From 0ba4ada19486722619ec919f22faaf23129a5b17 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 11:50:36 -0400
Subject: [PATCH 001/314] embryos: split XY position into coarse (bottom-cam)
 and fine (SPIM) stages

EmbryoState now carries position_coarse (bottom-camera detection or manual
map placement) and position_fine (future SPIM-objective alignment) as
separate fields; stage_position becomes a derived property (fine ?? coarse)
so every existing call site keeps working. FileStore round-trips both
stages; legacy position_x/position_y on disk backfill into coarse on read.

Phase 1 of the Map-as-embryo-home arc -- schema only, no UI changes yet.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 3e4105812544ecc579a7c8ccd1a32809defe417f)
---
 gently/app/agent.py               | 28 ++++++++----
 gently/core/file_store.py         | 76 +++++++++++++++++++++++++++----
 gently/core/store_types.py        | 10 +++-
 gently/harness/session/manager.py |  8 +++-
 gently/harness/state.py           | 48 +++++++++++++++++--
 5 files changed, 146 insertions(+), 24 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 1bd8c64a..15eed57d 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -847,11 +847,16 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                     eid,
                 )
                 src_role = "unassigned"
+            coarse = row.get("position_coarse") or {}
+            fine = row.get("position_fine") or {}
             embryo_states[eid] = {
-                "stage_position": {
-                    "x": row.get("position_x"),
-                    "y": row.get("position_y"),
-                },
+                # stage_position remains for legacy consumers of this snapshot.
+                # It carries the resolved (fine ?? coarse) view; add_embryo()
+                # downstream treats it as coarse, but the explicit
+                # position_fine field below will override that on restore.
+                "stage_position": dict(fine) if fine else dict(coarse),
+                "position_coarse": dict(coarse),
+                "position_fine": dict(fine),
                 "calibration": row.get("calibration") or {},
                 "uid": row.get("embryo_uid"),
                 "user_label": row.get("nickname"),
@@ -885,13 +890,20 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 continue
 
             try:
-                position = embryo_data.get('stage_position', {})
+                # Prefer explicit coarse/fine when the snapshot has them
+                # (FileStore path); fall back to flat stage_position for the
+                # legacy JSON-snapshot path which only carries the resolved view.
+                position_coarse = embryo_data.get('position_coarse')
+                position_fine = embryo_data.get('position_fine')
+                if position_coarse is None and position_fine is None:
+                    position_coarse = embryo_data.get('stage_position', {})
                 calibration = embryo_data.get('calibration', {})
                 source_uid = embryo_data.get('uid') or f"{session_id}_{embryo_id}"
 
                 self.experiment.add_embryo(
                     embryo_id=embryo_id,
-                    position=position,
+                    position=position_coarse or {},
+                    position_fine=position_fine or {},
                     calibration=calibration,
                     user_label=embryo_data.get('user_label'),
                     uid=source_uid,
@@ -1037,8 +1049,8 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
             try:
                 self.store.register_embryo(
                     self.session_id, embryo_id,
-                    position_x=embryo.stage_position.get('x') if embryo.stage_position else None,
-                    position_y=embryo.stage_position.get('y') if embryo.stage_position else None,
+                    position_coarse=embryo.position_coarse or None,
+                    position_fine=embryo.position_fine or None,
                     calibration=embryo.calibration,
                     role=embryo.role,
                 )
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 8ca383ea..1abbc971 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -108,6 +108,43 @@ def _sanitize_for_yaml(obj):
     return obj
 
 
+def _coarse_from_legacy(record: dict) -> Optional[dict]:
+    """Extract coarse XY from an embryo.yaml record, accepting either the new
+    `position_coarse` dict or the legacy flat `position_x` / `position_y` keys.
+    Returns None if neither shape carries usable values.
+    """
+    coarse = record.get("position_coarse")
+    if isinstance(coarse, dict) and coarse:
+        return coarse
+    px, py = record.get("position_x"), record.get("position_y")
+    if px is None and py is None:
+        return None
+    out = {}
+    if px is not None:
+        out["x"] = px
+    if py is not None:
+        out["y"] = py
+    return out or None
+
+
+def _normalize_embryo_record(record: Optional[dict]) -> Optional[dict]:
+    """Backfill an embryo.yaml dict so callers always see the new schema.
+
+    Adds `position_coarse` derived from legacy `position_x` / `position_y` if
+    only the legacy fields are present, and ensures `position_fine` exists
+    (as None) for forward-compat. The original record is not mutated.
+    """
+    if record is None:
+        return None
+    out = dict(record)
+    if out.get("position_coarse") is None:
+        backfill = _coarse_from_legacy(out)
+        if backfill is not None:
+            out["position_coarse"] = backfill
+    out.setdefault("position_fine", None)
+    return out
+
+
 def _write_yaml(path: Path, data: Any) -> None:
     """Write YAML atomically: write to a temp file, then rename."""
     path.parent.mkdir(parents=True, exist_ok=True)
@@ -432,6 +469,8 @@ def register_embryo(
         nickname: str = None,
         position_x: float = None,
         position_y: float = None,
+        position_coarse: dict = None,
+        position_fine: dict = None,
         calibration: dict = None,
         role: str = None,
     ) -> None:
@@ -440,23 +479,38 @@ def register_embryo(
         ``role`` is the experimental role key from gently.harness.roles.REGISTRY
         (e.g. ``"test"``, ``"calibration"``, ``"unassigned"``). Persisted in
         embryo.yaml. None preserves the existing value on update.
+
+        Position has two stages: coarse (bottom-camera / manual map placement)
+        and fine (future SPIM-objective alignment). New callers should pass
+        position_coarse / position_fine as dicts of shape {"x": float, "y":
+        float}. Legacy callers passing position_x / position_y get folded into
+        coarse automatically.
         """
         ed = self._embryo_dir(session_id, embryo_id)
         ed.mkdir(parents=True, exist_ok=True)
 
+        # Fold legacy position_x / position_y into coarse if caller used the
+        # old kwargs and didn't pass coarse explicitly.
+        if position_coarse is None and (position_x is not None or position_y is not None):
+            position_coarse = {}
+            if position_x is not None:
+                position_coarse["x"] = position_x
+            if position_y is not None:
+                position_coarse["y"] = position_y
+
         yaml_path = ed / "embryo.yaml"
         existing = _read_yaml(yaml_path)
 
         if existing is not None:
-            # Update: COALESCE behaviour -- keep existing values when new ones
-            # are None, matching the old ON CONFLICT DO UPDATE SET logic.
+            # COALESCE update — keep existing values when new ones are None.
+            existing_coarse = _coarse_from_legacy(existing)
             embryo_data = {
                 "embryo_id": embryo_id,
                 "session_id": session_id,
                 "embryo_uid": embryo_uid if embryo_uid is not None else existing.get("embryo_uid"),
                 "nickname": nickname if nickname is not None else existing.get("nickname"),
-                "position_x": position_x if position_x is not None else existing.get("position_x"),
-                "position_y": position_y if position_y is not None else existing.get("position_y"),
+                "position_coarse": position_coarse if position_coarse is not None else existing_coarse,
+                "position_fine": position_fine if position_fine is not None else existing.get("position_fine"),
                 "calibration": calibration if calibration is not None else existing.get("calibration"),
                 "role": role if role is not None else existing.get("role", "test"),
                 "created_at": existing.get("created_at", _now()),
@@ -467,8 +521,8 @@ def register_embryo(
                 "session_id": session_id,
                 "embryo_uid": embryo_uid,
                 "nickname": nickname,
-                "position_x": position_x,
-                "position_y": position_y,
+                "position_coarse": position_coarse,
+                "position_fine": position_fine,
                 "calibration": calibration,
                 "role": role if role is not None else "test",
                 "created_at": _now(),
@@ -477,13 +531,17 @@ def register_embryo(
         _write_yaml(yaml_path, embryo_data)
 
     def get_embryo(self, session_id: str, embryo_id: str) -> Optional[EmbryoInfo]:
-        """Read embryo.yaml.  Returns None if not found."""
+        """Read embryo.yaml. Returns None if not found.
+
+        Backfills position_coarse from legacy position_x / position_y so
+        callers don't need to know about the old schema.
+        """
         sd = self._session_dir(session_id)
         if sd is None:
             return None
         yaml_path = sd / "embryos" / embryo_id / "embryo.yaml"
         data = _read_yaml(yaml_path)
-        return data
+        return _normalize_embryo_record(data)
 
     def list_embryos(self, session_id: str) -> List[EmbryoInfo]:
         """List all embryos for a session, sorted by embryo_id."""
@@ -500,7 +558,7 @@ def list_embryos(self, session_id: str) -> List[EmbryoInfo]:
                 yaml_path = entry / "embryo.yaml"
                 data = _read_yaml(yaml_path)
                 if data is not None:
-                    result.append(data)
+                    result.append(_normalize_embryo_record(data))
         return result
 
     # ==================================================================
diff --git a/gently/core/store_types.py b/gently/core/store_types.py
index 34a466c4..d3cc45d1 100644
--- a/gently/core/store_types.py
+++ b/gently/core/store_types.py
@@ -14,11 +14,19 @@ class SessionInfo(TypedDict):
     metadata: Optional[dict]
 
 
-class EmbryoInfo(TypedDict):
+class EmbryoInfo(TypedDict, total=False):
     embryo_id: str
     session_id: str
     embryo_uid: Optional[str]
     nickname: Optional[str]
+    # Coarse XY (µm) from bottom-camera detection or manual map placement.
+    # Shape: {"x": float, "y": float}. Always present once the embryo exists.
+    position_coarse: Optional[dict]
+    # Fine XY (µm) from SPIM-objective alignment. None until that workflow
+    # refines the coarse position. Shape: {"x": float, "y": float}.
+    position_fine: Optional[dict]
+    # Legacy flat fields. Still accepted on write and surfaced on read for
+    # callers that haven't migrated; new code should use position_coarse.
     position_x: Optional[float]
     position_y: Optional[float]
     calibration: Optional[dict]
diff --git a/gently/harness/session/manager.py b/gently/harness/session/manager.py
index 9985b324..47ea38d3 100644
--- a/gently/harness/session/manager.py
+++ b/gently/harness/session/manager.py
@@ -100,14 +100,18 @@ def _resume_session(self, session_id: str, experiment):
                 embryo.should_skip = embryo_data.get('should_skip', False)
                 embryo.skip_reason = embryo_data.get('skip_reason')
 
-        # Also load embryos from store's embryo table
+        # Also load embryos from store's embryo table. FileStore returns
+        # position_coarse / position_fine (with legacy position_x / position_y
+        # backfilled into coarse on read), so both calibration stages survive
+        # the resume.
         store_embryos = self.store.list_embryos(session_id)
         for e in store_embryos:
             eid = e['embryo_id']
             if eid not in experiment.embryos:
                 experiment.add_embryo(
                     embryo_id=eid,
-                    position={'x': e.get('position_x'), 'y': e.get('position_y')},
+                    position=e.get('position_coarse') or {},
+                    position_fine=e.get('position_fine') or {},
                     calibration=json.loads(e['calibration']) if e.get('calibration') else {},
                 )
 
diff --git a/gently/harness/state.py b/gently/harness/state.py
index a6113480..cb02af74 100644
--- a/gently/harness/state.py
+++ b/gently/harness/state.py
@@ -131,8 +131,13 @@ class EmbryoState:
     # accidental Test→Calibration would burn extra dose on the precious sample.
     role: str = "test"
 
-    # Position
-    stage_position: Dict[str, float] = field(default_factory=dict)  # {'x': 1234.5, 'y': 5678.9}
+    # Position — two-stage: coarse (bottom-camera detection or manual map
+    # placement, always present once an embryo exists) and fine (populated
+    # later by SPIM-objective alignment). Resolved value is exposed by the
+    # `stage_position` property so downstream motion/perception can stay
+    # agnostic about which stage we're in.
+    position_coarse: Dict[str, float] = field(default_factory=dict)  # {'x': ..., 'y': ...}
+    position_fine: Dict[str, float] = field(default_factory=dict)    # empty until SPIM head alignment
     calibration: Dict = field(default_factory=dict)  # Galvo/piezo parameters
     detection_confidence: float = 0.0  # SAM/detection confidence score (0-1)
 
@@ -789,6 +794,33 @@ def get_exposure_summary(self) -> str:
 
         return f"{self.exposure_count} exposures, {time_str} total"
 
+    @property
+    def stage_position(self) -> Dict[str, float]:
+        """Resolved XY position — fine if SPIM-aligned, else coarse.
+
+        Coarse comes from the bottom-camera detection / manual map placement.
+        Fine comes from the SPIM-objective alignment workflow (not built yet).
+        Callers that just want "where is this embryo" read this; callers that
+        care about calibration state read position_coarse / position_fine
+        directly.
+        """
+        return self.position_fine if self.position_fine else self.position_coarse
+
+    @stage_position.setter
+    def stage_position(self, value: Dict[str, float]) -> None:
+        """Back-compat setter — writes to coarse.
+
+        Legacy callers that assigned `embryo.stage_position = {...}` were
+        writing a bottom-camera / manual position; that's the coarse stage.
+        New code should set position_coarse or position_fine explicitly.
+        """
+        self.position_coarse = value or {}
+
+    @property
+    def has_fine_position(self) -> bool:
+        """True once SPIM-objective alignment has refined the coarse position."""
+        return bool(self.position_fine)
+
     def to_dict(self) -> Dict:
         """Serialize for API responses"""
         return {
@@ -798,6 +830,9 @@ def to_dict(self) -> Dict:
             'user_label': self.user_label,
             'role': self.role,
             'stage_position': self.stage_position,
+            'position_coarse': self.position_coarse,
+            'position_fine': self.position_fine,
+            'has_fine_position': self.has_fine_position,
             'calibration': self.calibration,
             'detection_confidence': self.detection_confidence,
             'interval_seconds': self.interval_seconds,
@@ -848,13 +883,17 @@ def __init__(self):
     def add_embryo(self, embryo_id: str, position: Dict = None,
                    calibration: Dict = None, user_label: Optional[str] = None,
                    confidence: float = 0.0, uid: Optional[str] = None,
-                   role: str = "test"):
+                   role: str = "test", position_fine: Dict = None):
         """Register new embryo.
 
         ``role`` must be a key in :data:`gently.harness.roles.REGISTRY`
         (e.g. ``"test"``, ``"calibration"``, ``"unassigned"``). Unknown roles
         raise KeyError.
 
+        `position` is the coarse XY (bottom-camera detection or manual map
+        placement). `position_fine` is reserved for the future SPIM-objective
+        alignment workflow and defaults to empty.
+
         Emits an ``EMBRYO_DETECTED`` event so listeners (e.g. the viz
         server's TimelapseStateTracker, which feeds the device map)
         learn about marked embryos immediately — not just after the
@@ -871,7 +910,8 @@ def add_embryo(self, embryo_id: str, position: Dict = None,
         self.embryos[embryo_id] = EmbryoState(
             id=embryo_id,
             uid=uid,
-            stage_position=pos,
+            position_coarse=position or {},
+            position_fine=position_fine or {},
             calibration=calibration or {},
             user_label=user_label,
             detection_confidence=confidence,

From 6f28365b682fb96d3568228f38e0f92a6a684e7d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 13:33:47 -0400
Subject: [PATCH 002/314] embryos: broadcast EMBRYOS_UPDATE on mutation

Adds an EMBRYOS_UPDATE event type and wires ExperimentState's mutations
(add_embryo / remove_embryo / assign_nickname / batch clear / editor
finish) to publish a full embryo-list snapshot through the agent. The
viz server's existing wildcard subscription forwards it to all browser
clients, so Phase 3 can render embryos on the Map without polling.

ExperimentState stays bus-agnostic via an on_embryos_changed observer
hook; the agent wires the publisher at init.

Phase 2 of the Map-as-embryo-home arc.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 617e54c95f715cf949bc2b4a02fca65314da21ca)
---
 gently/app/agent.py                 | 36 +++++++++++++++++++++++++++++
 gently/app/tools/detection_tools.py |  3 ++-
 gently/core/event_bus.py            |  1 +
 gently/harness/state.py             | 29 ++++++++++++++++++++++-
 4 files changed, 67 insertions(+), 2 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 15eed57d..da7d7b11 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -125,6 +125,11 @@ def __init__(
         # Event bus for async messaging (must be before perception manager)
         self._event_bus = get_event_bus()
 
+        # Broadcast the embryo list whenever it mutates. Hooked through the
+        # state object's observer so add/remove/nickname/restore all publish
+        # without each call site having to remember.
+        self.experiment.on_embryos_changed = self._publish_embryos_update
+
         # Perception system (gently-perception harness)
         self.perceiver = Perceiver()
 
@@ -678,6 +683,36 @@ def _emit_event(self, event_type: EventType, data: Optional[Dict] = None):
             source="agent",
         )
 
+    def _publish_embryos_update(self) -> None:
+        """Broadcast the current embryo list as an EMBRYOS_UPDATE event.
+
+        Wired into ExperimentState.on_embryos_changed at agent init so every
+        add / remove / restore / nickname change snaps a fresh full-list
+        snapshot onto the bus. The viz server's wildcard subscription forwards
+        it straight to connected browsers — that's how the Devices > Map page
+        learns about embryos without a poll loop.
+        """
+        if self._event_bus is None:
+            return
+        try:
+            embryos = [e.to_dict() for e in self.experiment.embryos.values()]
+        except Exception:
+            logger.exception("Failed to serialise embryos for EMBRYOS_UPDATE")
+            return
+        payload = {
+            "embryos": embryos,
+            "count": len(embryos),
+            "session_id": getattr(self, "session_id", None),
+        }
+        try:
+            self._event_bus.publish(
+                event_type=EventType.EMBRYOS_UPDATE,
+                data=payload,
+                source="agent.experiment",
+            )
+        except Exception:
+            logger.exception("Failed to publish EMBRYOS_UPDATE")
+
     def _mark_significant_action(self, action_type: str):
         """Mark that a significant action occurred (triggers auto-save)."""
         self._auto_save()
@@ -879,6 +914,7 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
 
         if clear_existing:
             self.experiment.embryos.clear()
+            self.experiment.notify_embryos_changed()
 
         imported = []
         skipped = []
diff --git a/gently/app/tools/detection_tools.py b/gently/app/tools/detection_tools.py
index eda06d81..08cf58fd 100644
--- a/gently/app/tools/detection_tools.py
+++ b/gently/app/tools/detection_tools.py
@@ -373,7 +373,8 @@ async def edit_embryos(
         return "No embryos to edit. Run detect_embryos or manual_mark_embryos first."
 
     # Same flow as manual_mark_embryos: pre-populate with existing markers,
-    # let user edit, reconcile.
+    # let user edit, reconcile. notify_embryos_changed is fired by
+    # manual_mark_embryos / add_embryo internally.
     return await manual_mark_embryos(
         exposure_ms=exposure_ms,
         default_role=default_role,
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index b086f172..0b7d57b2 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -82,6 +82,7 @@ class EventType(Enum):
     LASER_CHANGED = auto()
     DEVICE_STATE_UPDATE = auto()   # Periodic device-state snapshot from device layer
     BOTTOM_CAMERA_FRAME = auto()   # Live JPEG frame from the bottom camera stream
+    EMBRYOS_UPDATE = auto()        # Full embryo list snapshot from agent.experiment
 
     # System events
     ERROR_OCCURRED = auto()
diff --git a/gently/harness/state.py b/gently/harness/state.py
index cb02af74..a52f7b79 100644
--- a/gently/harness/state.py
+++ b/gently/harness/state.py
@@ -25,13 +25,16 @@
 fields are now on ``EmbryoState`` directly.
 """
 
+import logging
 import re
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any, Callable, Dict, List, Optional, Tuple
 from pathlib import Path
 import numpy as np
 
+logger = logging.getLogger(__name__)
+
 # Re-export CalibrationPrior from its hardware-specific home for backward compat.
 # CalibrationPrior is diSPIM-specific (piezo-galvo linear fit). Other hardware
 # modules will define their own calibration models.
@@ -880,6 +883,27 @@ def __init__(self):
         # Updated after each successful calibration, used to initialize subsequent embryos
         self.calibration_prior: CalibrationPrior = CalibrationPrior()
 
+        # Observer hook — agent wires this at startup to publish EMBRYOS_UPDATE
+        # over the event bus. Kept as a plain callback so this module stays
+        # bus-agnostic.
+        self.on_embryos_changed: Optional[Callable[[], None]] = None
+
+    def notify_embryos_changed(self) -> None:
+        """Fire the on_embryos_changed observer if one is wired.
+
+        Call this after any mutation the agent can't intercept through
+        add_embryo / remove_embryo (e.g. a direct write to
+        embryo.position_coarse). UI hooks must not raise — failures here are
+        swallowed so state mutations stay durable.
+        """
+        cb = self.on_embryos_changed
+        if cb is None:
+            return
+        try:
+            cb()
+        except Exception:
+            logger.exception("ExperimentState.on_embryos_changed callback failed")
+
     def add_embryo(self, embryo_id: str, position: Dict = None,
                    calibration: Dict = None, user_label: Optional[str] = None,
                    confidence: float = 0.0, uid: Optional[str] = None,
@@ -917,6 +941,7 @@ def add_embryo(self, embryo_id: str, position: Dict = None,
             detection_confidence=confidence,
             role=role,
         )
+        self.notify_embryos_changed()
 
         # Fire the registration event. Late-bound import keeps this module
         # decoupled from the event bus until first use.
@@ -943,6 +968,7 @@ def remove_embryo(self, embryo_id: str) -> bool:
         """Remove embryo from experiment (e.g., false detection)"""
         if embryo_id in self.embryos:
             del self.embryos[embryo_id]
+            self.notify_embryos_changed()
             return True
         return False
 
@@ -950,6 +976,7 @@ def assign_nickname(self, embryo_id: str, nickname: str):
         """Agent assigns intuitive name"""
         if embryo_id in self.embryos:
             self.embryos[embryo_id].nickname = nickname
+            self.notify_embryos_changed()
 
     def get_embryo_by_any_name(self, name: str) -> Optional[EmbryoState]:
         """Get embryo by ID, nickname, or user label"""

From 4db06d8fbde3b1542afcc4d0cd44338e97751f3f Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 13:40:55 -0400
Subject: [PATCH 003/314] Devices > Map: render embryo waypoints as coarse
 rings / fine discs

Adds an embryo layer to the Map between the axes and the live stage
marker. Each embryo renders at its resolved XY (fine if SPIM-aligned,
else coarse): coarse-only as an outlined lavender ring, fine-calibrated
as a filled disc, both labelled with the embryo number. The layer is a
pure read of EMBRYOS_UPDATE events plus an initial /api/embryos/current
snapshot so a Map page opened mid-session shows existing embryos
without waiting for the next mutation.

Read-only at this phase; click / drag / delete will land in Phase 5.

Phase 3 of the Map-as-embryo-home arc.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 144d9fc9db6511aff3604c7313cc7305ba1cf645)
---
 gently/ui/web/routes/data.py       |  25 +++++++
 gently/ui/web/static/css/main.css  |  32 +++++++++
 gently/ui/web/static/js/devices.js | 105 ++++++++++++++++++++++++++---
 3 files changed, 153 insertions(+), 9 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 3e66763f..2d401199 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -63,6 +63,31 @@ async def get_device_status():
             "microscope": microscope_up,
         }
 
+    @router.get("/api/embryos/current")
+    async def get_current_embryos():
+        """Return the agent's current embryo list as an EMBRYOS_UPDATE payload.
+
+        EMBRYOS_UPDATE is published only on mutation, so a Map page opened
+        mid-session would otherwise see an empty embryo layer until the next
+        add/remove/edit. This endpoint serves the same payload shape as the
+        event so clients can bootstrap and then switch to the live stream.
+        """
+        empty = {"embryos": [], "count": 0, "session_id": None}
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        if agent is None or not hasattr(agent, "experiment"):
+            return empty
+        try:
+            embryos = [e.to_dict() for e in agent.experiment.embryos.values()]
+        except Exception:
+            logger.exception("Failed to serialise embryos for snapshot")
+            return empty
+        return {
+            "embryos": embryos,
+            "count": len(embryos),
+            "session_id": getattr(agent, "session_id", None),
+        }
+
     @router.get("/api/devices/coverslip")
     async def get_coverslip():
         """Return the coverslip outline metadata for the Map view.
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 4d19c79d..44405acd 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9172,6 +9172,7 @@ body.modal-open {
     --map-zone-green:  90, 168, 122;     /* RGB triples for compositing */
     --map-zone-orange: 215, 152, 84;
     --map-zone-red:    220, 96,  88;
+    --map-embryo:      156, 120, 220;    /* lavender — distinct from zones and marker */
     --map-overlay-bg:    rgba(11, 14, 19, 0.78);
     --map-overlay-bg-2:  rgba(11, 14, 19, 0.92);
     --map-overlay-edge:  rgba(212, 221, 232, 0.18);
@@ -9189,6 +9190,7 @@ body.modal-open {
     --map-accent:    #0e7490;
     --map-accent-2:  #155e75;
     --map-warm:      #a16207;
+    --map-embryo:    100, 60, 180;       /* deeper purple for cream paper */
     --map-overlay-bg:    rgba(246, 243, 236, 0.82);
     --map-overlay-bg-2:  rgba(246, 243, 236, 0.96);
     --map-overlay-edge:  rgba(29, 43, 58, 0.18);
@@ -9429,6 +9431,36 @@ body.modal-open {
     100% { opacity: 0;    r: 28; }
 }
 
+/* --- Embryo waypoints ------------------------------------------------ */
+/* Coarse = bottom-camera / manual placement; fine = SPIM-objective
+   alignment. Coarse reads as an outlined ring (provisional), fine as a
+   filled disc (committed). Same hue so the row of embryos still reads as
+   one cohort, but visual weight signals calibration state at a glance. */
+.devices-embryo-ring {
+    fill: rgba(var(--map-embryo), 0.08);
+    stroke: rgba(var(--map-embryo), 0.85);
+    stroke-width: 1.4;
+    vector-effect: non-scaling-stroke;
+}
+.devices-embryo-disc {
+    fill: rgba(var(--map-embryo), 0.65);
+    stroke: rgba(var(--map-embryo), 0.95);
+    stroke-width: 1.4;
+    vector-effect: non-scaling-stroke;
+}
+.devices-embryo-label {
+    fill: var(--map-ink);
+    font-family: 'JetBrains Mono', ui-monospace, monospace;
+    font-weight: 600;
+    text-anchor: middle;
+    dominant-baseline: central;
+    pointer-events: none;
+    paint-order: stroke;
+    stroke: var(--map-paper);
+    stroke-width: 2;
+    stroke-linejoin: round;
+}
+
 /* --- Overlay panels (compass, readout, scalebar, legend) ------------- */
 .devices-compass,
 .devices-map-readout,
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 0f2f5316..c1d5e1c8 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -32,11 +32,14 @@ const DevicesManager = (function () {
     let _mapWrap;
     let _scalebarLabel;
 
-    // Embryos overlay state: list of {embryo_id, x, y, role, ...}.
-    // Populated by /api/embryos/positions on init + EMBRYO_DETECTED /
-    // STATUS_CHANGED WS pushes thereafter. Roles drive the marker color
+    // Embryo waypoints — driven by EMBRYOS_UPDATE events (the canonical bulk
+    // mutation broadcast added by the embryos-broadcast commit) and the
+    // initial /api/embryos/current snapshot. Each entry mirrors
+    // EmbryoState.to_dict() (id, position_coarse, position_fine,
+    // has_fine_position, nickname, role, ...). Role drives marker color
     // (mirrors the marking-window legend: magenta=test, cyan=calibration,
-    // grey=unassigned).
+    // grey=unassigned). EMBRYO_DETECTED / STATUS_CHANGED listeners stay
+    // hooked as a belt-and-braces refresh path.
     let _embryos = [];
     const _ROLE_COLOR = {
         test: '#ff66cc',
@@ -257,6 +260,30 @@ const DevicesManager = (function () {
         }
     }
 
+    // Initial embryo snapshot — closes the gap for clients that connect
+    // mid-session, after the last EMBRYOS_UPDATE has already been broadcast
+    // and aged out of history. Subsequent updates arrive over the event bus.
+    async function loadEmbryosSnapshot() {
+        try {
+            const res = await fetch('/api/embryos/current');
+            if (!res.ok) return;
+            const data = await res.json();
+            handleEmbryosUpdate(data);
+        } catch (err) {
+            console.debug('embryos snapshot fetch failed:', err);
+        }
+    }
+
+    function handleEmbryosUpdate(payload) {
+        _embryos = (payload && Array.isArray(payload.embryos)) ? payload.embryos : [];
+        if (!_viewBox) {
+            computeViewBox();
+            renderMap();
+        } else {
+            renderEmbryos();
+        }
+    }
+
     // =====================================================================
     // Properties table (Details view)
     // =====================================================================
@@ -744,6 +771,67 @@ const DevicesManager = (function () {
         return Math.round(v).toString();
     }
 
+    // =====================================================================
+    // Embryo waypoints
+    // =====================================================================
+
+    // "embryo_007" / "embryo_7" -> 7. Falls back to a 1-based index from the
+    // caller so the label always shows *something*, even for stray ids.
+    function embryoLabelText(id, fallbackIndex) {
+        const m = id && String(id).match(/(\d+)/);
+        if (m) {
+            const n = parseInt(m[1], 10);
+            if (Number.isFinite(n)) return String(n);
+        }
+        return String(fallbackIndex + 1);
+    }
+
+    // Resolve XY for rendering — fine if SPIM-aligned, else coarse. Returns
+    // null when neither stage carries usable values so the entry is skipped
+    // (e.g. an embryo whose detection record came in malformed).
+    function embryoResolvedXY(emb) {
+        const f = emb && emb.position_fine;
+        if (f && Number.isFinite(f.x) && Number.isFinite(f.y)) return { x: f.x, y: f.y };
+        const c = emb && emb.position_coarse;
+        if (c && Number.isFinite(c.x) && Number.isFinite(c.y)) return { x: c.x, y: c.y };
+        return null;
+    }
+
+    function renderEmbryos() {
+        if (!_mapEmbryos || !_viewBox) return;
+        _mapEmbryos.innerHTML = '';
+        if (!_embryos || !_embryos.length) return;
+        const span = Math.max(_viewBox.xMax - _viewBox.xMin,
+                              _viewBox.yMax - _viewBox.yMin);
+        const radius = span * 0.012;
+        const fontSize = span * 0.015;
+
+        _embryos.forEach((emb, i) => {
+            const xy = embryoResolvedXY(emb);
+            if (!xy) return;
+
+            const isFine = !!emb.has_fine_position;
+            const circle = document.createElementNS(SVG_NS, 'circle');
+            circle.setAttribute('cx', xy.x);
+            circle.setAttribute('cy', svgY(xy.y));
+            circle.setAttribute('r', radius);
+            circle.setAttribute('class',
+                isFine ? 'devices-embryo-disc' : 'devices-embryo-ring');
+            // Identifiers for inspection / future click handlers — not used yet.
+            circle.setAttribute('data-embryo-id', emb.id || '');
+            circle.setAttribute('data-embryo-stage', isFine ? 'fine' : 'coarse');
+            _mapEmbryos.appendChild(circle);
+
+            const label = document.createElementNS(SVG_NS, 'text');
+            label.setAttribute('x', xy.x);
+            label.setAttribute('y', svgY(xy.y));
+            label.setAttribute('class', 'devices-embryo-label');
+            label.setAttribute('font-size', fontSize);
+            label.textContent = embryoLabelText(emb.id, i);
+            _mapEmbryos.appendChild(label);
+        });
+    }
+
     function updateMapMarker() {
         if (!_mapMarker || !_lastXY) return;
         const sx = _lastXY.X;
@@ -950,14 +1038,13 @@ const DevicesManager = (function () {
         setupViewSwitcher();
         setupCameraWiring();
         loadCoverslip();
-        loadEmbryos();
+        loadEmbryosSnapshot();
         switchView(_currentView);
         if (typeof ClientEventBus !== 'undefined') {
             ClientEventBus.on('DEVICE_STATE_UPDATE', handlePayload);
-            // Embryo events: a fresh marking session emits one
-            // EMBRYO_DETECTED per registered embryo (via
-            // ExperimentState.add_embryo). assign_embryo_roles emits
-            // STATUS_CHANGED with change=role_assigned per change.
+            ClientEventBus.on('EMBRYOS_UPDATE', handleEmbryosUpdate);
+            // Belt-and-braces: also listen for the fine-grained events that
+            // existed before EMBRYOS_UPDATE so direct emitters still refresh.
             ClientEventBus.on('EMBRYO_DETECTED', handleEmbryoDetected);
             ClientEventBus.on('STATUS_CHANGED', handleStatusChanged);
         }

From 1ed5fc4da9ecb6d748f6f342d874e459f8c0b5ea Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 14:04:53 -0400
Subject: [PATCH 004/314] detect_embryos: web Marking canvas replaces napari
 editor, gate control routes

Adds Phase 4 of the Map-as-embryo-home arc.

Auth (4a)
---------
New gently/ui/web/auth.py introduces a two-role model: localhost is
always control, remote callers default to view and need X-Gently-Token
matching GENTLY_CONTROL_TOKEN to upgrade. Bottom-camera stream
start/stop POST routes now Depends(require_control), so a remote
browser can watch the stage but cannot drive hardware until an operator
provisions the shared token.

Marking canvas seeded (4b)
--------------------------
VisualizationServer.start_marking_session takes initial_markers (pixel
positions from SAM); they're seeded into the session state and the
marking_image broadcast so the canvas opens with SAM detections pre-
placed. wait_for_marking now also computes stage_x_um / stage_y_um from
the operator-confirmed pixel positions, so callers can drop the result
straight into agent.experiment.add_embryo. marking.js renders the
seeded markers immediately and adapts the instruction string.

detect_embryos -> web (4c)
--------------------------
The agent tool now SAM-detects with open_editor=False (napari path
bypassed), then hands off to the web Marking canvas via
agent.viz_server.start_marking_session(initial_markers=...) and awaits
wait_for_marking. Confirmed embryos land in agent.experiment, which
broadcasts EMBRYOS_UPDATE -> Devices > Map shows them as coarse rings.
Falls back gracefully if viz_server is unavailable or the operator
never confirms.

edit_embryos / manual_mark_embryos still use napari; deferred to a
later phase. gently/ui/napari_viewer.py kept intact for offline use.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 4fbb9edf71b4faaef18aa7f4369d5bbc1556ca81)
---
 gently/ui/web/auth.py        | 95 ++++++++++++++++++++++++++++++++++++
 gently/ui/web/routes/data.py | 10 ++--
 2 files changed, 102 insertions(+), 3 deletions(-)
 create mode 100644 gently/ui/web/auth.py

diff --git a/gently/ui/web/auth.py b/gently/ui/web/auth.py
new file mode 100644
index 00000000..7933c515
--- /dev/null
+++ b/gently/ui/web/auth.py
@@ -0,0 +1,95 @@
+"""Web-UI authorization roles.
+
+Two roles:
+  view    -- read-only. GET endpoints, SSE / WebSocket event streams.
+  control -- can drive hardware (POST/PUT/DELETE). Localhost is always
+             control; remote callers must present a matching token in the
+             X-Gently-Token header (token read from GENTLY_CONTROL_TOKEN).
+
+Routes that move hardware or mutate persistent state declare a dependency:
+
+    from gently.ui.web.auth import require_control
+
+    @router.post("/api/devices/foo")
+    async def foo(_=Depends(require_control)):
+        ...
+
+Default-deny on control: if the token env var is unset, remote callers get
+view-only access until the operator provisions a token. That matches the
+"diSPIM computer alone gives control directions" intent while leaving room
+for authenticated remote operators later.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+from enum import Enum
+
+from fastapi import HTTPException, Request
+
+logger = logging.getLogger(__name__)
+
+
+_LOOPBACK_HOSTS = frozenset({"127.0.0.1", "::1", "localhost"})
+
+# Header name used to upgrade a remote session to control role. Single shared
+# token for now; per-user identities can be layered on later without changing
+# this module's public surface.
+_TOKEN_HEADER = "X-Gently-Token"
+_TOKEN_ENV    = "GENTLY_CONTROL_TOKEN"
+
+
+class Role(str, Enum):
+    VIEW    = "view"
+    CONTROL = "control"
+
+
+def _configured_token() -> str | None:
+    """Return the shared control token, or None if no token is provisioned.
+
+    Read fresh each request so the operator can rotate the token without
+    restarting the web server.
+    """
+    tok = os.environ.get(_TOKEN_ENV, "").strip()
+    return tok or None
+
+
+def resolve_role(request: Request) -> Role:
+    """Determine the effective role for a request.
+
+    Localhost is always control (the diSPIM box). Remote callers need to
+    present X-Gently-Token matching GENTLY_CONTROL_TOKEN.
+    """
+    client = request.client
+    host = client.host if client else None
+    if host in _LOOPBACK_HOSTS:
+        return Role.CONTROL
+
+    token = _configured_token()
+    if token is not None:
+        supplied = request.headers.get(_TOKEN_HEADER, "").strip()
+        if supplied and supplied == token:
+            return Role.CONTROL
+
+    return Role.VIEW
+
+
+def require_control(request: Request) -> Role:
+    """FastAPI dependency — 403 unless the caller has the control role.
+
+    Logs the denied client host (without leaking the token) so the operator
+    can spot if a remote browser is trying to drive hardware.
+    """
+    role = resolve_role(request)
+    if role is Role.CONTROL:
+        return role
+    host = request.client.host if request.client else "unknown"
+    logger.warning("control-route 403 for %s -> %s %s",
+                   host, request.method, request.url.path)
+    raise HTTPException(
+        status_code=403,
+        detail="control role required (this endpoint moves hardware or "
+               "mutates persistent state; localhost has it by default, "
+               "remote callers need X-Gently-Token)",
+    )
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 2d401199..6b9c2434 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -6,7 +6,9 @@
 from typing import Optional
 
 import yaml
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter, Depends, HTTPException
+
+from gently.ui.web.auth import require_control
 
 logger = logging.getLogger(__name__)
 
@@ -123,7 +125,8 @@ async def get_bottom_camera_status():
             "last_frame_ts": getattr(monitor, "_last_frame_ts", None) if monitor else None,
         }
 
-    @router.post("/api/devices/bottom_camera/stream/start")
+    @router.post("/api/devices/bottom_camera/stream/start",
+                 dependencies=[Depends(require_control)])
     async def start_bottom_camera_stream():
         """Start the bottom-camera stream bridge.
 
@@ -144,7 +147,8 @@ async def start_bottom_camera_stream():
             raise HTTPException(status_code=500, detail=f"start failed: {exc}")
         return {"streaming": monitor.running}
 
-    @router.post("/api/devices/bottom_camera/stream/stop")
+    @router.post("/api/devices/bottom_camera/stream/stop",
+                 dependencies=[Depends(require_control)])
     async def stop_bottom_camera_stream():
         """Stop the bottom-camera stream bridge. Idempotent."""
         bridge = getattr(server, "agent_bridge", None)

From 5b15797648c07afac03a9cbbff383bb87e042600 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 15:34:29 -0400
Subject: [PATCH 005/314] Devices > Map: pick-up / drop / delete to edit
 embryos in-place

Map becomes the home for embryos rather than a viewer.

Backend (data.py)
-----------------
PUT /api/embryos/{id}/position {x, y} updates position_coarse and CLEARS
position_fine -- the operator overriding the sighting invalidates any
prior SPIM-objective alignment derived from the old coarse, so it must
be re-run. DELETE /api/embryos/{id} removes via ExperimentState. Both
endpoints Depends(require_control), so only the diSPIM box (or a remote
session with X-Gently-Token) can mutate the embryo list. Both fire
EMBRYOS_UPDATE through the observer hook for live Map refresh.

Frontend (devices.js + main.css)
--------------------------------
First click on an embryo selects it (dashed lavender ring, brighter
label -- the "picked up" state). Click on empty map space drops it
there with a confirm prompt; Delete/Backspace removes with confirm;
Escape clears the selection. New embryos still go through the bottom-
camera Marking canvas -- the Map is a schematic, not a satellite, so
adding without a visual reference would be guessing.

Keyboard handler is tab-aware (Devices tab + Map view only) and
ignores keystrokes while an input/textarea/select has focus so it
doesn't hijack the chat composer.

Smoke-tested end-to-end via ASGI: PUT clears fine correctly, DELETE
fires notify, error paths return 400 / 404 / 503.

Phase 5 of the Map-as-embryo-home arc.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 8f6553e12b02ff070589d729cb8e320c330f2817)
---
 gently/ui/web/routes/data.py       |  54 ++++++++-
 gently/ui/web/static/css/main.css  |  17 +++
 gently/ui/web/static/js/devices.js | 171 ++++++++++++++++++++++++++++-
 3 files changed, 236 insertions(+), 6 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 6b9c2434..6a3e8ef5 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -6,7 +6,7 @@
 from typing import Optional
 
 import yaml
-from fastapi import APIRouter, Depends, HTTPException
+from fastapi import APIRouter, Body, Depends, HTTPException
 
 from gently.ui.web.auth import require_control
 
@@ -65,6 +65,58 @@ async def get_device_status():
             "microscope": microscope_up,
         }
 
+    def _require_agent_with_experiment():
+        """Resolve the live agent from the server bridge, or 503.
+
+        Edit endpoints write through ExperimentState so the notify hook fires
+        EMBRYOS_UPDATE and the Map re-renders without a follow-up fetch.
+        """
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        if agent is None or not hasattr(agent, "experiment"):
+            raise HTTPException(status_code=503, detail="Agent not ready")
+        return agent
+
+    @router.put("/api/embryos/{embryo_id}/position",
+                dependencies=[Depends(require_control)])
+    async def update_embryo_position(
+        embryo_id: str,
+        body: dict = Body(...),
+    ):
+        """Update an embryo's coarse XY position.
+
+        Map-side edits write to the coarse stage and CLEAR any prior fine
+        position — the operator is overriding the sighting, so any
+        SPIM-objective fine alignment derived from the old coarse is no
+        longer trustworthy and must be re-run.
+        """
+        agent = _require_agent_with_experiment()
+        emb = agent.experiment.embryos.get(embryo_id)
+        if emb is None:
+            raise HTTPException(status_code=404, detail=f"Embryo {embryo_id} not found")
+        try:
+            x = float(body.get("x"))
+            y = float(body.get("y"))
+        except (TypeError, ValueError):
+            raise HTTPException(status_code=400, detail="Body needs numeric x and y")
+        emb.position_coarse = {"x": x, "y": y}
+        emb.position_fine = {}
+        agent.experiment.notify_embryos_changed()
+        return emb.to_dict()
+
+    @router.delete("/api/embryos/{embryo_id}",
+                   dependencies=[Depends(require_control)])
+    async def delete_embryo(embryo_id: str):
+        """Remove an embryo from the experiment.
+
+        Goes through ExperimentState.remove_embryo so the observer hook
+        fires EMBRYOS_UPDATE automatically.
+        """
+        agent = _require_agent_with_experiment()
+        if not agent.experiment.remove_embryo(embryo_id):
+            raise HTTPException(status_code=404, detail=f"Embryo {embryo_id} not found")
+        return {"ok": True, "embryo_id": embryo_id}
+
     @router.get("/api/embryos/current")
     async def get_current_embryos():
         """Return the agent's current embryo list as an EMBRYOS_UPDATE payload.
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 44405acd..9e975176 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9436,6 +9436,9 @@ body.modal-open {
    alignment. Coarse reads as an outlined ring (provisional), fine as a
    filled disc (committed). Same hue so the row of embryos still reads as
    one cohort, but visual weight signals calibration state at a glance. */
+.devices-embryo-group {
+    cursor: pointer;
+}
 .devices-embryo-ring {
     fill: rgba(var(--map-embryo), 0.08);
     stroke: rgba(var(--map-embryo), 0.85);
@@ -9461,6 +9464,20 @@ body.modal-open {
     stroke-linejoin: round;
 }
 
+/* Selected = "picked up" — outlined dashed, hollow fill, brighter label.
+   Click on empty map drops the picked-up embryo at that XY; Delete /
+   Backspace removes it; Escape deselects. */
+.devices-embryo-group.devices-embryo-selected .devices-embryo-ring,
+.devices-embryo-group.devices-embryo-selected .devices-embryo-disc {
+    fill: rgba(var(--map-embryo), 0.12);
+    stroke: rgba(var(--map-embryo), 1);
+    stroke-width: 2;
+    stroke-dasharray: 4 3;
+}
+.devices-embryo-group.devices-embryo-selected .devices-embryo-label {
+    fill: rgba(var(--map-embryo), 1);
+}
+
 /* --- Overlay panels (compass, readout, scalebar, legend) ------------- */
 .devices-compass,
 .devices-map-readout,
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index c1d5e1c8..03d5fbb3 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -47,6 +47,11 @@ const DevicesManager = (function () {
         unassigned: '#888888',
     };
 
+    // Map-side edit state. _selectedEmbryoId means "picked up": the next
+    // click on empty map space drops it there (with a confirm), Delete /
+    // Backspace removes it (with a confirm), Escape clears the selection.
+    let _selectedEmbryoId = null;
+
     // Bottom-camera panel DOM + state
     let _camPanel, _camToggle, _camImg, _camPlaceholder, _camLed, _camMeta;
     let _camStreaming = false;
@@ -811,16 +816,24 @@ const DevicesManager = (function () {
             if (!xy) return;
 
             const isFine = !!emb.has_fine_position;
+            const isSelected = _selectedEmbryoId !== null
+                            && emb.id === _selectedEmbryoId;
+
+            // Wrap circle + label in a group so a single closest() lookup
+            // finds the embryo regardless of which child the click hit.
+            const group = document.createElementNS(SVG_NS, 'g');
+            group.setAttribute('class',
+                'devices-embryo-group' + (isSelected ? ' devices-embryo-selected' : ''));
+            group.setAttribute('data-embryo-id', emb.id || '');
+            group.setAttribute('data-embryo-stage', isFine ? 'fine' : 'coarse');
+
             const circle = document.createElementNS(SVG_NS, 'circle');
             circle.setAttribute('cx', xy.x);
             circle.setAttribute('cy', svgY(xy.y));
             circle.setAttribute('r', radius);
             circle.setAttribute('class',
                 isFine ? 'devices-embryo-disc' : 'devices-embryo-ring');
-            // Identifiers for inspection / future click handlers — not used yet.
-            circle.setAttribute('data-embryo-id', emb.id || '');
-            circle.setAttribute('data-embryo-stage', isFine ? 'fine' : 'coarse');
-            _mapEmbryos.appendChild(circle);
+            group.appendChild(circle);
 
             const label = document.createElementNS(SVG_NS, 'text');
             label.setAttribute('x', xy.x);
@@ -828,10 +841,150 @@ const DevicesManager = (function () {
             label.setAttribute('class', 'devices-embryo-label');
             label.setAttribute('font-size', fontSize);
             label.textContent = embryoLabelText(emb.id, i);
-            _mapEmbryos.appendChild(label);
+            group.appendChild(label);
+
+            _mapEmbryos.appendChild(group);
         });
     }
 
+    // ---- Map-side edit interactions ------------------------------------
+    // Convert a pointer event's client coords into stage µm. SVG y axis is
+    // positive-down and stage y is positive-up, so the y component is
+    // negated to match the convention used elsewhere in this module.
+    function eventToStageXY(event) {
+        if (!_mapSvg || !_mapSvg.getScreenCTM) return null;
+        const ctm = _mapSvg.getScreenCTM();
+        if (!ctm) return null;
+        const pt = _mapSvg.createSVGPoint();
+        pt.x = event.clientX;
+        pt.y = event.clientY;
+        const local = pt.matrixTransform(ctm.inverse());
+        return { x: local.x, y: -local.y };
+    }
+
+    function findEmbryoIdAt(target) {
+        if (!target) return null;
+        const node = target.closest && target.closest('[data-embryo-id]');
+        return node ? node.getAttribute('data-embryo-id') : null;
+    }
+
+    function embryoById(id) {
+        return _embryos.find(e => e.id === id) || null;
+    }
+
+    function embryoNumberFor(emb) {
+        return embryoLabelText(emb.id, _embryos.indexOf(emb));
+    }
+
+    function setSelectedEmbryo(id) {
+        if (_selectedEmbryoId === id) return;
+        _selectedEmbryoId = id;
+        renderEmbryos();
+    }
+
+    function clearSelection() {
+        if (_selectedEmbryoId === null) return;
+        _selectedEmbryoId = null;
+        renderEmbryos();
+    }
+
+    async function attemptMoveSelected(targetStage) {
+        const id = _selectedEmbryoId;
+        if (!id) return;
+        const emb = embryoById(id);
+        if (!emb) { clearSelection(); return; }
+        const cur = embryoResolvedXY(emb);
+        const num = embryoNumberFor(emb);
+        const oldStr = cur ? `(${cur.x.toFixed(1)}, ${cur.y.toFixed(1)})` : '(unknown)';
+        const newStr = `(${targetStage.x.toFixed(1)}, ${targetStage.y.toFixed(1)})`;
+        if (!window.confirm(`Move embryo ${num} from ${oldStr} to ${newStr}?`)) {
+            return;  // keep the embryo picked up so they can try again
+        }
+        try {
+            const res = await fetch(`/api/embryos/${encodeURIComponent(id)}/position`, {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ x: targetStage.x, y: targetStage.y }),
+            });
+            if (!res.ok) {
+                window.alert(`Move failed (${res.status}): ${await res.text()}`);
+                return;
+            }
+            // EMBRYOS_UPDATE will arrive over the bus and refresh the layer;
+            // dropping clears the picked-up state regardless.
+            clearSelection();
+        } catch (err) {
+            console.error('move embryo:', err);
+            window.alert(`Move failed: ${err.message}`);
+        }
+    }
+
+    async function attemptDeleteSelected() {
+        const id = _selectedEmbryoId;
+        if (!id) return;
+        const emb = embryoById(id);
+        const num = emb ? embryoNumberFor(emb) : id;
+        if (!window.confirm(`Remove embryo ${num}?`)) return;
+        try {
+            const res = await fetch(`/api/embryos/${encodeURIComponent(id)}`, {
+                method: 'DELETE',
+            });
+            if (!res.ok) {
+                window.alert(`Delete failed (${res.status}): ${await res.text()}`);
+                return;
+            }
+            // The embryo is gone from the server snapshot; EMBRYOS_UPDATE
+            // will arrive and drop it from _embryos. Clear locally too.
+            _selectedEmbryoId = null;
+        } catch (err) {
+            console.error('delete embryo:', err);
+            window.alert(`Delete failed: ${err.message}`);
+        }
+    }
+
+    function onMapPointerDown(event) {
+        // Ignore non-primary buttons so right-clicks etc. don't trigger UI.
+        if (event.button !== undefined && event.button !== 0) return;
+        const id = findEmbryoIdAt(event.target);
+        if (id) {
+            setSelectedEmbryo(id);
+            return;
+        }
+        // Empty-space click: drop the picked-up embryo here.
+        if (_selectedEmbryoId !== null) {
+            const stage = eventToStageXY(event);
+            if (stage) attemptMoveSelected(stage);
+        }
+    }
+
+    function onMapKeyDown(event) {
+        // Only honour keys when the operator is actually looking at the Map:
+        // not on another top-level tab, not on the Details subview, and not
+        // typing into an input / textarea / select / contenteditable.
+        if (typeof state !== 'undefined' && typeof TABS !== 'undefined'
+                && state.tab !== TABS.DEVICES) {
+            return;
+        }
+        if (_currentView !== 'map') return;
+        const a = document.activeElement;
+        if (a && (a.tagName === 'INPUT' || a.tagName === 'TEXTAREA' ||
+                  a.tagName === 'SELECT' || a.isContentEditable)) {
+            return;
+        }
+        if (event.key === 'Escape') {
+            if (_selectedEmbryoId !== null) {
+                clearSelection();
+                event.preventDefault();
+            }
+            return;
+        }
+        if (_selectedEmbryoId === null) return;
+        if (event.key === 'Delete' || event.key === 'Backspace') {
+            event.preventDefault();  // Backspace would otherwise navigate back
+            attemptDeleteSelected();
+        }
+    }
+
     function updateMapMarker() {
         if (!_mapMarker || !_lastXY) return;
         const sx = _lastXY.X;
@@ -1048,6 +1201,14 @@ const DevicesManager = (function () {
             ClientEventBus.on('EMBRYO_DETECTED', handleEmbryoDetected);
             ClientEventBus.on('STATUS_CHANGED', handleStatusChanged);
         }
+        // Map-side edit handlers. Pointer events on the SVG cover both
+        // "click an embryo" (selects it) and "click empty map" (drops the
+        // selected embryo). Keyboard listener is document-wide but guards
+        // against firing while an input is focused.
+        if (_mapSvg) {
+            _mapSvg.addEventListener('pointerdown', onMapPointerDown);
+        }
+        document.addEventListener('keydown', onMapKeyDown);
         setStatus('stale', 'waiting', 'no payload yet');
         syncInitialCameraState();
         // Stop the camera stream if the tab is closed while it's running,

From 7995cbd852219a1ae8be2c4001af22c49a3a4fb9 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 17:39:27 -0400
Subject: [PATCH 006/314] device_layer: re-enable XY joystick at boot

Tiger persists JoystickEnabled in non-volatile card settings. If a prior
session ever ran SaveCardSettings while the joystick happened to be off,
every subsequent boot inherits that state and the physical controller is
dead. We don't run SaveCardSettings ourselves, so the only way to recover
the joystick was a manual property write -- and there was no way to know
the state had drifted until the operator tried to use it.

DiSPIMXYStage gains enable_joystick(True) that writes JoystickEnabled +
verifies read-back (same pattern as set_firmware_limits). device_layer
calls it at boot right after the firmware soft limits are applied.

Failure is non-fatal: agent can still drive the stage; we just log loud
so the operator knows the joystick is unavailable.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 808fe8130d9e2066927a7d464e951d7f9d88af99)
---
 gently/hardware/dispim/device_layer.py  | 12 +++++++++
 gently/hardware/dispim/devices/stage.py | 34 +++++++++++++++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 1172ba1d..48e19746 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -274,6 +274,18 @@ async def initialize(self):
                 logger.error("Could not apply ASI firmware soft limits: %s", exc)
                 raise
 
+            # Tiger persists JoystickEnabled in non-volatile card settings —
+            # if a prior session ever called SaveCardSettings with the
+            # joystick off, every subsequent boot inherits that state and the
+            # physical controller is dead. Force it on at boot so the
+            # operator's joystick always works regardless of card history.
+            try:
+                xy_stage.enable_joystick(True)
+            except Exception as exc:
+                # Not fatal — the agent can still drive the stage. Log loudly
+                # so the operator knows the joystick is unavailable.
+                logger.error("Could not enable XY joystick: %s", exc)
+
         # [4/5] Initialize RunEngine
         logger.info("[4/5] Initializing RunEngine...")
         self.RE = RunEngine({})
diff --git a/gently/hardware/dispim/devices/stage.py b/gently/hardware/dispim/devices/stage.py
index a179135a..3c922d14 100644
--- a/gently/hardware/dispim/devices/stage.py
+++ b/gently/hardware/dispim/devices/stage.py
@@ -332,6 +332,40 @@ def set_firmware_limits(
                 )
             logger.info("ASI firmware limit %s = %.4f mm (verified)", prop, got)
 
+    def enable_joystick(self, enabled: bool = True) -> None:
+        """Set the ASI Tiger 'JoystickEnabled' property on the XY stage.
+
+        Tiger firmware persists this flag in its non-volatile card settings
+        (touched whenever someone calls SaveCardSettings — we don't, but
+        previous sessions may have). If it persisted as 'No', the physical
+        joystick is dead on boot until something writes 'Yes'. This method
+        is the boot-time fix; it's called from device_layer.initialize right
+        after the firmware soft limits are applied.
+
+        Read-back verified so a silent rejection by the adapter doesn't
+        leave the operator wondering why the controller still doesn't move.
+        """
+        target = "Yes" if enabled else "No"
+        prop = "JoystickEnabled"
+        try:
+            self.core.setProperty(self.name, prop, target)
+        except RuntimeError as exc:
+            raise HardwareError(
+                f"setProperty {prop}={target} failed on {self.name}: {exc}"
+            )
+        try:
+            got = self.core.getProperty(self.name, prop)
+        except RuntimeError as exc:
+            raise HardwareError(
+                f"getProperty {prop} read-back failed on {self.name}: {exc}"
+            )
+        if str(got).strip() != target:
+            raise HardwareError(
+                f"{prop} read-back mismatch on {self.name}: "
+                f"wrote '{target}', controller reports '{got}'."
+            )
+        logger.info("ASI %s.%s = %s (verified)", self.name, prop, got)
+
     # Synchronous convenience methods (usable outside RunEngine)
     def get_position(self) -> np.ndarray:
         """

From feca96aa30cc6d36ac60bdacee75417edb2265c6 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 17:39:39 -0400
Subject: [PATCH 007/314] Devices > Map: image-anchored crosshair +
 scroll-to-zoom in camera panel

Two improvements to the bottom-camera live thumbnail on the Map.

Crosshair (FOV reticle)
-----------------------
A centre crosshair anchored to the image, not the viewer rect. SVG
sibling of <img>; an inner <g> receives the same translate/scale as
the image (in viewBox units, via the SVG transform attribute), so the
lines track the FOV centre through zoom/pan instead of staying pinned
to the container centre. Transform sits on <g> rather than the SVG
element so the renderer re-rasterises at each zoom step -- otherwise
1px strokes get bitmap-scaled and go blurry. vector-effect: non-
scaling-stroke keeps them 1px at any zoom. Default colour amber
(var(--map-warm)).

Zoom / pan
----------
Scroll-wheel over the camera stage zooms in/out (1x to 8x, ~15% per
notch) centred under the cursor. Click and drag pans when zoomed.
Double-click resets to 1x. Pan is clamped so the image centre stays
inside the visible window. Stream stop also resets the transform so
the next session starts at 1x. wheel listener is passive:false so the
page doesn't scroll under the operator's hand.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit f7a13d694f157f50813ecec9ac115859d2a5b295)
---
 gently/ui/web/static/css/main.css  |  35 ++++++++
 gently/ui/web/static/js/devices.js | 137 +++++++++++++++++++++++++++++
 gently/ui/web/templates/index.html |  14 +++
 3 files changed, 186 insertions(+)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 9e975176..ef4dac96 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9684,9 +9684,44 @@ body.modal-open {
     display: block;
     opacity: 0;
     transition: opacity 0.25s;
+    /* Zoom anchored at frame centre; scroll-wheel + cursor adjust translate
+       so the point under the cursor stays under the cursor. */
+    transform-origin: center center;
+    will-change: transform;
 }
 .devices-camera-img.has-frame { opacity: 1; }
 
+/* Cursor hints for zoom/pan mode. Default cursor stays untouched at zoom 1
+   so the operator can still interact with overlays under the camera. */
+.devices-camera-stage.camera-zoomed   { cursor: grab; }
+.devices-camera-stage.camera-panning  { cursor: grabbing; }
+
+/* Centre reticle — full-span horizontal + vertical hairline marking the
+   FOV centre IN the image. SVG is a sibling of <img>; the inner <g>
+   receives the same translate/scale (in viewBox units) so the lines
+   track the camera image through zoom/pan instead of staying pinned to
+   the viewer rect. Transform lives on the <g>, not the SVG element, so
+   the renderer re-rasterises at each zoom step — otherwise the strokes
+   get bitmap-scaled and go blurry. */
+.devices-camera-crosshair {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+    pointer-events: none;
+    opacity: 0;
+    transition: opacity 0.25s;
+}
+.devices-camera-stage:has(.devices-camera-img.has-frame) .devices-camera-crosshair {
+    opacity: 1;
+}
+.devices-camera-crosshair line {
+    stroke: var(--map-warm);
+    stroke-width: 1;
+    vector-effect: non-scaling-stroke;
+    stroke-opacity: 0.85;
+}
+
 .devices-camera-placeholder {
     position: absolute;
     inset: 0;
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 03d5fbb3..b4cb30d2 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -54,6 +54,7 @@ const DevicesManager = (function () {
 
     // Bottom-camera panel DOM + state
     let _camPanel, _camToggle, _camImg, _camPlaceholder, _camLed, _camMeta;
+    let _camStage, _camCrosshair, _camCrosshairGroup;
     let _camStreaming = false;
     let _camLastFrameTs = 0;
     let _camHasFrame = false;
@@ -61,6 +62,16 @@ const DevicesManager = (function () {
     const _CAM_FPS_WINDOW = 12;
     let _camFrameTimes = [];
 
+    // Camera zoom / pan. Identity transform = (zoom 1, tx 0, ty 0); pan only
+    // engages once zoom > 1. Reset on double-click and on stream-off.
+    let _camZoom = 1;
+    let _camTx = 0;
+    let _camTy = 0;
+    let _camPanLast = null;  // {x, y} clientX/Y of last pointermove during pan
+    const _CAM_ZOOM_MIN = 1;
+    const _CAM_ZOOM_MAX = 8;
+    const _CAM_ZOOM_STEP = 1.15;  // multiplicative per wheel notch
+
     let _lastTs = 0;
     let _previousTs = 0;
     let _lastWallTs = 0;
@@ -118,6 +129,9 @@ const DevicesManager = (function () {
         _camToggle       = document.getElementById('devices-camera-toggle');
         _camImg          = document.getElementById('devices-camera-img');
         _camPlaceholder  = document.getElementById('devices-camera-placeholder');
+        _camStage        = _camPanel ? _camPanel.querySelector('.devices-camera-stage') : null;
+        _camCrosshair    = document.getElementById('devices-camera-crosshair');
+        _camCrosshairGroup = document.getElementById('devices-camera-crosshair-group');
         _camLed          = document.getElementById('devices-camera-led');
         _camMeta         = document.getElementById('devices-camera-meta');
 
@@ -1061,6 +1075,9 @@ const DevicesManager = (function () {
             if (_camPlaceholder) _camPlaceholder.hidden = false;
             if (_camMeta) _camMeta.textContent = 'stream off';
             if (_camStaleTimer) { clearTimeout(_camStaleTimer); _camStaleTimer = null; }
+            // Operator may have zoomed in; reset so the next stream session
+            // starts at 1× rather than inheriting a stale view.
+            resetCameraZoom();
         } else {
             _camFrameTimes = [];
             if (_camMeta) _camMeta.textContent = 'waiting…';
@@ -1122,6 +1139,116 @@ const DevicesManager = (function () {
         }
     }
 
+    // ---- Camera zoom / pan ---------------------------------------------
+    function applyCameraTransform() {
+        if (!_camImg) return;
+        _camImg.style.transform =
+            `translate(${_camTx}px, ${_camTy}px) scale(${_camZoom})`;
+        // Reticle uses an SVG transform attribute on the inner <g> instead
+        // of a CSS transform on the SVG element — same geometric effect,
+        // but the SVG renderer re-rasterises at the new zoom so the 1px
+        // strokes stay crisp instead of getting bitmap-scaled.
+        if (_camCrosshairGroup && _camStage) {
+            const rect = _camStage.getBoundingClientRect();
+            // Convert pixel-space translation to viewBox units (viewBox is
+            // 0..100 in both axes, preserveAspectRatio=none).
+            const txV = rect.width  > 0 ? (_camTx * 100) / rect.width  : 0;
+            const tyV = rect.height > 0 ? (_camTy * 100) / rect.height : 0;
+            // translate(50+tx, 50+ty) scale(zoom) translate(-50, -50) keeps
+            // the viewBox centre (50, 50) as the zoom anchor and offsets by
+            // the converted pixel translation.
+            _camCrosshairGroup.setAttribute(
+                'transform',
+                `translate(${50 + txV} ${50 + tyV}) ` +
+                `scale(${_camZoom}) ` +
+                `translate(-50 -50)`
+            );
+        }
+    }
+
+    function resetCameraZoom() {
+        _camZoom = 1;
+        _camTx = 0;
+        _camTy = 0;
+        applyCameraTransform();
+        if (_camStage) _camStage.classList.remove('camera-zoomed', 'camera-panning');
+    }
+
+    // Keep at least the image centre within the visible window so the
+    // operator can't accidentally pan the entire frame off-screen. At
+    // zoom 1 this collapses to (0, 0).
+    function clampCameraPan() {
+        if (!_camStage) return;
+        const rect = _camStage.getBoundingClientRect();
+        const maxX = (rect.width  * (_camZoom - 1)) / 2;
+        const maxY = (rect.height * (_camZoom - 1)) / 2;
+        _camTx = Math.max(-maxX, Math.min(maxX, _camTx));
+        _camTy = Math.max(-maxY, Math.min(maxY, _camTy));
+    }
+
+    function onCameraWheel(event) {
+        if (!_camStage) return;
+        // Always preventDefault so the page doesn't scroll under the
+        // operator while they're framing a sample.
+        event.preventDefault();
+        const rect = _camStage.getBoundingClientRect();
+        const cx = event.clientX - rect.left - rect.width  / 2;
+        const cy = event.clientY - rect.top  - rect.height / 2;
+        const oldZoom = _camZoom;
+        const factor = event.deltaY < 0 ? _CAM_ZOOM_STEP : 1 / _CAM_ZOOM_STEP;
+        const newZoom = Math.max(_CAM_ZOOM_MIN,
+                                 Math.min(_CAM_ZOOM_MAX, oldZoom * factor));
+        if (newZoom === oldZoom) return;
+
+        // Keep the image point under the cursor anchored under the cursor
+        // across the zoom: cursor_new = cursor_old after the transform
+        // change, which means newT = cursor - (cursor - oldT) * (new/old).
+        const ratio = newZoom / oldZoom;
+        _camTx = cx - (cx - _camTx) * ratio;
+        _camTy = cy - (cy - _camTy) * ratio;
+        _camZoom = newZoom;
+
+        if (Math.abs(_camZoom - 1) < 0.001) {
+            resetCameraZoom();
+            return;
+        }
+        clampCameraPan();
+        applyCameraTransform();
+        _camStage.classList.add('camera-zoomed');
+    }
+
+    function onCameraPointerDown(event) {
+        if (event.button !== 0) return;
+        if (_camZoom <= 1) return;
+        _camPanLast = { x: event.clientX, y: event.clientY };
+        try { _camStage.setPointerCapture(event.pointerId); } catch (_) {}
+        _camStage.classList.add('camera-panning');
+        event.preventDefault();
+    }
+
+    function onCameraPointerMove(event) {
+        if (!_camPanLast) return;
+        _camTx += event.clientX - _camPanLast.x;
+        _camTy += event.clientY - _camPanLast.y;
+        _camPanLast = { x: event.clientX, y: event.clientY };
+        clampCameraPan();
+        applyCameraTransform();
+    }
+
+    function onCameraPointerEnd(event) {
+        if (!_camPanLast) return;
+        _camPanLast = null;
+        try { _camStage.releasePointerCapture(event.pointerId); } catch (_) {}
+        if (_camStage) _camStage.classList.remove('camera-panning');
+    }
+
+    function onCameraDoubleClick(event) {
+        if (_camZoom !== 1 || _camTx !== 0 || _camTy !== 0) {
+            event.preventDefault();
+            resetCameraZoom();
+        }
+    }
+
     function setupCameraWiring() {
         if (!_camToggle) return;
         _camToggle.addEventListener('click', toggleCameraStream);
@@ -1129,6 +1256,16 @@ const DevicesManager = (function () {
         if (typeof ClientEventBus !== 'undefined') {
             ClientEventBus.on('BOTTOM_CAMERA_FRAME', handleCameraFrame);
         }
+        // Camera zoom/pan. wheel needs passive:false so we can preventDefault
+        // and stop the page from scrolling beneath the FOV.
+        if (_camStage) {
+            _camStage.addEventListener('wheel', onCameraWheel, { passive: false });
+            _camStage.addEventListener('pointerdown', onCameraPointerDown);
+            _camStage.addEventListener('pointermove', onCameraPointerMove);
+            _camStage.addEventListener('pointerup', onCameraPointerEnd);
+            _camStage.addEventListener('pointercancel', onCameraPointerEnd);
+            _camStage.addEventListener('dblclick', onCameraDoubleClick);
+        }
     }
 
     // =====================================================================
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index dd3bbfb0..64da673c 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -359,6 +359,20 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                         </div>
                         <div class="devices-camera-stage">
                             <img class="devices-camera-img" id="devices-camera-img" alt="bottom camera live frame">
+                            <!-- Centre reticle. The <g> inside receives the same
+                                 transform as the <img> (re-expressed in viewBox
+                                 units) so it tracks the FOV centre through
+                                 zoom/pan. Transform sits on the inner <g> rather
+                                 than on the SVG element itself, so the renderer
+                                 re-rasterises at the new geometry instead of
+                                 bitmap-scaling 1px strokes. -->
+                            <svg class="devices-camera-crosshair" id="devices-camera-crosshair"
+                                 viewBox="0 0 100 100" preserveAspectRatio="none" aria-hidden="true">
+                                <g id="devices-camera-crosshair-group">
+                                    <line x1="0" y1="50" x2="100" y2="50"/>
+                                    <line x1="50" y1="0" x2="50" y2="100"/>
+                                </g>
+                            </svg>
                             <div class="devices-camera-placeholder" id="devices-camera-placeholder">
                                 <div class="devices-camera-placeholder-icon">
                                     <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round">

From 294f7dc4f8ccfd76bcbac23f7a3e1211a7138705 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 17:40:00 -0400
Subject: [PATCH 008/314] eval: event capture / replay / shadow scaffolding for
 orchestrator A/B

Substrate for testing candidate orchestrator architectures without
running real hardware. Three layers, all under gently/eval/:

EventCapture
  Wildcard-subscribes to an EventBus; appends every Event to a per-
  session events.jsonl (D:/Gently3/sessions/{id}/events.jsonl).
  High-volume telemetry (DEVICE_STATE_UPDATE, BOTTOM_CAMERA_FRAME) is
  filtered out by default so 12-hour sessions don't drown the
  meaningful events under polling noise. Auto-starts in agent init.
  Handles non-JSON-native payloads (numpy, Path, datetime, set,
  Enum, dataclass, bytes) via a fallback serialiser.

EventReplay
  Reads events.jsonl back; publishes via EventBus.publish_event() so
  original timestamps survive (candidates can reason about historical
  cadence). Fast mode (no sleep) and real-time mode with optional
  time_scale. event_types() for cheap pre-flight histogramming.

DecisionLog + Decision + DecisionTrigger
  Per-session decisions.jsonl record. Each Decision captures WHY the
  agent woke up (trigger + detail), WHAT it saw (context summary,
  recent event ids, prompt hash), WHAT it did (tool calls, response
  text), and HOW it went (duration, error). Substrate for diffing
  candidate decisions later.

ShadowRunner + OrchestratorCandidate + NoOpCandidate
  Candidates subscribe to an EventBus alongside production but their
  decisions are LOGGED, not enacted -- never permitted to touch
  hardware by construction. ShadowRunner hosts a set of candidates,
  isolates candidate failures from each other and from the live bus.
  NoOpCandidate ships as worked-example and proof-of-life.

scripts/replay_session.py
  CLI: replay a session by id-prefix, with optional --candidate
  attachment, --real-time + --time-scale, and --histogram pre-flight.

15 unit tests in tests/test_eval.py covering capture filter, non-JSON
payloads, thread safety, replay round-trip (event_type / source /
data / correlation_id / timestamp all preserved), real-time cadence,
time_scale, malformed-line tolerance, decision-log round-trip,
shadow forwarding to multiple candidates, candidate-failure
isolation, and event-type whitelisting.

Phase 6 of the Map-as-embryo-home arc, unlocking offline iteration on
the world-model + decision-moment work (operator-action events,
wake triggers, tiered context).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit d69cc219be8606c669b5d9891316fc6f142e8bf9)
---
 gently/app/agent.py          |  45 +++++
 gently/eval/__init__.py      |  32 +++
 gently/eval/decision_log.py  | 170 ++++++++++++++++
 gently/eval/event_capture.py | 162 ++++++++++++++++
 gently/eval/event_replay.py  | 127 ++++++++++++
 gently/eval/shadow.py        | 229 ++++++++++++++++++++++
 scripts/replay_session.py    | 150 +++++++++++++++
 tests/test_eval.py           | 363 +++++++++++++++++++++++++++++++++++
 8 files changed, 1278 insertions(+)
 create mode 100644 gently/eval/__init__.py
 create mode 100644 gently/eval/decision_log.py
 create mode 100644 gently/eval/event_capture.py
 create mode 100644 gently/eval/event_replay.py
 create mode 100644 gently/eval/shadow.py
 create mode 100644 scripts/replay_session.py
 create mode 100644 tests/test_eval.py

diff --git a/gently/app/agent.py b/gently/app/agent.py
index da7d7b11..b549e0f2 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -146,6 +146,11 @@ def __init__(
         # Interaction logger for structured logging (research data collection)
         self.interaction_logger: Optional[InteractionLogger] = None
 
+        # Event capture — durable log of every EventBus event during this
+        # session. Substrate for offline replay / shadow-mode A/B of
+        # candidate orchestrator architectures.
+        self.event_capture = None
+
         # Timelapse orchestrator (initialized when microscope connected)
         self.timelapse_orchestrator: Optional[TimelapseOrchestrator] = None
 
@@ -208,6 +213,12 @@ def __init__(
         # Initialize interaction logger (for research data collection)
         self._init_interaction_logger()
 
+        # Start event capture into the session folder so offline replay /
+        # shadow-mode testing has a durable input stream. Filters out the
+        # high-volume telemetry types (DEVICE_STATE_UPDATE / BOTTOM_CAMERA_FRAME)
+        # by default so a long timelapse doesn't bury the meaningful events.
+        self._init_event_capture()
+
         # Wire interaction logger and choice handler to conversation manager
         self.conversation.interaction_logger = self.interaction_logger
         self.conversation.choice_handler = self.choice_handler
@@ -457,6 +468,40 @@ def _init_interaction_logger(self):
             logging.getLogger(__name__).warning(f"Failed to init interaction logger: {e}")
             self.interaction_logger = None
 
+    def _init_event_capture(self):
+        """Open the per-session events.jsonl capture.
+
+        Resolves the session folder via FileStore._session_dir so the log
+        sits next to session.yaml / interaction_log.jsonl. Silent no-op
+        when the session folder can't be resolved (e.g. test harness with
+        a stripped-down agent) — replay just won't have a log to read.
+        """
+        from gently.eval import EventCapture
+        try:
+            session_dir = None
+            sid = self.session_id
+            if self.store is not None and sid:
+                session_dir = self.store._session_dir(sid)
+            if session_dir is None:
+                logging.getLogger(__name__).debug(
+                    "EventCapture: no session dir for %s — skipping", sid)
+                return
+            path = session_dir / "events.jsonl"
+            self.event_capture = EventCapture(path)
+            self.event_capture.start(self._event_bus)
+        except Exception:
+            logging.getLogger(__name__).exception("Failed to init event capture")
+            self.event_capture = None
+
+    def stop_event_capture(self):
+        """Flush + close the events.jsonl. Idempotent; safe at shutdown."""
+        if self.event_capture is not None:
+            try:
+                self.event_capture.stop()
+            except Exception:
+                logging.getLogger(__name__).exception("EventCapture stop failed")
+            self.event_capture = None
+
     def _init_timelapse_orchestrator(self):
         """Initialize the timelapse orchestrator if microscope is connected."""
         if not self._has_microscope():
diff --git a/gently/eval/__init__.py b/gently/eval/__init__.py
new file mode 100644
index 00000000..3c4ed22b
--- /dev/null
+++ b/gently/eval/__init__.py
@@ -0,0 +1,32 @@
+"""Eval / replay / shadow primitives.
+
+Substrate for testing orchestrator architectures without running real
+hardware. The three layers:
+
+  EventCapture — records every EventBus event to a per-session jsonl
+                 file so the agent's input stream is durable.
+  EventReplay  — reads a captured jsonl and republishes events to a
+                 target bus, preserving original timestamps.
+  ShadowRunner — hosts candidate orchestrators that subscribe to the
+                 live (or replayed) bus, log their decisions, and
+                 never touch hardware. Diff their decision logs to
+                 compare architectures.
+
+See docs/EVAL.md (TODO) for usage.
+"""
+
+from .event_capture import EventCapture
+from .event_replay import EventReplay
+from .decision_log import Decision, DecisionLog, DecisionTrigger
+from .shadow import OrchestratorCandidate, ShadowRunner, NoOpCandidate
+
+__all__ = [
+    "EventCapture",
+    "EventReplay",
+    "Decision",
+    "DecisionLog",
+    "DecisionTrigger",
+    "OrchestratorCandidate",
+    "ShadowRunner",
+    "NoOpCandidate",
+]
diff --git a/gently/eval/decision_log.py b/gently/eval/decision_log.py
new file mode 100644
index 00000000..e6d713e9
--- /dev/null
+++ b/gently/eval/decision_log.py
@@ -0,0 +1,170 @@
+"""DecisionLog — records each "decision moment" the orchestrator (or a
+shadow candidate) acts on.
+
+A "decision moment" is whenever the agent wakes up and produces an output:
+a Claude tool call, a refusal, a chat reply, or even an explicit no-op
+("I see what happened, nothing to do"). Capturing these gives us the diff
+substrate for shadow-mode A/B: same input event stream, different
+candidates, compare what each decided.
+
+File format: one JSON object per line, written to
+D:/Gently3/sessions/{id}/decisions.jsonl (or wherever the caller points
+it). Lossless enough to reconstruct what the agent saw + chose, terse
+enough to skim across sessions.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import threading
+from dataclasses import dataclass, field, asdict
+from datetime import datetime
+from enum import Enum
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from .event_capture import _json_default
+
+logger = logging.getLogger(__name__)
+
+
+class DecisionTrigger(str, Enum):
+    """What woke the agent up for this decision moment."""
+    USER_MESSAGE = "user_message"
+    EVENT         = "event"           # event-driven (perception, error, etc.)
+    TICK          = "tick"            # scheduled / periodic checkpoint
+    PHASE         = "phase"           # plan phase boundary (between embryos / timepoints)
+    STARTUP       = "startup"         # initial session bring-up
+    UNKNOWN       = "unknown"
+
+
+@dataclass
+class Decision:
+    """A single decision moment.
+
+    The fields try to capture three things:
+      WHY the agent woke up: trigger, trigger_detail
+      WHAT it saw: context_summary, recent_event_ids
+      WHAT it did: tool_calls, response_text
+
+    `prompt_hash` is a stable fingerprint of the actual prompt+context
+    sent to Claude so two candidates with byte-identical input but
+    different decisions can be told apart by a single field.
+    """
+    timestamp: datetime
+    agent: str                              # "production" or candidate name
+    trigger: DecisionTrigger
+    trigger_detail: Optional[str] = None    # event_id, user message excerpt, tick name
+
+    tool_calls: List[Dict[str, Any]] = field(default_factory=list)
+    response_text: Optional[str] = None
+    prompt_hash: Optional[str] = None
+
+    context_summary: Optional[str] = None   # one-line description of state
+    recent_event_ids: List[str] = field(default_factory=list)
+
+    duration_ms: Optional[float] = None     # how long the decision took
+    error: Optional[str] = None             # if the decision moment errored
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "timestamp": self.timestamp.isoformat(),
+            "agent": self.agent,
+            "trigger": self.trigger.value,
+            "trigger_detail": self.trigger_detail,
+            "tool_calls": self.tool_calls,
+            "response_text": self.response_text,
+            "prompt_hash": self.prompt_hash,
+            "context_summary": self.context_summary,
+            "recent_event_ids": self.recent_event_ids,
+            "duration_ms": self.duration_ms,
+            "error": self.error,
+        }
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> "Decision":
+        return cls(
+            timestamp=datetime.fromisoformat(d["timestamp"]),
+            agent=d.get("agent", "unknown"),
+            trigger=DecisionTrigger(d.get("trigger", "unknown")),
+            trigger_detail=d.get("trigger_detail"),
+            tool_calls=d.get("tool_calls") or [],
+            response_text=d.get("response_text"),
+            prompt_hash=d.get("prompt_hash"),
+            context_summary=d.get("context_summary"),
+            recent_event_ids=d.get("recent_event_ids") or [],
+            duration_ms=d.get("duration_ms"),
+            error=d.get("error"),
+        )
+
+
+class DecisionLog:
+    """Append-only jsonl sink for Decisions. Thread-safe."""
+
+    def __init__(self, path: Path):
+        self.path = Path(path)
+        self._fp = None
+        self._lock = threading.Lock()
+        self._count = 0
+
+    def open(self) -> None:
+        if self._fp is not None:
+            return
+        self.path.parent.mkdir(parents=True, exist_ok=True)
+        self._fp = self.path.open("a", encoding="utf-8")
+        logger.info("DecisionLog: writing to %s", self.path)
+
+    def close(self) -> None:
+        with self._lock:
+            if self._fp is not None:
+                try:
+                    self._fp.close()
+                except Exception:
+                    logger.exception("DecisionLog: close failed")
+                self._fp = None
+        logger.info("DecisionLog: closed (%d decisions written)", self._count)
+
+    def append(self, decision: Decision) -> None:
+        try:
+            line = json.dumps(decision.to_dict(), default=_json_default)
+        except Exception:
+            logger.exception("DecisionLog: failed to serialise %s", decision)
+            return
+        with self._lock:
+            if self._fp is None:
+                self.open()
+            try:
+                self._fp.write(line + "\n")
+                self._fp.flush()
+                self._count += 1
+            except Exception:
+                logger.exception("DecisionLog: write failed")
+
+    @property
+    def count(self) -> int:
+        return self._count
+
+    def __enter__(self):
+        self.open()
+        return self
+
+    def __exit__(self, exc_type, exc, tb):
+        self.close()
+        return False
+
+    def read(self) -> List[Decision]:
+        """Read every decision back from disk. Quick + dirty diff substrate."""
+        if not self.path.exists():
+            return []
+        out: List[Decision] = []
+        with self.path.open("r", encoding="utf-8") as f:
+            for line_no, raw in enumerate(f, start=1):
+                raw = raw.strip()
+                if not raw:
+                    continue
+                try:
+                    out.append(Decision.from_dict(json.loads(raw)))
+                except Exception:
+                    logger.exception("DecisionLog: parse failure on line %d", line_no)
+        return out
diff --git a/gently/eval/event_capture.py b/gently/eval/event_capture.py
new file mode 100644
index 00000000..c92c9fcd
--- /dev/null
+++ b/gently/eval/event_capture.py
@@ -0,0 +1,162 @@
+"""EventCapture — wildcard-subscribe to an EventBus and append every event
+to a per-session jsonl file.
+
+The captured file is the substrate for replay and shadow-mode testing of
+candidate orchestrators. High-volume telemetry types (DEVICE_STATE_UPDATE,
+BOTTOM_CAMERA_FRAME) are filtered out by default — a 12-hour timelapse
+would otherwise produce ~250 MB of polling noise and drown the meaningful
+events (perception completions, operator actions, errors, plan boundaries).
+Replay can reconstruct world state from the meaningful events plus the
+state-snapshot model; it doesn't need the raw telemetry frames.
+
+File format: one JSON object per line, mirroring Event.to_dict():
+  {
+    "event_type": "EMBRYOS_UPDATE",
+    "data": {...},
+    "source": "agent.experiment",
+    "timestamp": "2026-05-15T15:32:55.123456",
+    "event_id": "abc12345",
+    "correlation_id": null
+  }
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import threading
+from dataclasses import asdict, is_dataclass
+from datetime import date, datetime
+from enum import Enum
+from pathlib import Path
+from typing import Optional, Set
+
+from gently.core.event_bus import Event, EventBus, EventType, _NO_HISTORY_TYPES
+
+logger = logging.getLogger(__name__)
+
+
+class EventCapture:
+    """Append-only jsonl sink for an EventBus.
+
+    Lifecycle:
+      capture = EventCapture(path)
+      capture.start(bus)   # opens file, subscribes
+      ...
+      capture.stop()       # unsubscribes, closes file
+
+    Thread-safe — bus dispatch can come from any thread; writes are
+    serialised through a lock.
+    """
+
+    # By default the same set of high-volume telemetry types the EventBus
+    # itself skips for its history deque. The rationale carries over: at
+    # 5 Hz over hours these would dominate the log without adding signal
+    # that replay / diff can use.
+    DEFAULT_SKIP: Set[EventType] = frozenset(_NO_HISTORY_TYPES)
+
+    def __init__(self, path: Path, *,
+                 skip: Optional[Set[EventType]] = None):
+        self.path = Path(path)
+        self._skip = self.DEFAULT_SKIP if skip is None else frozenset(skip)
+        self._fp = None
+        self._unsub = None
+        self._lock = threading.Lock()
+        self._count = 0
+        self._skipped = 0
+
+    def start(self, bus: EventBus) -> None:
+        """Open the capture file and subscribe to the bus (idempotent)."""
+        if self._fp is not None:
+            return
+        self.path.parent.mkdir(parents=True, exist_ok=True)
+        self._fp = self.path.open("a", encoding="utf-8")
+        # Sync subscription on purpose — capture is fast (single file write)
+        # and we want capture order to match dispatch order without async
+        # scheduling ambiguity.
+        self._unsub = bus.subscribe("*", self._on_event)
+        logger.info("EventCapture: writing to %s", self.path)
+
+    def stop(self) -> None:
+        """Unsubscribe and close the file (idempotent)."""
+        if self._unsub is not None:
+            try:
+                self._unsub()
+            except Exception:
+                logger.exception("EventCapture: unsubscribe failed")
+            self._unsub = None
+        with self._lock:
+            if self._fp is not None:
+                try:
+                    self._fp.close()
+                except Exception:
+                    logger.exception("EventCapture: file close failed")
+                self._fp = None
+        logger.info("EventCapture: closed (%d captured, %d skipped)",
+                    self._count, self._skipped)
+
+    def __del__(self):
+        # Best-effort safety net for cases where the owner forgets to call
+        # stop() — never let a forgotten file handle outlive the process'
+        # capture object. We can't rely on this for correctness (GC timing
+        # is undefined), but it makes tests and dev sessions tidier.
+        try:
+            self.stop()
+        except Exception:
+            pass
+
+    @property
+    def count(self) -> int:
+        return self._count
+
+    def _on_event(self, event: Event) -> None:
+        if event.event_type in self._skip:
+            self._skipped += 1
+            return
+        try:
+            line = json.dumps(event.to_dict(), default=_json_default)
+        except Exception:
+            logger.exception("EventCapture: failed to serialise %s", event)
+            return
+        with self._lock:
+            if self._fp is None:
+                return
+            try:
+                self._fp.write(line + "\n")
+                self._fp.flush()
+                self._count += 1
+            except Exception:
+                logger.exception("EventCapture: write failed for %s", event)
+
+
+def _json_default(obj):
+    """Last-resort serialiser for types json.dumps can't natively handle.
+
+    Designed to be lossy-but-useful: numpy arrays become lists, datetimes
+    become ISO strings, dataclasses become dicts, anything else falls back
+    to repr() so the line is at least valid JSON.
+    """
+    if isinstance(obj, (datetime, date)):
+        return obj.isoformat()
+    if isinstance(obj, Path):
+        return str(obj)
+    if isinstance(obj, Enum):
+        return obj.name
+    if is_dataclass(obj):
+        try:
+            return asdict(obj)
+        except Exception:
+            pass
+    try:
+        import numpy as np
+        if isinstance(obj, np.generic):
+            return obj.item()
+        if isinstance(obj, np.ndarray):
+            return obj.tolist()
+    except ImportError:
+        pass
+    if isinstance(obj, set):
+        return sorted(obj, key=str)
+    if isinstance(obj, bytes):
+        return obj.decode("utf-8", errors="replace")
+    return repr(obj)
diff --git a/gently/eval/event_replay.py b/gently/eval/event_replay.py
new file mode 100644
index 00000000..092ec719
--- /dev/null
+++ b/gently/eval/event_replay.py
@@ -0,0 +1,127 @@
+"""EventReplay — reads a captured events jsonl and republishes events to a
+target EventBus.
+
+Two modes:
+  fast      events as fast as the bus can dispatch (default)
+  real-time inserts sleep delays between events to preserve the original
+            cadence — useful when a candidate's behaviour depends on
+            time-since-last-event
+
+Original Event timestamps are preserved by going through
+EventBus.publish_event() (which keeps the dataclass instance untouched)
+rather than EventBus.publish() (which constructs a fresh Event with
+datetime.now()). Candidates can therefore reason about historical timing
+as if they were live.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import time
+from datetime import datetime
+from pathlib import Path
+from typing import Callable, Iterator, Optional
+
+from gently.core.event_bus import Event, EventBus
+
+logger = logging.getLogger(__name__)
+
+
+class EventReplay:
+    """Stream-replays an events.jsonl into a target bus."""
+
+    def __init__(self, path: Path):
+        self.path = Path(path)
+        if not self.path.exists():
+            raise FileNotFoundError(f"event log not found: {self.path}")
+
+    def events(self) -> Iterator[Event]:
+        """Yield each Event from the captured log, in order.
+
+        Lines that don't parse are skipped with a warning rather than
+        aborting the whole replay — a partial log is better than no log.
+        """
+        with self.path.open("r", encoding="utf-8") as f:
+            for line_no, raw in enumerate(f, start=1):
+                raw = raw.strip()
+                if not raw:
+                    continue
+                try:
+                    record = json.loads(raw)
+                except json.JSONDecodeError:
+                    logger.warning("EventReplay: malformed line %d in %s",
+                                   line_no, self.path)
+                    continue
+                try:
+                    yield Event.from_dict(record)
+                except KeyError:
+                    # Unknown EventType — could be a newer enum the
+                    # capturing process knew about. Skip rather than abort.
+                    logger.warning("EventReplay: unknown event_type on line %d",
+                                   line_no)
+                except Exception:
+                    logger.exception("EventReplay: parse failure on line %d",
+                                     line_no)
+
+    def replay(
+        self,
+        target: EventBus,
+        *,
+        real_time: bool = False,
+        time_scale: float = 1.0,
+        on_event: Optional[Callable[[Event], None]] = None,
+    ) -> int:
+        """Replay the captured events to ``target``. Returns count emitted.
+
+        Parameters
+        ----------
+        target:
+            EventBus to publish into. The bus's existing subscribers (and
+            any shadow candidates registered on it) will see the events.
+        real_time:
+            If True, sleep between events to reproduce the original
+            cadence. If False, dispatch as fast as the bus can handle.
+        time_scale:
+            Only meaningful in real-time mode. ``time_scale=4`` runs the
+            replay at 4× speed (sleep delays divided by 4). Must be > 0.
+        on_event:
+            Optional callback invoked after each event is published, for
+            instrumentation / progress reporting. Exceptions are caught
+            and logged.
+        """
+        if time_scale <= 0:
+            raise ValueError("time_scale must be > 0")
+
+        emitted = 0
+        prev_ts: Optional[datetime] = None
+        wall_start = time.monotonic()
+        for ev in self.events():
+            if real_time and prev_ts is not None:
+                delta = (ev.timestamp - prev_ts).total_seconds() / time_scale
+                if delta > 0:
+                    time.sleep(delta)
+            target.publish_event(ev)
+            emitted += 1
+            if on_event is not None:
+                try:
+                    on_event(ev)
+                except Exception:
+                    logger.exception("EventReplay: on_event callback failed")
+            prev_ts = ev.timestamp
+        wall = time.monotonic() - wall_start
+        logger.info(
+            "EventReplay: emitted %d events in %.2fs (real_time=%s, time_scale=%g)",
+            emitted, wall, real_time, time_scale,
+        )
+        return emitted
+
+    def event_types(self) -> dict:
+        """Return a {EventType.name: count} histogram of the log.
+
+        Cheap pre-flight diagnostic before running an expensive replay.
+        """
+        counts: dict = {}
+        for ev in self.events():
+            counts[ev.event_type.name] = counts.get(ev.event_type.name, 0) + 1
+        return counts
diff --git a/gently/eval/shadow.py b/gently/eval/shadow.py
new file mode 100644
index 00000000..05335c96
--- /dev/null
+++ b/gently/eval/shadow.py
@@ -0,0 +1,229 @@
+"""Shadow orchestrator scaffolding.
+
+A candidate orchestrator runs alongside production: it sees the same
+events but its decisions are LOGGED, not enacted. Diff the decision logs
+between production and a candidate (or between two candidates) to compare
+architectures on identical input streams.
+
+Two entry points:
+
+  OrchestratorCandidate
+    Protocol that any candidate must satisfy. Receives events via
+    on_event() and ticks via on_tick(); is given a DecisionLog to write
+    into. Never gets to call tools that touch hardware — by construction
+    its only output is the log.
+
+  ShadowRunner
+    Hosts a set of candidates against a single EventBus. Wildcards onto
+    the bus and forwards each event to every registered candidate.
+    Lifecycle (start / stop) keeps subscriptions tidy.
+
+The simplest candidate is NoOpCandidate, included as a worked example
+and as proof-of-life for the wiring (events visible? decision log
+writeable? shutdown clean?).
+"""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+import threading
+from abc import ABC, abstractmethod
+from datetime import datetime
+from pathlib import Path
+from typing import Awaitable, Callable, Dict, List, Optional
+
+from gently.core.event_bus import Event, EventBus
+
+from .decision_log import Decision, DecisionLog, DecisionTrigger
+
+logger = logging.getLogger(__name__)
+
+
+class OrchestratorCandidate(ABC):
+    """Base class for a shadow orchestrator candidate.
+
+    A candidate is given:
+      - its name (e.g. "reactive-v1", "haiku-summariser")
+      - a DecisionLog to write decisions into
+
+    It receives events synchronously via ``on_event``. If it needs to
+    do heavy work (LLM call, long compute), it should hand off to its
+    own task / thread and write into the log asynchronously.
+
+    Candidates MUST NOT touch hardware. They have no access to the
+    device-layer client, no permission to publish events back onto the
+    bus, no MMCore handle. The only side effect they're allowed is
+    writing to their decision log.
+    """
+
+    def __init__(self, name: str, decisions: DecisionLog):
+        self.name = name
+        self.decisions = decisions
+
+    @abstractmethod
+    def on_event(self, event: Event) -> None:
+        """Handle one event from the bus. Synchronous, must not block long."""
+
+    def on_start(self) -> None:
+        """Called once when the shadow runner attaches this candidate."""
+
+    def on_stop(self) -> None:
+        """Called once when the shadow runner detaches this candidate."""
+
+    # ---- helpers candidates can use ---------------------------------------
+
+    def log_decision(
+        self,
+        *,
+        trigger: DecisionTrigger,
+        trigger_detail: Optional[str] = None,
+        tool_calls: Optional[List[Dict]] = None,
+        response_text: Optional[str] = None,
+        context_summary: Optional[str] = None,
+        recent_event_ids: Optional[List[str]] = None,
+        prompt_hash: Optional[str] = None,
+        duration_ms: Optional[float] = None,
+        error: Optional[str] = None,
+    ) -> None:
+        self.decisions.append(Decision(
+            timestamp=datetime.now(),
+            agent=self.name,
+            trigger=trigger,
+            trigger_detail=trigger_detail,
+            tool_calls=tool_calls or [],
+            response_text=response_text,
+            context_summary=context_summary,
+            recent_event_ids=recent_event_ids or [],
+            prompt_hash=prompt_hash,
+            duration_ms=duration_ms,
+            error=error,
+        ))
+
+
+class NoOpCandidate(OrchestratorCandidate):
+    """Trivial candidate: logs every event it sees as a decision marker.
+
+    Useful as the smoke test for the wiring (events visible? decision
+    log writeable? shutdown clean?) and as the template every real
+    candidate evolves from.
+    """
+
+    def __init__(self, name: str, decisions: DecisionLog,
+                 *, watch: Optional[List[str]] = None):
+        super().__init__(name, decisions)
+        # Optional whitelist of event_type names to react to. None = all.
+        self._watch = set(watch) if watch else None
+        self._seen = 0
+
+    def on_event(self, event: Event) -> None:
+        if self._watch is not None and event.event_type.name not in self._watch:
+            return
+        self._seen += 1
+        self.log_decision(
+            trigger=DecisionTrigger.EVENT,
+            trigger_detail=event.event_type.name,
+            response_text=f"(noop) seen {event.event_type.name} from {event.source}",
+            recent_event_ids=[event.event_id],
+            context_summary=f"noop candidate; events seen so far: {self._seen}",
+        )
+
+
+class ShadowRunner:
+    """Hosts a set of OrchestratorCandidates against an EventBus.
+
+    Wildcards onto the bus, dispatches each event to every registered
+    candidate. Candidates' exceptions are caught and logged so one
+    bad candidate doesn't take down the others or affect the live bus.
+
+    The runner itself never enacts decisions — it only forwards events
+    and lets candidates write their own logs.
+    """
+
+    def __init__(self, bus: EventBus):
+        self.bus = bus
+        self._candidates: List[OrchestratorCandidate] = []
+        self._unsub: Optional[Callable[[], None]] = None
+        self._lock = threading.RLock()
+        self._running = False
+
+    def add(self, candidate: OrchestratorCandidate) -> None:
+        with self._lock:
+            self._candidates.append(candidate)
+            if self._running:
+                try:
+                    candidate.on_start()
+                except Exception:
+                    logger.exception(
+                        "ShadowRunner: on_start failed for %s", candidate.name
+                    )
+
+    def remove(self, candidate: OrchestratorCandidate) -> None:
+        with self._lock:
+            try:
+                self._candidates.remove(candidate)
+            except ValueError:
+                return
+            try:
+                candidate.on_stop()
+            except Exception:
+                logger.exception(
+                    "ShadowRunner: on_stop failed for %s", candidate.name
+                )
+
+    def start(self) -> None:
+        """Subscribe to the bus and notify every candidate. Idempotent."""
+        with self._lock:
+            if self._running:
+                return
+            self._unsub = self.bus.subscribe("*", self._on_event)
+            for c in self._candidates:
+                try:
+                    c.on_start()
+                except Exception:
+                    logger.exception(
+                        "ShadowRunner: on_start failed for %s", c.name
+                    )
+            self._running = True
+        logger.info(
+            "ShadowRunner: started with %d candidate(s)", len(self._candidates)
+        )
+
+    def stop(self) -> None:
+        """Unsubscribe from the bus and notify every candidate. Idempotent."""
+        with self._lock:
+            if not self._running:
+                return
+            if self._unsub is not None:
+                try:
+                    self._unsub()
+                except Exception:
+                    logger.exception("ShadowRunner: unsubscribe failed")
+                self._unsub = None
+            for c in self._candidates:
+                try:
+                    c.on_stop()
+                except Exception:
+                    logger.exception(
+                        "ShadowRunner: on_stop failed for %s", c.name
+                    )
+            self._running = False
+        logger.info("ShadowRunner: stopped")
+
+    @property
+    def candidates(self) -> List[OrchestratorCandidate]:
+        with self._lock:
+            return list(self._candidates)
+
+    def _on_event(self, event: Event) -> None:
+        # Snapshot under the lock so a remove() mid-dispatch doesn't break us.
+        with self._lock:
+            candidates = list(self._candidates)
+        for c in candidates:
+            try:
+                c.on_event(event)
+            except Exception:
+                logger.exception(
+                    "ShadowRunner: candidate %s raised on %s",
+                    c.name, event,
+                )
diff --git a/scripts/replay_session.py b/scripts/replay_session.py
new file mode 100644
index 00000000..f8ffe208
--- /dev/null
+++ b/scripts/replay_session.py
@@ -0,0 +1,150 @@
+#!/usr/bin/env python
+"""Replay a captured session's events into a fresh EventBus.
+
+Useful for:
+  - Diffing what a candidate orchestrator would have decided from the
+    same input stream the production agent saw.
+  - Inspecting the event histogram of a session before deciding what to
+    investigate ("did this session even fire any ERROR_OCCURRED?").
+  - Re-running a session offline with a different filter / candidate
+    set without touching hardware.
+
+Examples
+--------
+List the events recorded in a session:
+    python scripts/replay_session.py 2e0e0356 --histogram
+
+Replay as fast as possible:
+    python scripts/replay_session.py 2e0e0356
+
+Replay with original cadence, 4x speed, and a NoOpCandidate writing a
+decision log into the current directory:
+    python scripts/replay_session.py 2e0e0356 --real-time --time-scale 4 --candidate noop-test
+
+Custom root (default: $GENTLY_STORAGE_PATH or D:/Gently3):
+    python scripts/replay_session.py 2e0e0356 --root /path/to/sessions
+"""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import os
+import sys
+from pathlib import Path
+
+# Allow `python scripts/replay_session.py …` from the repo root without
+# requiring PYTHONPATH=.; the project root is one level up from this file.
+_REPO_ROOT = Path(__file__).resolve().parent.parent
+if str(_REPO_ROOT) not in sys.path:
+    sys.path.insert(0, str(_REPO_ROOT))
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(
+        description=__doc__,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument(
+        "session_id",
+        help="Session id (full or prefix) to replay",
+    )
+    parser.add_argument(
+        "--root",
+        default=None,
+        help="Storage root (default: $GENTLY_STORAGE_PATH or D:/Gently3)",
+    )
+    parser.add_argument(
+        "--real-time",
+        action="store_true",
+        help="Preserve original cadence between events (default: fast)",
+    )
+    parser.add_argument(
+        "--time-scale",
+        type=float,
+        default=1.0,
+        help="Real-time replay speed multiplier (default: 1.0)",
+    )
+    parser.add_argument(
+        "--candidate",
+        default=None,
+        help="Attach a NoOpCandidate; decisions written to replay-decisions-<sid>.jsonl",
+    )
+    parser.add_argument(
+        "--histogram",
+        action="store_true",
+        help="Print event-type histogram, don't replay",
+    )
+    parser.add_argument(
+        "-v", "--verbose", action="store_true",
+        help="Verbose logging",
+    )
+    args = parser.parse_args(argv)
+
+    logging.basicConfig(
+        level=logging.DEBUG if args.verbose else logging.INFO,
+        format="%(asctime)s %(levelname)s %(name)s %(message)s",
+    )
+
+    from gently.core.event_bus import EventBus
+    from gently.core.file_store import FileStore
+    from gently.eval import EventReplay, DecisionLog, ShadowRunner, NoOpCandidate
+
+    root = args.root or os.environ.get("GENTLY_STORAGE_PATH", "D:/Gently3")
+    store = FileStore(root=Path(root))
+
+    sessions = store.list_sessions()
+    matches = [s for s in sessions if s["session_id"].startswith(args.session_id)]
+    if not matches:
+        print(f"No session matching '{args.session_id}'", file=sys.stderr)
+        return 1
+    if len(matches) > 1:
+        print(f"Multiple sessions match '{args.session_id}':", file=sys.stderr)
+        for s in matches:
+            print(f"  {s['session_id']}", file=sys.stderr)
+        return 1
+
+    session = matches[0]
+    session_dir = store._session_dir(session["session_id"])
+    log_path = session_dir / "events.jsonl"
+    if not log_path.exists():
+        print(f"No events.jsonl in {session_dir}", file=sys.stderr)
+        return 1
+
+    rep = EventReplay(log_path)
+
+    if args.histogram:
+        hist = rep.event_types()
+        total = sum(hist.values())
+        print(f"{total} events in {log_path}:")
+        for ev, n in sorted(hist.items(), key=lambda kv: -kv[1]):
+            print(f"  {n:>6}  {ev}")
+        return 0
+
+    bus = EventBus()
+    runner = None
+    dlog = None
+    if args.candidate:
+        out = Path.cwd() / f"replay-decisions-{session['session_id'][:8]}.jsonl"
+        dlog = DecisionLog(out)
+        dlog.open()
+        runner = ShadowRunner(bus)
+        runner.add(NoOpCandidate(args.candidate, dlog))
+        runner.start()
+        print(f"Candidate '{args.candidate}' attached; decisions -> {out}")
+
+    try:
+        emitted = rep.replay(
+            bus, real_time=args.real_time, time_scale=args.time_scale,
+        )
+        print(f"Replayed {emitted} events from session {session['session_id']}")
+    finally:
+        if runner is not None:
+            runner.stop()
+        if dlog is not None:
+            dlog.close()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_eval.py b/tests/test_eval.py
new file mode 100644
index 00000000..8bc97064
--- /dev/null
+++ b/tests/test_eval.py
@@ -0,0 +1,363 @@
+"""Tests for the gently.eval package: capture / replay / shadow."""
+
+from __future__ import annotations
+
+import json
+import threading
+import time
+from datetime import datetime
+from pathlib import Path
+
+import numpy as np
+import pytest
+
+from gently.core.event_bus import EventBus, EventType, Event
+from gently.eval import (
+    Decision,
+    DecisionLog,
+    DecisionTrigger,
+    EventCapture,
+    EventReplay,
+    NoOpCandidate,
+    ShadowRunner,
+)
+
+
+# =============================================================================
+# EventCapture
+# =============================================================================
+
+def test_capture_writes_meaningful_events_skips_telemetry(tmp_path: Path):
+    """Capture skips high-volume telemetry by default but keeps the rest."""
+    bus = EventBus()
+    log = tmp_path / "events.jsonl"
+    cap = EventCapture(log)
+    cap.start(bus)
+
+    bus.publish(EventType.EMBRYOS_UPDATE, {"a": 1}, source="t")
+    bus.publish(EventType.DEVICE_STATE_UPDATE, {"x": 0}, source="t")  # skipped
+    bus.publish(EventType.STAGE_MOVED, {"x": 100.0}, source="t")
+    bus.publish(EventType.BOTTOM_CAMERA_FRAME, {"jpeg": ""}, source="t")  # skipped
+    cap.stop()
+
+    assert cap.count == 2  # the two non-telemetry events
+    lines = log.read_text(encoding="utf-8").strip().split("\n")
+    assert len(lines) == 2
+    parsed = [json.loads(ln) for ln in lines]
+    assert {p["event_type"] for p in parsed} == {"EMBRYOS_UPDATE", "STAGE_MOVED"}
+
+
+def test_capture_handles_non_json_native_payloads(tmp_path: Path):
+    """numpy scalars / arrays / Paths / datetimes / sets serialise cleanly."""
+    bus = EventBus()
+    log = tmp_path / "events.jsonl"
+    cap = EventCapture(log)
+    cap.start(bus)
+
+    bus.publish(EventType.STAGE_MOVED, {
+        "np_scalar": np.float64(1.5),
+        "np_array": np.array([1, 2, 3]),
+        "path": Path("/tmp/foo.tif"),
+        "now": datetime(2026, 5, 15, 12, 0, 0),
+        "as_set": {"a", "b"},
+    }, source="t")
+    cap.stop()
+
+    record = json.loads(log.read_text().strip())
+    data = record["data"]
+    assert data["np_scalar"] == pytest.approx(1.5)
+    assert data["np_array"] == [1, 2, 3]
+    assert "tmp" in data["path"] and "foo.tif" in data["path"]
+    assert data["now"] == "2026-05-15T12:00:00"
+    assert sorted(data["as_set"]) == ["a", "b"]
+
+
+def test_capture_start_stop_idempotent(tmp_path: Path):
+    """Repeated start / stop don't error or duplicate subscribers."""
+    bus = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(bus)
+    cap.start(bus)  # second start = no-op
+    bus.publish(EventType.STAGE_MOVED, {}, source="t")
+    cap.stop()
+    cap.stop()  # second stop = no-op
+    # Even with two start() calls the single subscription captures the event
+    # exactly once.
+    assert cap.count == 1
+
+
+def test_capture_thread_safety(tmp_path: Path):
+    """Concurrent publishers from many threads all land in the log."""
+    bus = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(bus)
+
+    N_THREADS = 8
+    N_EVENTS_PER_THREAD = 50
+
+    def worker(idx: int):
+        for i in range(N_EVENTS_PER_THREAD):
+            bus.publish(EventType.STAGE_MOVED,
+                        {"t": idx, "i": i}, source=f"thread-{idx}")
+
+    threads = [threading.Thread(target=worker, args=(i,)) for i in range(N_THREADS)]
+    for t in threads:
+        t.start()
+    for t in threads:
+        t.join()
+
+    cap.stop()
+    # All events visible, jsonl is well-formed (each line a valid JSON object).
+    assert cap.count == N_THREADS * N_EVENTS_PER_THREAD
+    lines = (tmp_path / "events.jsonl").read_text().strip().split("\n")
+    assert len(lines) == N_THREADS * N_EVENTS_PER_THREAD
+    for ln in lines:
+        json.loads(ln)
+
+
+# =============================================================================
+# EventReplay
+# =============================================================================
+
+def test_replay_preserves_event_fields(tmp_path: Path):
+    """Round-trip: capture, then replay, then verify Event field identity."""
+    src_bus = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(src_bus)
+
+    e1 = src_bus.publish(EventType.EMBRYOS_UPDATE,
+                          {"embryos": [{"id": "e1"}], "count": 1},
+                          source="capture-test", correlation_id="corr-A")
+    e2 = src_bus.publish(EventType.ERROR_OCCURRED,
+                          {"msg": "bang"}, source="capture-test")
+    cap.stop()
+
+    rep = EventReplay(tmp_path / "events.jsonl")
+    dest = EventBus()
+    received: list[Event] = []
+    dest.subscribe("*", lambda ev: received.append(ev))
+    rep.replay(dest)
+
+    assert len(received) == 2
+
+    # event_type, source, correlation_id, event_id, timestamp preserved
+    by_id = {r.event_id: r for r in received}
+    r1 = by_id[e1.event_id]
+    r2 = by_id[e2.event_id]
+    assert r1.event_type == EventType.EMBRYOS_UPDATE
+    assert r1.source == "capture-test"
+    assert r1.correlation_id == "corr-A"
+    assert r1.data == e1.data
+    assert r1.timestamp == e1.timestamp
+    assert r2.event_type == EventType.ERROR_OCCURRED
+    assert r2.timestamp == e2.timestamp
+
+
+def test_replay_histogram(tmp_path: Path):
+    bus = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(bus)
+    bus.publish(EventType.STAGE_MOVED, {}, source="t")
+    bus.publish(EventType.STAGE_MOVED, {}, source="t")
+    bus.publish(EventType.EMBRYOS_UPDATE, {}, source="t")
+    cap.stop()
+
+    rep = EventReplay(tmp_path / "events.jsonl")
+    hist = rep.event_types()
+    assert hist == {"STAGE_MOVED": 2, "EMBRYOS_UPDATE": 1}
+
+
+def test_replay_real_time_respects_cadence(tmp_path: Path):
+    """Two events 200 ms apart replay in ~200 ms in real-time mode."""
+    bus = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(bus)
+    bus.publish(EventType.STAGE_MOVED, {"i": 0}, source="t")
+    time.sleep(0.2)
+    bus.publish(EventType.STAGE_MOVED, {"i": 1}, source="t")
+    cap.stop()
+
+    dest = EventBus()
+    dest.subscribe("*", lambda ev: None)
+
+    t0 = time.monotonic()
+    EventReplay(tmp_path / "events.jsonl").replay(dest, real_time=True)
+    elapsed = time.monotonic() - t0
+    assert 0.10 < elapsed < 0.40, f"real-time elapsed={elapsed}"
+
+
+def test_replay_time_scale_speeds_up(tmp_path: Path):
+    """time_scale=4 should approximately quarter the real-time wall delay."""
+    bus = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(bus)
+    bus.publish(EventType.STAGE_MOVED, {"i": 0}, source="t")
+    time.sleep(0.4)
+    bus.publish(EventType.STAGE_MOVED, {"i": 1}, source="t")
+    cap.stop()
+
+    dest = EventBus()
+    dest.subscribe("*", lambda ev: None)
+    t0 = time.monotonic()
+    EventReplay(tmp_path / "events.jsonl").replay(
+        dest, real_time=True, time_scale=4.0,
+    )
+    elapsed = time.monotonic() - t0
+    # 0.4s scaled by 4 -> ~0.1s, with generous slack for scheduling.
+    assert 0.03 < elapsed < 0.30, f"scaled elapsed={elapsed}"
+
+
+def test_replay_skips_malformed_lines(tmp_path: Path):
+    """A garbage line in the log doesn't abort the whole replay."""
+    log = tmp_path / "events.jsonl"
+    log.write_text(
+        json.dumps({
+            "event_type": "STAGE_MOVED", "data": {}, "source": "t",
+            "timestamp": "2026-01-01T00:00:00", "event_id": "abc",
+            "correlation_id": None,
+        }) + "\n"
+        "not valid json garbage\n"
+        + json.dumps({
+            "event_type": "EMBRYOS_UPDATE", "data": {}, "source": "t",
+            "timestamp": "2026-01-01T00:00:01", "event_id": "def",
+            "correlation_id": None,
+        }) + "\n",
+        encoding="utf-8",
+    )
+    rep = EventReplay(log)
+    seen = list(rep.events())
+    assert [s.event_type.name for s in seen] == ["STAGE_MOVED", "EMBRYOS_UPDATE"]
+
+
+def test_replay_missing_file_raises(tmp_path: Path):
+    with pytest.raises(FileNotFoundError):
+        EventReplay(tmp_path / "nope.jsonl")
+
+
+# =============================================================================
+# DecisionLog
+# =============================================================================
+
+def test_decision_log_round_trip(tmp_path: Path):
+    log_path = tmp_path / "decisions.jsonl"
+    dlog = DecisionLog(log_path)
+    dlog.open()
+
+    d1 = Decision(
+        timestamp=datetime(2026, 5, 15, 12, 0, 0),
+        agent="prod",
+        trigger=DecisionTrigger.USER_MESSAGE,
+        trigger_detail="detect embryos",
+        tool_calls=[{"name": "detect_embryos", "input": {}}],
+        response_text="Detected 4 embryos.",
+        context_summary="2 embryos active",
+        recent_event_ids=["abc12345"],
+        prompt_hash="deadbeef",
+        duration_ms=820.5,
+    )
+    dlog.append(d1)
+    dlog.append(Decision(
+        timestamp=datetime(2026, 5, 15, 12, 0, 5),
+        agent="prod",
+        trigger=DecisionTrigger.EVENT,
+        trigger_detail="EMBRYOS_UPDATE",
+        error=None,
+    ))
+    dlog.close()
+
+    back = dlog.read()
+    assert len(back) == 2
+    assert back[0].agent == "prod"
+    assert back[0].trigger is DecisionTrigger.USER_MESSAGE
+    assert back[0].tool_calls == [{"name": "detect_embryos", "input": {}}]
+    assert back[0].duration_ms == pytest.approx(820.5)
+    assert back[1].trigger is DecisionTrigger.EVENT
+    assert back[1].trigger_detail == "EMBRYOS_UPDATE"
+
+
+def test_decision_log_context_manager(tmp_path: Path):
+    log_path = tmp_path / "decisions.jsonl"
+    with DecisionLog(log_path) as dlog:
+        dlog.append(Decision(
+            timestamp=datetime.now(),
+            agent="t",
+            trigger=DecisionTrigger.TICK,
+        ))
+    assert log_path.exists()
+    assert len(log_path.read_text().splitlines()) == 1
+
+
+# =============================================================================
+# ShadowRunner + NoOpCandidate
+# =============================================================================
+
+def test_shadow_runner_forwards_to_all_candidates(tmp_path: Path):
+    bus = EventBus()
+    log_a = DecisionLog(tmp_path / "a.jsonl")
+    log_b = DecisionLog(tmp_path / "b.jsonl")
+    log_a.open()
+    log_b.open()
+
+    cand_a = NoOpCandidate("cand-a", log_a)
+    cand_b = NoOpCandidate("cand-b", log_b)
+    runner = ShadowRunner(bus)
+    runner.add(cand_a)
+    runner.add(cand_b)
+    runner.start()
+
+    bus.publish(EventType.STAGE_MOVED, {"x": 1}, source="t")
+    bus.publish(EventType.EMBRYOS_UPDATE, {"count": 1}, source="t")
+    runner.stop()
+    log_a.close()
+    log_b.close()
+
+    decisions_a = log_a.read()
+    decisions_b = log_b.read()
+    assert len(decisions_a) == 2
+    assert len(decisions_b) == 2
+    assert [d.trigger_detail for d in decisions_a] == ["STAGE_MOVED", "EMBRYOS_UPDATE"]
+    assert [d.agent for d in decisions_a] == ["cand-a", "cand-a"]
+    assert [d.agent for d in decisions_b] == ["cand-b", "cand-b"]
+
+
+def test_shadow_runner_isolates_candidate_failures(tmp_path: Path):
+    """A failing candidate doesn't break delivery to its peers."""
+    bus = EventBus()
+    log_ok = DecisionLog(tmp_path / "ok.jsonl")
+    log_ok.open()
+
+    class BoomCandidate(NoOpCandidate):
+        def on_event(self, event):
+            raise RuntimeError("intentional")
+
+    runner = ShadowRunner(bus)
+    runner.add(BoomCandidate("boom", DecisionLog(tmp_path / "boom.jsonl")))
+    runner.add(NoOpCandidate("ok", log_ok))
+    runner.start()
+
+    bus.publish(EventType.STAGE_MOVED, {}, source="t")
+    runner.stop()
+    log_ok.close()
+
+    # Production candidate still received the event.
+    assert len(log_ok.read()) == 1
+
+
+def test_shadow_runner_watch_filter(tmp_path: Path):
+    """NoOpCandidate(watch=[...]) only fires for matching event types."""
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    runner = ShadowRunner(bus)
+    runner.add(NoOpCandidate("only-errors", dlog, watch=["ERROR_OCCURRED"]))
+    runner.start()
+
+    bus.publish(EventType.STAGE_MOVED, {}, source="t")
+    bus.publish(EventType.EMBRYOS_UPDATE, {}, source="t")
+    bus.publish(EventType.ERROR_OCCURRED, {"msg": "x"}, source="t")
+    runner.stop()
+    dlog.close()
+
+    decs = dlog.read()
+    assert len(decs) == 1
+    assert decs[0].trigger_detail == "ERROR_OCCURRED"

From 2f4e1a255d88ff397512b6179ccf84797f1ed4d9 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 17:46:29 -0400
Subject: [PATCH 009/314] eval: capture production decisions per user turn
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Completes the second half of the shadow-mode substrate. The agent now
writes a Decision row to a per-session decisions.jsonl every time
ConversationManager.call_claude returns — success or error. Pairs with
the events.jsonl from Phase 6a so a candidate replay can be diffed
against production turn-by-turn.

What a production Decision captures
-----------------------------------
- trigger        always USER_MESSAGE for now (event/tick triggers land
                 with the wake-router phase)
- trigger_detail user message excerpt (200 chars)
- tool_calls     aggregated across the multi-step tool loop — every
                 tool_use block Claude emitted during this turn
- response_text  final assistant text
- prompt_hash    short SHA-256 of (system_prompt, conversation_history)
                 snapshotted BEFORE the tool loop appends to history.
                 Same hash = same input; safe to compare candidate
                 decisions against this one.
- duration_ms    wall time of the whole turn
- error          set on the failure path; the exception still re-raises
                 to the caller so the existing error UX is unchanged

Wiring
------
- gently/eval/decision_log.py
    new prompt_hash() helper (shared by production + candidates so the
    fingerprint format stays consistent)
- gently/harness/conversation.py
    ConversationManager gains decision_log field; call_claude collects
    tool_use blocks across every Claude round, then writes one Decision
    in both success and except branches. Best-effort: a DecisionLog
    write failure never breaks the live agent.
- gently/app/agent.py
    _init_decision_log opens session_dir/decisions.jsonl and assigns
    to self.conversation.decision_log; stop_decision_log mirrors
    stop_event_capture for shutdown cleanliness.
- tests/test_eval.py
    +5 tests: prompt_hash stability and shape-tolerance; success path
    captures tool_calls + response + prompt_hash + duration; error path
    captures error + re-raises; no-log path is a clean no-op.

Phase 6f. 20/20 tests green.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 75d7c9db7459fd3aebe8a73ca204c267816969de)
---
 gently/app/agent.py            |  46 ++++++++
 gently/eval/__init__.py        |   3 +-
 gently/eval/decision_log.py    |  23 ++++
 gently/harness/conversation.py |  96 ++++++++++++++++
 tests/test_eval.py             | 198 +++++++++++++++++++++++++++++++++
 5 files changed, 365 insertions(+), 1 deletion(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index b549e0f2..01c7371d 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -151,6 +151,11 @@ def __init__(
         # candidate orchestrator architectures.
         self.event_capture = None
 
+        # Decision log — what production decided at each turn (tool calls,
+        # response text, prompt hash). Pairs with event capture so a
+        # candidate replay can be diffed against production turn-by-turn.
+        self.decision_log = None
+
         # Timelapse orchestrator (initialized when microscope connected)
         self.timelapse_orchestrator: Optional[TimelapseOrchestrator] = None
 
@@ -219,6 +224,10 @@ def __init__(
         # by default so a long timelapse doesn't bury the meaningful events.
         self._init_event_capture()
 
+        # Open the per-session production decision log and hand it to the
+        # conversation manager so each Claude round-trip is captured.
+        self._init_decision_log()
+
         # Wire interaction logger and choice handler to conversation manager
         self.conversation.interaction_logger = self.interaction_logger
         self.conversation.choice_handler = self.choice_handler
@@ -502,6 +511,43 @@ def stop_event_capture(self):
                 logging.getLogger(__name__).exception("EventCapture stop failed")
             self.event_capture = None
 
+    def _init_decision_log(self):
+        """Open the per-session decisions.jsonl and wire it into conversation.
+
+        Each call to ConversationManager.call_claude writes one Decision
+        row (success or error) describing what production decided for the
+        user turn. Shadow candidates write their own rows into separate
+        logs and the two are diffed offline.
+        """
+        from gently.eval import DecisionLog
+        try:
+            session_dir = None
+            sid = self.session_id
+            if self.store is not None and sid:
+                session_dir = self.store._session_dir(sid)
+            if session_dir is None:
+                logging.getLogger(__name__).debug(
+                    "DecisionLog: no session dir for %s — skipping", sid)
+                return
+            path = session_dir / "decisions.jsonl"
+            self.decision_log = DecisionLog(path)
+            self.decision_log.open()
+            self.conversation.decision_log = self.decision_log
+        except Exception:
+            logging.getLogger(__name__).exception("Failed to init decision log")
+            self.decision_log = None
+
+    def stop_decision_log(self):
+        """Flush + close the decisions.jsonl. Idempotent; safe at shutdown."""
+        if self.decision_log is not None:
+            try:
+                self.decision_log.close()
+            except Exception:
+                logging.getLogger(__name__).exception("DecisionLog close failed")
+            self.decision_log = None
+            if hasattr(self, "conversation") and self.conversation is not None:
+                self.conversation.decision_log = None
+
     def _init_timelapse_orchestrator(self):
         """Initialize the timelapse orchestrator if microscope is connected."""
         if not self._has_microscope():
diff --git a/gently/eval/__init__.py b/gently/eval/__init__.py
index 3c4ed22b..49cd873e 100644
--- a/gently/eval/__init__.py
+++ b/gently/eval/__init__.py
@@ -17,7 +17,7 @@
 
 from .event_capture import EventCapture
 from .event_replay import EventReplay
-from .decision_log import Decision, DecisionLog, DecisionTrigger
+from .decision_log import Decision, DecisionLog, DecisionTrigger, prompt_hash
 from .shadow import OrchestratorCandidate, ShadowRunner, NoOpCandidate
 
 __all__ = [
@@ -26,6 +26,7 @@
     "Decision",
     "DecisionLog",
     "DecisionTrigger",
+    "prompt_hash",
     "OrchestratorCandidate",
     "ShadowRunner",
     "NoOpCandidate",
diff --git a/gently/eval/decision_log.py b/gently/eval/decision_log.py
index e6d713e9..0a014b61 100644
--- a/gently/eval/decision_log.py
+++ b/gently/eval/decision_log.py
@@ -15,6 +15,7 @@
 
 from __future__ import annotations
 
+import hashlib
 import json
 import logging
 import threading
@@ -29,6 +30,28 @@
 logger = logging.getLogger(__name__)
 
 
+def prompt_hash(system_prompt: Any, messages: Any) -> str:
+    """Stable short fingerprint of the input the orchestrator saw.
+
+    Two candidates seeing byte-identical (system_prompt, messages) get
+    the same hash; a difference here means they're working from different
+    context, so any decision divergence is expected. Used in shadow A/B
+    to filter out apples-to-oranges comparisons.
+
+    SHA-256 truncated to 16 hex chars — enough to make accidental
+    collisions vanishingly unlikely at the scale of one session's
+    decisions, short enough to skim by eye in a log.
+    """
+    h = hashlib.sha256()
+    if isinstance(system_prompt, str):
+        h.update(system_prompt.encode("utf-8"))
+    else:
+        h.update(json.dumps(system_prompt, sort_keys=True, default=_json_default).encode("utf-8"))
+    h.update(b"\x1f")  # separator so prompt boundary can't be ambiguous
+    h.update(json.dumps(messages, sort_keys=True, default=_json_default).encode("utf-8"))
+    return h.hexdigest()[:16]
+
+
 class DecisionTrigger(str, Enum):
     """What woke the agent up for this decision moment."""
     USER_MESSAGE = "user_message"
diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 8384ba9c..765d16b2 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -17,6 +17,27 @@
 logger = logging.getLogger(__name__)
 
 
+def _extend_tool_calls(out: List[Dict[str, Any]], content_blocks) -> None:
+    """Append every tool_use block in content_blocks to out.
+
+    Tolerates absent attributes (some SDK versions / mock objects) so it
+    never crashes the live agent on a content-shape surprise.
+    """
+    if not content_blocks:
+        return
+    for block in content_blocks:
+        try:
+            if getattr(block, "type", None) != "tool_use":
+                continue
+            out.append({
+                "name": getattr(block, "name", None),
+                "input": getattr(block, "input", None),
+                "id": getattr(block, "id", None),
+            })
+        except Exception:
+            continue
+
+
 class ConversationManager:
     """
     Manages Claude API conversations, tool execution, and token tracking.
@@ -48,6 +69,11 @@ def __init__(self, client, model, tool_registry):
         self.choice_handler = None
         self.context_store = None  # for tool_label
 
+        # Decision capture for orchestrator A/B testing. Set by the agent
+        # alongside the EventCapture once the session folder is known. None
+        # = no capture, so tests / harnesses without a session still work.
+        self.decision_log = None
+
     # ===== Quick Response =====
 
     def try_quick_response(self, message: str, experiment, mode: str,
@@ -175,6 +201,22 @@ async def call_claude(self, user_message: str, system_prompt, tools,
                 }
             )
 
+        # Snapshot inputs for decision capture BEFORE the tool loop starts
+        # appending to conversation_history. This is the state shadow
+        # candidates would need to reproduce production's input — same
+        # system_prompt and same starting messages.
+        decision_prompt_hash = None
+        if self.decision_log is not None:
+            try:
+                from gently.eval import prompt_hash as _prompt_hash
+                decision_prompt_hash = _prompt_hash(
+                    system_prompt, list(self.conversation_history),
+                )
+            except Exception:
+                logger.exception("Failed to compute decision prompt_hash")
+
+        tool_calls_collected: List[Dict[str, Any]] = []
+        assistant_message = ""
         error_occurred = None
 
         try:
@@ -194,6 +236,7 @@ async def call_claude(self, user_message: str, system_prompt, tools,
                 **api_kwargs
             )
             self._track_token_usage(response)
+            _extend_tool_calls(tool_calls_collected, response.content)
 
             # Process tool calls
             while response.stop_reason == "tool_use":
@@ -216,6 +259,7 @@ async def call_claude(self, user_message: str, system_prompt, tools,
                     **api_kwargs
                 )
                 self._track_token_usage(response)
+                _extend_tool_calls(tool_calls_collected, response.content)
 
             # Extract text response
             assistant_message = ""
@@ -242,6 +286,14 @@ async def call_claude(self, user_message: str, system_prompt, tools,
                     error=error_occurred,
                     error_traceback=error_tb,
                 )
+            self._write_production_decision(
+                user_message=user_message,
+                tool_calls=tool_calls_collected,
+                response_text=assistant_message,
+                duration_ms=(time.time() - start_time) * 1000.0,
+                prompt_hash_value=decision_prompt_hash,
+                error=error_occurred,
+            )
             raise
 
         if interaction and self.interaction_logger:
@@ -251,10 +303,54 @@ async def call_claude(self, user_message: str, system_prompt, tools,
                 total_duration_seconds=time.time() - start_time,
             )
 
+        self._write_production_decision(
+            user_message=user_message,
+            tool_calls=tool_calls_collected,
+            response_text=assistant_message,
+            duration_ms=(time.time() - start_time) * 1000.0,
+            prompt_hash_value=decision_prompt_hash,
+            error=None,
+        )
+
         auto_save_fn()
 
         return assistant_message
 
+    def _write_production_decision(
+        self,
+        *,
+        user_message: str,
+        tool_calls: List[Dict[str, Any]],
+        response_text: str,
+        duration_ms: float,
+        prompt_hash_value: Optional[str],
+        error: Optional[str],
+    ) -> None:
+        """Persist one production Decision row (best-effort).
+
+        Failures here are swallowed — decision capture must never break
+        the live agent. The DecisionLog itself is also tolerant of
+        serialisation errors.
+        """
+        if self.decision_log is None:
+            return
+        try:
+            from datetime import datetime
+            from gently.eval import Decision, DecisionTrigger
+            self.decision_log.append(Decision(
+                timestamp=datetime.now(),
+                agent="production",
+                trigger=DecisionTrigger.USER_MESSAGE,
+                trigger_detail=(user_message or "")[:200],
+                tool_calls=tool_calls,
+                response_text=response_text,
+                prompt_hash=prompt_hash_value,
+                duration_ms=duration_ms,
+                error=error,
+            ))
+        except Exception:
+            logger.exception("Failed to write production Decision")
+
     # ===== Dry-Run Tool Call (Benchmarking) =====
 
     async def get_tool_call(self, user_message: str, system_prompt, tools) -> Optional[Dict]:
diff --git a/tests/test_eval.py b/tests/test_eval.py
index 8bc97064..28fe46ea 100644
--- a/tests/test_eval.py
+++ b/tests/test_eval.py
@@ -361,3 +361,201 @@ def test_shadow_runner_watch_filter(tmp_path: Path):
     decs = dlog.read()
     assert len(decs) == 1
     assert decs[0].trigger_detail == "ERROR_OCCURRED"
+
+
+# =============================================================================
+# prompt_hash
+# =============================================================================
+
+def test_prompt_hash_stable_and_distinguishing():
+    """Identical inputs → identical hash; any change → different hash."""
+    from gently.eval import prompt_hash
+    h1 = prompt_hash("sys-A", [{"role": "user", "content": "hi"}])
+    h2 = prompt_hash("sys-A", [{"role": "user", "content": "hi"}])
+    h3 = prompt_hash("sys-A", [{"role": "user", "content": "hello"}])
+    h4 = prompt_hash("sys-B", [{"role": "user", "content": "hi"}])
+    assert h1 == h2
+    assert h1 != h3
+    assert h1 != h4
+    assert len(h1) == 16  # documented short fingerprint length
+
+
+def test_prompt_hash_accepts_list_system_prompt():
+    """Cached system prompts use the list-of-blocks shape; hashing must work."""
+    from gently.eval import prompt_hash
+    list_prompt = [{"type": "text", "text": "sys", "cache_control": {"type": "ephemeral"}}]
+    str_prompt = "sys"
+    # Different shapes, different hashes — that's fine, the point is just
+    # that the list case doesn't raise.
+    h_list = prompt_hash(list_prompt, [])
+    h_str  = prompt_hash(str_prompt,  [])
+    assert isinstance(h_list, str) and isinstance(h_str, str)
+    assert len(h_list) == 16 and len(h_str) == 16
+
+
+# =============================================================================
+# ConversationManager production-decision capture (success + error paths)
+# =============================================================================
+
+def _make_fake_conversation_manager(claude_client):
+    """Build a ConversationManager with a fake Claude client and a no-op
+    tool registry — enough to exercise call_claude's decision-write path."""
+    import asyncio  # noqa: F401  (used by callers)
+    from gently.harness.conversation import ConversationManager
+
+    class _NoopReg:
+        # call_claude doesn't use this directly; tools list is passed in
+        pass
+
+    return ConversationManager(claude_client, "claude-haiku-4-5-20251001", _NoopReg())
+
+
+class _Usage:
+    input_tokens = 10
+    output_tokens = 20
+    cache_creation_input_tokens = 0
+    cache_read_input_tokens = 0
+
+
+class _ToolBlock:
+    type = "tool_use"
+    name = "detect_embryos"
+    input = {"min_confidence": 0.7}
+    id = "t1"
+
+
+class _TextBlock:
+    type = "text"
+    text = "Done."
+
+
+class _R1:
+    stop_reason = "tool_use"
+    content = [_ToolBlock()]
+    usage = _Usage()
+
+
+class _R2:
+    stop_reason = "end_turn"
+    content = [_TextBlock()]
+    usage = _Usage()
+
+
+def test_production_decision_capture_success(tmp_path: Path):
+    """One success turn through call_claude writes one Decision row."""
+    import asyncio
+
+    calls = {"n": 0}
+
+    class _FakeMessages:
+        def create(self, **kw):
+            calls["n"] += 1
+            return _R1() if calls["n"] == 1 else _R2()
+
+    class _FakeClient:
+        messages = _FakeMessages()
+
+    cm = _make_fake_conversation_manager(_FakeClient())
+
+    # Bypass actual tool execution
+    async def fake_exec(content_blocks, interaction):
+        return [{"type": "tool_result", "tool_use_id": "t1", "content": "ok"}]
+    cm._execute_tools_with_logging = fake_exec
+
+    dlog = DecisionLog(tmp_path / "decisions.jsonl")
+    dlog.open()
+    cm.decision_log = dlog
+
+    async def run():
+        return await cm.call_claude(
+            user_message="find embryos please",
+            system_prompt="system",
+            tools=[],
+            mode="run",
+            auto_save_fn=lambda: None,
+        )
+
+    out = asyncio.run(run())
+    dlog.close()
+
+    assert out == "Done."
+    decs = dlog.read()
+    assert len(decs) == 1
+    d = decs[0]
+    assert d.agent == "production"
+    assert d.trigger is DecisionTrigger.USER_MESSAGE
+    assert d.trigger_detail == "find embryos please"
+    assert d.tool_calls == [{
+        "name": "detect_embryos",
+        "input": {"min_confidence": 0.7},
+        "id": "t1",
+    }]
+    assert d.response_text == "Done."
+    assert d.error is None
+    assert d.prompt_hash is not None and len(d.prompt_hash) == 16
+    assert d.duration_ms is not None and d.duration_ms >= 0
+
+
+def test_production_decision_capture_error(tmp_path: Path):
+    """A failing Claude call writes a Decision with error before re-raising."""
+    import asyncio
+
+    class _BoomMessages:
+        def create(self, **kw):
+            raise RuntimeError("simulated outage")
+
+    class _BoomClient:
+        messages = _BoomMessages()
+
+    cm = _make_fake_conversation_manager(_BoomClient())
+    dlog = DecisionLog(tmp_path / "decisions.jsonl")
+    dlog.open()
+    cm.decision_log = dlog
+
+    async def run():
+        with pytest.raises(RuntimeError, match="simulated outage"):
+            await cm.call_claude(
+                user_message="do something",
+                system_prompt="system",
+                tools=[],
+                mode="run",
+                auto_save_fn=lambda: None,
+            )
+
+    asyncio.run(run())
+    dlog.close()
+    decs = dlog.read()
+    assert len(decs) == 1
+    assert decs[0].error == "simulated outage"
+    assert decs[0].trigger is DecisionTrigger.USER_MESSAGE
+    assert decs[0].response_text and "simulated outage" in decs[0].response_text
+
+
+def test_production_decision_capture_no_log_is_no_op(tmp_path: Path):
+    """No DecisionLog attached → call_claude proceeds normally, no errors."""
+    import asyncio
+
+    calls = {"n": 0}
+
+    class _M:
+        def create(self, **kw):
+            calls["n"] += 1
+            return _R2()  # immediate end_turn, no tool loop
+
+    class _C:
+        messages = _M()
+
+    cm = _make_fake_conversation_manager(_C())
+    assert cm.decision_log is None  # default
+
+    async def run():
+        return await cm.call_claude(
+            user_message="hi",
+            system_prompt="sys",
+            tools=[],
+            mode="run",
+            auto_save_fn=lambda: None,
+        )
+
+    out = asyncio.run(run())
+    assert out == "Done."  # no log to read; we just want no error

From 1194a1f584a8222ef177f2b05e531db984bf92b4 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 18:13:05 -0400
Subject: [PATCH 010/314] eval: operator-action events + ReactiveCandidate
 (first real shadow)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two pieces of the closed-loop paradigm, tightly coupled.

Operator-action events (vocabulary)
-----------------------------------
Three new EventType values for human-driven mutations. They're distinct
from EMBRYOS_UPDATE because they carry INTENT, not just state delta —
candidates can reason about "the operator just did X" without typing
that fact into chat.

  OPERATOR_EDITED_EMBRYO  PUT /api/embryos/{id}/position
                          payload: embryo_id + old/new coarse +
                          fine_position_invalidated
  OPERATOR_REMOVED_EMBRYO DELETE /api/embryos/{id}
                          payload: embryo_id + last_position
  OPERATOR_MARKED_EMBRYOS detect_embryos web-editor finish
                          payload: embryo_ids + count + stage_origin +
                          pre_edit_count

Map-edit routes publish via server.agent_bridge.agent._event_bus.
detect_embryos publishes only when the operator actually confirmed via
the web canvas (operator_marked flag) — if the editor was skipped, the
SAM list still landed in experiment.embryos but it wasn't operator-
confirmed, so no operator event.

ReactiveCandidate (first real candidate)
----------------------------------------
gently/eval/candidates.py — pure-rule shadow orchestrator with a tiny
world model (embryos + last stage + last error). Reacts to:

  EMBRYOS_UPDATE        ingest, silent
  STAGE_MOVED           ingest, silent
  OPERATOR_EDITED_EMBRYO  propose recalibrate_embryo if fine was invalidated
  OPERATOR_MARKED_EMBRYOS propose calibrate_all_embryos for the new set
  OPERATOR_REMOVED_EMBRYO propose forget_embryo for cache tidy-up
  ERROR_OCCURRED        escalate first occurrence, suppress same msg
                        within 30s

The thesis being tested: a rule-based responder can do the routine
bookkeeping that today only happens when the operator chats with Claude.
Shadow mode will tell us how often that thesis holds in practice.

Tests
-----
+7 ReactiveCandidate tests covering silent ingest, conditional
recalibrate, marked-set proposal, removal tidy-up, error
escalate/suppress, and a full event-stream-through-replay smoke that
proves the captured jsonl alone is sufficient input to drive a candidate
to a decision log. 27/27 green.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 0a97563e94bbe53a41704602744190ad92a81034)
---
 gently/app/tools/detection_tools.py |  20 +++
 gently/core/event_bus.py            |   8 +
 gently/eval/__init__.py             |   2 +
 gently/eval/candidates.py           | 257 ++++++++++++++++++++++++++++
 gently/ui/web/routes/data.py        |  50 +++++-
 tests/test_eval.py                  | 208 ++++++++++++++++++++++
 6 files changed, 544 insertions(+), 1 deletion(-)
 create mode 100644 gently/eval/candidates.py

diff --git a/gently/app/tools/detection_tools.py b/gently/app/tools/detection_tools.py
index 08cf58fd..e30f5f33 100644
--- a/gently/app/tools/detection_tools.py
+++ b/gently/app/tools/detection_tools.py
@@ -204,6 +204,26 @@ async def detect_embryos(
                 )
             added.append((emb_id, m.get("role", default_role)))
 
+        # OPERATOR_MARKED_EMBRYOS — operator confirmed via the web canvas.
+        # This is the intent signal eval/shadow listeners hook for ReactiveCandidate.
+        if added:
+            bus = getattr(agent, '_event_bus', None)
+            if bus is not None:
+                from gently.core.event_bus import EventType
+                try:
+                    bus.publish(
+                        event_type=EventType.OPERATOR_MARKED_EMBRYOS,
+                        data={
+                            'embryo_ids': [eid for eid, _ in added],
+                            'count': len(added),
+                            'stage_origin': list(stage_pos),
+                            'pre_edit_count': len(sam_embryos),
+                        },
+                        source='detect_embryos:web-editor',
+                    )
+                except Exception:
+                    pass
+
         role_counts = {}
         for _, r in added:
             role_counts[r] = role_counts.get(r, 0) + 1
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 0b7d57b2..3d59d9c6 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -84,6 +84,14 @@ class EventType(Enum):
     BOTTOM_CAMERA_FRAME = auto()   # Live JPEG frame from the bottom camera stream
     EMBRYOS_UPDATE = auto()        # Full embryo list snapshot from agent.experiment
 
+    # Operator-action events. Distinct from EMBRYOS_UPDATE because they
+    # carry intent ("a human did this") rather than just state delta.
+    # Candidate orchestrators can subscribe and reason about what the
+    # operator just did without having to type it in chat.
+    OPERATOR_EDITED_EMBRYO    = auto()   # Map drag/drop -> PUT /api/embryos/{id}/position
+    OPERATOR_REMOVED_EMBRYO   = auto()   # Map delete  -> DELETE /api/embryos/{id}
+    OPERATOR_MARKED_EMBRYOS   = auto()   # Marking canvas "Done" — operator confirmed N positions
+
     # System events
     ERROR_OCCURRED = auto()
     WARNING_ISSUED = auto()
diff --git a/gently/eval/__init__.py b/gently/eval/__init__.py
index 49cd873e..e93f5d5c 100644
--- a/gently/eval/__init__.py
+++ b/gently/eval/__init__.py
@@ -19,6 +19,7 @@
 from .event_replay import EventReplay
 from .decision_log import Decision, DecisionLog, DecisionTrigger, prompt_hash
 from .shadow import OrchestratorCandidate, ShadowRunner, NoOpCandidate
+from .candidates import ReactiveCandidate
 
 __all__ = [
     "EventCapture",
@@ -30,4 +31,5 @@
     "OrchestratorCandidate",
     "ShadowRunner",
     "NoOpCandidate",
+    "ReactiveCandidate",
 ]
diff --git a/gently/eval/candidates.py b/gently/eval/candidates.py
new file mode 100644
index 00000000..111cc935
--- /dev/null
+++ b/gently/eval/candidates.py
@@ -0,0 +1,257 @@
+"""Canned shadow orchestrator candidates.
+
+NoOpCandidate lives in shadow.py as the trivial baseline. Anything more
+interesting — even pure-rule architectures with state — lives here. As
+LLM-driven candidates land they should slot into this module too.
+
+Conventions every candidate should keep:
+  - It maintains its own tiny world model. The production agent's
+    `experiment` is intentionally not shared (a candidate that mutates
+    production state would defeat the point of shadow mode).
+  - Decisions go through `log_decision`. Never call hardware tools.
+  - State updates from events are cheap (no LLM, no I/O).
+"""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+
+from gently.core.event_bus import Event
+
+from .decision_log import DecisionLog, DecisionTrigger
+from .shadow import OrchestratorCandidate
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class _ReactiveWorldModel:
+    """The tiniest possible world model — everything ReactiveCandidate
+    needs to make rule-based decisions without re-reading the agent."""
+
+    # {embryo_id: {"coarse": {x, y} | None, "fine": {x, y} | None,
+    #              "has_fine": bool, "confidence": float}}
+    embryos: Dict[str, Dict[str, Any]] = field(default_factory=dict)
+
+    # Last live stage XY (µm) from a STAGE_MOVED event.
+    last_stage_um: Optional[Dict[str, float]] = None
+
+    # Last error message + timestamp, so the candidate can avoid
+    # spam-proposing escalations for the same recurring failure.
+    last_error: Optional[Dict[str, Any]] = None
+
+    # Count of events seen, by type name — useful debug field that also
+    # ends up in the decision context_summary.
+    seen: Dict[str, int] = field(default_factory=dict)
+
+
+class ReactiveCandidate(OrchestratorCandidate):
+    """Pure-rule reactive shadow orchestrator.
+
+    The thesis being tested: *can a rule-based responder do the
+    routine bookkeeping that today only happens when the operator
+    chats with Claude?*
+
+    Reactions
+    ---------
+    OPERATOR_EDITED_EMBRYO
+        Operator moved an embryo on the Map. The PUT also clears fine
+        position. Propose `recalibrate_embryo(embryo_id)` so the new
+        coarse position gets a SPIM-fine alignment before the next
+        acquisition. If `fine_position_invalidated` was False (no fine
+        existed yet) skip the proposal — there's nothing to refresh.
+
+    OPERATOR_MARKED_EMBRYOS
+        Operator just confirmed a fresh set of embryos via the marking
+        canvas. Propose `calibrate_all_embryos` to bring them all into
+        focus. Cheap pattern: kick off calibration the moment sightings
+        land, instead of waiting for the operator to type it.
+
+    OPERATOR_REMOVED_EMBRYO
+        Operator deleted an embryo. Propose a tidy-up step
+        `forget_embryo(embryo_id)` for any candidate that wants to
+        clean caches / learnings keyed on the gone embryo. No-op for
+        production today (state mutation already happened); the
+        proposal is reserved for downstream cleanup tools.
+
+    ERROR_OCCURRED
+        Propose `escalate_to_operator(error_message)` once per distinct
+        error. Suppresses if the same error fires twice within 30s —
+        avoids drowning the operator in repeat alarms.
+
+    EMBRYOS_UPDATE / STAGE_MOVED
+        Update the world model. No decision logged (silent ingest).
+
+    """
+
+    # If two ERROR_OCCURRED events with the same message arrive within
+    # this window, only the first proposes an escalation.
+    ERROR_SUPPRESS_WINDOW_SEC = 30.0
+
+    def __init__(self, name: str, decisions: DecisionLog):
+        super().__init__(name, decisions)
+        self.world = _ReactiveWorldModel()
+
+    # ---- event handlers ----------------------------------------------------
+
+    def on_event(self, event: Event) -> None:
+        name = event.event_type.name
+        self.world.seen[name] = self.world.seen.get(name, 0) + 1
+
+        # Always ingest state-shaped events first.
+        if name == "EMBRYOS_UPDATE":
+            self._ingest_embryos_update(event)
+            return
+        if name == "STAGE_MOVED":
+            self._ingest_stage_moved(event)
+            return
+
+        # Operator + error events produce decisions.
+        if name == "OPERATOR_EDITED_EMBRYO":
+            self._react_operator_edited(event)
+            return
+        if name == "OPERATOR_MARKED_EMBRYOS":
+            self._react_operator_marked(event)
+            return
+        if name == "OPERATOR_REMOVED_EMBRYO":
+            self._react_operator_removed(event)
+            return
+        if name == "ERROR_OCCURRED":
+            self._react_error(event)
+            return
+
+    # ---- ingests -----------------------------------------------------------
+
+    def _ingest_embryos_update(self, event: Event) -> None:
+        embryos = (event.data or {}).get("embryos") or []
+        new_world: Dict[str, Dict[str, Any]] = {}
+        for emb in embryos:
+            new_world[emb.get("id", "")] = {
+                "coarse": emb.get("position_coarse"),
+                "fine": emb.get("position_fine"),
+                "has_fine": bool(emb.get("has_fine_position")),
+                "confidence": emb.get("detection_confidence", 0.0),
+            }
+        self.world.embryos = new_world
+
+    def _ingest_stage_moved(self, event: Event) -> None:
+        d = event.data or {}
+        if "x" in d and "y" in d:
+            self.world.last_stage_um = {"x": float(d["x"]), "y": float(d["y"])}
+
+    # ---- reactions ---------------------------------------------------------
+
+    def _react_operator_edited(self, event: Event) -> None:
+        data = event.data or {}
+        eid = data.get("embryo_id") or ""
+        invalidated = bool(data.get("fine_position_invalidated"))
+        tool_calls: List[Dict[str, Any]] = []
+        # Only propose a recalibration when there was a fine position
+        # that the edit just invalidated. New coarse without any prior
+        # fine has nothing to refresh yet.
+        if invalidated:
+            tool_calls.append({
+                "name": "recalibrate_embryo",
+                "input": {"embryo_id": eid},
+                "id": None,
+            })
+        self.log_decision(
+            trigger=DecisionTrigger.EVENT,
+            trigger_detail="OPERATOR_EDITED_EMBRYO",
+            tool_calls=tool_calls,
+            response_text=(
+                f"Operator moved {eid}; proposing recalibration."
+                if invalidated else
+                f"Operator moved {eid}; no prior fine -- no action."
+            ),
+            recent_event_ids=[event.event_id],
+            context_summary=self._summary(),
+        )
+
+    def _react_operator_marked(self, event: Event) -> None:
+        data = event.data or {}
+        ids = data.get("embryo_ids") or []
+        count = data.get("count", len(ids))
+        tool_calls: List[Dict[str, Any]] = []
+        if count:
+            tool_calls.append({
+                "name": "calibrate_all_embryos",
+                "input": {"embryo_ids": list(ids)},
+                "id": None,
+            })
+        self.log_decision(
+            trigger=DecisionTrigger.EVENT,
+            trigger_detail="OPERATOR_MARKED_EMBRYOS",
+            tool_calls=tool_calls,
+            response_text=(
+                f"Operator marked {count} embryos; proposing calibration."
+                if count else
+                "Operator marked zero embryos; no action."
+            ),
+            recent_event_ids=[event.event_id],
+            context_summary=self._summary(),
+        )
+
+    def _react_operator_removed(self, event: Event) -> None:
+        data = event.data or {}
+        eid = data.get("embryo_id") or ""
+        self.log_decision(
+            trigger=DecisionTrigger.EVENT,
+            trigger_detail="OPERATOR_REMOVED_EMBRYO",
+            tool_calls=[{
+                "name": "forget_embryo",
+                "input": {"embryo_id": eid},
+                "id": None,
+            }],
+            response_text=f"Operator removed {eid}; proposing cache tidy-up.",
+            recent_event_ids=[event.event_id],
+            context_summary=self._summary(),
+        )
+
+    def _react_error(self, event: Event) -> None:
+        from datetime import datetime
+        data = event.data or {}
+        msg = str(data.get("msg") or data.get("error") or data.get("message") or "unknown")
+        now = datetime.now()
+        prior = self.world.last_error
+        suppress = (
+            prior is not None
+            and prior.get("msg") == msg
+            and (now - prior["ts"]).total_seconds() < self.ERROR_SUPPRESS_WINDOW_SEC
+        )
+        self.world.last_error = {"msg": msg, "ts": now}
+        if suppress:
+            self.log_decision(
+                trigger=DecisionTrigger.EVENT,
+                trigger_detail="ERROR_OCCURRED",
+                tool_calls=[],
+                response_text=f"Suppressed repeat error within {self.ERROR_SUPPRESS_WINDOW_SEC:.0f}s window: {msg[:120]}",
+                recent_event_ids=[event.event_id],
+                context_summary=self._summary(),
+            )
+            return
+        self.log_decision(
+            trigger=DecisionTrigger.EVENT,
+            trigger_detail="ERROR_OCCURRED",
+            tool_calls=[{
+                "name": "escalate_to_operator",
+                "input": {"error_message": msg, "source": event.source},
+                "id": None,
+            }],
+            response_text=f"New error -- proposing escalation: {msg[:120]}",
+            recent_event_ids=[event.event_id],
+            context_summary=self._summary(),
+        )
+
+    # ---- helpers -----------------------------------------------------------
+
+    def _summary(self) -> str:
+        n_emb = len(self.world.embryos)
+        n_fine = sum(1 for v in self.world.embryos.values() if v.get("has_fine"))
+        stage = self.world.last_stage_um
+        stage_str = f"({stage['x']:.1f}, {stage['y']:.1f})" if stage else "unknown"
+        seen = sum(self.world.seen.values())
+        return (f"{n_emb} embryos ({n_fine} fine-calibrated); "
+                f"stage {stage_str}; {seen} events ingested")
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 6a3e8ef5..7bb5ad3b 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -89,6 +89,10 @@ async def update_embryo_position(
         position — the operator is overriding the sighting, so any
         SPIM-objective fine alignment derived from the old coarse is no
         longer trustworthy and must be re-run.
+
+        Publishes OPERATOR_EDITED_EMBRYO with both the old and new
+        positions so candidates can reason about the magnitude of the
+        correction and trigger re-calibration suggestions.
         """
         agent = _require_agent_with_experiment()
         emb = agent.experiment.embryos.get(embryo_id)
@@ -99,9 +103,28 @@ async def update_embryo_position(
             y = float(body.get("y"))
         except (TypeError, ValueError):
             raise HTTPException(status_code=400, detail="Body needs numeric x and y")
+        old_coarse = dict(emb.position_coarse) if emb.position_coarse else None
+        had_fine   = bool(emb.position_fine)
         emb.position_coarse = {"x": x, "y": y}
         emb.position_fine = {}
         agent.experiment.notify_embryos_changed()
+
+        bus = getattr(agent, "_event_bus", None)
+        if bus is not None:
+            from gently.core.event_bus import EventType
+            try:
+                bus.publish(
+                    event_type=EventType.OPERATOR_EDITED_EMBRYO,
+                    data={
+                        "embryo_id": embryo_id,
+                        "old_position_coarse": old_coarse,
+                        "new_position_coarse": {"x": x, "y": y},
+                        "fine_position_invalidated": had_fine,
+                    },
+                    source="web:map-edit",
+                )
+            except Exception:
+                logger.exception("Failed to publish OPERATOR_EDITED_EMBRYO")
         return emb.to_dict()
 
     @router.delete("/api/embryos/{embryo_id}",
@@ -110,11 +133,36 @@ async def delete_embryo(embryo_id: str):
         """Remove an embryo from the experiment.
 
         Goes through ExperimentState.remove_embryo so the observer hook
-        fires EMBRYOS_UPDATE automatically.
+        fires EMBRYOS_UPDATE automatically. Also publishes
+        OPERATOR_REMOVED_EMBRYO carrying the embryo's last known position
+        — candidates can use that to e.g. clean up associated cache or
+        log the deletion in their own world model.
         """
         agent = _require_agent_with_experiment()
+        emb = agent.experiment.embryos.get(embryo_id)
+        last_position = None
+        if emb is not None:
+            last_position = {
+                "coarse": dict(emb.position_coarse) if emb.position_coarse else None,
+                "fine":   dict(emb.position_fine) if emb.position_fine else None,
+            }
         if not agent.experiment.remove_embryo(embryo_id):
             raise HTTPException(status_code=404, detail=f"Embryo {embryo_id} not found")
+
+        bus = getattr(agent, "_event_bus", None)
+        if bus is not None:
+            from gently.core.event_bus import EventType
+            try:
+                bus.publish(
+                    event_type=EventType.OPERATOR_REMOVED_EMBRYO,
+                    data={
+                        "embryo_id": embryo_id,
+                        "last_position": last_position,
+                    },
+                    source="web:map-delete",
+                )
+            except Exception:
+                logger.exception("Failed to publish OPERATOR_REMOVED_EMBRYO")
         return {"ok": True, "embryo_id": embryo_id}
 
     @router.get("/api/embryos/current")
diff --git a/tests/test_eval.py b/tests/test_eval.py
index 28fe46ea..879b7fc9 100644
--- a/tests/test_eval.py
+++ b/tests/test_eval.py
@@ -19,6 +19,7 @@
     EventCapture,
     EventReplay,
     NoOpCandidate,
+    ReactiveCandidate,
     ShadowRunner,
 )
 
@@ -559,3 +560,210 @@ async def run():
 
     out = asyncio.run(run())
     assert out == "Done."  # no log to read; we just want no error
+
+
+# =============================================================================
+# ReactiveCandidate
+# =============================================================================
+
+def _publish(bus, event_type_name: str, data: dict, source: str = "test"):
+    bus.publish(EventType[event_type_name], data, source=source)
+
+
+def _decisions_for(dlog: DecisionLog):
+    return dlog.read()
+
+
+def test_reactive_ingests_embryos_update_silently(tmp_path: Path):
+    """EMBRYOS_UPDATE updates the world model but emits no decision."""
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    cand = ReactiveCandidate("reactive-test", dlog)
+    runner = ShadowRunner(bus)
+    runner.add(cand)
+    runner.start()
+
+    _publish(bus, "EMBRYOS_UPDATE", {"embryos": [
+        {"id": "embryo_1", "position_coarse": {"x": 1.0, "y": 2.0},
+         "position_fine": {}, "has_fine_position": False},
+        {"id": "embryo_2", "position_coarse": {"x": 3.0, "y": 4.0},
+         "position_fine": {"x": 3.1, "y": 4.1}, "has_fine_position": True},
+    ]})
+
+    runner.stop()
+    dlog.close()
+
+    assert _decisions_for(dlog) == []  # silent
+    assert set(cand.world.embryos.keys()) == {"embryo_1", "embryo_2"}
+    assert cand.world.embryos["embryo_2"]["has_fine"]
+
+
+def test_reactive_proposes_recalibrate_when_fine_invalidated(tmp_path: Path):
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    runner = ShadowRunner(bus)
+    runner.add(ReactiveCandidate("reactive", dlog))
+    runner.start()
+
+    _publish(bus, "OPERATOR_EDITED_EMBRYO", {
+        "embryo_id": "embryo_2",
+        "old_position_coarse": {"x": 3, "y": 4},
+        "new_position_coarse": {"x": 30, "y": 40},
+        "fine_position_invalidated": True,
+    })
+    runner.stop()
+    dlog.close()
+    decs = _decisions_for(dlog)
+    assert len(decs) == 1
+    assert decs[0].tool_calls == [{
+        "name": "recalibrate_embryo",
+        "input": {"embryo_id": "embryo_2"},
+        "id": None,
+    }]
+
+
+def test_reactive_skips_recalibrate_when_no_fine_existed(tmp_path: Path):
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    runner = ShadowRunner(bus)
+    runner.add(ReactiveCandidate("reactive", dlog))
+    runner.start()
+
+    _publish(bus, "OPERATOR_EDITED_EMBRYO", {
+        "embryo_id": "embryo_1",
+        "old_position_coarse": {"x": 1, "y": 2},
+        "new_position_coarse": {"x": 10, "y": 20},
+        "fine_position_invalidated": False,
+    })
+    runner.stop()
+    dlog.close()
+    decs = _decisions_for(dlog)
+    assert len(decs) == 1
+    assert decs[0].tool_calls == []  # nothing to refresh
+    assert "no action" in decs[0].response_text.lower()
+
+
+def test_reactive_proposes_calibrate_all_on_marked(tmp_path: Path):
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    runner = ShadowRunner(bus)
+    runner.add(ReactiveCandidate("reactive", dlog))
+    runner.start()
+
+    _publish(bus, "OPERATOR_MARKED_EMBRYOS", {
+        "embryo_ids": ["embryo_001", "embryo_002", "embryo_003"],
+        "count": 3,
+    })
+    runner.stop()
+    dlog.close()
+    decs = _decisions_for(dlog)
+    assert len(decs) == 1
+    assert decs[0].tool_calls == [{
+        "name": "calibrate_all_embryos",
+        "input": {"embryo_ids": ["embryo_001", "embryo_002", "embryo_003"]},
+        "id": None,
+    }]
+
+
+def test_reactive_proposes_forget_on_removal(tmp_path: Path):
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    runner = ShadowRunner(bus)
+    runner.add(ReactiveCandidate("reactive", dlog))
+    runner.start()
+
+    _publish(bus, "OPERATOR_REMOVED_EMBRYO", {
+        "embryo_id": "embryo_5",
+        "last_position": {"coarse": {"x": 1, "y": 2}, "fine": None},
+    })
+    runner.stop()
+    dlog.close()
+    decs = _decisions_for(dlog)
+    assert len(decs) == 1
+    assert decs[0].tool_calls == [{
+        "name": "forget_embryo",
+        "input": {"embryo_id": "embryo_5"},
+        "id": None,
+    }]
+
+
+def test_reactive_escalates_first_error_then_suppresses_repeat(tmp_path: Path):
+    bus = EventBus()
+    dlog = DecisionLog(tmp_path / "d.jsonl")
+    dlog.open()
+    runner = ShadowRunner(bus)
+    runner.add(ReactiveCandidate("reactive", dlog))
+    runner.start()
+
+    _publish(bus, "ERROR_OCCURRED", {"msg": "camera lost lock"})
+    _publish(bus, "ERROR_OCCURRED", {"msg": "camera lost lock"})  # within 30s
+    _publish(bus, "ERROR_OCCURRED", {"msg": "different error"})
+    runner.stop()
+    dlog.close()
+    decs = _decisions_for(dlog)
+    assert len(decs) == 3
+    # 1st: escalate
+    assert decs[0].tool_calls[0]["name"] == "escalate_to_operator"
+    # 2nd: suppressed
+    assert decs[1].tool_calls == []
+    assert "suppressed" in decs[1].response_text.lower()
+    # 3rd: different message -> escalate
+    assert decs[2].tool_calls[0]["name"] == "escalate_to_operator"
+
+
+def test_reactive_full_event_stream_through_replay(tmp_path: Path):
+    """Capture a realistic operator-driven session and replay through the
+    candidate. End-to-end smoke that the recorded jsonl is enough to
+    drive a candidate's decision log without any other inputs."""
+    src = EventBus()
+    cap = EventCapture(tmp_path / "events.jsonl")
+    cap.start(src)
+
+    src.publish(EventType.EMBRYOS_UPDATE, {"embryos": [
+        {"id": "embryo_1", "position_coarse": {"x": 1.0, "y": 2.0},
+         "position_fine": {"x": 1.05, "y": 2.05}, "has_fine_position": True},
+    ]}, source="agent")
+    src.publish(EventType.OPERATOR_EDITED_EMBRYO, {
+        "embryo_id": "embryo_1",
+        "old_position_coarse": {"x": 1.0, "y": 2.0},
+        "new_position_coarse": {"x": 5.0, "y": 6.0},
+        "fine_position_invalidated": True,
+    }, source="web:map-edit")
+    src.publish(EventType.OPERATOR_MARKED_EMBRYOS, {
+        "embryo_ids": ["embryo_2", "embryo_3"], "count": 2,
+    }, source="detect_embryos:web-editor")
+    src.publish(EventType.ERROR_OCCURRED, {"msg": "lost focus"},
+                source="device-layer")
+    cap.stop()
+
+    dst = EventBus()
+    dlog = DecisionLog(tmp_path / "decisions.jsonl")
+    dlog.open()
+    runner = ShadowRunner(dst)
+    runner.add(ReactiveCandidate("replay-cand", dlog))
+    runner.start()
+
+    n = EventReplay(tmp_path / "events.jsonl").replay(dst)
+    runner.stop()
+    dlog.close()
+
+    assert n == 4  # all four events replayed
+    decs = _decisions_for(dlog)
+    # EMBRYOS_UPDATE is silent ingest; the other 3 each produce a decision.
+    triggers = [(d.trigger.value, d.trigger_detail) for d in decs]
+    assert triggers == [
+        ("event", "OPERATOR_EDITED_EMBRYO"),
+        ("event", "OPERATOR_MARKED_EMBRYOS"),
+        ("event", "ERROR_OCCURRED"),
+    ]
+    tool_names = [d.tool_calls[0]["name"] if d.tool_calls else None for d in decs]
+    assert tool_names == [
+        "recalibrate_embryo",
+        "calibrate_all_embryos",
+        "escalate_to_operator",
+    ]

From ed75933e157a9c37608938a5f48163c2c24ec625 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 15 May 2026 19:52:56 -0400
Subject: [PATCH 011/314] docs: closed-loop paradigm write-up

Distillation of the design conversation that produced the
paradigm/closed-loop branch:

  - The four orchestrator roles and which one creates the friction
  - Web/chat reconciliation patterns A/B/C/D
  - Why 'turn' is the wrong unit and 'decision moment' is right
  - Wake-router model (events + schedule + user input)
  - Tiered world model (snapshot / digest / pull tools / lazy summariser)
  - Five testing primitives ranked by payoff
  - Coarse-vs-fine schema as 'measurement provenance'
  - Map as collaborative world model
  - Revolutionary trajectories: plans-as-goals, compounding learning,
    collaborative world model, reverse-mode microscopy, continuous shadow
  - What is built (commit table), what is not yet, and the open
    questions for the next iteration

Future-self / new-collaborator reference, not a transcript.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 938baf8a74fbd8a1fe3a08df113104412283c596)
---
 docs/CLOSED_LOOP_PARADIGM.md | 536 +++++++++++++++++++++++++++++++++++
 1 file changed, 536 insertions(+)
 create mode 100644 docs/CLOSED_LOOP_PARADIGM.md

diff --git a/docs/CLOSED_LOOP_PARADIGM.md b/docs/CLOSED_LOOP_PARADIGM.md
new file mode 100644
index 00000000..8f1cf80d
--- /dev/null
+++ b/docs/CLOSED_LOOP_PARADIGM.md
@@ -0,0 +1,536 @@
+# Closed-Loop Paradigm: Notes on the Discussion
+
+This document captures the design conversation that produced everything on the
+`paradigm/closed-loop` branch: the schema split, the Map-as-embryo-home work,
+the operator-action vocabulary, the eval substrate (capture / replay /
+decisions / shadow), and the trajectory the system is on. It is a
+distillation, not a transcript — a future-self / new-collaborator reference
+for *why* this code looks the way it does and *where it is going*.
+
+---
+
+## 1. The Original Friction
+
+The conversation started from a small, concrete observation by the operator:
+
+> "It feels awkward that the operator has to go between the chat in the TUI
+> and the viz server… or even to chat about detecting embryos."
+
+That awkwardness is a symptom, not a defect. It surfaces a deeper design
+question: **what is the orchestrator (the agent) actually for?** Today the
+orchestrator does at least four jobs at once, and one of them — *tool router*
+— is the one creating the friction.
+
+### The four orchestrator roles
+
+| Role | Description | Replaceable by a button? |
+| --- | --- | --- |
+| 1. Tool router | "Detect embryos" → `detect_embryos()` call | **Yes** — this is the friction surface |
+| 2. Workflow runner | Timelapses, multi-embryo plans, perception loops | No |
+| 3. Domain reasoner | Knows microscopy, embryos, safety constraints | No |
+| 4. Session memory | Coherent narrative of what happened and why | No |
+
+Routing a single click through chat for a routine action is the system
+fighting against its own users. Routing a multi-step scientific decision
+through Claude is using the right tool for the right job. The paradigm here
+is: **shrink role 1 to its essentials, keep roles 2–4 first-class, and let
+the UI carry the rest.**
+
+---
+
+## 2. Web ↔ Chat Reconciliation Patterns
+
+Four ways to relate the web UI and the chat orchestrator. Each has a
+distinct world model property:
+
+### A. Chat-only intent (the old default)
+
+Every action originates in chat. The web is observation + delegated subtasks
+(e.g. the marking canvas is a delegation the orchestrator triggers).
+
+* Cleanest record.
+* Worst friction.
+* Orchestrator's world model is "complete" because every change passes
+  through it.
+
+### B. Two parallel command surfaces
+
+Operator clicks in web, web acts directly; orchestrator finds out by polling
+state or doesn't find out at all.
+
+* Lowest friction.
+* Orchestrator's world model **drifts from reality** — fatal for role 4
+  (session memory) and dangerous for role 3 (safety reasoning).
+
+### C. Web acts, orchestrator subscribes *(the chosen direction)*
+
+Operator clicks → web performs the action **and** publishes an event
+(`OPERATOR_*`) → orchestrator's session memory ingests it.
+
+* Chat log shows only human conversation.
+* Orchestrator's working context shows chat + events as a single timeline.
+* Phase 7 (operator events vocabulary + reactive candidate) is the first
+  installment of this pattern.
+
+### D. Cross-pattern hybrid
+
+Different action classes use different patterns. Heavy / novel / composite
+actions use chat (A); routine / clickable / contextual actions use web (C).
+This is what the system actually drifts toward; pattern C is the substrate
+that makes it possible.
+
+The orchestrator's job shifts from being **a funnel for action** to being **a
+brain that knows what's happening on every surface**.
+
+---
+
+## 3. The "Turn" is Wrong; the "Decision Moment" is Right
+
+Chat-AI literature reasons in *turns* (user message → assistant response).
+That model imports an assumption that does not hold here: the human is at
+the keyboard continuously. In a microscopy experiment running 12+ hours, the
+human checks in once, twice, maybe ten times. The agent is autonomous in
+between.
+
+The right unit is a **decision moment**, triggered by:
+
+1. **User message** — rare, interrupting (classic chat turn).
+2. **Critical event** — error, safety violation, lost focus, perception
+   anomaly. Wake immediately; decide to act / abort / escalate.
+3. **Phase boundary** — between timepoints, between embryos. Built-in
+   checkpoint: review state, decide whether to continue.
+4. **Periodic checkpoint** — every N minutes if nothing else happened.
+   Catches slow drifts.
+
+Between moments the agent is asleep. Plans execute autonomously. Events
+accumulate on the bus and in the world model. When the next decision
+moment fires, the agent reads:
+
+* The trigger (why am I waking up?)
+* The world snapshot (NOW state)
+* The events digest (what happened since last wake)
+* The conversation history (which might be hours old and less relevant
+  than usual)
+
+This is closer to a **supervisory controller** than a chat partner. The
+conversation history matters less than usual; what matters more is the
+**flight log** (events) plus the **current state snapshot**.
+
+### Trigger model — concrete
+
+A small router (in code, not Claude) sits between the bus and the brain:
+
+```
+   user input ─┐
+   event bus ──┼─► wake-router ──► (compose context) ──► claude.messages.create
+   schedule  ──┘
+```
+
+The router's responsibilities:
+* Subscribe to a whitelist of "wake-worthy" event types.
+* Hold a debounce / coalescing buffer (so a burst of events becomes one
+  wake).
+* Keep a heartbeat schedule (every N minutes if no other trigger fired).
+* On wake, package: trigger, world snapshot, events digest, recent
+  conversation tail.
+* Surface the package to the brain.
+
+The brain stays the brain (Claude). The router is cheap, deterministic,
+debuggable code. It's the **meta-orchestrator** the operator mentioned —
+**not as another LLM**, but as a control surface.
+
+### Phase boundaries: hand-back vs subscribe
+
+Two designs for letting the brain look in mid-plan:
+
+* **Plan hands control back** at well-known points (between embryos, every
+  5 timepoints). Cheaper, predictable, slightly less reactive.
+* **Plan never pauses; brain subscribes to plan events** ("perception
+  complete for embryo 3"). More reactive, more plan-coupling.
+
+The first one composes better with the supervisory-controller framing and
+is the recommended starting point.
+
+### Idle ticks
+
+If 30 min pass with no event and no user, should the agent wake to verify
+everything's OK? Default to **yes — periodic ticks with a high action
+threshold.** Most ticks should result in the agent doing nothing. The
+purpose is catching slow drifts (focus, sample state, hardware
+degradation) that don't trigger their own events.
+
+---
+
+## 4. World Model — Tiered, Not Monolithic
+
+A common mistake is "summarise everything every turn." Better is a tiered
+model where different freshness/density tiers carry different cadence
+costs.
+
+### Tier 1 — World snapshot
+
+Structured, ~30 lines, computed from in-memory state (not events), every
+wake.
+
+Includes: live stage XY/Z, current session id, embryo list with
+calibration state, current plan, acquisition status, recent operator
+actions (one-line summary).
+
+Cheap to build, fresh every time. Already mostly present in the
+codebase — `agent.experiment.get_summary()` plus the cached
+`DEVICE_STATE_UPDATE` payload is 80% of this.
+
+### Tier 2 — Recent-events digest
+
+Hand-written formatter over the events bus, filtered to wake-worthy types,
+inserted as a system note at each wake.
+
+Shape: `"Since last response: operator added embryo 4 via Map at 14:32; calibration completed for embryo 2; one perception trace pending."`
+
+Hand-written because LLM summarisation here adds latency, cost, and
+non-determinism for low value. Events are already structured.
+
+### Tier 3 — Pull tools
+
+For when reasoning needs depth: `get_recent_perceptions(embryo_id, n=5)`,
+`get_session_timeline()`, `get_learnings(campaign_id)`, etc. The agent
+calls these when it wants the detail.
+
+### Tier 4 — Optional LLM summariser
+
+Reserved for genuinely natural-language streams that resist rule-based
+compression: accumulated CV reasoning chains, narrative observations,
+cross-session learnings. Use a smaller, faster Claude model (Haiku is the
+natural fit). Run lazily, when a tier-3 tool asks for "summarise the last
+30 min for embryo 3."
+
+### Why this shape
+
+Decision moments are **rare** in autonomous mode. Token budget per wake
+can be generous (it's mostly idle compute). What matters more than budget
+is **cadence of waking** — saving 200 tokens per turn doesn't help if
+you're waking up at the wrong moments.
+
+---
+
+## 5. Testing — Where Most Projects Fail
+
+You cannot iterate on agent architecture without a way to compare
+architectures. Microscopy makes this hard:
+
+* Physical, non-deterministic, non-replayable in the trivial sense.
+* "Correct" is fuzzy — biological judgements rarely have ground truth.
+* Slow feedback (a timelapse takes hours).
+* Can't always reset to a clean state (samples are consumed).
+
+Five testing primitives, ranked by payoff per unit work (this ordering
+informed Phase 6's build order):
+
+### 5.1 Event replay *(built — Phase 6a/6b)*
+
+Capture the full event stream during a real run. Offline, replay it
+through any candidate architecture. Diff its decisions against
+production's. **Foundation** — without it, every change to the
+orchestrator is a flight test.
+
+### 5.2 Shadow mode *(built — Phase 6d)*
+
+During a real experiment, candidate architectures run alongside
+production. They see the same events but their decisions are *logged,
+not enacted*. Unique value over pure replay: shadow agents experience
+real temporal cadence, so timing-sensitive things (drift, races) are
+caught.
+
+### 5.3 Synthetic event sequences
+
+Hand-crafted streams: cascading errors, ambiguous perception,
+contradictory operator actions, focus drift, network drop mid-acquisition.
+Stress / chaos testing. The orchestrator is correct if it doesn't do
+something catastrophic — much easier to score than biological
+correctness.
+
+Trivially built on top of 5.1 — write a `jsonl` by hand, replay it.
+
+### 5.4 Decision-level micro-benchmarks
+
+Specific judgements — "given this perception result and these recent
+observations, should the agent re-focus?" — captured as
+(input → expected decision) pairs labelled by a biologist. Regression
+suite. Cheap with biologist time, expensive to bootstrap, very valuable
+once you have a few hundred.
+
+### 5.5 Multi-agent A/B in production
+
+Two embryos in the same dish, one supervised by architecture A and one
+by B (both honouring the firmware fence). Compare biological outcomes.
+Slow (one timelapse per data point), but the **only thing that measures
+biological correctness end-to-end.**
+
+---
+
+## 6. Embryo Schema: Coarse vs Fine
+
+Foundational and quietly important. Each embryo carries:
+
+* `position_coarse` — set by bottom-camera detection or manual Map
+  placement. Always present.
+* `position_fine` — set later by SPIM-objective alignment (workflow not
+  yet built). Initially `{}`.
+* `stage_position` — a *derived property*: `fine if fine else coarse`.
+  Downstream motion / perception keeps reading this and stays agnostic
+  about which calibration stage we're in.
+
+This is the seed for a broader idea: **measurements have provenance and
+calibration state**. The same embryo at the same nominal XY can have
+different "true" positions depending on which sensor sighted it. Encode
+that explicitly so any downstream decision can ask *"how confident is
+this position?"* without needing to know the whole calibration history.
+
+When the operator drags an embryo on the Map, the PUT clears `fine` —
+overriding the sighting invalidates any SPIM-derived fine alignment
+derived from the old coarse. `OPERATOR_EDITED_EMBRYO` carries
+`fine_position_invalidated` so the candidate / future controller can
+schedule a re-alignment without inferring it.
+
+---
+
+## 7. The Map as Collaborative World Model
+
+The Devices > Map page is more than visualisation. It is the **first
+collaborative surface** between operator and orchestrator: both can read
+the embryo list; both can mutate it. The orchestrator subscribes; the
+operator clicks.
+
+Visual semantics matter:
+
+* Coarse-only embryo → outlined ring + number. *Provisional.*
+* SPIM-fine-calibrated → filled disc + number. *Committed.*
+
+Calibration state is then visible at a glance across the slide — the
+operator can scan and see "embryo 3 still needs alignment" without
+opening anything.
+
+The pick-up / drop interaction (Phase 5) deliberately rejects
+click-to-add: the Map is a schematic, not a satellite view. Adding a
+new sighting without a visual reference is guessing. New embryos go
+through the bottom-camera marking canvas. The Map is for **editing what
+already exists**.
+
+### Future arc
+
+* **Annotations beyond position**: operator marks "this is the control",
+  "this one is dead, skip", "I think this is in 2-cell stage". These
+  become first-class scientific observations through additional
+  `OPERATOR_*` events.
+* **Satellite tile**: render the live bottom-camera frame as an overlay
+  on the Map at the current stage XY, scaled by um_per_pixel. Inside
+  that tile, click-to-add becomes meaningful (you can see what you're
+  picking). Outside, the Map stays schematic.
+
+---
+
+## 8. Revolutionary Trajectories
+
+Some of these are reasonable extensions; some are genuinely new.
+
+### 8.1 Plans-as-goals, not scripts
+
+Operator specifies "characterise gut development for these four
+embryos." Orchestrator translates this into a continuously adapted
+imaging plan that changes based on what perception sees mid-run. The
+plan isn't a fixed script handed to Bluesky — it's a negotiation the
+orchestrator keeps in flight, with the world model as the substrate
+for adaptation.
+
+Requires: tier-1 + tier-2 world model, decent perception loop, a way
+to express goals as predicates over the world model.
+
+### 8.2 Compounding cross-session learning
+
+`agent/learnings/` already exists. Today it's barely used. With replay
++ shadow, an architecture that proposes priors ("embryos at 3-fold
+typically need slower piezo") becomes **A/B testable across sessions**.
+Improvement gets *measurable*, which is the unlock — most "smart
+microscopy" today is shallow because it has no measurement loop.
+
+The right framing: each session is a **trial**, the orchestrator is the
+**experimenter**, the world model is what carries learning between
+trials.
+
+### 8.3 Collaborative world model
+
+The Map (operator edits embryos) is the first instance. Extend
+everywhere:
+
+* Operator annotates morphology on the Map → orchestrator updates
+  hypothesis space.
+* Operator marks a focus failure → orchestrator marks the calibration
+  region as untrustworthy.
+* Operator confirms a perception → orchestrator increases confidence in
+  the perception predicate for similar inputs.
+
+The point is making the operator's tacit knowledge **first-class data**
+that the system can reason about, not just record.
+
+### 8.4 Reverse-mode microscopy
+
+"I want to know X — plan the imaging that answers X." The orchestrator
+translates scientific goals into imaging plans. This is the
+plans-as-goals idea taken to its conclusion: the operator describes
+intent in scientific terms, the orchestrator owns the imaging strategy.
+
+Tractable only once 8.1 and the goal language are built.
+
+### 8.5 Continuous shadow / always-on critic
+
+Run the production orchestrator + a shadow candidate continuously, and
+log all decision divergences. Over weeks, the divergence log becomes a
+**dataset of disagreements**. Each disagreement is either:
+
+* Production was right, candidate was wrong → candidate needs a fix.
+* Candidate was right, production was wrong → consider promotion or
+  investigate why production picked differently.
+* Both were defensible → annotate the case.
+
+Free with the eval substrate (Phase 6); the only addition is a
+divergence collator.
+
+---
+
+## 9. Concretely Built Today (`paradigm/closed-loop` branch)
+
+| # | Commit | What |
+| --- | --- | --- |
+| 1 | `3e410581` | Schema split: `position_coarse` / `position_fine` / derived `stage_position`. |
+| 2 | `617e54c9` | `ExperimentState.notify_embryos_changed()` observer → `EMBRYOS_UPDATE` broadcast. |
+| 3 | `144d9fc9` | Map render layer — lavender rings (coarse) / discs (fine) / numbers. |
+| 4 | `4fbb9edf` | `detect_embryos` flows through web Marking canvas; `auth.py` + `require_control`. |
+| 5 | `8f6553e1` | Map pick-up / drop / Delete to edit embryos in place (control-gated PUT/DELETE). |
+| 6 | `808fe813` | Side-fix: re-enable XY joystick at device-layer boot. |
+| 7 | `f7a13d69` | Side-fix: image-anchored crosshair + scroll-to-zoom in camera panel. |
+| 8 | `d69cc219` | `gently/eval/`: event capture / replay / shadow / decision log scaffolding. |
+| 9 | `75d7c9db` | Production decision capture wired through `ConversationManager.call_claude`. |
+| 10 | `0a97563e` | `OPERATOR_*` event vocabulary + `ReactiveCandidate` (first real shadow). |
+
+### Per-session disk shape now
+
+`D:\Gently3\sessions\{id}\`
+
+* `events.jsonl` — captured event bus, telemetry-filtered.
+* `decisions.jsonl` — every Claude turn (success + error).
+* `interaction_log.jsonl` — pre-existing chat-shaped interactions.
+* `timeline.jsonl` — pre-existing session timeline.
+* Plus everything from the legacy FileStore layout.
+
+### Eval CLI
+
+`python scripts/replay_session.py {session_id_prefix} [--histogram] [--candidate {name}] [--real-time] [--time-scale N]`
+
+---
+
+## 10. What is *Not* Done Yet
+
+These are the natural follow-ups; sketched as future-self breadcrumbs.
+
+### Near-term (days)
+
+* **Tier-1 world snapshot** as a system-prompt section the brain sees
+  on every wake. Build the snapshot from `agent.experiment` plus the
+  last cached `DEVICE_STATE_UPDATE`. ~30 lines of formatted prose, every
+  wake.
+* **Tier-2 events digest** — hand-written formatter that reads the
+  bus's recent meaningful events (or the captured jsonl tail) and
+  produces a one-paragraph "since last response" note.
+* **Snapshot ingest into the brain's prompt** — `_update_system_prompt`
+  already takes a `context_summary`; route tier-1 + tier-2 through it.
+
+### Medium-term (weeks)
+
+* **Wake-router** — the code-level scheduler from §3. Currently the
+  brain only wakes on user message. Add: event-driven wake (subscribe
+  to wake-worthy events), periodic-tick wake (heartbeat), debounce /
+  coalesce buffer.
+* **More operator events** — `OPERATOR_ANNOTATED_EMBRYO` ("this is the
+  control", "skip, looks dead"), `OPERATOR_STARTED_TIMELAPSE`,
+  `OPERATOR_INTERRUPTED_PLAN`, `OPERATOR_TOGGLED_CAMERA`. Whatever the
+  Map / web UI lets the operator do should publish a typed event.
+* **SPIM-fine alignment workflow** — populate `position_fine`. Tool +
+  per-embryo state transition. Triggers `EMBRYOS_UPDATE` and a new
+  `FINE_ALIGNMENT_COMPLETED` event the orchestrator can react to.
+* **Continuous-shadow harness** — extend `ShadowRunner` to run a
+  candidate alongside production in the live agent process (not just
+  during replay). Collect divergences into a per-session
+  `divergences.jsonl`.
+
+### Longer arc (months)
+
+* **A goal expression language** — predicates over the world model that
+  let the operator say "image until 4-fold" or "follow the cell
+  divisions in embryo 3 at high resolution." This is the substrate for
+  §8.1 (plans-as-goals).
+* **LLM-driven candidates** — once the rule-based `ReactiveCandidate`
+  proves the substrate, add Claude-driven candidates (Haiku for cheap,
+  Opus for thinking). Use the snapshot+digest as their input.
+* **Cross-session learning loop** — wire the `learnings/` store into
+  the world model as priors. Add a learning-write surface (a tool the
+  orchestrator can call when it notices a pattern). Use shadow A/B to
+  validate that learnings improve decisions.
+* **Goal-driven evaluation** — once goals exist, "did the experiment
+  achieve its goal" becomes a measurable end-to-end success rate. The
+  ultimate metric is this, not turn-level decision diffs.
+
+---
+
+## 11. Principles That Surface Throughout
+
+A few recurring design priors worth naming:
+
+1. **Distill, don't dump.** Structured summaries beat raw logs in
+   prompts. Hand-written formatters beat LLM summarisers for
+   structured data. LLMs for prose, code for structure.
+2. **Pull beats push when uncertain.** Default to tools the agent
+   queries on demand, not data shoved into every prompt. Push only
+   what's universally relevant (the world snapshot).
+3. **Same shape for production and shadow.** If production writes a
+   Decision with these fields, shadow candidates write Decisions with
+   the same fields. Diff is then trivial.
+4. **Events carry intent; state carries position.** `EMBRYOS_UPDATE`
+   is state (the embryo list now). `OPERATOR_EDITED_EMBRYO` is intent
+   (a human just did this). Both exist; they answer different
+   questions.
+5. **The brain doesn't move hardware.** All hardware action goes
+   through tools that go through the device layer that goes through
+   ophyd that goes through MMCore. Shadow candidates are constructively
+   prevented from acting. Layers are not negotiable.
+6. **No SaveCardSettings.** Firmware persistent state silently inherits
+   between sessions; if it ever gets out of sync with code it's a
+   debugging nightmare. Apply firmware config every boot, code wins.
+7. **Localhost is the diSPIM box. Remote is view-only by default.**
+   Auth surface stays tiny and explicit. Token upgrade is the seam,
+   not user accounts.
+
+---
+
+## 12. Open Questions (Worth Revisiting Later)
+
+* **Continuous vs episodic shadows.** Continuous always-on shadow
+  captures divergence over time but multiplies cost (multiple LLM
+  candidates running). Episodic shadow at decision moments is cheaper
+  but misses timing-sensitive cases. Hybrid?
+* **Is the conversation history the right substrate at all?** With
+  decision moments hours apart, prior chat may be more distracting
+  than useful. Maybe the brain shouldn't see chat history beyond N
+  hours; the world model + events digest are the durable memory and
+  chat is just for the active dialogue.
+* **How much should the operator know about the orchestrator's plan?**
+  Today the operator drives by asking. With autonomous mode, the
+  orchestrator runs experiments largely on its own. Should there be a
+  permanent "what is the orchestrator thinking right now" surface
+  visible on the Map? An always-on intent display?
+* **Failure semantics.** If a candidate would have made a different
+  decision than production, and production's decision led to a bad
+  outcome, the candidate "wins." How do we score? Define "bad outcome"
+  rigorously enough that it can be measured?
+
+These are not blockers. They are notes for the next iteration of this
+document, after a few weeks of running on the substrate built here.

From 6dd37be4b55fb2aa84f5f49497870ccc6e4a5032 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sat, 16 May 2026 17:16:04 -0400
Subject: [PATCH 012/314] events: bridge Python logs onto the EventBus / Events
 page

The console output from launch_gently.py is the most informative surface
in the system -- calibration progress, plan executor state changes,
perception decisions, MMCore callbacks. Until now it lived only in the
terminal and on-disk gently_*.log. This bridge fans it onto the EventBus
too, so the Events page in the viz server mirrors what the operator
would otherwise have to alt-tab to a terminal to see.

Backend
-------
gently/core/log_bridge.py
  LogToBusHandler(logging.Handler) -- emit() publishes EventType.LOG_RECORD
  with {level, level_name, logger, message, module, func, line, ts_ms,
  exc_text?}. Per-thread re-entry guard prevents a subscriber's own log
  call from spawning a cascade. Loggers in gently.core.event_bus and
  gently.core.log_bridge are never bridged.

  configure_log_bridge() reads three env vars:
    GENTLY_LOG_BUS                  off/on (default on)
    GENTLY_LOG_BUS_LEVEL            threshold (default INFO)
    GENTLY_LOG_BUS_INCLUDE_THIRDPARTY  also bridge aiohttp/uvicorn/
                                       bluesky/anthropic/httpx/httpcore
                                       (default off -- keeps the page
                                       readable; durable copy still in
                                       gently_*.log)
  Idempotent: re-attaching is a no-op.

gently/core/event_bus.py
  EventType.LOG_RECORD added, plus inclusion in _NO_HISTORY_TYPES (log
  records can fire hundreds-per-minute and would crowd out the bounded
  history deque used for "meaningful" events).

launch_gently.py
  configure_log_bridge() runs right after configure_logging() in main().
  Single line, env-controlled, no API changes.

Frontend
--------
gently/ui/web/static/js/events.js
  addEventToTable() branches on LOG_RECORD vs everything else. Log rows
  render with a level-coloured badge (DEBUG / INFO / WARN / ERROR), the
  logger name greyed before the message, and click-to-expand reveals the
  full payload including stack traces.

gently/ui/web/static/css/main.css
  Four new .event-type-badge.log-{debug,info,warn,error} classes
  matching the existing badge palette. Monospace font for log message,
  red tint for exception lines.

websocket.js already forwards everything except DEVICE_STATE_UPDATE /
BOTTOM_CAMERA_FRAME to the events table; LOG_RECORD inherits that
behaviour automatically.

Tests
-----
tests/test_log_bridge.py: 10 tests covering pass-through, level threshold,
exception capture, re-entry guard, bridge-internal logger skip,
GENTLY_LOG_BUS=off path, default attach, idempotency, third-party
exclusion default, opt-in third-party. 10/10 green; full paradigm suite
42/42.

Phase 9. On paradigm/closed-loop only.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 6318691b24994d006e7cf83893b5ad1f05fd68a8)
---
 gently/core/event_bus.py          |   8 +
 gently/core/log_bridge.py         | 175 ++++++++++++++++++++++
 gently/ui/web/static/css/main.css |  14 ++
 gently/ui/web/static/js/events.js | 148 ++++++++++++++-----
 launch_gently.py                  |   5 +
 tests/test_log_bridge.py          | 235 ++++++++++++++++++++++++++++++
 6 files changed, 546 insertions(+), 39 deletions(-)
 create mode 100644 gently/core/log_bridge.py
 create mode 100644 tests/test_log_bridge.py

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 3d59d9c6..d5495976 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -84,6 +84,11 @@ class EventType(Enum):
     BOTTOM_CAMERA_FRAME = auto()   # Live JPEG frame from the bottom camera stream
     EMBRYOS_UPDATE = auto()        # Full embryo list snapshot from agent.experiment
 
+    # Python logging.LogRecord republished onto the bus so the Events page
+    # surfaces what would otherwise only land in the terminal. See
+    # gently/core/log_bridge.py — opt-in handler.
+    LOG_RECORD = auto()
+
     # Operator-action events. Distinct from EMBRYOS_UPDATE because they
     # carry intent ("a human did this") rather than just state delta.
     # Candidate orchestrators can subscribe and reason about what the
@@ -166,6 +171,9 @@ class EventType(Enum):
 _NO_HISTORY_TYPES = frozenset({
     EventType.DEVICE_STATE_UPDATE,
     EventType.BOTTOM_CAMERA_FRAME,  # ~2 Hz JPEG frames — would crowd history out
+    EventType.LOG_RECORD,           # log lines can hit hundreds/min during
+                                    # calibration; durable copy is in the
+                                    # gently_*.log file already
 })
 
 
diff --git a/gently/core/log_bridge.py b/gently/core/log_bridge.py
new file mode 100644
index 00000000..d8d7e69f
--- /dev/null
+++ b/gently/core/log_bridge.py
@@ -0,0 +1,175 @@
+"""Bridge Python logging into the EventBus so the Events page mirrors the
+console.
+
+A small ``LogToBusHandler`` subclasses ``logging.Handler``. Every record it
+sees gets published as ``EventType.LOG_RECORD`` with a compact payload the
+frontend can render. The handler attaches itself to whichever loggers
+``configure_log_bridge`` is told to cover — by default only ``gently`` and
+``gently_perception``, which keeps third-party noise (aiohttp access logs,
+bluesky state transitions, anthropic SDK chatter) off the page unless the
+operator opts in.
+
+Env-configurable:
+    GENTLY_LOG_BUS                — "on" / "off" (default: on)
+    GENTLY_LOG_BUS_LEVEL          — DEBUG / INFO (default) / WARNING / ERROR
+    GENTLY_LOG_BUS_INCLUDE_THIRDPARTY — "1"/"true" to include common third-
+                                       party loggers (uvicorn, aiohttp,
+                                       bluesky, anthropic, httpx, httpcore)
+
+Re-entrancy is the only real subtlety: if a log call happens inside the
+EventBus.publish path (e.g. from the dispatch loop's logger), republishing
+it as another LOG_RECORD would loop forever. Guarded with a thread-local
+re-entry flag.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+import threading
+from typing import Iterable, Optional, Sequence
+
+from .event_bus import EventBus, EventType, get_event_bus
+
+logger = logging.getLogger(__name__)
+
+
+# Loggers we never want on the Events page — they emit at the wrong layer
+# (their own log lines describe bus dispatch / events page WebSocket frames)
+# so republishing them would create feedback or infinite churn.
+_NEVER_BRIDGE = frozenset({
+    "gently.core.event_bus",
+    "gently.core.log_bridge",
+})
+
+# Loggers that count as "third-party noise" — silenced by default, can be
+# opted in with GENTLY_LOG_BUS_INCLUDE_THIRDPARTY=1.
+_THIRDPARTY_DEFAULTS: Sequence[str] = (
+    "uvicorn", "uvicorn.error", "uvicorn.access",
+    "aiohttp", "aiohttp.access",
+    "anthropic", "httpx", "httpcore",
+    "bluesky", "bluesky.RE.state",
+)
+
+
+class LogToBusHandler(logging.Handler):
+    """Publishes each record onto the EventBus as a LOG_RECORD event.
+
+    Per-thread re-entry guard prevents infinite loops when something in
+    the publish path itself logs.
+    """
+
+    def __init__(self, bus: EventBus, *, level: int = logging.INFO):
+        super().__init__(level=level)
+        self._bus = bus
+        self._reentry = threading.local()
+
+    def emit(self, record: logging.LogRecord) -> None:
+        # Re-entry guard: if a downstream subscriber's handler logs, we
+        # must not republish that log line.
+        if getattr(self._reentry, "active", False):
+            return
+        # Never bridge our own machinery — those records describe the
+        # bridge itself, would loop.
+        if record.name in _NEVER_BRIDGE:
+            return
+        self._reentry.active = True
+        try:
+            try:
+                # format() runs all configured formatters (incl. exc_info
+                # serialisation). We send the formatted message + the
+                # structured bits separately so the frontend can choose
+                # how to render.
+                message = record.getMessage()
+            except Exception:
+                message = "<log format error>"
+
+            payload = {
+                "level": int(record.levelno),
+                "level_name": record.levelname,
+                "logger": record.name,
+                "message": message,
+                "module": record.module,
+                "func": record.funcName,
+                "line": record.lineno,
+                # Wall-clock ms since epoch — frontend uses this for its
+                # own ordering / display, separate from the EventBus's
+                # internal timestamp.
+                "ts_ms": int(record.created * 1000),
+            }
+            if record.exc_info:
+                try:
+                    payload["exc_text"] = logging.Formatter().formatException(record.exc_info)
+                except Exception:
+                    pass
+
+            self._bus.publish(
+                event_type=EventType.LOG_RECORD,
+                data=payload,
+                source=f"log:{record.name}",
+            )
+        except Exception:
+            # If we can't publish (shutdown, etc.), drop the record
+            # silently — the live console + on-disk log still have it.
+            pass
+        finally:
+            self._reentry.active = False
+
+
+def configure_log_bridge(
+    bus: Optional[EventBus] = None,
+    *,
+    loggers: Optional[Iterable[str]] = None,
+    level: Optional[str] = None,
+    include_thirdparty: Optional[bool] = None,
+) -> Optional[LogToBusHandler]:
+    """Attach a LogToBusHandler to the requested loggers.
+
+    Returns the installed handler (or None if the bridge is disabled).
+    Idempotent: safe to call multiple times — only the first call attaches.
+
+    Parameters honour env-var defaults so the launch script doesn't need
+    to know the knobs:
+      GENTLY_LOG_BUS                — "off" disables entirely
+      GENTLY_LOG_BUS_LEVEL          — threshold (default INFO)
+      GENTLY_LOG_BUS_INCLUDE_THIRDPARTY — adds aiohttp/uvicorn/bluesky/etc.
+    """
+    if os.environ.get("GENTLY_LOG_BUS", "on").lower() in ("off", "0", "false", "no"):
+        return None
+
+    if bus is None:
+        bus = get_event_bus()
+
+    if level is None:
+        level = os.environ.get("GENTLY_LOG_BUS_LEVEL", "INFO")
+    level_int = getattr(logging, level.upper(), logging.INFO)
+
+    if include_thirdparty is None:
+        env_val = os.environ.get("GENTLY_LOG_BUS_INCLUDE_THIRDPARTY", "")
+        include_thirdparty = env_val.lower() in ("1", "true", "yes", "on")
+
+    if loggers is None:
+        loggers = ["gently", "gently_perception"]
+        if include_thirdparty:
+            loggers = list(loggers) + list(_THIRDPARTY_DEFAULTS)
+
+    handler = LogToBusHandler(bus, level=level_int)
+
+    attached = []
+    for name in loggers:
+        target = logging.getLogger(name)
+        # Skip if already attached (idempotency for re-invocation).
+        if any(isinstance(h, LogToBusHandler) for h in target.handlers):
+            continue
+        target.addHandler(handler)
+        attached.append(name)
+
+    if attached:
+        # Surface the configuration once at startup — using our own logger
+        # (which is in _NEVER_BRIDGE) so this announcement itself doesn't
+        # become a LOG_RECORD event.
+        logger.info(
+            "Log bridge active: level=%s, loggers=%s, include_thirdparty=%s",
+            logging.getLevelName(level_int), attached, include_thirdparty,
+        )
+    return handler
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index ef4dac96..c0a6c539 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -2036,6 +2036,20 @@ a.tab-link.active {
 .event-type-badge.error { background: rgba(248, 81, 73, 0.2); color: #f85149; }
 .event-type-badge.default { background: var(--bg-hover); color: var(--text-muted); }
 
+/* Log-record badges per level. The level is the badge text (DEBUG / INFO /
+   WARN / ERROR) for log rows; the LOG_RECORD type itself is collapsed into
+   the level so the column doesn't read the same string for every line. */
+.event-type-badge.log-debug { background: rgba(125, 134, 145, 0.18); color: #9ba3b0; }
+.event-type-badge.log-info  { background: rgba(88, 166, 255, 0.16); color: var(--accent); }
+.event-type-badge.log-warn  { background: rgba(210, 153, 34, 0.22); color: var(--accent-orange); }
+.event-type-badge.log-error { background: rgba(248, 81, 73, 0.22); color: #f85149; }
+
+/* Log line message: monospace, faint logger prefix, expandable trace. */
+.log-row .event-data { font-family: 'JetBrains Mono', ui-monospace, monospace; }
+.log-logger { color: var(--text-muted); opacity: 0.85; margin-right: 0.5rem; }
+.log-message { color: var(--text); }
+.log-exc { color: #f85149; opacity: 0.85; }
+
 .event-source {
     color: var(--text-muted);
     font-size: 0.75rem;
diff --git a/gently/ui/web/static/js/events.js b/gently/ui/web/static/js/events.js
index 02365e40..3e37eb66 100644
--- a/gently/ui/web/static/js/events.js
+++ b/gently/ui/web/static/js/events.js
@@ -41,6 +41,40 @@ function getEventBadgeClass(eventType) {
     return 'default';
 }
 
+// Log-record helpers --------------------------------------------------
+// LOG_RECORD events come from the Python logging bridge. We collapse the
+// generic "LOG_RECORD" type into the actual level (DEBUG / INFO / WARN /
+// ERROR) so the table is readable -- otherwise every row in a busy
+// session reads the same string in the Type column.
+function isLogEvent(event) {
+    return event && event.event_type === 'LOG_RECORD';
+}
+
+function logLevelLabel(d) {
+    // levelname is fastest path; fall back to numeric mapping if missing.
+    const lvl = (d && (d.level_name || '')).toString().toUpperCase();
+    if (lvl) {
+        if (lvl === 'WARNING') return 'WARN';
+        if (lvl === 'CRITICAL') return 'CRIT';
+        return lvl;
+    }
+    const n = d && Number(d.level);
+    if (!isFinite(n)) return 'LOG';
+    if (n >= 50) return 'CRIT';
+    if (n >= 40) return 'ERROR';
+    if (n >= 30) return 'WARN';
+    if (n >= 20) return 'INFO';
+    return 'DEBUG';
+}
+
+function logBadgeClass(d) {
+    const label = logLevelLabel(d);
+    if (label === 'DEBUG') return 'log-debug';
+    if (label === 'INFO')  return 'log-info';
+    if (label === 'WARN')  return 'log-warn';
+    return 'log-error';  // ERROR / CRIT collapse together
+}
+
 // Search helper functions
 function escapeRegex(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -212,45 +246,81 @@ function addEventToTable(event, prepend = true) {
     if (hasImage) tr.classList.add('has-image');
     tr.dataset.eventId = event.event_id || '';
 
-    const badgeClass = getEventBadgeClass(event.event_type);
-
-    // Image indicator icon
-    const imageIndicator = hasImage
-        ? `<span class="event-image-indicator" title="Has linked image">
-             <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-               <rect x="3" y="3" width="18" height="18" rx="2"></rect>
-               <circle cx="8.5" cy="8.5" r="1.5"></circle>
-               <polyline points="21,15 16,10 5,21"></polyline>
-             </svg>
-           </span>`
-        : '';
-
-    // Thumbnail preview
-    const thumbnailHtml = hasImage
-        ? `<img class="event-thumbnail"
-               src="data:image/png;base64,${linkedImage.base64_png}"
-               onclick="event.stopPropagation(); showEventImage('${imageUid}')"
-               title="Click to view image"
-               alt="Event image">`
-        : '';
-
-    tr.innerHTML = `
-        <td class="col-time">${formatEventTime(event.timestamp)}</td>
-        <td class="col-type">${imageIndicator}<span class="event-type-badge ${badgeClass}">${event.event_type}</span></td>
-        <td class="col-source"><span class="event-source">${event.source || '-'}</span></td>
-        <td class="col-data">${thumbnailHtml}<div class="event-data">${formatEventData(event.data)}</div></td>
-    `;
-
-    // Click to expand data
-    tr.addEventListener('click', () => {
-        const dataDiv = tr.querySelector('.event-data');
-        dataDiv.classList.toggle('expanded');
-        if (dataDiv.classList.contains('expanded')) {
-            dataDiv.innerHTML = `<pre>${JSON.stringify(event.data, null, 2)}</pre>`;
-        } else {
-            dataDiv.innerHTML = formatEventData(event.data);
-        }
-    });
+    if (isLogEvent(event)) {
+        // Log rows have a compact, distinctive shape: level badge in the
+        // Type column, logger name + message in the Data column. Click to
+        // toggle a pre with the full payload (incl. exception trace).
+        tr.classList.add('log-row');
+        const d = event.data || {};
+        const badgeCls = logBadgeClass(d);
+        const label = logLevelLabel(d);
+        const message = highlightSearchTerms(d.message || '');
+        const loggerName = highlightSearchTerms(d.logger || '-');
+        const excTag = d.exc_text ? '<span class="log-exc">  ⏎ trace…</span>' : '';
+        tr.innerHTML = `
+            <td class="col-time">${formatEventTime(event.timestamp)}</td>
+            <td class="col-type"><span class="event-type-badge ${badgeCls}">${label}</span></td>
+            <td class="col-source"><span class="event-source">${event.source || '-'}</span></td>
+            <td class="col-data"><div class="event-data">
+                <span class="log-logger">${loggerName}</span><span class="log-message">${message}</span>${excTag}
+            </div></td>
+        `;
+        tr.addEventListener('click', () => {
+            const dataDiv = tr.querySelector('.event-data');
+            dataDiv.classList.toggle('expanded');
+            if (dataDiv.classList.contains('expanded')) {
+                const tracePart = d.exc_text
+                    ? `\n\n${d.exc_text}` : '';
+                dataDiv.innerHTML =
+                    `<pre>${d.logger || ''}  ${d.func || ''}:${d.line || ''}\n` +
+                    `${(d.message || '')}${tracePart}</pre>`;
+            } else {
+                dataDiv.innerHTML =
+                    `<span class="log-logger">${loggerName}</span>` +
+                    `<span class="log-message">${message}</span>${excTag}`;
+            }
+        });
+    } else {
+        const badgeClass = getEventBadgeClass(event.event_type);
+
+        // Image indicator icon
+        const imageIndicator = hasImage
+            ? `<span class="event-image-indicator" title="Has linked image">
+                 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                   <rect x="3" y="3" width="18" height="18" rx="2"></rect>
+                   <circle cx="8.5" cy="8.5" r="1.5"></circle>
+                   <polyline points="21,15 16,10 5,21"></polyline>
+                 </svg>
+               </span>`
+            : '';
+
+        // Thumbnail preview
+        const thumbnailHtml = hasImage
+            ? `<img class="event-thumbnail"
+                   src="data:image/png;base64,${linkedImage.base64_png}"
+                   onclick="event.stopPropagation(); showEventImage('${imageUid}')"
+                   title="Click to view image"
+                   alt="Event image">`
+            : '';
+
+        tr.innerHTML = `
+            <td class="col-time">${formatEventTime(event.timestamp)}</td>
+            <td class="col-type">${imageIndicator}<span class="event-type-badge ${badgeClass}">${event.event_type}</span></td>
+            <td class="col-source"><span class="event-source">${event.source || '-'}</span></td>
+            <td class="col-data">${thumbnailHtml}<div class="event-data">${formatEventData(event.data)}</div></td>
+        `;
+
+        // Click to expand data
+        tr.addEventListener('click', () => {
+            const dataDiv = tr.querySelector('.event-data');
+            dataDiv.classList.toggle('expanded');
+            if (dataDiv.classList.contains('expanded')) {
+                dataDiv.innerHTML = `<pre>${JSON.stringify(event.data, null, 2)}</pre>`;
+            } else {
+                dataDiv.innerHTML = formatEventData(event.data);
+            }
+        });
+    }
 
     if (prepend) {
         tbody.insertBefore(tr, tbody.firstChild);
diff --git a/launch_gently.py b/launch_gently.py
index 1727dd2a..58f94fb5 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -29,6 +29,7 @@
 import yaml
 
 from gently.log_config import configure_logging
+from gently.core.log_bridge import configure_log_bridge
 from gently.app.agent import MicroscopyAgent
 from gently.organisms import load_organism
 from gently.hardware import load_hardware, get_hardware
@@ -124,6 +125,10 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     log_file = str(log_dir / f"gently_{datetime.now().strftime('%Y%m%d_%H%M%S')}.log")
     # File always gets INFO+, console uses the requested level
     configure_logging(level=log_level, log_file=log_file)
+    # Mirror gently / gently_perception log lines onto the EventBus so the
+    # Events page in the viz server shows them too. Env vars control level
+    # and whether to include noisy third-party loggers (off by default).
+    configure_log_bridge()
     logger.info("Logging to %s (console level: %s)", log_file, log_level)
 
     # Load organism module from config
diff --git a/tests/test_log_bridge.py b/tests/test_log_bridge.py
new file mode 100644
index 00000000..2079d365
--- /dev/null
+++ b/tests/test_log_bridge.py
@@ -0,0 +1,235 @@
+"""Tests for the logging->EventBus bridge."""
+
+from __future__ import annotations
+
+import logging
+import os
+
+import pytest
+
+from gently.core.event_bus import EventBus, EventType
+from gently.core.log_bridge import (
+    LogToBusHandler,
+    configure_log_bridge,
+    _NEVER_BRIDGE,
+)
+
+
+@pytest.fixture
+def bus_with_capture():
+    bus = EventBus()
+    seen = []
+    bus.subscribe(EventType.LOG_RECORD, lambda ev: seen.append(ev))
+    return bus, seen
+
+
+@pytest.fixture
+def isolated_logger(request):
+    """Fresh logger per test; cleaned up after.
+
+    Using uniquely-named loggers under the gently.* namespace ensures we
+    don't tangle with any handlers installed by other tests in the suite.
+    """
+    name = f"gently.test_logbridge.{request.node.name}"
+    lgr = logging.getLogger(name)
+    lgr.setLevel(logging.DEBUG)
+    # Don't propagate to root; we don't want pytest's caplog to swallow it
+    # before our handler sees it.
+    original_propagate = lgr.propagate
+    lgr.propagate = False
+    yield lgr
+    # Teardown: strip handlers we added
+    for h in list(lgr.handlers):
+        lgr.removeHandler(h)
+    lgr.propagate = original_propagate
+
+
+def test_handler_publishes_each_record(bus_with_capture, isolated_logger):
+    """Every log call below threshold becomes a LOG_RECORD event."""
+    bus, seen = bus_with_capture
+    isolated_logger.addHandler(LogToBusHandler(bus, level=logging.DEBUG))
+
+    isolated_logger.debug("debug msg")
+    isolated_logger.info("info msg")
+    isolated_logger.warning("warn msg")
+    isolated_logger.error("error msg")
+
+    assert len(seen) == 4
+    levels = [ev.data["level_name"] for ev in seen]
+    assert levels == ["DEBUG", "INFO", "WARNING", "ERROR"]
+    msgs = [ev.data["message"] for ev in seen]
+    assert msgs == ["debug msg", "info msg", "warn msg", "error msg"]
+
+
+def test_handler_respects_level_threshold(bus_with_capture, isolated_logger):
+    """Records below the handler level are dropped."""
+    bus, seen = bus_with_capture
+    isolated_logger.addHandler(LogToBusHandler(bus, level=logging.WARNING))
+
+    isolated_logger.debug("nope")
+    isolated_logger.info("also nope")
+    isolated_logger.warning("yes")
+    isolated_logger.error("yes")
+
+    assert [ev.data["level_name"] for ev in seen] == ["WARNING", "ERROR"]
+
+
+def test_exc_text_captured_on_exception(bus_with_capture, isolated_logger):
+    """logger.exception() includes the formatted traceback in payload."""
+    bus, seen = bus_with_capture
+    isolated_logger.addHandler(LogToBusHandler(bus, level=logging.DEBUG))
+
+    try:
+        raise RuntimeError("simulated")
+    except RuntimeError:
+        isolated_logger.exception("blew up")
+
+    assert len(seen) == 1
+    payload = seen[0].data
+    assert payload["level_name"] == "ERROR"
+    assert payload["message"] == "blew up"
+    assert payload.get("exc_text") and "RuntimeError" in payload["exc_text"]
+    assert "simulated" in payload["exc_text"]
+
+
+def test_reentry_guard_prevents_infinite_loop(bus_with_capture, isolated_logger):
+    """A bus subscriber that itself logs must NOT spawn cascading events.
+
+    Without the guard, every subscriber-emitted log would republish as
+    another LOG_RECORD, spawn another subscriber call, ... ad infinitum.
+    """
+    bus, seen = bus_with_capture
+    isolated_logger.addHandler(LogToBusHandler(bus, level=logging.DEBUG))
+
+    # Subscriber that re-logs on every event it sees.
+    def loud(ev):
+        isolated_logger.debug("subscriber-internal log")
+
+    bus.subscribe(EventType.LOG_RECORD, loud)
+
+    isolated_logger.info("trigger")
+    # Exactly one event — the original. The subscriber's log was
+    # suppressed by the re-entry guard.
+    assert len(seen) == 1
+    assert seen[0].data["message"] == "trigger"
+
+
+def test_handler_skips_bridge_internals(bus_with_capture):
+    """Records from the bridge's own loggers must never be republished."""
+    bus, seen = bus_with_capture
+    h = LogToBusHandler(bus, level=logging.DEBUG)
+
+    for blocked in _NEVER_BRIDGE:
+        lgr = logging.getLogger(blocked)
+        lgr.setLevel(logging.DEBUG)
+        lgr.addHandler(h)
+        try:
+            lgr.info("from %s", blocked)
+        finally:
+            lgr.removeHandler(h)
+
+    assert seen == []  # nothing republished
+
+
+def test_configure_log_bridge_off_returns_none(bus_with_capture, monkeypatch):
+    """GENTLY_LOG_BUS=off disables the bridge entirely."""
+    bus, seen = bus_with_capture
+    monkeypatch.setenv("GENTLY_LOG_BUS", "off")
+    h = configure_log_bridge(bus=bus, loggers=["gently.cfg_off_test"])
+    assert h is None
+    logging.getLogger("gently.cfg_off_test").info("should not appear")
+    assert seen == []
+
+
+def test_configure_log_bridge_attaches_handler(bus_with_capture, monkeypatch):
+    """Default-on path attaches a handler that publishes records."""
+    bus, seen = bus_with_capture
+    monkeypatch.setenv("GENTLY_LOG_BUS", "on")
+    monkeypatch.setenv("GENTLY_LOG_BUS_LEVEL", "INFO")
+    monkeypatch.delenv("GENTLY_LOG_BUS_INCLUDE_THIRDPARTY", raising=False)
+
+    target_name = "gently.cfg_attach_test"
+    target = logging.getLogger(target_name)
+    target.setLevel(logging.DEBUG)  # otherwise inherits root WARNING
+
+    h = configure_log_bridge(bus=bus, loggers=[target_name])
+    assert h is not None
+    try:
+        target.info("hi")
+        assert any(ev.data["message"] == "hi" for ev in seen)
+    finally:
+        target.removeHandler(h)
+
+
+def test_configure_log_bridge_is_idempotent(bus_with_capture, monkeypatch):
+    """Calling configure twice doesn't double-attach."""
+    bus, seen = bus_with_capture
+    monkeypatch.setenv("GENTLY_LOG_BUS", "on")
+
+    target = "gently.idem_test"
+    logging.getLogger(target).setLevel(logging.DEBUG)
+    h1 = configure_log_bridge(bus=bus, loggers=[target])
+    h2 = configure_log_bridge(bus=bus, loggers=[target])
+    assert h1 is not None
+    try:
+        logging.getLogger(target).warning("once")
+        # If both handlers were attached we'd see two events for the same
+        # record. One event = no double-attach.
+        warn_events = [ev for ev in seen if ev.data["message"] == "once"]
+        assert len(warn_events) == 1
+    finally:
+        for h in (h1, h2):
+            if h is not None:
+                try:
+                    logging.getLogger(target).removeHandler(h)
+                except Exception:
+                    pass
+
+
+def test_third_party_excluded_by_default(bus_with_capture, monkeypatch):
+    """uvicorn / aiohttp / bluesky etc. don't get bridged unless opted in."""
+    bus, seen = bus_with_capture
+    monkeypatch.setenv("GENTLY_LOG_BUS", "on")
+    monkeypatch.delenv("GENTLY_LOG_BUS_INCLUDE_THIRDPARTY", raising=False)
+    # Default behaviour: loggers list omits third-party. We pass None so
+    # the function picks its own default.
+    logging.getLogger("gently").setLevel(logging.DEBUG)
+    h = configure_log_bridge(bus=bus, loggers=None)
+    assert h is not None
+    try:
+        logging.getLogger("aiohttp.access").info("noisy 1")
+        logging.getLogger("bluesky").info("noisy 2")
+        assert seen == []
+        # But gently.* still works
+        logging.getLogger("gently.proves_attached").info("kept")
+        assert any(ev.data["message"] == "kept" for ev in seen)
+    finally:
+        for n in ("gently", "gently_perception"):
+            try:
+                logging.getLogger(n).removeHandler(h)
+            except Exception:
+                pass
+
+
+def test_third_party_included_when_opted_in(bus_with_capture, monkeypatch):
+    """GENTLY_LOG_BUS_INCLUDE_THIRDPARTY=1 brings the noisy loggers in."""
+    bus, seen = bus_with_capture
+    monkeypatch.setenv("GENTLY_LOG_BUS", "on")
+    monkeypatch.setenv("GENTLY_LOG_BUS_INCLUDE_THIRDPARTY", "1")
+    logging.getLogger("aiohttp").setLevel(logging.DEBUG)
+    logging.getLogger("aiohttp.access").setLevel(logging.DEBUG)
+
+    h = configure_log_bridge(bus=bus, loggers=None)
+    assert h is not None
+    try:
+        logging.getLogger("aiohttp.access").info("now visible")
+        assert any(ev.data["message"] == "now visible" for ev in seen)
+    finally:
+        # Strip handler from every logger we might have attached to —
+        # belt and braces, since the function defaults to a long list.
+        for name in (list(logging.Logger.manager.loggerDict.keys()) +
+                     ["gently", "gently_perception"]):
+            try:
+                logging.getLogger(name).removeHandler(h)
+            except Exception:
+                pass

From 7017866b8b7f2badf354b0b4a20aff80922b357a Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 13:18:10 -0400
Subject: [PATCH 013/314] switchbot: BLE room-light accessory device + web test
 GUI

SwitchBot Bot (WoHand) as a Bluesky/ophyd-protocol device over `bleak`
(set('on'|'off'|'press') -> Status, read/describe). Controls the diSPIM
room light used for bottom-camera imaging. Adds a standalone FastAPI test
GUI under diagnostics/ (buttons + morse blinker). Dep in requirements_device.txt.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit a790b028bd384595d58f58dc8af5356300f306dd)
---
 diagnostics/switchbot_webgui.py | 345 ++++++++++++++++++++++++++++++++
 gently/hardware/switchbot.py    | 176 ++++++++++++++++
 requirements_device.txt         |   3 +
 3 files changed, 524 insertions(+)
 create mode 100644 diagnostics/switchbot_webgui.py
 create mode 100644 gently/hardware/switchbot.py

diff --git a/diagnostics/switchbot_webgui.py b/diagnostics/switchbot_webgui.py
new file mode 100644
index 00000000..5832b103
--- /dev/null
+++ b/diagnostics/switchbot_webgui.py
@@ -0,0 +1,345 @@
+#!/usr/bin/env python3
+"""
+Temporary web GUI to play with the SwitchBot Bot that switches the diSPIM room
+light (on for bottom-camera/brightfield imaging, off otherwise).
+
+This is a TEST TOOL, not part of the production device layer. It drives the Bot
+directly over BLE using the same command protocol as
+``gently.hardware.switchbot.SwitchBot`` (same command bytes + GATT UUIDs), but
+over a single *persistent* connection so the buttons feel snappy and the morse
+blinker is fast — the device-layer class is connect-per-command (~1-2 s each),
+which is fine for a plan step but hopeless for blinking.
+
+Features: ON / OFF / PRESS buttons, and a morse-code blinker (blinks the real
+room light + mirrors the pattern on screen). The Bot is a mechanical switch
+pusher, so each toggle is a ~0.5-1 s servo move — morse is deliberately slow.
+
+Run:
+    .venv/bin/python diagnostics/switchbot_webgui.py
+    # then open http://127.0.0.1:8765
+
+    .venv/bin/python diagnostics/switchbot_webgui.py --address EC:6F:04:06:5B:23 --port 8765
+"""
+from __future__ import annotations
+
+import argparse
+import asyncio
+import logging
+from contextlib import asynccontextmanager
+
+import uvicorn
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse, JSONResponse
+from pydantic import BaseModel
+
+# Reuse the device-layer device's protocol definitions (single source of truth).
+from gently.hardware.switchbot import _COMMANDS, _CTRL_CHAR
+
+logger = logging.getLogger("switchbot_webgui")
+
+DEFAULT_ADDRESS = "EC:6F:04:06:5B:23"
+
+# ITU morse, letters + digits. Unsupported characters are skipped.
+MORSE = {
+    "A": ".-", "B": "-...", "C": "-.-.", "D": "-..", "E": ".", "F": "..-.",
+    "G": "--.", "H": "....", "I": "..", "J": ".---", "K": "-.-", "L": ".-..",
+    "M": "--", "N": "-.", "O": "---", "P": ".--.", "Q": "--.-", "R": ".-.",
+    "S": "...", "T": "-", "U": "..-", "V": "...-", "W": ".--", "X": "-..-",
+    "Y": "-.--", "Z": "--..",
+    "0": "-----", "1": ".----", "2": "..---", "3": "...--", "4": "....-",
+    "5": ".....", "6": "-....", "7": "--...", "8": "---..", "9": "----.",
+}
+
+
+class Bot:
+    """A single persistent BLE connection to the Bot, with serialized access."""
+
+    def __init__(self, address: str):
+        self.address = address
+        self._client = None
+        self._lock = asyncio.Lock()
+        self._morse_task: asyncio.Task | None = None
+        self.state = "unknown"
+        self.busy = False
+
+    async def _ensure(self):
+        from bleak import BleakClient
+        if self._client is not None and self._client.is_connected:
+            return
+        self._client = BleakClient(self.address, timeout=20)
+        await self._client.connect()
+        logger.info("connected to %s", self.address)
+
+    async def _write(self, action: str):
+        """Write one command, reconnecting once if the link dropped."""
+        from bleak.exc import BleakError
+        for attempt in (1, 2):
+            try:
+                await self._ensure()
+                await self._client.write_gatt_char(_CTRL_CHAR, _COMMANDS[action], response=True)
+                if action in ("on", "off"):
+                    self.state = action
+                return
+            except (BleakError, OSError, asyncio.TimeoutError) as exc:
+                logger.warning("write %s attempt %d failed: %s", action, attempt, exc)
+                self._client = None  # force reconnect
+                if attempt == 2:
+                    raise
+
+    async def _cancel_morse(self):
+        task = self._morse_task
+        if task and not task.done():
+            task.cancel()
+            await asyncio.gather(task, return_exceptions=True)
+        self._morse_task = None
+
+    async def command(self, action: str) -> str:
+        """ON/OFF/PRESS. Interrupts any running morse (manual override)."""
+        await self._cancel_morse()
+        async with self._lock:
+            await self._write(action)
+        return self.state
+
+    def schedule(self, text: str, unit: float):
+        """Build an on/off timeline [(state, seconds), ...] for a message."""
+        seq = [("off", round(unit, 3))]  # settle to a known state first
+        for ch in text.upper():
+            if ch == " ":
+                seq.append(("off", round(unit * 7, 3)))
+                continue
+            code = MORSE.get(ch)
+            if not code:
+                continue
+            for sym in code:
+                seq.append(("on", round(unit * (3 if sym == "-" else 1), 3)))
+                seq.append(("off", round(unit, 3)))  # intra-letter gap
+            st, _ = seq[-1]
+            seq[-1] = (st, round(unit * 3, 3))  # upgrade to inter-letter gap
+        return seq
+
+    async def start_morse(self, text: str, unit: float):
+        await self._cancel_morse()
+        seq = self.schedule(text, unit)
+        if len(seq) <= 1:
+            return None
+        restore = self.state
+        self._morse_task = asyncio.create_task(self._play(seq, restore))
+        return seq
+
+    async def _play(self, seq, restore: str):
+        async with self._lock:
+            self.busy = True
+            try:
+                for state, dur in seq:
+                    await self._write(state)
+                    await asyncio.sleep(dur)
+                await self._write(restore if restore in ("on", "off") else "off")
+            finally:
+                self.busy = False
+
+    async def stop(self):
+        await self._cancel_morse()
+        async with self._lock:
+            await self._write("off")
+        return self.state
+
+    async def disconnect(self):
+        await self._cancel_morse()
+        if self._client is not None and self._client.is_connected:
+            await self._client.disconnect()
+
+
+BOT: Bot | None = None
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    yield
+    if BOT is not None:
+        await BOT.disconnect()
+
+
+app = FastAPI(lifespan=lifespan)
+
+
+class MorseReq(BaseModel):
+    text: str
+    unit: float = 1.5
+
+
+@app.get("/", response_class=HTMLResponse)
+async def index():
+    return PAGE.replace("__ADDRESS__", BOT.address)
+
+
+@app.get("/status")
+async def status():
+    return {"state": BOT.state, "busy": BOT.busy, "address": BOT.address}
+
+
+@app.post("/cmd/{action}")
+async def cmd(action: str):
+    if action not in _COMMANDS:
+        return JSONResponse({"error": f"unknown action {action!r}"}, status_code=400)
+    try:
+        state = await BOT.command(action)
+    except Exception as exc:
+        return JSONResponse({"error": str(exc)}, status_code=502)
+    return {"state": state}
+
+
+@app.post("/morse")
+async def morse(req: MorseReq):
+    unit = max(0.3, min(4.0, req.unit))
+    text = req.text[:40]
+    try:
+        seq = await BOT.start_morse(text, unit)
+    except Exception as exc:
+        return JSONResponse({"error": str(exc)}, status_code=502)
+    if seq is None:
+        return JSONResponse({"error": "nothing sendable in that text"}, status_code=400)
+    seconds = round(sum(d for _, d in seq), 1)
+    return {"schedule": seq, "unit": unit, "seconds": seconds}
+
+
+@app.post("/stop")
+async def stop():
+    try:
+        state = await BOT.stop()
+    except Exception as exc:
+        return JSONResponse({"error": str(exc)}, status_code=502)
+    return {"state": state}
+
+
+PAGE = """<!doctype html>
+<html lang="en"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>diSPIM Room Light</title>
+<style>
+  :root { color-scheme: dark; }
+  body { margin:0; font-family: ui-sans-serif, system-ui, sans-serif;
+         background:#0d1117; color:#e6edf3; display:flex; min-height:100vh;
+         align-items:center; justify-content:center; }
+  .card { width:min(440px,92vw); padding:28px; background:#161b22;
+          border:1px solid #30363d; border-radius:16px; text-align:center; }
+  h1 { margin:0 0 2px; font-size:20px; }
+  .sub { color:#8b949e; font-size:12px; margin-bottom:18px; font-variant-numeric:tabular-nums; }
+  .bulb { width:96px; height:96px; border-radius:50%; margin:6px auto 4px;
+          background:#21262d; border:1px solid #30363d; transition:.12s;
+          box-shadow:inset 0 0 12px #0008; }
+  .bulb.on { background:#ffd24a; border-color:#ffe08a;
+             box-shadow:0 0 36px 8px #ffd24a99, inset 0 0 12px #fff6; }
+  .state { font-size:13px; color:#8b949e; height:18px; margin-bottom:14px;
+           text-transform:uppercase; letter-spacing:.08em; }
+  .row { display:flex; gap:8px; justify-content:center; margin-bottom:16px; }
+  button { flex:1; padding:12px 0; font-size:14px; font-weight:600; cursor:pointer;
+           border-radius:10px; border:1px solid #30363d; background:#21262d; color:#e6edf3; }
+  button:hover { border-color:#58a6ff; }
+  button:active { transform:translateY(1px); }
+  button.on  { background:#1f6feb33; border-color:#1f6feb; }
+  button.off { background:#30363d; }
+  button.stop{ background:#f8514933; border-color:#f85149; flex:0 0 84px; }
+  .morse { border-top:1px solid #30363d; padding-top:16px; }
+  input[type=text]{ width:100%; box-sizing:border-box; padding:10px; margin-bottom:10px;
+           background:#0d1117; color:#e6edf3; border:1px solid #30363d; border-radius:8px;
+           font-size:15px; text-transform:uppercase; letter-spacing:.1em; }
+  .speed { display:flex; align-items:center; gap:8px; font-size:12px; color:#8b949e; margin-bottom:12px; }
+  .speed input { flex:1; }
+  .mrow { display:flex; gap:8px; }
+  .status { margin-top:14px; font-size:12px; color:#8b949e; min-height:16px; }
+</style></head><body>
+<div class="card">
+  <h1>diSPIM Room Light</h1>
+  <div class="sub">SwitchBot Bot &middot; __ADDRESS__</div>
+  <div id="bulb" class="bulb"></div>
+  <div id="state" class="state">&mdash;</div>
+  <div class="row">
+    <button class="on"  onclick="cmd('on')">ON</button>
+    <button class="off" onclick="cmd('off')">OFF</button>
+    <button onclick="cmd('press')">PRESS</button>
+  </div>
+  <div class="morse">
+    <input id="msg" type="text" maxlength="40" value="SOS" placeholder="message">
+    <div class="speed">
+      <span>fast</span>
+      <input id="speed" type="range" min="0.5" max="3" step="0.1" value="1.5" oninput="sv()">
+      <span>slow</span>
+      <span id="speedval" style="width:34px">0.7s</span>
+    </div>
+    <div class="mrow">
+      <button onclick="sendMorse()">Send Morse</button>
+      <button class="stop" onclick="stop()">Stop</button>
+    </div>
+  </div>
+  <div id="status" class="status"></div>
+</div>
+<script>
+const $ = id => document.getElementById(id);
+let timers = [];
+function setBulb(on){ $('bulb').classList.toggle('on', on); }
+function setState(s){ $('state').textContent = s; if(s==='on')setBulb(true); else if(s==='off')setBulb(false); }
+function clearTimers(){ timers.forEach(clearTimeout); timers = []; }
+function sv(){ $('speedval').textContent = (+$('speed').value).toFixed(1)+'s'; }
+
+async function cmd(a){
+  clearTimers();
+  $('status').textContent = '…';
+  try {
+    const r = await fetch('/cmd/'+a, {method:'POST'});
+    const j = await r.json();
+    if(j.error){ $('status').textContent = '⚠ '+j.error; return; }
+    if(a==='press'){ setBulb(true); setTimeout(()=>setBulb(false), 350); }
+    else setState(j.state);
+    $('status').textContent = 'ok';
+  } catch(e){ $('status').textContent = '⚠ '+e; }
+}
+
+async function sendMorse(){
+  clearTimers();
+  const text = $('msg').value, unit = +$('speed').value;
+  $('status').textContent = 'sending…';
+  try {
+    const r = await fetch('/morse', {method:'POST', headers:{'content-type':'application/json'},
+                                     body: JSON.stringify({text, unit})});
+    const j = await r.json();
+    if(j.error){ $('status').textContent = '⚠ '+j.error; return; }
+    $('status').textContent = 'blinking "'+text+'" — '+j.seconds+'s';
+    let t = 0;
+    for(const [st,dur] of j.schedule){
+      timers.push(setTimeout(()=>setBulb(st==='on'), t*1000));
+      t += dur;
+    }
+    timers.push(setTimeout(()=>{ $('status').textContent='done'; }, t*1000));
+  } catch(e){ $('status').textContent = '⚠ '+e; }
+}
+
+async function stop(){
+  clearTimers();
+  await fetch('/stop', {method:'POST'});
+  $('status').textContent = 'stopped';
+  refresh();
+}
+async function refresh(){
+  try { const j = await (await fetch('/status')).json(); setState(j.state); } catch(e){}
+}
+sv(); refresh();
+</script></body></html>
+"""
+
+
+def main():
+    ap = argparse.ArgumentParser(description="Temporary SwitchBot room-light web GUI")
+    ap.add_argument("--address", default=DEFAULT_ADDRESS, help="Bot BLE MAC address")
+    ap.add_argument("--port", type=int, default=8765)
+    ap.add_argument("--host", default="127.0.0.1", help="bind host (default: localhost only)")
+    args = ap.parse_args()
+
+    logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
+    global BOT
+    BOT = Bot(args.address)
+    print(f"\n  diSPIM Room Light GUI  →  http://{args.host}:{args.port}\n  Bot: {args.address}\n")
+    uvicorn.run(app, host=args.host, port=args.port, log_level="warning")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/gently/hardware/switchbot.py b/gently/hardware/switchbot.py
new file mode 100644
index 00000000..131c50ef
--- /dev/null
+++ b/gently/hardware/switchbot.py
@@ -0,0 +1,176 @@
+"""
+SwitchBot Bot (WoHand) control as a Bluesky/Ophyd-protocol device.
+
+The SwitchBot Bot is a Bluetooth-LE button pusher. In "Switch mode" it supports
+explicit on/off; in "Press mode" it does a momentary press. This module talks to
+it directly over BLE via ``bleak`` using the documented GATT command protocol —
+no SwitchBot cloud, no hub.
+
+The device follows the same duck-typed Bluesky protocol as the diSPIM devices
+(see ``gently.hardware.dispim.devices.optical.DiSPIMLED``): ``set(state)`` returns
+an ophyd ``Status``, plus ``read()``/``describe()``. So it drops into plans via
+``yield from bps.mv(bot, 'on')``.
+
+BLE I/O is async (``bleak``); ``set()`` runs a fresh connect→write→disconnect
+cycle in a worker thread and resolves the Status when done. Connecting per command
+keeps the implementation robust (no stale-connection handling) at the cost of
+~1-2 s latency, which is fine for a low-frequency accessory. For lower latency or
+encrypted/password-protected Bots, swap the ``_send_command`` body for PySwitchbot.
+
+Self-test (drives a real Bot)::
+
+    python gently/hardware/switchbot.py EC:6F:04:06:5B:23 on off
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+import threading
+import time
+from collections import OrderedDict
+
+logger = logging.getLogger(__name__)
+
+# SwitchBot Bot GATT. Note the UUID group is 9fb8 — the widely-copied 9fb9 is wrong.
+_CTRL_CHAR = "cba20002-224d-11e6-9fb8-0002a5d5c51b"    # write / write-without-response
+_NOTIFY_CHAR = "cba20003-224d-11e6-9fb8-0002a5d5c51b"  # notify (command response)
+
+_COMMANDS = {
+    "on":    bytes([0x57, 0x01, 0x01]),
+    "off":   bytes([0x57, 0x01, 0x02]),
+    "press": bytes([0x57, 0x01, 0x00]),
+}
+_RESP_OK = 0x01  # first byte of the response notification on success
+
+
+class SwitchBotError(RuntimeError):
+    """BLE I/O failed, timed out, or the Bot reported a non-OK response."""
+
+
+async def _send_command(address: str, command: bytes, timeout: float) -> bytes:
+    """Connect, send one command, await the response notification, disconnect.
+
+    Returns the raw response bytes; raises SwitchBotError on timeout or non-OK.
+    """
+    from bleak import BleakClient  # lazy import keeps module import cheap
+
+    response: dict[str, bytes] = {}
+    got = asyncio.Event()
+
+    def _on_notify(_char, data: bytearray) -> None:
+        response["data"] = bytes(data)
+        got.set()
+
+    async with BleakClient(address, timeout=timeout) as client:
+        await client.start_notify(_NOTIFY_CHAR, _on_notify)
+        await client.write_gatt_char(_CTRL_CHAR, command, response=True)
+        try:
+            await asyncio.wait_for(got.wait(), timeout=timeout)
+        except asyncio.TimeoutError as exc:
+            raise SwitchBotError("no response notification from SwitchBot") from exc
+        finally:
+            try:
+                await client.stop_notify(_NOTIFY_CHAR)
+            except Exception:  # disconnect cleanup is best-effort
+                pass
+
+    data = response["data"]
+    if not data or data[0] != _RESP_OK:
+        raise SwitchBotError(f"SwitchBot returned non-OK response: {data.hex()}")
+    return data
+
+
+class SwitchBot:
+    """Bluesky-protocol device for a SwitchBot Bot button pusher.
+
+    Parameters
+    ----------
+    address : str
+        BLE MAC address, e.g. "EC:6F:04:06:5B:23".
+    name : str
+        Device name used as the key in plans and read() output.
+    timeout : float
+        Per-command BLE connect/response timeout in seconds.
+
+    Valid states for ``set``: 'on', 'off', 'press'.
+    """
+
+    def __init__(self, address: str, name: str = "switchbot", *, timeout: float = 20.0):
+        self.address = address
+        self.name = name
+        self.timeout = timeout
+        self.parent = None              # required for Bluesky bps.mv()
+        self._state = "unknown"         # last commanded on/off state
+        self._lock = threading.Lock()   # serialize BLE access (one radio, one bot)
+
+    # -- Bluesky settable protocol -------------------------------------------
+    def set(self, state: str):
+        """Send on/off/press. Returns an ophyd Status that finishes when done."""
+        from ophyd.status import Status
+
+        state = str(state).lower()
+        if state not in _COMMANDS:
+            raise ValueError(f"state {state!r} not in {list(_COMMANDS)}")
+
+        status = Status(obj=self, timeout=self.timeout + 5)
+
+        def worker():
+            with self._lock:
+                try:
+                    data = asyncio.run(
+                        _send_command(self.address, _COMMANDS[state], self.timeout)
+                    )
+                except Exception as exc:
+                    logger.warning("SwitchBot %s set(%s) failed: %s", self.name, state, exc)
+                    status.set_exception(exc)
+                    return
+            if state in ("on", "off"):
+                self._state = state
+            logger.info("SwitchBot %s -> %s (resp %s)", self.name, state, data.hex())
+            status.set_finished()
+
+        threading.Thread(target=worker, name=f"{self.name}-set", daemon=True).start()
+        return status
+
+    # -- Bluesky readable protocol -------------------------------------------
+    def read(self):
+        return OrderedDict({
+            self.name: {"value": self._state, "timestamp": time.time()}
+        })
+
+    def describe(self):
+        return OrderedDict({
+            self.name: {"source": f"switchbot:{self.address}", "dtype": "string", "shape": []}
+        })
+
+    def read_configuration(self):
+        return OrderedDict()
+
+    def describe_configuration(self):
+        return OrderedDict()
+
+
+if __name__ == "__main__":
+    # Standalone self-test, e.g.:  python gently/hardware/switchbot.py AA:BB:.. on off
+    import sys
+
+    address = "EC:6F:04:06:5B:23"
+    cmds = []
+    for arg in sys.argv[1:]:
+        if ":" in arg and len(arg) >= 17:  # looks like a MAC address
+            address = arg
+        else:
+            cmds.append(arg.lower())
+    cmds = cmds or ["on", "off"]
+
+    logging.basicConfig(level=logging.INFO, format="%(message)s")
+    bot = SwitchBot(address)
+    print(f"SwitchBot {address} — sequence: {cmds}\n")
+    for i, cmd in enumerate(cmds):
+        print(f"set({cmd!r}) ...")
+        st = bot.set(cmd)
+        st.wait(30)  # blocks; raises if the command failed
+        print(f"  done; read() -> {bot.read()[bot.name]['value']}")
+        if i != len(cmds) - 1:
+            time.sleep(1.5)
+    print("\nOK")
diff --git a/requirements_device.txt b/requirements_device.txt
index 71612cf6..bbcc5fdd 100644
--- a/requirements_device.txt
+++ b/requirements_device.txt
@@ -22,3 +22,6 @@ pyyaml>=6.0
 # SAM embryo detection (optional, needs CUDA GPU)
 # torch>=2.0.0
 # segment-anything
+
+# BLE accessory control (SwitchBot Bot — diSPIM room light)
+bleak>=0.21.0

From d42ac6b7e1681f0163b16d73da7d21f770171e8f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 13:18:10 -0400
Subject: [PATCH 014/314] temperature: ACUITYnano thermal controller device
 (serial/MQTT/mock)

Bluesky/ophyd-protocol device for the ACUITYnano Peltier controller.
set(target) blocks until "[ SYSTEM LOCKED ]"; read() reports water temp,
setpoint, state. Serial + MQTT transports plus a mock backend for
hardware-free testing. Deps in requirements_device.txt.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 5f7912e5ecda9dd154bda147e782b519ac814d56)
---
 gently/hardware/temperature.py | 242 +++++++++++++++++++++++++++++++++
 requirements_device.txt        |   4 +
 2 files changed, 246 insertions(+)
 create mode 100644 gently/hardware/temperature.py

diff --git a/gently/hardware/temperature.py b/gently/hardware/temperature.py
new file mode 100644
index 00000000..526d576d
--- /dev/null
+++ b/gently/hardware/temperature.py
@@ -0,0 +1,242 @@
+"""
+ACUITYnano Precision Thermal Controller as a Bluesky/Ophyd-protocol device.
+
+Wraps the vendor SDK — a Peltier/TEC water-cooled controller, 0.0-99.9 C. Two
+transports expose the same core API:
+  - USB serial : acuitynano_precision_thermalizer_serial  (vendor-recommended
+                 for closed-loop automation; zero-latency)
+  - MQTT       : acuitynano_precision_thermalizer_api      (multi-client; adds
+                 get_peltier_temp())
+
+The device follows the same duck-typed Bluesky protocol as the diSPIM devices
+(see gently.hardware.dispim.devices.optical.DiSPIMLED). A temperature controller
+is the textbook bluesky "settable that completes on stabilization":
+
+    yield from bps.mv(temperature, 20.0)   # blocks until the controller LOCKS
+
+set(target) commands the setpoint, enables the TEC, and returns an ophyd Status
+that finishes only when the controller reports "[ SYSTEM LOCKED ]" (or raises on
+timeout). read() reports the live water temperature (plus setpoint / state, and
+peltier temp when the transport provides it). BLE-style work runs in a worker
+thread so the Status integrates with the RunEngine.
+
+NOTE: the vendor `acuitynano_precision_thermalizer_*` packages are NOT on PyPI —
+install them on the device-layer machine. Local logic can be exercised with the
+built-in mock backend: `python gently/hardware/temperature.py --mock 20`.
+"""
+from __future__ import annotations
+
+import logging
+import threading
+import time
+from collections import OrderedDict
+
+logger = logging.getLogger(__name__)
+
+TEMP_MIN_C = 0.0
+TEMP_MAX_C = 99.9
+
+
+def _make_backend(cfg: dict):
+    """Construct the vendor SDK transport from a config mapping."""
+    backend = str(cfg.get("backend", "serial")).lower()
+    if backend == "mock":
+        return _MockBackend()
+    if backend == "serial":
+        from acuitynano_precision_thermalizer_serial import AcuityNanoPrecisionThermalizerSerial
+        return AcuityNanoPrecisionThermalizerSerial(
+            cfg["com_port"], baud_rate=cfg.get("baud_rate", 115200)
+        )
+    if backend == "mqtt":
+        from acuitynano_precision_thermalizer_api import AcuityNanoPrecisionThermalizerAPI
+        # The vendor package ships with an embedded HiveMQ Cloud broker + creds,
+        # so MQTT can run with no config. Pass only the keys actually provided,
+        # to override those embedded defaults (and keep secrets in config, not code).
+        kwargs = {k: cfg[k] for k in ("broker", "port", "user", "password") if k in cfg}
+        return AcuityNanoPrecisionThermalizerAPI(**kwargs)
+    raise ValueError(f"unknown temperature backend {backend!r} (use 'serial', 'mqtt', or 'mock')")
+
+
+def create_temperature_controller(cfg: dict) -> "TemperatureController":
+    """Factory used by the device layer: build transport + wrap as a device."""
+    backend = _make_backend(cfg)
+    if "feedback_peltier" in cfg and hasattr(backend, "set_feedback_sensor"):
+        backend.set_feedback_sensor(use_peltier=bool(cfg["feedback_peltier"]))
+    return TemperatureController(
+        backend,
+        name=cfg.get("name", "temperature"),
+        stabilize_timeout=cfg.get("stabilize_timeout", 600.0),
+    )
+
+
+class TemperatureController:
+    """Bluesky-protocol device for the ACUITYnano thermal controller.
+
+    Parameters
+    ----------
+    backend : object
+        Vendor SDK instance exposing set_temperature / get_water_temp /
+        get_system_state / enable_tec / wait_for_target.
+    name : str
+        Device name; the registry key and primary read() field.
+    stabilize_timeout : float
+        Seconds to wait for "[ SYSTEM LOCKED ]" before set() fails.
+    """
+
+    def __init__(self, backend, name: str = "temperature", *, stabilize_timeout: float = 600.0):
+        self._dev = backend
+        self.name = name
+        self.stabilize_timeout = float(stabilize_timeout)
+        self.parent = None            # required for Bluesky bps.mv()
+        self._setpoint = None         # last commanded target
+        self._lock = threading.Lock()
+
+    # -- Bluesky settable protocol -------------------------------------------
+    def set(self, target_c):
+        """Command setpoint + enable TEC; Status finishes when the system locks."""
+        from ophyd.status import Status
+
+        target = float(target_c)
+        if not (TEMP_MIN_C <= target <= TEMP_MAX_C):
+            raise ValueError(f"target {target} C outside [{TEMP_MIN_C}, {TEMP_MAX_C}]")
+
+        status = Status(obj=self, timeout=self.stabilize_timeout + 30)
+
+        def worker():
+            with self._lock:
+                try:
+                    self._dev.set_temperature(target)   # vendor also validates range
+                    self._dev.enable_tec(True)
+                    locked = self._dev.wait_for_target(timeout_seconds=self.stabilize_timeout)
+                except Exception as exc:
+                    logger.warning("temperature %s set(%.2f) failed: %s", self.name, target, exc)
+                    status.set_exception(exc)
+                    return
+                self._setpoint = target
+            if locked:
+                logger.info("temperature %s locked at %.2f C", self.name, target)
+                status.set_finished()
+            else:
+                status.set_exception(TimeoutError(
+                    f"{self.name} did not stabilize at {target} C within {self.stabilize_timeout}s"
+                ))
+
+        threading.Thread(target=worker, name=f"{self.name}-set", daemon=True).start()
+        return status
+
+    # -- Explicit controls (outside the bps.mv() path) -----------------------
+    def enable(self, on: bool = True):
+        self._dev.enable_tec(bool(on))
+
+    def setpoint(self, target_c):
+        """Command the setpoint without blocking for stabilization."""
+        self._dev.set_temperature(float(target_c))
+
+    # -- Bluesky readable protocol -------------------------------------------
+    def read(self):
+        now = time.time()
+        data = OrderedDict()
+        data[self.name] = {"value": self._safe(self._dev.get_water_temp), "timestamp": now}
+        data[f"{self.name}_setpoint"] = {"value": self._setpoint, "timestamp": now}
+        data[f"{self.name}_state"] = {
+            "value": self._safe(self._dev.get_system_state, default="unknown"), "timestamp": now
+        }
+        if self._has_peltier():
+            data[f"{self.name}_peltier"] = {"value": self._safe(self._dev.get_peltier_temp), "timestamp": now}
+        return data
+
+    def describe(self):
+        src = f"acuitynano:{self.name}"
+        d = OrderedDict()
+        d[self.name] = {"source": src, "dtype": "number", "shape": []}
+        d[f"{self.name}_setpoint"] = {"source": src, "dtype": "number", "shape": []}
+        d[f"{self.name}_state"] = {"source": src, "dtype": "string", "shape": []}
+        if self._has_peltier():
+            d[f"{self.name}_peltier"] = {"source": src, "dtype": "number", "shape": []}
+        return d
+
+    def read_configuration(self):
+        return OrderedDict()
+
+    def describe_configuration(self):
+        return OrderedDict()
+
+    def close(self):
+        """Release the transport (serial port / MQTT client) on shutdown."""
+        for method in ("close", "disconnect"):
+            fn = getattr(self._dev, method, None)
+            if fn is not None:
+                try:
+                    fn()
+                except Exception:
+                    pass
+                return
+
+    # -- helpers --------------------------------------------------------------
+    def _has_peltier(self) -> bool:
+        return getattr(self._dev, "get_peltier_temp", None) is not None
+
+    @staticmethod
+    def _safe(fn, default=None):
+        try:
+            return fn()
+        except Exception:
+            return default
+
+
+class _MockBackend:
+    """In-memory fake mirroring the vendor API, for local testing without hardware."""
+
+    def __init__(self, *args, **kwargs):
+        self._target = 25.0
+        self._enabled = False
+
+    def set_temperature(self, t):
+        if not (TEMP_MIN_C <= float(t) <= TEMP_MAX_C):
+            raise ValueError("Target must be between 0.0 and 99.9 C")
+        self._target = float(t)
+
+    def enable_tec(self, on):
+        self._enabled = bool(on)
+
+    def set_feedback_sensor(self, use_peltier=False):
+        pass
+
+    def wait_for_target(self, timeout_seconds=300):
+        time.sleep(0.5)  # pretend to ramp + settle
+        return True
+
+    def get_water_temp(self):
+        return self._target
+
+    def get_peltier_temp(self):
+        return self._target - 1.0
+
+    def get_system_state(self):
+        return "[ SYSTEM LOCKED ]" if self._enabled else "[ IDLE ]"
+
+    def close(self):
+        pass
+
+
+if __name__ == "__main__":
+    import sys
+
+    logging.basicConfig(level=logging.INFO, format="%(message)s")
+    if "--mock" in sys.argv:
+        target = 20.0
+        for arg in sys.argv[1:]:
+            try:
+                target = float(arg)
+                break
+            except ValueError:
+                continue
+        dev = TemperatureController(_MockBackend(), name="temperature", stabilize_timeout=10)
+        print(f"[mock] set({target}) — blocks until locked ...")
+        st = dev.set(target)
+        st.wait(15)
+        print("[mock] read ->", {k: v["value"] for k, v in dev.read().items()})
+        print("OK")
+    else:
+        print("Real-hardware self-test needs the vendor SDK + a controller. "
+              "Run with --mock to exercise the device logic locally.")
diff --git a/requirements_device.txt b/requirements_device.txt
index bbcc5fdd..26b10dab 100644
--- a/requirements_device.txt
+++ b/requirements_device.txt
@@ -25,3 +25,7 @@ pyyaml>=6.0
 
 # BLE accessory control (SwitchBot Bot — diSPIM room light)
 bleak>=0.21.0
+
+# ACUITYnano thermal controller transports
+pyserial>=3.5
+paho-mqtt>=1.6.0

From 32a8ad28be00c765f2b5ea4bcfa3df7b9c667f99 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 13:18:10 -0400
Subject: [PATCH 015/314] device_layer: register switchbot + temperature;
 expose temperature to the agent

Config-gated registration of the SwitchBot and ACUITYnano devices alongside
the MMCore devices. Adds /api/temperature/{set,status} REST endpoints +
client methods, and set_temperature/get_temperature agent tools so the agent
can hold or shift sample temperature (C. elegans development rate).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(cherry picked from commit 249ae4ac0752ea419e9dd430423ab7db936efeed)
---
 gently/app/tools/__init__.py           |   1 +
 gently/app/tools/temperature_tools.py  |  75 ++++++++++++++++++
 gently/hardware/dispim/client.py       |   9 +++
 gently/hardware/dispim/device_layer.py | 103 +++++++++++++++++++++++++
 4 files changed, 188 insertions(+)
 create mode 100644 gently/app/tools/temperature_tools.py

diff --git a/gently/app/tools/__init__.py b/gently/app/tools/__init__.py
index 765b3d33..4dd1b776 100644
--- a/gently/app/tools/__init__.py
+++ b/gently/app/tools/__init__.py
@@ -10,6 +10,7 @@
 from . import stage_tools
 from . import led_tools
 from . import light_source_tools
+from . import temperature_tools
 from . import calibration_tools
 from . import acquisition_tools
 from . import volume_tools
diff --git a/gently/app/tools/temperature_tools.py b/gently/app/tools/temperature_tools.py
new file mode 100644
index 00000000..43ff8ab0
--- /dev/null
+++ b/gently/app/tools/temperature_tools.py
@@ -0,0 +1,75 @@
+"""
+Temperature Control Tools
+
+Agent tools for the ACUITYnano thermal controller. Temperature drives C. elegans
+development rate, so these let the agent hold or shift the sample temperature as
+part of closed-loop experiments.
+"""
+from typing import Dict
+
+from gently.harness.tools.registry import tool, ToolCategory, ToolExample
+
+
+@tool(
+    name="set_temperature",
+    description=(
+        "Set the sample temperature setpoint in Celsius (0.0-99.9). The thermal "
+        "controller ramps toward the target and this returns immediately — poll "
+        "get_temperature until the state reads '[ SYSTEM LOCKED ]' before imaging. "
+        "Temperature controls C. elegans development rate (~15 C slow, 20 C standard, "
+        "25 C fast)."
+    ),
+    category=ToolCategory.HARDWARE,
+    requires_microscope=True,
+    examples=[
+        ToolExample("Hold the sample at 20 degrees", {"target_c": 20.0}),
+        ToolExample("Warm the embryos to 25 C to speed development", {"target_c": 25.0}),
+    ],
+)
+async def set_temperature(target_c: float, context: Dict) -> str:
+    """Command the thermal controller to a target temperature.
+
+    Parameters
+    ----------
+    target_c : float
+        Target temperature in degrees Celsius (0.0-99.9).
+    """
+    client = context.get('client')
+    try:
+        result = await client.set_temperature(target_c)
+        if result.get('success'):
+            return (f"Commanded {target_c} C. Currently {result.get('temperature_c')} C, "
+                    f"state {result.get('state')!r}. Ramping — call get_temperature to confirm lock.")
+        return f"Error setting temperature: {result.get('error', 'unknown error')}"
+    except Exception as e:
+        return f"Error setting temperature: {e}"
+
+
+@tool(
+    name="get_temperature",
+    description=(
+        "Read the current sample temperature, target setpoint, and lock state from the "
+        "thermal controller. Use to confirm the sample has stabilized at the setpoint "
+        "('[ SYSTEM LOCKED ]') before acquiring."
+    ),
+    category=ToolCategory.HARDWARE,
+    requires_microscope=True,
+    examples=[
+        ToolExample("What's the current temperature?"),
+        ToolExample("Has the sample reached temperature yet?"),
+    ],
+)
+async def get_temperature(context: Dict) -> str:
+    """Read current temperature, setpoint, and lock state."""
+    client = context.get('client')
+    try:
+        r = await client.get_temperature()
+        if r.get('success'):
+            msg = (f"Temperature {r.get('temperature_c')} C "
+                   f"(setpoint {r.get('setpoint_c')} C, state {r.get('state')!r}")
+            if r.get('peltier_c') is not None:
+                msg += f", peltier {r.get('peltier_c')} C"
+            return msg + ")"
+        return f"Error reading temperature: {r.get('error', 'unknown error')}"
+    except Exception as e:
+        return f"Error reading temperature: {e}"
diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 6f097670..03ff8009 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -802,6 +802,15 @@ async def get_led_status(self) -> Dict:
         """Get current LED status."""
         return await self._api_get('/api/led/status')
 
+    async def set_temperature(self, target_c: float) -> Dict:
+        """Command the thermal-controller setpoint (Celsius). Non-blocking — the
+        controller ramps; poll get_temperature() for the lock state."""
+        return await self._api_post('/api/temperature/set', {'target_c': target_c})
+
+    async def get_temperature(self) -> Dict:
+        """Get current temperature, setpoint, and lock state."""
+        return await self._api_get('/api/temperature/status')
+
     # ------------------------------------------------------------------
     # Live device-state readout (streamed from the device layer poller)
     # ------------------------------------------------------------------
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 48e19746..a1af5e4a 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -237,6 +237,39 @@ async def initialize(self):
         for name in self.devices:
             logger.debug("  - %s", name)
 
+        # Optional BLE accessory: SwitchBot Bot. It's a Bluetooth device, not a
+        # Micro-Manager adapter, so it's created here (independently of MMCore)
+        # and added to the same registry. Plans address it by name, e.g.
+        # bps.mv(switchbot, 'on'). Config-gated: no `switchbot:` section => no-op.
+        sb_cfg = self.config.get('switchbot')
+        if sb_cfg:
+            try:
+                from gently.hardware.switchbot import SwitchBot
+                sb_name = sb_cfg.get('name', 'switchbot')
+                self.devices[sb_name] = SwitchBot(
+                    address=sb_cfg['address'],
+                    name=sb_name,
+                    timeout=sb_cfg.get('timeout', 20.0),
+                )
+                logger.info("Created SwitchBot '%s' at %s", sb_name, sb_cfg['address'])
+            except Exception as exc:
+                logger.warning("Could not create SwitchBot: %s", exc)
+
+        # Optional temperature controller (ACUITYnano). Like the SwitchBot it's
+        # not an MMCore adapter — created here from config and added to the same
+        # registry. Plans block on it via bps.mv(temperature, 20.0) until the
+        # controller reports SYSTEM LOCKED. Config-gated: no `temperature:` => no-op.
+        temp_cfg = self.config.get('temperature')
+        if temp_cfg:
+            try:
+                from gently.hardware.temperature import create_temperature_controller
+                tc = create_temperature_controller(temp_cfg)
+                self.devices[tc.name] = tc
+                logger.info("Created temperature controller '%s' (backend=%s)",
+                            tc.name, temp_cfg.get('backend', 'serial'))
+            except Exception as exc:
+                logger.warning("Could not create temperature controller: %s", exc)
+
         # Push XY safety bounds down to the ASI Tiger firmware so the joystick
         # can't drive past Layer-1 software limits. The XY_STAGE_*_UM constants
         # in devices/stage.py are the single source of truth — both the
@@ -1294,6 +1327,74 @@ async def handle_set_led(self, request):
                 'traceback': traceback.format_exc()
             }, status=500)
 
+    async def handle_get_temperature_status(self, request):
+        """GET /api/temperature/status - current temperature, setpoint, lock state."""
+        try:
+            temp = self.devices.get('temperature')
+            if temp is None:
+                return web.json_response({'success': False, 'error': 'temperature device not found'})
+            r = temp.read()
+            return web.json_response({
+                'success': True,
+                'temperature_c': r.get(temp.name, {}).get('value'),
+                'setpoint_c': r.get(f'{temp.name}_setpoint', {}).get('value'),
+                'state': r.get(f'{temp.name}_state', {}).get('value'),
+                'peltier_c': r.get(f'{temp.name}_peltier', {}).get('value'),
+            })
+        except Exception as e:
+            import traceback
+            return web.json_response({'success': False, 'error': str(e),
+                                      'traceback': traceback.format_exc()}, status=500)
+
+    async def handle_set_temperature(self, request):
+        """POST /api/temperature/set - command setpoint. Body: {target_c, wait?}.
+
+        Non-blocking by default (controller ramps; poll status). wait=true blocks
+        until SYSTEM LOCKED or the device's stabilize timeout.
+        """
+        try:
+            data = await request.json()
+            target = float(data.get('target_c'))
+            wait = bool(data.get('wait', False))
+            if not (0.0 <= target <= 99.9):
+                return web.json_response({'success': False,
+                                          'error': f'target {target} outside [0.0, 99.9]'})
+            temp = self.devices.get('temperature')
+            if temp is None:
+                return web.json_response({'success': False, 'error': 'temperature device not found'})
+
+            if not wait:
+                temp.enable(True)
+                temp.setpoint(target)
+                r = temp.read()
+                return web.json_response({
+                    'success': True, 'target_c': target, 'waited': False,
+                    'message': f'commanded {target} C (ramping)',
+                    'temperature_c': r.get(temp.name, {}).get('value'),
+                    'state': r.get(f'{temp.name}_state', {}).get('value'),
+                })
+
+            import time
+            status = temp.set(target)
+            timeout = float(getattr(temp, 'stabilize_timeout', 600.0)) + 10
+            start = time.time()
+            while not status.done and (time.time() - start) < timeout:
+                await asyncio.sleep(0.5)
+            r = temp.read()
+            if status.done and status.success:
+                return web.json_response({
+                    'success': True, 'target_c': target, 'waited': True,
+                    'message': f'locked at {target} C',
+                    'temperature_c': r.get(temp.name, {}).get('value'),
+                    'state': r.get(f'{temp.name}_state', {}).get('value'),
+                })
+            return web.json_response({'success': False, 'target_c': target,
+                                      'error': f'did not stabilize at {target} C within {timeout:.0f}s'})
+        except Exception as e:
+            import traceback
+            return web.json_response({'success': False, 'error': str(e),
+                                      'traceback': traceback.format_exc()}, status=500)
+
     async def handle_set_camera_led_mode(self, request):
         """POST /api/camera/led_mode - Enable/disable automatic LED for bottom camera"""
         try:
@@ -2236,6 +2337,8 @@ async def on_start(self):
         self._app.router.add_get('/api/plans', self.handle_get_plans)
         self._app.router.add_get('/api/led/status', self.handle_get_led_status)
         self._app.router.add_post('/api/led/set', self.handle_set_led)
+        self._app.router.add_get('/api/temperature/status', self.handle_get_temperature_status)
+        self._app.router.add_post('/api/temperature/set', self.handle_set_temperature)
         self._app.router.add_post('/api/camera/led_mode', self.handle_set_camera_led_mode)
         self._app.router.add_post('/api/camera/exposure', self.handle_set_camera_exposure)
         self._app.router.add_get('/api/camera/exposure', self.handle_get_camera_exposure)

From 3c7bfc79a8d2f51baa86607fcbd001342c74ddfc Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 14:28:59 -0400
Subject: [PATCH 016/314] =?UTF-8?q?events:=20EMBRYO=5FTERMINATED=20?=
 =?UTF-8?q?=E2=80=94=20orchestrator=20emits,=20UI=20tracker=20handles?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

New EventType.EMBRYO_TERMINATED fires whenever an embryo's imaging
stops for any reason (no_object terminal, configured stop condition,
errors, user removal). The orchestrator emits it from both the
no_object terminal path and the per-condition stop check.
TimelapseStateTracker handles it by marking the embryo complete and
carrying the completion_reason through for the UI.

Single source of truth for "an embryo has stopped" — downstream
listeners (filmstrip terminated badge, summary stats) now have one
event to subscribe to instead of polling embryo state.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 gently/app/orchestration/timelapse.py | 10 ++++++++++
 gently/core/event_bus.py              |  1 +
 gently/ui/web/timelapse_tracker.py    | 12 ++++++++++++
 3 files changed, 23 insertions(+)

diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index 28ae86b8..d35768f1 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -900,6 +900,11 @@ async def _check_stop_condition(self, embryo_state: EmbryoState):
                 f"likely hatched / out of FOV)"
             )
             logger.info(f"Embryo {embryo_state.id} stopped: {embryo_state.completion_reason}")
+            self._emit_event(EventType.EMBRYO_TERMINATED, {
+                "embryo_id": embryo_state.id,
+                "completion_reason": embryo_state.completion_reason,
+                "timepoints_acquired": embryo_state.timepoints_acquired,
+            })
             return
 
         # Check all conditions (primary + additional) with OR logic
@@ -909,6 +914,11 @@ async def _check_stop_condition(self, embryo_state: EmbryoState):
                 embryo_state.is_complete = True
                 embryo_state.completion_reason = reason
                 logger.info(f"Embryo {embryo_state.id} stopped: {reason}")
+                self._emit_event(EventType.EMBRYO_TERMINATED, {
+                    "embryo_id": embryo_state.id,
+                    "completion_reason": reason,
+                    "timepoints_acquired": embryo_state.timepoints_acquired,
+                })
                 return  # Stop on first matching condition
 
     def _evaluate_single_condition(
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index d5495976..da10b19e 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -44,6 +44,7 @@ class EventType(Enum):
     EMBRYO_CENTERED = auto()
     EMBRYO_CALIBRATED = auto()
     EMBRYO_SKIPPED = auto()
+    EMBRYO_TERMINATED = auto()  # {embryo_id, completion_reason} - emitted when an embryo's imaging stops (any reason: no_object terminal, stop condition met, errors, user removal)
 
     # Analysis events
     ANALYSIS_STARTED = auto()
diff --git a/gently/ui/web/timelapse_tracker.py b/gently/ui/web/timelapse_tracker.py
index b57086f9..665ef1b7 100644
--- a/gently/ui/web/timelapse_tracker.py
+++ b/gently/ui/web/timelapse_tracker.py
@@ -128,6 +128,18 @@ def handle_event(self, event_type: str, data: dict):
             self.status = "STOPPED"
             # Don't mark embryos as complete - they were stopped, not finished
 
+        elif event_type == "EMBRYO_TERMINATED":
+            # A single embryo's imaging was halted by the orchestrator
+            # (no_object terminal, configured stop condition, errors, etc).
+            # Carry the completion_reason through so the UI can show why.
+            eid = data.get("embryo_id")
+            if eid and eid in self.embryos:
+                self.embryos[eid]["is_complete"] = True
+                self.embryos[eid]["completion_reason"] = data.get("completion_reason")
+                self.embryos[eid].setdefault(
+                    "completed_at", datetime.now().isoformat()
+                )
+
         elif event_type == "DETECTOR_EVALUATED":
             # All detector/perception evaluations (with reasoning) - populates reasoning panel
             eid = data.get("embryo_id")

From a7250edaa5d0f0337c455b05d50cd663f262f234 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 14:29:50 -0400
Subject: [PATCH 017/314] Calibration: SPIM thumb expands into a floating
 popout for a larger live view
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The compact SPIM thumb in the metrics strip is now a button. Click
opens a draggable, fixed-position popout (~560×480) that mirrors the
same live frame stream with bigger imagery, the embryo label, and a
close affordance. Hover/focus on the thumb shows a ⤢ chip hinting
the interaction; the chip is hidden until a frame actually arrives.

The popout reuses SpimLivePreview's apply-on-render plumbing so no
new stream is opened — same data path, second render target. Keeps
the calibration profile compact by default while letting the
operator pull a properly-sized view when they need to read fine
structure.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css  | 194 ++++++++++++++++++++-
 gently/ui/web/static/js/gallery.js | 269 +++++++++++++++++++++++++++--
 2 files changed, 445 insertions(+), 18 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index c0a6c539..4772dad7 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -1482,12 +1482,200 @@ a.tab-link.active {
     background: #000;
     border-radius: 3px;
     border: 1px solid var(--border);
-    display: none;  /* shown when frame arrives via .has-frame */
-    opacity: 1;
+    display: inline-block;
+    opacity: 0.35;  /* dim until a real frame arrives (.has-frame) */
 }
 
 .cal-spim-thumb.has-frame {
-    display: inline-block;
+    opacity: 1;
+}
+
+/* Thumb wrapped in a button so click pops out a larger live view.
+   Sized to match the thumb so it remains clickable even before the
+   first frame arrives. */
+.cal-spim-thumb-btn {
+    position: relative;
+    padding: 0;
+    background: none;
+    border: 0;
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    line-height: 0;
+    color: inherit;
+    width: 96px;
+    height: 72px;
+}
+
+.cal-spim-thumb-btn:focus-visible {
+    outline: 2px solid var(--accent, #4f8cff);
+    outline-offset: 2px;
+    border-radius: 4px;
+}
+
+.cal-spim-expand-icon {
+    position: absolute;
+    top: 2px;
+    right: 2px;
+    background: rgba(0, 0, 0, 0.55);
+    color: #fff;
+    font-size: 11px;
+    line-height: 1;
+    padding: 2px 4px;
+    border-radius: 3px;
+    opacity: 0;
+    transition: opacity 0.12s ease;
+    pointer-events: none;
+}
+
+.cal-spim-thumb-btn:hover .cal-spim-expand-icon,
+.cal-spim-thumb-btn:focus-visible .cal-spim-expand-icon {
+    opacity: 1;
+}
+
+/* Hide the expand chip when the thumb has no frame yet — nothing to expand. */
+.cal-spim-thumb-btn:has(.cal-spim-thumb:not(.has-frame)) .cal-spim-expand-icon {
+    display: none;
+}
+
+/* ---------- Floating SPIM popout ---------- */
+.cal-spim-popout {
+    position: fixed;
+    top: 80px;
+    right: 24px;
+    width: 560px;
+    height: 480px;
+    min-width: 320px;
+    min-height: 260px;
+    z-index: 9000;
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    box-shadow: 0 16px 40px rgba(0, 0, 0, 0.45),
+                0 2px 8px rgba(0, 0, 0, 0.25);
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    resize: both;
+}
+
+.cal-spim-popout[hidden] {
+    display: none;
+}
+
+.cal-spim-popout.dragging {
+    user-select: none;
+    cursor: grabbing;
+}
+
+.cal-spim-popout-header {
+    flex: 0 0 auto;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 8px 12px;
+    background: var(--bg-elevated, var(--bg-card));
+    border-bottom: 1px solid var(--border);
+    cursor: grab;
+    touch-action: none;
+}
+
+.cal-spim-popout.dragging .cal-spim-popout-header {
+    cursor: grabbing;
+}
+
+.cal-spim-popout-led {
+    width: 8px;
+    height: 8px;
+    border-radius: 50%;
+    background: #4ade80;
+    box-shadow: 0 0 6px rgba(74, 222, 128, 0.7);
+    animation: cal-spim-led-blink 1.6s ease-in-out infinite;
+}
+
+.cal-spim-popout-led.idle {
+    background: var(--text-muted, #666);
+    box-shadow: none;
+    animation: none;
+}
+
+.cal-spim-popout-title {
+    font-size: 11px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.6px;
+    color: var(--text);
+}
+
+.cal-spim-popout-embryo {
+    font-family: 'JetBrains Mono', ui-monospace, monospace;
+    font-size: 11px;
+    color: var(--text-muted);
+}
+
+.cal-spim-popout-spacer {
+    flex: 1;
+}
+
+.cal-spim-popout-close {
+    background: transparent;
+    border: 0;
+    color: var(--text-muted);
+    font-size: 20px;
+    line-height: 1;
+    padding: 0 6px;
+    cursor: pointer;
+    border-radius: 4px;
+}
+
+.cal-spim-popout-close:hover {
+    color: var(--text);
+    background: var(--border);
+}
+
+.cal-spim-popout-body {
+    flex: 1;
+    min-height: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: #000;
+    overflow: hidden;
+    padding: 4px;
+}
+
+.cal-spim-popout-img {
+    max-width: 100%;
+    max-height: 100%;
+    object-fit: contain;
+    display: none;
+}
+
+.cal-spim-popout-img.has-frame {
+    display: block;
+}
+
+.cal-spim-popout-placeholder {
+    color: var(--text-muted);
+    font-size: 12px;
+    letter-spacing: 0.4px;
+}
+
+.cal-spim-popout-placeholder[hidden] {
+    display: none;
+}
+
+.cal-spim-popout-footer {
+    flex: 0 0 auto;
+    padding: 6px 12px;
+    border-top: 1px solid var(--border);
+    background: var(--bg-elevated, var(--bg-card));
+    font-family: 'JetBrains Mono', ui-monospace, monospace;
+    font-size: 11px;
+    color: var(--text-muted);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
 }
 
 /* When a live frame is active, let the SPIM cell breathe a bit so the
diff --git a/gently/ui/web/static/js/gallery.js b/gently/ui/web/static/js/gallery.js
index 51ee4207..42159d18 100644
--- a/gently/ui/web/static/js/gallery.js
+++ b/gently/ui/web/static/js/gallery.js
@@ -422,13 +422,19 @@ const CalibrationProfileView = {
 
     /** Compact SPIM live indicator used inside the metrics strip.
      * Carries the same IDs as the old big preview so SpimLivePreview's
-     * apply-on-render logic continues to work unchanged. */
+     * apply-on-render logic continues to work unchanged. The thumb is a
+     * button — click to open the floating popout for a larger view. */
     _renderSpimIndicator() {
         return `
             <div class="cal-spim-indicator" id="cal-spim-preview">
                 <span class="cal-spim-led idle" id="cal-spim-led"></span>
                 <span class="cal-spim-label">SPIM</span>
-                <img class="cal-spim-img cal-spim-thumb" id="cal-spim-img" alt="">
+                <button type="button" class="cal-spim-thumb-btn" id="cal-spim-thumb-btn"
+                        title="Open live SPIM popout"
+                        onclick="SpimPopout.open()">
+                    <img class="cal-spim-img cal-spim-thumb" id="cal-spim-img" alt="">
+                    <span class="cal-spim-expand-icon" aria-hidden="true">⤢</span>
+                </button>
                 <span class="cal-spim-placeholder" id="cal-spim-placeholder" hidden></span>
                 <span class="cal-spim-meta" id="cal-spim-meta">—</span>
             </div>
@@ -1329,21 +1335,33 @@ const SpimLivePreview = {
         const placeholder = document.getElementById('cal-spim-placeholder');
         const metaEl = document.getElementById('cal-spim-meta');
         const led = document.getElementById('cal-spim-led');
-        if (!img) return;  // not in profile view
 
         const latest = embryoId ? this._latestByEmbryo[embryoId] : null;
-        if (latest) {
-            img.src = `data:image/png;base64,${latest.base64_png}`;
-            img.classList.add('has-frame');
-            if (placeholder) placeholder.hidden = true;
-            if (metaEl) metaEl.textContent = this._formatMeta(latest);
-            if (led) led.classList.remove('idle');
-        } else {
-            img.removeAttribute('src');
-            img.classList.remove('has-frame');
-            if (placeholder) placeholder.hidden = false;
-            if (metaEl) metaEl.textContent = '—';
-            if (led) led.classList.add('idle');
+
+        if (img) {
+            if (latest) {
+                img.src = `data:image/png;base64,${latest.base64_png}`;
+                img.classList.add('has-frame');
+                if (placeholder) placeholder.hidden = true;
+                if (metaEl) metaEl.textContent = this._formatMeta(latest);
+                if (led) led.classList.remove('idle');
+            } else {
+                img.removeAttribute('src');
+                img.classList.remove('has-frame');
+                if (placeholder) placeholder.hidden = false;
+                if (metaEl) metaEl.textContent = '—';
+                if (led) led.classList.add('idle');
+            }
+        }
+
+        // Mirror into popout if it's open — the popout lives outside the
+        // calibration panel's innerHTML reset, so we paint it independently.
+        if (typeof SpimPopout !== 'undefined') {
+            SpimPopout.paint(latest ? {
+                base64_png: latest.base64_png,
+                meta: this._formatMeta(latest),
+                embryoId,
+            } : null);
         }
     },
 
@@ -1375,6 +1393,227 @@ const SpimLivePreview = {
 
 document.addEventListener('DOMContentLoaded', () => SpimLivePreview.init());
 
+// ==========================================
+// SPIM live popout (floating draggable window)
+// ==========================================
+// Lazy-built floating window that mirrors SpimLivePreview at a larger
+// size. Draggable via the header bar, resizable from the bottom-right
+// corner. Position and size persist in localStorage so the window
+// re-opens where the operator last left it. Closes on Escape.
+const SpimPopout = {
+    _STORAGE_KEY: 'gently.spimPopout.v1',
+    _root: null,
+    _isOpen: false,
+
+    _ensureBuilt() {
+        if (this._root) return this._root;
+
+        const el = document.createElement('div');
+        el.className = 'cal-spim-popout';
+        el.id = 'cal-spim-popout';
+        el.hidden = true;
+        el.innerHTML = `
+            <div class="cal-spim-popout-header" id="cal-spim-popout-header">
+                <span class="cal-spim-popout-led idle" id="cal-spim-popout-led"></span>
+                <span class="cal-spim-popout-title">SPIM Live</span>
+                <span class="cal-spim-popout-embryo" id="cal-spim-popout-embryo"></span>
+                <span class="cal-spim-popout-spacer"></span>
+                <button type="button" class="cal-spim-popout-close" id="cal-spim-popout-close"
+                        title="Close (Esc)" aria-label="Close popout">×</button>
+            </div>
+            <div class="cal-spim-popout-body">
+                <img class="cal-spim-popout-img" id="cal-spim-popout-img" alt="">
+                <div class="cal-spim-popout-placeholder" id="cal-spim-popout-placeholder">
+                    Awaiting SPIM frame…
+                </div>
+            </div>
+            <div class="cal-spim-popout-footer">
+                <span class="cal-spim-popout-meta" id="cal-spim-popout-meta">—</span>
+            </div>
+        `;
+        document.body.appendChild(el);
+        this._root = el;
+
+        // Restore persisted geometry
+        const saved = this._loadGeometry();
+        if (saved) {
+            el.style.left = `${saved.left}px`;
+            el.style.top = `${saved.top}px`;
+            el.style.width = `${saved.width}px`;
+            el.style.height = `${saved.height}px`;
+        }
+
+        el.querySelector('#cal-spim-popout-close').addEventListener('click', () => this.close());
+        this._wireDrag(el);
+        this._wireResizeObserver(el);
+
+        return el;
+    },
+
+    open() {
+        const el = this._ensureBuilt();
+        if (this._isOpen) return;
+        el.hidden = false;
+        this._isOpen = true;
+
+        // Clamp into viewport in case window was resized while popout was hidden
+        this._clampIntoViewport(el);
+
+        // Paint current frame for the selected embryo
+        const selected = (typeof CalibrationManager !== 'undefined')
+            ? CalibrationManager.selectedEmbryoId : null;
+        if (selected && typeof SpimLivePreview !== 'undefined') {
+            const latest = SpimLivePreview._latestByEmbryo[selected];
+            this.paint(latest ? {
+                base64_png: latest.base64_png,
+                meta: SpimLivePreview._formatMeta(latest),
+                embryoId: selected,
+            } : null);
+        } else {
+            this.paint(null);
+        }
+
+        document.addEventListener('keydown', this._onKey);
+    },
+
+    close() {
+        if (!this._root || !this._isOpen) return;
+        this._root.hidden = true;
+        this._isOpen = false;
+        document.removeEventListener('keydown', this._onKey);
+    },
+
+    toggle() {
+        this._isOpen ? this.close() : this.open();
+    },
+
+    /** Called by SpimLivePreview whenever the current embryo's latest
+     * frame changes. Frame is {base64_png, meta, embryoId} or null. */
+    paint(frame) {
+        if (!this._root || !this._isOpen) return;
+        const img = this._root.querySelector('#cal-spim-popout-img');
+        const placeholder = this._root.querySelector('#cal-spim-popout-placeholder');
+        const meta = this._root.querySelector('#cal-spim-popout-meta');
+        const embryoEl = this._root.querySelector('#cal-spim-popout-embryo');
+        const led = this._root.querySelector('#cal-spim-popout-led');
+
+        if (frame) {
+            img.src = `data:image/png;base64,${frame.base64_png}`;
+            img.classList.add('has-frame');
+            placeholder.hidden = true;
+            meta.textContent = frame.meta || '—';
+            embryoEl.textContent = frame.embryoId || '';
+            led.classList.remove('idle');
+        } else {
+            img.removeAttribute('src');
+            img.classList.remove('has-frame');
+            placeholder.hidden = false;
+            meta.textContent = '—';
+            embryoEl.textContent = '';
+            led.classList.add('idle');
+        }
+    },
+
+    _onKey: (e) => {
+        if (e.key === 'Escape') SpimPopout.close();
+    },
+
+    _wireDrag(el) {
+        const header = el.querySelector('#cal-spim-popout-header');
+        let dragging = false;
+        let startX = 0, startY = 0, startLeft = 0, startTop = 0;
+
+        header.addEventListener('pointerdown', (e) => {
+            // Don't start drag on the close button
+            if (e.target.closest('.cal-spim-popout-close')) return;
+            dragging = true;
+            const rect = el.getBoundingClientRect();
+            startX = e.clientX;
+            startY = e.clientY;
+            startLeft = rect.left;
+            startTop = rect.top;
+            // Switch to absolute positioning if currently default
+            el.style.left = `${startLeft}px`;
+            el.style.top = `${startTop}px`;
+            el.style.right = 'auto';
+            el.style.bottom = 'auto';
+            header.setPointerCapture(e.pointerId);
+            el.classList.add('dragging');
+        });
+
+        header.addEventListener('pointermove', (e) => {
+            if (!dragging) return;
+            const dx = e.clientX - startX;
+            const dy = e.clientY - startY;
+            let nextLeft = startLeft + dx;
+            let nextTop = startTop + dy;
+            // Keep at least 40px of header on-screen
+            const w = el.offsetWidth;
+            const h = el.offsetHeight;
+            nextLeft = Math.max(-(w - 80), Math.min(window.innerWidth - 80, nextLeft));
+            nextTop = Math.max(0, Math.min(window.innerHeight - 40, nextTop));
+            el.style.left = `${nextLeft}px`;
+            el.style.top = `${nextTop}px`;
+        });
+
+        const endDrag = (e) => {
+            if (!dragging) return;
+            dragging = false;
+            el.classList.remove('dragging');
+            try { header.releasePointerCapture(e.pointerId); } catch (_) {}
+            this._saveGeometry(el);
+        };
+        header.addEventListener('pointerup', endDrag);
+        header.addEventListener('pointercancel', endDrag);
+    },
+
+    _wireResizeObserver(el) {
+        if (typeof ResizeObserver === 'undefined') return;
+        let saveTimer = null;
+        const ro = new ResizeObserver(() => {
+            if (!this._isOpen) return;
+            clearTimeout(saveTimer);
+            saveTimer = setTimeout(() => this._saveGeometry(el), 250);
+        });
+        ro.observe(el);
+    },
+
+    _clampIntoViewport(el) {
+        const rect = el.getBoundingClientRect();
+        if (rect.left + 80 > window.innerWidth || rect.top + 40 > window.innerHeight
+            || rect.left < -(rect.width - 80) || rect.top < 0) {
+            // Recenter
+            const w = Math.min(rect.width || 520, window.innerWidth - 40);
+            const h = Math.min(rect.height || 440, window.innerHeight - 40);
+            el.style.width = `${w}px`;
+            el.style.height = `${h}px`;
+            el.style.left = `${Math.max(20, (window.innerWidth - w) / 2)}px`;
+            el.style.top = `${Math.max(20, (window.innerHeight - h) / 2)}px`;
+        }
+    },
+
+    _saveGeometry(el) {
+        const rect = el.getBoundingClientRect();
+        const data = {
+            left: Math.round(rect.left),
+            top: Math.round(rect.top),
+            width: Math.round(rect.width),
+            height: Math.round(rect.height),
+        };
+        try { localStorage.setItem(this._STORAGE_KEY, JSON.stringify(data)); } catch (_) {}
+    },
+
+    _loadGeometry() {
+        try {
+            const raw = localStorage.getItem(this._STORAGE_KEY);
+            if (!raw) return null;
+            const data = JSON.parse(raw);
+            if (typeof data.left !== 'number') return null;
+            return data;
+        } catch (_) { return null; }
+    },
+};
+
 // Legacy wrappers kept for backward compatibility
 function renderCalibrationGallery() { CalibrationManager.render(); }
 

From 7f241e1b1ececf56d8ded2332579789ae4f7315e Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 14:30:04 -0400
Subject: [PATCH 018/314] Embryos > Board: clock / stereo / pace columns
 replace confidence + rate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The board's metric columns are restructured around developmental
time, the actual question this view answers ("is this embryo on
pace?"):

- 'clock' — elapsed wall-clock time in the current stage
- 'stereo' — stereotypic developmental position at 20 °C reference
- 'pace' — clock / stereo ratio; 1.0× means on reference pace

These replace 'confidence' (never populated meaningfully) and 'rate'
(misleading for slow embryos). 'eta' is now hatch-time, pace-corrected.

Migration: dashboardConfig loaded from localStorage runs an idempotent
filter that drops 'confidence' / 'rate' from the saved column list and
inserts the three new columns in the right slots. Existing user
configs upgrade silently on next load.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css  |  18 ++-
 gently/ui/web/static/js/embryos.js | 209 ++++++++++++++++++++++-------
 2 files changed, 176 insertions(+), 51 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 4772dad7..ea8dd142 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -3607,12 +3607,24 @@ kbd {
 .board-col { padding: 0 0.5rem; }
 .board-col-embryo { width: 100px; flex-shrink: 0; }
 .board-col-stage { width: 130px; flex-shrink: 0; }
-.board-col-conf { width: 60px; flex-shrink: 0; text-align: center; }
-.board-col-rate { width: 70px; flex-shrink: 0; text-align: center; }
-.board-col-eta { width: 70px; flex-shrink: 0; text-align: center; }
+.board-col-clock { width: 72px; flex-shrink: 0; text-align: right; font-variant-numeric: tabular-nums; }
+.board-col-stereo { width: 140px; flex-shrink: 0; font-variant-numeric: tabular-nums; }
+.board-col-pace { width: 90px; flex-shrink: 0; text-align: center; font-variant-numeric: tabular-nums; }
+.board-col-eta { width: 70px; flex-shrink: 0; text-align: right; font-variant-numeric: tabular-nums; }
 .board-col-spark { flex: 1; min-width: 100px; }
 .board-col-alert { width: 110px; flex-shrink: 0; text-align: right; }
 
+/* Pace cell coloring — green when on reference, orange when slow,
+   red when seriously slow. Class names mirror _formatPace(). */
+.board-col-pace.pace-unknown { color: var(--text-muted); }
+.board-col-pace.pace-normal  { color: var(--accent-green, #4ade80); }
+.board-col-pace.pace-slow    { color: #fb923c; }
+.board-col-pace.pace-slow-bad { color: #f87171; font-weight: 600; }
+
+/* Subtle overdue mark in the stereo cell when clock has run past the
+   expected stage duration. */
+.stereo-overdue { color: #fb923c; margin-left: 4px; }
+
 .board-rows { flex: 1; }
 
 .board-row {
diff --git a/gently/ui/web/static/js/embryos.js b/gently/ui/web/static/js/embryos.js
index f8b7cea3..29340cf5 100644
--- a/gently/ui/web/static/js/embryos.js
+++ b/gently/ui/web/static/js/embryos.js
@@ -59,7 +59,7 @@ const EmbryosManager = {
     dashboardConfig: {
         defaultView: 'default',
         board: {
-            columns: ['stage', 'confidence', 'rate', 'eta', 'sparkline', 'alert'],
+            columns: ['stage', 'clock', 'stereo', 'pace', 'eta', 'sparkline', 'alert'],
             sparklineLength: 20,
             warnOvertimeRatio: 1.5,
             criticalOvertimeRatio: 2.5
@@ -266,6 +266,23 @@ const EmbryosManager = {
                 // Deep merge with defaults
                 this.dashboardConfig = this._deepMerge(this.dashboardConfig, parsed);
             }
+            // Migrate legacy board columns: drop the never-populated
+            // 'confidence' column and the misleading 'rate' column in
+            // favour of clock/stereo/pace. Idempotent — runs on every load.
+            const cols = this.dashboardConfig.board?.columns;
+            if (Array.isArray(cols)) {
+                const filtered = cols.filter(c => c !== 'confidence' && c !== 'rate');
+                const ensure = (key, after) => {
+                    if (filtered.includes(key)) return;
+                    const idx = filtered.indexOf(after);
+                    if (idx === -1) filtered.push(key);
+                    else filtered.splice(idx + 1, 0, key);
+                };
+                ensure('clock', 'stage');
+                ensure('stereo', 'clock');
+                ensure('pace', 'stereo');
+                this.dashboardConfig.board.columns = filtered;
+            }
         } catch (e) {
             console.warn('Failed to load dashboard config:', e);
         }
@@ -370,9 +387,10 @@ const EmbryosManager = {
             <div class="board-header">
                 <span class="board-col board-col-embryo">Embryo</span>
                 ${cols.includes('stage') ? '<span class="board-col board-col-stage">Stage</span>' : ''}
-                ${cols.includes('confidence') ? '<span class="board-col board-col-conf">Conf</span>' : ''}
-                ${cols.includes('rate') ? '<span class="board-col board-col-rate">Rate</span>' : ''}
-                ${cols.includes('eta') ? '<span class="board-col board-col-eta">ETA</span>' : ''}
+                ${cols.includes('clock') ? '<span class="board-col board-col-clock" title="Clock time in current stage">Clock</span>' : ''}
+                ${cols.includes('stereo') ? '<span class="board-col board-col-stereo" title="Stereotypic developmental position (20°C reference)">Stereo</span>' : ''}
+                ${cols.includes('pace') ? '<span class="board-col board-col-pace" title="Clock / stereotypic time — 1.0× means on reference pace">Pace</span>' : ''}
+                ${cols.includes('eta') ? '<span class="board-col board-col-eta" title="Estimated clock-time to hatch, pace-corrected">ETA</span>' : ''}
                 ${cols.includes('sparkline') ? '<span class="board-col board-col-spark">Progression</span>' : ''}
                 ${cols.includes('alert') ? '<span class="board-col board-col-alert">Alert</span>' : ''}
             </div>
@@ -412,54 +430,27 @@ const EmbryosManager = {
         const latest = reasoning.length > 0 ? reasoning[reasoning.length - 1] : null;
         const cols = this.dashboardConfig.board.columns;
 
-        // Stage
         const stage = latest?.stage || embryo.current_stage || '—';
         const stageIcon = this.getStageIcon(stage);
         const stageName = this.formatStageName(stage);
 
-        // Confidence
-        const conf = latest ? this.normalizeConfidence(latest.confidence) : 'unknown';
-        const confDots = conf === 'high' ? '●●●' : conf === 'medium' ? '●●○' : conf === 'low' ? '●○○' : '○○○';
-        const confClass = conf === 'high' ? 'conf-high' : conf === 'medium' ? 'conf-med' : 'conf-low';
+        const align = this._computeAlignment(latest);
+        const overtime = align?.overtime;
 
-        // Rate
-        const overtime = latest?.temporal_analysis?.overtime_ratio;
-        let rateText = '—';
-        let rateClass = '';
-        if (overtime != null) {
-            const rate = (1 / overtime).toFixed(1);
-            rateText = overtime < 0.9 ? `${rate}x↑` : overtime > 1.1 ? `${rate}x↓` : `${rate}x→`;
-            rateClass = overtime < 0.9 ? 'rate-fast' : overtime > 1.5 ? 'rate-slow' : 'rate-normal';
-        }
+        const clockText = align ? this._formatMinutes(align.inStageClockMin) : '—';
+        const stereoText = align ? this._formatStereoLabel(align) : '—';
+        const pace = align ? this._formatPace(align) : { text: '—', className: '' };
+        const eta = align ? this._formatEta(align) : '—';
 
-        // ETA
-        let eta = '—';
-        if (stage && this.STAGE_TIMING[stage] != null) {
-            const stageMinutes = this.STAGE_TIMING[stage];
-            const hatchMinutes = this.STAGE_TIMING['hatched'] || 570;
-            const remaining = hatchMinutes - stageMinutes;
-            if (remaining > 0) {
-                const hours = (remaining / 60).toFixed(1);
-                eta = `~${hours}h`;
-            } else {
-                eta = 'done';
-            }
-        }
-
-        // Sparkline
         const sparklineSvg = cols.includes('sparkline') ? this._renderBoardSparkline(reasoning) : '';
 
-        // Alert
         const arrested = latest?.temporal_analysis?.is_potentially_arrested;
         const slow = overtime && overtime > (this.dashboardConfig.board.warnOvertimeRatio || 1.5);
-        const lowConf = conf === 'low';
         let alertHtml = '<span class="board-alert-none">—</span>';
         if (arrested) {
             alertHtml = '<span class="board-alert board-alert-critical">⚠ arrested</span>';
         } else if (slow) {
-            alertHtml = `<span class="board-alert board-alert-warn">⚠ slow ${overtime.toFixed(1)}x</span>`;
-        } else if (lowConf) {
-            alertHtml = '<span class="board-alert board-alert-warn">⚠ low conf</span>';
+            alertHtml = `<span class="board-alert board-alert-warn">⚠ slow ${overtime.toFixed(1)}×</span>`;
         }
 
         const status = embryo.isComplete ? 'complete' : embryo.lastError ? 'error' : 'running';
@@ -472,8 +463,9 @@ const EmbryosManager = {
                     <span class="board-embryo-name">${embryo.embryoId.replace(/embryo_?/i, 'E')}</span>
                 </span>
                 ${cols.includes('stage') ? `<span class="board-col board-col-stage"><span class="board-stage-badge" style="color:${this.STAGE_COLORS[stage] || 'var(--text)'}">${stageIcon} ${stageName}</span></span>` : ''}
-                ${cols.includes('confidence') ? `<span class="board-col board-col-conf ${confClass}">${confDots}</span>` : ''}
-                ${cols.includes('rate') ? `<span class="board-col board-col-rate ${rateClass}">${rateText}</span>` : ''}
+                ${cols.includes('clock') ? `<span class="board-col board-col-clock">${clockText}</span>` : ''}
+                ${cols.includes('stereo') ? `<span class="board-col board-col-stereo">${stereoText}</span>` : ''}
+                ${cols.includes('pace') ? `<span class="board-col board-col-pace ${pace.className}">${pace.text}</span>` : ''}
                 ${cols.includes('eta') ? `<span class="board-col board-col-eta">${eta}</span>` : ''}
                 ${cols.includes('sparkline') ? `<span class="board-col board-col-spark">${sparklineSvg}</span>` : ''}
                 ${cols.includes('alert') ? `<span class="board-col board-col-alert">${alertHtml}</span>` : ''}
@@ -481,6 +473,99 @@ const EmbryosManager = {
         `;
     },
 
+    /** Compute clock↔stereotypic alignment from perception temporal_analysis.
+     *
+     * Definitions:
+     *   inStageClockMin  — wall-clock minutes elapsed in current stage
+     *   inStageStereoMin — stereotypic minutes "used" within the stage,
+     *                      capped at the stage's expected duration. An
+     *                      overdue embryo is stuck at the stage end in
+     *                      stereo time while clock keeps ticking.
+     *   overtime         — ratio inStageClockMin / expected_duration.
+     *                      >1 means the embryo has spent more clock time
+     *                      in the stage than the reference 20°C textbook
+     *                      duration. <1 just means "still within stage" —
+     *                      no slow/fast signal yet.
+     *   stereoAgeMin     — total stereotypic age, anchored at the start
+     *                      minute of the current stage in the reference
+     *                      table plus the (capped) in-stage stereo offset.
+     */
+    _computeAlignment(latest) {
+        const ta = latest?.temporal_analysis;
+        if (!ta || !ta.current_stage) return null;
+        const stage = ta.current_stage;
+        const stageStart = this.STAGE_TIMING[stage];
+        if (stageStart == null) return null;
+
+        const expDur = Number(ta.expected_duration_min) || 0;
+        const inClock = Number(ta.time_in_stage_min) || 0;
+        const overtime = Number(ta.overtime_ratio) || 0;
+
+        const inStereo = expDur > 0 ? Math.min(inClock, expDur) : inClock;
+        const stereoAge = stageStart + inStereo;
+
+        return {
+            stage,
+            stageStart,
+            expDur,
+            inStageClockMin: inClock,
+            inStageStereoMin: inStereo,
+            stereoAgeMin: stereoAge,
+            overtime,
+        };
+    },
+
+    /** Render the stereo cell: "≈early", "≈bean +12m", or "≈comma +88m ⚠"
+     * when overdue (stereo capped at stage end while clock keeps running). */
+    _formatStereoLabel(align) {
+        const stageName = this.formatStageName(align.stage);
+        const offsetMin = Math.round(align.inStageStereoMin);
+        const overdue = align.expDur > 0 && align.inStageClockMin > align.expDur + 1;
+        const offsetStr = offsetMin > 0 ? ` +${offsetMin}m` : '';
+        const overdueMark = overdue ? ' <span class="stereo-overdue" title="Clock ran past expected stage duration">⚠</span>' : '';
+        return `≈${stageName}${offsetStr}${overdueMark}`;
+    },
+
+    _formatPace(align) {
+        // Only emit a pace signal once we have meaningful clock data.
+        // Within the first few minutes the ratio is tiny and noisy — show
+        // a dashed placeholder so the column doesn't lie about precision.
+        const NORMAL_BAND = 1.05;
+        const SLOW_BAND = 1.5;
+        if (align.inStageClockMin < 1 || align.expDur <= 0) {
+            return { text: '—', className: 'pace-unknown' };
+        }
+        const r = align.overtime;
+        if (r <= NORMAL_BAND) {
+            return { text: '1.0×', className: 'pace-normal' };
+        }
+        if (r <= SLOW_BAND) {
+            return { text: `${r.toFixed(1)}× slow`, className: 'pace-slow' };
+        }
+        return { text: `⚠ ${r.toFixed(1)}×`, className: 'pace-slow-bad' };
+    },
+
+    /** ETA in hours from current stereotypic position to hatched, scaled
+     * by observed pace when the embryo is demonstrably slow. */
+    _formatEta(align) {
+        const hatchStereo = this.STAGE_TIMING['hatched'] || 570;
+        const remainStereo = hatchStereo - align.stereoAgeMin;
+        if (remainStereo <= 0) return 'done';
+        const paceFactor = align.overtime > 1.05 ? align.overtime : 1.0;
+        const remainClockMin = remainStereo * paceFactor;
+        return `~${(remainClockMin / 60).toFixed(1)}h`;
+    },
+
+    /** Compact minute formatter: "45s" / "10m" / "1h 22m" / "3h". */
+    _formatMinutes(min) {
+        if (min == null || !isFinite(min)) return '—';
+        if (min < 1) return `${Math.round(min * 60)}s`;
+        if (min < 60) return `${Math.round(min)}m`;
+        const h = Math.floor(min / 60);
+        const m = Math.round(min - h * 60);
+        return m > 0 ? `${h}h ${m}m` : `${h}h`;
+    },
+
     _renderBoardSparkline(reasoning) {
         if (!reasoning.length) return '';
         const sorted = [...reasoning].sort((a, b) => (a.timepoint ?? 0) - (b.timepoint ?? 0));
@@ -565,12 +650,24 @@ const EmbryosManager = {
 
             const shortName = embryo.embryoId.replace(/embryo_?/i, 'E');
             const latestStage = sorted.length > 0 ? this.formatStageName(sorted[sorted.length - 1].stage) : '—';
+            const isTerminated = !!embryo.isComplete;
+            const termReason = embryo.completionReason || '';
+            // Short label for the badge — humanise the no_object terminal
+            // reason, otherwise keep the first clause of whatever the
+            // backend sent so the user still gets a hint.
+            const termBadge = isTerminated
+                ? (termReason.includes('no_object') ? 'HATCHED?' : 'STOPPED')
+                : '';
+            const termTooltip = isTerminated
+                ? `Terminated — ${termReason || 'no reason given'}`
+                : '';
 
-            html += `<div class="filmstrip-row">`;
+            html += `<div class="filmstrip-row${isTerminated ? ' terminated' : ''}"${termTooltip ? ` title="${termTooltip.replace(/"/g, '&quot;')}"` : ''}>`;
             html += `<div class="filmstrip-label">
                 <span class="filmstrip-name">${shortName}</span>
                 <span class="filmstrip-stage">${latestStage}</span>
                 <span class="filmstrip-count">${reasoning.length} eval</span>
+                ${isTerminated ? `<span class="filmstrip-terminated-badge">${termBadge}</span>` : ''}
             </div>`;
             html += `<div class="filmstrip-thumbs">`;
 
@@ -1000,7 +1097,7 @@ const EmbryosManager = {
                 intervalSeconds: embryoData.interval_seconds || this.state.baseInterval,
                 timepoints: embryoData.timepoints || 0,
                 isComplete: embryoData.is_complete || false,
-                completionReason: null,
+                completionReason: embryoData.completion_reason || null,
                 firstAcquired: embryoData.first_acquired ? new Date(embryoData.first_acquired) : null,
                 lastAcquired: embryoData.last_acquired ? new Date(embryoData.last_acquired) : null,
                 detections: embryoData.detections || {},
@@ -2726,10 +2823,17 @@ const EmbryosManager = {
             `;
         }
 
-        // Format confidence display
-        const confDisplay = typeof item.confidence === 'number'
-            ? `${Math.round(item.confidence * 100)}%`
-            : (item.confidence || 'Unknown');
+        // Format confidence display. Hide entirely when the detector
+        // doesn't emit a probabilistic confidence (e.g. dopaminergic_signal
+        // returns structured intensity/structure findings instead) — the
+        // string "Unknown confidence" was actively confusing.
+        const hasNumericConf = typeof item.confidence === 'number';
+        const hasTextConf = typeof item.confidence === 'string' && item.confidence.trim() !== '';
+        const confHtml = hasNumericConf
+            ? `<span class="verdict-confidence">${Math.round(item.confidence * 100)}% confidence</span>`
+            : hasTextConf
+                ? `<span class="verdict-confidence">${item.confidence}</span>`
+                : '';
 
         return `
             <div class="detail-panel-header">
@@ -2748,7 +2852,7 @@ const EmbryosManager = {
                     </div>
                     <div class="detail-verdict ${item.detected ? 'detected' : ''}">
                         <span class="verdict-stage">${item.stage ? this.formatStageName(item.stage) : (item.detected ? 'DETECTED' : 'Not detected')}</span>
-                        <span class="verdict-confidence">${confDisplay} confidence</span>
+                        ${confHtml}
                         ${transitionalHtml}
                     </div>
                     ${detectorFindingsHtml}
@@ -2979,13 +3083,22 @@ const EmbryosManager = {
             container.classList.remove('visible');
             container.innerHTML = '';
         }
+        // Filmstrip side panel — clearing innerHTML lets the :empty CSS
+        // rule collapse the panel and let the rows reclaim full width.
+        const filmstripDetail = document.getElementById('filmstrip-detail');
+        if (filmstripDetail) {
+            filmstripDetail.innerHTML = '';
+        }
         this.detailPanelVisible = false;
         this.currentDetailItem = null;
 
-        // Clear eval dot highlight
+        // Clear eval dot + filmstrip cell highlight
         document.querySelectorAll('.eval-dot.active').forEach(dot => {
             dot.classList.remove('active');
         });
+        document.querySelectorAll('.filmstrip-cell.active').forEach(cell => {
+            cell.classList.remove('active');
+        });
     },
 
     // Navigate to previous/next item in detail panel

From cbf41404846297a2b208155320ae7745b5c49e04 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 14:30:28 -0400
Subject: [PATCH 019/314] Bump version to 0.21.0.dev0

Opens the v0.21 development cycle on this branch. Targets per the
KANBAN roadmap: cross-session resume, sacrificial vocab alias,
campaign template loader (Path B), LDM Phase 1 MVP.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 gently/__init__.py | 2 +-
 pyproject.toml     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gently/__init__.py b/gently/__init__.py
index be9985bb..37aee420 100644
--- a/gently/__init__.py
+++ b/gently/__init__.py
@@ -76,7 +76,7 @@
 except ImportError:
     _VISUALIZATION_AVAILABLE = False
 
-__version__ = "0.20.0"
+__version__ = "0.21.0.dev0"
 __all__ = [
     # Main entry point
     "Gently",
diff --git a/pyproject.toml b/pyproject.toml
index d07b6c42..2395f90e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gently"
-version = "0.20.0"
+version = "0.21.0.dev0"
 description = "Agentic harnessing for microscopy"
 readme = "docs/README.md"
 license = {text = "MIT"}

From 63c5be0ee6eb2a8c52732f709db507ed5190e179 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 18:16:30 -0400
Subject: [PATCH 020/314] switchbot: accept newer 0x05 status-frame response as
 success
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Modern SwitchBot Bot firmware (≥ v4.x) replies to press/on/off with a
3-byte status frame: 0x05 + battery% + flag bits. Older firmware
returned the bare 0x01 success byte. The strict 0x01-only check
raised SwitchBotError for any current-production Bot even though the
press had landed (visible on the controlled load).

Widen _RESP_OK to accept either prefix. Both indicate the command
reached the actuator.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 gently/hardware/switchbot.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/gently/hardware/switchbot.py b/gently/hardware/switchbot.py
index 131c50ef..713a785f 100644
--- a/gently/hardware/switchbot.py
+++ b/gently/hardware/switchbot.py
@@ -40,7 +40,10 @@
     "off":   bytes([0x57, 0x01, 0x02]),
     "press": bytes([0x57, 0x01, 0x00]),
 }
-_RESP_OK = 0x01  # first byte of the response notification on success
+# First byte of the success response. Older Bot firmware returns 0x01 alone;
+# modern firmware (≥ Bot v4.x) returns 0x05 followed by a status frame —
+# byte 1 = battery %, byte 2 = flag bits. Both mean "press landed."
+_RESP_OK = (0x01, 0x05)
 
 
 class SwitchBotError(RuntimeError):
@@ -75,7 +78,7 @@ def _on_notify(_char, data: bytearray) -> None:
                 pass
 
     data = response["data"]
-    if not data or data[0] != _RESP_OK:
+    if not data or data[0] not in _RESP_OK:
         raise SwitchBotError(f"SwitchBot returned non-OK response: {data.hex()}")
     return data
 

From b6bd49ce21b4c9757576ce637615b6f08346be27 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 18:16:31 -0400
Subject: [PATCH 021/314] config: register room_light SwitchBot for the diSPIM
 rig
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Wires the BLE-attached SwitchBot Bot that toggles the room light into
the device-layer config so DeviceLayerServer registers it on boot.
Plans address it via `bps.mv(room_light, 'on')`. MAC is the bot
already mounted on the rig.

Reached over BLE via the TP-Link UB500 dongle on this desktop —
RSSI -70 dBm, well within reliable range.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 config/config.yml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/config/config.yml b/config/config.yml
index e59e9f6d..086de3f1 100644
--- a/config/config.yml
+++ b/config/config.yml
@@ -1,4 +1,13 @@
 organism: "celegans"
 hardware: "dispim"
 mmconfig: "MMConfig_tracking_screening.cfg"
-mmdirectory: "C:/Program Files/Micro-Manager-1.4"
\ No newline at end of file
+mmdirectory: "C:/Program Files/Micro-Manager-1.4"
+
+# SwitchBot Bot — physical button-pusher mounted on the diSPIM room light
+# switch. Talks BLE direct (no SwitchBot Hub / cloud). Plans address it by
+# name, e.g. `bps.mv(room_light, 'on')`. Remove this block to skip
+# registration; the device layer is tolerant of either state.
+switchbot:
+  name: room_light
+  address: "EC:6F:04:06:5B:23"
+  timeout: 20.0
\ No newline at end of file

From 0158004e94d2b2e2e75cf182d13a6db3e498bf91 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 18:25:12 -0400
Subject: [PATCH 022/314] =?UTF-8?q?switchbot:=20read=5Fstatus()=20?=
 =?UTF-8?q?=E2=80=94=20battery=20/=20firmware=20via=200x57=200x02=20query?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a dedicated status query (BLE 0x57 0x02) that returns battery
percentage and firmware version without touching the actuator. Result
is cached on the device instance and surfaced through read() /
describe() as `<name>_battery_pct` and `<name>_firmware`, so the
device-state stream picks them up automatically once polled.

Verified on a Bot v4.2 over the TP-Link UB500: response
`01 64 42 64 00 00 00 66 00 10 00 00 00` parses as battery 100%,
firmware 0x42 (v4.2).

Importantly, action-command responses are NOT used as a battery
source — their byte-1 field looks like battery (an empirically
0x48-shaped value) but isn't: the dedicated query on the same bot
reads 100%, so byte 1 of an action response is some other
firmware-internal counter. Documented inline so the next
reverse-engineer doesn't fall into the same trap.

Periodic polling cadence is left to the caller; hourly is plenty for
a battery that moves over months.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 gently/hardware/switchbot.py | 72 +++++++++++++++++++++++++++++++++---
 1 file changed, 67 insertions(+), 5 deletions(-)

diff --git a/gently/hardware/switchbot.py b/gently/hardware/switchbot.py
index 713a785f..6a165054 100644
--- a/gently/hardware/switchbot.py
+++ b/gently/hardware/switchbot.py
@@ -40,9 +40,22 @@
     "off":   bytes([0x57, 0x01, 0x02]),
     "press": bytes([0x57, 0x01, 0x00]),
 }
+# Dedicated status query: returns battery %, firmware version, mode flags.
+# This is the only reliable source of battery — action-command responses
+# also include status bytes but in a different format (byte 1 there isn't
+# battery despite what's documented for older firmware).
+_QUERY_STATUS = bytes([0x57, 0x02])
+# Status-query response format (firmware ≥ 6.x):
+#   byte 0 = 0x01 success
+#   byte 1 = battery %
+#   byte 2 = firmware version (BCD-ish: high nibble.low nibble — 0x42 = v4.2)
+#   bytes 3+ = mode flags / timer count / counters (firmware-dependent)
+_STATUS_BATTERY_IDX = 1
+_STATUS_FIRMWARE_IDX = 2
 # First byte of the success response. Older Bot firmware returns 0x01 alone;
-# modern firmware (≥ Bot v4.x) returns 0x05 followed by a status frame —
-# byte 1 = battery %, byte 2 = flag bits. Both mean "press landed."
+# modern firmware (≥ Bot v4.x) returns 0x05 for action commands followed by
+# action-status bytes. Both are "command landed" — the action payload format
+# differs from the status-query payload format, so don't reuse parsers.
 _RESP_OK = (0x01, 0x05)
 
 
@@ -104,6 +117,12 @@ def __init__(self, address: str, name: str = "switchbot", *, timeout: float = 20
         self.timeout = timeout
         self.parent = None              # required for Bluesky bps.mv()
         self._state = "unknown"         # last commanded on/off state
+        # Status fields populated only by read_status(). Left as None until
+        # first contact — action commands deliberately don't update these,
+        # see note on _STATUS_BATTERY_IDX above.
+        self._battery_pct: int | None = None
+        self._firmware: int | None = None
+        self._status_ts: float | None = None
         self._lock = threading.Lock()   # serialize BLE access (one radio, one bot)
 
     # -- Bluesky settable protocol -------------------------------------------
@@ -135,15 +154,58 @@ def worker():
         threading.Thread(target=worker, name=f"{self.name}-set", daemon=True).start()
         return status
 
+    # -- Dedicated status query (no actuation) -------------------------------
+    def read_status(self) -> dict:
+        """Query battery / firmware / mode without touching the switch arm.
+
+        Synchronous: runs its own BLE connect → query → disconnect on the
+        caller's thread. Updates the cached status fields on success so
+        read() surfaces fresh values to the device-state stream. Use this
+        for periodic polls (~hourly is fine; battery doesn't move quickly).
+
+        Returns a dict ``{battery_pct, firmware, raw_hex}``; raises
+        SwitchBotError on BLE / protocol failure.
+        """
+        with self._lock:
+            data = asyncio.run(
+                _send_command(self.address, _QUERY_STATUS, self.timeout)
+            )
+        info = {
+            "raw_hex": data.hex(),
+            "battery_pct": data[_STATUS_BATTERY_IDX] if len(data) > _STATUS_BATTERY_IDX else None,
+            "firmware": data[_STATUS_FIRMWARE_IDX] if len(data) > _STATUS_FIRMWARE_IDX else None,
+        }
+        if info["battery_pct"] is not None:
+            self._battery_pct = info["battery_pct"]
+        if info["firmware"] is not None:
+            self._firmware = info["firmware"]
+        self._status_ts = time.time()
+        logger.info("SwitchBot %s status: %s", self.name, info)
+        return info
+
     # -- Bluesky readable protocol -------------------------------------------
     def read(self):
-        return OrderedDict({
-            self.name: {"value": self._state, "timestamp": time.time()}
+        ts = time.time()
+        out = OrderedDict({
+            self.name: {"value": self._state, "timestamp": ts}
         })
+        if self._battery_pct is not None:
+            out[f"{self.name}_battery_pct"] = {
+                "value": self._battery_pct,
+                "timestamp": self._status_ts or ts,
+            }
+        if self._firmware is not None:
+            out[f"{self.name}_firmware"] = {
+                "value": self._firmware,
+                "timestamp": self._status_ts or ts,
+            }
+        return out
 
     def describe(self):
         return OrderedDict({
-            self.name: {"source": f"switchbot:{self.address}", "dtype": "string", "shape": []}
+            self.name: {"source": f"switchbot:{self.address}", "dtype": "string", "shape": []},
+            f"{self.name}_battery_pct": {"source": f"switchbot:{self.address}", "dtype": "integer", "shape": []},
+            f"{self.name}_firmware":    {"source": f"switchbot:{self.address}", "dtype": "integer", "shape": []},
         })
 
     def read_configuration(self):

From a2a82bca0bf92df1082310e8c3624c136252fbc5 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 23:32:34 -0400
Subject: [PATCH 023/314] feat(web): add agent chat window + control lock;
 retire TUI launch

Begin the TUI->web convergence:

- Floating agent-chat window in the web UI (agent-chat.js/.css, wired into
  index.html) connecting to /ws/agent: streaming text/thinking/tool calls,
  choice pickers, applied-spec cards, slash-command routing. All untrusted
  text is escaped before insertion.
- Single-driver control lock in agent_ws.py: only the holder may drive the
  agent; other clients are observers with a "Take control" banner. Fixes the
  latent shared-conversation corruption when >1 client connects.
- launch_gently.py no longer spawns the Node TUI. It starts the agent + viz
  server, prints a launch banner (URL, device status, storage, Ctrl-C),
  auto-opens the browser (--no-browser to suppress), and serves until
  interrupted. Removes the Node/dist requirement; --resume resolves to
  latest (interactive picking deferred to the browser). TUI source kept
  in-tree (reversible).

Auth not yet added: the browser is now the only control path and is
unauthenticated on the LAN. Bind to 127.0.0.1 or trust the LAN until
self-managed accounts land.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py        |  96 ++++++-
 gently/ui/web/static/css/agent-chat.css | 233 ++++++++++++++++
 gently/ui/web/static/js/agent-chat.js   | 351 ++++++++++++++++++++++++
 gently/ui/web/templates/index.html      |  18 ++
 launch_gently.py                        | 112 +++++---
 5 files changed, 763 insertions(+), 47 deletions(-)
 create mode 100644 gently/ui/web/static/css/agent-chat.css
 create mode 100644 gently/ui/web/static/js/agent-chat.js

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index df59aaeb..d9b8d5cb 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -10,7 +10,7 @@
 import json
 import logging
 from datetime import datetime
-from typing import Dict, Optional
+from typing import Callable, Dict, Optional
 
 from fastapi import APIRouter, WebSocket, WebSocketDisconnect
 
@@ -31,6 +31,32 @@ def create_router(server) -> APIRouter:
     # Pending choice futures keyed by request_id
     _choice_futures: Dict[str, asyncio.Future] = {}
 
+    # ── Single-driver control arbitration ─────────────────────
+    # Shared across all /ws/agent clients (the router is created once).
+    # Only the control holder may drive the agent (chat/command/cancel);
+    # everyone else is an observer until they take control. This is the
+    # seed of the multi-user control lock and also prevents the shared
+    # agent conversation from being corrupted when >1 client connects.
+    _control: Dict[str, Optional[str]] = {"holder": None}
+    _clients: Dict[str, Callable] = {}
+    _client_labels: Dict[str, str] = {}
+    _client_counter = {"n": 0}
+
+    async def _broadcast_control_status():
+        """Tell every connected agent client who currently holds control."""
+        holder = _control["holder"]
+        holder_label = _client_labels.get(holder) if holder else None
+        for cid, fn in list(_clients.items()):
+            try:
+                await fn({
+                    "type": "control_status",
+                    "holder": holder,
+                    "holder_label": holder_label,
+                    "you_have_control": (cid == holder),
+                })
+            except Exception:
+                pass
+
     async def _run_wizard(wizard, websocket, send_fn, _choice_futures, bridge=None, log_transcript=None):
         """Run the wizard's interactive loop.
 
@@ -136,6 +162,13 @@ async def agent_websocket(websocket: WebSocket):
             await websocket.close()
             return
 
+        # Assign a stable id for control arbitration. The first client to
+        # connect (in practice the TUI, spawned at launch) is labelled the
+        # terminal; later connections are browser windows.
+        _client_counter["n"] += 1
+        client_id = f"agent_client_{_client_counter['n']}"
+        client_label = "the terminal" if _client_counter["n"] == 1 else "a browser window"
+
         # Send connection metadata (version, tokens, embryo count, commands)
         meta = bridge.get_connect_metadata()
         _connected_msg = {
@@ -409,6 +442,13 @@ def choice_future_factory(choice_data: dict) -> asyncio.Future:
             _choice_futures[request_id] = future
             return future
 
+        # Register this client for control arbitration; grant control if free.
+        _clients[client_id] = send_fn
+        _client_labels[client_id] = client_label
+        if _control["holder"] is None:
+            _control["holder"] = client_id
+        await _broadcast_control_status()
+
         try:
             # ── Wizard phase ──────────────────────────────────────
             # Run startup wizard (if needed) before entering the REPL.
@@ -497,6 +537,38 @@ async def _run_resolution_bootstrap():
                 _log_transcript("in", data)
                 msg_type = data.get("type")
 
+                # ── Control arbitration ───────────────────────────
+                # A client requesting the wheel.
+                if msg_type == "take_control":
+                    prev = _control["holder"]
+                    _control["holder"] = client_id
+                    if prev and prev != client_id and prev in _clients:
+                        try:
+                            await _clients[prev]({
+                                "type": "notification",
+                                "level": "warning",
+                                "title": f"Control taken by {client_label}",
+                                "body": "You are now viewing.",
+                            })
+                        except Exception:
+                            pass
+                    await _broadcast_control_status()
+                    continue
+
+                # Only the holder may drive the agent. Observers are told
+                # to take control rather than silently corrupting the
+                # single shared conversation.
+                if msg_type in ("chat", "command", "cancel") and client_id != _control["holder"]:
+                    holder_label = _client_labels.get(_control["holder"]) or "another client"
+                    await send_fn({
+                        "type": "notification",
+                        "level": "info",
+                        "title": f"Viewing only — control is held by {holder_label}",
+                        "body": "Take control to drive the microscope.",
+                    })
+                    await _broadcast_control_status()
+                    continue
+
                 if msg_type == "chat":
                     text = data.get("text", "").strip()
                     if not text:
@@ -615,11 +687,23 @@ async def _run_resolution_bootstrap():
                 active_task.cancel()
             if bootstrap_task is not None and not bootstrap_task.done():
                 bootstrap_task.cancel()
-            # Clean up pending futures
-            for future in _choice_futures.values():
-                if not future.done():
-                    future.cancel()
-            _choice_futures.clear()
+            # Release control arbitration for this client; hand the wheel
+            # to any remaining client (or free it) and resync everyone.
+            _clients.pop(client_id, None)
+            _client_labels.pop(client_id, None)
+            if _control["holder"] == client_id:
+                _control["holder"] = next(iter(_clients), None)
+                try:
+                    await _broadcast_control_status()
+                except Exception:
+                    pass
+            # Clean up pending futures only when the last client leaves —
+            # otherwise we'd cancel another connected client's pending choices.
+            if not _clients:
+                for future in _choice_futures.values():
+                    if not future.done():
+                        future.cancel()
+                _choice_futures.clear()
 
     return router
 
diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
new file mode 100644
index 00000000..99dbcf33
--- /dev/null
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -0,0 +1,233 @@
+/* Floating agent-chat window — the web-side control surface. */
+
+.agent-fab {
+    position: fixed;
+    right: 22px;
+    bottom: 22px;
+    width: 56px;
+    height: 56px;
+    border-radius: 50%;
+    border: none;
+    cursor: pointer;
+    z-index: 1200;
+    font-size: 24px;
+    color: #fff;
+    background: var(--gradient-primary);
+    box-shadow: var(--shadow-glow-strong);
+    transition: transform 0.15s ease, box-shadow 0.15s ease;
+}
+.agent-fab:hover { transform: translateY(-2px) scale(1.04); }
+.agent-fab.ac-fab-active { transform: rotate(45deg); }
+
+.agent-chat {
+    position: fixed;
+    right: 22px;
+    bottom: 90px;
+    width: 400px;
+    max-width: calc(100vw - 44px);
+    height: 560px;
+    max-height: calc(100vh - 130px);
+    display: flex;
+    flex-direction: column;
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 14px;
+    box-shadow: 0 12px 48px rgba(0, 0, 0, 0.45);
+    z-index: 1199;
+    overflow: hidden;
+}
+.agent-chat.hidden, .agent-control-banner.hidden { display: none; }
+
+.agent-chat-header {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 10px 14px;
+    border-bottom: 1px solid var(--border);
+    background: var(--bg-hover);
+}
+.agent-chat-title { font-weight: 600; color: var(--text); flex: 0 0 auto; }
+.agent-chat-conn { font-size: 11px; margin-left: 4px; color: var(--text-muted); }
+.agent-chat-conn.ac-conn-ok { color: var(--accent-green); }
+.agent-chat-conn.ac-conn-bad { color: var(--color-danger, #f87171); }
+.agent-chat-close {
+    margin-left: auto;
+    background: none;
+    border: none;
+    color: var(--text-muted);
+    font-size: 22px;
+    line-height: 1;
+    cursor: pointer;
+}
+.agent-chat-close:hover { color: var(--text); }
+
+.agent-control-banner {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 8px 14px;
+    background: rgba(251, 146, 60, 0.12);
+    border-bottom: 1px solid var(--border);
+    color: var(--accent-orange, #fb923c);
+    font-size: 13px;
+}
+.ac-take-control {
+    margin-left: auto;
+    padding: 4px 12px;
+    border-radius: 8px;
+    border: 1px solid var(--accent);
+    background: var(--accent);
+    color: #fff;
+    cursor: pointer;
+    font-size: 12px;
+    font-weight: 600;
+}
+.ac-take-control:hover { background: var(--accent-hover); }
+
+.agent-chat-log {
+    flex: 1 1 auto;
+    overflow-y: auto;
+    padding: 14px;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    font-size: 14px;
+    line-height: 1.5;
+}
+
+.ac-msg {
+    padding: 8px 12px;
+    border-radius: 12px;
+    max-width: 90%;
+    word-wrap: break-word;
+    white-space: normal;
+}
+.ac-user {
+    align-self: flex-end;
+    background: var(--accent);
+    color: #fff;
+    border-bottom-right-radius: 4px;
+}
+.ac-agent {
+    align-self: flex-start;
+    background: var(--bg-hover);
+    color: var(--text);
+    border-bottom-left-radius: 4px;
+}
+.ac-agent code, .ac-agent strong { color: var(--accent-cyan); }
+.ac-agent code {
+    background: rgba(0, 0, 0, 0.25);
+    padding: 1px 5px;
+    border-radius: 4px;
+    font-size: 12.5px;
+}
+
+.ac-tool {
+    align-self: flex-start;
+    font-size: 12.5px;
+    color: var(--text-muted);
+    padding: 3px 10px;
+    border-radius: 8px;
+    background: rgba(255, 255, 255, 0.03);
+    border: 1px solid var(--border);
+}
+.ac-tool-done .ac-tool-check { color: var(--accent-green); }
+.ac-tool-spin { display: inline-block; animation: ac-spin 1.4s linear infinite; }
+@keyframes ac-spin { to { transform: rotate(360deg); } }
+
+.ac-thinking {
+    align-self: flex-start;
+    font-size: 12.5px;
+    color: var(--text-muted);
+    font-style: italic;
+    opacity: 0.8;
+}
+
+.ac-system {
+    align-self: center;
+    font-size: 12px;
+    color: var(--text-muted);
+    text-align: center;
+    padding: 2px 8px;
+}
+.ac-level-error { color: var(--color-danger, #f87171); }
+.ac-level-warning { color: var(--accent-orange, #fb923c); }
+.ac-level-success { color: var(--accent-green); }
+
+.ac-choice {
+    align-self: stretch;
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+    padding: 10px;
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    background: rgba(96, 165, 250, 0.06);
+}
+.ac-choice-q { color: var(--text); font-weight: 500; margin-bottom: 2px; }
+.ac-choice-opt {
+    text-align: left;
+    padding: 8px 12px;
+    border-radius: 8px;
+    border: 1px solid var(--border);
+    background: var(--bg-card);
+    color: var(--text);
+    cursor: pointer;
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+}
+.ac-choice-opt:hover:not(:disabled) { border-color: var(--accent); background: var(--bg-hover); }
+.ac-choice-opt:disabled { opacity: 0.5; cursor: default; }
+.ac-choice-label { font-weight: 600; }
+.ac-choice-desc { font-size: 12px; color: var(--text-muted); }
+.ac-choice-picked { border-color: var(--accent-green); }
+
+.ac-spec {
+    align-self: flex-start;
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 8px 12px;
+    background: var(--bg-hover);
+    font-size: 13px;
+}
+.ac-spec-title { font-weight: 600; color: var(--accent-purple); margin-bottom: 4px; }
+.ac-spec-row { display: flex; justify-content: space-between; gap: 16px; color: var(--text-muted); }
+.ac-spec-row span:last-child { color: var(--text); }
+
+.agent-chat-input {
+    display: flex;
+    gap: 8px;
+    padding: 10px;
+    border-top: 1px solid var(--border);
+    background: var(--bg-hover);
+}
+.agent-chat-input textarea {
+    flex: 1 1 auto;
+    resize: none;
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    background: var(--bg-card);
+    color: var(--text);
+    padding: 8px 10px;
+    font-family: inherit;
+    font-size: 14px;
+    line-height: 1.4;
+    max-height: 140px;
+}
+.agent-chat-input textarea:focus { outline: none; border-color: var(--accent); }
+.agent-chat-input textarea:disabled { opacity: 0.6; }
+.agent-chat-send {
+    flex: 0 0 auto;
+    align-self: flex-end;
+    padding: 8px 16px;
+    border-radius: 10px;
+    border: none;
+    background: var(--accent);
+    color: #fff;
+    font-weight: 600;
+    cursor: pointer;
+}
+.agent-chat-send:hover:not(:disabled) { background: var(--accent-hover); }
+.agent-chat-send:disabled { opacity: 0.5; cursor: default; }
+.agent-chat-send.ac-busy { background: var(--color-danger, #f87171); }
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
new file mode 100644
index 00000000..0b83f7a5
--- /dev/null
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -0,0 +1,351 @@
+/**
+ * Floating agent-chat window — the web-side control surface.
+ *
+ * Connects to the same /ws/agent bridge the TUI uses, streams the agent's
+ * responses, and renders interactive choice pickers. A single-driver control
+ * lock on the server arbitrates who may drive the microscope; this client
+ * shows a banner and offers "Take control" when another client holds it.
+ *
+ * Self-contained IIFE (no build step). All untrusted text is escaped before
+ * insertion — never assign agent/user/tool strings to innerHTML directly.
+ */
+const AgentChat = (() => {
+    let ws = null;
+    let reconnectDelay = 1000;
+    const MAX_DELAY = 30000;
+
+    let panelOpen = false;
+    let hasControl = true;        // optimistic until the server says otherwise
+    let holderLabel = null;
+    let streaming = false;
+    let currentAgentEl = null;    // the agent bubble currently being streamed into
+    let thinkingEl = null;
+
+    // DOM refs (resolved in init)
+    let fab, panel, log, input, sendBtn, connDot, banner, closeBtn;
+
+    // ── Safe rendering ────────────────────────────────────────
+    function escapeHtml(s) {
+        const d = document.createElement('div');
+        d.textContent = String(s == null ? '' : s);
+        return d.innerHTML;
+    }
+
+    /** Minimal, safe markdown: escape first, then a few inline transforms. */
+    function mdToHtml(text) {
+        let html = escapeHtml(text);
+        html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
+        html = html.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+        html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
+        html = html.replace(/\n/g, '<br>');
+        return html;
+    }
+
+    // ── Message helpers ───────────────────────────────────────
+    function scrollToBottom() {
+        log.scrollTop = log.scrollHeight;
+    }
+
+    function addBubble(role, htmlOrText, { html = false } = {}) {
+        const el = document.createElement('div');
+        el.className = `ac-msg ac-${role}`;
+        if (html) el.innerHTML = htmlOrText;
+        else el.textContent = htmlOrText;
+        log.appendChild(el);
+        scrollToBottom();
+        return el;
+    }
+
+    function addSystemLine(text, level = 'info') {
+        const el = document.createElement('div');
+        el.className = `ac-system ac-level-${level}`;
+        el.textContent = text;
+        log.appendChild(el);
+        scrollToBottom();
+        return el;
+    }
+
+    function clearThinking() {
+        if (thinkingEl && thinkingEl.parentNode) thinkingEl.parentNode.removeChild(thinkingEl);
+        thinkingEl = null;
+    }
+
+    // ── Protocol handlers ─────────────────────────────────────
+    function handle(msg) {
+        switch (msg.type) {
+            case 'connected':
+                reconnectDelay = 1000;
+                setConn(true);
+                // version / session in the header tooltip
+                if (msg.version) connDot.title = `connected · v${msg.version}`;
+                break;
+
+            case 'control_status':
+                hasControl = !!msg.you_have_control;
+                holderLabel = msg.holder_label || null;
+                renderControl();
+                break;
+
+            case 'stream_start':
+                streaming = true;
+                clearThinking();
+                currentAgentEl = null;  // created lazily on first text
+                setBusy(true);
+                break;
+
+            case 'thinking':
+                if (!thinkingEl) {
+                    thinkingEl = document.createElement('div');
+                    thinkingEl.className = 'ac-thinking';
+                    thinkingEl.textContent = 'thinking…';
+                    log.appendChild(thinkingEl);
+                    scrollToBottom();
+                }
+                break;
+
+            case 'text': {
+                clearThinking();
+                if (!currentAgentEl) {
+                    currentAgentEl = addBubble('agent', '', { html: true });
+                    currentAgentEl._raw = '';
+                }
+                currentAgentEl._raw += (msg.text || '');
+                currentAgentEl.innerHTML = mdToHtml(currentAgentEl._raw);
+                scrollToBottom();
+                break;
+            }
+
+            case 'tool_start': {
+                clearThinking();
+                const label = msg.tool_label || msg.tool_name || 'tool';
+                const el = document.createElement('div');
+                el.className = 'ac-tool ac-tool-running';
+                el.dataset.tool = msg.tool_name || '';
+                el.innerHTML = `<span class="ac-tool-spin">⚙</span> ${escapeHtml(label)}…`;
+                log.appendChild(el);
+                scrollToBottom();
+                break;
+            }
+
+            case 'tool_call': {
+                // Mark the most recent running entry for this tool as done.
+                const running = [...log.querySelectorAll('.ac-tool-running')]
+                    .filter(e => e.dataset.tool === (msg.tool_name || ''));
+                const el = running[running.length - 1];
+                const label = msg.tool_name || 'tool';
+                const dur = msg.duration ? ` · ${msg.duration.toFixed ? msg.duration.toFixed(1) : msg.duration}s` : '';
+                const summary = msg.result_summary ? ` — ${escapeHtml(msg.result_summary)}` : '';
+                if (el) {
+                    el.className = 'ac-tool ac-tool-done';
+                    el.innerHTML = `<span class="ac-tool-check">✓</span> ${escapeHtml(label)}${dur}${summary}`;
+                } else {
+                    addBubble('tool', `✓ ${escapeHtml(label)}${dur}${summary}`, { html: true });
+                }
+                scrollToBottom();
+                break;
+            }
+
+            case 'choice_request':
+                renderChoice(msg);
+                break;
+
+            case 'applied_spec':
+                renderSpec(msg.spec || {});
+                break;
+
+            case 'stream_end':
+                streaming = false;
+                clearThinking();
+                currentAgentEl = null;
+                setBusy(false);
+                break;
+
+            case 'command_result':
+                if (msg.error) addSystemLine(`${msg.command}: ${msg.error}`, 'error');
+                else if (msg.content) addSystemLine(`${msg.command} ✓`, 'info');
+                break;
+
+            case 'notification':
+                addSystemLine(msg.body ? `${msg.title} — ${msg.body}` : msg.title, msg.level || 'info');
+                break;
+
+            case 'error':
+                streaming = false;
+                setBusy(false);
+                addSystemLine(msg.error || 'Unknown error', 'error');
+                break;
+
+            case 'ping':
+                send({ type: 'pong' });
+                break;
+
+            case 'pong':
+            case 'state_update':
+            case 'browse_result':
+                break;  // not surfaced in the chat window (yet)
+
+            default:
+                break;  // unknown types ignored (forward-compatible)
+        }
+    }
+
+    function renderChoice(msg) {
+        clearThinking();
+        const data = msg.choice_data || {};
+        const reqId = msg.request_id || data.request_id || '';
+        const wrap = document.createElement('div');
+        wrap.className = 'ac-choice';
+        const q = document.createElement('div');
+        q.className = 'ac-choice-q';
+        q.innerHTML = mdToHtml(data.question || 'Choose:');
+        wrap.appendChild(q);
+
+        (data.options || []).forEach(opt => {
+            const btn = document.createElement('button');
+            btn.className = 'ac-choice-opt';
+            btn.disabled = !!opt.disabled;
+            const desc = opt.description ? `<span class="ac-choice-desc">${escapeHtml(opt.description)}</span>` : '';
+            btn.innerHTML = `<span class="ac-choice-label">${escapeHtml(opt.label)}</span>${desc}`;
+            btn.addEventListener('click', () => {
+                send({ type: 'choice_response', request_id: reqId, selected: opt.id });
+                // lock the picker and show the pick
+                [...wrap.querySelectorAll('button')].forEach(b => b.disabled = true);
+                wrap.classList.add('ac-choice-answered');
+                btn.classList.add('ac-choice-picked');
+            });
+            wrap.appendChild(btn);
+        });
+        log.appendChild(wrap);
+        scrollToBottom();
+    }
+
+    function renderSpec(spec) {
+        const rows = [];
+        const add = (k, v) => { if (v !== undefined && v !== null && v !== '') rows.push([k, v]); };
+        add('strain', spec.strain);
+        add('temp °C', spec.temperature_c);
+        add('slices', spec.num_slices);
+        add('exposure ms', spec.exposure_ms);
+        add('interval s', spec.interval_s);
+        add('stop at', spec.stop_condition);
+        if (!rows.length) return;
+        const html = '<div class="ac-spec-title">Imaging spec applied</div>' +
+            rows.map(([k, v]) => `<div class="ac-spec-row"><span>${escapeHtml(k)}</span><span>${escapeHtml(v)}</span></div>`).join('');
+        addBubble('spec', html, { html: true });
+    }
+
+    // ── Control / UI state ────────────────────────────────────
+    function renderControl() {
+        if (hasControl) {
+            banner.classList.add('hidden');
+            banner.innerHTML = '';
+            input.disabled = false;
+            sendBtn.disabled = false;
+            input.placeholder = 'Message the agent…';
+        } else {
+            banner.classList.remove('hidden');
+            const who = holderLabel || 'another client';
+            banner.innerHTML = `<span>🔒 ${escapeHtml(who)} is driving</span>`;
+            const btn = document.createElement('button');
+            btn.className = 'ac-take-control';
+            btn.textContent = 'Take control';
+            btn.addEventListener('click', () => send({ type: 'take_control' }));
+            banner.appendChild(btn);
+            input.disabled = true;
+            sendBtn.disabled = true;
+            input.placeholder = 'Viewing only — take control to drive…';
+        }
+    }
+
+    function setBusy(busy) {
+        sendBtn.textContent = busy ? 'Stop' : 'Send';
+        sendBtn.classList.toggle('ac-busy', busy);
+    }
+
+    function setConn(ok) {
+        connDot.classList.toggle('ac-conn-ok', ok);
+        connDot.classList.toggle('ac-conn-bad', !ok);
+        if (!ok) connDot.title = 'reconnecting…';
+    }
+
+    // ── Transport ─────────────────────────────────────────────
+    function send(obj) {
+        if (ws && ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify(obj));
+    }
+
+    function connect() {
+        const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
+        ws = new WebSocket(`${proto}//${location.host}/ws/agent`);
+        ws.onopen = () => { reconnectDelay = 1000; setConn(true); };
+        ws.onclose = () => {
+            setConn(false);
+            setBusy(false);
+            streaming = false;
+            setTimeout(connect, reconnectDelay);
+            reconnectDelay = Math.min(reconnectDelay * 2, MAX_DELAY);
+        };
+        ws.onerror = () => {};
+        ws.onmessage = (e) => {
+            let msg;
+            try { msg = JSON.parse(e.data); } catch { return; }
+            handle(msg);
+        };
+    }
+
+    // ── Input handling ────────────────────────────────────────
+    function submit() {
+        if (streaming) { send({ type: 'cancel' }); return; }  // Send doubles as Stop
+        const text = input.value.trim();
+        if (!text) return;
+        if (!hasControl) { renderControl(); return; }
+        addBubble('user', text);
+        if (text.startsWith('/')) {
+            send({ type: 'command', command: text });  // slash commands (e.g. /status)
+        } else {
+            send({ type: 'chat', text });
+        }
+        input.value = '';
+        autosize();
+    }
+
+    function autosize() {
+        input.style.height = 'auto';
+        input.style.height = Math.min(input.scrollHeight, 140) + 'px';
+    }
+
+    function togglePanel(open) {
+        panelOpen = (open === undefined) ? !panelOpen : open;
+        panel.classList.toggle('hidden', !panelOpen);
+        fab.classList.toggle('ac-fab-active', panelOpen);
+        if (panelOpen) {
+            if (!ws) connect();
+            setTimeout(() => input.focus(), 50);
+        }
+    }
+
+    // ── Init ──────────────────────────────────────────────────
+    function init() {
+        fab = document.getElementById('agent-fab');
+        panel = document.getElementById('agent-chat');
+        log = document.getElementById('agent-chat-log');
+        input = document.getElementById('agent-chat-text');
+        sendBtn = document.getElementById('agent-chat-send');
+        connDot = document.getElementById('agent-chat-conn');
+        banner = document.getElementById('agent-control-banner');
+        closeBtn = document.getElementById('agent-chat-close');
+        if (!fab || !panel) return;  // markup not present
+
+        fab.addEventListener('click', () => togglePanel());
+        closeBtn.addEventListener('click', () => togglePanel(false));
+        sendBtn.addEventListener('click', submit);
+        input.addEventListener('input', autosize);
+        input.addEventListener('keydown', (e) => {
+            if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); submit(); }
+            if (e.key === 'Escape' && streaming) { e.preventDefault(); send({ type: 'cancel' }); }
+        });
+    }
+
+    document.addEventListener('DOMContentLoaded', init);
+
+    return { togglePanel };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index dd3bbfb0..6314d7a9 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -14,6 +14,7 @@
     <link rel="stylesheet" href="/static/css/campaigns.css">
     <link rel="stylesheet" href="/static/css/review.css">
     <link rel="stylesheet" href="/static/css/experiment.css">
+    <link rel="stylesheet" href="/static/css/agent-chat.css">
 </head>
 <body>
     {% include '_header.html' %}
@@ -499,6 +500,22 @@ <h3 class="devices-properties-title">Properties</h3>
     <!-- Ambient health pulse overlay -->
     <div class="ambient-pulse" id="ambient-pulse"></div>
 
+    <!-- Floating agent chat (web-side control surface) -->
+    <button id="agent-fab" class="agent-fab" title="Chat with Gently">✦</button>
+    <div id="agent-chat" class="agent-chat hidden">
+        <div class="agent-chat-header">
+            <span class="agent-chat-title">✦ Gently</span>
+            <span id="agent-chat-conn" class="agent-chat-conn ac-conn-bad" title="connecting…">●</span>
+            <button id="agent-chat-close" class="agent-chat-close" title="Close">×</button>
+        </div>
+        <div id="agent-control-banner" class="agent-control-banner hidden"></div>
+        <div id="agent-chat-log" class="agent-chat-log"></div>
+        <div class="agent-chat-input">
+            <textarea id="agent-chat-text" rows="1" placeholder="Message the agent…"></textarea>
+            <button id="agent-chat-send" class="agent-chat-send">Send</button>
+        </div>
+    </div>
+
     <script src="/static/js/utils.js"></script>
     <script src="/static/js/event-bus.js"></script>
     <script src="/static/js/websocket.js"></script>
@@ -519,5 +536,6 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/app.js"></script>
     <script src="/static/js/campaigns.js"></script>
     <script src="/static/js/review.js"></script>
+    <script src="/static/js/agent-chat.js"></script>
 </body>
 </html>
diff --git a/launch_gently.py b/launch_gently.py
index 1727dd2a..44e1e4bb 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -4,11 +4,16 @@
 
 Conversational AI agent for diSPIM microscope control.
 
+Starts the agent + web visualization server, then opens the browser UI.
+The web UI is the control surface (the legacy Ink TUI is retired — its
+source is kept in the tree but no longer launched).
+
 Usage:
-    python launch_gently.py                      # Ink TUI (default)
-    python launch_gently.py --offline
+    python launch_gently.py                      # Start server + open browser
+    python launch_gently.py --no-browser         # Start server, don't open a browser
+    python launch_gently.py --offline            # Run without the device layer
     python launch_gently.py --sessions           # List sessions and exit
-    python launch_gently.py --resume             # Interactive session picker
+    python launch_gently.py --resume             # Resume most recent session
     python launch_gently.py --resume latest      # Resume most recent session
     python launch_gently.py --resume <id>        # Resume specific session
     python launch_gently.py -v                   # Verbose (INFO) logging
@@ -89,10 +94,40 @@ def list_sessions(store: FileStore):
     print("Use: python launch_gently.py --resume <id>")
 
 
+def _print_banner(viz_url, device_connected, offline, storage_dir, log_file, resumed):
+    """Print a human-readable launch banner to the terminal.
+
+    This is the "what you see when you open it" surface now that the
+    server (not a TUI) is the long-running process.
+    """
+    line = "─" * 56
+    if offline:
+        dev = "○ offline (--offline)"
+    elif device_connected:
+        dev = "● connected"
+    else:
+        dev = "○ offline — run:  python start_device_layer.py"
+    url = viz_url or "(viz server failed to start — check the log)"
+    tag = "  [resumed session]" if resumed else ""
+    print()
+    print(f"  ✦ Gently is running.{tag}")
+    print(f"    {line}")
+    print(f"    Open:    {url}")
+    print(f"    Device:  {dev}")
+    print(f"    Storage: {storage_dir}")
+    print(f"    Logs:    {log_file}")
+    print(f"    Stop:    Ctrl-C")
+    print(f"    {line}")
+    print()
+
+
 def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
     """
     Spawn the Ink TUI in session-picker mode and capture the selection.
 
+    Retired: kept for reference / potential reuse by a future web session
+    picker. No longer called by the launcher.
+
     Returns the selected session ID, or None for a new session.
     """
     proc = subprocess.run(
@@ -116,7 +151,7 @@ def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
     return None
 
 
-async def main(offline: bool = False, resume_session: str = None, show_sessions: bool = False, pick_session: bool = False, log_level: str = "WARNING"):
+async def main(offline: bool = False, resume_session: str = None, show_sessions: bool = False, pick_session: bool = False, log_level: str = "WARNING", no_browser: bool = False):
     # Set up log file in storage directory
     storage_base = Path(os.environ.get("GENTLY_STORAGE", "D:/Gently3"))
     log_dir = storage_base / "logs"
@@ -151,30 +186,20 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
         store.close()
         return
 
-    # Ensure TUI is available
-    tui_dist = Path(__file__).parent / "gently" / "tui" / "dist" / "index.js"
-    if not tui_dist.exists() or not shutil.which("node"):
-        print("Error: TUI not available.")
-        if not tui_dist.exists():
-            print("  Run: cd gently/tui && npm install && npm run build")
-        if not shutil.which("node"):
-            print("  Node.js not found in PATH")
-        store.close()
-        return
+    # Web-only: the TUI is retired. The browser is the control surface and
+    # the launcher just starts the server — no Node/dist requirement.
 
-    # Handle --resume (interactive picker, "latest", or specific session)
+    # Handle --resume. Interactive session picking has moved to the browser;
+    # without an explicit ID ("latest" or bare --resume) we resume the most
+    # recent session.
     session_to_resume = None
-    if pick_session:
-        # Two-phase launch: spawn Ink picker to select a session
-        items = _build_session_items(store)
-        if not items:
-            print("No saved sessions found. Starting new session.")
-        else:
-            session_to_resume = run_ink_picker(tui_dist, json.dumps(items))
-    elif resume_session == "latest":
+    if pick_session or resume_session == "latest":
         sessions = store.list_sessions()
         if sessions:
             session_to_resume = sessions[0].get("session_id")
+            if pick_session:
+                print(f"Resuming most recent session: {session_to_resume} "
+                      "(interactive session picking is moving into the browser)")
         else:
             print("No sessions found - starting fresh")
     elif resume_session:
@@ -391,29 +416,32 @@ def _status_provider():
         agent.viz_server.agent_bridge = bridge
         agent.viz_server.set_context_store(context_store)
 
-    ws_url = f"ws://localhost:{settings.network.viz_port}/ws/agent"
-
-    # Spawn the Node.js TUI — it inherits stdin/stdout/stderr so Ink
-    # takes over the terminal.
-    tui_proc = subprocess.Popen(
-        ["node", str(tui_dist), "--ws-url", ws_url],
-        stdin=sys.stdin,
-        stdout=sys.stdout,
-        stderr=sys.stderr,
+    # ── Banner + serve ──────────────────────────────────────────────
+    # The viz server runs in-process (uvicorn in a background task). With
+    # the TUI retired, the launcher's job is to keep that server alive and
+    # point the operator at the browser.
+    _print_banner(
+        viz_url=viz_url,
+        device_connected=bool(client and client.is_connected),
+        offline=offline,
+        storage_dir=storage_dir,
+        log_file=log_file,
+        resumed=session_to_resume is not None,
     )
 
-    try:
-        # Wait for TUI to exit (blocks the event loop in a thread so
-        # the asyncio loop stays responsive for the viz server).
-        exit_code = await asyncio.get_event_loop().run_in_executor(
-            None, tui_proc.wait
-        )
-    except (KeyboardInterrupt, asyncio.CancelledError):
-        tui_proc.terminate()
+    if viz_url and not no_browser:
         try:
-            tui_proc.wait(timeout=5)
+            import webbrowser
+            webbrowser.open(viz_url)
         except Exception:
             pass
+
+    try:
+        # Serve until interrupted (Ctrl-C). Keep the event loop alive so
+        # the in-process viz server keeps handling browser clients.
+        await asyncio.Event().wait()
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
     finally:
         # Suppress noisy CancelledError / overlapped IO errors from
         # uvicorn during shutdown on Windows.
@@ -448,6 +476,7 @@ def cli_main():
                         help="Resume a session. Without ID: shows picker. With ID: resumes that session.")
     parser.add_argument("-v", "--verbose", action="store_true", help="Enable verbose (INFO) logging")
     parser.add_argument("--debug", action="store_true", help="Enable debug logging (most verbose)")
+    parser.add_argument("--no-browser", action="store_true", help="Do not auto-open the web UI in a browser")
     args = parser.parse_args()
 
     log_level = "WARNING"
@@ -466,6 +495,7 @@ def cli_main():
             resume_session=resume_id,
             pick_session=pick_session,
             log_level=log_level,
+            no_browser=args.no_browser,
         ))
     except (KeyboardInterrupt, RuntimeError, SystemExit):
         pass

From 9460b785fc9641b27d200aa82ea38f9c5e5a2d54 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 28 May 2026 23:32:39 -0400
Subject: [PATCH 024/314] docs: add biologist-readiness plan

Consolidated plan from the codebase audit: robustness gaps, biologist-UX
gaps, complexity audit (legitimate vs refactorable + ~4000 lines of dead
duplicate code), frontend audit, startup/topology, multi-user auth +
single-driver control arbitration, a 5-day plan, the web-only convergence
roadmap (milestones A-F), and progress to date.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 notes/biologist-readiness-plan.md | 336 ++++++++++++++++++++++++++++++
 1 file changed, 336 insertions(+)
 create mode 100644 notes/biologist-readiness-plan.md

diff --git a/notes/biologist-readiness-plan.md b/notes/biologist-readiness-plan.md
new file mode 100644
index 00000000..00aae259
--- /dev/null
+++ b/notes/biologist-readiness-plan.md
@@ -0,0 +1,336 @@
+# Gently — Biologist-Readiness Plan
+
+> Engineering plan to make Gently more robust, easier for a non-programmer biologist to operate,
+> and to evolve it into a multi-user, web-first microscope control system.
+> Compiled from a codebase audit (architecture map, complexity audit of all >200-line files in `gently/`,
+> robustness + UX review, frontend audit, startup/topology trace, and auth/multi-user ground-truth).
+
+**Author:** engineering analysis · **Date:** 2026-05-28 · **Horizon:** 1 focused week + a multi-sprint convergence arc
+
+---
+
+## 0. Strategic decisions (already made)
+
+These are settled and shape everything below:
+
+1. **Frontend → converge on web-only.** The browser becomes the single surface (a floating agent chat window + the existing rich visuals). The Ink TUI becomes **legacy / maintenance-only** and is retired once the web reaches control parity. → *Do not invest in TUI refactors.*
+2. **Processes → keep the two-process split, improve feedback.** The device layer (`start_device_layer.py`) stays a separate process from the agent (`launch_gently.py`) — this isolation is a safety feature, not an accident. Fix the *visibility* of its state, not the topology.
+3. **Multi-user → LAN deployment, pluggable auth (no IT dependency to start).** Auth is a thin pluggable layer. Start with **Gently-managed accounts** (or shared/role tokens as an MVP) — needs nothing from institute IT. **Institute SSO (e.g. Janelia/HHMI login via a reverse proxy) is an optional later upgrade** that slots into the same layer if/when IT provides an endpoint. Gently owns the **control arbitration + roles + audit**, regardless of which login backend is used.
+4. **Roles → viewers vs operators.** Anyone authenticated can **watch** (today's read-only experience, unchanged). Only **operators** can take control and drive the microscope. **Admins** can force-release and manage roles.
+5. **Permission model → an explicit observable-vs-inputable classification.** Every endpoint/WS-message is tagged `observable` (read-only) or `inputable` (control). One registry drives all gating: viewer = observable set; operator-with-lock = observable + inputable. Adding a new action forces a classification; the audit log falls out of the `inputable` tag.
+6. **Plan shape → balanced.** Interleave robustness/UX hardening with safe, high-value refactors. Bold-but-safe: refactor where features *won't* break; add tests *before* touching anything that might.
+
+---
+
+## 1. Executive summary
+
+Gently is in **good architectural shape**. The hard parts (async acquisition state machine, hardware-safety code, the LLM loop) are well-factored. The problems that matter are **not "too complex"** — they are a handful of **silent, high-consequence failure modes**, an **opt-in/jargon UX that assumes a programmer**, and the **operational friction** of starting and using a multi-process, dual-frontend system. The web-only + multi-user direction resolves much of the friction *by construction* (e.g. it dissolves the embryo-marking hand-off and removes the Node dependency).
+
+**Top priorities, in order:**
+
+1. **Fix the verified, provable bugs** (status-tool KeyError, non-atomic writes, the silent device-down, the env-var split). Low risk, immediate value.
+2. **Wire crash/restart auto-resume** — the single biggest data-loss risk; the code already exists but is never called.
+3. **Harden transient-failure handling** (device hiccups, perception/Claude outages) so a brief blip doesn't silently end a run or image a dead embryo.
+4. **Make state visible** — live device heartbeat, connection banner, liveness line, acquisition-settings panel, armed-rules display.
+5. **Begin the web-only + multi-user arc** — browser agent chat, then the auth + single-driver control lock (the control lock must land *with* browser control, not after).
+
+---
+
+## 2. State of the codebase — legitimate vs. accidental complexity
+
+Most large files are **legitimately large** (broad-but-cohesive domain modules), not tangled. Accidental complexity is concentrated and well-localized.
+
+### Leave alone — legitimate complexity (high feature-break risk)
+- `harness/state.py` (979L) — shared mutable `EmbryoState`/`ExperimentState`. Splitting *creates* the duplication the design avoids. **Riskiest refactor target in the repo.**
+- `harness/conversation.py` (774L) — core LLM loop (asend-recursion, observed-failure guards).
+- `hardware/dispim/devices/*` (stage/optical/scanner/acquisition/camera/piezo) — laser/stage safety constants + MMCore vocab.
+- `hardware/dispim/plans/calibration.py` (958L) — irreducible multi-phase calibration state machine.
+- `core/imaging.py`, `event_bus.py`, `service.py`; `app/device_state_monitor.py`; `organisms/celegans/stages.py`.
+
+### Top refactor targets — accidental complexity worth fixing
+
+| File | Verdict | Risk | Effort | The fix |
+|---|---|---|---|---|
+| `app/tools/timelapse_tools.py` (815L) | REFACTORABLE | low | ~4h | Contains the confirmed KeyError bug. `@timelapse_tool` decorator kills the 6-line preamble in 17 tools; stop reaching into `orchestrator._embryo_states`. |
+| `app/tools/calibration_tools.py` (1504L) | REFACTORABLE | low | ~2h | Delete ~450 lines of **dead code** (`fast_calibrate_embryo`, `hybrid_focus_selection`, `binary_edge_search`, `_fine_focus_sweep`) — unregistered, uncalled, reference nonexistent agent attrs. |
+| `harness/bridge.py` (2215L) | REFACTORABLE | med | ~10h | God-object: 720-line `handle_command` if/elif ladder + case-folding bug (lowercases session/embryo IDs). Dispatch table off `CommandRegistry`. **High value for web convergence** — the browser control surface leans on this. |
+| `harness/detection/verifier.py` (1158L) | REFACTORABLE | med | ~6h | `verify()`/`verify_with_context()` + two `_evaluate_consensus*` are superset/subset dupes; 5 `_run_*` + 4 `_parse_*` copy-paste. ~250 lines. **Capture consensus truth-table fixtures first.** |
+| `mesh/peer_client.py` (393L) | REFACTORABLE | low | ~4h | 11 near-identical authed methods → one `_authed_json` helper (~270→~80 lines). |
+| `hardware/dispim/claude_client.py` (631L) | REFACTORABLE | low | ~3h | 4 vision methods copy-paste → one `_vision_call`. |
+| `harness/memory/file_store.py` (2552L) | MIXED | med | ~10h | Mixin split + shared serde. Lower priority than deleting the SQLite twin. |
+
+### The dominant *reduction* opportunity — ~4000 lines of dead duplicate code
+The **legacy SQLite store stack** is a complete duplicate of the live file stores (CLAUDE.md says "No SQLite databases"):
+- `core/store.py` (1064L) twins `core/file_store.py`
+- `harness/memory/{store,_intentions,_plans,_understanding,_ml_pipelines}.py` (~2960L) twin `harness/memory/file_store.py`
+
+Dead in production, pinned only by ~41 tests. Delete **after** migrating tests to the `file_context_store` fixture → ~4000 lines gone, zero runtime change. **Friday work** (gated on test migration).
+
+---
+
+## 3. Verified bugs (confirmed in source, not just inferred)
+
+| # | Bug | Location | Impact |
+|---|---|---|---|
+| V1 | `get_timelapse_status` reads `next_embryo`/`next_acquisition_in_seconds` that `to_dict()` never emits → **KeyError every call**. Same dead keys in `detection_tools.py`. | `app/tools/timelapse_tools.py:145-146,154` | Biologist's primary "is it working?" tool is broken. |
+| V2 | `load_state()` fully implemented, `save_state()` runs every acquisition — but `load_state()` has **zero callers**. | `app/orchestration/timelapse.py:1643` | **No crash/restart auto-resume.** Overnight crash = whole night lost. |
+| V3 | `_write_yaml` does `unlink()` then `rename()`; `save_state()` writes with no temp file. | `core/file_store.py:123-125` | **Non-atomic on Windows** — a power blip corrupts the files `/resume` needs. |
+| V4 | Launcher reads `GENTLY_STORAGE`; everything else uses `GENTLY_STORAGE_PATH`. | `launch_gently.py:121` | Logs and data silently split to different paths. |
+| V5 | Device-layer-down is a `logger.debug` (invisible at default log level). | `launch_gently.py:209-212` | Biologist starts with scope off, gets a normal-looking startup, discovers it mid-conversation. |
+| V6 | **XSS / HTML injection** — event key/value (perception prose, paths, agent text) assigned via `innerHTML` with no escaping. | `ui/web/static/js/events.js:69-77, 130-151, 237` | Real injection surface in the events table. `escapeHtml` exists and is used elsewhere. |
+| V7 | `/ws/agent` has **no connection guard/lock**; conversation state is a single shared object. | `routes/agent_ws.py:128`, `bridge.py:565`, `agent.py:759` | Latent today (TUI is sole client); **becomes live corruption the moment a browser drives the agent.** Fixed by the control lock (§9). |
+| V8 | `bridge.handle_command` does `command.strip().lower()` then branches on it. | `harness/bridge.py:647,696` | Case-sensitive args (session IDs, hostnames, embryo IDs) silently corrupted. |
+| V9 | Embryo marking blocks forever; `wait_for_marking(timeout=None)`; TUI never shows the viz URL or signals a browser is needed. | `ui/web/embryo_marker.py:79`, `server.py:481`, `detection_tools.py` | **Worst operational friction** — hangs if no browser is open. Dissolved by web-only convergence. |
+| V10 | Marking is global shared state broadcast to all `/ws` clients; any client's `marking_done` clobbers. | `server.py:459-472`, `websocket.py:164-188` | Two browsers marking simultaneously clobber each other. Fixed by driver-only gating (§9). |
+
+---
+
+## 4. Robustness gaps (ranked, for unattended multi-hour sessions)
+
+1. **[CRITICAL] No crash/restart auto-resume** (V2). `_resume_session` (`manager.py:40-117`) restores embryos+conversation but never the orchestrator or runtime fields (stop_condition, cadence_phase, next_due_at, error_count).
+2. **[CRITICAL] Device hiccup permanently drops embryos.** `_acquire_embryo` (`timelapse.py:712`) treats network/timeout as terminal; 3 strikes → `complete: errors`. No auto-reconnect in `client.py`.
+3. **[CRITICAL] Silent perception/detector outage.** `_run_perception`/`_run_detector` are log-only, no retry, no event. A Claude outage silently freezes stage/hatching detection **while the laser keeps firing.**
+4. **[HIGH] Non-atomic writes** (V3).
+5. **[HIGH] No abort path for a hung device-layer plan** — one RunEngine, no abort endpoint; one stuck acquisition freezes the wheel each round.
+6. **[HIGH] Disk-full silently stops persistence** — `save_state` failures are `logger.debug`.
+7. **[HIGH] Orphaned volume TIFFs** — swallowed `register_volume` failure + 300s `cleanup_incoming` race deletes valid volumes.
+8. **[HIGH] Unbounded fatal exception kills the whole session** — `_run_loop` top-level except → FAILED, no per-iteration recovery.
+9. **[MEDIUM]** Perception task leak / no per-call timeout (`timelapse.py:2706, 2483`).
+10. **[MEDIUM]** Startup picker / `wait_for_marking` block forever.
+11. **[MEDIUM]** Advisory `session.lock`, no PID check.
+
+---
+
+## 5. Biologist usability gaps (ranked)
+
+1. **[CRITICAL] "Microscope not connected" is silent** (V5). → persistent banner worded as consequence+fix; live heartbeat dot; `/reconnect`.
+2. **[CRITICAL] Phototoxicity protection is opt-in, silent, expert-only** — only arms if Claude is passed `monitoring_mode='expression_monitoring'`. → make it **default** for reporter/hatching experiments; agent states plainly what it armed; show armed rules in plain English.
+3. **[CRITICAL] No LLM-independent emergency stop** — pause/stop are only LLM tools. → `/stop` `/pause` that call the orchestrator directly (no API round-trip).
+4. **[HIGH] Silent auto-complete / auto-pause** — biologist must inspect `completion_reason`. → push plain-language notice; distinguish hardware-error (offer retry) from biological endpoint.
+5. **[HIGH] No liveness reassurance.** → "last volume 0:47 ago · next in 1:13" line, yellow/red when stalled.
+6. **[HIGH] Marking blocks with no browser cue** (V9).
+7. **[HIGH] Cryptic launch hard-stops** (`ANTHROPIC_API_KEY not set`, "TUI not available", Node/npm).
+8. **[HIGH] First-run setup landmines** — stale model IDs (`settings.py:55-58`), env-var split, raw `ModuleNotFoundError` on bad organism, README version drift (v0.11.0 vs 0.20.0). → `--doctor` preflight.
+9. **[MEDIUM]** Jargon mismatch (campaign/role=test/burst/SAM/photodose). → relabel human-facing strings.
+10. **[MEDIUM]** Stop-condition vocabulary mismatch ("pretzel"/"2fold" shown but rejected as targets); casing drift.
+11. **[MEDIUM]** Generic error strings (raw `str(e)`/tracebacks reach the biologist).
+
+---
+
+## 6. Frontend audit
+
+### Web UI (`gently/ui/web`) — the future single surface
+- **Stack:** vanilla JS, no build step, FastAPI + Jinja2, Three.js for 3D. ~15k JS / 21 `<script>` globals / ~12.5k CSS. Tabs: Embryos, Events, Calibration, Experiment, Plans, Sessions, Devices.
+- **Good infra:** `ClientEventBus` decoupling, exponential-backoff WS reconnect, connection manager + presence, clean `devices.js` IIFE, and `experiment-overview.js`'s `el()/elText()/svgEl()` DOM-builders.
+- **Refactor targets:** `embryos.js` (4,443L god-object — six concerns: state reconcile, four view renderers, copilot chat, markdown engine; cleanest cuts: `copilot-chat.js` + `markdown.js` low-risk ~½ day). Inline `innerHTML` everywhere (adopt the `el()` helpers). Dead code (`mode-toggle-preview.html`, the `#main-content` shortcut/help). 14 separate `DOMContentLoaded` handlers with global keydown collisions.
+- **Bugs:** V6 (XSS), Experiment tab `init()` double-fire, event double-display race (no dedup by `event_id`).
+
+### TUI (`gently/tui`) — LEGACY / maintenance-only
+- **Stack:** Ink 5 + React 18 + Zustand, `tsc` build. Well-architected (Static/active message split, hooks, typed protocol). 
+- **Decision: do NOT refactor.** Keep it working until the web reaches control parity, then retire the spawn from `launch_gently.py`. Skip the `StatusBar.tsx` split, dead-component cleanup, etc. — they're polish on a retiring component.
+- **The bugs that matter are the ones that affect parity/migration:** the stale device-connection dot (B1 — `device_connected` captured once at launch, never updated) and the missing live-state push — but the *fix* belongs in the shared backend (see §8), not the TUI.
+
+---
+
+## 7. Acquisition-settings UX (in the web UI)
+
+**Principle:** the sample is the primary object; acquisition settings are a collapsible "imaging recipe" attached to each sample, plus a global defaults header. A normal scope shows one global block; Gently's edge is *per-sample* settings — lean into that.
+
+**Already in the data model + persisted** (`EmbryoState` state.py:139-148, per-volume `meta.yaml` at `bridge.py:1045`): interval, exposure, num_slices, 488 power, mode, timepoints, cumulative dose; z-geometry from the calibration dict. `FileStore.get_latest_volume_metadata()` (`file_store.py:707`) returns it in one read-only call.
+
+**Surfaced today:** almost nothing. The web **Experiment tab** (`strategy_snapshot.py`) shows cadence/488-power/dose/timepoints; the Monitoring board is pure biology.
+
+**Missing from the model (needs new fields):** channels/wavelengths + 561/405/637 per-line power; objective, binning, camera ROI (pixel size is a hardcoded constant in `imaging.py`).
+
+**Design (Experiment tab):**
+```
+┌─ Imaging defaults ───────────────────────────────────────────┐
+│ Objective 40× · z 100µm/50 slices (2µm) · base 90s            │
+│ Channels: [488 ▓ 4%] [561 ▓ 6%]      ← colored wavelength chips│
+└───────────────────────────────────────────────────────────────┘
+▸ Sample e3   [comma stage · 0.82]  ●imaging          ← biology FIRST
+   dose ████████░░ 64% · 142 tp · last 0:47 · next 1:13
+   ▾ Imaging recipe (collapsed)                        ← settings SECOND
+       interval 90s · exposure 10ms · 50 slices
+       z: 50µm ± 25µm (step 2µm) · 488 @ 4%
+```
+- Wavelength chips colored by line (405 violet · 488 cyan · 561 yellow-green · 637 red) with live power %.
+- Biology stays the headline; recipe is a collapsible secondary row.
+- **Backend: mostly free** — add `num_slices` + `exposure_ms` to `_serialize_runtime_state` (`timelapse.py:1716`); also fixes the `_DEFAULT_PER_TP_MS=500` hardcode (`strategy_snapshot.py:46`). z-geometry + 488 power already on disk.
+
+---
+
+## 8. Generalization — beyond nuclear-stained *C. elegans*
+
+The architecture is **already substantially organism-pluggable** (recent work removed hardcoded celegans imports from the harness):
+- `OrganismProtocol` (`harness/protocols.py`), `load_organism()`/`get_organism()` driven by `config/config.yml`, a documented **build-a-plugin guide with a Drosophila example**.
+- The whole "8 stages" assumption is **encapsulated in `gently/organisms/celegans/`**. The orchestrator reads stage names via `get_organism()` — no hardcoded stage strings.
+- `SAMPLE_TERM`/`SAMPLE_TERM_PLURAL` already flows into prompts. **"Nuclear stain" is prose, not structure.** A non-nuclear reporter already runs via `dopaminergic_signal.py`.
+
+**Three real gaps:**
+1. 🔴 **External `gently_perception` is celegans-only.** `Perceiver()` takes no organism arg (`agent.py:129`); `plan_mode/tools/validation.py:115` imports `CELEGANS` directly. Crosses a repo boundary. *The one item that genuinely gates "any organism via the standard staging path."*
+2. 🟡 **Startup wizard lies** — the organism picker (`startup_wizard.py:156`) stores a free-text learning but never calls `load_organism()` / writes config. Correctness bug, low-risk fix.
+3. 🟡 **No channel/stain abstraction** — wavelengths exist only at the device layer + prose. **Same deliverable as §7's channel model** — build once, serves both.
+
+**Build the new UI generalization-ready:** sample noun from `SAMPLE_TERM` (web `index.html` currently hardcodes "Embryos"); stage chips from `organism.STAGES`; channels rendered as data, not assumptions.
+
+---
+
+## 9. Startup, topology, and multi-user auth
+
+### Process topology (factual)
+Three processes; the agent is the hub:
+- **Agent** (`launch_gently.py`) — asyncio loop + Claude agent; hosts the **uvicorn viz server in-process on :8080** (`/ws` browser, `/ws/agent` TUI/future-browser, `/api/mesh/*`); mesh UDP :19547; connects *out* to the device layer over HTTP.
+- **Device layer** (`start_device_layer.py`) — separate **manual** launch, HTTP :60610 (MMCore/Bluesky/SAM). The agent connects to it; does not spawn it. **Isolation is a safety feature — keep it.**
+- **Node TUI** — auto-spawned subprocess, connects back to `:8080/ws/agent`. (Retiring under web-only.)
+
+Ports (all in `settings.py`, env-overridable): viz **8080** (`viz_host` defaults to `0.0.0.0`), device **60610**, mesh UDP **19547**, transfer 19548.
+
+### Startup feedback fixes (keep 2 processes)
+- **Fix V5** (silent device-down) → loud message + persistent banner: *"Microscope offline — start it with `python start_device_layer.py`. I can plan/review but can't image."*
+- **`--doctor` preflight**: API key valid, device reachable + expected devices present, port 8080 free, storage writable + free space, model IDs current.
+- **Live device heartbeat in the protocol** — periodic `state_update` carrying live `device_connected` (+ last-volume timestamp) from `agent_ws.py`. Lights up the connection dot/banner everywhere. *(Shared fix behind the stale-dot frontend bug.)*
+- **`/reconnect`** so a late device-layer start doesn't force a relaunch.
+- **Unify `GENTLY_STORAGE` → `GENTLY_STORAGE_PATH`** (V4).
+- **Security:** with the reverse proxy in front, bind viz to `127.0.0.1`, lock CORS to the proxy origin, make mesh opt-in.
+
+### Current auth posture
+**None.** Plain HTTP on `0.0.0.0:8080`, wide-open CORS (`server.py:172-178`), anonymous self-asserted presence, **no guard on `/ws/agent`** (V7). The mesh has real auth (HMAC tokens + daily rotation + scopes + `Depends()` gating + audit + rate-limit) but it authenticates **machines** (instance_id, TLS cert, PIN ceremony), is localhost-exempt, and opens fully when no PairingManager exists.
+
+### Multi-user design (LAN, pluggable auth)
+
+Two separate problems: **authentication** (who are you) and **arbitration** (who drives the one microscope). Authentication is standard; arbitration is the hard, instrument-specific part.
+
+**Layer 0 — Transport:** TLS required once credentials cross the LAN. Either terminate TLS at a reverse proxy (if one is used) or wire the existing mesh cert into `start_viz_server` (the constructor already accepts `ssl_certfile/keyfile` — `launch_gently.py:252` just never passes them). Bind viz to `127.0.0.1` if behind a proxy; lock CORS (`server.py:172-178`).
+
+**Layer 1 — Authentication (PLUGGABLE — no IT dependency to start).** A thin auth abstraction with interchangeable backends, in rough order of effort/strength:
+  - **A. Shared/role tokens (MVP):** an operator secret/link grants control; viewers just open the page (or a view token). Crude, zero external deps, works day one.
+  - **B. Gently-managed accounts (recommended start):** a small user list (user → role → password/token) + a login page. No external system, fully under lab control. Fine for a trusted LAN; you own credential storage + TLS.
+  - **C. Self-hosted login (Authelia/Authentik, or "Sign in with Google"):** your own user list or Google-Workspace login, run as a reverse proxy. Real identities, no institute IT.
+  - **D. Institute SSO (Janelia/HHMI) via reverse proxy:** Gently trusts a verified `X-Forwarded-Email` header. Strongest, real verified identities, IT manages accounts — **but depends on an IT-provided SSO endpoint (OIDC/SAML) + a rig hostname/cert.** Optional later upgrade.
+  
+  *Decision: build the layer so A/B work now and D can slot in later. Do not block the project on institute IT.* No password storage if/when D is used.
+
+**Layer 2 — Identity replaces anonymity:** swap presence's `Anonymous {id}` (`connection_manager.py`) for the authenticated user. Presence UI stays; identity becomes trustworthy.
+
+**Layer 2.5 — The observable/inputable registry (permission backbone).** Classify every endpoint and WS-message as **`observable`** (read-only) or **`inputable`** (control), in one registry. All gating derives from this single source: viewer = observable set; operator-with-lock = observable + inputable. Adding an action forces a classification; the audit log falls out of the `inputable` tag. Inventory:
+  - **OBSERVABLE:** live images/projections/3D volumes/galleries/filmstrips; monitoring board; events/system tables; reasoning/strategy panels + plots; device *status*/property tables/stage map; sessions/campaigns/plans (view) + acquisition-settings recipe (view); presence; the agent transcript (watch the stream).
+  - **INPUTABLE:** the agent chat `/ws/agent` (master control); start/stop/pause timelapse, run plans, move stage; embryo marking (place/edit/roles); bottom-camera start/stop; detector config; campaign mutations (share/join/claim/status); emergency `/stop` `/pause`; perception follow-up chat (cost).
+
+**Layer 3 — Control arbitration (the core): single-driver "control lock."**
+```
+        ┌─ FREE ──────────────────────────────┐
+        │   any OPERATOR → "Take control"      │
+        ▼                                       │
+   HELD by user A  ──A "Release"──────────────► FREE
+        │  ▲                                     ▲
+        │  └── B "Request control" → A approves ─┘ (handoff)
+        │
+        └── A disconnects → GRACE (~60s, esp. mid-acquisition)
+                              → reclaim if A returns, else FREE
+                              → ADMIN can force-release
+```
+- Many browsers connect to `/ws/agent`; **only the lock-holder's messages drive the agent.** Everyone else watches the same shared conversation live ("🔒 Dr. Chen is driving — Request control").
+- **Acquisition-aware:** don't drop the lock on a network blip during an unattended run (grace period); confirm before a handoff interrupts a running acquisition.
+- **This is the missing guard** — fixes V7 (conversation corruption) and V10 (marking clobber → driver-only).
+
+**Layer 4 — Roles (viewers vs operators — per the requirement):**
+- **viewer** — authenticated, **read-only; today's rich watching experience unchanged** (images, volumes, monitoring, events). The default for most users.
+- **operator** — viewer + can take the control lock and drive the scope.
+- **admin** — operator + force-release + manage roles.
+Gate the mutating set (`/ws/agent` chat, marking, bottom-camera, campaign mutations, perception chat-cost) with operator + lock, using the proven `Depends()` pattern. Read endpoints stay open to any authenticated user.
+
+**Layer 5 — Audit:** reuse the mesh audit log so every hardware-affecting action is attributed to a user.
+
+---
+
+## 10. THE 5-DAY PLAN (next week, one engineer)
+
+Quick wins and verified bugs first; the resume wiring gets its test net before it ships; the big deletion is last and gated on test migration. **Tests are added before any medium/high-risk change. No TUI refactors.**
+
+### MONDAY — Verified bugs & quick wins *(no new risk)*
+- Fix **V1** (`get_timelapse_status` KeyError) — align keys with `to_dict()`; audit `detection_tools.py`; add a smoke test.
+- Fix **V3** (crash-safe writes) — temp-file → `flush`+`os.fsync` → `os.replace()`; keep one `.bak`; make `_read_yaml` raise on corruption for critical files.
+- Fix **V4** (unify storage env var); log `Storage: <path>` at startup.
+- Fix **V6** (XSS) — route event key/value through `escapeHtml` (`events.js`).
+- Fix **V5** (silent device-down) — loud message at WARNING+.
+- Delete dead calibration code (~450 lines, `calibration_tools.py`) — Grep-confirm zero callers.
+- Friendly config errors (`organisms/__init__.py:46`, `hardware/__init__.py:46`).
+- **Done when:** status tool returns clean in a smoke test; killing mid-write never corrupts YAML; data+logs share a path; events table renders `<` literally; calibration tests pass.
+
+### TUESDAY — Acquisition auto-resume (#1 data-loss risk) + its test net
+- **Tests FIRST:** round-trip `save_state()`/`load_state()` (populate orchestrator → reload fresh → assert cadence/stop/error fields).
+- Wire **V2** — `orchestrator.resume_acquisition()` from `manager._resume_session`: restore runtime fields, re-point `_embryo_states` at shared `EmbryoState`, restart `_run_loop()` if saved status was RUNNING.
+- Confirm-on-resume banner: *"Previous run was acquiring N embryos (last 3h ago). Resume? [Resume] [Review only]"*.
+- **Done when:** round-trip test passes; simulated crash + relaunch restarts the loop with correct cadence; "Review only" stays stopped.
+
+### WEDNESDAY — Device & perception failure hardening
+- Distinguish transient vs terminal errors in `_acquire_embryo` (~712-878): network/timeout → pause + surfaced event; only genuine bad images count toward 3-strike completion.
+- Client auto-reconnect (`client.py`) — exponential-backoff re-poll of `/api/status`.
+- Retry + timeout on autonomous Claude calls (`_run_perception` ~2643, `_run_detector` ~2441, perceiver ~2706, detector.run ~2483): `asyncio.wait_for(...)` + bounded retry; emit `PERCEPTION_DEGRADED`; semaphore on concurrent perception.
+- Per-iteration loop guard (`_run_loop` ~703-710): continue on per-embryo error; reserve FAILED for unrecoverable.
+- **Done when:** simulated disconnect pauses (not drops) embryos and self-heals; simulated 429 retries then emits `PERCEPTION_DEGRADED`; one embryo's exception doesn't kill the others.
+
+### THURSDAY — Visibility & trust (web + shared backend)
+- **Live device heartbeat** in the protocol (periodic `state_update` w/ `device_connected` + last-volume ts) — the shared fix behind the stale dot.
+- **Web connection banner + `/reconnect`** driven by the heartbeat; liveness line ("last volume 0:47 ago · next 1:13", red when stalled).
+- **Acquisition-settings panel** on the web Experiment tab (§7) — add `num_slices`/`exposure_ms` to `_serialize_runtime_state`, render the recipe + wavelength chips. Mostly free.
+- **LLM-independent `/stop` `/pause`** through the bridge (no API round-trip).
+- **Surface armed adaptive rules** in plain English; warn if a precious sample has none.
+- **Done when:** disconnecting the device shows the banner and `/reconnect` works; status shows live time-since-last-volume; the Experiment tab shows per-sample recipe + channels; `/stop` halts a run with the API mid-stream.
+
+### FRIDAY — Safe, high-value reduction *(gated on test migration)*
+- Migrate the ~41 SQLite-store tests onto the `file_context_store` fixture.
+- Delete the SQLite stack (~4000 lines) once green; grep-confirm no live importer.
+- If time: `peer_client.py` `_authed_json` extraction.
+- **Done when:** full suite passes with SQLite files deleted; agent runs a session normally.
+
+> **Note on scope:** the web-only convergence and multi-user auth (below) are a **multi-sprint arc**, not part of this week. Next week stabilizes the system; the arc transforms it.
+
+---
+
+## 11. The web-only + multi-user convergence roadmap (post-week)
+
+Incremental — the backend protocol for agent control already exists (`/ws/agent`); the browser becomes a second client.
+
+**Milestone A — Browser agent chat.** Floating chat window in the web UI connecting to `/ws/agent` with streaming (text/thinking/tool calls). Build on the copilot-chat scaffolding in `embryos.js`.
+
+**Milestone B — Auth + control lock (MUST land with/before A in production).** TLS + a pluggable auth backend (start with Gently-managed accounts / tokens — §9 Layer 1) + the observable/inputable registry + the **single-driver control lock** enforced at `/ws/agent`. This is the minimum that makes browser control *safe* (fixes V7). Browser chat without arbitration = the corruption bug in production. (Institute SSO is a later drop-in, not a prerequisite.)
+
+**Milestone C — Interactive flows in the browser.** Choice pickers (plan approval, session resolution), applied-spec cards, token/cost. Port slash commands to **GUI affordances** (a biologist shouldn't type `/timelapse`).
+
+**Milestone D — Roles + audit.** viewer/operator/admin (§9 Layer 4), per-action gating, request-control handoff UX, admin override, attributed audit log.
+
+**Milestone E — Retire the TUI.** Once parity is reached, drop the TUI spawn from `launch_gently.py`; delete the duplicated markdown/campaign/spec renderers. **Bonus: removes the Node/npm precondition entirely.**
+
+**Parity checklist before retiring the TUI:** chat streaming · slash-command equivalents · choice pickers · startup wizard · session resolution/resume · applied-spec display · token/cost · campaign browse.
+
+**Milestone F — Reshape `launch_gently.py` into a service launcher.** Once the TUI is gone, the launcher's job changes from "spawn a terminal app" to "start a server you point a browser at."
+- *What it does:* `--doctor` preflight (API key, device reachable + expected devices, port free, storage writable + free space, auth configured) → start agent + viz server → **block on the server, not a TUI subprocess** → print a human banner (URL · device status · storage · "Ctrl-C to stop") → optionally `webbrowser.open` unless `--no-browser` → clean shutdown on Ctrl-C.
+- *Delete/migrate:* the Node-on-PATH + `dist/index.js` checks (~155-163, **removes the Node dependency**); `run_ink_picker()` + the `--resume` Ink picker (session picking moves to the browser); `subprocess.Popen(["node", ...])` + `tui_proc.wait()` (~398-410, replaced by awaiting the server); repurpose `set_launch_info(...)` to feed the web connection banner/heartbeat.
+- *Browser landing flow (replaces the TUI startup sequence):* a session picker/dashboard landing page (replaces the Ink `--resume` picker); the startup wizard as a web modal (hostable in the floating chat); **first-run auth bootstrap** — create an admin + print a one-time setup link in the terminal banner.
+- *Modes preserved:* `--offline`, `--sessions`, `--resume <id>` (now pre-selects what the browser opens into), plus new `--doctor` and `--no-browser`.
+- *Mental model shift:* "open it → a terminal app appears" → "open it → a server starts; you and labmates point browsers at it." Cleaner for a LAN multi-user instrument.
+
+### Progress
+- **[done] Milestone A (start):** floating agent-chat window in the web UI (`static/js/agent-chat.js`, `static/css/agent-chat.css`, wired into `index.html`) connecting to `/ws/agent` with streaming + choice pickers + applied-spec cards + slash-command routing, XSS-safe.
+- **[done] Milestone B (seed):** single-driver control lock in `routes/agent_ws.py` (holder drives; observers get a "Take control" banner; control passes on disconnect). Fixes latent V7. *Not yet gated by auth — that's the next increment.*
+- **[done] Milestone E/F (TUI retired + launcher reshaped):** `launch_gently.py` no longer spawns the Node TUI — it starts the agent + viz server, prints a launch banner (URL · device status [fixes V5] · storage · Ctrl-C), auto-opens the browser (`--no-browser` to suppress), and serves until interrupted. Node/dist requirement removed; `--resume`/bare `--resume` resolves to most-recent (interactive picker deferred to the web). TUI source kept in-tree (reversible), `run_ink_picker` retained for reference.
+- **[‼ NEXT] Auth gating:** with the TUI gone, the browser is the *only* control path and it is **unauthenticated on the LAN**. Bind viz to `127.0.0.1` or trust the LAN until self-managed accounts + viewer/operator roles land. This is now the top priority.
+
+---
+
+## 12. Backlog (valuable, not next week)
+
+**Robustness:** device-layer abort/`RE.stop` endpoint + client calling it on timeout; disk free-space check → `STORAGE_LOW/FULL` event + auto-pause; crash-safe `register_volume` + `cleanup_incoming` quarantine; live-PID lock check; startup-picker/marking timeouts.
+
+**Usability/setup:** phototoxicity protection **default** for reporter/hatching experiments; `--doctor`; startup model-ID preflight; lean core install (move torch/SAM to a `[device]` extra); README version single-sourcing; jargon relabeling; stop-condition vocabulary + perceiver/STOP_CONDITIONS self-check; consequence+next-step error wrapping.
+
+**Generalization:** per-sample **channels/wavelengths/per-line-power model** (+ objective/binning) into `EmbryoState`/volume metadata — the "looks like microscope software" deliverable *and* the stain generalizer; **parameterize `gently_perception`** for non-celegans (cross-repo); wire startup wizard → `load_organism()`; route `validation.py` through `get_organism()`; reconcile the two `DevelopmentalStage` enums.
+
+**Refactors (after their tests; medium risk):** `bridge.py` dispatch table + case-fold fix (high value for web control); `verifier.py` consensus dedup (capture truth-table fixtures first; preserve `ensemble_size=50` + conservative on-error defaults); `timelapse.py` rule `to_dict()/from_dict()` then `TimelapseStatePersister` + `RuleEngine`; `file_store.py` mixin split; `device_layer.py` `@json_endpoint`; `claude_client.py` `_vision_call`; consolidate pixel→stage math (duplicated 4×) into `gently.core.coordinates`; web `embryos.js` split (`copilot-chat.js`, `markdown.js`, `embryo-views.js`).
+
+---
+
+## Key file reference
+`app/orchestration/timelapse.py` (load_state:1643, _run_loop:703, _acquire_embryo:712, save_state:~1635, _serialize_runtime_state:1685/1716) · `app/tools/timelapse_tools.py:145-146` · `core/file_store.py:111-132, 707` · `harness/session/manager.py:40-117` · `launch_gently.py:121,209-212,252,394,398` · `harness/bridge.py:565,627-1346,647` · `hardware/dispim/client.py` · `ui/web/server.py:172-178,459-502,624-633` · `ui/web/routes/{agent_ws.py:126,websocket.py,chat.py}` · `ui/web/embryo_marker.py:79` · `ui/web/static/js/{embryos.js,events.js:69-151,marking.js}` · `mesh/{pairing.py,routes.py:35-90}` · `organisms/__init__.py`, `organisms/celegans/stages.py` · `harness/protocols.py` · `app/agent.py:129` · `settings.py:32-33,55-58,64`.

From 99fb0738e96b2886a87c2673dfb0b79aa7a0d84e Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:06:48 -0400
Subject: [PATCH 025/314] feat(web): self-managed auth + chat activity
 indicator + branding
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Auth — self-managed accounts gating the control surface:
- accounts.py: file-backed user store (PBKDF2 password hashing, HMAC-signed
  session cookies, first-run admin bootstrap); roles viewer/operator/admin.
- auth.py: resolve_role recognizes the session cookie in account mode
  (operator/admin -> control, else view); legacy localhost/token path kept
  when no accounts are configured.
- routes/auth_routes.py: /login page + /api/auth/login|logout|me and an
  admin-gated /api/auth/users.
- pages.py: main page redirects to /login when accounts require it.
- agent_ws.py: /ws/agent authenticates via the session cookie; only
  operators/admins may hold/take the control lock, viewers watch only; the
  holder label is now the username (fixes ambiguous "a browser window").
- launch_gently.py: initializes the account store and prints first-run admin
  credentials in the banner (GENTLY_NO_AUTH=1 disables auth).
- templates/login.html: clean on-brand sign-in page.

Chat UX:
- Activity indicator: instant "Working…/Thinking…" feedback with animated
  dots across the stream lifecycle; tool rows show spinner -> check.
- Professional restyle (Inter Tight / JetBrains Mono, role labels, status
  pill); brand cell/embryo favicon replaces the Gemini-like sparkle; dropped
  the "Microscope assistant" subtitle; header shows signed-in user + Sign out.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/accounts.py               | 190 +++++++++++++++
 gently/ui/web/auth.py                   |  41 +++-
 gently/ui/web/routes/__init__.py        |   2 +
 gently/ui/web/routes/agent_ws.py        |  43 +++-
 gently/ui/web/routes/auth_routes.py     | 110 +++++++++
 gently/ui/web/routes/pages.py           |   7 +-
 gently/ui/web/static/css/agent-chat.css | 307 +++++++++++++-----------
 gently/ui/web/static/js/agent-chat.js   | 193 +++++++++------
 gently/ui/web/templates/index.html      |  17 +-
 gently/ui/web/templates/login.html      |  92 +++++++
 launch_gently.py                        |  21 ++
 11 files changed, 793 insertions(+), 230 deletions(-)
 create mode 100644 gently/ui/web/accounts.py
 create mode 100644 gently/ui/web/routes/auth_routes.py
 create mode 100644 gently/ui/web/templates/login.html

diff --git a/gently/ui/web/accounts.py b/gently/ui/web/accounts.py
new file mode 100644
index 00000000..2a534c44
--- /dev/null
+++ b/gently/ui/web/accounts.py
@@ -0,0 +1,190 @@
+"""Self-managed user accounts for the web UI.
+
+A small, dependency-free account store: users live in a YAML file under the
+storage directory (NOT the repo), passwords are PBKDF2-hashed, and browser
+sessions are stateless HMAC-signed cookies. This is the "self-managed
+accounts" backend chosen for the LAN deployment; institute SSO can be layered
+on later behind the same ``resolve_role`` surface in ``auth.py``.
+
+Roles
+-----
+  viewer    -- read-only. Sees everything (today's watching experience).
+  operator  -- viewer + may take the microscope control lock and drive.
+  admin     -- operator + may manage users.
+
+Layout (under <GENTLY_STORAGE>/auth/)
+  users.yaml   -- { users: { <name>: {role, salt, hash, iterations, created_at} } }
+  secret.key   -- random key used to sign session cookies (created on first run)
+"""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+import logging
+import secrets
+import time
+from datetime import datetime
+from pathlib import Path
+from typing import Optional, Tuple
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+ROLES = ("viewer", "operator", "admin")
+CONTROL_ROLES = frozenset({"operator", "admin"})
+_PBKDF2_ITERATIONS = 200_000
+_SESSION_TTL_SECONDS = 7 * 24 * 3600  # 1 week
+
+
+def _b64(raw: bytes) -> str:
+    return base64.urlsafe_b64encode(raw).decode("ascii").rstrip("=")
+
+
+def _unb64(s: str) -> bytes:
+    pad = "=" * (-len(s) % 4)
+    return base64.urlsafe_b64decode(s + pad)
+
+
+class AccountStore:
+    """File-backed user accounts + signed session tokens."""
+
+    def __init__(self, auth_dir: Path):
+        self.auth_dir = Path(auth_dir)
+        self.auth_dir.mkdir(parents=True, exist_ok=True)
+        self.users_path = self.auth_dir / "users.yaml"
+        self.secret_path = self.auth_dir / "secret.key"
+        self._users: dict = self._load_users()
+        self._secret: bytes = self._load_or_create_secret()
+
+    # ── Persistence ───────────────────────────────────────────
+    def _load_users(self) -> dict:
+        if not self.users_path.exists():
+            return {}
+        try:
+            data = yaml.safe_load(self.users_path.read_text(encoding="utf-8")) or {}
+            return data.get("users", {}) or {}
+        except Exception as e:
+            logger.error("Failed to read users.yaml: %s", e)
+            return {}
+
+    def _save_users(self) -> None:
+        tmp = self.users_path.with_suffix(".yaml.tmp")
+        tmp.write_text(yaml.safe_dump({"users": self._users}, sort_keys=True),
+                       encoding="utf-8")
+        tmp.replace(self.users_path)  # atomic
+
+    def _load_or_create_secret(self) -> bytes:
+        if self.secret_path.exists():
+            return self.secret_path.read_bytes()
+        secret = secrets.token_bytes(32)
+        self.secret_path.write_bytes(secret)
+        try:
+            self.secret_path.chmod(0o600)
+        except OSError:
+            pass  # best-effort on Windows
+        return secret
+
+    # ── Users ─────────────────────────────────────────────────
+    def has_users(self) -> bool:
+        return bool(self._users)
+
+    def list_users(self) -> list:
+        return [{"username": u, "role": r.get("role", "viewer")}
+                for u, r in sorted(self._users.items())]
+
+    def get_role(self, username: str) -> Optional[str]:
+        rec = self._users.get(username)
+        return rec.get("role") if rec else None
+
+    def _hash(self, password: str, salt: bytes, iterations: int) -> bytes:
+        return hashlib.pbkdf2_hmac("sha256", password.encode("utf-8"), salt, iterations)
+
+    def create_user(self, username: str, password: str, role: str = "viewer") -> None:
+        username = (username or "").strip()
+        if not username:
+            raise ValueError("username required")
+        if role not in ROLES:
+            raise ValueError(f"role must be one of {ROLES}")
+        salt = secrets.token_bytes(16)
+        self._users[username] = {
+            "role": role,
+            "salt": salt.hex(),
+            "hash": self._hash(password, salt, _PBKDF2_ITERATIONS).hex(),
+            "iterations": _PBKDF2_ITERATIONS,
+            "created_at": datetime.now().isoformat(timespec="seconds"),
+        }
+        self._save_users()
+
+    def verify_password(self, username: str, password: str) -> Optional[str]:
+        """Return the user's role if the password matches, else None."""
+        rec = self._users.get((username or "").strip())
+        if not rec:
+            return None
+        try:
+            salt = bytes.fromhex(rec["salt"])
+            expected = bytes.fromhex(rec["hash"])
+            iterations = int(rec.get("iterations", _PBKDF2_ITERATIONS))
+        except (KeyError, ValueError):
+            return None
+        candidate = self._hash(password, salt, iterations)
+        if hmac.compare_digest(candidate, expected):
+            return rec.get("role", "viewer")
+        return None
+
+    def bootstrap_admin_if_empty(self) -> Optional[Tuple[str, str]]:
+        """If no users exist, create an admin with a random password.
+
+        Returns (username, password) so the launcher can print it once, or
+        None if users already exist.
+        """
+        if self._users:
+            return None
+        password = secrets.token_urlsafe(12)
+        self.create_user("admin", password, role="admin")
+        logger.info("Bootstrapped default admin account")
+        return ("admin", password)
+
+    # ── Sessions (stateless signed cookie) ────────────────────
+    def issue_session(self, username: str, ttl: int = _SESSION_TTL_SECONDS) -> str:
+        expiry = int(time.time()) + ttl
+        payload = f"{username}|{expiry}".encode("utf-8")
+        sig = hmac.new(self._secret, payload, hashlib.sha256).digest()
+        return f"{_b64(payload)}.{_b64(sig)}"
+
+    def verify_session(self, token: str) -> Optional[str]:
+        """Return the username for a valid, unexpired token, else None."""
+        if not token or "." not in token:
+            return None
+        try:
+            payload_b64, sig_b64 = token.split(".", 1)
+            payload = _unb64(payload_b64)
+            sig = _unb64(sig_b64)
+        except Exception:
+            return None
+        expected = hmac.new(self._secret, payload, hashlib.sha256).digest()
+        if not hmac.compare_digest(sig, expected):
+            return None
+        try:
+            username, expiry_s = payload.decode("utf-8").rsplit("|", 1)
+            if int(expiry_s) < int(time.time()):
+                return None
+        except Exception:
+            return None
+        # The user may have been deleted since the token was issued.
+        return username if username in self._users else None
+
+
+# ── Module-level singleton (set during server init) ───────────
+_store: Optional[AccountStore] = None
+
+
+def set_account_store(store: Optional[AccountStore]) -> None:
+    global _store
+    _store = store
+
+
+def get_account_store() -> Optional[AccountStore]:
+    return _store
diff --git a/gently/ui/web/auth.py b/gently/ui/web/auth.py
index 7933c515..2f2d9927 100644
--- a/gently/ui/web/auth.py
+++ b/gently/ui/web/auth.py
@@ -33,18 +33,33 @@ async def foo(_=Depends(require_control)):
 
 _LOOPBACK_HOSTS = frozenset({"127.0.0.1", "::1", "localhost"})
 
-# Header name used to upgrade a remote session to control role. Single shared
-# token for now; per-user identities can be layered on later without changing
-# this module's public surface.
+# Header name used to upgrade a remote session to control role (legacy
+# single-shared-token path, used only when no user accounts are configured).
 _TOKEN_HEADER = "X-Gently-Token"
 _TOKEN_ENV    = "GENTLY_CONTROL_TOKEN"
 
+# Browser session cookie set by the login flow (see routes/auth_routes.py).
+SESSION_COOKIE = "gently_session"
+
 
 class Role(str, Enum):
     VIEW    = "view"
     CONTROL = "control"
 
 
+def current_username(request: Request) -> str | None:
+    """Return the authenticated username from the session cookie, or None.
+
+    None when no account store is configured or the cookie is missing/invalid.
+    """
+    from gently.ui.web.accounts import get_account_store
+    store = get_account_store()
+    if store is None:
+        return None
+    token = request.cookies.get(SESSION_COOKIE)
+    return store.verify_session(token) if token else None
+
+
 def _configured_token() -> str | None:
     """Return the shared control token, or None if no token is provisioned.
 
@@ -58,9 +73,25 @@ def _configured_token() -> str | None:
 def resolve_role(request: Request) -> Role:
     """Determine the effective role for a request.
 
-    Localhost is always control (the diSPIM box). Remote callers need to
-    present X-Gently-Token matching GENTLY_CONTROL_TOKEN.
+    Account mode (preferred): if user accounts are configured, identity comes
+    from the signed session cookie — operators/admins get control, everyone
+    else (including anonymous) gets view.
+
+    Legacy mode (no accounts configured): localhost is always control (the
+    diSPIM box); remote callers need X-Gently-Token matching
+    GENTLY_CONTROL_TOKEN. This keeps existing single-operator rigs working
+    until an admin provisions accounts.
     """
+    from gently.ui.web.accounts import get_account_store, CONTROL_ROLES
+    store = get_account_store()
+    if store is not None and store.has_users():
+        username = current_username(request)
+        if username:
+            role = store.get_role(username)
+            return Role.CONTROL if role in CONTROL_ROLES else Role.VIEW
+        return Role.VIEW
+
+    # Legacy mode — no accounts configured.
     client = request.client
     host = client.host if client else None
     if host in _LOOPBACK_HOSTS:
diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index 13f72b53..7b76f94d 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -16,12 +16,14 @@
 from .campaigns import create_router as create_campaigns_router
 from .chat import create_router as create_chat_router
 from .experiments import create_router as create_experiments_router
+from .auth_routes import create_router as create_auth_router
 
 
 def register_all_routes(server):
     """Register all route groups on the server's FastAPI app."""
     for factory in (
         create_pages_router,
+        create_auth_router,
         create_sessions_router,
         create_campaigns_router,
         create_experiments_router,
diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index d9b8d5cb..c29dfbce 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -162,12 +162,33 @@ async def agent_websocket(websocket: WebSocket):
             await websocket.close()
             return
 
-        # Assign a stable id for control arbitration. The first client to
-        # connect (in practice the TUI, spawned at launch) is labelled the
-        # terminal; later connections are browser windows.
+        # ── Authenticate the connection (account mode) ────────────
+        # When user accounts are configured, identity comes from the signed
+        # session cookie (set at login). Viewers may watch but not drive;
+        # operators/admins may take the control lock. With no accounts
+        # configured we fall back to the legacy "anyone connected can drive".
+        from gently.ui.web.accounts import get_account_store, CONTROL_ROLES
+        from gently.ui.web.auth import SESSION_COOKIE
+        _acct = get_account_store()
+        username = None
+        can_control = True  # legacy default
+        if _acct is not None and _acct.has_users():
+            _token = websocket.cookies.get(SESSION_COOKIE)
+            username = _acct.verify_session(_token) if _token else None
+            if username is None:
+                await websocket.send_json({
+                    "type": "error",
+                    "error": "Authentication required — please sign in.",
+                })
+                await websocket.close()
+                return
+            can_control = _acct.get_role(username) in CONTROL_ROLES
+
+        # Assign a stable id for control arbitration. The label shown to other
+        # clients is the username when authenticated, else a generic window id.
         _client_counter["n"] += 1
         client_id = f"agent_client_{_client_counter['n']}"
-        client_label = "the terminal" if _client_counter["n"] == 1 else "a browser window"
+        client_label = username or f"window {_client_counter['n']}"
 
         # Send connection metadata (version, tokens, embryo count, commands)
         meta = bridge.get_connect_metadata()
@@ -442,10 +463,11 @@ def choice_future_factory(choice_data: dict) -> asyncio.Future:
             _choice_futures[request_id] = future
             return future
 
-        # Register this client for control arbitration; grant control if free.
+        # Register this client for control arbitration; grant control if free
+        # (only to clients allowed to drive — viewers never auto-hold).
         _clients[client_id] = send_fn
         _client_labels[client_id] = client_label
-        if _control["holder"] is None:
+        if _control["holder"] is None and can_control:
             _control["holder"] = client_id
         await _broadcast_control_status()
 
@@ -540,6 +562,15 @@ async def _run_resolution_bootstrap():
                 # ── Control arbitration ───────────────────────────
                 # A client requesting the wheel.
                 if msg_type == "take_control":
+                    if not can_control:
+                        await send_fn({
+                            "type": "notification",
+                            "level": "warning",
+                            "title": "View-only role",
+                            "body": "Your account can watch but not control the microscope.",
+                        })
+                        await _broadcast_control_status()
+                        continue
                     prev = _control["holder"]
                     _control["holder"] = client_id
                     if prev and prev != client_id and prev in _clients:
diff --git a/gently/ui/web/routes/auth_routes.py b/gently/ui/web/routes/auth_routes.py
new file mode 100644
index 00000000..e7db5500
--- /dev/null
+++ b/gently/ui/web/routes/auth_routes.py
@@ -0,0 +1,110 @@
+"""Auth routes — login / logout / me, plus the login page.
+
+Self-managed accounts (see gently/ui/web/accounts.py). Login issues a signed
+session cookie; roles (viewer/operator/admin) gate control elsewhere via
+gently.ui.web.auth.resolve_role and the /ws/agent control lock.
+"""
+
+import logging
+
+from fastapi import APIRouter, Request
+from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse
+
+from gently.ui.web.accounts import get_account_store, CONTROL_ROLES, ROLES, _SESSION_TTL_SECONDS
+from gently.ui.web.auth import SESSION_COOKIE, current_username
+
+logger = logging.getLogger(__name__)
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _secure(request: Request) -> bool:
+        # Only mark the cookie Secure over HTTPS, else the browser drops it on
+        # plain-HTTP LAN deployments.
+        return request.url.scheme == "https"
+
+    @router.get("/login", response_class=HTMLResponse)
+    async def login_page(request: Request):
+        store = get_account_store()
+        if store is None or not store.has_users():
+            return RedirectResponse("/", status_code=302)
+        if current_username(request):
+            return RedirectResponse("/", status_code=302)
+        return server.templates.TemplateResponse("login.html", {"request": request})
+
+    @router.post("/api/auth/login")
+    async def login(request: Request):
+        store = get_account_store()
+        if store is None or not store.has_users():
+            return JSONResponse({"error": "accounts not configured"}, status_code=400)
+        try:
+            body = await request.json()
+        except Exception:
+            body = {}
+        username = (body.get("username") or "").strip()
+        password = body.get("password") or ""
+        role = store.verify_password(username, password)
+        if not role:
+            host = request.client.host if request.client else "?"
+            logger.warning("login failed for %r from %s", username, host)
+            return JSONResponse({"error": "Invalid username or password"}, status_code=401)
+        token = store.issue_session(username)
+        resp = JSONResponse({"ok": True, "username": username, "role": role})
+        resp.set_cookie(
+            SESSION_COOKIE, token,
+            httponly=True, samesite="lax", secure=_secure(request),
+            max_age=_SESSION_TTL_SECONDS, path="/",
+        )
+        logger.info("login ok: %s (%s)", username, role)
+        return resp
+
+    @router.post("/api/auth/logout")
+    async def logout(request: Request):
+        resp = JSONResponse({"ok": True})
+        resp.delete_cookie(SESSION_COOKIE, path="/")
+        return resp
+
+    @router.get("/api/auth/me")
+    async def me(request: Request):
+        store = get_account_store()
+        if store is None or not store.has_users():
+            return JSONResponse({"accounts": False, "authenticated": False})
+        username = current_username(request)
+        if not username:
+            return JSONResponse({"accounts": True, "authenticated": False})
+        role = store.get_role(username)
+        return JSONResponse({
+            "accounts": True, "authenticated": True,
+            "username": username, "role": role,
+            "can_control": role in CONTROL_ROLES,
+        })
+
+    @router.post("/api/auth/users")
+    async def create_user(request: Request):
+        """Admin-only: provision a new account."""
+        store = get_account_store()
+        if store is None:
+            return JSONResponse({"error": "accounts not configured"}, status_code=400)
+        requester = current_username(request)
+        if not requester or store.get_role(requester) != "admin":
+            return JSONResponse({"error": "admin role required"}, status_code=403)
+        try:
+            body = await request.json()
+        except Exception:
+            body = {}
+        new_user = (body.get("username") or "").strip()
+        password = body.get("password") or ""
+        role = body.get("role") or "viewer"
+        if not new_user or not password:
+            return JSONResponse({"error": "username and password required"}, status_code=400)
+        if role not in ROLES:
+            return JSONResponse({"error": f"role must be one of {list(ROLES)}"}, status_code=400)
+        try:
+            store.create_user(new_user, password, role)
+        except ValueError as e:
+            return JSONResponse({"error": str(e)}, status_code=400)
+        logger.info("admin %s created user %s (%s)", requester, new_user, role)
+        return JSONResponse({"ok": True, "username": new_user, "role": role})
+
+    return router
diff --git a/gently/ui/web/routes/pages.py b/gently/ui/web/routes/pages.py
index 1412e014..9c48912a 100644
--- a/gently/ui/web/routes/pages.py
+++ b/gently/ui/web/routes/pages.py
@@ -9,7 +9,12 @@ def create_router(server) -> APIRouter:
 
     @router.get("/", response_class=HTMLResponse)
     async def index(request: Request):
-        """Serve the main SPA page"""
+        """Serve the main SPA page (redirect to login if accounts require it)."""
+        from gently.ui.web.accounts import get_account_store
+        from gently.ui.web.auth import current_username
+        store = get_account_store()
+        if store is not None and store.has_users() and not current_username(request):
+            return RedirectResponse("/login", status_code=302)
         return server.templates.TemplateResponse(
             "index.html",
             {"request": request, "active_section": "embryos", "is_live": True}
diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index 99dbcf33..3fa05eb5 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -1,232 +1,257 @@
-/* Floating agent-chat window — the web-side control surface. */
+/* Floating agent-chat window — the web-side control surface.
+   Restrained, professional styling for a lab instrument. */
 
 .agent-fab {
     position: fixed;
-    right: 22px;
-    bottom: 22px;
-    width: 56px;
-    height: 56px;
-    border-radius: 50%;
-    border: none;
+    right: 24px;
+    bottom: 24px;
+    width: 52px;
+    height: 52px;
+    border-radius: 14px;
+    border: 1px solid var(--border);
     cursor: pointer;
     z-index: 1200;
-    font-size: 24px;
-    color: #fff;
-    background: var(--gradient-primary);
-    box-shadow: var(--shadow-glow-strong);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: var(--bg-card);
+    box-shadow: 0 6px 24px rgba(0, 0, 0, 0.4);
     transition: transform 0.15s ease, box-shadow 0.15s ease;
 }
-.agent-fab:hover { transform: translateY(-2px) scale(1.04); }
-.agent-fab.ac-fab-active { transform: rotate(45deg); }
+.agent-fab img { display: block; }
+.agent-fab:hover { transform: translateY(-2px); box-shadow: 0 10px 30px rgba(0, 0, 0, 0.5); }
+.agent-fab.ac-fab-active { opacity: 0.92; }
 
 .agent-chat {
     position: fixed;
-    right: 22px;
-    bottom: 90px;
-    width: 400px;
-    max-width: calc(100vw - 44px);
-    height: 560px;
-    max-height: calc(100vh - 130px);
+    right: 24px;
+    bottom: 88px;
+    width: 412px;
+    max-width: calc(100vw - 48px);
+    height: 600px;
+    max-height: calc(100vh - 128px);
     display: flex;
     flex-direction: column;
     background: var(--bg-card);
     border: 1px solid var(--border);
-    border-radius: 14px;
-    box-shadow: 0 12px 48px rgba(0, 0, 0, 0.45);
+    border-radius: 12px;
+    box-shadow: 0 16px 50px rgba(0, 0, 0, 0.5);
     z-index: 1199;
     overflow: hidden;
+    font-family: 'Inter Tight', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
 }
 .agent-chat.hidden, .agent-control-banner.hidden { display: none; }
 
+/* ── Header ─────────────────────────────────────────────── */
 .agent-chat-header {
     display: flex;
     align-items: center;
-    gap: 8px;
-    padding: 10px 14px;
+    gap: 10px;
+    padding: 12px 14px;
     border-bottom: 1px solid var(--border);
-    background: var(--bg-hover);
 }
-.agent-chat-title { font-weight: 600; color: var(--text); flex: 0 0 auto; }
-.agent-chat-conn { font-size: 11px; margin-left: 4px; color: var(--text-muted); }
-.agent-chat-conn.ac-conn-ok { color: var(--accent-green); }
-.agent-chat-conn.ac-conn-bad { color: var(--color-danger, #f87171); }
-.agent-chat-close {
+.agent-chat-id { display: flex; align-items: center; gap: 9px; }
+.agent-chat-mark { display: block; }
+.agent-chat-title { font-weight: 600; font-size: 14px; color: var(--text); letter-spacing: 0.01em; }
+.agent-chat-user {
+    font-size: 11px; color: var(--text-muted);
+    padding-left: 7px; margin-left: 1px;
+    border-left: 1px solid var(--border);
+}
+.agent-chat-user:empty { display: none; }
+.agent-chat-signout {
+    background: none; border: none;
+    color: var(--text-muted); font-size: 11px; cursor: pointer;
+    padding: 0 4px; font-family: inherit;
+}
+.agent-chat-signout:hover { color: var(--text); text-decoration: underline; }
+
+.agent-chat-conn {
     margin-left: auto;
-    background: none;
-    border: none;
+    font-size: 11px;
+    font-weight: 500;
+    padding: 3px 9px;
+    border-radius: 999px;
+    border: 1px solid var(--border);
     color: var(--text-muted);
-    font-size: 22px;
-    line-height: 1;
-    cursor: pointer;
+    white-space: nowrap;
+}
+.agent-chat-conn.ac-conn-ok { color: var(--accent-green); border-color: rgba(74, 222, 128, 0.35); }
+.agent-chat-conn.ac-conn-bad { color: var(--accent-orange, #fb923c); border-color: rgba(251, 146, 60, 0.35); }
+.agent-chat-close {
+    background: none; border: none;
+    color: var(--text-muted); font-size: 20px; line-height: 1;
+    cursor: pointer; padding: 0 2px;
 }
 .agent-chat-close:hover { color: var(--text); }
 
+/* ── Control banner ─────────────────────────────────────── */
 .agent-control-banner {
-    display: flex;
-    align-items: center;
-    gap: 10px;
-    padding: 8px 14px;
-    background: rgba(251, 146, 60, 0.12);
+    display: flex; align-items: center; gap: 10px;
+    padding: 9px 14px;
+    background: rgba(251, 146, 60, 0.10);
     border-bottom: 1px solid var(--border);
     color: var(--accent-orange, #fb923c);
-    font-size: 13px;
+    font-size: 12.5px;
 }
 .ac-take-control {
     margin-left: auto;
-    padding: 4px 12px;
-    border-radius: 8px;
+    padding: 4px 12px; border-radius: 7px;
     border: 1px solid var(--accent);
-    background: var(--accent);
-    color: #fff;
-    cursor: pointer;
-    font-size: 12px;
-    font-weight: 600;
+    background: var(--accent); color: #fff;
+    cursor: pointer; font-size: 12px; font-weight: 600;
 }
 .ac-take-control:hover { background: var(--accent-hover); }
 
+/* ── Transcript ─────────────────────────────────────────── */
 .agent-chat-log {
     flex: 1 1 auto;
     overflow-y: auto;
-    padding: 14px;
-    display: flex;
-    flex-direction: column;
-    gap: 8px;
-    font-size: 14px;
-    line-height: 1.5;
+    padding: 16px;
+    display: flex; flex-direction: column; gap: 14px;
+    font-size: 13.5px; line-height: 1.6;
+    color: var(--text);
 }
 
-.ac-msg {
-    padding: 8px 12px;
-    border-radius: 12px;
-    max-width: 90%;
-    word-wrap: break-word;
-    white-space: normal;
+.ac-turn { display: flex; flex-direction: column; }
+.ac-role {
+    font-size: 10.5px; font-weight: 600;
+    letter-spacing: 0.06em; text-transform: uppercase;
+    color: var(--accent-purple);
+    margin-bottom: 4px;
 }
-.ac-user {
-    align-self: flex-end;
-    background: var(--accent);
-    color: #fff;
-    border-bottom-right-radius: 4px;
+.ac-turn-agent .ac-content { color: var(--text); }
+.ac-turn-agent .ac-content code {
+    font-family: 'JetBrains Mono', ui-monospace, monospace;
+    font-size: 12px;
+    background: rgba(127, 127, 127, 0.14);
+    padding: 1px 5px; border-radius: 4px;
 }
-.ac-agent {
-    align-self: flex-start;
-    background: var(--bg-hover);
+
+/* User: right-aligned, subtle accent block (not a loud bubble) */
+.ac-turn-user { align-items: flex-end; }
+.ac-turn-user .ac-content {
+    background: rgba(96, 165, 250, 0.12);
+    border: 1px solid rgba(96, 165, 250, 0.22);
     color: var(--text);
-    border-bottom-left-radius: 4px;
+    padding: 7px 11px;
+    border-radius: 10px 10px 2px 10px;
+    max-width: 88%;
+    white-space: pre-wrap; word-wrap: break-word;
 }
-.ac-agent code, .ac-agent strong { color: var(--accent-cyan); }
-.ac-agent code {
-    background: rgba(0, 0, 0, 0.25);
-    padding: 1px 5px;
-    border-radius: 4px;
-    font-size: 12.5px;
+
+/* ── Activity indicator ─────────────────────────────────── */
+.ac-activity {
+    display: flex; align-items: center; gap: 9px;
+    color: var(--text-muted); font-size: 12.5px;
 }
+.ac-dots { display: inline-flex; gap: 4px; }
+.ac-dots i {
+    width: 5px; height: 5px; border-radius: 50%;
+    background: var(--accent);
+    display: inline-block;
+    animation: ac-blink 1.2s infinite both;
+}
+.ac-dots i:nth-child(2) { animation-delay: 0.18s; }
+.ac-dots i:nth-child(3) { animation-delay: 0.36s; }
+@keyframes ac-blink { 0%, 80%, 100% { opacity: 0.22; } 40% { opacity: 1; } }
 
+/* ── Tool calls ─────────────────────────────────────────── */
 .ac-tool {
-    align-self: flex-start;
-    font-size: 12.5px;
+    display: flex; align-items: center; gap: 8px;
+    font-family: 'JetBrains Mono', ui-monospace, monospace;
+    font-size: 11.5px;
     color: var(--text-muted);
-    padding: 3px 10px;
-    border-radius: 8px;
-    background: rgba(255, 255, 255, 0.03);
+    padding: 6px 10px;
     border: 1px solid var(--border);
+    border-radius: 8px;
+    background: rgba(127, 127, 127, 0.05);
 }
-.ac-tool-done .ac-tool-check { color: var(--accent-green); }
-.ac-tool-spin { display: inline-block; animation: ac-spin 1.4s linear infinite; }
-@keyframes ac-spin { to { transform: rotate(360deg); } }
-
-.ac-thinking {
-    align-self: flex-start;
-    font-size: 12.5px;
-    color: var(--text-muted);
-    font-style: italic;
-    opacity: 0.8;
+.ac-tool-name { color: var(--text); }
+.ac-tool-meta { color: var(--text-muted); }
+.ac-tool-check { color: var(--accent-green); }
+.ac-tool-spin {
+    width: 11px; height: 11px; border-radius: 50%;
+    border: 1.6px solid var(--border);
+    border-top-color: var(--accent);
+    display: inline-block;
+    animation: ac-spin 0.7s linear infinite;
 }
+@keyframes ac-spin { to { transform: rotate(360deg); } }
 
+/* ── System lines / notifications ───────────────────────── */
 .ac-system {
     align-self: center;
-    font-size: 12px;
-    color: var(--text-muted);
-    text-align: center;
-    padding: 2px 8px;
+    font-size: 11.5px; color: var(--text-muted);
+    text-align: center; max-width: 95%;
 }
 .ac-level-error { color: var(--color-danger, #f87171); }
 .ac-level-warning { color: var(--accent-orange, #fb923c); }
 .ac-level-success { color: var(--accent-green); }
 
+/* ── Choice picker ──────────────────────────────────────── */
 .ac-choice {
-    align-self: stretch;
-    display: flex;
-    flex-direction: column;
-    gap: 6px;
-    padding: 10px;
+    display: flex; flex-direction: column; gap: 7px;
+    padding: 12px;
     border: 1px solid var(--border);
-    border-radius: 12px;
-    background: rgba(96, 165, 250, 0.06);
+    border-radius: 10px;
+    background: rgba(127, 127, 127, 0.04);
 }
-.ac-choice-q { color: var(--text); font-weight: 500; margin-bottom: 2px; }
+.ac-choice-q { color: var(--text); font-weight: 500; }
 .ac-choice-opt {
     text-align: left;
-    padding: 8px 12px;
-    border-radius: 8px;
+    padding: 9px 12px; border-radius: 8px;
     border: 1px solid var(--border);
-    background: var(--bg-card);
-    color: var(--text);
+    background: var(--bg-card); color: var(--text);
     cursor: pointer;
-    display: flex;
-    flex-direction: column;
-    gap: 2px;
+    display: flex; flex-direction: column; gap: 2px;
+    transition: border-color 0.12s ease, background 0.12s ease;
 }
 .ac-choice-opt:hover:not(:disabled) { border-color: var(--accent); background: var(--bg-hover); }
 .ac-choice-opt:disabled { opacity: 0.5; cursor: default; }
-.ac-choice-label { font-weight: 600; }
+.ac-choice-label { font-weight: 600; font-size: 13px; }
 .ac-choice-desc { font-size: 12px; color: var(--text-muted); }
-.ac-choice-picked { border-color: var(--accent-green); }
+.ac-choice-picked { border-color: var(--accent-green); background: rgba(74, 222, 128, 0.08); }
 
+/* ── Applied-spec card ──────────────────────────────────── */
 .ac-spec {
-    align-self: flex-start;
     border: 1px solid var(--border);
     border-radius: 10px;
-    padding: 8px 12px;
-    background: var(--bg-hover);
-    font-size: 13px;
+    padding: 11px 13px;
+    background: rgba(127, 127, 127, 0.04);
+    font-size: 12.5px;
 }
-.ac-spec-title { font-weight: 600; color: var(--accent-purple); margin-bottom: 4px; }
-.ac-spec-row { display: flex; justify-content: space-between; gap: 16px; color: var(--text-muted); }
-.ac-spec-row span:last-child { color: var(--text); }
+.ac-spec-title {
+    font-weight: 600; color: var(--accent-purple);
+    font-size: 11px; letter-spacing: 0.04em; text-transform: uppercase;
+    margin-bottom: 6px;
+}
+.ac-spec-row { display: flex; justify-content: space-between; gap: 16px; padding: 1px 0; color: var(--text-muted); }
+.ac-spec-row span:last-child { color: var(--text); font-family: 'JetBrains Mono', ui-monospace, monospace; }
 
+/* ── Composer ───────────────────────────────────────────── */
 .agent-chat-input {
-    display: flex;
-    gap: 8px;
-    padding: 10px;
+    display: flex; gap: 8px;
+    padding: 12px;
     border-top: 1px solid var(--border);
-    background: var(--bg-hover);
 }
 .agent-chat-input textarea {
-    flex: 1 1 auto;
-    resize: none;
-    border: 1px solid var(--border);
-    border-radius: 10px;
-    background: var(--bg-card);
-    color: var(--text);
-    padding: 8px 10px;
-    font-family: inherit;
-    font-size: 14px;
-    line-height: 1.4;
+    flex: 1 1 auto; resize: none;
+    border: 1px solid var(--border); border-radius: 9px;
+    background: var(--bg-dark); color: var(--text);
+    padding: 9px 11px;
+    font-family: inherit; font-size: 13.5px; line-height: 1.45;
     max-height: 140px;
 }
+.agent-chat-input textarea::placeholder { color: var(--text-muted); }
 .agent-chat-input textarea:focus { outline: none; border-color: var(--accent); }
-.agent-chat-input textarea:disabled { opacity: 0.6; }
+.agent-chat-input textarea:disabled { opacity: 0.55; }
 .agent-chat-send {
-    flex: 0 0 auto;
-    align-self: flex-end;
-    padding: 8px 16px;
-    border-radius: 10px;
-    border: none;
-    background: var(--accent);
-    color: #fff;
-    font-weight: 600;
-    cursor: pointer;
+    flex: 0 0 auto; align-self: flex-end;
+    padding: 9px 16px; border-radius: 9px;
+    border: none; background: var(--accent); color: #fff;
+    font-weight: 600; font-size: 13px; cursor: pointer;
+    transition: background 0.12s ease;
 }
 .agent-chat-send:hover:not(:disabled) { background: var(--accent-hover); }
 .agent-chat-send:disabled { opacity: 0.5; cursor: default; }
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 0b83f7a5..cb42c409 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -18,11 +18,12 @@ const AgentChat = (() => {
     let hasControl = true;        // optimistic until the server says otherwise
     let holderLabel = null;
     let streaming = false;
-    let currentAgentEl = null;    // the agent bubble currently being streamed into
-    let thinkingEl = null;
+    let currentAgentEl = null;    // the agent content element being streamed into
+    let activityEl = null;        // the persistent "working…" indicator (reused)
+    let me = null;                // { authenticated, username, role, can_control }
 
     // DOM refs (resolved in init)
-    let fab, panel, log, input, sendBtn, connDot, banner, closeBtn;
+    let fab, panel, log, input, sendBtn, conn, banner, closeBtn, userEl, signoutBtn;
 
     // ── Safe rendering ────────────────────────────────────────
     function escapeHtml(s) {
@@ -41,19 +42,48 @@ const AgentChat = (() => {
         return html;
     }
 
-    // ── Message helpers ───────────────────────────────────────
-    function scrollToBottom() {
-        log.scrollTop = log.scrollHeight;
+    function scrollToBottom() { log.scrollTop = log.scrollHeight; }
+
+    // ── Activity indicator ────────────────────────────────────
+    // A single reusable "the agent is working" row, always pinned to the
+    // bottom of the log. This is the trust signal — something is happening.
+    function setActivity(label) {
+        if (!activityEl) {
+            activityEl = document.createElement('div');
+            activityEl.className = 'ac-activity';
+            activityEl.innerHTML =
+                '<span class="ac-dots"><i></i><i></i><i></i></span>' +
+                '<span class="ac-activity-label"></span>';
+        }
+        activityEl.querySelector('.ac-activity-label').textContent = label;
+        log.appendChild(activityEl);  // (re)pin to bottom
+        scrollToBottom();
+    }
+    function hideActivity() {
+        if (activityEl && activityEl.parentNode) activityEl.parentNode.removeChild(activityEl);
     }
 
-    function addBubble(role, htmlOrText, { html = false } = {}) {
-        const el = document.createElement('div');
-        el.className = `ac-msg ac-${role}`;
-        if (html) el.innerHTML = htmlOrText;
-        else el.textContent = htmlOrText;
-        log.appendChild(el);
+    // ── Message elements ──────────────────────────────────────
+    function addTurn(role) {
+        const wrap = document.createElement('div');
+        wrap.className = `ac-turn ac-turn-${role}`;
+        if (role === 'agent') {
+            const label = document.createElement('div');
+            label.className = 'ac-role';
+            label.textContent = 'Gently';
+            wrap.appendChild(label);
+        }
+        const content = document.createElement('div');
+        content.className = 'ac-content';
+        wrap.appendChild(content);
+        log.appendChild(wrap);
         scrollToBottom();
-        return el;
+        return content;
+    }
+
+    function addUserMessage(text) {
+        const content = addTurn('user');
+        content.textContent = text;
     }
 
     function addSystemLine(text, level = 'info') {
@@ -62,12 +92,6 @@ const AgentChat = (() => {
         el.textContent = text;
         log.appendChild(el);
         scrollToBottom();
-        return el;
-    }
-
-    function clearThinking() {
-        if (thinkingEl && thinkingEl.parentNode) thinkingEl.parentNode.removeChild(thinkingEl);
-        thinkingEl = null;
     }
 
     // ── Protocol handlers ─────────────────────────────────────
@@ -75,9 +99,7 @@ const AgentChat = (() => {
         switch (msg.type) {
             case 'connected':
                 reconnectDelay = 1000;
-                setConn(true);
-                // version / session in the header tooltip
-                if (msg.version) connDot.title = `connected · v${msg.version}`;
+                setConn(true, msg.version ? `Connected · v${msg.version}` : 'Connected');
                 break;
 
             case 'control_status':
@@ -88,25 +110,19 @@ const AgentChat = (() => {
 
             case 'stream_start':
                 streaming = true;
-                clearThinking();
                 currentAgentEl = null;  // created lazily on first text
                 setBusy(true);
+                setActivity('Working…');
                 break;
 
             case 'thinking':
-                if (!thinkingEl) {
-                    thinkingEl = document.createElement('div');
-                    thinkingEl.className = 'ac-thinking';
-                    thinkingEl.textContent = 'thinking…';
-                    log.appendChild(thinkingEl);
-                    scrollToBottom();
-                }
+                if (streaming) setActivity('Thinking…');
                 break;
 
             case 'text': {
-                clearThinking();
                 if (!currentAgentEl) {
-                    currentAgentEl = addBubble('agent', '', { html: true });
+                    hideActivity();
+                    currentAgentEl = addTurn('agent');
                     currentAgentEl._raw = '';
                 }
                 currentAgentEl._raw += (msg.text || '');
@@ -116,36 +132,37 @@ const AgentChat = (() => {
             }
 
             case 'tool_start': {
-                clearThinking();
+                hideActivity();           // the running tool row is the signal now
+                currentAgentEl = null;    // text after a tool starts a fresh bubble
                 const label = msg.tool_label || msg.tool_name || 'tool';
                 const el = document.createElement('div');
                 el.className = 'ac-tool ac-tool-running';
                 el.dataset.tool = msg.tool_name || '';
-                el.innerHTML = `<span class="ac-tool-spin">⚙</span> ${escapeHtml(label)}…`;
+                el.innerHTML = `<span class="ac-tool-spin"></span><span class="ac-tool-name">${escapeHtml(label)}</span>`;
                 log.appendChild(el);
                 scrollToBottom();
                 break;
             }
 
             case 'tool_call': {
-                // Mark the most recent running entry for this tool as done.
                 const running = [...log.querySelectorAll('.ac-tool-running')]
                     .filter(e => e.dataset.tool === (msg.tool_name || ''));
                 const el = running[running.length - 1];
                 const label = msg.tool_name || 'tool';
-                const dur = msg.duration ? ` · ${msg.duration.toFixed ? msg.duration.toFixed(1) : msg.duration}s` : '';
+                const dur = msg.duration
+                    ? ` · ${(msg.duration.toFixed ? msg.duration.toFixed(1) : msg.duration)}s` : '';
                 const summary = msg.result_summary ? ` — ${escapeHtml(msg.result_summary)}` : '';
                 if (el) {
                     el.className = 'ac-tool ac-tool-done';
-                    el.innerHTML = `<span class="ac-tool-check">✓</span> ${escapeHtml(label)}${dur}${summary}`;
-                } else {
-                    addBubble('tool', `✓ ${escapeHtml(label)}${dur}${summary}`, { html: true });
+                    el.innerHTML = `<span class="ac-tool-check">✓</span><span class="ac-tool-name">${escapeHtml(label)}</span><span class="ac-tool-meta">${dur}${summary}</span>`;
                 }
+                if (streaming) setActivity('Working…');  // agent continues after the tool
                 scrollToBottom();
                 break;
             }
 
             case 'choice_request':
+                hideActivity();
                 renderChoice(msg);
                 break;
 
@@ -155,8 +172,8 @@ const AgentChat = (() => {
 
             case 'stream_end':
                 streaming = false;
-                clearThinking();
                 currentAgentEl = null;
+                hideActivity();
                 setBusy(false);
                 break;
 
@@ -171,6 +188,7 @@ const AgentChat = (() => {
 
             case 'error':
                 streaming = false;
+                hideActivity();
                 setBusy(false);
                 addSystemLine(msg.error || 'Unknown error', 'error');
                 break;
@@ -179,18 +197,12 @@ const AgentChat = (() => {
                 send({ type: 'pong' });
                 break;
 
-            case 'pong':
-            case 'state_update':
-            case 'browse_result':
-                break;  // not surfaced in the chat window (yet)
-
             default:
-                break;  // unknown types ignored (forward-compatible)
+                break;  // pong / state_update / browse_result / unknown — ignored
         }
     }
 
     function renderChoice(msg) {
-        clearThinking();
         const data = msg.choice_data || {};
         const reqId = msg.request_id || data.request_id || '';
         const wrap = document.createElement('div');
@@ -208,10 +220,10 @@ const AgentChat = (() => {
             btn.innerHTML = `<span class="ac-choice-label">${escapeHtml(opt.label)}</span>${desc}`;
             btn.addEventListener('click', () => {
                 send({ type: 'choice_response', request_id: reqId, selected: opt.id });
-                // lock the picker and show the pick
                 [...wrap.querySelectorAll('button')].forEach(b => b.disabled = true);
                 wrap.classList.add('ac-choice-answered');
                 btn.classList.add('ac-choice-picked');
+                if (streaming) setActivity('Working…');
             });
             wrap.appendChild(btn);
         });
@@ -222,16 +234,19 @@ const AgentChat = (() => {
     function renderSpec(spec) {
         const rows = [];
         const add = (k, v) => { if (v !== undefined && v !== null && v !== '') rows.push([k, v]); };
-        add('strain', spec.strain);
-        add('temp °C', spec.temperature_c);
-        add('slices', spec.num_slices);
-        add('exposure ms', spec.exposure_ms);
-        add('interval s', spec.interval_s);
-        add('stop at', spec.stop_condition);
+        add('Strain', spec.strain);
+        add('Temperature', spec.temperature_c != null ? `${spec.temperature_c} °C` : null);
+        add('Slices', spec.num_slices);
+        add('Exposure', spec.exposure_ms != null ? `${spec.exposure_ms} ms` : null);
+        add('Interval', spec.interval_s != null ? `${spec.interval_s} s` : null);
+        add('Stop at', spec.stop_condition);
         if (!rows.length) return;
-        const html = '<div class="ac-spec-title">Imaging spec applied</div>' +
+        const el = document.createElement('div');
+        el.className = 'ac-spec';
+        el.innerHTML = '<div class="ac-spec-title">Imaging spec applied</div>' +
             rows.map(([k, v]) => `<div class="ac-spec-row"><span>${escapeHtml(k)}</span><span>${escapeHtml(v)}</span></div>`).join('');
-        addBubble('spec', html, { html: true });
+        log.appendChild(el);
+        scrollToBottom();
     }
 
     // ── Control / UI state ────────────────────────────────────
@@ -241,19 +256,25 @@ const AgentChat = (() => {
             banner.innerHTML = '';
             input.disabled = false;
             sendBtn.disabled = false;
-            input.placeholder = 'Message the agent…';
+            input.placeholder = 'Message Gently…';
         } else {
             banner.classList.remove('hidden');
-            const who = holderLabel || 'another client';
-            banner.innerHTML = `<span>🔒 ${escapeHtml(who)} is driving</span>`;
-            const btn = document.createElement('button');
-            btn.className = 'ac-take-control';
-            btn.textContent = 'Take control';
-            btn.addEventListener('click', () => send({ type: 'take_control' }));
-            banner.appendChild(btn);
+            const who = holderLabel || 'another session';
             input.disabled = true;
             sendBtn.disabled = true;
-            input.placeholder = 'Viewing only — take control to drive…';
+            if (me && me.authenticated && me.can_control === false) {
+                // Viewer role — watching is all this account can do.
+                banner.innerHTML = `<span class="ac-lock">View-only access — you can watch but not control.</span>`;
+                input.placeholder = 'View-only access';
+            } else {
+                banner.innerHTML = `<span class="ac-lock">Control held by ${escapeHtml(who)}</span>`;
+                const btn = document.createElement('button');
+                btn.className = 'ac-take-control';
+                btn.textContent = 'Take control';
+                btn.addEventListener('click', () => send({ type: 'take_control' }));
+                banner.appendChild(btn);
+                input.placeholder = 'Viewing only — take control to drive…';
+            }
         }
     }
 
@@ -262,10 +283,10 @@ const AgentChat = (() => {
         sendBtn.classList.toggle('ac-busy', busy);
     }
 
-    function setConn(ok) {
-        connDot.classList.toggle('ac-conn-ok', ok);
-        connDot.classList.toggle('ac-conn-bad', !ok);
-        if (!ok) connDot.title = 'reconnecting…';
+    function setConn(ok, label) {
+        conn.classList.toggle('ac-conn-ok', ok);
+        conn.classList.toggle('ac-conn-bad', !ok);
+        conn.textContent = label || (ok ? 'Connected' : 'Reconnecting…');
     }
 
     // ── Transport ─────────────────────────────────────────────
@@ -275,12 +296,14 @@ const AgentChat = (() => {
 
     function connect() {
         const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
+        setConn(false, 'Connecting…');
         ws = new WebSocket(`${proto}//${location.host}/ws/agent`);
         ws.onopen = () => { reconnectDelay = 1000; setConn(true); };
         ws.onclose = () => {
-            setConn(false);
+            setConn(false, 'Reconnecting…');
             setBusy(false);
             streaming = false;
+            hideActivity();
             setTimeout(connect, reconnectDelay);
             reconnectDelay = Math.min(reconnectDelay * 2, MAX_DELAY);
         };
@@ -298,12 +321,15 @@ const AgentChat = (() => {
         const text = input.value.trim();
         if (!text) return;
         if (!hasControl) { renderControl(); return; }
-        addBubble('user', text);
+        addUserMessage(text);
         if (text.startsWith('/')) {
             send({ type: 'command', command: text });  // slash commands (e.g. /status)
         } else {
             send({ type: 'chat', text });
         }
+        // Instant feedback before the first chunk arrives.
+        setBusy(true);
+        setActivity('Working…');
         input.value = '';
         autosize();
     }
@@ -323,6 +349,22 @@ const AgentChat = (() => {
         }
     }
 
+    // ── Identity ──────────────────────────────────────────────
+    function fetchMe() {
+        fetch('/api/auth/me').then(r => r.json()).then(m => {
+            me = m;
+            if (m && m.authenticated) {
+                userEl.textContent = m.username;
+                userEl.title = `Signed in as ${m.username} (${m.role})`;
+                signoutBtn.style.display = '';
+            } else {
+                userEl.textContent = '';
+                signoutBtn.style.display = 'none';
+            }
+            renderControl();
+        }).catch(() => {});
+    }
+
     // ── Init ──────────────────────────────────────────────────
     function init() {
         fab = document.getElementById('agent-fab');
@@ -330,13 +372,20 @@ const AgentChat = (() => {
         log = document.getElementById('agent-chat-log');
         input = document.getElementById('agent-chat-text');
         sendBtn = document.getElementById('agent-chat-send');
-        connDot = document.getElementById('agent-chat-conn');
+        conn = document.getElementById('agent-chat-conn');
         banner = document.getElementById('agent-control-banner');
         closeBtn = document.getElementById('agent-chat-close');
+        userEl = document.getElementById('agent-chat-user');
+        signoutBtn = document.getElementById('agent-chat-signout');
         if (!fab || !panel) return;  // markup not present
 
         fab.addEventListener('click', () => togglePanel());
         closeBtn.addEventListener('click', () => togglePanel(false));
+        signoutBtn.addEventListener('click', async () => {
+            try { await fetch('/api/auth/logout', { method: 'POST' }); } catch (_) {}
+            window.location.href = '/login';
+        });
+        fetchMe();
         sendBtn.addEventListener('click', submit);
         input.addEventListener('input', autosize);
         input.addEventListener('keydown', (e) => {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 249bede7..b66893da 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -515,17 +515,24 @@ <h3 class="devices-properties-title">Properties</h3>
     <div class="ambient-pulse" id="ambient-pulse"></div>
 
     <!-- Floating agent chat (web-side control surface) -->
-    <button id="agent-fab" class="agent-fab" title="Chat with Gently">✦</button>
+    <button id="agent-fab" class="agent-fab" title="Chat with Gently">
+        <img src="/static/favicon.svg" alt="Gently" width="30" height="30">
+    </button>
     <div id="agent-chat" class="agent-chat hidden">
         <div class="agent-chat-header">
-            <span class="agent-chat-title">✦ Gently</span>
-            <span id="agent-chat-conn" class="agent-chat-conn ac-conn-bad" title="connecting…">●</span>
-            <button id="agent-chat-close" class="agent-chat-close" title="Close">×</button>
+            <div class="agent-chat-id">
+                <img class="agent-chat-mark" src="/static/favicon.svg" alt="" width="26" height="26">
+                <span class="agent-chat-title">Gently</span>
+                <span id="agent-chat-user" class="agent-chat-user"></span>
+            </div>
+            <span id="agent-chat-conn" class="agent-chat-conn ac-conn-bad">Connecting…</span>
+            <button id="agent-chat-signout" class="agent-chat-signout" title="Sign out" style="display:none">Sign out</button>
+            <button id="agent-chat-close" class="agent-chat-close" title="Close">&times;</button>
         </div>
         <div id="agent-control-banner" class="agent-control-banner hidden"></div>
         <div id="agent-chat-log" class="agent-chat-log"></div>
         <div class="agent-chat-input">
-            <textarea id="agent-chat-text" rows="1" placeholder="Message the agent…"></textarea>
+            <textarea id="agent-chat-text" rows="1" placeholder="Message Gently…"></textarea>
             <button id="agent-chat-send" class="agent-chat-send">Send</button>
         </div>
     </div>
diff --git a/gently/ui/web/templates/login.html b/gently/ui/web/templates/login.html
new file mode 100644
index 00000000..9f893995
--- /dev/null
+++ b/gently/ui/web/templates/login.html
@@ -0,0 +1,92 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Sign in · Gently</title>
+    <link rel="icon" type="image/svg+xml" href="/static/favicon.svg">
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@400;500;600;700&display=swap" rel="stylesheet">
+    <style>
+        :root {
+            --bg-dark: #0d1117; --bg-card: #161b22; --border: #30363d;
+            --text: #c9d1d9; --text-muted: #8b949e; --accent: #60a5fa;
+            --accent-hover: #93c5fd; --danger: #f87171;
+        }
+        * { box-sizing: border-box; }
+        body {
+            margin: 0; min-height: 100vh;
+            display: flex; align-items: center; justify-content: center;
+            background: var(--bg-dark); color: var(--text);
+            font-family: 'Inter Tight', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+        }
+        .card {
+            width: 340px; max-width: calc(100vw - 40px);
+            background: var(--bg-card); border: 1px solid var(--border);
+            border-radius: 14px; padding: 28px 26px;
+            box-shadow: 0 16px 50px rgba(0, 0, 0, 0.5);
+        }
+        .brand { display: flex; align-items: center; gap: 10px; margin-bottom: 4px; }
+        .brand img { display: block; }
+        .brand h1 { font-size: 20px; font-weight: 600; margin: 0; }
+        .sub { color: var(--text-muted); font-size: 13px; margin: 0 0 22px; }
+        label { display: block; font-size: 12px; color: var(--text-muted); margin: 14px 0 5px; }
+        input {
+            width: 100%; padding: 10px 12px; border-radius: 9px;
+            border: 1px solid var(--border); background: var(--bg-dark);
+            color: var(--text); font-size: 14px; font-family: inherit;
+        }
+        input:focus { outline: none; border-color: var(--accent); }
+        button {
+            width: 100%; margin-top: 22px; padding: 11px;
+            border: none; border-radius: 9px;
+            background: var(--accent); color: #fff;
+            font-weight: 600; font-size: 14px; cursor: pointer;
+        }
+        button:hover:not(:disabled) { background: var(--accent-hover); }
+        button:disabled { opacity: 0.6; cursor: default; }
+        .error { color: var(--danger); font-size: 13px; margin-top: 14px; min-height: 18px; }
+    </style>
+</head>
+<body>
+    <form class="card" id="login-form" autocomplete="on">
+        <div class="brand">
+            <img src="/static/favicon.svg" alt="" width="30" height="30">
+            <h1>Gently</h1>
+        </div>
+        <p class="sub">Sign in to control the microscope.</p>
+        <label for="username">Username</label>
+        <input id="username" name="username" type="text" autocomplete="username" autofocus required>
+        <label for="password">Password</label>
+        <input id="password" name="password" type="password" autocomplete="current-password" required>
+        <button type="submit" id="submit">Sign in</button>
+        <div class="error" id="error"></div>
+    </form>
+    <script>
+        const form = document.getElementById('login-form');
+        const errEl = document.getElementById('error');
+        const btn = document.getElementById('submit');
+        form.addEventListener('submit', async (e) => {
+            e.preventDefault();
+            errEl.textContent = '';
+            btn.disabled = true;
+            try {
+                const r = await fetch('/api/auth/login', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        username: document.getElementById('username').value,
+                        password: document.getElementById('password').value,
+                    }),
+                });
+                if (r.ok) { window.location.href = '/'; return; }
+                const data = await r.json().catch(() => ({}));
+                errEl.textContent = data.error || 'Sign in failed';
+            } catch (_) {
+                errEl.textContent = 'Could not reach the server';
+            }
+            btn.disabled = false;
+        });
+    </script>
+</body>
+</html>
diff --git a/launch_gently.py b/launch_gently.py
index 9a38e815..34cdff8e 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -185,6 +185,20 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     write_manifest(storage_dir)
     store = FileStore(storage_dir)
 
+    # ── Accounts / auth ───────────────────────────────────────────
+    # Self-managed user accounts gate microscope control on the LAN. On first
+    # run we bootstrap an admin and print its one-time password in the banner.
+    # Set GENTLY_NO_AUTH=1 to disable accounts (legacy localhost-control mode).
+    admin_creds = None
+    if os.environ.get("GENTLY_NO_AUTH", "").strip().lower() not in ("1", "true", "yes"):
+        try:
+            from gently.ui.web.accounts import AccountStore, set_account_store
+            account_store = AccountStore(storage_dir / "auth")
+            set_account_store(account_store)
+            admin_creds = account_store.bootstrap_admin_if_empty()
+        except Exception as e:
+            logger.error("Account store init failed (continuing without auth): %s", e)
+
     # Handle --sessions (just list and exit)
     if show_sessions:
         list_sessions(store)
@@ -434,6 +448,13 @@ def _status_provider():
         resumed=session_to_resume is not None,
     )
 
+    if admin_creds:
+        _u, _p = admin_creds
+        print("  First-run admin account created — sign in at the URL above:")
+        print(f"      username: {_u}")
+        print(f"      password: {_p}")
+        print("  (Save this now. Add users via the admin API; GENTLY_NO_AUTH=1 disables auth.)\n")
+
     if viz_url and not no_browser:
         try:
             import webbrowser

From 6917a4282da3af2a198a8feb861c6b0dfd17d1bb Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:11:29 -0400
Subject: [PATCH 026/314] fix(launcher): make Ctrl-C stop the server on Windows

The serve loop blocked on a bare asyncio.Event().wait(), which the Windows
Proactor loop won't interrupt on Ctrl-C, leaving the server unstoppable.
Install SIGINT/SIGTERM handlers (loop.add_signal_handler, falling back to
signal.signal + call_soon_threadsafe on Windows) and poll a stop Event on a
short interval so the interrupt surfaces and shutdown runs cleanly.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 launch_gently.py | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/launch_gently.py b/launch_gently.py
index 34cdff8e..37d4913c 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -462,10 +462,30 @@ def _status_provider():
         except Exception:
             pass
 
+    # Keep the event loop alive so the in-process viz server keeps serving.
+    # On Windows the Proactor loop won't surface Ctrl-C while blocked on a
+    # bare Event().wait(), so install signal handlers and poll on a short
+    # interval (which also lets a pending KeyboardInterrupt surface).
+    import signal as _signal
+    _loop = asyncio.get_running_loop()
+    _stop = asyncio.Event()
     try:
-        # Serve until interrupted (Ctrl-C). Keep the event loop alive so
-        # the in-process viz server keeps handling browser clients.
-        await asyncio.Event().wait()
+        _loop.add_signal_handler(_signal.SIGINT, _stop.set)
+        _loop.add_signal_handler(_signal.SIGTERM, _stop.set)
+    except (NotImplementedError, AttributeError, RuntimeError, ValueError):
+        # Windows Proactor: add_signal_handler is unsupported — fall back to
+        # signal.signal, waking the loop via call_soon_threadsafe.
+        def _sig(*_a):
+            _loop.call_soon_threadsafe(_stop.set)
+        try:
+            _signal.signal(_signal.SIGINT, _sig)
+            _signal.signal(_signal.SIGTERM, _sig)
+        except (ValueError, OSError):
+            pass
+
+    try:
+        while not _stop.is_set():
+            await asyncio.sleep(0.3)
     except (KeyboardInterrupt, asyncio.CancelledError):
         pass
     finally:

From e075dcd1f42ce45899952ca610d9efed270bc8de Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:16:16 -0400
Subject: [PATCH 027/314] fix(web): viewing is open; login elevates to control
 (not a page gate)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Opening the dashboard no longer redirects to /login — viewing is open to
everyone (the "watch like it is now" model). Login is an elevation to the
control role, not a gate on the app.

- pages.py: drop the /login redirect on the main page.
- agent_ws.py: anonymous clients may connect to /ws/agent and *watch*; only
  authenticated operators/admins can hold/take the control lock (drive
  actions stay gated). No more close-on-unauthenticated.
- agent-chat.js: distinguish anonymous ("Viewing — sign in to control",
  with a Sign in button) from a viewer-role account ("view-only"); header
  button is Sign in / Sign out accordingly.

API model: observable (read) endpoints + watching the agent need no auth;
only inputable (control) actions are gated via require_control / the control
lock — auth is not attached to every endpoint.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py      | 15 ++++++--------
 gently/ui/web/routes/pages.py         | 12 +++++------
 gently/ui/web/static/js/agent-chat.js | 29 ++++++++++++++++++++++++---
 3 files changed, 38 insertions(+), 18 deletions(-)

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index c29dfbce..ba49cb76 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -171,18 +171,15 @@ async def agent_websocket(websocket: WebSocket):
         from gently.ui.web.auth import SESSION_COOKIE
         _acct = get_account_store()
         username = None
-        can_control = True  # legacy default
+        can_control = True  # legacy default when no accounts are configured
         if _acct is not None and _acct.has_users():
+            # Viewing is open: anonymous clients may connect and *watch* the
+            # conversation. Only authenticated operators/admins can hold or
+            # take the control lock (enforced on the drive actions below).
             _token = websocket.cookies.get(SESSION_COOKIE)
             username = _acct.verify_session(_token) if _token else None
-            if username is None:
-                await websocket.send_json({
-                    "type": "error",
-                    "error": "Authentication required — please sign in.",
-                })
-                await websocket.close()
-                return
-            can_control = _acct.get_role(username) in CONTROL_ROLES
+            role = _acct.get_role(username) if username else None
+            can_control = role in CONTROL_ROLES
 
         # Assign a stable id for control arbitration. The label shown to other
         # clients is the username when authenticated, else a generic window id.
diff --git a/gently/ui/web/routes/pages.py b/gently/ui/web/routes/pages.py
index 9c48912a..0cff7d82 100644
--- a/gently/ui/web/routes/pages.py
+++ b/gently/ui/web/routes/pages.py
@@ -9,12 +9,12 @@ def create_router(server) -> APIRouter:
 
     @router.get("/", response_class=HTMLResponse)
     async def index(request: Request):
-        """Serve the main SPA page (redirect to login if accounts require it)."""
-        from gently.ui.web.accounts import get_account_store
-        from gently.ui.web.auth import current_username
-        store = get_account_store()
-        if store is not None and store.has_users() and not current_username(request):
-            return RedirectResponse("/login", status_code=302)
+        """Serve the main SPA page.
+
+        Viewing is open to everyone — the dashboard loads in view mode with no
+        login. Signing in is an *elevation* to control (handled in-app via the
+        chat window's "Sign in" affordance), not a gate on the page itself.
+        """
         return server.templates.TemplateResponse(
             "index.html",
             {"request": request, "active_section": "embryos", "is_live": True}
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index cb42c409..8a60f3a0 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -262,8 +262,17 @@ const AgentChat = (() => {
             const who = holderLabel || 'another session';
             input.disabled = true;
             sendBtn.disabled = true;
-            if (me && me.authenticated && me.can_control === false) {
-                // Viewer role — watching is all this account can do.
+            if (me && me.accounts && !me.authenticated) {
+                // Anonymous — viewing is open; sign in to control.
+                banner.innerHTML = `<span class="ac-lock">Viewing — sign in to control.</span>`;
+                const btn = document.createElement('button');
+                btn.className = 'ac-take-control';
+                btn.textContent = 'Sign in';
+                btn.addEventListener('click', () => { window.location.href = '/login'; });
+                banner.appendChild(btn);
+                input.placeholder = 'Viewing — sign in to control…';
+            } else if (me && me.authenticated && me.can_control === false) {
+                // Viewer-role account — watching is all this account can do.
                 banner.innerHTML = `<span class="ac-lock">View-only access — you can watch but not control.</span>`;
                 input.placeholder = 'View-only access';
             } else {
@@ -356,8 +365,18 @@ const AgentChat = (() => {
             if (m && m.authenticated) {
                 userEl.textContent = m.username;
                 userEl.title = `Signed in as ${m.username} (${m.role})`;
+                signoutBtn.textContent = 'Sign out';
+                signoutBtn.dataset.action = 'logout';
+                signoutBtn.style.display = '';
+            } else if (m && m.accounts) {
+                // Anonymous — viewing is open; sign in to gain control.
+                userEl.textContent = 'viewing';
+                userEl.title = 'Not signed in — view-only';
+                signoutBtn.textContent = 'Sign in';
+                signoutBtn.dataset.action = 'login';
                 signoutBtn.style.display = '';
             } else {
+                // No accounts configured (legacy mode).
                 userEl.textContent = '';
                 signoutBtn.style.display = 'none';
             }
@@ -382,8 +401,12 @@ const AgentChat = (() => {
         fab.addEventListener('click', () => togglePanel());
         closeBtn.addEventListener('click', () => togglePanel(false));
         signoutBtn.addEventListener('click', async () => {
+            if (signoutBtn.dataset.action === 'login') {
+                window.location.href = '/login';
+                return;
+            }
             try { await fetch('/api/auth/logout', { method: 'POST' }); } catch (_) {}
-            window.location.href = '/login';
+            window.location.reload();
         });
         fetchMe();
         sendBtn.addEventListener('click', submit);

From 645aacef15a4fe8a85739767c4cd80fd16c2bacc Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:24:29 -0400
Subject: [PATCH 028/314] feat(web): gate person-driven control actions by role
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Complete the inputable-action gating beyond the REST routes already covered
in data.py:
- chat.py: the per-timepoint VLM follow-up (POST /api/perception/chat/...)
  now requires the control role — it spends API budget and writes traces, so
  anonymous viewers can't trigger it.
- websocket.py (/ws): marking actions (embryo_marked / marking_update /
  marking_done / marking_redetect) are gated to control-role clients via the
  session cookie; pure read/presence messages stay open so anyone can watch.

Deliberately NOT gated here: device-layer ingest (POST images/volumes — a
machine trust domain, would break under account mode where localhost is no
longer auto-control) and campaign mutations (their own mesh scope auth).
These need a separate machine-token pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/chat.py      |  7 +++++--
 gently/ui/web/routes/websocket.py | 29 +++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/routes/chat.py b/gently/ui/web/routes/chat.py
index 12833b13..1cdd15f7 100644
--- a/gently/ui/web/routes/chat.py
+++ b/gently/ui/web/routes/chat.py
@@ -16,10 +16,12 @@
 from pathlib import Path
 from typing import Optional
 
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter, Depends, HTTPException
 from fastapi.responses import StreamingResponse
 from pydantic import BaseModel
 
+from gently.ui.web.auth import require_control
+
 logger = logging.getLogger(__name__)
 
 CHAT_MODEL = "claude-opus-4-7"
@@ -106,7 +108,8 @@ async def get_chat(sid: str, eid: str, tp: int):
         return {"turns": _load_history(path)}
 
     @router.post("/api/perception/chat/{sid}/{eid}/{tp}")
-    async def post_chat(sid: str, eid: str, tp: int, body: ChatRequest):
+    async def post_chat(sid: str, eid: str, tp: int, body: ChatRequest,
+                        _control=Depends(require_control)):
         """Append a user message and stream the assistant reply as SSE.
 
         Each SSE event is JSON: ``{"type": "delta", "text": "..."}`` for
diff --git a/gently/ui/web/routes/websocket.py b/gently/ui/web/routes/websocket.py
index b49518e0..3dce3320 100644
--- a/gently/ui/web/routes/websocket.py
+++ b/gently/ui/web/routes/websocket.py
@@ -11,6 +11,30 @@
 
 logger = logging.getLogger(__name__)
 
+# /ws message types that mutate experiment state (define what gets imaged).
+# These are control actions and are gated by role; pure read/presence
+# messages stay open so anyone can watch.
+_MARKING_TYPES = frozenset({
+    "embryo_marked", "marking_update", "marking_done", "marking_redetect",
+})
+
+
+def _ws_can_control(websocket: WebSocket) -> bool:
+    """Whether this /ws client may perform control actions (marking).
+
+    Account mode: operators/admins (by session cookie) only. Legacy mode
+    (no accounts configured): open, preserving prior behavior.
+    """
+    from gently.ui.web.accounts import get_account_store, CONTROL_ROLES
+    from gently.ui.web.auth import SESSION_COOKIE
+    store = get_account_store()
+    if store is None or not store.has_users():
+        return True
+    token = websocket.cookies.get(SESSION_COOKIE)
+    user = store.verify_session(token) if token else None
+    role = store.get_role(user) if user else None
+    return role in CONTROL_ROLES
+
 
 def create_router(server) -> APIRouter:
     router = APIRouter()
@@ -77,6 +101,11 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
         msg_type = data.get("type")
         embryo_id = data.get("embryo_id")
 
+        # Gate control actions (marking) by role; viewing/presence stays open.
+        if msg_type in _MARKING_TYPES and not _ws_can_control(websocket):
+            logger.warning("Ignored %s from a view-only /ws client", msg_type)
+            return
+
         if msg_type == "get_calibration":
             images = server.store.get_all_calibration(embryo_id)
             await websocket.send_json({

From 0fc43c6e1aa05897e63091d49ad0bc224af41be7 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:28:30 -0400
Subject: [PATCH 029/314] feat(web): uniform session transcript across all
 clients
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The conversation is now the same for every client of a session — operators
and viewers, live and on reconnect/refresh.

- Broadcast: user messages and the agent's streamed reply (text/thinking/
  tool calls/choice requests) go to ALL connected /ws/agent clients via a
  raw-websocket registry, not just the driver. Observers watch live.
- History: a display transcript is accumulated server-side and persisted to
  <session>/chat_display.json (user/agent/tool turns, capped to 500). On
  connect each client is sent a "history" message and rebuilds the
  transcript, so refreshes and late joiners see the full conversation.
- Choice pickers are interactive only for the control holder; observers see
  them read-only and only the holder's choice_response resolves.
- Client: handles "history" (rebuild) and "user_message" (live echo with
  author); stops double-echoing the sender's own chat (it now arrives via
  the broadcast); slash commands still echo locally (not broadcast).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py      | 98 ++++++++++++++++++++++++++-
 gently/ui/web/static/js/agent-chat.js | 59 ++++++++++++++--
 2 files changed, 150 insertions(+), 7 deletions(-)

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index ba49cb76..570c112a 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -41,6 +41,14 @@ def create_router(server) -> APIRouter:
     _clients: Dict[str, Callable] = {}
     _client_labels: Dict[str, str] = {}
     _client_counter = {"n": 0}
+    _raw_clients: Dict[str, WebSocket] = {}  # client_id -> websocket (broadcast)
+
+    # ── Uniform display transcript ────────────────────────────
+    # A single conversation history shared by every client of this session.
+    # Persisted to <session>/chat_display.json so it survives reconnects and
+    # restarts; broadcast live so all instances stay in sync.
+    _history: list = []
+    _history_state = {"loaded": False, "path": None, "agent_buf": None}
 
     async def _broadcast_control_status():
         """Tell every connected agent client who currently holds control."""
@@ -57,6 +65,75 @@ async def _broadcast_control_status():
             except Exception:
                 pass
 
+    def _load_history_once(bridge):
+        if _history_state["loaded"]:
+            return
+        _history_state["loaded"] = True
+        try:
+            agent = bridge.agent
+            store = getattr(agent, "store", None)
+            sid = getattr(agent, "session_id", None)
+            if store and sid:
+                sdir = store._session_dir(sid)
+                if sdir:
+                    p = sdir / "chat_display.json"
+                    _history_state["path"] = p
+                    if p.exists():
+                        loaded = json.loads(p.read_text(encoding="utf-8")) or []
+                        if isinstance(loaded, list):
+                            _history.extend(loaded)
+        except Exception:
+            logger.debug("Could not load chat history", exc_info=True)
+
+    def _save_history():
+        p = _history_state["path"]
+        if not p:
+            return
+        try:
+            tmp = p.with_suffix(".json.tmp")
+            tmp.write_text(json.dumps(_history[-500:]), encoding="utf-8")
+            tmp.replace(p)
+        except Exception:
+            pass
+
+    def _record(item):
+        _history.append(item)
+        if len(_history) > 500:
+            del _history[: len(_history) - 500]
+        _save_history()
+
+    def _flush_agent_buf():
+        buf = _history_state["agent_buf"]
+        if buf:
+            _record({"role": "agent", "text": buf})
+        _history_state["agent_buf"] = None
+
+    def _record_display(msg):
+        """Fold a streamed chunk into the persistent display history."""
+        t = msg.get("type")
+        if t == "user_message":
+            _flush_agent_buf()
+            _record({"role": "user", "text": msg.get("text", ""),
+                     "author": msg.get("author")})
+        elif t == "text":
+            _history_state["agent_buf"] = (_history_state["agent_buf"] or "") + msg.get("text", "")
+        elif t == "tool_call":
+            _flush_agent_buf()
+            _record({"role": "tool", "name": msg.get("tool_name"),
+                     "duration": msg.get("duration"),
+                     "summary": msg.get("result_summary")})
+        elif t == "stream_end":
+            _flush_agent_buf()
+
+    async def _broadcast(msg):
+        """Record to history + send a display message to ALL clients."""
+        _record_display(msg)
+        for cid, ws in list(_raw_clients.items()):
+            try:
+                await ws.send_json(msg)
+            except Exception:
+                pass
+
     async def _run_wizard(wizard, websocket, send_fn, _choice_futures, bridge=None, log_transcript=None):
         """Run the wizard's interactive loop.
 
@@ -464,10 +541,20 @@ def choice_future_factory(choice_data: dict) -> asyncio.Future:
         # (only to clients allowed to drive — viewers never auto-hold).
         _clients[client_id] = send_fn
         _client_labels[client_id] = client_label
+        _raw_clients[client_id] = websocket
         if _control["holder"] is None and can_control:
             _control["holder"] = client_id
         await _broadcast_control_status()
 
+        # Replay the uniform session transcript so every client (and every
+        # reconnect/refresh) shows the same conversation.
+        _load_history_once(bridge)
+        if _history:
+            try:
+                await websocket.send_json({"type": "history", "items": list(_history)})
+            except Exception:
+                pass
+
         try:
             # ── Wizard phase ──────────────────────────────────────
             # Run startup wizard (if needed) before entering the REPL.
@@ -606,11 +693,19 @@ async def _run_resolution_bootstrap():
                     if active_task and not active_task.done():
                         active_task.cancel()
 
+                    # Echo the user's message to ALL clients (so observers see
+                    # what was asked), then stream the reply to everyone.
+                    await _broadcast({"type": "user_message", "text": text,
+                                      "author": client_label})
                     active_task = asyncio.create_task(
-                        bridge.stream_response(text, send_fn, choice_future_factory)
+                        bridge.stream_response(text, _broadcast, choice_future_factory)
                     )
 
                 elif msg_type == "choice_response":
+                    # Only the control holder answers pickers (observers see
+                    # them read-only).
+                    if _control["holder"] != client_id:
+                        continue
                     request_id = data.get("request_id", "")
                     selected = data.get("selected", "")
                     # Check if bridge owns this choice (e.g. /import-embryos picker)
@@ -719,6 +814,7 @@ async def _run_resolution_bootstrap():
             # to any remaining client (or free it) and resync everyone.
             _clients.pop(client_id, None)
             _client_labels.pop(client_id, None)
+            _raw_clients.pop(client_id, None)
             if _control["holder"] == client_id:
                 _control["holder"] = next(iter(_clients), None)
                 try:
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 8a60f3a0..577d18bd 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -81,9 +81,47 @@ const AgentChat = (() => {
         return content;
     }
 
-    function addUserMessage(text) {
-        const content = addTurn('user');
+    function addUserMessage(text, author) {
+        const wrap = document.createElement('div');
+        wrap.className = 'ac-turn ac-turn-user';
+        if (author) {
+            const label = document.createElement('div');
+            label.className = 'ac-role ac-role-user';
+            label.textContent = author;
+            wrap.appendChild(label);
+        }
+        const content = document.createElement('div');
+        content.className = 'ac-content';
         content.textContent = text;
+        wrap.appendChild(content);
+        log.appendChild(wrap);
+        scrollToBottom();
+    }
+
+    /** Rebuild the transcript from a persisted/replayed history list. */
+    function renderHistory(items) {
+        log.innerHTML = '';
+        currentAgentEl = null;
+        activityEl = null;
+        (items || []).forEach(it => {
+            if (it.role === 'user') {
+                addUserMessage(it.text, it.author);
+            } else if (it.role === 'agent') {
+                const c = addTurn('agent');
+                c._raw = it.text || '';
+                c.innerHTML = mdToHtml(c._raw);
+            } else if (it.role === 'tool') {
+                const el = document.createElement('div');
+                el.className = 'ac-tool ac-tool-done';
+                const dur = it.duration ? ` · ${(it.duration.toFixed ? it.duration.toFixed(1) : it.duration)}s` : '';
+                const summary = it.summary ? ` — ${escapeHtml(it.summary)}` : '';
+                el.innerHTML = `<span class="ac-tool-check">✓</span><span class="ac-tool-name">${escapeHtml(it.name || 'tool')}</span><span class="ac-tool-meta">${dur}${summary}</span>`;
+                log.appendChild(el);
+            } else if (it.role === 'system') {
+                addSystemLine(it.text, it.level || 'info');
+            }
+        });
+        scrollToBottom();
     }
 
     function addSystemLine(text, level = 'info') {
@@ -108,6 +146,15 @@ const AgentChat = (() => {
                 renderControl();
                 break;
 
+            case 'history':
+                renderHistory(msg.items || []);
+                break;
+
+            case 'user_message':
+                hideActivity();
+                addUserMessage(msg.text, msg.author);
+                break;
+
             case 'stream_start':
                 streaming = true;
                 currentAgentEl = null;  // created lazily on first text
@@ -215,7 +262,7 @@ const AgentChat = (() => {
         (data.options || []).forEach(opt => {
             const btn = document.createElement('button');
             btn.className = 'ac-choice-opt';
-            btn.disabled = !!opt.disabled;
+            btn.disabled = !!opt.disabled || !hasControl;  // observers see it read-only
             const desc = opt.description ? `<span class="ac-choice-desc">${escapeHtml(opt.description)}</span>` : '';
             btn.innerHTML = `<span class="ac-choice-label">${escapeHtml(opt.label)}</span>${desc}`;
             btn.addEventListener('click', () => {
@@ -330,11 +377,11 @@ const AgentChat = (() => {
         const text = input.value.trim();
         if (!text) return;
         if (!hasControl) { renderControl(); return; }
-        addUserMessage(text);
         if (text.startsWith('/')) {
-            send({ type: 'command', command: text });  // slash commands (e.g. /status)
+            addUserMessage(text);                       // commands aren't broadcast; echo locally
+            send({ type: 'command', command: text });   // slash commands (e.g. /status)
         } else {
-            send({ type: 'chat', text });
+            send({ type: 'chat', text });               // echoed to all via 'user_message'
         }
         // Instant feedback before the first chunk arrives.
         setBusy(true);

From f6aad7452fd1ef4b9e49ed1311709faa2a04f313 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:30:53 -0400
Subject: [PATCH 030/314] fix(store): crash-safe atomic YAML/JSON writes (V3)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

_write_yaml and save_conversation wrote to a temp file, then unlink()'d the
target and rename()'d — a non-atomic window where a crash/power-loss between
unlink and rename leaves the file (session.yaml, embryo.yaml, conversation
.json, timelapse state) missing or truncated. The very files /resume depends
on were the ones at risk.

Use os.replace(tmp, path) (atomic + overwrites on Windows) and fsync the temp
before the swap, so the target always reflects either the old or new content,
never a gap.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/core/file_store.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 1abbc971..0231c14c 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -156,10 +156,11 @@ def _write_yaml(path: Path, data: Any) -> None:
         with os.fdopen(fd, "w", encoding="utf-8") as f:
             yaml.safe_dump(data, f, default_flow_style=False, sort_keys=False,
                            allow_unicode=True)
-        # On Windows, rename over an existing file requires removing it first.
-        if path.exists():
-            path.unlink()
-        Path(tmp).rename(path)
+            f.flush()
+            os.fsync(f.fileno())
+        # os.replace is atomic and overwrites on Windows — no unlink gap that
+        # a crash/power-loss could leave the target missing.
+        os.replace(tmp, path)
     except BaseException:
         # Clean up temp file on failure
         try:
@@ -410,9 +411,9 @@ def save_session_snapshot(self, session_id: str, snapshot: dict) -> None:
         try:
             with os.fdopen(fd, "w", encoding="utf-8") as f:
                 json.dump(snapshot, f, indent=2, ensure_ascii=False, default=str)
-            if path.exists():
-                path.unlink()
-            Path(tmp).rename(path)
+                f.flush()
+                os.fsync(f.fileno())
+            os.replace(tmp, path)
         except BaseException:
             try:
                 os.unlink(tmp)

From 7698decb4019bc7c924b6811a7a4d293a2c631f4 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:31:49 -0400
Subject: [PATCH 031/314] fix(tools): get_timelapse_status crashed with
 KeyError (V1)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The status tool read status_dict['next_embryo'],
['next_acquisition_in_seconds'] and per-embryo ['interval_seconds'] — none of
which TimelapseState.to_dict() emits (it has next_round_time /
seconds_until_next_round, and embryo_details carries timepoints / is_complete
/ completion_reason). Every successful call raised KeyError, so the
biologist's primary "is it working?" tool was broken.

Use the real keys: report seconds_until_next_round for the next acquisition
and drop the unavailable per-embryo interval from the line.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/tools/timelapse_tools.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index fad0ff95..2e01fa60 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -142,16 +142,15 @@ def get_timelapse_status(context: Dict = None) -> str:
     lines.append(f"Completed embryos: {status_dict['completed_embryos']}")
     lines.append("")
 
-    if status_dict['next_embryo']:
-        lines.append(f"Next acquisition: {status_dict['next_embryo']} in {status_dict['next_acquisition_in_seconds']:.0f}s")
+    if status_dict.get('seconds_until_next_round') is not None:
+        lines.append(f"Next acquisition in {status_dict['seconds_until_next_round']:.0f}s")
         lines.append("")
 
     if status_dict['embryo_details']:
         lines.append("Embryo Details:")
         for eid, details in status_dict['embryo_details'].items():
             status_marker = "[done]" if details['is_complete'] else "[active]"
-            lines.append(f"  {status_marker} {eid}: t={details['timepoints']} "
-                        f"(interval={details['interval_seconds']}s)")
+            lines.append(f"  {status_marker} {eid}: t={details['timepoints']}")
             if details['is_complete']:
                 lines.append(f"      Completed: {details['completion_reason']}")
 

From 8e3531b14709d4b05999f6c60efe2554a95243e0 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:32:07 -0400
Subject: [PATCH 032/314] =?UTF-8?q?fix(launcher):=20unify=20storage=20env?=
 =?UTF-8?q?=20var=20=E2=80=94=20logs=20follow=20data=20(V4)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The launcher read GENTLY_STORAGE for its log directory while the rest of the
system uses GENTLY_STORAGE_PATH (via settings.storage.base_path). Setting only
one silently split logs from data. Use settings.storage.base_path for the log
dir too so both honor the same configured root.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 launch_gently.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/launch_gently.py b/launch_gently.py
index 37d4913c..6caa3cba 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -154,7 +154,11 @@ def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
 
 async def main(offline: bool = False, resume_session: str = None, show_sessions: bool = False, pick_session: bool = False, log_level: str = "WARNING", no_browser: bool = False):
     # Set up log file in storage directory
-    storage_base = Path(os.environ.get("GENTLY_STORAGE", "D:/Gently3"))
+    # Unified with FileStore: logs live under the same root as data
+    # (settings.storage.base_path reads GENTLY_STORAGE_PATH). Previously this
+    # read a separate GENTLY_STORAGE env var, so setting only one split logs
+    # from data.
+    storage_base = settings.storage.base_path
     log_dir = storage_base / "logs"
     log_dir.mkdir(parents=True, exist_ok=True)
     log_file = str(log_dir / f"gently_{datetime.now().strftime('%Y%m%d_%H%M%S')}.log")

From 2f4e3e61f4288dfbcd4104d2c3f38630407ba0af Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:33:21 -0400
Subject: [PATCH 033/314] fix(web): escape event text to close events-table XSS
 (V6)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

highlightSearchTerms returned arbitrary event data (perception reasoning,
file paths, agent free-text) unescaped, and callers assigned it via innerHTML
— so any '<' in event data was interpreted as markup (a real injection
surface). Escape the input before inserting the search <mark> tags; this
closes the hole at every call site (event key/value, log message, logger
name) since they all route through this function.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/js/events.js | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/gently/ui/web/static/js/events.js b/gently/ui/web/static/js/events.js
index 3e37eb66..998431a1 100644
--- a/gently/ui/web/static/js/events.js
+++ b/gently/ui/web/static/js/events.js
@@ -101,12 +101,17 @@ function eventMatchesSearch(event) {
 }
 
 function highlightSearchTerms(text) {
-    if (!searchQuery || !text) return text;
+    // Escape first — event keys/values/messages are arbitrary text (perception
+    // prose, file paths, agent output) and are inserted via innerHTML by the
+    // callers. Escaping here closes the XSS hole at every call site; the
+    // injected <mark> tags are the only markup we add.
+    const safe = escapeHtml(text == null ? '' : String(text));
+    if (!searchQuery) return safe;
     try {
         const regex = new RegExp(`(${escapeRegex(searchQuery)})`, 'gi');
-        return String(text).replace(regex, '<mark class="search-highlight">$1</mark>');
+        return safe.replace(regex, '<mark class="search-highlight">$1</mark>');
     } catch (e) {
-        return text;
+        return safe;
     }
 }
 

From 2b94ffe0275cb3dc5a63fb137eca9896b1b96a6d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 00:33:54 -0400
Subject: [PATCH 034/314] =?UTF-8?q?docs:=20update=20progress=20=E2=80=94?=
 =?UTF-8?q?=20auth,=20gating,=20transcript,=20verified=20bugs=20done?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 notes/biologist-readiness-plan.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/notes/biologist-readiness-plan.md b/notes/biologist-readiness-plan.md
index 00aae259..701a4fc5 100644
--- a/notes/biologist-readiness-plan.md
+++ b/notes/biologist-readiness-plan.md
@@ -316,7 +316,11 @@ Incremental — the backend protocol for agent control already exists (`/ws/agen
 - **[done] Milestone A (start):** floating agent-chat window in the web UI (`static/js/agent-chat.js`, `static/css/agent-chat.css`, wired into `index.html`) connecting to `/ws/agent` with streaming + choice pickers + applied-spec cards + slash-command routing, XSS-safe.
 - **[done] Milestone B (seed):** single-driver control lock in `routes/agent_ws.py` (holder drives; observers get a "Take control" banner; control passes on disconnect). Fixes latent V7. *Not yet gated by auth — that's the next increment.*
 - **[done] Milestone E/F (TUI retired + launcher reshaped):** `launch_gently.py` no longer spawns the Node TUI — it starts the agent + viz server, prints a launch banner (URL · device status [fixes V5] · storage · Ctrl-C), auto-opens the browser (`--no-browser` to suppress), and serves until interrupted. Node/dist requirement removed; `--resume`/bare `--resume` resolves to most-recent (interactive picker deferred to the web). TUI source kept in-tree (reversible), `run_ink_picker` retained for reference.
-- **[‼ NEXT] Auth gating:** with the TUI gone, the browser is the *only* control path and it is **unauthenticated on the LAN**. Bind viz to `127.0.0.1` or trust the LAN until self-managed accounts + viewer/operator roles land. This is now the top priority.
+- **[done] Self-managed auth + roles:** `accounts.py` (PBKDF2 users, HMAC session cookies, first-run admin bootstrap), `auth.py` cookie-aware `resolve_role`, `/login` + `/api/auth/*`, `/ws/agent` authenticates and gates control by role. Viewing is **open** (anonymous watch); login elevates to control; admin/operator/viewer. `GENTLY_NO_AUTH=1` disables.
+- **[done] Control-action gating pass:** perception-chat POST + `/ws` marking actions gated to control role (`require_control` / session cookie). Device-ingest + campaign-mesh routes deliberately left to their own machine/mesh auth (documented).
+- **[done] Uniform session transcript:** user messages + agent stream broadcast to ALL `/ws/agent` clients (observers watch live); display history persisted to `<session>/chat_display.json` and replayed on connect so refreshes/late-joiners see the full conversation. Choice pickers interactive only for the holder.
+- **[done] Verified bugs:** V1 `get_timelapse_status` KeyError, V3 crash-safe atomic writes (`os.replace`+fsync), V4 storage env-var unify, V6 events-table XSS escape. Plus the Windows Ctrl-C launcher fix.
+- **[remaining] Not yet done (need tests / live verification):** V2 acquisition auto-resume (add round-trip tests first), dead-calibration-code + SQLite-stack deletion (grep + test migration), device/perception transient-failure hardening, friendly organism/hardware config errors, machine-token auth for device-ingest endpoints.
 
 ---
 

From 2038bf7846f1a9969c932cf3390ab73d15700e03 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 05:37:57 -0400
Subject: [PATCH 035/314] feat(web): resume a session from the Sessions tab

The Sessions tab was empty: /api/sessions globbed sessions_dir/*.json, but
Gently3's FileStore stores each session as a directory (session.yaml). And
there was no way to switch the live agent's session from the browser after
the TUI session picker was retired.

- /api/sessions now lists from the live FileStore (via the agent), with an
  `active` flag for the current session.
- New control-gated POST /api/sessions/{id}/resume calls agent.resume_session
  (the same machinery as CLI resume: saves current, loads target's embryos +
  conversation), then broadcasts `session_changed` so all browsers reload.
- agent_ws transcript is now session-aware: _load_history reloads the
  display history when the session id changes, so a resumed session shows its
  own conversation instead of the previous one.
- Sessions tab: a "Resume in agent" button per session (active one badged);
  /ws clients reload on `session_changed`.

Note: resume restores embryos + conversation; restarting a previously-running
timelapse on resume is the separate V2 auto-resume item (not yet wired).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py     | 21 ++++--
 gently/ui/web/routes/sessions.py     | 97 ++++++++++++++++++++++------
 gently/ui/web/static/css/review.css  | 27 ++++++++
 gently/ui/web/static/js/review.js    | 22 ++++++-
 gently/ui/web/static/js/websocket.js |  4 ++
 5 files changed, 143 insertions(+), 28 deletions(-)

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index 570c112a..0ffd9d76 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -48,7 +48,7 @@ def create_router(server) -> APIRouter:
     # Persisted to <session>/chat_display.json so it survives reconnects and
     # restarts; broadcast live so all instances stay in sync.
     _history: list = []
-    _history_state = {"loaded": False, "path": None, "agent_buf": None}
+    _history_state = {"sid": None, "path": None, "agent_buf": None}
 
     async def _broadcast_control_status():
         """Tell every connected agent client who currently holds control."""
@@ -65,14 +65,23 @@ async def _broadcast_control_status():
             except Exception:
                 pass
 
-    def _load_history_once(bridge):
-        if _history_state["loaded"]:
-            return
-        _history_state["loaded"] = True
+    def _load_history_for_session(bridge):
+        """Load the current session's display history, reloading if the
+        session changed (e.g. after a resume from the Sessions tab)."""
         try:
             agent = bridge.agent
             store = getattr(agent, "store", None)
             sid = getattr(agent, "session_id", None)
+        except Exception:
+            return
+        if sid == _history_state["sid"]:
+            return  # already loaded for this session
+        # Session changed (or first load): reset and reload from disk.
+        _history.clear()
+        _history_state["sid"] = sid
+        _history_state["path"] = None
+        _history_state["agent_buf"] = None
+        try:
             if store and sid:
                 sdir = store._session_dir(sid)
                 if sdir:
@@ -548,7 +557,7 @@ def choice_future_factory(choice_data: dict) -> asyncio.Future:
 
         # Replay the uniform session transcript so every client (and every
         # reconnect/refresh) shows the same conversation.
-        _load_history_once(bridge)
+        _load_history_for_session(bridge)
         if _history:
             try:
                 await websocket.send_json({"type": "history", "items": list(_history)})
diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index 69d70d47..9447738a 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -1,9 +1,11 @@
-"""Session routes - list and retrieve saved sessions."""
+"""Session routes - list, retrieve, and resume saved sessions."""
 
 import json
 import logging
 
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter, Depends, HTTPException
+
+from gently.ui.web.auth import require_control
 
 logger = logging.getLogger(__name__)
 
@@ -11,28 +13,83 @@
 def create_router(server) -> APIRouter:
     router = APIRouter()
 
+    def _file_store():
+        """The live FileStore (current Gently3 layout), via the agent."""
+        bridge = getattr(server, "agent_bridge", None)
+        if bridge is not None and getattr(bridge, "agent", None) is not None:
+            st = getattr(bridge.agent, "store", None)
+            if st is not None:
+                return st
+        return getattr(server, "gently_store", None)
+
+    def _active_session_id():
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        return getattr(agent, "session_id", None) if agent is not None else None
+
     @router.get("/api/sessions")
     async def list_sessions():
-        """List available sessions with metadata"""
+        """List available sessions (from the live FileStore)."""
+        store = _file_store()
+        if store is None:
+            return {"sessions": []}
+        active_id = _active_session_id()
         sessions = []
-        if server.sessions_dir.exists():
-            for path in server.sessions_dir.glob("*.json"):
+        try:
+            for s in store.list_sessions():
+                sid = s.get("session_id")
                 try:
-                    with open(path, encoding='utf-8') as f:
-                        data = json.load(f)
-                    sessions.append({
-                        'session_id': data.get('session_id', path.stem),
-                        'name': data.get('name', path.stem),
-                        'created_at': data.get('created_at', ''),
-                        'last_active': data.get('last_active', ''),
-                        'embryo_count': len(data.get('embryo_states', {})),
-                        'description': data.get('description', '')
-                    })
-                except Exception as e:
-                    logger.warning(f"Failed to read session {path}: {e}")
-        # Sort by created_at descending (newest first)
-        sessions.sort(key=lambda x: x.get('created_at', ''), reverse=True)
-        return {'sessions': sessions}
+                    count = len(store.list_embryos(sid) or [])
+                except Exception:
+                    count = 0
+                sessions.append({
+                    "session_id": sid,
+                    "name": s.get("name") or sid,
+                    "created_at": s.get("created_at", ""),
+                    "last_active": s.get("last_active", ""),
+                    "embryo_count": count,
+                    "description": s.get("description", ""),
+                    "active": sid == active_id,
+                })
+        except Exception as e:
+            logger.warning("Failed to list sessions from FileStore: %s", e)
+        return {"sessions": sessions}
+
+    @router.post("/api/sessions/{session_id}/resume",
+                 dependencies=[Depends(require_control)])
+    async def resume_session(session_id: str):
+        """Switch the live agent to a different saved session.
+
+        Reuses the same machinery as CLI resume (saves the current session,
+        loads the target's embryos + conversation). Then nudges all browser
+        clients to reload so they pick up the new session's state and
+        transcript.
+        """
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        if agent is None:
+            raise HTTPException(status_code=503, detail="Agent not ready")
+        store = getattr(agent, "store", None)
+        if store is None or store.get_session(session_id) is None:
+            raise HTTPException(status_code=404, detail="Session not found")
+        if session_id == getattr(agent, "session_id", None):
+            return {"ok": True, "session_id": session_id, "active": True,
+                    "note": "already active"}
+        try:
+            ok = agent.resume_session(session_id)
+        except Exception as e:
+            logger.exception("Session resume failed")
+            raise HTTPException(status_code=500, detail=f"resume failed: {e}")
+        if not ok:
+            raise HTTPException(status_code=500, detail="resume returned false")
+        # Tell every connected browser to reload — they'll reconnect to the
+        # new session's state (embryos, transcript).
+        try:
+            await server.manager.broadcast({"type": "session_changed",
+                                            "session_id": session_id})
+        except Exception:
+            pass
+        return {"ok": True, "session_id": session_id, "active": True}
 
     @router.get("/api/sessions/{session_id}")
     async def get_session(session_id: str):
diff --git a/gently/ui/web/static/css/review.css b/gently/ui/web/static/css/review.css
index de2bd66d..735d42a5 100644
--- a/gently/ui/web/static/css/review.css
+++ b/gently/ui/web/static/css/review.css
@@ -443,3 +443,30 @@
     color: var(--text-muted);
 }
 
+
+/* Resume-in-agent action on session list items */
+.session-resume-btn {
+    margin-top: 8px;
+    padding: 5px 10px;
+    border-radius: 7px;
+    border: 1px solid var(--accent, #60a5fa);
+    background: transparent;
+    color: var(--accent, #60a5fa);
+    font-size: 12px;
+    font-weight: 600;
+    cursor: pointer;
+}
+.session-resume-btn:hover { background: var(--accent, #60a5fa); color: #fff; }
+.session-active-badge {
+    font-size: 10px;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    color: var(--accent-green, #4ade80);
+    border: 1px solid var(--accent-green, #4ade80);
+    border-radius: 999px;
+    padding: 1px 7px;
+    margin-left: 6px;
+    vertical-align: middle;
+}
+.session-item.active-session { border-left: 2px solid var(--accent-green, #4ade80); }
diff --git a/gently/ui/web/static/js/review.js b/gently/ui/web/static/js/review.js
index bd2c75fa..07dcf49e 100644
--- a/gently/ui/web/static/js/review.js
+++ b/gently/ui/web/static/js/review.js
@@ -86,17 +86,35 @@ const ReviewApp = {
         }
 
         list.innerHTML = filtered.map(s => `
-            <div class="session-item" data-session-id="${s.session_id}" onclick="ReviewApp.loadSession('${s.session_id}')">
-                <div class="session-name">${this.escapeHtml(s.name || s.session_id)}</div>
+            <div class="session-item ${s.active ? 'active-session' : ''}" data-session-id="${s.session_id}" onclick="ReviewApp.loadSession('${s.session_id}')">
+                <div class="session-name">${this.escapeHtml(s.name || s.session_id)}${s.active ? ' <span class="session-active-badge">active</span>' : ''}</div>
                 <div class="session-meta">
                     ${this.formatDate(s.created_at)}
                     ${s.embryo_count ? `<span class="dot"></span>${s.embryo_count} embryo${s.embryo_count !== 1 ? 's' : ''}` : ''}
                 </div>
                 ${s.description ? `<div class="session-desc">${this.escapeHtml(s.description)}</div>` : ''}
+                ${s.active ? '' : `<button class="session-resume-btn" onclick="event.stopPropagation(); ReviewApp.resumeSession('${s.session_id}')">Resume in agent</button>`}
             </div>
         `).join('');
     },
 
+    async resumeSession(sessionId) {
+        if (!confirm('Switch the live agent to this session?\nThe current session is saved first.')) return;
+        try {
+            const resp = await fetch(`/api/sessions/${sessionId}/resume`, { method: 'POST' });
+            if (resp.ok) {
+                // Server broadcasts session_changed to reload all clients; we
+                // navigate home as well so the operator lands on the new session.
+                window.location.href = '/';
+            } else {
+                const d = await resp.json().catch(() => ({}));
+                alert('Resume failed: ' + (d.detail || ('HTTP ' + resp.status)));
+            }
+        } catch (e) {
+            alert('Resume failed: ' + e);
+        }
+    },
+
     renderSessionContent() {
         const content = document.getElementById('session-content');
         const s = this.currentSession;
diff --git a/gently/ui/web/static/js/websocket.js b/gently/ui/web/static/js/websocket.js
index 38a2794c..1e3a534c 100644
--- a/gently/ui/web/static/js/websocket.js
+++ b/gently/ui/web/static/js/websocket.js
@@ -127,6 +127,10 @@ function handleMessage(msg) {
             // Switch to embryos tab if not already there
             if (state.tab !== 'embryos') switchTab('embryos');
         }
+    } else if (msg.type === 'session_changed') {
+        // The live agent switched sessions (resume from the Sessions tab) —
+        // reload so every client picks up the new session's state + transcript.
+        window.location.href = '/';
     } else if (msg.type === 'ping') {
         state.ws.send(JSON.stringify({type: 'pong'}));
     } else if (msg.type === 'presence') {

From a14372dfd8a16ec2d13b1b1f204dd80ffb03c2d4 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 05:39:42 -0400
Subject: [PATCH 036/314] fix(config): friendly errors for unknown
 organism/hardware
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

load_organism / load_hardware raised a raw ModuleNotFoundError on a typo'd
config value. Now they raise a clear ValueError listing the available plugins
("Unknown organism 'celgans'. Available: celegans. Set 'organism:' in
config/config.yml.") — while re-raising if a dependency *inside* a valid
plugin module is what's actually missing, so real import errors aren't masked.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/__init__.py  | 25 +++++++++++++++++++++++--
 gently/organisms/__init__.py | 26 ++++++++++++++++++++++++--
 2 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/gently/hardware/__init__.py b/gently/hardware/__init__.py
index 2f07e9ce..c8886da7 100644
--- a/gently/hardware/__init__.py
+++ b/gently/hardware/__init__.py
@@ -14,14 +14,24 @@
 
 import importlib
 import logging
+import pkgutil
 from types import ModuleType
-from typing import Optional
+from typing import List, Optional
 
 logger = logging.getLogger(__name__)
 
 _active_hardware: Optional[ModuleType] = None
 
 
+def available_hardware() -> List[str]:
+    """Names of the hardware plugins shipped under gently.hardware."""
+    import gently.hardware as _pkg
+    return sorted(
+        m.name for m in pkgutil.iter_modules(_pkg.__path__)
+        if m.ispkg and not m.name.startswith("_")
+    )
+
+
 def load_hardware(name: str) -> ModuleType:
     """
     Load a hardware module by name and set it as active.
@@ -43,7 +53,18 @@ def load_hardware(name: str) -> ModuleType:
         If the hardware module cannot be found.
     """
     global _active_hardware
-    module = importlib.import_module(f"gently.hardware.{name}")
+    try:
+        module = importlib.import_module(f"gently.hardware.{name}")
+    except ModuleNotFoundError as e:
+        # Only a missing hardware *package* is a config error; re-raise if a
+        # dependency inside the module is what's missing.
+        if e.name in (f"gently.hardware.{name}", name):
+            avail = ", ".join(available_hardware()) or "(none found)"
+            raise ValueError(
+                f"Unknown hardware '{name}'. Available: {avail}. "
+                f"Set 'hardware:' in config/config.yml."
+            ) from e
+        raise
     _active_hardware = module
     logger.info("Loaded hardware module: %s", name)
     return module
diff --git a/gently/organisms/__init__.py b/gently/organisms/__init__.py
index d388ab60..e4f9d522 100644
--- a/gently/organisms/__init__.py
+++ b/gently/organisms/__init__.py
@@ -14,14 +14,24 @@
 
 import importlib
 import logging
+import pkgutil
 from types import ModuleType
-from typing import Optional
+from typing import List, Optional
 
 logger = logging.getLogger(__name__)
 
 _active_organism: Optional[ModuleType] = None
 
 
+def available_organisms() -> List[str]:
+    """Names of the organism plugins shipped under gently.organisms."""
+    import gently.organisms as _pkg
+    return sorted(
+        m.name for m in pkgutil.iter_modules(_pkg.__path__)
+        if m.ispkg and not m.name.startswith("_")
+    )
+
+
 def load_organism(name: str) -> ModuleType:
     """
     Load an organism module by name and set it as active.
@@ -43,7 +53,19 @@ def load_organism(name: str) -> ModuleType:
         If the organism module cannot be found.
     """
     global _active_organism
-    module = importlib.import_module(f"gently.organisms.{name}")
+    try:
+        module = importlib.import_module(f"gently.organisms.{name}")
+    except ModuleNotFoundError as e:
+        # Only treat a missing organism *package* as a config error; if a
+        # dependency *inside* the organism module is missing, re-raise so the
+        # real ImportError isn't masked.
+        if e.name in (f"gently.organisms.{name}", name):
+            avail = ", ".join(available_organisms()) or "(none found)"
+            raise ValueError(
+                f"Unknown organism '{name}'. Available: {avail}. "
+                f"Set 'organism:' in config/config.yml."
+            ) from e
+        raise
     _active_organism = module
     logger.info("Loaded organism module: %s (%s)", name, module.ORGANISM_DISPLAY_NAME)
     return module

From 638f827ed3106dbb66ea4c42f3ffd3e24f1760dc Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 05:41:16 -0400
Subject: [PATCH 037/314] fix(web): serve session review data from FileStore

GET /api/sessions/{id} still read sessions_dir/{id}.json (old layout), so
clicking a session in the Sessions tab 404'd. Map the FileStore session
snapshot onto the review view's shape (embryo_states from experiment_data,
conversation from conversation_history). detection_history is left empty for
now (per-timepoint predictions live in a separate store). Drops the now-unused
json import.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/sessions.py | 32 +++++++++++++++++++++++---------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index 9447738a..d47a146b 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -1,6 +1,5 @@
 """Session routes - list, retrieve, and resume saved sessions."""
 
-import json
 import logging
 
 from fastapi import APIRouter, Depends, HTTPException
@@ -93,14 +92,29 @@ async def resume_session(session_id: str):
 
     @router.get("/api/sessions/{session_id}")
     async def get_session(session_id: str):
-        """Get full session state for review"""
-        path = server.sessions_dir / f"{session_id}.json"
-        if not path.exists():
+        """Get session state for review, from the live FileStore.
+
+        Maps the FileStore session snapshot onto the shape the Sessions review
+        view expects (embryo_states / conversation). detection_history isn't
+        reconstructed here (per-timepoint predictions live elsewhere).
+        """
+        store = _file_store()
+        if store is None:
+            raise HTTPException(status_code=503, detail="Store not available")
+        info = store.get_session(session_id)
+        if info is None:
             raise HTTPException(status_code=404, detail="Session not found")
-        try:
-            with open(path, encoding='utf-8') as f:
-                return json.load(f)
-        except Exception as e:
-            raise HTTPException(status_code=500, detail=f"Failed to load session: {e}")
+        snapshot = store.load_session_snapshot(session_id) or {}
+        experiment = snapshot.get("experiment_data", {}) or {}
+        return {
+            "session_id": session_id,
+            "name": info.get("name") or session_id,
+            "description": info.get("description", ""),
+            "created_at": info.get("created_at", ""),
+            "last_active": info.get("last_active", ""),
+            "embryo_states": experiment.get("embryos", {}) or {},
+            "conversation": snapshot.get("conversation_history", []) or [],
+            "detection_history": {},
+        }
 
     return router

From cf2c24e212cc6191120a39ffdc863fbb5f09e4c2 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 05:56:15 -0400
Subject: [PATCH 038/314] fix(web): resumed sessions show history + correct
 session id
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two fixes for the confusing "resume shows an empty session" experience
(the data was always safe on disk; it just wasn't surfaced):

- Chat history: when a session has no chat_display.json (created before the
  uniform-transcript feature, or resumed for the first time), derive a
  best-effort transcript from the saved Claude conversation
  (conversation_history) so the chat panel shows the prior conversation
  instead of nothing.
- Header session id: the top-left session label is driven by the timelapse
  tracker's session_id, which goes stale after a resume with no active
  timelapse — so the header showed the launch session, not the resumed one.
  The /ws connect now overrides it with the live agent session_id.

Still open (separate, larger): rehydrating the viz image/projection/trace
stores from disk on resume so a resumed session's volumes/traces/calibration
actually display, and the apparent embryo double-count on resume.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py  | 26 ++++++++++++++++++++++++++
 gently/ui/web/routes/websocket.py | 11 +++++++++++
 2 files changed, 37 insertions(+)

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index 0ffd9d76..0d27a5d0 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -94,6 +94,32 @@ def _load_history_for_session(bridge):
         except Exception:
             logger.debug("Could not load chat history", exc_info=True)
 
+        # Fallback: sessions created before chat_display.json existed (or any
+        # session resumed for the first time) — derive a best-effort transcript
+        # from the saved Claude conversation so the chat still shows history.
+        if not _history and store and sid:
+            try:
+                snap = store.load_session_snapshot(sid) or {}
+                for m in (snap.get("conversation_history") or []):
+                    role = m.get("role")
+                    content = m.get("content")
+                    if isinstance(content, list):
+                        text = "".join(
+                            b.get("text", "") for b in content
+                            if isinstance(b, dict) and b.get("type") == "text"
+                        )
+                    else:
+                        text = content if isinstance(content, str) else ""
+                    text = (text or "").strip()
+                    if not text:
+                        continue
+                    if role == "user":
+                        _history.append({"role": "user", "text": text})
+                    elif role == "assistant":
+                        _history.append({"role": "agent", "text": text})
+            except Exception:
+                logger.debug("Could not derive history from conversation", exc_info=True)
+
     def _save_history():
         p = _history_state["path"]
         if not p:
diff --git a/gently/ui/web/routes/websocket.py b/gently/ui/web/routes/websocket.py
index 3dce3320..3b35f3e1 100644
--- a/gently/ui/web/routes/websocket.py
+++ b/gently/ui/web/routes/websocket.py
@@ -56,6 +56,17 @@ async def websocket_endpoint(websocket: WebSocket):
             # Always send timelapse state on connect so client can reconcile
             # (if IDLE with no session_id, client will clear stale cached state)
             timelapse_state = server.timelapse_tracker.to_dict()
+            # The header's session id is driven by this payload; the tracker's
+            # session_id goes stale after a resume with no active timelapse, so
+            # override it with the live agent session (the source of truth).
+            try:
+                bridge = getattr(server, "agent_bridge", None)
+                if bridge is not None and getattr(bridge, "agent", None) is not None:
+                    live_sid = bridge.agent.session_id
+                    if live_sid:
+                        timelapse_state["session_id"] = live_sid
+            except Exception:
+                pass
             await websocket.send_json({
                 "type": "timelapse_state",
                 "data": timelapse_state

From df3db33d5e0a50512e6e3efe37c3dfd3c415d89d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 06:02:01 -0400
Subject: [PATCH 039/314] feat(web): rehydrate viz imagery from disk on session
 resume
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Resuming a session restored embryo state but not the visual data: the viz
image store is in-memory (filled by live acquisition events), so a resumed
session's volumes/projections never appeared in the galleries/filmstrips even
though they were safe on disk.

- VisualizationServer.rehydrate_session(): enumerates the session's embryos x
  projection timepoints from the FileStore and adds lightweight ImageData
  entries (uid volume_{embryo}_t{NNNN}, no base64). JPEG pixels load lazily via
  /api/images/{uid}/png, which already falls back to the FileStore projection.
  Resets the store first so the previous session's images don't linger.
- FileStore.list_projection_timepoints(): cheap glob-only timepoint listing
  (avoids list_projections' per-file PIL/meta cost — matters for sessions with
  thousands of projections).
- _resolve_projection_path now uses the live agent session (via a new
  _current_session_id helper) instead of the stale timelapse-tracker session,
  so lazy projection serving targets the resumed session's folder.
- Wired into the resume endpoint and CLI --resume startup.

Verified against a real 256-projection session: all 256 rehydrate, filmstrip
sequences resolve, and the on-disk JPEGs serve.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/core/file_store.py        | 21 ++++++++++++
 gently/ui/web/routes/sessions.py | 12 +++++--
 gently/ui/web/server.py          | 56 ++++++++++++++++++++++++++++++--
 launch_gently.py                 |  7 ++++
 4 files changed, 91 insertions(+), 5 deletions(-)

diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 0231c14c..4b33dedd 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -792,6 +792,27 @@ def get_projection_path(
             return proj_path
         return None
 
+    def list_projection_timepoints(
+        self, session_id: str, embryo_id: str
+    ) -> List[int]:
+        """Cheaply list projection timepoints (glob only, no PIL/meta reads).
+
+        Used to rehydrate the viz image store on resume without paying the
+        per-file cost of list_projections().
+        """
+        sd = self._session_dir(session_id)
+        if sd is None:
+            return []
+        proj_dir = sd / "embryos" / embryo_id / "projections"
+        if not proj_dir.exists():
+            return []
+        tps: List[int] = []
+        for jpg in proj_dir.glob("t*.jpg"):
+            m = re.match(r"t(\d+)\.jpg$", jpg.name)
+            if m:
+                tps.append(int(m.group(1)))
+        return sorted(tps)
+
     def get_projection_b64(
         self, session_id: str, embryo_id: str, timepoint: int
     ) -> Optional[str]:
diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index d47a146b..58f3394d 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -81,14 +81,22 @@ async def resume_session(session_id: str):
             raise HTTPException(status_code=500, detail=f"resume failed: {e}")
         if not ok:
             raise HTTPException(status_code=500, detail="resume returned false")
+        # Rehydrate the viz image store from disk so the resumed session's
+        # projections/filmstrips show (pixels load lazily from the FileStore).
+        rehydrated = 0
+        try:
+            rehydrated = server.rehydrate_session(session_id)
+        except Exception:
+            logger.exception("rehydrate_session failed")
         # Tell every connected browser to reload — they'll reconnect to the
-        # new session's state (embryos, transcript).
+        # new session's state (embryos, transcript, rehydrated imagery).
         try:
             await server.manager.broadcast({"type": "session_changed",
                                             "session_id": session_id})
         except Exception:
             pass
-        return {"ok": True, "session_id": session_id, "active": True}
+        return {"ok": True, "session_id": session_id, "active": True,
+                "rehydrated_projections": rehydrated}
 
     @router.get("/api/sessions/{session_id}")
     async def get_session(session_id: str):
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index ff14f9bb..957e98fc 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -214,12 +214,24 @@ def _resolve_volume_path(self, embryo_id: str, timepoint: int) -> Optional[str]:
 
         return None
 
+    def _current_session_id(self) -> Optional[str]:
+        """The live agent session (source of truth), falling back to the
+        timelapse tracker. The tracker's session_id goes stale after a resume
+        with no active timelapse, so the live agent session is preferred."""
+        bridge = getattr(self, "agent_bridge", None)
+        if bridge is not None and getattr(bridge, "agent", None) is not None:
+            sid = getattr(bridge.agent, "session_id", None)
+            if sid:
+                return sid
+        return self.timelapse_tracker.session_id
+
     def _resolve_projection_path(self, embryo_id: str, timepoint: int) -> Optional[Path]:
-        """Resolve projection file path from FileStore."""
-        if self.gently_store and self.timelapse_tracker.session_id:
+        """Resolve projection file path from FileStore (current session)."""
+        sid = self._current_session_id()
+        if self.gently_store and sid:
             try:
                 proj_path = self.gently_store.get_projection_path(
-                    self.timelapse_tracker.session_id, embryo_id, timepoint,
+                    sid, embryo_id, timepoint,
                 )
                 if proj_path and proj_path.exists():
                     return proj_path
@@ -227,6 +239,44 @@ def _resolve_projection_path(self, embryo_id: str, timepoint: int) -> Optional[P
                 logger.debug(f"FileStore projection path lookup failed: {e}")
         return None
 
+    def rehydrate_session(self, session_id: str) -> int:
+        """Repopulate the in-memory image store with the FileStore's persisted
+        projections for a (resumed) session, so galleries and filmstrips show
+        its historical data.
+
+        Lightweight: only metadata-bearing ImageData entries are created (uid
+        ``volume_{embryo}_t{NNNN}``); the JPEG pixels load lazily on demand via
+        /api/images/{uid}/png (which falls back to the FileStore projection).
+        Resets the store first so the previous session's images don't linger.
+        Returns the number of projection entries added.
+        """
+        if self.gently_store is None or not session_id:
+            return 0
+        self.store = ImageStore()  # drop the previous session's images
+        added = 0
+        try:
+            embryos = self.gently_store.list_embryos(session_id) or []
+        except Exception:
+            embryos = []
+        for emb in embryos:
+            eid = emb.get("embryo_id") if isinstance(emb, dict) else getattr(emb, "embryo_id", None)
+            if not eid:
+                continue
+            try:
+                tps = self.gently_store.list_projection_timepoints(session_id, eid)
+            except Exception:
+                tps = []
+            for tp in tps:
+                self.store.add_image(ImageData(
+                    uid=f"volume_{eid}_t{tp:04d}",
+                    data_type="volume_projection",
+                    timestamp=f"{tp:06d}",  # monotonic with timepoint for ordering
+                    metadata={"embryo_id": eid, "timepoint": tp},
+                ))
+                added += 1
+        logger.info("Rehydrated %d projections for session %s", added, session_id)
+        return added
+
     def _subscribe_to_events(self):
         """Subscribe to EventBus for automatic updates - broadcasts ALL events"""
 
diff --git a/launch_gently.py b/launch_gently.py
index 6caa3cba..b6523bb2 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -438,6 +438,13 @@ def _status_provider():
     if agent.viz_server is not None:
         agent.viz_server.agent_bridge = bridge
         agent.viz_server.set_context_store(context_store)
+        # If launched into an existing session, rehydrate its persisted
+        # imagery so the galleries/filmstrips show data from the start.
+        if session_to_resume:
+            try:
+                agent.viz_server.rehydrate_session(session_to_resume)
+            except Exception:
+                logger.debug("Startup rehydrate failed", exc_info=True)
 
     # ── Banner + serve ──────────────────────────────────────────────
     # The viz server runs in-process (uvicorn in a background task). With

From c316399948af24448c58e2f620872aabc85dfba7 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 06:13:30 -0400
Subject: [PATCH 040/314] feat(web): rehydrate perception reasoning on resume
 (populates the views)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Projection rehydration made the imagery serve, but the Default/Film/reasoning
views stayed empty — those are driven by the tracker's detection_reasoning
(per-timepoint stage + reasoning + image uid), not the raw image store, and
resume never repopulated it.

Extend rehydrate_session to load predictions.jsonl per embryo and rebuild the
timelapse tracker's detection_reasoning + projection_uids + per-embryo
timepoints/current_stage. The reasoning items carry projection uids
(volume_{embryo}_t{NNNN}) so filmstrip thumbnails resolve via the lazy
FileStore projection path. to_dict() already emits detection_reasoning, so on
the post-resume reload the client populates the filmstrip, status board, and
reasoning panels.

Verified against the real session: 246 predictions rehydrate across 5 embryos
with stage progressions (early -> bean -> comma -> 1.5fold) and full reasoning.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/server.py | 51 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index 957e98fc..fc584cbc 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -274,6 +274,57 @@ def rehydrate_session(self, session_id: str) -> int:
                     metadata={"embryo_id": eid, "timepoint": tp},
                 ))
                 added += 1
+
+        # Rehydrate the timelapse tracker's per-embryo perception state from
+        # predictions.jsonl so the Default / Film / reasoning views populate
+        # (those are driven by detection_reasoning, not the raw image store).
+        # Thumbnails resolve via the projection uids added above.
+        tracker = self.timelapse_tracker
+        try:
+            tracker.session_id = session_id
+            tracker.detection_reasoning = {}
+            tracker.projection_uids = {}
+            for emb in embryos:
+                eid = emb.get("embryo_id") if isinstance(emb, dict) else getattr(emb, "embryo_id", None)
+                if not eid:
+                    continue
+                try:
+                    preds = self.gently_store.get_predictions(session_id, eid) or []
+                except Exception:
+                    preds = []
+                if not preds:
+                    continue
+                items, puids, last_stage = [], {}, None
+                for p in preds:
+                    tp = p.get("timepoint")
+                    if tp is None:
+                        continue
+                    uid = f"volume_{eid}_t{tp:04d}"
+                    puids[tp] = uid
+                    stage = p.get("predicted_stage")
+                    last_stage = stage or last_stage
+                    items.append({
+                        "timepoint": tp,
+                        "stage": stage,
+                        "detected_stage": stage,
+                        "reasoning": p.get("reasoning"),
+                        "confidence": p.get("confidence"),
+                        "projection_uid": uid,
+                        "image_uid": uid,
+                        "detector_name": "perception",
+                    })
+                tracker.detection_reasoning[eid] = items
+                tracker.projection_uids[eid] = puids
+                entry = tracker.embryos.setdefault(eid, {
+                    "embryo_id": eid, "timepoints": 0, "is_complete": False,
+                    "detections": {}, "current_stage": None,
+                })
+                entry["timepoints"] = max((it["timepoint"] for it in items), default=0)
+                entry["current_stage"] = last_stage
+            tracker.total_timepoints = sum(len(v) for v in tracker.detection_reasoning.values())
+        except Exception:
+            logger.exception("Tracker perception rehydration failed")
+
         logger.info("Rehydrated %d projections for session %s", added, session_id)
         return added
 

From 6d3cc12024a1db7a6af00c80d91ad388b41b0d4f Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:07:54 -0400
Subject: [PATCH 041/314] feat(web): filmstrip reasoning/detail panel on the
 side, not the bottom
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Film view stacked the rows above the detail (reasoning) panel, so it sat
at the bottom. Lay #view-filmstrip out as a flex row: scrollable rows on the
left, the reasoning/detail panel pinned to the right (flex 0 0 360px, own
scroll, border-left). The panel is hidden via :empty until a cell is clicked,
so the rows use the full width when nothing is selected.

Restores the side-panel layout (the weekend change appears to have been lost —
no commit for it in history, likely uncommitted). CSS-only: a hard refresh
picks it up.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css | 26 ++++++++++++++++++--------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index ea8dd142..fa584e30 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -3532,6 +3532,13 @@ kbd {
     padding: 0;
 }
 
+/* Filmstrip: rows on the left, reasoning/detail panel pinned on the right. */
+.view-filmstrip {
+    display: flex;
+    flex-direction: row;
+    overflow: hidden;  /* the two children scroll internally */
+}
+
 /* ========================================
    AMBIENT HEALTH PULSE
    ======================================== */
@@ -3714,8 +3721,11 @@ kbd {
        scrollbar shared by all rows. Labels pin to the left via
        position:sticky inside each row. */
     display: block;
+    flex: 1 1 auto;     /* take the space left of the detail panel */
+    min-width: 0;       /* allow shrinking so the panel keeps its width */
+    min-height: 0;
     overflow-x: auto;
-    overflow-y: hidden;
+    overflow-y: auto;
     scrollbar-width: thin;
     scrollbar-gutter: stable;
     position: relative;
@@ -3871,17 +3881,17 @@ kbd {
 }
 
 .filmstrip-detail {
+    /* Side panel: pinned to the right of the rows, full height, own scroll.
+       Hidden until a cell is clicked (see :empty below) so the rows use the
+       full width when nothing is selected. */
+    flex: 0 0 360px;
+    max-width: 42%;
+    border-left: 1px solid var(--border);
     background: var(--bg-card);
-    /* Cap the detail panel so it always leaves the rows visible AND
-       has a scrollable body of its own. Without this, when an item is
-       expanded the detail panel can grow past the viewport bottom and
-       the parent's scroll is unintuitive (mouse wheel over the rows
-       converts to horizontal). max-height keeps it bounded; overflow-y
-       lets long VLM summaries scroll on their own. */
-    max-height: 60vh;
     overflow-y: auto;
     overscroll-behavior: contain;
 }
+.filmstrip-detail:empty { display: none; }
 
 /* ========================================
    VITALS VIEW

From 8e3d26643df4452624b65db52c50b95807742f9d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:18:13 -0400
Subject: [PATCH 042/314] feat(web): restore the original filmstrip side-panel
 CSS (from lost WIP)

Replace my simpler side-panel layout with the polished version recovered from
the orphaned WIP commit 0269e18d (preserved as branch recovered-filmstrip-wip):
responsive width clamp(360px, 32vw, 520px), slide-in animation, :empty
collapse, and the #filmstrip-detail .detail-split vertical stack. The JS detail
rendering was already present in 0.21-dev, so this is CSS-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css | 33 ++++++++++++++++++++-----------
 1 file changed, 22 insertions(+), 11 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index fa584e30..aeb46a01 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -3532,11 +3532,13 @@ kbd {
     padding: 0;
 }
 
-/* Filmstrip: rows on the left, reasoning/detail panel pinned on the right. */
+/* Filmstrip: rows on the left, reasoning/detail panel pinned on the right.
+   (Recovered from the lost WIP commit 0269e18d.) */
 .view-filmstrip {
     display: flex;
     flex-direction: row;
-    overflow: hidden;  /* the two children scroll internally */
+    align-items: stretch;
+    overflow: hidden;
 }
 
 /* ========================================
@@ -3721,9 +3723,8 @@ kbd {
        scrollbar shared by all rows. Labels pin to the left via
        position:sticky inside each row. */
     display: block;
-    flex: 1 1 auto;     /* take the space left of the detail panel */
-    min-width: 0;       /* allow shrinking so the panel keeps its width */
-    min-height: 0;
+    flex: 1 1 0;        /* flex-1 child: shrinks/grows as the panel opens */
+    min-width: 0;
     overflow-x: auto;
     overflow-y: auto;
     scrollbar-width: thin;
@@ -3881,17 +3882,27 @@ kbd {
 }
 
 .filmstrip-detail {
-    /* Side panel: pinned to the right of the rows, full height, own scroll.
-       Hidden until a cell is clicked (see :empty below) so the rows use the
-       full width when nothing is selected. */
-    flex: 0 0 360px;
-    max-width: 42%;
-    border-left: 1px solid var(--border);
     background: var(--bg-card);
+    /* Right-side panel: fixed-ish width that shrinks gracefully on narrow
+       viewports. Scrolls vertically inside itself so long VLM summaries
+       don't push the layout. When empty (no frame selected) it collapses
+       entirely so the rows get full width. (Recovered from WIP 0269e18d.) */
+    flex: 0 0 auto;
+    width: clamp(360px, 32vw, 520px);
+    border-left: 1px solid var(--border);
     overflow-y: auto;
     overscroll-behavior: contain;
+    animation: filmstripDetailIn 0.18s ease-out;
 }
 .filmstrip-detail:empty { display: none; }
+@keyframes filmstripDetailIn {
+    from { transform: translateX(8px); opacity: 0; }
+    to   { transform: translateX(0);   opacity: 1; }
+}
+/* In the narrow side panel, stack the image | VLM summary split vertically. */
+#filmstrip-detail .detail-split {
+    grid-template-columns: 1fr;
+}
 
 /* ========================================
    VITALS VIEW

From 0c69e55cfb43c050f74aae9b369644fba5f7b5f9 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:26:35 -0400
Subject: [PATCH 043/314] fix(imaging): stored projection is the three-view of
 View A, not A|B
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

generate_jpeg_projection used extract_view_a_and_max_project, which only
splits views for 4D input. Volumes are stored 3D (Z, Y, X) with the two
diSPIM views concatenated along X (width = 2*height), so it max-projected
BOTH views -> the A|B side-by-side image, as a flat XY max.

Now: pick View A (index 0 of 4D, or the left half of a 3D dual-view), then
build the three-orthogonal-view layout (projection_three_view: [XY|YZ] over
[XZ]) — matching what the perceiver sees and what we intend to store. Also
fixes near-black filmstrip thumbnails (a single cropped view fills the frame
instead of a tiny embryo in a wide A|B canvas). 2D/other inputs fall back to
a percentile-stretched max projection.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/core/imaging.py | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index 6e830351..bc74ec26 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -282,9 +282,23 @@ def generate_jpeg_projection(
         return None
 
     try:
-        max_proj = extract_view_a_and_max_project(volume)
-        normalized = normalize_to_uint8(max_proj, method="percentile",
-                                        p_low=1, p_high=99.5)
+        # Reduce to a single 3D view, then build the three-orthogonal-view
+        # layout (the projection we actually want — matches what the
+        # perceiver sees). View A comes from index 0 of a 4D (Views,Z,Y,X)
+        # volume; a 3D dual-view volume stores the two views concatenated
+        # along X (width >= 2*height), so take the left half (View A) —
+        # otherwise the projection is an A|B side-by-side, not a clean view.
+        vol = np.squeeze(volume)
+        if vol.ndim == 4:
+            vol = vol[0]
+        if vol.ndim == 3:
+            z, h, w = vol.shape
+            if w >= 2 * h:
+                vol = vol[:, :, : w // 2]
+            normalized, _ = projection_three_view(vol)
+        else:
+            normalized = normalize_to_uint8(vol, method="percentile",
+                                            p_low=1, p_high=99.5)
 
         pil_image = Image.fromarray(normalized)
 

From e6646fd3c9c8faa23c36a9da8a8e1745f50905ec Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:29:51 -0400
Subject: [PATCH 044/314] =?UTF-8?q?feat(scripts):=20regenerate=5Fprojectio?=
 =?UTF-8?q?ns=20=E2=80=94=20refresh=20a=20session's=20projections=20from?=
 =?UTF-8?q?=20volumes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

One-off tool to rewrite a session's projections/t*.jpg from its stored volume
TIFFs using the current generate_jpeg_projection (e.g. after the three-view
fix, to refresh older sessions whose on-disk projections are the stale A|B
dual-view).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 scripts/regenerate_projections.py | 75 +++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 scripts/regenerate_projections.py

diff --git a/scripts/regenerate_projections.py b/scripts/regenerate_projections.py
new file mode 100644
index 00000000..54e07281
--- /dev/null
+++ b/scripts/regenerate_projections.py
@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""Regenerate JPEG projections for a session from its stored volumes.
+
+Use after the projection format changes (e.g. the three-view fix) to refresh
+older sessions whose on-disk projections are stale (e.g. the old A|B
+side-by-side max projection). Reads each volume TIFF and rewrites its
+projections/t{NNNN}.jpg via the current generate_jpeg_projection.
+
+Usage:
+    python scripts/regenerate_projections.py <session_id>
+    python scripts/regenerate_projections.py <session_id> --embryo embryo_001
+"""
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+from gently.settings import settings
+from gently.core.imaging import load_volume, generate_jpeg_projection
+
+
+def _session_dir(storage_base: Path, session_id: str) -> Path | None:
+    sessions = storage_base / "sessions"
+    if not sessions.exists():
+        return None
+    # Folder names are {date}_{time}_{slug}_{id8}; match the id suffix.
+    matches = [p for p in sessions.glob(f"*{session_id}*") if p.is_dir()]
+    return matches[0] if matches else None
+
+
+def regenerate(session_id: str, only_embryo: str | None = None) -> int:
+    base = Path(settings.storage.base_path)
+    sdir = _session_dir(base, session_id)
+    if sdir is None:
+        print(f"Session {session_id} not found under {base / 'sessions'}")
+        return 0
+    embryos_dir = sdir / "embryos"
+    if not embryos_dir.exists():
+        print(f"No embryos dir in {sdir}")
+        return 0
+
+    total = 0
+    for emb_dir in sorted(d for d in embryos_dir.iterdir() if d.is_dir()):
+        if only_embryo and emb_dir.name != only_embryo:
+            continue
+        vol_dir = emb_dir / "volumes"
+        proj_dir = emb_dir / "projections"
+        if not vol_dir.exists():
+            continue
+        tifs = sorted(vol_dir.glob("t*.tif"))
+        n = 0
+        for vf in tifs:
+            m = re.match(r"(t\d+)", vf.stem)
+            if not m:
+                continue
+            proj_path = proj_dir / f"{m.group(1)}.jpg"
+            try:
+                vol = load_volume(vf)
+                if generate_jpeg_projection(vol, proj_path) is not None:
+                    n += 1
+            except Exception as e:
+                print(f"  ! {vf.name}: {e}")
+        print(f"  {emb_dir.name}: regenerated {n}/{len(tifs)} projections")
+        total += n
+    print(f"Done: {total} projections regenerated for {session_id}")
+    return total
+
+
+if __name__ == "__main__":
+    ap = argparse.ArgumentParser(description="Regenerate session projections from volumes")
+    ap.add_argument("session_id")
+    ap.add_argument("--embryo", default=None, help="Only this embryo id")
+    args = ap.parse_args()
+    regenerate(args.session_id, args.embryo)

From eead6384baac76fdc70697d6b6d55541c39619a5 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:30:07 -0400
Subject: [PATCH 045/314] fix(scripts): add project root to sys.path in
 regenerate_projections

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 scripts/regenerate_projections.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/scripts/regenerate_projections.py b/scripts/regenerate_projections.py
index 54e07281..68110dbd 100644
--- a/scripts/regenerate_projections.py
+++ b/scripts/regenerate_projections.py
@@ -16,6 +16,11 @@
 import sys
 from pathlib import Path
 
+# Ensure the project root is importable when run as scripts/regenerate_projections.py
+_ROOT = Path(__file__).resolve().parent.parent
+if str(_ROOT) not in sys.path:
+    sys.path.insert(0, str(_ROOT))
+
 from gently.settings import settings
 from gently.core.imaging import load_volume, generate_jpeg_projection
 

From b2bf1f936b4e8947e1d8370f7440c2846d40ef3f Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:35:51 -0400
Subject: [PATCH 046/314] fix(web): content-aware cache for FileStore
 projections
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

On-disk projections can be regenerated (e.g. after the three-view fix), but
/api/images/{uid}/png served them with Cache-Control: immutable + a uid ETag,
so the browser kept the stale image forever. For the FileStore path, use an
mtime+size ETag and a short max-age so a regenerated projection is picked up
without a hard refresh. (In-memory base64 images keep immutable — they don't
change.)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/images.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/routes/images.py b/gently/ui/web/routes/images.py
index 2ecc805a..5d505b6a 100644
--- a/gently/ui/web/routes/images.py
+++ b/gently/ui/web/routes/images.py
@@ -102,15 +102,24 @@ async def get_image_png(uid: str):
             except Exception as e:
                 logger.warning(f"Failed to load image {uid} from DataStore: {e}")
 
-        # Fallback to FileStore JPEG projections (persistent on-disk)
+        # Fallback to FileStore JPEG projections (persistent on-disk).
+        # Unlike the in-memory base64 images, an on-disk projection CAN change
+        # (e.g. regenerated after a projection-format fix), so we must NOT mark
+        # it immutable with a content-independent (uid) ETag — that pins the
+        # browser to the stale image. Use a content-aware ETag (mtime+size)
+        # and a short max-age so a regeneration is picked up.
         if server.gently_store and parsed:
             embryo_id, timepoint = parsed
             proj_path = server._resolve_projection_path(embryo_id, timepoint)
             if proj_path:
+                st = proj_path.stat()
                 return FileResponse(
                     str(proj_path),
                     media_type="image/jpeg",
-                    headers=cache_headers,
+                    headers={
+                        "Cache-Control": "public, max-age=3600",
+                        "ETag": f'"{uid}-{int(st.st_mtime)}-{st.st_size}"',
+                    },
                 )
 
         raise HTTPException(status_code=404, detail=f"Image {uid} not found")

From 92406310cf68a35f6ff4d708d7cc9ce1588f821e Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:48:13 -0400
Subject: [PATCH 047/314] =?UTF-8?q?fix(imaging):=20don't=20split=203D=20vo?=
 =?UTF-8?q?lume=20by=20width=20=E2=80=94=20it=20halved=20centered=20embryo?=
 =?UTF-8?q?s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The previous fix split a 3D volume to the "left half" when width >= 2*height,
assuming dual-view A|B concatenation. But the embryo is typically centered and
straddles the X midline in a 2:1 (e.g. 512x1024) field, so the crop sliced it
in half — the "XY rendered halfway" bug. Project the full 3D volume into the
three orthogonal views instead; only an explicit 4D (Views,Z,Y,X) volume uses
View A. Verified: the XY view now shows the complete embryo.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/core/imaging.py | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index bc74ec26..9f5d2a96 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -282,19 +282,16 @@ def generate_jpeg_projection(
         return None
 
     try:
-        # Reduce to a single 3D view, then build the three-orthogonal-view
-        # layout (the projection we actually want — matches what the
-        # perceiver sees). View A comes from index 0 of a 4D (Views,Z,Y,X)
-        # volume; a 3D dual-view volume stores the two views concatenated
-        # along X (width >= 2*height), so take the left half (View A) —
-        # otherwise the projection is an A|B side-by-side, not a clean view.
+        # Build the three-orthogonal-view layout (the projection we actually
+        # want — matches what the perceiver sees). For an explicit 4D
+        # (Views, Z, Y, X) volume, use View A. For a 3D volume, project the
+        # whole thing — do NOT try to split views by aspect ratio: the embryo
+        # is often centered and straddles the X midline, so a width-based
+        # "dual-view" guess slices it in half (the XY-rendered-halfway bug).
         vol = np.squeeze(volume)
         if vol.ndim == 4:
             vol = vol[0]
         if vol.ndim == 3:
-            z, h, w = vol.shape
-            if w >= 2 * h:
-                vol = vol[:, :, : w // 2]
             normalized, _ = projection_three_view(vol)
         else:
             normalized = normalize_to_uint8(vol, method="percentile",

From 95224f714dce2aba96776ed83b63ed42b6aa0298 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 07:52:24 -0400
Subject: [PATCH 048/314] docs: record dual-view readiness as a design
 constraint

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 notes/biologist-readiness-plan.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/notes/biologist-readiness-plan.md b/notes/biologist-readiness-plan.md
index 701a4fc5..03c25844 100644
--- a/notes/biologist-readiness-plan.md
+++ b/notes/biologist-readiness-plan.md
@@ -332,6 +332,8 @@ Incremental — the backend protocol for agent control already exists (`/ws/agen
 
 **Generalization:** per-sample **channels/wavelengths/per-line-power model** (+ objective/binning) into `EmbryoState`/volume metadata — the "looks like microscope software" deliverable *and* the stain generalizer; **parameterize `gently_perception`** for non-celegans (cross-repo); wire startup wizard → `load_organism()`; route `validation.py` through `get_organism()`; reconcile the two `DevelopmentalStage` enums.
 
+**Dual-view readiness (design constraint).** All current data is single-view; dual-view is the intended general capability (single-view = `n_views == 1`). Today view B is dropped only at the explicit 4D `(Views,Z,Y,X)` → `vol[0]` path in `generate_jpeg_projection`. **Rule: view count/layout is declared by acquisition in volume metadata — never inferred from pixel shape** (an aspect-ratio "dual-view" guess sliced centered single-view embryos in half; fixed by removing it). To go dual-view later (additive): (1) device layer records `n_views`/layout in the volume sidecar; (2) uid scheme extends `volume_{embryo}_t{NNNN}` → optional `…_vA`/`…_vB` (bare form stays back-compat); (3) `generate_jpeg_projection` emits a three-view per present view; (4) filmstrip/detail panel + perception become view-aware (toggle / side-by-side / feed one or both). Nothing in the single-view path blocks this.
+
 **Refactors (after their tests; medium risk):** `bridge.py` dispatch table + case-fold fix (high value for web control); `verifier.py` consensus dedup (capture truth-table fixtures first; preserve `ensemble_size=50` + conservative on-error defaults); `timelapse.py` rule `to_dict()/from_dict()` then `TimelapseStatePersister` + `RuleEngine`; `file_store.py` mixin split; `device_layer.py` `@json_endpoint`; `claude_client.py` `_vision_call`; consolidate pixel→stage math (duplicated 4×) into `gently.core.coordinates`; web `embryos.js` split (`copilot-chat.js`, `markdown.js`, `embryo-views.js`).
 
 ---

From a356dfd43baeea43d553136cd6e16ec491e6d9dc Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 09:08:31 -0400
Subject: [PATCH 049/314] feat(launcher): open the web UI in Chrome
 (GENTLY_BROWSER override, default fallback)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 launch_gently.py | 51 +++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 46 insertions(+), 5 deletions(-)

diff --git a/launch_gently.py b/launch_gently.py
index b6523bb2..a2e590fa 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -122,6 +122,51 @@ def _print_banner(viz_url, device_connected, offline, storage_dir, log_file, res
     print()
 
 
+def _open_browser(url: str) -> None:
+    """Open the web UI, preferring Google Chrome.
+
+    Override with GENTLY_BROWSER (a webbrowser name like 'firefox', or a full
+    path to a browser executable). Falls back to the OS default browser if
+    Chrome can't be found, so this never blocks startup.
+    """
+    import webbrowser
+
+    override = os.environ.get("GENTLY_BROWSER", "").strip()
+
+    # 1) Registered browser names (override first, then Chrome aliases).
+    for name in ([override] if override else []) + ["chrome", "google-chrome", "chromium"]:
+        try:
+            webbrowser.get(name).open(url)
+            return
+        except Exception:
+            pass
+
+    # 2) Explicit executables (an override path, then known Chrome locations).
+    candidates = [override] if override else []
+    candidates += [
+        shutil.which("chrome"),
+        r"C:\Program Files\Google\Chrome\Application\chrome.exe",
+        r"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe",
+    ]
+    for exe in candidates:
+        try:
+            if exe and Path(exe).exists():
+                webbrowser.register(
+                    "gently-browser", None,
+                    webbrowser.BackgroundBrowser(exe), preferred=True,
+                )
+                webbrowser.get("gently-browser").open(url)
+                return
+        except Exception:
+            pass
+
+    # 3) Fall back to the OS default.
+    try:
+        webbrowser.open(url)
+    except Exception:
+        pass
+
+
 def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
     """
     Spawn the Ink TUI in session-picker mode and capture the selection.
@@ -467,11 +512,7 @@ def _status_provider():
         print("  (Save this now. Add users via the admin API; GENTLY_NO_AUTH=1 disables auth.)\n")
 
     if viz_url and not no_browser:
-        try:
-            import webbrowser
-            webbrowser.open(viz_url)
-        except Exception:
-            pass
+        _open_browser(viz_url)
 
     # Keep the event loop alive so the in-process viz server keeps serving.
     # On Windows the Proactor loop won't surface Ctrl-C while blocked on a

From 76505f4444d9c65cfb30e833e911f4b5d74277e9 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 09:34:49 -0400
Subject: [PATCH 050/314] feat(scripts): --all to regenerate projections for
 every session

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 scripts/regenerate_projections.py | 85 +++++++++++++++++++++----------
 1 file changed, 57 insertions(+), 28 deletions(-)

diff --git a/scripts/regenerate_projections.py b/scripts/regenerate_projections.py
index 68110dbd..7b6241ff 100644
--- a/scripts/regenerate_projections.py
+++ b/scripts/regenerate_projections.py
@@ -1,14 +1,15 @@
 #!/usr/bin/env python3
-"""Regenerate JPEG projections for a session from its stored volumes.
+"""Regenerate JPEG projections for a session (or all sessions) from volumes.
 
 Use after the projection format changes (e.g. the three-view fix) to refresh
-older sessions whose on-disk projections are stale (e.g. the old A|B
-side-by-side max projection). Reads each volume TIFF and rewrites its
-projections/t{NNNN}.jpg via the current generate_jpeg_projection.
+sessions whose on-disk projections are stale (e.g. the old flat-XY max
+projection). Reads each volume TIFF and rewrites its projections/t{NNNN}.jpg
+via the current generate_jpeg_projection.
 
 Usage:
     python scripts/regenerate_projections.py <session_id>
     python scripts/regenerate_projections.py <session_id> --embryo embryo_001
+    python scripts/regenerate_projections.py --all
 """
 
 import argparse
@@ -25,26 +26,10 @@
 from gently.core.imaging import load_volume, generate_jpeg_projection
 
 
-def _session_dir(storage_base: Path, session_id: str) -> Path | None:
-    sessions = storage_base / "sessions"
-    if not sessions.exists():
-        return None
-    # Folder names are {date}_{time}_{slug}_{id8}; match the id suffix.
-    matches = [p for p in sessions.glob(f"*{session_id}*") if p.is_dir()]
-    return matches[0] if matches else None
-
-
-def regenerate(session_id: str, only_embryo: str | None = None) -> int:
-    base = Path(settings.storage.base_path)
-    sdir = _session_dir(base, session_id)
-    if sdir is None:
-        print(f"Session {session_id} not found under {base / 'sessions'}")
-        return 0
-    embryos_dir = sdir / "embryos"
+def _regen_folder(folder: Path, only_embryo: str | None = None) -> int:
+    embryos_dir = folder / "embryos"
     if not embryos_dir.exists():
-        print(f"No embryos dir in {sdir}")
         return 0
-
     total = 0
     for emb_dir in sorted(d for d in embryos_dir.iterdir() if d.is_dir()):
         if only_embryo and emb_dir.name != only_embryo:
@@ -54,6 +39,8 @@ def regenerate(session_id: str, only_embryo: str | None = None) -> int:
         if not vol_dir.exists():
             continue
         tifs = sorted(vol_dir.glob("t*.tif"))
+        if not tifs:
+            continue
         n = 0
         for vf in tifs:
             m = re.match(r"(t\d+)", vf.stem)
@@ -61,20 +48,62 @@ def regenerate(session_id: str, only_embryo: str | None = None) -> int:
                 continue
             proj_path = proj_dir / f"{m.group(1)}.jpg"
             try:
-                vol = load_volume(vf)
-                if generate_jpeg_projection(vol, proj_path) is not None:
+                if generate_jpeg_projection(load_volume(vf), proj_path) is not None:
                     n += 1
             except Exception as e:
-                print(f"  ! {vf.name}: {e}")
-        print(f"  {emb_dir.name}: regenerated {n}/{len(tifs)} projections")
+                print(f"    ! {vf.name}: {e}")
+        print(f"    {emb_dir.name}: regenerated {n}/{len(tifs)} projections")
         total += n
+    return total
+
+
+def _session_dir(storage_base: Path, session_id: str) -> Path | None:
+    sessions = storage_base / "sessions"
+    if not sessions.exists():
+        return None
+    matches = [p for p in sessions.glob(f"*{session_id}*") if p.is_dir()]
+    return matches[0] if matches else None
+
+
+def regenerate(session_id: str, only_embryo: str | None = None) -> int:
+    base = Path(settings.storage.base_path)
+    sdir = _session_dir(base, session_id)
+    if sdir is None:
+        print(f"Session {session_id} not found under {base / 'sessions'}")
+        return 0
+    total = _regen_folder(sdir, only_embryo)
     print(f"Done: {total} projections regenerated for {session_id}")
     return total
 
 
+def regenerate_all() -> int:
+    base = Path(settings.storage.base_path)
+    sessions = base / "sessions"
+    if not sessions.exists():
+        print(f"No sessions dir at {sessions}")
+        return 0
+    folders = sorted(
+        p for p in sessions.iterdir()
+        if p.is_dir() and any((p / "embryos").glob("*/volumes/t*.tif"))
+    )
+    print(f"Regenerating projections for {len(folders)} session(s) with volumes...")
+    grand = 0
+    for i, folder in enumerate(folders, 1):
+        print(f"[{i}/{len(folders)}] {folder.name}")
+        grand += _regen_folder(folder)
+    print(f"ALL DONE: {grand} projections regenerated across {len(folders)} sessions")
+    return grand
+
+
 if __name__ == "__main__":
     ap = argparse.ArgumentParser(description="Regenerate session projections from volumes")
-    ap.add_argument("session_id")
+    ap.add_argument("session_id", nargs="?", help="Session id (omit with --all)")
+    ap.add_argument("--all", action="store_true", help="Regenerate every session that has volumes")
     ap.add_argument("--embryo", default=None, help="Only this embryo id")
     args = ap.parse_args()
-    regenerate(args.session_id, args.embryo)
+    if args.all:
+        regenerate_all()
+    elif args.session_id:
+        regenerate(args.session_id, args.embryo)
+    else:
+        ap.error("provide a session_id or --all")

From f87b3c9844d36efc1ee2b8dffda6250b865f2103 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 09:38:11 -0400
Subject: [PATCH 051/314] fix(web): filmstrip thumbnail crops to the XY embryo,
 not the black centre

The stored projection is now a three-view ([XY|YZ] over [XZ]); object-fit:cover
center-cropped the square thumb to the black XY|YZ divider, so thumbs looked
empty. object-position: left center crops to the embryo-bearing XY/XZ column.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index aeb46a01..5fcab675 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -3859,6 +3859,10 @@ kbd {
     border-radius: 4px;
     border: 2px solid;
     object-fit: cover;
+    /* The stored projection is a three-view ([XY|YZ] over [XZ]); the embryo is
+       in the LEFT column (XY/XZ), and the centre is the black XY|YZ divider.
+       Crop to the left so the square thumbnail shows the embryo, not the gap. */
+    object-position: left center;
     background: var(--bg-dark);
 }
 

From 9d0790d8dc93b54d4f2f6f5d66e045110c17cc94 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 12:36:22 -0400
Subject: [PATCH 052/314] Add room-light toggle and device-layer terminal UI

- Devices tab: SwitchBot room-light on/off button (web button + JS,
  gated route, device-layer handlers, and client methods).
- Device layer: dependency-free curated console UI (console_ui.py) with
  starting/READY status panels and a plain-language hardware-failure
  diagnostic panel instead of a raw Python traceback when a device (e.g.
  a COM port) is powered off. ASCII-safe + color/Unicode capability
  detection for Windows consoles.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/console_ui.py          | 187 +++++++++++++++++++++++++
 gently/hardware/dispim/client.py       |  14 ++
 gently/hardware/dispim/device_layer.py | 151 ++++++++++++++++++++
 gently/ui/web/routes/data.py           |  41 ++++++
 gently/ui/web/static/css/main.css      |  42 ++++++
 gently/ui/web/static/js/devices.js     | 102 ++++++++++++++
 gently/ui/web/templates/index.html     |  12 ++
 start_device_layer.py                  |  79 +++++++++--
 8 files changed, 617 insertions(+), 11 deletions(-)
 create mode 100644 gently/hardware/console_ui.py

diff --git a/gently/hardware/console_ui.py b/gently/hardware/console_ui.py
new file mode 100644
index 00000000..abc8ca64
--- /dev/null
+++ b/gently/hardware/console_ui.py
@@ -0,0 +1,187 @@
+"""Lightweight terminal styling for the device-layer console.
+
+Plain ``print`` to stdout, no third-party dependency. ``rich`` is deliberately
+avoided here — it has caused Unicode/encoding issues on Windows consoles (see
+the stdout-suppression note in ``dispim/device_layer.py``).
+
+The point of this module is to give the operator a readable, always-visible
+picture of the device layer at the terminal — distinct from the file log. The
+file log keeps the full INFO/DEBUG firehose; the console shows a curated set of
+milestones and a status panel.
+
+Robust by construction, because the device layer runs on Windows consoles:
+
+* **Colour** (ANSI) is auto-disabled unless stdout is a TTY. On Windows we try
+  to enable virtual-terminal processing first; if that fails, colour is off so
+  raw escape codes never leak. ``NO_COLOR`` (https://no-color.org) and a
+  ``dumb`` ``TERM`` also disable it.
+* **Box-drawing** glyphs are used only when stdout's encoding is UTF-based;
+  otherwise ASCII equivalents are used so a cp1252 console shows clean output.
+* ``out()`` is defensive: any residual ``UnicodeEncodeError`` is caught and the
+  line re-emitted with ``errors="replace"`` rather than crashing startup.
+"""
+from __future__ import annotations
+
+import os
+import sys
+
+# Visible width of the status panel (border rules). Content lines are written
+# without a right border so coloured text never needs width arithmetic.
+WIDTH = 64
+
+
+def _enable_windows_vt() -> bool:
+    """Best-effort: turn on ANSI escape handling for the Windows console.
+
+    Returns True if VT processing is (now) enabled or we're not on Windows.
+    """
+    if sys.platform != "win32":
+        return True
+    try:
+        import ctypes
+        from ctypes import wintypes
+
+        kernel32 = ctypes.windll.kernel32
+        ENABLE_VT = 0x0004
+        handle = kernel32.GetStdHandle(-11)  # STD_OUTPUT_HANDLE
+        mode = wintypes.DWORD()
+        if not kernel32.GetConsoleMode(handle, ctypes.byref(mode)):
+            return False
+        return bool(kernel32.SetConsoleMode(handle, mode.value | ENABLE_VT))
+    except Exception:
+        return False
+
+
+def _detect_color() -> bool:
+    if sys.stdout is None or not hasattr(sys.stdout, "isatty") or not sys.stdout.isatty():
+        return False
+    if os.environ.get("NO_COLOR") is not None or os.environ.get("TERM") == "dumb":
+        return False
+    return _enable_windows_vt()
+
+
+def _detect_unicode() -> bool:
+    enc = (getattr(sys.stdout, "encoding", None) or "").lower()
+    return "utf" in enc
+
+
+_USE_COLOR = _detect_color()
+_USE_UNICODE = _detect_unicode()
+
+# Glyphs: pretty (UTF) vs ASCII fallback.
+if _USE_UNICODE:
+    _HEAVY, _LIGHT, _DOT, _CHECK, _MID, _BULLET = "═", "─", "●", "✓", "·", "•"
+else:
+    _HEAVY, _LIGHT, _DOT, _CHECK, _MID, _BULLET = "=", "-", "*", "+", "-", "-"
+
+# Public separator for callers that build their own value strings.
+MIDDOT = f" {_MID} "
+
+_CODES = {
+    "reset": "\033[0m",
+    "bold": "\033[1m",
+    "dim": "\033[2m",
+    "green": "\033[32m",
+    "cyan": "\033[36m",
+    "yellow": "\033[33m",
+    "red": "\033[31m",
+    "blue": "\033[34m",
+    "magenta": "\033[35m",
+    "grey": "\033[90m",
+}
+
+
+def supports_color() -> bool:
+    return _USE_COLOR
+
+
+def c(text, *styles: str) -> str:
+    """Wrap *text* in ANSI styles, or return it unchanged when colour is off."""
+    if not _USE_COLOR or not styles:
+        return str(text)
+    prefix = "".join(_CODES.get(s, "") for s in styles)
+    return f"{prefix}{text}{_CODES['reset']}"
+
+
+def out(text: str = "") -> None:
+    """Print one line to stdout, flushing so it shows immediately.
+
+    Never raises on encoding: a console that can't represent a character gets
+    a replacement rather than a crashed startup.
+    """
+    try:
+        print(text, flush=True)
+    except UnicodeEncodeError:
+        enc = (getattr(sys.stdout, "encoding", None) or "ascii")
+        sys.stdout.write(text.encode(enc, "replace").decode(enc, "replace") + "\n")
+        sys.stdout.flush()
+
+
+def rule(heavy: bool = True, style: str = "grey") -> None:
+    out(c((_HEAVY if heavy else _LIGHT) * WIDTH, style))
+
+
+def header(title: str, badge: str | None = None, badge_style: str = "yellow") -> None:
+    """Top of a panel: a heavy rule, a title row (optional right-aligned badge),
+    and a closing heavy rule."""
+    rule(heavy=True)
+    line = "  " + c(title, "bold", "cyan")
+    if badge:
+        # Right-align using uncoloured widths so padding ignores ANSI codes.
+        pad = max(1, WIDTH - len("  " + title) - len(badge) - 1)
+        line += " " * pad + c(badge, "bold", badge_style)
+    out(line)
+    rule(heavy=True)
+
+
+def row(label: str, value: str, label_w: int = 12, label_style: str = "grey") -> None:
+    """A ``  label   value`` line inside a panel."""
+    out(f"  {c(label.ljust(label_w), label_style)}{value}")
+
+
+def sub(label: str, value: str, label_w: int = 10) -> None:
+    """An indented sub-row, e.g. a device-group breakdown."""
+    out(f"    {c(label.ljust(label_w), 'grey')}{value}")
+
+
+def step(n: int, total: int, label: str) -> None:
+    """A startup progress line: ``  [2/5] Starting Micro-Manager core``"""
+    out(f"  {c(f'[{n}/{total}]', 'cyan')} {label}")
+
+
+def step_done(detail: str = "ok") -> None:
+    """A check-mark continuation under the most recent step."""
+    out(f"        {c(_CHECK, 'green')} {c(detail, 'grey')}")
+
+
+def note(text: str, style: str = "grey") -> None:
+    out(f"  {c(text, style)}")
+
+
+def bullet(text: str) -> None:
+    out(f"    {c(_BULLET, 'cyan')} {text}")
+
+
+def error_panel(title: str, summary: str, details: str | None = None,
+                hints=None, log_file=None) -> None:
+    """A red FAILED panel: one-line summary, optional detail, fix hints, log path.
+
+    Used at the top-level startup catch so an operator sees a plain-language
+    diagnosis instead of a Python traceback (which still goes to the log file).
+    """
+    out()
+    header(title, badge="FAILED", badge_style="red")
+    note(summary, "yellow")
+    if details:
+        out()
+        row("Details", details, label_w=10)
+    if hints:
+        out()
+        note("Try this:", "bold")
+        for h in hints:
+            bullet(h)
+    if log_file:
+        out()
+        row("Full log", str(log_file), label_w=10)
+    rule(heavy=True)
+    out()
diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 03ff8009..2490dc24 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -802,6 +802,20 @@ async def get_led_status(self) -> Dict:
         """Get current LED status."""
         return await self._api_get('/api/led/status')
 
+    async def set_room_light(self, state: str = 'off') -> Dict:
+        """Switch the diSPIM room light on/off via the SwitchBot Bot.
+
+        Hits ``POST /api/room_light/set`` directly (no Bluesky queue, no
+        experiment trace) — a setup accessory poke. ``state`` is
+        'on' | 'off' | 'press'. Blocks at the device layer until the BLE
+        command lands (~1-2 s).
+        """
+        return await self._api_post('/api/room_light/set', {'state': state})
+
+    async def get_room_light_status(self) -> Dict:
+        """Read the room light's cached on/off state (no BLE round-trip)."""
+        return await self._api_get('/api/room_light/status')
+
     async def set_temperature(self, target_c: float) -> Dict:
         """Command the thermal-controller setpoint (Celsius). Non-blocking — the
         controller ramps; poll get_temperature() for the lock state."""
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index a1af5e4a..3b50aded 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -44,6 +44,7 @@
 from gently.exceptions import HardwareError, AcquisitionError
 from gently.log_config import configure_logging
 from gently.settings import settings
+from gently.hardware import console_ui as cui
 
 # Bluesky imports
 from bluesky import RunEngine
@@ -184,15 +185,21 @@ async def initialize(self):
         logger.info("GENTLY DEVICE LAYER")
         logger.info("=" * 60)
 
+        cui.out()
+        cui.note("Starting device layer...", "bold")
+
         # [1/5] Load config
+        cui.step(1, 5, "Loading configuration")
         logger.info("[1/5] Loading configuration...")
         with open(self.config_path, 'r') as f:
             self.config = yaml.safe_load(f)
         logger.info("Config loaded from %s", self.config_path)
+        cui.step_done(str(self.config_path))
 
         # [2/5] MMCore initialization, routed through the DiSPIMSystem facade
         # so this process never touches `core.*` directly outside the
         # devices/ package.
+        cui.step(2, 5, "Initializing Micro-Manager core")
         logger.info("[2/5] Initializing Micro-Manager Core (direct)...")
         from .devices.system import DiSPIMSystem
 
@@ -215,6 +222,7 @@ async def initialize(self):
         self.system.load_system_configuration(mm_config_path)
         logger.info("MMCore initialized (direct, in-process)")
         logger.info("Loaded devices: %s", self.system.get_loaded_devices())
+        cui.step_done(Path(mm_config_path).name)
 
         # Register MMCore event callback so we get push notifications for
         # property changes, stage moves, exposure changes, etc. — anything the
@@ -223,6 +231,7 @@ async def initialize(self):
         self._register_mmcore_callbacks()
 
         # [3/5] Create Ophyd devices
+        cui.step(3, 5, "Creating devices")
         logger.info("[3/5] Creating Ophyd devices...")
         from .device_factory import create_devices_from_mmcore
         # Suppress rich console output to avoid Unicode issues on Windows
@@ -270,6 +279,8 @@ async def initialize(self):
             except Exception as exc:
                 logger.warning("Could not create temperature controller: %s", exc)
 
+        cui.step_done(f"{len(self.devices)} devices")
+
         # Push XY safety bounds down to the ASI Tiger firmware so the joystick
         # can't drive past Layer-1 software limits. The XY_STAGE_*_UM constants
         # in devices/stage.py are the single source of truth — both the
@@ -320,6 +331,7 @@ async def initialize(self):
                 logger.error("Could not enable XY joystick: %s", exc)
 
         # [4/5] Initialize RunEngine
+        cui.step(4, 5, "Initializing RunEngine")
         logger.info("[4/5] Initializing RunEngine...")
         self.RE = RunEngine({})
 
@@ -381,10 +393,13 @@ def collect_docs(name, doc):
 
         self.RE.subscribe(collect_docs)
         logger.info("RunEngine ready")
+        cui.step_done("ready")
 
         # [5/5] Load plans
+        cui.step(5, 5, "Loading plans")
         logger.info("[5/5] Loading plans...")
         self._load_plans()
+        cui.step_done(f"{len(self.plans)} plans")
 
         logger.info("=" * 60)
         logger.info("Device layer initialized successfully")
@@ -1327,6 +1342,77 @@ async def handle_set_led(self, request):
                 'traceback': traceback.format_exc()
             }, status=500)
 
+    def _room_light_device(self):
+        """Resolve the room-light SwitchBot from the device registry.
+
+        Prefers the conventional 'room_light' key (config.yml name), but
+        falls back to scanning for any SwitchBot instance so a differently
+        named bot still works. Returns None when no bot is configured.
+        """
+        bot = self.devices.get('room_light')
+        if bot is not None:
+            return bot
+        try:
+            from gently.hardware.switchbot import SwitchBot
+        except Exception:
+            return None
+        for dev in self.devices.values():
+            if isinstance(dev, SwitchBot):
+                return dev
+        return None
+
+    async def handle_get_room_light_status(self, request):
+        """GET /api/room_light/status - cached on/off state of the room light.
+
+        Reads the SwitchBot's last-commanded state (no BLE round-trip, so it's
+        cheap to poll). 'unknown' until the first on/off command lands.
+        """
+        try:
+            bot = self._room_light_device()
+            if bot is None:
+                return web.json_response({'success': False, 'available': False,
+                                          'error': 'room_light device not configured'})
+            state = bot.read().get(bot.name, {}).get('value', 'unknown')
+            return web.json_response({'success': True, 'available': True, 'state': state})
+        except Exception as e:
+            import traceback
+            return web.json_response({'success': False, 'available': False, 'error': str(e),
+                                      'traceback': traceback.format_exc()}, status=500)
+
+    async def handle_set_room_light(self, request):
+        """POST /api/room_light/set - drive the room-light SwitchBot.
+
+        Body: {"state": "on" | "off" | "press"}. Blocks until the BLE command
+        lands (the bot's servo move is ~0.5-1 s plus connect latency).
+        """
+        try:
+            data = await request.json()
+            state = str(data.get('state', '')).lower()
+            if state not in ('on', 'off', 'press'):
+                return web.json_response({'success': False,
+                                          'error': f"state {state!r} must be on, off, or press"}, status=400)
+            bot = self._room_light_device()
+            if bot is None:
+                return web.json_response({'success': False,
+                                          'error': 'room_light device not configured'}, status=503)
+
+            status = bot.set(state)
+            import time
+            timeout = float(getattr(bot, 'timeout', 20.0)) + 5
+            start = time.time()
+            while not status.done and (time.time() - start) < timeout:
+                await asyncio.sleep(0.1)
+
+            if status.done and status.success:
+                new_state = bot.read().get(bot.name, {}).get('value', state)
+                return web.json_response({'success': True, 'state': new_state})
+            return web.json_response({'success': False,
+                                      'error': f'failed to set room light to {state}'}, status=502)
+        except Exception as e:
+            import traceback
+            return web.json_response({'success': False, 'error': str(e),
+                                      'traceback': traceback.format_exc()}, status=500)
+
     async def handle_get_temperature_status(self, request):
         """GET /api/temperature/status - current temperature, setpoint, lock state."""
         try:
@@ -2339,6 +2425,8 @@ async def on_start(self):
         self._app.router.add_post('/api/led/set', self.handle_set_led)
         self._app.router.add_get('/api/temperature/status', self.handle_get_temperature_status)
         self._app.router.add_post('/api/temperature/set', self.handle_set_temperature)
+        self._app.router.add_get('/api/room_light/status', self.handle_get_room_light_status)
+        self._app.router.add_post('/api/room_light/set', self.handle_set_room_light)
         self._app.router.add_post('/api/camera/led_mode', self.handle_set_camera_led_mode)
         self._app.router.add_post('/api/camera/exposure', self.handle_set_camera_exposure)
         self._app.router.add_get('/api/camera/exposure', self.handle_get_camera_exposure)
@@ -2390,10 +2478,72 @@ async def on_start(self):
         logger.info("Endpoints: GET /api/status, GET /api/devices, GET /api/plans, POST /api/queue/item/add, ...")
 
         await site.start()
+        self._print_ready_panel()
+
+    def _categorize_devices(self):
+        """Group device names into human-readable buckets for the console panel.
+
+        First-match-wins so 'room_light' lands in Accessory (not Light) and
+        'volume_scanner' in Motion. Accessory entries carry live state.
+        """
+        buckets = {"Motion": [], "Imaging": [], "Light": [], "Accessory": [], "Other": []}
+        for name in sorted(self.devices):
+            low = name.lower()
+            if low in ("room_light", "temperature"):
+                label = name
+                try:
+                    dev = self.devices[name]
+                    val = dev.read().get(dev.name, {}).get("value")
+                    if val is not None:
+                        label = f"{name} ({val})"
+                except Exception:
+                    pass
+                buckets["Accessory"].append(label)
+            elif "cam" in low or "snap" in low:
+                buckets["Imaging"].append(name)
+            elif any(k in low for k in ("stage", "piezo", "galvo", "scanner")):
+                buckets["Motion"].append(name)
+            elif any(k in low for k in ("laser", "led", "light", "illum")):
+                buckets["Light"].append(name)
+            else:
+                buckets["Other"].append(name)
+        return list(buckets.items())
+
+    def _print_ready_panel(self):
+        """Curated, always-visible status summary at the terminal.
+
+        Separate from the file log: the operator (often a biologist) gets the
+        URL the agent connects to, a grouped device inventory and accessory
+        states at a glance — instead of a silent console after the banner.
+        """
+        def _fmt(names, limit=6):
+            if len(names) <= limit:
+                return " · ".join(names)
+            return " · ".join(names[:limit]) + cui.c(f"  +{len(names) - limit} more", "grey")
+
+        host = self.host or "0.0.0.0"
+        url_host = "localhost" if host in ("0.0.0.0", "::", "") else host
+
+        cui.out()
+        cui.header(f"GENTLY{cui.MIDDOT}DEVICE LAYER", badge="READY", badge_style="green")
+        cui.row("URL", cui.c(f"http://{url_host}:{self.port}", "bold"))
+        cui.row("Hardware", str((self.config or {}).get("hardware", "dispim")))
+        cui.row("Devices", f"{len(self.devices)} loaded")
+        for label, names in self._categorize_devices():
+            if names:
+                cui.sub(label, _fmt(names))
+        cui.row("Detection", f"SAM on {self._sam_device} (loads on first use)")
+        cui.row("Plans", f"{len(self.plans)} available")
+        cui.rule(heavy=False)
+        cui.note("Waiting for the agent to connect.  Press Ctrl+C to stop.")
+        cui.rule(heavy=True)
+        cui.out()
 
     async def on_stop(self):
         """Shut down the HTTP server and plan executor."""
         logger.info("Shutting down...")
+        cui.out()
+        cui.note("Shutting down device layer...", "yellow")
         self._running = False
 
         # Cancel any pending coalesced-broadcast timer.
@@ -2446,6 +2596,7 @@ async def on_stop(self):
         if self._runner:
             await self._runner.cleanup()
         logger.info("Device layer stopped.")
+        cui.note("Device layer stopped.", "grey")
 
     async def health_check(self) -> Dict:
         """Return health status with device count, queue size, SAM status."""
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 7bb5ad3b..3133ec60 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -263,6 +263,47 @@ async def stop_bottom_camera_stream():
             raise HTTPException(status_code=500, detail=f"stop failed: {exc}")
         return {"streaming": False}
 
+    def _resolve_client():
+        """Resolve the live microscope client from the agent bridge, or None."""
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        return getattr(agent, "client", None) if agent else None
+
+    @router.get("/api/devices/room_light/status")
+    async def get_room_light_status():
+        """Cached on/off state of the room-light SwitchBot (cheap to poll)."""
+        client = _resolve_client()
+        if client is None:
+            return {"available": False, "state": "unknown"}
+        try:
+            res = await client.get_room_light_status()
+        except Exception as exc:
+            logger.debug("room light status fetch failed: %s", exc)
+            return {"available": False, "state": "unknown"}
+        return {
+            "available": bool(res.get("available", res.get("success", False))),
+            "state": res.get("state", "unknown"),
+        }
+
+    @router.post("/api/devices/room_light/set",
+                 dependencies=[Depends(require_control)])
+    async def set_room_light(payload: dict = Body(...)):
+        """Switch the room light on/off. Body: {"state": "on"|"off"|"press"}."""
+        state = str(payload.get("state", "")).lower()
+        if state not in ("on", "off", "press"):
+            raise HTTPException(status_code=400, detail="state must be on, off, or press")
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            res = await client.set_room_light(state)
+        except Exception as exc:
+            logger.exception("Room light command failed")
+            raise HTTPException(status_code=502, detail=f"room light command failed: {exc}")
+        if not res.get("success"):
+            raise HTTPException(status_code=502, detail=res.get("error", "room light command failed"))
+        return {"state": res.get("state", state)}
+
     @router.get("/api/calibration")
     async def list_calibration(embryo_id: Optional[str] = None):
         """Get calibration images"""
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 5fcab675..bd6ca7b9 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9494,6 +9494,48 @@ body.modal-open {
 .devices-status-led.stale::before { background: var(--map-warm); }
 .devices-status-led.error::before { background: #f87171; }
 
+/* --- Room-light toggle (header) -------------------------------------- */
+.devices-room-light {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.4rem;
+    padding: 0.18rem 0.6rem 0.18rem 0.45rem;
+    border: 1px solid var(--map-overlay-edge);
+    background: var(--map-overlay-bg);
+    border-radius: 999px;
+    color: var(--map-ink-mute);
+    font-family: inherit;
+    font-size: 0.65rem;
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    cursor: pointer;
+    transition: color 0.15s, border-color 0.15s, background 0.15s;
+}
+.devices-room-light[hidden] { display: none; }
+.devices-room-light:hover:not(:disabled) {
+    border-color: var(--map-accent);
+    color: var(--map-ink);
+}
+.devices-room-light:disabled { opacity: 0.5; cursor: default; }
+.devices-room-light-bulb {
+    display: inline-flex;
+    align-items: center;
+    color: var(--map-ink-mute);
+    transition: color 0.15s, filter 0.15s;
+}
+/* "on" — warm glow on the bulb to read like a lit lamp */
+.devices-room-light.is-on {
+    border-color: rgba(255, 210, 74, 0.7);
+    color: #ffd24a;
+    background: rgba(255, 210, 74, 0.12);
+}
+.devices-room-light.is-on .devices-room-light-bulb {
+    color: #ffd24a;
+    filter: drop-shadow(0 0 5px rgba(255, 210, 74, 0.7));
+}
+.devices-room-light.is-busy { opacity: 0.65; cursor: progress; }
+
 /* --- Containers ------------------------------------------------------- */
 .devices-view { display: flex; flex-direction: column; flex: 1; min-height: 0; }
 .devices-view-details { gap: 1rem; }
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index b4cb30d2..27bc12c3 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -72,6 +72,15 @@ const DevicesManager = (function () {
     const _CAM_ZOOM_MAX = 8;
     const _CAM_ZOOM_STEP = 1.15;  // multiplicative per wheel notch
 
+    // Room-light toggle (header). Drives the SwitchBot Bot that switches the
+    // diSPIM room light. State is the bot's cached on/off; hidden until the
+    // device layer reports the accessory is configured.
+    let _roomLightToggle, _roomLightLabel;
+    let _roomLightState = 'unknown';
+    let _roomLightAvailable = false;
+    let _roomLightBusy = false;
+    let _roomLightTimer = null;
+
     let _lastTs = 0;
     let _previousTs = 0;
     let _lastWallTs = 0;
@@ -135,6 +144,9 @@ const DevicesManager = (function () {
         _camLed          = document.getElementById('devices-camera-led');
         _camMeta         = document.getElementById('devices-camera-meta');
 
+        _roomLightToggle = document.getElementById('devices-room-light-toggle');
+        _roomLightLabel  = document.getElementById('devices-room-light-label');
+
         // Recompute the scale bar caption whenever the canvas resizes.
         if (_mapSvg && window.ResizeObserver) {
             new ResizeObserver(() => updateScalebar()).observe(_mapSvg);
@@ -1268,6 +1280,95 @@ const DevicesManager = (function () {
         }
     }
 
+    // =====================================================================
+    // Room-light toggle
+    // =====================================================================
+
+    function applyRoomLight(state, available) {
+        _roomLightState = state || 'unknown';
+        _roomLightAvailable = !!available;
+        if (!_roomLightToggle) return;
+        _roomLightToggle.hidden = !_roomLightAvailable;
+        _roomLightToggle.disabled = !_roomLightAvailable || _roomLightBusy;
+        const on = _roomLightState === 'on';
+        _roomLightToggle.classList.toggle('is-on', on);
+        _roomLightToggle.setAttribute('aria-pressed', on ? 'true' : 'false');
+        if (_roomLightLabel && !_roomLightBusy) {
+            _roomLightLabel.textContent = on ? 'Room light: on'
+                : (_roomLightState === 'off' ? 'Room light: off' : 'Room light');
+        }
+    }
+
+    async function loadRoomLightStatus() {
+        if (!_roomLightToggle || _roomLightBusy) return;
+        try {
+            const res = await fetch('/api/devices/room_light/status');
+            if (!res.ok) { applyRoomLight('unknown', false); return; }
+            const data = await res.json();
+            applyRoomLight(data.state, data.available);
+        } catch (err) {
+            console.debug('room light status fetch failed:', err);
+            applyRoomLight('unknown', false);
+        }
+    }
+
+    async function toggleRoomLight() {
+        if (!_roomLightToggle || _roomLightBusy || !_roomLightAvailable) return;
+        const next = _roomLightState === 'on' ? 'off' : 'on';
+        _roomLightBusy = true;
+        _roomLightToggle.classList.add('is-busy');
+        _roomLightToggle.disabled = true;
+        if (_roomLightLabel) {
+            _roomLightLabel.textContent = next === 'on' ? 'Turning on…' : 'Turning off…';
+        }
+
+        // Settle back to the resolved state, or surface a transient message
+        // (insufficient control / error) for 2 s before reverting.
+        const finish = (msg) => {
+            _roomLightBusy = false;
+            _roomLightToggle.classList.remove('is-busy');
+            if (msg) {
+                if (_roomLightLabel) _roomLightLabel.textContent = msg;
+                _roomLightToggle.disabled = false;
+                setTimeout(() => applyRoomLight(_roomLightState, _roomLightAvailable), 2000);
+            } else {
+                applyRoomLight(_roomLightState, _roomLightAvailable);
+            }
+        };
+
+        try {
+            const res = await fetch('/api/devices/room_light/set', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ state: next }),
+            });
+            if (res.status === 401 || res.status === 403) { finish('Need control'); return; }
+            if (!res.ok) {
+                console.error('room light set failed:', await res.text());
+                finish('Error');
+                return;
+            }
+            const data = await res.json();
+            _roomLightState = data.state || next;
+            finish(null);
+        } catch (err) {
+            console.error('room light toggle failed:', err);
+            finish('Error');
+        }
+    }
+
+    function setupRoomLight() {
+        if (!_roomLightToggle) return;
+        _roomLightToggle.addEventListener('click', toggleRoomLight);
+        loadRoomLightStatus();
+        // Light periodic refresh: state can also change from agent plans
+        // (e.g. brightfield imaging turns it on). Status read is cached at the
+        // device layer (no BLE), so polling is cheap; it also makes the toggle
+        // appear automatically once the device layer connects.
+        if (_roomLightTimer) clearInterval(_roomLightTimer);
+        _roomLightTimer = setInterval(loadRoomLightStatus, 15000);
+    }
+
     // =====================================================================
     // View switching
     // =====================================================================
@@ -1327,6 +1428,7 @@ const DevicesManager = (function () {
         cacheDom();
         setupViewSwitcher();
         setupCameraWiring();
+        setupRoomLight();
         loadCoverslip();
         loadEmbryosSnapshot();
         switchView(_currentView);
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index b66893da..528189f9 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -258,6 +258,18 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     </div>
                 </div>
                 <div class="devices-status">
+                    <button class="devices-room-light" id="devices-room-light-toggle" type="button"
+                            title="Toggle room light" aria-pressed="false" hidden disabled>
+                        <span class="devices-room-light-bulb" aria-hidden="true">
+                            <svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor"
+                                 stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">
+                                <path d="M9 18h6"/>
+                                <path d="M10 21h4"/>
+                                <path d="M12 3a6 6 0 0 0-4 10.5c.6.6 1 1.4 1 2.5h6c0-1.1.4-1.9 1-2.5A6 6 0 0 0 12 3z"/>
+                            </svg>
+                        </span>
+                        <span class="devices-room-light-label" id="devices-room-light-label">Room light</span>
+                    </button>
                     <span class="devices-status-led" id="devices-stream-pill">disconnected</span>
                     <span class="devices-status-meta" id="devices-status-meta">no data</span>
                 </div>
diff --git a/start_device_layer.py b/start_device_layer.py
index 5d4d7486..1ce25931 100644
--- a/start_device_layer.py
+++ b/start_device_layer.py
@@ -28,6 +28,58 @@
     sys.path.insert(0, str(project_root))
 
 
+def _render_startup_failure(exc, log_file):
+    """Turn a startup exception into a plain-language console panel.
+
+    The full traceback goes to the log file; the operator (often a biologist)
+    sees a diagnosis and concrete things to check. Recognises the common
+    "hardware powered off / COM port" case from the MMCore error text.
+    """
+    import re
+    import traceback
+    from gently.hardware import console_ui as cui
+
+    logging.getLogger("gently.device_layer").error(
+        "Startup failed:\n%s", "".join(traceback.format_exception(exc))
+    )
+
+    text = str(exc)
+    low = text.lower()
+    first_line = next((ln.strip() for ln in text.splitlines() if ln.strip()), "Unknown error")
+
+    summary = "The device layer could not start."
+    details = first_line
+    hints = []
+
+    dev_m = re.search(r'device "([^"]+)"', text)
+    device = dev_m.group(1) if dev_m else None
+
+    if device and "initialize" in low:
+        # MMCore failed to initialize a hardware device — almost always the
+        # instrument is off, unplugged, or its COM port is held by another app.
+        summary = "Can't reach the microscope - it looks powered off or disconnected."
+        details = f'Device "{device}" failed to initialize.'
+        if device.upper().startswith("COM"):
+            hints = [
+                "Is the microscope / stage controller powered on?",
+                "Are the USB / serial cables connected?",
+                f"Is another program using {device}? (e.g. Micro-Manager still open)",
+            ]
+        else:
+            hints = [
+                f'Check that "{device}" is powered on and connected.',
+                "Is another program (e.g. Micro-Manager) holding the hardware?",
+            ]
+    elif "access is denied" in low or "system error code 5" in low or "already" in low:
+        summary = "A hardware port is busy — another program may be holding it."
+        hints = [
+            "Close Micro-Manager or any other app using the microscope.",
+            "Then start the device layer again.",
+        ]
+
+    cui.error_panel("GENTLY DEVICE LAYER", summary, details, hints, log_file)
+
+
 def main():
     parser = argparse.ArgumentParser(
         description="Gently Device Layer - Hardware Server",
@@ -100,15 +152,15 @@ def main():
 
     hardware_name = config.get("hardware", "dispim")
 
-    print("\n" + "=" * 60)
-    print("GENTLY DEVICE LAYER")
-    print("=" * 60)
-    print(f"\nConfiguration:")
-    print(f"  Hardware:    {hardware_name}")
-    print(f"  HTTP Port:   {args.port}")
-    print(f"  SAM Device:  {args.sam_device}")
-    print(f"  Config:      {args.config}")
-    print()
+    from gently.hardware import console_ui as cui
+    cui.out()
+    cui.header(f"GENTLY{cui.MIDDOT}DEVICE LAYER", badge="starting", badge_style="cyan")
+    cui.row("Hardware", str(hardware_name))
+    cui.row("HTTP port", str(args.port))
+    cui.row("SAM device", str(args.sam_device))
+    cui.row("Config", str(args.config))
+    cui.row("Log file", str(log_file))
+    cui.rule(heavy=True)
 
     # Load hardware module and create device layer
     from gently.hardware import load_hardware
@@ -129,7 +181,8 @@ async def run_server():
         loop = asyncio.get_running_loop()
 
         def request_shutdown():
-            print("\n\nReceived interrupt signal...")
+            cui.out()
+            cui.note("Interrupt received - stopping...", "yellow")
             logging.getLogger("gently.device_layer.signal").warning(
                 "Interrupt signal received — initiating shutdown"
             )
@@ -154,7 +207,11 @@ def win_signal_handler(sig, frame):
     try:
         asyncio.run(run_server())
     except KeyboardInterrupt:
-        print("\n\nDevice layer stopped.")
+        cui.note("Device layer stopped.", "grey")
+    except Exception as exc:
+        # Hardware/init failure — show a diagnosis, not a raw traceback.
+        _render_startup_failure(exc, log_file)
+        sys.exit(1)
 
 
 if __name__ == "__main__":

From cdeabb8ecd483790f9aed1d5924b2413ed487499 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 12:36:40 -0400
Subject: [PATCH 053/314] Retire napari from the agent; add web-chat
 autocomplete; prune dead tools

Visualization (web-only):
- view_volume and batch_lightsheet no longer launch a blocking napari
  window. view_volume broadcasts an open_volume message so the existing
  in-browser ProjectionViewer opens for every connected client and the
  tool returns immediately (removes the Qt-loop freeze behind the SSE
  watchdog). batch_lightsheet pushes captures to the web image strip.
- New server.open_volume_in_browser() + websocket.js open_volume handler;
  bridge connect frame now ships the tool registry too.
- Removed the broken napari-only example; updated docs and the watchdog
  comment. No napari left in the agent runtime.

Chat UX:
- Slash-command and @tool autocomplete in the web chat (the command/tool
  registries were already on the connect frame, just unused).
- Tool rows now show arguments, a one-line result summary, and a warning
  icon when a tool errored or returned a failure string.
- conversation.py tool_call stream now carries result_summary + is_error.

Tool surface:
- Removed 4 permanently-dead databroker tools (no databroker is wired).
- calibrate_embryo use_v04_plan returns gracefully instead of raising.
- Allowlisted snapshot_plan/list_plan_versions/restore_plan_version in
  plan mode.

Fixes from adversarial review:
- open_volume resolves the volume against the live agent session (not the
  stale timelapse tracker), so it doesn't 404 after a web /resume.
- ProjectionViewer clears stale volume state on open and falls back to the
  projection grid when the 3D view is requested without volume data.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/TOOLS.md                                |  15 +-
 docs/guides/capabilities.md                  |   1 -
 examples/README.md                           |   2 -
 examples/example_napari_visualization.py     | 522 -------------------
 gently/app/device_state_monitor.py           |   8 +-
 gently/app/tools/__init__.py                 |   1 -
 gently/app/tools/acquisition_tools.py        |  48 +-
 gently/app/tools/calibration_tools.py        |  22 +-
 gently/app/tools/data_tools.py               | 203 --------
 gently/app/tools/volume_tools.py             | 136 ++---
 gently/harness/bridge.py                     |  29 ++
 gently/harness/conversation.py               |  19 +-
 gently/harness/prompts/manager.py            |   1 +
 gently/ui/web/server.py                      |  34 +-
 gently/ui/web/static/css/agent-chat.css      |  38 ++
 gently/ui/web/static/js/agent-chat.js        | 181 ++++++-
 gently/ui/web/static/js/projection-viewer.js |   8 +
 gently/ui/web/static/js/websocket.js         |  14 +
 18 files changed, 410 insertions(+), 872 deletions(-)
 delete mode 100644 examples/example_napari_visualization.py
 delete mode 100644 gently/app/tools/data_tools.py

diff --git a/docs/TOOLS.md b/docs/TOOLS.md
index 6d9e020c..feafbfbe 100644
--- a/docs/TOOLS.md
+++ b/docs/TOOLS.md
@@ -13,7 +13,7 @@ Source: `gently/agent/tools/` (run mode) and `gently/agent/plan_mode/tools/` (pl
 |------|-------------|
 | `acquire_volume` | Acquire a single 3D lightsheet volume for a specific embryo with calibration data |
 | `capture_lightsheet` | Capture a single 2D lightsheet fluorescence image at specified piezo/galvo position |
-| `batch_lightsheet` | Capture lightsheet images from ALL embryos and display as a stack |
+| `batch_lightsheet` | Capture lightsheet images from ALL embryos and show them in the web UI viewer |
 
 ### Analysis (`analysis_tools.py`)
 
@@ -29,22 +29,13 @@ Source: `gently/agent/tools/` (run mode) and `gently/agent/plan_mode/tools/` (pl
 | `calibrate_embryo` | Run full piezo-galvo calibration for a specific embryo using Claude vision |
 | `calibrate_all_embryos` | Run piezo-galvo calibration for all detected embryos sequentially |
 
-### Data (`data_tools.py`)
-
-| Tool | Description |
-|------|-------------|
-| `list_runs` | List recent Bluesky runs from Databroker |
-| `get_run_data` | Get data from a specific Bluesky run |
-| `get_run_image` | Get an image from a Bluesky run for analysis |
-| `search_runs` | Search Databroker runs by metadata criteria |
-
 ### Detection (`detection_tools.py`)
 
 | Tool | Description |
 |------|-------------|
 | `detect_embryos` | Automatically detect embryos using brightness detection and SAM segmentation |
 | `manual_mark_embryos` | Open interactive window to manually mark embryos by clicking |
-| `edit_embryos` | Open napari editor to add/remove/move embryo positions |
+| `edit_embryos` | Add/remove/move embryo positions in the web map view |
 | `show_detected_embryos` | Capture fresh image and display all tracked embryos with labeled bounding boxes |
 
 ### Detectors (`detector_tools.py`)
@@ -145,7 +136,7 @@ Source: `gently/agent/tools/` (run mode) and `gently/agent/plan_mode/tools/` (pl
 | Tool | Description |
 |------|-------------|
 | `view_image` | Capture and display current bottom camera widefield image |
-| `view_volume` | Open a volume in napari for 3D visualization |
+| `view_volume` | Open a volume in the in-browser 3D viewer |
 | `list_volumes` | List available volumes for an embryo or all embryos |
 
 ---
diff --git a/docs/guides/capabilities.md b/docs/guides/capabilities.md
index d3b097c7..846d662c 100644
--- a/docs/guides/capabilities.md
+++ b/docs/guides/capabilities.md
@@ -133,7 +133,6 @@ This design means experimental AI code — perception systems, coding agents, no
 | **Analysis** | analyze_volume, classify_embryo_stage | No |
 | **Experiment** | get_experiment_summary, query_embryo_status | No |
 | **Session** | list_sessions, import_embryos_from_session | No |
-| **Data** | list_runs, get_run_data, search_runs | No |
 | **Planning** | create_campaign, propose_plan, search_literature | No |
 | **Research** | search_literature, read_paper, search_strains | No |
 
diff --git a/examples/README.md b/examples/README.md
index c538fbc0..cb6f6b06 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -5,11 +5,9 @@ Working examples of Gently's Bluesky plan system and visualization pipeline.
 | Example | Description |
 |---------|-------------|
 | `example_dispim_workflows.py` | Complete DiSPIM workflows: atomic plans, autofocus, two-point calibration, embryo detection, multi-embryo acquisition |
-| `example_napari_visualization.py` | Real-time napari visualization: focus sweeps, embryo detection, dual-sided DiSPIM, custom configurations |
 
 ## Requirements
 
 ```bash
 pip install gently[device]   # Bluesky + Ophyd for hardware plans
-pip install napari[all]      # For visualization examples
 ```
diff --git a/examples/example_napari_visualization.py b/examples/example_napari_visualization.py
deleted file mode 100644
index cfbad522..00000000
--- a/examples/example_napari_visualization.py
+++ /dev/null
@@ -1,522 +0,0 @@
-#!/usr/bin/env python
-"""
-DiSPIM Napari Visualization Examples
-===================================
-
-Demonstrates real-time image visualization for DiSPIM experiments using napari.
-Shows different visualization patterns for various experiment types.
-
-This example shows:
-1. Basic napari setup with Bluesky RunEngine
-2. Focus sweep visualization (3D image stacks)
-3. Embryo detection visualization (2D image sequences)
-4. Dual-sided DiSPIM visualization (multi-channel)
-5. Custom visualization configurations
-6. Integration with complete DiSPIM workflows
-
-Requirements:
-    pip install napari[all]
-    # or with specific backend: pip install napari[pyqt5]
-"""
-
-import logging
-import numpy as np
-from bluesky import RunEngine
-from bluesky.callbacks import LiveTable
-
-# Import gently components
-from gently import (
-    # Device classes
-    create_dispim_system,
-    DiSPIMSystem,
-    
-    # Plan functions
-    focus_sweep,
-    dispim_piezo_autofocus,
-    find_embryos_with_bottom_camera,
-    full_dispim_workflow,
-    
-    # Configuration classes
-    AutofocusConfig,
-    CalibrationConfig,
-    
-    # Analysis utilities
-    FocusAlgorithm,
-    FitFunction
-)
-
-# Import visualization utilities
-from gently.ui.web import (
-    EmbryoMarker,
-    mark_embryos_napari,
-    generate_focus_curve_plot,
-    generate_calibration_summary_plot,
-    generate_edge_detection_plot,
-)
-
-# Napari availability check
-try:
-    import napari
-    NAPARI_AVAILABLE = True
-except ImportError:
-    NAPARI_AVAILABLE = False
-
-
-def check_napari_installation():
-    """Check if napari is available and provide installation instructions"""
-    if not NAPARI_AVAILABLE:
-        print("❌ Napari not available!")
-        print("\nTo enable image visualization, install napari:")
-        print("  pip install napari[all]")
-        print("\nOr with specific backend:")
-        print("  pip install napari[pyqt5]")
-        print("  # or napari[pyside2]")
-        print("\nAfter installation, restart and run this example again.")
-        return False
-    
-    print("✅ Napari is available - image visualization enabled!")
-    return True
-
-
-def setup_demo_system():
-    """Setup demo DiSPIM system for visualization examples"""
-    print("Setting up demo DiSPIM system...")
-    
-    # Create RunEngine
-    RE = RunEngine({})
-    
-    # For demonstration, we'll use mock system
-    # In practice: system = create_dispim_system("/path/to/micromanager", "config.cfg")
-    print("  [Note: Using mock system for demonstration]")
-    system = None  # Would be actual DiSPIMSystem
-    light_sheet = None  # Would be system.side_a
-    
-    return RE, system, light_sheet
-
-
-def demonstrate_basic_napari_setup(RE):
-    """Demonstrate basic napari visualization setup"""
-    print("\n" + "="*60)
-    print("1. BASIC NAPARI SETUP - Real-time Image Visualization")
-    print("="*60)
-    
-    print("\nSetting up napari for DiSPIM visualization:")
-    
-    # Create napari callback with default settings
-    napari_callback = setup_napari_callback()
-    
-    if not napari_callback.enabled:
-        print("  ❌ Napari callback disabled (napari not available)")
-        return None
-    
-    # Subscribe to RunEngine
-    RE.subscribe(napari_callback)
-    
-    print("  ✅ Napari callback created and subscribed")
-    print(f"  ✅ Viewer title: {napari_callback.viewer.title}")
-    print(f"  ✅ Focus sweeps: {napari_callback.show_focus_sweeps}")
-    print(f"  ✅ Embryo detection: {napari_callback.show_embryo_detection}")
-    print(f"  ✅ Dual channel: {napari_callback.dual_channel_mode}")
-    
-    print("\nBasic usage pattern:")
-    print("  RE = RunEngine({})")
-    print("  napari_callback = setup_napari_callback()")
-    print("  RE.subscribe(napari_callback)")
-    print("  # Now any plan with images will display in napari!")
-    
-    return napari_callback
-
-
-def demonstrate_focus_sweep_visualization(RE, light_sheet, napari_callback):
-    """Demonstrate focus sweep visualization"""
-    print("\n" + "="*60)
-    print("2. FOCUS SWEEP VISUALIZATION - 3D Image Stacks")
-    print("="*60)
-    
-    if not napari_callback or not napari_callback.enabled:
-        print("  ⚠ Skipping - napari not available")
-        return
-    
-    print("\nFocus sweep creates 3D image stacks visualized in real-time:")
-    
-    # Configure autofocus
-    config = AutofocusConfig(
-        num_positions=15,  # Fewer positions for faster demo
-        step_size_um=1.0,
-        algorithm=FocusAlgorithm.VOLATH.value,
-        fit_function=FitFunction.GAUSSIAN.value
-    )
-    
-    print(f"\nAutofocus configuration:")
-    print(f"  Positions: {config.num_positions}")
-    print(f"  Step size: {config.step_size_um} μm")
-    print(f"  Total range: ±{config.num_positions * config.step_size_um / 2} μm")
-    
-    if light_sheet is not None:
-        print(f"\nExecuting autofocus with napari visualization:")
-        print(f"  RE(dispim_piezo_autofocus(light_sheet, config))")
-        
-        # This would display images in napari as they're acquired
-        # RE(dispim_piezo_autofocus(light_sheet, config))
-        
-        print(f"\nNapari display:")
-        print(f"  ✅ Images stream to napari as they're acquired")
-        print(f"  ✅ 3D stack builds up in real-time")
-        print(f"  ✅ Can scrub through Z positions")
-        print(f"  ✅ Focus curve visible as image stack")
-        
-    else:
-        print(f"\n[Would execute: RE(dispim_piezo_autofocus(light_sheet, config))]")
-        print(f"\nExpected napari behavior:")
-        print(f"  - New layer: 'Focus Sweep (Side A)'")
-        print(f"  - Green colormap for side A data")
-        print(f"  - 3D stack: shape (15, height, width)")
-        print(f"  - Real-time updates as images acquired")
-    
-    print(f"\nVisualization features:")
-    print(f"  - Real-time focus quality assessment")
-    print(f"  - Immediate feedback on scan progress")
-    print(f"  - Visual validation of focus curve")
-
-
-def demonstrate_embryo_detection_visualization(RE, system, napari_callback):
-    """Demonstrate embryo detection visualization"""
-    print("\n" + "="*60)
-    print("3. EMBRYO DETECTION VISUALIZATION - 2D Image Sequences")
-    print("="*60)
-    
-    if not napari_callback or not napari_callback.enabled:
-        print("  ⚠ Skipping - napari not available")
-        return
-    
-    print("\nEmbryo detection creates sequences of 2D images from XY scanning:")
-    
-    # Configure embryo detection
-    detection_config = {
-        'scan_area': {
-            'x_start': -500, 'x_stop': 500,  # Smaller area for demo
-            'y_start': -500, 'y_stop': 500,
-            'step_size': 100  # μm between positions
-        },
-        'detection': {
-            'min_size_pixels': 50,
-            'max_size_pixels': 500,
-            'brightness_threshold': 0.3
-        }
-    }
-    
-    print(f"\nDetection configuration:")
-    print(f"  Scan area: {detection_config['scan_area']['x_start']} to {detection_config['scan_area']['x_stop']} μm")
-    print(f"  Step size: {detection_config['scan_area']['step_size']} μm")
-    print(f"  Grid size: 11x11 = 121 positions")
-    
-    if system is not None:
-        print(f"\nExecuting embryo detection with napari visualization:")
-        print(f"  RE(find_embryos_with_bottom_camera(system, detection_config))")
-        
-        # This would display images in napari as XY scan progresses
-        # RE(find_embryos_with_bottom_camera(system, detection_config))
-        
-        print(f"\nNapari display:")
-        print(f"  ✅ Each XY position shows in napari immediately")
-        print(f"  ✅ Can see scan progress across sample")
-        print(f"  ✅ Potential embryos highlighted as found")
-        print(f"  ✅ Final mosaic view of scanned area")
-        
-    else:
-        print(f"\n[Would execute: RE(find_embryos_with_bottom_camera(system, detection_config))]")
-        print(f"\nExpected napari behavior:")
-        print(f"  - New layer: 'Embryo Detection (Side A)'")
-        print(f"  - Updates with each XY position")
-        print(f"  - 121 total images in sequence")
-        print(f"  - Detected embryos marked/highlighted")
-    
-    print(f"\nVisualization benefits:")
-    print(f"  - Real-time quality control of scan")
-    print(f"  - Immediate feedback on embryo locations")
-    print(f"  - Visual verification of detection algorithm")
-
-
-def demonstrate_dual_channel_visualization(RE, system, napari_callback):
-    """Demonstrate dual-sided DiSPIM visualization"""
-    print("\n" + "="*60)
-    print("4. DUAL-CHANNEL VISUALIZATION - Multi-Camera Display")
-    print("="*60)
-    
-    if not napari_callback or not napari_callback.enabled:
-        print("  ⚠ Skipping - napari not available")
-        return
-    
-    print("\nDual-sided DiSPIM generates images from two cameras simultaneously:")
-    
-    if system is not None:
-        print(f"\nSimulating dual-sided acquisition:")
-        print(f"  # Both sides acquire simultaneously")
-        print(f"  side_a_image = system.side_a.camera.read()")
-        print(f"  side_b_image = system.side_b.camera.read()")
-        
-        print(f"\nNapari display:")
-        print(f"  ✅ Side A: Green channel")
-        print(f"  ✅ Side B: Magenta channel") 
-        print(f"  ✅ Additive blending for overlay")
-        print(f"  ✅ Separate layers for independent control")
-        print(f"  ✅ Synchronized updates")
-        
-    else:
-        print(f"\n[Would show both camera feeds simultaneously]")
-    
-    print(f"\nColor scheme:")
-    print(f"  - Side A (illumination from left): Green")
-    print(f"  - Side B (illumination from right): Magenta")
-    print(f"  - Overlaid: Shows complementary information")
-    
-    print(f"\nVisualization advantages:")
-    print(f"  - Compare image quality from both sides")
-    print(f"  - See complementary sample information")
-    print(f"  - Identify optimal viewing angle")
-    print(f"  - Real-time feedback for dual-sided experiments")
-
-
-def demonstrate_custom_visualization_configs(RE):
-    """Demonstrate custom visualization configurations"""
-    print("\n" + "="*60)
-    print("5. CUSTOM CONFIGURATIONS - Tailored Visualization")
-    print("="*60)
-    
-    if not NAPARI_AVAILABLE:
-        print("  ⚠ Skipping - napari not available")
-        return
-    
-    print("\nCustom configurations for different experiment needs:")
-    
-    # Configuration 1: Focus-only visualization
-    print(f"\n1. Focus-Only Configuration:")
-    print(f"   config = {{'show_focus_sweeps': True, 'show_embryo_detection': False}}")
-    print(f"   napari_callback = setup_napari_callback(config)")
-    
-    focus_config = {
-        'show_focus_sweeps': True,
-        'show_embryo_detection': False,
-        'show_single_images': False,
-        'update_interval': 0.05  # Faster updates
-    }
-    
-    print(f"   - Only shows focus sweep experiments")
-    print(f"   - Faster update rate (0.05s)")
-    print(f"   - Optimized for autofocus development")
-    
-    # Configuration 2: High-throughput visualization
-    print(f"\n2. High-Throughput Configuration:")
-    print(f"   config = {{'show_single_images': False, 'update_interval': 1.0}}")
-    
-    throughput_config = {
-        'show_focus_sweeps': True,
-        'show_embryo_detection': True,
-        'show_single_images': False,  # Skip individual images
-        'update_interval': 1.0  # Slower updates for performance
-    }
-    
-    print(f"   - Skip individual images to reduce overhead")
-    print(f"   - Slower update rate (1.0s) for performance")
-    print(f"   - Better for automated, high-throughput experiments")
-    
-    # Configuration 3: Development/debugging
-    print(f"\n3. Development/Debugging Configuration:")
-    print(f"   config = {{'show_single_images': True, 'update_interval': 0.01}}")
-    
-    debug_config = {
-        'show_focus_sweeps': True,
-        'show_embryo_detection': True,
-        'show_single_images': True,
-        'update_interval': 0.01  # Very fast updates
-    }
-    
-    print(f"   - Show every image for detailed inspection")
-    print(f"   - Very fast updates (0.01s)")
-    print(f"   - Maximum detail for troubleshooting")
-    
-    print(f"\nUsage pattern:")
-    print(f"  # Choose configuration for your needs")
-    print(f"  config = focus_config  # or throughput_config, debug_config")
-    print(f"  napari_callback = setup_napari_callback(config)")
-    print(f"  RE.subscribe(napari_callback)")
-
-
-def demonstrate_convenience_functions(RE):
-    """Demonstrate convenience functions for common patterns"""
-    print("\n" + "="*60)
-    print("6. CONVENIENCE FUNCTIONS - Common Usage Patterns")
-    print("="*60)
-    
-    if not NAPARI_AVAILABLE:
-        print("  ⚠ Skipping - napari not available")
-        return
-    
-    print("\nConvenience functions for common visualization needs:")
-    
-    print(f"\n1. Focus Sweep Only:")
-    print(f"   from gently.visualization import enable_focus_sweep_visualization")
-    print(f"   enable_focus_sweep_visualization(RE)")
-    print(f"   # Optimized for autofocus experiments")
-    
-    print(f"\n2. Embryo Detection Only:")
-    print(f"   from gently.visualization import enable_embryo_detection_visualization")
-    print(f"   enable_embryo_detection_visualization(RE)")
-    print(f"   # Optimized for sample detection")
-    
-    print(f"\n3. Full Visualization:")
-    print(f"   from gently.visualization import enable_full_visualization")
-    print(f"   enable_full_visualization(RE)")
-    print(f"   # Shows everything - good for general use")
-    
-    print(f"\n4. Custom Viewer:")
-    print(f"   from gently.visualization import create_napari_viewer")
-    print(f"   viewer = create_napari_viewer('My DiSPIM Experiment')")
-    print(f"   callback = setup_napari_callback(viewer=viewer)")
-    print(f"   # Use your own configured viewer")
-    
-    print(f"\nBenefits:")
-    print(f"  - One-line setup for common patterns")
-    print(f"  - Pre-configured for specific experiment types")
-    print(f"  - Easy to integrate into existing workflows")
-
-
-def demonstrate_complete_workflow_visualization(RE, system):
-    """Demonstrate visualization with complete DiSPIM workflow"""
-    print("\n" + "="*60)
-    print("7. COMPLETE WORKFLOW VISUALIZATION - Full Experiment")
-    print("="*60)
-    
-    if not NAPARI_AVAILABLE:
-        print("  ⚠ Skipping - napari not available")
-        return
-    
-    print("\nVisualization during complete multi-embryo workflow:")
-    
-    # Setup full visualization
-    print(f"\nSetting up comprehensive visualization:")
-    print(f"  napari_callback = enable_full_visualization(RE)")
-    print(f"  # Will show all stages of the workflow")
-    
-    # Complete workflow configuration
-    workflow_config = {
-        'system_setup': {
-            'center_devices': True,
-            'run_calibration': True
-        },
-        'calibration': {
-            'point1_um': 25.0,
-            'point2_um': 75.0,
-            'autofocus_each_point': True
-        },
-        'embryo_detection': {
-            'x_start': -1000, 'x_stop': 1000,
-            'y_start': -1000, 'y_stop': 1000,
-            'step_size': 200
-        },
-        'acquisition': {
-            'z_stack': {'range_um': 50, 'step_size_um': 1.0},
-            'dual_sided': True,
-            'time_points': 3
-        }
-    }
-    
-    print(f"\nWorkflow stages with visualization:")
-    
-    if system is not None:
-        print(f"\n  RE(full_dispim_workflow(system, workflow_config))")
-        print(f"\n  Expected napari display sequence:")
-        
-    print(f"  1. Calibration stage:")
-    print(f"     - Focus sweeps at calibration points")
-    print(f"     - Real-time focus quality assessment")
-    
-    print(f"  2. Embryo detection stage:")
-    print(f"     - XY scan images streaming in")
-    print(f"     - Detected embryo positions highlighted")
-    
-    print(f"  3. Multi-embryo acquisition:")
-    print(f"     - Focus sweeps for each embryo")
-    print(f"     - Z-stack acquisitions (dual-channel)")
-    print(f"     - Time series progression")
-    
-    print(f"\nVisualization benefits for complete workflow:")
-    print(f"  ✅ Monitor entire experiment progress")
-    print(f"  ✅ Quality control at each stage")
-    print(f"  ✅ Early detection of issues")
-    print(f"  ✅ Real-time data assessment")
-    print(f"  ✅ Immediate feedback on results")
-
-
-def main():
-    """Main napari visualization demonstration"""
-    print("DiSPIM Napari Visualization Examples")
-    print("=" * 60)
-    print()
-    print("This example demonstrates real-time image visualization")
-    print("for DiSPIM experiments using napari and Bluesky callbacks.")
-    print()
-    
-    # Check napari installation
-    if not check_napari_installation():
-        return
-    
-    # Setup demo system
-    RE, system, light_sheet = setup_demo_system()
-    
-    # Run demonstrations
-    napari_callback = demonstrate_basic_napari_setup(RE)
-    demonstrate_focus_sweep_visualization(RE, light_sheet, napari_callback)
-    demonstrate_embryo_detection_visualization(RE, system, napari_callback)
-    demonstrate_dual_channel_visualization(RE, system, napari_callback)
-    demonstrate_custom_visualization_configs(RE)
-    demonstrate_convenience_functions(RE)
-    demonstrate_complete_workflow_visualization(RE, system)
-    
-    # Summary
-    print("\n" + "="*60)
-    print("SUMMARY - Napari Visualization Integration")
-    print("="*60)
-    
-    print(f"\n✅ Napari integration complete:")
-    print(f"  - Real-time image streaming from Bluesky plans")
-    print(f"  - Automatic 3D stack visualization for focus sweeps")
-    print(f"  - 2D image sequences for embryo detection")
-    print(f"  - Dual-channel support for two-sided DiSPIM")
-    print(f"  - Configurable visualization options")
-    
-    print(f"\n✅ Key benefits:")
-    print(f"  - Immediate visual feedback during experiments")
-    print(f"  - Quality control and error detection")
-    print(f"  - Interactive data exploration")
-    print(f"  - Non-intrusive - works with existing plans")
-    print(f"  - Optional - graceful fallback if napari not available")
-    
-    print(f"\n✅ Usage patterns:")
-    print(f"  - Basic: setup_napari_callback() → RE.subscribe()")
-    print(f"  - Custom: setup_napari_callback(config) for specific needs")
-    print(f"  - Convenience: enable_focus_sweep_visualization(RE)")
-    print(f"  - Integration: Works with all existing DiSPIM plans")
-    
-    print(f"\nNext steps:")
-    print(f"  1. Install napari: pip install napari[all]")
-    print(f"  2. Add visualization to your DiSPIM experiments")
-    print(f"  3. Customize configurations for your needs")
-    print(f"  4. Enjoy real-time image feedback!")
-    
-    if napari_callback and napari_callback.enabled:
-        print(f"\nNapari viewer is open - explore the interface!")
-        print(f"  - Layer controls for each image type")
-        print(f"  - Color/brightness adjustments")
-        print(f"  - 3D visualization controls")
-        print(f"  - Screenshot and movie export options")
-    
-    print(f"\nGently DiSPIM + Napari: Real-time microscopy visualization! 🔬✨")
-
-
-if __name__ == "__main__":
-    # Setup logging
-    logging.basicConfig(level=logging.INFO)
-    
-    # Run demonstration
-    main()
\ No newline at end of file
diff --git a/gently/app/device_state_monitor.py b/gently/app/device_state_monitor.py
index beff9a54..55e61daf 100644
--- a/gently/app/device_state_monitor.py
+++ b/gently/app/device_state_monitor.py
@@ -14,9 +14,11 @@
 
 Watchdog
 --------
-The SSE iterator can silently stall in the agent process — most reliably
-when a Qt window (napari) freezes the asyncio loop synchronously during a
-tool call, but in principle any half-open TCP path can cause it. aiohttp's
+The SSE iterator can silently stall in the agent process whenever a
+half-open TCP path or a long synchronous tool call wedges the asyncio loop.
+(Historically the worst offender was a Qt window — napari — blocking the
+loop during a tool call; that path is gone now that all visualization is
+in-browser, but the watchdog stays for general robustness.) aiohttp's
 async iterator won't raise on a stalled socket; the ``async for`` just
 waits forever. To recover, a sibling watchdog task tracks the timestamp of
 the last received event; if no event arrives within ``stale_timeout_sec``
diff --git a/gently/app/tools/__init__.py b/gently/app/tools/__init__.py
index 4dd1b776..99c91e34 100644
--- a/gently/app/tools/__init__.py
+++ b/gently/app/tools/__init__.py
@@ -15,7 +15,6 @@
 from . import acquisition_tools
 from . import volume_tools
 from . import analysis_tools
-from . import data_tools
 from . import timelapse_tools
 from . import session_tools
 from . import focus_tools
diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index 2500fe41..0f429982 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -302,10 +302,11 @@ async def capture_lightsheet(
 
 @tool(
     name="batch_lightsheet",
-    description="""Capture lightsheet images from ALL embryos and display them together in a single napari viewer.
+    description="""Capture lightsheet images from ALL embryos and show them together in the web UI.
 Use when user says "lightsheet all embryos", "capture all embryos", "show me all embryos in lightsheet".
-Moves to each embryo, captures a lightsheet image, then opens napari with all images as separate layers.
-Much more efficient than capturing one at a time.""",
+Moves to each embryo, captures a lightsheet image, saves it, and pushes it to the
+web viewer (live image strip) for everyone watching. Much more efficient than
+capturing one at a time.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
     examples=[
@@ -317,7 +318,7 @@ async def batch_lightsheet(
     galvo_position: float = 0.0,
     context: Dict = None
 ) -> str:
-    """Capture lightsheet images from all embryos and show in single napari viewer"""
+    """Capture lightsheet images from all embryos and show them in the web UI"""
     agent = context.get('agent')
     client = context.get('client')
 
@@ -403,32 +404,25 @@ async def batch_lightsheet(
 
     logger.info("Saved %d images to %s", len(images), save_dir)
 
-    # Open single napari viewer with all images as a stack
-    import napari
-    import numpy as np
-    logger.info("Opening napari with %d embryo images as stack...", len(images))
-
-    # Stack images into a single array for slider navigation
-    image_stack = np.stack(images, axis=0)
-
-    viewer = napari.Viewer(title=f"Batch Lightsheet - {len(images)} embryos")
-
-    # Add as single stack with slider (grayscale)
-    viewer.add_image(
-        image_stack,
-        name='Embryos',
-        colormap='gray',
-    )
-
-    # Print embryo ID mapping for reference
-    logger.info("Slider index -> Embryo ID:")
-    for i, eid in enumerate(embryo_ids):
-        logger.info("  %d: %s", i, eid)
-
-    napari.run()
+    # Push each captured image to the web UI \u2014 no blocking desktop window.
+    # They appear in the live viewer / recent strip for everyone watching.
+    pushed = 0
+    if agent.viz_server is not None:
+        for img, eid in zip(images, embryo_ids):
+            uid = f"batch_lightsheet_{eid}_{timestamp}"
+            agent.push_viz(
+                img, uid, "image",
+                {"embryo_id": eid, "source": "batch_lightsheet", "label": eid},
+            )
+            pushed += 1
+        logger.info("Pushed %d batch-lightsheet images to the web UI", pushed)
 
     # Summary
     summary = f"\u2713 Captured {len(images)} embryos: {', '.join(embryo_ids)}"
+    if pushed:
+        summary += f"\nShowing {pushed} image(s) in the web UI viewer."
+    elif agent.viz_server is None:
+        summary += "\n(Web UI not running \u2014 images saved to disk only.)"
     if errors:
         summary += f"\n\u26a0 Errors: {'; '.join(errors)}"
     summary += f"\nSaved to: {save_dir}"
diff --git a/gently/app/tools/calibration_tools.py b/gently/app/tools/calibration_tools.py
index 963dc2d0..f827b8f8 100644
--- a/gently/app/tools/calibration_tools.py
+++ b/gently/app/tools/calibration_tools.py
@@ -973,18 +973,16 @@ async def calibrate_embryo(
         return f"Error: Not connected to microscope server. Cannot calibrate {embryo_id}."
 
     if use_v04_plan:
-        # Escape hatch hook. Not wired yet - delegating to the real Bluesky
-        # plan requires a RunEngine and device objects that live on the device
-        # layer, so the caller would have to submit the plan through the queue
-        # server. Since the surgical path already mirrors v0.4.0's behavior,
-        # this is a placeholder for a future hardware-regression follow-up.
-        raise NotImplementedError(
-            "use_v04_plan=True is not wired yet. The default surgical path "
-            "in calibrate_embryo already replicates the v0.4.0 calibration "
-            "plan's behavior (edge detection + inset + wide adaptive sweep). "
-            "If that path regresses on hardware, wire this branch to submit "
-            "gently.hardware.dispim.plans.calibration.calibrate_embryo_piezo_galvo "
-            "through the queue server's plan-submission API."
+        # Escape hatch reserved for a future hardware-regression follow-up. It is
+        # intentionally unwired (delegating to the real Bluesky plan needs a
+        # RunEngine + device objects that live on the device layer). Return a
+        # clear message instead of raising, so a model that sets this flag gets a
+        # graceful answer rather than a hard NotImplementedError — the default
+        # surgical path already mirrors v0.4.0 behavior.
+        return (
+            "use_v04_plan is not available: the default calibration path already "
+            "replicates the v0.4.0 plan (edge detection + inset + wide adaptive "
+            "sweep). Re-run calibrate_embryo without use_v04_plan."
         )
     logger.info("calibration path: surgical (v0.4.0-equivalent inset + adaptive sweep)")
 
diff --git a/gently/app/tools/data_tools.py b/gently/app/tools/data_tools.py
deleted file mode 100644
index 9435a433..00000000
--- a/gently/app/tools/data_tools.py
+++ /dev/null
@@ -1,203 +0,0 @@
-"""
-Databroker Tools
-
-Tools for querying and retrieving data from Bluesky/Databroker.
-"""
-
-from typing import Dict, List
-
-from gently.harness.tools.registry import tool, ToolCategory
-from gently.harness.tools.helpers import require_agent
-
-
-@tool(
-    name="list_runs",
-    description="List recent Bluesky runs from Databroker",
-    category=ToolCategory.DATA,
-)
-def list_runs(
-    limit: int = 10,
-    embryo_id: str = None,
-    plan_name: str = None,
-    context: Dict = None
-) -> str:
-    """List recent runs"""
-    agent = context.get('agent')
-
-    if not agent or not agent.databroker:
-        return "Databroker not available"
-
-    try:
-        db = agent.databroker
-
-        query = {}
-        if embryo_id:
-            query['embryo_id'] = embryo_id
-        if plan_name:
-            query['plan_name'] = plan_name
-
-        runs = list(db(**query))[:limit]
-
-        if not runs:
-            return "No runs found"
-
-        lines = [f"Recent runs ({len(runs)}):", ""]
-
-        for run_uid in runs:
-            run = db[run_uid]
-            start = run.metadata.get('start', {})
-            lines.append(f"* {run_uid[:8]}...")
-            lines.append(f"  Plan: {start.get('plan_name', 'unknown')}")
-            lines.append(f"  Time: {start.get('time', 'unknown')}")
-            if 'embryo_id' in start:
-                lines.append(f"  Embryo: {start['embryo_id']}")
-            lines.append("")
-
-        return "\n".join(lines)
-
-    except Exception as e:
-        return f"Error listing runs: {str(e)}"
-
-
-@tool(
-    name="get_run_data",
-    description="Get data from a specific Bluesky run",
-    category=ToolCategory.DATA,
-)
-def get_run_data(
-    run_id: str,
-    data_keys: List[str] = None,
-    stream: str = "primary",
-    context: Dict = None
-) -> str:
-    """Get run data"""
-    agent = context.get('agent')
-
-    if not agent or not agent.databroker:
-        return "Databroker not available"
-
-    try:
-        db = agent.databroker
-
-        if run_id.startswith('-'):
-            run = db[int(run_id)]
-        else:
-            run = db[run_id]
-
-        data = run.primary.read()
-
-        if data_keys:
-            data = {k: data[k] for k in data_keys if k in data}
-
-        lines = [f"Run: {run.metadata['start']['uid'][:8]}...", ""]
-        lines.append(f"Available keys: {list(data.keys())}")
-
-        for key, values in data.items():
-            shape = values.shape if hasattr(values, 'shape') else 'scalar'
-            lines.append(f"  {key}: shape={shape}")
-
-        return "\n".join(lines)
-
-    except Exception as e:
-        return f"Error getting run data: {str(e)}"
-
-
-@tool(
-    name="get_run_image",
-    description="Get an image from a Bluesky run for analysis",
-    category=ToolCategory.DATA,
-)
-async def get_run_image(
-    run_id: str,
-    detector: str = None,
-    analyze: bool = False,
-    analysis_prompt: str = None,
-    context: Dict = None
-) -> str:
-    """Get run image"""
-    agent = context.get('agent')
-
-    if not agent or not agent.databroker:
-        return "Databroker not available"
-
-    try:
-        db = agent.databroker
-
-        if run_id.startswith('-'):
-            run = db[int(run_id)]
-        else:
-            run = db[run_id]
-
-        data = run.primary.read()
-
-        if not detector:
-            for key in ['bottom_camera', 'camera', 'detector']:
-                if key in data:
-                    detector = key
-                    break
-
-        if detector not in data:
-            return f"Detector '{detector}' not found. Available: {list(data.keys())}"
-
-        image = data[detector]
-        shape = image.shape if hasattr(image, 'shape') else 'unknown'
-
-        result = f"Retrieved image from {detector}\nShape: {shape}"
-
-        if analyze and analysis_prompt:
-            analysis = await agent._analyze_image_with_vision(
-                image=image,
-                prompt=analysis_prompt
-            )
-            result += f"\n\nAnalysis:\n{analysis}"
-
-        return result
-
-    except Exception as e:
-        return f"Error getting image: {str(e)}"
-
-
-@tool(
-    name="search_runs",
-    description="Search Databroker runs by metadata criteria",
-    category=ToolCategory.DATA,
-)
-def search_runs(
-    since: str = None,
-    until: str = None,
-    metadata: Dict = None,
-    limit: int = 20,
-    context: Dict = None
-) -> str:
-    """Search runs"""
-    agent = context.get('agent')
-
-    if not agent or not agent.databroker:
-        return "Databroker not available"
-
-    try:
-        db = agent.databroker
-
-        query = metadata or {}
-
-        if since:
-            query['since'] = since
-        if until:
-            query['until'] = until
-
-        runs = list(db(**query))[:limit]
-
-        if not runs:
-            return "No matching runs found"
-
-        lines = [f"Found {len(runs)} runs:", ""]
-
-        for run_uid in runs:
-            run = db[run_uid]
-            start = run.metadata.get('start', {})
-            lines.append(f"* {run_uid[:8]}: {start.get('plan_name', 'unknown')}")
-
-        return "\n".join(lines)
-
-    except Exception as e:
-        return f"Error searching runs: {str(e)}"
diff --git a/gently/app/tools/volume_tools.py b/gently/app/tools/volume_tools.py
index 080e56dc..b1b69e59 100644
--- a/gently/app/tools/volume_tools.py
+++ b/gently/app/tools/volume_tools.py
@@ -118,15 +118,17 @@ async def view_image(
 
 @tool(
     name="view_volume",
-    description="""Open a volume in napari for 3D visualization.
-Can open a volume by file path OR by embryo ID (opens latest volume or specific timepoint).
-Use when user says "open volume", "view volume", "show volume in napari", or "look at the 3D data".""",
+    description="""Open an acquired volume in the in-browser 3D viewer.
+Opens by embryo ID \u2014 the latest volume, or a specific timepoint. The volume
+appears in the web UI's volume viewer (interactive 3D raymarcher + projections)
+for everyone watching the session; nothing pops up on the instrument desktop.
+Use when the user says "open volume", "view volume", "show the 3D data", or
+"look at timepoint N of embryo X".""",
     category=ToolCategory.ANALYSIS,
     requires_microscope=False,
     examples=[
         ToolExample("Open latest volume for embryo 2", {"embryo_id": "embryo_2"}),
         ToolExample("Open specific timepoint", {"embryo_id": "embryo_2", "timepoint": 5}),
-        ToolExample("Open volume file", {"file_path": "D:/Gently/volumes/embryo_1_t0001.tif"}),
     ],
 )
 async def view_volume(
@@ -135,95 +137,71 @@ async def view_volume(
     file_path: str = None,
     context: Dict = None
 ) -> str:
-    """Open a volume in napari for visualization"""
-    import napari
-    import tifffile
-    import numpy as np
+    """Open a volume in the browser-based viewer (no blocking desktop window)."""
     from pathlib import Path
 
     agent, err = require_agent(context)
     if err:
         return err
 
-    volume = None
-    volume_path = None
-    title = "Volume Viewer"
+    session_id = agent.session_id
 
-    # Determine which volume to open
-    if file_path:
-        # Open from file path
-        volume_path = Path(file_path)
-        if not volume_path.exists():
+    # file_path is legacy. In-browser viewing is addressed by embryo + timepoint,
+    # so map a FileStore path (embryos/{embryo_id}/volumes/t{NNNN}.tif) back to
+    # those when possible.
+    if file_path and not embryo_id:
+        p = Path(file_path)
+        if not p.exists():
             return f"Error: File not found: {file_path}"
-        title = f"Volume: {volume_path.name}"
-
-    elif embryo_id:
-        # Get volume for embryo from FileStore
-        session_id = agent.session_id
-
-        if timepoint is not None:
-            # Try to find specific timepoint via FileStore
-            volume_path = agent.store.get_volume_path(session_id, embryo_id, timepoint)
-            if volume_path and volume_path.exists():
-                title = f"{embryo_id} - t{timepoint:04d}"
-            else:
-                # Check recent_images as fallback
-                embryo, err = get_embryo_or_error(agent, embryo_id)
-                if err:
-                    return err
-                if embryo.recent_images:
-                    matching = [img for img in embryo.recent_images if img.timepoint == timepoint]
-                    if matching:
-                        volume_path = Path(matching[0].volume_path)
-                        title = f"{embryo_id} - t{timepoint:04d}"
-
-                if not volume_path or not volume_path.exists():
-                    # List available timepoints from store
-                    volumes = agent.store.list_volumes(session_id, embryo_id)
-                    available = sorted([v['timepoint'] for v in volumes])
-                    return f"Timepoint {timepoint} not found for {embryo_id}. Available: {available}"
-        else:
-            # Find latest volume from store
+        stem = p.stem  # e.g. "t0005"
+        try:
+            if stem.startswith("t"):
+                timepoint = int(stem[1:])
+            # .../embryos/{embryo_id}/volumes/t{NNNN}.tif \u2192 embryo dir is parent of "volumes"
+            embryo_id = p.parent.parent.name
+        except (ValueError, IndexError):
+            pass
+        if not embryo_id or timepoint is None:
+            return ("Volume viewing is now in-browser and addressed by embryo + "
+                    "timepoint. Please specify embryo_id (and optionally timepoint) "
+                    "rather than a raw file path.")
+
+    if not embryo_id:
+        return "Error: Specify embryo_id (and optionally timepoint)."
+
+    # Resolve the timepoint (specific or latest) and confirm the volume exists.
+    if timepoint is not None:
+        volume_path = agent.store.get_volume_path(session_id, embryo_id, timepoint)
+        if not volume_path or not Path(volume_path).exists():
             volumes = agent.store.list_volumes(session_id, embryo_id)
-            if not volumes:
+            available = sorted(v['timepoint'] for v in volumes)
+            if not available:
                 return f"No volumes found for {embryo_id} in session {session_id}"
-
-            # Find highest timepoint
-            latest = max(volumes, key=lambda v: v['timepoint'])
-            latest_tp = latest['timepoint']
-            volume_path = agent.store.get_volume_path(session_id, embryo_id, latest_tp)
-
-            title = f"{embryo_id} - t{latest_tp:04d}"
-
+            return f"Timepoint {timepoint} not found for {embryo_id}. Available: {available}"
     else:
-        return "Error: Specify either embryo_id or file_path"
+        volumes = agent.store.list_volumes(session_id, embryo_id)
+        if not volumes:
+            return f"No volumes found for {embryo_id} in session {session_id}"
+        timepoint = max(v['timepoint'] for v in volumes)
+
+    # Drive the in-browser viewer \u2014 no blocking Qt/desktop window.
+    viz = getattr(agent, "viz_server", None)
+    if viz is None:
+        return (f"Resolved {embryo_id} t{timepoint:04d}, but the web UI isn't running, "
+                f"so there's nowhere to display it. Start the web UI and try again.")
 
-    # Load the volume
     try:
-        volume = tifffile.imread(str(volume_path))
-        logger.info("Loaded volume: %s, dtype=%s", volume.shape, volume.dtype)
+        n_clients = await viz.open_volume_in_browser(embryo_id, timepoint)
     except Exception as e:
-        return f"Error loading volume: {e}"
-
-    # Open in napari
-    logger.info("Opening napari viewer...")
-    viewer = napari.Viewer(title=title)
-
-    # Add volume with appropriate settings
-    viewer.add_image(
-        volume,
-        name='Volume',
-        colormap='gray',
-        rendering='mip',  # Maximum intensity projection for 3D
-    )
-
-    # Add scale bar info
-    viewer.scale_bar.visible = True
-    viewer.scale_bar.unit = "um"
-
-    napari.run()
-
-    return f"\u2713 Opened volume in napari: {volume_path.name} (shape: {volume.shape})"
+        logger.exception("open_volume_in_browser failed")
+        return f"Error opening volume in the web viewer: {e}"
+
+    url = f"http://localhost:{getattr(viz, 'port', 8080)}/"
+    if n_clients <= 0:
+        return (f"Resolved {embryo_id} t{timepoint:04d}, but no browser is connected. "
+                f"Open {url} and select that embryo/timepoint to view it.")
+    return (f"\u2713 Opening {embryo_id} t{timepoint:04d} in the web volume viewer "
+            f"({n_clients} view(s) connected) \u2014 {url}")
 
 
 @tool(
diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index 4561b0f5..4ac10f90 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -1364,6 +1364,34 @@ def get_commands_json(self) -> list:
             })
         return commands
 
+    def get_tools_json(self) -> list:
+        """Serialize the agent tool registry for client-side autocomplete.
+
+        Trimmed on purpose (first description line + lightweight param list) so
+        the connect frame stays small. The web chat uses this for @tool-name
+        completion and to show a tool's arguments inline.
+        """
+        try:
+            from gently.harness.tools.registry import get_tool_registry
+            registry = get_tool_registry()
+        except Exception:
+            return []
+        tools = []
+        for t in registry.list_all():
+            desc = (t.description or "").strip().split("\n", 1)[0][:200]
+            category = getattr(t.category, "name", None) or str(t.category)
+            tools.append({
+                "name": t.name,
+                "description": desc,
+                "category": category,
+                "params": [
+                    {"name": p.name, "type": p.type, "required": bool(p.required)}
+                    for p in t.parameters if p.name != "context"
+                ],
+            })
+        tools.sort(key=lambda x: x["name"])
+        return tools
+
     # ------------------------------------------------------------------
     # Private helpers for structured command data
     # ------------------------------------------------------------------
@@ -1430,6 +1458,7 @@ def get_connect_metadata(self) -> dict:
         meta = {
             "session_id": self.agent.session_id,
             "commands": self.get_commands_json(),
+            "tools": self.get_tools_json(),
             "version": getattr(gently, "__version__", "dev"),
             "tokens": self._get_token_snapshot(),
             "embryo_count": len(exp.embryos),
diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 765d16b2..e5de53d9 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -604,6 +604,8 @@ def stream_and_collect():
                         'tool_label': tool_label_fn(block.name, block.input),
                     }
 
+                    is_error_flag = False
+                    result_text = ""
                     try:
                         tool_result = await self._execute_single_tool(block.name, block.input)
 
@@ -620,24 +622,39 @@ def stream_and_collect():
                             except (json.JSONDecodeError, TypeError):
                                 pass
 
+                        result_text = tool_result if isinstance(tool_result, str) else str(tool_result)
                         tool_results.append({
                             "type": "tool_result",
                             "tool_use_id": block.id,
                             "content": tool_result
                         })
                     except Exception as e:
+                        is_error_flag = True
+                        result_text = f"Error: {str(e)}"
                         tool_results.append({
                             "type": "tool_result",
                             "tool_use_id": block.id,
-                            "content": f"Error: {str(e)}",
+                            "content": result_text,
                             "is_error": True
                         })
 
+                    # First non-empty line of the result, trimmed — gives the chat
+                    # UI a one-line summary so the operator can see what a tool did
+                    # (or didn't do), not just that it ran.
+                    result_summary = next(
+                        (ln.strip() for ln in (result_text or "").splitlines() if ln.strip()),
+                        "",
+                    )
+                    if len(result_summary) > 140:
+                        result_summary = result_summary[:139] + "…"
+
                     yield {
                         'type': 'tool_call',
                         'tool_name': block.name,
                         'tool_input': block.input,
                         'duration': time.time() - start_time,
+                        'result_summary': result_summary,
+                        'is_error': is_error_flag,
                     }
 
             self.conversation_history.append({
diff --git a/gently/harness/prompts/manager.py b/gently/harness/prompts/manager.py
index 23cb9291..2d2f6f42 100644
--- a/gently/harness/prompts/manager.py
+++ b/gently/harness/prompts/manager.py
@@ -152,6 +152,7 @@ def get_tools_for_mode(self, mode: str, has_microscope: bool) -> list:
                 "search_literature", "search_strains",
                 "validate_plan",
                 "batch_update_status", "batch_update_spec",
+                "snapshot_plan", "list_plan_versions", "restore_plan_version",
                 "save_plan_template", "list_templates", "apply_template",
                 "ask_user_choice",
             }
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index fc584cbc..58cfbd65 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -201,11 +201,15 @@ def _resolve_volume_path(self, embryo_id: str, timepoint: int) -> Optional[str]:
             if path:
                 return path
 
-        # 2. Try FileStore (file-based, persistent)
-        if self.gently_store and self.timelapse_tracker.session_id:
+        # 2. Try FileStore (file-based, persistent). Key on the LIVE agent
+        # session, not the tracker's (which goes stale after a resume with no
+        # active timelapse) — mirrors _resolve_projection_path so an agent-driven
+        # open_volume hand-off doesn't 404 after a /resume.
+        sid = self._current_session_id()
+        if self.gently_store and sid:
             try:
                 vol_path = self.gently_store.get_volume_path(
-                    self.timelapse_tracker.session_id, embryo_id, timepoint,
+                    sid, embryo_id, timepoint,
                 )
                 if vol_path and vol_path.exists():
                     return str(vol_path)
@@ -682,6 +686,30 @@ async def push_volume_3d(
 
         logger.info(f"Pushed 3D volume {uid} ({volume.shape}) to {len(self.manager.active_connections)} clients")
 
+    async def open_volume_in_browser(
+        self,
+        embryo_id: str,
+        timepoint: int,
+        view: str = "3d_viewer",
+    ) -> int:
+        """Ask every connected browser to open the in-browser volume viewer.
+
+        This is the web-native replacement for the old napari ``view_volume``:
+        the agent triggers the existing ProjectionViewer (WebGL raymarcher +
+        projections) instead of launching a desktop Qt window that would block
+        the shared agent/web event loop. Returns the number of clients notified.
+        """
+        await self.manager.broadcast({
+            "type": "open_volume",
+            "embryo_id": embryo_id,
+            "timepoint": timepoint,
+            "view": view,
+        })
+        n = len(self.manager.active_connections)
+        logger.info("Requested browser open_volume for %s t%s (%d client(s))",
+                    embryo_id, timepoint, n)
+        return n
+
     async def on_start(self):
         """Start the visualization server"""
         # Set the event loop on the event bus so async handlers work
diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index 3fa05eb5..777582b2 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -170,6 +170,14 @@
 .ac-tool-name { color: var(--text); }
 .ac-tool-meta { color: var(--text-muted); }
 .ac-tool-check { color: var(--accent-green); }
+
+/* Multi-line tool rows: head (icon + name + meta) over args / summary. */
+.ac-tool { flex-direction: column; align-items: stretch; gap: 4px; }
+.ac-tool-head { display: flex; align-items: center; gap: 8px; }
+.ac-tool-args { color: var(--text-muted); padding-left: 19px; word-break: break-word; }
+.ac-tool-summary { color: var(--text-muted); padding-left: 19px; word-break: break-word; }
+.ac-tool-summary-err, .ac-tool-warn { color: var(--accent-orange, #fb923c); }
+.ac-tool-err { border-color: rgba(251, 146, 60, 0.35); }
 .ac-tool-spin {
     width: 11px; height: 11px; border-radius: 50%;
     border: 1.6px solid var(--border);
@@ -234,6 +242,36 @@
     display: flex; gap: 8px;
     padding: 12px;
     border-top: 1px solid var(--border);
+    position: relative;   /* anchor for the autocomplete dropdown */
+}
+
+/* ── Autocomplete dropdown ──────────────────────────────── */
+.ac-complete {
+    position: absolute;
+    left: 12px; right: 12px; bottom: calc(100% + 4px);
+    max-height: 240px; overflow-y: auto;
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 9px;
+    box-shadow: 0 -8px 28px rgba(0, 0, 0, 0.45);
+    padding: 4px;
+    z-index: 5;
+}
+.ac-complete.hidden { display: none; }
+.ac-complete-item {
+    display: flex; flex-direction: column; gap: 1px;
+    padding: 6px 9px; border-radius: 6px;
+    cursor: pointer;
+}
+.ac-complete-item.active,
+.ac-complete-item:hover { background: var(--bg-hover, rgba(127, 127, 127, 0.12)); }
+.ac-complete-name {
+    font-family: 'JetBrains Mono', ui-monospace, monospace;
+    font-size: 12.5px; color: var(--accent);
+}
+.ac-complete-desc {
+    font-size: 11.5px; color: var(--text-muted);
+    white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
 }
 .agent-chat-input textarea {
     flex: 1 1 auto; resize: none;
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 577d18bd..3b10d8be 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -22,8 +22,16 @@ const AgentChat = (() => {
     let activityEl = null;        // the persistent "working…" indicator (reused)
     let me = null;                // { authenticated, username, role, can_control }
 
+    // Autocomplete: slash-command + @tool registries (pushed by the server on
+    // connect) and the live dropdown state.
+    let commands = [];            // [{name, description, aliases, ...}]
+    let tools = [];               // [{name, description, params, ...}]
+    let acItems = [];             // current completion items shown in the dropdown
+    let acIdx = -1;               // highlighted item index
+
     // DOM refs (resolved in init)
     let fab, panel, log, input, sendBtn, conn, banner, closeBtn, userEl, signoutBtn;
+    let acComplete = null;        // the autocomplete dropdown element
 
     // ── Safe rendering ────────────────────────────────────────
     function escapeHtml(s) {
@@ -138,6 +146,11 @@ const AgentChat = (() => {
             case 'connected':
                 reconnectDelay = 1000;
                 setConn(true, msg.version ? `Connected · v${msg.version}` : 'Connected');
+                // The bridge ships the command + tool registries on connect.
+                // Capture them so the composer can offer autocomplete — the
+                // data was always on the wire; we just never used it.
+                commands = Array.isArray(msg.commands) ? msg.commands : [];
+                tools = Array.isArray(msg.tools) ? msg.tools : [];
                 break;
 
             case 'control_status':
@@ -182,10 +195,14 @@ const AgentChat = (() => {
                 hideActivity();           // the running tool row is the signal now
                 currentAgentEl = null;    // text after a tool starts a fresh bubble
                 const label = msg.tool_label || msg.tool_name || 'tool';
+                const args = fmtArgs(msg.tool_input);
                 const el = document.createElement('div');
                 el.className = 'ac-tool ac-tool-running';
                 el.dataset.tool = msg.tool_name || '';
-                el.innerHTML = `<span class="ac-tool-spin"></span><span class="ac-tool-name">${escapeHtml(label)}</span>`;
+                el.innerHTML =
+                    `<div class="ac-tool-head"><span class="ac-tool-spin"></span>` +
+                    `<span class="ac-tool-name">${escapeHtml(label)}</span></div>` +
+                    (args ? `<div class="ac-tool-args">${escapeHtml(args)}</div>` : '');
                 log.appendChild(el);
                 scrollToBottom();
                 break;
@@ -198,10 +215,29 @@ const AgentChat = (() => {
                 const label = msg.tool_name || 'tool';
                 const dur = msg.duration
                     ? ` · ${(msg.duration.toFixed ? msg.duration.toFixed(1) : msg.duration)}s` : '';
-                const summary = msg.result_summary ? ` — ${escapeHtml(msg.result_summary)}` : '';
+                const args = fmtArgs(msg.tool_input);
+                const summary = msg.result_summary || '';
+                // Show ⚠ instead of ✓ when the tool errored or its result reads
+                // like a failure — so the operator can tell when a tool did nothing.
+                const isErr = !!msg.is_error || looksLikeError(summary);
+                const icon = isErr
+                    ? `<span class="ac-tool-warn">⚠</span>`
+                    : `<span class="ac-tool-check">✓</span>`;
+                const html =
+                    `<div class="ac-tool-head">${icon}` +
+                    `<span class="ac-tool-name">${escapeHtml(label)}</span>` +
+                    `<span class="ac-tool-meta">${dur}</span></div>` +
+                    (args ? `<div class="ac-tool-args">${escapeHtml(args)}</div>` : '') +
+                    (summary ? `<div class="ac-tool-summary${isErr ? ' ac-tool-summary-err' : ''}">${escapeHtml(summary)}</div>` : '');
                 if (el) {
-                    el.className = 'ac-tool ac-tool-done';
-                    el.innerHTML = `<span class="ac-tool-check">✓</span><span class="ac-tool-name">${escapeHtml(label)}</span><span class="ac-tool-meta">${dur}${summary}</span>`;
+                    el.className = 'ac-tool ac-tool-done' + (isErr ? ' ac-tool-err' : '');
+                    el.innerHTML = html;
+                } else {
+                    // No matching running row (e.g. after a reconnect) — append fresh.
+                    const fresh = document.createElement('div');
+                    fresh.className = 'ac-tool ac-tool-done' + (isErr ? ' ac-tool-err' : '');
+                    fresh.innerHTML = html;
+                    log.appendChild(fresh);
                 }
                 if (streaming) setActivity('Working…');  // agent continues after the tool
                 scrollToBottom();
@@ -296,6 +332,118 @@ const AgentChat = (() => {
         scrollToBottom();
     }
 
+    // ── Tool argument formatting ──────────────────────────────
+    /** Compact, escaped "key=value" rendering of a tool's input for the chat. */
+    function fmtArgs(input) {
+        if (!input || typeof input !== 'object') return '';
+        const parts = [];
+        for (const [k, v] of Object.entries(input)) {
+            if (k === 'context' || v === null || v === undefined || v === '') continue;
+            let val = (typeof v === 'object') ? JSON.stringify(v) : String(v);
+            if (val.length > 48) val = val.slice(0, 47) + '…';
+            parts.push(`${k}=${val}`);
+        }
+        return parts.join('  ');
+    }
+
+    /** Heuristic: does a tool's result summary read like a failure?
+     *  Used to show ⚠ for tools that return an error STRING (the agent only
+     *  flags raised exceptions). Avoids false alarms like "No errors found". */
+    function looksLikeError(s) {
+        if (!s) return false;
+        const t = s.trim();
+        if (/^no\s+(errors?|issues?|problems?|anomal|changes?|warnings?)\b/i.test(t)) return false;
+        if (/^(error|failed|failure|unable|cannot|can'?t|could\s?n'?t|could not|denied|invalid|no |not )/i.test(t)) return true;
+        // mid-string failure markers, e.g. "Timepoint 7 not found for embryo_2".
+        return /\bnot (found|available|connected|recognized|valid|supported)\b/i.test(t);
+    }
+
+    // ── Autocomplete ──────────────────────────────────────────
+    /** The whitespace-delimited token immediately left of the caret. */
+    function currentToken() {
+        const v = input.value;
+        const pos = (input.selectionStart != null) ? input.selectionStart : v.length;
+        const before = v.slice(0, pos);
+        const m = before.match(/(\S+)$/);
+        return { token: m ? m[1] : '', start: m ? pos - m[1].length : pos, pos };
+    }
+
+    /** Compute completion items for the current input/caret, or []. */
+    function computeCompletions() {
+        const trimmed = input.value.trimStart().toLowerCase();
+        // Slash commands: whole-input prefix (mirrors the TUI). A trailing space
+        // (i.e. typing args) naturally yields no matches and hides the menu.
+        if (trimmed.startsWith('/')) {
+            return commands.filter(c =>
+                (c.name && c.name.toLowerCase().startsWith(trimmed)) ||
+                (c.aliases || []).some(a => String(a).toLowerCase().startsWith(trimmed))
+            ).slice(0, 8).map(c => ({ kind: 'command', name: c.name, desc: c.description || '' }));
+        }
+        // @tool mention: complete the token under the caret against tool names.
+        const tok = currentToken();
+        if (tok.token.startsWith('@') && tools.length) {
+            const q = tok.token.slice(1).toLowerCase();
+            return tools.filter(t => t.name.toLowerCase().includes(q))
+                .slice(0, 8)
+                .map(t => ({ kind: 'tool', name: t.name, desc: t.description || '', token: tok }));
+        }
+        return [];
+    }
+
+    function renderCompletions(items) {
+        acItems = items || [];
+        acIdx = acItems.length ? 0 : -1;
+        if (!acComplete) return;
+        if (!acItems.length) { hideCompletions(); return; }
+        acComplete.innerHTML = '';
+        acItems.forEach((it, i) => {
+            const row = document.createElement('div');
+            row.className = 'ac-complete-item' + (i === acIdx ? ' active' : '');
+            row.innerHTML =
+                `<span class="ac-complete-name">${escapeHtml(it.name)}</span>` +
+                (it.desc ? `<span class="ac-complete-desc">${escapeHtml(it.desc)}</span>` : '');
+            // mousedown (not click) so it fires before the textarea blurs.
+            row.addEventListener('mousedown', (e) => { e.preventDefault(); acceptCompletion(it); });
+            acComplete.appendChild(row);
+        });
+        acComplete.classList.remove('hidden');
+    }
+
+    function hideCompletions() {
+        acItems = [];
+        acIdx = -1;
+        if (acComplete) { acComplete.classList.add('hidden'); acComplete.innerHTML = ''; }
+    }
+
+    function updateCompletions() {
+        renderCompletions(computeCompletions());
+    }
+
+    function moveCompletion(delta) {
+        if (!acItems.length || !acComplete) return;
+        acIdx = (acIdx + delta + acItems.length) % acItems.length;
+        [...acComplete.children].forEach((c, i) => c.classList.toggle('active', i === acIdx));
+    }
+
+    function acceptCompletion(item) {
+        if (!item) return;
+        if (item.kind === 'command') {
+            input.value = item.name + ' ';
+            const p = input.value.length;
+            try { input.setSelectionRange(p, p); } catch (_) {}
+        } else if (item.kind === 'tool') {
+            const tok = item.token || currentToken();
+            const v = input.value;
+            const insert = '@' + item.name + ' ';
+            input.value = v.slice(0, tok.start) + insert + v.slice(tok.pos);
+            const p = tok.start + insert.length;
+            try { input.setSelectionRange(p, p); } catch (_) {}
+        }
+        hideCompletions();
+        input.focus();
+        autosize();
+    }
+
     // ── Control / UI state ────────────────────────────────────
     function renderControl() {
         if (hasControl) {
@@ -303,7 +451,7 @@ const AgentChat = (() => {
             banner.innerHTML = '';
             input.disabled = false;
             sendBtn.disabled = false;
-            input.placeholder = 'Message Gently…';
+            input.placeholder = 'Message Gently…   ( / commands · @ tools )';
         } else {
             banner.classList.remove('hidden');
             const who = holderLabel || 'another session';
@@ -374,6 +522,7 @@ const AgentChat = (() => {
     // ── Input handling ────────────────────────────────────────
     function submit() {
         if (streaming) { send({ type: 'cancel' }); return; }  // Send doubles as Stop
+        hideCompletions();
         const text = input.value.trim();
         if (!text) return;
         if (!hasControl) { renderControl(); return; }
@@ -456,9 +605,29 @@ const AgentChat = (() => {
             window.location.reload();
         });
         fetchMe();
+
+        // Build the autocomplete dropdown inside the composer (positioned above
+        // the textarea via CSS).
+        const inputWrap = input.parentNode;
+        if (inputWrap) {
+            acComplete = document.createElement('div');
+            acComplete.className = 'ac-complete hidden';
+            inputWrap.insertBefore(acComplete, inputWrap.firstChild);
+        }
+
         sendBtn.addEventListener('click', submit);
-        input.addEventListener('input', autosize);
+        input.addEventListener('input', () => { autosize(); updateCompletions(); });
+        // Close the menu shortly after blur (delay lets a mousedown selection land).
+        input.addEventListener('blur', () => setTimeout(hideCompletions, 120));
         input.addEventListener('keydown', (e) => {
+            // While the completion menu is open it owns the navigation keys.
+            if (acItems.length) {
+                if (e.key === 'ArrowDown') { e.preventDefault(); moveCompletion(1); return; }
+                if (e.key === 'ArrowUp') { e.preventDefault(); moveCompletion(-1); return; }
+                if (e.key === 'Tab') { e.preventDefault(); acceptCompletion(acItems[acIdx]); return; }
+                if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); acceptCompletion(acItems[acIdx]); return; }
+                if (e.key === 'Escape') { e.preventDefault(); hideCompletions(); return; }
+            }
             if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); submit(); }
             if (e.key === 'Escape' && streaming) { e.preventDefault(); send({ type: 'cancel' }); }
         });
diff --git a/gently/ui/web/static/js/projection-viewer.js b/gently/ui/web/static/js/projection-viewer.js
index 1f5f530e..7360f2d6 100644
--- a/gently/ui/web/static/js/projection-viewer.js
+++ b/gently/ui/web/static/js/projection-viewer.js
@@ -118,6 +118,10 @@ const ProjectionViewer = {
         this.projections = [];
         this.selectedMethod = null;
         this.isOpen = true;
+        // Clear any volume from a previous open so a failed /api/volume-raw fetch
+        // can't leave the prior embryo/timepoint's 3D data bound (stale-render).
+        this.volumeData = null;
+        this.volumeShape = null;
 
         const modal = document.getElementById('projection-viewer-modal');
         const loading = document.getElementById('pv-loading');
@@ -280,6 +284,10 @@ const ProjectionViewer = {
     },
 
     selectMethod(method) {
+        // If the 3D view is requested but no volume loaded (e.g. /api/volume-raw
+        // failed while projections succeeded), fall back to the projections grid
+        // rather than showing an empty, never-initialized 3D panel.
+        if (method === '3d_viewer' && !this.volumeData) method = null;
         this.selectedMethod = method;
         this.renderProjections();
         this.renderTabs();
diff --git a/gently/ui/web/static/js/websocket.js b/gently/ui/web/static/js/websocket.js
index 1e3a534c..069724a2 100644
--- a/gently/ui/web/static/js/websocket.js
+++ b/gently/ui/web/static/js/websocket.js
@@ -127,6 +127,20 @@ function handleMessage(msg) {
             // Switch to embryos tab if not already there
             if (state.tab !== 'embryos') switchTab('embryos');
         }
+    } else if (msg.type === 'open_volume') {
+        // The agent asked us to open the in-browser volume viewer — the
+        // web-native replacement for the old desktop napari window.
+        if (typeof ProjectionViewer !== 'undefined' && msg.embryo_id != null) {
+            const view = msg.view || '3d_viewer';
+            Promise.resolve(ProjectionViewer.open(msg.embryo_id, msg.timepoint))
+                .then(() => {
+                    // Default to the 3D viewer tab when the agent opens it.
+                    if (view && typeof ProjectionViewer.selectMethod === 'function') {
+                        ProjectionViewer.selectMethod(view);
+                    }
+                })
+                .catch((e) => console.warn('open_volume failed', e));
+        }
     } else if (msg.type === 'session_changed') {
         // The live agent switched sessions (resume from the Sessions tab) —
         // reload so every client picks up the new session's state + transcript.

From c5009acf497e8624b9820fa278bda3113ca166cd Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 17:42:01 -0400
Subject: [PATCH 054/314] Integrate the agent with perception: pull tool,
 prompt context, event bridge, wake-router

Closes the gap where perception ran as a fire-and-forget tool the agent
never saw. agent.perceiver is the same Perceiver the orchestrator drives, so
all reads are direct and side-effect-free.

B1 (read-only):
- get_recent_perceptions tool returns live per-embryo stage / stability /
  arrest / trajectory + the perceiver's reasoning.
- A deterministic '## Perception (live)' section is injected into the system
  prompt (build_perception_snapshot), bypassing the AI context-summary cache so
  stage data is never stale.

B2 (bridge + unify):
- The perception path's DETECTOR_EVALUATED now mirrors into EmbryoState
  (latest_developmental_stage) on stage CHANGE only; role=test pseudo-stages,
  recheck-skips, and the 'no_object' sentinel are filtered out. This fixes the
  long-standing dead wiring (the agent subscribed to STAGE_DETECTED, which the
  perception loop never emits).
- get_stage_history / predict_hatching now read the live Perceiver (hatching
  time computed from gently_perception's own organism stage durations),
  falling back to the DevelopmentalTracker.

B3 (decision-moment wake-router, opt-in / default OFF):
- gently/app/wake_router.py wakes the agent on stage transitions + critical
  events (hatching / arrest / embryo-terminated / errors), coalesced and
  throttled (critical bypasses the throttle); deferred events are re-armed, not
  dropped. Enabled via the set_autonomy tool. Full autonomy on a wake; device
  limits still bound it.
- A new agent turn-lock serializes wake turns against user turns on the shared
  conversation history; run_wake_turn drives the normal streaming pipeline.

Review fixes (adversarial pass):
- bridge.stream_response now closes the agent generator in a finally, so the
  turn-lock always releases on cancel/error (was: stalled the next turn).
- wake-router evaluates its guards before draining _pending so co-pending
  critical events survive an in-flight turn.
- 'no_object' no longer mirrors as a developmental stage or triggers a wake;
  autonomous turns log when they auto-cancel an interactive picker.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/agent.py                 | 155 +++++++++++++++---
 gently/app/tools/analysis_tools.py  |  88 ++++++++++-
 gently/app/tools/timelapse_tools.py | 128 ++++++++++++++-
 gently/app/wake_router.py           | 235 ++++++++++++++++++++++++++++
 gently/harness/bridge.py            |  10 ++
 gently/harness/prompts/manager.py   |   3 +-
 gently/harness/prompts/templates.py |  55 +++++++
 7 files changed, 646 insertions(+), 28 deletions(-)
 create mode 100644 gently/app/wake_router.py

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 01c7371d..4d83b4b9 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -143,6 +143,10 @@ def __init__(
         self.on_message_callback: Optional[Callable] = None
         self.choice_handler: Optional[Callable] = None
 
+        # Serializes conversation turns: user turns and autonomous wake turns
+        # must not interleave on the shared conversation_history.
+        self._turn_lock = asyncio.Lock()
+
         # Interaction logger for structured logging (research data collection)
         self.interaction_logger: Optional[InteractionLogger] = None
 
@@ -241,6 +245,16 @@ def __init__(
         # Subscribe to CV result events for EmbryoState integration
         self._subscribe_to_cv_events()
 
+        # Decision-moment wake-router (opt-in, default OFF). Wakes the agent on
+        # wake-worthy perception/lifecycle events so it can adapt acquisition
+        # autonomously; enabled via the set_autonomy tool.
+        try:
+            from gently.app.wake_router import WakeRouter
+            self.wake_router = WakeRouter(self, self._event_bus)
+        except Exception:
+            logger.exception("Failed to init wake-router")
+            self.wake_router = None
+
         # Build initial system prompt
         self._update_system_prompt()
 
@@ -420,7 +434,8 @@ def exit_plan_mode(self) -> str:
     def _update_system_prompt(self, context_summary: str = None):
         """Rebuild system prompt via PromptManager."""
         self.system_prompt = self.prompts.update_system_prompt(
-            self.experiment, self.client, self.mode, context_summary
+            self.experiment, self.client, self.mode, context_summary,
+            perceiver=getattr(self, "perceiver", None),
         )
 
     def _get_active_plan_summary(self) -> Optional[str]:
@@ -637,6 +652,45 @@ def on_stage_detected(event):
             unsub = self._event_bus.subscribe(EventType.STAGE_DETECTED, on_stage_detected)
             self._cv_subscriptions.append(unsub)
 
+            def on_perception(event):
+                # Bridge the perception loop's DETECTOR_EVALUATED into EmbryoState so
+                # the prompt/display developmental stage reflects the live Perceiver.
+                # (The STAGE_DETECTED wiring above is never emitted by the perception
+                # path — this closes that long-standing gap.) Record only on an
+                # actual stage CHANGE to keep cv_analyses a clean transition log and
+                # avoid per-timepoint disk/cache churn; live stability/timing is read
+                # straight from the Perceiver by the prompt snapshot + pull tool.
+                try:
+                    data = event.data
+                    if data.get("skipped") or data.get("detector_name") != "perception":
+                        return  # ignore recheck-skips and role=test pseudo-stages
+                    embryo_id = data.get("embryo_id")
+                    stage = data.get("stage")
+                    # 'no_object' is an empty-field sentinel, not a developmental
+                    # stage — don't mirror it into latest_developmental_stage.
+                    if (not stage or stage == "no_object" or not embryo_id
+                            or embryo_id not in self.experiment.embryos):
+                        return
+                    embryo = self.experiment.embryos[embryo_id]
+                    if stage == getattr(embryo, "latest_developmental_stage", None):
+                        return  # steady state — nothing new to mirror
+                    embryo.add_cv_result("stage_classification", {
+                        "stage": stage,
+                        "timepoint": data.get("timepoint"),
+                        "stability": data.get("stability"),
+                        "temporal_analysis": data.get("temporal_analysis"),
+                        "detector_name": "perception",
+                    })
+                    self.invalidate_context_cache()
+                    self._auto_save()
+                    logger.info("Perception: %s -> stage %s (t%s)",
+                                embryo_id, stage, data.get("timepoint"))
+                except Exception as e:
+                    logger.warning(f"Error handling perception event: {e}")
+
+            unsub = self._event_bus.subscribe(EventType.DETECTOR_EVALUATED, on_perception)
+            self._cv_subscriptions.append(unsub)
+
             logger.debug("Subscribed to CV result events")
 
         except Exception as e:
@@ -877,35 +931,86 @@ async def handle_message_stream(self, user_message: str):
             yield {'type': 'text', 'text': quick_response}
             return
 
-        context_summary = await self.prompts.get_cached_context_summary(
-            self.experiment, self.timelapse_orchestrator, self.timeline_manager
-        )
-        self._update_system_prompt(context_summary)
+        # Hold the turn-lock for the whole streamed turn so an autonomous wake
+        # turn cannot interleave on the shared conversation_history.
+        lock = getattr(self, "_turn_lock", None)
+        acquired = False
+        if lock is not None:
+            await lock.acquire()
+            acquired = True
+        try:
+            context_summary = await self.prompts.get_cached_context_summary(
+                self.experiment, self.timelapse_orchestrator, self.timeline_manager
+            )
+            self._update_system_prompt(context_summary)
 
-        self.conversation.conversation_history.append({
-            "role": "user",
-            "content": user_message
-        })
+            self.conversation.conversation_history.append({
+                "role": "user",
+                "content": user_message
+            })
 
-        tools = self._get_tools_for_mode()
-        cached_prompt = self._get_cached_system_prompt()
+            tools = self._get_tools_for_mode()
+            cached_prompt = self._get_cached_system_prompt()
 
-        inner_gen = self.conversation.call_claude_stream(
-            cached_prompt, tools,
-            tool_label_fn=self.conversation.tool_label,
-            auto_save_fn=self._auto_save,
-        )
-        sent_value = None
+            inner_gen = self.conversation.call_claude_stream(
+                cached_prompt, tools,
+                tool_label_fn=self.conversation.tool_label,
+                auto_save_fn=self._auto_save,
+            )
+            sent_value = None
 
+            try:
+                while True:
+                    if sent_value is None:
+                        chunk = await inner_gen.__anext__()
+                    else:
+                        chunk = await inner_gen.asend(sent_value)
+                    sent_value = yield chunk
+            except StopAsyncIteration:
+                return
+        finally:
+            if acquired:
+                lock.release()
+
+    async def run_wake_turn(self, wake_note: str):
+        """Drive one autonomous (no-user) turn for the wake-router.
+
+        Runs through the normal streaming pipeline (so it acquires the turn-lock
+        and is recorded to conversation history / auto-saved). Surfaces text via
+        on_message_callback if a UI wired one; always runs so the decision and
+        any tool actions are persisted even with no client attached. Only acts in
+        run mode.
+        """
+        if self.mode != "run":
+            logger.info("Wake turn skipped — agent not in run mode (mode=%s)", self.mode)
+            return ""
+        text_parts = []
         try:
-            while True:
-                if sent_value is None:
-                    chunk = await inner_gen.__anext__()
-                else:
-                    chunk = await inner_gen.asend(sent_value)
-                sent_value = yield chunk
-        except StopAsyncIteration:
-            return
+            async for chunk in self.handle_message_stream(wake_note):
+                if isinstance(chunk, dict) and chunk.get("type") == "text":
+                    text_parts.append(chunk.get("text", ""))
+                elif isinstance(chunk, dict) and chunk.get("type") == "choice_request":
+                    # A plain async-for resumes the generator with None, which the
+                    # picker resolves as 'cancelled'. Make that visible — there is
+                    # no operator to answer during an autonomous turn.
+                    cd = chunk.get("choice_data", {})
+                    logger.warning(
+                        "Wake turn invoked an interactive picker (%s); auto-cancelling "
+                        "— no operator present.", cd.get("question", "?"))
+                cb = getattr(self, "on_message_callback", None)
+                if cb is not None:
+                    try:
+                        res = cb(chunk)
+                        if asyncio.iscoroutine(res):
+                            await res
+                    except Exception:
+                        logger.debug("on_message_callback failed for wake chunk", exc_info=True)
+        except Exception:
+            logger.exception("run_wake_turn error")
+        summary = "".join(text_parts).strip()
+        if summary:
+            logger.info("Autonomous wake turn result: %s", summary[:500])
+        return summary
 
     async def get_tool_call(self, user_message: str) -> Optional[Dict]:
         """Dry-run tool call (for benchmarking)."""
diff --git a/gently/app/tools/analysis_tools.py b/gently/app/tools/analysis_tools.py
index 75422e77..ff813ad3 100644
--- a/gently/app/tools/analysis_tools.py
+++ b/gently/app/tools/analysis_tools.py
@@ -6,7 +6,7 @@
 
 from typing import Dict, Optional
 
-from gently.harness.tools.registry import tool, ToolCategory
+from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import require_agent, get_embryo_or_error
 
 
@@ -43,6 +43,92 @@ async def analyze_volume(
         return f"Error analyzing volume: {str(e)}"
 
 
+@tool(
+    name="get_recent_perceptions",
+    description="""Get the latest perception state for one embryo or all embryos:
+current developmental stage, how many consecutive observations it has held that stage
+(stability), a possible-arrest signal, the recent stage trajectory, and the
+perceiver's reasoning. Source: the LIVE perception loop (reads accumulated state,
+does not trigger a fresh capture).
+Use when the user asks "what stage is embryo X", "is anything stuck/arrested",
+"how are the embryos developing", or before deciding whether to adapt acquisition.""",
+    category=ToolCategory.ANALYSIS,
+    examples=[
+        ToolExample("What stage is embryo_1 at?", {"embryo_id": "embryo_1"}),
+        ToolExample("How is everything developing?", {}),
+        ToolExample("Is anything arrested?", {}),
+    ],
+)
+def get_recent_perceptions(
+    embryo_id: Optional[str] = None,
+    n: int = 5,
+    context: Dict = None,
+) -> str:
+    """Read live per-embryo perception state from the perception sessions.
+
+    All reads here (get_session / summary / attribute access) are synchronous and
+    side-effect-free — they never trigger a VLM call.
+    """
+    agent, err = require_agent(context)
+    if err:
+        return err
+
+    perceiver = getattr(agent, "perceiver", None)
+    if perceiver is None:
+        return "Perception system not available."
+
+    def _one(eid: str) -> str:
+        try:
+            session = perceiver.get_session(eid)
+        except Exception as e:
+            return f"{eid}: perception read failed ({e})"
+        if session is None or not getattr(session, "current_stage", None):
+            return f"{eid}: no perceptions recorded yet"
+        summary = session.summary()
+        lines = [
+            f"{eid}: stage={summary.get('current_stage')} "
+            f"(stable for {summary.get('stability', 0)} obs, "
+            f"{summary.get('observation_count', 0)} total)"
+        ]
+        seq = summary.get("stage_sequence") or []
+        if seq:
+            lines.append(f"  trajectory: {' -> '.join(seq)}")
+        temporal = summary.get("temporal")  # TemporalContext dataclass or None
+        if temporal is not None:
+            tmin = getattr(temporal, "time_in_stage_min", 0.0)
+            exp = getattr(temporal, "expected_duration_min", None)
+            seg = f"  time in stage: {tmin:.0f} min"
+            if exp:
+                seg += (f" (expected ~{exp:.0f} min, "
+                        f"{getattr(temporal, 'overtime_ratio', 0.0):.1f}x)")
+            lines.append(seg)
+            if getattr(temporal, "is_potentially_arrested", False):
+                lines.append("  ** potentially ARRESTED **")
+        observations = getattr(session, "observations", None) or []
+        if observations and n > 0:
+            recent = observations[-n:]
+            lines.append(f"  recent observations (last {len(recent)}):")
+            for o in recent:
+                reason = (getattr(o, "reasoning", "") or "").strip().replace("\n", " ")
+                if len(reason) > 160:
+                    reason = reason[:159] + "…"
+                lines.append(f"    t{getattr(o, 'timepoint', '?')}: "
+                             f"{getattr(o, 'stage', '?')} - {reason}")
+        return "\n".join(lines)
+
+    if embryo_id:
+        return _one(embryo_id)
+
+    embryos = getattr(agent.experiment, "embryos", {}) or {}
+    if not embryos:
+        return "No embryos in the experiment."
+    out = ["Perception state (all embryos):", ""]
+    for eid in sorted(embryos):
+        out.append(_one(eid))
+        out.append("")
+    return "\n".join(out).rstrip()
+
+
 @tool(
     name="get_detection_summary",
     description="Get summary of all detections across all embryos",
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index 2e01fa60..62b846f5 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -6,7 +6,7 @@
 
 from typing import Dict, List, Optional
 
-from gently.harness.tools.registry import tool, ToolCategory
+from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import (
     require_agent, get_embryo_or_error,
     require_timelapse_orchestrator, require_developmental_tracker
@@ -535,6 +535,32 @@ def get_stage_history(
     if err:
         return err
 
+    # Prefer the live perception session (the orchestrator's Perceiver, which the
+    # agent shares). The DevelopmentalTracker below is only populated by manual
+    # classify_embryo_stage calls, so it is usually empty in autonomous runs.
+    perceiver = getattr(agent, "perceiver", None)
+    session = perceiver.get_session(embryo_id) if perceiver else None
+    if session is not None and getattr(session, "current_stage", None):
+        s = session.summary()
+        lines = [
+            f"Stage progression for {embryo_id} (live perception):",
+            f"  Current stage: {s.get('current_stage')} (stable for {s.get('stability', 0)} obs)",
+            f"  Observations: {s.get('observation_count', 0)}",
+        ]
+        seq = s.get("stage_sequence") or []
+        if seq:
+            lines.append(f"  Trajectory: {' -> '.join(seq)}")
+        t = s.get("temporal")  # TemporalContext dataclass or None
+        if t is not None:
+            exp = getattr(t, "expected_duration_min", None)
+            seg = f"  Time in current stage: {getattr(t, 'time_in_stage_min', 0.0):.0f} min"
+            if exp:
+                seg += f" (expected ~{exp:.0f} min)"
+            lines.append(seg)
+            if getattr(t, "is_potentially_arrested", False):
+                lines.append("  ** potentially ARRESTED **")
+        return "\n".join(lines)
+
     tracker, err = require_developmental_tracker(agent)
     if err:
         return err
@@ -558,6 +584,42 @@ def get_stage_history(
     return "\n".join(lines)
 
 
+def _perceiver_hatching_estimate(session) -> Optional[float]:
+    """Estimate minutes until the 'hatching' stage from the perception session.
+
+    Uses gently_perception's own organism stage ordering + typical durations, so
+    no DevelopmentalStage enum mapping is needed. Returns None when unknown
+    (no_object / off-vocabulary stage), 0.0 when already hatching/hatched.
+    """
+    try:
+        from gently_perception.organism import CELEGANS
+    except Exception:
+        return None
+    stage = getattr(session, "current_stage", None)
+    if not stage or stage == "no_object":
+        return None
+    stages = list(CELEGANS.stages)
+    durations = dict(CELEGANS.stage_durations)
+    if stage in ("hatching", "hatched"):
+        return 0.0
+    if stage not in stages or "hatching" not in stages:
+        return None
+    idx = stages.index(stage)
+    target = stages.index("hatching")
+    if idx >= target:
+        return 0.0
+    # Remaining time in the current stage (expected minus already-elapsed).
+    elapsed = 0.0
+    t = session.summary().get("temporal")
+    if t is not None:
+        elapsed = getattr(t, "time_in_stage_min", 0.0) or 0.0
+    remaining = max(0.0, durations.get(stage, 0.0) - elapsed)
+    # Plus the full expected duration of each stage between current and hatching.
+    for s in stages[idx + 1:target]:
+        remaining += durations.get(s, 0.0)
+    return remaining
+
+
 @tool(
     name="predict_hatching",
     description="Predict time-to-hatching for an embryo with confidence intervals based on developmental stage",
@@ -573,6 +635,39 @@ def predict_hatching(
     if err:
         return err
 
+    # Prefer the live perception session; the DevelopmentalTracker is usually
+    # empty in autonomous runs (only manual classify_embryo_stage feeds it).
+    perceiver = getattr(agent, "perceiver", None)
+
+    def _perc_line(eid: str):
+        session = perceiver.get_session(eid) if perceiver else None
+        if session is None or not getattr(session, "current_stage", None):
+            return None
+        stage = session.current_stage
+        if stage in ("hatching", "hatched"):
+            return f"  {eid}: stage={stage} (hatching now / already hatched)"
+        est = _perceiver_hatching_estimate(session)
+        if est is None:
+            return f"  {eid}: stage={stage} (time-to-hatching unknown)"
+        return f"  {eid}: stage={stage}, ~{est / 60:.1f}h to hatching ({est:.0f} min)"
+
+    if perceiver is not None:
+        if all_embryos:
+            ids = list(agent.experiment.embryos.keys())
+            perc = [_perc_line(e) for e in ids]
+            if any(perc):
+                out = ["Hatching predictions (live perception):", ""]
+                out += [p for p in perc if p]
+                missing = [e for e, p in zip(ids, perc) if not p]
+                if missing:
+                    out.append("")
+                    out.append(f"(no perception yet for: {', '.join(missing)})")
+                return "\n".join(out)
+        elif embryo_id:
+            line = _perc_line(embryo_id)
+            if line:
+                return f"Hatching prediction for {embryo_id} (live perception):\n{line}"
+
     tracker, err = require_developmental_tracker(agent)
     if err:
         return err
@@ -629,6 +724,37 @@ def predict_hatching(
         return "\n".join(lines)
 
 
+@tool(
+    name="set_autonomy",
+    description="""Enable or disable autonomous mode (the decision-moment wake-router).
+When ON, the agent wakes itself between user messages on important perception events
+(developmental stage transitions, potential arrest, hatching, embryo termination, or
+errors) and may adjust acquisition on its own (interval, power, stop conditions,
+bursts). Default is OFF. Device-layer safety limits still bound any action.
+Use when the user says "enable autopilot", "watch and adapt on your own", "go
+autonomous", or "turn off autonomy".""",
+    category=ToolCategory.ANALYSIS,
+    examples=[
+        ToolExample("Enable autonomous mode", {"enabled": True}),
+        ToolExample("Turn off autopilot", {"enabled": False}),
+    ],
+)
+def set_autonomy(enabled: bool = True, context: Dict = None) -> str:
+    """Toggle the decision-moment wake-router."""
+    agent, err = require_agent(context)
+    if err:
+        return err
+    router = getattr(agent, "wake_router", None)
+    if router is None:
+        return "Autonomy is not available (wake-router failed to initialize)."
+    state = router.set_enabled(enabled)
+    if state:
+        return ("Autonomous mode ENABLED. I'll wake on stage transitions, potential "
+                "arrest, hatching, termination, and errors — and adapt acquisition as "
+                "needed. Say 'turn off autonomy' to stop.")
+    return "Autonomous mode disabled. I'll only act when you message me."
+
+
 # ---------------------------------------------------------------------------
 # Reactive monitoring modes (Phase 5) — high-level "install canonical
 # detector → cadence + power reactive rules" entry points. Without one of
diff --git a/gently/app/wake_router.py b/gently/app/wake_router.py
new file mode 100644
index 00000000..344e9d71
--- /dev/null
+++ b/gently/app/wake_router.py
@@ -0,0 +1,235 @@
+"""Decision-moment wake-router for autonomous agent turns.
+
+Subscribes to wake-worthy perception/lifecycle events and, when enabled, wakes
+the conversational agent between user messages so it can re-decide acquisition
+(cadence, power, stop conditions) in response to what perception sees — the
+closed loop.
+
+Design (opt-in, default OFF):
+  * Triggers: critical events (hatching / arrest / embryo-terminated / errors)
+    plus developmental stage transitions. No periodic heartbeat.
+  * Debounce: a burst of events inside COALESCE_WINDOW collapses into ONE wake.
+  * Throttle: non-critical wakes are rate-limited by MIN_WAKE_INTERVAL; critical
+    events bypass the throttle.
+  * Serialization: the wake turn runs through the agent's normal streaming
+    pipeline, which holds the agent turn-lock, so it never races a user turn.
+    A wake therefore waits for any in-progress user turn — including an open
+    choice picker — to finish before it runs; "critical bypasses the throttle"
+    means it skips MIN_WAKE_INTERVAL, not that it preempts an active user turn
+    (preempting would interleave on the shared conversation history).
+
+Nothing fires until ``set_enabled(True)`` (e.g. via the set_autonomy tool).
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+
+from gently.core.event_bus import EventType
+
+logger = logging.getLogger(__name__)
+
+# Tunables (seconds).
+COALESCE_WINDOW = 20.0     # collapse a burst of events into one wake
+MIN_WAKE_INTERVAL = 120.0  # throttle non-critical wakes
+
+# Events that always wake immediately (bypass MIN_WAKE_INTERVAL).
+CRITICAL_EVENTS = frozenset({
+    EventType.HATCHING_DETECTED,
+    EventType.EMBRYO_TERMINATED,
+    EventType.ERROR_OCCURRED,
+    EventType.ACQUISITION_FAILED,
+    EventType.ANOMALY_DETECTED,
+})
+# Non-critical events we also inspect (filtered for real transitions / arrest).
+WATCH_EVENTS = frozenset({EventType.DETECTOR_EVALUATED})
+
+
+class WakeRouter:
+    """Routes wake-worthy events into coalesced, throttled autonomous agent turns."""
+
+    def __init__(self, agent, bus):
+        self.agent = agent
+        self.bus = bus
+        self.enabled = False
+        self._loop = None
+        self._pending = []          # list[(EventType, dict)]
+        self._flush_handle = None   # TimerHandle for the coalesce window
+        self._last_wake = 0.0       # loop.time() of the last fired wake
+        self._last_stage = {}       # embryo_id -> last stage seen (transition detection)
+        self._in_flight = False
+        self._unsubs = []
+        self._subscribe()
+
+    # -- public control -------------------------------------------------
+    def set_enabled(self, enabled: bool) -> bool:
+        self.enabled = bool(enabled)
+        if not self.enabled:
+            self._cancel_flush()
+            self._pending.clear()
+        logger.info("Wake-router %s", "ENABLED" if self.enabled else "disabled")
+        return self.enabled
+
+    def is_enabled(self) -> bool:
+        return self.enabled
+
+    def shutdown(self):
+        self._cancel_flush()
+        for unsub in self._unsubs:
+            try:
+                unsub()
+            except Exception:
+                pass
+        self._unsubs.clear()
+
+    # -- subscription ---------------------------------------------------
+    def _subscribe(self):
+        for et in (CRITICAL_EVENTS | WATCH_EVENTS):
+            try:
+                self._unsubs.append(
+                    self.bus.subscribe(et, lambda e, _et=et: self._on_event(_et, e))
+                )
+            except Exception:
+                logger.exception("wake-router failed to subscribe %s", et)
+
+    # -- event intake ---------------------------------------------------
+    def _on_event(self, event_type, event):
+        # Synchronous handler (the bus calls it inline). Cheap-filter, then
+        # schedule a coalesced flush on the running loop. Never raise — the bus
+        # swallows handler exceptions, so failures would otherwise vanish.
+        try:
+            if not self.enabled:
+                return
+            if self._loop is None:
+                try:
+                    self._loop = asyncio.get_running_loop()
+                except RuntimeError:
+                    return  # no running loop -> can't schedule a wake; drop
+            data = getattr(event, "data", None) or {}
+            if not self._is_wake_worthy(event_type, data):
+                return
+            self._pending.append((event_type, data))
+            self._schedule_flush(critical=event_type in CRITICAL_EVENTS)
+        except Exception:
+            logger.exception("wake-router _on_event error")
+
+    def _is_wake_worthy(self, event_type, data) -> bool:
+        if event_type in CRITICAL_EVENTS:
+            return True
+        if event_type == EventType.DETECTOR_EVALUATED:
+            if data.get("skipped"):
+                return False
+            if data.get("detector_name") != "perception":
+                return False  # role=test pseudo-stages are not developmental
+            stage = data.get("stage")
+            if not stage or stage == "no_object":
+                return False  # empty-field sentinel — not a developmental change
+            ta = data.get("temporal_analysis") or {}
+            if ta.get("is_potentially_arrested"):
+                return True
+            eid = data.get("embryo_id")
+            last = self._last_stage.get(eid)
+            self._last_stage[eid] = stage
+            return stage != last  # only a real transition wakes
+        return False
+
+    # -- coalescing / flush --------------------------------------------
+    def _schedule_flush(self, critical: bool):
+        loop = self._loop
+        if loop is None:
+            return
+        delay = 0.0 if critical else COALESCE_WINDOW
+        if self._flush_handle is None:
+            self._flush_handle = loop.call_later(delay, self._fire_flush)
+        elif critical:
+            # bring a pending window-flush forward
+            self._flush_handle.cancel()
+            self._flush_handle = loop.call_later(0.0, self._fire_flush)
+
+    def _cancel_flush(self):
+        if self._flush_handle is not None:
+            try:
+                self._flush_handle.cancel()
+            except Exception:
+                pass
+            self._flush_handle = None
+
+    def _fire_flush(self):
+        self._flush_handle = None
+        loop = self._loop
+        if loop is not None:
+            asyncio.ensure_future(self._flush(), loop=loop)
+
+    async def _flush(self):
+        if not self._pending or not self.enabled:
+            self._pending.clear()
+            return
+        # Evaluate the guards BEFORE draining so a deferral can't lose events.
+        critical = any(et in CRITICAL_EVENTS for et, _ in self._pending)
+        now = self._loop.time() if self._loop else 0.0
+        if self._in_flight or (not critical and (now - self._last_wake) < MIN_WAKE_INTERVAL):
+            # A wake is already running, or we're inside the non-critical throttle
+            # window. Keep _pending intact and re-arm so these events — including
+            # any CRITICAL ones — are retried once the turn finishes / window
+            # elapses, rather than being dropped.
+            logger.debug("wake deferred (in_flight=%s critical=%s)", self._in_flight, critical)
+            # Retry on the coalesce window (not delay 0) so a critical event
+            # deferred behind an in-flight turn doesn't busy-spin call_later(0).
+            self._schedule_flush(critical=False)
+            return
+        events = self._pending
+        self._pending = []
+        self._in_flight = True
+        self._last_wake = now
+        try:
+            note = self._build_wake_note(events)
+            logger.info("Wake-router firing autonomous turn (%d event(s))", len(events))
+            await self.agent.run_wake_turn(note)
+        except Exception:
+            logger.exception("wake turn failed")
+        finally:
+            self._in_flight = False
+
+    # -- wake package ---------------------------------------------------
+    def _build_wake_note(self, events) -> str:
+        from gently.harness.prompts.templates import build_perception_snapshot
+        triggers = []
+        for et, data in events:
+            name = getattr(et, "name", str(et))
+            eid = data.get("embryo_id", "?")
+            stage = data.get("stage")
+            if et == EventType.HATCHING_DETECTED:
+                triggers.append(f"{eid}: hatching detected")
+            elif et == EventType.EMBRYO_TERMINATED:
+                triggers.append(f"{eid}: terminated ({data.get('completion_reason', '?')})")
+            elif et in (EventType.ERROR_OCCURRED, EventType.ACQUISITION_FAILED,
+                        EventType.ANOMALY_DETECTED):
+                triggers.append(f"{eid}: {name.lower().replace('_', ' ')}")
+            elif et == EventType.DETECTOR_EVALUATED:
+                ta = data.get("temporal_analysis") or {}
+                if ta.get("is_potentially_arrested"):
+                    triggers.append(f"{eid}: potential arrest at stage {stage}")
+                else:
+                    triggers.append(f"{eid}: stage -> {stage}")
+            else:
+                triggers.append(f"{eid}: {name.lower()}")
+        triggers = list(dict.fromkeys(triggers))  # dedupe, preserve order
+
+        try:
+            snap = build_perception_snapshot(
+                getattr(self.agent, "perceiver", None),
+                getattr(getattr(self.agent, "experiment", None), "embryos", {}) or {},
+            )
+        except Exception:
+            snap = ""
+        snap = snap or "(no live perception data)"
+
+        return (
+            "[AUTONOMOUS WAKE] Something changed while no one was typing — decide if "
+            "any acquisition change is warranted.\n\n"
+            f"What triggered this: {'; '.join(triggers)}\n\n"
+            f"{snap}\n\n"
+            "If a change helps (adjust interval/power, add a stop condition, queue a "
+            "burst, or stop an embryo), do it now using your tools. If nothing needs "
+            "doing, say so briefly and take no action."
+        )
diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index 4ac10f90..028ce2d7 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -623,6 +623,16 @@ async def stream_response(
         except Exception as e:
             logger.error(f"Stream error: {e}", exc_info=True)
             await send_fn({"type": "error", "error": str(e)})
+        finally:
+            # Deterministically close the agent generator so its turn-lock (and
+            # any other resources) release immediately. Without this, a cancelled
+            # or aborted stream leaves the generator suspended at a `yield` still
+            # holding self._turn_lock until non-deterministic GC, stalling the
+            # next user turn and any autonomous wake turn on lock.acquire().
+            try:
+                await stream_iter.aclose()
+            except Exception:
+                pass
 
     async def handle_command(
         self,
diff --git a/gently/harness/prompts/manager.py b/gently/harness/prompts/manager.py
index 2d2f6f42..cde5db44 100644
--- a/gently/harness/prompts/manager.py
+++ b/gently/harness/prompts/manager.py
@@ -47,7 +47,7 @@ def __init__(self, claude_client, model):
         self.memory = None  # AgentMemory instance
 
     def update_system_prompt(self, experiment, client, mode: str,
-                             context_summary: str = None) -> str:
+                             context_summary: str = None, perceiver=None) -> str:
         """
         Rebuild system prompt with current experiment state and connection status.
 
@@ -96,6 +96,7 @@ def update_system_prompt(self, experiment, client, mode: str,
             experiment, connection_status, context_summary,
             memory_awareness=memory_awareness,
             microscope=client,
+            perceiver=perceiver,
         )
 
     def get_tools_for_mode(self, mode: str, has_microscope: bool) -> list:
diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index 55894c22..a2f7634f 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -290,12 +290,57 @@
 """
 
 
+def build_perception_snapshot(perceiver, embryos) -> str:
+    """One compact line per embryo of live perception state for the system prompt.
+
+    Reads straight from the perception sessions (current stage, stability, time in
+    stage, arrest signal, short trajectory). Every read here is synchronous and
+    side-effect-free — it never triggers a VLM call. Returns '' when there is
+    nothing to show, so callers can drop the section entirely.
+    """
+    if not perceiver or not embryos:
+        return ""
+    lines = []
+    for embryo_id in sorted(embryos):
+        try:
+            session = perceiver.get_session(embryo_id)
+            summary = session.summary() if session is not None else None
+        except Exception:
+            summary = None
+        if not summary or not summary.get("current_stage"):
+            lines.append(f"- {embryo_id}: no perception yet")
+            continue
+        parts = [
+            f"stage={summary['current_stage']}",
+            f"stable={summary.get('stability', 0)}x",
+        ]
+        temporal = summary.get("temporal")  # TemporalContext dataclass or None
+        if temporal is not None:
+            tmin = getattr(temporal, "time_in_stage_min", None)
+            exp = getattr(temporal, "expected_duration_min", None)
+            if tmin is not None:
+                seg = f"in_stage={tmin:.0f}min"
+                if exp:
+                    seg += f"/{exp:.0f}"
+                parts.append(seg)
+            if getattr(temporal, "is_potentially_arrested", False):
+                parts.append("ARRESTED?")
+        seq = summary.get("stage_sequence") or []
+        if len(seq) > 1:
+            parts.append("traj=" + "->".join(seq[-4:]))
+        lines.append(f"- {embryo_id}: " + "  ".join(parts))
+    if not lines:
+        return ""
+    return "## Perception (live)\n\n" + "\n".join(lines)
+
+
 def build_system_prompt(
     experiment_state: ExperimentState,
     connection_status: dict = None,
     context_summary: str = None,
     memory_awareness: str = None,
     microscope=None,
+    perceiver=None,
 ) -> str:
     """
     Build complete system prompt for Claude
@@ -357,6 +402,15 @@ def build_system_prompt(
     else:
         context_section = ""
 
+    # Live per-embryo perception snapshot (deterministic, read straight from the
+    # perception sessions — bypasses the AI context-summary cache so stage data is
+    # never stale).
+    perception_section = ""
+    if perceiver is not None and experiment_state.embryos:
+        snap = build_perception_snapshot(perceiver, experiment_state.embryos)
+        if snap:
+            perception_section = f"\n{snap}\n"
+
     # Pull organism-specific content from the active organism module
     organism = get_organism()
     organism_display = organism.ORGANISM_DISPLAY_NAME
@@ -404,6 +458,7 @@ def build_system_prompt(
 # Current Experiment State
 
 {embryo_summary}
+{perception_section}
 {context_section}
 # Tool Use Guidelines
 

From c4bfac2d57fbe03744358831ec5916baa338b53e Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 19:13:57 -0400
Subject: [PATCH 055/314] Live acquisition control, observable + permissioned
 autonomy, and a refreshed prompt
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Builds on the perception integration: gives the agent real live control over
acquisition, makes its autonomous decisions visible and gated, fixes message
interleaving, and updates the long-stale system prompt.

Live control (A/B):
- modify_timelapse_interval (whole run) + set_embryo_cadence (one embryo) change
  cadence on a running timelapse and correctly re-anchor next_due_at (closes the
  gap where no working live-interval tool existed). set_embryo_cadence reports a
  no-op instead of a misleading reschedule message.
- set_photodose_budget (caps cumulative exposure; resumes budget-paused embryos
  on a raise, only when they're back under the cap) + get_photodose_status.
- (snap-mode hardware plumbing deferred — needs real-hardware validation.)

Observability (C):
- Autonomous wake turns now stream to every web chat client and persist to the
  transcript, rendered distinctly: a 'Gently woke up — <trigger>' banner + a
  'Gently · autonomous' bubble. bridge.register_display_broadcaster wires the
  previously-dead on_message_callback; run_wake_turn brackets the turn with
  autonomous_start/stream_end. Previously autonomous turns were invisible.

Interleaving (D):
- Typing while the agent is busy now QUEUES (with per-message remove + clear-all
  + auto-drain on idle) instead of cancelling; a separate Stop button replaces
  Send-as-Stop; the composer shows 'working' vs 'acting autonomously'. Slash
  commands no longer wedge the composer busy.

Autonomy modes (E):
- OFF / ASK / AUTO tri-state via set_autonomy, switchable mid-run. ASK proposes a
  change and waits for Approve/Modify/Skip in the chat (round-tripped through the
  wake choice channel, bounded by a timeout->Skip, lock released via aclose).
  Hybrid backstop: a few irreversible tools (set_laser_power, remove_embryo,
  stop_timelapse) can never run during an autonomous turn, enforced in the
  registry regardless of mode.

System prompt (F):
- Replaced the fictional cv_analyze 'CV subagent' block with an accurate
  Perception & Analysis section; added an Adapting-Acquisition (gentleness-first)
  + Autonomy (OFF/ASK/AUTO) section; removed the nonexistent enable_preset_detector
  reference and the stale interval tool name.

Review fixes: turn-lock released on disconnect-cancel (CancelledError handled as
'cancelled'); picker futures discarded on timeout/cancel; deferred critical wakes
re-fire promptly after a turn; Escape-cancel + the autonomous history flag reset
cleanly.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/agent.py                     | 124 +++++++++---
 gently/app/tools/timelapse_tools.py     | 238 ++++++++++++++++++++++--
 gently/app/wake_router.py               |  68 +++++--
 gently/harness/bridge.py                |  42 +++++
 gently/harness/prompts/templates.py     | 150 ++++++++-------
 gently/harness/tools/registry.py        |  14 ++
 gently/ui/web/routes/agent_ws.py        |  29 ++-
 gently/ui/web/static/css/agent-chat.css |  69 ++++++-
 gently/ui/web/static/js/agent-chat.js   | 158 ++++++++++++++--
 9 files changed, 752 insertions(+), 140 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 4d83b4b9..9b144f92 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -147,6 +147,17 @@ def __init__(
         # must not interleave on the shared conversation_history.
         self._turn_lock = asyncio.Lock()
 
+        # Autonomy backstop: while a wake turn runs, _autonomous_active is True
+        # and the registry refuses these irreversible tools (they require a
+        # human). User turns are unaffected. _wake_choice_factory is set by the
+        # web bridge so ASK-mode wake turns can round-trip an approval picker.
+        self._autonomous_active = False
+        self._autonomous_blocked_tools = frozenset({
+            "set_laser_power", "remove_embryo", "stop_timelapse",
+        })
+        self._wake_choice_factory = None
+        self._wake_choice_discard = None
+
         # Interaction logger for structured logging (research data collection)
         self.interaction_logger: Optional[InteractionLogger] = None
 
@@ -972,46 +983,113 @@ async def handle_message_stream(self, user_message: str):
             if acquired:
                 lock.release()
 
-    async def run_wake_turn(self, wake_note: str):
+    async def run_wake_turn(self, wake_note: str, trigger: str = None, interactive: bool = False):
         """Drive one autonomous (no-user) turn for the wake-router.
 
         Runs through the normal streaming pipeline (so it acquires the turn-lock
-        and is recorded to conversation history / auto-saved). Surfaces text via
-        on_message_callback if a UI wired one; always runs so the decision and
-        any tool actions are persisted even with no client attached. Only acts in
-        run mode.
+        and is recorded to conversation history / auto-saved). Brackets the turn
+        with an 'autonomous_start' (carrying the wake trigger) and a synthesized
+        'stream_end' so it streams to the web chat distinctly. Sets
+        _autonomous_active so the registry backstop refuses irreversible tools.
+        When interactive (ASK mode) a choice_request round-trips through the
+        operator; otherwise it is auto-cancelled. Run mode only.
         """
         if self.mode != "run":
             logger.info("Wake turn skipped — agent not in run mode (mode=%s)", self.mode)
             return ""
+
+        async def _emit(chunk):
+            cb = getattr(self, "on_message_callback", None)
+            if cb is None:
+                return
+            try:
+                res = cb(chunk)
+                if asyncio.iscoroutine(res):
+                    await res
+            except Exception:
+                logger.debug("on_message_callback failed for wake chunk", exc_info=True)
+
+        await _emit({"type": "autonomous_start", "trigger": trigger or ""})
         text_parts = []
+        self._autonomous_active = True
+        agen = self.handle_message_stream(wake_note)
+        sent_value = None
         try:
-            async for chunk in self.handle_message_stream(wake_note):
-                if isinstance(chunk, dict) and chunk.get("type") == "text":
+            while True:
+                try:
+                    if sent_value is None:
+                        chunk = await agen.__anext__()
+                    else:
+                        chunk = await agen.asend(sent_value)
+                        sent_value = None
+                except StopAsyncIteration:
+                    break
+                ctype = chunk.get("type") if isinstance(chunk, dict) else None
+                if ctype == "text":
                     text_parts.append(chunk.get("text", ""))
-                elif isinstance(chunk, dict) and chunk.get("type") == "choice_request":
-                    # A plain async-for resumes the generator with None, which the
-                    # picker resolves as 'cancelled'. Make that visible — there is
-                    # no operator to answer during an autonomous turn.
-                    cd = chunk.get("choice_data", {})
-                    logger.warning(
-                        "Wake turn invoked an interactive picker (%s); auto-cancelling "
-                        "— no operator present.", cd.get("question", "?"))
-                cb = getattr(self, "on_message_callback", None)
-                if cb is not None:
-                    try:
-                        res = cb(chunk)
-                        if asyncio.iscoroutine(res):
-                            await res
-                    except Exception:
-                        logger.debug("on_message_callback failed for wake chunk", exc_info=True)
+                if ctype == "choice_request":
+                    # Resolve via the operator (ASK) or auto-cancel (AUTO).
+                    sent_value = await self._resolve_wake_choice(chunk, _emit, interactive)
+                    continue  # don't re-emit the raw choice_request
+                await _emit(chunk)
         except Exception:
             logger.exception("run_wake_turn error")
+        finally:
+            self._autonomous_active = False
+            try:
+                # Release the turn-lock even if a picker hung / timed out.
+                await agen.aclose()
+            except Exception:
+                pass
+            await _emit({"type": "stream_end"})
         summary = "".join(text_parts).strip()
         if summary:
             logger.info("Autonomous wake turn result: %s", summary[:500])
         return summary
 
+    async def _resolve_wake_choice(self, chunk, emit, interactive):
+        """Resolve a choice_request raised during a wake turn.
+
+        AUTO (or no operator channel) -> 'cancelled'. ASK -> register a future via
+        the web choice-factory, broadcast the picker to clients, and await the
+        operator's selection (timeout -> 'skip' so an unanswered picker can't hold
+        the turn-lock forever)."""
+        choice_data = chunk.get("choice_data", {}) if isinstance(chunk, dict) else {}
+        factory = getattr(self, "_wake_choice_factory", None)
+        if not interactive or factory is None:
+            logger.info("Wake picker auto-cancelled (interactive=%s, channel=%s)",
+                        interactive, factory is not None)
+            return "cancelled"
+        try:
+            future = factory(choice_data)  # registers future + sets request_id
+        except Exception:
+            logger.exception("wake choice factory failed")
+            return "cancelled"
+        request_id = choice_data.get("request_id", "")
+        await emit({**chunk, "origin": "wake", "request_id": request_id})
+        from gently.app.wake_router import ASK_TIMEOUT_SEC
+        try:
+            selected = await asyncio.wait_for(future, timeout=ASK_TIMEOUT_SEC)
+        except asyncio.TimeoutError:
+            logger.info("Wake ASK timed out (%.0fs) -> skip", ASK_TIMEOUT_SEC)
+            selected = "skip"
+        except asyncio.CancelledError:
+            # The picker future was cancelled (e.g. the operator disconnected) —
+            # treat as a cancelled proposal so the turn finishes cleanly.
+            logger.info("Wake ASK future cancelled -> cancelled")
+            selected = "cancelled"
+        except Exception:
+            selected = "cancelled"
+        finally:
+            # Don't leak the future in the router-scoped registry on timeout/cancel.
+            discard = getattr(self, "_wake_choice_discard", None)
+            if discard is not None and request_id:
+                try:
+                    discard(request_id)
+                except Exception:
+                    pass
+        return selected or "skip"
+
     async def get_tool_call(self, user_message: str) -> Optional[Dict]:
         """Dry-run tool call (for benchmarking)."""
         context_summary = await self.prompts.get_cached_context_summary(
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index 62b846f5..316913a8 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -726,33 +726,237 @@ def _perc_line(eid: str):
 
 @tool(
     name="set_autonomy",
-    description="""Enable or disable autonomous mode (the decision-moment wake-router).
-When ON, the agent wakes itself between user messages on important perception events
-(developmental stage transitions, potential arrest, hatching, embryo termination, or
-errors) and may adjust acquisition on its own (interval, power, stop conditions,
-bursts). Default is OFF. Device-layer safety limits still bound any action.
-Use when the user says "enable autopilot", "watch and adapt on your own", "go
-autonomous", or "turn off autonomy".""",
+    description="""Set the autonomy mode of the decision-moment wake-router (default OFF).
+Modes:
+  'off'  — never act on its own; only respond to your messages.
+  'ask'  — on a notable event (stage transition, arrest, hatching, termination,
+           errors) the agent PROPOSES a change and waits for you to Approve /
+           Modify / Skip in the chat before acting.
+  'auto' — the agent adapts acquisition on its own (still bounded by device
+           limits; a few irreversible actions always require your confirmation).
+You can switch modes mid-run. Use when the user says "enable autopilot/autonomous",
+"ask me before changing things", "go fully autonomous", or "turn off autonomy".""",
     category=ToolCategory.ANALYSIS,
     examples=[
-        ToolExample("Enable autonomous mode", {"enabled": True}),
-        ToolExample("Turn off autopilot", {"enabled": False}),
+        ToolExample("Ask me before adapting", {"mode": "ask"}),
+        ToolExample("Go fully autonomous", {"mode": "auto"}),
+        ToolExample("Turn off autonomy", {"mode": "off"}),
     ],
 )
-def set_autonomy(enabled: bool = True, context: Dict = None) -> str:
-    """Toggle the decision-moment wake-router."""
+def set_autonomy(mode: str = None, enabled: bool = None, context: Dict = None) -> str:
+    """Set the wake-router mode (off/ask/auto). `enabled` kept for back-compat."""
     agent, err = require_agent(context)
     if err:
         return err
     router = getattr(agent, "wake_router", None)
     if router is None:
         return "Autonomy is not available (wake-router failed to initialize)."
-    state = router.set_enabled(enabled)
-    if state:
-        return ("Autonomous mode ENABLED. I'll wake on stage transitions, potential "
-                "arrest, hatching, termination, and errors — and adapt acquisition as "
-                "needed. Say 'turn off autonomy' to stop.")
-    return "Autonomous mode disabled. I'll only act when you message me."
+    if mode is not None:
+        m = str(mode).strip().lower()
+        if m not in ("off", "ask", "auto"):
+            return "mode must be 'off', 'ask', or 'auto'."
+        router.set_mode(m)
+    elif enabled is not None:
+        router.set_enabled(bool(enabled))
+    else:
+        return "Specify mode ('off', 'ask', or 'auto')."
+    cur = router.mode
+    if cur == "auto":
+        return ("Autonomy set to AUTO. I'll wake on stage transitions, arrest, "
+                "hatching, termination, and errors and adapt acquisition on my own "
+                "(irreversible actions still need your okay). Say 'ask mode' or "
+                "'turn off autonomy' to change.")
+    if cur == "ask":
+        return ("Autonomy set to ASK. On a notable event I'll propose a change and "
+                "wait for your Approve / Modify / Skip before doing anything.")
+    return "Autonomy OFF. I'll only act when you message me."
+
+
+# ---------------------------------------------------------------------------
+# Live cadence / dose modulation — direct knobs for a running timelapse.
+# ---------------------------------------------------------------------------
+
+
+@tool(
+    name="modify_timelapse_interval",
+    description="""Change the base acquisition interval for ALL embryos on a running timelapse, effective immediately.
+Re-anchors every embryo's next acquisition to now + the new interval and notifies the UI.
+Lower interval = more frequent imaging = more photodose; raise it to be gentler.
+Use when the user says "image every N minutes/seconds now", "speed up/slow down the whole run".
+For a single embryo use set_embryo_cadence instead.""",
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample("Image every 2 minutes now", {"new_interval_seconds": 120}),
+        ToolExample("Slow everything down to 10 minutes", {"new_interval_seconds": 600}),
+    ],
+)
+def modify_timelapse_interval(new_interval_seconds: float, context: Dict = None) -> str:
+    """Globally re-anchor the timelapse interval (live)."""
+    agent, err = require_agent(context)
+    if err:
+        return err
+    orchestrator, err = require_timelapse_orchestrator(agent)
+    if err:
+        return err
+    return orchestrator.modify_interval(new_interval_seconds)
+
+
+@tool(
+    name="set_embryo_cadence",
+    description="""Change ONE embryo's acquisition cadence on a running timelapse, effective immediately.
+Set new_interval_seconds to re-anchor that embryo's next acquisition to now + interval (lower = more frequent = more dose).
+Set new_phase to 'normal' to resume a paused embryo, or 'paused' to pause it.
+NOTE: re-issuing the SAME interval with the SAME phase is a no-op (it won't re-anchor).
+Use for per-embryo tuning, e.g. speed up the one that's developing fastest.""",
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample("Image embryo_2 every minute", {"embryo_id": "embryo_2", "new_interval_seconds": 60}),
+        ToolExample("Resume embryo_3", {"embryo_id": "embryo_3", "new_phase": "normal"}),
+    ],
+)
+def set_embryo_cadence(
+    embryo_id: str,
+    new_interval_seconds: float = None,
+    new_phase: str = None,
+    context: Dict = None,
+) -> str:
+    """Per-embryo cadence change routed through the re-anchoring path."""
+    agent, err = require_agent(context)
+    if err:
+        return err
+    orchestrator, err = require_timelapse_orchestrator(agent)
+    if err:
+        return err
+    embryo, err = get_embryo_or_error(agent, embryo_id)
+    if err:
+        return err
+    if new_interval_seconds is None and new_phase is None:
+        return "Specify new_interval_seconds and/or new_phase."
+    if new_interval_seconds is not None and new_interval_seconds < 1:
+        return "Interval must be >= 1 second."
+    if new_phase is not None and new_phase not in ("normal", "fast", "burst", "paused"):
+        return "new_phase must be one of: normal, fast, burst, paused."
+    # Detect the no-op (transition_cadence silently does nothing, and would NOT
+    # re-anchor next_due_at, if neither interval nor phase actually changes).
+    cur_interval = getattr(embryo, "interval_seconds", None)
+    cur_phase = getattr(embryo, "cadence_phase", None)
+    interval_change = new_interval_seconds is not None and new_interval_seconds != cur_interval
+    phase_change = new_phase is not None and new_phase != cur_phase
+    if not interval_change and not phase_change:
+        shown = f"{cur_interval:.0f}s" if cur_interval is not None else "default"
+        return f"{embryo.id}: no change (already interval={shown}, phase={cur_phase})."
+    orchestrator.transition_cadence(
+        embryo,
+        new_interval_seconds=new_interval_seconds if interval_change else None,
+        new_phase=new_phase if phase_change else None,
+        reason="agent:set_embryo_cadence",
+    )
+    bits = []
+    if interval_change:
+        bits.append(f"interval={new_interval_seconds:.0f}s")
+    if phase_change:
+        bits.append(f"phase={new_phase}")
+    due = getattr(embryo, "next_due_at", None)
+    tail = f"; next acquisition ~{due.strftime('%H:%M:%S')}" if due else ""
+    return f"{embryo.id}: {', '.join(bits)}{tail}"
+
+
+@tool(
+    name="set_photodose_budget",
+    description="""Set or clear the per-embryo photodose budget (a hard cap on cumulative laser exposure).
+base_dose_budget_ms is the ceiling for a 1x-role (test) embryo; calibration embryos get 10x.
+When an embryo's cumulative exposure exceeds its budget it is auto-PAUSED to protect the sample.
+Pass null/None to DISABLE the cap. Raising the budget also resumes embryos that were paused for the old cap.
+Use to enforce gentleness on precious samples, or to lift the cap when the user okays more dose.""",
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample("Cap each embryo at 5 seconds of light", {"base_dose_budget_ms": 5000}),
+        ToolExample("Remove the photodose cap", {"base_dose_budget_ms": None}),
+    ],
+)
+def set_photodose_budget(
+    base_dose_budget_ms: float = None,
+    resume_paused: bool = True,
+    context: Dict = None,
+) -> str:
+    """Set/clear the photodose budget; optionally resume budget-paused embryos."""
+    agent, err = require_agent(context)
+    if err:
+        return err
+    orchestrator, err = require_timelapse_orchestrator(agent)
+    if err:
+        return err
+    # Capture who was budget-paused BEFORE set_photodose_budget clears the set,
+    # so we only resume embryos paused for the budget (not manual pauses/bursts).
+    prev_exceeded = set(getattr(orchestrator, "_dose_budget_exceeded", set()) or set())
+    msg = orchestrator.set_photodose_budget(base_dose_budget_ms)
+    resumed = []
+    if resume_paused:
+        states = getattr(orchestrator, "_embryo_states", {}) or {}
+        try:
+            from gently.harness.roles import REGISTRY as ROLE_REGISTRY
+        except Exception:
+            ROLE_REGISTRY = {}
+        for eid in prev_exceeded:
+            e = states.get(eid)
+            if e is None or getattr(e, "cadence_phase", None) != "paused":
+                continue
+            # Only resume if the embryo is now UNDER the new budget (or the cap
+            # was disabled); otherwise it would just immediately re-pause.
+            if base_dose_budget_ms is not None:
+                rdef = ROLE_REGISTRY.get(getattr(e, "role", "test")) if hasattr(ROLE_REGISTRY, "get") else None
+                mult = getattr(rdef, "photodose_budget_multiplier", 1.0) if rdef else 1.0
+                if (getattr(e, "total_exposure_ms", 0.0) or 0.0) > base_dose_budget_ms * mult:
+                    continue
+            orchestrator.transition_cadence(e, new_phase="normal", reason="agent:budget change resume")
+            resumed.append(eid)
+    if resumed:
+        msg += f" Resumed: {', '.join(sorted(resumed))}."
+    return msg
+
+
+@tool(
+    name="get_photodose_status",
+    description="""Report each embryo's cumulative light exposure vs its photodose budget, and which are paused over budget.
+Use to reason about gentleness before/after changing the budget, power, or cadence.""",
+    category=ToolCategory.ANALYSIS,
+    examples=[ToolExample("How much light has each embryo gotten?", {})],
+)
+def get_photodose_status(context: Dict = None) -> str:
+    """Read-only photodose / budget status across embryos."""
+    agent, err = require_agent(context)
+    if err:
+        return err
+    orchestrator, err = require_timelapse_orchestrator(agent)
+    if err:
+        return err
+    base = getattr(orchestrator, "_dose_budget_base_ms", None)
+    exceeded = getattr(orchestrator, "_dose_budget_exceeded", set()) or set()
+    states = getattr(orchestrator, "_embryo_states", {}) or {}
+    if base is None:
+        lines = ["Photodose budget: DISABLED (no cap).", ""]
+    else:
+        lines = [f"Photodose budget: {base:.0f} ms base (scaled per role).", ""]
+    try:
+        from gently.harness.roles import REGISTRY as ROLE_REGISTRY
+    except Exception:
+        ROLE_REGISTRY = {}
+    for eid in sorted(states):
+        e = states[eid]
+        used = getattr(e, "total_exposure_ms", 0.0) or 0.0
+        role = getattr(e, "role", "test")
+        if base is not None:
+            rdef = ROLE_REGISTRY.get(role) if hasattr(ROLE_REGISTRY, "get") else None
+            mult = getattr(rdef, "photodose_budget_multiplier", 1.0) if rdef else 1.0
+            cap = base * mult
+            pct = (used / cap * 100.0) if cap else 0.0
+            flag = "  [PAUSED: over budget]" if eid in exceeded else ""
+            lines.append(f"  {eid} ({role}): {used:.0f}/{cap:.0f} ms ({pct:.0f}%){flag}")
+        else:
+            lines.append(f"  {eid} ({role}): {used:.0f} ms used")
+    if len(lines) == 2:
+        lines.append("  (no embryos)")
+    return "\n".join(lines)
 
 
 # ---------------------------------------------------------------------------
diff --git a/gently/app/wake_router.py b/gently/app/wake_router.py
index 344e9d71..71faa7ce 100644
--- a/gently/app/wake_router.py
+++ b/gently/app/wake_router.py
@@ -32,6 +32,7 @@
 # Tunables (seconds).
 COALESCE_WINDOW = 20.0     # collapse a burst of events into one wake
 MIN_WAKE_INTERVAL = 120.0  # throttle non-critical wakes
+ASK_TIMEOUT_SEC = 300.0    # ASK mode: how long to wait for operator approval -> Skip
 
 # Events that always wake immediately (bypass MIN_WAKE_INTERVAL).
 CRITICAL_EVENTS = frozenset({
@@ -51,7 +52,7 @@ class WakeRouter:
     def __init__(self, agent, bus):
         self.agent = agent
         self.bus = bus
-        self.enabled = False
+        self.mode = "off"          # 'off' | 'ask' | 'auto'
         self._loop = None
         self._pending = []          # list[(EventType, dict)]
         self._flush_handle = None   # TimerHandle for the coalesce window
@@ -62,12 +63,24 @@ def __init__(self, agent, bus):
         self._subscribe()
 
     # -- public control -------------------------------------------------
-    def set_enabled(self, enabled: bool) -> bool:
-        self.enabled = bool(enabled)
-        if not self.enabled:
+    @property
+    def enabled(self) -> bool:
+        return self.mode != "off"
+
+    def set_mode(self, mode: str) -> str:
+        mode = (mode or "off").strip().lower()
+        if mode not in ("off", "ask", "auto"):
+            mode = "off"
+        self.mode = mode
+        if mode == "off":
             self._cancel_flush()
             self._pending.clear()
-        logger.info("Wake-router %s", "ENABLED" if self.enabled else "disabled")
+        logger.info("Wake-router mode -> %s", mode.upper())
+        return self.mode
+
+    def set_enabled(self, enabled: bool) -> bool:
+        """Back-compat boolean toggle: maps to AUTO / OFF."""
+        self.set_mode("auto" if enabled else "off")
         return self.enabled
 
     def is_enabled(self) -> bool:
@@ -182,16 +195,28 @@ async def _flush(self):
         self._in_flight = True
         self._last_wake = now
         try:
-            note = self._build_wake_note(events)
-            logger.info("Wake-router firing autonomous turn (%d event(s))", len(events))
-            await self.agent.run_wake_turn(note)
+            ask = (self.mode == "ask")
+            note, trigger = self._build_wake_note(events, ask=ask)
+            logger.info("Wake-router firing %s turn (%d event(s)): %s",
+                        self.mode.upper(), len(events), trigger)
+            await self.agent.run_wake_turn(note, trigger=trigger, interactive=ask)
         except Exception:
             logger.exception("wake turn failed")
         finally:
             self._in_flight = False
+            # Events that arrived while we were busy (including deferred CRITICAL
+            # ones) are still in _pending — re-fire promptly rather than waiting
+            # out another coalesce window. _in_flight is now False so this flush
+            # will proceed instead of deferring (no busy-spin).
+            if self._pending and self.enabled:
+                self._schedule_flush(
+                    critical=any(et in CRITICAL_EVENTS for et, _ in self._pending))
 
     # -- wake package ---------------------------------------------------
-    def _build_wake_note(self, events) -> str:
+    def _build_wake_note(self, events, ask=False):
+        """Return (note, trigger_str). The note is the agent-facing wake prompt;
+        trigger_str is the short human-readable reason shown in the chat banner.
+        When ask=True the note instructs propose-then-confirm instead of acting."""
         from gently.harness.prompts.templates import build_perception_snapshot
         triggers = []
         for et, data in events:
@@ -223,13 +248,24 @@ def _build_wake_note(self, events) -> str:
         except Exception:
             snap = ""
         snap = snap or "(no live perception data)"
+        trigger_str = "; ".join(triggers)
 
-        return (
-            "[AUTONOMOUS WAKE] Something changed while no one was typing — decide if "
-            "any acquisition change is warranted.\n\n"
-            f"What triggered this: {'; '.join(triggers)}\n\n"
+        head = (
+            "[AUTONOMOUS WAKE] Something changed while no one was typing.\n\n"
+            f"What triggered this: {trigger_str}\n\n"
             f"{snap}\n\n"
-            "If a change helps (adjust interval/power, add a stop condition, queue a "
-            "burst, or stop an embryo), do it now using your tools. If nothing needs "
-            "doing, say so briefly and take no action."
         )
+        if ask:
+            tail = (
+                "Decide whether any acquisition change is warranted. If so, briefly "
+                "state your proposed change and WHY, then call ask_user_choice with "
+                "options Approve / Modify / Skip and act ONLY if the operator approves. "
+                "If nothing needs doing, say so briefly and take no action (no need to ask)."
+            )
+        else:
+            tail = (
+                "If a change helps (adjust interval/power, add a stop condition, queue a "
+                "burst, or stop an embryo), do it now using your tools. If nothing needs "
+                "doing, say so briefly and take no action."
+            )
+        return head + tail, trigger_str
diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index 028ce2d7..812b9e15 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -43,6 +43,48 @@ def __init__(self, agent):
         self._wizard = None  # StartupWizard, set by init_wizard()
         self._active_remote: Optional[Dict[str, Any]] = None  # {"peer": PeerInfo, "campaign_id": str}
         self._pending_import: Optional[Dict] = None  # For /import-embryos picker
+        # Set by the web layer (register_display_broadcaster) so AGENT-INITIATED
+        # turns (the wake-router) can stream to all chat clients + the transcript.
+        self._display_broadcaster: Optional[Callable] = None
+
+    def register_display_broadcaster(self, broadcast_fn, choice_factory=None,
+                                     choice_discard=None) -> None:
+        """Register the web layer's broadcast fn for autonomous (wake) turns.
+
+        The wake-router has no per-connection send_fn, so to make autonomous
+        turns visible we route their chunks through the same _broadcast the web
+        route uses for user turns (records to the display transcript AND fans out
+        to every connected chat client). Also wires the agent's dangling
+        on_message_callback to this path, and (for ASK mode) the choice-future
+        factory so an autonomous turn can round-trip an approval picker.
+        Idempotent — last registration wins; the registered fns are router-scoped
+        and fan out to whoever is connected.
+        """
+        self._display_broadcaster = broadcast_fn
+        try:
+            self.agent.on_message_callback = self.broadcast_autonomous_chunk
+            if choice_factory is not None:
+                self.agent._wake_choice_factory = choice_factory
+            if choice_discard is not None:
+                self.agent._wake_choice_discard = choice_discard
+        except Exception:
+            pass
+
+    async def broadcast_autonomous_chunk(self, chunk) -> None:
+        """Fan one autonomous-turn chunk to all chat clients + the transcript.
+
+        No-op when no web client has registered a broadcaster (headless run) —
+        the wake turn still executes and is persisted to the conversation/log.
+        """
+        fn = self._display_broadcaster
+        if fn is None:
+            return
+        try:
+            res = fn(chunk)
+            if asyncio.iscoroutine(res):
+                await res
+        except Exception:
+            logger.debug("broadcast_autonomous_chunk failed", exc_info=True)
 
     async def handle_choice_response(self, request_id: str, selected: str, send_fn) -> bool:
         """Handle a choice response that may belong to a bridge-initiated picker.
diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index a2f7634f..61d06706 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -87,62 +87,32 @@
 
 # CV Subagent capabilities
 CV_SUBAGENT = """
-# CV Subagent for Advanced Analysis
-
-For complex computer vision analysis, you have access to a specialized CV subagent via the `cv_analyze` tool.
-
-## IMPORTANT: Volume Required First!
-
-Before using cv_analyze or classify_embryo_stage, you MUST ensure the embryo has a volume acquired
-in this session. If the user asks for cell counting, stage classification, or any analysis:
-
-1. Check if the embryo has been imaged (recent_images exists)
-2. If NOT, acquire a volume first with `acquire_volume`
-3. Then proceed with analysis
-
-Example workflow:
-User: "Count the cells in embryo_3"
-→ First: acquire_volume(embryo_id="embryo_3")  # Get fresh data
-→ Then: cv_analyze(intent="count cells", embryo_id="embryo_3")
-
-## When to use cv_analyze
-
-Use the CV subagent when you need:
-- **Accurate stage classification** - It segments nuclei (Cellpose) and uses count + morphology for staging
-- **Cell counting** - 3D segmentation gives precise nuclei counts, not visual estimates
-- **Division tracking** - Tracks cells across timepoints, identifies division events
-- **Morphology measurements** - Elongation ratio, circularity (important for comma/fold stages)
-- **Anomaly detection** - Compares to expected developmental patterns
-
-## When NOT to use cv_analyze
-
-Don't use it for:
-- Quick visual checks (use simple image viewing instead)
-- Hatching detection (the hatching detector handles this)
-- Basic "what stage is this?" if rough estimate is fine
-
-## How it works
-
-The CV subagent is itself an AI agent that:
-1. Loads volume data from the data store
-2. Segments with Cellpose/StarDist (nuclei count!)
-3. Measures morphology (elongation for fold stages)
-4. Adds scale bars and annotations
-5. Uses Claude Vision with rich quantitative context
-
-This gives much more accurate results than just sending an image to vision.
-
-## Example usage
-
-User: "How many cells does embryo 1 have?"
-→ First acquire_volume if needed, then cv_analyze with intent="count cells and nuclei"
-
-User: "What stage is embryo 2?"
-→ If precision matters: acquire_volume then cv_analyze intent="classify developmental stage"
-→ If quick check: view the image yourself
-
-User: "Track cell divisions over the last 5 timepoints"
-→ cv_analyze with intent="track cell divisions" and timepoints=[t-4, t-3, t-2, t-1, t]
+# Perception & Analysis
+
+You see and reason about embryo development through three channels:
+
+1. **Live perception (the perceiver).** During a timelapse a vision-language
+   perceiver classifies each acquired volume's developmental stage and tracks
+   each embryo's trajectory. Its current read is injected into your context
+   under "## Perception (live)" — stage, stability (how long it's held that
+   stage), time-in-stage, and a possible-arrest flag. Call
+   `get_recent_perceptions(embryo_id)` for the fuller picture: stage history,
+   trajectory, the arrest signal, and the perceiver's own reasoning. This is
+   your primary signal for "how is it developing?" and for deciding whether to
+   adapt acquisition.
+
+2. **On-demand vision (`analyze_volume`).** Ask Claude Vision a specific
+   question about an acquired volume (e.g. "is the reporter saturating?",
+   "describe the morphology"). Requires a volume in this session — acquire one
+   first with `acquire_volume` if none exists.
+
+3. **Stage tools.** `classify_embryo_stage` (a vision spot-check of the latest
+   image), `get_stage_history`, and `predict_hatching` — the latter two read the
+   live perceiver when available, so they work without a manual classify call.
+
+Prefer the live perception snapshot + `get_recent_perceptions` for routine
+"what stage / is anything stuck" questions; reach for `analyze_volume` when you
+need a specific visual judgement about a particular volume.
 """
 
 
@@ -266,30 +236,78 @@
 
 1. User: "Run timelapse until all embryos hatch"
 2. Agent:
-   - Enables hatching detector (enable_preset_detector)
-   - Starts timelapse with stop_condition="hatching"
+   - Starts the timelapse with stop_condition="hatching" (the stop condition
+     wires the detection; the perception loop classifies each acquired volume)
+   - Optionally installs a monitoring mode (enable_monitoring_mode) for
+     reactive cadence/power
    - Reports progress on request
    - Each embryo stops automatically when it hatches
 
-## Available Preset Detectors
+## Stage detection
 
-- **hatching**: Detects eggshell breach and embryo emergence
-- **comma**: Detects comma stage morphology
-- **pretzel**: Detects 3-fold/pretzel stage
-- **gastrulation**: Detects cell internalization
-- **first_division**: Detects 1-cell to 2-cell transition
+Developmental stage comes from the live perception loop (see "Perception &
+Analysis"), surfaced in your context and via get_recent_perceptions. Stop
+conditions can key on it — e.g. stop_condition="hatching" or "comma".
 
 ## Commands During Timelapse
 
 - Query status: get_timelapse_status
 - Stop one embryo: stop_timelapse_embryo
-- Change interval: modify_timelapse_embryo
+- Change interval (all embryos): modify_timelapse_interval
+- Change one embryo's cadence: set_embryo_cadence
+- Other per-embryo params: modify_timelapse_embryo / modify_parameters
 - Pause all: pause_timelapse
 - Resume: resume_timelapse
 - Stop all: stop_timelapse
 """
 
 
+AUTONOMY_AND_ADAPTATION = """
+# Adapting Acquisition — Gently
+
+Gentleness is the prime directive: every imaging action spends photodose on a
+precious, living sample. Always prefer the *least* light that answers the
+question. When you do adapt, you have direct, live knobs — each takes effect on
+the embryo's next acquisition, no restart:
+
+- **Cadence**: `modify_timelapse_interval` (whole run) / `set_embryo_cadence`
+  (one embryo). Speed up only around events worth catching (e.g. approaching
+  hatching); slow back down when nothing is changing.
+- **Dose levers**: `modify_parameters` — num_slices, exposure_ms, acquisition
+  mode (volume ↔ snap, snap is far gentler), and per-embryo 488 power (hard
+  clamped 2–6%). `set_photodose_budget` caps cumulative exposure and pauses an
+  embryo that exceeds it; `get_photodose_status` shows where each stands.
+- **Events**: `add_stop_condition` (auto-stop on hatching/stage/duration),
+  `queue_burst` (one-shot high-rate capture of a transient), and per-embryo
+  pause / resume / stop.
+- **Reactive modes**: `enable_monitoring_mode` installs perception-driven rules
+  that fire on their own (pre-hatching speedup, 488 rampdown on saturation,
+  burst on stable structure).
+
+Bias toward the gentlest sufficient action — snap over volume, fewer slices,
+lower power, longer interval — unless an event genuinely needs the resolution.
+
+# Autonomy (OFF / ASK / AUTO)
+
+You may act between user messages, but only as far as the operator allows. The
+mode is set with `set_autonomy` and is **OFF by default**:
+
+- **off** — act only when the user messages you.
+- **ask** — on a notable event (a developmental stage transition, possible
+  arrest, hatching, an embryo terminating, or an error) you wake, briefly state
+  your PROPOSED change and why, then call `ask_user_choice` with
+  Approve / Modify / Skip and act ONLY on Approve.
+- **auto** — you adapt on your own on those events. Still: prefer the gentlest
+  action, and a few irreversible tools (turning the laser on via
+  `set_laser_power`, `remove_embryo`, `stop_timelapse`) are hard-blocked from
+  autonomous use — ask the operator for those.
+
+When you wake autonomously, your turn and the trigger that woke you are shown to
+the operator in the chat. Keep autonomous turns tight: assess, make the smallest
+helpful change (or none), and explain it in a sentence or two.
+"""
+
+
 def build_perception_snapshot(perceiver, embryos) -> str:
     """One compact line per embryo of live perception state for the system prompt.
 
@@ -451,6 +469,8 @@ def build_system_prompt(
 
 {REACTIVE_MONITORING_MODES}
 
+{AUTONOMY_AND_ADAPTATION}
+
 {USER_INTERACTION_GUIDELINES}
 
 {SESSION_MANAGEMENT}
diff --git a/gently/harness/tools/registry.py b/gently/harness/tools/registry.py
index 106bd7a2..48e1cf4f 100644
--- a/gently/harness/tools/registry.py
+++ b/gently/harness/tools/registry.py
@@ -425,6 +425,20 @@ async def execute(self, tool_name: str, tool_input: Dict, context: Dict = None)
         else:
             exec_context = self._context
 
+        # Hybrid-autonomy backstop: during an autonomous (wake) turn, a small set
+        # of irreversible tools (laser-on, embryo termination, stopping the run)
+        # must NEVER execute without a human — even if the model tries to call
+        # them directly. The agent sets these flags around its autonomous turns;
+        # user-driven turns are unaffected. The blocked set is supplied by the
+        # agent so this layer stays free of app-specific tool names.
+        _agent = exec_context.get('agent') if isinstance(exec_context, dict) else None
+        if _agent is not None and getattr(_agent, '_autonomous_active', False):
+            blocked = getattr(_agent, '_autonomous_blocked_tools', None) or ()
+            if tool_name in blocked:
+                logger.info("Autonomy backstop blocked '%s' (irreversible)", tool_name)
+                return (f"'{tool_name}' is an irreversible action and cannot run "
+                        f"autonomously. Ask the operator to confirm it.")
+
         # Check microscope requirement
         if tool.requires_microscope:
             client = exec_context.get('client')
diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index 0d27a5d0..36ca6ee5 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -48,7 +48,7 @@ def create_router(server) -> APIRouter:
     # Persisted to <session>/chat_display.json so it survives reconnects and
     # restarts; broadcast live so all instances stay in sync.
     _history: list = []
-    _history_state = {"sid": None, "path": None, "agent_buf": None}
+    _history_state = {"sid": None, "path": None, "agent_buf": None, "autonomous": False}
 
     async def _broadcast_control_status():
         """Tell every connected agent client who currently holds control."""
@@ -81,6 +81,7 @@ def _load_history_for_session(bridge):
         _history_state["sid"] = sid
         _history_state["path"] = None
         _history_state["agent_buf"] = None
+        _history_state["autonomous"] = False
         try:
             if store and sid:
                 sdir = store._session_dir(sid)
@@ -140,7 +141,10 @@ def _record(item):
     def _flush_agent_buf():
         buf = _history_state["agent_buf"]
         if buf:
-            _record({"role": "agent", "text": buf})
+            # An autonomous (wake) turn's text is recorded distinctly so replay
+            # shows it as "Gently · autonomous", not an ordinary agent reply.
+            role = "autonomous" if _history_state.get("autonomous") else "agent"
+            _record({"role": role, "text": buf})
         _history_state["agent_buf"] = None
 
     def _record_display(msg):
@@ -148,8 +152,15 @@ def _record_display(msg):
         t = msg.get("type")
         if t == "user_message":
             _flush_agent_buf()
+            _history_state["autonomous"] = False
             _record({"role": "user", "text": msg.get("text", ""),
                      "author": msg.get("author")})
+        elif t == "autonomous_start":
+            # An autonomous wake turn is beginning — record the trigger banner
+            # and mark following text as autonomous until stream_end.
+            _flush_agent_buf()
+            _history_state["autonomous"] = True
+            _record({"role": "autonomous_start", "trigger": msg.get("trigger", "")})
         elif t == "text":
             _history_state["agent_buf"] = (_history_state["agent_buf"] or "") + msg.get("text", "")
         elif t == "tool_call":
@@ -159,6 +170,7 @@ def _record_display(msg):
                      "summary": msg.get("result_summary")})
         elif t == "stream_end":
             _flush_agent_buf()
+            _history_state["autonomous"] = False
 
     async def _broadcast(msg):
         """Record to history + send a display message to ALL clients."""
@@ -274,6 +286,11 @@ async def agent_websocket(websocket: WebSocket):
             await websocket.close()
             return
 
+        # Route autonomous (wake-router) turns through this router's _broadcast so
+        # they stream to all chat clients + persist to the display transcript.
+        # Idempotent; _broadcast is router-scoped and fans out to whoever is live.
+        bridge.register_display_broadcaster(_broadcast)
+
         # ── Authenticate the connection (account mode) ────────────
         # When user accounts are configured, identity comes from the signed
         # session cookie (set at login). Viewers may watch but not drive;
@@ -572,6 +589,14 @@ def choice_future_factory(choice_data: dict) -> asyncio.Future:
             _choice_futures[request_id] = future
             return future
 
+        def _discard_choice(request_id: str) -> None:
+            _choice_futures.pop(request_id, None)
+
+        # Give the bridge the choice-factory + discard too, so ASK-mode autonomous
+        # turns can round-trip an approval picker through this connection's channel
+        # and clean up the future on timeout/cancel.
+        bridge.register_display_broadcaster(_broadcast, choice_future_factory, _discard_choice)
+
         # Register this client for control arbitration; grant control if free
         # (only to clients allowed to drive — viewers never auto-hold).
         _clients[client_id] = send_fn
diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index 777582b2..862a92e8 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -140,6 +140,28 @@
     white-space: pre-wrap; word-wrap: break-word;
 }
 
+/* ── Autonomous (wake) turns ────────────────────────────── */
+.ac-autonomous-banner {
+    display: flex; align-items: center; gap: 8px;
+    align-self: stretch;
+    margin: 2px 0;
+    padding: 6px 10px;
+    font-size: 11.5px; font-weight: 500;
+    color: var(--accent-purple);
+    background: rgba(167, 139, 250, 0.10);
+    border: 1px solid rgba(167, 139, 250, 0.28);
+    border-radius: 8px;
+}
+.ac-autonomous-dot {
+    width: 7px; height: 7px; border-radius: 50%;
+    background: var(--accent-purple);
+    box-shadow: 0 0 0 3px rgba(167, 139, 250, 0.20);
+    flex: 0 0 auto;
+}
+/* Autonomous agent bubbles get an accent rail + a distinct role label. */
+.ac-turn-autonomous { border-left: 2px solid rgba(167, 139, 250, 0.45); padding-left: 8px; }
+.ac-turn-autonomous .ac-role { color: var(--accent-purple); }
+
 /* ── Activity indicator ─────────────────────────────────── */
 .ac-activity {
     display: flex; align-items: center; gap: 9px;
@@ -220,6 +242,11 @@
 .ac-choice-label { font-weight: 600; font-size: 13px; }
 .ac-choice-desc { font-size: 12px; color: var(--text-muted); }
 .ac-choice-picked { border-color: var(--accent-green); background: rgba(74, 222, 128, 0.08); }
+.ac-choice-wake { border-color: rgba(167, 139, 250, 0.45); }
+.ac-choice-origin {
+    font-size: 10.5px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase;
+    color: var(--accent-purple); margin-bottom: 2px;
+}
 
 /* ── Applied-spec card ──────────────────────────────────── */
 .ac-spec {
@@ -293,4 +320,44 @@
 }
 .agent-chat-send:hover:not(:disabled) { background: var(--accent-hover); }
 .agent-chat-send:disabled { opacity: 0.5; cursor: default; }
-.agent-chat-send.ac-busy { background: var(--color-danger, #f87171); }
+/* Send now queues while busy (it no longer doubles as Stop), so just dim it. */
+.agent-chat-send.ac-busy { opacity: 0.6; }
+
+/* Explicit Stop (separate from Send), shown only during a cancellable turn. */
+.ac-stop {
+    flex: 0 0 auto; align-self: flex-end;
+    padding: 9px 12px; border-radius: 9px;
+    border: 1px solid var(--color-danger, #f87171);
+    background: transparent; color: var(--color-danger, #f87171);
+    font-weight: 600; font-size: 13px; cursor: pointer;
+}
+.ac-stop:hover { background: rgba(248, 113, 113, 0.12); }
+.ac-stop.hidden { display: none; }
+
+/* ── Queued-message panel (type-while-busy) ─────────────── */
+.ac-queue {
+    margin: 0 12px 6px;
+    border: 1px solid var(--border); border-radius: 9px;
+    background: rgba(127, 127, 127, 0.06);
+    padding: 6px; font-size: 12px;
+}
+.ac-queue.hidden { display: none; }
+.ac-queue-head {
+    display: flex; align-items: center; justify-content: space-between;
+    padding: 2px 4px 6px; color: var(--text-muted);
+}
+.ac-queue-clear {
+    background: none; border: none; color: var(--accent);
+    cursor: pointer; font-size: 11.5px; font-family: inherit;
+}
+.ac-queue-clear:hover { text-decoration: underline; }
+.ac-queue-item { display: flex; align-items: center; gap: 8px; padding: 4px; }
+.ac-queue-text {
+    flex: 1 1 auto; color: var(--text);
+    white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+.ac-queue-remove {
+    flex: 0 0 auto; background: none; border: none;
+    color: var(--text-muted); cursor: pointer; font-size: 12px; line-height: 1;
+}
+.ac-queue-remove:hover { color: var(--color-danger, #f87171); }
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 3b10d8be..545b05ac 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -28,6 +28,12 @@ const AgentChat = (() => {
     let tools = [];               // [{name, description, params, ...}]
     let acItems = [];             // current completion items shown in the dropdown
     let acIdx = -1;               // highlighted item index
+    let autonomousTurn = false;   // true while rendering an autonomous (wake) turn
+    let agentBusy = false;        // a turn (user or autonomous) is currently running
+    let busySource = null;        // 'user' | 'wake' while busy
+    let msgQueue = [];            // messages typed while busy, sent on idle
+    let queuePanel = null;        // the "⏳ Queued (N)" panel element
+    let stopBtn = null;           // explicit Stop button (separate from Send)
 
     // DOM refs (resolved in init)
     let fab, panel, log, input, sendBtn, conn, banner, closeBtn, userEl, signoutBtn;
@@ -75,10 +81,11 @@ const AgentChat = (() => {
     function addTurn(role) {
         const wrap = document.createElement('div');
         wrap.className = `ac-turn ac-turn-${role}`;
+        if (role === 'agent' && autonomousTurn) wrap.classList.add('ac-turn-autonomous');
         if (role === 'agent') {
             const label = document.createElement('div');
             label.className = 'ac-role';
-            label.textContent = 'Gently';
+            label.textContent = autonomousTurn ? 'Gently · autonomous' : 'Gently';
             wrap.appendChild(label);
         }
         const content = document.createElement('div');
@@ -118,6 +125,14 @@ const AgentChat = (() => {
                 const c = addTurn('agent');
                 c._raw = it.text || '';
                 c.innerHTML = mdToHtml(c._raw);
+            } else if (it.role === 'autonomous_start') {
+                addAutonomousBanner(it.trigger || '');
+            } else if (it.role === 'autonomous') {
+                autonomousTurn = true;
+                const c = addTurn('agent');
+                c._raw = it.text || '';
+                c.innerHTML = mdToHtml(c._raw);
+                autonomousTurn = false;
             } else if (it.role === 'tool') {
                 const el = document.createElement('div');
                 el.className = 'ac-tool ac-tool-done';
@@ -132,6 +147,16 @@ const AgentChat = (() => {
         scrollToBottom();
     }
 
+    /** A divider announcing the agent woke itself, with the trigger reason. */
+    function addAutonomousBanner(trigger) {
+        const el = document.createElement('div');
+        el.className = 'ac-autonomous-banner';
+        const t = trigger ? `Gently woke up — ${trigger}` : 'Gently woke up';
+        el.innerHTML = `<span class="ac-autonomous-dot"></span><span>${escapeHtml(t)}</span>`;
+        log.appendChild(el);
+        scrollToBottom();
+    }
+
     function addSystemLine(text, level = 'info') {
         const el = document.createElement('div');
         el.className = `ac-system ac-level-${level}`;
@@ -171,10 +196,20 @@ const AgentChat = (() => {
             case 'stream_start':
                 streaming = true;
                 currentAgentEl = null;  // created lazily on first text
-                setBusy(true);
+                setBusy(true, 'user');
                 setActivity('Working…');
                 break;
 
+            case 'autonomous_start':
+                // The agent woke itself — render a distinct banner + label the
+                // following text as autonomous (no stream_start precedes this).
+                hideActivity();
+                autonomousTurn = true;
+                currentAgentEl = null;
+                setBusy(true, 'wake');
+                addAutonomousBanner(msg.trigger || '');
+                break;
+
             case 'thinking':
                 if (streaming) setActivity('Thinking…');
                 break;
@@ -256,6 +291,7 @@ const AgentChat = (() => {
             case 'stream_end':
                 streaming = false;
                 currentAgentEl = null;
+                autonomousTurn = false;
                 hideActivity();
                 setBusy(false);
                 break;
@@ -289,7 +325,13 @@ const AgentChat = (() => {
         const data = msg.choice_data || {};
         const reqId = msg.request_id || data.request_id || '';
         const wrap = document.createElement('div');
-        wrap.className = 'ac-choice';
+        wrap.className = 'ac-choice' + (msg.origin === 'wake' ? ' ac-choice-wake' : '');
+        if (msg.origin === 'wake') {
+            const tag = document.createElement('div');
+            tag.className = 'ac-choice-origin';
+            tag.textContent = 'Autonomy proposal — your approval needed';
+            wrap.appendChild(tag);
+        }
         const q = document.createElement('div');
         q.className = 'ac-choice-q';
         q.innerHTML = mdToHtml(data.question || 'Choose:');
@@ -482,9 +524,67 @@ const AgentChat = (() => {
         }
     }
 
-    function setBusy(busy) {
-        sendBtn.textContent = busy ? 'Stop' : 'Send';
-        sendBtn.classList.toggle('ac-busy', busy);
+    function setBusy(busy, source) {
+        agentBusy = !!busy;
+        busySource = agentBusy ? (source || 'user') : null;
+        // Send no longer doubles as Stop — it queues while busy. A separate Stop
+        // (shown only for a cancellable user turn) aborts the current turn.
+        if (stopBtn) stopBtn.classList.toggle('hidden', !(agentBusy && busySource === 'user'));
+        sendBtn.classList.toggle('ac-busy', agentBusy);
+        if (agentBusy) {
+            input.placeholder = (busySource === 'wake')
+                ? 'Gently is acting autonomously — your message will queue'
+                : 'Gently is working — your message will queue';
+        } else {
+            if (hasControl) input.placeholder = 'Message Gently…   ( / commands · @ tools )';
+            drainQueue();  // a turn just ended — send the next queued message
+        }
+    }
+
+    // ── Message queue (type-while-busy) ───────────────────────
+    function enqueue(text) { msgQueue.push(text); renderQueue(); }
+    function removeQueued(i) {
+        if (i >= 0 && i < msgQueue.length) { msgQueue.splice(i, 1); renderQueue(); }
+    }
+    function clearQueue() { msgQueue = []; renderQueue(); }
+    function drainQueue() {
+        if (agentBusy || !msgQueue.length) return;
+        if (!ws || ws.readyState !== WebSocket.OPEN) return;  // keep queued until reconnect
+        const next = msgQueue.shift();
+        renderQueue();
+        actuallySend(next);
+    }
+    function renderQueue() {
+        if (!queuePanel) return;
+        if (!msgQueue.length) { queuePanel.classList.add('hidden'); queuePanel.innerHTML = ''; return; }
+        queuePanel.classList.remove('hidden');
+        queuePanel.innerHTML = '';
+        const head = document.createElement('div');
+        head.className = 'ac-queue-head';
+        const lbl = document.createElement('span');
+        lbl.textContent = `⏳ Queued (${msgQueue.length})`;
+        const clear = document.createElement('button');
+        clear.className = 'ac-queue-clear';
+        clear.textContent = 'Clear all';
+        clear.addEventListener('click', clearQueue);
+        head.appendChild(lbl);
+        head.appendChild(clear);
+        queuePanel.appendChild(head);
+        msgQueue.forEach((m, i) => {
+            const row = document.createElement('div');
+            row.className = 'ac-queue-item';
+            const span = document.createElement('span');
+            span.className = 'ac-queue-text';
+            span.textContent = m;
+            const x = document.createElement('button');
+            x.className = 'ac-queue-remove';
+            x.textContent = '✕';
+            x.title = 'Remove from queue';
+            x.addEventListener('click', () => removeQueued(i));
+            row.appendChild(span);
+            row.appendChild(x);
+            queuePanel.appendChild(row);
+        });
     }
 
     function setConn(ok, label) {
@@ -520,23 +620,32 @@ const AgentChat = (() => {
     }
 
     // ── Input handling ────────────────────────────────────────
-    function submit() {
-        if (streaming) { send({ type: 'cancel' }); return; }  // Send doubles as Stop
-        hideCompletions();
-        const text = input.value.trim();
-        if (!text) return;
-        if (!hasControl) { renderControl(); return; }
+    function actuallySend(text) {
         if (text.startsWith('/')) {
             addUserMessage(text);                       // commands aren't broadcast; echo locally
             send({ type: 'command', command: text });   // slash commands (e.g. /status)
-        } else {
-            send({ type: 'chat', text });               // echoed to all via 'user_message'
+            // Most commands reply with a single 'command_result' and no stream —
+            // do NOT mark the composer busy, or the queue would stick forever.
+            // Commands that DO stream (e.g. /wizard) set busy via stream_start.
+            return;
         }
+        send({ type: 'chat', text });                   // echoed to all via 'user_message'
         // Instant feedback before the first chunk arrives.
-        setBusy(true);
+        setBusy(true, 'user');
         setActivity('Working…');
+    }
+
+    function submit() {
+        hideCompletions();
+        const text = input.value.trim();
+        if (!text) return;
+        if (!hasControl) { renderControl(); return; }
         input.value = '';
         autosize();
+        // While the agent is busy (a user OR autonomous turn), queue instead of
+        // cancelling — Send no longer doubles as Stop.
+        if (agentBusy) { enqueue(text); return; }
+        actuallySend(text);
     }
 
     function autosize() {
@@ -613,6 +722,19 @@ const AgentChat = (() => {
             acComplete = document.createElement('div');
             acComplete.className = 'ac-complete hidden';
             inputWrap.insertBefore(acComplete, inputWrap.firstChild);
+
+            // Queued-message panel (above the composer) for type-while-busy.
+            queuePanel = document.createElement('div');
+            queuePanel.className = 'ac-queue hidden';
+            if (inputWrap.parentNode) inputWrap.parentNode.insertBefore(queuePanel, inputWrap);
+
+            // Explicit Stop button — shown only during a cancellable user turn.
+            stopBtn = document.createElement('button');
+            stopBtn.className = 'ac-stop hidden';
+            stopBtn.textContent = 'Stop';
+            stopBtn.title = 'Stop the current turn';
+            stopBtn.addEventListener('click', () => { send({ type: 'cancel' }); setBusy(false); });
+            inputWrap.appendChild(stopBtn);
         }
 
         sendBtn.addEventListener('click', submit);
@@ -629,7 +751,11 @@ const AgentChat = (() => {
                 if (e.key === 'Escape') { e.preventDefault(); hideCompletions(); return; }
             }
             if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); submit(); }
-            if (e.key === 'Escape' && streaming) { e.preventDefault(); send({ type: 'cancel' }); }
+            // Escape mirrors Stop: cancel a cancellable (user) turn and clear busy
+            // (a cancelled turn emits no stream_end, so clear optimistically).
+            if (e.key === 'Escape' && agentBusy && busySource === 'user') {
+                e.preventDefault(); send({ type: 'cancel' }); setBusy(false);
+            }
         });
     }
 

From f8f977159a83fb42491573439dca06972a622bdc Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 20:17:47 -0400
Subject: [PATCH 056/314] Redesign agent chat as a docked, sliding side panel
 (overlay + pin-to-dock)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replaces the floating popup bubble with a professional VSCode-style side panel,
per a UI/UX + biologist-cognition consult that converged on overlay-by-default
with an opt-in pin-to-dock.

- App shell: header/navbar stay full-width; a new .app-shell flex row holds
  .app-main (content) + the chat <aside>. Overlay mode = absolute slide-over
  (transform, no reflow) so the live viewer stays steady; pin-to-dock makes it a
  real pushing column (min-width:0 lets canvases shrink).
- Killed the floating FAB → a labeled 'Agent' toggle in the header with a
  connection dot + an unseen-activity badge (wake/approval/notification while
  closed); Ctrl/Cmd+J toggles it.
- Docked grammar: flush to edge, no radius, directional edge shadow (overlay) /
  seam (dock), 220ms transform slide, left-edge drag handle to resize (clamped
  320..min(560,45vw), persisted, double-click reset, debounced dock reflow).
- Fixed a latent bug: the Three.js 3D viewer had no resize handler at all — added
  a ResizeObserver + a 'gently:layout-changed' event so it follows the dock and
  window.
- ASK approvals pin to a sticky slot above the composer (never scroll away);
  autoscroll pins-to-bottom only when already there, else a '↓ N new' pill.
- Light/dark shadow + seam theme vars.

Review fixes: resize handle uses pointer capture + pointercancel + primary-button
guard; the 'N new' pill counts items not stream chunks; Ctrl/Cmd+J ignores
auto-repeat and won't fire while composing; opening the panel re-pins to latest.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/agent-chat.css      | 142 +++++++++---
 gently/ui/web/static/css/main.css            |  27 +++
 gently/ui/web/static/js/agent-chat.js        | 215 +++++++++++++++++--
 gently/ui/web/static/js/projection-viewer.js |  41 ++++
 gently/ui/web/templates/_header.html         |  11 +
 gently/ui/web/templates/index.html           |  25 ++-
 6 files changed, 410 insertions(+), 51 deletions(-)

diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index 862a92e8..afbbb893 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -1,46 +1,98 @@
 /* Floating agent-chat window — the web-side control surface.
    Restrained, professional styling for a lab instrument. */
 
-.agent-fab {
-    position: fixed;
-    right: 24px;
-    bottom: 24px;
-    width: 52px;
-    height: 52px;
-    border-radius: 14px;
+/* ── Header toggle (replaces the floating FAB) ─────────────── */
+.header-agent-toggle {
+    display: inline-flex; align-items: center; gap: 7px;
+    padding: 5px 10px; border-radius: 8px;
     border: 1px solid var(--border);
-    cursor: pointer;
-    z-index: 1200;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    background: var(--bg-card);
-    box-shadow: 0 6px 24px rgba(0, 0, 0, 0.4);
-    transition: transform 0.15s ease, box-shadow 0.15s ease;
+    background: var(--bg-hover); color: var(--text);
+    font: 500 12.5px/1 'Inter Tight', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+    cursor: pointer; position: relative;
+    transition: border-color 0.15s ease, background 0.15s ease, color 0.15s ease;
+}
+.header-agent-toggle:hover { border-color: var(--accent); }
+.header-agent-toggle[aria-pressed="true"] {
+    border-color: var(--accent); color: var(--accent);
+    background: rgba(96, 165, 250, 0.12);
+}
+.header-agent-toggle svg { display: block; }
+.header-agent-label { letter-spacing: 0.01em; }
+.header-agent-dot {
+    width: 7px; height: 7px; border-radius: 50%;
+    background: var(--text-muted); flex: 0 0 auto;
+}
+.header-agent-dot.ok { background: var(--accent-green); }
+.header-agent-badge {
+    position: absolute; top: -6px; right: -6px;
+    min-width: 16px; height: 16px; padding: 0 4px;
+    border-radius: 999px; background: var(--accent-purple); color: #fff;
+    font-size: 10px; font-weight: 700; line-height: 16px; text-align: center;
 }
-.agent-fab img { display: block; }
-.agent-fab:hover { transform: translateY(-2px); box-shadow: 0 10px 30px rgba(0, 0, 0, 0.5); }
-.agent-fab.ac-fab-active { opacity: 0.92; }
+.header-agent-badge.hidden { display: none; }
 
+/* ── Docked agent panel ────────────────────────────────────
+   Default = overlay slide-over, absolutely positioned inside .app-shell (which
+   sits below the global header/navbar). Pin (body.chat-docked) turns it into a
+   real column that pushes .app-main. */
 .agent-chat {
-    position: fixed;
-    right: 24px;
-    bottom: 88px;
-    width: 412px;
-    max-width: calc(100vw - 48px);
-    height: 600px;
-    max-height: calc(100vh - 128px);
+    position: absolute;
+    top: 0; right: 0; bottom: 0;
+    width: var(--chat-w, 384px);
+    max-width: 92vw;
     display: flex;
     flex-direction: column;
     background: var(--bg-card);
-    border: 1px solid var(--border);
-    border-radius: 12px;
-    box-shadow: 0 16px 50px rgba(0, 0, 0, 0.5);
-    z-index: 1199;
+    border-left: 1px solid var(--border);
+    box-shadow: -16px 0 40px -16px var(--panel-edge-shadow);
+    z-index: 50;
     overflow: hidden;
+    transform: translateX(100%);
+    transition: transform 0.22s cubic-bezier(0.22, 1, 0.36, 1);
+    will-change: transform;
     font-family: 'Inter Tight', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
 }
-.agent-chat.hidden, .agent-control-banner.hidden { display: none; }
+.agent-chat.open { transform: translateX(0); }
+
+/* Pinned: a real pushing column — no float shadow, just a seam. */
+body.chat-docked .agent-chat {
+    position: relative;
+    transform: none;
+    box-shadow: none;
+    border-left: 1px solid var(--border-strong);
+    flex: 0 0 auto;
+    transition: none;
+    z-index: auto;
+}
+body.chat-docked .agent-chat:not(.open) {
+    width: 0; border-left: none; overflow: hidden;
+}
+
+@media (prefers-reduced-motion: reduce) {
+    .agent-chat { transition: opacity 0.12s ease; }
+}
+
+/* Left-edge resize handle (thin seam, generous hit area). */
+.agent-chat-resize {
+    position: absolute; left: -2px; top: 0; bottom: 0; width: 6px;
+    cursor: ew-resize; z-index: 3;
+}
+.agent-chat-resize::after {
+    content: ''; position: absolute; left: 2px; top: 0; bottom: 0; width: 1px;
+    background: transparent; transition: background 0.12s ease;
+}
+.agent-chat-resize:hover::after, .agent-chat-resize.dragging::after { background: var(--accent); }
+
+.agent-control-banner.hidden { display: none; }
+
+/* Pin button in the panel header. */
+.agent-chat-pin {
+    background: none; border: none; color: var(--text-muted);
+    cursor: pointer; padding: 2px; display: flex; align-items: center;
+    border-radius: 5px;
+}
+.agent-chat-pin:hover { color: var(--text); background: var(--bg-hover); }
+.agent-chat-pin[aria-pressed="true"] { color: var(--accent); }
 
 /* ── Header ─────────────────────────────────────────────── */
 .agent-chat-header {
@@ -242,12 +294,40 @@
 .ac-choice-label { font-weight: 600; font-size: 13px; }
 .ac-choice-desc { font-size: 12px; color: var(--text-muted); }
 .ac-choice-picked { border-color: var(--accent-green); background: rgba(74, 222, 128, 0.08); }
-.ac-choice-wake { border-color: rgba(167, 139, 250, 0.45); }
+.ac-choice-wake {
+    border-color: rgba(167, 139, 250, 0.45);
+    border-left: 3px solid var(--accent-purple);
+    background: rgba(167, 139, 250, 0.06);
+}
 .ac-choice-origin {
     font-size: 10.5px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase;
     color: var(--accent-purple); margin-bottom: 2px;
 }
 
+/* Sticky ASK-approval slot: pinned above the composer so it never scrolls away. */
+.ac-pending {
+    flex: 0 0 auto;
+    border-top: 1px solid var(--border);
+    background: var(--bg-card);
+    padding: 8px 12px 0;
+}
+.ac-pending.hidden { display: none; }
+.ac-pending .ac-choice { margin-bottom: 8px; }
+
+/* "↓ N new" jump-to-bottom pill (shown when scrolled up during streaming). */
+.ac-jump {
+    position: absolute;
+    left: 50%; transform: translateX(-50%);
+    bottom: 74px;
+    padding: 4px 12px; border-radius: 999px;
+    border: 1px solid var(--accent);
+    background: var(--bg-card); color: var(--accent);
+    font: 600 11.5px/1.4 'Inter Tight', -apple-system, sans-serif;
+    cursor: pointer; z-index: 4;
+    box-shadow: 0 4px 14px rgba(0, 0, 0, 0.35);
+}
+.ac-jump.hidden { display: none; }
+
 /* ── Applied-spec card ──────────────────────────────────── */
 .ac-spec {
     border: 1px solid var(--border);
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index bd6ca7b9..bf36b569 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -34,6 +34,10 @@
 
     /* Image backgrounds */
     --img-bg: #000;
+
+    /* Docked agent panel */
+    --panel-edge-shadow: rgba(0, 0, 0, 0.55);
+    --border-strong: #444c56;
 }
 
 /* ========================================
@@ -70,6 +74,10 @@
 
     /* Image backgrounds */
     --img-bg: #1e293b;
+
+    /* Docked agent panel — softer shadow + stronger seam for light mode */
+    --panel-edge-shadow: rgba(0, 0, 0, 0.18);
+    --border-strong: #cbd5e1;
 }
 
 * { margin: 0; padding: 0; box-sizing: border-box; }
@@ -90,6 +98,25 @@ body {
     transition: background-color 0.3s ease, color 0.3s ease;
 }
 
+/* App shell: main column + docked agent panel side by side. The flex row lets
+   the panel become a real column (pushing content) when pinned to dock; in the
+   default overlay mode the panel is position:fixed and sits out of this flow. */
+.app-shell {
+    flex: 1 1 auto;
+    min-height: 0;
+    display: flex;
+    flex-direction: row;
+    position: relative;   /* anchor for the overlay-mode agent panel */
+}
+.app-main {
+    flex: 1 1 auto;
+    min-width: 0;   /* allow canvases to shrink (not overflow) when docked */
+    min-height: 0;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+}
+
 /* Smooth theme transitions for key elements */
 .header, .tabs, .tab-content, .panel, .gallery-item,
 .events-container, .lightbox-container, .shortcuts-content {
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 545b05ac..6b456955 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -36,7 +36,9 @@ const AgentChat = (() => {
     let stopBtn = null;           // explicit Stop button (separate from Send)
 
     // DOM refs (resolved in init)
-    let fab, panel, log, input, sendBtn, conn, banner, closeBtn, userEl, signoutBtn;
+    let panel, log, input, sendBtn, conn, banner, closeBtn, userEl, signoutBtn;
+    let toggleBtn, pinBtn, resizeEl, toggleDot, toggleBadge;  // docked-panel chrome
+    let pendingSlot = null;       // sticky slot for ASK approval proposals
     let acComplete = null;        // the autocomplete dropdown element
 
     // ── Safe rendering ────────────────────────────────────────
@@ -56,7 +58,33 @@ const AgentChat = (() => {
         return html;
     }
 
-    function scrollToBottom() { log.scrollTop = log.scrollHeight; }
+    // Pin-to-bottom autoscroll: only follow new content if the user is already
+    // near the bottom; otherwise count unseen items and show a "↓ N new" pill so
+    // a streaming agent never yanks the operator away from something they're reading.
+    let stickBottom = true;
+    let newCount = 0;
+    let jumpPill = null;
+    function nearBottom() { return (log.scrollHeight - log.scrollTop - log.clientHeight) < 60; }
+    function renderJumpPill() {
+        if (!jumpPill) return;
+        if (!stickBottom && newCount > 0) {
+            jumpPill.textContent = `↓ ${newCount} new`;
+            jumpPill.classList.remove('hidden');
+        } else {
+            jumpPill.classList.add('hidden');
+        }
+    }
+    function scrollToBottom(isNewItem = true) {
+        if (stickBottom) { log.scrollTop = log.scrollHeight; }
+        // Only count genuinely new items (bubbles/rows), not in-place streaming
+        // text edits — otherwise the "N new" pill inflates per chunk.
+        else { if (isNewItem) newCount += 1; renderJumpPill(); }
+    }
+    function jumpToBottom() {
+        stickBottom = true; newCount = 0;
+        log.scrollTop = log.scrollHeight;
+        renderJumpPill();
+    }
 
     // ── Activity indicator ────────────────────────────────────
     // A single reusable "the agent is working" row, always pinned to the
@@ -118,6 +146,7 @@ const AgentChat = (() => {
         log.innerHTML = '';
         currentAgentEl = null;
         activityEl = null;
+        stickBottom = true; newCount = 0;  // a full rebuild jumps to latest
         (items || []).forEach(it => {
             if (it.role === 'user') {
                 addUserMessage(it.text, it.author);
@@ -208,6 +237,7 @@ const AgentChat = (() => {
                 currentAgentEl = null;
                 setBusy(true, 'wake');
                 addAutonomousBanner(msg.trigger || '');
+                bumpBadge();
                 break;
 
             case 'thinking':
@@ -222,7 +252,7 @@ const AgentChat = (() => {
                 }
                 currentAgentEl._raw += (msg.text || '');
                 currentAgentEl.innerHTML = mdToHtml(currentAgentEl._raw);
-                scrollToBottom();
+                scrollToBottom(false);  // in-place edit, not a new item
                 break;
             }
 
@@ -282,6 +312,7 @@ const AgentChat = (() => {
             case 'choice_request':
                 hideActivity();
                 renderChoice(msg);
+                bumpBadge();
                 break;
 
             case 'applied_spec':
@@ -303,6 +334,7 @@ const AgentChat = (() => {
 
             case 'notification':
                 addSystemLine(msg.body ? `${msg.title} — ${msg.body}` : msg.title, msg.level || 'info');
+                bumpBadge();
                 break;
 
             case 'error':
@@ -324,9 +356,10 @@ const AgentChat = (() => {
     function renderChoice(msg) {
         const data = msg.choice_data || {};
         const reqId = msg.request_id || data.request_id || '';
+        const isWake = msg.origin === 'wake';
         const wrap = document.createElement('div');
-        wrap.className = 'ac-choice' + (msg.origin === 'wake' ? ' ac-choice-wake' : '');
-        if (msg.origin === 'wake') {
+        wrap.className = 'ac-choice' + (isWake ? ' ac-choice-wake' : '');
+        if (isWake) {
             const tag = document.createElement('div');
             tag.className = 'ac-choice-origin';
             tag.textContent = 'Autonomy proposal — your approval needed';
@@ -349,9 +382,20 @@ const AgentChat = (() => {
                 wrap.classList.add('ac-choice-answered');
                 btn.classList.add('ac-choice-picked');
                 if (streaming) setActivity('Working…');
+                if (isWake && pendingSlot) {
+                    setTimeout(() => { pendingSlot.classList.add('hidden'); pendingSlot.innerHTML = ''; }, 700);
+                }
             });
             wrap.appendChild(btn);
         });
+        // ASK approvals pin to the sticky slot above the composer so they can't
+        // scroll out of reach; ordinary choices stay inline in the transcript.
+        if (isWake && pendingSlot) {
+            pendingSlot.innerHTML = '';
+            pendingSlot.appendChild(wrap);
+            pendingSlot.classList.remove('hidden');
+            return;
+        }
         log.appendChild(wrap);
         scrollToBottom();
     }
@@ -591,6 +635,7 @@ const AgentChat = (() => {
         conn.classList.toggle('ac-conn-ok', ok);
         conn.classList.toggle('ac-conn-bad', !ok);
         conn.textContent = label || (ok ? 'Connected' : 'Reconnecting…');
+        if (toggleDot) toggleDot.classList.toggle('ok', ok);
     }
 
     // ── Transport ─────────────────────────────────────────────
@@ -655,12 +700,126 @@ const AgentChat = (() => {
 
     function togglePanel(open) {
         panelOpen = (open === undefined) ? !panelOpen : open;
-        panel.classList.toggle('hidden', !panelOpen);
-        fab.classList.toggle('ac-fab-active', panelOpen);
+        panel.classList.toggle('open', panelOpen);
+        if (toggleBtn) {
+            toggleBtn.setAttribute('aria-pressed', panelOpen ? 'true' : 'false');
+            toggleBtn.setAttribute('aria-expanded', panelOpen ? 'true' : 'false');
+        }
         if (panelOpen) {
+            clearBadge();
             if (!ws) connect();
-            setTimeout(() => input.focus(), 50);
+            // Re-pin to the latest content (it may have streamed while closed,
+            // where scroll events don't fire to keep stickBottom current).
+            setTimeout(() => { input.focus(); jumpToBottom(); }, 50);
         }
+        // Opening/closing while docked reflows .app-main — tell viewers to resize.
+        if (document.body.classList.contains('chat-docked')) emitLayoutChanged();
+    }
+
+    // ── Layout: dock, resize, persistence ─────────────────────
+    const CHAT_MIN_W = 320;
+    function chatMaxW() { return Math.min(560, Math.round(window.innerWidth * 0.45)); }
+
+    function emitLayoutChanged() {
+        // Let the CSS settle, then notify viewers (e.g. the 3D canvas) to resize.
+        requestAnimationFrame(() => window.dispatchEvent(new CustomEvent('gently:layout-changed')));
+    }
+
+    function curChatWidth() {
+        return parseInt(getComputedStyle(document.documentElement).getPropertyValue('--chat-w')) || 384;
+    }
+
+    function setChatWidth(px, persist) {
+        const w = Math.max(CHAT_MIN_W, Math.min(chatMaxW(), Math.round(px)));
+        document.documentElement.style.setProperty('--chat-w', w + 'px');
+        if (persist) { try { localStorage.setItem('gently-chat-w', String(w)); } catch (_) {} }
+        return w;
+    }
+
+    function applyDock(docked, persist) {
+        document.body.classList.toggle('chat-docked', docked);
+        if (pinBtn) {
+            pinBtn.setAttribute('aria-pressed', docked ? 'true' : 'false');
+            pinBtn.title = docked ? 'Unpin (float over content)' : 'Pin to dock';
+        }
+        if (persist) { try { localStorage.setItem('gently-chat-docked', docked ? '1' : '0'); } catch (_) {} }
+        // Suppress the slide animation across the mode flip, then notify viewers.
+        panel.style.transition = 'none';
+        requestAnimationFrame(() => { panel.style.transition = ''; emitLayoutChanged(); });
+    }
+
+    function togglePin() {
+        const docked = !document.body.classList.contains('chat-docked');
+        if (docked && !panelOpen) togglePanel(true);  // pinning implies showing
+        applyDock(docked, true);
+    }
+
+    function setupResize() {
+        if (!resizeEl) return;
+        let startX = 0, startW = 0, dragging = false, rafId = 0, pid = null;
+        const onMove = (e) => {
+            if (!dragging) return;
+            setChatWidth(startW + (startX - e.clientX), false);  // right panel: drag left = wider
+            if (document.body.classList.contains('chat-docked')) {
+                if (rafId) cancelAnimationFrame(rafId);
+                rafId = requestAnimationFrame(emitLayoutChanged);  // coalesce dock reflow
+            }
+        };
+        const onUp = () => {
+            if (!dragging) return;
+            dragging = false;
+            resizeEl.classList.remove('dragging');
+            resizeEl.removeEventListener('pointermove', onMove);
+            resizeEl.removeEventListener('pointerup', onUp);
+            resizeEl.removeEventListener('pointercancel', onUp);
+            if (pid !== null && resizeEl.hasPointerCapture && resizeEl.hasPointerCapture(pid)) {
+                try { resizeEl.releasePointerCapture(pid); } catch (_) {}
+            }
+            pid = null;
+            document.body.style.userSelect = '';
+            setChatWidth(curChatWidth(), true);
+            emitLayoutChanged();
+        };
+        resizeEl.addEventListener('pointerdown', (e) => {
+            if (e.button !== 0) return;  // primary button only
+            e.preventDefault();
+            dragging = true;
+            startX = e.clientX;
+            startW = curChatWidth();
+            pid = e.pointerId;
+            // Capture so move/up/cancel always reach the handle (touch/pen-safe).
+            try { resizeEl.setPointerCapture(pid); } catch (_) {}
+            resizeEl.classList.add('dragging');
+            document.body.style.userSelect = 'none';
+            resizeEl.addEventListener('pointermove', onMove);
+            resizeEl.addEventListener('pointerup', onUp);
+            resizeEl.addEventListener('pointercancel', onUp);
+        });
+        resizeEl.addEventListener('dblclick', () => { setChatWidth(384, true); emitLayoutChanged(); });
+    }
+
+    function restorePrefs() {
+        try {
+            const w = parseInt(localStorage.getItem('gently-chat-w'));
+            if (w) setChatWidth(w, false);
+            if (localStorage.getItem('gently-chat-docked') === '1') applyDock(true, false);
+        } catch (_) {}
+    }
+
+    // Unseen-activity badge on the header toggle — so a closed panel still tells
+    // the operator the agent did something (woke, proposed an approval, notified).
+    let badgeCount = 0;
+    function bumpBadge() {
+        if (panelOpen) return;  // they're watching; no badge needed
+        badgeCount += 1;
+        if (toggleBadge) {
+            toggleBadge.textContent = badgeCount > 9 ? '9+' : String(badgeCount);
+            toggleBadge.classList.remove('hidden');
+        }
+    }
+    function clearBadge() {
+        badgeCount = 0;
+        if (toggleBadge) { toggleBadge.classList.add('hidden'); toggleBadge.textContent = ''; }
     }
 
     // ── Identity ──────────────────────────────────────────────
@@ -691,7 +850,6 @@ const AgentChat = (() => {
 
     // ── Init ──────────────────────────────────────────────────
     function init() {
-        fab = document.getElementById('agent-fab');
         panel = document.getElementById('agent-chat');
         log = document.getElementById('agent-chat-log');
         input = document.getElementById('agent-chat-text');
@@ -701,10 +859,27 @@ const AgentChat = (() => {
         closeBtn = document.getElementById('agent-chat-close');
         userEl = document.getElementById('agent-chat-user');
         signoutBtn = document.getElementById('agent-chat-signout');
-        if (!fab || !panel) return;  // markup not present
-
-        fab.addEventListener('click', () => togglePanel());
+        toggleBtn = document.getElementById('agent-chat-toggle');
+        pinBtn = document.getElementById('agent-chat-pin');
+        resizeEl = document.getElementById('agent-chat-resize');
+        toggleDot = document.getElementById('agent-chat-toggle-dot');
+        toggleBadge = document.getElementById('agent-chat-toggle-badge');
+        if (!panel) return;  // markup not present
+
+        restorePrefs();
+        if (toggleBtn) toggleBtn.addEventListener('click', () => togglePanel());
         closeBtn.addEventListener('click', () => togglePanel(false));
+        if (pinBtn) pinBtn.addEventListener('click', togglePin);
+        setupResize();
+        // Ctrl/Cmd+J toggles the panel from anywhere.
+        document.addEventListener('keydown', (e) => {
+            if ((e.ctrlKey || e.metaKey) && (e.key === 'j' || e.key === 'J')) {
+                e.preventDefault();              // suppress browser default (downloads) always
+                if (e.repeat) return;            // ignore held-key auto-repeat
+                if (document.activeElement === input) return;  // don't toggle while composing
+                togglePanel();
+            }
+        });
         signoutBtn.addEventListener('click', async () => {
             if (signoutBtn.dataset.action === 'login') {
                 window.location.href = '/login';
@@ -735,8 +910,24 @@ const AgentChat = (() => {
             stopBtn.title = 'Stop the current turn';
             stopBtn.addEventListener('click', () => { send({ type: 'cancel' }); setBusy(false); });
             inputWrap.appendChild(stopBtn);
+
+            // Sticky ASK-approval slot — above the queue + composer, never scrolls away.
+            pendingSlot = document.createElement('div');
+            pendingSlot.className = 'ac-pending hidden';
+            if (inputWrap.parentNode) inputWrap.parentNode.insertBefore(pendingSlot, queuePanel);
         }
 
+        // "↓ N new" jump pill + pin-to-bottom scroll tracking.
+        jumpPill = document.createElement('button');
+        jumpPill.className = 'ac-jump hidden';
+        jumpPill.addEventListener('click', jumpToBottom);
+        panel.appendChild(jumpPill);
+        log.addEventListener('scroll', () => {
+            stickBottom = nearBottom();
+            if (stickBottom) newCount = 0;
+            renderJumpPill();
+        });
+
         sendBtn.addEventListener('click', submit);
         input.addEventListener('input', () => { autosize(); updateCompletions(); });
         // Close the menu shortly after blur (delay lets a mousedown selection land).
diff --git a/gently/ui/web/static/js/projection-viewer.js b/gently/ui/web/static/js/projection-viewer.js
index 7360f2d6..0e20b9fa 100644
--- a/gently/ui/web/static/js/projection-viewer.js
+++ b/gently/ui/web/static/js/projection-viewer.js
@@ -306,6 +306,19 @@ const ProjectionViewer = {
         this.updateViewerVisibility();
     },
 
+    // Resize the WebGL canvas + camera to the container's current width.
+    // (Height is fixed at 400px; only width tracks the layout.) The animation
+    // loop handles re-rendering.
+    _resize3D() {
+        const container = document.getElementById('pv-3d-container');
+        if (!container || !this.renderer3d || !this.camera3d) return;
+        const w = container.clientWidth || 500;
+        const h = 400;
+        this.renderer3d.setSize(w, h);
+        this.camera3d.aspect = w / h;
+        this.camera3d.updateProjectionMatrix();
+    },
+
     // 3D Viewer Methods
     init3DViewer() {
         const container = document.getElementById('pv-3d-container');
@@ -327,6 +340,22 @@ const ProjectionViewer = {
         container.innerHTML = '';
         container.appendChild(this.renderer3d.domElement);
 
+        // Keep the WebGL canvas in sync with its container width — the chat
+        // panel can dock/resize and the window can resize. The animation loop
+        // re-renders every frame, so on a size change we only need to resize the
+        // renderer + camera (coalesced to one rAF). Also listen for the explicit
+        // layout-change event the chat dock fires on pin/unpin.
+        if (this._resizeObserver) this._resizeObserver.disconnect();
+        this._resizeObserver = new ResizeObserver(() => {
+            if (this._resizeRaf) cancelAnimationFrame(this._resizeRaf);
+            this._resizeRaf = requestAnimationFrame(() => this._resize3D());
+        });
+        this._resizeObserver.observe(container);
+        if (!this._onLayoutChanged) {
+            this._onLayoutChanged = () => this._resize3D();
+            window.addEventListener('gently:layout-changed', this._onLayoutChanged);
+        }
+
         // Root group is the object the user rotates. Raymarched volume
         // mesh is added here. The group scale flips Y so the image
         // orientation matches 2D projections.
@@ -617,6 +646,18 @@ const ProjectionViewer = {
             cancelAnimationFrame(this.animationId);
             this.animationId = null;
         }
+        if (this._resizeObserver) {
+            this._resizeObserver.disconnect();
+            this._resizeObserver = null;
+        }
+        if (this._resizeRaf) {
+            cancelAnimationFrame(this._resizeRaf);
+            this._resizeRaf = null;
+        }
+        if (this._onLayoutChanged) {
+            window.removeEventListener('gently:layout-changed', this._onLayoutChanged);
+            this._onLayoutChanged = null;
+        }
         // Dispose the volume cube's geometry, material, and 3D texture.
         if (this.volumeMesh) {
             this.volumeMesh.geometry?.dispose();
diff --git a/gently/ui/web/templates/_header.html b/gently/ui/web/templates/_header.html
index d8f692e0..3f113590 100644
--- a/gently/ui/web/templates/_header.html
+++ b/gently/ui/web/templates/_header.html
@@ -25,6 +25,17 @@
         <div class="presence-container" id="presence-container">
             <!-- Avatars rendered by PresenceManager -->
         </div>
+        <!-- Agent chat toggle (docked side panel) -->
+        <button class="header-agent-toggle" id="agent-chat-toggle"
+                title="Agent  (Ctrl/Cmd+J)" aria-pressed="false"
+                aria-expanded="false" aria-controls="agent-chat">
+            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"></path>
+            </svg>
+            <span class="header-agent-label">Agent</span>
+            <span class="header-agent-dot" id="agent-chat-toggle-dot" aria-hidden="true"></span>
+            <span class="header-agent-badge hidden" id="agent-chat-toggle-badge" aria-hidden="true"></span>
+        </button>
         {% endif %}
         <!-- Settings link -->
         <a href="/settings" class="header-nav-link" title="Dashboard settings">
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 528189f9..31013b1f 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -19,6 +19,10 @@
 <body>
     {% include '_header.html' %}
     {% include '_navbar.html' %}
+    <!-- App shell: main content + docked agent panel (flex row for pin-to-dock).
+         Header + navbar stay full-width above this. -->
+    <div class="app-shell">
+    <div class="app-main">
 
     <!-- Calibration Tab -->
     <div id="calibration-content" class="tab-content">
@@ -525,19 +529,23 @@ <h3 class="devices-properties-title">Properties</h3>
 
     <!-- Ambient health pulse overlay -->
     <div class="ambient-pulse" id="ambient-pulse"></div>
+    </div><!-- /.app-main -->
 
-    <!-- Floating agent chat (web-side control surface) -->
-    <button id="agent-fab" class="agent-fab" title="Chat with Gently">
-        <img src="/static/favicon.svg" alt="Gently" width="30" height="30">
-    </button>
-    <div id="agent-chat" class="agent-chat hidden">
+    <!-- Agent chat — docked side panel (overlay by default; pin to dock) -->
+    <aside id="agent-chat" class="agent-chat" aria-label="Agent chat">
+        <div class="agent-chat-resize" id="agent-chat-resize" title="Drag to resize" aria-hidden="true"></div>
         <div class="agent-chat-header">
             <div class="agent-chat-id">
-                <img class="agent-chat-mark" src="/static/favicon.svg" alt="" width="26" height="26">
-                <span class="agent-chat-title">Gently</span>
+                <img class="agent-chat-mark" src="/static/favicon.svg" alt="" width="22" height="22">
+                <span class="agent-chat-title">Agent</span>
                 <span id="agent-chat-user" class="agent-chat-user"></span>
             </div>
             <span id="agent-chat-conn" class="agent-chat-conn ac-conn-bad">Connecting…</span>
+            <button id="agent-chat-pin" class="agent-chat-pin" title="Pin to dock" aria-pressed="false">
+                <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                    <path d="M9 3v18M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z"></path>
+                </svg>
+            </button>
             <button id="agent-chat-signout" class="agent-chat-signout" title="Sign out" style="display:none">Sign out</button>
             <button id="agent-chat-close" class="agent-chat-close" title="Close">&times;</button>
         </div>
@@ -547,7 +555,8 @@ <h3 class="devices-properties-title">Properties</h3>
             <textarea id="agent-chat-text" rows="1" placeholder="Message Gently…"></textarea>
             <button id="agent-chat-send" class="agent-chat-send">Send</button>
         </div>
-    </div>
+    </aside>
+    </div><!-- /.app-shell -->
 
     <script src="/static/js/utils.js"></script>
     <script src="/static/js/event-bus.js"></script>

From 2a36834b241d880e39ed56c8b69c8613880541e7 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 20:31:22 -0400
Subject: [PATCH 057/314] Add a Home landing tab; stop the chat auto-running
 the startup wizard
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replaces the auto-popping startup wizard with a proper Home landing page (the
new default tab).

- Home tab: a scrollable landing with a 'Start / continue an experiment' button
  + a thin status line, and three at-a-glance cards — recent sessions (with
  Resume), recent plans (with progress chips), and a recent-images strip — all
  fed by existing endpoints (/api/sessions, /api/campaigns, /api/snapshots,
  /api/images/{uid}/png). New HomeApp module (mirrors ReviewApp/CampaignsApp);
  self-inits on load since it's the default tab.
- Wizard: no longer auto-pops in the chat on connect — gated behind
  server.wizard_autorun (default off). 'Start / continue an experiment' opens the
  agent panel and runs /wizard on demand; the briefing/resolution path is
  unchanged (wizard_ran still derives from wizard.needed).
- Wiring: TABS.HOME; Home is the default-active tab (navbar + panel + state.tab);
  switchTab lazy-inits HomeApp; #home in the hash-route whitelist; AgentChat now
  exposes runCommand() so Home can trigger /wizard.
- Reuses .panel/.empty-state + theme vars; namespaced .home-* styles, responsive
  grid, scroll on an inner wrapper (the panel is overflow:hidden).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py      |   9 +-
 gently/ui/web/static/css/main.css     | 108 ++++++++++++++++++
 gently/ui/web/static/js/agent-chat.js |  10 +-
 gently/ui/web/static/js/app.js        |   7 +-
 gently/ui/web/static/js/home.js       | 156 ++++++++++++++++++++++++++
 gently/ui/web/static/js/utils.js      |   2 +-
 gently/ui/web/templates/_navbar.html  |   4 +-
 gently/ui/web/templates/index.html    |  45 +++++++-
 8 files changed, 333 insertions(+), 8 deletions(-)
 create mode 100644 gently/ui/web/static/js/home.js

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index 36ca6ee5..8f3a3262 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -617,9 +617,14 @@ def _discard_choice(request_id: str) -> None:
 
         try:
             # ── Wizard phase ──────────────────────────────────────
-            # Run startup wizard (if needed) before entering the REPL.
+            # The startup wizard no longer auto-pops in the chat — setup is now
+            # launched on demand from the Home page (which sends /wizard) or via
+            # the /wizard command. Re-enable auto-run by setting
+            # server.wizard_autorun = True. NOTE: wizard_ran below is still
+            # derived from wizard.needed, so the briefing/resolution path is
+            # unaffected by this gate.
             wizard = getattr(bridge, "_wizard", None)
-            if wizard is not None and wizard.needed:
+            if wizard is not None and wizard.needed and getattr(server, "wizard_autorun", False):
                 wizard_task = await _run_wizard(
                     wizard, websocket, send_fn, _choice_futures, bridge,
                     log_transcript=_log_transcript,
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index bf36b569..fdafcc1d 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -652,6 +652,114 @@ a.tab-link.active {
     flex-direction: column;
 }
 
+/* ── Home (landing) tab ─────────────────────────────────────
+   #home-content is a flex column with overflow:hidden, so the scroll lives on
+   .home-scroll. */
+.home-scroll {
+    flex: 1 1 auto;
+    min-height: 0;
+    overflow-y: auto;
+    padding: 24px;
+    display: flex;
+    flex-direction: column;
+    gap: 20px;
+}
+.home-hero {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 16px;
+    padding: 20px 22px;
+    border: 1px solid var(--border);
+    border-radius: 14px;
+    background: var(--bg-card);
+}
+.home-hero-title { font-size: 1.35rem; font-weight: 700; color: var(--text); margin: 0; }
+.home-hero-status { font-size: 12.5px; color: var(--text-muted); margin-top: 4px; }
+.home-start-btn {
+    flex: 0 0 auto;
+    padding: 10px 18px;
+    border: none; border-radius: 10px;
+    background: var(--gradient-primary, var(--accent));
+    color: #fff; font-weight: 600; font-size: 13.5px; cursor: pointer;
+    box-shadow: var(--shadow-glow);
+    transition: transform 0.12s ease, box-shadow 0.12s ease;
+}
+.home-start-btn:hover { transform: translateY(-1px); box-shadow: var(--shadow-glow-strong); }
+
+.home-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 16px;
+}
+.home-card-wide { grid-column: 1 / -1; }
+@media (max-width: 820px) {
+    .home-grid { grid-template-columns: 1fr; }
+    .home-card-wide { grid-column: auto; }
+}
+
+.home-card {
+    display: flex; flex-direction: column;
+    padding: 14px 16px;
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    background: var(--bg-card);
+    min-height: 120px;
+}
+.home-card-head {
+    display: flex; align-items: center; justify-content: space-between;
+    margin-bottom: 10px;
+}
+.home-card-title {
+    font-size: 11px; font-weight: 600; letter-spacing: 0.06em;
+    text-transform: uppercase; color: var(--text-muted);
+}
+.home-card-link { font-size: 11.5px; color: var(--accent); text-decoration: none; }
+.home-card-link:hover { text-decoration: underline; }
+.home-card-body { display: flex; flex-direction: column; gap: 6px; }
+
+.home-item {
+    display: flex; align-items: center; justify-content: space-between; gap: 10px;
+    padding: 8px 10px; border-radius: 8px;
+    background: rgba(127, 127, 127, 0.05);
+    border: 1px solid transparent;
+}
+.home-item-clickable { cursor: pointer; }
+.home-item-clickable:hover { border-color: var(--accent); background: var(--bg-hover); }
+.home-item-main { display: flex; flex-direction: column; gap: 2px; min-width: 0; }
+.home-item-row { display: flex; align-items: center; gap: 7px; }
+.home-item-name {
+    font-size: 13px; color: var(--text); font-weight: 500;
+    white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+.home-item-meta { font-size: 11.5px; color: var(--text-muted); }
+.home-tag {
+    font-size: 9.5px; font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase;
+    padding: 1px 6px; border-radius: 999px;
+}
+.home-tag-live { color: var(--accent-green); border: 1px solid rgba(74, 222, 128, 0.4); }
+.home-resume {
+    flex: 0 0 auto;
+    padding: 4px 11px; border-radius: 7px;
+    border: 1px solid var(--accent); background: transparent; color: var(--accent);
+    font-size: 12px; font-weight: 600; cursor: pointer;
+}
+.home-resume:hover { background: var(--accent); color: #fff; }
+.home-resume:disabled { opacity: 0.6; cursor: default; }
+.home-chip {
+    flex: 0 0 auto;
+    font-size: 11px; font-weight: 600;
+    padding: 2px 8px; border-radius: 999px;
+    background: var(--bg-hover); color: var(--text-muted);
+}
+
+.home-image-strip { display: flex; gap: 8px; flex-wrap: wrap; }
+.home-image {
+    width: 84px; height: 84px; border-radius: 8px; overflow: hidden;
+    border: 1px solid var(--border); background: var(--img-bg); flex: 0 0 auto;
+}
+.home-image img { width: 100%; height: 100%; object-fit: cover; display: block; }
+
 /* Live View - Clean full-width layout */
 .live-view {
     display: flex;
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 6b456955..170353c3 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -952,5 +952,13 @@ const AgentChat = (() => {
 
     document.addEventListener('DOMContentLoaded', init);
 
-    return { togglePanel };
+    // Public: programmatically send a message/command (e.g. the Home page's
+    // "Start / continue an experiment" button sends '/wizard').
+    function runCommand(text) {
+        if (!text) return;
+        if (!hasControl) { renderControl(); return; }
+        actuallySend(text);
+    }
+
+    return { togglePanel, runCommand };
 })();
diff --git a/gently/ui/web/static/js/app.js b/gently/ui/web/static/js/app.js
index 203cea04..d1e75a72 100644
--- a/gently/ui/web/static/js/app.js
+++ b/gently/ui/web/static/js/app.js
@@ -6,7 +6,7 @@
 const state = {
     ws: null,
     connected: false,
-    tab: TABS.EMBRYOS,  // Default to Embryos tab
+    tab: TABS.HOME,  // Default to the Home landing tab
     snapshots: [],
     calibration: [],
     embryos: [],
@@ -71,6 +71,9 @@ function switchTab(tabName) {
     const content = document.getElementById(`${tabName}-content`);
     if (content) content.classList.add('active');
 
+    // Lazy-init Home landing tab
+    if (tabName === TABS.HOME && typeof HomeApp !== 'undefined') HomeApp.init();
+
     // Render galleries
     if (tabName === TABS.CALIBRATION) renderCalibrationGallery();
     if (tabName === TABS.EVENTS) renderEventsTable();
@@ -631,7 +634,7 @@ document.addEventListener('DOMContentLoaded', () => {
     const hash = window.location.hash.slice(1); // remove #
     if (hash) {
         const [tab, param] = hash.split(':');
-        if (tab === TABS.PLANS || tab === TABS.SESSIONS || tab === TABS.EMBRYOS || tab === TABS.CALIBRATION || tab === TABS.EVENTS || tab === TABS.EXPERIMENT) {
+        if (tab === TABS.HOME || tab === TABS.PLANS || tab === TABS.SESSIONS || tab === TABS.EMBRYOS || tab === TABS.CALIBRATION || tab === TABS.EVENTS || tab === TABS.EXPERIMENT) {
             switchTab(tab);
             if (tab === TABS.PLANS && param && typeof openCampaign === 'function') {
                 setTimeout(() => openCampaign(param), 200);
diff --git a/gently/ui/web/static/js/home.js b/gently/ui/web/static/js/home.js
new file mode 100644
index 00000000..54adadd9
--- /dev/null
+++ b/gently/ui/web/static/js/home.js
@@ -0,0 +1,156 @@
+/**
+ * HomeApp — the landing tab.
+ *
+ * A light at-a-glance landing surface: recent sessions, recent plans, recent
+ * images, a thin status line, and a "Start / continue an experiment" button
+ * that launches the setup flow (the wizard, which no longer auto-pops in chat).
+ *
+ * Read-only fetches against existing endpoints (/api/sessions, /api/campaigns,
+ * /api/snapshots); mirrors the ReviewApp/CampaignsApp module pattern.
+ */
+const HomeApp = (() => {
+    let _inited = false;
+    const SESSIONS_N = 5;
+    const CAMPAIGNS_N = 5;
+    const IMAGES_N = 8;
+
+    function relTime(iso) {
+        if (!iso) return '';
+        const t = Date.parse(iso);
+        if (isNaN(t)) return '';
+        const s = Math.max(0, (Date.now() - t) / 1000);
+        if (s < 60) return 'just now';
+        if (s < 3600) return `${Math.floor(s / 60)}m ago`;
+        if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+        const d = Math.floor(s / 86400);
+        return d < 30 ? `${d}d ago` : new Date(t).toLocaleDateString();
+    }
+
+    function empty(el, msg) {
+        el.innerHTML = `<div class="empty-state">${escapeHtml(msg)}</div>`;
+    }
+
+    function wireGoTab(scope) {
+        (scope || document).querySelectorAll('[data-go-tab]').forEach(el => {
+            if (el._goWired) return;
+            el._goWired = true;
+            el.addEventListener('click', (e) => {
+                e.preventDefault();
+                if (typeof switchTab === 'function') switchTab(el.dataset.goTab);
+            });
+        });
+    }
+
+    async function loadSessions() {
+        const el = document.getElementById('home-recent-sessions');
+        if (!el) return;
+        try {
+            const data = await (await fetch('/api/sessions')).json();
+            const sessions = (data.sessions || []).slice(0, SESSIONS_N);
+            if (!sessions.length) { empty(el, 'No sessions yet.'); return; }
+            el.innerHTML = sessions.map(s => {
+                const live = s.active ? '<span class="home-tag home-tag-live">live</span>' : '';
+                const resume = s.active ? '' :
+                    `<button class="home-resume" data-resume="${escapeHtml(s.session_id)}">Resume</button>`;
+                return `<div class="home-item">
+                    <div class="home-item-main">
+                        <div class="home-item-row"><span class="home-item-name">${escapeHtml(s.name || s.session_id)}</span>${live}</div>
+                        <span class="home-item-meta">${escapeHtml(relTime(s.last_active))} · ${s.embryo_count || 0} embryos</span>
+                    </div>${resume}
+                </div>`;
+            }).join('');
+            el.querySelectorAll('[data-resume]').forEach(b => b.addEventListener('click', async () => {
+                b.disabled = true;
+                b.textContent = 'Resuming…';
+                try {
+                    await fetch(`/api/sessions/${encodeURIComponent(b.dataset.resume)}/resume`, { method: 'POST' });
+                } catch (_) { b.disabled = false; b.textContent = 'Resume'; }
+            }));
+        } catch (e) { empty(el, 'Could not load sessions.'); }
+    }
+
+    async function loadCampaigns() {
+        const el = document.getElementById('home-recent-campaigns');
+        if (!el) return;
+        try {
+            const data = await (await fetch('/api/campaigns')).json();
+            const items = (data.campaigns || []).slice(0, CAMPAIGNS_N);
+            if (!items.length) { empty(el, 'No plans yet.'); return; }
+            el.innerHTML = items.map(t => {
+                const c = t.campaign || {};
+                const st = t.status || {};
+                const name = c.shorthand || c.description || 'Untitled plan';
+                const total = st.total || 0;
+                const chip = total ? `<span class="home-chip">${st.completed || 0}/${total} done</span>` : '';
+                return `<div class="home-item home-item-clickable" data-go-tab="plans">
+                    <span class="home-item-name">${escapeHtml(name)}</span>${chip}
+                </div>`;
+            }).join('');
+            wireGoTab(el);
+        } catch (e) { empty(el, 'Could not load plans.'); }
+    }
+
+    async function loadImages() {
+        const el = document.getElementById('home-recent-images');
+        if (!el) return;
+        try {
+            const data = await (await fetch('/api/snapshots')).json();
+            // /api/snapshots is timestamp-ASCENDING; take the tail for "recent".
+            const recent = (data.snapshots || []).slice(-IMAGES_N).reverse();
+            if (!recent.length) {
+                empty(el, 'No images yet — they appear once a session is active.');
+                return;
+            }
+            el.innerHTML = '<div class="home-image-strip">' + recent.map(s => {
+                const m = s.metadata || {};
+                const label = m.embryo_id
+                    ? `${m.embryo_id}${m.timepoint != null ? ' · t' + m.timepoint : ''}` : '';
+                return `<div class="home-image" title="${escapeHtml(label)}">
+                    <img loading="lazy" src="/api/images/${encodeURIComponent(s.uid)}/png?size=96" alt="${escapeHtml(label)}">
+                </div>`;
+            }).join('') + '</div>';
+        } catch (e) { empty(el, 'Could not load images.'); }
+    }
+
+    function updateStatus() {
+        const el = document.getElementById('home-status');
+        if (!el) return;
+        const connected = (typeof state !== 'undefined' && state.connected);
+        const n = (typeof state !== 'undefined' && Array.isArray(state.embryos)) ? state.embryos.length : 0;
+        el.textContent = connected
+            ? `Connected · ${n} embryo${n === 1 ? '' : 's'} in view`
+            : 'Offline — start the agent to connect.';
+    }
+
+    function refresh() {
+        updateStatus();
+        loadSessions();
+        loadCampaigns();
+        loadImages();
+    }
+
+    function init() {
+        if (!_inited) {
+            _inited = true;
+            wireGoTab(document.getElementById('home-content'));
+            const start = document.getElementById('home-start-btn');
+            if (start) start.addEventListener('click', () => {
+                if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
+                    AgentChat.togglePanel(true);
+                    // Let the panel's WS connect before sending the command.
+                    if (AgentChat.runCommand) setTimeout(() => AgentChat.runCommand('/wizard'), 250);
+                }
+            });
+        }
+        refresh();  // re-fetch on every entry to the tab
+    }
+
+    // Self-initialise on load when Home is the default-active tab (switchTab's
+    // lazy-init hook only fires on a tab click / hash route, not initial paint).
+    document.addEventListener('DOMContentLoaded', () => {
+        const home = document.getElementById('home-content');
+        if (home && home.classList.contains('active')) init();
+    });
+
+    return { init, refresh };
+})();
diff --git a/gently/ui/web/static/js/utils.js b/gently/ui/web/static/js/utils.js
index b0e6d2ac..4b8ff62b 100644
--- a/gently/ui/web/static/js/utils.js
+++ b/gently/ui/web/static/js/utils.js
@@ -3,7 +3,7 @@
 // ══════════════════════════════════════════════════════════
 
 // Tab and view name constants
-const TABS = { EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment' };
+const TABS = { HOME: 'home', EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment' };
 
 /**
  * HTML-escape a string (safe for insertion into innerHTML).
diff --git a/gently/ui/web/templates/_navbar.html b/gently/ui/web/templates/_navbar.html
index 821c8710..33d5f675 100644
--- a/gently/ui/web/templates/_navbar.html
+++ b/gently/ui/web/templates/_navbar.html
@@ -2,7 +2,8 @@
 <div class="tabs">
     {% if is_live %}
     {# SPA tabs — JS-driven via switchTab() in app.js #}
-    <div class="tab active" data-tab="embryos">
+    <div class="tab active" data-tab="home">Home</div>
+    <div class="tab" data-tab="embryos">
         Embryos
         <span class="tab-badge" id="embryos-count">0</span>
     </div>
@@ -24,6 +25,7 @@
     <div class="tab" data-tab="sessions">Sessions</div>
     {% else %}
     {# Standalone pages — all tabs link back to the SPA #}
+    <a href="/" class="tab tab-link">Home</a>
     <a href="/" class="tab tab-link">Embryos</a>
     <a href="/" class="tab tab-link">Calibration</a>
     <a href="/" class="tab tab-link">System</a>
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 31013b1f..e8164eca 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -25,6 +25,48 @@
     <div class="app-main">
 
     <!-- Calibration Tab -->
+    <!-- Home Tab (landing) -->
+    <div id="home-content" class="tab-content active">
+        <div class="home-scroll">
+            <div class="home-hero">
+                <div class="home-hero-text">
+                    <h2 class="home-hero-title">Welcome to Gently</h2>
+                    <div class="home-hero-status" id="home-status">Connecting…</div>
+                </div>
+                <button class="home-start-btn" id="home-start-btn">Start / continue an experiment</button>
+            </div>
+            <div class="home-grid">
+                <div class="panel home-card">
+                    <div class="home-card-head">
+                        <span class="home-card-title">Recent sessions</span>
+                        <a href="#sessions" class="home-card-link" data-go-tab="sessions">All</a>
+                    </div>
+                    <div class="home-card-body" id="home-recent-sessions">
+                        <div class="empty-state">Loading…</div>
+                    </div>
+                </div>
+                <div class="panel home-card">
+                    <div class="home-card-head">
+                        <span class="home-card-title">Recent plans</span>
+                        <a href="#plans" class="home-card-link" data-go-tab="plans">All</a>
+                    </div>
+                    <div class="home-card-body" id="home-recent-campaigns">
+                        <div class="empty-state">Loading…</div>
+                    </div>
+                </div>
+                <div class="panel home-card home-card-wide">
+                    <div class="home-card-head">
+                        <span class="home-card-title">Recent images</span>
+                        <a href="#embryos" class="home-card-link" data-go-tab="embryos">All</a>
+                    </div>
+                    <div class="home-card-body" id="home-recent-images">
+                        <div class="empty-state">No images yet — they appear once a session is active.</div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
     <div id="calibration-content" class="tab-content">
         <div class="calibration-header-bar">
             <h2 class="calibration-title">Calibration</h2>
@@ -127,7 +169,7 @@ <h2 class="calibration-title">Calibration</h2>
     </div>
 
     <!-- Embryos Tab (default landing page) -->
-    <div id="embryos-content" class="tab-content active">
+    <div id="embryos-content" class="tab-content">
         <!-- Subtab bar -->
         <div class="embryos-subtab-bar">
             <div class="embryos-subtab active" data-subtab="monitoring" onclick="MarkingManager.switchSubtab('monitoring')">Monitoring</div>
@@ -576,6 +618,7 @@ <h3 class="devices-properties-title">Properties</h3>
     <!-- Three.js for 3D volume viewer -->
     <script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>
     <script src="/static/js/app.js"></script>
+    <script src="/static/js/home.js"></script>
     <script src="/static/js/campaigns.js"></script>
     <script src="/static/js/review.js"></script>
     <script src="/static/js/agent-chat.js"></script>

From befe98e2045678b5205cc7ffabf988ef9131f0f1 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 20:38:10 -0400
Subject: [PATCH 058/314] =?UTF-8?q?Cache=20YAML=20parses=20in=20FileContex?=
 =?UTF-8?q?tStore=20=E2=80=94=20fixes=20slow=20Plans/campaign=20loading?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

_build_campaign_tree calls get_subcampaigns (reads every campaign.yaml) and
get_plan_status -> get_plan_items(include_children) -> _get_campaign_tree_ids
(re-scans every campaign.yaml) per node, so listing/opening campaigns re-parsed
the same YAML files O(N^2)+ times per request. The new Home tab made
/api/campaigns fire on every page load, compounding it.

Add a parse cache to _read_yaml keyed by (mtime, size): repeated reads of the
same file return a deepcopy of the cached parse instead of re-opening +
re-parsing. Auto-invalidated when a file's mtime/size changes (incl. external
writes) and explicitly on _write_yaml. Every return is a deepcopy, so callers
that mutate raw plan-item lists (update/delete) can't corrupt the cache.
Collapses the tree build from O(N^2) YAML parses to O(N) parses + cheap
stat/deepcopy. Verified: deepcopy isolation, write- and mtime-invalidation,
missing-file.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/memory/file_store.py | 32 +++++++++++++++++++++--------
 1 file changed, 24 insertions(+), 8 deletions(-)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 84beebf2..f8f797bb 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -28,6 +28,7 @@
         assessments/{id}.yaml
 """
 
+import copy
 import dataclasses
 import json
 import logging
@@ -106,6 +107,11 @@ class FileContextStore:
     def __init__(self, agent_dir: Path):
         self.agent_dir = Path(agent_dir)
         self._ensure_dirs()
+        # YAML parse cache: str(path) -> ((mtime, size), parsed). Collapses the
+        # O(N^2) re-parsing in campaign-tree builds; auto-invalidated by file
+        # mtime/size changes and explicitly on _write_yaml. Set BEFORE the index
+        # rebuild below, which reads YAML through the cache.
+        self._yaml_cache: Dict[str, tuple] = {}
         # In-memory index: campaign_id -> folder Path
         self._campaign_index: Dict[str, Path] = {}
         self._rebuild_campaign_index()
@@ -177,22 +183,32 @@ def _write_yaml(self, path: Path, data):
             yaml.dump(data, fh, Dumper=_ISODumper, default_flow_style=False,
                        allow_unicode=True, sort_keys=False)
         # Atomic rename (on Windows this replaces the target).
-        if os.name == "nt":
-            # os.replace is atomic on Windows when on same volume.
-            os.replace(str(tmp), str(path))
-        else:
-            os.replace(str(tmp), str(path))
+        os.replace(str(tmp), str(path))
+        # Invalidate the parse cache so the next read reloads (new mtime anyway).
+        self._yaml_cache.pop(str(path), None)
 
     def _read_yaml(self, path: Path):
-        """Read a YAML file; return None if missing or empty."""
-        if not path.exists():
+        """Read a YAML file, parse-cached by (mtime, size). Returns None if
+        missing or empty. The cached object is never handed out directly — every
+        return is a deepcopy — so callers may freely mutate the result without
+        corrupting the cache."""
+        try:
+            st = path.stat()
+        except OSError:
             return None
+        key = str(path)
+        sig = (st.st_mtime, st.st_size)
+        cached = self._yaml_cache.get(key)
+        if cached is not None and cached[0] == sig:
+            return copy.deepcopy(cached[1])
         try:
             with open(path, "r", encoding="utf-8") as fh:
-                return yaml.safe_load(fh)
+                data = yaml.safe_load(fh)
         except Exception:
             logger.warning(f"Failed to read {path}", exc_info=True)
             return None
+        self._yaml_cache[key] = (sig, data)
+        return copy.deepcopy(data)
 
     def _append_jsonl(self, path: Path, record: dict):
         """Append one JSON line to a file."""

From 9369407619d1291e143cf8b646544bc95e9d2613 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 20:56:08 -0400
Subject: [PATCH 059/314] Home: recent images aggregated across previous
 sessions

The home "recent images" card previously read /api/snapshots, which is the
in-memory ImageStore for the *current* session only -- so a freshly opened UI
showed nothing until the live session captured volumes. Pull from the
FileStore on disk instead so it reflects imagery from previous sessions.

New routes (gently/ui/web/routes/sessions.py):
  - GET /api/home/recent-images  -- latest projection per embryo across the
    most-recent sessions. Cheap by construction: session IDs from folder names
    (no session.yaml parse), embryo IDs from directory names (no embryo.yaml
    parse), timepoints from a filename glob (no pixel decode), and the walk
    stops as soon as `limit` images are collected. limit/sessions are clamped
    on both ends so a crafted query cannot turn this unauthenticated read into
    a full-disk scan.
  - GET /api/sessions/{id}/projection  -- serves any saved session's JPEG
    projection, with a component-wise path-traversal guard (the resolved file
    must be a child of the session dir; not str.startswith, which a sibling
    like `<dir>_evil` would slip through).

Cheap FileStore helpers (gently/core/file_store.py):
  - recent_session_ids(limit) -- newest-first by folder date prefix, no YAML.
  - list_embryo_ids(session) -- IDs from directory names, no embryo.yaml read.

home.js loadImages() now fetches the aggregator and builds encoded thumbnail
URLs, with an in-flight + 15s TTL guard so re-entering the Home tab does not
re-walk the disk on every visit.

Verified with a synthetic on-disk store (helpers, aggregation ordering +
short-circuit + clamps, and the traversal-guard predicate including the
sibling-prefix case). Findings from an adversarial review (missing upper-bound
clamp, no early short-circuit, per-embryo YAML parse, redundant fetches) are
all addressed here.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/core/file_store.py        | 31 +++++++++++
 gently/ui/web/routes/sessions.py | 92 ++++++++++++++++++++++++++++++++
 gently/ui/web/static/js/home.js  | 45 +++++++++++-----
 3 files changed, 156 insertions(+), 12 deletions(-)

diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 4b33dedd..e4f14009 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -388,6 +388,21 @@ def list_sessions(self) -> List[SessionInfo]:
         sessions.sort(key=lambda s: s.get("last_active", ""), reverse=True)
         return sessions
 
+    def recent_session_ids(self, limit: int = 8) -> List[str]:
+        """Most-recent session IDs by folder-name date prefix, *cheaply*.
+
+        Folder names are ``{YYYYMMDD}_{HHMM}_{slug}_{id8}`` so a reverse lexical
+        sort of the index orders them newest-first by creation time — no
+        ``session.yaml`` parse required. This is a creation-recency proxy (a
+        long-dormant session that was just resumed sorts by its original date),
+        which is fine for at-a-glance landing views; use ``list_sessions`` when
+        exact ``last_active`` ordering matters.
+        """
+        items = sorted(self._index.items(), key=lambda kv: kv[1], reverse=True)
+        if limit and limit > 0:
+            items = items[:limit]
+        return [sid for sid, _ in items]
+
     def touch_session(self, session_id: str) -> None:
         """Update last_active timestamp."""
         sd = self._session_dir(session_id)
@@ -562,6 +577,22 @@ def list_embryos(self, session_id: str) -> List[EmbryoInfo]:
                     result.append(_normalize_embryo_record(data))
         return result
 
+    def list_embryo_ids(self, session_id: str) -> List[str]:
+        """Embryo IDs from directory names only — no ``embryo.yaml`` parse.
+
+        The directory name *is* the embryo_id in this layout (see
+        ``_embryo_dir`` / ``put_embryo``), so callers that only need the ids
+        (e.g. enumerating projections) can skip the per-embryo YAML read that
+        ``list_embryos`` pays.
+        """
+        sd = self._session_dir(session_id)
+        if sd is None:
+            return []
+        embryos_dir = sd / "embryos"
+        if not embryos_dir.exists():
+            return []
+        return [e.name for e in sorted(embryos_dir.iterdir()) if e.is_dir()]
+
     # ==================================================================
     # Volumes
     # ==================================================================
diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index 58f3394d..09f3bd25 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -1,8 +1,10 @@
 """Session routes - list, retrieve, and resume saved sessions."""
 
 import logging
+from pathlib import Path
 
 from fastapi import APIRouter, Depends, HTTPException
+from fastapi.responses import FileResponse
 
 from gently.ui.web.auth import require_control
 
@@ -54,6 +56,96 @@ async def list_sessions():
             logger.warning("Failed to list sessions from FileStore: %s", e)
         return {"sessions": sessions}
 
+    @router.get("/api/home/recent-images")
+    async def recent_images(limit: int = 8, sessions: int = 6):
+        """Latest projection per embryo, aggregated across recent sessions.
+
+        Unlike /api/snapshots (in-memory, current session only), this walks the
+        FileStore on disk so the home page can show imagery from *previous*
+        sessions. Cheap by construction: recent session IDs come from folder
+        names (no session.yaml parse), embryo IDs from directory names (no
+        embryo.yaml parse), timepoints from a filename glob (no pixel decode),
+        and the walk stops as soon as `limit` images are collected. Bounds are
+        clamped so a crafted ?sessions=/?limit= can't turn this unauthenticated
+        read into a full-disk scan. Returns components; the client builds the
+        (encoded) image URL.
+        """
+        store = _file_store()
+        if store is None:
+            return {"images": []}
+        limit = max(1, min(int(limit), 48))
+        sessions = max(1, min(int(sessions), 24))
+        out = []
+        try:
+            for sid in (store.recent_session_ids(sessions) or []):
+                try:
+                    eids = store.list_embryo_ids(sid)
+                except Exception:
+                    eids = []
+                sname = None  # parsed lazily, only if this session contributes
+                for eid in eids:
+                    try:
+                        tps = store.list_projection_timepoints(sid, eid) or []
+                    except Exception:
+                        tps = []
+                    if not tps:
+                        continue
+                    if sname is None:
+                        try:
+                            info = store.get_session(sid)
+                        except Exception:
+                            info = None
+                        sname = (info.get("name") if info else None) or sid
+                    out.append({
+                        "session_id": sid,
+                        "session_name": sname,
+                        "embryo_id": eid,
+                        "timepoint": int(max(tps)),
+                    })
+                    if len(out) >= limit:
+                        break
+                if len(out) >= limit:
+                    break
+        except Exception as e:
+            logger.warning("recent_images failed: %s", e)
+        return {"images": out[:limit]}
+
+    @router.get("/api/sessions/{session_id}/projection")
+    async def get_session_projection(session_id: str, embryo: str, t: int):
+        """Serve a saved JPEG projection from any session on disk.
+
+        Path-traversal safe: the resolved file must live inside the session's
+        own directory, so a crafted `embryo` (e.g. '../..') can't escape.
+        """
+        store = _file_store()
+        if store is None:
+            raise HTTPException(status_code=503, detail="Store not available")
+        path = store.get_projection_path(session_id, embryo, t)
+        if path is None:
+            raise HTTPException(status_code=404, detail="Projection not found")
+        try:
+            sd = store._session_dir(session_id)
+            resolved = Path(path).resolve()
+            # Component-wise ancestor check (not str.startswith, which would
+            # let a sibling like `<sd>_evil` slip through the prefix match).
+            sd_resolved = Path(sd).resolve() if sd is not None else None
+            if sd_resolved is None or sd_resolved not in resolved.parents:
+                raise HTTPException(status_code=404, detail="Not found")
+        except HTTPException:
+            raise
+        except Exception:
+            raise HTTPException(status_code=404, detail="Not found")
+        try:
+            st = resolved.stat()
+            etag = f'"{int(st.st_mtime)}-{st.st_size}"'
+        except OSError:
+            etag = None
+        headers = {"Cache-Control": "private, max-age=60"}
+        if etag:
+            headers["ETag"] = etag
+        return FileResponse(str(resolved), media_type="image/jpeg",
+                            headers=headers)
+
     @router.post("/api/sessions/{session_id}/resume",
                  dependencies=[Depends(require_control)])
     async def resume_session(session_id: str):
diff --git a/gently/ui/web/static/js/home.js b/gently/ui/web/static/js/home.js
index 54adadd9..089d7de3 100644
--- a/gently/ui/web/static/js/home.js
+++ b/gently/ui/web/static/js/home.js
@@ -6,13 +6,18 @@
  * that launches the setup flow (the wizard, which no longer auto-pops in chat).
  *
  * Read-only fetches against existing endpoints (/api/sessions, /api/campaigns,
- * /api/snapshots); mirrors the ReviewApp/CampaignsApp module pattern.
+ * /api/home/recent-images); mirrors the ReviewApp/CampaignsApp module pattern.
  */
 const HomeApp = (() => {
     let _inited = false;
     const SESSIONS_N = 5;
     const CAMPAIGNS_N = 5;
     const IMAGES_N = 8;
+    // Recent images are stable (latest projection per embryo). refresh() runs on
+    // every Home-tab entry, so guard against redundant disk-walking fetches:
+    // skip if one is in flight or the strip was loaded within IMAGES_TTL_MS.
+    const IMAGES_TTL_MS = 15000;
+    let _imgState = { at: 0, inflight: false };
 
     function relTime(iso) {
         if (!iso) return '';
@@ -90,26 +95,42 @@ const HomeApp = (() => {
         } catch (e) { empty(el, 'Could not load plans.'); }
     }
 
-    async function loadImages() {
+    async function loadImages(force) {
         const el = document.getElementById('home-recent-images');
         if (!el) return;
+        if (_imgState.inflight) return;
+        // _imgState.at is set only after a completed fetch (images or empty),
+        // never after an error — so failures still retry on the next entry.
+        if (!force && _imgState.at && (Date.now() - _imgState.at) < IMAGES_TTL_MS) return;
+        _imgState.inflight = true;
         try {
-            const data = await (await fetch('/api/snapshots')).json();
-            // /api/snapshots is timestamp-ASCENDING; take the tail for "recent".
-            const recent = (data.snapshots || []).slice(-IMAGES_N).reverse();
+            const data = await (await fetch(`/api/home/recent-images?limit=${IMAGES_N}`)).json();
+            // Latest projection per embryo across recent sessions (server orders
+            // most-recent session first).
+            const recent = (data.images || []).slice(0, IMAGES_N);
             if (!recent.length) {
-                empty(el, 'No images yet — they appear once a session is active.');
+                empty(el, 'No images yet — they appear once a session has captured volumes.');
+                _imgState.at = Date.now();
                 return;
             }
             el.innerHTML = '<div class="home-image-strip">' + recent.map(s => {
-                const m = s.metadata || {};
-                const label = m.embryo_id
-                    ? `${m.embryo_id}${m.timepoint != null ? ' · t' + m.timepoint : ''}` : '';
-                return `<div class="home-image" title="${escapeHtml(label)}">
-                    <img loading="lazy" src="/api/images/${encodeURIComponent(s.uid)}/png?size=96" alt="${escapeHtml(label)}">
+                const tp = (s.timepoint != null) ? ` · t${s.timepoint}` : '';
+                const label = `${s.embryo_id || ''}${tp}`;
+                const sub = s.session_name && s.session_name !== s.session_id
+                    ? ` (${s.session_name})` : '';
+                const src = `/api/sessions/${encodeURIComponent(s.session_id)}`
+                    + `/projection?embryo=${encodeURIComponent(s.embryo_id)}`
+                    + `&t=${encodeURIComponent(s.timepoint)}`;
+                return `<div class="home-image" title="${escapeHtml(label + sub)}">
+                    <img loading="lazy" src="${src}" alt="${escapeHtml(label)}">
                 </div>`;
             }).join('') + '</div>';
-        } catch (e) { empty(el, 'Could not load images.'); }
+            _imgState.at = Date.now();
+        } catch (e) {
+            empty(el, 'Could not load images.');
+        } finally {
+            _imgState.inflight = false;
+        }
     }
 
     function updateStatus() {

From 7d877ba51daa470791a89f0f55fdeb873314f6cb Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 20:57:06 -0400
Subject: [PATCH 060/314] Login: non-blocking page with a "Continue in
 view-only" escape hatch

The /login page was a dead end: once a viewer landed there (via the chat
window's "Sign in" button, a bookmark, or a redirect) the only way forward was
valid credentials. Viewing is already open to everyone at / (index serves the
SPA in view mode; signing in is an *elevation* to control, not a gate), so the
login page should offer the same choice.

Add a clearly-secondary "Continue without signing in ->" action beneath the
Sign in button that drops straight into view-only mode, with a one-line note
that you can sign in any time to take control. The subtitle now frames both
paths. Only rendered when accounts are configured (otherwise /login already
redirects to /).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/templates/login.html | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/gently/ui/web/templates/login.html b/gently/ui/web/templates/login.html
index 9f893995..62e5ec98 100644
--- a/gently/ui/web/templates/login.html
+++ b/gently/ui/web/templates/login.html
@@ -46,6 +46,25 @@
         button:hover:not(:disabled) { background: var(--accent-hover); }
         button:disabled { opacity: 0.6; cursor: default; }
         .error { color: var(--danger); font-size: 13px; margin-top: 14px; min-height: 18px; }
+        .divider {
+            display: flex; align-items: center; gap: 10px;
+            margin: 18px 0 0; color: var(--text-muted);
+            font-size: 12px; text-transform: uppercase; letter-spacing: 0.06em;
+        }
+        .divider::before, .divider::after {
+            content: ""; flex: 1; height: 1px; background: var(--border);
+        }
+        .ghost {
+            display: block; width: 100%; margin-top: 14px; padding: 10px;
+            text-align: center; border: 1px solid var(--border);
+            border-radius: 9px; background: transparent; color: var(--text);
+            font-size: 13.5px; font-weight: 500; text-decoration: none;
+        }
+        .ghost:hover { border-color: var(--accent); color: var(--accent-hover); }
+        .alt-note {
+            margin: 12px 0 0; color: var(--text-muted);
+            font-size: 12px; line-height: 1.5; text-align: center;
+        }
     </style>
 </head>
 <body>
@@ -54,13 +73,16 @@
             <img src="/static/favicon.svg" alt="" width="30" height="30">
             <h1>Gently</h1>
         </div>
-        <p class="sub">Sign in to control the microscope.</p>
+        <p class="sub">Sign in to control the microscope — or keep watching in view-only mode.</p>
         <label for="username">Username</label>
         <input id="username" name="username" type="text" autocomplete="username" autofocus required>
         <label for="password">Password</label>
         <input id="password" name="password" type="password" autocomplete="current-password" required>
         <button type="submit" id="submit">Sign in</button>
         <div class="error" id="error"></div>
+        <div class="divider">or</div>
+        <a class="ghost" href="/">Continue without signing in →</a>
+        <p class="alt-note">View-only: watch live sessions and imagery. You can sign in any time to take control.</p>
     </form>
     <script>
         const form = document.getElementById('login-form');

From 596edd3e8bc4bf7d116fb258a3443bb71cb98134 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 21:06:22 -0400
Subject: [PATCH 061/314] Home: recent-images was starved by empty trailing
 sessions

The aggregator scanned only the newest 6 sessions, but a rig accrues many
no-capture/aborted sessions at the head (on this store the 12 newest had zero
embryos while older ones held thousands of projections), so the home "recent
images" card came up empty even though previous sessions had imagery.

Treat the session count as a *scan budget* rather than a hard window: walk
most-recent sessions, skip empty ones (one iterdir each, nearly free), and
stop as soon as `limit` images are collected. Default budget raised 6 -> 200
(clamped <= 500) so the walk reaches the older image-bearing sessions. Verified
against the live store: scan=6 returned 0 images, scan=200 returns 8 across the
two most-recent sessions that actually have projections.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/sessions.py | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index 09f3bd25..310ae9cf 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -57,7 +57,7 @@ async def list_sessions():
         return {"sessions": sessions}
 
     @router.get("/api/home/recent-images")
-    async def recent_images(limit: int = 8, sessions: int = 6):
+    async def recent_images(limit: int = 8, scan: int = 200):
         """Latest projection per embryo, aggregated across recent sessions.
 
         Unlike /api/snapshots (in-memory, current session only), this walks the
@@ -65,19 +65,24 @@ async def recent_images(limit: int = 8, sessions: int = 6):
         sessions. Cheap by construction: recent session IDs come from folder
         names (no session.yaml parse), embryo IDs from directory names (no
         embryo.yaml parse), timepoints from a filename glob (no pixel decode),
-        and the walk stops as soon as `limit` images are collected. Bounds are
-        clamped so a crafted ?sessions=/?limit= can't turn this unauthenticated
-        read into a full-disk scan. Returns components; the client builds the
-        (encoded) image URL.
+        and the walk stops as soon as `limit` images are collected.
+
+        `scan` is the *budget* of most-recent sessions to walk while hunting for
+        images, NOT a hard window — empty/aborted sessions (common at the head:
+        a rig accrues many no-capture sessions) are skipped nearly for free
+        (one iterdir each), so the default is generous enough to reach older
+        sessions that actually hold projections. Both bounds are clamped so a
+        crafted ?scan=/?limit= can't turn this unauthenticated read into an
+        unbounded scan. Returns components; the client builds the (encoded) URL.
         """
         store = _file_store()
         if store is None:
             return {"images": []}
         limit = max(1, min(int(limit), 48))
-        sessions = max(1, min(int(sessions), 24))
+        scan = max(1, min(int(scan), 500))
         out = []
         try:
-            for sid in (store.recent_session_ids(sessions) or []):
+            for sid in (store.recent_session_ids(scan) or []):
                 try:
                     eids = store.list_embryo_ids(sid)
                 except Exception:

From f64406ffe95d688039eeb992891dc300f46141ef Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 21:08:00 -0400
Subject: [PATCH 062/314] Chat: wider default and a roomier resize ceiling

The agent panel showed reasoning, tool calls, approvals and pickers in a 384px
column with a hard max of min(560, 45vw) -- so even dragging the handle fully,
content was capped at 560px and wrapped badly. Widen the defaults: default
384 -> 460px, ceiling min(560,45vw) -> min(760, 60vw) (~half the viewport).
Min stays 320px; double-click still snaps to the default; persisted widths are
untouched. Default factored into CHAT_DEFAULT_W and mirrored in the CSS
fallback.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/agent-chat.css |  2 +-
 gently/ui/web/static/js/agent-chat.js   | 10 +++++++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index afbbb893..fdaaa8e3 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -38,7 +38,7 @@
 .agent-chat {
     position: absolute;
     top: 0; right: 0; bottom: 0;
-    width: var(--chat-w, 384px);
+    width: var(--chat-w, 460px);
     max-width: 92vw;
     display: flex;
     flex-direction: column;
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 170353c3..63339b92 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -718,7 +718,11 @@ const AgentChat = (() => {
 
     // ── Layout: dock, resize, persistence ─────────────────────
     const CHAT_MIN_W = 320;
-    function chatMaxW() { return Math.min(560, Math.round(window.innerWidth * 0.45)); }
+    const CHAT_DEFAULT_W = 460;
+    // Roomy ceiling: the panel shows agent reasoning, tool calls, approvals and
+    // pickers — content that wraps badly in a narrow column — so allow up to
+    // ~half the viewport (was min(560, 45vw), which capped power users too low).
+    function chatMaxW() { return Math.min(760, Math.round(window.innerWidth * 0.60)); }
 
     function emitLayoutChanged() {
         // Let the CSS settle, then notify viewers (e.g. the 3D canvas) to resize.
@@ -726,7 +730,7 @@ const AgentChat = (() => {
     }
 
     function curChatWidth() {
-        return parseInt(getComputedStyle(document.documentElement).getPropertyValue('--chat-w')) || 384;
+        return parseInt(getComputedStyle(document.documentElement).getPropertyValue('--chat-w')) || CHAT_DEFAULT_W;
     }
 
     function setChatWidth(px, persist) {
@@ -795,7 +799,7 @@ const AgentChat = (() => {
             resizeEl.addEventListener('pointerup', onUp);
             resizeEl.addEventListener('pointercancel', onUp);
         });
-        resizeEl.addEventListener('dblclick', () => { setChatWidth(384, true); emitLayoutChanged(); });
+        resizeEl.addEventListener('dblclick', () => { setChatWidth(CHAT_DEFAULT_W, true); emitLayoutChanged(); });
     }
 
     function restorePrefs() {

From cbb8f6a3cf1bd469272e90c149a7536da7d291d2 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Fri, 29 May 2026 21:26:59 -0400
Subject: [PATCH 063/314] Open 0.22 dev line: bump version to 0.22.0.dev0

0.21 is tagged (v0.21.0) at the 0.21-dev tip. This branch carries the
web-first epoch on top of it -- napari retired, web UI + self-managed auth
and roles, agent<->perception integration, observable/permissioned autonomy
(wake-router), the Home landing tab, and the docked sliding chat panel -- a
minor-version's worth of work, so it opens the 0.22 line.

pyproject.toml and gently/__init__.py -> 0.22.0.dev0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/__init__.py | 2 +-
 pyproject.toml     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gently/__init__.py b/gently/__init__.py
index 37aee420..b7f6d72f 100644
--- a/gently/__init__.py
+++ b/gently/__init__.py
@@ -76,7 +76,7 @@
 except ImportError:
     _VISUALIZATION_AVAILABLE = False
 
-__version__ = "0.21.0.dev0"
+__version__ = "0.22.0.dev0"
 __all__ = [
     # Main entry point
     "Gently",
diff --git a/pyproject.toml b/pyproject.toml
index 2395f90e..3f5a7ce7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gently"
-version = "0.21.0.dev0"
+version = "0.22.0.dev0"
 description = "Agentic harnessing for microscopy"
 readme = "docs/README.md"
 license = {text = "MIT"}

From f33847dddf6d8f0ee2b2e0a7a7b6798d69d89211 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sat, 30 May 2026 15:37:55 -0400
Subject: [PATCH 064/314] docs(readme): web-first quick start + first-run
 admin/accounts

The Quick Start was stale for the 0.22 web-first line: it told first-timers to
install Node and `npm run build` the Ink TUI (retired this epoch), used
`pip install -r requirements.txt`, and documented nothing about the web UI or
the admin bootstrap. Rewrite for reality:

- Prereqs: drop Node/TUI; Python 3.10+, ANTHROPIC_API_KEY, optional
  GENTLY_STORAGE_PATH.
- Setup: `pip install -e .`.
- Launch: device layer + launch_gently opens the browser; document
  --no-browser, --offline, and the banner URL (default http://localhost:8080).
- New "First sign-in (accounts)" section: viewing is open, login elevates to
  control; first run prints a one-time admin password to the console (never
  logged); how to add users (POST /api/auth/users), recover (delete
  users.yaml), and GENTLY_NO_AUTH=1 to disable auth.
- Fix architecture note: the core store is the file-based FileStore, not
  GentlyStore (SQLite).

Status line 0.11.0 -> 0.22.0.dev0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md | 62 +++++++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 47 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index f9bf651d..01e9320a 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 Agentic harness for microscopy.
 
-**Status**: v0.11.0 — actively developed at Shroff Lab, Janelia.
+**Status**: 0.22.0.dev0 — actively developed at Shroff Lab, Janelia.
 
 ![Safety Architecture](docs/images/safety_architecture.png)
 
@@ -67,37 +67,37 @@ Currently, the sample abstraction is the `Embryo` object for *C. elegans* work.
 
 ### Prerequisites
 
-- Python 3.11+
-- [Node.js](https://nodejs.org/) 18+ (for the Ink TUI)
+- Python 3.10+
 - An `ANTHROPIC_API_KEY` environment variable
+- *(Optional)* `GENTLY_STORAGE_PATH` — where sessions and data live (default `D:/Gently3`)
+
+Gently is **web-first**: the agent is driven from an in-page chat in your
+browser. There is no TUI to build (Node.js is only needed for the paper
+diagrams, not the app).
 
 ### Setup
 
 ```bash
-# Clone and install Python dependencies
 git clone https://github.com/pskeshu/gently.git
 cd gently
-pip install -r requirements.txt
-
-# Build the TUI (one-time, rebuild after TUI code changes)
-cd gently/tui
-npm install
-npm run build
-cd ../..
+pip install -e .            # installs the gently package + dependencies
 ```
 
 ### Launch
 
 ```bash
-# 1. Start the device layer (hardware control + SAM detection)
+# 1. Device layer (hardware control + SAM detection) — separate process, own terminal
 python start_device_layer.py
 
-# 2. Launch the agent
+# 2. Agent + web UI (starts the in-process server and opens your browser)
 python launch_gently.py
 
-# Or launch without hardware (for development / review)
+# Run without hardware (development / review)
 python launch_gently.py --offline
 
+# Don't auto-open a browser — open the printed URL yourself
+python launch_gently.py --no-browser
+
 # Resume a previous session
 python launch_gently.py --resume            # interactive picker
 python launch_gently.py --resume latest     # most recent session
@@ -108,6 +108,38 @@ python launch_gently.py -v                  # INFO level
 python launch_gently.py --debug             # DEBUG level
 ```
 
+The launcher prints a banner with the URL (default `http://localhost:8080`),
+device status, storage path, and log location. Open that URL in any browser on
+the LAN.
+
+### First sign-in (accounts)
+
+**Viewing is open** — the dashboard loads read-only for anyone, no login.
+Signing in *elevates* you to control (driving hardware, taking the
+single-operator lock); it isn't a gate on the page.
+
+On the **first run**, Gently creates one `admin` account and prints a one-time
+random password in the startup banner:
+
+```
+First-run admin account created — sign in at the URL above:
+    username: admin
+    password: <random>
+```
+
+- **Save it now** — the password is printed to the console once and never
+  written to the log (only a PBKDF2 hash is stored).
+- After signing in, add accounts (roles `viewer` / `operator` / `admin`) via the
+  admin-only `POST /api/auth/users`.
+- **Lost it?** There's no reset command yet — delete
+  `<GENTLY_STORAGE_PATH>/auth/users.yaml` and restart to bootstrap a fresh
+  `admin` (this clears all accounts).
+- **Just trying it locally?** `GENTLY_NO_AUTH=1` disables accounts entirely
+  (legacy mode: localhost gets control, remote callers need `X-Gently-Token`).
+
+Accounts live under `<GENTLY_STORAGE_PATH>/auth/` (`users.yaml` + `secret.key`),
+outside the repo.
+
 ## Guides
 
 | Guide | Audience | What you'll learn |
@@ -125,7 +157,7 @@ Four layers with strict downward-only dependencies. The **harness** (reusable ag
 gently/
 ├── core/                  # Layer 1: Foundation — zero domain knowledge
 │   ├── event_bus.py       #   Async pub/sub messaging
-│   ├── store.py           #   GentlyStore (SQLite + files)
+│   ├── file_store.py      #   FileStore (file-based: YAML / JSONL / TIF)
 │   ├── imaging.py         #   Projection, normalization, encoding
 │   └── coordinates.py     #   Pixel/stage transforms
 │

From 406c87d2f83c40057b9e9aea2046d84567a9ccb5 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sat, 30 May 2026 15:41:12 -0400
Subject: [PATCH 065/314] docs(readme): dual venv + uv setup instructions
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

First-timers increasingly reach for uv, and the project is a standard PEP 621
pyproject so uv works against it with no extra config. Offer both paths in
Setup instead of assuming pip/venv: `python -m venv` + `pip install -e .`, or
`uv venv` + `uv pip install -e .` (lockfile-free — there's no uv.lock to
maintain yet). Add a Launch note so uv users know to either activate .venv or
prefix commands with `uv run`.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 01e9320a..54346398 100644
--- a/README.md
+++ b/README.md
@@ -80,11 +80,27 @@ diagrams, not the app).
 ```bash
 git clone https://github.com/pskeshu/gently.git
 cd gently
-pip install -e .            # installs the gently package + dependencies
+```
+
+Then create an environment and install — **either path works**:
+
+```bash
+# venv + pip
+python -m venv .venv
+source .venv/bin/activate          # Windows: .venv\Scripts\activate
+pip install -e .                   # installs the gently package + dependencies
+```
+
+```bash
+# or uv (https://docs.astral.sh/uv/) — faster, no separate activation step
+uv venv
+uv pip install -e .
 ```
 
 ### Launch
 
+> **uv users:** either activate the env first (`source .venv/bin/activate`) or prefix the commands below with `uv run` (e.g. `uv run python launch_gently.py`).
+
 ```bash
 # 1. Device layer (hardware control + SAM detection) — separate process, own terminal
 python start_device_layer.py

From d6c0082848ee269830fe22c88b8f9295394c85fe Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sat, 30 May 2026 15:41:29 -0400
Subject: [PATCH 066/314] docs(try-offline): web-first install + dual venv/uv

The 10-minute offline guide had the same stale steps as the README: it told
readers to `pip install -r requirements.txt` and `npm run build` the terminal
UI that this epoch retires. Bring it in line with the web-first reality and
mirror the README's dual environment paths (venv+pip or uv), drop the Node
prerequisite, and add the uv-run / Windows `set` variants to the launch step.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/guides/try-offline.md | 29 +++++++++++++++++++----------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/docs/guides/try-offline.md b/docs/guides/try-offline.md
index 50ca6e65..e4341291 100644
--- a/docs/guides/try-offline.md
+++ b/docs/guides/try-offline.md
@@ -4,29 +4,38 @@ Get the agent running in 10 minutes — no microscope needed.
 
 ## Prerequisites
 
-- **Python 3.11+**
-- **Node.js 18+** (for the terminal UI)
+- **Python 3.10+**
 - An **Anthropic API key** (`ANTHROPIC_API_KEY` environment variable)
 
+Gently is web-first — the agent runs in your browser, so there's no terminal UI to build (no Node.js needed for the app).
+
 ## Install
 
 ```bash
 git clone https://github.com/pskeshu/gently.git
 cd gently
-pip install -r requirements.txt
+```
 
-# Build the TUI (one-time)
-cd gently/tui
-npm install
-npm run build
-cd ../..
+Create an environment and install — **either path works**:
+
+```bash
+# venv + pip
+python -m venv .venv
+source .venv/bin/activate          # Windows: .venv\Scripts\activate
+pip install -e .
+```
+
+```bash
+# or uv (https://docs.astral.sh/uv/)
+uv venv
+uv pip install -e .
 ```
 
 ## Launch
 
 ```bash
-export ANTHROPIC_API_KEY=sk-ant-...
-python launch_gently.py --offline
+export ANTHROPIC_API_KEY=sk-ant-...      # Windows: set ANTHROPIC_API_KEY=sk-ant-...
+python launch_gently.py --offline        # uv (no activate): uv run python launch_gently.py --offline
 ```
 
 The `--offline` flag skips the hardware connection. The full agent launches — conversation, perception, plan mode, memory — just without microscope control.

From bfed3e8225155f7ab5bba49f3afaa841345c26c3 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sat, 30 May 2026 15:55:42 -0400
Subject: [PATCH 067/314] docs(eval): replay-harness design for testing the
 orchestrator offline

Fills the docs/EVAL.md TODO referenced by gently/eval/__init__.py. Documents
the capture/replay substrate that already shipped (EventCapture / EventReplay /
ShadowRunner / DecisionLog) and a grounded, incremental design for exercising
the *real* wake-router + agent reasoning offline by replaying recorded sessions
on a controllable clock.

Covers the central wiring gap (replay currently targets a fresh EventBus the
agent never subscribes to), four compared approaches (event-stream replay,
Perceiver stub, full timelapse re-feed, shadow scoring), honest fidelity limits
(recorded perception != new perception, LLM nondeterminism, wake-router
coalesce/throttle vs replay clock, wall-clock reads), and a step-by-step build
order. Referenced from the PR's "Where we'd especially value help" section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/EVAL.md | 187 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 187 insertions(+)
 create mode 100644 docs/EVAL.md

diff --git a/docs/EVAL.md b/docs/EVAL.md
new file mode 100644
index 00000000..73f35b69
--- /dev/null
+++ b/docs/EVAL.md
@@ -0,0 +1,187 @@
+<!-- Fills the docs/EVAL.md (TODO) referenced by gently/eval/__init__.py. -->
+
+> **Status:** design + intended usage for the `gently/eval/` capture/replay substrate and the
+> proposed offline replay harness for testing agentic orchestrator patterns. Grounded in the
+> code as of the 0.22 epoch; the harness itself is a work-in-progress (see the incremental plan).
+
+# Testing agentic orchestrator patterns offline (replay harness)
+
+## Goal
+
+We want to iterate on the agent's design — its realtime reasoning and the wake-router that
+turns developmental events into autonomous turns — **without booking a live microscope run**.
+Concretely: take a recorded session, simulate the microscope conditions from its on-disk
+artifacts (captured events, recorded volumes, recorded perception traces), drive the *real*
+`WakeRouter -> run_wake_turn -> Claude` loop offline, and observe/diff what the agent decides.
+This lets us tune wake triggers, coalescing/throttling, prompt construction, and tool policy on
+a laptop, replayed at a controllable clock (e.g. 10x), instead of waiting hours for embryos to
+develop on a live rig.
+
+## What's already in place (reuse)
+
+A real, tested replay/eval substrate shipped in the 0.22 epoch (`gently/eval/`), plus production
+capture wiring. None of this is hypothetical — it's on disk and runnable today:
+
+- **`gently/eval/event_capture.py`** — `EventCapture` wildcard-subscribes the bus and appends every
+  `Event.to_dict()` to `{session_dir}/events.jsonl`. Auto-wired into **every** live session by
+  `gently/app/agent.py` `_init_event_capture()` (line ~506, called at agent init). Skips only
+  `_NO_HISTORY_TYPES` (`DEVICE_STATE_UPDATE`, `BOTTOM_CAMERA_FRAME`, `LOG_RECORD`); `DETECTOR_EVALUATED`
+  and lifecycle events are **not** skipped.
+- **`gently/eval/event_replay.py`** — `EventReplay(path).replay(target_bus, real_time=, time_scale=, on_event=)`
+  republishes each event via `target.publish_event(ev)`, **preserving the original `Event.timestamp`**
+  (not re-stamping `now()`). `real_time=True` sleeps `(ev.timestamp - prev)/time_scale` between events,
+  so cadence is reproducible. `event_types()` gives a pre-flight histogram.
+- **`gently/eval/shadow.py` + `candidates.py`** — `ShadowRunner` + `OrchestratorCandidate` host
+  sandboxed rule-based candidates (e.g. `ReactiveCandidate`) that may *only* write a `DecisionLog`.
+- **`gently/eval/decision_log.py`** — `Decision`/`DecisionLog` + `prompt_hash()` (sha256[:16] over
+  system prompt + messages) for apples-to-apples A/B diffing.
+- **`scripts/replay_session.py`** — working CLI: resolves a session by id-prefix via
+  `FileStore.list_sessions`, prints `--histogram`, or replays `events.jsonl` into a **fresh** `EventBus()`
+  with an optional `NoOpCandidate`.
+- **Recorded perception inputs/outputs** persist via `FileStore` (`gently/core/file_store.py`):
+  `embryos/{id}/volumes/t{NNNN}.tif` + `.meta.yaml`, `projections/t{NNNN}.jpg`,
+  `predictions.jsonl`, and `traces/t{NNNN}.json` (verbatim `predicted_stage`/`reasoning`/`raw_response`/`stability`).
+  Verified on disk: session `68e7dc33` has 9 embryos, 56 predictions on embryo_001, volume
+  `t0001.tif` shape `[50,512,2048]` uint16.
+- **`timeline.jsonl`** (durable, predates eval) carries 256 `detection/evaluated` records on `68e7dc33`
+  with exactly the fields `WakeRouter._is_wake_worthy` reads (`embryo_id`, `timepoint`,
+  `detector_name`, `stage`, `reasoning`) — a fallback event source for pre-eval-scaffold sessions.
+
+### The one central wiring gap
+
+The real agent subscribes its `WakeRouter` to the **global singleton** bus
+(`gently/app/agent.py:126` `self._event_bus = get_event_bus()`; WakeRouter built with that same bus).
+But `scripts/replay_session.py:124` replays into a **fresh** `EventBus()` that the agent never sees.
+**So today's replay reaches shadow candidates but never the real WakeRouter/agent.** Bridging this —
+either `set_event_bus(replay_bus)` before constructing the agent, or replaying into `get_event_bus()`
+directly — is the core seam to build.
+
+## Approaches, compared
+
+### (A) Event-stream replay into the agent's bus  — *recommended first*
+Publish recorded `DETECTOR_EVALUATED` + critical events (`HATCHING_DETECTED`, `EMBRYO_TERMINATED`,
+`ERROR_OCCURRED`, …) onto the bus the agent's `WakeRouter` is subscribed to, on a controllable clock.
+
+- **Reuses:** `EventReplay`, `EventCapture` output, the entire real `WakeRouter` (`_is_wake_worthy`
+  filter at wake_router.py:129, coalesce `COALESCE_WINDOW=20s`, throttle `MIN_WAKE_INTERVAL=120s`,
+  `_flush -> agent.run_wake_turn`).
+- **Fidelity:** Exercises the *real* wake path end-to-end: filtering, transition gate, coalescing,
+  throttling, prompt build, and a real Claude turn (`run_wake_turn -> handle_message_stream`, gated on
+  `agent.mode=='run'`). Highest leverage for the least new code.
+- **Effort:** Medium. Needs (1) the bus bridge above; (2) a running asyncio loop so the async dispatch
+  + `loop.call_later` coalesce timers fire (`EventReplay.replay` is a blocking `time.sleep` loop — run it
+  in a thread or port it to `await asyncio.sleep`, and call `bus.set_event_loop(loop)`); (3) a stub
+  client so any tools the woken agent calls don't hit hardware (autonomous mode already refuses
+  irreversible tools via `_autonomous_active`).
+- **Can't catch:** Anything depending on *fresh* perception of new pixels — the wake note embeds
+  `build_perception_snapshot(agent.perceiver, ...)`, which reads **live** Perceiver state, so this
+  approach needs (B) to make that snapshot reflect the replayed timepoint rather than empty state.
+- **Blocker today:** No recorded session yet contains `DETECTOR_EVALUATED` (verified: all 20 captured
+  `events.jsonl` hold only `STATUS_CHANGED`/`EMBRYO_DETECTED`/`EMBRYOS_UPDATE`). Either capture one fresh
+  perception-driven session, or synthesize `DETECTOR_EVALUATED` events from `traces/`+`timeline.jsonl`.
+
+### (B) Perceiver stub — feed recorded traces
+Replace `agent.perceiver`/`orchestrator.perceiver` with a duck-typed stub whose `__call__(...)` returns
+`.stage`/`.reasoning` from `traces/t{NNNN}.json`, and whose `get_session(embryo_id)` returns an object
+with `.stability`/`.summary()` matching what `build_perception_snapshot` reads
+(`current_stage`/`stability`/`temporal`/`stage_sequence`).
+
+- **Reuses:** All downstream code in `_run_perception` (DETECTOR_EVALUATED emit, trace write,
+  `store_prediction`, `_check_interval_rules`) is pure local code; the Perceiver is the *only* external
+  VLM dependency. `perceiver` is already an optional ctor arg (timelapse.py:71).
+- **Fidelity:** Reproduces recorded perception verbatim — no VLM spend, deterministic. Makes (A)'s wake
+  snapshot reflect the replayed timepoint.
+- **Effort:** Low-medium (one stub class).
+- **Can't catch:** Perception on *new* conditions — it only echoes what the recorded run already saw.
+  Also the stub interface was inferred from call sites (`templates.py` `build_perception_snapshot`,
+  `timelapse.py` `_run_perception`), not from `gently_perception` source — **verify against the
+  installed package** before relying on it.
+
+### (C) Full offline re-feed through the timelapse loop
+Inject a fake `microscope_client` whose `acquire_volume(...)` returns
+`{'success': True, 'volume': <ndarray from volumes/t{NNNN}.tif>}` keyed by `(embryo_id, timepoint)`,
+plus `move_to_position`, etc. `_has_microscope()` (`return self.client is not None`) then gates the
+orchestrator *on*, driving the entire per-timepoint loop (acquire -> callback -> `_run_perception`).
+
+- **Reuses:** The whole `TimelapseOrchestrator`; `client` is a single ctor arg accessed only via named
+  async methods.
+- **Fidelity:** Highest — exercises scheduling, acquisition callbacks, perception, event emission, and
+  wakes as one system.
+- **Effort:** High. The orchestrator schedules entirely off `datetime.now()`/`asyncio.sleep`
+  (`_pick_next_due`, `_reschedule`, the acquire loop) and ignores `Event.timestamp` — a faithful
+  time-scaled run needs an **injectable clock** threaded through both the orchestrator and the
+  WakeRouter's wall-clock timers. There is also no helper to join recorded TIFFs to the event stream.
+- **Can't catch:** Same perception-novelty limit as (B); plus device-state/camera-frame telemetry is
+  absent from `events.jsonl` and must be sourced from disk or synthesized.
+
+### (D) Shadow mode — score candidates / replay captured turns
+Keep the existing `ShadowRunner` path: replay captured events into a bus with rule-based candidates
+attached, diff `decisions.jsonl` (production) vs `replay-decisions-*.jsonl` (candidate) via `prompt_hash`.
+
+- **Reuses:** Fully built already (`scripts/replay_session.py --candidate`).
+- **Fidelity:** Tests *alternative* (non-LLM) orchestrator architectures, not the production Claude agent.
+- **Effort:** None (exists).
+- **Can't catch:** The real agent's reasoning. Also: production only writes `Decision`s for **user turns**
+  (`conversation.py:343` hardcodes `trigger=DecisionTrigger.USER_MESSAGE`); wake turns via
+  `call_claude_stream` aren't logged as decisions, so there's currently no production wake-decision row to
+  diff against.
+
+## Honest fidelity limits
+
+- **Recorded perception ≠ new perception.** Approaches B/C echo `traces/`; they cannot evaluate the
+  Perceiver on conditions the original run didn't encounter. Genuinely testing perception requires a live
+  (or freshly captured) run.
+- **LLM nondeterminism.** `run_wake_turn` makes a real Claude call; the same replayed input can yield
+  different tool calls run-to-run. `prompt_hash` isolates *input* identity but not *output* determinism —
+  diffs are about distributions/policy, not exact equality.
+- **Clock vs coalesce/throttle.** `WakeRouter` uses real wall-clock `loop.call_later(COALESCE_WINDOW=20s)`
+  and `loop.time()`-based `MIN_WAKE_INTERVAL=120s` — these are **not** scaled by `time_scale`. A fast
+  replay collapses bursts into one wake; a high `time_scale` shrinks inter-event sleeps below the fixed
+  20s window, again collapsing wakes. These tunables (currently module-level constants in
+  `wake_router.py:33-35`) must be parameterized/injectable for faithful timed replay.
+- **Wall-clock reads break replay.** `TimelapseOrchestrator` (`timelapse.py`) drives scheduling off
+  `datetime.now()`/`asyncio.sleep` and never consults `Event.timestamp`; perception stamps
+  `timestamp=datetime.now()`. Any *new* events the woken agent emits use `publish()` (fresh `now()`),
+  intermixing replayed-historical and live-now timestamps on the same bus — a consistency hazard for
+  downstream diffing.
+- **Telemetry gaps.** `EventCapture` skips `DEVICE_STATE_UPDATE`/`BOTTOM_CAMERA_FRAME`/`LOG_RECORD`, so a
+  replay can't reconstruct live device readouts or frames from `events.jsonl` (re-capture with
+  `EventCapture(path, skip=set())` or synthesize).
+- **Data availability (verified).** No single recorded session yet combines a full timelapse with
+  non-trivial capture: `68e7dc33` has 9 embryos + volumes/traces but **no** `events.jsonl`; the newest
+  sessions have `events.jsonl` but 0 embryos and empty `decisions.jsonl`. All 20 captured `events.jsonl`
+  contain only setup-phase events — **zero** `DETECTOR_EVALUATED`.
+
+## Concrete incremental plan
+
+**Step 0 — Generate one good input stream (unblocks everything).** Either (a) run a single fresh
+perception-driven session (live or with a stub client) after the eval-scaffold commit so
+`events.jsonl` + non-empty `decisions.jsonl` coexist with volumes/traces; or (b) write a tiny
+`synthesize_events.py` that emits `DETECTOR_EVALUATED` events from `68e7dc33`'s `traces/`+`timeline.jsonl`
+into a synthetic `events.jsonl`. Validate with `python scripts/replay_session.py <id> --histogram`.
+
+**Step 1 (smallest useful) — Bus bridge + offline driver skeleton.** New script
+`scripts/replay_into_agent.py`: construct a `GentlyAgent` with a stub microscope client, call
+`set_event_bus(replay_bus)` (or replay into `get_event_bus()`), set `agent.mode='run'` and
+`wake_router.set_mode('ask')`, run an asyncio loop, `bus.set_event_loop(loop)`, and run
+`EventReplay(...).replay(bus, real_time=True, time_scale=N)` in a thread. First milestone: a recorded
+`DETECTOR_EVALUATED` actually fires `_on_event -> _flush -> run_wake_turn`. Reuses `EventReplay`,
+`WakeRouter`, `run_wake_turn` unchanged.
+
+**Step 2 — Perceiver stub (B).** Add a `RecordedPerceiver` reading `traces/t{NNNN}.json`, injected via
+`agent.perceiver`. Verify its `summary()`/result shape against the installed `gently_perception`. Now the
+wake prompt's `build_perception_snapshot` reflects the replayed timepoint.
+
+**Step 3 — Injectable clock + parameterized tunables.** Thread a clock/`now()` provider through
+`TimelapseOrchestrator` and make `COALESCE_WINDOW`/`MIN_WAKE_INTERVAL` injectable on `WakeRouter` so a
+time-scaled replay reproduces the live wake set. Also scale or virtualize the loop timers.
+
+**Step 4 — Capture wake decisions + fix trigger labels.** Add `DecisionLog` capture to the
+`call_claude_stream` (wake) path and emit `DecisionTrigger.EVENT` for wake turns (today `conversation.py`
+only writes `USER_MESSAGE` decisions from `call_claude`). This makes replayed autonomous turns diffable.
+
+**Step 5 — Optional full re-feed (C).** Add a `RecordedMicroscopeClient` whose `acquire_volume` loads
+`volumes/t{NNNN}.tif`, gating the orchestrator on for end-to-end loop testing.
+
+**Step 6 — Write `docs/EVAL.md`** (referenced as TODO in `gently/eval/__init__.py`) documenting the
+replay workflow and fidelity tiers.

From d50f9d613363da2ec470c141dde2b92990eacf0d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sat, 30 May 2026 16:04:36 -0400
Subject: [PATCH 068/314] docs(readme): "Make your first plan" walkthrough
 (chat -> /plan -> Plans viewer)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Quick Start got users installed and signed in but stopped at "open the
URL" — it never led them into actually using the app. Add a walkthrough that
takes a first user all the way through the core loop:

- open the agent chat (header Agent toggle / Ctrl+J, or Home's Start button +
  the /wizard setup),
- enter plan mode with /plan (agent as scientific collaborator, no hardware),
- describe an experiment in plain language -> the agent drafts a campaign of
  typed plan items with concrete specs,
- inspect it in the Plans tab (plan viewer): campaign card -> plan document,
  item statuses/specs + inspector, doc/board/graph/timeline views, versions.

Notes that plan mode works fully offline (--offline), so reviewers can try the
talk -> plan -> inspect loop without a microscope — which is exactly the
hands-on interface feedback the PR asks for.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 54346398..28af4c12 100644
--- a/README.md
+++ b/README.md
@@ -156,6 +156,20 @@ First-run admin account created — sign in at the URL above:
 Accounts live under `<GENTLY_STORAGE_PATH>/auth/` (`users.yaml` + `secret.key`),
 outside the repo.
 
+## Make your first plan
+
+You don't need a microscope to try the core loop — **plan mode is pure agent reasoning and works under `--offline`**. The path from launch to an inspectable plan:
+
+1. **Open the agent chat.** Click **Agent** in the header (or press `Ctrl`/`Cmd`+`J`). New here? The **Home** tab's *Start an experiment* button runs a short setup wizard (also available anytime via `/wizard` — it sets the organism, the campaign, and what you're trying to learn).
+2. **Enter plan mode** — type `/plan` in the chat. The agent switches from *operator* to *scientific collaborator*: it won't touch hardware, it helps you design an experiment.
+3. **Describe what you want, in plain language.** For example:
+   > *"Follow GFP-tagged embryos from bean stage through elongation, imaging every 10 minutes, with a no-laser control — three embryos per condition."*
+
+   The agent drafts a **campaign**: a sequence of typed **plan items** — imaging 📷, bench 🧪, genetics 🧬, analysis 📊, decision points 🚦 — each with concrete specs (strain, interval, laser power, Z-slices, target window, success criteria). Keep replying to refine it; `/plan status` shows progress and `/plan exit` returns to run mode.
+4. **Inspect it in the plan viewer.** Open the **Plans** tab. Your campaign appears as a card — click it to open the **plan document**. Each item shows its status (○ planned · ◑ in progress · ● done) and specs; click one to see full details in the inspector. Switch layouts (document / board / graph / timeline) from the view controls, and browse plan **versions** as it evolves. (Typing `/campaign` in chat lists campaigns too.)
+
+That's the loop: **talk → plan → inspect.** With hardware connected (drop `--offline` and start the device layer), the same campaign drives acquisition — and perception events can wake the agent to adjust it as the embryos develop.
+
 ## Guides
 
 | Guide | Audience | What you'll learn |

From ce8b64729eab3aeed6cadbf8d8e1f2f399948cc8 Mon Sep 17 00:00:00 2001
From: Magdalena Schneider <schneiderm2@hhmi.org>
Date: Mon, 1 Jun 2026 14:52:27 -0400
Subject: [PATCH 069/314] Relicense and update author list

---
 LICENSE        | 695 +++++++++++++++++++++++++++++++++++++++++++++++--
 README.md      |   4 +-
 pyproject.toml |   4 +-
 3 files changed, 679 insertions(+), 24 deletions(-)

diff --git a/LICENSE b/LICENSE
index 486ead3a..f288702d 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,21 +1,674 @@
-MIT License
-
-Copyright (c) 2023 Kesavan Subburam
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.
diff --git a/README.md b/README.md
index f3630dfd..b339d2c7 100644
--- a/README.md
+++ b/README.md
@@ -282,4 +282,6 @@ These papers provide theoretical background for gently's approach:
 
 ## License
 
-See [LICENSE](LICENSE) file.
+Copyright © 2026 Howard Hughes Medical Institute.
+
+Gently is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later) — see the [LICENSE](LICENSE) file.
diff --git a/pyproject.toml b/pyproject.toml
index 3f5a7ce7..e6f41307 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -7,10 +7,10 @@ name = "gently"
 version = "0.22.0.dev0"
 description = "Agentic harnessing for microscopy"
 readme = "docs/README.md"
-license = {text = "MIT"}
+license = {text = "GPL-3.0-or-later"}
 requires-python = ">=3.10"
 authors = [
-    {name = "Shroff Lab", email = "shroffl@nih.gov"},
+    {name = "Kesavan Subburam", email = "pskeshu@gmail.com"},
 ]
 classifiers = [
     "Development Status :: 4 - Beta",

From 574bc802364bcbf6bc4d35b24ea93fed3bc9fd5b Mon Sep 17 00:00:00 2001
From: Magdalena Schneider <schneiderm2@hhmi.org>
Date: Mon, 1 Jun 2026 15:07:02 -0400
Subject: [PATCH 070/314] fix(web): use Starlette 1.x TemplateResponse(request,
 name, ...) signature

---
 gently/ui/web/routes/auth_routes.py | 2 +-
 gently/ui/web/routes/pages.py       | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/gently/ui/web/routes/auth_routes.py b/gently/ui/web/routes/auth_routes.py
index e7db5500..dd4e0629 100644
--- a/gently/ui/web/routes/auth_routes.py
+++ b/gently/ui/web/routes/auth_routes.py
@@ -31,7 +31,7 @@ async def login_page(request: Request):
             return RedirectResponse("/", status_code=302)
         if current_username(request):
             return RedirectResponse("/", status_code=302)
-        return server.templates.TemplateResponse("login.html", {"request": request})
+        return server.templates.TemplateResponse(request, "login.html")
 
     @router.post("/api/auth/login")
     async def login(request: Request):
diff --git a/gently/ui/web/routes/pages.py b/gently/ui/web/routes/pages.py
index 0cff7d82..3cf5c37a 100644
--- a/gently/ui/web/routes/pages.py
+++ b/gently/ui/web/routes/pages.py
@@ -16,8 +16,9 @@ async def index(request: Request):
         chat window's "Sign in" affordance), not a gate on the page itself.
         """
         return server.templates.TemplateResponse(
+            request,
             "index.html",
-            {"request": request, "active_section": "embryos", "is_live": True}
+            {"active_section": "embryos", "is_live": True}
         )
 
     # Standalone URLs redirect to SPA with hash fragment for tab routing
@@ -37,8 +38,8 @@ async def plan_review_page(campaign_id: str):
     async def settings_page(request: Request):
         """Serve the dashboard settings page"""
         return server.templates.TemplateResponse(
+            request,
             "settings.html",
-            {"request": request}
         )
 
     return router

From 856df4cb17e1e7b07abdbe7b59f717ce4741d39b Mon Sep 17 00:00:00 2001
From: Magdalena Schneider <schneiderm2@hhmi.org>
Date: Mon, 1 Jun 2026 17:11:36 -0400
Subject: [PATCH 071/314] Switch environment setup to uv and add
 offline/UI-only launch

- Adopt uv for env + deps; declare gently-perception (sibling repo) via [tool.uv.sources] and add python-dotenv. Refresh README setup/launch docs.
- Migrate requirements*.txt into pyproject: drop the redundant requirements.txt, move device accessories (bleak/pyserial/paho-mqtt) to a [device] extra, and document the optional CUDA-torch install (kept opt-in, not a forced default).
- Auto-load a project-root .env on startup; OS-aware ANTHROPIC_API_KEY message.
- Add --no-api UI-only mode and an immediate startup log line before imports.
---
 README.md               |   85 +-
 gently/app/agent.py     |   31 +-
 launch_gently.py        |   45 +-
 pyproject.toml          |   17 +
 requirements-cuda.txt   |    9 -
 requirements.txt        |   43 -
 requirements_device.txt |   31 -
 uv.lock                 | 4261 +++++++++++++++++++++++++++++++++++++++
 8 files changed, 4412 insertions(+), 110 deletions(-)
 delete mode 100644 requirements-cuda.txt
 delete mode 100644 requirements.txt
 delete mode 100644 requirements_device.txt
 create mode 100644 uv.lock

diff --git a/README.md b/README.md
index b339d2c7..34865ccb 100644
--- a/README.md
+++ b/README.md
@@ -68,7 +68,11 @@ Currently, the sample abstraction is the `Embryo` object for *C. elegans* work.
 ### Prerequisites
 
 - Python 3.10+
-- An `ANTHROPIC_API_KEY` environment variable
+- An `ANTHROPIC_API_KEY` — either exported in your shell
+  (`export ANTHROPIC_API_KEY=your-key`) or placed in a `.env` file in the
+  project root (`ANTHROPIC_API_KEY=your-key`), which is loaded automatically
+  on launch and is gitignored. *(Not required if you launch with `--no-api`
+  to browse the UI only — see Launch below.)*
 - *(Optional)* `GENTLY_STORAGE_PATH` — where sessions and data live (default `D:/Gently3`)
 
 Gently is **web-first**: the agent is driven from an in-page chat in your
@@ -77,51 +81,94 @@ diagrams, not the app).
 
 ### Setup
 
+This project uses [uv](https://docs.astral.sh/uv/) for environment and
+dependency management. If you don't have it yet, install it following the
+[uv installation guide](https://docs.astral.sh/uv/getting-started/installation/)
+(e.g. `curl -LsSf https://astral.sh/uv/install.sh | sh` on macOS/Linux).
+
+Gently depends on **`gently-perception`** (the VLM perception harness, repo
+`pskeshu/gently-perception`), which is not published to PyPI. Clone it as a
+**sibling** of `gently` so the path source in `pyproject.toml` can find it:
+
 ```bash
+# Clone both repos side by side
 git clone https://github.com/pskeshu/gently.git
+git clone https://github.com/pskeshu/gently-perception.git
+
+# Layout:
+#   <parent>/
+#     gently/             <- you run commands from here
+#     gently-perception/  <- resolved via [tool.uv.sources]
+```
+
+From the project root run:
+
+```bash
 cd gently
+uv sync
 ```
 
-Then create an environment and install — **either path works**:
+This creates a `.venv` in the project directory and installs the runtime + dev
+dependencies pinned in `uv.lock` (see `pyproject.toml` for the spec), including
+`gently-perception` as an editable install from the sibling clone. Activate it
+with `source .venv/bin/activate`, or just prefix commands with `uv run` (e.g.
+`uv run python ...`) to use it without activating.
+
+#### Optional extras
 
 ```bash
-# venv + pip
-python -m venv .venv
-source .venv/bin/activate          # Windows: .venv\Scripts\activate
-pip install -e .                   # installs the gently package + dependencies
+# Device-layer accessories (microscope computer): BLE/serial/MQTT transports
+uv sync --extra device
+
+# GPU acceleration for SAM detection — install the CUDA build of PyTorch
+# (skip on CPU-only machines; the default torch from uv sync works there)
+uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
 ```
 
+#### Running tests
+
 ```bash
-# or uv (https://docs.astral.sh/uv/) — faster, no separate activation step
-uv venv
-uv pip install -e .
+uv run pytest
 ```
 
 ### Launch
 
-> **uv users:** either activate the env first (`source .venv/bin/activate`) or prefix the commands below with `uv run` (e.g. `uv run python launch_gently.py`).
+> The commands below use `uv run` so they work without activating the env. If you've activated it first (`source .venv/bin/activate`), the `uv run` prefix isn't necessary.
+
+To verify the install, you can start gently without an API key or hardware. The
+web UI boots and is browsable, though the agent itself (chat, perception, plan
+mode) stays disabled until you add a key:
+
+```bash
+uv run python launch_gently.py --offline --no-api
+```
+
+For the full launch:
 
 ```bash
 # 1. Device layer (hardware control + SAM detection) — separate process, own terminal
-python start_device_layer.py
+uv run python start_device_layer.py
 
 # 2. Agent + web UI (starts the in-process server and opens your browser)
-python launch_gently.py
+uv run python launch_gently.py
 
 # Run without hardware (development / review)
-python launch_gently.py --offline
+uv run python launch_gently.py --offline
+
+# UI-only — boot the web UI with no API key (chat/perception disabled)
+uv run python launch_gently.py --no-api
 
 # Don't auto-open a browser — open the printed URL yourself
-python launch_gently.py --no-browser
+uv run python launch_gently.py --no-browser
 
 # Resume a previous session
-python launch_gently.py --resume            # interactive picker
-python launch_gently.py --resume latest     # most recent session
-python launch_gently.py --resume <id>       # specific session
+uv run python launch_gently.py --resume            # interactive picker
+uv run python launch_gently.py --resume latest     # most recent session
+uv run python launch_gently.py --resume <id>       # specific session
 
 # Verbose / debug logging
-python launch_gently.py -v                  # INFO level
-python launch_gently.py --debug             # DEBUG level
+uv run python launch_gently.py -v                  # INFO level
+uv run python launch_gently.py --debug             # DEBUG level
 ```
 
 The launcher prints a banner with the URL (default `http://localhost:8080`),
diff --git a/gently/app/agent.py b/gently/app/agent.py
index 9b144f92..16ae51c3 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -47,6 +47,16 @@
 from ..harness.prompts.manager import PromptManager
 
 
+# Shown when the agent is launched in UI-only mode (--no-api). The web UI is
+# fully browsable, but anything that would call Claude is disabled.
+_NO_API_NOTICE = (
+    "The agent is running in **UI-only mode** (`--no-api`), so it can't "
+    "respond — no Anthropic API calls are made. You can browse the interface, "
+    "view saved sessions, and explore the UI. To enable chat, perception, and "
+    "plan generation, restart without `--no-api` and with `ANTHROPIC_API_KEY` set."
+)
+
+
 class MicroscopyAgent:
     """
     Conversational AI agent for microscopy experiments
@@ -67,6 +77,7 @@ def __init__(
         microscope_client=None,
         session_id: Optional[str] = None,
         store: FileStore = None,
+        no_api: bool = False,
     ):
         """
         Parameters
@@ -83,13 +94,24 @@ def __init__(
             Session ID to resume. If None, creates new session.
         store : FileStore
             Unified file-based data store. Required.
+        no_api : bool
+            UI-only mode: skip Anthropic API calls entirely. The full agent and
+            its sub-components are still constructed (so the web UI boots), but
+            message handling short-circuits with a clear notice instead of
+            calling Claude. Useful for browsing the UI without an API key.
         """
         if store is None:
             raise ValueError("FileStore is required. Pass store=FileStore(path) to agent.")
 
+        # UI-only mode: no real API calls. We still build the client object (so
+        # all sub-components that hold a reference work), but fall back to a
+        # placeholder key so construction never fails when no key is set, and
+        # the message entry points refuse to call Claude.
+        self.api_enabled = not no_api
+
         # API client with interleaved thinking support
         self.claude = anthropic.Anthropic(
-            api_key=api_key or os.getenv("ANTHROPIC_API_KEY"),
+            api_key=api_key or os.getenv("ANTHROPIC_API_KEY") or ("no-api-mode" if no_api else None),
             default_headers={"anthropic-beta": "interleaved-thinking-2025-05-14"}
         )
         self.model = model
@@ -899,6 +921,9 @@ async def handle_message(self, user_message: str) -> str:
         ):
             return quick_response
 
+        if not self.api_enabled:
+            return _NO_API_NOTICE
+
         # Update system prompt with current state and context awareness
         context_summary = await self.prompts.get_cached_context_summary(
             self.experiment, self.timelapse_orchestrator, self.timeline_manager
@@ -942,6 +967,10 @@ async def handle_message_stream(self, user_message: str):
             yield {'type': 'text', 'text': quick_response}
             return
 
+        if not self.api_enabled:
+            yield {'type': 'text', 'text': _NO_API_NOTICE}
+            return
+
         # Hold the turn-lock for the whole streamed turn so an autonomous wake
         # turn cannot interleave on the shared conversation_history.
         lock = getattr(self, "_turn_lock", None)
diff --git a/launch_gently.py b/launch_gently.py
index a2e590fa..57dee885 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -12,6 +12,7 @@
     python launch_gently.py                      # Start server + open browser
     python launch_gently.py --no-browser         # Start server, don't open a browser
     python launch_gently.py --offline            # Run without the device layer
+    python launch_gently.py --no-api             # UI-only: boot the web UI without an API key
     python launch_gently.py --sessions           # List sessions and exit
     python launch_gently.py --resume             # Resume most recent session
     python launch_gently.py --resume latest      # Resume most recent session
@@ -33,6 +34,22 @@
 
 import yaml
 
+# Load a project-root .env (if present) so ANTHROPIC_API_KEY and other
+# settings can live in a file instead of being exported every session.
+# Existing environment variables take precedence.
+try:
+    from dotenv import load_dotenv
+
+    load_dotenv(Path(__file__).resolve().parent / ".env")
+except ImportError:
+    pass
+
+# The gently imports below pull in heavy dependencies (anthropic, torch, scipy,
+# perception) and take several seconds. Print immediate feedback first so the
+# terminal isn't silent during that load. Skipped for --help/--version.
+if not any(flag in sys.argv for flag in ("-h", "--help")):
+    print("Starting gently — loading modules (this can take a few seconds)...", flush=True)
+
 from gently.log_config import configure_logging
 from gently.core.log_bridge import configure_log_bridge
 from gently.app.agent import MicroscopyAgent
@@ -95,7 +112,7 @@ def list_sessions(store: FileStore):
     print("Use: python launch_gently.py --resume <id>")
 
 
-def _print_banner(viz_url, device_connected, offline, storage_dir, log_file, resumed):
+def _print_banner(viz_url, device_connected, offline, storage_dir, log_file, resumed, no_api=False):
     """Print a human-readable launch banner to the terminal.
 
     This is the "what you see when you open it" surface now that the
@@ -108,12 +125,14 @@ def _print_banner(viz_url, device_connected, offline, storage_dir, log_file, res
         dev = "● connected"
     else:
         dev = "○ offline — run:  python start_device_layer.py"
+    agent_status = "○ disabled — UI only (--no-api)" if no_api else "● enabled"
     url = viz_url or "(viz server failed to start — check the log)"
     tag = "  [resumed session]" if resumed else ""
     print()
     print(f"  ✦ Gently is running.{tag}")
     print(f"    {line}")
     print(f"    Open:    {url}")
+    print(f"    Agent:   {agent_status}")
     print(f"    Device:  {dev}")
     print(f"    Storage: {storage_dir}")
     print(f"    Logs:    {log_file}")
@@ -197,7 +216,7 @@ def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
     return None
 
 
-async def main(offline: bool = False, resume_session: str = None, show_sessions: bool = False, pick_session: bool = False, log_level: str = "WARNING", no_browser: bool = False):
+async def main(offline: bool = False, resume_session: str = None, show_sessions: bool = False, pick_session: bool = False, log_level: str = "WARNING", no_browser: bool = False, no_api: bool = False):
     # Set up log file in storage directory
     # Unified with FileStore: logs live under the same root as data
     # (settings.storage.base_path reads GENTLY_STORAGE_PATH). Previously this
@@ -329,6 +348,7 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
         storage_path=storage_dir,
         session_id=session_to_resume,
         store=store,
+        no_api=no_api,
     )
 
     # Generate TLS certificate for mesh communication
@@ -502,6 +522,7 @@ def _status_provider():
         storage_dir=storage_dir,
         log_file=log_file,
         resumed=session_to_resume is not None,
+        no_api=no_api,
     )
 
     if admin_creds:
@@ -562,13 +583,11 @@ def _sig(*_a):
 
 def cli_main():
     """Sync entry point for ``gently`` console script (pyproject.toml)."""
-    if not os.getenv("ANTHROPIC_API_KEY"):
-        print("Error: ANTHROPIC_API_KEY not set")
-        print("Set with: set ANTHROPIC_API_KEY=your-key")
-        exit(1)
-
     parser = argparse.ArgumentParser(description="Launch Microscopy Agent")
     parser.add_argument("--offline", action="store_true", help="Run without server connections")
+    parser.add_argument("--no-api", action="store_true",
+                        help="UI-only mode: boot the web UI without any Anthropic API key. "
+                             "Chat, perception, and plan generation are disabled.")
     parser.add_argument("--sessions", action="store_true", help="List available sessions and exit")
     parser.add_argument("--resume", nargs="?", const="__PICK__", metavar="ID",
                         help="Resume a session. Without ID: shows picker. With ID: resumes that session.")
@@ -577,6 +596,17 @@ def cli_main():
     parser.add_argument("--no-browser", action="store_true", help="Do not auto-open the web UI in a browser")
     args = parser.parse_args()
 
+    # An API key is required unless running in UI-only mode.
+    if not args.no_api and not os.getenv("ANTHROPIC_API_KEY"):
+        print("Error: ANTHROPIC_API_KEY not set")
+        if os.name == "nt":
+            print("Set with: set ANTHROPIC_API_KEY=your-key")
+        else:
+            print("Set with: export ANTHROPIC_API_KEY=your-key")
+        print("Or add it to a .env file in the project root: ANTHROPIC_API_KEY=your-key")
+        print("Or run UI-only without a key: python launch_gently.py --no-api")
+        exit(1)
+
     log_level = "WARNING"
     if args.verbose:
         log_level = "INFO"
@@ -594,6 +624,7 @@ def cli_main():
             pick_session=pick_session,
             log_level=log_level,
             no_browser=args.no_browser,
+            no_api=args.no_api,
         ))
     except (KeyboardInterrupt, RuntimeError, SystemExit):
         pass
diff --git a/pyproject.toml b/pyproject.toml
index e6f41307..cc7e9c34 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -34,6 +34,9 @@ dependencies = [
     "jinja2>=3.1.0",
     "pyyaml>=6.0",
     "matplotlib>=3.7.0",
+    "python-dotenv>=1.0.0",
+    # Perception harness — cloned as a sibling repo (see [tool.uv.sources])
+    "gently-perception",
     # Device control
     "pymmcore>=11.1.1",
     "bluesky>=1.11.0",
@@ -51,10 +54,24 @@ dependencies = [
 sam = [
     "segment-anything",
 ]
+# Device-layer accessories for the microscope computer. Core hardware-control
+# deps (pymmcore, bluesky, ophyd) are already in [project.dependencies]; these
+# are the extras the device layer needs: BLE (SwitchBot room light), serial and
+# MQTT transports (ACUITYnano thermal controller). Install: uv sync --extra device
+device = [
+    "bleak>=0.21.0",
+    "pyserial>=3.5",
+    "paho-mqtt>=1.6.0",
+]
 
 [project.scripts]
 gently = "launch_gently:cli_main"
 
+# gently-perception is not published to PyPI; it lives in a sibling clone of
+# pskeshu/gently-perception and is installed editable from there.
+[tool.uv.sources]
+gently-perception = { path = "../gently-perception", editable = true }
+
 [tool.setuptools.packages.find]
 include = ["gently*"]
 exclude = ["tests*", "benchmarks*", "scripts*", "examples*"]
diff --git a/requirements-cuda.txt b/requirements-cuda.txt
deleted file mode 100644
index 0bc40341..00000000
--- a/requirements-cuda.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-# PyTorch with CUDA 12.1 support (A5000 GPUs)
-# Install with: pip install -r requirements-cuda.txt
---index-url https://download.pytorch.org/whl/cu121
-
-torch>=2.0.0
-torchvision>=0.15.0
-
-# GPU monitoring for dynamic capability provider
-nvidia-ml-py>=12.0.0
diff --git a/requirements.txt b/requirements.txt
deleted file mode 100644
index 0ea2fa09..00000000
--- a/requirements.txt
+++ /dev/null
@@ -1,43 +0,0 @@
-# Gently Copilot
-# Install: pip install -r requirements.txt
-# Canonical source: pyproject.toml [project.dependencies]
-
-# AI / LLM
-anthropic>=0.39.0
-
-# Web server (visualization + WebSocket bridge)
-fastapi>=0.104.0
-uvicorn[standard]>=0.24.0
-
-# HTTP client (communication with device layer)
-aiohttp>=3.9.0
-
-# Image processing
-numpy>=1.24.0
-pillow>=10.0.0
-tifffile>=2023.0.0
-scipy>=1.10.0
-scikit-image>=0.21.0
-
-# Plotting
-matplotlib>=3.7.0
-
-# Templates
-jinja2>=3.1.0
-
-# Configuration
-pyyaml>=6.0
-
-# Device control
-pymmcore>=11.1.1
-bluesky>=1.11.0
-ophyd>=1.9.0
-
-# ML / SAM
-torch>=2.0.0
-torchvision>=0.15.0
-nvidia-ml-py>=12.0.0
-
-# Testing
-pytest>=7.0.0
-pytest-asyncio>=0.21.0
diff --git a/requirements_device.txt b/requirements_device.txt
deleted file mode 100644
index 26b10dab..00000000
--- a/requirements_device.txt
+++ /dev/null
@@ -1,31 +0,0 @@
-# Gently Device Layer (microscope computer)
-# Install: pip install -r requirements_device.txt
-# Canonical source: pyproject.toml [project.optional-dependencies.device]
-
-# Hardware control
-pymmcore>=11.1.1
-bluesky>=1.11.0
-ophyd>=1.9.0
-
-# Web server (HTTP API for plan execution)
-aiohttp>=3.9.0
-
-# Image processing
-numpy>=1.24.0
-pillow>=10.0.0
-tifffile>=2023.0.0
-scipy>=1.10.0
-
-# Configuration
-pyyaml>=6.0
-
-# SAM embryo detection (optional, needs CUDA GPU)
-# torch>=2.0.0
-# segment-anything
-
-# BLE accessory control (SwitchBot Bot — diSPIM room light)
-bleak>=0.21.0
-
-# ACUITYnano thermal controller transports
-pyserial>=3.5
-paho-mqtt>=1.6.0
diff --git a/uv.lock b/uv.lock
new file mode 100644
index 00000000..1015cc0c
--- /dev/null
+++ b/uv.lock
@@ -0,0 +1,4261 @@
+version = 1
+revision = 3
+requires-python = ">=3.10"
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+    "python_full_version < '3.11'",
+]
+
+[[package]]
+name = "aiohappyeyeballs"
+version = "2.6.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/33/c6/61a2d7b7572279226bb2e7f61d7a19ca7c90da0329c93fa0d560cbf288d8/aiohappyeyeballs-2.6.2.tar.gz", hash = "sha256:e202810ee718bd01fc6ef49e8ea53d023d5cb6b581076d7925aa499fa55dbe64", size = 22591, upload-time = "2026-05-20T15:12:24.631Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5f/fc/a7bf5b6e4e617b45f90f2d9d2a68519c249c81dd4fc2658c7a2a61c4f4b7/aiohappyeyeballs-2.6.2-py3-none-any.whl", hash = "sha256:4708045e2d7a6c6bdf8aafa8ed39649eaf926a4543b54560659129e3365953c4", size = 15062, upload-time = "2026-05-20T15:12:23.328Z" },
+]
+
+[[package]]
+name = "aiohttp"
+version = "3.13.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "aiohappyeyeballs" },
+    { name = "aiosignal" },
+    { name = "async-timeout", marker = "python_full_version < '3.11'" },
+    { name = "attrs" },
+    { name = "frozenlist" },
+    { name = "multidict" },
+    { name = "propcache" },
+    { name = "yarl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/77/9a/152096d4808df8e4268befa55fba462f440f14beab85e8ad9bf990516918/aiohttp-3.13.5.tar.gz", hash = "sha256:9d98cc980ecc96be6eb4c1994ce35d28d8b1f5e5208a23b421187d1209dbb7d1", size = 7858271, upload-time = "2026-03-31T22:01:03.343Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bd/85/cebc47ee74d8b408749073a1a46c6fcba13d170dc8af7e61996c6c9394ac/aiohttp-3.13.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:02222e7e233295f40e011c1b00e3b0bd451f22cf853a0304c3595633ee47da4b", size = 750547, upload-time = "2026-03-31T21:56:30.024Z" },
+    { url = "https://files.pythonhosted.org/packages/05/98/afd308e35b9d3d8c9ec54c0918f1d722c86dc17ddfec272fcdbcce5a3124/aiohttp-3.13.5-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:bace460460ed20614fa6bc8cb09966c0b8517b8c58ad8046828c6078d25333b5", size = 503535, upload-time = "2026-03-31T21:56:31.935Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/4d/926c183e06b09d5270a309eb50fbde7b09782bfd305dec1e800f329834fb/aiohttp-3.13.5-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8f546a4dc1e6a5edbb9fd1fd6ad18134550e096a5a43f4ad74acfbd834fc6670", size = 497830, upload-time = "2026-03-31T21:56:33.654Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/d6/f47d1c690f115a5c2a5e8938cce4a232a5be9aac5c5fb2647efcbbbda333/aiohttp-3.13.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c86969d012e51b8e415a8c6ce96f7857d6a87d6207303ab02d5d11ef0cad2274", size = 1682474, upload-time = "2026-03-31T21:56:35.513Z" },
+    { url = "https://files.pythonhosted.org/packages/01/44/056fd37b1bb52eac760303e5196acc74d9d546631b035704ae5927f7b4ac/aiohttp-3.13.5-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b6f6cd1560c5fa427e3b6074bb24d2c64e225afbb7165008903bd42e4e33e28a", size = 1655259, upload-time = "2026-03-31T21:56:37.843Z" },
+    { url = "https://files.pythonhosted.org/packages/91/9f/78eb1a20c1c28ae02f6a3c0f4d7b0dcc66abce5290cadd53d78ce3084175/aiohttp-3.13.5-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:636bc362f0c5bbc7372bc3ae49737f9e3030dbce469f0f422c8f38079780363d", size = 1736204, upload-time = "2026-03-31T21:56:39.822Z" },
+    { url = "https://files.pythonhosted.org/packages/de/6c/d20d7de23f0b52b8c1d9e2033b2db1ac4dacbb470bb74c56de0f5f86bb4f/aiohttp-3.13.5-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6a7cbeb06d1070f1d14895eeeed4dac5913b22d7b456f2eb969f11f4b3993796", size = 1826198, upload-time = "2026-03-31T21:56:41.378Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/86/a6f3ff1fd795f49545a7c74b2c92f62729135d73e7e4055bf74da5a26c82/aiohttp-3.13.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bca9ef7517fd7874a1a08970ae88f497bf5c984610caa0bf40bd7e8450852b95", size = 1681329, upload-time = "2026-03-31T21:56:43.374Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/68/84cd3dab6b7b4f3e6fe9459a961acb142aaab846417f6e8905110d7027e5/aiohttp-3.13.5-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:019a67772e034a0e6b9b17c13d0a8fe56ad9fb150fc724b7f3ffd3724288d9e5", size = 1560023, upload-time = "2026-03-31T21:56:45.031Z" },
+    { url = "https://files.pythonhosted.org/packages/41/2c/db61b64b0249e30f954a65ab4cb4970ced57544b1de2e3c98ee5dc24165f/aiohttp-3.13.5-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:f34ecee82858e41dd217734f0c41a532bd066bcaab636ad830f03a30b2a96f2a", size = 1652372, upload-time = "2026-03-31T21:56:47.075Z" },
+    { url = "https://files.pythonhosted.org/packages/25/6f/e96988a6c982d047810c772e28c43c64c300c943b0ed5c1c0c4ce1e1027c/aiohttp-3.13.5-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:4eac02d9af4813ee289cd63a361576da36dba57f5a1ab36377bc2600db0cbb73", size = 1662031, upload-time = "2026-03-31T21:56:48.835Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/26/a56feace81f3d347b4052403a9d03754a0ab23f7940780dada0849a38c92/aiohttp-3.13.5-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:4beac52e9fe46d6abf98b0176a88154b742e878fdf209d2248e99fcdf73cd297", size = 1708118, upload-time = "2026-03-31T21:56:50.833Z" },
+    { url = "https://files.pythonhosted.org/packages/78/6e/b6173a8ff03d01d5e1a694bc06764b5dad1df2d4ed8f0ceec12bb3277936/aiohttp-3.13.5-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:c180f480207a9b2475f2b8d8bd7204e47aec952d084b2a2be58a782ffcf96074", size = 1548667, upload-time = "2026-03-31T21:56:52.81Z" },
+    { url = "https://files.pythonhosted.org/packages/16/13/13296ffe2c132d888b3fe2c195c8b9c0c24c89c3fa5cc2c44464dc23b22e/aiohttp-3.13.5-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:2837fb92951564d6339cedae4a7231692aa9f73cbc4fb2e04263b96844e03b4e", size = 1724490, upload-time = "2026-03-31T21:56:54.541Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/b4/1f1c287f4a79782ef36e5a6e62954c85343bc30470d862d30bd5f26c9fa2/aiohttp-3.13.5-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:d9010032a0b9710f58012a1e9c222528763d860ba2ee1422c03473eab47703e7", size = 1667109, upload-time = "2026-03-31T21:56:56.21Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/42/8461a2aaf60a8f4ea4549a4056be36b904b0eb03d97ca9a8a2604681a500/aiohttp-3.13.5-cp310-cp310-win32.whl", hash = "sha256:7c4b6668b2b2b9027f209ddf647f2a4407784b5d88b8be4efcc72036f365baf9", size = 439478, upload-time = "2026-03-31T21:56:58.292Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/71/06956304cb5ee439dfe8d86e1b2e70088bd88ed1ced1f42fb29e5d855f0e/aiohttp-3.13.5-cp310-cp310-win_amd64.whl", hash = "sha256:cd3db5927bf9167d5a6157ddb2f036f6b6b0ad001ac82355d43e97a4bde76d76", size = 462047, upload-time = "2026-03-31T21:57:00.257Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/f5/a20c4ac64aeaef1679e25c9983573618ff765d7aa829fa2b84ae7573169e/aiohttp-3.13.5-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:7ab7229b6f9b5c1ba4910d6c41a9eb11f543eadb3f384df1b4c293f4e73d44d6", size = 757513, upload-time = "2026-03-31T21:57:02.146Z" },
+    { url = "https://files.pythonhosted.org/packages/75/0a/39fa6c6b179b53fcb3e4b3d2b6d6cad0180854eda17060c7218540102bef/aiohttp-3.13.5-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:8f14c50708bb156b3a3ca7230b3d820199d56a48e3af76fa21c2d6087190fe3d", size = 506748, upload-time = "2026-03-31T21:57:04.275Z" },
+    { url = "https://files.pythonhosted.org/packages/87/ec/e38ce072e724fd7add6243613f8d1810da084f54175353d25ccf9f9c7e5a/aiohttp-3.13.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e7d2f8616f0ff60bd332022279011776c3ac0faa0f1b463f7bb12326fbc97a1c", size = 501673, upload-time = "2026-03-31T21:57:06.208Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/ba/3bc7525d7e2beaa11b309a70d48b0d3cfc3c2089ec6a7d0820d59c657053/aiohttp-3.13.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a2567b72e1ffc3ab25510db43f355b29eeada56c0a622e58dcdb19530eb0a3cb", size = 1763757, upload-time = "2026-03-31T21:57:07.882Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/ab/e87744cf18f1bd78263aba24924d4953b41086bd3a31d22452378e9028a0/aiohttp-3.13.5-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:fb0540c854ac9c0c5ad495908fdfd3e332d553ec731698c0e29b1877ba0d2ec6", size = 1720152, upload-time = "2026-03-31T21:57:09.946Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/f3/ed17a6f2d742af17b50bae2d152315ed1b164b07a5fd5cc1754d99e4dfa5/aiohttp-3.13.5-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c9883051c6972f58bfc4ebb2116345ee2aa151178e99c3f2b2bbe2af712abd13", size = 1818010, upload-time = "2026-03-31T21:57:12.157Z" },
+    { url = "https://files.pythonhosted.org/packages/53/06/ecbc63dc937192e2a5cb46df4d3edb21deb8225535818802f210a6ea5816/aiohttp-3.13.5-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2294172ce08a82fb7c7273485895de1fa1186cc8294cfeb6aef4af42ad261174", size = 1907251, upload-time = "2026-03-31T21:57:14.023Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/a5/0521aa32c1ddf3aa1e71dcc466be0b7db2771907a13f18cddaa45967d97b/aiohttp-3.13.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3a807cabd5115fb55af198b98178997a5e0e57dead43eb74a93d9c07d6d4a7dc", size = 1759969, upload-time = "2026-03-31T21:57:16.146Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/78/a38f8c9105199dd3b9706745865a8a59d0041b6be0ca0cc4b2ccf1bab374/aiohttp-3.13.5-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:aa6d0d932e0f39c02b80744273cd5c388a2d9bc07760a03164f229c8e02662f6", size = 1616871, upload-time = "2026-03-31T21:57:17.856Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/41/27392a61ead8ab38072105c71aa44ff891e71653fe53d576a7067da2b4e8/aiohttp-3.13.5-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:60869c7ac4aaabe7110f26499f3e6e5696eae98144735b12a9c3d9eae2b51a49", size = 1739844, upload-time = "2026-03-31T21:57:19.679Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/55/5564e7ae26d94f3214250009a0b1c65a0c6af4bf88924ccb6fdab901de28/aiohttp-3.13.5-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:26d2f8546f1dfa75efa50c3488215a903c0168d253b75fba4210f57ab77a0fb8", size = 1731969, upload-time = "2026-03-31T21:57:22.006Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/c5/705a3929149865fc941bcbdd1047b238e4a72bcb215a9b16b9d7a2e8d992/aiohttp-3.13.5-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:f1162a1492032c82f14271e831c8f4b49f2b6078f4f5fc74de2c912fa225d51d", size = 1795193, upload-time = "2026-03-31T21:57:24.256Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/19/edabed62f718d02cff7231ca0db4ef1c72504235bc467f7b67adb1679f48/aiohttp-3.13.5-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:8b14eb3262fad0dc2f89c1a43b13727e709504972186ff6a99a3ecaa77102b6c", size = 1606477, upload-time = "2026-03-31T21:57:26.364Z" },
+    { url = "https://files.pythonhosted.org/packages/de/fc/76f80ef008675637d88d0b21584596dc27410a990b0918cb1e5776545b5b/aiohttp-3.13.5-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:ca9ac61ac6db4eb6c2a0cd1d0f7e1357647b638ccc92f7e9d8d133e71ed3c6ac", size = 1813198, upload-time = "2026-03-31T21:57:28.316Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/67/5b3ac26b80adb20ea541c487f73730dc8fa107d632c998f25bbbab98fcda/aiohttp-3.13.5-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7996023b2ed59489ae4762256c8516df9820f751cf2c5da8ed2fb20ee50abab3", size = 1752321, upload-time = "2026-03-31T21:57:30.549Z" },
+    { url = "https://files.pythonhosted.org/packages/88/06/e4a2e49255ea23fa4feeb5ab092d90240d927c15e47b5b5c48dff5a9ce29/aiohttp-3.13.5-cp311-cp311-win32.whl", hash = "sha256:77dfa48c9f8013271011e51c00f8ada19851f013cde2c48fca1ba5e0caf5bb06", size = 439069, upload-time = "2026-03-31T21:57:32.388Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/43/8c7163a596dab4f8be12c190cf467a1e07e4734cf90eebb39f7f5d53fc6a/aiohttp-3.13.5-cp311-cp311-win_amd64.whl", hash = "sha256:d3a4834f221061624b8887090637db9ad4f61752001eae37d56c52fddade2dc8", size = 462859, upload-time = "2026-03-31T21:57:34.455Z" },
+    { url = "https://files.pythonhosted.org/packages/be/6f/353954c29e7dcce7cf00280a02c75f30e133c00793c7a2ed3776d7b2f426/aiohttp-3.13.5-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:023ecba036ddd840b0b19bf195bfae970083fd7024ce1ac22e9bba90464620e9", size = 748876, upload-time = "2026-03-31T21:57:36.319Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/1b/428a7c64687b3b2e9cd293186695affc0e1e54a445d0361743b231f11066/aiohttp-3.13.5-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:15c933ad7920b7d9a20de151efcd05a6e38302cbf0e10c9b2acb9a42210a2416", size = 499557, upload-time = "2026-03-31T21:57:38.236Z" },
+    { url = "https://files.pythonhosted.org/packages/29/47/7be41556bfbb6917069d6a6634bb7dd5e163ba445b783a90d40f5ac7e3a7/aiohttp-3.13.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ab2899f9fa2f9f741896ebb6fa07c4c883bfa5c7f2ddd8cf2aafa86fa981b2d2", size = 500258, upload-time = "2026-03-31T21:57:39.923Z" },
+    { url = "https://files.pythonhosted.org/packages/67/84/c9ecc5828cb0b3695856c07c0a6817a99d51e2473400f705275a2b3d9239/aiohttp-3.13.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a60eaa2d440cd4707696b52e40ed3e2b0f73f65be07fd0ef23b6b539c9c0b0b4", size = 1749199, upload-time = "2026-03-31T21:57:41.938Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/d3/3c6d610e66b495657622edb6ae7c7fd31b2e9086b4ec50b47897ad6042a9/aiohttp-3.13.5-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:55b3bdd3292283295774ab585160c4004f4f2f203946997f49aac032c84649e9", size = 1721013, upload-time = "2026-03-31T21:57:43.904Z" },
+    { url = "https://files.pythonhosted.org/packages/49/a0/24409c12217456df0bae7babe3b014e460b0b38a8e60753d6cb339f6556d/aiohttp-3.13.5-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c2b2355dc094e5f7d45a7bb262fe7207aa0460b37a0d87027dcf21b5d890e7d5", size = 1781501, upload-time = "2026-03-31T21:57:46.285Z" },
+    { url = "https://files.pythonhosted.org/packages/98/9d/b65ec649adc5bccc008b0957a9a9c691070aeac4e41cea18559fef49958b/aiohttp-3.13.5-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b38765950832f7d728297689ad78f5f2cf79ff82487131c4d26fe6ceecdc5f8e", size = 1878981, upload-time = "2026-03-31T21:57:48.734Z" },
+    { url = "https://files.pythonhosted.org/packages/57/d8/8d44036d7eb7b6a8ec4c5494ea0c8c8b94fbc0ed3991c1a7adf230df03bf/aiohttp-3.13.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b18f31b80d5a33661e08c89e202edabf1986e9b49c42b4504371daeaa11b47c1", size = 1767934, upload-time = "2026-03-31T21:57:51.171Z" },
+    { url = "https://files.pythonhosted.org/packages/31/04/d3f8211f273356f158e3464e9e45484d3fb8c4ce5eb2f6fe9405c3273983/aiohttp-3.13.5-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:33add2463dde55c4f2d9635c6ab33ce154e5ecf322bd26d09af95c5f81cfa286", size = 1566671, upload-time = "2026-03-31T21:57:53.326Z" },
+    { url = "https://files.pythonhosted.org/packages/41/db/073e4ebe00b78e2dfcacff734291651729a62953b48933d765dc513bf798/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:327cc432fdf1356fb4fbc6fe833ad4e9f6aacb71a8acaa5f1855e4b25910e4a9", size = 1705219, upload-time = "2026-03-31T21:57:55.385Z" },
+    { url = "https://files.pythonhosted.org/packages/48/45/7dfba71a2f9fd97b15c95c06819de7eb38113d2cdb6319669195a7d64270/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:7c35b0bf0b48a70b4cb4fc5d7bed9b932532728e124874355de1a0af8ec4bc88", size = 1743049, upload-time = "2026-03-31T21:57:57.341Z" },
+    { url = "https://files.pythonhosted.org/packages/18/71/901db0061e0f717d226386a7f471bb59b19566f2cae5f0d93874b017271f/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:df23d57718f24badef8656c49743e11a89fd6f5358fa8a7b96e728fda2abf7d3", size = 1749557, upload-time = "2026-03-31T21:57:59.626Z" },
+    { url = "https://files.pythonhosted.org/packages/08/d5/41eebd16066e59cd43728fe74bce953d7402f2b4ddfdfef2c0e9f17ca274/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:02e048037a6501a5ec1f6fc9736135aec6eb8a004ce48838cb951c515f32c80b", size = 1558931, upload-time = "2026-03-31T21:58:01.972Z" },
+    { url = "https://files.pythonhosted.org/packages/30/e6/4a799798bf05740e66c3a1161079bda7a3dd8e22ca392481d7a7f9af82a6/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:31cebae8b26f8a615d2b546fee45d5ffb76852ae6450e2a03f42c9102260d6fe", size = 1774125, upload-time = "2026-03-31T21:58:04.007Z" },
+    { url = "https://files.pythonhosted.org/packages/84/63/7749337c90f92bc2cb18f9560d67aa6258c7060d1397d21529b8004fcf6f/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:888e78eb5ca55a615d285c3c09a7a91b42e9dd6fc699b166ebd5dee87c9ccf14", size = 1732427, upload-time = "2026-03-31T21:58:06.337Z" },
+    { url = "https://files.pythonhosted.org/packages/98/de/cf2f44ff98d307e72fb97d5f5bbae3bfcb442f0ea9790c0bf5c5c2331404/aiohttp-3.13.5-cp312-cp312-win32.whl", hash = "sha256:8bd3ec6376e68a41f9f95f5ed170e2fcf22d4eb27a1f8cb361d0508f6e0557f3", size = 433534, upload-time = "2026-03-31T21:58:08.712Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/ca/eadf6f9c8fa5e31d40993e3db153fb5ed0b11008ad5d9de98a95045bed84/aiohttp-3.13.5-cp312-cp312-win_amd64.whl", hash = "sha256:110e448e02c729bcebb18c60b9214a87ba33bac4a9fa5e9a5f139938b56c6cb1", size = 460446, upload-time = "2026-03-31T21:58:10.945Z" },
+    { url = "https://files.pythonhosted.org/packages/78/e9/d76bf503005709e390122d34e15256b88f7008e246c4bdbe915cd4f1adce/aiohttp-3.13.5-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:a5029cc80718bbd545123cd8fe5d15025eccaaaace5d0eeec6bd556ad6163d61", size = 742930, upload-time = "2026-03-31T21:58:13.155Z" },
+    { url = "https://files.pythonhosted.org/packages/57/00/4b7b70223deaebd9bb85984d01a764b0d7bd6526fcdc73cca83bcbe7243e/aiohttp-3.13.5-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4bb6bf5811620003614076bdc807ef3b5e38244f9d25ca5fe888eaccea2a9832", size = 496927, upload-time = "2026-03-31T21:58:15.073Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/f5/0fb20fb49f8efdcdce6cd8127604ad2c503e754a8f139f5e02b01626523f/aiohttp-3.13.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a84792f8631bf5a94e52d9cc881c0b824ab42717165a5579c760b830d9392ac9", size = 497141, upload-time = "2026-03-31T21:58:17.009Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/86/b7c870053e36a94e8951b803cb5b909bfbc9b90ca941527f5fcafbf6b0fa/aiohttp-3.13.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:57653eac22c6a4c13eb22ecf4d673d64a12f266e72785ab1c8b8e5940d0e8090", size = 1732476, upload-time = "2026-03-31T21:58:18.925Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/e5/4e161f84f98d80c03a238671b4136e6530453d65262867d989bbe78244d0/aiohttp-3.13.5-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5e5f7debc7a57af53fdf5c5009f9391d9f4c12867049d509bf7bb164a6e295b", size = 1706507, upload-time = "2026-03-31T21:58:21.094Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/56/ea11a9f01518bd5a2a2fcee869d248c4b8a0cfa0bb13401574fa31adf4d4/aiohttp-3.13.5-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c719f65bebcdf6716f10e9eff80d27567f7892d8988c06de12bbbd39307c6e3a", size = 1773465, upload-time = "2026-03-31T21:58:23.159Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/40/333ca27fb74b0383f17c90570c748f7582501507307350a79d9f9f3c6eb1/aiohttp-3.13.5-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d97f93fdae594d886c5a866636397e2bcab146fd7a132fd6bb9ce182224452f8", size = 1873523, upload-time = "2026-03-31T21:58:25.59Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/d2/e2f77eef1acb7111405433c707dc735e63f67a56e176e72e9e7a2cd3f493/aiohttp-3.13.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3df334e39d4c2f899a914f1dba283c1aadc311790733f705182998c6f7cae665", size = 1754113, upload-time = "2026-03-31T21:58:27.624Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/56/3f653d7f53c89669301ec9e42c95233e2a0c0a6dd051269e6e678db4fdb0/aiohttp-3.13.5-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fe6970addfea9e5e081401bcbadf865d2b6da045472f58af08427e108d618540", size = 1562351, upload-time = "2026-03-31T21:58:29.918Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/a6/9b3e91eb8ae791cce4ee736da02211c85c6f835f1bdfac0594a8a3b7018c/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:7becdf835feff2f4f335d7477f121af787e3504b48b449ff737afb35869ba7bb", size = 1693205, upload-time = "2026-03-31T21:58:32.214Z" },
+    { url = "https://files.pythonhosted.org/packages/98/fc/bfb437a99a2fcebd6b6eaec609571954de2ed424f01c352f4b5504371dd3/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:676e5651705ad5d8a70aeb8eb6936c436d8ebbd56e63436cb7dd9bb36d2a9a46", size = 1730618, upload-time = "2026-03-31T21:58:34.728Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/b6/c8534862126191a034f68153194c389addc285a0f1347d85096d349bbc15/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:9b16c653d38eb1a611cc898c41e76859ca27f119d25b53c12875fd0474ae31a8", size = 1745185, upload-time = "2026-03-31T21:58:36.909Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/93/4ca8ee2ef5236e2707e0fd5fecb10ce214aee1ff4ab307af9c558bda3b37/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:999802d5fa0389f58decd24b537c54aa63c01c3219ce17d1214cbda3c2b22d2d", size = 1557311, upload-time = "2026-03-31T21:58:39.38Z" },
+    { url = "https://files.pythonhosted.org/packages/57/ae/76177b15f18c5f5d094f19901d284025db28eccc5ae374d1d254181d33f4/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:ec707059ee75732b1ba130ed5f9580fe10ff75180c812bc267ded039db5128c6", size = 1773147, upload-time = "2026-03-31T21:58:41.476Z" },
+    { url = "https://files.pythonhosted.org/packages/01/a4/62f05a0a98d88af59d93b7fcac564e5f18f513cb7471696ac286db970d6a/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:2d6d44a5b48132053c2f6cd5c8cb14bc67e99a63594e336b0f2af81e94d5530c", size = 1730356, upload-time = "2026-03-31T21:58:44.049Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/85/fc8601f59dfa8c9523808281f2da571f8b4699685f9809a228adcc90838d/aiohttp-3.13.5-cp313-cp313-win32.whl", hash = "sha256:329f292ed14d38a6c4c435e465f48bebb47479fd676a0411936cc371643225cc", size = 432637, upload-time = "2026-03-31T21:58:46.167Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/1b/ac685a8882896acf0f6b31d689e3792199cfe7aba37969fa91da63a7fa27/aiohttp-3.13.5-cp313-cp313-win_amd64.whl", hash = "sha256:69f571de7500e0557801c0b51f4780482c0ec5fe2ac851af5a92cfce1af1cb83", size = 458896, upload-time = "2026-03-31T21:58:48.119Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/ce/46572759afc859e867a5bc8ec3487315869013f59281ce61764f76d879de/aiohttp-3.13.5-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:eb4639f32fd4a9904ab8fb45bf3383ba71137f3d9d4ba25b3b3f3109977c5b8c", size = 745721, upload-time = "2026-03-31T21:58:50.229Z" },
+    { url = "https://files.pythonhosted.org/packages/13/fe/8a2efd7626dbe6049b2ef8ace18ffda8a4dfcbe1bcff3ac30c0c7575c20b/aiohttp-3.13.5-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:7e5dc4311bd5ac493886c63cbf76ab579dbe4641268e7c74e48e774c74b6f2be", size = 497663, upload-time = "2026-03-31T21:58:52.232Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/91/cc8cc78a111826c54743d88651e1687008133c37e5ee615fee9b57990fac/aiohttp-3.13.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:756c3c304d394977519824449600adaf2be0ccee76d206ee339c5e76b70ded25", size = 499094, upload-time = "2026-03-31T21:58:54.566Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/33/a8362cb15cf16a3af7e86ed11962d5cd7d59b449202dc576cdc731310bde/aiohttp-3.13.5-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ecc26751323224cf8186efcf7fbcbc30f4e1d8c7970659daf25ad995e4032a56", size = 1726701, upload-time = "2026-03-31T21:58:56.864Z" },
+    { url = "https://files.pythonhosted.org/packages/45/0c/c091ac5c3a17114bd76cbf85d674650969ddf93387876cf67f754204bd77/aiohttp-3.13.5-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:10a75acfcf794edf9d8db50e5a7ec5fc818b2a8d3f591ce93bc7b1210df016d2", size = 1683360, upload-time = "2026-03-31T21:58:59.072Z" },
+    { url = "https://files.pythonhosted.org/packages/23/73/bcee1c2b79bc275e964d1446c55c54441a461938e70267c86afaae6fba27/aiohttp-3.13.5-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0f7a18f258d124cd678c5fe072fe4432a4d5232b0657fca7c1847f599233c83a", size = 1773023, upload-time = "2026-03-31T21:59:01.776Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/ef/720e639df03004fee2d869f771799d8c23046dec47d5b81e396c7cda583a/aiohttp-3.13.5-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:df6104c009713d3a89621096f3e3e88cc323fd269dbd7c20afe18535094320be", size = 1853795, upload-time = "2026-03-31T21:59:04.568Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/c9/989f4034fb46841208de7aeeac2c6d8300745ab4f28c42f629ba77c2d916/aiohttp-3.13.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:241a94f7de7c0c3b616627aaad530fe2cb620084a8b144d3be7b6ecfe95bae3b", size = 1730405, upload-time = "2026-03-31T21:59:07.221Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/75/ee1fd286ca7dc599d824b5651dad7b3be7ff8d9a7e7b3fe9820d9180f7db/aiohttp-3.13.5-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c974fb66180e58709b6fc402846f13791240d180b74de81d23913abe48e96d94", size = 1558082, upload-time = "2026-03-31T21:59:09.484Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/20/1e9e6650dfc436340116b7aa89ff8cb2bbdf0abc11dfaceaad8f74273a10/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:6e27ea05d184afac78aabbac667450c75e54e35f62238d44463131bd3f96753d", size = 1692346, upload-time = "2026-03-31T21:59:12.068Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/40/8ebc6658d48ea630ac7903912fe0dd4e262f0e16825aa4c833c56c9f1f56/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:a79a6d399cef33a11b6f004c67bb07741d91f2be01b8d712d52c75711b1e07c7", size = 1698891, upload-time = "2026-03-31T21:59:14.552Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/78/ea0ae5ec8ba7a5c10bdd6e318f1ba5e76fcde17db8275188772afc7917a4/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:c632ce9c0b534fbe25b52c974515ed674937c5b99f549a92127c85f771a78772", size = 1742113, upload-time = "2026-03-31T21:59:17.068Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/66/9d308ed71e3f2491be1acb8769d96c6f0c47d92099f3bc9119cada27b357/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:fceedde51fbd67ee2bcc8c0b33d0126cc8b51ef3bbde2f86662bd6d5a6f10ec5", size = 1553088, upload-time = "2026-03-31T21:59:19.541Z" },
+    { url = "https://files.pythonhosted.org/packages/da/a6/6cc25ed8dfc6e00c90f5c6d126a98e2cf28957ad06fa1036bd34b6f24a2c/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:f92995dfec9420bb69ae629abf422e516923ba79ba4403bc750d94fb4a6c68c1", size = 1757976, upload-time = "2026-03-31T21:59:22.311Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/2b/cce5b0ffe0de99c83e5e36d8f828e4161e415660a9f3e58339d07cce3006/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:20ae0ff08b1f2c8788d6fb85afcb798654ae6ba0b747575f8562de738078457b", size = 1712444, upload-time = "2026-03-31T21:59:24.635Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/cf/9e1795b4160c58d29421eafd1a69c6ce351e2f7c8d3c6b7e4ca44aea1a5b/aiohttp-3.13.5-cp314-cp314-win32.whl", hash = "sha256:b20df693de16f42b2472a9c485e1c948ee55524786a0a34345511afdd22246f3", size = 438128, upload-time = "2026-03-31T21:59:27.291Z" },
+    { url = "https://files.pythonhosted.org/packages/22/4d/eaedff67fc805aeba4ba746aec891b4b24cebb1a7d078084b6300f79d063/aiohttp-3.13.5-cp314-cp314-win_amd64.whl", hash = "sha256:f85c6f327bf0b8c29da7d93b1cabb6363fb5e4e160a32fa241ed2dce21b73162", size = 464029, upload-time = "2026-03-31T21:59:29.429Z" },
+    { url = "https://files.pythonhosted.org/packages/79/11/c27d9332ee20d68dd164dc12a6ecdef2e2e35ecc97ed6cf0d2442844624b/aiohttp-3.13.5-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:1efb06900858bb618ff5cee184ae2de5828896c448403d51fb633f09e109be0a", size = 778758, upload-time = "2026-03-31T21:59:31.547Z" },
+    { url = "https://files.pythonhosted.org/packages/04/fb/377aead2e0a3ba5f09b7624f702a964bdf4f08b5b6728a9799830c80041e/aiohttp-3.13.5-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:fee86b7c4bd29bdaf0d53d14739b08a106fdda809ca5fe032a15f52fae5fe254", size = 512883, upload-time = "2026-03-31T21:59:34.098Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/a6/aa109a33671f7a5d3bd78b46da9d852797c5e665bfda7d6b373f56bff2ec/aiohttp-3.13.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:20058e23909b9e65f9da62b396b77dfa95965cbe840f8def6e572538b1d32e36", size = 516668, upload-time = "2026-03-31T21:59:36.497Z" },
+    { url = "https://files.pythonhosted.org/packages/79/b3/ca078f9f2fa9563c36fb8ef89053ea2bb146d6f792c5104574d49d8acb63/aiohttp-3.13.5-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8cf20a8d6868cb15a73cab329ffc07291ba8c22b1b88176026106ae39aa6df0f", size = 1883461, upload-time = "2026-03-31T21:59:38.723Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/e3/a7ad633ca1ca497b852233a3cce6906a56c3225fb6d9217b5e5e60b7419d/aiohttp-3.13.5-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:330f5da04c987f1d5bdb8ae189137c77139f36bd1cb23779ca1a354a4b027800", size = 1747661, upload-time = "2026-03-31T21:59:41.187Z" },
+    { url = "https://files.pythonhosted.org/packages/33/b9/cd6fe579bed34a906d3d783fe60f2fa297ef55b27bb4538438ee49d4dc41/aiohttp-3.13.5-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6f1cbf0c7926d315c3c26c2da41fd2b5d2fe01ac0e157b78caefc51a782196cf", size = 1863800, upload-time = "2026-03-31T21:59:43.84Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/3f/2c1e2f5144cefa889c8afd5cf431994c32f3b29da9961698ff4e3811b79a/aiohttp-3.13.5-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:53fc049ed6390d05423ba33103ded7281fe897cf97878f369a527070bd95795b", size = 1958382, upload-time = "2026-03-31T21:59:46.187Z" },
+    { url = "https://files.pythonhosted.org/packages/66/1d/f31ec3f1013723b3babe3609e7f119c2c2fb6ef33da90061a705ef3e1bc8/aiohttp-3.13.5-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:898703aa2667e3c5ca4c54ca36cd73f58b7a38ef87a5606414799ebce4d3fd3a", size = 1803724, upload-time = "2026-03-31T21:59:48.656Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/b4/57712dfc6f1542f067daa81eb61da282fab3e6f1966fca25db06c4fc62d5/aiohttp-3.13.5-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0494a01ca9584eea1e5fbd6d748e61ecff218c51b576ee1999c23db7066417d8", size = 1640027, upload-time = "2026-03-31T21:59:51.284Z" },
+    { url = "https://files.pythonhosted.org/packages/25/3c/734c878fb43ec083d8e31bf029daae1beafeae582d1b35da234739e82ee7/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:6cf81fe010b8c17b09495cbd15c1d35afbc8fb405c0c9cf4738e5ae3af1d65be", size = 1806644, upload-time = "2026-03-31T21:59:53.753Z" },
+    { url = "https://files.pythonhosted.org/packages/20/a5/f671e5cbec1c21d044ff3078223f949748f3a7f86b14e34a365d74a5d21f/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:c564dd5f09ddc9d8f2c2d0a301cd30a79a2cc1b46dd1a73bef8f0038863d016b", size = 1791630, upload-time = "2026-03-31T21:59:56.239Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/63/fb8d0ad63a0b8a99be97deac8c04dacf0785721c158bdf23d679a87aa99e/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:2994be9f6e51046c4f864598fd9abeb4fba6e88f0b2152422c9666dcd4aea9c6", size = 1809403, upload-time = "2026-03-31T21:59:59.103Z" },
+    { url = "https://files.pythonhosted.org/packages/59/0c/bfed7f30662fcf12206481c2aac57dedee43fe1c49275e85b3a1e1742294/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:157826e2fa245d2ef46c83ea8a5faf77ca19355d278d425c29fda0beb3318037", size = 1634924, upload-time = "2026-03-31T22:00:02.116Z" },
+    { url = "https://files.pythonhosted.org/packages/17/d6/fd518d668a09fd5a3319ae5e984d4d80b9a4b3df4e21c52f02251ef5a32e/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:a8aca50daa9493e9e13c0f566201a9006f080e7c50e5e90d0b06f53146a54500", size = 1836119, upload-time = "2026-03-31T22:00:04.756Z" },
+    { url = "https://files.pythonhosted.org/packages/78/b7/15fb7a9d52e112a25b621c67b69c167805cb1f2ab8f1708a5c490d1b52fe/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:3b13560160d07e047a93f23aaa30718606493036253d5430887514715b67c9d9", size = 1772072, upload-time = "2026-03-31T22:00:07.494Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/df/57ba7f0c4a553fc2bd8b6321df236870ec6fd64a2a473a8a13d4f733214e/aiohttp-3.13.5-cp314-cp314t-win32.whl", hash = "sha256:9a0f4474b6ea6818b41f82172d799e4b3d29e22c2c520ce4357856fced9af2f8", size = 471819, upload-time = "2026-03-31T22:00:10.277Z" },
+    { url = "https://files.pythonhosted.org/packages/62/29/2f8418269e46454a26171bfdd6a055d74febf32234e474930f2f60a17145/aiohttp-3.13.5-cp314-cp314t-win_amd64.whl", hash = "sha256:18a2f6c1182c51baa1d28d68fea51513cb2a76612f038853c0ad3c145423d3d9", size = 505441, upload-time = "2026-03-31T22:00:12.791Z" },
+]
+
+[[package]]
+name = "aiosignal"
+version = "1.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "frozenlist" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/61/62/06741b579156360248d1ec624842ad0edf697050bbaf7c3e46394e106ad1/aiosignal-1.4.0.tar.gz", hash = "sha256:f47eecd9468083c2029cc99945502cb7708b082c232f9aca65da147157b251c7", size = 25007, upload-time = "2025-07-03T22:54:43.528Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/76/641ae371508676492379f16e2fa48f4e2c11741bd63c48be4b12a6b09cba/aiosignal-1.4.0-py3-none-any.whl", hash = "sha256:053243f8b92b990551949e63930a839ff0cf0b0ebbe0597b0f3fb19e1a0fe82e", size = 7490, upload-time = "2025-07-03T22:54:42.156Z" },
+]
+
+[[package]]
+name = "annotated-doc"
+version = "0.0.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/ba/046ceea27344560984e26a590f90bc7f4a75b06701f653222458922b558c/annotated_doc-0.0.4.tar.gz", hash = "sha256:fbcda96e87e9c92ad167c2e53839e57503ecfda18804ea28102353485033faa4", size = 7288, upload-time = "2025-11-10T22:07:42.062Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/d3/26bf1008eb3d2daa8ef4cacc7f3bfdc11818d111f7e2d0201bc6e3b49d45/annotated_doc-0.0.4-py3-none-any.whl", hash = "sha256:571ac1dc6991c450b25a9c2d84a3705e2ae7a53467b5d111c24fa8baabbed320", size = 5303, upload-time = "2025-11-10T22:07:40.673Z" },
+]
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "anthropic"
+version = "0.105.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "distro" },
+    { name = "docstring-parser" },
+    { name = "httpx" },
+    { name = "jiter" },
+    { name = "pydantic" },
+    { name = "sniffio" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/46/46/47581b8c689c743ceabf6a0f9ff48472160900ce802d26c0fb50423997b3/anthropic-0.105.2.tar.gz", hash = "sha256:0e26b90841c2dced7cc6e98d21d5517d0be33f1876b8e779f478202e28bcaa07", size = 853789, upload-time = "2026-05-29T00:21:14.104Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/83/75/be0c357e33a5a56c8f9db5b4212f886138d2bf59c0952d858f6b75d710ef/anthropic-0.105.2-py3-none-any.whl", hash = "sha256:e53ed5f6bf36fb1ecb9b25d8634cfd30e02fab9fb3374a0c2d5c585874757230", size = 837507, upload-time = "2026-05-29T00:21:15.528Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
+]
+
+[[package]]
+name = "async-timeout"
+version = "5.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a5/ae/136395dfbfe00dfc94da3f3e136d0b13f394cba8f4841120e34226265780/async_timeout-5.0.1.tar.gz", hash = "sha256:d9321a7a3d5a6a5e187e824d2fa0793ce379a202935782d555d6e9d2735677d3", size = 9274, upload-time = "2024-11-06T16:41:39.6Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fe/ba/e2081de779ca30d473f21f5b30e0e737c438205440784c7dfc81efc2b029/async_timeout-5.0.1-py3-none-any.whl", hash = "sha256:39e3809566ff85354557ec2398b55e096c8364bacac9405a7a1fa429e77fe76c", size = 6233, upload-time = "2024-11-06T16:41:37.9Z" },
+]
+
+[[package]]
+name = "attrs"
+version = "26.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9a/8e/82a0fe20a541c03148528be8cac2408564a6c9a0cc7e9171802bc1d26985/attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32", size = 952055, upload-time = "2026-03-19T14:22:25.026Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/64/b4/17d4b0b2a2dc85a6df63d1157e028ed19f90d4cd97c36717afef2bc2f395/attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309", size = 67548, upload-time = "2026-03-19T14:22:23.645Z" },
+]
+
+[[package]]
+name = "backports-asyncio-runner"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8e/ff/70dca7d7cb1cbc0edb2c6cc0c38b65cba36cccc491eca64cabd5fe7f8670/backports_asyncio_runner-1.2.0.tar.gz", hash = "sha256:a5aa7b2b7d8f8bfcaa2b57313f70792df84e32a2a746f585213373f900b42162", size = 69893, upload-time = "2025-07-02T02:27:15.685Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/59/76ab57e3fe74484f48a53f8e337171b4a2349e506eabe136d7e01d059086/backports_asyncio_runner-1.2.0-py3-none-any.whl", hash = "sha256:0da0a936a8aeb554eccb426dc55af3ba63bcdc69fa1a600b5bb305413a4477b5", size = 12313, upload-time = "2025-07-02T02:27:14.263Z" },
+]
+
+[[package]]
+name = "bleak"
+version = "3.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "async-timeout", marker = "python_full_version < '3.11'" },
+    { name = "dbus-fast", marker = "sys_platform == 'linux'" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin'" },
+    { name = "pyobjc-framework-corebluetooth", marker = "sys_platform == 'darwin'" },
+    { name = "pyobjc-framework-libdispatch", marker = "sys_platform == 'darwin'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.12'" },
+    { name = "winrt-runtime", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-devices-bluetooth", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-devices-bluetooth-advertisement", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-devices-bluetooth-genericattributeprofile", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-devices-enumeration", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-devices-radios", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-foundation", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-foundation-collections", marker = "sys_platform == 'win32'" },
+    { name = "winrt-windows-storage-streams", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/16/df/05a3f80ca8e3f7f5b0dba68a9e618147c909ccdba1468f07487dc8d72a9d/bleak-3.0.2.tar.gz", hash = "sha256:c2229cb8238d5876b4bd05c74bf7a1aea1f88da39d2e51ac9dfd5cc319d5265f", size = 125293, upload-time = "2026-05-02T23:01:04.066Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/26/54/05aceb9cd80073805b3ed8522e3196e8cb22f70e741873fa51406c31f4e7/bleak-3.0.2-py3-none-any.whl", hash = "sha256:39092feb9e83f1df5ad2f88e837723c7211c982ce9e9cda6235104bc2ebe0d0d", size = 146490, upload-time = "2026-05-02T23:01:02.592Z" },
+]
+
+[[package]]
+name = "bluesky"
+version = "1.15.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cycler" },
+    { name = "event-model" },
+    { name = "historydict" },
+    { name = "msgpack" },
+    { name = "msgpack-numpy" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "opentelemetry-api" },
+    { name = "toolz" },
+    { name = "tqdm" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/83/2e5d1956a1c4cd3d4f0bb34605cc2b11f2ce33e48249773292b27e6bba88/bluesky-1.15.1.tar.gz", hash = "sha256:956e161a8f34f698af28edcd501db118fa793a6c43241001e30ed8c6aaabd95c", size = 513978, upload-time = "2026-05-06T14:06:40.116Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8e/99/cc217b2a727fdf730d0c0064bc8c03473dfe5d0528f2bd0c4f59fdab4179/bluesky-1.15.1-py3-none-any.whl", hash = "sha256:7b3a0f04cf2bb0a7907771e014e59fe6fced777347df8df84adec7239f6c3d2a", size = 372701, upload-time = "2026-05-06T14:06:38.618Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.5.20"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f3/ce/ee2ecad540810a79593028e88299baeae54d346cc7a0d94b6199988b89b1/certifi-2026.5.20.tar.gz", hash = "sha256:69dea482ab64caa7b9f6aba1c6bf48bb6a5448d1c0f1b17ab42ad8c763a5344d", size = 135422, upload-time = "2026-05-20T11:46:50.073Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/59/8c/57e832b7af6d7c5abe66eb3fbe3a3a32f4d11ea23a1aa7131371035be991/certifi-2026.5.20-py3-none-any.whl", hash = "sha256:3c52e209ba0a4ad7aebe60436a4ab349c39e1e602e8c134221e546902ad25897", size = 134134, upload-time = "2026-05-20T11:46:48.578Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.4.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9b/98/518d8e5081007684232226f475082b30087d0f585e8457db087298259f49/click-8.4.1.tar.gz", hash = "sha256:918b5633eddf6b41c32d4f454bf0de810065c74e3f7dbf8ee5452f8be88d3e96", size = 353007, upload-time = "2026-05-22T04:08:37.769Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/0d/67e5b4109ea4a837e80daa87c2c696711955e40449a97e8926672534def2/click-8.4.1-py3-none-any.whl", hash = "sha256:482be17c6991b8c19c5429a1e995d9b0efdbb63172824c41f99965dc0ade8ec2", size = 116639, upload-time = "2026-05-22T04:08:35.26Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "contourpy"
+version = "1.3.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/54/eb9bfc647b19f2009dd5c7f5ec51c4e6ca831725f1aea7a993034f483147/contourpy-1.3.2.tar.gz", hash = "sha256:b6945942715a034c671b7fc54f9588126b0b8bf23db2696e3ca8328f3ff0ab54", size = 13466130, upload-time = "2025-04-15T17:47:53.79Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/a3/da4153ec8fe25d263aa48c1a4cbde7f49b59af86f0b6f7862788c60da737/contourpy-1.3.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:ba38e3f9f330af820c4b27ceb4b9c7feee5fe0493ea53a8720f4792667465934", size = 268551, upload-time = "2025-04-15T17:34:46.581Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/6c/330de89ae1087eb622bfca0177d32a7ece50c3ef07b28002de4757d9d875/contourpy-1.3.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:dc41ba0714aa2968d1f8674ec97504a8f7e334f48eeacebcaa6256213acb0989", size = 253399, upload-time = "2025-04-15T17:34:51.427Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/bd/20c6726b1b7f81a8bee5271bed5c165f0a8e1f572578a9d27e2ccb763cb2/contourpy-1.3.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9be002b31c558d1ddf1b9b415b162c603405414bacd6932d031c5b5a8b757f0d", size = 312061, upload-time = "2025-04-15T17:34:55.961Z" },
+    { url = "https://files.pythonhosted.org/packages/22/fc/a9665c88f8a2473f823cf1ec601de9e5375050f1958cbb356cdf06ef1ab6/contourpy-1.3.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8d2e74acbcba3bfdb6d9d8384cdc4f9260cae86ed9beee8bd5f54fee49a430b9", size = 351956, upload-time = "2025-04-15T17:35:00.992Z" },
+    { url = "https://files.pythonhosted.org/packages/25/eb/9f0a0238f305ad8fb7ef42481020d6e20cf15e46be99a1fcf939546a177e/contourpy-1.3.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e259bced5549ac64410162adc973c5e2fb77f04df4a439d00b478e57a0e65512", size = 320872, upload-time = "2025-04-15T17:35:06.177Z" },
+    { url = "https://files.pythonhosted.org/packages/32/5c/1ee32d1c7956923202f00cf8d2a14a62ed7517bdc0ee1e55301227fc273c/contourpy-1.3.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ad687a04bc802cbe8b9c399c07162a3c35e227e2daccf1668eb1f278cb698631", size = 325027, upload-time = "2025-04-15T17:35:11.244Z" },
+    { url = "https://files.pythonhosted.org/packages/83/bf/9baed89785ba743ef329c2b07fd0611d12bfecbedbdd3eeecf929d8d3b52/contourpy-1.3.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:cdd22595308f53ef2f891040ab2b93d79192513ffccbd7fe19be7aa773a5e09f", size = 1306641, upload-time = "2025-04-15T17:35:26.701Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/cc/74e5e83d1e35de2d28bd97033426b450bc4fd96e092a1f7a63dc7369b55d/contourpy-1.3.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:b4f54d6a2defe9f257327b0f243612dd051cc43825587520b1bf74a31e2f6ef2", size = 1374075, upload-time = "2025-04-15T17:35:43.204Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/42/17f3b798fd5e033b46a16f8d9fcb39f1aba051307f5ebf441bad1ecf78f8/contourpy-1.3.2-cp310-cp310-win32.whl", hash = "sha256:f939a054192ddc596e031e50bb13b657ce318cf13d264f095ce9db7dc6ae81c0", size = 177534, upload-time = "2025-04-15T17:35:46.554Z" },
+    { url = "https://files.pythonhosted.org/packages/54/ec/5162b8582f2c994721018d0c9ece9dc6ff769d298a8ac6b6a652c307e7df/contourpy-1.3.2-cp310-cp310-win_amd64.whl", hash = "sha256:c440093bbc8fc21c637c03bafcbef95ccd963bc6e0514ad887932c18ca2a759a", size = 221188, upload-time = "2025-04-15T17:35:50.064Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/b9/ede788a0b56fc5b071639d06c33cb893f68b1178938f3425debebe2dab78/contourpy-1.3.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6a37a2fb93d4df3fc4c0e363ea4d16f83195fc09c891bc8ce072b9d084853445", size = 269636, upload-time = "2025-04-15T17:35:54.473Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/75/3469f011d64b8bbfa04f709bfc23e1dd71be54d05b1b083be9f5b22750d1/contourpy-1.3.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:b7cd50c38f500bbcc9b6a46643a40e0913673f869315d8e70de0438817cb7773", size = 254636, upload-time = "2025-04-15T17:35:58.283Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/2f/95adb8dae08ce0ebca4fd8e7ad653159565d9739128b2d5977806656fcd2/contourpy-1.3.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d6658ccc7251a4433eebd89ed2672c2ed96fba367fd25ca9512aa92a4b46c4f1", size = 313053, upload-time = "2025-04-15T17:36:03.235Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/a6/8ccf97a50f31adfa36917707fe39c9a0cbc24b3bbb58185577f119736cc9/contourpy-1.3.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:70771a461aaeb335df14deb6c97439973d253ae70660ca085eec25241137ef43", size = 352985, upload-time = "2025-04-15T17:36:08.275Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/b6/7925ab9b77386143f39d9c3243fdd101621b4532eb126743201160ffa7e6/contourpy-1.3.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:65a887a6e8c4cd0897507d814b14c54a8c2e2aa4ac9f7686292f9769fcf9a6ab", size = 323750, upload-time = "2025-04-15T17:36:13.29Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/f3/20c5d1ef4f4748e52d60771b8560cf00b69d5c6368b5c2e9311bcfa2a08b/contourpy-1.3.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3859783aefa2b8355697f16642695a5b9792e7a46ab86da1118a4a23a51a33d7", size = 326246, upload-time = "2025-04-15T17:36:18.329Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/e5/9dae809e7e0b2d9d70c52b3d24cba134dd3dad979eb3e5e71f5df22ed1f5/contourpy-1.3.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:eab0f6db315fa4d70f1d8ab514e527f0366ec021ff853d7ed6a2d33605cf4b83", size = 1308728, upload-time = "2025-04-15T17:36:33.878Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/4a/0058ba34aeea35c0b442ae61a4f4d4ca84d6df8f91309bc2d43bb8dd248f/contourpy-1.3.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:d91a3ccc7fea94ca0acab82ceb77f396d50a1f67412efe4c526f5d20264e6ecd", size = 1375762, upload-time = "2025-04-15T17:36:51.295Z" },
+    { url = "https://files.pythonhosted.org/packages/09/33/7174bdfc8b7767ef2c08ed81244762d93d5c579336fc0b51ca57b33d1b80/contourpy-1.3.2-cp311-cp311-win32.whl", hash = "sha256:1c48188778d4d2f3d48e4643fb15d8608b1d01e4b4d6b0548d9b336c28fc9b6f", size = 178196, upload-time = "2025-04-15T17:36:55.002Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/fe/4029038b4e1c4485cef18e480b0e2cd2d755448bb071eb9977caac80b77b/contourpy-1.3.2-cp311-cp311-win_amd64.whl", hash = "sha256:5ebac872ba09cb8f2131c46b8739a7ff71de28a24c869bcad554477eb089a878", size = 222017, upload-time = "2025-04-15T17:36:58.576Z" },
+    { url = "https://files.pythonhosted.org/packages/34/f7/44785876384eff370c251d58fd65f6ad7f39adce4a093c934d4a67a7c6b6/contourpy-1.3.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:4caf2bcd2969402bf77edc4cb6034c7dd7c0803213b3523f111eb7460a51b8d2", size = 271580, upload-time = "2025-04-15T17:37:03.105Z" },
+    { url = "https://files.pythonhosted.org/packages/93/3b/0004767622a9826ea3d95f0e9d98cd8729015768075d61f9fea8eeca42a8/contourpy-1.3.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:82199cb78276249796419fe36b7386bd8d2cc3f28b3bc19fe2454fe2e26c4c15", size = 255530, upload-time = "2025-04-15T17:37:07.026Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/bb/7bd49e1f4fa805772d9fd130e0d375554ebc771ed7172f48dfcd4ca61549/contourpy-1.3.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:106fab697af11456fcba3e352ad50effe493a90f893fca6c2ca5c033820cea92", size = 307688, upload-time = "2025-04-15T17:37:11.481Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/97/e1d5dbbfa170725ef78357a9a0edc996b09ae4af170927ba8ce977e60a5f/contourpy-1.3.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d14f12932a8d620e307f715857107b1d1845cc44fdb5da2bc8e850f5ceba9f87", size = 347331, upload-time = "2025-04-15T17:37:18.212Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/66/e69e6e904f5ecf6901be3dd16e7e54d41b6ec6ae3405a535286d4418ffb4/contourpy-1.3.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:532fd26e715560721bb0d5fc7610fce279b3699b018600ab999d1be895b09415", size = 318963, upload-time = "2025-04-15T17:37:22.76Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/32/b8a1c8965e4f72482ff2d1ac2cd670ce0b542f203c8e1d34e7c3e6925da7/contourpy-1.3.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f26b383144cf2d2c29f01a1e8170f50dacf0eac02d64139dcd709a8ac4eb3cfe", size = 323681, upload-time = "2025-04-15T17:37:33.001Z" },
+    { url = "https://files.pythonhosted.org/packages/30/c6/12a7e6811d08757c7162a541ca4c5c6a34c0f4e98ef2b338791093518e40/contourpy-1.3.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:c49f73e61f1f774650a55d221803b101d966ca0c5a2d6d5e4320ec3997489441", size = 1308674, upload-time = "2025-04-15T17:37:48.64Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/8a/bebe5a3f68b484d3a2b8ffaf84704b3e343ef1addea528132ef148e22b3b/contourpy-1.3.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:3d80b2c0300583228ac98d0a927a1ba6a2ba6b8a742463c564f1d419ee5b211e", size = 1380480, upload-time = "2025-04-15T17:38:06.7Z" },
+    { url = "https://files.pythonhosted.org/packages/34/db/fcd325f19b5978fb509a7d55e06d99f5f856294c1991097534360b307cf1/contourpy-1.3.2-cp312-cp312-win32.whl", hash = "sha256:90df94c89a91b7362e1142cbee7568f86514412ab8a2c0d0fca72d7e91b62912", size = 178489, upload-time = "2025-04-15T17:38:10.338Z" },
+    { url = "https://files.pythonhosted.org/packages/01/c8/fadd0b92ffa7b5eb5949bf340a63a4a496a6930a6c37a7ba0f12acb076d6/contourpy-1.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:8c942a01d9163e2e5cfb05cb66110121b8d07ad438a17f9e766317bcb62abf73", size = 223042, upload-time = "2025-04-15T17:38:14.239Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/61/5673f7e364b31e4e7ef6f61a4b5121c5f170f941895912f773d95270f3a2/contourpy-1.3.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:de39db2604ae755316cb5967728f4bea92685884b1e767b7c24e983ef5f771cb", size = 271630, upload-time = "2025-04-15T17:38:19.142Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/66/a40badddd1223822c95798c55292844b7e871e50f6bfd9f158cb25e0bd39/contourpy-1.3.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:3f9e896f447c5c8618f1edb2bafa9a4030f22a575ec418ad70611450720b5b08", size = 255670, upload-time = "2025-04-15T17:38:23.688Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/c7/cf9fdee8200805c9bc3b148f49cb9482a4e3ea2719e772602a425c9b09f8/contourpy-1.3.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:71e2bd4a1c4188f5c2b8d274da78faab884b59df20df63c34f74aa1813c4427c", size = 306694, upload-time = "2025-04-15T17:38:28.238Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/e7/ccb9bec80e1ba121efbffad7f38021021cda5be87532ec16fd96533bb2e0/contourpy-1.3.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:de425af81b6cea33101ae95ece1f696af39446db9682a0b56daaa48cfc29f38f", size = 345986, upload-time = "2025-04-15T17:38:33.502Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/49/ca13bb2da90391fa4219fdb23b078d6065ada886658ac7818e5441448b78/contourpy-1.3.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:977e98a0e0480d3fe292246417239d2d45435904afd6d7332d8455981c408b85", size = 318060, upload-time = "2025-04-15T17:38:38.672Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/65/5245ce8c548a8422236c13ffcdcdada6a2a812c361e9e0c70548bb40b661/contourpy-1.3.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:434f0adf84911c924519d2b08fc10491dd282b20bdd3fa8f60fd816ea0b48841", size = 322747, upload-time = "2025-04-15T17:38:43.712Z" },
+    { url = "https://files.pythonhosted.org/packages/72/30/669b8eb48e0a01c660ead3752a25b44fdb2e5ebc13a55782f639170772f9/contourpy-1.3.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:c66c4906cdbc50e9cba65978823e6e00b45682eb09adbb78c9775b74eb222422", size = 1308895, upload-time = "2025-04-15T17:39:00.224Z" },
+    { url = "https://files.pythonhosted.org/packages/05/5a/b569f4250decee6e8d54498be7bdf29021a4c256e77fe8138c8319ef8eb3/contourpy-1.3.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8b7fc0cd78ba2f4695fd0a6ad81a19e7e3ab825c31b577f384aa9d7817dc3bef", size = 1379098, upload-time = "2025-04-15T17:43:29.649Z" },
+    { url = "https://files.pythonhosted.org/packages/19/ba/b227c3886d120e60e41b28740ac3617b2f2b971b9f601c835661194579f1/contourpy-1.3.2-cp313-cp313-win32.whl", hash = "sha256:15ce6ab60957ca74cff444fe66d9045c1fd3e92c8936894ebd1f3eef2fff075f", size = 178535, upload-time = "2025-04-15T17:44:44.532Z" },
+    { url = "https://files.pythonhosted.org/packages/12/6e/2fed56cd47ca739b43e892707ae9a13790a486a3173be063681ca67d2262/contourpy-1.3.2-cp313-cp313-win_amd64.whl", hash = "sha256:e1578f7eafce927b168752ed7e22646dad6cd9bca673c60bff55889fa236ebf9", size = 223096, upload-time = "2025-04-15T17:44:48.194Z" },
+    { url = "https://files.pythonhosted.org/packages/54/4c/e76fe2a03014a7c767d79ea35c86a747e9325537a8b7627e0e5b3ba266b4/contourpy-1.3.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0475b1f6604896bc7c53bb070e355e9321e1bc0d381735421a2d2068ec56531f", size = 285090, upload-time = "2025-04-15T17:43:34.084Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/e2/5aba47debd55d668e00baf9651b721e7733975dc9fc27264a62b0dd26eb8/contourpy-1.3.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:c85bb486e9be652314bb5b9e2e3b0d1b2e643d5eec4992c0fbe8ac71775da739", size = 268643, upload-time = "2025-04-15T17:43:38.626Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/37/cd45f1f051fe6230f751cc5cdd2728bb3a203f5619510ef11e732109593c/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:745b57db7758f3ffc05a10254edd3182a2a83402a89c00957a8e8a22f5582823", size = 310443, upload-time = "2025-04-15T17:43:44.522Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/a2/36ea6140c306c9ff6dd38e3bcec80b3b018474ef4d17eb68ceecd26675f4/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:970e9173dbd7eba9b4e01aab19215a48ee5dd3f43cef736eebde064a171f89a5", size = 349865, upload-time = "2025-04-15T17:43:49.545Z" },
+    { url = "https://files.pythonhosted.org/packages/95/b7/2fc76bc539693180488f7b6cc518da7acbbb9e3b931fd9280504128bf956/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c6c4639a9c22230276b7bffb6a850dfc8258a2521305e1faefe804d006b2e532", size = 321162, upload-time = "2025-04-15T17:43:54.203Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/10/76d4f778458b0aa83f96e59d65ece72a060bacb20cfbee46cf6cd5ceba41/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc829960f34ba36aad4302e78eabf3ef16a3a100863f0d4eeddf30e8a485a03b", size = 327355, upload-time = "2025-04-15T17:44:01.025Z" },
+    { url = "https://files.pythonhosted.org/packages/43/a3/10cf483ea683f9f8ab096c24bad3cce20e0d1dd9a4baa0e2093c1c962d9d/contourpy-1.3.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:d32530b534e986374fc19eaa77fcb87e8a99e5431499949b828312bdcd20ac52", size = 1307935, upload-time = "2025-04-15T17:44:17.322Z" },
+    { url = "https://files.pythonhosted.org/packages/78/73/69dd9a024444489e22d86108e7b913f3528f56cfc312b5c5727a44188471/contourpy-1.3.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:e298e7e70cf4eb179cc1077be1c725b5fd131ebc81181bf0c03525c8abc297fd", size = 1372168, upload-time = "2025-04-15T17:44:33.43Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/1b/96d586ccf1b1a9d2004dd519b25fbf104a11589abfd05484ff12199cca21/contourpy-1.3.2-cp313-cp313t-win32.whl", hash = "sha256:d0e589ae0d55204991450bb5c23f571c64fe43adaa53f93fc902a84c96f52fe1", size = 189550, upload-time = "2025-04-15T17:44:37.092Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/e6/6000d0094e8a5e32ad62591c8609e269febb6e4db83a1c75ff8868b42731/contourpy-1.3.2-cp313-cp313t-win_amd64.whl", hash = "sha256:78e9253c3de756b3f6a5174d024c4835acd59eb3f8e2ca13e775dbffe1558f69", size = 238214, upload-time = "2025-04-15T17:44:40.827Z" },
+    { url = "https://files.pythonhosted.org/packages/33/05/b26e3c6ecc05f349ee0013f0bb850a761016d89cec528a98193a48c34033/contourpy-1.3.2-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:fd93cc7f3139b6dd7aab2f26a90dde0aa9fc264dbf70f6740d498a70b860b82c", size = 265681, upload-time = "2025-04-15T17:44:59.314Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/25/ac07d6ad12affa7d1ffed11b77417d0a6308170f44ff20fa1d5aa6333f03/contourpy-1.3.2-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:107ba8a6a7eec58bb475329e6d3b95deba9440667c4d62b9b6063942b61d7f16", size = 315101, upload-time = "2025-04-15T17:45:04.165Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/4d/5bb3192bbe9d3f27e3061a6a8e7733c9120e203cb8515767d30973f71030/contourpy-1.3.2-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:ded1706ed0c1049224531b81128efbd5084598f18d8a2d9efae833edbd2b40ad", size = 220599, upload-time = "2025-04-15T17:45:08.456Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/c0/91f1215d0d9f9f343e4773ba6c9b89e8c0cc7a64a6263f21139da639d848/contourpy-1.3.2-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:5f5964cdad279256c084b69c3f412b7801e15356b16efa9d78aa974041903da0", size = 266807, upload-time = "2025-04-15T17:45:15.535Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/79/6be7e90c955c0487e7712660d6cead01fa17bff98e0ea275737cc2bc8e71/contourpy-1.3.2-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:49b65a95d642d4efa8f64ba12558fcb83407e58a2dfba9d796d77b63ccfcaff5", size = 318729, upload-time = "2025-04-15T17:45:20.166Z" },
+    { url = "https://files.pythonhosted.org/packages/87/68/7f46fb537958e87427d98a4074bcde4b67a70b04900cfc5ce29bc2f556c1/contourpy-1.3.2-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:8c5acb8dddb0752bf252e01a3035b21443158910ac16a3b0d20e7fed7d534ce5", size = 221791, upload-time = "2025-04-15T17:45:24.794Z" },
+]
+
+[[package]]
+name = "contourpy"
+version = "1.3.3"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+dependencies = [
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/58/01/1253e6698a07380cd31a736d248a3f2a50a7c88779a1813da27503cadc2a/contourpy-1.3.3.tar.gz", hash = "sha256:083e12155b210502d0bca491432bb04d56dc3432f95a979b429f2848c3dbe880", size = 13466174, upload-time = "2025-07-26T12:03:12.549Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/91/2e/c4390a31919d8a78b90e8ecf87cd4b4c4f05a5b48d05ec17db8e5404c6f4/contourpy-1.3.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:709a48ef9a690e1343202916450bc48b9e51c049b089c7f79a267b46cffcdaa1", size = 288773, upload-time = "2025-07-26T12:01:02.277Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/44/c4b0b6095fef4dc9c420e041799591e3b63e9619e3044f7f4f6c21c0ab24/contourpy-1.3.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:23416f38bfd74d5d28ab8429cc4d63fa67d5068bd711a85edb1c3fb0c3e2f381", size = 270149, upload-time = "2025-07-26T12:01:04.072Z" },
+    { url = "https://files.pythonhosted.org/packages/30/2e/dd4ced42fefac8470661d7cb7e264808425e6c5d56d175291e93890cce09/contourpy-1.3.3-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:929ddf8c4c7f348e4c0a5a3a714b5c8542ffaa8c22954862a46ca1813b667ee7", size = 329222, upload-time = "2025-07-26T12:01:05.688Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/74/cc6ec2548e3d276c71389ea4802a774b7aa3558223b7bade3f25787fafc2/contourpy-1.3.3-cp311-cp311-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9e999574eddae35f1312c2b4b717b7885d4edd6cb46700e04f7f02db454e67c1", size = 377234, upload-time = "2025-07-26T12:01:07.054Z" },
+    { url = "https://files.pythonhosted.org/packages/03/b3/64ef723029f917410f75c09da54254c5f9ea90ef89b143ccadb09df14c15/contourpy-1.3.3-cp311-cp311-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:0bf67e0e3f482cb69779dd3061b534eb35ac9b17f163d851e2a547d56dba0a3a", size = 380555, upload-time = "2025-07-26T12:01:08.801Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/4b/6157f24ca425b89fe2eb7e7be642375711ab671135be21e6faa100f7448c/contourpy-1.3.3-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:51e79c1f7470158e838808d4a996fa9bac72c498e93d8ebe5119bc1e6becb0db", size = 355238, upload-time = "2025-07-26T12:01:10.319Z" },
+    { url = "https://files.pythonhosted.org/packages/98/56/f914f0dd678480708a04cfd2206e7c382533249bc5001eb9f58aa693e200/contourpy-1.3.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:598c3aaece21c503615fd59c92a3598b428b2f01bfb4b8ca9c4edeecc2438620", size = 1326218, upload-time = "2025-07-26T12:01:12.659Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/d7/4a972334a0c971acd5172389671113ae82aa7527073980c38d5868ff1161/contourpy-1.3.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:322ab1c99b008dad206d406bb61d014cf0174df491ae9d9d0fac6a6fda4f977f", size = 1392867, upload-time = "2025-07-26T12:01:15.533Z" },
+    { url = "https://files.pythonhosted.org/packages/75/3e/f2cc6cd56dc8cff46b1a56232eabc6feea52720083ea71ab15523daab796/contourpy-1.3.3-cp311-cp311-win32.whl", hash = "sha256:fd907ae12cd483cd83e414b12941c632a969171bf90fc937d0c9f268a31cafff", size = 183677, upload-time = "2025-07-26T12:01:17.088Z" },
+    { url = "https://files.pythonhosted.org/packages/98/4b/9bd370b004b5c9d8045c6c33cf65bae018b27aca550a3f657cdc99acdbd8/contourpy-1.3.3-cp311-cp311-win_amd64.whl", hash = "sha256:3519428f6be58431c56581f1694ba8e50626f2dd550af225f82fb5f5814d2a42", size = 225234, upload-time = "2025-07-26T12:01:18.256Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/b6/71771e02c2e004450c12b1120a5f488cad2e4d5b590b1af8bad060360fe4/contourpy-1.3.3-cp311-cp311-win_arm64.whl", hash = "sha256:15ff10bfada4bf92ec8b31c62bf7c1834c244019b4a33095a68000d7075df470", size = 193123, upload-time = "2025-07-26T12:01:19.848Z" },
+    { url = "https://files.pythonhosted.org/packages/be/45/adfee365d9ea3d853550b2e735f9d66366701c65db7855cd07621732ccfc/contourpy-1.3.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b08a32ea2f8e42cf1d4be3169a98dd4be32bafe4f22b6c4cb4ba810fa9e5d2cb", size = 293419, upload-time = "2025-07-26T12:01:21.16Z" },
+    { url = "https://files.pythonhosted.org/packages/53/3e/405b59cfa13021a56bba395a6b3aca8cec012b45bf177b0eaf7a202cde2c/contourpy-1.3.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:556dba8fb6f5d8742f2923fe9457dbdd51e1049c4a43fd3986a0b14a1d815fc6", size = 273979, upload-time = "2025-07-26T12:01:22.448Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/1c/a12359b9b2ca3a845e8f7f9ac08bdf776114eb931392fcad91743e2ea17b/contourpy-1.3.3-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:92d9abc807cf7d0e047b95ca5d957cf4792fcd04e920ca70d48add15c1a90ea7", size = 332653, upload-time = "2025-07-26T12:01:24.155Z" },
+    { url = "https://files.pythonhosted.org/packages/63/12/897aeebfb475b7748ea67b61e045accdfcf0d971f8a588b67108ed7f5512/contourpy-1.3.3-cp312-cp312-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b2e8faa0ed68cb29af51edd8e24798bb661eac3bd9f65420c1887b6ca89987c8", size = 379536, upload-time = "2025-07-26T12:01:25.91Z" },
+    { url = "https://files.pythonhosted.org/packages/43/8a/a8c584b82deb248930ce069e71576fc09bd7174bbd35183b7943fb1064fd/contourpy-1.3.3-cp312-cp312-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:626d60935cf668e70a5ce6ff184fd713e9683fb458898e4249b63be9e28286ea", size = 384397, upload-time = "2025-07-26T12:01:27.152Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/8f/ec6289987824b29529d0dfda0d74a07cec60e54b9c92f3c9da4c0ac732de/contourpy-1.3.3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4d00e655fcef08aba35ec9610536bfe90267d7ab5ba944f7032549c55a146da1", size = 362601, upload-time = "2025-07-26T12:01:28.808Z" },
+    { url = "https://files.pythonhosted.org/packages/05/0a/a3fe3be3ee2dceb3e615ebb4df97ae6f3828aa915d3e10549ce016302bd1/contourpy-1.3.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:451e71b5a7d597379ef572de31eeb909a87246974d960049a9848c3bc6c41bf7", size = 1331288, upload-time = "2025-07-26T12:01:31.198Z" },
+    { url = "https://files.pythonhosted.org/packages/33/1d/acad9bd4e97f13f3e2b18a3977fe1b4a37ecf3d38d815333980c6c72e963/contourpy-1.3.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:459c1f020cd59fcfe6650180678a9993932d80d44ccde1fa1868977438f0b411", size = 1403386, upload-time = "2025-07-26T12:01:33.947Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/8f/5847f44a7fddf859704217a99a23a4f6417b10e5ab1256a179264561540e/contourpy-1.3.3-cp312-cp312-win32.whl", hash = "sha256:023b44101dfe49d7d53932be418477dba359649246075c996866106da069af69", size = 185018, upload-time = "2025-07-26T12:01:35.64Z" },
+    { url = "https://files.pythonhosted.org/packages/19/e8/6026ed58a64563186a9ee3f29f41261fd1828f527dd93d33b60feca63352/contourpy-1.3.3-cp312-cp312-win_amd64.whl", hash = "sha256:8153b8bfc11e1e4d75bcb0bff1db232f9e10b274e0929de9d608027e0d34ff8b", size = 226567, upload-time = "2025-07-26T12:01:36.804Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/e2/f05240d2c39a1ed228d8328a78b6f44cd695f7ef47beb3e684cf93604f86/contourpy-1.3.3-cp312-cp312-win_arm64.whl", hash = "sha256:07ce5ed73ecdc4a03ffe3e1b3e3c1166db35ae7584be76f65dbbe28a7791b0cc", size = 193655, upload-time = "2025-07-26T12:01:37.999Z" },
+    { url = "https://files.pythonhosted.org/packages/68/35/0167aad910bbdb9599272bd96d01a9ec6852f36b9455cf2ca67bd4cc2d23/contourpy-1.3.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:177fb367556747a686509d6fef71d221a4b198a3905fe824430e5ea0fda54eb5", size = 293257, upload-time = "2025-07-26T12:01:39.367Z" },
+    { url = "https://files.pythonhosted.org/packages/96/e4/7adcd9c8362745b2210728f209bfbcf7d91ba868a2c5f40d8b58f54c509b/contourpy-1.3.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:d002b6f00d73d69333dac9d0b8d5e84d9724ff9ef044fd63c5986e62b7c9e1b1", size = 274034, upload-time = "2025-07-26T12:01:40.645Z" },
+    { url = "https://files.pythonhosted.org/packages/73/23/90e31ceeed1de63058a02cb04b12f2de4b40e3bef5e082a7c18d9c8ae281/contourpy-1.3.3-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:348ac1f5d4f1d66d3322420f01d42e43122f43616e0f194fc1c9f5d830c5b286", size = 334672, upload-time = "2025-07-26T12:01:41.942Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/93/b43d8acbe67392e659e1d984700e79eb67e2acb2bd7f62012b583a7f1b55/contourpy-1.3.3-cp313-cp313-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:655456777ff65c2c548b7c454af9c6f33f16c8884f11083244b5819cc214f1b5", size = 381234, upload-time = "2025-07-26T12:01:43.499Z" },
+    { url = "https://files.pythonhosted.org/packages/46/3b/bec82a3ea06f66711520f75a40c8fc0b113b2a75edb36aa633eb11c4f50f/contourpy-1.3.3-cp313-cp313-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:644a6853d15b2512d67881586bd03f462c7ab755db95f16f14d7e238f2852c67", size = 385169, upload-time = "2025-07-26T12:01:45.219Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/32/e0f13a1c5b0f8572d0ec6ae2f6c677b7991fafd95da523159c19eff0696a/contourpy-1.3.3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4debd64f124ca62069f313a9cb86656ff087786016d76927ae2cf37846b006c9", size = 362859, upload-time = "2025-07-26T12:01:46.519Z" },
+    { url = "https://files.pythonhosted.org/packages/33/71/e2a7945b7de4e58af42d708a219f3b2f4cff7386e6b6ab0a0fa0033c49a9/contourpy-1.3.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a15459b0f4615b00bbd1e91f1b9e19b7e63aea7483d03d804186f278c0af2659", size = 1332062, upload-time = "2025-07-26T12:01:48.964Z" },
+    { url = "https://files.pythonhosted.org/packages/12/fc/4e87ac754220ccc0e807284f88e943d6d43b43843614f0a8afa469801db0/contourpy-1.3.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ca0fdcd73925568ca027e0b17ab07aad764be4706d0a925b89227e447d9737b7", size = 1403932, upload-time = "2025-07-26T12:01:51.979Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/2e/adc197a37443f934594112222ac1aa7dc9a98faf9c3842884df9a9d8751d/contourpy-1.3.3-cp313-cp313-win32.whl", hash = "sha256:b20c7c9a3bf701366556e1b1984ed2d0cedf999903c51311417cf5f591d8c78d", size = 185024, upload-time = "2025-07-26T12:01:53.245Z" },
+    { url = "https://files.pythonhosted.org/packages/18/0b/0098c214843213759692cc638fce7de5c289200a830e5035d1791d7a2338/contourpy-1.3.3-cp313-cp313-win_amd64.whl", hash = "sha256:1cadd8b8969f060ba45ed7c1b714fe69185812ab43bd6b86a9123fe8f99c3263", size = 226578, upload-time = "2025-07-26T12:01:54.422Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/9a/2f6024a0c5995243cd63afdeb3651c984f0d2bc727fd98066d40e141ad73/contourpy-1.3.3-cp313-cp313-win_arm64.whl", hash = "sha256:fd914713266421b7536de2bfa8181aa8c699432b6763a0ea64195ebe28bff6a9", size = 193524, upload-time = "2025-07-26T12:01:55.73Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/b3/f8a1a86bd3298513f500e5b1f5fd92b69896449f6cab6a146a5d52715479/contourpy-1.3.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:88df9880d507169449d434c293467418b9f6cbe82edd19284aa0409e7fdb933d", size = 306730, upload-time = "2025-07-26T12:01:57.051Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/11/4780db94ae62fc0c2053909b65dc3246bd7cecfc4f8a20d957ad43aa4ad8/contourpy-1.3.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:d06bb1f751ba5d417047db62bca3c8fde202b8c11fb50742ab3ab962c81e8216", size = 287897, upload-time = "2025-07-26T12:01:58.663Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/15/e59f5f3ffdd6f3d4daa3e47114c53daabcb18574a26c21f03dc9e4e42ff0/contourpy-1.3.3-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e4e6b05a45525357e382909a4c1600444e2a45b4795163d3b22669285591c1ae", size = 326751, upload-time = "2025-07-26T12:02:00.343Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/81/03b45cfad088e4770b1dcf72ea78d3802d04200009fb364d18a493857210/contourpy-1.3.3-cp313-cp313t-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:ab3074b48c4e2cf1a960e6bbeb7f04566bf36b1861d5c9d4d8ac04b82e38ba20", size = 375486, upload-time = "2025-07-26T12:02:02.128Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/ba/49923366492ffbdd4486e970d421b289a670ae8cf539c1ea9a09822b371a/contourpy-1.3.3-cp313-cp313t-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6c3d53c796f8647d6deb1abe867daeb66dcc8a97e8455efa729516b997b8ed99", size = 388106, upload-time = "2025-07-26T12:02:03.615Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/52/5b00ea89525f8f143651f9f03a0df371d3cbd2fccd21ca9b768c7a6500c2/contourpy-1.3.3-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:50ed930df7289ff2a8d7afeb9603f8289e5704755c7e5c3bbd929c90c817164b", size = 352548, upload-time = "2025-07-26T12:02:05.165Z" },
+    { url = "https://files.pythonhosted.org/packages/32/1d/a209ec1a3a3452d490f6b14dd92e72280c99ae3d1e73da74f8277d4ee08f/contourpy-1.3.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:4feffb6537d64b84877da813a5c30f1422ea5739566abf0bd18065ac040e120a", size = 1322297, upload-time = "2025-07-26T12:02:07.379Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/9e/46f0e8ebdd884ca0e8877e46a3f4e633f6c9c8c4f3f6e72be3fe075994aa/contourpy-1.3.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:2b7e9480ffe2b0cd2e787e4df64270e3a0440d9db8dc823312e2c940c167df7e", size = 1391023, upload-time = "2025-07-26T12:02:10.171Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/70/f308384a3ae9cd2209e0849f33c913f658d3326900d0ff5d378d6a1422d2/contourpy-1.3.3-cp313-cp313t-win32.whl", hash = "sha256:283edd842a01e3dcd435b1c5116798d661378d83d36d337b8dde1d16a5fc9ba3", size = 196157, upload-time = "2025-07-26T12:02:11.488Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/dd/880f890a6663b84d9e34a6f88cded89d78f0091e0045a284427cb6b18521/contourpy-1.3.3-cp313-cp313t-win_amd64.whl", hash = "sha256:87acf5963fc2b34825e5b6b048f40e3635dd547f590b04d2ab317c2619ef7ae8", size = 240570, upload-time = "2025-07-26T12:02:12.754Z" },
+    { url = "https://files.pythonhosted.org/packages/80/99/2adc7d8ffead633234817ef8e9a87115c8a11927a94478f6bb3d3f4d4f7d/contourpy-1.3.3-cp313-cp313t-win_arm64.whl", hash = "sha256:3c30273eb2a55024ff31ba7d052dde990d7d8e5450f4bbb6e913558b3d6c2301", size = 199713, upload-time = "2025-07-26T12:02:14.4Z" },
+    { url = "https://files.pythonhosted.org/packages/72/8b/4546f3ab60f78c514ffb7d01a0bd743f90de36f0019d1be84d0a708a580a/contourpy-1.3.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fde6c716d51c04b1c25d0b90364d0be954624a0ee9d60e23e850e8d48353d07a", size = 292189, upload-time = "2025-07-26T12:02:16.095Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/e1/3542a9cb596cadd76fcef413f19c79216e002623158befe6daa03dbfa88c/contourpy-1.3.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:cbedb772ed74ff5be440fa8eee9bd49f64f6e3fc09436d9c7d8f1c287b121d77", size = 273251, upload-time = "2025-07-26T12:02:17.524Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/71/f93e1e9471d189f79d0ce2497007731c1e6bf9ef6d1d61b911430c3db4e5/contourpy-1.3.3-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:22e9b1bd7a9b1d652cd77388465dc358dafcd2e217d35552424aa4f996f524f5", size = 335810, upload-time = "2025-07-26T12:02:18.9Z" },
+    { url = "https://files.pythonhosted.org/packages/91/f9/e35f4c1c93f9275d4e38681a80506b5510e9327350c51f8d4a5a724d178c/contourpy-1.3.3-cp314-cp314-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a22738912262aa3e254e4f3cb079a95a67132fc5a063890e224393596902f5a4", size = 382871, upload-time = "2025-07-26T12:02:20.418Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/71/47b512f936f66a0a900d81c396a7e60d73419868fba959c61efed7a8ab46/contourpy-1.3.3-cp314-cp314-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:afe5a512f31ee6bd7d0dda52ec9864c984ca3d66664444f2d72e0dc4eb832e36", size = 386264, upload-time = "2025-07-26T12:02:21.916Z" },
+    { url = "https://files.pythonhosted.org/packages/04/5f/9ff93450ba96b09c7c2b3f81c94de31c89f92292f1380261bd7195bea4ea/contourpy-1.3.3-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f64836de09927cba6f79dcd00fdd7d5329f3fccc633468507079c829ca4db4e3", size = 363819, upload-time = "2025-07-26T12:02:23.759Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/a6/0b185d4cc480ee494945cde102cb0149ae830b5fa17bf855b95f2e70ad13/contourpy-1.3.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:1fd43c3be4c8e5fd6e4f2baeae35ae18176cf2e5cced681cca908addf1cdd53b", size = 1333650, upload-time = "2025-07-26T12:02:26.181Z" },
+    { url = "https://files.pythonhosted.org/packages/43/d7/afdc95580ca56f30fbcd3060250f66cedbde69b4547028863abd8aa3b47e/contourpy-1.3.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:6afc576f7b33cf00996e5c1102dc2a8f7cc89e39c0b55df93a0b78c1bd992b36", size = 1404833, upload-time = "2025-07-26T12:02:28.782Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/e2/366af18a6d386f41132a48f033cbd2102e9b0cf6345d35ff0826cd984566/contourpy-1.3.3-cp314-cp314-win32.whl", hash = "sha256:66c8a43a4f7b8df8b71ee1840e4211a3c8d93b214b213f590e18a1beca458f7d", size = 189692, upload-time = "2025-07-26T12:02:30.128Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/c2/57f54b03d0f22d4044b8afb9ca0e184f8b1afd57b4f735c2fa70883dc601/contourpy-1.3.3-cp314-cp314-win_amd64.whl", hash = "sha256:cf9022ef053f2694e31d630feaacb21ea24224be1c3ad0520b13d844274614fd", size = 232424, upload-time = "2025-07-26T12:02:31.395Z" },
+    { url = "https://files.pythonhosted.org/packages/18/79/a9416650df9b525737ab521aa181ccc42d56016d2123ddcb7b58e926a42c/contourpy-1.3.3-cp314-cp314-win_arm64.whl", hash = "sha256:95b181891b4c71de4bb404c6621e7e2390745f887f2a026b2d99e92c17892339", size = 198300, upload-time = "2025-07-26T12:02:32.956Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/42/38c159a7d0f2b7b9c04c64ab317042bb6952b713ba875c1681529a2932fe/contourpy-1.3.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:33c82d0138c0a062380332c861387650c82e4cf1747aaa6938b9b6516762e772", size = 306769, upload-time = "2025-07-26T12:02:34.2Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/6c/26a8205f24bca10974e77460de68d3d7c63e282e23782f1239f226fcae6f/contourpy-1.3.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ea37e7b45949df430fe649e5de8351c423430046a2af20b1c1961cae3afcda77", size = 287892, upload-time = "2025-07-26T12:02:35.807Z" },
+    { url = "https://files.pythonhosted.org/packages/66/06/8a475c8ab718ebfd7925661747dbb3c3ee9c82ac834ccb3570be49d129f4/contourpy-1.3.3-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d304906ecc71672e9c89e87c4675dc5c2645e1f4269a5063b99b0bb29f232d13", size = 326748, upload-time = "2025-07-26T12:02:37.193Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/a3/c5ca9f010a44c223f098fccd8b158bb1cb287378a31ac141f04730dc49be/contourpy-1.3.3-cp314-cp314t-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:ca658cd1a680a5c9ea96dc61cdbae1e85c8f25849843aa799dfd3cb370ad4fbe", size = 375554, upload-time = "2025-07-26T12:02:38.894Z" },
+    { url = "https://files.pythonhosted.org/packages/80/5b/68bd33ae63fac658a4145088c1e894405e07584a316738710b636c6d0333/contourpy-1.3.3-cp314-cp314t-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ab2fd90904c503739a75b7c8c5c01160130ba67944a7b77bbf36ef8054576e7f", size = 388118, upload-time = "2025-07-26T12:02:40.642Z" },
+    { url = "https://files.pythonhosted.org/packages/40/52/4c285a6435940ae25d7410a6c36bda5145839bc3f0beb20c707cda18b9d2/contourpy-1.3.3-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b7301b89040075c30e5768810bc96a8e8d78085b47d8be6e4c3f5a0b4ed478a0", size = 352555, upload-time = "2025-07-26T12:02:42.25Z" },
+    { url = "https://files.pythonhosted.org/packages/24/ee/3e81e1dd174f5c7fefe50e85d0892de05ca4e26ef1c9a59c2a57e43b865a/contourpy-1.3.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:2a2a8b627d5cc6b7c41a4beff6c5ad5eb848c88255fda4a8745f7e901b32d8e4", size = 1322295, upload-time = "2025-07-26T12:02:44.668Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/b2/6d913d4d04e14379de429057cd169e5e00f6c2af3bb13e1710bcbdb5da12/contourpy-1.3.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:fd6ec6be509c787f1caf6b247f0b1ca598bef13f4ddeaa126b7658215529ba0f", size = 1391027, upload-time = "2025-07-26T12:02:47.09Z" },
+    { url = "https://files.pythonhosted.org/packages/93/8a/68a4ec5c55a2971213d29a9374913f7e9f18581945a7a31d1a39b5d2dfe5/contourpy-1.3.3-cp314-cp314t-win32.whl", hash = "sha256:e74a9a0f5e3fff48fb5a7f2fd2b9b70a3fe014a67522f79b7cca4c0c7e43c9ae", size = 202428, upload-time = "2025-07-26T12:02:48.691Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/96/fd9f641ffedc4fa3ace923af73b9d07e869496c9cc7a459103e6e978992f/contourpy-1.3.3-cp314-cp314t-win_amd64.whl", hash = "sha256:13b68d6a62db8eafaebb8039218921399baf6e47bf85006fd8529f2a08ef33fc", size = 250331, upload-time = "2025-07-26T12:02:50.137Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/8c/469afb6465b853afff216f9528ffda78a915ff880ed58813ba4faf4ba0b6/contourpy-1.3.3-cp314-cp314t-win_arm64.whl", hash = "sha256:b7448cb5a725bb1e35ce88771b86fba35ef418952474492cf7c764059933ff8b", size = 203831, upload-time = "2025-07-26T12:02:51.449Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/29/8dcfe16f0107943fa92388c23f6e05cff0ba58058c4c95b00280d4c75a14/contourpy-1.3.3-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:cd5dfcaeb10f7b7f9dc8941717c6c2ade08f587be2226222c12b25f0483ed497", size = 278809, upload-time = "2025-07-26T12:02:52.74Z" },
+    { url = "https://files.pythonhosted.org/packages/85/a9/8b37ef4f7dafeb335daee3c8254645ef5725be4d9c6aa70b50ec46ef2f7e/contourpy-1.3.3-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:0c1fc238306b35f246d61a1d416a627348b5cf0648648a031e14bb8705fcdfe8", size = 261593, upload-time = "2025-07-26T12:02:54.037Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/59/ebfb8c677c75605cc27f7122c90313fd2f375ff3c8d19a1694bda74aaa63/contourpy-1.3.3-pp311-pypy311_pp73-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:70f9aad7de812d6541d29d2bbf8feb22ff7e1c299523db288004e3157ff4674e", size = 302202, upload-time = "2025-07-26T12:02:55.947Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/37/21972a15834d90bfbfb009b9d004779bd5a07a0ec0234e5ba8f64d5736f4/contourpy-1.3.3-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5ed3657edf08512fc3fe81b510e35c2012fbd3081d2e26160f27ca28affec989", size = 329207, upload-time = "2025-07-26T12:02:57.468Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/58/bd257695f39d05594ca4ad60df5bcb7e32247f9951fd09a9b8edb82d1daa/contourpy-1.3.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:3d1a3799d62d45c18bafd41c5fa05120b96a28079f2393af559b843d1a966a77", size = 225315, upload-time = "2025-07-26T12:02:58.801Z" },
+]
+
+[[package]]
+name = "cuda-bindings"
+version = "13.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cuda-pathfinder" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a9/21/8464d133752951c154feafb3b65c297e7d80f301183d220bec4c830f1441/cuda_bindings-13.3.1-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:120fcc53d57903df529c3486962c56528cba5b7d6c57c99537320ed9922c8b86", size = 6073403, upload-time = "2026-05-29T23:11:36.22Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/1f/5ef51f5fbaa5d4d3201bb3d7555af028ec1aa4416275ccbf73c9e34e3d2d/cuda_bindings-13.3.1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9851b0caa8bfd3bc6fa054eaf57bea7c8e9c3a62db2d2621224677f49f3c53d0", size = 6675244, upload-time = "2026-05-29T23:11:38.664Z" },
+    { url = "https://files.pythonhosted.org/packages/51/6b/457ca12dad3ee9bfcc9a545cfd6b64b359ba49de40f776f6e028e678f262/cuda_bindings-13.3.1-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c5879712accf6e14bb01aa5e67440eb84998b8d104b509cc7a6dc0b8f656a474", size = 6053539, upload-time = "2026-05-29T23:11:43.19Z" },
+    { url = "https://files.pythonhosted.org/packages/95/7a/c5e3c34a409b148f5c0f5a4ea374158f95d488862c1dffedf9aa5c639df9/cuda_bindings-13.3.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:04436a9364059c84b8f9636f359eccda1cf814341f5b670c71d80d2f79dbc708", size = 6674166, upload-time = "2026-05-29T23:11:45.478Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/67/5e7dba1ba576dd73da5dee894ca076ca5e959450dfff66d6d510a255d1f7/cuda_bindings-13.3.1-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7855c4868aabc0cfae28abbe83d56734bdfbd08f08fc234ac1912a12858bf49", size = 6025351, upload-time = "2026-05-29T23:11:49.685Z" },
+    { url = "https://files.pythonhosted.org/packages/39/2a/6d2e9047d1fb243dbaa364b01e0297534b9ed7fd27dba1c9f361519cf69b/cuda_bindings-13.3.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e32d08f71ebcdf00f0f41eab2eb37e8da94c8ed411cc9f7f7a019ce6b34abe3a", size = 6657965, upload-time = "2026-05-29T23:11:52.227Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/6e/2394f8163360f8391f8f1b7e72d300a82724edb81a7b7084c799fbd4c91f/cuda_bindings-13.3.1-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9efb21c1ee64981e184b9e0ba5eb3179e5ba3d4b51665a6cb52b8ef3d01a7cbf", size = 5920504, upload-time = "2026-05-29T23:11:56.883Z" },
+    { url = "https://files.pythonhosted.org/packages/34/c2/ef9b6a63f7dc432712a462c816662e662e00d38caa9b861c8c2588195d03/cuda_bindings-13.3.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2732904099e0a4d4db774a5fc6d91ee95fae065b4d2ecabb4968c5fe2406c9d7", size = 6476660, upload-time = "2026-05-29T23:11:59.188Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/81/bff68ce829999c1e4209c761bbf903b1c06ec570416ddb25020864ad5907/cuda_bindings-13.3.1-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ab2f74ed65bfef4163ba07a8db16f1085e0729291db12a2423aff84ee8278b8", size = 6013639, upload-time = "2026-05-29T23:12:03.509Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/e0/c8a1f0c8f9ffdea4f5fe6dbab89b326cef4d85caf489dad39e209da89416/cuda_bindings-13.3.1-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:efd4c814d311ec08c981f6dded1dbe7d4b371067ee4f6c14cccec4bde9590f80", size = 6534419, upload-time = "2026-05-29T23:12:05.633Z" },
+    { url = "https://files.pythonhosted.org/packages/52/b8/83b1f563925b290f2d11a01a77a84013ba56052fe3653a5bef3ccfbb43d6/cuda_bindings-13.3.1-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c3c772dfff49681541d59630c90f858e173ac926b9c593a2b7123f2a1043cc76", size = 5809771, upload-time = "2026-05-29T23:12:10.422Z" },
+    { url = "https://files.pythonhosted.org/packages/12/20/e79b4bfe98f075195afb6343d41c498f9dbd2d161d7021d4d28bceb83581/cuda_bindings-13.3.1-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:36febb7c1079d68a981dbbd8d5a67235b399802b82075c9388624719607e52b9", size = 6358584, upload-time = "2026-05-29T23:12:12.767Z" },
+]
+
+[[package]]
+name = "cuda-pathfinder"
+version = "1.5.5"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/11/c8/26f2e4aae92f11522a96043892ba39a90eac610d5242523aa863212bc1c7/cuda_pathfinder-1.5.5-py3-none-any.whl", hash = "sha256:0228c023f95d1480f143ef5c8922d27a2ab052087a942e81dc289c9eb8f91689", size = 51671, upload-time = "2026-05-27T01:21:25.413Z" },
+]
+
+[[package]]
+name = "cuda-toolkit"
+version = "13.0.2"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/57/b2/453099f5f3b698d7d0eab38916aac44c7f76229f451709e2eb9db6615dcd/cuda_toolkit-13.0.2-py2.py3-none-any.whl", hash = "sha256:b198824cf2f54003f50d64ada3a0f184b42ca0846c1c94192fa269ecd97a66eb", size = 2364, upload-time = "2025-12-19T23:24:07.328Z" },
+]
+
+[package.optional-dependencies]
+cudart = [
+    { name = "nvidia-cuda-runtime", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+cufft = [
+    { name = "nvidia-cufft", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+cufile = [
+    { name = "nvidia-cufile", marker = "sys_platform == 'linux'" },
+]
+cupti = [
+    { name = "nvidia-cuda-cupti", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+curand = [
+    { name = "nvidia-curand", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+cusolver = [
+    { name = "nvidia-cusolver", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+cusparse = [
+    { name = "nvidia-cusparse", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+nvjitlink = [
+    { name = "nvidia-nvjitlink", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+nvrtc = [
+    { name = "nvidia-cuda-nvrtc", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+nvtx = [
+    { name = "nvidia-nvtx", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
+]
+
+[[package]]
+name = "cycler"
+version = "0.12.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a9/95/a3dbbb5028f35eafb79008e7522a75244477d2838f38cbb722248dabc2a8/cycler-0.12.1.tar.gz", hash = "sha256:88bb128f02ba341da8ef447245a9e138fae777f6a23943da4540077d3601eb1c", size = 7615, upload-time = "2023-10-07T05:32:18.335Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/05/c19819d5e3d95294a6f5947fb9b9629efb316b96de511b418c53d245aae6/cycler-0.12.1-py3-none-any.whl", hash = "sha256:85cef7cff222d8644161529808465972e51340599459b8ac3ccbac5a854e0d30", size = 8321, upload-time = "2023-10-07T05:32:16.783Z" },
+]
+
+[[package]]
+name = "dbus-fast"
+version = "5.0.16"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c2/26/a75b4f79c56bd1f24e4cf85399b28a1a607d1052b9e66aceb961d79a6d3f/dbus_fast-5.0.16.tar.gz", hash = "sha256:24d0a86f32acb209a41806d20cf8a9207e4d46760e23c32479d1951d43739080", size = 82570, upload-time = "2026-05-27T19:19:33.316Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2f/9f/e876913135540b426f4b7e2b5b8b718a42da51f115e2a70323f13e2d6db9/dbus_fast-5.0.16-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dc1b3de7c70cb25cb4799fd098aae23caca89e957f199a02997c2c280f20a1a8", size = 839874, upload-time = "2026-05-27T19:27:25.396Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/ee/e1c8e106d1e83d7db653d360d58527c567c58dd7faac43ac255915293522/dbus_fast-5.0.16-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d0601912b5f7015870f3987216c7d0cec49278adb8a282fc879e171a73b7f8f4", size = 884279, upload-time = "2026-05-27T19:27:26.673Z" },
+    { url = "https://files.pythonhosted.org/packages/59/26/b699fccea33ae56abb087795127e65b846feab093abd1e673f6233945b03/dbus_fast-5.0.16-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d57b49994666998dfdacaac726f6c788855ebd1942e3d40b91bf72b9bd64c079", size = 885549, upload-time = "2026-05-27T19:27:28.285Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/89/8203aa0666327b01855cadd17da0d5f8f41b8fa28ca658f868d807404c5a/dbus_fast-5.0.16-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:b92b773075adc85f24a628875e8b57f4d1f1fbe63ec18db1bb9f136f26a6f621", size = 846911, upload-time = "2026-05-27T19:27:29.478Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/ba/b3f02870dab313b423442ac8859de138386b12539de30583758b1787b81f/dbus_fast-5.0.16-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:7fb55b9658f9a285bd52b6209e54a89613da7f1134d505aa089299ed99268c1a", size = 883229, upload-time = "2026-05-27T19:27:31.104Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/54/fab358e1bee38621cf2289eb59d001c7f2d2aeff61319852346518fa9304/dbus_fast-5.0.16-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:c775272eccf2aa3948c72509c590f84a9a9bebb3bc7ee68452ad029209670c63", size = 891357, upload-time = "2026-05-27T19:27:32.736Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/a6/3903f047ee563a793a9adf9c6bb46a00164fcdd83224fce221cb4a69b90f/dbus_fast-5.0.16-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ddac5066da9e1e38d434e41372392ac62ab8ce80e4e9616a0504999749b9ec46", size = 838181, upload-time = "2026-05-27T19:27:35.791Z" },
+    { url = "https://files.pythonhosted.org/packages/00/42/e5c277b88eb0102c71f2387eb3feb7413f2f5f8ed3ef2b7c16e54bfe618a/dbus_fast-5.0.16-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6d41f51d2a420f7274d4f48b7a4f3e56b70ee8ca87ad666854007de102025ee3", size = 883024, upload-time = "2026-05-27T19:27:37.237Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/6a/73ee89383f66be965fa20c1b4e6d558a9f6059ff4c0809455b8fca8a2d47/dbus_fast-5.0.16-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:651347df9079744395c6404e0ed03a3704485d21833765db7ad71390c7c807a6", size = 885925, upload-time = "2026-05-27T19:27:38.77Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/69/9c7d4231dab8d1b40a7bd59226d0ae57cd7e07a4b9869a76ddc3ba6b54e0/dbus_fast-5.0.16-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1f5017cb3c32b07622f9c01a1285526183988ae1dd4e5fedc7390650a3cfbca2", size = 845630, upload-time = "2026-05-27T19:27:40.71Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/ea/d3945d8fa00fe5bf96aa4bff6b93b91afa4493ccb377ee5d9f9bb7adfa29/dbus_fast-5.0.16-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:bff101277226e71aa744d72b968efcdde4e185dc0d3571b8168edb99a2f72d3a", size = 881730, upload-time = "2026-05-27T19:27:42.357Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/d6/864c0fec52f3de381371f342966070252a8323ccf6b829f3c58e6d0b65e4/dbus_fast-5.0.16-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3367dfeba013db0f97004b4c93f4a21c39728f2bbe0fbef74dbbeb6e078e47fa", size = 890381, upload-time = "2026-05-27T19:27:44.089Z" },
+    { url = "https://files.pythonhosted.org/packages/25/49/9c6013b1f19ff0f2c1ba4e8996f81bf225d85ffea541200a89de4a0c44bc/dbus_fast-5.0.16-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:85a7771883fd5beaa5e92b27772722db5e3d4dc2f7e04a1812d3bf01b7de440d", size = 799934, upload-time = "2026-05-27T19:27:47.528Z" },
+    { url = "https://files.pythonhosted.org/packages/02/c2/4c6e23a17b14461b6d0d24dff7d6d9f6c1b7c01ddd1ea80757f69f9541ff/dbus_fast-5.0.16-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c42dc349ea1e52e4bd17462d5029c7650d76e8ccd2fbd136b6a0384abae61004", size = 852402, upload-time = "2026-05-27T19:27:49.058Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/62/597c9742618b7f5273d1bd0e330f9e2fa13d9c59d4e3a591f4cf3e1c985f/dbus_fast-5.0.16-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:941b926581ef458dfde70711badbb5ab1bfba523b527f1b73004c21cdf9976ec", size = 833815, upload-time = "2026-05-27T19:27:50.767Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/a2/5c2d7953906eae84dad02ea920dae9c4fe0339e84870b6e6ad9b9a6070cf/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:42a7901d5f053490d3d59c5a9b9a13b1d8322836458efcb93040ea360aced572", size = 807750, upload-time = "2026-05-27T19:27:52.236Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/2f/7aec4afdfeae504a9381d0fcc8105e1b440f81d25480ac5f6704c124d561/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:8deec1d4dd41336672b30b596d60ed78898e923f3b06f9ef60affc1a5dec656c", size = 830883, upload-time = "2026-05-27T19:27:53.604Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/f8/1070ab5973dda406f735f6f73a4bc50debf7c43301f5e113fd3657bfca58/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a8b2c92f82af04d59c50cbccf65f995fa2e321ce7850e3c1b613e94680a8044e", size = 860033, upload-time = "2026-05-27T19:27:55.167Z" },
+    { url = "https://files.pythonhosted.org/packages/36/65/1cadc9c53e779a224ae13210b222bf41bc8c4d0843cf529fd927e308334d/dbus_fast-5.0.16-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:831a6f6a865260395fa59f80d36c73b1e270b268603f53422552a813bf61c529", size = 798537, upload-time = "2026-05-27T19:27:58.33Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/ff/8a9c99ba28ab266038a3ea3cf2989623deb5cbd8e8aceb69a4385b7fccd5/dbus_fast-5.0.16-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4eee863c411c0c1c783518f30c3de50339316fc745ac2abcc0778046e4adac40", size = 850377, upload-time = "2026-05-27T19:28:00.007Z" },
+    { url = "https://files.pythonhosted.org/packages/77/9a/b79c59d12199f7aebbf71d9ce8d2e087f623d66c9981c0836b52ce31c69b/dbus_fast-5.0.16-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:790c1310d38369e659b45ae5b95b6bce24ae51e011634142324cb6ebc8e11398", size = 828635, upload-time = "2026-05-27T19:28:01.675Z" },
+    { url = "https://files.pythonhosted.org/packages/94/b0/8492fbb855defeff0229e88cc601f256ea0dfffaa2169e361d2064686e47/dbus_fast-5.0.16-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f0707f8473cd8e5be0ac1aceed7532e2fcb4b5b97584f2878f98cbe61049a184", size = 806411, upload-time = "2026-05-27T19:28:03.227Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/e8/b6ef9463e41e745b785856e7537503aefaab2a06b18545c407ed11a2974b/dbus_fast-5.0.16-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:df3f3ee7cf61be297be9d3ce2074f74da44b13cdb413cc821e398902d2f38036", size = 828424, upload-time = "2026-05-27T19:28:04.683Z" },
+    { url = "https://files.pythonhosted.org/packages/44/fa/e7d5e24b42d9193acf6219ee04e818b8495a0b4a0f122a58f536b2460708/dbus_fast-5.0.16-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0b800db6ffaec39554f1489b54482e33a8b6247325974cf82659504a3816b956", size = 858114, upload-time = "2026-05-27T19:28:06.021Z" },
+    { url = "https://files.pythonhosted.org/packages/88/6e/827fe09289b73f03fbaaa07493e7944dd16266429bf081ba1c62094af03e/dbus_fast-5.0.16-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:874bbd1fff34054c10b1062676334fcf170f32a0f0f9f21d2a9d1bf22ef70b35", size = 810903, upload-time = "2026-05-27T19:28:09.025Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/1d/8a9caaf953c2212538b9f210edd2507ecd2dc90414ac688b030917f6d1ec/dbus_fast-5.0.16-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:07554554373441f562d1469bd73d024dd3144c9725375bbffbe8b3375bf464fe", size = 855741, upload-time = "2026-05-27T19:28:10.49Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/3d/509e45e1739e96b08461c281eb257f564fd7533f9cabd067f0c4694b725d/dbus_fast-5.0.16-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e6fc1831c702725eb4875d69c877700d95e7c3fa8542f4edaad318c6ba3e66f2", size = 833659, upload-time = "2026-05-27T19:28:12.062Z" },
+    { url = "https://files.pythonhosted.org/packages/30/8d/3237d8a6826a302095b258f183ddf236d345b4070af6e6bb65da3f5dfe25/dbus_fast-5.0.16-cp314-cp314-manylinux_2_41_x86_64.whl", hash = "sha256:8447d1ab3cd7dc9976805dda5903453d0fdb8aaab870536f3bcaf6b1f58800a3", size = 853989, upload-time = "2026-05-27T19:19:30.644Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/2b/f9cc24ebb6f4175bc5760b46d13ad108cd634dfb41c474245bd1fd846091/dbus_fast-5.0.16-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d36ff2f0f6a5fd6dae96a09f48783ee7de51bf12d0da18a13edf19766bd0b99a", size = 818691, upload-time = "2026-05-27T19:28:14.271Z" },
+    { url = "https://files.pythonhosted.org/packages/95/58/a20c6e76b6bc037d5b565531f501d427dcd70fe5a903dcc7984dfe3ef287/dbus_fast-5.0.16-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:fc43f5a7e7db86728e9925757a53a717eb3fec27de54e7bbc688cd65b8e9028c", size = 833842, upload-time = "2026-05-27T19:28:15.719Z" },
+    { url = "https://files.pythonhosted.org/packages/30/0c/2cb74502755be1957b81faf1cf2e57b9b12764afaf7ac30b99c5ebe6e615/dbus_fast-5.0.16-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:56e64ff9d1a1f503e07a940f861bf6dc80f24602425cb6f384d69bdc7fe7071f", size = 862625, upload-time = "2026-05-27T19:28:17.309Z" },
+    { url = "https://files.pythonhosted.org/packages/71/53/d0a0df847025e57a5aa58b0d711d74859a778ca3c28454d10f3b1a554bc3/dbus_fast-5.0.16-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2d8943d0b92ec9f49e37aed6224515ce161eb2b5df5e9fd3e1d692f35efbe48b", size = 1534575, upload-time = "2026-05-27T19:28:20.471Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/82/1423c68091804af7711e940128cacd5494d8d3be645609ae0b23d9104562/dbus_fast-5.0.16-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e2f96e7da851b0dc9e0bc1e00d8b9cd6f227469b6e48e1b2ad474e44ff91841b", size = 1613383, upload-time = "2026-05-27T19:28:22.106Z" },
+    { url = "https://files.pythonhosted.org/packages/20/88/465a6e79cd77e8dc1451fdcfd8080ff72f6693f0a8b25b127df81283f241/dbus_fast-5.0.16-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:2832c5eefcc5b4e0623a27e20751ca34006d7fe73b21d58ef859aa2cef0a8ec8", size = 821797, upload-time = "2026-05-27T19:28:23.698Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/1f/11d8d709736644685dbaa191d65dd313869fec688ff75eaed542f0625895/dbus_fast-5.0.16-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:d2c9ae45a01d5f2e27a9508159d6e3c34e6714b485884000839daf5320d76da9", size = 1549870, upload-time = "2026-05-27T19:28:25.438Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/db/1b01c80c81202ff81e96d1ce92a45296a818bd81c705ea5f032536d591b1/dbus_fast-5.0.16-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:e46276642f787a345f127389ff36a90ba9e4df6537b852d8afdc12e2b2f9bb91", size = 822814, upload-time = "2026-05-27T19:28:27.484Z" },
+    { url = "https://files.pythonhosted.org/packages/88/7c/25ce2a94711a7479d2786de321c7c5fbbf99ab8c67eba1bf5dd5bd80c830/dbus_fast-5.0.16-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f41ca52046e41775c0784148c7b6b636539722bcc1412bae3139ac7295883265", size = 1629346, upload-time = "2026-05-27T19:28:29.121Z" },
+]
+
+[[package]]
+name = "distro"
+version = "1.9.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fc/f8/98eea607f65de6527f8a2e8885fc8015d3e6f5775df186e443e0964a11c3/distro-1.9.0.tar.gz", hash = "sha256:2fa77c6fd8940f116ee1d6b94a2f90b13b5ea8d019b98bc8bafdcabcdd9bdbed", size = 60722, upload-time = "2023-12-24T09:54:32.31Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/b3/231ffd4ab1fc9d679809f356cebee130ac7daa00d6d6f3206dd4fd137e9e/distro-1.9.0-py3-none-any.whl", hash = "sha256:7bffd925d65168f85027d8da9af6bddab658135b840670a223589bc0c8ef02b2", size = 20277, upload-time = "2023-12-24T09:54:30.421Z" },
+]
+
+[[package]]
+name = "docstring-parser"
+version = "0.18.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/4d/f332313098c1de1b2d2ff91cf2674415cc7cddab2ca1b01ae29774bd5fdf/docstring_parser-0.18.0.tar.gz", hash = "sha256:292510982205c12b1248696f44959db3cdd1740237a968ea1e2e7a900eeb2015", size = 29341, upload-time = "2026-04-14T04:09:19.867Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a7/5f/ed01f9a3cdffbd5a008556fc7b2a08ddb1cc6ace7effa7340604b1d16699/docstring_parser-0.18.0-py3-none-any.whl", hash = "sha256:b3fcbed555c47d8479be0796ef7e19c2670d428d72e96da63f3a40122860374b", size = 22484, upload-time = "2026-04-14T04:09:18.638Z" },
+]
+
+[[package]]
+name = "event-model"
+version = "1.23.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "importlib-resources" },
+    { name = "jsonschema" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f9/5a/de03f05fdbc4377db89fa6daf243e89370f9bcf2d21ad96b54d4549a74ed/event_model-1.23.1.tar.gz", hash = "sha256:5bb70fd8c7f345aa32afe561aff5a306b2c8a19cbdc3066b736643c8092ddaab", size = 185271, upload-time = "2025-08-28T13:26:38.647Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/32/e31e3363bf48ad2ba80b644b01ad9676ce154f1b755950de81eb4ed5b6bd/event_model-1.23.1-py3-none-any.whl", hash = "sha256:e0b951b829cebcf3879beff238bb370fd997d315856bc5d5ac2a66202b854958", size = 77057, upload-time = "2025-08-28T13:26:37.228Z" },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
+[[package]]
+name = "fastapi"
+version = "0.136.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-doc" },
+    { name = "pydantic" },
+    { name = "starlette" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/81/2d/ff8d91d7b564d464629a0fd50a4489c97fcb836ac230bf3a7269232a9b1f/fastapi-0.136.3.tar.gz", hash = "sha256:e487fae93ad408e6f47641ee4dfe389864fd7bec92e547ea8498fc13f43e83ab", size = 396410, upload-time = "2026-05-23T18:53:15.192Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/82/45359b62a067409bd929ae8a56b8ed13e5a8c8a61194b3c236920999ab83/fastapi-0.136.3-py3-none-any.whl", hash = "sha256:3d2a69bdf04b7e9f3afa292c3bc7a98816bbfafa10bc9b45f3f3700d2f761620", size = 117481, upload-time = "2026-05-23T18:53:16.924Z" },
+]
+
+[[package]]
+name = "filelock"
+version = "3.29.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b5/fe/997687a931ab51049acce6fa1f23e8f01216374ea81374ddee763c493db5/filelock-3.29.0.tar.gz", hash = "sha256:69974355e960702e789734cb4871f884ea6fe50bd8404051a3530bc07809cf90", size = 57571, upload-time = "2026-04-19T15:39:10.068Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/47/dd9a212ef6e343a6857485ffe25bba537304f1913bdbed446a23f7f592e1/filelock-3.29.0-py3-none-any.whl", hash = "sha256:96f5f6344709aa1572bbf631c640e4ebeeb519e08da902c39a001882f30ac258", size = 39812, upload-time = "2026-04-19T15:39:08.752Z" },
+]
+
+[[package]]
+name = "flexcache"
+version = "0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/b0/8a21e330561c65653d010ef112bf38f60890051d244ede197ddaa08e50c1/flexcache-0.3.tar.gz", hash = "sha256:18743bd5a0621bfe2cf8d519e4c3bfdf57a269c15d1ced3fb4b64e0ff4600656", size = 15816, upload-time = "2024-03-09T03:21:07.555Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/cd/c883e1a7c447479d6e13985565080e3fea88ab5a107c21684c813dba1875/flexcache-0.3-py3-none-any.whl", hash = "sha256:d43c9fea82336af6e0115e308d9d33a185390b8346a017564611f1466dcd2e32", size = 13263, upload-time = "2024-03-09T03:21:05.635Z" },
+]
+
+[[package]]
+name = "flexparser"
+version = "0.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/82/99/b4de7e39e8eaf8207ba1a8fa2241dd98b2ba72ae6e16960d8351736d8702/flexparser-0.4.tar.gz", hash = "sha256:266d98905595be2ccc5da964fe0a2c3526fbbffdc45b65b3146d75db992ef6b2", size = 31799, upload-time = "2024-11-07T02:00:56.249Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fe/5e/3be305568fe5f34448807976dc82fc151d76c3e0e03958f34770286278c1/flexparser-0.4-py3-none-any.whl", hash = "sha256:3738b456192dcb3e15620f324c447721023c0293f6af9955b481e91d00179846", size = 27625, upload-time = "2024-11-07T02:00:54.523Z" },
+]
+
+[[package]]
+name = "fonttools"
+version = "4.63.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/84/69/c97f2c18e0db87d2c7b15da1974dace76ae938f1cfa22e2727a648b7ed43/fonttools-4.63.0.tar.gz", hash = "sha256:caeb583deeb5168e694b65cda8b4ee62abedfa66cf88488734466f2366b9c4e0", size = 3597189, upload-time = "2026-05-14T12:04:30.958Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f2/c9/4141c90a90db20f807c7e10bfd689fe53eb8f7f4caff58ee4d4dfe46919f/fonttools-4.63.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e3297a6a4059b4acc3a1e9a8b04741f240a80044eef08ebd32e8b5bcdddce75b", size = 2884632, upload-time = "2026-05-14T12:02:38.56Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/46/ad12b5c10eae602d7ef814b02afa08aacbf89da917fed5b071282b7eadc2/fonttools-4.63.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b1cd75a03ad8cb5bc40c90bfde68c0c47de423aa19e5c0f362b43520645eea94", size = 2429441, upload-time = "2026-05-14T12:02:41.162Z" },
+    { url = "https://files.pythonhosted.org/packages/90/8f/bdca24a84c81d56fffed052229cdcff368f6e05882e526f4558891481f65/fonttools-4.63.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0425b277a59cff3d80ca42162a8de360f318438a2ac83570842a678d826d579", size = 4946346, upload-time = "2026-05-14T12:02:43.41Z" },
+    { url = "https://files.pythonhosted.org/packages/04/59/a639c0e136441ee91a65b56fdf89e5d075927e7a09c559d1b0f5276577db/fonttools-4.63.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d7e5c9973aa04c95650c96e5f5ad865fbf42d62079163ecfab1e01cbc2504c22", size = 4903184, upload-time = "2026-05-14T12:02:45.742Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/53/91b7e0cb45b536f3da1b29ba8cbab89f27e8b986809e0b1982303a3f4eca/fonttools-4.63.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:cb014d58140a38135f16064c74c652ed57aa0b75cbf8bb59cac821f7edb5334e", size = 4922967, upload-time = "2026-05-14T12:02:48.386Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/b7/87439bf44e6b97c5538cd29d0b7e366a5b8ce2cc132a4134fb67fa3f2fa2/fonttools-4.63.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:032038247a96c1690f9f31e377c389383c902531b085aa4e4dabd6f57f870e69", size = 5042799, upload-time = "2026-05-14T12:02:50.424Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/7c/8b96c3263b89ef99cded544c0f0636686f85dbd3c211c4dceef0231fca23/fonttools-4.63.0-cp310-cp310-win32.whl", hash = "sha256:a8b33a82979e0a6a34ff435cc81317be1f95ec1ebb7a3a2d1c8a6a54f02ae44e", size = 1519704, upload-time = "2026-05-14T12:02:52.523Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/4d/2c2f0069970b6907de8fb5b05c5c0193cc22f717df151d1c7aef1c738f58/fonttools-4.63.0-cp310-cp310-win_amd64.whl", hash = "sha256:0c18358a155d75034911c5ee397a5b44cd19dd325dbb8b35fb60bf421d6a72ac", size = 1568666, upload-time = "2026-05-14T12:02:54.917Z" },
+    { url = "https://files.pythonhosted.org/packages/75/2b/a7f1545bdf5da69c4bda0cea2a5781f0ad2a6623e0277267672db43c5fe6/fonttools-4.63.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:2b8ae05d9eacf6081414d759c0a352769ac28ce31280d6bb8e77b03f9e3c449f", size = 2881793, upload-time = "2026-05-14T12:02:56.645Z" },
+    { url = "https://files.pythonhosted.org/packages/49/50/965308c703f085f225db2886813b27e015b8b3438c350b22dd65b52c2a2c/fonttools-4.63.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:79cdc9f567aec74a72918fd060283911406750cbc9fd28c1316023deb6ce31a9", size = 2428130, upload-time = "2026-05-14T12:02:58.891Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/38/6937fbd7f2dc3a6b48725851bc2c15ec949b9af14d9bbcb5fe83cdf9bdf9/fonttools-4.63.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2c14b4fd138c4bafcca294765c547914e1aa431ae1ca94ab99d8db08c958bd3b", size = 5111952, upload-time = "2026-05-14T12:03:01.263Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/43/a81f20050a3115b57d62c8e781446949512eac36690dc384ccea65ff4cc1/fonttools-4.63.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d76ac49f929aecaf82d83250b8347e099d7aecba0f4726c1d9b6df3b8bb5fe18", size = 5082308, upload-time = "2026-05-14T12:03:03.211Z" },
+    { url = "https://files.pythonhosted.org/packages/67/00/cdd9d4944ca6ae280d01e69cc37bde3bf663630b837a6fc6d2cd65d80e0e/fonttools-4.63.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:dcf076a4474fe0d7367e5bbf5b052c7284fa1feca729c04176ce513521afd8a0", size = 5087932, upload-time = "2026-05-14T12:03:05.147Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/f1/0aa0dbea778c75adbef223c42019fd47d22262b905974d62d829545d485f/fonttools-4.63.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7dd683fef0663e9f0f45cf541d788d24caa3ec9db50796b588e1757d8b3bc007", size = 5213271, upload-time = "2026-05-14T12:03:07.238Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/99/253e4056e1f0e67b9390125a154b73b5eb73ad521bece95c004858fdeec2/fonttools-4.63.0-cp311-cp311-win32.whl", hash = "sha256:afefc1ed0a59785a7fb06ea7e1678e849c193e1e387db783579bc7b3056fcfcb", size = 2304473, upload-time = "2026-05-14T12:03:09.271Z" },
+    { url = "https://files.pythonhosted.org/packages/08/60/defa5e69641db890a63be281f41345f4c33b157824eaf0b9fad3e08b0dcb/fonttools-4.63.0-cp311-cp311-win_amd64.whl", hash = "sha256:063e08bd17bd5a90127a14123de0d6a952dbc847695fd98b63c043d58057f90c", size = 2356389, upload-time = "2026-05-14T12:03:11.53Z" },
+    { url = "https://files.pythonhosted.org/packages/08/ef/b3c6b9b5be2f82416d73fe2ed2e96e2793cd80e7510bd6a17ca79cdd88ec/fonttools-4.63.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:37dd23e621e3b0aef1baa70a303b80aaf38449632cfc8fd2a55fb285bbccfc02", size = 2881131, upload-time = "2026-05-14T12:03:13.386Z" },
+    { url = "https://files.pythonhosted.org/packages/44/a0/c815bea63117fa63e4e1c01f8a1110d2112fa003f838e6467094ec2432ce/fonttools-4.63.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a9faff9e0c1f76f9fd55899d2ce785832efebab37eb8ae13995853aef178bef0", size = 2426704, upload-time = "2026-05-14T12:03:15.801Z" },
+    { url = "https://files.pythonhosted.org/packages/44/04/0b91d8e916e92ad1fac9e4624760baf0fd5ff2ead614c2f68fb21373f03f/fonttools-4.63.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef3048ef05dbb552b89817713d9cac912e00d0fde4a3105c00d29e52e10c89af", size = 5044298, upload-time = "2026-05-14T12:03:18.085Z" },
+    { url = "https://files.pythonhosted.org/packages/77/c7/2342da9830e3e9d4870305ca5d2091d2a83284f2953079b7bdd3b5e029d8/fonttools-4.63.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:58dc6bb86a78d782f00f9190ca02c119cf5bbe2807536e361e18d42019f877d8", size = 4999800, upload-time = "2026-05-14T12:03:20.161Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/6d/67fe16c48d7ce050979b33f47e0d28a318f02da030602e944c34f7a16ef3/fonttools-4.63.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ee08ebfa58f6e1aeff5697ab9582105bb620008c1caafb681e4c557e7483027b", size = 4982666, upload-time = "2026-05-14T12:03:22.87Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/00/3bbab338c07c71fa56269953845e92c951a61457bbbb0f1022551ea266d9/fonttools-4.63.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:27fdc65af8da6f88b9c6121c47a464cbe359fcfff7ff6fc2d37a1f395d755b78", size = 5133598, upload-time = "2026-05-14T12:03:25.168Z" },
+    { url = "https://files.pythonhosted.org/packages/62/f2/aa27c7f98db5b064883dadcc5283947e81e034de42e22a33675878d98b54/fonttools-4.63.0-cp312-cp312-win32.whl", hash = "sha256:af2fd1664d00a397d75f806985ddb36282091c2131a73a6485c23b4a34722263", size = 2292575, upload-time = "2026-05-14T12:03:27.496Z" },
+    { url = "https://files.pythonhosted.org/packages/87/36/cccb9bc2a6ab63d1b2980374f0dca72ce95ae267c9b4cfe77455bb70d0d4/fonttools-4.63.0-cp312-cp312-win_amd64.whl", hash = "sha256:59ac449f8cca9b4ffa08d2e7bbadad87ce710d69d1eda5c3c1ce579baa987272", size = 2343211, upload-time = "2026-05-14T12:03:30.057Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/8d/d8fec3dcde2963f8c908fb315e5ff2cd0ac34f82394bbbf73a2aa5145ce3/fonttools-4.63.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:cd7e9857e5e63738b9d9fd707bc1f59c8b09e5177726d23664db393c59bb08bd", size = 2876062, upload-time = "2026-05-14T12:03:32.554Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/71/d935dc54e4ff121bfdd11e08702db63a7e6f25af21d8a3d7b7212df53641/fonttools-4.63.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c2a2a42198b696a6f48fad91709afb55176e66a5e566131219dba372fb7f8c59", size = 2424594, upload-time = "2026-05-14T12:03:34.86Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/40/e76320afa1df918e146155ef239b1719ee266092e96f5423bfd075affba1/fonttools-4.63.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1e874792a8212b44583ea02189d9e693906b2f78b261f372f95d6c563210ac1d", size = 5024840, upload-time = "2026-05-14T12:03:36.745Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/36/0b805d8c485f872f65a509cbe3b58a5d0d17bee855333b54a150c79d3061/fonttools-4.63.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:22135da48a348785c5e2d5d2d9d6bec5ed44adacbaeb9db12d9493bf6c6bfa68", size = 4975801, upload-time = "2026-05-14T12:03:38.833Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/26/2cee03d0aa083ab022da5c07aff9ed3f689da1defb81ad6917c9627896da/fonttools-4.63.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ccf41f2efdf56994d22d73bef4ced1052161958169428d06ba9724ea9e9a64be", size = 4965009, upload-time = "2026-05-14T12:03:41.494Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/48/cc4b66d9058c0d0982c833fad10127c4b0e9324606aafa41382295ca4102/fonttools-4.63.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9ced0bd02ac751dd6319b0da88aaef24414e3b0dbc32bb4f24944821a3741a27", size = 5105892, upload-time = "2026-05-14T12:03:43.525Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/1f/a98a30a814b9ddef3a2e706025f90b9e0bc94890e6cb15254bc86547d11a/fonttools-4.63.0-cp313-cp313-win32.whl", hash = "sha256:85be818f5506e8a7753153def2c9550178f0ecae6a47b5e0e8dbb23f7cc90380", size = 2291313, upload-time = "2026-05-14T12:03:45.594Z" },
+    { url = "https://files.pythonhosted.org/packages/92/46/5177b01f3b4abfdd4409f31cca4ab279c9343a26efbe9ec78c97fc612e02/fonttools-4.63.0-cp313-cp313-win_amd64.whl", hash = "sha256:ba04cb5891d4c0c21b6da95eda8d7b090021508a294fff33464fc7d241e0856b", size = 2342299, upload-time = "2026-05-14T12:03:47.414Z" },
+    { url = "https://files.pythonhosted.org/packages/27/d2/23d25e3f247b328be58d04a4c9f894178a0d1eda7d42867cfb388adaf416/fonttools-4.63.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fd1e3094f42d806d3d7c79162fc59e5910fcbe3a7360c385b8da969bc4493745", size = 2875338, upload-time = "2026-05-14T12:03:50.052Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/58/7dfa0c761cb3b2964e2a84c4dc986c926a87de0cb9fb60d5b28ded3f2914/fonttools-4.63.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:6e528da43bc3791085f8cb6141b1d13e459226790240340fcbb4625649238b03", size = 2422661, upload-time = "2026-05-14T12:03:52.154Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/87/64cfa18a7a1621d17b7f4502b2b0ed8a135a90c3db51ea590ee99043e76b/fonttools-4.63.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b2248c5decb223562f7902ff6325077a073f608ee8e33e88ad88db734eb9f49", size = 5010526, upload-time = "2026-05-14T12:03:54.647Z" },
+    { url = "https://files.pythonhosted.org/packages/36/e1/a8933a72c45a87177fbde2696e0d0755c8c9062f8c077a961c6215fa27b1/fonttools-4.63.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:308f957cdeaf8abe4e5f2f124902ef405448af92c90f80e302a3b771c2e6116b", size = 4923946, upload-time = "2026-05-14T12:03:56.984Z" },
+    { url = "https://files.pythonhosted.org/packages/27/60/872e6e233b8c5e8b41413796ff18b7fe479661bd40147e071b450dfad7a1/fonttools-4.63.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:bf00f21eb5fb721dbaf73d1e9da6d02a1af7768f2ebcf9798be98beab8ba90f6", size = 4962489, upload-time = "2026-05-14T12:03:59.443Z" },
+    { url = "https://files.pythonhosted.org/packages/30/c4/83c24f2ec38b90cfda84bf4b1a1f49df80e84a1db4e7ac6e0d41bf23bc39/fonttools-4.63.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c1aaa4b9c75798400ac043ce04d74e7830376c85095a5a6ed7cba2f17a266bf4", size = 5071870, upload-time = "2026-05-14T12:04:02.122Z" },
+    { url = "https://files.pythonhosted.org/packages/de/40/3ae22b60ff1d41ce0bd044b31238cdc72cef99f28b976f1e128ebd618c9b/fonttools-4.63.0-cp314-cp314-win32.whl", hash = "sha256:22693918177bd9ceabec4736d338045f357769416fc6b0b2508eefef75b08616", size = 2295026, upload-time = "2026-05-14T12:04:04.47Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/d4/98078064ccc76b45cb0f6c002452011e93c4bd26f6850344f0951cc1fe89/fonttools-4.63.0-cp314-cp314-win_amd64.whl", hash = "sha256:7d782fac32985914c351556f68ac0855391572bcd87de50e05970d3cd4c96fc5", size = 2347454, upload-time = "2026-05-14T12:04:06.752Z" },
+    { url = "https://files.pythonhosted.org/packages/49/4e/652d1580c5f4e39f7d103b0c793e4773129ad633dce4addd0cf4dfebde02/fonttools-4.63.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:6db5140a60a5d731d21ec076745b40a310607731b0a565b50776393188649001", size = 2958152, upload-time = "2026-05-14T12:04:08.706Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/55/ad864c9a9b219f552eb46b32cd7906c466e5a578ba0c3abfcc0fe7413eb6/fonttools-4.63.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:7d76edbff9014094dbf03bd2d074709dfa6ec7aba13d838c937a2b33d2d6a86e", size = 2460809, upload-time = "2026-05-14T12:04:10.783Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/2b/0aa8db70f18cf52e49b4ed5ecec68547f981160bf5ded3b5aed6faa0a6f9/fonttools-4.63.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0eac00b9118c3c2f87d272e45341871c5b3066baa3c86897fa634a7c3fb59096", size = 5148649, upload-time = "2026-05-14T12:04:12.747Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/63/18e4369c25043096f1048e0c9915951adc4f842bd81c6b18155824d6fa99/fonttools-4.63.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:51394295f1a51de8b5f30bdb1e1b9a4231536c7064ef5c6e211eec19fa36036f", size = 4932147, upload-time = "2026-05-14T12:04:14.806Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/3f/67f3eac2ffd8a98446c5022f8ed3864eac878a5ff7af8df4c8286dba16cc/fonttools-4.63.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9e12f105d2b6342c559c298afb674006bb2893afc7102dcf8a1b55b0486b4e40", size = 5027237, upload-time = "2026-05-14T12:04:17.675Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/ba/4e6214cb38a7b04779e97bb7636de9a5c7f20af7018d03dee0b64c08510a/fonttools-4.63.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:796f27556dbe094c4824f75ca85267e4df776c79036c8441469a4df37038c196", size = 5053933, upload-time = "2026-05-14T12:04:20.818Z" },
+    { url = "https://files.pythonhosted.org/packages/34/3b/214dcc19ee31d3d38fb5ad2755c11ef0514e5dc300bbaf41c0b69f393799/fonttools-4.63.0-cp314-cp314t-win32.whl", hash = "sha256:948428a275741f0b64b113c955425a953314f4b9ab9997f73a72c83e68e569c8", size = 2359326, upload-time = "2026-05-14T12:04:24.22Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/1e/3ff1a9b523058c2eeb6a9d50f5574e2a738200d0d94107d5bc4105e8da3f/fonttools-4.63.0-cp314-cp314t-win_amd64.whl", hash = "sha256:6d4741eb179121cab9eea4cb2393d24492373a260d7945006358c08cfbf45419", size = 2425829, upload-time = "2026-05-14T12:04:26.829Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/47/c99d5268f354002ce80f8d029cd9d7d872969da1de8b93d32de4dc56d6f4/fonttools-4.63.0-py3-none-any.whl", hash = "sha256:445af2eab030a16b9171ea8bdda7ebf7d96bda2df88ee182a464252f6e05e20d", size = 1164562, upload-time = "2026-05-14T12:04:29.092Z" },
+]
+
+[[package]]
+name = "frozenlist"
+version = "1.8.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2d/f5/c831fac6cc817d26fd54c7eaccd04ef7e0288806943f7cc5bbf69f3ac1f0/frozenlist-1.8.0.tar.gz", hash = "sha256:3ede829ed8d842f6cd48fc7081d7a41001a56f1f38603f9d49bf3020d59a31ad", size = 45875, upload-time = "2025-10-06T05:38:17.865Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/83/4a/557715d5047da48d54e659203b9335be7bfaafda2c3f627b7c47e0b3aaf3/frozenlist-1.8.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:b37f6d31b3dcea7deb5e9696e529a6aa4a898adc33db82da12e4c60a7c4d2011", size = 86230, upload-time = "2025-10-06T05:35:23.699Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/fb/c85f9fed3ea8fe8740e5b46a59cc141c23b842eca617da8876cfce5f760e/frozenlist-1.8.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:ef2b7b394f208233e471abc541cc6991f907ffd47dc72584acee3147899d6565", size = 49621, upload-time = "2025-10-06T05:35:25.341Z" },
+    { url = "https://files.pythonhosted.org/packages/63/70/26ca3f06aace16f2352796b08704338d74b6d1a24ca38f2771afbb7ed915/frozenlist-1.8.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a88f062f072d1589b7b46e951698950e7da00442fc1cacbe17e19e025dc327ad", size = 49889, upload-time = "2025-10-06T05:35:26.797Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/ed/c7895fd2fde7f3ee70d248175f9b6cdf792fb741ab92dc59cd9ef3bd241b/frozenlist-1.8.0-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:f57fb59d9f385710aa7060e89410aeb5058b99e62f4d16b08b91986b9a2140c2", size = 219464, upload-time = "2025-10-06T05:35:28.254Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/83/4d587dccbfca74cb8b810472392ad62bfa100bf8108c7223eb4c4fa2f7b3/frozenlist-1.8.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:799345ab092bee59f01a915620b5d014698547afd011e691a208637312db9186", size = 221649, upload-time = "2025-10-06T05:35:29.454Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/c6/fd3b9cd046ec5fff9dab66831083bc2077006a874a2d3d9247dea93ddf7e/frozenlist-1.8.0-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c23c3ff005322a6e16f71bf8692fcf4d5a304aaafe1e262c98c6d4adc7be863e", size = 219188, upload-time = "2025-10-06T05:35:30.951Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/80/6693f55eb2e085fc8afb28cf611448fb5b90e98e068fa1d1b8d8e66e5c7d/frozenlist-1.8.0-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8a76ea0f0b9dfa06f254ee06053d93a600865b3274358ca48a352ce4f0798450", size = 231748, upload-time = "2025-10-06T05:35:32.101Z" },
+    { url = "https://files.pythonhosted.org/packages/97/d6/e9459f7c5183854abd989ba384fe0cc1a0fb795a83c033f0571ec5933ca4/frozenlist-1.8.0-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:c7366fe1418a6133d5aa824ee53d406550110984de7637d65a178010f759c6ef", size = 236351, upload-time = "2025-10-06T05:35:33.834Z" },
+    { url = "https://files.pythonhosted.org/packages/97/92/24e97474b65c0262e9ecd076e826bfd1d3074adcc165a256e42e7b8a7249/frozenlist-1.8.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:13d23a45c4cebade99340c4165bd90eeb4a56c6d8a9d8aa49568cac19a6d0dc4", size = 218767, upload-time = "2025-10-06T05:35:35.205Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/bf/dc394a097508f15abff383c5108cb8ad880d1f64a725ed3b90d5c2fbf0bb/frozenlist-1.8.0-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:e4a3408834f65da56c83528fb52ce7911484f0d1eaf7b761fc66001db1646eff", size = 235887, upload-time = "2025-10-06T05:35:36.354Z" },
+    { url = "https://files.pythonhosted.org/packages/40/90/25b201b9c015dbc999a5baf475a257010471a1fa8c200c843fd4abbee725/frozenlist-1.8.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:42145cd2748ca39f32801dad54aeea10039da6f86e303659db90db1c4b614c8c", size = 228785, upload-time = "2025-10-06T05:35:37.949Z" },
+    { url = "https://files.pythonhosted.org/packages/84/f4/b5bc148df03082f05d2dd30c089e269acdbe251ac9a9cf4e727b2dbb8a3d/frozenlist-1.8.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:e2de870d16a7a53901e41b64ffdf26f2fbb8917b3e6ebf398098d72c5b20bd7f", size = 230312, upload-time = "2025-10-06T05:35:39.178Z" },
+    { url = "https://files.pythonhosted.org/packages/db/4b/87e95b5d15097c302430e647136b7d7ab2398a702390cf4c8601975709e7/frozenlist-1.8.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:20e63c9493d33ee48536600d1a5c95eefc870cd71e7ab037763d1fbb89cc51e7", size = 217650, upload-time = "2025-10-06T05:35:40.377Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/70/78a0315d1fea97120591a83e0acd644da638c872f142fd72a6cebee825f3/frozenlist-1.8.0-cp310-cp310-win32.whl", hash = "sha256:adbeebaebae3526afc3c96fad434367cafbfd1b25d72369a9e5858453b1bb71a", size = 39659, upload-time = "2025-10-06T05:35:41.863Z" },
+    { url = "https://files.pythonhosted.org/packages/66/aa/3f04523fb189a00e147e60c5b2205126118f216b0aa908035c45336e27e4/frozenlist-1.8.0-cp310-cp310-win_amd64.whl", hash = "sha256:667c3777ca571e5dbeb76f331562ff98b957431df140b54c85fd4d52eea8d8f6", size = 43837, upload-time = "2025-10-06T05:35:43.205Z" },
+    { url = "https://files.pythonhosted.org/packages/39/75/1135feecdd7c336938bd55b4dc3b0dfc46d85b9be12ef2628574b28de776/frozenlist-1.8.0-cp310-cp310-win_arm64.whl", hash = "sha256:80f85f0a7cc86e7a54c46d99c9e1318ff01f4687c172ede30fd52d19d1da1c8e", size = 39989, upload-time = "2025-10-06T05:35:44.596Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/03/077f869d540370db12165c0aa51640a873fb661d8b315d1d4d67b284d7ac/frozenlist-1.8.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:09474e9831bc2b2199fad6da3c14c7b0fbdd377cce9d3d77131be28906cb7d84", size = 86912, upload-time = "2025-10-06T05:35:45.98Z" },
+    { url = "https://files.pythonhosted.org/packages/df/b5/7610b6bd13e4ae77b96ba85abea1c8cb249683217ef09ac9e0ae93f25a91/frozenlist-1.8.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:17c883ab0ab67200b5f964d2b9ed6b00971917d5d8a92df149dc2c9779208ee9", size = 50046, upload-time = "2025-10-06T05:35:47.009Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/ef/0e8f1fe32f8a53dd26bdd1f9347efe0778b0fddf62789ea683f4cc7d787d/frozenlist-1.8.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:fa47e444b8ba08fffd1c18e8cdb9a75db1b6a27f17507522834ad13ed5922b93", size = 50119, upload-time = "2025-10-06T05:35:48.38Z" },
+    { url = "https://files.pythonhosted.org/packages/11/b1/71a477adc7c36e5fb628245dfbdea2166feae310757dea848d02bd0689fd/frozenlist-1.8.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:2552f44204b744fba866e573be4c1f9048d6a324dfe14475103fd51613eb1d1f", size = 231067, upload-time = "2025-10-06T05:35:49.97Z" },
+    { url = "https://files.pythonhosted.org/packages/45/7e/afe40eca3a2dc19b9904c0f5d7edfe82b5304cb831391edec0ac04af94c2/frozenlist-1.8.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:957e7c38f250991e48a9a73e6423db1bb9dd14e722a10f6b8bb8e16a0f55f695", size = 233160, upload-time = "2025-10-06T05:35:51.729Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/aa/7416eac95603ce428679d273255ffc7c998d4132cfae200103f164b108aa/frozenlist-1.8.0-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:8585e3bb2cdea02fc88ffa245069c36555557ad3609e83be0ec71f54fd4abb52", size = 228544, upload-time = "2025-10-06T05:35:53.246Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/3d/2a2d1f683d55ac7e3875e4263d28410063e738384d3adc294f5ff3d7105e/frozenlist-1.8.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:edee74874ce20a373d62dc28b0b18b93f645633c2943fd90ee9d898550770581", size = 243797, upload-time = "2025-10-06T05:35:54.497Z" },
+    { url = "https://files.pythonhosted.org/packages/78/1e/2d5565b589e580c296d3bb54da08d206e797d941a83a6fdea42af23be79c/frozenlist-1.8.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:c9a63152fe95756b85f31186bddf42e4c02c6321207fd6601a1c89ebac4fe567", size = 247923, upload-time = "2025-10-06T05:35:55.861Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/c3/65872fcf1d326a7f101ad4d86285c403c87be7d832b7470b77f6d2ed5ddc/frozenlist-1.8.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:b6db2185db9be0a04fecf2f241c70b63b1a242e2805be291855078f2b404dd6b", size = 230886, upload-time = "2025-10-06T05:35:57.399Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/76/ac9ced601d62f6956f03cc794f9e04c81719509f85255abf96e2510f4265/frozenlist-1.8.0-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:f4be2e3d8bc8aabd566f8d5b8ba7ecc09249d74ba3c9ed52e54dc23a293f0b92", size = 245731, upload-time = "2025-10-06T05:35:58.563Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/49/ecccb5f2598daf0b4a1415497eba4c33c1e8ce07495eb07d2860c731b8d5/frozenlist-1.8.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:c8d1634419f39ea6f5c427ea2f90ca85126b54b50837f31497f3bf38266e853d", size = 241544, upload-time = "2025-10-06T05:35:59.719Z" },
+    { url = "https://files.pythonhosted.org/packages/53/4b/ddf24113323c0bbcc54cb38c8b8916f1da7165e07b8e24a717b4a12cbf10/frozenlist-1.8.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:1a7fa382a4a223773ed64242dbe1c9c326ec09457e6b8428efb4118c685c3dfd", size = 241806, upload-time = "2025-10-06T05:36:00.959Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/fb/9b9a084d73c67175484ba2789a59f8eebebd0827d186a8102005ce41e1ba/frozenlist-1.8.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:11847b53d722050808926e785df837353bd4d75f1d494377e59b23594d834967", size = 229382, upload-time = "2025-10-06T05:36:02.22Z" },
+    { url = "https://files.pythonhosted.org/packages/95/a3/c8fb25aac55bf5e12dae5c5aa6a98f85d436c1dc658f21c3ac73f9fa95e5/frozenlist-1.8.0-cp311-cp311-win32.whl", hash = "sha256:27c6e8077956cf73eadd514be8fb04d77fc946a7fe9f7fe167648b0b9085cc25", size = 39647, upload-time = "2025-10-06T05:36:03.409Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/f5/603d0d6a02cfd4c8f2a095a54672b3cf967ad688a60fb9faf04fc4887f65/frozenlist-1.8.0-cp311-cp311-win_amd64.whl", hash = "sha256:ac913f8403b36a2c8610bbfd25b8013488533e71e62b4b4adce9c86c8cea905b", size = 44064, upload-time = "2025-10-06T05:36:04.368Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/16/c2c9ab44e181f043a86f9a8f84d5124b62dbcb3a02c0977ec72b9ac1d3e0/frozenlist-1.8.0-cp311-cp311-win_arm64.whl", hash = "sha256:d4d3214a0f8394edfa3e303136d0575eece0745ff2b47bd2cb2e66dd92d4351a", size = 39937, upload-time = "2025-10-06T05:36:05.669Z" },
+    { url = "https://files.pythonhosted.org/packages/69/29/948b9aa87e75820a38650af445d2ef2b6b8a6fab1a23b6bb9e4ef0be2d59/frozenlist-1.8.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:78f7b9e5d6f2fdb88cdde9440dc147259b62b9d3b019924def9f6478be254ac1", size = 87782, upload-time = "2025-10-06T05:36:06.649Z" },
+    { url = "https://files.pythonhosted.org/packages/64/80/4f6e318ee2a7c0750ed724fa33a4bdf1eacdc5a39a7a24e818a773cd91af/frozenlist-1.8.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:229bf37d2e4acdaf808fd3f06e854a4a7a3661e871b10dc1f8f1896a3b05f18b", size = 50594, upload-time = "2025-10-06T05:36:07.69Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/94/5c8a2b50a496b11dd519f4a24cb5496cf125681dd99e94c604ccdea9419a/frozenlist-1.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f833670942247a14eafbb675458b4e61c82e002a148f49e68257b79296e865c4", size = 50448, upload-time = "2025-10-06T05:36:08.78Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/bd/d91c5e39f490a49df14320f4e8c80161cfcce09f1e2cde1edd16a551abb3/frozenlist-1.8.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:494a5952b1c597ba44e0e78113a7266e656b9794eec897b19ead706bd7074383", size = 242411, upload-time = "2025-10-06T05:36:09.801Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/83/f61505a05109ef3293dfb1ff594d13d64a2324ac3482be2cedc2be818256/frozenlist-1.8.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96f423a119f4777a4a056b66ce11527366a8bb92f54e541ade21f2374433f6d4", size = 243014, upload-time = "2025-10-06T05:36:11.394Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/cb/cb6c7b0f7d4023ddda30cf56b8b17494eb3a79e3fda666bf735f63118b35/frozenlist-1.8.0-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3462dd9475af2025c31cc61be6652dfa25cbfb56cbbf52f4ccfe029f38decaf8", size = 234909, upload-time = "2025-10-06T05:36:12.598Z" },
+    { url = "https://files.pythonhosted.org/packages/31/c5/cd7a1f3b8b34af009fb17d4123c5a778b44ae2804e3ad6b86204255f9ec5/frozenlist-1.8.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c4c800524c9cd9bac5166cd6f55285957fcfc907db323e193f2afcd4d9abd69b", size = 250049, upload-time = "2025-10-06T05:36:14.065Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/01/2f95d3b416c584a1e7f0e1d6d31998c4a795f7544069ee2e0962a4b60740/frozenlist-1.8.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d6a5df73acd3399d893dafc71663ad22534b5aa4f94e8a2fabfe856c3c1b6a52", size = 256485, upload-time = "2025-10-06T05:36:15.39Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/03/024bf7720b3abaebcff6d0793d73c154237b85bdf67b7ed55e5e9596dc9a/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:405e8fe955c2280ce66428b3ca55e12b3c4e9c336fb2103a4937e891c69a4a29", size = 237619, upload-time = "2025-10-06T05:36:16.558Z" },
+    { url = "https://files.pythonhosted.org/packages/69/fa/f8abdfe7d76b731f5d8bd217827cf6764d4f1d9763407e42717b4bed50a0/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:908bd3f6439f2fef9e85031b59fd4f1297af54415fb60e4254a95f75b3cab3f3", size = 250320, upload-time = "2025-10-06T05:36:17.821Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/3c/b051329f718b463b22613e269ad72138cc256c540f78a6de89452803a47d/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:294e487f9ec720bd8ffcebc99d575f7eff3568a08a253d1ee1a0378754b74143", size = 246820, upload-time = "2025-10-06T05:36:19.046Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/ae/58282e8f98e444b3f4dd42448ff36fa38bef29e40d40f330b22e7108f565/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:74c51543498289c0c43656701be6b077f4b265868fa7f8a8859c197006efb608", size = 250518, upload-time = "2025-10-06T05:36:20.763Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/96/007e5944694d66123183845a106547a15944fbbb7154788cbf7272789536/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:776f352e8329135506a1d6bf16ac3f87bc25b28e765949282dcc627af36123aa", size = 239096, upload-time = "2025-10-06T05:36:22.129Z" },
+    { url = "https://files.pythonhosted.org/packages/66/bb/852b9d6db2fa40be96f29c0d1205c306288f0684df8fd26ca1951d461a56/frozenlist-1.8.0-cp312-cp312-win32.whl", hash = "sha256:433403ae80709741ce34038da08511d4a77062aa924baf411ef73d1146e74faf", size = 39985, upload-time = "2025-10-06T05:36:23.661Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/af/38e51a553dd66eb064cdf193841f16f077585d4d28394c2fa6235cb41765/frozenlist-1.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:34187385b08f866104f0c0617404c8eb08165ab1272e884abc89c112e9c00746", size = 44591, upload-time = "2025-10-06T05:36:24.958Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/06/1dc65480ab147339fecc70797e9c2f69d9cea9cf38934ce08df070fdb9cb/frozenlist-1.8.0-cp312-cp312-win_arm64.whl", hash = "sha256:fe3c58d2f5db5fbd18c2987cba06d51b0529f52bc3a6cdc33d3f4eab725104bd", size = 40102, upload-time = "2025-10-06T05:36:26.333Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/40/0832c31a37d60f60ed79e9dfb5a92e1e2af4f40a16a29abcc7992af9edff/frozenlist-1.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:8d92f1a84bb12d9e56f818b3a746f3efba93c1b63c8387a73dde655e1e42282a", size = 85717, upload-time = "2025-10-06T05:36:27.341Z" },
+    { url = "https://files.pythonhosted.org/packages/30/ba/b0b3de23f40bc55a7057bd38434e25c34fa48e17f20ee273bbde5e0650f3/frozenlist-1.8.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:96153e77a591c8adc2ee805756c61f59fef4cf4073a9275ee86fe8cba41241f7", size = 49651, upload-time = "2025-10-06T05:36:28.855Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/ab/6e5080ee374f875296c4243c381bbdef97a9ac39c6e3ce1d5f7d42cb78d6/frozenlist-1.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:f21f00a91358803399890ab167098c131ec2ddd5f8f5fd5fe9c9f2c6fcd91e40", size = 49417, upload-time = "2025-10-06T05:36:29.877Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/4e/e4691508f9477ce67da2015d8c00acd751e6287739123113a9fca6f1604e/frozenlist-1.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fb30f9626572a76dfe4293c7194a09fb1fe93ba94c7d4f720dfae3b646b45027", size = 234391, upload-time = "2025-10-06T05:36:31.301Z" },
+    { url = "https://files.pythonhosted.org/packages/40/76/c202df58e3acdf12969a7895fd6f3bc016c642e6726aa63bd3025e0fc71c/frozenlist-1.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaa352d7047a31d87dafcacbabe89df0aa506abb5b1b85a2fb91bc3faa02d822", size = 233048, upload-time = "2025-10-06T05:36:32.531Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/c0/8746afb90f17b73ca5979c7a3958116e105ff796e718575175319b5bb4ce/frozenlist-1.8.0-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:03ae967b4e297f58f8c774c7eabcce57fe3c2434817d4385c50661845a058121", size = 226549, upload-time = "2025-10-06T05:36:33.706Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/eb/4c7eefc718ff72f9b6c4893291abaae5fbc0c82226a32dcd8ef4f7a5dbef/frozenlist-1.8.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6292f1de555ffcc675941d65fffffb0a5bcd992905015f85d0592201793e0e5", size = 239833, upload-time = "2025-10-06T05:36:34.947Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/4e/e5c02187cf704224f8b21bee886f3d713ca379535f16893233b9d672ea71/frozenlist-1.8.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:29548f9b5b5e3460ce7378144c3010363d8035cea44bc0bf02d57f5a685e084e", size = 245363, upload-time = "2025-10-06T05:36:36.534Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/96/cb85ec608464472e82ad37a17f844889c36100eed57bea094518bf270692/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ec3cc8c5d4084591b4237c0a272cc4f50a5b03396a47d9caaf76f5d7b38a4f11", size = 229314, upload-time = "2025-10-06T05:36:38.582Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/6f/4ae69c550e4cee66b57887daeebe006fe985917c01d0fff9caab9883f6d0/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:517279f58009d0b1f2e7c1b130b377a349405da3f7621ed6bfae50b10adf20c1", size = 243365, upload-time = "2025-10-06T05:36:40.152Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/58/afd56de246cf11780a40a2c28dc7cbabbf06337cc8ddb1c780a2d97e88d8/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:db1e72ede2d0d7ccb213f218df6a078a9c09a7de257c2fe8fcef16d5925230b1", size = 237763, upload-time = "2025-10-06T05:36:41.355Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/36/cdfaf6ed42e2644740d4a10452d8e97fa1c062e2a8006e4b09f1b5fd7d63/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:b4dec9482a65c54a5044486847b8a66bf10c9cb4926d42927ec4e8fd5db7fed8", size = 240110, upload-time = "2025-10-06T05:36:42.716Z" },
+    { url = "https://files.pythonhosted.org/packages/03/a8/9ea226fbefad669f11b52e864c55f0bd57d3c8d7eb07e9f2e9a0b39502e1/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:21900c48ae04d13d416f0e1e0c4d81f7931f73a9dfa0b7a8746fb2fe7dd970ed", size = 233717, upload-time = "2025-10-06T05:36:44.251Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/0b/1b5531611e83ba7d13ccc9988967ea1b51186af64c42b7a7af465dcc9568/frozenlist-1.8.0-cp313-cp313-win32.whl", hash = "sha256:8b7b94a067d1c504ee0b16def57ad5738701e4ba10cec90529f13fa03c833496", size = 39628, upload-time = "2025-10-06T05:36:45.423Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/cf/174c91dbc9cc49bc7b7aab74d8b734e974d1faa8f191c74af9b7e80848e6/frozenlist-1.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:878be833caa6a3821caf85eb39c5ba92d28e85df26d57afb06b35b2efd937231", size = 43882, upload-time = "2025-10-06T05:36:46.796Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/17/502cd212cbfa96eb1388614fe39a3fc9ab87dbbe042b66f97acb57474834/frozenlist-1.8.0-cp313-cp313-win_arm64.whl", hash = "sha256:44389d135b3ff43ba8cc89ff7f51f5a0bb6b63d829c8300f79a2fe4fe61bcc62", size = 39676, upload-time = "2025-10-06T05:36:47.8Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/5c/3bbfaa920dfab09e76946a5d2833a7cbdf7b9b4a91c714666ac4855b88b4/frozenlist-1.8.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:e25ac20a2ef37e91c1b39938b591457666a0fa835c7783c3a8f33ea42870db94", size = 89235, upload-time = "2025-10-06T05:36:48.78Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/d6/f03961ef72166cec1687e84e8925838442b615bd0b8854b54923ce5b7b8a/frozenlist-1.8.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:07cdca25a91a4386d2e76ad992916a85038a9b97561bf7a3fd12d5d9ce31870c", size = 50742, upload-time = "2025-10-06T05:36:49.837Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/bb/a6d12b7ba4c3337667d0e421f7181c82dda448ce4e7ad7ecd249a16fa806/frozenlist-1.8.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4e0c11f2cc6717e0a741f84a527c52616140741cd812a50422f83dc31749fb52", size = 51725, upload-time = "2025-10-06T05:36:50.851Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/71/d1fed0ffe2c2ccd70b43714c6cab0f4188f09f8a67a7914a6b46ee30f274/frozenlist-1.8.0-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b3210649ee28062ea6099cfda39e147fa1bc039583c8ee4481cb7811e2448c51", size = 284533, upload-time = "2025-10-06T05:36:51.898Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/1f/fb1685a7b009d89f9bf78a42d94461bc06581f6e718c39344754a5d9bada/frozenlist-1.8.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:581ef5194c48035a7de2aefc72ac6539823bb71508189e5de01d60c9dcd5fa65", size = 292506, upload-time = "2025-10-06T05:36:53.101Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/3b/b991fe1612703f7e0d05c0cf734c1b77aaf7c7d321df4572e8d36e7048c8/frozenlist-1.8.0-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3ef2d026f16a2b1866e1d86fc4e1291e1ed8a387b2c333809419a2f8b3a77b82", size = 274161, upload-time = "2025-10-06T05:36:54.309Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/ec/c5c618767bcdf66e88945ec0157d7f6c4a1322f1473392319b7a2501ded7/frozenlist-1.8.0-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5500ef82073f599ac84d888e3a8c1f77ac831183244bfd7f11eaa0289fb30714", size = 294676, upload-time = "2025-10-06T05:36:55.566Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/ce/3934758637d8f8a88d11f0585d6495ef54b2044ed6ec84492a91fa3b27aa/frozenlist-1.8.0-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:50066c3997d0091c411a66e710f4e11752251e6d2d73d70d8d5d4c76442a199d", size = 300638, upload-time = "2025-10-06T05:36:56.758Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/4f/a7e4d0d467298f42de4b41cbc7ddaf19d3cfeabaf9ff97c20c6c7ee409f9/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:5c1c8e78426e59b3f8005e9b19f6ff46e5845895adbde20ece9218319eca6506", size = 283067, upload-time = "2025-10-06T05:36:57.965Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/48/c7b163063d55a83772b268e6d1affb960771b0e203b632cfe09522d67ea5/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:eefdba20de0d938cec6a89bd4d70f346a03108a19b9df4248d3cf0d88f1b0f51", size = 292101, upload-time = "2025-10-06T05:36:59.237Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/d0/2366d3c4ecdc2fd391e0afa6e11500bfba0ea772764d631bbf82f0136c9d/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:cf253e0e1c3ceb4aaff6df637ce033ff6535fb8c70a764a8f46aafd3d6ab798e", size = 289901, upload-time = "2025-10-06T05:37:00.811Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/94/daff920e82c1b70e3618a2ac39fbc01ae3e2ff6124e80739ce5d71c9b920/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:032efa2674356903cd0261c4317a561a6850f3ac864a63fc1583147fb05a79b0", size = 289395, upload-time = "2025-10-06T05:37:02.115Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/20/bba307ab4235a09fdcd3cc5508dbabd17c4634a1af4b96e0f69bfe551ebd/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6da155091429aeba16851ecb10a9104a108bcd32f6c1642867eadaee401c1c41", size = 283659, upload-time = "2025-10-06T05:37:03.711Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/00/04ca1c3a7a124b6de4f8a9a17cc2fcad138b4608e7a3fc5877804b8715d7/frozenlist-1.8.0-cp313-cp313t-win32.whl", hash = "sha256:0f96534f8bfebc1a394209427d0f8a63d343c9779cda6fc25e8e121b5fd8555b", size = 43492, upload-time = "2025-10-06T05:37:04.915Z" },
+    { url = "https://files.pythonhosted.org/packages/59/5e/c69f733a86a94ab10f68e496dc6b7e8bc078ebb415281d5698313e3af3a1/frozenlist-1.8.0-cp313-cp313t-win_amd64.whl", hash = "sha256:5d63a068f978fc69421fb0e6eb91a9603187527c86b7cd3f534a5b77a592b888", size = 48034, upload-time = "2025-10-06T05:37:06.343Z" },
+    { url = "https://files.pythonhosted.org/packages/16/6c/be9d79775d8abe79b05fa6d23da99ad6e7763a1d080fbae7290b286093fd/frozenlist-1.8.0-cp313-cp313t-win_arm64.whl", hash = "sha256:bf0a7e10b077bf5fb9380ad3ae8ce20ef919a6ad93b4552896419ac7e1d8e042", size = 41749, upload-time = "2025-10-06T05:37:07.431Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/c8/85da824b7e7b9b6e7f7705b2ecaf9591ba6f79c1177f324c2735e41d36a2/frozenlist-1.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:cee686f1f4cadeb2136007ddedd0aaf928ab95216e7691c63e50a8ec066336d0", size = 86127, upload-time = "2025-10-06T05:37:08.438Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/e8/a1185e236ec66c20afd72399522f142c3724c785789255202d27ae992818/frozenlist-1.8.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:119fb2a1bd47307e899c2fac7f28e85b9a543864df47aa7ec9d3c1b4545f096f", size = 49698, upload-time = "2025-10-06T05:37:09.48Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/93/72b1736d68f03fda5fdf0f2180fb6caaae3894f1b854d006ac61ecc727ee/frozenlist-1.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4970ece02dbc8c3a92fcc5228e36a3e933a01a999f7094ff7c23fbd2beeaa67c", size = 49749, upload-time = "2025-10-06T05:37:10.569Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/b2/fabede9fafd976b991e9f1b9c8c873ed86f202889b864756f240ce6dd855/frozenlist-1.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:cba69cb73723c3f329622e34bdbf5ce1f80c21c290ff04256cff1cd3c2036ed2", size = 231298, upload-time = "2025-10-06T05:37:11.993Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/3b/d9b1e0b0eed36e70477ffb8360c49c85c8ca8ef9700a4e6711f39a6e8b45/frozenlist-1.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:778a11b15673f6f1df23d9586f83c4846c471a8af693a22e066508b77d201ec8", size = 232015, upload-time = "2025-10-06T05:37:13.194Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/94/be719d2766c1138148564a3960fc2c06eb688da592bdc25adcf856101be7/frozenlist-1.8.0-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0325024fe97f94c41c08872db482cf8ac4800d80e79222c6b0b7b162d5b13686", size = 225038, upload-time = "2025-10-06T05:37:14.577Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/09/6712b6c5465f083f52f50cf74167b92d4ea2f50e46a9eea0523d658454ae/frozenlist-1.8.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:97260ff46b207a82a7567b581ab4190bd4dfa09f4db8a8b49d1a958f6aa4940e", size = 240130, upload-time = "2025-10-06T05:37:15.781Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/d4/cd065cdcf21550b54f3ce6a22e143ac9e4836ca42a0de1022da8498eac89/frozenlist-1.8.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:54b2077180eb7f83dd52c40b2750d0a9f175e06a42e3213ce047219de902717a", size = 242845, upload-time = "2025-10-06T05:37:17.037Z" },
+    { url = "https://files.pythonhosted.org/packages/62/c3/f57a5c8c70cd1ead3d5d5f776f89d33110b1addae0ab010ad774d9a44fb9/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:2f05983daecab868a31e1da44462873306d3cbfd76d1f0b5b69c473d21dbb128", size = 229131, upload-time = "2025-10-06T05:37:18.221Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/52/232476fe9cb64f0742f3fde2b7d26c1dac18b6d62071c74d4ded55e0ef94/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:33f48f51a446114bc5d251fb2954ab0164d5be02ad3382abcbfe07e2531d650f", size = 240542, upload-time = "2025-10-06T05:37:19.771Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/85/07bf3f5d0fb5414aee5f47d33c6f5c77bfe49aac680bfece33d4fdf6a246/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:154e55ec0655291b5dd1b8731c637ecdb50975a2ae70c606d100750a540082f7", size = 237308, upload-time = "2025-10-06T05:37:20.969Z" },
+    { url = "https://files.pythonhosted.org/packages/11/99/ae3a33d5befd41ac0ca2cc7fd3aa707c9c324de2e89db0e0f45db9a64c26/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:4314debad13beb564b708b4a496020e5306c7333fa9a3ab90374169a20ffab30", size = 238210, upload-time = "2025-10-06T05:37:22.252Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/60/b1d2da22f4970e7a155f0adde9b1435712ece01b3cd45ba63702aea33938/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:073f8bf8becba60aa931eb3bc420b217bb7d5b8f4750e6f8b3be7f3da85d38b7", size = 231972, upload-time = "2025-10-06T05:37:23.5Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/ab/945b2f32de889993b9c9133216c068b7fcf257d8595a0ac420ac8677cab0/frozenlist-1.8.0-cp314-cp314-win32.whl", hash = "sha256:bac9c42ba2ac65ddc115d930c78d24ab8d4f465fd3fc473cdedfccadb9429806", size = 40536, upload-time = "2025-10-06T05:37:25.581Z" },
+    { url = "https://files.pythonhosted.org/packages/59/ad/9caa9b9c836d9ad6f067157a531ac48b7d36499f5036d4141ce78c230b1b/frozenlist-1.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:3e0761f4d1a44f1d1a47996511752cf3dcec5bbdd9cc2b4fe595caf97754b7a0", size = 44330, upload-time = "2025-10-06T05:37:26.928Z" },
+    { url = "https://files.pythonhosted.org/packages/82/13/e6950121764f2676f43534c555249f57030150260aee9dcf7d64efda11dd/frozenlist-1.8.0-cp314-cp314-win_arm64.whl", hash = "sha256:d1eaff1d00c7751b7c6662e9c5ba6eb2c17a2306ba5e2a37f24ddf3cc953402b", size = 40627, upload-time = "2025-10-06T05:37:28.075Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/c7/43200656ecc4e02d3f8bc248df68256cd9572b3f0017f0a0c4e93440ae23/frozenlist-1.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:d3bb933317c52d7ea5004a1c442eef86f426886fba134ef8cf4226ea6ee1821d", size = 89238, upload-time = "2025-10-06T05:37:29.373Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/29/55c5f0689b9c0fb765055629f472c0de484dcaf0acee2f7707266ae3583c/frozenlist-1.8.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:8009897cdef112072f93a0efdce29cd819e717fd2f649ee3016efd3cd885a7ed", size = 50738, upload-time = "2025-10-06T05:37:30.792Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/7d/b7282a445956506fa11da8c2db7d276adcbf2b17d8bb8407a47685263f90/frozenlist-1.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2c5dcbbc55383e5883246d11fd179782a9d07a986c40f49abe89ddf865913930", size = 51739, upload-time = "2025-10-06T05:37:32.127Z" },
+    { url = "https://files.pythonhosted.org/packages/62/1c/3d8622e60d0b767a5510d1d3cf21065b9db874696a51ea6d7a43180a259c/frozenlist-1.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:39ecbc32f1390387d2aa4f5a995e465e9e2f79ba3adcac92d68e3e0afae6657c", size = 284186, upload-time = "2025-10-06T05:37:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/14/aa36d5f85a89679a85a1d44cd7a6657e0b1c75f61e7cad987b203d2daca8/frozenlist-1.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:92db2bf818d5cc8d9c1f1fc56b897662e24ea5adb36ad1f1d82875bd64e03c24", size = 292196, upload-time = "2025-10-06T05:37:36.107Z" },
+    { url = "https://files.pythonhosted.org/packages/05/23/6bde59eb55abd407d34f77d39a5126fb7b4f109a3f611d3929f14b700c66/frozenlist-1.8.0-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2dc43a022e555de94c3b68a4ef0b11c4f747d12c024a520c7101709a2144fb37", size = 273830, upload-time = "2025-10-06T05:37:37.663Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/3f/22cff331bfad7a8afa616289000ba793347fcd7bc275f3b28ecea2a27909/frozenlist-1.8.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:cb89a7f2de3602cfed448095bab3f178399646ab7c61454315089787df07733a", size = 294289, upload-time = "2025-10-06T05:37:39.261Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/89/5b057c799de4838b6c69aa82b79705f2027615e01be996d2486a69ca99c4/frozenlist-1.8.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:33139dc858c580ea50e7e60a1b0ea003efa1fd42e6ec7fdbad78fff65fad2fd2", size = 300318, upload-time = "2025-10-06T05:37:43.213Z" },
+    { url = "https://files.pythonhosted.org/packages/30/de/2c22ab3eb2a8af6d69dc799e48455813bab3690c760de58e1bf43b36da3e/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:168c0969a329b416119507ba30b9ea13688fafffac1b7822802537569a1cb0ef", size = 282814, upload-time = "2025-10-06T05:37:45.337Z" },
+    { url = "https://files.pythonhosted.org/packages/59/f7/970141a6a8dbd7f556d94977858cfb36fa9b66e0892c6dd780d2219d8cd8/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:28bd570e8e189d7f7b001966435f9dac6718324b5be2990ac496cf1ea9ddb7fe", size = 291762, upload-time = "2025-10-06T05:37:46.657Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/15/ca1adae83a719f82df9116d66f5bb28bb95557b3951903d39135620ef157/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:b2a095d45c5d46e5e79ba1e5b9cb787f541a8dee0433836cea4b96a2c439dcd8", size = 289470, upload-time = "2025-10-06T05:37:47.946Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/83/dca6dc53bf657d371fbc88ddeb21b79891e747189c5de990b9dfff2ccba1/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:eab8145831a0d56ec9c4139b6c3e594c7a83c2c8be25d5bcf2d86136a532287a", size = 289042, upload-time = "2025-10-06T05:37:49.499Z" },
+    { url = "https://files.pythonhosted.org/packages/96/52/abddd34ca99be142f354398700536c5bd315880ed0a213812bc491cff5e4/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:974b28cf63cc99dfb2188d8d222bc6843656188164848c4f679e63dae4b0708e", size = 283148, upload-time = "2025-10-06T05:37:50.745Z" },
+    { url = "https://files.pythonhosted.org/packages/af/d3/76bd4ed4317e7119c2b7f57c3f6934aba26d277acc6309f873341640e21f/frozenlist-1.8.0-cp314-cp314t-win32.whl", hash = "sha256:342c97bf697ac5480c0a7ec73cd700ecfa5a8a40ac923bd035484616efecc2df", size = 44676, upload-time = "2025-10-06T05:37:52.222Z" },
+    { url = "https://files.pythonhosted.org/packages/89/76/c615883b7b521ead2944bb3480398cbb07e12b7b4e4d073d3752eb721558/frozenlist-1.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:06be8f67f39c8b1dc671f5d83aaefd3358ae5cdcf8314552c57e7ed3e6475bdd", size = 49451, upload-time = "2025-10-06T05:37:53.425Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/a3/5982da14e113d07b325230f95060e2169f5311b1017ea8af2a29b374c289/frozenlist-1.8.0-cp314-cp314t-win_arm64.whl", hash = "sha256:102e6314ca4da683dca92e3b1355490fed5f313b768500084fbe6371fddfdb79", size = 42507, upload-time = "2025-10-06T05:37:54.513Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/9a/e35b4a917281c0b8419d4207f4334c8e8c5dbf4f3f5f9ada73958d937dcc/frozenlist-1.8.0-py3-none-any.whl", hash = "sha256:0c18a16eab41e82c295618a77502e17b195883241c563b00f0aa5106fc4eaa0d", size = 13409, upload-time = "2025-10-06T05:38:16.721Z" },
+]
+
+[[package]]
+name = "fsspec"
+version = "2026.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d5/8d/1c51c094345df128ca4a990d633fe1a0ff28726c9e6b3c41ba65087bba1d/fsspec-2026.4.0.tar.gz", hash = "sha256:301d8ac70ae90ef3ad05dcf94d6c3754a097f9b5fe4667d2787aa359ec7df7e4", size = 312760, upload-time = "2026-04-29T20:42:38.635Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d5/0c/043d5e551459da400957a1395e0febbf771446ff34291afcbe3d8be2a279/fsspec-2026.4.0-py3-none-any.whl", hash = "sha256:11ef7bb35dab8a394fde6e608221d5cf3e8499401c249bebaeaad760a1a8dec2", size = 203402, upload-time = "2026-04-29T20:42:36.842Z" },
+]
+
+[[package]]
+name = "gently"
+version = "0.22.0.dev0"
+source = { editable = "." }
+dependencies = [
+    { name = "aiohttp" },
+    { name = "anthropic" },
+    { name = "bluesky" },
+    { name = "fastapi" },
+    { name = "gently-perception" },
+    { name = "jinja2" },
+    { name = "matplotlib" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "nvidia-ml-py" },
+    { name = "ophyd" },
+    { name = "pillow" },
+    { name = "pymmcore" },
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+    { name = "python-dotenv" },
+    { name = "pyyaml" },
+    { name = "scikit-image", version = "0.25.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "scikit-image", version = "0.26.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "tifffile", version = "2025.5.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "tifffile", version = "2026.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+    { name = "tifffile", version = "2026.5.15", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "torch" },
+    { name = "torchvision" },
+    { name = "uvicorn", extra = ["standard"] },
+]
+
+[package.optional-dependencies]
+device = [
+    { name = "bleak" },
+    { name = "paho-mqtt" },
+    { name = "pyserial" },
+]
+sam = [
+    { name = "segment-anything" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "aiohttp", specifier = ">=3.9.0" },
+    { name = "anthropic", specifier = ">=0.39.0" },
+    { name = "bleak", marker = "extra == 'device'", specifier = ">=0.21.0" },
+    { name = "bluesky", specifier = ">=1.11.0" },
+    { name = "fastapi", specifier = ">=0.104.0" },
+    { name = "gently-perception", editable = "../gently-perception" },
+    { name = "jinja2", specifier = ">=3.1.0" },
+    { name = "matplotlib", specifier = ">=3.7.0" },
+    { name = "numpy", specifier = ">=1.24.0" },
+    { name = "nvidia-ml-py", specifier = ">=12.0.0" },
+    { name = "ophyd", specifier = ">=1.9.0" },
+    { name = "paho-mqtt", marker = "extra == 'device'", specifier = ">=1.6.0" },
+    { name = "pillow", specifier = ">=10.0.0" },
+    { name = "pymmcore", specifier = ">=11.1.1" },
+    { name = "pyserial", marker = "extra == 'device'", specifier = ">=3.5" },
+    { name = "pytest", specifier = ">=7.0.0" },
+    { name = "pytest-asyncio", specifier = ">=0.21.0" },
+    { name = "python-dotenv", specifier = ">=1.0.0" },
+    { name = "pyyaml", specifier = ">=6.0" },
+    { name = "scikit-image", specifier = ">=0.21.0" },
+    { name = "scipy", specifier = ">=1.10.0" },
+    { name = "segment-anything", marker = "extra == 'sam'" },
+    { name = "tifffile", specifier = ">=2023.0.0" },
+    { name = "torch", specifier = ">=2.0.0" },
+    { name = "torchvision", specifier = ">=0.15.0" },
+    { name = "uvicorn", extras = ["standard"], specifier = ">=0.24.0" },
+]
+provides-extras = ["sam", "device"]
+
+[[package]]
+name = "gently-perception"
+version = "0.1.0"
+source = { editable = "../gently-perception" }
+dependencies = [
+    { name = "anthropic" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "pillow" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "anthropic", specifier = ">=0.40.0" },
+    { name = "matplotlib", marker = "extra == 'benchmark'", specifier = ">=3.7.0" },
+    { name = "numpy", specifier = ">=1.24.0" },
+    { name = "pillow", specifier = ">=10.0.0" },
+    { name = "tifffile", marker = "extra == 'benchmark'", specifier = ">=2024.1.30" },
+]
+provides-extras = ["benchmark"]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "historydict"
+version = "1.2.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/21/eb/91c2bd3684147ba8deef546ff2b6d091f32ece81ceb153831bab9f2ea6a5/historydict-1.2.6.tar.gz", hash = "sha256:a800ae05d28b618fe0c913ff0d64e4aebe05d76934fa610539f70ead37dc6fb5", size = 4011, upload-time = "2023-08-05T20:42:20.672Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fe/47/deb64c73aec25af7699247e021153a6bfe9a08452f7f7337dcee4aa07a2b/historydict-1.2.6-py3-none-any.whl", hash = "sha256:b4b00a170f05502aa682caba62435da5fe1f73037e884707581fe84f8d7b43f5", size = 4501, upload-time = "2023-08-05T20:42:19.244Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httptools"
+version = "0.8.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/e5/d471fcb0e14523fe1c3f4ba58ca52480e7bd70ad7109a3846bc75892f7fb/httptools-0.8.0.tar.gz", hash = "sha256:6b2a32f18d97e16e90827d7a819ffa8dbd8cc245fc4e1fa9d1095b54ef4bd999", size = 271342, upload-time = "2026-05-25T22:17:48.841Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/40/b9/be66eb0decd730d89b9c94f930e4b8d87787b05724bb84af98bfd825f72c/httptools-0.8.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:bf3b6f807c8541503cecfbb8a8dffb385640d0d96102f3d112aa8740f9b7c826", size = 208805, upload-time = "2026-05-25T22:16:50.434Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/f7/b4d41eaae2869d31356bc4bbf546f44fae83ff298af0a043ca0625b06773/httptools-0.8.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:da684f2e1aa2ee9bdcb083f3f3a68c5956750b375bc5df864d3a5f0c42a40b77", size = 113527, upload-time = "2026-05-25T22:16:51.672Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/e4/77487e14fc7be47180fd0eb4267c7486d0cc59b74031839a3daf8650136b/httptools-0.8.0-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:a6f21e2a3b0067bbe7f67e34cfd16276af556e5e52f4c7503be0cb5f90e905e4", size = 450035, upload-time = "2026-05-25T22:16:53.313Z" },
+    { url = "https://files.pythonhosted.org/packages/da/72/5a8f787e323f56fbd86c32a4be92a86776e4cfe8b4317db999f452028362/httptools-0.8.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ea897f0c729581ebf72131a438a7932d9b14efef72d75ada966700cac3caaeb", size = 451101, upload-time = "2026-05-25T22:16:54.696Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/41/b44a25560955197674b6744cb903664300e239235a5eaa69df0890d87054/httptools-0.8.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:c0d726cc107fceb7d45f978483b4b70dd8caa836f5914d3434bb18628eb73813", size = 436140, upload-time = "2026-05-25T22:16:56.239Z" },
+    { url = "https://files.pythonhosted.org/packages/74/b0/054aac84c03d7e097bf4c605fb7e74eec3d65c0276adf64ee97f3a103ff5/httptools-0.8.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:9878eb2785ba5eb70631ad269b37976f73d647955e26c91d490eb8a4edfda4ba", size = 437041, upload-time = "2026-05-25T22:16:57.716Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/e8/86b85bbc0ac7892232f1a99ab96a9aa71936984fa06adfc0afc83ca7789e/httptools-0.8.0-cp310-cp310-win_amd64.whl", hash = "sha256:b205e5f5523fa039679da0dfe5a10132b2a4abeae6a86fdd1ddc035f7f836557", size = 90454, upload-time = "2026-05-25T22:16:58.871Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/d2/c3eedaef57de65c3cc5f8dc244cf12d09c84ad258a479055aad6db23206c/httptools-0.8.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:ed377e64805bdba4943c82717333f8f8603a13b09aff9cead2717c6c817fb168", size = 208428, upload-time = "2026-05-25T22:16:59.717Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/94/dfe435d90d0ef61ec0f2cc3d480eef78c59727c6c2ce039f433882f6131a/httptools-0.8.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:9518c406d7b310f05adb1a37f80acabac40504a575d7c0da6d3e365c695ac20d", size = 113366, upload-time = "2026-05-25T22:17:00.795Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/d4/13025f1a56e615dcb331e0bbe2d9a1143212b58c263385fc5d2e558f5bac/httptools-0.8.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:57278e6fa0424c42a8a3e454828ab4f0aff27b40cddf9679579b98c6dce6a376", size = 464676, upload-time = "2026-05-25T22:17:02.014Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/95/4c1c26c0b985f8a3331682d802598f14e32dc41bf7509266eb2c04ad4801/httptools-0.8.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bbb8caadb2b742d293169d2b458b5c001ef70e3158704aa3d3ef9597624c5d1d", size = 464235, upload-time = "2026-05-25T22:17:03.109Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/82/6735be2b0ca527718c431cdb8e5f70c3862c0844a687df0f572c51e11497/httptools-0.8.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:52dd695b865fe96d9d2b16b64a895f3f57bf3cb064e8383cd3b5713a069e8085", size = 449809, upload-time = "2026-05-25T22:17:04.443Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/f9/5811c74f37a758c8a4aa3dc430375119d335947e883efc4664d8f3559a41/httptools-0.8.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:20b4aac66ff65f7db06a375808b78f42a94970aa22e826b3cb2b43eb09174124", size = 452174, upload-time = "2026-05-25T22:17:05.476Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/94/97b75870dea07b71e3ec535cebe525b08d723152e4c7d13fa887e51f4de2/httptools-0.8.0-cp311-cp311-win_amd64.whl", hash = "sha256:a1b4c8e7a489a0d750d91894e9a8cdc295838f1924c0ca903ae993456fddec07", size = 90991, upload-time = "2026-05-25T22:17:06.75Z" },
+    { url = "https://files.pythonhosted.org/packages/14/88/1d21a36da8f5cb0fa49eafd4b169eba5608d57e75bbcf61845cbc6243216/httptools-0.8.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:880490234c10f70a9830743097e8958d6e4b9f5a0ffc24515023afeef984054d", size = 208247, upload-time = "2026-05-25T22:17:07.843Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/42/cc4feea2945cb3051038f090c9b36bd5b8a9d7f5a894a506a8983e33fd1c/httptools-0.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5931891fb7b441b8a3853cf1b85c82c903defce084dd5f6771ca46e31bf862c5", size = 113064, upload-time = "2026-05-25T22:17:09.136Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/a6/febbb8b8db0f58b38e44ad6cb946e6a255ae49b55f2e8543408fb7501ccd/httptools-0.8.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b15fc622b0f869d19207c4089a501d9bcc63ca5e071ffdd2f03f922df882dcb2", size = 523851, upload-time = "2026-05-25T22:17:10.106Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/e4/f90a0df0b83beff265b7e3b65f2a4cefd95792d4be0ac3e16049f2acd3c2/httptools-0.8.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:425f83884fd6343828d8c565f046cb72b6d19063f6924093e11bcd8e1548cd09", size = 518842, upload-time = "2026-05-25T22:17:11.218Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/2d/0c9ac76dd2c893841fbf6498d6acec4f2442e1b7067f6e3e316a80e494e8/httptools-0.8.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ef7c3c97f4311c7be57e2986629df89d49cb434dbff78eafcd48c2bff986b15a", size = 501238, upload-time = "2026-05-25T22:17:12.728Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/42/906adc91ae3a5fa9c59c0a2f21c139725bd7e5b41ae6acd485cd14123ebf/httptools-0.8.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a1afd7c9fbff0d9f5d489c4ce2768bd09c84a46ddefc7161e6aa82ae35c85745", size = 509567, upload-time = "2026-05-25T22:17:13.842Z" },
+    { url = "https://files.pythonhosted.org/packages/05/0b/4240efeb672751ee5b9b380cb0e3fdc050bc05f68adc7a8aefc4fcd9a69a/httptools-0.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:cd96f29b4bab1d42fa6e3d008711c75e0f79e94e06827330160e3a304227f150", size = 90918, upload-time = "2026-05-25T22:17:15.155Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/e5/8cfcabc5546e8022f168be28bcdaa128a240a0befdd03b59d558b4f18bd6/httptools-0.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:614ceea8ea606848bece2338ac03b3ce5324bcb4be8dc7d377ed708012fa4db8", size = 205148, upload-time = "2026-05-25T22:17:16.333Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/0e/0fb14848c19a686c8062ff9067c1a48793e3224b47bc5b201535b6036fce/httptools-0.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2d689918c15a013c65ef52d9fd495d766893ab831a2c8d89f2ac5940a5df847c", size = 111368, upload-time = "2026-05-25T22:17:17.586Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/1b/46f1cecf06b9bbde8e4b8c88034ac7908989e5ff7a3a388ef38392949c1f/httptools-0.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:eb3028cca2fc0a6d720e52ef61d8ebb62fcbfeb1de56874546d858d3f25a26b7", size = 486447, upload-time = "2026-05-25T22:17:18.564Z" },
+    { url = "https://files.pythonhosted.org/packages/77/00/258bfc0837221f81d9725c45f9b948a6a6b2994a147a4fb66e85100c668f/httptools-0.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:88bdd940f2b5d487b4d032c6afa5489a7dc4694410d43de3c38c4fb3af0dc45d", size = 482448, upload-time = "2026-05-25T22:17:19.912Z" },
+    { url = "https://files.pythonhosted.org/packages/04/ab/d1cef3b5523f4d272a70f42a776c3169a2dddfe3a54de4b2ce4a36341528/httptools-0.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6a43c9dd399758ccc0531acb0a3c4a6c299ee893ee9400e9c893b7bdcfae0681", size = 464460, upload-time = "2026-05-25T22:17:20.882Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/48/5d1d072442277bb2b3434e0e60690b8e8c23840ef7de8b6ea54040a536d3/httptools-0.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0770728beb05094c809b98e814edff5fef69d26ad7d21185f2f6d5884a0ba683", size = 471312, upload-time = "2026-05-25T22:17:22.085Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/66/b96623b27e51a68199ef4efdda0613cced9233fe3062ac74e50749c5ad37/httptools-0.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:7685df791fad561384bfb139e77fde27a1ffd93134e016f95a0db424ffbf77b1", size = 90117, upload-time = "2026-05-25T22:17:23.074Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/12/fa3fbf5f9517b273edea2dc982aa82a8c634091e67c590792b729017bc6f/httptools-0.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:de242a49b5d18e0a8776e654e9f6bf6d89f3875a5c35b425a0e7ce940feb3fd6", size = 206183, upload-time = "2026-05-25T22:17:24.004Z" },
+    { url = "https://files.pythonhosted.org/packages/30/fc/5e7c4cb443370f2090a3aba0453a07384d29ff66b7435bb90e77e1037599/httptools-0.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:159e9ab5f701ccd42e555a12f1ad8ff69702910fc1c996cf2bb66e5fcb7a231b", size = 112079, upload-time = "2026-05-25T22:17:25.216Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/53/771bd891eb0f236f32145d6a1775777ec85745f3cc983a1f23d1a3b8ddfe/httptools-0.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c4a9f1707e4823d54dfec6c33fa3697d302aed536ed352a7ebb5a061ddb869d0", size = 481596, upload-time = "2026-05-25T22:17:26.186Z" },
+    { url = "https://files.pythonhosted.org/packages/62/42/94e15bc68ce3d423243c45d7f1b0c7561f13844f97dc52ae23182fb65628/httptools-0.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d76ad7b951387e3632c8716a9bb03ac5b45c5f16119aa409db0459520887944e", size = 480865, upload-time = "2026-05-25T22:17:27.542Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/7c/fe2980fc03723272e30f135b62360b075f513dfe7cc73aef36c7f04012bd/httptools-0.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a3b7387147361c3fd47a0bde763c5c91b5b4cd4dc9989b8ece84ff436c99843b", size = 463189, upload-time = "2026-05-25T22:17:28.546Z" },
+    { url = "https://files.pythonhosted.org/packages/15/1b/47fc5fff68acd1bfa20b4734059c9a06cadb88119dcd5258b5b0d21d91c8/httptools-0.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f256d6ce930c52ca1cb2a960b7da03548c454e7d28b06059ad41bfe789036ce0", size = 466610, upload-time = "2026-05-25T22:17:29.816Z" },
+    { url = "https://files.pythonhosted.org/packages/60/bd/07b13c93ffd9bec9546e0d43f8e19378dd696dbd278511406bc07371ef1f/httptools-0.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:19d1ee275bb59ba2643ba9a3a1e51cc0c788caf2b8df506368e03f56fdd08527", size = 92705, upload-time = "2026-05-25T22:17:31.133Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/c4/121648f68ce066d7bd762d6b6d97e620847642d38d54f3d90ff11d947629/httptools-0.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:de1ed58a974e75d56560acc7e7fed01a454994429456f65209789992e41f2568", size = 215023, upload-time = "2026-05-25T22:17:32.401Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/b0/312a062ae741ae3e8baa8c8bf20be81b2e67337b259ab4349bebc7b6142e/httptools-0.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:e93c227b595c6926c1acee96891dd9da4be338cfbe82e5cd3bb9d8dd7dc4ac0b", size = 117405, upload-time = "2026-05-25T22:17:33.742Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/37/fccd705f795386bb05bf413012fecff2a33e5aa8c2f069096de3e9fd8702/httptools-0.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:2a021c3a8e65cc125390d72f59b968afca3bdcaff25bd67965e0a055a14946ca", size = 558497, upload-time = "2026-05-25T22:17:34.732Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/39/f172e8003576de35f5ba77ff417cf0e34429d35dc014deef15afa337a72c/httptools-0.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:48774d39cbb70e2b1f71f88852a3087ae1d3a1eb80482bb48c13067ab080c14f", size = 571585, upload-time = "2026-05-25T22:17:35.813Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/b9/f5564760af99f3dbbf3f9104dc00e5da27e96cf433c6bdcf77617f70bf3f/httptools-0.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:88eead8ec8680a9f146c655bc88445a325bd7921cfd8194c7337e9467282427d", size = 543297, upload-time = "2026-05-25T22:17:37.08Z" },
+    { url = "https://files.pythonhosted.org/packages/99/67/8d9f2c313618e161b82f3873188e7196126da1d6e29688df40eb3997c77a/httptools-0.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2c032fa028f46871ec7e1fc59fc15e8023eab3e6bbe6ece786a1611719a5d081", size = 539535, upload-time = "2026-05-25T22:17:38.032Z" },
+    { url = "https://files.pythonhosted.org/packages/48/63/b906c01e53f50d432c0defe43ce52764a111dc1bdd028bafbeb54dcfd008/httptools-0.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:384c17174464c8e873398b7af24f0b1f44d992c820328413951a625323155d77", size = 108209, upload-time = "2026-05-25T22:17:39.473Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.17"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b9/28/99c51f664567218d824af024c0251650fb27e4ca066df188dab0769c5b91/idna-3.17.tar.gz", hash = "sha256:5eb0cb53bc467c12eadcf6de83163ad8527cec9416f44b9b61b19caedad2b87f", size = 196048, upload-time = "2026-05-28T14:32:38.55Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/de/a7/f76514cc40ad6234098ecdebda08732d75964776c51a42845b7da10649e2/idna-3.17-py3-none-any.whl", hash = "sha256:466e48829084efe2548012b855df21540b96f2e20e51bd124c851536556a592c", size = 65316, upload-time = "2026-05-28T14:32:37.035Z" },
+]
+
+[[package]]
+name = "imageio"
+version = "2.37.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "pillow" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/84/93bcd1300216ea50811cee96873b84a1bebf8d0489ffaf7f2a3756bab866/imageio-2.37.3.tar.gz", hash = "sha256:bbb37efbfc4c400fcd534b367b91fcd66d5da639aaa138034431a1c5e0a41451", size = 389673, upload-time = "2026-03-09T11:31:12.573Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/fa/391e437a34e55095173dca5f24070d89cbc233ff85bf1c29c93248c6588d/imageio-2.37.3-py3-none-any.whl", hash = "sha256:46f5bb8522cd421c0f5ae104d8268f569d856b29eb1a13b92829d1970f32c9f0", size = 317646, upload-time = "2026-03-09T11:31:10.771Z" },
+]
+
+[[package]]
+name = "importlib-resources"
+version = "7.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e4/06/b56dfa750b44e86157093bc8fca0ab81dccbf5260510de4eaf1cb69b5b99/importlib_resources-7.1.0.tar.gz", hash = "sha256:0722d4c6212489c530f2a145a34c0a7a3b4721bc96a15fada5930e2a0b760708", size = 44985, upload-time = "2026-04-12T16:36:09.232Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/db/55a262f3606bebcae07cc14095338471ad7c0bbcaa37707e6f0ee49725b7/importlib_resources-7.1.0-py3-none-any.whl", hash = "sha256:1bd7b48b4088eddb2cd16382150bb515af0bd2c70128194392725f82ad2c96a1", size = 37232, upload-time = "2026-04-12T16:36:08.219Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "jinja2"
+version = "3.1.6"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markupsafe" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115, upload-time = "2025-03-05T20:05:02.478Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" },
+]
+
+[[package]]
+name = "jiter"
+version = "0.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/b5/55f06bb281d92fb3cc86d14e1def2bd908bb77693183e7cb1f5a3c388b0c/jiter-0.15.0.tar.gz", hash = "sha256:4251acc80e2b7c9b7b8823456ea0fceeb0734dac2df7636d3c711b38476b5a76", size = 166640, upload-time = "2026-05-19T10:09:48.361Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1d/da/76a2c7e510ba15fe323d9509c223ab272da79ea59f54488f4a78da6426db/jiter-0.15.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:edebcf7d1f601199084bb6e844d7dc67e03e04f6ac786b0332d616635c4ff7a4", size = 310849, upload-time = "2026-05-19T10:06:51.944Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/8e/827be942883a4dc0862c48626ff41af3320b1902d136a0bf4b9041f2c567/jiter-0.15.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9f924585cdacf631cd382b657966847bb537bf9ed0a6f9b991da5f05a631480f", size = 314991, upload-time = "2026-05-19T10:06:53.522Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/38/be2832be361ba1b9517c76f46d30b64e985be1dd43c974f4c3a4b1844436/jiter-0.15.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:abbf258599526ad0326fe51e252e24f2bd6f24f1852681b4b78feda3808f1d18", size = 340843, upload-time = "2026-05-19T10:06:55.071Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/d8/90f01fb83c0c7ba509303ec93e32a308fbfa167d264860b01c0fd0dbbd06/jiter-0.15.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7c468136b8bd6bb18c8786e4236a1fa27362f24cb23450ba0cb204ab379b8e6f", size = 365116, upload-time = "2026-05-19T10:06:56.893Z" },
+    { url = "https://files.pythonhosted.org/packages/91/38/94593d34f8c67a0b6f6cbc027f016ffa9780b3a858a7a86f6fd7a15bcc1e/jiter-0.15.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:05906b93d72f03339e6bb7cf8dc10ebda64a0266126eed6beba79e20abcf5fd4", size = 457970, upload-time = "2026-05-19T10:06:58.707Z" },
+    { url = "https://files.pythonhosted.org/packages/df/04/d79962dd49d00c97e2a9b4cacea1947904d02135936960351f9a96d4c1a6/jiter-0.15.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:30ce785d2adb8e32c3f7741442370a74834ec4c01f3c48f0750227a0b4ef27d6", size = 375744, upload-time = "2026-05-19T10:07:00.471Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/2e/5d37abe2be0e819c21e2338bebd410e481763ce526a9138c8c3652fa0123/jiter-0.15.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2fd73e3da91a0a722d67165e849ce2cdc10de0e0d48738c142be8c6c5f310f4c", size = 349609, upload-time = "2026-05-19T10:07:01.829Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/90/98768ad2ed90c1fda15d64157de2dfbf73c1c074d4b1bfaca915480bc7cf/jiter-0.15.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:ceb8fc27d38793f9c97149be8302720c5b22e5c195a37bf2c45dc36c4600a512", size = 354366, upload-time = "2026-05-19T10:07:03.587Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/c4/fbfb806209f1fe4b7dccdfb07bc62bb044300734a945b06fd64db446ef6a/jiter-0.15.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d726e3ceeb337191324b49de298142f27c3ad10886341555d1d5315b5f252c6a", size = 393519, upload-time = "2026-05-19T10:07:05.08Z" },
+    { url = "https://files.pythonhosted.org/packages/37/1c/b9c257cd70cb453b6d10f3ebf0402cdb11669ab455389096f09839670290/jiter-0.15.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:2c8aea7781d2a372227871de4e1a1332aa96f5a89fd76c5e835dafdbad102887", size = 519952, upload-time = "2026-05-19T10:07:06.589Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/1a/aa85027db7ab15829c12feebbc33b404f53fc399bd559d85fd0d6365ff0d/jiter-0.15.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:cf4bd113a69c0a740e27cb962ce10630c36d2b8f59d759a651b955ee9d18a823", size = 550770, upload-time = "2026-05-19T10:07:08.228Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/54/8c3f65c8a5687925e84708f19d63f7f37d28e2b86a48d951702ad94424d8/jiter-0.15.0-cp310-cp310-win32.whl", hash = "sha256:d92a5cd21fdb083931d546c207aa29633787c5dc5b02daab2d32b843f88a2c53", size = 209303, upload-time = "2026-05-19T10:07:10.006Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/72/0528a1eb9f42dd2d8228a0711458628f35924d131f623eaebc35fd23d3d4/jiter-0.15.0-cp310-cp310-win_amd64.whl", hash = "sha256:e58585a58209d72691ce2d62a9147445f5a87beb0bde97fde284c96ae392a3d1", size = 200404, upload-time = "2026-05-19T10:07:11.426Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/13/daa722f5765c393576f466378f9dfd29d77c9bed939e0688f96afa3601ea/jiter-0.15.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:0f862193b8696249d22ec433e85fd2ab0ad9596bc3e45e6c0bc55e8aeba97be2", size = 310899, upload-time = "2026-05-19T10:07:12.89Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/82/2d2551829b082f4b6d82b9f939b031fb808a10aab1ec0664f82e150bb9a2/jiter-0.15.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1303d4d68a9b051ea90502402063ecf3807da00ad2affa19ca1ae3b90b3c5f67", size = 314963, upload-time = "2026-05-19T10:07:14.539Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/0a/8b1a51466f7fe9f31dbe4bc7e0ca848674f9825e0f737b929b97e8c60aa7/jiter-0.15.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:392b8ab019e5502d08aff85c6272209c24bc2cbe706ea82a56368f524236614a", size = 341730, upload-time = "2026-05-19T10:07:15.869Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/2a/e71dea19822e2e404e83992a08c1d6b9b617bb944f28c9c2fbd85d02c91e/jiter-0.15.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:773b6eb282ce11ee19f05f6b2d4404fa308e5bbd353b0b80a0262caad6db2cd7", size = 366214, upload-time = "2026-05-19T10:07:17.259Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/59/97e1fa539d124a509a00ab7f669289d1c1d236ecabf12948a18f16c91082/jiter-0.15.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8d2c0c44d569ce0f2850f5c926f8caeb5f245fbc84475aeb36efccc2103e6dbd", size = 459527, upload-time = "2026-05-19T10:07:18.741Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/7a/4a68d331aef8cf2e2393c14a3aacb635c62aa86071b0229899fb5baaa907/jiter-0.15.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:032396229564bca02440396bd327710719f724f5e7b7e9f7a8eb3faa4a2c2281", size = 375451, upload-time = "2026-05-19T10:07:20.208Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/7e/1c445c2b6f0e30a274dc8082e0c3c7825411cce80d726bccd697c98cc8d3/jiter-0.15.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f3d37768fce7f88dd2a8c6091f2325dea27d30d30d5c6e7a1c0f0af77723b708", size = 349428, upload-time = "2026-05-19T10:07:22.372Z" },
+    { url = "https://files.pythonhosted.org/packages/00/94/e20d38984fc17a636371bffd2ae0f698124fdc8e75ef969cd2da6ba7cea7/jiter-0.15.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:2c9cb907439d20bd0c7d7565ca01ee52234203208433749bae5b516907526928", size = 355405, upload-time = "2026-05-19T10:07:23.916Z" },
+    { url = "https://files.pythonhosted.org/packages/94/fa/4d09f814779d0ea80a28ed8e4c6662ec9a4a8ecef0ac52190ebac6262d14/jiter-0.15.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:9100ddbec09741cc66feb0fc6773f8bdbd0e3c345689368f260082ff85dcc0cd", size = 393688, upload-time = "2026-05-19T10:07:25.854Z" },
+    { url = "https://files.pythonhosted.org/packages/54/9d/8eb5d4fb8bf7e93a75964a5da71a75c67c864baf7fa3f98598187b3c7e57/jiter-0.15.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:ae1b0d82ac2d987f9ea512b1c9adfcc71a28de3dea3a6039b54d76cffda9901e", size = 520853, upload-time = "2026-05-19T10:07:27.303Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/2c/5e07874e59e623a943a0acf1552a80d05b70f31b402287a8fc6d7ec634c7/jiter-0.15.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:8020c99ec13a7db2b6f96cbe82ef4721c88b426a4892f27478044af0284615ef", size = 551016, upload-time = "2026-05-19T10:07:28.846Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ed/d2d34422143474cadc15b60d482b1c35683dbc5c63c24346ddd0df09bcaf/jiter-0.15.0-cp311-cp311-win32.whl", hash = "sha256:42bfb257930800cf43e7c62c832402c704ab60797c992faf88d20e903eac8f32", size = 209518, upload-time = "2026-05-19T10:07:30.431Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/7d/52778b930e5cc3e52a37d950b1c10494244308b4329b25a0ff0d88303a81/jiter-0.15.0-cp311-cp311-win_amd64.whl", hash = "sha256:860a74063284a2ae9bfedd694f299cc2c68e2696c5f3d440cc9d18bb81b9dd04", size = 200565, upload-time = "2026-05-19T10:07:32.125Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/4f/d9b4067feb69b3fa6eb0488e1b59e2ad5b463fe39f59e527eab2aca00bb0/jiter-0.15.0-cp311-cp311-win_arm64.whl", hash = "sha256:37a10c377ce3a4a85f4a67f28b7afe093154cde77eaf248a72e856aa08b4d865", size = 195488, upload-time = "2026-05-19T10:07:33.846Z" },
+    { url = "https://files.pythonhosted.org/packages/44/53/4f6bddbcde3c71e56d0aa1337ec95950f3d27dd4153e25aadf0feac71751/jiter-0.15.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:0e90a1c315a0226ec822d973817967f9223b7701546c8c2a7913e7ab0926294d", size = 308793, upload-time = "2026-05-19T10:07:35.25Z" },
+    { url = "https://files.pythonhosted.org/packages/01/84/c01099b59a285a1ebba64ae93f62bfa036675340fd1b0045ae65890a0442/jiter-0.15.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8c9004af7c8d67cce7f1aae1026fb55607f4aa600710d08ede3a3ce4aeefe7e0", size = 309570, upload-time = "2026-05-19T10:07:36.919Z" },
+    { url = "https://files.pythonhosted.org/packages/58/64/8fb7f9d45bb98190355454cd04dad8d8f27223d6bd52f83af07f637168a6/jiter-0.15.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c210f8b35dc6f30aafd4b4365ca89b9d1189f21ab49b8e68fa6322a847aef138", size = 336783, upload-time = "2026-05-19T10:07:38.694Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/b6/f5739011d009b3a30f6a53c5240979030ba29ae46a8c67e3a15759f7c37d/jiter-0.15.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5f30bae8bc1c2d613e28e5af3e8cceb09b742f1c8a8a5f839fb67afaffc03b61", size = 363555, upload-time = "2026-05-19T10:07:40.832Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/12/98a9d9f766665e8a3b6252454e17cb0c464606a28cf2fa09399b003345fa/jiter-0.15.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c60e71b6d10cfc284c9bf36bd885e8d44c46f688ce50aa91b5edd90181dea687", size = 452255, upload-time = "2026-05-19T10:07:42.62Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/d5/60f972840f79c5e7544fce567c56f1e4e50468f996baba3e78d823dd62a6/jiter-0.15.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:0ab068bce62a45aa3e7367eceaffb5dde60b7eb853be8dece45132e3d0ff4879", size = 373559, upload-time = "2026-05-19T10:07:44.201Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/cf/d46ef1234ba335aabc2f013210db8e0821a22f5e644a2e9449df199ecc23/jiter-0.15.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fa248c9eb220197d363f688818dac2fd4b2f0cd7d843ca7105d652034823427d", size = 346055, upload-time = "2026-05-19T10:07:46.005Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/63/4d2749d8d54d230bad9b3a6b0d00cc28c6ff6b2fdffc26a8ccf76cc5a974/jiter-0.15.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2a77aadd57cac1682e4401a72724d2796d89a4ba129b1a5812aa94ee480826eb", size = 351406, upload-time = "2026-05-19T10:07:47.855Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/b9/9965b990035d8773328e0a8c8b457a87bf2b19f6c4126d9d99296be5d16a/jiter-0.15.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2ae901f3a55bfafdde31d289590fa25e3245735a2b1e8c7cc15871710a002871", size = 389357, upload-time = "2026-05-19T10:07:49.665Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/55/9ddf903deda1413e87fed792f416b7123daee5b8efbad6a202a7421c36a5/jiter-0.15.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:f0b271b462769543716f92d3a4f90527df6ef5ed05ee95ec4137f513e21e1b77", size = 517263, upload-time = "2026-05-19T10:07:51.537Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/76/a0c40ad064d3a20a4fde231e35d56e9a01ce82164278180e82d5daf85469/jiter-0.15.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:2fb6a5d26af81fc0f00f9360a891e05cf755e149bba391c4d563adc54812973d", size = 548646, upload-time = "2026-05-19T10:07:53.196Z" },
+    { url = "https://files.pythonhosted.org/packages/23/4f/eca9b954942916ba2f453891b8593ab444cd872396fe66a3936616f236f3/jiter-0.15.0-cp312-cp312-win32.whl", hash = "sha256:c2f6bb8b5216ab9e7873bc08b5d7bef2b8abbb578a3069bf1cd14a45d71d771d", size = 206427, upload-time = "2026-05-19T10:07:55.307Z" },
+    { url = "https://files.pythonhosted.org/packages/95/bf/8ead82a87495149542748e828d153fd232a512a22c83b02c4815c1a9c7d8/jiter-0.15.0-cp312-cp312-win_amd64.whl", hash = "sha256:40b2c7e92c44a84d748d21706c68dc6ff8161d80b59c99d774721a0d2317d7c7", size = 197300, upload-time = "2026-05-19T10:07:56.651Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/e4/9b8a78fb2d894471bc344e37f1949bdd784bd914d031dba0ba3a40c71dd7/jiter-0.15.0-cp312-cp312-win_arm64.whl", hash = "sha256:cc0bc345cf2df9d1c00ac443f50d543c1ccfa8b0422cb85b1ab70d681c0b255b", size = 192702, upload-time = "2026-05-19T10:07:58.307Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/f4/f708c900ecee41b2025ef8413d5351e5649eb2125c506f6720cc69b06f5c/jiter-0.15.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:1c11465f97e2abf45a014b83b730222f8f1c5335e802c7055a67d50de6f1f4e3", size = 307829, upload-time = "2026-05-19T10:07:59.704Z" },
+    { url = "https://files.pythonhosted.org/packages/86/59/db537c0949e83668c38481d426b9f2fd5ab758c4ee53a811dd0a510626a0/jiter-0.15.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:d1e7b1776f0797956c509e123d0952d10d293a9492dea9f288ab9570ec01d1a5", size = 308445, upload-time = "2026-05-19T10:08:01.184Z" },
+    { url = "https://files.pythonhosted.org/packages/37/38/ea0e13b18c30ef951da0d47d39e7fa9edb82a93a62990ffbd7cea9b622d4/jiter-0.15.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:351a341c2105aa430b7047e30f1bf7975f6313b00165d3fc07be2edaf741f279", size = 336181, upload-time = "2026-05-19T10:08:02.688Z" },
+    { url = "https://files.pythonhosted.org/packages/58/fc/2303901b16c4ba05865588990a420c0b4156270b44379c20931544a1d962/jiter-0.15.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4ab395feec8d249ec4044e228e98a7033f043426a265df439dc3698823f0a4e4", size = 362985, upload-time = "2026-05-19T10:08:04.394Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/6f/11bace093c52e7d4d26c8e606ccd7ae8c972189622469ec0d9e28161e28b/jiter-0.15.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a2a438005b6f22d0273413484d6094d7c2c5d10ec1b3a3bf128e0d1d3ba53258", size = 453292, upload-time = "2026-05-19T10:08:05.967Z" },
+    { url = "https://files.pythonhosted.org/packages/22/db/987f2f086ca4d7a6582eb4ccd513f9b26b42d9e4243a087609a3137a8fc7/jiter-0.15.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f18f85e4218d1b40f000f42a92239a7a61a902cd42c65e6c360dbd17dcb20894", size = 373501, upload-time = "2026-05-19T10:08:07.857Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/7c/89fbcabb2739b7a5b8dc959a1b6c5761f6484f5fed3486854b3c789bb1de/jiter-0.15.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d1aa62e277fc1cbd80e6deacae6f4d983b41b3d7728e0645c5d741a6149bba45", size = 344683, upload-time = "2026-05-19T10:08:09.431Z" },
+    { url = "https://files.pythonhosted.org/packages/30/6f/6cca7692e7dddfec6d8d76c54dc97f2af2a41df4ac0674b999df1f09a5f3/jiter-0.15.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:6550fa135c7deb8ead6af49ed7ff648532ea8334a1447fe34a36315ef79c5c29", size = 350892, upload-time = "2026-05-19T10:08:11.352Z" },
+    { url = "https://files.pythonhosted.org/packages/39/14/0338d6190cb8e6d22e677ab1d4eabd4117f67cca70c54cd04b82ff64e068/jiter-0.15.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:066f8f33f18b2419cd8213b2436fa7fbc9c499f315971cfa3ce1f9820c001b1b", size = 388723, upload-time = "2026-05-19T10:08:12.912Z" },
+    { url = "https://files.pythonhosted.org/packages/90/31/cc19f4a1bdb6afb09ce6a2f2615aa8d44d994eba0d8e6105ed1af920e736/jiter-0.15.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:75e8a04e91432dde9f1838373cf93d23726c79d3e908d319acf0e796f85592e7", size = 516648, upload-time = "2026-05-19T10:08:14.808Z" },
+    { url = "https://files.pythonhosted.org/packages/49/9f/833c541512cd091b63c10c0381973dfe11bc7a503a818c16384417e0c81e/jiter-0.15.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:a97261f1fccb8e50ecd2890a96e46efdc3f57c80a197324c6777827231eca712", size = 547382, upload-time = "2026-05-19T10:08:16.927Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/11/e7b70e91f90bc4477e8eee9e8a5f7cf3cb41b4525d6394dc98a714eb8f7f/jiter-0.15.0-cp313-cp313-win32.whl", hash = "sha256:c77496cb10bd7549690fbbab3e5ec05857b83e49276f4a9423a766ddd2afcd4c", size = 205845, upload-time = "2026-05-19T10:08:18.401Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/23/5c20d9ad6f02c493e4023e5d2d09e1c1f15fe2753c9102c544aff068a88e/jiter-0.15.0-cp313-cp313-win_amd64.whl", hash = "sha256:b15741f501469009ae0ae90b7147958a664a7dede40aa7ff174a8a4645f546d0", size = 196842, upload-time = "2026-05-19T10:08:20.131Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/11/1eb400ef248e8c925fd883fbe325daf5e42cd1b0d308539dd332bd4f7ffc/jiter-0.15.0-cp313-cp313-win_arm64.whl", hash = "sha256:5d6a60072b44c3c2b797a7ddcbcbbf2b34ea3cfd4721580fbfd2a09d9d9b84ba", size = 192212, upload-time = "2026-05-19T10:08:21.807Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/60/2fd8d7c79da8acf9b7b277c7616847773779356b92acfc9bb158452174da/jiter-0.15.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:ef1fd24d9413f6209e00d3d5a453e67acfe004a25cc6c8e8484faed4311ab9e8", size = 315065, upload-time = "2026-05-19T10:08:23.218Z" },
+    { url = "https://files.pythonhosted.org/packages/46/f4/008fb7d65e8ac2abf00811651a661e025c4ba80bbc6f378450384ddd3aed/jiter-0.15.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:144f8e72cb53dab146347b91cceac01f5481237f2b93b4a339a1ee8f8878b67c", size = 339444, upload-time = "2026-05-19T10:08:24.701Z" },
+    { url = "https://files.pythonhosted.org/packages/00/55/90b0c7b9c6896c0f2a591dd36d36b71d22e09674bfef178fa03ba3f81499/jiter-0.15.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:553fcac2ef2cb990877f9fc0833b8b629a3e6a5670b6b5fd58219b41a653ddc4", size = 347779, upload-time = "2026-05-19T10:08:26.408Z" },
+    { url = "https://files.pythonhosted.org/packages/51/6b/69666cec5000fd57734c118437394516c749ae8dbeea9fb66d6fef9c4775/jiter-0.15.0-cp313-cp313t-win_amd64.whl", hash = "sha256:774f93f65031856bf14ad9f59bdcab8b8cad501e5ceabd51ba3525f76937a25b", size = 200395, upload-time = "2026-05-19T10:08:28.055Z" },
+    { url = "https://files.pythonhosted.org/packages/39/04/a6aa62cd27e8149b0d28df5561f10f6cceaf7935a9ccf3f1c5a05f9a0cd8/jiter-0.15.0-cp313-cp313t-win_arm64.whl", hash = "sha256:f1e1754960f38ec40613a07e5e372df67acb3b890fb383b6fb3de3e49ddbf3c7", size = 190516, upload-time = "2026-05-19T10:08:29.35Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/d2/079f350ebf7859d081de30aa890f9e3be68516f754f3ba32366ffff4dcee/jiter-0.15.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:ac0d9ddea4350974be7a221fc25895f251a8fee748c889bdced2141c0fec1a49", size = 308884, upload-time = "2026-05-19T10:08:31.667Z" },
+    { url = "https://files.pythonhosted.org/packages/04/4e/a2c30a7f69b48c03b20935d647479106fe932f6e63f75faf53937197e05d/jiter-0.15.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:01a8222cf05ab1128e239421156c207949808acaaea2bdfd33130ae666786e86", size = 310028, upload-time = "2026-05-19T10:08:33.304Z" },
+    { url = "https://files.pythonhosted.org/packages/40/90/2e7cdfd3cf8ca967be38c48f5cf474d79f089efaf559a40f15984a77ae69/jiter-0.15.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:182226cbc930c9fab81bc2e41a4da672f89539906dadb05e75670ac07b94f71f", size = 337485, upload-time = "2026-05-19T10:08:35.259Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/11/15a1aa28b120b8ee5b4f1fb894c125046225f09847738bd64233d3b84883/jiter-0.15.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:71683c38c825452999b5717fcae07ea708e8c93003e808be4319c1b02e3d176e", size = 364223, upload-time = "2026-05-19T10:08:36.694Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/25/f442e8af5f3d0dcf47b39e83a0efd9ee45ea946aa6d04625dc3181eae3b6/jiter-0.15.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:30f2218e6a9e5c18bc10fe6d41ac189c442c88eacf11bad9f28ef95a9bef00e6", size = 456387, upload-time = "2026-05-19T10:08:38.143Z" },
+    { url = "https://files.pythonhosted.org/packages/da/f4/37f2d2c9f64f49af7da652ed7532bb5a2372e588e6927c3fdd76f911db65/jiter-0.15.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5157de9f76eb4bc5ea74a1219366a25f945ad305641d74e04f59c54087091aa9", size = 374461, upload-time = "2026-05-19T10:08:39.869Z" },
+    { url = "https://files.pythonhosted.org/packages/60/28/edcfbbbf0cb15436f36664a8908a0df47ab9006298d4cd937dc08ea932d6/jiter-0.15.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90c5db5527c221249a876160663ab891ace358c17f7b9c93ec1478b7f0550e5c", size = 345924, upload-time = "2026-05-19T10:08:41.668Z" },
+    { url = "https://files.pythonhosted.org/packages/47/13/89fba6398dab7f202b7278c4b4aac122399d2c0183971c4a57a3b7088df5/jiter-0.15.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:3e4540b8e74e4268811ac05db226a6a128ff572e7e0ce3f1163b693cadb184cd", size = 352283, upload-time = "2026-05-19T10:08:43.091Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/da/0f6af8cef2c565a1ab44d970f268c43ccaa72707386ea6388e6fe2b6cd26/jiter-0.15.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:62ebd14e47e9aed9df4472afcb2663668ce4d74891cd54f86bf6e44029d6dc89", size = 389985, upload-time = "2026-05-19T10:08:44.915Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/ec/b9cb7d6d29e24ee14910266157d2a279d7a8f60ee0df7fa840882976ba64/jiter-0.15.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0be6f5ad41a809f303f416d17cec92a7a725902fb9b4f3de3d19362ac0ef8554", size = 517695, upload-time = "2026-05-19T10:08:46.486Z" },
+    { url = "https://files.pythonhosted.org/packages/64/5e/6d1bda880723aae0ad86b4b763f044362448efe31e3e819635d41cb03451/jiter-0.15.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:813dfbb17d65328bf86e5f0905dd277ba2265d3ca20556e86c0c7035b7182e5a", size = 548868, upload-time = "2026-05-19T10:08:48.026Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/72/7de501cf38dcacaf35098796f3a50e0f2e338baba18a58946c618544b809/jiter-0.15.0-cp314-cp314-win32.whl", hash = "sha256:50e51156192722a9c58db112837d3f8ef96fb3c5ecc14e95f409134b08b158ec", size = 206380, upload-time = "2026-05-19T10:08:49.738Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/a9/e19addf4b0c1bdce52c6da12351e6bc42c340c45e7c09e2158e46d293ccc/jiter-0.15.0-cp314-cp314-win_amd64.whl", hash = "sha256:30ce1a5d16b5641dc935d50ef775af6a0871e3d14ab05d6fc54dff371b78e558", size = 197687, upload-time = "2026-05-19T10:08:51.088Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/c9/776b1db01db25fc6c1d58d1979a37b0a9fe787e5f5b1d062d2eaacb77923/jiter-0.15.0-cp314-cp314-win_arm64.whl", hash = "sha256:510c8b3c17a0ed9ac69850c0438dada3c9b82d9c4d589fcb62002a5a9cf3a866", size = 192571, upload-time = "2026-05-19T10:08:52.451Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/f6/45bb4670bacf300fd2c7abadbfb3af376e5f1b6ae75fd9bc069891d15870/jiter-0.15.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7553333dd0930c104a5a0db8df72bf7219fe663d731383b576bb6ed6351c984d", size = 317151, upload-time = "2026-05-19T10:08:53.867Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/68/ed635ad5acd7b73e454283083bbb7c8205ad10e88b0d9d7d793b09fe8226/jiter-0.15.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f2143ab06181d2b029eedcb6af3cebe95f11bbac62441781860f98ee9330a6a6", size = 341243, upload-time = "2026-05-19T10:08:55.383Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/db/3ff4176b817b8ea33879e71e13d8bc2b0d481a7ed3fe9e080f333d415c16/jiter-0.15.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6eac374c5c975709b69c10f09afd199df74150172156ad10c8d4fd785b7da995", size = 363629, upload-time = "2026-05-19T10:08:56.928Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/24/5f8270e0ba9c883582f96f722f8a0b58015c7ce1f8c6d4571cf394e99b6b/jiter-0.15.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b3b3b775e33d3bfaec9899edc526ae97b0da0bf9d071a46124ba419149a414f8", size = 456198, upload-time = "2026-05-19T10:08:58.618Z" },
+    { url = "https://files.pythonhosted.org/packages/45/5b/76fc02b0b5c54c3d18c60653156e2f76fde1816f9b4722db68d6ee2c897e/jiter-0.15.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eda3071db3346334beae1360b46da4606da57bf3528c167b3c38533afaf9f2c5", size = 373710, upload-time = "2026-05-19T10:09:00.151Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/52/4310821b0ea9277994d3e1f49fc6a4b34e4800caebacb2c0af81da59a454/jiter-0.15.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c6694a173ecabc12eb60efbc0b474464ead1951ff65cd8b1e72100715c64512b", size = 349901, upload-time = "2026-05-19T10:09:01.621Z" },
+    { url = "https://files.pythonhosted.org/packages/93/fe/67648c35b3594fba8854ac64cc8a826d8bcd18324bbdb53d77697c60b6ef/jiter-0.15.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:a254e10b593624d230c365b6d616b22ca0ad65e63a16e6631c2b3466022e6ba8", size = 352438, upload-time = "2026-05-19T10:09:03.216Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/28/0a1879d07ad6b3e025a2750027363452ced93c2d16d1c9d4b153ffd51c91/jiter-0.15.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d8d2955167274e15d79a7a020afdd9b39c990eb80b2d89fca695d92dcfdd38ec", size = 388152, upload-time = "2026-05-19T10:09:04.741Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/78/46c6f6b56ba85c90021f4afd72ed42f691f8f84daacb5fe27277070e3858/jiter-0.15.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:acf4ee4d1fc55917239fe72972fb292dd773055d05eb040d36f4326e02cc2c0e", size = 517707, upload-time = "2026-05-19T10:09:06.231Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/cb/720662d4c88fcad606e826fef5424365527ba43ce4868a479aed8f8c507e/jiter-0.15.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:e7196e56f1cd69af1dbb07dff02dcfb260a50b45a82d409d92a06fedb32473b5", size = 548241, upload-time = "2026-05-19T10:09:08.093Z" },
+    { url = "https://files.pythonhosted.org/packages/60/e3/935b8034fd143f21125c87d51404a9e0e1449186a494405721ff5d1d695e/jiter-0.15.0-cp314-cp314t-win32.whl", hash = "sha256:7f6163c0f10b055245f814dcc59f4818da60dfe72f3e72ab89fc24b6bd5e9c52", size = 207950, upload-time = "2026-05-19T10:09:09.616Z" },
+    { url = "https://files.pythonhosted.org/packages/93/59/984fd9ece895953dad3e0880a650e766f5a2da2c5514f0eafdaaabbeb5f9/jiter-0.15.0-cp314-cp314t-win_amd64.whl", hash = "sha256:980c256edb05b78a111b99c4de3b1d32e31634b867fd1fc2cf726e7b7bba9854", size = 200055, upload-time = "2026-05-19T10:09:11.367Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/a4/cf8d779feb133a27a2e3bc833bccb9e13aa332cdf820497ebf72c10ce8c3/jiter-0.15.0-cp314-cp314t-win_arm64.whl", hash = "sha256:66b1880df2d01e206e8339769d1c7c1753bcb653efd6289e203f6f24ebada0c0", size = 191244, upload-time = "2026-05-19T10:09:12.74Z" },
+    { url = "https://files.pythonhosted.org/packages/65/43/1fc62172aa98b50a7de9a25554060db510f85c89cfbed0dfe13e1907a139/jiter-0.15.0-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:411fa4dfa5a7ae3d11491027ffb9beadec3996010a986862db70d91abba1c750", size = 305585, upload-time = "2026-05-19T10:09:35.995Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/c4/dd58fcd9e2df83666e5c1c1347bef58ce919cd8efc3ffa38aeea62ce493b/jiter-0.15.0-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:2b0074e2f56eb2dacca1689760fd2852a068f85a0547a157b82cb4cafeb6768b", size = 306936, upload-time = "2026-05-19T10:09:37.435Z" },
+    { url = "https://files.pythonhosted.org/packages/39/86/b695e16f1180c07f43ea98e73ecd21cf63fa2e1b0c1103739013784d11ae/jiter-0.15.0-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:913d02d29c9606643418d9ccfc3b72492ab25a6bf7889934e09a3490f8d3438b", size = 342453, upload-time = "2026-05-19T10:09:39.294Z" },
+    { url = "https://files.pythonhosted.org/packages/34/56/55d76614af37fe3f22a3347d1e410d2a15da581997cb2da499a625000bb5/jiter-0.15.0-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b15d3ec9b0449c40e85319bdb4caa8b77ab526e74f5532ed94bec15e2f66822c", size = 345606, upload-time = "2026-05-19T10:09:40.727Z" },
+    { url = "https://files.pythonhosted.org/packages/73/38/505941b2b092fd5bbbd60a52a880db1173f1690ae6751bed3af1c9ddcb4e/jiter-0.15.0-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:631f13a3d04e97d4e083993b10f4b99530e3a10d953e2eb5e196b7dc7f812ce0", size = 303769, upload-time = "2026-05-19T10:09:42.203Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/95/a06692b29e77473f286e1ec1f426d3ca44d7b5843be8ad21d7a5f3fcdcc0/jiter-0.15.0-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:b6c0ffae686c39bf3737be60793783267628783ea42545632c10b291105aee45", size = 305128, upload-time = "2026-05-19T10:09:43.657Z" },
+    { url = "https://files.pythonhosted.org/packages/23/85/7270d7ad41d6061a25b950c6bf91d638bd9aacb113200a8c8d57a055fd67/jiter-0.15.0-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1d54fb5b31dea401a41af3f8a7d2512e9b6a6a005491e6166c7e4ffab9639a9c", size = 340459, upload-time = "2026-05-19T10:09:45.452Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/8d/302cb2057b7513327b4d575cff6b1d066ee6431a5357fc3f8867cd684406/jiter-0.15.0-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:54d5d6090cdc1b7c9e780dfb04949a990adb1e301a2fc0bbcee7de4638d33f9a", size = 344469, upload-time = "2026-05-19T10:09:46.864Z" },
+]
+
+[[package]]
+name = "jsonschema"
+version = "4.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "jsonschema-specifications" },
+    { name = "referencing" },
+    { name = "rpds-py", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "rpds-py", version = "2026.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
+]
+
+[[package]]
+name = "jsonschema-specifications"
+version = "2025.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
+]
+
+[[package]]
+name = "kiwisolver"
+version = "1.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d0/67/9c61eccb13f0bdca9307614e782fec49ffdde0f7a2314935d489fa93cd9c/kiwisolver-1.5.0.tar.gz", hash = "sha256:d4193f3d9dc3f6f79aaed0e5637f45d98850ebf01f7ca20e69457f3e8946b66a", size = 103482, upload-time = "2026-03-09T13:15:53.382Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ac/f8/06549565caa026e540b7e7bab5c5a90eb7ca986015f4c48dace243cd24d9/kiwisolver-1.5.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:32cc0a5365239a6ea0c6ed461e8838d053b57e397443c0ca894dcc8e388d4374", size = 122802, upload-time = "2026-03-09T13:12:37.515Z" },
+    { url = "https://files.pythonhosted.org/packages/84/eb/8476a0818850c563ff343ea7c9c05dcdcbd689a38e01aa31657df01f91fa/kiwisolver-1.5.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:cc0b66c1eec9021353a4b4483afb12dfd50e3669ffbb9152d6842eb34c7e29fd", size = 66216, upload-time = "2026-03-09T13:12:38.812Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/c4/f9c8a6b4c21aed4198566e45923512986d6cef530e7263b3a5f823546561/kiwisolver-1.5.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:86e0287879f75621ae85197b0877ed2f8b7aa57b511c7331dce2eb6f4de7d476", size = 63917, upload-time = "2026-03-09T13:12:40.053Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/0e/ba4ae25d03722f64de8b2c13e80d82ab537a06b30fc7065183c6439357e3/kiwisolver-1.5.0-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:62f59da443c4f4849f73a51a193b1d9d258dcad0c41bc4d1b8fb2bcc04bfeb22", size = 1628776, upload-time = "2026-03-09T13:12:41.976Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/e4/3f43a011bc8a0860d1c96f84d32fa87439d3feedf66e672fef03bf5e8bac/kiwisolver-1.5.0-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9190426b7aa26c5229501fa297b8d0653cfd3f5a36f7990c264e157cbf886b3b", size = 1228164, upload-time = "2026-03-09T13:12:44.002Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/34/3a901559a1e0c218404f9a61a93be82d45cb8f44453ba43088644980f033/kiwisolver-1.5.0-cp310-cp310-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c8277104ded0a51e699c8c3aff63ce2c56d4ed5519a5f73e0fd7057f959a2b9e", size = 1246656, upload-time = "2026-03-09T13:12:45.557Z" },
+    { url = "https://files.pythonhosted.org/packages/87/9e/f78c466ea20527822b95ad38f141f2de1dcd7f23fb8716b002b0d91bbe59/kiwisolver-1.5.0-cp310-cp310-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8f9baf6f0a6e7571c45c8863010b45e837c3ee1c2c77fcd6ef423be91b21fedb", size = 1295562, upload-time = "2026-03-09T13:12:47.562Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/66/fd0e4a612e3a286c24e6d6f3a5428d11258ed1909bc530ba3b59807fd980/kiwisolver-1.5.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:cff8e5383db4989311f99e814feeb90c4723eb4edca425b9d5d9c3fefcdd9537", size = 2178473, upload-time = "2026-03-09T13:12:50.254Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/8e/6cac929e0049539e5ee25c1ee937556f379ba5204840d03008363ced662d/kiwisolver-1.5.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:ebae99ed6764f2b5771c522477b311be313e8841d2e0376db2b10922daebbba4", size = 2274035, upload-time = "2026-03-09T13:12:51.785Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/d3/9d0c18f1b52ea8074b792452cf17f1f5a56bd0302a85191f405cfbf9da16/kiwisolver-1.5.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:d5cd5189fc2b6a538b75ae45433140c4823463918f7b1617c31e68b085c0022c", size = 2443217, upload-time = "2026-03-09T13:12:53.329Z" },
+    { url = "https://files.pythonhosted.org/packages/45/2a/6e19368803a038b2a90857bf4ee9e3c7b667216d045866bf22d3439fd75e/kiwisolver-1.5.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:f42c23db5d1521218a3276bb08666dcb662896a0be7347cba864eca45ff64ede", size = 2249196, upload-time = "2026-03-09T13:12:55.057Z" },
+    { url = "https://files.pythonhosted.org/packages/75/2b/3f641dfcbe72e222175d626bacf2f72c3b34312afec949dd1c50afa400f5/kiwisolver-1.5.0-cp310-cp310-win_amd64.whl", hash = "sha256:94eff26096eb5395136634622515b234ecb6c9979824c1f5004c6e3c3c85ccd2", size = 73389, upload-time = "2026-03-09T13:12:56.496Z" },
+    { url = "https://files.pythonhosted.org/packages/da/88/299b137b9e0025d8982e03d2d52c123b0a2b159e84b0ef1501ef446339cf/kiwisolver-1.5.0-cp310-cp310-win_arm64.whl", hash = "sha256:dd952e03bfbb096cfe2dd35cd9e00f269969b67536cb4370994afc20ff2d0875", size = 64782, upload-time = "2026-03-09T13:12:57.609Z" },
+    { url = "https://files.pythonhosted.org/packages/12/dd/a495a9c104be1c476f0386e714252caf2b7eca883915422a64c50b88c6f5/kiwisolver-1.5.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:9eed0f7edbb274413b6ee781cca50541c8c0facd3d6fd289779e494340a2b85c", size = 122798, upload-time = "2026-03-09T13:12:58.963Z" },
+    { url = "https://files.pythonhosted.org/packages/11/60/37b4047a2af0cf5ef6d8b4b26e91829ae6fc6a2d1f74524bcb0e7cd28a32/kiwisolver-1.5.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3c4923e404d6bcd91b6779c009542e5647fef32e4a5d75e115e3bbac6f2335eb", size = 66216, upload-time = "2026-03-09T13:13:00.155Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/aa/510dc933d87767584abfe03efa445889996c70c2990f6f87c3ebaa0a18c5/kiwisolver-1.5.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:0df54df7e686afa55e6f21fb86195224a6d9beb71d637e8d7920c95cf0f89aac", size = 63911, upload-time = "2026-03-09T13:13:01.671Z" },
+    { url = "https://files.pythonhosted.org/packages/80/46/bddc13df6c2a40741e0cc7865bb1c9ed4796b6760bd04ce5fae3928ef917/kiwisolver-1.5.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2517e24d7315eb51c10664cdb865195df38ab74456c677df67bb47f12d088a27", size = 1438209, upload-time = "2026-03-09T13:13:03.385Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/d6/76621246f5165e5372f02f5e6f3f48ea336a8f9e96e43997d45b240ed8cd/kiwisolver-1.5.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff710414307fefa903e0d9bdf300972f892c23477829f49504e59834f4195398", size = 1248888, upload-time = "2026-03-09T13:13:05.231Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/c1/31559ec6fb39a5b48035ce29bb63ade628f321785f38c384dee3e2c08bc1/kiwisolver-1.5.0-cp311-cp311-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6176c1811d9d5a04fa391c490cc44f451e240697a16977f11c6f722efb9041db", size = 1266304, upload-time = "2026-03-09T13:13:06.743Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/ef/1cb8276f2d29cc6a41e0a042f27946ca347d3a4a75acf85d0a16aa6dcc82/kiwisolver-1.5.0-cp311-cp311-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:50847dca5d197fcbd389c805aa1a1cf32f25d2e7273dc47ab181a517666b68cc", size = 1319650, upload-time = "2026-03-09T13:13:08.607Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/e4/5ba3cecd7ce6236ae4a80f67e5d5531287337d0e1f076ca87a5abe4cd5d0/kiwisolver-1.5.0-cp311-cp311-manylinux_2_39_riscv64.whl", hash = "sha256:01808c6d15f4c3e8559595d6d1fe6411c68e4a3822b4b9972b44473b24f4e679", size = 970949, upload-time = "2026-03-09T13:13:10.299Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/69/dc61f7ae9a2f071f26004ced87f078235b5507ab6e5acd78f40365655034/kiwisolver-1.5.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:f1f9f4121ec58628c96baa3de1a55a4e3a333c5102c8e94b64e23bf7b2083309", size = 2199125, upload-time = "2026-03-09T13:13:11.841Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/7b/abbe0f1b5afa85f8d084b73e90e5f801c0939eba16ac2e49af7c61a6c28d/kiwisolver-1.5.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:b7d335370ae48a780c6e6a6bbfa97342f563744c39c35562f3f367665f5c1de2", size = 2293783, upload-time = "2026-03-09T13:13:14.399Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/80/5908ae149d96d81580d604c7f8aefd0e98f4fd728cf172f477e9f2a81744/kiwisolver-1.5.0-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:800ee55980c18545af444d93fdd60c56b580db5cc54867d8cbf8a1dc0829938c", size = 1960726, upload-time = "2026-03-09T13:13:16.047Z" },
+    { url = "https://files.pythonhosted.org/packages/84/08/a78cb776f8c085b7143142ce479859cfec086bd09ee638a317040b6ef420/kiwisolver-1.5.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:c438f6ca858697c9ab67eb28246c92508af972e114cac34e57a6d4ba17a3ac08", size = 2464738, upload-time = "2026-03-09T13:13:17.897Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/e1/65584da5356ed6cb12c63791a10b208860ac40a83de165cb6a6751a686e3/kiwisolver-1.5.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:8c63c91f95173f9c2a67c7c526b2cea976828a0e7fced9cdcead2802dc10f8a4", size = 2270718, upload-time = "2026-03-09T13:13:19.421Z" },
+    { url = "https://files.pythonhosted.org/packages/be/6c/28f17390b62b8f2f520e2915095b3c94d88681ecf0041e75389d9667f202/kiwisolver-1.5.0-cp311-cp311-win_amd64.whl", hash = "sha256:beb7f344487cdcb9e1efe4b7a29681b74d34c08f0043a327a74da852a6749e7b", size = 73480, upload-time = "2026-03-09T13:13:20.818Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/0e/2ee5debc4f77a625778fec5501ff3e8036fe361b7ee28ae402a485bb9694/kiwisolver-1.5.0-cp311-cp311-win_arm64.whl", hash = "sha256:ad4ae4ffd1ee9cd11357b4c66b612da9888f4f4daf2f36995eda64bd45370cac", size = 64930, upload-time = "2026-03-09T13:13:21.997Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/b2/818b74ebea34dabe6d0c51cb1c572e046730e64844da6ed646d5298c40ce/kiwisolver-1.5.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:4e9750bc21b886308024f8a54ccb9a2cc38ac9fa813bf4348434e3d54f337ff9", size = 123158, upload-time = "2026-03-09T13:13:23.127Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/d9/405320f8077e8e1c5c4bd6adc45e1e6edf6d727b6da7f2e2533cf58bff71/kiwisolver-1.5.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:72ec46b7eba5b395e0a7b63025490d3214c11013f4aacb4f5e8d6c3041829588", size = 66388, upload-time = "2026-03-09T13:13:24.765Z" },
+    { url = "https://files.pythonhosted.org/packages/99/9f/795fedf35634f746151ca8839d05681ceb6287fbed6cc1c9bf235f7887c2/kiwisolver-1.5.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ed3a984b31da7481b103f68776f7128a89ef26ed40f4dc41a2223cda7fb24819", size = 64068, upload-time = "2026-03-09T13:13:25.878Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/13/680c54afe3e65767bed7ec1a15571e1a2f1257128733851ade24abcefbcc/kiwisolver-1.5.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:bb5136fb5352d3f422df33f0c879a1b0c204004324150cc3b5e3c4f310c9049f", size = 1477934, upload-time = "2026-03-09T13:13:27.166Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/2f/cebfcdb60fd6a9b0f6b47a9337198bcbad6fbe15e68189b7011fd914911f/kiwisolver-1.5.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b2af221f268f5af85e776a73d62b0845fc8baf8ef0abfae79d29c77d0e776aaf", size = 1278537, upload-time = "2026-03-09T13:13:28.707Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/0d/9b782923aada3fafb1d6b84e13121954515c669b18af0c26e7d21f579855/kiwisolver-1.5.0-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b0f172dc8ffaccb8522d7c5d899de00133f2f1ca7b0a49b7da98e901de87bf2d", size = 1296685, upload-time = "2026-03-09T13:13:30.528Z" },
+    { url = "https://files.pythonhosted.org/packages/27/70/83241b6634b04fe44e892688d5208332bde130f38e610c0418f9ede47ded/kiwisolver-1.5.0-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6ab8ba9152203feec73758dad83af9a0bbe05001eb4639e547207c40cfb52083", size = 1346024, upload-time = "2026-03-09T13:13:32.818Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/db/30ed226fb271ae1a6431fc0fe0edffb2efe23cadb01e798caeb9f2ceae8f/kiwisolver-1.5.0-cp312-cp312-manylinux_2_39_riscv64.whl", hash = "sha256:cdee07c4d7f6d72008d3f73b9bf027f4e11550224c7c50d8df1ae4a37c1402a6", size = 987241, upload-time = "2026-03-09T13:13:34.435Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/bd/c314595208e4c9587652d50959ead9e461995389664e490f4dce7ff0f782/kiwisolver-1.5.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:7c60d3c9b06fb23bd9c6139281ccbdc384297579ae037f08ae90c69f6845c0b1", size = 2227742, upload-time = "2026-03-09T13:13:36.4Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/43/0499cec932d935229b5543d073c2b87c9c22846aab48881e9d8d6e742a2d/kiwisolver-1.5.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:e315e5ec90d88e140f57696ff85b484ff68bb311e36f2c414aa4286293e6dee0", size = 2323966, upload-time = "2026-03-09T13:13:38.204Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/6f/79b0d760907965acfd9d61826a3d41f8f093c538f55cd2633d3f0db269f6/kiwisolver-1.5.0-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:1465387ac63576c3e125e5337a6892b9e99e0627d52317f3ca79e6930d889d15", size = 1977417, upload-time = "2026-03-09T13:13:39.966Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/31/01d0537c41cb75a551a438c3c7a80d0c60d60b81f694dac83dd436aec0d0/kiwisolver-1.5.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:530a3fd64c87cffa844d4b6b9768774763d9caa299e9b75d8eca6a4423b31314", size = 2491238, upload-time = "2026-03-09T13:13:41.698Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/34/8aefdd0be9cfd00a44509251ba864f5caf2991e36772e61c408007e7f417/kiwisolver-1.5.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:1d9daea4ea6b9be74fe2f01f7fbade8d6ffab263e781274cffca0dba9be9eec9", size = 2294947, upload-time = "2026-03-09T13:13:43.343Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/cf/0348374369ca588f8fe9c338fae49fa4e16eeb10ffb3d012f23a54578a9e/kiwisolver-1.5.0-cp312-cp312-win_amd64.whl", hash = "sha256:f18c2d9782259a6dc132fdc7a63c168cbc74b35284b6d75c673958982a378384", size = 73569, upload-time = "2026-03-09T13:13:45.792Z" },
+    { url = "https://files.pythonhosted.org/packages/28/26/192b26196e2316e2bd29deef67e37cdf9870d9af8e085e521afff0fed526/kiwisolver-1.5.0-cp312-cp312-win_arm64.whl", hash = "sha256:f7c7553b13f69c1b29a5bde08ddc6d9d0c8bfb84f9ed01c30db25944aeb852a7", size = 64997, upload-time = "2026-03-09T13:13:46.878Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/69/024d6711d5ba575aa65d5538042e99964104e97fa153a9f10bc369182bc2/kiwisolver-1.5.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:fd40bb9cd0891c4c3cb1ddf83f8bbfa15731a248fdc8162669405451e2724b09", size = 123166, upload-time = "2026-03-09T13:13:48.032Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/48/adbb40df306f587054a348831220812b9b1d787aff714cfbc8556e38fccd/kiwisolver-1.5.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c0e1403fd7c26d77c1f03e096dc58a5c726503fa0db0456678b8668f76f521e3", size = 66395, upload-time = "2026-03-09T13:13:49.365Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/3a/d0a972b34e1c63e2409413104216cd1caa02c5a37cb668d1687d466c1c45/kiwisolver-1.5.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:dda366d548e89a90d88a86c692377d18d8bd64b39c1fb2b92cb31370e2896bbd", size = 64065, upload-time = "2026-03-09T13:13:50.562Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/0a/7b98e1e119878a27ba8618ca1e18b14f992ff1eda40f47bccccf4de44121/kiwisolver-1.5.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:332b4f0145c30b5f5ad9374881133e5aa64320428a57c2c2b61e9d891a51c2f3", size = 1477903, upload-time = "2026-03-09T13:13:52.084Z" },
+    { url = "https://files.pythonhosted.org/packages/18/d8/55638d89ffd27799d5cc3d8aa28e12f4ce7a64d67b285114dbedc8ea4136/kiwisolver-1.5.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0c50b89ffd3e1a911c69a1dd3de7173c0cd10b130f56222e57898683841e4f96", size = 1278751, upload-time = "2026-03-09T13:13:54.673Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/97/b4c8d0d18421ecceba20ad8701358453b88e32414e6f6950b5a4bad54e65/kiwisolver-1.5.0-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:4db576bb8c3ef9365f8b40fe0f671644de6736ae2c27a2c62d7d8a1b4329f099", size = 1296793, upload-time = "2026-03-09T13:13:56.287Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/10/f862f94b6389d8957448ec9df59450b81bec4abb318805375c401a1e6892/kiwisolver-1.5.0-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:0b85aad90cea8ac6797a53b5d5f2e967334fa4d1149f031c4537569972596cb8", size = 1346041, upload-time = "2026-03-09T13:13:58.269Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/6a/f1650af35821eaf09de398ec0bc2aefc8f211f0cda50204c9f1673741ba9/kiwisolver-1.5.0-cp313-cp313-manylinux_2_39_riscv64.whl", hash = "sha256:d36ca54cb4c6c4686f7cbb7b817f66f5911c12ddb519450bbe86707155028f87", size = 987292, upload-time = "2026-03-09T13:13:59.871Z" },
+    { url = "https://files.pythonhosted.org/packages/de/19/d7fb82984b9238115fe629c915007be608ebd23dc8629703d917dbfaffd4/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:38f4a703656f493b0ad185211ccfca7f0386120f022066b018eb5296d8613e23", size = 2227865, upload-time = "2026-03-09T13:14:01.401Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/b9/46b7f386589fd222dac9e9de9c956ce5bcefe2ee73b4e79891381dda8654/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:3ac2360e93cb41be81121755c6462cff3beaa9967188c866e5fce5cf13170859", size = 2324369, upload-time = "2026-03-09T13:14:02.972Z" },
+    { url = "https://files.pythonhosted.org/packages/92/8b/95e237cf3d9c642960153c769ddcbe278f182c8affb20cecc1cc983e7cc5/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c95cab08d1965db3d84a121f1c7ce7479bdd4072c9b3dafd8fecce48a2e6b902", size = 1977989, upload-time = "2026-03-09T13:14:04.503Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/95/980c9df53501892784997820136c01f62bc1865e31b82b9560f980c0e649/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:fc20894c3d21194d8041a28b65622d5b86db786da6e3cfe73f0c762951a61167", size = 2491645, upload-time = "2026-03-09T13:14:06.106Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/32/900647fd0840abebe1561792c6b31e6a7c0e278fc3973d30572a965ca14c/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:7a32f72973f0f950c1920475d5c5ea3d971b81b6f0ec53b8d0a956cc965f22e0", size = 2295237, upload-time = "2026-03-09T13:14:08.891Z" },
+    { url = "https://files.pythonhosted.org/packages/be/8a/be60e3bbcf513cc5a50f4a3e88e1dcecebb79c1ad607a7222877becaa101/kiwisolver-1.5.0-cp313-cp313-win_amd64.whl", hash = "sha256:0bf3acf1419fa93064a4c2189ac0b58e3be7872bf6ee6177b0d4c63dc4cea276", size = 73573, upload-time = "2026-03-09T13:14:12.327Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/d2/64be2e429eb4fca7f7e1c52a91b12663aeaf25de3895e5cca0f47ef2a8d0/kiwisolver-1.5.0-cp313-cp313-win_arm64.whl", hash = "sha256:fa8eb9ecdb7efb0b226acec134e0d709e87a909fa4971a54c0c4f6e88635484c", size = 64998, upload-time = "2026-03-09T13:14:13.469Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/69/ce68dd0c85755ae2de490bf015b62f2cea5f6b14ff00a463f9d0774449ff/kiwisolver-1.5.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:db485b3847d182b908b483b2ed133c66d88d49cacf98fd278fadafe11b4478d1", size = 125700, upload-time = "2026-03-09T13:14:14.636Z" },
+    { url = "https://files.pythonhosted.org/packages/74/aa/937aac021cf9d4349990d47eb319309a51355ed1dbdc9c077cdc9224cb11/kiwisolver-1.5.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:be12f931839a3bdfe28b584db0e640a65a8bcbc24560ae3fdb025a449b3d754e", size = 67537, upload-time = "2026-03-09T13:14:15.808Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/20/3a87fbece2c40ad0f6f0aefa93542559159c5f99831d596050e8afae7a9f/kiwisolver-1.5.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:16b85d37c2cbb3253226d26e64663f755d88a03439a9c47df6246b35defbdfb7", size = 65514, upload-time = "2026-03-09T13:14:18.035Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/7f/f943879cda9007c45e1f7dba216d705c3a18d6b35830e488b6c6a4e7cdf0/kiwisolver-1.5.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4432b835675f0ea7414aab3d37d119f7226d24869b7a829caeab49ebda407b0c", size = 1584848, upload-time = "2026-03-09T13:14:19.745Z" },
+    { url = "https://files.pythonhosted.org/packages/37/f8/4d4f85cc1870c127c88d950913370dd76138482161cd07eabbc450deff01/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b0feb50971481a2cc44d94e88bdb02cdd497618252ae226b8eb1201b957e368", size = 1391542, upload-time = "2026-03-09T13:14:21.54Z" },
+    { url = "https://files.pythonhosted.org/packages/04/0b/65dd2916c84d252b244bd405303220f729e7c17c9d7d33dca6feeff9ffc4/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:56fa888f10d0f367155e76ce849fa1166fc9730d13bd2d65a2aa13b6f5424489", size = 1404447, upload-time = "2026-03-09T13:14:23.205Z" },
+    { url = "https://files.pythonhosted.org/packages/39/5c/2606a373247babce9b1d056c03a04b65f3cf5290a8eac5d7bdead0a17e21/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:940dda65d5e764406b9fb92761cbf462e4e63f712ab60ed98f70552e496f3bf1", size = 1455918, upload-time = "2026-03-09T13:14:24.74Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/d1/c6078b5756670658e9192a2ef11e939c92918833d2745f85cd14a6004bdf/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_39_riscv64.whl", hash = "sha256:89fc958c702ee9a745e4700378f5d23fddbc46ff89e8fdbf5395c24d5c1452a3", size = 1072856, upload-time = "2026-03-09T13:14:26.597Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/c8/7def6ddf16eb2b3741d8b172bdaa9af882b03c78e9b0772975408801fa63/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9027d773c4ff81487181a925945743413f6069634d0b122d0b37684ccf4f1e18", size = 2333580, upload-time = "2026-03-09T13:14:28.237Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/87/2ac1fce0eb1e616fcd3c35caa23e665e9b1948bb984f4764790924594128/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:5b233ea3e165e43e35dba1d2b8ecc21cf070b45b65ae17dd2747d2713d942021", size = 2423018, upload-time = "2026-03-09T13:14:30.018Z" },
+    { url = "https://files.pythonhosted.org/packages/67/13/c6700ccc6cc218716bfcda4935e4b2997039869b4ad8a94f364c5a3b8e63/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:ce9bf03dad3b46408c08649c6fbd6ca28a9fce0eb32fdfffa6775a13103b5310", size = 2062804, upload-time = "2026-03-09T13:14:32.888Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/bd/877056304626943ff0f1f44c08f584300c199b887cb3176cd7e34f1515f1/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:fc4d3f1fb9ca0ae9f97b095963bc6326f1dbfd3779d6679a1e016b9baaa153d3", size = 2597482, upload-time = "2026-03-09T13:14:34.971Z" },
+    { url = "https://files.pythonhosted.org/packages/75/19/c60626c47bf0f8ac5dcf72c6c98e266d714f2fbbfd50cf6dab5ede3aaa50/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:f443b4825c50a51ee68585522ab4a1d1257fac65896f282b4c6763337ac9f5d2", size = 2394328, upload-time = "2026-03-09T13:14:36.816Z" },
+    { url = "https://files.pythonhosted.org/packages/47/84/6a6d5e5bb8273756c27b7d810d47f7ef2f1f9b9fd23c9ee9a3f8c75c9cef/kiwisolver-1.5.0-cp313-cp313t-win_arm64.whl", hash = "sha256:893ff3a711d1b515ba9da14ee090519bad4610ed1962fbe298a434e8c5f8db53", size = 68410, upload-time = "2026-03-09T13:14:38.695Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/d7/060f45052f2a01ad5762c8fdecd6d7a752b43400dc29ff75cd47225a40fd/kiwisolver-1.5.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8df31fe574b8b3993cc61764f40941111b25c2d9fea13d3ce24a49907cd2d615", size = 123231, upload-time = "2026-03-09T13:14:41.323Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/a7/78da680eadd06ff35edef6ef68a1ad273bad3e2a0936c9a885103230aece/kiwisolver-1.5.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:1d49a49ac4cbfb7c1375301cd1ec90169dfeae55ff84710d782260ce77a75a02", size = 66489, upload-time = "2026-03-09T13:14:42.534Z" },
+    { url = "https://files.pythonhosted.org/packages/49/b2/97980f3ad4fae37dd7fe31626e2bf75fbf8bdf5d303950ec1fab39a12da8/kiwisolver-1.5.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0cbe94b69b819209a62cb27bdfa5dc2a8977d8de2f89dfd97ba4f53ed3af754e", size = 64063, upload-time = "2026-03-09T13:14:44.759Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/f9/b06c934a6aa8bc91f566bd2a214fd04c30506c2d9e2b6b171953216a65b6/kiwisolver-1.5.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:80aa065ffd378ff784822a6d7c3212f2d5f5e9c3589614b5c228b311fd3063ac", size = 1475913, upload-time = "2026-03-09T13:14:46.247Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/f0/f768ae564a710135630672981231320bc403cf9152b5596ec5289de0f106/kiwisolver-1.5.0-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e7f886f47ab881692f278ae901039a234e4025a68e6dfab514263a0b1c4ae05", size = 1282782, upload-time = "2026-03-09T13:14:48.458Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/9f/1de7aad00697325f05238a5f2eafbd487fb637cc27a558b5367a5f37fb7f/kiwisolver-1.5.0-cp314-cp314-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5060731cc3ed12ca3a8b57acd4aeca5bbc2f49216dd0bec1650a1acd89486bcd", size = 1300815, upload-time = "2026-03-09T13:14:50.721Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/c2/297f25141d2e468e0ce7f7a7b92e0cf8918143a0cbd3422c1ad627e85a06/kiwisolver-1.5.0-cp314-cp314-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:7a4aa69609f40fce3cbc3f87b2061f042eee32f94b8f11db707b66a26461591a", size = 1347925, upload-time = "2026-03-09T13:14:52.304Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/d3/f4c73a02eb41520c47610207b21afa8cdd18fdbf64ffd94674ae21c4812d/kiwisolver-1.5.0-cp314-cp314-manylinux_2_39_riscv64.whl", hash = "sha256:d168fda2dbff7b9b5f38e693182d792a938c31db4dac3a80a4888de603c99554", size = 991322, upload-time = "2026-03-09T13:14:54.637Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/46/d3f2efef7732fcda98d22bf4ad5d3d71d545167a852ca710a494f4c15343/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:413b820229730d358efd838ecbab79902fe97094565fdc80ddb6b0a18c18a581", size = 2232857, upload-time = "2026-03-09T13:14:56.471Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/ec/2d9756bf2b6d26ae4349b8d3662fb3993f16d80c1f971c179ce862b9dbae/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:5124d1ea754509b09e53738ec185584cc609aae4a3b510aaf4ed6aa047ef9303", size = 2329376, upload-time = "2026-03-09T13:14:58.072Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/9f/876a0a0f2260f1bde92e002b3019a5fabc35e0939c7d945e0fa66185eb20/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e4415a8db000bf49a6dd1c478bf70062eaacff0f462b92b0ba68791a905861f9", size = 1982549, upload-time = "2026-03-09T13:14:59.668Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/4f/ba3624dfac23a64d54ac4179832860cb537c1b0af06024936e82ca4154a0/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:d618fd27420381a4f6044faa71f46d8bfd911bd077c555f7138ed88729bfbe79", size = 2494680, upload-time = "2026-03-09T13:15:01.364Z" },
+    { url = "https://files.pythonhosted.org/packages/39/b7/97716b190ab98911b20d10bf92eca469121ec483b8ce0edd314f51bc85af/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5092eb5b1172947f57d6ea7d89b2f29650414e4293c47707eb499ec07a0ac796", size = 2297905, upload-time = "2026-03-09T13:15:03.925Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/36/4e551e8aa55c9188bca9abb5096805edbf7431072b76e2298e34fd3a3008/kiwisolver-1.5.0-cp314-cp314-win_amd64.whl", hash = "sha256:d76e2d8c75051d58177e762164d2e9ab92886534e3a12e795f103524f221dd8e", size = 75086, upload-time = "2026-03-09T13:15:07.775Z" },
+    { url = "https://files.pythonhosted.org/packages/70/15/9b90f7df0e31a003c71649cf66ef61c3c1b862f48c81007fa2383c8bd8d7/kiwisolver-1.5.0-cp314-cp314-win_arm64.whl", hash = "sha256:fa6248cd194edff41d7ea9425ced8ca3a6f838bfb295f6f1d6e6bb694a8518df", size = 66577, upload-time = "2026-03-09T13:15:09.139Z" },
+    { url = "https://files.pythonhosted.org/packages/17/01/7dc8c5443ff42b38e72731643ed7cf1ed9bf01691ae5cdca98501999ed83/kiwisolver-1.5.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:d1ffeb80b5676463d7a7d56acbe8e37a20ce725570e09549fe738e02ca6b7e1e", size = 125794, upload-time = "2026-03-09T13:15:10.525Z" },
+    { url = "https://files.pythonhosted.org/packages/46/8a/b4ebe46ebaac6a303417fab10c2e165c557ddaff558f9699d302b256bc53/kiwisolver-1.5.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:bc4d8e252f532ab46a1de9349e2d27b91fce46736a9eedaa37beaca66f574ed4", size = 67646, upload-time = "2026-03-09T13:15:12.016Z" },
+    { url = "https://files.pythonhosted.org/packages/60/35/10a844afc5f19d6f567359bf4789e26661755a2f36200d5d1ed8ad0126e5/kiwisolver-1.5.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:6783e069732715ad0c3ce96dbf21dbc2235ab0593f2baf6338101f70371f4028", size = 65511, upload-time = "2026-03-09T13:15:13.311Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/8a/685b297052dd041dcebce8e8787b58923b6e78acc6115a0dc9189011c44b/kiwisolver-1.5.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:e7c4c09a490dc4d4a7f8cbee56c606a320f9dc28cf92a7157a39d1ce7676a657", size = 1584858, upload-time = "2026-03-09T13:15:15.103Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/80/04865e3d4638ac5bddec28908916df4a3075b8c6cc101786a96803188b96/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2a075bd7bd19c70cf67c8badfa36cf7c5d8de3c9ddb8420c51e10d9c50e94920", size = 1392539, upload-time = "2026-03-09T13:15:16.661Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/01/77a19cacc0893fa13fafa46d1bba06fb4dc2360b3292baf4b56d8e067b24/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:bdd3e53429ff02aa319ba59dfe4ceeec345bf46cf180ec2cf6fd5b942e7975e9", size = 1405310, upload-time = "2026-03-09T13:15:18.229Z" },
+    { url = "https://files.pythonhosted.org/packages/53/39/bcaf5d0cca50e604cfa9b4e3ae1d64b50ca1ae5b754122396084599ef903/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:3cdcb35dc9d807259c981a85531048ede628eabcffb3239adf3d17463518992d", size = 1456244, upload-time = "2026-03-09T13:15:20.444Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/7a/72c187abc6975f6978c3e39b7cf67aeb8b3c0a8f9790aa7fd412855e9e1f/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_39_riscv64.whl", hash = "sha256:70d593af6a6ca332d1df73d519fddb5148edb15cd90d5f0155e3746a6d4fcc65", size = 1073154, upload-time = "2026-03-09T13:15:22.039Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/ca/cf5b25783ebbd59143b4371ed0c8428a278abe68d6d0104b01865b1bbd0f/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:377815a8616074cabbf3f53354e1d040c35815a134e01d7614b7692e4bf8acfa", size = 2334377, upload-time = "2026-03-09T13:15:23.741Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/e5/b1f492adc516796e88751282276745340e2a72dcd0d36cf7173e0daf3210/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:0255a027391d52944eae1dbb5d4cc5903f57092f3674e8e544cdd2622826b3f0", size = 2425288, upload-time = "2026-03-09T13:15:25.789Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/e5/9b21fbe91a61b8f409d74a26498706e97a48008bfcd1864373d32a6ba31c/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:012b1eb16e28718fa782b5e61dc6f2da1f0792ca73bd05d54de6cb9561665fc9", size = 2063158, upload-time = "2026-03-09T13:15:27.63Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/02/83f47986138310f95ea95531f851b2a62227c11cbc3e690ae1374fe49f0f/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:0e3aafb33aed7479377e5e9a82e9d4bf87063741fc99fc7ae48b0f16e32bdd6f", size = 2597260, upload-time = "2026-03-09T13:15:29.421Z" },
+    { url = "https://files.pythonhosted.org/packages/07/18/43a5f24608d8c313dd189cf838c8e68d75b115567c6279de7796197cfb6a/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:e7a116ae737f0000343218c4edf5bd45893bfeaff0993c0b215d7124c9f77646", size = 2394403, upload-time = "2026-03-09T13:15:31.517Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/b5/98222136d839b8afabcaa943b09bd05888c2d36355b7e448550211d1fca4/kiwisolver-1.5.0-cp314-cp314t-win_amd64.whl", hash = "sha256:1dd9b0b119a350976a6d781e7278ec7aca0b201e1a9e2d23d9804afecb6ca681", size = 79687, upload-time = "2026-03-09T13:15:33.204Z" },
+    { url = "https://files.pythonhosted.org/packages/99/a2/ca7dc962848040befed12732dff6acae7fb3c4f6fc4272b3f6c9a30b8713/kiwisolver-1.5.0-cp314-cp314t-win_arm64.whl", hash = "sha256:58f812017cd2985c21fbffb4864d59174d4903dd66fa23815e74bbc7a0e2dd57", size = 70032, upload-time = "2026-03-09T13:15:34.411Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/fa/2910df836372d8761bb6eff7d8bdcb1613b5c2e03f260efe7abe34d388a7/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-macosx_10_13_x86_64.whl", hash = "sha256:5ae8e62c147495b01a0f4765c878e9bfdf843412446a247e28df59936e99e797", size = 130262, upload-time = "2026-03-09T13:15:35.629Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/41/c5f71f9f00aabcc71fee8b7475e3f64747282580c2fe748961ba29b18385/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:f6764a4ccab3078db14a632420930f6186058750df066b8ea2a7106df91d3203", size = 138036, upload-time = "2026-03-09T13:15:36.894Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/06/7399a607f434119c6e1fdc8ec89a8d51ccccadf3341dee4ead6bd14caaf5/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c31c13da98624f957b0fb1b5bae5383b2333c2c3f6793d9825dd5ce79b525cb7", size = 194295, upload-time = "2026-03-09T13:15:38.22Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/91/53255615acd2a1eaca307ede3c90eb550bae9c94581f8c00081b6b1c8f44/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-win_amd64.whl", hash = "sha256:1f1489f769582498610e015a8ef2d36f28f505ab3096d0e16b4858a9ec214f57", size = 75987, upload-time = "2026-03-09T13:15:39.65Z" },
+    { url = "https://files.pythonhosted.org/packages/17/6f/6fd4f690a40c2582fa34b97d2678f718acf3706b91d270c65ecb455d0a06/kiwisolver-1.5.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:295d9ffe712caa9f8a3081de8d32fc60191b4b51c76f02f951fd8407253528f4", size = 59606, upload-time = "2026-03-09T13:15:40.81Z" },
+    { url = "https://files.pythonhosted.org/packages/82/a0/2355d5e3b338f13ce63f361abb181e3b6ea5fffdb73f739b3e80efa76159/kiwisolver-1.5.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:51e8c4084897de9f05898c2c2a39af6318044ae969d46ff7a34ed3f96274adca", size = 57537, upload-time = "2026-03-09T13:15:42.071Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/b9/1d50e610ecadebe205b71d6728fd224ce0e0ca6aba7b9cbe1da049203ac5/kiwisolver-1.5.0-pp310-pypy310_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:b83af57bdddef03c01a9138034c6ff03181a3028d9a1003b301eb1a55e161a3f", size = 79888, upload-time = "2026-03-09T13:15:43.317Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/ee/b85ffcd75afed0357d74f0e6fc02a4507da441165de1ca4760b9f496390d/kiwisolver-1.5.0-pp310-pypy310_pp73-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bf4679a3d71012a7c2bf360e5cd878fbd5e4fcac0896b56393dec239d81529ed", size = 77584, upload-time = "2026-03-09T13:15:44.605Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/dd/644d0dde6010a8583b4cd66dd41c5f83f5325464d15c4f490b3340ab73b4/kiwisolver-1.5.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:41024ed50e44ab1a60d3fe0a9d15a4ccc9f5f2b1d814ff283c8d01134d5b81bc", size = 73390, upload-time = "2026-03-09T13:15:45.832Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/eb/5fcbbbf9a0e2c3a35effb88831a483345326bbc3a030a3b5b69aee647f84/kiwisolver-1.5.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:ec4c85dc4b687c7f7f15f553ff26a98bfe8c58f5f7f0ac8905f0ba4c7be60232", size = 59532, upload-time = "2026-03-09T13:15:47.047Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/9b/e17104555bb4db148fd52327feea1e96be4b88e8e008b029002c281a21ab/kiwisolver-1.5.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:12e91c215a96e39f57989c8912ae761286ac5a9584d04030ceb3368a357f017a", size = 57420, upload-time = "2026-03-09T13:15:48.199Z" },
+    { url = "https://files.pythonhosted.org/packages/48/44/2b5b95b7aa39fb2d8d9d956e0f3d5d45aef2ae1d942d4c3ffac2f9cfed1a/kiwisolver-1.5.0-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:be4a51a55833dc29ab5d7503e7bcb3b3af3402d266018137127450005cdfe737", size = 79892, upload-time = "2026-03-09T13:15:49.694Z" },
+    { url = "https://files.pythonhosted.org/packages/52/7d/7157f9bba6b455cfb4632ed411e199fc8b8977642c2b12082e1bd9e6d173/kiwisolver-1.5.0-pp311-pypy311_pp73-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:daae526907e262de627d8f70058a0f64acc9e2641c164c99c8f594b34a799a16", size = 77603, upload-time = "2026-03-09T13:15:50.945Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/dd/8050c947d435c8d4bc94e3252f4d8bb8a76cfb424f043a8680be637a57f1/kiwisolver-1.5.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:59cd8683f575d96df5bb48f6add94afc055012c29e28124fcae2b63661b9efb1", size = 73558, upload-time = "2026-03-09T13:15:52.112Z" },
+]
+
+[[package]]
+name = "lazy-loader"
+version = "0.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "packaging" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/49/ac/21a1f8aa3777f5658576777ea76bfb124b702c520bbe90edf4ae9915eafa/lazy_loader-0.5.tar.gz", hash = "sha256:717f9179a0dbed357012ddad50a5ad3d5e4d9a0b8712680d4e687f5e6e6ed9b3", size = 15294, upload-time = "2026-03-06T15:45:09.054Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/a1/8d812e53a5da1687abb10445275d41a8b13adb781bbf7196ddbcf8d88505/lazy_loader-0.5-py3-none-any.whl", hash = "sha256:ab0ea149e9c554d4ffeeb21105ac60bed7f3b4fd69b1d2360a4add51b170b005", size = 8044, upload-time = "2026-03-06T15:45:07.668Z" },
+]
+
+[[package]]
+name = "markupsafe"
+version = "3.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313, upload-time = "2025-09-27T18:37:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e8/4b/3541d44f3937ba468b75da9eebcae497dcf67adb65caa16760b0a6807ebb/markupsafe-3.0.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2f981d352f04553a7171b8e44369f2af4055f888dfb147d55e42d29e29e74559", size = 11631, upload-time = "2025-09-27T18:36:05.558Z" },
+    { url = "https://files.pythonhosted.org/packages/98/1b/fbd8eed11021cabd9226c37342fa6ca4e8a98d8188a8d9b66740494960e4/markupsafe-3.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e1c1493fb6e50ab01d20a22826e57520f1284df32f2d8601fdd90b6304601419", size = 12057, upload-time = "2025-09-27T18:36:07.165Z" },
+    { url = "https://files.pythonhosted.org/packages/40/01/e560d658dc0bb8ab762670ece35281dec7b6c1b33f5fbc09ebb57a185519/markupsafe-3.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ba88449deb3de88bd40044603fafffb7bc2b055d626a330323a9ed736661695", size = 22050, upload-time = "2025-09-27T18:36:08.005Z" },
+    { url = "https://files.pythonhosted.org/packages/af/cd/ce6e848bbf2c32314c9b237839119c5a564a59725b53157c856e90937b7a/markupsafe-3.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f42d0984e947b8adf7dd6dde396e720934d12c506ce84eea8476409563607591", size = 20681, upload-time = "2025-09-27T18:36:08.881Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/2a/b5c12c809f1c3045c4d580b035a743d12fcde53cf685dbc44660826308da/markupsafe-3.0.3-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c0c0b3ade1c0b13b936d7970b1d37a57acde9199dc2aecc4c336773e1d86049c", size = 20705, upload-time = "2025-09-27T18:36:10.131Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/e3/9427a68c82728d0a88c50f890d0fc072a1484de2f3ac1ad0bfc1a7214fd5/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0303439a41979d9e74d18ff5e2dd8c43ed6c6001fd40e5bf2e43f7bd9bbc523f", size = 21524, upload-time = "2025-09-27T18:36:11.324Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/36/23578f29e9e582a4d0278e009b38081dbe363c5e7165113fad546918a232/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:d2ee202e79d8ed691ceebae8e0486bd9a2cd4794cec4824e1c99b6f5009502f6", size = 20282, upload-time = "2025-09-27T18:36:12.573Z" },
+    { url = "https://files.pythonhosted.org/packages/56/21/dca11354e756ebd03e036bd8ad58d6d7168c80ce1fe5e75218e4945cbab7/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:177b5253b2834fe3678cb4a5f0059808258584c559193998be2601324fdeafb1", size = 20745, upload-time = "2025-09-27T18:36:13.504Z" },
+    { url = "https://files.pythonhosted.org/packages/87/99/faba9369a7ad6e4d10b6a5fbf71fa2a188fe4a593b15f0963b73859a1bbd/markupsafe-3.0.3-cp310-cp310-win32.whl", hash = "sha256:2a15a08b17dd94c53a1da0438822d70ebcd13f8c3a95abe3a9ef9f11a94830aa", size = 14571, upload-time = "2025-09-27T18:36:14.779Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/25/55dc3ab959917602c96985cb1253efaa4ff42f71194bddeb61eb7278b8be/markupsafe-3.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:c4ffb7ebf07cfe8931028e3e4c85f0357459a3f9f9490886198848f4fa002ec8", size = 15056, upload-time = "2025-09-27T18:36:16.125Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/9e/0a02226640c255d1da0b8d12e24ac2aa6734da68bff14c05dd53b94a0fc3/markupsafe-3.0.3-cp310-cp310-win_arm64.whl", hash = "sha256:e2103a929dfa2fcaf9bb4e7c091983a49c9ac3b19c9061b6d5427dd7d14d81a1", size = 13932, upload-time = "2025-09-27T18:36:17.311Z" },
+    { url = "https://files.pythonhosted.org/packages/08/db/fefacb2136439fc8dd20e797950e749aa1f4997ed584c62cfb8ef7c2be0e/markupsafe-3.0.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad", size = 11631, upload-time = "2025-09-27T18:36:18.185Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/2e/5898933336b61975ce9dc04decbc0a7f2fee78c30353c5efba7f2d6ff27a/markupsafe-3.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a", size = 12058, upload-time = "2025-09-27T18:36:19.444Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/09/adf2df3699d87d1d8184038df46a9c80d78c0148492323f4693df54e17bb/markupsafe-3.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50", size = 24287, upload-time = "2025-09-27T18:36:20.768Z" },
+    { url = "https://files.pythonhosted.org/packages/30/ac/0273f6fcb5f42e314c6d8cd99effae6a5354604d461b8d392b5ec9530a54/markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf", size = 22940, upload-time = "2025-09-27T18:36:22.249Z" },
+    { url = "https://files.pythonhosted.org/packages/19/ae/31c1be199ef767124c042c6c3e904da327a2f7f0cd63a0337e1eca2967a8/markupsafe-3.0.3-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f", size = 21887, upload-time = "2025-09-27T18:36:23.535Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/76/7edcab99d5349a4532a459e1fe64f0b0467a3365056ae550d3bcf3f79e1e/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a", size = 23692, upload-time = "2025-09-27T18:36:24.823Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/28/6e74cdd26d7514849143d69f0bf2399f929c37dc2b31e6829fd2045b2765/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115", size = 21471, upload-time = "2025-09-27T18:36:25.95Z" },
+    { url = "https://files.pythonhosted.org/packages/62/7e/a145f36a5c2945673e590850a6f8014318d5577ed7e5920a4b3448e0865d/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a", size = 22923, upload-time = "2025-09-27T18:36:27.109Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/62/d9c46a7f5c9adbeeeda52f5b8d802e1094e9717705a645efc71b0913a0a8/markupsafe-3.0.3-cp311-cp311-win32.whl", hash = "sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19", size = 14572, upload-time = "2025-09-27T18:36:28.045Z" },
+    { url = "https://files.pythonhosted.org/packages/83/8a/4414c03d3f891739326e1783338e48fb49781cc915b2e0ee052aa490d586/markupsafe-3.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01", size = 15077, upload-time = "2025-09-27T18:36:29.025Z" },
+    { url = "https://files.pythonhosted.org/packages/35/73/893072b42e6862f319b5207adc9ae06070f095b358655f077f69a35601f0/markupsafe-3.0.3-cp311-cp311-win_arm64.whl", hash = "sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c", size = 13876, upload-time = "2025-09-27T18:36:29.954Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/72/147da192e38635ada20e0a2e1a51cf8823d2119ce8883f7053879c2199b5/markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e", size = 11615, upload-time = "2025-09-27T18:36:30.854Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/81/7e4e08678a1f98521201c3079f77db69fb552acd56067661f8c2f534a718/markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce", size = 12020, upload-time = "2025-09-27T18:36:31.971Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/2c/799f4742efc39633a1b54a92eec4082e4f815314869865d876824c257c1e/markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d", size = 24332, upload-time = "2025-09-27T18:36:32.813Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/2e/8d0c2ab90a8c1d9a24f0399058ab8519a3279d1bd4289511d74e909f060e/markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d", size = 22947, upload-time = "2025-09-27T18:36:33.86Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/54/887f3092a85238093a0b2154bd629c89444f395618842e8b0c41783898ea/markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a", size = 21962, upload-time = "2025-09-27T18:36:35.099Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/2f/336b8c7b6f4a4d95e91119dc8521402461b74a485558d8f238a68312f11c/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b", size = 23760, upload-time = "2025-09-27T18:36:36.001Z" },
+    { url = "https://files.pythonhosted.org/packages/32/43/67935f2b7e4982ffb50a4d169b724d74b62a3964bc1a9a527f5ac4f1ee2b/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f", size = 21529, upload-time = "2025-09-27T18:36:36.906Z" },
+    { url = "https://files.pythonhosted.org/packages/89/e0/4486f11e51bbba8b0c041098859e869e304d1c261e59244baa3d295d47b7/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b", size = 23015, upload-time = "2025-09-27T18:36:37.868Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540, upload-time = "2025-09-27T18:36:38.761Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105, upload-time = "2025-09-27T18:36:39.701Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906, upload-time = "2025-09-27T18:36:40.689Z" },
+    { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" },
+    { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" },
+    { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" },
+    { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" },
+    { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" },
+    { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" },
+    { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" },
+    { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" },
+    { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" },
+    { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619, upload-time = "2025-09-27T18:37:06.342Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029, upload-time = "2025-09-27T18:37:07.213Z" },
+    { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408, upload-time = "2025-09-27T18:37:09.572Z" },
+    { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005, upload-time = "2025-09-27T18:37:10.58Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048, upload-time = "2025-09-27T18:37:11.547Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821, upload-time = "2025-09-27T18:37:12.48Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606, upload-time = "2025-09-27T18:37:13.485Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043, upload-time = "2025-09-27T18:37:14.408Z" },
+    { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747, upload-time = "2025-09-27T18:37:15.36Z" },
+    { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341, upload-time = "2025-09-27T18:37:16.496Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073, upload-time = "2025-09-27T18:37:17.476Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661, upload-time = "2025-09-27T18:37:18.453Z" },
+    { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069, upload-time = "2025-09-27T18:37:19.332Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670, upload-time = "2025-09-27T18:37:20.245Z" },
+    { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598, upload-time = "2025-09-27T18:37:21.177Z" },
+    { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261, upload-time = "2025-09-27T18:37:22.167Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835, upload-time = "2025-09-27T18:37:23.296Z" },
+    { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733, upload-time = "2025-09-27T18:37:24.237Z" },
+    { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672, upload-time = "2025-09-27T18:37:25.271Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819, upload-time = "2025-09-27T18:37:26.285Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426, upload-time = "2025-09-27T18:37:27.316Z" },
+    { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146, upload-time = "2025-09-27T18:37:28.327Z" },
+]
+
+[[package]]
+name = "matplotlib"
+version = "3.10.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "contourpy", version = "1.3.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "contourpy", version = "1.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "cycler" },
+    { name = "fonttools" },
+    { name = "kiwisolver" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "packaging" },
+    { name = "pillow" },
+    { name = "pyparsing" },
+    { name = "python-dateutil" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/63/1b/4be5be87d43d327a0cf4de1a56e86f7f84c89312452406cf122efe2839e6/matplotlib-3.10.9.tar.gz", hash = "sha256:fd66508e8c6877d98e586654b608a0456db8d7e8a546eb1e2600efd957302358", size = 34811233, upload-time = "2026-04-24T00:14:13.539Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/6f/340b04986e67aac6f66c5145ce68bf72c64bed30f92c8913499a6e6b8f99/matplotlib-3.10.9-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:77210dce9cb8153dffc967efaae990543392563d5a376d4dd8539bebcb0ed217", size = 8296625, upload-time = "2026-04-24T00:11:43.376Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/2f/127081eb83162053ebb9678ceac64220b93a663e0167432566e9c7c82aab/matplotlib-3.10.9-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:1e7698ac9868428e84d2c967424803b2472ff7167d9d6590d4204ed775343c3b", size = 8188790, upload-time = "2026-04-24T00:11:46.556Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/b7/d8bcec2626c35f96972bff656299fef4578113ea6193c8fdad324710410c/matplotlib-3.10.9-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:1aa972116abb4c9d201bf245620b433726cb6856f3bef6a78f776a00f5c92d37", size = 8769389, upload-time = "2026-04-24T00:11:48.959Z" },
+    { url = "https://files.pythonhosted.org/packages/12/49/b78e214a527ea732033b7f4d37f7afb504d74ba9d134bd47938230dfb8b1/matplotlib-3.10.9-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ae2f11957b27ce53497dd4d7b235c4d4f1faf383dfb39d0c5beb833bff883294", size = 9589657, upload-time = "2026-04-24T00:11:51.915Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/15/5246f7b43beae19c74dfee651d58d6cc8112e06f77adb4e88cc04f2e3a23/matplotlib-3.10.9-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:b049278ddce116aaa1c1377ebf58adea909132dfce0281cf7e3a1ea9fc2e2c65", size = 9651983, upload-time = "2026-04-24T00:11:54.766Z" },
+    { url = "https://files.pythonhosted.org/packages/75/77/5acecfe672ba0fa1b8c0454f69ce155d1e6fc5852fa7206bf9afaf767121/matplotlib-3.10.9-cp310-cp310-win_amd64.whl", hash = "sha256:82834c3c292d24d3a8aae77cd2d20019de69d692a34a970e4fdb8d33e2ea3dda", size = 8199701, upload-time = "2026-04-24T00:11:58.389Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/8c/290f021104741fea63769c31494f5324c0cd249bf536a65a4350767b1f22/matplotlib-3.10.9-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:68cfdcede415f7c8f5577b03303dd94526cdb6d11036cecdc205e08733b2d2bb", size = 8306860, upload-time = "2026-04-24T00:12:01.207Z" },
+    { url = "https://files.pythonhosted.org/packages/51/18/325cd32ece1120d1da51cc4e4294c6580190699490183fc2fe8cb6d61ec5/matplotlib-3.10.9-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dfca0129678bd56379db26c52b5d77ed7de314c047492fbdc763aa7501710cfb", size = 8199254, upload-time = "2026-04-24T00:12:04.239Z" },
+    { url = "https://files.pythonhosted.org/packages/79/db/e28c1b83e3680740aa78925f5fb2ae4d16207207419ad75ea9fe604f8676/matplotlib-3.10.9-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8e436d155fa8a3399dc62683f8f5d0e2e50d25d0144a73edd73f82eec8f4abfb", size = 8777092, upload-time = "2026-04-24T00:12:06.793Z" },
+    { url = "https://files.pythonhosted.org/packages/55/fa/3ce7adfe9ba101748f465211660d9c6374c876b671bdb8c2bb6d347e8b94/matplotlib-3.10.9-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:56fc0bd271b00025c6edfdc7c2dcd247372c8e1544971d62e1dc7c17367e8bf9", size = 9595691, upload-time = "2026-04-24T00:12:09.706Z" },
+    { url = "https://files.pythonhosted.org/packages/36/c4/6960a76686ed668f2c60f84e9799ba4c0d56abdb36b1577b60c1d061d1ec/matplotlib-3.10.9-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:a5a6104ed666402ba5106d7f36e0e0cdca4e8d7fa4d39708ca88019e2835a2eb", size = 9659771, upload-time = "2026-04-24T00:12:12.766Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/0d/271aace3342157c64700c9ff4c59c7b392f3dbab393692e8db6fbe7ab96c/matplotlib-3.10.9-cp311-cp311-win_amd64.whl", hash = "sha256:d730e984eddf56974c3e72b6129c7ca462ac38dc624338f4b0b23eb23ecba00f", size = 8205112, upload-time = "2026-04-24T00:12:15.773Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/ee/cb57ad4754f3e7b9174ce6ce66d9205fb827067e48a9f58ac09d7e7d6b77/matplotlib-3.10.9-cp311-cp311-win_arm64.whl", hash = "sha256:51bf0ddbdc598e060d46c16b5590708f81a1624cefbaaf62f6a81bf9285b8c80", size = 8132310, upload-time = "2026-04-24T00:12:18.645Z" },
+    { url = "https://files.pythonhosted.org/packages/35/c6/5581e26c72233ebb2a2a6fed2d24fb7c66b4700120b813f51b0555acf0b6/matplotlib-3.10.9-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:f0c3c28d9fbcc1fe7a03be236d73430cf6409c41fb2383a7ac52fe932b072cb1", size = 8319908, upload-time = "2026-04-24T00:12:21.323Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/18/4880dd762e40cd360c1bf06e890c5a97b997e91cb324602b1a19950ad5ce/matplotlib-3.10.9-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:41cb28c2bd769aa3e98322c6ab09854cbcc52ab69d2759d681bba3e327b2b320", size = 8216016, upload-time = "2026-04-24T00:12:23.4Z" },
+    { url = "https://files.pythonhosted.org/packages/32/91/d024616abdba99e83120e07a20658976f6a343646710760c4a51df126029/matplotlib-3.10.9-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ae20801130378b82d647ff5047c07316295b68dc054ca6b3c13519d0ea624285", size = 8789336, upload-time = "2026-04-24T00:12:26.096Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/04/030a2f61ef2158f5e4c259487a92ac877732499fb33d871585d89e03c42d/matplotlib-3.10.9-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6c63ebcd8b4b169eb2f5c200552ae6b8be8999a005b6b507ed76fb8d7d674fe2", size = 9604602, upload-time = "2026-04-24T00:12:29.052Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/c2/541e4d09d87bb6b5830fc28b4c887a9a8cf4e1c6cee698a8c05552ae2003/matplotlib-3.10.9-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:d75d11c949914165976c621b2324f9ef162af7ebf4b057ddf95dd1dba7e5edcf", size = 9670966, upload-time = "2026-04-24T00:12:32.131Z" },
+    { url = "https://files.pythonhosted.org/packages/04/a1/4571fc46e7702de8d0c2dc54ad1b2f8e29328dea3ee90831181f7353d93c/matplotlib-3.10.9-cp312-cp312-win_amd64.whl", hash = "sha256:d091f9d758b34aaaaa6331d13574bf01891d903b3dec59bfff458ef7551de5d6", size = 8217462, upload-time = "2026-04-24T00:12:35.226Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/d0/2269edb12aa30c13c8bcc9382892e39943ce1d28aab4ec296e0381798e81/matplotlib-3.10.9-cp312-cp312-win_arm64.whl", hash = "sha256:10cc5ce06d10231c36f40e875f3c7e8050362a4ee8f0ee5d29a6b3277d57bb42", size = 8136688, upload-time = "2026-04-24T00:12:37.442Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/d3/8d4f6afbecb49fc04e060a57c0fce39ea51cc163a6bd87303ccd698e4fa6/matplotlib-3.10.9-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:b580440f1ff81a0e34122051a3dfabb7e4b7f9e380629929bde0eff9af72165f", size = 8320331, upload-time = "2026-04-24T00:12:39.688Z" },
+    { url = "https://files.pythonhosted.org/packages/63/d9/9e14bc7564bf92d5ffa801ae5fac819ce74b925dfb55e3ebde61a3bbad3e/matplotlib-3.10.9-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:b1b745c489cd1a77a0dc1120a05dc87af9798faebc913601feb8c73d89bf2d1e", size = 8216461, upload-time = "2026-04-24T00:12:42.494Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/17/4402d0d14ccf1dfc70932600b68097fbbf9c898a4871d2cbbe79c7801a32/matplotlib-3.10.9-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8f3bcac1ca5ed000a6f4337d47ba67dfddf37ed6a46c15fd7f014997f7bf865f", size = 8790091, upload-time = "2026-04-24T00:12:44.789Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/0b/322aeec06dd9b91411f92028b37d447342770a24392aa4813e317064dad5/matplotlib-3.10.9-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7a8d66a55def891c33147ba3ba9bfcabf0b526a43764c818acbb4525e5ed0838", size = 9605027, upload-time = "2026-04-24T00:12:47.583Z" },
+    { url = "https://files.pythonhosted.org/packages/74/88/5f13482f55e7b00bcfc09838b093c2456e1379978d2a146844aae05350ad/matplotlib-3.10.9-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:d843374407c4017a6403b59c6c81606773d136f3259d5b6da3131bc814542cc2", size = 9671269, upload-time = "2026-04-24T00:12:50.878Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/e0/0840fd2f93da988ec660b8ad1984abe9f25d2aed22a5e394ff1c68c88307/matplotlib-3.10.9-cp313-cp313-win_amd64.whl", hash = "sha256:f4399f64b3e94cd500195490972ae1ee81170df1636fa15364d157d5bdd7b921", size = 8217588, upload-time = "2026-04-24T00:12:53.784Z" },
+    { url = "https://files.pythonhosted.org/packages/47/b9/d706d06dd605c49b9f83a2aed8c13e3e5db70697d7a80b7e3d7915de6b17/matplotlib-3.10.9-cp313-cp313-win_arm64.whl", hash = "sha256:ba7b3b8ef09eab7df0e86e9ae086faa433efbfbdb46afcb3aa16aabf779469a8", size = 8136913, upload-time = "2026-04-24T00:12:56.501Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/45/6e32d96978264c8ca8c4b1010adb955a1a49cfaf314e212bbc8908f04a61/matplotlib-3.10.9-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:09218df8a93712bd6ea133e83a153c755448cf7868316c531cffcc43f69d1cc9", size = 8368019, upload-time = "2026-04-24T00:12:58.896Z" },
+    { url = "https://files.pythonhosted.org/packages/86/0a/c8e3d3bba245f0f7fc424937f8ff7ef77291a36af3edb97ccd78aa93d84f/matplotlib-3.10.9-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:82368699727bfb7b0182e1aa13082e3c08e092fa1a25d3e1fd92405bff96f6d4", size = 8264645, upload-time = "2026-04-24T00:13:01.406Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/aa/5bf5a14fe4fed73a4209a155606f8096ff797aad89c6c35179026571133e/matplotlib-3.10.9-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3225f4e1edcb8c86c884ddf79ebe20ecd0a67d30188f279897554ccd8fded4dc", size = 8802194, upload-time = "2026-04-24T00:13:03.702Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/5e/b4be852d6bba6fd15893fadf91ff26ae49cb91aac789e95dde9d342e664f/matplotlib-3.10.9-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:de2445a0c6690d21b7eb6ce071cebad6d40a2e9bdf10d039074a96ba19797b99", size = 9622684, upload-time = "2026-04-24T00:13:06.647Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/3d/ed428c971139112ef730f62770654d609467346d09d4b62617e1afd68a5a/matplotlib-3.10.9-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:b2b9516251cb89ff618d757daec0e2ed1bf21248013844a853d87ef85ab3081d", size = 9680790, upload-time = "2026-04-24T00:13:10.009Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/09/052e884aaf2b985c63cb79f715f1d5b6a3eaa7de78f6a52b9dbc077d5b53/matplotlib-3.10.9-cp313-cp313t-win_amd64.whl", hash = "sha256:e9fae004b941b23ff2edcf1567a857ed77bafc8086ffa258190462328434faf8", size = 8287571, upload-time = "2026-04-24T00:13:13.087Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/38/ae27288e788c35a4250491422f3db7750366fc8c97d6f36fbdecfc1f5518/matplotlib-3.10.9-cp313-cp313t-win_arm64.whl", hash = "sha256:6b63d9c7c769b88ab81e10dc86e4e0607cf56817b9f9e6cf24b2a5f1693b8e38", size = 8188292, upload-time = "2026-04-24T00:13:15.546Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/e6/3bd8afd04949f02eabc1c17115ea5255e19cacd4d06fc5abdde4eeb0052c/matplotlib-3.10.9-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:172db52c9e683f5d12eaf57f0f54834190e12581fe1cc2a19595a8f5acb4e77d", size = 8321276, upload-time = "2026-04-24T00:13:18.318Z" },
+    { url = "https://files.pythonhosted.org/packages/41/86/86231232fff41c9f8e4a1a7d7a597d349a02527109c3af7d618366122139/matplotlib-3.10.9-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:97e35e8d39ccc85859095e01a53847432ba9a53ddf7986f7a54a11b73d0e143f", size = 8218218, upload-time = "2026-04-24T00:13:20.974Z" },
+    { url = "https://files.pythonhosted.org/packages/85/8f/becc9722cafc64f5d2eb0b7c1bf5f585271c618a45dbd8fabeb021f898b6/matplotlib-3.10.9-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:aba1615dabe83188e19d4f75a253c6a08423e04c1425e64039f800050a69de6b", size = 9608145, upload-time = "2026-04-24T00:13:23.228Z" },
+    { url = "https://files.pythonhosted.org/packages/32/5d/f7e914f7d9325abff4057cee62c0fa70263683189f774473cbfb534cd13b/matplotlib-3.10.9-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34cf8167e023ad956c15f36302911d5406bd99a9862c1a8499ea6f7c0e015dc2", size = 9885085, upload-time = "2026-04-24T00:13:25.849Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/fd/fa69f2221534e80cc5772ac2b7d222011a2acafc2ec7216d5dd174c864ae/matplotlib-3.10.9-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:59476c6d29d612b8e9bb6ce8c5b631be6ba8f9e3a2421f22a02b192c7dd28716", size = 9672358, upload-time = "2026-04-24T00:13:28.906Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/1a/5a4f747a8b271cbb024946d2dd3c913ab5032ba430626f8c3528ada96b4b/matplotlib-3.10.9-cp314-cp314-win_amd64.whl", hash = "sha256:336b9acc64d309063126edcdaca00db9373af3c476bb94388fe9c5a53ad13e6f", size = 8349970, upload-time = "2026-04-24T00:13:31.904Z" },
+    { url = "https://files.pythonhosted.org/packages/64/dc/95d60ecaefe30680a154b52ea96ab4b0dab547f1fd6aa12f5fb655e89cae/matplotlib-3.10.9-cp314-cp314-win_arm64.whl", hash = "sha256:2dc9477819ffd78ad12a20df1d9d6a6bd4fec6aaa9072681465fddca052f1456", size = 8272785, upload-time = "2026-04-24T00:13:34.511Z" },
+    { url = "https://files.pythonhosted.org/packages/70/a0/005d68bc8b8418300ce6591f18586910a8526806e2ab663933d9f20a41e9/matplotlib-3.10.9-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:da4e09638420548f31c354032a6250e473c68e5a4e96899b4844cf39ddea23fe", size = 8367999, upload-time = "2026-04-24T00:13:36.962Z" },
+    { url = "https://files.pythonhosted.org/packages/22/05/1236cc9290be70b2498af20ca348add76e3fffe7f67b477db5133a84f3ea/matplotlib-3.10.9-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:345f6f68ecc8da0ca56fad2ea08fde1a115eda530079eca185d50a7bc3e146c6", size = 8264543, upload-time = "2026-04-24T00:13:39.851Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/c2/071f5a5ff6c5bd63aaaf2f45c811d9bf2ced94bde188d9e1a519e21d0cba/matplotlib-3.10.9-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4edcfbd8565339aa62f1cd4012f7180926fdbe71850f7b0d3c379c175cd6b66c", size = 9622800, upload-time = "2026-04-24T00:13:42.296Z" },
+    { url = "https://files.pythonhosted.org/packages/95/57/da7d1f10a85624b9e7db68e069dd94e58dc41dbf9463c5921632ecbe3661/matplotlib-3.10.9-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6be157fe17fc37cb95ac1d7374cf717ce9259616edec911a78d9d26dae8522d4", size = 9888561, upload-time = "2026-04-24T00:13:45.026Z" },
+    { url = "https://files.pythonhosted.org/packages/67/b2/ef8d6bb59b0edb6c16c968b70f548aa13b54348972def5aa6ac85df67145/matplotlib-3.10.9-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:4e42042d54db34fda4e95a7bd3e5789c2a995d2dad3eb8850232ee534092fbbf", size = 9680884, upload-time = "2026-04-24T00:13:48.066Z" },
+    { url = "https://files.pythonhosted.org/packages/61/1c/d21bfeb9931881ebe96bcfcff27c7ae4b160ae0ec291a714c42641a56d75/matplotlib-3.10.9-cp314-cp314t-win_amd64.whl", hash = "sha256:c27df8b3848f32a83d1767566595e43cfaa4460380974da06f4279a7ec143c39", size = 8432333, upload-time = "2026-04-24T00:13:51.008Z" },
+    { url = "https://files.pythonhosted.org/packages/78/23/92493c3e6e1b635ccfff146f7b99e674808787915420373ac399283764c2/matplotlib-3.10.9-cp314-cp314t-win_arm64.whl", hash = "sha256:a49f1eadc84ca85fd72fa4e89e70e61bf86452df6f971af04b12c60761a0772c", size = 8324785, upload-time = "2026-04-24T00:13:53.633Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/2b/0e92ad0ac446633f928a1563db4aa8add407e1924faf0ded5b95b35afb27/matplotlib-3.10.9-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:1872fb212a05b729e649754a72d5da61d03e0554d76e80303b6f83d1d2c0552b", size = 8293058, upload-time = "2026-04-24T00:13:56.339Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/23/74682fd369f5299ceda438fea2a0662e6383b85c9383fb9cdfcf04713e07/matplotlib-3.10.9-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:985f2238880e2e69093f588f5fe2e46771747febf0649f3cf7f7b7480875317f", size = 8186627, upload-time = "2026-04-24T00:13:58.623Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/e8/368aab88f3c4cd8992800f31abfe0670c3e47540ba20a97e9fdbcde594b3/matplotlib-3.10.9-pp310-pypy310_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:6640f75af2c6148293caa0a2b39dd806a492dd66c8a8b04035813e33d0fd2585", size = 8764117, upload-time = "2026-04-24T00:14:01.684Z" },
+    { url = "https://files.pythonhosted.org/packages/63/e2/9f66ca6a651a52abfe0d4964ce01439ed34f3f1e119de10ff3a07f403043/matplotlib-3.10.9-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:42fb814efabe95c06c1994d8ab5a8385f43a249e23badd3ba931d4308e5bca20", size = 8304420, upload-time = "2026-04-24T00:14:04.57Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/e8/467c03568218792906aa87b5e7bb379b605e056ed0c74fe00c051786d925/matplotlib-3.10.9-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:f76e640a5268850bfda54b5131b1b1941cc685e42c5fa98ed9f2d64038308cba", size = 8197981, upload-time = "2026-04-24T00:14:07.233Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/87/afead29192170917537934c6aff4b008c805fff7b1ccea0c79120d96beda/matplotlib-3.10.9-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3fc0364dfbe1d07f6d15c5ebd0c5bf89e126916e5a8667dd4a7a6e84c36653d4", size = 8774002, upload-time = "2026-04-24T00:14:09.816Z" },
+]
+
+[[package]]
+name = "mpmath"
+version = "1.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/47/dd32fa426cc72114383ac549964eecb20ecfd886d1e5ccf5340b55b02f57/mpmath-1.3.0.tar.gz", hash = "sha256:7a28eb2a9774d00c7bc92411c19a89209d5da7c4c9a9e227be8330a23a25b91f", size = 508106, upload-time = "2023-03-07T16:47:11.061Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/43/e3/7d92a15f894aa0c9c4b49b8ee9ac9850d6e63b03c9c32c0367a13ae62209/mpmath-1.3.0-py3-none-any.whl", hash = "sha256:a0b2b9fe80bbcd81a6647ff13108738cfb482d481d826cc0e02f5b35e5c88d2c", size = 536198, upload-time = "2023-03-07T16:47:09.197Z" },
+]
+
+[[package]]
+name = "msgpack"
+version = "1.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4d/f2/bfb55a6236ed8725a96b0aa3acbd0ec17588e6a2c3b62a93eb513ed8783f/msgpack-1.1.2.tar.gz", hash = "sha256:3b60763c1373dd60f398488069bcdc703cd08a711477b5d480eecc9f9626f47e", size = 173581, upload-time = "2025-10-08T09:15:56.596Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f5/a2/3b68a9e769db68668b25c6108444a35f9bd163bb848c0650d516761a59c0/msgpack-1.1.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:0051fffef5a37ca2cd16978ae4f0aef92f164df86823871b5162812bebecd8e2", size = 81318, upload-time = "2025-10-08T09:14:38.722Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/e1/2b720cc341325c00be44e1ed59e7cfeae2678329fbf5aa68f5bda57fe728/msgpack-1.1.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a605409040f2da88676e9c9e5853b3449ba8011973616189ea5ee55ddbc5bc87", size = 83786, upload-time = "2025-10-08T09:14:40.082Z" },
+    { url = "https://files.pythonhosted.org/packages/71/e5/c2241de64bfceac456b140737812a2ab310b10538a7b34a1d393b748e095/msgpack-1.1.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8b696e83c9f1532b4af884045ba7f3aa741a63b2bc22617293a2c6a7c645f251", size = 398240, upload-time = "2025-10-08T09:14:41.151Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/09/2a06956383c0fdebaef5aa9246e2356776f12ea6f2a44bd1368abf0e46c4/msgpack-1.1.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:365c0bbe981a27d8932da71af63ef86acc59ed5c01ad929e09a0b88c6294e28a", size = 406070, upload-time = "2025-10-08T09:14:42.821Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/74/2957703f0e1ef20637d6aead4fbb314330c26f39aa046b348c7edcf6ca6b/msgpack-1.1.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:41d1a5d875680166d3ac5c38573896453bbbea7092936d2e107214daf43b1d4f", size = 393403, upload-time = "2025-10-08T09:14:44.38Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/09/3bfc12aa90f77b37322fc33e7a8a7c29ba7c8edeadfa27664451801b9860/msgpack-1.1.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:354e81bcdebaab427c3df4281187edc765d5d76bfb3a7c125af9da7a27e8458f", size = 398947, upload-time = "2025-10-08T09:14:45.56Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/4f/05fcebd3b4977cb3d840f7ef6b77c51f8582086de5e642f3fefee35c86fc/msgpack-1.1.2-cp310-cp310-win32.whl", hash = "sha256:e64c8d2f5e5d5fda7b842f55dec6133260ea8f53c4257d64494c534f306bf7a9", size = 64769, upload-time = "2025-10-08T09:14:47.334Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/3e/b4547e3a34210956382eed1c85935fff7e0f9b98be3106b3745d7dec9c5e/msgpack-1.1.2-cp310-cp310-win_amd64.whl", hash = "sha256:db6192777d943bdaaafb6ba66d44bf65aa0e9c5616fa1d2da9bb08828c6b39aa", size = 71293, upload-time = "2025-10-08T09:14:48.665Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/97/560d11202bcd537abca693fd85d81cebe2107ba17301de42b01ac1677b69/msgpack-1.1.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:2e86a607e558d22985d856948c12a3fa7b42efad264dca8a3ebbcfa2735d786c", size = 82271, upload-time = "2025-10-08T09:14:49.967Z" },
+    { url = "https://files.pythonhosted.org/packages/83/04/28a41024ccbd67467380b6fb440ae916c1e4f25e2cd4c63abe6835ac566e/msgpack-1.1.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:283ae72fc89da59aa004ba147e8fc2f766647b1251500182fac0350d8af299c0", size = 84914, upload-time = "2025-10-08T09:14:50.958Z" },
+    { url = "https://files.pythonhosted.org/packages/71/46/b817349db6886d79e57a966346cf0902a426375aadc1e8e7a86a75e22f19/msgpack-1.1.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:61c8aa3bd513d87c72ed0b37b53dd5c5a0f58f2ff9f26e1555d3bd7948fb7296", size = 416962, upload-time = "2025-10-08T09:14:51.997Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e0/6cc2e852837cd6086fe7d8406af4294e66827a60a4cf60b86575a4a65ca8/msgpack-1.1.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:454e29e186285d2ebe65be34629fa0e8605202c60fbc7c4c650ccd41870896ef", size = 426183, upload-time = "2025-10-08T09:14:53.477Z" },
+    { url = "https://files.pythonhosted.org/packages/25/98/6a19f030b3d2ea906696cedd1eb251708e50a5891d0978b012cb6107234c/msgpack-1.1.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:7bc8813f88417599564fafa59fd6f95be417179f76b40325b500b3c98409757c", size = 411454, upload-time = "2025-10-08T09:14:54.648Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/cd/9098fcb6adb32187a70b7ecaabf6339da50553351558f37600e53a4a2a23/msgpack-1.1.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:bafca952dc13907bdfdedfc6a5f579bf4f292bdd506fadb38389afa3ac5b208e", size = 422341, upload-time = "2025-10-08T09:14:56.328Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/ae/270cecbcf36c1dc85ec086b33a51a4d7d08fc4f404bdbc15b582255d05ff/msgpack-1.1.2-cp311-cp311-win32.whl", hash = "sha256:602b6740e95ffc55bfb078172d279de3773d7b7db1f703b2f1323566b878b90e", size = 64747, upload-time = "2025-10-08T09:14:57.882Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/79/309d0e637f6f37e83c711f547308b91af02b72d2326ddd860b966080ef29/msgpack-1.1.2-cp311-cp311-win_amd64.whl", hash = "sha256:d198d275222dc54244bf3327eb8cbe00307d220241d9cec4d306d49a44e85f68", size = 71633, upload-time = "2025-10-08T09:14:59.177Z" },
+    { url = "https://files.pythonhosted.org/packages/73/4d/7c4e2b3d9b1106cd0aa6cb56cc57c6267f59fa8bfab7d91df5adc802c847/msgpack-1.1.2-cp311-cp311-win_arm64.whl", hash = "sha256:86f8136dfa5c116365a8a651a7d7484b65b13339731dd6faebb9a0242151c406", size = 64755, upload-time = "2025-10-08T09:15:00.48Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/bd/8b0d01c756203fbab65d265859749860682ccd2a59594609aeec3a144efa/msgpack-1.1.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:70a0dff9d1f8da25179ffcf880e10cf1aad55fdb63cd59c9a49a1b82290062aa", size = 81939, upload-time = "2025-10-08T09:15:01.472Z" },
+    { url = "https://files.pythonhosted.org/packages/34/68/ba4f155f793a74c1483d4bdef136e1023f7bcba557f0db4ef3db3c665cf1/msgpack-1.1.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:446abdd8b94b55c800ac34b102dffd2f6aa0ce643c55dfc017ad89347db3dbdb", size = 85064, upload-time = "2025-10-08T09:15:03.764Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/60/a064b0345fc36c4c3d2c743c82d9100c40388d77f0b48b2f04d6041dbec1/msgpack-1.1.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c63eea553c69ab05b6747901b97d620bb2a690633c77f23feb0c6a947a8a7b8f", size = 417131, upload-time = "2025-10-08T09:15:05.136Z" },
+    { url = "https://files.pythonhosted.org/packages/65/92/a5100f7185a800a5d29f8d14041f61475b9de465ffcc0f3b9fba606e4505/msgpack-1.1.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:372839311ccf6bdaf39b00b61288e0557916c3729529b301c52c2d88842add42", size = 427556, upload-time = "2025-10-08T09:15:06.837Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/87/ffe21d1bf7d9991354ad93949286f643b2bb6ddbeab66373922b44c3b8cc/msgpack-1.1.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2929af52106ca73fcb28576218476ffbb531a036c2adbcf54a3664de124303e9", size = 404920, upload-time = "2025-10-08T09:15:08.179Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/41/8543ed2b8604f7c0d89ce066f42007faac1eaa7d79a81555f206a5cdb889/msgpack-1.1.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:be52a8fc79e45b0364210eef5234a7cf8d330836d0a64dfbb878efa903d84620", size = 415013, upload-time = "2025-10-08T09:15:09.83Z" },
+    { url = "https://files.pythonhosted.org/packages/41/0d/2ddfaa8b7e1cee6c490d46cb0a39742b19e2481600a7a0e96537e9c22f43/msgpack-1.1.2-cp312-cp312-win32.whl", hash = "sha256:1fff3d825d7859ac888b0fbda39a42d59193543920eda9d9bea44d958a878029", size = 65096, upload-time = "2025-10-08T09:15:11.11Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/ec/d431eb7941fb55a31dd6ca3404d41fbb52d99172df2e7707754488390910/msgpack-1.1.2-cp312-cp312-win_amd64.whl", hash = "sha256:1de460f0403172cff81169a30b9a92b260cb809c4cb7e2fc79ae8d0510c78b6b", size = 72708, upload-time = "2025-10-08T09:15:12.554Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/31/5b1a1f70eb0e87d1678e9624908f86317787b536060641d6798e3cf70ace/msgpack-1.1.2-cp312-cp312-win_arm64.whl", hash = "sha256:be5980f3ee0e6bd44f3a9e9dea01054f175b50c3e6cdb692bc9424c0bbb8bf69", size = 64119, upload-time = "2025-10-08T09:15:13.589Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/31/b46518ecc604d7edf3a4f94cb3bf021fc62aa301f0cb849936968164ef23/msgpack-1.1.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4efd7b5979ccb539c221a4c4e16aac1a533efc97f3b759bb5a5ac9f6d10383bf", size = 81212, upload-time = "2025-10-08T09:15:14.552Z" },
+    { url = "https://files.pythonhosted.org/packages/92/dc/c385f38f2c2433333345a82926c6bfa5ecfff3ef787201614317b58dd8be/msgpack-1.1.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:42eefe2c3e2af97ed470eec850facbe1b5ad1d6eacdbadc42ec98e7dcf68b4b7", size = 84315, upload-time = "2025-10-08T09:15:15.543Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/68/93180dce57f684a61a88a45ed13047558ded2be46f03acb8dec6d7c513af/msgpack-1.1.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1fdf7d83102bf09e7ce3357de96c59b627395352a4024f6e2458501f158bf999", size = 412721, upload-time = "2025-10-08T09:15:16.567Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/ba/459f18c16f2b3fc1a1ca871f72f07d70c07bf768ad0a507a698b8052ac58/msgpack-1.1.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fac4be746328f90caa3cd4bc67e6fe36ca2bf61d5c6eb6d895b6527e3f05071e", size = 424657, upload-time = "2025-10-08T09:15:17.825Z" },
+    { url = "https://files.pythonhosted.org/packages/38/f8/4398c46863b093252fe67368b44edc6c13b17f4e6b0e4929dbf0bdb13f23/msgpack-1.1.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:fffee09044073e69f2bad787071aeec727183e7580443dfeb8556cbf1978d162", size = 402668, upload-time = "2025-10-08T09:15:19.003Z" },
+    { url = "https://files.pythonhosted.org/packages/28/ce/698c1eff75626e4124b4d78e21cca0b4cc90043afb80a507626ea354ab52/msgpack-1.1.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:5928604de9b032bc17f5099496417f113c45bc6bc21b5c6920caf34b3c428794", size = 419040, upload-time = "2025-10-08T09:15:20.183Z" },
+    { url = "https://files.pythonhosted.org/packages/67/32/f3cd1667028424fa7001d82e10ee35386eea1408b93d399b09fb0aa7875f/msgpack-1.1.2-cp313-cp313-win32.whl", hash = "sha256:a7787d353595c7c7e145e2331abf8b7ff1e6673a6b974ded96e6d4ec09f00c8c", size = 65037, upload-time = "2025-10-08T09:15:21.416Z" },
+    { url = "https://files.pythonhosted.org/packages/74/07/1ed8277f8653c40ebc65985180b007879f6a836c525b3885dcc6448ae6cb/msgpack-1.1.2-cp313-cp313-win_amd64.whl", hash = "sha256:a465f0dceb8e13a487e54c07d04ae3ba131c7c5b95e2612596eafde1dccf64a9", size = 72631, upload-time = "2025-10-08T09:15:22.431Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/db/0314e4e2db56ebcf450f277904ffd84a7988b9e5da8d0d61ab2d057df2b6/msgpack-1.1.2-cp313-cp313-win_arm64.whl", hash = "sha256:e69b39f8c0aa5ec24b57737ebee40be647035158f14ed4b40e6f150077e21a84", size = 64118, upload-time = "2025-10-08T09:15:23.402Z" },
+    { url = "https://files.pythonhosted.org/packages/22/71/201105712d0a2ff07b7873ed3c220292fb2ea5120603c00c4b634bcdafb3/msgpack-1.1.2-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:e23ce8d5f7aa6ea6d2a2b326b4ba46c985dbb204523759984430db7114f8aa00", size = 81127, upload-time = "2025-10-08T09:15:24.408Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/9f/38ff9e57a2eade7bf9dfee5eae17f39fc0e998658050279cbb14d97d36d9/msgpack-1.1.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:6c15b7d74c939ebe620dd8e559384be806204d73b4f9356320632d783d1f7939", size = 84981, upload-time = "2025-10-08T09:15:25.812Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/a9/3536e385167b88c2cc8f4424c49e28d49a6fc35206d4a8060f136e71f94c/msgpack-1.1.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:99e2cb7b9031568a2a5c73aa077180f93dd2e95b4f8d3b8e14a73ae94a9e667e", size = 411885, upload-time = "2025-10-08T09:15:27.22Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/40/dc34d1a8d5f1e51fc64640b62b191684da52ca469da9cd74e84936ffa4a6/msgpack-1.1.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:180759d89a057eab503cf62eeec0aa61c4ea1200dee709f3a8e9397dbb3b6931", size = 419658, upload-time = "2025-10-08T09:15:28.4Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/ef/2b92e286366500a09a67e03496ee8b8ba00562797a52f3c117aa2b29514b/msgpack-1.1.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:04fb995247a6e83830b62f0b07bf36540c213f6eac8e851166d8d86d83cbd014", size = 403290, upload-time = "2025-10-08T09:15:29.764Z" },
+    { url = "https://files.pythonhosted.org/packages/78/90/e0ea7990abea5764e4655b8177aa7c63cdfa89945b6e7641055800f6c16b/msgpack-1.1.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:8e22ab046fa7ede9e36eeb4cfad44d46450f37bb05d5ec482b02868f451c95e2", size = 415234, upload-time = "2025-10-08T09:15:31.022Z" },
+    { url = "https://files.pythonhosted.org/packages/72/4e/9390aed5db983a2310818cd7d3ec0aecad45e1f7007e0cda79c79507bb0d/msgpack-1.1.2-cp314-cp314-win32.whl", hash = "sha256:80a0ff7d4abf5fecb995fcf235d4064b9a9a8a40a3ab80999e6ac1e30b702717", size = 66391, upload-time = "2025-10-08T09:15:32.265Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/f1/abd09c2ae91228c5f3998dbd7f41353def9eac64253de3c8105efa2082f7/msgpack-1.1.2-cp314-cp314-win_amd64.whl", hash = "sha256:9ade919fac6a3e7260b7f64cea89df6bec59104987cbea34d34a2fa15d74310b", size = 73787, upload-time = "2025-10-08T09:15:33.219Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/b0/9d9f667ab48b16ad4115c1935d94023b82b3198064cb84a123e97f7466c1/msgpack-1.1.2-cp314-cp314-win_arm64.whl", hash = "sha256:59415c6076b1e30e563eb732e23b994a61c159cec44deaf584e5cc1dd662f2af", size = 66453, upload-time = "2025-10-08T09:15:34.225Z" },
+    { url = "https://files.pythonhosted.org/packages/16/67/93f80545eb1792b61a217fa7f06d5e5cb9e0055bed867f43e2b8e012e137/msgpack-1.1.2-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:897c478140877e5307760b0ea66e0932738879e7aa68144d9b78ea4c8302a84a", size = 85264, upload-time = "2025-10-08T09:15:35.61Z" },
+    { url = "https://files.pythonhosted.org/packages/87/1c/33c8a24959cf193966ef11a6f6a2995a65eb066bd681fd085afd519a57ce/msgpack-1.1.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a668204fa43e6d02f89dbe79a30b0d67238d9ec4c5bd8a940fc3a004a47b721b", size = 89076, upload-time = "2025-10-08T09:15:36.619Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/6b/62e85ff7193663fbea5c0254ef32f0c77134b4059f8da89b958beb7696f3/msgpack-1.1.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5559d03930d3aa0f3aacb4c42c776af1a2ace2611871c84a75afe436695e6245", size = 435242, upload-time = "2025-10-08T09:15:37.647Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/47/5c74ecb4cc277cf09f64e913947871682ffa82b3b93c8dad68083112f412/msgpack-1.1.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:70c5a7a9fea7f036b716191c29047374c10721c389c21e9ffafad04df8c52c90", size = 432509, upload-time = "2025-10-08T09:15:38.794Z" },
+    { url = "https://files.pythonhosted.org/packages/24/a4/e98ccdb56dc4e98c929a3f150de1799831c0a800583cde9fa022fa90602d/msgpack-1.1.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:f2cb069d8b981abc72b41aea1c580ce92d57c673ec61af4c500153a626cb9e20", size = 415957, upload-time = "2025-10-08T09:15:40.238Z" },
+    { url = "https://files.pythonhosted.org/packages/da/28/6951f7fb67bc0a4e184a6b38ab71a92d9ba58080b27a77d3e2fb0be5998f/msgpack-1.1.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:d62ce1f483f355f61adb5433ebfd8868c5f078d1a52d042b0a998682b4fa8c27", size = 422910, upload-time = "2025-10-08T09:15:41.505Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/03/42106dcded51f0a0b5284d3ce30a671e7bd3f7318d122b2ead66ad289fed/msgpack-1.1.2-cp314-cp314t-win32.whl", hash = "sha256:1d1418482b1ee984625d88aa9585db570180c286d942da463533b238b98b812b", size = 75197, upload-time = "2025-10-08T09:15:42.954Z" },
+    { url = "https://files.pythonhosted.org/packages/15/86/d0071e94987f8db59d4eeb386ddc64d0bb9b10820a8d82bcd3e53eeb2da6/msgpack-1.1.2-cp314-cp314t-win_amd64.whl", hash = "sha256:5a46bf7e831d09470ad92dff02b8b1ac92175ca36b087f904a0519857c6be3ff", size = 85772, upload-time = "2025-10-08T09:15:43.954Z" },
+    { url = "https://files.pythonhosted.org/packages/81/f2/08ace4142eb281c12701fc3b93a10795e4d4dc7f753911d836675050f886/msgpack-1.1.2-cp314-cp314t-win_arm64.whl", hash = "sha256:d99ef64f349d5ec3293688e91486c5fdb925ed03807f64d98d205d2713c60b46", size = 70868, upload-time = "2025-10-08T09:15:44.959Z" },
+]
+
+[[package]]
+name = "msgpack-numpy"
+version = "0.4.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "msgpack" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/08/94/61e8aee142733ebfdc400a05bdac6e1763c4514bba3b42743d223f388450/msgpack-numpy-0.4.8.tar.gz", hash = "sha256:c667d3180513422f9c7545be5eec5d296dcbb357e06f72ed39cc683797556e69", size = 10923, upload-time = "2022-06-09T03:43:08.739Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9b/5d/f25ac7d4fb77cbd53ddc6d05d833c6bf52b12770a44fa9a447eed470ca9a/msgpack_numpy-0.4.8-py2.py3-none-any.whl", hash = "sha256:773c19d4dfbae1b3c7b791083e2caf66983bb19b40901646f61d8731554ae3da", size = 6919, upload-time = "2022-06-09T03:43:06.82Z" },
+]
+
+[[package]]
+name = "multidict"
+version = "6.7.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/1a/c2/c2d94cbe6ac1753f3fc980da97b3d930efe1da3af3c9f5125354436c073d/multidict-6.7.1.tar.gz", hash = "sha256:ec6652a1bee61c53a3e5776b6049172c53b6aaba34f18c9ad04f82712bac623d", size = 102010, upload-time = "2026-01-26T02:46:45.979Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/84/0b/19348d4c98980c4851d2f943f8ebafdece2ae7ef737adcfa5994ce8e5f10/multidict-6.7.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:c93c3db7ea657dd4637d57e74ab73de31bccefe144d3d4ce370052035bc85fb5", size = 77176, upload-time = "2026-01-26T02:42:59.784Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/04/9de3f8077852e3d438215c81e9b691244532d2e05b4270e89ce67b7d103c/multidict-6.7.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:974e72a2474600827abaeda71af0c53d9ebbc3c2eb7da37b37d7829ae31232d8", size = 44996, upload-time = "2026-01-26T02:43:01.674Z" },
+    { url = "https://files.pythonhosted.org/packages/31/5c/08c7f7fe311f32e83f7621cd3f99d805f45519cd06fafb247628b861da7d/multidict-6.7.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:cdea2e7b2456cfb6694fb113066fd0ec7ea4d67e3a35e1f4cbeea0b448bf5872", size = 44631, upload-time = "2026-01-26T02:43:03.169Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/7f/0e3b1390ae772f27501199996b94b52ceeb64fe6f9120a32c6c3f6b781be/multidict-6.7.1-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:17207077e29342fdc2c9a82e4b306f1127bf1ea91f8b71e02d4798a70bb99991", size = 242561, upload-time = "2026-01-26T02:43:04.733Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/f4/8719f4f167586af317b69dd3e90f913416c91ca610cac79a45c53f590312/multidict-6.7.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d4f49cb5661344764e4c7c7973e92a47a59b8fc19b6523649ec9dc4960e58a03", size = 242223, upload-time = "2026-01-26T02:43:06.695Z" },
+    { url = "https://files.pythonhosted.org/packages/47/ab/7c36164cce64a6ad19c6d9a85377b7178ecf3b89f8fd589c73381a5eedfd/multidict-6.7.1-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a9fc4caa29e2e6ae408d1c450ac8bf19892c5fca83ee634ecd88a53332c59981", size = 222322, upload-time = "2026-01-26T02:43:08.472Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/79/a25add6fb38035b5337bc5734f296d9afc99163403bbcf56d4170f97eb62/multidict-6.7.1-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c5f0c21549ab432b57dcc82130f388d84ad8179824cc3f223d5e7cfbfd4143f6", size = 254005, upload-time = "2026-01-26T02:43:10.127Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/7b/64a87cf98e12f756fc8bd444b001232ffff2be37288f018ad0d3f0aae931/multidict-6.7.1-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:7dfb78d966b2c906ae1d28ccf6e6712a3cd04407ee5088cd276fe8cb42186190", size = 251173, upload-time = "2026-01-26T02:43:11.731Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/ac/b605473de2bb404e742f2cc3583d12aedb2352a70e49ae8fce455b50c5aa/multidict-6.7.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9b0d9b91d1aa44db9c1f1ecd0d9d2ae610b2f4f856448664e01a3b35899f3f92", size = 243273, upload-time = "2026-01-26T02:43:13.063Z" },
+    { url = "https://files.pythonhosted.org/packages/03/65/11492d6a0e259783720f3bc1d9ea55579a76f1407e31ed44045c99542004/multidict-6.7.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:dd96c01a9dcd4889dcfcf9eb5544ca0c77603f239e3ffab0524ec17aea9a93ee", size = 238956, upload-time = "2026-01-26T02:43:14.843Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/a7/7ee591302af64e7c196fb63fe856c788993c1372df765102bd0448e7e165/multidict-6.7.1-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:067343c68cd6612d375710f895337b3a98a033c94f14b9a99eff902f205424e2", size = 233477, upload-time = "2026-01-26T02:43:16.025Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/99/c109962d58756c35fd9992fed7f2355303846ea2ff054bb5f5e9d6b888de/multidict-6.7.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:5884a04f4ff56c6120f6ccf703bdeb8b5079d808ba604d4d53aec0d55dc33568", size = 243615, upload-time = "2026-01-26T02:43:17.84Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/5f/1973e7c771c86e93dcfe1c9cc55a5481b610f6614acfc28c0d326fe6bfad/multidict-6.7.1-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:8affcf1c98b82bc901702eb73b6947a1bfa170823c153fe8a47b5f5f02e48e40", size = 249930, upload-time = "2026-01-26T02:43:19.06Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/a5/f170fc2268c3243853580203378cd522446b2df632061e0a5409817854c7/multidict-6.7.1-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:0d17522c37d03e85c8098ec8431636309b2682cf12e58f4dbc76121fb50e4962", size = 243807, upload-time = "2026-01-26T02:43:20.286Z" },
+    { url = "https://files.pythonhosted.org/packages/de/01/73856fab6d125e5bc652c3986b90e8699a95e84b48d72f39ade6c0e74a8c/multidict-6.7.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:24c0cf81544ca5e17cfcb6e482e7a82cd475925242b308b890c9452a074d4505", size = 239103, upload-time = "2026-01-26T02:43:21.508Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/46/f1220bd9944d8aa40d8ccff100eeeee19b505b857b6f603d6078cb5315b0/multidict-6.7.1-cp310-cp310-win32.whl", hash = "sha256:d82dd730a95e6643802f4454b8fdecdf08667881a9c5670db85bc5a56693f122", size = 41416, upload-time = "2026-01-26T02:43:22.703Z" },
+    { url = "https://files.pythonhosted.org/packages/68/00/9b38e272a770303692fc406c36e1a4c740f401522d5787691eb38a8925a8/multidict-6.7.1-cp310-cp310-win_amd64.whl", hash = "sha256:cf37cbe5ced48d417ba045aca1b21bafca67489452debcde94778a576666a1df", size = 46022, upload-time = "2026-01-26T02:43:23.77Z" },
+    { url = "https://files.pythonhosted.org/packages/64/65/d8d42490c02ee07b6bbe00f7190d70bb4738b3cce7629aaf9f213ef730dd/multidict-6.7.1-cp310-cp310-win_arm64.whl", hash = "sha256:59bc83d3f66b41dac1e7460aac1d196edc70c9ba3094965c467715a70ecb46db", size = 43238, upload-time = "2026-01-26T02:43:24.882Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/f1/a90635c4f88fb913fbf4ce660b83b7445b7a02615bda034b2f8eb38fd597/multidict-6.7.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:7ff981b266af91d7b4b3793ca3382e53229088d193a85dfad6f5f4c27fc73e5d", size = 76626, upload-time = "2026-01-26T02:43:26.485Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/9b/267e64eaf6fc637a15b35f5de31a566634a2740f97d8d094a69d34f524a4/multidict-6.7.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:844c5bca0b5444adb44a623fb0a1310c2f4cd41f402126bb269cd44c9b3f3e1e", size = 44706, upload-time = "2026-01-26T02:43:27.607Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/a4/d45caf2b97b035c57267791ecfaafbd59c68212004b3842830954bb4b02e/multidict-6.7.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:f2a0a924d4c2e9afcd7ec64f9de35fcd96915149b2216e1cb2c10a56df483855", size = 44356, upload-time = "2026-01-26T02:43:28.661Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/d2/0a36c8473f0cbaeadd5db6c8b72d15bbceeec275807772bfcd059bef487d/multidict-6.7.1-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:8be1802715a8e892c784c0197c2ace276ea52702a0ede98b6310c8f255a5afb3", size = 244355, upload-time = "2026-01-26T02:43:31.165Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/16/8c65be997fd7dd311b7d39c7b6e71a0cb449bad093761481eccbbe4b42a2/multidict-6.7.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2e2d2ed645ea29f31c4c7ea1552fcfd7cb7ba656e1eafd4134a6620c9f5fdd9e", size = 246433, upload-time = "2026-01-26T02:43:32.581Z" },
+    { url = "https://files.pythonhosted.org/packages/01/fb/4dbd7e848d2799c6a026ec88ad39cf2b8416aa167fcc903baa55ecaa045c/multidict-6.7.1-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:95922cee9a778659e91db6497596435777bd25ed116701a4c034f8e46544955a", size = 225376, upload-time = "2026-01-26T02:43:34.417Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/8a/4a3a6341eac3830f6053062f8fbc9a9e54407c80755b3f05bc427295c2d0/multidict-6.7.1-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6b83cabdc375ffaaa15edd97eb7c0c672ad788e2687004990074d7d6c9b140c8", size = 257365, upload-time = "2026-01-26T02:43:35.741Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/a2/dd575a69c1aa206e12d27d0770cdf9b92434b48a9ef0cd0d1afdecaa93c4/multidict-6.7.1-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:38fb49540705369bab8484db0689d86c0a33a0a9f2c1b197f506b71b4b6c19b0", size = 254747, upload-time = "2026-01-26T02:43:36.976Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/56/21b27c560c13822ed93133f08aa6372c53a8e067f11fbed37b4adcdac922/multidict-6.7.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:439cbebd499f92e9aa6793016a8acaa161dfa749ae86d20960189f5398a19144", size = 246293, upload-time = "2026-01-26T02:43:38.258Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/a4/23466059dc3854763423d0ad6c0f3683a379d97673b1b89ec33826e46728/multidict-6.7.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:6d3bc717b6fe763b8be3f2bee2701d3c8eb1b2a8ae9f60910f1b2860c82b6c49", size = 242962, upload-time = "2026-01-26T02:43:40.034Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/67/51dd754a3524d685958001e8fa20a0f5f90a6a856e0a9dcabff69be3dbb7/multidict-6.7.1-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:619e5a1ac57986dbfec9f0b301d865dddf763696435e2962f6d9cf2fdff2bb71", size = 237360, upload-time = "2026-01-26T02:43:41.752Z" },
+    { url = "https://files.pythonhosted.org/packages/64/3f/036dfc8c174934d4b55d86ff4f978e558b0e585cef70cfc1ad01adc6bf18/multidict-6.7.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:0b38ebffd9be37c1170d33bc0f36f4f262e0a09bc1aac1c34c7aa51a7293f0b3", size = 245940, upload-time = "2026-01-26T02:43:43.042Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/20/6214d3c105928ebc353a1c644a6ef1408bc5794fcb4f170bb524a3c16311/multidict-6.7.1-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:10ae39c9cfe6adedcdb764f5e8411d4a92b055e35573a2eaa88d3323289ef93c", size = 253502, upload-time = "2026-01-26T02:43:44.371Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/e2/c653bc4ae1be70a0f836b82172d643fcf1dade042ba2676ab08ec08bff0f/multidict-6.7.1-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:25167cc263257660290fba06b9318d2026e3c910be240a146e1f66dd114af2b0", size = 247065, upload-time = "2026-01-26T02:43:45.745Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/11/a854b4154cd3bd8b1fd375e8a8ca9d73be37610c361543d56f764109509b/multidict-6.7.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:128441d052254f42989ef98b7b6a6ecb1e6f708aa962c7984235316db59f50fa", size = 241870, upload-time = "2026-01-26T02:43:47.054Z" },
+    { url = "https://files.pythonhosted.org/packages/13/bf/9676c0392309b5fdae322333d22a829715b570edb9baa8016a517b55b558/multidict-6.7.1-cp311-cp311-win32.whl", hash = "sha256:d62b7f64ffde3b99d06b707a280db04fb3855b55f5a06df387236051d0668f4a", size = 41302, upload-time = "2026-01-26T02:43:48.753Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/68/f16a3a8ba6f7b6dc92a1f19669c0810bd2c43fc5a02da13b1cbf8e253845/multidict-6.7.1-cp311-cp311-win_amd64.whl", hash = "sha256:bdbf9f3b332abd0cdb306e7c2113818ab1e922dc84b8f8fd06ec89ed2a19ab8b", size = 45981, upload-time = "2026-01-26T02:43:49.921Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/ad/9dd5305253fa00cd3c7555dbef69d5bf4133debc53b87ab8d6a44d411665/multidict-6.7.1-cp311-cp311-win_arm64.whl", hash = "sha256:b8c990b037d2fff2f4e33d3f21b9b531c5745b33a49a7d6dbe7a177266af44f6", size = 43159, upload-time = "2026-01-26T02:43:51.635Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/9c/f20e0e2cf80e4b2e4b1c365bf5fe104ee633c751a724246262db8f1a0b13/multidict-6.7.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:a90f75c956e32891a4eda3639ce6dd86e87105271f43d43442a3aedf3cddf172", size = 76893, upload-time = "2026-01-26T02:43:52.754Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/cf/18ef143a81610136d3da8193da9d80bfe1cb548a1e2d1c775f26b23d024a/multidict-6.7.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:3fccb473e87eaa1382689053e4a4618e7ba7b9b9b8d6adf2027ee474597128cd", size = 45456, upload-time = "2026-01-26T02:43:53.893Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/65/1caac9d4cd32e8433908683446eebc953e82d22b03d10d41a5f0fefe991b/multidict-6.7.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:b0fa96985700739c4c7853a43c0b3e169360d6855780021bfc6d0f1ce7c123e7", size = 43872, upload-time = "2026-01-26T02:43:55.041Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/3b/d6bd75dc4f3ff7c73766e04e705b00ed6dbbaccf670d9e05a12b006f5a21/multidict-6.7.1-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:cb2a55f408c3043e42b40cc8eecd575afa27b7e0b956dfb190de0f8499a57a53", size = 251018, upload-time = "2026-01-26T02:43:56.198Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/80/c959c5933adedb9ac15152e4067c702a808ea183a8b64cf8f31af8ad3155/multidict-6.7.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eb0ce7b2a32d09892b3dd6cc44877a0d02a33241fafca5f25c8b6b62374f8b75", size = 258883, upload-time = "2026-01-26T02:43:57.499Z" },
+    { url = "https://files.pythonhosted.org/packages/86/85/7ed40adafea3d4f1c8b916e3b5cc3a8e07dfcdcb9cd72800f4ed3ca1b387/multidict-6.7.1-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c3a32d23520ee37bf327d1e1a656fec76a2edd5c038bf43eddfa0572ec49c60b", size = 242413, upload-time = "2026-01-26T02:43:58.755Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/57/b8565ff533e48595503c785f8361ff9a4fde4d67de25c207cd0ba3befd03/multidict-6.7.1-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9c90fed18bffc0189ba814749fdcc102b536e83a9f738a9003e569acd540a733", size = 268404, upload-time = "2026-01-26T02:44:00.216Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/50/9810c5c29350f7258180dfdcb2e52783a0632862eb334c4896ac717cebcb/multidict-6.7.1-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:da62917e6076f512daccfbbde27f46fed1c98fee202f0559adec8ee0de67f71a", size = 269456, upload-time = "2026-01-26T02:44:02.202Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/8d/5e5be3ced1d12966fefb5c4ea3b2a5b480afcea36406559442c6e31d4a48/multidict-6.7.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bfde23ef6ed9db7eaee6c37dcec08524cb43903c60b285b172b6c094711b3961", size = 256322, upload-time = "2026-01-26T02:44:03.56Z" },
+    { url = "https://files.pythonhosted.org/packages/31/6e/d8a26d81ac166a5592782d208dd90dfdc0a7a218adaa52b45a672b46c122/multidict-6.7.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3758692429e4e32f1ba0df23219cd0b4fc0a52f476726fff9337d1a57676a582", size = 253955, upload-time = "2026-01-26T02:44:04.845Z" },
+    { url = "https://files.pythonhosted.org/packages/59/4c/7c672c8aad41534ba619bcd4ade7a0dc87ed6b8b5c06149b85d3dd03f0cd/multidict-6.7.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:398c1478926eca669f2fd6a5856b6de9c0acf23a2cb59a14c0ba5844fa38077e", size = 251254, upload-time = "2026-01-26T02:44:06.133Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/bd/84c24de512cbafbdbc39439f74e967f19570ce7924e3007174a29c348916/multidict-6.7.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:c102791b1c4f3ab36ce4101154549105a53dc828f016356b3e3bcae2e3a039d3", size = 252059, upload-time = "2026-01-26T02:44:07.518Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/ba/f5449385510825b73d01c2d4087bf6d2fccc20a2d42ac34df93191d3dd03/multidict-6.7.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:a088b62bd733e2ad12c50dad01b7d0166c30287c166e137433d3b410add807a6", size = 263588, upload-time = "2026-01-26T02:44:09.382Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/11/afc7c677f68f75c84a69fe37184f0f82fce13ce4b92f49f3db280b7e92b3/multidict-6.7.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:3d51ff4785d58d3f6c91bdbffcb5e1f7ddfda557727043aa20d20ec4f65e324a", size = 259642, upload-time = "2026-01-26T02:44:10.73Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/17/ebb9644da78c4ab36403739e0e6e0e30ebb135b9caf3440825001a0bddcb/multidict-6.7.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fc5907494fccf3e7d3f94f95c91d6336b092b5fc83811720fae5e2765890dfba", size = 251377, upload-time = "2026-01-26T02:44:12.042Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/a4/840f5b97339e27846c46307f2530a2805d9d537d8b8bd416af031cad7fa0/multidict-6.7.1-cp312-cp312-win32.whl", hash = "sha256:28ca5ce2fd9716631133d0e9a9b9a745ad7f60bac2bccafb56aa380fc0b6c511", size = 41887, upload-time = "2026-01-26T02:44:14.245Z" },
+    { url = "https://files.pythonhosted.org/packages/80/31/0b2517913687895f5904325c2069d6a3b78f66cc641a86a2baf75a05dcbb/multidict-6.7.1-cp312-cp312-win_amd64.whl", hash = "sha256:fcee94dfbd638784645b066074b338bc9cc155d4b4bffa4adce1615c5a426c19", size = 46053, upload-time = "2026-01-26T02:44:15.371Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/5b/aba28e4ee4006ae4c7df8d327d31025d760ffa992ea23812a601d226e682/multidict-6.7.1-cp312-cp312-win_arm64.whl", hash = "sha256:ba0a9fb644d0c1a2194cf7ffb043bd852cea63a57f66fbd33959f7dae18517bf", size = 43307, upload-time = "2026-01-26T02:44:16.852Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/22/929c141d6c0dba87d3e1d38fbdf1ba8baba86b7776469f2bc2d3227a1e67/multidict-6.7.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:2b41f5fed0ed563624f1c17630cb9941cf2309d4df00e494b551b5f3e3d67a23", size = 76174, upload-time = "2026-01-26T02:44:18.509Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/75/bc704ae15fee974f8fccd871305e254754167dce5f9e42d88a2def741a1d/multidict-6.7.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:84e61e3af5463c19b67ced91f6c634effb89ef8bfc5ca0267f954451ed4bb6a2", size = 45116, upload-time = "2026-01-26T02:44:19.745Z" },
+    { url = "https://files.pythonhosted.org/packages/79/76/55cd7186f498ed080a18440c9013011eb548f77ae1b297206d030eb1180a/multidict-6.7.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:935434b9853c7c112eee7ac891bc4cb86455aa631269ae35442cb316790c1445", size = 43524, upload-time = "2026-01-26T02:44:21.571Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/3c/414842ef8d5a1628d68edee29ba0e5bcf235dbfb3ccd3ea303a7fe8c72ff/multidict-6.7.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:432feb25a1cb67fe82a9680b4d65fb542e4635cb3166cd9c01560651ad60f177", size = 249368, upload-time = "2026-01-26T02:44:22.803Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/32/befed7f74c458b4a525e60519fe8d87eef72bb1e99924fa2b0f9d97a221e/multidict-6.7.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e82d14e3c948952a1a85503817e038cba5905a3352de76b9a465075d072fba23", size = 256952, upload-time = "2026-01-26T02:44:24.306Z" },
+    { url = "https://files.pythonhosted.org/packages/03/d6/c878a44ba877f366630c860fdf74bfb203c33778f12b6ac274936853c451/multidict-6.7.1-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:4cfb48c6ea66c83bcaaf7e4dfa7ec1b6bbcf751b7db85a328902796dfde4c060", size = 240317, upload-time = "2026-01-26T02:44:25.772Z" },
+    { url = "https://files.pythonhosted.org/packages/68/49/57421b4d7ad2e9e60e25922b08ceb37e077b90444bde6ead629095327a6f/multidict-6.7.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1d540e51b7e8e170174555edecddbd5538105443754539193e3e1061864d444d", size = 267132, upload-time = "2026-01-26T02:44:27.648Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/fe/ec0edd52ddbcea2a2e89e174f0206444a61440b40f39704e64dc807a70bd/multidict-6.7.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:273d23f4b40f3dce4d6c8a821c741a86dec62cded82e1175ba3d99be128147ed", size = 268140, upload-time = "2026-01-26T02:44:29.588Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/73/6e1b01cbeb458807aa0831742232dbdd1fa92bfa33f52a3f176b4ff3dc11/multidict-6.7.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d624335fd4fa1c08a53f8b4be7676ebde19cd092b3895c421045ca87895b429", size = 254277, upload-time = "2026-01-26T02:44:30.902Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/b2/5fb8c124d7561a4974c342bc8c778b471ebbeb3cc17df696f034a7e9afe7/multidict-6.7.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:12fad252f8b267cc75b66e8fc51b3079604e8d43a75428ffe193cd9e2195dfd6", size = 252291, upload-time = "2026-01-26T02:44:32.31Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/96/51d4e4e06bcce92577fcd488e22600bd38e4fd59c20cb49434d054903bd2/multidict-6.7.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:03ede2a6ffbe8ef936b92cb4529f27f42be7f56afcdab5ab739cd5f27fb1cbf9", size = 250156, upload-time = "2026-01-26T02:44:33.734Z" },
+    { url = "https://files.pythonhosted.org/packages/db/6b/420e173eec5fba721a50e2a9f89eda89d9c98fded1124f8d5c675f7a0c0f/multidict-6.7.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:90efbcf47dbe33dcf643a1e400d67d59abeac5db07dc3f27d6bdeae497a2198c", size = 249742, upload-time = "2026-01-26T02:44:35.222Z" },
+    { url = "https://files.pythonhosted.org/packages/44/a3/ec5b5bd98f306bc2aa297b8c6f11a46714a56b1e6ef5ebda50a4f5d7c5fb/multidict-6.7.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:5c4b9bfc148f5a91be9244d6264c53035c8a0dcd2f51f1c3c6e30e30ebaa1c84", size = 262221, upload-time = "2026-01-26T02:44:36.604Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/f7/e8c0d0da0cd1e28d10e624604e1a36bcc3353aaebdfdc3a43c72bc683a12/multidict-6.7.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:401c5a650f3add2472d1d288c26deebc540f99e2fb83e9525007a74cd2116f1d", size = 258664, upload-time = "2026-01-26T02:44:38.008Z" },
+    { url = "https://files.pythonhosted.org/packages/52/da/151a44e8016dd33feed44f730bd856a66257c1ee7aed4f44b649fb7edeb3/multidict-6.7.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:97891f3b1b3ffbded884e2916cacf3c6fc87b66bb0dde46f7357404750559f33", size = 249490, upload-time = "2026-01-26T02:44:39.386Z" },
+    { url = "https://files.pythonhosted.org/packages/87/af/a3b86bf9630b732897f6fc3f4c4714b90aa4361983ccbdcd6c0339b21b0c/multidict-6.7.1-cp313-cp313-win32.whl", hash = "sha256:e1c5988359516095535c4301af38d8a8838534158f649c05dd1050222321bcb3", size = 41695, upload-time = "2026-01-26T02:44:41.318Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/35/e994121b0e90e46134673422dd564623f93304614f5d11886b1b3e06f503/multidict-6.7.1-cp313-cp313-win_amd64.whl", hash = "sha256:960c83bf01a95b12b08fd54324a4eb1d5b52c88932b5cba5d6e712bb3ed12eb5", size = 45884, upload-time = "2026-01-26T02:44:42.488Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/61/42d3e5dbf661242a69c97ea363f2d7b46c567da8eadef8890022be6e2ab0/multidict-6.7.1-cp313-cp313-win_arm64.whl", hash = "sha256:563fe25c678aaba333d5399408f5ec3c383ca5b663e7f774dd179a520b8144df", size = 43122, upload-time = "2026-01-26T02:44:43.664Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/b3/e6b21c6c4f314bb956016b0b3ef2162590a529b84cb831c257519e7fde44/multidict-6.7.1-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:c76c4bec1538375dad9d452d246ca5368ad6e1c9039dadcf007ae59c70619ea1", size = 83175, upload-time = "2026-01-26T02:44:44.894Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/76/23ecd2abfe0957b234f6c960f4ade497f55f2c16aeb684d4ecdbf1c95791/multidict-6.7.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:57b46b24b5d5ebcc978da4ec23a819a9402b4228b8a90d9c656422b4bdd8a963", size = 48460, upload-time = "2026-01-26T02:44:46.106Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/57/a0ed92b23f3a042c36bc4227b72b97eca803f5f1801c1ab77c8a212d455e/multidict-6.7.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:e954b24433c768ce78ab7929e84ccf3422e46deb45a4dc9f93438f8217fa2d34", size = 46930, upload-time = "2026-01-26T02:44:47.278Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/66/02ec7ace29162e447f6382c495dc95826bf931d3818799bbef11e8f7df1a/multidict-6.7.1-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3bd231490fa7217cc832528e1cd8752a96f0125ddd2b5749390f7c3ec8721b65", size = 242582, upload-time = "2026-01-26T02:44:48.604Z" },
+    { url = "https://files.pythonhosted.org/packages/58/18/64f5a795e7677670e872673aca234162514696274597b3708b2c0d276cce/multidict-6.7.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:253282d70d67885a15c8a7716f3a73edf2d635793ceda8173b9ecc21f2fb8292", size = 250031, upload-time = "2026-01-26T02:44:50.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/ed/e192291dbbe51a8290c5686f482084d31bcd9d09af24f63358c3d42fd284/multidict-6.7.1-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0b4c48648d7649c9335cf1927a8b87fa692de3dcb15faa676c6a6f1f1aabda43", size = 228596, upload-time = "2026-01-26T02:44:51.951Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/7e/3562a15a60cf747397e7f2180b0a11dc0c38d9175a650e75fa1b4d325e15/multidict-6.7.1-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:98bc624954ec4d2c7cb074b8eefc2b5d0ce7d482e410df446414355d158fe4ca", size = 257492, upload-time = "2026-01-26T02:44:53.902Z" },
+    { url = "https://files.pythonhosted.org/packages/24/02/7d0f9eae92b5249bb50ac1595b295f10e263dd0078ebb55115c31e0eaccd/multidict-6.7.1-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:1b99af4d9eec0b49927b4402bcbb58dea89d3e0db8806a4086117019939ad3dd", size = 255899, upload-time = "2026-01-26T02:44:55.316Z" },
+    { url = "https://files.pythonhosted.org/packages/00/e3/9b60ed9e23e64c73a5cde95269ef1330678e9c6e34dd4eb6b431b85b5a10/multidict-6.7.1-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6aac4f16b472d5b7dc6f66a0d49dd57b0e0902090be16594dc9ebfd3d17c47e7", size = 247970, upload-time = "2026-01-26T02:44:56.783Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/06/538e58a63ed5cfb0bd4517e346b91da32fde409d839720f664e9a4ae4f9d/multidict-6.7.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:21f830fe223215dffd51f538e78c172ed7c7f60c9b96a2bf05c4848ad49921c3", size = 245060, upload-time = "2026-01-26T02:44:58.195Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/2f/d743a3045a97c895d401e9bd29aaa09b94f5cbdf1bd561609e5a6c431c70/multidict-6.7.1-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:f5dd81c45b05518b9aa4da4aa74e1c93d715efa234fd3e8a179df611cc85e5f4", size = 235888, upload-time = "2026-01-26T02:44:59.57Z" },
+    { url = "https://files.pythonhosted.org/packages/38/83/5a325cac191ab28b63c52f14f1131f3b0a55ba3b9aa65a6d0bf2a9b921a0/multidict-6.7.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:eb304767bca2bb92fb9c5bd33cedc95baee5bb5f6c88e63706533a1c06ad08c8", size = 243554, upload-time = "2026-01-26T02:45:01.054Z" },
+    { url = "https://files.pythonhosted.org/packages/20/1f/9d2327086bd15da2725ef6aae624208e2ef828ed99892b17f60c344e57ed/multidict-6.7.1-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:c9035dde0f916702850ef66460bc4239d89d08df4d02023a5926e7446724212c", size = 252341, upload-time = "2026-01-26T02:45:02.484Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/2c/2a1aa0280cf579d0f6eed8ee5211c4f1730bd7e06c636ba2ee6aafda302e/multidict-6.7.1-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:af959b9beeb66c822380f222f0e0a1889331597e81f1ded7f374f3ecb0fd6c52", size = 246391, upload-time = "2026-01-26T02:45:03.862Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/03/7ca022ffc36c5a3f6e03b179a5ceb829be9da5783e6fe395f347c0794680/multidict-6.7.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:41f2952231456154ee479651491e94118229844dd7226541788be783be2b5108", size = 243422, upload-time = "2026-01-26T02:45:05.296Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/1d/b31650eab6c5778aceed46ba735bd97f7c7d2f54b319fa916c0f96e7805b/multidict-6.7.1-cp313-cp313t-win32.whl", hash = "sha256:df9f19c28adcb40b6aae30bbaa1478c389efd50c28d541d76760199fc1037c32", size = 47770, upload-time = "2026-01-26T02:45:06.754Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/5b/2d2d1d522e51285bd61b1e20df8f47ae1a9d80839db0b24ea783b3832832/multidict-6.7.1-cp313-cp313t-win_amd64.whl", hash = "sha256:d54ecf9f301853f2c5e802da559604b3e95bb7a3b01a9c295c6ee591b9882de8", size = 53109, upload-time = "2026-01-26T02:45:08.044Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/a3/cc409ba012c83ca024a308516703cf339bdc4b696195644a7215a5164a24/multidict-6.7.1-cp313-cp313t-win_arm64.whl", hash = "sha256:5a37ca18e360377cfda1d62f5f382ff41f2b8c4ccb329ed974cc2e1643440118", size = 45573, upload-time = "2026-01-26T02:45:09.349Z" },
+    { url = "https://files.pythonhosted.org/packages/91/cc/db74228a8be41884a567e88a62fd589a913708fcf180d029898c17a9a371/multidict-6.7.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8f333ec9c5eb1b7105e3b84b53141e66ca05a19a605368c55450b6ba208cb9ee", size = 75190, upload-time = "2026-01-26T02:45:10.651Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/22/492f2246bb5b534abd44804292e81eeaf835388901f0c574bac4eeec73c5/multidict-6.7.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:a407f13c188f804c759fc6a9f88286a565c242a76b27626594c133b82883b5c2", size = 44486, upload-time = "2026-01-26T02:45:11.938Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/4f/733c48f270565d78b4544f2baddc2fb2a245e5a8640254b12c36ac7ac68e/multidict-6.7.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0e161ddf326db5577c3a4cc2d8648f81456e8a20d40415541587a71620d7a7d1", size = 43219, upload-time = "2026-01-26T02:45:14.346Z" },
+    { url = "https://files.pythonhosted.org/packages/24/bb/2c0c2287963f4259c85e8bcbba9182ced8d7fca65c780c38e99e61629d11/multidict-6.7.1-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:1e3a8bb24342a8201d178c3b4984c26ba81a577c80d4d525727427460a50c22d", size = 245132, upload-time = "2026-01-26T02:45:15.712Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/f9/44d4b3064c65079d2467888794dea218d1601898ac50222ab8a9a8094460/multidict-6.7.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:97231140a50f5d447d3164f994b86a0bed7cd016e2682f8650d6a9158e14fd31", size = 252420, upload-time = "2026-01-26T02:45:17.293Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/13/78f7275e73fa17b24c9a51b0bd9d73ba64bb32d0ed51b02a746eb876abe7/multidict-6.7.1-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:6b10359683bd8806a200fd2909e7c8ca3a7b24ec1d8132e483d58e791d881048", size = 233510, upload-time = "2026-01-26T02:45:19.356Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/25/8167187f62ae3cbd52da7893f58cb036b47ea3fb67138787c76800158982/multidict-6.7.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:283ddac99f7ac25a4acadbf004cb5ae34480bbeb063520f70ce397b281859362", size = 264094, upload-time = "2026-01-26T02:45:20.834Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/e7/69a3a83b7b030cf283fb06ce074a05a02322359783424d7edf0f15fe5022/multidict-6.7.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:538cec1e18c067d0e6103aa9a74f9e832904c957adc260e61cd9d8cf0c3b3d37", size = 260786, upload-time = "2026-01-26T02:45:22.818Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/3b/8ec5074bcfc450fe84273713b4b0a0dd47c0249358f5d82eb8104ffe2520/multidict-6.7.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7eee46ccb30ff48a1e35bb818cc90846c6be2b68240e42a78599166722cea709", size = 248483, upload-time = "2026-01-26T02:45:24.368Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5a/d5a99e3acbca0e29c5d9cba8f92ceb15dce78bab963b308ae692981e3a5d/multidict-6.7.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:fa263a02f4f2dd2d11a7b1bb4362aa7cb1049f84a9235d31adf63f30143469a0", size = 248403, upload-time = "2026-01-26T02:45:25.982Z" },
+    { url = "https://files.pythonhosted.org/packages/35/48/e58cd31f6c7d5102f2a4bf89f96b9cf7e00b6c6f3d04ecc44417c00a5a3c/multidict-6.7.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:2e1425e2f99ec5bd36c15a01b690a1a2456209c5deed58f95469ffb46039ccbb", size = 240315, upload-time = "2026-01-26T02:45:27.487Z" },
+    { url = "https://files.pythonhosted.org/packages/94/33/1cd210229559cb90b6786c30676bb0c58249ff42f942765f88793b41fdce/multidict-6.7.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:497394b3239fc6f0e13a78a3e1b61296e72bf1c5f94b4c4eb80b265c37a131cd", size = 245528, upload-time = "2026-01-26T02:45:28.991Z" },
+    { url = "https://files.pythonhosted.org/packages/64/f2/6e1107d226278c876c783056b7db43d800bb64c6131cec9c8dfb6903698e/multidict-6.7.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:233b398c29d3f1b9676b4b6f75c518a06fcb2ea0b925119fb2c1bc35c05e1601", size = 258784, upload-time = "2026-01-26T02:45:30.503Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/c1/11f664f14d525e4a1b5327a82d4de61a1db604ab34c6603bb3c2cc63ad34/multidict-6.7.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:93b1818e4a6e0930454f0f2af7dfce69307ca03cdcfb3739bf4d91241967b6c1", size = 251980, upload-time = "2026-01-26T02:45:32.603Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/9f/75a9ac888121d0c5bbd4ecf4eead45668b1766f6baabfb3b7f66a410e231/multidict-6.7.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f33dc2a3abe9249ea5d8360f969ec7f4142e7ac45ee7014d8f8d5acddf178b7b", size = 243602, upload-time = "2026-01-26T02:45:34.043Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e7/50bf7b004cc8525d80dbbbedfdc7aed3e4c323810890be4413e589074032/multidict-6.7.1-cp314-cp314-win32.whl", hash = "sha256:3ab8b9d8b75aef9df299595d5388b14530839f6422333357af1339443cff777d", size = 40930, upload-time = "2026-01-26T02:45:36.278Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/bf/52f25716bbe93745595800f36fb17b73711f14da59ed0bb2eba141bc9f0f/multidict-6.7.1-cp314-cp314-win_amd64.whl", hash = "sha256:5e01429a929600e7dab7b166062d9bb54a5eed752384c7384c968c2afab8f50f", size = 45074, upload-time = "2026-01-26T02:45:37.546Z" },
+    { url = "https://files.pythonhosted.org/packages/97/ab/22803b03285fa3a525f48217963da3a65ae40f6a1b6f6cf2768879e208f9/multidict-6.7.1-cp314-cp314-win_arm64.whl", hash = "sha256:4885cb0e817aef5d00a2e8451d4665c1808378dc27c2705f1bf4ef8505c0d2e5", size = 42471, upload-time = "2026-01-26T02:45:38.889Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/6d/f9293baa6146ba9507e360ea0292b6422b016907c393e2f63fc40ab7b7b5/multidict-6.7.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:0458c978acd8e6ea53c81eefaddbbee9c6c5e591f41b3f5e8e194780fe026581", size = 82401, upload-time = "2026-01-26T02:45:40.254Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/68/53b5494738d83558d87c3c71a486504d8373421c3e0dbb6d0db48ad42ee0/multidict-6.7.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:c0abd12629b0af3cf590982c0b413b1e7395cd4ec026f30986818ab95bfaa94a", size = 48143, upload-time = "2026-01-26T02:45:41.635Z" },
+    { url = "https://files.pythonhosted.org/packages/37/e8/5284c53310dcdc99ce5d66563f6e5773531a9b9fe9ec7a615e9bc306b05f/multidict-6.7.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:14525a5f61d7d0c94b368a42cff4c9a4e7ba2d52e2672a7b23d84dc86fb02b0c", size = 46507, upload-time = "2026-01-26T02:45:42.99Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/fc/6800d0e5b3875568b4083ecf5f310dcf91d86d52573160834fb4bfcf5e4f/multidict-6.7.1-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:17307b22c217b4cf05033dabefe68255a534d637c6c9b0cc8382718f87be4262", size = 239358, upload-time = "2026-01-26T02:45:44.376Z" },
+    { url = "https://files.pythonhosted.org/packages/41/75/4ad0973179361cdf3a113905e6e088173198349131be2b390f9fa4da5fc6/multidict-6.7.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7a7e590ff876a3eaf1c02a4dfe0724b6e69a9e9de6d8f556816f29c496046e59", size = 246884, upload-time = "2026-01-26T02:45:47.167Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/9c/095bb28b5da139bd41fb9a5d5caff412584f377914bd8787c2aa98717130/multidict-6.7.1-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:5fa6a95dfee63893d80a34758cd0e0c118a30b8dcb46372bf75106c591b77889", size = 225878, upload-time = "2026-01-26T02:45:48.698Z" },
+    { url = "https://files.pythonhosted.org/packages/07/d0/c0a72000243756e8f5a277b6b514fa005f2c73d481b7d9e47cd4568aa2e4/multidict-6.7.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a0543217a6a017692aa6ae5cc39adb75e587af0f3a82288b1492eb73dd6cc2a4", size = 253542, upload-time = "2026-01-26T02:45:50.164Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/6b/f69da15289e384ecf2a68837ec8b5ad8c33e973aa18b266f50fe55f24b8c/multidict-6.7.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f99fe611c312b3c1c0ace793f92464d8cd263cc3b26b5721950d977b006b6c4d", size = 252403, upload-time = "2026-01-26T02:45:51.779Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/76/b9669547afa5a1a25cd93eaca91c0da1c095b06b6d2d8ec25b713588d3a1/multidict-6.7.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9004d8386d133b7e6135679424c91b0b854d2d164af6ea3f289f8f2761064609", size = 244889, upload-time = "2026-01-26T02:45:53.27Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/a9/a50d2669e506dad33cfc45b5d574a205587b7b8a5f426f2fbb2e90882588/multidict-6.7.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e628ef0e6859ffd8273c69412a2465c4be4a9517d07261b33334b5ec6f3c7489", size = 241982, upload-time = "2026-01-26T02:45:54.919Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/bb/1609558ad8b456b4827d3c5a5b775c93b87878fd3117ed3db3423dfbce1b/multidict-6.7.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:841189848ba629c3552035a6a7f5bf3b02eb304e9fea7492ca220a8eda6b0e5c", size = 232415, upload-time = "2026-01-26T02:45:56.981Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/59/6f61039d2aa9261871e03ab9dc058a550d240f25859b05b67fd70f80d4b3/multidict-6.7.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:ce1bbd7d780bb5a0da032e095c951f7014d6b0a205f8318308140f1a6aba159e", size = 240337, upload-time = "2026-01-26T02:45:58.698Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/29/fdc6a43c203890dc2ae9249971ecd0c41deaedfe00d25cb6564b2edd99eb/multidict-6.7.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:b26684587228afed0d50cf804cc71062cc9c1cdf55051c4c6345d372947b268c", size = 248788, upload-time = "2026-01-26T02:46:00.862Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/14/a153a06101323e4cf086ecee3faadba52ff71633d471f9685c42e3736163/multidict-6.7.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:9f9af11306994335398293f9958071019e3ab95e9a707dc1383a35613f6abcb9", size = 242842, upload-time = "2026-01-26T02:46:02.824Z" },
+    { url = "https://files.pythonhosted.org/packages/41/5f/604ae839e64a4a6efc80db94465348d3b328ee955e37acb24badbcd24d83/multidict-6.7.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b4938326284c4f1224178a560987b6cf8b4d38458b113d9b8c1db1a836e640a2", size = 240237, upload-time = "2026-01-26T02:46:05.898Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/60/c3a5187bf66f6fb546ff4ab8fb5a077cbdd832d7b1908d4365c7f74a1917/multidict-6.7.1-cp314-cp314t-win32.whl", hash = "sha256:98655c737850c064a65e006a3df7c997cd3b220be4ec8fe26215760b9697d4d7", size = 48008, upload-time = "2026-01-26T02:46:07.468Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/f7/addf1087b860ac60e6f382240f64fb99f8bfb532bb06f7c542b83c29ca61/multidict-6.7.1-cp314-cp314t-win_amd64.whl", hash = "sha256:497bde6223c212ba11d462853cfa4f0ae6ef97465033e7dc9940cdb3ab5b48e5", size = 53542, upload-time = "2026-01-26T02:46:08.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/81/4629d0aa32302ef7b2ec65c75a728cc5ff4fa410c50096174c1632e70b3e/multidict-6.7.1-cp314-cp314t-win_arm64.whl", hash = "sha256:2bbd113e0d4af5db41d5ebfe9ccaff89de2120578164f86a5d17d5a576d1e5b2", size = 44719, upload-time = "2026-01-26T02:46:11.146Z" },
+    { url = "https://files.pythonhosted.org/packages/81/08/7036c080d7117f28a4af526d794aab6a84463126db031b007717c1a6676e/multidict-6.7.1-py3-none-any.whl", hash = "sha256:55d97cc6dae627efa6a6e548885712d4864b81110ac76fa4e534c03819fa4a56", size = 12319, upload-time = "2026-01-26T02:46:44.004Z" },
+]
+
+[[package]]
+name = "networkx"
+version = "3.4.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fd/1d/06475e1cd5264c0b870ea2cc6fdb3e37177c1e565c43f56ff17a10e3937f/networkx-3.4.2.tar.gz", hash = "sha256:307c3669428c5362aab27c8a1260aa8f47c4e91d3891f48be0141738d8d053e1", size = 2151368, upload-time = "2024-10-21T12:39:38.695Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b9/54/dd730b32ea14ea797530a4479b2ed46a6fb250f682a9cfb997e968bf0261/networkx-3.4.2-py3-none-any.whl", hash = "sha256:df5d4365b724cf81b8c6a7312509d0c22386097011ad1abe274afd5e9d3bbc5f", size = 1723263, upload-time = "2024-10-21T12:39:36.247Z" },
+]
+
+[[package]]
+name = "networkx"
+version = "3.6.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/6a/51/63fe664f3908c97be9d2e4f1158eb633317598cfa6e1fc14af5383f17512/networkx-3.6.1.tar.gz", hash = "sha256:26b7c357accc0c8cde558ad486283728b65b6a95d85ee1cd66bafab4c8168509", size = 2517025, upload-time = "2025-12-08T17:02:39.908Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/c9/b2622292ea83fbb4ec318f5b9ab867d0a28ab43c5717bb85b0a5f6b3b0a4/networkx-3.6.1-py3-none-any.whl", hash = "sha256:d47fbf302e7d9cbbb9e2555a0d267983d2aa476bac30e90dfbe5669bd57f3762", size = 2068504, upload-time = "2025-12-08T17:02:38.159Z" },
+]
+
+[[package]]
+name = "numpy"
+version = "2.2.6"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/76/21/7d2a95e4bba9dc13d043ee156a356c0a8f0c6309dff6b21b4d71a073b8a8/numpy-2.2.6.tar.gz", hash = "sha256:e29554e2bef54a90aa5cc07da6ce955accb83f21ab5de01a62c8478897b264fd", size = 20276440, upload-time = "2025-05-17T22:38:04.611Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9a/3e/ed6db5be21ce87955c0cbd3009f2803f59fa08df21b5df06862e2d8e2bdd/numpy-2.2.6-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b412caa66f72040e6d268491a59f2c43bf03eb6c96dd8f0307829feb7fa2b6fb", size = 21165245, upload-time = "2025-05-17T21:27:58.555Z" },
+    { url = "https://files.pythonhosted.org/packages/22/c2/4b9221495b2a132cc9d2eb862e21d42a009f5a60e45fc44b00118c174bff/numpy-2.2.6-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8e41fd67c52b86603a91c1a505ebaef50b3314de0213461c7a6e99c9a3beff90", size = 14360048, upload-time = "2025-05-17T21:28:21.406Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/77/dc2fcfc66943c6410e2bf598062f5959372735ffda175b39906d54f02349/numpy-2.2.6-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:37e990a01ae6ec7fe7fa1c26c55ecb672dd98b19c3d0e1d1f326fa13cb38d163", size = 5340542, upload-time = "2025-05-17T21:28:30.931Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/4f/1cb5fdc353a5f5cc7feb692db9b8ec2c3d6405453f982435efc52561df58/numpy-2.2.6-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:5a6429d4be8ca66d889b7cf70f536a397dc45ba6faeb5f8c5427935d9592e9cf", size = 6878301, upload-time = "2025-05-17T21:28:41.613Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/17/96a3acd228cec142fcb8723bd3cc39c2a474f7dcf0a5d16731980bcafa95/numpy-2.2.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:efd28d4e9cd7d7a8d39074a4d44c63eda73401580c5c76acda2ce969e0a38e83", size = 14297320, upload-time = "2025-05-17T21:29:02.78Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/63/3de6a34ad7ad6646ac7d2f55ebc6ad439dbbf9c4370017c50cf403fb19b5/numpy-2.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fc7b73d02efb0e18c000e9ad8b83480dfcd5dfd11065997ed4c6747470ae8915", size = 16801050, upload-time = "2025-05-17T21:29:27.675Z" },
+    { url = "https://files.pythonhosted.org/packages/07/b6/89d837eddef52b3d0cec5c6ba0456c1bf1b9ef6a6672fc2b7873c3ec4e2e/numpy-2.2.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:74d4531beb257d2c3f4b261bfb0fc09e0f9ebb8842d82a7b4209415896adc680", size = 15807034, upload-time = "2025-05-17T21:29:51.102Z" },
+    { url = "https://files.pythonhosted.org/packages/01/c8/dc6ae86e3c61cfec1f178e5c9f7858584049b6093f843bca541f94120920/numpy-2.2.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:8fc377d995680230e83241d8a96def29f204b5782f371c532579b4f20607a289", size = 18614185, upload-time = "2025-05-17T21:30:18.703Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/c5/0064b1b7e7c89137b471ccec1fd2282fceaae0ab3a9550f2568782d80357/numpy-2.2.6-cp310-cp310-win32.whl", hash = "sha256:b093dd74e50a8cba3e873868d9e93a85b78e0daf2e98c6797566ad8044e8363d", size = 6527149, upload-time = "2025-05-17T21:30:29.788Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/dd/4b822569d6b96c39d1215dbae0582fd99954dcbcf0c1a13c61783feaca3f/numpy-2.2.6-cp310-cp310-win_amd64.whl", hash = "sha256:f0fd6321b839904e15c46e0d257fdd101dd7f530fe03fd6359c1ea63738703f3", size = 12904620, upload-time = "2025-05-17T21:30:48.994Z" },
+    { url = "https://files.pythonhosted.org/packages/da/a8/4f83e2aa666a9fbf56d6118faaaf5f1974d456b1823fda0a176eff722839/numpy-2.2.6-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f9f1adb22318e121c5c69a09142811a201ef17ab257a1e66ca3025065b7f53ae", size = 21176963, upload-time = "2025-05-17T21:31:19.36Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/2b/64e1affc7972decb74c9e29e5649fac940514910960ba25cd9af4488b66c/numpy-2.2.6-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c820a93b0255bc360f53eca31a0e676fd1101f673dda8da93454a12e23fc5f7a", size = 14406743, upload-time = "2025-05-17T21:31:41.087Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/9f/0121e375000b5e50ffdd8b25bf78d8e1a5aa4cca3f185d41265198c7b834/numpy-2.2.6-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:3d70692235e759f260c3d837193090014aebdf026dfd167834bcba43e30c2a42", size = 5352616, upload-time = "2025-05-17T21:31:50.072Z" },
+    { url = "https://files.pythonhosted.org/packages/31/0d/b48c405c91693635fbe2dcd7bc84a33a602add5f63286e024d3b6741411c/numpy-2.2.6-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:481b49095335f8eed42e39e8041327c05b0f6f4780488f61286ed3c01368d491", size = 6889579, upload-time = "2025-05-17T21:32:01.712Z" },
+    { url = "https://files.pythonhosted.org/packages/52/b8/7f0554d49b565d0171eab6e99001846882000883998e7b7d9f0d98b1f934/numpy-2.2.6-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b64d8d4d17135e00c8e346e0a738deb17e754230d7e0810ac5012750bbd85a5a", size = 14312005, upload-time = "2025-05-17T21:32:23.332Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/dd/2238b898e51bd6d389b7389ffb20d7f4c10066d80351187ec8e303a5a475/numpy-2.2.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba10f8411898fc418a521833e014a77d3ca01c15b0c6cdcce6a0d2897e6dbbdf", size = 16821570, upload-time = "2025-05-17T21:32:47.991Z" },
+    { url = "https://files.pythonhosted.org/packages/83/6c/44d0325722cf644f191042bf47eedad61c1e6df2432ed65cbe28509d404e/numpy-2.2.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:bd48227a919f1bafbdda0583705e547892342c26fb127219d60a5c36882609d1", size = 15818548, upload-time = "2025-05-17T21:33:11.728Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/9d/81e8216030ce66be25279098789b665d49ff19eef08bfa8cb96d4957f422/numpy-2.2.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:9551a499bf125c1d4f9e250377c1ee2eddd02e01eac6644c080162c0c51778ab", size = 18620521, upload-time = "2025-05-17T21:33:39.139Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/fd/e19617b9530b031db51b0926eed5345ce8ddc669bb3bc0044b23e275ebe8/numpy-2.2.6-cp311-cp311-win32.whl", hash = "sha256:0678000bb9ac1475cd454c6b8c799206af8107e310843532b04d49649c717a47", size = 6525866, upload-time = "2025-05-17T21:33:50.273Z" },
+    { url = "https://files.pythonhosted.org/packages/31/0a/f354fb7176b81747d870f7991dc763e157a934c717b67b58456bc63da3df/numpy-2.2.6-cp311-cp311-win_amd64.whl", hash = "sha256:e8213002e427c69c45a52bbd94163084025f533a55a59d6f9c5b820774ef3303", size = 12907455, upload-time = "2025-05-17T21:34:09.135Z" },
+    { url = "https://files.pythonhosted.org/packages/82/5d/c00588b6cf18e1da539b45d3598d3557084990dcc4331960c15ee776ee41/numpy-2.2.6-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:41c5a21f4a04fa86436124d388f6ed60a9343a6f767fced1a8a71c3fbca038ff", size = 20875348, upload-time = "2025-05-17T21:34:39.648Z" },
+    { url = "https://files.pythonhosted.org/packages/66/ee/560deadcdde6c2f90200450d5938f63a34b37e27ebff162810f716f6a230/numpy-2.2.6-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:de749064336d37e340f640b05f24e9e3dd678c57318c7289d222a8a2f543e90c", size = 14119362, upload-time = "2025-05-17T21:35:01.241Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/65/4baa99f1c53b30adf0acd9a5519078871ddde8d2339dc5a7fde80d9d87da/numpy-2.2.6-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:894b3a42502226a1cac872f840030665f33326fc3dac8e57c607905773cdcde3", size = 5084103, upload-time = "2025-05-17T21:35:10.622Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/89/e5a34c071a0570cc40c9a54eb472d113eea6d002e9ae12bb3a8407fb912e/numpy-2.2.6-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:71594f7c51a18e728451bb50cc60a3ce4e6538822731b2933209a1f3614e9282", size = 6625382, upload-time = "2025-05-17T21:35:21.414Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/35/8c80729f1ff76b3921d5c9487c7ac3de9b2a103b1cd05e905b3090513510/numpy-2.2.6-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f2618db89be1b4e05f7a1a847a9c1c0abd63e63a1607d892dd54668dd92faf87", size = 14018462, upload-time = "2025-05-17T21:35:42.174Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/3d/1e1db36cfd41f895d266b103df00ca5b3cbe965184df824dec5c08c6b803/numpy-2.2.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd83c01228a688733f1ded5201c678f0c53ecc1006ffbc404db9f7a899ac6249", size = 16527618, upload-time = "2025-05-17T21:36:06.711Z" },
+    { url = "https://files.pythonhosted.org/packages/61/c6/03ed30992602c85aa3cd95b9070a514f8b3c33e31124694438d88809ae36/numpy-2.2.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:37c0ca431f82cd5fa716eca9506aefcabc247fb27ba69c5062a6d3ade8cf8f49", size = 15505511, upload-time = "2025-05-17T21:36:29.965Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/25/5761d832a81df431e260719ec45de696414266613c9ee268394dd5ad8236/numpy-2.2.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fe27749d33bb772c80dcd84ae7e8df2adc920ae8297400dabec45f0dedb3f6de", size = 18313783, upload-time = "2025-05-17T21:36:56.883Z" },
+    { url = "https://files.pythonhosted.org/packages/57/0a/72d5a3527c5ebffcd47bde9162c39fae1f90138c961e5296491ce778e682/numpy-2.2.6-cp312-cp312-win32.whl", hash = "sha256:4eeaae00d789f66c7a25ac5f34b71a7035bb474e679f410e5e1a94deb24cf2d4", size = 6246506, upload-time = "2025-05-17T21:37:07.368Z" },
+    { url = "https://files.pythonhosted.org/packages/36/fa/8c9210162ca1b88529ab76b41ba02d433fd54fecaf6feb70ef9f124683f1/numpy-2.2.6-cp312-cp312-win_amd64.whl", hash = "sha256:c1f9540be57940698ed329904db803cf7a402f3fc200bfe599334c9bd84a40b2", size = 12614190, upload-time = "2025-05-17T21:37:26.213Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/5c/6657823f4f594f72b5471f1db1ab12e26e890bb2e41897522d134d2a3e81/numpy-2.2.6-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0811bb762109d9708cca4d0b13c4f67146e3c3b7cf8d34018c722adb2d957c84", size = 20867828, upload-time = "2025-05-17T21:37:56.699Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/9e/14520dc3dadf3c803473bd07e9b2bd1b69bc583cb2497b47000fed2fa92f/numpy-2.2.6-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:287cc3162b6f01463ccd86be154f284d0893d2b3ed7292439ea97eafa8170e0b", size = 14143006, upload-time = "2025-05-17T21:38:18.291Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/06/7e96c57d90bebdce9918412087fc22ca9851cceaf5567a45c1f404480e9e/numpy-2.2.6-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:f1372f041402e37e5e633e586f62aa53de2eac8d98cbfb822806ce4bbefcb74d", size = 5076765, upload-time = "2025-05-17T21:38:27.319Z" },
+    { url = "https://files.pythonhosted.org/packages/73/ed/63d920c23b4289fdac96ddbdd6132e9427790977d5457cd132f18e76eae0/numpy-2.2.6-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:55a4d33fa519660d69614a9fad433be87e5252f4b03850642f88993f7b2ca566", size = 6617736, upload-time = "2025-05-17T21:38:38.141Z" },
+    { url = "https://files.pythonhosted.org/packages/85/c5/e19c8f99d83fd377ec8c7e0cf627a8049746da54afc24ef0a0cb73d5dfb5/numpy-2.2.6-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f92729c95468a2f4f15e9bb94c432a9229d0d50de67304399627a943201baa2f", size = 14010719, upload-time = "2025-05-17T21:38:58.433Z" },
+    { url = "https://files.pythonhosted.org/packages/19/49/4df9123aafa7b539317bf6d342cb6d227e49f7a35b99c287a6109b13dd93/numpy-2.2.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1bc23a79bfabc5d056d106f9befb8d50c31ced2fbc70eedb8155aec74a45798f", size = 16526072, upload-time = "2025-05-17T21:39:22.638Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/6c/04b5f47f4f32f7c2b0e7260442a8cbcf8168b0e1a41ff1495da42f42a14f/numpy-2.2.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e3143e4451880bed956e706a3220b4e5cf6172ef05fcc397f6f36a550b1dd868", size = 15503213, upload-time = "2025-05-17T21:39:45.865Z" },
+    { url = "https://files.pythonhosted.org/packages/17/0a/5cd92e352c1307640d5b6fec1b2ffb06cd0dabe7d7b8227f97933d378422/numpy-2.2.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b4f13750ce79751586ae2eb824ba7e1e8dba64784086c98cdbbcc6a42112ce0d", size = 18316632, upload-time = "2025-05-17T21:40:13.331Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/3b/5cba2b1d88760ef86596ad0f3d484b1cbff7c115ae2429678465057c5155/numpy-2.2.6-cp313-cp313-win32.whl", hash = "sha256:5beb72339d9d4fa36522fc63802f469b13cdbe4fdab4a288f0c441b74272ebfd", size = 6244532, upload-time = "2025-05-17T21:43:46.099Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/3b/d58c12eafcb298d4e6d0d40216866ab15f59e55d148a5658bb3132311fcf/numpy-2.2.6-cp313-cp313-win_amd64.whl", hash = "sha256:b0544343a702fa80c95ad5d3d608ea3599dd54d4632df855e4c8d24eb6ecfa1c", size = 12610885, upload-time = "2025-05-17T21:44:05.145Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/9e/4bf918b818e516322db999ac25d00c75788ddfd2d2ade4fa66f1f38097e1/numpy-2.2.6-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0bca768cd85ae743b2affdc762d617eddf3bcf8724435498a1e80132d04879e6", size = 20963467, upload-time = "2025-05-17T21:40:44Z" },
+    { url = "https://files.pythonhosted.org/packages/61/66/d2de6b291507517ff2e438e13ff7b1e2cdbdb7cb40b3ed475377aece69f9/numpy-2.2.6-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:fc0c5673685c508a142ca65209b4e79ed6740a4ed6b2267dbba90f34b0b3cfda", size = 14225144, upload-time = "2025-05-17T21:41:05.695Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/25/480387655407ead912e28ba3a820bc69af9adf13bcbe40b299d454ec011f/numpy-2.2.6-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:5bd4fc3ac8926b3819797a7c0e2631eb889b4118a9898c84f585a54d475b7e40", size = 5200217, upload-time = "2025-05-17T21:41:15.903Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/4a/6e313b5108f53dcbf3aca0c0f3e9c92f4c10ce57a0a721851f9785872895/numpy-2.2.6-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:fee4236c876c4e8369388054d02d0e9bb84821feb1a64dd59e137e6511a551f8", size = 6712014, upload-time = "2025-05-17T21:41:27.321Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/30/172c2d5c4be71fdf476e9de553443cf8e25feddbe185e0bd88b096915bcc/numpy-2.2.6-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e1dda9c7e08dc141e0247a5b8f49cf05984955246a327d4c48bda16821947b2f", size = 14077935, upload-time = "2025-05-17T21:41:49.738Z" },
+    { url = "https://files.pythonhosted.org/packages/12/fb/9e743f8d4e4d3c710902cf87af3512082ae3d43b945d5d16563f26ec251d/numpy-2.2.6-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f447e6acb680fd307f40d3da4852208af94afdfab89cf850986c3ca00562f4fa", size = 16600122, upload-time = "2025-05-17T21:42:14.046Z" },
+    { url = "https://files.pythonhosted.org/packages/12/75/ee20da0e58d3a66f204f38916757e01e33a9737d0b22373b3eb5a27358f9/numpy-2.2.6-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:389d771b1623ec92636b0786bc4ae56abafad4a4c513d36a55dce14bd9ce8571", size = 15586143, upload-time = "2025-05-17T21:42:37.464Z" },
+    { url = "https://files.pythonhosted.org/packages/76/95/bef5b37f29fc5e739947e9ce5179ad402875633308504a52d188302319c8/numpy-2.2.6-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8e9ace4a37db23421249ed236fdcdd457d671e25146786dfc96835cd951aa7c1", size = 18385260, upload-time = "2025-05-17T21:43:05.189Z" },
+    { url = "https://files.pythonhosted.org/packages/09/04/f2f83279d287407cf36a7a8053a5abe7be3622a4363337338f2585e4afda/numpy-2.2.6-cp313-cp313t-win32.whl", hash = "sha256:038613e9fb8c72b0a41f025a7e4c3f0b7a1b5d768ece4796b674c8f3fe13efff", size = 6377225, upload-time = "2025-05-17T21:43:16.254Z" },
+    { url = "https://files.pythonhosted.org/packages/67/0e/35082d13c09c02c011cf21570543d202ad929d961c02a147493cb0c2bdf5/numpy-2.2.6-cp313-cp313t-win_amd64.whl", hash = "sha256:6031dd6dfecc0cf9f668681a37648373bddd6421fff6c66ec1624eed0180ee06", size = 12771374, upload-time = "2025-05-17T21:43:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/3b/d94a75f4dbf1ef5d321523ecac21ef23a3cd2ac8b78ae2aac40873590229/numpy-2.2.6-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:0b605b275d7bd0c640cad4e5d30fa701a8d59302e127e5f79138ad62762c3e3d", size = 21040391, upload-time = "2025-05-17T21:44:35.948Z" },
+    { url = "https://files.pythonhosted.org/packages/17/f4/09b2fa1b58f0fb4f7c7963a1649c64c4d315752240377ed74d9cd878f7b5/numpy-2.2.6-pp310-pypy310_pp73-macosx_14_0_x86_64.whl", hash = "sha256:7befc596a7dc9da8a337f79802ee8adb30a552a94f792b9c9d18c840055907db", size = 6786754, upload-time = "2025-05-17T21:44:47.446Z" },
+    { url = "https://files.pythonhosted.org/packages/af/30/feba75f143bdc868a1cc3f44ccfa6c4b9ec522b36458e738cd00f67b573f/numpy-2.2.6-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce47521a4754c8f4593837384bd3424880629f718d87c5d44f8ed763edd63543", size = 16643476, upload-time = "2025-05-17T21:45:11.871Z" },
+    { url = "https://files.pythonhosted.org/packages/37/48/ac2a9584402fb6c0cd5b5d1a91dcf176b15760130dd386bbafdbfe3640bf/numpy-2.2.6-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:d042d24c90c41b54fd506da306759e06e568864df8ec17ccc17e9e884634fd00", size = 12812666, upload-time = "2025-05-17T21:45:31.426Z" },
+]
+
+[[package]]
+name = "numpy"
+version = "2.4.6"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d0/ad/fed0499ce6a338d2a03ebae59cd15093910c8875328855781952abf6c2fe/numpy-2.4.6.tar.gz", hash = "sha256:f3a3570c4a2a16746ac2c31a7c7c7b0c186b95ce902e33db6f28094ed7387dda", size = 20735807, upload-time = "2026-05-18T23:37:14.07Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/49/ec46835a70be8fa6446c495126ac84fdb28cb2558e1620ffb87a10c8b64c/numpy-2.4.6-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:0280e0356c0829a18d9de1cb7eee50ec22ca639878d7240307ca0943d73cd2c4", size = 16969194, upload-time = "2026-05-18T23:33:13.503Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/0d/f5957185c0ee2f3e12f78715aa9e3b353fd83633316c8532b38faa37e3f6/numpy-2.4.6-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:110f8b71aacb688ec69062bb7f6938a0f8acb01b7c1c4beb453c65b6d234584d", size = 14964111, upload-time = "2026-05-18T23:33:17.795Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/40/40a40ee0ddf7ceb782c49af278894b686e586d65d8c1889c8b5da01a3d7d/numpy-2.4.6-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:4cfe66903cc32a9921a6733d96b19bb6abf310397581bbad89c228f5abaf0ee8", size = 5469159, upload-time = "2026-05-18T23:33:20.654Z" },
+    { url = "https://files.pythonhosted.org/packages/63/13/f9a8046535cb21deae82f8d03de9617e08882d274fad2539630761888228/numpy-2.4.6-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:8155154c7c691289fe18f510b5d4657c68c67989f293f0535a91360392ff6538", size = 6798936, upload-time = "2026-05-18T23:33:22.987Z" },
+    { url = "https://files.pythonhosted.org/packages/33/a8/6fa8c1a345a8c85dbb21932c447bee07c30a2c2a3f31e369c0a84b300147/numpy-2.4.6-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ab0a9c4ffb1a6d95ef519fe4247dba8eb6b18ad93999f76b7f657039acabd47", size = 15966692, upload-time = "2026-05-18T23:33:26.62Z" },
+    { url = "https://files.pythonhosted.org/packages/02/03/74fe2a4cb3817d94d86402f2506554130a2f01414e299b5a843e5a8a957f/numpy-2.4.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:89cd468399cfd2504718f0ba50e410dca55a170b61a02ad92bb18c8a65186e93", size = 16918164, upload-time = "2026-05-18T23:33:29.955Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/80/3615be3313f7e7696609bc194b9f0101da809df79e859bdb84e0cd043f46/numpy-2.4.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c2d37ab77531417474168eb79d6d80b14f821a966818505d03013d0833edb7a8", size = 17322877, upload-time = "2026-05-18T23:33:34.724Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/ac/a691e0fe2675e370d0e08ff905adc49a1c8830e8cae03efe4477e92cd55d/numpy-2.4.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f407cb6b8e9d6d8c626bc73c945db1706035af8fd632295547bf1c9e46d092d6", size = 18651487, upload-time = "2026-05-18T23:33:38.217Z" },
+    { url = "https://files.pythonhosted.org/packages/15/a7/9bc1cd626d7bf6869bfedf27b91b6ab5dd607758bf8e959d6fa80c6a59cb/numpy-2.4.6-cp311-cp311-win32.whl", hash = "sha256:ddea102b48f9e339f3948bf22040944184627a30fdf7f858667673b9c5f033c8", size = 6233945, upload-time = "2026-05-18T23:33:41.331Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/31/7fc6239c12bce7e931463251cca4426c465e1876ba3cc785402ef4dd8f4e/numpy-2.4.6-cp311-cp311-win_amd64.whl", hash = "sha256:1e254a00cdf42b1e4d5b3d68d33af63268d41340d8885df2ab6470f2e1500147", size = 12608406, upload-time = "2026-05-18T23:33:44.131Z" },
+    { url = "https://files.pythonhosted.org/packages/27/83/140f85a466595a16382996a1bf06b2b54bcd597488921b0c9daaeeda72af/numpy-2.4.6-cp311-cp311-win_arm64.whl", hash = "sha256:ed9749eef4cbd126da3dc1d6bcb3a57f5eb7ac6a6484146bdbf743f552dfc577", size = 10479528, upload-time = "2026-05-18T23:33:50.725Z" },
+    { url = "https://files.pythonhosted.org/packages/95/2a/3d7b5ac8aac24feaf9ad7ed58f45b0bbc06d37e4338ae84c9f2298b570f9/numpy-2.4.6-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:001fbb8e08d942dd57599e781f2472269ee7f2755fae407b4f67b2f0b17da3f1", size = 16689119, upload-time = "2026-05-18T23:33:54.065Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/12/92c4c131527599e8288d6918e888d88726f84d805d784b771f32408aeaef/numpy-2.4.6-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ebfb099f8dcf083deef3ac1ca4c1503f387cf76296fcb3816b66f5ecb5f54fdb", size = 14699246, upload-time = "2026-05-18T23:33:57.621Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/fe/c0a6b7b2ca128a8fb228575147073b660656734b8ebe4d76c8fd748dcc79/numpy-2.4.6-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:3213d622a0283a39a93d188f3cf72b26862df52fbb4ca3697f51705016523d41", size = 5204410, upload-time = "2026-05-18T23:34:00.302Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d4/9770d14ba719432bb90a421bfd443872ed0f70f7264b64bec12ea363d5fd/numpy-2.4.6-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:357cc07a6d7b0b182ff02249616a03742827ebb1277546b5c7cd7f7620a45698", size = 6551240, upload-time = "2026-05-18T23:34:02.852Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/c6/50a46a6205feba2343f1d6d17438107c5dc491ed1c736e6ea68689fd906b/numpy-2.4.6-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f9fb9157b4ce2971008323afe46053787b526ef624fea915b261468a8421a0f", size = 15671012, upload-time = "2026-05-18T23:34:05.485Z" },
+    { url = "https://files.pythonhosted.org/packages/99/60/14115e6364fa676c5397c2ad3004e527e9aa487abf5d0706ec81bbd08529/numpy-2.4.6-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:90f9849678c75fe7afa2d348ac842c168b0a4d3d61919687216dfc547976d853", size = 16645538, upload-time = "2026-05-18T23:34:09.265Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/c5/693cbe59e57db94d2231fa519ca3978dc9e19da5a8f088588f5c6e947ff2/numpy-2.4.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:c1a2af6c6ef86344a6b0db6b97834208bf598db514f2b155042439b62605601a", size = 17020706, upload-time = "2026-05-18T23:34:13.053Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/fc/85b7c4eff9b4966ade25c2273cf7e7012e92366c032058653934b37de044/numpy-2.4.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e5805d5a22fd19c8ccff10a9561f9df94436b0545619ea579db2d3c35294bce2", size = 18368541, upload-time = "2026-05-18T23:34:17.024Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/81/e1b27545deedce7f4a0b348618c6b62d74e36a4dc9ccd42f3eb2f85eee32/numpy-2.4.6-cp312-cp312-win32.whl", hash = "sha256:e3eeb0aabd6bd5ce64faae67e9935203a6991b4bc2a485a767fbafb2c5125f45", size = 5962825, upload-time = "2026-05-18T23:34:20.3Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/ca/feab00bd44aa5fe1ad2c18f08b4d3bb92e26484b0b1d1443897809ed528c/numpy-2.4.6-cp312-cp312-win_amd64.whl", hash = "sha256:d8e8286dd7cea7895157318d1b91cdacac64c479f3cbc8dce548331728484751", size = 12321687, upload-time = "2026-05-18T23:34:23.095Z" },
+    { url = "https://files.pythonhosted.org/packages/63/cf/5a6d34850a39d1093558564f77ee8e8e0bee5061151b8f05a55711001ec7/numpy-2.4.6-cp312-cp312-win_arm64.whl", hash = "sha256:4081eb135ac24158bd51cdfbef16f1c64df7063b1143f24731387137c092bec8", size = 10221482, upload-time = "2026-05-18T23:34:25.876Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/82/bdab26d7438c6791ca31b7c024ca37c1eab8b726ba236129005cd4a06e45/numpy-2.4.6-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:511dbaf848decaaaf4b4ca48032619fb3138710c4bf7da7617765edad1ef96b0", size = 16684648, upload-time = "2026-05-18T23:34:29.41Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/30/a80189bcc7f5e4258b3fbc3968d909d1756f54d023299ecc39ad6fdb9ef8/numpy-2.4.6-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bf162abab1c1a736333192707cef898e735a5ca00f38f27eeedf44b39d9e85eb", size = 14693902, upload-time = "2026-05-18T23:34:33.013Z" },
+    { url = "https://files.pythonhosted.org/packages/97/12/70b5d0d7c15e1ebb8a6a84a8caa1d19e181d84fb58bb6d70aca29099dec1/numpy-2.4.6-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:043191bfa8eab18c776647b62723ac9dddece59743b13f49b2016094129c2b3f", size = 5198992, upload-time = "2026-05-18T23:34:36.132Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/8c/ebd2a8f8a83541f8d38cc5667e8c2b69cecfd30da6e45693e8158857d44b/numpy-2.4.6-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:6180d8b35af935aed8ece3a85e0a43f87393ae0ac87c8d2c8bd2c993f7270ef3", size = 6546944, upload-time = "2026-05-18T23:34:38.484Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/c5/7b863a97a91671a0338f4253bd3b5a3d3852f0692dae91711c9f4a10e787/numpy-2.4.6-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:72fbe16c6fac95aedf5937fa873445cec2110be35d8a4e9433d7501fd98dae6b", size = 15669392, upload-time = "2026-05-18T23:34:41.257Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/9d/3584b9984ca4c047aea75214ce1a4c4c73d849bd71b604264b7f5653f8a8/numpy-2.4.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a7830bab239b79cda9c08c2da014761cafb48da6150e1da17ac06283f43b6089", size = 16633220, upload-time = "2026-05-18T23:34:45.075Z" },
+    { url = "https://files.pythonhosted.org/packages/05/ae/7c67fba23bd98caec7c99261f3a16072ade14813486b0282cb29846de832/numpy-2.4.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ef4aea96ce4d3b074422cb4f2f64e216bf9e213004bb58ecfdf50ea02ea8eb9a", size = 17020800, upload-time = "2026-05-18T23:34:49.065Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/5d/3b6725cb31d983c5e66916f5d36f6d7e5521129e4c4404d64f918292a5b6/numpy-2.4.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:dfa20cc6ca228e6b155b11da03825975ce66aea520985dbbddf0f2a5a495c605", size = 18357600, upload-time = "2026-05-18T23:34:52.709Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/da/2ccc6c2fe8898dee01d90c75c5f5f914a23daf99e3e0f59516a08760c8b5/numpy-2.4.6-cp313-cp313-win32.whl", hash = "sha256:56b39e5e0622a09a25bf5baf62f4bcf0cb8a41ae6e2819cf49bbc5a74c083f91", size = 5961134, upload-time = "2026-05-18T23:34:55.618Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/cd/9cc4dc876fb065d5c220aae4d5e14826b2715331bb7618ce1fb07a679d99/numpy-2.4.6-cp313-cp313-win_amd64.whl", hash = "sha256:c4fc99836233ea196540b17ab0983aff60ed07941751930f5f4d05bc3b3b7359", size = 12318598, upload-time = "2026-05-18T23:34:58.928Z" },
+    { url = "https://files.pythonhosted.org/packages/39/1e/c0bcba1f8694116485fe28fd1be698c278fcda4141c5b0e53a2aed8b12a8/numpy-2.4.6-cp313-cp313-win_arm64.whl", hash = "sha256:a7c711e21628b52034bb5ab8d1bce291f752fcc5e92accc615778acee1ff4778", size = 10222272, upload-time = "2026-05-18T23:35:02.167Z" },
+    { url = "https://files.pythonhosted.org/packages/63/6d/cc5619247c8f4204e507f5883528372e4ac4bb189e579fb859a12e480b1f/numpy-2.4.6-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:112b06a867b235ef466ed3508ddf0238050df9c727cafb5301ac385b899189a1", size = 14821197, upload-time = "2026-05-18T23:35:05.468Z" },
+    { url = "https://files.pythonhosted.org/packages/00/58/f1c39161c87d9e9bed660f1ed4bafc0e403d5ec9650b6dd77aead07d489b/numpy-2.4.6-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:eaf7fa2de5c0be8ae6ff8e9bea2ccd725e980541244521d8d4b5f3354a27babe", size = 5326287, upload-time = "2026-05-18T23:35:08.693Z" },
+    { url = "https://files.pythonhosted.org/packages/af/57/3917ab0fd97f271a8694513581b8a36c655f111c446852c302f04ccdb6fc/numpy-2.4.6-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:7265a2f3d436e54ef9f2b52b5c937e6be778781bd97a590319d7348f1c1ca997", size = 6646763, upload-time = "2026-05-18T23:35:11.459Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/0f/037e64c494b67581ae18193d770adef354c41f3f2c8ebf865602d949bf8f/numpy-2.4.6-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f74a575920ab21fe304421a3fc28793d82e299cae9eccb37084e9fc7f3617c20", size = 15728070, upload-time = "2026-05-18T23:35:14.79Z" },
+    { url = "https://files.pythonhosted.org/packages/21/a6/5d2bae9c9542eb4df16dc9c46dc79c186e9bad53805dfa5399a6023c6db0/numpy-2.4.6-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ede83e07a75dd06bc501566c1eca2afc0d61677c1472ac9ad93fdee6e638a48d", size = 16681752, upload-time = "2026-05-18T23:35:18.836Z" },
+    { url = "https://files.pythonhosted.org/packages/92/14/23d1dfb410ae362cd59ce53e936b1513d545eb40db3949ced632e19a459e/numpy-2.4.6-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:68bb27509ac1b9a3443094260f6326150663b06abe40b73a2f81160623da5b67", size = 17086024, upload-time = "2026-05-18T23:35:22.52Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/6e/23595a2c642cdf3bc567877064bdd7f91c8b0038a4453cf2daf7248eafe9/numpy-2.4.6-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:a0df0043bdb289bde1f62da130d20df23d58b45429f752bc7a8fc5325a225ecd", size = 18403398, upload-time = "2026-05-18T23:35:26.398Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/90/0ac3bc947217e66dec77e7cbc6a1979d1af70b6461b82f620d3bccd5e4c8/numpy-2.4.6-cp313-cp313t-win32.whl", hash = "sha256:29a287e0cf63ff528da061de6b9f64a4618da591ca1046aafc54062e40ca7eab", size = 6084971, upload-time = "2026-05-18T23:35:29.387Z" },
+    { url = "https://files.pythonhosted.org/packages/77/71/5673e351671a1d2bd6063b91b44f70c0affea7d1516fa7a6572941ba4aa1/numpy-2.4.6-cp313-cp313t-win_amd64.whl", hash = "sha256:25c692919ac5a01f170a3bfcd62d745b24fd095c353d50812637d6fcab442e75", size = 12458532, upload-time = "2026-05-18T23:35:32.175Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/88/19d3503c5046e688f049274b27a3ef3d771152fa80d3ba3d01a3dff61abe/numpy-2.4.6-cp313-cp313t-win_arm64.whl", hash = "sha256:1e978ec1e8bd0e0e4de6bb75de9d30cbb74db6b6a2bb727618613703ca0167dd", size = 10291881, upload-time = "2026-05-18T23:35:35.465Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/91/3ab2044d05fd16d343c5ac2e69b127f1b2854040dd20b193257c78028bd3/numpy-2.4.6-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:06ca2f61ec4385a07a6977c55ba998a4466c123642b4a32694d3128fce18c079", size = 16683458, upload-time = "2026-05-18T23:35:38.353Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/62/764ce66fa4147ae6d73071a3abf804ffe606f174618697c571acdf26a7c9/numpy-2.4.6-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:38efbc8de75c7a0fc1ac190162d892787f3f47b57cc291231aafee36b80982b7", size = 14704559, upload-time = "2026-05-18T23:35:42.14Z" },
+    { url = "https://files.pythonhosted.org/packages/60/61/23f27c172f022e04025b7dc2367f4d63c1a398120607ec896228649a6f48/numpy-2.4.6-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:d581b735e177fdcdce6fed8e7e8880a3fb6ee4e3653a3ac6af01c6f4c03effc5", size = 5209716, upload-time = "2026-05-18T23:35:45.377Z" },
+    { url = "https://files.pythonhosted.org/packages/03/71/21cf70dc6ea3e3acb95fc53a265b2fc248b981f0194ceb5b475271b8809d/numpy-2.4.6-cp314-cp314-macosx_14_0_x86_64.whl", hash = "sha256:0a041d3d761dc3c35cc56ce0351506a02bcbc25f7b169f652435141a17db9096", size = 6543947, upload-time = "2026-05-18T23:35:47.926Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/91/64288395ee1799bd2e0b04a305dce9666da90c961e1f3fe982a05ee1c036/numpy-2.4.6-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:40fdc1ae7125e518ea98e53e69a4ebc27e1fd50510c47b7ea130cf21e5e1d42b", size = 15685197, upload-time = "2026-05-18T23:35:50.863Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/eb/ebffaa97dc55502df69584a8f0dcf07f69a3e0b3e2323670a2722db9aa39/numpy-2.4.6-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a2c306dea656c12c68f51f4cea133cbe78ca7435eb28c735eac1d3ebe73be6e8", size = 16638245, upload-time = "2026-05-18T23:35:54.752Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/0b/54f9da33128d7e350fab89c7455902eeae70349ee52bddb448dc4a576f45/numpy-2.4.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:33111801a01c12a8a1e3721f0a9232f8cfc8ae2c6b7098167e6f623c6073f402", size = 17036587, upload-time = "2026-05-18T23:35:58.355Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/f0/fdebc1052db1cc37c64beb22072d67cd6d1c71adca1299f53dec2b5e20d3/numpy-2.4.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ae506e6902902557576a26ff33eda8695e7ecb3cb36c3b573a0765dee114ebdb", size = 18363226, upload-time = "2026-05-18T23:36:02.845Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/b4/298628d98c72b57e57f7165ae6a481a1deaf6f3c28262a6e4c739c275930/numpy-2.4.6-cp314-cp314-win32.whl", hash = "sha256:aaf159caa35993cb1f56fb9b8e4610d35758e7ca005412eb1daa856a78c9c4b1", size = 6010196, upload-time = "2026-05-18T23:36:05.92Z" },
+    { url = "https://files.pythonhosted.org/packages/df/ac/46de6dda46478f7942f839e094970be2d4a861e005c4b3bf07c92e291a09/numpy-2.4.6-cp314-cp314-win_amd64.whl", hash = "sha256:b507f5c4c1d508876d1819b6bf9a49d365b96320b5d4993426b33a23ca4b8261", size = 12450334, upload-time = "2026-05-18T23:36:09.107Z" },
+    { url = "https://files.pythonhosted.org/packages/78/92/b8b798ac784102c0da830d2257d59358e3d3d90d1e2b3f2575dad976c5cf/numpy-2.4.6-cp314-cp314-win_arm64.whl", hash = "sha256:6f41ae150c4e32db4f3310cdaf64b1593a03dbabe29eec77fc9b50fe64061df6", size = 10495678, upload-time = "2026-05-18T23:36:12.766Z" },
+    { url = "https://files.pythonhosted.org/packages/30/34/ec28d1aa8115971537c01469ab2011ee96827930f0a124de1000cc2a7ed7/numpy-2.4.6-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ece3d2cfe132e7d51f44a832b303895e6f2d499c5e74dfbdb06ee246147a304a", size = 14823672, upload-time = "2026-05-18T23:36:16.473Z" },
+    { url = "https://files.pythonhosted.org/packages/16/bd/f6d1fede4e54e8042a7ff97bb495510f3c220f94bcd9e8b228e87c92cc0d/numpy-2.4.6-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:e3e5193ef5a3dc73bceee50f7fdc2c90dbb76c42df8d8fae3d1067a583df579e", size = 5328731, upload-time = "2026-05-18T23:36:19.767Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/f0/e105b9e2fd728a9910103884decd6951d9dd73896b914a98d9a231de02ee/numpy-2.4.6-cp314-cp314t-macosx_14_0_x86_64.whl", hash = "sha256:17f9ade344e7d9b464a084d69bcf18fc691cb1db67c62ed80820bf4926d78f0e", size = 6649805, upload-time = "2026-05-18T23:36:22.266Z" },
+    { url = "https://files.pythonhosted.org/packages/82/dd/1206a7ca6ab15e3f02069707ca96222e202af681bb73756da7527f3cb837/numpy-2.4.6-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9cd5ffd25db4e7ba6a375693b3fc0fc1791ec636c17db3720da19bde7180ec43", size = 15730496, upload-time = "2026-05-18T23:36:25.713Z" },
+    { url = "https://files.pythonhosted.org/packages/51/e7/38d3ea825dcab85a591734decb2f6c67caa7c8367d374df1a1c3842f9b07/numpy-2.4.6-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7d92c3819208a60205a12a245c91ad70cb0a85336659b19b834205573ac8456e", size = 16679616, upload-time = "2026-05-18T23:36:29.652Z" },
+    { url = "https://files.pythonhosted.org/packages/93/b7/caabfdf53edf663e0b4eb74d7d405d83baef09eb5e83bcd32d601d72b93e/numpy-2.4.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e85b752a1e912b70eaad4fafbd4d1238007ab221de2009b9a2f5ae7461239895", size = 17085145, upload-time = "2026-05-18T23:36:33.449Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/45/68d7c33a6bcf3e5aa3bdbd57a367e6f615286dfd6482f97e8ffeb734306e/numpy-2.4.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:29cb7f67d10b479ff07c17d33e39f78c07f71c40ef30d63c153d340e96cd3fb4", size = 18403813, upload-time = "2026-05-18T23:36:37.369Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/50/0753655aa844c99cd9e018aacf76f130f1bd81d881bb74bc0aef5d73a8ba/numpy-2.4.6-cp314-cp314t-win32.whl", hash = "sha256:260a5d70215b61ab4fadf5c7baacd64821842975eea312125ed3c39a6391b063", size = 6156982, upload-time = "2026-05-18T23:36:40.817Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/d4/7c67becf668f973cb490cec3e98dfd799d866f9c989a54d355672cfa0db6/numpy-2.4.6-cp314-cp314t-win_amd64.whl", hash = "sha256:81a1cca95ed5bb92aa8b10dd2cdc9a0d3853a50fad926c28b5d7e8ea54389627", size = 12638908, upload-time = "2026-05-18T23:36:43.996Z" },
+    { url = "https://files.pythonhosted.org/packages/43/bb/e1c71a4295b1b1d1393d50dbb4f2a36283c6859d9d3892e84f00ec5a91d5/numpy-2.4.6-cp314-cp314t-win_arm64.whl", hash = "sha256:0c9136e14ed34a9e343a31c533d78a9813a69a3148332bce5e9821cb2f996e66", size = 10565867, upload-time = "2026-05-18T23:36:47.114Z" },
+    { url = "https://files.pythonhosted.org/packages/de/12/b422cc84439adc0d00de605bf4a308890ae5c26f2c71fbd73e5d08fbb0dd/numpy-2.4.6-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:55cced7c52e981362f708ad635198e97a752dfba412cc03c23bbf3bd8d5cd662", size = 16847511, upload-time = "2026-05-18T23:36:50.673Z" },
+    { url = "https://files.pythonhosted.org/packages/44/53/f481bef68011740f8849418d82db07230e825013f31f4eef5ba5b805316a/numpy-2.4.6-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:d6da64deb6b8ed903e7560180a92f2d804ee1ba5eeb849ac2748b8c1aba1f6d7", size = 14889064, upload-time = "2026-05-18T23:36:53.879Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/57/42ed575c10ced8af951d426bc4e1f8aff16fd851db33f067036215a7f860/numpy-2.4.6-pp311-pypy311_pp73-macosx_14_0_arm64.whl", hash = "sha256:68a5124b13fa6cc2086764a20005d30bc0548146f7f5322f02fce212ca14317f", size = 5394157, upload-time = "2026-05-18T23:36:57.194Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/ef/f66cc724fcc36c1e364c67f51ae9146090b8b584f27d58b97fdae3edd737/numpy-2.4.6-pp311-pypy311_pp73-macosx_14_0_x86_64.whl", hash = "sha256:948424b06129ce883307e8cff868c31396d8dc7630a59c61d70d98dbe70f222c", size = 6708728, upload-time = "2026-05-18T23:36:59.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/9c/c531f2293b91265d8b48e9b329f54fdd7ffae73cb4134ea10cca4237e9cc/numpy-2.4.6-pp311-pypy311_pp73-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5dbbdb29840ca3d91ee0fece42fc29278886d908280bfec0a5846c6f901a3eb0", size = 15798374, upload-time = "2026-05-18T23:37:02.674Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/b0/413077f6b1153ed3cba361401c6783bbad6114804a000cc22eb71c13e190/numpy-2.4.6-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8ad03c0965fb3c692200e74d458ca28c1dbb4ce96f9a479a8aa041ad5fabca02", size = 16747286, upload-time = "2026-05-18T23:37:06.327Z" },
+    { url = "https://files.pythonhosted.org/packages/15/ce/e5ec180bc41812edcd8daeb8639d205622c0e8c02259d8ab25a0201b3c2a/numpy-2.4.6-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:2803abfebfc990042cd494d8ce2d5f82e9d847af6d35ec486923aa19dbad5e73", size = 12504263, upload-time = "2026-05-18T23:37:09.715Z" },
+]
+
+[[package]]
+name = "nvidia-cublas"
+version = "13.1.1.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "nvidia-cuda-nvrtc" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a7/a1/0bd24ee8c8d03adac032fd2909426a00c88f8c57961b1277ded97f91119f/nvidia_cublas-13.1.1.3-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:b7a210458267ac818974c53038fbec2e969d5c99f305ab15c72522fa9f001dd5", size = 542848918, upload-time = "2026-04-08T18:46:22.985Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/cd/154ca20c38269e05eff77c1464e6c1da89f50a6390b565e9d82e06bc11e1/nvidia_cublas-13.1.1.3-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:37936a16db8fe4ac1f065c2139360608a543a09275cb1a1af612e08cfa065436", size = 423138758, upload-time = "2026-04-08T18:46:58.655Z" },
+]
+
+[[package]]
+name = "nvidia-cuda-cupti"
+version = "13.0.85"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/2a/80353b103fc20ce05ef51e928daed4b6015db4aaa9162ed0997090fe2250/nvidia_cuda_cupti-13.0.85-py3-none-manylinux_2_25_aarch64.whl", hash = "sha256:796bd679890ee55fb14a94629b698b6db54bcfd833d391d5e94017dd9d7d3151", size = 10310827, upload-time = "2025-09-04T08:26:42.012Z" },
+    { url = "https://files.pythonhosted.org/packages/33/6d/737d164b4837a9bbd202f5ae3078975f0525a55730fe871d8ed4e3b952b0/nvidia_cuda_cupti-13.0.85-py3-none-manylinux_2_25_x86_64.whl", hash = "sha256:4eb01c08e859bf924d222250d2e8f8b8ff6d3db4721288cf35d14252a4d933c8", size = 10715597, upload-time = "2025-09-04T08:26:51.312Z" },
+]
+
+[[package]]
+name = "nvidia-cuda-nvrtc"
+version = "13.0.88"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c3/68/483a78f5e8f31b08fb1bb671559968c0ca3a065ac7acabfc7cee55214fd6/nvidia_cuda_nvrtc-13.0.88-py3-none-manylinux2010_x86_64.manylinux_2_12_x86_64.whl", hash = "sha256:ad9b6d2ead2435f11cbb6868809d2adeeee302e9bb94bcf0539c7a40d80e8575", size = 90215200, upload-time = "2025-09-04T08:28:44.204Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/dc/6bb80850e0b7edd6588d560758f17e0550893a1feaf436807d64d2da040f/nvidia_cuda_nvrtc-13.0.88-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d27f20a0ca67a4bb34268a5e951033496c5b74870b868bacd046b1b8e0c3267b", size = 43015449, upload-time = "2025-09-04T08:28:20.239Z" },
+]
+
+[[package]]
+name = "nvidia-cuda-runtime"
+version = "13.0.96"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/87/4f/17d7b9b8e285199c58ce28e31b5c5bbaa4d8271af06a89b6405258245de2/nvidia_cuda_runtime-13.0.96-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ef9bcbe90493a2b9d810e43d249adb3d02e98dd30200d86607d8d02687c43f55", size = 2261060, upload-time = "2025-10-09T08:55:15.78Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/24/d1558f3b68b1d26e706813b1d10aa1d785e4698c425af8db8edc3dced472/nvidia_cuda_runtime-13.0.96-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7f82250d7782aa23b6cfe765ecc7db554bd3c2870c43f3d1821f1d18aebf0548", size = 2243632, upload-time = "2025-10-09T08:55:36.117Z" },
+]
+
+[[package]]
+name = "nvidia-cudnn-cu13"
+version = "9.20.0.48"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "nvidia-cublas" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/56/c5/83384d846b2fd17c44bd499b36c75a45ed4f095fbbb2252294e89cea5c5c/nvidia_cudnn_cu13-9.20.0.48-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:e31454ae00094b0c55319d9d15b6fa2fc50a9e1c0f5c8c80fb75258234e731e1", size = 444574296, upload-time = "2026-03-09T19:28:27.751Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/5e/edb9c0ae051602c3ccaffe424256463636d639e27d7f302dde9975ef9e7a/nvidia_cudnn_cu13-9.20.0.48-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:0c45dd8eeb50b603f07995b1b300c62ffe6a1980482b82b3bcf94a4ca9d49304", size = 366173588, upload-time = "2026-03-09T19:29:34.474Z" },
+]
+
+[[package]]
+name = "nvidia-cufft"
+version = "12.0.0.61"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "nvidia-nvjitlink" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8b/ae/f417a75c0259e85c1d2f83ca4e960289a5f814ed0cea74d18c353d3e989d/nvidia_cufft-12.0.0.61-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:2708c852ef8cd89d1d2068bdbece0aa188813a0c934db3779b9b1faa8442e5f5", size = 214053554, upload-time = "2025-09-04T08:31:38.196Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/2f/7b57e29836ea8714f81e9898409196f47d772d5ddedddf1592eadb8ab743/nvidia_cufft-12.0.0.61-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:6c44f692dce8fd5ffd3e3df134b6cdb9c2f72d99cf40b62c32dde45eea9ddad3", size = 214085489, upload-time = "2025-09-04T08:31:56.044Z" },
+]
+
+[[package]]
+name = "nvidia-cufile"
+version = "1.15.1.6"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3f/70/4f193de89a48b71714e74602ee14d04e4019ad36a5a9f20c425776e72cd6/nvidia_cufile-1.15.1.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:08a3ecefae5a01c7f5117351c64f17c7c62efa5fffdbe24fc7d298da19cd0b44", size = 1223672, upload-time = "2025-09-04T08:32:22.779Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/73/cc4a14c9813a8a0d509417cf5f4bdaba76e924d58beb9864f5a7baceefbf/nvidia_cufile-1.15.1.6-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:bdc0deedc61f548bddf7733bdc216456c2fdb101d020e1ab4b88d232d5e2f6d1", size = 1136992, upload-time = "2025-09-04T08:32:14.119Z" },
+]
+
+[[package]]
+name = "nvidia-curand"
+version = "10.4.0.35"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/72/7c2ae24fb6b63a32e6ae5d241cc65263ea18d08802aaae087d9f013335a2/nvidia_curand-10.4.0.35-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:133df5a7509c3e292aaa2b477afd0194f06ce4ea24d714d616ff36439cee349a", size = 61962106, upload-time = "2025-08-04T10:21:41.128Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/9f/be0a41ca4a4917abf5cb9ae0daff1a6060cc5de950aec0396de9f3b52bc5/nvidia_curand-10.4.0.35-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:1aee33a5da6e1db083fe2b90082def8915f30f3248d5896bcec36a579d941bfc", size = 59544258, upload-time = "2025-08-04T10:22:03.992Z" },
+]
+
+[[package]]
+name = "nvidia-cusolver"
+version = "12.0.4.66"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "nvidia-cublas" },
+    { name = "nvidia-cusparse" },
+    { name = "nvidia-nvjitlink" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c8/c3/b30c9e935fc01e3da443ec0116ed1b2a009bb867f5324d3f2d7e533e776b/nvidia_cusolver-12.0.4.66-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:02c2457eaa9e39de20f880f4bd8820e6a1cfb9f9a34f820eb12a155aa5bc92d2", size = 223467760, upload-time = "2025-09-04T08:33:04.222Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/67/cba3777620cdacb99102da4042883709c41c709f4b6323c10781a9c3aa34/nvidia_cusolver-12.0.4.66-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:0a759da5dea5c0ea10fd307de75cdeb59e7ea4fcb8add0924859b944babf1112", size = 200941980, upload-time = "2025-09-04T08:33:22.767Z" },
+]
+
+[[package]]
+name = "nvidia-cusparse"
+version = "12.6.3.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "nvidia-nvjitlink" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f8/94/5c26f33738ae35276672f12615a64bd008ed5be6d1ebcb23579285d960a9/nvidia_cusparse-12.6.3.3-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:80bcc4662f23f1054ee334a15c72b8940402975e0eab63178fc7e670aa59472c", size = 162155568, upload-time = "2025-09-04T08:33:42.864Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/18/623c77619c31d62efd55302939756966f3ecc8d724a14dab2b75f1508850/nvidia_cusparse-12.6.3.3-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2b3c89c88d01ee0e477cb7f82ef60a11a4bcd57b6b87c33f789350b59759360b", size = 145942937, upload-time = "2025-09-04T08:33:58.029Z" },
+]
+
+[[package]]
+name = "nvidia-cusparselt-cu13"
+version = "0.8.1"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/46/e1/cdc1797eadf82d3a9a575a19b33fdc871a97edbec42c00b5b5e914f4aff4/nvidia_cusparselt_cu13-0.8.1-py3-none-manylinux2014_aarch64.whl", hash = "sha256:4dca476c50bf4780d46cd0bfbd82e2bc10a08e4fef7950917ce8d7578d22a23f", size = 221051344, upload-time = "2025-09-05T18:49:51.289Z" },
+    { url = "https://files.pythonhosted.org/packages/34/7d/2661f2fb3ac4302f3a246f5fc030213ac60c1fe0bce84f9783dbd831dbb7/nvidia_cusparselt_cu13-0.8.1-py3-none-manylinux2014_x86_64.whl", hash = "sha256:786ce87568c303fadb5afcc7102d454cd3040d75f6f8626f5db460d1871f4dd0", size = 170148586, upload-time = "2025-09-05T18:50:50.248Z" },
+]
+
+[[package]]
+name = "nvidia-ml-py"
+version = "13.595.45"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ce/49/c29f6e30d8662d2e94fef17739ea7309cc76aba269922ae999e4cc07f268/nvidia_ml_py-13.595.45.tar.gz", hash = "sha256:c9f34897fe0441ff35bc8f35baf80f830a20b0f4e6ce71e0a325bc0e66acf079", size = 50780, upload-time = "2026-03-19T16:59:44.956Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/24/fc256107d23597fa33d319505ce77160fa1a2349c096d01901ffc7cb7fc4/nvidia_ml_py-13.595.45-py3-none-any.whl", hash = "sha256:b65a7977f503d56154b14d683710125ef93594adb63fbf7e559336e3318f1376", size = 51776, upload-time = "2026-03-19T16:59:43.603Z" },
+]
+
+[[package]]
+name = "nvidia-nccl-cu13"
+version = "2.29.7"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/72/0d/daf50d44177ee0cbc7ff0a0c91eb5ff676c82be42f9a970bc7597f440c3a/nvidia_nccl_cu13-2.29.7-py3-none-manylinux_2_18_aarch64.whl", hash = "sha256:674a12383e3c38a1bcccae7d4f3633b37852230b6047883cb2f4c2d1b36d9bf5", size = 206014712, upload-time = "2026-03-03T05:34:20.843Z" },
+    { url = "https://files.pythonhosted.org/packages/67/f4/58e4e91b6919367c7aafb8e36fce9aad1a3047e536bf7e2fd560927d3a4c/nvidia_nccl_cu13-2.29.7-py3-none-manylinux_2_18_x86_64.whl", hash = "sha256:edd81538446786ec3b73972543e53bb43bcaf0bfc8ef76cb679fcc390ffe136d", size = 205976000, upload-time = "2026-03-03T05:36:24.472Z" },
+]
+
+[[package]]
+name = "nvidia-nvjitlink"
+version = "13.0.88"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/56/7a/123e033aaff487c77107195fa5a2b8686795ca537935a24efae476c41f05/nvidia_nvjitlink-13.0.88-py3-none-manylinux2010_x86_64.manylinux_2_12_x86_64.whl", hash = "sha256:13a74f429e23b921c1109976abefacc69835f2f433ebd323d3946e11d804e47b", size = 40713933, upload-time = "2025-09-04T08:35:43.553Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/2c/93c5250e64df4f894f1cbb397c6fd71f79813f9fd79d7cd61de3f97b3c2d/nvidia_nvjitlink-13.0.88-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:e931536ccc7d467a98ba1d8b89ff7fa7f1fa3b13f2b0069118cd7f47bff07d0c", size = 38768748, upload-time = "2025-09-04T08:35:20.008Z" },
+]
+
+[[package]]
+name = "nvidia-nvshmem-cu13"
+version = "3.4.5"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/0f/05cc9c720236dcd2db9c1ab97fff629e96821be2e63103569da0c9b72f19/nvidia_nvshmem_cu13-3.4.5-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6dc2a197f38e5d0376ad52cd1a2a3617d3cdc150fd5966f4aee9bcebb1d68fe9", size = 60215947, upload-time = "2025-09-06T00:32:20.022Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/35/a9bf80a609e74e3b000fef598933235c908fcefcef9026042b8e6dfde2a9/nvidia_nvshmem_cu13-3.4.5-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:290f0a2ee94c9f3687a02502f3b9299a9f9fe826e6d0287ee18482e78d495b80", size = 60412546, upload-time = "2025-09-06T00:32:41.564Z" },
+]
+
+[[package]]
+name = "nvidia-nvtx"
+version = "13.0.85"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c2/f3/d86c845465a2723ad7e1e5c36dcd75ddb82898b3f53be47ebd429fb2fa5d/nvidia_nvtx-13.0.85-py3-none-manylinux1_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:4936d1d6780fbe68db454f5e72a42ff64d1fd6397df9f363ae786930fd5c1cd4", size = 148047, upload-time = "2025-09-04T08:29:01.761Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/64/3708a90d1ebe202ffdeb7185f878a3c84d15c2b2c31858da2ce0583e2def/nvidia_nvtx-13.0.85-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:cb7780edb6b14107373c835bf8b72e7a178bac7367e23da7acb108f973f157a6", size = 148878, upload-time = "2025-09-04T08:28:53.627Z" },
+]
+
+[[package]]
+name = "opentelemetry-api"
+version = "1.42.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b4/1c/125e1c936c0873796771b7f04f6c93b9f1bf5d424cea90fda94a99f61da8/opentelemetry_api-1.42.1.tar.gz", hash = "sha256:56c63bea9f77b62856be8c47600474acad853b2924b99b1687c4cb6297166716", size = 72296, upload-time = "2026-05-21T16:32:49.335Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a3/ca/9520cc1f3dfbbd03ac5903bbf55833e257bc64b1cf30fa8b0d6df374d821/opentelemetry_api-1.42.1-py3-none-any.whl", hash = "sha256:51a69edacadbc03a8950ace1c4c21099cacc538820ac2c9e36277e78cebba714", size = 61311, upload-time = "2026-05-21T16:32:28.822Z" },
+]
+
+[[package]]
+name = "ophyd"
+version = "1.11.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "opentelemetry-api" },
+    { name = "packaging" },
+    { name = "pint", version = "0.24.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "pint", version = "0.25.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3b/4a/d41c587299c62dcee80af425e29fddb96ba6ee8d8cd83d05acc959316554/ophyd-1.11.1.tar.gz", hash = "sha256:c813fa90f7d070b8da2a875ace9f50193a29d4c4555838c9c766947d971bbb9c", size = 313339, upload-time = "2026-03-31T19:03:33.948Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6c/fc/a4bf334181e291ced9c9b09178394e6cd42ec6e8e0ef2e890c5b6c8e4ab5/ophyd-1.11.1-py3-none-any.whl", hash = "sha256:af3032fe4cc74a2f219d0dfd0c65454faff397b14b194ca3fc7a3b5ec89c1ceb", size = 280052, upload-time = "2026-03-31T19:03:32.394Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "paho-mqtt"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/39/15/0a6214e76d4d32e7f663b109cf71fb22561c2be0f701d67f93950cd40542/paho_mqtt-2.1.0.tar.gz", hash = "sha256:12d6e7511d4137555a3f6ea167ae846af2c7357b10bc6fa4f7c3968fc1723834", size = 148848, upload-time = "2024-04-29T19:52:55.591Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c4/cb/00451c3cf31790287768bb12c6bec834f5d292eaf3022afc88e14b8afc94/paho_mqtt-2.1.0-py3-none-any.whl", hash = "sha256:6db9ba9b34ed5bc6b6e3812718c7e06e2fd7444540df2455d2c51bd58808feee", size = 67219, upload-time = "2024-04-29T19:52:48.345Z" },
+]
+
+[[package]]
+name = "pillow"
+version = "12.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/21/c2bcdd5906101a30244eaffc1b6e6ce71a31bd0742a01eb89e660ebfac2d/pillow-12.2.0.tar.gz", hash = "sha256:a830b1a40919539d07806aa58e1b114df53ddd43213d9c8b75847eee6c0182b5", size = 46987819, upload-time = "2026-04-01T14:46:17.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3a/aa/d0b28e1c811cd4d5f5c2bfe2e022292bd255ae5744a3b9ac7d6c8f72dd75/pillow-12.2.0-cp310-cp310-macosx_10_10_x86_64.whl", hash = "sha256:a4e8f36e677d3336f35089648c8955c51c6d386a13cf6ee9c189c5f5bd713a9f", size = 5354355, upload-time = "2026-04-01T14:42:15.402Z" },
+    { url = "https://files.pythonhosted.org/packages/27/8e/1d5b39b8ae2bd7650d0c7b6abb9602d16043ead9ebbfef4bc4047454da2a/pillow-12.2.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:2e589959f10d9824d39b350472b92f0ce3b443c0a3442ebf41c40cb8361c5b97", size = 4695871, upload-time = "2026-04-01T14:42:18.234Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/c5/dcb7a6ca6b7d3be41a76958e90018d56c8462166b3ef223150360850c8da/pillow-12.2.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:a52edc8bfff4429aaabdf4d9ee0daadbbf8562364f940937b941f87a4290f5ff", size = 6269734, upload-time = "2026-04-01T14:42:20.608Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/f1/aa1bb13b2f4eba914e9637893c73f2af8e48d7d4023b9d3750d4c5eb2d0c/pillow-12.2.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:975385f4776fafde056abb318f612ef6285b10a1f12b8570f3647ad0d74b48ec", size = 8076080, upload-time = "2026-04-01T14:42:23.095Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/2a/8c79d6a53169937784604a8ae8d77e45888c41537f7f6f65ed1f407fe66d/pillow-12.2.0-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bd9c0c7a0c681a347b3194c500cb1e6ca9cab053ea4d82a5cf45b6b754560136", size = 6382236, upload-time = "2026-04-01T14:42:25.82Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/42/bbcb6051030e1e421d103ce7a8ecadf837aa2f39b8f82ef1a8d37c3d4ebc/pillow-12.2.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:88d387ff40b3ff7c274947ed3125dedf5262ec6919d83946753b5f3d7c67ea4c", size = 7070220, upload-time = "2026-04-01T14:42:28.68Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/e1/c2a7d6dd8cfa6b231227da096fd2d58754bab3603b9d73bf609d3c18b64f/pillow-12.2.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:51c4167c34b0d8ba05b547a3bb23578d0ba17b80a5593f93bd8ecb123dd336a3", size = 6493124, upload-time = "2026-04-01T14:42:31.579Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/41/7c8617da5d32e1d2f026e509484fdb6f3ad7efaef1749a0c1928adbb099e/pillow-12.2.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:34c0d99ecccea270c04882cb3b86e7b57296079c9a4aff88cb3b33563d95afaa", size = 7194324, upload-time = "2026-04-01T14:42:34.615Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/de/a777627e19fd6d62f84070ee1521adde5eeda4855b5cf60fe0b149118bca/pillow-12.2.0-cp310-cp310-win32.whl", hash = "sha256:b85f66ae9eb53e860a873b858b789217ba505e5e405a24b85c0464822fe88032", size = 6376363, upload-time = "2026-04-01T14:42:37.19Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/34/fc4cb5204896465842767b96d250c08410f01f2f28afc43b257de842eed5/pillow-12.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:673aa32138f3e7531ccdbca7b3901dba9b70940a19ccecc6a37c77d5fdeb05b5", size = 7083523, upload-time = "2026-04-01T14:42:39.62Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/a0/32852d36bc7709f14dc3f64f929a275e958ad8c19a6deba9610d458e28b3/pillow-12.2.0-cp310-cp310-win_arm64.whl", hash = "sha256:3e080565d8d7c671db5802eedfb438e5565ffa40115216eabb8cd52d0ecce024", size = 2463318, upload-time = "2026-04-01T14:42:42.063Z" },
+    { url = "https://files.pythonhosted.org/packages/68/e1/748f5663efe6edcfc4e74b2b93edfb9b8b99b67f21a854c3ae416500a2d9/pillow-12.2.0-cp311-cp311-macosx_10_10_x86_64.whl", hash = "sha256:8be29e59487a79f173507c30ddf57e733a357f67881430449bb32614075a40ab", size = 5354347, upload-time = "2026-04-01T14:42:44.255Z" },
+    { url = "https://files.pythonhosted.org/packages/47/a1/d5ff69e747374c33a3b53b9f98cca7889fce1fd03d79cdc4e1bccc6c5a87/pillow-12.2.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:71cde9a1e1551df7d34a25462fc60325e8a11a82cc2e2f54578e5e9a1e153d65", size = 4695873, upload-time = "2026-04-01T14:42:46.452Z" },
+    { url = "https://files.pythonhosted.org/packages/df/21/e3fbdf54408a973c7f7f89a23b2cb97a7ef30c61ab4142af31eee6aebc88/pillow-12.2.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:f490f9368b6fc026f021db16d7ec2fbf7d89e2edb42e8ec09d2c60505f5729c7", size = 6280168, upload-time = "2026-04-01T14:42:49.228Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/f1/00b7278c7dd52b17ad4329153748f87b6756ec195ff786c2bdf12518337d/pillow-12.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8bd7903a5f2a4545f6fd5935c90058b89d30045568985a71c79f5fd6edf9b91e", size = 8088188, upload-time = "2026-04-01T14:42:51.735Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/cf/220a5994ef1b10e70e85748b75649d77d506499352be135a4989c957b701/pillow-12.2.0-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3997232e10d2920a68d25191392e3a4487d8183039e1c74c2297f00ed1c50705", size = 6394401, upload-time = "2026-04-01T14:42:54.343Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/bd/e51a61b1054f09437acfbc2ff9106c30d1eb76bc1453d428399946781253/pillow-12.2.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e74473c875d78b8e9d5da2a70f7099549f9eb37ded4e2f6a463e60125bccd176", size = 7079655, upload-time = "2026-04-01T14:42:56.954Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/3d/45132c57d5fb4b5744567c3817026480ac7fc3ce5d4c47902bc0e7f6f853/pillow-12.2.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:56a3f9c60a13133a98ecff6197af34d7824de9b7b38c3654861a725c970c197b", size = 6503105, upload-time = "2026-04-01T14:42:59.847Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/2e/9df2fc1e82097b1df3dce58dc43286aa01068e918c07574711fcc53e6fb4/pillow-12.2.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:90e6f81de50ad6b534cab6e5aef77ff6e37722b2f5d908686f4a5c9eba17a909", size = 7203402, upload-time = "2026-04-01T14:43:02.664Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/2e/2941e42858ebb67e50ae741473de81c2984e6eff7b397017623c676e2e8d/pillow-12.2.0-cp311-cp311-win32.whl", hash = "sha256:8c984051042858021a54926eb597d6ee3012393ce9c181814115df4c60b9a808", size = 6378149, upload-time = "2026-04-01T14:43:05.274Z" },
+    { url = "https://files.pythonhosted.org/packages/69/42/836b6f3cd7f3e5fa10a1f1a5420447c17966044c8fbf589cc0452d5502db/pillow-12.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:6e6b2a0c538fc200b38ff9eb6628228b77908c319a005815f2dde585a0664b60", size = 7082626, upload-time = "2026-04-01T14:43:08.557Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/88/549194b5d6f1f494b485e493edc6693c0a16f4ada488e5bd974ed1f42fad/pillow-12.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:9a8a34cc89c67a65ea7437ce257cea81a9dad65b29805f3ecee8c8fe8ff25ffe", size = 2463531, upload-time = "2026-04-01T14:43:10.743Z" },
+    { url = "https://files.pythonhosted.org/packages/58/be/7482c8a5ebebbc6470b3eb791812fff7d5e0216c2be3827b30b8bb6603ed/pillow-12.2.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:2d192a155bbcec180f8564f693e6fd9bccff5a7af9b32e2e4bf8c9c69dbad6b5", size = 5308279, upload-time = "2026-04-01T14:43:13.246Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/95/0a351b9289c2b5cbde0bacd4a83ebc44023e835490a727b2a3bd60ddc0f4/pillow-12.2.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f3f40b3c5a968281fd507d519e444c35f0ff171237f4fdde090dd60699458421", size = 4695490, upload-time = "2026-04-01T14:43:15.584Z" },
+    { url = "https://files.pythonhosted.org/packages/de/af/4e8e6869cbed569d43c416fad3dc4ecb944cb5d9492defaed89ddd6fe871/pillow-12.2.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:03e7e372d5240cc23e9f07deca4d775c0817bffc641b01e9c3af208dbd300987", size = 6284462, upload-time = "2026-04-01T14:43:18.268Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/9e/c05e19657fd57841e476be1ab46c4d501bffbadbafdc31a6d665f8b737b6/pillow-12.2.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:b86024e52a1b269467a802258c25521e6d742349d760728092e1bc2d135b4d76", size = 8094744, upload-time = "2026-04-01T14:43:20.716Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/54/1789c455ed10176066b6e7e6da1b01e50e36f94ba584dc68d9eebfe9156d/pillow-12.2.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7371b48c4fa448d20d2714c9a1f775a81155050d383333e0a6c15b1123dda005", size = 6398371, upload-time = "2026-04-01T14:43:23.443Z" },
+    { url = "https://files.pythonhosted.org/packages/43/e3/fdc657359e919462369869f1c9f0e973f353f9a9ee295a39b1fea8ee1a77/pillow-12.2.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:62f5409336adb0663b7caa0da5c7d9e7bdbaae9ce761d34669420c2a801b2780", size = 7087215, upload-time = "2026-04-01T14:43:26.758Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/f8/2f6825e441d5b1959d2ca5adec984210f1ec086435b0ed5f52c19b3b8a6e/pillow-12.2.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:01afa7cf67f74f09523699b4e88c73fb55c13346d212a59a2db1f86b0a63e8c5", size = 6509783, upload-time = "2026-04-01T14:43:29.56Z" },
+    { url = "https://files.pythonhosted.org/packages/67/f9/029a27095ad20f854f9dba026b3ea6428548316e057e6fc3545409e86651/pillow-12.2.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fc3d34d4a8fbec3e88a79b92e5465e0f9b842b628675850d860b8bd300b159f5", size = 7212112, upload-time = "2026-04-01T14:43:32.091Z" },
+    { url = "https://files.pythonhosted.org/packages/be/42/025cfe05d1be22dbfdb4f264fe9de1ccda83f66e4fc3aac94748e784af04/pillow-12.2.0-cp312-cp312-win32.whl", hash = "sha256:58f62cc0f00fd29e64b29f4fd923ffdb3859c9f9e6105bfc37ba1d08994e8940", size = 6378489, upload-time = "2026-04-01T14:43:34.601Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/7b/25a221d2c761c6a8ae21bfa3874988ff2583e19cf8a27bf2fee358df7942/pillow-12.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:7f84204dee22a783350679a0333981df803dac21a0190d706a50475e361c93f5", size = 7084129, upload-time = "2026-04-01T14:43:37.213Z" },
+    { url = "https://files.pythonhosted.org/packages/10/e1/542a474affab20fd4a0f1836cb234e8493519da6b76899e30bcc5d990b8b/pillow-12.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:af73337013e0b3b46f175e79492d96845b16126ddf79c438d7ea7ff27783a414", size = 2463612, upload-time = "2026-04-01T14:43:39.421Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/01/53d10cf0dbad820a8db274d259a37ba50b88b24768ddccec07355382d5ad/pillow-12.2.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:8297651f5b5679c19968abefd6bb84d95fe30ef712eb1b2d9b2d31ca61267f4c", size = 4100837, upload-time = "2026-04-01T14:43:41.506Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/98/f3a6657ecb698c937f6c76ee564882945f29b79bad496abcba0e84659ec5/pillow-12.2.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:50d8520da2a6ce0af445fa6d648c4273c3eeefbc32d7ce049f22e8b5c3daecc2", size = 4176528, upload-time = "2026-04-01T14:43:43.773Z" },
+    { url = "https://files.pythonhosted.org/packages/69/bc/8986948f05e3ea490b8442ea1c1d4d990b24a7e43d8a51b2c7d8b1dced36/pillow-12.2.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:766cef22385fa1091258ad7e6216792b156dc16d8d3fa607e7545b2b72061f1c", size = 3640401, upload-time = "2026-04-01T14:43:45.87Z" },
+    { url = "https://files.pythonhosted.org/packages/34/46/6c717baadcd62bc8ed51d238d521ab651eaa74838291bda1f86fe1f864c9/pillow-12.2.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5d2fd0fa6b5d9d1de415060363433f28da8b1526c1c129020435e186794b3795", size = 5308094, upload-time = "2026-04-01T14:43:48.438Z" },
+    { url = "https://files.pythonhosted.org/packages/71/43/905a14a8b17fdb1ccb58d282454490662d2cb89a6bfec26af6d3520da5ec/pillow-12.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:56b25336f502b6ed02e889f4ece894a72612fe885889a6e8c4c80239ff6e5f5f", size = 4695402, upload-time = "2026-04-01T14:43:51.292Z" },
+    { url = "https://files.pythonhosted.org/packages/73/dd/42107efcb777b16fa0393317eac58f5b5cf30e8392e266e76e51cff28c3d/pillow-12.2.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:f1c943e96e85df3d3478f7b691f229887e143f81fedab9b20205349ab04d73ed", size = 6280005, upload-time = "2026-04-01T14:43:54.242Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/68/b93e09e5e8549019e61acf49f65b1a8530765a7f812c77a7461bca7e4494/pillow-12.2.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:03f6fab9219220f041c74aeaa2939ff0062bd5c364ba9ce037197f4c6d498cd9", size = 8090669, upload-time = "2026-04-01T14:43:57.335Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/6e/3ccb54ce8ec4ddd1accd2d89004308b7b0b21c4ac3d20fa70af4760a4330/pillow-12.2.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5cdfebd752ec52bf5bb4e35d9c64b40826bc5b40a13df7c3cda20a2c03a0f5ed", size = 6395194, upload-time = "2026-04-01T14:43:59.864Z" },
+    { url = "https://files.pythonhosted.org/packages/67/ee/21d4e8536afd1a328f01b359b4d3997b291ffd35a237c877b331c1c3b71c/pillow-12.2.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:eedf4b74eda2b5a4b2b2fb4c006d6295df3bf29e459e198c90ea48e130dc75c3", size = 7082423, upload-time = "2026-04-01T14:44:02.74Z" },
+    { url = "https://files.pythonhosted.org/packages/78/5f/e9f86ab0146464e8c133fe85df987ed9e77e08b29d8d35f9f9f4d6f917ba/pillow-12.2.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:00a2865911330191c0b818c59103b58a5e697cae67042366970a6b6f1b20b7f9", size = 6505667, upload-time = "2026-04-01T14:44:05.381Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/1e/409007f56a2fdce61584fd3acbc2bbc259857d555196cedcadc68c015c82/pillow-12.2.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1e1757442ed87f4912397c6d35a0db6a7b52592156014706f17658ff58bbf795", size = 7208580, upload-time = "2026-04-01T14:44:08.39Z" },
+    { url = "https://files.pythonhosted.org/packages/23/c4/7349421080b12fb35414607b8871e9534546c128a11965fd4a7002ccfbee/pillow-12.2.0-cp313-cp313-win32.whl", hash = "sha256:144748b3af2d1b358d41286056d0003f47cb339b8c43a9ea42f5fea4d8c66b6e", size = 6375896, upload-time = "2026-04-01T14:44:11.197Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/82/8a3739a5e470b3c6cbb1d21d315800d8e16bff503d1f16b03a4ec3212786/pillow-12.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:390ede346628ccc626e5730107cde16c42d3836b89662a115a921f28440e6a3b", size = 7081266, upload-time = "2026-04-01T14:44:13.947Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/25/f968f618a062574294592f668218f8af564830ccebdd1fa6200f598e65c5/pillow-12.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:8023abc91fba39036dbce14a7d6535632f99c0b857807cbbbf21ecc9f4717f06", size = 2463508, upload-time = "2026-04-01T14:44:16.312Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/a4/b342930964e3cb4dce5038ae34b0eab4653334995336cd486c5a8c25a00c/pillow-12.2.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:042db20a421b9bafecc4b84a8b6e444686bd9d836c7fd24542db3e7df7baad9b", size = 5309927, upload-time = "2026-04-01T14:44:18.89Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/de/23198e0a65a9cf06123f5435a5d95cea62a635697f8f03d134d3f3a96151/pillow-12.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:dd025009355c926a84a612fecf58bb315a3f6814b17ead51a8e48d3823d9087f", size = 4698624, upload-time = "2026-04-01T14:44:21.115Z" },
+    { url = "https://files.pythonhosted.org/packages/01/a6/1265e977f17d93ea37aa28aa81bad4fa597933879fac2520d24e021c8da3/pillow-12.2.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:88ddbc66737e277852913bd1e07c150cc7bb124539f94c4e2df5344494e0a612", size = 6321252, upload-time = "2026-04-01T14:44:23.663Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/83/5982eb4a285967baa70340320be9f88e57665a387e3a53a7f0db8231a0cd/pillow-12.2.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d362d1878f00c142b7e1a16e6e5e780f02be8195123f164edf7eddd911eefe7c", size = 8126550, upload-time = "2026-04-01T14:44:26.772Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/48/6ffc514adce69f6050d0753b1a18fd920fce8cac87620d5a31231b04bfc5/pillow-12.2.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2c727a6d53cb0018aadd8018c2b938376af27914a68a492f59dfcaca650d5eea", size = 6433114, upload-time = "2026-04-01T14:44:29.615Z" },
+    { url = "https://files.pythonhosted.org/packages/36/a3/f9a77144231fb8d40ee27107b4463e205fa4677e2ca2548e14da5cf18dce/pillow-12.2.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:efd8c21c98c5cc60653bcb311bef2ce0401642b7ce9d09e03a7da87c878289d4", size = 7115667, upload-time = "2026-04-01T14:44:32.773Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/fc/ac4ee3041e7d5a565e1c4fd72a113f03b6394cc72ab7089d27608f8aaccb/pillow-12.2.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9f08483a632889536b8139663db60f6724bfcb443c96f1b18855860d7d5c0fd4", size = 6538966, upload-time = "2026-04-01T14:44:35.252Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/a8/27fb307055087f3668f6d0a8ccb636e7431d56ed0750e07a60547b1e083e/pillow-12.2.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:dac8d77255a37e81a2efcbd1fc05f1c15ee82200e6c240d7e127e25e365c39ea", size = 7238241, upload-time = "2026-04-01T14:44:37.875Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/4b/926ab182c07fccae9fcb120043464e1ff1564775ec8864f21a0ebce6ac25/pillow-12.2.0-cp313-cp313t-win32.whl", hash = "sha256:ee3120ae9dff32f121610bb08e4313be87e03efeadfc6c0d18f89127e24d0c24", size = 6379592, upload-time = "2026-04-01T14:44:40.336Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c4/f9e476451a098181b30050cc4c9a3556b64c02cf6497ea421ac047e89e4b/pillow-12.2.0-cp313-cp313t-win_amd64.whl", hash = "sha256:325ca0528c6788d2a6c3d40e3568639398137346c3d6e66bb61db96b96511c98", size = 7085542, upload-time = "2026-04-01T14:44:43.251Z" },
+    { url = "https://files.pythonhosted.org/packages/00/a4/285f12aeacbe2d6dc36c407dfbbe9e96d4a80b0fb710a337f6d2ad978c75/pillow-12.2.0-cp313-cp313t-win_arm64.whl", hash = "sha256:2e5a76d03a6c6dcef67edabda7a52494afa4035021a79c8558e14af25313d453", size = 2465765, upload-time = "2026-04-01T14:44:45.996Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/98/4595daa2365416a86cb0d495248a393dfc84e96d62ad080c8546256cb9c0/pillow-12.2.0-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:3adc9215e8be0448ed6e814966ecf3d9952f0ea40eb14e89a102b87f450660d8", size = 4100848, upload-time = "2026-04-01T14:44:48.48Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/79/40184d464cf89f6663e18dfcf7ca21aae2491fff1a16127681bf1fa9b8cf/pillow-12.2.0-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:6a9adfc6d24b10f89588096364cc726174118c62130c817c2837c60cf08a392b", size = 4176515, upload-time = "2026-04-01T14:44:51.353Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/63/703f86fd4c422a9cf722833670f4f71418fb116b2853ff7da722ea43f184/pillow-12.2.0-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:6a6e67ea2e6feda684ed370f9a1c52e7a243631c025ba42149a2cc5934dec295", size = 3640159, upload-time = "2026-04-01T14:44:53.588Z" },
+    { url = "https://files.pythonhosted.org/packages/71/e0/fb22f797187d0be2270f83500aab851536101b254bfa1eae10795709d283/pillow-12.2.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:2bb4a8d594eacdfc59d9e5ad972aa8afdd48d584ffd5f13a937a664c3e7db0ed", size = 5312185, upload-time = "2026-04-01T14:44:56.039Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/8c/1a9e46228571de18f8e28f16fabdfc20212a5d019f3e3303452b3f0a580d/pillow-12.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:80b2da48193b2f33ed0c32c38140f9d3186583ce7d516526d462645fd98660ae", size = 4695386, upload-time = "2026-04-01T14:44:58.663Z" },
+    { url = "https://files.pythonhosted.org/packages/70/62/98f6b7f0c88b9addd0e87c217ded307b36be024d4ff8869a812b241d1345/pillow-12.2.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:22db17c68434de69d8ecfc2fe821569195c0c373b25cccb9cbdacf2c6e53c601", size = 6280384, upload-time = "2026-04-01T14:45:01.5Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/03/688747d2e91cfbe0e64f316cd2e8005698f76ada3130d0194664174fa5de/pillow-12.2.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7b14cc0106cd9aecda615dd6903840a058b4700fcb817687d0ee4fc8b6e389be", size = 8091599, upload-time = "2026-04-01T14:45:04.5Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/35/577e22b936fcdd66537329b33af0b4ccfefaeabd8aec04b266528cddb33c/pillow-12.2.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8cbeb542b2ebc6fcdacabf8aca8c1a97c9b3ad3927d46b8723f9d4f033288a0f", size = 6396021, upload-time = "2026-04-01T14:45:07.117Z" },
+    { url = "https://files.pythonhosted.org/packages/11/8d/d2532ad2a603ca2b93ad9f5135732124e57811d0168155852f37fbce2458/pillow-12.2.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4bfd07bc812fbd20395212969e41931001fd59eb55a60658b0e5710872e95286", size = 7083360, upload-time = "2026-04-01T14:45:09.763Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/26/d325f9f56c7e039034897e7380e9cc202b1e368bfd04d4cbe6a441f02885/pillow-12.2.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9aba9a17b623ef750a4d11b742cbafffeb48a869821252b30ee21b5e91392c50", size = 6507628, upload-time = "2026-04-01T14:45:12.378Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/f7/769d5632ffb0988f1c5e7660b3e731e30f7f8ec4318e94d0a5d674eb65a4/pillow-12.2.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:deede7c263feb25dba4e82ea23058a235dcc2fe1f6021025dc71f2b618e26104", size = 7209321, upload-time = "2026-04-01T14:45:15.122Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/7a/c253e3c645cd47f1aceea6a8bacdba9991bf45bb7dfe927f7c893e89c93c/pillow-12.2.0-cp314-cp314-win32.whl", hash = "sha256:632ff19b2778e43162304d50da0181ce24ac5bb8180122cbe1bf4673428328c7", size = 6479723, upload-time = "2026-04-01T14:45:17.797Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/8b/601e6566b957ca50e28725cb6c355c59c2c8609751efbecd980db44e0349/pillow-12.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:4e6c62e9d237e9b65fac06857d511e90d8461a32adcc1b9065ea0c0fa3a28150", size = 7217400, upload-time = "2026-04-01T14:45:20.529Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/94/220e46c73065c3e2951bb91c11a1fb636c8c9ad427ac3ce7d7f3359b9b2f/pillow-12.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:b1c1fbd8a5a1af3412a0810d060a78b5136ec0836c8a4ef9aa11807f2a22f4e1", size = 2554835, upload-time = "2026-04-01T14:45:23.162Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/ab/1b426a3974cb0e7da5c29ccff4807871d48110933a57207b5a676cccc155/pillow-12.2.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:57850958fe9c751670e49b2cecf6294acc99e562531f4bd317fa5ddee2068463", size = 5314225, upload-time = "2026-04-01T14:45:25.637Z" },
+    { url = "https://files.pythonhosted.org/packages/19/1e/dce46f371be2438eecfee2a1960ee2a243bbe5e961890146d2dee1ff0f12/pillow-12.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:d5d38f1411c0ed9f97bcb49b7bd59b6b7c314e0e27420e34d99d844b9ce3b6f3", size = 4698541, upload-time = "2026-04-01T14:45:28.355Z" },
+    { url = "https://files.pythonhosted.org/packages/55/c3/7fbecf70adb3a0c33b77a300dc52e424dc22ad8cdc06557a2e49523b703d/pillow-12.2.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5c0a9f29ca8e79f09de89293f82fc9b0270bb4af1d58bc98f540cc4aedf03166", size = 6322251, upload-time = "2026-04-01T14:45:30.924Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/3c/7fbc17cfb7e4fe0ef1642e0abc17fc6c94c9f7a16be41498e12e2ba60408/pillow-12.2.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:1610dd6c61621ae1cf811bef44d77e149ce3f7b95afe66a4512f8c59f25d9ebe", size = 8127807, upload-time = "2026-04-01T14:45:33.908Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/c3/a8ae14d6defd2e448493ff512fae903b1e9bd40b72efb6ec55ce0048c8ce/pillow-12.2.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0a34329707af4f73cf1782a36cd2289c0368880654a2c11f027bcee9052d35dd", size = 6433935, upload-time = "2026-04-01T14:45:36.623Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/32/2880fb3a074847ac159d8f902cb43278a61e85f681661e7419e6596803ed/pillow-12.2.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8e9c4f5b3c546fa3458a29ab22646c1c6c787ea8f5ef51300e5a60300736905e", size = 7116720, upload-time = "2026-04-01T14:45:39.258Z" },
+    { url = "https://files.pythonhosted.org/packages/46/87/495cc9c30e0129501643f24d320076f4cc54f718341df18cc70ec94c44e1/pillow-12.2.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fb043ee2f06b41473269765c2feae53fc2e2fbf96e5e22ca94fb5ad677856f06", size = 6540498, upload-time = "2026-04-01T14:45:41.879Z" },
+    { url = "https://files.pythonhosted.org/packages/18/53/773f5edca692009d883a72211b60fdaf8871cbef075eaa9d577f0a2f989e/pillow-12.2.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f278f034eb75b4e8a13a54a876cc4a5ab39173d2cdd93a638e1b467fc545ac43", size = 7239413, upload-time = "2026-04-01T14:45:44.705Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/e4/4b64a97d71b2a83158134abbb2f5bd3f8a2ea691361282f010998f339ec7/pillow-12.2.0-cp314-cp314t-win32.whl", hash = "sha256:6bb77b2dcb06b20f9f4b4a8454caa581cd4dd0643a08bacf821216a16d9c8354", size = 6482084, upload-time = "2026-04-01T14:45:47.568Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/13/306d275efd3a3453f72114b7431c877d10b1154014c1ebbedd067770d629/pillow-12.2.0-cp314-cp314t-win_amd64.whl", hash = "sha256:6562ace0d3fb5f20ed7290f1f929cae41b25ae29528f2af1722966a0a02e2aa1", size = 7225152, upload-time = "2026-04-01T14:45:50.032Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/6e/cf826fae916b8658848d7b9f38d88da6396895c676e8086fc0988073aaf8/pillow-12.2.0-cp314-cp314t-win_arm64.whl", hash = "sha256:aa88ccfe4e32d362816319ed727a004423aab09c5cea43c01a4b435643fa34eb", size = 2556579, upload-time = "2026-04-01T14:45:52.529Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/b7/2437044fb910f499610356d1352e3423753c98e34f915252aafecc64889f/pillow-12.2.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:0538bd5e05efec03ae613fd89c4ce0368ecd2ba239cc25b9f9be7ed426b0af1f", size = 5273969, upload-time = "2026-04-01T14:45:55.538Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/f4/8316e31de11b780f4ac08ef3654a75555e624a98db1056ecb2122d008d5a/pillow-12.2.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:394167b21da716608eac917c60aa9b969421b5dcbbe02ae7f013e7b85811c69d", size = 4659674, upload-time = "2026-04-01T14:45:58.093Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/37/664fca7201f8bb2aa1d20e2c3d5564a62e6ae5111741966c8319ca802361/pillow-12.2.0-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5d04bfa02cc2d23b497d1e90a0f927070043f6cbf303e738300532379a4b4e0f", size = 5288479, upload-time = "2026-04-01T14:46:01.141Z" },
+    { url = "https://files.pythonhosted.org/packages/49/62/5b0ed78fce87346be7a5cfcfaaad91f6a1f98c26f86bdbafa2066c647ef6/pillow-12.2.0-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:0c838a5125cee37e68edec915651521191cef1e6aa336b855f495766e77a366e", size = 7032230, upload-time = "2026-04-01T14:46:03.874Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/28/ec0fc38107fc32536908034e990c47914c57cd7c5a3ece4d8d8f7ffd7e27/pillow-12.2.0-pp311-pypy311_pp73-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4a6c9fa44005fa37a91ebfc95d081e8079757d2e904b27103f4f5fa6f0bf78c0", size = 5355404, upload-time = "2026-04-01T14:46:06.33Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/8b/51b0eddcfa2180d60e41f06bd6d0a62202b20b59c68f5a132e615b75aecf/pillow-12.2.0-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:25373b66e0dd5905ed63fa3cae13c82fbddf3079f2c8bf15c6fb6a35586324c1", size = 6002215, upload-time = "2026-04-01T14:46:08.83Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/60/5382c03e1970de634027cee8e1b7d39776b778b81812aaf45b694dfe9e28/pillow-12.2.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:bfa9c230d2fe991bed5318a5f119bd6780cda2915cca595393649fc118ab895e", size = 7080946, upload-time = "2026-04-01T14:46:11.734Z" },
+]
+
+[[package]]
+name = "pint"
+version = "0.24.4"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+dependencies = [
+    { name = "flexcache", marker = "python_full_version < '3.11'" },
+    { name = "flexparser", marker = "python_full_version < '3.11'" },
+    { name = "platformdirs", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/20/bb/52b15ddf7b7706ed591134a895dbf6e41c8348171fb635e655e0a4bbb0ea/pint-0.24.4.tar.gz", hash = "sha256:35275439b574837a6cd3020a5a4a73645eb125ce4152a73a2f126bf164b91b80", size = 342225, upload-time = "2024-11-07T16:29:46.061Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/16/bd2f5904557265882108dc2e04f18abc05ab0c2b7082ae9430091daf1d5c/Pint-0.24.4-py3-none-any.whl", hash = "sha256:aa54926c8772159fcf65f82cc0d34de6768c151b32ad1deb0331291c38fe7659", size = 302029, upload-time = "2024-11-07T16:29:43.976Z" },
+]
+
+[[package]]
+name = "pint"
+version = "0.25.3"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+dependencies = [
+    { name = "flexcache", marker = "python_full_version >= '3.11'" },
+    { name = "flexparser", marker = "python_full_version >= '3.11'" },
+    { name = "platformdirs", marker = "python_full_version >= '3.11'" },
+    { name = "typing-extensions", marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/52/9d/b1379cdbd33a49d17d627bc24e2b63cca06a1c5343b38072d2889499e82e/pint-0.25.3.tar.gz", hash = "sha256:f8f5df6cf65314d74da1ade1bf96f8e3e4d0c41b51577ac53c49e7d44ca5acee", size = 255106, upload-time = "2026-03-19T21:57:08.72Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1b/dd/a9fe6a0a09512da23951c68bf36466aeecd89def3183dc095edbc807ddc5/pint-0.25.3-py3-none-any.whl", hash = "sha256:27eb25143bd5de9fcc4d5a4b484f16faf6b4615aa93ece6b3373a8c1a3c1b97d", size = 307488, upload-time = "2026-03-19T21:57:07.022Z" },
+]
+
+[[package]]
+name = "platformdirs"
+version = "4.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/47/e4501f49c178ae1d9f4a75073fda4204f52647993f075a9db4d14930e0c5/platformdirs-4.10.0.tar.gz", hash = "sha256:31e761a6a0ca04faf7353ea759bdba55652be214725111e5aac52dfa29d4bef7", size = 31224, upload-time = "2026-05-28T03:32:53.587Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/e6/cd9575ac904136b3cbf7aa7ee819ef86eedb7274e46f230e94ea4342e729/platformdirs-4.10.0-py3-none-any.whl", hash = "sha256:fb516cdb12eb0d857d0cd85a7c57cea4d060bee4578d6cf5a14dfdf8cbf8784a", size = 22743, upload-time = "2026-05-28T03:32:52.175Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "propcache"
+version = "0.5.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ec/44/c87281c333769159c50594f22610f77398a47ccbfbbf23074e744e86f87c/propcache-0.5.2.tar.gz", hash = "sha256:01c4fc7480cd0598bb4b57022df55b9ca296da7fc5a8760bd8451a7e63a7d427", size = 50208, upload-time = "2026-05-08T21:02:12.199Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5b/56/030b7b4719d53085722893e0009dffb9236aa10bca1b12121bdc5626ef16/propcache-0.5.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d5a81be28596d6559f6131ef33e10200de6e17643b3c74ce03f9eb103be6ae8b", size = 93417, upload-time = "2026-05-08T20:59:15.597Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/55/1140a8e067b8ec093a18a4ae7bb0045d9db65da38a08618ddc5e2f1994aa/propcache-0.5.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:29cbaac5ea0212663e6845e04b5e188d5a6ae6dd919810ac835bf1d3b42c3f4c", size = 53847, upload-time = "2026-05-08T20:59:17.096Z" },
+    { url = "https://files.pythonhosted.org/packages/20/42/0e7443c90310498561addf346e7d57fe3c6ba1914e1ba938b5464c7bbfd2/propcache-0.5.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:6bf3be92233808fcd338eba0fb4d0b59ec5772af4f4ecfcec450d1bfc0f8b5eb", size = 53512, upload-time = "2026-05-08T20:59:18.64Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/db/cf51a71bab2009517d1a7f0ee07657e3bd446c4d69f67e6966cf17bcf956/propcache-0.5.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2f8ea531c794b9d6274acd4e8d2c2ebcac590a4361d27482edd3010b79f1325e", size = 58068, upload-time = "2026-05-08T20:59:20.683Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/43/39b6bdee9699fa1e1641c519feeb64a67e2a9f93bb465c70776b37a7333f/propcache-0.5.2-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:decfca4c79dd53ebab484b00cc4b6717d8c369f86e74aa4ca395a64ac651495e", size = 61020, upload-time = "2026-05-08T20:59:22.112Z" },
+    { url = "https://files.pythonhosted.org/packages/26/0b/843726fbb0a29a8c5684fdb25971823638399f31e52e9d1f06a02dc9aa6b/propcache-0.5.2-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4621064bbf28fa77ff64dd5d94367c04684c67d3a5bf1dff25f0cd0d98a38f3b", size = 62732, upload-time = "2026-05-08T20:59:23.805Z" },
+    { url = "https://files.pythonhosted.org/packages/39/6e/899fed76dc1942b8a64193a4f059d7f1a2c7ef65085e8a9366ed8ec0d199/propcache-0.5.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b96db7141a592cbc968daf1feea83a118e6ab378af4abbc72b248c895414c22d", size = 60140, upload-time = "2026-05-08T20:59:25.389Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/09/3da4be9b5b879219ad234aa535b3dd4a080ed1ad48d3a73ca07a9e798f22/propcache-0.5.2-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1ca071adabaab6e9219924bbe00af821f1ee7de113a9eca1cdc292de3d120f4d", size = 60400, upload-time = "2026-05-08T20:59:27.238Z" },
+    { url = "https://files.pythonhosted.org/packages/60/2f/09b72b874a9aa0044faf52a69807a6ed618e267ceaa9ec4a63195fa5b504/propcache-0.5.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:e4294d04a94dcab1b3bccd8b66d962dcad411a1d19414b2a41d1445f1de32ad0", size = 58155, upload-time = "2026-05-08T20:59:28.48Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/37/97489848c54c95578045473954f10956d619ce6a09e7ac137b71cdcb698b/propcache-0.5.2-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:a0e399a2eccb91ed18721f86aa85757727400b6865c89e88934781deb9c8498b", size = 57037, upload-time = "2026-05-08T20:59:30.146Z" },
+    { url = "https://files.pythonhosted.org/packages/22/db/6c695285ccfc49012743ee9c98212b8c5dd0aed7b63cfd816d4a0f7a1601/propcache-0.5.2-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:823581fd5cb08b12a48bfa11fe962a7916766b6170c17b028fbdf762b85eb9bf", size = 61103, upload-time = "2026-05-08T20:59:31.626Z" },
+    { url = "https://files.pythonhosted.org/packages/98/a9/1e500401ca593b0bdb6bf75a70bc2d723835fd53360edff6af70692c7546/propcache-0.5.2-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:949c91d1a990cf3b2e8188dfcfb25005e0b834a06c63fa4ef9f360878ce21ecf", size = 60394, upload-time = "2026-05-08T20:59:32.829Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/87/f638b6e375eae0f30a1a2325d8b34fd85fdc785bb9960cf805f3bf1ec69a/propcache-0.5.2-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:cc1177027eda740fdb152706bd215a3f124e3eea15afc39f2cb9fe351b50619e", size = 63084, upload-time = "2026-05-08T20:59:35.964Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/18/884573f5d97b6d9eba68de759a82c901b7e39d7904d30f7b8d58d42d2a12/propcache-0.5.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:b05d643f944a8c3c4bd86d65ffd87bf3264b617f87791940302bc474d2ff5274", size = 60999, upload-time = "2026-05-08T20:59:38.481Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/1a/c3915eb059ceec9e758a56e4cfd955292bc0f201be2176a46b76d94b303a/propcache-0.5.2-cp310-cp310-win32.whl", hash = "sha256:8114f28879e0904748e831c3a7774261bd9e75f49be089f389a76f959dcd13fe", size = 39036, upload-time = "2026-05-08T20:59:40.323Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/02/1dfd5607501a602d19c1c449d2d193b7d1c611f9246b4059026a1189a80e/propcache-0.5.2-cp310-cp310-win_amd64.whl", hash = "sha256:5fcb98e7598b1ee0addab320d90f65b530297a867dbfe9de52ea838077e16e3d", size = 42190, upload-time = "2026-05-08T20:59:42.232Z" },
+    { url = "https://files.pythonhosted.org/packages/57/93/f71588ad08b3e6f4b555b5ef215808a3c02b042d0151ad82fa6f15be677a/propcache-0.5.2-cp310-cp310-win_arm64.whl", hash = "sha256:04dc2390d9edbbaef7461f33322555976ffddf0b650a038649d026358714e6c5", size = 38545, upload-time = "2026-05-08T20:59:44.087Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/f1/8a8cc1c2c7e7934ab77e0163414f736fadbc0f5e8dd9673b952355ac175b/propcache-0.5.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:74b70780220e2dd89175ca24b81b68b67c83db499ae611e7f2313cb329801c78", size = 90744, upload-time = "2026-05-08T20:59:45.799Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/f4/651b1225e976bd1a2ba5cfba0c29d096581c2636b437e3a9a7ab6276270a/propcache-0.5.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:a4840ab0ae0216d952f4b53dc6d0b992bfc2bedbfe360bdd9b548bc184c08959", size = 52033, upload-time = "2026-05-08T20:59:47.408Z" },
+    { url = "https://files.pythonhosted.org/packages/15/a8/8ede85d6aa1f79fc7dc2f8fd2c8d65920b8272c3892903c8a1affde48cfb/propcache-0.5.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c6844ba6364fb12f403928a82cfd295ab103a2b315c77c747b2dbe4a41894ea7", size = 52754, upload-time = "2026-05-08T20:59:49.202Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/fe/b3551b41bbc2f5b5bb088fc6920567cd43101253e68fbaa261339eb96fe1/propcache-0.5.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2293949b855ce597f2826452d17c2d545fb5622379c4ea6fdf525e9b8e8a2511", size = 57573, upload-time = "2026-05-08T20:59:50.778Z" },
+    { url = "https://files.pythonhosted.org/packages/83/27/ab851ebd1b7172e3e161f5f8d39e315d54a91bea246f01f4d872d3376aef/propcache-0.5.2-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0fd59b5af35f74da48d905dcbad55449ba13be91823cb05a9bd590bbf5b61660", size = 60645, upload-time = "2026-05-08T20:59:52.227Z" },
+    { url = "https://files.pythonhosted.org/packages/95/7d/466b3d18022e9897cbda9c735c493c5bd747d7a4c6f5ea1480b4cec434b6/propcache-0.5.2-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:29f9309a2e42b0d273be006fdb4be2d6c39a47f6f57d8fb1cf9f81481df81b66", size = 61563, upload-time = "2026-05-08T20:59:53.866Z" },
+    { url = "https://files.pythonhosted.org/packages/27/1b/16ab7f2cf2041da2f60d156ba64c2484eadf9168075b4ff43c3ef60045af/propcache-0.5.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5aaa2b923c1944ac8febd6609cb373540a5563e7cbcb0fd770f75dace2eb817b", size = 58888, upload-time = "2026-05-08T20:59:55.457Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/67/bb777ffd907633563bf35fd859c4ce97b0512c32f4633cf5d1eb7c33512b/propcache-0.5.2-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:66ea454f095ddf5b6b14f56c064c0941c4788be11e18d2464cf643bf7203ff67", size = 59253, upload-time = "2026-05-08T20:59:57.075Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/42/64f8d90b73fd9cdc1499b48057ff6d9cd2a98a25734c9bb62ecf07e87061/propcache-0.5.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:95f1e3f4760d404b13c9976c0229b2b49a3c8e2c62a9ce92efdd2b11ada75e3f", size = 57558, upload-time = "2026-05-08T20:59:58.602Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/02/dba5bc03c9041f2092ea55a449caf5dfe68352c6654511b29ba0654ddb69/propcache-0.5.2-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:85341b12b9d55bad0bded24cac341bb34289469e03a11f3f583ea1cc1db0326c", size = 55007, upload-time = "2026-05-08T20:59:59.837Z" },
+    { url = "https://files.pythonhosted.org/packages/14/c0/43f649c7aa2a77a3b100d84e9dea3a483120ecb608bfe36ce49eaff517fe/propcache-0.5.2-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:26a4dca084132874e639895c3135dfad5eb20bae209f62d1aeb31b03e601c3c0", size = 60355, upload-time = "2026-05-08T21:00:01.144Z" },
+    { url = "https://files.pythonhosted.org/packages/83/c0/435dafd27f1cb4a495381dae60e25883ccfe4020bb72818e8184c1678092/propcache-0.5.2-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:3b199b9b2b3d6a7edf3183ba8a9a137a22b97f7df525feb5ae1eccf026d2a9c6", size = 59057, upload-time = "2026-05-08T21:00:02.401Z" },
+    { url = "https://files.pythonhosted.org/packages/53/ae/6e292df9135d659944e96cb3389258e4a663e5b2b5f6c217ef0ddc8d2f73/propcache-0.5.2-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:e59bc9e66329185b93dab73f210f1a37f81cb40f321501db8017c9aea15dba27", size = 61938, upload-time = "2026-05-08T21:00:03.638Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/42/314ebc50d8159055411fd6b0bda322ff510e4b1f7d2e4927940ad0f6af20/propcache-0.5.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:552ffadf6ad409844bc5919c42a0a83d88314cedddaea0e41e80a8b8fffe881f", size = 59731, upload-time = "2026-05-08T21:00:04.881Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/9b/2da6dee38871c3c8772fabc2758325a5c9077d6d18c597737dc04dd884cd/propcache-0.5.2-cp311-cp311-win32.whl", hash = "sha256:cd416c1de191973c52ff1a12a57446bfc7642797b282d7caf2162d7d1b8aa9a0", size = 38966, upload-time = "2026-05-08T21:00:06.511Z" },
+    { url = "https://files.pythonhosted.org/packages/42/4e/f17363fb58c0afe05b067361cb6d86ed2d29de6506779a27547c4d183075/propcache-0.5.2-cp311-cp311-win_amd64.whl", hash = "sha256:44e488ef40dbb452700b2b1f8188934121f6648f52c295055662d2191959ff82", size = 42135, upload-time = "2026-05-08T21:00:08.088Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/eb/6af6685077d22e8b33358d3c548e3282706a0b3cd85044ffba4e5dd08e3b/propcache-0.5.2-cp311-cp311-win_arm64.whl", hash = "sha256:54adaa85a22078d1e306304a40984dc5be99d599bf3dc0a24dc98f7daeab89ab", size = 38381, upload-time = "2026-05-08T21:00:09.692Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/cb/e27bc2b2737a0bb49962b275efa051e8f1c35a936df7d5139b6b658b7dc9/propcache-0.5.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:806719138ecd720339a12410fb9614ac9b2b2d3a5fdf8235d56981c36f4039ba", size = 95887, upload-time = "2026-05-08T21:00:11.277Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/13/b8ae04c59392f8d11c6cd9fb4011d1dc7c86b81225c770280300e259ffe1/propcache-0.5.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:db2b80ea58eab4f86b2beec3cc8b39e8ff9276ac20e96b7cce43c8ae84cd6b5a", size = 54654, upload-time = "2026-05-08T21:00:12.604Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/7d/49777a3e20b55863d4794384a38acd460c04157b0a00f8602b0d508b8431/propcache-0.5.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:e5cbfac9f61484f7e9f3597775500cd3ebe8274e9b050c38f9525c77c97520bf", size = 55190, upload-time = "2026-05-08T21:00:13.935Z" },
+    { url = "https://files.pythonhosted.org/packages/44/c7/085d0cd63062e84044e3f05797749c3f8e3938ff3aeb0eb2f69d43fafc91/propcache-0.5.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5dbc581d2814337da56222fab8dc5f161cd798a434e49bac27930aaef798e144", size = 59995, upload-time = "2026-05-08T21:00:15.526Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/42/32cf8e3009e92b2645cf1e944f701e8ea4e924dffde1ee26db860bcbf7e4/propcache-0.5.2-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:857187f381f88c8e2fa2fe56ab94879d011b883d5a2ee5a1b60a8cd2a06846d9", size = 63422, upload-time = "2026-05-08T21:00:16.824Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/1b/f112433f99fc979431b87a39ef169e3f8df070d99a72792c56d6937ac48b/propcache-0.5.2-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:178b4a2cdaac1818e2bf1c5a99b94383fa73ea5382e032a48dec07dc5668dc42", size = 64342, upload-time = "2026-05-08T21:00:18.362Z" },
+    { url = "https://files.pythonhosted.org/packages/14/15/5574111ae50dd6e879456888c0eadd4c5a869959775854e18e18a6b345f3/propcache-0.5.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6f328175a2cde1f0ff2c4ed8ce968b9dcfb55f3a7153f39e2957ed994da13476", size = 61639, upload-time = "2026-05-08T21:00:19.692Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/da/4d775080b1490c0ae604acda868bd71aabe3a89ed16f2aa4339eb8a283e7/propcache-0.5.2-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:5671d09a36b06d0fd4a3da0fccbcae360e9b1570924171a15e9e0997f0249fba", size = 61588, upload-time = "2026-05-08T21:00:21.155Z" },
+    { url = "https://files.pythonhosted.org/packages/04/ac/f076982cbe2195ee9cf32de5a1e46951d9fb399fc207f390562dd0fd8fb2/propcache-0.5.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:80168e2ebe4d3ec6599d10ad8f520304ae1cad9b6c5a95372aef1b66b7bfb53a", size = 60029, upload-time = "2026-05-08T21:00:22.713Z" },
+    { url = "https://files.pythonhosted.org/packages/70/60/189be62e0dd898dce3b331e1b8c7a543cd3a405ac0c81fe8ee8a9d5d77e1/propcache-0.5.2-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:45f11346f884bc47444f6e6647131055844134c3175b629f84952e2b5cd62b64", size = 56774, upload-time = "2026-05-08T21:00:24.001Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/9e/93377b9c7939c1ffae98f878dee955efadfd638078bc86dbc21f9d52f651/propcache-0.5.2-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:8e778ebd44ef4f66ed60a0416b06b489687db264a9c0b3620362f26489492913", size = 63532, upload-time = "2026-05-08T21:00:25.545Z" },
+    { url = "https://files.pythonhosted.org/packages/14/f9/590ef6cfb9b8028d516d287812ece32bb0bc5f11fbb9c8bf6b2e6313fec8/propcache-0.5.2-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:c0cb9ed24c8964e172768d455a38254c2dd8a552905729ce006cad3d3dda59b1", size = 61592, upload-time = "2026-05-08T21:00:27.186Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/5e/70958b3034c297a630bba2f17ca7abc2d5f39a803ad7e370ab79d1ecd022/propcache-0.5.2-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:1d1ad32d9d4355e2be65574fd0bfd3677e7066b009cd5b9b2dee8aa6a6393b33", size = 64788, upload-time = "2026-05-08T21:00:28.8Z" },
+    { url = "https://files.pythonhosted.org/packages/12/fd/77fe5936d8c3086ca9048f7f415f122ed82e53884a9ec193646b42deef06/propcache-0.5.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:c80f4ba3e8f00189165999a742ee526ebeccedf6c3f7beb0c7df821e9772435a", size = 62514, upload-time = "2026-05-08T21:00:30.098Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/74/66bd798b5b3be70aa1b391f5cc9d6a0a5532d7fd3b19ec0b213e72e6ad9d/propcache-0.5.2-cp312-cp312-win32.whl", hash = "sha256:8c7972d8f193740d9175f0998ab38717e6cd322d5935c5b0fef8c0d323fd9031", size = 39018, upload-time = "2026-05-08T21:00:31.622Z" },
+    { url = "https://files.pythonhosted.org/packages/61/7c/5c0d34aa3024694d6dcb9271cdbdd08c4e47c1c0ad95ec7e7bc74cdea145/propcache-0.5.2-cp312-cp312-win_amd64.whl", hash = "sha256:d9ee8826a7d47863a08ac44e1a5f611a462eefc3a194b492da242128bec75b42", size = 42322, upload-time = "2026-05-08T21:00:32.918Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/91/875812f1a3feb20ceba818ef39fbe4d92f1081e04ac815c822496d0d038b/propcache-0.5.2-cp312-cp312-win_arm64.whl", hash = "sha256:2800a4a8ead6b28cccd1ec54b59346f0def7922ee1c7598e8499c733cfbb7c84", size = 38172, upload-time = "2026-05-08T21:00:35.124Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/09/f049e45385503fe67db75a6b6186a7b9f0c3930366dc960522c312a825b1/propcache-0.5.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:099aaf4b4d1a02265b92a977edf00b5c4f63b3b17ac6de39b0d637c9cac0188a", size = 94457, upload-time = "2026-05-08T21:00:36.355Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/65/83d1d05655baf63113731bd5a1008435e14f8d1e5a06cbe4ec5b23ad7a31/propcache-0.5.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:68ce1c44c7a813a7f71ea04315a8c7b330b63db99d059a797a4651bb6f69f117", size = 53835, upload-time = "2026-05-08T21:00:38.072Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/12/a6ba6482bb5ea3260c000c9b20881c95fa11c6b30173715668259f844ed7/propcache-0.5.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:fc299c129490f55f254cd90be0deca4764e36e9a7c08b4aa588479a3bbed3098", size = 54545, upload-time = "2026-05-08T21:00:39.319Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/19/7fa086f5764c59ec8a8e157cd93aa8497acc00aba9dcdec56bfffb32602d/propcache-0.5.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a6ae2198be502c10f09b2516e7b5d019816924bc3183a43ce792a7bd6625e6f4", size = 59886, upload-time = "2026-05-08T21:00:40.621Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/e4/5d7663dc8235956c8f5281698a3af1d351d8820341ddd890f59d9a9127f2/propcache-0.5.2-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6041d31504dc1779d700e1edcfb08eea334b357620b06681a4eabb57a74e574e", size = 63261, upload-time = "2026-05-08T21:00:41.775Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/4a/15a03adee24d6350da4292caeac44c34c033d2afe5e87eb370f38854560f/propcache-0.5.2-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f7eabc04151c78a9f4d5bbb5f1faf571e4defeb4b585e0fe95b60ff2dbe4d3d7", size = 64184, upload-time = "2026-05-08T21:00:43.018Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/c6/979176efdaa3d239e36d503d5af63a0a773b36662ed8f52e5b6a6d9fd40e/propcache-0.5.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4db0ba63d693afd40d249bd93f842b5f144f8fcbb83de05660373bcf30517b1d", size = 61534, upload-time = "2026-05-08T21:00:44.507Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/22/63e8cd1bae4c2d2be6493b6b7d10566ddafad88137cfbc99964a1119853c/propcache-0.5.2-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1dbcf7675229b35d31abb6547d8ebc8c27a830ac3f9a794edff6254873ec7c0a", size = 61500, upload-time = "2026-05-08T21:00:45.796Z" },
+    { url = "https://files.pythonhosted.org/packages/60/5a/28e5d9acbac1cc9ccb67045e8c1b943aa8d79fdf39c93bd73cacd68008ea/propcache-0.5.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d310c013aad2c72f1c3f2f8dd3279d460a858c551f97aeb8c63e4693cca7b4d2", size = 59994, upload-time = "2026-05-08T21:00:47.093Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/40/db650677f554a95b9c01a7c9d93d629e93a15562f5deb4573c9ee136fed2/propcache-0.5.2-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:06187263ddad280d05b4d8a8b3bb7d164cbebd469236544a42e6d9b28ac6a4fa", size = 56884, upload-time = "2026-05-08T21:00:48.376Z" },
+    { url = "https://files.pythonhosted.org/packages/80/45/70b39b89516ff8b96bf732fa6fded8cef20f293cb1508690101c3c07ec51/propcache-0.5.2-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:3115559b8effafd63b142ea5ed53d63a16ea6469cbc63dce4ee194b42db5d853", size = 63464, upload-time = "2026-05-08T21:00:49.954Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/e2/fa59d3a89eac5534293124af4f1d0d0ada091ce4a0ab4610ce03fd2bdd8d/propcache-0.5.2-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c60462af8e6dc30c35407c7237ea908d777b22862bbee27bc4699c0d8bcdc45a", size = 61588, upload-time = "2026-05-08T21:00:51.281Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/97/efb547a55c4bc7381cfb202d6a2239ac621045277bc1ea5dfd3a7f0516c0/propcache-0.5.2-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:40314bca9ac559716fe374094fc81c11dcc34b64fd6c585360f5775690505704", size = 64667, upload-time = "2026-05-08T21:00:52.602Z" },
+    { url = "https://files.pythonhosted.org/packages/92/56/f5c7d9b4b7595d5127da38974d791b2153f3d1eae6c674af3583ace92ad3/propcache-0.5.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:cfa21e036ce1e1db2be04ba3b85d2df1bb1702fa01932d984c5464c665228ff4", size = 62463, upload-time = "2026-05-08T21:00:54.303Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/3b/484a3a65fc9f9f60c41dcd17b428bace5389544e2c680994534a20755066/propcache-0.5.2-cp313-cp313-win32.whl", hash = "sha256:f156a3529f38063b6dbaf356e15602a7f95f8055b1295a438433a6386f10463d", size = 38621, upload-time = "2026-05-08T21:00:55.808Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/fd/3f0f10dba4dabad3bf53102be007abf55481067952bde0fdddff439e7c61/propcache-0.5.2-cp313-cp313-win_amd64.whl", hash = "sha256:dfed59d0a5aeb01e242e66ff0300bc4a265a7c05f612d30016f0b60b1017d757", size = 41649, upload-time = "2026-05-08T21:00:57.061Z" },
+    { url = "https://files.pythonhosted.org/packages/90/ec/6ce619cc32bb500a482f811f9cd509368b4e58e638d13f2c68f370d6b475/propcache-0.5.2-cp313-cp313-win_arm64.whl", hash = "sha256:ba338430e87ceb9c8f0cf754de38a9860560261e56c00376debd628698a7364f", size = 37636, upload-time = "2026-05-08T21:00:58.646Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/82/c1d268bbbf2ef981c5bf0fbbe746db617c66e3bcefe431a1aa8943fbe23a/propcache-0.5.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:a592f5f3da71c8691c788c13cb6734b6d17663d2e1cb8caddf0673d01ef8847d", size = 98872, upload-time = "2026-05-08T21:00:59.889Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/d4/52c871e73e864e6b34c0e2d58ac1ec5ccd149497ddc7ad2137ae98323a35/propcache-0.5.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:6a997d0489e9668a384fcfd5061b857aa5361de73191cac204d04b889cfbbafa", size = 56257, upload-time = "2026-05-08T21:01:01.195Z" },
+    { url = "https://files.pythonhosted.org/packages/67/f0/9b90ca2a210b3d09bcfcd96ecd0f55545c091535abce2a45de2775cfd357/propcache-0.5.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:10734b5484ea113152ee25a91dccedf81631791805d2c9ccb054958e51842c94", size = 56696, upload-time = "2026-05-08T21:01:02.941Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/0e/6e9d4ba07c8e56e21ddec1e75f12148142b21ca83a51871babce095334f4/propcache-0.5.2-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cafca7e56c12bb02ae16d283742bef25a61122e9dab2b5b3f2ccbe589ce32164", size = 62378, upload-time = "2026-05-08T21:01:04.475Z" },
+    { url = "https://files.pythonhosted.org/packages/65/19/c10badaa463dde8a27ce884f8ee2ec37e6035b7c9f5ff0c8f74f06f08dac/propcache-0.5.2-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f064f8d2b59177878b7615df1735cd8fe3462ed6be8c7b217d17a276489c2b7f", size = 65283, upload-time = "2026-05-08T21:01:05.959Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/b6/93bea99ca80e19cef6512a8580e5b7857bbe09422d9daa7fd4ef5723306c/propcache-0.5.2-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f78abfa8dfc32376fd1aacf597b2f2fbbe0ea751419aee718af5d4f82537ef8c", size = 66616, upload-time = "2026-05-08T21:01:07.228Z" },
+    { url = "https://files.pythonhosted.org/packages/83/e4/5c7462e50625f051f37fb38b8224f7639f667184bbd34424ec83819bb1b7/propcache-0.5.2-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f7467da8a9822bf1a55336f877340c5bcbd3c482afc43a99771169f74a26dedc", size = 63773, upload-time = "2026-05-08T21:01:08.514Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/b6/99238894047b13c823be25027e736626cd414a52a5e30d2c3347c2733529/propcache-0.5.2-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a6ddc6ac9e25de626c1f129c1b467d7ecd33ce2237d3fd0c4e429feef0a7ee1f", size = 63664, upload-time = "2026-05-08T21:01:09.874Z" },
+    { url = "https://files.pythonhosted.org/packages/85/1e/a3a1a63116a2b8edb415a8bb9a6f0c34bd03830b1e18e8ce2904e1dc1cf4/propcache-0.5.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:2f22cbbac9e26a8e864c0985ff1268d5d939d53d9d9411a9824279097e03a2cb", size = 62643, upload-time = "2026-05-08T21:01:11.132Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/03/893cf147de2fc6543c5eaa07ad833170e7e2a2385725bbebe8c0503723bb/propcache-0.5.2-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:fc76378c62a0f04d0cd82fbb1a2cd2d7e28fcb40d5873f28a6c44e388aaa2751", size = 59595, upload-time = "2026-05-08T21:01:12.387Z" },
+    { url = "https://files.pythonhosted.org/packages/86/3b/04c1a2e12c57766568ba75ba72b3bf2042818d4c1425fab6fc07155c7cff/propcache-0.5.2-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:acd2c8edba48e31e58a363b8cf4e5c7db3b04b3f9e371f601df30d9b0d244836", size = 65711, upload-time = "2026-05-08T21:01:13.676Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/34/80f8d0099f8d6bacc4de1624c85672681c8cd1149ca2da0e38fd120b817f/propcache-0.5.2-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:452b5065457eb9991ec5eb38ff41d6cd4c991c9ac7c531c4d5849ae473a9a13f", size = 64247, upload-time = "2026-05-08T21:01:14.936Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/1a/8b08f3a5f1037e9e370c55883ceeeee0f6dd0416fb2d2d67b8bfc91f2a79/propcache-0.5.2-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:3430bb2bfe1331885c427745a751e774ee679fd4344f80b97bf879815fe8fa55", size = 67102, upload-time = "2026-05-08T21:01:16.281Z" },
+    { url = "https://files.pythonhosted.org/packages/34/68/8bdb7bb7756d76e005490649d10e4a8369e610c74d619f71e1aedf889e9c/propcache-0.5.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:cef6cea3922890dd6c9654971001fa797b526c16ab5e1e46c05fd6f877be7568", size = 64964, upload-time = "2026-05-08T21:01:17.57Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/aa/50fb0b5d3968b61a510926ff8b8465f1d6e976b3ab74496d7a4b9fc42515/propcache-0.5.2-cp313-cp313t-win32.whl", hash = "sha256:72d61e16dd78228b58c5d47be830ff3da7e5f139abdf0aef9d86cde1c5cf2191", size = 42546, upload-time = "2026-05-08T21:01:18.946Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/4c/0ddbae64321bd4a95bcbfc19307238016b5b1fee645c84626c8d539e5b74/propcache-0.5.2-cp313-cp313t-win_amd64.whl", hash = "sha256:0958834041a0166d343b8d2cedcd8bcbaeb4fdbe0cf08320c5379f143c3be6e7", size = 46330, upload-time = "2026-05-08T21:01:20.162Z" },
+    { url = "https://files.pythonhosted.org/packages/00/d9/9cddc8efb78d8af264c5ec9f6d10b62f57c515feda8d321595f56010fb23/propcache-0.5.2-cp313-cp313t-win_arm64.whl", hash = "sha256:6de8bd93ddde9b992cf2b2e0d796d501a19026b5b9fd87356d7d0779531a8d96", size = 40521, upload-time = "2026-05-08T21:01:21.399Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/ea/23ee535d90ce8bcc465a3028eb3cc0ce3bd1005f4bb27710b30587de798d/propcache-0.5.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:46088abff4cba581dea21ae0467a480526cb25aa5f3c269e909f800328bc3999", size = 94662, upload-time = "2026-05-08T21:01:22.683Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/06/c5a52f419b5d8972f8d46a7577476090d8e3263ff589ce40b5ca4968d5be/propcache-0.5.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fc88b26f08d634f7bc819a7852e5214f5802641ab8d9fd5326892292eee1993e", size = 53928, upload-time = "2026-05-08T21:01:23.986Z" },
+    { url = "https://files.pythonhosted.org/packages/63/b1/4260d67d6bd85e58a66b72d54ce15d5de789b6f3870cc6bedf8ff9667401/propcache-0.5.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:97797ebb098e670a2f92dd66f32897e30d7615b14e7f59711de23e30a9072539", size = 54650, upload-time = "2026-05-08T21:01:25.305Z" },
+    { url = "https://files.pythonhosted.org/packages/70/06/2f46c318e3307cd7a6a7481def374ce838c0fe20084b39dd54b0879d0e99/propcache-0.5.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ba57fffe4ac99c5d30076161b5866336d97600769bad35cc68f7774b15298a4e", size = 59912, upload-time = "2026-05-08T21:01:26.545Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/29/fe1aebec2ce57ab985a9c382bded1124431f85078113aa222c5d278430d4/propcache-0.5.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:583c19759d9eec1e5b69e2fbef36a7d9c326041be9746cb822d335c8cedc2979", size = 63300, upload-time = "2026-05-08T21:01:27.937Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/18/2334b26768b6c82be8c69e83671b767d5ef426aa09b0cba6c2ea47816774/propcache-0.5.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d0326e2e5e1f3163fa306c834e48e8d490e5fae607a097a40c0648109b47ba80", size = 64208, upload-time = "2026-05-08T21:01:29.484Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/76/7f1bfd6afff4c5e38e36a3c6d68eb5f4b7311ea80baf693db78d95b603c4/propcache-0.5.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e00820e192c8dbebcafb383ebbf99030895f09905e7a0eb2e0340a0bcc2bc825", size = 61633, upload-time = "2026-05-08T21:01:31.068Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/46/b3ff8aba2b4953a3e50de2cf72f1b5748b8eca93b15f3dc2c84339084c09/propcache-0.5.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c66afea89b1e43725731d2004732a046fe6fe955d51f952c3e95a7314a284a39", size = 61724, upload-time = "2026-05-08T21:01:32.374Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/01/814cfcafbcff954f94c01cf30e097ddc88a076b5440fbcf4570753437d40/propcache-0.5.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d4dc37dec6c6cdad0b57881a5658fd14fbf53e333b1a86cf86559f190e1d9ec4", size = 60069, upload-time = "2026-05-08T21:01:33.67Z" },
+    { url = "https://files.pythonhosted.org/packages/da/68/5c6f7622d510cc666a300687e06fd060c1a43361c0c9b20d284f06d8096a/propcache-0.5.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:5570dbcc97571c15f68068e529c92715a12f8d54030e272d264b377e22bd17a5", size = 57099, upload-time = "2026-05-08T21:01:34.915Z" },
+    { url = "https://files.pythonhosted.org/packages/55/27/9cb0b4c679124085327957d42521c99dba04c88c90c3e55a6f0b633ebccc/propcache-0.5.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:f814362777a9f841adddb200ecdf8f5cb1e5a3c4b7a86378edbd6ccb26edd702", size = 63391, upload-time = "2026-05-08T21:01:36.231Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/9d/7258aaa5bdf60fc6f27591eef6fe52768cb0beda7140be477c8b12c9794a/propcache-0.5.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:196913dea116aeb5a2ba95af4ddcb7ea85559ae07d8eee8751688310d09168c3", size = 61626, upload-time = "2026-05-08T21:01:37.545Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/0d/41c602003e8a9b16fe1e7eadf62c7bfba9d5474370b24200bf48b315f45f/propcache-0.5.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:6e7b8719005dd1175be4ab1cd25e9b98659a5e0347331506ec6760d2773a7fb5", size = 64781, upload-time = "2026-05-08T21:01:38.83Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/f3/38e66b1856e9bd079deea015bc4a55f7767c0e4db2f7dcf69e7e680ba4ce/propcache-0.5.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:51f96d685ab16e88cab128cd37a52c5da540809c8b879fa047731bfcb4ad35a4", size = 62570, upload-time = "2026-05-08T21:01:40.415Z" },
+    { url = "https://files.pythonhosted.org/packages/95/ca/bbfe9b910ce57dde8bb4876b4520fc02a4e89497c10de26be936758a3aaa/propcache-0.5.2-cp314-cp314-win32.whl", hash = "sha256:cc6fc3cc62e8501d3ed62894425040d2728ecddb1ed072737a5c70bd537aa9f0", size = 39436, upload-time = "2026-05-08T21:01:41.654Z" },
+    { url = "https://files.pythonhosted.org/packages/61/d2/45c9defbaa1ea297035d9d4cce9e8f80daafbf19319c6007f157c6256ea9/propcache-0.5.2-cp314-cp314-win_amd64.whl", hash = "sha256:81e3a30b0bb60caa22033dd0f8a3618d1d67356212514f62c57db75cb0ef410c", size = 42373, upload-time = "2026-05-08T21:01:43.041Z" },
+    { url = "https://files.pythonhosted.org/packages/44/68/9ea5103f41d5217d7d6ec24db90018e23aebec070c3f9a6e54d12b841fd8/propcache-0.5.2-cp314-cp314-win_arm64.whl", hash = "sha256:0d2c9bf8528f135dbb805ce027567e09164f7efa51a2be07458a2c0420f292d0", size = 38554, upload-time = "2026-05-08T21:01:44.336Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/81/fadf555f42d3b762eea8a53950b0489fdc0aa9da5f8ed9e10ce0a4e01b48/propcache-0.5.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:4bc8ff1feffc6a61c7002ffe84634c41b822e104990ae009f44a0834430070bb", size = 99395, upload-time = "2026-05-08T21:01:45.883Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/c9/c61e134a686949cf7971af3a390148b1156f7be81c73bc0cd12c873e2d48/propcache-0.5.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:79aa3ff0a9b566633b642fa9caf7e21ed1c13d6feca718187873f199e1514078", size = 56653, upload-time = "2026-05-08T21:01:47.307Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/73/daf935ea7048ddd7ec8eec5345b4a40b619d2d178b3c0a0900796bc3c794/propcache-0.5.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1b31822f4474c4036bae62de9402710051d431a606d6a0f907fec79935a071aa", size = 56914, upload-time = "2026-05-08T21:01:48.573Z" },
+    { url = "https://files.pythonhosted.org/packages/79/9f/aba959b435ea18617edd7cf0a7ad0b9c574b8fc7e3d2cd55fb59cb255d33/propcache-0.5.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:13fef48778b5a2a756523fdb781326b028ca75e32858b04f2cdd19f394564917", size = 62567, upload-time = "2026-05-08T21:01:49.903Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/a1/859942de9a791ff42f6141736f5b37749b8f53e65edfa49638c67dd67e6a/propcache-0.5.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8b73ab70f1a3351fbc71f663b3e645af6dd0329100c353081cf69c37433fc6fe", size = 65542, upload-time = "2026-05-08T21:01:51.204Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/61/315bc0fd6c0fc7f80a528b8afd209e5fc4a875ea79571b91b8f50f442907/propcache-0.5.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5538d2c13d93e4698af7e092b57bc7298fd35d1d58e656ae18f23ee0d0378e03", size = 66845, upload-time = "2026-05-08T21:01:52.539Z" },
+    { url = "https://files.pythonhosted.org/packages/47/f7/9f8122e3132e8e354ac41975ef8f1099be7d5a16bc7ae562734e993665c0/propcache-0.5.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:cd645f03898405cabe694fb8bc35241e3a9c332ec85627584fe3de201452b335", size = 63985, upload-time = "2026-05-08T21:01:53.847Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/54/c317819ec157cbf6f35df9df9657a6f82daf34d5faf15948b2f639c2192e/propcache-0.5.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a473b3440261e0c60706e732b2ed2f517857344fc21bf48fdfe211e2d98eb285", size = 63999, upload-time = "2026-05-08T21:01:55.179Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/56/387e3f7dfce0a9233df41fb888aa1c30222cb4bbbf09537c02dd9bd85fe2/propcache-0.5.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7afa37062e6650640e932e4cc9297d81f9f42d9944029cc386b8247dea4da837", size = 62779, upload-time = "2026-05-08T21:01:57.489Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/9c/596784cb5824ed61ee960d3f8655a3f0993e107c6e98ab6c818b7fb92ccb/propcache-0.5.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:8a90efd5777e996e42d568db9ac740b944d691e565cbfd31b2f7832f9184b2b8", size = 59796, upload-time = "2026-05-08T21:01:58.736Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/3d/1a6cfa1726a48542c1e8784a0761421476a5b68e09b7f36bf95eb954aaba/propcache-0.5.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:f19bb891234d72535764d703bfed1153cc34f4214d5bd7150aee1eec9e8f4366", size = 66023, upload-time = "2026-05-08T21:02:00.228Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/0e/05fd6990369477076e4e280bcb970de760fddf0161a46e988bc95f7940ec/propcache-0.5.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:32775082acd2d807ee3db715c7770d38767b817870acfa08c29e057f3c4d5b56", size = 64448, upload-time = "2026-05-08T21:02:01.888Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/86/5f8da315a4309c62c10c0b2516b17492d5d3bbe1bb862b96604db67e2a37/propcache-0.5.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:9282fb1a3bccd038da9f768b927b24a0c753e466c086b7c4f3c6982851eefb2d", size = 67329, upload-time = "2026-05-08T21:02:03.484Z" },
+    { url = "https://files.pythonhosted.org/packages/da/d3/3368efe79ab21f0cdf86ef49895811c9cc933131d4cde1f28a624e22e712/propcache-0.5.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:cc49723e2f60d6b32a0f0b08a3fd6d13203c07f1cd9566cfce0f12a917c967a2", size = 65172, upload-time = "2026-05-08T21:02:04.745Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/07/127e8b0bacfb325396196f9d976a22453049b89b9b2b08477cc3145faa44/propcache-0.5.2-cp314-cp314t-win32.whl", hash = "sha256:2d7aa89ebca5acc98cba9d1472d976e394782f587bad6661003602a619fd1821", size = 43813, upload-time = "2026-05-08T21:02:06.025Z" },
+    { url = "https://files.pythonhosted.org/packages/88/fb/46dad6c0ae49ed230ab1b16c890c2b6314e2403e6c412976f4a72d64a527/propcache-0.5.2-cp314-cp314t-win_amd64.whl", hash = "sha256:d447bb0b3054be5818458fbb171208b1d9ff11eba14e18ca18b90cbb45767370", size = 47764, upload-time = "2026-05-08T21:02:07.353Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/c4/a47d0a63aa309d10d59ede6e9d4cff03a344a79d1f0f4cd0cd74997b53e0/propcache-0.5.2-cp314-cp314t-win_arm64.whl", hash = "sha256:fe67a3d11cd9b4efabfa45c3d00ffba2b26811442a73a581a94b67c2b5faccf6", size = 41140, upload-time = "2026-05-08T21:02:09.065Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/ed/1cdcab6ba3d6ab7feca11fc14f0eeea80755bb53ef4e892079f31b10a25f/propcache-0.5.2-py3-none-any.whl", hash = "sha256:be1ddfcbb376e3de5d2e2db1d58d6d67463e6b4f9f040c000de8e300295465fe", size = 14036, upload-time = "2026-05-08T21:02:10.673Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.13.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/18/a5/b60d21ac674192f8ab0ba4e9fd860690f9b4a6e51ca5df118733b487d8d6/pydantic-2.13.4.tar.gz", hash = "sha256:c40756b57adaa8b1efeeced5c196f3f3b7c435f90e84ea7f443901bec8099ef6", size = 844775, upload-time = "2026-05-06T13:43:05.343Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fd/7b/122376b1fd3c62c1ed9dc80c931ace4844b3c55407b6fb2d199377c9736f/pydantic-2.13.4-py3-none-any.whl", hash = "sha256:45a282cde31d808236fd7ea9d919b128653c8b38b393d1c4ab335c62924d9aba", size = 472262, upload-time = "2026-05-06T13:43:02.641Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.46.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9d/56/921726b776ace8d8f5db44c4ef961006580d91dc52b803c489fafd1aa249/pydantic_core-2.46.4.tar.gz", hash = "sha256:62f875393d7f270851f20523dd2e29f082bcc82292d66db2b64ea71f64b6e1c1", size = 471464, upload-time = "2026-05-06T13:37:06.98Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/08/f1ba952f1c8ae5581c70fa9c6da89f247b83e3dd8c09c035d5d7931fc23d/pydantic_core-2.46.4-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:a396dcc17e5a0b164dbe026896245a4fa9ff402edca1dff0be3d53a517f74de4", size = 2113146, upload-time = "2026-05-06T13:37:36.537Z" },
+    { url = "https://files.pythonhosted.org/packages/56/c6/65f646c7ff09bd257f660434adb45c4dfcbbcebcc030562fecf6f5bf887d/pydantic_core-2.46.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:da4b951fe36dc7c3a1ccb4e3cd1747c3542b8c9ceede8fc86cae054e764485f5", size = 1949769, upload-time = "2026-05-06T13:37:46.365Z" },
+    { url = "https://files.pythonhosted.org/packages/64/ba/bfb1d928fd5b49e1258935ff104ae356e9fd89384a55bf9f847e9193ad40/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bb63e0198ca18aad131c089b9204c23079c3afa95487e561f4c522d519e55aba", size = 1974958, upload-time = "2026-05-06T13:37:28.611Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/74/76223bfb117b64af743c9b6670d1364516f5c0604f96b48f3272f6af6cc6/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f47286a97f0bc9b8859519809077b91b2cefe4ae47fcbf5e466a009c1c5d742b", size = 2042118, upload-time = "2026-05-06T13:36:55.216Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/7b/848732968bc8f48f3187542f08358b9d842db564147b256669426ebb1652/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:905a0ed8ea6f2d61c1738835f99b699348d7857379083e5fc497fa0c967a407c", size = 2222876, upload-time = "2026-05-06T13:38:25.455Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/2f/e90b63ee2e14bd8d3db8f705a6d75d64e6ee1b7c2c8833747ce706e1e0ce/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ea793e075b70290d89d8142074262885d3f7da19634845135751bd6344f73b50", size = 2286703, upload-time = "2026-05-06T13:37:53.304Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/1e/acc4d70f88a0a277e4a1fa77ebb985ceabaf900430f875bf9338e11c9420/pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:395aebd9183f9d112f569aeb5b2214d1a10a33bec8456447f7fbdfa51d38d4cd", size = 2092042, upload-time = "2026-05-06T13:38:46.981Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/da/0a422b57bf8504102bf3c4ccea9c41bab5a5cee6a54650acf8faf67f5a24/pydantic_core-2.46.4-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:b078afbc25f3a1436c7a1d2cd3e322497ee99615ba97c563566fdf46aff1ee01", size = 2117231, upload-time = "2026-05-06T13:39:23.146Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/2a/2ac13c3af305843e23c5078c53d135656b3f05a2fd78cb7bbbb12e97b473/pydantic_core-2.46.4-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f747929cf940cddb5b3668a390056ddd5ba2e5010615ea2dcf4f9c4f3ab8791d", size = 2168388, upload-time = "2026-05-06T13:40:08.06Z" },
+    { url = "https://files.pythonhosted.org/packages/72/04/2beacf7e1607e93eefe4aed1b4709f079b905fb77530179d4f7c71745f22/pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:daa27d92c36f24388fe3ad306b174781c747627f134452e4f128ea00ce1fe8c4", size = 2184769, upload-time = "2026-05-06T13:38:13.901Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/29/d2b9fd9f539133548eaf622c06a4ce176cb46ac59f32d0359c4abc0de047/pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:19e51f073cd3df251856a8a4189fbdf1de4012c3ebacfb1884f94f1eb406079f", size = 2319312, upload-time = "2026-05-06T13:39:08.24Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/af/0f7a5b85fec6075bea96e3ef9187de38fccced0de92c1e7feda8d5cc7bb9/pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:c1747f85cee84c26985853c6f3d9bd3e75da5212912443fa111c113b9c246f39", size = 2361817, upload-time = "2026-05-06T13:38:43.2Z" },
+    { url = "https://files.pythonhosted.org/packages/25/a4/73363fec545fd3ec025490bdda2743c56d0dd5b6266b1a53bbe9e4265375/pydantic_core-2.46.4-cp310-cp310-win32.whl", hash = "sha256:2f84c03c8607173d16b5a854ec68a2f9079ae03237a54fb506d13af47e1d018d", size = 1987085, upload-time = "2026-05-06T13:39:25.497Z" },
+    { url = "https://files.pythonhosted.org/packages/01/aa/62f082da2c91fac1c234bc9ee0066257ce83f0604abd72e4c9d5991f2d84/pydantic_core-2.46.4-cp310-cp310-win_amd64.whl", hash = "sha256:8358a950c8909158e3df31538a7e4edc2d7265a7c54b47f0864d9e5bae9dcebf", size = 2074311, upload-time = "2026-05-06T13:39:59.922Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/fa/6d7708d2cfc1a832acb6aeb0cd16e801902df8a0f583bb3b4b527fde022e/pydantic_core-2.46.4-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:0e96592440881c74a213e5ad528e2b24d3d4f940de2766bed9010ab1d9e51594", size = 2111872, upload-time = "2026-05-06T13:40:27.596Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/6f/aa064a3e74b5745afbdf250594f38e7ead05e2d651bcb35994b9417a0d4d/pydantic_core-2.46.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e0d65b8c354be7fb5f720c3caa8bc940bc2d20ce749c8e06135f07f8ed95dd7c", size = 1948255, upload-time = "2026-05-06T13:39:12.574Z" },
+    { url = "https://files.pythonhosted.org/packages/43/3a/41114a9f7569b84b4d84e7a018c57c56347dac30c0d4a872946ec4e36c46/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7bfb192b3f4b9e8a89b6277b6ce787564f62cfd272055f6e685726b111dc7826", size = 1972827, upload-time = "2026-05-06T13:38:19.841Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/25/1ab42e8048fe551934d9884e8d64daa7e990ad386f310a15981aeb6a5b08/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9037063db01f09b09e237c282b6792bd4da634b5402c4e7f0c61effed7701a04", size = 2041051, upload-time = "2026-05-06T13:38:10.447Z" },
+    { url = "https://files.pythonhosted.org/packages/94/c2/1a934597ddf08da410385b3b7aae91956a5a76c635effef456074fad7e88/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fc010ab034c8c7452522748bf937df58020d256ccae0874463d1f4d01758af8e", size = 2221314, upload-time = "2026-05-06T13:40:13.089Z" },
+    { url = "https://files.pythonhosted.org/packages/02/6d/9e8ad178c9c4df27ad3c8f25d1fe2a7ab0d2ba0559fad4aee5d3d1f16771/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c5dac79fa1614d1e06ca695109c6105923bd9c7d1d6c918d4e637b7e6b32fd3", size = 2285146, upload-time = "2026-05-06T13:38:59.224Z" },
+    { url = "https://files.pythonhosted.org/packages/80/50/540cd3aeefc041beb111125c4bff779831a2111fc6b15a9138cda277d32c/pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f9fa868638bf362d3d138ea55829cefb3d5f4b0d7f142234382a15e2485dbec4", size = 2089685, upload-time = "2026-05-06T13:38:17.762Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/a4/b440ad35f05f6a38f89fa0f149accb3f0e02be94ca5e15f3c449a61b4bc9/pydantic_core-2.46.4-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:17299feefe090f2caa5b8e37222bb5f663e4935a8bfa6931d4102e5df1a9f398", size = 2115420, upload-time = "2026-05-06T13:37:58.195Z" },
+    { url = "https://files.pythonhosted.org/packages/99/61/de4f55db8dfd57bfdfa9a12ec90fe1b57c4f41062f7ca86f08586b3e0ac0/pydantic_core-2.46.4-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4c63ebc82684aa89d9a3bcbd13d515b3be44250dc68dd3bd81526c1cb31286c3", size = 2165122, upload-time = "2026-05-06T13:37:01.167Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/52/7c529d7bdb2d1068bd52f51fe32572c8301f9a4febf1948f10639f1436f5/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:aaa2a54443eff1950ba5ddc6b6ccda0d9c84a364276a62f969bdf2a390650848", size = 2182573, upload-time = "2026-05-06T13:38:45.04Z" },
+    { url = "https://files.pythonhosted.org/packages/37/b3/7c40325848ba78247f2812dcf9c7274e38cd801820ca6dd9fe63bcfb0eb4/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:18e5ceec2ab67e6d5f1a9085e5a24c9c4e2ac4545730bfe668680bca05e555f3", size = 2317139, upload-time = "2026-05-06T13:37:15.539Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/37/f913f81a657c865b75da6c0dbed79876073c2a43b5bd9edbe8da785e4d49/pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:a0f62d0a58f4e7da165457e995725421e0064f2255d8eccebc49f41bbc23b109", size = 2360433, upload-time = "2026-05-06T13:37:30.099Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/67/6acaa1be2567f9256b056d8477158cac7240813956ce86e49deae8e173b4/pydantic_core-2.46.4-cp311-cp311-win32.whl", hash = "sha256:041bde0a48fd37cf71cab1c9d56d3e8625a3793fef1f7dd232b3ff37e978ecda", size = 1985513, upload-time = "2026-05-06T13:38:15.669Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/e6/c505f83dfeda9a2e5c995cfd872949e4d05e12f7feb3dca72f633daefa94/pydantic_core-2.46.4-cp311-cp311-win_amd64.whl", hash = "sha256:6f2eeda33a839975441c86a4119e1383c50b47faf0cbb5176985565c6bb02c33", size = 2071114, upload-time = "2026-05-06T13:40:35.416Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/da/7a263a96d965d9d0df5e8de8a475f33495451117035b09acb110288c381f/pydantic_core-2.46.4-cp311-cp311-win_arm64.whl", hash = "sha256:14f4c5d6db102bd796a627bbb3a17b4cf4574b9ae861d8b7c9a9661c6dd3362d", size = 2044298, upload-time = "2026-05-06T13:38:29.754Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/8c/af022f0af448d7747c5154288d46b5f2bc5f17366eaa0e23e9aa04d59f3b/pydantic_core-2.46.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3245406455a5d98187ec35530fd772b1d799b26667980872c8d4614991e2c4a2", size = 2106158, upload-time = "2026-05-06T13:38:57.215Z" },
+    { url = "https://files.pythonhosted.org/packages/19/95/6195171e385007300f0f5574592e467c568becce2d937a0b6804f218bc49/pydantic_core-2.46.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:962ccbab7b642487b1d8b7df90ef677e03134cf1fd8880bf698649b22a69371f", size = 1951724, upload-time = "2026-05-06T13:37:02.697Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/bc/f47d1ff9cbb1620e1b5b697eef06010035735f07820180e74178226b27b3/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8233f2947cf85404441fd7e0085f53b10c93e0ee78611099b5c7237e36aacbf7", size = 1975742, upload-time = "2026-05-06T13:37:09.448Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/11/9b9a5b0306345664a2da6410877af6e8082481b5884b3ddd78d47c6013ce/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3a233125ac121aa3ffba9a2b59edfc4a985a76092dc8279586ab4b71390875e7", size = 2052418, upload-time = "2026-05-06T13:37:38.234Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/b7/a65fec226f5d78fc39f4a13c4cc0c768c22b113438f60c14adc9d2865038/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5b712b53160b79a5850310b912a5ef8e57e56947c8ad690c227f5c9d7e561712", size = 2232274, upload-time = "2026-05-06T13:38:27.753Z" },
+    { url = "https://files.pythonhosted.org/packages/68/f0/92039db98b907ef49269a8271f67db9cb78ae2fc68062ef7e4e77adb5f61/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9401557acd873c3a7f3eb9383edef8ac4968f9510e340f4808d427e75667e7b4", size = 2309940, upload-time = "2026-05-06T13:38:05.353Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/97/2aab507d3d00ca626e8e57c1eac6a79e4e5fbcc63eb99733ff55d1717f65/pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:926c9541b14b12b1681dca8a0b75feb510b06c6341b70a8e500c2fdcff837cce", size = 2094516, upload-time = "2026-05-06T13:39:10.577Z" },
+    { url = "https://files.pythonhosted.org/packages/22/37/a8aca44d40d737dde2bc05b3c6c07dff0de07ce6f82e9f3167aeaf4d5dea/pydantic_core-2.46.4-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:56cb4851bcaf3d117eddcef4fe66afd750a50274b0da8e22be256d10e5611987", size = 2136854, upload-time = "2026-05-06T13:40:22.59Z" },
+    { url = "https://files.pythonhosted.org/packages/24/99/fcef1b79238c06a8cbec70819ac722ba76e02bc8ada9b0fd66eba40da01b/pydantic_core-2.46.4-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c68fcd102d71ea85c5b2dfac3f4f8476eff42a9e078fd5faefff6d145063536b", size = 2180306, upload-time = "2026-05-06T13:40:10.666Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/6c/fc44000918855b42779d007ae63b0532794739027b2f417321cddbc44f6a/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:b2f69dec1725e79a012d920df1707de5caf7ed5e08f3be4435e25803efc47458", size = 2190044, upload-time = "2026-05-06T13:40:43.231Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/65/d9cadc9f1920d7a127ad2edba16c1db7916e59719285cd6c94600b0080ba/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:8d0820e8192167f80d88d64038e609c31452eeca865b4e1d9950a27a4609b00b", size = 2329133, upload-time = "2026-05-06T13:39:57.365Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/cf/c873d91679f3a30bcf5e7ac280ce5573483e72295307685120d0d5ad3416/pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:fbdb89b3e1c94a30cc5edfce477c6e6a5dc4d8f84665b455c27582f211a1c72c", size = 2374464, upload-time = "2026-05-06T13:38:06.976Z" },
+    { url = "https://files.pythonhosted.org/packages/47/bd/6f2fc8188f31bf10590f1e98e7b306336161fac930a8c514cd7bd828c7dc/pydantic_core-2.46.4-cp312-cp312-win32.whl", hash = "sha256:9aa768456404a8bf48a4406685ac2bec8e72b62c69313734fa3b73cf33b3a894", size = 1974823, upload-time = "2026-05-06T13:40:47.985Z" },
+    { url = "https://files.pythonhosted.org/packages/40/8c/985c1d41ea1107c2534abd9870e4ed5c8e7669b5c308297835c001e7a1c4/pydantic_core-2.46.4-cp312-cp312-win_amd64.whl", hash = "sha256:e9c26f834c65f5752f3f06cb08cb86a913ceb7274d0db6e267808a708b46bc89", size = 2072919, upload-time = "2026-05-06T13:39:21.153Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/ba/f463d006e0c47373ca7ec5e1a261c59dc01ef4d62b2657af925fb0deee3a/pydantic_core-2.46.4-cp312-cp312-win_arm64.whl", hash = "sha256:4fc73cb559bdb54b1134a706a2802a4cddd27a0633f5abb7e53056268751ac6a", size = 2027604, upload-time = "2026-05-06T13:39:03.753Z" },
+    { url = "https://files.pythonhosted.org/packages/51/a2/5d30b469c5267a17b39dec53208222f76a8d351dfac4af661888c5aee77d/pydantic_core-2.46.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:5d5902252db0d3cedf8d4a1bc68f70eeb430f7e4c7104c8c476753519b423008", size = 2106306, upload-time = "2026-05-06T13:37:48.029Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/81/4fa520eaffa8bd7d1525e644cd6d39e7d60b1592bc5b516693c7340b50f1/pydantic_core-2.46.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c94f0688e7b8d0a67abf40e57a7eaaecd17cc9586706a31b76c031f63df052b4", size = 1951906, upload-time = "2026-05-06T13:37:17.012Z" },
+    { url = "https://files.pythonhosted.org/packages/03/d5/fd02da45b659668b05923b17ba3a0100a0a3d5541e3bd8fcc4ecb711309e/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f027324c56cd5406ca49c124b0db10e56c69064fec039acc571c29020cc87c76", size = 1976802, upload-time = "2026-05-06T13:37:35.113Z" },
+    { url = "https://files.pythonhosted.org/packages/21/f2/95727e1368be3d3ed485eaab7adbd7dda408f33f7a36e8b48e0144002b91/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e739fee756ba1010f8bcccb534252e85a35fe45ae92c295a06059ce58b74ccd3", size = 2052446, upload-time = "2026-05-06T13:37:12.313Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/86/5d99feea3f77c7234b8718075b23db11532773c1a0dbd9b9490215dc2eeb/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9d56801be94b86a9da183e5f3766e6310752b99ff647e38b09a9500d88e46e76", size = 2232757, upload-time = "2026-05-06T13:39:01.149Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/3a/508ac615935ef7588cf6d9e9b91309fdc2da751af865e02a9098de88258c/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2412e734dcb48da14d4e4006b82b46b74f2518b8a26ee7e58c6844a6cd6d03c4", size = 2309275, upload-time = "2026-05-06T13:37:41.406Z" },
+    { url = "https://files.pythonhosted.org/packages/07/f8/41db9de19d7987d6b04715a02b3b40aea467000275d9d758ffaa31af7d50/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9551187363ffc0de2a00b2e47c25aeaeb1020b69b668762966df15fc5659dd5a", size = 2094467, upload-time = "2026-05-06T13:39:18.847Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/e2/f35033184cb11d0052daf4416e8e10a502ea2ac006fc4f459aee872727d1/pydantic_core-2.46.4-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:0186750b482eefa11d7f435892b09c5c606193ef3375bcf94aa00ae6bfb66262", size = 2134417, upload-time = "2026-05-06T13:40:17.944Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/7b/6ceeb1cc90e193862f444ebe373d8fdf613f0a82572dde03fb10734c6c71/pydantic_core-2.46.4-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5855698a4856556d86e8e6cd8434bc3ac0314ee8e12089ae0e143f64c6256e4e", size = 2179782, upload-time = "2026-05-06T13:40:32.618Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f2/c8d7773ede6af08036423a00ae0ceffce266c3c52a096c435d68c896083f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:cbaf13819775b7f769bf4a1f066cb6df7a28d4480081a589828ef190226881cd", size = 2188782, upload-time = "2026-05-06T13:36:51.018Z" },
+    { url = "https://files.pythonhosted.org/packages/59/31/0c864784e31f09f05cdd87606f08923b9c9e7f6e51dd27f20f62f975ce9f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:633147d34cf4550417f12e2b1a0383973bdf5cdfde212cb09e9a581cf10820be", size = 2328334, upload-time = "2026-05-06T13:40:37.764Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/eb/4f6c8a41efa30baa755590f4141abf3a8c370fab610915733e74134a7270/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:82cf5301172168103724d49a1444d3378cb20cdee30b116a1bd6031236298a5d", size = 2372986, upload-time = "2026-05-06T13:39:34.152Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/24/b375a480d53113860c299764bfe9f349a3dc9108b3adc0d7f0d786492ebf/pydantic_core-2.46.4-cp313-cp313-win32.whl", hash = "sha256:9fa8ae11da9e2b3126c6426f147e0fba88d96d65921799bb30c6abd1cb2c97fb", size = 1973693, upload-time = "2026-05-06T13:37:55.072Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/e8/cff247591966f2d22ec8c003cd7587e27b7ba7b81ab2fb888e3ab75dc285/pydantic_core-2.46.4-cp313-cp313-win_amd64.whl", hash = "sha256:6b3ace8194b0e5204818c92802dcdca7fc6d88aabbb799d7c795540d9cd6d292", size = 2071819, upload-time = "2026-05-06T13:38:49.139Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/1a/f4aee670d5670e9e148e0c82c7db98d780be566c6e6a97ee8035528ca0b3/pydantic_core-2.46.4-cp313-cp313-win_arm64.whl", hash = "sha256:184c081504d17f1c1066e430e117142b2c77d9448a97f7b65c6ac9fd9aee238d", size = 2027411, upload-time = "2026-05-06T13:40:45.796Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/74/228a26ddad29c6672b805d9fd78e8d251cd04004fa7eed0e622096cd0250/pydantic_core-2.46.4-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:428e04521a40150c85216fc8b85e8d39fece235a9cf5e383761238c7fa9b96fb", size = 2102079, upload-time = "2026-05-06T13:38:41.019Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/1f/8970b150a4b4365623ae00fc88603491f763c627311ae8031e3111356d6e/pydantic_core-2.46.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:23ace664830ee0bfe014a0c7bc248b1f7f25ed7ad103852c317624a1083af462", size = 1952179, upload-time = "2026-05-06T13:36:59.812Z" },
+    { url = "https://files.pythonhosted.org/packages/95/30/5211a831ae054928054b2f79731661087a2bc5c01e825c672b3a4a8f1b3e/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce5c1d2a8b27468f433ca974829c44060b8097eedc39933e3c206a90ee49c4a9", size = 1978926, upload-time = "2026-05-06T13:37:39.933Z" },
+    { url = "https://files.pythonhosted.org/packages/57/e9/689668733b1eb67adeef047db3c2e8788fcf65a7fd9c9e2b46b7744fe245/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7283d57845ecf5a163403eb0702dfc220cc4fbdd18919cb5ccea4f95ee1cdab4", size = 2046785, upload-time = "2026-05-06T13:38:01.995Z" },
+    { url = "https://files.pythonhosted.org/packages/60/d9/6715260422ff50a2109878fd24d948a6c3446bb2664f34ee78cd972b3acd/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8daafc69c93ee8a0204506a3b6b30f586ef54028f52aeeeb5c4cfc5184fd5914", size = 2228733, upload-time = "2026-05-06T13:40:50.371Z" },
+    { url = "https://files.pythonhosted.org/packages/18/ae/fdb2f64316afca925640f8e70bb1a564b0ec2721c1389e25b8eb4bf9a299/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd2213145bcc2ba85884d0ac63d222fece9209678f77b9b4d76f054c561adb28", size = 2307534, upload-time = "2026-05-06T13:37:21.531Z" },
+    { url = "https://files.pythonhosted.org/packages/89/1d/8eff589b45bb8190a9d12c49cfad0f176a5cbd1534908a6b5125e2886239/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7a5f930472650a82629163023e630d160863fce524c616f4e5186e5de9d9a49b", size = 2099732, upload-time = "2026-05-06T13:39:31.942Z" },
+    { url = "https://files.pythonhosted.org/packages/06/d5/ee5a3366637fee41dee51a1fc91562dcf12ddbc68fda34e6b253da2324bb/pydantic_core-2.46.4-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:c1b3f518abeca3aa13c712fd202306e145abf59a18b094a6bafb2d2bbf59192c", size = 2129627, upload-time = "2026-05-06T13:37:25.033Z" },
+    { url = "https://files.pythonhosted.org/packages/94/33/2414be571d2c6a6c4d08be21f9292b6d3fdb08949a97b6dfe985017821db/pydantic_core-2.46.4-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1a7dd0b3ee80d90150e3495a3a13ac34dbcbfd4f012996a6a1d8900e91b5c0fb", size = 2179141, upload-time = "2026-05-06T13:37:14.046Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/79/7daa95be995be0eecc4cf75064cb33f9bbbfe3fe0158caf2f0d4a996a5c7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:3fb702cd90b0446a3a1c5e470bfa0dd23c0233b676a9099ddcc964fa6ca13898", size = 2184325, upload-time = "2026-05-06T13:36:53.615Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/cb/d0a382f5c0de8a222dc61c65348e0ce831b1f68e0a018450d31c2cace3a5/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:b8458003118a712e66286df6a707db01c52c0f52f7db8e4a38f0da1d3b94fc4e", size = 2323990, upload-time = "2026-05-06T13:40:29.971Z" },
+    { url = "https://files.pythonhosted.org/packages/05/db/d9ba624cc4a5aced1598e88c04fdbd8310c8a69b9d38b9a3d39ce3a61ed7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:372429a130e469c9cd698925ce5fc50940b7a1336b0d82038e63d5bbc4edc519", size = 2369978, upload-time = "2026-05-06T13:37:23.027Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/20/d15df15ba918c423461905802bfd2981c3af0bfa0e40d05e13edbfa48bc3/pydantic_core-2.46.4-cp314-cp314-win32.whl", hash = "sha256:85bb3611ff1802f3ee7fdd7dbff26b56f343fb432d57a4728fdd49b6ef35e2f4", size = 1966354, upload-time = "2026-05-06T13:38:03.499Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/b6/6b8de4c0a7d7ab3004c439c80c5c1e0a3e8d78bbae19379b01960383d9e5/pydantic_core-2.46.4-cp314-cp314-win_amd64.whl", hash = "sha256:811ff8e9c313ab425368bcbb36e5c4ebd7108c2bbf4e4089cfbb0b01eff63fac", size = 2072238, upload-time = "2026-05-06T13:39:40.807Z" },
+    { url = "https://files.pythonhosted.org/packages/32/36/51eb763beec1f4cf59b1db243a7dcc39cbb41230f050a09b9d69faaf0a48/pydantic_core-2.46.4-cp314-cp314-win_arm64.whl", hash = "sha256:bfec22eab3c8cc2ceec0248aec886624116dc079afa027ecc8ad4a7e62010f8a", size = 2018251, upload-time = "2026-05-06T13:37:26.72Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/91/855af51d625b23aa987116a19e231d2aaef9c4a415273ddc189b79a45fee/pydantic_core-2.46.4-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:af8244b2bef6aaad6d92cda81372de7f8c8d36c9f0c3ea36e827c60e7d9467a0", size = 2099593, upload-time = "2026-05-06T13:39:47.682Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/1b/8784a54c65edb5f49f0a14d6977cf1b209bba85a4c77445b255c2de58ab3/pydantic_core-2.46.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5a4330cdbc57162e4b3aa303f588ba752257694c9c9be3e7ebb11b4aca659b5d", size = 1935226, upload-time = "2026-05-06T13:40:40.428Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/e7/1955d28d1afc56dd4b3ad7cc0cf39df1b9852964cf16e5d13912756d6d6b/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29c61fc04a3d840155ff08e475a04809278972fe6aef51e2720554e96367e34b", size = 1974605, upload-time = "2026-05-06T13:37:32.029Z" },
+    { url = "https://files.pythonhosted.org/packages/93/e2/3fedbf0ba7a22850e6e9fd78117f1c0f10f950182344d8a6c535d468fdd8/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c50f2528cf200c5eed56faf3f4e22fcd5f38c157a8b78576e6ba3168ec35f000", size = 2030777, upload-time = "2026-05-06T13:38:55.239Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/61/46be275fcaaba0b4f5b9669dd852267ce1ff616592dccf7a7845588df091/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0cbe8b01f948de4286c74cdd6c667aceb38f5c1e26f0693b3983d9d74887c65e", size = 2236641, upload-time = "2026-05-06T13:37:08.096Z" },
+    { url = "https://files.pythonhosted.org/packages/60/db/12e93e46a8bac9988be3c016860f83293daea8c716c029c9ace279036f2f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:617d7e2ca7dcb8c5cf6bcb8c59b8832c94b36196bbf1cbd1bfb56ed341905edd", size = 2286404, upload-time = "2026-05-06T13:40:20.221Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/4a/4d8b19008f38d31c53b8219cfedc2e3d5de5fe99d90076b7e767de29274f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7027560ee92211647d0d34e3f7cd6f50da56399d26a9c8ad0da286d3869a53f3", size = 2109219, upload-time = "2026-05-06T13:38:12.153Z" },
+    { url = "https://files.pythonhosted.org/packages/88/70/3cbc40978fefb7bb09c6708d40d4ad1a5d70fd7213c3d17f971de868ec1f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:f99626688942fb746e545232e7726926f3be91b5975f8b55327665fafda991c7", size = 2110594, upload-time = "2026-05-06T13:40:02.971Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/20/b8d36736216e29491125531685b2f9e61aa5b4b2599893f8268551da3338/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fc3e9034a63de20e15e8ade85358bc6efc614008cab72898b4b4952bea0509ff", size = 2159542, upload-time = "2026-05-06T13:39:27.506Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/a2/367df868eb584dacf6bf82a389272406d7178e301c4ac82545ab98bc2dd9/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:97e7cf2be5c77b7d1a9713a05605d49460d02c6078d38d8bef3cbe323c548424", size = 2168146, upload-time = "2026-05-06T13:38:31.93Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/b8/4460f77f7e201893f649a29ab355dddd3beee8a97bcb1a320db414f9a06e/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:3bf92c5d0e00fefaab325a4d27828fe6b6e2a21848686b5b60d2d9eeb09d76c6", size = 2306309, upload-time = "2026-05-06T13:37:44.717Z" },
+    { url = "https://files.pythonhosted.org/packages/64/c4/be2639293acd87dc8ddbcec41a73cee9b2ebf996fe6d892a1a74e88ad3f7/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:3ecbc122d18468d06ca279dc26a8c2e2d5acb10943bb35e36ae92096dc3b5565", size = 2369736, upload-time = "2026-05-06T13:37:05.645Z" },
+    { url = "https://files.pythonhosted.org/packages/30/a6/9f9f380dbb301f67023bf8f707aaa75daadf84f7152d95c410fd7e81d994/pydantic_core-2.46.4-cp314-cp314t-win32.whl", hash = "sha256:e846ae7835bf0703ae43f534ab79a867146dadd59dc9ca5c8b53d5c8f7c9ef02", size = 1955575, upload-time = "2026-05-06T13:38:51.116Z" },
+    { url = "https://files.pythonhosted.org/packages/40/1f/f1eb9eb350e795d1af8586289746f5c5677d16043040d63710e22abc43c9/pydantic_core-2.46.4-cp314-cp314t-win_amd64.whl", hash = "sha256:2108ba5c1c1eca18030634489dc544844144ee36357f2f9f780b93e7ddbb44b5", size = 2051624, upload-time = "2026-05-06T13:38:21.672Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/d2/42dd53d0a85c27606f316d3aa5d2869c4e8470a5ed6dec30e4a1abe19192/pydantic_core-2.46.4-cp314-cp314t-win_arm64.whl", hash = "sha256:4fcbe087dbc2068af7eda3aa87634eba216dbda64d1ae73c8684b621d33f6596", size = 2017325, upload-time = "2026-05-06T13:40:52.723Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/a4/73995fd4ebbb46ba0ee51e6fa049b8f02c40daebb762208feda8a6b7894d/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:14d4edf427bdcf950a8a02d7cb44a08614388dd6e1bdcbf4f67504fa7887da9c", size = 2111589, upload-time = "2026-05-06T13:37:10.817Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/7f/f37d3a5e8bfcc2e403f5c57a730f2d815693fb42119e8ea48b3789335af1/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:0ce40cd7b21210e99342afafbd4d0f76d784eb5b1d60f3bdc566be4983c6c73b", size = 1944552, upload-time = "2026-05-06T13:36:56.717Z" },
+    { url = "https://files.pythonhosted.org/packages/15/3c/d7eb777b3ff43e8433a4efb39a17aa8fd98a4ee8561a24a67ef5db07b2d6/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:90884113d8b48f760e9587002789ddd741e76ab9f89518cd1e43b1f1a52ec44b", size = 1982984, upload-time = "2026-05-06T13:39:06.207Z" },
+    { url = "https://files.pythonhosted.org/packages/63/87/70b9f40170a81afd55ca26c9b2acb25c20d64bcfbf888fafecb3ba077d4c/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66ce7632c22d837c95301830e111ad0128a32b8207533b60896a96c4915192ea", size = 2138417, upload-time = "2026-05-06T13:39:45.476Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/1d/8987ad40f65ae1432753072f214fb5c74fe47ffbd0698bb9cbbb585664f8/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:1d8ba486450b14f3b1d63bc521d410ec7565e52f887b9fb671791886436a42f7", size = 2095527, upload-time = "2026-05-06T13:39:52.283Z" },
+    { url = "https://files.pythonhosted.org/packages/64/d3/84c282a7eee1d3ac4c0377546ef5a1ea436ce26840d9ac3b7ed54a377507/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:3009f12e4e90b7f88b4f9adb1b0c4a3d58fe7820f3238c190047209d148026df", size = 1936024, upload-time = "2026-05-06T13:40:15.671Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/ca/eac61596cdeb4d7e174d3dc0bd8a6238f14f75f97a24e7b7db4c7e7340a0/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ad785e92e6dc634c21555edc8bd6b64957ab844541bcb96a1366c202951ae526", size = 1990696, upload-time = "2026-05-06T13:38:34.717Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/c3/7c8b240552251faf6b3a957db200fcfbbcec36763c050428b601e0c9b83b/pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00c603d540afdd6b80eb39f078f33ebd46211f02f33e34a32d9f053bba711de0", size = 2147590, upload-time = "2026-05-06T13:39:29.883Z" },
+    { url = "https://files.pythonhosted.org/packages/11/cb/428de0385b6c8d44b716feba566abfacfbd23ee3c4439faa789a1456242f/pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:0c563b08bca408dc7f65f700633d8442fffb2421fc47b8101377e9fd65051ff0", size = 2112782, upload-time = "2026-05-06T13:37:04.016Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/b5/6a17bdadd0fc1f170adfd05a20d37c832f52b117b4d9131da1f41bb097ce/pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:db06ffe51636ffe9ca531fe9023dd64bdd794be8754cb5df57c5498ae5b518a7", size = 1952146, upload-time = "2026-05-06T13:39:43.092Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/dc/03734d80e362cd43ef65428e9de77c730ce7f2f11c60d2b1e1b39f0fbf99/pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:133878133d271ade3d41d1bfb2a45ec38dbdbda40bc065921c6b04e4630127e2", size = 2134492, upload-time = "2026-05-06T13:36:58.124Z" },
+    { url = "https://files.pythonhosted.org/packages/de/df/5e5ffc085ed07cc22d298134d3d911c63e91f6a0eb91fe646750a3209910/pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:9bc519fbf2b7578398853d815009ae5e4d4603d12f4e3f91da8c06852d3da3e9", size = 2156604, upload-time = "2026-05-06T13:37:49.88Z" },
+    { url = "https://files.pythonhosted.org/packages/81/44/6e112a4253e56f5705467cbab7ab5e91ee7398ba3d56d358635958893d3e/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:c7a7bd4e39e8e4c12c39cd480356842b6a8a06e41b23a55a5e3e191718838ddf", size = 2183828, upload-time = "2026-05-06T13:37:43.053Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/ad/5565071e937d8e752842ac241463944c9eb14c87e2d269f2658a5bd05e98/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:d396ec2b979760aaf3218e76c24e65bd0aca24983298653b3a9d7a45f9e47b30", size = 2310000, upload-time = "2026-05-06T13:37:56.694Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/c3/66883a5cec183e7fba4d024b4cbbe61851a63750ef606b0afecc46d1f2bf/pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:86e1a4418c6cd97d60c95c71164158eaf7324fae7b0923264016baa993eba6fc", size = 2361286, upload-time = "2026-05-06T13:40:05.667Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/2d/69abac8f838090bbecd5df894befb2c2619e7996a98ddb949db9f3b93225/pydantic_core-2.46.4-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:d51026d73fcfd93610abc7b27789c26b313920fcfb20e27462d74a7f8b06e983", size = 2193071, upload-time = "2026-05-06T13:38:08.682Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "pymmcore"
+version = "12.5.0.75.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f5/51/e75186deeff67e4ba5b6c340343d7efc2d6819a2607e1927547754ea6183/pymmcore-12.5.0.75.0.tar.gz", hash = "sha256:c78670ff99ea2a4424d41eea7f0f0b6059053689af7700a5b19815fa8dde8390", size = 1418871, upload-time = "2026-05-06T08:34:20.948Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d7/a4/1e67b6069406ea01b68e7dc2dcfd2e1c5f186005ea546809a265ea85bc8c/pymmcore-12.5.0.75.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:af494ad1729f0657c1bba4975c691892012c562c4ac661d5048f6ff23ed92f00", size = 952692, upload-time = "2026-05-06T08:33:48.171Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/82/473e57e60674565b6dc4d2bbf6a8d4f6376d638cf3b14efc186944c6e112/pymmcore-12.5.0.75.0-cp310-cp310-macosx_11_0_x86_64.whl", hash = "sha256:4b0207c75c556edab0fae5c45b6815ec432259730919543d9918fc3219cf94f4", size = 1002870, upload-time = "2026-05-06T08:33:49.806Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/e6/bdb7db16313d4b2eb54cf42562297cc06ae84e325cb06e5ee0d671c47122/pymmcore-12.5.0.75.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:aa0379fbaf91e82e8c801d270fb242e183cd91ed05bc8e7f7eea487d7a6bd932", size = 1249369, upload-time = "2026-05-06T08:33:52.063Z" },
+    { url = "https://files.pythonhosted.org/packages/74/20/b5d7dec09d1bca8d6474d0671bbbdb478a548a4a373ef43cec4caa9ced43/pymmcore-12.5.0.75.0-cp310-cp310-win_amd64.whl", hash = "sha256:03791c8cd38b3abfd55106a1aa4eb2defb0f91a1db8154bc6fbd1a4e4fa20c4a", size = 777813, upload-time = "2026-05-06T08:33:53.737Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/05/3e116795c4475fbacfff2814d1c582867ce25e9706619cae2a530398ea0a/pymmcore-12.5.0.75.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ed0baa677cd95194cccd19c7c7f937cdac9815e6334393573f11d8d5927dfae9", size = 952692, upload-time = "2026-05-06T08:33:55.373Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/28/90ed415b117bbfd94b5b76772631edbe828743c507898390541393e4c82a/pymmcore-12.5.0.75.0-cp311-cp311-macosx_11_0_x86_64.whl", hash = "sha256:9e566ea4f638d0dce84e783ff7c02ff9abbbe7b3ce60fefa9dc8b69f7f7cd82a", size = 1002871, upload-time = "2026-05-06T08:33:56.71Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/a0/11b38ee2d97fcef695dcb0e7a1d500259569ee207dd61d53ebcc20d9af92/pymmcore-12.5.0.75.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6ec52998258906cfab5ec5d80cd42968d8d6277430bad49099d10f4c349ee636", size = 1249367, upload-time = "2026-05-06T08:33:58.256Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/7b/beea18cbdd04456635b3217bc40a5c315a48b0eedb692fda10b741a91fc1/pymmcore-12.5.0.75.0-cp311-cp311-win_amd64.whl", hash = "sha256:6f5dbc8f71085df8ac02216a6369da7a3c4afddb27a69f1f2490575b97634e46", size = 777921, upload-time = "2026-05-06T08:33:59.707Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/0d/03271a7952cbebeb8d773e4827415ed653179a7d6bb881a04db8e8c30613/pymmcore-12.5.0.75.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6cce904e951c868895809ca423b4b1935542928bec90f6c12f2ae2a91f725db3", size = 953414, upload-time = "2026-05-06T08:34:01.254Z" },
+    { url = "https://files.pythonhosted.org/packages/63/0c/e1456b1c1aa5cbaa9f6728a3f30cdcf30f8187b577a8ad062d345be9c750/pymmcore-12.5.0.75.0-cp312-cp312-macosx_11_0_x86_64.whl", hash = "sha256:b87f2a2c08dab610905575953e8dcc3f0cec999571c07f618c68ab2bbee201b4", size = 1006454, upload-time = "2026-05-06T08:34:02.966Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/b6/eaebb16c8aba2dd4657acb7116f1714bfdafffbdb2e9dcb79eaf506ee373/pymmcore-12.5.0.75.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1e64c3688a25d1a964b2e1ec732cacb83c01258a3e0f9e306b4bd9ebb4f4a4c2", size = 1250052, upload-time = "2026-05-06T08:34:04.57Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/76/a0059dee9fbca8d9b4214534af11e8c9ecc7a2520e6fe7eae09114ec2470/pymmcore-12.5.0.75.0-cp312-cp312-win_amd64.whl", hash = "sha256:6a8b0e7a0bac2af5496fefa6b6291f76a8640a75cb75adfaf28b1288e91340a5", size = 777918, upload-time = "2026-05-06T08:34:06.189Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/9b/1f23574154d25c08a7364615e2403e0c339c449fca37ebf16a1aa77b8cd5/pymmcore-12.5.0.75.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:0a559ac0e9e3918b19fc18d0cac733f12b328201f10c917d50b37f031935531b", size = 972415, upload-time = "2026-05-06T08:34:07.681Z" },
+    { url = "https://files.pythonhosted.org/packages/17/06/e03d10ef62060a31c67ae76bbf4a91afc021d01af4ed7e74b1252f6cd575/pymmcore-12.5.0.75.0-cp313-cp313-macosx_11_0_x86_64.whl", hash = "sha256:b427d9aadbf4c731b19d479b396ade5a872d16653d15030ce5467e8d820c57c9", size = 1020680, upload-time = "2026-05-06T08:34:09.06Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/d6/1ae1574b96b674f33a863f1656f0bdc4f95f28771b3c9144f4b1ec0d5fe9/pymmcore-12.5.0.75.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a07b4203822b65288946c1fbffd8bd3c413e23a1b0086ba8273ca98c7c721183", size = 1250853, upload-time = "2026-05-06T08:34:10.385Z" },
+    { url = "https://files.pythonhosted.org/packages/af/7a/9f8556ff3dc37ee67edf54543327864567abcb4941d0b3ff882adc0d9fa3/pymmcore-12.5.0.75.0-cp313-cp313-win_amd64.whl", hash = "sha256:e871d73da442a6d17ac7e39c239ddc61178cfc53a2e6386e4d4496d46a89926a", size = 777956, upload-time = "2026-05-06T08:34:13.006Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/5b/d2413012632b8e674bb55867e4354596fe5619af7e3cc91908925fce4725/pymmcore-12.5.0.75.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1f11aab098f0e36b9db7d4e73b82a217857bce065f42f36e154b71c9bfe3a918", size = 973291, upload-time = "2026-05-06T08:34:14.505Z" },
+    { url = "https://files.pythonhosted.org/packages/45/ff/c39e52d38c4f0d57c7f05d67387d07c1c49680a8ff17e59571480ca68d80/pymmcore-12.5.0.75.0-cp314-cp314-macosx_11_0_x86_64.whl", hash = "sha256:226164a2d424dc017e9cf9f675e732599fc8242d97a822f3141225adb075cf8b", size = 1023703, upload-time = "2026-05-06T08:34:16.318Z" },
+    { url = "https://files.pythonhosted.org/packages/65/e3/0ab664adde1eb500b54ce592dd361b2aa94d8159bc43bb835dd272686f34/pymmcore-12.5.0.75.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1bc6fb9aae9941337935b1ddf77c08d82c0dc1158e01d23cacc0048427329cb5", size = 1250626, upload-time = "2026-05-06T08:34:18.116Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/49/f5bb70814568022bdd1aa26f31321397e44d2e9c812d4b0bf322b01ddba6/pymmcore-12.5.0.75.0-cp314-cp314-win_amd64.whl", hash = "sha256:5dff6e13926d473e123a6e01732f99313442307157cbe65cecd94815527d4ea7", size = 792936, upload-time = "2026-05-06T08:34:19.568Z" },
+]
+
+[[package]]
+name = "pyobjc-core"
+version = "12.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2a/e8/a6cc12669211e7c9b29e8f26bf2159e67c7a73555dc229018abf46d8167a/pyobjc_core-12.2.tar.gz", hash = "sha256:51d7de4cfa32f508c6a7aac31f131b12d5e196a8dcf588e6e8d7e6337224f66d", size = 1062064, upload-time = "2026-05-30T12:29:55.417Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a9/cd/2e8cc2d648648186aab7e3eea76d89ad02f10eb752f3846c1aaba2c93e22/pyobjc_core-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:45fffb2b8dc0ae4480386429bd1e7fa8aabeb2eec81816d6971b33936dfcfff8", size = 6478736, upload-time = "2026-05-30T09:47:42.912Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/dc/b68d8bd769865d509fbcab81f5fae6497bd4e33409a44925e5d5e7c68d72/pyobjc_core-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:17b4e003af384d3086c2f39989a0b282c5755dd1066f331cf7c9fa65febe22ce", size = 6475918, upload-time = "2026-05-30T10:00:44.669Z" },
+    { url = "https://files.pythonhosted.org/packages/24/be/4771f4fd786f0e1a2bd6d8931a72a5f3929b7bb1b28a1fe6ca8a08371c55/pyobjc_core-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:7677ed758a367bbbb5589d6f5276fb360a45c89168276c26162f61840b0fa03d", size = 6421145, upload-time = "2026-05-30T10:17:41.992Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/ed/6e62d038992bc7ef9091d95ec97c3c221686fe52a993a6501e961c757613/pyobjc_core-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:9287c7c46d6ae8676b4c6c0389a8f4b5381f42ae53a47151900c08b157e5a992", size = 6428611, upload-time = "2026-05-30T10:21:33.83Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/0b/d492110202f4d1050a5e590620ebd1e730cf89f9880a26cf18205e0f5800/pyobjc_core-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:515ecf2afe168301feb66a7230d700584ce2e4b8a0ac178e19450b8898384139", size = 6677992, upload-time = "2026-05-30T10:44:13.039Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/b2/ecfbd0c80e7688ed6f3db23414758443c69c3a9d318f2036e26530ede955/pyobjc_core-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:a51352e478785cd7fce1604b9902125a286139caea0759cb340e59d75b594992", size = 6421372, upload-time = "2026-05-30T10:47:27.907Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/89/ecd5cb62573fba9a95f8bdb838a9860a360907104a0724af6611d3b20512/pyobjc_core-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:3137b2d14f9f2154fb5b1c092c38d15e164f68ab190c18335d76e4e7e1583f79", size = 6676789, upload-time = "2026-05-30T10:59:33.811Z" },
+    { url = "https://files.pythonhosted.org/packages/74/24/5091d156b19df0f657127f42b08eada11c9b9cc5df49fedb91bb354d9821/pyobjc_core-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:1e4216f2ec962dc13cf7f31b9bc3a7190337a0f401e7dc9de6b2d8c08b9dbb7a", size = 6476112, upload-time = "2026-05-30T11:21:46.914Z" },
+    { url = "https://files.pythonhosted.org/packages/77/e2/ee91ea8a0ad28e759f351ed8654027c34fc62ad5e207672522025a6a3fc2/pyobjc_core-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:ac952bac8057dd0b97ee7b311c39f97cad7430b7cfbd67ca0a30135a7d17d2ab", size = 6718365, upload-time = "2026-05-30T11:51:47.35Z" },
+]
+
+[[package]]
+name = "pyobjc-framework-cocoa"
+version = "12.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyobjc-core" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/6d/cc/927169225e72bab9c9b44285656768fb75052a0bc85fdbca62740e1ca43c/pyobjc_framework_cocoa-12.2.tar.gz", hash = "sha256:20b392e2b7241caad0538dfde12143343e5dfe48f72e7df660a7548e635903dc", size = 3125555, upload-time = "2026-05-30T12:35:09.273Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/36/db/e86555b282c38bb0aadb63bf961c17e3ca70252774a677945f6bc4ee19c0/pyobjc_framework_cocoa-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:a2efad455ded551d1a033fd22245d57b71b6c065e8b52158dceed1611b5ae033", size = 387272, upload-time = "2026-05-30T11:57:27.512Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/10/95edbdee61731dc0e18633071fe56a4220879a92e9ba77c330a34add4b28/pyobjc_framework_cocoa-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:0bb7cd468ca89bbc2d1d8acb930b4f4fdce8826de30a66608fc28f8880c1f6a6", size = 387272, upload-time = "2026-05-30T11:57:51.391Z" },
+    { url = "https://files.pythonhosted.org/packages/30/66/5a91f2eddfced4f26bc2df2bcebb7f5f10c5bf5666aff6fa00ded845af07/pyobjc_framework_cocoa-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:06cb92d97d1af9d1f459ae6cf1d1a7b824c12d3aff1b709885966acd6b7208c2", size = 388093, upload-time = "2026-05-30T11:58:14.921Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/3b/1af2be2bf5204bbcfc94de215d5f87d35348c9982d9b05f54ceefbc53b8f/pyobjc_framework_cocoa-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:f0bbe0abedfb24b11ff6c71e26cdefb0df001c6482f95591fad40c2688c16498", size = 388154, upload-time = "2026-05-30T11:58:38.547Z" },
+    { url = "https://files.pythonhosted.org/packages/41/cb/c0435d64f1199210af36141b90aea2ae3344719f7313d4160b8b0dd527db/pyobjc_framework_cocoa-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:46b6681e2b21b099ed095339c140f2c8137d6ac5658653166ee90722f9e3c621", size = 392245, upload-time = "2026-05-30T11:59:02.436Z" },
+    { url = "https://files.pythonhosted.org/packages/56/4b/df8e359e5e422e8f1430bde038aa64364e8c1d4542d7f6fcc4f8a97ec0b7/pyobjc_framework_cocoa-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:aecfd44908fa12a9291fb6ca2458ebbc611102de6784f2202a35fd5ed9f56c60", size = 388334, upload-time = "2026-05-30T11:59:25.861Z" },
+    { url = "https://files.pythonhosted.org/packages/43/a2/68c0702cc9d6dbc7077edbd13ccc9aa30ac589d514f51ad6f5c3840e3bf1/pyobjc_framework_cocoa-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ef679740f541c52118149b558b757d1f11d9dcf30c2a23344b13a6af6a99a1ab", size = 392376, upload-time = "2026-05-30T11:59:50.031Z" },
+    { url = "https://files.pythonhosted.org/packages/83/c3/e170672302e75cc1aa833546fb0d5a3bd4a126ede4124566d5a2e4a50cd6/pyobjc_framework_cocoa-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:290e544a8c2d0786a34a359d825eaad44ebaaa3b30cdd765b2755422ca39a0d2", size = 388566, upload-time = "2026-05-30T12:00:13.606Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/6b/78e98e4de11646e56cf98066f9f84b43c86adc8b273a660d85a6ceba7a31/pyobjc_framework_cocoa-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:5a0bed77b0b56074cc2b4564aae3e6e9d5da5fdf93252f50b6dbced0f7fece3a", size = 392674, upload-time = "2026-05-30T12:00:37.572Z" },
+]
+
+[[package]]
+name = "pyobjc-framework-corebluetooth"
+version = "12.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyobjc-core" },
+    { name = "pyobjc-framework-cocoa" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/52/df/bee7ba216f9fb513710aac1701b78c97b087b37fca8ec1806f8572e0bbb3/pyobjc_framework_corebluetooth-12.2.tar.gz", hash = "sha256:8b4e5ca99953c360c391a695b0782a5328fcecafd56fdf790ad709e932feb306", size = 37552, upload-time = "2026-05-30T12:35:33.863Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0a/2e/03974693bf040ff819f3141f4ee88bfd190407370e83fcab70472698eb8f/pyobjc_framework_corebluetooth-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:c2732cd05d26ac1541ce41cc6ece4d94108601ed503ddfe6dc6afd36a834cd65", size = 13164, upload-time = "2026-05-30T12:01:57.971Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/2d/ee819fde6d48f2d43733ae40097f4872e1129fbca40847d434939cefa552/pyobjc_framework_corebluetooth-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:b03beace02ca1963697f35faf4d3d0263f707e0182f67950212c890dd9d19e6f", size = 13169, upload-time = "2026-05-30T12:02:00.003Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9a/99e61547e61b0e38cb13c67931f9ca9bbd1dc72c1ff78322c7c3af805e8b/pyobjc_framework_corebluetooth-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:31da3686ea55e9f7f8fc321fe2fcdf23827acd24c91ae1798e47e1f3a8355ab7", size = 13191, upload-time = "2026-05-30T12:02:01.811Z" },
+    { url = "https://files.pythonhosted.org/packages/25/eb/04f0ea541e6df3b7a328fe63ed1f508898d84910be66ae0f4d08103ad5a1/pyobjc_framework_corebluetooth-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:b43a21eb9388453c867ce82bf5d475cfce4fe2ceaea974474071f1cfd178f40f", size = 13205, upload-time = "2026-05-30T12:02:03.831Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/b7/502b1e5ff1feede7fbed1f28e1fd14604cf564e4a4f5d4f33c93a4706739/pyobjc_framework_corebluetooth-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:162623f74c85041bb8a2c9a8862cee6674531d603ad7a8d65a3efc81619f84c5", size = 13389, upload-time = "2026-05-30T12:02:05.647Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/ef/a75bd6c17e012f7d73a8a2d94e324528a82dc06451b6019d910b1a993864/pyobjc_framework_corebluetooth-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8a3b35a1253de626d5efe705dda36a4f1fb8753e48aafdc4dbf99dc9c9526d86", size = 13196, upload-time = "2026-05-30T12:02:07.462Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/d7/11a8a90463e6a3928274e65bd17acaa3f0bfbd9c19a68b93c61cbc4fa379/pyobjc_framework_corebluetooth-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:bd0b9e7bc2fffcfa4843d7f103e1e927ce37817a70932d080378e1e29a073381", size = 13387, upload-time = "2026-05-30T12:02:09.431Z" },
+    { url = "https://files.pythonhosted.org/packages/10/d0/d5cc4ba6dbe21f6f4c90e8f0087254f1f742134580394b763025416ab7d2/pyobjc_framework_corebluetooth-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:a2dd4bd8fde13b97a3339a42d6703c9c9b148663e2e23a184ffe2877c8e51470", size = 13192, upload-time = "2026-05-30T12:02:11.41Z" },
+    { url = "https://files.pythonhosted.org/packages/25/a0/964b18affc8f6b582ed891f3b59413452fd95acce4adbf070a389b5197e4/pyobjc_framework_corebluetooth-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:42db087cd3a328abc620c76c7f708d7c2b451f3dbc0779983812a0c84320fe60", size = 13394, upload-time = "2026-05-30T12:02:13.443Z" },
+]
+
+[[package]]
+name = "pyobjc-framework-libdispatch"
+version = "12.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pyobjc-core" },
+    { name = "pyobjc-framework-cocoa" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/1b/fe/e23be301e46c30450955cdb096f16f6a86e7609787a4b8225ec24d6fdc9d/pyobjc_framework_libdispatch-12.2.tar.gz", hash = "sha256:4a41879ef7716b73d70f2e40ff39353d686cbc59d48c93217ed362d2b2baf1ba", size = 40345, upload-time = "2026-05-30T12:39:09.474Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ba/fb/b6948caf3e365aa3ad9400376832258ab25a10a43423d47a1be6d9ddef9c/pyobjc_framework_libdispatch-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0a43de8025ef9e2db597dbe3d2b49c9952d0b0aa93a78d89b0bfdc58f851f42c", size = 20466, upload-time = "2026-05-30T12:11:56.667Z" },
+    { url = "https://files.pythonhosted.org/packages/22/2b/b8d686307f4e8ba65afb204623da0b5568ac624caafc3a777a107c57fec1/pyobjc_framework_libdispatch-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:38fb417f3f3ee1ec20e14821f150210f5b6122e5c1d8b04958bddb660ce3d04f", size = 20462, upload-time = "2026-05-30T12:11:59.253Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/9e/94b587d8c5b243cb6026489752093a45d75fff08c85ed5b8b5548ad3596a/pyobjc_framework_libdispatch-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:9fb0028b400661b6b2279e2b611d396a4217bc36aa9dadd3ae21419551f5e091", size = 15634, upload-time = "2026-05-30T12:12:01.08Z" },
+    { url = "https://files.pythonhosted.org/packages/83/ac/f5e01c960287e3484f71a737e7ffd75ca1c192200de70fa342a22181895f/pyobjc_framework_libdispatch-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:265fe4edfd60de111c870932ab8397f845c314332a935aa7a27100fd8562cebc", size = 15651, upload-time = "2026-05-30T12:12:03.156Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/d9/8bcb4e234aee09396d06515ed80fb1f79cee3aeb67a311aa8e81a085584b/pyobjc_framework_libdispatch-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:117ed20ca54e334f657e60b9b9a3de3741d91875fd50ee51ac6a09224912cc68", size = 15918, upload-time = "2026-05-30T12:12:05.257Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/0e/caee3281628ba4913206167062274334a62ba5dedb8dada5fd884a53584f/pyobjc_framework_libdispatch-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fef3158dd4a068a9db8108a5cbf7da385788136e1d8af2e6fb7f82215016ecb2", size = 15679, upload-time = "2026-05-30T12:12:07.217Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/e0/ecf5fb9f11d12271818c5244c57d36ee654abfa2d15799bd594d4f58d931/pyobjc_framework_libdispatch-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:02dc66f1c11e25eceecf3c1b2b397f1727659dcac3e0c7b97784d5af3cfab491", size = 15960, upload-time = "2026-05-30T12:12:09.199Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/74/c1d1d1fc45434dcbab16887273d368d9ad89e65939babcffd502ed308ef9/pyobjc_framework_libdispatch-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:a81d9329fdf5094c9bc09b916e1d2fb86ab27138161d3e7ddb76ec2e780a1aba", size = 15699, upload-time = "2026-05-30T12:12:11.103Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/46/6ba13e10cbac853af00ee37444f37826a0688e32d1d22ce2fde4e2add9d3/pyobjc_framework_libdispatch-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:8daaf8844b5b328cf8adb6e8c085bf2aad22237956f7c5dc6fbb7a46c5015af0", size = 15990, upload-time = "2026-05-30T12:12:13.077Z" },
+]
+
+[[package]]
+name = "pyparsing"
+version = "3.3.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f3/91/9c6ee907786a473bf81c5f53cf703ba0957b23ab84c264080fb5a450416f/pyparsing-3.3.2.tar.gz", hash = "sha256:c777f4d763f140633dcb6d8a3eda953bf7a214dc4eff598413c070bcdc117cbc", size = 6851574, upload-time = "2026-01-21T03:57:59.36Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/10/bd/c038d7cc38edc1aa5bf91ab8068b63d4308c66c4c8bb3cbba7dfbc049f9c/pyparsing-3.3.2-py3-none-any.whl", hash = "sha256:850ba148bd908d7e2411587e247a1e4f0327839c40e2e5e6d05a007ecc69911d", size = 122781, upload-time = "2026-01-21T03:57:55.912Z" },
+]
+
+[[package]]
+name = "pyserial"
+version = "3.5"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1e/7d/ae3f0a63f41e4d2f6cb66a5b57197850f919f59e558159a4dd3a818f5082/pyserial-3.5.tar.gz", hash = "sha256:3c77e014170dfffbd816e6ffc205e9842efb10be9f58ec16d3e8675b4925cddb", size = 159125, upload-time = "2020-11-23T03:59:15.045Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/07/bc/587a445451b253b285629263eb51c2d8e9bcea4fc97826266d186f96f558/pyserial-3.5-py2.py3-none-any.whl", hash = "sha256:c4451db6ba391ca6ca299fb3ec7bae67a5c55dde170964c7a14ceefec02f2cf0", size = 90585, upload-time = "2020-11-23T03:59:13.41Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
+]
+
+[[package]]
+name = "pytest-asyncio"
+version = "1.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "backports-asyncio-runner", marker = "python_full_version < '3.11'" },
+    { name = "pytest" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/7c/d36d04db312ecf4298932ef77e6e4a9e8ad017906e24e34f0b0c361a2473/pytest_asyncio-1.4.0.tar.gz", hash = "sha256:c6c0d2259945122819f171a32ecea2c349ead889ee28176caaf492143424be42", size = 58514, upload-time = "2026-05-26T09:56:04.083Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/03/e2/08a497ef684b88559c9cc5f4ad53a37e7b99e727094a86d6ea32536d5d3c/pytest_asyncio-1.4.0-py3-none-any.whl", hash = "sha256:933ca923a23075a87fb7070c0ec272a6848489824d887c85c812670932835aa1", size = 16930, upload-time = "2026-05-26T09:56:02.576Z" },
+]
+
+[[package]]
+name = "python-dateutil"
+version = "2.9.0.post0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "six" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/ed/0301aeeac3e5353ef3d94b6ec08bbcabd04a72018415dcb29e588514bba8/python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3", size = 50135, upload-time = "2026-03-01T16:00:26.196Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a", size = 22101, upload-time = "2026-03-01T16:00:25.09Z" },
+]
+
+[[package]]
+name = "pyyaml"
+version = "6.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/a0/39350dd17dd6d6c6507025c0e53aef67a9293a6d37d3511f23ea510d5800/pyyaml-6.0.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b", size = 184227, upload-time = "2025-09-25T21:31:46.04Z" },
+    { url = "https://files.pythonhosted.org/packages/05/14/52d505b5c59ce73244f59c7a50ecf47093ce4765f116cdb98286a71eeca2/pyyaml-6.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956", size = 174019, upload-time = "2025-09-25T21:31:47.706Z" },
+    { url = "https://files.pythonhosted.org/packages/43/f7/0e6a5ae5599c838c696adb4e6330a59f463265bfa1e116cfd1fbb0abaaae/pyyaml-6.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8", size = 740646, upload-time = "2025-09-25T21:31:49.21Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/3a/61b9db1d28f00f8fd0ae760459a5c4bf1b941baf714e207b6eb0657d2578/pyyaml-6.0.3-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198", size = 840793, upload-time = "2025-09-25T21:31:50.735Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/1e/7acc4f0e74c4b3d9531e24739e0ab832a5edf40e64fbae1a9c01941cabd7/pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b", size = 770293, upload-time = "2025-09-25T21:31:51.828Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/ef/abd085f06853af0cd59fa5f913d61a8eab65d7639ff2a658d18a25d6a89d/pyyaml-6.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0", size = 732872, upload-time = "2025-09-25T21:31:53.282Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/15/2bc9c8faf6450a8b3c9fc5448ed869c599c0a74ba2669772b1f3a0040180/pyyaml-6.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69", size = 758828, upload-time = "2025-09-25T21:31:54.807Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/00/531e92e88c00f4333ce359e50c19b8d1de9fe8d581b1534e35ccfbc5f393/pyyaml-6.0.3-cp310-cp310-win32.whl", hash = "sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e", size = 142415, upload-time = "2025-09-25T21:31:55.885Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/fa/926c003379b19fca39dd4634818b00dec6c62d87faf628d1394e137354d4/pyyaml-6.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c", size = 158561, upload-time = "2025-09-25T21:31:57.406Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" },
+    { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" },
+    { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" },
+    { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
+    { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
+    { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
+    { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
+    { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
+    { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
+    { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
+    { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
+    { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
+    { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
+    { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
+    { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
+    { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
+    { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
+    { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
+]
+
+[[package]]
+name = "referencing"
+version = "0.37.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "rpds-py", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "rpds-py", version = "2026.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
+]
+
+[[package]]
+name = "rpds-py"
+version = "0.30.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/06/0c/0c411a0ec64ccb6d104dcabe0e713e05e153a9a2c3c2bd2b32ce412166fe/rpds_py-0.30.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:679ae98e00c0e8d68a7fda324e16b90fd5260945b45d3b824c892cec9eea3288", size = 370490, upload-time = "2025-11-30T20:21:33.256Z" },
+    { url = "https://files.pythonhosted.org/packages/19/6a/4ba3d0fb7297ebae71171822554abe48d7cab29c28b8f9f2c04b79988c05/rpds_py-0.30.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4cc2206b76b4f576934f0ed374b10d7ca5f457858b157ca52064bdfc26b9fc00", size = 359751, upload-time = "2025-11-30T20:21:34.591Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/7c/e4933565ef7f7a0818985d87c15d9d273f1a649afa6a52ea35ad011195ea/rpds_py-0.30.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:389a2d49eded1896c3d48b0136ead37c48e221b391c052fba3f4055c367f60a6", size = 389696, upload-time = "2025-11-30T20:21:36.122Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/01/6271a2511ad0815f00f7ed4390cf2567bec1d4b1da39e2c27a41e6e3b4de/rpds_py-0.30.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:32c8528634e1bf7121f3de08fa85b138f4e0dc47657866630611b03967f041d7", size = 403136, upload-time = "2025-11-30T20:21:37.728Z" },
+    { url = "https://files.pythonhosted.org/packages/55/64/c857eb7cd7541e9b4eee9d49c196e833128a55b89a9850a9c9ac33ccf897/rpds_py-0.30.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f207f69853edd6f6700b86efb84999651baf3789e78a466431df1331608e5324", size = 524699, upload-time = "2025-11-30T20:21:38.92Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/ed/94816543404078af9ab26159c44f9e98e20fe47e2126d5d32c9d9948d10a/rpds_py-0.30.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:67b02ec25ba7a9e8fa74c63b6ca44cf5707f2fbfadae3ee8e7494297d56aa9df", size = 412022, upload-time = "2025-11-30T20:21:40.407Z" },
+    { url = "https://files.pythonhosted.org/packages/61/b5/707f6cf0066a6412aacc11d17920ea2e19e5b2f04081c64526eb35b5c6e7/rpds_py-0.30.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c0e95f6819a19965ff420f65578bacb0b00f251fefe2c8b23347c37174271f3", size = 390522, upload-time = "2025-11-30T20:21:42.17Z" },
+    { url = "https://files.pythonhosted.org/packages/13/4e/57a85fda37a229ff4226f8cbcf09f2a455d1ed20e802ce5b2b4a7f5ed053/rpds_py-0.30.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:a452763cc5198f2f98898eb98f7569649fe5da666c2dc6b5ddb10fde5a574221", size = 404579, upload-time = "2025-11-30T20:21:43.769Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/da/c9339293513ec680a721e0e16bf2bac3db6e5d7e922488de471308349bba/rpds_py-0.30.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:e0b65193a413ccc930671c55153a03ee57cecb49e6227204b04fae512eb657a7", size = 421305, upload-time = "2025-11-30T20:21:44.994Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/be/522cb84751114f4ad9d822ff5a1aa3c98006341895d5f084779b99596e5c/rpds_py-0.30.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:858738e9c32147f78b3ac24dc0edb6610000e56dc0f700fd5f651d0a0f0eb9ff", size = 572503, upload-time = "2025-11-30T20:21:46.91Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/9b/de879f7e7ceddc973ea6e4629e9b380213a6938a249e94b0cdbcc325bb66/rpds_py-0.30.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:da279aa314f00acbb803da1e76fa18666778e8a8f83484fba94526da5de2cba7", size = 598322, upload-time = "2025-11-30T20:21:48.709Z" },
+    { url = "https://files.pythonhosted.org/packages/48/ac/f01fc22efec3f37d8a914fc1b2fb9bcafd56a299edbe96406f3053edea5a/rpds_py-0.30.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:7c64d38fb49b6cdeda16ab49e35fe0da2e1e9b34bc38bd78386530f218b37139", size = 560792, upload-time = "2025-11-30T20:21:50.024Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/da/4e2b19d0f131f35b6146425f846563d0ce036763e38913d917187307a671/rpds_py-0.30.0-cp310-cp310-win32.whl", hash = "sha256:6de2a32a1665b93233cde140ff8b3467bdb9e2af2b91079f0333a0974d12d464", size = 221901, upload-time = "2025-11-30T20:21:51.32Z" },
+    { url = "https://files.pythonhosted.org/packages/96/cb/156d7a5cf4f78a7cc571465d8aec7a3c447c94f6749c5123f08438bcf7bc/rpds_py-0.30.0-cp310-cp310-win_amd64.whl", hash = "sha256:1726859cd0de969f88dc8673bdd954185b9104e05806be64bcd87badbe313169", size = 235823, upload-time = "2025-11-30T20:21:52.505Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/6e/f964e88b3d2abee2a82c1ac8366da848fce1c6d834dc2132c3fda3970290/rpds_py-0.30.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a2bffea6a4ca9f01b3f8e548302470306689684e61602aa3d141e34da06cf425", size = 370157, upload-time = "2025-11-30T20:21:53.789Z" },
+    { url = "https://files.pythonhosted.org/packages/94/ba/24e5ebb7c1c82e74c4e4f33b2112a5573ddc703915b13a073737b59b86e0/rpds_py-0.30.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dc4f992dfe1e2bc3ebc7444f6c7051b4bc13cd8e33e43511e8ffd13bf407010d", size = 359676, upload-time = "2025-11-30T20:21:55.475Z" },
+    { url = "https://files.pythonhosted.org/packages/84/86/04dbba1b087227747d64d80c3b74df946b986c57af0a9f0c98726d4d7a3b/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:422c3cb9856d80b09d30d2eb255d0754b23e090034e1deb4083f8004bd0761e4", size = 389938, upload-time = "2025-11-30T20:21:57.079Z" },
+    { url = "https://files.pythonhosted.org/packages/42/bb/1463f0b1722b7f45431bdd468301991d1328b16cffe0b1c2918eba2c4eee/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:07ae8a593e1c3c6b82ca3292efbe73c30b61332fd612e05abee07c79359f292f", size = 402932, upload-time = "2025-11-30T20:21:58.47Z" },
+    { url = "https://files.pythonhosted.org/packages/99/ee/2520700a5c1f2d76631f948b0736cdf9b0acb25abd0ca8e889b5c62ac2e3/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:12f90dd7557b6bd57f40abe7747e81e0c0b119bef015ea7726e69fe550e394a4", size = 525830, upload-time = "2025-11-30T20:21:59.699Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/ad/bd0331f740f5705cc555a5e17fdf334671262160270962e69a2bdef3bf76/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:99b47d6ad9a6da00bec6aabe5a6279ecd3c06a329d4aa4771034a21e335c3a97", size = 412033, upload-time = "2025-11-30T20:22:00.991Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/1e/372195d326549bb51f0ba0f2ecb9874579906b97e08880e7a65c3bef1a99/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:33f559f3104504506a44bb666b93a33f5d33133765b0c216a5bf2f1e1503af89", size = 390828, upload-time = "2025-11-30T20:22:02.723Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/2b/d88bb33294e3e0c76bc8f351a3721212713629ffca1700fa94979cb3eae8/rpds_py-0.30.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:946fe926af6e44f3697abbc305ea168c2c31d3e3ef1058cf68f379bf0335a78d", size = 404683, upload-time = "2025-11-30T20:22:04.367Z" },
+    { url = "https://files.pythonhosted.org/packages/50/32/c759a8d42bcb5289c1fac697cd92f6fe01a018dd937e62ae77e0e7f15702/rpds_py-0.30.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:495aeca4b93d465efde585977365187149e75383ad2684f81519f504f5c13038", size = 421583, upload-time = "2025-11-30T20:22:05.814Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/81/e729761dbd55ddf5d84ec4ff1f47857f4374b0f19bdabfcf929164da3e24/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9a0ca5da0386dee0655b4ccdf46119df60e0f10da268d04fe7cc87886872ba7", size = 572496, upload-time = "2025-11-30T20:22:07.713Z" },
+    { url = "https://files.pythonhosted.org/packages/14/f6/69066a924c3557c9c30baa6ec3a0aa07526305684c6f86c696b08860726c/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:8d6d1cc13664ec13c1b84241204ff3b12f9bb82464b8ad6e7a5d3486975c2eed", size = 598669, upload-time = "2025-11-30T20:22:09.312Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/48/905896b1eb8a05630d20333d1d8ffd162394127b74ce0b0784ae04498d32/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3896fa1be39912cf0757753826bc8bdc8ca331a28a7c4ae46b7a21280b06bb85", size = 561011, upload-time = "2025-11-30T20:22:11.309Z" },
+    { url = "https://files.pythonhosted.org/packages/22/16/cd3027c7e279d22e5eb431dd3c0fbc677bed58797fe7581e148f3f68818b/rpds_py-0.30.0-cp311-cp311-win32.whl", hash = "sha256:55f66022632205940f1827effeff17c4fa7ae1953d2b74a8581baaefb7d16f8c", size = 221406, upload-time = "2025-11-30T20:22:13.101Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/5b/e7b7aa136f28462b344e652ee010d4de26ee9fd16f1bfd5811f5153ccf89/rpds_py-0.30.0-cp311-cp311-win_amd64.whl", hash = "sha256:a51033ff701fca756439d641c0ad09a41d9242fa69121c7d8769604a0a629825", size = 236024, upload-time = "2025-11-30T20:22:14.853Z" },
+    { url = "https://files.pythonhosted.org/packages/14/a6/364bba985e4c13658edb156640608f2c9e1d3ea3c81b27aa9d889fff0e31/rpds_py-0.30.0-cp311-cp311-win_arm64.whl", hash = "sha256:47b0ef6231c58f506ef0b74d44e330405caa8428e770fec25329ed2cb971a229", size = 229069, upload-time = "2025-11-30T20:22:16.577Z" },
+    { url = "https://files.pythonhosted.org/packages/03/e7/98a2f4ac921d82f33e03f3835f5bf3a4a40aa1bfdc57975e74a97b2b4bdd/rpds_py-0.30.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a161f20d9a43006833cd7068375a94d035714d73a172b681d8881820600abfad", size = 375086, upload-time = "2025-11-30T20:22:17.93Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/a1/bca7fd3d452b272e13335db8d6b0b3ecde0f90ad6f16f3328c6fb150c889/rpds_py-0.30.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6abc8880d9d036ecaafe709079969f56e876fcf107f7a8e9920ba6d5a3878d05", size = 359053, upload-time = "2025-11-30T20:22:19.297Z" },
+    { url = "https://files.pythonhosted.org/packages/65/1c/ae157e83a6357eceff62ba7e52113e3ec4834a84cfe07fa4b0757a7d105f/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca28829ae5f5d569bb62a79512c842a03a12576375d5ece7d2cadf8abe96ec28", size = 390763, upload-time = "2025-11-30T20:22:21.661Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/36/eb2eb8515e2ad24c0bd43c3ee9cd74c33f7ca6430755ccdb240fd3144c44/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a1010ed9524c73b94d15919ca4d41d8780980e1765babf85f9a2f90d247153dd", size = 408951, upload-time = "2025-11-30T20:22:23.408Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/65/ad8dc1784a331fabbd740ef6f71ce2198c7ed0890dab595adb9ea2d775a1/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8d1736cfb49381ba528cd5baa46f82fdc65c06e843dab24dd70b63d09121b3f", size = 514622, upload-time = "2025-11-30T20:22:25.16Z" },
+    { url = "https://files.pythonhosted.org/packages/63/8e/0cfa7ae158e15e143fe03993b5bcd743a59f541f5952e1546b1ac1b5fd45/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d948b135c4693daff7bc2dcfc4ec57237a29bd37e60c2fabf5aff2bbacf3e2f1", size = 414492, upload-time = "2025-11-30T20:22:26.505Z" },
+    { url = "https://files.pythonhosted.org/packages/60/1b/6f8f29f3f995c7ffdde46a626ddccd7c63aefc0efae881dc13b6e5d5bb16/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47f236970bccb2233267d89173d3ad2703cd36a0e2a6e92d0560d333871a3d23", size = 394080, upload-time = "2025-11-30T20:22:27.934Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/d5/a266341051a7a3ca2f4b750a3aa4abc986378431fc2da508c5034d081b70/rpds_py-0.30.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2e6ecb5a5bcacf59c3f912155044479af1d0b6681280048b338b28e364aca1f6", size = 408680, upload-time = "2025-11-30T20:22:29.341Z" },
+    { url = "https://files.pythonhosted.org/packages/10/3b/71b725851df9ab7a7a4e33cf36d241933da66040d195a84781f49c50490c/rpds_py-0.30.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a8fa71a2e078c527c3e9dc9fc5a98c9db40bcc8a92b4e8858e36d329f8684b51", size = 423589, upload-time = "2025-11-30T20:22:31.469Z" },
+    { url = "https://files.pythonhosted.org/packages/00/2b/e59e58c544dc9bd8bd8384ecdb8ea91f6727f0e37a7131baeff8d6f51661/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73c67f2db7bc334e518d097c6d1e6fed021bbc9b7d678d6cc433478365d1d5f5", size = 573289, upload-time = "2025-11-30T20:22:32.997Z" },
+    { url = "https://files.pythonhosted.org/packages/da/3e/a18e6f5b460893172a7d6a680e86d3b6bc87a54c1f0b03446a3c8c7b588f/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5ba103fb455be00f3b1c2076c9d4264bfcb037c976167a6047ed82f23153f02e", size = 599737, upload-time = "2025-11-30T20:22:34.419Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e2/714694e4b87b85a18e2c243614974413c60aa107fd815b8cbc42b873d1d7/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7cee9c752c0364588353e627da8a7e808a66873672bcb5f52890c33fd965b394", size = 563120, upload-time = "2025-11-30T20:22:35.903Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/ab/d5d5e3bcedb0a77f4f613706b750e50a5a3ba1c15ccd3665ecc636c968fd/rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf", size = 223782, upload-time = "2025-11-30T20:22:37.271Z" },
+    { url = "https://files.pythonhosted.org/packages/39/3b/f786af9957306fdc38a74cef405b7b93180f481fb48453a114bb6465744a/rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b", size = 240463, upload-time = "2025-11-30T20:22:39.021Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d2/b91dc748126c1559042cfe41990deb92c4ee3e2b415f6b5234969ffaf0cc/rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e", size = 230868, upload-time = "2025-11-30T20:22:40.493Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" },
+    { url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" },
+    { url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" },
+    { url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" },
+    { url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" },
+    { url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" },
+    { url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" },
+    { url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" },
+    { url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" },
+    { url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" },
+    { url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" },
+    { url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" },
+    { url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" },
+    { url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" },
+    { url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" },
+    { url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" },
+    { url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" },
+    { url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" },
+    { url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" },
+    { url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" },
+    { url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" },
+    { url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" },
+    { url = "https://files.pythonhosted.org/packages/69/71/3f34339ee70521864411f8b6992e7ab13ac30d8e4e3309e07c7361767d91/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c2262bdba0ad4fc6fb5545660673925c2d2a5d9e2e0fb603aad545427be0fc58", size = 372292, upload-time = "2025-11-30T20:24:16.537Z" },
+    { url = "https://files.pythonhosted.org/packages/57/09/f183df9b8f2d66720d2ef71075c59f7e1b336bec7ee4c48f0a2b06857653/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ee6af14263f25eedc3bb918a3c04245106a42dfd4f5c2285ea6f997b1fc3f89a", size = 362128, upload-time = "2025-11-30T20:24:18.086Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/68/5c2594e937253457342e078f0cc1ded3dd7b2ad59afdbf2d354869110a02/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3adbb8179ce342d235c31ab8ec511e66c73faa27a47e076ccc92421add53e2bb", size = 391542, upload-time = "2025-11-30T20:24:20.092Z" },
+    { url = "https://files.pythonhosted.org/packages/49/5c/31ef1afd70b4b4fbdb2800249f34c57c64beb687495b10aec0365f53dfc4/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:250fa00e9543ac9b97ac258bd37367ff5256666122c2d0f2bc97577c60a1818c", size = 404004, upload-time = "2025-11-30T20:24:22.231Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/63/0cfbea38d05756f3440ce6534d51a491d26176ac045e2707adc99bb6e60a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9854cf4f488b3d57b9aaeb105f06d78e5529d3145b1e4a41750167e8c213c6d3", size = 527063, upload-time = "2025-11-30T20:24:24.302Z" },
+    { url = "https://files.pythonhosted.org/packages/42/e6/01e1f72a2456678b0f618fc9a1a13f882061690893c192fcad9f2926553a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:993914b8e560023bc0a8bf742c5f303551992dcb85e247b1e5c7f4a7d145bda5", size = 413099, upload-time = "2025-11-30T20:24:25.916Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/25/8df56677f209003dcbb180765520c544525e3ef21ea72279c98b9aa7c7fb/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58edca431fb9b29950807e301826586e5bbf24163677732429770a697ffe6738", size = 392177, upload-time = "2025-11-30T20:24:27.834Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/b4/0a771378c5f16f8115f796d1f437950158679bcd2a7c68cf251cfb00ed5b/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:dea5b552272a944763b34394d04577cf0f9bd013207bc32323b5a89a53cf9c2f", size = 406015, upload-time = "2025-11-30T20:24:29.457Z" },
+    { url = "https://files.pythonhosted.org/packages/36/d8/456dbba0af75049dc6f63ff295a2f92766b9d521fa00de67a2bd6427d57a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ba3af48635eb83d03f6c9735dfb21785303e73d22ad03d489e88adae6eab8877", size = 423736, upload-time = "2025-11-30T20:24:31.22Z" },
+    { url = "https://files.pythonhosted.org/packages/13/64/b4d76f227d5c45a7e0b796c674fd81b0a6c4fbd48dc29271857d8219571c/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:dff13836529b921e22f15cb099751209a60009731a68519630a24d61f0b1b30a", size = 573981, upload-time = "2025-11-30T20:24:32.934Z" },
+    { url = "https://files.pythonhosted.org/packages/20/91/092bacadeda3edf92bf743cc96a7be133e13a39cdbfd7b5082e7ab638406/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:1b151685b23929ab7beec71080a8889d4d6d9fa9a983d213f07121205d48e2c4", size = 599782, upload-time = "2025-11-30T20:24:35.169Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/b7/b95708304cd49b7b6f82fdd039f1748b66ec2b21d6a45180910802f1abf1/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:ac37f9f516c51e5753f27dfdef11a88330f04de2d564be3991384b2f3535d02e", size = 562191, upload-time = "2025-11-30T20:24:36.853Z" },
+]
+
+[[package]]
+name = "rpds-py"
+version = "2026.5.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2e/43/25a8dcd3feedd735039a8f0b5b7e3b118232b5eae288c4fd9ab200d41094/rpds_py-2026.5.1.tar.gz", hash = "sha256:07b24fea40541e28570e5b795a4a38fbdcd12550c06bd0748005ecc8116ca256", size = 64459, upload-time = "2026-05-28T12:02:13.232Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4f/a0/acf8b6fc20bfdcd3a45bd3f57680fb198e157b7e997b9123b10763798bd2/rpds_py-2026.5.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:3397a5ed7174dc2786bb214030232fc36fe8e5584fec43a9952cc542b1a12036", size = 355609, upload-time = "2026-05-28T11:58:50.78Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/95/f8203fd997484b1690a6869cd0e503b6c3c6be55b0ecc36d1a491fe742f0/rpds_py-2026.5.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:99ab6ba7bfa2cb0f96a04e3652355bf04e3f51aceb1e943b8541dab7ba4828cc", size = 348460, upload-time = "2026-05-28T11:58:52.374Z" },
+    { url = "https://files.pythonhosted.org/packages/33/8c/b47326ad2f0be545a5e5c1a55937a12afaea7d392ba2837bb9680f57e6c9/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d0efbe45632665e53e3db8fe1e5692db58fc5cb9bab4459d570b83efefe11164", size = 381031, upload-time = "2026-05-28T11:58:53.775Z" },
+    { url = "https://files.pythonhosted.org/packages/22/0b/e83bbd97ffac6f6389b605cd4e1c8ac5761dc7e977769c9255d8c5adb7bd/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:01d17b29c0c23d82b1f4751147ec49cf451f1fc2554eb9ef5f957e55d2656ead", size = 387121, upload-time = "2026-05-28T11:58:55.243Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/0e/d285d1bc8864245919c61e1ca82263e4a66d337759c3a4cef72766ff9afc/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7559f72b94ae52659086c595dfa017cde03155f7832071d30959049052cb3ece", size = 501026, upload-time = "2026-05-28T11:58:56.788Z" },
+    { url = "https://files.pythonhosted.org/packages/86/06/ccb2109a1e543437b5e43816f2b43b9554cc6783145528a4e3711e05c011/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9e25b7088f9ccbfc0dfcaa52bf969300ca229e10ecf758974ebcbb080a4b37bb", size = 391865, upload-time = "2026-05-28T11:58:58.298Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/33/237173db1cfef10105b3839a24de00eb8d2a523711add4632447cdf0aedd/rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:613fc4ee9eaef26dc5840666214dd6fbcebcf32f46e76f4abc473059f4e13dda", size = 378012, upload-time = "2026-05-28T11:58:59.589Z" },
+    { url = "https://files.pythonhosted.org/packages/97/64/1eae54e34d5161f9969295e80bd6b62a55f2b6ac5f2a5b60d02c2140e758/rpds_py-2026.5.1-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:85264a90ff4c05c1568dd65f5921c837614b67c60358fb4c17df3b7f2e90690a", size = 391111, upload-time = "2026-05-28T11:59:01.104Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/34/5bb334a5a0f65d77869217c4654f34c78a7d11b93938a3c076a2edeafc52/rpds_py-2026.5.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe71bca7d547acb17027c7fd1624ff8aae623499c498d3e7011182c4de5c25e0", size = 409225, upload-time = "2026-05-28T11:59:02.433Z" },
+    { url = "https://files.pythonhosted.org/packages/16/0f/007ec21283b5b040b4ec3bd95e0402591e22bfa7d5c93dfe01c465c2d2d7/rpds_py-2026.5.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:a05fa4f41f37ec97c9c260441a940450a192f78d774d2b097eee1379f1e1246a", size = 556487, upload-time = "2026-05-28T11:59:04.012Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/10/5437c94508169b6b22d8418fef7a66e9ffb5f3b9e9c94460f2eedafe06ff/rpds_py-2026.5.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:df1d2a1996755b24b9ecee92cb4d36c28f86f464a6a173349c26bab41e94b8c2", size = 620798, upload-time = "2026-05-28T11:59:05.485Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/d5/9937dce4d6bda74157b954e7d1460db05a22f5929dccfeeba1ed27a93df0/rpds_py-2026.5.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:8895840ac4809e5f60c88fd07617cd71326e73d6e5a8aa783c5c0f7c24985de2", size = 584053, upload-time = "2026-05-28T11:59:06.837Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/31/750617dd0ae1752471bf43f9e41d263398fae7cde7849d23b8574a70e617/rpds_py-2026.5.1-cp311-cp311-win32.whl", hash = "sha256:3684a59b158a7683aaeb8e25352e9a9dd2122cec78f2d8530266e4f91b4c7b3f", size = 214390, upload-time = "2026-05-28T11:59:08.402Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/bb/3dcab0e1d9516303f2eb672a5d6f62eca5a69e2886301e9c8c54b520c39b/rpds_py-2026.5.1-cp311-cp311-win_amd64.whl", hash = "sha256:7bd530e6a530bb3ea892f194fafa455f3516ac25ecf7143fd33c09be62b0470a", size = 231097, upload-time = "2026-05-28T11:59:09.786Z" },
+    { url = "https://files.pythonhosted.org/packages/49/d6/c6bbf5cb1cf12b9732df8074b57f6ef8341ba884c95d40632ae8bddb44e4/rpds_py-2026.5.1-cp311-cp311-win_arm64.whl", hash = "sha256:0a5ae4dbe43c1076983b72616496919872ae7bbe7a1e21cc48336bc3154d130b", size = 226361, upload-time = "2026-05-28T11:59:11.079Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/e7/a78582dc57caa592dcc7d4fb69b61390561e908eb3d2f5df5928a8e354c0/rpds_py-2026.5.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3abe24a66e57adcfa645d718063a5fa5103ecc71ddbf26d78af8f9368018ff1d", size = 353040, upload-time = "2026-05-28T11:59:12.531Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/43/35e3f136343aef451e545ce8c38d36c2f93c0ed88703db8b64ba2b205c68/rpds_py-2026.5.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:58b1d94308ddf0b1982f61f2eb54bf92997c9ece8a8093ef014250f4a517906c", size = 345775, upload-time = "2026-05-28T11:59:13.827Z" },
+    { url = "https://files.pythonhosted.org/packages/20/e1/0f2160c5982d3157734d5cb3ed63d8b2d583a73c9864f77b666449f32cf8/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0fa92420128dadce7f54bd73ba1825a273e9268fe9e35dbf7e6362890efa4e08", size = 376329, upload-time = "2026-05-28T11:59:15.271Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/11/ee0ba42aff83bf4effdbc576673c6be64c5e173978c3f6d537e94482f77d/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ca653c6546386227cd9800d1bef6a348099acf8db4250341da6d90f663d6dfcb", size = 383539, upload-time = "2026-05-28T11:59:16.665Z" },
+    { url = "https://files.pythonhosted.org/packages/11/df/d94aa6a499d4ac40afe2d7620f2c597fd3c0f182e854ad7cf3f596a81cb6/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:66c93681c4729e4e3ecba31b8179fae083ff3118841672835140338b4b9867c1", size = 494674, upload-time = "2026-05-28T11:59:17.991Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/75/33d30f43bb2f458de11979486a591b1bf6e5651765ed1704c6197c2dc773/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:40ff257542e04796880e011e15cd4dc21c2599975df2aaa8f2c8495ca574e1a5", size = 389268, upload-time = "2026-05-28T11:59:19.434Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/1e/2c9096fc19d5fd084b0184ca2b651e659aa0a37e6fdbecf6ece47f147fe1/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b6825cc329b290e93c5f6a9be2393118a763f6ccf6abd83704e0c102ca583644", size = 376280, upload-time = "2026-05-28T11:59:21Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/e5/61ec9f8be8211ea7f48448195549e4aaf02004083475493b0e137702ecb2/rpds_py-2026.5.1-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:de42116e69cb53b911cc34aee5ab98f36c597b822545045d49e938818b99e5e4", size = 387233, upload-time = "2026-05-28T11:59:22.454Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/ca/bcec1005c4f4a234f92a29078631fee49206c7265ccae966f18fd332e80e/rpds_py-2026.5.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c0f920015df2a504bebaba6d4c31ccf3fcf942f92655c086da30b671aad19aa6", size = 405009, upload-time = "2026-05-28T11:59:23.845Z" },
+    { url = "https://files.pythonhosted.org/packages/72/e6/4d5718c5cf26c522dc7c9999e238da1e77380b81d0c5d1df11e271ddfeb1/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:0408a24e44feb919423dc6d9da677cb5cddb894d2ca9e763967d156d9c60fab4", size = 553113, upload-time = "2026-05-28T11:59:25.184Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/25/2ee807bdb3e1f0b7eddf7782acd5665a8b5205a331a7d7244a52c4812fd9/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:cea68bcd53467561ae2f96a6bdad1544299ba97b5b0ddcd5ac3d376e5c781c24", size = 618838, upload-time = "2026-05-28T11:59:26.749Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/c1/7d4c26f167f8c41501cc073d30ee22082b16ce358cf5b00ec97cbc7804ea/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:4be8b1d2a705cc37d08256004e1d07de143fa0075c8e85a3df020b776f62b732", size = 582436, upload-time = "2026-05-28T11:59:28.11Z" },
+    { url = "https://files.pythonhosted.org/packages/04/1d/9d12b0a337bab46f4769f8857f4007e3b2d639e14f9a44a0efe157696e64/rpds_py-2026.5.1-cp312-cp312-win32.whl", hash = "sha256:6736718bd4fc49cbcb538ba30516fdbef161522acefb739657d48b97bd864fed", size = 212734, upload-time = "2026-05-28T11:59:29.689Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/93/e4116f2de7f56bc7406a76033dc501811ddeb22b7f056b92d632871ebb0c/rpds_py-2026.5.1-cp312-cp312-win_amd64.whl", hash = "sha256:0a7d1eec967df0e9b22614a5e177622e0c89611d03727fa0cb48e45028907870", size = 229045, upload-time = "2026-05-28T11:59:31.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/53/6c3419d85eb2ec5938a37627c585b42d76a63bb731d6e42ed4b079ebf486/rpds_py-2026.5.1-cp312-cp312-win_arm64.whl", hash = "sha256:1841d067089e117142d79b98aa0df2f08b52f2ecc1819dd2700636c0db74a473", size = 223967, upload-time = "2026-05-28T11:59:32.318Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/32/14c961ad295f490eb0849ada8b79683e93a59b9de3afdd983eaf55fa6867/rpds_py-2026.5.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:efef4ac29c6ff495531eb17ee705b62841ecaa291b7c7077e848ea03e237164d", size = 352787, upload-time = "2026-05-28T11:59:33.655Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/bb/d1b85117967c11191441a7274ae616c65d93901d082c588f89a50a8da5ae/rpds_py-2026.5.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c39f5b67a8a2e67179ada2a954227d670fe65fa9098457f698f56ddf248709b3", size = 345179, upload-time = "2026-05-28T11:59:35Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/46/d84105f062e626a1b233f863907288a4708c2d833b8b4c6fb2764bc080c0/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5c30f3f04eef4fbd362226a6f31d7c8895ca4fbb6e0b790f6890a98d8da8559", size = 376173, upload-time = "2026-05-28T11:59:36.43Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/ae/469d7959ce5b1201e1de135dc735b86db3b35dd0d1734f6a44246d5f061c/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:277f6c82f0580848796c7ecc8a7173aa3bfb928e4ff831261c2f60a81dc270db", size = 383162, upload-time = "2026-05-28T11:59:37.995Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/a2/57853d31a1116a561aa072794602ad3f6341e18d70a8523f1bd5b9fc1e5a/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:63c2c4c213f1a4e3f3de28ecab029dbdee976324e729c0d7a55211be72576b02", size = 495093, upload-time = "2026-05-28T11:59:39.453Z" },
+    { url = "https://files.pythonhosted.org/packages/99/63/3a8eabcad9314b7daf5c65f451d2c33d989235cd8a5762186cf2c3f5a4f8/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3350ec808fb538fe71a1f94dfaa0e29c598dfad805ce49f0caec5ae3183c652b", size = 389829, upload-time = "2026-05-28T11:59:40.896Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/25/05678d97fc25e2622df14dc530fb82023174ecfff6733991ed0d78f167bd/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b1b964e3ab599e718dc46c018d104b1ebc007cbc6567d827c94a687fca56d77e", size = 374786, upload-time = "2026-05-28T11:59:42.626Z" },
+    { url = "https://files.pythonhosted.org/packages/88/d1/8c90b6431e80a3b91b284a5c7c8c0c4f9c006444d90477a740d6e0f9c694/rpds_py-2026.5.1-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:19cb09fab7b7fc96b2a6e28f2e34b72a3705ff27b37edb77455316e5d3f3dc9b", size = 386920, upload-time = "2026-05-28T11:59:44.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/99/4638f672ab356682d633ee0da9255f5b67ce6efd0b85eb94ad3e255e65a5/rpds_py-2026.5.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:abe76bcdba31e576cb83eeb8797aa0d882b738fef6dc65d0601fc753806a5b46", size = 405059, upload-time = "2026-05-28T11:59:47.177Z" },
+    { url = "https://files.pythonhosted.org/packages/66/3f/3546524b6eb4cc2e1f363a3d638fa52f6c24faae3500c25fb488b02f1740/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:8bff7073db3899158fff55ebf57b113a67030af26f80a18978f9f0aa60250ddf", size = 553030, upload-time = "2026-05-28T11:59:48.603Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/c3/7b3388c796fcf471bd17194242d4dc1a7608567c0fa422bcc1c5e79f9c1e/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:8ba264fa49be666cd9cc56bf34ec7002fb3d27a4aee5bcb4d43d0d18feb1bb6f", size = 618975, upload-time = "2026-05-28T11:59:50.314Z" },
+    { url = "https://files.pythonhosted.org/packages/61/1e/a3cb07f2795075d1d88efddae2f541359fde5f08c81ee114c29c2949c90a/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4860b603ddda0475a8885499b3729e90229d480105b42651962a5397d995fa89", size = 581178, upload-time = "2026-05-28T11:59:51.673Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/74/e758c03a5ef46f04c37f2651a2893db846d569ba8a7bca469d4b58939bcd/rpds_py-2026.5.1-cp313-cp313-win32.whl", hash = "sha256:7944270ae71383f6e2657dd7d5ce4eeb4ac2d0059a6738f0510583d462ab4842", size = 212481, upload-time = "2026-05-28T11:59:53.148Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ec/a2aca432db9c7359b40fa393eeeaa0d166c2f70175be956e75fa24197c44/rpds_py-2026.5.1-cp313-cp313-win_amd64.whl", hash = "sha256:88647f43a73c4e01be19b04ceef0c8d3a1958153604d13c773becd8016f2a0cf", size = 228519, upload-time = "2026-05-28T11:59:54.505Z" },
+    { url = "https://files.pythonhosted.org/packages/29/60/a73bfdd45b096574556acf303bbd9fa9eed36ca8a818b514e2a5d5fe2b9d/rpds_py-2026.5.1-cp313-cp313-win_arm64.whl", hash = "sha256:453895624ecf7db7063b1004e44037522bbaef9ff6a945e59bc71662d7a03abd", size = 223446, upload-time = "2026-05-28T11:59:56.081Z" },
+    { url = "https://files.pythonhosted.org/packages/18/e2/408105fd611823f00882aea810f3989a30d26b1bab8b6beb20f98c724e0e/rpds_py-2026.5.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:b4e4bc98639ec915f512fde3aa7a95e0041d95d9c3cc86eea841fa63cb1e8600", size = 355287, upload-time = "2026-05-28T11:59:57.448Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/58/5c4a43436843c90d0f6d19f82c200c80e3843ca9fa07b237623327f6d384/rpds_py-2026.5.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:cacedb7a6e167680acba45ad5716e89067d225dc80da0d7040cae8c81d4572fa", size = 347033, upload-time = "2026-05-28T11:59:58.881Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/c2/1a71acdacaf4e259b10278fb87b039ded3cf80041bcd89dd8a3ea702ded6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:68700371c5d7ae1412862ddfa719090925c93ecf351c566d66f09d04b136ea00", size = 376891, upload-time = "2026-05-28T12:00:00.516Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c8/535f3d9b65addd8e28aa87b83c6e526799c3717a88273db8ea795beeef7a/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:296c799becfa849c779c8725494fe9ed94959ed886787df4364b058465bad7f0", size = 385646, upload-time = "2026-05-28T12:00:02.394Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/91/dc033f313345c354ade914dbe73cdb90b615a4409ea02430d5356794f3d8/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d3858b908218ee108d0bbfb2095ccc237648053c9bf98affad7cb079acaf1d97", size = 498830, upload-time = "2026-05-28T12:00:04.189Z" },
+    { url = "https://files.pythonhosted.org/packages/27/fc/90fcbea459dbb8ddc18a2e0fd1de9412b48bc84ffff2db771cf714bacfd6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4fb8d2e7cb2f850b169806d61d1b991738acec96500a75c30f49caf064ce7cef", size = 392830, upload-time = "2026-05-28T12:00:05.797Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/1d/46cd11a228c9750684a798d98f878be6f614aa762438da7378f035e79e35/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:27b74c10ed6a8f190f4287f53bcfea348b92a84a9c9f70d30183d1e6172d580d", size = 379613, upload-time = "2026-05-28T12:00:07.433Z" },
+    { url = "https://files.pythonhosted.org/packages/24/4a/d9b0c6af3a1de03eb93741bbe8be2bdce84d8fda8224f3005451d86df389/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:b9a6528956191c48c52294a592dbd4a8386d7048bdb25c0efcb6b966466c6d83", size = 388183, upload-time = "2026-05-28T12:00:09.227Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/b4/db7aaabdda6d020afc87d981bcc2f57a434c7dec60ecfc2ab3dd50b20351/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:af03e34e860047bc7a352b842856fcf78798fbb81132cc98bd2f907ab4eb9cd2", size = 408578, upload-time = "2026-05-28T12:00:10.779Z" },
+    { url = "https://files.pythonhosted.org/packages/08/d6/070f6a41cbb343e2ac4171859bf3f3623e0ab002f72619d6d505313ec2de/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:fea6e836d10abbe191d557d33bd58bd5987725fe63aa1eefe557d230209855bd", size = 553573, upload-time = "2026-05-28T12:00:12.443Z" },
+    { url = "https://files.pythonhosted.org/packages/75/ab/1a71ea3589c4345dac0a0518f0e6a031cb42689277851b683c46d27463a5/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:fc0c0f878ea770a0a8a462456c5ad36fc9fe6358e6b76fdadc7f17575e0b8bf1", size = 620861, upload-time = "2026-05-28T12:00:14.09Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/22/9bf80a56069c0c443fcfefac639a86a744550a2898817a6dfd3e26654924/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:e0b360f316d966b048b085857630b3cc51f3db2f07b06f440eac8f695374d1e3", size = 585633, upload-time = "2026-05-28T12:00:15.66Z" },
+    { url = "https://files.pythonhosted.org/packages/da/68/3b2c0a75c9e04125696f84ebdbbf304acf5a40b58ba4481cdb98a922c3ba/rpds_py-2026.5.1-cp313-cp313t-win32.whl", hash = "sha256:a2999883eedf72fdfb7520b92c7d4ec2572a71ff40239377aa604cc529eecafc", size = 210074, upload-time = "2026-05-28T12:00:17.291Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/8b/609157d5a25d37d4f29f92840ba531f416907c34ae5c5739dd21fc2bef98/rpds_py-2026.5.1-cp313-cp313t-win_amd64.whl", hash = "sha256:e07be2a9d7122bd6e82dea89814ef8dc893feb1aae97fec1630f3263bbb30e55", size = 228635, upload-time = "2026-05-28T12:00:18.73Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/6f/19c1918a4b590d8de87e712e4abe4b3875771eff60216fb6153cf6665c68/rpds_py-2026.5.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:1f2c391c3059798093b65df23aca2cac150460ae9c630d99dec83d703d9485b9", size = 349756, upload-time = "2026-05-28T12:00:20.217Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/60/a06fe7da34eca79dacbf958a2ba0c6eea85bc2b29de20080bf40f72f66fa/rpds_py-2026.5.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:413b424f7c4ee65ab5e5be91f5731be0f8b41a1ee2b12dfe810d716312e95a78", size = 343831, upload-time = "2026-05-28T12:00:21.711Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/ec/b2333b97b90e2a6ef6ca8ad386ee284968e74bcfe113b3f1a8d9036429a9/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2c595a1d9255dce0599e13130d1440ab2506654f2b50294226ee06402f8fef63", size = 375127, upload-time = "2026-05-28T12:00:23.326Z" },
+    { url = "https://files.pythonhosted.org/packages/14/7f/e00aae54067f2b488c4637961d5f58204d470795fc791085fa3f15060d2e/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1c27c5f6102eac8c03e7595a00827a53b271ba40a53b59ff8709170e0855ea4a", size = 379034, upload-time = "2026-05-28T12:00:24.89Z" },
+    { url = "https://files.pythonhosted.org/packages/be/cc/423999bbb8ae8dc93c77fc1d5e984ade5eb89d237d3bb884ccfa72ae2890/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6c7fcf61d44cacecaf3aea542b0e053db77972a4573e7ceda16fb2b399161195", size = 490823, upload-time = "2026-05-28T12:00:26.676Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/aa/c671bf660f12e68d3c52ff86c7066ed1372df5a0f4f2ff584e419b8207e7/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2c817a189d4ee14290420e5ff051e4dd6baa13f3edf84685071dee07a6d538ee", size = 388144, upload-time = "2026-05-28T12:00:28.577Z" },
+    { url = "https://files.pythonhosted.org/packages/19/c8/d63bb75b68afe77b229e3021c6031bcaf01da5db5b0e69d0d10f9ba679a7/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21846aac0ed2e0589f38c12dc44e77bb64e494b771eadbcf169cba00566ba7ba", size = 371959, upload-time = "2026-05-28T12:00:30.304Z" },
+    { url = "https://files.pythonhosted.org/packages/82/35/c51122014d8274ff37dc606d60049c3db7d83da02b5b282511e5a906a9a6/rpds_py-2026.5.1-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b317c87a13f769a4e787819bd508aaa5d69aa09b0880de9af6d3a8a54571cdec", size = 383558, upload-time = "2026-05-28T12:00:31.764Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/f9/2790cb99c136a5363acdeacf5c27c56f3de0d4118a1f48fca83404c99c89/rpds_py-2026.5.1-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ce87129d9f2c14fa6c4a8601fb80eb4488c80d38a20cd13758ef11123e14995d", size = 402789, upload-time = "2026-05-28T12:00:33.247Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/1b/e4fb584f8c75d35c38150ff6a332cda949e6f97acba1f4fd123b14ab56fe/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9cdddb6c1207d284d94fd1530adf57fbd797fe7c4b8704ba85f49414f2557e7d", size = 551405, upload-time = "2026-05-28T12:00:34.819Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/f7/a6731b4216cb3793ea1af5391da240f5683dacc0d13e034fe5fc3503f240/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:4e237e139f94d3c036fd28eb9f564c99055476ff4ff05cd42be55ce349b5aa02", size = 616975, upload-time = "2026-05-28T12:00:36.268Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/ea/2e051a81d95d8e63f4b35a1c463a87e8766bc3d083c067c5dfb6bf220747/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ed0954b524873214369184a9c82b0eaa45a3fbb9a798cd95b17e0d98499e7ea0", size = 578701, upload-time = "2026-05-28T12:00:37.82Z" },
+    { url = "https://files.pythonhosted.org/packages/65/56/b5f6fdb2083e32bca8a8993d89e70db114b4756c9e2c38421328126689d2/rpds_py-2026.5.1-cp314-cp314-win32.whl", hash = "sha256:2d88621d6a7d4dfa633d21abe90f280bb205274e16b1d1e61c6ad4640b2453b7", size = 209806, upload-time = "2026-05-28T12:00:39.492Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/80/65a5aa96c155e611d1ed844e4e1f57f3e36b021f396d9f8585d756e6b90d/rpds_py-2026.5.1-cp314-cp314-win_amd64.whl", hash = "sha256:cef8ac28d26f4dda3533060c20fbf80a325458fa9fd23ea72a73cdfa8e978838", size = 225985, upload-time = "2026-05-28T12:00:40.94Z" },
+    { url = "https://files.pythonhosted.org/packages/27/7c/ad185212e87b05f196daef92bc5f3caf07298eb47c295b5585c3dd3093ac/rpds_py-2026.5.1-cp314-cp314-win_arm64.whl", hash = "sha256:eaaea962c68cdc68d4a533ba985ab8e9484277910bbfaa2ab3ef7732667bfed8", size = 221219, upload-time = "2026-05-28T12:00:43.15Z" },
+    { url = "https://files.pythonhosted.org/packages/23/58/e14ae18759020334646b031e708ab4158d653a938822bfb7b95ef2e93aa3/rpds_py-2026.5.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:21942f52dbbd5f8758bf021213d28bd45c39e873e65e2407faf5f1846f5761ad", size = 352148, upload-time = "2026-05-28T12:00:44.638Z" },
+    { url = "https://files.pythonhosted.org/packages/31/9b/5f4a1e2f960bca3ac5d052b139dd31eed97b259f9d909173821760d542e8/rpds_py-2026.5.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f414556f6e3958300ff941e40c9f97e3dc9774ddd1b3434c475d73dd354bbed3", size = 345196, upload-time = "2026-05-28T12:00:46.14Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/71/1d9574d6a2fa20ab60eaa55c7467f5aa20cbc770f341a05f09c0876f59e2/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ef1013a8625c74043210190b246f5b1551e09757c1f356c6e4160ef96c5bc081", size = 374981, upload-time = "2026-05-28T12:00:47.531Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/9a/37e99f4915a80aa71670263c1267f7ae0af95f53a3f61e6c3bdc016d4515/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cc68e231a77a5f0d774ae278a1f8e55c0456501820847c1e4efb3829f3441df6", size = 379961, upload-time = "2026-05-28T12:00:49.216Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/ff/6e73f74b89d2e0715e0fc86b7dde893f9a61ae2f9b256ff3bdfe41ac4e94/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9baffb505aff33acc69b422a19f77806680f3c8632227d79f48de8a810d1c2c5", size = 495965, upload-time = "2026-05-28T12:00:51.111Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/e0/425faba25f59d74d4638b267f7c7a80e8649d2ef4db10a19b0c4a71e6e6f/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b8d2f912928d426e8cfa396f7f3f8d29a59e6689c86dcca3c420730c1096322b", size = 389526, upload-time = "2026-05-28T12:00:52.77Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/76/7a41960e3fddae47fab43a28684d5da981401dffd88253de0944148654cb/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90f628283be835db980c941767d41c9a27b5239e54ba0a9c1335247e82406964", size = 376190, upload-time = "2026-05-28T12:00:54.215Z" },
+    { url = "https://files.pythonhosted.org/packages/27/60/5f38dc70824fc6951b51d35377e577a3a3a4c81a6769cc5a2de25ebe0ad1/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:1ebb2f0ab7e16132995a72de805170e0203df0c3dd22e1ef1cd1fdd90bd7a131", size = 383921, upload-time = "2026-05-28T12:00:55.673Z" },
+    { url = "https://files.pythonhosted.org/packages/60/1a/d60a38caa1505f4b9483c3fbbde12c94e1079154f4f401a6da96f7e77621/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f3df3d16ded76f1f8c9cdebd0e1ea55fdf4c23b812de189814da7cf229c22a81", size = 404766, upload-time = "2026-05-28T12:00:57.518Z" },
+    { url = "https://files.pythonhosted.org/packages/87/ff/602fd3f174d6425f0bce05ad0dfbec0e96b38d0f7d08a79af5aa20083885/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9af8905b8f854990e40d5206aa5ac58d9b0fe0b7f351ff2bb086c20f6c8c6a47", size = 551343, upload-time = "2026-05-28T12:00:58.978Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/c1/1be13327acdbead3eca1fde03b6a34dbb011f1e864e217f0d32cc1779a7f/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:036a36a87fb1cd3b214d11c4b3c4f7d2ddad933625dca1c900b56a057c07740a", size = 618502, upload-time = "2026-05-28T12:01:00.656Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d7/afb49b49d7f2be8b7ba1a9f0977fa5168003437b93086726f066544e8351/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:62ae3853454fe9ef283a03c96c2d835d39e84b14643a9d62c82ef0fb87d702ca", size = 581916, upload-time = "2026-05-28T12:01:02.22Z" },
+    { url = "https://files.pythonhosted.org/packages/25/d1/dbef8c1f8a10f07beb62b5f054e20099fd9924b3ec001b8f0b6ac7813a85/rpds_py-2026.5.1-cp314-cp314t-win32.whl", hash = "sha256:6c3d771a46ec18b12af06ce36243a9a80b07a5d0515236332d90863ca8bb326a", size = 207855, upload-time = "2026-05-28T12:01:03.821Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/72/bfa4e61ab8e7dc1c8adf397e05e6cbdd4239357bd72b248d3de662f23915/rpds_py-2026.5.1-cp314-cp314t-win_amd64.whl", hash = "sha256:c93c629be4636cf54337bd5f06c104d55e42ced54d681f6fe21ae510a65116f6", size = 225422, upload-time = "2026-05-28T12:01:05.194Z" },
+    { url = "https://files.pythonhosted.org/packages/27/3a/7b5da92b640f67b6717ccafc83cdd06bfa7ff2395c3685c68922bb54d703/rpds_py-2026.5.1-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:3574b55c604b8f75dacb007136508bbc0db406e626301778096a133327e7f2fb", size = 349576, upload-time = "2026-05-28T12:01:06.722Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/8a/2aafd7ad355a1bd48ca76e2262b74b15e6432b5a1efe150efd4d779cd55d/rpds_py-2026.5.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:94068eb3ae6d43f5a786b7db96a406a34e6d5c24489feef32fd6e8946ea7b291", size = 343640, upload-time = "2026-05-28T12:01:08.441Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/7d/6c9523c1abbe840a1b7fba3c516d48e1d3487cc80fea4366c4071cf56784/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f3a5b10e8ce894825f380a8f1b6444cf73c294dfea62afbb2d13e3a9e630cec1", size = 375322, upload-time = "2026-05-28T12:01:09.934Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/5d/0b7b03fb1dc509321f01de3149784ab773e34c8573022029af8076afcb9c/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fc09f82e63d4bcd58149572f857a431bae851dc747e313c3b5bdf7abb907fda8", size = 379066, upload-time = "2026-05-28T12:01:11.48Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/e2/8ef6012999ebf1cb1c22f876d9ce5e63d960fd4631d2af3202d3f480aa25/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e10464d17df3b582745c25cec695cb9558bca2cb6ddb631aee1787fc72c767b2", size = 494586, upload-time = "2026-05-28T12:01:13.051Z" },
+    { url = "https://files.pythonhosted.org/packages/80/af/1eeb029bec67582c226b7809172207cd005073af4ebd906e65ff494f4983/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ba05adbf15d994c38ec0b7ab32e858e5110c21e9009a00a86545fd220f84e038", size = 388415, upload-time = "2026-05-28T12:01:14.631Z" },
+    { url = "https://files.pythonhosted.org/packages/18/23/ffbe10711c4d766c1cab0557d6906c074f795814863c67b351355d29354a/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:77c004fdc7b891967106f78ddfd7b076bfe6813c6139c6fff6aed3bcaa960b26", size = 372427, upload-time = "2026-05-28T12:01:16.153Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/3a/30ba4a6ad457e5b070c18d742a33fb77d8d922b565cc881f8a5313d63bfe/rpds_py-2026.5.1-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:83bcf894486c9d78dd290d3c0124ff6dd8875d3025e2090a8ec49fcc37c55fdd", size = 383615, upload-time = "2026-05-28T12:01:17.809Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/69/62e242b53ce39c0814bd24e1a6e6eba6c92be716277745f317f9540a2e7b/rpds_py-2026.5.1-cp315-cp315-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c3df104083952a0e0c6f10de33e440eabe98fb6317d23e1a58c68f6df08d01b9", size = 402786, upload-time = "2026-05-28T12:01:19.419Z" },
+    { url = "https://files.pythonhosted.org/packages/38/c1/a770b9c186928a1ed0f7e6d7ae50e7f3950ed23e3f9e366dbc8e38cb55de/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:980450826cf22e133c57e0835070bdd0dd3f73b9b708c3ce223def2cb9469e14", size = 551583, upload-time = "2026-05-28T12:01:21.013Z" },
+    { url = "https://files.pythonhosted.org/packages/21/7c/68e8579b95375b70d2a963103c42e705856cdb98569258bd807f4423891c/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_i686.whl", hash = "sha256:205dde846f24332ab0c1188699a043b8d165b79bb84529ce272c45048ff6be01", size = 616941, upload-time = "2026-05-28T12:01:22.548Z" },
+    { url = "https://files.pythonhosted.org/packages/70/a1/a6135aed5730ff03ab957182259987ac11e55fb392a28dc6f0592048a280/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:3966b82dd563176396df030f3dd52a6e54cb69b718e95e78bd555ed3d1e0185d", size = 578349, upload-time = "2026-05-28T12:01:24.118Z" },
+    { url = "https://files.pythonhosted.org/packages/09/6e/f24201a76a84e6c49d0bdfdfcb735210e21701e9b21c5bfc0ba497dd62f6/rpds_py-2026.5.1-cp315-cp315-win32.whl", hash = "sha256:7818f8d0a415be74d2be3590b0a1c1f463a642f4d0217e7d10602dceef5b79aa", size = 209922, upload-time = "2026-05-28T12:01:25.522Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/e4/966bc240bb0485fc265278f6de44d05834bf0b3618886e0b22e33d54c49a/rpds_py-2026.5.1-cp315-cp315-win_amd64.whl", hash = "sha256:b3cc20c0d800af78fd0fac68086e28c1856cec51ea528bb81ea851aa40d39325", size = 226003, upload-time = "2026-05-28T12:01:27.062Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/5c/a15a59269cd5e74472734516c73795c15eccfc841b3d4b0228c3f53f19d0/rpds_py-2026.5.1-cp315-cp315-win_arm64.whl", hash = "sha256:3609e9939a8a76cd904cf98a3f1f13b5dc7e150adeaee89e0ea09652ea213e16", size = 221245, upload-time = "2026-05-28T12:01:28.51Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/22/135ce03804e179a71ceb13be095deda4a279bc88f7a6b8fa161c5ad44e12/rpds_py-2026.5.1-cp315-cp315t-macosx_10_12_x86_64.whl", hash = "sha256:5d333a7127d4b307601ac37792bee01bb95c867cbfacf21b6375b804d6bbd723", size = 352015, upload-time = "2026-05-28T12:01:30.214Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/5f/f1f6d2652eb9d848f6eb369d8db83a2da6249bb49ad2c2a48f45d54538d3/rpds_py-2026.5.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:b5f077b44a4f7808520f66dae234988d867deb9aed9be5da057ce9ba831b2a41", size = 345016, upload-time = "2026-05-28T12:01:31.656Z" },
+    { url = "https://files.pythonhosted.org/packages/88/66/b74182775691ea2290c99e52ac8d5db844e56fbec90ce421f107658c8314/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:55d8f9b7b78c9538fc9e04e82ec0e888ff0c3cffcfad152c77e57cd09351a98a", size = 374775, upload-time = "2026-05-28T12:01:33.136Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/8f/15e5a61d9f0a43902d36561d4f07cae6ae9f4716be825159fd72717f33af/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e3a8ae58895ac107ed934a6bf51e5846f95c53b9b940c2c6d310838fd5846358", size = 380270, upload-time = "2026-05-28T12:01:34.574Z" },
+    { url = "https://files.pythonhosted.org/packages/02/c3/f859b12763a80540cdf2af0f15b19904cf756a71d7bdd3f82ff3e5b1bbf9/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0957cf3c2b8632ec7aaebffebea8005b353cc2a237b6e2ae3c2cac0820704cfb", size = 495285, upload-time = "2026-05-28T12:01:36.127Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/c7/ff27c2ac8411d30b03b1829fd88cae8dad1a4d0da48dd25e57c4038042e6/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c396c1304de421050b3681ea70f371874b54d41b0151e96109758144c231e30b", size = 389581, upload-time = "2026-05-28T12:01:37.635Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/67/fe92ee32a6cc05c77228a2f8b1762e7124f386ec20ff83d0757b762d58d0/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aad1bff7f666b9598e573815affd666aac6a13a585dde336f843e33350c7fadc", size = 376041, upload-time = "2026-05-28T12:01:39.307Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/91/b4d6685c27aba55bd82f25b278be8237038117d05f9659a6213ad3408130/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_31_riscv64.whl", hash = "sha256:656a042550878f12d45752452d47094b7cfe5ad1e9d7b87b5a22ad3ae5ff8015", size = 383946, upload-time = "2026-05-28T12:01:41.043Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/79/2c1d832a53c8e0f8e98fc970ec257b950fecd4f62be2ab7182b500a0cbc8/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:73c4bd4f70294737b5206a3e8e30ccadbf8a60301831c8ea23eec5dbeea1ecfa", size = 405526, upload-time = "2026-05-28T12:01:43.032Z" },
+    { url = "https://files.pythonhosted.org/packages/78/c4/c98117b03c6a8581ab2c2dfccfe9a5ad82bd8128a3c28b46a6ad2d97c393/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:43bca78665423cabae77146f2fe7ce55272b6c8d55d82cca83effd42c7e13972", size = 551165, upload-time = "2026-05-28T12:01:44.648Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/c1/bc479ca069200af730881b1bd525e3114b2b391a351509fcb1b772f28086/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_i686.whl", hash = "sha256:42d0f20e85e549c870749d0e247f0c10d318a45b7e9676d575d2dcb04a1b2e66", size = 618778, upload-time = "2026-05-28T12:01:46.337Z" },
+    { url = "https://files.pythonhosted.org/packages/77/65/38ab2f90df44c2febfb63cc10ced40763d9b4bc94d173e734528663fe7f5/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:b1be5c35683684d5331b93600c210e8367c254683d8a6df6bd21bd2da3a334fb", size = 581839, upload-time = "2026-05-28T12:01:48.109Z" },
+    { url = "https://files.pythonhosted.org/packages/15/2d/ce1f605fe036aadd460e5822e578c6c7ec3a860936cca37d6e0f299daa77/rpds_py-2026.5.1-cp315-cp315t-win32.whl", hash = "sha256:75808f6c38ce7749bb68cc2770161aae5045e6c6f6781a9782e74b93304399df", size = 207866, upload-time = "2026-05-28T12:01:49.648Z" },
+    { url = "https://files.pythonhosted.org/packages/79/cb/966040123eb102371559746908ef2c9471f4d43e17ec9a645a2258dab64b/rpds_py-2026.5.1-cp315-cp315t-win_amd64.whl", hash = "sha256:90bd6630002a1c7f09e7843dd79f0d24f3d2897cc25a753480917865d14f15b3", size = 225441, upload-time = "2026-05-28T12:01:51.408Z" },
+    { url = "https://files.pythonhosted.org/packages/42/56/3fe0fb34820ff667be791b3a3c22b85e8bcba54e9c832f47438c191fa7be/rpds_py-2026.5.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:edf2765d84e42447f112ad877af8fe1db0089aaec5b28e88d6eab45e7fe99cea", size = 357151, upload-time = "2026-05-28T12:01:53.43Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/f2/3eb9ccdb9f143b8c9b003978898cb497f942a324c077401e6b8834238e63/rpds_py-2026.5.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ad3773236e95f7f33991eb125224b7da66f206504d032a253a02da7e134519fb", size = 350195, upload-time = "2026-05-28T12:01:54.901Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/24/dbda232bc4f3ed732120692ab0d2c8402cb020516556d8bee622dcef2413/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a04df86b3f0fade39ec8fd0e0aab089b1da9fbd2b48df778a57ef96f5e7d38df", size = 381850, upload-time = "2026-05-28T12:01:56.601Z" },
+    { url = "https://files.pythonhosted.org/packages/40/30/32e769839a358f78810c234f160f2cc21d1e4e47e1c0e0e0d535be5a0219/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6142dbd80c4df62a5d899f0d616d417f84e0bc8d32526c8e5589019d75d028a7", size = 387899, upload-time = "2026-05-28T12:01:58.212Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/86/ec84d243aadb3b34b71dd26a010d0930b2d284ff5fc9a69fec53810ee6fd/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0b35217adefe87f2fe4db7e9766cabe84744bfe9616d9667be18988928c7f2dc", size = 501618, upload-time = "2026-05-28T12:01:59.888Z" },
+    { url = "https://files.pythonhosted.org/packages/74/25/b60e52686bbff777a64f9e4f4d3dd57980dc846913777177a2c92e4937aa/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b95d5e11fc712b752081183a55a244c03cd00570489edd7014d8899f8ceb8162", size = 394003, upload-time = "2026-05-28T12:02:01.482Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/c7/b3a6a588cc2219510ef3f42e207483a93950bedd1e3a0fd4015c95cff9e5/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:141c9498daf2ace9eda35d2b0e376f9ea8b058d84f2aef4f96fccfd449a2f251", size = 379778, upload-time = "2026-05-28T12:02:03.197Z" },
+    { url = "https://files.pythonhosted.org/packages/31/00/c7dba3fc8a3da8cb3f6db1eb3386be4d79c2e97c6890d20eb9ac66ae8c43/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:6f249f8b860a200ad35193af961183ebe9132710484e6f6ce0cf89fd83c63a9a", size = 392359, upload-time = "2026-05-28T12:02:04.817Z" },
+    { url = "https://files.pythonhosted.org/packages/93/dd/472ba494c70753f93745992c99855bee0636daf74e6984e5e003f150316f/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:e4abbf391a70be864920858bf360f4fb380577c9a0f732438a1996726e2c195b", size = 412820, upload-time = "2026-05-28T12:02:06.401Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/6f/93831a3bfe789542ed0c1d0d74b78b440f055d6dc3ea4640eba2d95e6e23/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:c74005a7bb87752acf351c93897ec63ad77a07a0da7ecad9c050e32e7286ba34", size = 557243, upload-time = "2026-05-28T12:02:08.013Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/ff/0b3d604614ffc77522c6b288fdbce68957eb583da1002aa65ba38ac0ee40/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:8213afbe8a3a906fb9acb2014423fe3359ee783d0bf90995f70623a3217bfa6c", size = 623541, upload-time = "2026-05-28T12:02:09.661Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/ea/e7b0251441da9adfeaebcf29601d10f2a1455fcf0772fae9e7e19032bd96/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:8c43a8a973270fd173bf48cdf80bbe66312421cba68d40845034f174f2389049", size = 586326, upload-time = "2026-05-28T12:02:11.47Z" },
+]
+
+[[package]]
+name = "scikit-image"
+version = "0.25.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+dependencies = [
+    { name = "imageio", marker = "python_full_version < '3.11'" },
+    { name = "lazy-loader", marker = "python_full_version < '3.11'" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "packaging", marker = "python_full_version < '3.11'" },
+    { name = "pillow", marker = "python_full_version < '3.11'" },
+    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "tifffile", version = "2025.5.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c7/a8/3c0f256012b93dd2cb6fda9245e9f4bff7dc0486880b248005f15ea2255e/scikit_image-0.25.2.tar.gz", hash = "sha256:e5a37e6cd4d0c018a7a55b9d601357e3382826d3888c10d0213fc63bff977dde", size = 22693594, upload-time = "2025-02-18T18:05:24.538Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/11/cb/016c63f16065c2d333c8ed0337e18a5cdf9bc32d402e4f26b0db362eb0e2/scikit_image-0.25.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:d3278f586793176599df6a4cf48cb6beadae35c31e58dc01a98023af3dc31c78", size = 13988922, upload-time = "2025-02-18T18:04:11.069Z" },
+    { url = "https://files.pythonhosted.org/packages/30/ca/ff4731289cbed63c94a0c9a5b672976603118de78ed21910d9060c82e859/scikit_image-0.25.2-cp310-cp310-macosx_12_0_arm64.whl", hash = "sha256:5c311069899ce757d7dbf1d03e32acb38bb06153236ae77fcd820fd62044c063", size = 13192698, upload-time = "2025-02-18T18:04:15.362Z" },
+    { url = "https://files.pythonhosted.org/packages/39/6d/a2aadb1be6d8e149199bb9b540ccde9e9622826e1ab42fe01de4c35ab918/scikit_image-0.25.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:be455aa7039a6afa54e84f9e38293733a2622b8c2fb3362b822d459cc5605e99", size = 14153634, upload-time = "2025-02-18T18:04:18.496Z" },
+    { url = "https://files.pythonhosted.org/packages/96/08/916e7d9ee4721031b2f625db54b11d8379bd51707afaa3e5a29aecf10bc4/scikit_image-0.25.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a4c464b90e978d137330be433df4e76d92ad3c5f46a22f159520ce0fdbea8a09", size = 14767545, upload-time = "2025-02-18T18:04:22.556Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/ee/c53a009e3997dda9d285402f19226fbd17b5b3cb215da391c4ed084a1424/scikit_image-0.25.2-cp310-cp310-win_amd64.whl", hash = "sha256:60516257c5a2d2f74387c502aa2f15a0ef3498fbeaa749f730ab18f0a40fd054", size = 12812908, upload-time = "2025-02-18T18:04:26.364Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/97/3051c68b782ee3f1fb7f8f5bb7d535cf8cb92e8aae18fa9c1cdf7e15150d/scikit_image-0.25.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f4bac9196fb80d37567316581c6060763b0f4893d3aca34a9ede3825bc035b17", size = 14003057, upload-time = "2025-02-18T18:04:30.395Z" },
+    { url = "https://files.pythonhosted.org/packages/19/23/257fc696c562639826065514d551b7b9b969520bd902c3a8e2fcff5b9e17/scikit_image-0.25.2-cp311-cp311-macosx_12_0_arm64.whl", hash = "sha256:d989d64ff92e0c6c0f2018c7495a5b20e2451839299a018e0e5108b2680f71e0", size = 13180335, upload-time = "2025-02-18T18:04:33.449Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/14/0c4a02cb27ca8b1e836886b9ec7c9149de03053650e9e2ed0625f248dd92/scikit_image-0.25.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b2cfc96b27afe9a05bc92f8c6235321d3a66499995675b27415e0d0c76625173", size = 14144783, upload-time = "2025-02-18T18:04:36.594Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/9b/9fb556463a34d9842491d72a421942c8baff4281025859c84fcdb5e7e602/scikit_image-0.25.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:24cc986e1f4187a12aa319f777b36008764e856e5013666a4a83f8df083c2641", size = 14785376, upload-time = "2025-02-18T18:04:39.856Z" },
+    { url = "https://files.pythonhosted.org/packages/de/ec/b57c500ee85885df5f2188f8bb70398481393a69de44a00d6f1d055f103c/scikit_image-0.25.2-cp311-cp311-win_amd64.whl", hash = "sha256:b4f6b61fc2db6340696afe3db6b26e0356911529f5f6aee8c322aa5157490c9b", size = 12791698, upload-time = "2025-02-18T18:04:42.868Z" },
+    { url = "https://files.pythonhosted.org/packages/35/8c/5df82881284459f6eec796a5ac2a0a304bb3384eec2e73f35cfdfcfbf20c/scikit_image-0.25.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:8db8dd03663112783221bf01ccfc9512d1cc50ac9b5b0fe8f4023967564719fb", size = 13986000, upload-time = "2025-02-18T18:04:47.156Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/e6/93bebe1abcdce9513ffec01d8af02528b4c41fb3c1e46336d70b9ed4ef0d/scikit_image-0.25.2-cp312-cp312-macosx_12_0_arm64.whl", hash = "sha256:483bd8cc10c3d8a7a37fae36dfa5b21e239bd4ee121d91cad1f81bba10cfb0ed", size = 13235893, upload-time = "2025-02-18T18:04:51.049Z" },
+    { url = "https://files.pythonhosted.org/packages/53/4b/eda616e33f67129e5979a9eb33c710013caa3aa8a921991e6cc0b22cea33/scikit_image-0.25.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9d1e80107bcf2bf1291acfc0bf0425dceb8890abe9f38d8e94e23497cbf7ee0d", size = 14178389, upload-time = "2025-02-18T18:04:54.245Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/b5/b75527c0f9532dd8a93e8e7cd8e62e547b9f207d4c11e24f0006e8646b36/scikit_image-0.25.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a17e17eb8562660cc0d31bb55643a4da996a81944b82c54805c91b3fe66f4824", size = 15003435, upload-time = "2025-02-18T18:04:57.586Z" },
+    { url = "https://files.pythonhosted.org/packages/34/e3/49beb08ebccda3c21e871b607c1cb2f258c3fa0d2f609fed0a5ba741b92d/scikit_image-0.25.2-cp312-cp312-win_amd64.whl", hash = "sha256:bdd2b8c1de0849964dbc54037f36b4e9420157e67e45a8709a80d727f52c7da2", size = 12899474, upload-time = "2025-02-18T18:05:01.166Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/7c/9814dd1c637f7a0e44342985a76f95a55dd04be60154247679fd96c7169f/scikit_image-0.25.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:7efa888130f6c548ec0439b1a7ed7295bc10105458a421e9bf739b457730b6da", size = 13921841, upload-time = "2025-02-18T18:05:03.963Z" },
+    { url = "https://files.pythonhosted.org/packages/84/06/66a2e7661d6f526740c309e9717d3bd07b473661d5cdddef4dd978edab25/scikit_image-0.25.2-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:dd8011efe69c3641920614d550f5505f83658fe33581e49bed86feab43a180fc", size = 13196862, upload-time = "2025-02-18T18:05:06.986Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/63/3368902ed79305f74c2ca8c297dfeb4307269cbe6402412668e322837143/scikit_image-0.25.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:28182a9d3e2ce3c2e251383bdda68f8d88d9fff1a3ebe1eb61206595c9773341", size = 14117785, upload-time = "2025-02-18T18:05:10.69Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/9b/c3da56a145f52cd61a68b8465d6a29d9503bc45bc993bb45e84371c97d94/scikit_image-0.25.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b8abd3c805ce6944b941cfed0406d88faeb19bab3ed3d4b50187af55cf24d147", size = 14977119, upload-time = "2025-02-18T18:05:13.871Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/97/5fcf332e1753831abb99a2525180d3fb0d70918d461ebda9873f66dcc12f/scikit_image-0.25.2-cp313-cp313-win_amd64.whl", hash = "sha256:64785a8acefee460ec49a354706db0b09d1f325674107d7fa3eadb663fb56d6f", size = 12885116, upload-time = "2025-02-18T18:05:17.844Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cc/75e9f17e3670b5ed93c32456fda823333c6279b144cd93e2c03aa06aa472/scikit_image-0.25.2-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:330d061bd107d12f8d68f1d611ae27b3b813b8cdb0300a71d07b1379178dd4cd", size = 13862801, upload-time = "2025-02-18T18:05:20.783Z" },
+]
+
+[[package]]
+name = "scikit-image"
+version = "0.26.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+dependencies = [
+    { name = "imageio", marker = "python_full_version >= '3.11'" },
+    { name = "lazy-loader", marker = "python_full_version >= '3.11'" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "packaging", marker = "python_full_version >= '3.11'" },
+    { name = "pillow", marker = "python_full_version >= '3.11'" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "tifffile", version = "2026.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+    { name = "tifffile", version = "2026.5.15", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a1/b4/2528bb43c67d48053a7a649a9666432dc307d66ba02e3a6d5c40f46655df/scikit_image-0.26.0.tar.gz", hash = "sha256:f5f970ab04efad85c24714321fcc91613fcb64ef2a892a13167df2f3e59199fa", size = 22729739, upload-time = "2025-12-20T17:12:21.824Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/76/16/8a407688b607f86f81f8c649bf0d68a2a6d67375f18c2d660aba20f5b648/scikit_image-0.26.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:b1ede33a0fb3731457eaf53af6361e73dd510f449dac437ab54573b26788baf0", size = 12355510, upload-time = "2025-12-20T17:10:31.628Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/f9/7efc088ececb6f6868fd4475e16cfafc11f242ce9ab5fc3557d78b5da0d4/scikit_image-0.26.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7af7aa331c6846bd03fa28b164c18d0c3fd419dbb888fb05e958ac4257a78fdd", size = 12056334, upload-time = "2025-12-20T17:10:34.559Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/1e/bc7fb91fb5ff65ef42346c8b7ee8b09b04eabf89235ab7dbfdfd96cbd1ea/scikit_image-0.26.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9ea6207d9e9d21c3f464efe733121c0504e494dbdc7728649ff3e23c3c5a4953", size = 13297768, upload-time = "2025-12-20T17:10:37.733Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/2a/e71c1a7d90e70da67b88ccc609bd6ae54798d5847369b15d3a8052232f9d/scikit_image-0.26.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:74aa5518ccea28121f57a95374581d3b979839adc25bb03f289b1bc9b99c58af", size = 13711217, upload-time = "2025-12-20T17:10:40.935Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/59/9637ee12c23726266b91296791465218973ce1ad3e4c56fc81e4d8e7d6e1/scikit_image-0.26.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d5c244656de905e195a904e36dbc18585e06ecf67d90f0482cbde63d7f9ad59d", size = 14337782, upload-time = "2025-12-20T17:10:43.452Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/5c/a3e1e0860f9294663f540c117e4bf83d55e5b47c281d475cc06227e88411/scikit_image-0.26.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:21a818ee6ca2f2131b9e04d8eb7637b5c18773ebe7b399ad23dcc5afaa226d2d", size = 14805997, upload-time = "2025-12-20T17:10:45.93Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/c6/2eeacf173da041a9e388975f54e5c49df750757fcfc3ee293cdbbae1ea0a/scikit_image-0.26.0-cp311-cp311-win_amd64.whl", hash = "sha256:9490360c8d3f9a7e85c8de87daf7c0c66507960cf4947bb9610d1751928721c7", size = 11878486, upload-time = "2025-12-20T17:10:48.246Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/a4/a852c4949b9058d585e762a66bf7e9a2cd3be4795cd940413dfbfbb0ce79/scikit_image-0.26.0-cp311-cp311-win_arm64.whl", hash = "sha256:0baa0108d2d027f34d748e84e592b78acc23e965a5de0e4bb03cf371de5c0581", size = 11346518, upload-time = "2025-12-20T17:10:50.575Z" },
+    { url = "https://files.pythonhosted.org/packages/99/e8/e13757982264b33a1621628f86b587e9a73a13f5256dad49b19ba7dc9083/scikit_image-0.26.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d454b93a6fa770ac5ae2d33570f8e7a321bb80d29511ce4b6b78058ebe176e8c", size = 12376452, upload-time = "2025-12-20T17:10:52.796Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/be/f8dd17d0510f9911f9f17ba301f7455328bf13dae416560126d428de9568/scikit_image-0.26.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:3409e89d66eff5734cd2b672d1c48d2759360057e714e1d92a11df82c87cba37", size = 12061567, upload-time = "2025-12-20T17:10:55.207Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/2b/c70120a6880579fb42b91567ad79feb4772f7be72e8d52fec403a3dde0c6/scikit_image-0.26.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4c717490cec9e276afb0438dd165b7c3072d6c416709cc0f9f5a4c1070d23a44", size = 13084214, upload-time = "2025-12-20T17:10:57.468Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/a2/70401a107d6d7466d64b466927e6b96fcefa99d57494b972608e2f8be50f/scikit_image-0.26.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7df650e79031634ac90b11e64a9eedaf5a5e06fcd09bcd03a34be01745744466", size = 13561683, upload-time = "2025-12-20T17:10:59.49Z" },
+    { url = "https://files.pythonhosted.org/packages/13/a5/48bdfd92794c5002d664e0910a349d0a1504671ef5ad358150f21643c79a/scikit_image-0.26.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:cefd85033e66d4ea35b525bb0937d7f42d4cdcfed2d1888e1570d5ce450d3932", size = 14112147, upload-time = "2025-12-20T17:11:02.083Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/b5/ac71694da92f5def5953ca99f18a10fe98eac2dd0a34079389b70b4d0394/scikit_image-0.26.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:3f5bf622d7c0435884e1e141ebbe4b2804e16b2dd23ae4c6183e2ea99233be70", size = 14661625, upload-time = "2025-12-20T17:11:04.528Z" },
+    { url = "https://files.pythonhosted.org/packages/23/4d/a3cc1e96f080e253dad2251bfae7587cf2b7912bcd76fd43fd366ff35a87/scikit_image-0.26.0-cp312-cp312-win_amd64.whl", hash = "sha256:abed017474593cd3056ae0fe948d07d0747b27a085e92df5474f4955dd65aec0", size = 11911059, upload-time = "2025-12-20T17:11:06.61Z" },
+    { url = "https://files.pythonhosted.org/packages/35/8a/d1b8055f584acc937478abf4550d122936f420352422a1a625eef2c605d8/scikit_image-0.26.0-cp312-cp312-win_arm64.whl", hash = "sha256:4d57e39ef67a95d26860c8caf9b14b8fb130f83b34c6656a77f191fa6d1d04d8", size = 11348740, upload-time = "2025-12-20T17:11:09.118Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/48/02357ffb2cca35640f33f2cfe054a4d6d5d7a229b88880a64f1e45c11f4e/scikit_image-0.26.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:a2e852eccf41d2d322b8e60144e124802873a92b8d43a6f96331aa42888491c7", size = 12346329, upload-time = "2025-12-20T17:11:11.599Z" },
+    { url = "https://files.pythonhosted.org/packages/67/b9/b792c577cea2c1e94cda83b135a656924fc57c428e8a6d302cd69aac1b60/scikit_image-0.26.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:98329aab3bc87db352b9887f64ce8cdb8e75f7c2daa19927f2e121b797b678d5", size = 12031726, upload-time = "2025-12-20T17:11:13.871Z" },
+    { url = "https://files.pythonhosted.org/packages/07/a9/9564250dfd65cb20404a611016db52afc6268b2b371cd19c7538ea47580f/scikit_image-0.26.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:915bb3ba66455cf8adac00dc8fdf18a4cd29656aec7ddd38cb4dda90289a6f21", size = 13094910, upload-time = "2025-12-20T17:11:16.2Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/b8/0d8eeb5a9fd7d34ba84f8a55753a0a3e2b5b51b2a5a0ade648a8db4a62f7/scikit_image-0.26.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b36ab5e778bf50af5ff386c3ac508027dc3aaeccf2161bdf96bde6848f44d21b", size = 13660939, upload-time = "2025-12-20T17:11:18.464Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/d6/91d8973584d4793d4c1a847d388e34ef1218d835eeddecfc9108d735b467/scikit_image-0.26.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:09bad6a5d5949c7896c8347424c4cca899f1d11668030e5548813ab9c2865dcb", size = 14138938, upload-time = "2025-12-20T17:11:20.919Z" },
+    { url = "https://files.pythonhosted.org/packages/39/9a/7e15d8dc10d6bbf212195fb39bdeb7f226c46dd53f9c63c312e111e2e175/scikit_image-0.26.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:aeb14db1ed09ad4bee4ceb9e635547a8d5f3549be67fc6c768c7f923e027e6cd", size = 14752243, upload-time = "2025-12-20T17:11:23.347Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/58/2b11b933097bc427e42b4a8b15f7de8f24f2bac1fd2779d2aea1431b2c31/scikit_image-0.26.0-cp313-cp313-win_amd64.whl", hash = "sha256:ac529eb9dbd5954f9aaa2e3fe9a3fd9661bfe24e134c688587d811a0233127f1", size = 11906770, upload-time = "2025-12-20T17:11:25.297Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/ec/96941474a18a04b69b6f6562a5bd79bd68049fa3728d3b350976eccb8b93/scikit_image-0.26.0-cp313-cp313-win_arm64.whl", hash = "sha256:a2d211bc355f59725efdcae699b93b30348a19416cc9e017f7b2fb599faf7219", size = 11342506, upload-time = "2025-12-20T17:11:27.399Z" },
+    { url = "https://files.pythonhosted.org/packages/03/e5/c1a9962b0cf1952f42d32b4a2e48eed520320dbc4d2ff0b981c6fa508b6b/scikit_image-0.26.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:9eefb4adad066da408a7601c4c24b07af3b472d90e08c3e7483d4e9e829d8c49", size = 12663278, upload-time = "2025-12-20T17:11:29.358Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/97/c1a276a59ce8e4e24482d65c1a3940d69c6b3873279193b7ebd04e5ee56b/scikit_image-0.26.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:6caec76e16c970c528d15d1c757363334d5cb3069f9cea93d2bead31820511f3", size = 12405142, upload-time = "2025-12-20T17:11:31.282Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/4a/f1cbd1357caef6c7993f7efd514d6e53d8fd6f7fe01c4714d51614c53289/scikit_image-0.26.0-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a07200fe09b9d99fcdab959859fe0f7db8df6333d6204344425d476850ce3604", size = 12942086, upload-time = "2025-12-20T17:11:33.683Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/6f/74d9fb87c5655bd64cf00b0c44dc3d6206d9002e5f6ba1c9aeb13236f6bf/scikit_image-0.26.0-cp313-cp313t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:92242351bccf391fc5df2d1529d15470019496d2498d615beb68da85fe7fdf37", size = 13265667, upload-time = "2025-12-20T17:11:36.11Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/73/faddc2413ae98d863f6fa2e3e14da4467dd38e788e1c23346cf1a2b06b97/scikit_image-0.26.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:52c496f75a7e45844d951557f13c08c81487c6a1da2e3c9c8a39fcde958e02cc", size = 14001966, upload-time = "2025-12-20T17:11:38.55Z" },
+    { url = "https://files.pythonhosted.org/packages/02/94/9f46966fa042b5d57c8cd641045372b4e0df0047dd400e77ea9952674110/scikit_image-0.26.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:20ef4a155e2e78b8ab973998e04d8a361d49d719e65412405f4dadd9155a61d9", size = 14359526, upload-time = "2025-12-20T17:11:41.087Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/b4/2840fe38f10057f40b1c9f8fb98a187a370936bf144a4ac23452c5ef1baf/scikit_image-0.26.0-cp313-cp313t-win_amd64.whl", hash = "sha256:c9087cf7d0e7f33ab5c46d2068d86d785e70b05400a891f73a13400f1e1faf6a", size = 12287629, upload-time = "2025-12-20T17:11:43.11Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ba/73b6ca70796e71f83ab222690e35a79612f0117e5aaf167151b7d46f5f2c/scikit_image-0.26.0-cp313-cp313t-win_arm64.whl", hash = "sha256:27d58bc8b2acd351f972c6508c1b557cfed80299826080a4d803dd29c51b707e", size = 11647755, upload-time = "2025-12-20T17:11:45.279Z" },
+    { url = "https://files.pythonhosted.org/packages/51/44/6b744f92b37ae2833fd423cce8f806d2368859ec325a699dc30389e090b9/scikit_image-0.26.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:63af3d3a26125f796f01052052f86806da5b5e54c6abef152edb752683075a9c", size = 12365810, upload-time = "2025-12-20T17:11:47.357Z" },
+    { url = "https://files.pythonhosted.org/packages/40/f5/83590d9355191f86ac663420fec741b82cc547a4afe7c4c1d986bf46e4db/scikit_image-0.26.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ce00600cd70d4562ed59f80523e18cdcc1fae0e10676498a01f73c255774aefd", size = 12075717, upload-time = "2025-12-20T17:11:49.483Z" },
+    { url = "https://files.pythonhosted.org/packages/72/48/253e7cf5aee6190459fe136c614e2cbccc562deceb4af96e0863f1b8ee29/scikit_image-0.26.0-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6381edf972b32e4f54085449afde64365a57316637496c1325a736987083e2ab", size = 13161520, upload-time = "2025-12-20T17:11:51.58Z" },
+    { url = "https://files.pythonhosted.org/packages/73/c3/cec6a3cbaadfdcc02bd6ff02f3abfe09eaa7f4d4e0a525a1e3a3f4bce49c/scikit_image-0.26.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c6624a76c6085218248154cc7e1500e6b488edcd9499004dd0d35040607d7505", size = 13684340, upload-time = "2025-12-20T17:11:53.708Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/0d/39a776f675d24164b3a267aa0db9f677a4cb20127660d8bf4fd7fef66817/scikit_image-0.26.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f775f0e420faac9c2aa6757135f4eb468fb7b70e0b67fa77a5e79be3c30ee331", size = 14203839, upload-time = "2025-12-20T17:11:55.89Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/25/2514df226bbcedfe9b2caafa1ba7bc87231a0c339066981b182b08340e06/scikit_image-0.26.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede4d6d255cc5da9faeb2f9ba7fedbc990abbc652db429f40a16b22e770bb578", size = 14770021, upload-time = "2025-12-20T17:11:58.014Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/5b/0671dc91c0c79340c3fe202f0549c7d3681eb7640fe34ab68a5f090a7c7f/scikit_image-0.26.0-cp314-cp314-win_amd64.whl", hash = "sha256:0660b83968c15293fd9135e8d860053ee19500d52bf55ca4fb09de595a1af650", size = 12023490, upload-time = "2025-12-20T17:12:00.013Z" },
+    { url = "https://files.pythonhosted.org/packages/65/08/7c4cb59f91721f3de07719085212a0b3962e3e3f2d1818cbac4eeb1ea53e/scikit_image-0.26.0-cp314-cp314-win_arm64.whl", hash = "sha256:b8d14d3181c21c11170477a42542c1addc7072a90b986675a71266ad17abc37f", size = 11473782, upload-time = "2025-12-20T17:12:01.983Z" },
+    { url = "https://files.pythonhosted.org/packages/49/41/65c4258137acef3d73cb561ac55512eacd7b30bb4f4a11474cad526bc5db/scikit_image-0.26.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:cde0bbd57e6795eba83cb10f71a677f7239271121dc950bc060482834a668ad1", size = 12686060, upload-time = "2025-12-20T17:12:03.886Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/32/76971f8727b87f1420a962406388a50e26667c31756126444baf6668f559/scikit_image-0.26.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:163e9afb5b879562b9aeda0dd45208a35316f26cc7a3aed54fd601604e5cf46f", size = 12422628, upload-time = "2025-12-20T17:12:05.921Z" },
+    { url = "https://files.pythonhosted.org/packages/37/0d/996febd39f757c40ee7b01cdb861867327e5c8e5f595a634e8201462d958/scikit_image-0.26.0-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:724f79fd9b6cb6f4a37864fe09f81f9f5d5b9646b6868109e1b100d1a7019e59", size = 12962369, upload-time = "2025-12-20T17:12:07.912Z" },
+    { url = "https://files.pythonhosted.org/packages/48/b4/612d354f946c9600e7dea012723c11d47e8d455384e530f6daaaeb9bf62c/scikit_image-0.26.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3268f13310e6857508bd87202620df996199a016a1d281b309441d227c822394", size = 13272431, upload-time = "2025-12-20T17:12:10.255Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/6e/26c00b466e06055a086de2c6e2145fe189ccdc9a1d11ccc7de020f2591ad/scikit_image-0.26.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fac96a1f9b06cd771cbbb3cd96c5332f36d4efd839b1d8b053f79e5887acde62", size = 14016362, upload-time = "2025-12-20T17:12:12.793Z" },
+    { url = "https://files.pythonhosted.org/packages/47/88/00a90402e1775634043c2a0af8a3c76ad450866d9fa444efcc43b553ba2d/scikit_image-0.26.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2c1e7bd342f43e7a97e571b3f03ba4c1293ea1a35c3f13f41efdc8a81c1dc8f2", size = 14364151, upload-time = "2025-12-20T17:12:14.909Z" },
+    { url = "https://files.pythonhosted.org/packages/da/ca/918d8d306bd43beacff3b835c6d96fac0ae64c0857092f068b88db531a7c/scikit_image-0.26.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b702c3bb115e1dcf4abf5297429b5c90f2189655888cbed14921f3d26f81d3a4", size = 12413484, upload-time = "2025-12-20T17:12:17.046Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/cd/4da01329b5a8d47ff7ec3c99a2b02465a8017b186027590dc7425cee0b56/scikit_image-0.26.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0608aa4a9ec39e0843de10d60edb2785a30c1c47819b67866dd223ebd149acaf", size = 11769501, upload-time = "2025-12-20T17:12:19.339Z" },
+]
+
+[[package]]
+name = "scipy"
+version = "1.15.3"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0f/37/6964b830433e654ec7485e45a00fc9a27cf868d622838f6b6d9c5ec0d532/scipy-1.15.3.tar.gz", hash = "sha256:eae3cf522bc7df64b42cad3925c876e1b0b6c35c1337c93e12c0f366f55b0eaf", size = 59419214, upload-time = "2025-05-08T16:13:05.955Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/2f/4966032c5f8cc7e6a60f1b2e0ad686293b9474b65246b0c642e3ef3badd0/scipy-1.15.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:a345928c86d535060c9c2b25e71e87c39ab2f22fc96e9636bd74d1dbf9de448c", size = 38702770, upload-time = "2025-05-08T16:04:20.849Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/6e/0c3bf90fae0e910c274db43304ebe25a6b391327f3f10b5dcc638c090795/scipy-1.15.3-cp310-cp310-macosx_12_0_arm64.whl", hash = "sha256:ad3432cb0f9ed87477a8d97f03b763fd1d57709f1bbde3c9369b1dff5503b253", size = 30094511, upload-time = "2025-05-08T16:04:27.103Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/b1/4deb37252311c1acff7f101f6453f0440794f51b6eacb1aad4459a134081/scipy-1.15.3-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:aef683a9ae6eb00728a542b796f52a5477b78252edede72b8327a886ab63293f", size = 22368151, upload-time = "2025-05-08T16:04:31.731Z" },
+    { url = "https://files.pythonhosted.org/packages/38/7d/f457626e3cd3c29b3a49ca115a304cebb8cc6f31b04678f03b216899d3c6/scipy-1.15.3-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:1c832e1bd78dea67d5c16f786681b28dd695a8cb1fb90af2e27580d3d0967e92", size = 25121732, upload-time = "2025-05-08T16:04:36.596Z" },
+    { url = "https://files.pythonhosted.org/packages/db/0a/92b1de4a7adc7a15dcf5bddc6e191f6f29ee663b30511ce20467ef9b82e4/scipy-1.15.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:263961f658ce2165bbd7b99fa5135195c3a12d9bef045345016b8b50c315cb82", size = 35547617, upload-time = "2025-05-08T16:04:43.546Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/6d/41991e503e51fc1134502694c5fa7a1671501a17ffa12716a4a9151af3df/scipy-1.15.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9e2abc762b0811e09a0d3258abee2d98e0c703eee49464ce0069590846f31d40", size = 37662964, upload-time = "2025-05-08T16:04:49.431Z" },
+    { url = "https://files.pythonhosted.org/packages/25/e1/3df8f83cb15f3500478c889be8fb18700813b95e9e087328230b98d547ff/scipy-1.15.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:ed7284b21a7a0c8f1b6e5977ac05396c0d008b89e05498c8b7e8f4a1423bba0e", size = 37238749, upload-time = "2025-05-08T16:04:55.215Z" },
+    { url = "https://files.pythonhosted.org/packages/93/3e/b3257cf446f2a3533ed7809757039016b74cd6f38271de91682aa844cfc5/scipy-1.15.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5380741e53df2c566f4d234b100a484b420af85deb39ea35a1cc1be84ff53a5c", size = 40022383, upload-time = "2025-05-08T16:05:01.914Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/84/55bc4881973d3f79b479a5a2e2df61c8c9a04fcb986a213ac9c02cfb659b/scipy-1.15.3-cp310-cp310-win_amd64.whl", hash = "sha256:9d61e97b186a57350f6d6fd72640f9e99d5a4a2b8fbf4b9ee9a841eab327dc13", size = 41259201, upload-time = "2025-05-08T16:05:08.166Z" },
+    { url = "https://files.pythonhosted.org/packages/96/ab/5cc9f80f28f6a7dff646c5756e559823614a42b1939d86dd0ed550470210/scipy-1.15.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:993439ce220d25e3696d1b23b233dd010169b62f6456488567e830654ee37a6b", size = 38714255, upload-time = "2025-05-08T16:05:14.596Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/4a/66ba30abe5ad1a3ad15bfb0b59d22174012e8056ff448cb1644deccbfed2/scipy-1.15.3-cp311-cp311-macosx_12_0_arm64.whl", hash = "sha256:34716e281f181a02341ddeaad584205bd2fd3c242063bd3423d61ac259ca7eba", size = 30111035, upload-time = "2025-05-08T16:05:20.152Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/fa/a7e5b95afd80d24313307f03624acc65801846fa75599034f8ceb9e2cbf6/scipy-1.15.3-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:3b0334816afb8b91dab859281b1b9786934392aa3d527cd847e41bb6f45bee65", size = 22384499, upload-time = "2025-05-08T16:05:24.494Z" },
+    { url = "https://files.pythonhosted.org/packages/17/99/f3aaddccf3588bb4aea70ba35328c204cadd89517a1612ecfda5b2dd9d7a/scipy-1.15.3-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:6db907c7368e3092e24919b5e31c76998b0ce1684d51a90943cb0ed1b4ffd6c1", size = 25152602, upload-time = "2025-05-08T16:05:29.313Z" },
+    { url = "https://files.pythonhosted.org/packages/56/c5/1032cdb565f146109212153339f9cb8b993701e9fe56b1c97699eee12586/scipy-1.15.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:721d6b4ef5dc82ca8968c25b111e307083d7ca9091bc38163fb89243e85e3889", size = 35503415, upload-time = "2025-05-08T16:05:34.699Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/37/89f19c8c05505d0601ed5650156e50eb881ae3918786c8fd7262b4ee66d3/scipy-1.15.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:39cb9c62e471b1bb3750066ecc3a3f3052b37751c7c3dfd0fd7e48900ed52982", size = 37652622, upload-time = "2025-05-08T16:05:40.762Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/31/be59513aa9695519b18e1851bb9e487de66f2d31f835201f1b42f5d4d475/scipy-1.15.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:795c46999bae845966368a3c013e0e00947932d68e235702b5c3f6ea799aa8c9", size = 37244796, upload-time = "2025-05-08T16:05:48.119Z" },
+    { url = "https://files.pythonhosted.org/packages/10/c0/4f5f3eeccc235632aab79b27a74a9130c6c35df358129f7ac8b29f562ac7/scipy-1.15.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:18aaacb735ab38b38db42cb01f6b92a2d0d4b6aabefeb07f02849e47f8fb3594", size = 40047684, upload-time = "2025-05-08T16:05:54.22Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/a7/0ddaf514ce8a8714f6ed243a2b391b41dbb65251affe21ee3077ec45ea9a/scipy-1.15.3-cp311-cp311-win_amd64.whl", hash = "sha256:ae48a786a28412d744c62fd7816a4118ef97e5be0bee968ce8f0a2fba7acf3bb", size = 41246504, upload-time = "2025-05-08T16:06:00.437Z" },
+    { url = "https://files.pythonhosted.org/packages/37/4b/683aa044c4162e10ed7a7ea30527f2cbd92e6999c10a8ed8edb253836e9c/scipy-1.15.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6ac6310fdbfb7aa6612408bd2f07295bcbd3fda00d2d702178434751fe48e019", size = 38766735, upload-time = "2025-05-08T16:06:06.471Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/7e/f30be3d03de07f25dc0ec926d1681fed5c732d759ac8f51079708c79e680/scipy-1.15.3-cp312-cp312-macosx_12_0_arm64.whl", hash = "sha256:185cd3d6d05ca4b44a8f1595af87f9c372bb6acf9c808e99aa3e9aa03bd98cf6", size = 30173284, upload-time = "2025-05-08T16:06:11.686Z" },
+    { url = "https://files.pythonhosted.org/packages/07/9c/0ddb0d0abdabe0d181c1793db51f02cd59e4901da6f9f7848e1f96759f0d/scipy-1.15.3-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:05dc6abcd105e1a29f95eada46d4a3f251743cfd7d3ae8ddb4088047f24ea477", size = 22446958, upload-time = "2025-05-08T16:06:15.97Z" },
+    { url = "https://files.pythonhosted.org/packages/af/43/0bce905a965f36c58ff80d8bea33f1f9351b05fad4beaad4eae34699b7a1/scipy-1.15.3-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:06efcba926324df1696931a57a176c80848ccd67ce6ad020c810736bfd58eb1c", size = 25242454, upload-time = "2025-05-08T16:06:20.394Z" },
+    { url = "https://files.pythonhosted.org/packages/56/30/a6f08f84ee5b7b28b4c597aca4cbe545535c39fe911845a96414700b64ba/scipy-1.15.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c05045d8b9bfd807ee1b9f38761993297b10b245f012b11b13b91ba8945f7e45", size = 35210199, upload-time = "2025-05-08T16:06:26.159Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/1f/03f52c282437a168ee2c7c14a1a0d0781a9a4a8962d84ac05c06b4c5b555/scipy-1.15.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:271e3713e645149ea5ea3e97b57fdab61ce61333f97cfae392c28ba786f9bb49", size = 37309455, upload-time = "2025-05-08T16:06:32.778Z" },
+    { url = "https://files.pythonhosted.org/packages/89/b1/fbb53137f42c4bf630b1ffdfc2151a62d1d1b903b249f030d2b1c0280af8/scipy-1.15.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6cfd56fc1a8e53f6e89ba3a7a7251f7396412d655bca2aa5611c8ec9a6784a1e", size = 36885140, upload-time = "2025-05-08T16:06:39.249Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/2e/025e39e339f5090df1ff266d021892694dbb7e63568edcfe43f892fa381d/scipy-1.15.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:0ff17c0bb1cb32952c09217d8d1eed9b53d1463e5f1dd6052c7857f83127d539", size = 39710549, upload-time = "2025-05-08T16:06:45.729Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/eb/3bf6ea8ab7f1503dca3a10df2e4b9c3f6b3316df07f6c0ded94b281c7101/scipy-1.15.3-cp312-cp312-win_amd64.whl", hash = "sha256:52092bc0472cfd17df49ff17e70624345efece4e1a12b23783a1ac59a1b728ed", size = 40966184, upload-time = "2025-05-08T16:06:52.623Z" },
+    { url = "https://files.pythonhosted.org/packages/73/18/ec27848c9baae6e0d6573eda6e01a602e5649ee72c27c3a8aad673ebecfd/scipy-1.15.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:2c620736bcc334782e24d173c0fdbb7590a0a436d2fdf39310a8902505008759", size = 38728256, upload-time = "2025-05-08T16:06:58.696Z" },
+    { url = "https://files.pythonhosted.org/packages/74/cd/1aef2184948728b4b6e21267d53b3339762c285a46a274ebb7863c9e4742/scipy-1.15.3-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:7e11270a000969409d37ed399585ee530b9ef6aa99d50c019de4cb01e8e54e62", size = 30109540, upload-time = "2025-05-08T16:07:04.209Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/d8/59e452c0a255ec352bd0a833537a3bc1bfb679944c4938ab375b0a6b3a3e/scipy-1.15.3-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:8c9ed3ba2c8a2ce098163a9bdb26f891746d02136995df25227a20e71c396ebb", size = 22383115, upload-time = "2025-05-08T16:07:08.998Z" },
+    { url = "https://files.pythonhosted.org/packages/08/f5/456f56bbbfccf696263b47095291040655e3cbaf05d063bdc7c7517f32ac/scipy-1.15.3-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:0bdd905264c0c9cfa74a4772cdb2070171790381a5c4d312c973382fc6eaf730", size = 25163884, upload-time = "2025-05-08T16:07:14.091Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/66/a9618b6a435a0f0c0b8a6d0a2efb32d4ec5a85f023c2b79d39512040355b/scipy-1.15.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:79167bba085c31f38603e11a267d862957cbb3ce018d8b38f79ac043bc92d825", size = 35174018, upload-time = "2025-05-08T16:07:19.427Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/09/c5b6734a50ad4882432b6bb7c02baf757f5b2f256041da5df242e2d7e6b6/scipy-1.15.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c9deabd6d547aee2c9a81dee6cc96c6d7e9a9b1953f74850c179f91fdc729cb7", size = 37269716, upload-time = "2025-05-08T16:07:25.712Z" },
+    { url = "https://files.pythonhosted.org/packages/77/0a/eac00ff741f23bcabd352731ed9b8995a0a60ef57f5fd788d611d43d69a1/scipy-1.15.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:dde4fc32993071ac0c7dd2d82569e544f0bdaff66269cb475e0f369adad13f11", size = 36872342, upload-time = "2025-05-08T16:07:31.468Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/54/4379be86dd74b6ad81551689107360d9a3e18f24d20767a2d5b9253a3f0a/scipy-1.15.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:f77f853d584e72e874d87357ad70f44b437331507d1c311457bed8ed2b956126", size = 39670869, upload-time = "2025-05-08T16:07:38.002Z" },
+    { url = "https://files.pythonhosted.org/packages/87/2e/892ad2862ba54f084ffe8cc4a22667eaf9c2bcec6d2bff1d15713c6c0703/scipy-1.15.3-cp313-cp313-win_amd64.whl", hash = "sha256:b90ab29d0c37ec9bf55424c064312930ca5f4bde15ee8619ee44e69319aab163", size = 40988851, upload-time = "2025-05-08T16:08:33.671Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/e9/7a879c137f7e55b30d75d90ce3eb468197646bc7b443ac036ae3fe109055/scipy-1.15.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:3ac07623267feb3ae308487c260ac684b32ea35fd81e12845039952f558047b8", size = 38863011, upload-time = "2025-05-08T16:07:44.039Z" },
+    { url = "https://files.pythonhosted.org/packages/51/d1/226a806bbd69f62ce5ef5f3ffadc35286e9fbc802f606a07eb83bf2359de/scipy-1.15.3-cp313-cp313t-macosx_12_0_arm64.whl", hash = "sha256:6487aa99c2a3d509a5227d9a5e889ff05830a06b2ce08ec30df6d79db5fcd5c5", size = 30266407, upload-time = "2025-05-08T16:07:49.891Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/9b/f32d1d6093ab9eeabbd839b0f7619c62e46cc4b7b6dbf05b6e615bbd4400/scipy-1.15.3-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:50f9e62461c95d933d5c5ef4a1f2ebf9a2b4e83b0db374cb3f1de104d935922e", size = 22540030, upload-time = "2025-05-08T16:07:54.121Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/29/c278f699b095c1a884f29fda126340fcc201461ee8bfea5c8bdb1c7c958b/scipy-1.15.3-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:14ed70039d182f411ffc74789a16df3835e05dc469b898233a245cdfd7f162cb", size = 25218709, upload-time = "2025-05-08T16:07:58.506Z" },
+    { url = "https://files.pythonhosted.org/packages/24/18/9e5374b617aba742a990581373cd6b68a2945d65cc588482749ef2e64467/scipy-1.15.3-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a769105537aa07a69468a0eefcd121be52006db61cdd8cac8a0e68980bbb723", size = 34809045, upload-time = "2025-05-08T16:08:03.929Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/fe/9c4361e7ba2927074360856db6135ef4904d505e9b3afbbcb073c4008328/scipy-1.15.3-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9db984639887e3dffb3928d118145ffe40eff2fa40cb241a306ec57c219ebbbb", size = 36703062, upload-time = "2025-05-08T16:08:09.558Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/8e/038ccfe29d272b30086b25a4960f757f97122cb2ec42e62b460d02fe98e9/scipy-1.15.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:40e54d5c7e7ebf1aa596c374c49fa3135f04648a0caabcb66c52884b943f02b4", size = 36393132, upload-time = "2025-05-08T16:08:15.34Z" },
+    { url = "https://files.pythonhosted.org/packages/10/7e/5c12285452970be5bdbe8352c619250b97ebf7917d7a9a9e96b8a8140f17/scipy-1.15.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:5e721fed53187e71d0ccf382b6bf977644c533e506c4d33c3fb24de89f5c3ed5", size = 38979503, upload-time = "2025-05-08T16:08:21.513Z" },
+    { url = "https://files.pythonhosted.org/packages/81/06/0a5e5349474e1cbc5757975b21bd4fad0e72ebf138c5592f191646154e06/scipy-1.15.3-cp313-cp313t-win_amd64.whl", hash = "sha256:76ad1fb5f8752eabf0fa02e4cc0336b4e8f021e2d5f061ed37d6d264db35e3ca", size = 40308097, upload-time = "2025-05-08T16:08:27.627Z" },
+]
+
+[[package]]
+name = "scipy"
+version = "1.17.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+]
+dependencies = [
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7a/97/5a3609c4f8d58b039179648e62dd220f89864f56f7357f5d4f45c29eb2cc/scipy-1.17.1.tar.gz", hash = "sha256:95d8e012d8cb8816c226aef832200b1d45109ed4464303e997c5b13122b297c0", size = 30573822, upload-time = "2026-02-23T00:26:24.851Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/75/b4ce781849931fef6fd529afa6b63711d5a733065722d0c3e2724af9e40a/scipy-1.17.1-cp311-cp311-macosx_10_14_x86_64.whl", hash = "sha256:1f95b894f13729334fb990162e911c9e5dc1ab390c58aa6cbecb389c5b5e28ec", size = 31613675, upload-time = "2026-02-23T00:16:00.13Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/58/bccc2861b305abdd1b8663d6130c0b3d7cc22e8d86663edbc8401bfd40d4/scipy-1.17.1-cp311-cp311-macosx_12_0_arm64.whl", hash = "sha256:e18f12c6b0bc5a592ed23d3f7b891f68fd7f8241d69b7883769eb5d5dfb52696", size = 28162057, upload-time = "2026-02-23T00:16:09.456Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/ee/18146b7757ed4976276b9c9819108adbc73c5aad636e5353e20746b73069/scipy-1.17.1-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:a3472cfbca0a54177d0faa68f697d8ba4c80bbdc19908c3465556d9f7efce9ee", size = 20334032, upload-time = "2026-02-23T00:16:17.358Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/e6/cef1cf3557f0c54954198554a10016b6a03b2ec9e22a4e1df734936bd99c/scipy-1.17.1-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:766e0dc5a616d026a3a1cffa379af959671729083882f50307e18175797b3dfd", size = 22709533, upload-time = "2026-02-23T00:16:25.791Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/60/8804678875fc59362b0fb759ab3ecce1f09c10a735680318ac30da8cd76b/scipy-1.17.1-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:744b2bf3640d907b79f3fd7874efe432d1cf171ee721243e350f55234b4cec4c", size = 33062057, upload-time = "2026-02-23T00:16:36.931Z" },
+    { url = "https://files.pythonhosted.org/packages/09/7d/af933f0f6e0767995b4e2d705a0665e454d1c19402aa7e895de3951ebb04/scipy-1.17.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43af8d1f3bea642559019edfe64e9b11192a8978efbd1539d7bc2aaa23d92de4", size = 35349300, upload-time = "2026-02-23T00:16:49.108Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/3d/7ccbbdcbb54c8fdc20d3b6930137c782a163fa626f0aef920349873421ba/scipy-1.17.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:cd96a1898c0a47be4520327e01f874acfd61fb48a9420f8aa9f6483412ffa444", size = 35127333, upload-time = "2026-02-23T00:17:01.293Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/19/f926cb11c42b15ba08e3a71e376d816ac08614f769b4f47e06c3580c836a/scipy-1.17.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:4eb6c25dd62ee8d5edf68a8e1c171dd71c292fdae95d8aeb3dd7d7de4c364082", size = 37741314, upload-time = "2026-02-23T00:17:12.576Z" },
+    { url = "https://files.pythonhosted.org/packages/95/da/0d1df507cf574b3f224ccc3d45244c9a1d732c81dcb26b1e8a766ae271a8/scipy-1.17.1-cp311-cp311-win_amd64.whl", hash = "sha256:d30e57c72013c2a4fe441c2fcb8e77b14e152ad48b5464858e07e2ad9fbfceff", size = 36607512, upload-time = "2026-02-23T00:17:23.424Z" },
+    { url = "https://files.pythonhosted.org/packages/68/7f/bdd79ceaad24b671543ffe0ef61ed8e659440eb683b66f033454dcee90eb/scipy-1.17.1-cp311-cp311-win_arm64.whl", hash = "sha256:9ecb4efb1cd6e8c4afea0daa91a87fbddbce1b99d2895d151596716c0b2e859d", size = 24599248, upload-time = "2026-02-23T00:17:34.561Z" },
+    { url = "https://files.pythonhosted.org/packages/35/48/b992b488d6f299dbe3f11a20b24d3dda3d46f1a635ede1c46b5b17a7b163/scipy-1.17.1-cp312-cp312-macosx_10_14_x86_64.whl", hash = "sha256:35c3a56d2ef83efc372eaec584314bd0ef2e2f0d2adb21c55e6ad5b344c0dcb8", size = 31610954, upload-time = "2026-02-23T00:17:49.855Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/02/cf107b01494c19dc100f1d0b7ac3cc08666e96ba2d64db7626066cee895e/scipy-1.17.1-cp312-cp312-macosx_12_0_arm64.whl", hash = "sha256:fcb310ddb270a06114bb64bbe53c94926b943f5b7f0842194d585c65eb4edd76", size = 28172662, upload-time = "2026-02-23T00:18:01.64Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/a9/599c28631bad314d219cf9ffd40e985b24d603fc8a2f4ccc5ae8419a535b/scipy-1.17.1-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:cc90d2e9c7e5c7f1a482c9875007c095c3194b1cfedca3c2f3291cdc2bc7c086", size = 20344366, upload-time = "2026-02-23T00:18:12.015Z" },
+    { url = "https://files.pythonhosted.org/packages/35/f5/906eda513271c8deb5af284e5ef0206d17a96239af79f9fa0aebfe0e36b4/scipy-1.17.1-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:c80be5ede8f3f8eded4eff73cc99a25c388ce98e555b17d31da05287015ffa5b", size = 22704017, upload-time = "2026-02-23T00:18:21.502Z" },
+    { url = "https://files.pythonhosted.org/packages/da/34/16f10e3042d2f1d6b66e0428308ab52224b6a23049cb2f5c1756f713815f/scipy-1.17.1-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e19ebea31758fac5893a2ac360fedd00116cbb7628e650842a6691ba7ca28a21", size = 32927842, upload-time = "2026-02-23T00:18:35.367Z" },
+    { url = "https://files.pythonhosted.org/packages/01/8e/1e35281b8ab6d5d72ebe9911edcdffa3f36b04ed9d51dec6dd140396e220/scipy-1.17.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:02ae3b274fde71c5e92ac4d54bc06c42d80e399fec704383dcd99b301df37458", size = 35235890, upload-time = "2026-02-23T00:18:49.188Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/5c/9d7f4c88bea6e0d5a4f1bc0506a53a00e9fcb198de372bfe4d3652cef482/scipy-1.17.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8a604bae87c6195d8b1045eddece0514d041604b14f2727bbc2b3020172045eb", size = 35003557, upload-time = "2026-02-23T00:18:54.74Z" },
+    { url = "https://files.pythonhosted.org/packages/65/94/7698add8f276dbab7a9de9fb6b0e02fc13ee61d51c7c3f85ac28b65e1239/scipy-1.17.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:f590cd684941912d10becc07325a3eeb77886fe981415660d9265c4c418d0bea", size = 37625856, upload-time = "2026-02-23T00:19:00.307Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/84/dc08d77fbf3d87d3ee27f6a0c6dcce1de5829a64f2eae85a0ecc1f0daa73/scipy-1.17.1-cp312-cp312-win_amd64.whl", hash = "sha256:41b71f4a3a4cab9d366cd9065b288efc4d4f3c0b37a91a8e0947fb5bd7f31d87", size = 36549682, upload-time = "2026-02-23T00:19:07.67Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/98/fe9ae9ffb3b54b62559f52dedaebe204b408db8109a8c66fdd04869e6424/scipy-1.17.1-cp312-cp312-win_arm64.whl", hash = "sha256:f4115102802df98b2b0db3cce5cb9b92572633a1197c77b7553e5203f284a5b3", size = 24547340, upload-time = "2026-02-23T00:19:12.024Z" },
+    { url = "https://files.pythonhosted.org/packages/76/27/07ee1b57b65e92645f219b37148a7e7928b82e2b5dbeccecb4dff7c64f0b/scipy-1.17.1-cp313-cp313-macosx_10_14_x86_64.whl", hash = "sha256:5e3c5c011904115f88a39308379c17f91546f77c1667cea98739fe0fccea804c", size = 31590199, upload-time = "2026-02-23T00:19:17.192Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/ae/db19f8ab842e9b724bf5dbb7db29302a91f1e55bc4d04b1025d6d605a2c5/scipy-1.17.1-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:6fac755ca3d2c3edcb22f479fceaa241704111414831ddd3bc6056e18516892f", size = 28154001, upload-time = "2026-02-23T00:19:22.241Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/58/3ce96251560107b381cbd6e8413c483bbb1228a6b919fa8652b0d4090e7f/scipy-1.17.1-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:7ff200bf9d24f2e4d5dc6ee8c3ac64d739d3a89e2326ba68aaf6c4a2b838fd7d", size = 20325719, upload-time = "2026-02-23T00:19:26.329Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/83/15087d945e0e4d48ce2377498abf5ad171ae013232ae31d06f336e64c999/scipy-1.17.1-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:4b400bdc6f79fa02a4d86640310dde87a21fba0c979efff5248908c6f15fad1b", size = 22683595, upload-time = "2026-02-23T00:19:30.304Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/e0/e58fbde4a1a594c8be8114eb4aac1a55bcd6587047efc18a61eb1f5c0d30/scipy-1.17.1-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2b64ca7d4aee0102a97f3ba22124052b4bd2152522355073580bf4845e2550b6", size = 32896429, upload-time = "2026-02-23T00:19:35.536Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/5f/f17563f28ff03c7b6799c50d01d5d856a1d55f2676f537ca8d28c7f627cd/scipy-1.17.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:581b2264fc0aa555f3f435a5944da7504ea3a065d7029ad60e7c3d1ae09c5464", size = 35203952, upload-time = "2026-02-23T00:19:42.259Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/a5/9afd17de24f657fdfe4df9a3f1ea049b39aef7c06000c13db1530d81ccca/scipy-1.17.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:beeda3d4ae615106d7094f7e7cef6218392e4465cc95d25f900bebabfded0950", size = 34979063, upload-time = "2026-02-23T00:19:47.547Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/13/88b1d2384b424bf7c924f2038c1c409f8d88bb2a8d49d097861dd64a57b2/scipy-1.17.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6609bc224e9568f65064cfa72edc0f24ee6655b47575954ec6339534b2798369", size = 37598449, upload-time = "2026-02-23T00:19:53.238Z" },
+    { url = "https://files.pythonhosted.org/packages/35/e5/d6d0e51fc888f692a35134336866341c08655d92614f492c6860dc45bb2c/scipy-1.17.1-cp313-cp313-win_amd64.whl", hash = "sha256:37425bc9175607b0268f493d79a292c39f9d001a357bebb6b88fdfaff13f6448", size = 36510943, upload-time = "2026-02-23T00:20:50.89Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/fd/3be73c564e2a01e690e19cc618811540ba5354c67c8680dce3281123fb79/scipy-1.17.1-cp313-cp313-win_arm64.whl", hash = "sha256:5cf36e801231b6a2059bf354720274b7558746f3b1a4efb43fcf557ccd484a87", size = 24545621, upload-time = "2026-02-23T00:20:55.871Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/6b/17787db8b8114933a66f9dcc479a8272e4b4da75fe03b0c282f7b0ade8cd/scipy-1.17.1-cp313-cp313t-macosx_10_14_x86_64.whl", hash = "sha256:d59c30000a16d8edc7e64152e30220bfbd724c9bbb08368c054e24c651314f0a", size = 31936708, upload-time = "2026-02-23T00:19:58.694Z" },
+    { url = "https://files.pythonhosted.org/packages/38/2e/524405c2b6392765ab1e2b722a41d5da33dc5c7b7278184a8ad29b6cb206/scipy-1.17.1-cp313-cp313t-macosx_12_0_arm64.whl", hash = "sha256:010f4333c96c9bb1a4516269e33cb5917b08ef2166d5556ca2fd9f082a9e6ea0", size = 28570135, upload-time = "2026-02-23T00:20:03.934Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/c3/5bd7199f4ea8556c0c8e39f04ccb014ac37d1468e6cfa6a95c6b3562b76e/scipy-1.17.1-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:2ceb2d3e01c5f1d83c4189737a42d9cb2fc38a6eeed225e7515eef71ad301dce", size = 20741977, upload-time = "2026-02-23T00:20:07.935Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/b8/8ccd9b766ad14c78386599708eb745f6b44f08400a5fd0ade7cf89b6fc93/scipy-1.17.1-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:844e165636711ef41f80b4103ed234181646b98a53c8f05da12ca5ca289134f6", size = 23029601, upload-time = "2026-02-23T00:20:12.161Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/a0/3cb6f4d2fb3e17428ad2880333cac878909ad1a89f678527b5328b93c1d4/scipy-1.17.1-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:158dd96d2207e21c966063e1635b1063cd7787b627b6f07305315dd73d9c679e", size = 33019667, upload-time = "2026-02-23T00:20:17.208Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/c3/2d834a5ac7bf3a0c806ad1508efc02dda3c8c61472a56132d7894c312dea/scipy-1.17.1-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:74cbb80d93260fe2ffa334efa24cb8f2f0f622a9b9febf8b483c0b865bfb3475", size = 35264159, upload-time = "2026-02-23T00:20:23.087Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/77/d3ed4becfdbd217c52062fafe35a72388d1bd82c2d0ba5ca19d6fcc93e11/scipy-1.17.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:dbc12c9f3d185f5c737d801da555fb74b3dcfa1a50b66a1a93e09190f41fab50", size = 35102771, upload-time = "2026-02-23T00:20:28.636Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/12/d19da97efde68ca1ee5538bb261d5d2c062f0c055575128f11a2730e3ac1/scipy-1.17.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:94055a11dfebe37c656e70317e1996dc197e1a15bbcc351bcdd4610e128fe1ca", size = 37665910, upload-time = "2026-02-23T00:20:34.743Z" },
+    { url = "https://files.pythonhosted.org/packages/06/1c/1172a88d507a4baaf72c5a09bb6c018fe2ae0ab622e5830b703a46cc9e44/scipy-1.17.1-cp313-cp313t-win_amd64.whl", hash = "sha256:e30bdeaa5deed6bc27b4cc490823cd0347d7dae09119b8803ae576ea0ce52e4c", size = 36562980, upload-time = "2026-02-23T00:20:40.575Z" },
+    { url = "https://files.pythonhosted.org/packages/70/b0/eb757336e5a76dfa7911f63252e3b7d1de00935d7705cf772db5b45ec238/scipy-1.17.1-cp313-cp313t-win_arm64.whl", hash = "sha256:a720477885a9d2411f94a93d16f9d89bad0f28ca23c3f8daa521e2dcc3f44d49", size = 24856543, upload-time = "2026-02-23T00:20:45.313Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/83/333afb452af6f0fd70414dc04f898647ee1423979ce02efa75c3b0f2c28e/scipy-1.17.1-cp314-cp314-macosx_10_14_x86_64.whl", hash = "sha256:a48a72c77a310327f6a3a920092fa2b8fd03d7deaa60f093038f22d98e096717", size = 31584510, upload-time = "2026-02-23T00:21:01.015Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/a6/d05a85fd51daeb2e4ea71d102f15b34fedca8e931af02594193ae4fd25f7/scipy-1.17.1-cp314-cp314-macosx_12_0_arm64.whl", hash = "sha256:45abad819184f07240d8a696117a7aacd39787af9e0b719d00285549ed19a1e9", size = 28170131, upload-time = "2026-02-23T00:21:05.888Z" },
+    { url = "https://files.pythonhosted.org/packages/db/7b/8624a203326675d7746a254083a187398090a179335b2e4a20e2ddc46e83/scipy-1.17.1-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:3fd1fcdab3ea951b610dc4cef356d416d5802991e7e32b5254828d342f7b7e0b", size = 20342032, upload-time = "2026-02-23T00:21:09.904Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/35/2c342897c00775d688d8ff3987aced3426858fd89d5a0e26e020b660b301/scipy-1.17.1-cp314-cp314-macosx_14_0_x86_64.whl", hash = "sha256:7bdf2da170b67fdf10bca777614b1c7d96ae3ca5794fd9587dce41eb2966e866", size = 22678766, upload-time = "2026-02-23T00:21:14.313Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/f2/7cdb8eb308a1a6ae1e19f945913c82c23c0c442a462a46480ce487fdc0ac/scipy-1.17.1-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:adb2642e060a6549c343603a3851ba76ef0b74cc8c079a9a58121c7ec9fe2350", size = 32957007, upload-time = "2026-02-23T00:21:19.663Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/2e/7eea398450457ecb54e18e9d10110993fa65561c4f3add5e8eccd2b9cd41/scipy-1.17.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:eee2cfda04c00a857206a4330f0c5e3e56535494e30ca445eb19ec624ae75118", size = 35221333, upload-time = "2026-02-23T00:21:25.278Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/77/5b8509d03b77f093a0d52e606d3c4f79e8b06d1d38c441dacb1e26cacf46/scipy-1.17.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d2650c1fb97e184d12d8ba010493ee7b322864f7d3d00d3f9bb97d9c21de4068", size = 35042066, upload-time = "2026-02-23T00:21:31.358Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/df/18f80fb99df40b4070328d5ae5c596f2f00fffb50167e31439e932f29e7d/scipy-1.17.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:08b900519463543aa604a06bec02461558a6e1cef8fdbb8098f77a48a83c8118", size = 37612763, upload-time = "2026-02-23T00:21:37.247Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/39/f0e8ea762a764a9dc52aa7dabcfad51a354819de1f0d4652b6a1122424d6/scipy-1.17.1-cp314-cp314-win_amd64.whl", hash = "sha256:3877ac408e14da24a6196de0ddcace62092bfc12a83823e92e49e40747e52c19", size = 37290984, upload-time = "2026-02-23T00:22:35.023Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/56/fe201e3b0f93d1a8bcf75d3379affd228a63d7e2d80ab45467a74b494947/scipy-1.17.1-cp314-cp314-win_arm64.whl", hash = "sha256:f8885db0bc2bffa59d5c1b72fad7a6a92d3e80e7257f967dd81abb553a90d293", size = 25192877, upload-time = "2026-02-23T00:22:39.798Z" },
+    { url = "https://files.pythonhosted.org/packages/96/ad/f8c414e121f82e02d76f310f16db9899c4fcde36710329502a6b2a3c0392/scipy-1.17.1-cp314-cp314t-macosx_10_14_x86_64.whl", hash = "sha256:1cc682cea2ae55524432f3cdff9e9a3be743d52a7443d0cba9017c23c87ae2f6", size = 31949750, upload-time = "2026-02-23T00:21:42.289Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/b0/c741e8865d61b67c81e255f4f0a832846c064e426636cd7de84e74d209be/scipy-1.17.1-cp314-cp314t-macosx_12_0_arm64.whl", hash = "sha256:2040ad4d1795a0ae89bfc7e8429677f365d45aa9fd5e4587cf1ea737f927b4a1", size = 28585858, upload-time = "2026-02-23T00:21:47.706Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/1b/3985219c6177866628fa7c2595bfd23f193ceebbe472c98a08824b9466ff/scipy-1.17.1-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:131f5aaea57602008f9822e2115029b55d4b5f7c070287699fe45c661d051e39", size = 20757723, upload-time = "2026-02-23T00:21:52.039Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/19/2a04aa25050d656d6f7b9e7b685cc83d6957fb101665bfd9369ca6534563/scipy-1.17.1-cp314-cp314t-macosx_14_0_x86_64.whl", hash = "sha256:9cdc1a2fcfd5c52cfb3045feb399f7b3ce822abdde3a193a6b9a60b3cb5854ca", size = 23043098, upload-time = "2026-02-23T00:21:56.185Z" },
+    { url = "https://files.pythonhosted.org/packages/86/f1/3383beb9b5d0dbddd030335bf8a8b32d4317185efe495374f134d8be6cce/scipy-1.17.1-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e3dcd57ab780c741fde8dc68619de988b966db759a3c3152e8e9142c26295ad", size = 33030397, upload-time = "2026-02-23T00:22:01.404Z" },
+    { url = "https://files.pythonhosted.org/packages/41/68/8f21e8a65a5a03f25a79165ec9d2b28c00e66dc80546cf5eb803aeeff35b/scipy-1.17.1-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a9956e4d4f4a301ebf6cde39850333a6b6110799d470dbbb1e25326ac447f52a", size = 35281163, upload-time = "2026-02-23T00:22:07.024Z" },
+    { url = "https://files.pythonhosted.org/packages/84/8d/c8a5e19479554007a5632ed7529e665c315ae7492b4f946b0deb39870e39/scipy-1.17.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:a4328d245944d09fd639771de275701ccadf5f781ba0ff092ad141e017eccda4", size = 35116291, upload-time = "2026-02-23T00:22:12.585Z" },
+    { url = "https://files.pythonhosted.org/packages/52/52/e57eceff0e342a1f50e274264ed47497b59e6a4e3118808ee58ddda7b74a/scipy-1.17.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a77cbd07b940d326d39a1d1b37817e2ee4d79cb30e7338f3d0cddffae70fcaa2", size = 37682317, upload-time = "2026-02-23T00:22:18.513Z" },
+    { url = "https://files.pythonhosted.org/packages/11/2f/b29eafe4a3fbc3d6de9662b36e028d5f039e72d345e05c250e121a230dd4/scipy-1.17.1-cp314-cp314t-win_amd64.whl", hash = "sha256:eb092099205ef62cd1782b006658db09e2fed75bffcae7cc0d44052d8aa0f484", size = 37345327, upload-time = "2026-02-23T00:22:24.442Z" },
+    { url = "https://files.pythonhosted.org/packages/07/39/338d9219c4e87f3e708f18857ecd24d22a0c3094752393319553096b98af/scipy-1.17.1-cp314-cp314t-win_arm64.whl", hash = "sha256:200e1050faffacc162be6a486a984a0497866ec54149a01270adc8a59b7c7d21", size = 25489165, upload-time = "2026-02-23T00:22:29.563Z" },
+]
+
+[[package]]
+name = "segment-anything"
+version = "1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4f/88/7725f418f2bb4a7ac2e5e8295fbbca2900c70c8fe5ba48b3aff5788af9a2/segment_anything-1.0.tar.gz", hash = "sha256:ed0c9f6fb07bbef9c6238a7028a13c8272f1ba6b6305ca73e3e064266503736b", size = 31191, upload-time = "2023-04-06T18:04:40.816Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/75/77/8e0c16abf151a1dd076b562febc0da2ecf1132b0b41826087af96f101f42/segment_anything-1.0-py3-none-any.whl", hash = "sha256:86f67d417a915823c3302098effe9008b688945772517310956bb49de0e7f02e", size = 36560, upload-time = "2023-04-06T18:04:38.834Z" },
+]
+
+[[package]]
+name = "setuptools"
+version = "81.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0d/1c/73e719955c59b8e424d015ab450f51c0af856ae46ea2da83eba51cc88de1/setuptools-81.0.0.tar.gz", hash = "sha256:487b53915f52501f0a79ccfd0c02c165ffe06631443a886740b91af4b7a5845a", size = 1198299, upload-time = "2026-02-06T21:10:39.601Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e1/e3/c164c88b2e5ce7b24d667b9bd83589cf4f3520d97cad01534cd3c4f55fdb/setuptools-81.0.0-py3-none-any.whl", hash = "sha256:fdd925d5c5d9f62e4b74b30d6dd7828ce236fd6ed998a08d81de62ce5a6310d6", size = 1062021, upload-time = "2026-02-06T21:10:37.175Z" },
+]
+
+[[package]]
+name = "six"
+version = "1.17.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031, upload-time = "2024-12-04T17:35:28.174Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
+]
+
+[[package]]
+name = "sniffio"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/87/a6771e1546d97e7e041b6ae58d80074f81b7d5121207425c964ddf5cfdbd/sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc", size = 20372, upload-time = "2024-02-25T23:20:04.057Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e9/44/75a9c9421471a6c4805dbf2356f7c181a29c1879239abab1ea2cc8f38b40/sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2", size = 10235, upload-time = "2024-02-25T23:20:01.196Z" },
+]
+
+[[package]]
+name = "starlette"
+version = "1.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/25/44/ec35f1b6e83094b997da438a02c8c9b0ade2b1e84cfc48bd4656780760a6/starlette-1.2.1.tar.gz", hash = "sha256:9b9b5ebb992e67d6093741e63c2f59e4f6fff986f81163c087867bd7b924b3f6", size = 2701854, upload-time = "2026-05-31T01:07:51.847Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1c/54/196d0c1db10af76baa4f64894448505d60d3cdf70ef92cbb35f46a4e4c71/starlette-1.2.1-py3-none-any.whl", hash = "sha256:4de0082d08c8f6764a85a54cf1120d6939507a19905c7768acad2a9f875d2b89", size = 73350, upload-time = "2026-05-31T01:07:50.09Z" },
+]
+
+[[package]]
+name = "sympy"
+version = "1.14.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mpmath" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/83/d3/803453b36afefb7c2bb238361cd4ae6125a569b4db67cd9e79846ba2d68c/sympy-1.14.0.tar.gz", hash = "sha256:d3d3fe8df1e5a0b42f0e7bdf50541697dbe7d23746e894990c030e2b05e72517", size = 7793921, upload-time = "2025-04-27T18:05:01.611Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a2/09/77d55d46fd61b4a135c444fc97158ef34a095e5681d0a6c10b75bf356191/sympy-1.14.0-py3-none-any.whl", hash = "sha256:e091cc3e99d2141a0ba2847328f5479b05d94a6635cb96148ccb3f34671bd8f5", size = 6299353, upload-time = "2025-04-27T18:04:59.103Z" },
+]
+
+[[package]]
+name = "tifffile"
+version = "2025.5.10"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.11'",
+]
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/44/d0/18fed0fc0916578a4463f775b0fbd9c5fed2392152d039df2fb533bfdd5d/tifffile-2025.5.10.tar.gz", hash = "sha256:018335d34283aa3fd8c263bae5c3c2b661ebc45548fde31504016fcae7bf1103", size = 365290, upload-time = "2025-05-10T19:22:34.386Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/06/bd0a6097da704a7a7c34a94cfd771c3ea3c2f405dd214e790d22c93f6be1/tifffile-2025.5.10-py3-none-any.whl", hash = "sha256:e37147123c0542d67bc37ba5cdd67e12ea6fbe6e86c52bee037a9eb6a064e5ad", size = 226533, upload-time = "2025-05-10T19:22:27.279Z" },
+]
+
+[[package]]
+name = "tifffile"
+version = "2026.3.3"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version == '3.11.*'",
+]
+dependencies = [
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c5/cb/2f6d79c7576e22c116352a801f4c3c8ace5957e9aced862012430b62e14f/tifffile-2026.3.3.tar.gz", hash = "sha256:d9a1266bed6f2ee1dd0abde2018a38b4f8b2935cb843df381d70ac4eac5458b7", size = 388745, upload-time = "2026-03-03T19:14:38.134Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/e4/e804505f87627cd8cdae9c010c47c4485fd8c1ce31a7dd0ab7fcc4707377/tifffile-2026.3.3-py3-none-any.whl", hash = "sha256:e8be15c94273113d31ecb7aa3a39822189dd11c4967e3cc88c178f1ad2fd1170", size = 243960, upload-time = "2026-03-03T19:14:35.808Z" },
+]
+
+[[package]]
+name = "tifffile"
+version = "2026.5.15"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+]
+dependencies = [
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/40/66/0aef917d525767a40edebe088f8ed6a4417e6eb489c58f6805bfa872636b/tifffile-2026.5.15.tar.gz", hash = "sha256:ee4f3e07ee0d8ff4745a8c735ac2b72caa3173c7d6059b00fdc3ff492a0b635b", size = 429998, upload-time = "2026-05-15T20:04:55.896Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1f/6e/7d8850ff112f8f80d394ca45e89b975a3a43559d47af3137b767669b3294/tifffile-2026.5.15-py3-none-any.whl", hash = "sha256:6715515a53cabc0cefc5c9f13a0ae2c250e63e2ca784ce02d0b6c333810c2a17", size = 266665, upload-time = "2026-05-15T20:04:54.227Z" },
+]
+
+[[package]]
+name = "tomli"
+version = "2.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/22/de/48c59722572767841493b26183a0d1cc411d54fd759c5607c4590b6563a6/tomli-2.4.1.tar.gz", hash = "sha256:7c7e1a961a0b2f2472c1ac5b69affa0ae1132c39adcb67aba98568702b9cc23f", size = 17543, upload-time = "2026-03-25T20:22:03.828Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/11/db3d5885d8528263d8adc260bb2d28ebf1270b96e98f0e0268d32b8d9900/tomli-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8f0fc26ec2cc2b965b7a3b87cd19c5c6b8c5e5f436b984e85f486d652285c30", size = 154704, upload-time = "2026-03-25T20:21:10.473Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/f7/675db52c7e46064a9aa928885a9b20f4124ecb9bc2e1ce74c9106648d202/tomli-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ab97e64ccda8756376892c53a72bd1f964e519c77236368527f758fbc36a53a", size = 149454, upload-time = "2026-03-25T20:21:12.036Z" },
+    { url = "https://files.pythonhosted.org/packages/61/71/81c50943cf953efa35bce7646caab3cf457a7d8c030b27cfb40d7235f9ee/tomli-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96481a5786729fd470164b47cdb3e0e58062a496f455ee41b4403be77cb5a076", size = 237561, upload-time = "2026-03-25T20:21:13.098Z" },
+    { url = "https://files.pythonhosted.org/packages/48/c1/f41d9cb618acccca7df82aaf682f9b49013c9397212cb9f53219e3abac37/tomli-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a881ab208c0baf688221f8cecc5401bd291d67e38a1ac884d6736cbcd8247e9", size = 243824, upload-time = "2026-03-25T20:21:14.569Z" },
+    { url = "https://files.pythonhosted.org/packages/22/e4/5a816ecdd1f8ca51fb756ef684b90f2780afc52fc67f987e3c61d800a46d/tomli-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47149d5bd38761ac8be13a84864bf0b7b70bc051806bc3669ab1cbc56216b23c", size = 242227, upload-time = "2026-03-25T20:21:15.712Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/49/2b2a0ef529aa6eec245d25f0c703e020a73955ad7edf73e7f54ddc608aa5/tomli-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ec9bfaf3ad2df51ace80688143a6a4ebc09a248f6ff781a9945e51937008fcbc", size = 247859, upload-time = "2026-03-25T20:21:17.001Z" },
+    { url = "https://files.pythonhosted.org/packages/83/bd/6c1a630eaca337e1e78c5903104f831bda934c426f9231429396ce3c3467/tomli-2.4.1-cp311-cp311-win32.whl", hash = "sha256:ff2983983d34813c1aeb0fa89091e76c3a22889ee83ab27c5eeb45100560c049", size = 97204, upload-time = "2026-03-25T20:21:18.079Z" },
+    { url = "https://files.pythonhosted.org/packages/42/59/71461df1a885647e10b6bb7802d0b8e66480c61f3f43079e0dcd315b3954/tomli-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:5ee18d9ebdb417e384b58fe414e8d6af9f4e7a0ae761519fb50f721de398dd4e", size = 108084, upload-time = "2026-03-25T20:21:18.978Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/83/dceca96142499c069475b790e7913b1044c1a4337e700751f48ed723f883/tomli-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:c2541745709bad0264b7d4705ad453b76ccd191e64aa6f0fc66b69a293a45ece", size = 95285, upload-time = "2026-03-25T20:21:20.309Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/ba/42f134a3fe2b370f555f44b1d72feebb94debcab01676bf918d0cb70e9aa/tomli-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c742f741d58a28940ce01d58f0ab2ea3ced8b12402f162f4d534dfe18ba1cd6a", size = 155924, upload-time = "2026-03-25T20:21:21.626Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/c7/62d7a17c26487ade21c5422b646110f2162f1fcc95980ef7f63e73c68f14/tomli-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7f86fd587c4ed9dd76f318225e7d9b29cfc5a9d43de44e5754db8d1128487085", size = 150018, upload-time = "2026-03-25T20:21:23.002Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/05/79d13d7c15f13bdef410bdd49a6485b1c37d28968314eabee452c22a7fda/tomli-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff18e6a727ee0ab0388507b89d1bc6a22b138d1e2fa56d1ad494586d61d2eae9", size = 244948, upload-time = "2026-03-25T20:21:24.04Z" },
+    { url = "https://files.pythonhosted.org/packages/10/90/d62ce007a1c80d0b2c93e02cab211224756240884751b94ca72df8a875ca/tomli-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:136443dbd7e1dee43c68ac2694fde36b2849865fa258d39bf822c10e8068eac5", size = 253341, upload-time = "2026-03-25T20:21:25.177Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/7e/caf6496d60152ad4ed09282c1885cca4eea150bfd007da84aea07bcc0a3e/tomli-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5e262d41726bc187e69af7825504c933b6794dc3fbd5945e41a79bb14c31f585", size = 248159, upload-time = "2026-03-25T20:21:26.364Z" },
+    { url = "https://files.pythonhosted.org/packages/99/e7/c6f69c3120de34bbd882c6fba7975f3d7a746e9218e56ab46a1bc4b42552/tomli-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5cb41aa38891e073ee49d55fbc7839cfdb2bc0e600add13874d048c94aadddd1", size = 253290, upload-time = "2026-03-25T20:21:27.46Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/2f/4a3c322f22c5c66c4b836ec58211641a4067364f5dcdd7b974b4c5da300c/tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917", size = 98141, upload-time = "2026-03-25T20:21:28.492Z" },
+    { url = "https://files.pythonhosted.org/packages/24/22/4daacd05391b92c55759d55eaee21e1dfaea86ce5c571f10083360adf534/tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9", size = 108847, upload-time = "2026-03-25T20:21:29.386Z" },
+    { url = "https://files.pythonhosted.org/packages/68/fd/70e768887666ddd9e9f5d85129e84910f2db2796f9096aa02b721a53098d/tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257", size = 95088, upload-time = "2026-03-25T20:21:30.677Z" },
+    { url = "https://files.pythonhosted.org/packages/07/06/b823a7e818c756d9a7123ba2cda7d07bc2dd32835648d1a7b7b7a05d848d/tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54", size = 155866, upload-time = "2026-03-25T20:21:31.65Z" },
+    { url = "https://files.pythonhosted.org/packages/14/6f/12645cf7f08e1a20c7eb8c297c6f11d31c1b50f316a7e7e1e1de6e2e7b7e/tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a", size = 149887, upload-time = "2026-03-25T20:21:33.028Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e0/90637574e5e7212c09099c67ad349b04ec4d6020324539297b634a0192b0/tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897", size = 243704, upload-time = "2026-03-25T20:21:34.51Z" },
+    { url = "https://files.pythonhosted.org/packages/10/8f/d3ddb16c5a4befdf31a23307f72828686ab2096f068eaf56631e136c1fdd/tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f", size = 251628, upload-time = "2026-03-25T20:21:36.012Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/f1/dbeeb9116715abee2485bf0a12d07a8f31af94d71608c171c45f64c0469d/tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d", size = 247180, upload-time = "2026-03-25T20:21:37.136Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/74/16336ffd19ed4da28a70959f92f506233bd7cfc2332b20bdb01591e8b1d1/tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5", size = 251674, upload-time = "2026-03-25T20:21:38.298Z" },
+    { url = "https://files.pythonhosted.org/packages/16/f9/229fa3434c590ddf6c0aa9af64d3af4b752540686cace29e6281e3458469/tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd", size = 97976, upload-time = "2026-03-25T20:21:39.316Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/1e/71dfd96bcc1c775420cb8befe7a9d35f2e5b1309798f009dca17b7708c1e/tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36", size = 108755, upload-time = "2026-03-25T20:21:40.248Z" },
+    { url = "https://files.pythonhosted.org/packages/83/7a/d34f422a021d62420b78f5c538e5b102f62bea616d1d75a13f0a88acb04a/tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd", size = 95265, upload-time = "2026-03-25T20:21:41.219Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/fb/9a5c8d27dbab540869f7c1f8eb0abb3244189ce780ba9cd73f3770662072/tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf", size = 155726, upload-time = "2026-03-25T20:21:42.23Z" },
+    { url = "https://files.pythonhosted.org/packages/62/05/d2f816630cc771ad836af54f5001f47a6f611d2d39535364f148b6a92d6b/tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac", size = 149859, upload-time = "2026-03-25T20:21:43.386Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/48/66341bdb858ad9bd0ceab5a86f90eddab127cf8b046418009f2125630ecb/tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662", size = 244713, upload-time = "2026-03-25T20:21:44.474Z" },
+    { url = "https://files.pythonhosted.org/packages/df/6d/c5fad00d82b3c7a3ab6189bd4b10e60466f22cfe8a08a9394185c8a8111c/tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853", size = 252084, upload-time = "2026-03-25T20:21:45.62Z" },
+    { url = "https://files.pythonhosted.org/packages/00/71/3a69e86f3eafe8c7a59d008d245888051005bd657760e96d5fbfb0b740c2/tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15", size = 247973, upload-time = "2026-03-25T20:21:46.937Z" },
+    { url = "https://files.pythonhosted.org/packages/67/50/361e986652847fec4bd5e4a0208752fbe64689c603c7ae5ea7cb16b1c0ca/tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba", size = 256223, upload-time = "2026-03-25T20:21:48.467Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/9a/b4173689a9203472e5467217e0154b00e260621caa227b6fa01feab16998/tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6", size = 98973, upload-time = "2026-03-25T20:21:49.526Z" },
+    { url = "https://files.pythonhosted.org/packages/14/58/640ac93bf230cd27d002462c9af0d837779f8773bc03dee06b5835208214/tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7", size = 109082, upload-time = "2026-03-25T20:21:50.506Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/2f/702d5e05b227401c1068f0d386d79a589bb12bf64c3d2c72ce0631e3bc49/tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232", size = 96490, upload-time = "2026-03-25T20:21:51.474Z" },
+    { url = "https://files.pythonhosted.org/packages/45/4b/b877b05c8ba62927d9865dd980e34a755de541eb65fffba52b4cc495d4d2/tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4", size = 164263, upload-time = "2026-03-25T20:21:52.543Z" },
+    { url = "https://files.pythonhosted.org/packages/24/79/6ab420d37a270b89f7195dec5448f79400d9e9c1826df982f3f8e97b24fd/tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c", size = 160736, upload-time = "2026-03-25T20:21:53.674Z" },
+    { url = "https://files.pythonhosted.org/packages/02/e0/3630057d8eb170310785723ed5adcdfb7d50cb7e6455f85ba8a3deed642b/tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d", size = 270717, upload-time = "2026-03-25T20:21:55.129Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/b4/1613716072e544d1a7891f548d8f9ec6ce2faf42ca65acae01d76ea06bb0/tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41", size = 278461, upload-time = "2026-03-25T20:21:56.228Z" },
+    { url = "https://files.pythonhosted.org/packages/05/38/30f541baf6a3f6df77b3df16b01ba319221389e2da59427e221ef417ac0c/tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c", size = 274855, upload-time = "2026-03-25T20:21:57.653Z" },
+    { url = "https://files.pythonhosted.org/packages/77/a3/ec9dd4fd2c38e98de34223b995a3b34813e6bdadf86c75314c928350ed14/tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f", size = 283144, upload-time = "2026-03-25T20:21:59.089Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/be/605a6261cac79fba2ec0c9827e986e00323a1945700969b8ee0b30d85453/tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8", size = 108683, upload-time = "2026-03-25T20:22:00.214Z" },
+    { url = "https://files.pythonhosted.org/packages/12/64/da524626d3b9cc40c168a13da8335fe1c51be12c0a63685cc6db7308daae/tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26", size = 121196, upload-time = "2026-03-25T20:22:01.169Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/cd/e80b62269fc78fc36c9af5a6b89c835baa8af28ff5ad28c7028d60860320/tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396", size = 100393, upload-time = "2026-03-25T20:22:02.137Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/61/cceae43728b7de99d9b847560c262873a1f6c98202171fd5ed62640b494b/tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe", size = 14583, upload-time = "2026-03-25T20:22:03.012Z" },
+]
+
+[[package]]
+name = "toolz"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/11/d6/114b492226588d6ff54579d95847662fc69196bdeec318eb45393b24c192/toolz-1.1.0.tar.gz", hash = "sha256:27a5c770d068c110d9ed9323f24f1543e83b2f300a687b7891c1a6d56b697b5b", size = 52613, upload-time = "2025-10-17T04:03:21.661Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/12/5911ae3eeec47800503a238d971e51722ccea5feb8569b735184d5fcdbc0/toolz-1.1.0-py3-none-any.whl", hash = "sha256:15ccc861ac51c53696de0a5d6d4607f99c210739caf987b5d2054f3efed429d8", size = 58093, upload-time = "2025-10-17T04:03:20.435Z" },
+]
+
+[[package]]
+name = "torch"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cuda-bindings", marker = "sys_platform == 'linux'" },
+    { name = "cuda-toolkit", extra = ["cudart", "cufft", "cufile", "cupti", "curand", "cusolver", "cusparse", "nvjitlink", "nvrtc", "nvtx"], marker = "sys_platform == 'linux'" },
+    { name = "filelock" },
+    { name = "fsspec" },
+    { name = "jinja2" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "nvidia-cublas", marker = "sys_platform == 'linux'" },
+    { name = "nvidia-cudnn-cu13", marker = "sys_platform == 'linux'" },
+    { name = "nvidia-cusparselt-cu13", marker = "sys_platform == 'linux'" },
+    { name = "nvidia-nccl-cu13", marker = "sys_platform == 'linux'" },
+    { name = "nvidia-nvshmem-cu13", marker = "sys_platform == 'linux'" },
+    { name = "setuptools" },
+    { name = "sympy" },
+    { name = "triton", marker = "sys_platform == 'linux'" },
+    { name = "typing-extensions" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c2/b7/53fe0436586716ab7aecff41e26b9302d57c85ded481fd83a2cd741e6b4e/torch-2.12.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:1834bd984f8a2f4f16bdfbeecca9146184b220aa46276bf5756735b5dae12812", size = 87981887, upload-time = "2026-05-13T14:55:53.234Z" },
+    { url = "https://files.pythonhosted.org/packages/34/60/d930eac44c30de06ed16f6d1ba4e785e1632532b50d8f0bf9bf699a4d0c7/torch-2.12.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:d4d029801cb7b6df858804a2a21b00cc2aa0bf0ee5d2ab18d343c9e9e5681f35", size = 426355000, upload-time = "2026-05-13T14:54:31.944Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/0c/c76b6a087820bab55705b94dfc074e520de9ae91f5ef90da2ecbf2a3ef12/torch-2.12.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:d47e7dee68ac4cd7a068b26bcd6b989935427709fae1c8f7bd0019978f829e15", size = 532144998, upload-time = "2026-05-13T14:56:05.523Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/64/8a0d036e166a6aa85ee09bef072f3655d1ba5d5486a68d1b03b6813c01b3/torch-2.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:cf9839790285dd472e7a16aafcb4a4e6bf58ec1b494045044b0eefb0eb4bd1f2", size = 122949877, upload-time = "2026-05-13T14:55:46.841Z" },
+    { url = "https://files.pythonhosted.org/packages/18/62/131124fb95df03811b8260d1d43dcc5ee85ea1a344b964613d7efe77fb08/torch-2.12.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:10802fd383bbfed646212e765a72c37d2185205d4f26eb197a254e8ac7ddcb25", size = 87990344, upload-time = "2026-05-13T14:55:42.154Z" },
+    { url = "https://files.pythonhosted.org/packages/12/9c/dda0dbd547dc549839824135f223792fd0e725f28ed0715dda366b7acaa2/torch-2.12.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:c12592630aef72feaf18bd3f197ef587bbfa21131b31c38b23ab2e55fce92e36", size = 426362932, upload-time = "2026-05-13T14:54:15.295Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/d2/a7dd5a3f9bdaa7842124e8e2359202b317c48d47d2fc5816fafdf2049adb/torch-2.12.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:415c1b8d0412f67551c8e89a2daca0fb3e56694af0281ba155eaa9da481f58b4", size = 532170085, upload-time = "2026-05-13T14:55:20.788Z" },
+    { url = "https://files.pythonhosted.org/packages/12/1b/a61ce2004f9ab0ea8964a6e6168133a127795667639e2ff4f8f2bdb16a65/torch-2.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:dd37188ea325042cb1f6cafa56822b11ada2520c04791a52629b0af25bdfbfd9", size = 122953128, upload-time = "2026-05-13T14:54:52.744Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/bb/285d643f254731294c9b595a007eac39db4600a98682d7bca688f42ca164/torch-2.12.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:b41339df93d491435e790ff8bcbae1c0ce777175889bfd1281d119862793e6a2", size = 88010197, upload-time = "2026-05-13T14:55:35.414Z" },
+    { url = "https://files.pythonhosted.org/packages/79/81/76debf1db1343bd929bbb5d74c89fb437c2ed88eb144712557e7bd3eea45/torch-2.12.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:8fbef9f108a863e7722a73740998967e3b074742a834fc5be3a535a2befa7057", size = 426376751, upload-time = "2026-05-13T14:55:03.353Z" },
+    { url = "https://files.pythonhosted.org/packages/de/f0/80026028b603c4650ff270fc3785bdef4bd6738765a9cc5a0f5a637d65a2/torch-2.12.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:4b4f64c2c2b11f7510d93dd6412b87025ff6eddd6bb61c3b5a3d892ea20c4756", size = 532261691, upload-time = "2026-05-13T14:52:54.453Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/c2/64b06cbb7830fb3cd9be13e1158b31a3f36b68e6a209105ee3c9d9480be0/torch-2.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:8b958caff4a14d3a3b0b2dfc6a378f64dda9728a9dad28c08a0db9ce4dafb549", size = 122988114, upload-time = "2026-05-13T14:54:42.153Z" },
+    { url = "https://files.pythonhosted.org/packages/86/ca/01896c80ba921676aa45886b2c5b8d774912de2a1f719de48169c6f755cd/torch-2.12.0-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:90dd587a5f61bfe1307148b581e2084fc5bc4a06e2b90a20e9a36b81087ff16b", size = 88009511, upload-time = "2026-05-13T14:54:47.411Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/04/52bdaf4787eab6ac7d7f5851dff934e4def0bc8ead9c8fd2b69b3e529699/torch-2.12.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:864392c73b7654f4d2b3ae712f607937d0dbb1101c4555fbb41848106b297f39", size = 426383231, upload-time = "2026-05-13T14:53:32.129Z" },
+    { url = "https://files.pythonhosted.org/packages/49/8a/94bdecd13f5aaa90d45920b89789d9fe7c6f4af8c3cdd7ce01fcb59908fc/torch-2.12.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:5d6b560dfa7d56291c07d615c3bb73e8d9943d9b6d87f76cd0d9d570c4797fa6", size = 532269288, upload-time = "2026-05-13T14:53:49.423Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/2f/bdbaaa267de519ef1b73054bf590d8c93c37a266c9a4e24a01bd38b6918f/torch-2.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:3fee918902090ade827643e758e98363278815de583c75d111fdd665ebffde9f", size = 122987706, upload-time = "2026-05-13T14:54:00.335Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/ad/e95e822f3538171e22640a7fbe839a1fdb666600bf6487025de2ff03b11a/torch-2.12.0-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:10ee1448a9f304d3b987eb4656f664ba6e4d7b410ca7a5a7c642199777a2cf88", size = 88319556, upload-time = "2026-05-13T14:54:05.574Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/07/055d06d985b445d67422d25b033c11cf55bbb81785d4c4e68e28bca5820e/torch-2.12.0-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:af68dbf403439cae9ceaeaaf92f8352b460787dcd27b92aa05c40dd4a19c0f1e", size = 426397656, upload-time = "2026-05-13T14:52:38.84Z" },
+    { url = "https://files.pythonhosted.org/packages/43/94/b0b4fdc3014122e0a7302fb90086d352aa48f2576f0b252561ebb38c01a8/torch-2.12.0-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:a6a2eebb237d3b1d9ad3b378e86d9b9e0782afdea8b1e0eba6a13646b9b49c07", size = 532183124, upload-time = "2026-05-13T14:53:16.178Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/c8/052405e6ad05d3237bfe5a4df78f917773956f8e17813a2d44c059068b74/torch-2.12.0-cp313-cp313t-win_amd64.whl", hash = "sha256:2140e373e9a51a3e22ef62e8d14366d0b470d18f0adf19fdc757368077133a34", size = 123232462, upload-time = "2026-05-13T14:52:27.26Z" },
+    { url = "https://files.pythonhosted.org/packages/67/dc/ac069f8d6e8be701535921141055293b0d4819d3d7f224a4612cf157c7f9/torch-2.12.0-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:f7dfae4a519197dfa050e98d8e36378a0fb5899625a875c2b54445005a2e404e", size = 88027282, upload-time = "2026-05-13T14:53:05.258Z" },
+    { url = "https://files.pythonhosted.org/packages/33/c3/1c1eb00e34555b536dddf792676026a988d710ed36981aa00499b36b0620/torch-2.12.0-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:891c769072637c74e9a5a77a3bc782894696d8ffec83b938df8536dee7f0ba78", size = 426386961, upload-time = "2026-05-13T14:51:28.406Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/d4/7e730dba0c7032a4154dc9056b76cf9625515e030e269cfbf8098fcfee7d/torch-2.12.0-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:e2ad3eb85d39c3cab62dfa93ed5a73516e6a53c6713cb97d004004fe089f0f1f", size = 532272265, upload-time = "2026-05-13T14:51:59.308Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/b4/92c80d1bbfee1c0036c06d1d2155a3065bd2423134c83bf8a47e65cd6b9b/torch-2.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:c66696857e987efb8bc1777a37357ec4f60ab5e8af6250b83d6034437fa2d8f3", size = 122987138, upload-time = "2026-05-13T14:51:45.942Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/78/2e12b37ce50a19a037d7bc62d652a5a8f27385a7b05859d6bc9204f20cfe/torch-2.12.0-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:b4556715c8572758625d62b6e0ae3b1f76c440221913a6fb5e100f321fb4fb02", size = 88320100, upload-time = "2026-05-13T14:51:39.955Z" },
+    { url = "https://files.pythonhosted.org/packages/56/5e/83c450ec7b0bb40a7b74611c1b5440f9260e33c54c90d556fd4a1f0fd955/torch-2.12.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:a43ac605a5e13116c72b64c359644cce0229f213dde48d2ae0ae5eb5becf7feb", size = 426391871, upload-time = "2026-05-13T14:52:14.989Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/e9/1a0b575d98d0afedd8f157d23fa3d2759421483660448e60d0a4b10b6daa/torch-2.12.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:6a7512adfdd7f6732e40de1c620831e3c75b39b98cef60b11d0c5f0a76473ec5", size = 532192241, upload-time = "2026-05-13T14:51:07.795Z" },
+    { url = "https://files.pythonhosted.org/packages/88/21/afadd25ecd81b3cea1e11c73cf1ab41a983a50271548c3ec7ec3b9efc3e9/torch-2.12.0-cp314-cp314t-win_amd64.whl", hash = "sha256:5f96b63f8287f66a005dd1b5a6abba2920f11156c5e5c4d815f3e2050fd1aa16", size = 123231092, upload-time = "2026-05-13T14:51:18.854Z" },
+]
+
+[[package]]
+name = "torchvision"
+version = "0.27.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "pillow" },
+    { name = "torch" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/13/15/2df874db140bbfe42f377e05e2dd38f2b9dc88414a6607eecc42073b2baa/torchvision-0.27.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:0822b58d2c5d325cd0c7152b744acbd15f898c07572e2cfb70b075a865a4f6f9", size = 1758817, upload-time = "2026-05-13T14:57:20.113Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/32/10b1ff4087d35b7af7bd85ccb85fbc2573c6f1c2008cf8abfcaf605a10fc/torchvision-0.27.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:c9f44e35e6ec01caedacce9e941a5bf21fe424403321efac2507a201273653c5", size = 7830083, upload-time = "2026-05-13T14:57:18.336Z" },
+    { url = "https://files.pythonhosted.org/packages/57/20/97dca91770235028ba7e9c598ca1fc48c297f1843af8102430f2adcd4335/torchvision-0.27.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:419c98a9275b27660cdce6d09080fd5974d1ec1d4a225f71439ebacb3b0c4e64", size = 7573816, upload-time = "2026-05-13T14:57:12.327Z" },
+    { url = "https://files.pythonhosted.org/packages/37/a5/66fbf7f21f292d095a153ee142806646813e2055a69efe5854c28e7c3fb9/torchvision-0.27.0-cp310-cp310-win_amd64.whl", hash = "sha256:2664d06acd64d328aa7689b0d0c81ee31e240e9977d8768816b4be7c66c03211", size = 3435489, upload-time = "2026-05-13T14:57:13.716Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/d6/a7e71e981042d5c573e2e61891b9023b190c88adb75b18bed8594371250c/torchvision-0.27.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:df0c166b6bdf7c47f88e81e8b43bc085451d5c50d0c5d1691bc474c1227d6fed", size = 1758812, upload-time = "2026-05-13T14:57:16.662Z" },
+    { url = "https://files.pythonhosted.org/packages/93/f9/f542fb7e4476603fb237ebdc64369a7d11f18eb5a129aa2559cbdb710aee/torchvision-0.27.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:9bb9251f64b854124efed95d02953a89f7e2726c3ca662d7ea0151129157297f", size = 7831148, upload-time = "2026-05-13T14:57:08.37Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/61/7aa7cc2c9e8750027f6fb9ae3a7393ef43860bcdfe3966e2f71fee800e31/torchvision-0.27.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:f44453f107c296d5446a79f7ac59733ad8bf5ddfa04c53805dfbae298a42a798", size = 7575519, upload-time = "2026-05-13T14:56:50.552Z" },
+    { url = "https://files.pythonhosted.org/packages/19/aa/929b358b1a643849b81ec95569938044cc37dc65ab10c84eb6d82fe1bfbb/torchvision-0.27.0-cp311-cp311-win_amd64.whl", hash = "sha256:b4aacff70ea4b7377f996f9048989c850d221fef33658ddbcae42aa5bd4ca11a", size = 3749475, upload-time = "2026-05-13T14:57:11.007Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/c8/5cd91932f7f3671b0743dc4ae1a4c16b1d0b45bf4087976277d325bda718/torchvision-0.27.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:1a6dd742a150645126df9e0b2e449874c1d635897c773b322c2e067e98382dfe", size = 1758824, upload-time = "2026-05-13T14:57:15.227Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/36/7fb7d19477b3d93283b52fea11fa8ee30ab9064a08c97b4a6b91445e26cb/torchvision-0.27.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:65772ff3ec4f4f5d680e30019835555dd239e7fefee4b0a846375fe1cb1592ef", size = 7831034, upload-time = "2026-05-13T14:57:06.483Z" },
+    { url = "https://files.pythonhosted.org/packages/62/43/dfd894c3f8b01b5b33fde990f0159c1926ebc7b6e2c4193e2efb7da3c4cb/torchvision-0.27.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:7a9966a088d06b4cf6c610e03be62de469efa6f2cd2e7c7eed8e925ed6af59ac", size = 7579774, upload-time = "2026-05-13T14:56:59.337Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/0c/722e989f9cf026e97ef7cb24a9bb1859e099f72d247ae35388fb89729f73/torchvision-0.27.0-cp312-cp312-win_amd64.whl", hash = "sha256:2c037709072ca9b19750c0cbe9e8bb6f91c9a1be1befa26df33e281deccbd8c7", size = 4021073, upload-time = "2026-05-13T14:57:00.848Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/ae/36547812e6e047c1d80bcacd1b17a340612b08a6e876e0aabf3d0b9228b0/torchvision-0.27.0-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:41d6dae73e1af09fa82ded597ae57f2a2314285acde54b25890a8f8e51b999d7", size = 1758826, upload-time = "2026-05-13T14:57:05.262Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/30/32c4ea842738728a14e3df8c576c62dedcf5ae5cb6a5c984c6429ebe7524/torchvision-0.27.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:70f071c6f74b60d5fe8851636d8d4cd5f4fa29d57fd9348a87a6f17b990b95ba", size = 7789501, upload-time = "2026-05-13T14:56:57.786Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/24/4d0d48684251bd0673f87d633d5d88ab00227983b00591156eed2f86c8d5/torchvision-0.27.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:aaafa6962c9d91f42503de1957d6fa349907d028c06f335bd95da7a5bc57147d", size = 7579868, upload-time = "2026-05-13T14:56:41.618Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/da/e6edd051d2ba25adf23b120fa97f458dff888d098c51e84724f17d2d1470/torchvision-0.27.0-cp313-cp313-win_amd64.whl", hash = "sha256:aee384a2782c89517c4ab9061d2720ba59fd2ffe5ef89d0a149cc2d43abdf521", size = 4092700, upload-time = "2026-05-13T14:57:09.729Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/23/95dfa40431360f42ca949bf861434bed51164adfa8fb9801e05bf3194f50/torchvision-0.27.0-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:c5121f1b9ab09a7f73e837871deb8321551f7eaeb19d87aa00de9191968eae44", size = 1845008, upload-time = "2026-05-13T14:57:03.768Z" },
+    { url = "https://files.pythonhosted.org/packages/23/b9/9dbdf76b2b49a75ba8088df6f7c755bdb520afb6c6dbac0102b46cde5e99/torchvision-0.27.0-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:1c01f0d1091ae22b9dfc082b0a0fe5faaf053686a29b4fb082ba7691375c73cf", size = 7791430, upload-time = "2026-05-13T14:56:56.206Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/6a/e4a16cf2f3310c2ea7760dc5d9054496844391e0f4c1fae87fefac2f3d9e/torchvision-0.27.0-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:dadea3c5ecfd05bbb2a3312ab0374f213c58bf6459cb059122e2f4dfe13d10ed", size = 7668441, upload-time = "2026-05-13T14:57:02.127Z" },
+    { url = "https://files.pythonhosted.org/packages/00/70/01b6461117a6a94b5af3f8ee166bb0f045056f3cf187750c110dabfdfffa/torchvision-0.27.0-cp313-cp313t-win_amd64.whl", hash = "sha256:a49e55055a39a8506fe7e59850522cab004efb2c3839f6057658889c1d69c815", size = 4141602, upload-time = "2026-05-13T14:56:53.449Z" },
+    { url = "https://files.pythonhosted.org/packages/92/22/c0633677b3b3f3e69554a21ac087bf705f829c40cd5e3783507b8c006681/torchvision-0.27.0-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:c1fac0fc2a7adf29481fc1938a0e7845c57ba1147a986784109c4d98f434ea8c", size = 1758818, upload-time = "2026-05-13T14:56:54.988Z" },
+    { url = "https://files.pythonhosted.org/packages/48/e8/55f9d9667b56dae470e69e31beac9b00d458ea393feec1aae95cc4f3f1c9/torchvision-0.27.0-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:cbf89764fc76f3f17fbf80c12d5a89c691e91cb9d82c38412aaf0568655ffb19", size = 7789667, upload-time = "2026-05-13T14:56:48.858Z" },
+    { url = "https://files.pythonhosted.org/packages/00/bc/6f8681daf3bbc4c315bb0005110f99d28e3ecd675bf9c8f2c0d393fbac7a/torchvision-0.27.0-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:91f61b9865423037c327eb56afa207cc72de874e458c361840db9dcf5ce0c0eb", size = 7579848, upload-time = "2026-05-13T14:56:38.209Z" },
+    { url = "https://files.pythonhosted.org/packages/19/6c/8d8020e6bd1e46c53e487c9c4e9457a07f2ee28931028fb5d71e2da40adc/torchvision-0.27.0-cp314-cp314-win_amd64.whl", hash = "sha256:5bb82fc3c55daf1788621e504310b0a286f1069627a8742f692aebb075ef25a7", size = 4119284, upload-time = "2026-05-13T14:56:46.625Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/7e/e78c48662a8d551606efdbe11c6b9c1d6d2391b92cd0e4591b9e6a2412b8/torchvision-0.27.0-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:2c4099a15150143b9b034730b404a56d572efe0b79489b4c765d929cb4eac7f3", size = 1758828, upload-time = "2026-05-13T14:56:52.293Z" },
+    { url = "https://files.pythonhosted.org/packages/21/dd/d03ee9f9ee7bf11a8c7c776fb8e7fd6102f59c013791a2a4e5175bd6cba7/torchvision-0.27.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:b4c6bb0a670dcba017b3643e21902c9b8a1cc1c127d602f1488fa29ec3c6e865", size = 7790618, upload-time = "2026-05-13T14:56:44.721Z" },
+    { url = "https://files.pythonhosted.org/packages/39/08/4002336a74742be70728603ec1769feb2b55e0d19c532c9ec9f92008de76/torchvision-0.27.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:1c2db4bde82bc48ebff73436a6adf34d4f809448268a70d9a1285f5c8f92313d", size = 7580217, upload-time = "2026-05-13T14:56:43.274Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/cb/4dd4783eb3565f526ba6e64b6f6ca26c00eacc924cdfe60455db9d91b84b/torchvision-0.27.0-cp314-cp314t-win_amd64.whl", hash = "sha256:72bf547e58ddb948689734eed6f4b6a2031f979dba4fb08e3690688b392e929f", size = 4226392, upload-time = "2026-05-13T14:56:40.235Z" },
+]
+
+[[package]]
+name = "tqdm"
+version = "4.67.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/09/a9/6ba95a270c6f1fbcd8dac228323f2777d886cb206987444e4bce66338dd4/tqdm-4.67.3.tar.gz", hash = "sha256:7d825f03f89244ef73f1d4ce193cb1774a8179fd96f31d7e1dcde62092b960bb", size = 169598, upload-time = "2026-02-03T17:35:53.048Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/16/e1/3079a9ff9b8e11b846c6ac5c8b5bfb7ff225eee721825310c91b3b50304f/tqdm-4.67.3-py3-none-any.whl", hash = "sha256:ee1e4c0e59148062281c49d80b25b67771a127c85fc9676d3be5f243206826bf", size = 78374, upload-time = "2026-02-03T17:35:50.982Z" },
+]
+
+[[package]]
+name = "triton"
+version = "3.7.0"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3e/97/dcd1f2a0f8336691bff74abc59b2ed9c69a0c0f8f65cd77109c49e05f068/triton-3.7.0-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:223ac302091491436c248a34ee1e6c47a1026486579103c906ffd805be50cb89", size = 188367104, upload-time = "2026-05-07T19:04:56.68Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/c0/c2ac4fd2d8809b7579d4a820a0f9e5de62a9bc8a757ed4b3abf4f7ee964a/triton-3.7.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c631b65668d4951213b948a413c0564184305b77bb45cc9d686d3e1ecc4701a3", size = 201313191, upload-time = "2026-05-07T18:45:58.444Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/c1/5d842314bb6c78442cc60437928781701c6050b8d479bc2a1aed691d37ca/triton-3.7.0-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a9e71fc392675fac364e0ecf4ef3f76f85b7f5433a16f4c3c5fe5f05a52c85fe", size = 188480277, upload-time = "2026-05-07T19:05:03.231Z" },
+    { url = "https://files.pythonhosted.org/packages/13/31/8315ea5f8dd18e60970b3022e3a8b93fd37e0b784fbbef86e10c8e6e5ca1/triton-3.7.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:22bacffce443f54593dd20f05294d5a40622e0ea9ab632816f87154504356221", size = 201415942, upload-time = "2026-05-07T18:46:06.479Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/13/ec05adfcd87311d532ba61e3af143e8be59fcd26675884c4682841406a20/triton-3.7.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a4bf49b00a7a377a68a6da603a876e797614e6455a80e9021669c476a953ad9a", size = 188505104, upload-time = "2026-05-07T19:05:09.843Z" },
+    { url = "https://files.pythonhosted.org/packages/62/7b/468a576e35beef1426e0828e28e9ba9e65f5474d496f16ee126c15646324/triton-3.7.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8f111161d49bf903c0eaedde3962353a3d841c08a836839b7cc1025b8426efcf", size = 201457567, upload-time = "2026-05-07T18:46:13.505Z" },
+    { url = "https://files.pythonhosted.org/packages/01/e1/a59a583de59b8f62c495d67c80ee3ea97d09e91ac80c4c6e76456ed8d8ac/triton-3.7.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:abdf6beaa89b1bcfb9a43cd990536ce66091a997841a4814b260b7bee4c88c3c", size = 188503209, upload-time = "2026-05-07T19:05:17.935Z" },
+    { url = "https://files.pythonhosted.org/packages/30/b1/b7507bb9815d403927c8dd51d4158ed2e11751a92dbc118a044f247b6848/triton-3.7.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a35d7afe3f3f058e7ec49fcce09794049e0ffc5c59019ac25ec3413741b8c4e7", size = 201453566, upload-time = "2026-05-07T18:46:20.427Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/8f/0bea7a6a0c989315c9135a1d7fb37e41905cfb3a17cbc1f10044ebd4cc3a/triton-3.7.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cc1d61c172d257db80ddf42595131fb196ad2e9bdd751e90fe2ef13531734e8b", size = 188612899, upload-time = "2026-05-07T19:05:24.955Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/02/d96f57828d0912aec733b9bc7e0e7dbfd2c6f079a8fa433ac25cb93d1a30/triton-3.7.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:70fb9bbdc9f400afc54bbf6eb2670af28829a6ae3996863317964783141daf56", size = 201553816, upload-time = "2026-05-07T18:46:27.49Z" },
+    { url = "https://files.pythonhosted.org/packages/40/fb/82a802dac4689f2a2fb2e69302e6a138eecc3e175bbe976ba3cfc717683a/triton-3.7.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c4a44a8476d0d3571eac4e4d1048e1ff75aad81a09ff4602ccfc56c6dea1672e", size = 188507879, upload-time = "2026-05-07T19:05:32.209Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/af/9904ec6d3c93d9b24e5ec360445bbdf758b7f00bfbeedb89cb0eb64eb8bb/triton-3.7.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b9b85e72968a9d8bba5ddb24e9b64aaabaf48affb042f2755cb7cfa92b7531ce", size = 201460637, upload-time = "2026-05-07T18:46:34.749Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/f9/4835a8ea746b88727d8899f4e3ccce4f9cacb38abfc3bb0a638266c53111/triton-3.7.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:18a160de426fd99f92b0baf509045360afbd3bfaa0b4a5171dde800ec9f09684", size = 188608706, upload-time = "2026-05-07T19:05:39.218Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/68/fa86e5a39608000f645535b2c124920126327ab731f8c4fafd5b07ff8d4b/triton-3.7.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ce061073102714b725f3660ec6939d94a1da7984b3aa99c921417cae273672f5", size = 201546766, upload-time = "2026-05-07T18:46:42.088Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "uvicorn"
+version = "0.48.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "h11" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e6/bf/f6544ba992ddb9a6077343a576f9844f7f8f06ab819aefd00206e9255f18/uvicorn-0.48.0.tar.gz", hash = "sha256:a5504207195d08c2511bf9125ede5ac4a4b71725d519e758d01dcf0bc2d31c37", size = 91074, upload-time = "2026-05-24T12:08:41.925Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/01/be/72532be3da7acc5fdfbccdb95215cd04f995a0886532a5b423f929cda4cc/uvicorn-0.48.0-py3-none-any.whl", hash = "sha256:48097851328b87ec36117d3d575234519eb58c2b22d79666e9bbc6c49a761dad", size = 71410, upload-time = "2026-05-24T12:08:40.258Z" },
+]
+
+[package.optional-dependencies]
+standard = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "httptools" },
+    { name = "python-dotenv" },
+    { name = "pyyaml" },
+    { name = "uvloop", marker = "platform_python_implementation != 'PyPy' and sys_platform != 'cygwin' and sys_platform != 'win32'" },
+    { name = "watchfiles" },
+    { name = "websockets" },
+]
+
+[[package]]
+name = "uvloop"
+version = "0.22.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/06/f0/18d39dbd1971d6d62c4629cc7fa67f74821b0dc1f5a77af43719de7936a7/uvloop-0.22.1.tar.gz", hash = "sha256:6c84bae345b9147082b17371e3dd5d42775bddce91f885499017f4607fdaf39f", size = 2443250, upload-time = "2025-10-16T22:17:19.342Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/eb/14/ecceb239b65adaaf7fde510aa8bd534075695d1e5f8dadfa32b5723d9cfb/uvloop-0.22.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:ef6f0d4cc8a9fa1f6a910230cd53545d9a14479311e87e3cb225495952eb672c", size = 1343335, upload-time = "2025-10-16T22:16:11.43Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/ae/6f6f9af7f590b319c94532b9567409ba11f4fa71af1148cab1bf48a07048/uvloop-0.22.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:7cd375a12b71d33d46af85a3343b35d98e8116134ba404bd657b3b1d15988792", size = 742903, upload-time = "2025-10-16T22:16:12.979Z" },
+    { url = "https://files.pythonhosted.org/packages/09/bd/3667151ad0702282a1f4d5d29288fce8a13c8b6858bf0978c219cd52b231/uvloop-0.22.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ac33ed96229b7790eb729702751c0e93ac5bc3bcf52ae9eccbff30da09194b86", size = 3648499, upload-time = "2025-10-16T22:16:14.451Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/f6/21657bb3beb5f8c57ce8be3b83f653dd7933c2fd00545ed1b092d464799a/uvloop-0.22.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:481c990a7abe2c6f4fc3d98781cc9426ebd7f03a9aaa7eb03d3bfc68ac2a46bd", size = 3700133, upload-time = "2025-10-16T22:16:16.272Z" },
+    { url = "https://files.pythonhosted.org/packages/09/e0/604f61d004ded805f24974c87ddd8374ef675644f476f01f1df90e4cdf72/uvloop-0.22.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:a592b043a47ad17911add5fbd087c76716d7c9ccc1d64ec9249ceafd735f03c2", size = 3512681, upload-time = "2025-10-16T22:16:18.07Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/ce/8491fd370b0230deb5eac69c7aae35b3be527e25a911c0acdffb922dc1cd/uvloop-0.22.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:1489cf791aa7b6e8c8be1c5a080bae3a672791fcb4e9e12249b05862a2ca9cec", size = 3615261, upload-time = "2025-10-16T22:16:19.596Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/d5/69900f7883235562f1f50d8184bb7dd84a2fb61e9ec63f3782546fdbd057/uvloop-0.22.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:c60ebcd36f7b240b30788554b6f0782454826a0ed765d8430652621b5de674b9", size = 1352420, upload-time = "2025-10-16T22:16:21.187Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/73/c4e271b3bce59724e291465cc936c37758886a4868787da0278b3b56b905/uvloop-0.22.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3b7f102bf3cb1995cfeaee9321105e8f5da76fdb104cdad8986f85461a1b7b77", size = 748677, upload-time = "2025-10-16T22:16:22.558Z" },
+    { url = "https://files.pythonhosted.org/packages/86/94/9fb7fad2f824d25f8ecac0d70b94d0d48107ad5ece03769a9c543444f78a/uvloop-0.22.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:53c85520781d84a4b8b230e24a5af5b0778efdb39142b424990ff1ef7c48ba21", size = 3753819, upload-time = "2025-10-16T22:16:23.903Z" },
+    { url = "https://files.pythonhosted.org/packages/74/4f/256aca690709e9b008b7108bc85fba619a2bc37c6d80743d18abad16ee09/uvloop-0.22.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:56a2d1fae65fd82197cb8c53c367310b3eabe1bbb9fb5a04d28e3e3520e4f702", size = 3804529, upload-time = "2025-10-16T22:16:25.246Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/74/03c05ae4737e871923d21a76fe28b6aad57f5c03b6e6bfcfa5ad616013e4/uvloop-0.22.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:40631b049d5972c6755b06d0bfe8233b1bd9a8a6392d9d1c45c10b6f9e9b2733", size = 3621267, upload-time = "2025-10-16T22:16:26.819Z" },
+    { url = "https://files.pythonhosted.org/packages/75/be/f8e590fe61d18b4a92070905497aec4c0e64ae1761498cad09023f3f4b3e/uvloop-0.22.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:535cc37b3a04f6cd2c1ef65fa1d370c9a35b6695df735fcff5427323f2cd5473", size = 3723105, upload-time = "2025-10-16T22:16:28.252Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/ff/7f72e8170be527b4977b033239a83a68d5c881cc4775fca255c677f7ac5d/uvloop-0.22.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:fe94b4564e865d968414598eea1a6de60adba0c040ba4ed05ac1300de402cd42", size = 1359936, upload-time = "2025-10-16T22:16:29.436Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/c6/e5d433f88fd54d81ef4be58b2b7b0cea13c442454a1db703a1eea0db1a59/uvloop-0.22.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:51eb9bd88391483410daad430813d982010f9c9c89512321f5b60e2cddbdddd6", size = 752769, upload-time = "2025-10-16T22:16:30.493Z" },
+    { url = "https://files.pythonhosted.org/packages/24/68/a6ac446820273e71aa762fa21cdcc09861edd3536ff47c5cd3b7afb10eeb/uvloop-0.22.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:700e674a166ca5778255e0e1dc4e9d79ab2acc57b9171b79e65feba7184b3370", size = 4317413, upload-time = "2025-10-16T22:16:31.644Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/6f/e62b4dfc7ad6518e7eff2516f680d02a0f6eb62c0c212e152ca708a0085e/uvloop-0.22.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7b5b1ac819a3f946d3b2ee07f09149578ae76066d70b44df3fa990add49a82e4", size = 4426307, upload-time = "2025-10-16T22:16:32.917Z" },
+    { url = "https://files.pythonhosted.org/packages/90/60/97362554ac21e20e81bcef1150cb2a7e4ffdaf8ea1e5b2e8bf7a053caa18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e047cc068570bac9866237739607d1313b9253c3051ad84738cbb095be0537b2", size = 4131970, upload-time = "2025-10-16T22:16:34.015Z" },
+    { url = "https://files.pythonhosted.org/packages/99/39/6b3f7d234ba3964c428a6e40006340f53ba37993f46ed6e111c6e9141d18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:512fec6815e2dd45161054592441ef76c830eddaad55c8aa30952e6fe1ed07c0", size = 4296343, upload-time = "2025-10-16T22:16:35.149Z" },
+    { url = "https://files.pythonhosted.org/packages/89/8c/182a2a593195bfd39842ea68ebc084e20c850806117213f5a299dfc513d9/uvloop-0.22.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:561577354eb94200d75aca23fbde86ee11be36b00e52a4eaf8f50fb0c86b7705", size = 1358611, upload-time = "2025-10-16T22:16:36.833Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/14/e301ee96a6dc95224b6f1162cd3312f6d1217be3907b79173b06785f2fe7/uvloop-0.22.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:1cdf5192ab3e674ca26da2eada35b288d2fa49fdd0f357a19f0e7c4e7d5077c8", size = 751811, upload-time = "2025-10-16T22:16:38.275Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/02/654426ce265ac19e2980bfd9ea6590ca96a56f10c76e63801a2df01c0486/uvloop-0.22.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e2ea3d6190a2968f4a14a23019d3b16870dd2190cd69c8180f7c632d21de68d", size = 4288562, upload-time = "2025-10-16T22:16:39.375Z" },
+    { url = "https://files.pythonhosted.org/packages/15/c0/0be24758891ef825f2065cd5db8741aaddabe3e248ee6acc5e8a80f04005/uvloop-0.22.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0530a5fbad9c9e4ee3f2b33b148c6a64d47bbad8000ea63704fa8260f4cf728e", size = 4366890, upload-time = "2025-10-16T22:16:40.547Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/53/8369e5219a5855869bcee5f4d317f6da0e2c669aecf0ef7d371e3d084449/uvloop-0.22.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bc5ef13bbc10b5335792360623cc378d52d7e62c2de64660616478c32cd0598e", size = 4119472, upload-time = "2025-10-16T22:16:41.694Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/ba/d69adbe699b768f6b29a5eec7b47dd610bd17a69de51b251126a801369ea/uvloop-0.22.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1f38ec5e3f18c8a10ded09742f7fb8de0108796eb673f30ce7762ce1b8550cad", size = 4239051, upload-time = "2025-10-16T22:16:43.224Z" },
+    { url = "https://files.pythonhosted.org/packages/90/cd/b62bdeaa429758aee8de8b00ac0dd26593a9de93d302bff3d21439e9791d/uvloop-0.22.1-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3879b88423ec7e97cd4eba2a443aa26ed4e59b45e6b76aabf13fe2f27023a142", size = 1362067, upload-time = "2025-10-16T22:16:44.503Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/f8/a132124dfda0777e489ca86732e85e69afcd1ff7686647000050ba670689/uvloop-0.22.1-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:4baa86acedf1d62115c1dc6ad1e17134476688f08c6efd8a2ab076e815665c74", size = 752423, upload-time = "2025-10-16T22:16:45.968Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/94/94af78c156f88da4b3a733773ad5ba0b164393e357cc4bd0ab2e2677a7d6/uvloop-0.22.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:297c27d8003520596236bdb2335e6b3f649480bd09e00d1e3a99144b691d2a35", size = 4272437, upload-time = "2025-10-16T22:16:47.451Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/35/60249e9fd07b32c665192cec7af29e06c7cd96fa1d08b84f012a56a0b38e/uvloop-0.22.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1955d5a1dd43198244d47664a5858082a3239766a839b2102a269aaff7a4e25", size = 4292101, upload-time = "2025-10-16T22:16:49.318Z" },
+    { url = "https://files.pythonhosted.org/packages/02/62/67d382dfcb25d0a98ce73c11ed1a6fba5037a1a1d533dcbb7cab033a2636/uvloop-0.22.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b31dc2fccbd42adc73bc4e7cdbae4fc5086cf378979e53ca5d0301838c5682c6", size = 4114158, upload-time = "2025-10-16T22:16:50.517Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/7a/f1171b4a882a5d13c8b7576f348acfe6074d72eaf52cccef752f748d4a9f/uvloop-0.22.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:93f617675b2d03af4e72a5333ef89450dfaa5321303ede6e67ba9c9d26878079", size = 4177360, upload-time = "2025-10-16T22:16:52.646Z" },
+    { url = "https://files.pythonhosted.org/packages/79/7b/b01414f31546caf0919da80ad57cbfe24c56b151d12af68cee1b04922ca8/uvloop-0.22.1-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:37554f70528f60cad66945b885eb01f1bb514f132d92b6eeed1c90fd54ed6289", size = 1454790, upload-time = "2025-10-16T22:16:54.355Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/31/0bb232318dd838cad3fa8fb0c68c8b40e1145b32025581975e18b11fab40/uvloop-0.22.1-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:b76324e2dc033a0b2f435f33eb88ff9913c156ef78e153fb210e03c13da746b3", size = 796783, upload-time = "2025-10-16T22:16:55.906Z" },
+    { url = "https://files.pythonhosted.org/packages/42/38/c9b09f3271a7a723a5de69f8e237ab8e7803183131bc57c890db0b6bb872/uvloop-0.22.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:badb4d8e58ee08dad957002027830d5c3b06aea446a6a3744483c2b3b745345c", size = 4647548, upload-time = "2025-10-16T22:16:57.008Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/37/945b4ca0ac27e3dc4952642d4c900edd030b3da6c9634875af6e13ae80e5/uvloop-0.22.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b91328c72635f6f9e0282e4a57da7470c7350ab1c9f48546c0f2866205349d21", size = 4467065, upload-time = "2025-10-16T22:16:58.206Z" },
+    { url = "https://files.pythonhosted.org/packages/97/cc/48d232f33d60e2e2e0b42f4e73455b146b76ebe216487e862700457fbf3c/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:daf620c2995d193449393d6c62131b3fbd40a63bf7b307a1527856ace637fe88", size = 4328384, upload-time = "2025-10-16T22:16:59.36Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/16/c1fd27e9549f3c4baf1dc9c20c456cd2f822dbf8de9f463824b0c0357e06/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6cde23eeda1a25c75b2e07d39970f3374105d5eafbaab2a4482be82f272d5a5e", size = 4296730, upload-time = "2025-10-16T22:17:00.744Z" },
+]
+
+[[package]]
+name = "watchfiles"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/cd/41/5e1a4bb12aac5f1493fa1bdc11154eca3b258ca4eba65d39c473fe19d8e9/watchfiles-1.2.0.tar.gz", hash = "sha256:c995fba777f1ea992f090f9236e9284cf7a5d1a0130dd5a3d82c598cacd76838", size = 108252, upload-time = "2026-05-18T04:32:04.251Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0d/5a/2bf22ecb24916983bf1cc0095e7dea2741d14d6553b0d6a2ac8bc96eca93/watchfiles-1.2.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:bb68bf4df85abebe5efddc53cf2075520f243a59868d9b3973278b23e76962a9", size = 400471, upload-time = "2026-05-18T04:31:08.908Z" },
+    { url = "https://files.pythonhosted.org/packages/55/70/dea1f6a0e76607841a60fb51af150e70124864673f61704abb62b90cdcc7/watchfiles-1.2.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c16cb06dd17d43b9d185094268459eac92c9538356f050e55b54e82cf700e1d4", size = 394599, upload-time = "2026-05-18T04:30:19.845Z" },
+    { url = "https://files.pythonhosted.org/packages/18/52/752dcc7dc817baef5e89518732925795ce52e36a683a9a3c9fb68b21504e/watchfiles-1.2.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a0feab9af4c021c581f695258c642b3d10c5fd4c676e33a0d8606425d82631", size = 455458, upload-time = "2026-05-18T04:30:29.126Z" },
+    { url = "https://files.pythonhosted.org/packages/12/48/366ebbb22fcc504c2f72b45f0b7e72f40a18795cc01752c16066d597b67a/watchfiles-1.2.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a16ffe19bf5cf9f5edaa1ad1dd830c5a816e8feec430c522302ab55483a4b994", size = 460513, upload-time = "2026-05-18T04:31:40.85Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/44/1f9e1b15e7a729062e0d0c3d0d7225ea4ab98b2267ef87287153be2495fc/watchfiles-1.2.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:204f299afcbd65918ab78dbc52626b0ae45e9d8cef403fdbf33ecf9e40eac66e", size = 493616, upload-time = "2026-05-18T04:30:58.47Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/55/8b1086dcc8a1d6a697a62767bd7ea368e74c61c6fd171683cfe24a3fe5d2/watchfiles-1.2.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:11743adfa510bfffebe97659fb280182b5c9b238708f667e866f308c3430dc19", size = 573154, upload-time = "2026-05-18T04:30:37.903Z" },
+    { url = "https://files.pythonhosted.org/packages/14/7a/242f400cc77fafa7b18d53d19d9cb64fc6a6f61f28c55913bae7c674d92a/watchfiles-1.2.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eb72919d93e3a16fc451d3aa3d4b1698423daca1b382d3d959c9ac51297c12a8", size = 467046, upload-time = "2026-05-18T04:30:41.869Z" },
+    { url = "https://files.pythonhosted.org/packages/02/c8/79eee650c62d2c186598489814468e389b5def0ebe755399ff645b35b1b2/watchfiles-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b62f042afde2dde21ec1d2c1a74361e804673df86f51e418a999c9acfe671b07", size = 457100, upload-time = "2026-05-18T04:31:13.064Z" },
+    { url = "https://files.pythonhosted.org/packages/81/36/519f6dbb7a95e4fe7c1513ed25b1520295ef9905a27f1f2226a73892bfb7/watchfiles-1.2.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:027ae72bfdfd254862065d8b3e2a815c6ab9b1853ce41e6648ece84afd34a551", size = 467038, upload-time = "2026-05-18T04:30:32.915Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/12/951af6b9f89097e02511122258402cb3578443021930b70cf968d6310dc0/watchfiles-1.2.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e1cfd51e97e13ff3bd047c140764d277fc9b95b7cb5da59e46a47d167adab310", size = 632563, upload-time = "2026-05-18T04:30:11.539Z" },
+    { url = "https://files.pythonhosted.org/packages/28/cc/0cba1f0a6117b7ec117271bdc3cb3a5a252005959755a2c09a745e0942cc/watchfiles-1.2.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:24b2405c0a46738dd9e1cf7135aa5dbdb9d42d024628651b3b13d5117e99f8df", size = 660851, upload-time = "2026-05-18T04:31:53.186Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/f2/26347558cc8bf6877845e66b315f644d03c173906aa09e233a3f4fd23928/watchfiles-1.2.0-cp310-cp310-win32.whl", hash = "sha256:8c520725602756229f045b032a1ff33d7ef0f7404189d62f6c2438cb6d8ef6a1", size = 277023, upload-time = "2026-05-18T04:30:18.825Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/68/a5e67b6b68e94f4c1511d61c46c55eba0737583620b6febf194c7b9cc23f/watchfiles-1.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:03b14855c6f35539e2d95c442ae9530a75762f1e26567152b9ed05f96534a74d", size = 290107, upload-time = "2026-05-18T04:32:09.677Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/3d/8024c801df84d1587740d0359e7fdd80afeae3d159011f3d5376dd82f18e/watchfiles-1.2.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:704fd259e332e01f9b9c178f4bce9e49027e5587cc2600eeeaf8e76e1c846201", size = 400242, upload-time = "2026-05-18T04:31:19.014Z" },
+    { url = "https://files.pythonhosted.org/packages/87/5b/f4dfd45323e949984a3a7f9dc31d1cbb049921e7d98253488dda72ccdaa9/watchfiles-1.2.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:6543cf55d170003296d185c0af981f3e1311564907e1f4e08671fc7693a890a5", size = 394562, upload-time = "2026-05-18T04:30:08.46Z" },
+    { url = "https://files.pythonhosted.org/packages/98/d8/19483ef075d601c409bce8bcbb5c0f81a10876fff870400568f08ce484a1/watchfiles-1.2.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:89d8c2394a065ca86f5d2910ff263ae67c127e1376ccc4f9fc35c71db879f80a", size = 456611, upload-time = "2026-05-18T04:30:45.723Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/6a/cc81fbe7ee42f2f22e661a6e12def7807e01b14b2f39e0ff83fd373fd307/watchfiles-1.2.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:772b80df316480d894a0e3165fdd19cf77f5d17f9a787f94029465ad0e3529d1", size = 461379, upload-time = "2026-05-18T04:31:29.292Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/57/7e669002082c0a0f4fb5113bb70125f7110124b846b0a11bc5ae8e90eac1/watchfiles-1.2.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d158cd89df6053823533e06fb1d73c549133bff5f0396170c0e53d9559340717", size = 493556, upload-time = "2026-05-18T04:30:05.44Z" },
+    { url = "https://files.pythonhosted.org/packages/45/7d/f60a2b19807b21fe8281f3a8da4f59eef0d5f96825ac4680ba2d4f2ebf91/watchfiles-1.2.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d516b3283a758e087841aedb8031549fb41ced08f3db10aa6d2bf32dc042525b", size = 575255, upload-time = "2026-05-18T04:30:40.568Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/49/77f5b5e6efbcd57482f74948ebb1b97e5c0046d6b61475042d830c84b3ff/watchfiles-1.2.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:53b2290c92e0506d102cd448fbc610d87079553f86caa39d67440856a8b8bba5", size = 467052, upload-time = "2026-05-18T04:31:17.942Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/5a/73e2959af1b97fd5d556f9a8bdba017be23ceeef731869d5eaa0a753d5a3/watchfiles-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a711b51aec4370d0dcda5b6c09463206f133a5759341d7744b953a7b62e1100e", size = 456858, upload-time = "2026-05-18T04:30:30.182Z" },
+    { url = "https://files.pythonhosted.org/packages/50/57/1bc8c27fad7e6c19bddee15d276dbb6ab72480ec01c127afff1673aee417/watchfiles-1.2.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:e2ca07fa7d89195ec0865d3d285666286740bfa83d83e5cee204043a31ecc165", size = 467579, upload-time = "2026-05-18T04:32:15.897Z" },
+    { url = "https://files.pythonhosted.org/packages/09/6c/3c2e44edba3553c5e3c3b8c8a2a6dee6b9e12ae2cf4bd2378bebf9dc3038/watchfiles-1.2.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:e0618518f282c4ebff60f5e5b1247b6d91bb8b9f4476947563a1e74acc66f3c6", size = 633253, upload-time = "2026-05-18T04:31:37.123Z" },
+    { url = "https://files.pythonhosted.org/packages/30/c2/d8c84a882ab39bbefcc4915ab3e91830b7a7e990c5570b0b69075aba3faf/watchfiles-1.2.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:0d191c054d0715c3c95c99df9b8dbf6fd096d8c1e021e8f212e1bd8bc444ccb5", size = 660713, upload-time = "2026-05-18T04:31:24.62Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/07/f97736a5fc605364fe67b25e9fa4a6965dfd4840d50c406ada507e9d735f/watchfiles-1.2.0-cp311-cp311-win32.whl", hash = "sha256:9342472aff9b093c5acd4f6d8f70ae0937964ab56542502bcf5579782da69ae8", size = 277222, upload-time = "2026-05-18T04:31:21.131Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/99/2b04981977fc2608afd60360d928c6aecf6b950292ca221d98f4005f6694/watchfiles-1.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:dbd6c97045dad81227c8d040173da044c1de08de64a5ea8b555da4aee1d5fa22", size = 290274, upload-time = "2026-05-18T04:31:45.966Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/74/f7f58a7075ee9cf612b0cfcddb78b8cd8234f0742d6f0075cf0da2dde1c6/watchfiles-1.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:57a2d9fa4fb4c2ecae57b13dfff2c7ab53e21a2ba674fe9f05506680fcdcc0d7", size = 283460, upload-time = "2026-05-18T04:31:39.126Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/2f/e42c992d2afda3108ea1c02acecc991b9f31d05c14adc2a7cee9ee211fc4/watchfiles-1.2.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:bc13eb17538be00c874699dc0abe4ee2bc8d50bb1166a6b9e175ef3fd7eb8f26", size = 400115, upload-time = "2026-05-18T04:32:02.06Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/8f/6af2ea19065c91d8b0ea3516fdfc8c0d349f407e8e9fbf4e5a17360de8ad/watchfiles-1.2.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:2d95ddc1eb6914154253d239089900813f6a767e174b8e6a50e7fdacb7e4236c", size = 393659, upload-time = "2026-05-18T04:30:50.951Z" },
+    { url = "https://files.pythonhosted.org/packages/13/01/b32a967c56fb3e3e5be3db52c3d3b87fa4513aa367d8ed1ad96d42952e5f/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8f70d8b291ef6e88d19b1f297a6905ddb978888d9272b0d05e6f53309856bcfc", size = 453207, upload-time = "2026-05-18T04:31:04.231Z" },
+    { url = "https://files.pythonhosted.org/packages/04/98/97557a812180338cb1abd32e1cffcc4588f59b5f23e0cb006b2ba95ba64a/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:56d8641cf834c2836922899105bd3ce3d0dfc69291d52edf0b4d0436829b34c0", size = 459273, upload-time = "2026-05-18T04:31:50.377Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/a8/b4b08dcb7653b8087c6586f7ce649505900e866bbcfe40dc9587af02e686/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2581a94056e55d7d0a31a823ea92bf73749c489ca2285bfdc0fbe6b2bb49d50c", size = 489927, upload-time = "2026-05-18T04:31:42.485Z" },
+    { url = "https://files.pythonhosted.org/packages/50/94/3dceea03545d2e5ddfd839f0ddd5e1cecbf1697b5a428d5ba11cef6af95d/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:41bc1199f7523b3f82843c88cbb979180c949caef0342cf90968f178e5d49b01", size = 570476, upload-time = "2026-05-18T04:31:03.071Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/f2/d39a5450c3532092b91f81d274360e613c2371bc874a89c7a1a3c5e8d138/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7571e4464cb6e434958f867f7f730b8ab0b75e3f8e5eac0499168486ab3c33a8", size = 465650, upload-time = "2026-05-18T04:30:12.701Z" },
+    { url = "https://files.pythonhosted.org/packages/22/24/ed72f68cbc1333ca9b9f2200aa048bb6658ae41709bc1caad4310f4bdffd/watchfiles-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e53a384f76b631c3ae5334ce6a52f0baa3a911eb94a4eac7f160079868b716d5", size = 456398, upload-time = "2026-05-18T04:30:13.784Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/64/982ef4a4e5bab5b6e5b6becc8cd5e732f6130a78b855f0abec6439a9a135/watchfiles-1.2.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:d20029a60a71a052a24c4db7673bc4de39ab89adbaccbfb5d67987c5d73f424d", size = 465140, upload-time = "2026-05-18T04:31:52.111Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/0c/95282abf4ed680b6096010bcfc30c5fa7a041fc5aa5a2ad17a2cc6c75bba/watchfiles-1.2.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:2cb93af48550faf1cea04c303107c8b75833de7013e57ce27d3b8d21d8d0f58c", size = 630259, upload-time = "2026-05-18T04:31:25.676Z" },
+    { url = "https://files.pythonhosted.org/packages/30/45/607c1de1530c4bdcf2cf1d1ecc2505ddba5d96bd43ba9f2b0e79876f850f/watchfiles-1.2.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:2995c176de7692b86a2e4c58d9ec718f753150a979cb4a754e2b4ffa38e70906", size = 659859, upload-time = "2026-05-18T04:30:24.333Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/08/d9e2e0f9e8e6791d33aefc694ad7eefa7f901f63caff84a81ded38692f9c/watchfiles-1.2.0-cp312-cp312-win32.whl", hash = "sha256:7a2cffd17d27d2ecbb310c2b1d8174f222a5495b1a721894afa88ec11e25b898", size = 275480, upload-time = "2026-05-18T04:30:31.307Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/e6/9d42569c0102645cc8cea5d8c7d8a1e9d4ada2cb7f05f75e554b8aa2202a/watchfiles-1.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:f155b3a1b2a5fc89cdc70d47ee5d54e3b75e88efa34982028a35daef9ba00379", size = 288718, upload-time = "2026-05-18T04:32:10.745Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/26/88e0dc6ee3898169d7fa22bb6a69cabf2502d2ee25cb8c876d1262d204f8/watchfiles-1.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:8fa585ede612ee9f9e91b18bebf9ba11b9ae29a4e3a0d0cf6fca3e382133f0d5", size = 281026, upload-time = "2026-05-18T04:30:22.23Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/4d/70a7feced9f87e2ff26dba42667290f41694fc64646c67261fbb8cab5d5c/watchfiles-1.2.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:01ea8d66f0693b9b60a6541c8d10263091ca9a9060d242f3c1f3143f9aad2c98", size = 399730, upload-time = "2026-05-18T04:31:38.162Z" },
+    { url = "https://files.pythonhosted.org/packages/31/3a/0da302f2307aee316922806ebd5726c542cbd787c938271cf14a074c7daf/watchfiles-1.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7ba0480b9a74af058f43b337e937a451e109295c420916d68ad24e3dc02f5e44", size = 392842, upload-time = "2026-05-18T04:30:27.051Z" },
+    { url = "https://files.pythonhosted.org/packages/db/ef/d5bdb705c224dbc256aa0c1ec47bf4e61ec52558f2afb44a71a1fe4d7015/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4f34e26a19f91f710c08e0183429f0d1d15df734e6bc78c31e77b9ea9c433658", size = 452989, upload-time = "2026-05-18T04:31:11.945Z" },
+    { url = "https://files.pythonhosted.org/packages/71/29/5495f2c1661949ef7a35e4d71111d129cfe7606414a26887a919d0a55406/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b4e77f6a55f858504069abd35d336a637555c09bca453dde1ee1e5ada8a6a1fb", size = 458978, upload-time = "2026-05-18T04:30:52.606Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/8c/7f9c07c433811c2fffd93e13fdfb7135de9aab5f2ae41be08960fa0047dc/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0cb4d80e212f116474a545c21c912b445f16bb0cef9e6a73a498164223e14e2f", size = 490248, upload-time = "2026-05-18T04:31:36.003Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/11/d93632febc52fbc21be90231bb7c17fd5387f46c9076fd40a5f9c2ae6910/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b974946a10af379d425e2eef5b62f5c6ebeaccf91d45eaad6f5b27ecd4f91aa0", size = 571847, upload-time = "2026-05-18T04:31:10.862Z" },
+    { url = "https://files.pythonhosted.org/packages/55/b4/383173e73aabb07ad1d9c7aa859d95437ac46a6d6a1e11005facda0c9d19/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:86bc13c25a8d1fcd70b51d0ce7c9b65e90de5666fcbfd3e34957cc73ee19aeb5", size = 465974, upload-time = "2026-05-18T04:30:17.006Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/6c/89b1a230a78f57c52dd8893adb1f92f94411721b6ec12596c56d98c74356/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca148d73dea36c9763aaa351e4d7a51780ec1584217c45276f4fe8239c768b71", size = 454782, upload-time = "2026-05-18T04:30:35.656Z" },
+    { url = "https://files.pythonhosted.org/packages/24/62/1732118367cfff0a9fce3bf62ff4bfded09ef5df21d9d446b858b3f70a96/watchfiles-1.2.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:c525543d91961c6955b2636b308569e84a1d1c5f5f2932041ab9ef46422f43e3", size = 465182, upload-time = "2026-05-18T04:30:20.846Z" },
+    { url = "https://files.pythonhosted.org/packages/28/96/716f7e5f51339bf22963f3345f9f27d7f3b30e2eadc597e257c881dd3c53/watchfiles-1.2.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:a204794696ffb8f9b10fba6f7cb5216d42f3b2b71860ccac6b6e42f5f10973b0", size = 629841, upload-time = "2026-05-18T04:31:05.397Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/fe/c40783950fd771ccf66ab3ec2722d188a9af1c7f96c6e811f36e40c6e03f/watchfiles-1.2.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:10d86db20695afe7997ac9e1717637d6714a8d0220458c33f3d2061f54cec427", size = 658028, upload-time = "2026-05-18T04:31:48.22Z" },
+    { url = "https://files.pythonhosted.org/packages/71/72/4508db1856d1d87fcbb3b63f4839bab1b5682cb0e8d224d122263c09654a/watchfiles-1.2.0-cp313-cp313-win32.whl", hash = "sha256:eb283ee99e21ad6443c8cdb06ac5b34b1308c329cbdf03fa02b445363714c799", size = 275183, upload-time = "2026-05-18T04:30:59.57Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/36/14b76ca57652e5cc5fd1c11f32a261292c08a0d19a00351013c2549cbfb2/watchfiles-1.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:a0f27f01bee51861392bb6b7c4fdb290b27d1eb194e9e28788d68102a0e898d9", size = 288059, upload-time = "2026-05-18T04:32:07.937Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/8d/0a85e395398d8d20fadfe5c5d32c726eee17a519e78fb356f2cf7531bffe/watchfiles-1.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:3651aa7058595e9cfb75d35dd5ada2bf9f48a5b8a0f3562821d3e210c507e077", size = 280186, upload-time = "2026-05-18T04:31:54.484Z" },
+    { url = "https://files.pythonhosted.org/packages/37/68/36db056f1fdcc5f07302f56e631774d6835bcd6fa3ace402304621d5f9e5/watchfiles-1.2.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:faea288b6f0ab1902ef08f4ca6de005dccf856c4e0c4f21b8c5fce02d90a1b08", size = 399031, upload-time = "2026-05-18T04:30:44.576Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/64/01a9d6f66a82a5c101ce939274106cc72759d62427e153f01edd2b9f87c2/watchfiles-1.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:01859b11fd9fbca670f4d5da00fbac282cfea9bd67a2125d8b2833a3b5617ea9", size = 391205, upload-time = "2026-05-18T04:30:25.413Z" },
+    { url = "https://files.pythonhosted.org/packages/84/2c/0a44fe058cb4bb7b8ede6b6670698bbb7c0400740e378d00022189b7b31d/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fff610d7bb2256a317bb1e96f0d7862c7aa8076733ee5df0fd41bbe76a24a4f4", size = 451892, upload-time = "2026-05-18T04:32:14.005Z" },
+    { url = "https://files.pythonhosted.org/packages/67/a1/351e0d56cd35e6488b5c8b4fb11a809a5bc923e8fe8fed9faf8920be0c89/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b141a4891c995a039cd89e9a49e62df1dc8a559a5d1a6e4c7106d16c12777a55", size = 458867, upload-time = "2026-05-18T04:31:22.279Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/7d/9d09605187f1b838998624049fcf8bf47b73c1a3b76901fcac1782f62277/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f22943b7770483f6ea0721c6b11d022947a98eb0acae14694de034f4d0d38925", size = 490217, upload-time = "2026-05-18T04:31:43.657Z" },
+    { url = "https://files.pythonhosted.org/packages/60/5d/a17a16eccb182f04188cd308ec24b1a71a9b5c4e7098269cf35d9fa56d02/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1bc6195825b7dcd217968bb1f801a60fd4c16e8eeab5bedc7fe917d7d5995ab4", size = 571458, upload-time = "2026-05-18T04:32:11.875Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/3d/4dd457062083ab1938e5dfd45032eb425cee2ac817287ca8ff4356183e5d/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d4a4b147f5dca2a5d325a06a832fb43f345751adfbc63204aec30e0d9ca965a2", size = 464707, upload-time = "2026-05-18T04:30:43.492Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/71/ea8c57b128f5383de74d0c7d2d9c57ad7c9a65a930c451bd25d524b295b7/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4543579a9bdb0c9560039b4ffddbdb39545707659fbc430ce4c10f3f68d557f9", size = 454663, upload-time = "2026-05-18T04:30:16.061Z" },
+    { url = "https://files.pythonhosted.org/packages/53/fd/2e812bf938406d7db351f0703ddd3fc6c061cf30d96153a77bc79a943a44/watchfiles-1.2.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:20aa0e708b920bde876a4aa82dc7dd6ebea228a63a67cda6632c2fc87b787efa", size = 463537, upload-time = "2026-05-18T04:31:44.9Z" },
+    { url = "https://files.pythonhosted.org/packages/86/56/d17a7f1dd1bc3035f1072694a551301272f1739c2d8e319c927cb9e29b38/watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:d413349d565dab74297f2a63e84a097936be69bf8f3b3801f27f380e32040f44", size = 629194, upload-time = "2026-05-18T04:31:14.141Z" },
+    { url = "https://files.pythonhosted.org/packages/be/06/f1ff66bf5cae50aa4062779a0ecd0bbaf15e466195719074078947d9a17d/watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f28b2725eb8cce327b9b3ab02415c853011dc55c95832fe90de6bc56f5315f72", size = 656194, upload-time = "2026-05-18T04:31:47.14Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/54/a9c7ea9a82a4ac65e7004c0a03920b5cdd2f9c3b678757d9cd425aa51d53/watchfiles-1.2.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:b8c8358484d5fa12ef34f05b7f4168eaf1932f408725ff6d023c33ec17bd79d4", size = 400205, upload-time = "2026-05-18T04:32:05.153Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/5d/c9ab3534374a4a67450696905d6ef16a04405448b8dc52bd752ae50423d4/watchfiles-1.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:9f04b092229ad2c50126dd3c922c8822e51e605993764a33058d4a791ab42281", size = 392508, upload-time = "2026-05-18T04:30:54.849Z" },
+    { url = "https://files.pythonhosted.org/packages/26/ca/1ad30103535cf0cecd7b993e8d50edc5351b1820e38f2d22e3df58962feb/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7a7ce236284f002a156f70add88efe5c70879cccbb658be0822c54b1306fc09d", size = 452448, upload-time = "2026-05-18T04:30:53.727Z" },
+    { url = "https://files.pythonhosted.org/packages/37/a1/ceee2cdf2afbd715fa07758d39c9859513eae411b23196f7fd039e5feedd/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b9909cc2b48468b575eefa944919e1fe8a36c5849d5c7c168f80a8c1db69398e", size = 459605, upload-time = "2026-05-18T04:30:23.312Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/f6/421e30fd1cb3907a84ed92ab3f1983e37ba2dca015e9a894a048418417a2/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0a37faaed405c67e28e6be45a1fa4f206ef5a2860f27c237db9fa30704c38242", size = 490757, upload-time = "2026-05-18T04:30:47.358Z" },
+    { url = "https://files.pythonhosted.org/packages/41/b0/55ed1b97ed08be7bba6f9a541cac15f2a858e1d74d2b07b6da70a82aab00/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9649193aa27bd9ff2e80ff29bfaa93085496c7a3a377592823cc58b77ee88add", size = 568672, upload-time = "2026-05-18T04:30:38.915Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/cf/d8ae8a80dd7bafab395ea7681c10237311bbf34d37704a8c744e7cf31fc7/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e4ff8e37f99cf1da89e255e07c9c4b37c214038c4283707bdec308cb1b0ea1f", size = 464197, upload-time = "2026-05-18T04:30:09.914Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/8a/3076c496ca8dafe0e8cd03fcebdfc47be4b1174b4e5b24ff6e396e6b3af2/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:054dc20fd2e3132b4c3883b4a00d72fd6e1f56fdaf89fccd12e8057d74cd74d7", size = 453181, upload-time = "2026-05-18T04:30:14.829Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/10/9745e17c98e7b8a86454df0a3c7b5686bd650383f1e9f26e4ebcbd6cc0c0/watchfiles-1.2.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:e140ed30ebde76796b686e67c182cff10ea2fbab186fafd1560f74bb5a473a6e", size = 465109, upload-time = "2026-05-18T04:30:28.123Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/95/8ef4a95481d3e0cb52d62a06fa6e972e81424be2d9698b91a2fecca9904c/watchfiles-1.2.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:bb7e52ecf68ba46d22df23467b87cffeb2146908aa523ebfe803019618cfda06", size = 630653, upload-time = "2026-05-18T04:31:49.304Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/e4/3b3bf36b0f829b50c6ebcb8d031583863c59f923d6a6af3d485e470d0fac/watchfiles-1.2.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:23282a321c8baf9b3a3c4afff673f9fe65eb7fdc2338d765ccad9d3d1916a5ba", size = 657838, upload-time = "2026-05-18T04:31:06.497Z" },
+    { url = "https://files.pythonhosted.org/packages/21/b1/6cbbb50c1f3002ab568777d44aa21206dfb8807a840990c4037523b51812/watchfiles-1.2.0-cp314-cp314-win32.whl", hash = "sha256:c0db965c5f79aa49fe672d297cf1febc5ad149b658594944f49a54a2b96270a7", size = 275108, upload-time = "2026-05-18T04:30:06.891Z" },
+    { url = "https://files.pythonhosted.org/packages/92/45/190ce6db8dcb4536682cf75d3889ff1a27182a58cb519d343cb6d9ea63d8/watchfiles-1.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:71283b39fd17e5408eb123bd37aeecfd9d54c81fc184421943208aadb879d103", size = 288441, upload-time = "2026-05-18T04:32:12.901Z" },
+    { url = "https://files.pythonhosted.org/packages/74/0d/3eae1c2313ab08378431d907c3f8095ecca00f3eda33111cf4f0f2591799/watchfiles-1.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:c5c19526f4e54a00f2666a6c0e9e40d582c09e865055ea7378bf0009aab857b3", size = 280684, upload-time = "2026-05-18T04:31:26.902Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/75/fb64e6c25d6b5ca636d03df34ffb1c6e9873303e76d27967e045f8df088f/watchfiles-1.2.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:d73a585accffa5ae39c17264c36ec3166d2fad7000c780f5ef83b2722afb9dd2", size = 398857, upload-time = "2026-05-18T04:32:17.108Z" },
+    { url = "https://files.pythonhosted.org/packages/73/4e/9f7adf01754cbf81843722ccfec169d8f26c69778281a302855cecd2ee08/watchfiles-1.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ae99b14c5f21e026e0e9d96f40e07d8570ebee6cafd9d8fc318354606daa7a28", size = 392413, upload-time = "2026-05-18T04:31:07.911Z" },
+    { url = "https://files.pythonhosted.org/packages/47/c8/bec626bcc2d69f44b9acb24ce7d60ed7b16b73628eea747fcbd169d8edda/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4429f3b105524a10b72c3a819b091c495d2811d419c1e1e8df773a5a5974f831", size = 452409, upload-time = "2026-05-18T04:31:20.142Z" },
+    { url = "https://files.pythonhosted.org/packages/00/b7/b6362068e81e7c556d155a34c35d40ac3ef42d747b06d7f6e5bf58e359c2/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:43d818978d06062d9b22c4fab2ebe44cf5213d42dc8e62bda8c2760cfa2eeb33", size = 458827, upload-time = "2026-05-18T04:32:06.219Z" },
+    { url = "https://files.pythonhosted.org/packages/67/f8/9a813fa42afb1e0b4625e75f0479826644d3ee8dc287e093799bc01f390c/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b9f732dc58b2dbe69e464ccf8fff7a03b0dd0be439da4c0720d3558527d3d6b4", size = 490104, upload-time = "2026-05-18T04:31:56.034Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/bf/27dfb6094ca4c9aad21298b5525b6c53cb36121ee454331d05161e58d130/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8f200104103feb097de4cab8fe4f5dd18a2026934c7dea98c55a2f5fd6d5a33b", size = 571360, upload-time = "2026-05-18T04:31:57.133Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/39/44a096d67270ea93df91d33877dbe91fbda3aa4f8ec2edf799d93eda8736/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:63ac26eefbf4af1741247d6fb68b11c49a25b2f7413fbd318a83a12aaa9cf666", size = 464644, upload-time = "2026-05-18T04:30:57.33Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/80/c7472203bad6268e3ef1ad260739704847898938ad7ea8b63a5131f46b50/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c4997d4e4a55f0d02b6cde327322daf3a0400e5df6c6b15948994bf72497925", size = 454771, upload-time = "2026-05-18T04:30:48.736Z" },
+    { url = "https://files.pythonhosted.org/packages/51/cf/3b10b268b4b7f0fc26e9debb5eef1998b515887840f444cd3ec80c688755/watchfiles-1.2.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:4c887eba18b7945ac73067a8b4a66f21cd46c2539b2bc68588f7be6c7eb6d26b", size = 463494, upload-time = "2026-05-18T04:31:33.826Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/3e/a4302545cd589262a0dc7d140e86f7688eba3f9c72776c27f7e23b8864c4/watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:3416ff151bb6b5a8d8d11664974fbef4d9305b9b2957839ab5a270468fd8df30", size = 629383, upload-time = "2026-05-18T04:31:15.596Z" },
+    { url = "https://files.pythonhosted.org/packages/db/99/d5649df0a9a410d45b7c882304d0b790903ac9b6e8f2cfd12114e0c6b9f2/watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:0e831a271c035d89789cffc386b6aa1375f39f1cd25eb7ca0997e4970d152fc5", size = 656093, upload-time = "2026-05-18T04:31:58.707Z" },
+    { url = "https://files.pythonhosted.org/packages/92/b9/362702539275019a54dd2e94511b31a9b89c5f9e6a21966de7eb692549fc/watchfiles-1.2.0-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:37a6721cdf3f65dbb13aa9503510ccb4451603ac837e44d265d7992a597e1374", size = 400109, upload-time = "2026-05-18T04:31:16.879Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/75/71d5ba62db781e5587bded1d944c675374bc4aa37ff33d5018d98e8b6538/watchfiles-1.2.0-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:2b37d10b5a63bd4d87e18472d80fa525bd670586fae62e5dd580452764879b65", size = 392167, upload-time = "2026-05-18T04:31:28.058Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/01/c66dd95d0423fe30d31820e2d1d5bda773764131bbb6ac0cb1cf303ac328/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a105bc2283f67e8fbec74253ec2d94925de92ed72c0393f1206bf326b7b7b69", size = 452372, upload-time = "2026-05-18T04:31:00.836Z" },
+    { url = "https://files.pythonhosted.org/packages/91/15/2fe99557e72f85627c6a8eed50d889e8d101623e060a22ad75b875cb932d/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5327989a465505f05cfe06f04fa9d0c2fd5432bb243e10e6f012b1bdca3c8579", size = 459596, upload-time = "2026-05-18T04:31:34.96Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/23/d4acfa0023367428ed48351b3b9b267893037b6cadae55620c61c24bcfd4/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ecb47f183a8025b2aa18b546725c3657e542112ae9c0613a2af79b4fa8d04ad7", size = 490869, upload-time = "2026-05-18T04:31:59.923Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/5f/3164cbdce06c9fb95c4f7b9e2f9760b5e2797af43a9ecc317ef42a23a278/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8520a4ab0e37f770afc34459c4f8f7019e153f9124dc101c15538365875d1ab2", size = 571641, upload-time = "2026-05-18T04:32:00.948Z" },
+    { url = "https://files.pythonhosted.org/packages/41/e6/85d3731c55e65cd7690f3f803d24c139588aaf863e4bf2148fe7a7fa1a19/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:71cd71740ed2c15211ebb237ced4e39a1cdf6f80566e5fe95428da1626f4fde6", size = 464444, upload-time = "2026-05-18T04:30:34.298Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/7d/562641012b8b09872742c3b8adf9629ec479fd78f8d68ae4a0c13da8add6/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f88af53d6ddaf72179ef613ddc905e6f4785f712b49b80b3bef9f3525e6194b4", size = 453593, upload-time = "2026-05-18T04:31:23.464Z" },
+    { url = "https://files.pythonhosted.org/packages/56/fe/cb8ef3d6f929d14158fdaaad9925985b7310abc9384dcd4d82dd0016fb59/watchfiles-1.2.0-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:cee9d5efd929efdac5f7e58f72b3376f676b64050a91c5b99a7094c5b2317488", size = 465096, upload-time = "2026-05-18T04:31:30.384Z" },
+    { url = "https://files.pythonhosted.org/packages/25/91/80908e835e100527a9267147b08c0eee1fa6ab0ffec15edc04d1d44885f7/watchfiles-1.2.0-cp315-cp315-musllinux_1_1_aarch64.whl", hash = "sha256:b718bf356bbc15e559bd8ef41782b573b8ae0e3f177ab244b440568d7ea02cfb", size = 630638, upload-time = "2026-05-18T04:30:49.89Z" },
+    { url = "https://files.pythonhosted.org/packages/46/4b/95ab2f256bb4af3cb2eb23b9317bda984ee6e0f11733a5c004a6c95b06e3/watchfiles-1.2.0-cp315-cp315-musllinux_1_1_x86_64.whl", hash = "sha256:922c0e019fe68b3ae392965a766b02a71ba1168c932cebc3733cd52c5fe5b377", size = 657684, upload-time = "2026-05-18T04:31:32.027Z" },
+    { url = "https://files.pythonhosted.org/packages/23/f4/7513ef1e85fc4c6331b59479d6d72661fc391fbe543678052ac72c8b6c19/watchfiles-1.2.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:4674d49eb94706dfe666c069fc0a1b646ffcf920473492e209f6d5f60d3f0cc2", size = 403050, upload-time = "2026-05-18T04:30:36.753Z" },
+    { url = "https://files.pythonhosted.org/packages/27/0b/a54103cfd732bb703c7a749222011a0483ef3705948dae3b203158601119/watchfiles-1.2.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:094b9b70103d4e963499bdea001ee3c2697b144cd9ae6218a62c0f89ec9e31db", size = 396629, upload-time = "2026-05-18T04:32:03.268Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/2c/73f31a3b893886206c3f54d73e8ad8dee58cdb2f69ad2622e0a8a9e07f4e/watchfiles-1.2.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b0ef001f8c25ad0fa9529f914c1600647ecd0f542d11c19b7894768c67b6acb7", size = 457318, upload-time = "2026-05-18T04:31:01.932Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/f9/45d021e4a5cc7b9dd567f7cbb06d3b75f751a690063fb6cc7ec60f4e46b7/watchfiles-1.2.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a88fc94e647bc4eec523f1caa540258eb71d14278b9daf72fa1e2658a98df0f0", size = 457771, upload-time = "2026-05-18T04:30:56.331Z" },
+]
+
+[[package]]
+name = "websockets"
+version = "16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/04/24/4b2031d72e840ce4c1ccb255f693b15c334757fc50023e4db9537080b8c4/websockets-16.0.tar.gz", hash = "sha256:5f6261a5e56e8d5c42a4497b364ea24d94d9563e8fbd44e78ac40879c60179b5", size = 179346, upload-time = "2026-01-10T09:23:47.181Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/20/74/221f58decd852f4b59cc3354cccaf87e8ef695fede361d03dc9a7396573b/websockets-16.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:04cdd5d2d1dacbad0a7bf36ccbcd3ccd5a30ee188f2560b7a62a30d14107b31a", size = 177343, upload-time = "2026-01-10T09:22:21.28Z" },
+    { url = "https://files.pythonhosted.org/packages/19/0f/22ef6107ee52ab7f0b710d55d36f5a5d3ef19e8a205541a6d7ffa7994e5a/websockets-16.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:8ff32bb86522a9e5e31439a58addbb0166f0204d64066fb955265c4e214160f0", size = 175021, upload-time = "2026-01-10T09:22:22.696Z" },
+    { url = "https://files.pythonhosted.org/packages/10/40/904a4cb30d9b61c0e278899bf36342e9b0208eb3c470324a9ecbaac2a30f/websockets-16.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:583b7c42688636f930688d712885cf1531326ee05effd982028212ccc13e5957", size = 175320, upload-time = "2026-01-10T09:22:23.94Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/2f/4b3ca7e106bc608744b1cdae041e005e446124bebb037b18799c2d356864/websockets-16.0-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:7d837379b647c0c4c2355c2499723f82f1635fd2c26510e1f587d89bc2199e72", size = 183815, upload-time = "2026-01-10T09:22:25.469Z" },
+    { url = "https://files.pythonhosted.org/packages/86/26/d40eaa2a46d4302becec8d15b0fc5e45bdde05191e7628405a19cf491ccd/websockets-16.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:df57afc692e517a85e65b72e165356ed1df12386ecb879ad5693be08fac65dde", size = 185054, upload-time = "2026-01-10T09:22:27.101Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/ba/6500a0efc94f7373ee8fefa8c271acdfd4dca8bd49a90d4be7ccabfc397e/websockets-16.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:2b9f1e0d69bc60a4a87349d50c09a037a2607918746f07de04df9e43252c77a3", size = 184565, upload-time = "2026-01-10T09:22:28.293Z" },
+    { url = "https://files.pythonhosted.org/packages/04/b4/96bf2cee7c8d8102389374a2616200574f5f01128d1082f44102140344cc/websockets-16.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:335c23addf3d5e6a8633f9f8eda77efad001671e80b95c491dd0924587ece0b3", size = 183848, upload-time = "2026-01-10T09:22:30.394Z" },
+    { url = "https://files.pythonhosted.org/packages/02/8e/81f40fb00fd125357814e8c3025738fc4ffc3da4b6b4a4472a82ba304b41/websockets-16.0-cp310-cp310-win32.whl", hash = "sha256:37b31c1623c6605e4c00d466c9d633f9b812ea430c11c8a278774a1fde1acfa9", size = 178249, upload-time = "2026-01-10T09:22:32.083Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/5f/7e40efe8df57db9b91c88a43690ac66f7b7aa73a11aa6a66b927e44f26fa/websockets-16.0-cp310-cp310-win_amd64.whl", hash = "sha256:8e1dab317b6e77424356e11e99a432b7cb2f3ec8c5ab4dabbcee6add48f72b35", size = 178685, upload-time = "2026-01-10T09:22:33.345Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/db/de907251b4ff46ae804ad0409809504153b3f30984daf82a1d84a9875830/websockets-16.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:31a52addea25187bde0797a97d6fc3d2f92b6f72a9370792d65a6e84615ac8a8", size = 177340, upload-time = "2026-01-10T09:22:34.539Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/fa/abe89019d8d8815c8781e90d697dec52523fb8ebe308bf11664e8de1877e/websockets-16.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:417b28978cdccab24f46400586d128366313e8a96312e4b9362a4af504f3bbad", size = 175022, upload-time = "2026-01-10T09:22:36.332Z" },
+    { url = "https://files.pythonhosted.org/packages/58/5d/88ea17ed1ded2079358b40d31d48abe90a73c9e5819dbcde1606e991e2ad/websockets-16.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:af80d74d4edfa3cb9ed973a0a5ba2b2a549371f8a741e0800cb07becdd20f23d", size = 175319, upload-time = "2026-01-10T09:22:37.602Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/ae/0ee92b33087a33632f37a635e11e1d99d429d3d323329675a6022312aac2/websockets-16.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:08d7af67b64d29823fed316505a89b86705f2b7981c07848fb5e3ea3020c1abe", size = 184631, upload-time = "2026-01-10T09:22:38.789Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/c5/27178df583b6c5b31b29f526ba2da5e2f864ecc79c99dae630a85d68c304/websockets-16.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7be95cfb0a4dae143eaed2bcba8ac23f4892d8971311f1b06f3c6b78952ee70b", size = 185870, upload-time = "2026-01-10T09:22:39.893Z" },
+    { url = "https://files.pythonhosted.org/packages/87/05/536652aa84ddc1c018dbb7e2c4cbcd0db884580bf8e95aece7593fde526f/websockets-16.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d6297ce39ce5c2e6feb13c1a996a2ded3b6832155fcfc920265c76f24c7cceb5", size = 185361, upload-time = "2026-01-10T09:22:41.016Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/e2/d5332c90da12b1e01f06fb1b85c50cfc489783076547415bf9f0a659ec19/websockets-16.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:1c1b30e4f497b0b354057f3467f56244c603a79c0d1dafce1d16c283c25f6e64", size = 184615, upload-time = "2026-01-10T09:22:42.442Z" },
+    { url = "https://files.pythonhosted.org/packages/77/fb/d3f9576691cae9253b51555f841bc6600bf0a983a461c79500ace5a5b364/websockets-16.0-cp311-cp311-win32.whl", hash = "sha256:5f451484aeb5cafee1ccf789b1b66f535409d038c56966d6101740c1614b86c6", size = 178246, upload-time = "2026-01-10T09:22:43.654Z" },
+    { url = "https://files.pythonhosted.org/packages/54/67/eaff76b3dbaf18dcddabc3b8c1dba50b483761cccff67793897945b37408/websockets-16.0-cp311-cp311-win_amd64.whl", hash = "sha256:8d7f0659570eefb578dacde98e24fb60af35350193e4f56e11190787bee77dac", size = 178684, upload-time = "2026-01-10T09:22:44.941Z" },
+    { url = "https://files.pythonhosted.org/packages/84/7b/bac442e6b96c9d25092695578dda82403c77936104b5682307bd4deb1ad4/websockets-16.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:71c989cbf3254fbd5e84d3bff31e4da39c43f884e64f2551d14bb3c186230f00", size = 177365, upload-time = "2026-01-10T09:22:46.787Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/fe/136ccece61bd690d9c1f715baaeefd953bb2360134de73519d5df19d29ca/websockets-16.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:8b6e209ffee39ff1b6d0fa7bfef6de950c60dfb91b8fcead17da4ee539121a79", size = 175038, upload-time = "2026-01-10T09:22:47.999Z" },
+    { url = "https://files.pythonhosted.org/packages/40/1e/9771421ac2286eaab95b8575b0cb701ae3663abf8b5e1f64f1fd90d0a673/websockets-16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:86890e837d61574c92a97496d590968b23c2ef0aeb8a9bc9421d174cd378ae39", size = 175328, upload-time = "2026-01-10T09:22:49.809Z" },
+    { url = "https://files.pythonhosted.org/packages/18/29/71729b4671f21e1eaa5d6573031ab810ad2936c8175f03f97f3ff164c802/websockets-16.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:9b5aca38b67492ef518a8ab76851862488a478602229112c4b0d58d63a7a4d5c", size = 184915, upload-time = "2026-01-10T09:22:51.071Z" },
+    { url = "https://files.pythonhosted.org/packages/97/bb/21c36b7dbbafc85d2d480cd65df02a1dc93bf76d97147605a8e27ff9409d/websockets-16.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e0334872c0a37b606418ac52f6ab9cfd17317ac26365f7f65e203e2d0d0d359f", size = 186152, upload-time = "2026-01-10T09:22:52.224Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/34/9bf8df0c0cf88fa7bfe36678dc7b02970c9a7d5e065a3099292db87b1be2/websockets-16.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a0b31e0b424cc6b5a04b8838bbaec1688834b2383256688cf47eb97412531da1", size = 185583, upload-time = "2026-01-10T09:22:53.443Z" },
+    { url = "https://files.pythonhosted.org/packages/47/88/4dd516068e1a3d6ab3c7c183288404cd424a9a02d585efbac226cb61ff2d/websockets-16.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:485c49116d0af10ac698623c513c1cc01c9446c058a4e61e3bf6c19dff7335a2", size = 184880, upload-time = "2026-01-10T09:22:55.033Z" },
+    { url = "https://files.pythonhosted.org/packages/91/d6/7d4553ad4bf1c0421e1ebd4b18de5d9098383b5caa1d937b63df8d04b565/websockets-16.0-cp312-cp312-win32.whl", hash = "sha256:eaded469f5e5b7294e2bdca0ab06becb6756ea86894a47806456089298813c89", size = 178261, upload-time = "2026-01-10T09:22:56.251Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/f0/f3a17365441ed1c27f850a80b2bc680a0fa9505d733fe152fdf5e98c1c0b/websockets-16.0-cp312-cp312-win_amd64.whl", hash = "sha256:5569417dc80977fc8c2d43a86f78e0a5a22fee17565d78621b6bb264a115d4ea", size = 178693, upload-time = "2026-01-10T09:22:57.478Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/9c/baa8456050d1c1b08dd0ec7346026668cbc6f145ab4e314d707bb845bf0d/websockets-16.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:878b336ac47938b474c8f982ac2f7266a540adc3fa4ad74ae96fea9823a02cc9", size = 177364, upload-time = "2026-01-10T09:22:59.333Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/0c/8811fc53e9bcff68fe7de2bcbe75116a8d959ac699a3200f4847a8925210/websockets-16.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:52a0fec0e6c8d9a784c2c78276a48a2bdf099e4ccc2a4cad53b27718dbfd0230", size = 175039, upload-time = "2026-01-10T09:23:01.171Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/82/39a5f910cb99ec0b59e482971238c845af9220d3ab9fa76dd9162cda9d62/websockets-16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e6578ed5b6981005df1860a56e3617f14a6c307e6a71b4fff8c48fdc50f3ed2c", size = 175323, upload-time = "2026-01-10T09:23:02.341Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/28/0a25ee5342eb5d5f297d992a77e56892ecb65e7854c7898fb7d35e9b33bd/websockets-16.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:95724e638f0f9c350bb1c2b0a7ad0e83d9cc0c9259f3ea94e40d7b02a2179ae5", size = 184975, upload-time = "2026-01-10T09:23:03.756Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/66/27ea52741752f5107c2e41fda05e8395a682a1e11c4e592a809a90c6a506/websockets-16.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0204dc62a89dc9d50d682412c10b3542d748260d743500a85c13cd1ee4bde82", size = 186203, upload-time = "2026-01-10T09:23:05.01Z" },
+    { url = "https://files.pythonhosted.org/packages/37/e5/8e32857371406a757816a2b471939d51c463509be73fa538216ea52b792a/websockets-16.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:52ac480f44d32970d66763115edea932f1c5b1312de36df06d6b219f6741eed8", size = 185653, upload-time = "2026-01-10T09:23:06.301Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/67/f926bac29882894669368dc73f4da900fcdf47955d0a0185d60103df5737/websockets-16.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6e5a82b677f8f6f59e8dfc34ec06ca6b5b48bc4fcda346acd093694cc2c24d8f", size = 184920, upload-time = "2026-01-10T09:23:07.492Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/a1/3d6ccdcd125b0a42a311bcd15a7f705d688f73b2a22d8cf1c0875d35d34a/websockets-16.0-cp313-cp313-win32.whl", hash = "sha256:abf050a199613f64c886ea10f38b47770a65154dc37181bfaff70c160f45315a", size = 178255, upload-time = "2026-01-10T09:23:09.245Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/ae/90366304d7c2ce80f9b826096a9e9048b4bb760e44d3b873bb272cba696b/websockets-16.0-cp313-cp313-win_amd64.whl", hash = "sha256:3425ac5cf448801335d6fdc7ae1eb22072055417a96cc6b31b3861f455fbc156", size = 178689, upload-time = "2026-01-10T09:23:10.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/1d/e88022630271f5bd349ed82417136281931e558d628dd52c4d8621b4a0b2/websockets-16.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8cc451a50f2aee53042ac52d2d053d08bf89bcb31ae799cb4487587661c038a0", size = 177406, upload-time = "2026-01-10T09:23:12.178Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/78/e63be1bf0724eeb4616efb1ae1c9044f7c3953b7957799abb5915bffd38e/websockets-16.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:daa3b6ff70a9241cf6c7fc9e949d41232d9d7d26fd3522b1ad2b4d62487e9904", size = 175085, upload-time = "2026-01-10T09:23:13.511Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/f4/d3c9220d818ee955ae390cf319a7c7a467beceb24f05ee7aaaa2414345ba/websockets-16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:fd3cb4adb94a2a6e2b7c0d8d05cb94e6f1c81a0cf9dc2694fb65c7e8d94c42e4", size = 175328, upload-time = "2026-01-10T09:23:14.727Z" },
+    { url = "https://files.pythonhosted.org/packages/63/bc/d3e208028de777087e6fb2b122051a6ff7bbcca0d6df9d9c2bf1dd869ae9/websockets-16.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:781caf5e8eee67f663126490c2f96f40906594cb86b408a703630f95550a8c3e", size = 185044, upload-time = "2026-01-10T09:23:15.939Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/6e/9a0927ac24bd33a0a9af834d89e0abc7cfd8e13bed17a86407a66773cc0e/websockets-16.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:caab51a72c51973ca21fa8a18bd8165e1a0183f1ac7066a182ff27107b71e1a4", size = 186279, upload-time = "2026-01-10T09:23:17.148Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/ca/bf1c68440d7a868180e11be653c85959502efd3a709323230314fda6e0b3/websockets-16.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19c4dc84098e523fd63711e563077d39e90ec6702aff4b5d9e344a60cb3c0cb1", size = 185711, upload-time = "2026-01-10T09:23:18.372Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/f8/fdc34643a989561f217bb477cbc47a3a07212cbda91c0e4389c43c296ebf/websockets-16.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5e18a238a2b2249c9a9235466b90e96ae4795672598a58772dd806edc7ac6d3", size = 184982, upload-time = "2026-01-10T09:23:19.652Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/d1/574fa27e233764dbac9c52730d63fcf2823b16f0856b3329fc6268d6ae4f/websockets-16.0-cp314-cp314-win32.whl", hash = "sha256:a069d734c4a043182729edd3e9f247c3b2a4035415a9172fd0f1b71658a320a8", size = 177915, upload-time = "2026-01-10T09:23:21.458Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/f1/ae6b937bf3126b5134ce1f482365fde31a357c784ac51852978768b5eff4/websockets-16.0-cp314-cp314-win_amd64.whl", hash = "sha256:c0ee0e63f23914732c6d7e0cce24915c48f3f1512ec1d079ed01fc629dab269d", size = 178381, upload-time = "2026-01-10T09:23:22.715Z" },
+    { url = "https://files.pythonhosted.org/packages/06/9b/f791d1db48403e1f0a27577a6beb37afae94254a8c6f08be4a23e4930bc0/websockets-16.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:a35539cacc3febb22b8f4d4a99cc79b104226a756aa7400adc722e83b0d03244", size = 177737, upload-time = "2026-01-10T09:23:24.523Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/40/53ad02341fa33b3ce489023f635367a4ac98b73570102ad2cdd770dacc9a/websockets-16.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:b784ca5de850f4ce93ec85d3269d24d4c82f22b7212023c974c401d4980ebc5e", size = 175268, upload-time = "2026-01-10T09:23:25.781Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/6158d4e459b984f949dcbbb0c5d270154c7618e11c01029b9bbd1bb4c4f9/websockets-16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:569d01a4e7fba956c5ae4fc988f0d4e187900f5497ce46339c996dbf24f17641", size = 175486, upload-time = "2026-01-10T09:23:27.033Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/2d/7583b30208b639c8090206f95073646c2c9ffd66f44df967981a64f849ad/websockets-16.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:50f23cdd8343b984957e4077839841146f67a3d31ab0d00e6b824e74c5b2f6e8", size = 185331, upload-time = "2026-01-10T09:23:28.259Z" },
+    { url = "https://files.pythonhosted.org/packages/45/b0/cce3784eb519b7b5ad680d14b9673a31ab8dcb7aad8b64d81709d2430aa8/websockets-16.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:152284a83a00c59b759697b7f9e9cddf4e3c7861dd0d964b472b70f78f89e80e", size = 186501, upload-time = "2026-01-10T09:23:29.449Z" },
+    { url = "https://files.pythonhosted.org/packages/19/60/b8ebe4c7e89fb5f6cdf080623c9d92789a53636950f7abacfc33fe2b3135/websockets-16.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:bc59589ab64b0022385f429b94697348a6a234e8ce22544e3681b2e9331b5944", size = 186062, upload-time = "2026-01-10T09:23:31.368Z" },
+    { url = "https://files.pythonhosted.org/packages/88/a8/a080593f89b0138b6cba1b28f8df5673b5506f72879322288b031337c0b8/websockets-16.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:32da954ffa2814258030e5a57bc73a3635463238e797c7375dc8091327434206", size = 185356, upload-time = "2026-01-10T09:23:32.627Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/b6/b9afed2afadddaf5ebb2afa801abf4b0868f42f8539bfe4b071b5266c9fe/websockets-16.0-cp314-cp314t-win32.whl", hash = "sha256:5a4b4cc550cb665dd8a47f868c8d04c8230f857363ad3c9caf7a0c3bf8c61ca6", size = 178085, upload-time = "2026-01-10T09:23:33.816Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/3e/28135a24e384493fa804216b79a6a6759a38cc4ff59118787b9fb693df93/websockets-16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b14dc141ed6d2dde437cddb216004bcac6a1df0935d79656387bd41632ba0bbd", size = 178531, upload-time = "2026-01-10T09:23:35.016Z" },
+    { url = "https://files.pythonhosted.org/packages/72/07/c98a68571dcf256e74f1f816b8cc5eae6eb2d3d5cfa44d37f801619d9166/websockets-16.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:349f83cd6c9a415428ee1005cadb5c2c56f4389bc06a9af16103c3bc3dcc8b7d", size = 174947, upload-time = "2026-01-10T09:23:36.166Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/52/93e166a81e0305b33fe416338be92ae863563fe7bce446b0f687b9df5aea/websockets-16.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:4a1aba3340a8dca8db6eb5a7986157f52eb9e436b74813764241981ca4888f03", size = 175260, upload-time = "2026-01-10T09:23:37.409Z" },
+    { url = "https://files.pythonhosted.org/packages/56/0c/2dbf513bafd24889d33de2ff0368190a0e69f37bcfa19009ef819fe4d507/websockets-16.0-pp311-pypy311_pp73-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:f4a32d1bd841d4bcbffdcb3d2ce50c09c3909fbead375ab28d0181af89fd04da", size = 176071, upload-time = "2026-01-10T09:23:39.158Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/8f/aea9c71cc92bf9b6cc0f7f70df8f0b420636b6c96ef4feee1e16f80f75dd/websockets-16.0-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0298d07ee155e2e9fda5be8a9042200dd2e3bb0b8a38482156576f863a9d457c", size = 176968, upload-time = "2026-01-10T09:23:41.031Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/3f/f70e03f40ffc9a30d817eef7da1be72ee4956ba8d7255c399a01b135902a/websockets-16.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:a653aea902e0324b52f1613332ddf50b00c06fdaf7e92624fbf8c77c78fa5767", size = 178735, upload-time = "2026-01-10T09:23:42.259Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/28/258ebab549c2bf3e64d2b0217b973467394a9cea8c42f70418ca2c5d0d2e/websockets-16.0-py3-none-any.whl", hash = "sha256:1637db62fad1dc833276dded54215f2c7fa46912301a24bd94d45d46a011ceec", size = 171598, upload-time = "2026-01-10T09:23:45.395Z" },
+]
+
+[[package]]
+name = "winrt-runtime"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/16/dd/acdd527c1d890c8f852cc2af644aa6c160974e66631289420aa871b05e65/winrt_runtime-3.2.1.tar.gz", hash = "sha256:c8dca19e12b234ae6c3dadf1a4d0761b51e708457492c13beb666556958801ea", size = 21721, upload-time = "2025-06-06T14:40:27.593Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/65/28/26d86ca6d2f155f31ca61e069312034a8922a5a89f5d0fc68abb7c04aad1/winrt_runtime-3.2.1-cp310-cp310-win32.whl", hash = "sha256:25a2d1e2b45423742319f7e10fa8ca2e7063f01284b6e85e99d805c4b50bbfb3", size = 210993, upload-time = "2025-06-06T06:44:01.184Z" },
+    { url = "https://files.pythonhosted.org/packages/46/a4/f096687e0d1877d206bc5d1f5f07ff90e00b0772d69d4559ab2b6b37090b/winrt_runtime-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:dc81d5fb736bf1ddecf743928622253dce4d0aac9a57faad776d7a3834e13257", size = 242210, upload-time = "2025-06-06T06:44:02.366Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/81/46927ce4d79fc8f40f193f35204bce79eff7c496d888825a7a74d8560b6e/winrt_runtime-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:363f584b1e9fcb601e3e178636d8877e6f0537ac3c96ce4a96f06066f8ff0eae", size = 415833, upload-time = "2025-06-06T06:44:03.379Z" },
+    { url = "https://files.pythonhosted.org/packages/90/8d/d7ae0e07cd85c7768de76e8578261854f2af72bd3a8a527bb675e8ae0eda/winrt_runtime-3.2.1-cp311-cp311-win32.whl", hash = "sha256:9e9b64f1ba631cc4b9fe60b8ff16fef3f32c7ce2fcc84735a63129ff8b15c022", size = 210798, upload-time = "2025-06-06T06:44:04.775Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/66/d05f6e6c0517654734e7f87fa1f0fbc965add9f27cc36b524d96331ab3d8/winrt_runtime-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:c0a9046ae416808420a358c51705af8ae100acd40bc578be57ddfdd51cbb0f9c", size = 242032, upload-time = "2025-06-06T06:44:06.103Z" },
+    { url = "https://files.pythonhosted.org/packages/39/a5/760c8396110f6d3e4c417752da1a2bf3b89e0998329c2f10afc717ef6291/winrt_runtime-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:e94f3cb40ea2d723c44c82c16d715c03c6b3bd977d135b49535fdd5415fd9130", size = 415659, upload-time = "2025-06-06T06:44:07.007Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/54/3dd06f2341fab6abb06588a16b30e0b213b0125be7b79dafc3bdba3b334a/winrt_runtime-3.2.1-cp312-cp312-win32.whl", hash = "sha256:762b3d972a2f7037f7db3acbaf379dd6d8f6cda505f71f66c6b425d1a1eae2f1", size = 210090, upload-time = "2025-06-06T06:44:08.151Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/a1/1d7248d5c62ccbea5f3e0da64ca4529ce99c639c3be2485b6ed709f5c740/winrt_runtime-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:06510db215d4f0dc45c00fbb1251c6544e91742a0ad928011db33b30677e1576", size = 241391, upload-time = "2025-06-06T06:44:09.442Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/ae/6a205d8dafc79f7c242be7f940b1e0c1971fd64ab3079bda4b514aa3d714/winrt_runtime-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:14562c29a087ccad38e379e585fef333e5c94166c807bdde67b508a6261aa195", size = 415242, upload-time = "2025-06-06T06:44:10.407Z" },
+    { url = "https://files.pythonhosted.org/packages/79/d4/1a555d8bdcb8b920f8e896232c82901cc0cda6d3e4f92842199ae7dff70a/winrt_runtime-3.2.1-cp313-cp313-win32.whl", hash = "sha256:44e2733bc709b76c554aee6c7fe079443b8306b2e661e82eecfebe8b9d71e4d1", size = 210022, upload-time = "2025-06-06T06:44:11.767Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/24/2b6e536ca7745d788dfd17a2ec376fa03a8c7116dc638bb39b035635484f/winrt_runtime-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:3c1fdcaeedeb2920dc3b9039db64089a6093cad2be56a3e64acc938849245a6d", size = 241349, upload-time = "2025-06-06T06:44:12.661Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/7f/6d72973279e2929b2a71ed94198ad4a5d63ee2936e91a11860bf7b431410/winrt_runtime-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:28f3dab083412625ff4d2b46e81246932e6bebddf67bea7f05e01712f54e6159", size = 415126, upload-time = "2025-06-06T06:44:13.702Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/87/88bd98419a9da77a68e030593fee41702925a7ad8a8aec366945258cbb31/winrt_runtime-3.2.1-cp314-cp314-win32.whl", hash = "sha256:9b6298375468ac2f6815d0c008a059fc16508c8f587e824c7936ed9216480dad", size = 210257, upload-time = "2025-09-20T07:06:41.054Z" },
+    { url = "https://files.pythonhosted.org/packages/87/85/e5c2a10d287edd9d3ee8dc24bf7d7f335636b92bf47119768b7dd2fd1669/winrt_runtime-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:e36e587ab5fd681ee472cd9a5995743f75107a1a84d749c64f7e490bc86bc814", size = 241873, upload-time = "2025-09-20T07:06:42.059Z" },
+    { url = "https://files.pythonhosted.org/packages/52/2a/eb9e78397132175f70dd51dfa4f93e489c17d6b313ae9dce60369b8d84a7/winrt_runtime-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:35d6241a2ebd5598e4788e69768b8890ee1eee401a819865767a1fbdd3e9a650", size = 416222, upload-time = "2025-09-20T07:06:43.376Z" },
+]
+
+[[package]]
+name = "winrt-windows-devices-bluetooth"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b2/a0/1c8a0c469abba7112265c6cb52f0090d08a67c103639aee71fc690e614b8/winrt_windows_devices_bluetooth-3.2.1.tar.gz", hash = "sha256:db496d2d92742006d5a052468fc355bf7bb49e795341d695c374746113d74505", size = 23732, upload-time = "2025-06-06T14:41:20.489Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/b7/822da8bc0b6a67cc0c3e460fef793f00c51a6fe59aa54f6bfe416519a9d9/winrt_windows_devices_bluetooth-3.2.1-cp310-cp310-win32.whl", hash = "sha256:49489351037094a088a08fbdf0f99c94e3299b574edb211f717c4c727770af78", size = 105569, upload-time = "2025-06-06T07:00:05.406Z" },
+    { url = "https://files.pythonhosted.org/packages/68/46/696893d3bae80751e35fb0fb8fae5e7fc94a5354dfb5e19167d415e27c66/winrt_windows_devices_bluetooth-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:20f6a21029034c18ea6a6b6df399671813b071102a0d6d8355bb78cf4f547cdb", size = 114743, upload-time = "2025-06-06T07:00:06.408Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/6a/a36b28739b73cc2c67050da866b063af135b5f6c071997c85a27adb6815c/winrt_windows_devices_bluetooth-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:69c523814eab795bc1bf913292309cb1025ef0a67d5fc33863a98788995e551d", size = 105021, upload-time = "2025-06-06T07:00:07.299Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/cf/671bf29337323cc08f9969cb32312f217d2927d29dbf2964f0dbb378cb90/winrt_windows_devices_bluetooth-3.2.1-cp311-cp311-win32.whl", hash = "sha256:f4082a00b834c1e34b961e0612f3e581356bdb38c5798bd6842f88ec02e5152b", size = 105535, upload-time = "2025-06-06T07:00:08.146Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/d5/5761a8b6dcc56957018970dd443059c8ee8a79de7b07f0b4d143f8e7dc15/winrt_windows_devices_bluetooth-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:44277a3f2cc5ac32ce9b4b2d96c5c5f601d394ac5f02cc71bcd551f738660e2d", size = 114612, upload-time = "2025-06-06T07:00:08.984Z" },
+    { url = "https://files.pythonhosted.org/packages/24/0b/7819bb102286752d3572a75d03e6a8000ffe3c6cb7aee3eb136dca383fe2/winrt_windows_devices_bluetooth-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:0803a417403a7d225316b9b0c4fe3f8446579d6a22f2f729a2c21f4befc74a80", size = 105017, upload-time = "2025-06-06T07:00:09.813Z" },
+    { url = "https://files.pythonhosted.org/packages/54/ff/c4a3de909a875b46fad5e9f4fd412bba48571405bfa802b878954abf128c/winrt_windows_devices_bluetooth-3.2.1-cp312-cp312-win32.whl", hash = "sha256:18c833ec49e7076127463679e85efc59f61785ade0dc185c852586b21be1f31c", size = 105752, upload-time = "2025-06-06T07:00:10.684Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/78/bfee1f0c8d188c561c5b946ab21f6a0037e60dea110e80b1d6a1d529639f/winrt_windows_devices_bluetooth-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:9b6702c462b216c91e32388023a74d0f87210cef6fd5d93b7191e9427ce2faca", size = 113356, upload-time = "2025-06-06T07:00:11.541Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/1b/d9da9c29d36cabadef4e19c3e9ba6d2692f6a28224c81fcff757132ea0da/winrt_windows_devices_bluetooth-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:419fd1078c7749119f6b4bbf6be4e586e03a0ed544c03b83178f1d85f1b3d148", size = 104724, upload-time = "2025-06-06T07:00:12.406Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/cc/797516c5c0f8d7f5b680862e0ed7c1087c58aec0bcf57a417fa90f7eb983/winrt_windows_devices_bluetooth-3.2.1-cp313-cp313-win32.whl", hash = "sha256:12b0a16fb36ce0b42243ca81f22a6b53fbb344ed7ea07a6eeec294604f0505e4", size = 105757, upload-time = "2025-06-06T07:00:13.269Z" },
+    { url = "https://files.pythonhosted.org/packages/05/6d/f60588846a065e69a2ec5e67c5f85eb45cb7edef2ee8974cd52fa8504de6/winrt_windows_devices_bluetooth-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6703dfbe444ee22426738830fb305c96a728ea9ccce905acfdf811d81045fdb3", size = 113363, upload-time = "2025-06-06T07:00:14.135Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/13/2d3c4762018b26a9f66879676ea15d7551cdbf339c8e8e0c56ea05ea31ef/winrt_windows_devices_bluetooth-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:2cf8a0bfc9103e32dc7237af15f84be06c791f37711984abdca761f6318bbdb2", size = 104722, upload-time = "2025-06-06T07:00:14.999Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/95/91cfdf941a1ba791708ab3477fc4e46793c8fe9117fc3e0a8c5ac5d7a09c/winrt_windows_devices_bluetooth-3.2.1-cp314-cp314-win32.whl", hash = "sha256:de36ded53ca3ba12fc6dd4deb14b779acc391447726543815df4800348aad63a", size = 109015, upload-time = "2025-09-20T07:09:51.067Z" },
+    { url = "https://files.pythonhosted.org/packages/61/fa/7460655628d0f340a93524f5236bb9f8514eb0e1d334b38cba8a89f6c1a6/winrt_windows_devices_bluetooth-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:3295d932cc93259d5ccb23a41e3a3af4c78ce5d6a6223b2b7638985f604fa34c", size = 115931, upload-time = "2025-09-20T07:09:51.922Z" },
+    { url = "https://files.pythonhosted.org/packages/de/70/e1248dea2ab881eb76b61ff1ad6cb9c07ac005faf99349e4af0b29bc3f1b/winrt_windows_devices_bluetooth-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:1f61c178766a1bbce0669f44790c6161ff4669404c477b4aedaa576348f9e102", size = 109561, upload-time = "2025-09-20T07:09:52.733Z" },
+]
+
+[[package]]
+name = "winrt-windows-devices-bluetooth-advertisement"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/fc/7ffe66ca4109b9e994b27c00f3d2d506e6e549e268791f755287ad9106d8/winrt_windows_devices_bluetooth_advertisement-3.2.1.tar.gz", hash = "sha256:0223852a7b7fa5c8dea3c6a93473bd783df4439b1ed938d9871f947933e574cc", size = 16906, upload-time = "2025-06-06T14:41:21.448Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/b9/c2b0d201b8b38895809591d089a5edc37e702a23f3a6bc6e542c5e7d6dbf/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp310-cp310-win32.whl", hash = "sha256:a758c5f81a98cc38347fdfb024ce62720969480e8c5b98e402b89d2b09b32866", size = 89730, upload-time = "2025-06-06T07:00:18.451Z" },
+    { url = "https://files.pythonhosted.org/packages/56/f9/f086c3ac17745a71d8384e1831cab0d5a7c737e1fe5cb84d7584f6c14bbf/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:f982ef72e729ddd60cdb975293866e84bb838798828933012a57ee4bf12b0ea1", size = 95825, upload-time = "2025-06-06T07:00:19.385Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/b5/f7f830b2da1fb7ffcaf25ce2734db0019615111f8f39e7b4d83fea4a0bd0/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:e88a72e1e09c7ccc899a9e6d2ab3fc0f43b5dd4509bcc49ec4abf65b55ab015f", size = 89402, upload-time = "2025-06-06T07:00:20.178Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/5e/c628719e877a89f00cac7ce53f9666acbc5ed6f074130729d5d6768b63ff/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp311-cp311-win32.whl", hash = "sha256:fe17c2cf63284646622e8b2742b064bf7970bbf53cfab02062136c67fa6b06c9", size = 89614, upload-time = "2025-06-06T07:00:20.952Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/1a/d172d6f1c2fae53535e7f23835025cf39e3002749a0304f18a38e8ed490d/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:78e99dd48b4d89b71b7778c5085fdba64e754dd3ebc54fd09c200fe5222c6e09", size = 95783, upload-time = "2025-06-06T07:00:21.764Z" },
+    { url = "https://files.pythonhosted.org/packages/67/c1/568dfdaea62ca3b13bb70162cb292e5cd0be5bbb98b738961ddcc2edd374/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:6d5d2295474deab444fc4311580c725a2ca8a814b0f3344d0779828891d75401", size = 89253, upload-time = "2025-06-06T07:00:22.603Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/15/ad05c28e049208c97011728e2debdb45439175f75efe357b6faa4c9ba099/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp312-cp312-win32.whl", hash = "sha256:901933cc40de5eb7e5f4188897c899dd0b0f577cb2c13eab1a63c7dfe89b08c4", size = 90033, upload-time = "2025-06-06T07:00:23.421Z" },
+    { url = "https://files.pythonhosted.org/packages/26/48/074779081841f6eba4987930c4e7adcec38a5985b7dffd9fecc41f39a89c/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:e6c66e7d4f4ca86d2c801d30efd2b9673247b59a2b4c365d9e11650303d68d89", size = 95824, upload-time = "2025-06-06T07:00:24.238Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/25/e01966033a02b2d0718710bb47ef4f6b9b5a619ca2c857e06eb5c8e3ed13/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:447d19defd8982d39944642eb7ebe89e4e20259ec9734116cf88879fb2c514ff", size = 89311, upload-time = "2025-06-06T07:00:25.029Z" },
+    { url = "https://files.pythonhosted.org/packages/34/01/8fc8e57605ea08dd0723c035ed0c2d0435dace2bc80a66d33aecfea49a56/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp313-cp313-win32.whl", hash = "sha256:4122348ea525a914e85615647a0b54ae8b2f42f92cdbf89c5a12eea53ef6ed90", size = 90037, upload-time = "2025-06-06T07:00:25.818Z" },
+    { url = "https://files.pythonhosted.org/packages/86/83/503cf815d84c5ba8c8bc61480f32e55579ebf76630163405f7df39aa297b/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:b66410c04b8dae634a7e4b615c3b7f8adda9c7d4d6902bcad5b253da1a684943", size = 95822, upload-time = "2025-06-06T07:00:26.666Z" },
+    { url = "https://files.pythonhosted.org/packages/32/13/052be8b6642e6f509b30c194312b37bfee8b6b60ac3bd5ca2968c3ea5b80/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:07af19b1d252ddb9dd3eb2965118bc2b7cabff4dda6e499341b765e5038ca61d", size = 89326, upload-time = "2025-06-06T07:00:27.477Z" },
+    { url = "https://files.pythonhosted.org/packages/27/3d/421d04a20037370baf13de929bc1dc5438b306a76fe17275ec5d893aae6c/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp314-cp314-win32.whl", hash = "sha256:2985565c265b3f9eab625361b0e40e88c94b03d89f5171f36146f2e88b3ee214", size = 92264, upload-time = "2025-09-20T07:09:53.563Z" },
+    { url = "https://files.pythonhosted.org/packages/07/c7/43601ab82fe42bcff430b8466d84d92b31be06cc45c7fd64e9aac40f7851/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:d102f3fac64fde32332e370969dfbc6f37b405d8cc055d9da30d14d07449a3c2", size = 97517, upload-time = "2025-09-20T07:09:54.411Z" },
+    { url = "https://files.pythonhosted.org/packages/91/17/e3303f6a25a2d98e424b06580fc85bbfd068f383424c67fa47cb1b357a46/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:ffeb5e946cd42c32c6999a62e240d6730c653cdfb7b49c7839afba375e20a62a", size = 94122, upload-time = "2025-09-20T07:09:55.187Z" },
+]
+
+[[package]]
+name = "winrt-windows-devices-bluetooth-genericattributeprofile"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/44/21/aeeddc0eccdfbd25e543360b5cc093233e2eab3cdfb53ad3cabae1b5d04d/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1.tar.gz", hash = "sha256:cdf6ddc375e9150d040aca67f5a17c41ceaf13a63f3668f96608bc1d045dde71", size = 38896, upload-time = "2025-06-06T14:41:22.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/66/a3/449ffc2f8e4c3cfbe7f14c1b43bcaa0475fbd2e8e8bf08465399c5ea078c/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp310-cp310-win32.whl", hash = "sha256:af4914d7b30b49232092cd3b934e3ed6f5d3b1715ba47238541408ee595b7f46", size = 182059, upload-time = "2025-06-06T07:00:47.095Z" },
+    { url = "https://files.pythonhosted.org/packages/50/d9/6ea88731df569f5c1b086daf4c3496c8d43281588e3a578ea623fef6bc43/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:0e557dd52fc80392b8bd7c237e1153a50a164b3983838b4ac674551072efc9ed", size = 187866, upload-time = "2025-06-06T07:00:48.123Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/2c/ace56fd32ad07608462de0ac7df218e0bf810e4cc31f2c0fbd7f5f90ee93/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:64cff62baa6b7aadd6c206e61d149113fdcda17360feb6e9d05bc8bbda4b9fde", size = 184627, upload-time = "2025-06-06T07:00:49.087Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/5e/349a5d958be8c0570f0a49bbb746088bcfaa81555accb57503ba01185359/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp311-cp311-win32.whl", hash = "sha256:832cf65d035a11e6dbfef4fd66abdcc46be7e911ec96e2e72e98e12d8d5b9d3c", size = 182312, upload-time = "2025-06-06T07:00:49.974Z" },
+    { url = "https://files.pythonhosted.org/packages/90/db/929ab0085ec89e46bd3a58c74b451dd770c3285dfa0cbd4f4aa4730da004/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:8179638a6c721b0bbf04ba251ef98d5e02d9a17f0cce377398e42c4fbb441415", size = 187768, upload-time = "2025-06-06T07:00:50.853Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/53/f316e2224c384178204430439f04f9b72017fe8237e341a9aebb20da8191/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:70b7edfca3190b89ae38bf60972b11978311b6d933d3142ae45560c955dbf5c7", size = 184189, upload-time = "2025-06-06T07:00:51.791Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/a1/75ac783a5faee9b455fef2f53b7fef97b21ed60d52401b44c690202141e4/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp312-cp312-win32.whl", hash = "sha256:ef894d21e0a805f3e114940254636a8045335fa9de766c7022af5d127dfad557", size = 183326, upload-time = "2025-06-06T07:00:52.662Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/d9/a9dcc15322d2f5c7dfd491bd7ab121e36437caf78ebfa92bc0dd0546e2ca/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:db05de95cd1b24a51abb69cb936a8b17e9214e015757d0b37e3a5e207ddceb3d", size = 187810, upload-time = "2025-06-06T07:00:53.594Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/fc/47d00af076f558267097af3050910beda6bf8a21ceaa5830bbd26fcaf85e/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:8d4e131cf3d15fc5ad81c1bcde3509ac171298217381abed6bdf687f29871984", size = 184516, upload-time = "2025-06-06T07:00:55.24Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/93/30b45ce473d1a604908221a1fa035fe8d5e4bb9008e820ae671a21dab94c/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp313-cp313-win32.whl", hash = "sha256:b1879c8dcf46bd2110b9ad4b0b185f4e2a5f95170d014539203a5fee2b2115f0", size = 183342, upload-time = "2025-06-06T07:00:56.16Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/3b/eb9d99b82a36002d7885206d00ea34f4a23db69c16c94816434ded728fa3/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d8d89f01e9b6931fb48217847caac3227a0aeb38a5b7782af71c2e7b262ec30", size = 187844, upload-time = "2025-06-06T07:00:57.134Z" },
+    { url = "https://files.pythonhosted.org/packages/84/9b/ebbbe9be9a3e640dcfc5f166eb48f2f9d8ce42553f83aa9f4c5dcd9eb5f5/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:4e71207bb89798016b1795bb15daf78afe45529f2939b3b9e78894cfe650b383", size = 184540, upload-time = "2025-06-06T07:00:58.081Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/32/cb447ca7730a1e05730272309b074da6a04af29a8c0f5121014db8a2fc02/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp314-cp314-win32.whl", hash = "sha256:d5f83739ca370f0baf52b0400aebd6240ab80150081fbfba60fd6e7b2e7b4c5f", size = 185249, upload-time = "2025-09-20T07:09:58.639Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/fa/f465d5d44dda166bf7ec64b7a950f57eca61f165bfe18345e9a5ea542def/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:13786a5853a933de140d456cd818696e1121c7c296ae7b7af262fc5d2cffb851", size = 193739, upload-time = "2025-09-20T07:09:59.893Z" },
+    { url = "https://files.pythonhosted.org/packages/78/08/51c53ac3c704cd92da5ed7e7b9b57159052f6e46744e4f7e447ed708aa22/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:5140682da2860f6a55eb6faf9e980724dc457c2e4b4b35a10e1cebd8fc97d892", size = 194836, upload-time = "2025-09-20T07:10:00.87Z" },
+]
+
+[[package]]
+name = "winrt-windows-devices-enumeration"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9e/dd/75835bfbd063dffa152109727dedbd80f6e92ea284855f7855d48cdf31c9/winrt_windows_devices_enumeration-3.2.1.tar.gz", hash = "sha256:df316899e39bfc0ffc1f3cb0f5ee54d04e1d167fbbcc1484d2d5121449a935cf", size = 23538, upload-time = "2025-06-06T14:41:26.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bd/61/2744d0e0b3fa7807149a1a36dd89abba901d6b24184d9fd5ef3f28467232/winrt_windows_devices_enumeration-3.2.1-cp310-cp310-win32.whl", hash = "sha256:40dac777d8f45b41449f3ff1ae70f0d457f1ede53f53962a6e2521b651533db5", size = 130040, upload-time = "2025-06-06T07:01:56.337Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/f9/881b7ee8acdf3c9fe6c79d8ccd90f9246b397fc78420d55014c4ac05b822/winrt_windows_devices_enumeration-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:a101ec3e0ad0a0783032fdcd5dc48e7cd68ee034cbde4f903a8c7b391532c71a", size = 142463, upload-time = "2025-06-06T07:01:57.554Z" },
+    { url = "https://files.pythonhosted.org/packages/12/db/b09dffcf1158b35d81d8d57bf19ad04293870cea5afa77943c87f1110d88/winrt_windows_devices_enumeration-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:3296a3863ac086928ff3f3dc872b2a2fb971dab728817424264f3ca547504e9e", size = 135871, upload-time = "2025-06-06T07:01:58.792Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/92/ca1fd311d96fce15fba25543a2ae3cb829744a8af548a11d74233d0e4f64/winrt_windows_devices_enumeration-3.2.1-cp311-cp311-win32.whl", hash = "sha256:9f29465a6c6b0456e4330d4ad09eccdd53a17e1e97695c2e57db0d4666cc0011", size = 129898, upload-time = "2025-06-06T07:01:59.687Z" },
+    { url = "https://files.pythonhosted.org/packages/03/fd/5bd5da5d7997725ba3f1995c16aa1c3362937f8ff68ad4cadfd3415eebcb/winrt_windows_devices_enumeration-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:2a725d04b4cb43aa0e2af035f73a60d16a6c0ff165fcb6b763383e4e33a975fd", size = 142361, upload-time = "2025-06-06T07:02:00.546Z" },
+    { url = "https://files.pythonhosted.org/packages/df/be/d423b63e740600e0617ddb85fba3ef99e7bbff02299fe46323bfe624a382/winrt_windows_devices_enumeration-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:6365ef5978d4add26678827286034acf474b6b133aa4054e76567d12194e6817", size = 135808, upload-time = "2025-06-06T07:02:01.4Z" },
+    { url = "https://files.pythonhosted.org/packages/31/3e/81642208ecd6c6c936f35a39a433c54e3f68e09d316546b8f953581ae334/winrt_windows_devices_enumeration-3.2.1-cp312-cp312-win32.whl", hash = "sha256:1db22b0292b93b0688d11ad932ad1f3629d4f471310281a2fbfe187530c2c1f3", size = 130249, upload-time = "2025-06-06T07:02:02.237Z" },
+    { url = "https://files.pythonhosted.org/packages/00/f4/a9ede5f3f0d86abfc7590726cf711133d97419b49ced372fca532e4f0696/winrt_windows_devices_enumeration-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:a73bc88d7f510af454f2b392985501c96f39b89fd987140708ccaec1588ceebc", size = 141512, upload-time = "2025-06-06T07:02:03.424Z" },
+    { url = "https://files.pythonhosted.org/packages/31/ef/4fad07c03124bdc3acd64f80f3bd3cc4417ea641e07bb16a9503afd3e554/winrt_windows_devices_enumeration-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:2853d687803f0dd76ae1afe3648abc0453e09dff0e7eddbb84b792eddb0473ca", size = 135383, upload-time = "2025-06-06T07:02:04.312Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/7d/ebd712ab8ccd599c593796fbcd606abe22b5a8e20db134aa87987d67ac0e/winrt_windows_devices_enumeration-3.2.1-cp313-cp313-win32.whl", hash = "sha256:14a71cdcc84f624c209cbb846ed6bd9767a9a9437b2bf26b48ac9a91599da6e9", size = 130276, upload-time = "2025-06-06T07:02:05.178Z" },
+    { url = "https://files.pythonhosted.org/packages/70/de/f30daaaa0e6f4edb6bd7ddb3e058bd453c9ad90c032a4545c4d4639338aa/winrt_windows_devices_enumeration-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6ca40d334734829e178ad46375275c4f7b5d6d2d4fc2e8879690452cbfb36015", size = 141536, upload-time = "2025-06-06T07:02:06.067Z" },
+    { url = "https://files.pythonhosted.org/packages/75/4b/9a6aafdc74a085c550641a325be463bf4b811f6f605766c9cd4f4b5c19d2/winrt_windows_devices_enumeration-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:2d14d187f43e4409c7814b7d1693c03a270e77489b710d92fcbbaeca5de260d4", size = 135362, upload-time = "2025-06-06T07:02:06.997Z" },
+    { url = "https://files.pythonhosted.org/packages/41/31/5785cd1ec54dc0f0e6f3e6a466d07a62b8014a6e2b782e80444ef87e83ab/winrt_windows_devices_enumeration-3.2.1-cp314-cp314-win32.whl", hash = "sha256:e087364273ed7c717cd0191fed4be9def6fdf229fe9b536a4b8d0228f7814106", size = 134252, upload-time = "2025-09-20T07:10:12.935Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/f6/68d91068048410f49794c0b19c45759c63ca559607068cfe5affba2f211b/winrt_windows_devices_enumeration-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:0da1ddb8285d97a6775c36265d7157acf1bbcb88bcc9a7ce9a4549906c822472", size = 145509, upload-time = "2025-09-20T07:10:13.797Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/a4/898951d5bfc474aa9c7d133fe30870f0f2184f4ba3027eafb779d30eb7bc/winrt_windows_devices_enumeration-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:09bf07e74e897e97a49a9275d0a647819254ddb74142806bbbcf4777ed240a22", size = 141334, upload-time = "2025-09-20T07:10:14.637Z" },
+]
+
+[[package]]
+name = "winrt-windows-devices-radios"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5e/02/9704ea359ad8b0d6faa1011f98fb477e8fb6eac5201f39d19e73c2407e7b/winrt_windows_devices_radios-3.2.1.tar.gz", hash = "sha256:4dc9b9d1501846049eb79428d64ec698d6476c27a357999b78a8331072e18a0b", size = 5908, upload-time = "2025-06-06T14:41:44.868Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7d/1b/0de659ed4bb80aee28753b4431011334205637a2578481a511866a11e0cf/winrt_windows_devices_radios-3.2.1-cp310-cp310-win32.whl", hash = "sha256:f97766fd551d06c102155d51b2922f96663dee045e1f8d57177def0a2149cb78", size = 38643, upload-time = "2025-06-06T07:07:56.852Z" },
+    { url = "https://files.pythonhosted.org/packages/29/fd/67c6db8a3244ecc95f85970a7b0e749cda28e26563db1274c3db36a8fbe4/winrt_windows_devices_radios-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:104b737fa1279a3b6a88ba3c6236157afc1de03c472657c45e5176ad7a209e23", size = 40295, upload-time = "2025-06-06T07:07:57.738Z" },
+    { url = "https://files.pythonhosted.org/packages/15/6d/d145c7f90b01c24f4f9885d1f7d430ecaf2a2b42b6bc236701791b0b0a06/winrt_windows_devices_radios-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:55b02877d2de06ca6f0f6140611a9af9d0c65710e28f1afdeaac1040433b1837", size = 37060, upload-time = "2025-06-06T07:07:58.47Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/a0/4a8b51da15de218cec04bcc1cd85b4b93bcfd8ebe50a5f0a7eee28836dc6/winrt_windows_devices_radios-3.2.1-cp311-cp311-win32.whl", hash = "sha256:7c02790472414b6cda00d24a8cd23bca18e4b7474ddad4f9264f4484b891807e", size = 38505, upload-time = "2025-06-06T07:07:59.204Z" },
+    { url = "https://files.pythonhosted.org/packages/de/49/ba69e3180585dbc6f3336a09fef7cba4558a6a1e7d500500f62c1478418e/winrt_windows_devices_radios-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:f87745486d313ba1e7562ca97f25ad436ec01ad4b3b9ea349fb6b6f25cb41104", size = 40157, upload-time = "2025-06-06T07:07:59.948Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/92/64817f71a20ecf842da36dc3848f42614217688137a69c93fda8a6103155/winrt_windows_devices_radios-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:6cee6f946ff3a3571850d1ca745edaee7c331d06ca321873e650779654effc4a", size = 36976, upload-time = "2025-06-06T07:08:00.719Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/e0/4731a3c412318b2c5e74a8803a32e2fb9afc2c98368c6b61a422eb359e7e/winrt_windows_devices_radios-3.2.1-cp312-cp312-win32.whl", hash = "sha256:c3e683ce682338a5a5ed465f735e223ba7a22f16d0bbea2d070962bc7657edbb", size = 38606, upload-time = "2025-06-06T07:08:01.477Z" },
+    { url = "https://files.pythonhosted.org/packages/37/8e/91464854dfc9e0be9ce8dcbe2bd6a67c19b68ab91584fc5de0f4f13e78f8/winrt_windows_devices_radios-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:a116e552a3f38607b9be558fb2e7de9b4450d1f9080069944d74d80cdda1873e", size = 40172, upload-time = "2025-06-06T07:08:02.214Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/0d/1bd62f606b6c4dfa936fccc4712be5506a40fc5d1b7177c3d3cbcaf30972/winrt_windows_devices_radios-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:4c28822f9251c9d547324f596b5c2581f050254ded05e5b786c650a3502744c1", size = 36989, upload-time = "2025-06-06T07:08:03.295Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/94/c22a14fd424632f3f3c0b25672218db9e8f4ae9e1355e0b148f2fe6015b5/winrt_windows_devices_radios-3.2.1-cp313-cp313-win32.whl", hash = "sha256:ae4a0065927fcd2d10215223f8a46be6fb89bad71cb4edd25dae3d01c137b3a8", size = 38613, upload-time = "2025-06-06T07:08:04.077Z" },
+    { url = "https://files.pythonhosted.org/packages/39/c1/24cec0cc228642554b48d436a7617d7162fb952919c55fc26e2d99c310bd/winrt_windows_devices_radios-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:bf1a975f46a2aa271ffea1340be0c7e64985050d07433e701343dddc22a72290", size = 40180, upload-time = "2025-06-06T07:08:04.849Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/d3/776453af26e78c0d0c0e1bfa89f86fd81322872f31a3e5dafb344dd47bf2/winrt_windows_devices_radios-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:10b298ed154c5824cea2de174afce1694ed2aabfb58826de814074027ffef96f", size = 36989, upload-time = "2025-06-06T07:08:05.576Z" },
+    { url = "https://files.pythonhosted.org/packages/76/79/4627afae6b389ddd1e5f1d691663c6b14d6c8f98959082aed1217cc57ef9/winrt_windows_devices_radios-3.2.1-cp314-cp314-win32.whl", hash = "sha256:21452e1cae50e44cd1d5e78159e1b9986ac3389b66458ad89caa196ce5eca2d6", size = 39521, upload-time = "2025-09-20T07:11:17.992Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/7c/c6aea91908ee7279ed51d12157bc8aeecb8850af2441073c3c91b261ad31/winrt_windows_devices_radios-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:6a8413e586fe597c6849607885cca7e0549da33ae5699165d11f7911534c6eaf", size = 41121, upload-time = "2025-09-20T07:11:18.747Z" },
+    { url = "https://files.pythonhosted.org/packages/86/c5/652f14e3c501452ad8e0723518d9bbd729219b47f4a4dbe2966c2f82dca8/winrt_windows_devices_radios-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:39129fd9d09103adb003575f59881c1a5a70a43310547850150b46c6f4020312", size = 38114, upload-time = "2025-09-20T07:11:19.599Z" },
+]
+
+[[package]]
+name = "winrt-windows-foundation"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0c/55/098ce7ea0679efcc1298b269c48768f010b6c68f90c588f654ec874c8a74/winrt_windows_foundation-3.2.1.tar.gz", hash = "sha256:ad2f1fcaa6c34672df45527d7c533731fdf65b67c4638c2b4aca949f6eec0656", size = 30485, upload-time = "2025-06-06T14:41:53.344Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a5/69/d387332c4378b41f87211b7dc40a4cfc6b7047dc227448aaa207624fc911/winrt_windows_foundation-3.2.1-cp310-cp310-win32.whl", hash = "sha256:677e98165dcbbf7a2367f905bc61090ef2c568b6e465f87cf7276df4734f3b0b", size = 111969, upload-time = "2025-06-06T07:10:55.77Z" },
+    { url = "https://files.pythonhosted.org/packages/52/71/046c1e2424627c3db66d764871186de4d26936e8a138d6bf04dc143e4606/winrt_windows_foundation-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:a8f27b4f0fdb73ccc4a3e24bc8010a6607b2bdd722fa799eafce7daa87d19d39", size = 118695, upload-time = "2025-06-06T07:10:56.782Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/2e/2463bc4ad984836fb3ecf1abac62df67bc5cabab004cad09b828b86ed51b/winrt_windows_foundation-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:d900c6165fab4ea589811efa2feed27b532e1b6f505f63bf63e2052b8cb6bdc4", size = 109690, upload-time = "2025-06-06T07:10:57.618Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/36/09b9757f7cbf269e67008ea2ad188a44f974c94c9b49ebf0b52d1a8c4069/winrt_windows_foundation-3.2.1-cp311-cp311-win32.whl", hash = "sha256:d1b5970241ccd61428f7330d099be75f4f52f25e510d82c84dbbdaadd625e437", size = 111944, upload-time = "2025-06-06T07:10:58.496Z" },
+    { url = "https://files.pythonhosted.org/packages/05/a5/216d66df6bdcee58eb3877fabc1544337e23f850bf9f93838db7f5698371/winrt_windows_foundation-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:f3762be2f6e0f2aedf83a0742fd727290b397ffe3463d963d29211e4ebb53a7e", size = 118465, upload-time = "2025-06-06T07:10:59.678Z" },
+    { url = "https://files.pythonhosted.org/packages/be/ca/48ca8b5bc5be5c7a5516c9e1d9a21861b4217e1b4ee57923aab6f13fa411/winrt_windows_foundation-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:806c77818217b3476e6c617293b3d5b0ff8a9901549dc3417586f6799938d671", size = 109609, upload-time = "2025-06-06T07:11:00.54Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/f8/495e304ddedd5ff2f196efbde906265cb75ade4d79e2937837f72ef654a0/winrt_windows_foundation-3.2.1-cp312-cp312-win32.whl", hash = "sha256:867642ccf629611733db482c4288e17b7919f743a5873450efb6d69ae09fdc2b", size = 112169, upload-time = "2025-06-06T07:11:01.438Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/5e/b5059e4ece095351c496c9499783130c302d25e353c18031d5231b1b3b3c/winrt_windows_foundation-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:45550c5b6c2125cde495c409633e6b1ea5aa1677724e3b95eb8140bfccbe30c9", size = 118668, upload-time = "2025-06-06T07:11:02.475Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/70/acbcb3ef07b1b67e2de4afab9176a5282cfd775afd073efe6828dfc65ace/winrt_windows_foundation-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:94f4661d71cb35ebc52be7af112f2eeabdfa02cb05e0243bf9d6bd2cafaa6f37", size = 109671, upload-time = "2025-06-06T07:11:03.538Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/71/5e87131e4aecc8546c76b9e190bfe4e1292d028bda3f9dd03b005d19c76c/winrt_windows_foundation-3.2.1-cp313-cp313-win32.whl", hash = "sha256:3998dc58ed50ecbdbabace1cdef3a12920b725e32a5806d648ad3f4829d5ba46", size = 112184, upload-time = "2025-06-06T07:11:04.459Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/7f/8d5108461351d4f6017f550af8874e90c14007f9122fa2eab9f9e0e9b4e1/winrt_windows_foundation-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6e98617c1e46665c7a56ce3f5d28e252798416d1ebfee3201267a644a4e3c479", size = 118672, upload-time = "2025-06-06T07:11:05.55Z" },
+    { url = "https://files.pythonhosted.org/packages/44/f5/2edf70922a3d03500dab17121b90d368979bd30016f6dbca0d043f0c71f1/winrt_windows_foundation-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:2a8c1204db5c352f6a563130a5a41d25b887aff7897bb677d4ff0b660315aad4", size = 109673, upload-time = "2025-06-06T07:11:06.398Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/0a/d77346e39fe0c81f718cde49f83fe77c368c0e14c6418f72dfa1e7ef22d0/winrt_windows_foundation-3.2.1-cp314-cp314-win32.whl", hash = "sha256:35e973ab3c77c2a943e139302256c040e017fd6ff1a75911c102964603bba1da", size = 114590, upload-time = "2025-09-20T07:11:49.97Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/56/4d2b545bea0f34f68df6d4d4ca22950ff8a935497811dccdc0ca58737a05/winrt_windows_foundation-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:a22a7ebcec0d262e60119cff728f32962a02df60471ded8b2735a655eccc0ef5", size = 122148, upload-time = "2025-09-20T07:11:50.826Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/ed/b9d3a11cac73444c0a3703200161cd7267dab5ab85fd00e1f965526e74a8/winrt_windows_foundation-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:3be7fbae829b98a6a946db4fbaf356b11db1fbcbb5d4f37e7a73ac6b25de8b87", size = 114360, upload-time = "2025-09-20T07:11:51.626Z" },
+]
+
+[[package]]
+name = "winrt-windows-foundation-collections"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ef/62/d21e3f1eeb8d47077887bbf0c3882c49277a84d8f98f7c12bda64d498a07/winrt_windows_foundation_collections-3.2.1.tar.gz", hash = "sha256:0eff1ad0d8d763ad17e9e7bbd0c26a62b27215016393c05b09b046d6503ae6d5", size = 16043, upload-time = "2025-06-06T14:41:53.983Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/35/26/ed3d35ea262999d28be957c35a32e93360eac0ef9f14e75d32cd6b5c6a37/winrt_windows_foundation_collections-3.2.1-cp310-cp310-win32.whl", hash = "sha256:46948484addfc4db981dab35688d4457533ceb54d4954922af41503fddaa8389", size = 59880, upload-time = "2025-06-06T07:11:10.177Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/39/b4a1aeba2d13c1f2ad3d851d5092b8397c05f34fb318d6a7d499f5b5720b/winrt_windows_foundation_collections-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:899eaa3a93c35bfb1857d649e8dd60c38b978dda7cedd9725fcdbcebba156fd6", size = 70650, upload-time = "2025-06-06T07:11:11.396Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/74/f8a4a29202da24f2af2c4a8f515b0a44fe46bc4d25b3d54ea2249e980bd3/winrt_windows_foundation_collections-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:c36eb49ad1eba1b32134df768bb47af13cabb9b59f974a3cea37843e2d80e0e6", size = 59216, upload-time = "2025-06-06T07:11:12.575Z" },
+    { url = "https://files.pythonhosted.org/packages/87/b3/7e4a75c62e86bedf9458b7ec8dfed74cff3236e0b4b2288f95967d5cc4d2/winrt_windows_foundation_collections-3.2.1-cp311-cp311-win32.whl", hash = "sha256:9b272d9936e7db4840881c5dcf921eb26789ae4ef23fb6ec15e13e19a16254e7", size = 59693, upload-time = "2025-06-06T07:11:13.388Z" },
+    { url = "https://files.pythonhosted.org/packages/32/58/049db1d95fdfc0c8451dc6db17442ed4e6b2aba361c425c0bb8dc8c98c4a/winrt_windows_foundation_collections-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:c646a5d442dd6540ade50890081ca118b41f073356e19032d0a5d7d0d38fbc89", size = 70828, upload-time = "2025-06-06T07:11:14.54Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/6b/a04974f5555c86452e54c19d063d9fd45f0fe9f2a6858e7fe12c639043fb/winrt_windows_foundation_collections-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:2c4630027c93cdd518b0cf4cc726b8fbdbc3388e36d02aa1de190a0fc18ca523", size = 59051, upload-time = "2025-06-06T07:11:15.379Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/0b/7802349391466d3f7e8f62f588f36a1a0b6560abfcdbdaa426fe21d322b4/winrt_windows_foundation_collections-3.2.1-cp312-cp312-win32.whl", hash = "sha256:15704eef3125788f846f269cf54a3d89656fa09a1dc8428b70871f717d595ad6", size = 60060, upload-time = "2025-06-06T07:11:16.173Z" },
+    { url = "https://files.pythonhosted.org/packages/37/94/5b888713e472746635a382e523513ab1b8200af55c5b56bc70e1e4369115/winrt_windows_foundation_collections-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:550dfb8c82fe74d9e0728a2a16a9175cc9e34ca2b8ef758d69b2a398894b698b", size = 69058, upload-time = "2025-06-06T07:11:17.009Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/3c/829273622c9b37c67b97f187b92be318404f7d33db045e31d72b7d50f54c/winrt_windows_foundation_collections-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:810ad4bd11ab4a74fdbcd3ed33b597ef7c0b03af73fc9d7986c22bcf3bd24f84", size = 58793, upload-time = "2025-06-06T07:11:17.837Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/cd/99ef050d80bea2922fa1ded93e5c250732634095d8bd3595dd808083e5ca/winrt_windows_foundation_collections-3.2.1-cp313-cp313-win32.whl", hash = "sha256:4267a711b63476d36d39227883aeb3fb19ac92b88a9fc9973e66fbce1fd4aed9", size = 60063, upload-time = "2025-06-06T07:11:18.65Z" },
+    { url = "https://files.pythonhosted.org/packages/94/93/4f75fd6a4c96f1e9bee198c5dc9a9b57e87a9c38117e1b5e423401886353/winrt_windows_foundation_collections-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:5e12a6e75036ee90484c33e204b85fb6785fcc9e7c8066ad65097301f48cdd10", size = 69057, upload-time = "2025-06-06T07:11:19.446Z" },
+    { url = "https://files.pythonhosted.org/packages/40/76/de47ccc390017ec5575e7e7fd9f659ee3747c52049cdb2969b1b538ce947/winrt_windows_foundation_collections-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:34b556255562f1b36d07fba933c2bcd9f0db167fa96727a6cbb4717b152ad7a2", size = 58792, upload-time = "2025-06-06T07:11:20.24Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/47/b3301d964422d4611c181348149a7c5956a2a76e6339de451a000d4ae8e7/winrt_windows_foundation_collections-3.2.1-cp314-cp314-win32.whl", hash = "sha256:33188ed2d63e844c8adfbb82d1d3d461d64aaf78d225ce9c5930421b413c45ab", size = 62211, upload-time = "2025-09-20T07:11:52.411Z" },
+    { url = "https://files.pythonhosted.org/packages/20/59/5f2c940ff606297129e93ebd6030c813e6a43a786de7fc33ccb268e0b06b/winrt_windows_foundation_collections-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:d4cfece7e9c0ead2941e55a1da82f20d2b9c8003bb7a8853bb7f999b539f80a4", size = 70399, upload-time = "2025-09-20T07:11:53.254Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/2d/2c8eb89062c71d4be73d618457ed68e7e2ba29a660ac26349d44fc121cbf/winrt_windows_foundation_collections-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:3884146fea13727510458f6a14040b7632d5d90127028b9bfd503c6c655d0c01", size = 61392, upload-time = "2025-09-20T07:11:53.993Z" },
+]
+
+[[package]]
+name = "winrt-windows-storage-streams"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "winrt-runtime" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/00/50/f4488b07281566e3850fcae1021f0285c9653992f60a915e15567047db63/winrt_windows_storage_streams-3.2.1.tar.gz", hash = "sha256:476f522722751eb0b571bc7802d85a82a3cae8b1cce66061e6e758f525e7b80f", size = 34335, upload-time = "2025-06-06T14:43:23.905Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/4d/a0d806f4664b9bcf525bd31dcdf1f9520cc14f033e897dc7f7dd4ad4eb77/winrt_windows_storage_streams-3.2.1-cp310-cp310-win32.whl", hash = "sha256:89bb2d667ebed6861af36ed2710757456e12921ee56347946540320dacf6c003", size = 127791, upload-time = "2025-06-06T14:01:56.192Z" },
+    { url = "https://files.pythonhosted.org/packages/99/2c/00baa87041a3d92a3cc5230d4033e995a52740e9c08fcd9f7bde93cb979f/winrt_windows_storage_streams-3.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:48a78e5dc7d3488eb77e449c278bc6d6ac28abcdda7df298462c4112d7635d00", size = 132608, upload-time = "2025-06-06T14:01:57.3Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/d0/ed03e864aa8eaaec964d5bbc95baccf738275ae6cc88600db66ecb5adaf4/winrt_windows_storage_streams-3.2.1-cp310-cp310-win_arm64.whl", hash = "sha256:da71231d4a554f9f15f1249b4990c6431176f6dfb0e3385c7caa7896f4ca24d6", size = 128495, upload-time = "2025-06-06T14:01:58.124Z" },
+    { url = "https://files.pythonhosted.org/packages/19/60/a9e0dc03434aa29e6b5c83067e988cd5934adf830cd9f87cbbc06569ca32/winrt_windows_storage_streams-3.2.1-cp311-cp311-win32.whl", hash = "sha256:7dace2f9e364422255d0e2f335f741bfe7abb1f4d4f6003622b2450b87c91e69", size = 127509, upload-time = "2025-06-06T14:01:58.971Z" },
+    { url = "https://files.pythonhosted.org/packages/23/98/6c9c21b5e75ff5927a130da9eaf5ab628dfa1f93b64c181f0193706cbd6c/winrt_windows_storage_streams-3.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:b02fa251a7eef6081eca1a5f64ecf349cfd1ac0ac0c5a5a30be52897d060bed5", size = 132491, upload-time = "2025-06-06T14:01:59.788Z" },
+    { url = "https://files.pythonhosted.org/packages/38/ca/d0a02045d445cbf1029d65f01b487fdded5b333c0367a8bae0565b3def00/winrt_windows_storage_streams-3.2.1-cp311-cp311-win_arm64.whl", hash = "sha256:efdf250140340a75647e8e8ad002782d91308e9fdd1e19470a5b9cc969ae4780", size = 128577, upload-time = "2025-06-06T14:02:00.623Z" },
+    { url = "https://files.pythonhosted.org/packages/87/e7/7d3f2a4a442f264e05cab2bdf20ed1b95cb3f753bd1b0f277f2b49fb8335/winrt_windows_storage_streams-3.2.1-cp312-cp312-win32.whl", hash = "sha256:77c1f0e004b84347b5bd705e8f0fc63be8cd29a6093be13f1d0869d0d97b7d78", size = 127787, upload-time = "2025-06-06T14:02:02.277Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/2f/cc36f475f8af293f40e2c2a5d6c2e75a189c2c2d4d01ecb3551578518c79/winrt_windows_storage_streams-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:e4508ee135af53e4fc142876abbf4bc7c2a95edfc7d19f52b291a8499cacd6dc", size = 131849, upload-time = "2025-06-06T14:02:03.09Z" },
+    { url = "https://files.pythonhosted.org/packages/94/84/896fb734f7456910ec412f3f3adfdc3f0dc3134864a496d5b120592f3bfd/winrt_windows_storage_streams-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:040cb94e6fb26b0d00a00e8b88b06fadf29dfe18cf24ed6cb3e69709c3613307", size = 128144, upload-time = "2025-06-06T14:02:03.946Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/d2/24d9f59bdc05e741261d5bec3bcea9a848d57714126a263df840e2b515a8/winrt_windows_storage_streams-3.2.1-cp313-cp313-win32.whl", hash = "sha256:401bb44371720dc43bd1e78662615a2124372e7d5d9d65dfa8f77877bbcb8163", size = 127774, upload-time = "2025-06-06T14:02:04.752Z" },
+    { url = "https://files.pythonhosted.org/packages/15/59/601724453b885265c7779d5f8025b043a68447cbc64ceb9149d674d5b724/winrt_windows_storage_streams-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:202c5875606398b8bfaa2a290831458bb55f2196a39c1d4e5fa88a03d65ef915", size = 131827, upload-time = "2025-06-06T14:02:05.601Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/c2/a419675a6087c9ea496968c9b7805ef234afa585b7483e2269608a12b044/winrt_windows_storage_streams-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:ca3c5ec0aab60895006bf61053a1aca6418bc7f9a27a34791ba3443b789d230d", size = 128180, upload-time = "2025-06-06T14:02:06.759Z" },
+    { url = "https://files.pythonhosted.org/packages/55/70/2869ea2112c565caace73c9301afd1d7afcc49bdd37fac058f0178ba95d4/winrt_windows_storage_streams-3.2.1-cp314-cp314-win32.whl", hash = "sha256:5cd0dbad86fcc860366f6515fce97177b7eaa7069da261057be4813819ba37ee", size = 131701, upload-time = "2025-09-20T07:17:16.849Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/3d/aae50b1d0e37b5a61055759aedd42c6c99d7c17ab8c3e568ab33c0288938/winrt_windows_storage_streams-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:3c5bf41d725369b9986e6d64bad7079372b95c329897d684f955d7028c7f27a0", size = 135566, upload-time = "2025-09-20T07:17:17.69Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/c3/6d3ce7a58e6c828e0795c9db8790d0593dd7fdf296e513c999150deb98d4/winrt_windows_storage_streams-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:293e09825559d0929bbe5de01e1e115f7a6283d8996ab55652e5af365f032987", size = 134393, upload-time = "2025-09-20T07:17:18.802Z" },
+]
+
+[[package]]
+name = "yarl"
+version = "1.24.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "multidict" },
+    { name = "propcache" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/79/12/1e8f37460ea0f7eb59c221fdaf0ed75e7ac43e97f8093b9c6f411df50a78/yarl-1.24.2.tar.gz", hash = "sha256:9ac374123c6fd7abf64d1fec93962b0bd4ee2c19751755a762a72dd96c0378f8", size = 210798, upload-time = "2026-05-19T21:31:05.599Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3f/df/f1c7a3de0831cd83194f1a85c5bb431b13f81e6b45079314c86d1c4ef3f2/yarl-1.24.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:5249a113065c2b7a958bc699759e359cd61cfc81e3069662208f48f191b7ed12", size = 129057, upload-time = "2026-05-19T21:27:47.564Z" },
+    { url = "https://files.pythonhosted.org/packages/48/41/7daafb32dd7562bf45b1ce56562e7e1a9146f6479b6456873eb8a3413c40/yarl-1.24.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:7f4425fa244fbf530b006d0c5f79ce920114cfff5b4f5f6056e669f8e160fdc0", size = 91545, upload-time = "2026-05-19T21:27:50.089Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/8f/7b3ec212f1ea0683f55f978e3246bc313c38818664edfc97a9f349a4901e/yarl-1.24.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:15c0b5e49d3c44e2a0b93e6a49476c5edad0a7686b92c395765a7ea775572a75", size = 91380, upload-time = "2026-05-19T21:27:51.953Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/1b/8bafab7db23b0567ae9db749099b329d91e3b82bc6028b2050ba583e116c/yarl-1.24.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:246d32a53a947c8f0189f5d699cbd4c7036de45d9359e13ba238d1239678c727", size = 105957, upload-time = "2026-05-19T21:27:53.98Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/77/21030c2f8d21d21559719beafc772ada2014be933418ed1eaed9cc800e42/yarl-1.24.2-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:64480fb3e4d4ed9ed71c48a91a477384fc342a50ca30071d2f8a88d51d9c9413", size = 97242, upload-time = "2026-05-19T21:27:55.981Z" },
+    { url = "https://files.pythonhosted.org/packages/50/d8/f9ea63d1b6aa910a866e089d871fff6cbd49caab29b86b35221a62dfa0d5/yarl-1.24.2-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:349de4701dc3760b6e876628423a8f147ef4f5599d10aba1e10702075d424ed9", size = 114719, upload-time = "2026-05-19T21:27:58.037Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/a3/04e0ee98ac58a249ea7ed75223f5f901ba81a834f0b4921b58e5cec11757/yarl-1.24.2-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d162677af8d5d3d6ebab8394b021f4d041ac107a4b705873148a77a49dc9e1b2", size = 112140, upload-time = "2026-05-19T21:27:59.618Z" },
+    { url = "https://files.pythonhosted.org/packages/02/ad/0b9cc9f38a7324a7eb1d80f834eaa5283d17e9271bbda3186e598dddaeac/yarl-1.24.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f5f5c6ec23a9043f2d139cc072f53dd23168d202a334b9b2fda8de4c3e890d90", size = 106721, upload-time = "2026-05-19T21:28:02.586Z" },
+    { url = "https://files.pythonhosted.org/packages/65/e7/a52478ebfc66ec989e085c6ae038b9f1bfa4190baa193b133b669c709e2f/yarl-1.24.2-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:60de6742447fbbf697f16f070b8a443f1b5fe6ca3826fbef9fe70ecd5328e643", size = 106478, upload-time = "2026-05-19T21:28:04.523Z" },
+    { url = "https://files.pythonhosted.org/packages/04/d8/5508530fea8472542de00013ae280765fc938ee196fc4030c43a498afb36/yarl-1.24.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:acf93187c3710e422368eb768aee98db551ec7c85adc250207a95c16548ab7ac", size = 105423, upload-time = "2026-05-19T21:28:06.515Z" },
+    { url = "https://files.pythonhosted.org/packages/84/f1/ece28505e9628e8b756e11bb4f28864a17cc33b6b44db4d2aaf0622bf630/yarl-1.24.2-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:f4b0352fd41fd34b6651934606268816afd6914d09626f9bcbbf018edb0afb3f", size = 99878, upload-time = "2026-05-19T21:28:08.637Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/52/fb5d34529b46dd84013afcfb30b8d2bc2832ed03d412736f577d604fa393/yarl-1.24.2-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:6b208bb939099b4b297438da4e9b25357f0b1c791888669b963e45b203ea9f36", size = 114025, upload-time = "2026-05-19T21:28:10.64Z" },
+    { url = "https://files.pythonhosted.org/packages/43/f0/ff9d31aaab024f7a251c0ed308a98ae29bf9f7dc344e78f28b1322431ca2/yarl-1.24.2-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:4b85b8825e631295ff4bc8943f7471d54c533a9360bbe15ebb38e018b555bb8a", size = 105613, upload-time = "2026-05-19T21:28:12.784Z" },
+    { url = "https://files.pythonhosted.org/packages/31/7d/3296fb3f3ecd52bf9ae6c16b0895c1cda7e9170a2083861552b683f70264/yarl-1.24.2-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:e26acf20c26cb4fefc631fdb75aca2a6b8fa8b7b5d7f204fb6a8f1e63c706f53", size = 111665, upload-time = "2026-05-19T21:28:14.393Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/74/77aa6ddaca4fbf42e45e675a465c43956dd40702281049975a2aa04eae59/yarl-1.24.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:819ca24f8eafcfb683c1bd5f44f2f488cea1274eb8944731ffd2e1f10f619342", size = 106914, upload-time = "2026-05-19T21:28:15.893Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/02/7611f22cd1d4ed7373eb7f9ee21fde1046edba2e7c0e514880d760352f48/yarl-1.24.2-cp310-cp310-win_amd64.whl", hash = "sha256:5cb0f995a901c36be096ccbf4c673591c2faabbe96279598ffaec8c030f85bf4", size = 92658, upload-time = "2026-05-19T21:28:17.471Z" },
+    { url = "https://files.pythonhosted.org/packages/91/00/671d0add79938127292839ae44506ce2f7fe8909c72d5a931864f128fd0b/yarl-1.24.2-cp310-cp310-win_arm64.whl", hash = "sha256:f408eace7e22a68b467a0562e0d27d322f91fe3eaaa6f466b962c6cfaea9fa39", size = 87887, upload-time = "2026-05-19T21:28:19.021Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/c5/1ce244152ff2839645e7cae92f90e7bafcb2c52bea7ff586ac714f14f5df/yarl-1.24.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:36348bebb147b83818b9d7e673ea4debc75970afc6ffdc7e3975ad05ce5a58c1", size = 128971, upload-time = "2026-05-19T21:28:20.543Z" },
+    { url = "https://files.pythonhosted.org/packages/87/5a/00f36967203ed89cb3acd2c8ed526cc3fed9418eb70ce128160a911c8499/yarl-1.24.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1a97e42c8a2233f2f279ecadd9e4a037bcb5d813b78435e8eedd4db5a9e9708c", size = 91507, upload-time = "2026-05-19T21:28:22.556Z" },
+    { url = "https://files.pythonhosted.org/packages/31/d0/1fb0c1cd27288f39f6974da4318c32768d72c9890984541fdf1e2e32a51d/yarl-1.24.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:8d027d56f1035e339d1001ac33eceab5b2ec8e42e449787bb75e289fb9a5cd1d", size = 91343, upload-time = "2026-05-19T21:28:24.092Z" },
+    { url = "https://files.pythonhosted.org/packages/03/ce/d4a646508bed2f8dec6435b40166fe9308dd191262033d3f307b2bbcaecd/yarl-1.24.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0a6377060e7927187a42b7eb202090cbe2b34933a4eeaf90e3bd9e33432e5cae", size = 105704, upload-time = "2026-05-19T21:28:25.872Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/07/b3278e82d8bc41485bcf6d856cd0433262593de615b1d3dc43bd3f5bead4/yarl-1.24.2-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:17076578bce0049a5ce57d14ad1bded391b68a3b213e9b81b0097b090244999a", size = 97281, upload-time = "2026-05-19T21:28:27.352Z" },
+    { url = "https://files.pythonhosted.org/packages/17/5b/4cee6e7c92e487bebe7afc797da0aa54a248ab4e776a68fe369ec29665a5/yarl-1.24.2-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:50713f1d4d6be6375bb178bb43d140ee1acb8abe589cd723320b7925a275be1e", size = 114020, upload-time = "2026-05-19T21:28:29.458Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/82/111076571545a7d4f9cca3fbd5c6f40615af58642be09f12328f48022468/yarl-1.24.2-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:34263e2fa8fb5bb63a0d97706cda38edbad62fddb58c7f12d6acbc092812aa50", size = 111450, upload-time = "2026-05-19T21:28:31.262Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/ec/08f671f69a444d704aeecebf92af659b67b97a869942411d0a578b08c334/yarl-1.24.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:49016d82f032b1bd1e10b01078a7d29ae71bf468eeae0ea22df8bab691e60003", size = 106384, upload-time = "2026-05-19T21:28:32.856Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/86/ce41e7a7a199340b2330d52b60f25c4074b6636dd0e60b1a80d31a9db042/yarl-1.24.2-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3f6d2c216318f8f32038ca3f72501ba08536f0fd18a36e858836b121b2deed9f", size = 106153, upload-time = "2026-05-19T21:28:35.222Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/5d/31be8a729531ab3e55ac3e7e5c800be8c89ea98947f418b2f6ea259fb6ee/yarl-1.24.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:08d3a33218e0c64393e7610284e770409a9c31c429b078bcb24096ed0a783b8f", size = 105322, upload-time = "2026-05-19T21:28:36.642Z" },
+    { url = "https://files.pythonhosted.org/packages/47/9b/b57afb22b386ae87ac9940f09878b98d8c333f89113e6fc96fcf4ca9eb64/yarl-1.24.2-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:5d699376c4ca3cba49bbfae3a05b5b70ded572937171ce1e0b8d87118e2ba294", size = 99057, upload-time = "2026-05-19T21:28:38.386Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/4f/06348c27c8389256c313e8a57d796808fc0264c915dd5e7cfd3c0e314dc7/yarl-1.24.2-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:a1cab588b4fa14bea2e55ebea27478adfb05372f47573738e1acc4a36c0b05d2", size = 113502, upload-time = "2026-05-19T21:28:40.091Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/1c/284f307b298e4a17b7943b07d9d7ecc4151537f8d137ba51f3bb6c31ca20/yarl-1.24.2-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:ec87ccc31bd21db7ad009d8572c127c1000f268517618a4cc09adba3c2a7f21c", size = 105253, upload-time = "2026-05-19T21:28:41.987Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/bf/0de123bec8619e45c80cbded9085f61b5b4a9eddb8abe6d25d28ee1ec866/yarl-1.24.2-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:d1dd47a22843b212baa8d74f37796815d43bd046b42a0f41e9da433386c3136b", size = 111345, upload-time = "2026-05-19T21:28:43.93Z" },
+    { url = "https://files.pythonhosted.org/packages/90/af/0248eb065e51129d2a9b2436cd1b5c772c19a6b04e5b6a186955671e3319/yarl-1.24.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7b54b9c67c2b06bd7b9a77253d242124b9c95d2c02def5a1144001ee547dd9d5", size = 106558, upload-time = "2026-05-19T21:28:45.806Z" },
+    { url = "https://files.pythonhosted.org/packages/21/3c/f960d7a65ef97d8ba9b424fb5128796a4bc710fc6df2ddbbd7dfdc3bbd20/yarl-1.24.2-cp311-cp311-win_amd64.whl", hash = "sha256:f8fdbcff8b2c7c9284e60c196f693588598ddcee31e11c18e14949ce44519d45", size = 92808, upload-time = "2026-05-19T21:28:48.465Z" },
+    { url = "https://files.pythonhosted.org/packages/03/1a/49fb03750e4de4d2284cd5b885a383133c34eef45bd59631b2bb8b7e81e8/yarl-1.24.2-cp311-cp311-win_arm64.whl", hash = "sha256:b32c37a7a337e90822c45797bf3d79d60875cfcccd3ecc80e9f453d87026c122", size = 87610, upload-time = "2026-05-19T21:28:50.07Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/da/866bcb01076ba49d2b42b309867bed3826421f1c479655eb7a607b44f20b/yarl-1.24.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:b975866c184564c827e0877380f0dae57dcca7e52782128381b72feff6dfceb8", size = 129957, upload-time = "2026-05-19T21:28:51.695Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/1d/fcefb70922ea2268a8971d8e5874d9a8218644200fb8465f1dcad55e6851/yarl-1.24.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:3b075301a2836a0e297b1b658cb6d6135df535d62efefdd60366bd589c2c82f2", size = 92164, upload-time = "2026-05-19T21:28:53.242Z" },
+    { url = "https://files.pythonhosted.org/packages/29/b6/170e2b8d4e3bc30e6bfdcca53556537f5bf595e938632dfcb059311f3ff6/yarl-1.24.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8ae44649b00947634ab0dab2a374a638f52923a6e67083f2c156cd5cbd1a881d", size = 91688, upload-time = "2026-05-19T21:28:54.865Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/a5/c9f655d5553ea0b99fdac9d6a99ad3f9b3e73b8e5758bb46f58c9831f74c/yarl-1.24.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:507cc19f0b45454e2d6dcd62ff7d062b9f77a2812404e62dbdaec05b50faa035", size = 102902, upload-time = "2026-05-19T21:28:56.963Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/bc/6b9664d815d79af4ee553337f9d606c56bbf269186ada9172de45f1b5f60/yarl-1.24.2-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c4c17bad5a530912d2111825d3f05e89bab2dd376aaa8cbc77e449e6db63e576", size = 97931, upload-time = "2026-05-19T21:28:58.56Z" },
+    { url = "https://files.pythonhosted.org/packages/98/ec/32ba48acae30fecd60928f5791188b80a9d6ee3840507ffda29fecd37b71/yarl-1.24.2-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f5f0cbb112838a4a293985b6ed73948a547dadcc1ba6d2089938e7abdedceef8", size = 111030, upload-time = "2026-05-19T21:29:00.148Z" },
+    { url = "https://files.pythonhosted.org/packages/82/5a/6f4cd081e5f4934d2ae3a8ef4abe3afacc010d26f0035ee91b35cd7d7c37/yarl-1.24.2-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5ec8356b8a6afcf81fc7aeeef13b1ff7a49dec00f313394bbb9e83830d32ccd7", size = 110392, upload-time = "2026-05-19T21:29:02.155Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/da/323a01c349bd5fb01bb6652e314d9bb218cee630a736bdb810ad50e4013f/yarl-1.24.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7e7ebcdef69dec6c6451e616f32b622a6d4a2e92b445c992f7c8e5274a6bbc4c", size = 105612, upload-time = "2026-05-19T21:29:04.247Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/80/264ab684f181e1a876389374519ff05d10248725535ae2ac4e8ac4e563d6/yarl-1.24.2-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:47a55d6cf6db2f401017a9e96e5288844e5051911fb4e0c8311a3980f5e59a7d", size = 104487, upload-time = "2026-05-19T21:29:06.491Z" },
+    { url = "https://files.pythonhosted.org/packages/41/07/efabe5df87e96d7ad5959760b888344be48cd6884db127b407c6b5503adc/yarl-1.24.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3065657c80a2321225e804048597ad55658a7e76b32d6f5ee4074d04c50401db", size = 102333, upload-time = "2026-05-19T21:29:08.267Z" },
+    { url = "https://files.pythonhosted.org/packages/44/0c/bcf7c42603e1009295f586d8890f2ba032c8b53310e815adf0a202c73d9f/yarl-1.24.2-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:cb84b80d88e19ede158619b80813968713d8d008b0e2497a576e6a0557d50712", size = 99025, upload-time = "2026-05-19T21:29:10.682Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/82/84482ab1a57a0f21a08afe6a7004c61d741f8f2ecc3b05c321577c612164/yarl-1.24.2-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:990de4f680b1c217e77ff0d6aa0029f9eb79889c11fb3e9a3942c7eba29c1996", size = 110507, upload-time = "2026-05-19T21:29:12.954Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/8d/a546ba1dfe1b0f290e05fef145cd07614c0f15df1a707195e512d1e39d1d/yarl-1.24.2-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:abb8ec0323b80161e3802da3150ef660b41d0e9be2048b76a363d93eee992c2b", size = 103719, upload-time = "2026-05-19T21:29:14.893Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/b6/267f2a09213138473adfce6b8a6e17791d7fee70bd4d9003218e4dec58b0/yarl-1.24.2-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:e7977781f83638a4c73e0f88425563d70173e0dfd90ac006a45c65036293ee3c", size = 110438, upload-time = "2026-05-19T21:29:16.485Z" },
+    { url = "https://files.pythonhosted.org/packages/48/2d/1c8d89c7c5f9cad9fb2902445d94e2ab1d7aa35de029afbb8ae95c42d00f/yarl-1.24.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e30dd55825dc554ec5b66a94953b8eda8745926514c5089dfcacecb9c99b5bd1", size = 105719, upload-time = "2026-05-19T21:29:18.367Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/25/722e3b93bd687009afb2d59a35e13d30ddd8f80571445bb0c4e4ce26ec66/yarl-1.24.2-cp312-cp312-win_amd64.whl", hash = "sha256:7dafe10c12ddd4d120d528c4b5599c953bd7b12845347d507b95451195bb6cad", size = 92901, upload-time = "2026-05-19T21:29:20.014Z" },
+    { url = "https://files.pythonhosted.org/packages/39/47/4486ccfb674c04854a1ef8aa77868b6a6f765feaf69633409d7ca4f02cb8/yarl-1.24.2-cp312-cp312-win_arm64.whl", hash = "sha256:044a09d8401fcf8681977faef6d286b8ade1e2d2e9dceda175d1cfa5ca496f30", size = 87229, upload-time = "2026-05-19T21:29:22.1Z" },
+    { url = "https://files.pythonhosted.org/packages/82/62/fcf0ce677f17e5c471c06311dd25964be38a4c586993632910d2e75278bc/yarl-1.24.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:491ac9141decf49ee8030199e1ee251cdff0e131f25678817ff6aa5f837a3536", size = 128978, upload-time = "2026-05-19T21:29:23.83Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/58/8e63299bb71ed61a834121d9d3fe6c9fcf2a6a5d09754ff4f20f2d20baf5/yarl-1.24.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e89418f65eda18f99030386305bd44d7d504e328a7945db1ead514fbe03a0607", size = 91733, upload-time = "2026-05-19T21:29:25.375Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/24/16748d5dab6daec8b0ed81ccec639a1cded0f18dcc62a4f696b4fe366c37/yarl-1.24.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:cdfcce633b4a4bb8281913c57fcafd4b5933fbc19111a5e3930bbd299d6102f1", size = 91113, upload-time = "2026-05-19T21:29:26.928Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/66/b63fff7b71211e866624b21432d5943cbb633eb0c2872d9ee3070648f22c/yarl-1.24.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:863297ddede92ee49024e9a9b11ecb59f310ca85b60d8537f56bed9bbb5b1986", size = 103899, upload-time = "2026-05-19T21:29:28.842Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/ac/ba1974b8533909636f7733fe86cf677e3619527c3c2fa913e0ea89c48757/yarl-1.24.2-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:374423f70754a2c96942ede36a29d37dc6b0cb8f92f8d009ddf3ed78d3da5488", size = 97862, upload-time = "2026-05-19T21:29:31.086Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/a5/123ac993b5c2ba6f554a140305620cb8f150fa543711bbc49be3ec0a65a4/yarl-1.24.2-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:33a29b5d00ccbf3219bb3e351d7875739c19481e030779f48cc46a7a71681a9b", size = 111060, upload-time = "2026-05-19T21:29:32.657Z" },
+    { url = "https://files.pythonhosted.org/packages/23/37/c472d3af3509688392134a88a825276770a187f1daa4de3f6dc0a327a751/yarl-1.24.2-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a9532c57211730c515341af11fef6e9b61d157487272a096d0c04da445642592", size = 110613, upload-time = "2026-05-19T21:29:34.379Z" },
+    { url = "https://files.pythonhosted.org/packages/df/88/09c28dad91e662ccfaa1b78f1c57badde74fc9d0b23e74aef644750ecd73/yarl-1.24.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:91e72cf093fd833483a97ee648e0c053c7c629f51ff4a0e7edd84f806b0c5617", size = 107012, upload-time = "2026-05-19T21:29:36.216Z" },
+    { url = "https://files.pythonhosted.org/packages/07/ab/9d4f69d571a94f4d112fa7e2e007200f5a54d319f58c82ac7b7baa61f5c6/yarl-1.24.2-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b3177bc0a768ef3bacceb4f272632990b7bea352f1b2f1eee9d6d6ff16516f92", size = 105887, upload-time = "2026-05-19T21:29:38.746Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/9a/000b2b66c0d772a499fc531d21dab92dfeb73b640a12eed6ba89f49bb2d0/yarl-1.24.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e196952aacaf3b232e265ff02980b64d483dc0972bd49bcb061171ff22ac203a", size = 103620, upload-time = "2026-05-19T21:29:40.368Z" },
+    { url = "https://files.pythonhosted.org/packages/41/7c/7c1050f73450fbdaa3f0c72017059f00ce5e13366692f3dba25275a1083d/yarl-1.24.2-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:204e7a61ce99919c0de1bf904ab5d7aa188a129ea8f690a8f76cfb6e2844dc44", size = 100599, upload-time = "2026-05-19T21:29:42.66Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/b1/29e5756b3926705f5f6089bd5b9f50a56eaac550da6e260bf713ead44d04/yarl-1.24.2-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:4b156914620f0b9d78dc1adb3751141daee561cfec796088abb89ed49d220f1a", size = 110604, upload-time = "2026-05-19T21:29:44.632Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/4b/8415bc96e9b150cde942fbac9a8182985e58f40ce5c54c34ed015407d3ee/yarl-1.24.2-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:8372a2b976cf70654b2be6619ab6068acabb35f724c0fda7b277fbf53d66a5cf", size = 105161, upload-time = "2026-05-19T21:29:46.755Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/d4/cde059abfa229553b7298a2eadde2752e723d50aeedaef86ce59da2718ee/yarl-1.24.2-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:f9a1e9b622ca284143aab5d885848686dcd85453bb1ca9abcdb7503e64dc0056", size = 110619, upload-time = "2026-05-19T21:29:48.972Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/2c/d6a6c9a61549f7b6c7e6dc6937d195bcf069582b47b7200dcd0e7b256acf/yarl-1.24.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:810e19b685c8c3c5862f6a38160a1f4e4c0916c9390024ec347b6157a45a0992", size = 107362, upload-time = "2026-05-19T21:29:51Z" },
+    { url = "https://files.pythonhosted.org/packages/92/dd/3ae5fe417e9d1c353a548553326eb9935e76b6b727161563b424cc296df3/yarl-1.24.2-cp313-cp313-win_amd64.whl", hash = "sha256:7d37fb7c38f2b6edab0f845c4f85148d4c44204f52bc127021bd2bc9fdbf1656", size = 92667, upload-time = "2026-05-19T21:29:52.743Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cc/a7beb239f78f27fca1b053c8e8595e4179c02e62249b4687ec218c370c50/yarl-1.24.2-cp313-cp313-win_arm64.whl", hash = "sha256:1e831894be7c2954240e49791fa4b50c05a0dc881de2552cfe3ffd8631c7f461", size = 87069, upload-time = "2026-05-19T21:29:54.442Z" },
+    { url = "https://files.pythonhosted.org/packages/40/0e/e08087695fc12789263821c5dc0f8dc52b5b17efd0887cacf419f8a43ba3/yarl-1.24.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:f9312b3c02d9b3d23840f67952913c9c8721d7f1b7db305289faefa878f364c2", size = 129670, upload-time = "2026-05-19T21:29:56.631Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/98/ab4b5ed1b1b5cd973c8a3eb994c3a6aefb6ce6d399e21bb5f0316c33815c/yarl-1.24.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:a4f4d6cd615823bfc7fb7e9b5987c3f41666371d870d51058f77e2680fbe9630", size = 91916, upload-time = "2026-05-19T21:29:58.645Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/b1/5297bb6a7df4782f7605bffc43b31f5044070935fbbcaa6c705a07e6ac65/yarl-1.24.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0c3063e5c0a8e8e62fae6c2596fa01da1561e4cd1da6fec5789f5cf99a8aefd8", size = 91625, upload-time = "2026-05-19T21:30:00.412Z" },
+    { url = "https://files.pythonhosted.org/packages/02/a7/45baabfff76829264e623b185cff0c340d7e11bf3e1cd9ea37e7d17934bd/yarl-1.24.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fecd17873a096036c1c87ab3486f1aef7f269ada7f23f7f856f93b1cc7744f14", size = 104574, upload-time = "2026-05-19T21:30:02.544Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/40/3a5ab144d3d650ca37d4f4b57e56169be8af3ca34c448793e064b30baaed/yarl-1.24.2-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a46d1ab4ba4d32e6dc80daf8a28ce0bd83d08df52fbc32f3e288663427734535", size = 97534, upload-time = "2026-05-19T21:30:04.319Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/b5/5658fef3681fb5776b4513b052bec750009f47b3a592251c705d75375798/yarl-1.24.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:73e68edf6dfd5f73f9ca127d84e2a6f9213c65bdffb736bda19524c0564fcd14", size = 111481, upload-time = "2026-05-19T21:30:05.988Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/06/fdcd7dde037f00866dce123ed4ba23dba94beb56fc4cf561668d27be37f2/yarl-1.24.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a296ca617f2d25fbceafb962b88750d627e5984e75732c712154d058ae8d79a3", size = 111529, upload-time = "2026-05-19T21:30:07.738Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/53/d81269aaafccea0d33396c03035de997b743f11e648e6e27a0df99c72980/yarl-1.24.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e51b2cf5ec89a8b8470177641ed62a3ba22d74e1e898e06ad53aa77972487208", size = 107338, upload-time = "2026-05-19T21:30:09.713Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/04/23049463f729bd899df203a7960505a75333edd499cda8aa1d5a82b64df5/yarl-1.24.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:310fc687f7b2044ec54e372c8cbe923bb88f5c37bded0d3079e5791c2fc3cf50", size = 106147, upload-time = "2026-05-19T21:30:11.365Z" },
+    { url = "https://files.pythonhosted.org/packages/14/18/04a4b5830b43ed5e4c5015b40e9f6241ad91487d71611061b4e111d6ac80/yarl-1.24.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:297a2fe352ecf858b30a98f87948746ec16f001d279f84aebdbd3bd965e2f1bd", size = 104272, upload-time = "2026-05-19T21:30:12.978Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f7/8cffdf319aee7a7c1dbd07b61d91c3e3fda460c7a93b5f93e445f3806c4c/yarl-1.24.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:2a263e76b97bc42bdcd7c5f4953dec1f7cd62a1112fa7f869e57255229390d67", size = 99962, upload-time = "2026-05-19T21:30:15.001Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/39/b3cce3b7dbef64ac700ad4cea156a207d01bede0f507587616c364b5468e/yarl-1.24.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:822519b64cf0b474f1a0aaef1dc621438ea46bb77c94df97a5b4d213a7d8a8b1", size = 111063, upload-time = "2026-05-19T21:30:16.683Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/ea/100818505e7ebf165c7242ff17fdf7d9fee79e27234aeca871c1082920d7/yarl-1.24.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:b6067060d9dc594899ba83e6db6c48c68d1e494a6dab158156ed86977ca7bcb1", size = 105438, upload-time = "2026-05-19T21:30:18.769Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/d2/e075a0b32aa6625087de9e653087df0759fed5de4a435fef594181102a77/yarl-1.24.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:0063adad533e57171b79db3943b229d40dfafeeee579767f96541f106bac5f1b", size = 111458, upload-time = "2026-05-19T21:30:21.024Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/5c/ceea7ba98b65c8eb8d947fdc52f9bedfcd43c6a57c9e3c90c17be8f324a3/yarl-1.24.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ee8e3fb34513e8dc082b586ef4910c98335d43a6fab688cd44d4851bacfce3e8", size = 107589, upload-time = "2026-05-19T21:30:23.412Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/d9/5582d57e2b2db9b85eb6663a22efdd78e08805f3f5389566e9fcad254d1b/yarl-1.24.2-cp314-cp314-win_amd64.whl", hash = "sha256:afb00d7fd8e0f285ca29a44cc50df2d622ff2f7a6d933fa641577b5f9d5f3db0", size = 94424, upload-time = "2026-05-19T21:30:25.425Z" },
+    { url = "https://files.pythonhosted.org/packages/92/10/7dc07a0e22806a9280f42a57361395506e800c64e22737cd7b0886feab42/yarl-1.24.2-cp314-cp314-win_arm64.whl", hash = "sha256:68cf6eacd6028ef1142bc4b48376b81566385ca6f9e7dde3b0fa91be08ffcb57", size = 88690, upload-time = "2026-05-19T21:30:27.623Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/13/d5b8e2c8667db955bcb3de233f18798fefe7edf1d7429c2c9d4f9c401114/yarl-1.24.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:221ce1dd921ac4f603957f17d7c18c5cc0797fbb52f156941f92e04605d1d67b", size = 136248, upload-time = "2026-05-19T21:30:29.297Z" },
+    { url = "https://files.pythonhosted.org/packages/de/46/a4a97c05c9c9b8fd266bb2a0df12992c7fbd02391eb9640583411b6dab32/yarl-1.24.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:5f3224db28173a00d7afacdee07045cc4673dfab2b15492c7ae10deddbece761", size = 95084, upload-time = "2026-05-19T21:30:31.031Z" },
+    { url = "https://files.pythonhosted.org/packages/95/b2/845cf2074a015e6fe0d0808cf1a2d9e868386c4220d657ebd8302b199043/yarl-1.24.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c557165320d6244ebe3a02431b2a201a20080e02f41f0cfa0ccc47a183765da8", size = 95272, upload-time = "2026-05-19T21:30:33.062Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/16/e69d4aa244aef45235ddfebc0e04036a6829842bc5a6a795aedc6c998d23/yarl-1.24.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:904065e6e85b1fa54d0d87438bd58c14c0bad97aad654ad1077fd9d87e8478ed", size = 101497, upload-time = "2026-05-19T21:30:34.842Z" },
+    { url = "https://files.pythonhosted.org/packages/15/94/c07107715d621076863ee88b3ddf183fa5e9d4aba5769623c9979828410a/yarl-1.24.2-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:8cec2a38d70edc10e0e856ceda886af5327a017ccbde8e1de1bd44d300357543", size = 94002, upload-time = "2026-05-19T21:30:37.724Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/35/fc1bbdd895b5e4010b8fdd037f7ed3aa289d3863e08231b30231ca9a0815/yarl-1.24.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e7484b9361ed222ee1ca5b4337aa4cbdcc4618ce5aff57d9ef1582fd95893fc0", size = 106524, upload-time = "2026-05-19T21:30:40.196Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/f2/32b66d0a4ba47c296cf86d03e2c67bff58399fe6d6d84d5205c04c66cc6d/yarl-1.24.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:84f9670b89f34db07f81e53aee83e0b938a3412329d51c8f922488be7fcc4024", size = 106165, upload-time = "2026-05-19T21:30:41.888Z" },
+    { url = "https://files.pythonhosted.org/packages/95/47/37cb5ff50c5e825d4d38e81bb04d1b7e96bf960f7ab89f9850b162f3f114/yarl-1.24.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:abb2759733d63a28b4956500a5dd57140f26486c92b2caedfb964ab7d9b79dbf", size = 103010, upload-time = "2026-05-19T21:30:43.985Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/d2/4597912315096f7bb359e46e13bf8b60994fcbb2db29b804c0902ef4eff5/yarl-1.24.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:081c2bf54efe03774d0311172bc04fedf9ca01e644d4cd8c805688e527209bdc", size = 101128, upload-time = "2026-05-19T21:30:46.291Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/d5/c8e86e120521e646013d02a8e3b8884392e28494be8f392366e50d208efc/yarl-1.24.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:86746bef442aa479107fe28132e1277237f9c24c2f00b0b0cf22b3ee0904f2bb", size = 101382, upload-time = "2026-05-19T21:30:48.085Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/98/70b229236118f89dbeb739b76f10225bbf53b5497725502594c9a01d699a/yarl-1.24.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:2d07d21d0bc4b17558e8de0b02fbfdf1e347d3bb3699edd00bb92e7c57925420", size = 95964, upload-time = "2026-05-19T21:30:49.785Z" },
+    { url = "https://files.pythonhosted.org/packages/87/f8/56c386981e3c8648d279fdef2397ffec577e8320fd5649745e34d54faeb7/yarl-1.24.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:4fb1ac3fc5fecd8ae7453ea237e4d22b49befa70266dfe1629924245c21a0c7f", size = 106204, upload-time = "2026-05-19T21:30:51.862Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/1e/765afe97811ca35933e2a7de70ac57b1997ea2e4ee895719ee7a231fb7e5/yarl-1.24.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:4da31a5512ed1729ca8d8aacde3f7faeb8843cde3165d6bcf7f88f74f17bb8aa", size = 101510, upload-time = "2026-05-19T21:30:53.62Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/78/393913f4b9039e1edd09ae8a9bbb9d539be909a8abf6d8a2084585bed4b7/yarl-1.24.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:533ded4dceb5f1f3da7906244f4e82cf46cfd40d84c69a1faf5ac506aa65ecbe", size = 105584, upload-time = "2026-05-19T21:30:55.962Z" },
+    { url = "https://files.pythonhosted.org/packages/78/87/deb17b7049bbe74ea11a713b86f8f27800cc1c8648b0b797243ebb4830ba/yarl-1.24.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:7b3a85525f6e7eeabcfdd372862b21ee1915db1b498a04e8bf0e389b607ff0bd", size = 103410, upload-time = "2026-05-19T21:30:57.962Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/be/f9f7594e23b5b93affff0318e4593c1920331bcaefda326cabcad94296a1/yarl-1.24.2-cp314-cp314t-win_amd64.whl", hash = "sha256:a7624b1ca46ca5d7b864ef0d2f8efe3091454085ee1855b4e992314529972215", size = 102980, upload-time = "2026-05-19T21:30:59.735Z" },
+    { url = "https://files.pythonhosted.org/packages/65/a4/ba80dccd3593ff1f01051a818694d07b58cb8232677ee9a22a5a1f93a9fc/yarl-1.24.2-cp314-cp314t-win_arm64.whl", hash = "sha256:e434a45ce2e7a947f951fc5a8944c8cc080b7e59f9c50ae80fd39107cf88126d", size = 91219, upload-time = "2026-05-19T21:31:01.934Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/4d/4b880086bd0d3e034d25647be1d830afc3e3f610e98c4ab3490af6b1b6d5/yarl-1.24.2-py3-none-any.whl", hash = "sha256:2783d9226db8797636cd6896e4de81feed252d1db72265686c9558d97a4d94b9", size = 53576, upload-time = "2026-05-19T21:31:03.909Z" },
+]

From a7670f9f2c79c97c4aa3b3b6f6010e70253d8412 Mon Sep 17 00:00:00 2001
From: Magdalena Schneider <schneiderm2@hhmi.org>
Date: Fri, 5 Jun 2026 15:30:02 -0400
Subject: [PATCH 072/314] Pin pymmcore to device-interface 70 and restructure
 the environment

---
 .python-version |    1 +
 README.md       |   44 +-
 pyproject.toml  |   85 +-
 uv.lock         | 2244 ++++++++++-------------------------------------
 4 files changed, 554 insertions(+), 1820 deletions(-)
 create mode 100644 .python-version

diff --git a/.python-version b/.python-version
new file mode 100644
index 00000000..2c073331
--- /dev/null
+++ b/.python-version
@@ -0,0 +1 @@
+3.11
diff --git a/README.md b/README.md
index 34865ccb..8fdc3efe 100644
--- a/README.md
+++ b/README.md
@@ -87,42 +87,48 @@ dependency management. If you don't have it yet, install it following the
 (e.g. `curl -LsSf https://astral.sh/uv/install.sh | sh` on macOS/Linux).
 
 Gently depends on **`gently-perception`** (the VLM perception harness, repo
-`pskeshu/gently-perception`), which is not published to PyPI. Clone it as a
-**sibling** of `gently` so the path source in `pyproject.toml` can find it:
+`gently-project/gently-perception`), which is not published to PyPI. For development, it is
+installed as an **editable sibling clone**, so clone both repos side by side:
 
 ```bash
-# Clone both repos side by side
-git clone https://github.com/pskeshu/gently.git
-git clone https://github.com/pskeshu/gently-perception.git
+git clone git@github.com:gently-project/gently.git
+git clone git@github.com:gently-project/gently-perception.git
 
 # Layout:
 #   <parent>/
 #     gently/             <- you run commands from here
-#     gently-perception/  <- resolved via [tool.uv.sources]
-```
-
-From the project root run:
+#     gently-perception/  <- editable, resolved via [tool.uv.sources]
 
-```bash
 cd gently
-uv sync
+uv sync                    # base env (add --extra ... for torch etc., see below)
 ```
 
-This creates a `.venv` in the project directory and installs the runtime + dev
-dependencies pinned in `uv.lock` (see `pyproject.toml` for the spec), including
-`gently-perception` as an editable install from the sibling clone. Activate it
-with `source .venv/bin/activate`, or just prefix commands with `uv run` (e.g.
-`uv run python ...`) to use it without activating.
+> The `git@github.com:` URLs use **SSH**, which needs an
+> [SSH key configured with GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh).
+> If you don't use SSH, clone over HTTPS instead
+> (`https://github.com/gently-project/<repo>.git`).
+
+`[tool.uv.sources]` resolves `gently-perception` to the sibling as an editable
+install, so your perception edits are live immediately and survive `uv sync`. If
+the sibling isn't cloned, `uv sync` fails by design — clone it first.
+
+You get a `.venv` in the project directory with the runtime + dev dependencies
+pinned in `uv.lock`. Activate it with `source .venv/bin/activate`, or prefix
+commands with `uv run` (e.g. `uv run python ...`) to use it without activating.
 
 #### Optional extras
 
+PyTorch is **not** in the base install — the CUDA build is machine-specific, so
+it lives in mutually-exclusive extras wired to the right PyTorch index:
+
 ```bash
 # Device-layer accessories (microscope computer): BLE/serial/MQTT transports
 uv sync --extra device
 
-# GPU acceleration for SAM detection — install the CUDA build of PyTorch
-# (skip on CPU-only machines; the default torch from uv sync works there)
-uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
+# PyTorch (needed for SAM detection and the ML pipeline)
+# NOTE: the GPU and CPU builds are mutually exclusive, so they can't be combined.
+uv sync --extra torch-gpu   # CUDA 11.8 build (GPU box, e.g. the microscope PC)
+uv sync --extra torch-cpu   # CPU-only build (dev laptop / CI)
 ```
 
 #### Running tests
diff --git a/pyproject.toml b/pyproject.toml
index cc7e9c34..82f2ac3e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,9 @@ version = "0.22.0.dev0"
 description = "Agentic harnessing for microscopy"
 readme = "docs/README.md"
 license = {text = "GPL-3.0-or-later"}
-requires-python = ">=3.10"
+# Upper bound from numpy<2: numpy 1.26.4 (the last 1.x) ships wheels only for
+# cp310-cp312, so 3.13+ cannot resolve. pymmcore 70 itself goes to cp315.
+requires-python = ">=3.10,<3.13"
 authors = [
     {name = "Kesavan Subburam", email = "pskeshu@gmail.com"},
 ]
@@ -26,7 +28,10 @@ dependencies = [
     "fastapi>=0.104.0",
     "uvicorn[standard]>=0.24.0",
     "aiohttp>=3.9.0",
-    "numpy>=1.24.0",
+    # numpy capped <2: pymmcore 10.1.1.70.6 is a C-extension built against the
+    # numpy 1.x ABI and fails to import under numpy 2.x. The wheel declares no
+    # upper bound, so we enforce it here.
+    "numpy>=1.24.0,<2",
     "pillow>=10.0.0",
     "tifffile>=2023.0.0",
     "scipy>=1.10.0",
@@ -35,25 +40,42 @@ dependencies = [
     "pyyaml>=6.0",
     "matplotlib>=3.7.0",
     "python-dotenv>=1.0.0",
-    # Perception harness — cloned as a sibling repo (see [tool.uv.sources])
+    # Perception harness — installed as an editable sibling clone (see
+    # [tool.uv.sources]); clone gently-project/gently-perception next to this repo.
     "gently-perception",
-    # Device control
-    "pymmcore>=11.1.1",
+    # Device control.
+    # pymmcore pinned exactly: its MMCore must match the device-interface version
+    # (70) of the Micro-Manager device adapters installed on the microscope PC.
+    # Bumping this requires upgrading the MM adapter install in lockstep.
+    "pymmcore==10.1.1.70.6",
     "bluesky>=1.11.0",
     "ophyd>=1.9.0",
-    # ML / SAM
-    "torch>=2.0.0",
-    "torchvision>=0.15.0",
-    "nvidia-ml-py>=12.0.0",
-    # Testing
-    "pytest>=7.0.0",
-    "pytest-asyncio>=0.21.0",
+    # NOTE: torch / torchvision / nvidia-ml-py are NOT base deps — CUDA build is
+    # machine-specific. Install via an extra: `uv sync --extra torch-gpu` (CUDA
+    # 11.8) or `uv sync --extra torch-cpu`. All torch imports are lazy/guarded.
+    # Test/dev tooling lives in [dependency-groups] below, not here.
 ]
 
 [project.optional-dependencies]
 sam = [
     "segment-anything",
 ]
+# PyTorch — CUDA build is per-machine, so it lives in mutually-exclusive extras
+# wired to dedicated indexes below (see [tool.uv.sources] / [[tool.uv.index]]).
+#   uv sync --extra torch-gpu   # CUDA 11.8 build (microscope / GPU box)
+#   uv sync --extra torch-cpu   # CPU-only build (dev laptops, CI)
+# torch-gpu pins the cu118 index: those wheels bundle their own CUDA 11.8 runtime
+# and only need a recent NVIDIA driver, so the same build runs across GPU machines
+# regardless of their system CUDA version.
+torch-gpu = [
+    "torch>=2.0.0",
+    "torchvision>=0.15.0",
+    "nvidia-ml-py>=12.0.0",
+]
+torch-cpu = [
+    "torch>=2.0.0",
+    "torchvision>=0.15.0",
+]
 # Device-layer accessories for the microscope computer. Core hardware-control
 # deps (pymmcore, bluesky, ophyd) are already in [project.dependencies]; these
 # are the extras the device layer needs: BLE (SwitchBot room light), serial and
@@ -64,13 +86,48 @@ device = [
     "paho-mqtt>=1.6.0",
 ]
 
+# Test/dev tooling — installed by `uv sync` (uv enables the `dev` group by
+# default) but excluded from gently's published runtime requirements.
+[dependency-groups]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
 [project.scripts]
 gently = "launch_gently:cli_main"
 
-# gently-perception is not published to PyPI; it lives in a sibling clone of
-# pskeshu/gently-perception and is installed editable from there.
+# torch-gpu and torch-cpu extras are mutually exclusive — they pull torch/
+# torchvision from different indexes, so they can't be installed together.
+[tool.uv]
+conflicts = [
+    [{ extra = "torch-gpu" }, { extra = "torch-cpu" }],
+]
+
+# gently-perception is not published to PyPI; clone gently-project/gently-perception
+# as a sibling of this repo and it is installed editable from there — so your edits
+# are live immediately. A missing sibling makes `uv sync` fail by design; clone it.
+# torch/torchvision are routed to a CUDA or CPU index depending on the extra.
 [tool.uv.sources]
 gently-perception = { path = "../gently-perception", editable = true }
+torch = [
+    { index = "pytorch-cu118", extra = "torch-gpu" },
+    { index = "pytorch-cpu", extra = "torch-cpu" },
+]
+torchvision = [
+    { index = "pytorch-cu118", extra = "torch-gpu" },
+    { index = "pytorch-cpu", extra = "torch-cpu" },
+]
+
+[[tool.uv.index]]
+name = "pytorch-cu118"
+url = "https://download.pytorch.org/whl/cu118"
+explicit = true
+
+[[tool.uv.index]]
+name = "pytorch-cpu"
+url = "https://download.pytorch.org/whl/cpu"
+explicit = true
 
 [tool.setuptools.packages.find]
 include = ["gently*"]
diff --git a/uv.lock b/uv.lock
index 1015cc0c..60a87123 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1,11 +1,21 @@
 version = 1
 revision = 3
-requires-python = ">=3.10"
+requires-python = ">=3.10, <3.13"
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
-    "python_full_version < '3.11'",
-]
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+]
+conflicts = [[
+    { package = "gently", extra = "torch-cpu" },
+    { package = "gently", extra = "torch-gpu" },
+]]
 
 [[package]]
 name = "aiohappyeyeballs"
@@ -23,7 +33,7 @@ source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiohappyeyeballs" },
     { name = "aiosignal" },
-    { name = "async-timeout", marker = "python_full_version < '3.11'" },
+    { name = "async-timeout", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "attrs" },
     { name = "frozenlist" },
     { name = "multidict" },
@@ -83,57 +93,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/84/63/7749337c90f92bc2cb18f9560d67aa6258c7060d1397d21529b8004fcf6f/aiohttp-3.13.5-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:888e78eb5ca55a615d285c3c09a7a91b42e9dd6fc699b166ebd5dee87c9ccf14", size = 1732427, upload-time = "2026-03-31T21:58:06.337Z" },
     { url = "https://files.pythonhosted.org/packages/98/de/cf2f44ff98d307e72fb97d5f5bbae3bfcb442f0ea9790c0bf5c5c2331404/aiohttp-3.13.5-cp312-cp312-win32.whl", hash = "sha256:8bd3ec6376e68a41f9f95f5ed170e2fcf22d4eb27a1f8cb361d0508f6e0557f3", size = 433534, upload-time = "2026-03-31T21:58:08.712Z" },
     { url = "https://files.pythonhosted.org/packages/aa/ca/eadf6f9c8fa5e31d40993e3db153fb5ed0b11008ad5d9de98a95045bed84/aiohttp-3.13.5-cp312-cp312-win_amd64.whl", hash = "sha256:110e448e02c729bcebb18c60b9214a87ba33bac4a9fa5e9a5f139938b56c6cb1", size = 460446, upload-time = "2026-03-31T21:58:10.945Z" },
-    { url = "https://files.pythonhosted.org/packages/78/e9/d76bf503005709e390122d34e15256b88f7008e246c4bdbe915cd4f1adce/aiohttp-3.13.5-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:a5029cc80718bbd545123cd8fe5d15025eccaaaace5d0eeec6bd556ad6163d61", size = 742930, upload-time = "2026-03-31T21:58:13.155Z" },
-    { url = "https://files.pythonhosted.org/packages/57/00/4b7b70223deaebd9bb85984d01a764b0d7bd6526fcdc73cca83bcbe7243e/aiohttp-3.13.5-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4bb6bf5811620003614076bdc807ef3b5e38244f9d25ca5fe888eaccea2a9832", size = 496927, upload-time = "2026-03-31T21:58:15.073Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/f5/0fb20fb49f8efdcdce6cd8127604ad2c503e754a8f139f5e02b01626523f/aiohttp-3.13.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a84792f8631bf5a94e52d9cc881c0b824ab42717165a5579c760b830d9392ac9", size = 497141, upload-time = "2026-03-31T21:58:17.009Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/86/b7c870053e36a94e8951b803cb5b909bfbc9b90ca941527f5fcafbf6b0fa/aiohttp-3.13.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:57653eac22c6a4c13eb22ecf4d673d64a12f266e72785ab1c8b8e5940d0e8090", size = 1732476, upload-time = "2026-03-31T21:58:18.925Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/e5/4e161f84f98d80c03a238671b4136e6530453d65262867d989bbe78244d0/aiohttp-3.13.5-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5e5f7debc7a57af53fdf5c5009f9391d9f4c12867049d509bf7bb164a6e295b", size = 1706507, upload-time = "2026-03-31T21:58:21.094Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/56/ea11a9f01518bd5a2a2fcee869d248c4b8a0cfa0bb13401574fa31adf4d4/aiohttp-3.13.5-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c719f65bebcdf6716f10e9eff80d27567f7892d8988c06de12bbbd39307c6e3a", size = 1773465, upload-time = "2026-03-31T21:58:23.159Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/40/333ca27fb74b0383f17c90570c748f7582501507307350a79d9f9f3c6eb1/aiohttp-3.13.5-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d97f93fdae594d886c5a866636397e2bcab146fd7a132fd6bb9ce182224452f8", size = 1873523, upload-time = "2026-03-31T21:58:25.59Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/d2/e2f77eef1acb7111405433c707dc735e63f67a56e176e72e9e7a2cd3f493/aiohttp-3.13.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3df334e39d4c2f899a914f1dba283c1aadc311790733f705182998c6f7cae665", size = 1754113, upload-time = "2026-03-31T21:58:27.624Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/56/3f653d7f53c89669301ec9e42c95233e2a0c0a6dd051269e6e678db4fdb0/aiohttp-3.13.5-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fe6970addfea9e5e081401bcbadf865d2b6da045472f58af08427e108d618540", size = 1562351, upload-time = "2026-03-31T21:58:29.918Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/a6/9b3e91eb8ae791cce4ee736da02211c85c6f835f1bdfac0594a8a3b7018c/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:7becdf835feff2f4f335d7477f121af787e3504b48b449ff737afb35869ba7bb", size = 1693205, upload-time = "2026-03-31T21:58:32.214Z" },
-    { url = "https://files.pythonhosted.org/packages/98/fc/bfb437a99a2fcebd6b6eaec609571954de2ed424f01c352f4b5504371dd3/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:676e5651705ad5d8a70aeb8eb6936c436d8ebbd56e63436cb7dd9bb36d2a9a46", size = 1730618, upload-time = "2026-03-31T21:58:34.728Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/b6/c8534862126191a034f68153194c389addc285a0f1347d85096d349bbc15/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:9b16c653d38eb1a611cc898c41e76859ca27f119d25b53c12875fd0474ae31a8", size = 1745185, upload-time = "2026-03-31T21:58:36.909Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/93/4ca8ee2ef5236e2707e0fd5fecb10ce214aee1ff4ab307af9c558bda3b37/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:999802d5fa0389f58decd24b537c54aa63c01c3219ce17d1214cbda3c2b22d2d", size = 1557311, upload-time = "2026-03-31T21:58:39.38Z" },
-    { url = "https://files.pythonhosted.org/packages/57/ae/76177b15f18c5f5d094f19901d284025db28eccc5ae374d1d254181d33f4/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:ec707059ee75732b1ba130ed5f9580fe10ff75180c812bc267ded039db5128c6", size = 1773147, upload-time = "2026-03-31T21:58:41.476Z" },
-    { url = "https://files.pythonhosted.org/packages/01/a4/62f05a0a98d88af59d93b7fcac564e5f18f513cb7471696ac286db970d6a/aiohttp-3.13.5-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:2d6d44a5b48132053c2f6cd5c8cb14bc67e99a63594e336b0f2af81e94d5530c", size = 1730356, upload-time = "2026-03-31T21:58:44.049Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/85/fc8601f59dfa8c9523808281f2da571f8b4699685f9809a228adcc90838d/aiohttp-3.13.5-cp313-cp313-win32.whl", hash = "sha256:329f292ed14d38a6c4c435e465f48bebb47479fd676a0411936cc371643225cc", size = 432637, upload-time = "2026-03-31T21:58:46.167Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/1b/ac685a8882896acf0f6b31d689e3792199cfe7aba37969fa91da63a7fa27/aiohttp-3.13.5-cp313-cp313-win_amd64.whl", hash = "sha256:69f571de7500e0557801c0b51f4780482c0ec5fe2ac851af5a92cfce1af1cb83", size = 458896, upload-time = "2026-03-31T21:58:48.119Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/ce/46572759afc859e867a5bc8ec3487315869013f59281ce61764f76d879de/aiohttp-3.13.5-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:eb4639f32fd4a9904ab8fb45bf3383ba71137f3d9d4ba25b3b3f3109977c5b8c", size = 745721, upload-time = "2026-03-31T21:58:50.229Z" },
-    { url = "https://files.pythonhosted.org/packages/13/fe/8a2efd7626dbe6049b2ef8ace18ffda8a4dfcbe1bcff3ac30c0c7575c20b/aiohttp-3.13.5-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:7e5dc4311bd5ac493886c63cbf76ab579dbe4641268e7c74e48e774c74b6f2be", size = 497663, upload-time = "2026-03-31T21:58:52.232Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/91/cc8cc78a111826c54743d88651e1687008133c37e5ee615fee9b57990fac/aiohttp-3.13.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:756c3c304d394977519824449600adaf2be0ccee76d206ee339c5e76b70ded25", size = 499094, upload-time = "2026-03-31T21:58:54.566Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/33/a8362cb15cf16a3af7e86ed11962d5cd7d59b449202dc576cdc731310bde/aiohttp-3.13.5-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ecc26751323224cf8186efcf7fbcbc30f4e1d8c7970659daf25ad995e4032a56", size = 1726701, upload-time = "2026-03-31T21:58:56.864Z" },
-    { url = "https://files.pythonhosted.org/packages/45/0c/c091ac5c3a17114bd76cbf85d674650969ddf93387876cf67f754204bd77/aiohttp-3.13.5-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:10a75acfcf794edf9d8db50e5a7ec5fc818b2a8d3f591ce93bc7b1210df016d2", size = 1683360, upload-time = "2026-03-31T21:58:59.072Z" },
-    { url = "https://files.pythonhosted.org/packages/23/73/bcee1c2b79bc275e964d1446c55c54441a461938e70267c86afaae6fba27/aiohttp-3.13.5-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0f7a18f258d124cd678c5fe072fe4432a4d5232b0657fca7c1847f599233c83a", size = 1773023, upload-time = "2026-03-31T21:59:01.776Z" },
-    { url = "https://files.pythonhosted.org/packages/c7/ef/720e639df03004fee2d869f771799d8c23046dec47d5b81e396c7cda583a/aiohttp-3.13.5-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:df6104c009713d3a89621096f3e3e88cc323fd269dbd7c20afe18535094320be", size = 1853795, upload-time = "2026-03-31T21:59:04.568Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/c9/989f4034fb46841208de7aeeac2c6d8300745ab4f28c42f629ba77c2d916/aiohttp-3.13.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:241a94f7de7c0c3b616627aaad530fe2cb620084a8b144d3be7b6ecfe95bae3b", size = 1730405, upload-time = "2026-03-31T21:59:07.221Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/75/ee1fd286ca7dc599d824b5651dad7b3be7ff8d9a7e7b3fe9820d9180f7db/aiohttp-3.13.5-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c974fb66180e58709b6fc402846f13791240d180b74de81d23913abe48e96d94", size = 1558082, upload-time = "2026-03-31T21:59:09.484Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/20/1e9e6650dfc436340116b7aa89ff8cb2bbdf0abc11dfaceaad8f74273a10/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:6e27ea05d184afac78aabbac667450c75e54e35f62238d44463131bd3f96753d", size = 1692346, upload-time = "2026-03-31T21:59:12.068Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/40/8ebc6658d48ea630ac7903912fe0dd4e262f0e16825aa4c833c56c9f1f56/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:a79a6d399cef33a11b6f004c67bb07741d91f2be01b8d712d52c75711b1e07c7", size = 1698891, upload-time = "2026-03-31T21:59:14.552Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/78/ea0ae5ec8ba7a5c10bdd6e318f1ba5e76fcde17db8275188772afc7917a4/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:c632ce9c0b534fbe25b52c974515ed674937c5b99f549a92127c85f771a78772", size = 1742113, upload-time = "2026-03-31T21:59:17.068Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/66/9d308ed71e3f2491be1acb8769d96c6f0c47d92099f3bc9119cada27b357/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:fceedde51fbd67ee2bcc8c0b33d0126cc8b51ef3bbde2f86662bd6d5a6f10ec5", size = 1553088, upload-time = "2026-03-31T21:59:19.541Z" },
-    { url = "https://files.pythonhosted.org/packages/da/a6/6cc25ed8dfc6e00c90f5c6d126a98e2cf28957ad06fa1036bd34b6f24a2c/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:f92995dfec9420bb69ae629abf422e516923ba79ba4403bc750d94fb4a6c68c1", size = 1757976, upload-time = "2026-03-31T21:59:22.311Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/2b/cce5b0ffe0de99c83e5e36d8f828e4161e415660a9f3e58339d07cce3006/aiohttp-3.13.5-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:20ae0ff08b1f2c8788d6fb85afcb798654ae6ba0b747575f8562de738078457b", size = 1712444, upload-time = "2026-03-31T21:59:24.635Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/cf/9e1795b4160c58d29421eafd1a69c6ce351e2f7c8d3c6b7e4ca44aea1a5b/aiohttp-3.13.5-cp314-cp314-win32.whl", hash = "sha256:b20df693de16f42b2472a9c485e1c948ee55524786a0a34345511afdd22246f3", size = 438128, upload-time = "2026-03-31T21:59:27.291Z" },
-    { url = "https://files.pythonhosted.org/packages/22/4d/eaedff67fc805aeba4ba746aec891b4b24cebb1a7d078084b6300f79d063/aiohttp-3.13.5-cp314-cp314-win_amd64.whl", hash = "sha256:f85c6f327bf0b8c29da7d93b1cabb6363fb5e4e160a32fa241ed2dce21b73162", size = 464029, upload-time = "2026-03-31T21:59:29.429Z" },
-    { url = "https://files.pythonhosted.org/packages/79/11/c27d9332ee20d68dd164dc12a6ecdef2e2e35ecc97ed6cf0d2442844624b/aiohttp-3.13.5-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:1efb06900858bb618ff5cee184ae2de5828896c448403d51fb633f09e109be0a", size = 778758, upload-time = "2026-03-31T21:59:31.547Z" },
-    { url = "https://files.pythonhosted.org/packages/04/fb/377aead2e0a3ba5f09b7624f702a964bdf4f08b5b6728a9799830c80041e/aiohttp-3.13.5-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:fee86b7c4bd29bdaf0d53d14739b08a106fdda809ca5fe032a15f52fae5fe254", size = 512883, upload-time = "2026-03-31T21:59:34.098Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/a6/aa109a33671f7a5d3bd78b46da9d852797c5e665bfda7d6b373f56bff2ec/aiohttp-3.13.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:20058e23909b9e65f9da62b396b77dfa95965cbe840f8def6e572538b1d32e36", size = 516668, upload-time = "2026-03-31T21:59:36.497Z" },
-    { url = "https://files.pythonhosted.org/packages/79/b3/ca078f9f2fa9563c36fb8ef89053ea2bb146d6f792c5104574d49d8acb63/aiohttp-3.13.5-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8cf20a8d6868cb15a73cab329ffc07291ba8c22b1b88176026106ae39aa6df0f", size = 1883461, upload-time = "2026-03-31T21:59:38.723Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/e3/a7ad633ca1ca497b852233a3cce6906a56c3225fb6d9217b5e5e60b7419d/aiohttp-3.13.5-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:330f5da04c987f1d5bdb8ae189137c77139f36bd1cb23779ca1a354a4b027800", size = 1747661, upload-time = "2026-03-31T21:59:41.187Z" },
-    { url = "https://files.pythonhosted.org/packages/33/b9/cd6fe579bed34a906d3d783fe60f2fa297ef55b27bb4538438ee49d4dc41/aiohttp-3.13.5-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6f1cbf0c7926d315c3c26c2da41fd2b5d2fe01ac0e157b78caefc51a782196cf", size = 1863800, upload-time = "2026-03-31T21:59:43.84Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/3f/2c1e2f5144cefa889c8afd5cf431994c32f3b29da9961698ff4e3811b79a/aiohttp-3.13.5-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:53fc049ed6390d05423ba33103ded7281fe897cf97878f369a527070bd95795b", size = 1958382, upload-time = "2026-03-31T21:59:46.187Z" },
-    { url = "https://files.pythonhosted.org/packages/66/1d/f31ec3f1013723b3babe3609e7f119c2c2fb6ef33da90061a705ef3e1bc8/aiohttp-3.13.5-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:898703aa2667e3c5ca4c54ca36cd73f58b7a38ef87a5606414799ebce4d3fd3a", size = 1803724, upload-time = "2026-03-31T21:59:48.656Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/b4/57712dfc6f1542f067daa81eb61da282fab3e6f1966fca25db06c4fc62d5/aiohttp-3.13.5-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0494a01ca9584eea1e5fbd6d748e61ecff218c51b576ee1999c23db7066417d8", size = 1640027, upload-time = "2026-03-31T21:59:51.284Z" },
-    { url = "https://files.pythonhosted.org/packages/25/3c/734c878fb43ec083d8e31bf029daae1beafeae582d1b35da234739e82ee7/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:6cf81fe010b8c17b09495cbd15c1d35afbc8fb405c0c9cf4738e5ae3af1d65be", size = 1806644, upload-time = "2026-03-31T21:59:53.753Z" },
-    { url = "https://files.pythonhosted.org/packages/20/a5/f671e5cbec1c21d044ff3078223f949748f3a7f86b14e34a365d74a5d21f/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:c564dd5f09ddc9d8f2c2d0a301cd30a79a2cc1b46dd1a73bef8f0038863d016b", size = 1791630, upload-time = "2026-03-31T21:59:56.239Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/63/fb8d0ad63a0b8a99be97deac8c04dacf0785721c158bdf23d679a87aa99e/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:2994be9f6e51046c4f864598fd9abeb4fba6e88f0b2152422c9666dcd4aea9c6", size = 1809403, upload-time = "2026-03-31T21:59:59.103Z" },
-    { url = "https://files.pythonhosted.org/packages/59/0c/bfed7f30662fcf12206481c2aac57dedee43fe1c49275e85b3a1e1742294/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:157826e2fa245d2ef46c83ea8a5faf77ca19355d278d425c29fda0beb3318037", size = 1634924, upload-time = "2026-03-31T22:00:02.116Z" },
-    { url = "https://files.pythonhosted.org/packages/17/d6/fd518d668a09fd5a3319ae5e984d4d80b9a4b3df4e21c52f02251ef5a32e/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:a8aca50daa9493e9e13c0f566201a9006f080e7c50e5e90d0b06f53146a54500", size = 1836119, upload-time = "2026-03-31T22:00:04.756Z" },
-    { url = "https://files.pythonhosted.org/packages/78/b7/15fb7a9d52e112a25b621c67b69c167805cb1f2ab8f1708a5c490d1b52fe/aiohttp-3.13.5-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:3b13560160d07e047a93f23aaa30718606493036253d5430887514715b67c9d9", size = 1772072, upload-time = "2026-03-31T22:00:07.494Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/df/57ba7f0c4a553fc2bd8b6321df236870ec6fd64a2a473a8a13d4f733214e/aiohttp-3.13.5-cp314-cp314t-win32.whl", hash = "sha256:9a0f4474b6ea6818b41f82172d799e4b3d29e22c2c520ce4357856fced9af2f8", size = 471819, upload-time = "2026-03-31T22:00:10.277Z" },
-    { url = "https://files.pythonhosted.org/packages/62/29/2f8418269e46454a26171bfdd6a055d74febf32234e474930f2f60a17145/aiohttp-3.13.5-cp314-cp314t-win_amd64.whl", hash = "sha256:18a2f6c1182c51baa1d28d68fea51513cb2a76612f038853c0ad3c145423d3d9", size = 505441, upload-time = "2026-03-31T22:00:12.791Z" },
 ]
 
 [[package]]
@@ -142,7 +101,7 @@ version = "1.4.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "frozenlist" },
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/61/62/06741b579156360248d1ec624842ad0edf697050bbaf7c3e46394e106ad1/aiosignal-1.4.0.tar.gz", hash = "sha256:f47eecd9468083c2029cc99945502cb7708b082c232f9aca65da147157b251c7", size = 25007, upload-time = "2025-07-03T22:54:43.528Z" }
 wheels = [
@@ -191,9 +150,9 @@ name = "anyio"
 version = "4.13.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "idna" },
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
 wheels = [
@@ -232,21 +191,21 @@ name = "bleak"
 version = "3.0.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "async-timeout", marker = "python_full_version < '3.11'" },
-    { name = "dbus-fast", marker = "sys_platform == 'linux'" },
-    { name = "pyobjc-core", marker = "sys_platform == 'darwin'" },
-    { name = "pyobjc-framework-corebluetooth", marker = "sys_platform == 'darwin'" },
-    { name = "pyobjc-framework-libdispatch", marker = "sys_platform == 'darwin'" },
-    { name = "typing-extensions", marker = "python_full_version < '3.12'" },
-    { name = "winrt-runtime", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-devices-bluetooth", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-devices-bluetooth-advertisement", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-devices-bluetooth-genericattributeprofile", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-devices-enumeration", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-devices-radios", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-foundation", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-foundation-collections", marker = "sys_platform == 'win32'" },
-    { name = "winrt-windows-storage-streams", marker = "sys_platform == 'win32'" },
+    { name = "async-timeout", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "dbus-fast", marker = "sys_platform == 'linux' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-framework-corebluetooth", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-framework-libdispatch", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "typing-extensions", marker = "python_full_version < '3.12' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-runtime", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-devices-bluetooth", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-devices-bluetooth-advertisement", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-devices-bluetooth-genericattributeprofile", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-devices-enumeration", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-devices-radios", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-foundation", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-foundation-collections", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "winrt-windows-storage-streams", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/16/df/05a3f80ca8e3f7f5b0dba68a9e618147c909ccdba1468f07487dc8d72a9d/bleak-3.0.2.tar.gz", hash = "sha256:c2229cb8238d5876b4bd05c74bf7a1aea1f88da39d2e51ac9dfd5cc319d5265f", size = 125293, upload-time = "2026-05-02T23:01:04.066Z" }
 wheels = [
@@ -263,8 +222,7 @@ dependencies = [
     { name = "historydict" },
     { name = "msgpack" },
     { name = "msgpack-numpy" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
     { name = "opentelemetry-api" },
     { name = "toolz" },
     { name = "tqdm" },
@@ -289,7 +247,7 @@ name = "click"
 version = "8.4.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "colorama", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/9b/98/518d8e5081007684232226f475082b30087d0f585e8457db087298259f49/click-8.4.1.tar.gz", hash = "sha256:918b5633eddf6b41c32d4f454bf0de810065c74e3f7dbf8ee5452f8be88d3e96", size = 353007, upload-time = "2026-05-22T04:08:37.769Z" }
 wheels = [
@@ -310,10 +268,13 @@ name = "contourpy"
 version = "1.3.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/66/54/eb9bfc647b19f2009dd5c7f5ec51c4e6ca831725f1aea7a993034f483147/contourpy-1.3.2.tar.gz", hash = "sha256:b6945942715a034c671b7fc54f9588126b0b8bf23db2696e3ca8328f3ff0ab54", size = 13466130, upload-time = "2025-04-15T17:47:53.79Z" }
 wheels = [
@@ -347,26 +308,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/8a/bebe5a3f68b484d3a2b8ffaf84704b3e343ef1addea528132ef148e22b3b/contourpy-1.3.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:3d80b2c0300583228ac98d0a927a1ba6a2ba6b8a742463c564f1d419ee5b211e", size = 1380480, upload-time = "2025-04-15T17:38:06.7Z" },
     { url = "https://files.pythonhosted.org/packages/34/db/fcd325f19b5978fb509a7d55e06d99f5f856294c1991097534360b307cf1/contourpy-1.3.2-cp312-cp312-win32.whl", hash = "sha256:90df94c89a91b7362e1142cbee7568f86514412ab8a2c0d0fca72d7e91b62912", size = 178489, upload-time = "2025-04-15T17:38:10.338Z" },
     { url = "https://files.pythonhosted.org/packages/01/c8/fadd0b92ffa7b5eb5949bf340a63a4a496a6930a6c37a7ba0f12acb076d6/contourpy-1.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:8c942a01d9163e2e5cfb05cb66110121b8d07ad438a17f9e766317bcb62abf73", size = 223042, upload-time = "2025-04-15T17:38:14.239Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/61/5673f7e364b31e4e7ef6f61a4b5121c5f170f941895912f773d95270f3a2/contourpy-1.3.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:de39db2604ae755316cb5967728f4bea92685884b1e767b7c24e983ef5f771cb", size = 271630, upload-time = "2025-04-15T17:38:19.142Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/66/a40badddd1223822c95798c55292844b7e871e50f6bfd9f158cb25e0bd39/contourpy-1.3.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:3f9e896f447c5c8618f1edb2bafa9a4030f22a575ec418ad70611450720b5b08", size = 255670, upload-time = "2025-04-15T17:38:23.688Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/c7/cf9fdee8200805c9bc3b148f49cb9482a4e3ea2719e772602a425c9b09f8/contourpy-1.3.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:71e2bd4a1c4188f5c2b8d274da78faab884b59df20df63c34f74aa1813c4427c", size = 306694, upload-time = "2025-04-15T17:38:28.238Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/e7/ccb9bec80e1ba121efbffad7f38021021cda5be87532ec16fd96533bb2e0/contourpy-1.3.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:de425af81b6cea33101ae95ece1f696af39446db9682a0b56daaa48cfc29f38f", size = 345986, upload-time = "2025-04-15T17:38:33.502Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/49/ca13bb2da90391fa4219fdb23b078d6065ada886658ac7818e5441448b78/contourpy-1.3.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:977e98a0e0480d3fe292246417239d2d45435904afd6d7332d8455981c408b85", size = 318060, upload-time = "2025-04-15T17:38:38.672Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/65/5245ce8c548a8422236c13ffcdcdada6a2a812c361e9e0c70548bb40b661/contourpy-1.3.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:434f0adf84911c924519d2b08fc10491dd282b20bdd3fa8f60fd816ea0b48841", size = 322747, upload-time = "2025-04-15T17:38:43.712Z" },
-    { url = "https://files.pythonhosted.org/packages/72/30/669b8eb48e0a01c660ead3752a25b44fdb2e5ebc13a55782f639170772f9/contourpy-1.3.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:c66c4906cdbc50e9cba65978823e6e00b45682eb09adbb78c9775b74eb222422", size = 1308895, upload-time = "2025-04-15T17:39:00.224Z" },
-    { url = "https://files.pythonhosted.org/packages/05/5a/b569f4250decee6e8d54498be7bdf29021a4c256e77fe8138c8319ef8eb3/contourpy-1.3.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8b7fc0cd78ba2f4695fd0a6ad81a19e7e3ab825c31b577f384aa9d7817dc3bef", size = 1379098, upload-time = "2025-04-15T17:43:29.649Z" },
-    { url = "https://files.pythonhosted.org/packages/19/ba/b227c3886d120e60e41b28740ac3617b2f2b971b9f601c835661194579f1/contourpy-1.3.2-cp313-cp313-win32.whl", hash = "sha256:15ce6ab60957ca74cff444fe66d9045c1fd3e92c8936894ebd1f3eef2fff075f", size = 178535, upload-time = "2025-04-15T17:44:44.532Z" },
-    { url = "https://files.pythonhosted.org/packages/12/6e/2fed56cd47ca739b43e892707ae9a13790a486a3173be063681ca67d2262/contourpy-1.3.2-cp313-cp313-win_amd64.whl", hash = "sha256:e1578f7eafce927b168752ed7e22646dad6cd9bca673c60bff55889fa236ebf9", size = 223096, upload-time = "2025-04-15T17:44:48.194Z" },
-    { url = "https://files.pythonhosted.org/packages/54/4c/e76fe2a03014a7c767d79ea35c86a747e9325537a8b7627e0e5b3ba266b4/contourpy-1.3.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0475b1f6604896bc7c53bb070e355e9321e1bc0d381735421a2d2068ec56531f", size = 285090, upload-time = "2025-04-15T17:43:34.084Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/e2/5aba47debd55d668e00baf9651b721e7733975dc9fc27264a62b0dd26eb8/contourpy-1.3.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:c85bb486e9be652314bb5b9e2e3b0d1b2e643d5eec4992c0fbe8ac71775da739", size = 268643, upload-time = "2025-04-15T17:43:38.626Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/37/cd45f1f051fe6230f751cc5cdd2728bb3a203f5619510ef11e732109593c/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:745b57db7758f3ffc05a10254edd3182a2a83402a89c00957a8e8a22f5582823", size = 310443, upload-time = "2025-04-15T17:43:44.522Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/a2/36ea6140c306c9ff6dd38e3bcec80b3b018474ef4d17eb68ceecd26675f4/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:970e9173dbd7eba9b4e01aab19215a48ee5dd3f43cef736eebde064a171f89a5", size = 349865, upload-time = "2025-04-15T17:43:49.545Z" },
-    { url = "https://files.pythonhosted.org/packages/95/b7/2fc76bc539693180488f7b6cc518da7acbbb9e3b931fd9280504128bf956/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c6c4639a9c22230276b7bffb6a850dfc8258a2521305e1faefe804d006b2e532", size = 321162, upload-time = "2025-04-15T17:43:54.203Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/10/76d4f778458b0aa83f96e59d65ece72a060bacb20cfbee46cf6cd5ceba41/contourpy-1.3.2-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc829960f34ba36aad4302e78eabf3ef16a3a100863f0d4eeddf30e8a485a03b", size = 327355, upload-time = "2025-04-15T17:44:01.025Z" },
-    { url = "https://files.pythonhosted.org/packages/43/a3/10cf483ea683f9f8ab096c24bad3cce20e0d1dd9a4baa0e2093c1c962d9d/contourpy-1.3.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:d32530b534e986374fc19eaa77fcb87e8a99e5431499949b828312bdcd20ac52", size = 1307935, upload-time = "2025-04-15T17:44:17.322Z" },
-    { url = "https://files.pythonhosted.org/packages/78/73/69dd9a024444489e22d86108e7b913f3528f56cfc312b5c5727a44188471/contourpy-1.3.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:e298e7e70cf4eb179cc1077be1c725b5fd131ebc81181bf0c03525c8abc297fd", size = 1372168, upload-time = "2025-04-15T17:44:33.43Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/1b/96d586ccf1b1a9d2004dd519b25fbf104a11589abfd05484ff12199cca21/contourpy-1.3.2-cp313-cp313t-win32.whl", hash = "sha256:d0e589ae0d55204991450bb5c23f571c64fe43adaa53f93fc902a84c96f52fe1", size = 189550, upload-time = "2025-04-15T17:44:37.092Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/e6/6000d0094e8a5e32ad62591c8609e269febb6e4db83a1c75ff8868b42731/contourpy-1.3.2-cp313-cp313t-win_amd64.whl", hash = "sha256:78e9253c3de756b3f6a5174d024c4835acd59eb3f8e2ca13e775dbffe1558f69", size = 238214, upload-time = "2025-04-15T17:44:40.827Z" },
     { url = "https://files.pythonhosted.org/packages/33/05/b26e3c6ecc05f349ee0013f0bb850a761016d89cec528a98193a48c34033/contourpy-1.3.2-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:fd93cc7f3139b6dd7aab2f26a90dde0aa9fc264dbf70f6740d498a70b860b82c", size = 265681, upload-time = "2025-04-15T17:44:59.314Z" },
     { url = "https://files.pythonhosted.org/packages/2b/25/ac07d6ad12affa7d1ffed11b77417d0a6308170f44ff20fa1d5aa6333f03/contourpy-1.3.2-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:107ba8a6a7eec58bb475329e6d3b95deba9440667c4d62b9b6063942b61d7f16", size = 315101, upload-time = "2025-04-15T17:45:04.165Z" },
     { url = "https://files.pythonhosted.org/packages/8f/4d/5bb3192bbe9d3f27e3061a6a8e7733c9120e203cb8515767d30973f71030/contourpy-1.3.2-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:ded1706ed0c1049224531b81128efbd5084598f18d8a2d9efae833edbd2b40ad", size = 220599, upload-time = "2025-04-15T17:45:08.456Z" },
@@ -380,11 +321,14 @@ name = "contourpy"
 version = "1.3.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/58/01/1253e6698a07380cd31a736d248a3f2a50a7c88779a1813da27503cadc2a/contourpy-1.3.3.tar.gz", hash = "sha256:083e12155b210502d0bca491432bb04d56dc3432f95a979b429f2848c3dbe880", size = 13466174, upload-time = "2025-07-26T12:03:12.549Z" }
 wheels = [
@@ -410,50 +354,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/cf/8f/5847f44a7fddf859704217a99a23a4f6417b10e5ab1256a179264561540e/contourpy-1.3.3-cp312-cp312-win32.whl", hash = "sha256:023b44101dfe49d7d53932be418477dba359649246075c996866106da069af69", size = 185018, upload-time = "2025-07-26T12:01:35.64Z" },
     { url = "https://files.pythonhosted.org/packages/19/e8/6026ed58a64563186a9ee3f29f41261fd1828f527dd93d33b60feca63352/contourpy-1.3.3-cp312-cp312-win_amd64.whl", hash = "sha256:8153b8bfc11e1e4d75bcb0bff1db232f9e10b274e0929de9d608027e0d34ff8b", size = 226567, upload-time = "2025-07-26T12:01:36.804Z" },
     { url = "https://files.pythonhosted.org/packages/d1/e2/f05240d2c39a1ed228d8328a78b6f44cd695f7ef47beb3e684cf93604f86/contourpy-1.3.3-cp312-cp312-win_arm64.whl", hash = "sha256:07ce5ed73ecdc4a03ffe3e1b3e3c1166db35ae7584be76f65dbbe28a7791b0cc", size = 193655, upload-time = "2025-07-26T12:01:37.999Z" },
-    { url = "https://files.pythonhosted.org/packages/68/35/0167aad910bbdb9599272bd96d01a9ec6852f36b9455cf2ca67bd4cc2d23/contourpy-1.3.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:177fb367556747a686509d6fef71d221a4b198a3905fe824430e5ea0fda54eb5", size = 293257, upload-time = "2025-07-26T12:01:39.367Z" },
-    { url = "https://files.pythonhosted.org/packages/96/e4/7adcd9c8362745b2210728f209bfbcf7d91ba868a2c5f40d8b58f54c509b/contourpy-1.3.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:d002b6f00d73d69333dac9d0b8d5e84d9724ff9ef044fd63c5986e62b7c9e1b1", size = 274034, upload-time = "2025-07-26T12:01:40.645Z" },
-    { url = "https://files.pythonhosted.org/packages/73/23/90e31ceeed1de63058a02cb04b12f2de4b40e3bef5e082a7c18d9c8ae281/contourpy-1.3.3-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:348ac1f5d4f1d66d3322420f01d42e43122f43616e0f194fc1c9f5d830c5b286", size = 334672, upload-time = "2025-07-26T12:01:41.942Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/93/b43d8acbe67392e659e1d984700e79eb67e2acb2bd7f62012b583a7f1b55/contourpy-1.3.3-cp313-cp313-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:655456777ff65c2c548b7c454af9c6f33f16c8884f11083244b5819cc214f1b5", size = 381234, upload-time = "2025-07-26T12:01:43.499Z" },
-    { url = "https://files.pythonhosted.org/packages/46/3b/bec82a3ea06f66711520f75a40c8fc0b113b2a75edb36aa633eb11c4f50f/contourpy-1.3.3-cp313-cp313-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:644a6853d15b2512d67881586bd03f462c7ab755db95f16f14d7e238f2852c67", size = 385169, upload-time = "2025-07-26T12:01:45.219Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/32/e0f13a1c5b0f8572d0ec6ae2f6c677b7991fafd95da523159c19eff0696a/contourpy-1.3.3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4debd64f124ca62069f313a9cb86656ff087786016d76927ae2cf37846b006c9", size = 362859, upload-time = "2025-07-26T12:01:46.519Z" },
-    { url = "https://files.pythonhosted.org/packages/33/71/e2a7945b7de4e58af42d708a219f3b2f4cff7386e6b6ab0a0fa0033c49a9/contourpy-1.3.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a15459b0f4615b00bbd1e91f1b9e19b7e63aea7483d03d804186f278c0af2659", size = 1332062, upload-time = "2025-07-26T12:01:48.964Z" },
-    { url = "https://files.pythonhosted.org/packages/12/fc/4e87ac754220ccc0e807284f88e943d6d43b43843614f0a8afa469801db0/contourpy-1.3.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ca0fdcd73925568ca027e0b17ab07aad764be4706d0a925b89227e447d9737b7", size = 1403932, upload-time = "2025-07-26T12:01:51.979Z" },
-    { url = "https://files.pythonhosted.org/packages/a6/2e/adc197a37443f934594112222ac1aa7dc9a98faf9c3842884df9a9d8751d/contourpy-1.3.3-cp313-cp313-win32.whl", hash = "sha256:b20c7c9a3bf701366556e1b1984ed2d0cedf999903c51311417cf5f591d8c78d", size = 185024, upload-time = "2025-07-26T12:01:53.245Z" },
-    { url = "https://files.pythonhosted.org/packages/18/0b/0098c214843213759692cc638fce7de5c289200a830e5035d1791d7a2338/contourpy-1.3.3-cp313-cp313-win_amd64.whl", hash = "sha256:1cadd8b8969f060ba45ed7c1b714fe69185812ab43bd6b86a9123fe8f99c3263", size = 226578, upload-time = "2025-07-26T12:01:54.422Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/9a/2f6024a0c5995243cd63afdeb3651c984f0d2bc727fd98066d40e141ad73/contourpy-1.3.3-cp313-cp313-win_arm64.whl", hash = "sha256:fd914713266421b7536de2bfa8181aa8c699432b6763a0ea64195ebe28bff6a9", size = 193524, upload-time = "2025-07-26T12:01:55.73Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/b3/f8a1a86bd3298513f500e5b1f5fd92b69896449f6cab6a146a5d52715479/contourpy-1.3.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:88df9880d507169449d434c293467418b9f6cbe82edd19284aa0409e7fdb933d", size = 306730, upload-time = "2025-07-26T12:01:57.051Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/11/4780db94ae62fc0c2053909b65dc3246bd7cecfc4f8a20d957ad43aa4ad8/contourpy-1.3.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:d06bb1f751ba5d417047db62bca3c8fde202b8c11fb50742ab3ab962c81e8216", size = 287897, upload-time = "2025-07-26T12:01:58.663Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/15/e59f5f3ffdd6f3d4daa3e47114c53daabcb18574a26c21f03dc9e4e42ff0/contourpy-1.3.3-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e4e6b05a45525357e382909a4c1600444e2a45b4795163d3b22669285591c1ae", size = 326751, upload-time = "2025-07-26T12:02:00.343Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/81/03b45cfad088e4770b1dcf72ea78d3802d04200009fb364d18a493857210/contourpy-1.3.3-cp313-cp313t-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:ab3074b48c4e2cf1a960e6bbeb7f04566bf36b1861d5c9d4d8ac04b82e38ba20", size = 375486, upload-time = "2025-07-26T12:02:02.128Z" },
-    { url = "https://files.pythonhosted.org/packages/0c/ba/49923366492ffbdd4486e970d421b289a670ae8cf539c1ea9a09822b371a/contourpy-1.3.3-cp313-cp313t-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6c3d53c796f8647d6deb1abe867daeb66dcc8a97e8455efa729516b997b8ed99", size = 388106, upload-time = "2025-07-26T12:02:03.615Z" },
-    { url = "https://files.pythonhosted.org/packages/9f/52/5b00ea89525f8f143651f9f03a0df371d3cbd2fccd21ca9b768c7a6500c2/contourpy-1.3.3-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:50ed930df7289ff2a8d7afeb9603f8289e5704755c7e5c3bbd929c90c817164b", size = 352548, upload-time = "2025-07-26T12:02:05.165Z" },
-    { url = "https://files.pythonhosted.org/packages/32/1d/a209ec1a3a3452d490f6b14dd92e72280c99ae3d1e73da74f8277d4ee08f/contourpy-1.3.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:4feffb6537d64b84877da813a5c30f1422ea5739566abf0bd18065ac040e120a", size = 1322297, upload-time = "2025-07-26T12:02:07.379Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/9e/46f0e8ebdd884ca0e8877e46a3f4e633f6c9c8c4f3f6e72be3fe075994aa/contourpy-1.3.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:2b7e9480ffe2b0cd2e787e4df64270e3a0440d9db8dc823312e2c940c167df7e", size = 1391023, upload-time = "2025-07-26T12:02:10.171Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/70/f308384a3ae9cd2209e0849f33c913f658d3326900d0ff5d378d6a1422d2/contourpy-1.3.3-cp313-cp313t-win32.whl", hash = "sha256:283edd842a01e3dcd435b1c5116798d661378d83d36d337b8dde1d16a5fc9ba3", size = 196157, upload-time = "2025-07-26T12:02:11.488Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/dd/880f890a6663b84d9e34a6f88cded89d78f0091e0045a284427cb6b18521/contourpy-1.3.3-cp313-cp313t-win_amd64.whl", hash = "sha256:87acf5963fc2b34825e5b6b048f40e3635dd547f590b04d2ab317c2619ef7ae8", size = 240570, upload-time = "2025-07-26T12:02:12.754Z" },
-    { url = "https://files.pythonhosted.org/packages/80/99/2adc7d8ffead633234817ef8e9a87115c8a11927a94478f6bb3d3f4d4f7d/contourpy-1.3.3-cp313-cp313t-win_arm64.whl", hash = "sha256:3c30273eb2a55024ff31ba7d052dde990d7d8e5450f4bbb6e913558b3d6c2301", size = 199713, upload-time = "2025-07-26T12:02:14.4Z" },
-    { url = "https://files.pythonhosted.org/packages/72/8b/4546f3ab60f78c514ffb7d01a0bd743f90de36f0019d1be84d0a708a580a/contourpy-1.3.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fde6c716d51c04b1c25d0b90364d0be954624a0ee9d60e23e850e8d48353d07a", size = 292189, upload-time = "2025-07-26T12:02:16.095Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/e1/3542a9cb596cadd76fcef413f19c79216e002623158befe6daa03dbfa88c/contourpy-1.3.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:cbedb772ed74ff5be440fa8eee9bd49f64f6e3fc09436d9c7d8f1c287b121d77", size = 273251, upload-time = "2025-07-26T12:02:17.524Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/71/f93e1e9471d189f79d0ce2497007731c1e6bf9ef6d1d61b911430c3db4e5/contourpy-1.3.3-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:22e9b1bd7a9b1d652cd77388465dc358dafcd2e217d35552424aa4f996f524f5", size = 335810, upload-time = "2025-07-26T12:02:18.9Z" },
-    { url = "https://files.pythonhosted.org/packages/91/f9/e35f4c1c93f9275d4e38681a80506b5510e9327350c51f8d4a5a724d178c/contourpy-1.3.3-cp314-cp314-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a22738912262aa3e254e4f3cb079a95a67132fc5a063890e224393596902f5a4", size = 382871, upload-time = "2025-07-26T12:02:20.418Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/71/47b512f936f66a0a900d81c396a7e60d73419868fba959c61efed7a8ab46/contourpy-1.3.3-cp314-cp314-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:afe5a512f31ee6bd7d0dda52ec9864c984ca3d66664444f2d72e0dc4eb832e36", size = 386264, upload-time = "2025-07-26T12:02:21.916Z" },
-    { url = "https://files.pythonhosted.org/packages/04/5f/9ff93450ba96b09c7c2b3f81c94de31c89f92292f1380261bd7195bea4ea/contourpy-1.3.3-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f64836de09927cba6f79dcd00fdd7d5329f3fccc633468507079c829ca4db4e3", size = 363819, upload-time = "2025-07-26T12:02:23.759Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/a6/0b185d4cc480ee494945cde102cb0149ae830b5fa17bf855b95f2e70ad13/contourpy-1.3.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:1fd43c3be4c8e5fd6e4f2baeae35ae18176cf2e5cced681cca908addf1cdd53b", size = 1333650, upload-time = "2025-07-26T12:02:26.181Z" },
-    { url = "https://files.pythonhosted.org/packages/43/d7/afdc95580ca56f30fbcd3060250f66cedbde69b4547028863abd8aa3b47e/contourpy-1.3.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:6afc576f7b33cf00996e5c1102dc2a8f7cc89e39c0b55df93a0b78c1bd992b36", size = 1404833, upload-time = "2025-07-26T12:02:28.782Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/e2/366af18a6d386f41132a48f033cbd2102e9b0cf6345d35ff0826cd984566/contourpy-1.3.3-cp314-cp314-win32.whl", hash = "sha256:66c8a43a4f7b8df8b71ee1840e4211a3c8d93b214b213f590e18a1beca458f7d", size = 189692, upload-time = "2025-07-26T12:02:30.128Z" },
-    { url = "https://files.pythonhosted.org/packages/7d/c2/57f54b03d0f22d4044b8afb9ca0e184f8b1afd57b4f735c2fa70883dc601/contourpy-1.3.3-cp314-cp314-win_amd64.whl", hash = "sha256:cf9022ef053f2694e31d630feaacb21ea24224be1c3ad0520b13d844274614fd", size = 232424, upload-time = "2025-07-26T12:02:31.395Z" },
-    { url = "https://files.pythonhosted.org/packages/18/79/a9416650df9b525737ab521aa181ccc42d56016d2123ddcb7b58e926a42c/contourpy-1.3.3-cp314-cp314-win_arm64.whl", hash = "sha256:95b181891b4c71de4bb404c6621e7e2390745f887f2a026b2d99e92c17892339", size = 198300, upload-time = "2025-07-26T12:02:32.956Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/42/38c159a7d0f2b7b9c04c64ab317042bb6952b713ba875c1681529a2932fe/contourpy-1.3.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:33c82d0138c0a062380332c861387650c82e4cf1747aaa6938b9b6516762e772", size = 306769, upload-time = "2025-07-26T12:02:34.2Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/6c/26a8205f24bca10974e77460de68d3d7c63e282e23782f1239f226fcae6f/contourpy-1.3.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ea37e7b45949df430fe649e5de8351c423430046a2af20b1c1961cae3afcda77", size = 287892, upload-time = "2025-07-26T12:02:35.807Z" },
-    { url = "https://files.pythonhosted.org/packages/66/06/8a475c8ab718ebfd7925661747dbb3c3ee9c82ac834ccb3570be49d129f4/contourpy-1.3.3-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d304906ecc71672e9c89e87c4675dc5c2645e1f4269a5063b99b0bb29f232d13", size = 326748, upload-time = "2025-07-26T12:02:37.193Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/a3/c5ca9f010a44c223f098fccd8b158bb1cb287378a31ac141f04730dc49be/contourpy-1.3.3-cp314-cp314t-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:ca658cd1a680a5c9ea96dc61cdbae1e85c8f25849843aa799dfd3cb370ad4fbe", size = 375554, upload-time = "2025-07-26T12:02:38.894Z" },
-    { url = "https://files.pythonhosted.org/packages/80/5b/68bd33ae63fac658a4145088c1e894405e07584a316738710b636c6d0333/contourpy-1.3.3-cp314-cp314t-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ab2fd90904c503739a75b7c8c5c01160130ba67944a7b77bbf36ef8054576e7f", size = 388118, upload-time = "2025-07-26T12:02:40.642Z" },
-    { url = "https://files.pythonhosted.org/packages/40/52/4c285a6435940ae25d7410a6c36bda5145839bc3f0beb20c707cda18b9d2/contourpy-1.3.3-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b7301b89040075c30e5768810bc96a8e8d78085b47d8be6e4c3f5a0b4ed478a0", size = 352555, upload-time = "2025-07-26T12:02:42.25Z" },
-    { url = "https://files.pythonhosted.org/packages/24/ee/3e81e1dd174f5c7fefe50e85d0892de05ca4e26ef1c9a59c2a57e43b865a/contourpy-1.3.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:2a2a8b627d5cc6b7c41a4beff6c5ad5eb848c88255fda4a8745f7e901b32d8e4", size = 1322295, upload-time = "2025-07-26T12:02:44.668Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/b2/6d913d4d04e14379de429057cd169e5e00f6c2af3bb13e1710bcbdb5da12/contourpy-1.3.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:fd6ec6be509c787f1caf6b247f0b1ca598bef13f4ddeaa126b7658215529ba0f", size = 1391027, upload-time = "2025-07-26T12:02:47.09Z" },
-    { url = "https://files.pythonhosted.org/packages/93/8a/68a4ec5c55a2971213d29a9374913f7e9f18581945a7a31d1a39b5d2dfe5/contourpy-1.3.3-cp314-cp314t-win32.whl", hash = "sha256:e74a9a0f5e3fff48fb5a7f2fd2b9b70a3fe014a67522f79b7cca4c0c7e43c9ae", size = 202428, upload-time = "2025-07-26T12:02:48.691Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/96/fd9f641ffedc4fa3ace923af73b9d07e869496c9cc7a459103e6e978992f/contourpy-1.3.3-cp314-cp314t-win_amd64.whl", hash = "sha256:13b68d6a62db8eafaebb8039218921399baf6e47bf85006fd8529f2a08ef33fc", size = 250331, upload-time = "2025-07-26T12:02:50.137Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/8c/469afb6465b853afff216f9528ffda78a915ff880ed58813ba4faf4ba0b6/contourpy-1.3.3-cp314-cp314t-win_arm64.whl", hash = "sha256:b7448cb5a725bb1e35ce88771b86fba35ef418952474492cf7c764059933ff8b", size = 203831, upload-time = "2025-07-26T12:02:51.449Z" },
     { url = "https://files.pythonhosted.org/packages/a5/29/8dcfe16f0107943fa92388c23f6e05cff0ba58058c4c95b00280d4c75a14/contourpy-1.3.3-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:cd5dfcaeb10f7b7f9dc8941717c6c2ade08f587be2226222c12b25f0483ed497", size = 278809, upload-time = "2025-07-26T12:02:52.74Z" },
     { url = "https://files.pythonhosted.org/packages/85/a9/8b37ef4f7dafeb335daee3c8254645ef5725be4d9c6aa70b50ec46ef2f7e/contourpy-1.3.3-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:0c1fc238306b35f246d61a1d416a627348b5cf0648648a031e14bb8705fcdfe8", size = 261593, upload-time = "2025-07-26T12:02:54.037Z" },
     { url = "https://files.pythonhosted.org/packages/0a/59/ebfb8c677c75605cc27f7122c90313fd2f375ff3c8d19a1694bda74aaa63/contourpy-1.3.3-pp311-pypy311_pp73-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:70f9aad7de812d6541d29d2bbf8feb22ff7e1c299523db288004e3157ff4674e", size = 302202, upload-time = "2025-07-26T12:02:55.947Z" },
@@ -461,76 +361,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0c/58/bd257695f39d05594ca4ad60df5bcb7e32247f9951fd09a9b8edb82d1daa/contourpy-1.3.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:3d1a3799d62d45c18bafd41c5fa05120b96a28079f2393af559b843d1a966a77", size = 225315, upload-time = "2025-07-26T12:02:58.801Z" },
 ]
 
-[[package]]
-name = "cuda-bindings"
-version = "13.3.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "cuda-pathfinder" },
-]
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/a9/21/8464d133752951c154feafb3b65c297e7d80f301183d220bec4c830f1441/cuda_bindings-13.3.1-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:120fcc53d57903df529c3486962c56528cba5b7d6c57c99537320ed9922c8b86", size = 6073403, upload-time = "2026-05-29T23:11:36.22Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/1f/5ef51f5fbaa5d4d3201bb3d7555af028ec1aa4416275ccbf73c9e34e3d2d/cuda_bindings-13.3.1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9851b0caa8bfd3bc6fa054eaf57bea7c8e9c3a62db2d2621224677f49f3c53d0", size = 6675244, upload-time = "2026-05-29T23:11:38.664Z" },
-    { url = "https://files.pythonhosted.org/packages/51/6b/457ca12dad3ee9bfcc9a545cfd6b64b359ba49de40f776f6e028e678f262/cuda_bindings-13.3.1-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c5879712accf6e14bb01aa5e67440eb84998b8d104b509cc7a6dc0b8f656a474", size = 6053539, upload-time = "2026-05-29T23:11:43.19Z" },
-    { url = "https://files.pythonhosted.org/packages/95/7a/c5e3c34a409b148f5c0f5a4ea374158f95d488862c1dffedf9aa5c639df9/cuda_bindings-13.3.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:04436a9364059c84b8f9636f359eccda1cf814341f5b670c71d80d2f79dbc708", size = 6674166, upload-time = "2026-05-29T23:11:45.478Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/67/5e7dba1ba576dd73da5dee894ca076ca5e959450dfff66d6d510a255d1f7/cuda_bindings-13.3.1-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7855c4868aabc0cfae28abbe83d56734bdfbd08f08fc234ac1912a12858bf49", size = 6025351, upload-time = "2026-05-29T23:11:49.685Z" },
-    { url = "https://files.pythonhosted.org/packages/39/2a/6d2e9047d1fb243dbaa364b01e0297534b9ed7fd27dba1c9f361519cf69b/cuda_bindings-13.3.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e32d08f71ebcdf00f0f41eab2eb37e8da94c8ed411cc9f7f7a019ce6b34abe3a", size = 6657965, upload-time = "2026-05-29T23:11:52.227Z" },
-    { url = "https://files.pythonhosted.org/packages/cc/6e/2394f8163360f8391f8f1b7e72d300a82724edb81a7b7084c799fbd4c91f/cuda_bindings-13.3.1-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9efb21c1ee64981e184b9e0ba5eb3179e5ba3d4b51665a6cb52b8ef3d01a7cbf", size = 5920504, upload-time = "2026-05-29T23:11:56.883Z" },
-    { url = "https://files.pythonhosted.org/packages/34/c2/ef9b6a63f7dc432712a462c816662e662e00d38caa9b861c8c2588195d03/cuda_bindings-13.3.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2732904099e0a4d4db774a5fc6d91ee95fae065b4d2ecabb4968c5fe2406c9d7", size = 6476660, upload-time = "2026-05-29T23:11:59.188Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/81/bff68ce829999c1e4209c761bbf903b1c06ec570416ddb25020864ad5907/cuda_bindings-13.3.1-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ab2f74ed65bfef4163ba07a8db16f1085e0729291db12a2423aff84ee8278b8", size = 6013639, upload-time = "2026-05-29T23:12:03.509Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/e0/c8a1f0c8f9ffdea4f5fe6dbab89b326cef4d85caf489dad39e209da89416/cuda_bindings-13.3.1-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:efd4c814d311ec08c981f6dded1dbe7d4b371067ee4f6c14cccec4bde9590f80", size = 6534419, upload-time = "2026-05-29T23:12:05.633Z" },
-    { url = "https://files.pythonhosted.org/packages/52/b8/83b1f563925b290f2d11a01a77a84013ba56052fe3653a5bef3ccfbb43d6/cuda_bindings-13.3.1-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c3c772dfff49681541d59630c90f858e173ac926b9c593a2b7123f2a1043cc76", size = 5809771, upload-time = "2026-05-29T23:12:10.422Z" },
-    { url = "https://files.pythonhosted.org/packages/12/20/e79b4bfe98f075195afb6343d41c498f9dbd2d161d7021d4d28bceb83581/cuda_bindings-13.3.1-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:36febb7c1079d68a981dbbd8d5a67235b399802b82075c9388624719607e52b9", size = 6358584, upload-time = "2026-05-29T23:12:12.767Z" },
-]
-
-[[package]]
-name = "cuda-pathfinder"
-version = "1.5.5"
-source = { registry = "https://pypi.org/simple" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/11/c8/26f2e4aae92f11522a96043892ba39a90eac610d5242523aa863212bc1c7/cuda_pathfinder-1.5.5-py3-none-any.whl", hash = "sha256:0228c023f95d1480f143ef5c8922d27a2ab052087a942e81dc289c9eb8f91689", size = 51671, upload-time = "2026-05-27T01:21:25.413Z" },
-]
-
-[[package]]
-name = "cuda-toolkit"
-version = "13.0.2"
-source = { registry = "https://pypi.org/simple" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/57/b2/453099f5f3b698d7d0eab38916aac44c7f76229f451709e2eb9db6615dcd/cuda_toolkit-13.0.2-py2.py3-none-any.whl", hash = "sha256:b198824cf2f54003f50d64ada3a0f184b42ca0846c1c94192fa269ecd97a66eb", size = 2364, upload-time = "2025-12-19T23:24:07.328Z" },
-]
-
-[package.optional-dependencies]
-cudart = [
-    { name = "nvidia-cuda-runtime", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-cufft = [
-    { name = "nvidia-cufft", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-cufile = [
-    { name = "nvidia-cufile", marker = "sys_platform == 'linux'" },
-]
-cupti = [
-    { name = "nvidia-cuda-cupti", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-curand = [
-    { name = "nvidia-curand", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-cusolver = [
-    { name = "nvidia-cusolver", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-cusparse = [
-    { name = "nvidia-cusparse", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-nvjitlink = [
-    { name = "nvidia-nvjitlink", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-nvrtc = [
-    { name = "nvidia-cuda-nvrtc", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-nvtx = [
-    { name = "nvidia-nvtx", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
-]
-
 [[package]]
 name = "cycler"
 version = "0.12.1"
@@ -546,43 +376,27 @@ version = "5.0.16"
 source = { registry = "https://pypi.org/simple" }
 sdist = { url = "https://files.pythonhosted.org/packages/c2/26/a75b4f79c56bd1f24e4cf85399b28a1a607d1052b9e66aceb961d79a6d3f/dbus_fast-5.0.16.tar.gz", hash = "sha256:24d0a86f32acb209a41806d20cf8a9207e4d46760e23c32479d1951d43739080", size = 82570, upload-time = "2026-05-27T19:19:33.316Z" }
 wheels = [
+    { url = "https://files.pythonhosted.org/packages/65/a3/be8cf9f2094ae2e672f4e3505387dc18da9fd88822df2e726055406121b2/dbus_fast-5.0.16-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:872bed67d7c0e58663d4e0ed5be44e7e56800222dd2ef20796be6ba40aaf8443", size = 694596, upload-time = "2026-05-27T19:27:22.621Z" },
     { url = "https://files.pythonhosted.org/packages/2f/9f/e876913135540b426f4b7e2b5b8b718a42da51f115e2a70323f13e2d6db9/dbus_fast-5.0.16-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dc1b3de7c70cb25cb4799fd098aae23caca89e957f199a02997c2c280f20a1a8", size = 839874, upload-time = "2026-05-27T19:27:25.396Z" },
     { url = "https://files.pythonhosted.org/packages/ac/ee/e1c8e106d1e83d7db653d360d58527c567c58dd7faac43ac255915293522/dbus_fast-5.0.16-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d0601912b5f7015870f3987216c7d0cec49278adb8a282fc879e171a73b7f8f4", size = 884279, upload-time = "2026-05-27T19:27:26.673Z" },
     { url = "https://files.pythonhosted.org/packages/59/26/b699fccea33ae56abb087795127e65b846feab093abd1e673f6233945b03/dbus_fast-5.0.16-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d57b49994666998dfdacaac726f6c788855ebd1942e3d40b91bf72b9bd64c079", size = 885549, upload-time = "2026-05-27T19:27:28.285Z" },
     { url = "https://files.pythonhosted.org/packages/2b/89/8203aa0666327b01855cadd17da0d5f8f41b8fa28ca658f868d807404c5a/dbus_fast-5.0.16-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:b92b773075adc85f24a628875e8b57f4d1f1fbe63ec18db1bb9f136f26a6f621", size = 846911, upload-time = "2026-05-27T19:27:29.478Z" },
     { url = "https://files.pythonhosted.org/packages/4b/ba/b3f02870dab313b423442ac8859de138386b12539de30583758b1787b81f/dbus_fast-5.0.16-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:7fb55b9658f9a285bd52b6209e54a89613da7f1134d505aa089299ed99268c1a", size = 883229, upload-time = "2026-05-27T19:27:31.104Z" },
     { url = "https://files.pythonhosted.org/packages/f6/54/fab358e1bee38621cf2289eb59d001c7f2d2aeff61319852346518fa9304/dbus_fast-5.0.16-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:c775272eccf2aa3948c72509c590f84a9a9bebb3bc7ee68452ad029209670c63", size = 891357, upload-time = "2026-05-27T19:27:32.736Z" },
+    { url = "https://files.pythonhosted.org/packages/77/a8/d83ca112995ceecc8de75d921a56cc9bd066bb3661228497de28f6fe8b0c/dbus_fast-5.0.16-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:0a846c0103073f78cecd70b7cd229d4f37b739164797de4d7943d0591dac4393", size = 692827, upload-time = "2026-05-27T19:27:34.397Z" },
     { url = "https://files.pythonhosted.org/packages/e6/a6/3903f047ee563a793a9adf9c6bb46a00164fcdd83224fce221cb4a69b90f/dbus_fast-5.0.16-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ddac5066da9e1e38d434e41372392ac62ab8ce80e4e9616a0504999749b9ec46", size = 838181, upload-time = "2026-05-27T19:27:35.791Z" },
     { url = "https://files.pythonhosted.org/packages/00/42/e5c277b88eb0102c71f2387eb3feb7413f2f5f8ed3ef2b7c16e54bfe618a/dbus_fast-5.0.16-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6d41f51d2a420f7274d4f48b7a4f3e56b70ee8ca87ad666854007de102025ee3", size = 883024, upload-time = "2026-05-27T19:27:37.237Z" },
     { url = "https://files.pythonhosted.org/packages/b4/6a/73ee89383f66be965fa20c1b4e6d558a9f6059ff4c0809455b8fca8a2d47/dbus_fast-5.0.16-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:651347df9079744395c6404e0ed03a3704485d21833765db7ad71390c7c807a6", size = 885925, upload-time = "2026-05-27T19:27:38.77Z" },
     { url = "https://files.pythonhosted.org/packages/6e/69/9c7d4231dab8d1b40a7bd59226d0ae57cd7e07a4b9869a76ddc3ba6b54e0/dbus_fast-5.0.16-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1f5017cb3c32b07622f9c01a1285526183988ae1dd4e5fedc7390650a3cfbca2", size = 845630, upload-time = "2026-05-27T19:27:40.71Z" },
     { url = "https://files.pythonhosted.org/packages/0c/ea/d3945d8fa00fe5bf96aa4bff6b93b91afa4493ccb377ee5d9f9bb7adfa29/dbus_fast-5.0.16-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:bff101277226e71aa744d72b968efcdde4e185dc0d3571b8168edb99a2f72d3a", size = 881730, upload-time = "2026-05-27T19:27:42.357Z" },
     { url = "https://files.pythonhosted.org/packages/6c/d6/864c0fec52f3de381371f342966070252a8323ccf6b829f3c58e6d0b65e4/dbus_fast-5.0.16-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3367dfeba013db0f97004b4c93f4a21c39728f2bbe0fbef74dbbeb6e078e47fa", size = 890381, upload-time = "2026-05-27T19:27:44.089Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/52/c7cc66d4c8e6b155c165f6dc28dad5fecee1c614441f5b89a4c6a7e0e5bf/dbus_fast-5.0.16-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f35c2ce7ab95ecc8a378119a024691b33693f07068bfaa3642d32d2f1a0e28a8", size = 690053, upload-time = "2026-05-27T19:27:46.17Z" },
     { url = "https://files.pythonhosted.org/packages/25/49/9c6013b1f19ff0f2c1ba4e8996f81bf225d85ffea541200a89de4a0c44bc/dbus_fast-5.0.16-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:85a7771883fd5beaa5e92b27772722db5e3d4dc2f7e04a1812d3bf01b7de440d", size = 799934, upload-time = "2026-05-27T19:27:47.528Z" },
     { url = "https://files.pythonhosted.org/packages/02/c2/4c6e23a17b14461b6d0d24dff7d6d9f6c1b7c01ddd1ea80757f69f9541ff/dbus_fast-5.0.16-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c42dc349ea1e52e4bd17462d5029c7650d76e8ccd2fbd136b6a0384abae61004", size = 852402, upload-time = "2026-05-27T19:27:49.058Z" },
     { url = "https://files.pythonhosted.org/packages/b8/62/597c9742618b7f5273d1bd0e330f9e2fa13d9c59d4e3a591f4cf3e1c985f/dbus_fast-5.0.16-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:941b926581ef458dfde70711badbb5ab1bfba523b527f1b73004c21cdf9976ec", size = 833815, upload-time = "2026-05-27T19:27:50.767Z" },
     { url = "https://files.pythonhosted.org/packages/3b/a2/5c2d7953906eae84dad02ea920dae9c4fe0339e84870b6e6ad9b9a6070cf/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:42a7901d5f053490d3d59c5a9b9a13b1d8322836458efcb93040ea360aced572", size = 807750, upload-time = "2026-05-27T19:27:52.236Z" },
     { url = "https://files.pythonhosted.org/packages/fb/2f/7aec4afdfeae504a9381d0fcc8105e1b440f81d25480ac5f6704c124d561/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:8deec1d4dd41336672b30b596d60ed78898e923f3b06f9ef60affc1a5dec656c", size = 830883, upload-time = "2026-05-27T19:27:53.604Z" },
     { url = "https://files.pythonhosted.org/packages/c5/f8/1070ab5973dda406f735f6f73a4bc50debf7c43301f5e113fd3657bfca58/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a8b2c92f82af04d59c50cbccf65f995fa2e321ce7850e3c1b613e94680a8044e", size = 860033, upload-time = "2026-05-27T19:27:55.167Z" },
-    { url = "https://files.pythonhosted.org/packages/36/65/1cadc9c53e779a224ae13210b222bf41bc8c4d0843cf529fd927e308334d/dbus_fast-5.0.16-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:831a6f6a865260395fa59f80d36c73b1e270b268603f53422552a813bf61c529", size = 798537, upload-time = "2026-05-27T19:27:58.33Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/ff/8a9c99ba28ab266038a3ea3cf2989623deb5cbd8e8aceb69a4385b7fccd5/dbus_fast-5.0.16-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4eee863c411c0c1c783518f30c3de50339316fc745ac2abcc0778046e4adac40", size = 850377, upload-time = "2026-05-27T19:28:00.007Z" },
-    { url = "https://files.pythonhosted.org/packages/77/9a/b79c59d12199f7aebbf71d9ce8d2e087f623d66c9981c0836b52ce31c69b/dbus_fast-5.0.16-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:790c1310d38369e659b45ae5b95b6bce24ae51e011634142324cb6ebc8e11398", size = 828635, upload-time = "2026-05-27T19:28:01.675Z" },
-    { url = "https://files.pythonhosted.org/packages/94/b0/8492fbb855defeff0229e88cc601f256ea0dfffaa2169e361d2064686e47/dbus_fast-5.0.16-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f0707f8473cd8e5be0ac1aceed7532e2fcb4b5b97584f2878f98cbe61049a184", size = 806411, upload-time = "2026-05-27T19:28:03.227Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/e8/b6ef9463e41e745b785856e7537503aefaab2a06b18545c407ed11a2974b/dbus_fast-5.0.16-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:df3f3ee7cf61be297be9d3ce2074f74da44b13cdb413cc821e398902d2f38036", size = 828424, upload-time = "2026-05-27T19:28:04.683Z" },
-    { url = "https://files.pythonhosted.org/packages/44/fa/e7d5e24b42d9193acf6219ee04e818b8495a0b4a0f122a58f536b2460708/dbus_fast-5.0.16-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0b800db6ffaec39554f1489b54482e33a8b6247325974cf82659504a3816b956", size = 858114, upload-time = "2026-05-27T19:28:06.021Z" },
-    { url = "https://files.pythonhosted.org/packages/88/6e/827fe09289b73f03fbaaa07493e7944dd16266429bf081ba1c62094af03e/dbus_fast-5.0.16-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:874bbd1fff34054c10b1062676334fcf170f32a0f0f9f21d2a9d1bf22ef70b35", size = 810903, upload-time = "2026-05-27T19:28:09.025Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/1d/8a9caaf953c2212538b9f210edd2507ecd2dc90414ac688b030917f6d1ec/dbus_fast-5.0.16-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:07554554373441f562d1469bd73d024dd3144c9725375bbffbe8b3375bf464fe", size = 855741, upload-time = "2026-05-27T19:28:10.49Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/3d/509e45e1739e96b08461c281eb257f564fd7533f9cabd067f0c4694b725d/dbus_fast-5.0.16-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e6fc1831c702725eb4875d69c877700d95e7c3fa8542f4edaad318c6ba3e66f2", size = 833659, upload-time = "2026-05-27T19:28:12.062Z" },
-    { url = "https://files.pythonhosted.org/packages/30/8d/3237d8a6826a302095b258f183ddf236d345b4070af6e6bb65da3f5dfe25/dbus_fast-5.0.16-cp314-cp314-manylinux_2_41_x86_64.whl", hash = "sha256:8447d1ab3cd7dc9976805dda5903453d0fdb8aaab870536f3bcaf6b1f58800a3", size = 853989, upload-time = "2026-05-27T19:19:30.644Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/2b/f9cc24ebb6f4175bc5760b46d13ad108cd634dfb41c474245bd1fd846091/dbus_fast-5.0.16-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d36ff2f0f6a5fd6dae96a09f48783ee7de51bf12d0da18a13edf19766bd0b99a", size = 818691, upload-time = "2026-05-27T19:28:14.271Z" },
-    { url = "https://files.pythonhosted.org/packages/95/58/a20c6e76b6bc037d5b565531f501d427dcd70fe5a903dcc7984dfe3ef287/dbus_fast-5.0.16-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:fc43f5a7e7db86728e9925757a53a717eb3fec27de54e7bbc688cd65b8e9028c", size = 833842, upload-time = "2026-05-27T19:28:15.719Z" },
-    { url = "https://files.pythonhosted.org/packages/30/0c/2cb74502755be1957b81faf1cf2e57b9b12764afaf7ac30b99c5ebe6e615/dbus_fast-5.0.16-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:56e64ff9d1a1f503e07a940f861bf6dc80f24602425cb6f384d69bdc7fe7071f", size = 862625, upload-time = "2026-05-27T19:28:17.309Z" },
-    { url = "https://files.pythonhosted.org/packages/71/53/d0a0df847025e57a5aa58b0d711d74859a778ca3c28454d10f3b1a554bc3/dbus_fast-5.0.16-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2d8943d0b92ec9f49e37aed6224515ce161eb2b5df5e9fd3e1d692f35efbe48b", size = 1534575, upload-time = "2026-05-27T19:28:20.471Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/82/1423c68091804af7711e940128cacd5494d8d3be645609ae0b23d9104562/dbus_fast-5.0.16-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e2f96e7da851b0dc9e0bc1e00d8b9cd6f227469b6e48e1b2ad474e44ff91841b", size = 1613383, upload-time = "2026-05-27T19:28:22.106Z" },
-    { url = "https://files.pythonhosted.org/packages/20/88/465a6e79cd77e8dc1451fdcfd8080ff72f6693f0a8b25b127df81283f241/dbus_fast-5.0.16-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:2832c5eefcc5b4e0623a27e20751ca34006d7fe73b21d58ef859aa2cef0a8ec8", size = 821797, upload-time = "2026-05-27T19:28:23.698Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/1f/11d8d709736644685dbaa191d65dd313869fec688ff75eaed542f0625895/dbus_fast-5.0.16-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:d2c9ae45a01d5f2e27a9508159d6e3c34e6714b485884000839daf5320d76da9", size = 1549870, upload-time = "2026-05-27T19:28:25.438Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/db/1b01c80c81202ff81e96d1ce92a45296a818bd81c705ea5f032536d591b1/dbus_fast-5.0.16-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:e46276642f787a345f127389ff36a90ba9e4df6537b852d8afdc12e2b2f9bb91", size = 822814, upload-time = "2026-05-27T19:28:27.484Z" },
-    { url = "https://files.pythonhosted.org/packages/88/7c/25ce2a94711a7479d2786de321c7c5fbbf99ab8c67eba1bf5dd5bd80c830/dbus_fast-5.0.16-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f41ca52046e41775c0784148c7b6b636539722bcc1412bae3139ac7295883265", size = 1629346, upload-time = "2026-05-27T19:28:29.121Z" },
 ]
 
 [[package]]
@@ -610,8 +424,7 @@ source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "importlib-resources" },
     { name = "jsonschema" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
     { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/f9/5a/de03f05fdbc4377db89fa6daf243e89370f9bcf2d21ad96b54d4549a74ed/event_model-1.23.1.tar.gz", hash = "sha256:5bb70fd8c7f345aa32afe561aff5a306b2c8a19cbdc3066b736643c8092ddaab", size = 185271, upload-time = "2025-08-28T13:26:38.647Z" }
@@ -624,7 +437,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -710,30 +523,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f2/00/3bbab338c07c71fa56269953845e92c951a61457bbbb0f1022551ea266d9/fonttools-4.63.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:27fdc65af8da6f88b9c6121c47a464cbe359fcfff7ff6fc2d37a1f395d755b78", size = 5133598, upload-time = "2026-05-14T12:03:25.168Z" },
     { url = "https://files.pythonhosted.org/packages/62/f2/aa27c7f98db5b064883dadcc5283947e81e034de42e22a33675878d98b54/fonttools-4.63.0-cp312-cp312-win32.whl", hash = "sha256:af2fd1664d00a397d75f806985ddb36282091c2131a73a6485c23b4a34722263", size = 2292575, upload-time = "2026-05-14T12:03:27.496Z" },
     { url = "https://files.pythonhosted.org/packages/87/36/cccb9bc2a6ab63d1b2980374f0dca72ce95ae267c9b4cfe77455bb70d0d4/fonttools-4.63.0-cp312-cp312-win_amd64.whl", hash = "sha256:59ac449f8cca9b4ffa08d2e7bbadad87ce710d69d1eda5c3c1ce579baa987272", size = 2343211, upload-time = "2026-05-14T12:03:30.057Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/8d/d8fec3dcde2963f8c908fb315e5ff2cd0ac34f82394bbbf73a2aa5145ce3/fonttools-4.63.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:cd7e9857e5e63738b9d9fd707bc1f59c8b09e5177726d23664db393c59bb08bd", size = 2876062, upload-time = "2026-05-14T12:03:32.554Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/71/d935dc54e4ff121bfdd11e08702db63a7e6f25af21d8a3d7b7212df53641/fonttools-4.63.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c2a2a42198b696a6f48fad91709afb55176e66a5e566131219dba372fb7f8c59", size = 2424594, upload-time = "2026-05-14T12:03:34.86Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/40/e76320afa1df918e146155ef239b1719ee266092e96f5423bfd075affba1/fonttools-4.63.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1e874792a8212b44583ea02189d9e693906b2f78b261f372f95d6c563210ac1d", size = 5024840, upload-time = "2026-05-14T12:03:36.745Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/36/0b805d8c485f872f65a509cbe3b58a5d0d17bee855333b54a150c79d3061/fonttools-4.63.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:22135da48a348785c5e2d5d2d9d6bec5ed44adacbaeb9db12d9493bf6c6bfa68", size = 4975801, upload-time = "2026-05-14T12:03:38.833Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/26/2cee03d0aa083ab022da5c07aff9ed3f689da1defb81ad6917c9627896da/fonttools-4.63.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ccf41f2efdf56994d22d73bef4ced1052161958169428d06ba9724ea9e9a64be", size = 4965009, upload-time = "2026-05-14T12:03:41.494Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/48/cc4b66d9058c0d0982c833fad10127c4b0e9324606aafa41382295ca4102/fonttools-4.63.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9ced0bd02ac751dd6319b0da88aaef24414e3b0dbc32bb4f24944821a3741a27", size = 5105892, upload-time = "2026-05-14T12:03:43.525Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/1f/a98a30a814b9ddef3a2e706025f90b9e0bc94890e6cb15254bc86547d11a/fonttools-4.63.0-cp313-cp313-win32.whl", hash = "sha256:85be818f5506e8a7753153def2c9550178f0ecae6a47b5e0e8dbb23f7cc90380", size = 2291313, upload-time = "2026-05-14T12:03:45.594Z" },
-    { url = "https://files.pythonhosted.org/packages/92/46/5177b01f3b4abfdd4409f31cca4ab279c9343a26efbe9ec78c97fc612e02/fonttools-4.63.0-cp313-cp313-win_amd64.whl", hash = "sha256:ba04cb5891d4c0c21b6da95eda8d7b090021508a294fff33464fc7d241e0856b", size = 2342299, upload-time = "2026-05-14T12:03:47.414Z" },
-    { url = "https://files.pythonhosted.org/packages/27/d2/23d25e3f247b328be58d04a4c9f894178a0d1eda7d42867cfb388adaf416/fonttools-4.63.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fd1e3094f42d806d3d7c79162fc59e5910fcbe3a7360c385b8da969bc4493745", size = 2875338, upload-time = "2026-05-14T12:03:50.052Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/58/7dfa0c761cb3b2964e2a84c4dc986c926a87de0cb9fb60d5b28ded3f2914/fonttools-4.63.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:6e528da43bc3791085f8cb6141b1d13e459226790240340fcbb4625649238b03", size = 2422661, upload-time = "2026-05-14T12:03:52.154Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/87/64cfa18a7a1621d17b7f4502b2b0ed8a135a90c3db51ea590ee99043e76b/fonttools-4.63.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b2248c5decb223562f7902ff6325077a073f608ee8e33e88ad88db734eb9f49", size = 5010526, upload-time = "2026-05-14T12:03:54.647Z" },
-    { url = "https://files.pythonhosted.org/packages/36/e1/a8933a72c45a87177fbde2696e0d0755c8c9062f8c077a961c6215fa27b1/fonttools-4.63.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:308f957cdeaf8abe4e5f2f124902ef405448af92c90f80e302a3b771c2e6116b", size = 4923946, upload-time = "2026-05-14T12:03:56.984Z" },
-    { url = "https://files.pythonhosted.org/packages/27/60/872e6e233b8c5e8b41413796ff18b7fe479661bd40147e071b450dfad7a1/fonttools-4.63.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:bf00f21eb5fb721dbaf73d1e9da6d02a1af7768f2ebcf9798be98beab8ba90f6", size = 4962489, upload-time = "2026-05-14T12:03:59.443Z" },
-    { url = "https://files.pythonhosted.org/packages/30/c4/83c24f2ec38b90cfda84bf4b1a1f49df80e84a1db4e7ac6e0d41bf23bc39/fonttools-4.63.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c1aaa4b9c75798400ac043ce04d74e7830376c85095a5a6ed7cba2f17a266bf4", size = 5071870, upload-time = "2026-05-14T12:04:02.122Z" },
-    { url = "https://files.pythonhosted.org/packages/de/40/3ae22b60ff1d41ce0bd044b31238cdc72cef99f28b976f1e128ebd618c9b/fonttools-4.63.0-cp314-cp314-win32.whl", hash = "sha256:22693918177bd9ceabec4736d338045f357769416fc6b0b2508eefef75b08616", size = 2295026, upload-time = "2026-05-14T12:04:04.47Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/d4/98078064ccc76b45cb0f6c002452011e93c4bd26f6850344f0951cc1fe89/fonttools-4.63.0-cp314-cp314-win_amd64.whl", hash = "sha256:7d782fac32985914c351556f68ac0855391572bcd87de50e05970d3cd4c96fc5", size = 2347454, upload-time = "2026-05-14T12:04:06.752Z" },
-    { url = "https://files.pythonhosted.org/packages/49/4e/652d1580c5f4e39f7d103b0c793e4773129ad633dce4addd0cf4dfebde02/fonttools-4.63.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:6db5140a60a5d731d21ec076745b40a310607731b0a565b50776393188649001", size = 2958152, upload-time = "2026-05-14T12:04:08.706Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/55/ad864c9a9b219f552eb46b32cd7906c466e5a578ba0c3abfcc0fe7413eb6/fonttools-4.63.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:7d76edbff9014094dbf03bd2d074709dfa6ec7aba13d838c937a2b33d2d6a86e", size = 2460809, upload-time = "2026-05-14T12:04:10.783Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/2b/0aa8db70f18cf52e49b4ed5ecec68547f981160bf5ded3b5aed6faa0a6f9/fonttools-4.63.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0eac00b9118c3c2f87d272e45341871c5b3066baa3c86897fa634a7c3fb59096", size = 5148649, upload-time = "2026-05-14T12:04:12.747Z" },
-    { url = "https://files.pythonhosted.org/packages/7f/63/18e4369c25043096f1048e0c9915951adc4f842bd81c6b18155824d6fa99/fonttools-4.63.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:51394295f1a51de8b5f30bdb1e1b9a4231536c7064ef5c6e211eec19fa36036f", size = 4932147, upload-time = "2026-05-14T12:04:14.806Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/3f/67f3eac2ffd8a98446c5022f8ed3864eac878a5ff7af8df4c8286dba16cc/fonttools-4.63.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9e12f105d2b6342c559c298afb674006bb2893afc7102dcf8a1b55b0486b4e40", size = 5027237, upload-time = "2026-05-14T12:04:17.675Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/ba/4e6214cb38a7b04779e97bb7636de9a5c7f20af7018d03dee0b64c08510a/fonttools-4.63.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:796f27556dbe094c4824f75ca85267e4df776c79036c8441469a4df37038c196", size = 5053933, upload-time = "2026-05-14T12:04:20.818Z" },
-    { url = "https://files.pythonhosted.org/packages/34/3b/214dcc19ee31d3d38fb5ad2755c11ef0514e5dc300bbaf41c0b69f393799/fonttools-4.63.0-cp314-cp314t-win32.whl", hash = "sha256:948428a275741f0b64b113c955425a953314f4b9ab9997f73a72c83e68e569c8", size = 2359326, upload-time = "2026-05-14T12:04:24.22Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/1e/3ff1a9b523058c2eeb6a9d50f5574e2a738200d0d94107d5bc4105e8da3f/fonttools-4.63.0-cp314-cp314t-win_amd64.whl", hash = "sha256:6d4741eb179121cab9eea4cb2393d24492373a260d7945006358c08cfbf45419", size = 2425829, upload-time = "2026-05-14T12:04:26.829Z" },
     { url = "https://files.pythonhosted.org/packages/2c/47/c99d5268f354002ce80f8d029cd9d7d872969da1de8b93d32de4dc56d6f4/fonttools-4.63.0-py3-none-any.whl", hash = "sha256:445af2eab030a16b9171ea8bdda7ebf7d96bda2df88ee182a464252f6e05e20d", size = 1164562, upload-time = "2026-05-14T12:04:29.092Z" },
 ]
 
@@ -791,70 +580,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/66/bb/852b9d6db2fa40be96f29c0d1205c306288f0684df8fd26ca1951d461a56/frozenlist-1.8.0-cp312-cp312-win32.whl", hash = "sha256:433403ae80709741ce34038da08511d4a77062aa924baf411ef73d1146e74faf", size = 39985, upload-time = "2025-10-06T05:36:23.661Z" },
     { url = "https://files.pythonhosted.org/packages/b8/af/38e51a553dd66eb064cdf193841f16f077585d4d28394c2fa6235cb41765/frozenlist-1.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:34187385b08f866104f0c0617404c8eb08165ab1272e884abc89c112e9c00746", size = 44591, upload-time = "2025-10-06T05:36:24.958Z" },
     { url = "https://files.pythonhosted.org/packages/a7/06/1dc65480ab147339fecc70797e9c2f69d9cea9cf38934ce08df070fdb9cb/frozenlist-1.8.0-cp312-cp312-win_arm64.whl", hash = "sha256:fe3c58d2f5db5fbd18c2987cba06d51b0529f52bc3a6cdc33d3f4eab725104bd", size = 40102, upload-time = "2025-10-06T05:36:26.333Z" },
-    { url = "https://files.pythonhosted.org/packages/2d/40/0832c31a37d60f60ed79e9dfb5a92e1e2af4f40a16a29abcc7992af9edff/frozenlist-1.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:8d92f1a84bb12d9e56f818b3a746f3efba93c1b63c8387a73dde655e1e42282a", size = 85717, upload-time = "2025-10-06T05:36:27.341Z" },
-    { url = "https://files.pythonhosted.org/packages/30/ba/b0b3de23f40bc55a7057bd38434e25c34fa48e17f20ee273bbde5e0650f3/frozenlist-1.8.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:96153e77a591c8adc2ee805756c61f59fef4cf4073a9275ee86fe8cba41241f7", size = 49651, upload-time = "2025-10-06T05:36:28.855Z" },
-    { url = "https://files.pythonhosted.org/packages/0c/ab/6e5080ee374f875296c4243c381bbdef97a9ac39c6e3ce1d5f7d42cb78d6/frozenlist-1.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:f21f00a91358803399890ab167098c131ec2ddd5f8f5fd5fe9c9f2c6fcd91e40", size = 49417, upload-time = "2025-10-06T05:36:29.877Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/4e/e4691508f9477ce67da2015d8c00acd751e6287739123113a9fca6f1604e/frozenlist-1.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fb30f9626572a76dfe4293c7194a09fb1fe93ba94c7d4f720dfae3b646b45027", size = 234391, upload-time = "2025-10-06T05:36:31.301Z" },
-    { url = "https://files.pythonhosted.org/packages/40/76/c202df58e3acdf12969a7895fd6f3bc016c642e6726aa63bd3025e0fc71c/frozenlist-1.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaa352d7047a31d87dafcacbabe89df0aa506abb5b1b85a2fb91bc3faa02d822", size = 233048, upload-time = "2025-10-06T05:36:32.531Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/c0/8746afb90f17b73ca5979c7a3958116e105ff796e718575175319b5bb4ce/frozenlist-1.8.0-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:03ae967b4e297f58f8c774c7eabcce57fe3c2434817d4385c50661845a058121", size = 226549, upload-time = "2025-10-06T05:36:33.706Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/eb/4c7eefc718ff72f9b6c4893291abaae5fbc0c82226a32dcd8ef4f7a5dbef/frozenlist-1.8.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6292f1de555ffcc675941d65fffffb0a5bcd992905015f85d0592201793e0e5", size = 239833, upload-time = "2025-10-06T05:36:34.947Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/4e/e5c02187cf704224f8b21bee886f3d713ca379535f16893233b9d672ea71/frozenlist-1.8.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:29548f9b5b5e3460ce7378144c3010363d8035cea44bc0bf02d57f5a685e084e", size = 245363, upload-time = "2025-10-06T05:36:36.534Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/96/cb85ec608464472e82ad37a17f844889c36100eed57bea094518bf270692/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ec3cc8c5d4084591b4237c0a272cc4f50a5b03396a47d9caaf76f5d7b38a4f11", size = 229314, upload-time = "2025-10-06T05:36:38.582Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/6f/4ae69c550e4cee66b57887daeebe006fe985917c01d0fff9caab9883f6d0/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:517279f58009d0b1f2e7c1b130b377a349405da3f7621ed6bfae50b10adf20c1", size = 243365, upload-time = "2025-10-06T05:36:40.152Z" },
-    { url = "https://files.pythonhosted.org/packages/7a/58/afd56de246cf11780a40a2c28dc7cbabbf06337cc8ddb1c780a2d97e88d8/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:db1e72ede2d0d7ccb213f218df6a078a9c09a7de257c2fe8fcef16d5925230b1", size = 237763, upload-time = "2025-10-06T05:36:41.355Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/36/cdfaf6ed42e2644740d4a10452d8e97fa1c062e2a8006e4b09f1b5fd7d63/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:b4dec9482a65c54a5044486847b8a66bf10c9cb4926d42927ec4e8fd5db7fed8", size = 240110, upload-time = "2025-10-06T05:36:42.716Z" },
-    { url = "https://files.pythonhosted.org/packages/03/a8/9ea226fbefad669f11b52e864c55f0bd57d3c8d7eb07e9f2e9a0b39502e1/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:21900c48ae04d13d416f0e1e0c4d81f7931f73a9dfa0b7a8746fb2fe7dd970ed", size = 233717, upload-time = "2025-10-06T05:36:44.251Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/0b/1b5531611e83ba7d13ccc9988967ea1b51186af64c42b7a7af465dcc9568/frozenlist-1.8.0-cp313-cp313-win32.whl", hash = "sha256:8b7b94a067d1c504ee0b16def57ad5738701e4ba10cec90529f13fa03c833496", size = 39628, upload-time = "2025-10-06T05:36:45.423Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/cf/174c91dbc9cc49bc7b7aab74d8b734e974d1faa8f191c74af9b7e80848e6/frozenlist-1.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:878be833caa6a3821caf85eb39c5ba92d28e85df26d57afb06b35b2efd937231", size = 43882, upload-time = "2025-10-06T05:36:46.796Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/17/502cd212cbfa96eb1388614fe39a3fc9ab87dbbe042b66f97acb57474834/frozenlist-1.8.0-cp313-cp313-win_arm64.whl", hash = "sha256:44389d135b3ff43ba8cc89ff7f51f5a0bb6b63d829c8300f79a2fe4fe61bcc62", size = 39676, upload-time = "2025-10-06T05:36:47.8Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/5c/3bbfaa920dfab09e76946a5d2833a7cbdf7b9b4a91c714666ac4855b88b4/frozenlist-1.8.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:e25ac20a2ef37e91c1b39938b591457666a0fa835c7783c3a8f33ea42870db94", size = 89235, upload-time = "2025-10-06T05:36:48.78Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/d6/f03961ef72166cec1687e84e8925838442b615bd0b8854b54923ce5b7b8a/frozenlist-1.8.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:07cdca25a91a4386d2e76ad992916a85038a9b97561bf7a3fd12d5d9ce31870c", size = 50742, upload-time = "2025-10-06T05:36:49.837Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/bb/a6d12b7ba4c3337667d0e421f7181c82dda448ce4e7ad7ecd249a16fa806/frozenlist-1.8.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4e0c11f2cc6717e0a741f84a527c52616140741cd812a50422f83dc31749fb52", size = 51725, upload-time = "2025-10-06T05:36:50.851Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/71/d1fed0ffe2c2ccd70b43714c6cab0f4188f09f8a67a7914a6b46ee30f274/frozenlist-1.8.0-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b3210649ee28062ea6099cfda39e147fa1bc039583c8ee4481cb7811e2448c51", size = 284533, upload-time = "2025-10-06T05:36:51.898Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/1f/fb1685a7b009d89f9bf78a42d94461bc06581f6e718c39344754a5d9bada/frozenlist-1.8.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:581ef5194c48035a7de2aefc72ac6539823bb71508189e5de01d60c9dcd5fa65", size = 292506, upload-time = "2025-10-06T05:36:53.101Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/3b/b991fe1612703f7e0d05c0cf734c1b77aaf7c7d321df4572e8d36e7048c8/frozenlist-1.8.0-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3ef2d026f16a2b1866e1d86fc4e1291e1ed8a387b2c333809419a2f8b3a77b82", size = 274161, upload-time = "2025-10-06T05:36:54.309Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/ec/c5c618767bcdf66e88945ec0157d7f6c4a1322f1473392319b7a2501ded7/frozenlist-1.8.0-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5500ef82073f599ac84d888e3a8c1f77ac831183244bfd7f11eaa0289fb30714", size = 294676, upload-time = "2025-10-06T05:36:55.566Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/ce/3934758637d8f8a88d11f0585d6495ef54b2044ed6ec84492a91fa3b27aa/frozenlist-1.8.0-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:50066c3997d0091c411a66e710f4e11752251e6d2d73d70d8d5d4c76442a199d", size = 300638, upload-time = "2025-10-06T05:36:56.758Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/4f/a7e4d0d467298f42de4b41cbc7ddaf19d3cfeabaf9ff97c20c6c7ee409f9/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:5c1c8e78426e59b3f8005e9b19f6ff46e5845895adbde20ece9218319eca6506", size = 283067, upload-time = "2025-10-06T05:36:57.965Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/48/c7b163063d55a83772b268e6d1affb960771b0e203b632cfe09522d67ea5/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:eefdba20de0d938cec6a89bd4d70f346a03108a19b9df4248d3cf0d88f1b0f51", size = 292101, upload-time = "2025-10-06T05:36:59.237Z" },
-    { url = "https://files.pythonhosted.org/packages/9f/d0/2366d3c4ecdc2fd391e0afa6e11500bfba0ea772764d631bbf82f0136c9d/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:cf253e0e1c3ceb4aaff6df637ce033ff6535fb8c70a764a8f46aafd3d6ab798e", size = 289901, upload-time = "2025-10-06T05:37:00.811Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/94/daff920e82c1b70e3618a2ac39fbc01ae3e2ff6124e80739ce5d71c9b920/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:032efa2674356903cd0261c4317a561a6850f3ac864a63fc1583147fb05a79b0", size = 289395, upload-time = "2025-10-06T05:37:02.115Z" },
-    { url = "https://files.pythonhosted.org/packages/e3/20/bba307ab4235a09fdcd3cc5508dbabd17c4634a1af4b96e0f69bfe551ebd/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6da155091429aeba16851ecb10a9104a108bcd32f6c1642867eadaee401c1c41", size = 283659, upload-time = "2025-10-06T05:37:03.711Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/00/04ca1c3a7a124b6de4f8a9a17cc2fcad138b4608e7a3fc5877804b8715d7/frozenlist-1.8.0-cp313-cp313t-win32.whl", hash = "sha256:0f96534f8bfebc1a394209427d0f8a63d343c9779cda6fc25e8e121b5fd8555b", size = 43492, upload-time = "2025-10-06T05:37:04.915Z" },
-    { url = "https://files.pythonhosted.org/packages/59/5e/c69f733a86a94ab10f68e496dc6b7e8bc078ebb415281d5698313e3af3a1/frozenlist-1.8.0-cp313-cp313t-win_amd64.whl", hash = "sha256:5d63a068f978fc69421fb0e6eb91a9603187527c86b7cd3f534a5b77a592b888", size = 48034, upload-time = "2025-10-06T05:37:06.343Z" },
-    { url = "https://files.pythonhosted.org/packages/16/6c/be9d79775d8abe79b05fa6d23da99ad6e7763a1d080fbae7290b286093fd/frozenlist-1.8.0-cp313-cp313t-win_arm64.whl", hash = "sha256:bf0a7e10b077bf5fb9380ad3ae8ce20ef919a6ad93b4552896419ac7e1d8e042", size = 41749, upload-time = "2025-10-06T05:37:07.431Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/c8/85da824b7e7b9b6e7f7705b2ecaf9591ba6f79c1177f324c2735e41d36a2/frozenlist-1.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:cee686f1f4cadeb2136007ddedd0aaf928ab95216e7691c63e50a8ec066336d0", size = 86127, upload-time = "2025-10-06T05:37:08.438Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/e8/a1185e236ec66c20afd72399522f142c3724c785789255202d27ae992818/frozenlist-1.8.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:119fb2a1bd47307e899c2fac7f28e85b9a543864df47aa7ec9d3c1b4545f096f", size = 49698, upload-time = "2025-10-06T05:37:09.48Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/93/72b1736d68f03fda5fdf0f2180fb6caaae3894f1b854d006ac61ecc727ee/frozenlist-1.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4970ece02dbc8c3a92fcc5228e36a3e933a01a999f7094ff7c23fbd2beeaa67c", size = 49749, upload-time = "2025-10-06T05:37:10.569Z" },
-    { url = "https://files.pythonhosted.org/packages/a7/b2/fabede9fafd976b991e9f1b9c8c873ed86f202889b864756f240ce6dd855/frozenlist-1.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:cba69cb73723c3f329622e34bdbf5ce1f80c21c290ff04256cff1cd3c2036ed2", size = 231298, upload-time = "2025-10-06T05:37:11.993Z" },
-    { url = "https://files.pythonhosted.org/packages/3a/3b/d9b1e0b0eed36e70477ffb8360c49c85c8ca8ef9700a4e6711f39a6e8b45/frozenlist-1.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:778a11b15673f6f1df23d9586f83c4846c471a8af693a22e066508b77d201ec8", size = 232015, upload-time = "2025-10-06T05:37:13.194Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/94/be719d2766c1138148564a3960fc2c06eb688da592bdc25adcf856101be7/frozenlist-1.8.0-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0325024fe97f94c41c08872db482cf8ac4800d80e79222c6b0b7b162d5b13686", size = 225038, upload-time = "2025-10-06T05:37:14.577Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/09/6712b6c5465f083f52f50cf74167b92d4ea2f50e46a9eea0523d658454ae/frozenlist-1.8.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:97260ff46b207a82a7567b581ab4190bd4dfa09f4db8a8b49d1a958f6aa4940e", size = 240130, upload-time = "2025-10-06T05:37:15.781Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/d4/cd065cdcf21550b54f3ce6a22e143ac9e4836ca42a0de1022da8498eac89/frozenlist-1.8.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:54b2077180eb7f83dd52c40b2750d0a9f175e06a42e3213ce047219de902717a", size = 242845, upload-time = "2025-10-06T05:37:17.037Z" },
-    { url = "https://files.pythonhosted.org/packages/62/c3/f57a5c8c70cd1ead3d5d5f776f89d33110b1addae0ab010ad774d9a44fb9/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:2f05983daecab868a31e1da44462873306d3cbfd76d1f0b5b69c473d21dbb128", size = 229131, upload-time = "2025-10-06T05:37:18.221Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/52/232476fe9cb64f0742f3fde2b7d26c1dac18b6d62071c74d4ded55e0ef94/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:33f48f51a446114bc5d251fb2954ab0164d5be02ad3382abcbfe07e2531d650f", size = 240542, upload-time = "2025-10-06T05:37:19.771Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/85/07bf3f5d0fb5414aee5f47d33c6f5c77bfe49aac680bfece33d4fdf6a246/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:154e55ec0655291b5dd1b8731c637ecdb50975a2ae70c606d100750a540082f7", size = 237308, upload-time = "2025-10-06T05:37:20.969Z" },
-    { url = "https://files.pythonhosted.org/packages/11/99/ae3a33d5befd41ac0ca2cc7fd3aa707c9c324de2e89db0e0f45db9a64c26/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:4314debad13beb564b708b4a496020e5306c7333fa9a3ab90374169a20ffab30", size = 238210, upload-time = "2025-10-06T05:37:22.252Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/60/b1d2da22f4970e7a155f0adde9b1435712ece01b3cd45ba63702aea33938/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:073f8bf8becba60aa931eb3bc420b217bb7d5b8f4750e6f8b3be7f3da85d38b7", size = 231972, upload-time = "2025-10-06T05:37:23.5Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/ab/945b2f32de889993b9c9133216c068b7fcf257d8595a0ac420ac8677cab0/frozenlist-1.8.0-cp314-cp314-win32.whl", hash = "sha256:bac9c42ba2ac65ddc115d930c78d24ab8d4f465fd3fc473cdedfccadb9429806", size = 40536, upload-time = "2025-10-06T05:37:25.581Z" },
-    { url = "https://files.pythonhosted.org/packages/59/ad/9caa9b9c836d9ad6f067157a531ac48b7d36499f5036d4141ce78c230b1b/frozenlist-1.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:3e0761f4d1a44f1d1a47996511752cf3dcec5bbdd9cc2b4fe595caf97754b7a0", size = 44330, upload-time = "2025-10-06T05:37:26.928Z" },
-    { url = "https://files.pythonhosted.org/packages/82/13/e6950121764f2676f43534c555249f57030150260aee9dcf7d64efda11dd/frozenlist-1.8.0-cp314-cp314-win_arm64.whl", hash = "sha256:d1eaff1d00c7751b7c6662e9c5ba6eb2c17a2306ba5e2a37f24ddf3cc953402b", size = 40627, upload-time = "2025-10-06T05:37:28.075Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/c7/43200656ecc4e02d3f8bc248df68256cd9572b3f0017f0a0c4e93440ae23/frozenlist-1.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:d3bb933317c52d7ea5004a1c442eef86f426886fba134ef8cf4226ea6ee1821d", size = 89238, upload-time = "2025-10-06T05:37:29.373Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/29/55c5f0689b9c0fb765055629f472c0de484dcaf0acee2f7707266ae3583c/frozenlist-1.8.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:8009897cdef112072f93a0efdce29cd819e717fd2f649ee3016efd3cd885a7ed", size = 50738, upload-time = "2025-10-06T05:37:30.792Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/7d/b7282a445956506fa11da8c2db7d276adcbf2b17d8bb8407a47685263f90/frozenlist-1.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2c5dcbbc55383e5883246d11fd179782a9d07a986c40f49abe89ddf865913930", size = 51739, upload-time = "2025-10-06T05:37:32.127Z" },
-    { url = "https://files.pythonhosted.org/packages/62/1c/3d8622e60d0b767a5510d1d3cf21065b9db874696a51ea6d7a43180a259c/frozenlist-1.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:39ecbc32f1390387d2aa4f5a995e465e9e2f79ba3adcac92d68e3e0afae6657c", size = 284186, upload-time = "2025-10-06T05:37:33.21Z" },
-    { url = "https://files.pythonhosted.org/packages/2d/14/aa36d5f85a89679a85a1d44cd7a6657e0b1c75f61e7cad987b203d2daca8/frozenlist-1.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:92db2bf818d5cc8d9c1f1fc56b897662e24ea5adb36ad1f1d82875bd64e03c24", size = 292196, upload-time = "2025-10-06T05:37:36.107Z" },
-    { url = "https://files.pythonhosted.org/packages/05/23/6bde59eb55abd407d34f77d39a5126fb7b4f109a3f611d3929f14b700c66/frozenlist-1.8.0-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2dc43a022e555de94c3b68a4ef0b11c4f747d12c024a520c7101709a2144fb37", size = 273830, upload-time = "2025-10-06T05:37:37.663Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/3f/22cff331bfad7a8afa616289000ba793347fcd7bc275f3b28ecea2a27909/frozenlist-1.8.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:cb89a7f2de3602cfed448095bab3f178399646ab7c61454315089787df07733a", size = 294289, upload-time = "2025-10-06T05:37:39.261Z" },
-    { url = "https://files.pythonhosted.org/packages/a4/89/5b057c799de4838b6c69aa82b79705f2027615e01be996d2486a69ca99c4/frozenlist-1.8.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:33139dc858c580ea50e7e60a1b0ea003efa1fd42e6ec7fdbad78fff65fad2fd2", size = 300318, upload-time = "2025-10-06T05:37:43.213Z" },
-    { url = "https://files.pythonhosted.org/packages/30/de/2c22ab3eb2a8af6d69dc799e48455813bab3690c760de58e1bf43b36da3e/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:168c0969a329b416119507ba30b9ea13688fafffac1b7822802537569a1cb0ef", size = 282814, upload-time = "2025-10-06T05:37:45.337Z" },
-    { url = "https://files.pythonhosted.org/packages/59/f7/970141a6a8dbd7f556d94977858cfb36fa9b66e0892c6dd780d2219d8cd8/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:28bd570e8e189d7f7b001966435f9dac6718324b5be2990ac496cf1ea9ddb7fe", size = 291762, upload-time = "2025-10-06T05:37:46.657Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/15/ca1adae83a719f82df9116d66f5bb28bb95557b3951903d39135620ef157/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:b2a095d45c5d46e5e79ba1e5b9cb787f541a8dee0433836cea4b96a2c439dcd8", size = 289470, upload-time = "2025-10-06T05:37:47.946Z" },
-    { url = "https://files.pythonhosted.org/packages/ac/83/dca6dc53bf657d371fbc88ddeb21b79891e747189c5de990b9dfff2ccba1/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:eab8145831a0d56ec9c4139b6c3e594c7a83c2c8be25d5bcf2d86136a532287a", size = 289042, upload-time = "2025-10-06T05:37:49.499Z" },
-    { url = "https://files.pythonhosted.org/packages/96/52/abddd34ca99be142f354398700536c5bd315880ed0a213812bc491cff5e4/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:974b28cf63cc99dfb2188d8d222bc6843656188164848c4f679e63dae4b0708e", size = 283148, upload-time = "2025-10-06T05:37:50.745Z" },
-    { url = "https://files.pythonhosted.org/packages/af/d3/76bd4ed4317e7119c2b7f57c3f6934aba26d277acc6309f873341640e21f/frozenlist-1.8.0-cp314-cp314t-win32.whl", hash = "sha256:342c97bf697ac5480c0a7ec73cd700ecfa5a8a40ac923bd035484616efecc2df", size = 44676, upload-time = "2025-10-06T05:37:52.222Z" },
-    { url = "https://files.pythonhosted.org/packages/89/76/c615883b7b521ead2944bb3480398cbb07e12b7b4e4d073d3752eb721558/frozenlist-1.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:06be8f67f39c8b1dc671f5d83aaefd3358ae5cdcf8314552c57e7ed3e6475bdd", size = 49451, upload-time = "2025-10-06T05:37:53.425Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/a3/5982da14e113d07b325230f95060e2169f5311b1017ea8af2a29b374c289/frozenlist-1.8.0-cp314-cp314t-win_arm64.whl", hash = "sha256:102e6314ca4da683dca92e3b1355490fed5f313b768500084fbe6371fddfdb79", size = 42507, upload-time = "2025-10-06T05:37:54.513Z" },
     { url = "https://files.pythonhosted.org/packages/9a/9a/e35b4a917281c0b8419d4207f4334c8e8c5dbf4f3f5f9ada73958d937dcc/frozenlist-1.8.0-py3-none-any.whl", hash = "sha256:0c18a16eab41e82c295618a77502e17b195883241c563b00f0aa5106fc4eaa0d", size = 13409, upload-time = "2025-10-06T05:38:16.721Z" },
 ]
 
@@ -879,25 +604,18 @@ dependencies = [
     { name = "gently-perception" },
     { name = "jinja2" },
     { name = "matplotlib" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "nvidia-ml-py" },
+    { name = "numpy" },
     { name = "ophyd" },
     { name = "pillow" },
     { name = "pymmcore" },
-    { name = "pytest" },
-    { name = "pytest-asyncio" },
     { name = "python-dotenv" },
     { name = "pyyaml" },
-    { name = "scikit-image", version = "0.25.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "scikit-image", version = "0.26.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "tifffile", version = "2025.5.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "tifffile", version = "2026.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
-    { name = "tifffile", version = "2026.5.15", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
-    { name = "torch" },
-    { name = "torchvision" },
+    { name = "scikit-image", version = "0.25.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scikit-image", version = "0.26.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "tifffile", version = "2025.5.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "tifffile", version = "2026.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "uvicorn", extra = ["standard"] },
 ]
 
@@ -910,6 +628,23 @@ device = [
 sam = [
     { name = "segment-anything" },
 ]
+torch-cpu = [
+    { name = "torch", version = "2.12.0", source = { registry = "https://download.pytorch.org/whl/cpu" }, marker = "(sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu') or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "torch", version = "2.12.0+cpu", source = { registry = "https://download.pytorch.org/whl/cpu" }, marker = "(sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu') or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "torchvision", version = "0.27.0", source = { registry = "https://download.pytorch.org/whl/cpu" }, marker = "(sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu') or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "torchvision", version = "0.27.0+cpu", source = { registry = "https://download.pytorch.org/whl/cpu" }, marker = "(sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu') or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+]
+torch-gpu = [
+    { name = "nvidia-ml-py" },
+    { name = "torch", version = "2.7.1+cu118", source = { registry = "https://download.pytorch.org/whl/cu118" } },
+    { name = "torchvision", version = "0.22.1+cu118", source = { registry = "https://download.pytorch.org/whl/cu118" } },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+]
 
 [package.metadata]
 requires-dist = [
@@ -921,26 +656,32 @@ requires-dist = [
     { name = "gently-perception", editable = "../gently-perception" },
     { name = "jinja2", specifier = ">=3.1.0" },
     { name = "matplotlib", specifier = ">=3.7.0" },
-    { name = "numpy", specifier = ">=1.24.0" },
-    { name = "nvidia-ml-py", specifier = ">=12.0.0" },
+    { name = "numpy", specifier = ">=1.24.0,<2" },
+    { name = "nvidia-ml-py", marker = "extra == 'torch-gpu'", specifier = ">=12.0.0" },
     { name = "ophyd", specifier = ">=1.9.0" },
     { name = "paho-mqtt", marker = "extra == 'device'", specifier = ">=1.6.0" },
     { name = "pillow", specifier = ">=10.0.0" },
-    { name = "pymmcore", specifier = ">=11.1.1" },
+    { name = "pymmcore", specifier = "==10.1.1.70.6" },
     { name = "pyserial", marker = "extra == 'device'", specifier = ">=3.5" },
-    { name = "pytest", specifier = ">=7.0.0" },
-    { name = "pytest-asyncio", specifier = ">=0.21.0" },
     { name = "python-dotenv", specifier = ">=1.0.0" },
     { name = "pyyaml", specifier = ">=6.0" },
     { name = "scikit-image", specifier = ">=0.21.0" },
     { name = "scipy", specifier = ">=1.10.0" },
     { name = "segment-anything", marker = "extra == 'sam'" },
     { name = "tifffile", specifier = ">=2023.0.0" },
-    { name = "torch", specifier = ">=2.0.0" },
-    { name = "torchvision", specifier = ">=0.15.0" },
+    { name = "torch", marker = "extra == 'torch-cpu'", specifier = ">=2.0.0", index = "https://download.pytorch.org/whl/cpu", conflict = { package = "gently", extra = "torch-cpu" } },
+    { name = "torch", marker = "extra == 'torch-gpu'", specifier = ">=2.0.0", index = "https://download.pytorch.org/whl/cu118", conflict = { package = "gently", extra = "torch-gpu" } },
+    { name = "torchvision", marker = "extra == 'torch-cpu'", specifier = ">=0.15.0", index = "https://download.pytorch.org/whl/cpu", conflict = { package = "gently", extra = "torch-cpu" } },
+    { name = "torchvision", marker = "extra == 'torch-gpu'", specifier = ">=0.15.0", index = "https://download.pytorch.org/whl/cu118", conflict = { package = "gently", extra = "torch-gpu" } },
     { name = "uvicorn", extras = ["standard"], specifier = ">=0.24.0" },
 ]
-provides-extras = ["sam", "device"]
+provides-extras = ["sam", "torch-gpu", "torch-cpu", "device"]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=7.0.0" },
+    { name = "pytest-asyncio", specifier = ">=0.21.0" },
+]
 
 [[package]]
 name = "gently-perception"
@@ -948,8 +689,7 @@ version = "0.1.0"
 source = { editable = "../gently-perception" }
 dependencies = [
     { name = "anthropic" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
     { name = "pillow" },
 ]
 
@@ -1021,27 +761,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/9e/2d/0c9ac76dd2c893841fbf6498d6acec4f2442e1b7067f6e3e316a80e494e8/httptools-0.8.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ef7c3c97f4311c7be57e2986629df89d49cb434dbff78eafcd48c2bff986b15a", size = 501238, upload-time = "2026-05-25T22:17:12.728Z" },
     { url = "https://files.pythonhosted.org/packages/ca/42/906adc91ae3a5fa9c59c0a2f21c139725bd7e5b41ae6acd485cd14123ebf/httptools-0.8.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a1afd7c9fbff0d9f5d489c4ce2768bd09c84a46ddefc7161e6aa82ae35c85745", size = 509567, upload-time = "2026-05-25T22:17:13.842Z" },
     { url = "https://files.pythonhosted.org/packages/05/0b/4240efeb672751ee5b9b380cb0e3fdc050bc05f68adc7a8aefc4fcd9a69a/httptools-0.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:cd96f29b4bab1d42fa6e3d008711c75e0f79e94e06827330160e3a304227f150", size = 90918, upload-time = "2026-05-25T22:17:15.155Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/e5/8cfcabc5546e8022f168be28bcdaa128a240a0befdd03b59d558b4f18bd6/httptools-0.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:614ceea8ea606848bece2338ac03b3ce5324bcb4be8dc7d377ed708012fa4db8", size = 205148, upload-time = "2026-05-25T22:17:16.333Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/0e/0fb14848c19a686c8062ff9067c1a48793e3224b47bc5b201535b6036fce/httptools-0.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2d689918c15a013c65ef52d9fd495d766893ab831a2c8d89f2ac5940a5df847c", size = 111368, upload-time = "2026-05-25T22:17:17.586Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/1b/46f1cecf06b9bbde8e4b8c88034ac7908989e5ff7a3a388ef38392949c1f/httptools-0.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:eb3028cca2fc0a6d720e52ef61d8ebb62fcbfeb1de56874546d858d3f25a26b7", size = 486447, upload-time = "2026-05-25T22:17:18.564Z" },
-    { url = "https://files.pythonhosted.org/packages/77/00/258bfc0837221f81d9725c45f9b948a6a6b2994a147a4fb66e85100c668f/httptools-0.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:88bdd940f2b5d487b4d032c6afa5489a7dc4694410d43de3c38c4fb3af0dc45d", size = 482448, upload-time = "2026-05-25T22:17:19.912Z" },
-    { url = "https://files.pythonhosted.org/packages/04/ab/d1cef3b5523f4d272a70f42a776c3169a2dddfe3a54de4b2ce4a36341528/httptools-0.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6a43c9dd399758ccc0531acb0a3c4a6c299ee893ee9400e9c893b7bdcfae0681", size = 464460, upload-time = "2026-05-25T22:17:20.882Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/48/5d1d072442277bb2b3434e0e60690b8e8c23840ef7de8b6ea54040a536d3/httptools-0.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0770728beb05094c809b98e814edff5fef69d26ad7d21185f2f6d5884a0ba683", size = 471312, upload-time = "2026-05-25T22:17:22.085Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/66/b96623b27e51a68199ef4efdda0613cced9233fe3062ac74e50749c5ad37/httptools-0.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:7685df791fad561384bfb139e77fde27a1ffd93134e016f95a0db424ffbf77b1", size = 90117, upload-time = "2026-05-25T22:17:23.074Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/12/fa3fbf5f9517b273edea2dc982aa82a8c634091e67c590792b729017bc6f/httptools-0.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:de242a49b5d18e0a8776e654e9f6bf6d89f3875a5c35b425a0e7ce940feb3fd6", size = 206183, upload-time = "2026-05-25T22:17:24.004Z" },
-    { url = "https://files.pythonhosted.org/packages/30/fc/5e7c4cb443370f2090a3aba0453a07384d29ff66b7435bb90e77e1037599/httptools-0.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:159e9ab5f701ccd42e555a12f1ad8ff69702910fc1c996cf2bb66e5fcb7a231b", size = 112079, upload-time = "2026-05-25T22:17:25.216Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/53/771bd891eb0f236f32145d6a1775777ec85745f3cc983a1f23d1a3b8ddfe/httptools-0.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c4a9f1707e4823d54dfec6c33fa3697d302aed536ed352a7ebb5a061ddb869d0", size = 481596, upload-time = "2026-05-25T22:17:26.186Z" },
-    { url = "https://files.pythonhosted.org/packages/62/42/94e15bc68ce3d423243c45d7f1b0c7561f13844f97dc52ae23182fb65628/httptools-0.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d76ad7b951387e3632c8716a9bb03ac5b45c5f16119aa409db0459520887944e", size = 480865, upload-time = "2026-05-25T22:17:27.542Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/7c/fe2980fc03723272e30f135b62360b075f513dfe7cc73aef36c7f04012bd/httptools-0.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a3b7387147361c3fd47a0bde763c5c91b5b4cd4dc9989b8ece84ff436c99843b", size = 463189, upload-time = "2026-05-25T22:17:28.546Z" },
-    { url = "https://files.pythonhosted.org/packages/15/1b/47fc5fff68acd1bfa20b4734059c9a06cadb88119dcd5258b5b0d21d91c8/httptools-0.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f256d6ce930c52ca1cb2a960b7da03548c454e7d28b06059ad41bfe789036ce0", size = 466610, upload-time = "2026-05-25T22:17:29.816Z" },
-    { url = "https://files.pythonhosted.org/packages/60/bd/07b13c93ffd9bec9546e0d43f8e19378dd696dbd278511406bc07371ef1f/httptools-0.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:19d1ee275bb59ba2643ba9a3a1e51cc0c788caf2b8df506368e03f56fdd08527", size = 92705, upload-time = "2026-05-25T22:17:31.133Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/c4/121648f68ce066d7bd762d6b6d97e620847642d38d54f3d90ff11d947629/httptools-0.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:de1ed58a974e75d56560acc7e7fed01a454994429456f65209789992e41f2568", size = 215023, upload-time = "2026-05-25T22:17:32.401Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/b0/312a062ae741ae3e8baa8c8bf20be81b2e67337b259ab4349bebc7b6142e/httptools-0.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:e93c227b595c6926c1acee96891dd9da4be338cfbe82e5cd3bb9d8dd7dc4ac0b", size = 117405, upload-time = "2026-05-25T22:17:33.742Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/37/fccd705f795386bb05bf413012fecff2a33e5aa8c2f069096de3e9fd8702/httptools-0.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:2a021c3a8e65cc125390d72f59b968afca3bdcaff25bd67965e0a055a14946ca", size = 558497, upload-time = "2026-05-25T22:17:34.732Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/39/f172e8003576de35f5ba77ff417cf0e34429d35dc014deef15afa337a72c/httptools-0.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:48774d39cbb70e2b1f71f88852a3087ae1d3a1eb80482bb48c13067ab080c14f", size = 571585, upload-time = "2026-05-25T22:17:35.813Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/b9/f5564760af99f3dbbf3f9104dc00e5da27e96cf433c6bdcf77617f70bf3f/httptools-0.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:88eead8ec8680a9f146c655bc88445a325bd7921cfd8194c7337e9467282427d", size = 543297, upload-time = "2026-05-25T22:17:37.08Z" },
-    { url = "https://files.pythonhosted.org/packages/99/67/8d9f2c313618e161b82f3873188e7196126da1d6e29688df40eb3997c77a/httptools-0.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2c032fa028f46871ec7e1fc59fc15e8023eab3e6bbe6ece786a1611719a5d081", size = 539535, upload-time = "2026-05-25T22:17:38.032Z" },
-    { url = "https://files.pythonhosted.org/packages/48/63/b906c01e53f50d432c0defe43ce52764a111dc1bdd028bafbeb54dcfd008/httptools-0.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:384c17174464c8e873398b7af24f0b1f44d992c820328413951a625323155d77", size = 108209, upload-time = "2026-05-25T22:17:39.473Z" },
 ]
 
 [[package]]
@@ -1073,8 +792,7 @@ name = "imageio"
 version = "2.37.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
     { name = "pillow" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/b1/84/93bcd1300216ea50811cee96873b84a1bebf8d0489ffaf7f2a3756bab866/imageio-2.37.3.tar.gz", hash = "sha256:bbb37efbfc4c400fcd534b367b91fcd66d5da639aaa138034431a1c5e0a41451", size = 389673, upload-time = "2026-03-09T11:31:12.573Z" }
@@ -1159,52 +877,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/23/4f/eca9b954942916ba2f453891b8593ab444cd872396fe66a3936616f236f3/jiter-0.15.0-cp312-cp312-win32.whl", hash = "sha256:c2f6bb8b5216ab9e7873bc08b5d7bef2b8abbb578a3069bf1cd14a45d71d771d", size = 206427, upload-time = "2026-05-19T10:07:55.307Z" },
     { url = "https://files.pythonhosted.org/packages/95/bf/8ead82a87495149542748e828d153fd232a512a22c83b02c4815c1a9c7d8/jiter-0.15.0-cp312-cp312-win_amd64.whl", hash = "sha256:40b2c7e92c44a84d748d21706c68dc6ff8161d80b59c99d774721a0d2317d7c7", size = 197300, upload-time = "2026-05-19T10:07:56.651Z" },
     { url = "https://files.pythonhosted.org/packages/f4/e4/9b8a78fb2d894471bc344e37f1949bdd784bd914d031dba0ba3a40c71dd7/jiter-0.15.0-cp312-cp312-win_arm64.whl", hash = "sha256:cc0bc345cf2df9d1c00ac443f50d543c1ccfa8b0422cb85b1ab70d681c0b255b", size = 192702, upload-time = "2026-05-19T10:07:58.307Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/f4/f708c900ecee41b2025ef8413d5351e5649eb2125c506f6720cc69b06f5c/jiter-0.15.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:1c11465f97e2abf45a014b83b730222f8f1c5335e802c7055a67d50de6f1f4e3", size = 307829, upload-time = "2026-05-19T10:07:59.704Z" },
-    { url = "https://files.pythonhosted.org/packages/86/59/db537c0949e83668c38481d426b9f2fd5ab758c4ee53a811dd0a510626a0/jiter-0.15.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:d1e7b1776f0797956c509e123d0952d10d293a9492dea9f288ab9570ec01d1a5", size = 308445, upload-time = "2026-05-19T10:08:01.184Z" },
-    { url = "https://files.pythonhosted.org/packages/37/38/ea0e13b18c30ef951da0d47d39e7fa9edb82a93a62990ffbd7cea9b622d4/jiter-0.15.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:351a341c2105aa430b7047e30f1bf7975f6313b00165d3fc07be2edaf741f279", size = 336181, upload-time = "2026-05-19T10:08:02.688Z" },
-    { url = "https://files.pythonhosted.org/packages/58/fc/2303901b16c4ba05865588990a420c0b4156270b44379c20931544a1d962/jiter-0.15.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4ab395feec8d249ec4044e228e98a7033f043426a265df439dc3698823f0a4e4", size = 362985, upload-time = "2026-05-19T10:08:04.394Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/6f/11bace093c52e7d4d26c8e606ccd7ae8c972189622469ec0d9e28161e28b/jiter-0.15.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a2a438005b6f22d0273413484d6094d7c2c5d10ec1b3a3bf128e0d1d3ba53258", size = 453292, upload-time = "2026-05-19T10:08:05.967Z" },
-    { url = "https://files.pythonhosted.org/packages/22/db/987f2f086ca4d7a6582eb4ccd513f9b26b42d9e4243a087609a3137a8fc7/jiter-0.15.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f18f85e4218d1b40f000f42a92239a7a61a902cd42c65e6c360dbd17dcb20894", size = 373501, upload-time = "2026-05-19T10:08:07.857Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/7c/89fbcabb2739b7a5b8dc959a1b6c5761f6484f5fed3486854b3c789bb1de/jiter-0.15.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d1aa62e277fc1cbd80e6deacae6f4d983b41b3d7728e0645c5d741a6149bba45", size = 344683, upload-time = "2026-05-19T10:08:09.431Z" },
-    { url = "https://files.pythonhosted.org/packages/30/6f/6cca7692e7dddfec6d8d76c54dc97f2af2a41df4ac0674b999df1f09a5f3/jiter-0.15.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:6550fa135c7deb8ead6af49ed7ff648532ea8334a1447fe34a36315ef79c5c29", size = 350892, upload-time = "2026-05-19T10:08:11.352Z" },
-    { url = "https://files.pythonhosted.org/packages/39/14/0338d6190cb8e6d22e677ab1d4eabd4117f67cca70c54cd04b82ff64e068/jiter-0.15.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:066f8f33f18b2419cd8213b2436fa7fbc9c499f315971cfa3ce1f9820c001b1b", size = 388723, upload-time = "2026-05-19T10:08:12.912Z" },
-    { url = "https://files.pythonhosted.org/packages/90/31/cc19f4a1bdb6afb09ce6a2f2615aa8d44d994eba0d8e6105ed1af920e736/jiter-0.15.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:75e8a04e91432dde9f1838373cf93d23726c79d3e908d319acf0e796f85592e7", size = 516648, upload-time = "2026-05-19T10:08:14.808Z" },
-    { url = "https://files.pythonhosted.org/packages/49/9f/833c541512cd091b63c10c0381973dfe11bc7a503a818c16384417e0c81e/jiter-0.15.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:a97261f1fccb8e50ecd2890a96e46efdc3f57c80a197324c6777827231eca712", size = 547382, upload-time = "2026-05-19T10:08:16.927Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/11/e7b70e91f90bc4477e8eee9e8a5f7cf3cb41b4525d6394dc98a714eb8f7f/jiter-0.15.0-cp313-cp313-win32.whl", hash = "sha256:c77496cb10bd7549690fbbab3e5ec05857b83e49276f4a9423a766ddd2afcd4c", size = 205845, upload-time = "2026-05-19T10:08:18.401Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/23/5c20d9ad6f02c493e4023e5d2d09e1c1f15fe2753c9102c544aff068a88e/jiter-0.15.0-cp313-cp313-win_amd64.whl", hash = "sha256:b15741f501469009ae0ae90b7147958a664a7dede40aa7ff174a8a4645f546d0", size = 196842, upload-time = "2026-05-19T10:08:20.131Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/11/1eb400ef248e8c925fd883fbe325daf5e42cd1b0d308539dd332bd4f7ffc/jiter-0.15.0-cp313-cp313-win_arm64.whl", hash = "sha256:5d6a60072b44c3c2b797a7ddcbcbbf2b34ea3cfd4721580fbfd2a09d9d9b84ba", size = 192212, upload-time = "2026-05-19T10:08:21.807Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/60/2fd8d7c79da8acf9b7b277c7616847773779356b92acfc9bb158452174da/jiter-0.15.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:ef1fd24d9413f6209e00d3d5a453e67acfe004a25cc6c8e8484faed4311ab9e8", size = 315065, upload-time = "2026-05-19T10:08:23.218Z" },
-    { url = "https://files.pythonhosted.org/packages/46/f4/008fb7d65e8ac2abf00811651a661e025c4ba80bbc6f378450384ddd3aed/jiter-0.15.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:144f8e72cb53dab146347b91cceac01f5481237f2b93b4a339a1ee8f8878b67c", size = 339444, upload-time = "2026-05-19T10:08:24.701Z" },
-    { url = "https://files.pythonhosted.org/packages/00/55/90b0c7b9c6896c0f2a591dd36d36b71d22e09674bfef178fa03ba3f81499/jiter-0.15.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:553fcac2ef2cb990877f9fc0833b8b629a3e6a5670b6b5fd58219b41a653ddc4", size = 347779, upload-time = "2026-05-19T10:08:26.408Z" },
-    { url = "https://files.pythonhosted.org/packages/51/6b/69666cec5000fd57734c118437394516c749ae8dbeea9fb66d6fef9c4775/jiter-0.15.0-cp313-cp313t-win_amd64.whl", hash = "sha256:774f93f65031856bf14ad9f59bdcab8b8cad501e5ceabd51ba3525f76937a25b", size = 200395, upload-time = "2026-05-19T10:08:28.055Z" },
-    { url = "https://files.pythonhosted.org/packages/39/04/a6aa62cd27e8149b0d28df5561f10f6cceaf7935a9ccf3f1c5a05f9a0cd8/jiter-0.15.0-cp313-cp313t-win_arm64.whl", hash = "sha256:f1e1754960f38ec40613a07e5e372df67acb3b890fb383b6fb3de3e49ddbf3c7", size = 190516, upload-time = "2026-05-19T10:08:29.35Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/d2/079f350ebf7859d081de30aa890f9e3be68516f754f3ba32366ffff4dcee/jiter-0.15.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:ac0d9ddea4350974be7a221fc25895f251a8fee748c889bdced2141c0fec1a49", size = 308884, upload-time = "2026-05-19T10:08:31.667Z" },
-    { url = "https://files.pythonhosted.org/packages/04/4e/a2c30a7f69b48c03b20935d647479106fe932f6e63f75faf53937197e05d/jiter-0.15.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:01a8222cf05ab1128e239421156c207949808acaaea2bdfd33130ae666786e86", size = 310028, upload-time = "2026-05-19T10:08:33.304Z" },
-    { url = "https://files.pythonhosted.org/packages/40/90/2e7cdfd3cf8ca967be38c48f5cf474d79f089efaf559a40f15984a77ae69/jiter-0.15.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:182226cbc930c9fab81bc2e41a4da672f89539906dadb05e75670ac07b94f71f", size = 337485, upload-time = "2026-05-19T10:08:35.259Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/11/15a1aa28b120b8ee5b4f1fb894c125046225f09847738bd64233d3b84883/jiter-0.15.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:71683c38c825452999b5717fcae07ea708e8c93003e808be4319c1b02e3d176e", size = 364223, upload-time = "2026-05-19T10:08:36.694Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/25/f442e8af5f3d0dcf47b39e83a0efd9ee45ea946aa6d04625dc3181eae3b6/jiter-0.15.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:30f2218e6a9e5c18bc10fe6d41ac189c442c88eacf11bad9f28ef95a9bef00e6", size = 456387, upload-time = "2026-05-19T10:08:38.143Z" },
-    { url = "https://files.pythonhosted.org/packages/da/f4/37f2d2c9f64f49af7da652ed7532bb5a2372e588e6927c3fdd76f911db65/jiter-0.15.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5157de9f76eb4bc5ea74a1219366a25f945ad305641d74e04f59c54087091aa9", size = 374461, upload-time = "2026-05-19T10:08:39.869Z" },
-    { url = "https://files.pythonhosted.org/packages/60/28/edcfbbbf0cb15436f36664a8908a0df47ab9006298d4cd937dc08ea932d6/jiter-0.15.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90c5db5527c221249a876160663ab891ace358c17f7b9c93ec1478b7f0550e5c", size = 345924, upload-time = "2026-05-19T10:08:41.668Z" },
-    { url = "https://files.pythonhosted.org/packages/47/13/89fba6398dab7f202b7278c4b4aac122399d2c0183971c4a57a3b7088df5/jiter-0.15.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:3e4540b8e74e4268811ac05db226a6a128ff572e7e0ce3f1163b693cadb184cd", size = 352283, upload-time = "2026-05-19T10:08:43.091Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/da/0f6af8cef2c565a1ab44d970f268c43ccaa72707386ea6388e6fe2b6cd26/jiter-0.15.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:62ebd14e47e9aed9df4472afcb2663668ce4d74891cd54f86bf6e44029d6dc89", size = 389985, upload-time = "2026-05-19T10:08:44.915Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/ec/b9cb7d6d29e24ee14910266157d2a279d7a8f60ee0df7fa840882976ba64/jiter-0.15.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0be6f5ad41a809f303f416d17cec92a7a725902fb9b4f3de3d19362ac0ef8554", size = 517695, upload-time = "2026-05-19T10:08:46.486Z" },
-    { url = "https://files.pythonhosted.org/packages/64/5e/6d1bda880723aae0ad86b4b763f044362448efe31e3e819635d41cb03451/jiter-0.15.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:813dfbb17d65328bf86e5f0905dd277ba2265d3ca20556e86c0c7035b7182e5a", size = 548868, upload-time = "2026-05-19T10:08:48.026Z" },
-    { url = "https://files.pythonhosted.org/packages/0c/72/7de501cf38dcacaf35098796f3a50e0f2e338baba18a58946c618544b809/jiter-0.15.0-cp314-cp314-win32.whl", hash = "sha256:50e51156192722a9c58db112837d3f8ef96fb3c5ecc14e95f409134b08b158ec", size = 206380, upload-time = "2026-05-19T10:08:49.738Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/a9/e19addf4b0c1bdce52c6da12351e6bc42c340c45e7c09e2158e46d293ccc/jiter-0.15.0-cp314-cp314-win_amd64.whl", hash = "sha256:30ce1a5d16b5641dc935d50ef775af6a0871e3d14ab05d6fc54dff371b78e558", size = 197687, upload-time = "2026-05-19T10:08:51.088Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/c9/776b1db01db25fc6c1d58d1979a37b0a9fe787e5f5b1d062d2eaacb77923/jiter-0.15.0-cp314-cp314-win_arm64.whl", hash = "sha256:510c8b3c17a0ed9ac69850c0438dada3c9b82d9c4d589fcb62002a5a9cf3a866", size = 192571, upload-time = "2026-05-19T10:08:52.451Z" },
-    { url = "https://files.pythonhosted.org/packages/a0/f6/45bb4670bacf300fd2c7abadbfb3af376e5f1b6ae75fd9bc069891d15870/jiter-0.15.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7553333dd0930c104a5a0db8df72bf7219fe663d731383b576bb6ed6351c984d", size = 317151, upload-time = "2026-05-19T10:08:53.867Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/68/ed635ad5acd7b73e454283083bbb7c8205ad10e88b0d9d7d793b09fe8226/jiter-0.15.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f2143ab06181d2b029eedcb6af3cebe95f11bbac62441781860f98ee9330a6a6", size = 341243, upload-time = "2026-05-19T10:08:55.383Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/db/3ff4176b817b8ea33879e71e13d8bc2b0d481a7ed3fe9e080f333d415c16/jiter-0.15.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6eac374c5c975709b69c10f09afd199df74150172156ad10c8d4fd785b7da995", size = 363629, upload-time = "2026-05-19T10:08:56.928Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/24/5f8270e0ba9c883582f96f722f8a0b58015c7ce1f8c6d4571cf394e99b6b/jiter-0.15.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b3b3b775e33d3bfaec9899edc526ae97b0da0bf9d071a46124ba419149a414f8", size = 456198, upload-time = "2026-05-19T10:08:58.618Z" },
-    { url = "https://files.pythonhosted.org/packages/45/5b/76fc02b0b5c54c3d18c60653156e2f76fde1816f9b4722db68d6ee2c897e/jiter-0.15.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eda3071db3346334beae1360b46da4606da57bf3528c167b3c38533afaf9f2c5", size = 373710, upload-time = "2026-05-19T10:09:00.151Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/52/4310821b0ea9277994d3e1f49fc6a4b34e4800caebacb2c0af81da59a454/jiter-0.15.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c6694a173ecabc12eb60efbc0b474464ead1951ff65cd8b1e72100715c64512b", size = 349901, upload-time = "2026-05-19T10:09:01.621Z" },
-    { url = "https://files.pythonhosted.org/packages/93/fe/67648c35b3594fba8854ac64cc8a826d8bcd18324bbdb53d77697c60b6ef/jiter-0.15.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:a254e10b593624d230c365b6d616b22ca0ad65e63a16e6631c2b3466022e6ba8", size = 352438, upload-time = "2026-05-19T10:09:03.216Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/28/0a1879d07ad6b3e025a2750027363452ced93c2d16d1c9d4b153ffd51c91/jiter-0.15.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d8d2955167274e15d79a7a020afdd9b39c990eb80b2d89fca695d92dcfdd38ec", size = 388152, upload-time = "2026-05-19T10:09:04.741Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/78/46c6f6b56ba85c90021f4afd72ed42f691f8f84daacb5fe27277070e3858/jiter-0.15.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:acf4ee4d1fc55917239fe72972fb292dd773055d05eb040d36f4326e02cc2c0e", size = 517707, upload-time = "2026-05-19T10:09:06.231Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/cb/720662d4c88fcad606e826fef5424365527ba43ce4868a479aed8f8c507e/jiter-0.15.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:e7196e56f1cd69af1dbb07dff02dcfb260a50b45a82d409d92a06fedb32473b5", size = 548241, upload-time = "2026-05-19T10:09:08.093Z" },
-    { url = "https://files.pythonhosted.org/packages/60/e3/935b8034fd143f21125c87d51404a9e0e1449186a494405721ff5d1d695e/jiter-0.15.0-cp314-cp314t-win32.whl", hash = "sha256:7f6163c0f10b055245f814dcc59f4818da60dfe72f3e72ab89fc24b6bd5e9c52", size = 207950, upload-time = "2026-05-19T10:09:09.616Z" },
-    { url = "https://files.pythonhosted.org/packages/93/59/984fd9ece895953dad3e0880a650e766f5a2da2c5514f0eafdaaabbeb5f9/jiter-0.15.0-cp314-cp314t-win_amd64.whl", hash = "sha256:980c256edb05b78a111b99c4de3b1d32e31634b867fd1fc2cf726e7b7bba9854", size = 200055, upload-time = "2026-05-19T10:09:11.367Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/a4/cf8d779feb133a27a2e3bc833bccb9e13aa332cdf820497ebf72c10ce8c3/jiter-0.15.0-cp314-cp314t-win_arm64.whl", hash = "sha256:66b1880df2d01e206e8339769d1c7c1753bcb653efd6289e203f6f24ebada0c0", size = 191244, upload-time = "2026-05-19T10:09:12.74Z" },
     { url = "https://files.pythonhosted.org/packages/65/43/1fc62172aa98b50a7de9a25554060db510f85c89cfbed0dfe13e1907a139/jiter-0.15.0-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:411fa4dfa5a7ae3d11491027ffb9beadec3996010a986862db70d91abba1c750", size = 305585, upload-time = "2026-05-19T10:09:35.995Z" },
     { url = "https://files.pythonhosted.org/packages/e8/c4/dd58fcd9e2df83666e5c1c1347bef58ce919cd8efc3ffa38aeea62ce493b/jiter-0.15.0-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:2b0074e2f56eb2dacca1689760fd2852a068f85a0547a157b82cb4cafeb6768b", size = 306936, upload-time = "2026-05-19T10:09:37.435Z" },
     { url = "https://files.pythonhosted.org/packages/39/86/b695e16f1180c07f43ea98e73ecd21cf63fa2e1b0c1103739013784d11ae/jiter-0.15.0-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:913d02d29c9606643418d9ccfc3b72492ab25a6bf7889934e09a3490f8d3438b", size = 342453, upload-time = "2026-05-19T10:09:39.294Z" },
@@ -1223,8 +895,8 @@ dependencies = [
     { name = "attrs" },
     { name = "jsonschema-specifications" },
     { name = "referencing" },
-    { name = "rpds-py", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "rpds-py", version = "2026.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "rpds-py", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "rpds-py", version = "2026.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
 wheels = [
@@ -1292,65 +964,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e4/34/8aefdd0be9cfd00a44509251ba864f5caf2991e36772e61c408007e7f417/kiwisolver-1.5.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:1d9daea4ea6b9be74fe2f01f7fbade8d6ffab263e781274cffca0dba9be9eec9", size = 2294947, upload-time = "2026-03-09T13:13:43.343Z" },
     { url = "https://files.pythonhosted.org/packages/ad/cf/0348374369ca588f8fe9c338fae49fa4e16eeb10ffb3d012f23a54578a9e/kiwisolver-1.5.0-cp312-cp312-win_amd64.whl", hash = "sha256:f18c2d9782259a6dc132fdc7a63c168cbc74b35284b6d75c673958982a378384", size = 73569, upload-time = "2026-03-09T13:13:45.792Z" },
     { url = "https://files.pythonhosted.org/packages/28/26/192b26196e2316e2bd29deef67e37cdf9870d9af8e085e521afff0fed526/kiwisolver-1.5.0-cp312-cp312-win_arm64.whl", hash = "sha256:f7c7553b13f69c1b29a5bde08ddc6d9d0c8bfb84f9ed01c30db25944aeb852a7", size = 64997, upload-time = "2026-03-09T13:13:46.878Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/69/024d6711d5ba575aa65d5538042e99964104e97fa153a9f10bc369182bc2/kiwisolver-1.5.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:fd40bb9cd0891c4c3cb1ddf83f8bbfa15731a248fdc8162669405451e2724b09", size = 123166, upload-time = "2026-03-09T13:13:48.032Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/48/adbb40df306f587054a348831220812b9b1d787aff714cfbc8556e38fccd/kiwisolver-1.5.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c0e1403fd7c26d77c1f03e096dc58a5c726503fa0db0456678b8668f76f521e3", size = 66395, upload-time = "2026-03-09T13:13:49.365Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/3a/d0a972b34e1c63e2409413104216cd1caa02c5a37cb668d1687d466c1c45/kiwisolver-1.5.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:dda366d548e89a90d88a86c692377d18d8bd64b39c1fb2b92cb31370e2896bbd", size = 64065, upload-time = "2026-03-09T13:13:50.562Z" },
-    { url = "https://files.pythonhosted.org/packages/2b/0a/7b98e1e119878a27ba8618ca1e18b14f992ff1eda40f47bccccf4de44121/kiwisolver-1.5.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:332b4f0145c30b5f5ad9374881133e5aa64320428a57c2c2b61e9d891a51c2f3", size = 1477903, upload-time = "2026-03-09T13:13:52.084Z" },
-    { url = "https://files.pythonhosted.org/packages/18/d8/55638d89ffd27799d5cc3d8aa28e12f4ce7a64d67b285114dbedc8ea4136/kiwisolver-1.5.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0c50b89ffd3e1a911c69a1dd3de7173c0cd10b130f56222e57898683841e4f96", size = 1278751, upload-time = "2026-03-09T13:13:54.673Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/97/b4c8d0d18421ecceba20ad8701358453b88e32414e6f6950b5a4bad54e65/kiwisolver-1.5.0-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:4db576bb8c3ef9365f8b40fe0f671644de6736ae2c27a2c62d7d8a1b4329f099", size = 1296793, upload-time = "2026-03-09T13:13:56.287Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/10/f862f94b6389d8957448ec9df59450b81bec4abb318805375c401a1e6892/kiwisolver-1.5.0-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:0b85aad90cea8ac6797a53b5d5f2e967334fa4d1149f031c4537569972596cb8", size = 1346041, upload-time = "2026-03-09T13:13:58.269Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/6a/f1650af35821eaf09de398ec0bc2aefc8f211f0cda50204c9f1673741ba9/kiwisolver-1.5.0-cp313-cp313-manylinux_2_39_riscv64.whl", hash = "sha256:d36ca54cb4c6c4686f7cbb7b817f66f5911c12ddb519450bbe86707155028f87", size = 987292, upload-time = "2026-03-09T13:13:59.871Z" },
-    { url = "https://files.pythonhosted.org/packages/de/19/d7fb82984b9238115fe629c915007be608ebd23dc8629703d917dbfaffd4/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:38f4a703656f493b0ad185211ccfca7f0386120f022066b018eb5296d8613e23", size = 2227865, upload-time = "2026-03-09T13:14:01.401Z" },
-    { url = "https://files.pythonhosted.org/packages/7f/b9/46b7f386589fd222dac9e9de9c956ce5bcefe2ee73b4e79891381dda8654/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:3ac2360e93cb41be81121755c6462cff3beaa9967188c866e5fce5cf13170859", size = 2324369, upload-time = "2026-03-09T13:14:02.972Z" },
-    { url = "https://files.pythonhosted.org/packages/92/8b/95e237cf3d9c642960153c769ddcbe278f182c8affb20cecc1cc983e7cc5/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c95cab08d1965db3d84a121f1c7ce7479bdd4072c9b3dafd8fecce48a2e6b902", size = 1977989, upload-time = "2026-03-09T13:14:04.503Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/95/980c9df53501892784997820136c01f62bc1865e31b82b9560f980c0e649/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:fc20894c3d21194d8041a28b65622d5b86db786da6e3cfe73f0c762951a61167", size = 2491645, upload-time = "2026-03-09T13:14:06.106Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/32/900647fd0840abebe1561792c6b31e6a7c0e278fc3973d30572a965ca14c/kiwisolver-1.5.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:7a32f72973f0f950c1920475d5c5ea3d971b81b6f0ec53b8d0a956cc965f22e0", size = 2295237, upload-time = "2026-03-09T13:14:08.891Z" },
-    { url = "https://files.pythonhosted.org/packages/be/8a/be60e3bbcf513cc5a50f4a3e88e1dcecebb79c1ad607a7222877becaa101/kiwisolver-1.5.0-cp313-cp313-win_amd64.whl", hash = "sha256:0bf3acf1419fa93064a4c2189ac0b58e3be7872bf6ee6177b0d4c63dc4cea276", size = 73573, upload-time = "2026-03-09T13:14:12.327Z" },
-    { url = "https://files.pythonhosted.org/packages/4d/d2/64be2e429eb4fca7f7e1c52a91b12663aeaf25de3895e5cca0f47ef2a8d0/kiwisolver-1.5.0-cp313-cp313-win_arm64.whl", hash = "sha256:fa8eb9ecdb7efb0b226acec134e0d709e87a909fa4971a54c0c4f6e88635484c", size = 64998, upload-time = "2026-03-09T13:14:13.469Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/69/ce68dd0c85755ae2de490bf015b62f2cea5f6b14ff00a463f9d0774449ff/kiwisolver-1.5.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:db485b3847d182b908b483b2ed133c66d88d49cacf98fd278fadafe11b4478d1", size = 125700, upload-time = "2026-03-09T13:14:14.636Z" },
-    { url = "https://files.pythonhosted.org/packages/74/aa/937aac021cf9d4349990d47eb319309a51355ed1dbdc9c077cdc9224cb11/kiwisolver-1.5.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:be12f931839a3bdfe28b584db0e640a65a8bcbc24560ae3fdb025a449b3d754e", size = 67537, upload-time = "2026-03-09T13:14:15.808Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/20/3a87fbece2c40ad0f6f0aefa93542559159c5f99831d596050e8afae7a9f/kiwisolver-1.5.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:16b85d37c2cbb3253226d26e64663f755d88a03439a9c47df6246b35defbdfb7", size = 65514, upload-time = "2026-03-09T13:14:18.035Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/7f/f943879cda9007c45e1f7dba216d705c3a18d6b35830e488b6c6a4e7cdf0/kiwisolver-1.5.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4432b835675f0ea7414aab3d37d119f7226d24869b7a829caeab49ebda407b0c", size = 1584848, upload-time = "2026-03-09T13:14:19.745Z" },
-    { url = "https://files.pythonhosted.org/packages/37/f8/4d4f85cc1870c127c88d950913370dd76138482161cd07eabbc450deff01/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b0feb50971481a2cc44d94e88bdb02cdd497618252ae226b8eb1201b957e368", size = 1391542, upload-time = "2026-03-09T13:14:21.54Z" },
-    { url = "https://files.pythonhosted.org/packages/04/0b/65dd2916c84d252b244bd405303220f729e7c17c9d7d33dca6feeff9ffc4/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:56fa888f10d0f367155e76ce849fa1166fc9730d13bd2d65a2aa13b6f5424489", size = 1404447, upload-time = "2026-03-09T13:14:23.205Z" },
-    { url = "https://files.pythonhosted.org/packages/39/5c/2606a373247babce9b1d056c03a04b65f3cf5290a8eac5d7bdead0a17e21/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:940dda65d5e764406b9fb92761cbf462e4e63f712ab60ed98f70552e496f3bf1", size = 1455918, upload-time = "2026-03-09T13:14:24.74Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/d1/c6078b5756670658e9192a2ef11e939c92918833d2745f85cd14a6004bdf/kiwisolver-1.5.0-cp313-cp313t-manylinux_2_39_riscv64.whl", hash = "sha256:89fc958c702ee9a745e4700378f5d23fddbc46ff89e8fdbf5395c24d5c1452a3", size = 1072856, upload-time = "2026-03-09T13:14:26.597Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/c8/7def6ddf16eb2b3741d8b172bdaa9af882b03c78e9b0772975408801fa63/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9027d773c4ff81487181a925945743413f6069634d0b122d0b37684ccf4f1e18", size = 2333580, upload-time = "2026-03-09T13:14:28.237Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/87/2ac1fce0eb1e616fcd3c35caa23e665e9b1948bb984f4764790924594128/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:5b233ea3e165e43e35dba1d2b8ecc21cf070b45b65ae17dd2747d2713d942021", size = 2423018, upload-time = "2026-03-09T13:14:30.018Z" },
-    { url = "https://files.pythonhosted.org/packages/67/13/c6700ccc6cc218716bfcda4935e4b2997039869b4ad8a94f364c5a3b8e63/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:ce9bf03dad3b46408c08649c6fbd6ca28a9fce0eb32fdfffa6775a13103b5310", size = 2062804, upload-time = "2026-03-09T13:14:32.888Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/bd/877056304626943ff0f1f44c08f584300c199b887cb3176cd7e34f1515f1/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:fc4d3f1fb9ca0ae9f97b095963bc6326f1dbfd3779d6679a1e016b9baaa153d3", size = 2597482, upload-time = "2026-03-09T13:14:34.971Z" },
-    { url = "https://files.pythonhosted.org/packages/75/19/c60626c47bf0f8ac5dcf72c6c98e266d714f2fbbfd50cf6dab5ede3aaa50/kiwisolver-1.5.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:f443b4825c50a51ee68585522ab4a1d1257fac65896f282b4c6763337ac9f5d2", size = 2394328, upload-time = "2026-03-09T13:14:36.816Z" },
-    { url = "https://files.pythonhosted.org/packages/47/84/6a6d5e5bb8273756c27b7d810d47f7ef2f1f9b9fd23c9ee9a3f8c75c9cef/kiwisolver-1.5.0-cp313-cp313t-win_arm64.whl", hash = "sha256:893ff3a711d1b515ba9da14ee090519bad4610ed1962fbe298a434e8c5f8db53", size = 68410, upload-time = "2026-03-09T13:14:38.695Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/d7/060f45052f2a01ad5762c8fdecd6d7a752b43400dc29ff75cd47225a40fd/kiwisolver-1.5.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8df31fe574b8b3993cc61764f40941111b25c2d9fea13d3ce24a49907cd2d615", size = 123231, upload-time = "2026-03-09T13:14:41.323Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/a7/78da680eadd06ff35edef6ef68a1ad273bad3e2a0936c9a885103230aece/kiwisolver-1.5.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:1d49a49ac4cbfb7c1375301cd1ec90169dfeae55ff84710d782260ce77a75a02", size = 66489, upload-time = "2026-03-09T13:14:42.534Z" },
-    { url = "https://files.pythonhosted.org/packages/49/b2/97980f3ad4fae37dd7fe31626e2bf75fbf8bdf5d303950ec1fab39a12da8/kiwisolver-1.5.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0cbe94b69b819209a62cb27bdfa5dc2a8977d8de2f89dfd97ba4f53ed3af754e", size = 64063, upload-time = "2026-03-09T13:14:44.759Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/f9/b06c934a6aa8bc91f566bd2a214fd04c30506c2d9e2b6b171953216a65b6/kiwisolver-1.5.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:80aa065ffd378ff784822a6d7c3212f2d5f5e9c3589614b5c228b311fd3063ac", size = 1475913, upload-time = "2026-03-09T13:14:46.247Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/f0/f768ae564a710135630672981231320bc403cf9152b5596ec5289de0f106/kiwisolver-1.5.0-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e7f886f47ab881692f278ae901039a234e4025a68e6dfab514263a0b1c4ae05", size = 1282782, upload-time = "2026-03-09T13:14:48.458Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/9f/1de7aad00697325f05238a5f2eafbd487fb637cc27a558b5367a5f37fb7f/kiwisolver-1.5.0-cp314-cp314-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5060731cc3ed12ca3a8b57acd4aeca5bbc2f49216dd0bec1650a1acd89486bcd", size = 1300815, upload-time = "2026-03-09T13:14:50.721Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/c2/297f25141d2e468e0ce7f7a7b92e0cf8918143a0cbd3422c1ad627e85a06/kiwisolver-1.5.0-cp314-cp314-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:7a4aa69609f40fce3cbc3f87b2061f042eee32f94b8f11db707b66a26461591a", size = 1347925, upload-time = "2026-03-09T13:14:52.304Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/d3/f4c73a02eb41520c47610207b21afa8cdd18fdbf64ffd94674ae21c4812d/kiwisolver-1.5.0-cp314-cp314-manylinux_2_39_riscv64.whl", hash = "sha256:d168fda2dbff7b9b5f38e693182d792a938c31db4dac3a80a4888de603c99554", size = 991322, upload-time = "2026-03-09T13:14:54.637Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/46/d3f2efef7732fcda98d22bf4ad5d3d71d545167a852ca710a494f4c15343/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:413b820229730d358efd838ecbab79902fe97094565fdc80ddb6b0a18c18a581", size = 2232857, upload-time = "2026-03-09T13:14:56.471Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/ec/2d9756bf2b6d26ae4349b8d3662fb3993f16d80c1f971c179ce862b9dbae/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:5124d1ea754509b09e53738ec185584cc609aae4a3b510aaf4ed6aa047ef9303", size = 2329376, upload-time = "2026-03-09T13:14:58.072Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/9f/876a0a0f2260f1bde92e002b3019a5fabc35e0939c7d945e0fa66185eb20/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e4415a8db000bf49a6dd1c478bf70062eaacff0f462b92b0ba68791a905861f9", size = 1982549, upload-time = "2026-03-09T13:14:59.668Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/4f/ba3624dfac23a64d54ac4179832860cb537c1b0af06024936e82ca4154a0/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:d618fd27420381a4f6044faa71f46d8bfd911bd077c555f7138ed88729bfbe79", size = 2494680, upload-time = "2026-03-09T13:15:01.364Z" },
-    { url = "https://files.pythonhosted.org/packages/39/b7/97716b190ab98911b20d10bf92eca469121ec483b8ce0edd314f51bc85af/kiwisolver-1.5.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5092eb5b1172947f57d6ea7d89b2f29650414e4293c47707eb499ec07a0ac796", size = 2297905, upload-time = "2026-03-09T13:15:03.925Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/36/4e551e8aa55c9188bca9abb5096805edbf7431072b76e2298e34fd3a3008/kiwisolver-1.5.0-cp314-cp314-win_amd64.whl", hash = "sha256:d76e2d8c75051d58177e762164d2e9ab92886534e3a12e795f103524f221dd8e", size = 75086, upload-time = "2026-03-09T13:15:07.775Z" },
-    { url = "https://files.pythonhosted.org/packages/70/15/9b90f7df0e31a003c71649cf66ef61c3c1b862f48c81007fa2383c8bd8d7/kiwisolver-1.5.0-cp314-cp314-win_arm64.whl", hash = "sha256:fa6248cd194edff41d7ea9425ced8ca3a6f838bfb295f6f1d6e6bb694a8518df", size = 66577, upload-time = "2026-03-09T13:15:09.139Z" },
-    { url = "https://files.pythonhosted.org/packages/17/01/7dc8c5443ff42b38e72731643ed7cf1ed9bf01691ae5cdca98501999ed83/kiwisolver-1.5.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:d1ffeb80b5676463d7a7d56acbe8e37a20ce725570e09549fe738e02ca6b7e1e", size = 125794, upload-time = "2026-03-09T13:15:10.525Z" },
-    { url = "https://files.pythonhosted.org/packages/46/8a/b4ebe46ebaac6a303417fab10c2e165c557ddaff558f9699d302b256bc53/kiwisolver-1.5.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:bc4d8e252f532ab46a1de9349e2d27b91fce46736a9eedaa37beaca66f574ed4", size = 67646, upload-time = "2026-03-09T13:15:12.016Z" },
-    { url = "https://files.pythonhosted.org/packages/60/35/10a844afc5f19d6f567359bf4789e26661755a2f36200d5d1ed8ad0126e5/kiwisolver-1.5.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:6783e069732715ad0c3ce96dbf21dbc2235ab0593f2baf6338101f70371f4028", size = 65511, upload-time = "2026-03-09T13:15:13.311Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/8a/685b297052dd041dcebce8e8787b58923b6e78acc6115a0dc9189011c44b/kiwisolver-1.5.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:e7c4c09a490dc4d4a7f8cbee56c606a320f9dc28cf92a7157a39d1ce7676a657", size = 1584858, upload-time = "2026-03-09T13:15:15.103Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/80/04865e3d4638ac5bddec28908916df4a3075b8c6cc101786a96803188b96/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2a075bd7bd19c70cf67c8badfa36cf7c5d8de3c9ddb8420c51e10d9c50e94920", size = 1392539, upload-time = "2026-03-09T13:15:16.661Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/01/77a19cacc0893fa13fafa46d1bba06fb4dc2360b3292baf4b56d8e067b24/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:bdd3e53429ff02aa319ba59dfe4ceeec345bf46cf180ec2cf6fd5b942e7975e9", size = 1405310, upload-time = "2026-03-09T13:15:18.229Z" },
-    { url = "https://files.pythonhosted.org/packages/53/39/bcaf5d0cca50e604cfa9b4e3ae1d64b50ca1ae5b754122396084599ef903/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:3cdcb35dc9d807259c981a85531048ede628eabcffb3239adf3d17463518992d", size = 1456244, upload-time = "2026-03-09T13:15:20.444Z" },
-    { url = "https://files.pythonhosted.org/packages/d0/7a/72c187abc6975f6978c3e39b7cf67aeb8b3c0a8f9790aa7fd412855e9e1f/kiwisolver-1.5.0-cp314-cp314t-manylinux_2_39_riscv64.whl", hash = "sha256:70d593af6a6ca332d1df73d519fddb5148edb15cd90d5f0155e3746a6d4fcc65", size = 1073154, upload-time = "2026-03-09T13:15:22.039Z" },
-    { url = "https://files.pythonhosted.org/packages/c7/ca/cf5b25783ebbd59143b4371ed0c8428a278abe68d6d0104b01865b1bbd0f/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:377815a8616074cabbf3f53354e1d040c35815a134e01d7614b7692e4bf8acfa", size = 2334377, upload-time = "2026-03-09T13:15:23.741Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/e5/b1f492adc516796e88751282276745340e2a72dcd0d36cf7173e0daf3210/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:0255a027391d52944eae1dbb5d4cc5903f57092f3674e8e544cdd2622826b3f0", size = 2425288, upload-time = "2026-03-09T13:15:25.789Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/e5/9b21fbe91a61b8f409d74a26498706e97a48008bfcd1864373d32a6ba31c/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:012b1eb16e28718fa782b5e61dc6f2da1f0792ca73bd05d54de6cb9561665fc9", size = 2063158, upload-time = "2026-03-09T13:15:27.63Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/02/83f47986138310f95ea95531f851b2a62227c11cbc3e690ae1374fe49f0f/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:0e3aafb33aed7479377e5e9a82e9d4bf87063741fc99fc7ae48b0f16e32bdd6f", size = 2597260, upload-time = "2026-03-09T13:15:29.421Z" },
-    { url = "https://files.pythonhosted.org/packages/07/18/43a5f24608d8c313dd189cf838c8e68d75b115567c6279de7796197cfb6a/kiwisolver-1.5.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:e7a116ae737f0000343218c4edf5bd45893bfeaff0993c0b215d7124c9f77646", size = 2394403, upload-time = "2026-03-09T13:15:31.517Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/b5/98222136d839b8afabcaa943b09bd05888c2d36355b7e448550211d1fca4/kiwisolver-1.5.0-cp314-cp314t-win_amd64.whl", hash = "sha256:1dd9b0b119a350976a6d781e7278ec7aca0b201e1a9e2d23d9804afecb6ca681", size = 79687, upload-time = "2026-03-09T13:15:33.204Z" },
-    { url = "https://files.pythonhosted.org/packages/99/a2/ca7dc962848040befed12732dff6acae7fb3c4f6fc4272b3f6c9a30b8713/kiwisolver-1.5.0-cp314-cp314t-win_arm64.whl", hash = "sha256:58f812017cd2985c21fbffb4864d59174d4903dd66fa23815e74bbc7a0e2dd57", size = 70032, upload-time = "2026-03-09T13:15:34.411Z" },
     { url = "https://files.pythonhosted.org/packages/1c/fa/2910df836372d8761bb6eff7d8bdcb1613b5c2e03f260efe7abe34d388a7/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-macosx_10_13_x86_64.whl", hash = "sha256:5ae8e62c147495b01a0f4765c878e9bfdf843412446a247e28df59936e99e797", size = 130262, upload-time = "2026-03-09T13:15:35.629Z" },
     { url = "https://files.pythonhosted.org/packages/0f/41/c5f71f9f00aabcc71fee8b7475e3f64747282580c2fe748961ba29b18385/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:f6764a4ccab3078db14a632420930f6186058750df066b8ea2a7106df91d3203", size = 138036, upload-time = "2026-03-09T13:15:36.894Z" },
     { url = "https://files.pythonhosted.org/packages/fa/06/7399a607f434119c6e1fdc8ec89a8d51ccccadf3341dee4ead6bd14caaf5/kiwisolver-1.5.0-graalpy312-graalpy250_312_native-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c31c13da98624f957b0fb1b5bae5383b2333c2c3f6793d9825dd5ce79b525cb7", size = 194295, upload-time = "2026-03-09T13:15:38.22Z" },
@@ -1418,50 +1031,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540, upload-time = "2025-09-27T18:36:38.761Z" },
     { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105, upload-time = "2025-09-27T18:36:39.701Z" },
     { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906, upload-time = "2025-09-27T18:36:40.689Z" },
-    { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" },
-    { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" },
-    { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" },
-    { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" },
-    { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" },
-    { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" },
-    { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" },
-    { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" },
-    { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" },
-    { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" },
-    { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" },
-    { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619, upload-time = "2025-09-27T18:37:06.342Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029, upload-time = "2025-09-27T18:37:07.213Z" },
-    { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408, upload-time = "2025-09-27T18:37:09.572Z" },
-    { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005, upload-time = "2025-09-27T18:37:10.58Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048, upload-time = "2025-09-27T18:37:11.547Z" },
-    { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821, upload-time = "2025-09-27T18:37:12.48Z" },
-    { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606, upload-time = "2025-09-27T18:37:13.485Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043, upload-time = "2025-09-27T18:37:14.408Z" },
-    { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747, upload-time = "2025-09-27T18:37:15.36Z" },
-    { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341, upload-time = "2025-09-27T18:37:16.496Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073, upload-time = "2025-09-27T18:37:17.476Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661, upload-time = "2025-09-27T18:37:18.453Z" },
-    { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069, upload-time = "2025-09-27T18:37:19.332Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670, upload-time = "2025-09-27T18:37:20.245Z" },
-    { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598, upload-time = "2025-09-27T18:37:21.177Z" },
-    { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261, upload-time = "2025-09-27T18:37:22.167Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835, upload-time = "2025-09-27T18:37:23.296Z" },
-    { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733, upload-time = "2025-09-27T18:37:24.237Z" },
-    { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672, upload-time = "2025-09-27T18:37:25.271Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819, upload-time = "2025-09-27T18:37:26.285Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426, upload-time = "2025-09-27T18:37:27.316Z" },
-    { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146, upload-time = "2025-09-27T18:37:28.327Z" },
 ]
 
 [[package]]
@@ -1469,13 +1038,12 @@ name = "matplotlib"
 version = "3.10.9"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "contourpy", version = "1.3.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "contourpy", version = "1.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "contourpy", version = "1.3.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "contourpy", version = "1.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "cycler" },
     { name = "fonttools" },
     { name = "kiwisolver" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
     { name = "packaging" },
     { name = "pillow" },
     { name = "pyparsing" },
@@ -1503,34 +1071,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/fc/c2/541e4d09d87bb6b5830fc28b4c887a9a8cf4e1c6cee698a8c05552ae2003/matplotlib-3.10.9-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:d75d11c949914165976c621b2324f9ef162af7ebf4b057ddf95dd1dba7e5edcf", size = 9670966, upload-time = "2026-04-24T00:12:32.131Z" },
     { url = "https://files.pythonhosted.org/packages/04/a1/4571fc46e7702de8d0c2dc54ad1b2f8e29328dea3ee90831181f7353d93c/matplotlib-3.10.9-cp312-cp312-win_amd64.whl", hash = "sha256:d091f9d758b34aaaaa6331d13574bf01891d903b3dec59bfff458ef7551de5d6", size = 8217462, upload-time = "2026-04-24T00:12:35.226Z" },
     { url = "https://files.pythonhosted.org/packages/4b/d0/2269edb12aa30c13c8bcc9382892e39943ce1d28aab4ec296e0381798e81/matplotlib-3.10.9-cp312-cp312-win_arm64.whl", hash = "sha256:10cc5ce06d10231c36f40e875f3c7e8050362a4ee8f0ee5d29a6b3277d57bb42", size = 8136688, upload-time = "2026-04-24T00:12:37.442Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/d3/8d4f6afbecb49fc04e060a57c0fce39ea51cc163a6bd87303ccd698e4fa6/matplotlib-3.10.9-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:b580440f1ff81a0e34122051a3dfabb7e4b7f9e380629929bde0eff9af72165f", size = 8320331, upload-time = "2026-04-24T00:12:39.688Z" },
-    { url = "https://files.pythonhosted.org/packages/63/d9/9e14bc7564bf92d5ffa801ae5fac819ce74b925dfb55e3ebde61a3bbad3e/matplotlib-3.10.9-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:b1b745c489cd1a77a0dc1120a05dc87af9798faebc913601feb8c73d89bf2d1e", size = 8216461, upload-time = "2026-04-24T00:12:42.494Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/17/4402d0d14ccf1dfc70932600b68097fbbf9c898a4871d2cbbe79c7801a32/matplotlib-3.10.9-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8f3bcac1ca5ed000a6f4337d47ba67dfddf37ed6a46c15fd7f014997f7bf865f", size = 8790091, upload-time = "2026-04-24T00:12:44.789Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/0b/322aeec06dd9b91411f92028b37d447342770a24392aa4813e317064dad5/matplotlib-3.10.9-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7a8d66a55def891c33147ba3ba9bfcabf0b526a43764c818acbb4525e5ed0838", size = 9605027, upload-time = "2026-04-24T00:12:47.583Z" },
-    { url = "https://files.pythonhosted.org/packages/74/88/5f13482f55e7b00bcfc09838b093c2456e1379978d2a146844aae05350ad/matplotlib-3.10.9-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:d843374407c4017a6403b59c6c81606773d136f3259d5b6da3131bc814542cc2", size = 9671269, upload-time = "2026-04-24T00:12:50.878Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/e0/0840fd2f93da988ec660b8ad1984abe9f25d2aed22a5e394ff1c68c88307/matplotlib-3.10.9-cp313-cp313-win_amd64.whl", hash = "sha256:f4399f64b3e94cd500195490972ae1ee81170df1636fa15364d157d5bdd7b921", size = 8217588, upload-time = "2026-04-24T00:12:53.784Z" },
-    { url = "https://files.pythonhosted.org/packages/47/b9/d706d06dd605c49b9f83a2aed8c13e3e5db70697d7a80b7e3d7915de6b17/matplotlib-3.10.9-cp313-cp313-win_arm64.whl", hash = "sha256:ba7b3b8ef09eab7df0e86e9ae086faa433efbfbdb46afcb3aa16aabf779469a8", size = 8136913, upload-time = "2026-04-24T00:12:56.501Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/45/6e32d96978264c8ca8c4b1010adb955a1a49cfaf314e212bbc8908f04a61/matplotlib-3.10.9-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:09218df8a93712bd6ea133e83a153c755448cf7868316c531cffcc43f69d1cc9", size = 8368019, upload-time = "2026-04-24T00:12:58.896Z" },
-    { url = "https://files.pythonhosted.org/packages/86/0a/c8e3d3bba245f0f7fc424937f8ff7ef77291a36af3edb97ccd78aa93d84f/matplotlib-3.10.9-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:82368699727bfb7b0182e1aa13082e3c08e092fa1a25d3e1fd92405bff96f6d4", size = 8264645, upload-time = "2026-04-24T00:13:01.406Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/aa/5bf5a14fe4fed73a4209a155606f8096ff797aad89c6c35179026571133e/matplotlib-3.10.9-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3225f4e1edcb8c86c884ddf79ebe20ecd0a67d30188f279897554ccd8fded4dc", size = 8802194, upload-time = "2026-04-24T00:13:03.702Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/5e/b4be852d6bba6fd15893fadf91ff26ae49cb91aac789e95dde9d342e664f/matplotlib-3.10.9-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:de2445a0c6690d21b7eb6ce071cebad6d40a2e9bdf10d039074a96ba19797b99", size = 9622684, upload-time = "2026-04-24T00:13:06.647Z" },
-    { url = "https://files.pythonhosted.org/packages/4c/3d/ed428c971139112ef730f62770654d609467346d09d4b62617e1afd68a5a/matplotlib-3.10.9-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:b2b9516251cb89ff618d757daec0e2ed1bf21248013844a853d87ef85ab3081d", size = 9680790, upload-time = "2026-04-24T00:13:10.009Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/09/052e884aaf2b985c63cb79f715f1d5b6a3eaa7de78f6a52b9dbc077d5b53/matplotlib-3.10.9-cp313-cp313t-win_amd64.whl", hash = "sha256:e9fae004b941b23ff2edcf1567a857ed77bafc8086ffa258190462328434faf8", size = 8287571, upload-time = "2026-04-24T00:13:13.087Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/38/ae27288e788c35a4250491422f3db7750366fc8c97d6f36fbdecfc1f5518/matplotlib-3.10.9-cp313-cp313t-win_arm64.whl", hash = "sha256:6b63d9c7c769b88ab81e10dc86e4e0607cf56817b9f9e6cf24b2a5f1693b8e38", size = 8188292, upload-time = "2026-04-24T00:13:15.546Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/e6/3bd8afd04949f02eabc1c17115ea5255e19cacd4d06fc5abdde4eeb0052c/matplotlib-3.10.9-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:172db52c9e683f5d12eaf57f0f54834190e12581fe1cc2a19595a8f5acb4e77d", size = 8321276, upload-time = "2026-04-24T00:13:18.318Z" },
-    { url = "https://files.pythonhosted.org/packages/41/86/86231232fff41c9f8e4a1a7d7a597d349a02527109c3af7d618366122139/matplotlib-3.10.9-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:97e35e8d39ccc85859095e01a53847432ba9a53ddf7986f7a54a11b73d0e143f", size = 8218218, upload-time = "2026-04-24T00:13:20.974Z" },
-    { url = "https://files.pythonhosted.org/packages/85/8f/becc9722cafc64f5d2eb0b7c1bf5f585271c618a45dbd8fabeb021f898b6/matplotlib-3.10.9-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:aba1615dabe83188e19d4f75a253c6a08423e04c1425e64039f800050a69de6b", size = 9608145, upload-time = "2026-04-24T00:13:23.228Z" },
-    { url = "https://files.pythonhosted.org/packages/32/5d/f7e914f7d9325abff4057cee62c0fa70263683189f774473cbfb534cd13b/matplotlib-3.10.9-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34cf8167e023ad956c15f36302911d5406bd99a9862c1a8499ea6f7c0e015dc2", size = 9885085, upload-time = "2026-04-24T00:13:25.849Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/fd/fa69f2221534e80cc5772ac2b7d222011a2acafc2ec7216d5dd174c864ae/matplotlib-3.10.9-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:59476c6d29d612b8e9bb6ce8c5b631be6ba8f9e3a2421f22a02b192c7dd28716", size = 9672358, upload-time = "2026-04-24T00:13:28.906Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/1a/5a4f747a8b271cbb024946d2dd3c913ab5032ba430626f8c3528ada96b4b/matplotlib-3.10.9-cp314-cp314-win_amd64.whl", hash = "sha256:336b9acc64d309063126edcdaca00db9373af3c476bb94388fe9c5a53ad13e6f", size = 8349970, upload-time = "2026-04-24T00:13:31.904Z" },
-    { url = "https://files.pythonhosted.org/packages/64/dc/95d60ecaefe30680a154b52ea96ab4b0dab547f1fd6aa12f5fb655e89cae/matplotlib-3.10.9-cp314-cp314-win_arm64.whl", hash = "sha256:2dc9477819ffd78ad12a20df1d9d6a6bd4fec6aaa9072681465fddca052f1456", size = 8272785, upload-time = "2026-04-24T00:13:34.511Z" },
-    { url = "https://files.pythonhosted.org/packages/70/a0/005d68bc8b8418300ce6591f18586910a8526806e2ab663933d9f20a41e9/matplotlib-3.10.9-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:da4e09638420548f31c354032a6250e473c68e5a4e96899b4844cf39ddea23fe", size = 8367999, upload-time = "2026-04-24T00:13:36.962Z" },
-    { url = "https://files.pythonhosted.org/packages/22/05/1236cc9290be70b2498af20ca348add76e3fffe7f67b477db5133a84f3ea/matplotlib-3.10.9-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:345f6f68ecc8da0ca56fad2ea08fde1a115eda530079eca185d50a7bc3e146c6", size = 8264543, upload-time = "2026-04-24T00:13:39.851Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/c2/071f5a5ff6c5bd63aaaf2f45c811d9bf2ced94bde188d9e1a519e21d0cba/matplotlib-3.10.9-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4edcfbd8565339aa62f1cd4012f7180926fdbe71850f7b0d3c379c175cd6b66c", size = 9622800, upload-time = "2026-04-24T00:13:42.296Z" },
-    { url = "https://files.pythonhosted.org/packages/95/57/da7d1f10a85624b9e7db68e069dd94e58dc41dbf9463c5921632ecbe3661/matplotlib-3.10.9-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6be157fe17fc37cb95ac1d7374cf717ce9259616edec911a78d9d26dae8522d4", size = 9888561, upload-time = "2026-04-24T00:13:45.026Z" },
-    { url = "https://files.pythonhosted.org/packages/67/b2/ef8d6bb59b0edb6c16c968b70f548aa13b54348972def5aa6ac85df67145/matplotlib-3.10.9-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:4e42042d54db34fda4e95a7bd3e5789c2a995d2dad3eb8850232ee534092fbbf", size = 9680884, upload-time = "2026-04-24T00:13:48.066Z" },
-    { url = "https://files.pythonhosted.org/packages/61/1c/d21bfeb9931881ebe96bcfcff27c7ae4b160ae0ec291a714c42641a56d75/matplotlib-3.10.9-cp314-cp314t-win_amd64.whl", hash = "sha256:c27df8b3848f32a83d1767566595e43cfaa4460380974da06f4279a7ec143c39", size = 8432333, upload-time = "2026-04-24T00:13:51.008Z" },
-    { url = "https://files.pythonhosted.org/packages/78/23/92493c3e6e1b635ccfff146f7b99e674808787915420373ac399283764c2/matplotlib-3.10.9-cp314-cp314t-win_arm64.whl", hash = "sha256:a49f1eadc84ca85fd72fa4e89e70e61bf86452df6f971af04b12c60761a0772c", size = 8324785, upload-time = "2026-04-24T00:13:53.633Z" },
     { url = "https://files.pythonhosted.org/packages/2c/2b/0e92ad0ac446633f928a1563db4aa8add407e1924faf0ded5b95b35afb27/matplotlib-3.10.9-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:1872fb212a05b729e649754a72d5da61d03e0554d76e80303b6f83d1d2c0552b", size = 8293058, upload-time = "2026-04-24T00:13:56.339Z" },
     { url = "https://files.pythonhosted.org/packages/4b/23/74682fd369f5299ceda438fea2a0662e6383b85c9383fb9cdfcf04713e07/matplotlib-3.10.9-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:985f2238880e2e69093f588f5fe2e46771747febf0649f3cf7f7b7480875317f", size = 8186627, upload-time = "2026-04-24T00:13:58.623Z" },
     { url = "https://files.pythonhosted.org/packages/ca/e8/368aab88f3c4cd8992800f31abfe0670c3e47540ba20a97e9fdbcde594b3/matplotlib-3.10.9-pp310-pypy310_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:6640f75af2c6148293caa0a2b39dd806a492dd66c8a8b04035813e33d0fd2585", size = 8764117, upload-time = "2026-04-24T00:14:01.684Z" },
@@ -1580,33 +1120,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/41/0d/2ddfaa8b7e1cee6c490d46cb0a39742b19e2481600a7a0e96537e9c22f43/msgpack-1.1.2-cp312-cp312-win32.whl", hash = "sha256:1fff3d825d7859ac888b0fbda39a42d59193543920eda9d9bea44d958a878029", size = 65096, upload-time = "2025-10-08T09:15:11.11Z" },
     { url = "https://files.pythonhosted.org/packages/8c/ec/d431eb7941fb55a31dd6ca3404d41fbb52d99172df2e7707754488390910/msgpack-1.1.2-cp312-cp312-win_amd64.whl", hash = "sha256:1de460f0403172cff81169a30b9a92b260cb809c4cb7e2fc79ae8d0510c78b6b", size = 72708, upload-time = "2025-10-08T09:15:12.554Z" },
     { url = "https://files.pythonhosted.org/packages/c5/31/5b1a1f70eb0e87d1678e9624908f86317787b536060641d6798e3cf70ace/msgpack-1.1.2-cp312-cp312-win_arm64.whl", hash = "sha256:be5980f3ee0e6bd44f3a9e9dea01054f175b50c3e6cdb692bc9424c0bbb8bf69", size = 64119, upload-time = "2025-10-08T09:15:13.589Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/31/b46518ecc604d7edf3a4f94cb3bf021fc62aa301f0cb849936968164ef23/msgpack-1.1.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4efd7b5979ccb539c221a4c4e16aac1a533efc97f3b759bb5a5ac9f6d10383bf", size = 81212, upload-time = "2025-10-08T09:15:14.552Z" },
-    { url = "https://files.pythonhosted.org/packages/92/dc/c385f38f2c2433333345a82926c6bfa5ecfff3ef787201614317b58dd8be/msgpack-1.1.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:42eefe2c3e2af97ed470eec850facbe1b5ad1d6eacdbadc42ec98e7dcf68b4b7", size = 84315, upload-time = "2025-10-08T09:15:15.543Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/68/93180dce57f684a61a88a45ed13047558ded2be46f03acb8dec6d7c513af/msgpack-1.1.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1fdf7d83102bf09e7ce3357de96c59b627395352a4024f6e2458501f158bf999", size = 412721, upload-time = "2025-10-08T09:15:16.567Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/ba/459f18c16f2b3fc1a1ca871f72f07d70c07bf768ad0a507a698b8052ac58/msgpack-1.1.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fac4be746328f90caa3cd4bc67e6fe36ca2bf61d5c6eb6d895b6527e3f05071e", size = 424657, upload-time = "2025-10-08T09:15:17.825Z" },
-    { url = "https://files.pythonhosted.org/packages/38/f8/4398c46863b093252fe67368b44edc6c13b17f4e6b0e4929dbf0bdb13f23/msgpack-1.1.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:fffee09044073e69f2bad787071aeec727183e7580443dfeb8556cbf1978d162", size = 402668, upload-time = "2025-10-08T09:15:19.003Z" },
-    { url = "https://files.pythonhosted.org/packages/28/ce/698c1eff75626e4124b4d78e21cca0b4cc90043afb80a507626ea354ab52/msgpack-1.1.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:5928604de9b032bc17f5099496417f113c45bc6bc21b5c6920caf34b3c428794", size = 419040, upload-time = "2025-10-08T09:15:20.183Z" },
-    { url = "https://files.pythonhosted.org/packages/67/32/f3cd1667028424fa7001d82e10ee35386eea1408b93d399b09fb0aa7875f/msgpack-1.1.2-cp313-cp313-win32.whl", hash = "sha256:a7787d353595c7c7e145e2331abf8b7ff1e6673a6b974ded96e6d4ec09f00c8c", size = 65037, upload-time = "2025-10-08T09:15:21.416Z" },
-    { url = "https://files.pythonhosted.org/packages/74/07/1ed8277f8653c40ebc65985180b007879f6a836c525b3885dcc6448ae6cb/msgpack-1.1.2-cp313-cp313-win_amd64.whl", hash = "sha256:a465f0dceb8e13a487e54c07d04ae3ba131c7c5b95e2612596eafde1dccf64a9", size = 72631, upload-time = "2025-10-08T09:15:22.431Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/db/0314e4e2db56ebcf450f277904ffd84a7988b9e5da8d0d61ab2d057df2b6/msgpack-1.1.2-cp313-cp313-win_arm64.whl", hash = "sha256:e69b39f8c0aa5ec24b57737ebee40be647035158f14ed4b40e6f150077e21a84", size = 64118, upload-time = "2025-10-08T09:15:23.402Z" },
-    { url = "https://files.pythonhosted.org/packages/22/71/201105712d0a2ff07b7873ed3c220292fb2ea5120603c00c4b634bcdafb3/msgpack-1.1.2-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:e23ce8d5f7aa6ea6d2a2b326b4ba46c985dbb204523759984430db7114f8aa00", size = 81127, upload-time = "2025-10-08T09:15:24.408Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/9f/38ff9e57a2eade7bf9dfee5eae17f39fc0e998658050279cbb14d97d36d9/msgpack-1.1.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:6c15b7d74c939ebe620dd8e559384be806204d73b4f9356320632d783d1f7939", size = 84981, upload-time = "2025-10-08T09:15:25.812Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/a9/3536e385167b88c2cc8f4424c49e28d49a6fc35206d4a8060f136e71f94c/msgpack-1.1.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:99e2cb7b9031568a2a5c73aa077180f93dd2e95b4f8d3b8e14a73ae94a9e667e", size = 411885, upload-time = "2025-10-08T09:15:27.22Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/40/dc34d1a8d5f1e51fc64640b62b191684da52ca469da9cd74e84936ffa4a6/msgpack-1.1.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:180759d89a057eab503cf62eeec0aa61c4ea1200dee709f3a8e9397dbb3b6931", size = 419658, upload-time = "2025-10-08T09:15:28.4Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/ef/2b92e286366500a09a67e03496ee8b8ba00562797a52f3c117aa2b29514b/msgpack-1.1.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:04fb995247a6e83830b62f0b07bf36540c213f6eac8e851166d8d86d83cbd014", size = 403290, upload-time = "2025-10-08T09:15:29.764Z" },
-    { url = "https://files.pythonhosted.org/packages/78/90/e0ea7990abea5764e4655b8177aa7c63cdfa89945b6e7641055800f6c16b/msgpack-1.1.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:8e22ab046fa7ede9e36eeb4cfad44d46450f37bb05d5ec482b02868f451c95e2", size = 415234, upload-time = "2025-10-08T09:15:31.022Z" },
-    { url = "https://files.pythonhosted.org/packages/72/4e/9390aed5db983a2310818cd7d3ec0aecad45e1f7007e0cda79c79507bb0d/msgpack-1.1.2-cp314-cp314-win32.whl", hash = "sha256:80a0ff7d4abf5fecb995fcf235d4064b9a9a8a40a3ab80999e6ac1e30b702717", size = 66391, upload-time = "2025-10-08T09:15:32.265Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/f1/abd09c2ae91228c5f3998dbd7f41353def9eac64253de3c8105efa2082f7/msgpack-1.1.2-cp314-cp314-win_amd64.whl", hash = "sha256:9ade919fac6a3e7260b7f64cea89df6bec59104987cbea34d34a2fa15d74310b", size = 73787, upload-time = "2025-10-08T09:15:33.219Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/b0/9d9f667ab48b16ad4115c1935d94023b82b3198064cb84a123e97f7466c1/msgpack-1.1.2-cp314-cp314-win_arm64.whl", hash = "sha256:59415c6076b1e30e563eb732e23b994a61c159cec44deaf584e5cc1dd662f2af", size = 66453, upload-time = "2025-10-08T09:15:34.225Z" },
-    { url = "https://files.pythonhosted.org/packages/16/67/93f80545eb1792b61a217fa7f06d5e5cb9e0055bed867f43e2b8e012e137/msgpack-1.1.2-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:897c478140877e5307760b0ea66e0932738879e7aa68144d9b78ea4c8302a84a", size = 85264, upload-time = "2025-10-08T09:15:35.61Z" },
-    { url = "https://files.pythonhosted.org/packages/87/1c/33c8a24959cf193966ef11a6f6a2995a65eb066bd681fd085afd519a57ce/msgpack-1.1.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a668204fa43e6d02f89dbe79a30b0d67238d9ec4c5bd8a940fc3a004a47b721b", size = 89076, upload-time = "2025-10-08T09:15:36.619Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/6b/62e85ff7193663fbea5c0254ef32f0c77134b4059f8da89b958beb7696f3/msgpack-1.1.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5559d03930d3aa0f3aacb4c42c776af1a2ace2611871c84a75afe436695e6245", size = 435242, upload-time = "2025-10-08T09:15:37.647Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/47/5c74ecb4cc277cf09f64e913947871682ffa82b3b93c8dad68083112f412/msgpack-1.1.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:70c5a7a9fea7f036b716191c29047374c10721c389c21e9ffafad04df8c52c90", size = 432509, upload-time = "2025-10-08T09:15:38.794Z" },
-    { url = "https://files.pythonhosted.org/packages/24/a4/e98ccdb56dc4e98c929a3f150de1799831c0a800583cde9fa022fa90602d/msgpack-1.1.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:f2cb069d8b981abc72b41aea1c580ce92d57c673ec61af4c500153a626cb9e20", size = 415957, upload-time = "2025-10-08T09:15:40.238Z" },
-    { url = "https://files.pythonhosted.org/packages/da/28/6951f7fb67bc0a4e184a6b38ab71a92d9ba58080b27a77d3e2fb0be5998f/msgpack-1.1.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:d62ce1f483f355f61adb5433ebfd8868c5f078d1a52d042b0a998682b4fa8c27", size = 422910, upload-time = "2025-10-08T09:15:41.505Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/03/42106dcded51f0a0b5284d3ce30a671e7bd3f7318d122b2ead66ad289fed/msgpack-1.1.2-cp314-cp314t-win32.whl", hash = "sha256:1d1418482b1ee984625d88aa9585db570180c286d942da463533b238b98b812b", size = 75197, upload-time = "2025-10-08T09:15:42.954Z" },
-    { url = "https://files.pythonhosted.org/packages/15/86/d0071e94987f8db59d4eeb386ddc64d0bb9b10820a8d82bcd3e53eeb2da6/msgpack-1.1.2-cp314-cp314t-win_amd64.whl", hash = "sha256:5a46bf7e831d09470ad92dff02b8b1ac92175ca36b087f904a0519857c6be3ff", size = 85772, upload-time = "2025-10-08T09:15:43.954Z" },
-    { url = "https://files.pythonhosted.org/packages/81/f2/08ace4142eb281c12701fc3b93a10795e4d4dc7f753911d836675050f886/msgpack-1.1.2-cp314-cp314t-win_arm64.whl", hash = "sha256:d99ef64f349d5ec3293688e91486c5fdb925ed03807f64d98d205d2713c60b46", size = 70868, upload-time = "2025-10-08T09:15:44.959Z" },
 ]
 
 [[package]]
@@ -1615,8 +1128,7 @@ version = "0.4.8"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "msgpack" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/08/94/61e8aee142733ebfdc400a05bdac6e1763c4514bba3b42743d223f388450/msgpack-numpy-0.4.8.tar.gz", hash = "sha256:c667d3180513422f9c7545be5eec5d296dcbb357e06f72ed39cc683797556e69", size = 10923, upload-time = "2022-06-09T03:43:08.739Z" }
 wheels = [
@@ -1628,7 +1140,7 @@ name = "multidict"
 version = "6.7.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/1a/c2/c2d94cbe6ac1753f3fc980da97b3d930efe1da3af3c9f5125354436c073d/multidict-6.7.1.tar.gz", hash = "sha256:ec6652a1bee61c53a3e5776b6049172c53b6aaba34f18c9ad04f82712bac623d", size = 102010, upload-time = "2026-01-26T02:46:45.979Z" }
 wheels = [
@@ -1686,78 +1198,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ca/a4/840f5b97339e27846c46307f2530a2805d9d537d8b8bd416af031cad7fa0/multidict-6.7.1-cp312-cp312-win32.whl", hash = "sha256:28ca5ce2fd9716631133d0e9a9b9a745ad7f60bac2bccafb56aa380fc0b6c511", size = 41887, upload-time = "2026-01-26T02:44:14.245Z" },
     { url = "https://files.pythonhosted.org/packages/80/31/0b2517913687895f5904325c2069d6a3b78f66cc641a86a2baf75a05dcbb/multidict-6.7.1-cp312-cp312-win_amd64.whl", hash = "sha256:fcee94dfbd638784645b066074b338bc9cc155d4b4bffa4adce1615c5a426c19", size = 46053, upload-time = "2026-01-26T02:44:15.371Z" },
     { url = "https://files.pythonhosted.org/packages/0c/5b/aba28e4ee4006ae4c7df8d327d31025d760ffa992ea23812a601d226e682/multidict-6.7.1-cp312-cp312-win_arm64.whl", hash = "sha256:ba0a9fb644d0c1a2194cf7ffb043bd852cea63a57f66fbd33959f7dae18517bf", size = 43307, upload-time = "2026-01-26T02:44:16.852Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/22/929c141d6c0dba87d3e1d38fbdf1ba8baba86b7776469f2bc2d3227a1e67/multidict-6.7.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:2b41f5fed0ed563624f1c17630cb9941cf2309d4df00e494b551b5f3e3d67a23", size = 76174, upload-time = "2026-01-26T02:44:18.509Z" },
-    { url = "https://files.pythonhosted.org/packages/c7/75/bc704ae15fee974f8fccd871305e254754167dce5f9e42d88a2def741a1d/multidict-6.7.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:84e61e3af5463c19b67ced91f6c634effb89ef8bfc5ca0267f954451ed4bb6a2", size = 45116, upload-time = "2026-01-26T02:44:19.745Z" },
-    { url = "https://files.pythonhosted.org/packages/79/76/55cd7186f498ed080a18440c9013011eb548f77ae1b297206d030eb1180a/multidict-6.7.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:935434b9853c7c112eee7ac891bc4cb86455aa631269ae35442cb316790c1445", size = 43524, upload-time = "2026-01-26T02:44:21.571Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/3c/414842ef8d5a1628d68edee29ba0e5bcf235dbfb3ccd3ea303a7fe8c72ff/multidict-6.7.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:432feb25a1cb67fe82a9680b4d65fb542e4635cb3166cd9c01560651ad60f177", size = 249368, upload-time = "2026-01-26T02:44:22.803Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/32/befed7f74c458b4a525e60519fe8d87eef72bb1e99924fa2b0f9d97a221e/multidict-6.7.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e82d14e3c948952a1a85503817e038cba5905a3352de76b9a465075d072fba23", size = 256952, upload-time = "2026-01-26T02:44:24.306Z" },
-    { url = "https://files.pythonhosted.org/packages/03/d6/c878a44ba877f366630c860fdf74bfb203c33778f12b6ac274936853c451/multidict-6.7.1-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:4cfb48c6ea66c83bcaaf7e4dfa7ec1b6bbcf751b7db85a328902796dfde4c060", size = 240317, upload-time = "2026-01-26T02:44:25.772Z" },
-    { url = "https://files.pythonhosted.org/packages/68/49/57421b4d7ad2e9e60e25922b08ceb37e077b90444bde6ead629095327a6f/multidict-6.7.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1d540e51b7e8e170174555edecddbd5538105443754539193e3e1061864d444d", size = 267132, upload-time = "2026-01-26T02:44:27.648Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/fe/ec0edd52ddbcea2a2e89e174f0206444a61440b40f39704e64dc807a70bd/multidict-6.7.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:273d23f4b40f3dce4d6c8a821c741a86dec62cded82e1175ba3d99be128147ed", size = 268140, upload-time = "2026-01-26T02:44:29.588Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/73/6e1b01cbeb458807aa0831742232dbdd1fa92bfa33f52a3f176b4ff3dc11/multidict-6.7.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d624335fd4fa1c08a53f8b4be7676ebde19cd092b3895c421045ca87895b429", size = 254277, upload-time = "2026-01-26T02:44:30.902Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/b2/5fb8c124d7561a4974c342bc8c778b471ebbeb3cc17df696f034a7e9afe7/multidict-6.7.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:12fad252f8b267cc75b66e8fc51b3079604e8d43a75428ffe193cd9e2195dfd6", size = 252291, upload-time = "2026-01-26T02:44:32.31Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/96/51d4e4e06bcce92577fcd488e22600bd38e4fd59c20cb49434d054903bd2/multidict-6.7.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:03ede2a6ffbe8ef936b92cb4529f27f42be7f56afcdab5ab739cd5f27fb1cbf9", size = 250156, upload-time = "2026-01-26T02:44:33.734Z" },
-    { url = "https://files.pythonhosted.org/packages/db/6b/420e173eec5fba721a50e2a9f89eda89d9c98fded1124f8d5c675f7a0c0f/multidict-6.7.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:90efbcf47dbe33dcf643a1e400d67d59abeac5db07dc3f27d6bdeae497a2198c", size = 249742, upload-time = "2026-01-26T02:44:35.222Z" },
-    { url = "https://files.pythonhosted.org/packages/44/a3/ec5b5bd98f306bc2aa297b8c6f11a46714a56b1e6ef5ebda50a4f5d7c5fb/multidict-6.7.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:5c4b9bfc148f5a91be9244d6264c53035c8a0dcd2f51f1c3c6e30e30ebaa1c84", size = 262221, upload-time = "2026-01-26T02:44:36.604Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/f7/e8c0d0da0cd1e28d10e624604e1a36bcc3353aaebdfdc3a43c72bc683a12/multidict-6.7.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:401c5a650f3add2472d1d288c26deebc540f99e2fb83e9525007a74cd2116f1d", size = 258664, upload-time = "2026-01-26T02:44:38.008Z" },
-    { url = "https://files.pythonhosted.org/packages/52/da/151a44e8016dd33feed44f730bd856a66257c1ee7aed4f44b649fb7edeb3/multidict-6.7.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:97891f3b1b3ffbded884e2916cacf3c6fc87b66bb0dde46f7357404750559f33", size = 249490, upload-time = "2026-01-26T02:44:39.386Z" },
-    { url = "https://files.pythonhosted.org/packages/87/af/a3b86bf9630b732897f6fc3f4c4714b90aa4361983ccbdcd6c0339b21b0c/multidict-6.7.1-cp313-cp313-win32.whl", hash = "sha256:e1c5988359516095535c4301af38d8a8838534158f649c05dd1050222321bcb3", size = 41695, upload-time = "2026-01-26T02:44:41.318Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/35/e994121b0e90e46134673422dd564623f93304614f5d11886b1b3e06f503/multidict-6.7.1-cp313-cp313-win_amd64.whl", hash = "sha256:960c83bf01a95b12b08fd54324a4eb1d5b52c88932b5cba5d6e712bb3ed12eb5", size = 45884, upload-time = "2026-01-26T02:44:42.488Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/61/42d3e5dbf661242a69c97ea363f2d7b46c567da8eadef8890022be6e2ab0/multidict-6.7.1-cp313-cp313-win_arm64.whl", hash = "sha256:563fe25c678aaba333d5399408f5ec3c383ca5b663e7f774dd179a520b8144df", size = 43122, upload-time = "2026-01-26T02:44:43.664Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/b3/e6b21c6c4f314bb956016b0b3ef2162590a529b84cb831c257519e7fde44/multidict-6.7.1-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:c76c4bec1538375dad9d452d246ca5368ad6e1c9039dadcf007ae59c70619ea1", size = 83175, upload-time = "2026-01-26T02:44:44.894Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/76/23ecd2abfe0957b234f6c960f4ade497f55f2c16aeb684d4ecdbf1c95791/multidict-6.7.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:57b46b24b5d5ebcc978da4ec23a819a9402b4228b8a90d9c656422b4bdd8a963", size = 48460, upload-time = "2026-01-26T02:44:46.106Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/57/a0ed92b23f3a042c36bc4227b72b97eca803f5f1801c1ab77c8a212d455e/multidict-6.7.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:e954b24433c768ce78ab7929e84ccf3422e46deb45a4dc9f93438f8217fa2d34", size = 46930, upload-time = "2026-01-26T02:44:47.278Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/66/02ec7ace29162e447f6382c495dc95826bf931d3818799bbef11e8f7df1a/multidict-6.7.1-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3bd231490fa7217cc832528e1cd8752a96f0125ddd2b5749390f7c3ec8721b65", size = 242582, upload-time = "2026-01-26T02:44:48.604Z" },
-    { url = "https://files.pythonhosted.org/packages/58/18/64f5a795e7677670e872673aca234162514696274597b3708b2c0d276cce/multidict-6.7.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:253282d70d67885a15c8a7716f3a73edf2d635793ceda8173b9ecc21f2fb8292", size = 250031, upload-time = "2026-01-26T02:44:50.544Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/ed/e192291dbbe51a8290c5686f482084d31bcd9d09af24f63358c3d42fd284/multidict-6.7.1-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0b4c48648d7649c9335cf1927a8b87fa692de3dcb15faa676c6a6f1f1aabda43", size = 228596, upload-time = "2026-01-26T02:44:51.951Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/7e/3562a15a60cf747397e7f2180b0a11dc0c38d9175a650e75fa1b4d325e15/multidict-6.7.1-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:98bc624954ec4d2c7cb074b8eefc2b5d0ce7d482e410df446414355d158fe4ca", size = 257492, upload-time = "2026-01-26T02:44:53.902Z" },
-    { url = "https://files.pythonhosted.org/packages/24/02/7d0f9eae92b5249bb50ac1595b295f10e263dd0078ebb55115c31e0eaccd/multidict-6.7.1-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:1b99af4d9eec0b49927b4402bcbb58dea89d3e0db8806a4086117019939ad3dd", size = 255899, upload-time = "2026-01-26T02:44:55.316Z" },
-    { url = "https://files.pythonhosted.org/packages/00/e3/9b60ed9e23e64c73a5cde95269ef1330678e9c6e34dd4eb6b431b85b5a10/multidict-6.7.1-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6aac4f16b472d5b7dc6f66a0d49dd57b0e0902090be16594dc9ebfd3d17c47e7", size = 247970, upload-time = "2026-01-26T02:44:56.783Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/06/538e58a63ed5cfb0bd4517e346b91da32fde409d839720f664e9a4ae4f9d/multidict-6.7.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:21f830fe223215dffd51f538e78c172ed7c7f60c9b96a2bf05c4848ad49921c3", size = 245060, upload-time = "2026-01-26T02:44:58.195Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/2f/d743a3045a97c895d401e9bd29aaa09b94f5cbdf1bd561609e5a6c431c70/multidict-6.7.1-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:f5dd81c45b05518b9aa4da4aa74e1c93d715efa234fd3e8a179df611cc85e5f4", size = 235888, upload-time = "2026-01-26T02:44:59.57Z" },
-    { url = "https://files.pythonhosted.org/packages/38/83/5a325cac191ab28b63c52f14f1131f3b0a55ba3b9aa65a6d0bf2a9b921a0/multidict-6.7.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:eb304767bca2bb92fb9c5bd33cedc95baee5bb5f6c88e63706533a1c06ad08c8", size = 243554, upload-time = "2026-01-26T02:45:01.054Z" },
-    { url = "https://files.pythonhosted.org/packages/20/1f/9d2327086bd15da2725ef6aae624208e2ef828ed99892b17f60c344e57ed/multidict-6.7.1-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:c9035dde0f916702850ef66460bc4239d89d08df4d02023a5926e7446724212c", size = 252341, upload-time = "2026-01-26T02:45:02.484Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/2c/2a1aa0280cf579d0f6eed8ee5211c4f1730bd7e06c636ba2ee6aafda302e/multidict-6.7.1-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:af959b9beeb66c822380f222f0e0a1889331597e81f1ded7f374f3ecb0fd6c52", size = 246391, upload-time = "2026-01-26T02:45:03.862Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/03/7ca022ffc36c5a3f6e03b179a5ceb829be9da5783e6fe395f347c0794680/multidict-6.7.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:41f2952231456154ee479651491e94118229844dd7226541788be783be2b5108", size = 243422, upload-time = "2026-01-26T02:45:05.296Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/1d/b31650eab6c5778aceed46ba735bd97f7c7d2f54b319fa916c0f96e7805b/multidict-6.7.1-cp313-cp313t-win32.whl", hash = "sha256:df9f19c28adcb40b6aae30bbaa1478c389efd50c28d541d76760199fc1037c32", size = 47770, upload-time = "2026-01-26T02:45:06.754Z" },
-    { url = "https://files.pythonhosted.org/packages/ac/5b/2d2d1d522e51285bd61b1e20df8f47ae1a9d80839db0b24ea783b3832832/multidict-6.7.1-cp313-cp313t-win_amd64.whl", hash = "sha256:d54ecf9f301853f2c5e802da559604b3e95bb7a3b01a9c295c6ee591b9882de8", size = 53109, upload-time = "2026-01-26T02:45:08.044Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/a3/cc409ba012c83ca024a308516703cf339bdc4b696195644a7215a5164a24/multidict-6.7.1-cp313-cp313t-win_arm64.whl", hash = "sha256:5a37ca18e360377cfda1d62f5f382ff41f2b8c4ccb329ed974cc2e1643440118", size = 45573, upload-time = "2026-01-26T02:45:09.349Z" },
-    { url = "https://files.pythonhosted.org/packages/91/cc/db74228a8be41884a567e88a62fd589a913708fcf180d029898c17a9a371/multidict-6.7.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8f333ec9c5eb1b7105e3b84b53141e66ca05a19a605368c55450b6ba208cb9ee", size = 75190, upload-time = "2026-01-26T02:45:10.651Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/22/492f2246bb5b534abd44804292e81eeaf835388901f0c574bac4eeec73c5/multidict-6.7.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:a407f13c188f804c759fc6a9f88286a565c242a76b27626594c133b82883b5c2", size = 44486, upload-time = "2026-01-26T02:45:11.938Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/4f/733c48f270565d78b4544f2baddc2fb2a245e5a8640254b12c36ac7ac68e/multidict-6.7.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0e161ddf326db5577c3a4cc2d8648f81456e8a20d40415541587a71620d7a7d1", size = 43219, upload-time = "2026-01-26T02:45:14.346Z" },
-    { url = "https://files.pythonhosted.org/packages/24/bb/2c0c2287963f4259c85e8bcbba9182ced8d7fca65c780c38e99e61629d11/multidict-6.7.1-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:1e3a8bb24342a8201d178c3b4984c26ba81a577c80d4d525727427460a50c22d", size = 245132, upload-time = "2026-01-26T02:45:15.712Z" },
-    { url = "https://files.pythonhosted.org/packages/a7/f9/44d4b3064c65079d2467888794dea218d1601898ac50222ab8a9a8094460/multidict-6.7.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:97231140a50f5d447d3164f994b86a0bed7cd016e2682f8650d6a9158e14fd31", size = 252420, upload-time = "2026-01-26T02:45:17.293Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/13/78f7275e73fa17b24c9a51b0bd9d73ba64bb32d0ed51b02a746eb876abe7/multidict-6.7.1-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:6b10359683bd8806a200fd2909e7c8ca3a7b24ec1d8132e483d58e791d881048", size = 233510, upload-time = "2026-01-26T02:45:19.356Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/25/8167187f62ae3cbd52da7893f58cb036b47ea3fb67138787c76800158982/multidict-6.7.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:283ddac99f7ac25a4acadbf004cb5ae34480bbeb063520f70ce397b281859362", size = 264094, upload-time = "2026-01-26T02:45:20.834Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/e7/69a3a83b7b030cf283fb06ce074a05a02322359783424d7edf0f15fe5022/multidict-6.7.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:538cec1e18c067d0e6103aa9a74f9e832904c957adc260e61cd9d8cf0c3b3d37", size = 260786, upload-time = "2026-01-26T02:45:22.818Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/3b/8ec5074bcfc450fe84273713b4b0a0dd47c0249358f5d82eb8104ffe2520/multidict-6.7.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7eee46ccb30ff48a1e35bb818cc90846c6be2b68240e42a78599166722cea709", size = 248483, upload-time = "2026-01-26T02:45:24.368Z" },
-    { url = "https://files.pythonhosted.org/packages/48/5a/d5a99e3acbca0e29c5d9cba8f92ceb15dce78bab963b308ae692981e3a5d/multidict-6.7.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:fa263a02f4f2dd2d11a7b1bb4362aa7cb1049f84a9235d31adf63f30143469a0", size = 248403, upload-time = "2026-01-26T02:45:25.982Z" },
-    { url = "https://files.pythonhosted.org/packages/35/48/e58cd31f6c7d5102f2a4bf89f96b9cf7e00b6c6f3d04ecc44417c00a5a3c/multidict-6.7.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:2e1425e2f99ec5bd36c15a01b690a1a2456209c5deed58f95469ffb46039ccbb", size = 240315, upload-time = "2026-01-26T02:45:27.487Z" },
-    { url = "https://files.pythonhosted.org/packages/94/33/1cd210229559cb90b6786c30676bb0c58249ff42f942765f88793b41fdce/multidict-6.7.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:497394b3239fc6f0e13a78a3e1b61296e72bf1c5f94b4c4eb80b265c37a131cd", size = 245528, upload-time = "2026-01-26T02:45:28.991Z" },
-    { url = "https://files.pythonhosted.org/packages/64/f2/6e1107d226278c876c783056b7db43d800bb64c6131cec9c8dfb6903698e/multidict-6.7.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:233b398c29d3f1b9676b4b6f75c518a06fcb2ea0b925119fb2c1bc35c05e1601", size = 258784, upload-time = "2026-01-26T02:45:30.503Z" },
-    { url = "https://files.pythonhosted.org/packages/4d/c1/11f664f14d525e4a1b5327a82d4de61a1db604ab34c6603bb3c2cc63ad34/multidict-6.7.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:93b1818e4a6e0930454f0f2af7dfce69307ca03cdcfb3739bf4d91241967b6c1", size = 251980, upload-time = "2026-01-26T02:45:32.603Z" },
-    { url = "https://files.pythonhosted.org/packages/e1/9f/75a9ac888121d0c5bbd4ecf4eead45668b1766f6baabfb3b7f66a410e231/multidict-6.7.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f33dc2a3abe9249ea5d8360f969ec7f4142e7ac45ee7014d8f8d5acddf178b7b", size = 243602, upload-time = "2026-01-26T02:45:34.043Z" },
-    { url = "https://files.pythonhosted.org/packages/9a/e7/50bf7b004cc8525d80dbbbedfdc7aed3e4c323810890be4413e589074032/multidict-6.7.1-cp314-cp314-win32.whl", hash = "sha256:3ab8b9d8b75aef9df299595d5388b14530839f6422333357af1339443cff777d", size = 40930, upload-time = "2026-01-26T02:45:36.278Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/bf/52f25716bbe93745595800f36fb17b73711f14da59ed0bb2eba141bc9f0f/multidict-6.7.1-cp314-cp314-win_amd64.whl", hash = "sha256:5e01429a929600e7dab7b166062d9bb54a5eed752384c7384c968c2afab8f50f", size = 45074, upload-time = "2026-01-26T02:45:37.546Z" },
-    { url = "https://files.pythonhosted.org/packages/97/ab/22803b03285fa3a525f48217963da3a65ae40f6a1b6f6cf2768879e208f9/multidict-6.7.1-cp314-cp314-win_arm64.whl", hash = "sha256:4885cb0e817aef5d00a2e8451d4665c1808378dc27c2705f1bf4ef8505c0d2e5", size = 42471, upload-time = "2026-01-26T02:45:38.889Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/6d/f9293baa6146ba9507e360ea0292b6422b016907c393e2f63fc40ab7b7b5/multidict-6.7.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:0458c978acd8e6ea53c81eefaddbbee9c6c5e591f41b3f5e8e194780fe026581", size = 82401, upload-time = "2026-01-26T02:45:40.254Z" },
-    { url = "https://files.pythonhosted.org/packages/7a/68/53b5494738d83558d87c3c71a486504d8373421c3e0dbb6d0db48ad42ee0/multidict-6.7.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:c0abd12629b0af3cf590982c0b413b1e7395cd4ec026f30986818ab95bfaa94a", size = 48143, upload-time = "2026-01-26T02:45:41.635Z" },
-    { url = "https://files.pythonhosted.org/packages/37/e8/5284c53310dcdc99ce5d66563f6e5773531a9b9fe9ec7a615e9bc306b05f/multidict-6.7.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:14525a5f61d7d0c94b368a42cff4c9a4e7ba2d52e2672a7b23d84dc86fb02b0c", size = 46507, upload-time = "2026-01-26T02:45:42.99Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/fc/6800d0e5b3875568b4083ecf5f310dcf91d86d52573160834fb4bfcf5e4f/multidict-6.7.1-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:17307b22c217b4cf05033dabefe68255a534d637c6c9b0cc8382718f87be4262", size = 239358, upload-time = "2026-01-26T02:45:44.376Z" },
-    { url = "https://files.pythonhosted.org/packages/41/75/4ad0973179361cdf3a113905e6e088173198349131be2b390f9fa4da5fc6/multidict-6.7.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7a7e590ff876a3eaf1c02a4dfe0724b6e69a9e9de6d8f556816f29c496046e59", size = 246884, upload-time = "2026-01-26T02:45:47.167Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/9c/095bb28b5da139bd41fb9a5d5caff412584f377914bd8787c2aa98717130/multidict-6.7.1-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:5fa6a95dfee63893d80a34758cd0e0c118a30b8dcb46372bf75106c591b77889", size = 225878, upload-time = "2026-01-26T02:45:48.698Z" },
-    { url = "https://files.pythonhosted.org/packages/07/d0/c0a72000243756e8f5a277b6b514fa005f2c73d481b7d9e47cd4568aa2e4/multidict-6.7.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a0543217a6a017692aa6ae5cc39adb75e587af0f3a82288b1492eb73dd6cc2a4", size = 253542, upload-time = "2026-01-26T02:45:50.164Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/6b/f69da15289e384ecf2a68837ec8b5ad8c33e973aa18b266f50fe55f24b8c/multidict-6.7.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f99fe611c312b3c1c0ace793f92464d8cd263cc3b26b5721950d977b006b6c4d", size = 252403, upload-time = "2026-01-26T02:45:51.779Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/76/b9669547afa5a1a25cd93eaca91c0da1c095b06b6d2d8ec25b713588d3a1/multidict-6.7.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9004d8386d133b7e6135679424c91b0b854d2d164af6ea3f289f8f2761064609", size = 244889, upload-time = "2026-01-26T02:45:53.27Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/a9/a50d2669e506dad33cfc45b5d574a205587b7b8a5f426f2fbb2e90882588/multidict-6.7.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e628ef0e6859ffd8273c69412a2465c4be4a9517d07261b33334b5ec6f3c7489", size = 241982, upload-time = "2026-01-26T02:45:54.919Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/bb/1609558ad8b456b4827d3c5a5b775c93b87878fd3117ed3db3423dfbce1b/multidict-6.7.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:841189848ba629c3552035a6a7f5bf3b02eb304e9fea7492ca220a8eda6b0e5c", size = 232415, upload-time = "2026-01-26T02:45:56.981Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/59/6f61039d2aa9261871e03ab9dc058a550d240f25859b05b67fd70f80d4b3/multidict-6.7.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:ce1bbd7d780bb5a0da032e095c951f7014d6b0a205f8318308140f1a6aba159e", size = 240337, upload-time = "2026-01-26T02:45:58.698Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/29/fdc6a43c203890dc2ae9249971ecd0c41deaedfe00d25cb6564b2edd99eb/multidict-6.7.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:b26684587228afed0d50cf804cc71062cc9c1cdf55051c4c6345d372947b268c", size = 248788, upload-time = "2026-01-26T02:46:00.862Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/14/a153a06101323e4cf086ecee3faadba52ff71633d471f9685c42e3736163/multidict-6.7.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:9f9af11306994335398293f9958071019e3ab95e9a707dc1383a35613f6abcb9", size = 242842, upload-time = "2026-01-26T02:46:02.824Z" },
-    { url = "https://files.pythonhosted.org/packages/41/5f/604ae839e64a4a6efc80db94465348d3b328ee955e37acb24badbcd24d83/multidict-6.7.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b4938326284c4f1224178a560987b6cf8b4d38458b113d9b8c1db1a836e640a2", size = 240237, upload-time = "2026-01-26T02:46:05.898Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/60/c3a5187bf66f6fb546ff4ab8fb5a077cbdd832d7b1908d4365c7f74a1917/multidict-6.7.1-cp314-cp314t-win32.whl", hash = "sha256:98655c737850c064a65e006a3df7c997cd3b220be4ec8fe26215760b9697d4d7", size = 48008, upload-time = "2026-01-26T02:46:07.468Z" },
-    { url = "https://files.pythonhosted.org/packages/0c/f7/addf1087b860ac60e6f382240f64fb99f8bfb532bb06f7c542b83c29ca61/multidict-6.7.1-cp314-cp314t-win_amd64.whl", hash = "sha256:497bde6223c212ba11d462853cfa4f0ae6ef97465033e7dc9940cdb3ab5b48e5", size = 53542, upload-time = "2026-01-26T02:46:08.809Z" },
-    { url = "https://files.pythonhosted.org/packages/4c/81/4629d0aa32302ef7b2ec65c75a728cc5ff4fa410c50096174c1632e70b3e/multidict-6.7.1-cp314-cp314t-win_arm64.whl", hash = "sha256:2bbd113e0d4af5db41d5ebfe9ccaff89de2120578164f86a5d17d5a576d1e5b2", size = 44719, upload-time = "2026-01-26T02:46:11.146Z" },
     { url = "https://files.pythonhosted.org/packages/81/08/7036c080d7117f28a4af526d794aab6a84463126db031b007717c1a6676e/multidict-6.7.1-py3-none-any.whl", hash = "sha256:55d97cc6dae627efa6a6e548885712d4864b81110ac76fa4e534c03819fa4a56", size = 12319, upload-time = "2026-01-26T02:46:44.004Z" },
 ]
 
@@ -1766,7 +1206,10 @@ name = "networkx"
 version = "3.4.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/fd/1d/06475e1cd5264c0b870ea2cc6fdb3e37177c1e565c43f56ff17a10e3937f/networkx-3.4.2.tar.gz", hash = "sha256:307c3669428c5362aab27c8a1260aa8f47c4e91d3891f48be0141738d8d053e1", size = 2151368, upload-time = "2024-10-21T12:39:38.695Z" }
 wheels = [
@@ -1778,8 +1221,11 @@ name = "networkx"
 version = "3.6.1"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/6a/51/63fe664f3908c97be9d2e4f1158eb633317598cfa6e1fc14af5383f17512/networkx-3.6.1.tar.gz", hash = "sha256:26b7c357accc0c8cde558ad486283728b65b6a95d85ee1cd66bafab4c8168509", size = 2517025, upload-time = "2025-12-08T17:02:39.908Z" }
 wheels = [
@@ -1788,266 +1234,137 @@ wheels = [
 
 [[package]]
 name = "numpy"
-version = "2.2.6"
+version = "1.26.4"
 source = { registry = "https://pypi.org/simple" }
-resolution-markers = [
-    "python_full_version < '3.11'",
-]
-sdist = { url = "https://files.pythonhosted.org/packages/76/21/7d2a95e4bba9dc13d043ee156a356c0a8f0c6309dff6b21b4d71a073b8a8/numpy-2.2.6.tar.gz", hash = "sha256:e29554e2bef54a90aa5cc07da6ce955accb83f21ab5de01a62c8478897b264fd", size = 20276440, upload-time = "2025-05-17T22:38:04.611Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/9a/3e/ed6db5be21ce87955c0cbd3009f2803f59fa08df21b5df06862e2d8e2bdd/numpy-2.2.6-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b412caa66f72040e6d268491a59f2c43bf03eb6c96dd8f0307829feb7fa2b6fb", size = 21165245, upload-time = "2025-05-17T21:27:58.555Z" },
-    { url = "https://files.pythonhosted.org/packages/22/c2/4b9221495b2a132cc9d2eb862e21d42a009f5a60e45fc44b00118c174bff/numpy-2.2.6-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8e41fd67c52b86603a91c1a505ebaef50b3314de0213461c7a6e99c9a3beff90", size = 14360048, upload-time = "2025-05-17T21:28:21.406Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/77/dc2fcfc66943c6410e2bf598062f5959372735ffda175b39906d54f02349/numpy-2.2.6-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:37e990a01ae6ec7fe7fa1c26c55ecb672dd98b19c3d0e1d1f326fa13cb38d163", size = 5340542, upload-time = "2025-05-17T21:28:30.931Z" },
-    { url = "https://files.pythonhosted.org/packages/7a/4f/1cb5fdc353a5f5cc7feb692db9b8ec2c3d6405453f982435efc52561df58/numpy-2.2.6-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:5a6429d4be8ca66d889b7cf70f536a397dc45ba6faeb5f8c5427935d9592e9cf", size = 6878301, upload-time = "2025-05-17T21:28:41.613Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/17/96a3acd228cec142fcb8723bd3cc39c2a474f7dcf0a5d16731980bcafa95/numpy-2.2.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:efd28d4e9cd7d7a8d39074a4d44c63eda73401580c5c76acda2ce969e0a38e83", size = 14297320, upload-time = "2025-05-17T21:29:02.78Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/63/3de6a34ad7ad6646ac7d2f55ebc6ad439dbbf9c4370017c50cf403fb19b5/numpy-2.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fc7b73d02efb0e18c000e9ad8b83480dfcd5dfd11065997ed4c6747470ae8915", size = 16801050, upload-time = "2025-05-17T21:29:27.675Z" },
-    { url = "https://files.pythonhosted.org/packages/07/b6/89d837eddef52b3d0cec5c6ba0456c1bf1b9ef6a6672fc2b7873c3ec4e2e/numpy-2.2.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:74d4531beb257d2c3f4b261bfb0fc09e0f9ebb8842d82a7b4209415896adc680", size = 15807034, upload-time = "2025-05-17T21:29:51.102Z" },
-    { url = "https://files.pythonhosted.org/packages/01/c8/dc6ae86e3c61cfec1f178e5c9f7858584049b6093f843bca541f94120920/numpy-2.2.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:8fc377d995680230e83241d8a96def29f204b5782f371c532579b4f20607a289", size = 18614185, upload-time = "2025-05-17T21:30:18.703Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/c5/0064b1b7e7c89137b471ccec1fd2282fceaae0ab3a9550f2568782d80357/numpy-2.2.6-cp310-cp310-win32.whl", hash = "sha256:b093dd74e50a8cba3e873868d9e93a85b78e0daf2e98c6797566ad8044e8363d", size = 6527149, upload-time = "2025-05-17T21:30:29.788Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/dd/4b822569d6b96c39d1215dbae0582fd99954dcbcf0c1a13c61783feaca3f/numpy-2.2.6-cp310-cp310-win_amd64.whl", hash = "sha256:f0fd6321b839904e15c46e0d257fdd101dd7f530fe03fd6359c1ea63738703f3", size = 12904620, upload-time = "2025-05-17T21:30:48.994Z" },
-    { url = "https://files.pythonhosted.org/packages/da/a8/4f83e2aa666a9fbf56d6118faaaf5f1974d456b1823fda0a176eff722839/numpy-2.2.6-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f9f1adb22318e121c5c69a09142811a201ef17ab257a1e66ca3025065b7f53ae", size = 21176963, upload-time = "2025-05-17T21:31:19.36Z" },
-    { url = "https://files.pythonhosted.org/packages/b3/2b/64e1affc7972decb74c9e29e5649fac940514910960ba25cd9af4488b66c/numpy-2.2.6-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c820a93b0255bc360f53eca31a0e676fd1101f673dda8da93454a12e23fc5f7a", size = 14406743, upload-time = "2025-05-17T21:31:41.087Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/9f/0121e375000b5e50ffdd8b25bf78d8e1a5aa4cca3f185d41265198c7b834/numpy-2.2.6-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:3d70692235e759f260c3d837193090014aebdf026dfd167834bcba43e30c2a42", size = 5352616, upload-time = "2025-05-17T21:31:50.072Z" },
-    { url = "https://files.pythonhosted.org/packages/31/0d/b48c405c91693635fbe2dcd7bc84a33a602add5f63286e024d3b6741411c/numpy-2.2.6-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:481b49095335f8eed42e39e8041327c05b0f6f4780488f61286ed3c01368d491", size = 6889579, upload-time = "2025-05-17T21:32:01.712Z" },
-    { url = "https://files.pythonhosted.org/packages/52/b8/7f0554d49b565d0171eab6e99001846882000883998e7b7d9f0d98b1f934/numpy-2.2.6-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b64d8d4d17135e00c8e346e0a738deb17e754230d7e0810ac5012750bbd85a5a", size = 14312005, upload-time = "2025-05-17T21:32:23.332Z" },
-    { url = "https://files.pythonhosted.org/packages/b3/dd/2238b898e51bd6d389b7389ffb20d7f4c10066d80351187ec8e303a5a475/numpy-2.2.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba10f8411898fc418a521833e014a77d3ca01c15b0c6cdcce6a0d2897e6dbbdf", size = 16821570, upload-time = "2025-05-17T21:32:47.991Z" },
-    { url = "https://files.pythonhosted.org/packages/83/6c/44d0325722cf644f191042bf47eedad61c1e6df2432ed65cbe28509d404e/numpy-2.2.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:bd48227a919f1bafbdda0583705e547892342c26fb127219d60a5c36882609d1", size = 15818548, upload-time = "2025-05-17T21:33:11.728Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/9d/81e8216030ce66be25279098789b665d49ff19eef08bfa8cb96d4957f422/numpy-2.2.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:9551a499bf125c1d4f9e250377c1ee2eddd02e01eac6644c080162c0c51778ab", size = 18620521, upload-time = "2025-05-17T21:33:39.139Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/fd/e19617b9530b031db51b0926eed5345ce8ddc669bb3bc0044b23e275ebe8/numpy-2.2.6-cp311-cp311-win32.whl", hash = "sha256:0678000bb9ac1475cd454c6b8c799206af8107e310843532b04d49649c717a47", size = 6525866, upload-time = "2025-05-17T21:33:50.273Z" },
-    { url = "https://files.pythonhosted.org/packages/31/0a/f354fb7176b81747d870f7991dc763e157a934c717b67b58456bc63da3df/numpy-2.2.6-cp311-cp311-win_amd64.whl", hash = "sha256:e8213002e427c69c45a52bbd94163084025f533a55a59d6f9c5b820774ef3303", size = 12907455, upload-time = "2025-05-17T21:34:09.135Z" },
-    { url = "https://files.pythonhosted.org/packages/82/5d/c00588b6cf18e1da539b45d3598d3557084990dcc4331960c15ee776ee41/numpy-2.2.6-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:41c5a21f4a04fa86436124d388f6ed60a9343a6f767fced1a8a71c3fbca038ff", size = 20875348, upload-time = "2025-05-17T21:34:39.648Z" },
-    { url = "https://files.pythonhosted.org/packages/66/ee/560deadcdde6c2f90200450d5938f63a34b37e27ebff162810f716f6a230/numpy-2.2.6-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:de749064336d37e340f640b05f24e9e3dd678c57318c7289d222a8a2f543e90c", size = 14119362, upload-time = "2025-05-17T21:35:01.241Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/65/4baa99f1c53b30adf0acd9a5519078871ddde8d2339dc5a7fde80d9d87da/numpy-2.2.6-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:894b3a42502226a1cac872f840030665f33326fc3dac8e57c607905773cdcde3", size = 5084103, upload-time = "2025-05-17T21:35:10.622Z" },
-    { url = "https://files.pythonhosted.org/packages/cc/89/e5a34c071a0570cc40c9a54eb472d113eea6d002e9ae12bb3a8407fb912e/numpy-2.2.6-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:71594f7c51a18e728451bb50cc60a3ce4e6538822731b2933209a1f3614e9282", size = 6625382, upload-time = "2025-05-17T21:35:21.414Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/35/8c80729f1ff76b3921d5c9487c7ac3de9b2a103b1cd05e905b3090513510/numpy-2.2.6-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f2618db89be1b4e05f7a1a847a9c1c0abd63e63a1607d892dd54668dd92faf87", size = 14018462, upload-time = "2025-05-17T21:35:42.174Z" },
-    { url = "https://files.pythonhosted.org/packages/8c/3d/1e1db36cfd41f895d266b103df00ca5b3cbe965184df824dec5c08c6b803/numpy-2.2.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd83c01228a688733f1ded5201c678f0c53ecc1006ffbc404db9f7a899ac6249", size = 16527618, upload-time = "2025-05-17T21:36:06.711Z" },
-    { url = "https://files.pythonhosted.org/packages/61/c6/03ed30992602c85aa3cd95b9070a514f8b3c33e31124694438d88809ae36/numpy-2.2.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:37c0ca431f82cd5fa716eca9506aefcabc247fb27ba69c5062a6d3ade8cf8f49", size = 15505511, upload-time = "2025-05-17T21:36:29.965Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/25/5761d832a81df431e260719ec45de696414266613c9ee268394dd5ad8236/numpy-2.2.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fe27749d33bb772c80dcd84ae7e8df2adc920ae8297400dabec45f0dedb3f6de", size = 18313783, upload-time = "2025-05-17T21:36:56.883Z" },
-    { url = "https://files.pythonhosted.org/packages/57/0a/72d5a3527c5ebffcd47bde9162c39fae1f90138c961e5296491ce778e682/numpy-2.2.6-cp312-cp312-win32.whl", hash = "sha256:4eeaae00d789f66c7a25ac5f34b71a7035bb474e679f410e5e1a94deb24cf2d4", size = 6246506, upload-time = "2025-05-17T21:37:07.368Z" },
-    { url = "https://files.pythonhosted.org/packages/36/fa/8c9210162ca1b88529ab76b41ba02d433fd54fecaf6feb70ef9f124683f1/numpy-2.2.6-cp312-cp312-win_amd64.whl", hash = "sha256:c1f9540be57940698ed329904db803cf7a402f3fc200bfe599334c9bd84a40b2", size = 12614190, upload-time = "2025-05-17T21:37:26.213Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/5c/6657823f4f594f72b5471f1db1ab12e26e890bb2e41897522d134d2a3e81/numpy-2.2.6-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0811bb762109d9708cca4d0b13c4f67146e3c3b7cf8d34018c722adb2d957c84", size = 20867828, upload-time = "2025-05-17T21:37:56.699Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/9e/14520dc3dadf3c803473bd07e9b2bd1b69bc583cb2497b47000fed2fa92f/numpy-2.2.6-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:287cc3162b6f01463ccd86be154f284d0893d2b3ed7292439ea97eafa8170e0b", size = 14143006, upload-time = "2025-05-17T21:38:18.291Z" },
-    { url = "https://files.pythonhosted.org/packages/4f/06/7e96c57d90bebdce9918412087fc22ca9851cceaf5567a45c1f404480e9e/numpy-2.2.6-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:f1372f041402e37e5e633e586f62aa53de2eac8d98cbfb822806ce4bbefcb74d", size = 5076765, upload-time = "2025-05-17T21:38:27.319Z" },
-    { url = "https://files.pythonhosted.org/packages/73/ed/63d920c23b4289fdac96ddbdd6132e9427790977d5457cd132f18e76eae0/numpy-2.2.6-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:55a4d33fa519660d69614a9fad433be87e5252f4b03850642f88993f7b2ca566", size = 6617736, upload-time = "2025-05-17T21:38:38.141Z" },
-    { url = "https://files.pythonhosted.org/packages/85/c5/e19c8f99d83fd377ec8c7e0cf627a8049746da54afc24ef0a0cb73d5dfb5/numpy-2.2.6-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f92729c95468a2f4f15e9bb94c432a9229d0d50de67304399627a943201baa2f", size = 14010719, upload-time = "2025-05-17T21:38:58.433Z" },
-    { url = "https://files.pythonhosted.org/packages/19/49/4df9123aafa7b539317bf6d342cb6d227e49f7a35b99c287a6109b13dd93/numpy-2.2.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1bc23a79bfabc5d056d106f9befb8d50c31ced2fbc70eedb8155aec74a45798f", size = 16526072, upload-time = "2025-05-17T21:39:22.638Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/6c/04b5f47f4f32f7c2b0e7260442a8cbcf8168b0e1a41ff1495da42f42a14f/numpy-2.2.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e3143e4451880bed956e706a3220b4e5cf6172ef05fcc397f6f36a550b1dd868", size = 15503213, upload-time = "2025-05-17T21:39:45.865Z" },
-    { url = "https://files.pythonhosted.org/packages/17/0a/5cd92e352c1307640d5b6fec1b2ffb06cd0dabe7d7b8227f97933d378422/numpy-2.2.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b4f13750ce79751586ae2eb824ba7e1e8dba64784086c98cdbbcc6a42112ce0d", size = 18316632, upload-time = "2025-05-17T21:40:13.331Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/3b/5cba2b1d88760ef86596ad0f3d484b1cbff7c115ae2429678465057c5155/numpy-2.2.6-cp313-cp313-win32.whl", hash = "sha256:5beb72339d9d4fa36522fc63802f469b13cdbe4fdab4a288f0c441b74272ebfd", size = 6244532, upload-time = "2025-05-17T21:43:46.099Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/3b/d58c12eafcb298d4e6d0d40216866ab15f59e55d148a5658bb3132311fcf/numpy-2.2.6-cp313-cp313-win_amd64.whl", hash = "sha256:b0544343a702fa80c95ad5d3d608ea3599dd54d4632df855e4c8d24eb6ecfa1c", size = 12610885, upload-time = "2025-05-17T21:44:05.145Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/9e/4bf918b818e516322db999ac25d00c75788ddfd2d2ade4fa66f1f38097e1/numpy-2.2.6-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0bca768cd85ae743b2affdc762d617eddf3bcf8724435498a1e80132d04879e6", size = 20963467, upload-time = "2025-05-17T21:40:44Z" },
-    { url = "https://files.pythonhosted.org/packages/61/66/d2de6b291507517ff2e438e13ff7b1e2cdbdb7cb40b3ed475377aece69f9/numpy-2.2.6-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:fc0c5673685c508a142ca65209b4e79ed6740a4ed6b2267dbba90f34b0b3cfda", size = 14225144, upload-time = "2025-05-17T21:41:05.695Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/25/480387655407ead912e28ba3a820bc69af9adf13bcbe40b299d454ec011f/numpy-2.2.6-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:5bd4fc3ac8926b3819797a7c0e2631eb889b4118a9898c84f585a54d475b7e40", size = 5200217, upload-time = "2025-05-17T21:41:15.903Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/4a/6e313b5108f53dcbf3aca0c0f3e9c92f4c10ce57a0a721851f9785872895/numpy-2.2.6-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:fee4236c876c4e8369388054d02d0e9bb84821feb1a64dd59e137e6511a551f8", size = 6712014, upload-time = "2025-05-17T21:41:27.321Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/30/172c2d5c4be71fdf476e9de553443cf8e25feddbe185e0bd88b096915bcc/numpy-2.2.6-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e1dda9c7e08dc141e0247a5b8f49cf05984955246a327d4c48bda16821947b2f", size = 14077935, upload-time = "2025-05-17T21:41:49.738Z" },
-    { url = "https://files.pythonhosted.org/packages/12/fb/9e743f8d4e4d3c710902cf87af3512082ae3d43b945d5d16563f26ec251d/numpy-2.2.6-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f447e6acb680fd307f40d3da4852208af94afdfab89cf850986c3ca00562f4fa", size = 16600122, upload-time = "2025-05-17T21:42:14.046Z" },
-    { url = "https://files.pythonhosted.org/packages/12/75/ee20da0e58d3a66f204f38916757e01e33a9737d0b22373b3eb5a27358f9/numpy-2.2.6-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:389d771b1623ec92636b0786bc4ae56abafad4a4c513d36a55dce14bd9ce8571", size = 15586143, upload-time = "2025-05-17T21:42:37.464Z" },
-    { url = "https://files.pythonhosted.org/packages/76/95/bef5b37f29fc5e739947e9ce5179ad402875633308504a52d188302319c8/numpy-2.2.6-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8e9ace4a37db23421249ed236fdcdd457d671e25146786dfc96835cd951aa7c1", size = 18385260, upload-time = "2025-05-17T21:43:05.189Z" },
-    { url = "https://files.pythonhosted.org/packages/09/04/f2f83279d287407cf36a7a8053a5abe7be3622a4363337338f2585e4afda/numpy-2.2.6-cp313-cp313t-win32.whl", hash = "sha256:038613e9fb8c72b0a41f025a7e4c3f0b7a1b5d768ece4796b674c8f3fe13efff", size = 6377225, upload-time = "2025-05-17T21:43:16.254Z" },
-    { url = "https://files.pythonhosted.org/packages/67/0e/35082d13c09c02c011cf21570543d202ad929d961c02a147493cb0c2bdf5/numpy-2.2.6-cp313-cp313t-win_amd64.whl", hash = "sha256:6031dd6dfecc0cf9f668681a37648373bddd6421fff6c66ec1624eed0180ee06", size = 12771374, upload-time = "2025-05-17T21:43:35.479Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/3b/d94a75f4dbf1ef5d321523ecac21ef23a3cd2ac8b78ae2aac40873590229/numpy-2.2.6-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:0b605b275d7bd0c640cad4e5d30fa701a8d59302e127e5f79138ad62762c3e3d", size = 21040391, upload-time = "2025-05-17T21:44:35.948Z" },
-    { url = "https://files.pythonhosted.org/packages/17/f4/09b2fa1b58f0fb4f7c7963a1649c64c4d315752240377ed74d9cd878f7b5/numpy-2.2.6-pp310-pypy310_pp73-macosx_14_0_x86_64.whl", hash = "sha256:7befc596a7dc9da8a337f79802ee8adb30a552a94f792b9c9d18c840055907db", size = 6786754, upload-time = "2025-05-17T21:44:47.446Z" },
-    { url = "https://files.pythonhosted.org/packages/af/30/feba75f143bdc868a1cc3f44ccfa6c4b9ec522b36458e738cd00f67b573f/numpy-2.2.6-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce47521a4754c8f4593837384bd3424880629f718d87c5d44f8ed763edd63543", size = 16643476, upload-time = "2025-05-17T21:45:11.871Z" },
-    { url = "https://files.pythonhosted.org/packages/37/48/ac2a9584402fb6c0cd5b5d1a91dcf176b15760130dd386bbafdbfe3640bf/numpy-2.2.6-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:d042d24c90c41b54fd506da306759e06e568864df8ec17ccc17e9e884634fd00", size = 12812666, upload-time = "2025-05-17T21:45:31.426Z" },
-]
-
-[[package]]
-name = "numpy"
-version = "2.4.6"
-source = { registry = "https://pypi.org/simple" }
-resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
-]
-sdist = { url = "https://files.pythonhosted.org/packages/d0/ad/fed0499ce6a338d2a03ebae59cd15093910c8875328855781952abf6c2fe/numpy-2.4.6.tar.gz", hash = "sha256:f3a3570c4a2a16746ac2c31a7c7c7b0c186b95ce902e33db6f28094ed7387dda", size = 20735807, upload-time = "2026-05-18T23:37:14.07Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/b3/49/ec46835a70be8fa6446c495126ac84fdb28cb2558e1620ffb87a10c8b64c/numpy-2.4.6-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:0280e0356c0829a18d9de1cb7eee50ec22ca639878d7240307ca0943d73cd2c4", size = 16969194, upload-time = "2026-05-18T23:33:13.503Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/0d/f5957185c0ee2f3e12f78715aa9e3b353fd83633316c8532b38faa37e3f6/numpy-2.4.6-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:110f8b71aacb688ec69062bb7f6938a0f8acb01b7c1c4beb453c65b6d234584d", size = 14964111, upload-time = "2026-05-18T23:33:17.795Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/40/40a40ee0ddf7ceb782c49af278894b686e586d65d8c1889c8b5da01a3d7d/numpy-2.4.6-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:4cfe66903cc32a9921a6733d96b19bb6abf310397581bbad89c228f5abaf0ee8", size = 5469159, upload-time = "2026-05-18T23:33:20.654Z" },
-    { url = "https://files.pythonhosted.org/packages/63/13/f9a8046535cb21deae82f8d03de9617e08882d274fad2539630761888228/numpy-2.4.6-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:8155154c7c691289fe18f510b5d4657c68c67989f293f0535a91360392ff6538", size = 6798936, upload-time = "2026-05-18T23:33:22.987Z" },
-    { url = "https://files.pythonhosted.org/packages/33/a8/6fa8c1a345a8c85dbb21932c447bee07c30a2c2a3f31e369c0a84b300147/numpy-2.4.6-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ab0a9c4ffb1a6d95ef519fe4247dba8eb6b18ad93999f76b7f657039acabd47", size = 15966692, upload-time = "2026-05-18T23:33:26.62Z" },
-    { url = "https://files.pythonhosted.org/packages/02/03/74fe2a4cb3817d94d86402f2506554130a2f01414e299b5a843e5a8a957f/numpy-2.4.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:89cd468399cfd2504718f0ba50e410dca55a170b61a02ad92bb18c8a65186e93", size = 16918164, upload-time = "2026-05-18T23:33:29.955Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/80/3615be3313f7e7696609bc194b9f0101da809df79e859bdb84e0cd043f46/numpy-2.4.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c2d37ab77531417474168eb79d6d80b14f821a966818505d03013d0833edb7a8", size = 17322877, upload-time = "2026-05-18T23:33:34.724Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/ac/a691e0fe2675e370d0e08ff905adc49a1c8830e8cae03efe4477e92cd55d/numpy-2.4.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f407cb6b8e9d6d8c626bc73c945db1706035af8fd632295547bf1c9e46d092d6", size = 18651487, upload-time = "2026-05-18T23:33:38.217Z" },
-    { url = "https://files.pythonhosted.org/packages/15/a7/9bc1cd626d7bf6869bfedf27b91b6ab5dd607758bf8e959d6fa80c6a59cb/numpy-2.4.6-cp311-cp311-win32.whl", hash = "sha256:ddea102b48f9e339f3948bf22040944184627a30fdf7f858667673b9c5f033c8", size = 6233945, upload-time = "2026-05-18T23:33:41.331Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/31/7fc6239c12bce7e931463251cca4426c465e1876ba3cc785402ef4dd8f4e/numpy-2.4.6-cp311-cp311-win_amd64.whl", hash = "sha256:1e254a00cdf42b1e4d5b3d68d33af63268d41340d8885df2ab6470f2e1500147", size = 12608406, upload-time = "2026-05-18T23:33:44.131Z" },
-    { url = "https://files.pythonhosted.org/packages/27/83/140f85a466595a16382996a1bf06b2b54bcd597488921b0c9daaeeda72af/numpy-2.4.6-cp311-cp311-win_arm64.whl", hash = "sha256:ed9749eef4cbd126da3dc1d6bcb3a57f5eb7ac6a6484146bdbf743f552dfc577", size = 10479528, upload-time = "2026-05-18T23:33:50.725Z" },
-    { url = "https://files.pythonhosted.org/packages/95/2a/3d7b5ac8aac24feaf9ad7ed58f45b0bbc06d37e4338ae84c9f2298b570f9/numpy-2.4.6-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:001fbb8e08d942dd57599e781f2472269ee7f2755fae407b4f67b2f0b17da3f1", size = 16689119, upload-time = "2026-05-18T23:33:54.065Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/12/92c4c131527599e8288d6918e888d88726f84d805d784b771f32408aeaef/numpy-2.4.6-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ebfb099f8dcf083deef3ac1ca4c1503f387cf76296fcb3816b66f5ecb5f54fdb", size = 14699246, upload-time = "2026-05-18T23:33:57.621Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/fe/c0a6b7b2ca128a8fb228575147073b660656734b8ebe4d76c8fd748dcc79/numpy-2.4.6-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:3213d622a0283a39a93d188f3cf72b26862df52fbb4ca3697f51705016523d41", size = 5204410, upload-time = "2026-05-18T23:34:00.302Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/d4/9770d14ba719432bb90a421bfd443872ed0f70f7264b64bec12ea363d5fd/numpy-2.4.6-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:357cc07a6d7b0b182ff02249616a03742827ebb1277546b5c7cd7f7620a45698", size = 6551240, upload-time = "2026-05-18T23:34:02.852Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/c6/50a46a6205feba2343f1d6d17438107c5dc491ed1c736e6ea68689fd906b/numpy-2.4.6-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f9fb9157b4ce2971008323afe46053787b526ef624fea915b261468a8421a0f", size = 15671012, upload-time = "2026-05-18T23:34:05.485Z" },
-    { url = "https://files.pythonhosted.org/packages/99/60/14115e6364fa676c5397c2ad3004e527e9aa487abf5d0706ec81bbd08529/numpy-2.4.6-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:90f9849678c75fe7afa2d348ac842c168b0a4d3d61919687216dfc547976d853", size = 16645538, upload-time = "2026-05-18T23:34:09.265Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/c5/693cbe59e57db94d2231fa519ca3978dc9e19da5a8f088588f5c6e947ff2/numpy-2.4.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:c1a2af6c6ef86344a6b0db6b97834208bf598db514f2b155042439b62605601a", size = 17020706, upload-time = "2026-05-18T23:34:13.053Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/fc/85b7c4eff9b4966ade25c2273cf7e7012e92366c032058653934b37de044/numpy-2.4.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e5805d5a22fd19c8ccff10a9561f9df94436b0545619ea579db2d3c35294bce2", size = 18368541, upload-time = "2026-05-18T23:34:17.024Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/81/e1b27545deedce7f4a0b348618c6b62d74e36a4dc9ccd42f3eb2f85eee32/numpy-2.4.6-cp312-cp312-win32.whl", hash = "sha256:e3eeb0aabd6bd5ce64faae67e9935203a6991b4bc2a485a767fbafb2c5125f45", size = 5962825, upload-time = "2026-05-18T23:34:20.3Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/ca/feab00bd44aa5fe1ad2c18f08b4d3bb92e26484b0b1d1443897809ed528c/numpy-2.4.6-cp312-cp312-win_amd64.whl", hash = "sha256:d8e8286dd7cea7895157318d1b91cdacac64c479f3cbc8dce548331728484751", size = 12321687, upload-time = "2026-05-18T23:34:23.095Z" },
-    { url = "https://files.pythonhosted.org/packages/63/cf/5a6d34850a39d1093558564f77ee8e8e0bee5061151b8f05a55711001ec7/numpy-2.4.6-cp312-cp312-win_arm64.whl", hash = "sha256:4081eb135ac24158bd51cdfbef16f1c64df7063b1143f24731387137c092bec8", size = 10221482, upload-time = "2026-05-18T23:34:25.876Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/82/bdab26d7438c6791ca31b7c024ca37c1eab8b726ba236129005cd4a06e45/numpy-2.4.6-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:511dbaf848decaaaf4b4ca48032619fb3138710c4bf7da7617765edad1ef96b0", size = 16684648, upload-time = "2026-05-18T23:34:29.41Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/30/a80189bcc7f5e4258b3fbc3968d909d1756f54d023299ecc39ad6fdb9ef8/numpy-2.4.6-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bf162abab1c1a736333192707cef898e735a5ca00f38f27eeedf44b39d9e85eb", size = 14693902, upload-time = "2026-05-18T23:34:33.013Z" },
-    { url = "https://files.pythonhosted.org/packages/97/12/70b5d0d7c15e1ebb8a6a84a8caa1d19e181d84fb58bb6d70aca29099dec1/numpy-2.4.6-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:043191bfa8eab18c776647b62723ac9dddece59743b13f49b2016094129c2b3f", size = 5198992, upload-time = "2026-05-18T23:34:36.132Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/8c/ebd2a8f8a83541f8d38cc5667e8c2b69cecfd30da6e45693e8158857d44b/numpy-2.4.6-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:6180d8b35af935aed8ece3a85e0a43f87393ae0ac87c8d2c8bd2c993f7270ef3", size = 6546944, upload-time = "2026-05-18T23:34:38.484Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/c5/7b863a97a91671a0338f4253bd3b5a3d3852f0692dae91711c9f4a10e787/numpy-2.4.6-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:72fbe16c6fac95aedf5937fa873445cec2110be35d8a4e9433d7501fd98dae6b", size = 15669392, upload-time = "2026-05-18T23:34:41.257Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/9d/3584b9984ca4c047aea75214ce1a4c4c73d849bd71b604264b7f5653f8a8/numpy-2.4.6-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a7830bab239b79cda9c08c2da014761cafb48da6150e1da17ac06283f43b6089", size = 16633220, upload-time = "2026-05-18T23:34:45.075Z" },
-    { url = "https://files.pythonhosted.org/packages/05/ae/7c67fba23bd98caec7c99261f3a16072ade14813486b0282cb29846de832/numpy-2.4.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ef4aea96ce4d3b074422cb4f2f64e216bf9e213004bb58ecfdf50ea02ea8eb9a", size = 17020800, upload-time = "2026-05-18T23:34:49.065Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/5d/3b6725cb31d983c5e66916f5d36f6d7e5521129e4c4404d64f918292a5b6/numpy-2.4.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:dfa20cc6ca228e6b155b11da03825975ce66aea520985dbbddf0f2a5a495c605", size = 18357600, upload-time = "2026-05-18T23:34:52.709Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/da/2ccc6c2fe8898dee01d90c75c5f5f914a23daf99e3e0f59516a08760c8b5/numpy-2.4.6-cp313-cp313-win32.whl", hash = "sha256:56b39e5e0622a09a25bf5baf62f4bcf0cb8a41ae6e2819cf49bbc5a74c083f91", size = 5961134, upload-time = "2026-05-18T23:34:55.618Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/cd/9cc4dc876fb065d5c220aae4d5e14826b2715331bb7618ce1fb07a679d99/numpy-2.4.6-cp313-cp313-win_amd64.whl", hash = "sha256:c4fc99836233ea196540b17ab0983aff60ed07941751930f5f4d05bc3b3b7359", size = 12318598, upload-time = "2026-05-18T23:34:58.928Z" },
-    { url = "https://files.pythonhosted.org/packages/39/1e/c0bcba1f8694116485fe28fd1be698c278fcda4141c5b0e53a2aed8b12a8/numpy-2.4.6-cp313-cp313-win_arm64.whl", hash = "sha256:a7c711e21628b52034bb5ab8d1bce291f752fcc5e92accc615778acee1ff4778", size = 10222272, upload-time = "2026-05-18T23:35:02.167Z" },
-    { url = "https://files.pythonhosted.org/packages/63/6d/cc5619247c8f4204e507f5883528372e4ac4bb189e579fb859a12e480b1f/numpy-2.4.6-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:112b06a867b235ef466ed3508ddf0238050df9c727cafb5301ac385b899189a1", size = 14821197, upload-time = "2026-05-18T23:35:05.468Z" },
-    { url = "https://files.pythonhosted.org/packages/00/58/f1c39161c87d9e9bed660f1ed4bafc0e403d5ec9650b6dd77aead07d489b/numpy-2.4.6-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:eaf7fa2de5c0be8ae6ff8e9bea2ccd725e980541244521d8d4b5f3354a27babe", size = 5326287, upload-time = "2026-05-18T23:35:08.693Z" },
-    { url = "https://files.pythonhosted.org/packages/af/57/3917ab0fd97f271a8694513581b8a36c655f111c446852c302f04ccdb6fc/numpy-2.4.6-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:7265a2f3d436e54ef9f2b52b5c937e6be778781bd97a590319d7348f1c1ca997", size = 6646763, upload-time = "2026-05-18T23:35:11.459Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/0f/037e64c494b67581ae18193d770adef354c41f3f2c8ebf865602d949bf8f/numpy-2.4.6-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f74a575920ab21fe304421a3fc28793d82e299cae9eccb37084e9fc7f3617c20", size = 15728070, upload-time = "2026-05-18T23:35:14.79Z" },
-    { url = "https://files.pythonhosted.org/packages/21/a6/5d2bae9c9542eb4df16dc9c46dc79c186e9bad53805dfa5399a6023c6db0/numpy-2.4.6-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ede83e07a75dd06bc501566c1eca2afc0d61677c1472ac9ad93fdee6e638a48d", size = 16681752, upload-time = "2026-05-18T23:35:18.836Z" },
-    { url = "https://files.pythonhosted.org/packages/92/14/23d1dfb410ae362cd59ce53e936b1513d545eb40db3949ced632e19a459e/numpy-2.4.6-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:68bb27509ac1b9a3443094260f6326150663b06abe40b73a2f81160623da5b67", size = 17086024, upload-time = "2026-05-18T23:35:22.52Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/6e/23595a2c642cdf3bc567877064bdd7f91c8b0038a4453cf2daf7248eafe9/numpy-2.4.6-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:a0df0043bdb289bde1f62da130d20df23d58b45429f752bc7a8fc5325a225ecd", size = 18403398, upload-time = "2026-05-18T23:35:26.398Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/90/0ac3bc947217e66dec77e7cbc6a1979d1af70b6461b82f620d3bccd5e4c8/numpy-2.4.6-cp313-cp313t-win32.whl", hash = "sha256:29a287e0cf63ff528da061de6b9f64a4618da591ca1046aafc54062e40ca7eab", size = 6084971, upload-time = "2026-05-18T23:35:29.387Z" },
-    { url = "https://files.pythonhosted.org/packages/77/71/5673e351671a1d2bd6063b91b44f70c0affea7d1516fa7a6572941ba4aa1/numpy-2.4.6-cp313-cp313t-win_amd64.whl", hash = "sha256:25c692919ac5a01f170a3bfcd62d745b24fd095c353d50812637d6fcab442e75", size = 12458532, upload-time = "2026-05-18T23:35:32.175Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/88/19d3503c5046e688f049274b27a3ef3d771152fa80d3ba3d01a3dff61abe/numpy-2.4.6-cp313-cp313t-win_arm64.whl", hash = "sha256:1e978ec1e8bd0e0e4de6bb75de9d30cbb74db6b6a2bb727618613703ca0167dd", size = 10291881, upload-time = "2026-05-18T23:35:35.465Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/91/3ab2044d05fd16d343c5ac2e69b127f1b2854040dd20b193257c78028bd3/numpy-2.4.6-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:06ca2f61ec4385a07a6977c55ba998a4466c123642b4a32694d3128fce18c079", size = 16683458, upload-time = "2026-05-18T23:35:38.353Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/62/764ce66fa4147ae6d73071a3abf804ffe606f174618697c571acdf26a7c9/numpy-2.4.6-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:38efbc8de75c7a0fc1ac190162d892787f3f47b57cc291231aafee36b80982b7", size = 14704559, upload-time = "2026-05-18T23:35:42.14Z" },
-    { url = "https://files.pythonhosted.org/packages/60/61/23f27c172f022e04025b7dc2367f4d63c1a398120607ec896228649a6f48/numpy-2.4.6-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:d581b735e177fdcdce6fed8e7e8880a3fb6ee4e3653a3ac6af01c6f4c03effc5", size = 5209716, upload-time = "2026-05-18T23:35:45.377Z" },
-    { url = "https://files.pythonhosted.org/packages/03/71/21cf70dc6ea3e3acb95fc53a265b2fc248b981f0194ceb5b475271b8809d/numpy-2.4.6-cp314-cp314-macosx_14_0_x86_64.whl", hash = "sha256:0a041d3d761dc3c35cc56ce0351506a02bcbc25f7b169f652435141a17db9096", size = 6543947, upload-time = "2026-05-18T23:35:47.926Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/91/64288395ee1799bd2e0b04a305dce9666da90c961e1f3fe982a05ee1c036/numpy-2.4.6-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:40fdc1ae7125e518ea98e53e69a4ebc27e1fd50510c47b7ea130cf21e5e1d42b", size = 15685197, upload-time = "2026-05-18T23:35:50.863Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/eb/ebffaa97dc55502df69584a8f0dcf07f69a3e0b3e2323670a2722db9aa39/numpy-2.4.6-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a2c306dea656c12c68f51f4cea133cbe78ca7435eb28c735eac1d3ebe73be6e8", size = 16638245, upload-time = "2026-05-18T23:35:54.752Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/0b/54f9da33128d7e350fab89c7455902eeae70349ee52bddb448dc4a576f45/numpy-2.4.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:33111801a01c12a8a1e3721f0a9232f8cfc8ae2c6b7098167e6f623c6073f402", size = 17036587, upload-time = "2026-05-18T23:35:58.355Z" },
-    { url = "https://files.pythonhosted.org/packages/b6/f0/fdebc1052db1cc37c64beb22072d67cd6d1c71adca1299f53dec2b5e20d3/numpy-2.4.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ae506e6902902557576a26ff33eda8695e7ecb3cb36c3b573a0765dee114ebdb", size = 18363226, upload-time = "2026-05-18T23:36:02.845Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/b4/298628d98c72b57e57f7165ae6a481a1deaf6f3c28262a6e4c739c275930/numpy-2.4.6-cp314-cp314-win32.whl", hash = "sha256:aaf159caa35993cb1f56fb9b8e4610d35758e7ca005412eb1daa856a78c9c4b1", size = 6010196, upload-time = "2026-05-18T23:36:05.92Z" },
-    { url = "https://files.pythonhosted.org/packages/df/ac/46de6dda46478f7942f839e094970be2d4a861e005c4b3bf07c92e291a09/numpy-2.4.6-cp314-cp314-win_amd64.whl", hash = "sha256:b507f5c4c1d508876d1819b6bf9a49d365b96320b5d4993426b33a23ca4b8261", size = 12450334, upload-time = "2026-05-18T23:36:09.107Z" },
-    { url = "https://files.pythonhosted.org/packages/78/92/b8b798ac784102c0da830d2257d59358e3d3d90d1e2b3f2575dad976c5cf/numpy-2.4.6-cp314-cp314-win_arm64.whl", hash = "sha256:6f41ae150c4e32db4f3310cdaf64b1593a03dbabe29eec77fc9b50fe64061df6", size = 10495678, upload-time = "2026-05-18T23:36:12.766Z" },
-    { url = "https://files.pythonhosted.org/packages/30/34/ec28d1aa8115971537c01469ab2011ee96827930f0a124de1000cc2a7ed7/numpy-2.4.6-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ece3d2cfe132e7d51f44a832b303895e6f2d499c5e74dfbdb06ee246147a304a", size = 14823672, upload-time = "2026-05-18T23:36:16.473Z" },
-    { url = "https://files.pythonhosted.org/packages/16/bd/f6d1fede4e54e8042a7ff97bb495510f3c220f94bcd9e8b228e87c92cc0d/numpy-2.4.6-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:e3e5193ef5a3dc73bceee50f7fdc2c90dbb76c42df8d8fae3d1067a583df579e", size = 5328731, upload-time = "2026-05-18T23:36:19.767Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/f0/e105b9e2fd728a9910103884decd6951d9dd73896b914a98d9a231de02ee/numpy-2.4.6-cp314-cp314t-macosx_14_0_x86_64.whl", hash = "sha256:17f9ade344e7d9b464a084d69bcf18fc691cb1db67c62ed80820bf4926d78f0e", size = 6649805, upload-time = "2026-05-18T23:36:22.266Z" },
-    { url = "https://files.pythonhosted.org/packages/82/dd/1206a7ca6ab15e3f02069707ca96222e202af681bb73756da7527f3cb837/numpy-2.4.6-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9cd5ffd25db4e7ba6a375693b3fc0fc1791ec636c17db3720da19bde7180ec43", size = 15730496, upload-time = "2026-05-18T23:36:25.713Z" },
-    { url = "https://files.pythonhosted.org/packages/51/e7/38d3ea825dcab85a591734decb2f6c67caa7c8367d374df1a1c3842f9b07/numpy-2.4.6-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7d92c3819208a60205a12a245c91ad70cb0a85336659b19b834205573ac8456e", size = 16679616, upload-time = "2026-05-18T23:36:29.652Z" },
-    { url = "https://files.pythonhosted.org/packages/93/b7/caabfdf53edf663e0b4eb74d7d405d83baef09eb5e83bcd32d601d72b93e/numpy-2.4.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e85b752a1e912b70eaad4fafbd4d1238007ab221de2009b9a2f5ae7461239895", size = 17085145, upload-time = "2026-05-18T23:36:33.449Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/45/68d7c33a6bcf3e5aa3bdbd57a367e6f615286dfd6482f97e8ffeb734306e/numpy-2.4.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:29cb7f67d10b479ff07c17d33e39f78c07f71c40ef30d63c153d340e96cd3fb4", size = 18403813, upload-time = "2026-05-18T23:36:37.369Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/50/0753655aa844c99cd9e018aacf76f130f1bd81d881bb74bc0aef5d73a8ba/numpy-2.4.6-cp314-cp314t-win32.whl", hash = "sha256:260a5d70215b61ab4fadf5c7baacd64821842975eea312125ed3c39a6391b063", size = 6156982, upload-time = "2026-05-18T23:36:40.817Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/d4/7c67becf668f973cb490cec3e98dfd799d866f9c989a54d355672cfa0db6/numpy-2.4.6-cp314-cp314t-win_amd64.whl", hash = "sha256:81a1cca95ed5bb92aa8b10dd2cdc9a0d3853a50fad926c28b5d7e8ea54389627", size = 12638908, upload-time = "2026-05-18T23:36:43.996Z" },
-    { url = "https://files.pythonhosted.org/packages/43/bb/e1c71a4295b1b1d1393d50dbb4f2a36283c6859d9d3892e84f00ec5a91d5/numpy-2.4.6-cp314-cp314t-win_arm64.whl", hash = "sha256:0c9136e14ed34a9e343a31c533d78a9813a69a3148332bce5e9821cb2f996e66", size = 10565867, upload-time = "2026-05-18T23:36:47.114Z" },
-    { url = "https://files.pythonhosted.org/packages/de/12/b422cc84439adc0d00de605bf4a308890ae5c26f2c71fbd73e5d08fbb0dd/numpy-2.4.6-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:55cced7c52e981362f708ad635198e97a752dfba412cc03c23bbf3bd8d5cd662", size = 16847511, upload-time = "2026-05-18T23:36:50.673Z" },
-    { url = "https://files.pythonhosted.org/packages/44/53/f481bef68011740f8849418d82db07230e825013f31f4eef5ba5b805316a/numpy-2.4.6-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:d6da64deb6b8ed903e7560180a92f2d804ee1ba5eeb849ac2748b8c1aba1f6d7", size = 14889064, upload-time = "2026-05-18T23:36:53.879Z" },
-    { url = "https://files.pythonhosted.org/packages/7f/57/42ed575c10ced8af951d426bc4e1f8aff16fd851db33f067036215a7f860/numpy-2.4.6-pp311-pypy311_pp73-macosx_14_0_arm64.whl", hash = "sha256:68a5124b13fa6cc2086764a20005d30bc0548146f7f5322f02fce212ca14317f", size = 5394157, upload-time = "2026-05-18T23:36:57.194Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/ef/f66cc724fcc36c1e364c67f51ae9146090b8b584f27d58b97fdae3edd737/numpy-2.4.6-pp311-pypy311_pp73-macosx_14_0_x86_64.whl", hash = "sha256:948424b06129ce883307e8cff868c31396d8dc7630a59c61d70d98dbe70f222c", size = 6708728, upload-time = "2026-05-18T23:36:59.575Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/9c/c531f2293b91265d8b48e9b329f54fdd7ffae73cb4134ea10cca4237e9cc/numpy-2.4.6-pp311-pypy311_pp73-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5dbbdb29840ca3d91ee0fece42fc29278886d908280bfec0a5846c6f901a3eb0", size = 15798374, upload-time = "2026-05-18T23:37:02.674Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/b0/413077f6b1153ed3cba361401c6783bbad6114804a000cc22eb71c13e190/numpy-2.4.6-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8ad03c0965fb3c692200e74d458ca28c1dbb4ce96f9a479a8aa041ad5fabca02", size = 16747286, upload-time = "2026-05-18T23:37:06.327Z" },
-    { url = "https://files.pythonhosted.org/packages/15/ce/e5ec180bc41812edcd8daeb8639d205622c0e8c02259d8ab25a0201b3c2a/numpy-2.4.6-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:2803abfebfc990042cd494d8ce2d5f82e9d847af6d35ec486923aa19dbad5e73", size = 12504263, upload-time = "2026-05-18T23:37:09.715Z" },
-]
-
-[[package]]
-name = "nvidia-cublas"
-version = "13.1.1.3"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "nvidia-cuda-nvrtc" },
-]
+sdist = { url = "https://files.pythonhosted.org/packages/65/6e/09db70a523a96d25e115e71cc56a6f9031e7b8cd166c1ac8438307c14058/numpy-1.26.4.tar.gz", hash = "sha256:2a02aba9ed12e4ac4eb3ea9421c420301a0c6460d9830d74a9df87efa4912010", size = 15786129, upload-time = "2024-02-06T00:26:44.495Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a7/a1/0bd24ee8c8d03adac032fd2909426a00c88f8c57961b1277ded97f91119f/nvidia_cublas-13.1.1.3-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:b7a210458267ac818974c53038fbec2e969d5c99f305ab15c72522fa9f001dd5", size = 542848918, upload-time = "2026-04-08T18:46:22.985Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/cd/154ca20c38269e05eff77c1464e6c1da89f50a6390b565e9d82e06bc11e1/nvidia_cublas-13.1.1.3-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:37936a16db8fe4ac1f065c2139360608a543a09275cb1a1af612e08cfa065436", size = 423138758, upload-time = "2026-04-08T18:46:58.655Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/94/ace0fdea5241a27d13543ee117cbc65868e82213fb31a8eb7fe9ff23f313/numpy-1.26.4-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:9ff0f4f29c51e2803569d7a51c2304de5554655a60c5d776e35b4a41413830d0", size = 20631468, upload-time = "2024-02-05T23:48:01.194Z" },
+    { url = "https://files.pythonhosted.org/packages/20/f7/b24208eba89f9d1b58c1668bc6c8c4fd472b20c45573cb767f59d49fb0f6/numpy-1.26.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:2e4ee3380d6de9c9ec04745830fd9e2eccb3e6cf790d39d7b98ffd19b0dd754a", size = 13966411, upload-time = "2024-02-05T23:48:29.038Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/a5/4beee6488160798683eed5bdb7eead455892c3b4e1f78d79d8d3f3b084ac/numpy-1.26.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d209d8969599b27ad20994c8e41936ee0964e6da07478d6c35016bc386b66ad4", size = 14219016, upload-time = "2024-02-05T23:48:54.098Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/d7/ecf66c1cd12dc28b4040b15ab4d17b773b87fa9d29ca16125de01adb36cd/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ffa75af20b44f8dba823498024771d5ac50620e6915abac414251bd971b4529f", size = 18240889, upload-time = "2024-02-05T23:49:25.361Z" },
+    { url = "https://files.pythonhosted.org/packages/24/03/6f229fe3187546435c4f6f89f6d26c129d4f5bed40552899fcf1f0bf9e50/numpy-1.26.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:62b8e4b1e28009ef2846b4c7852046736bab361f7aeadeb6a5b89ebec3c7055a", size = 13876746, upload-time = "2024-02-05T23:49:51.983Z" },
+    { url = "https://files.pythonhosted.org/packages/39/fe/39ada9b094f01f5a35486577c848fe274e374bbf8d8f472e1423a0bbd26d/numpy-1.26.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a4abb4f9001ad2858e7ac189089c42178fcce737e4169dc61321660f1a96c7d2", size = 18078620, upload-time = "2024-02-05T23:50:22.515Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/ef/6ad11d51197aad206a9ad2286dc1aac6a378059e06e8cf22cd08ed4f20dc/numpy-1.26.4-cp310-cp310-win32.whl", hash = "sha256:bfe25acf8b437eb2a8b2d49d443800a5f18508cd811fea3181723922a8a82b07", size = 5972659, upload-time = "2024-02-05T23:50:35.834Z" },
+    { url = "https://files.pythonhosted.org/packages/19/77/538f202862b9183f54108557bfda67e17603fc560c384559e769321c9d92/numpy-1.26.4-cp310-cp310-win_amd64.whl", hash = "sha256:b97fe8060236edf3662adfc2c633f56a08ae30560c56310562cb4f95500022d5", size = 15808905, upload-time = "2024-02-05T23:51:03.701Z" },
+    { url = "https://files.pythonhosted.org/packages/11/57/baae43d14fe163fa0e4c47f307b6b2511ab8d7d30177c491960504252053/numpy-1.26.4-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:4c66707fabe114439db9068ee468c26bbdf909cac0fb58686a42a24de1760c71", size = 20630554, upload-time = "2024-02-05T23:51:50.149Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/2e/151484f49fd03944c4a3ad9c418ed193cfd02724e138ac8a9505d056c582/numpy-1.26.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:edd8b5fe47dab091176d21bb6de568acdd906d1887a4584a15a9a96a1dca06ef", size = 13997127, upload-time = "2024-02-05T23:52:15.314Z" },
+    { url = "https://files.pythonhosted.org/packages/79/ae/7e5b85136806f9dadf4878bf73cf223fe5c2636818ba3ab1c585d0403164/numpy-1.26.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7ab55401287bfec946ced39700c053796e7cc0e3acbef09993a9ad2adba6ca6e", size = 14222994, upload-time = "2024-02-05T23:52:47.569Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/d0/edc009c27b406c4f9cbc79274d6e46d634d139075492ad055e3d68445925/numpy-1.26.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:666dbfb6ec68962c033a450943ded891bed2d54e6755e35e5835d63f4f6931d5", size = 18252005, upload-time = "2024-02-05T23:53:15.637Z" },
+    { url = "https://files.pythonhosted.org/packages/09/bf/2b1aaf8f525f2923ff6cfcf134ae5e750e279ac65ebf386c75a0cf6da06a/numpy-1.26.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:96ff0b2ad353d8f990b63294c8986f1ec3cb19d749234014f4e7eb0112ceba5a", size = 13885297, upload-time = "2024-02-05T23:53:42.16Z" },
+    { url = "https://files.pythonhosted.org/packages/df/a0/4e0f14d847cfc2a633a1c8621d00724f3206cfeddeb66d35698c4e2cf3d2/numpy-1.26.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:60dedbb91afcbfdc9bc0b1f3f402804070deed7392c23eb7a7f07fa857868e8a", size = 18093567, upload-time = "2024-02-05T23:54:11.696Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/b7/a734c733286e10a7f1a8ad1ae8c90f2d33bf604a96548e0a4a3a6739b468/numpy-1.26.4-cp311-cp311-win32.whl", hash = "sha256:1af303d6b2210eb850fcf03064d364652b7120803a0b872f5211f5234b399f20", size = 5968812, upload-time = "2024-02-05T23:54:26.453Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/6b/5610004206cf7f8e7ad91c5a85a8c71b2f2f8051a0c0c4d5916b76d6cbb2/numpy-1.26.4-cp311-cp311-win_amd64.whl", hash = "sha256:cd25bcecc4974d09257ffcd1f098ee778f7834c3ad767fe5db785be9a4aa9cb2", size = 15811913, upload-time = "2024-02-05T23:54:53.933Z" },
+    { url = "https://files.pythonhosted.org/packages/95/12/8f2020a8e8b8383ac0177dc9570aad031a3beb12e38847f7129bacd96228/numpy-1.26.4-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:b3ce300f3644fb06443ee2222c2201dd3a89ea6040541412b8fa189341847218", size = 20335901, upload-time = "2024-02-05T23:55:32.801Z" },
+    { url = "https://files.pythonhosted.org/packages/75/5b/ca6c8bd14007e5ca171c7c03102d17b4f4e0ceb53957e8c44343a9546dcc/numpy-1.26.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:03a8c78d01d9781b28a6989f6fa1bb2c4f2d51201cf99d3dd875df6fbd96b23b", size = 13685868, upload-time = "2024-02-05T23:55:56.28Z" },
+    { url = "https://files.pythonhosted.org/packages/79/f8/97f10e6755e2a7d027ca783f63044d5b1bc1ae7acb12afe6a9b4286eac17/numpy-1.26.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9fad7dcb1aac3c7f0584a5a8133e3a43eeb2fe127f47e3632d43d677c66c102b", size = 13925109, upload-time = "2024-02-05T23:56:20.368Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/50/de23fde84e45f5c4fda2488c759b69990fd4512387a8632860f3ac9cd225/numpy-1.26.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:675d61ffbfa78604709862923189bad94014bef562cc35cf61d3a07bba02a7ed", size = 17950613, upload-time = "2024-02-05T23:56:56.054Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/0c/9c603826b6465e82591e05ca230dfc13376da512b25ccd0894709b054ed0/numpy-1.26.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ab47dbe5cc8210f55aa58e4805fe224dac469cde56b9f731a4c098b91917159a", size = 13572172, upload-time = "2024-02-05T23:57:21.56Z" },
+    { url = "https://files.pythonhosted.org/packages/76/8c/2ba3902e1a0fc1c74962ea9bb33a534bb05984ad7ff9515bf8d07527cadd/numpy-1.26.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:1dda2e7b4ec9dd512f84935c5f126c8bd8b9f2fc001e9f54af255e8c5f16b0e0", size = 17786643, upload-time = "2024-02-05T23:57:56.585Z" },
+    { url = "https://files.pythonhosted.org/packages/28/4a/46d9e65106879492374999e76eb85f87b15328e06bd1550668f79f7b18c6/numpy-1.26.4-cp312-cp312-win32.whl", hash = "sha256:50193e430acfc1346175fcbdaa28ffec49947a06918b7b92130744e81e640110", size = 5677803, upload-time = "2024-02-05T23:58:08.963Z" },
+    { url = "https://files.pythonhosted.org/packages/16/2e/86f24451c2d530c88daf997cb8d6ac622c1d40d19f5a031ed68a4b73a374/numpy-1.26.4-cp312-cp312-win_amd64.whl", hash = "sha256:08beddf13648eb95f8d867350f6a018a4be2e5ad54c8d8caed89ebca558b2818", size = 15517754, upload-time = "2024-02-05T23:58:36.364Z" },
 ]
 
 [[package]]
-name = "nvidia-cuda-cupti"
-version = "13.0.85"
+name = "nvidia-cublas-cu11"
+version = "11.11.3.6"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/2a/2a/80353b103fc20ce05ef51e928daed4b6015db4aaa9162ed0997090fe2250/nvidia_cuda_cupti-13.0.85-py3-none-manylinux_2_25_aarch64.whl", hash = "sha256:796bd679890ee55fb14a94629b698b6db54bcfd833d391d5e94017dd9d7d3151", size = 10310827, upload-time = "2025-09-04T08:26:42.012Z" },
-    { url = "https://files.pythonhosted.org/packages/33/6d/737d164b4837a9bbd202f5ae3078975f0525a55730fe871d8ed4e3b952b0/nvidia_cuda_cupti-13.0.85-py3-none-manylinux_2_25_x86_64.whl", hash = "sha256:4eb01c08e859bf924d222250d2e8f8b8ff6d3db4721288cf35d14252a4d933c8", size = 10715597, upload-time = "2025-09-04T08:26:51.312Z" },
+    { url = "https://files.pythonhosted.org/packages/46/be/c222e33e60d28ecd496a46fc4d78ccae0ee28e1fd7dc705b6288b4cad27e/nvidia_cublas_cu11-11.11.3.6-py3-none-manylinux1_x86_64.whl", hash = "sha256:39fb40e8f486dd8a2ddb8fdeefe1d5b28f5b99df01c87ab3676f057a74a5a6f3", size = 417870452, upload-time = "2022-10-18T21:17:48.638Z" },
+    { url = "https://files.pythonhosted.org/packages/96/df/c5ac9ac5096355c47c606e613ecc7aa50fbccf5e0145df857d11da6464b1/nvidia_cublas_cu11-11.11.3.6-py3-none-manylinux2014_aarch64.whl", hash = "sha256:5ccae9e069a2c6be9af9cb5a0b0c6928c19c7915e390d15f598a1eead2a01a7a", size = 291428448, upload-time = "2024-08-16T23:59:46.358Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/2e/9d99c60771d275ecf6c914a612e9a577f740a615bc826bec132368e1d3ae/nvidia_cublas_cu11-11.11.3.6-py3-none-manylinux2014_x86_64.whl", hash = "sha256:60252822adea5d0b10cd990a7dc7bedf7435f30ae40083c7a624a85a43225abc", size = 417870460, upload-time = "2024-08-17T00:00:26.889Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/1d/7a78cd36fd5e3da4021b3ac2c2c8b2651dd72345b7c3ecc0d3e051884f50/nvidia_cublas_cu11-11.11.3.6-py3-none-win_amd64.whl", hash = "sha256:6ab12b1302bef8ac1ff4414edd1c059e57f4833abef9151683fb8f4de25900be", size = 427234740, upload-time = "2022-10-18T21:21:50.058Z" },
 ]
 
 [[package]]
-name = "nvidia-cuda-nvrtc"
-version = "13.0.88"
+name = "nvidia-cuda-cupti-cu11"
+version = "11.8.87"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c3/68/483a78f5e8f31b08fb1bb671559968c0ca3a065ac7acabfc7cee55214fd6/nvidia_cuda_nvrtc-13.0.88-py3-none-manylinux2010_x86_64.manylinux_2_12_x86_64.whl", hash = "sha256:ad9b6d2ead2435f11cbb6868809d2adeeee302e9bb94bcf0539c7a40d80e8575", size = 90215200, upload-time = "2025-09-04T08:28:44.204Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/dc/6bb80850e0b7edd6588d560758f17e0550893a1feaf436807d64d2da040f/nvidia_cuda_nvrtc-13.0.88-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d27f20a0ca67a4bb34268a5e951033496c5b74870b868bacd046b1b8e0c3267b", size = 43015449, upload-time = "2025-09-04T08:28:20.239Z" },
+    { url = "https://files.pythonhosted.org/packages/27/c9/b4b15f709a694ea9f84871c6c4fbeeb54bab225962d852665a2c6f77f90d/nvidia_cuda_cupti_cu11-11.8.87-py3-none-manylinux1_x86_64.whl", hash = "sha256:0e50c707df56c75a2c0703dc6b886f3c97a22f37d6f63839f75b7418ba672a8d", size = 13093657, upload-time = "2022-10-03T21:46:12.544Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/5a/fb7e315aaa9d2bb28d3f2d9127375823c43646e07db4fe1b08746626e677/nvidia_cuda_cupti_cu11-11.8.87-py3-none-manylinux2014_aarch64.whl", hash = "sha256:9aaa638963a8271df26b6ee0d93b781730b7acc6581ff700bd023d7934e4385e", size = 11687484, upload-time = "2024-08-16T23:56:27.303Z" },
+    { url = "https://files.pythonhosted.org/packages/74/42/9f5c5cc084ce6f3073048c4f6806f45ba4c8c73f227c9587215d9c372e05/nvidia_cuda_cupti_cu11-11.8.87-py3-none-manylinux2014_x86_64.whl", hash = "sha256:4191a17913a706b5098681280cd089cd7d8d3df209a6f5cb79384974a96d24f2", size = 13093662, upload-time = "2024-08-16T23:56:38.082Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/b9/371cff81be29e008a69f1681f468a2b428fa4ea03842196c178cb4cf1991/nvidia_cuda_cupti_cu11-11.8.87-py3-none-win_amd64.whl", hash = "sha256:4332d8550ad5f5b673f98d08e4e4f82030cb604c66d8d5ee919399ea01312e58", size = 9952361, upload-time = "2022-10-03T23:38:14.399Z" },
 ]
 
 [[package]]
-name = "nvidia-cuda-runtime"
-version = "13.0.96"
+name = "nvidia-cuda-nvrtc-cu11"
+version = "11.8.89"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/87/4f/17d7b9b8e285199c58ce28e31b5c5bbaa4d8271af06a89b6405258245de2/nvidia_cuda_runtime-13.0.96-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ef9bcbe90493a2b9d810e43d249adb3d02e98dd30200d86607d8d02687c43f55", size = 2261060, upload-time = "2025-10-09T08:55:15.78Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/24/d1558f3b68b1d26e706813b1d10aa1d785e4698c425af8db8edc3dced472/nvidia_cuda_runtime-13.0.96-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7f82250d7782aa23b6cfe765ecc7db554bd3c2870c43f3d1821f1d18aebf0548", size = 2243632, upload-time = "2025-10-09T08:55:36.117Z" },
+    { url = "https://files.pythonhosted.org/packages/83/08/a9833e4e9f9165bedb7f36033b47aa399b053b9cb2eaf7b84d1e28705cf7/nvidia_cuda_nvrtc_cu11-11.8.89-py3-none-manylinux1_x86_64.whl", hash = "sha256:1f27d67b0f72902e9065ae568b4f6268dfe49ba3ed269c9a3da99bb86d1d2008", size = 23173264, upload-time = "2022-10-03T21:47:00.705Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/ad/58a9f86b0280190582691b1141ac3678c08f698d3d6161eed5cbe4e43b46/nvidia_cuda_nvrtc_cu11-11.8.89-py3-none-manylinux2014_aarch64.whl", hash = "sha256:8ab17ed51e7c4928f7170a0551e3e3b42f89d973bd267ced9688c238b3e10aef", size = 22671777, upload-time = "2024-08-16T23:57:58.688Z" },
+    { url = "https://files.pythonhosted.org/packages/60/44/202e027c224c26e15a53f01c5c7604c7f6b4fd368882d3164ea08fead207/nvidia_cuda_nvrtc_cu11-11.8.89-py3-none-manylinux2014_x86_64.whl", hash = "sha256:a8d02f3cba345be56b1ffc3e74d8f61f02bb758dd31b0f20e12277a5a244f756", size = 23173745, upload-time = "2024-08-16T23:58:16.539Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/19/17745076214b0cc985cfdbabe2b3108f1237704985dab5b748e48432aca1/nvidia_cuda_nvrtc_cu11-11.8.89-py3-none-win_amd64.whl", hash = "sha256:e18a23a8f4064664a6f1c4a64f38c581cbebfb5935280e94a4943ea8ae3791b1", size = 19034935, upload-time = "2022-10-03T23:39:03.211Z" },
 ]
 
 [[package]]
-name = "nvidia-cudnn-cu13"
-version = "9.20.0.48"
+name = "nvidia-cuda-runtime-cu11"
+version = "11.8.89"
 source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "nvidia-cublas" },
-]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/56/c5/83384d846b2fd17c44bd499b36c75a45ed4f095fbbb2252294e89cea5c5c/nvidia_cudnn_cu13-9.20.0.48-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:e31454ae00094b0c55319d9d15b6fa2fc50a9e1c0f5c8c80fb75258234e731e1", size = 444574296, upload-time = "2026-03-09T19:28:27.751Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/5e/edb9c0ae051602c3ccaffe424256463636d639e27d7f302dde9975ef9e7a/nvidia_cudnn_cu13-9.20.0.48-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:0c45dd8eeb50b603f07995b1b300c62ffe6a1980482b82b3bcf94a4ca9d49304", size = 366173588, upload-time = "2026-03-09T19:29:34.474Z" },
+    { url = "https://files.pythonhosted.org/packages/45/3e/84db02be49fe6d6df6e42f69fd64501c22d0f9ada9c9877f885612085d20/nvidia_cuda_runtime_cu11-11.8.89-py3-none-manylinux1_x86_64.whl", hash = "sha256:f587bd726eb2f7612cf77ce38a2c1e65cf23251ff49437f6161ce0d647f64f7c", size = 875585, upload-time = "2022-10-03T21:46:03.05Z" },
+    { url = "https://files.pythonhosted.org/packages/da/16/86d6f3f25c1d69cfcaa01c9a9704b7e946387b7aa13cc2f385b50eb46da5/nvidia_cuda_runtime_cu11-11.8.89-py3-none-manylinux2014_aarch64.whl", hash = "sha256:e53bf160b6b660819cb6e4a9da2cc89e6aa2329858299780a2459780a2b8d012", size = 805995, upload-time = "2024-08-16T23:56:10.507Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/ec/a540f28b31de7bc1ed49eecc72035d4cb77db88ead1d42f7bfa5ae407ac6/nvidia_cuda_runtime_cu11-11.8.89-py3-none-manylinux2014_x86_64.whl", hash = "sha256:92d04069a987e1fbc9213f8376d265df0f7bb42617d44f5eda1f496acea7f2d1", size = 875592, upload-time = "2024-08-16T23:56:18.774Z" },
+    { url = "https://files.pythonhosted.org/packages/48/ae/09f335dfbca630ae213e53d2a9294540620453fe2b37e7489ff05817a525/nvidia_cuda_runtime_cu11-11.8.89-py3-none-win_amd64.whl", hash = "sha256:f60c9fdaed8065b38de8097867240efc5556a8a710007146daeb9082334a6e63", size = 1021163, upload-time = "2022-10-03T23:37:53.656Z" },
 ]
 
 [[package]]
-name = "nvidia-cufft"
-version = "12.0.0.61"
+name = "nvidia-cudnn-cu11"
+version = "9.1.0.70"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-nvjitlink" },
+    { name = "nvidia-cublas-cu11" },
 ]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/8b/ae/f417a75c0259e85c1d2f83ca4e960289a5f814ed0cea74d18c353d3e989d/nvidia_cufft-12.0.0.61-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:2708c852ef8cd89d1d2068bdbece0aa188813a0c934db3779b9b1faa8442e5f5", size = 214053554, upload-time = "2025-09-04T08:31:38.196Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/2f/7b57e29836ea8714f81e9898409196f47d772d5ddedddf1592eadb8ab743/nvidia_cufft-12.0.0.61-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:6c44f692dce8fd5ffd3e3df134b6cdb9c2f72d99cf40b62c32dde45eea9ddad3", size = 214085489, upload-time = "2025-09-04T08:31:56.044Z" },
-]
-
-[[package]]
-name = "nvidia-cufile"
-version = "1.15.1.6"
-source = { registry = "https://pypi.org/simple" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/3f/70/4f193de89a48b71714e74602ee14d04e4019ad36a5a9f20c425776e72cd6/nvidia_cufile-1.15.1.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:08a3ecefae5a01c7f5117351c64f17c7c62efa5fffdbe24fc7d298da19cd0b44", size = 1223672, upload-time = "2025-09-04T08:32:22.779Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/73/cc4a14c9813a8a0d509417cf5f4bdaba76e924d58beb9864f5a7baceefbf/nvidia_cufile-1.15.1.6-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:bdc0deedc61f548bddf7733bdc216456c2fdb101d020e1ab4b88d232d5e2f6d1", size = 1136992, upload-time = "2025-09-04T08:32:14.119Z" },
+    { url = "https://files.pythonhosted.org/packages/00/3b/0b776f04e364cd99e4cf152c2a9eadb5934c67c9a91429da55169a9447fd/nvidia_cudnn_cu11-9.1.0.70-py3-none-manylinux2014_x86_64.whl", hash = "sha256:e6135ac63fe9d5b0b89cfb35c3fc1c1349f2b995becadf2e9dc21bca89d9633d", size = 663919573, upload-time = "2024-04-22T15:20:24.839Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/66/c0d600fa64b65e474eced8f07c4a6e9441aacf746f800fd12fe395dd09db/nvidia_cudnn_cu11-9.1.0.70-py3-none-win_amd64.whl", hash = "sha256:32f6a2fe80b4b7ebc5f9c4cb403c4c381eca99e6daa3cf38241047b3d3e14daa", size = 680107132, upload-time = "2024-04-22T15:21:08.134Z" },
 ]
 
 [[package]]
-name = "nvidia-curand"
-version = "10.4.0.35"
+name = "nvidia-cufft-cu11"
+version = "10.9.0.58"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1e/72/7c2ae24fb6b63a32e6ae5d241cc65263ea18d08802aaae087d9f013335a2/nvidia_curand-10.4.0.35-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:133df5a7509c3e292aaa2b477afd0194f06ce4ea24d714d616ff36439cee349a", size = 61962106, upload-time = "2025-08-04T10:21:41.128Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/9f/be0a41ca4a4917abf5cb9ae0daff1a6060cc5de950aec0396de9f3b52bc5/nvidia_curand-10.4.0.35-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:1aee33a5da6e1db083fe2b90082def8915f30f3248d5896bcec36a579d941bfc", size = 59544258, upload-time = "2025-08-04T10:22:03.992Z" },
+    { url = "https://files.pythonhosted.org/packages/74/79/b912a77e38e41f15a0581a59f5c3548d1ddfdda3225936fb67c342719e7a/nvidia_cufft_cu11-10.9.0.58-py3-none-manylinux1_x86_64.whl", hash = "sha256:222f9da70c80384632fd6035e4c3f16762d64ea7a843829cb278f98b3cb7dd81", size = 168405414, upload-time = "2022-10-03T23:29:47.505Z" },
+    { url = "https://files.pythonhosted.org/packages/71/7a/a2ad9951d57c3cc23f4fa6d84b146afd9f375ffbc744b38935930ac4393f/nvidia_cufft_cu11-10.9.0.58-py3-none-manylinux2014_aarch64.whl", hash = "sha256:34b7315104e615b230dc3c2d1861f13bff9ec465c5d3b4bb65b4986d03a1d8d4", size = 111231060, upload-time = "2024-08-17T00:00:57.04Z" },
+    { url = "https://files.pythonhosted.org/packages/64/c8/133717b43182ba063803e983e7680a94826a9f4ff5734af0ca315803f1b3/nvidia_cufft_cu11-10.9.0.58-py3-none-manylinux2014_x86_64.whl", hash = "sha256:e21037259995243cc370dd63c430d77ae9280bedb68d5b5a18226bfc92e5d748", size = 168405419, upload-time = "2024-08-17T00:02:03.562Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/b4/e432a74f8db0e84f734dc14d36c0e529225132bf7e239da21f55893351a6/nvidia_cufft_cu11-10.9.0.58-py3-none-win_amd64.whl", hash = "sha256:c4d316f17c745ec9c728e30409612eaf77a8404c3733cdf6c9c1569634d1ca03", size = 172237004, upload-time = "2022-10-03T23:39:58.288Z" },
 ]
 
 [[package]]
-name = "nvidia-cusolver"
-version = "12.0.4.66"
+name = "nvidia-curand-cu11"
+version = "10.3.0.86"
 source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "nvidia-cublas" },
-    { name = "nvidia-cusparse" },
-    { name = "nvidia-nvjitlink" },
-]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c8/c3/b30c9e935fc01e3da443ec0116ed1b2a009bb867f5324d3f2d7e533e776b/nvidia_cusolver-12.0.4.66-py3-none-manylinux_2_27_aarch64.whl", hash = "sha256:02c2457eaa9e39de20f880f4bd8820e6a1cfb9f9a34f820eb12a155aa5bc92d2", size = 223467760, upload-time = "2025-09-04T08:33:04.222Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/67/cba3777620cdacb99102da4042883709c41c709f4b6323c10781a9c3aa34/nvidia_cusolver-12.0.4.66-py3-none-manylinux_2_27_x86_64.whl", hash = "sha256:0a759da5dea5c0ea10fd307de75cdeb59e7ea4fcb8add0924859b944babf1112", size = 200941980, upload-time = "2025-09-04T08:33:22.767Z" },
+    { url = "https://files.pythonhosted.org/packages/49/28/c47f8e2439ddbcbeae3cf74d43ed572b651d630ea72863d5357f3759eb66/nvidia_curand_cu11-10.3.0.86-py3-none-manylinux1_x86_64.whl", hash = "sha256:ac439548c88580269a1eb6aeb602a5aed32f0dbb20809a31d9ed7d01d77f6bf5", size = 58124493, upload-time = "2022-10-03T23:30:05.413Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/c0/aec095de6cb3b07197042f9ff8958eda2a5eaaefabc8db2e3bfa32aafb97/nvidia_curand_cu11-10.3.0.86-py3-none-manylinux2014_aarch64.whl", hash = "sha256:64defc3016d8c1de351a764617818c2961210430f12476faee10084b269b188c", size = 58134524, upload-time = "2024-08-17T00:02:48.788Z" },
+    { url = "https://files.pythonhosted.org/packages/58/e5/ce5806afc48a6e4e0dddd25316ac60b6fa94fd1791bdbf4ca17bf52696ea/nvidia_curand_cu11-10.3.0.86-py3-none-manylinux2014_x86_64.whl", hash = "sha256:cd4cffbf78bb06580206b4814d5dc696d1161c902aae37b2bba00056832379e6", size = 58124497, upload-time = "2024-08-17T00:03:01.833Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/e0/a68e20f37512c2ff22c1b2707383faec80acc20c39727e4007065ed284ea/nvidia_curand_cu11-10.3.0.86-py3-none-win_amd64.whl", hash = "sha256:8fa8365065fc3e3760d7437b08f164a6bcf8f7124f3b544d2463ded01e6bdc70", size = 57597791, upload-time = "2022-10-03T23:40:27.142Z" },
 ]
 
 [[package]]
-name = "nvidia-cusparse"
-version = "12.6.3.3"
+name = "nvidia-cusolver-cu11"
+version = "11.4.1.48"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-nvjitlink" },
+    { name = "nvidia-cublas-cu11" },
 ]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f8/94/5c26f33738ae35276672f12615a64bd008ed5be6d1ebcb23579285d960a9/nvidia_cusparse-12.6.3.3-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:80bcc4662f23f1054ee334a15c72b8940402975e0eab63178fc7e670aa59472c", size = 162155568, upload-time = "2025-09-04T08:33:42.864Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/18/623c77619c31d62efd55302939756966f3ecc8d724a14dab2b75f1508850/nvidia_cusparse-12.6.3.3-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2b3c89c88d01ee0e477cb7f82ef60a11a4bcd57b6b87c33f789350b59759360b", size = 145942937, upload-time = "2025-09-04T08:33:58.029Z" },
+    { url = "https://files.pythonhosted.org/packages/55/ee/939ff0104991dd7bdabb4c9767994c612ba0e1c9a55672a1ddd42f5e5b16/nvidia_cusolver_cu11-11.4.1.48-py3-none-manylinux1_x86_64.whl", hash = "sha256:ca538f545645b7e6629140786d3127fe067b3d5a085bd794cde5bfe877c8926f", size = 128240842, upload-time = "2022-10-03T23:30:24.348Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/32/676f0cfea4ff5bbc6dcfe00b5f385ba49d322dc8e9ff1ef864b570e27e9e/nvidia_cusolver_cu11-11.4.1.48-py3-none-manylinux2014_aarch64.whl", hash = "sha256:1a96acb05768610bc414dbef5b25ebd2d820fc8a1e8c72097f41f53d80934d61", size = 127903177, upload-time = "2024-08-17T00:03:20.657Z" },
+    { url = "https://files.pythonhosted.org/packages/52/fe/866e87e6e6a1b0a5fcf8524a058042656702f2057e22bfdb8899a7c38e10/nvidia_cusolver_cu11-11.4.1.48-py3-none-manylinux2014_x86_64.whl", hash = "sha256:ea9fb1ad8c644ca9ed55af13cc39af3b7ba4c3eb5aef18471fe1fe77d94383cb", size = 128246438, upload-time = "2024-08-17T00:03:52.432Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/94/4fd658d09776307b98411eca09dd77773d8c3bdc484b186a2084038b75e2/nvidia_cusolver_cu11-11.4.1.48-py3-none-win_amd64.whl", hash = "sha256:7efe43b113495a64e2cf9a0b4365bd53b0a82afb2e2cf91e9f993c9ef5e69ee8", size = 125732382, upload-time = "2022-10-03T23:40:44.179Z" },
 ]
 
 [[package]]
-name = "nvidia-cusparselt-cu13"
-version = "0.8.1"
+name = "nvidia-cusparse-cu11"
+version = "11.7.5.86"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/46/e1/cdc1797eadf82d3a9a575a19b33fdc871a97edbec42c00b5b5e914f4aff4/nvidia_cusparselt_cu13-0.8.1-py3-none-manylinux2014_aarch64.whl", hash = "sha256:4dca476c50bf4780d46cd0bfbd82e2bc10a08e4fef7950917ce8d7578d22a23f", size = 221051344, upload-time = "2025-09-05T18:49:51.289Z" },
-    { url = "https://files.pythonhosted.org/packages/34/7d/2661f2fb3ac4302f3a246f5fc030213ac60c1fe0bce84f9783dbd831dbb7/nvidia_cusparselt_cu13-0.8.1-py3-none-manylinux2014_x86_64.whl", hash = "sha256:786ce87568c303fadb5afcc7102d454cd3040d75f6f8626f5db460d1871f4dd0", size = 170148586, upload-time = "2025-09-05T18:50:50.248Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/e0/21b829c535d569831835a4ca5d049a19ba00d3e91f3e12ab4ad27bd7385f/nvidia_cusparse_cu11-11.7.5.86-py3-none-manylinux1_x86_64.whl", hash = "sha256:4ae709fe78d3f23f60acaba8c54b8ad556cf16ca486e0cc1aa92dca7555d2d2b", size = 204126221, upload-time = "2022-10-18T21:19:28.04Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/6e/4eb2842e7ab1804072bca43030a8b92731e5a35f6a4a1b8f1aa8fa5f411c/nvidia_cusparse_cu11-11.7.5.86-py3-none-manylinux2014_aarch64.whl", hash = "sha256:6c7da46abee7567e619d4aa2e90a1b032cfcbd1211d429853b1a6e87514a14b2", size = 203917797, upload-time = "2024-08-17T00:04:22.798Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/5c/b0333b07c51ced77397c2fb0d9826072cea0da9d421aa7e792aa0f8ecc72/nvidia_cusparse_cu11-11.7.5.86-py3-none-manylinux2014_x86_64.whl", hash = "sha256:8d7cf1628fd8d462b5d2ba6678fae34733a48ecb80495b9c68672ec6a6dde5ef", size = 204126227, upload-time = "2024-08-17T00:05:20.798Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/36/a670e8ca1deccd3c63be4d0286491cf5c6375253f0d948e7cc5167fe1da9/nvidia_cusparse_cu11-11.7.5.86-py3-none-win_amd64.whl", hash = "sha256:a0f6ee81cd91be606fc2f55992d06b09cd4e86d74b6ae5e8dd1631cf7f5a8706", size = 203420667, upload-time = "2022-10-18T21:22:55.982Z" },
 ]
 
 [[package]]
@@ -2060,39 +1377,22 @@ wheels = [
 ]
 
 [[package]]
-name = "nvidia-nccl-cu13"
-version = "2.29.7"
-source = { registry = "https://pypi.org/simple" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/72/0d/daf50d44177ee0cbc7ff0a0c91eb5ff676c82be42f9a970bc7597f440c3a/nvidia_nccl_cu13-2.29.7-py3-none-manylinux_2_18_aarch64.whl", hash = "sha256:674a12383e3c38a1bcccae7d4f3633b37852230b6047883cb2f4c2d1b36d9bf5", size = 206014712, upload-time = "2026-03-03T05:34:20.843Z" },
-    { url = "https://files.pythonhosted.org/packages/67/f4/58e4e91b6919367c7aafb8e36fce9aad1a3047e536bf7e2fd560927d3a4c/nvidia_nccl_cu13-2.29.7-py3-none-manylinux_2_18_x86_64.whl", hash = "sha256:edd81538446786ec3b73972543e53bb43bcaf0bfc8ef76cb679fcc390ffe136d", size = 205976000, upload-time = "2026-03-03T05:36:24.472Z" },
-]
-
-[[package]]
-name = "nvidia-nvjitlink"
-version = "13.0.88"
-source = { registry = "https://pypi.org/simple" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/56/7a/123e033aaff487c77107195fa5a2b8686795ca537935a24efae476c41f05/nvidia_nvjitlink-13.0.88-py3-none-manylinux2010_x86_64.manylinux_2_12_x86_64.whl", hash = "sha256:13a74f429e23b921c1109976abefacc69835f2f433ebd323d3946e11d804e47b", size = 40713933, upload-time = "2025-09-04T08:35:43.553Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/2c/93c5250e64df4f894f1cbb397c6fd71f79813f9fd79d7cd61de3f97b3c2d/nvidia_nvjitlink-13.0.88-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:e931536ccc7d467a98ba1d8b89ff7fa7f1fa3b13f2b0069118cd7f47bff07d0c", size = 38768748, upload-time = "2025-09-04T08:35:20.008Z" },
-]
-
-[[package]]
-name = "nvidia-nvshmem-cu13"
-version = "3.4.5"
+name = "nvidia-nccl-cu11"
+version = "2.21.5"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/dc/0f/05cc9c720236dcd2db9c1ab97fff629e96821be2e63103569da0c9b72f19/nvidia_nvshmem_cu13-3.4.5-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6dc2a197f38e5d0376ad52cd1a2a3617d3cdc150fd5966f4aee9bcebb1d68fe9", size = 60215947, upload-time = "2025-09-06T00:32:20.022Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/35/a9bf80a609e74e3b000fef598933235c908fcefcef9026042b8e6dfde2a9/nvidia_nvshmem_cu13-3.4.5-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:290f0a2ee94c9f3687a02502f3b9299a9f9fe826e6d0287ee18482e78d495b80", size = 60412546, upload-time = "2025-09-06T00:32:41.564Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/9a/8b6a28b3b87d5fddab0e92cd835339eb8fbddaa71ae67518c8c1b3d05bae/nvidia_nccl_cu11-2.21.5-py3-none-manylinux2014_x86_64.whl", hash = "sha256:49d8350629c7888701d1fd200934942671cb5c728f49acc5a0b3a768820bed29", size = 147811630, upload-time = "2024-04-03T15:33:12.879Z" },
 ]
 
 [[package]]
-name = "nvidia-nvtx"
-version = "13.0.85"
+name = "nvidia-nvtx-cu11"
+version = "11.8.86"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c2/f3/d86c845465a2723ad7e1e5c36dcd75ddb82898b3f53be47ebd429fb2fa5d/nvidia_nvtx-13.0.85-py3-none-manylinux1_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:4936d1d6780fbe68db454f5e72a42ff64d1fd6397df9f363ae786930fd5c1cd4", size = 148047, upload-time = "2025-09-04T08:29:01.761Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/64/3708a90d1ebe202ffdeb7185f878a3c84d15c2b2c31858da2ce0583e2def/nvidia_nvtx-13.0.85-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:cb7780edb6b14107373c835bf8b72e7a178bac7367e23da7acb108f973f157a6", size = 148878, upload-time = "2025-09-04T08:28:53.627Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/a2/23214c23118784dc2189ac2d2e48190df3e4206e2f73eb17d47140797a2b/nvidia_nvtx_cu11-11.8.86-py3-none-manylinux1_x86_64.whl", hash = "sha256:890656d8bd9b4e280231c832e1f0d03459200ba4824ddda3dcb59b1e1989b9f5", size = 99125, upload-time = "2022-10-03T21:47:19.565Z" },
+    { url = "https://files.pythonhosted.org/packages/42/b9/385e4323646d21f9aedb9e953e5c778311cd8df32eb2237f1ce242c58572/nvidia_nvtx_cu11-11.8.86-py3-none-manylinux2014_aarch64.whl", hash = "sha256:5e84b97062eb102b45a8a9172a06cfe28b239b1635075a13d6474e91295e0468", size = 100401, upload-time = "2024-08-16T23:58:25.484Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/ad/973a187b137a3d45dc3faac421ef1275fb41fc169fd3889e2d5ceb0daa54/nvidia_nvtx_cu11-11.8.86-py3-none-manylinux2014_x86_64.whl", hash = "sha256:979f5b2aef5da164c5c53c64c85c3dfa61b8b4704f4f963bb568bf98fa8472e8", size = 99130, upload-time = "2024-08-16T23:58:33.479Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/3f/0e1dd2bc4d89f838b86c76956ffa514307d3be4d8b5ee0da4e9d12a8b54b/nvidia_nvtx_cu11-11.8.86-py3-none-win_amd64.whl", hash = "sha256:54031010ee38d774b2991004d88f90bbd7bbc1458a96bbc4b42662756508c252", size = 66297, upload-time = "2022-10-03T23:39:12.132Z" },
 ]
 
 [[package]]
@@ -2112,14 +1412,13 @@ name = "ophyd"
 version = "1.11.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "numpy" },
     { name = "opentelemetry-api" },
     { name = "packaging" },
-    { name = "pint", version = "0.24.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "pint", version = "0.25.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "pint", version = "0.24.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pint", version = "0.25.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/3b/4a/d41c587299c62dcee80af425e29fddb96ba6ee8d8cd83d05acc959316554/ophyd-1.11.1.tar.gz", hash = "sha256:c813fa90f7d070b8da2a875ace9f50193a29d4c4555838c9c766947d971bbb9c", size = 313339, upload-time = "2026-03-31T19:03:33.948Z" }
 wheels = [
@@ -2183,56 +1482,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/be/42/025cfe05d1be22dbfdb4f264fe9de1ccda83f66e4fc3aac94748e784af04/pillow-12.2.0-cp312-cp312-win32.whl", hash = "sha256:58f62cc0f00fd29e64b29f4fd923ffdb3859c9f9e6105bfc37ba1d08994e8940", size = 6378489, upload-time = "2026-04-01T14:43:34.601Z" },
     { url = "https://files.pythonhosted.org/packages/5d/7b/25a221d2c761c6a8ae21bfa3874988ff2583e19cf8a27bf2fee358df7942/pillow-12.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:7f84204dee22a783350679a0333981df803dac21a0190d706a50475e361c93f5", size = 7084129, upload-time = "2026-04-01T14:43:37.213Z" },
     { url = "https://files.pythonhosted.org/packages/10/e1/542a474affab20fd4a0f1836cb234e8493519da6b76899e30bcc5d990b8b/pillow-12.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:af73337013e0b3b46f175e79492d96845b16126ddf79c438d7ea7ff27783a414", size = 2463612, upload-time = "2026-04-01T14:43:39.421Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/01/53d10cf0dbad820a8db274d259a37ba50b88b24768ddccec07355382d5ad/pillow-12.2.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:8297651f5b5679c19968abefd6bb84d95fe30ef712eb1b2d9b2d31ca61267f4c", size = 4100837, upload-time = "2026-04-01T14:43:41.506Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/98/f3a6657ecb698c937f6c76ee564882945f29b79bad496abcba0e84659ec5/pillow-12.2.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:50d8520da2a6ce0af445fa6d648c4273c3eeefbc32d7ce049f22e8b5c3daecc2", size = 4176528, upload-time = "2026-04-01T14:43:43.773Z" },
-    { url = "https://files.pythonhosted.org/packages/69/bc/8986948f05e3ea490b8442ea1c1d4d990b24a7e43d8a51b2c7d8b1dced36/pillow-12.2.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:766cef22385fa1091258ad7e6216792b156dc16d8d3fa607e7545b2b72061f1c", size = 3640401, upload-time = "2026-04-01T14:43:45.87Z" },
-    { url = "https://files.pythonhosted.org/packages/34/46/6c717baadcd62bc8ed51d238d521ab651eaa74838291bda1f86fe1f864c9/pillow-12.2.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5d2fd0fa6b5d9d1de415060363433f28da8b1526c1c129020435e186794b3795", size = 5308094, upload-time = "2026-04-01T14:43:48.438Z" },
-    { url = "https://files.pythonhosted.org/packages/71/43/905a14a8b17fdb1ccb58d282454490662d2cb89a6bfec26af6d3520da5ec/pillow-12.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:56b25336f502b6ed02e889f4ece894a72612fe885889a6e8c4c80239ff6e5f5f", size = 4695402, upload-time = "2026-04-01T14:43:51.292Z" },
-    { url = "https://files.pythonhosted.org/packages/73/dd/42107efcb777b16fa0393317eac58f5b5cf30e8392e266e76e51cff28c3d/pillow-12.2.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:f1c943e96e85df3d3478f7b691f229887e143f81fedab9b20205349ab04d73ed", size = 6280005, upload-time = "2026-04-01T14:43:54.242Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/68/b93e09e5e8549019e61acf49f65b1a8530765a7f812c77a7461bca7e4494/pillow-12.2.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:03f6fab9219220f041c74aeaa2939ff0062bd5c364ba9ce037197f4c6d498cd9", size = 8090669, upload-time = "2026-04-01T14:43:57.335Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/6e/3ccb54ce8ec4ddd1accd2d89004308b7b0b21c4ac3d20fa70af4760a4330/pillow-12.2.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5cdfebd752ec52bf5bb4e35d9c64b40826bc5b40a13df7c3cda20a2c03a0f5ed", size = 6395194, upload-time = "2026-04-01T14:43:59.864Z" },
-    { url = "https://files.pythonhosted.org/packages/67/ee/21d4e8536afd1a328f01b359b4d3997b291ffd35a237c877b331c1c3b71c/pillow-12.2.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:eedf4b74eda2b5a4b2b2fb4c006d6295df3bf29e459e198c90ea48e130dc75c3", size = 7082423, upload-time = "2026-04-01T14:44:02.74Z" },
-    { url = "https://files.pythonhosted.org/packages/78/5f/e9f86ab0146464e8c133fe85df987ed9e77e08b29d8d35f9f9f4d6f917ba/pillow-12.2.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:00a2865911330191c0b818c59103b58a5e697cae67042366970a6b6f1b20b7f9", size = 6505667, upload-time = "2026-04-01T14:44:05.381Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/1e/409007f56a2fdce61584fd3acbc2bbc259857d555196cedcadc68c015c82/pillow-12.2.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1e1757442ed87f4912397c6d35a0db6a7b52592156014706f17658ff58bbf795", size = 7208580, upload-time = "2026-04-01T14:44:08.39Z" },
-    { url = "https://files.pythonhosted.org/packages/23/c4/7349421080b12fb35414607b8871e9534546c128a11965fd4a7002ccfbee/pillow-12.2.0-cp313-cp313-win32.whl", hash = "sha256:144748b3af2d1b358d41286056d0003f47cb339b8c43a9ea42f5fea4d8c66b6e", size = 6375896, upload-time = "2026-04-01T14:44:11.197Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/82/8a3739a5e470b3c6cbb1d21d315800d8e16bff503d1f16b03a4ec3212786/pillow-12.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:390ede346628ccc626e5730107cde16c42d3836b89662a115a921f28440e6a3b", size = 7081266, upload-time = "2026-04-01T14:44:13.947Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/25/f968f618a062574294592f668218f8af564830ccebdd1fa6200f598e65c5/pillow-12.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:8023abc91fba39036dbce14a7d6535632f99c0b857807cbbbf21ecc9f4717f06", size = 2463508, upload-time = "2026-04-01T14:44:16.312Z" },
-    { url = "https://files.pythonhosted.org/packages/4d/a4/b342930964e3cb4dce5038ae34b0eab4653334995336cd486c5a8c25a00c/pillow-12.2.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:042db20a421b9bafecc4b84a8b6e444686bd9d836c7fd24542db3e7df7baad9b", size = 5309927, upload-time = "2026-04-01T14:44:18.89Z" },
-    { url = "https://files.pythonhosted.org/packages/9f/de/23198e0a65a9cf06123f5435a5d95cea62a635697f8f03d134d3f3a96151/pillow-12.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:dd025009355c926a84a612fecf58bb315a3f6814b17ead51a8e48d3823d9087f", size = 4698624, upload-time = "2026-04-01T14:44:21.115Z" },
-    { url = "https://files.pythonhosted.org/packages/01/a6/1265e977f17d93ea37aa28aa81bad4fa597933879fac2520d24e021c8da3/pillow-12.2.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:88ddbc66737e277852913bd1e07c150cc7bb124539f94c4e2df5344494e0a612", size = 6321252, upload-time = "2026-04-01T14:44:23.663Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/83/5982eb4a285967baa70340320be9f88e57665a387e3a53a7f0db8231a0cd/pillow-12.2.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d362d1878f00c142b7e1a16e6e5e780f02be8195123f164edf7eddd911eefe7c", size = 8126550, upload-time = "2026-04-01T14:44:26.772Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/48/6ffc514adce69f6050d0753b1a18fd920fce8cac87620d5a31231b04bfc5/pillow-12.2.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2c727a6d53cb0018aadd8018c2b938376af27914a68a492f59dfcaca650d5eea", size = 6433114, upload-time = "2026-04-01T14:44:29.615Z" },
-    { url = "https://files.pythonhosted.org/packages/36/a3/f9a77144231fb8d40ee27107b4463e205fa4677e2ca2548e14da5cf18dce/pillow-12.2.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:efd8c21c98c5cc60653bcb311bef2ce0401642b7ce9d09e03a7da87c878289d4", size = 7115667, upload-time = "2026-04-01T14:44:32.773Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/fc/ac4ee3041e7d5a565e1c4fd72a113f03b6394cc72ab7089d27608f8aaccb/pillow-12.2.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9f08483a632889536b8139663db60f6724bfcb443c96f1b18855860d7d5c0fd4", size = 6538966, upload-time = "2026-04-01T14:44:35.252Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/a8/27fb307055087f3668f6d0a8ccb636e7431d56ed0750e07a60547b1e083e/pillow-12.2.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:dac8d77255a37e81a2efcbd1fc05f1c15ee82200e6c240d7e127e25e365c39ea", size = 7238241, upload-time = "2026-04-01T14:44:37.875Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/4b/926ab182c07fccae9fcb120043464e1ff1564775ec8864f21a0ebce6ac25/pillow-12.2.0-cp313-cp313t-win32.whl", hash = "sha256:ee3120ae9dff32f121610bb08e4313be87e03efeadfc6c0d18f89127e24d0c24", size = 6379592, upload-time = "2026-04-01T14:44:40.336Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/c4/f9e476451a098181b30050cc4c9a3556b64c02cf6497ea421ac047e89e4b/pillow-12.2.0-cp313-cp313t-win_amd64.whl", hash = "sha256:325ca0528c6788d2a6c3d40e3568639398137346c3d6e66bb61db96b96511c98", size = 7085542, upload-time = "2026-04-01T14:44:43.251Z" },
-    { url = "https://files.pythonhosted.org/packages/00/a4/285f12aeacbe2d6dc36c407dfbbe9e96d4a80b0fb710a337f6d2ad978c75/pillow-12.2.0-cp313-cp313t-win_arm64.whl", hash = "sha256:2e5a76d03a6c6dcef67edabda7a52494afa4035021a79c8558e14af25313d453", size = 2465765, upload-time = "2026-04-01T14:44:45.996Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/98/4595daa2365416a86cb0d495248a393dfc84e96d62ad080c8546256cb9c0/pillow-12.2.0-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:3adc9215e8be0448ed6e814966ecf3d9952f0ea40eb14e89a102b87f450660d8", size = 4100848, upload-time = "2026-04-01T14:44:48.48Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/79/40184d464cf89f6663e18dfcf7ca21aae2491fff1a16127681bf1fa9b8cf/pillow-12.2.0-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:6a9adfc6d24b10f89588096364cc726174118c62130c817c2837c60cf08a392b", size = 4176515, upload-time = "2026-04-01T14:44:51.353Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/63/703f86fd4c422a9cf722833670f4f71418fb116b2853ff7da722ea43f184/pillow-12.2.0-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:6a6e67ea2e6feda684ed370f9a1c52e7a243631c025ba42149a2cc5934dec295", size = 3640159, upload-time = "2026-04-01T14:44:53.588Z" },
-    { url = "https://files.pythonhosted.org/packages/71/e0/fb22f797187d0be2270f83500aab851536101b254bfa1eae10795709d283/pillow-12.2.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:2bb4a8d594eacdfc59d9e5ad972aa8afdd48d584ffd5f13a937a664c3e7db0ed", size = 5312185, upload-time = "2026-04-01T14:44:56.039Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/8c/1a9e46228571de18f8e28f16fabdfc20212a5d019f3e3303452b3f0a580d/pillow-12.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:80b2da48193b2f33ed0c32c38140f9d3186583ce7d516526d462645fd98660ae", size = 4695386, upload-time = "2026-04-01T14:44:58.663Z" },
-    { url = "https://files.pythonhosted.org/packages/70/62/98f6b7f0c88b9addd0e87c217ded307b36be024d4ff8869a812b241d1345/pillow-12.2.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:22db17c68434de69d8ecfc2fe821569195c0c373b25cccb9cbdacf2c6e53c601", size = 6280384, upload-time = "2026-04-01T14:45:01.5Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/03/688747d2e91cfbe0e64f316cd2e8005698f76ada3130d0194664174fa5de/pillow-12.2.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7b14cc0106cd9aecda615dd6903840a058b4700fcb817687d0ee4fc8b6e389be", size = 8091599, upload-time = "2026-04-01T14:45:04.5Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/35/577e22b936fcdd66537329b33af0b4ccfefaeabd8aec04b266528cddb33c/pillow-12.2.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8cbeb542b2ebc6fcdacabf8aca8c1a97c9b3ad3927d46b8723f9d4f033288a0f", size = 6396021, upload-time = "2026-04-01T14:45:07.117Z" },
-    { url = "https://files.pythonhosted.org/packages/11/8d/d2532ad2a603ca2b93ad9f5135732124e57811d0168155852f37fbce2458/pillow-12.2.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4bfd07bc812fbd20395212969e41931001fd59eb55a60658b0e5710872e95286", size = 7083360, upload-time = "2026-04-01T14:45:09.763Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/26/d325f9f56c7e039034897e7380e9cc202b1e368bfd04d4cbe6a441f02885/pillow-12.2.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9aba9a17b623ef750a4d11b742cbafffeb48a869821252b30ee21b5e91392c50", size = 6507628, upload-time = "2026-04-01T14:45:12.378Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/f7/769d5632ffb0988f1c5e7660b3e731e30f7f8ec4318e94d0a5d674eb65a4/pillow-12.2.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:deede7c263feb25dba4e82ea23058a235dcc2fe1f6021025dc71f2b618e26104", size = 7209321, upload-time = "2026-04-01T14:45:15.122Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/7a/c253e3c645cd47f1aceea6a8bacdba9991bf45bb7dfe927f7c893e89c93c/pillow-12.2.0-cp314-cp314-win32.whl", hash = "sha256:632ff19b2778e43162304d50da0181ce24ac5bb8180122cbe1bf4673428328c7", size = 6479723, upload-time = "2026-04-01T14:45:17.797Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/8b/601e6566b957ca50e28725cb6c355c59c2c8609751efbecd980db44e0349/pillow-12.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:4e6c62e9d237e9b65fac06857d511e90d8461a32adcc1b9065ea0c0fa3a28150", size = 7217400, upload-time = "2026-04-01T14:45:20.529Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/94/220e46c73065c3e2951bb91c11a1fb636c8c9ad427ac3ce7d7f3359b9b2f/pillow-12.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:b1c1fbd8a5a1af3412a0810d060a78b5136ec0836c8a4ef9aa11807f2a22f4e1", size = 2554835, upload-time = "2026-04-01T14:45:23.162Z" },
-    { url = "https://files.pythonhosted.org/packages/b6/ab/1b426a3974cb0e7da5c29ccff4807871d48110933a57207b5a676cccc155/pillow-12.2.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:57850958fe9c751670e49b2cecf6294acc99e562531f4bd317fa5ddee2068463", size = 5314225, upload-time = "2026-04-01T14:45:25.637Z" },
-    { url = "https://files.pythonhosted.org/packages/19/1e/dce46f371be2438eecfee2a1960ee2a243bbe5e961890146d2dee1ff0f12/pillow-12.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:d5d38f1411c0ed9f97bcb49b7bd59b6b7c314e0e27420e34d99d844b9ce3b6f3", size = 4698541, upload-time = "2026-04-01T14:45:28.355Z" },
-    { url = "https://files.pythonhosted.org/packages/55/c3/7fbecf70adb3a0c33b77a300dc52e424dc22ad8cdc06557a2e49523b703d/pillow-12.2.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5c0a9f29ca8e79f09de89293f82fc9b0270bb4af1d58bc98f540cc4aedf03166", size = 6322251, upload-time = "2026-04-01T14:45:30.924Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/3c/7fbc17cfb7e4fe0ef1642e0abc17fc6c94c9f7a16be41498e12e2ba60408/pillow-12.2.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:1610dd6c61621ae1cf811bef44d77e149ce3f7b95afe66a4512f8c59f25d9ebe", size = 8127807, upload-time = "2026-04-01T14:45:33.908Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/c3/a8ae14d6defd2e448493ff512fae903b1e9bd40b72efb6ec55ce0048c8ce/pillow-12.2.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0a34329707af4f73cf1782a36cd2289c0368880654a2c11f027bcee9052d35dd", size = 6433935, upload-time = "2026-04-01T14:45:36.623Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/32/2880fb3a074847ac159d8f902cb43278a61e85f681661e7419e6596803ed/pillow-12.2.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8e9c4f5b3c546fa3458a29ab22646c1c6c787ea8f5ef51300e5a60300736905e", size = 7116720, upload-time = "2026-04-01T14:45:39.258Z" },
-    { url = "https://files.pythonhosted.org/packages/46/87/495cc9c30e0129501643f24d320076f4cc54f718341df18cc70ec94c44e1/pillow-12.2.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fb043ee2f06b41473269765c2feae53fc2e2fbf96e5e22ca94fb5ad677856f06", size = 6540498, upload-time = "2026-04-01T14:45:41.879Z" },
-    { url = "https://files.pythonhosted.org/packages/18/53/773f5edca692009d883a72211b60fdaf8871cbef075eaa9d577f0a2f989e/pillow-12.2.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f278f034eb75b4e8a13a54a876cc4a5ab39173d2cdd93a638e1b467fc545ac43", size = 7239413, upload-time = "2026-04-01T14:45:44.705Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/e4/4b64a97d71b2a83158134abbb2f5bd3f8a2ea691361282f010998f339ec7/pillow-12.2.0-cp314-cp314t-win32.whl", hash = "sha256:6bb77b2dcb06b20f9f4b4a8454caa581cd4dd0643a08bacf821216a16d9c8354", size = 6482084, upload-time = "2026-04-01T14:45:47.568Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/13/306d275efd3a3453f72114b7431c877d10b1154014c1ebbedd067770d629/pillow-12.2.0-cp314-cp314t-win_amd64.whl", hash = "sha256:6562ace0d3fb5f20ed7290f1f929cae41b25ae29528f2af1722966a0a02e2aa1", size = 7225152, upload-time = "2026-04-01T14:45:50.032Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/6e/cf826fae916b8658848d7b9f38d88da6396895c676e8086fc0988073aaf8/pillow-12.2.0-cp314-cp314t-win_arm64.whl", hash = "sha256:aa88ccfe4e32d362816319ed727a004423aab09c5cea43c01a4b435643fa34eb", size = 2556579, upload-time = "2026-04-01T14:45:52.529Z" },
     { url = "https://files.pythonhosted.org/packages/4e/b7/2437044fb910f499610356d1352e3423753c98e34f915252aafecc64889f/pillow-12.2.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:0538bd5e05efec03ae613fd89c4ce0368ecd2ba239cc25b9f9be7ed426b0af1f", size = 5273969, upload-time = "2026-04-01T14:45:55.538Z" },
     { url = "https://files.pythonhosted.org/packages/f6/f4/8316e31de11b780f4ac08ef3654a75555e624a98db1056ecb2122d008d5a/pillow-12.2.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:394167b21da716608eac917c60aa9b969421b5dcbbe02ae7f013e7b85811c69d", size = 4659674, upload-time = "2026-04-01T14:45:58.093Z" },
     { url = "https://files.pythonhosted.org/packages/d4/37/664fca7201f8bb2aa1d20e2c3d5564a62e6ae5111741966c8319ca802361/pillow-12.2.0-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5d04bfa02cc2d23b497d1e90a0f927070043f6cbf303e738300532379a4b4e0f", size = 5288479, upload-time = "2026-04-01T14:46:01.141Z" },
@@ -2247,13 +1496,16 @@ name = "pint"
 version = "0.24.4"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "flexcache", marker = "python_full_version < '3.11'" },
-    { name = "flexparser", marker = "python_full_version < '3.11'" },
-    { name = "platformdirs", marker = "python_full_version < '3.11'" },
-    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+    { name = "flexcache", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "flexparser", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "platformdirs", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/20/bb/52b15ddf7b7706ed591134a895dbf6e41c8348171fb635e655e0a4bbb0ea/pint-0.24.4.tar.gz", hash = "sha256:35275439b574837a6cd3020a5a4a73645eb125ce4152a73a2f126bf164b91b80", size = 342225, upload-time = "2024-11-07T16:29:46.061Z" }
 wheels = [
@@ -2265,14 +1517,17 @@ name = "pint"
 version = "0.25.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "flexcache", marker = "python_full_version >= '3.11'" },
-    { name = "flexparser", marker = "python_full_version >= '3.11'" },
-    { name = "platformdirs", marker = "python_full_version >= '3.11'" },
-    { name = "typing-extensions", marker = "python_full_version >= '3.11'" },
+    { name = "flexcache", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "flexparser", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "platformdirs", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "typing-extensions", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/52/9d/b1379cdbd33a49d17d627bc24e2b63cca06a1c5343b38072d2889499e82e/pint-0.25.3.tar.gz", hash = "sha256:f8f5df6cf65314d74da1ade1bf96f8e3e4d0c41b51577ac53c49e7d44ca5acee", size = 255106, upload-time = "2026-03-19T21:57:08.72Z" }
 wheels = [
@@ -2354,74 +1609,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/cf/74/66bd798b5b3be70aa1b391f5cc9d6a0a5532d7fd3b19ec0b213e72e6ad9d/propcache-0.5.2-cp312-cp312-win32.whl", hash = "sha256:8c7972d8f193740d9175f0998ab38717e6cd322d5935c5b0fef8c0d323fd9031", size = 39018, upload-time = "2026-05-08T21:00:31.622Z" },
     { url = "https://files.pythonhosted.org/packages/61/7c/5c0d34aa3024694d6dcb9271cdbdd08c4e47c1c0ad95ec7e7bc74cdea145/propcache-0.5.2-cp312-cp312-win_amd64.whl", hash = "sha256:d9ee8826a7d47863a08ac44e1a5f611a462eefc3a194b492da242128bec75b42", size = 42322, upload-time = "2026-05-08T21:00:32.918Z" },
     { url = "https://files.pythonhosted.org/packages/4d/91/875812f1a3feb20ceba818ef39fbe4d92f1081e04ac815c822496d0d038b/propcache-0.5.2-cp312-cp312-win_arm64.whl", hash = "sha256:2800a4a8ead6b28cccd1ec54b59346f0def7922ee1c7598e8499c733cfbb7c84", size = 38172, upload-time = "2026-05-08T21:00:35.124Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/09/f049e45385503fe67db75a6b6186a7b9f0c3930366dc960522c312a825b1/propcache-0.5.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:099aaf4b4d1a02265b92a977edf00b5c4f63b3b17ac6de39b0d637c9cac0188a", size = 94457, upload-time = "2026-05-08T21:00:36.355Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/65/83d1d05655baf63113731bd5a1008435e14f8d1e5a06cbe4ec5b23ad7a31/propcache-0.5.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:68ce1c44c7a813a7f71ea04315a8c7b330b63db99d059a797a4651bb6f69f117", size = 53835, upload-time = "2026-05-08T21:00:38.072Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/12/a6ba6482bb5ea3260c000c9b20881c95fa11c6b30173715668259f844ed7/propcache-0.5.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:fc299c129490f55f254cd90be0deca4764e36e9a7c08b4aa588479a3bbed3098", size = 54545, upload-time = "2026-05-08T21:00:39.319Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/19/7fa086f5764c59ec8a8e157cd93aa8497acc00aba9dcdec56bfffb32602d/propcache-0.5.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a6ae2198be502c10f09b2516e7b5d019816924bc3183a43ce792a7bd6625e6f4", size = 59886, upload-time = "2026-05-08T21:00:40.621Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/e4/5d7663dc8235956c8f5281698a3af1d351d8820341ddd890f59d9a9127f2/propcache-0.5.2-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6041d31504dc1779d700e1edcfb08eea334b357620b06681a4eabb57a74e574e", size = 63261, upload-time = "2026-05-08T21:00:41.775Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/4a/15a03adee24d6350da4292caeac44c34c033d2afe5e87eb370f38854560f/propcache-0.5.2-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f7eabc04151c78a9f4d5bbb5f1faf571e4defeb4b585e0fe95b60ff2dbe4d3d7", size = 64184, upload-time = "2026-05-08T21:00:43.018Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/c6/979176efdaa3d239e36d503d5af63a0a773b36662ed8f52e5b6a6d9fd40e/propcache-0.5.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4db0ba63d693afd40d249bd93f842b5f144f8fcbb83de05660373bcf30517b1d", size = 61534, upload-time = "2026-05-08T21:00:44.507Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/22/63e8cd1bae4c2d2be6493b6b7d10566ddafad88137cfbc99964a1119853c/propcache-0.5.2-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1dbcf7675229b35d31abb6547d8ebc8c27a830ac3f9a794edff6254873ec7c0a", size = 61500, upload-time = "2026-05-08T21:00:45.796Z" },
-    { url = "https://files.pythonhosted.org/packages/60/5a/28e5d9acbac1cc9ccb67045e8c1b943aa8d79fdf39c93bd73cacd68008ea/propcache-0.5.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d310c013aad2c72f1c3f2f8dd3279d460a858c551f97aeb8c63e4693cca7b4d2", size = 59994, upload-time = "2026-05-08T21:00:47.093Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/40/db650677f554a95b9c01a7c9d93d629e93a15562f5deb4573c9ee136fed2/propcache-0.5.2-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:06187263ddad280d05b4d8a8b3bb7d164cbebd469236544a42e6d9b28ac6a4fa", size = 56884, upload-time = "2026-05-08T21:00:48.376Z" },
-    { url = "https://files.pythonhosted.org/packages/80/45/70b39b89516ff8b96bf732fa6fded8cef20f293cb1508690101c3c07ec51/propcache-0.5.2-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:3115559b8effafd63b142ea5ed53d63a16ea6469cbc63dce4ee194b42db5d853", size = 63464, upload-time = "2026-05-08T21:00:49.954Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/e2/fa59d3a89eac5534293124af4f1d0d0ada091ce4a0ab4610ce03fd2bdd8d/propcache-0.5.2-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c60462af8e6dc30c35407c7237ea908d777b22862bbee27bc4699c0d8bcdc45a", size = 61588, upload-time = "2026-05-08T21:00:51.281Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/97/efb547a55c4bc7381cfb202d6a2239ac621045277bc1ea5dfd3a7f0516c0/propcache-0.5.2-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:40314bca9ac559716fe374094fc81c11dcc34b64fd6c585360f5775690505704", size = 64667, upload-time = "2026-05-08T21:00:52.602Z" },
-    { url = "https://files.pythonhosted.org/packages/92/56/f5c7d9b4b7595d5127da38974d791b2153f3d1eae6c674af3583ace92ad3/propcache-0.5.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:cfa21e036ce1e1db2be04ba3b85d2df1bb1702fa01932d984c5464c665228ff4", size = 62463, upload-time = "2026-05-08T21:00:54.303Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/3b/484a3a65fc9f9f60c41dcd17b428bace5389544e2c680994534a20755066/propcache-0.5.2-cp313-cp313-win32.whl", hash = "sha256:f156a3529f38063b6dbaf356e15602a7f95f8055b1295a438433a6386f10463d", size = 38621, upload-time = "2026-05-08T21:00:55.808Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/fd/3f0f10dba4dabad3bf53102be007abf55481067952bde0fdddff439e7c61/propcache-0.5.2-cp313-cp313-win_amd64.whl", hash = "sha256:dfed59d0a5aeb01e242e66ff0300bc4a265a7c05f612d30016f0b60b1017d757", size = 41649, upload-time = "2026-05-08T21:00:57.061Z" },
-    { url = "https://files.pythonhosted.org/packages/90/ec/6ce619cc32bb500a482f811f9cd509368b4e58e638d13f2c68f370d6b475/propcache-0.5.2-cp313-cp313-win_arm64.whl", hash = "sha256:ba338430e87ceb9c8f0cf754de38a9860560261e56c00376debd628698a7364f", size = 37636, upload-time = "2026-05-08T21:00:58.646Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/82/c1d268bbbf2ef981c5bf0fbbe746db617c66e3bcefe431a1aa8943fbe23a/propcache-0.5.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:a592f5f3da71c8691c788c13cb6734b6d17663d2e1cb8caddf0673d01ef8847d", size = 98872, upload-time = "2026-05-08T21:00:59.889Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/d4/52c871e73e864e6b34c0e2d58ac1ec5ccd149497ddc7ad2137ae98323a35/propcache-0.5.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:6a997d0489e9668a384fcfd5061b857aa5361de73191cac204d04b889cfbbafa", size = 56257, upload-time = "2026-05-08T21:01:01.195Z" },
-    { url = "https://files.pythonhosted.org/packages/67/f0/9b90ca2a210b3d09bcfcd96ecd0f55545c091535abce2a45de2775cfd357/propcache-0.5.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:10734b5484ea113152ee25a91dccedf81631791805d2c9ccb054958e51842c94", size = 56696, upload-time = "2026-05-08T21:01:02.941Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/0e/6e9d4ba07c8e56e21ddec1e75f12148142b21ca83a51871babce095334f4/propcache-0.5.2-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cafca7e56c12bb02ae16d283742bef25a61122e9dab2b5b3f2ccbe589ce32164", size = 62378, upload-time = "2026-05-08T21:01:04.475Z" },
-    { url = "https://files.pythonhosted.org/packages/65/19/c10badaa463dde8a27ce884f8ee2ec37e6035b7c9f5ff0c8f74f06f08dac/propcache-0.5.2-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f064f8d2b59177878b7615df1735cd8fe3462ed6be8c7b217d17a276489c2b7f", size = 65283, upload-time = "2026-05-08T21:01:05.959Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/b6/93bea99ca80e19cef6512a8580e5b7857bbe09422d9daa7fd4ef5723306c/propcache-0.5.2-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f78abfa8dfc32376fd1aacf597b2f2fbbe0ea751419aee718af5d4f82537ef8c", size = 66616, upload-time = "2026-05-08T21:01:07.228Z" },
-    { url = "https://files.pythonhosted.org/packages/83/e4/5c7462e50625f051f37fb38b8224f7639f667184bbd34424ec83819bb1b7/propcache-0.5.2-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f7467da8a9822bf1a55336f877340c5bcbd3c482afc43a99771169f74a26dedc", size = 63773, upload-time = "2026-05-08T21:01:08.514Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/b6/99238894047b13c823be25027e736626cd414a52a5e30d2c3347c2733529/propcache-0.5.2-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a6ddc6ac9e25de626c1f129c1b467d7ecd33ce2237d3fd0c4e429feef0a7ee1f", size = 63664, upload-time = "2026-05-08T21:01:09.874Z" },
-    { url = "https://files.pythonhosted.org/packages/85/1e/a3a1a63116a2b8edb415a8bb9a6f0c34bd03830b1e18e8ce2904e1dc1cf4/propcache-0.5.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:2f22cbbac9e26a8e864c0985ff1268d5d939d53d9d9411a9824279097e03a2cb", size = 62643, upload-time = "2026-05-08T21:01:11.132Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/03/893cf147de2fc6543c5eaa07ad833170e7e2a2385725bbebe8c0503723bb/propcache-0.5.2-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:fc76378c62a0f04d0cd82fbb1a2cd2d7e28fcb40d5873f28a6c44e388aaa2751", size = 59595, upload-time = "2026-05-08T21:01:12.387Z" },
-    { url = "https://files.pythonhosted.org/packages/86/3b/04c1a2e12c57766568ba75ba72b3bf2042818d4c1425fab6fc07155c7cff/propcache-0.5.2-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:acd2c8edba48e31e58a363b8cf4e5c7db3b04b3f9e371f601df30d9b0d244836", size = 65711, upload-time = "2026-05-08T21:01:13.676Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/34/80f8d0099f8d6bacc4de1624c85672681c8cd1149ca2da0e38fd120b817f/propcache-0.5.2-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:452b5065457eb9991ec5eb38ff41d6cd4c991c9ac7c531c4d5849ae473a9a13f", size = 64247, upload-time = "2026-05-08T21:01:14.936Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/1a/8b08f3a5f1037e9e370c55883ceeeee0f6dd0416fb2d2d67b8bfc91f2a79/propcache-0.5.2-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:3430bb2bfe1331885c427745a751e774ee679fd4344f80b97bf879815fe8fa55", size = 67102, upload-time = "2026-05-08T21:01:16.281Z" },
-    { url = "https://files.pythonhosted.org/packages/34/68/8bdb7bb7756d76e005490649d10e4a8369e610c74d619f71e1aedf889e9c/propcache-0.5.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:cef6cea3922890dd6c9654971001fa797b526c16ab5e1e46c05fd6f877be7568", size = 64964, upload-time = "2026-05-08T21:01:17.57Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/aa/50fb0b5d3968b61a510926ff8b8465f1d6e976b3ab74496d7a4b9fc42515/propcache-0.5.2-cp313-cp313t-win32.whl", hash = "sha256:72d61e16dd78228b58c5d47be830ff3da7e5f139abdf0aef9d86cde1c5cf2191", size = 42546, upload-time = "2026-05-08T21:01:18.946Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/4c/0ddbae64321bd4a95bcbfc19307238016b5b1fee645c84626c8d539e5b74/propcache-0.5.2-cp313-cp313t-win_amd64.whl", hash = "sha256:0958834041a0166d343b8d2cedcd8bcbaeb4fdbe0cf08320c5379f143c3be6e7", size = 46330, upload-time = "2026-05-08T21:01:20.162Z" },
-    { url = "https://files.pythonhosted.org/packages/00/d9/9cddc8efb78d8af264c5ec9f6d10b62f57c515feda8d321595f56010fb23/propcache-0.5.2-cp313-cp313t-win_arm64.whl", hash = "sha256:6de8bd93ddde9b992cf2b2e0d796d501a19026b5b9fd87356d7d0779531a8d96", size = 40521, upload-time = "2026-05-08T21:01:21.399Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/ea/23ee535d90ce8bcc465a3028eb3cc0ce3bd1005f4bb27710b30587de798d/propcache-0.5.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:46088abff4cba581dea21ae0467a480526cb25aa5f3c269e909f800328bc3999", size = 94662, upload-time = "2026-05-08T21:01:22.683Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/06/c5a52f419b5d8972f8d46a7577476090d8e3263ff589ce40b5ca4968d5be/propcache-0.5.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fc88b26f08d634f7bc819a7852e5214f5802641ab8d9fd5326892292eee1993e", size = 53928, upload-time = "2026-05-08T21:01:23.986Z" },
-    { url = "https://files.pythonhosted.org/packages/63/b1/4260d67d6bd85e58a66b72d54ce15d5de789b6f3870cc6bedf8ff9667401/propcache-0.5.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:97797ebb098e670a2f92dd66f32897e30d7615b14e7f59711de23e30a9072539", size = 54650, upload-time = "2026-05-08T21:01:25.305Z" },
-    { url = "https://files.pythonhosted.org/packages/70/06/2f46c318e3307cd7a6a7481def374ce838c0fe20084b39dd54b0879d0e99/propcache-0.5.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ba57fffe4ac99c5d30076161b5866336d97600769bad35cc68f7774b15298a4e", size = 59912, upload-time = "2026-05-08T21:01:26.545Z" },
-    { url = "https://files.pythonhosted.org/packages/4c/29/fe1aebec2ce57ab985a9c382bded1124431f85078113aa222c5d278430d4/propcache-0.5.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:583c19759d9eec1e5b69e2fbef36a7d9c326041be9746cb822d335c8cedc2979", size = 63300, upload-time = "2026-05-08T21:01:27.937Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/18/2334b26768b6c82be8c69e83671b767d5ef426aa09b0cba6c2ea47816774/propcache-0.5.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d0326e2e5e1f3163fa306c834e48e8d490e5fae607a097a40c0648109b47ba80", size = 64208, upload-time = "2026-05-08T21:01:29.484Z" },
-    { url = "https://files.pythonhosted.org/packages/2b/76/7f1bfd6afff4c5e38e36a3c6d68eb5f4b7311ea80baf693db78d95b603c4/propcache-0.5.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e00820e192c8dbebcafb383ebbf99030895f09905e7a0eb2e0340a0bcc2bc825", size = 61633, upload-time = "2026-05-08T21:01:31.068Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/46/b3ff8aba2b4953a3e50de2cf72f1b5748b8eca93b15f3dc2c84339084c09/propcache-0.5.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c66afea89b1e43725731d2004732a046fe6fe955d51f952c3e95a7314a284a39", size = 61724, upload-time = "2026-05-08T21:01:32.374Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/01/814cfcafbcff954f94c01cf30e097ddc88a076b5440fbcf4570753437d40/propcache-0.5.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d4dc37dec6c6cdad0b57881a5658fd14fbf53e333b1a86cf86559f190e1d9ec4", size = 60069, upload-time = "2026-05-08T21:01:33.67Z" },
-    { url = "https://files.pythonhosted.org/packages/da/68/5c6f7622d510cc666a300687e06fd060c1a43361c0c9b20d284f06d8096a/propcache-0.5.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:5570dbcc97571c15f68068e529c92715a12f8d54030e272d264b377e22bd17a5", size = 57099, upload-time = "2026-05-08T21:01:34.915Z" },
-    { url = "https://files.pythonhosted.org/packages/55/27/9cb0b4c679124085327957d42521c99dba04c88c90c3e55a6f0b633ebccc/propcache-0.5.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:f814362777a9f841adddb200ecdf8f5cb1e5a3c4b7a86378edbd6ccb26edd702", size = 63391, upload-time = "2026-05-08T21:01:36.231Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/9d/7258aaa5bdf60fc6f27591eef6fe52768cb0beda7140be477c8b12c9794a/propcache-0.5.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:196913dea116aeb5a2ba95af4ddcb7ea85559ae07d8eee8751688310d09168c3", size = 61626, upload-time = "2026-05-08T21:01:37.545Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/0d/41c602003e8a9b16fe1e7eadf62c7bfba9d5474370b24200bf48b315f45f/propcache-0.5.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:6e7b8719005dd1175be4ab1cd25e9b98659a5e0347331506ec6760d2773a7fb5", size = 64781, upload-time = "2026-05-08T21:01:38.83Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/f3/38e66b1856e9bd079deea015bc4a55f7767c0e4db2f7dcf69e7e680ba4ce/propcache-0.5.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:51f96d685ab16e88cab128cd37a52c5da540809c8b879fa047731bfcb4ad35a4", size = 62570, upload-time = "2026-05-08T21:01:40.415Z" },
-    { url = "https://files.pythonhosted.org/packages/95/ca/bbfe9b910ce57dde8bb4876b4520fc02a4e89497c10de26be936758a3aaa/propcache-0.5.2-cp314-cp314-win32.whl", hash = "sha256:cc6fc3cc62e8501d3ed62894425040d2728ecddb1ed072737a5c70bd537aa9f0", size = 39436, upload-time = "2026-05-08T21:01:41.654Z" },
-    { url = "https://files.pythonhosted.org/packages/61/d2/45c9defbaa1ea297035d9d4cce9e8f80daafbf19319c6007f157c6256ea9/propcache-0.5.2-cp314-cp314-win_amd64.whl", hash = "sha256:81e3a30b0bb60caa22033dd0f8a3618d1d67356212514f62c57db75cb0ef410c", size = 42373, upload-time = "2026-05-08T21:01:43.041Z" },
-    { url = "https://files.pythonhosted.org/packages/44/68/9ea5103f41d5217d7d6ec24db90018e23aebec070c3f9a6e54d12b841fd8/propcache-0.5.2-cp314-cp314-win_arm64.whl", hash = "sha256:0d2c9bf8528f135dbb805ce027567e09164f7efa51a2be07458a2c0420f292d0", size = 38554, upload-time = "2026-05-08T21:01:44.336Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/81/fadf555f42d3b762eea8a53950b0489fdc0aa9da5f8ed9e10ce0a4e01b48/propcache-0.5.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:4bc8ff1feffc6a61c7002ffe84634c41b822e104990ae009f44a0834430070bb", size = 99395, upload-time = "2026-05-08T21:01:45.883Z" },
-    { url = "https://files.pythonhosted.org/packages/f5/c9/c61e134a686949cf7971af3a390148b1156f7be81c73bc0cd12c873e2d48/propcache-0.5.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:79aa3ff0a9b566633b642fa9caf7e21ed1c13d6feca718187873f199e1514078", size = 56653, upload-time = "2026-05-08T21:01:47.307Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/73/daf935ea7048ddd7ec8eec5345b4a40b619d2d178b3c0a0900796bc3c794/propcache-0.5.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1b31822f4474c4036bae62de9402710051d431a606d6a0f907fec79935a071aa", size = 56914, upload-time = "2026-05-08T21:01:48.573Z" },
-    { url = "https://files.pythonhosted.org/packages/79/9f/aba959b435ea18617edd7cf0a7ad0b9c574b8fc7e3d2cd55fb59cb255d33/propcache-0.5.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:13fef48778b5a2a756523fdb781326b028ca75e32858b04f2cdd19f394564917", size = 62567, upload-time = "2026-05-08T21:01:49.903Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/a1/859942de9a791ff42f6141736f5b37749b8f53e65edfa49638c67dd67e6a/propcache-0.5.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8b73ab70f1a3351fbc71f663b3e645af6dd0329100c353081cf69c37433fc6fe", size = 65542, upload-time = "2026-05-08T21:01:51.204Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/61/315bc0fd6c0fc7f80a528b8afd209e5fc4a875ea79571b91b8f50f442907/propcache-0.5.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5538d2c13d93e4698af7e092b57bc7298fd35d1d58e656ae18f23ee0d0378e03", size = 66845, upload-time = "2026-05-08T21:01:52.539Z" },
-    { url = "https://files.pythonhosted.org/packages/47/f7/9f8122e3132e8e354ac41975ef8f1099be7d5a16bc7ae562734e993665c0/propcache-0.5.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:cd645f03898405cabe694fb8bc35241e3a9c332ec85627584fe3de201452b335", size = 63985, upload-time = "2026-05-08T21:01:53.847Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/54/c317819ec157cbf6f35df9df9657a6f82daf34d5faf15948b2f639c2192e/propcache-0.5.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a473b3440261e0c60706e732b2ed2f517857344fc21bf48fdfe211e2d98eb285", size = 63999, upload-time = "2026-05-08T21:01:55.179Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/56/387e3f7dfce0a9233df41fb888aa1c30222cb4bbbf09537c02dd9bd85fe2/propcache-0.5.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7afa37062e6650640e932e4cc9297d81f9f42d9944029cc386b8247dea4da837", size = 62779, upload-time = "2026-05-08T21:01:57.489Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/9c/596784cb5824ed61ee960d3f8655a3f0993e107c6e98ab6c818b7fb92ccb/propcache-0.5.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:8a90efd5777e996e42d568db9ac740b944d691e565cbfd31b2f7832f9184b2b8", size = 59796, upload-time = "2026-05-08T21:01:58.736Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/3d/1a6cfa1726a48542c1e8784a0761421476a5b68e09b7f36bf95eb954aaba/propcache-0.5.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:f19bb891234d72535764d703bfed1153cc34f4214d5bd7150aee1eec9e8f4366", size = 66023, upload-time = "2026-05-08T21:02:00.228Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/0e/05fd6990369477076e4e280bcb970de760fddf0161a46e988bc95f7940ec/propcache-0.5.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:32775082acd2d807ee3db715c7770d38767b817870acfa08c29e057f3c4d5b56", size = 64448, upload-time = "2026-05-08T21:02:01.888Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/86/5f8da315a4309c62c10c0b2516b17492d5d3bbe1bb862b96604db67e2a37/propcache-0.5.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:9282fb1a3bccd038da9f768b927b24a0c753e466c086b7c4f3c6982851eefb2d", size = 67329, upload-time = "2026-05-08T21:02:03.484Z" },
-    { url = "https://files.pythonhosted.org/packages/da/d3/3368efe79ab21f0cdf86ef49895811c9cc933131d4cde1f28a624e22e712/propcache-0.5.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:cc49723e2f60d6b32a0f0b08a3fd6d13203c07f1cd9566cfce0f12a917c967a2", size = 65172, upload-time = "2026-05-08T21:02:04.745Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/07/127e8b0bacfb325396196f9d976a22453049b89b9b2b08477cc3145faa44/propcache-0.5.2-cp314-cp314t-win32.whl", hash = "sha256:2d7aa89ebca5acc98cba9d1472d976e394782f587bad6661003602a619fd1821", size = 43813, upload-time = "2026-05-08T21:02:06.025Z" },
-    { url = "https://files.pythonhosted.org/packages/88/fb/46dad6c0ae49ed230ab1b16c890c2b6314e2403e6c412976f4a72d64a527/propcache-0.5.2-cp314-cp314t-win_amd64.whl", hash = "sha256:d447bb0b3054be5818458fbb171208b1d9ff11eba14e18ca18b90cbb45767370", size = 47764, upload-time = "2026-05-08T21:02:07.353Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/c4/a47d0a63aa309d10d59ede6e9d4cff03a344a79d1f0f4cd0cd74997b53e0/propcache-0.5.2-cp314-cp314t-win_arm64.whl", hash = "sha256:fe67a3d11cd9b4efabfa45c3d00ffba2b26811442a73a581a94b67c2b5faccf6", size = 41140, upload-time = "2026-05-08T21:02:09.065Z" },
     { url = "https://files.pythonhosted.org/packages/3a/ed/1cdcab6ba3d6ab7feca11fc14f0eeea80755bb53ef4e892079f31b10a25f/propcache-0.5.2-py3-none-any.whl", hash = "sha256:be1ddfcbb376e3de5d2e2db1d58d6d67463e6b4f9f040c000de8e300295465fe", size = 14036, upload-time = "2026-05-08T21:02:10.673Z" },
 ]
 
@@ -2493,51 +1680,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/47/bd/6f2fc8188f31bf10590f1e98e7b306336161fac930a8c514cd7bd828c7dc/pydantic_core-2.46.4-cp312-cp312-win32.whl", hash = "sha256:9aa768456404a8bf48a4406685ac2bec8e72b62c69313734fa3b73cf33b3a894", size = 1974823, upload-time = "2026-05-06T13:40:47.985Z" },
     { url = "https://files.pythonhosted.org/packages/40/8c/985c1d41ea1107c2534abd9870e4ed5c8e7669b5c308297835c001e7a1c4/pydantic_core-2.46.4-cp312-cp312-win_amd64.whl", hash = "sha256:e9c26f834c65f5752f3f06cb08cb86a913ceb7274d0db6e267808a708b46bc89", size = 2072919, upload-time = "2026-05-06T13:39:21.153Z" },
     { url = "https://files.pythonhosted.org/packages/c4/ba/f463d006e0c47373ca7ec5e1a261c59dc01ef4d62b2657af925fb0deee3a/pydantic_core-2.46.4-cp312-cp312-win_arm64.whl", hash = "sha256:4fc73cb559bdb54b1134a706a2802a4cddd27a0633f5abb7e53056268751ac6a", size = 2027604, upload-time = "2026-05-06T13:39:03.753Z" },
-    { url = "https://files.pythonhosted.org/packages/51/a2/5d30b469c5267a17b39dec53208222f76a8d351dfac4af661888c5aee77d/pydantic_core-2.46.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:5d5902252db0d3cedf8d4a1bc68f70eeb430f7e4c7104c8c476753519b423008", size = 2106306, upload-time = "2026-05-06T13:37:48.029Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/81/4fa520eaffa8bd7d1525e644cd6d39e7d60b1592bc5b516693c7340b50f1/pydantic_core-2.46.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c94f0688e7b8d0a67abf40e57a7eaaecd17cc9586706a31b76c031f63df052b4", size = 1951906, upload-time = "2026-05-06T13:37:17.012Z" },
-    { url = "https://files.pythonhosted.org/packages/03/d5/fd02da45b659668b05923b17ba3a0100a0a3d5541e3bd8fcc4ecb711309e/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f027324c56cd5406ca49c124b0db10e56c69064fec039acc571c29020cc87c76", size = 1976802, upload-time = "2026-05-06T13:37:35.113Z" },
-    { url = "https://files.pythonhosted.org/packages/21/f2/95727e1368be3d3ed485eaab7adbd7dda408f33f7a36e8b48e0144002b91/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e739fee756ba1010f8bcccb534252e85a35fe45ae92c295a06059ce58b74ccd3", size = 2052446, upload-time = "2026-05-06T13:37:12.313Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/86/5d99feea3f77c7234b8718075b23db11532773c1a0dbd9b9490215dc2eeb/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9d56801be94b86a9da183e5f3766e6310752b99ff647e38b09a9500d88e46e76", size = 2232757, upload-time = "2026-05-06T13:39:01.149Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/3a/508ac615935ef7588cf6d9e9b91309fdc2da751af865e02a9098de88258c/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2412e734dcb48da14d4e4006b82b46b74f2518b8a26ee7e58c6844a6cd6d03c4", size = 2309275, upload-time = "2026-05-06T13:37:41.406Z" },
-    { url = "https://files.pythonhosted.org/packages/07/f8/41db9de19d7987d6b04715a02b3b40aea467000275d9d758ffaa31af7d50/pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9551187363ffc0de2a00b2e47c25aeaeb1020b69b668762966df15fc5659dd5a", size = 2094467, upload-time = "2026-05-06T13:39:18.847Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/e2/f35033184cb11d0052daf4416e8e10a502ea2ac006fc4f459aee872727d1/pydantic_core-2.46.4-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:0186750b482eefa11d7f435892b09c5c606193ef3375bcf94aa00ae6bfb66262", size = 2134417, upload-time = "2026-05-06T13:40:17.944Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/7b/6ceeb1cc90e193862f444ebe373d8fdf613f0a82572dde03fb10734c6c71/pydantic_core-2.46.4-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5855698a4856556d86e8e6cd8434bc3ac0314ee8e12089ae0e143f64c6256e4e", size = 2179782, upload-time = "2026-05-06T13:40:32.618Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/f2/c8d7773ede6af08036423a00ae0ceffce266c3c52a096c435d68c896083f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:cbaf13819775b7f769bf4a1f066cb6df7a28d4480081a589828ef190226881cd", size = 2188782, upload-time = "2026-05-06T13:36:51.018Z" },
-    { url = "https://files.pythonhosted.org/packages/59/31/0c864784e31f09f05cdd87606f08923b9c9e7f6e51dd27f20f62f975ce9f/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:633147d34cf4550417f12e2b1a0383973bdf5cdfde212cb09e9a581cf10820be", size = 2328334, upload-time = "2026-05-06T13:40:37.764Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/eb/4f6c8a41efa30baa755590f4141abf3a8c370fab610915733e74134a7270/pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:82cf5301172168103724d49a1444d3378cb20cdee30b116a1bd6031236298a5d", size = 2372986, upload-time = "2026-05-06T13:39:34.152Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/24/b375a480d53113860c299764bfe9f349a3dc9108b3adc0d7f0d786492ebf/pydantic_core-2.46.4-cp313-cp313-win32.whl", hash = "sha256:9fa8ae11da9e2b3126c6426f147e0fba88d96d65921799bb30c6abd1cb2c97fb", size = 1973693, upload-time = "2026-05-06T13:37:55.072Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/e8/cff247591966f2d22ec8c003cd7587e27b7ba7b81ab2fb888e3ab75dc285/pydantic_core-2.46.4-cp313-cp313-win_amd64.whl", hash = "sha256:6b3ace8194b0e5204818c92802dcdca7fc6d88aabbb799d7c795540d9cd6d292", size = 2071819, upload-time = "2026-05-06T13:38:49.139Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/1a/f4aee670d5670e9e148e0c82c7db98d780be566c6e6a97ee8035528ca0b3/pydantic_core-2.46.4-cp313-cp313-win_arm64.whl", hash = "sha256:184c081504d17f1c1066e430e117142b2c77d9448a97f7b65c6ac9fd9aee238d", size = 2027411, upload-time = "2026-05-06T13:40:45.796Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/74/228a26ddad29c6672b805d9fd78e8d251cd04004fa7eed0e622096cd0250/pydantic_core-2.46.4-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:428e04521a40150c85216fc8b85e8d39fece235a9cf5e383761238c7fa9b96fb", size = 2102079, upload-time = "2026-05-06T13:38:41.019Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/1f/8970b150a4b4365623ae00fc88603491f763c627311ae8031e3111356d6e/pydantic_core-2.46.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:23ace664830ee0bfe014a0c7bc248b1f7f25ed7ad103852c317624a1083af462", size = 1952179, upload-time = "2026-05-06T13:36:59.812Z" },
-    { url = "https://files.pythonhosted.org/packages/95/30/5211a831ae054928054b2f79731661087a2bc5c01e825c672b3a4a8f1b3e/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce5c1d2a8b27468f433ca974829c44060b8097eedc39933e3c206a90ee49c4a9", size = 1978926, upload-time = "2026-05-06T13:37:39.933Z" },
-    { url = "https://files.pythonhosted.org/packages/57/e9/689668733b1eb67adeef047db3c2e8788fcf65a7fd9c9e2b46b7744fe245/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7283d57845ecf5a163403eb0702dfc220cc4fbdd18919cb5ccea4f95ee1cdab4", size = 2046785, upload-time = "2026-05-06T13:38:01.995Z" },
-    { url = "https://files.pythonhosted.org/packages/60/d9/6715260422ff50a2109878fd24d948a6c3446bb2664f34ee78cd972b3acd/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8daafc69c93ee8a0204506a3b6b30f586ef54028f52aeeeb5c4cfc5184fd5914", size = 2228733, upload-time = "2026-05-06T13:40:50.371Z" },
-    { url = "https://files.pythonhosted.org/packages/18/ae/fdb2f64316afca925640f8e70bb1a564b0ec2721c1389e25b8eb4bf9a299/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd2213145bcc2ba85884d0ac63d222fece9209678f77b9b4d76f054c561adb28", size = 2307534, upload-time = "2026-05-06T13:37:21.531Z" },
-    { url = "https://files.pythonhosted.org/packages/89/1d/8eff589b45bb8190a9d12c49cfad0f176a5cbd1534908a6b5125e2886239/pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7a5f930472650a82629163023e630d160863fce524c616f4e5186e5de9d9a49b", size = 2099732, upload-time = "2026-05-06T13:39:31.942Z" },
-    { url = "https://files.pythonhosted.org/packages/06/d5/ee5a3366637fee41dee51a1fc91562dcf12ddbc68fda34e6b253da2324bb/pydantic_core-2.46.4-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:c1b3f518abeca3aa13c712fd202306e145abf59a18b094a6bafb2d2bbf59192c", size = 2129627, upload-time = "2026-05-06T13:37:25.033Z" },
-    { url = "https://files.pythonhosted.org/packages/94/33/2414be571d2c6a6c4d08be21f9292b6d3fdb08949a97b6dfe985017821db/pydantic_core-2.46.4-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1a7dd0b3ee80d90150e3495a3a13ac34dbcbfd4f012996a6a1d8900e91b5c0fb", size = 2179141, upload-time = "2026-05-06T13:37:14.046Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/79/7daa95be995be0eecc4cf75064cb33f9bbbfe3fe0158caf2f0d4a996a5c7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:3fb702cd90b0446a3a1c5e470bfa0dd23c0233b676a9099ddcc964fa6ca13898", size = 2184325, upload-time = "2026-05-06T13:36:53.615Z" },
-    { url = "https://files.pythonhosted.org/packages/9f/cb/d0a382f5c0de8a222dc61c65348e0ce831b1f68e0a018450d31c2cace3a5/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:b8458003118a712e66286df6a707db01c52c0f52f7db8e4a38f0da1d3b94fc4e", size = 2323990, upload-time = "2026-05-06T13:40:29.971Z" },
-    { url = "https://files.pythonhosted.org/packages/05/db/d9ba624cc4a5aced1598e88c04fdbd8310c8a69b9d38b9a3d39ce3a61ed7/pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:372429a130e469c9cd698925ce5fc50940b7a1336b0d82038e63d5bbc4edc519", size = 2369978, upload-time = "2026-05-06T13:37:23.027Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/20/d15df15ba918c423461905802bfd2981c3af0bfa0e40d05e13edbfa48bc3/pydantic_core-2.46.4-cp314-cp314-win32.whl", hash = "sha256:85bb3611ff1802f3ee7fdd7dbff26b56f343fb432d57a4728fdd49b6ef35e2f4", size = 1966354, upload-time = "2026-05-06T13:38:03.499Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/b6/6b8de4c0a7d7ab3004c439c80c5c1e0a3e8d78bbae19379b01960383d9e5/pydantic_core-2.46.4-cp314-cp314-win_amd64.whl", hash = "sha256:811ff8e9c313ab425368bcbb36e5c4ebd7108c2bbf4e4089cfbb0b01eff63fac", size = 2072238, upload-time = "2026-05-06T13:39:40.807Z" },
-    { url = "https://files.pythonhosted.org/packages/32/36/51eb763beec1f4cf59b1db243a7dcc39cbb41230f050a09b9d69faaf0a48/pydantic_core-2.46.4-cp314-cp314-win_arm64.whl", hash = "sha256:bfec22eab3c8cc2ceec0248aec886624116dc079afa027ecc8ad4a7e62010f8a", size = 2018251, upload-time = "2026-05-06T13:37:26.72Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/91/855af51d625b23aa987116a19e231d2aaef9c4a415273ddc189b79a45fee/pydantic_core-2.46.4-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:af8244b2bef6aaad6d92cda81372de7f8c8d36c9f0c3ea36e827c60e7d9467a0", size = 2099593, upload-time = "2026-05-06T13:39:47.682Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/1b/8784a54c65edb5f49f0a14d6977cf1b209bba85a4c77445b255c2de58ab3/pydantic_core-2.46.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5a4330cdbc57162e4b3aa303f588ba752257694c9c9be3e7ebb11b4aca659b5d", size = 1935226, upload-time = "2026-05-06T13:40:40.428Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/e7/1955d28d1afc56dd4b3ad7cc0cf39df1b9852964cf16e5d13912756d6d6b/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29c61fc04a3d840155ff08e475a04809278972fe6aef51e2720554e96367e34b", size = 1974605, upload-time = "2026-05-06T13:37:32.029Z" },
-    { url = "https://files.pythonhosted.org/packages/93/e2/3fedbf0ba7a22850e6e9fd78117f1c0f10f950182344d8a6c535d468fdd8/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c50f2528cf200c5eed56faf3f4e22fcd5f38c157a8b78576e6ba3168ec35f000", size = 2030777, upload-time = "2026-05-06T13:38:55.239Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/61/46be275fcaaba0b4f5b9669dd852267ce1ff616592dccf7a7845588df091/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0cbe8b01f948de4286c74cdd6c667aceb38f5c1e26f0693b3983d9d74887c65e", size = 2236641, upload-time = "2026-05-06T13:37:08.096Z" },
-    { url = "https://files.pythonhosted.org/packages/60/db/12e93e46a8bac9988be3c016860f83293daea8c716c029c9ace279036f2f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:617d7e2ca7dcb8c5cf6bcb8c59b8832c94b36196bbf1cbd1bfb56ed341905edd", size = 2286404, upload-time = "2026-05-06T13:40:20.221Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/4a/4d8b19008f38d31c53b8219cfedc2e3d5de5fe99d90076b7e767de29274f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7027560ee92211647d0d34e3f7cd6f50da56399d26a9c8ad0da286d3869a53f3", size = 2109219, upload-time = "2026-05-06T13:38:12.153Z" },
-    { url = "https://files.pythonhosted.org/packages/88/70/3cbc40978fefb7bb09c6708d40d4ad1a5d70fd7213c3d17f971de868ec1f/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:f99626688942fb746e545232e7726926f3be91b5975f8b55327665fafda991c7", size = 2110594, upload-time = "2026-05-06T13:40:02.971Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/20/b8d36736216e29491125531685b2f9e61aa5b4b2599893f8268551da3338/pydantic_core-2.46.4-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fc3e9034a63de20e15e8ade85358bc6efc614008cab72898b4b4952bea0509ff", size = 2159542, upload-time = "2026-05-06T13:39:27.506Z" },
-    { url = "https://files.pythonhosted.org/packages/1d/a2/367df868eb584dacf6bf82a389272406d7178e301c4ac82545ab98bc2dd9/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:97e7cf2be5c77b7d1a9713a05605d49460d02c6078d38d8bef3cbe323c548424", size = 2168146, upload-time = "2026-05-06T13:38:31.93Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/b8/4460f77f7e201893f649a29ab355dddd3beee8a97bcb1a320db414f9a06e/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:3bf92c5d0e00fefaab325a4d27828fe6b6e2a21848686b5b60d2d9eeb09d76c6", size = 2306309, upload-time = "2026-05-06T13:37:44.717Z" },
-    { url = "https://files.pythonhosted.org/packages/64/c4/be2639293acd87dc8ddbcec41a73cee9b2ebf996fe6d892a1a74e88ad3f7/pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:3ecbc122d18468d06ca279dc26a8c2e2d5acb10943bb35e36ae92096dc3b5565", size = 2369736, upload-time = "2026-05-06T13:37:05.645Z" },
-    { url = "https://files.pythonhosted.org/packages/30/a6/9f9f380dbb301f67023bf8f707aaa75daadf84f7152d95c410fd7e81d994/pydantic_core-2.46.4-cp314-cp314t-win32.whl", hash = "sha256:e846ae7835bf0703ae43f534ab79a867146dadd59dc9ca5c8b53d5c8f7c9ef02", size = 1955575, upload-time = "2026-05-06T13:38:51.116Z" },
-    { url = "https://files.pythonhosted.org/packages/40/1f/f1eb9eb350e795d1af8586289746f5c5677d16043040d63710e22abc43c9/pydantic_core-2.46.4-cp314-cp314t-win_amd64.whl", hash = "sha256:2108ba5c1c1eca18030634489dc544844144ee36357f2f9f780b93e7ddbb44b5", size = 2051624, upload-time = "2026-05-06T13:38:21.672Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/d2/42dd53d0a85c27606f316d3aa5d2869c4e8470a5ed6dec30e4a1abe19192/pydantic_core-2.46.4-cp314-cp314t-win_arm64.whl", hash = "sha256:4fcbe087dbc2068af7eda3aa87634eba216dbda64d1ae73c8684b621d33f6596", size = 2017325, upload-time = "2026-05-06T13:40:52.723Z" },
     { url = "https://files.pythonhosted.org/packages/ee/a4/73995fd4ebbb46ba0ee51e6fa049b8f02c40daebb762208feda8a6b7894d/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:14d4edf427bdcf950a8a02d7cb44a08614388dd6e1bdcbf4f67504fa7887da9c", size = 2111589, upload-time = "2026-05-06T13:37:10.817Z" },
     { url = "https://files.pythonhosted.org/packages/fb/7f/f37d3a5e8bfcc2e403f5c57a730f2d815693fb42119e8ea48b3789335af1/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:0ce40cd7b21210e99342afafbd4d0f76d784eb5b1d60f3bdc566be4983c6c73b", size = 1944552, upload-time = "2026-05-06T13:36:56.717Z" },
     { url = "https://files.pythonhosted.org/packages/15/3c/d7eb777b3ff43e8433a4efb39a17aa8fd98a4ee8561a24a67ef5db07b2d6/pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:90884113d8b48f760e9587002789ddd741e76ab9f89518cd1e43b1f1a52ec44b", size = 1982984, upload-time = "2026-05-06T13:39:06.207Z" },
@@ -2567,34 +1709,20 @@ wheels = [
 
 [[package]]
 name = "pymmcore"
-version = "12.5.0.75.0"
+version = "10.1.1.70.6"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/f5/51/e75186deeff67e4ba5b6c340343d7efc2d6819a2607e1927547754ea6183/pymmcore-12.5.0.75.0.tar.gz", hash = "sha256:c78670ff99ea2a4424d41eea7f0f0b6059053689af7700a5b19815fa8dde8390", size = 1418871, upload-time = "2026-05-06T08:34:20.948Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/d7/a4/1e67b6069406ea01b68e7dc2dcfd2e1c5f186005ea546809a265ea85bc8c/pymmcore-12.5.0.75.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:af494ad1729f0657c1bba4975c691892012c562c4ac661d5048f6ff23ed92f00", size = 952692, upload-time = "2026-05-06T08:33:48.171Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/82/473e57e60674565b6dc4d2bbf6a8d4f6376d638cf3b14efc186944c6e112/pymmcore-12.5.0.75.0-cp310-cp310-macosx_11_0_x86_64.whl", hash = "sha256:4b0207c75c556edab0fae5c45b6815ec432259730919543d9918fc3219cf94f4", size = 1002870, upload-time = "2026-05-06T08:33:49.806Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/e6/bdb7db16313d4b2eb54cf42562297cc06ae84e325cb06e5ee0d671c47122/pymmcore-12.5.0.75.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:aa0379fbaf91e82e8c801d270fb242e183cd91ed05bc8e7f7eea487d7a6bd932", size = 1249369, upload-time = "2026-05-06T08:33:52.063Z" },
-    { url = "https://files.pythonhosted.org/packages/74/20/b5d7dec09d1bca8d6474d0671bbbdb478a548a4a373ef43cec4caa9ced43/pymmcore-12.5.0.75.0-cp310-cp310-win_amd64.whl", hash = "sha256:03791c8cd38b3abfd55106a1aa4eb2defb0f91a1db8154bc6fbd1a4e4fa20c4a", size = 777813, upload-time = "2026-05-06T08:33:53.737Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/05/3e116795c4475fbacfff2814d1c582867ce25e9706619cae2a530398ea0a/pymmcore-12.5.0.75.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ed0baa677cd95194cccd19c7c7f937cdac9815e6334393573f11d8d5927dfae9", size = 952692, upload-time = "2026-05-06T08:33:55.373Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/28/90ed415b117bbfd94b5b76772631edbe828743c507898390541393e4c82a/pymmcore-12.5.0.75.0-cp311-cp311-macosx_11_0_x86_64.whl", hash = "sha256:9e566ea4f638d0dce84e783ff7c02ff9abbbe7b3ce60fefa9dc8b69f7f7cd82a", size = 1002871, upload-time = "2026-05-06T08:33:56.71Z" },
-    { url = "https://files.pythonhosted.org/packages/b3/a0/11b38ee2d97fcef695dcb0e7a1d500259569ee207dd61d53ebcc20d9af92/pymmcore-12.5.0.75.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6ec52998258906cfab5ec5d80cd42968d8d6277430bad49099d10f4c349ee636", size = 1249367, upload-time = "2026-05-06T08:33:58.256Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/7b/beea18cbdd04456635b3217bc40a5c315a48b0eedb692fda10b741a91fc1/pymmcore-12.5.0.75.0-cp311-cp311-win_amd64.whl", hash = "sha256:6f5dbc8f71085df8ac02216a6369da7a3c4afddb27a69f1f2490575b97634e46", size = 777921, upload-time = "2026-05-06T08:33:59.707Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/0d/03271a7952cbebeb8d773e4827415ed653179a7d6bb881a04db8e8c30613/pymmcore-12.5.0.75.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6cce904e951c868895809ca423b4b1935542928bec90f6c12f2ae2a91f725db3", size = 953414, upload-time = "2026-05-06T08:34:01.254Z" },
-    { url = "https://files.pythonhosted.org/packages/63/0c/e1456b1c1aa5cbaa9f6728a3f30cdcf30f8187b577a8ad062d345be9c750/pymmcore-12.5.0.75.0-cp312-cp312-macosx_11_0_x86_64.whl", hash = "sha256:b87f2a2c08dab610905575953e8dcc3f0cec999571c07f618c68ab2bbee201b4", size = 1006454, upload-time = "2026-05-06T08:34:02.966Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/b6/eaebb16c8aba2dd4657acb7116f1714bfdafffbdb2e9dcb79eaf506ee373/pymmcore-12.5.0.75.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1e64c3688a25d1a964b2e1ec732cacb83c01258a3e0f9e306b4bd9ebb4f4a4c2", size = 1250052, upload-time = "2026-05-06T08:34:04.57Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/76/a0059dee9fbca8d9b4214534af11e8c9ecc7a2520e6fe7eae09114ec2470/pymmcore-12.5.0.75.0-cp312-cp312-win_amd64.whl", hash = "sha256:6a8b0e7a0bac2af5496fefa6b6291f76a8640a75cb75adfaf28b1288e91340a5", size = 777918, upload-time = "2026-05-06T08:34:06.189Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/9b/1f23574154d25c08a7364615e2403e0c339c449fca37ebf16a1aa77b8cd5/pymmcore-12.5.0.75.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:0a559ac0e9e3918b19fc18d0cac733f12b328201f10c917d50b37f031935531b", size = 972415, upload-time = "2026-05-06T08:34:07.681Z" },
-    { url = "https://files.pythonhosted.org/packages/17/06/e03d10ef62060a31c67ae76bbf4a91afc021d01af4ed7e74b1252f6cd575/pymmcore-12.5.0.75.0-cp313-cp313-macosx_11_0_x86_64.whl", hash = "sha256:b427d9aadbf4c731b19d479b396ade5a872d16653d15030ce5467e8d820c57c9", size = 1020680, upload-time = "2026-05-06T08:34:09.06Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/d6/1ae1574b96b674f33a863f1656f0bdc4f95f28771b3c9144f4b1ec0d5fe9/pymmcore-12.5.0.75.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a07b4203822b65288946c1fbffd8bd3c413e23a1b0086ba8273ca98c7c721183", size = 1250853, upload-time = "2026-05-06T08:34:10.385Z" },
-    { url = "https://files.pythonhosted.org/packages/af/7a/9f8556ff3dc37ee67edf54543327864567abcb4941d0b3ff882adc0d9fa3/pymmcore-12.5.0.75.0-cp313-cp313-win_amd64.whl", hash = "sha256:e871d73da442a6d17ac7e39c239ddc61178cfc53a2e6386e4d4496d46a89926a", size = 777956, upload-time = "2026-05-06T08:34:13.006Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/5b/d2413012632b8e674bb55867e4354596fe5619af7e3cc91908925fce4725/pymmcore-12.5.0.75.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1f11aab098f0e36b9db7d4e73b82a217857bce065f42f36e154b71c9bfe3a918", size = 973291, upload-time = "2026-05-06T08:34:14.505Z" },
-    { url = "https://files.pythonhosted.org/packages/45/ff/c39e52d38c4f0d57c7f05d67387d07c1c49680a8ff17e59571480ca68d80/pymmcore-12.5.0.75.0-cp314-cp314-macosx_11_0_x86_64.whl", hash = "sha256:226164a2d424dc017e9cf9f675e732599fc8242d97a822f3141225adb075cf8b", size = 1023703, upload-time = "2026-05-06T08:34:16.318Z" },
-    { url = "https://files.pythonhosted.org/packages/65/e3/0ab664adde1eb500b54ce592dd361b2aa94d8159bc43bb835dd272686f34/pymmcore-12.5.0.75.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1bc6fb9aae9941337935b1ddf77c08d82c0dc1158e01d23cacc0048427329cb5", size = 1250626, upload-time = "2026-05-06T08:34:18.116Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/49/f5bb70814568022bdd1aa26f31321397e44d2e9c812d4b0bf322b01ddba6/pymmcore-12.5.0.75.0-cp314-cp314-win_amd64.whl", hash = "sha256:5dff6e13926d473e123a6e01732f99313442307157cbe65cecd94815527d4ea7", size = 792936, upload-time = "2026-05-06T08:34:19.568Z" },
+    { name = "numpy" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2c/44/7c379fcf379cd3cbf6ff33a62056b6ee174a3279b7f52bb8fcf696cf9633/pymmcore-10.1.1.70.6.tar.gz", hash = "sha256:d522b167daf0eb39076a0e83851ffa20ec1844d965cd3457350c6f1965f4bc47", size = 191558, upload-time = "2022-10-26T17:56:00.565Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8b/04/1f02e9df9cfdae350ae143c7a1dd88af9bbaf1d50645eed9056abaac872c/pymmcore-10.1.1.70.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:884db854b8b086538b2ef0b4e9708b776b390ad78bc6043e18e5786900ebe5af", size = 1930993, upload-time = "2022-10-26T17:55:30.944Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/6e/bcb1e26d0690c755c9e7197788120fcdcf4619ed787da185748f6e82f3f2/pymmcore-10.1.1.70.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ab8fde3ac3a65d933e1bf2f436de3803db8278de85cbbf12af97cbe81b36aa39", size = 1053868, upload-time = "2022-10-26T17:55:32.361Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/bf/a1a646472bb7242439ce993b3d96e1ec5d68576c73cf1084f78074097e8f/pymmcore-10.1.1.70.6-cp310-cp310-win_amd64.whl", hash = "sha256:7e4678a1fb29ee3709e3f90087ea44f1c00e63ad2506e63e9708a2026b78ce9a", size = 701538, upload-time = "2022-10-26T17:55:33.717Z" },
+    { url = "https://files.pythonhosted.org/packages/63/ad/6221eaf33a11f841a4f8e0768a339a034b8974c7fba49bad1f41e2885b71/pymmcore-10.1.1.70.6-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:b1cf7029d068536ee3bf5a6ef77516b8f874133c73f0c49b40f6e63b680bc4b0", size = 1931153, upload-time = "2022-10-26T17:55:35.7Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/11/61c80a9e96bb523d68c2b41b6289a3f266d1a093cd9a62eedee7f2c01b3e/pymmcore-10.1.1.70.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9b9ca87c8262ea6f671f9f833a60decdaa7e3d2a0633aee875d0c78847b5f271", size = 1053868, upload-time = "2022-10-26T17:55:37.483Z" },
+    { url = "https://files.pythonhosted.org/packages/78/8d/14ca497f6d4c2249773978cfac51602259ae9310295a319991229688f8ab/pymmcore-10.1.1.70.6-cp311-cp311-win32.whl", hash = "sha256:2dbf97e89edd60773da99129de4ac2546b8c1eca918d425ed42c7e842d34bfb1", size = 559198, upload-time = "2022-10-26T17:55:38.672Z" },
+    { url = "https://files.pythonhosted.org/packages/38/37/82c3aec19189dac632c4ed1d7a31d85e78b5daa10d3e493131db3208e020/pymmcore-10.1.1.70.6-cp311-cp311-win_amd64.whl", hash = "sha256:6cdce9441bc160d19229271439c5191f6a7a0b954e78c8c62e4592a73e11bb53", size = 701457, upload-time = "2022-10-26T17:55:40.102Z" },
 ]
 
 [[package]]
@@ -2606,12 +1734,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a9/cd/2e8cc2d648648186aab7e3eea76d89ad02f10eb752f3846c1aaba2c93e22/pyobjc_core-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:45fffb2b8dc0ae4480386429bd1e7fa8aabeb2eec81816d6971b33936dfcfff8", size = 6478736, upload-time = "2026-05-30T09:47:42.912Z" },
     { url = "https://files.pythonhosted.org/packages/c3/dc/b68d8bd769865d509fbcab81f5fae6497bd4e33409a44925e5d5e7c68d72/pyobjc_core-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:17b4e003af384d3086c2f39989a0b282c5755dd1066f331cf7c9fa65febe22ce", size = 6475918, upload-time = "2026-05-30T10:00:44.669Z" },
     { url = "https://files.pythonhosted.org/packages/24/be/4771f4fd786f0e1a2bd6d8931a72a5f3929b7bb1b28a1fe6ca8a08371c55/pyobjc_core-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:7677ed758a367bbbb5589d6f5276fb360a45c89168276c26162f61840b0fa03d", size = 6421145, upload-time = "2026-05-30T10:17:41.992Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/ed/6e62d038992bc7ef9091d95ec97c3c221686fe52a993a6501e961c757613/pyobjc_core-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:9287c7c46d6ae8676b4c6c0389a8f4b5381f42ae53a47151900c08b157e5a992", size = 6428611, upload-time = "2026-05-30T10:21:33.83Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/0b/d492110202f4d1050a5e590620ebd1e730cf89f9880a26cf18205e0f5800/pyobjc_core-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:515ecf2afe168301feb66a7230d700584ce2e4b8a0ac178e19450b8898384139", size = 6677992, upload-time = "2026-05-30T10:44:13.039Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/b2/ecfbd0c80e7688ed6f3db23414758443c69c3a9d318f2036e26530ede955/pyobjc_core-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:a51352e478785cd7fce1604b9902125a286139caea0759cb340e59d75b594992", size = 6421372, upload-time = "2026-05-30T10:47:27.907Z" },
-    { url = "https://files.pythonhosted.org/packages/2b/89/ecd5cb62573fba9a95f8bdb838a9860a360907104a0724af6611d3b20512/pyobjc_core-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:3137b2d14f9f2154fb5b1c092c38d15e164f68ab190c18335d76e4e7e1583f79", size = 6676789, upload-time = "2026-05-30T10:59:33.811Z" },
-    { url = "https://files.pythonhosted.org/packages/74/24/5091d156b19df0f657127f42b08eada11c9b9cc5df49fedb91bb354d9821/pyobjc_core-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:1e4216f2ec962dc13cf7f31b9bc3a7190337a0f401e7dc9de6b2d8c08b9dbb7a", size = 6476112, upload-time = "2026-05-30T11:21:46.914Z" },
-    { url = "https://files.pythonhosted.org/packages/77/e2/ee91ea8a0ad28e759f351ed8654027c34fc62ad5e207672522025a6a3fc2/pyobjc_core-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:ac952bac8057dd0b97ee7b311c39f97cad7430b7cfbd67ca0a30135a7d17d2ab", size = 6718365, upload-time = "2026-05-30T11:51:47.35Z" },
 ]
 
 [[package]]
@@ -2626,12 +1748,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/36/db/e86555b282c38bb0aadb63bf961c17e3ca70252774a677945f6bc4ee19c0/pyobjc_framework_cocoa-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:a2efad455ded551d1a033fd22245d57b71b6c065e8b52158dceed1611b5ae033", size = 387272, upload-time = "2026-05-30T11:57:27.512Z" },
     { url = "https://files.pythonhosted.org/packages/a2/10/95edbdee61731dc0e18633071fe56a4220879a92e9ba77c330a34add4b28/pyobjc_framework_cocoa-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:0bb7cd468ca89bbc2d1d8acb930b4f4fdce8826de30a66608fc28f8880c1f6a6", size = 387272, upload-time = "2026-05-30T11:57:51.391Z" },
     { url = "https://files.pythonhosted.org/packages/30/66/5a91f2eddfced4f26bc2df2bcebb7f5f10c5bf5666aff6fa00ded845af07/pyobjc_framework_cocoa-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:06cb92d97d1af9d1f459ae6cf1d1a7b824c12d3aff1b709885966acd6b7208c2", size = 388093, upload-time = "2026-05-30T11:58:14.921Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/3b/1af2be2bf5204bbcfc94de215d5f87d35348c9982d9b05f54ceefbc53b8f/pyobjc_framework_cocoa-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:f0bbe0abedfb24b11ff6c71e26cdefb0df001c6482f95591fad40c2688c16498", size = 388154, upload-time = "2026-05-30T11:58:38.547Z" },
-    { url = "https://files.pythonhosted.org/packages/41/cb/c0435d64f1199210af36141b90aea2ae3344719f7313d4160b8b0dd527db/pyobjc_framework_cocoa-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:46b6681e2b21b099ed095339c140f2c8137d6ac5658653166ee90722f9e3c621", size = 392245, upload-time = "2026-05-30T11:59:02.436Z" },
-    { url = "https://files.pythonhosted.org/packages/56/4b/df8e359e5e422e8f1430bde038aa64364e8c1d4542d7f6fcc4f8a97ec0b7/pyobjc_framework_cocoa-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:aecfd44908fa12a9291fb6ca2458ebbc611102de6784f2202a35fd5ed9f56c60", size = 388334, upload-time = "2026-05-30T11:59:25.861Z" },
-    { url = "https://files.pythonhosted.org/packages/43/a2/68c0702cc9d6dbc7077edbd13ccc9aa30ac589d514f51ad6f5c3840e3bf1/pyobjc_framework_cocoa-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ef679740f541c52118149b558b757d1f11d9dcf30c2a23344b13a6af6a99a1ab", size = 392376, upload-time = "2026-05-30T11:59:50.031Z" },
-    { url = "https://files.pythonhosted.org/packages/83/c3/e170672302e75cc1aa833546fb0d5a3bd4a126ede4124566d5a2e4a50cd6/pyobjc_framework_cocoa-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:290e544a8c2d0786a34a359d825eaad44ebaaa3b30cdd765b2755422ca39a0d2", size = 388566, upload-time = "2026-05-30T12:00:13.606Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/6b/78e98e4de11646e56cf98066f9f84b43c86adc8b273a660d85a6ceba7a31/pyobjc_framework_cocoa-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:5a0bed77b0b56074cc2b4564aae3e6e9d5da5fdf93252f50b6dbced0f7fece3a", size = 392674, upload-time = "2026-05-30T12:00:37.572Z" },
 ]
 
 [[package]]
@@ -2647,12 +1763,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0a/2e/03974693bf040ff819f3141f4ee88bfd190407370e83fcab70472698eb8f/pyobjc_framework_corebluetooth-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:c2732cd05d26ac1541ce41cc6ece4d94108601ed503ddfe6dc6afd36a834cd65", size = 13164, upload-time = "2026-05-30T12:01:57.971Z" },
     { url = "https://files.pythonhosted.org/packages/1c/2d/ee819fde6d48f2d43733ae40097f4872e1129fbca40847d434939cefa552/pyobjc_framework_corebluetooth-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:b03beace02ca1963697f35faf4d3d0263f707e0182f67950212c890dd9d19e6f", size = 13169, upload-time = "2026-05-30T12:02:00.003Z" },
     { url = "https://files.pythonhosted.org/packages/8b/9a/99e61547e61b0e38cb13c67931f9ca9bbd1dc72c1ff78322c7c3af805e8b/pyobjc_framework_corebluetooth-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:31da3686ea55e9f7f8fc321fe2fcdf23827acd24c91ae1798e47e1f3a8355ab7", size = 13191, upload-time = "2026-05-30T12:02:01.811Z" },
-    { url = "https://files.pythonhosted.org/packages/25/eb/04f0ea541e6df3b7a328fe63ed1f508898d84910be66ae0f4d08103ad5a1/pyobjc_framework_corebluetooth-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:b43a21eb9388453c867ce82bf5d475cfce4fe2ceaea974474071f1cfd178f40f", size = 13205, upload-time = "2026-05-30T12:02:03.831Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/b7/502b1e5ff1feede7fbed1f28e1fd14604cf564e4a4f5d4f33c93a4706739/pyobjc_framework_corebluetooth-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:162623f74c85041bb8a2c9a8862cee6674531d603ad7a8d65a3efc81619f84c5", size = 13389, upload-time = "2026-05-30T12:02:05.647Z" },
-    { url = "https://files.pythonhosted.org/packages/a7/ef/a75bd6c17e012f7d73a8a2d94e324528a82dc06451b6019d910b1a993864/pyobjc_framework_corebluetooth-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8a3b35a1253de626d5efe705dda36a4f1fb8753e48aafdc4dbf99dc9c9526d86", size = 13196, upload-time = "2026-05-30T12:02:07.462Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/d7/11a8a90463e6a3928274e65bd17acaa3f0bfbd9c19a68b93c61cbc4fa379/pyobjc_framework_corebluetooth-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:bd0b9e7bc2fffcfa4843d7f103e1e927ce37817a70932d080378e1e29a073381", size = 13387, upload-time = "2026-05-30T12:02:09.431Z" },
-    { url = "https://files.pythonhosted.org/packages/10/d0/d5cc4ba6dbe21f6f4c90e8f0087254f1f742134580394b763025416ab7d2/pyobjc_framework_corebluetooth-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:a2dd4bd8fde13b97a3339a42d6703c9c9b148663e2e23a184ffe2877c8e51470", size = 13192, upload-time = "2026-05-30T12:02:11.41Z" },
-    { url = "https://files.pythonhosted.org/packages/25/a0/964b18affc8f6b582ed891f3b59413452fd95acce4adbf070a389b5197e4/pyobjc_framework_corebluetooth-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:42db087cd3a328abc620c76c7f708d7c2b451f3dbc0779983812a0c84320fe60", size = 13394, upload-time = "2026-05-30T12:02:13.443Z" },
 ]
 
 [[package]]
@@ -2668,12 +1778,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ba/fb/b6948caf3e365aa3ad9400376832258ab25a10a43423d47a1be6d9ddef9c/pyobjc_framework_libdispatch-12.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:0a43de8025ef9e2db597dbe3d2b49c9952d0b0aa93a78d89b0bfdc58f851f42c", size = 20466, upload-time = "2026-05-30T12:11:56.667Z" },
     { url = "https://files.pythonhosted.org/packages/22/2b/b8d686307f4e8ba65afb204623da0b5568ac624caafc3a777a107c57fec1/pyobjc_framework_libdispatch-12.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:38fb417f3f3ee1ec20e14821f150210f5b6122e5c1d8b04958bddb660ce3d04f", size = 20462, upload-time = "2026-05-30T12:11:59.253Z" },
     { url = "https://files.pythonhosted.org/packages/e3/9e/94b587d8c5b243cb6026489752093a45d75fff08c85ed5b8b5548ad3596a/pyobjc_framework_libdispatch-12.2-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:9fb0028b400661b6b2279e2b611d396a4217bc36aa9dadd3ae21419551f5e091", size = 15634, upload-time = "2026-05-30T12:12:01.08Z" },
-    { url = "https://files.pythonhosted.org/packages/83/ac/f5e01c960287e3484f71a737e7ffd75ca1c192200de70fa342a22181895f/pyobjc_framework_libdispatch-12.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:265fe4edfd60de111c870932ab8397f845c314332a935aa7a27100fd8562cebc", size = 15651, upload-time = "2026-05-30T12:12:03.156Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/d9/8bcb4e234aee09396d06515ed80fb1f79cee3aeb67a311aa8e81a085584b/pyobjc_framework_libdispatch-12.2-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:117ed20ca54e334f657e60b9b9a3de3741d91875fd50ee51ac6a09224912cc68", size = 15918, upload-time = "2026-05-30T12:12:05.257Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/0e/caee3281628ba4913206167062274334a62ba5dedb8dada5fd884a53584f/pyobjc_framework_libdispatch-12.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fef3158dd4a068a9db8108a5cbf7da385788136e1d8af2e6fb7f82215016ecb2", size = 15679, upload-time = "2026-05-30T12:12:07.217Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/e0/ecf5fb9f11d12271818c5244c57d36ee654abfa2d15799bd594d4f58d931/pyobjc_framework_libdispatch-12.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:02dc66f1c11e25eceecf3c1b2b397f1727659dcac3e0c7b97784d5af3cfab491", size = 15960, upload-time = "2026-05-30T12:12:09.199Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/74/c1d1d1fc45434dcbab16887273d368d9ad89e65939babcffd502ed308ef9/pyobjc_framework_libdispatch-12.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:a81d9329fdf5094c9bc09b916e1d2fb86ab27138161d3e7ddb76ec2e780a1aba", size = 15699, upload-time = "2026-05-30T12:12:11.103Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/46/6ba13e10cbac853af00ee37444f37826a0688e32d1d22ce2fde4e2add9d3/pyobjc_framework_libdispatch-12.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:8daaf8844b5b328cf8adb6e8c085bf2aad22237956f7c5dc6fbb7a46c5015af0", size = 15990, upload-time = "2026-05-30T12:12:13.077Z" },
 ]
 
 [[package]]
@@ -2699,13 +1803,13 @@ name = "pytest"
 version = "9.0.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
-    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "colorama", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "iniconfig" },
     { name = "packaging" },
     { name = "pluggy" },
     { name = "pygments" },
-    { name = "tomli", marker = "python_full_version < '3.11'" },
+    { name = "tomli", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
 wheels = [
@@ -2717,9 +1821,9 @@ name = "pytest-asyncio"
 version = "1.4.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "backports-asyncio-runner", marker = "python_full_version < '3.11'" },
+    { name = "backports-asyncio-runner", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "pytest" },
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/43/7c/d36d04db312ecf4298932ef77e6e4a9e8ad017906e24e34f0b0c361a2473/pytest_asyncio-1.4.0.tar.gz", hash = "sha256:c6c0d2259945122819f171a32ecea2c349ead889ee28176caaf492143424be42", size = 58514, upload-time = "2026-05-26T09:56:04.083Z" }
 wheels = [
@@ -2781,34 +1885,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
     { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
     { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
-    { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
-    { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
-    { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
-    { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
-    { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
-    { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
-    { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
-    { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
-    { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
-    { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
-    { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
 ]
 
 [[package]]
@@ -2817,9 +1893,9 @@ version = "0.37.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "attrs" },
-    { name = "rpds-py", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "rpds-py", version = "2026.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "rpds-py", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "rpds-py", version = "2026.5.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
 wheels = [
@@ -2831,7 +1907,10 @@ name = "rpds-py"
 version = "0.30.0"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
 wheels = [
@@ -2879,64 +1958,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/6f/ab/d5d5e3bcedb0a77f4f613706b750e50a5a3ba1c15ccd3665ecc636c968fd/rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf", size = 223782, upload-time = "2025-11-30T20:22:37.271Z" },
     { url = "https://files.pythonhosted.org/packages/39/3b/f786af9957306fdc38a74cef405b7b93180f481fb48453a114bb6465744a/rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b", size = 240463, upload-time = "2025-11-30T20:22:39.021Z" },
     { url = "https://files.pythonhosted.org/packages/f3/d2/b91dc748126c1559042cfe41990deb92c4ee3e2b415f6b5234969ffaf0cc/rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e", size = 230868, upload-time = "2025-11-30T20:22:40.493Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" },
-    { url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" },
-    { url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" },
-    { url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" },
-    { url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" },
-    { url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" },
-    { url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" },
-    { url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" },
-    { url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" },
-    { url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" },
-    { url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" },
-    { url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" },
-    { url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" },
-    { url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" },
-    { url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" },
-    { url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" },
-    { url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" },
-    { url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" },
-    { url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" },
-    { url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" },
-    { url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" },
-    { url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" },
-    { url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" },
-    { url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" },
-    { url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" },
-    { url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" },
-    { url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" },
-    { url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" },
-    { url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" },
     { url = "https://files.pythonhosted.org/packages/69/71/3f34339ee70521864411f8b6992e7ab13ac30d8e4e3309e07c7361767d91/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c2262bdba0ad4fc6fb5545660673925c2d2a5d9e2e0fb603aad545427be0fc58", size = 372292, upload-time = "2025-11-30T20:24:16.537Z" },
     { url = "https://files.pythonhosted.org/packages/57/09/f183df9b8f2d66720d2ef71075c59f7e1b336bec7ee4c48f0a2b06857653/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ee6af14263f25eedc3bb918a3c04245106a42dfd4f5c2285ea6f997b1fc3f89a", size = 362128, upload-time = "2025-11-30T20:24:18.086Z" },
     { url = "https://files.pythonhosted.org/packages/7a/68/5c2594e937253457342e078f0cc1ded3dd7b2ad59afdbf2d354869110a02/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3adbb8179ce342d235c31ab8ec511e66c73faa27a47e076ccc92421add53e2bb", size = 391542, upload-time = "2025-11-30T20:24:20.092Z" },
@@ -2956,8 +1977,11 @@ name = "rpds-py"
 version = "2026.5.1"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/2e/43/25a8dcd3feedd735039a8f0b5b7e3b118232b5eae288c4fd9ab200d41094/rpds_py-2026.5.1.tar.gz", hash = "sha256:07b24fea40541e28570e5b795a4a38fbdcd12550c06bd0748005ecc8116ca256", size = 64459, upload-time = "2026-05-28T12:02:13.232Z" }
 wheels = [
@@ -2991,93 +2015,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/04/1d/9d12b0a337bab46f4769f8857f4007e3b2d639e14f9a44a0efe157696e64/rpds_py-2026.5.1-cp312-cp312-win32.whl", hash = "sha256:6736718bd4fc49cbcb538ba30516fdbef161522acefb739657d48b97bd864fed", size = 212734, upload-time = "2026-05-28T11:59:29.689Z" },
     { url = "https://files.pythonhosted.org/packages/c5/93/e4116f2de7f56bc7406a76033dc501811ddeb22b7f056b92d632871ebb0c/rpds_py-2026.5.1-cp312-cp312-win_amd64.whl", hash = "sha256:0a7d1eec967df0e9b22614a5e177622e0c89611d03727fa0cb48e45028907870", size = 229045, upload-time = "2026-05-28T11:59:31.033Z" },
     { url = "https://files.pythonhosted.org/packages/cb/53/6c3419d85eb2ec5938a37627c585b42d76a63bb731d6e42ed4b079ebf486/rpds_py-2026.5.1-cp312-cp312-win_arm64.whl", hash = "sha256:1841d067089e117142d79b98aa0df2f08b52f2ecc1819dd2700636c0db74a473", size = 223967, upload-time = "2026-05-28T11:59:32.318Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/32/14c961ad295f490eb0849ada8b79683e93a59b9de3afdd983eaf55fa6867/rpds_py-2026.5.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:efef4ac29c6ff495531eb17ee705b62841ecaa291b7c7077e848ea03e237164d", size = 352787, upload-time = "2026-05-28T11:59:33.655Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/bb/d1b85117967c11191441a7274ae616c65d93901d082c588f89a50a8da5ae/rpds_py-2026.5.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c39f5b67a8a2e67179ada2a954227d670fe65fa9098457f698f56ddf248709b3", size = 345179, upload-time = "2026-05-28T11:59:35Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/46/d84105f062e626a1b233f863907288a4708c2d833b8b4c6fb2764bc080c0/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5c30f3f04eef4fbd362226a6f31d7c8895ca4fbb6e0b790f6890a98d8da8559", size = 376173, upload-time = "2026-05-28T11:59:36.43Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/ae/469d7959ce5b1201e1de135dc735b86db3b35dd0d1734f6a44246d5f061c/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:277f6c82f0580848796c7ecc8a7173aa3bfb928e4ff831261c2f60a81dc270db", size = 383162, upload-time = "2026-05-28T11:59:37.995Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/a2/57853d31a1116a561aa072794602ad3f6341e18d70a8523f1bd5b9fc1e5a/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:63c2c4c213f1a4e3f3de28ecab029dbdee976324e729c0d7a55211be72576b02", size = 495093, upload-time = "2026-05-28T11:59:39.453Z" },
-    { url = "https://files.pythonhosted.org/packages/99/63/3a8eabcad9314b7daf5c65f451d2c33d989235cd8a5762186cf2c3f5a4f8/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3350ec808fb538fe71a1f94dfaa0e29c598dfad805ce49f0caec5ae3183c652b", size = 389829, upload-time = "2026-05-28T11:59:40.896Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/25/05678d97fc25e2622df14dc530fb82023174ecfff6733991ed0d78f167bd/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b1b964e3ab599e718dc46c018d104b1ebc007cbc6567d827c94a687fca56d77e", size = 374786, upload-time = "2026-05-28T11:59:42.626Z" },
-    { url = "https://files.pythonhosted.org/packages/88/d1/8c90b6431e80a3b91b284a5c7c8c0c4f9c006444d90477a740d6e0f9c694/rpds_py-2026.5.1-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:19cb09fab7b7fc96b2a6e28f2e34b72a3705ff27b37edb77455316e5d3f3dc9b", size = 386920, upload-time = "2026-05-28T11:59:44.124Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/99/4638f672ab356682d633ee0da9255f5b67ce6efd0b85eb94ad3e255e65a5/rpds_py-2026.5.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:abe76bcdba31e576cb83eeb8797aa0d882b738fef6dc65d0601fc753806a5b46", size = 405059, upload-time = "2026-05-28T11:59:47.177Z" },
-    { url = "https://files.pythonhosted.org/packages/66/3f/3546524b6eb4cc2e1f363a3d638fa52f6c24faae3500c25fb488b02f1740/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:8bff7073db3899158fff55ebf57b113a67030af26f80a18978f9f0aa60250ddf", size = 553030, upload-time = "2026-05-28T11:59:48.603Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/c3/7b3388c796fcf471bd17194242d4dc1a7608567c0fa422bcc1c5e79f9c1e/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:8ba264fa49be666cd9cc56bf34ec7002fb3d27a4aee5bcb4d43d0d18feb1bb6f", size = 618975, upload-time = "2026-05-28T11:59:50.314Z" },
-    { url = "https://files.pythonhosted.org/packages/61/1e/a3cb07f2795075d1d88efddae2f541359fde5f08c81ee114c29c2949c90a/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4860b603ddda0475a8885499b3729e90229d480105b42651962a5397d995fa89", size = 581178, upload-time = "2026-05-28T11:59:51.673Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/74/e758c03a5ef46f04c37f2651a2893db846d569ba8a7bca469d4b58939bcd/rpds_py-2026.5.1-cp313-cp313-win32.whl", hash = "sha256:7944270ae71383f6e2657dd7d5ce4eeb4ac2d0059a6738f0510583d462ab4842", size = 212481, upload-time = "2026-05-28T11:59:53.148Z" },
-    { url = "https://files.pythonhosted.org/packages/70/ec/a2aca432db9c7359b40fa393eeeaa0d166c2f70175be956e75fa24197c44/rpds_py-2026.5.1-cp313-cp313-win_amd64.whl", hash = "sha256:88647f43a73c4e01be19b04ceef0c8d3a1958153604d13c773becd8016f2a0cf", size = 228519, upload-time = "2026-05-28T11:59:54.505Z" },
-    { url = "https://files.pythonhosted.org/packages/29/60/a73bfdd45b096574556acf303bbd9fa9eed36ca8a818b514e2a5d5fe2b9d/rpds_py-2026.5.1-cp313-cp313-win_arm64.whl", hash = "sha256:453895624ecf7db7063b1004e44037522bbaef9ff6a945e59bc71662d7a03abd", size = 223446, upload-time = "2026-05-28T11:59:56.081Z" },
-    { url = "https://files.pythonhosted.org/packages/18/e2/408105fd611823f00882aea810f3989a30d26b1bab8b6beb20f98c724e0e/rpds_py-2026.5.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:b4e4bc98639ec915f512fde3aa7a95e0041d95d9c3cc86eea841fa63cb1e8600", size = 355287, upload-time = "2026-05-28T11:59:57.448Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/58/5c4a43436843c90d0f6d19f82c200c80e3843ca9fa07b237623327f6d384/rpds_py-2026.5.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:cacedb7a6e167680acba45ad5716e89067d225dc80da0d7040cae8c81d4572fa", size = 347033, upload-time = "2026-05-28T11:59:58.881Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/c2/1a71acdacaf4e259b10278fb87b039ded3cf80041bcd89dd8a3ea702ded6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:68700371c5d7ae1412862ddfa719090925c93ecf351c566d66f09d04b136ea00", size = 376891, upload-time = "2026-05-28T12:00:00.516Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/c8/535f3d9b65addd8e28aa87b83c6e526799c3717a88273db8ea795beeef7a/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:296c799becfa849c779c8725494fe9ed94959ed886787df4364b058465bad7f0", size = 385646, upload-time = "2026-05-28T12:00:02.394Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/91/dc033f313345c354ade914dbe73cdb90b615a4409ea02430d5356794f3d8/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d3858b908218ee108d0bbfb2095ccc237648053c9bf98affad7cb079acaf1d97", size = 498830, upload-time = "2026-05-28T12:00:04.189Z" },
-    { url = "https://files.pythonhosted.org/packages/27/fc/90fcbea459dbb8ddc18a2e0fd1de9412b48bc84ffff2db771cf714bacfd6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4fb8d2e7cb2f850b169806d61d1b991738acec96500a75c30f49caf064ce7cef", size = 392830, upload-time = "2026-05-28T12:00:05.797Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/1d/46cd11a228c9750684a798d98f878be6f614aa762438da7378f035e79e35/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:27b74c10ed6a8f190f4287f53bcfea348b92a84a9c9f70d30183d1e6172d580d", size = 379613, upload-time = "2026-05-28T12:00:07.433Z" },
-    { url = "https://files.pythonhosted.org/packages/24/4a/d9b0c6af3a1de03eb93741bbe8be2bdce84d8fda8224f3005451d86df389/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:b9a6528956191c48c52294a592dbd4a8386d7048bdb25c0efcb6b966466c6d83", size = 388183, upload-time = "2026-05-28T12:00:09.227Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/b4/db7aaabdda6d020afc87d981bcc2f57a434c7dec60ecfc2ab3dd50b20351/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:af03e34e860047bc7a352b842856fcf78798fbb81132cc98bd2f907ab4eb9cd2", size = 408578, upload-time = "2026-05-28T12:00:10.779Z" },
-    { url = "https://files.pythonhosted.org/packages/08/d6/070f6a41cbb343e2ac4171859bf3f3623e0ab002f72619d6d505313ec2de/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:fea6e836d10abbe191d557d33bd58bd5987725fe63aa1eefe557d230209855bd", size = 553573, upload-time = "2026-05-28T12:00:12.443Z" },
-    { url = "https://files.pythonhosted.org/packages/75/ab/1a71ea3589c4345dac0a0518f0e6a031cb42689277851b683c46d27463a5/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:fc0c0f878ea770a0a8a462456c5ad36fc9fe6358e6b76fdadc7f17575e0b8bf1", size = 620861, upload-time = "2026-05-28T12:00:14.09Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/22/9bf80a56069c0c443fcfefac639a86a744550a2898817a6dfd3e26654924/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:e0b360f316d966b048b085857630b3cc51f3db2f07b06f440eac8f695374d1e3", size = 585633, upload-time = "2026-05-28T12:00:15.66Z" },
-    { url = "https://files.pythonhosted.org/packages/da/68/3b2c0a75c9e04125696f84ebdbbf304acf5a40b58ba4481cdb98a922c3ba/rpds_py-2026.5.1-cp313-cp313t-win32.whl", hash = "sha256:a2999883eedf72fdfb7520b92c7d4ec2572a71ff40239377aa604cc529eecafc", size = 210074, upload-time = "2026-05-28T12:00:17.291Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/8b/609157d5a25d37d4f29f92840ba531f416907c34ae5c5739dd21fc2bef98/rpds_py-2026.5.1-cp313-cp313t-win_amd64.whl", hash = "sha256:e07be2a9d7122bd6e82dea89814ef8dc893feb1aae97fec1630f3263bbb30e55", size = 228635, upload-time = "2026-05-28T12:00:18.73Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/6f/19c1918a4b590d8de87e712e4abe4b3875771eff60216fb6153cf6665c68/rpds_py-2026.5.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:1f2c391c3059798093b65df23aca2cac150460ae9c630d99dec83d703d9485b9", size = 349756, upload-time = "2026-05-28T12:00:20.217Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/60/a06fe7da34eca79dacbf958a2ba0c6eea85bc2b29de20080bf40f72f66fa/rpds_py-2026.5.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:413b424f7c4ee65ab5e5be91f5731be0f8b41a1ee2b12dfe810d716312e95a78", size = 343831, upload-time = "2026-05-28T12:00:21.711Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/ec/b2333b97b90e2a6ef6ca8ad386ee284968e74bcfe113b3f1a8d9036429a9/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2c595a1d9255dce0599e13130d1440ab2506654f2b50294226ee06402f8fef63", size = 375127, upload-time = "2026-05-28T12:00:23.326Z" },
-    { url = "https://files.pythonhosted.org/packages/14/7f/e00aae54067f2b488c4637961d5f58204d470795fc791085fa3f15060d2e/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1c27c5f6102eac8c03e7595a00827a53b271ba40a53b59ff8709170e0855ea4a", size = 379034, upload-time = "2026-05-28T12:00:24.89Z" },
-    { url = "https://files.pythonhosted.org/packages/be/cc/423999bbb8ae8dc93c77fc1d5e984ade5eb89d237d3bb884ccfa72ae2890/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6c7fcf61d44cacecaf3aea542b0e053db77972a4573e7ceda16fb2b399161195", size = 490823, upload-time = "2026-05-28T12:00:26.676Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/aa/c671bf660f12e68d3c52ff86c7066ed1372df5a0f4f2ff584e419b8207e7/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2c817a189d4ee14290420e5ff051e4dd6baa13f3edf84685071dee07a6d538ee", size = 388144, upload-time = "2026-05-28T12:00:28.577Z" },
-    { url = "https://files.pythonhosted.org/packages/19/c8/d63bb75b68afe77b229e3021c6031bcaf01da5db5b0e69d0d10f9ba679a7/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21846aac0ed2e0589f38c12dc44e77bb64e494b771eadbcf169cba00566ba7ba", size = 371959, upload-time = "2026-05-28T12:00:30.304Z" },
-    { url = "https://files.pythonhosted.org/packages/82/35/c51122014d8274ff37dc606d60049c3db7d83da02b5b282511e5a906a9a6/rpds_py-2026.5.1-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b317c87a13f769a4e787819bd508aaa5d69aa09b0880de9af6d3a8a54571cdec", size = 383558, upload-time = "2026-05-28T12:00:31.764Z" },
-    { url = "https://files.pythonhosted.org/packages/e3/f9/2790cb99c136a5363acdeacf5c27c56f3de0d4118a1f48fca83404c99c89/rpds_py-2026.5.1-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ce87129d9f2c14fa6c4a8601fb80eb4488c80d38a20cd13758ef11123e14995d", size = 402789, upload-time = "2026-05-28T12:00:33.247Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/1b/e4fb584f8c75d35c38150ff6a332cda949e6f97acba1f4fd123b14ab56fe/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9cdddb6c1207d284d94fd1530adf57fbd797fe7c4b8704ba85f49414f2557e7d", size = 551405, upload-time = "2026-05-28T12:00:34.819Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/f7/a6731b4216cb3793ea1af5391da240f5683dacc0d13e034fe5fc3503f240/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:4e237e139f94d3c036fd28eb9f564c99055476ff4ff05cd42be55ce349b5aa02", size = 616975, upload-time = "2026-05-28T12:00:36.268Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/ea/2e051a81d95d8e63f4b35a1c463a87e8766bc3d083c067c5dfb6bf220747/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ed0954b524873214369184a9c82b0eaa45a3fbb9a798cd95b17e0d98499e7ea0", size = 578701, upload-time = "2026-05-28T12:00:37.82Z" },
-    { url = "https://files.pythonhosted.org/packages/65/56/b5f6fdb2083e32bca8a8993d89e70db114b4756c9e2c38421328126689d2/rpds_py-2026.5.1-cp314-cp314-win32.whl", hash = "sha256:2d88621d6a7d4dfa633d21abe90f280bb205274e16b1d1e61c6ad4640b2453b7", size = 209806, upload-time = "2026-05-28T12:00:39.492Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/80/65a5aa96c155e611d1ed844e4e1f57f3e36b021f396d9f8585d756e6b90d/rpds_py-2026.5.1-cp314-cp314-win_amd64.whl", hash = "sha256:cef8ac28d26f4dda3533060c20fbf80a325458fa9fd23ea72a73cdfa8e978838", size = 225985, upload-time = "2026-05-28T12:00:40.94Z" },
-    { url = "https://files.pythonhosted.org/packages/27/7c/ad185212e87b05f196daef92bc5f3caf07298eb47c295b5585c3dd3093ac/rpds_py-2026.5.1-cp314-cp314-win_arm64.whl", hash = "sha256:eaaea962c68cdc68d4a533ba985ab8e9484277910bbfaa2ab3ef7732667bfed8", size = 221219, upload-time = "2026-05-28T12:00:43.15Z" },
-    { url = "https://files.pythonhosted.org/packages/23/58/e14ae18759020334646b031e708ab4158d653a938822bfb7b95ef2e93aa3/rpds_py-2026.5.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:21942f52dbbd5f8758bf021213d28bd45c39e873e65e2407faf5f1846f5761ad", size = 352148, upload-time = "2026-05-28T12:00:44.638Z" },
-    { url = "https://files.pythonhosted.org/packages/31/9b/5f4a1e2f960bca3ac5d052b139dd31eed97b259f9d909173821760d542e8/rpds_py-2026.5.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f414556f6e3958300ff941e40c9f97e3dc9774ddd1b3434c475d73dd354bbed3", size = 345196, upload-time = "2026-05-28T12:00:46.14Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/71/1d9574d6a2fa20ab60eaa55c7467f5aa20cbc770f341a05f09c0876f59e2/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ef1013a8625c74043210190b246f5b1551e09757c1f356c6e4160ef96c5bc081", size = 374981, upload-time = "2026-05-28T12:00:47.531Z" },
-    { url = "https://files.pythonhosted.org/packages/0c/9a/37e99f4915a80aa71670263c1267f7ae0af95f53a3f61e6c3bdc016d4515/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cc68e231a77a5f0d774ae278a1f8e55c0456501820847c1e4efb3829f3441df6", size = 379961, upload-time = "2026-05-28T12:00:49.216Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/ff/6e73f74b89d2e0715e0fc86b7dde893f9a61ae2f9b256ff3bdfe41ac4e94/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9baffb505aff33acc69b422a19f77806680f3c8632227d79f48de8a810d1c2c5", size = 495965, upload-time = "2026-05-28T12:00:51.111Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/e0/425faba25f59d74d4638b267f7c7a80e8649d2ef4db10a19b0c4a71e6e6f/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b8d2f912928d426e8cfa396f7f3f8d29a59e6689c86dcca3c420730c1096322b", size = 389526, upload-time = "2026-05-28T12:00:52.77Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/76/7a41960e3fddae47fab43a28684d5da981401dffd88253de0944148654cb/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90f628283be835db980c941767d41c9a27b5239e54ba0a9c1335247e82406964", size = 376190, upload-time = "2026-05-28T12:00:54.215Z" },
-    { url = "https://files.pythonhosted.org/packages/27/60/5f38dc70824fc6951b51d35377e577a3a3a4c81a6769cc5a2de25ebe0ad1/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:1ebb2f0ab7e16132995a72de805170e0203df0c3dd22e1ef1cd1fdd90bd7a131", size = 383921, upload-time = "2026-05-28T12:00:55.673Z" },
-    { url = "https://files.pythonhosted.org/packages/60/1a/d60a38caa1505f4b9483c3fbbde12c94e1079154f4f401a6da96f7e77621/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f3df3d16ded76f1f8c9cdebd0e1ea55fdf4c23b812de189814da7cf229c22a81", size = 404766, upload-time = "2026-05-28T12:00:57.518Z" },
-    { url = "https://files.pythonhosted.org/packages/87/ff/602fd3f174d6425f0bce05ad0dfbec0e96b38d0f7d08a79af5aa20083885/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9af8905b8f854990e40d5206aa5ac58d9b0fe0b7f351ff2bb086c20f6c8c6a47", size = 551343, upload-time = "2026-05-28T12:00:58.978Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/c1/1be13327acdbead3eca1fde03b6a34dbb011f1e864e217f0d32cc1779a7f/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:036a36a87fb1cd3b214d11c4b3c4f7d2ddad933625dca1c900b56a057c07740a", size = 618502, upload-time = "2026-05-28T12:01:00.656Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/d7/afb49b49d7f2be8b7ba1a9f0977fa5168003437b93086726f066544e8351/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:62ae3853454fe9ef283a03c96c2d835d39e84b14643a9d62c82ef0fb87d702ca", size = 581916, upload-time = "2026-05-28T12:01:02.22Z" },
-    { url = "https://files.pythonhosted.org/packages/25/d1/dbef8c1f8a10f07beb62b5f054e20099fd9924b3ec001b8f0b6ac7813a85/rpds_py-2026.5.1-cp314-cp314t-win32.whl", hash = "sha256:6c3d771a46ec18b12af06ce36243a9a80b07a5d0515236332d90863ca8bb326a", size = 207855, upload-time = "2026-05-28T12:01:03.821Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/72/bfa4e61ab8e7dc1c8adf397e05e6cbdd4239357bd72b248d3de662f23915/rpds_py-2026.5.1-cp314-cp314t-win_amd64.whl", hash = "sha256:c93c629be4636cf54337bd5f06c104d55e42ced54d681f6fe21ae510a65116f6", size = 225422, upload-time = "2026-05-28T12:01:05.194Z" },
-    { url = "https://files.pythonhosted.org/packages/27/3a/7b5da92b640f67b6717ccafc83cdd06bfa7ff2395c3685c68922bb54d703/rpds_py-2026.5.1-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:3574b55c604b8f75dacb007136508bbc0db406e626301778096a133327e7f2fb", size = 349576, upload-time = "2026-05-28T12:01:06.722Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/8a/2aafd7ad355a1bd48ca76e2262b74b15e6432b5a1efe150efd4d779cd55d/rpds_py-2026.5.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:94068eb3ae6d43f5a786b7db96a406a34e6d5c24489feef32fd6e8946ea7b291", size = 343640, upload-time = "2026-05-28T12:01:08.441Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/7d/6c9523c1abbe840a1b7fba3c516d48e1d3487cc80fea4366c4071cf56784/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f3a5b10e8ce894825f380a8f1b6444cf73c294dfea62afbb2d13e3a9e630cec1", size = 375322, upload-time = "2026-05-28T12:01:09.934Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/5d/0b7b03fb1dc509321f01de3149784ab773e34c8573022029af8076afcb9c/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fc09f82e63d4bcd58149572f857a431bae851dc747e313c3b5bdf7abb907fda8", size = 379066, upload-time = "2026-05-28T12:01:11.48Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/e2/8ef6012999ebf1cb1c22f876d9ce5e63d960fd4631d2af3202d3f480aa25/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e10464d17df3b582745c25cec695cb9558bca2cb6ddb631aee1787fc72c767b2", size = 494586, upload-time = "2026-05-28T12:01:13.051Z" },
-    { url = "https://files.pythonhosted.org/packages/80/af/1eeb029bec67582c226b7809172207cd005073af4ebd906e65ff494f4983/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ba05adbf15d994c38ec0b7ab32e858e5110c21e9009a00a86545fd220f84e038", size = 388415, upload-time = "2026-05-28T12:01:14.631Z" },
-    { url = "https://files.pythonhosted.org/packages/18/23/ffbe10711c4d766c1cab0557d6906c074f795814863c67b351355d29354a/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:77c004fdc7b891967106f78ddfd7b076bfe6813c6139c6fff6aed3bcaa960b26", size = 372427, upload-time = "2026-05-28T12:01:16.153Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/3a/30ba4a6ad457e5b070c18d742a33fb77d8d922b565cc881f8a5313d63bfe/rpds_py-2026.5.1-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:83bcf894486c9d78dd290d3c0124ff6dd8875d3025e2090a8ec49fcc37c55fdd", size = 383615, upload-time = "2026-05-28T12:01:17.809Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/69/62e242b53ce39c0814bd24e1a6e6eba6c92be716277745f317f9540a2e7b/rpds_py-2026.5.1-cp315-cp315-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c3df104083952a0e0c6f10de33e440eabe98fb6317d23e1a58c68f6df08d01b9", size = 402786, upload-time = "2026-05-28T12:01:19.419Z" },
-    { url = "https://files.pythonhosted.org/packages/38/c1/a770b9c186928a1ed0f7e6d7ae50e7f3950ed23e3f9e366dbc8e38cb55de/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:980450826cf22e133c57e0835070bdd0dd3f73b9b708c3ce223def2cb9469e14", size = 551583, upload-time = "2026-05-28T12:01:21.013Z" },
-    { url = "https://files.pythonhosted.org/packages/21/7c/68e8579b95375b70d2a963103c42e705856cdb98569258bd807f4423891c/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_i686.whl", hash = "sha256:205dde846f24332ab0c1188699a043b8d165b79bb84529ce272c45048ff6be01", size = 616941, upload-time = "2026-05-28T12:01:22.548Z" },
-    { url = "https://files.pythonhosted.org/packages/70/a1/a6135aed5730ff03ab957182259987ac11e55fb392a28dc6f0592048a280/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:3966b82dd563176396df030f3dd52a6e54cb69b718e95e78bd555ed3d1e0185d", size = 578349, upload-time = "2026-05-28T12:01:24.118Z" },
-    { url = "https://files.pythonhosted.org/packages/09/6e/f24201a76a84e6c49d0bdfdfcb735210e21701e9b21c5bfc0ba497dd62f6/rpds_py-2026.5.1-cp315-cp315-win32.whl", hash = "sha256:7818f8d0a415be74d2be3590b0a1c1f463a642f4d0217e7d10602dceef5b79aa", size = 209922, upload-time = "2026-05-28T12:01:25.522Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/e4/966bc240bb0485fc265278f6de44d05834bf0b3618886e0b22e33d54c49a/rpds_py-2026.5.1-cp315-cp315-win_amd64.whl", hash = "sha256:b3cc20c0d800af78fd0fac68086e28c1856cec51ea528bb81ea851aa40d39325", size = 226003, upload-time = "2026-05-28T12:01:27.062Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/5c/a15a59269cd5e74472734516c73795c15eccfc841b3d4b0228c3f53f19d0/rpds_py-2026.5.1-cp315-cp315-win_arm64.whl", hash = "sha256:3609e9939a8a76cd904cf98a3f1f13b5dc7e150adeaee89e0ea09652ea213e16", size = 221245, upload-time = "2026-05-28T12:01:28.51Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/22/135ce03804e179a71ceb13be095deda4a279bc88f7a6b8fa161c5ad44e12/rpds_py-2026.5.1-cp315-cp315t-macosx_10_12_x86_64.whl", hash = "sha256:5d333a7127d4b307601ac37792bee01bb95c867cbfacf21b6375b804d6bbd723", size = 352015, upload-time = "2026-05-28T12:01:30.214Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/5f/f1f6d2652eb9d848f6eb369d8db83a2da6249bb49ad2c2a48f45d54538d3/rpds_py-2026.5.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:b5f077b44a4f7808520f66dae234988d867deb9aed9be5da057ce9ba831b2a41", size = 345016, upload-time = "2026-05-28T12:01:31.656Z" },
-    { url = "https://files.pythonhosted.org/packages/88/66/b74182775691ea2290c99e52ac8d5db844e56fbec90ce421f107658c8314/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:55d8f9b7b78c9538fc9e04e82ec0e888ff0c3cffcfad152c77e57cd09351a98a", size = 374775, upload-time = "2026-05-28T12:01:33.136Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/8f/15e5a61d9f0a43902d36561d4f07cae6ae9f4716be825159fd72717f33af/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e3a8ae58895ac107ed934a6bf51e5846f95c53b9b940c2c6d310838fd5846358", size = 380270, upload-time = "2026-05-28T12:01:34.574Z" },
-    { url = "https://files.pythonhosted.org/packages/02/c3/f859b12763a80540cdf2af0f15b19904cf756a71d7bdd3f82ff3e5b1bbf9/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0957cf3c2b8632ec7aaebffebea8005b353cc2a237b6e2ae3c2cac0820704cfb", size = 495285, upload-time = "2026-05-28T12:01:36.127Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/c7/ff27c2ac8411d30b03b1829fd88cae8dad1a4d0da48dd25e57c4038042e6/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c396c1304de421050b3681ea70f371874b54d41b0151e96109758144c231e30b", size = 389581, upload-time = "2026-05-28T12:01:37.635Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/67/fe92ee32a6cc05c77228a2f8b1762e7124f386ec20ff83d0757b762d58d0/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aad1bff7f666b9598e573815affd666aac6a13a585dde336f843e33350c7fadc", size = 376041, upload-time = "2026-05-28T12:01:39.307Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/91/b4d6685c27aba55bd82f25b278be8237038117d05f9659a6213ad3408130/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_31_riscv64.whl", hash = "sha256:656a042550878f12d45752452d47094b7cfe5ad1e9d7b87b5a22ad3ae5ff8015", size = 383946, upload-time = "2026-05-28T12:01:41.043Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/79/2c1d832a53c8e0f8e98fc970ec257b950fecd4f62be2ab7182b500a0cbc8/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:73c4bd4f70294737b5206a3e8e30ccadbf8a60301831c8ea23eec5dbeea1ecfa", size = 405526, upload-time = "2026-05-28T12:01:43.032Z" },
-    { url = "https://files.pythonhosted.org/packages/78/c4/c98117b03c6a8581ab2c2dfccfe9a5ad82bd8128a3c28b46a6ad2d97c393/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:43bca78665423cabae77146f2fe7ce55272b6c8d55d82cca83effd42c7e13972", size = 551165, upload-time = "2026-05-28T12:01:44.648Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/c1/bc479ca069200af730881b1bd525e3114b2b391a351509fcb1b772f28086/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_i686.whl", hash = "sha256:42d0f20e85e549c870749d0e247f0c10d318a45b7e9676d575d2dcb04a1b2e66", size = 618778, upload-time = "2026-05-28T12:01:46.337Z" },
-    { url = "https://files.pythonhosted.org/packages/77/65/38ab2f90df44c2febfb63cc10ced40763d9b4bc94d173e734528663fe7f5/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:b1be5c35683684d5331b93600c210e8367c254683d8a6df6bd21bd2da3a334fb", size = 581839, upload-time = "2026-05-28T12:01:48.109Z" },
-    { url = "https://files.pythonhosted.org/packages/15/2d/ce1f605fe036aadd460e5822e578c6c7ec3a860936cca37d6e0f299daa77/rpds_py-2026.5.1-cp315-cp315t-win32.whl", hash = "sha256:75808f6c38ce7749bb68cc2770161aae5045e6c6f6781a9782e74b93304399df", size = 207866, upload-time = "2026-05-28T12:01:49.648Z" },
-    { url = "https://files.pythonhosted.org/packages/79/cb/966040123eb102371559746908ef2c9471f4d43e17ec9a645a2258dab64b/rpds_py-2026.5.1-cp315-cp315t-win_amd64.whl", hash = "sha256:90bd6630002a1c7f09e7843dd79f0d24f3d2897cc25a753480917865d14f15b3", size = 225441, upload-time = "2026-05-28T12:01:51.408Z" },
     { url = "https://files.pythonhosted.org/packages/42/56/3fe0fb34820ff667be791b3a3c22b85e8bcba54e9c832f47438c191fa7be/rpds_py-2026.5.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:edf2765d84e42447f112ad877af8fe1db0089aaec5b28e88d6eab45e7fe99cea", size = 357151, upload-time = "2026-05-28T12:01:53.43Z" },
     { url = "https://files.pythonhosted.org/packages/8b/f2/3eb9ccdb9f143b8c9b003978898cb497f942a324c077401e6b8834238e63/rpds_py-2026.5.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ad3773236e95f7f33991eb125224b7da66f206504d032a253a02da7e134519fb", size = 350195, upload-time = "2026-05-28T12:01:54.901Z" },
     { url = "https://files.pythonhosted.org/packages/a7/24/dbda232bc4f3ed732120692ab0d2c8402cb020516556d8bee622dcef2413/rpds_py-2026.5.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a04df86b3f0fade39ec8fd0e0aab089b1da9fbd2b48df778a57ef96f5e7d38df", size = 381850, upload-time = "2026-05-28T12:01:56.601Z" },
@@ -3097,17 +2034,20 @@ name = "scikit-image"
 version = "0.25.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "imageio", marker = "python_full_version < '3.11'" },
-    { name = "lazy-loader", marker = "python_full_version < '3.11'" },
-    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "packaging", marker = "python_full_version < '3.11'" },
-    { name = "pillow", marker = "python_full_version < '3.11'" },
-    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "tifffile", version = "2025.5.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "imageio", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "lazy-loader", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "packaging", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pillow", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "tifffile", version = "2025.5.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/c7/a8/3c0f256012b93dd2cb6fda9245e9f4bff7dc0486880b248005f15ea2255e/scikit_image-0.25.2.tar.gz", hash = "sha256:e5a37e6cd4d0c018a7a55b9d601357e3382826d3888c10d0213fc63bff977dde", size = 22693594, upload-time = "2025-02-18T18:05:24.538Z" }
 wheels = [
@@ -3126,12 +2066,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/53/4b/eda616e33f67129e5979a9eb33c710013caa3aa8a921991e6cc0b22cea33/scikit_image-0.25.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9d1e80107bcf2bf1291acfc0bf0425dceb8890abe9f38d8e94e23497cbf7ee0d", size = 14178389, upload-time = "2025-02-18T18:04:54.245Z" },
     { url = "https://files.pythonhosted.org/packages/6b/b5/b75527c0f9532dd8a93e8e7cd8e62e547b9f207d4c11e24f0006e8646b36/scikit_image-0.25.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a17e17eb8562660cc0d31bb55643a4da996a81944b82c54805c91b3fe66f4824", size = 15003435, upload-time = "2025-02-18T18:04:57.586Z" },
     { url = "https://files.pythonhosted.org/packages/34/e3/49beb08ebccda3c21e871b607c1cb2f258c3fa0d2f609fed0a5ba741b92d/scikit_image-0.25.2-cp312-cp312-win_amd64.whl", hash = "sha256:bdd2b8c1de0849964dbc54037f36b4e9420157e67e45a8709a80d727f52c7da2", size = 12899474, upload-time = "2025-02-18T18:05:01.166Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/7c/9814dd1c637f7a0e44342985a76f95a55dd04be60154247679fd96c7169f/scikit_image-0.25.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:7efa888130f6c548ec0439b1a7ed7295bc10105458a421e9bf739b457730b6da", size = 13921841, upload-time = "2025-02-18T18:05:03.963Z" },
-    { url = "https://files.pythonhosted.org/packages/84/06/66a2e7661d6f526740c309e9717d3bd07b473661d5cdddef4dd978edab25/scikit_image-0.25.2-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:dd8011efe69c3641920614d550f5505f83658fe33581e49bed86feab43a180fc", size = 13196862, upload-time = "2025-02-18T18:05:06.986Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/63/3368902ed79305f74c2ca8c297dfeb4307269cbe6402412668e322837143/scikit_image-0.25.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:28182a9d3e2ce3c2e251383bdda68f8d88d9fff1a3ebe1eb61206595c9773341", size = 14117785, upload-time = "2025-02-18T18:05:10.69Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/9b/c3da56a145f52cd61a68b8465d6a29d9503bc45bc993bb45e84371c97d94/scikit_image-0.25.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b8abd3c805ce6944b941cfed0406d88faeb19bab3ed3d4b50187af55cf24d147", size = 14977119, upload-time = "2025-02-18T18:05:13.871Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/97/5fcf332e1753831abb99a2525180d3fb0d70918d461ebda9873f66dcc12f/scikit_image-0.25.2-cp313-cp313-win_amd64.whl", hash = "sha256:64785a8acefee460ec49a354706db0b09d1f325674107d7fa3eadb663fb56d6f", size = 12885116, upload-time = "2025-02-18T18:05:17.844Z" },
-    { url = "https://files.pythonhosted.org/packages/10/cc/75e9f17e3670b5ed93c32456fda823333c6279b144cd93e2c03aa06aa472/scikit_image-0.25.2-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:330d061bd107d12f8d68f1d611ae27b3b813b8cdb0300a71d07b1379178dd4cd", size = 13862801, upload-time = "2025-02-18T18:05:20.783Z" },
 ]
 
 [[package]]
@@ -3139,19 +2073,21 @@ name = "scikit-image"
 version = "0.26.0"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
-]
-dependencies = [
-    { name = "imageio", marker = "python_full_version >= '3.11'" },
-    { name = "lazy-loader", marker = "python_full_version >= '3.11'" },
-    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "packaging", marker = "python_full_version >= '3.11'" },
-    { name = "pillow", marker = "python_full_version >= '3.11'" },
-    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "tifffile", version = "2026.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
-    { name = "tifffile", version = "2026.5.15", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+]
+dependencies = [
+    { name = "imageio", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "lazy-loader", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "packaging", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pillow", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "tifffile", version = "2026.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/a1/b4/2528bb43c67d48053a7a649a9666432dc307d66ba02e3a6d5c40f46655df/scikit_image-0.26.0.tar.gz", hash = "sha256:f5f970ab04efad85c24714321fcc91613fcb64ef2a892a13167df2f3e59199fa", size = 22729739, upload-time = "2025-12-20T17:12:21.824Z" }
 wheels = [
@@ -3171,38 +2107,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ee/b5/ac71694da92f5def5953ca99f18a10fe98eac2dd0a34079389b70b4d0394/scikit_image-0.26.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:3f5bf622d7c0435884e1e141ebbe4b2804e16b2dd23ae4c6183e2ea99233be70", size = 14661625, upload-time = "2025-12-20T17:11:04.528Z" },
     { url = "https://files.pythonhosted.org/packages/23/4d/a3cc1e96f080e253dad2251bfae7587cf2b7912bcd76fd43fd366ff35a87/scikit_image-0.26.0-cp312-cp312-win_amd64.whl", hash = "sha256:abed017474593cd3056ae0fe948d07d0747b27a085e92df5474f4955dd65aec0", size = 11911059, upload-time = "2025-12-20T17:11:06.61Z" },
     { url = "https://files.pythonhosted.org/packages/35/8a/d1b8055f584acc937478abf4550d122936f420352422a1a625eef2c605d8/scikit_image-0.26.0-cp312-cp312-win_arm64.whl", hash = "sha256:4d57e39ef67a95d26860c8caf9b14b8fb130f83b34c6656a77f191fa6d1d04d8", size = 11348740, upload-time = "2025-12-20T17:11:09.118Z" },
-    { url = "https://files.pythonhosted.org/packages/4f/48/02357ffb2cca35640f33f2cfe054a4d6d5d7a229b88880a64f1e45c11f4e/scikit_image-0.26.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:a2e852eccf41d2d322b8e60144e124802873a92b8d43a6f96331aa42888491c7", size = 12346329, upload-time = "2025-12-20T17:11:11.599Z" },
-    { url = "https://files.pythonhosted.org/packages/67/b9/b792c577cea2c1e94cda83b135a656924fc57c428e8a6d302cd69aac1b60/scikit_image-0.26.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:98329aab3bc87db352b9887f64ce8cdb8e75f7c2daa19927f2e121b797b678d5", size = 12031726, upload-time = "2025-12-20T17:11:13.871Z" },
-    { url = "https://files.pythonhosted.org/packages/07/a9/9564250dfd65cb20404a611016db52afc6268b2b371cd19c7538ea47580f/scikit_image-0.26.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:915bb3ba66455cf8adac00dc8fdf18a4cd29656aec7ddd38cb4dda90289a6f21", size = 13094910, upload-time = "2025-12-20T17:11:16.2Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/b8/0d8eeb5a9fd7d34ba84f8a55753a0a3e2b5b51b2a5a0ade648a8db4a62f7/scikit_image-0.26.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b36ab5e778bf50af5ff386c3ac508027dc3aaeccf2161bdf96bde6848f44d21b", size = 13660939, upload-time = "2025-12-20T17:11:18.464Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/d6/91d8973584d4793d4c1a847d388e34ef1218d835eeddecfc9108d735b467/scikit_image-0.26.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:09bad6a5d5949c7896c8347424c4cca899f1d11668030e5548813ab9c2865dcb", size = 14138938, upload-time = "2025-12-20T17:11:20.919Z" },
-    { url = "https://files.pythonhosted.org/packages/39/9a/7e15d8dc10d6bbf212195fb39bdeb7f226c46dd53f9c63c312e111e2e175/scikit_image-0.26.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:aeb14db1ed09ad4bee4ceb9e635547a8d5f3549be67fc6c768c7f923e027e6cd", size = 14752243, upload-time = "2025-12-20T17:11:23.347Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/58/2b11b933097bc427e42b4a8b15f7de8f24f2bac1fd2779d2aea1431b2c31/scikit_image-0.26.0-cp313-cp313-win_amd64.whl", hash = "sha256:ac529eb9dbd5954f9aaa2e3fe9a3fd9661bfe24e134c688587d811a0233127f1", size = 11906770, upload-time = "2025-12-20T17:11:25.297Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/ec/96941474a18a04b69b6f6562a5bd79bd68049fa3728d3b350976eccb8b93/scikit_image-0.26.0-cp313-cp313-win_arm64.whl", hash = "sha256:a2d211bc355f59725efdcae699b93b30348a19416cc9e017f7b2fb599faf7219", size = 11342506, upload-time = "2025-12-20T17:11:27.399Z" },
-    { url = "https://files.pythonhosted.org/packages/03/e5/c1a9962b0cf1952f42d32b4a2e48eed520320dbc4d2ff0b981c6fa508b6b/scikit_image-0.26.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:9eefb4adad066da408a7601c4c24b07af3b472d90e08c3e7483d4e9e829d8c49", size = 12663278, upload-time = "2025-12-20T17:11:29.358Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/97/c1a276a59ce8e4e24482d65c1a3940d69c6b3873279193b7ebd04e5ee56b/scikit_image-0.26.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:6caec76e16c970c528d15d1c757363334d5cb3069f9cea93d2bead31820511f3", size = 12405142, upload-time = "2025-12-20T17:11:31.282Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/4a/f1cbd1357caef6c7993f7efd514d6e53d8fd6f7fe01c4714d51614c53289/scikit_image-0.26.0-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a07200fe09b9d99fcdab959859fe0f7db8df6333d6204344425d476850ce3604", size = 12942086, upload-time = "2025-12-20T17:11:33.683Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/6f/74d9fb87c5655bd64cf00b0c44dc3d6206d9002e5f6ba1c9aeb13236f6bf/scikit_image-0.26.0-cp313-cp313t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:92242351bccf391fc5df2d1529d15470019496d2498d615beb68da85fe7fdf37", size = 13265667, upload-time = "2025-12-20T17:11:36.11Z" },
-    { url = "https://files.pythonhosted.org/packages/a7/73/faddc2413ae98d863f6fa2e3e14da4467dd38e788e1c23346cf1a2b06b97/scikit_image-0.26.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:52c496f75a7e45844d951557f13c08c81487c6a1da2e3c9c8a39fcde958e02cc", size = 14001966, upload-time = "2025-12-20T17:11:38.55Z" },
-    { url = "https://files.pythonhosted.org/packages/02/94/9f46966fa042b5d57c8cd641045372b4e0df0047dd400e77ea9952674110/scikit_image-0.26.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:20ef4a155e2e78b8ab973998e04d8a361d49d719e65412405f4dadd9155a61d9", size = 14359526, upload-time = "2025-12-20T17:11:41.087Z" },
-    { url = "https://files.pythonhosted.org/packages/5d/b4/2840fe38f10057f40b1c9f8fb98a187a370936bf144a4ac23452c5ef1baf/scikit_image-0.26.0-cp313-cp313t-win_amd64.whl", hash = "sha256:c9087cf7d0e7f33ab5c46d2068d86d785e70b05400a891f73a13400f1e1faf6a", size = 12287629, upload-time = "2025-12-20T17:11:43.11Z" },
-    { url = "https://files.pythonhosted.org/packages/22/ba/73b6ca70796e71f83ab222690e35a79612f0117e5aaf167151b7d46f5f2c/scikit_image-0.26.0-cp313-cp313t-win_arm64.whl", hash = "sha256:27d58bc8b2acd351f972c6508c1b557cfed80299826080a4d803dd29c51b707e", size = 11647755, upload-time = "2025-12-20T17:11:45.279Z" },
-    { url = "https://files.pythonhosted.org/packages/51/44/6b744f92b37ae2833fd423cce8f806d2368859ec325a699dc30389e090b9/scikit_image-0.26.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:63af3d3a26125f796f01052052f86806da5b5e54c6abef152edb752683075a9c", size = 12365810, upload-time = "2025-12-20T17:11:47.357Z" },
-    { url = "https://files.pythonhosted.org/packages/40/f5/83590d9355191f86ac663420fec741b82cc547a4afe7c4c1d986bf46e4db/scikit_image-0.26.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ce00600cd70d4562ed59f80523e18cdcc1fae0e10676498a01f73c255774aefd", size = 12075717, upload-time = "2025-12-20T17:11:49.483Z" },
-    { url = "https://files.pythonhosted.org/packages/72/48/253e7cf5aee6190459fe136c614e2cbccc562deceb4af96e0863f1b8ee29/scikit_image-0.26.0-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6381edf972b32e4f54085449afde64365a57316637496c1325a736987083e2ab", size = 13161520, upload-time = "2025-12-20T17:11:51.58Z" },
-    { url = "https://files.pythonhosted.org/packages/73/c3/cec6a3cbaadfdcc02bd6ff02f3abfe09eaa7f4d4e0a525a1e3a3f4bce49c/scikit_image-0.26.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c6624a76c6085218248154cc7e1500e6b488edcd9499004dd0d35040607d7505", size = 13684340, upload-time = "2025-12-20T17:11:53.708Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/0d/39a776f675d24164b3a267aa0db9f677a4cb20127660d8bf4fd7fef66817/scikit_image-0.26.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f775f0e420faac9c2aa6757135f4eb468fb7b70e0b67fa77a5e79be3c30ee331", size = 14203839, upload-time = "2025-12-20T17:11:55.89Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/25/2514df226bbcedfe9b2caafa1ba7bc87231a0c339066981b182b08340e06/scikit_image-0.26.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede4d6d255cc5da9faeb2f9ba7fedbc990abbc652db429f40a16b22e770bb578", size = 14770021, upload-time = "2025-12-20T17:11:58.014Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/5b/0671dc91c0c79340c3fe202f0549c7d3681eb7640fe34ab68a5f090a7c7f/scikit_image-0.26.0-cp314-cp314-win_amd64.whl", hash = "sha256:0660b83968c15293fd9135e8d860053ee19500d52bf55ca4fb09de595a1af650", size = 12023490, upload-time = "2025-12-20T17:12:00.013Z" },
-    { url = "https://files.pythonhosted.org/packages/65/08/7c4cb59f91721f3de07719085212a0b3962e3e3f2d1818cbac4eeb1ea53e/scikit_image-0.26.0-cp314-cp314-win_arm64.whl", hash = "sha256:b8d14d3181c21c11170477a42542c1addc7072a90b986675a71266ad17abc37f", size = 11473782, upload-time = "2025-12-20T17:12:01.983Z" },
-    { url = "https://files.pythonhosted.org/packages/49/41/65c4258137acef3d73cb561ac55512eacd7b30bb4f4a11474cad526bc5db/scikit_image-0.26.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:cde0bbd57e6795eba83cb10f71a677f7239271121dc950bc060482834a668ad1", size = 12686060, upload-time = "2025-12-20T17:12:03.886Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/32/76971f8727b87f1420a962406388a50e26667c31756126444baf6668f559/scikit_image-0.26.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:163e9afb5b879562b9aeda0dd45208a35316f26cc7a3aed54fd601604e5cf46f", size = 12422628, upload-time = "2025-12-20T17:12:05.921Z" },
-    { url = "https://files.pythonhosted.org/packages/37/0d/996febd39f757c40ee7b01cdb861867327e5c8e5f595a634e8201462d958/scikit_image-0.26.0-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:724f79fd9b6cb6f4a37864fe09f81f9f5d5b9646b6868109e1b100d1a7019e59", size = 12962369, upload-time = "2025-12-20T17:12:07.912Z" },
-    { url = "https://files.pythonhosted.org/packages/48/b4/612d354f946c9600e7dea012723c11d47e8d455384e530f6daaaeb9bf62c/scikit_image-0.26.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3268f13310e6857508bd87202620df996199a016a1d281b309441d227c822394", size = 13272431, upload-time = "2025-12-20T17:12:10.255Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/6e/26c00b466e06055a086de2c6e2145fe189ccdc9a1d11ccc7de020f2591ad/scikit_image-0.26.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fac96a1f9b06cd771cbbb3cd96c5332f36d4efd839b1d8b053f79e5887acde62", size = 14016362, upload-time = "2025-12-20T17:12:12.793Z" },
-    { url = "https://files.pythonhosted.org/packages/47/88/00a90402e1775634043c2a0af8a3c76ad450866d9fa444efcc43b553ba2d/scikit_image-0.26.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2c1e7bd342f43e7a97e571b3f03ba4c1293ea1a35c3f13f41efdc8a81c1dc8f2", size = 14364151, upload-time = "2025-12-20T17:12:14.909Z" },
-    { url = "https://files.pythonhosted.org/packages/da/ca/918d8d306bd43beacff3b835c6d96fac0ae64c0857092f068b88db531a7c/scikit_image-0.26.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b702c3bb115e1dcf4abf5297429b5c90f2189655888cbed14921f3d26f81d3a4", size = 12413484, upload-time = "2025-12-20T17:12:17.046Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/cd/4da01329b5a8d47ff7ec3c99a2b02465a8017b186027590dc7425cee0b56/scikit_image-0.26.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0608aa4a9ec39e0843de10d60edb2785a30c1c47819b67866dd223ebd149acaf", size = 11769501, upload-time = "2025-12-20T17:12:19.339Z" },
 ]
 
 [[package]]
@@ -3210,10 +2114,13 @@ name = "scipy"
 version = "1.15.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/0f/37/6964b830433e654ec7485e45a00fc9a27cf868d622838f6b6d9c5ec0d532/scipy-1.15.3.tar.gz", hash = "sha256:eae3cf522bc7df64b42cad3925c876e1b0b6c35c1337c93e12c0f366f55b0eaf", size = 59419214, upload-time = "2025-05-08T16:13:05.955Z" }
 wheels = [
@@ -3244,24 +2151,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/89/b1/fbb53137f42c4bf630b1ffdfc2151a62d1d1b903b249f030d2b1c0280af8/scipy-1.15.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6cfd56fc1a8e53f6e89ba3a7a7251f7396412d655bca2aa5611c8ec9a6784a1e", size = 36885140, upload-time = "2025-05-08T16:06:39.249Z" },
     { url = "https://files.pythonhosted.org/packages/2e/2e/025e39e339f5090df1ff266d021892694dbb7e63568edcfe43f892fa381d/scipy-1.15.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:0ff17c0bb1cb32952c09217d8d1eed9b53d1463e5f1dd6052c7857f83127d539", size = 39710549, upload-time = "2025-05-08T16:06:45.729Z" },
     { url = "https://files.pythonhosted.org/packages/e6/eb/3bf6ea8ab7f1503dca3a10df2e4b9c3f6b3316df07f6c0ded94b281c7101/scipy-1.15.3-cp312-cp312-win_amd64.whl", hash = "sha256:52092bc0472cfd17df49ff17e70624345efece4e1a12b23783a1ac59a1b728ed", size = 40966184, upload-time = "2025-05-08T16:06:52.623Z" },
-    { url = "https://files.pythonhosted.org/packages/73/18/ec27848c9baae6e0d6573eda6e01a602e5649ee72c27c3a8aad673ebecfd/scipy-1.15.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:2c620736bcc334782e24d173c0fdbb7590a0a436d2fdf39310a8902505008759", size = 38728256, upload-time = "2025-05-08T16:06:58.696Z" },
-    { url = "https://files.pythonhosted.org/packages/74/cd/1aef2184948728b4b6e21267d53b3339762c285a46a274ebb7863c9e4742/scipy-1.15.3-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:7e11270a000969409d37ed399585ee530b9ef6aa99d50c019de4cb01e8e54e62", size = 30109540, upload-time = "2025-05-08T16:07:04.209Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/d8/59e452c0a255ec352bd0a833537a3bc1bfb679944c4938ab375b0a6b3a3e/scipy-1.15.3-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:8c9ed3ba2c8a2ce098163a9bdb26f891746d02136995df25227a20e71c396ebb", size = 22383115, upload-time = "2025-05-08T16:07:08.998Z" },
-    { url = "https://files.pythonhosted.org/packages/08/f5/456f56bbbfccf696263b47095291040655e3cbaf05d063bdc7c7517f32ac/scipy-1.15.3-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:0bdd905264c0c9cfa74a4772cdb2070171790381a5c4d312c973382fc6eaf730", size = 25163884, upload-time = "2025-05-08T16:07:14.091Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/66/a9618b6a435a0f0c0b8a6d0a2efb32d4ec5a85f023c2b79d39512040355b/scipy-1.15.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:79167bba085c31f38603e11a267d862957cbb3ce018d8b38f79ac043bc92d825", size = 35174018, upload-time = "2025-05-08T16:07:19.427Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/09/c5b6734a50ad4882432b6bb7c02baf757f5b2f256041da5df242e2d7e6b6/scipy-1.15.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c9deabd6d547aee2c9a81dee6cc96c6d7e9a9b1953f74850c179f91fdc729cb7", size = 37269716, upload-time = "2025-05-08T16:07:25.712Z" },
-    { url = "https://files.pythonhosted.org/packages/77/0a/eac00ff741f23bcabd352731ed9b8995a0a60ef57f5fd788d611d43d69a1/scipy-1.15.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:dde4fc32993071ac0c7dd2d82569e544f0bdaff66269cb475e0f369adad13f11", size = 36872342, upload-time = "2025-05-08T16:07:31.468Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/54/4379be86dd74b6ad81551689107360d9a3e18f24d20767a2d5b9253a3f0a/scipy-1.15.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:f77f853d584e72e874d87357ad70f44b437331507d1c311457bed8ed2b956126", size = 39670869, upload-time = "2025-05-08T16:07:38.002Z" },
-    { url = "https://files.pythonhosted.org/packages/87/2e/892ad2862ba54f084ffe8cc4a22667eaf9c2bcec6d2bff1d15713c6c0703/scipy-1.15.3-cp313-cp313-win_amd64.whl", hash = "sha256:b90ab29d0c37ec9bf55424c064312930ca5f4bde15ee8619ee44e69319aab163", size = 40988851, upload-time = "2025-05-08T16:08:33.671Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/e9/7a879c137f7e55b30d75d90ce3eb468197646bc7b443ac036ae3fe109055/scipy-1.15.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:3ac07623267feb3ae308487c260ac684b32ea35fd81e12845039952f558047b8", size = 38863011, upload-time = "2025-05-08T16:07:44.039Z" },
-    { url = "https://files.pythonhosted.org/packages/51/d1/226a806bbd69f62ce5ef5f3ffadc35286e9fbc802f606a07eb83bf2359de/scipy-1.15.3-cp313-cp313t-macosx_12_0_arm64.whl", hash = "sha256:6487aa99c2a3d509a5227d9a5e889ff05830a06b2ce08ec30df6d79db5fcd5c5", size = 30266407, upload-time = "2025-05-08T16:07:49.891Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/9b/f32d1d6093ab9eeabbd839b0f7619c62e46cc4b7b6dbf05b6e615bbd4400/scipy-1.15.3-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:50f9e62461c95d933d5c5ef4a1f2ebf9a2b4e83b0db374cb3f1de104d935922e", size = 22540030, upload-time = "2025-05-08T16:07:54.121Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/29/c278f699b095c1a884f29fda126340fcc201461ee8bfea5c8bdb1c7c958b/scipy-1.15.3-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:14ed70039d182f411ffc74789a16df3835e05dc469b898233a245cdfd7f162cb", size = 25218709, upload-time = "2025-05-08T16:07:58.506Z" },
-    { url = "https://files.pythonhosted.org/packages/24/18/9e5374b617aba742a990581373cd6b68a2945d65cc588482749ef2e64467/scipy-1.15.3-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a769105537aa07a69468a0eefcd121be52006db61cdd8cac8a0e68980bbb723", size = 34809045, upload-time = "2025-05-08T16:08:03.929Z" },
-    { url = "https://files.pythonhosted.org/packages/e1/fe/9c4361e7ba2927074360856db6135ef4904d505e9b3afbbcb073c4008328/scipy-1.15.3-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9db984639887e3dffb3928d118145ffe40eff2fa40cb241a306ec57c219ebbbb", size = 36703062, upload-time = "2025-05-08T16:08:09.558Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/8e/038ccfe29d272b30086b25a4960f757f97122cb2ec42e62b460d02fe98e9/scipy-1.15.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:40e54d5c7e7ebf1aa596c374c49fa3135f04648a0caabcb66c52884b943f02b4", size = 36393132, upload-time = "2025-05-08T16:08:15.34Z" },
-    { url = "https://files.pythonhosted.org/packages/10/7e/5c12285452970be5bdbe8352c619250b97ebf7917d7a9a9e96b8a8140f17/scipy-1.15.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:5e721fed53187e71d0ccf382b6bf977644c533e506c4d33c3fb24de89f5c3ed5", size = 38979503, upload-time = "2025-05-08T16:08:21.513Z" },
-    { url = "https://files.pythonhosted.org/packages/81/06/0a5e5349474e1cbc5757975b21bd4fad0e72ebf138c5592f191646154e06/scipy-1.15.3-cp313-cp313t-win_amd64.whl", hash = "sha256:76ad1fb5f8752eabf0fa02e4cc0336b4e8f021e2d5f061ed37d6d264db35e3ca", size = 40308097, upload-time = "2025-05-08T16:08:27.627Z" },
 ]
 
 [[package]]
@@ -3269,11 +2158,14 @@ name = "scipy"
 version = "1.17.1"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/7a/97/5a3609c4f8d58b039179648e62dd220f89864f56f7357f5d4f45c29eb2cc/scipy-1.17.1.tar.gz", hash = "sha256:95d8e012d8cb8816c226aef832200b1d45109ed4464303e997c5b13122b297c0", size = 30573822, upload-time = "2026-02-23T00:26:24.851Z" }
 wheels = [
@@ -3297,46 +2189,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/65/94/7698add8f276dbab7a9de9fb6b0e02fc13ee61d51c7c3f85ac28b65e1239/scipy-1.17.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:f590cd684941912d10becc07325a3eeb77886fe981415660d9265c4c418d0bea", size = 37625856, upload-time = "2026-02-23T00:19:00.307Z" },
     { url = "https://files.pythonhosted.org/packages/a2/84/dc08d77fbf3d87d3ee27f6a0c6dcce1de5829a64f2eae85a0ecc1f0daa73/scipy-1.17.1-cp312-cp312-win_amd64.whl", hash = "sha256:41b71f4a3a4cab9d366cd9065b288efc4d4f3c0b37a91a8e0947fb5bd7f31d87", size = 36549682, upload-time = "2026-02-23T00:19:07.67Z" },
     { url = "https://files.pythonhosted.org/packages/bc/98/fe9ae9ffb3b54b62559f52dedaebe204b408db8109a8c66fdd04869e6424/scipy-1.17.1-cp312-cp312-win_arm64.whl", hash = "sha256:f4115102802df98b2b0db3cce5cb9b92572633a1197c77b7553e5203f284a5b3", size = 24547340, upload-time = "2026-02-23T00:19:12.024Z" },
-    { url = "https://files.pythonhosted.org/packages/76/27/07ee1b57b65e92645f219b37148a7e7928b82e2b5dbeccecb4dff7c64f0b/scipy-1.17.1-cp313-cp313-macosx_10_14_x86_64.whl", hash = "sha256:5e3c5c011904115f88a39308379c17f91546f77c1667cea98739fe0fccea804c", size = 31590199, upload-time = "2026-02-23T00:19:17.192Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/ae/db19f8ab842e9b724bf5dbb7db29302a91f1e55bc4d04b1025d6d605a2c5/scipy-1.17.1-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:6fac755ca3d2c3edcb22f479fceaa241704111414831ddd3bc6056e18516892f", size = 28154001, upload-time = "2026-02-23T00:19:22.241Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/58/3ce96251560107b381cbd6e8413c483bbb1228a6b919fa8652b0d4090e7f/scipy-1.17.1-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:7ff200bf9d24f2e4d5dc6ee8c3ac64d739d3a89e2326ba68aaf6c4a2b838fd7d", size = 20325719, upload-time = "2026-02-23T00:19:26.329Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/83/15087d945e0e4d48ce2377498abf5ad171ae013232ae31d06f336e64c999/scipy-1.17.1-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:4b400bdc6f79fa02a4d86640310dde87a21fba0c979efff5248908c6f15fad1b", size = 22683595, upload-time = "2026-02-23T00:19:30.304Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/e0/e58fbde4a1a594c8be8114eb4aac1a55bcd6587047efc18a61eb1f5c0d30/scipy-1.17.1-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2b64ca7d4aee0102a97f3ba22124052b4bd2152522355073580bf4845e2550b6", size = 32896429, upload-time = "2026-02-23T00:19:35.536Z" },
-    { url = "https://files.pythonhosted.org/packages/f5/5f/f17563f28ff03c7b6799c50d01d5d856a1d55f2676f537ca8d28c7f627cd/scipy-1.17.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:581b2264fc0aa555f3f435a5944da7504ea3a065d7029ad60e7c3d1ae09c5464", size = 35203952, upload-time = "2026-02-23T00:19:42.259Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/a5/9afd17de24f657fdfe4df9a3f1ea049b39aef7c06000c13db1530d81ccca/scipy-1.17.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:beeda3d4ae615106d7094f7e7cef6218392e4465cc95d25f900bebabfded0950", size = 34979063, upload-time = "2026-02-23T00:19:47.547Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/13/88b1d2384b424bf7c924f2038c1c409f8d88bb2a8d49d097861dd64a57b2/scipy-1.17.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6609bc224e9568f65064cfa72edc0f24ee6655b47575954ec6339534b2798369", size = 37598449, upload-time = "2026-02-23T00:19:53.238Z" },
-    { url = "https://files.pythonhosted.org/packages/35/e5/d6d0e51fc888f692a35134336866341c08655d92614f492c6860dc45bb2c/scipy-1.17.1-cp313-cp313-win_amd64.whl", hash = "sha256:37425bc9175607b0268f493d79a292c39f9d001a357bebb6b88fdfaff13f6448", size = 36510943, upload-time = "2026-02-23T00:20:50.89Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/fd/3be73c564e2a01e690e19cc618811540ba5354c67c8680dce3281123fb79/scipy-1.17.1-cp313-cp313-win_arm64.whl", hash = "sha256:5cf36e801231b6a2059bf354720274b7558746f3b1a4efb43fcf557ccd484a87", size = 24545621, upload-time = "2026-02-23T00:20:55.871Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/6b/17787db8b8114933a66f9dcc479a8272e4b4da75fe03b0c282f7b0ade8cd/scipy-1.17.1-cp313-cp313t-macosx_10_14_x86_64.whl", hash = "sha256:d59c30000a16d8edc7e64152e30220bfbd724c9bbb08368c054e24c651314f0a", size = 31936708, upload-time = "2026-02-23T00:19:58.694Z" },
-    { url = "https://files.pythonhosted.org/packages/38/2e/524405c2b6392765ab1e2b722a41d5da33dc5c7b7278184a8ad29b6cb206/scipy-1.17.1-cp313-cp313t-macosx_12_0_arm64.whl", hash = "sha256:010f4333c96c9bb1a4516269e33cb5917b08ef2166d5556ca2fd9f082a9e6ea0", size = 28570135, upload-time = "2026-02-23T00:20:03.934Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/c3/5bd7199f4ea8556c0c8e39f04ccb014ac37d1468e6cfa6a95c6b3562b76e/scipy-1.17.1-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:2ceb2d3e01c5f1d83c4189737a42d9cb2fc38a6eeed225e7515eef71ad301dce", size = 20741977, upload-time = "2026-02-23T00:20:07.935Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/b8/8ccd9b766ad14c78386599708eb745f6b44f08400a5fd0ade7cf89b6fc93/scipy-1.17.1-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:844e165636711ef41f80b4103ed234181646b98a53c8f05da12ca5ca289134f6", size = 23029601, upload-time = "2026-02-23T00:20:12.161Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/a0/3cb6f4d2fb3e17428ad2880333cac878909ad1a89f678527b5328b93c1d4/scipy-1.17.1-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:158dd96d2207e21c966063e1635b1063cd7787b627b6f07305315dd73d9c679e", size = 33019667, upload-time = "2026-02-23T00:20:17.208Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/c3/2d834a5ac7bf3a0c806ad1508efc02dda3c8c61472a56132d7894c312dea/scipy-1.17.1-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:74cbb80d93260fe2ffa334efa24cb8f2f0f622a9b9febf8b483c0b865bfb3475", size = 35264159, upload-time = "2026-02-23T00:20:23.087Z" },
-    { url = "https://files.pythonhosted.org/packages/4d/77/d3ed4becfdbd217c52062fafe35a72388d1bd82c2d0ba5ca19d6fcc93e11/scipy-1.17.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:dbc12c9f3d185f5c737d801da555fb74b3dcfa1a50b66a1a93e09190f41fab50", size = 35102771, upload-time = "2026-02-23T00:20:28.636Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/12/d19da97efde68ca1ee5538bb261d5d2c062f0c055575128f11a2730e3ac1/scipy-1.17.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:94055a11dfebe37c656e70317e1996dc197e1a15bbcc351bcdd4610e128fe1ca", size = 37665910, upload-time = "2026-02-23T00:20:34.743Z" },
-    { url = "https://files.pythonhosted.org/packages/06/1c/1172a88d507a4baaf72c5a09bb6c018fe2ae0ab622e5830b703a46cc9e44/scipy-1.17.1-cp313-cp313t-win_amd64.whl", hash = "sha256:e30bdeaa5deed6bc27b4cc490823cd0347d7dae09119b8803ae576ea0ce52e4c", size = 36562980, upload-time = "2026-02-23T00:20:40.575Z" },
-    { url = "https://files.pythonhosted.org/packages/70/b0/eb757336e5a76dfa7911f63252e3b7d1de00935d7705cf772db5b45ec238/scipy-1.17.1-cp313-cp313t-win_arm64.whl", hash = "sha256:a720477885a9d2411f94a93d16f9d89bad0f28ca23c3f8daa521e2dcc3f44d49", size = 24856543, upload-time = "2026-02-23T00:20:45.313Z" },
-    { url = "https://files.pythonhosted.org/packages/cf/83/333afb452af6f0fd70414dc04f898647ee1423979ce02efa75c3b0f2c28e/scipy-1.17.1-cp314-cp314-macosx_10_14_x86_64.whl", hash = "sha256:a48a72c77a310327f6a3a920092fa2b8fd03d7deaa60f093038f22d98e096717", size = 31584510, upload-time = "2026-02-23T00:21:01.015Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/a6/d05a85fd51daeb2e4ea71d102f15b34fedca8e931af02594193ae4fd25f7/scipy-1.17.1-cp314-cp314-macosx_12_0_arm64.whl", hash = "sha256:45abad819184f07240d8a696117a7aacd39787af9e0b719d00285549ed19a1e9", size = 28170131, upload-time = "2026-02-23T00:21:05.888Z" },
-    { url = "https://files.pythonhosted.org/packages/db/7b/8624a203326675d7746a254083a187398090a179335b2e4a20e2ddc46e83/scipy-1.17.1-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:3fd1fcdab3ea951b610dc4cef356d416d5802991e7e32b5254828d342f7b7e0b", size = 20342032, upload-time = "2026-02-23T00:21:09.904Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/35/2c342897c00775d688d8ff3987aced3426858fd89d5a0e26e020b660b301/scipy-1.17.1-cp314-cp314-macosx_14_0_x86_64.whl", hash = "sha256:7bdf2da170b67fdf10bca777614b1c7d96ae3ca5794fd9587dce41eb2966e866", size = 22678766, upload-time = "2026-02-23T00:21:14.313Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/f2/7cdb8eb308a1a6ae1e19f945913c82c23c0c442a462a46480ce487fdc0ac/scipy-1.17.1-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:adb2642e060a6549c343603a3851ba76ef0b74cc8c079a9a58121c7ec9fe2350", size = 32957007, upload-time = "2026-02-23T00:21:19.663Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/2e/7eea398450457ecb54e18e9d10110993fa65561c4f3add5e8eccd2b9cd41/scipy-1.17.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:eee2cfda04c00a857206a4330f0c5e3e56535494e30ca445eb19ec624ae75118", size = 35221333, upload-time = "2026-02-23T00:21:25.278Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/77/5b8509d03b77f093a0d52e606d3c4f79e8b06d1d38c441dacb1e26cacf46/scipy-1.17.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d2650c1fb97e184d12d8ba010493ee7b322864f7d3d00d3f9bb97d9c21de4068", size = 35042066, upload-time = "2026-02-23T00:21:31.358Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/df/18f80fb99df40b4070328d5ae5c596f2f00fffb50167e31439e932f29e7d/scipy-1.17.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:08b900519463543aa604a06bec02461558a6e1cef8fdbb8098f77a48a83c8118", size = 37612763, upload-time = "2026-02-23T00:21:37.247Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/39/f0e8ea762a764a9dc52aa7dabcfad51a354819de1f0d4652b6a1122424d6/scipy-1.17.1-cp314-cp314-win_amd64.whl", hash = "sha256:3877ac408e14da24a6196de0ddcace62092bfc12a83823e92e49e40747e52c19", size = 37290984, upload-time = "2026-02-23T00:22:35.023Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/56/fe201e3b0f93d1a8bcf75d3379affd228a63d7e2d80ab45467a74b494947/scipy-1.17.1-cp314-cp314-win_arm64.whl", hash = "sha256:f8885db0bc2bffa59d5c1b72fad7a6a92d3e80e7257f967dd81abb553a90d293", size = 25192877, upload-time = "2026-02-23T00:22:39.798Z" },
-    { url = "https://files.pythonhosted.org/packages/96/ad/f8c414e121f82e02d76f310f16db9899c4fcde36710329502a6b2a3c0392/scipy-1.17.1-cp314-cp314t-macosx_10_14_x86_64.whl", hash = "sha256:1cc682cea2ae55524432f3cdff9e9a3be743d52a7443d0cba9017c23c87ae2f6", size = 31949750, upload-time = "2026-02-23T00:21:42.289Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/b0/c741e8865d61b67c81e255f4f0a832846c064e426636cd7de84e74d209be/scipy-1.17.1-cp314-cp314t-macosx_12_0_arm64.whl", hash = "sha256:2040ad4d1795a0ae89bfc7e8429677f365d45aa9fd5e4587cf1ea737f927b4a1", size = 28585858, upload-time = "2026-02-23T00:21:47.706Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/1b/3985219c6177866628fa7c2595bfd23f193ceebbe472c98a08824b9466ff/scipy-1.17.1-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:131f5aaea57602008f9822e2115029b55d4b5f7c070287699fe45c661d051e39", size = 20757723, upload-time = "2026-02-23T00:21:52.039Z" },
-    { url = "https://files.pythonhosted.org/packages/c0/19/2a04aa25050d656d6f7b9e7b685cc83d6957fb101665bfd9369ca6534563/scipy-1.17.1-cp314-cp314t-macosx_14_0_x86_64.whl", hash = "sha256:9cdc1a2fcfd5c52cfb3045feb399f7b3ce822abdde3a193a6b9a60b3cb5854ca", size = 23043098, upload-time = "2026-02-23T00:21:56.185Z" },
-    { url = "https://files.pythonhosted.org/packages/86/f1/3383beb9b5d0dbddd030335bf8a8b32d4317185efe495374f134d8be6cce/scipy-1.17.1-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e3dcd57ab780c741fde8dc68619de988b966db759a3c3152e8e9142c26295ad", size = 33030397, upload-time = "2026-02-23T00:22:01.404Z" },
-    { url = "https://files.pythonhosted.org/packages/41/68/8f21e8a65a5a03f25a79165ec9d2b28c00e66dc80546cf5eb803aeeff35b/scipy-1.17.1-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a9956e4d4f4a301ebf6cde39850333a6b6110799d470dbbb1e25326ac447f52a", size = 35281163, upload-time = "2026-02-23T00:22:07.024Z" },
-    { url = "https://files.pythonhosted.org/packages/84/8d/c8a5e19479554007a5632ed7529e665c315ae7492b4f946b0deb39870e39/scipy-1.17.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:a4328d245944d09fd639771de275701ccadf5f781ba0ff092ad141e017eccda4", size = 35116291, upload-time = "2026-02-23T00:22:12.585Z" },
-    { url = "https://files.pythonhosted.org/packages/52/52/e57eceff0e342a1f50e274264ed47497b59e6a4e3118808ee58ddda7b74a/scipy-1.17.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a77cbd07b940d326d39a1d1b37817e2ee4d79cb30e7338f3d0cddffae70fcaa2", size = 37682317, upload-time = "2026-02-23T00:22:18.513Z" },
-    { url = "https://files.pythonhosted.org/packages/11/2f/b29eafe4a3fbc3d6de9662b36e028d5f039e72d345e05c250e121a230dd4/scipy-1.17.1-cp314-cp314t-win_amd64.whl", hash = "sha256:eb092099205ef62cd1782b006658db09e2fed75bffcae7cc0d44052d8aa0f484", size = 37345327, upload-time = "2026-02-23T00:22:24.442Z" },
-    { url = "https://files.pythonhosted.org/packages/07/39/338d9219c4e87f3e708f18857ecd24d22a0c3094752393319553096b98af/scipy-1.17.1-cp314-cp314t-win_arm64.whl", hash = "sha256:200e1050faffacc162be6a486a984a0497866ec54149a01270adc8a59b7c7d21", size = 25489165, upload-time = "2026-02-23T00:22:29.563Z" },
 ]
 
 [[package]]
@@ -3381,7 +2233,7 @@ version = "1.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/25/44/ec35f1b6e83094b997da438a02c8c9b0ade2b1e84cfc48bd4656780760a6/starlette-1.2.1.tar.gz", hash = "sha256:9b9b5ebb992e67d6093741e63c2f59e4f6fff986f81163c087867bd7b924b3f6", size = 2701854, upload-time = "2026-05-31T01:07:51.847Z" }
 wheels = [
@@ -3405,10 +2257,13 @@ name = "tifffile"
 version = "2025.5.10"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/44/d0/18fed0fc0916578a4463f775b0fbd9c5fed2392152d039df2fb533bfdd5d/tifffile-2025.5.10.tar.gz", hash = "sha256:018335d34283aa3fd8c263bae5c3c2b661ebc45548fde31504016fcae7bf1103", size = 365290, upload-time = "2025-05-10T19:22:34.386Z" }
 wheels = [
@@ -3420,31 +2275,20 @@ name = "tifffile"
 version = "2026.3.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version == '3.11.*'",
+    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+    { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/c5/cb/2f6d79c7576e22c116352a801f4c3c8ace5957e9aced862012430b62e14f/tifffile-2026.3.3.tar.gz", hash = "sha256:d9a1266bed6f2ee1dd0abde2018a38b4f8b2935cb843df381d70ac4eac5458b7", size = 388745, upload-time = "2026-03-03T19:14:38.134Z" }
 wheels = [
     { url = "https://files.pythonhosted.org/packages/1a/e4/e804505f87627cd8cdae9c010c47c4485fd8c1ce31a7dd0ab7fcc4707377/tifffile-2026.3.3-py3-none-any.whl", hash = "sha256:e8be15c94273113d31ecb7aa3a39822189dd11c4967e3cc88c178f1ad2fd1170", size = 243960, upload-time = "2026-03-03T19:14:35.808Z" },
 ]
 
-[[package]]
-name = "tifffile"
-version = "2026.5.15"
-source = { registry = "https://pypi.org/simple" }
-resolution-markers = [
-    "python_full_version >= '3.12'",
-]
-dependencies = [
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/40/66/0aef917d525767a40edebe088f8ed6a4417e6eb489c58f6805bfa872636b/tifffile-2026.5.15.tar.gz", hash = "sha256:ee4f3e07ee0d8ff4745a8c735ac2b72caa3173c7d6059b00fdc3ff492a0b635b", size = 429998, upload-time = "2026-05-15T20:04:55.896Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/1f/6e/7d8850ff112f8f80d394ca45e89b975a3a43559d47af3137b767669b3294/tifffile-2026.5.15-py3-none-any.whl", hash = "sha256:6715515a53cabc0cefc5c9f13a0ae2c250e63e2ca784ce02d0b6c333810c2a17", size = 266665, upload-time = "2026-05-15T20:04:54.227Z" },
-]
-
 [[package]]
 name = "tomli"
 version = "2.4.1"
@@ -3469,33 +2313,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d6/2f/4a3c322f22c5c66c4b836ec58211641a4067364f5dcdd7b974b4c5da300c/tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917", size = 98141, upload-time = "2026-03-25T20:21:28.492Z" },
     { url = "https://files.pythonhosted.org/packages/24/22/4daacd05391b92c55759d55eaee21e1dfaea86ce5c571f10083360adf534/tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9", size = 108847, upload-time = "2026-03-25T20:21:29.386Z" },
     { url = "https://files.pythonhosted.org/packages/68/fd/70e768887666ddd9e9f5d85129e84910f2db2796f9096aa02b721a53098d/tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257", size = 95088, upload-time = "2026-03-25T20:21:30.677Z" },
-    { url = "https://files.pythonhosted.org/packages/07/06/b823a7e818c756d9a7123ba2cda7d07bc2dd32835648d1a7b7b7a05d848d/tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54", size = 155866, upload-time = "2026-03-25T20:21:31.65Z" },
-    { url = "https://files.pythonhosted.org/packages/14/6f/12645cf7f08e1a20c7eb8c297c6f11d31c1b50f316a7e7e1e1de6e2e7b7e/tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a", size = 149887, upload-time = "2026-03-25T20:21:33.028Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/e0/90637574e5e7212c09099c67ad349b04ec4d6020324539297b634a0192b0/tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897", size = 243704, upload-time = "2026-03-25T20:21:34.51Z" },
-    { url = "https://files.pythonhosted.org/packages/10/8f/d3ddb16c5a4befdf31a23307f72828686ab2096f068eaf56631e136c1fdd/tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f", size = 251628, upload-time = "2026-03-25T20:21:36.012Z" },
-    { url = "https://files.pythonhosted.org/packages/e3/f1/dbeeb9116715abee2485bf0a12d07a8f31af94d71608c171c45f64c0469d/tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d", size = 247180, upload-time = "2026-03-25T20:21:37.136Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/74/16336ffd19ed4da28a70959f92f506233bd7cfc2332b20bdb01591e8b1d1/tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5", size = 251674, upload-time = "2026-03-25T20:21:38.298Z" },
-    { url = "https://files.pythonhosted.org/packages/16/f9/229fa3434c590ddf6c0aa9af64d3af4b752540686cace29e6281e3458469/tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd", size = 97976, upload-time = "2026-03-25T20:21:39.316Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/1e/71dfd96bcc1c775420cb8befe7a9d35f2e5b1309798f009dca17b7708c1e/tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36", size = 108755, upload-time = "2026-03-25T20:21:40.248Z" },
-    { url = "https://files.pythonhosted.org/packages/83/7a/d34f422a021d62420b78f5c538e5b102f62bea616d1d75a13f0a88acb04a/tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd", size = 95265, upload-time = "2026-03-25T20:21:41.219Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/fb/9a5c8d27dbab540869f7c1f8eb0abb3244189ce780ba9cd73f3770662072/tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf", size = 155726, upload-time = "2026-03-25T20:21:42.23Z" },
-    { url = "https://files.pythonhosted.org/packages/62/05/d2f816630cc771ad836af54f5001f47a6f611d2d39535364f148b6a92d6b/tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac", size = 149859, upload-time = "2026-03-25T20:21:43.386Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/48/66341bdb858ad9bd0ceab5a86f90eddab127cf8b046418009f2125630ecb/tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662", size = 244713, upload-time = "2026-03-25T20:21:44.474Z" },
-    { url = "https://files.pythonhosted.org/packages/df/6d/c5fad00d82b3c7a3ab6189bd4b10e60466f22cfe8a08a9394185c8a8111c/tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853", size = 252084, upload-time = "2026-03-25T20:21:45.62Z" },
-    { url = "https://files.pythonhosted.org/packages/00/71/3a69e86f3eafe8c7a59d008d245888051005bd657760e96d5fbfb0b740c2/tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15", size = 247973, upload-time = "2026-03-25T20:21:46.937Z" },
-    { url = "https://files.pythonhosted.org/packages/67/50/361e986652847fec4bd5e4a0208752fbe64689c603c7ae5ea7cb16b1c0ca/tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba", size = 256223, upload-time = "2026-03-25T20:21:48.467Z" },
-    { url = "https://files.pythonhosted.org/packages/8c/9a/b4173689a9203472e5467217e0154b00e260621caa227b6fa01feab16998/tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6", size = 98973, upload-time = "2026-03-25T20:21:49.526Z" },
-    { url = "https://files.pythonhosted.org/packages/14/58/640ac93bf230cd27d002462c9af0d837779f8773bc03dee06b5835208214/tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7", size = 109082, upload-time = "2026-03-25T20:21:50.506Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/2f/702d5e05b227401c1068f0d386d79a589bb12bf64c3d2c72ce0631e3bc49/tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232", size = 96490, upload-time = "2026-03-25T20:21:51.474Z" },
-    { url = "https://files.pythonhosted.org/packages/45/4b/b877b05c8ba62927d9865dd980e34a755de541eb65fffba52b4cc495d4d2/tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4", size = 164263, upload-time = "2026-03-25T20:21:52.543Z" },
-    { url = "https://files.pythonhosted.org/packages/24/79/6ab420d37a270b89f7195dec5448f79400d9e9c1826df982f3f8e97b24fd/tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c", size = 160736, upload-time = "2026-03-25T20:21:53.674Z" },
-    { url = "https://files.pythonhosted.org/packages/02/e0/3630057d8eb170310785723ed5adcdfb7d50cb7e6455f85ba8a3deed642b/tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d", size = 270717, upload-time = "2026-03-25T20:21:55.129Z" },
-    { url = "https://files.pythonhosted.org/packages/7a/b4/1613716072e544d1a7891f548d8f9ec6ce2faf42ca65acae01d76ea06bb0/tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41", size = 278461, upload-time = "2026-03-25T20:21:56.228Z" },
-    { url = "https://files.pythonhosted.org/packages/05/38/30f541baf6a3f6df77b3df16b01ba319221389e2da59427e221ef417ac0c/tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c", size = 274855, upload-time = "2026-03-25T20:21:57.653Z" },
-    { url = "https://files.pythonhosted.org/packages/77/a3/ec9dd4fd2c38e98de34223b995a3b34813e6bdadf86c75314c928350ed14/tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f", size = 283144, upload-time = "2026-03-25T20:21:59.089Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/be/605a6261cac79fba2ec0c9827e986e00323a1945700969b8ee0b30d85453/tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8", size = 108683, upload-time = "2026-03-25T20:22:00.214Z" },
-    { url = "https://files.pythonhosted.org/packages/12/64/da524626d3b9cc40c168a13da8335fe1c51be12c0a63685cc6db7308daae/tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26", size = 121196, upload-time = "2026-03-25T20:22:01.169Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/cd/e80b62269fc78fc36c9af5a6b89c835baa8af28ff5ad28c7028d60860320/tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396", size = 100393, upload-time = "2026-03-25T20:22:02.137Z" },
     { url = "https://files.pythonhosted.org/packages/7b/61/cceae43728b7de99d9b847560c262873a1f6c98202171fd5ed62640b494b/tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe", size = 14583, upload-time = "2026-03-25T20:22:03.012Z" },
 ]
 
@@ -3510,96 +2327,168 @@ wheels = [
 
 [[package]]
 name = "torch"
-version = "2.12.0"
-source = { registry = "https://pypi.org/simple" }
+version = "2.7.1+cu118"
+source = { registry = "https://download.pytorch.org/whl/cu118" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+    "python_full_version < '3.11'",
+]
 dependencies = [
-    { name = "cuda-bindings", marker = "sys_platform == 'linux'" },
-    { name = "cuda-toolkit", extra = ["cudart", "cufft", "cufile", "cupti", "curand", "cusolver", "cusparse", "nvjitlink", "nvrtc", "nvtx"], marker = "sys_platform == 'linux'" },
     { name = "filelock" },
     { name = "fsspec" },
     { name = "jinja2" },
-    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "nvidia-cublas", marker = "sys_platform == 'linux'" },
-    { name = "nvidia-cudnn-cu13", marker = "sys_platform == 'linux'" },
-    { name = "nvidia-cusparselt-cu13", marker = "sys_platform == 'linux'" },
-    { name = "nvidia-nccl-cu13", marker = "sys_platform == 'linux'" },
-    { name = "nvidia-nvshmem-cu13", marker = "sys_platform == 'linux'" },
-    { name = "setuptools" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and extra == 'extra-6-gently-torch-gpu') or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and extra == 'extra-6-gently-torch-gpu') or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "nvidia-cublas-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cuda-cupti-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cuda-nvrtc-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cuda-runtime-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cudnn-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cufft-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-curand-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cusolver-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cusparse-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-nccl-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-nvtx-cu11", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "setuptools", marker = "python_full_version >= '3.12'" },
     { name = "sympy" },
-    { name = "triton", marker = "sys_platform == 'linux'" },
+    { name = "triton", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
     { name = "typing-extensions" },
 ]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c2/b7/53fe0436586716ab7aecff41e26b9302d57c85ded481fd83a2cd741e6b4e/torch-2.12.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:1834bd984f8a2f4f16bdfbeecca9146184b220aa46276bf5756735b5dae12812", size = 87981887, upload-time = "2026-05-13T14:55:53.234Z" },
-    { url = "https://files.pythonhosted.org/packages/34/60/d930eac44c30de06ed16f6d1ba4e785e1632532b50d8f0bf9bf699a4d0c7/torch-2.12.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:d4d029801cb7b6df858804a2a21b00cc2aa0bf0ee5d2ab18d343c9e9e5681f35", size = 426355000, upload-time = "2026-05-13T14:54:31.944Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/0c/c76b6a087820bab55705b94dfc074e520de9ae91f5ef90da2ecbf2a3ef12/torch-2.12.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:d47e7dee68ac4cd7a068b26bcd6b989935427709fae1c8f7bd0019978f829e15", size = 532144998, upload-time = "2026-05-13T14:56:05.523Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/64/8a0d036e166a6aa85ee09bef072f3655d1ba5d5486a68d1b03b6813c01b3/torch-2.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:cf9839790285dd472e7a16aafcb4a4e6bf58ec1b494045044b0eefb0eb4bd1f2", size = 122949877, upload-time = "2026-05-13T14:55:46.841Z" },
-    { url = "https://files.pythonhosted.org/packages/18/62/131124fb95df03811b8260d1d43dcc5ee85ea1a344b964613d7efe77fb08/torch-2.12.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:10802fd383bbfed646212e765a72c37d2185205d4f26eb197a254e8ac7ddcb25", size = 87990344, upload-time = "2026-05-13T14:55:42.154Z" },
-    { url = "https://files.pythonhosted.org/packages/12/9c/dda0dbd547dc549839824135f223792fd0e725f28ed0715dda366b7acaa2/torch-2.12.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:c12592630aef72feaf18bd3f197ef587bbfa21131b31c38b23ab2e55fce92e36", size = 426362932, upload-time = "2026-05-13T14:54:15.295Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/d2/a7dd5a3f9bdaa7842124e8e2359202b317c48d47d2fc5816fafdf2049adb/torch-2.12.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:415c1b8d0412f67551c8e89a2daca0fb3e56694af0281ba155eaa9da481f58b4", size = 532170085, upload-time = "2026-05-13T14:55:20.788Z" },
-    { url = "https://files.pythonhosted.org/packages/12/1b/a61ce2004f9ab0ea8964a6e6168133a127795667639e2ff4f8f2bdb16a65/torch-2.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:dd37188ea325042cb1f6cafa56822b11ada2520c04791a52629b0af25bdfbfd9", size = 122953128, upload-time = "2026-05-13T14:54:52.744Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/bb/285d643f254731294c9b595a007eac39db4600a98682d7bca688f42ca164/torch-2.12.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:b41339df93d491435e790ff8bcbae1c0ce777175889bfd1281d119862793e6a2", size = 88010197, upload-time = "2026-05-13T14:55:35.414Z" },
-    { url = "https://files.pythonhosted.org/packages/79/81/76debf1db1343bd929bbb5d74c89fb437c2ed88eb144712557e7bd3eea45/torch-2.12.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:8fbef9f108a863e7722a73740998967e3b074742a834fc5be3a535a2befa7057", size = 426376751, upload-time = "2026-05-13T14:55:03.353Z" },
-    { url = "https://files.pythonhosted.org/packages/de/f0/80026028b603c4650ff270fc3785bdef4bd6738765a9cc5a0f5a637d65a2/torch-2.12.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:4b4f64c2c2b11f7510d93dd6412b87025ff6eddd6bb61c3b5a3d892ea20c4756", size = 532261691, upload-time = "2026-05-13T14:52:54.453Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/c2/64b06cbb7830fb3cd9be13e1158b31a3f36b68e6a209105ee3c9d9480be0/torch-2.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:8b958caff4a14d3a3b0b2dfc6a378f64dda9728a9dad28c08a0db9ce4dafb549", size = 122988114, upload-time = "2026-05-13T14:54:42.153Z" },
-    { url = "https://files.pythonhosted.org/packages/86/ca/01896c80ba921676aa45886b2c5b8d774912de2a1f719de48169c6f755cd/torch-2.12.0-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:90dd587a5f61bfe1307148b581e2084fc5bc4a06e2b90a20e9a36b81087ff16b", size = 88009511, upload-time = "2026-05-13T14:54:47.411Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/04/52bdaf4787eab6ac7d7f5851dff934e4def0bc8ead9c8fd2b69b3e529699/torch-2.12.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:864392c73b7654f4d2b3ae712f607937d0dbb1101c4555fbb41848106b297f39", size = 426383231, upload-time = "2026-05-13T14:53:32.129Z" },
-    { url = "https://files.pythonhosted.org/packages/49/8a/94bdecd13f5aaa90d45920b89789d9fe7c6f4af8c3cdd7ce01fcb59908fc/torch-2.12.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:5d6b560dfa7d56291c07d615c3bb73e8d9943d9b6d87f76cd0d9d570c4797fa6", size = 532269288, upload-time = "2026-05-13T14:53:49.423Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/2f/bdbaaa267de519ef1b73054bf590d8c93c37a266c9a4e24a01bd38b6918f/torch-2.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:3fee918902090ade827643e758e98363278815de583c75d111fdd665ebffde9f", size = 122987706, upload-time = "2026-05-13T14:54:00.335Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/ad/e95e822f3538171e22640a7fbe839a1fdb666600bf6487025de2ff03b11a/torch-2.12.0-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:10ee1448a9f304d3b987eb4656f664ba6e4d7b410ca7a5a7c642199777a2cf88", size = 88319556, upload-time = "2026-05-13T14:54:05.574Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/07/055d06d985b445d67422d25b033c11cf55bbb81785d4c4e68e28bca5820e/torch-2.12.0-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:af68dbf403439cae9ceaeaaf92f8352b460787dcd27b92aa05c40dd4a19c0f1e", size = 426397656, upload-time = "2026-05-13T14:52:38.84Z" },
-    { url = "https://files.pythonhosted.org/packages/43/94/b0b4fdc3014122e0a7302fb90086d352aa48f2576f0b252561ebb38c01a8/torch-2.12.0-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:a6a2eebb237d3b1d9ad3b378e86d9b9e0782afdea8b1e0eba6a13646b9b49c07", size = 532183124, upload-time = "2026-05-13T14:53:16.178Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/c8/052405e6ad05d3237bfe5a4df78f917773956f8e17813a2d44c059068b74/torch-2.12.0-cp313-cp313t-win_amd64.whl", hash = "sha256:2140e373e9a51a3e22ef62e8d14366d0b470d18f0adf19fdc757368077133a34", size = 123232462, upload-time = "2026-05-13T14:52:27.26Z" },
-    { url = "https://files.pythonhosted.org/packages/67/dc/ac069f8d6e8be701535921141055293b0d4819d3d7f224a4612cf157c7f9/torch-2.12.0-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:f7dfae4a519197dfa050e98d8e36378a0fb5899625a875c2b54445005a2e404e", size = 88027282, upload-time = "2026-05-13T14:53:05.258Z" },
-    { url = "https://files.pythonhosted.org/packages/33/c3/1c1eb00e34555b536dddf792676026a988d710ed36981aa00499b36b0620/torch-2.12.0-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:891c769072637c74e9a5a77a3bc782894696d8ffec83b938df8536dee7f0ba78", size = 426386961, upload-time = "2026-05-13T14:51:28.406Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/d4/7e730dba0c7032a4154dc9056b76cf9625515e030e269cfbf8098fcfee7d/torch-2.12.0-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:e2ad3eb85d39c3cab62dfa93ed5a73516e6a53c6713cb97d004004fe089f0f1f", size = 532272265, upload-time = "2026-05-13T14:51:59.308Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/b4/92c80d1bbfee1c0036c06d1d2155a3065bd2423134c83bf8a47e65cd6b9b/torch-2.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:c66696857e987efb8bc1777a37357ec4f60ab5e8af6250b83d6034437fa2d8f3", size = 122987138, upload-time = "2026-05-13T14:51:45.942Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/78/2e12b37ce50a19a037d7bc62d652a5a8f27385a7b05859d6bc9204f20cfe/torch-2.12.0-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:b4556715c8572758625d62b6e0ae3b1f76c440221913a6fb5e100f321fb4fb02", size = 88320100, upload-time = "2026-05-13T14:51:39.955Z" },
-    { url = "https://files.pythonhosted.org/packages/56/5e/83c450ec7b0bb40a7b74611c1b5440f9260e33c54c90d556fd4a1f0fd955/torch-2.12.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:a43ac605a5e13116c72b64c359644cce0229f213dde48d2ae0ae5eb5becf7feb", size = 426391871, upload-time = "2026-05-13T14:52:14.989Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/e9/1a0b575d98d0afedd8f157d23fa3d2759421483660448e60d0a4b10b6daa/torch-2.12.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:6a7512adfdd7f6732e40de1c620831e3c75b39b98cef60b11d0c5f0a76473ec5", size = 532192241, upload-time = "2026-05-13T14:51:07.795Z" },
-    { url = "https://files.pythonhosted.org/packages/88/21/afadd25ecd81b3cea1e11c73cf1ab41a983a50271548c3ec7ec3b9efc3e9/torch-2.12.0-cp314-cp314t-win_amd64.whl", hash = "sha256:5f96b63f8287f66a005dd1b5a6abba2920f11156c5e5c4d815f3e2050fd1aa16", size = 123231092, upload-time = "2026-05-13T14:51:18.854Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torch-2.7.1%2Bcu118-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:89433c62b02ec802d4c0887c867d935887ae8f00d7cc549ecf1c2640d096bd4c", upload-time = "2025-06-03T18:28:22Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torch-2.7.1%2Bcu118-cp310-cp310-win_amd64.whl", hash = "sha256:af4833e36a8e964681a4dad7775f559cf043bd42c9d0c0b5e0619f9d0e44cb56", upload-time = "2025-06-03T18:28:07Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torch-2.7.1%2Bcu118-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:a596d91c747d1fa601724e85b9c8797c8d7c62140aa1acf245773e911254bc45", upload-time = "2025-06-03T18:28:14Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torch-2.7.1%2Bcu118-cp311-cp311-win_amd64.whl", hash = "sha256:584e5ee99d29286b93be2fba3b3f1f5b9d7a4b9055a288eb31b33100a1f09ed9", upload-time = "2025-06-03T18:28:22Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torch-2.7.1%2Bcu118-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:91454dcfdb81f181fdf216d6d6d9912fbd8795578b90384b3b8b8132737072bb", upload-time = "2025-06-03T18:28:21Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torch-2.7.1%2Bcu118-cp312-cp312-win_amd64.whl", hash = "sha256:80855ec840b7b06372ff43535d01393a8ec101842618d1f9ed629572b52aed71", upload-time = "2025-06-03T18:28:23Z" },
+]
+
+[[package]]
+name = "torch"
+version = "2.12.0"
+source = { registry = "https://download.pytorch.org/whl/cpu" }
+resolution-markers = [
+    "python_full_version >= '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+]
+dependencies = [
+    { name = "filelock", marker = "sys_platform == 'darwin'" },
+    { name = "fsspec", marker = "sys_platform == 'darwin'" },
+    { name = "jinja2", marker = "sys_platform == 'darwin'" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu') or (python_full_version >= '3.11' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu') or (python_full_version < '3.11' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "setuptools", marker = "sys_platform == 'darwin'" },
+    { name = "sympy", marker = "sys_platform == 'darwin'" },
+    { name = "typing-extensions", marker = "sys_platform == 'darwin'" },
+]
+wheels = [
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:1834bd984f8a2f4f16bdfbeecca9146184b220aa46276bf5756735b5dae12812", upload-time = "2026-05-12T16:20:02Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:10802fd383bbfed646212e765a72c37d2185205d4f26eb197a254e8ac7ddcb25", upload-time = "2026-05-12T16:20:07Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:b41339df93d491435e790ff8bcbae1c0ce777175889bfd1281d119862793e6a2", upload-time = "2026-05-12T16:20:12Z" },
+]
+
+[[package]]
+name = "torch"
+version = "2.12.0+cpu"
+source = { registry = "https://download.pytorch.org/whl/cpu" }
+resolution-markers = [
+    "python_full_version >= '3.11' and sys_platform != 'darwin'",
+    "python_full_version < '3.11' and sys_platform != 'darwin'",
+]
+dependencies = [
+    { name = "filelock", marker = "sys_platform != 'darwin'" },
+    { name = "fsspec", marker = "sys_platform != 'darwin'" },
+    { name = "jinja2", marker = "sys_platform != 'darwin'" },
+    { name = "networkx", version = "3.4.2", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu') or (python_full_version >= '3.11' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "networkx", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu') or (python_full_version < '3.11' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "setuptools", marker = "sys_platform != 'darwin'" },
+    { name = "sympy", marker = "sys_platform != 'darwin'" },
+    { name = "typing-extensions", marker = "sys_platform != 'darwin'" },
+]
+wheels = [
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp310-cp310-linux_s390x.whl", hash = "sha256:0e04beb2ab285bdcc5bb15d9cf7b2a757cf0d9422092fa5747de946359e1b409", upload-time = "2026-05-12T23:15:34Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:c74a449ad7f97b879734b5a4f1092a91b1780e2cd525ec369c29fd9877ef73c0", upload-time = "2026-05-12T23:15:40Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:5d8513a19dcf28c5dc338f3c8ee5a692b07699e8dbd01dbabce6c74a75474f70", upload-time = "2026-05-12T23:15:48Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp310-cp310-win_amd64.whl", hash = "sha256:7b9442036d46fb657c6a95f4c77c875db07e604400f29ef0ae8dc370c37619b8", upload-time = "2026-05-12T23:15:55Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp311-cp311-linux_s390x.whl", hash = "sha256:aaa9c1f5e8c518d7be1e3c3e1b090ca7d63b6e353a1abd6cfdaf902405093467", upload-time = "2026-05-12T23:16:01Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:4ecd8ecdb9ea1affa5f35d10501809d62dc713f7de9635e8098e760ddbeb852c", upload-time = "2026-05-12T23:16:08Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:d85bdbc271bf22ef1931375a81b0366ab11081509728c58df730cf194a090818", upload-time = "2026-05-12T23:16:15Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp311-cp311-win_amd64.whl", hash = "sha256:ce7cee08446201b1d4d01e36916e152d88c3bbf8b7234278b2c3633397c0145f", upload-time = "2026-05-12T23:16:23Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp311-cp311-win_arm64.whl", hash = "sha256:f51148512f2ad92ed91397ebfee187925d6152a229c66ef6a4cfe52c0191df53", upload-time = "2026-05-12T23:16:28Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp312-cp312-linux_s390x.whl", hash = "sha256:b9d0e8eed0af9321ffb12b75f4aca371b071254f12cf75875d5a8e7cc8f52b51", upload-time = "2026-05-12T23:16:33Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:ce2ddb880b0813fcc91a737f08fdd973a8115a74c64ccb34e9c09a7964b4d448", upload-time = "2026-05-12T23:16:40Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:5e3dc83725581fa38b7b2e45c58692e30b2a3cde19191af54b675ffcac3840a6", upload-time = "2026-05-12T23:16:48Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp312-cp312-win_amd64.whl", hash = "sha256:70ead47f538417323a230c0e743e5cbb6d91f11bd8339abf8c05c9d02f8409bc", upload-time = "2026-05-12T23:16:56Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torch-2.12.0%2Bcpu-cp312-cp312-win_arm64.whl", hash = "sha256:5a3b24f429d126a08acafd5cfe8b719409618ad57c49bf4f20df4f8cd32cd682", upload-time = "2026-05-12T23:17:00Z" },
 ]
 
 [[package]]
 name = "torchvision"
-version = "0.27.0"
-source = { registry = "https://pypi.org/simple" }
+version = "0.22.1+cu118"
+source = { registry = "https://download.pytorch.org/whl/cu118" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+    "python_full_version < '3.11'",
+]
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "numpy" },
     { name = "pillow" },
-    { name = "torch" },
-]
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/13/15/2df874db140bbfe42f377e05e2dd38f2b9dc88414a6607eecc42073b2baa/torchvision-0.27.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:0822b58d2c5d325cd0c7152b744acbd15f898c07572e2cfb70b075a865a4f6f9", size = 1758817, upload-time = "2026-05-13T14:57:20.113Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/32/10b1ff4087d35b7af7bd85ccb85fbc2573c6f1c2008cf8abfcaf605a10fc/torchvision-0.27.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:c9f44e35e6ec01caedacce9e941a5bf21fe424403321efac2507a201273653c5", size = 7830083, upload-time = "2026-05-13T14:57:18.336Z" },
-    { url = "https://files.pythonhosted.org/packages/57/20/97dca91770235028ba7e9c598ca1fc48c297f1843af8102430f2adcd4335/torchvision-0.27.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:419c98a9275b27660cdce6d09080fd5974d1ec1d4a225f71439ebacb3b0c4e64", size = 7573816, upload-time = "2026-05-13T14:57:12.327Z" },
-    { url = "https://files.pythonhosted.org/packages/37/a5/66fbf7f21f292d095a153ee142806646813e2055a69efe5854c28e7c3fb9/torchvision-0.27.0-cp310-cp310-win_amd64.whl", hash = "sha256:2664d06acd64d328aa7689b0d0c81ee31e240e9977d8768816b4be7c66c03211", size = 3435489, upload-time = "2026-05-13T14:57:13.716Z" },
-    { url = "https://files.pythonhosted.org/packages/cf/d6/a7e71e981042d5c573e2e61891b9023b190c88adb75b18bed8594371250c/torchvision-0.27.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:df0c166b6bdf7c47f88e81e8b43bc085451d5c50d0c5d1691bc474c1227d6fed", size = 1758812, upload-time = "2026-05-13T14:57:16.662Z" },
-    { url = "https://files.pythonhosted.org/packages/93/f9/f542fb7e4476603fb237ebdc64369a7d11f18eb5a129aa2559cbdb710aee/torchvision-0.27.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:9bb9251f64b854124efed95d02953a89f7e2726c3ca662d7ea0151129157297f", size = 7831148, upload-time = "2026-05-13T14:57:08.37Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/61/7aa7cc2c9e8750027f6fb9ae3a7393ef43860bcdfe3966e2f71fee800e31/torchvision-0.27.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:f44453f107c296d5446a79f7ac59733ad8bf5ddfa04c53805dfbae298a42a798", size = 7575519, upload-time = "2026-05-13T14:56:50.552Z" },
-    { url = "https://files.pythonhosted.org/packages/19/aa/929b358b1a643849b81ec95569938044cc37dc65ab10c84eb6d82fe1bfbb/torchvision-0.27.0-cp311-cp311-win_amd64.whl", hash = "sha256:b4aacff70ea4b7377f996f9048989c850d221fef33658ddbcae42aa5bd4ca11a", size = 3749475, upload-time = "2026-05-13T14:57:11.007Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/c8/5cd91932f7f3671b0743dc4ae1a4c16b1d0b45bf4087976277d325bda718/torchvision-0.27.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:1a6dd742a150645126df9e0b2e449874c1d635897c773b322c2e067e98382dfe", size = 1758824, upload-time = "2026-05-13T14:57:15.227Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/36/7fb7d19477b3d93283b52fea11fa8ee30ab9064a08c97b4a6b91445e26cb/torchvision-0.27.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:65772ff3ec4f4f5d680e30019835555dd239e7fefee4b0a846375fe1cb1592ef", size = 7831034, upload-time = "2026-05-13T14:57:06.483Z" },
-    { url = "https://files.pythonhosted.org/packages/62/43/dfd894c3f8b01b5b33fde990f0159c1926ebc7b6e2c4193e2efb7da3c4cb/torchvision-0.27.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:7a9966a088d06b4cf6c610e03be62de469efa6f2cd2e7c7eed8e925ed6af59ac", size = 7579774, upload-time = "2026-05-13T14:56:59.337Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/0c/722e989f9cf026e97ef7cb24a9bb1859e099f72d247ae35388fb89729f73/torchvision-0.27.0-cp312-cp312-win_amd64.whl", hash = "sha256:2c037709072ca9b19750c0cbe9e8bb6f91c9a1be1befa26df33e281deccbd8c7", size = 4021073, upload-time = "2026-05-13T14:57:00.848Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/ae/36547812e6e047c1d80bcacd1b17a340612b08a6e876e0aabf3d0b9228b0/torchvision-0.27.0-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:41d6dae73e1af09fa82ded597ae57f2a2314285acde54b25890a8f8e51b999d7", size = 1758826, upload-time = "2026-05-13T14:57:05.262Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/30/32c4ea842738728a14e3df8c576c62dedcf5ae5cb6a5c984c6429ebe7524/torchvision-0.27.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:70f071c6f74b60d5fe8851636d8d4cd5f4fa29d57fd9348a87a6f17b990b95ba", size = 7789501, upload-time = "2026-05-13T14:56:57.786Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/24/4d0d48684251bd0673f87d633d5d88ab00227983b00591156eed2f86c8d5/torchvision-0.27.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:aaafa6962c9d91f42503de1957d6fa349907d028c06f335bd95da7a5bc57147d", size = 7579868, upload-time = "2026-05-13T14:56:41.618Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/da/e6edd051d2ba25adf23b120fa97f458dff888d098c51e84724f17d2d1470/torchvision-0.27.0-cp313-cp313-win_amd64.whl", hash = "sha256:aee384a2782c89517c4ab9061d2720ba59fd2ffe5ef89d0a149cc2d43abdf521", size = 4092700, upload-time = "2026-05-13T14:57:09.729Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/23/95dfa40431360f42ca949bf861434bed51164adfa8fb9801e05bf3194f50/torchvision-0.27.0-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:c5121f1b9ab09a7f73e837871deb8321551f7eaeb19d87aa00de9191968eae44", size = 1845008, upload-time = "2026-05-13T14:57:03.768Z" },
-    { url = "https://files.pythonhosted.org/packages/23/b9/9dbdf76b2b49a75ba8088df6f7c755bdb520afb6c6dbac0102b46cde5e99/torchvision-0.27.0-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:1c01f0d1091ae22b9dfc082b0a0fe5faaf053686a29b4fb082ba7691375c73cf", size = 7791430, upload-time = "2026-05-13T14:56:56.206Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/6a/e4a16cf2f3310c2ea7760dc5d9054496844391e0f4c1fae87fefac2f3d9e/torchvision-0.27.0-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:dadea3c5ecfd05bbb2a3312ab0374f213c58bf6459cb059122e2f4dfe13d10ed", size = 7668441, upload-time = "2026-05-13T14:57:02.127Z" },
-    { url = "https://files.pythonhosted.org/packages/00/70/01b6461117a6a94b5af3f8ee166bb0f045056f3cf187750c110dabfdfffa/torchvision-0.27.0-cp313-cp313t-win_amd64.whl", hash = "sha256:a49e55055a39a8506fe7e59850522cab004efb2c3839f6057658889c1d69c815", size = 4141602, upload-time = "2026-05-13T14:56:53.449Z" },
-    { url = "https://files.pythonhosted.org/packages/92/22/c0633677b3b3f3e69554a21ac087bf705f829c40cd5e3783507b8c006681/torchvision-0.27.0-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:c1fac0fc2a7adf29481fc1938a0e7845c57ba1147a986784109c4d98f434ea8c", size = 1758818, upload-time = "2026-05-13T14:56:54.988Z" },
-    { url = "https://files.pythonhosted.org/packages/48/e8/55f9d9667b56dae470e69e31beac9b00d458ea393feec1aae95cc4f3f1c9/torchvision-0.27.0-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:cbf89764fc76f3f17fbf80c12d5a89c691e91cb9d82c38412aaf0568655ffb19", size = 7789667, upload-time = "2026-05-13T14:56:48.858Z" },
-    { url = "https://files.pythonhosted.org/packages/00/bc/6f8681daf3bbc4c315bb0005110f99d28e3ecd675bf9c8f2c0d393fbac7a/torchvision-0.27.0-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:91f61b9865423037c327eb56afa207cc72de874e458c361840db9dcf5ce0c0eb", size = 7579848, upload-time = "2026-05-13T14:56:38.209Z" },
-    { url = "https://files.pythonhosted.org/packages/19/6c/8d8020e6bd1e46c53e487c9c4e9457a07f2ee28931028fb5d71e2da40adc/torchvision-0.27.0-cp314-cp314-win_amd64.whl", hash = "sha256:5bb82fc3c55daf1788621e504310b0a286f1069627a8742f692aebb075ef25a7", size = 4119284, upload-time = "2026-05-13T14:56:46.625Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/7e/e78c48662a8d551606efdbe11c6b9c1d6d2391b92cd0e4591b9e6a2412b8/torchvision-0.27.0-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:2c4099a15150143b9b034730b404a56d572efe0b79489b4c765d929cb4eac7f3", size = 1758828, upload-time = "2026-05-13T14:56:52.293Z" },
-    { url = "https://files.pythonhosted.org/packages/21/dd/d03ee9f9ee7bf11a8c7c776fb8e7fd6102f59c013791a2a4e5175bd6cba7/torchvision-0.27.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:b4c6bb0a670dcba017b3643e21902c9b8a1cc1c127d602f1488fa29ec3c6e865", size = 7790618, upload-time = "2026-05-13T14:56:44.721Z" },
-    { url = "https://files.pythonhosted.org/packages/39/08/4002336a74742be70728603ec1769feb2b55e0d19c532c9ec9f92008de76/torchvision-0.27.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:1c2db4bde82bc48ebff73436a6adf34d4f809448268a70d9a1285f5c8f92313d", size = 7580217, upload-time = "2026-05-13T14:56:43.274Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/cb/4dd4783eb3565f526ba6e64b6f6ca26c00eacc924cdfe60455db9d91b84b/torchvision-0.27.0-cp314-cp314t-win_amd64.whl", hash = "sha256:72bf547e58ddb948689734eed6f4b6a2031f979dba4fb08e3690688b392e929f", size = 4226392, upload-time = "2026-05-13T14:56:40.235Z" },
+    { name = "torch", version = "2.7.1+cu118", source = { registry = "https://download.pytorch.org/whl/cu118" } },
+]
+wheels = [
+    { url = "https://download-r2.pytorch.org/whl/cu118/torchvision-0.22.1%2Bcu118-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:64954400493caf614b5aebded9b5a63eda8753cea9f8a1e32752eb2adc6ed383", upload-time = "2025-06-03T18:37:25Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torchvision-0.22.1%2Bcu118-cp310-cp310-win_amd64.whl", hash = "sha256:608ea6cb93eb66cdf273cab41122f83191c198c3c4ff583609f0e6e184f52865", upload-time = "2025-06-03T18:37:25Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torchvision-0.22.1%2Bcu118-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:6dd3d825fb4a75eae887665d1da812a360d69273118bfa17616c836bfb466627", upload-time = "2025-06-03T18:37:26Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torchvision-0.22.1%2Bcu118-cp311-cp311-win_amd64.whl", hash = "sha256:98a626661670cd96faeef05b33a140a09f9f134b0ab38d127b6ebbcf73d42bf5", upload-time = "2025-06-03T18:37:26Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torchvision-0.22.1%2Bcu118-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:e4a8696261b8c64297a2683656f4ee64418d7ee391627702fe5c06b72ce81123", upload-time = "2025-06-03T18:37:26Z" },
+    { url = "https://download-r2.pytorch.org/whl/cu118/torchvision-0.22.1%2Bcu118-cp312-cp312-win_amd64.whl", hash = "sha256:3e927a3b0b08c7582cfa09e5f16b35435de390a612cfe76eed1418ab7b68d6b6", upload-time = "2025-06-03T18:37:26Z" },
+]
+
+[[package]]
+name = "torchvision"
+version = "0.27.0"
+source = { registry = "https://download.pytorch.org/whl/cpu" }
+resolution-markers = [
+    "python_full_version >= '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+]
+dependencies = [
+    { name = "numpy", marker = "sys_platform == 'darwin'" },
+    { name = "pillow", marker = "sys_platform == 'darwin'" },
+    { name = "torch", version = "2.12.0", source = { registry = "https://download.pytorch.org/whl/cpu" }, marker = "sys_platform == 'darwin'" },
+]
+wheels = [
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:0822b58d2c5d325cd0c7152b744acbd15f898c07572e2cfb70b075a865a4f6f9", upload-time = "2026-05-12T16:20:37Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:df0c166b6bdf7c47f88e81e8b43bc085451d5c50d0c5d1691bc474c1227d6fed", upload-time = "2026-05-12T16:20:37Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:1a6dd742a150645126df9e0b2e449874c1d635897c773b322c2e067e98382dfe", upload-time = "2026-05-12T16:20:37Z" },
+]
+
+[[package]]
+name = "torchvision"
+version = "0.27.0+cpu"
+source = { registry = "https://download.pytorch.org/whl/cpu" }
+resolution-markers = [
+    "python_full_version >= '3.11' and sys_platform != 'darwin'",
+    "python_full_version < '3.11' and sys_platform != 'darwin'",
+]
+dependencies = [
+    { name = "numpy", marker = "sys_platform != 'darwin'" },
+    { name = "pillow", marker = "sys_platform != 'darwin'" },
+    { name = "torch", version = "2.12.0+cpu", source = { registry = "https://download.pytorch.org/whl/cpu" }, marker = "sys_platform != 'darwin'" },
+]
+wheels = [
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:279a056a6436f69f767675b1f1d82b67ecaca1ba1871b11ce0af4744a324aa22", upload-time = "2026-05-12T16:20:36Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:17425d4df43966a70d2d40216968273f2c3f753aa1e8f7a671caab550685d234", upload-time = "2026-05-12T16:20:36Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp310-cp310-win_amd64.whl", hash = "sha256:62a4318e2484871143b5f3fbca7cd245c7a8106f60aa2b7f4d8bb0d1cc87fe52", upload-time = "2026-05-12T16:20:37Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:99d05d071ff34305334ee1854f5edf7c2767b96ba59fe92e76d84a1fa72c8e06", upload-time = "2026-05-12T16:20:36Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:376d04dcb7b75069a2b9a1af2c30ff4ac40113309907a54d0b0b26f4ad2ba075", upload-time = "2026-05-12T16:20:36Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp311-cp311-win_amd64.whl", hash = "sha256:74731fbb41248bbbc24607368b484237533eaba72d7f994e7d20a1b4b8f83fbe", upload-time = "2026-05-12T16:20:37Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:1b06f42d48b62098114923d8a3fe9fa864182715db06584a515155db0aa8eb30", upload-time = "2026-05-12T16:20:36Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:912a8b008d95fc9f8f8507e0663238aa01abfeb29f38e218116217560a1b6401", upload-time = "2026-05-12T16:20:36Z" },
+    { url = "https://download-r2.pytorch.org/whl/cpu/torchvision-0.27.0%2Bcpu-cp312-cp312-win_amd64.whl", hash = "sha256:4c87d4bb691765173f186f5a9882fb85a75301547c4186dd75688bba907076e4", upload-time = "2026-05-12T16:20:36Z" },
 ]
 
 [[package]]
@@ -3607,7 +2496,7 @@ name = "tqdm"
 version = "4.67.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "colorama", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/09/a9/6ba95a270c6f1fbcd8dac228323f2777d886cb206987444e4bce66338dd4/tqdm-4.67.3.tar.gz", hash = "sha256:7d825f03f89244ef73f1d4ce193cb1774a8179fd96f31d7e1dcde62092b960bb", size = 169598, upload-time = "2026-02-03T17:35:53.048Z" }
 wheels = [
@@ -3616,23 +2505,15 @@ wheels = [
 
 [[package]]
 name = "triton"
-version = "3.7.0"
+version = "3.3.1"
 source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "setuptools" },
+]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/3e/97/dcd1f2a0f8336691bff74abc59b2ed9c69a0c0f8f65cd77109c49e05f068/triton-3.7.0-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:223ac302091491436c248a34ee1e6c47a1026486579103c906ffd805be50cb89", size = 188367104, upload-time = "2026-05-07T19:04:56.68Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/c0/c2ac4fd2d8809b7579d4a820a0f9e5de62a9bc8a757ed4b3abf4f7ee964a/triton-3.7.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c631b65668d4951213b948a413c0564184305b77bb45cc9d686d3e1ecc4701a3", size = 201313191, upload-time = "2026-05-07T18:45:58.444Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/c1/5d842314bb6c78442cc60437928781701c6050b8d479bc2a1aed691d37ca/triton-3.7.0-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a9e71fc392675fac364e0ecf4ef3f76f85b7f5433a16f4c3c5fe5f05a52c85fe", size = 188480277, upload-time = "2026-05-07T19:05:03.231Z" },
-    { url = "https://files.pythonhosted.org/packages/13/31/8315ea5f8dd18e60970b3022e3a8b93fd37e0b784fbbef86e10c8e6e5ca1/triton-3.7.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:22bacffce443f54593dd20f05294d5a40622e0ea9ab632816f87154504356221", size = 201415942, upload-time = "2026-05-07T18:46:06.479Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/13/ec05adfcd87311d532ba61e3af143e8be59fcd26675884c4682841406a20/triton-3.7.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a4bf49b00a7a377a68a6da603a876e797614e6455a80e9021669c476a953ad9a", size = 188505104, upload-time = "2026-05-07T19:05:09.843Z" },
-    { url = "https://files.pythonhosted.org/packages/62/7b/468a576e35beef1426e0828e28e9ba9e65f5474d496f16ee126c15646324/triton-3.7.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8f111161d49bf903c0eaedde3962353a3d841c08a836839b7cc1025b8426efcf", size = 201457567, upload-time = "2026-05-07T18:46:13.505Z" },
-    { url = "https://files.pythonhosted.org/packages/01/e1/a59a583de59b8f62c495d67c80ee3ea97d09e91ac80c4c6e76456ed8d8ac/triton-3.7.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:abdf6beaa89b1bcfb9a43cd990536ce66091a997841a4814b260b7bee4c88c3c", size = 188503209, upload-time = "2026-05-07T19:05:17.935Z" },
-    { url = "https://files.pythonhosted.org/packages/30/b1/b7507bb9815d403927c8dd51d4158ed2e11751a92dbc118a044f247b6848/triton-3.7.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a35d7afe3f3f058e7ec49fcce09794049e0ffc5c59019ac25ec3413741b8c4e7", size = 201453566, upload-time = "2026-05-07T18:46:20.427Z" },
-    { url = "https://files.pythonhosted.org/packages/a6/8f/0bea7a6a0c989315c9135a1d7fb37e41905cfb3a17cbc1f10044ebd4cc3a/triton-3.7.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cc1d61c172d257db80ddf42595131fb196ad2e9bdd751e90fe2ef13531734e8b", size = 188612899, upload-time = "2026-05-07T19:05:24.955Z" },
-    { url = "https://files.pythonhosted.org/packages/e1/02/d96f57828d0912aec733b9bc7e0e7dbfd2c6f079a8fa433ac25cb93d1a30/triton-3.7.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:70fb9bbdc9f400afc54bbf6eb2670af28829a6ae3996863317964783141daf56", size = 201553816, upload-time = "2026-05-07T18:46:27.49Z" },
-    { url = "https://files.pythonhosted.org/packages/40/fb/82a802dac4689f2a2fb2e69302e6a138eecc3e175bbe976ba3cfc717683a/triton-3.7.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c4a44a8476d0d3571eac4e4d1048e1ff75aad81a09ff4602ccfc56c6dea1672e", size = 188507879, upload-time = "2026-05-07T19:05:32.209Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/af/9904ec6d3c93d9b24e5ec360445bbdf758b7f00bfbeedb89cb0eb64eb8bb/triton-3.7.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b9b85e72968a9d8bba5ddb24e9b64aaabaf48affb042f2755cb7cfa92b7531ce", size = 201460637, upload-time = "2026-05-07T18:46:34.749Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/f9/4835a8ea746b88727d8899f4e3ccce4f9cacb38abfc3bb0a638266c53111/triton-3.7.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:18a160de426fd99f92b0baf509045360afbd3bfaa0b4a5171dde800ec9f09684", size = 188608706, upload-time = "2026-05-07T19:05:39.218Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/68/fa86e5a39608000f645535b2c124920126327ab731f8c4fafd5b07ff8d4b/triton-3.7.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ce061073102714b725f3660ec6939d94a1da7984b3aa99c921417cae273672f5", size = 201546766, upload-time = "2026-05-07T18:46:42.088Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/a9/549e51e9b1b2c9b854fd761a1d23df0ba2fbc60bd0c13b489ffa518cfcb7/triton-3.3.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b74db445b1c562844d3cfad6e9679c72e93fdfb1a90a24052b03bb5c49d1242e", size = 155600257, upload-time = "2025-05-29T23:39:36.085Z" },
+    { url = "https://files.pythonhosted.org/packages/21/2f/3e56ea7b58f80ff68899b1dbe810ff257c9d177d288c6b0f55bf2fe4eb50/triton-3.3.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b31e3aa26f8cb3cc5bf4e187bf737cbacf17311e1112b781d4a059353dfd731b", size = 155689937, upload-time = "2025-05-29T23:39:44.182Z" },
+    { url = "https://files.pythonhosted.org/packages/24/5f/950fb373bf9c01ad4eb5a8cd5eaf32cdf9e238c02f9293557a2129b9c4ac/triton-3.3.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9999e83aba21e1a78c1f36f21bce621b77bcaa530277a50484a7cb4a822f6e43", size = 155669138, upload-time = "2025-05-29T23:39:51.771Z" },
 ]
 
 [[package]]
@@ -3663,7 +2544,7 @@ source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "h11" },
-    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/e6/bf/f6544ba992ddb9a6077343a576f9844f7f8f06ab819aefd00206e9255f18/uvicorn-0.48.0.tar.gz", hash = "sha256:a5504207195d08c2511bf9125ede5ac4a4b71725d519e758d01dcf0bc2d31c37", size = 91074, upload-time = "2026-05-24T12:08:41.925Z" }
 wheels = [
@@ -3672,11 +2553,11 @@ wheels = [
 
 [package.optional-dependencies]
 standard = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "colorama", marker = "sys_platform == 'win32' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "httptools" },
     { name = "python-dotenv" },
     { name = "pyyaml" },
-    { name = "uvloop", marker = "platform_python_implementation != 'PyPy' and sys_platform != 'cygwin' and sys_platform != 'win32'" },
+    { name = "uvloop", marker = "(platform_python_implementation != 'PyPy' and sys_platform != 'cygwin' and sys_platform != 'win32') or (platform_python_implementation == 'PyPy' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'cygwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'win32' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
     { name = "watchfiles" },
     { name = "websockets" },
 ]
@@ -3705,24 +2586,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/5f/6f/e62b4dfc7ad6518e7eff2516f680d02a0f6eb62c0c212e152ca708a0085e/uvloop-0.22.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7b5b1ac819a3f946d3b2ee07f09149578ae76066d70b44df3fa990add49a82e4", size = 4426307, upload-time = "2025-10-16T22:16:32.917Z" },
     { url = "https://files.pythonhosted.org/packages/90/60/97362554ac21e20e81bcef1150cb2a7e4ffdaf8ea1e5b2e8bf7a053caa18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e047cc068570bac9866237739607d1313b9253c3051ad84738cbb095be0537b2", size = 4131970, upload-time = "2025-10-16T22:16:34.015Z" },
     { url = "https://files.pythonhosted.org/packages/99/39/6b3f7d234ba3964c428a6e40006340f53ba37993f46ed6e111c6e9141d18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:512fec6815e2dd45161054592441ef76c830eddaad55c8aa30952e6fe1ed07c0", size = 4296343, upload-time = "2025-10-16T22:16:35.149Z" },
-    { url = "https://files.pythonhosted.org/packages/89/8c/182a2a593195bfd39842ea68ebc084e20c850806117213f5a299dfc513d9/uvloop-0.22.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:561577354eb94200d75aca23fbde86ee11be36b00e52a4eaf8f50fb0c86b7705", size = 1358611, upload-time = "2025-10-16T22:16:36.833Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/14/e301ee96a6dc95224b6f1162cd3312f6d1217be3907b79173b06785f2fe7/uvloop-0.22.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:1cdf5192ab3e674ca26da2eada35b288d2fa49fdd0f357a19f0e7c4e7d5077c8", size = 751811, upload-time = "2025-10-16T22:16:38.275Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/02/654426ce265ac19e2980bfd9ea6590ca96a56f10c76e63801a2df01c0486/uvloop-0.22.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e2ea3d6190a2968f4a14a23019d3b16870dd2190cd69c8180f7c632d21de68d", size = 4288562, upload-time = "2025-10-16T22:16:39.375Z" },
-    { url = "https://files.pythonhosted.org/packages/15/c0/0be24758891ef825f2065cd5db8741aaddabe3e248ee6acc5e8a80f04005/uvloop-0.22.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0530a5fbad9c9e4ee3f2b33b148c6a64d47bbad8000ea63704fa8260f4cf728e", size = 4366890, upload-time = "2025-10-16T22:16:40.547Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/53/8369e5219a5855869bcee5f4d317f6da0e2c669aecf0ef7d371e3d084449/uvloop-0.22.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bc5ef13bbc10b5335792360623cc378d52d7e62c2de64660616478c32cd0598e", size = 4119472, upload-time = "2025-10-16T22:16:41.694Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/ba/d69adbe699b768f6b29a5eec7b47dd610bd17a69de51b251126a801369ea/uvloop-0.22.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1f38ec5e3f18c8a10ded09742f7fb8de0108796eb673f30ce7762ce1b8550cad", size = 4239051, upload-time = "2025-10-16T22:16:43.224Z" },
-    { url = "https://files.pythonhosted.org/packages/90/cd/b62bdeaa429758aee8de8b00ac0dd26593a9de93d302bff3d21439e9791d/uvloop-0.22.1-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3879b88423ec7e97cd4eba2a443aa26ed4e59b45e6b76aabf13fe2f27023a142", size = 1362067, upload-time = "2025-10-16T22:16:44.503Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/f8/a132124dfda0777e489ca86732e85e69afcd1ff7686647000050ba670689/uvloop-0.22.1-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:4baa86acedf1d62115c1dc6ad1e17134476688f08c6efd8a2ab076e815665c74", size = 752423, upload-time = "2025-10-16T22:16:45.968Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/94/94af78c156f88da4b3a733773ad5ba0b164393e357cc4bd0ab2e2677a7d6/uvloop-0.22.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:297c27d8003520596236bdb2335e6b3f649480bd09e00d1e3a99144b691d2a35", size = 4272437, upload-time = "2025-10-16T22:16:47.451Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/35/60249e9fd07b32c665192cec7af29e06c7cd96fa1d08b84f012a56a0b38e/uvloop-0.22.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1955d5a1dd43198244d47664a5858082a3239766a839b2102a269aaff7a4e25", size = 4292101, upload-time = "2025-10-16T22:16:49.318Z" },
-    { url = "https://files.pythonhosted.org/packages/02/62/67d382dfcb25d0a98ce73c11ed1a6fba5037a1a1d533dcbb7cab033a2636/uvloop-0.22.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b31dc2fccbd42adc73bc4e7cdbae4fc5086cf378979e53ca5d0301838c5682c6", size = 4114158, upload-time = "2025-10-16T22:16:50.517Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/7a/f1171b4a882a5d13c8b7576f348acfe6074d72eaf52cccef752f748d4a9f/uvloop-0.22.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:93f617675b2d03af4e72a5333ef89450dfaa5321303ede6e67ba9c9d26878079", size = 4177360, upload-time = "2025-10-16T22:16:52.646Z" },
-    { url = "https://files.pythonhosted.org/packages/79/7b/b01414f31546caf0919da80ad57cbfe24c56b151d12af68cee1b04922ca8/uvloop-0.22.1-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:37554f70528f60cad66945b885eb01f1bb514f132d92b6eeed1c90fd54ed6289", size = 1454790, upload-time = "2025-10-16T22:16:54.355Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/31/0bb232318dd838cad3fa8fb0c68c8b40e1145b32025581975e18b11fab40/uvloop-0.22.1-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:b76324e2dc033a0b2f435f33eb88ff9913c156ef78e153fb210e03c13da746b3", size = 796783, upload-time = "2025-10-16T22:16:55.906Z" },
-    { url = "https://files.pythonhosted.org/packages/42/38/c9b09f3271a7a723a5de69f8e237ab8e7803183131bc57c890db0b6bb872/uvloop-0.22.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:badb4d8e58ee08dad957002027830d5c3b06aea446a6a3744483c2b3b745345c", size = 4647548, upload-time = "2025-10-16T22:16:57.008Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/37/945b4ca0ac27e3dc4952642d4c900edd030b3da6c9634875af6e13ae80e5/uvloop-0.22.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b91328c72635f6f9e0282e4a57da7470c7350ab1c9f48546c0f2866205349d21", size = 4467065, upload-time = "2025-10-16T22:16:58.206Z" },
-    { url = "https://files.pythonhosted.org/packages/97/cc/48d232f33d60e2e2e0b42f4e73455b146b76ebe216487e862700457fbf3c/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:daf620c2995d193449393d6c62131b3fbd40a63bf7b307a1527856ace637fe88", size = 4328384, upload-time = "2025-10-16T22:16:59.36Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/16/c1fd27e9549f3c4baf1dc9c20c456cd2f822dbf8de9f463824b0c0357e06/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6cde23eeda1a25c75b2e07d39970f3374105d5eafbaab2a4482be82f272d5a5e", size = 4296730, upload-time = "2025-10-16T22:17:00.744Z" },
 ]
 
 [[package]]
@@ -3775,67 +2638,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/fa/08/d9e2e0f9e8e6791d33aefc694ad7eefa7f901f63caff84a81ded38692f9c/watchfiles-1.2.0-cp312-cp312-win32.whl", hash = "sha256:7a2cffd17d27d2ecbb310c2b1d8174f222a5495b1a721894afa88ec11e25b898", size = 275480, upload-time = "2026-05-18T04:30:31.307Z" },
     { url = "https://files.pythonhosted.org/packages/1c/e6/9d42569c0102645cc8cea5d8c7d8a1e9d4ada2cb7f05f75e554b8aa2202a/watchfiles-1.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:f155b3a1b2a5fc89cdc70d47ee5d54e3b75e88efa34982028a35daef9ba00379", size = 288718, upload-time = "2026-05-18T04:32:10.745Z" },
     { url = "https://files.pythonhosted.org/packages/0a/26/88e0dc6ee3898169d7fa22bb6a69cabf2502d2ee25cb8c876d1262d204f8/watchfiles-1.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:8fa585ede612ee9f9e91b18bebf9ba11b9ae29a4e3a0d0cf6fca3e382133f0d5", size = 281026, upload-time = "2026-05-18T04:30:22.23Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/4d/70a7feced9f87e2ff26dba42667290f41694fc64646c67261fbb8cab5d5c/watchfiles-1.2.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:01ea8d66f0693b9b60a6541c8d10263091ca9a9060d242f3c1f3143f9aad2c98", size = 399730, upload-time = "2026-05-18T04:31:38.162Z" },
-    { url = "https://files.pythonhosted.org/packages/31/3a/0da302f2307aee316922806ebd5726c542cbd787c938271cf14a074c7daf/watchfiles-1.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7ba0480b9a74af058f43b337e937a451e109295c420916d68ad24e3dc02f5e44", size = 392842, upload-time = "2026-05-18T04:30:27.051Z" },
-    { url = "https://files.pythonhosted.org/packages/db/ef/d5bdb705c224dbc256aa0c1ec47bf4e61ec52558f2afb44a71a1fe4d7015/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4f34e26a19f91f710c08e0183429f0d1d15df734e6bc78c31e77b9ea9c433658", size = 452989, upload-time = "2026-05-18T04:31:11.945Z" },
-    { url = "https://files.pythonhosted.org/packages/71/29/5495f2c1661949ef7a35e4d71111d129cfe7606414a26887a919d0a55406/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b4e77f6a55f858504069abd35d336a637555c09bca453dde1ee1e5ada8a6a1fb", size = 458978, upload-time = "2026-05-18T04:30:52.606Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/8c/7f9c07c433811c2fffd93e13fdfb7135de9aab5f2ae41be08960fa0047dc/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0cb4d80e212f116474a545c21c912b445f16bb0cef9e6a73a498164223e14e2f", size = 490248, upload-time = "2026-05-18T04:31:36.003Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/11/d93632febc52fbc21be90231bb7c17fd5387f46c9076fd40a5f9c2ae6910/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b974946a10af379d425e2eef5b62f5c6ebeaccf91d45eaad6f5b27ecd4f91aa0", size = 571847, upload-time = "2026-05-18T04:31:10.862Z" },
-    { url = "https://files.pythonhosted.org/packages/55/b4/383173e73aabb07ad1d9c7aa859d95437ac46a6d6a1e11005facda0c9d19/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:86bc13c25a8d1fcd70b51d0ce7c9b65e90de5666fcbfd3e34957cc73ee19aeb5", size = 465974, upload-time = "2026-05-18T04:30:17.006Z" },
-    { url = "https://files.pythonhosted.org/packages/a7/6c/89b1a230a78f57c52dd8893adb1f92f94411721b6ec12596c56d98c74356/watchfiles-1.2.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca148d73dea36c9763aaa351e4d7a51780ec1584217c45276f4fe8239c768b71", size = 454782, upload-time = "2026-05-18T04:30:35.656Z" },
-    { url = "https://files.pythonhosted.org/packages/24/62/1732118367cfff0a9fce3bf62ff4bfded09ef5df21d9d446b858b3f70a96/watchfiles-1.2.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:c525543d91961c6955b2636b308569e84a1d1c5f5f2932041ab9ef46422f43e3", size = 465182, upload-time = "2026-05-18T04:30:20.846Z" },
-    { url = "https://files.pythonhosted.org/packages/28/96/716f7e5f51339bf22963f3345f9f27d7f3b30e2eadc597e257c881dd3c53/watchfiles-1.2.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:a204794696ffb8f9b10fba6f7cb5216d42f3b2b71860ccac6b6e42f5f10973b0", size = 629841, upload-time = "2026-05-18T04:31:05.397Z" },
-    { url = "https://files.pythonhosted.org/packages/4c/fe/c40783950fd771ccf66ab3ec2722d188a9af1c7f96c6e811f36e40c6e03f/watchfiles-1.2.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:10d86db20695afe7997ac9e1717637d6714a8d0220458c33f3d2061f54cec427", size = 658028, upload-time = "2026-05-18T04:31:48.22Z" },
-    { url = "https://files.pythonhosted.org/packages/71/72/4508db1856d1d87fcbb3b63f4839bab1b5682cb0e8d224d122263c09654a/watchfiles-1.2.0-cp313-cp313-win32.whl", hash = "sha256:eb283ee99e21ad6443c8cdb06ac5b34b1308c329cbdf03fa02b445363714c799", size = 275183, upload-time = "2026-05-18T04:30:59.57Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/36/14b76ca57652e5cc5fd1c11f32a261292c08a0d19a00351013c2549cbfb2/watchfiles-1.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:a0f27f01bee51861392bb6b7c4fdb290b27d1eb194e9e28788d68102a0e898d9", size = 288059, upload-time = "2026-05-18T04:32:07.937Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/8d/0a85e395398d8d20fadfe5c5d32c726eee17a519e78fb356f2cf7531bffe/watchfiles-1.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:3651aa7058595e9cfb75d35dd5ada2bf9f48a5b8a0f3562821d3e210c507e077", size = 280186, upload-time = "2026-05-18T04:31:54.484Z" },
-    { url = "https://files.pythonhosted.org/packages/37/68/36db056f1fdcc5f07302f56e631774d6835bcd6fa3ace402304621d5f9e5/watchfiles-1.2.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:faea288b6f0ab1902ef08f4ca6de005dccf856c4e0c4f21b8c5fce02d90a1b08", size = 399031, upload-time = "2026-05-18T04:30:44.576Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/64/01a9d6f66a82a5c101ce939274106cc72759d62427e153f01edd2b9f87c2/watchfiles-1.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:01859b11fd9fbca670f4d5da00fbac282cfea9bd67a2125d8b2833a3b5617ea9", size = 391205, upload-time = "2026-05-18T04:30:25.413Z" },
-    { url = "https://files.pythonhosted.org/packages/84/2c/0a44fe058cb4bb7b8ede6b6670698bbb7c0400740e378d00022189b7b31d/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fff610d7bb2256a317bb1e96f0d7862c7aa8076733ee5df0fd41bbe76a24a4f4", size = 451892, upload-time = "2026-05-18T04:32:14.005Z" },
-    { url = "https://files.pythonhosted.org/packages/67/a1/351e0d56cd35e6488b5c8b4fb11a809a5bc923e8fe8fed9faf8920be0c89/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b141a4891c995a039cd89e9a49e62df1dc8a559a5d1a6e4c7106d16c12777a55", size = 458867, upload-time = "2026-05-18T04:31:22.279Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/7d/9d09605187f1b838998624049fcf8bf47b73c1a3b76901fcac1782f62277/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f22943b7770483f6ea0721c6b11d022947a98eb0acae14694de034f4d0d38925", size = 490217, upload-time = "2026-05-18T04:31:43.657Z" },
-    { url = "https://files.pythonhosted.org/packages/60/5d/a17a16eccb182f04188cd308ec24b1a71a9b5c4e7098269cf35d9fa56d02/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1bc6195825b7dcd217968bb1f801a60fd4c16e8eeab5bedc7fe917d7d5995ab4", size = 571458, upload-time = "2026-05-18T04:32:11.875Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/3d/4dd457062083ab1938e5dfd45032eb425cee2ac817287ca8ff4356183e5d/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d4a4b147f5dca2a5d325a06a832fb43f345751adfbc63204aec30e0d9ca965a2", size = 464707, upload-time = "2026-05-18T04:30:43.492Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/71/ea8c57b128f5383de74d0c7d2d9c57ad7c9a65a930c451bd25d524b295b7/watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4543579a9bdb0c9560039b4ffddbdb39545707659fbc430ce4c10f3f68d557f9", size = 454663, upload-time = "2026-05-18T04:30:16.061Z" },
-    { url = "https://files.pythonhosted.org/packages/53/fd/2e812bf938406d7db351f0703ddd3fc6c061cf30d96153a77bc79a943a44/watchfiles-1.2.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:20aa0e708b920bde876a4aa82dc7dd6ebea228a63a67cda6632c2fc87b787efa", size = 463537, upload-time = "2026-05-18T04:31:44.9Z" },
-    { url = "https://files.pythonhosted.org/packages/86/56/d17a7f1dd1bc3035f1072694a551301272f1739c2d8e319c927cb9e29b38/watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:d413349d565dab74297f2a63e84a097936be69bf8f3b3801f27f380e32040f44", size = 629194, upload-time = "2026-05-18T04:31:14.141Z" },
-    { url = "https://files.pythonhosted.org/packages/be/06/f1ff66bf5cae50aa4062779a0ecd0bbaf15e466195719074078947d9a17d/watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f28b2725eb8cce327b9b3ab02415c853011dc55c95832fe90de6bc56f5315f72", size = 656194, upload-time = "2026-05-18T04:31:47.14Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/54/a9c7ea9a82a4ac65e7004c0a03920b5cdd2f9c3b678757d9cd425aa51d53/watchfiles-1.2.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:b8c8358484d5fa12ef34f05b7f4168eaf1932f408725ff6d023c33ec17bd79d4", size = 400205, upload-time = "2026-05-18T04:32:05.153Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/5d/c9ab3534374a4a67450696905d6ef16a04405448b8dc52bd752ae50423d4/watchfiles-1.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:9f04b092229ad2c50126dd3c922c8822e51e605993764a33058d4a791ab42281", size = 392508, upload-time = "2026-05-18T04:30:54.849Z" },
-    { url = "https://files.pythonhosted.org/packages/26/ca/1ad30103535cf0cecd7b993e8d50edc5351b1820e38f2d22e3df58962feb/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7a7ce236284f002a156f70add88efe5c70879cccbb658be0822c54b1306fc09d", size = 452448, upload-time = "2026-05-18T04:30:53.727Z" },
-    { url = "https://files.pythonhosted.org/packages/37/a1/ceee2cdf2afbd715fa07758d39c9859513eae411b23196f7fd039e5feedd/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b9909cc2b48468b575eefa944919e1fe8a36c5849d5c7c168f80a8c1db69398e", size = 459605, upload-time = "2026-05-18T04:30:23.312Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/f6/421e30fd1cb3907a84ed92ab3f1983e37ba2dca015e9a894a048418417a2/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0a37faaed405c67e28e6be45a1fa4f206ef5a2860f27c237db9fa30704c38242", size = 490757, upload-time = "2026-05-18T04:30:47.358Z" },
-    { url = "https://files.pythonhosted.org/packages/41/b0/55ed1b97ed08be7bba6f9a541cac15f2a858e1d74d2b07b6da70a82aab00/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9649193aa27bd9ff2e80ff29bfaa93085496c7a3a377592823cc58b77ee88add", size = 568672, upload-time = "2026-05-18T04:30:38.915Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/cf/d8ae8a80dd7bafab395ea7681c10237311bbf34d37704a8c744e7cf31fc7/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e4ff8e37f99cf1da89e255e07c9c4b37c214038c4283707bdec308cb1b0ea1f", size = 464197, upload-time = "2026-05-18T04:30:09.914Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/8a/3076c496ca8dafe0e8cd03fcebdfc47be4b1174b4e5b24ff6e396e6b3af2/watchfiles-1.2.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:054dc20fd2e3132b4c3883b4a00d72fd6e1f56fdaf89fccd12e8057d74cd74d7", size = 453181, upload-time = "2026-05-18T04:30:14.829Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/10/9745e17c98e7b8a86454df0a3c7b5686bd650383f1e9f26e4ebcbd6cc0c0/watchfiles-1.2.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:e140ed30ebde76796b686e67c182cff10ea2fbab186fafd1560f74bb5a473a6e", size = 465109, upload-time = "2026-05-18T04:30:28.123Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/95/8ef4a95481d3e0cb52d62a06fa6e972e81424be2d9698b91a2fecca9904c/watchfiles-1.2.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:bb7e52ecf68ba46d22df23467b87cffeb2146908aa523ebfe803019618cfda06", size = 630653, upload-time = "2026-05-18T04:31:49.304Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/e4/3b3bf36b0f829b50c6ebcb8d031583863c59f923d6a6af3d485e470d0fac/watchfiles-1.2.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:23282a321c8baf9b3a3c4afff673f9fe65eb7fdc2338d765ccad9d3d1916a5ba", size = 657838, upload-time = "2026-05-18T04:31:06.497Z" },
-    { url = "https://files.pythonhosted.org/packages/21/b1/6cbbb50c1f3002ab568777d44aa21206dfb8807a840990c4037523b51812/watchfiles-1.2.0-cp314-cp314-win32.whl", hash = "sha256:c0db965c5f79aa49fe672d297cf1febc5ad149b658594944f49a54a2b96270a7", size = 275108, upload-time = "2026-05-18T04:30:06.891Z" },
-    { url = "https://files.pythonhosted.org/packages/92/45/190ce6db8dcb4536682cf75d3889ff1a27182a58cb519d343cb6d9ea63d8/watchfiles-1.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:71283b39fd17e5408eb123bd37aeecfd9d54c81fc184421943208aadb879d103", size = 288441, upload-time = "2026-05-18T04:32:12.901Z" },
-    { url = "https://files.pythonhosted.org/packages/74/0d/3eae1c2313ab08378431d907c3f8095ecca00f3eda33111cf4f0f2591799/watchfiles-1.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:c5c19526f4e54a00f2666a6c0e9e40d582c09e865055ea7378bf0009aab857b3", size = 280684, upload-time = "2026-05-18T04:31:26.902Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/75/fb64e6c25d6b5ca636d03df34ffb1c6e9873303e76d27967e045f8df088f/watchfiles-1.2.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:d73a585accffa5ae39c17264c36ec3166d2fad7000c780f5ef83b2722afb9dd2", size = 398857, upload-time = "2026-05-18T04:32:17.108Z" },
-    { url = "https://files.pythonhosted.org/packages/73/4e/9f7adf01754cbf81843722ccfec169d8f26c69778281a302855cecd2ee08/watchfiles-1.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ae99b14c5f21e026e0e9d96f40e07d8570ebee6cafd9d8fc318354606daa7a28", size = 392413, upload-time = "2026-05-18T04:31:07.911Z" },
-    { url = "https://files.pythonhosted.org/packages/47/c8/bec626bcc2d69f44b9acb24ce7d60ed7b16b73628eea747fcbd169d8edda/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4429f3b105524a10b72c3a819b091c495d2811d419c1e1e8df773a5a5974f831", size = 452409, upload-time = "2026-05-18T04:31:20.142Z" },
-    { url = "https://files.pythonhosted.org/packages/00/b7/b6362068e81e7c556d155a34c35d40ac3ef42d747b06d7f6e5bf58e359c2/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:43d818978d06062d9b22c4fab2ebe44cf5213d42dc8e62bda8c2760cfa2eeb33", size = 458827, upload-time = "2026-05-18T04:32:06.219Z" },
-    { url = "https://files.pythonhosted.org/packages/67/f8/9a813fa42afb1e0b4625e75f0479826644d3ee8dc287e093799bc01f390c/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b9f732dc58b2dbe69e464ccf8fff7a03b0dd0be439da4c0720d3558527d3d6b4", size = 490104, upload-time = "2026-05-18T04:31:56.034Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/bf/27dfb6094ca4c9aad21298b5525b6c53cb36121ee454331d05161e58d130/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8f200104103feb097de4cab8fe4f5dd18a2026934c7dea98c55a2f5fd6d5a33b", size = 571360, upload-time = "2026-05-18T04:31:57.133Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/39/44a096d67270ea93df91d33877dbe91fbda3aa4f8ec2edf799d93eda8736/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:63ac26eefbf4af1741247d6fb68b11c49a25b2f7413fbd318a83a12aaa9cf666", size = 464644, upload-time = "2026-05-18T04:30:57.33Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/80/c7472203bad6268e3ef1ad260739704847898938ad7ea8b63a5131f46b50/watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c4997d4e4a55f0d02b6cde327322daf3a0400e5df6c6b15948994bf72497925", size = 454771, upload-time = "2026-05-18T04:30:48.736Z" },
-    { url = "https://files.pythonhosted.org/packages/51/cf/3b10b268b4b7f0fc26e9debb5eef1998b515887840f444cd3ec80c688755/watchfiles-1.2.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:4c887eba18b7945ac73067a8b4a66f21cd46c2539b2bc68588f7be6c7eb6d26b", size = 463494, upload-time = "2026-05-18T04:31:33.826Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/3e/a4302545cd589262a0dc7d140e86f7688eba3f9c72776c27f7e23b8864c4/watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:3416ff151bb6b5a8d8d11664974fbef4d9305b9b2957839ab5a270468fd8df30", size = 629383, upload-time = "2026-05-18T04:31:15.596Z" },
-    { url = "https://files.pythonhosted.org/packages/db/99/d5649df0a9a410d45b7c882304d0b790903ac9b6e8f2cfd12114e0c6b9f2/watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:0e831a271c035d89789cffc386b6aa1375f39f1cd25eb7ca0997e4970d152fc5", size = 656093, upload-time = "2026-05-18T04:31:58.707Z" },
-    { url = "https://files.pythonhosted.org/packages/92/b9/362702539275019a54dd2e94511b31a9b89c5f9e6a21966de7eb692549fc/watchfiles-1.2.0-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:37a6721cdf3f65dbb13aa9503510ccb4451603ac837e44d265d7992a597e1374", size = 400109, upload-time = "2026-05-18T04:31:16.879Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/75/71d5ba62db781e5587bded1d944c675374bc4aa37ff33d5018d98e8b6538/watchfiles-1.2.0-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:2b37d10b5a63bd4d87e18472d80fa525bd670586fae62e5dd580452764879b65", size = 392167, upload-time = "2026-05-18T04:31:28.058Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/01/c66dd95d0423fe30d31820e2d1d5bda773764131bbb6ac0cb1cf303ac328/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a105bc2283f67e8fbec74253ec2d94925de92ed72c0393f1206bf326b7b7b69", size = 452372, upload-time = "2026-05-18T04:31:00.836Z" },
-    { url = "https://files.pythonhosted.org/packages/91/15/2fe99557e72f85627c6a8eed50d889e8d101623e060a22ad75b875cb932d/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5327989a465505f05cfe06f04fa9d0c2fd5432bb243e10e6f012b1bdca3c8579", size = 459596, upload-time = "2026-05-18T04:31:34.96Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/23/d4acfa0023367428ed48351b3b9b267893037b6cadae55620c61c24bcfd4/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ecb47f183a8025b2aa18b546725c3657e542112ae9c0613a2af79b4fa8d04ad7", size = 490869, upload-time = "2026-05-18T04:31:59.923Z" },
-    { url = "https://files.pythonhosted.org/packages/a4/5f/3164cbdce06c9fb95c4f7b9e2f9760b5e2797af43a9ecc317ef42a23a278/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8520a4ab0e37f770afc34459c4f8f7019e153f9124dc101c15538365875d1ab2", size = 571641, upload-time = "2026-05-18T04:32:00.948Z" },
-    { url = "https://files.pythonhosted.org/packages/41/e6/85d3731c55e65cd7690f3f803d24c139588aaf863e4bf2148fe7a7fa1a19/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:71cd71740ed2c15211ebb237ced4e39a1cdf6f80566e5fe95428da1626f4fde6", size = 464444, upload-time = "2026-05-18T04:30:34.298Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/7d/562641012b8b09872742c3b8adf9629ec479fd78f8d68ae4a0c13da8add6/watchfiles-1.2.0-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f88af53d6ddaf72179ef613ddc905e6f4785f712b49b80b3bef9f3525e6194b4", size = 453593, upload-time = "2026-05-18T04:31:23.464Z" },
-    { url = "https://files.pythonhosted.org/packages/56/fe/cb8ef3d6f929d14158fdaaad9925985b7310abc9384dcd4d82dd0016fb59/watchfiles-1.2.0-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:cee9d5efd929efdac5f7e58f72b3376f676b64050a91c5b99a7094c5b2317488", size = 465096, upload-time = "2026-05-18T04:31:30.384Z" },
-    { url = "https://files.pythonhosted.org/packages/25/91/80908e835e100527a9267147b08c0eee1fa6ab0ffec15edc04d1d44885f7/watchfiles-1.2.0-cp315-cp315-musllinux_1_1_aarch64.whl", hash = "sha256:b718bf356bbc15e559bd8ef41782b573b8ae0e3f177ab244b440568d7ea02cfb", size = 630638, upload-time = "2026-05-18T04:30:49.89Z" },
-    { url = "https://files.pythonhosted.org/packages/46/4b/95ab2f256bb4af3cb2eb23b9317bda984ee6e0f11733a5c004a6c95b06e3/watchfiles-1.2.0-cp315-cp315-musllinux_1_1_x86_64.whl", hash = "sha256:922c0e019fe68b3ae392965a766b02a71ba1168c932cebc3733cd52c5fe5b377", size = 657684, upload-time = "2026-05-18T04:31:32.027Z" },
     { url = "https://files.pythonhosted.org/packages/23/f4/7513ef1e85fc4c6331b59479d6d72661fc391fbe543678052ac72c8b6c19/watchfiles-1.2.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:4674d49eb94706dfe666c069fc0a1b646ffcf920473492e209f6d5f60d3f0cc2", size = 403050, upload-time = "2026-05-18T04:30:36.753Z" },
     { url = "https://files.pythonhosted.org/packages/27/0b/a54103cfd732bb703c7a749222011a0483ef3705948dae3b203158601119/watchfiles-1.2.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:094b9b70103d4e963499bdea001ee3c2697b144cd9ae6218a62c0f89ec9e31db", size = 396629, upload-time = "2026-05-18T04:32:03.268Z" },
     { url = "https://files.pythonhosted.org/packages/5e/2c/73f31a3b893886206c3f54d73e8ad8dee58cdb2f69ad2622e0a8a9e07f4e/watchfiles-1.2.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b0ef001f8c25ad0fa9529f914c1600647ecd0f542d11c19b7894768c67b6acb7", size = 457318, upload-time = "2026-05-18T04:31:01.932Z" },
@@ -3875,33 +2677,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/47/88/4dd516068e1a3d6ab3c7c183288404cd424a9a02d585efbac226cb61ff2d/websockets-16.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:485c49116d0af10ac698623c513c1cc01c9446c058a4e61e3bf6c19dff7335a2", size = 184880, upload-time = "2026-01-10T09:22:55.033Z" },
     { url = "https://files.pythonhosted.org/packages/91/d6/7d4553ad4bf1c0421e1ebd4b18de5d9098383b5caa1d937b63df8d04b565/websockets-16.0-cp312-cp312-win32.whl", hash = "sha256:eaded469f5e5b7294e2bdca0ab06becb6756ea86894a47806456089298813c89", size = 178261, upload-time = "2026-01-10T09:22:56.251Z" },
     { url = "https://files.pythonhosted.org/packages/c3/f0/f3a17365441ed1c27f850a80b2bc680a0fa9505d733fe152fdf5e98c1c0b/websockets-16.0-cp312-cp312-win_amd64.whl", hash = "sha256:5569417dc80977fc8c2d43a86f78e0a5a22fee17565d78621b6bb264a115d4ea", size = 178693, upload-time = "2026-01-10T09:22:57.478Z" },
-    { url = "https://files.pythonhosted.org/packages/cc/9c/baa8456050d1c1b08dd0ec7346026668cbc6f145ab4e314d707bb845bf0d/websockets-16.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:878b336ac47938b474c8f982ac2f7266a540adc3fa4ad74ae96fea9823a02cc9", size = 177364, upload-time = "2026-01-10T09:22:59.333Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/0c/8811fc53e9bcff68fe7de2bcbe75116a8d959ac699a3200f4847a8925210/websockets-16.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:52a0fec0e6c8d9a784c2c78276a48a2bdf099e4ccc2a4cad53b27718dbfd0230", size = 175039, upload-time = "2026-01-10T09:23:01.171Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/82/39a5f910cb99ec0b59e482971238c845af9220d3ab9fa76dd9162cda9d62/websockets-16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e6578ed5b6981005df1860a56e3617f14a6c307e6a71b4fff8c48fdc50f3ed2c", size = 175323, upload-time = "2026-01-10T09:23:02.341Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/28/0a25ee5342eb5d5f297d992a77e56892ecb65e7854c7898fb7d35e9b33bd/websockets-16.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:95724e638f0f9c350bb1c2b0a7ad0e83d9cc0c9259f3ea94e40d7b02a2179ae5", size = 184975, upload-time = "2026-01-10T09:23:03.756Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/66/27ea52741752f5107c2e41fda05e8395a682a1e11c4e592a809a90c6a506/websockets-16.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0204dc62a89dc9d50d682412c10b3542d748260d743500a85c13cd1ee4bde82", size = 186203, upload-time = "2026-01-10T09:23:05.01Z" },
-    { url = "https://files.pythonhosted.org/packages/37/e5/8e32857371406a757816a2b471939d51c463509be73fa538216ea52b792a/websockets-16.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:52ac480f44d32970d66763115edea932f1c5b1312de36df06d6b219f6741eed8", size = 185653, upload-time = "2026-01-10T09:23:06.301Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/67/f926bac29882894669368dc73f4da900fcdf47955d0a0185d60103df5737/websockets-16.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6e5a82b677f8f6f59e8dfc34ec06ca6b5b48bc4fcda346acd093694cc2c24d8f", size = 184920, upload-time = "2026-01-10T09:23:07.492Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/a1/3d6ccdcd125b0a42a311bcd15a7f705d688f73b2a22d8cf1c0875d35d34a/websockets-16.0-cp313-cp313-win32.whl", hash = "sha256:abf050a199613f64c886ea10f38b47770a65154dc37181bfaff70c160f45315a", size = 178255, upload-time = "2026-01-10T09:23:09.245Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/ae/90366304d7c2ce80f9b826096a9e9048b4bb760e44d3b873bb272cba696b/websockets-16.0-cp313-cp313-win_amd64.whl", hash = "sha256:3425ac5cf448801335d6fdc7ae1eb22072055417a96cc6b31b3861f455fbc156", size = 178689, upload-time = "2026-01-10T09:23:10.483Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/1d/e88022630271f5bd349ed82417136281931e558d628dd52c4d8621b4a0b2/websockets-16.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8cc451a50f2aee53042ac52d2d053d08bf89bcb31ae799cb4487587661c038a0", size = 177406, upload-time = "2026-01-10T09:23:12.178Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/78/e63be1bf0724eeb4616efb1ae1c9044f7c3953b7957799abb5915bffd38e/websockets-16.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:daa3b6ff70a9241cf6c7fc9e949d41232d9d7d26fd3522b1ad2b4d62487e9904", size = 175085, upload-time = "2026-01-10T09:23:13.511Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/f4/d3c9220d818ee955ae390cf319a7c7a467beceb24f05ee7aaaa2414345ba/websockets-16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:fd3cb4adb94a2a6e2b7c0d8d05cb94e6f1c81a0cf9dc2694fb65c7e8d94c42e4", size = 175328, upload-time = "2026-01-10T09:23:14.727Z" },
-    { url = "https://files.pythonhosted.org/packages/63/bc/d3e208028de777087e6fb2b122051a6ff7bbcca0d6df9d9c2bf1dd869ae9/websockets-16.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:781caf5e8eee67f663126490c2f96f40906594cb86b408a703630f95550a8c3e", size = 185044, upload-time = "2026-01-10T09:23:15.939Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/6e/9a0927ac24bd33a0a9af834d89e0abc7cfd8e13bed17a86407a66773cc0e/websockets-16.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:caab51a72c51973ca21fa8a18bd8165e1a0183f1ac7066a182ff27107b71e1a4", size = 186279, upload-time = "2026-01-10T09:23:17.148Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/ca/bf1c68440d7a868180e11be653c85959502efd3a709323230314fda6e0b3/websockets-16.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19c4dc84098e523fd63711e563077d39e90ec6702aff4b5d9e344a60cb3c0cb1", size = 185711, upload-time = "2026-01-10T09:23:18.372Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/f8/fdc34643a989561f217bb477cbc47a3a07212cbda91c0e4389c43c296ebf/websockets-16.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5e18a238a2b2249c9a9235466b90e96ae4795672598a58772dd806edc7ac6d3", size = 184982, upload-time = "2026-01-10T09:23:19.652Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/d1/574fa27e233764dbac9c52730d63fcf2823b16f0856b3329fc6268d6ae4f/websockets-16.0-cp314-cp314-win32.whl", hash = "sha256:a069d734c4a043182729edd3e9f247c3b2a4035415a9172fd0f1b71658a320a8", size = 177915, upload-time = "2026-01-10T09:23:21.458Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/f1/ae6b937bf3126b5134ce1f482365fde31a357c784ac51852978768b5eff4/websockets-16.0-cp314-cp314-win_amd64.whl", hash = "sha256:c0ee0e63f23914732c6d7e0cce24915c48f3f1512ec1d079ed01fc629dab269d", size = 178381, upload-time = "2026-01-10T09:23:22.715Z" },
-    { url = "https://files.pythonhosted.org/packages/06/9b/f791d1db48403e1f0a27577a6beb37afae94254a8c6f08be4a23e4930bc0/websockets-16.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:a35539cacc3febb22b8f4d4a99cc79b104226a756aa7400adc722e83b0d03244", size = 177737, upload-time = "2026-01-10T09:23:24.523Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/40/53ad02341fa33b3ce489023f635367a4ac98b73570102ad2cdd770dacc9a/websockets-16.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:b784ca5de850f4ce93ec85d3269d24d4c82f22b7212023c974c401d4980ebc5e", size = 175268, upload-time = "2026-01-10T09:23:25.781Z" },
-    { url = "https://files.pythonhosted.org/packages/74/9b/6158d4e459b984f949dcbbb0c5d270154c7618e11c01029b9bbd1bb4c4f9/websockets-16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:569d01a4e7fba956c5ae4fc988f0d4e187900f5497ce46339c996dbf24f17641", size = 175486, upload-time = "2026-01-10T09:23:27.033Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/2d/7583b30208b639c8090206f95073646c2c9ffd66f44df967981a64f849ad/websockets-16.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:50f23cdd8343b984957e4077839841146f67a3d31ab0d00e6b824e74c5b2f6e8", size = 185331, upload-time = "2026-01-10T09:23:28.259Z" },
-    { url = "https://files.pythonhosted.org/packages/45/b0/cce3784eb519b7b5ad680d14b9673a31ab8dcb7aad8b64d81709d2430aa8/websockets-16.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:152284a83a00c59b759697b7f9e9cddf4e3c7861dd0d964b472b70f78f89e80e", size = 186501, upload-time = "2026-01-10T09:23:29.449Z" },
-    { url = "https://files.pythonhosted.org/packages/19/60/b8ebe4c7e89fb5f6cdf080623c9d92789a53636950f7abacfc33fe2b3135/websockets-16.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:bc59589ab64b0022385f429b94697348a6a234e8ce22544e3681b2e9331b5944", size = 186062, upload-time = "2026-01-10T09:23:31.368Z" },
-    { url = "https://files.pythonhosted.org/packages/88/a8/a080593f89b0138b6cba1b28f8df5673b5506f72879322288b031337c0b8/websockets-16.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:32da954ffa2814258030e5a57bc73a3635463238e797c7375dc8091327434206", size = 185356, upload-time = "2026-01-10T09:23:32.627Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/b6/b9afed2afadddaf5ebb2afa801abf4b0868f42f8539bfe4b071b5266c9fe/websockets-16.0-cp314-cp314t-win32.whl", hash = "sha256:5a4b4cc550cb665dd8a47f868c8d04c8230f857363ad3c9caf7a0c3bf8c61ca6", size = 178085, upload-time = "2026-01-10T09:23:33.816Z" },
-    { url = "https://files.pythonhosted.org/packages/9f/3e/28135a24e384493fa804216b79a6a6759a38cc4ff59118787b9fb693df93/websockets-16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b14dc141ed6d2dde437cddb216004bcac6a1df0935d79656387bd41632ba0bbd", size = 178531, upload-time = "2026-01-10T09:23:35.016Z" },
     { url = "https://files.pythonhosted.org/packages/72/07/c98a68571dcf256e74f1f816b8cc5eae6eb2d3d5cfa44d37f801619d9166/websockets-16.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:349f83cd6c9a415428ee1005cadb5c2c56f4389bc06a9af16103c3bc3dcc8b7d", size = 174947, upload-time = "2026-01-10T09:23:36.166Z" },
     { url = "https://files.pythonhosted.org/packages/7e/52/93e166a81e0305b33fe416338be92ae863563fe7bce446b0f687b9df5aea/websockets-16.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:4a1aba3340a8dca8db6eb5a7986157f52eb9e436b74813764241981ca4888f03", size = 175260, upload-time = "2026-01-10T09:23:37.409Z" },
     { url = "https://files.pythonhosted.org/packages/56/0c/2dbf513bafd24889d33de2ff0368190a0e69f37bcfa19009ef819fe4d507/websockets-16.0-pp311-pypy311_pp73-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:f4a32d1bd841d4bcbffdcb3d2ce50c09c3909fbead375ab28d0181af89fd04da", size = 176071, upload-time = "2026-01-10T09:23:39.158Z" },
@@ -3928,12 +2703,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d3/54/3dd06f2341fab6abb06588a16b30e0b213b0125be7b79dafc3bdba3b334a/winrt_runtime-3.2.1-cp312-cp312-win32.whl", hash = "sha256:762b3d972a2f7037f7db3acbaf379dd6d8f6cda505f71f66c6b425d1a1eae2f1", size = 210090, upload-time = "2025-06-06T06:44:08.151Z" },
     { url = "https://files.pythonhosted.org/packages/ca/a1/1d7248d5c62ccbea5f3e0da64ca4529ce99c639c3be2485b6ed709f5c740/winrt_runtime-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:06510db215d4f0dc45c00fbb1251c6544e91742a0ad928011db33b30677e1576", size = 241391, upload-time = "2025-06-06T06:44:09.442Z" },
     { url = "https://files.pythonhosted.org/packages/8a/ae/6a205d8dafc79f7c242be7f940b1e0c1971fd64ab3079bda4b514aa3d714/winrt_runtime-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:14562c29a087ccad38e379e585fef333e5c94166c807bdde67b508a6261aa195", size = 415242, upload-time = "2025-06-06T06:44:10.407Z" },
-    { url = "https://files.pythonhosted.org/packages/79/d4/1a555d8bdcb8b920f8e896232c82901cc0cda6d3e4f92842199ae7dff70a/winrt_runtime-3.2.1-cp313-cp313-win32.whl", hash = "sha256:44e2733bc709b76c554aee6c7fe079443b8306b2e661e82eecfebe8b9d71e4d1", size = 210022, upload-time = "2025-06-06T06:44:11.767Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/24/2b6e536ca7745d788dfd17a2ec376fa03a8c7116dc638bb39b035635484f/winrt_runtime-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:3c1fdcaeedeb2920dc3b9039db64089a6093cad2be56a3e64acc938849245a6d", size = 241349, upload-time = "2025-06-06T06:44:12.661Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/7f/6d72973279e2929b2a71ed94198ad4a5d63ee2936e91a11860bf7b431410/winrt_runtime-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:28f3dab083412625ff4d2b46e81246932e6bebddf67bea7f05e01712f54e6159", size = 415126, upload-time = "2025-06-06T06:44:13.702Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/87/88bd98419a9da77a68e030593fee41702925a7ad8a8aec366945258cbb31/winrt_runtime-3.2.1-cp314-cp314-win32.whl", hash = "sha256:9b6298375468ac2f6815d0c008a059fc16508c8f587e824c7936ed9216480dad", size = 210257, upload-time = "2025-09-20T07:06:41.054Z" },
-    { url = "https://files.pythonhosted.org/packages/87/85/e5c2a10d287edd9d3ee8dc24bf7d7f335636b92bf47119768b7dd2fd1669/winrt_runtime-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:e36e587ab5fd681ee472cd9a5995743f75107a1a84d749c64f7e490bc86bc814", size = 241873, upload-time = "2025-09-20T07:06:42.059Z" },
-    { url = "https://files.pythonhosted.org/packages/52/2a/eb9e78397132175f70dd51dfa4f93e489c17d6b313ae9dce60369b8d84a7/winrt_runtime-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:35d6241a2ebd5598e4788e69768b8890ee1eee401a819865767a1fbdd3e9a650", size = 416222, upload-time = "2025-09-20T07:06:43.376Z" },
 ]
 
 [[package]]
@@ -3954,12 +2723,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/ff/c4a3de909a875b46fad5e9f4fd412bba48571405bfa802b878954abf128c/winrt_windows_devices_bluetooth-3.2.1-cp312-cp312-win32.whl", hash = "sha256:18c833ec49e7076127463679e85efc59f61785ade0dc185c852586b21be1f31c", size = 105752, upload-time = "2025-06-06T07:00:10.684Z" },
     { url = "https://files.pythonhosted.org/packages/e7/78/bfee1f0c8d188c561c5b946ab21f6a0037e60dea110e80b1d6a1d529639f/winrt_windows_devices_bluetooth-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:9b6702c462b216c91e32388023a74d0f87210cef6fd5d93b7191e9427ce2faca", size = 113356, upload-time = "2025-06-06T07:00:11.541Z" },
     { url = "https://files.pythonhosted.org/packages/d2/1b/d9da9c29d36cabadef4e19c3e9ba6d2692f6a28224c81fcff757132ea0da/winrt_windows_devices_bluetooth-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:419fd1078c7749119f6b4bbf6be4e586e03a0ed544c03b83178f1d85f1b3d148", size = 104724, upload-time = "2025-06-06T07:00:12.406Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/cc/797516c5c0f8d7f5b680862e0ed7c1087c58aec0bcf57a417fa90f7eb983/winrt_windows_devices_bluetooth-3.2.1-cp313-cp313-win32.whl", hash = "sha256:12b0a16fb36ce0b42243ca81f22a6b53fbb344ed7ea07a6eeec294604f0505e4", size = 105757, upload-time = "2025-06-06T07:00:13.269Z" },
-    { url = "https://files.pythonhosted.org/packages/05/6d/f60588846a065e69a2ec5e67c5f85eb45cb7edef2ee8974cd52fa8504de6/winrt_windows_devices_bluetooth-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6703dfbe444ee22426738830fb305c96a728ea9ccce905acfdf811d81045fdb3", size = 113363, upload-time = "2025-06-06T07:00:14.135Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/13/2d3c4762018b26a9f66879676ea15d7551cdbf339c8e8e0c56ea05ea31ef/winrt_windows_devices_bluetooth-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:2cf8a0bfc9103e32dc7237af15f84be06c791f37711984abdca761f6318bbdb2", size = 104722, upload-time = "2025-06-06T07:00:14.999Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/95/91cfdf941a1ba791708ab3477fc4e46793c8fe9117fc3e0a8c5ac5d7a09c/winrt_windows_devices_bluetooth-3.2.1-cp314-cp314-win32.whl", hash = "sha256:de36ded53ca3ba12fc6dd4deb14b779acc391447726543815df4800348aad63a", size = 109015, upload-time = "2025-09-20T07:09:51.067Z" },
-    { url = "https://files.pythonhosted.org/packages/61/fa/7460655628d0f340a93524f5236bb9f8514eb0e1d334b38cba8a89f6c1a6/winrt_windows_devices_bluetooth-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:3295d932cc93259d5ccb23a41e3a3af4c78ce5d6a6223b2b7638985f604fa34c", size = 115931, upload-time = "2025-09-20T07:09:51.922Z" },
-    { url = "https://files.pythonhosted.org/packages/de/70/e1248dea2ab881eb76b61ff1ad6cb9c07ac005faf99349e4af0b29bc3f1b/winrt_windows_devices_bluetooth-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:1f61c178766a1bbce0669f44790c6161ff4669404c477b4aedaa576348f9e102", size = 109561, upload-time = "2025-09-20T07:09:52.733Z" },
 ]
 
 [[package]]
@@ -3980,12 +2743,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c9/15/ad05c28e049208c97011728e2debdb45439175f75efe357b6faa4c9ba099/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp312-cp312-win32.whl", hash = "sha256:901933cc40de5eb7e5f4188897c899dd0b0f577cb2c13eab1a63c7dfe89b08c4", size = 90033, upload-time = "2025-06-06T07:00:23.421Z" },
     { url = "https://files.pythonhosted.org/packages/26/48/074779081841f6eba4987930c4e7adcec38a5985b7dffd9fecc41f39a89c/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:e6c66e7d4f4ca86d2c801d30efd2b9673247b59a2b4c365d9e11650303d68d89", size = 95824, upload-time = "2025-06-06T07:00:24.238Z" },
     { url = "https://files.pythonhosted.org/packages/aa/25/e01966033a02b2d0718710bb47ef4f6b9b5a619ca2c857e06eb5c8e3ed13/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:447d19defd8982d39944642eb7ebe89e4e20259ec9734116cf88879fb2c514ff", size = 89311, upload-time = "2025-06-06T07:00:25.029Z" },
-    { url = "https://files.pythonhosted.org/packages/34/01/8fc8e57605ea08dd0723c035ed0c2d0435dace2bc80a66d33aecfea49a56/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp313-cp313-win32.whl", hash = "sha256:4122348ea525a914e85615647a0b54ae8b2f42f92cdbf89c5a12eea53ef6ed90", size = 90037, upload-time = "2025-06-06T07:00:25.818Z" },
-    { url = "https://files.pythonhosted.org/packages/86/83/503cf815d84c5ba8c8bc61480f32e55579ebf76630163405f7df39aa297b/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:b66410c04b8dae634a7e4b615c3b7f8adda9c7d4d6902bcad5b253da1a684943", size = 95822, upload-time = "2025-06-06T07:00:26.666Z" },
-    { url = "https://files.pythonhosted.org/packages/32/13/052be8b6642e6f509b30c194312b37bfee8b6b60ac3bd5ca2968c3ea5b80/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:07af19b1d252ddb9dd3eb2965118bc2b7cabff4dda6e499341b765e5038ca61d", size = 89326, upload-time = "2025-06-06T07:00:27.477Z" },
-    { url = "https://files.pythonhosted.org/packages/27/3d/421d04a20037370baf13de929bc1dc5438b306a76fe17275ec5d893aae6c/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp314-cp314-win32.whl", hash = "sha256:2985565c265b3f9eab625361b0e40e88c94b03d89f5171f36146f2e88b3ee214", size = 92264, upload-time = "2025-09-20T07:09:53.563Z" },
-    { url = "https://files.pythonhosted.org/packages/07/c7/43601ab82fe42bcff430b8466d84d92b31be06cc45c7fd64e9aac40f7851/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:d102f3fac64fde32332e370969dfbc6f37b405d8cc055d9da30d14d07449a3c2", size = 97517, upload-time = "2025-09-20T07:09:54.411Z" },
-    { url = "https://files.pythonhosted.org/packages/91/17/e3303f6a25a2d98e424b06580fc85bbfd068f383424c67fa47cb1b357a46/winrt_windows_devices_bluetooth_advertisement-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:ffeb5e946cd42c32c6999a62e240d6730c653cdfb7b49c7839afba375e20a62a", size = 94122, upload-time = "2025-09-20T07:09:55.187Z" },
 ]
 
 [[package]]
@@ -4006,12 +2763,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/9c/a1/75ac783a5faee9b455fef2f53b7fef97b21ed60d52401b44c690202141e4/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp312-cp312-win32.whl", hash = "sha256:ef894d21e0a805f3e114940254636a8045335fa9de766c7022af5d127dfad557", size = 183326, upload-time = "2025-06-06T07:00:52.662Z" },
     { url = "https://files.pythonhosted.org/packages/7a/d9/a9dcc15322d2f5c7dfd491bd7ab121e36437caf78ebfa92bc0dd0546e2ca/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:db05de95cd1b24a51abb69cb936a8b17e9214e015757d0b37e3a5e207ddceb3d", size = 187810, upload-time = "2025-06-06T07:00:53.594Z" },
     { url = "https://files.pythonhosted.org/packages/d2/fc/47d00af076f558267097af3050910beda6bf8a21ceaa5830bbd26fcaf85e/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:8d4e131cf3d15fc5ad81c1bcde3509ac171298217381abed6bdf687f29871984", size = 184516, upload-time = "2025-06-06T07:00:55.24Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/93/30b45ce473d1a604908221a1fa035fe8d5e4bb9008e820ae671a21dab94c/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp313-cp313-win32.whl", hash = "sha256:b1879c8dcf46bd2110b9ad4b0b185f4e2a5f95170d014539203a5fee2b2115f0", size = 183342, upload-time = "2025-06-06T07:00:56.16Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/3b/eb9d99b82a36002d7885206d00ea34f4a23db69c16c94816434ded728fa3/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d8d89f01e9b6931fb48217847caac3227a0aeb38a5b7782af71c2e7b262ec30", size = 187844, upload-time = "2025-06-06T07:00:57.134Z" },
-    { url = "https://files.pythonhosted.org/packages/84/9b/ebbbe9be9a3e640dcfc5f166eb48f2f9d8ce42553f83aa9f4c5dcd9eb5f5/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:4e71207bb89798016b1795bb15daf78afe45529f2939b3b9e78894cfe650b383", size = 184540, upload-time = "2025-06-06T07:00:58.081Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/32/cb447ca7730a1e05730272309b074da6a04af29a8c0f5121014db8a2fc02/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp314-cp314-win32.whl", hash = "sha256:d5f83739ca370f0baf52b0400aebd6240ab80150081fbfba60fd6e7b2e7b4c5f", size = 185249, upload-time = "2025-09-20T07:09:58.639Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/fa/f465d5d44dda166bf7ec64b7a950f57eca61f165bfe18345e9a5ea542def/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:13786a5853a933de140d456cd818696e1121c7c296ae7b7af262fc5d2cffb851", size = 193739, upload-time = "2025-09-20T07:09:59.893Z" },
-    { url = "https://files.pythonhosted.org/packages/78/08/51c53ac3c704cd92da5ed7e7b9b57159052f6e46744e4f7e447ed708aa22/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:5140682da2860f6a55eb6faf9e980724dc457c2e4b4b35a10e1cebd8fc97d892", size = 194836, upload-time = "2025-09-20T07:10:00.87Z" },
 ]
 
 [[package]]
@@ -4032,12 +2783,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/31/3e/81642208ecd6c6c936f35a39a433c54e3f68e09d316546b8f953581ae334/winrt_windows_devices_enumeration-3.2.1-cp312-cp312-win32.whl", hash = "sha256:1db22b0292b93b0688d11ad932ad1f3629d4f471310281a2fbfe187530c2c1f3", size = 130249, upload-time = "2025-06-06T07:02:02.237Z" },
     { url = "https://files.pythonhosted.org/packages/00/f4/a9ede5f3f0d86abfc7590726cf711133d97419b49ced372fca532e4f0696/winrt_windows_devices_enumeration-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:a73bc88d7f510af454f2b392985501c96f39b89fd987140708ccaec1588ceebc", size = 141512, upload-time = "2025-06-06T07:02:03.424Z" },
     { url = "https://files.pythonhosted.org/packages/31/ef/4fad07c03124bdc3acd64f80f3bd3cc4417ea641e07bb16a9503afd3e554/winrt_windows_devices_enumeration-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:2853d687803f0dd76ae1afe3648abc0453e09dff0e7eddbb84b792eddb0473ca", size = 135383, upload-time = "2025-06-06T07:02:04.312Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/7d/ebd712ab8ccd599c593796fbcd606abe22b5a8e20db134aa87987d67ac0e/winrt_windows_devices_enumeration-3.2.1-cp313-cp313-win32.whl", hash = "sha256:14a71cdcc84f624c209cbb846ed6bd9767a9a9437b2bf26b48ac9a91599da6e9", size = 130276, upload-time = "2025-06-06T07:02:05.178Z" },
-    { url = "https://files.pythonhosted.org/packages/70/de/f30daaaa0e6f4edb6bd7ddb3e058bd453c9ad90c032a4545c4d4639338aa/winrt_windows_devices_enumeration-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6ca40d334734829e178ad46375275c4f7b5d6d2d4fc2e8879690452cbfb36015", size = 141536, upload-time = "2025-06-06T07:02:06.067Z" },
-    { url = "https://files.pythonhosted.org/packages/75/4b/9a6aafdc74a085c550641a325be463bf4b811f6f605766c9cd4f4b5c19d2/winrt_windows_devices_enumeration-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:2d14d187f43e4409c7814b7d1693c03a270e77489b710d92fcbbaeca5de260d4", size = 135362, upload-time = "2025-06-06T07:02:06.997Z" },
-    { url = "https://files.pythonhosted.org/packages/41/31/5785cd1ec54dc0f0e6f3e6a466d07a62b8014a6e2b782e80444ef87e83ab/winrt_windows_devices_enumeration-3.2.1-cp314-cp314-win32.whl", hash = "sha256:e087364273ed7c717cd0191fed4be9def6fdf229fe9b536a4b8d0228f7814106", size = 134252, upload-time = "2025-09-20T07:10:12.935Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/f6/68d91068048410f49794c0b19c45759c63ca559607068cfe5affba2f211b/winrt_windows_devices_enumeration-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:0da1ddb8285d97a6775c36265d7157acf1bbcb88bcc9a7ce9a4549906c822472", size = 145509, upload-time = "2025-09-20T07:10:13.797Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/a4/898951d5bfc474aa9c7d133fe30870f0f2184f4ba3027eafb779d30eb7bc/winrt_windows_devices_enumeration-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:09bf07e74e897e97a49a9275d0a647819254ddb74142806bbbcf4777ed240a22", size = 141334, upload-time = "2025-09-20T07:10:14.637Z" },
 ]
 
 [[package]]
@@ -4058,12 +2803,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a5/e0/4731a3c412318b2c5e74a8803a32e2fb9afc2c98368c6b61a422eb359e7e/winrt_windows_devices_radios-3.2.1-cp312-cp312-win32.whl", hash = "sha256:c3e683ce682338a5a5ed465f735e223ba7a22f16d0bbea2d070962bc7657edbb", size = 38606, upload-time = "2025-06-06T07:08:01.477Z" },
     { url = "https://files.pythonhosted.org/packages/37/8e/91464854dfc9e0be9ce8dcbe2bd6a67c19b68ab91584fc5de0f4f13e78f8/winrt_windows_devices_radios-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:a116e552a3f38607b9be558fb2e7de9b4450d1f9080069944d74d80cdda1873e", size = 40172, upload-time = "2025-06-06T07:08:02.214Z" },
     { url = "https://files.pythonhosted.org/packages/c3/0d/1bd62f606b6c4dfa936fccc4712be5506a40fc5d1b7177c3d3cbcaf30972/winrt_windows_devices_radios-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:4c28822f9251c9d547324f596b5c2581f050254ded05e5b786c650a3502744c1", size = 36989, upload-time = "2025-06-06T07:08:03.295Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/94/c22a14fd424632f3f3c0b25672218db9e8f4ae9e1355e0b148f2fe6015b5/winrt_windows_devices_radios-3.2.1-cp313-cp313-win32.whl", hash = "sha256:ae4a0065927fcd2d10215223f8a46be6fb89bad71cb4edd25dae3d01c137b3a8", size = 38613, upload-time = "2025-06-06T07:08:04.077Z" },
-    { url = "https://files.pythonhosted.org/packages/39/c1/24cec0cc228642554b48d436a7617d7162fb952919c55fc26e2d99c310bd/winrt_windows_devices_radios-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:bf1a975f46a2aa271ffea1340be0c7e64985050d07433e701343dddc22a72290", size = 40180, upload-time = "2025-06-06T07:08:04.849Z" },
-    { url = "https://files.pythonhosted.org/packages/ca/d3/776453af26e78c0d0c0e1bfa89f86fd81322872f31a3e5dafb344dd47bf2/winrt_windows_devices_radios-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:10b298ed154c5824cea2de174afce1694ed2aabfb58826de814074027ffef96f", size = 36989, upload-time = "2025-06-06T07:08:05.576Z" },
-    { url = "https://files.pythonhosted.org/packages/76/79/4627afae6b389ddd1e5f1d691663c6b14d6c8f98959082aed1217cc57ef9/winrt_windows_devices_radios-3.2.1-cp314-cp314-win32.whl", hash = "sha256:21452e1cae50e44cd1d5e78159e1b9986ac3389b66458ad89caa196ce5eca2d6", size = 39521, upload-time = "2025-09-20T07:11:17.992Z" },
-    { url = "https://files.pythonhosted.org/packages/a7/7c/c6aea91908ee7279ed51d12157bc8aeecb8850af2441073c3c91b261ad31/winrt_windows_devices_radios-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:6a8413e586fe597c6849607885cca7e0549da33ae5699165d11f7911534c6eaf", size = 41121, upload-time = "2025-09-20T07:11:18.747Z" },
-    { url = "https://files.pythonhosted.org/packages/86/c5/652f14e3c501452ad8e0723518d9bbd729219b47f4a4dbe2966c2f82dca8/winrt_windows_devices_radios-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:39129fd9d09103adb003575f59881c1a5a70a43310547850150b46c6f4020312", size = 38114, upload-time = "2025-09-20T07:11:19.599Z" },
 ]
 
 [[package]]
@@ -4084,12 +2823,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f3/f8/495e304ddedd5ff2f196efbde906265cb75ade4d79e2937837f72ef654a0/winrt_windows_foundation-3.2.1-cp312-cp312-win32.whl", hash = "sha256:867642ccf629611733db482c4288e17b7919f743a5873450efb6d69ae09fdc2b", size = 112169, upload-time = "2025-06-06T07:11:01.438Z" },
     { url = "https://files.pythonhosted.org/packages/9b/5e/b5059e4ece095351c496c9499783130c302d25e353c18031d5231b1b3b3c/winrt_windows_foundation-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:45550c5b6c2125cde495c409633e6b1ea5aa1677724e3b95eb8140bfccbe30c9", size = 118668, upload-time = "2025-06-06T07:11:02.475Z" },
     { url = "https://files.pythonhosted.org/packages/a5/70/acbcb3ef07b1b67e2de4afab9176a5282cfd775afd073efe6828dfc65ace/winrt_windows_foundation-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:94f4661d71cb35ebc52be7af112f2eeabdfa02cb05e0243bf9d6bd2cafaa6f37", size = 109671, upload-time = "2025-06-06T07:11:03.538Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/71/5e87131e4aecc8546c76b9e190bfe4e1292d028bda3f9dd03b005d19c76c/winrt_windows_foundation-3.2.1-cp313-cp313-win32.whl", hash = "sha256:3998dc58ed50ecbdbabace1cdef3a12920b725e32a5806d648ad3f4829d5ba46", size = 112184, upload-time = "2025-06-06T07:11:04.459Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/7f/8d5108461351d4f6017f550af8874e90c14007f9122fa2eab9f9e0e9b4e1/winrt_windows_foundation-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:6e98617c1e46665c7a56ce3f5d28e252798416d1ebfee3201267a644a4e3c479", size = 118672, upload-time = "2025-06-06T07:11:05.55Z" },
-    { url = "https://files.pythonhosted.org/packages/44/f5/2edf70922a3d03500dab17121b90d368979bd30016f6dbca0d043f0c71f1/winrt_windows_foundation-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:2a8c1204db5c352f6a563130a5a41d25b887aff7897bb677d4ff0b660315aad4", size = 109673, upload-time = "2025-06-06T07:11:06.398Z" },
-    { url = "https://files.pythonhosted.org/packages/e3/0a/d77346e39fe0c81f718cde49f83fe77c368c0e14c6418f72dfa1e7ef22d0/winrt_windows_foundation-3.2.1-cp314-cp314-win32.whl", hash = "sha256:35e973ab3c77c2a943e139302256c040e017fd6ff1a75911c102964603bba1da", size = 114590, upload-time = "2025-09-20T07:11:49.97Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/56/4d2b545bea0f34f68df6d4d4ca22950ff8a935497811dccdc0ca58737a05/winrt_windows_foundation-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:a22a7ebcec0d262e60119cff728f32962a02df60471ded8b2735a655eccc0ef5", size = 122148, upload-time = "2025-09-20T07:11:50.826Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/ed/b9d3a11cac73444c0a3703200161cd7267dab5ab85fd00e1f965526e74a8/winrt_windows_foundation-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:3be7fbae829b98a6a946db4fbaf356b11db1fbcbb5d4f37e7a73ac6b25de8b87", size = 114360, upload-time = "2025-09-20T07:11:51.626Z" },
 ]
 
 [[package]]
@@ -4110,12 +2843,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1d/0b/7802349391466d3f7e8f62f588f36a1a0b6560abfcdbdaa426fe21d322b4/winrt_windows_foundation_collections-3.2.1-cp312-cp312-win32.whl", hash = "sha256:15704eef3125788f846f269cf54a3d89656fa09a1dc8428b70871f717d595ad6", size = 60060, upload-time = "2025-06-06T07:11:16.173Z" },
     { url = "https://files.pythonhosted.org/packages/37/94/5b888713e472746635a382e523513ab1b8200af55c5b56bc70e1e4369115/winrt_windows_foundation_collections-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:550dfb8c82fe74d9e0728a2a16a9175cc9e34ca2b8ef758d69b2a398894b698b", size = 69058, upload-time = "2025-06-06T07:11:17.009Z" },
     { url = "https://files.pythonhosted.org/packages/5f/3c/829273622c9b37c67b97f187b92be318404f7d33db045e31d72b7d50f54c/winrt_windows_foundation_collections-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:810ad4bd11ab4a74fdbcd3ed33b597ef7c0b03af73fc9d7986c22bcf3bd24f84", size = 58793, upload-time = "2025-06-06T07:11:17.837Z" },
-    { url = "https://files.pythonhosted.org/packages/a6/cd/99ef050d80bea2922fa1ded93e5c250732634095d8bd3595dd808083e5ca/winrt_windows_foundation_collections-3.2.1-cp313-cp313-win32.whl", hash = "sha256:4267a711b63476d36d39227883aeb3fb19ac92b88a9fc9973e66fbce1fd4aed9", size = 60063, upload-time = "2025-06-06T07:11:18.65Z" },
-    { url = "https://files.pythonhosted.org/packages/94/93/4f75fd6a4c96f1e9bee198c5dc9a9b57e87a9c38117e1b5e423401886353/winrt_windows_foundation_collections-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:5e12a6e75036ee90484c33e204b85fb6785fcc9e7c8066ad65097301f48cdd10", size = 69057, upload-time = "2025-06-06T07:11:19.446Z" },
-    { url = "https://files.pythonhosted.org/packages/40/76/de47ccc390017ec5575e7e7fd9f659ee3747c52049cdb2969b1b538ce947/winrt_windows_foundation_collections-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:34b556255562f1b36d07fba933c2bcd9f0db167fa96727a6cbb4717b152ad7a2", size = 58792, upload-time = "2025-06-06T07:11:20.24Z" },
-    { url = "https://files.pythonhosted.org/packages/e1/47/b3301d964422d4611c181348149a7c5956a2a76e6339de451a000d4ae8e7/winrt_windows_foundation_collections-3.2.1-cp314-cp314-win32.whl", hash = "sha256:33188ed2d63e844c8adfbb82d1d3d461d64aaf78d225ce9c5930421b413c45ab", size = 62211, upload-time = "2025-09-20T07:11:52.411Z" },
-    { url = "https://files.pythonhosted.org/packages/20/59/5f2c940ff606297129e93ebd6030c813e6a43a786de7fc33ccb268e0b06b/winrt_windows_foundation_collections-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:d4cfece7e9c0ead2941e55a1da82f20d2b9c8003bb7a8853bb7f999b539f80a4", size = 70399, upload-time = "2025-09-20T07:11:53.254Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/2d/2c8eb89062c71d4be73d618457ed68e7e2ba29a660ac26349d44fc121cbf/winrt_windows_foundation_collections-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:3884146fea13727510458f6a14040b7632d5d90127028b9bfd503c6c655d0c01", size = 61392, upload-time = "2025-09-20T07:11:53.993Z" },
 ]
 
 [[package]]
@@ -4136,12 +2863,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/87/e7/7d3f2a4a442f264e05cab2bdf20ed1b95cb3f753bd1b0f277f2b49fb8335/winrt_windows_storage_streams-3.2.1-cp312-cp312-win32.whl", hash = "sha256:77c1f0e004b84347b5bd705e8f0fc63be8cd29a6093be13f1d0869d0d97b7d78", size = 127787, upload-time = "2025-06-06T14:02:02.277Z" },
     { url = "https://files.pythonhosted.org/packages/c6/2f/cc36f475f8af293f40e2c2a5d6c2e75a189c2c2d4d01ecb3551578518c79/winrt_windows_storage_streams-3.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:e4508ee135af53e4fc142876abbf4bc7c2a95edfc7d19f52b291a8499cacd6dc", size = 131849, upload-time = "2025-06-06T14:02:03.09Z" },
     { url = "https://files.pythonhosted.org/packages/94/84/896fb734f7456910ec412f3f3adfdc3f0dc3134864a496d5b120592f3bfd/winrt_windows_storage_streams-3.2.1-cp312-cp312-win_arm64.whl", hash = "sha256:040cb94e6fb26b0d00a00e8b88b06fadf29dfe18cf24ed6cb3e69709c3613307", size = 128144, upload-time = "2025-06-06T14:02:03.946Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/d2/24d9f59bdc05e741261d5bec3bcea9a848d57714126a263df840e2b515a8/winrt_windows_storage_streams-3.2.1-cp313-cp313-win32.whl", hash = "sha256:401bb44371720dc43bd1e78662615a2124372e7d5d9d65dfa8f77877bbcb8163", size = 127774, upload-time = "2025-06-06T14:02:04.752Z" },
-    { url = "https://files.pythonhosted.org/packages/15/59/601724453b885265c7779d5f8025b043a68447cbc64ceb9149d674d5b724/winrt_windows_storage_streams-3.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:202c5875606398b8bfaa2a290831458bb55f2196a39c1d4e5fa88a03d65ef915", size = 131827, upload-time = "2025-06-06T14:02:05.601Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/c2/a419675a6087c9ea496968c9b7805ef234afa585b7483e2269608a12b044/winrt_windows_storage_streams-3.2.1-cp313-cp313-win_arm64.whl", hash = "sha256:ca3c5ec0aab60895006bf61053a1aca6418bc7f9a27a34791ba3443b789d230d", size = 128180, upload-time = "2025-06-06T14:02:06.759Z" },
-    { url = "https://files.pythonhosted.org/packages/55/70/2869ea2112c565caace73c9301afd1d7afcc49bdd37fac058f0178ba95d4/winrt_windows_storage_streams-3.2.1-cp314-cp314-win32.whl", hash = "sha256:5cd0dbad86fcc860366f6515fce97177b7eaa7069da261057be4813819ba37ee", size = 131701, upload-time = "2025-09-20T07:17:16.849Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/3d/aae50b1d0e37b5a61055759aedd42c6c99d7c17ab8c3e568ab33c0288938/winrt_windows_storage_streams-3.2.1-cp314-cp314-win_amd64.whl", hash = "sha256:3c5bf41d725369b9986e6d64bad7079372b95c329897d684f955d7028c7f27a0", size = 135566, upload-time = "2025-09-20T07:17:17.69Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/c3/6d3ce7a58e6c828e0795c9db8790d0593dd7fdf296e513c999150deb98d4/winrt_windows_storage_streams-3.2.1-cp314-cp314-win_arm64.whl", hash = "sha256:293e09825559d0929bbe5de01e1e115f7a6283d8996ab55652e5af365f032987", size = 134393, upload-time = "2025-09-20T07:17:18.802Z" },
 ]
 
 [[package]]
@@ -4206,56 +2927,5 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/48/2d/1c8d89c7c5f9cad9fb2902445d94e2ab1d7aa35de029afbb8ae95c42d00f/yarl-1.24.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e30dd55825dc554ec5b66a94953b8eda8745926514c5089dfcacecb9c99b5bd1", size = 105719, upload-time = "2026-05-19T21:29:18.367Z" },
     { url = "https://files.pythonhosted.org/packages/a7/25/722e3b93bd687009afb2d59a35e13d30ddd8f80571445bb0c4e4ce26ec66/yarl-1.24.2-cp312-cp312-win_amd64.whl", hash = "sha256:7dafe10c12ddd4d120d528c4b5599c953bd7b12845347d507b95451195bb6cad", size = 92901, upload-time = "2026-05-19T21:29:20.014Z" },
     { url = "https://files.pythonhosted.org/packages/39/47/4486ccfb674c04854a1ef8aa77868b6a6f765feaf69633409d7ca4f02cb8/yarl-1.24.2-cp312-cp312-win_arm64.whl", hash = "sha256:044a09d8401fcf8681977faef6d286b8ade1e2d2e9dceda175d1cfa5ca496f30", size = 87229, upload-time = "2026-05-19T21:29:22.1Z" },
-    { url = "https://files.pythonhosted.org/packages/82/62/fcf0ce677f17e5c471c06311dd25964be38a4c586993632910d2e75278bc/yarl-1.24.2-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:491ac9141decf49ee8030199e1ee251cdff0e131f25678817ff6aa5f837a3536", size = 128978, upload-time = "2026-05-19T21:29:23.83Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/58/8e63299bb71ed61a834121d9d3fe6c9fcf2a6a5d09754ff4f20f2d20baf5/yarl-1.24.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e89418f65eda18f99030386305bd44d7d504e328a7945db1ead514fbe03a0607", size = 91733, upload-time = "2026-05-19T21:29:25.375Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/24/16748d5dab6daec8b0ed81ccec639a1cded0f18dcc62a4f696b4fe366c37/yarl-1.24.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:cdfcce633b4a4bb8281913c57fcafd4b5933fbc19111a5e3930bbd299d6102f1", size = 91113, upload-time = "2026-05-19T21:29:26.928Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/66/b63fff7b71211e866624b21432d5943cbb633eb0c2872d9ee3070648f22c/yarl-1.24.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:863297ddede92ee49024e9a9b11ecb59f310ca85b60d8537f56bed9bbb5b1986", size = 103899, upload-time = "2026-05-19T21:29:28.842Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/ac/ba1974b8533909636f7733fe86cf677e3619527c3c2fa913e0ea89c48757/yarl-1.24.2-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:374423f70754a2c96942ede36a29d37dc6b0cb8f92f8d009ddf3ed78d3da5488", size = 97862, upload-time = "2026-05-19T21:29:31.086Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/a5/123ac993b5c2ba6f554a140305620cb8f150fa543711bbc49be3ec0a65a4/yarl-1.24.2-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:33a29b5d00ccbf3219bb3e351d7875739c19481e030779f48cc46a7a71681a9b", size = 111060, upload-time = "2026-05-19T21:29:32.657Z" },
-    { url = "https://files.pythonhosted.org/packages/23/37/c472d3af3509688392134a88a825276770a187f1daa4de3f6dc0a327a751/yarl-1.24.2-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a9532c57211730c515341af11fef6e9b61d157487272a096d0c04da445642592", size = 110613, upload-time = "2026-05-19T21:29:34.379Z" },
-    { url = "https://files.pythonhosted.org/packages/df/88/09c28dad91e662ccfaa1b78f1c57badde74fc9d0b23e74aef644750ecd73/yarl-1.24.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:91e72cf093fd833483a97ee648e0c053c7c629f51ff4a0e7edd84f806b0c5617", size = 107012, upload-time = "2026-05-19T21:29:36.216Z" },
-    { url = "https://files.pythonhosted.org/packages/07/ab/9d4f69d571a94f4d112fa7e2e007200f5a54d319f58c82ac7b7baa61f5c6/yarl-1.24.2-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b3177bc0a768ef3bacceb4f272632990b7bea352f1b2f1eee9d6d6ff16516f92", size = 105887, upload-time = "2026-05-19T21:29:38.746Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/9a/000b2b66c0d772a499fc531d21dab92dfeb73b640a12eed6ba89f49bb2d0/yarl-1.24.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e196952aacaf3b232e265ff02980b64d483dc0972bd49bcb061171ff22ac203a", size = 103620, upload-time = "2026-05-19T21:29:40.368Z" },
-    { url = "https://files.pythonhosted.org/packages/41/7c/7c1050f73450fbdaa3f0c72017059f00ce5e13366692f3dba25275a1083d/yarl-1.24.2-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:204e7a61ce99919c0de1bf904ab5d7aa188a129ea8f690a8f76cfb6e2844dc44", size = 100599, upload-time = "2026-05-19T21:29:42.66Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/b1/29e5756b3926705f5f6089bd5b9f50a56eaac550da6e260bf713ead44d04/yarl-1.24.2-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:4b156914620f0b9d78dc1adb3751141daee561cfec796088abb89ed49d220f1a", size = 110604, upload-time = "2026-05-19T21:29:44.632Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/4b/8415bc96e9b150cde942fbac9a8182985e58f40ce5c54c34ed015407d3ee/yarl-1.24.2-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:8372a2b976cf70654b2be6619ab6068acabb35f724c0fda7b277fbf53d66a5cf", size = 105161, upload-time = "2026-05-19T21:29:46.755Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/d4/cde059abfa229553b7298a2eadde2752e723d50aeedaef86ce59da2718ee/yarl-1.24.2-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:f9a1e9b622ca284143aab5d885848686dcd85453bb1ca9abcdb7503e64dc0056", size = 110619, upload-time = "2026-05-19T21:29:48.972Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/2c/d6a6c9a61549f7b6c7e6dc6937d195bcf069582b47b7200dcd0e7b256acf/yarl-1.24.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:810e19b685c8c3c5862f6a38160a1f4e4c0916c9390024ec347b6157a45a0992", size = 107362, upload-time = "2026-05-19T21:29:51Z" },
-    { url = "https://files.pythonhosted.org/packages/92/dd/3ae5fe417e9d1c353a548553326eb9935e76b6b727161563b424cc296df3/yarl-1.24.2-cp313-cp313-win_amd64.whl", hash = "sha256:7d37fb7c38f2b6edab0f845c4f85148d4c44204f52bc127021bd2bc9fdbf1656", size = 92667, upload-time = "2026-05-19T21:29:52.743Z" },
-    { url = "https://files.pythonhosted.org/packages/10/cc/a7beb239f78f27fca1b053c8e8595e4179c02e62249b4687ec218c370c50/yarl-1.24.2-cp313-cp313-win_arm64.whl", hash = "sha256:1e831894be7c2954240e49791fa4b50c05a0dc881de2552cfe3ffd8631c7f461", size = 87069, upload-time = "2026-05-19T21:29:54.442Z" },
-    { url = "https://files.pythonhosted.org/packages/40/0e/e08087695fc12789263821c5dc0f8dc52b5b17efd0887cacf419f8a43ba3/yarl-1.24.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:f9312b3c02d9b3d23840f67952913c9c8721d7f1b7db305289faefa878f364c2", size = 129670, upload-time = "2026-05-19T21:29:56.631Z" },
-    { url = "https://files.pythonhosted.org/packages/3a/98/ab4b5ed1b1b5cd973c8a3eb994c3a6aefb6ce6d399e21bb5f0316c33815c/yarl-1.24.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:a4f4d6cd615823bfc7fb7e9b5987c3f41666371d870d51058f77e2680fbe9630", size = 91916, upload-time = "2026-05-19T21:29:58.645Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/b1/5297bb6a7df4782f7605bffc43b31f5044070935fbbcaa6c705a07e6ac65/yarl-1.24.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0c3063e5c0a8e8e62fae6c2596fa01da1561e4cd1da6fec5789f5cf99a8aefd8", size = 91625, upload-time = "2026-05-19T21:30:00.412Z" },
-    { url = "https://files.pythonhosted.org/packages/02/a7/45baabfff76829264e623b185cff0c340d7e11bf3e1cd9ea37e7d17934bd/yarl-1.24.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fecd17873a096036c1c87ab3486f1aef7f269ada7f23f7f856f93b1cc7744f14", size = 104574, upload-time = "2026-05-19T21:30:02.544Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/40/3a5ab144d3d650ca37d4f4b57e56169be8af3ca34c448793e064b30baaed/yarl-1.24.2-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a46d1ab4ba4d32e6dc80daf8a28ce0bd83d08df52fbc32f3e288663427734535", size = 97534, upload-time = "2026-05-19T21:30:04.319Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/b5/5658fef3681fb5776b4513b052bec750009f47b3a592251c705d75375798/yarl-1.24.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:73e68edf6dfd5f73f9ca127d84e2a6f9213c65bdffb736bda19524c0564fcd14", size = 111481, upload-time = "2026-05-19T21:30:05.988Z" },
-    { url = "https://files.pythonhosted.org/packages/4c/06/fdcd7dde037f00866dce123ed4ba23dba94beb56fc4cf561668d27be37f2/yarl-1.24.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a296ca617f2d25fbceafb962b88750d627e5984e75732c712154d058ae8d79a3", size = 111529, upload-time = "2026-05-19T21:30:07.738Z" },
-    { url = "https://files.pythonhosted.org/packages/c2/53/d81269aaafccea0d33396c03035de997b743f11e648e6e27a0df99c72980/yarl-1.24.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e51b2cf5ec89a8b8470177641ed62a3ba22d74e1e898e06ad53aa77972487208", size = 107338, upload-time = "2026-05-19T21:30:09.713Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/04/23049463f729bd899df203a7960505a75333edd499cda8aa1d5a82b64df5/yarl-1.24.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:310fc687f7b2044ec54e372c8cbe923bb88f5c37bded0d3079e5791c2fc3cf50", size = 106147, upload-time = "2026-05-19T21:30:11.365Z" },
-    { url = "https://files.pythonhosted.org/packages/14/18/04a4b5830b43ed5e4c5015b40e9f6241ad91487d71611061b4e111d6ac80/yarl-1.24.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:297a2fe352ecf858b30a98f87948746ec16f001d279f84aebdbd3bd965e2f1bd", size = 104272, upload-time = "2026-05-19T21:30:12.978Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/f7/8cffdf319aee7a7c1dbd07b61d91c3e3fda460c7a93b5f93e445f3806c4c/yarl-1.24.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:2a263e76b97bc42bdcd7c5f4953dec1f7cd62a1112fa7f869e57255229390d67", size = 99962, upload-time = "2026-05-19T21:30:15.001Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/39/b3cce3b7dbef64ac700ad4cea156a207d01bede0f507587616c364b5468e/yarl-1.24.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:822519b64cf0b474f1a0aaef1dc621438ea46bb77c94df97a5b4d213a7d8a8b1", size = 111063, upload-time = "2026-05-19T21:30:16.683Z" },
-    { url = "https://files.pythonhosted.org/packages/a1/ea/100818505e7ebf165c7242ff17fdf7d9fee79e27234aeca871c1082920d7/yarl-1.24.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:b6067060d9dc594899ba83e6db6c48c68d1e494a6dab158156ed86977ca7bcb1", size = 105438, upload-time = "2026-05-19T21:30:18.769Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/d2/e075a0b32aa6625087de9e653087df0759fed5de4a435fef594181102a77/yarl-1.24.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:0063adad533e57171b79db3943b229d40dfafeeee579767f96541f106bac5f1b", size = 111458, upload-time = "2026-05-19T21:30:21.024Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/5c/ceea7ba98b65c8eb8d947fdc52f9bedfcd43c6a57c9e3c90c17be8f324a3/yarl-1.24.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ee8e3fb34513e8dc082b586ef4910c98335d43a6fab688cd44d4851bacfce3e8", size = 107589, upload-time = "2026-05-19T21:30:23.412Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/d9/5582d57e2b2db9b85eb6663a22efdd78e08805f3f5389566e9fcad254d1b/yarl-1.24.2-cp314-cp314-win_amd64.whl", hash = "sha256:afb00d7fd8e0f285ca29a44cc50df2d622ff2f7a6d933fa641577b5f9d5f3db0", size = 94424, upload-time = "2026-05-19T21:30:25.425Z" },
-    { url = "https://files.pythonhosted.org/packages/92/10/7dc07a0e22806a9280f42a57361395506e800c64e22737cd7b0886feab42/yarl-1.24.2-cp314-cp314-win_arm64.whl", hash = "sha256:68cf6eacd6028ef1142bc4b48376b81566385ca6f9e7dde3b0fa91be08ffcb57", size = 88690, upload-time = "2026-05-19T21:30:27.623Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/13/d5b8e2c8667db955bcb3de233f18798fefe7edf1d7429c2c9d4f9c401114/yarl-1.24.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:221ce1dd921ac4f603957f17d7c18c5cc0797fbb52f156941f92e04605d1d67b", size = 136248, upload-time = "2026-05-19T21:30:29.297Z" },
-    { url = "https://files.pythonhosted.org/packages/de/46/a4a97c05c9c9b8fd266bb2a0df12992c7fbd02391eb9640583411b6dab32/yarl-1.24.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:5f3224db28173a00d7afacdee07045cc4673dfab2b15492c7ae10deddbece761", size = 95084, upload-time = "2026-05-19T21:30:31.031Z" },
-    { url = "https://files.pythonhosted.org/packages/95/b2/845cf2074a015e6fe0d0808cf1a2d9e868386c4220d657ebd8302b199043/yarl-1.24.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c557165320d6244ebe3a02431b2a201a20080e02f41f0cfa0ccc47a183765da8", size = 95272, upload-time = "2026-05-19T21:30:33.062Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/16/e69d4aa244aef45235ddfebc0e04036a6829842bc5a6a795aedc6c998d23/yarl-1.24.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:904065e6e85b1fa54d0d87438bd58c14c0bad97aad654ad1077fd9d87e8478ed", size = 101497, upload-time = "2026-05-19T21:30:34.842Z" },
-    { url = "https://files.pythonhosted.org/packages/15/94/c07107715d621076863ee88b3ddf183fa5e9d4aba5769623c9979828410a/yarl-1.24.2-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:8cec2a38d70edc10e0e856ceda886af5327a017ccbde8e1de1bd44d300357543", size = 94002, upload-time = "2026-05-19T21:30:37.724Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/35/fc1bbdd895b5e4010b8fdd037f7ed3aa289d3863e08231b30231ca9a0815/yarl-1.24.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e7484b9361ed222ee1ca5b4337aa4cbdcc4618ce5aff57d9ef1582fd95893fc0", size = 106524, upload-time = "2026-05-19T21:30:40.196Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/f2/32b66d0a4ba47c296cf86d03e2c67bff58399fe6d6d84d5205c04c66cc6d/yarl-1.24.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:84f9670b89f34db07f81e53aee83e0b938a3412329d51c8f922488be7fcc4024", size = 106165, upload-time = "2026-05-19T21:30:41.888Z" },
-    { url = "https://files.pythonhosted.org/packages/95/47/37cb5ff50c5e825d4d38e81bb04d1b7e96bf960f7ab89f9850b162f3f114/yarl-1.24.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:abb2759733d63a28b4956500a5dd57140f26486c92b2caedfb964ab7d9b79dbf", size = 103010, upload-time = "2026-05-19T21:30:43.985Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/d2/4597912315096f7bb359e46e13bf8b60994fcbb2db29b804c0902ef4eff5/yarl-1.24.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:081c2bf54efe03774d0311172bc04fedf9ca01e644d4cd8c805688e527209bdc", size = 101128, upload-time = "2026-05-19T21:30:46.291Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/d5/c8e86e120521e646013d02a8e3b8884392e28494be8f392366e50d208efc/yarl-1.24.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:86746bef442aa479107fe28132e1277237f9c24c2f00b0b0cf22b3ee0904f2bb", size = 101382, upload-time = "2026-05-19T21:30:48.085Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/98/70b229236118f89dbeb739b76f10225bbf53b5497725502594c9a01d699a/yarl-1.24.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:2d07d21d0bc4b17558e8de0b02fbfdf1e347d3bb3699edd00bb92e7c57925420", size = 95964, upload-time = "2026-05-19T21:30:49.785Z" },
-    { url = "https://files.pythonhosted.org/packages/87/f8/56c386981e3c8648d279fdef2397ffec577e8320fd5649745e34d54faeb7/yarl-1.24.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:4fb1ac3fc5fecd8ae7453ea237e4d22b49befa70266dfe1629924245c21a0c7f", size = 106204, upload-time = "2026-05-19T21:30:51.862Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/1e/765afe97811ca35933e2a7de70ac57b1997ea2e4ee895719ee7a231fb7e5/yarl-1.24.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:4da31a5512ed1729ca8d8aacde3f7faeb8843cde3165d6bcf7f88f74f17bb8aa", size = 101510, upload-time = "2026-05-19T21:30:53.62Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/78/393913f4b9039e1edd09ae8a9bbb9d539be909a8abf6d8a2084585bed4b7/yarl-1.24.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:533ded4dceb5f1f3da7906244f4e82cf46cfd40d84c69a1faf5ac506aa65ecbe", size = 105584, upload-time = "2026-05-19T21:30:55.962Z" },
-    { url = "https://files.pythonhosted.org/packages/78/87/deb17b7049bbe74ea11a713b86f8f27800cc1c8648b0b797243ebb4830ba/yarl-1.24.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:7b3a85525f6e7eeabcfdd372862b21ee1915db1b498a04e8bf0e389b607ff0bd", size = 103410, upload-time = "2026-05-19T21:30:57.962Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/be/f9f7594e23b5b93affff0318e4593c1920331bcaefda326cabcad94296a1/yarl-1.24.2-cp314-cp314t-win_amd64.whl", hash = "sha256:a7624b1ca46ca5d7b864ef0d2f8efe3091454085ee1855b4e992314529972215", size = 102980, upload-time = "2026-05-19T21:30:59.735Z" },
-    { url = "https://files.pythonhosted.org/packages/65/a4/ba80dccd3593ff1f01051a818694d07b58cb8232677ee9a22a5a1f93a9fc/yarl-1.24.2-cp314-cp314t-win_arm64.whl", hash = "sha256:e434a45ce2e7a947f951fc5a8944c8cc080b7e59f9c50ae80fd39107cf88126d", size = 91219, upload-time = "2026-05-19T21:31:01.934Z" },
     { url = "https://files.pythonhosted.org/packages/fd/4d/4b880086bd0d3e034d25647be1d830afc3e3f610e98c4ab3490af6b1b6d5/yarl-1.24.2-py3-none-any.whl", hash = "sha256:2783d9226db8797636cd6896e4de81feed252d1db72265686c9558d97a4d94b9", size = 53576, upload-time = "2026-05-19T21:31:03.909Z" },
 ]

From 38cac409b708e123257f5e779330842dd0c81536 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 7 Jun 2026 20:19:08 -0400
Subject: [PATCH 073/314] Integrate ACUITYnano temperature controller (config,
 web control, SDKs)

- config.yml: add `temperature:` block (serial backend on COM8) so the
  device layer registers a `temperature` device.
- Web Devices header: live water-temperature readout + setpoint control
  - data.py: GET /api/devices/temperature/status, POST /api/devices/temperature/set
  - devices.js: temperature panel (poll + set); main.css pill; index.html markup
- Vendor integration SDKs: MQTT (test_temperature_controller.py) and USB
  serial (test_temp_usb.py).
---
 config/config.yml                             |  27 +++-
 .../hardware/dispim/devices/test_temp_usb.py  |  90 +++++++++++++
 .../devices/test_temperature_controller.py    |  99 +++++++++++++++
 gently/ui/web/routes/data.py                  |  55 ++++++++
 gently/ui/web/static/css/main.css             |  65 ++++++++++
 gently/ui/web/static/js/devices.js            | 118 ++++++++++++++++++
 gently/ui/web/templates/index.html            |  14 +++
 7 files changed, 467 insertions(+), 1 deletion(-)
 create mode 100644 gently/hardware/dispim/devices/test_temp_usb.py
 create mode 100644 gently/hardware/dispim/devices/test_temperature_controller.py

diff --git a/config/config.yml b/config/config.yml
index 086de3f1..9c05c274 100644
--- a/config/config.yml
+++ b/config/config.yml
@@ -10,4 +10,29 @@ mmdirectory: "C:/Program Files/Micro-Manager-1.4"
 switchbot:
   name: room_light
   address: "EC:6F:04:06:5B:23"
-  timeout: 20.0
\ No newline at end of file
+  timeout: 20.0
+
+# ACUITYnano Precision Thermal Controller (Peltier/TEC, 0.0–99.9 °C). When this
+# block is present the device layer registers a `temperature` device and the
+# Devices tab shows a setpoint control; plans can also block on it via
+# `bps.mv(temperature, 20.0)`. Remove/comment the block to skip registration.
+#
+# backend: mqtt talks to the controller over the vendor's MQTT bridge
+# (acuitynano_precision_thermalizer_api). With no broker/port/user/password
+# keys it uses the vendor package's embedded HiveMQ Cloud defaults — set them
+# here only to point at a different broker. The vendor package must be
+# installed on the device-layer machine (not on PyPI).
+temperature:
+  name: temperature
+  backend: serial          # serial | mqtt | mock — USB serial is the working
+                           # link on this machine (MQTT cloud is firewalled)
+  com_port: "COM8"
+  baud_rate: 115200
+  stabilize_timeout: 600   # seconds to wait for "[ SYSTEM LOCKED ]" on a blocking set
+  feedback_peltier: false  # true = control off the peltier sensor instead of water
+  # MQTT alternative (vendor HiveMQ Cloud defaults; needs outbound TLS :8883):
+  # backend: mqtt
+  # broker: "your-broker.example.com"   # optional — overrides the embedded default
+  # port: 8883
+  # user: "username"
+  # password: "secret"
\ No newline at end of file
diff --git a/gently/hardware/dispim/devices/test_temp_usb.py b/gently/hardware/dispim/devices/test_temp_usb.py
new file mode 100644
index 00000000..f6394aee
--- /dev/null
+++ b/gently/hardware/dispim/devices/test_temp_usb.py
@@ -0,0 +1,90 @@
+import serial
+import time
+import threading
+
+class AcuityNanoPrecisionThermalizerSerial:
+    def __init__(self, com_port, baud_rate=115200):
+        self.telemetry = {
+            "target": 20.0,
+            "water": 20.0,
+            "peltier": 20.0,
+            "state": "DISCONNECTED",
+            "errors": "0"
+        }
+        self.running = True
+        self.ser = serial.Serial(com_port, baud_rate, timeout=0.1)
+        time.sleep(2)
+        
+        self.thread = threading.Thread(target=self._read_loop, daemon=True)
+        self.thread.start()
+
+    def _read_loop(self):
+        while self.running and self.ser.is_open:
+            try:
+                if self.ser.in_waiting:
+                    line = self.ser.readline().decode('utf-8', errors='ignore').strip()
+                    if "=" in line:
+                        key, val = line.split("=", 1)
+                        if key == "TARGET": self.telemetry["target"] = float(val)
+                        elif key == "WATER": self.telemetry["water"] = float(val)
+                        elif key == "ACTUAL": self.telemetry["peltier"] = float(val)
+                        elif key == "STATE": self.telemetry["state"] = val
+                        elif key == "ERRORS": self.telemetry["errors"] = val
+            except Exception:
+                pass
+            time.sleep(0.01)
+
+    def close(self):
+        self.running = False
+        if self.ser.is_open:
+            self.ser.close()
+    
+    def set_temperature(self, target_celsius):
+        if 0.0 <= target_celsius <= 99.9:
+            cmd = f"TEMP={target_celsius}\n"
+            self.ser.write(cmd.encode('utf-8'))
+        else:
+            raise ValueError("Target must be between 0.0 and 99.9 C")
+
+    def enable_tec(self, enable=True):
+        val = "1" if enable else "0"
+        cmd = f"ENABLE={val}\n"
+        self.ser.write(cmd.encode('utf-8'))
+
+    def set_feedback_sensor(self, use_peltier=False):
+        val = "1" if use_peltier else "0"
+        cmd = f"SENSOR={val}\n"
+        self.ser.write(cmd.encode('utf-8'))
+
+    def get_water_temp(self):
+        return self.telemetry["water"]
+
+    def get_system_state(self):
+        return self.telemetry["state"]
+        
+    def wait_for_target(self, timeout_seconds=300):
+        start = time.time()
+        while time.time() - start < timeout_seconds:
+            if "[ SYSTEM LOCKED ]" in self.telemetry["state"]:
+                return True
+            time.sleep(0.5)
+        return False
+
+if __name__ == "__main__":
+    import time
+    
+    print("Connecting to ACUITYnano...")
+    acuity = AcuityNanoPrecisionThermalizerSerial("COM8")
+
+    print("Commanding 37.0 C...")
+    acuity.set_temperature(37.0)
+    acuity.enable_tec(True)
+
+    print("Waiting for thermal stabilization...")
+    if acuity.wait_for_target(timeout_seconds=600):
+        print(f"System locked at {acuity.get_water_temp()} C!")
+        # Trigger external camera or syringe pump here
+    else:
+        print("Timeout reached before system stabilized.")
+
+    acuity.close()
\ No newline at end of file
diff --git a/gently/hardware/dispim/devices/test_temperature_controller.py b/gently/hardware/dispim/devices/test_temperature_controller.py
new file mode 100644
index 00000000..a7efddfe
--- /dev/null
+++ b/gently/hardware/dispim/devices/test_temperature_controller.py
@@ -0,0 +1,99 @@
+"""
+ACUITYnano Third-Party Integration SDK
+Provides a clean, object-oriented API for external software automation.
+"""
+import paho.mqtt.client as mqtt
+import time
+import threading
+
+class AcuityNanoPrecisionThermalizerAPI:
+    def __init__(self, broker="d0246aa97d194c9da52a19e6f46063eb.s1.eu.hivemq.cloud", port=8883, user="acuitynano", password="Bg984V!@wfhBrkp"):
+        self.prefix = "acuitynano_hhmi_shroff_diSPIM_001"
+        self.telemetry = {
+            "target": 20.0,
+            "water": 20.0,
+            "peltier": 20.0,
+            "state": "DISCONNECTED",
+            "errors": "0"
+        }
+        
+        try:
+            self.client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2)
+        except AttributeError:
+            self.client = mqtt.Client()
+            
+        self.client.username_pw_set(user, password)
+        self.client.tls_set()
+        self.client.on_connect = self._on_connect
+        self.client.on_message = self._on_message
+        
+        self.thread = threading.Thread(target=self._start_loop, daemon=True)
+        self.thread.start()
+        time.sleep(2)
+
+    def _start_loop(self):
+        self.client.connect(broker, port, 60)
+        self.client.loop_forever()
+
+    def _on_connect(self, client, userdata, flags, rc, properties=None):
+        self.client.subscribe(f"{self.prefix}/telemetry/#")
+
+    def _on_message(self, client, userdata, msg):
+        topic = msg.topic.split("/")[-1]
+        payload = msg.payload.decode('utf-8')
+        
+        if topic == "target": self.telemetry["target"] = float(payload)
+        elif topic == "water": self.telemetry["water"] = float(payload)
+        elif topic == "actual": self.telemetry["peltier"] = float(payload)
+        elif topic == "state": self.telemetry["state"] = payload
+        elif topic == "errors": self.telemetry["errors"] = payload
+
+    def set_temperature(self, target_celsius):
+        if 0.0 <= target_celsius <= 99.9:
+            self.client.publish(f"{self.prefix}/cmd/temp", str(target_celsius))
+        else:
+            raise ValueError("Target must be between 0.0 and 99.9 C")
+
+    def enable_tec(self, enable=True):
+        val = "1" if enable else "0"
+        self.client.publish(f"{self.prefix}/cmd/enable", val)
+
+    def set_feedback_sensor(self, use_peltier=False):
+        val = "1" if use_peltier else "0"
+        self.client.publish(f"{self.prefix}/cmd/sensor", val)
+
+    def get_water_temp(self):
+        return self.telemetry["water"]
+
+    def get_peltier_temp(self):
+        return self.telemetry["peltier"]
+
+    def get_system_state(self):
+        return self.telemetry["state"]
+        
+    def wait_for_target(self, timeout_seconds=300):
+        start = time.time()
+        while time.time() - start < timeout_seconds:
+            if "[ SYSTEM LOCKED ]" in self.telemetry["state"]:
+                return True
+            time.sleep(0.5)
+        return False
+
+
+
+if __name__ == "__main__":
+
+    import time
+    from acuitynano_precision_thermalizer_api import AcuityNanoPrecisionThermalizerAPI
+
+    acuity = AcuityNanoPrecisionThermalizerAPI()
+    print("Commanding ACUITYnano to 37.0 C...")
+    acuity.set_temperature(30.0)
+    acuity.enable_tec(True)
+
+    print("Waiting for thermal stabilization...")
+    if acuity.wait_for_target(timeout_seconds=600):
+        print(f"System locked at {acuity.get_water_temp()} C!")
+        # Trigger image acquisition here
+    else:
+        print("Timeout reached.")
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 3133ec60..c8c0ebe7 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -304,6 +304,61 @@ async def set_room_light(payload: dict = Body(...)):
             raise HTTPException(status_code=502, detail=res.get("error", "room light command failed"))
         return {"state": res.get("state", state)}
 
+    @router.get("/api/devices/temperature/status")
+    async def get_temperature_status():
+        """Live water temperature, setpoint, and lock state (cheap to poll).
+
+        Cached at the device layer (no per-call hardware round trip), so the
+        Devices header can poll it like the room light. ``available`` is false
+        when no controller is configured/connected, which hides the control.
+        """
+        client = _resolve_client()
+        if client is None:
+            return {"available": False, "state": "unknown"}
+        try:
+            res = await client.get_temperature()
+        except Exception as exc:
+            logger.debug("temperature status fetch failed: %s", exc)
+            return {"available": False, "state": "unknown"}
+        return {
+            "available": bool(res.get("success", False)),
+            "temperature_c": res.get("temperature_c"),
+            "setpoint_c": res.get("setpoint_c"),
+            "state": res.get("state", "unknown"),
+            "peltier_c": res.get("peltier_c"),
+        }
+
+    @router.post("/api/devices/temperature/set",
+                 dependencies=[Depends(require_control)])
+    async def set_temperature(payload: dict = Body(...)):
+        """Command the temperature setpoint. Body: {"target_c": float}.
+
+        Non-blocking: the controller ramps and the status poll reflects progress
+        (and the SYSTEM LOCKED state once it stabilizes).
+        """
+        try:
+            target = float(payload.get("target_c"))
+        except (TypeError, ValueError):
+            raise HTTPException(status_code=400, detail="target_c must be a number")
+        if not (0.0 <= target <= 99.9):
+            raise HTTPException(status_code=400, detail="target_c must be between 0.0 and 99.9 C")
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            res = await client.set_temperature(target)
+        except Exception as exc:
+            logger.exception("Temperature command failed")
+            raise HTTPException(status_code=502, detail=f"temperature command failed: {exc}")
+        if not res.get("success"):
+            raise HTTPException(status_code=502, detail=res.get("error", "temperature command failed"))
+        return {
+            "target_c": res.get("target_c", target),
+            "temperature_c": res.get("temperature_c"),
+            "state": res.get("state", "unknown"),
+            "waited": res.get("waited", False),
+        }
+
     @router.get("/api/calibration")
     async def list_calibration(embryo_id: Optional[str] = None):
         """Get calibration images"""
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index fdafcc1d..10bc6f62 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9671,6 +9671,71 @@ body.modal-open {
 }
 .devices-room-light.is-busy { opacity: 0.65; cursor: progress; }
 
+/* --- Temperature controller ------------------------------------------- */
+/* Readout + setpoint input + Set, styled as a pill to sit beside the
+   room-light toggle in the Devices header. Hidden until a controller is
+   available (mirrors the room light). */
+.devices-temp {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35rem;
+    padding: 0.12rem 0.28rem 0.12rem 0.5rem;
+    border: 1px solid var(--map-overlay-edge);
+    background: var(--map-overlay-bg);
+    border-radius: 999px;
+    color: var(--map-ink-mute);
+    font-family: inherit;
+    font-size: 0.65rem;
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+}
+.devices-temp[hidden] { display: none; }
+.devices-temp-icon { display: inline-flex; align-items: center; color: var(--map-ink-mute); transition: color 0.15s, filter 0.15s; }
+/* "locked" — cool glow once the controller reports SYSTEM LOCKED */
+.devices-temp.is-locked { border-color: rgba(90, 200, 250, 0.6); color: #5ac8fa; background: rgba(90, 200, 250, 0.1); }
+.devices-temp.is-locked .devices-temp-icon { color: #5ac8fa; filter: drop-shadow(0 0 5px rgba(90, 200, 250, 0.6)); }
+.devices-temp.is-busy { opacity: 0.7; cursor: progress; }
+.devices-temp-readout {
+    font-variant-numeric: tabular-nums;
+    letter-spacing: 0.02em;
+    min-width: 3.4em;
+    text-align: right;
+    white-space: nowrap;
+}
+.devices-temp-input {
+    width: 3.4em;
+    padding: 0.1rem 0.3rem;
+    border: 1px solid var(--map-overlay-edge);
+    background: var(--map-paper, rgba(0, 0, 0, 0.2));
+    border-radius: 6px;
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.72rem;
+    font-variant-numeric: tabular-nums;
+    text-align: right;
+    -moz-appearance: textfield;
+}
+.devices-temp-input:focus { outline: none; border-color: var(--map-accent); }
+.devices-temp-input::-webkit-outer-spin-button,
+.devices-temp-input::-webkit-inner-spin-button { -webkit-appearance: none; margin: 0; }
+.devices-temp-set {
+    padding: 0.16rem 0.5rem;
+    border: 1px solid var(--map-overlay-edge);
+    background: var(--map-overlay-bg);
+    border-radius: 999px;
+    color: var(--map-ink-mute);
+    font-family: inherit;
+    font-size: 0.62rem;
+    font-weight: 700;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    cursor: pointer;
+    transition: color 0.15s, border-color 0.15s, background 0.15s;
+}
+.devices-temp-set:hover:not(:disabled) { border-color: var(--map-accent); color: var(--map-ink); }
+.devices-temp-set:disabled { opacity: 0.5; cursor: default; }
+
 /* --- Containers ------------------------------------------------------- */
 .devices-view { display: flex; flex-direction: column; flex: 1; min-height: 0; }
 .devices-view-details { gap: 1rem; }
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 27bc12c3..caa1bf48 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -81,6 +81,13 @@ const DevicesManager = (function () {
     let _roomLightBusy = false;
     let _roomLightTimer = null;
 
+    // Temperature-controller panel DOM + state
+    let _tempEl, _tempReadout, _tempInput, _tempSet;
+    let _tempState = 'unknown';
+    let _tempAvailable = false;
+    let _tempBusy = false;
+    let _tempTimer = null;
+
     let _lastTs = 0;
     let _previousTs = 0;
     let _lastWallTs = 0;
@@ -147,6 +154,11 @@ const DevicesManager = (function () {
         _roomLightToggle = document.getElementById('devices-room-light-toggle');
         _roomLightLabel  = document.getElementById('devices-room-light-label');
 
+        _tempEl      = document.getElementById('devices-temp');
+        _tempReadout = document.getElementById('devices-temp-readout');
+        _tempInput   = document.getElementById('devices-temp-input');
+        _tempSet     = document.getElementById('devices-temp-set');
+
         // Recompute the scale bar caption whenever the canvas resizes.
         if (_mapSvg && window.ResizeObserver) {
             new ResizeObserver(() => updateScalebar()).observe(_mapSvg);
@@ -1369,6 +1381,111 @@ const DevicesManager = (function () {
         _roomLightTimer = setInterval(loadRoomLightStatus, 15000);
     }
 
+    // =====================================================================
+    // Temperature controller (ACUITYnano) — readout + setpoint
+    // =====================================================================
+
+    function fmtTemp(v) {
+        return (v === null || v === undefined || isNaN(v)) ? '—' : Number(v).toFixed(1) + '°';
+    }
+
+    function applyTemperature(data) {
+        _tempAvailable = !!(data && data.available);
+        if (!_tempEl) return;
+        _tempEl.hidden = !_tempAvailable;
+        if (!_tempAvailable) return;
+        _tempState = (data && data.state) || 'unknown';
+        const locked = /LOCK/i.test(_tempState);
+        _tempEl.classList.toggle('is-locked', locked);
+        if (_tempBusy) return;  // a set() is in flight; leave its transient label
+        const cur = fmtTemp(data.temperature_c);
+        const hasSp = data.setpoint_c !== null && data.setpoint_c !== undefined;
+        const sp = hasSp ? fmtTemp(data.setpoint_c) : null;
+        _tempReadout.textContent = sp ? (cur + ' → ' + sp) : cur;
+        _tempReadout.title = 'Water ' + cur + (sp ? (', setpoint ' + sp) : '')
+            + (locked ? ' (locked)' : '');
+        // Seed the input with the current setpoint once, while untouched, so the
+        // operator sees where it is before nudging it.
+        if (_tempInput && document.activeElement !== _tempInput && _tempInput.value === '' && hasSp) {
+            _tempInput.value = Number(data.setpoint_c).toFixed(1);
+        }
+    }
+
+    async function loadTemperatureStatus() {
+        if (!_tempEl || _tempBusy) return;
+        try {
+            const res = await fetch('/api/devices/temperature/status');
+            if (!res.ok) { applyTemperature({ available: false }); return; }
+            applyTemperature(await res.json());
+        } catch (err) {
+            console.debug('temperature status fetch failed:', err);
+            applyTemperature({ available: false });
+        }
+    }
+
+    async function setTemperature() {
+        if (!_tempEl || _tempBusy || !_tempAvailable) return;
+        const target = parseFloat(_tempInput && _tempInput.value);
+        if (isNaN(target) || target < 0 || target > 99.9) {
+            _tempReadout.textContent = '0–99.9 °C';
+            setTimeout(loadTemperatureStatus, 1500);
+            return;
+        }
+        _tempBusy = true;
+        _tempEl.classList.add('is-busy');
+        if (_tempSet) _tempSet.disabled = true;
+        _tempReadout.textContent = 'Set ' + target.toFixed(1) + '°…';
+
+        // Settle back to the resolved state, or surface a transient message
+        // (insufficient control / error) for 2 s before reverting.
+        const finish = (msg) => {
+            _tempBusy = false;
+            _tempEl.classList.remove('is-busy');
+            if (_tempSet) _tempSet.disabled = false;
+            if (msg) {
+                _tempReadout.textContent = msg;
+                setTimeout(loadTemperatureStatus, 2000);
+            } else {
+                loadTemperatureStatus();  // controller ramps; poll shows progress
+            }
+        };
+
+        try {
+            const res = await fetch('/api/devices/temperature/set', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ target_c: target }),
+            });
+            if (res.status === 401 || res.status === 403) { finish('Need control'); return; }
+            if (!res.ok) {
+                console.error('temperature set failed:', await res.text());
+                finish('Error');
+                return;
+            }
+            await res.json();
+            finish(null);
+        } catch (err) {
+            console.error('temperature set failed:', err);
+            finish('Error');
+        }
+    }
+
+    function setupTemperature() {
+        if (!_tempEl) return;
+        if (_tempSet) _tempSet.addEventListener('click', setTemperature);
+        if (_tempInput) {
+            _tempInput.addEventListener('keydown', (e) => {
+                if (e.key === 'Enter') { e.preventDefault(); setTemperature(); }
+            });
+        }
+        loadTemperatureStatus();
+        // Periodic refresh: the setpoint can also change from agent plans, and a
+        // commanded ramp settles over time. Status is cached at the device layer,
+        // so polling is cheap; it also reveals the control once the layer connects.
+        if (_tempTimer) clearInterval(_tempTimer);
+        _tempTimer = setInterval(loadTemperatureStatus, 15000);
+    }
+
     // =====================================================================
     // View switching
     // =====================================================================
@@ -1429,6 +1546,7 @@ const DevicesManager = (function () {
         setupViewSwitcher();
         setupCameraWiring();
         setupRoomLight();
+        setupTemperature();
         loadCoverslip();
         loadEmbryosSnapshot();
         switchView(_currentView);
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index e8164eca..85a60345 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -304,6 +304,20 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     </div>
                 </div>
                 <div class="devices-status">
+                    <div class="devices-temp" id="devices-temp" title="Temperature controller" hidden>
+                        <span class="devices-temp-icon" aria-hidden="true">
+                            <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor"
+                                 stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">
+                                <path d="M14 14.76V5a2 2 0 0 0-4 0v9.76a4 4 0 1 0 4 0z"/>
+                            </svg>
+                        </span>
+                        <span class="devices-temp-readout" id="devices-temp-readout" title="Water temperature → setpoint">—</span>
+                        <input class="devices-temp-input" id="devices-temp-input" type="number"
+                               min="0" max="99.9" step="0.1" inputmode="decimal" placeholder="°C"
+                               aria-label="Target temperature in Celsius">
+                        <button class="devices-temp-set" id="devices-temp-set" type="button"
+                                title="Set temperature setpoint">Set</button>
+                    </div>
                     <button class="devices-room-light" id="devices-room-light-toggle" type="button"
                             title="Toggle room light" aria-pressed="false" hidden disabled>
                         <span class="devices-room-light-bulb" aria-hidden="true">

From 06ccbfed243467a8f934349f14a90b7a38cbda81 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 7 Jun 2026 20:19:17 -0400
Subject: [PATCH 074/314] Add SPIM-head F-drive device, hard limits, and
 focus/align plans

- piezo.py: harden DiSPIMFDrive with module-level hard travel limits
  (F_DRIVE_MIN_UM=30, F_DRIVE_MAX_UM=25000), non-overridable from above;
  configurable per-move Status timeout (120s) for slow full-travel traverses.
- device_factory.py: register the SPIM head as `fdrive` (ZStage:V:37).
- plans/acquisition.py: spim_head_focus_descent_plan (3-phase descent:
  fast traverse -> coarse 1000um steps -> fine sweep-and-fit under LED),
  register_views_xy_plan (dual-view XY registration), and the composite
  spim_head_focus_and_align_plan. Also fix get_stage_position_plan to use
  bps.rd's actual return value (it was indexed as a {name:{value}} dict).
- device_layer.py: register the new plans and mark them heavy.
- test_dispim_device_safety.py: F-drive bounds tests for the 30/25000 limits.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/device_factory.py    |   9 +
 gently/hardware/dispim/device_layer.py      |  19 ++
 gently/hardware/dispim/devices/piezo.py     |  64 ++++-
 gently/hardware/dispim/plans/acquisition.py | 294 +++++++++++++++++++-
 tests/test_dispim_device_safety.py          |  36 ++-
 5 files changed, 405 insertions(+), 17 deletions(-)

diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index 44399076..c70e68b0 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -34,6 +34,7 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
         - lightsheet_snap: DiSPIMLightSheetSnap
         - scanner: DiSPIMScanner
         - piezo: DiSPIMPiezo
+        - fdrive: DiSPIMFDrive (SPIM head Z / F axis)
 
     Example
     -------
@@ -67,6 +68,7 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
         'camera_name': 'HamCam1',
         'scanner_name': 'Scanner:AB:33',
         'piezo_name': 'PiezoStage:P:34',
+        'fdrive_name': 'ZStage:V:37',
         'bottom_camera_name': 'Bottom PCO',
         'led_name': 'LED:X:31'
     }
@@ -127,6 +129,13 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
     except Exception as e:
         logger.warning("Could not create XY stage: %s", e)
 
+    try:
+        from .devices import DiSPIMFDrive
+        devices['fdrive'] = DiSPIMFDrive(name=cfg['fdrive_name'], core=core)
+        logger.info("Created F-drive (SPIM head): %s", cfg['fdrive_name'])
+    except Exception as e:
+        logger.warning("Could not create F-drive (SPIM head): %s", e)
+
     try:
         if cfg.get('led_name'):
             from .devices import DiSPIMLED
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 3b50aded..53495cf6 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -177,6 +177,11 @@ def __init__(
             'focus_sweep_plan',
             'calibrate_piezo_galvo_plan',
             'multi_embryo_calibration_workflow',
+            # Slow F-drive traverse (25000 -> ~50 um) + fine focus scan + the
+            # XY view-registration loop all hold MMCore for a while.
+            'spim_head_focus_descent_plan',
+            'register_views_xy_plan',
+            'spim_head_focus_and_align_plan',
         })
 
     async def initialize(self):
@@ -448,6 +453,20 @@ def _load_plans(self):
         except ImportError:
             logger.info("Main acquisition plans not available")
 
+        # SPIM head focus + dual-view registration plans
+        try:
+            from .plans.acquisition import (
+                spim_head_focus_descent_plan,
+                register_views_xy_plan,
+                spim_head_focus_and_align_plan,
+            )
+            self.plans['spim_head_focus_descent_plan'] = spim_head_focus_descent_plan
+            self.plans['register_views_xy_plan'] = register_views_xy_plan
+            self.plans['spim_head_focus_and_align_plan'] = spim_head_focus_and_align_plan
+            logger.info("Loaded SPIM head focus plans")
+        except ImportError:
+            logger.info("SPIM head focus plans not available")
+
     def _resolve_device_args(self, kwargs: Dict[str, Any]) -> Dict[str, Any]:
         """Replace device name strings with actual device objects"""
         resolved = {}
diff --git a/gently/hardware/dispim/devices/piezo.py b/gently/hardware/dispim/devices/piezo.py
index 7103814b..91161e12 100644
--- a/gently/hardware/dispim/devices/piezo.py
+++ b/gently/hardware/dispim/devices/piezo.py
@@ -15,36 +15,80 @@
 logger = logging.getLogger(__name__)
 
 
+# =========================================================================
+# SPIM-HEAD F-DRIVE HARDWARE SAFETY LIMITS — absolute MMCore micrometres.
+#
+# Layer-1 software fence for the SPIM head: the ASI Tiger "ZStage:V:37"
+# axis, which the ASIdiSPIM plugin labels "SPIM Head Height" (the F axis).
+# This is the drive that LOWERS the objectives into the dish to hunt for
+# embryos ("Start Hunting") and RAISES them clear for sample loading
+# ("Load Sample"). Every F-drive move planned by any layer above (Bluesky
+# plans, agent orchestrators, UI tools) is bounded here. These are NOT
+# constructor kwargs and DiSPIMFDrive exposes no setter — no layer above
+# can widen them.
+#
+#   F_DRIVE_MIN_UM  collision-critical FLOOR. Smaller F drives the head
+#                   DOWN toward the sample/holder; this hard stop keeps the
+#                   objectives off the dish.
+#   F_DRIVE_MAX_UM  fully-raised "Load Sample" ceiling.
+#
+# Update only after physically verifying head travel on the rig (drive the
+# F axis to each extreme by hand, confirm no collision, read the absolute
+# MMCore position) and then editing the constants below.
+#
+# SCOPE: this is a SOFTWARE-ONLY fence. Unlike the XY stage (see
+# devices/stage.py, which also pushes ASI Tiger firmware soft-limits) we do
+# NOT write these to the controller, so a physical joystick move can still
+# drive the head past these bounds — they bind code-issued moves only.
+# =========================================================================
+F_DRIVE_MIN_UM: float = 30.0
+F_DRIVE_MAX_UM: float = 25000.0
+
+
 class DiSPIMFDrive:
     """
     DiSPIM F-drive (SPIM Head motor) - works with bps.mv(fdrive, position)
 
-    ASI Tiger V:37 axis - controls F-axis module for lowering objectives
-    Device-agnostic: any plan that moves a positioner will work with this device
+    ASI Tiger "ZStage:V:37" axis — the ASIdiSPIM "SPIM Head Height" / F
+    axis that lowers the objectives to hunt for embryos and raises them to
+    load a sample. Device-agnostic: any plan that moves a positioner works.
+
+    Hard travel bounds are the module-level F_DRIVE_MIN_UM / F_DRIVE_MAX_UM
+    constants. They are not constructor kwargs and cannot be widened from
+    above — see the safety-limit note above this class.
     """
 
     def __init__(self, name: str, core: pymmcore.CMMCore,
-                 limits: Tuple[float, float] = (20.0, 25000.0)):
+                 move_timeout_s: float = 120.0):
         self.name = name
         self.core = core
         self.parent = None  # Required for Bluesky
-        self._limits = limits
+        # Full-travel F moves (e.g. 25000 -> 5000 um: "Load Sample" -> approach)
+        # are slow; the per-move Status timeout must comfortably exceed the
+        # longest traverse or bps.mv would error mid-move while the stage is
+        # still travelling. Configurable for unusually slow controllers.
+        self._move_timeout_s = float(move_timeout_s)
         self.tolerance = 0.1  # µm
 
     @property
-    def limits(self):
-        return self._limits
+    def limits(self) -> Tuple[float, float]:
+        """Read-only view of the hardware safety limits (module constants)."""
+        return (F_DRIVE_MIN_UM, F_DRIVE_MAX_UM)
 
     def set(self, position):
         """Move F-drive to position - called by bps.mv()"""
         position = float(position)
         position = round(position, 2)  # Round to 0.01 μm precision
 
-        # Safety check
-        if not (self._limits[0] <= position <= self._limits[1]):
-            raise ValueError(f"Position {position} outside limits {self._limits}")
+        # Hardware safety check — pinned to the module-level F_DRIVE_*_UM
+        # constants; nothing above this layer can widen them.
+        if not (F_DRIVE_MIN_UM <= position <= F_DRIVE_MAX_UM):
+            raise ValueError(
+                f"F-drive position {position} outside hardware limits "
+                f"[{F_DRIVE_MIN_UM}, {F_DRIVE_MAX_UM}]"
+            )
 
-        status = Status(obj=self, timeout=30)
+        status = Status(obj=self, timeout=self._move_timeout_s)
 
         def wait():
             try:
diff --git a/gently/hardware/dispim/plans/acquisition.py b/gently/hardware/dispim/plans/acquisition.py
index 8b8ffb35..9c08c8be 100644
--- a/gently/hardware/dispim/plans/acquisition.py
+++ b/gently/hardware/dispim/plans/acquisition.py
@@ -256,8 +256,9 @@ def get_stage_position_plan(xy_stage):
     >>> current_pos = yield from get_stage_position_plan(xy_stage)
     >>> print(f"Stage at: {current_pos}")
     """
-    result = yield from bps.rd(xy_stage)
-    return result[xy_stage.name]['value']
+    # bps.rd returns the device's single reading value directly (here the
+    # [x, y] position array), not a {name: {value}} dict.
+    return (yield from bps.rd(xy_stage))
 
 
 def move_to_pixel_plan(xy_stage,
@@ -1337,3 +1338,292 @@ def get_light_source_power_plan(
         'pct': value,
         'success': True,
     }
+
+
+# ============================================================================
+# SPIM HEAD FOCUS
+# Bring the SPIM head down onto an XY-positioned embryo, lock focus, then
+# register the two objective views on top of each other via the XY stage.
+# ============================================================================
+
+def spim_head_focus_descent_plan(
+    fdrive,
+    camera,
+    led=None,
+    *,
+    traverse_to_um: float = 5000.0,
+    coarse_step_um: float = 1000.0,
+    coarse_stop_um: float = 500.0,
+    fine_top_um: float = 150.0,
+    fine_bottom_um: float = 35.0,
+    fine_step_um: float = 5.0,
+    focus_algorithm: str = "volath",
+    coarse_settle_s: float = 2.0,
+    fine_settle_s: float = 0.5,
+    led_state: str = "Open",
+    detect_roi: bool = True,
+) -> Generator[Any, Any, dict]:
+    """
+    Bring the SPIM head down onto an (already XY-positioned) embryo and lock focus.
+
+    The head parks fully raised (~25000 um, "Load Sample") and the embryo only
+    comes into focus near the bottom of travel (~50 um), so almost the whole
+    descent is empty space -- and full-travel F moves are slow. Rather than scan
+    the entire 25000->50 range, this descends in three phases:
+
+      1. Traverse -- one fast move down to ``traverse_to_um`` (default 5000). No imaging.
+      2. Coarse   -- step down by ``coarse_step_um`` (1000) to ``coarse_stop_um``
+                     (~500), settling at each step. No focus decision yet.
+      3. Fine     -- bounded sweep-and-fit from ``fine_top_um`` (150) down to
+                     ``fine_bottom_um`` (35, >= the 30 um hard floor) in
+                     ``fine_step_um`` (5) steps: snap ``camera`` + score each
+                     frame, fit the focus curve (gently.analysis.focus), and
+                     move to the best-focus position.
+
+    ``led`` (transmitted illumination) is opened for the descent and ALWAYS
+    closed afterwards (finalize), mirroring the bottom camera's LED discipline.
+
+    Every F move is clamped to ``fdrive.limits`` (30-25000 um); the 30 um floor
+    is the hard collision stop and ``fine_bottom_um`` must sit above it.
+
+    Parameters
+    ----------
+    fdrive : DiSPIMFDrive
+        SPIM-head F-drive positioner (``bps.mv(fdrive, z)``).
+    camera : DiSPIMCamera
+        SPIM objective camera; ``camera.snap()`` returns the frame to score.
+    led : DiSPIMLED, optional
+        Transmitted-light source. Opened during the descent, closed after.
+    focus_algorithm : str
+        Focus metric: 'volath' (default), 'gradient', 'variance', 'fft_bandpass'.
+
+    Returns
+    -------
+    dict
+        success, best_position_um, best_score, r_squared, start_position_um,
+        and fine_curve (list of (z_um, score) tuples).
+    """
+    from gently.analysis.focus import (
+        FocusAnalysisConfig, FocusDataPoint, analyze_focus_sweep, score_single_image,
+    )
+
+    lo, hi = fdrive.limits
+    config = FocusAnalysisConfig(algorithm=focus_algorithm)
+    out: Dict[str, Any] = {}
+
+    def _clamp(z: float) -> float:
+        return max(lo, min(hi, float(z)))
+
+    def _grab_and_score():
+        frame = camera.snap()
+        # A single SPIM snap may be a side-by-side dual view; score the brighter
+        # objective half (focus is per-objective). Heuristic: width >> height.
+        if frame.ndim == 2 and frame.shape[1] >= frame.shape[0] * 1.5:
+            view = select_best_camera_view(frame)
+        else:
+            view = frame
+        score, roi = score_single_image(view, config, detect_roi=detect_roi)
+        return view, score, roi
+
+    def inner():
+        # bps.rd returns the device's single reading value directly (a float
+        # here) in this bluesky version -- not a {name: {value}} dict.
+        start_z = float((yield from bps.rd(fdrive)))
+        logger.info("[SPIM head focus] start %.1f um, floor %.0f um", start_z, lo)
+
+        if led is not None:
+            yield from bps.mv(led, led_state)
+
+        # Phase 1 -- fast traverse (skip if already below the traverse height)
+        z = start_z
+        if z > traverse_to_um:
+            z = _clamp(traverse_to_um)
+            logger.info("[SPIM head focus] traverse -> %.0f um (slow move)", z)
+            yield from bps.mv(fdrive, z)
+            yield from bps.sleep(coarse_settle_s)
+
+        # Phase 2 -- coarse stepped descent to ~coarse_stop_um
+        while z > coarse_stop_um + 1e-6:
+            z = _clamp(max(coarse_stop_um, z - coarse_step_um))
+            logger.info("[SPIM head focus] coarse -> %.0f um", z)
+            yield from bps.mv(fdrive, z)
+            yield from bps.sleep(coarse_settle_s)
+
+        # Phase 3 -- fine bounded sweep-and-fit through the focus window
+        top, bottom = _clamp(fine_top_um), _clamp(fine_bottom_um)
+        n = max(3, int(round(abs(top - bottom) / max(fine_step_um, 1e-6))) + 1)
+        positions = [_clamp(p) for p in np.linspace(top, bottom, n)]  # descending
+        logger.info("[SPIM head focus] fine scan %.0f->%.0f um in %d steps", top, bottom, n)
+
+        sweep = []
+        for zp in positions:
+            yield from bps.mv(fdrive, zp)
+            yield from bps.sleep(fine_settle_s)
+            view, score, roi = _grab_and_score()
+            sweep.append(FocusDataPoint(position=zp, score=score, image=view, roi=roi))
+            logger.debug("[SPIM head focus] z=%.1f score=%.3g", zp, score)
+
+        result = analyze_focus_sweep(sweep, config)
+        if result.success:
+            best = _clamp(result.best_position)
+        else:
+            best = _clamp(max(sweep, key=lambda d: d.score).position)
+
+        yield from bps.mv(fdrive, best)
+        yield from bps.sleep(fine_settle_s)
+
+        out.update(
+            success=bool(result.success),
+            best_position_um=float(best),
+            best_score=float(result.best_score),
+            r_squared=float(result.r_squared),
+            start_position_um=start_z,
+            fine_curve=[(float(d.position), float(d.score)) for d in sweep],
+        )
+        logger.info("[SPIM head focus] locked %.1f um (score %.3g, R2=%.3f, fit=%s)",
+                    best, result.best_score, result.r_squared, result.success)
+
+    def cleanup():
+        if led is not None:
+            yield from bps.mv(led, "Closed")
+
+    yield from bpp.finalize_wrapper(inner(), cleanup())
+    return out
+
+
+def register_views_xy_plan(
+    camera,
+    xy_stage,
+    *,
+    view_pixel_size_um: float,
+    tolerance_px: float = 20.0,
+    max_iters: int = 4,
+    settle_s: float = 0.5,
+    led=None,
+    led_state: str = "Open",
+    reference_view: int = 0,
+    x_sign: float = -1.0,
+    y_sign: float = 1.0,
+) -> Generator[Any, Any, dict]:
+    """
+    Register the two SPIM objective views on top of each other via the XY stage.
+
+    Snaps ``camera`` (a side-by-side dual view: left = view A, right = view B),
+    detects the embryo centroid in each half, and moves the XY stage to bring
+    the embryo to the centre of the ``reference_view`` (0 = A/left, 1 = B/right).
+    The residual offset in the *other* view is recorded each iteration as the
+    registration error. Iterates up to ``max_iters`` or until the reference
+    view is within ``tolerance_px``.
+
+    The view->stage mapping is the rig-specific part and likely needs tuning:
+      - ``view_pixel_size_um`` is the effective um/pixel of the OBJECTIVE view
+        (NOT the bottom camera) -- required.
+      - ``x_sign`` / ``y_sign`` flip the stage axes to match the camera
+        orientation. Defaults follow the bottom-camera convention (X inverted);
+        confirm them on the rig from the reported per-iteration residuals (if
+        the offset grows instead of shrinking, flip the offending sign).
+
+    XY moves are bounded by the stage's own hardware limits, so a mis-tuned
+    sign fails loudly (limit error) rather than driving anywhere unsafe.
+
+    Returns
+    -------
+    dict
+        converged (bool), iterations (per-iter offsets per view, in px),
+        final_stage_um, and (if nothing was found) error.
+    """
+    from gently.core.coordinates import pixel_displacement_to_stage_movement
+
+    out: Dict[str, Any] = {"converged": False, "iterations": []}
+
+    def _views(frame):
+        if frame.ndim == 2 and frame.shape[1] >= frame.shape[0] * 1.5:
+            mid = frame.shape[1] // 2
+            return [frame[:, :mid], frame[:, mid:]]
+        return [frame]
+
+    def _centroid_offset(view):
+        # (dx, dy) of the embryo centroid from the view centre, in pixels;
+        # None if no embryo (detect_embryo_roi falls back to the whole frame).
+        y0, y1, x0, x1 = detect_embryo_roi(view)
+        h, w = view.shape
+        if (y1 - y0) >= h and (x1 - x0) >= w:
+            return None
+        cx, cy = (x0 + x1) / 2.0, (y0 + y1) / 2.0
+        return (cx - w / 2.0, cy - h / 2.0)
+
+    def inner():
+        if led is not None:
+            yield from bps.mv(led, led_state)
+
+        for _ in range(max_iters):
+            frame = camera.snap()
+            views = _views(frame)
+            offsets = [_centroid_offset(v) for v in views]
+            out["iterations"].append({
+                "offsets_px": [None if o is None else (float(o[0]), float(o[1])) for o in offsets]
+            })
+
+            ref = offsets[reference_view] if reference_view < len(offsets) else None
+            if ref is None:
+                seen = [o for o in offsets if o is not None]
+                if not seen:
+                    out["error"] = "no embryo detected in any view"
+                    break
+                ref = seen[0]
+
+            if max(abs(ref[0]), abs(ref[1])) <= tolerance_px:
+                out["converged"] = True
+                break
+
+            dx_um, dy_um = pixel_displacement_to_stage_movement(ref[0], ref[1], view_pixel_size_um)
+            cur = yield from bps.rd(xy_stage)   # -> [x, y] um (single reading value)
+            target = [cur[0] + x_sign * dx_um, cur[1] + y_sign * dy_um]
+            yield from bps.mov(xy_stage, target)
+            yield from bps.sleep(settle_s)
+
+        final = yield from bps.rd(xy_stage)
+        out["final_stage_um"] = [float(final[0]), float(final[1])]
+
+    def cleanup():
+        if led is not None:
+            yield from bps.mv(led, "Closed")
+
+    yield from bpp.finalize_wrapper(inner(), cleanup())
+    return out
+
+
+def spim_head_focus_and_align_plan(
+    fdrive,
+    camera,
+    xy_stage,
+    led=None,
+    *,
+    view_pixel_size_um: Optional[float] = None,
+    align: bool = True,
+    focus_kwargs: Optional[Dict] = None,
+    align_kwargs: Optional[Dict] = None,
+) -> Generator[Any, Any, dict]:
+    """
+    Full SPIM-head focus workflow for one XY-positioned embryo.
+
+    Descends and locks focus (``spim_head_focus_descent_plan``), then registers
+    the two objective views via the XY stage (``register_views_xy_plan``).
+
+    ``align=True`` requires ``view_pixel_size_um`` (objective-view um/pixel).
+    """
+    out: Dict[str, Any] = {}
+    out["focus"] = yield from spim_head_focus_descent_plan(
+        fdrive, camera, led=led, **(focus_kwargs or {})
+    )
+    if align:
+        if view_pixel_size_um is None:
+            raise ValueError(
+                "align=True requires view_pixel_size_um "
+                "(objective-view um/pixel calibration)"
+            )
+        out["align"] = yield from register_views_xy_plan(
+            camera, xy_stage, view_pixel_size_um=view_pixel_size_um,
+            led=led, **(align_kwargs or {}),
+        )
+    return out
diff --git a/tests/test_dispim_device_safety.py b/tests/test_dispim_device_safety.py
index 40fab85a..1ea296d0 100644
--- a/tests/test_dispim_device_safety.py
+++ b/tests/test_dispim_device_safety.py
@@ -236,9 +236,9 @@ def make_piezo(core=None, limits=(-200.0, 200.0)):
     return DiSPIMPiezo("Piezo", core or make_core(), limits=limits)
 
 
-def make_fdrive(core=None, limits=(20.0, 25000.0)):
+def make_fdrive(core=None):
     from gently.hardware.dispim.devices.piezo import DiSPIMFDrive
-    return DiSPIMFDrive("FDrive", core or make_core(), limits=limits)
+    return DiSPIMFDrive("FDrive", core or make_core())
 
 
 def make_scanner(core=None, limits=(-5.0, 5.0)):
@@ -381,7 +381,8 @@ def test_above_positive_limit_raises(self):
 
 
 class TestFDriveBounds:
-    """F-drive must reject positions outside 20-25000µm limits."""
+    """F-drive (SPIM head) must reject positions outside the 30-25000 µm
+    hard limits (module constants F_DRIVE_MIN_UM / F_DRIVE_MAX_UM)."""
 
     def test_valid_position(self):
         fdrive = make_fdrive()
@@ -391,14 +392,39 @@ def test_valid_position(self):
 
     def test_below_lower_limit_raises(self):
         fdrive = make_fdrive()
-        with pytest.raises(ValueError, match="outside limits"):
+        with pytest.raises(ValueError, match="outside hardware limits"):
             fdrive.set(19.9)
 
     def test_above_upper_limit_raises(self):
         fdrive = make_fdrive()
-        with pytest.raises(ValueError, match="outside limits"):
+        with pytest.raises(ValueError, match="outside hardware limits"):
             fdrive.set(25001.0)
 
+    def test_at_floor_allowed(self):
+        fdrive = make_fdrive()
+        status = fdrive.set(30.0)
+        status.wait(timeout=2)
+        assert fdrive.core._positions["FDrive"] == 30.0
+
+    def test_at_ceiling_allowed(self):
+        fdrive = make_fdrive()
+        status = fdrive.set(25000.0)
+        status.wait(timeout=2)
+        assert fdrive.core._positions["FDrive"] == 25000.0
+
+    def test_just_below_floor_raises(self):
+        fdrive = make_fdrive()
+        with pytest.raises(ValueError, match="outside hardware limits"):
+            fdrive.set(29.99)
+
+    def test_limits_property_is_module_constants(self):
+        from gently.hardware.dispim.devices.piezo import (
+            F_DRIVE_MIN_UM, F_DRIVE_MAX_UM,
+        )
+        fdrive = make_fdrive()
+        assert fdrive.limits == (F_DRIVE_MIN_UM, F_DRIVE_MAX_UM)
+        assert fdrive.limits == (30.0, 25000.0)
+
 
 class TestScannerBounds:
     """Scanner must reject positions outside ±5° limits for both A and B axes."""

From efb6a8e4816cc6952a53e0959e2f9e705cfc9632 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 20:30:27 +0100
Subject: [PATCH 075/314] Add ruff lint/format tooling and fix all violations
 (#42)

- pyproject.toml: configure ruff (line-length=100, target-version=py310,
  select=E,F,I,UP,B) and add ruff/pre-commit to the dev dependency group.
- .pre-commit-config.yaml: ruff --fix + ruff-format hooks, pinned to
  v0.15.17 (matches the installed ruff; the older v0.4.0 pin in the issue
  template produced inconsistent UP038/format results).
- .github/workflows/lint.yml: CI job running `ruff check .` and
  `ruff format --check .` on every PR.
- CONTRIBUTING.md: local setup instructions (uv sync, pre-commit install,
  pre-commit run --all-files); notes that mypy is tracked separately (#46).
- Fix all ~716 pre-existing ruff violations across the codebase: E501
  (wrapped long lines, line-length raised to 100), E402, F401, F841, B904,
  B905, B007, B023, B008, B027, UP035, E741 (ambiguous `l` -> `learning`),
  E722, F402, and F821 (including two real bugs: missing **kwargs in
  multi_embryo_calibration_session_plan, and an undefined-variable return
  in sam_detection._detect_with_sam).

mypy was scoped out of this issue due to its size (3002 errors across
225/299 files); tracked as a follow-up in #46.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .github/workflows/lint.yml                    |   26 +
 .pre-commit-config.yaml                       |    7 +
 CONTRIBUTING.md                               |   51 +
 benchmarks/agent/evaluator.py                 |   50 +-
 benchmarks/perception/__init__.py             |    4 +-
 benchmarks/perception/ground_truth.py         |   48 +-
 benchmarks/perception/live_viewer.py          |  152 +-
 benchmarks/perception/metrics.py              |  111 +-
 benchmarks/perception/runner.py               |   49 +-
 benchmarks/perception/testset.py              |   37 +-
 benchmarks/perception/trace_viewer.py         |   90 +-
 benchmarks/runner.py                          |   10 +-
 diagnostics/benchmark_gentlystore_fps.py      |  263 ++-
 diagnostics/benchmark_volume_fps.py           |  410 +++--
 diagnostics/measure_centering_error.py        |   38 +-
 diagnostics/plot_benchmark_results.py         |  285 ++--
 diagnostics/run_multi_embryo_volumes.py       |  234 +--
 diagnostics/segment_embryo_nuclei.py          |   12 +-
 .../spim_hardware_triggering_reference.py     |   98 +-
 diagnostics/switchbot_webgui.py               |   52 +-
 examples/example_dispim_workflows.py          |  534 +++---
 experimental/data_reasoning/__init__.py       |    6 +-
 experimental/data_reasoning/assessment.py     |   42 +-
 experimental/data_reasoning/coverage.py       |   49 +-
 experimental/data_reasoning/gap_planner.py    |    2 +-
 experimental/data_reasoning/models.py         |   30 +-
 experimental/data_reasoning/quality.py        |   17 +-
 experimental/ml_agent/agent.py                |   21 +-
 experimental/ml_agent/prompt.py               |   19 +-
 experimental/ml_agent/tools.py                |  131 +-
 experimental/test_data_reasoning.py           |   19 +-
 gently/__init__.py                            |   64 +-
 gently/agent/__init__.py                      |   61 +-
 gently/analysis/__init__.py                   |   11 +-
 gently/analysis/core.py                       |  191 ++-
 gently/analysis/focus.py                      |   75 +-
 gently/analysis/pipeline.py                   |  140 +-
 gently/analysis/steps.py                      |  196 ++-
 gently/app/agent.py                           |  504 +++---
 gently/app/benchmark.py                       |  113 +-
 gently/app/bottom_camera_monitor.py           |   11 +-
 gently/app/calibration/__init__.py            |    2 +-
 gently/app/calibration/base.py                |   19 +-
 gently/app/calibration/edge_roi.py            |   18 +-
 gently/app/calibration/registry.py            |    9 +-
 gently/app/calibration/two_point.py           |   10 +-
 gently/app/detectors/__init__.py              |    2 +-
 gently/app/detectors/base.py                  |   19 +-
 gently/app/detectors/blank_image.py           |   81 +-
 gently/app/detectors/dopaminergic_signal.py   |  141 +-
 gently/app/detectors/hatching.py              |   49 +-
 gently/app/detectors/perception_proxy.py      |   10 +-
 gently/app/detectors/registry.py              |   13 +-
 gently/app/developmental_tracker.py           |    6 +-
 gently/app/device_state_monitor.py            |   20 +-
 gently/app/orchestration/exclusive.py         |  140 +-
 gently/app/orchestration/monitoring_modes.py  |   19 +-
 gently/app/orchestration/timelapse.py         |  869 ++++++----
 gently/app/orchestration/timelapse_models.py  |  177 +-
 gently/app/queue_server_client.py             |    9 +-
 gently/app/theme.py                           |    6 +-
 gently/app/tools/__init__.py                  |   94 +-
 gently/app/tools/acquisition_tools.py         |  241 +--
 gently/app/tools/analysis_tools.py            |   33 +-
 gently/app/tools/calibration_tools.py         |  663 ++++----
 gently/app/tools/detection_tools.py           |  225 +--
 gently/app/tools/experiment_tools.py          |  201 ++-
 gently/app/tools/focus_tools.py               |  108 +-
 gently/app/tools/hardware_common.py           |    1 +
 gently/app/tools/interaction_tools.py         |   77 +-
 gently/app/tools/led_tools.py                 |   34 +-
 gently/app/tools/light_source_tools.py        |   30 +-
 gently/app/tools/memory_tools.py              |   17 +-
 gently/app/tools/plan_execution_tools.py      |   33 +-
 gently/app/tools/resolution_tools.py          |   83 +-
 gently/app/tools/session_tools.py             |  157 +-
 gently/app/tools/stage_tools.py               |   44 +-
 gently/app/tools/temperature_tools.py         |   29 +-
 gently/app/tools/timelapse_tools.py           |  271 +--
 gently/app/tools/volume_tools.py              |  146 +-
 gently/app/video_maker.py                     |   68 +-
 gently/app/wake_router.py                     |   54 +-
 gently/core/__init__.py                       |   45 +-
 gently/core/coordinates.py                    |   21 +-
 gently/core/database.py                       |  153 +-
 gently/core/event_bus.py                      |  141 +-
 gently/core/file_store.py                     |  174 +-
 gently/core/gently_manifest.py                |   18 +-
 gently/core/imaging.py                        |   52 +-
 gently/core/log_bridge.py                     |   40 +-
 gently/core/service.py                        |  111 +-
 gently/core/store.py                          |  237 ++-
 gently/core/store_types.py                    |   67 +-
 gently/dataset/__init__.py                    |   10 +-
 gently/dataset/aggregator.py                  |  343 ++--
 gently/dataset/cli.py                         |   31 +-
 gently/dataset/embryo_dataset.py              |  447 +++--
 gently/dataset/explorer_server.py             |  347 ++--
 gently/dataset/schema.py                      |   42 +-
 gently/detection.py                           |   80 +-
 gently/eval/__init__.py                       |    6 +-
 gently/eval/candidates.py                     |   83 +-
 gently/eval/decision_log.py                   |   42 +-
 gently/eval/event_capture.py                  |   12 +-
 gently/eval/event_replay.py                   |   20 +-
 gently/eval/shadow.py                         |   84 +-
 gently/exceptions.py                          |   39 +
 gently/gently.py                              |   81 +-
 gently/hardware/__init__.py                   |   12 +-
 gently/hardware/console_ui.py                 |    8 +-
 gently/hardware/dispim/__init__.py            |   16 +-
 gently/hardware/dispim/calibration.py         |   72 +-
 gently/hardware/dispim/claude_client.py       |  260 +--
 gently/hardware/dispim/client.py              |  582 ++++---
 gently/hardware/dispim/config.py              |  100 +-
 gently/hardware/dispim/device_factory.py      |   99 +-
 gently/hardware/dispim/device_layer.py        | 1493 ++++++++++-------
 gently/hardware/dispim/devices/__init__.py    |   24 +-
 gently/hardware/dispim/devices/acquisition.py |   97 +-
 gently/hardware/dispim/devices/camera.py      |   77 +-
 gently/hardware/dispim/devices/optical.py     |   51 +-
 gently/hardware/dispim/devices/piezo.py       |   62 +-
 gently/hardware/dispim/devices/scanner.py     |  134 +-
 gently/hardware/dispim/devices/stage.py       |   85 +-
 gently/hardware/dispim/devices/system.py      |    6 +-
 .../hardware/dispim/devices/test_temp_usb.py  |   42 +-
 .../devices/test_temperature_controller.py    |   49 +-
 gently/hardware/dispim/plans/acquisition.py   |  580 ++++---
 gently/hardware/dispim/plans/calibration.py   |  395 +++--
 gently/hardware/dispim/plans/multi_embryo.py  |  177 +-
 gently/hardware/dispim/sam_detection.py       |  467 +++---
 gently/hardware/switchbot.py                  |   49 +-
 gently/hardware/temperature.py                |   47 +-
 gently/harness/bridge.py                      | 1246 ++++++++------
 gently/harness/commands.py                    |  824 +++++----
 gently/harness/conversation.py                |  351 ++--
 gently/harness/detection/detector.py          |  265 +--
 gently/harness/detection/queue.py             |  111 +-
 gently/harness/detection/registry.py          |   72 +-
 gently/harness/detection/verifier.py          |  581 ++++---
 gently/harness/error_log.py                   |   22 +-
 gently/harness/memory/__init__.py             |   53 +-
 gently/harness/memory/_intentions.py          |  210 +--
 gently/harness/memory/_ml_pipelines.py        |  104 +-
 gently/harness/memory/_plans.py               |  225 +--
 gently/harness/memory/_understanding.py       |   57 +-
 gently/harness/memory/file_store.py           |  759 +++++----
 gently/harness/memory/gap_assessment.py       |  119 +-
 gently/harness/memory/interface.py            |   84 +-
 gently/harness/memory/model.py                |  248 +--
 gently/harness/memory/onboarding.py           |  232 +--
 gently/harness/memory/serialization.py        |   83 +-
 gently/harness/memory/startup_wizard.py       |   78 +-
 gently/harness/memory/store.py                |   19 +-
 gently/harness/microscope.py                  |   35 +-
 .../harness/orchestration/plan_synthesis.py   |  108 +-
 gently/harness/plan_mode/prompt.py            |   11 +-
 gently/harness/plan_mode/tools/__init__.py    |    8 +-
 gently/harness/plan_mode/tools/lab_context.py |   20 +-
 gently/harness/plan_mode/tools/planning.py    |  134 +-
 gently/harness/plan_mode/tools/research.py    |  288 ++--
 gently/harness/plan_mode/tools/templates.py   |   12 +-
 gently/harness/plan_mode/tools/validation.py  |   91 +-
 gently/harness/prompts/manager.py             |  183 +-
 gently/harness/prompts/templates.py           |   88 +-
 gently/harness/protocols.py                   |   12 +-
 gently/harness/resolution_mode/prompt.py      |    9 +-
 gently/harness/roles.py                       |   15 +-
 gently/harness/session/interaction_logger.py  |  118 +-
 gently/harness/session/manager.py             |  122 +-
 gently/harness/session/timeline.py            |  279 +--
 gently/harness/state.py                       |  424 ++---
 gently/harness/tools/helpers.py               |   59 +-
 gently/harness/tools/registry.py              |  163 +-
 gently/log_config.py                          |   16 +-
 gently/mesh/audit.py                          |    4 +-
 gently/mesh/capability_provider.py            |   65 +-
 gently/mesh/discovery.py                      |   37 +-
 gently/mesh/mesh_service.py                   |  110 +-
 gently/mesh/models.py                         |   43 +-
 gently/mesh/pairing.py                        |   71 +-
 gently/mesh/peer_client.py                    |  119 +-
 gently/mesh/routes.py                         |  265 +--
 gently/mesh/tls.py                            |   37 +-
 gently/mesh/transfer/__init__.py              |    8 +-
 gently/mesh/transfer/client.py                |   10 +-
 gently/mesh/transfer/models.py                |   22 +-
 gently/mesh/transfer/protocol.py              |    5 +-
 gently/mesh/transfer/server.py                |    5 +-
 gently/mesh/transfer/tracker.py               |   16 +-
 gently/mesh/verse_map.py                      |   32 +-
 gently/ml/__init__.py                         |    2 +-
 gently/ml/_train_worker.py                    |   52 +-
 gently/ml/architectures.py                    |    6 +-
 gently/ml/data_loader.py                      |   36 +-
 gently/ml/evaluation.py                       |   21 +-
 gently/ml/federated.py                        |   59 +-
 gently/ml/models.py                           |   55 +-
 gently/ml/trainer.py                          |   18 +-
 gently/organisms/__init__.py                  |   12 +-
 gently/organisms/celegans/__init__.py         |   42 +-
 gently/organisms/celegans/biology.py          |    3 +-
 gently/organisms/celegans/detector_presets.py |   84 +-
 .../celegans/developmental_tracker.py         |  236 +--
 .../organisms/celegans/perception_prompt.py   |   32 +-
 gently/organisms/celegans/stages.py           |   45 +-
 gently/settings.py                            |   22 +-
 gently/ui/web/__init__.py                     |   15 +-
 gently/ui/web/accounts.py                     |   25 +-
 gently/ui/web/auth.py                         |   15 +-
 gently/ui/web/connection_manager.py           |   84 +-
 gently/ui/web/embryo_marker.py                |   55 +-
 gently/ui/web/image_store.py                  |   60 +-
 gently/ui/web/models.py                       |   72 +-
 gently/ui/web/plots.py                        |  143 +-
 gently/ui/web/routes/__init__.py              |   14 +-
 gently/ui/web/routes/agent_ws.py              |  485 ++++--
 gently/ui/web/routes/auth_routes.py           |   31 +-
 gently/ui/web/routes/campaigns.py             |  108 +-
 gently/ui/web/routes/chat.py                  |   28 +-
 gently/ui/web/routes/data.py                  |  196 +--
 gently/ui/web/routes/experiments.py           |    2 +-
 gently/ui/web/routes/images.py                |   47 +-
 gently/ui/web/routes/pages.py                 |    4 +-
 gently/ui/web/routes/sessions.py              |   65 +-
 gently/ui/web/routes/volumes.py               |  120 +-
 gently/ui/web/routes/websocket.py             |   88 +-
 gently/ui/web/server.py                       |  314 ++--
 gently/ui/web/strategy_snapshot.py            |  310 ++--
 gently/ui/web/timelapse_tracker.py            |  177 +-
 gently/ui/web/volume_helpers.py               |   11 +-
 launch_gently.py                              |  172 +-
 pyproject.toml                                |    9 +
 scripts/auto_label_examples.py                |  123 +-
 scripts/contrast_variants.py                  |   25 +-
 scripts/dry_run_dopaminergic_detector.py      |   39 +-
 scripts/dump_perceiver_input.py               |    2 +-
 scripts/extract_stage_examples.py             |  165 +-
 scripts/gemini_stage_test.py                  |  218 ++-
 scripts/generate_examples.py                  |   66 +-
 scripts/launch_viz_server.py                  |   52 +-
 scripts/projection_explorer.py                |  350 ++--
 scripts/recreate_session_videos.py            |  675 +++++---
 scripts/regenerate_examples_three_view.py     |   15 +-
 scripts/regenerate_projections.py             |    7 +-
 scripts/replay_session.py                     |   10 +-
 scripts/stage_annotator.py                    |  101 +-
 scripts/view_examples.py                      |   35 +-
 scripts/watch_callbacks.py                    |   14 +-
 scripts/watch_devices.py                      |   27 +-
 scripts/watch_position.py                     |   19 +-
 start_device_layer.py                         |   39 +-
 tests/conftest.py                             |    5 +-
 tests/test_analysis_core.py                   |   24 +-
 tests/test_campaign_coordination.py           |  145 +-
 tests/test_capability_provider.py             |    3 +-
 tests/test_context_store.py                   |   92 +-
 tests/test_coordinates.py                     |   53 +-
 tests/test_data_catalog.py                    |    5 +-
 tests/test_database_utils.py                  |   45 +-
 tests/test_detector.py                        |   64 +-
 tests/test_device_state_monitor.py            |   76 +-
 tests/test_dispim_device_safety.py            |  203 ++-
 tests/test_eval.py                            |  291 ++--
 tests/test_event_bus.py                       |    9 +-
 tests/test_federated.py                       |   30 +-
 tests/test_gently_store.py                    |   54 +-
 tests/test_harness_state.py                   |  131 +-
 tests/test_log_bridge.py                      |    9 +-
 tests/test_mesh_models.py                     |   53 +-
 tests/test_mesh_pairing.py                    |   54 +-
 tests/test_mesh_service.py                    |    6 +-
 tests/test_ml_architectures.py                |   16 +-
 tests/test_ml_data_loader.py                  |   38 +-
 tests/test_ml_models.py                       |   29 +-
 tests/test_ml_pipeline_mixin.py               |   24 +-
 tests/test_prompt_manager.py                  |   73 +-
 tests/test_session_manager.py                 |   55 +-
 tests/test_stages.py                          |   14 +-
 tests/test_text_tool_call_extraction.py       |   27 +-
 tests/test_tool_helpers.py                    |   27 +-
 tests/test_tool_registry.py                   |   15 +-
 tests/test_transfer_protocol.py               |   23 +-
 tests/test_transfer_service.py                |   74 +-
 tests/test_verse_map.py                       |   27 +-
 tests/validate_recursive_autofocus.py         |   41 +-
 286 files changed, 18719 insertions(+), 13461 deletions(-)
 create mode 100644 .github/workflows/lint.yml
 create mode 100644 .pre-commit-config.yaml
 create mode 100644 CONTRIBUTING.md

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
new file mode 100644
index 00000000..5a92ceac
--- /dev/null
+++ b/.github/workflows/lint.yml
@@ -0,0 +1,26 @@
+name: Lint
+
+on:
+  push:
+    branches: [main, development]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: ruff check
+        run: ruff check .
+
+      - name: ruff format check
+        run: ruff format --check .
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
new file mode 100644
index 00000000..7b184093
--- /dev/null
+++ b/.pre-commit-config.yaml
@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.17  # run `pre-commit autoupdate` to pin to latest
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..7e75550a
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,51 @@
+# Contributing to Gently
+
+## Code quality toolchain
+
+This project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting, and [pre-commit](https://pre-commit.com/) to enforce this automatically before every commit.
+
+> **Note:** Type checking with mypy is not yet enforced. See the tracking issue for gradually
+> introducing mypy across the codebase.
+
+### First-time setup
+
+Install the dev dependencies (includes ruff and pre-commit):
+
+```bash
+uv sync
+```
+
+Then install the pre-commit hooks:
+
+```bash
+pre-commit install
+```
+
+From this point on, ruff runs automatically on staged files whenever you `git commit`.
+
+### Running manually
+
+To check all files at once (useful before opening a PR):
+
+```bash
+pre-commit run --all-files
+```
+
+Or run the tools directly:
+
+```bash
+ruff check .          # lint
+ruff format .         # format in-place
+```
+
+### Keeping hooks up to date
+
+To update hook versions to their latest releases:
+
+```bash
+pre-commit autoupdate
+```
+
+### CI
+
+Every pull request runs the lint job (`.github/workflows/lint.yml`), which checks ruff lint and formatting across the entire project. Fix any failures locally with `pre-commit run --all-files` before pushing.
diff --git a/benchmarks/agent/evaluator.py b/benchmarks/agent/evaluator.py
index 190b2c8b..3442e79f 100644
--- a/benchmarks/agent/evaluator.py
+++ b/benchmarks/agent/evaluator.py
@@ -9,7 +9,7 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Union
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -17,17 +17,18 @@
 @dataclass
 class EvalResult:
     """Result of evaluating a single test case"""
+
     test_id: str
     query: str
-    expected_tool: Union[str, List[str]]
-    actual_tool: Optional[str]
+    expected_tool: str | list[str]
+    actual_tool: str | None
     tool_correct: bool
     params_correct: bool
-    param_errors: List[str] = field(default_factory=list)
+    param_errors: list[str] = field(default_factory=list)
     input_tokens: int = 0
     output_tokens: int = 0
     latency_ms: float = 0
-    error: Optional[str] = None
+    error: str | None = None
 
     @property
     def passed(self) -> bool:
@@ -37,6 +38,7 @@ def passed(self) -> bool:
 @dataclass
 class BenchmarkReport:
     """Summary report for a benchmark run"""
+
     timestamp: str
     num_cases: int
     num_passed: int
@@ -45,10 +47,10 @@ class BenchmarkReport:
     total_input_tokens: int
     total_output_tokens: int
     avg_latency_ms: float
-    results: List[EvalResult]
-    metadata: Dict[str, Any] = field(default_factory=dict)
+    results: list[EvalResult]
+    metadata: dict[str, Any] = field(default_factory=dict)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         return {
             "timestamp": self.timestamp,
             "summary": {
@@ -61,7 +63,10 @@ def to_dict(self) -> Dict:
             "tokens": {
                 "total_input": self.total_input_tokens,
                 "total_output": self.total_output_tokens,
-                "avg_per_query": (self.total_input_tokens + self.total_output_tokens) / self.num_cases if self.num_cases > 0 else 0,
+                "avg_per_query": (self.total_input_tokens + self.total_output_tokens)
+                / self.num_cases
+                if self.num_cases > 0
+                else 0,
             },
             "latency": {
                 "avg_ms": self.avg_latency_ms,
@@ -92,7 +97,7 @@ class AgentEvaluator:
         print(f"Tool accuracy: {report.tool_accuracy:.1%}")
     """
 
-    def __init__(self, test_cases_path: Optional[Path] = None):
+    def __init__(self, test_cases_path: Path | None = None):
         """
         Parameters
         ----------
@@ -111,8 +116,8 @@ def __init__(self, test_cases_path: Optional[Path] = None):
     async def run_benchmark(
         self,
         agent,
-        tags: Optional[List[str]] = None,
-        max_cases: Optional[int] = None,
+        tags: list[str] | None = None,
+        max_cases: int | None = None,
     ) -> BenchmarkReport:
         """
         Run benchmark against agent
@@ -162,7 +167,7 @@ async def run_benchmark(
             metadata={"version": self.version, "tags": tags},
         )
 
-    async def _evaluate_case(self, agent, case: Dict) -> EvalResult:
+    async def _evaluate_case(self, agent, case: dict) -> EvalResult:
         """Evaluate a single test case"""
         test_id = case["id"]
         query = case["query"]
@@ -172,6 +177,7 @@ async def _evaluate_case(self, agent, case: Dict) -> EvalResult:
         try:
             # Get tool call from agent (without executing)
             import time
+
             start = time.perf_counter()
 
             tool_call = await self._get_tool_call(agent, query)
@@ -211,7 +217,9 @@ async def _evaluate_case(self, agent, case: Dict) -> EvalResult:
                 elif key not in actual_params:
                     param_errors.append(f"missing param: {key}")
                 elif actual_params[key] != expected_value:
-                    param_errors.append(f"{key}: expected {expected_value}, got {actual_params[key]}")
+                    param_errors.append(
+                        f"{key}: expected {expected_value}, got {actual_params[key]}"
+                    )
 
             return EvalResult(
                 test_id=test_id,
@@ -238,7 +246,7 @@ async def _evaluate_case(self, agent, case: Dict) -> EvalResult:
                 error=str(e),
             )
 
-    async def _get_tool_call(self, agent, query: str) -> Optional[Dict]:
+    async def _get_tool_call(self, agent, query: str) -> dict | None:
         """
         Get the tool call Claude would make for a query
 
@@ -248,7 +256,7 @@ async def _get_tool_call(self, agent, query: str) -> Optional[Dict]:
         return await agent.get_tool_call(query)
 
 
-def compare_reports(before: BenchmarkReport, after: BenchmarkReport) -> Dict:
+def compare_reports(before: BenchmarkReport, after: BenchmarkReport) -> dict:
     """
     Compare two benchmark reports
 
@@ -271,8 +279,8 @@ def compare_reports(before: BenchmarkReport, after: BenchmarkReport) -> Dict:
         "tokens": {
             "before": before.total_input_tokens + before.total_output_tokens,
             "after": after.total_input_tokens + after.total_output_tokens,
-            "delta": (after.total_input_tokens + after.total_output_tokens) -
-                     (before.total_input_tokens + before.total_output_tokens),
+            "delta": (after.total_input_tokens + after.total_output_tokens)
+            - (before.total_input_tokens + before.total_output_tokens),
         },
         "latency_ms": {
             "before": before.avg_latency_ms,
@@ -280,11 +288,13 @@ def compare_reports(before: BenchmarkReport, after: BenchmarkReport) -> Dict:
             "delta": after.avg_latency_ms - before.avg_latency_ms,
         },
         "regressions": [
-            r.test_id for r in after.results
+            r.test_id
+            for r in after.results
             if not r.passed and any(br.test_id == r.test_id and br.passed for br in before.results)
         ],
         "improvements": [
-            r.test_id for r in after.results
+            r.test_id
+            for r in after.results
             if r.passed and any(br.test_id == r.test_id and not br.passed for br in before.results)
         ],
     }
diff --git a/benchmarks/perception/__init__.py b/benchmarks/perception/__init__.py
index c811d881..f26bbea4 100644
--- a/benchmarks/perception/__init__.py
+++ b/benchmarks/perception/__init__.py
@@ -5,9 +5,9 @@
 """
 
 from .ground_truth import GroundTruth
-from .testset import OfflineTestset, TestCase
-from .runner import PerceptionBenchmark, BenchmarkConfig, EmbryoResult
 from .metrics import PerceptionMetrics
+from .runner import BenchmarkConfig, EmbryoResult, PerceptionBenchmark
+from .testset import OfflineTestset, TestCase
 
 __all__ = [
     "GroundTruth",
diff --git a/benchmarks/perception/ground_truth.py b/benchmarks/perception/ground_truth.py
index d3ce2a0a..71187596 100644
--- a/benchmarks/perception/ground_truth.py
+++ b/benchmarks/perception/ground_truth.py
@@ -7,11 +7,18 @@
 import json
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Dict, List, Optional
-
 
 # Stage progression order
-STAGE_ORDER = ["early", "bean", "comma", "1.5fold", "2fold", "pretzel", "hatching", "hatched"]
+STAGE_ORDER = [
+    "early",
+    "bean",
+    "comma",
+    "1.5fold",
+    "2fold",
+    "pretzel",
+    "hatching",
+    "hatched",
+]
 
 
 @dataclass
@@ -24,14 +31,14 @@ class GroundTruth:
     """
 
     # {embryo_id: {stage: start_timepoint}}
-    transitions: Dict[str, Dict[str, int]] = field(default_factory=dict)
+    transitions: dict[str, dict[str, int]] = field(default_factory=dict)
 
     # Metadata
-    session_id: Optional[str] = None
-    annotator: Optional[str] = None
-    notes: Optional[str] = None
+    session_id: str | None = None
+    annotator: str | None = None
+    notes: str | None = None
 
-    def get_stage_at(self, embryo_id: str, timepoint: int) -> Optional[str]:
+    def get_stage_at(self, embryo_id: str, timepoint: int) -> str | None:
         """
         Get the ground truth stage for a given embryo at a given timepoint.
 
@@ -63,15 +70,13 @@ def get_stage_at(self, embryo_id: str, timepoint: int) -> Optional[str]:
 
         return current_stage
 
-    def get_transition_timepoint(
-        self, embryo_id: str, stage: str
-    ) -> Optional[int]:
+    def get_transition_timepoint(self, embryo_id: str, stage: str) -> int | None:
         """Get the timepoint when a stage starts for a given embryo."""
         if embryo_id not in self.transitions:
             return None
         return self.transitions[embryo_id].get(stage)
 
-    def get_stages_for_embryo(self, embryo_id: str) -> List[str]:
+    def get_stages_for_embryo(self, embryo_id: str) -> list[str]:
         """Get list of stages (in order) for a given embryo."""
         if embryo_id not in self.transitions:
             return []
@@ -79,10 +84,7 @@ def get_stages_for_embryo(self, embryo_id: str) -> List[str]:
         embryo_transitions = self.transitions[embryo_id]
 
         # Sort by start timepoint
-        sorted_stages = sorted(
-            embryo_transitions.keys(),
-            key=lambda s: embryo_transitions[s]
-        )
+        sorted_stages = sorted(embryo_transitions.keys(), key=lambda s: embryo_transitions[s])
         return sorted_stages
 
     def get_timepoint_range(self, embryo_id: str) -> tuple:
@@ -101,11 +103,11 @@ def get_timepoint_range(self, embryo_id: str) -> tuple:
         return (min(starts), max(starts))
 
     @property
-    def embryo_ids(self) -> List[str]:
+    def embryo_ids(self) -> list[str]:
         """Get list of all embryo IDs with ground truth."""
         return list(self.transitions.keys())
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize to dictionary for JSON storage."""
         return {
             "session_id": self.session_id,
@@ -115,7 +117,7 @@ def to_dict(self) -> Dict:
         }
 
     @classmethod
-    def from_dict(cls, data: Dict) -> "GroundTruth":
+    def from_dict(cls, data: dict) -> "GroundTruth":
         """Load from dictionary."""
         return cls(
             transitions=data.get("transitions", {}),
@@ -127,7 +129,7 @@ def from_dict(cls, data: Dict) -> "GroundTruth":
     @classmethod
     def from_json(cls, path: Path) -> "GroundTruth":
         """Load ground truth from JSON file."""
-        with open(path, "r") as f:
+        with open(path) as f:
             data = json.load(f)
         return cls.from_dict(data)
 
@@ -139,9 +141,9 @@ def save_json(self, path: Path) -> None:
 
 
 def create_ground_truth_from_email_format(
-    annotations: Dict[str, str],
-    session_id: Optional[str] = None,
-    annotator: Optional[str] = None,
+    annotations: dict[str, str],
+    session_id: str | None = None,
+    annotator: str | None = None,
 ) -> GroundTruth:
     """
     Create GroundTruth from email-style annotations.
diff --git a/benchmarks/perception/live_viewer.py b/benchmarks/perception/live_viewer.py
index a6ea2456..7b0f7af7 100644
--- a/benchmarks/perception/live_viewer.py
+++ b/benchmarks/perception/live_viewer.py
@@ -13,22 +13,19 @@
 
 import argparse
 import asyncio
-import base64
 import json
 import logging
 import sys
 import webbrowser
-from dataclasses import asdict
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 # FastAPI and websockets
 try:
+    import uvicorn
     from fastapi import FastAPI, WebSocket, WebSocketDisconnect
     from fastapi.responses import HTMLResponse
-    from fastapi.staticfiles import StaticFiles
-    import uvicorn
 except ImportError:
     print("Please install: pip install fastapi uvicorn websockets")
     sys.exit(1)
@@ -39,8 +36,8 @@
 logger = logging.getLogger(__name__)
 
 # Global state for websocket connections
-connected_clients: List[WebSocket] = []
-benchmark_state: Dict[str, Any] = {
+connected_clients: list[WebSocket] = []
+benchmark_state: dict[str, Any] = {
     "status": "idle",
     "current_embryo": None,
     "current_timepoint": None,
@@ -52,7 +49,7 @@
 pause_event: asyncio.Event = None  # Will be initialized on startup
 
 
-async def broadcast(message: Dict):
+async def broadcast(message: dict):
     """Broadcast message to all connected clients."""
     if not connected_clients:
         return
@@ -396,7 +393,10 @@ async def broadcast(message: Dict):
     <div class="header">
         <h1>Perception Benchmark Live Viewer</h1>
         <div style="display: flex; align-items: center; gap: 15px;">
-            <button id="pause-btn" onclick="togglePause()" style="padding: 8px 16px; font-size: 0.9em; cursor: pointer; background: #4caf50; color: white; border: none; border-radius: 4px;">⏸ Pause</button>
+            <button id="pause-btn" onclick="togglePause()"
+              style="padding: 8px 16px; font-size: 0.9em; cursor: pointer;
+                     background: #4caf50; color: white; border: none;
+                     border-radius: 4px;">⏸ Pause</button>
             <div id="status" class="status idle">Connecting...</div>
         </div>
     </div>
@@ -555,8 +555,10 @@ async def broadcast(message: Dict):
                 // Display three-view combined image (XY+YZ+XZ orthogonal projections)
                 container.innerHTML = `
                     <div style="text-align: center;">
-                        <div style="color: #888; font-size: 12px; margin-bottom: 4px;">THREE-VIEW (XY | YZ / XZ)</div>
-                        <img src="data:image/jpeg;base64,${imgData.combined}" alt="Three-View T${timepoint}" style="max-height: 450px;">
+                        <div style="color: #888; font-size: 12px; margin-bottom: 4px;">
+                          THREE-VIEW (XY | YZ / XZ)</div>
+                        <img src="data:image/jpeg;base64,${imgData.combined}"
+                          alt="Three-View T${timepoint}" style="max-height: 450px;">
                     </div>`;
                 // Also get embryoId and groundTruth from stored data if not provided
                 embryoId = embryoId || imgData.embryoId;
@@ -628,10 +630,13 @@ async def broadcast(message: Dict):
 
             // Update header
             document.querySelector('.trace-section h2').innerHTML =
-                `Reasoning Trace - T${timepoint} <button onclick="clearSelection()" style="float:right;font-size:0.8em;padding:2px 8px;cursor:pointer;">Show Live</button>`;
+                `Reasoning Trace - T${timepoint} <button onclick="clearSelection()"
+                  style="float:right;font-size:0.8em;padding:2px 8px;
+                         cursor:pointer;">Show Live</button>`;
 
             if (traceSteps.length === 0) {
-                list.innerHTML = '<div class="no-data">No trace recorded for T' + timepoint + '</div>';
+                list.innerHTML = '<div class="no-data">No trace recorded for T'
+                    + timepoint + '</div>';
                 return;
             }
 
@@ -685,12 +690,16 @@ async def broadcast(message: Dict):
                     '<span class="verification-badge">verified</span>' : '';
 
                 html += `
-                    <div class="prediction-row ${rowClass}" onclick="selectTimepoint(${pred.timepoint})" style="cursor:pointer;">
+                    <div class="prediction-row ${rowClass}"
+                      onclick="selectTimepoint(${pred.timepoint})" style="cursor:pointer;">
                         <div>T${pred.timepoint}</div>
-                        <div><span class="stage-badge stage-${pred.predicted}">${pred.predicted}</span></div>
-                        <div><span class="stage-badge stage-${pred.ground_truth}">${pred.ground_truth}</span></div>
+                        <div><span class="stage-badge stage-${pred.predicted}"
+                          >${pred.predicted}</span></div>
+                        <div><span class="stage-badge stage-${pred.ground_truth}"
+                          >${pred.ground_truth}</span></div>
                         <div>${(pred.confidence * 100).toFixed(0)}%</div>
-                        <div>${pred.phase_count > 1 ? pred.phase_count + '-phase' : ''}${verifiedBadge}</div>
+                        <div>${pred.phase_count > 1
+                          ? pred.phase_count + '-phase' : ''}${verifiedBadge}</div>
                     </div>
                 `;
             }
@@ -749,10 +758,14 @@ async def websocket_endpoint(websocket: WebSocket):
     connected_clients.append(websocket)
 
     # Send current state
-    await websocket.send_text(json.dumps({
-        "type": "status",
-        "status": benchmark_state["status"],
-    }))
+    await websocket.send_text(
+        json.dumps(
+            {
+                "type": "status",
+                "status": benchmark_state["status"],
+            }
+        )
+    )
 
     try:
         while True:
@@ -789,8 +802,8 @@ def __init__(
         embryo_id: str,
         enable_verification: bool = True,
         start_timepoint: int = 0,
-        max_timepoints: Optional[int] = None,
-        trace_dir: Optional[Path] = None,
+        max_timepoints: int | None = None,
+        trace_dir: Path | None = None,
     ):
         self.testset = testset
         self.embryo_id = embryo_id
@@ -798,7 +811,7 @@ def __init__(
         self.start_timepoint = start_timepoint
         self.max_timepoints = max_timepoints
 
-        self.predictions: List[Dict] = []
+        self.predictions: list[dict] = []
         self.correct_count = 0
         self.adjacent_count = 0
         self.verified_count = 0
@@ -808,7 +821,7 @@ def __init__(
         self.trace_dir = trace_dir or Path("benchmarks/results/traces")
         self.run_dir = self.trace_dir / f"{self.run_id}_{embryo_id}"
         self.run_dir.mkdir(parents=True, exist_ok=True)
-        self.traces: Dict[int, List[Dict]] = {}  # timepoint -> trace steps
+        self.traces: dict[int, list[dict]] = {}  # timepoint -> trace steps
 
         logger.info(f"Trace persistence enabled: {self.run_dir}")
 
@@ -861,23 +874,23 @@ async def run(self):
             benchmark_state["current_timepoint"] = test_case.timepoint
 
             # Send image(s)
-            await broadcast({
-                "type": "image",
-                "embryo_id": self.embryo_id,
-                "timepoint": test_case.timepoint,
-                "ground_truth": test_case.ground_truth_stage,
-                "image": test_case.image_b64,  # Combined for backward compat
-                "top_image": test_case.top_image_b64,
-                "side_image": test_case.side_image_b64,
-            })
+            await broadcast(
+                {
+                    "type": "image",
+                    "embryo_id": self.embryo_id,
+                    "timepoint": test_case.timepoint,
+                    "ground_truth": test_case.ground_truth_stage,
+                    "image": test_case.image_b64,  # Combined for backward compat
+                    "top_image": test_case.top_image_b64,
+                    "side_image": test_case.side_image_b64,
+                }
+            )
 
             # Clear trace for new prediction
             await broadcast({"type": "clear_trace"})
 
             # Run perception with trace streaming
-            result = await self._run_perception_with_streaming(
-                engine, session, test_case
-            )
+            result = await self._run_perception_with_streaming(engine, session, test_case)
 
             # Check accuracy
             is_correct = result.stage == test_case.ground_truth_stage
@@ -915,23 +928,29 @@ async def run(self):
             await broadcast(pred_msg)
 
             # Save trace for this timepoint
-            self._save_timepoint_trace(test_case.timepoint, result, test_case, is_correct, is_adjacent)
+            self._save_timepoint_trace(
+                test_case.timepoint, result, test_case, is_correct, is_adjacent
+            )
 
             # Send updated stats
             total = len(self.predictions)
-            await broadcast({
-                "type": "stats",
-                "accuracy": self.correct_count / total if total > 0 else None,
-                "adjacent": self.adjacent_count / total if total > 0 else None,
-                "total": total,
-                "verified": self.verified_count,
-            })
+            await broadcast(
+                {
+                    "type": "stats",
+                    "accuracy": self.correct_count / total if total > 0 else None,
+                    "adjacent": self.adjacent_count / total if total > 0 else None,
+                    "total": total,
+                    "verified": self.verified_count,
+                }
+            )
 
             # Add observation to session with simulated timestamp
             # Typical diSPIM acquisition interval is ~4 minutes per timepoint
-            simulated_timestamp = datetime.now() - timedelta(
-                minutes=(self.max_timepoints or 100) * 4
-            ) + timedelta(minutes=test_case.timepoint * 4)
+            simulated_timestamp = (
+                datetime.now()
+                - timedelta(minutes=(self.max_timepoints or 100) * 4)
+                + timedelta(minutes=test_case.timepoint * 4)
+            )
 
             session.add_observation(
                 timepoint=test_case.timepoint,
@@ -953,7 +972,6 @@ async def run(self):
 
     async def _run_perception_with_streaming(self, engine, session, test_case):
         """Run perception and stream trace steps."""
-        from gently.harness.perception.session import ReasoningStep
 
         # We need to hook into the reasoning trace
         # For now, run perception and stream the trace after
@@ -985,7 +1003,9 @@ async def _run_perception_with_streaming(self, engine, session, test_case):
 
         return result
 
-    def _save_timepoint_trace(self, timepoint: int, result, test_case, is_correct: bool, is_adjacent: bool):
+    def _save_timepoint_trace(
+        self, timepoint: int, result, test_case, is_correct: bool, is_adjacent: bool
+    ):
         """Save trace for a single timepoint to disk."""
         trace_data = {
             "timepoint": timepoint,
@@ -1035,7 +1055,7 @@ async def run_benchmark_background(
     embryo_id: str,
     enable_verification: bool,
     start_timepoint: int = 0,
-    max_timepoints: Optional[int] = None,
+    max_timepoints: int | None = None,
 ):
     """Run benchmark in background after server starts."""
     print("[DEBUG] run_benchmark_background starting", flush=True)
@@ -1049,7 +1069,10 @@ async def run_benchmark_background(
 
         # Load data
         ground_truth = GroundTruth.from_json(ground_truth_path)
-        print(f"[DEBUG] Loaded ground truth: {len(ground_truth.transitions)} embryos", flush=True)
+        print(
+            f"[DEBUG] Loaded ground truth: {len(ground_truth.transitions)} embryos",
+            flush=True,
+        )
         testset = OfflineTestset(
             session_path=session_path,
             ground_truth=ground_truth,
@@ -1071,6 +1094,7 @@ async def run_benchmark_background(
     except Exception as e:
         print(f"[DEBUG] ERROR in run_benchmark_background: {e}", flush=True)
         import traceback
+
         traceback.print_exc()
 
 
@@ -1142,9 +1166,9 @@ def main():
     trace_dir = Path("benchmarks/results/traces")
     run_id = datetime.now().strftime("%Y%m%d_%H%M%S")
 
-    print(f"\n{'='*60}")
+    print(f"\n{'=' * 60}")
     print("Perception Benchmark Live Viewer")
-    print(f"{'='*60}")
+    print(f"{'=' * 60}")
     print(f"Session: {session_path}")
     print(f"Embryo: {args.embryo}")
     print(f"Start timepoint: T{args.start_timepoint}")
@@ -1152,7 +1176,7 @@ def main():
     print(f"Verification: {'disabled' if args.no_verification else 'enabled'}")
     print(f"Traces: {trace_dir / f'{run_id}_{args.embryo}'}")
     print(f"URL: http://localhost:{args.port}")
-    print(f"{'='*60}\n")
+    print(f"{'=' * 60}\n")
 
     # Open browser
     if not args.no_browser:
@@ -1162,14 +1186,16 @@ def main():
     @app.on_event("startup")
     async def startup_event():
         print("[DEBUG] Startup event fired", flush=True)
-        asyncio.create_task(run_benchmark_background(
-            session_path=session_path,
-            ground_truth_path=gt_path,
-            embryo_id=args.embryo,
-            enable_verification=not args.no_verification,
-            start_timepoint=args.start_timepoint,
-            max_timepoints=args.max_timepoints,
-        ))
+        asyncio.create_task(
+            run_benchmark_background(
+                session_path=session_path,
+                ground_truth_path=gt_path,
+                embryo_id=args.embryo,
+                enable_verification=not args.no_verification,
+                start_timepoint=args.start_timepoint,
+                max_timepoints=args.max_timepoints,
+            )
+        )
         print("[DEBUG] Background task created", flush=True)
 
     # Run server
diff --git a/benchmarks/perception/metrics.py b/benchmarks/perception/metrics.py
index f69c054f..f0578ea1 100644
--- a/benchmarks/perception/metrics.py
+++ b/benchmarks/perception/metrics.py
@@ -6,14 +6,23 @@
 
 from collections import defaultdict
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional, Tuple, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from .runner import BenchmarkReport
 
 
 # Stage order for metrics
-STAGE_ORDER = ["early", "bean", "comma", "1.5fold", "2fold", "pretzel", "hatching", "hatched"]
+STAGE_ORDER = [
+    "early",
+    "bean",
+    "comma",
+    "1.5fold",
+    "2fold",
+    "pretzel",
+    "hatching",
+    "hatched",
+]
 
 
 @dataclass
@@ -25,30 +34,30 @@ class PerceptionMetrics:
     adjacent_accuracy: float = 0.0  # Within 1 stage
 
     # Per-stage accuracy
-    stage_accuracy: Dict[str, float] = field(default_factory=dict)
-    stage_counts: Dict[str, int] = field(default_factory=dict)
+    stage_accuracy: dict[str, float] = field(default_factory=dict)
+    stage_counts: dict[str, int] = field(default_factory=dict)
 
     # Confusion matrix: confusion[gt_stage][pred_stage] = count
-    confusion_matrix: Dict[str, Dict[str, int]] = field(default_factory=dict)
+    confusion_matrix: dict[str, dict[str, int]] = field(default_factory=dict)
 
     # Confidence calibration
     mean_confidence: float = 0.0
     confidence_when_correct: float = 0.0
     confidence_when_wrong: float = 0.0
-    calibration_bins: List[Tuple[float, float, int]] = field(default_factory=list)
+    calibration_bins: list[tuple[float, float, int]] = field(default_factory=list)
     # (confidence_bin_center, accuracy_in_bin, count)
 
     expected_calibration_error: float = 0.0  # ECE
 
     # Temporal metrics
     backward_transitions: int = 0  # Errors where stage went backward
-    stage_transition_delay: Dict[str, float] = field(default_factory=dict)
+    stage_transition_delay: dict[str, float] = field(default_factory=dict)
     # How many timepoints after GT transition until prediction caught up
 
     # Tool usage
     total_tool_calls: int = 0
     tool_call_rate: float = 0.0  # Avg tool calls per prediction
-    tool_use_by_stage: Dict[str, float] = field(default_factory=dict)
+    tool_use_by_stage: dict[str, float] = field(default_factory=dict)
 
     # When tools were used vs not
     accuracy_with_tools: float = 0.0
@@ -59,7 +68,7 @@ class PerceptionMetrics:
     transitional_rate: float = 0.0
     transitional_accuracy: float = 0.0  # Accuracy when marked transitional
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "accuracy": self.accuracy,
             "adjacent_accuracy": self.adjacent_accuracy,
@@ -102,8 +111,7 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
 
     # Collect all predictions
     all_preds = [
-        p for r in report.embryo_results for p in r.predictions
-        if p.ground_truth_stage is not None
+        p for r in report.embryo_results for p in r.predictions if p.ground_truth_stage is not None
     ]
 
     if not all_preds:
@@ -134,9 +142,7 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
     for p in all_preds:
         confusion[p.ground_truth_stage][p.predicted_stage] += 1
 
-    metrics.confusion_matrix = {
-        gt: dict(preds) for gt, preds in confusion.items()
-    }
+    metrics.confusion_matrix = {gt: dict(preds) for gt, preds in confusion.items()}
 
     # Confidence statistics
     confidences = [p.confidence for p in all_preds]
@@ -156,10 +162,7 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
         bin_high = (i + 1) / num_bins
         bin_center = (bin_low + bin_high) / 2
 
-        bin_preds = [
-            p for p in all_preds
-            if bin_low <= p.confidence < bin_high
-        ]
+        bin_preds = [p for p in all_preds if bin_low <= p.confidence < bin_high]
 
         if bin_preds:
             bin_accuracy = sum(1 for p in bin_preds if p.is_correct) / len(bin_preds)
@@ -207,7 +210,9 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
     if with_tools:
         metrics.accuracy_with_tools = sum(1 for p in with_tools if p.is_correct) / len(with_tools)
     if without_tools:
-        metrics.accuracy_without_tools = sum(1 for p in without_tools if p.is_correct) / len(without_tools)
+        metrics.accuracy_without_tools = sum(1 for p in without_tools if p.is_correct) / len(
+            without_tools
+        )
 
     # Transitional observations
     transitional_preds = [p for p in all_preds if p.is_transitional]
@@ -215,16 +220,16 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
     metrics.transitional_rate = len(transitional_preds) / len(all_preds)
 
     if transitional_preds:
-        metrics.transitional_accuracy = sum(
-            1 for p in transitional_preds if p.is_correct
-        ) / len(transitional_preds)
+        metrics.transitional_accuracy = sum(1 for p in transitional_preds if p.is_correct) / len(
+            transitional_preds
+        )
 
     return metrics
 
 
 def format_confusion_matrix(
-    confusion: Dict[str, Dict[str, int]],
-    stages: Optional[List[str]] = None,
+    confusion: dict[str, dict[str, int]],
+    stages: list[str] | None = None,
 ) -> str:
     """Format confusion matrix as ASCII table."""
     if stages is None:
@@ -278,34 +283,38 @@ def format_metrics_summary(metrics: PerceptionMetrics) -> str:
             count = metrics.stage_counts[stage]
             lines.append(f"  {stage:>10}: {acc:.1%} (n={count})")
 
-    lines.extend([
-        "",
-        "CONFIDENCE CALIBRATION",
-        f"  Mean confidence:         {metrics.mean_confidence:.2f}",
-        f"  Confidence (correct):    {metrics.confidence_when_correct:.2f}",
-        f"  Confidence (wrong):      {metrics.confidence_when_wrong:.2f}",
-        f"  Expected Cal. Error:     {metrics.expected_calibration_error:.3f}",
-        "",
-        "TOOL USAGE",
-        f"  Total tool calls:        {metrics.total_tool_calls}",
-        f"  Avg calls per pred:      {metrics.tool_call_rate:.2f}",
-        f"  Accuracy with tools:     {metrics.accuracy_with_tools:.1%}",
-        f"  Accuracy without tools:  {metrics.accuracy_without_tools:.1%}",
-        "",
-        "TEMPORAL",
-        f"  Backward transitions:    {metrics.backward_transitions}",
-        "",
-        "TRANSITIONAL OBSERVATIONS",
-        f"  Count:    {metrics.transitional_count}",
-        f"  Rate:     {metrics.transitional_rate:.1%}",
-        f"  Accuracy: {metrics.transitional_accuracy:.1%}",
-    ])
+    lines.extend(
+        [
+            "",
+            "CONFIDENCE CALIBRATION",
+            f"  Mean confidence:         {metrics.mean_confidence:.2f}",
+            f"  Confidence (correct):    {metrics.confidence_when_correct:.2f}",
+            f"  Confidence (wrong):      {metrics.confidence_when_wrong:.2f}",
+            f"  Expected Cal. Error:     {metrics.expected_calibration_error:.3f}",
+            "",
+            "TOOL USAGE",
+            f"  Total tool calls:        {metrics.total_tool_calls}",
+            f"  Avg calls per pred:      {metrics.tool_call_rate:.2f}",
+            f"  Accuracy with tools:     {metrics.accuracy_with_tools:.1%}",
+            f"  Accuracy without tools:  {metrics.accuracy_without_tools:.1%}",
+            "",
+            "TEMPORAL",
+            f"  Backward transitions:    {metrics.backward_transitions}",
+            "",
+            "TRANSITIONAL OBSERVATIONS",
+            f"  Count:    {metrics.transitional_count}",
+            f"  Rate:     {metrics.transitional_rate:.1%}",
+            f"  Accuracy: {metrics.transitional_accuracy:.1%}",
+        ]
+    )
 
     if metrics.confusion_matrix:
-        lines.extend([
-            "",
-            "CONFUSION MATRIX",
-            format_confusion_matrix(metrics.confusion_matrix),
-        ])
+        lines.extend(
+            [
+                "",
+                "CONFUSION MATRIX",
+                format_confusion_matrix(metrics.confusion_matrix),
+            ]
+        )
 
     return "\n".join(lines)
diff --git a/benchmarks/perception/runner.py b/benchmarks/perception/runner.py
index 33d93fe3..70ac32fd 100644
--- a/benchmarks/perception/runner.py
+++ b/benchmarks/perception/runner.py
@@ -12,11 +12,11 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from .ground_truth import GroundTruth
-from .testset import OfflineTestset, TestCase
 from .metrics import PerceptionMetrics, compute_metrics
+from .testset import OfflineTestset
 
 logger = logging.getLogger(__name__)
 
@@ -39,20 +39,20 @@ class BenchmarkConfig:
 
     # Test settings
     start_timepoint: int = 0
-    max_timepoints_per_embryo: Optional[int] = None
-    embryo_ids: Optional[List[str]] = None  # None = all
+    max_timepoints_per_embryo: int | None = None
+    embryo_ids: list[str] | None = None  # None = all
 
     # Ablation toggles
     include_temporal_context: bool = True
     include_previous_observations: bool = True
 
     # Custom system prompt override
-    system_prompt_override: Optional[str] = None
+    system_prompt_override: str | None = None
 
     # Metadata
     description: str = ""
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "model": self.model,
             "temperature": self.temperature,
@@ -78,20 +78,20 @@ class PredictionResult:
 
     timepoint: int
     predicted_stage: str
-    ground_truth_stage: Optional[str]
+    ground_truth_stage: str | None
     confidence: float
     is_transitional: bool
-    transition_between: Optional[List[str]]
+    transition_between: list[str] | None
     reasoning: str
-    reasoning_trace: Optional[Dict[str, Any]]  # Serialized ReasoningTrace
+    reasoning_trace: dict[str, Any] | None  # Serialized ReasoningTrace
     tool_calls: int
-    tools_used: List[str]
+    tools_used: list[str]
 
     # Multi-phase verification fields
     verification_triggered: bool = False
     phase_count: int = 1
-    verification_result: Optional[Dict[str, Any]] = None
-    candidate_stages: Optional[List[Dict[str, Any]]] = None
+    verification_result: dict[str, Any] | None = None
+    candidate_stages: list[dict[str, Any]] | None = None
 
     @property
     def is_correct(self) -> bool:
@@ -113,7 +113,7 @@ def is_adjacent_correct(self) -> bool:
         except ValueError:
             return False
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "timepoint": self.timepoint,
             "predicted_stage": self.predicted_stage,
@@ -139,9 +139,9 @@ class EmbryoResult:
     """Results for a single embryo run."""
 
     embryo_id: str
-    predictions: List[PredictionResult] = field(default_factory=list)
+    predictions: list[PredictionResult] = field(default_factory=list)
     duration_seconds: float = 0.0
-    error: Optional[str] = None
+    error: str | None = None
 
     @property
     def accuracy(self) -> float:
@@ -159,7 +159,7 @@ def adjacent_accuracy(self) -> float:
         correct = sum(1 for p in self.predictions if p.is_adjacent_correct)
         return correct / len(self.predictions)
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "embryo_id": self.embryo_id,
             "predictions": [p.to_dict() for p in self.predictions],
@@ -175,11 +175,11 @@ class BenchmarkReport:
     """Complete benchmark report."""
 
     config: BenchmarkConfig
-    embryo_results: List[EmbryoResult] = field(default_factory=list)
-    metrics: Optional[PerceptionMetrics] = None
+    embryo_results: list[EmbryoResult] = field(default_factory=list)
+    metrics: PerceptionMetrics | None = None
     started_at: datetime = field(default_factory=datetime.now)
-    completed_at: Optional[datetime] = None
-    session_id: Optional[str] = None
+    completed_at: datetime | None = None
+    session_id: str | None = None
 
     @property
     def total_predictions(self) -> int:
@@ -192,7 +192,7 @@ def overall_accuracy(self) -> float:
             return 0.0
         return sum(1 for p in all_preds if p.is_correct) / len(all_preds)
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "config": self.config.to_dict(),
             "embryo_results": [r.to_dict() for r in self.embryo_results],
@@ -222,7 +222,7 @@ def __init__(
         self,
         testset: OfflineTestset,
         config: BenchmarkConfig,
-        engine: Optional[Any] = None,  # PerceptionEngine
+        engine: Any | None = None,  # PerceptionEngine
     ):
         """
         Parameters
@@ -246,7 +246,6 @@ async def _get_engine(self):
         # Lazy import to avoid circular dependencies
         import anthropic
         from gently.harness.perception.engine import PerceptionEngine
-        from gently.harness.perception.example_store import ExampleStore
 
         client = anthropic.Anthropic()
 
@@ -465,7 +464,8 @@ async def main():
         help="Description for this benchmark run",
     )
     parser.add_argument(
-        "-v", "--verbose",
+        "-v",
+        "--verbose",
         action="store_true",
         help="Verbose logging",
     )
@@ -481,6 +481,7 @@ async def main():
     # The perception engine reads stage definitions etc. from the active
     # organism module, which is normally loaded by launch_gently.py.
     from gently.organisms import load_organism
+
     load_organism("celegans")
 
     # Find session path
diff --git a/benchmarks/perception/testset.py b/benchmarks/perception/testset.py
index 658cc011..075eccdb 100644
--- a/benchmarks/perception/testset.py
+++ b/benchmarks/perception/testset.py
@@ -6,10 +6,10 @@
 
 import base64
 import io
+from collections.abc import Iterator
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
-from typing import Iterator, List, Optional, Tuple, Dict
 
 import numpy as np
 
@@ -26,10 +26,12 @@ def _ensure_dependencies():
 
     if tifffile is None:
         import tifffile as _tifffile
+
         tifffile = _tifffile
 
     if PIL_Image is None:
         from PIL import Image as _Image
+
         PIL_Image = _Image
 
 
@@ -40,23 +42,25 @@ class TestCase:
     embryo_id: str
     timepoint: int
     image_b64: str  # Combined view (for backward compatibility)
-    top_image_b64: Optional[str]  # TOP view only
-    side_image_b64: Optional[str]  # SIDE view only
-    volume: Optional[np.ndarray]
-    ground_truth_stage: Optional[str]
-    acquired_at: Optional[datetime] = None
+    top_image_b64: str | None  # TOP view only
+    side_image_b64: str | None  # SIDE view only
+    volume: np.ndarray | None
+    ground_truth_stage: str | None
+    acquired_at: datetime | None = None
 
 
 def _discover_volumes(
-    session_dir: Path, embryo_id: Optional[str] = None
-) -> Dict[str, List[Tuple[datetime, Path]]]:
+    session_dir: Path, embryo_id: str | None = None
+) -> dict[str, list[tuple[datetime, Path]]]:
     """Discover volume files (with parsed acquisition timestamps) in a session directory."""
     if not session_dir.exists():
         return {}
 
     tif_files = (
-        list(session_dir.glob("*.tif")) + list(session_dir.glob("*.tiff"))
-        + list(session_dir.glob("**/*.tif")) + list(session_dir.glob("**/*.tiff"))
+        list(session_dir.glob("*.tif"))
+        + list(session_dir.glob("*.tiff"))
+        + list(session_dir.glob("**/*.tif"))
+        + list(session_dir.glob("**/*.tiff"))
     )
     # Deduplicate (flat + recursive may overlap)
     tif_files = list({f.resolve(): f for f in tif_files}.values())
@@ -89,6 +93,7 @@ def _discover_volumes(
 def _load_volume(path: Path) -> np.ndarray:
     """Load a volume from TIFF file."""
     from gently.core.imaging import load_volume
+
     return load_volume(path)
 
 
@@ -122,9 +127,9 @@ def _create_three_view_image(volume: np.ndarray, max_dim: int = 1500) -> str:
     _ensure_dependencies()
 
     from gently.core.imaging import (
-        projection_three_view,
-        compute_crop_bounds,
         apply_crop_bounds,
+        compute_crop_bounds,
+        projection_three_view,
     )
 
     # Auto-crop to embryo region
@@ -150,7 +155,7 @@ def _create_three_view_image(volume: np.ndarray, max_dim: int = 1500) -> str:
     return base64.b64encode(buffer.getvalue()).decode("utf-8")
 
 
-def _create_separate_view_images(volume: np.ndarray, max_dim: int = 1000) -> Tuple[str, str]:
+def _create_separate_view_images(volume: np.ndarray, max_dim: int = 1000) -> tuple[str, str]:
     """Create separate TOP and SIDE view images from volume, return base64 tuple.
 
     Parameters
@@ -244,7 +249,7 @@ def __init__(
         self._embryo_volumes = _discover_volumes(self.session_path)
 
     @property
-    def embryo_ids(self) -> List[str]:
+    def embryo_ids(self) -> list[str]:
         """Get list of embryo IDs with both volumes and ground truth."""
         gt_embryos = set(self.ground_truth.embryo_ids)
         vol_embryos = set(self._embryo_volumes.keys())
@@ -258,7 +263,7 @@ def iter_embryo(
         self,
         embryo_id: str,
         start_timepoint: int = 0,
-        end_timepoint: Optional[int] = None,
+        end_timepoint: int | None = None,
     ) -> Iterator[TestCase]:
         """
         Iterate through timepoints for an embryo sequentially.
@@ -318,7 +323,7 @@ def iter_embryo(
                 acquired_at=acquired_at,
             )
 
-    def iter_all(self) -> Iterator[Tuple[str, Iterator[TestCase]]]:
+    def iter_all(self) -> Iterator[tuple[str, Iterator[TestCase]]]:
         """
         Iterate through all embryos in the testset.
 
diff --git a/benchmarks/perception/trace_viewer.py b/benchmarks/perception/trace_viewer.py
index 5a3ced2d..69ea5fa6 100644
--- a/benchmarks/perception/trace_viewer.py
+++ b/benchmarks/perception/trace_viewer.py
@@ -7,12 +7,9 @@
 import argparse
 import json
 import sys
-from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
-
-from .metrics import format_metrics_summary, PerceptionMetrics
 
+from .metrics import PerceptionMetrics, format_metrics_summary
 
 HTML_TEMPLATE = """
 <!DOCTYPE html>
@@ -293,16 +290,16 @@
 """
 
 
-def generate_embryo_section(embryo_id: str, predictions: List[Dict]) -> str:
+def generate_embryo_section(embryo_id: str, predictions: list[dict]) -> str:
     """Generate HTML for one embryo's predictions."""
     rows = [
         '<div class="prediction-row header">',
-        '<div>Timepoint</div>',
-        '<div>Predicted</div>',
-        '<div>Ground Truth</div>',
-        '<div>Confidence</div>',
-        '<div>Details</div>',
-        '</div>',
+        "<div>Timepoint</div>",
+        "<div>Predicted</div>",
+        "<div>Ground Truth</div>",
+        "<div>Confidence</div>",
+        "<div>Details</div>",
+        "</div>",
     ]
 
     for i, pred in enumerate(predictions):
@@ -320,15 +317,15 @@ def generate_embryo_section(embryo_id: str, predictions: List[Dict]) -> str:
         row_id = f"{embryo_id}-{timepoint}"
 
         rows.append(f'<div class="prediction-row {row_class}">')
-        rows.append(f'<div>T{timepoint}</div>')
+        rows.append(f"<div>T{timepoint}</div>")
         rows.append(f'<div><span class="stage-badge stage-{pred_stage}">{pred_stage}</span></div>')
         rows.append(f'<div><span class="stage-badge stage-{gt_stage}">{gt_stage}</span></div>')
-        rows.append(f'''<div>
+        rows.append(f"""<div>
             <div class="confidence-bar">
                 <div class="confidence-fill" style="width: {confidence * 100}%"></div>
             </div>
             <small>{confidence:.0%}</small>
-        </div>''')
+        </div>""")
 
         # Details column with expand button
         tool_calls = pred.get("tool_calls", 0)
@@ -351,31 +348,31 @@ def generate_embryo_section(embryo_id: str, predictions: List[Dict]) -> str:
         if phase_count > 1:
             badges += f'<span class="phase-indicator">{phase_count}-phase</span>'
 
-        rows.append(f'''<div>
+        rows.append(f"""<div>
             {details_str}
             {badges}
             <span class="expand-btn" onclick="toggleTrace('{row_id}')">
                 [show trace]
             </span>
-        </div>''')
-        rows.append('</div>')
+        </div>""")
+        rows.append("</div>")
 
         # Reasoning trace (hidden by default)
         trace_html = format_reasoning_trace(pred.get("reasoning_trace"))
-        rows.append(f'''<div id="trace-{row_id}" class="reasoning-trace">
+        rows.append(f"""<div id="trace-{row_id}" class="reasoning-trace">
             <strong>Reasoning:</strong> {reasoning}
             {trace_html}
-        </div>''')
+        </div>""")
 
-    return f'''
+    return f"""
     <div class="embryo-section">
         <h2>{embryo_id}</h2>
         {"".join(rows)}
     </div>
-    '''
+    """
 
 
-def format_reasoning_trace(trace: Optional[Dict]) -> str:
+def format_reasoning_trace(trace: dict | None) -> str:
     """Format reasoning trace as HTML."""
     if not trace:
         return ""
@@ -393,56 +390,66 @@ def format_reasoning_trace(trace: Optional[Dict]) -> str:
         if step_type == "tool_call":
             tool_name = step.get("tool_name", "")
             tool_input = step.get("tool_input", {})
-            html_parts.append(f'''
+            html_parts.append(f"""
                 <div class="trace-step tool_call">
                     <strong>Tool Call:</strong> {tool_name}<br>
                     Input: {json.dumps(tool_input, indent=2)}
                 </div>
-            ''')
+            """)
         elif step_type == "tool_result":
             summary = step.get("tool_result_summary", content)
-            html_parts.append(f'''
+            html_parts.append(f"""
                 <div class="trace-step tool_result">
                     <strong>Tool Result:</strong> {summary}
                 </div>
-            ''')
+            """)
         elif step_type == "final_decision":
-            html_parts.append(f'''
+            html_parts.append(f"""
                 <div class="trace-step final_decision">
                     <strong>Final Decision:</strong><br>
                     {content[:500]}...
                 </div>
-            ''')
+            """)
         elif step_type == "verification_requested":
-            html_parts.append(f'''
+            html_parts.append(f"""
                 <div class="trace-step verification_requested">
                     <strong>Verification Requested:</strong><br>
                     {content}
                 </div>
-            ''')
+            """)
         elif step_type == "verification_subagent":
             tool_input = step.get("tool_input", {})
             summary = step.get("tool_result_summary", content)
-            html_parts.append(f'''
+            html_parts.append(f"""
                 <div class="trace-step verification_subagent">
-                    <strong>Subagent:</strong> {tool_input.get("stage_a", "?")} vs {tool_input.get("stage_b", "?")}<br>
+                    <strong>Subagent:</strong> {tool_input.get("stage_a", "?")} vs
+                    {tool_input.get("stage_b", "?")}<br>
                     Result: {summary}
                 </div>
-            ''')
+            """)
         elif step_type == "verification_result":
-            html_parts.append(f'''
+            html_parts.append(f"""
                 <div class="trace-step verification_result">
                     <strong>Verification Result:</strong><br>
                     {content}
                 </div>
-            ''')
+            """)
 
     return "".join(html_parts)
 
 
-def generate_confusion_matrix_html(confusion: Dict[str, Dict[str, int]]) -> str:
+def generate_confusion_matrix_html(confusion: dict[str, dict[str, int]]) -> str:
     """Generate HTML table for confusion matrix."""
-    stages = ["early", "bean", "comma", "1.5fold", "2fold", "pretzel", "hatching", "hatched"]
+    stages = [
+        "early",
+        "bean",
+        "comma",
+        "1.5fold",
+        "2fold",
+        "pretzel",
+        "hatching",
+        "hatched",
+    ]
 
     # Filter to stages present in data
     present = set()
@@ -478,7 +485,7 @@ def generate_confusion_matrix_html(confusion: Dict[str, Dict[str, int]]) -> str:
     return "".join(rows)
 
 
-def generate_html_report(report_data: Dict) -> str:
+def generate_html_report(report_data: dict) -> str:
     """Generate complete HTML report from benchmark data."""
     # Extract summary metrics
     metrics = report_data.get("metrics", {})
@@ -493,9 +500,7 @@ def generate_html_report(report_data: Dict) -> str:
     # Generate embryo sections
     embryo_sections = []
     for er in embryo_results:
-        embryo_sections.append(
-            generate_embryo_section(er["embryo_id"], er["predictions"])
-        )
+        embryo_sections.append(generate_embryo_section(er["embryo_id"], er["predictions"]))
 
     # Generate confusion matrix
     confusion = metrics.get("confusion_matrix", {})
@@ -569,8 +574,7 @@ def main():
     # Filter embryo if specified
     if args.embryo:
         report_data["embryo_results"] = [
-            er for er in report_data.get("embryo_results", [])
-            if er["embryo_id"] == args.embryo
+            er for er in report_data.get("embryo_results", []) if er["embryo_id"] == args.embryo
         ]
 
     # Generate HTML
diff --git a/benchmarks/runner.py b/benchmarks/runner.py
index 4d6d847a..7dd31236 100644
--- a/benchmarks/runner.py
+++ b/benchmarks/runner.py
@@ -13,8 +13,6 @@
 import json
 import logging
 import sys
-from datetime import datetime
-from pathlib import Path
 
 logging.basicConfig(level=logging.INFO, format="%(message)s")
 logger = logging.getLogger(__name__)
@@ -66,7 +64,6 @@ async def run_agent_benchmark(args):
 
 def compare_reports(args):
     """Compare two benchmark reports"""
-    from .agent.evaluator import BenchmarkReport, compare_reports as _compare
 
     with open(args.before) as f:
         before_data = json.load(f)
@@ -101,7 +98,10 @@ def compare_reports(args):
         delta_str = f"+{fmt.format(delta)}" if delta > 0 else fmt.format(delta)
         status = "improved" if delta > 0 else ("regressed" if delta < 0 else "unchanged")
 
-        logger.info(f"  {name}: {fmt.format(before_val)} -> {fmt.format(after_val)} ({delta_str}) [{status}]")
+        logger.info(
+            f"  {name}: {fmt.format(before_val)} -> {fmt.format(after_val)}"
+            f" ({delta_str}) [{status}]"
+        )
 
     # Token comparison
     before_tokens = before_data.get("tokens", {})
@@ -111,7 +111,7 @@ def compare_reports(args):
     after_total = after_tokens.get("total_input", 0) + after_tokens.get("total_output", 0)
     token_delta = after_total - before_total
 
-    logger.info(f"\nTokens:")
+    logger.info("\nTokens:")
     logger.info(f"  Total: {before_total:,} -> {after_total:,} ({token_delta:+,})")
 
     return 0
diff --git a/diagnostics/benchmark_gentlystore_fps.py b/diagnostics/benchmark_gentlystore_fps.py
index 43187b9e..3e8188a7 100644
--- a/diagnostics/benchmark_gentlystore_fps.py
+++ b/diagnostics/benchmark_gentlystore_fps.py
@@ -22,23 +22,22 @@
 import argparse
 import shutil
 import statistics
+
+# Add gently to path
+import sys
 import tempfile
 import time
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import List, Optional
 
 import numpy as np
 
-# Add gently to path
-import sys
 GENTLY_ROOT = Path(__file__).resolve().parent.parent
 if str(GENTLY_ROOT) not in sys.path:
     sys.path.insert(0, str(GENTLY_ROOT))
 
-from gently.core.file_store import FileStore
-
+from gently.core.file_store import FileStore  # noqa: E402
 
 # ---------------------------------------------------------------------------
 # Default parameters -- typical diSPIM volume dimensions
@@ -60,9 +59,9 @@ class BenchmarkResult:
     approach: str
     num_slices: int
     volume_shape: tuple
-    timings: List[float] = field(default_factory=list)
-    sizes_mb: List[float] = field(default_factory=list)
-    errors: List[str] = field(default_factory=list)
+    timings: list[float] = field(default_factory=list)
+    sizes_mb: list[float] = field(default_factory=list)
+    errors: list[str] = field(default_factory=list)
 
     @property
     def mean(self) -> float:
@@ -130,7 +129,7 @@ def generate_synthetic_volume(
         z = np.linspace(0, 1, num_slices)[:, None, None]
         y = np.linspace(0, 1, height)[None, :, None]
         x = np.linspace(0, 1, width)[None, None, :]
-        vol = (z * 0.3 + y * 0.3 + x * 0.4)
+        vol = z * 0.3 + y * 0.3 + x * 0.4
         if np.issubdtype(dtype, np.integer):
             info = np.iinfo(dtype)
             vol = (vol * info.max).astype(dtype)
@@ -149,14 +148,18 @@ def generate_synthetic_volume(
             cx = np.random.randint(width // 4, 3 * width // 4)
             sz, sy, sx = 3, 15, 15
 
-            z_idx = np.clip(np.arange(cz - sz*2, cz + sz*2), 0, num_slices - 1)
-            y_idx = np.clip(np.arange(cy - sy*2, cy + sy*2), 0, height - 1)
-            x_idx = np.clip(np.arange(cx - sx*2, cx + sx*2), 0, width - 1)
+            z_idx = np.clip(np.arange(cz - sz * 2, cz + sz * 2), 0, num_slices - 1)
+            y_idx = np.clip(np.arange(cy - sy * 2, cy + sy * 2), 0, height - 1)
+            x_idx = np.clip(np.arange(cx - sx * 2, cx + sx * 2), 0, width - 1)
 
-            zz, yy, xx = np.meshgrid(z_idx, y_idx, x_idx, indexing='ij')
+            zz, yy, xx = np.meshgrid(z_idx, y_idx, x_idx, indexing="ij")
             d2 = ((zz - cz) / sz) ** 2 + ((yy - cy) / sy) ** 2 + ((xx - cx) / sx) ** 2
             blob = np.exp(-d2 / 2)
-            vol[z_idx[0]:z_idx[-1]+1, y_idx[0]:y_idx[-1]+1, x_idx[0]:x_idx[-1]+1] += blob
+            vol[
+                z_idx[0] : z_idx[-1] + 1,
+                y_idx[0] : y_idx[-1] + 1,
+                x_idx[0] : x_idx[-1] + 1,
+            ] += blob
 
         # Add background noise
         vol += np.random.random(shape) * 0.1
@@ -178,7 +181,7 @@ def generate_synthetic_volume(
 def benchmark_raw_tiff_write(
     volume: np.ndarray,
     output_dir: Path,
-    compression: Optional[str] = "zlib",
+    compression: str | None = "zlib",
 ) -> tuple[float, float]:
     """
     Benchmark raw tifffile write (no FileStore).
@@ -255,7 +258,7 @@ def benchmark_register_volume(
 # Main benchmark sweep
 # ---------------------------------------------------------------------------
 def run_benchmark_sweep(
-    slices_list: List[int],
+    slices_list: list[int],
     width: int,
     height: int,
     num_repeats: int,
@@ -265,9 +268,9 @@ def run_benchmark_sweep(
     run_put_volume: bool = True,
     run_register: bool = True,
     skip_projection: bool = False,
-) -> List[BenchmarkResult]:
+) -> list[BenchmarkResult]:
     """Run the full benchmark sweep."""
-    results: List[BenchmarkResult] = []
+    results: list[BenchmarkResult] = []
 
     # Create temporary directory for benchmark
     temp_dir = Path(tempfile.mkdtemp(prefix="gently_benchmark_"))
@@ -291,10 +294,12 @@ def run_benchmark_sweep(
         timepoint = 0
 
         for config_idx, num_slices in enumerate(slices_list):
-            print(f"\n{'='*60}")
-            print(f"Config {config_idx + 1}/{total_configs}: "
-                  f"slices={num_slices}, shape=({num_slices}, {height}, {width})")
-            print(f"{'='*60}")
+            print(f"\n{'=' * 60}")
+            print(
+                f"Config {config_idx + 1}/{total_configs}: "
+                f"slices={num_slices}, shape=({num_slices}, {height}, {width})"
+            )
+            print(f"{'=' * 60}")
 
             volume_shape = (num_slices, height, width)
 
@@ -307,22 +312,22 @@ def run_benchmark_sweep(
             # --- Raw TIFF write (baseline) ---
             if run_raw:
                 res_raw = BenchmarkResult("raw_tiff_zlib", num_slices, volume_shape)
-                print(f"\n[Raw TIFF zlib]")
+                print("\n[Raw TIFF zlib]")
 
                 # Warmup
                 for w in range(num_warmup):
-                    print(f"  Warmup {w+1}/{num_warmup}...", end=" ", flush=True)
+                    print(f"  Warmup {w + 1}/{num_warmup}...", end=" ", flush=True)
                     dur, size = benchmark_raw_tiff_write(volume, raw_dir, "zlib")
                     print(f"{dur:.3f}s, {size:.1f} MB")
 
                 # Timed repeats
                 for r in range(num_repeats):
-                    print(f"  Repeat {r+1}/{num_repeats}...", end=" ", flush=True)
+                    print(f"  Repeat {r + 1}/{num_repeats}...", end=" ", flush=True)
                     try:
                         dur, size = benchmark_raw_tiff_write(volume, raw_dir, "zlib")
                         res_raw.timings.append(dur)
                         res_raw.sizes_mb.append(size)
-                        print(f"{dur:.3f}s, {size:.1f} MB ({1/dur:.1f} vol/s)")
+                        print(f"{dur:.3f}s, {size:.1f} MB ({1 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
                         res_raw.errors.append(str(e))
@@ -333,26 +338,38 @@ def run_benchmark_sweep(
             # --- put_volume (full pipeline) ---
             if run_put_volume:
                 res_put = BenchmarkResult("put_volume", num_slices, volume_shape)
-                print(f"\n[FileStore.put_volume]")
+                print("\n[FileStore.put_volume]")
 
                 # Warmup
                 for w in range(num_warmup):
                     embryo_id = f"embryo_{w % NUM_EMBRYOS}"
-                    print(f"  Warmup {w+1}/{num_warmup} ({embryo_id})...", end=" ", flush=True)
-                    dur, size = benchmark_put_volume(store, session_id, embryo_id, timepoint, volume)
+                    print(
+                        f"  Warmup {w + 1}/{num_warmup} ({embryo_id})...",
+                        end=" ",
+                        flush=True,
+                    )
+                    dur, size = benchmark_put_volume(
+                        store, session_id, embryo_id, timepoint, volume
+                    )
                     timepoint += 1
                     print(f"{dur:.3f}s, {size:.1f} MB")
 
                 # Timed repeats
                 for r in range(num_repeats):
                     embryo_id = f"embryo_{r % NUM_EMBRYOS}"
-                    print(f"  Repeat {r+1}/{num_repeats} ({embryo_id})...", end=" ", flush=True)
+                    print(
+                        f"  Repeat {r + 1}/{num_repeats} ({embryo_id})...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
-                        dur, size = benchmark_put_volume(store, session_id, embryo_id, timepoint, volume)
+                        dur, size = benchmark_put_volume(
+                            store, session_id, embryo_id, timepoint, volume
+                        )
                         timepoint += 1
                         res_put.timings.append(dur)
                         res_put.sizes_mb.append(size)
-                        print(f"{dur:.3f}s, {size:.1f} MB ({1/dur:.1f} vol/s)")
+                        print(f"{dur:.3f}s, {size:.1f} MB ({1 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
                         res_put.errors.append(str(e))
@@ -363,26 +380,38 @@ def run_benchmark_sweep(
             # --- register_volume (zero-copy path) ---
             if run_register:
                 res_reg = BenchmarkResult("register_volume", num_slices, volume_shape)
-                print(f"\n[FileStore.register_volume]")
+                print("\n[FileStore.register_volume]")
 
                 # Warmup
                 for w in range(num_warmup):
                     embryo_id = f"embryo_{w % NUM_EMBRYOS}"
-                    print(f"  Warmup {w+1}/{num_warmup} ({embryo_id})...", end=" ", flush=True)
-                    dur, size = benchmark_register_volume(store, session_id, embryo_id, timepoint, volume)
+                    print(
+                        f"  Warmup {w + 1}/{num_warmup} ({embryo_id})...",
+                        end=" ",
+                        flush=True,
+                    )
+                    dur, size = benchmark_register_volume(
+                        store, session_id, embryo_id, timepoint, volume
+                    )
                     timepoint += 1
                     print(f"{dur:.3f}s, {size:.1f} MB")
 
                 # Timed repeats
                 for r in range(num_repeats):
                     embryo_id = f"embryo_{r % NUM_EMBRYOS}"
-                    print(f"  Repeat {r+1}/{num_repeats} ({embryo_id})...", end=" ", flush=True)
+                    print(
+                        f"  Repeat {r + 1}/{num_repeats} ({embryo_id})...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
-                        dur, size = benchmark_register_volume(store, session_id, embryo_id, timepoint, volume)
+                        dur, size = benchmark_register_volume(
+                            store, session_id, embryo_id, timepoint, volume
+                        )
                         timepoint += 1
                         res_reg.timings.append(dur)
                         res_reg.sizes_mb.append(size)
-                        print(f"{dur:.3f}s, {size:.1f} MB ({1/dur:.1f} vol/s)")
+                        print(f"{dur:.3f}s, {size:.1f} MB ({1 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
                         res_reg.errors.append(str(e))
@@ -410,20 +439,24 @@ def _print_single_result(res: BenchmarkResult):
     if not res.timings:
         print(f"  -> {res.approach}: NO SUCCESSFUL RUNS ({len(res.errors)} errors)")
         return
-    print(f"  -> {res.approach}: {res.vol_per_sec:.2f} vol/s, "
-          f"mean={res.mean:.3f}s, std={res.std:.3f}s, "
-          f"avg_size={res.avg_size_mb:.1f} MB")
+    print(
+        f"  -> {res.approach}: {res.vol_per_sec:.2f} vol/s, "
+        f"mean={res.mean:.3f}s, std={res.std:.3f}s, "
+        f"avg_size={res.avg_size_mb:.1f} MB"
+    )
 
 
-def print_results_table(results: List[BenchmarkResult]):
+def print_results_table(results: list[BenchmarkResult]):
     """Print formatted ASCII results table."""
     if not results:
         print("No results to display.")
         return
 
-    header = (f"{'Slices':>6} | {'Approach':>18} | {'Vol/s':>7} | "
-              f"{'Mean(s)':>7} | {'Std(s)':>6} | {'Min(s)':>6} | "
-              f"{'Max(s)':>6} | {'Size(MB)':>8} | {'MB/s':>7}")
+    header = (
+        f"{'Slices':>6} | {'Approach':>18} | {'Vol/s':>7} | "
+        f"{'Mean(s)':>7} | {'Std(s)':>6} | {'Min(s)':>6} | "
+        f"{'Max(s)':>6} | {'Size(MB)':>8} | {'MB/s':>7}"
+    )
     sep = "-" * len(header)
 
     print(f"\n{sep}")
@@ -434,19 +467,23 @@ def print_results_table(results: List[BenchmarkResult]):
 
     for r in results:
         if r.timings:
-            print(f"{r.num_slices:>6} | {r.approach:>18} | "
-                  f"{r.vol_per_sec:>7.2f} | {r.mean:>7.3f} | {r.std:>6.3f} | "
-                  f"{r.min_t:>6.3f} | {r.max_t:>6.3f} | {r.avg_size_mb:>8.1f} | "
-                  f"{r.mb_per_sec:>7.1f}")
+            print(
+                f"{r.num_slices:>6} | {r.approach:>18} | "
+                f"{r.vol_per_sec:>7.2f} | {r.mean:>7.3f} | {r.std:>6.3f} | "
+                f"{r.min_t:>6.3f} | {r.max_t:>6.3f} | {r.avg_size_mb:>8.1f} | "
+                f"{r.mb_per_sec:>7.1f}"
+            )
         else:
-            print(f"{r.num_slices:>6} | {r.approach:>18} | "
-                  f"{'FAIL':>7} | {'---':>7} | {'---':>6} | "
-                  f"{'---':>6} | {'---':>6} | {'---':>8} | {'---':>7}")
+            print(
+                f"{r.num_slices:>6} | {r.approach:>18} | "
+                f"{'FAIL':>7} | {'---':>7} | {'---':>6} | "
+                f"{'---':>6} | {'---':>6} | {'---':>8} | {'---':>7}"
+            )
 
     print(sep)
 
 
-def print_overhead_analysis(results: List[BenchmarkResult]):
+def print_overhead_analysis(results: list[BenchmarkResult]):
     """Print overhead analysis comparing FileStore to raw TIFF."""
     from collections import defaultdict
 
@@ -454,9 +491,11 @@ def print_overhead_analysis(results: List[BenchmarkResult]):
     for r in results:
         groups[r.num_slices][r.approach] = r
 
-    has_data = [(k, v) for k, v in groups.items()
-                if "raw_tiff_zlib" in v and
-                ("put_volume" in v or "register_volume" in v)]
+    has_data = [
+        (k, v)
+        for k, v in groups.items()
+        if "raw_tiff_zlib" in v and ("put_volume" in v or "register_volume" in v)
+    ]
 
     if not has_data:
         return
@@ -487,7 +526,7 @@ def print_overhead_analysis(results: List[BenchmarkResult]):
     print(sep)
 
 
-def save_results_csv(results: List[BenchmarkResult], path: Path, run_params: dict):
+def save_results_csv(results: list[BenchmarkResult], path: Path, run_params: dict):
     """Save results to CSV."""
     import csv
     import json
@@ -508,30 +547,44 @@ def save_results_csv(results: List[BenchmarkResult], path: Path, run_params: dic
         writer.writerow([])
 
         # Summary table
-        writer.writerow([
-            "slices", "approach", "vol_per_sec", "mean_s", "std_s",
-            "min_s", "max_s", "avg_size_mb", "mb_per_sec", "num_repeats", "errors",
-        ])
+        writer.writerow(
+            [
+                "slices",
+                "approach",
+                "vol_per_sec",
+                "mean_s",
+                "std_s",
+                "min_s",
+                "max_s",
+                "avg_size_mb",
+                "mb_per_sec",
+                "num_repeats",
+                "errors",
+            ]
+        )
         for r in results:
-            writer.writerow([
-                r.num_slices, r.approach,
-                f"{r.vol_per_sec:.4f}" if r.timings else "",
-                f"{r.mean:.6f}" if r.timings else "",
-                f"{r.std:.6f}" if r.timings else "",
-                f"{r.min_t:.6f}" if r.timings else "",
-                f"{r.max_t:.6f}" if r.timings else "",
-                f"{r.avg_size_mb:.2f}" if r.sizes_mb else "",
-                f"{r.mb_per_sec:.2f}" if r.timings else "",
-                len(r.timings),
-                "; ".join(r.errors) if r.errors else "",
-            ])
+            writer.writerow(
+                [
+                    r.num_slices,
+                    r.approach,
+                    f"{r.vol_per_sec:.4f}" if r.timings else "",
+                    f"{r.mean:.6f}" if r.timings else "",
+                    f"{r.std:.6f}" if r.timings else "",
+                    f"{r.min_t:.6f}" if r.timings else "",
+                    f"{r.max_t:.6f}" if r.timings else "",
+                    f"{r.avg_size_mb:.2f}" if r.sizes_mb else "",
+                    f"{r.mb_per_sec:.2f}" if r.timings else "",
+                    len(r.timings),
+                    "; ".join(r.errors) if r.errors else "",
+                ]
+            )
 
         # Per-volume timings
         writer.writerow([])
         writer.writerow(["# Per-volume timings"])
         writer.writerow(["slices", "approach", "repeat", "elapsed_s", "size_mb"])
         for r in results:
-            for i, (t, s) in enumerate(zip(r.timings, r.sizes_mb)):
+            for i, (t, s) in enumerate(zip(r.timings, r.sizes_mb, strict=False)):
                 writer.writerow([r.num_slices, r.approach, i + 1, f"{t:.6f}", f"{s:.2f}"])
 
     print(f"\nResults saved to: {path}")
@@ -541,24 +594,45 @@ def save_results_csv(results: List[BenchmarkResult], path: Path, run_params: dic
 # Main
 # ---------------------------------------------------------------------------
 def main():
-    parser = argparse.ArgumentParser(
-        description="Benchmark FileStore volume storage throughput"
+    parser = argparse.ArgumentParser(description="Benchmark FileStore volume storage throughput")
+    parser.add_argument(
+        "--slices",
+        type=int,
+        nargs="+",
+        default=DEFAULT_SLICES,
+        help=f"Slice counts to test (default: {DEFAULT_SLICES})",
+    )
+    parser.add_argument(
+        "--width",
+        type=int,
+        default=DEFAULT_WIDTH,
+        help=f"Image width (default: {DEFAULT_WIDTH})",
+    )
+    parser.add_argument(
+        "--height",
+        type=int,
+        default=DEFAULT_HEIGHT,
+        help=f"Image height (default: {DEFAULT_HEIGHT})",
+    )
+    parser.add_argument(
+        "--repeats",
+        type=int,
+        default=NUM_REPEATS,
+        help=f"Number of timed repeats (default: {NUM_REPEATS})",
+    )
+    parser.add_argument(
+        "--warmup",
+        type=int,
+        default=NUM_WARMUP,
+        help=f"Number of warmup runs (default: {NUM_WARMUP})",
+    )
+    parser.add_argument(
+        "--pattern",
+        choices=["noise", "gradient", "embryo"],
+        default="embryo",
+        help="Volume pattern: noise, gradient, or embryo (default: embryo)",
     )
-    parser.add_argument("--slices", type=int, nargs="+", default=DEFAULT_SLICES,
-                        help=f"Slice counts to test (default: {DEFAULT_SLICES})")
-    parser.add_argument("--width", type=int, default=DEFAULT_WIDTH,
-                        help=f"Image width (default: {DEFAULT_WIDTH})")
-    parser.add_argument("--height", type=int, default=DEFAULT_HEIGHT,
-                        help=f"Image height (default: {DEFAULT_HEIGHT})")
-    parser.add_argument("--repeats", type=int, default=NUM_REPEATS,
-                        help=f"Number of timed repeats (default: {NUM_REPEATS})")
-    parser.add_argument("--warmup", type=int, default=NUM_WARMUP,
-                        help=f"Number of warmup runs (default: {NUM_WARMUP})")
-    parser.add_argument("--pattern", choices=["noise", "gradient", "embryo"],
-                        default="embryo",
-                        help="Volume pattern: noise, gradient, or embryo (default: embryo)")
-    parser.add_argument("--save", action="store_true",
-                        help="Save results to CSV")
+    parser.add_argument("--save", action="store_true", help="Save results to CSV")
     args = parser.parse_args()
 
     print("FileStore Volume Storage Benchmark")
@@ -566,7 +640,7 @@ def main():
     print(f"  Dimensions: {args.width} x {args.height}")
     print(f"  Pattern:   {args.pattern}")
     print(f"  Repeats:   {args.repeats} (+ {args.warmup} warmup)")
-    print(f"  Approaches: raw_tiff_zlib / put_volume / register_volume")
+    print("  Approaches: raw_tiff_zlib / put_volume / register_volume")
 
     results = run_benchmark_sweep(
         slices_list=args.slices,
@@ -581,7 +655,10 @@ def main():
     print_overhead_analysis(results)
 
     if args.save:
-        csv_path = Path("results") / f"benchmark_gentlystore_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv"
+        csv_path = (
+            Path("results")
+            / f"benchmark_gentlystore_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv"
+        )
         run_params = {
             "slices": args.slices,
             "width": args.width,
diff --git a/diagnostics/benchmark_volume_fps.py b/diagnostics/benchmark_volume_fps.py
index ff7b2e38..381e3697 100644
--- a/diagnostics/benchmark_volume_fps.py
+++ b/diagnostics/benchmark_volume_fps.py
@@ -15,20 +15,21 @@
 """
 
 import os
+import statistics
 import sys
 import time
-import statistics
-from pathlib import Path
 from dataclasses import dataclass, field
-from typing import List, Optional, Tuple
 from datetime import datetime
+from pathlib import Path
 
-import yaml
 import numpy as np
 import pymmcore
+import yaml
 
 # Add dispim-control to path for ophyd device imports
-DISPIM_CONTROL_DIR = Path(__file__).resolve().parent.parent / "UsersdispimDocumentsGitHubdispim-control"
+DISPIM_CONTROL_DIR = (
+    Path(__file__).resolve().parent.parent / "UsersdispimDocumentsGitHubdispim-control"
+)
 if str(DISPIM_CONTROL_DIR) not in sys.path:
     sys.path.insert(0, str(DISPIM_CONTROL_DIR))
 
@@ -41,10 +42,10 @@
 PIEZO_DEVICE = "PiezoStage:P:34"
 
 # Default scan parameters (same as run_multi_embryo_volumes.py)
-DEFAULT_GALVO_AMPLITUDE = 0.5    # degrees
-DEFAULT_GALVO_CENTER = 0.0       # degrees
-DEFAULT_PIEZO_AMPLITUDE = 25.0   # um
-DEFAULT_PIEZO_CENTER = 50.0      # um
+DEFAULT_GALVO_AMPLITUDE = 0.5  # degrees
+DEFAULT_GALVO_CENTER = 0.0  # degrees
+DEFAULT_PIEZO_AMPLITUDE = 25.0  # um
+DEFAULT_PIEZO_CENTER = 50.0  # um
 DEFAULT_LASER_CONFIG = "488 and 561"
 DEFAULT_CAMERA_ROI = (128, 896, 2048, 512)  # (x, y, width, height)
 
@@ -69,10 +70,30 @@
 # Simulated embryo calibration profiles for round-robin reconfig test.
 # Each entry represents a different embryo with distinct galvo/piezo settings.
 EMBRYO_PROFILES = [
-    {"galvo_amplitude": 0.50, "galvo_center":  0.00, "piezo_amplitude": 25.0, "piezo_center": 50.0},
-    {"galvo_amplitude": 0.45, "galvo_center":  0.12, "piezo_amplitude": 22.5, "piezo_center": 55.0},
-    {"galvo_amplitude": 0.55, "galvo_center": -0.08, "piezo_amplitude": 27.5, "piezo_center": 45.0},
-    {"galvo_amplitude": 0.48, "galvo_center":  0.05, "piezo_amplitude": 24.0, "piezo_center": 52.0},
+    {
+        "galvo_amplitude": 0.50,
+        "galvo_center": 0.00,
+        "piezo_amplitude": 25.0,
+        "piezo_center": 50.0,
+    },
+    {
+        "galvo_amplitude": 0.45,
+        "galvo_center": 0.12,
+        "piezo_amplitude": 22.5,
+        "piezo_center": 55.0,
+    },
+    {
+        "galvo_amplitude": 0.55,
+        "galvo_center": -0.08,
+        "piezo_amplitude": 27.5,
+        "piezo_center": 45.0,
+    },
+    {
+        "galvo_amplitude": 0.48,
+        "galvo_center": 0.05,
+        "piezo_amplitude": 24.0,
+        "piezo_center": 52.0,
+    },
 ]
 
 
@@ -84,9 +105,9 @@ class BenchmarkResult:
     approach: str
     num_slices: int
     exposure_ms: float
-    timings: List[float] = field(default_factory=list)
-    image_counts: List[int] = field(default_factory=list)
-    errors: List[str] = field(default_factory=list)
+    timings: list[float] = field(default_factory=list)
+    image_counts: list[int] = field(default_factory=list)
+    errors: list[str] = field(default_factory=list)
 
     @property
     def mean(self) -> float:
@@ -116,13 +137,13 @@ def total_images(self) -> int:
 # ---------------------------------------------------------------------------
 # Config loading
 # ---------------------------------------------------------------------------
-def load_config(path: str) -> Tuple[str, str]:
+def load_config(path: str) -> tuple[str, str]:
     """Read config.yml and return (mm_dir, config_file)."""
     cfg_path = Path(path)
     if not cfg_path.exists():
         raise FileNotFoundError(f"Config file not found: {cfg_path}")
 
-    with open(cfg_path, "r") as f:
+    with open(cfg_path) as f:
         cfg = yaml.safe_load(f)
 
     mm_dir = cfg["mmdirectory"]
@@ -236,8 +257,8 @@ def configure_hardware_raw(core: pymmcore.CMMCore, num_slices: int, exposure_ms:
 def acquire_volume_raw(
     core: pymmcore.CMMCore,
     num_slices: int,
-    save_dir: Optional[Path] = None,
-) -> Tuple[int, float]:
+    save_dir: Path | None = None,
+) -> tuple[int, float]:
     """
     Trigger SPIM and collect images from the circular buffer.
 
@@ -329,10 +350,10 @@ def create_ophyd_devices(core: pymmcore.CMMCore):
     which imports a theme module that may not be available).
     """
     from dispim_control.devices import (
-        DiSPIMScanner,
         DiSPIMCamera,
-        DiSPIMPiezo,
         DiSPIMLaserControl,
+        DiSPIMPiezo,
+        DiSPIMScanner,
         DiSPIMVolumeScanner,
     )
 
@@ -356,8 +377,8 @@ def acquire_volume_ophyd(
     volume_scanner,
     num_slices: int,
     exposure_ms: float,
-    save_dir: Optional[Path] = None,
-) -> Tuple[int, float]:
+    save_dir: Path | None = None,
+) -> tuple[int, float]:
     """
     Configure + trigger via ophyd VolumeScanner.
 
@@ -392,8 +413,9 @@ def acquire_volume_ophyd(
 # ---------------------------------------------------------------------------
 # Ophyd burst approach -- configure once, skip per-volume reset
 # ---------------------------------------------------------------------------
-def configure_ophyd_burst(volume_scanner, num_slices: int, exposure_ms: float,
-                          core: pymmcore.CMMCore):
+def configure_ophyd_burst(
+    volume_scanner, num_slices: int, exposure_ms: float, core: pymmcore.CMMCore
+):
     """
     Configure ophyd devices once for a burst of volumes.
 
@@ -417,8 +439,9 @@ def configure_ophyd_burst(volume_scanner, num_slices: int, exposure_ms: float,
     time.sleep(0.1)
 
 
-def acquire_volume_ophyd_burst(volume_scanner, num_slices: int,
-                               core: pymmcore.CMMCore) -> Tuple[int, float]:
+def acquire_volume_ophyd_burst(
+    volume_scanner, num_slices: int, core: pymmcore.CMMCore
+) -> tuple[int, float]:
     """
     Acquire one volume using ophyd devices but without per-volume reset.
 
@@ -494,8 +517,9 @@ def cleanup_ophyd_burst(volume_scanner, core: pymmcore.CMMCore):
 # ---------------------------------------------------------------------------
 # Burst reconfig approach -- reconfigure galvo/piezo per volume (round-robin)
 # ---------------------------------------------------------------------------
-def configure_burst_reconfig(volume_scanner, num_slices: int, exposure_ms: float,
-                             core: pymmcore.CMMCore):
+def configure_burst_reconfig(
+    volume_scanner, num_slices: int, exposure_ms: float, core: pymmcore.CMMCore
+):
     """
     One-time setup for burst_reconfig: camera, scanner X-axis & timing, lasers.
 
@@ -519,9 +543,11 @@ def configure_burst_reconfig(volume_scanner, num_slices: int, exposure_ms: float
 
 
 def acquire_volume_burst_reconfig(
-    volume_scanner, num_slices: int, profile_idx: int,
+    volume_scanner,
+    num_slices: int,
+    profile_idx: int,
     core: pymmcore.CMMCore,
-) -> Tuple[int, float]:
+) -> tuple[int, float]:
     """
     Acquire one volume after reconfiguring galvo/piezo for a specific embryo.
 
@@ -535,7 +561,6 @@ def acquire_volume_burst_reconfig(
     profile = EMBRYO_PROFILES[profile_idx % len(EMBRYO_PROFILES)]
     camera_name = volume_scanner.camera.name
     scanner = volume_scanner.scanner
-    piezo = volume_scanner.piezo
 
     core.clearCircularBuffer()
 
@@ -548,16 +573,12 @@ def acquire_volume_burst_reconfig(
     t0 = time.perf_counter()
 
     # Reconfigure galvo Y-axis for this embryo
-    core.setProperty(GALVO_DEVICE, "SingleAxisYAmplitude(deg)",
-                     float(profile["galvo_amplitude"]))
-    core.setProperty(GALVO_DEVICE, "SingleAxisYOffset(deg)",
-                     float(profile["galvo_center"]))
+    core.setProperty(GALVO_DEVICE, "SingleAxisYAmplitude(deg)", float(profile["galvo_amplitude"]))
+    core.setProperty(GALVO_DEVICE, "SingleAxisYOffset(deg)", float(profile["galvo_center"]))
 
     # Reconfigure piezo for this embryo
-    core.setProperty(PIEZO_DEVICE, "SingleAxisAmplitude(um)",
-                     float(profile["piezo_amplitude"]))
-    core.setProperty(PIEZO_DEVICE, "SingleAxisOffset(um)",
-                     float(profile["piezo_center"]))
+    core.setProperty(PIEZO_DEVICE, "SingleAxisAmplitude(um)", float(profile["piezo_amplitude"]))
+    core.setProperty(PIEZO_DEVICE, "SingleAxisOffset(um)", float(profile["piezo_center"]))
     core.setProperty(PIEZO_DEVICE, "SPIMState", "Armed")
     time.sleep(0.3)
 
@@ -595,9 +616,11 @@ def acquire_volume_burst_reconfig(
 # Burst reconfig with waitForDevice -- replaces time.sleep() with MMCore API
 # ---------------------------------------------------------------------------
 def acquire_volume_burst_reconfig_wfd(
-    volume_scanner, num_slices: int, profile_idx: int,
+    volume_scanner,
+    num_slices: int,
+    profile_idx: int,
     core: pymmcore.CMMCore,
-) -> Tuple[int, float]:
+) -> tuple[int, float]:
     """
     Same as burst_reconfig but uses core.waitForDevice() instead of
     time.sleep() to wait for hardware readiness.
@@ -608,7 +631,6 @@ def acquire_volume_burst_reconfig_wfd(
     """
     profile = EMBRYO_PROFILES[profile_idx % len(EMBRYO_PROFILES)]
     camera_name = volume_scanner.camera.name
-    scanner = volume_scanner.scanner
 
     core.clearCircularBuffer()
 
@@ -621,17 +643,13 @@ def acquire_volume_burst_reconfig_wfd(
     t0 = time.perf_counter()
 
     # Reconfigure galvo Y-axis for this embryo
-    core.setProperty(GALVO_DEVICE, "SingleAxisYAmplitude(deg)",
-                     float(profile["galvo_amplitude"]))
-    core.setProperty(GALVO_DEVICE, "SingleAxisYOffset(deg)",
-                     float(profile["galvo_center"]))
+    core.setProperty(GALVO_DEVICE, "SingleAxisYAmplitude(deg)", float(profile["galvo_amplitude"]))
+    core.setProperty(GALVO_DEVICE, "SingleAxisYOffset(deg)", float(profile["galvo_center"]))
     core.waitForDevice(GALVO_DEVICE)
 
     # Reconfigure piezo for this embryo
-    core.setProperty(PIEZO_DEVICE, "SingleAxisAmplitude(um)",
-                     float(profile["piezo_amplitude"]))
-    core.setProperty(PIEZO_DEVICE, "SingleAxisOffset(um)",
-                     float(profile["piezo_center"]))
+    core.setProperty(PIEZO_DEVICE, "SingleAxisAmplitude(um)", float(profile["piezo_amplitude"]))
+    core.setProperty(PIEZO_DEVICE, "SingleAxisOffset(um)", float(profile["piezo_center"]))
     core.setProperty(PIEZO_DEVICE, "SPIMState", "Armed")
     core.waitForDevice(PIEZO_DEVICE)
 
@@ -686,16 +704,16 @@ def _save_volume(volume: np.ndarray, save_dir: Path, approach: str, num_slices:
 # ---------------------------------------------------------------------------
 def run_benchmark_sweep(
     core: pymmcore.CMMCore,
-    slices_list: List[int],
-    exposures_list: List[float],
+    slices_list: list[int],
+    exposures_list: list[float],
     num_repeats: int,
     num_warmup: int,
     run_raw: bool,
     run_ophyd: bool,
-    save_dir: Optional[Path] = None,
-) -> List[BenchmarkResult]:
+    save_dir: Path | None = None,
+) -> list[BenchmarkResult]:
     """Run the full parameter sweep and return results."""
-    results: List[BenchmarkResult] = []
+    results: list[BenchmarkResult] = []
 
     volume_scanner = None
     if run_ophyd:
@@ -709,15 +727,17 @@ def run_benchmark_sweep(
     for num_slices in slices_list:
         for exposure_ms in exposures_list:
             config_idx += 1
-            print(f"\n{'='*60}")
-            print(f"Config {config_idx}/{total_configs}: "
-                  f"slices={num_slices}, exposure={exposure_ms}ms")
-            print(f"{'='*60}")
+            print(f"\n{'=' * 60}")
+            print(
+                f"Config {config_idx}/{total_configs}: "
+                f"slices={num_slices}, exposure={exposure_ms}ms"
+            )
+            print(f"{'=' * 60}")
 
             # --- Raw MMCore ---
             if run_raw:
                 res_raw = BenchmarkResult("raw", num_slices, exposure_ms)
-                print(f"\n[Raw MMCore] Configuring hardware...")
+                print("\n[Raw MMCore] Configuring hardware...")
                 try:
                     configure_hardware_raw(core, num_slices, exposure_ms)
                 except Exception as e:
@@ -728,7 +748,7 @@ def run_benchmark_sweep(
 
                 # Warm-up
                 for w in range(num_warmup):
-                    print(f"  Warm-up {w+1}/{num_warmup}...", end=" ", flush=True)
+                    print(f"  Warm-up {w + 1}/{num_warmup}...", end=" ", flush=True)
                     try:
                         cnt, dur = acquire_volume_raw(core, num_slices)
                         print(f"{cnt} imgs, {dur:.3f}s")
@@ -737,15 +757,15 @@ def run_benchmark_sweep(
 
                 # Timed repeats
                 for r in range(num_repeats):
-                    print(f"  Repeat {r+1}/{num_repeats}...", end=" ", flush=True)
+                    print(f"  Repeat {r + 1}/{num_repeats}...", end=" ", flush=True)
                     try:
                         cnt, dur = acquire_volume_raw(core, num_slices, save_dir=save_dir)
                         res_raw.timings.append(dur)
                         res_raw.image_counts.append(cnt)
-                        print(f"{cnt} imgs, {dur:.3f}s ({1.0/dur:.1f} vol/s)")
+                        print(f"{cnt} imgs, {dur:.3f}s ({1.0 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
-                        res_raw.errors.append(f"repeat {r+1}: {e}")
+                        res_raw.errors.append(f"repeat {r + 1}: {e}")
 
                 # Cleanup after raw batch (lasers off)
                 cleanup_raw(core)
@@ -758,27 +778,34 @@ def run_benchmark_sweep(
 
                 # Warm-up
                 for w in range(num_warmup):
-                    print(f"  [Ophyd] Warm-up {w+1}/{num_warmup}...", end=" ", flush=True)
+                    print(
+                        f"  [Ophyd] Warm-up {w + 1}/{num_warmup}...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
-                        cnt, dur = acquire_volume_ophyd(
-                            volume_scanner, num_slices, exposure_ms)
+                        cnt, dur = acquire_volume_ophyd(volume_scanner, num_slices, exposure_ms)
                         print(f"{cnt} imgs, {dur:.3f}s")
                     except Exception as e:
                         print(f"ERROR: {e}")
 
                 # Timed repeats
                 for r in range(num_repeats):
-                    print(f"  [Ophyd] Repeat {r+1}/{num_repeats}...", end=" ", flush=True)
+                    print(
+                        f"  [Ophyd] Repeat {r + 1}/{num_repeats}...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
                         cnt, dur = acquire_volume_ophyd(
-                            volume_scanner, num_slices, exposure_ms,
-                            save_dir=save_dir)
+                            volume_scanner, num_slices, exposure_ms, save_dir=save_dir
+                        )
                         res_ophyd.timings.append(dur)
                         res_ophyd.image_counts.append(cnt)
-                        print(f"{cnt} imgs, {dur:.3f}s ({1.0/dur:.1f} vol/s)")
+                        print(f"{cnt} imgs, {dur:.3f}s ({1.0 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
-                        res_ophyd.errors.append(f"repeat {r+1}: {e}")
+                        res_ophyd.errors.append(f"repeat {r + 1}: {e}")
 
                 results.append(res_ophyd)
                 _print_single_result(res_ophyd)
@@ -786,10 +813,9 @@ def run_benchmark_sweep(
             # --- Ophyd burst (configure once, no per-volume reset) ---
             if run_ophyd and volume_scanner is not None:
                 res_burst = BenchmarkResult("ophyd_burst", num_slices, exposure_ms)
-                print(f"\n[Ophyd Burst] Configuring once...")
+                print("\n[Ophyd Burst] Configuring once...")
                 try:
-                    configure_ophyd_burst(volume_scanner, num_slices,
-                                          exposure_ms, core)
+                    configure_ophyd_burst(volume_scanner, num_slices, exposure_ms, core)
                 except Exception as e:
                     print(f"  ERROR configuring ophyd burst: {e}")
                     res_burst.errors.append(f"configure: {e}")
@@ -798,26 +824,24 @@ def run_benchmark_sweep(
 
                 # Warm-up
                 for w in range(num_warmup):
-                    print(f"  Warm-up {w+1}/{num_warmup}...", end=" ", flush=True)
+                    print(f"  Warm-up {w + 1}/{num_warmup}...", end=" ", flush=True)
                     try:
-                        cnt, dur = acquire_volume_ophyd_burst(
-                            volume_scanner, num_slices, core)
+                        cnt, dur = acquire_volume_ophyd_burst(volume_scanner, num_slices, core)
                         print(f"{cnt} imgs, {dur:.3f}s")
                     except Exception as e:
                         print(f"ERROR: {e}")
 
                 # Timed repeats
                 for r in range(num_repeats):
-                    print(f"  Repeat {r+1}/{num_repeats}...", end=" ", flush=True)
+                    print(f"  Repeat {r + 1}/{num_repeats}...", end=" ", flush=True)
                     try:
-                        cnt, dur = acquire_volume_ophyd_burst(
-                            volume_scanner, num_slices, core)
+                        cnt, dur = acquire_volume_ophyd_burst(volume_scanner, num_slices, core)
                         res_burst.timings.append(dur)
                         res_burst.image_counts.append(cnt)
-                        print(f"{cnt} imgs, {dur:.3f}s ({1.0/dur:.1f} vol/s)")
+                        print(f"{cnt} imgs, {dur:.3f}s ({1.0 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
-                        res_burst.errors.append(f"repeat {r+1}: {e}")
+                        res_burst.errors.append(f"repeat {r + 1}: {e}")
 
                 cleanup_ophyd_burst(volume_scanner, core)
                 results.append(res_burst)
@@ -826,11 +850,12 @@ def run_benchmark_sweep(
             # --- Burst reconfig (round-robin galvo/piezo per volume) ---
             if run_ophyd and volume_scanner is not None:
                 res_reconfig = BenchmarkResult("burst_reconfig", num_slices, exposure_ms)
-                print(f"\n[Burst Reconfig] Configuring once, "
-                      f"cycling {len(EMBRYO_PROFILES)} embryo profiles...")
+                print(
+                    f"\n[Burst Reconfig] Configuring once, "
+                    f"cycling {len(EMBRYO_PROFILES)} embryo profiles..."
+                )
                 try:
-                    configure_burst_reconfig(volume_scanner, num_slices,
-                                             exposure_ms, core)
+                    configure_burst_reconfig(volume_scanner, num_slices, exposure_ms, core)
                 except Exception as e:
                     print(f"  ERROR configuring burst reconfig: {e}")
                     res_reconfig.errors.append(f"configure: {e}")
@@ -839,12 +864,15 @@ def run_benchmark_sweep(
 
                 # Warm-up (cycle through profiles)
                 for w in range(num_warmup):
-                    print(f"  Warm-up {w+1}/{num_warmup} "
-                          f"(profile {w % len(EMBRYO_PROFILES)})...",
-                          end=" ", flush=True)
+                    print(
+                        f"  Warm-up {w + 1}/{num_warmup} (profile {w % len(EMBRYO_PROFILES)})...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
                         cnt, dur = acquire_volume_burst_reconfig(
-                            volume_scanner, num_slices, w, core)
+                            volume_scanner, num_slices, w, core
+                        )
                         print(f"{cnt} imgs, {dur:.3f}s")
                     except Exception as e:
                         print(f"ERROR: {e}")
@@ -852,17 +880,21 @@ def run_benchmark_sweep(
                 # Timed repeats (cycle through profiles)
                 for r in range(num_repeats):
                     pidx = r % len(EMBRYO_PROFILES)
-                    print(f"  Repeat {r+1}/{num_repeats} "
-                          f"(profile {pidx})...", end=" ", flush=True)
+                    print(
+                        f"  Repeat {r + 1}/{num_repeats} (profile {pidx})...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
                         cnt, dur = acquire_volume_burst_reconfig(
-                            volume_scanner, num_slices, r, core)
+                            volume_scanner, num_slices, r, core
+                        )
                         res_reconfig.timings.append(dur)
                         res_reconfig.image_counts.append(cnt)
-                        print(f"{cnt} imgs, {dur:.3f}s ({1.0/dur:.1f} vol/s)")
+                        print(f"{cnt} imgs, {dur:.3f}s ({1.0 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
-                        res_reconfig.errors.append(f"repeat {r+1}: {e}")
+                        res_reconfig.errors.append(f"repeat {r + 1}: {e}")
 
                 cleanup_ophyd_burst(volume_scanner, core)
                 results.append(res_reconfig)
@@ -871,11 +903,12 @@ def run_benchmark_sweep(
             # --- Burst reconfig with waitForDevice (no time.sleep) ---
             if run_ophyd and volume_scanner is not None:
                 res_wfd = BenchmarkResult("reconfig_wfd", num_slices, exposure_ms)
-                print(f"\n[Reconfig WFD] Configuring once, "
-                      f"using waitForDevice() instead of time.sleep()...")
+                print(
+                    "\n[Reconfig WFD] Configuring once, "
+                    "using waitForDevice() instead of time.sleep()..."
+                )
                 try:
-                    configure_burst_reconfig(volume_scanner, num_slices,
-                                             exposure_ms, core)
+                    configure_burst_reconfig(volume_scanner, num_slices, exposure_ms, core)
                 except Exception as e:
                     print(f"  ERROR configuring reconfig_wfd: {e}")
                     res_wfd.errors.append(f"configure: {e}")
@@ -884,12 +917,15 @@ def run_benchmark_sweep(
 
                 # Warm-up (cycle through profiles)
                 for w in range(num_warmup):
-                    print(f"  Warm-up {w+1}/{num_warmup} "
-                          f"(profile {w % len(EMBRYO_PROFILES)})...",
-                          end=" ", flush=True)
+                    print(
+                        f"  Warm-up {w + 1}/{num_warmup} (profile {w % len(EMBRYO_PROFILES)})...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
                         cnt, dur = acquire_volume_burst_reconfig_wfd(
-                            volume_scanner, num_slices, w, core)
+                            volume_scanner, num_slices, w, core
+                        )
                         print(f"{cnt} imgs, {dur:.3f}s")
                     except Exception as e:
                         print(f"ERROR: {e}")
@@ -897,17 +933,21 @@ def run_benchmark_sweep(
                 # Timed repeats (cycle through profiles)
                 for r in range(num_repeats):
                     pidx = r % len(EMBRYO_PROFILES)
-                    print(f"  Repeat {r+1}/{num_repeats} "
-                          f"(profile {pidx})...", end=" ", flush=True)
+                    print(
+                        f"  Repeat {r + 1}/{num_repeats} (profile {pidx})...",
+                        end=" ",
+                        flush=True,
+                    )
                     try:
                         cnt, dur = acquire_volume_burst_reconfig_wfd(
-                            volume_scanner, num_slices, r, core)
+                            volume_scanner, num_slices, r, core
+                        )
                         res_wfd.timings.append(dur)
                         res_wfd.image_counts.append(cnt)
-                        print(f"{cnt} imgs, {dur:.3f}s ({1.0/dur:.1f} vol/s)")
+                        print(f"{cnt} imgs, {dur:.3f}s ({1.0 / dur:.1f} vol/s)")
                     except Exception as e:
                         print(f"ERROR: {e}")
-                        res_wfd.errors.append(f"repeat {r+1}: {e}")
+                        res_wfd.errors.append(f"repeat {r + 1}: {e}")
 
                 cleanup_ophyd_burst(volume_scanner, core)
                 results.append(res_wfd)
@@ -922,22 +962,25 @@ def run_benchmark_sweep(
 def _print_single_result(res: BenchmarkResult):
     """Print a single intermediate result."""
     if not res.timings:
-        print(f"  -> {res.approach}: NO SUCCESSFUL RUNS "
-              f"({len(res.errors)} errors)")
+        print(f"  -> {res.approach}: NO SUCCESSFUL RUNS ({len(res.errors)} errors)")
         return
-    print(f"  -> {res.approach}: {res.vol_per_sec:.2f} vol/s, "
-          f"mean={res.mean:.3f}s, std={res.std:.3f}s")
+    print(
+        f"  -> {res.approach}: {res.vol_per_sec:.2f} vol/s, "
+        f"mean={res.mean:.3f}s, std={res.std:.3f}s"
+    )
 
 
-def print_results_table(results: List[BenchmarkResult]):
+def print_results_table(results: list[BenchmarkResult]):
     """Print formatted ASCII results table."""
     if not results:
         print("No results to display.")
         return
 
-    header = (f"{'Slices':>6} | {'Exp(ms)':>7} | {'Approach':>14} | "
-              f"{'Vol/s':>7} | {'Mean(s)':>7} | {'Std(s)':>7} | "
-              f"{'Min(s)':>7} | {'Max(s)':>7} | {'Images':>6}")
+    header = (
+        f"{'Slices':>6} | {'Exp(ms)':>7} | {'Approach':>14} | "
+        f"{'Vol/s':>7} | {'Mean(s)':>7} | {'Std(s)':>7} | "
+        f"{'Min(s)':>7} | {'Max(s)':>7} | {'Images':>6}"
+    )
     sep = "-" * len(header)
 
     print(f"\n{sep}")
@@ -948,35 +991,43 @@ def print_results_table(results: List[BenchmarkResult]):
 
     for r in results:
         if r.timings:
-            print(f"{r.num_slices:>6} | {r.exposure_ms:>7.1f} | {r.approach:>14} | "
-                  f"{r.vol_per_sec:>7.2f} | {r.mean:>7.3f} | {r.std:>7.3f} | "
-                  f"{r.min_t:>7.3f} | {r.max_t:>7.3f} | {r.total_images:>6}")
+            print(
+                f"{r.num_slices:>6} | {r.exposure_ms:>7.1f} | {r.approach:>14} | "
+                f"{r.vol_per_sec:>7.2f} | {r.mean:>7.3f} | {r.std:>7.3f} | "
+                f"{r.min_t:>7.3f} | {r.max_t:>7.3f} | {r.total_images:>6}"
+            )
         else:
-            print(f"{r.num_slices:>6} | {r.exposure_ms:>7.1f} | {r.approach:>14} | "
-                  f"{'FAIL':>7} | {'---':>7} | {'---':>7} | "
-                  f"{'---':>7} | {'---':>7} | {'---':>6}")
+            print(
+                f"{r.num_slices:>6} | {r.exposure_ms:>7.1f} | {r.approach:>14} | "
+                f"{'FAIL':>7} | {'---':>7} | {'---':>7} | "
+                f"{'---':>7} | {'---':>7} | {'---':>6}"
+            )
 
     print(sep)
 
 
-def print_summary(results: List[BenchmarkResult]):
+def print_summary(results: list[BenchmarkResult]):
     """Print overhead analysis comparing ophyd and ophyd_burst vs raw."""
     from collections import defaultdict
+
     groups = defaultdict(dict)
     for r in results:
         groups[(r.num_slices, r.exposure_ms)][r.approach] = r
 
     # Need at least raw + one ophyd variant
-    has_data = [(k, v) for k, v in groups.items()
-                if "raw" in v and ("ophyd" in v or "ophyd_burst" in v
-                                   or "burst_reconfig" in v
-                                   or "reconfig_wfd" in v)]
+    has_data = [
+        (k, v)
+        for k, v in groups.items()
+        if "raw" in v
+        and ("ophyd" in v or "ophyd_burst" in v or "burst_reconfig" in v or "reconfig_wfd" in v)
+    ]
     if not has_data:
         return
 
     print()
-    header = (f"{'Slices':>6} | {'Exp(ms)':>7} | "
-              f"{'Approach':>14} | {'vs Raw(ms)':>10} | {'vs Raw(%)':>9}")
+    header = (
+        f"{'Slices':>6} | {'Exp(ms)':>7} | {'Approach':>14} | {'vs Raw(ms)':>10} | {'vs Raw(%)':>9}"
+    )
     sep = "-" * len(header)
 
     print(sep)
@@ -995,14 +1046,15 @@ def print_summary(results: List[BenchmarkResult]):
             other_mean = approaches[label].mean
             overhead_ms = (other_mean - raw_mean) * 1000.0
             overhead_pct = ((other_mean - raw_mean) / raw_mean) * 100.0
-            print(f"{ns:>6} | {exp:>7.1f} | {label:>14} | "
-                  f"{overhead_ms:>+10.1f} | {overhead_pct:>+8.1f}%")
+            print(
+                f"{ns:>6} | {exp:>7.1f} | {label:>14} | "
+                f"{overhead_ms:>+10.1f} | {overhead_pct:>+8.1f}%"
+            )
 
     print(sep)
 
 
-def save_results_csv(results: List[BenchmarkResult], path: Path,
-                     run_params: dict):
+def save_results_csv(results: list[BenchmarkResult], path: Path, run_params: dict):
     """Write benchmark results to a CSV file with full metadata."""
     import csv
     import json
@@ -1031,37 +1083,63 @@ def save_results_csv(results: List[BenchmarkResult], path: Path,
         writer.writerow([])
 
         # --- Summary table ---
-        writer.writerow([
-            "slices", "exposure_ms", "approach",
-            "vol_per_sec", "mean_s", "std_s", "min_s", "max_s",
-            "total_images", "num_repeats", "errors",
-        ])
+        writer.writerow(
+            [
+                "slices",
+                "exposure_ms",
+                "approach",
+                "vol_per_sec",
+                "mean_s",
+                "std_s",
+                "min_s",
+                "max_s",
+                "total_images",
+                "num_repeats",
+                "errors",
+            ]
+        )
         for r in results:
-            writer.writerow([
-                r.num_slices, r.exposure_ms, r.approach,
-                f"{r.vol_per_sec:.4f}" if r.timings else "",
-                f"{r.mean:.6f}" if r.timings else "",
-                f"{r.std:.6f}" if r.timings else "",
-                f"{r.min_t:.6f}" if r.timings else "",
-                f"{r.max_t:.6f}" if r.timings else "",
-                r.total_images,
-                len(r.timings),
-                "; ".join(r.errors) if r.errors else "",
-            ])
+            writer.writerow(
+                [
+                    r.num_slices,
+                    r.exposure_ms,
+                    r.approach,
+                    f"{r.vol_per_sec:.4f}" if r.timings else "",
+                    f"{r.mean:.6f}" if r.timings else "",
+                    f"{r.std:.6f}" if r.timings else "",
+                    f"{r.min_t:.6f}" if r.timings else "",
+                    f"{r.max_t:.6f}" if r.timings else "",
+                    r.total_images,
+                    len(r.timings),
+                    "; ".join(r.errors) if r.errors else "",
+                ]
+            )
 
         # --- Per-volume raw timings ---
         writer.writerow([])
         writer.writerow(["# Per-volume timings (seconds)"])
-        writer.writerow([
-            "slices", "exposure_ms", "approach",
-            "repeat", "elapsed_s", "image_count",
-        ])
+        writer.writerow(
+            [
+                "slices",
+                "exposure_ms",
+                "approach",
+                "repeat",
+                "elapsed_s",
+                "image_count",
+            ]
+        )
         for r in results:
-            for i, (t, cnt) in enumerate(zip(r.timings, r.image_counts)):
-                writer.writerow([
-                    r.num_slices, r.exposure_ms, r.approach,
-                    i + 1, f"{t:.6f}", cnt,
-                ])
+            for i, (t, cnt) in enumerate(zip(r.timings, r.image_counts, strict=False)):
+                writer.writerow(
+                    [
+                        r.num_slices,
+                        r.exposure_ms,
+                        r.approach,
+                        i + 1,
+                        f"{t:.6f}",
+                        cnt,
+                    ]
+                )
 
     print(f"\nResults saved to: {path}")
 
@@ -1076,8 +1154,10 @@ def main():
     print(f"  Slices series: {SLICES_SERIES}")
     print(f"  Exposure:      {EXPOSURE_MS} ms")
     print(f"  Repeats:       {NUM_REPEATS} (+ {NUM_WARMUP} warmup)")
-    print(f"  Approaches:    raw / ophyd / ophyd_burst / burst_reconfig / reconfig_wfd")
-    print(f"  Embryo profiles: {len(EMBRYO_PROFILES)} (for burst_reconfig & reconfig_wfd round-robin)")
+    print("  Approaches:    raw / ophyd / ophyd_burst / burst_reconfig / reconfig_wfd")
+    print(
+        f"  Embryo profiles: {len(EMBRYO_PROFILES)} (for burst_reconfig & reconfig_wfd round-robin)"
+    )
 
     # Load config and initialize
     mm_dir, config_file = load_config(config_path)
@@ -1099,7 +1179,9 @@ def main():
         print_summary(results)
 
         # Save CSV
-        csv_path = Path("results") / f"benchmark_volume_fps_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv"
+        csv_path = (
+            Path("results") / f"benchmark_volume_fps_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv"
+        )
         run_params = {
             "slices": SLICES_SERIES,
             "exposure_ms": EXPOSURE_MS,
diff --git a/diagnostics/measure_centering_error.py b/diagnostics/measure_centering_error.py
index 0f159c79..c8c22ef4 100644
--- a/diagnostics/measure_centering_error.py
+++ b/diagnostics/measure_centering_error.py
@@ -6,8 +6,9 @@
 """
 
 import json
-import numpy as np
+
 import matplotlib.pyplot as plt
+import numpy as np
 from PIL import Image
 
 # Load the image after moving to embryo
@@ -21,6 +22,7 @@
 # Store clicked position
 clicked_pos = [None, None]
 
+
 def on_click(event):
     if event.xdata is not None and event.ydata is not None:
         clicked_pos[0] = event.xdata
@@ -47,48 +49,56 @@ def on_click(event):
             "error_y_direction": "BELOW" if error_y > 0 else "ABOVE",
             "error_x_um": float(error_x_um),
             "error_y_um": float(error_y_um),
-            "um_per_pixel": um_per_pixel
+            "um_per_pixel": um_per_pixel,
         }
 
         # Write to file
-        with open(OUTPUT_FILE, 'w') as f:
+        with open(OUTPUT_FILE, "w") as f:
             json.dump(result, f, indent=2)
 
-        print(f"\n{'='*50}")
+        print(f"\n{'=' * 50}")
         print(f"CLICKED POSITION: ({clicked_pos[0]:.1f}, {clicked_pos[1]:.1f})")
         print(f"CENTER POSITION:  ({CENTER_X}, {CENTER_Y})")
-        print(f"{'='*50}")
+        print(f"{'=' * 50}")
         print(f"ERROR X: {error_x:+.1f} pixels ({result['error_x_direction']} of center)")
         print(f"ERROR Y: {error_y:+.1f} pixels ({result['error_y_direction']} center)")
-        print(f"{'='*50}")
+        print(f"{'=' * 50}")
         print(f"ERROR X: {error_x_um:+.1f} um")
         print(f"ERROR Y: {error_y_um:+.1f} um")
-        print(f"{'='*50}")
+        print(f"{'=' * 50}")
         print(f"\nSaved to: {OUTPUT_FILE}")
 
         # Update the plot with clicked marker
-        ax.plot(clicked_pos[0], clicked_pos[1], 'go', markersize=15, markeredgewidth=3,
-                markerfacecolor='none', label='Actual embryo position')
+        ax.plot(
+            clicked_pos[0],
+            clicked_pos[1],
+            "go",
+            markersize=15,
+            markeredgewidth=3,
+            markerfacecolor="none",
+            label="Actual embryo position",
+        )
         ax.legend()
         fig.canvas.draw()
 
+
 # Load image
 img = np.array(Image.open(IMAGE_PATH))
 
 # Create figure
 fig, ax = plt.subplots(figsize=(12, 12))
-ax.imshow(img, cmap='gray')
+ax.imshow(img, cmap="gray")
 
 # Draw crosshairs at center
-ax.axhline(CENTER_Y, color='red', linestyle='--', alpha=0.7, linewidth=1, label='Center')
-ax.axvline(CENTER_X, color='red', linestyle='--', alpha=0.7, linewidth=1)
-ax.plot(CENTER_X, CENTER_Y, 'r+', markersize=30, markeredgewidth=2)
+ax.axhline(CENTER_Y, color="red", linestyle="--", alpha=0.7, linewidth=1, label="Center")
+ax.axvline(CENTER_X, color="red", linestyle="--", alpha=0.7, linewidth=1)
+ax.plot(CENTER_X, CENTER_Y, "r+", markersize=30, markeredgewidth=2)
 
 ax.set_title("Click on where EMBRYO 3 actually is\n(Red crosshairs = center where it SHOULD be)")
 ax.legend()
 
 # Connect click event
-fig.canvas.mpl_connect('button_press_event', on_click)
+fig.canvas.mpl_connect("button_press_event", on_click)
 
 print("\nClick on where embryo_3 actually appears in the image.")
 print("The red crosshairs show the center (where it should be).\n")
diff --git a/diagnostics/plot_benchmark_results.py b/diagnostics/plot_benchmark_results.py
index 2eba25de..c3b5cdf1 100644
--- a/diagnostics/plot_benchmark_results.py
+++ b/diagnostics/plot_benchmark_results.py
@@ -10,14 +10,13 @@
     python diagnostics/plot_benchmark_results.py results/benchmark_volume_fps_20260127_123405.csv
 """
 
-import sys
 import csv
-from pathlib import Path
+import sys
 from collections import defaultdict
+from pathlib import Path
 
-import numpy as np
 import matplotlib.pyplot as plt
-import matplotlib.ticker as ticker
+import numpy as np
 
 
 # ---------------------------------------------------------------------------
@@ -29,7 +28,7 @@ def parse_benchmark_csv(path: Path) -> dict:
     summary = []
     per_volume = []
 
-    with open(path, "r") as f:
+    with open(path) as f:
         reader = csv.reader(f)
         section = "metadata"
 
@@ -55,27 +54,31 @@ def parse_benchmark_csv(path: Path) -> dict:
                 continue
 
             if section == "summary":
-                summary.append({
-                    "slices": int(row[0]),
-                    "exposure_ms": float(row[1]),
-                    "approach": row[2],
-                    "vol_per_sec": float(row[3]) if row[3] else None,
-                    "mean_s": float(row[4]) if row[4] else None,
-                    "std_s": float(row[5]) if row[5] else None,
-                    "min_s": float(row[6]) if row[6] else None,
-                    "max_s": float(row[7]) if row[7] else None,
-                    "total_images": int(row[8]) if row[8] else 0,
-                    "num_repeats": int(row[9]) if row[9] else 0,
-                })
+                summary.append(
+                    {
+                        "slices": int(row[0]),
+                        "exposure_ms": float(row[1]),
+                        "approach": row[2],
+                        "vol_per_sec": float(row[3]) if row[3] else None,
+                        "mean_s": float(row[4]) if row[4] else None,
+                        "std_s": float(row[5]) if row[5] else None,
+                        "min_s": float(row[6]) if row[6] else None,
+                        "max_s": float(row[7]) if row[7] else None,
+                        "total_images": int(row[8]) if row[8] else 0,
+                        "num_repeats": int(row[9]) if row[9] else 0,
+                    }
+                )
             elif section == "per_volume":
-                per_volume.append({
-                    "slices": int(row[0]),
-                    "exposure_ms": float(row[1]),
-                    "approach": row[2],
-                    "repeat": int(row[3]),
-                    "elapsed_s": float(row[4]),
-                    "image_count": int(row[5]),
-                })
+                per_volume.append(
+                    {
+                        "slices": int(row[0]),
+                        "exposure_ms": float(row[1]),
+                        "approach": row[2],
+                        "repeat": int(row[3]),
+                        "elapsed_s": float(row[4]),
+                        "image_count": int(row[5]),
+                    }
+                )
 
     return {"metadata": metadata, "summary": summary, "per_volume": per_volume}
 
@@ -102,18 +105,18 @@ def plot_throughput(data: dict, output_dir: Path):
 
     # Colors and labels
     color_map = {
-        "raw":             "#2563eb",
-        "ophyd":           "#dc2626",
-        "ophyd_burst":     "#16a34a",
-        "burst_reconfig":  "#ea580c",
-        "reconfig_wfd":    "#7c3aed",
+        "raw": "#2563eb",
+        "ophyd": "#dc2626",
+        "ophyd_burst": "#16a34a",
+        "burst_reconfig": "#ea580c",
+        "reconfig_wfd": "#7c3aed",
     }
     label_map = {
-        "raw":             "Raw MMCore",
-        "ophyd":           "Ophyd (full)",
-        "ophyd_burst":     "Ophyd burst",
-        "burst_reconfig":  "Reconfig (sleep)",
-        "reconfig_wfd":    "Reconfig (waitForDevice)",
+        "raw": "Raw MMCore",
+        "ophyd": "Ophyd (full)",
+        "ophyd_burst": "Ophyd burst",
+        "burst_reconfig": "Reconfig (sleep)",
+        "reconfig_wfd": "Reconfig (waitForDevice)",
     }
 
     fig, ax = plt.subplots(figsize=(10, 5.5))
@@ -124,16 +127,27 @@ def plot_throughput(data: dict, output_dir: Path):
     for i, approach in enumerate(approaches):
         vals = [vps[s].get(approach, 0) for s in slices_set]
         offset = (i - n / 2 + 0.5) * width
-        bars = ax.bar(x + offset, vals, width * 0.92,
-                       label=label_map.get(approach, approach),
-                       color=color_map.get(approach, "#888"),
-                       edgecolor="white", linewidth=0.5)
+        bars = ax.bar(
+            x + offset,
+            vals,
+            width * 0.92,
+            label=label_map.get(approach, approach),
+            color=color_map.get(approach, "#888"),
+            edgecolor="white",
+            linewidth=0.5,
+        )
         # Value labels on bars
-        for bar, v in zip(bars, vals):
+        for bar, v in zip(bars, vals, strict=False):
             if v > 0:
-                ax.text(bar.get_x() + bar.get_width() / 2, bar.get_height() + 0.02,
-                        f"{v:.2f}", ha="center", va="bottom", fontsize=7,
-                        fontweight="bold")
+                ax.text(
+                    bar.get_x() + bar.get_width() / 2,
+                    bar.get_height() + 0.02,
+                    f"{v:.2f}",
+                    ha="center",
+                    va="bottom",
+                    fontsize=7,
+                    fontweight="bold",
+                )
 
     ax.set_xlabel("Slices per volume", fontsize=11)
     ax.set_ylabel("Volumes per second", fontsize=11)
@@ -149,7 +163,7 @@ def plot_throughput(data: dict, output_dir: Path):
     fig.tight_layout()
     fig.savefig(output_dir / "benchmark_throughput.png", dpi=180)
     plt.close(fig)
-    print(f"  Saved: benchmark_throughput.png")
+    print("  Saved: benchmark_throughput.png")
 
 
 # ---------------------------------------------------------------------------
@@ -167,14 +181,14 @@ def plot_overhead(data: dict, output_dir: Path):
 
     compare = ["ophyd", "burst_reconfig", "reconfig_wfd"]
     color_map = {
-        "ophyd":           "#dc2626",
-        "burst_reconfig":  "#ea580c",
-        "reconfig_wfd":    "#7c3aed",
+        "ophyd": "#dc2626",
+        "burst_reconfig": "#ea580c",
+        "reconfig_wfd": "#7c3aed",
     }
     label_map = {
-        "ophyd":           "Ophyd (full teardown/setup)",
-        "burst_reconfig":  "Reconfig (time.sleep)",
-        "reconfig_wfd":    "Reconfig (waitForDevice)",
+        "ophyd": "Ophyd (full teardown/setup)",
+        "burst_reconfig": "Reconfig (time.sleep)",
+        "reconfig_wfd": "Reconfig (waitForDevice)",
     }
 
     overhead = defaultdict(dict)
@@ -192,15 +206,26 @@ def plot_overhead(data: dict, output_dir: Path):
     for i, approach in enumerate(compare):
         vals = [overhead[s].get(approach, 0) for s in slices_set]
         offset = (i - n / 2 + 0.5) * width
-        bars = ax.bar(x + offset, vals, width * 0.92,
-                       label=label_map.get(approach, approach),
-                       color=color_map.get(approach, "#888"),
-                       edgecolor="white", linewidth=0.5)
-        for bar, v in zip(bars, vals):
+        bars = ax.bar(
+            x + offset,
+            vals,
+            width * 0.92,
+            label=label_map.get(approach, approach),
+            color=color_map.get(approach, "#888"),
+            edgecolor="white",
+            linewidth=0.5,
+        )
+        for bar, v in zip(bars, vals, strict=False):
             if v > 0:
-                ax.text(bar.get_x() + bar.get_width() / 2, bar.get_height() + 8,
-                        f"{v:.0f}", ha="center", va="bottom", fontsize=8,
-                        fontweight="bold")
+                ax.text(
+                    bar.get_x() + bar.get_width() / 2,
+                    bar.get_height() + 8,
+                    f"{v:.0f}",
+                    ha="center",
+                    va="bottom",
+                    fontsize=8,
+                    fontweight="bold",
+                )
 
     ax.set_xlabel("Slices per volume", fontsize=11)
     ax.set_ylabel("Overhead vs raw MMCore (ms)", fontsize=11)
@@ -216,7 +241,7 @@ def plot_overhead(data: dict, output_dir: Path):
     fig.tight_layout()
     fig.savefig(output_dir / "benchmark_overhead.png", dpi=180)
     plt.close(fig)
-    print(f"  Saved: benchmark_overhead.png")
+    print("  Saved: benchmark_overhead.png")
 
 
 # ---------------------------------------------------------------------------
@@ -243,20 +268,35 @@ def plot_wfd_savings(data: dict, output_dir: Path):
     x = np.arange(len(slices_set))
     width = 0.32
 
-    for i, (approach, label, color) in enumerate([
-        ("burst_reconfig", "sleep()", "#ea580c"),
-        ("reconfig_wfd", "waitForDevice()", "#7c3aed"),
-    ]):
+    for i, (approach, label, color) in enumerate(
+        [
+            ("burst_reconfig", "sleep()", "#ea580c"),
+            ("reconfig_wfd", "waitForDevice()", "#7c3aed"),
+        ]
+    ):
         acq_times = [raw_means.get(s, 0) for s in slices_set]
         overheads = [means[s].get(approach, 0) - raw_means.get(s, 0) for s in slices_set]
 
         offset = (i - 0.5) * width
-        ax.bar(x + offset, acq_times, width * 0.92,
-               color="#93c5fd", edgecolor="white", linewidth=0.5,
-               label="Acquisition time" if i == 0 else None)
-        ax.bar(x + offset, overheads, width * 0.92,
-               bottom=acq_times, color=color, edgecolor="white", linewidth=0.5,
-               label=f"Overhead ({label})")
+        ax.bar(
+            x + offset,
+            acq_times,
+            width * 0.92,
+            color="#93c5fd",
+            edgecolor="white",
+            linewidth=0.5,
+            label="Acquisition time" if i == 0 else None,
+        )
+        ax.bar(
+            x + offset,
+            overheads,
+            width * 0.92,
+            bottom=acq_times,
+            color=color,
+            edgecolor="white",
+            linewidth=0.5,
+            label=f"Overhead ({label})",
+        )
 
     ax.set_xlabel("Slices per volume", fontsize=11)
     ax.set_ylabel("Total time per volume (s)", fontsize=11)
@@ -282,27 +322,53 @@ def plot_wfd_savings(data: dict, output_dir: Path):
         savings.append(so - wo)
 
     bar_width = 0.55
-    bars_sleep = ax2.barh(x + 0.15, sleep_overhead, bar_width * 0.48,
-                           color="#ea580c", label="time.sleep() overhead")
-    bars_wfd = ax2.barh(x - 0.15, wfd_overhead, bar_width * 0.48,
-                         color="#7c3aed", label="waitForDevice() overhead")
-
-    for bar, val, sav in zip(bars_sleep, sleep_overhead, savings):
-        ax2.text(bar.get_width() + 8, bar.get_y() + bar.get_height() / 2,
-                 f"{val:.0f}ms", va="center", fontsize=9, color="#ea580c",
-                 fontweight="bold")
-    for bar, val in zip(bars_wfd, wfd_overhead):
-        ax2.text(bar.get_width() + 8, bar.get_y() + bar.get_height() / 2,
-                 f"{val:.0f}ms", va="center", fontsize=9, color="#7c3aed",
-                 fontweight="bold")
+    bars_sleep = ax2.barh(
+        x + 0.15,
+        sleep_overhead,
+        bar_width * 0.48,
+        color="#ea580c",
+        label="time.sleep() overhead",
+    )
+    bars_wfd = ax2.barh(
+        x - 0.15,
+        wfd_overhead,
+        bar_width * 0.48,
+        color="#7c3aed",
+        label="waitForDevice() overhead",
+    )
+
+    for bar, val, _sav in zip(bars_sleep, sleep_overhead, savings, strict=False):
+        ax2.text(
+            bar.get_width() + 8,
+            bar.get_y() + bar.get_height() / 2,
+            f"{val:.0f}ms",
+            va="center",
+            fontsize=9,
+            color="#ea580c",
+            fontweight="bold",
+        )
+    for bar, val in zip(bars_wfd, wfd_overhead, strict=False):
+        ax2.text(
+            bar.get_width() + 8,
+            bar.get_y() + bar.get_height() / 2,
+            f"{val:.0f}ms",
+            va="center",
+            fontsize=9,
+            color="#7c3aed",
+            fontweight="bold",
+        )
 
     # Add savings annotation
-    for i, (s, sav) in enumerate(zip(slices_set, savings)):
-        ax2.annotate(f"-{sav:.0f}ms",
-                     xy=(sleep_overhead[i], i + 0.15),
-                     xytext=(sleep_overhead[i] + 60, i + 0.35),
-                     fontsize=8.5, fontweight="bold", color="#166534",
-                     arrowprops=dict(arrowstyle="->", color="#166534", lw=1.2))
+    for i, (_s, sav) in enumerate(zip(slices_set, savings, strict=False)):
+        ax2.annotate(
+            f"-{sav:.0f}ms",
+            xy=(sleep_overhead[i], i + 0.15),
+            xytext=(sleep_overhead[i] + 60, i + 0.35),
+            fontsize=8.5,
+            fontweight="bold",
+            color="#166534",
+            arrowprops=dict(arrowstyle="->", color="#166534", lw=1.2),
+        )
 
     ax2.set_yticks(x)
     ax2.set_yticklabels([f"{s} slices" for s in slices_set])
@@ -316,7 +382,7 @@ def plot_wfd_savings(data: dict, output_dir: Path):
     fig.tight_layout()
     fig.savefig(output_dir / "benchmark_wfd_savings.png", dpi=180)
     plt.close(fig)
-    print(f"  Saved: benchmark_wfd_savings.png")
+    print("  Saved: benchmark_wfd_savings.png")
 
 
 # ---------------------------------------------------------------------------
@@ -328,18 +394,18 @@ def plot_consistency(data: dict, output_dir: Path):
 
     approaches_order = ["raw", "ophyd_burst", "reconfig_wfd", "burst_reconfig", "ophyd"]
     label_map = {
-        "raw":             "Raw\nMMCore",
-        "ophyd":           "Ophyd\n(full)",
-        "ophyd_burst":     "Ophyd\nburst",
-        "burst_reconfig":  "Reconfig\n(sleep)",
-        "reconfig_wfd":    "Reconfig\n(wfd)",
+        "raw": "Raw\nMMCore",
+        "ophyd": "Ophyd\n(full)",
+        "ophyd_burst": "Ophyd\nburst",
+        "burst_reconfig": "Reconfig\n(sleep)",
+        "reconfig_wfd": "Reconfig\n(wfd)",
     }
     color_map = {
-        "raw":             "#2563eb",
-        "ophyd":           "#dc2626",
-        "ophyd_burst":     "#16a34a",
-        "burst_reconfig":  "#ea580c",
-        "reconfig_wfd":    "#7c3aed",
+        "raw": "#2563eb",
+        "ophyd": "#dc2626",
+        "ophyd_burst": "#16a34a",
+        "burst_reconfig": "#ea580c",
+        "reconfig_wfd": "#7c3aed",
     }
 
     slices_set = sorted(set(r["slices"] for r in per_volume))
@@ -348,21 +414,28 @@ def plot_consistency(data: dict, output_dir: Path):
     if len(slices_set) == 1:
         axes = [axes]
 
-    for ax, ns in zip(axes, slices_set):
+    for ax, ns in zip(axes, slices_set, strict=False):
         box_data = []
         labels = []
         colors = []
         for approach in approaches_order:
-            timings = [r["elapsed_s"] for r in per_volume
-                       if r["slices"] == ns and r["approach"] == approach]
+            timings = [
+                r["elapsed_s"]
+                for r in per_volume
+                if r["slices"] == ns and r["approach"] == approach
+            ]
             if timings:
                 box_data.append(timings)
                 labels.append(label_map.get(approach, approach))
                 colors.append(color_map.get(approach, "#888"))
 
-        bp = ax.boxplot(box_data, patch_artist=True, widths=0.55,
-                         medianprops=dict(color="black", linewidth=1.5))
-        for patch, c in zip(bp["boxes"], colors):
+        bp = ax.boxplot(
+            box_data,
+            patch_artist=True,
+            widths=0.55,
+            medianprops=dict(color="black", linewidth=1.5),
+        )
+        for patch, c in zip(bp["boxes"], colors, strict=False):
             patch.set_facecolor(c)
             patch.set_alpha(0.7)
 
@@ -377,7 +450,7 @@ def plot_consistency(data: dict, output_dir: Path):
     fig.tight_layout()
     fig.savefig(output_dir / "benchmark_consistency.png", dpi=180, bbox_inches="tight")
     plt.close(fig)
-    print(f"  Saved: benchmark_consistency.png")
+    print("  Saved: benchmark_consistency.png")
 
 
 # ---------------------------------------------------------------------------
diff --git a/diagnostics/run_multi_embryo_volumes.py b/diagnostics/run_multi_embryo_volumes.py
index d52aeada..90af3c68 100644
--- a/diagnostics/run_multi_embryo_volumes.py
+++ b/diagnostics/run_multi_embryo_volumes.py
@@ -9,14 +9,15 @@
     python run_multi_embryo_volumes.py
 """
 
-import time
 import json
-import numpy as np
-from pathlib import Path
+import time
 from datetime import datetime, timedelta
-from client import get_mmc
-import tifffile
+from pathlib import Path
+
+import numpy as np
 import rpyc
+import tifffile
+from client import get_mmc
 from tqdm import tqdm
 
 # Device configuration
@@ -36,9 +37,11 @@
 def load_database():
     """Load embryo database."""
     if not DATABASE_FILE.exists():
-        raise FileNotFoundError(f"Database not found: {DATABASE_FILE}\nRun multi_embryo_calibration.py first!")
+        raise FileNotFoundError(
+            f"Database not found: {DATABASE_FILE}\nRun multi_embryo_calibration.py first!"
+        )
 
-    with open(DATABASE_FILE, 'r') as f:
+    with open(DATABASE_FILE) as f:
         return json.load(f)
 
 
@@ -58,8 +61,8 @@ def move_to_embryo(embryo_data):
     embryo_data : dict
         Embryo information from database
     """
-    target_x = embryo_data['stage_position_after_centering_um']['x']
-    target_y = embryo_data['stage_position_after_centering_um']['y']
+    target_x = embryo_data["stage_position_after_centering_um"]["x"]
+    target_y = embryo_data["stage_position_after_centering_um"]["y"]
 
     print(f"  Moving to embryo position: ({target_x:.2f}, {target_y:.2f}) µm")
 
@@ -94,7 +97,7 @@ def configure_hardware_for_volume(calibration, num_slices):
 
     # Stop any existing sequence acquisition (from previous embryo or calibration)
     if core.isSequenceRunning():
-        print(f"    Stopping previous sequence...")
+        print("    Stopping previous sequence...")
         core.stopSequenceAcquisition()
         time.sleep(0.5)
 
@@ -105,14 +108,14 @@ def configure_hardware_for_volume(calibration, num_slices):
     try:
         core.setProperty(GALVO_DEVICE, "SPIMState", "Idle")
         time.sleep(0.2)
-    except:
+    except Exception:
         pass
 
     # Extract calibration parameters
-    slope = calibration['slope_um_per_deg']
-    offset = calibration['offset_um']
-    galvo_top = calibration.get('edge_top_deg', calibration['galvo_top_deg'])
-    galvo_bottom = calibration.get('edge_bottom_deg', calibration['galvo_bottom_deg'])
+    slope = calibration["slope_um_per_deg"]
+    offset = calibration["offset_um"]
+    galvo_top = calibration.get("edge_top_deg", calibration["galvo_top_deg"])
+    galvo_bottom = calibration.get("edge_bottom_deg", calibration["galvo_bottom_deg"])
 
     # Calculate galvo parameters
     galvo_center = (galvo_top + galvo_bottom) / 2.0
@@ -126,8 +129,14 @@ def configure_hardware_for_volume(calibration, num_slices):
     piezo_range = piezo_bottom - piezo_top
     piezo_amplitude = piezo_range / 2.0
 
-    print(f"    Galvo: center={galvo_center:+.4f}°, amplitude=±{galvo_amplitude:.4f}° (range: {galvo_range:.4f}°)")
-    print(f"    Piezo: center={piezo_center:.1f}µm, amplitude=±{piezo_amplitude:.1f}µm (range: {piezo_range:.1f}µm)")
+    print(
+        f"    Galvo: center={galvo_center:+.4f}°, amplitude=±{galvo_amplitude:.4f}°"
+        f" (range: {galvo_range:.4f}°)"
+    )
+    print(
+        f"    Piezo: center={piezo_center:.1f}µm, amplitude=±{piezo_amplitude:.1f}µm"
+        f" (range: {piezo_range:.1f}µm)"
+    )
 
     # System startup
     core.setConfig("System", "Startup")
@@ -189,13 +198,13 @@ def configure_hardware_for_volume(calibration, num_slices):
     core.setProperty(PIEZO_DEVICE, "SPIMState", "Armed")
 
     time.sleep(0.3)
-    print(f"  ✓ Hardware configured for hardware-triggered acquisition")
+    print("  ✓ Hardware configured for hardware-triggered acquisition")
 
     return {
-        'galvo_center': galvo_center,
-        'galvo_amplitude': galvo_amplitude,
-        'piezo_center': piezo_center,
-        'piezo_amplitude': piezo_amplitude
+        "galvo_center": galvo_center,
+        "galvo_amplitude": galvo_amplitude,
+        "piezo_center": piezo_center,
+        "piezo_amplitude": piezo_amplitude,
     }
 
 
@@ -238,7 +247,7 @@ def acquire_volume_for_embryo(embryo_id, calibration, num_slices=50):
 
     # Trigger SPIM state machine
     core.setProperty(GALVO_DEVICE, "SPIMState", "Running")
-    print(f"  ✓ SPIM triggered")
+    print("  ✓ SPIM triggered")
 
     # Collect images
     images = []
@@ -296,52 +305,59 @@ def save_volume(volume, embryo_id, embryo_number, output_dir):
 
 def main():
     """Main multi-embryo volume acquisition workflow."""
-    print(f"{'='*70}")
+    print(f"{'=' * 70}")
     print("MULTI-EMBRYO VOLUME ACQUISITION")
-    print(f"{'='*70}")
+    print(f"{'=' * 70}")
 
     try:
         # Load database
-        print(f"\n{'='*70}")
+        print(f"\n{'=' * 70}")
         print("LOADING DATABASE")
-        print(f"{'='*70}")
+        print(f"{'=' * 70}")
         database = load_database()
 
-        embryos = database.get('embryos', {})
+        embryos = database.get("embryos", {})
         num_embryos = len(embryos)
 
         print(f"  Database: {DATABASE_FILE}")
         print(f"  Found {num_embryos} embryo(s)")
 
         if num_embryos == 0:
-            print(f"\n  ⚠ No embryos in database!")
-            print(f"  Run multi_embryo_calibration.py first.")
+            print("\n  ⚠ No embryos in database!")
+            print("  Run multi_embryo_calibration.py first.")
             return
 
         # List embryos
-        print(f"\n  Embryos:")
+        print("\n  Embryos:")
         for emb_id, emb_data in embryos.items():
-            emb_num = emb_data.get('embryo_number', '?')
-            pos = emb_data['stage_position_after_centering_um']
+            emb_num = emb_data.get("embryo_number", "?")
+            pos = emb_data["stage_position_after_centering_um"]
             print(f"    {emb_id} (#{emb_num}): ({pos['x']:.1f}, {pos['y']:.1f}) µm")
 
         # Acquisition parameters
-        print(f"\n{'='*70}")
+        print(f"\n{'=' * 70}")
         print("ACQUISITION PARAMETERS")
-        print(f"{'='*70}")
+        print(f"{'=' * 70}")
 
-        num_slices = int(input(f"  Number of slices per volume (default 50): ").strip() or "50")
+        num_slices = int(input("  Number of slices per volume (default 50): ").strip() or "50")
         print(f"  ✓ Will acquire {num_slices} slices per embryo")
 
         # Timelapse parameters
-        num_timepoints = int(input(f"  Number of timepoints (default 1 for single acquisition): ").strip() or "1")
+        num_timepoints = int(
+            input("  Number of timepoints (default 1 for single acquisition): ").strip() or "1"
+        )
         interval_minutes = 0
         if num_timepoints > 1:
-            interval_minutes = float(input(f"  Interval between timepoints in minutes (e.g., 2): ").strip() or "2")
+            interval_minutes = float(
+                input("  Interval between timepoints in minutes (e.g., 2): ").strip() or "2"
+            )
             total_duration_hours = (num_timepoints - 1) * interval_minutes / 60.0
-            print(f"  ✓ Timelapse: {num_timepoints} timepoints every {interval_minutes} min ({total_duration_hours:.1f} hours total)")
+            print(
+                f"  ✓ Timelapse: {num_timepoints} timepoints every {interval_minutes} min"
+                f" ({total_duration_hours:.1f} hours total)"
+            )
         else:
-            print(f"  ✓ Single acquisition (no timelapse)")
+            print("  ✓ Single acquisition (no timelapse)")
 
         # Create output directory
         session_dir = OUTPUT_DIR / datetime.now().strftime("%Y%m%d_%H%M%S")
@@ -358,8 +374,11 @@ def main():
             desc="Timepoints",
             unit="tp",
             position=0,
-            colour='green',
-            bar_format='{desc}: {percentage:3.0f}%|{bar}| {n_fmt}/{total_fmt} [{elapsed}<{remaining}, {rate_fmt}]'
+            colour="green",
+            bar_format=(
+                "{desc}: {percentage:3.0f}%|{bar}| {n_fmt}/{total_fmt}"
+                " [{elapsed}<{remaining}, {rate_fmt}]"
+            ),
         )
 
         for timepoint in range(num_timepoints):
@@ -367,13 +386,15 @@ def main():
             elapsed_hours = (timepoint_start_time - session_start_time) / 3600.0
 
             # Update timepoint progress bar
-            timepoint_pbar.set_description(f"Timepoint {timepoint+1}/{num_timepoints} (Elapsed: {elapsed_hours:.1f}h)")
+            timepoint_pbar.set_description(
+                f"Timepoint {timepoint + 1}/{num_timepoints} (Elapsed: {elapsed_hours:.1f}h)"
+            )
 
-            print(f"\n{'='*70}")
+            print(f"\n{'=' * 70}")
             print(f"TIMEPOINT {timepoint + 1}/{num_timepoints}")
             if num_timepoints > 1:
                 print(f"Elapsed: {elapsed_hours:.2f} hours")
-            print(f"{'='*70}")
+            print(f"{'=' * 70}")
 
             # Acquire volume for each embryo
             timepoint_results = []
@@ -385,51 +406,53 @@ def main():
                 unit="embryo",
                 position=1,
                 leave=False,
-                colour='cyan'
+                colour="cyan",
             )
 
             for idx, (emb_id, emb_data) in enumerate(embryos.items(), 1):
-                emb_num = emb_data.get('embryo_number', idx)
+                emb_num = emb_data.get("embryo_number", idx)
 
                 embryo_pbar.set_description(f"  Embryo {emb_num} (t{timepoint:04d})")
 
                 print(f"\n[Embryo {idx}/{num_embryos}] {emb_id} (Embryo #{emb_num})")
-                print(f"{'─'*70}")
+                print(f"{'─' * 70}")
 
                 # Move to embryo
                 move_to_embryo(emb_data)
 
                 # Configure hardware
-                calibration = emb_data['calibration']
+                calibration = emb_data["calibration"]
                 configure_hardware_for_volume(calibration, num_slices)
 
                 # Acquire volume
                 volume = acquire_volume_for_embryo(emb_id, calibration, num_slices)
 
                 if volume is None:
-                    print(f"  ✗ Failed to acquire volume")
-                    timepoint_results.append({
-                        'embryo_id': emb_id,
-                        'timepoint': timepoint,
-                        'success': False
-                    })
+                    print("  ✗ Failed to acquire volume")
+                    timepoint_results.append(
+                        {"embryo_id": emb_id, "timepoint": timepoint, "success": False}
+                    )
                     embryo_pbar.update(1)
                     continue
 
                 # Save volume with timepoint in filename
                 timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
-                filename = session_dir / f"{emb_id}_embryo{emb_num:03d}_t{timepoint:04d}_{timestamp}.tif"
+                filename = (
+                    session_dir / f"{emb_id}_embryo{emb_num:03d}_t{timepoint:04d}_{timestamp}.tif"
+                )
                 tifffile.imwrite(filename, volume)
                 print(f"  ✓ Saved: {filename.name}")
 
-                timepoint_results.append({
-                    'embryo_id': emb_id,
-                    'embryo_number': emb_num,
-                    'timepoint': timepoint,
-                    'success': True,
-                    'filename': str(filename),
-                    'shape': volume.shape
-                })
+                timepoint_results.append(
+                    {
+                        "embryo_id": emb_id,
+                        "embryo_number": emb_num,
+                        "timepoint": timepoint,
+                        "success": True,
+                        "filename": str(filename),
+                        "shape": volume.shape,
+                    }
+                )
 
                 print(f"  ✓ Complete: {volume.shape}")
                 embryo_pbar.update(1)
@@ -447,10 +470,10 @@ def main():
 
                 if wait_time > 0:
                     next_timepoint_time = datetime.now() + timedelta(seconds=wait_time)
-                    print(f"\n{'─'*70}")
-                    print(f"Waiting {wait_time/60:.1f} minutes until next timepoint...")
+                    print(f"\n{'─' * 70}")
+                    print(f"Waiting {wait_time / 60:.1f} minutes until next timepoint...")
                     print(f"Next timepoint at: {next_timepoint_time.strftime('%H:%M:%S')}")
-                    print(f"{'─'*70}")
+                    print(f"{'─' * 70}")
 
                     # Progress bar for waiting
                     wait_pbar = tqdm(
@@ -459,7 +482,7 @@ def main():
                         unit="s",
                         position=1,
                         leave=False,
-                        colour='yellow'
+                        colour="yellow",
                     )
                     for _ in range(int(wait_time)):
                         time.sleep(1)
@@ -469,70 +492,81 @@ def main():
                     # Sleep remaining fractional seconds
                     time.sleep(wait_time - int(wait_time))
                 else:
-                    print(f"\n{'─'*70}")
-                    print(f"⚠ Warning: Acquisition took {timepoint_duration/60:.1f} min (longer than {interval_minutes} min interval)")
-                    print(f"Proceeding immediately to next timepoint...")
-                    print(f"{'─'*70}")
+                    print(f"\n{'─' * 70}")
+                    print(
+                        f"⚠ Warning: Acquisition took {timepoint_duration / 60:.1f} min"
+                        f" (longer than {interval_minutes} min interval)"
+                    )
+                    print("Proceeding immediately to next timepoint...")
+                    print(f"{'─' * 70}")
 
         timepoint_pbar.close()
 
         # Cleanup
-        print(f"\n{'='*70}")
+        print(f"\n{'=' * 70}")
         print("CLEANUP")
-        print(f"{'='*70}")
+        print(f"{'=' * 70}")
         core.setConfig("Laser", "ALL OFF")
-        print(f"  ✓ Lasers OFF")
+        print("  ✓ Lasers OFF")
 
         # Summary
-        print(f"\n{'='*70}")
+        print(f"\n{'=' * 70}")
         print("ACQUISITION COMPLETE")
-        print(f"{'='*70}")
+        print(f"{'=' * 70}")
 
         total_duration = time.time() - session_start_time
-        successful = sum(1 for r in all_results if r['success'])
+        successful = sum(1 for r in all_results if r["success"])
         total_acquisitions = num_embryos * num_timepoints
 
-        print(f"\n  Session duration: {total_duration/3600:.2f} hours")
+        print(f"\n  Session duration: {total_duration / 3600:.2f} hours")
         print(f"  Timepoints: {num_timepoints}")
         print(f"  Embryos per timepoint: {num_embryos}")
         print(f"  Successful acquisitions: {successful}/{total_acquisitions}")
         print(f"  Output directory: {session_dir}")
 
-        print(f"\n  Results:")
+        print("\n  Results:")
         for result in all_results:
-            if result['success']:
-                t = result.get('timepoint', 0)
-                print(f"    ✓ {result['embryo_id']} t{t:04d}: {result['shape']} → {Path(result['filename']).name}")
+            if result["success"]:
+                t = result.get("timepoint", 0)
+                print(
+                    f"    ✓ {result['embryo_id']} t{t:04d}: {result['shape']}"
+                    f" → {Path(result['filename']).name}"
+                )
             else:
-                t = result.get('timepoint', 0)
+                t = result.get("timepoint", 0)
                 print(f"    ✗ {result['embryo_id']} t{t:04d}: Failed")
 
         # Save acquisition log
         log_file = session_dir / "acquisition_log.json"
-        with open(log_file, 'w') as f:
-            json.dump({
-                'timestamp': datetime.now().isoformat(),
-                'session_duration_hours': total_duration / 3600.0,
-                'num_embryos': num_embryos,
-                'num_slices': num_slices,
-                'num_timepoints': num_timepoints,
-                'interval_minutes': interval_minutes,
-                'total_acquisitions': total_acquisitions,
-                'successful_acquisitions': successful,
-                'results': all_results
-            }, f, indent=2)
+        with open(log_file, "w") as f:
+            json.dump(
+                {
+                    "timestamp": datetime.now().isoformat(),
+                    "session_duration_hours": total_duration / 3600.0,
+                    "num_embryos": num_embryos,
+                    "num_slices": num_slices,
+                    "num_timepoints": num_timepoints,
+                    "interval_minutes": interval_minutes,
+                    "total_acquisitions": total_acquisitions,
+                    "successful_acquisitions": successful,
+                    "results": all_results,
+                },
+                f,
+                indent=2,
+            )
 
         print(f"\n  ✓ Log saved: {log_file}")
-        print(f"\n{'='*70}\n")
+        print(f"\n{'=' * 70}\n")
 
     except KeyboardInterrupt:
-        print(f"\n\nInterrupted\n")
+        print("\n\nInterrupted\n")
     except Exception as e:
-        print(f"\n{'='*70}")
+        print(f"\n{'=' * 70}")
         print("ERROR")
-        print(f"{'='*70}")
+        print(f"{'=' * 70}")
         print(f"Error: {e}")
         import traceback
+
         traceback.print_exc()
 
 
diff --git a/diagnostics/segment_embryo_nuclei.py b/diagnostics/segment_embryo_nuclei.py
index a99538c8..b9c0405f 100644
--- a/diagnostics/segment_embryo_nuclei.py
+++ b/diagnostics/segment_embryo_nuclei.py
@@ -3,11 +3,12 @@
 Run with venv_cv: venv_cv/Scripts/python segment_embryo_nuclei.py
 """
 
+from pathlib import Path
+
+import napari
 import numpy as np
 import tifffile
-from pathlib import Path
 from cellpose import models
-import napari
 
 
 def load_volume(tiff_path: Path) -> np.ndarray:
@@ -39,10 +40,10 @@ def segment_nuclei_3d(volume: np.ndarray, diameter: float = 30.0) -> np.ndarray:
     masks, flows, styles = model.eval(
         vol_norm,
         diameter=diameter,
-        do_3D=False,           # 2D per slice (fast!)
+        do_3D=False,  # 2D per slice (fast!)
         z_axis=0,
         stitch_threshold=0.5,  # stitch 2D masks into 3D
-        batch_size=64,         # larger batch for speed
+        batch_size=64,  # larger batch for speed
     )
 
     n_nuclei = len(np.unique(masks)) - 1
@@ -76,6 +77,7 @@ def main():
 
     # Downsample by factor of 2
     from scipy.ndimage import zoom
+
     volume = zoom(volume, (1, 0.5, 0.5), order=1)
     print(f"  Downsampled 2x: {volume.shape}")
 
@@ -85,7 +87,7 @@ def main():
     # Visualize in Napari
     print("Opening Napari viewer...")
     viewer = napari.Viewer()
-    viewer.add_image(volume, name="Volume", colormap='gray')
+    viewer.add_image(volume, name="Volume", colormap="gray")
     viewer.add_labels(masks, name="Nuclei segmentation")
     napari.run()
 
diff --git a/diagnostics/spim_hardware_triggering_reference.py b/diagnostics/spim_hardware_triggering_reference.py
index cab5cfb1..87a9f7a4 100644
--- a/diagnostics/spim_hardware_triggering_reference.py
+++ b/diagnostics/spim_hardware_triggering_reference.py
@@ -70,9 +70,11 @@
 """
 
 import time
+
 import numpy as np
 from client import get_mmc
 
+
 def configure_camera_for_hardware_trigger(core, camera_name, exposure_ms):
     """
     Configure Hamamatsu camera for external edge triggering in light sheet mode.
@@ -132,8 +134,15 @@ def configure_camera_for_hardware_trigger(core, camera_name, exposure_ms):
         raise Exception(f"Failed to set TRIGGER ACTIVE to EDGE (got: {trigger_active})")
 
 
-def configure_spim_scanner(core, scanner_name, num_slices, slice_step_um,
-                          scan_duration_ms, camera_duration_ms, laser_duration_ms):
+def configure_spim_scanner(
+    core,
+    scanner_name,
+    num_slices,
+    slice_step_um,
+    scan_duration_ms,
+    camera_duration_ms,
+    laser_duration_ms,
+):
     """
     Configure ASI Tiger scanner for SPIM state machine operation.
 
@@ -180,7 +189,7 @@ def configure_spim_scanner(core, scanner_name, num_slices, slice_step_um,
     core.setProperty(scanner_name, "SingleAxisYPattern", "1 - Triangle")
     core.setProperty(scanner_name, "SingleAxisYMode", "3 - Enabled with axes synced")
 
-    print(f"  X-axis (light sheet): Amplitude=2.0°, Pattern=Triangle, Mode=Synced")
+    print("  X-axis (light sheet): Amplitude=2.0°, Pattern=Triangle, Mode=Synced")
     print(f"  Y-axis (slice step): Amplitude={y_amplitude:.4f}°, Pattern=Triangle, Mode=Synced")
     print(f"    (Calculated for {num_slices} slices × {slice_step_um} μm steps)")
 
@@ -206,7 +215,7 @@ def configure_spim_scanner(core, scanner_name, num_slices, slice_step_um,
     core.setProperty(scanner_name, "SPIMDelayBeforeScan(ms)", 0.0)
     core.setProperty(scanner_name, "SPIMDelayBeforeCamera(ms)", 0.5)
 
-    print(f"  SPIM State Machine:")
+    print("  SPIM State Machine:")
     print(f"    NumSlices: {num_slices}")
     print(f"    ScanDuration: {scan_duration_ms} ms (total time per slice)")
     print(f"    CameraDuration: {camera_duration_ms} ms (TTL trigger pulse width)")
@@ -214,10 +223,16 @@ def configure_spim_scanner(core, scanner_name, num_slices, slice_step_um,
 
     # Verify critical timing relationships
     if camera_duration_ms > scan_duration_ms:
-        raise Exception(f"CameraDuration ({camera_duration_ms}ms) must be <= ScanDuration ({scan_duration_ms}ms)")
+        raise Exception(
+            f"CameraDuration ({camera_duration_ms}ms) must be <="
+            f" ScanDuration ({scan_duration_ms}ms)"
+        )
 
     if laser_duration_ms > camera_duration_ms:
-        raise Exception(f"LaserDuration ({laser_duration_ms}ms) must be <= CameraDuration ({camera_duration_ms}ms)")
+        raise Exception(
+            f"LaserDuration ({laser_duration_ms}ms) must be <="
+            f" CameraDuration ({camera_duration_ms}ms)"
+        )
 
 
 def arm_spim_state_machine(core, scanner_name):
@@ -256,8 +271,9 @@ def trigger_spim_acquisition(core, scanner_name):
     print(f"  SPIMState: {state}")
 
 
-def acquire_spim_volume(core, camera_name, scanner_name, num_slices,
-                       scan_duration_ms, timeout_extra_sec=5.0):
+def acquire_spim_volume(
+    core, camera_name, scanner_name, num_slices, scan_duration_ms, timeout_extra_sec=5.0
+):
     """
     Perform hardware-triggered SPIM volume acquisition.
 
@@ -337,7 +353,10 @@ def acquire_spim_volume(core, camera_name, scanner_name, num_slices,
             count = core.getRemainingImageCount()
             seq_running = core.isSequenceRunning(camera_name)
             spim_state = core.getProperty(scanner_name, "SPIMState")
-            print(f"    t={elapsed:.1f}s: images={count}/{num_slices}, seq={seq_running}, SPIM={spim_state}")
+            print(
+                f"    t={elapsed:.1f}s: images={count}/{num_slices},"
+                f" seq={seq_running}, SPIM={spim_state}"
+            )
             last_print_time = time.time()
 
         time.sleep(0.01)
@@ -350,13 +369,16 @@ def acquire_spim_volume(core, camera_name, scanner_name, num_slices,
 
     print("  Retrieving images from buffer...")
     import rpyc
+
     images = []
     for i in range(count):
         img = core.popNextImage()
         img = rpyc.classic.obtain(img)  # Transfer from remote to local
         images.append(img)
-        print(f"    Image {i+1}/{count}: shape={img.shape}, dtype={img.dtype}, "
-              f"range=[{img.min()}, {img.max()}], mean={img.mean():.1f}")
+        print(
+            f"    Image {i + 1}/{count}: shape={img.shape}, dtype={img.dtype}, "
+            f"range=[{img.min()}, {img.max()}], mean={img.mean():.1f}"
+        )
 
     # Convert to 3D numpy array
     volume = np.array(images)
@@ -380,9 +402,9 @@ def main():
     camera_duration_ms = 155.0  # TTL pulse width (should be ~= exposure)
     laser_duration_ms = 154.0  # Laser on time (slightly less than camera)
 
-    print("="*80)
+    print("=" * 80)
     print("ASI diSPIM HARDWARE-TRIGGERED VOLUME ACQUISITION")
-    print("="*80)
+    print("=" * 80)
 
     try:
         # Apply system configuration
@@ -413,8 +435,13 @@ def main():
         # Configure SPIM scanner
         print()
         configure_spim_scanner(
-            core, scanner_name, num_slices, slice_step_um,
-            scan_duration_ms, camera_duration_ms, laser_duration_ms
+            core,
+            scanner_name,
+            num_slices,
+            slice_step_um,
+            scan_duration_ms,
+            camera_duration_ms,
+            laser_duration_ms,
         )
 
         # Arm SPIM state machine
@@ -423,43 +450,50 @@ def main():
 
         # Acquire volume
         print()
-        volume = acquire_spim_volume(
-            core, camera_name, scanner_name, num_slices, scan_duration_ms
-        )
+        volume = acquire_spim_volume(core, camera_name, scanner_name, num_slices, scan_duration_ms)
 
         # Save volume
         print("\nSaving volume...")
         from PIL import Image as PILImage
+
         img_list = [PILImage.fromarray(img.astype(np.uint16)) for img in volume]
-        img_list[0].save('spim_hardware_triggered_volume.tif',
-                        save_all=True, append_images=img_list[1:])
+        img_list[0].save(
+            "spim_hardware_triggered_volume.tif",
+            save_all=True,
+            append_images=img_list[1:],
+        )
         print(f"  Saved {len(volume)}-slice volume to: spim_hardware_triggered_volume.tif")
         print(f"  Volume shape: {volume.shape} (slices, height, width)")
 
         # Display in napari (optional)
         try:
             import napari
+
             print("\nDisplaying in napari...")
             viewer = napari.Viewer()
-            viewer.add_image(volume, name='SPIM Volume', colormap='gray',
-                           contrast_limits=[np.percentile(volume, 1),
-                                          np.percentile(volume, 99)])
-            viewer.dims.axis_labels = ['Z', 'Y', 'X']
+            viewer.add_image(
+                volume,
+                name="SPIM Volume",
+                colormap="gray",
+                contrast_limits=[np.percentile(volume, 1), np.percentile(volume, 99)],
+            )
+            viewer.dims.axis_labels = ["Z", "Y", "X"]
             print("  Close napari window to continue...")
             napari.run()
         except ImportError:
             print("  (napari not available, skipping visualization)")
 
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("ACQUISITION COMPLETE!")
-        print("="*80)
+        print("=" * 80)
 
     except Exception as e:
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("ACQUISITION FAILED")
-        print("="*80)
+        print("=" * 80)
         print(f"Error: {e}")
         import traceback
+
         traceback.print_exc()
 
     finally:
@@ -469,26 +503,26 @@ def main():
             if core.isSequenceRunning(camera_name):
                 core.stopSequenceAcquisition(camera_name)
                 print("  Stopped camera sequence")
-        except:
+        except Exception:
             pass
 
         try:
             core.setProperty(scanner_name, "SPIMState", "Idle")
             print("  Reset SPIM to Idle")
-        except:
+        except Exception:
             pass
 
         try:
             # Reset camera to internal triggering for live mode
             core.setProperty(camera_name, "TRIGGER SOURCE", "INTERNAL")
             print("  Reset camera to internal triggering")
-        except:
+        except Exception:
             pass
 
         try:
             core.setConfig("Laser", "ALL OFF")
             print("  Lasers OFF")
-        except:
+        except Exception:
             pass
 
 
diff --git a/diagnostics/switchbot_webgui.py b/diagnostics/switchbot_webgui.py
index 5832b103..5df81015 100644
--- a/diagnostics/switchbot_webgui.py
+++ b/diagnostics/switchbot_webgui.py
@@ -20,6 +20,7 @@
 
     .venv/bin/python diagnostics/switchbot_webgui.py --address EC:6F:04:06:5B:23 --port 8765
 """
+
 from __future__ import annotations
 
 import argparse
@@ -41,13 +42,42 @@
 
 # ITU morse, letters + digits. Unsupported characters are skipped.
 MORSE = {
-    "A": ".-", "B": "-...", "C": "-.-.", "D": "-..", "E": ".", "F": "..-.",
-    "G": "--.", "H": "....", "I": "..", "J": ".---", "K": "-.-", "L": ".-..",
-    "M": "--", "N": "-.", "O": "---", "P": ".--.", "Q": "--.-", "R": ".-.",
-    "S": "...", "T": "-", "U": "..-", "V": "...-", "W": ".--", "X": "-..-",
-    "Y": "-.--", "Z": "--..",
-    "0": "-----", "1": ".----", "2": "..---", "3": "...--", "4": "....-",
-    "5": ".....", "6": "-....", "7": "--...", "8": "---..", "9": "----.",
+    "A": ".-",
+    "B": "-...",
+    "C": "-.-.",
+    "D": "-..",
+    "E": ".",
+    "F": "..-.",
+    "G": "--.",
+    "H": "....",
+    "I": "..",
+    "J": ".---",
+    "K": "-.-",
+    "L": ".-..",
+    "M": "--",
+    "N": "-.",
+    "O": "---",
+    "P": ".--.",
+    "Q": "--.-",
+    "R": ".-.",
+    "S": "...",
+    "T": "-",
+    "U": "..-",
+    "V": "...-",
+    "W": ".--",
+    "X": "-..-",
+    "Y": "-.--",
+    "Z": "--..",
+    "0": "-----",
+    "1": ".----",
+    "2": "..---",
+    "3": "...--",
+    "4": "....-",
+    "5": ".....",
+    "6": "-....",
+    "7": "--...",
+    "8": "---..",
+    "9": "----.",
 }
 
 
@@ -64,6 +94,7 @@ def __init__(self, address: str):
 
     async def _ensure(self):
         from bleak import BleakClient
+
         if self._client is not None and self._client.is_connected:
             return
         self._client = BleakClient(self.address, timeout=20)
@@ -73,6 +104,7 @@ async def _ensure(self):
     async def _write(self, action: str):
         """Write one command, reconnecting once if the link dropped."""
         from bleak.exc import BleakError
+
         for attempt in (1, 2):
             try:
                 await self._ensure()
@@ -243,7 +275,8 @@ async def stop():
   input[type=text]{ width:100%; box-sizing:border-box; padding:10px; margin-bottom:10px;
            background:#0d1117; color:#e6edf3; border:1px solid #30363d; border-radius:8px;
            font-size:15px; text-transform:uppercase; letter-spacing:.1em; }
-  .speed { display:flex; align-items:center; gap:8px; font-size:12px; color:#8b949e; margin-bottom:12px; }
+  .speed { display:flex; align-items:center; gap:8px; font-size:12px;
+           color:#8b949e; margin-bottom:12px; }
   .speed input { flex:1; }
   .mrow { display:flex; gap:8px; }
   .status { margin-top:14px; font-size:12px; color:#8b949e; min-height:16px; }
@@ -277,7 +310,8 @@ async def stop():
 const $ = id => document.getElementById(id);
 let timers = [];
 function setBulb(on){ $('bulb').classList.toggle('on', on); }
-function setState(s){ $('state').textContent = s; if(s==='on')setBulb(true); else if(s==='off')setBulb(false); }
+function setState(s){ $('state').textContent = s;
+  if(s==='on')setBulb(true); else if(s==='off')setBulb(false); }
 function clearTimers(){ timers.forEach(clearTimeout); timers = []; }
 function sv(){ $('speedval').textContent = (+$('speed').value).toFixed(1)+'s'; }
 
diff --git a/examples/example_dispim_workflows.py b/examples/example_dispim_workflows.py
index 133555c3..e81e7574 100644
--- a/examples/example_dispim_workflows.py
+++ b/examples/example_dispim_workflows.py
@@ -9,7 +9,7 @@
 This example shows:
 1. Device-agnostic atomic plans (focus_sweep)
 2. Autofocus functionality for precise positioning
-3. Two-point calibration for coordinate mapping  
+3. Two-point calibration for coordinate mapping
 4. Embryo detection with bottom camera
 5. Complete multi-embryo acquisition workflows
 
@@ -17,34 +17,25 @@
 """
 
 import logging
+
 import numpy as np
 from bluesky import RunEngine
 from bluesky.callbacks import LiveTable
 
 # Import gently components
 from gently import (
-    # Device classes
-    create_dispim_system,
-    DiSPIMSystem,
-    
-    # Plan functions  
-    focus_sweep,                    # Atomic plan
-    dispim_piezo_autofocus,        # Autofocus functionality
-    dispim_two_point_calibration,  # Calibration plan
-    full_dispim_workflow,          # Complete workflow
-    
     # Configuration
     AutofocusConfig,
     CalibrationConfig,
-    
+    FitFunction,
     # Analysis utilities
-    FocusAlgorithm,
-    FitFunction
+    FocusAlgorithm,  # Complete workflow
 )
 
 # Import optional napari visualization
 try:
-    import napari
+    import napari  # noqa: F401
+
     NAPARI_AVAILABLE = True
 except ImportError:
     NAPARI_AVAILABLE = False
@@ -53,46 +44,46 @@
 def setup_dispim_session():
     """
     Setup DiSPIM session with devices and RunEngine
-    
+
     In practice, this would use actual MM installation paths:
     system = create_dispim_system("/path/to/micromanager", "/path/to/config.cfg")
     """
     print("Setting up DiSPIM session...")
-    
+
     # Create RunEngine
     RE = RunEngine({})
-    
+
     # For demonstration, create a mock system
     # In practice: system = create_dispim_system(mm_dir, config_file)
     print("  [Note: Using mock system for demonstration]")
     print("  [In practice: system = create_dispim_system(mm_dir, config_file)]")
     system = None  # Would be actual DiSPIMSystem
-    
+
     # Setup live callbacks
-    live_table = LiveTable(['piezo_a_position', 'galvo_a_position', 'camera_a_image'])
+    live_table = LiveTable(["piezo_a_position", "galvo_a_position", "camera_a_image"])
     RE.subscribe(live_table)
-    
+
     return RE, system
 
 
 def setup_napari_visualization(RE):
     """Setup optional napari visualization for real-time image display"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("OPTIONAL: NAPARI VISUALIZATION SETUP")
-    print("="*60)
-    
+    print("=" * 60)
+
     if not NAPARI_AVAILABLE:
         print("\n⚠ Napari not available - skipping visualization setup")
         print("  To enable real-time image visualization:")
         print("    pip install napari[all]")
         print("  Then restart and run this example again.")
         return None
-    
+
     print("\n✅ Napari available - setting up real-time visualization")
-    
+
     # Setup napari callback for all DiSPIM experiments
-    napari_callback = enable_full_visualization(RE)
-    
+    napari_callback = enable_full_visualization(RE)  # noqa: F821
+
     if napari_callback.enabled:
         print("  ✅ Napari callback enabled and subscribed to RunEngine")
         print("  ✅ Real-time image display will show:")
@@ -100,71 +91,71 @@ def setup_napari_visualization(RE):
         print("    - Embryo detection scan images")
         print("    - Dual-channel DiSPIM data (green/magenta)")
         print("    - Individual camera acquisitions")
-        
+
         print(f"\n  Napari viewer: '{napari_callback.viewer.title}'")
         print(f"  - Focus sweeps: {napari_callback.show_focus_sweeps}")
         print(f"  - Embryo detection: {napari_callback.show_embryo_detection}")
         print(f"  - Dual channels: {napari_callback.dual_channel_mode}")
-        
+
         print("\n  💡 The napari window is now open - you can:")
         print("    - Adjust layer visibility and colors")
         print("    - Explore 3D image stacks")
         print("    - Take screenshots and export movies")
         print("    - View images in real-time during experiments")
-        
+
     else:
         print("  ❌ Napari callback failed to initialize")
         return None
-    
+
     return napari_callback
 
 
 def demonstrate_atomic_plans(RE, light_sheet):
     """Demonstrate device-agnostic atomic plans"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("1. ATOMIC PLANS - Device-Agnostic Building Blocks")
-    print("="*60)
-    
+    print("=" * 60)
+
     print("\nThe foundation: focus_sweep(positioner, positions, detector)")
     print("This atomic plan works with ANY positioner and detector:")
-    
+
     # Define scan positions
     positions = np.linspace(-10, 10, 11)  # 11 positions from -10 to +10 μm
-    
+
     print(f"\n  Positions to scan: {positions}")
     print(f"  Number of positions: {len(positions)}")
-    
+
     if light_sheet is not None:
         # Example 1: Piezo focus sweep
         print("\n  Example 1: Piezo focus sweep")
         print("    focus_sweep(light_sheet.piezo, positions, light_sheet.camera)")
         # RE(focus_sweep(light_sheet.piezo, positions, light_sheet.camera))
-    
-        # Example 2: Galvo focus sweep  
+
+        # Example 2: Galvo focus sweep
         print("\n  Example 2: Galvo focus sweep")
         print("    focus_sweep(light_sheet.galvo, positions, light_sheet.camera)")
         # RE(focus_sweep(light_sheet.galvo, positions, light_sheet.camera))
-    
+
         # Example 3: XY stage sweep (device-agnostic)
         print("\n  Example 3: XY stage sweep (device-agnostic!)")
         print("    focus_sweep(xy_stage.x, positions, light_sheet.camera)")
         # RE(focus_sweep(xy_stage.x, positions, light_sheet.camera))
     else:
         print("    [Would execute: RE(focus_sweep(device, positions, detector))]")
-    
+
     print("\nKey insight: Same atomic plan, different devices!")
     print("This is the power of device-agnostic Bluesky plans.")
 
 
 def demonstrate_autofocus_functionality(RE, light_sheet):
     """Demonstrate autofocus functionality for precise positioning"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("2. AUTOFOCUS FUNCTIONALITY - Precise Device Positioning")
-    print("="*60)
-    
+    print("=" * 60)
+
     print("\nAutofocus builds on the atomic focus_sweep plan:")
     print("dispim_piezo_autofocus() = focus_sweep() + analysis + validation")
-    
+
     # Create autofocus configuration
     config = AutofocusConfig(
         num_positions=21,
@@ -172,251 +163,276 @@ def demonstrate_autofocus_functionality(RE, light_sheet):
         algorithm=FocusAlgorithm.VOLATH.value,
         fit_function=FitFunction.GAUSSIAN.value,
         minimum_r_squared=0.75,
-        center_at_current=True
+        center_at_current=True,
     )
-    
-    print(f"\nAutofocus Configuration:")
+
+    print("\nAutofocus Configuration:")
     print(f"  Positions: {config.num_positions}")
     print(f"  Step size: {config.step_size_um} μm")
     print(f"  Algorithm: {config.algorithm}")
     print(f"  Fit function: {config.fit_function}")
     print(f"  Min R²: {config.minimum_r_squared}")
-    
+
     if light_sheet is not None:
-        print(f"\nExecuting autofocus:")
-        print(f"  RE(dispim_piezo_autofocus(light_sheet, config))")
+        print("\nExecuting autofocus:")
+        print("  RE(dispim_piezo_autofocus(light_sheet, config))")
         # RE(dispim_piezo_autofocus(light_sheet, config))
-        
+
         if NAPARI_AVAILABLE:
-            print(f"\n  📺 With napari visualization:")
-            print(f"    - Images stream to napari in real-time")
-            print(f"    - 3D focus stack builds as positions are scanned")
-            print(f"    - Can see focus quality at each position")
-            print(f"    - Visual feedback on autofocus progress")
+            print("\n  📺 With napari visualization:")
+            print("    - Images stream to napari in real-time")
+            print("    - 3D focus stack builds as positions are scanned")
+            print("    - Can see focus quality at each position")
+            print("    - Visual feedback on autofocus progress")
     else:
-        print(f"\n[Would execute: RE(dispim_piezo_autofocus(light_sheet, config))]")
-    
-    print(f"\nAutofocus workflow:")
-    print(f"  1. bps.stage(light_sheet)      # Save current state")
-    print(f"  2. focus_sweep(piezo, positions, camera)  # Atomic plan")
-    print(f"  3. analyze_focus_stack(positions, images) # Find best position")
-    print(f"  4. bps.mv(piezo, best_position) # Move to focus")
-    print(f"  5. bps.unstage(light_sheet)     # Restore if failed")
-    
-    print(f"\nThis enables precise, automated positioning for experiments!")
+        print("\n[Would execute: RE(dispim_piezo_autofocus(light_sheet, config))]")
+
+    print("\nAutofocus workflow:")
+    print("  1. bps.stage(light_sheet)      # Save current state")
+    print("  2. focus_sweep(piezo, positions, camera)  # Atomic plan")
+    print("  3. analyze_focus_stack(positions, images) # Find best position")
+    print("  4. bps.mv(piezo, best_position) # Move to focus")
+    print("  5. bps.unstage(light_sheet)     # Restore if failed")
+
+    print("\nThis enables precise, automated positioning for experiments!")
 
 
 def demonstrate_calibration_workflow(RE, light_sheet):
     """Demonstrate calibration workflows for coordinate mapping"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("3. CALIBRATION WORKFLOW - Coordinate System Mapping")
-    print("="*60)
-    
+    print("=" * 60)
+
     print("\nTwo-point calibration uses autofocus at each calibration point:")
     print("dispim_two_point_calibration() = move + autofocus + move + autofocus + fit")
-    
+
     # Create calibration configuration
     autofocus_config = AutofocusConfig(
         num_positions=11,  # Faster for calibration
         step_size_um=1.0,
-        algorithm=FocusAlgorithm.VOLATH.value
+        algorithm=FocusAlgorithm.VOLATH.value,
     )
-    
+
     cal_config = CalibrationConfig(
         point1_um=25.0,
         point2_um=75.0,
         autofocus_each_point=True,
-        autofocus_config=autofocus_config
+        autofocus_config=autofocus_config,
     )
-    
-    print(f"\nCalibration Configuration:")
+
+    print("\nCalibration Configuration:")
     print(f"  Point 1: {cal_config.point1_um} μm")
-    print(f"  Point 2: {cal_config.point2_um} μm")  
+    print(f"  Point 2: {cal_config.point2_um} μm")
     print(f"  Autofocus at each point: {cal_config.autofocus_each_point}")
-    
+
     if light_sheet is not None:
-        print(f"\nExecuting calibration:")
-        print(f"  RE(dispim_two_point_calibration(light_sheet, cal_config))")
+        print("\nExecuting calibration:")
+        print("  RE(dispim_two_point_calibration(light_sheet, cal_config))")
         # RE(dispim_two_point_calibration(light_sheet, cal_config))
     else:
-        print(f"\n[Would execute: RE(dispim_two_point_calibration(light_sheet, cal_config))]")
-    
-    print(f"\nCalibration workflow:")
-    print(f"  1. bps.mv(piezo, point1)        # Move to first point")
-    print(f"  2. dispim_galvo_autofocus()     # Focus galvo (uses atomic plans)")
-    print(f"  3. bps.trigger_and_read([...])  # Record positions")
-    print(f"  4. bps.mv(piezo, point2)        # Move to second point")
-    print(f"  5. dispim_galvo_autofocus()     # Focus galvo again")  
-    print(f"  6. bps.trigger_and_read([...])  # Record positions")
-    print(f"  7. calculate_linear_fit()       # Determine calibration")
-    
-    print(f"\nCalibration enables coordinate transformations between devices!")
+        print("\n[Would execute: RE(dispim_two_point_calibration(light_sheet, cal_config))]")
+
+    print("\nCalibration workflow:")
+    print("  1. bps.mv(piezo, point1)        # Move to first point")
+    print("  2. dispim_galvo_autofocus()     # Focus galvo (uses atomic plans)")
+    print("  3. bps.trigger_and_read([...])  # Record positions")
+    print("  4. bps.mv(piezo, point2)        # Move to second point")
+    print("  5. dispim_galvo_autofocus()     # Focus galvo again")
+    print("  6. bps.trigger_and_read([...])  # Record positions")
+    print("  7. calculate_linear_fit()       # Determine calibration")
+
+    print("\nCalibration enables coordinate transformations between devices!")
 
 
 def demonstrate_embryo_detection_workflow(RE, dispim_system):
     """Demonstrate embryo detection with bottom camera"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("4. EMBRYO DETECTION WORKFLOW - Automated Sample Finding")
-    print("="*60)
-    
+    print("=" * 60)
+
     print("\nEmbryo detection uses bottom camera for automated sample finding:")
     print("find_embryos_with_bottom_camera() = XY scan + image analysis + position recording")
-    
+
     # Create detection configuration
     detection_config = {
-        'scan_area': {
-            'x_start': -1000, 'x_stop': 1000,  # μm
-            'y_start': -1000, 'y_stop': 1000,  # μm
-            'step_size': 200  # μm between positions
+        "scan_area": {
+            "x_start": -1000,
+            "x_stop": 1000,  # μm
+            "y_start": -1000,
+            "y_stop": 1000,  # μm
+            "step_size": 200,  # μm between positions
+        },
+        "detection": {
+            "min_size_pixels": 50,
+            "max_size_pixels": 500,
+            "brightness_threshold": 0.3,
+            "circularity_threshold": 0.7,
         },
-        'detection': {
-            'min_size_pixels': 50,
-            'max_size_pixels': 500,
-            'brightness_threshold': 0.3,
-            'circularity_threshold': 0.7
+        "safety": {
+            "z_position_um": 0.0,  # Safe Z position during XY scan
+            "max_scan_time_minutes": 10,
         },
-        'safety': {
-            'z_position_um': 0.0,  # Safe Z position during XY scan
-            'max_scan_time_minutes': 10
-        }
     }
-    
-    print(f"\nDetection Configuration:")
-    print(f"  Scan area: {detection_config['scan_area']['x_start']} to {detection_config['scan_area']['x_stop']} μm (X)")
-    print(f"             {detection_config['scan_area']['y_start']} to {detection_config['scan_area']['y_stop']} μm (Y)")
+
+    print("\nDetection Configuration:")
+    print(
+        f"  Scan area: {detection_config['scan_area']['x_start']} to"
+        f" {detection_config['scan_area']['x_stop']} μm (X)"
+    )
+    print(
+        f"             {detection_config['scan_area']['y_start']} to"
+        f" {detection_config['scan_area']['y_stop']} μm (Y)"
+    )
     print(f"  Step size: {detection_config['scan_area']['step_size']} μm")
-    print(f"  Detection thresholds: size {detection_config['detection']['min_size_pixels']}-{detection_config['detection']['max_size_pixels']} pixels")
-    
+    print(
+        f"  Detection thresholds: size"
+        f" {detection_config['detection']['min_size_pixels']}"
+        f"-{detection_config['detection']['max_size_pixels']} pixels"
+    )
+
     if dispim_system is not None:
-        print(f"\nExecuting embryo detection:")
-        print(f"  RE(find_embryos_with_bottom_camera(dispim_system, detection_config))")
+        print("\nExecuting embryo detection:")
+        print("  RE(find_embryos_with_bottom_camera(dispim_system, detection_config))")
         # RE(find_embryos_with_bottom_camera(dispim_system, detection_config))
-        
+
         if NAPARI_AVAILABLE:
-            print(f"\n  📺 With napari visualization:")
-            print(f"    - Each XY position shows in napari as it's acquired")
-            print(f"    - See scan progress across the sample area")
-            print(f"    - Detected embryos can be highlighted in real-time")
-            print(f"    - Build up a mosaic view of the scanned region")
+            print("\n  📺 With napari visualization:")
+            print("    - Each XY position shows in napari as it's acquired")
+            print("    - See scan progress across the sample area")
+            print("    - Detected embryos can be highlighted in real-time")
+            print("    - Build up a mosaic view of the scanned region")
     else:
-        print(f"\n[Would execute: RE(find_embryos_with_bottom_camera(dispim_system, detection_config))]")
-    
-    print(f"\nDetection workflow:")
-    print(f"  1. bps.mv(xy_stage.z, safe_z_position)    # Move to safe Z")
-    print(f"  2. XY grid scan with bottom camera        # Scan entire area")
-    print(f"  3. Analyze images for embryo features     # Find circular objects")
-    print(f"  4. Record embryo positions in stage coords # Store locations")
-    print(f"  5. Convert to light sheet coordinates     # Transform coords")
-    
-    print(f"\nAutomated detection finds all samples for batch processing!")
+        print(
+            "\n[Would execute:"
+            " RE(find_embryos_with_bottom_camera(dispim_system, detection_config))]"
+        )
+
+    print("\nDetection workflow:")
+    print("  1. bps.mv(xy_stage.z, safe_z_position)    # Move to safe Z")
+    print("  2. XY grid scan with bottom camera        # Scan entire area")
+    print("  3. Analyze images for embryo features     # Find circular objects")
+    print("  4. Record embryo positions in stage coords # Store locations")
+    print("  5. Convert to light sheet coordinates     # Transform coords")
+
+    print("\nAutomated detection finds all samples for batch processing!")
 
 
 def demonstrate_complete_workflow(RE, dispim_system):
     """Demonstrate complete multi-embryo acquisition workflow"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("5. COMPLETE WORKFLOW - Multi-Embryo Light Sheet Acquisition")
-    print("="*60)
-    
+    print("=" * 60)
+
     print("\nThe complete workflow combines all components:")
     print("full_dispim_workflow() = calibration + embryo_detection + acquisition")
-    
+
     # Create complete workflow configuration
     workflow_config = {
-        'system_setup': {
-            'center_devices': True,
-            'run_calibration': True,
-            'validate_hardware': True
+        "system_setup": {
+            "center_devices": True,
+            "run_calibration": True,
+            "validate_hardware": True,
         },
-        'calibration': {
-            'point1_um': 25.0,
-            'point2_um': 75.0,
-            'autofocus_each_point': True,
-            'autofocus_config': {
-                'num_positions': 11,
-                'step_size_um': 1.0,
-                'algorithm': 'volath'
-            }
+        "calibration": {
+            "point1_um": 25.0,
+            "point2_um": 75.0,
+            "autofocus_each_point": True,
+            "autofocus_config": {
+                "num_positions": 11,
+                "step_size_um": 1.0,
+                "algorithm": "volath",
+            },
         },
-        'embryo_detection': {
-            'x_start': -1000, 'x_stop': 1000,
-            'y_start': -1000, 'y_stop': 1000, 
-            'step_size': 200,
-            'detection_thresholds': {
-                'min_size': 50, 'max_size': 500,
-                'brightness': 0.3, 'circularity': 0.7
-            }
+        "embryo_detection": {
+            "x_start": -1000,
+            "x_stop": 1000,
+            "y_start": -1000,
+            "y_stop": 1000,
+            "step_size": 200,
+            "detection_thresholds": {
+                "min_size": 50,
+                "max_size": 500,
+                "brightness": 0.3,
+                "circularity": 0.7,
+            },
         },
-        'acquisition': {
-            'autofocus_config': {
-                'num_positions': 21, 
-                'step_size_um': 0.5,
-                'algorithm': 'volath'
+        "acquisition": {
+            "autofocus_config": {
+                "num_positions": 21,
+                "step_size_um": 0.5,
+                "algorithm": "volath",
             },
-            'z_stack': {
-                'range_um': 50,  # ±25 μm around focus
-                'step_size_um': 1.0
+            "z_stack": {
+                "range_um": 50,  # ±25 μm around focus
+                "step_size_um": 1.0,
             },
-            'dual_sided': True,
-            'time_points': 1
-        }
+            "dual_sided": True,
+            "time_points": 1,
+        },
     }
-    
-    print(f"\nWorkflow Configuration:")
-    print(f"  Calibration: {workflow_config['calibration']['point1_um']} to {workflow_config['calibration']['point2_um']} μm")
-    print(f"  Detection area: {workflow_config['embryo_detection']['x_start']} to {workflow_config['embryo_detection']['x_stop']} μm")
-    print(f"  Z-stack range: ±{workflow_config['acquisition']['z_stack']['range_um']//2} μm")
+
+    print("\nWorkflow Configuration:")
+    print(
+        f"  Calibration: {workflow_config['calibration']['point1_um']} to"
+        f" {workflow_config['calibration']['point2_um']} μm"
+    )
+    print(
+        f"  Detection area: {workflow_config['embryo_detection']['x_start']} to"
+        f" {workflow_config['embryo_detection']['x_stop']} μm"
+    )
+    print(f"  Z-stack range: ±{workflow_config['acquisition']['z_stack']['range_um'] // 2} μm")
     print(f"  Dual-sided: {workflow_config['acquisition']['dual_sided']}")
-    
+
     if dispim_system is not None:
-        print(f"\nExecuting complete workflow:")
-        print(f"  RE(full_dispim_workflow(dispim_system, workflow_config))")
+        print("\nExecuting complete workflow:")
+        print("  RE(full_dispim_workflow(dispim_system, workflow_config))")
         # RE(full_dispim_workflow(dispim_system, workflow_config))
     else:
-        print(f"\n[Would execute: RE(full_dispim_workflow(dispim_system, workflow_config))]")
-    
-    print(f"\nComplete workflow stages:")
-    print(f"  1. System initialization and hardware validation")
-    print(f"  2. Two-point calibration (with autofocus)")
-    print(f"  3. Embryo detection with bottom camera")
-    print(f"  4. For each detected embryo:")
-    print(f"     a. Move to embryo position")
-    print(f"     b. Autofocus both sides")
-    print(f"     c. Acquire dual-sided Z-stack")
-    print(f"     d. Save data with metadata")
-    
-    print(f"\nAutomated, high-throughput DiSPIM experiments!")
+        print("\n[Would execute: RE(full_dispim_workflow(dispim_system, workflow_config))]")
+
+    print("\nComplete workflow stages:")
+    print("  1. System initialization and hardware validation")
+    print("  2. Two-point calibration (with autofocus)")
+    print("  3. Embryo detection with bottom camera")
+    print("  4. For each detected embryo:")
+    print("     a. Move to embryo position")
+    print("     b. Autofocus both sides")
+    print("     c. Acquire dual-sided Z-stack")
+    print("     d. Save data with metadata")
+
+    print("\nAutomated, high-throughput DiSPIM experiments!")
 
 
 def demonstrate_extensibility(RE):
     """Demonstrate how the atomic approach enables easy extension"""
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("6. EXTENSIBILITY - Easy Addition of New Capabilities")
-    print("="*60)
-    
+    print("=" * 60)
+
     print("\nBecause plans are device-agnostic, new capabilities are easy:")
-    
-    print(f"\nNew hardware? Same plans work:")
-    print(f"  focus_sweep(new_positioner, positions, new_detector)")
-    print(f"  dispim_piezo_autofocus(new_light_sheet, config)")
-    
-    print(f"\nNew algorithms? Just swap the analysis:")
-    print(f"  config.algorithm = 'new_algorithm'")
-    print(f"  Same dispim_piezo_autofocus() plan!")
-    
-    print(f"\nNew workflows? Compose existing plans:")
-    print(f"  def adaptive_autofocus_with_ai(light_sheet, ai_callback):")
-    print(f"    yield from dispim_piezo_autofocus(light_sheet, config)")
-    print(f"    decision = ai_callback(result)")
-    print(f"    if decision.refine:")
-    print(f"      yield from dispim_galvo_autofocus(light_sheet, refined_config)")
-    
-    print(f"\nIntegration with other systems:")
-    print(f"  def combined_microscopy_workflow(dispim, confocal, shared_stage):")
-    print(f"    yield from focus_sweep(shared_stage.z, positions, dispim.camera)")
-    print(f"    yield from focus_sweep(shared_stage.z, positions, confocal.camera)")
-    print(f"    # Same atomic plan, different systems!")
-    
-    print(f"\nThe atomic approach scales naturally!")
+
+    print("\nNew hardware? Same plans work:")
+    print("  focus_sweep(new_positioner, positions, new_detector)")
+    print("  dispim_piezo_autofocus(new_light_sheet, config)")
+
+    print("\nNew algorithms? Just swap the analysis:")
+    print("  config.algorithm = 'new_algorithm'")
+    print("  Same dispim_piezo_autofocus() plan!")
+
+    print("\nNew workflows? Compose existing plans:")
+    print("  def adaptive_autofocus_with_ai(light_sheet, ai_callback):")
+    print("    yield from dispim_piezo_autofocus(light_sheet, config)")
+    print("    decision = ai_callback(result)")
+    print("    if decision.refine:")
+    print("      yield from dispim_galvo_autofocus(light_sheet, refined_config)")
+
+    print("\nIntegration with other systems:")
+    print("  def combined_microscopy_workflow(dispim, confocal, shared_stage):")
+    print("    yield from focus_sweep(shared_stage.z, positions, dispim.camera)")
+    print("    yield from focus_sweep(shared_stage.z, positions, confocal.camera)")
+    print("    # Same atomic plan, different systems!")
+
+    print("\nThe atomic approach scales naturally!")
 
 
 def main():
@@ -429,17 +445,17 @@ def main():
     print()
     print("Key concepts:")
     print("  - Atomic plans work with ANY compatible devices")
-    print("  - Autofocus enables precise positioning") 
+    print("  - Autofocus enables precise positioning")
     print("  - Complex workflows compose atomic plans")
     print("  - Easy extensibility through device agnosticism")
-    
+
     # Setup session
     RE, system = setup_dispim_session()
-    light_sheet = getattr(system, 'side_a', None) if system else None
-    
+    light_sheet = getattr(system, "side_a", None) if system else None
+
     # Setup optional napari visualization
-    napari_callback = setup_napari_visualization(RE)
-    
+    setup_napari_visualization(RE)
+
     # Run demonstrations
     demonstrate_atomic_plans(RE, light_sheet)
     demonstrate_autofocus_functionality(RE, light_sheet)
@@ -447,50 +463,50 @@ def main():
     demonstrate_embryo_detection_workflow(RE, system)
     demonstrate_complete_workflow(RE, system)
     demonstrate_extensibility(RE)
-    
+
     # Summary
-    print("\n" + "="*60)
+    print("\n" + "=" * 60)
     print("SUMMARY - Complete DiSPIM Functionality")
-    print("="*60)
-    
-    print(f"\n✓ Created proper Ophyd devices (DiSPIMPiezo, DiSPIMCamera, etc.)")
-    print(f"✓ Built device-agnostic atomic plans (focus_sweep, move_and_acquire)")
-    print(f"✓ Implemented autofocus for precise positioning")
-    print(f"✓ Added calibration workflows for coordinate mapping")
-    print(f"✓ Created embryo detection for automated sample finding")
-    print(f"✓ Integrated complete multi-embryo acquisition workflows")
+    print("=" * 60)
+
+    print("\n✓ Created proper Ophyd devices (DiSPIMPiezo, DiSPIMCamera, etc.)")
+    print("✓ Built device-agnostic atomic plans (focus_sweep, move_and_acquire)")
+    print("✓ Implemented autofocus for precise positioning")
+    print("✓ Added calibration workflows for coordinate mapping")
+    print("✓ Created embryo detection for automated sample finding")
+    print("✓ Integrated complete multi-embryo acquisition workflows")
     if NAPARI_AVAILABLE:
-        print(f"✓ Enabled real-time image visualization with napari")
-    
-    print(f"\nKey benefits:")
-    print(f"  1. Device-agnostic - plans work with any compatible hardware")
-    print(f"  2. Composable - atomic plans build into complex workflows")
-    print(f"  3. Extensible - easy to add new capabilities")
-    print(f"  4. Reliable - proper Bluesky integration with error handling")
-    
-    print(f"\nNext steps:")
-    print(f"  1. Test with real DiSPIM hardware using safety protocols")
+        print("✓ Enabled real-time image visualization with napari")
+
+    print("\nKey benefits:")
+    print("  1. Device-agnostic - plans work with any compatible hardware")
+    print("  2. Composable - atomic plans build into complex workflows")
+    print("  3. Extensible - easy to add new capabilities")
+    print("  4. Reliable - proper Bluesky integration with error handling")
+
+    print("\nNext steps:")
+    print("  1. Test with real DiSPIM hardware using safety protocols")
     if not NAPARI_AVAILABLE:
-        print(f"  2. Install napari for real-time visualization: pip install napari[all]")
-        print(f"  3. Add image analysis for embryo detection")
-        print(f"  4. Integrate with VLM for intelligent workflows")  
-        print(f"  5. Extend to other microscopy systems")
+        print("  2. Install napari for real-time visualization: pip install napari[all]")
+        print("  3. Add image analysis for embryo detection")
+        print("  4. Integrate with VLM for intelligent workflows")
+        print("  5. Extend to other microscopy systems")
     else:
-        print(f"  2. Add image analysis for embryo detection")
-        print(f"  3. Integrate with VLM for intelligent workflows")
-        print(f"  4. Extend to other microscopy systems")
-    
-    print(f"\nThe transformation is complete:")
-    print(f"  635-line Java monolith → Composable Bluesky atomic plans")
-    print(f"  Device-specific code → Device-agnostic interfaces")
-    print(f"  Rigid workflows → Flexible, extensible compositions")
-    
-    print(f"\nGently DiSPIM: Where atomic plans meet experimental flexibility! 🔬")
+        print("  2. Add image analysis for embryo detection")
+        print("  3. Integrate with VLM for intelligent workflows")
+        print("  4. Extend to other microscopy systems")
+
+    print("\nThe transformation is complete:")
+    print("  635-line Java monolith → Composable Bluesky atomic plans")
+    print("  Device-specific code → Device-agnostic interfaces")
+    print("  Rigid workflows → Flexible, extensible compositions")
+
+    print("\nGently DiSPIM: Where atomic plans meet experimental flexibility! 🔬")
 
 
 if __name__ == "__main__":
     # Setup logging
     logging.basicConfig(level=logging.INFO)
-    
+
     # Run demonstration
-    main()
\ No newline at end of file
+    main()
diff --git a/experimental/data_reasoning/__init__.py b/experimental/data_reasoning/__init__.py
index 0450d5a1..8b06fd31 100644
--- a/experimental/data_reasoning/__init__.py
+++ b/experimental/data_reasoning/__init__.py
@@ -8,16 +8,16 @@
 - GapPlanner: create plan items to fill annotation gaps
 """
 
+from .assessment import DataAssessmentEngine
+from .coverage import CoverageAnalyzer
+from .gap_planner import GapPlanner
 from .models import (
     CoverageReport,
     DataQualityReport,
     NetworkDataInventory,
     SessionSummary,
 )
-from .assessment import DataAssessmentEngine
-from .coverage import CoverageAnalyzer
 from .quality import QualityAnalyzer
-from .gap_planner import GapPlanner
 
 __all__ = [
     "CoverageReport",
diff --git a/experimental/data_reasoning/assessment.py b/experimental/data_reasoning/assessment.py
index 874d8953..e3ef9c2e 100644
--- a/experimental/data_reasoning/assessment.py
+++ b/experimental/data_reasoning/assessment.py
@@ -7,7 +7,6 @@
 """
 
 import logging
-from typing import Optional
 
 from .models import NetworkDataInventory, SessionSummary
 
@@ -66,16 +65,18 @@ def inventory_local(self) -> list:
                     except Exception:
                         pass
 
-                sessions.append(SessionSummary(
-                    session_id=sid,
-                    session_name=sname,
-                    embryo_count=embryo_count,
-                    volume_count=vol_count,
-                    annotated_embryos=annotated,
-                    ground_truth_count=gt_count,
-                    stages_covered=sorted(stages),
-                    is_remote=False,
-                ))
+                sessions.append(
+                    SessionSummary(
+                        session_id=sid,
+                        session_name=sname,
+                        embryo_count=embryo_count,
+                        volume_count=vol_count,
+                        annotated_embryos=annotated,
+                        ground_truth_count=gt_count,
+                        stages_covered=sorted(stages),
+                        is_remote=False,
+                    )
+                )
         except Exception as e:
             logger.error(f"Local inventory failed: {e}")
 
@@ -98,6 +99,7 @@ async def inventory_remote(self) -> tuple:
             try:
                 # Build a PeerInfo-like object for PeerClient
                 from ..mesh.models import PeerInfo
+
                 peer = PeerInfo(
                     instance_id=peer_entry.instance_id,
                     hostname=peer_entry.hostname,
@@ -111,14 +113,16 @@ async def inventory_remote(self) -> tuple:
                     peers_failed += 1
                     continue
                 for s in peer_sessions:
-                    sessions.append(SessionSummary(
-                        session_id=s.get("session_id", ""),
-                        session_name=s.get("name", ""),
-                        source_peer=peer_entry.instance_id,
-                        embryo_count=s.get("embryo_count", 0),
-                        volume_count=s.get("volume_count", 0),
-                        is_remote=True,
-                    ))
+                    sessions.append(
+                        SessionSummary(
+                            session_id=s.get("session_id", ""),
+                            session_name=s.get("name", ""),
+                            source_peer=peer_entry.instance_id,
+                            embryo_count=s.get("embryo_count", 0),
+                            volume_count=s.get("volume_count", 0),
+                            is_remote=True,
+                        )
+                    )
             except Exception as e:
                 logger.debug(f"Remote inventory failed for {peer_entry.hostname}: {e}")
                 peers_failed += 1
diff --git a/experimental/data_reasoning/coverage.py b/experimental/data_reasoning/coverage.py
index ac9c1f0d..4a449729 100644
--- a/experimental/data_reasoning/coverage.py
+++ b/experimental/data_reasoning/coverage.py
@@ -3,7 +3,6 @@
 """
 
 import logging
-from typing import Dict, List, Optional
 
 from .models import CoverageReport
 
@@ -11,9 +10,21 @@
 
 # Known C. elegans embryonic stages (common ordering)
 KNOWN_STAGES = [
-    "early", "2-cell", "4-cell", "8-cell", "16-cell",
-    "32-cell", "64-cell", "gastrulation", "bean", "comma",
-    "1.5-fold", "2-fold", "pretzel", "3-fold", "hatching",
+    "early",
+    "2-cell",
+    "4-cell",
+    "8-cell",
+    "16-cell",
+    "32-cell",
+    "64-cell",
+    "gastrulation",
+    "bean",
+    "comma",
+    "1.5-fold",
+    "2-fold",
+    "pretzel",
+    "3-fold",
+    "hatching",
 ]
 
 # Minimum recommended samples per stage for training
@@ -32,7 +43,7 @@ class CoverageAnalyzer:
     def __init__(self, gently_store=None):
         self._store = gently_store
 
-    def analyze(self, session_ids: Optional[List[str]] = None) -> CoverageReport:
+    def analyze(self, session_ids: list[str] | None = None) -> CoverageReport:
         """Analyze annotation coverage across specified sessions (or all).
 
         Parameters
@@ -49,7 +60,7 @@ def analyze(self, session_ids: Optional[List[str]] = None) -> CoverageReport:
 
         total_embryos = 0
         annotated_embryos = 0
-        stage_counts: Dict[str, int] = {}
+        stage_counts: dict[str, int] = {}
 
         try:
             sessions = self._store.list_sessions()
@@ -89,7 +100,11 @@ def analyze(self, session_ids: Optional[List[str]] = None) -> CoverageReport:
         # Find gaps and generate recommendations
         gaps = self._find_gaps(stage_counts)
         recommendations = self._generate_recommendations(
-            total_embryos, annotated_embryos, coverage_pct, stage_counts, gaps,
+            total_embryos,
+            annotated_embryos,
+            coverage_pct,
+            stage_counts,
+            gaps,
         )
 
         return CoverageReport(
@@ -104,7 +119,7 @@ def analyze(self, session_ids: Optional[List[str]] = None) -> CoverageReport:
 
     def analyze_from_inventory(self, inventory) -> CoverageReport:
         """Build a coverage report from a NetworkDataInventory."""
-        stage_counts: Dict[str, int] = {}
+        stage_counts: dict[str, int] = {}
         total_embryos = inventory.total_embryos
         annotated_embryos = inventory.total_annotated
 
@@ -118,7 +133,11 @@ def analyze_from_inventory(self, inventory) -> CoverageReport:
         imbalance_ratio = (max(counts) / min(counts)) if counts and min(counts) > 0 else 0.0
         gaps = self._find_gaps(stage_counts)
         recommendations = self._generate_recommendations(
-            total_embryos, annotated_embryos, coverage_pct, stage_counts, gaps,
+            total_embryos,
+            annotated_embryos,
+            coverage_pct,
+            stage_counts,
+            gaps,
         )
 
         return CoverageReport(
@@ -131,7 +150,7 @@ def analyze_from_inventory(self, inventory) -> CoverageReport:
             recommendations=recommendations,
         )
 
-    def _find_gaps(self, stage_counts: Dict[str, int]) -> List[str]:
+    def _find_gaps(self, stage_counts: dict[str, int]) -> list[str]:
         """Identify underrepresented stages."""
         gaps = []
         if not stage_counts:
@@ -142,7 +161,9 @@ def _find_gaps(self, stage_counts: Dict[str, int]) -> List[str]:
         # Stages with too few samples
         for stage, count in stage_counts.items():
             if count < MIN_SAMPLES_PER_STAGE:
-                gaps.append(f"{stage} underrepresented ({count} samples, need {MIN_SAMPLES_PER_STAGE})")
+                gaps.append(
+                    f"{stage} underrepresented ({count} samples, need {MIN_SAMPLES_PER_STAGE})"
+                )
             elif count < avg * 0.5:
                 gaps.append(f"{stage} below average ({count} vs avg {avg:.0f})")
 
@@ -159,9 +180,9 @@ def _generate_recommendations(
         total_embryos: int,
         annotated: int,
         coverage_pct: float,
-        stage_counts: Dict[str, int],
-        gaps: List[str],
-    ) -> List[str]:
+        stage_counts: dict[str, int],
+        gaps: list[str],
+    ) -> list[str]:
         """Generate actionable recommendations."""
         recs = []
 
diff --git a/experimental/data_reasoning/gap_planner.py b/experimental/data_reasoning/gap_planner.py
index 4540d7a1..0a7f6bc6 100644
--- a/experimental/data_reasoning/gap_planner.py
+++ b/experimental/data_reasoning/gap_planner.py
@@ -3,7 +3,6 @@
 """
 
 import logging
-from typing import Optional
 
 from .models import CoverageReport
 
@@ -70,6 +69,7 @@ def plan_annotation_campaign(
 
         # Create items for completely missing stages
         from .coverage import KNOWN_STAGES
+
         present_stages = set(coverage_report.stage_counts.keys())
         for stage in KNOWN_STAGES:
             if stage not in present_stages:
diff --git a/experimental/data_reasoning/models.py b/experimental/data_reasoning/models.py
index 9e6f5ef9..8044f0b3 100644
--- a/experimental/data_reasoning/models.py
+++ b/experimental/data_reasoning/models.py
@@ -3,12 +3,13 @@
 """
 
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 
 @dataclass
 class SessionSummary:
     """Summary of a single imaging session's data."""
+
     session_id: str = ""
     session_name: str = ""
     source_peer: str = ""  # instance_id of peer (empty = local)
@@ -16,11 +17,11 @@ class SessionSummary:
     volume_count: int = 0
     annotated_embryos: int = 0
     ground_truth_count: int = 0
-    stages_covered: List[str] = field(default_factory=list)
+    stages_covered: list[str] = field(default_factory=list)
     total_size_gb: float = 0.0
     is_remote: bool = False
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "session_id": self.session_id,
             "session_name": self.session_name,
@@ -38,8 +39,9 @@ def to_dict(self) -> Dict[str, Any]:
 @dataclass
 class NetworkDataInventory:
     """Aggregated inventory of all data across the mesh."""
-    local_sessions: List[SessionSummary] = field(default_factory=list)
-    remote_sessions: List[SessionSummary] = field(default_factory=list)
+
+    local_sessions: list[SessionSummary] = field(default_factory=list)
+    remote_sessions: list[SessionSummary] = field(default_factory=list)
     total_embryos: int = 0
     total_volumes: int = 0
     total_annotated: int = 0
@@ -48,10 +50,10 @@ class NetworkDataInventory:
     peers_failed: int = 0
 
     @property
-    def all_sessions(self) -> List[SessionSummary]:
+    def all_sessions(self) -> list[SessionSummary]:
         return self.local_sessions + self.remote_sessions
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "local_sessions": [s.to_dict() for s in self.local_sessions],
             "remote_sessions": [s.to_dict() for s in self.remote_sessions],
@@ -67,15 +69,16 @@ def to_dict(self) -> Dict[str, Any]:
 @dataclass
 class CoverageReport:
     """Annotation coverage analysis across network data."""
+
     total_embryos: int = 0
     annotated_embryos: int = 0
     coverage_pct: float = 0.0
-    stage_counts: Dict[str, int] = field(default_factory=dict)
+    stage_counts: dict[str, int] = field(default_factory=dict)
     imbalance_ratio: float = 0.0
-    gaps: List[str] = field(default_factory=list)
-    recommendations: List[str] = field(default_factory=list)
+    gaps: list[str] = field(default_factory=list)
+    recommendations: list[str] = field(default_factory=list)
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "total_embryos": self.total_embryos,
             "annotated_embryos": self.annotated_embryos,
@@ -90,13 +93,14 @@ def to_dict(self) -> Dict[str, Any]:
 @dataclass
 class DataQualityReport:
     """Data quality validation results."""
+
     total_volumes_checked: int = 0
     readable_volumes: int = 0
     missing_projections: int = 0
     inconsistent_annotations: int = 0
-    issues: List[str] = field(default_factory=list)
+    issues: list[str] = field(default_factory=list)
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "total_volumes_checked": self.total_volumes_checked,
             "readable_volumes": self.readable_volumes,
diff --git a/experimental/data_reasoning/quality.py b/experimental/data_reasoning/quality.py
index 86afcf6e..6596fe75 100644
--- a/experimental/data_reasoning/quality.py
+++ b/experimental/data_reasoning/quality.py
@@ -7,7 +7,6 @@
 
 import logging
 from pathlib import Path
-from typing import Optional
 
 from .models import DataQualityReport
 
@@ -26,7 +25,9 @@ class QualityAnalyzer:
     def __init__(self, gently_store=None):
         self._store = gently_store
 
-    def analyze(self, session_ids: Optional[list] = None, check_files: bool = False) -> DataQualityReport:
+    def analyze(
+        self, session_ids: list | None = None, check_files: bool = False
+    ) -> DataQualityReport:
         """Run quality checks on local data.
 
         Parameters
@@ -62,7 +63,11 @@ def analyze(self, session_ids: Optional[list] = None, check_files: bool = False)
                     for vol in vols:
                         # Check volume file exists if requested
                         if check_files:
-                            vpath = vol.file_path if hasattr(vol, "file_path") else vol.get("file_path", "")
+                            vpath = (
+                                vol.file_path
+                                if hasattr(vol, "file_path")
+                                else vol.get("file_path", "")
+                            )
                             if vpath and Path(vpath).exists():
                                 report.readable_volumes += 1
                             elif vpath:
@@ -87,7 +92,11 @@ def analyze(self, session_ids: Optional[list] = None, check_files: bool = False)
                             # Check for overlapping timepoint ranges
                             ranges = []
                             for gt in gts:
-                                start = gt.start_tp if hasattr(gt, "start_tp") else gt.get("start_tp", 0)
+                                start = (
+                                    gt.start_tp
+                                    if hasattr(gt, "start_tp")
+                                    else gt.get("start_tp", 0)
+                                )
                                 end = gt.end_tp if hasattr(gt, "end_tp") else gt.get("end_tp", 0)
                                 if start and end and start > end:
                                     report.inconsistent_annotations += 1
diff --git a/experimental/ml_agent/agent.py b/experimental/ml_agent/agent.py
index 4e31e697..69e398e9 100644
--- a/experimental/ml_agent/agent.py
+++ b/experimental/ml_agent/agent.py
@@ -5,14 +5,12 @@
 execution loop, communicating back via the event bus.
 """
 
-import asyncio
 import json
 import logging
-from typing import Any, Dict, List, Optional
 
 from gently.core.event_bus import EventType, get_event_bus
 from gently.harness.tools.registry import ToolRegistry
-from .prompt import build_ml_system_prompt
+
 from .tools import register_ml_tools
 
 logger = logging.getLogger(__name__)
@@ -42,8 +40,8 @@ def __init__(
         self._peer_client = peer_client
         self._registry = ToolRegistry()
         self._running = False
-        self._task: Optional[str] = None
-        self._campaign_id: Optional[str] = None
+        self._task: str | None = None
+        self._campaign_id: str | None = None
 
         # Register ML tools on our private registry
         register_ml_tools(
@@ -96,15 +94,16 @@ async def run(self, task: str, campaign_id: str = ""):
             # Step 2: Check coverage
             bus.publish(
                 EventType.ML_SUBAGENT_STATUS,
-                {"status": "checking_coverage", "detail": "Analyzing annotation coverage..."},
+                {
+                    "status": "checking_coverage",
+                    "detail": "Analyzing annotation coverage...",
+                },
                 source="ml_subagent",
             )
-            coverage_result = await self._registry.execute(
-                "check_annotation_coverage", {}
-            )
+            coverage_result = await self._registry.execute("check_annotation_coverage", {})
             coverage = json.loads(coverage_result)
 
-            total_annotated = inventory.get("total_annotated", 0)
+            inventory.get("total_annotated", 0)
             total_gt = inventory.get("total_ground_truth", 0)
 
             # Step 3: Check if we have enough data
@@ -134,7 +133,7 @@ async def run(self, task: str, campaign_id: str = ""):
 
             # Determine VRAM
             vram = 24.0  # default A5000
-            local_sessions = inventory.get("local_sessions", [])
+            inventory.get("local_sessions", [])
 
             arch_result = await self._registry.execute(
                 "select_architecture",
diff --git a/experimental/ml_agent/prompt.py b/experimental/ml_agent/prompt.py
index 74ee5247..cc301743 100644
--- a/experimental/ml_agent/prompt.py
+++ b/experimental/ml_agent/prompt.py
@@ -2,12 +2,10 @@
 System prompt for the ML subagent.
 """
 
-from typing import Dict, List
-
 
 def build_ml_system_prompt(
-    architecture_registry: Dict,
-    hardware_info: Dict,
+    architecture_registry: dict,
+    hardware_info: dict,
     available_data_summary: str = "",
 ) -> str:
     """Build the system prompt for the ML subagent.
@@ -35,8 +33,10 @@ def build_ml_system_prompt(
     gpu_lines = []
     gpus = hardware_info.get("gpus", [])
     for g in gpus:
-        gpu_lines.append(f"- GPU {g.get('device_index', 0)}: {g.get('name', 'unknown')} "
-                         f"({g.get('vram_gb', 0)}GB VRAM)")
+        gpu_lines.append(
+            f"- GPU {g.get('device_index', 0)}: {g.get('name', 'unknown')} "
+            f"({g.get('vram_gb', 0)}GB VRAM)"
+        )
     gpu_section = "\n".join(gpu_lines) if gpu_lines else "No GPUs detected."
 
     return f"""You are the ML Training Subagent for Gently, a microscopy automation system.
@@ -50,14 +50,15 @@ def build_ml_system_prompt(
 
 ## Hardware
 {gpu_section}
-CPU cores: {hardware_info.get('cpu_cores', 0)}
-RAM: {hardware_info.get('ram_gb', 0)}GB
+CPU cores: {hardware_info.get("cpu_cores", 0)}
+RAM: {hardware_info.get("ram_gb", 0)}GB
 
 ## Available Data
 {available_data_summary or "Run inventory_datasets to discover available data."}
 
 ## Workflow
-1. **Assess data**: Use inventory_datasets and check_annotation_coverage to understand what's available
+1. **Assess data**: Use inventory_datasets and check_annotation_coverage to understand
+   what's available
 2. **Check readiness**: If coverage is insufficient, report gaps and suggest annotation campaigns
 3. **Select architecture**: Reason over the registry, dataset size, and hardware constraints
 4. **Configure training**: Set hyperparameters appropriate for the data and architecture
diff --git a/experimental/ml_agent/tools.py b/experimental/ml_agent/tools.py
index 096d5d27..488ca04c 100644
--- a/experimental/ml_agent/tools.py
+++ b/experimental/ml_agent/tools.py
@@ -8,16 +8,15 @@
 import json
 import logging
 from datetime import datetime
-from pathlib import Path
-from typing import Any, Dict, List, Optional
 
 from gently.harness.tools.registry import ToolCategory, ToolParameter
 
 logger = logging.getLogger(__name__)
 
 
-def register_ml_tools(registry, context_store=None, gently_store=None,
-                      verse_map=None, peer_client=None):
+def register_ml_tools(
+    registry, context_store=None, gently_store=None, verse_map=None, peer_client=None
+):
     """Register ML tools on a tool registry.
 
     Parameters
@@ -50,6 +49,7 @@ def register_ml_tools(registry, context_store=None, gently_store=None,
     )
     async def inventory_datasets(include_remote: bool = True, **kwargs) -> str:
         from gently.data_reasoning.assessment import DataAssessmentEngine
+
         engine = DataAssessmentEngine(
             gently_store=gently_store,
             peer_client=peer_client,
@@ -76,6 +76,7 @@ async def inventory_datasets(include_remote: bool = True, **kwargs) -> str:
     )
     async def check_annotation_coverage(session_ids: str = "", **kwargs) -> str:
         from gently.data_reasoning.coverage import CoverageAnalyzer
+
         analyzer = CoverageAnalyzer(gently_store=gently_store)
         sid_list = [s.strip() for s in session_ids.split(",") if s.strip()] or None
         report = analyzer.analyze(session_ids=sid_list)
@@ -105,6 +106,7 @@ async def check_annotation_coverage(session_ids: str = "", **kwargs) -> str:
     )
     async def select_architecture(dataset_size: int, vram_gb: float, **kwargs) -> str:
         from gently.ml.architectures import get_suitable_architectures
+
         results = get_suitable_architectures(dataset_size, vram_gb)
         return json.dumps(results, indent=2)
 
@@ -116,20 +118,46 @@ async def select_architecture(dataset_size: int, vram_gb: float, **kwargs) -> st
         ),
         category=ToolCategory.ML,
         parameters=[
-            ToolParameter(name="campaign_id", type="string",
-                          description="Campaign this pipeline belongs to", required=True),
-            ToolParameter(name="name", type="string",
-                          description="Pipeline name", required=True),
-            ToolParameter(name="architecture", type="string",
-                          description="Model architecture ID", required=True),
-            ToolParameter(name="num_classes", type="integer",
-                          description="Number of output classes", required=True),
-            ToolParameter(name="batch_size", type="integer",
-                          description="Training batch size", required=False, default=32),
-            ToolParameter(name="epochs", type="integer",
-                          description="Number of training epochs", required=False, default=50),
-            ToolParameter(name="learning_rate", type="number",
-                          description="Learning rate", required=False, default=1e-4),
+            ToolParameter(
+                name="campaign_id",
+                type="string",
+                description="Campaign this pipeline belongs to",
+                required=True,
+            ),
+            ToolParameter(name="name", type="string", description="Pipeline name", required=True),
+            ToolParameter(
+                name="architecture",
+                type="string",
+                description="Model architecture ID",
+                required=True,
+            ),
+            ToolParameter(
+                name="num_classes",
+                type="integer",
+                description="Number of output classes",
+                required=True,
+            ),
+            ToolParameter(
+                name="batch_size",
+                type="integer",
+                description="Training batch size",
+                required=False,
+                default=32,
+            ),
+            ToolParameter(
+                name="epochs",
+                type="integer",
+                description="Number of training epochs",
+                required=False,
+                default=50,
+            ),
+            ToolParameter(
+                name="learning_rate",
+                type="number",
+                description="Learning rate",
+                required=False,
+                default=1e-4,
+            ),
         ],
     )
     async def configure_training(
@@ -170,8 +198,12 @@ async def configure_training(
         ),
         category=ToolCategory.ML,
         parameters=[
-            ToolParameter(name="pipeline_id", type="string",
-                          description="Pipeline ID to train", required=True),
+            ToolParameter(
+                name="pipeline_id",
+                type="string",
+                description="Pipeline ID to train",
+                required=True,
+            ),
         ],
     )
     async def start_local_training(pipeline_id: str, **kwargs) -> str:
@@ -198,6 +230,7 @@ async def start_local_training(pipeline_id: str, **kwargs) -> str:
             return "Error: No data store available"
 
         from gently.ml.data_loader import build_labels_from_store
+
         labels = build_labels_from_store(gently_store)
 
         if not labels.get("samples"):
@@ -205,14 +238,15 @@ async def start_local_training(pipeline_id: str, **kwargs) -> str:
 
         # Write labels file
         from gently.settings import settings
+
         run_dir = settings.storage.base_path / "ml_runs" / run_data["id"]
         run_dir.mkdir(parents=True, exist_ok=True)
         labels_file = run_dir / "labels.json"
         labels_file.write_text(json.dumps(labels, indent=2))
 
         # Start trainer
+        from gently.ml.models import ModelConfig, TrainingConfig, TrainingRun
         from gently.ml.trainer import LocalTrainer
-        from gently.ml.models import TrainingRun, ModelConfig, TrainingConfig
 
         trainer = LocalTrainer(run_dir)
         run = TrainingRun(
@@ -228,22 +262,30 @@ async def start_local_training(pipeline_id: str, **kwargs) -> str:
         )
 
         context_store.update_training_run(
-            run_data["id"], status="training", started_at=datetime.now().isoformat(),
+            run_data["id"],
+            status="training",
+            started_at=datetime.now().isoformat(),
         )
 
-        return json.dumps({
-            "status": "training_started",
-            "run_id": run_data["id"],
-            "pipeline_id": pipeline_id,
-        })
+        return json.dumps(
+            {
+                "status": "training_started",
+                "run_id": run_data["id"],
+                "pipeline_id": pipeline_id,
+            }
+        )
 
     @registry.register(
         name="get_ml_status",
         description="Get the status of ML pipelines and training runs.",
         category=ToolCategory.ML,
         parameters=[
-            ToolParameter(name="pipeline_id", type="string",
-                          description="Pipeline ID (empty = list all)", required=False),
+            ToolParameter(
+                name="pipeline_id",
+                type="string",
+                description="Pipeline ID (empty = list all)",
+                required=False,
+            ),
         ],
     )
     async def get_ml_status(pipeline_id: str = "", **kwargs) -> str:
@@ -265,11 +307,19 @@ async def get_ml_status(pipeline_id: str = "", **kwargs) -> str:
         ),
         category=ToolCategory.ML,
         parameters=[
-            ToolParameter(name="campaign_id", type="string",
-                          description="Campaign to add items to", required=True),
-            ToolParameter(name="target_per_stage", type="integer",
-                          description="Target annotations per stage (default 50)",
-                          required=False, default=50),
+            ToolParameter(
+                name="campaign_id",
+                type="string",
+                description="Campaign to add items to",
+                required=True,
+            ),
+            ToolParameter(
+                name="target_per_stage",
+                type="integer",
+                description="Target annotations per stage (default 50)",
+                required=False,
+                default=50,
+            ),
         ],
     )
     async def plan_annotation_campaign(
@@ -290,8 +340,11 @@ async def plan_annotation_campaign(
             target_per_stage=target_per_stage,
         )
 
-        return json.dumps({
-            "created_plan_items": len(created_ids),
-            "item_ids": created_ids,
-            "coverage_before": report.to_dict(),
-        }, indent=2)
+        return json.dumps(
+            {
+                "created_plan_items": len(created_ids),
+                "item_ids": created_ids,
+                "coverage_before": report.to_dict(),
+            },
+            indent=2,
+        )
diff --git a/experimental/test_data_reasoning.py b/experimental/test_data_reasoning.py
index 14525d95..56164fcf 100644
--- a/experimental/test_data_reasoning.py
+++ b/experimental/test_data_reasoning.py
@@ -2,17 +2,15 @@
 Tests for data reasoning engine — coverage, assessment, gap planning.
 """
 
-from unittest.mock import MagicMock, AsyncMock
-import pytest
+from unittest.mock import MagicMock
 
+import pytest
+from gently.data_reasoning.assessment import DataAssessmentEngine
+from gently.data_reasoning.coverage import CoverageAnalyzer
+from gently.data_reasoning.gap_planner import GapPlanner
 from gently.data_reasoning.models import (
     CoverageReport,
-    NetworkDataInventory,
-    SessionSummary,
 )
-from gently.data_reasoning.coverage import CoverageAnalyzer
-from gently.data_reasoning.assessment import DataAssessmentEngine
-from gently.data_reasoning.gap_planner import GapPlanner
 
 
 def _make_mock_store(sessions=None, embryos_per_session=None, gt_per_embryo=None):
@@ -41,10 +39,12 @@ def list_embryos(sid):
             e.nickname = eid
             result.append(e)
         return result
+
     store.list_embryos.side_effect = list_embryos
 
     def list_volumes(sid, eid):
         return [MagicMock(timepoint=i) for i in range(3)]
+
     store.list_volumes.side_effect = list_volumes
 
     def get_ground_truth(sid, eid):
@@ -57,6 +57,7 @@ def get_ground_truth(sid, eid):
             gt.end_tp = 10
             result.append(gt)
         return result
+
     store.get_ground_truth.side_effect = get_ground_truth
 
     return store
@@ -101,8 +102,8 @@ def test_imbalance_detection(self):
             embryos_per_session={"s1": ["e1", "e2", "e3"]},
             gt_per_embryo={
                 ("s1", "e1"): ["early", "early", "early"],  # 3 early
-                ("s1", "e2"): ["comma"],                     # 1 comma
-                ("s1", "e3"): ["early"],                     # 1 more early
+                ("s1", "e2"): ["comma"],  # 1 comma
+                ("s1", "e3"): ["early"],  # 1 more early
             },
         )
         analyzer = CoverageAnalyzer(gently_store=store)
diff --git a/gently/__init__.py b/gently/__init__.py
index b7f6d72f..29b0b3b4 100644
--- a/gently/__init__.py
+++ b/gently/__init__.py
@@ -7,54 +7,58 @@
 
 # Main entry point
 from .gently import Gently, create_gently
+from .harness.memory.store import (
+    ContextStore,
+)
 
+# legacy SQLite store (kept for backward compat)
 # Harness (framework)
-from .harness.tools.registry import tool, ToolRegistry, ToolCategory, get_tool_registry
-from .harness.memory.store import ContextStore  # legacy SQLite store (kept for backward compat)
+from .harness.tools.registry import ToolCategory, ToolRegistry, get_tool_registry, tool
+
 try:
     from .harness.memory.file_store import FileContextStore
 except ImportError:
     FileContextStore = None
-from .harness.memory.interface import AgentMemory
-
 # Core infrastructure
 from .core import (
     EventBus,
     EventType,
     get_event_bus,
 )
-
-# Core utilities
-from .core.store import GentlyStore  # legacy SQLite store (kept for backward compat)
+from .core.coordinates import (
+    DEFAULT_OBJECTIVE_MAG,
+    DEFAULT_PIXEL_SIZE_UM,
+    get_um_per_pixel,
+    pixel_displacement_to_stage_movement,
+    pixel_to_stage_position,
+    stage_to_pixel_position,
+)
 from .core.file_store import FileStore
 from .core.imaging import (
-    normalize_to_uint8,
+    clip_and_project,
+    generate_jpeg_projection,
     image_to_base64,
+    normalize_to_uint8,
     projection_three_view,
     render_volume_view,
-    clip_and_project,
-    generate_jpeg_projection,
-)
-from .core.coordinates import (
-    pixel_to_stage_position,
-    stage_to_pixel_position,
-    pixel_displacement_to_stage_movement,
-    get_um_per_pixel,
-    DEFAULT_PIXEL_SIZE_UM,
-    DEFAULT_OBJECTIVE_MAG,
 )
 
+# Core utilities
+from .core.store import GentlyStore  # legacy SQLite store (kept for backward compat)
+from .harness.memory.interface import AgentMemory
+
 # Analysis utilities
 try:
     from .analysis.core import (
+        FitFunction,
+        FocusAlgorithm,
         FocusAnalysisConfig,
         FocusResult,
-        FocusAlgorithm,
-        FitFunction,
-        calculate_focus_score,
         analyze_focus_stack,
+        calculate_focus_score,
         fit_focus_curve,
     )
+
     _ANALYSIS_AVAILABLE = True
 except ImportError:
     _ANALYSIS_AVAILABLE = False
@@ -66,12 +70,13 @@
 # Visualization (web map view replaces the retired napari marker)
 try:
     from .ui.web import (
-        mark_embryos_web,
-        get_visualization_server,
-        generate_focus_curve_plot,
         generate_calibration_summary_plot,
         generate_edge_detection_plot,
+        generate_focus_curve_plot,
+        get_visualization_server,
+        mark_embryos_web,
     )
+
     _VISUALIZATION_AVAILABLE = True
 except ImportError:
     _VISUALIZATION_AVAILABLE = False
@@ -81,7 +86,6 @@
     # Main entry point
     "Gently",
     "create_gently",
-
     # Harness
     "tool",
     "ToolRegistry",
@@ -89,7 +93,6 @@
     "get_tool_registry",
     "ContextStore",  # legacy SQLite store (backward compat)
     "AgentMemory",
-
     # Core infrastructure
     "EventBus",
     "EventType",
@@ -97,7 +100,6 @@
     "GentlyStore",  # legacy SQLite store (backward compat)
     "FileStore",
     "FileContextStore",
-
     # Imaging
     "normalize_to_uint8",
     "image_to_base64",
@@ -105,7 +107,6 @@
     "render_volume_view",
     "clip_and_project",
     "generate_jpeg_projection",
-
     # Coordinates
     "pixel_to_stage_position",
     "stage_to_pixel_position",
@@ -113,7 +114,6 @@
     "get_um_per_pixel",
     "DEFAULT_PIXEL_SIZE_UM",
     "DEFAULT_OBJECTIVE_MAG",
-
     # Analysis
     "FocusAnalysisConfig",
     "FocusResult",
@@ -122,4 +122,10 @@
     "calculate_focus_score",
     "analyze_focus_stack",
     "fit_focus_curve",
+    # Visualization
+    "generate_calibration_summary_plot",
+    "generate_edge_detection_plot",
+    "generate_focus_curve_plot",
+    "get_visualization_server",
+    "mark_embryos_web",
 ]
diff --git a/gently/agent/__init__.py b/gently/agent/__init__.py
index 9ac0e133..6ef11680 100644
--- a/gently/agent/__init__.py
+++ b/gently/agent/__init__.py
@@ -6,38 +6,49 @@
 This module re-exports from the new locations for backward compatibility.
 """
 
+from gently_perception import Perceiver, PerceptionOutput
+from gently_perception import Session as PerceptionSession
+
 from gently.app.agent import MicroscopyAgent
-from gently.harness.state import EmbryoState, ExperimentState, ImageRecord
 from gently.harness.orchestration.plan_synthesis import PlanSynthesizer, PlanValidator
-from gently_perception import Perceiver, PerceptionOutput, Session as PerceptionSession
+from gently.harness.state import EmbryoState, ExperimentState, ImageRecord
+
 try:
     from gently.hardware.dispim.device_factory import create_devices_from_mmcore
 except ImportError:
     create_devices_from_mmcore = None
-from gently.app.queue_server_client import QueueServerClient
-from gently.harness.tools.registry import ToolRegistry, get_tool_registry, tool, ToolCategory
-from gently.app.benchmark import run_benchmark, BenchmarkResults, print_benchmark_results
-
 # Import tools package to register all tools
-from gently.app import tools
+from gently.app import tools  # noqa: F401
+from gently.app.benchmark import (
+    BenchmarkResults,
+    print_benchmark_results,
+    run_benchmark,
+)
+from gently.app.queue_server_client import QueueServerClient
+from gently.harness.tools.registry import (
+    ToolCategory,
+    ToolRegistry,
+    get_tool_registry,
+    tool,
+)
 
 __all__ = [
-    'MicroscopyAgent',
-    'QueueServerClient',
-    'EmbryoState',
-    'ExperimentState',
-    'ImageRecord',
-    'PlanSynthesizer',
-    'PlanValidator',
-    'Perceiver',
-    'PerceptionOutput',
-    'PerceptionSession',
-    'create_devices_from_mmcore',
-    'ToolRegistry',
-    'get_tool_registry',
-    'tool',
-    'ToolCategory',
-    'run_benchmark',
-    'BenchmarkResults',
-    'print_benchmark_results',
+    "MicroscopyAgent",
+    "QueueServerClient",
+    "EmbryoState",
+    "ExperimentState",
+    "ImageRecord",
+    "PlanSynthesizer",
+    "PlanValidator",
+    "Perceiver",
+    "PerceptionOutput",
+    "PerceptionSession",
+    "create_devices_from_mmcore",
+    "ToolRegistry",
+    "get_tool_registry",
+    "tool",
+    "ToolCategory",
+    "run_benchmark",
+    "BenchmarkResults",
+    "print_benchmark_results",
 ]
diff --git a/gently/analysis/__init__.py b/gently/analysis/__init__.py
index a6772a4b..08c6e228 100644
--- a/gently/analysis/__init__.py
+++ b/gently/analysis/__init__.py
@@ -11,8 +11,8 @@
 """
 
 from .pipeline import (
-    AnalysisStep,
     AnalysisResult,
+    AnalysisStep,
     Pipeline,
     PipelineBuilder,
     StepType,
@@ -20,14 +20,13 @@
     create_hatching_detection_pipeline,
     create_morphology_analysis_pipeline,
 )
-
 from .steps import (
-    VLMStep,
-    SAMStep,
+    BlobDetectionStep,
     MaxProjectionStep,
-    ThresholdStep,
     MorphologyStep,
-    BlobDetectionStep,
+    SAMStep,
+    ThresholdStep,
+    VLMStep,
 )
 
 __all__ = [
diff --git a/gently/analysis/core.py b/gently/analysis/core.py
index 6c95df07..d5f93b57 100644
--- a/gently/analysis/core.py
+++ b/gently/analysis/core.py
@@ -10,19 +10,20 @@
 """
 
 import logging
-from typing import Dict, List, Optional, Tuple, Any, Union
 from dataclasses import dataclass
 from enum import Enum
+from typing import Any
+
 import numpy as np
-from scipy import optimize, stats
+from scipy import optimize
 from scipy.ndimage import gaussian_filter, sobel
-import warnings
 
 from ..exceptions import FocusFitError
 
 
 class FocusAlgorithm(Enum):
     """Focus scoring algorithms available"""
+
     VOLATH = "volath"
     GRADIENT = "gradient"
     VARIANCE = "variance"
@@ -32,11 +33,12 @@ class FocusAlgorithm(Enum):
 # FFT Bandpass parameters (from ASI diSPIM OughtaFocus implementation)
 # These define the spatial frequency band analyzed for focus quality
 FFT_LOWER_CUTOFF = 0.025  # 2.5% of max frequency - filters DC and low spatial frequencies
-FFT_UPPER_CUTOFF = 0.14   # 14% of max frequency - filters high-frequency noise
+FFT_UPPER_CUTOFF = 0.14  # 14% of max frequency - filters high-frequency noise
 
 
 class FitFunction(Enum):
     """Curve fitting functions available"""
+
     GAUSSIAN = "gaussian"
     PARABOLIC = "parabolic"
     NONE = "none"
@@ -45,6 +47,7 @@ class FitFunction(Enum):
 @dataclass
 class FocusAnalysisConfig:
     """Configuration for focus analysis operations"""
+
     algorithm: str = FocusAlgorithm.VOLATH.value
     fit_function: str = FitFunction.GAUSSIAN.value
     minimum_r_squared: float = 0.75
@@ -56,14 +59,15 @@ class FocusAnalysisConfig:
 @dataclass
 class FocusResult:
     """Result of focus analysis"""
+
     success: bool
     best_position: float
     best_score: float
     r_squared: float
-    fit_params: Optional[np.ndarray] = None
-    all_positions: Optional[np.ndarray] = None
-    all_scores: Optional[np.ndarray] = None
-    error_message: Optional[str] = None
+    fit_params: np.ndarray | None = None
+    all_positions: np.ndarray | None = None
+    all_scores: np.ndarray | None = None
+    error_message: str | None = None
 
 
 class AdaptiveSweepState:
@@ -82,15 +86,15 @@ class AdaptiveSweepState:
 
     # Early stopping thresholds
     DECLINE_THRESHOLD: float = 0.70  # Stop if score drops below 70% of max
-    MIN_DECLINE_COUNT: int = 3       # Require N consecutive declines
-    MIN_POINTS_FOR_FIT: int = 5      # Minimum points before attempting fit
-    MIN_POINTS_PAST_PEAK: int = 3    # Need N points past peak for robust fit
+    MIN_DECLINE_COUNT: int = 3  # Require N consecutive declines
+    MIN_POINTS_FOR_FIT: int = 5  # Minimum points before attempting fit
+    MIN_POINTS_PAST_PEAK: int = 3  # Need N points past peak for robust fit
     STABILITY_THRESHOLD_UM: float = 0.5  # Peak position stability threshold
     HIGH_CONFIDENCE_R2: float = 0.90  # R² threshold for early exit
 
     def __init__(self):
-        self.positions: List[float] = []
-        self.scores: List[float] = []
+        self.positions: list[float] = []
+        self.scores: list[float] = []
 
         # Peak detection state
         self.running_max_score: float = 0.0
@@ -103,9 +107,9 @@ def __init__(self):
         self.current_r_squared: float = 0.0
         self.fit_stable: bool = False
         self.last_fit_position: float = 0.0
-        self.fit_history: List[Dict[str, float]] = []
+        self.fit_history: list[dict[str, float]] = []
 
-    def add_point(self, position: float, score: float) -> Dict[str, Any]:
+    def add_point(self, position: float, score: float) -> dict[str, Any]:
         """
         Add new measurement and compute early stopping decision.
 
@@ -127,9 +131,9 @@ def add_point(self, position: float, score: float) -> Dict[str, Any]:
         self.scores.append(score)
 
         result = {
-            'should_stop': False,
-            'reason': None,
-            'confidence': 0.0,
+            "should_stop": False,
+            "reason": None,
+            "confidence": 0.0,
         }
 
         # Update running max
@@ -147,44 +151,49 @@ def add_point(self, position: float, score: float) -> Dict[str, Any]:
         points_past_peak = len(self.positions) - self.running_max_idx - 1
         if self.decline_count >= self.MIN_DECLINE_COUNT:
             self.peak_detected = True
-            result['confidence'] = 0.7
+            result["confidence"] = 0.7
 
             # Continue a few more points past detected peak for robust fitting
             if points_past_peak >= self.MIN_POINTS_PAST_PEAK:
-                result['should_stop'] = True
-                result['reason'] = 'peak_passed'
+                result["should_stop"] = True
+                result["reason"] = "peak_passed"
 
         # Confidence-based early exit (if we have enough points)
         if len(self.positions) >= self.MIN_POINTS_FOR_FIT:
             fit_result = self._attempt_fit()
             if fit_result:
-                self.current_r_squared = fit_result['r_squared']
-                new_position = fit_result['peak_position']
+                self.current_r_squared = fit_result["r_squared"]
+                new_position = fit_result["peak_position"]
 
                 # Track fit history for stability check
-                self.fit_history.append({
-                    'position': new_position,
-                    'r_squared': fit_result['r_squared'],
-                })
+                self.fit_history.append(
+                    {
+                        "position": new_position,
+                        "r_squared": fit_result["r_squared"],
+                    }
+                )
 
                 # Check stability (position change across recent fits)
                 if len(self.fit_history) >= 3:
-                    recent_positions = [f['position'] for f in self.fit_history[-3:]]
+                    recent_positions = [f["position"] for f in self.fit_history[-3:]]
                     position_range = max(recent_positions) - min(recent_positions)
                     self.fit_stable = position_range < self.STABILITY_THRESHOLD_UM
 
                 self.last_fit_position = new_position
 
                 # High confidence early exit
-                if (self.current_r_squared >= self.HIGH_CONFIDENCE_R2 and
-                    self.fit_stable and len(self.positions) >= 7):
-                    result['should_stop'] = True
-                    result['reason'] = 'high_confidence_fit'
-                    result['confidence'] = self.current_r_squared
+                if (
+                    self.current_r_squared >= self.HIGH_CONFIDENCE_R2
+                    and self.fit_stable
+                    and len(self.positions) >= 7
+                ):
+                    result["should_stop"] = True
+                    result["reason"] = "high_confidence_fit"
+                    result["confidence"] = self.current_r_squared
 
         return result
 
-    def _attempt_fit(self) -> Optional[Dict[str, Any]]:
+    def _attempt_fit(self) -> dict[str, Any] | None:
         """
         Attempt Gaussian fit on current data.
 
@@ -201,19 +210,17 @@ def _attempt_fit(self) -> Optional[Dict[str, Any]]:
             scores = np.array(self.scores)
 
             # Use existing fit_focus_curve
-            _, _, params, r_squared = fit_focus_curve(
-                positions, scores, FitFunction.GAUSSIAN.value
-            )
+            _, _, params, r_squared = fit_focus_curve(positions, scores, FitFunction.GAUSSIAN.value)
 
             return {
-                'peak_position': float(params[1]),  # mu
-                'r_squared': r_squared,
-                'params': params,
+                "peak_position": float(params[1]),  # mu
+                "r_squared": r_squared,
+                "params": params,
             }
         except Exception:
             return None
 
-    def get_best_position(self) -> Tuple[float, float]:
+    def get_best_position(self) -> tuple[float, float]:
         """
         Get best focus position from current data.
 
@@ -227,8 +234,8 @@ def get_best_position(self) -> Tuple[float, float]:
 
         # Try fit first
         fit_result = self._attempt_fit()
-        if fit_result and fit_result['r_squared'] >= 0.5:
-            return (fit_result['peak_position'], fit_result['r_squared'])
+        if fit_result and fit_result["r_squared"] >= 0.5:
+            return (fit_result["peak_position"], fit_result["r_squared"])
 
         # Fall back to max score position
         return (self.running_max_position, 0.0)
@@ -248,9 +255,12 @@ def reset(self):
         self.fit_history = []
 
 
-def calculate_focus_score(image: np.ndarray, algorithm: str = FocusAlgorithm.VOLATH.value,
-                         roi: Optional[Tuple[int, int, int, int]] = None,
-                         config: Optional[FocusAnalysisConfig] = None) -> float:
+def calculate_focus_score(
+    image: np.ndarray,
+    algorithm: str = FocusAlgorithm.VOLATH.value,
+    roi: tuple[int, int, int, int] | None = None,
+    config: FocusAnalysisConfig | None = None,
+) -> float:
     """
     Calculate focus score for an image using specified algorithm
 
@@ -285,12 +295,12 @@ def calculate_focus_score(image: np.ndarray, algorithm: str = FocusAlgorithm.VOL
     # Apply ROI if specified
     if roi is not None:
         x, y, w, h = roi
-        image = image[y:y+h, x:x+w]
+        image = image[y : y + h, x : x + w]
 
     # Crop edges to avoid boundary effects
     if config.edge_crop > 0:
         crop = config.edge_crop
-        if image.shape[0] > 2*crop and image.shape[1] > 2*crop:
+        if image.shape[0] > 2 * crop and image.shape[1] > 2 * crop:
             image = image[crop:-crop, crop:-crop]
 
     # Convert to float for calculations
@@ -324,7 +334,7 @@ def _volath_focus_score(image: np.ndarray) -> float:
         shifted = np.roll(image, 1, axis=1)
         product_sum = np.sum(image * shifted)
 
-        return product_sum - (mean_val ** 2) * image.size
+        return product_sum - (mean_val**2) * image.size
 
     except Exception as e:
         logging.getLogger(__name__).error(f"Volath focus score failed: {e}")
@@ -362,9 +372,11 @@ def _variance_focus_score(image: np.ndarray) -> float:
         return 0.0
 
 
-def _fft_bandpass_focus_score(image: np.ndarray,
-                               lower_cutoff: float = FFT_LOWER_CUTOFF,
-                               upper_cutoff: float = FFT_UPPER_CUTOFF) -> float:
+def _fft_bandpass_focus_score(
+    image: np.ndarray,
+    lower_cutoff: float = FFT_LOWER_CUTOFF,
+    upper_cutoff: float = FFT_UPPER_CUTOFF,
+) -> float:
     """
     FFT bandpass focus measure (ASI diSPIM OughtaFocus algorithm).
 
@@ -408,7 +420,7 @@ def _fft_bandpass_focus_score(image: np.ndarray,
 
         # Create distance map from center (DC component)
         y, x = np.ogrid[:h, :w]
-        distance_from_center = np.sqrt((x - cx)**2 + (y - cy)**2)
+        distance_from_center = np.sqrt((x - cx) ** 2 + (y - cy) ** 2)
 
         # Maximum frequency (corner distance)
         max_freq = np.sqrt(cx**2 + cy**2)
@@ -417,7 +429,9 @@ def _fft_bandpass_focus_score(image: np.ndarray,
         normalized_distance = distance_from_center / max_freq
 
         # Create bandpass mask: keep frequencies in [lower_cutoff, upper_cutoff]
-        bandpass_mask = (normalized_distance >= lower_cutoff) & (normalized_distance <= upper_cutoff)
+        bandpass_mask = (normalized_distance >= lower_cutoff) & (
+            normalized_distance <= upper_cutoff
+        )
 
         # Apply mask and compute mean power in band
         masked_power = power_spectrum * bandpass_mask
@@ -434,8 +448,9 @@ def _fft_bandpass_focus_score(image: np.ndarray,
         return 0.0
 
 
-def analyze_focus_stack(positions: List[float], images: List[np.ndarray],
-                       config: FocusAnalysisConfig) -> FocusResult:
+def analyze_focus_stack(
+    positions: list[float], images: list[np.ndarray], config: FocusAnalysisConfig
+) -> FocusResult:
     """
     Analyze a complete focus stack to find best focus position
 
@@ -459,14 +474,20 @@ def analyze_focus_stack(positions: List[float], images: List[np.ndarray],
     try:
         if len(positions) != len(images):
             return FocusResult(
-                success=False, best_position=0.0, best_score=0.0, r_squared=0.0,
-                error_message="Positions and images length mismatch"
+                success=False,
+                best_position=0.0,
+                best_score=0.0,
+                r_squared=0.0,
+                error_message="Positions and images length mismatch",
             )
 
         if len(positions) < 3:
             return FocusResult(
-                success=False, best_position=0.0, best_score=0.0, r_squared=0.0,
-                error_message="Need at least 3 data points for analysis"
+                success=False,
+                best_position=0.0,
+                best_score=0.0,
+                r_squared=0.0,
+                error_message="Need at least 3 data points for analysis",
             )
 
         # Calculate focus scores for all images
@@ -495,7 +516,7 @@ def analyze_focus_stack(positions: List[float], images: List[np.ndarray],
                 best_position = positions[best_idx]
                 best_score = scores[best_idx]
 
-        except (FocusFitError, Exception) as fit_error:
+        except (FocusFitError, Exception):
             # Fallback to highest measured score
             best_idx = np.argmax(scores)
             best_position = positions[best_idx]
@@ -510,18 +531,24 @@ def analyze_focus_stack(positions: List[float], images: List[np.ndarray],
             r_squared=float(r_squared),
             fit_params=fit_params,
             all_positions=positions,
-            all_scores=scores
+            all_scores=scores,
         )
 
     except Exception as e:
         return FocusResult(
-            success=False, best_position=0.0, best_score=0.0, r_squared=0.0,
-            error_message=str(e)
+            success=False,
+            best_position=0.0,
+            best_score=0.0,
+            r_squared=0.0,
+            error_message=str(e),
         )
 
 
-def fit_focus_curve(positions: np.ndarray, scores: np.ndarray,
-                   fit_function: str = FitFunction.GAUSSIAN.value) -> Tuple[np.ndarray, np.ndarray, np.ndarray, float]:
+def fit_focus_curve(
+    positions: np.ndarray,
+    scores: np.ndarray,
+    fit_function: str = FitFunction.GAUSSIAN.value,
+) -> tuple[np.ndarray, np.ndarray, np.ndarray, float]:
     """
     Fit a curve to focus score data
 
@@ -545,7 +572,7 @@ def fit_focus_curve(positions: np.ndarray, scores: np.ndarray,
     # Create high-resolution position array for smooth curve
     pos_range = np.max(positions) - np.min(positions)
     pos_center = (np.max(positions) + np.min(positions)) / 2
-    fitted_positions = np.linspace(pos_center - pos_range*0.6, pos_center + pos_range*0.6, 100)
+    fitted_positions = np.linspace(pos_center - pos_range * 0.6, pos_center + pos_range * 0.6, 100)
 
     try:
         if fit_function == FitFunction.GAUSSIAN.value:
@@ -558,7 +585,7 @@ def fit_focus_curve(positions: np.ndarray, scores: np.ndarray,
         # Generate fitted curve
         if fit_function == FitFunction.GAUSSIAN.value:
             a, mu, sigma, c = fit_params
-            fitted_scores = a * np.exp(-((fitted_positions - mu) ** 2) / (2 * sigma ** 2)) + c
+            fitted_scores = a * np.exp(-((fitted_positions - mu) ** 2) / (2 * sigma**2)) + c
         else:  # parabolic
             a, b, c = fit_params
             fitted_scores = a * fitted_positions**2 + b * fitted_positions + c
@@ -572,10 +599,11 @@ def fit_focus_curve(positions: np.ndarray, scores: np.ndarray,
         raise
 
 
-def _fit_gaussian(positions: np.ndarray, scores: np.ndarray) -> Tuple[np.ndarray, float]:
+def _fit_gaussian(positions: np.ndarray, scores: np.ndarray) -> tuple[np.ndarray, float]:
     """Fit Gaussian curve to focus data"""
+
     def gaussian(x, a, mu, sigma, c):
-        return a * np.exp(-((x - mu) ** 2) / (2 * sigma ** 2)) + c
+        return a * np.exp(-((x - mu) ** 2) / (2 * sigma**2)) + c
 
     # Initial parameter estimates
     a_init = np.max(scores) - np.min(scores)
@@ -588,7 +616,7 @@ def gaussian(x, a, mu, sigma, c):
     # Fit with bounds to ensure physical parameters
     bounds = (
         [0, np.min(positions), 0.1, 0],  # Lower bounds
-        [np.inf, np.max(positions), np.inf, np.inf]  # Upper bounds
+        [np.inf, np.max(positions), np.inf, np.inf],  # Upper bounds
     )
 
     popt, pcov = optimize.curve_fit(gaussian, positions, scores, p0=p0, bounds=bounds, maxfev=1000)
@@ -602,7 +630,7 @@ def gaussian(x, a, mu, sigma, c):
     return popt, r_squared
 
 
-def _fit_parabolic(positions: np.ndarray, scores: np.ndarray) -> Tuple[np.ndarray, float]:
+def _fit_parabolic(positions: np.ndarray, scores: np.ndarray) -> tuple[np.ndarray, float]:
     """Fit parabolic curve to focus data"""
     # Fit quadratic polynomial: y = ax^2 + bx + c
     coeffs = np.polyfit(positions, scores, 2)
@@ -617,9 +645,9 @@ def _fit_parabolic(positions: np.ndarray, scores: np.ndarray) -> Tuple[np.ndarra
 
 
 def create_focus_montage(
-    images: List[np.ndarray],
-    labels: Optional[List[str]] = None,
-    offsets: Optional[List[float]] = None,
+    images: list[np.ndarray],
+    labels: list[str] | None = None,
+    offsets: list[float] | None = None,
     normalize: bool = True,
     gap: int = 4,
 ) -> np.ndarray:
@@ -659,7 +687,7 @@ def create_focus_montage(
 
     # Default labels: A, B, C, ...
     if labels is None:
-        labels = [chr(ord('A') + i) for i in range(len(images))]
+        labels = [chr(ord("A") + i) for i in range(len(images))]
 
     # Ensure all images are 2D and same size
     processed = []
@@ -689,19 +717,22 @@ def create_focus_montage(
     # Create montage canvas
     n = len(processed)
     total_width = w * n + gap * (n - 1)
-    montage = np.ones((h + 30, total_width), dtype=np.uint8) * 255  # White background, extra space for labels
+    montage = (
+        np.ones((h + 30, total_width), dtype=np.uint8) * 255
+    )  # White background, extra space for labels
 
     # Place images with gaps
-    for i, (img, label) in enumerate(zip(processed, labels)):
+    for i, (img, label) in enumerate(zip(processed, labels, strict=False)):
         x_start = i * (w + gap)
 
         # Resize if needed to match reference dimensions
         if img.shape != (h, w):
             from scipy.ndimage import zoom
+
             zoom_factors = (h / img.shape[0], w / img.shape[1])
             img = zoom(img, zoom_factors, order=1).astype(np.uint8)
 
-        montage[:h, x_start:x_start + w] = img
+        montage[:h, x_start : x_start + w] = img
 
         # Add label text (simple pixel drawing for letter)
         # Position label at top-left of each image
@@ -738,4 +769,4 @@ def _draw_label(image: np.ndarray, text: str, x: int, y: int, small: bool = Fals
         image[y:y_end, x:x_end] = 40  # Dark gray background
 
     # Note: For proper text rendering, the caller should use PIL or OpenCV
-    # This placeholder ensures the montage structure works
\ No newline at end of file
+    # This placeholder ensures the montage structure works
diff --git a/gently/analysis/focus.py b/gently/analysis/focus.py
index 82bd578c..1983abf8 100644
--- a/gently/analysis/focus.py
+++ b/gently/analysis/focus.py
@@ -10,43 +10,46 @@
 """
 
 import logging
-import numpy as np
-from typing import List, Tuple, Optional, Dict, Any
 from dataclasses import dataclass
 
+import numpy as np
+
 logger = logging.getLogger(__name__)
 
 # Import from core analysis module
-from .core import (
-    calculate_focus_score, analyze_focus_stack, fit_focus_curve,
-    FocusAnalysisConfig, FocusResult
+from ..detection import get_embryo_focus_roi  # noqa: E402
+from .core import (  # noqa: E402
+    FocusAnalysisConfig,
+    analyze_focus_stack,
+    calculate_focus_score,
 )
-from ..detection import get_embryo_focus_roi
 
 
 @dataclass
 class FocusDataPoint:
     """Single focus measurement data point"""
+
     position: float
     score: float
     image: np.ndarray
-    roi: Optional[Tuple[int, int, int, int]] = None
+    roi: tuple[int, int, int, int] | None = None
 
 
 @dataclass
 class FocusSweepResult:
     """Result of a focus sweep with analysis"""
+
     success: bool
     best_position: float
     best_score: float
-    all_data: List[FocusDataPoint]
+    all_data: list[FocusDataPoint]
     r_squared: float = 0.0
-    error_message: Optional[str] = None
+    error_message: str | None = None
 
 
-def score_single_image(image: np.ndarray,
-                      config: FocusAnalysisConfig,
-                      detect_roi: bool = True) -> Tuple[float, Optional[Tuple[int, int, int, int]]]:
+def score_single_image(
+    image: np.ndarray, config: FocusAnalysisConfig, detect_roi: bool = True
+) -> tuple[float, tuple[int, int, int, int] | None]:
     """
     Score a single image for focus quality
 
@@ -74,10 +77,12 @@ def score_single_image(image: np.ndarray,
     return score, roi
 
 
-def find_best_focus_position(positions: List[float],
-                           scores: List[float],
-                           images: List[np.ndarray],
-                           config: FocusAnalysisConfig) -> float:
+def find_best_focus_position(
+    positions: list[float],
+    scores: list[float],
+    images: list[np.ndarray],
+    config: FocusAnalysisConfig,
+) -> float:
     """
     Find the best focus position from sweep data
 
@@ -122,8 +127,9 @@ def find_best_focus_position(positions: List[float],
         return positions[np.argmax(scores)]
 
 
-def analyze_focus_sweep(sweep_data: List[FocusDataPoint],
-                       config: FocusAnalysisConfig) -> FocusSweepResult:
+def analyze_focus_sweep(
+    sweep_data: list[FocusDataPoint], config: FocusAnalysisConfig
+) -> FocusSweepResult:
     """
     Analyze a complete focus sweep
 
@@ -147,7 +153,7 @@ def analyze_focus_sweep(sweep_data: List[FocusDataPoint],
             best_position=0.0,
             best_score=0.0,
             all_data=sweep_data,
-            error_message="Insufficient data points for analysis"
+            error_message="Insufficient data points for analysis",
         )
 
     try:
@@ -176,7 +182,7 @@ def analyze_focus_sweep(sweep_data: List[FocusDataPoint],
             best_position=best_position,
             best_score=best_score,
             all_data=sweep_data,
-            r_squared=r_squared
+            r_squared=r_squared,
         )
 
     except Exception as e:
@@ -185,14 +191,13 @@ def analyze_focus_sweep(sweep_data: List[FocusDataPoint],
             best_position=0.0,
             best_score=0.0,
             all_data=sweep_data,
-            error_message=str(e)
+            error_message=str(e),
         )
 
 
-def create_focus_positions(center: float,
-                          range_um: float,
-                          num_steps: int,
-                          limits: Tuple[float, float]) -> List[float]:
+def create_focus_positions(
+    center: float, range_um: float, num_steps: int, limits: tuple[float, float]
+) -> list[float]:
     """
     Create focus sweep positions with limit checking
 
@@ -215,11 +220,7 @@ def create_focus_positions(center: float,
         List of valid positions within limits
     """
     # Generate positions
-    positions = np.linspace(
-        center - range_um/2,
-        center + range_um/2,
-        num_steps
-    )
+    positions = np.linspace(center - range_um / 2, center + range_um / 2, num_steps)
 
     # Filter to limits
     min_pos, max_pos = limits
@@ -240,22 +241,24 @@ def print_focus_summary(result: FocusSweepResult, scan_type: str = "focus") -> N
         Type of scan ("coarse", "fine", etc.)
     """
     if result.success:
-        logger.info(f"{scan_type.capitalize()} analysis: "
-              f"best position {result.best_position:.2f} um "
-              f"(score: {result.best_score:.1f}, R2: {result.r_squared:.3f})")
+        logger.info(
+            f"{scan_type.capitalize()} analysis: "
+            f"best position {result.best_position:.2f} um "
+            f"(score: {result.best_score:.1f}, R2: {result.r_squared:.3f})"
+        )
     else:
         logger.warning(f"{scan_type.capitalize()} analysis failed: {result.error_message}")
 
 
 # Convenience functions for common operations
-def quick_focus_score(image: np.ndarray, algorithm: str = 'gradient') -> float:
+def quick_focus_score(image: np.ndarray, algorithm: str = "gradient") -> float:
     """Quick focus scoring with default parameters"""
     config = FocusAnalysisConfig(algorithm=algorithm)
     score, _ = score_single_image(image, config, detect_roi=True)
     return score
 
 
-def is_good_focus_curve(scores: List[float], threshold: float = 0.1) -> bool:
+def is_good_focus_curve(scores: list[float], threshold: float = 0.1) -> bool:
     """
     Check if focus curve has sufficient variation for analysis
 
@@ -281,4 +284,4 @@ def is_good_focus_curve(scores: List[float], threshold: float = 0.1) -> bool:
         return False
 
     coefficient_of_variation = std_dev / mean_score
-    return coefficient_of_variation >= threshold
\ No newline at end of file
+    return coefficient_of_variation >= threshold
diff --git a/gently/analysis/pipeline.py b/gently/analysis/pipeline.py
index 1edd4230..8e6b1d8c 100644
--- a/gently/analysis/pipeline.py
+++ b/gently/analysis/pipeline.py
@@ -4,7 +4,6 @@
 Provides the base classes and execution engine for composable analysis pipelines.
 """
 
-import asyncio
 import logging
 import time
 import uuid
@@ -12,25 +11,24 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum, auto
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import Any
 
 from ..settings import settings
 
-import numpy as np
-
 logger = logging.getLogger(__name__)
 
 
 class StepType(Enum):
     """Types of analysis steps"""
-    VLM = auto()           # Vision Language Model (Claude)
-    SAM = auto()           # Segment Anything Model
-    CLASSICAL = auto()     # Classical CV (OpenCV, scikit-image)
-    PROJECTION = auto()    # Dimension reduction (max proj, etc.)
-    THRESHOLD = auto()     # Thresholding operations
-    MORPHOLOGY = auto()    # Morphological operations
-    DETECTION = auto()     # Object detection
-    CUSTOM = auto()        # Custom step
+
+    VLM = auto()  # Vision Language Model (Claude)
+    SAM = auto()  # Segment Anything Model
+    CLASSICAL = auto()  # Classical CV (OpenCV, scikit-image)
+    PROJECTION = auto()  # Dimension reduction (max proj, etc.)
+    THRESHOLD = auto()  # Thresholding operations
+    MORPHOLOGY = auto()  # Morphological operations
+    DETECTION = auto()  # Object detection
+    CUSTOM = auto()  # Custom step
 
 
 @dataclass
@@ -44,37 +42,38 @@ class AnalysisResult:
     - Metadata about the analysis
     - The actual result data
     """
+
     uid: str = field(default_factory=lambda: str(uuid.uuid4()))
     step_name: str = ""
     step_type: StepType = StepType.CUSTOM
-    parent_uid: Optional[str] = None
+    parent_uid: str | None = None
     timestamp: datetime = field(default_factory=datetime.now)
 
     # Result data
     data: Any = None  # Primary result (image, mask, dict, etc.)
-    metadata: Dict[str, Any] = field(default_factory=dict)
+    metadata: dict[str, Any] = field(default_factory=dict)
 
     # Execution info
     duration_ms: float = 0.0
     success: bool = True
-    error: Optional[str] = None
+    error: str | None = None
 
     def __str__(self) -> str:
         status = "+" if self.success else "x"
         return f"{status} {self.step_name} ({self.step_type.name}) [{self.uid[:8]}]"
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize to dictionary"""
         return {
-            'uid': self.uid,
-            'step_name': self.step_name,
-            'step_type': self.step_type.name,
-            'parent_uid': self.parent_uid,
-            'timestamp': self.timestamp.isoformat(),
-            'metadata': self.metadata,
-            'duration_ms': self.duration_ms,
-            'success': self.success,
-            'error': self.error,
+            "uid": self.uid,
+            "step_name": self.step_name,
+            "step_type": self.step_type.name,
+            "parent_uid": self.parent_uid,
+            "timestamp": self.timestamp.isoformat(),
+            "metadata": self.metadata,
+            "duration_ms": self.duration_ms,
+            "success": self.success,
+            "error": self.error,
         }
 
 
@@ -91,9 +90,9 @@ class AnalysisStep(ABC):
 
     def __init__(
         self,
-        name: Optional[str] = None,
+        name: str | None = None,
         step_type: StepType = StepType.CUSTOM,
-        config: Optional[Dict] = None,
+        config: dict | None = None,
     ):
         self.name = name or self.__class__.__name__
         self.step_type = step_type
@@ -103,7 +102,7 @@ def __init__(
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """
         Execute the analysis step
@@ -125,7 +124,7 @@ async def execute(
     async def __call__(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Allow calling step directly"""
         return await self.execute(input_data, context)
@@ -148,15 +147,15 @@ class Pipeline:
     def __init__(
         self,
         name: str = "pipeline",
-        steps: Optional[List[AnalysisStep]] = None,
+        steps: list[AnalysisStep] | None = None,
         store_intermediate: bool = False,
     ):
         self.name = name
-        self.steps: List[AnalysisStep] = steps or []
+        self.steps: list[AnalysisStep] = steps or []
         self.store_intermediate = store_intermediate
         self._data_store = None
 
-    def add_step(self, step: AnalysisStep) -> 'Pipeline':
+    def add_step(self, step: AnalysisStep) -> "Pipeline":
         """Add a step to the pipeline (fluent)"""
         self.steps.append(step)
         return self
@@ -168,7 +167,7 @@ def set_data_store(self, store):
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """
         Execute the full pipeline
@@ -187,8 +186,8 @@ async def execute(
         """
         context = context or {}
         current_data = input_data
-        parent_uid = context.get('input_uid')
-        results: List[AnalysisResult] = []
+        parent_uid = context.get("input_uid")
+        results: list[AnalysisResult] = []
 
         start_time = time.time()
 
@@ -210,10 +209,10 @@ async def execute(
                             data=result.data,
                             data_type="analysis",
                             metadata={
-                                'step_name': result.step_name,
-                                'step_type': result.step_type.name,
-                                'pipeline': self.name,
-                                'step_index': i,
+                                "step_name": result.step_name,
+                                "step_type": result.step_type.name,
+                                "pipeline": self.name,
+                                "step_index": i,
                                 **result.metadata,
                             },
                             parent_uid=parent_uid,
@@ -228,7 +227,7 @@ async def execute(
                 # Pass result data to next step
                 current_data = result.data
 
-                logger.debug(f"Step {i+1}/{len(self.steps)}: {result}")
+                logger.debug(f"Step {i + 1}/{len(self.steps)}: {result}")
 
             except Exception as e:
                 logger.error(f"Pipeline step {step.name} failed: {e}")
@@ -238,7 +237,7 @@ async def execute(
                     parent_uid=parent_uid,
                     success=False,
                     error=str(e),
-                    metadata={'failed_at_step': i, 'pipeline': self.name},
+                    metadata={"failed_at_step": i, "pipeline": self.name},
                 )
 
         # Create final result
@@ -246,14 +245,14 @@ async def execute(
         final_result = AnalysisResult(
             step_name=self.name,
             step_type=StepType.CUSTOM,
-            parent_uid=context.get('input_uid'),
+            parent_uid=context.get("input_uid"),
             data=current_data,
             duration_ms=total_duration,
             success=True,
             metadata={
-                'pipeline': self.name,
-                'num_steps': len(self.steps),
-                'step_results': [r.to_dict() for r in results],
+                "pipeline": self.name,
+                "num_steps": len(self.steps),
+                "step_results": [r.to_dict() for r in results],
             },
         )
 
@@ -264,8 +263,8 @@ async def execute(
                     data=final_result.data,
                     data_type="analysis",
                     metadata={
-                        'pipeline': self.name,
-                        'final': True,
+                        "pipeline": self.name,
+                        "final": True,
                         **final_result.metadata,
                     },
                     parent_uid=parent_uid,
@@ -279,7 +278,7 @@ async def execute(
     async def __call__(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Allow calling pipeline directly"""
         return await self.execute(input_data, context)
@@ -305,28 +304,30 @@ class PipelineBuilder:
 
     def __init__(self, name: str = "pipeline"):
         self.name = name
-        self._steps: List[AnalysisStep] = []
+        self._steps: list[AnalysisStep] = []
         self._store_intermediate = False
         self._data_store = None
 
-    def add(self, step: AnalysisStep) -> 'PipelineBuilder':
+    def add(self, step: AnalysisStep) -> "PipelineBuilder":
         """Add a custom step"""
         self._steps.append(step)
         return self
 
-    def max_projection(self, axis: int = 0) -> 'PipelineBuilder':
+    def max_projection(self, axis: int = 0) -> "PipelineBuilder":
         """Add max projection step"""
         from .steps import MaxProjectionStep
+
         self._steps.append(MaxProjectionStep(axis=axis))
         return self
 
     def threshold(
         self,
         method: str = "otsu",
-        value: Optional[float] = None,
-    ) -> 'PipelineBuilder':
+        value: float | None = None,
+    ) -> "PipelineBuilder":
         """Add threshold step"""
         from .steps import ThresholdStep
+
         self._steps.append(ThresholdStep(method=method, value=value))
         return self
 
@@ -334,9 +335,10 @@ def morphology(
         self,
         operation: str = "open",
         kernel_size: int = 3,
-    ) -> 'PipelineBuilder':
+    ) -> "PipelineBuilder":
         """Add morphological operation step"""
         from .steps import MorphologyStep
+
         self._steps.append(MorphologyStep(operation=operation, kernel_size=kernel_size))
         return self
 
@@ -345,23 +347,27 @@ def blob_detection(
         min_sigma: float = 10,
         max_sigma: float = 50,
         threshold: float = 0.1,
-    ) -> 'PipelineBuilder':
+    ) -> "PipelineBuilder":
         """Add blob detection step"""
         from .steps import BlobDetectionStep
-        self._steps.append(BlobDetectionStep(
-            min_sigma=min_sigma,
-            max_sigma=max_sigma,
-            threshold=threshold,
-        ))
+
+        self._steps.append(
+            BlobDetectionStep(
+                min_sigma=min_sigma,
+                max_sigma=max_sigma,
+                threshold=threshold,
+            )
+        )
         return self
 
     def sam_segment(
         self,
-        prompt: Optional[str] = None,
-        points: Optional[List] = None,
-    ) -> 'PipelineBuilder':
+        prompt: str | None = None,
+        points: list | None = None,
+    ) -> "PipelineBuilder":
         """Add SAM segmentation step"""
         from .steps import SAMStep
+
         self._steps.append(SAMStep(prompt=prompt, points=points))
         return self
 
@@ -370,13 +376,14 @@ def vlm_analyze(
         prompt: str,
         model: str = settings.models.perception,
         max_tokens: int = 1024,
-    ) -> 'PipelineBuilder':
+    ) -> "PipelineBuilder":
         """Add VLM analysis step"""
         from .steps import VLMStep
+
         self._steps.append(VLMStep(prompt=prompt, model=model, max_tokens=max_tokens))
         return self
 
-    def store_intermediate(self, store=None) -> 'PipelineBuilder':
+    def store_intermediate(self, store=None) -> "PipelineBuilder":
         """Enable storing intermediate results"""
         self._store_intermediate = True
         self._data_store = store
@@ -398,6 +405,7 @@ def build(self) -> Pipeline:
 # Pre-built pipelines for common analysis tasks
 # =============================================================================
 
+
 def create_embryo_detection_pipeline(
     use_sam: bool = True,
     use_vlm_verification: bool = False,
@@ -434,7 +442,7 @@ def create_embryo_detection_pipeline(
     if use_vlm_verification:
         builder.vlm_analyze(
             prompt="Verify these are C. elegans embryos. "
-                   "Count the number of valid embryos and note any false positives."
+            "Count the number of valid embryos and note any false positives."
         )
 
     return builder.build()
diff --git a/gently/analysis/steps.py b/gently/analysis/steps.py
index 5ed10533..24577eb4 100644
--- a/gently/analysis/steps.py
+++ b/gently/analysis/steps.py
@@ -10,12 +10,12 @@
 import asyncio
 import logging
 import os
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 import numpy as np
 
 from ..settings import settings
-from .pipeline import AnalysisStep, AnalysisResult, StepType
+from .pipeline import AnalysisResult, AnalysisStep, StepType
 
 logger = logging.getLogger(__name__)
 
@@ -24,6 +24,7 @@
 # Image Processing Steps
 # =============================================================================
 
+
 class MaxProjectionStep(AnalysisStep):
     """
     Create max intensity projection along an axis
@@ -38,7 +39,7 @@ def __init__(self, axis: int = 0, name: str = "max_projection"):
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Execute max projection"""
         if not isinstance(input_data, np.ndarray):
@@ -56,7 +57,7 @@ async def execute(
                 step_type=self.step_type,
                 data=input_data,
                 success=True,
-                metadata={'already_2d': True},
+                metadata={"already_2d": True},
             )
 
         # Perform projection
@@ -68,9 +69,9 @@ async def execute(
             data=projection,
             success=True,
             metadata={
-                'input_shape': list(input_data.shape),
-                'output_shape': list(projection.shape),
-                'axis': self.axis,
+                "input_shape": list(input_data.shape),
+                "output_shape": list(projection.shape),
+                "axis": self.axis,
             },
         )
 
@@ -89,7 +90,7 @@ class ThresholdStep(AnalysisStep):
     def __init__(
         self,
         method: str = "otsu",
-        value: Optional[float] = None,
+        value: float | None = None,
         name: str = "threshold",
     ):
         super().__init__(name=name, step_type=StepType.THRESHOLD)
@@ -99,7 +100,7 @@ def __init__(
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Apply threshold"""
         if not isinstance(input_data, np.ndarray):
@@ -117,6 +118,7 @@ async def execute(
             # Otsu's method
             try:
                 from skimage.filters import threshold_otsu
+
                 threshold_value = threshold_otsu(image)
             except ImportError:
                 # Fallback to simple percentile
@@ -151,9 +153,9 @@ async def execute(
             data=binary.astype(np.uint8) * 255,
             success=True,
             metadata={
-                'method': self.method,
-                'threshold_value': float(threshold_value),
-                'pixels_above': int(np.sum(binary)),
+                "method": self.method,
+                "threshold_value": float(threshold_value),
+                "pixels_above": int(np.sum(binary)),
             },
         )
 
@@ -184,7 +186,7 @@ def __init__(
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Apply morphological operation"""
         if not isinstance(input_data, np.ndarray):
@@ -197,6 +199,7 @@ async def execute(
 
         try:
             import cv2
+
             kernel = np.ones((self.kernel_size, self.kernel_size), np.uint8)
 
             if self.operation == "erode":
@@ -219,25 +222,38 @@ async def execute(
             # Fallback without OpenCV using scipy
             try:
                 from scipy import ndimage
+
                 kernel = np.ones((self.kernel_size, self.kernel_size))
 
                 if self.operation in ("erode", "open"):
-                    result = ndimage.binary_erosion(
-                        input_data > 0, structure=kernel, iterations=self.iterations
-                    ).astype(np.uint8) * 255
+                    result = (
+                        ndimage.binary_erosion(
+                            input_data > 0, structure=kernel, iterations=self.iterations
+                        ).astype(np.uint8)
+                        * 255
+                    )
                     if self.operation == "open":
-                        result = ndimage.binary_dilation(
-                            result > 0, structure=kernel, iterations=self.iterations
-                        ).astype(np.uint8) * 255
+                        result = (
+                            ndimage.binary_dilation(
+                                result > 0, structure=kernel, iterations=self.iterations
+                            ).astype(np.uint8)
+                            * 255
+                        )
 
                 elif self.operation in ("dilate", "close"):
-                    result = ndimage.binary_dilation(
-                        input_data > 0, structure=kernel, iterations=self.iterations
-                    ).astype(np.uint8) * 255
+                    result = (
+                        ndimage.binary_dilation(
+                            input_data > 0, structure=kernel, iterations=self.iterations
+                        ).astype(np.uint8)
+                        * 255
+                    )
                     if self.operation == "close":
-                        result = ndimage.binary_erosion(
-                            result > 0, structure=kernel, iterations=self.iterations
-                        ).astype(np.uint8) * 255
+                        result = (
+                            ndimage.binary_erosion(
+                                result > 0, structure=kernel, iterations=self.iterations
+                            ).astype(np.uint8)
+                            * 255
+                        )
 
             except ImportError:
                 return AnalysisResult(
@@ -253,9 +269,9 @@ async def execute(
             data=result,
             success=True,
             metadata={
-                'operation': self.operation,
-                'kernel_size': self.kernel_size,
-                'iterations': self.iterations,
+                "operation": self.operation,
+                "kernel_size": self.kernel_size,
+                "iterations": self.iterations,
             },
         )
 
@@ -284,7 +300,7 @@ def __init__(
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Detect blobs"""
         if not isinstance(input_data, np.ndarray):
@@ -316,25 +332,27 @@ async def execute(
             detections = []
             for blob in blobs:
                 y, x, sigma = blob
-                detections.append({
-                    'x': float(x),
-                    'y': float(y),
-                    'radius': float(sigma * np.sqrt(2)),
-                })
+                detections.append(
+                    {
+                        "x": float(x),
+                        "y": float(y),
+                        "radius": float(sigma * np.sqrt(2)),
+                    }
+                )
 
             return AnalysisResult(
                 step_name=self.name,
                 step_type=self.step_type,
                 data={
-                    'detections': detections,
-                    'count': len(detections),
-                    'image': input_data,  # Keep original for next step
+                    "detections": detections,
+                    "count": len(detections),
+                    "image": input_data,  # Keep original for next step
                 },
                 success=True,
                 metadata={
-                    'num_blobs': len(detections),
-                    'min_sigma': self.min_sigma,
-                    'max_sigma': self.max_sigma,
+                    "num_blobs": len(detections),
+                    "min_sigma": self.min_sigma,
+                    "max_sigma": self.max_sigma,
                 },
             )
 
@@ -351,6 +369,7 @@ async def execute(
 # VLM (Vision Language Model) Step
 # =============================================================================
 
+
 class VLMStep(AnalysisStep):
     """
     Analyze image using Claude Vision API
@@ -364,7 +383,7 @@ def __init__(
         model: str = settings.models.perception,
         max_tokens: int = 1024,
         name: str = "vlm_analysis",
-        api_key: Optional[str] = None,
+        api_key: str | None = None,
     ):
         super().__init__(name=name, step_type=StepType.VLM)
         self.prompt = prompt
@@ -374,21 +393,22 @@ def __init__(
 
     def _encode_image(self, image: np.ndarray) -> str:
         """Encode image to base64 JPEG."""
-        from gently.core.imaging import normalize_to_uint8, image_to_base64
+        from gently.core.imaging import image_to_base64, normalize_to_uint8
+
         img = normalize_to_uint8(image, method="minmax")
         return image_to_base64(img, format="JPEG", quality=85)
 
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Analyze with Claude Vision"""
         context = context or {}
 
         # Get image from input (handle dict from previous step)
         if isinstance(input_data, dict):
-            image = input_data.get('image', input_data.get('data'))
+            image = input_data.get("image", input_data.get("data"))
         else:
             image = input_data
 
@@ -404,7 +424,7 @@ async def execute(
             import anthropic
 
             # Get API key
-            api_key = self.api_key or context.get('api_key') or os.getenv("ANTHROPIC_API_KEY")
+            api_key = self.api_key or context.get("api_key") or os.getenv("ANTHROPIC_API_KEY")
             if not api_key:
                 return AnalysisResult(
                     step_name=self.name,
@@ -424,12 +444,12 @@ async def execute(
                         "type": "base64",
                         "media_type": "image/jpeg",
                         "data": b64_image,
-                    }
+                    },
                 },
                 {
                     "type": "text",
                     "text": self.prompt,
-                }
+                },
             ]
 
             # Call Claude
@@ -438,7 +458,7 @@ async def execute(
                 client.messages.create,
                 model=self.model,
                 max_tokens=self.max_tokens,
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             result_text = response.content[0].text
@@ -447,15 +467,15 @@ async def execute(
                 step_name=self.name,
                 step_type=self.step_type,
                 data={
-                    'analysis': result_text,
-                    'image': image,  # Pass through for next step
+                    "analysis": result_text,
+                    "image": image,  # Pass through for next step
                 },
                 success=True,
                 metadata={
-                    'model': self.model,
-                    'prompt': self.prompt[:100] + "..." if len(self.prompt) > 100 else self.prompt,
-                    'input_tokens': response.usage.input_tokens,
-                    'output_tokens': response.usage.output_tokens,
+                    "model": self.model,
+                    "prompt": self.prompt[:100] + "..." if len(self.prompt) > 100 else self.prompt,
+                    "input_tokens": response.usage.input_tokens,
+                    "output_tokens": response.usage.output_tokens,
                 },
             )
 
@@ -473,6 +493,7 @@ async def execute(
 # SAM (Segment Anything Model) Step
 # =============================================================================
 
+
 class SAMStep(AnalysisStep):
     """
     Segment image using SAM (Segment Anything Model)
@@ -485,9 +506,9 @@ class SAMStep(AnalysisStep):
 
     def __init__(
         self,
-        prompt: Optional[str] = None,
-        points: Optional[List[Tuple[int, int]]] = None,
-        model_path: Optional[str] = None,
+        prompt: str | None = None,
+        points: list[tuple[int, int]] | None = None,
+        model_path: str | None = None,
         min_area: int = 1000,
         name: str = "sam_segmentation",
     ):
@@ -505,8 +526,12 @@ def _load_sam(self):
             return
 
         try:
-            from segment_anything import sam_model_registry, SamPredictor, SamAutomaticMaskGenerator
             import torch
+            from segment_anything import (
+                SamAutomaticMaskGenerator,
+                SamPredictor,
+                sam_model_registry,
+            )
 
             device = "cuda" if torch.cuda.is_available() else "cpu"
 
@@ -528,12 +553,12 @@ def _load_sam(self):
     async def execute(
         self,
         input_data: Any,
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> AnalysisResult:
         """Run SAM segmentation"""
         # Get image from input
         if isinstance(input_data, dict):
-            image = input_data.get('image', input_data.get('data'))
+            image = input_data.get("image", input_data.get("data"))
         else:
             image = input_data
 
@@ -565,28 +590,29 @@ async def execute(
                 if image_rgb.max() <= 1.0:
                     image_rgb = (image_rgb * 255).astype(np.uint8)
                 else:
-                    image_rgb = ((image_rgb - image_rgb.min()) /
-                                 (image_rgb.max() - image_rgb.min()) * 255).astype(np.uint8)
+                    image_rgb = (
+                        (image_rgb - image_rgb.min()) / (image_rgb.max() - image_rgb.min()) * 255
+                    ).astype(np.uint8)
 
             # Run in thread (SAM is CPU/GPU intensive)
             masks = await asyncio.to_thread(self._run_sam, image_rgb)
 
             # Filter by area
-            filtered_masks = [m for m in masks if m['area'] >= self.min_area]
+            filtered_masks = [m for m in masks if m["area"] >= self.min_area]
 
             return AnalysisResult(
                 step_name=self.name,
                 step_type=self.step_type,
                 data={
-                    'masks': filtered_masks,
-                    'count': len(filtered_masks),
-                    'image': image,
+                    "masks": filtered_masks,
+                    "count": len(filtered_masks),
+                    "image": image,
                 },
                 success=True,
                 metadata={
-                    'total_masks': len(masks),
-                    'filtered_masks': len(filtered_masks),
-                    'min_area': self.min_area,
+                    "total_masks": len(masks),
+                    "filtered_masks": len(filtered_masks),
+                    "min_area": self.min_area,
                 },
             )
 
@@ -599,7 +625,7 @@ async def execute(
                 error=str(e),
             )
 
-    def _run_sam(self, image_rgb: np.ndarray) -> List[Dict]:
+    def _run_sam(self, image_rgb: np.ndarray) -> list[dict]:
         """Run SAM (blocking, called in thread)"""
         if self.points:
             # Point-prompted segmentation
@@ -615,9 +641,9 @@ def _run_sam(self, image_rgb: np.ndarray) -> List[Dict]:
 
             return [
                 {
-                    'segmentation': masks[i],
-                    'area': int(np.sum(masks[i])),
-                    'score': float(scores[i]),
+                    "segmentation": masks[i],
+                    "area": int(np.sum(masks[i])),
+                    "score": float(scores[i]),
                 }
                 for i in range(len(masks))
             ]
@@ -643,25 +669,27 @@ async def _fallback_segment(self, image: np.ndarray) -> AnalysisResult:
             for region in regions:
                 if region.area >= self.min_area:
                     mask = labeled == region.label
-                    masks.append({
-                        'segmentation': mask,
-                        'area': region.area,
-                        'centroid': region.centroid,
-                        'bbox': region.bbox,
-                    })
+                    masks.append(
+                        {
+                            "segmentation": mask,
+                            "area": region.area,
+                            "centroid": region.centroid,
+                            "bbox": region.bbox,
+                        }
+                    )
 
             return AnalysisResult(
                 step_name=self.name,
                 step_type=self.step_type,
                 data={
-                    'masks': masks,
-                    'count': len(masks),
-                    'image': image,
+                    "masks": masks,
+                    "count": len(masks),
+                    "image": image,
                 },
                 success=True,
                 metadata={
-                    'method': 'fallback_threshold',
-                    'num_masks': len(masks),
+                    "method": "fallback_threshold",
+                    "num_masks": len(masks),
                 },
             )
 
diff --git a/gently/app/agent.py b/gently/app/agent.py
index 16ae51c3..5122e80f 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -14,38 +14,41 @@
 import asyncio
 import logging
 import os
-from typing import Dict, List, Optional, Callable, Any, TYPE_CHECKING
+from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
+from typing import TYPE_CHECKING, Any
 
 import anthropic
 import numpy as np
 
-from ..exceptions import StorageError, AgentError
+from ..exceptions import StorageError
 from ..settings import settings
 
 if TYPE_CHECKING:
     from ..ui.web.server import VisualizationServer
+from gently_perception import Perceiver
 
-logger = logging.getLogger(__name__)
-
-from ..harness.state import ExperimentState, EmbryoState, ImageRecord
-from ..harness.orchestration.plan_synthesis import PlanSynthesizer, PlanLibrary, PlanValidator
+from ..core import EventType, emit, get_event_bus
+from ..core.file_store import FileStore
+from ..harness.conversation import ConversationManager
+from ..harness.orchestration.plan_synthesis import (
+    PlanLibrary,
+    PlanSynthesizer,
+    PlanValidator,
+)
+from ..harness.prompts.manager import PromptManager
+from ..harness.session.interaction_logger import InteractionLogger
+from ..harness.session.manager import SessionManager
+from ..harness.session.timeline import TimelineManager
+from ..harness.state import ExperimentState
 from ..harness.tools.registry import get_tool_registry
-from gently_perception import Perceiver
 
 # Import tools package to trigger @tool decorator registration
 from . import tools as _tools  # noqa: F401
-from ..harness.session.interaction_logger import InteractionLogger
 from .orchestration.timelapse import TimelapseOrchestrator
-from ..harness.session.timeline import TimelineManager
-from ..core import EventType, get_event_bus, emit
-from ..core.file_store import FileStore
-
-from ..harness.conversation import ConversationManager
-from ..harness.session.manager import SessionManager
-from ..harness.prompts.manager import PromptManager
 
+logger = logging.getLogger(__name__)
 
 # Shown when the agent is launched in UI-only mode (--no-api). The web UI is
 # fully browsable, but anything that would call Claude is disabled.
@@ -71,11 +74,11 @@ class MicroscopyAgent:
 
     def __init__(
         self,
-        api_key: Optional[str] = None,
+        api_key: str | None = None,
         storage_path: Path = Path("./experiment_data"),
         model: str = settings.models.main,
         microscope_client=None,
-        session_id: Optional[str] = None,
+        session_id: str | None = None,
         store: FileStore = None,
         no_api: bool = False,
     ):
@@ -111,8 +114,10 @@ def __init__(
 
         # API client with interleaved thinking support
         self.claude = anthropic.Anthropic(
-            api_key=api_key or os.getenv("ANTHROPIC_API_KEY") or ("no-api-mode" if no_api else None),
-            default_headers={"anthropic-beta": "interleaved-thinking-2025-05-14"}
+            api_key=api_key
+            or os.getenv("ANTHROPIC_API_KEY")
+            or ("no-api-mode" if no_api else None),
+            default_headers={"anthropic-beta": "interleaved-thinking-2025-05-14"},
         )
         self.model = model
 
@@ -124,7 +129,7 @@ def __init__(
         self.mode: str = "run"
 
         # Context store (agent's mind — set via set_context_store)
-        self.context_store: Optional[Any] = None
+        self.context_store: Any | None = None
 
         # Experiment state
         self.experiment = ExperimentState()
@@ -140,8 +145,7 @@ def __init__(
 
         # Plan synthesis
         self.plan_synthesizer = PlanSynthesizer(
-            plan_library=PlanLibrary(),
-            validator=PlanValidator()
+            plan_library=PlanLibrary(), validator=PlanValidator()
         )
 
         # Event bus for async messaging (must be before perception manager)
@@ -162,8 +166,8 @@ def __init__(
         self.client = self.microscope
 
         # Callbacks
-        self.on_message_callback: Optional[Callable] = None
-        self.choice_handler: Optional[Callable] = None
+        self.on_message_callback: Callable | None = None
+        self.choice_handler: Callable | None = None
 
         # Serializes conversation turns: user turns and autonomous wake turns
         # must not interleave on the shared conversation_history.
@@ -174,14 +178,18 @@ def __init__(
         # human). User turns are unaffected. _wake_choice_factory is set by the
         # web bridge so ASK-mode wake turns can round-trip an approval picker.
         self._autonomous_active = False
-        self._autonomous_blocked_tools = frozenset({
-            "set_laser_power", "remove_embryo", "stop_timelapse",
-        })
+        self._autonomous_blocked_tools = frozenset(
+            {
+                "set_laser_power",
+                "remove_embryo",
+                "stop_timelapse",
+            }
+        )
         self._wake_choice_factory = None
         self._wake_choice_discard = None
 
         # Interaction logger for structured logging (research data collection)
-        self.interaction_logger: Optional[InteractionLogger] = None
+        self.interaction_logger: InteractionLogger | None = None
 
         # Event capture — durable log of every EventBus event during this
         # session. Substrate for offline replay / shadow-mode A/B of
@@ -194,13 +202,13 @@ def __init__(
         self.decision_log = None
 
         # Timelapse orchestrator (initialized when microscope connected)
-        self.timelapse_orchestrator: Optional[TimelapseOrchestrator] = None
+        self.timelapse_orchestrator: TimelapseOrchestrator | None = None
 
         # Timeline manager for tracking events
-        self.timeline_manager: Optional[TimelineManager] = None
+        self.timeline_manager: TimelineManager | None = None
 
         # Visualization server for real-time feedback
-        self.viz_server: Optional["VisualizationServer"] = None
+        self.viz_server: VisualizationServer | None = None
 
         # Device-state monitor (bridges device-layer SSE → EventBus)
         self.device_state_monitor = None
@@ -218,10 +226,10 @@ def __init__(
         )
         # Wire tool execution context
         self.conversation._tool_context = {
-            'agent': self,
-            'client': getattr(self, 'microscope', None),
-            'microscope': getattr(self, 'microscope', None),
-            'databroker': getattr(self, 'databroker', None),
+            "agent": self,
+            "client": getattr(self, "microscope", None),
+            "microscope": getattr(self, "microscope", None),
+            "databroker": getattr(self, "databroker", None),
         }
 
         # Session manager (persistence)
@@ -241,16 +249,22 @@ def __init__(
             success, history = self.sessions._resume_session(session_id, self.experiment)
             if success:
                 self.conversation.conversation_history = history
-            self._emit_event(EventType.SESSION_RESTORED, {
-                'session_id': session_id,
-                'embryo_count': len(self.experiment.embryos),
-                'message_count': len(self.conversation.conversation_history),
-            })
+            self._emit_event(
+                EventType.SESSION_RESTORED,
+                {
+                    "session_id": session_id,
+                    "embryo_count": len(self.experiment.embryos),
+                    "message_count": len(self.conversation.conversation_history),
+                },
+            )
         else:
             self.sessions.create_session()
-            self._emit_event(EventType.SESSION_STARTED, {
-                'session_id': self.sessions.session_id,
-            })
+            self._emit_event(
+                EventType.SESSION_STARTED,
+                {
+                    "session_id": self.sessions.session_id,
+                },
+            )
 
         # Initialize interaction logger (for research data collection)
         self._init_interaction_logger()
@@ -283,6 +297,7 @@ def __init__(
         # autonomously; enabled via the set_autonomy tool.
         try:
             from gently.app.wake_router import WakeRouter
+
             self.wake_router = WakeRouter(self, self._event_bus)
         except Exception:
             logger.exception("Failed to init wake-router")
@@ -299,7 +314,7 @@ def session_id(self) -> str:
         return self.sessions.session_id
 
     @property
-    def _session_id(self) -> Optional[str]:
+    def _session_id(self) -> str | None:
         """Internal session ID (backward compat)."""
         return self.sessions._session_id
 
@@ -308,7 +323,7 @@ def _session_id(self, value):
         self.sessions._session_id = value
 
     @property
-    def conversation_history(self) -> List[Dict]:
+    def conversation_history(self) -> list[dict]:
         """Get conversation history."""
         return self.conversation.conversation_history
 
@@ -353,6 +368,7 @@ def set_context_store(self, context_store) -> None:
         self.prompts.context_store = context_store
         # Create agent memory harness
         from ..harness.memory.interface import AgentMemory
+
         self.memory = AgentMemory(context_store, session_id=self.session_id)
         self.prompts.memory = self.memory
 
@@ -362,8 +378,13 @@ def enter_plan_mode(self) -> str:
             return "Already in plan mode."
         self.mode = "plan"
         import gently.harness.plan_mode.tools  # noqa: F401
+
         self._update_system_prompt()
-        emit(EventType.STATUS_CHANGED, {"field": "agent_mode", "value": "plan"}, source="agent")
+        emit(
+            EventType.STATUS_CHANGED,
+            {"field": "agent_mode", "value": "plan"},
+            source="agent",
+        )
         logger.info("Entered plan mode")
         return "Switched to plan mode. I'm now your experimental design collaborator."
 
@@ -441,7 +462,8 @@ def exit_plan_mode(self) -> str:
                 if item and self.session_id and self.context_store:
                     try:
                         self.context_store.link_session_campaign(
-                            self.session_id, item.campaign_id,
+                            self.session_id,
+                            item.campaign_id,
                         )
                     except Exception:
                         pass
@@ -458,7 +480,11 @@ def exit_plan_mode(self) -> str:
             self.prompts.invalidate_context_cache()
 
         self._update_system_prompt()
-        emit(EventType.STATUS_CHANGED, {"field": "agent_mode", "value": "run"}, source="agent")
+        emit(
+            EventType.STATUS_CHANGED,
+            {"field": "agent_mode", "value": "run"},
+            source="agent",
+        )
         logger.info("Exited plan mode")
         return result
 
@@ -467,11 +493,14 @@ def exit_plan_mode(self) -> str:
     def _update_system_prompt(self, context_summary: str = None):
         """Rebuild system prompt via PromptManager."""
         self.system_prompt = self.prompts.update_system_prompt(
-            self.experiment, self.client, self.mode, context_summary,
+            self.experiment,
+            self.client,
+            self.mode,
+            context_summary,
             perceiver=getattr(self, "perceiver", None),
         )
 
-    def _get_active_plan_summary(self) -> Optional[str]:
+    def _get_active_plan_summary(self) -> str | None:
         """Delegation shim for agent bridge access."""
         return self.prompts.get_active_plan_summary()
 
@@ -501,7 +530,7 @@ def _auto_save(self):
             self.experiment, self.conversation.conversation_history, self.system_prompt
         )
 
-    def list_sessions(self) -> List[Dict]:
+    def list_sessions(self) -> list[dict]:
         """List available sessions."""
         return self.sessions.list_sessions()
 
@@ -534,6 +563,7 @@ def _init_event_capture(self):
         a stripped-down agent) — replay just won't have a log to read.
         """
         from gently.eval import EventCapture
+
         try:
             session_dir = None
             sid = self.session_id
@@ -541,7 +571,8 @@ def _init_event_capture(self):
                 session_dir = self.store._session_dir(sid)
             if session_dir is None:
                 logging.getLogger(__name__).debug(
-                    "EventCapture: no session dir for %s — skipping", sid)
+                    "EventCapture: no session dir for %s — skipping", sid
+                )
                 return
             path = session_dir / "events.jsonl"
             self.event_capture = EventCapture(path)
@@ -568,6 +599,7 @@ def _init_decision_log(self):
         logs and the two are diffed offline.
         """
         from gently.eval import DecisionLog
+
         try:
             session_dir = None
             sid = self.session_id
@@ -575,7 +607,8 @@ def _init_decision_log(self):
                 session_dir = self.store._session_dir(sid)
             if session_dir is None:
                 logging.getLogger(__name__).debug(
-                    "DecisionLog: no session dir for %s — skipping", sid)
+                    "DecisionLog: no session dir for %s — skipping", sid
+                )
                 return
             path = session_dir / "decisions.jsonl"
             self.decision_log = DecisionLog(path)
@@ -673,12 +706,15 @@ def on_stage_detected(event):
                     embryo_id = data.get("embryo_id")
                     if embryo_id and embryo_id in self.experiment.embryos:
                         embryo = self.experiment.embryos[embryo_id]
-                        embryo.add_cv_result("stage_classification", {
-                            "stage": data.get("stage"),
-                            "confidence": data.get("confidence"),
-                            "nuclei_count": data.get("nuclei_count"),
-                            "timepoint": data.get("timepoint"),
-                        })
+                        embryo.add_cv_result(
+                            "stage_classification",
+                            {
+                                "stage": data.get("stage"),
+                                "confidence": data.get("confidence"),
+                                "nuclei_count": data.get("nuclei_count"),
+                                "timepoint": data.get("timepoint"),
+                            },
+                        )
                 except Exception as e:
                     logger.warning(f"Error handling stage detected event: {e}")
 
@@ -701,23 +737,34 @@ def on_perception(event):
                     stage = data.get("stage")
                     # 'no_object' is an empty-field sentinel, not a developmental
                     # stage — don't mirror it into latest_developmental_stage.
-                    if (not stage or stage == "no_object" or not embryo_id
-                            or embryo_id not in self.experiment.embryos):
+                    if (
+                        not stage
+                        or stage == "no_object"
+                        or not embryo_id
+                        or embryo_id not in self.experiment.embryos
+                    ):
                         return
                     embryo = self.experiment.embryos[embryo_id]
                     if stage == getattr(embryo, "latest_developmental_stage", None):
                         return  # steady state — nothing new to mirror
-                    embryo.add_cv_result("stage_classification", {
-                        "stage": stage,
-                        "timepoint": data.get("timepoint"),
-                        "stability": data.get("stability"),
-                        "temporal_analysis": data.get("temporal_analysis"),
-                        "detector_name": "perception",
-                    })
+                    embryo.add_cv_result(
+                        "stage_classification",
+                        {
+                            "stage": stage,
+                            "timepoint": data.get("timepoint"),
+                            "stability": data.get("stability"),
+                            "temporal_analysis": data.get("temporal_analysis"),
+                            "detector_name": "perception",
+                        },
+                    )
                     self.invalidate_context_cache()
                     self._auto_save()
-                    logger.info("Perception: %s -> stage %s (t%s)",
-                                embryo_id, stage, data.get("timepoint"))
+                    logger.info(
+                        "Perception: %s -> stage %s (t%s)",
+                        embryo_id,
+                        stage,
+                        data.get("timepoint"),
+                    )
                 except Exception as e:
                     logger.warning(f"Error handling perception event: {e}")
 
@@ -732,7 +779,9 @@ def on_perception(event):
 
     # ===== Visualization Server Methods =====
 
-    async def start_viz_server(self, port: int = settings.network.viz_port, ssl_certfile=None, ssl_keyfile=None):
+    async def start_viz_server(
+        self, port: int = settings.network.viz_port, ssl_certfile=None, ssl_keyfile=None
+    ):
         """Start the visualization server for real-time feedback."""
         if self.viz_server is not None:
             logger.info("Visualization server already running")
@@ -782,6 +831,7 @@ async def start_viz_server(self, port: int = settings.network.viz_port, ssl_cert
         if self.microscope is not None and self.device_state_monitor is None:
             try:
                 from .device_state_monitor import DeviceStateMonitor
+
                 self.device_state_monitor = DeviceStateMonitor(self.microscope)
                 await self.device_state_monitor.start()
                 logger.info("Device-state monitor started")
@@ -795,6 +845,7 @@ async def start_viz_server(self, port: int = settings.network.viz_port, ssl_cert
         if self.microscope is not None and self.bottom_camera_monitor is None:
             try:
                 from .bottom_camera_monitor import BottomCameraStreamMonitor
+
                 self.bottom_camera_monitor = BottomCameraStreamMonitor(self.microscope)
                 logger.info("Bottom-camera monitor ready (not started)")
             except Exception as e:
@@ -825,16 +876,14 @@ def push_viz(
         array: np.ndarray,
         uid: str,
         data_type: str = "image",
-        metadata: Optional[Dict[str, Any]] = None,
+        metadata: dict[str, Any] | None = None,
     ):
         """Non-blocking push of image to visualization server."""
         if self.viz_server is None:
             return
 
         try:
-            asyncio.create_task(
-                self.viz_server.push_image(array, uid, data_type, metadata or {})
-            )
+            asyncio.create_task(self.viz_server.push_image(array, uid, data_type, metadata or {}))
         except RuntimeError:
             pass
         except Exception as e:
@@ -853,7 +902,7 @@ def _has_microscope(self) -> bool:
         """
         return self.client is not None
 
-    def _emit_event(self, event_type: EventType, data: Optional[Dict] = None):
+    def _emit_event(self, event_type: EventType, data: dict | None = None):
         """Emit an event to the event bus."""
         self._event_bus.publish(
             event_type=event_type,
@@ -894,10 +943,13 @@ def _publish_embryos_update(self) -> None:
     def _mark_significant_action(self, action_type: str):
         """Mark that a significant action occurred (triggers auto-save)."""
         self._auto_save()
-        self._emit_event(EventType.SESSION_SAVED, {
-            'session_id': self.sessions._session_id,
-            'action_type': action_type,
-        })
+        self._emit_event(
+            EventType.SESSION_SAVED,
+            {
+                "session_id": self.sessions._session_id,
+                "action_type": action_type,
+            },
+        )
 
     # ===== Public Message API =====
 
@@ -916,8 +968,11 @@ async def handle_message(self, user_message: str) -> str:
             Response from agent
         """
         if quick_response := self.conversation.try_quick_response(
-            user_message, self.experiment, self.mode,
-            self.enter_plan_mode, self.exit_plan_mode,
+            user_message,
+            self.experiment,
+            self.mode,
+            self.enter_plan_mode,
+            self.exit_plan_mode,
         ):
             return quick_response
 
@@ -931,10 +986,7 @@ async def handle_message(self, user_message: str) -> str:
         self._update_system_prompt(context_summary)
 
         # Add user message to history
-        self.conversation.conversation_history.append({
-            "role": "user",
-            "content": user_message
-        })
+        self.conversation.conversation_history.append({"role": "user", "content": user_message})
 
         tools = self._get_tools_for_mode()
         cached_prompt = self._get_cached_system_prompt()
@@ -961,14 +1013,17 @@ async def handle_message_stream(self, user_message: str):
             Chunks with 'type' and data
         """
         if quick_response := self.conversation.try_quick_response(
-            user_message, self.experiment, self.mode,
-            self.enter_plan_mode, self.exit_plan_mode,
+            user_message,
+            self.experiment,
+            self.mode,
+            self.enter_plan_mode,
+            self.exit_plan_mode,
         ):
-            yield {'type': 'text', 'text': quick_response}
+            yield {"type": "text", "text": quick_response}
             return
 
         if not self.api_enabled:
-            yield {'type': 'text', 'text': _NO_API_NOTICE}
+            yield {"type": "text", "text": _NO_API_NOTICE}
             return
 
         # Hold the turn-lock for the whole streamed turn so an autonomous wake
@@ -984,16 +1039,14 @@ async def handle_message_stream(self, user_message: str):
             )
             self._update_system_prompt(context_summary)
 
-            self.conversation.conversation_history.append({
-                "role": "user",
-                "content": user_message
-            })
+            self.conversation.conversation_history.append({"role": "user", "content": user_message})
 
             tools = self._get_tools_for_mode()
             cached_prompt = self._get_cached_system_prompt()
 
             inner_gen = self.conversation.call_claude_stream(
-                cached_prompt, tools,
+                cached_prompt,
+                tools,
                 tool_label_fn=self.conversation.tool_label,
                 auto_save_fn=self._auto_save,
             )
@@ -1086,8 +1139,11 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
         choice_data = chunk.get("choice_data", {}) if isinstance(chunk, dict) else {}
         factory = getattr(self, "_wake_choice_factory", None)
         if not interactive or factory is None:
-            logger.info("Wake picker auto-cancelled (interactive=%s, channel=%s)",
-                        interactive, factory is not None)
+            logger.info(
+                "Wake picker auto-cancelled (interactive=%s, channel=%s)",
+                interactive,
+                factory is not None,
+            )
             return "cancelled"
         try:
             future = factory(choice_data)  # registers future + sets request_id
@@ -1097,6 +1153,7 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
         request_id = choice_data.get("request_id", "")
         await emit({**chunk, "origin": "wake", "request_id": request_id})
         from gently.app.wake_router import ASK_TIMEOUT_SEC
+
         try:
             selected = await asyncio.wait_for(future, timeout=ASK_TIMEOUT_SEC)
         except asyncio.TimeoutError:
@@ -1119,7 +1176,7 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
                     pass
         return selected or "skip"
 
-    async def get_tool_call(self, user_message: str) -> Optional[Dict]:
+    async def get_tool_call(self, user_message: str) -> dict | None:
         """Dry-run tool call (for benchmarking)."""
         context_summary = await self.prompts.get_cached_context_summary(
             self.experiment, self.timelapse_orchestrator, self.timeline_manager
@@ -1131,25 +1188,25 @@ async def get_tool_call(self, user_message: str) -> Optional[Dict]:
 
     # === Experiment Management Methods ===
 
-    def load_embryos_from_database(self, database: Dict):
+    def load_embryos_from_database(self, database: dict):
         """Load embryos from calibration database."""
-        if 'embryos' not in database:
+        if "embryos" not in database:
             return
 
-        for embryo_id, embryo_data in database['embryos'].items():
-            position = embryo_data.get('stage_position_after_centering_um', {})
-            calibration = embryo_data.get('calibration', {})
+        for embryo_id, embryo_data in database["embryos"].items():
+            position = embryo_data.get("stage_position_after_centering_um", {})
+            calibration = embryo_data.get("calibration", {})
 
             self.experiment.add_embryo(
                 embryo_id=embryo_id,
                 position=position,
                 calibration=calibration,
-                uid=embryo_data.get('uid'),
+                uid=embryo_data.get("uid"),
             )
 
         self._update_system_prompt()
 
-    def import_embryos_from_session(self, session_id: str, clear_existing: bool = False) -> Dict:
+    def import_embryos_from_session(self, session_id: str, clear_existing: bool = False) -> dict:
         """
         Import embryos from another session into the current experiment.
 
@@ -1205,14 +1262,14 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         if not embryo_states:
             session_data = self.store.load_session_snapshot(session_id)
             if session_data:
-                embryo_states = session_data.get('embryo_states', {})
+                embryo_states = session_data.get("embryo_states", {})
 
         if not embryo_states:
             return {
-                'success': False,
-                'error': "No embryos found in session",
-                'imported': [],
-                'skipped': [],
+                "success": False,
+                "error": "No embryos found in session",
+                "imported": [],
+                "skipped": [],
             }
 
         if clear_existing:
@@ -1232,30 +1289,30 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 # Prefer explicit coarse/fine when the snapshot has them
                 # (FileStore path); fall back to flat stage_position for the
                 # legacy JSON-snapshot path which only carries the resolved view.
-                position_coarse = embryo_data.get('position_coarse')
-                position_fine = embryo_data.get('position_fine')
+                position_coarse = embryo_data.get("position_coarse")
+                position_fine = embryo_data.get("position_fine")
                 if position_coarse is None and position_fine is None:
-                    position_coarse = embryo_data.get('stage_position', {})
-                calibration = embryo_data.get('calibration', {})
-                source_uid = embryo_data.get('uid') or f"{session_id}_{embryo_id}"
+                    position_coarse = embryo_data.get("stage_position", {})
+                calibration = embryo_data.get("calibration", {})
+                source_uid = embryo_data.get("uid") or f"{session_id}_{embryo_id}"
 
                 self.experiment.add_embryo(
                     embryo_id=embryo_id,
                     position=position_coarse or {},
                     position_fine=position_fine or {},
                     calibration=calibration,
-                    user_label=embryo_data.get('user_label'),
+                    user_label=embryo_data.get("user_label"),
                     uid=source_uid,
-                    role=embryo_data.get('role') or 'unassigned',
+                    role=embryo_data.get("role") or "unassigned",
                 )
 
                 embryo = self.experiment.embryos[embryo_id]
-                embryo.nickname = embryo_data.get('nickname')
-                embryo.interval_seconds = embryo_data.get('interval_seconds')
-                embryo.num_slices = embryo_data.get('num_slices', 50)
-                embryo.exposure_ms = embryo_data.get('exposure_ms', 10.0)
-                embryo.priority = embryo_data.get('priority', 'normal')
-                embryo.acquisition_mode = embryo_data.get('acquisition_mode', 'volume')
+                embryo.nickname = embryo_data.get("nickname")
+                embryo.interval_seconds = embryo_data.get("interval_seconds")
+                embryo.num_slices = embryo_data.get("num_slices", 50)
+                embryo.exposure_ms = embryo_data.get("exposure_ms", 10.0)
+                embryo.priority = embryo_data.get("priority", "normal")
+                embryo.acquisition_mode = embryo_data.get("acquisition_mode", "volume")
 
                 # Light budget import. Prefer fields already on embryo_data
                 # (future schema may persist these directly on embryo.yaml);
@@ -1266,27 +1323,22 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 # removed and the import should fail loudly if dose is
                 # missing.
                 dose = self._compute_imported_dose(session_id, embryo_id)
-                embryo.exposure_count = (
-                    embryo_data.get('exposure_count')
-                    or dose['exposure_count']
-                )
+                embryo.exposure_count = embryo_data.get("exposure_count") or dose["exposure_count"]
                 embryo.total_exposure_ms = (
-                    embryo_data.get('total_exposure_ms')
-                    or dose['total_exposure_ms']
+                    embryo_data.get("total_exposure_ms") or dose["total_exposure_ms"]
                 )
                 embryo.timepoints_acquired = (
-                    embryo_data.get('timepoints_acquired')
-                    or dose['exposure_count']
+                    embryo_data.get("timepoints_acquired") or dose["exposure_count"]
                 )
 
-                last_imaged_str = embryo_data.get('last_imaged')
+                last_imaged_str = embryo_data.get("last_imaged")
                 if last_imaged_str:
                     try:
                         embryo.last_imaged = datetime.fromisoformat(last_imaged_str)
                     except (ValueError, TypeError):
-                        embryo.last_imaged = dose['last_imaged']
+                        embryo.last_imaged = dose["last_imaged"]
                 else:
-                    embryo.last_imaged = dose['last_imaged']
+                    embryo.last_imaged = dose["last_imaged"]
 
                 imported.append(embryo_id)
 
@@ -1297,14 +1349,14 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         self._mark_significant_action("embryo_import")
 
         return {
-            'success': len(imported) > 0,
-            'imported': imported,
-            'skipped': skipped,
-            'errors': errors,
-            'source_session': session_id,
+            "success": len(imported) > 0,
+            "imported": imported,
+            "skipped": skipped,
+            "errors": errors,
+            "source_session": session_id,
         }
 
-    def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> Dict:
+    def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> dict:
         """Reconstruct an embryo's realized 488 nm photodose from the source
         session's per-volume meta files.
 
@@ -1319,66 +1371,68 @@ def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> Dict
         TODO: replace with reading a persisted ``dose:`` block from
         embryo.yaml once dose-tracking is first-class.
         """
-        import yaml
         from datetime import datetime
         from pathlib import Path
 
+        import yaml
+
         result = {
-            'exposure_count': 0,
-            'total_exposure_ms': 0.0,
-            'last_imaged': None,
+            "exposure_count": 0,
+            "total_exposure_ms": 0.0,
+            "last_imaged": None,
         }
 
         if not self.store:
             return result
 
         # FileStore exposes _session_dir(session_id) → resolved Path.
-        session_dir_fn = getattr(self.store, '_session_dir', None)
+        session_dir_fn = getattr(self.store, "_session_dir", None)
         sd = session_dir_fn(source_session_id) if callable(session_dir_fn) else None
         if sd is None:
             return result
 
-        vols_dir = Path(sd) / 'embryos' / embryo_id / 'volumes'
+        vols_dir = Path(sd) / "embryos" / embryo_id / "volumes"
         if not vols_dir.is_dir():
             return result
 
         latest = None
-        for meta_path in sorted(vols_dir.glob('*.meta.yaml')):
+        for meta_path in sorted(vols_dir.glob("*.meta.yaml")):
             try:
                 doc = yaml.safe_load(meta_path.read_text()) or {}
             except Exception:
                 continue
-            md = doc.get('metadata') or {}
-            num_slices = md.get('num_slices')
+            md = doc.get("metadata") or {}
+            num_slices = md.get("num_slices")
             if num_slices is None:
-                shape = doc.get('shape') or []
+                shape = doc.get("shape") or []
                 num_slices = shape[0] if shape else 0
-            exposure_ms = md.get('exposure_ms') or 0.0
+            exposure_ms = md.get("exposure_ms") or 0.0
             try:
-                result['total_exposure_ms'] += float(num_slices) * float(exposure_ms)
+                result["total_exposure_ms"] += float(num_slices) * float(exposure_ms)
             except (TypeError, ValueError):
                 pass
-            result['exposure_count'] += 1
-            acq = doc.get('acquired_at')
+            result["exposure_count"] += 1
+            acq = doc.get("acquired_at")
             if acq and (latest is None or acq > latest):
                 latest = acq
 
         if latest:
             try:
-                result['last_imaged'] = datetime.fromisoformat(latest)
+                result["last_imaged"] = datetime.fromisoformat(latest)
             except (ValueError, TypeError):
                 pass
 
         return result
 
-    async def on_volume_acquired(self, embryo_id: str, timepoint: int,
-                                volume_data, volume_path=None):
+    async def on_volume_acquired(
+        self, embryo_id: str, timepoint: int, volume_data, volume_path=None
+    ):
         """Callback when a volume is acquired."""
         embryo = self.experiment.embryos.get(embryo_id)
         if not embryo:
             return
 
-        if hasattr(volume_data, 'read_volume'):
+        if hasattr(volume_data, "read_volume"):
             volume = volume_data.read_volume()
         else:
             volume = volume_data
@@ -1387,7 +1441,8 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
         if self.store and self.session_id:
             try:
                 self.store.register_embryo(
-                    self.session_id, embryo_id,
+                    self.session_id,
+                    embryo_id,
                     position_coarse=embryo.position_coarse or None,
                     position_fine=embryo.position_fine or None,
                     calibration=embryo.calibration,
@@ -1404,14 +1459,19 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
                 }
                 if volume_path is not None:
                     stored_path = self.store.register_volume(
-                        self.session_id, embryo_id, timepoint,
+                        self.session_id,
+                        embryo_id,
+                        timepoint,
                         incoming_path=Path(volume_path),
                         metadata=acq_metadata,
                         volume_data=volume,
                     )
                 else:
                     stored_path = self.store.put_volume(
-                        self.session_id, embryo_id, timepoint, volume,
+                        self.session_id,
+                        embryo_id,
+                        timepoint,
+                        volume,
                         metadata=acq_metadata,
                     )
             except StorageError:
@@ -1426,9 +1486,9 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
         if self.viz_server and volume is not None:
             try:
                 from gently.core.imaging import (
-                    projection_three_view,
-                    compute_crop_bounds,
                     apply_crop_bounds,
+                    compute_crop_bounds,
+                    projection_three_view,
                 )
 
                 view_a = volume[0] if volume.ndim == 4 else volume
@@ -1436,14 +1496,18 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
                 if view_a.ndim == 3:
                     z_depth, height, width = view_a.shape
                     if width > height * 2:
-                        view_a = view_a[:, :, :width // 2]
+                        view_a = view_a[:, :, : width // 2]
                     bounds = compute_crop_bounds(view_a)
                     cropped = apply_crop_bounds(view_a, bounds)
                     three_view_img, _ = projection_three_view(cropped)
                 else:
                     three_view_img = view_a.astype(np.float32)
                     if three_view_img.max() > three_view_img.min():
-                        three_view_img = (three_view_img - three_view_img.min()) / (three_view_img.max() - three_view_img.min()) * 255
+                        three_view_img = (
+                            (three_view_img - three_view_img.min())
+                            / (three_view_img.max() - three_view_img.min())
+                            * 255
+                        )
                     three_view_img = three_view_img.astype(np.uint8)
 
                 self.push_viz(
@@ -1451,29 +1515,32 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
                     uid=projection_uid,
                     data_type="volume_projection",
                     metadata={
-                        'embryo_id': embryo_id,
-                        'timepoint': timepoint,
-                        'shape': list(volume.shape),
-                        'projection_uid': projection_uid,
-                        'volume_uid': volume_uid,
-                        'projection_type': 'three_view',
-                    }
+                        "embryo_id": embryo_id,
+                        "timepoint": timepoint,
+                        "shape": list(volume.shape),
+                        "projection_uid": projection_uid,
+                        "volume_uid": volume_uid,
+                        "projection_type": "three_view",
+                    },
                 )
             except Exception as e:
                 logger.warning(f"Failed to push to viz: {e}")
 
-        self._emit_event(EventType.VOLUME_ACQUIRED, {
-            'embryo_id': embryo_id,
-            'timepoint': timepoint,
-            'volume_uid': volume_uid,
-            'projection_uid': projection_uid,
-            'volume_path': str(stored_path) if stored_path else None,
-            'shape': list(volume.shape),
-        })
+        self._emit_event(
+            EventType.VOLUME_ACQUIRED,
+            {
+                "embryo_id": embryo_id,
+                "timepoint": timepoint,
+                "volume_uid": volume_uid,
+                "projection_uid": projection_uid,
+                "volume_path": str(stored_path) if stored_path else None,
+                "shape": list(volume.shape),
+            },
+        )
 
         return {
-            'volume_uid': volume_uid,
-            'projection_uid': projection_uid,
+            "volume_uid": volume_uid,
+            "projection_uid": projection_uid,
         }
 
     def should_stop_experiment(self) -> bool:
@@ -1482,22 +1549,31 @@ def should_stop_experiment(self) -> bool:
             return False
         return all(e.should_skip for e in self.experiment.embryos.values())
 
-    def get_embryo_acquisition_order(self) -> List[str]:
+    def get_embryo_acquisition_order(self) -> list[str]:
         """Get embryo acquisition order based on priority."""
-        high = [e.id for e in self.experiment.embryos.values() if e.priority == "high" and not e.should_skip]
-        normal = [e.id for e in self.experiment.embryos.values() if e.priority == "normal" and not e.should_skip]
-        low = [e.id for e in self.experiment.embryos.values() if e.priority == "low" and not e.should_skip]
+        high = [
+            e.id
+            for e in self.experiment.embryos.values()
+            if e.priority == "high" and not e.should_skip
+        ]
+        normal = [
+            e.id
+            for e in self.experiment.embryos.values()
+            if e.priority == "normal" and not e.should_skip
+        ]
+        low = [
+            e.id
+            for e in self.experiment.embryos.values()
+            if e.priority == "low" and not e.should_skip
+        ]
         return high + normal + low
 
-    def decide_parameters(self, embryo_id: str, timepoint: int) -> Dict:
+    def decide_parameters(self, embryo_id: str, timepoint: int) -> dict:
         """Get current acquisition parameters for embryo."""
         embryo = self.experiment.embryos.get(embryo_id)
         if not embryo:
-            return {'num_slices': 50, 'exposure_ms': 10.0}
-        return {
-            'num_slices': embryo.num_slices,
-            'exposure_ms': embryo.exposure_ms
-        }
+            return {"num_slices": 50, "exposure_ms": 10.0}
+        return {"num_slices": embryo.num_slices, "exposure_ms": embryo.exposure_ms}
 
     def decide_next_interval(self, timepoint: int) -> float:
         """Decide interval until next timepoint."""
@@ -1522,8 +1598,9 @@ async def check_blank_image(
                 logger.warning(f"[BLANK_CHECK] {embryo_id}: Numerical check indicates blank image")
                 return True
 
-            import io
             import base64
+            import io
+
             from PIL import Image
 
             if max_proj.max() > 0:
@@ -1533,10 +1610,11 @@ async def check_blank_image(
 
             img = Image.fromarray(normalized)
             buffer = io.BytesIO()
-            img.save(buffer, format='PNG')
+            img.save(buffer, format="PNG")
             b64_image = base64.b64encode(buffer.getvalue()).decode()
 
-            prompt = """Look at this microscopy image. Is this a VALID microscopy image or a BLANK/CORRUPTED image?
+            prompt = """Look at this microscopy image. Is this a VALID microscopy image or a
+BLANK/CORRUPTED image?
 
 A BLANK or CORRUPTED image shows:
 - Mostly uniform gray/black with no structure
@@ -1554,20 +1632,22 @@ async def check_blank_image(
                 self.claude.messages.create,
                 model=settings.models.fast,
                 max_tokens=10,
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "text", "text": prompt},
-                        {
-                            "type": "image",
-                            "source": {
-                                "type": "base64",
-                                "media_type": "image/png",
-                                "data": b64_image
-                            }
-                        }
-                    ]
-                }]
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {"type": "text", "text": prompt},
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/png",
+                                    "data": b64_image,
+                                },
+                            },
+                        ],
+                    }
+                ],
             )
 
             result = response.content[0].text.strip().upper()
@@ -1578,7 +1658,11 @@ async def check_blank_image(
 
             return is_blank
 
-        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
+        except (
+            anthropic.APIConnectionError,
+            anthropic.RateLimitError,
+            anthropic.APIStatusError,
+        ) as e:
             logger.error(f"[BLANK_CHECK] Claude API error for {embryo_id}: {e}")
             return False
         except Exception as e:
diff --git a/gently/app/benchmark.py b/gently/app/benchmark.py
index 5724f548..643e296f 100644
--- a/gently/app/benchmark.py
+++ b/gently/app/benchmark.py
@@ -15,7 +15,6 @@
     /benchmark --volumes 10 --slices 50
 """
 
-import asyncio
 import csv
 import logging
 import shutil
@@ -25,7 +24,7 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import TYPE_CHECKING, Dict, List, Optional
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from .agent import MicroscopyAgent
@@ -36,6 +35,7 @@
 @dataclass
 class VolumeTiming:
     """Timing breakdown for a single volume acquisition."""
+
     volume_idx: int
     embryo_id: str
     timepoint: int
@@ -51,13 +51,14 @@ class VolumeTiming:
     volume_shape: tuple = ()
     file_size_mb: float = 0.0
     success: bool = True
-    error: Optional[str] = None
+    error: str | None = None
 
 
 @dataclass
 class BenchmarkResults:
     """Aggregate benchmark results."""
-    timings: List[VolumeTiming] = field(default_factory=list)
+
+    timings: list[VolumeTiming] = field(default_factory=list)
     num_embryos: int = 1
     num_slices: int = 50
     exposure_ms: float = 10.0
@@ -65,14 +66,14 @@ class BenchmarkResults:
     completed_at: str = ""
 
     @property
-    def successful(self) -> List[VolumeTiming]:
+    def successful(self) -> list[VolumeTiming]:
         return [t for t in self.timings if t.success]
 
     @property
-    def failed(self) -> List[VolumeTiming]:
+    def failed(self) -> list[VolumeTiming]:
         return [t for t in self.timings if not t.success]
 
-    def _stat(self, values: List[float]) -> Dict[str, float]:
+    def _stat(self, values: list[float]) -> dict[str, float]:
         if not values:
             return {"mean": 0, "std": 0, "min": 0, "max": 0}
         return {
@@ -83,19 +84,19 @@ def _stat(self, values: List[float]) -> Dict[str, float]:
         }
 
     @property
-    def acquisition_stats(self) -> Dict[str, float]:
+    def acquisition_stats(self) -> dict[str, float]:
         return self._stat([t.acquisition_time for t in self.successful])
 
     @property
-    def storage_stats(self) -> Dict[str, float]:
+    def storage_stats(self) -> dict[str, float]:
         return self._stat([t.storage_time for t in self.successful])
 
     @property
-    def viz_push_stats(self) -> Dict[str, float]:
+    def viz_push_stats(self) -> dict[str, float]:
         return self._stat([t.viz_push_time for t in self.successful])
 
     @property
-    def total_stats(self) -> Dict[str, float]:
+    def total_stats(self) -> dict[str, float]:
         return self._stat([t.total_time for t in self.successful])
 
     @property
@@ -140,7 +141,7 @@ async def run_benchmark(
     n_volumes: int = None,
     n_slices: int = None,
     n_warmup: int = None,
-    progress_fn: Optional[callable] = None,
+    progress_fn: callable | None = None,
 ) -> BenchmarkResults:
     """
     Run end-to-end volume acquisition benchmark.
@@ -172,7 +173,7 @@ async def run_benchmark(
         started_at=datetime.now().isoformat(),
     )
 
-    viz_server = getattr(agent, 'viz_server', None)
+    viz_server = getattr(agent, "viz_server", None)
     has_viz = viz_server is not None
 
     temp_dir = Path(tempfile.mkdtemp(prefix="gently_benchmark_"))
@@ -187,10 +188,13 @@ async def run_benchmark(
 
         logger.info(
             "Benchmark: %d volumes + %d warmup, %d slices, %.0f ms exposure",
-            num_volumes, warmup, num_slices, exposure_ms,
+            num_volumes,
+            warmup,
+            num_slices,
+            exposure_ms,
         )
 
-        timepoints: Dict[str, int] = {eid: 0 for eid in embryo_ids}
+        timepoints: dict[str, int] = {eid: 0 for eid in embryo_ids}
         total_iterations = warmup + num_volumes
 
         for i in range(total_iterations):
@@ -221,18 +225,16 @@ async def run_benchmark(
             try:
                 if embryo and embryo.calibration:
                     cal = embryo.calibration
-                    galvo_amp = cal.get('galvo_amplitude', 0.5)
-                    galvo_center = cal.get('galvo_center', 0.0)
-                    piezo_amp = cal.get('piezo_amplitude', 25.0)
-                    piezo_center = cal.get('piezo_center', 50.0)
+                    galvo_amp = cal.get("galvo_amplitude", 0.5)
+                    galvo_center = cal.get("galvo_center", 0.0)
+                    piezo_amp = cal.get("piezo_amplitude", 25.0)
+                    piezo_center = cal.get("piezo_center", 50.0)
                 else:
                     galvo_amp, galvo_center = 0.5, 0.0
                     piezo_amp, piezo_center = 25.0, 50.0
 
                 if embryo and embryo.position:
-                    await agent.client.move_stage(
-                        embryo.position['x'], embryo.position['y']
-                    )
+                    await agent.client.move_stage(embryo.position["x"], embryo.position["y"])
 
                 # Stage 1: Acquisition
                 t0 = time.perf_counter()
@@ -247,28 +249,34 @@ async def run_benchmark(
                 t1 = time.perf_counter()
                 timing.acquisition_time = t1 - t0
 
-                if not result.get('success'):
+                if not result.get("success"):
                     timing.success = False
-                    timing.error = result.get('error', 'Acquisition failed')
+                    timing.error = result.get("error", "Acquisition failed")
                     if not is_warmup:
                         results.timings.append(timing)
                     continue
 
-                volume = result.get('volume')
-                volume_path = result.get('volume_path')
+                volume = result.get("volume")
+                volume_path = result.get("volume_path")
                 timing.volume_shape = volume.shape if volume is not None else ()
 
                 # Stage 2: Storage
                 t2 = time.perf_counter()
                 if volume_path:
                     canonical_path = temp_store.register_volume(
-                        benchmark_session, embryo_id, tp, Path(volume_path),
+                        benchmark_session,
+                        embryo_id,
+                        tp,
+                        Path(volume_path),
                         volume_data=volume,
                     )
                     timing.file_size_mb = canonical_path.stat().st_size / (1024 * 1024)
                 elif volume is not None:
                     canonical_path = temp_store.put_volume(
-                        benchmark_session, embryo_id, tp, volume,
+                        benchmark_session,
+                        embryo_id,
+                        tp,
+                        volume,
                     )
                     timing.file_size_mb = canonical_path.stat().st_size / (1024 * 1024)
                 t3 = time.perf_counter()
@@ -282,7 +290,11 @@ async def run_benchmark(
                         proj,
                         uid=f"benchmark_{embryo_id}_t{tp:04d}",
                         data_type="benchmark",
-                        metadata={"embryo_id": embryo_id, "timepoint": tp, "benchmark": True},
+                        metadata={
+                            "embryo_id": embryo_id,
+                            "timepoint": tp,
+                            "benchmark": True,
+                        },
                     )
                 t5 = time.perf_counter()
                 timing.viz_push_time = t5 - t4
@@ -355,21 +367,34 @@ def save_benchmark_csv(results: BenchmarkResults, path: Path):
         writer.writerow(["# std_total_s", f"{total['std']:.6f}"])
         writer.writerow([])
 
-        writer.writerow([
-            "volume_idx", "embryo_id", "timepoint",
-            "acquisition_s", "storage_s", "viz_push_s", "total_s",
-            "file_size_mb", "success", "error"
-        ])
+        writer.writerow(
+            [
+                "volume_idx",
+                "embryo_id",
+                "timepoint",
+                "acquisition_s",
+                "storage_s",
+                "viz_push_s",
+                "total_s",
+                "file_size_mb",
+                "success",
+                "error",
+            ]
+        )
         for t in results.timings:
-            writer.writerow([
-                t.volume_idx, t.embryo_id, t.timepoint,
-                f"{t.acquisition_time:.6f}",
-                f"{t.storage_time:.6f}",
-                f"{t.viz_push_time:.6f}",
-                f"{t.total_time:.6f}",
-                f"{t.file_size_mb:.2f}",
-                t.success,
-                t.error or "",
-            ])
+            writer.writerow(
+                [
+                    t.volume_idx,
+                    t.embryo_id,
+                    t.timepoint,
+                    f"{t.acquisition_time:.6f}",
+                    f"{t.storage_time:.6f}",
+                    f"{t.viz_push_time:.6f}",
+                    f"{t.total_time:.6f}",
+                    f"{t.file_size_mb:.2f}",
+                    t.success,
+                    t.error or "",
+                ]
+            )
 
     return path
diff --git a/gently/app/bottom_camera_monitor.py b/gently/app/bottom_camera_monitor.py
index 6ec6443e..1671e718 100644
--- a/gently/app/bottom_camera_monitor.py
+++ b/gently/app/bottom_camera_monitor.py
@@ -14,7 +14,7 @@
 
 import asyncio
 import logging
-from typing import Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 from gently.core.event_bus import EventType, get_event_bus
 from gently.core.service import Service
@@ -35,15 +35,15 @@ class BottomCameraStreamMonitor(Service):
 
     def __init__(
         self,
-        microscope: "DiSPIMMicroscope",
+        microscope: DiSPIMMicroscope,
         reconnect_delay_sec: float = 2.0,
     ):
         super().__init__(name="bottom-camera-monitor", service_type="bridge")
         self.microscope = microscope
         self.reconnect_delay_sec = reconnect_delay_sec
-        self._task: Optional[asyncio.Task] = None
+        self._task: asyncio.Task | None = None
         self._stop_requested = False
-        self._last_frame_ts: Optional[float] = None
+        self._last_frame_ts: float | None = None
 
     @property
     def running(self) -> bool:
@@ -89,7 +89,8 @@ async def _run(self):
             except Exception as exc:
                 logger.warning(
                     "BottomCameraStreamMonitor: stream ended (%s) — reconnecting in %.1fs",
-                    exc, self.reconnect_delay_sec,
+                    exc,
+                    self.reconnect_delay_sec,
                 )
             if self._stop_requested:
                 break
diff --git a/gently/app/calibration/__init__.py b/gently/app/calibration/__init__.py
index 9365824e..683b152c 100644
--- a/gently/app/calibration/__init__.py
+++ b/gently/app/calibration/__init__.py
@@ -19,9 +19,9 @@
 """
 
 from .base import CalibrationData, CalibrationPipeline, aggregate_calibrations
-from .two_point import TwoPointCalibration
 from .edge_roi import EdgeRoiCalibration
 from .registry import CALIBRATION_REGISTRY, get_calibration_pipeline
+from .two_point import TwoPointCalibration
 
 __all__ = [
     "CalibrationData",
diff --git a/gently/app/calibration/base.py b/gently/app/calibration/base.py
index ae3e72dc..3b8259d7 100644
--- a/gently/app/calibration/base.py
+++ b/gently/app/calibration/base.py
@@ -5,7 +5,7 @@
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import numpy as np
 
@@ -19,11 +19,12 @@ class CalibrationData:
     ``edge_bbox`` for edge ROI). Merged ``CalibrationData`` from multiple
     pipelines is what gets passed to detector context as ``calibration``.
     """
+
     pipeline_name: str
     captured_at: datetime = field(default_factory=datetime.now)
-    source_embryo_ids: List[str] = field(default_factory=list)
-    payload: Dict[str, Any] = field(default_factory=dict)
-    notes: Optional[str] = None
+    source_embryo_ids: list[str] = field(default_factory=list)
+    payload: dict[str, Any] = field(default_factory=dict)
+    notes: str | None = None
 
 
 class CalibrationPipeline(ABC):
@@ -41,8 +42,8 @@ class CalibrationPipeline(ABC):
     @abstractmethod
     def capture(
         self,
-        source_volumes: Dict[str, np.ndarray],
-        context: Dict[str, Any],
+        source_volumes: dict[str, np.ndarray],
+        context: dict[str, Any],
     ) -> CalibrationData:
         """Compute calibration data from one or more source embryo volumes."""
         ...
@@ -57,8 +58,8 @@ def apply(
 
 
 def aggregate_calibrations(
-    pipelines_data: List[CalibrationData],
-) -> Dict[str, Any]:
+    pipelines_data: list[CalibrationData],
+) -> dict[str, Any]:
     """Merge multiple CalibrationData payloads into the single dict the
     detector context expects.
 
@@ -67,7 +68,7 @@ def aggregate_calibrations(
     single pipeline is the pipeline's responsibility (typically via
     pixel-wise median, see TwoPointCalibration).
     """
-    merged: Dict[str, Any] = {}
+    merged: dict[str, Any] = {}
     for cal in pipelines_data:
         merged.update(cal.payload)
     return merged
diff --git a/gently/app/calibration/edge_roi.py b/gently/app/calibration/edge_roi.py
index 68a0cb58..25aa907a 100644
--- a/gently/app/calibration/edge_roi.py
+++ b/gently/app/calibration/edge_roi.py
@@ -11,7 +11,7 @@
 dopaminergic detector uses).
 """
 
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 import numpy as np
 
@@ -28,8 +28,8 @@ def __init__(self, padding_px: int = 10):
 
     def capture(
         self,
-        source_volumes: Dict[str, Any],
-        context: Dict[str, Any],
+        source_volumes: dict[str, Any],
+        context: dict[str, Any],
     ) -> CalibrationData:
         """``source_volumes`` here is expected to be a flat
         ``{embryo_id: volume_ndarray}`` dict (no dark/flat split).
@@ -39,10 +39,10 @@ def capture(
         elsewhere and we just want to reuse its output.
         """
         precomputed = context.get("embryo_bboxes") if context else None
-        bboxes: List[Tuple[int, int, int, int]] = []
+        bboxes: list[tuple[int, int, int, int]] = []
 
         if precomputed:
-            for eid, bb in precomputed.items():
+            for _eid, bb in precomputed.items():
                 if bb is not None and len(bb) == 4:
                     bboxes.append(tuple(map(int, bb)))
         else:
@@ -65,8 +65,10 @@ def capture(
         xs1 = np.array([b[2] for b in bboxes])
         ys1 = np.array([b[3] for b in bboxes])
         agg = (
-            int(np.median(xs0)), int(np.median(ys0)),
-            int(np.median(xs1)), int(np.median(ys1)),
+            int(np.median(xs0)),
+            int(np.median(ys0)),
+            int(np.median(xs1)),
+            int(np.median(ys1)),
         )
 
         return CalibrationData(
@@ -77,7 +79,7 @@ def capture(
         )
 
 
-def _bbox_from_volume(vol, padding: int = 10) -> Optional[Tuple[int, int, int, int]]:
+def _bbox_from_volume(vol, padding: int = 10) -> tuple[int, int, int, int] | None:
     """Cheap thresholding-based bbox fallback when SAM hasn't run.
 
     Max-projects, thresholds at 25th percentile + delta, returns the
diff --git a/gently/app/calibration/registry.py b/gently/app/calibration/registry.py
index 5953110f..cadfa857 100644
--- a/gently/app/calibration/registry.py
+++ b/gently/app/calibration/registry.py
@@ -1,30 +1,31 @@
 """Calibration pipeline registry — name → factory."""
 
-from typing import Callable, Dict, Optional
+from collections.abc import Callable
 
 from .base import CalibrationPipeline
 
-
 CalibrationFactory = Callable[..., CalibrationPipeline]
 
 
 def _make_two_point(**kw) -> CalibrationPipeline:
     from .two_point import TwoPointCalibration
+
     return TwoPointCalibration(**kw)
 
 
 def _make_edge_roi(**kw) -> CalibrationPipeline:
     from .edge_roi import EdgeRoiCalibration
+
     return EdgeRoiCalibration(**kw)
 
 
-CALIBRATION_REGISTRY: Dict[str, CalibrationFactory] = {
+CALIBRATION_REGISTRY: dict[str, CalibrationFactory] = {
     "two_point": _make_two_point,
     "edge_roi": _make_edge_roi,
 }
 
 
-def get_calibration_pipeline(name: str, **kw) -> Optional[CalibrationPipeline]:
+def get_calibration_pipeline(name: str, **kw) -> CalibrationPipeline | None:
     factory = CALIBRATION_REGISTRY.get(name)
     if factory is None:
         return None
diff --git a/gently/app/calibration/two_point.py b/gently/app/calibration/two_point.py
index edd31263..bea11c1e 100644
--- a/gently/app/calibration/two_point.py
+++ b/gently/app/calibration/two_point.py
@@ -12,7 +12,7 @@
 calibration embryos uses pixel-wise **median** for robustness.
 """
 
-from typing import Any, Dict, List
+from typing import Any
 
 import numpy as np
 
@@ -44,8 +44,8 @@ def __init__(self, dark_source: str = "dark", flat_source: str = "flat"):
 
     def capture(
         self,
-        source_volumes: Dict[str, Any],
-        context: Dict[str, Any],
+        source_volumes: dict[str, Any],
+        context: dict[str, Any],
     ) -> CalibrationData:
         darks = source_volumes.get(self.dark_source, {}) or {}
         flats = source_volumes.get(self.flat_source, {}) or {}
@@ -53,7 +53,7 @@ def capture(
         dark_proj = _aggregate_projections(list(darks.values()))
         flat_proj = _aggregate_projections(list(flats.values()))
 
-        payload: Dict[str, Any] = {}
+        payload: dict[str, Any] = {}
         if dark_proj is not None:
             payload["dark"] = dark_proj
         if flat_proj is not None:
@@ -72,7 +72,7 @@ def capture(
         )
 
 
-def _aggregate_projections(volumes: List[np.ndarray]):
+def _aggregate_projections(volumes: list[np.ndarray]):
     """Max-project each volume to 2D, then median across embryos."""
     if not volumes:
         return None
diff --git a/gently/app/detectors/__init__.py b/gently/app/detectors/__init__.py
index 04db8775..bb54301c 100644
--- a/gently/app/detectors/__init__.py
+++ b/gently/app/detectors/__init__.py
@@ -18,9 +18,9 @@
 """
 
 from .base import Detector, DetectorResult
+from .blank_image import BlankImageDetector
 from .dopaminergic_signal import DopaminergicSignalDetector
 from .hatching import HatchingDetector
-from .blank_image import BlankImageDetector
 from .perception_proxy import PerceptionProxy
 from .registry import DETECTOR_REGISTRY, get_detector
 
diff --git a/gently/app/detectors/base.py b/gently/app/detectors/base.py
index a25caaca..0179061f 100644
--- a/gently/app/detectors/base.py
+++ b/gently/app/detectors/base.py
@@ -11,7 +11,7 @@
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Dict, Optional
+from typing import Any
 
 import numpy as np
 
@@ -26,18 +26,19 @@ class DetectorResult:
     structure_quality: "GOOD"}`` for the dopaminergic detector,
     ``{stage: "pretzel"}`` for the perception proxy).
     """
+
     detector_name: str
     embryo_id: str
     timepoint: int
-    findings: Dict[str, Any] = field(default_factory=dict)
-    confidence: Optional[float] = None
-    reasoning: Optional[str] = None
-    raw_response: Optional[str] = None
+    findings: dict[str, Any] = field(default_factory=dict)
+    confidence: float | None = None
+    reasoning: str | None = None
+    raw_response: str | None = None
     timestamp: datetime = field(default_factory=datetime.now)
-    elapsed_ms: Optional[float] = None
-    error: Optional[str] = None
+    elapsed_ms: float | None = None
+    error: str | None = None
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "detector_name": self.detector_name,
             "embryo_id": self.embryo_id,
@@ -76,7 +77,7 @@ class Detector(ABC):
     async def run(
         self,
         volume: np.ndarray,
-        context: Dict[str, Any],
+        context: dict[str, Any],
     ) -> DetectorResult:
         """Observe the volume and return a structured result."""
         ...
diff --git a/gently/app/detectors/blank_image.py b/gently/app/detectors/blank_image.py
index f8a6bcd3..8973c0cd 100644
--- a/gently/app/detectors/blank_image.py
+++ b/gently/app/detectors/blank_image.py
@@ -11,7 +11,7 @@
 import io
 import logging
 import time
-from typing import Any, Dict, Optional
+from typing import Any
 
 import numpy as np
 
@@ -20,7 +20,8 @@
 logger = logging.getLogger(__name__)
 
 
-_BLANK_PROMPT = """Look at this microscopy image. Is this a VALID microscopy image or a BLANK/CORRUPTED image?
+_BLANK_PROMPT = """Look at this microscopy image. Is this a VALID microscopy image or a
+BLANK/CORRUPTED image?
 
 A BLANK or CORRUPTED image shows:
 - Mostly uniform gray/black with no structure
@@ -40,18 +41,19 @@ class BlankImageDetector(Detector):
 
     name = "blank_image"
 
-    def __init__(self, claude_client=None, model: Optional[str] = None):
+    def __init__(self, claude_client=None, model: str | None = None):
         self._claude = claude_client
         self._model = model
 
     async def run(
         self,
         volume: np.ndarray,
-        context: Dict[str, Any],
+        context: dict[str, Any],
     ) -> DetectorResult:
-        from gently.settings import settings
-        from PIL import Image as PILImage
         import anthropic
+        from PIL import Image as PILImage
+
+        from gently.settings import settings
 
         embryo_id = context.get("embryo_id", "?")
         timepoint = int(context.get("timepoint", 0))
@@ -61,15 +63,20 @@ async def run(
         vol = np.squeeze(volume) if volume is not None else None
         if vol is None or vol.size == 0:
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
-                findings={"is_blank": True}, reasoning="Empty volume",
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
+                findings={"is_blank": True},
+                reasoning="Empty volume",
                 elapsed_ms=(time.time() - start) * 1000,
             )
 
         max_proj = np.max(vol, axis=0) if vol.ndim == 3 else vol
         if np.std(max_proj) < 1.0 or np.max(max_proj) < 10:
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
                 findings={"is_blank": True},
                 reasoning="Numerical check (low std / max)",
                 elapsed_ms=(time.time() - start) * 1000,
@@ -78,7 +85,9 @@ async def run(
         claude = self._claude or context.get("claude")
         if claude is None:
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
                 findings={"is_blank": False},
                 reasoning="No Claude client; deferred to numerical check (passed)",
                 elapsed_ms=(time.time() - start) * 1000,
@@ -87,8 +96,11 @@ async def run(
         # Normalize, encode, ask Claude
         if max_proj.max() == 0:
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
-                findings={"is_blank": True}, reasoning="Max projection is all zeros",
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
+                findings={"is_blank": True},
+                reasoning="Max projection is all zeros",
                 elapsed_ms=(time.time() - start) * 1000,
             )
         normalized = (max_proj / max_proj.max() * 255).astype(np.uint8)
@@ -101,38 +113,53 @@ async def run(
                 claude.messages.create,
                 model=self._model or settings.models.fast,
                 max_tokens=10,
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "text", "text": _BLANK_PROMPT},
-                        {"type": "image", "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": b64_image,
-                        }},
-                    ],
-                }],
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {"type": "text", "text": _BLANK_PROMPT},
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/png",
+                                    "data": b64_image,
+                                },
+                            },
+                        ],
+                    }
+                ],
             )
             text = (response.content[0].text if response.content else "").strip().upper()
             is_blank = "BLANK" in text
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
                 findings={"is_blank": is_blank},
                 reasoning=text,
                 raw_response=text,
                 elapsed_ms=(time.time() - start) * 1000,
             )
-        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
+        except (
+            anthropic.APIConnectionError,
+            anthropic.RateLimitError,
+            anthropic.APIStatusError,
+        ) as e:
             logger.error("[%s] Claude API error for %s: %s", self.name, embryo_id, e)
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
                 error=f"API error: {e}",
                 elapsed_ms=(time.time() - start) * 1000,
             )
         except Exception as e:
             logger.exception("[%s] unexpected error", self.name)
             return DetectorResult(
-                detector_name=self.name, embryo_id=embryo_id, timepoint=timepoint,
+                detector_name=self.name,
+                embryo_id=embryo_id,
+                timepoint=timepoint,
                 error=str(e),
                 elapsed_ms=(time.time() - start) * 1000,
             )
diff --git a/gently/app/detectors/dopaminergic_signal.py b/gently/app/detectors/dopaminergic_signal.py
index 4d919446..7fb09408 100644
--- a/gently/app/detectors/dopaminergic_signal.py
+++ b/gently/app/detectors/dopaminergic_signal.py
@@ -23,7 +23,7 @@
 import logging
 import re
 import time
-from typing import Any, Dict, Optional, Tuple
+from typing import Any
 
 import numpy as np
 
@@ -32,58 +32,81 @@
 logger = logging.getLogger(__name__)
 
 
-_PERCEIVER_PROMPT = """You are looking at the max projection of a volume of C. elegans imaged with a 488 nm light-sheet microscope. The embryo is expressing a fluorophore that lights up when certain neurons are born.
+_PERCEIVER_PROMPT = """You are looking at the max projection of a volume of C. elegans imaged
+with a 488 nm light-sheet microscope. The embryo is expressing a fluorophore that lights up
+when certain neurons are born.
 
-We are trying to image the birth of these neurons and their continued existence. Your description will be read by a classifier that decides how to guide the imaging: it will speed up imaging once the neuronal structures appear, and trigger a 1-minute burst of fast acquisitions once they look stably bright. Be specific so the classifier has something concrete to act on.
+We are trying to image the birth of these neurons and their continued existence. Your
+description will be read by a classifier that decides how to guide the imaging: it will speed
+up imaging once the neuronal structures appear, and trigger a 1-minute burst of fast
+acquisitions once they look stably bright. Be specific so the classifier has something
+concrete to act on.
 
 You may initially see a faint outline of the embryo — autofluorescence from the body.
 
-Eventually, you may see puncta-like structures in the embryo region of the image. If there are any puncta outside the embryo region, ignore them — those are likely gut granules.
+Eventually, you may see puncta-like structures in the embryo region of the image. If there
+are any puncta outside the embryo region, ignore them — those are likely gut granules.
 
-The nerve cells, as they begin to express, will first appear as a faint blob, then a brighter blob, then a further-brighter blob, and will start to emit thread-like structures from them — the nerve body. These are what we want to image.
+The nerve cells, as they begin to express, will first appear as a faint blob, then a brighter
+blob, then a further-brighter blob, and will start to emit thread-like structures from them —
+the nerve body. These are what we want to image.
 
-The embryo may also eventually hatch. This can look like the embryo structure disappearing entirely from the field of view. Mention it if you see this.
+The embryo may also eventually hatch. This can look like the embryo structure disappearing
+entirely from the field of view. Mention it if you see this.
 
 Describe what you see in a few sentences of plain prose.
 """
 
 
-_CLASSIFIER_PROMPT = """You are reading a microscopist's description of an image of a C. elegans embryo expressing a dopaminergic-neuron reporter (dat-1::mNeonGreen).
+_CLASSIFIER_PROMPT = """You are reading a microscopist's description of an image of a C. elegans
+embryo expressing a dopaminergic-neuron reporter (dat-1::mNeonGreen).
 
-Classify the description against the rubric below. Output ONLY a JSON object — no prose, no markdown fences. Your output drives the timelapse orchestrator's next imaging decision.
+Classify the description against the rubric below. Output ONLY a JSON object — no prose, no
+markdown fences. Your output drives the timelapse orchestrator's next imaging decision.
 
 The orchestrator can take these actions based on your output:
 - speed_up — accelerate imaging cadence to 1-minute intervals (when neurons begin to appear).
-- burst — fire a 1-minute burst of fast acquisitions (when neurons are stably bright and well-resolved).
+- burst — fire a 1-minute burst of fast acquisitions (when neurons are stably bright and
+  well-resolved).
 - ramp_down_power — step the 488 nm laser down (when signal saturates the camera).
 - stop — stop imaging this embryo (when it has hatched / left the field).
-- none — keep the base cadence, take no action (when the description is uncertain or shows only background).
+- none — keep the base cadence, take no action (when the description is uncertain or shows
+  only background).
 
 Schema:
 {
-  "intensity_level": "NONE" | "WEAK" | "MEDIUM" | "STRONG" | "SATURATING" | "UNCERTAIN",  # signal strength — is the signal absent, faint, average, or stronger?
-  "structure_quality": "NONE" | "PARTIAL" | "GOOD" | "UNCERTAIN",  # are the neuronal structures absent, emerging, fully emerged with good signal, or can't tell?
-  "has_hatched": true | false,  # has the embryo hatched or left the field of view? — drives the stop action
+  "intensity_level": "NONE" | "WEAK" | "MEDIUM" | "STRONG" | "SATURATING" | "UNCERTAIN",
+  # signal strength — is the signal absent, faint, average, or stronger?
+  "structure_quality": "NONE" | "PARTIAL" | "GOOD" | "UNCERTAIN",
+  # are the neuronal structures absent, emerging, fully emerged with good signal, or can't tell?
+  "has_hatched": true | false,
+  # has the embryo hatched or left the field of view? — drives the stop action
   "reasoning": "one short sentence quoting which words drove your choice"
 }
 
 intensity_level rubric (drives speed_up / ramp_down_power):
 - NONE: description says no puncta in the embryo / blank / nothing above background. → none
-- WEAK: description mentions 1 dim spot, OR signal explicitly described as "barely visible" / "could be noise" / "very faint". → none (could be noise)
+- WEAK: description mentions 1 dim spot, OR signal explicitly described as "barely visible" /
+  "could be noise" / "very faint". → none (could be noise)
 - MEDIUM: description mentions 2+ clearly discrete bright spots above background. → speed_up
 - STRONG: description mentions multiple bright, well-resolved spots. → speed_up
 - SATURATING: description explicitly says the signal saturates the camera. → ramp_down_power
-- UNCERTAIN: description hedges, doesn't address signal, or you cannot tell from the prose alone. → none
+- UNCERTAIN: description hedges, doesn't address signal, or you cannot tell from the prose
+  alone. → none
 
 structure_quality rubric (drives burst):
 - NONE: no puncta described. → none
 - PARTIAL: puncta present but no neurites / no curved connecting traces. → none (not yet stable)
-- GOOD: description mentions curved/elongated traces between puncta or recognizable neurite structure. → burst
+- GOOD: description mentions curved/elongated traces between puncta or recognizable neurite
+  structure. → burst
 - UNCERTAIN: description is silent on structure or ambiguous. → none
 
-has_hatched: true ONLY if the description explicitly says the embryo has hatched, OR the embryo structure has disappeared from the field of view. Default false. → stop
+has_hatched: true ONLY if the description explicitly says the embryo has hatched, OR the
+embryo structure has disappeared from the field of view. Default false. → stop
 
-When the description is ambiguous, choose UNCERTAIN over guessing. When between two adjacent levels, choose the more conservative (lower) one — false negatives (missing onset by a timepoint) are cheap, false positives (burning photodose on noise) are expensive.
+When the description is ambiguous, choose UNCERTAIN over guessing. When between two adjacent
+levels, choose the more conservative (lower) one — false negatives (missing onset by a
+timepoint) are cheap, false positives (burning photodose on noise) are expensive.
 
 Description to classify:
 ---
@@ -100,10 +123,10 @@ class DopaminergicSignalDetector(Detector):
     def __init__(
         self,
         claude_client=None,
-        perceiver_model: Optional[str] = None,
-        classifier_model: Optional[str] = None,
+        perceiver_model: str | None = None,
+        classifier_model: str | None = None,
         # Back-compat: callers passing the old single-model kwarg.
-        model: Optional[str] = None,
+        model: str | None = None,
     ):
         self._claude = claude_client
         self._perceiver_model = perceiver_model or model
@@ -113,11 +136,12 @@ def __init__(
     async def run(
         self,
         volume: np.ndarray,
-        context: Dict[str, Any],
+        context: dict[str, Any],
     ) -> DetectorResult:
-        from gently.settings import settings
         import anthropic
 
+        from gently.settings import settings
+
         embryo_id = context.get("embryo_id", "?")
         timepoint = int(context.get("timepoint", 0))
         start = time.time()
@@ -155,8 +179,11 @@ async def run(
                     detector_name=self.name,
                     embryo_id=embryo_id,
                     timepoint=timepoint,
-                    findings={"intensity_level": "NONE", "structure_quality": "NONE",
-                              "has_hatched": False},
+                    findings={
+                        "intensity_level": "NONE",
+                        "structure_quality": "NONE",
+                        "has_hatched": False,
+                    },
                     reasoning="Empty / unreadable volume",
                     elapsed_ms=(time.time() - start) * 1000,
                 )
@@ -164,13 +191,17 @@ async def run(
             # Stage 1: Perceiver (image → prose)
             perceiver_model = self._perceiver_model or settings.models.perception
             description, perceiver_raw = await self._call_perceiver(
-                claude, perceiver_model, b64_image,
+                claude,
+                perceiver_model,
+                b64_image,
             )
 
             # Stage 2: Classifier (prose → findings)
             classifier_model = self._classifier_model or settings.models.main
             findings, classifier_raw, parse_err = await self._call_classifier(
-                claude, classifier_model, description,
+                claude,
+                classifier_model,
+                description,
             )
 
             return DetectorResult(
@@ -190,7 +221,11 @@ async def run(
                 error=parse_err,
             )
 
-        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
+        except (
+            anthropic.APIConnectionError,
+            anthropic.RateLimitError,
+            anthropic.APIStatusError,
+        ) as e:
             logger.error("[%s] Claude API error for %s: %s", self.name, embryo_id, e)
             return DetectorResult(
                 detector_name=self.name,
@@ -210,35 +245,43 @@ async def run(
             )
 
     async def _call_perceiver(
-        self, claude, model: str, b64_image: str,
-    ) -> Tuple[str, str]:
+        self,
+        claude,
+        model: str,
+        b64_image: str,
+    ) -> tuple[str, str]:
         """Stage 1: image → free prose description. Stateless — each
         timepoint is evaluated independently."""
         response = await asyncio.to_thread(
             claude.messages.create,
             model=model,
             max_tokens=400,
-            messages=[{
-                "role": "user",
-                "content": [
-                    {"type": "text", "text": _PERCEIVER_PROMPT},
-                    {
-                        "type": "image",
-                        "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": b64_image,
+            messages=[
+                {
+                    "role": "user",
+                    "content": [
+                        {"type": "text", "text": _PERCEIVER_PROMPT},
+                        {
+                            "type": "image",
+                            "source": {
+                                "type": "base64",
+                                "media_type": "image/png",
+                                "data": b64_image,
+                            },
                         },
-                    },
-                ],
-            }],
+                    ],
+                }
+            ],
         )
         raw = response.content[0].text if response.content else ""
         return raw.strip(), raw
 
     async def _call_classifier(
-        self, claude, model: str, description: str,
-    ) -> Tuple[Dict[str, Any], str, Optional[str]]:
+        self,
+        claude,
+        model: str,
+        description: str,
+    ) -> tuple[dict[str, Any], str, str | None]:
         """Stage 2: description prose → structured findings."""
         prompt = _CLASSIFIER_PROMPT.replace("{DESCRIPTION}", description or "(no description)")
         response = await asyncio.to_thread(
@@ -252,7 +295,7 @@ async def _call_classifier(
         return findings, raw, parse_err
 
 
-def _volume_to_b64(volume: np.ndarray, calibration: Optional[Dict] = None) -> Optional[str]:
+def _volume_to_b64(volume: np.ndarray, calibration: dict | None = None) -> str | None:
     """Max-project a volume (with optional dark/flat correction + edge ROI)
     and return a base64-encoded PNG.
 
@@ -298,9 +341,9 @@ def _volume_to_b64(volume: np.ndarray, calibration: Optional[Dict] = None) -> Op
         dark = calibration.get("dark")
         flat = calibration.get("flat")
         if dark is not None and flat is not None and dark.shape == proj.shape:
-            denom = (flat.astype(np.float32) - dark.astype(np.float32))
+            denom = flat.astype(np.float32) - dark.astype(np.float32)
             denom[denom <= 0] = 1.0
-            proj = ((proj.astype(np.float32) - dark.astype(np.float32)) / denom * 255.0)
+            proj = (proj.astype(np.float32) - dark.astype(np.float32)) / denom * 255.0
             proj = np.clip(proj, 0, 255).astype(np.uint8)
             calibrated = True
 
@@ -389,7 +432,7 @@ def _parse_response(raw: str) -> tuple:
     return dict(_DEFAULT_FINDINGS), f"could not parse response: {raw[:120]!r}"
 
 
-def _normalize_findings(d: Dict[str, Any]) -> Dict[str, Any]:
+def _normalize_findings(d: dict[str, Any]) -> dict[str, Any]:
     """Coerce a parsed JSON dict to the expected schema, filling defaults
     for missing keys and validating enum values. UNCERTAIN is a valid
     value for both intensity_level and structure_quality and downstream
diff --git a/gently/app/detectors/hatching.py b/gently/app/detectors/hatching.py
index df4e7c00..62dd31cb 100644
--- a/gently/app/detectors/hatching.py
+++ b/gently/app/detectors/hatching.py
@@ -10,7 +10,7 @@
 import asyncio
 import logging
 import time
-from typing import Any, Dict, Optional
+from typing import Any
 
 import numpy as np
 
@@ -20,7 +20,8 @@
 logger = logging.getLogger(__name__)
 
 
-_HATCHING_PROMPT = """You are observing a C. elegans embryo on a microscope. Decide whether the embryo has HATCHED.
+_HATCHING_PROMPT = """You are observing a C. elegans embryo on a microscope. Decide whether
+the embryo has HATCHED.
 
 A HATCHED embryo:
 - Has visibly broken out of the eggshell
@@ -48,19 +49,22 @@ class HatchingDetector(Detector):
 
     name = "hatching"
 
-    def __init__(self, claude_client=None, model: Optional[str] = None):
+    def __init__(self, claude_client=None, model: str | None = None):
         self._claude = claude_client
         self._model = model
 
     async def run(
         self,
         volume: np.ndarray,
-        context: Dict[str, Any],
+        context: dict[str, Any],
     ) -> DetectorResult:
-        from gently.settings import settings
-        import json, re
+        import json
+        import re
+
         import anthropic
 
+        from gently.settings import settings
+
         embryo_id = context.get("embryo_id", "?")
         timepoint = int(context.get("timepoint", 0))
         start = time.time()
@@ -90,17 +94,22 @@ async def run(
                 claude.messages.create,
                 model=self._model or settings.models.fast,
                 max_tokens=200,
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "text", "text": _HATCHING_PROMPT},
-                        {"type": "image", "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": b64_image,
-                        }},
-                    ],
-                }],
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {"type": "text", "text": _HATCHING_PROMPT},
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/png",
+                                    "data": b64_image,
+                                },
+                            },
+                        ],
+                    }
+                ],
             )
             raw = response.content[0].text if response.content else ""
 
@@ -131,7 +140,11 @@ async def run(
                 error=err,
             )
 
-        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
+        except (
+            anthropic.APIConnectionError,
+            anthropic.RateLimitError,
+            anthropic.APIStatusError,
+        ) as e:
             logger.error("[%s] Claude API error for %s: %s", self.name, embryo_id, e)
             return DetectorResult(
                 detector_name=self.name,
diff --git a/gently/app/detectors/perception_proxy.py b/gently/app/detectors/perception_proxy.py
index 42962715..8cb501c6 100644
--- a/gently/app/detectors/perception_proxy.py
+++ b/gently/app/detectors/perception_proxy.py
@@ -10,7 +10,7 @@
 
 import logging
 import time
-from typing import Any, Dict, Optional
+from typing import Any
 
 import numpy as np
 
@@ -35,7 +35,7 @@ def perceiver(self):
     async def run(
         self,
         volume: np.ndarray,
-        context: Dict[str, Any],
+        context: dict[str, Any],
     ) -> DetectorResult:
         embryo_id = context.get("embryo_id", "?")
         timepoint = int(context.get("timepoint", 0))
@@ -66,8 +66,12 @@ async def run(
 
         try:
             from datetime import datetime
+
             result = await perceiver(
-                embryo_id, timepoint, b64_image, datetime.now().isoformat(),
+                embryo_id,
+                timepoint,
+                b64_image,
+                datetime.now().isoformat(),
             )
         except Exception as e:
             logger.exception("[%s] perceiver error for %s", self.name, embryo_id)
diff --git a/gently/app/detectors/registry.py b/gently/app/detectors/registry.py
index 35613623..219144f8 100644
--- a/gently/app/detectors/registry.py
+++ b/gently/app/detectors/registry.py
@@ -6,36 +6,39 @@
 instance here for each acquired volume.
 """
 
-from typing import Any, Callable, Dict, Optional
+from collections.abc import Callable
 
 from .base import Detector
 
-
 # Factory signature: (claude_client=None, perceiver=None) -> Detector
 DetectorFactory = Callable[..., Detector]
 
 
 def _make_dopaminergic(*, claude_client=None, perceiver=None, **_) -> Detector:
     from .dopaminergic_signal import DopaminergicSignalDetector
+
     return DopaminergicSignalDetector(claude_client=claude_client)
 
 
 def _make_hatching(*, claude_client=None, perceiver=None, **_) -> Detector:
     from .hatching import HatchingDetector
+
     return HatchingDetector(claude_client=claude_client)
 
 
 def _make_blank(*, claude_client=None, perceiver=None, **_) -> Detector:
     from .blank_image import BlankImageDetector
+
     return BlankImageDetector(claude_client=claude_client)
 
 
 def _make_perception(*, claude_client=None, perceiver=None, **_) -> Detector:
     from .perception_proxy import PerceptionProxy
+
     return PerceptionProxy(perceiver=perceiver)
 
 
-DETECTOR_REGISTRY: Dict[str, DetectorFactory] = {
+DETECTOR_REGISTRY: dict[str, DetectorFactory] = {
     "dopaminergic_signal": _make_dopaminergic,
     "hatching": _make_hatching,
     "blank_image": _make_blank,
@@ -44,11 +47,11 @@ def _make_perception(*, claude_client=None, perceiver=None, **_) -> Detector:
 
 
 def get_detector(
-    name: Optional[str],
+    name: str | None,
     *,
     claude_client=None,
     perceiver=None,
-) -> Optional[Detector]:
+) -> Detector | None:
     """Return a Detector instance for ``name``, or None if unknown.
 
     Unknown / None names return None so the orchestrator can choose
diff --git a/gently/app/developmental_tracker.py b/gently/app/developmental_tracker.py
index 64c47773..ef69f4d5 100644
--- a/gently/app/developmental_tracker.py
+++ b/gently/app/developmental_tracker.py
@@ -6,12 +6,12 @@
 """
 
 from gently.organisms.celegans.developmental_tracker import (  # noqa: F401
-    DevelopmentalStage,
+    STAGE_CLASSIFICATION_PROMPT,
     STAGE_TIMING_20C,
     TIME_TO_HATCHING,
     TIMING_VARIABILITY,
+    DevelopmentalStage,
+    DevelopmentalTracker,
     HatchingPrediction,
     StageClassification,
-    STAGE_CLASSIFICATION_PROMPT,
-    DevelopmentalTracker,
 )
diff --git a/gently/app/device_state_monitor.py b/gently/app/device_state_monitor.py
index 55e61daf..8231a9c2 100644
--- a/gently/app/device_state_monitor.py
+++ b/gently/app/device_state_monitor.py
@@ -32,7 +32,7 @@
 import asyncio
 import logging
 import time
-from typing import Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 from gently.core.event_bus import EventType, get_event_bus
 from gently.core.service import Service
@@ -69,7 +69,7 @@ class DeviceStateMonitor(Service):
 
     def __init__(
         self,
-        microscope: "DiSPIMMicroscope",
+        microscope: DiSPIMMicroscope,
         reconnect_delay_sec: float = 3.0,
         stale_timeout_sec: float = DEFAULT_STALE_TIMEOUT_SEC,
         watchdog_interval_sec: float = DEFAULT_WATCHDOG_INTERVAL_SEC,
@@ -79,14 +79,14 @@ def __init__(
         self.reconnect_delay_sec = reconnect_delay_sec
         self.stale_timeout_sec = stale_timeout_sec
         self.watchdog_interval_sec = watchdog_interval_sec
-        self._task: Optional[asyncio.Task] = None
-        self._watchdog_task: Optional[asyncio.Task] = None
+        self._task: asyncio.Task | None = None
+        self._watchdog_task: asyncio.Task | None = None
         self._stop_requested = False
         # Monotonic timestamp of the last successfully-received event. The
         # watchdog reads this; the reader writes it under no lock because
         # asyncio is single-threaded (datetime/float assignment is atomic
         # at the bytecode level on CPython).
-        self._last_event_at: Optional[float] = None
+        self._last_event_at: float | None = None
         # Counts of staleness-triggered reconnects, useful for diagnostics.
         self._watchdog_kicks: int = 0
         # Set by the watchdog right before it cancels the reader task, so
@@ -102,7 +102,8 @@ async def on_start(self):
         self._last_event_at = time.monotonic()
         self._task = asyncio.create_task(self._run(), name="device-state-monitor")
         self._watchdog_task = asyncio.create_task(
-            self._watchdog(), name="device-state-watchdog",
+            self._watchdog(),
+            name="device-state-watchdog",
         )
 
     async def on_stop(self):
@@ -161,7 +162,8 @@ async def _run(self):
             except Exception as exc:
                 logger.debug(
                     "DeviceStateMonitor: stream ended (%s) — reconnecting in %.1fs",
-                    exc, self.reconnect_delay_sec,
+                    exc,
+                    self.reconnect_delay_sec,
                 )
             if self._stop_requested:
                 break
@@ -198,7 +200,9 @@ async def _watchdog(self):
             logger.warning(
                 "DeviceStateMonitor: stale stream (%.1fs since last event > "
                 "%.1fs threshold) — forcing reconnect (kick #%d)",
-                age, self.stale_timeout_sec, self._watchdog_kicks,
+                age,
+                self.stale_timeout_sec,
+                self._watchdog_kicks,
             )
             # Reset the timer FIRST so we don't trigger again before the
             # reader has a chance to reconnect and publish.
diff --git a/gently/app/orchestration/exclusive.py b/gently/app/orchestration/exclusive.py
index 44dc8140..db9804bd 100644
--- a/gently/app/orchestration/exclusive.py
+++ b/gently/app/orchestration/exclusive.py
@@ -16,11 +16,10 @@
 import asyncio
 import logging
 from abc import ABC, abstractmethod
-from collections import deque
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 import numpy as np
 
@@ -30,14 +29,15 @@
 @dataclass
 class ExclusiveResult:
     """Outcome of an ExclusiveAcquisition.run()."""
+
     success: bool
     target_embryo_id: str
     request_id: str
     frames_captured: int = 0
     duration_s: float = 0.0
-    output_path: Optional[str] = None
-    extra: Dict[str, Any] = field(default_factory=dict)
-    error: Optional[str] = None
+    output_path: str | None = None
+    extra: dict[str, Any] = field(default_factory=dict)
+    error: str | None = None
 
 
 class ExclusiveAcquisition(ABC):
@@ -51,17 +51,17 @@ class ExclusiveAcquisition(ABC):
     #: Human-readable kind name, for events / UI / persistence.
     kind: str = "exclusive"
 
-    def __init__(self, target_embryo_id: str, request_id: Optional[str] = None):
+    def __init__(self, target_embryo_id: str, request_id: str | None = None):
         self.target_embryo_id = target_embryo_id
         self.request_id = request_id or _make_request_id(self.kind, target_embryo_id)
 
     @abstractmethod
-    async def run(self, orchestrator) -> ExclusiveResult:
-        ...
+    async def run(self, orchestrator) -> ExclusiveResult: ...
 
 
 def _make_request_id(kind: str, embryo_id: str) -> str:
     import uuid
+
     return f"{kind}_{embryo_id}_{uuid.uuid4().hex[:8]}"
 
 
@@ -97,7 +97,7 @@ def __init__(
         frames: int = 60,
         mode: str = "1hz",
         num_slices: int = 1,
-        request_id: Optional[str] = None,
+        request_id: str | None = None,
     ):
         super().__init__(target_embryo_id=target_embryo_id, request_id=request_id)
         self.frames = frames
@@ -118,12 +118,15 @@ async def run(self, orchestrator) -> ExclusiveResult:
 
         # Phase 10 dedicated burst events (Phase 7 originally rode
         # STATUS_CHANGED; now we have first-class types).
-        orchestrator._emit_event(EventType.BURST_START, {
-            "embryo_id": self.target_embryo_id,
-            "request_id": self.request_id,
-            "frames": self.frames,
-            "mode": self.mode,
-        })
+        orchestrator._emit_event(
+            EventType.BURST_START,
+            {
+                "embryo_id": self.target_embryo_id,
+                "request_id": self.request_id,
+                "frames": self.frames,
+                "mode": self.mode,
+            },
+        )
 
         # Hardware kwargs from the embryo's calibration (mirrors _acquire_embryo)
         cal = embryo.calibration or {}
@@ -171,7 +174,7 @@ async def run(self, orchestrator) -> ExclusiveResult:
                 pass
 
         frames_data = result.get("frames") or []
-        frames_captured: List[np.ndarray] = [
+        frames_captured: list[np.ndarray] = [
             np.asarray(f["volume"]) for f in frames_data if f.get("volume") is not None
         ]
 
@@ -213,14 +216,17 @@ async def run(self, orchestrator) -> ExclusiveResult:
 
         success = bool(result.get("success")) and len(frames_captured) > 0
 
-        orchestrator._emit_event(EventType.BURST_COMPLETE, {
-            "embryo_id": self.target_embryo_id,
-            "request_id": self.request_id,
-            "frames_captured": len(frames_captured),
-            "duration_s": duration_s,
-            "sustained_hz": sustained_hz,
-            "mp4_path": mp4_path,
-        })
+        orchestrator._emit_event(
+            EventType.BURST_COMPLETE,
+            {
+                "embryo_id": self.target_embryo_id,
+                "request_id": self.request_id,
+                "frames_captured": len(frames_captured),
+                "duration_s": duration_s,
+                "sustained_hz": sustained_hz,
+                "mp4_path": mp4_path,
+            },
+        )
 
         return ExclusiveResult(
             success=success,
@@ -248,16 +254,19 @@ async def _progress_ticker(self, orchestrator, frame_event_type):
             await asyncio.sleep(tick_interval)
             elapsed = (datetime.now() - start).total_seconds()
             approx_idx = min(self.frames - 1, int(elapsed / target_dt))
-            orchestrator._emit_event(frame_event_type, {
-                "embryo_id": self.target_embryo_id,
-                "request_id": self.request_id,
-                "frame_idx": approx_idx,
-                "total_frames": self.frames,
-                "approximate": True,
-            })
+            orchestrator._emit_event(
+                frame_event_type,
+                {
+                    "embryo_id": self.target_embryo_id,
+                    "request_id": self.request_id,
+                    "frame_idx": approx_idx,
+                    "total_frames": self.frames,
+                    "approximate": True,
+                },
+            )
 
 
-def _resolve_burst_dir(orchestrator, embryo_id: str, request_id: str) -> Optional[Path]:
+def _resolve_burst_dir(orchestrator, embryo_id: str, request_id: str) -> Path | None:
     """Return ``bursts/{request_id}/`` under the embryo's session folder.
 
     Uses ``FileStore._session_dir`` so the short session_id resolves to the full
@@ -269,7 +278,7 @@ def _resolve_burst_dir(orchestrator, embryo_id: str, request_id: str) -> Optiona
     sid = getattr(orchestrator, "_session_id", None)
     if store is None or sid is None:
         return None
-    session_dir: Optional[Path] = None
+    session_dir: Path | None = None
     for attr in ("_session_dir", "session_dir"):
         fn = getattr(store, attr, None)
         if callable(fn):
@@ -281,7 +290,10 @@ def _resolve_burst_dir(orchestrator, embryo_id: str, request_id: str) -> Optiona
                 break
     if session_dir is None:
         # Last-resort fallback: previous behaviour (will write to the shadow folder).
-        logger.warning("FileStore has no session_dir resolver; falling back to root/sessions/%s", sid)
+        logger.warning(
+            "FileStore has no session_dir resolver; falling back to root/sessions/%s",
+            sid,
+        )
         session_dir = store.root / "sessions" / sid
 
     burst_dir = session_dir / "embryos" / embryo_id / "bursts" / request_id
@@ -297,7 +309,7 @@ def _persist_burst_to_disk(
     request_id: str,
     mode: str,
     frames_requested: int,
-    frames_data: List[Dict[str, Any]],
+    frames_data: list[dict[str, Any]],
     loop_start: datetime,
     duration_s: float,
     sustained_hz: float,
@@ -305,8 +317,8 @@ def _persist_burst_to_disk(
     galvo_center: float,
     piezo_amplitude: float,
     piezo_center: float,
-    laser_power_488_pct: Optional[float],
-) -> Optional[Path]:
+    laser_power_488_pct: float | None,
+) -> Path | None:
     """Save per-frame TIFFs + meta + projections + a burst.yaml manifest.
 
     Best-effort: any per-frame failure is logged and skipped, the rest still
@@ -336,7 +348,7 @@ def _persist_burst_to_disk(
     pos = getattr(embryo, "stage_position", {}) or {}
     sid = getattr(orchestrator, "_session_id", None)
 
-    saved_frames: List[Dict[str, Any]] = []
+    saved_frames: list[dict[str, Any]] = []
     for i, fr in enumerate(frames_data, start=1):
         vol = fr.get("volume")
         if vol is None:
@@ -367,6 +379,7 @@ def _persist_burst_to_disk(
         # Projection via the same helper used for regular volumes.
         try:
             from gently.core.imaging import generate_jpeg_projection
+
             generate_jpeg_projection(arr, proj_path)
         except Exception as exc:
             logger.debug("[%s] burst frame %d projection failed: %s", embryo_id, i, exc)
@@ -380,8 +393,12 @@ def _persist_burst_to_disk(
             "dtype": str(arr.dtype),
             "acquired_at": acquired_at,
             "metadata": {
-                "num_slices": int(getattr(embryo, "num_slices", 1)) if hasattr(embryo, "num_slices") else None,
-                "exposure_ms": float(getattr(embryo, "exposure_ms", 0.0)) if hasattr(embryo, "exposure_ms") else None,
+                "num_slices": int(getattr(embryo, "num_slices", 1))
+                if hasattr(embryo, "num_slices")
+                else None,
+                "exposure_ms": float(getattr(embryo, "exposure_ms", 0.0))
+                if hasattr(embryo, "exposure_ms")
+                else None,
                 "acquisition_mode": "burst",
                 "burst_mode": mode,
                 "laser_power_488_pct": laser_power_488_pct,
@@ -394,12 +411,14 @@ def _persist_burst_to_disk(
                     _yaml.safe_dump(meta, f, sort_keys=False)
             except Exception as exc:
                 logger.debug("[%s] burst frame %d meta write failed: %s", embryo_id, i, exc)
-        saved_frames.append({
-            "frame_index": i,
-            "tif": tif_path.name,
-            "projection": f"projections/{proj_path.name}",
-            "acquired_at": acquired_at,
-        })
+        saved_frames.append(
+            {
+                "frame_index": i,
+                "tif": tif_path.name,
+                "projection": f"projections/{proj_path.name}",
+                "acquired_at": acquired_at,
+            }
+        )
 
     manifest = {
         "request_id": request_id,
@@ -428,18 +447,23 @@ def _persist_burst_to_disk(
         except Exception as exc:
             logger.warning("[%s] burst manifest write failed: %s", embryo_id, exc)
 
-    logger.info("[%s] persisted %d/%d burst frames -> %s",
-                embryo_id, len(saved_frames), frames_requested, burst_dir)
+    logger.info(
+        "[%s] persisted %d/%d burst frames -> %s",
+        embryo_id,
+        len(saved_frames),
+        frames_requested,
+        burst_dir,
+    )
     return burst_dir
 
 
 async def _maybe_generate_mp4(
     *,
-    burst_dir: Optional[Path],
+    burst_dir: Path | None,
     embryo_id: str,
     request_id: str,
-    frames: List[np.ndarray],
-) -> Optional[str]:
+    frames: list[np.ndarray],
+) -> str | None:
     """Best-effort MP4 generation using OpenCV's VideoWriter.
 
     Mirrors the codec-fallback pattern in :mod:`gently.app.video_maker`
@@ -461,7 +485,7 @@ async def _maybe_generate_mp4(
 
         # Reduce 3D frames to 2D max-projections, normalize to uint8, and
         # convert to 3-channel BGR for VideoWriter.
-        proj_frames: List[np.ndarray] = []
+        proj_frames: list[np.ndarray] = []
         for f in frames:
             v = np.squeeze(f)
             if v.ndim == 4:
@@ -483,10 +507,10 @@ async def _maybe_generate_mp4(
 
         height, width = proj_frames[0].shape[:2]
         codecs = (
-            ('mp4v', '.mp4'),
-            ('avc1', '.mp4'),
-            ('XVID', '.avi'),
-            ('MJPG', '.avi'),
+            ("mp4v", ".mp4"),
+            ("avc1", ".mp4"),
+            ("XVID", ".avi"),
+            ("MJPG", ".avi"),
         )
         writer = None
         chosen_codec = None
@@ -511,7 +535,9 @@ async def _maybe_generate_mp4(
         writer.release()
         logger.info(
             "Wrote burst movie: %s (%d frames, codec=%s)",
-            chosen_path, len(proj_frames), chosen_codec,
+            chosen_path,
+            len(proj_frames),
+            chosen_codec,
         )
         return str(chosen_path)
     except Exception as e:
diff --git a/gently/app/orchestration/monitoring_modes.py b/gently/app/orchestration/monitoring_modes.py
index 90f5e555..f84b034e 100644
--- a/gently/app/orchestration/monitoring_modes.py
+++ b/gently/app/orchestration/monitoring_modes.py
@@ -18,8 +18,8 @@
 Activate a mode via ``TimelapseOrchestrator.enable_monitoring_mode(name)``.
 """
 
+from collections.abc import Callable
 from dataclasses import dataclass, field
-from typing import Any, Callable, Dict, List, Optional
 
 
 @dataclass
@@ -31,11 +31,12 @@ class MonitoringMode:
     the active modes so the UI / persistence layer can show what
     anticipation logic is in play.
     """
+
     name: str = ""
     description: str = ""
-    applies_to_roles: List[str] = field(default_factory=list)
+    applies_to_roles: list[str] = field(default_factory=list)
 
-    def activate(self, orchestrator, embryo_ids: Optional[List[str]] = None):
+    def activate(self, orchestrator, embryo_ids: list[str] | None = None):
         """Install the mode's rules / detectors on the orchestrator."""
         raise NotImplementedError
 
@@ -54,6 +55,7 @@ class ExpressionMonitoringMode(MonitoringMode):
 
     Burst on good structure is handled by Phase 7's BurstAcquisition.
     """
+
     fast_interval: float = 60.0
     onset_confirm_timepoints: int = 2
     rampdown_step_pct: float = 1.0
@@ -80,7 +82,7 @@ def __post_init__(self):
         if not self.applies_to_roles:
             self.applies_to_roles = ["test"]
 
-    def activate(self, orchestrator, embryo_ids: Optional[List[str]] = None):
+    def activate(self, orchestrator, embryo_ids: list[str] | None = None):
         orchestrator.add_test_onset_speedup(
             fast_interval=self.fast_interval,
             confirm_timepoints=self.onset_confirm_timepoints,
@@ -108,6 +110,7 @@ class PreTerminalMonitoringMode(MonitoringMode):
     Wraps ``enable_pre_hatching_speedup`` declaratively. Uses the
     organism's PRE_TERMINAL_SPEEDUP_STAGE as the trigger.
     """
+
     fast_interval: float = 30.0
 
     def __post_init__(self):
@@ -119,7 +122,7 @@ def __post_init__(self):
                 f"to {self.fast_interval}s on detection."
             )
 
-    def activate(self, orchestrator, embryo_ids: Optional[List[str]] = None):
+    def activate(self, orchestrator, embryo_ids: list[str] | None = None):
         orchestrator.add_pre_terminal_speedup(fast_interval=self.fast_interval)
 
 
@@ -133,20 +136,20 @@ def __post_init__(self):
         if not self.description:
             self.description = "No active anticipation; standard timelapse cadence."
 
-    def activate(self, orchestrator, embryo_ids: Optional[List[str]] = None):
+    def activate(self, orchestrator, embryo_ids: list[str] | None = None):
         pass
 
 
 # Public registry. ``enable_monitoring_mode(name)`` on the orchestrator
 # looks up by key.
-MONITORING_MODES: Dict[str, Callable[[], MonitoringMode]] = {
+MONITORING_MODES: dict[str, Callable[[], MonitoringMode]] = {
     "idle": IdleMode,
     "expression_monitoring": ExpressionMonitoringMode,
     "pre_terminal_monitoring": PreTerminalMonitoringMode,
 }
 
 
-def get_monitoring_mode(name: str) -> Optional[MonitoringMode]:
+def get_monitoring_mode(name: str) -> MonitoringMode | None:
     """Return an instance of the named monitoring mode, or None if unknown."""
     factory = MONITORING_MODES.get(name)
     if factory is None:
diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index d35768f1..5a22eea0 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -11,37 +11,38 @@
 import asyncio
 import json
 import logging
+import traceback
 from collections import deque
+from collections.abc import Callable
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Optional, Set, TYPE_CHECKING
-import traceback
+from typing import TYPE_CHECKING, Any, Optional
 
 import numpy as np
 
 from gently.core import EventType, get_event_bus
 from gently.core.imaging import (
-    projection_three_view,
-    compute_crop_bounds,
     apply_crop_bounds,
+    compute_crop_bounds,
     image_to_base64,
     normalize_to_uint8,
+    projection_three_view,
 )
-from gently.settings import settings
 from gently.harness.error_log import GlobalErrorLog
+from gently.harness.state import EmbryoState
 from gently.organisms import get_organism
+from gently.settings import settings
 
 # Re-export models for backward compatibility
 from .timelapse_models import (
-    StopConditionType,
+    BurstRule,
     IntervalRule,
     PowerRule,
-    BurstRule,
     StopCondition,
-    TimelapseStatus,
+    StopConditionType,
     TimelapseState,
+    TimelapseStatus,
 )
-from gently.harness.state import EmbryoState
 
 if TYPE_CHECKING:
     from gently.core.file_store import FileStore
@@ -69,8 +70,8 @@ def __init__(
         microscope_client,
         experiment_state,
         perceiver=None,
-        on_volume_callback: Optional[Callable] = None,
-        session_id: Optional[str] = None,
+        on_volume_callback: Callable | None = None,
+        session_id: str | None = None,
         store: Optional["FileStore"] = None,
         claude_client=None,
     ):
@@ -103,11 +104,11 @@ def __init__(
 
         # Trace file storage (writes JSON files to disk)
         self._session_id = session_id
-        self._trace_dir: Optional[Path] = None
+        self._trace_dir: Path | None = None
 
         # Unified store for perception persistence
         self._store = store
-        self._perception_run_id: Optional[int] = None
+        self._perception_run_id: int | None = None
 
         # Event bus for status updates
         self._event_bus = get_event_bus()
@@ -116,20 +117,20 @@ def __init__(
         # Holds references to EmbryoState objects from self.experiment.embryos
         # for embryos currently active in this timelapse. Same objects, no
         # duplication of state.
-        self._embryo_states: Dict[str, EmbryoState] = {}
+        self._embryo_states: dict[str, EmbryoState] = {}
         self._status = TimelapseStatus.IDLE
-        self._started_at: Optional[datetime] = None
+        self._started_at: datetime | None = None
         self._total_timepoints = 0
         self._current_round = 0
-        self._error_message: Optional[str] = None
+        self._error_message: str | None = None
 
         # Round-based scheduling (global timing for all embryos)
         self._base_interval_seconds: float = 120.0
         self._total_pause_duration: timedelta = timedelta(0)
-        self._pause_start: Optional[datetime] = None
+        self._pause_start: datetime | None = None
 
         # Control
-        self._acquisition_task: Optional[asyncio.Task] = None
+        self._acquisition_task: asyncio.Task | None = None
         self._stop_requested = False
 
         # In-flight perception tasks. Acquisition fires perception tasks
@@ -138,59 +139,63 @@ def __init__(
         # not VLM API latency. Tasks are tracked here so (a) stop() can
         # await them before returning and (b) we can cap concurrency if
         # the Claude API rate limit becomes a problem.
-        self._perception_tasks: Set[asyncio.Task] = set()
+        self._perception_tasks: set[asyncio.Task] = set()
 
         # Interval adjustment rules
-        self._interval_rules: List[IntervalRule] = []
-        self._applied_rules: Dict[str, Set[str]] = {}  # embryo_id -> set of applied rule names
-        self._interval_rule_consecutive: Dict[str, Dict[str, int]] = {}  # embryo_id -> {rule_name: consecutive matches}
+        self._interval_rules: list[IntervalRule] = []
+        self._applied_rules: dict[str, set[str]] = {}  # embryo_id -> set of applied rule names
+        self._interval_rule_consecutive: dict[
+            str, dict[str, int]
+        ] = {}  # embryo_id -> {rule_name: consecutive matches}
 
         # Phase 5 reactive control: per-line power rules (sticky-downward
         # ramp on saturation, etc). Evaluated alongside _interval_rules in
         # _check_adaptive_rules / _check_interval_rules.
-        self._power_rules: List[PowerRule] = []
-        self._power_rule_consecutive: Dict[str, Dict[str, int]] = {}  # embryo_id -> {rule_name: count}
+        self._power_rules: list[PowerRule] = []
+        self._power_rule_consecutive: dict[
+            str, dict[str, int]
+        ] = {}  # embryo_id -> {rule_name: count}
 
         # Auto-burst rules: fire queue_burst() once per embryo on a
         # structure/intensity predicate match. One-time semantics are
         # enforced by queue_burst via _burst_applied.
-        self._burst_rules: List[Any] = []  # List[BurstRule] without forward import
-        self._burst_rule_consecutive: Dict[str, Dict[str, int]] = {}
+        self._burst_rules: list[Any] = []  # List[BurstRule] without forward import
+        self._burst_rule_consecutive: dict[str, dict[str, int]] = {}
 
         # Active monitoring modes (declarative anticipation bundles).
-        self._active_monitoring_modes: List[Any] = []
+        self._active_monitoring_modes: list[Any] = []
 
         # Phase 6: calibration data from CalibrationEmbryos. Populated by
         # ``run_calibration_pipelines()``; consumed by _run_detector as
         # detector context["calibration"].
-        self._calibration_data: Optional[Dict[str, Any]] = None
+        self._calibration_data: dict[str, Any] | None = None
 
         # Phase 8: per-role photodose budgets. ``base_dose_budget_ms`` is the
         # ceiling for a 1× role (e.g. test). Other roles get this scaled by
         # their EmbryoRole.photodose_budget_multiplier (e.g. calibration
         # gets 10×). None = no enforcement. See ``set_photodose_budget``.
-        self._dose_budget_base_ms: Optional[float] = None
+        self._dose_budget_base_ms: float | None = None
         # Embryos that have hit the budget — set to paused once, emit a
         # STATUS_CHANGED, then leave alone (don't spam).
-        self._dose_budget_exceeded: Set[str] = set()
+        self._dose_budget_exceeded: set[str] = set()
 
         # Async cadence state (Phase 4). Single-burst exclusion handled by
         # _burst_in_progress: while set to an embryo_id, _run_loop skips
         # all other embryos and runs only the burst executor (Phase 7).
-        self._burst_in_progress: Optional[str] = None
+        self._burst_in_progress: str | None = None
 
         # Phase 7: exclusive acquisitions (bursts, etc) — FIFO queue.
         self._exclusive_queue: deque = deque()
         # Track which embryos have already had a burst applied
         # (one-time per embryo by default).
-        self._burst_applied: Set[str] = set()
+        self._burst_applied: set[str] = set()
 
         # Global error log for cross-embryo hardware error correlation
         self.global_error_log = GlobalErrorLog()
 
     async def start(
         self,
-        embryo_ids: List[str],
+        embryo_ids: list[str],
         stop_condition: str = "manual",
         base_interval_seconds: float = 120.0,
         condition_value: Any = None,
@@ -218,7 +223,10 @@ async def start(
             Status message
         """
         if self._status == TimelapseStatus.RUNNING:
-            return "Timelapse already running. Use stop() first or modify_embryo() to change parameters."
+            return (
+                "Timelapse already running. Use stop() first or modify_embryo() to change"
+                " parameters."
+            )
 
         # Parse stop condition
         stop_cond = self._parse_stop_condition(stop_condition, condition_value)
@@ -286,7 +294,10 @@ async def start(
                     method="vlm_stage_classification",
                     model_name=settings.models.perception,
                     source="live",
-                    config={"stop_condition": stop_condition, "interval": base_interval_seconds},
+                    config={
+                        "stop_condition": stop_condition,
+                        "interval": base_interval_seconds,
+                    },
                 )
                 logger.info(f"Created perception run {self._perception_run_id} in FileStore")
             except Exception as e:
@@ -309,11 +320,14 @@ async def start(
         self._acquisition_task = asyncio.create_task(self._run_loop())
 
         # Emit event
-        self._emit_event(EventType.ACQUISITION_STARTED, {
-            'embryo_ids': embryo_ids,
-            'stop_condition': stop_condition,
-            'interval_seconds': base_interval_seconds,
-        })
+        self._emit_event(
+            EventType.ACQUISITION_STARTED,
+            {
+                "embryo_ids": embryo_ids,
+                "stop_condition": stop_condition,
+                "interval_seconds": base_interval_seconds,
+            },
+        )
 
         logger.info(f"Started timelapse for {len(embryo_ids)} embryos")
 
@@ -324,11 +338,7 @@ async def start(
             f"Use get_timelapse_status to monitor progress."
         )
 
-    def _parse_stop_condition(
-        self,
-        condition: str,
-        value: Any = None
-    ) -> StopCondition:
+    def _parse_stop_condition(self, condition: str, value: Any = None) -> StopCondition:
         """Parse stop condition string into StopCondition object"""
         condition = condition.lower().strip()
 
@@ -399,31 +409,38 @@ def _is_eligible(self, embryo) -> bool:
 
         if self._dose_budget_base_ms is not None and embryo.id not in self._dose_budget_exceeded:
             from gently.harness.roles import REGISTRY as _ROLE_REGISTRY
+
             role_def = _ROLE_REGISTRY.get(getattr(embryo, "role", "test"))
             mult = role_def.photodose_budget_multiplier if role_def else 1.0
             budget = self._dose_budget_base_ms * mult
             if embryo.total_exposure_ms > budget:
                 embryo.cadence_phase = "paused"
                 self._dose_budget_exceeded.add(embryo.id)
-                self._emit_event(EventType.STATUS_CHANGED, {
-                    "embryo_id": embryo.id,
-                    "change": "photodose_budget_exceeded",
-                    "role": embryo.role,
-                    "total_exposure_ms": embryo.total_exposure_ms,
-                    "budget_ms": budget,
-                    "multiplier": mult,
-                })
+                self._emit_event(
+                    EventType.STATUS_CHANGED,
+                    {
+                        "embryo_id": embryo.id,
+                        "change": "photodose_budget_exceeded",
+                        "role": embryo.role,
+                        "total_exposure_ms": embryo.total_exposure_ms,
+                        "budget_ms": budget,
+                        "multiplier": mult,
+                    },
+                )
                 logger.warning(
                     "[%s] photodose budget exceeded: %.0f ms > %.0f ms "
                     "(role=%s, mult=%.1fx). Pausing.",
-                    embryo.id, embryo.total_exposure_ms, budget,
-                    embryo.role, mult,
+                    embryo.id,
+                    embryo.total_exposure_ms,
+                    budget,
+                    embryo.role,
+                    mult,
                 )
                 return False
 
         return True
 
-    def set_photodose_budget(self, base_dose_budget_ms: Optional[float]) -> str:
+    def set_photodose_budget(self, base_dose_budget_ms: float | None) -> str:
         """Set the per-role photodose ceiling.
 
         Each embryo's ``total_exposure_ms`` is checked against
@@ -436,10 +453,7 @@ def set_photodose_budget(self, base_dose_budget_ms: Optional[float]) -> str:
         self._dose_budget_exceeded.clear()
         if base_dose_budget_ms is None:
             return "Photodose budget enforcement disabled."
-        return (
-            f"Photodose budget set: {base_dose_budget_ms:.0f} ms base "
-            f"(scaled per role)."
-        )
+        return f"Photodose budget set: {base_dose_budget_ms:.0f} ms base (scaled per role)."
 
     def _pick_next_due(self) -> tuple:
         """Pick the most-overdue eligible embryo.
@@ -486,10 +500,10 @@ def transition_cadence(
         self,
         embryo,
         *,
-        new_phase: Optional[str] = None,
-        new_interval_seconds: Optional[float] = None,
+        new_phase: str | None = None,
+        new_interval_seconds: float | None = None,
         reschedule: bool = True,
-        reason: Optional[str] = None,
+        reason: str | None = None,
     ) -> None:
         """Public API for cadence transitions (Phase 5 / agent tools use this).
 
@@ -514,23 +528,25 @@ def transition_cadence(
         if reschedule:
             self._reschedule(embryo)
 
-        self._emit_event(EventType.EMBRYO_CADENCE_CHANGED, {
-            "embryo_id": embryo.id,
-            "old_phase": old_phase,
-            "new_phase": embryo.cadence_phase,
-            "old_interval_s": old_interval,
-            "new_interval_s": embryo.interval_seconds,
-            "next_due_at": embryo.next_due_at.isoformat() if embryo.next_due_at else None,
-            "reason": reason,
-        })
+        self._emit_event(
+            EventType.EMBRYO_CADENCE_CHANGED,
+            {
+                "embryo_id": embryo.id,
+                "old_phase": old_phase,
+                "new_phase": embryo.cadence_phase,
+                "old_interval_s": old_interval,
+                "new_interval_s": embryo.interval_seconds,
+                "next_due_at": embryo.next_due_at.isoformat() if embryo.next_due_at else None,
+                "reason": reason,
+            },
+        )
 
     async def _finalize_timelapse(self):
         """Drain perception tasks, log trace count, emit completion event."""
         if self._perception_tasks:
             pending = list(self._perception_tasks)
             logger.info(
-                f"Draining {len(pending)} perception task(s) before "
-                f"completing timelapse..."
+                f"Draining {len(pending)} perception task(s) before completing timelapse..."
             )
             _done, still_pending = await asyncio.wait(pending, timeout=60.0)
             if still_pending:
@@ -549,13 +565,17 @@ async def _finalize_timelapse(self):
 
         self._finalize_perception_run("completed")
 
-        self._emit_event(EventType.ACQUISITION_COMPLETED, {
-            "total_timepoints": self._total_timepoints,
-            "duration_minutes": (
-                (datetime.now() - self._started_at).total_seconds() / 60
-                if self._started_at else 0
-            ),
-        })
+        self._emit_event(
+            EventType.ACQUISITION_COMPLETED,
+            {
+                "total_timepoints": self._total_timepoints,
+                "duration_minutes": (
+                    (datetime.now() - self._started_at).total_seconds() / 60
+                    if self._started_at
+                    else 0
+                ),
+            },
+        )
 
     async def _run_loop(self):
         """Async per-embryo acquisition loop (Phase 4).
@@ -591,7 +611,10 @@ async def _run_loop(self):
                     for eid, e in self._embryo_states.items():
                         if eid == next_op.target_embryo_id:
                             continue
-                        if getattr(e, "cadence_phase", "normal") not in ("burst", "paused"):
+                        if getattr(e, "cadence_phase", "normal") not in (
+                            "burst",
+                            "paused",
+                        ):
                             e.cadence_phase = "paused"
                             paused_ids.append(eid)
                     # Bursting embryo's phase reflects what it's doing.
@@ -605,7 +628,9 @@ async def _run_loop(self):
                     except Exception as e:
                         logger.error(
                             "Exclusive op %s failed: %s",
-                            next_op.request_id, e, exc_info=True,
+                            next_op.request_id,
+                            e,
+                            exc_info=True,
                         )
                     finally:
                         self._burst_in_progress = None
@@ -631,6 +656,7 @@ async def _run_loop(self):
                         # interval; rely on it to reschedule the embryo.
                         if target_emb is not None and target_emb.cadence_phase == "burst":
                             from gently.harness.roles import REGISTRY as _ROLE_REGISTRY
+
                             role_def = _ROLE_REGISTRY.get(target_emb.role)
                             new_interval = (
                                 role_def.default_cadence_seconds
@@ -647,7 +673,8 @@ async def _run_loop(self):
 
                 # All embryos complete?
                 active_count = sum(
-                    1 for e in self._embryo_states.values()
+                    1
+                    for e in self._embryo_states.values()
                     if not e.is_complete and not e.should_skip
                 )
                 if active_count == 0:
@@ -705,9 +732,12 @@ async def _run_loop(self):
             self._status = TimelapseStatus.FAILED
             self._error_message = str(e)
             self._finalize_perception_run("failed", error_message=str(e))
-            self._emit_event(EventType.ACQUISITION_FAILED, {
-                'error': str(e),
-            })
+            self._emit_event(
+                EventType.ACQUISITION_FAILED,
+                {
+                    "error": str(e),
+                },
+            )
 
     async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime = None):
         """Acquire a single volume for one embryo
@@ -730,20 +760,20 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
         try:
             # Move to embryo position
             pos = embryo.stage_position
-            if pos and pos.get('x') is not None:
-                await self.client.move_to_position(pos['x'], pos['y'])
+            if pos and pos.get("x") is not None:
+                await self.client.move_to_position(pos["x"], pos["y"])
 
             # Get calibration parameters
             cal = embryo.calibration or {}
-            galvo_amplitude = cal.get('galvo_amplitude', 0.5)
-            galvo_center = cal.get('galvo_center', 0.0)
-            piezo_amplitude = cal.get('piezo_amplitude', 25.0)
-            piezo_center = cal.get('piezo_center', 50.0)
+            galvo_amplitude = cal.get("galvo_amplitude", 0.5)
+            galvo_center = cal.get("galvo_center", 0.0)
+            piezo_amplitude = cal.get("piezo_amplitude", 25.0)
+            piezo_center = cal.get("piezo_center", 50.0)
 
             # Acquire based on mode (volume or snap)
-            acquisition_mode = getattr(embryo, 'acquisition_mode', 'volume')
+            acquisition_mode = getattr(embryo, "acquisition_mode", "volume")
 
-            if acquisition_mode == 'snap':
+            if acquisition_mode == "snap":
                 # Single 2D lightsheet image
                 result = await self.client.capture_lightsheet_image(
                     piezo_position=piezo_center,
@@ -760,12 +790,12 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
                     galvo_center=galvo_center,
                     piezo_amplitude=piezo_amplitude,
                     piezo_center=piezo_center,
-                    laser_power_488_pct=getattr(embryo, 'laser_power_488_pct', None),
+                    laser_power_488_pct=getattr(embryo, "laser_power_488_pct", None),
                 )
                 num_frames = embryo.num_slices
                 exposure_ms = embryo.exposure_ms
 
-            if result.get('success'):
+            if result.get("success"):
                 # Update state
                 embryo_state.timepoints_acquired += 1
                 embryo_state.error_count = 0
@@ -780,7 +810,7 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
                 embryo.record_exposure(
                     exposure_ms=exposure_ms,
                     num_frames=num_frames,
-                    timestamp=acquisition_timestamp
+                    timestamp=acquisition_timestamp,
                 )
 
                 # Note: VOLUME_ACQUIRED event is emitted by the callback (agent.on_volume_acquired)
@@ -791,17 +821,21 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
                 volume_uids = None  # Track UIDs from storage for perception events
                 if self.on_volume_callback:
                     # Get data - 'volume' for volume mode, 'image' for snap mode
-                    data = result.get('volume') if acquisition_mode == 'volume' else result.get('image')
+                    data = (
+                        result.get("volume")
+                        if acquisition_mode == "volume"
+                        else result.get("image")
+                    )
                     if data is not None:
                         # Ensure data is numpy array
                         if not isinstance(data, np.ndarray):
                             data = np.array(data)
                         # For snap mode (2D), add Z dimension so store_volume works
-                        if acquisition_mode == 'snap' and data.ndim == 2:
+                        if acquisition_mode == "snap" and data.ndim == 2:
                             data = data[np.newaxis, ...]  # Add Z dimension: (Y,X) -> (1,Y,X)
                         volume_data = data
                         # Pass volume_path if available (zero-copy from device)
-                        volume_path = result.get('volume_path')
+                        volume_path = result.get("volume_path")
                         # Callback may return UIDs from storage
                         callback_result = await self.on_volume_callback(
                             embryo_id,
@@ -837,13 +871,11 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
                 # perception - we'll re-check inside _run_perception too)
                 await self._check_stop_condition(embryo_state)
 
-                logger.debug(
-                    f"Acquired t={embryo_state.timepoints_acquired} for {embryo_id}"
-                )
+                logger.debug(f"Acquired t={embryo_state.timepoints_acquired} for {embryo_id}")
 
             else:
                 embryo_state.error_count += 1
-                embryo_state.last_error = result.get('error', 'Unknown error')
+                embryo_state.last_error = result.get("error", "Unknown error")
 
                 # Log to global error log for cross-embryo correlation
                 self.global_error_log.log_error(
@@ -851,7 +883,7 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
                     embryo_id=embryo_id,
                     timepoint=embryo_state.timepoints_acquired,
                     error_type="acquisition",
-                    message=embryo_state.last_error
+                    message=embryo_state.last_error,
                 )
 
                 # Stop after too many errors
@@ -874,7 +906,7 @@ async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime
                 timepoint=embryo_state.timepoints_acquired,
                 error_type="acquisition_exception",
                 message=str(e),
-                exception=e
+                exception=e,
             )
 
     async def _check_stop_condition(self, embryo_state: EmbryoState):
@@ -889,10 +921,13 @@ async def _check_stop_condition(self, embryo_state: EmbryoState):
         # from the role definition), the canonical signature of an
         # embryo that hatched / drifted out of the FOV.
         from gently.harness.roles import REGISTRY as _ROLE_REGISTRY
+
         role = _ROLE_REGISTRY.get(getattr(embryo_state, "role", "test"))
-        if (role is not None
-                and role.no_object_consecutive_terminal is not None
-                and embryo_state.consecutive_no_object >= role.no_object_consecutive_terminal):
+        if (
+            role is not None
+            and role.no_object_consecutive_terminal is not None
+            and embryo_state.consecutive_no_object >= role.no_object_consecutive_terminal
+        ):
             embryo_state.is_complete = True
             embryo_state.completion_reason = (
                 f"no_object x {embryo_state.consecutive_no_object} consecutive "
@@ -900,11 +935,14 @@ async def _check_stop_condition(self, embryo_state: EmbryoState):
                 f"likely hatched / out of FOV)"
             )
             logger.info(f"Embryo {embryo_state.id} stopped: {embryo_state.completion_reason}")
-            self._emit_event(EventType.EMBRYO_TERMINATED, {
-                "embryo_id": embryo_state.id,
-                "completion_reason": embryo_state.completion_reason,
-                "timepoints_acquired": embryo_state.timepoints_acquired,
-            })
+            self._emit_event(
+                EventType.EMBRYO_TERMINATED,
+                {
+                    "embryo_id": embryo_state.id,
+                    "completion_reason": embryo_state.completion_reason,
+                    "timepoints_acquired": embryo_state.timepoints_acquired,
+                },
+            )
             return
 
         # Check all conditions (primary + additional) with OR logic
@@ -914,18 +952,19 @@ async def _check_stop_condition(self, embryo_state: EmbryoState):
                 embryo_state.is_complete = True
                 embryo_state.completion_reason = reason
                 logger.info(f"Embryo {embryo_state.id} stopped: {reason}")
-                self._emit_event(EventType.EMBRYO_TERMINATED, {
-                    "embryo_id": embryo_state.id,
-                    "completion_reason": reason,
-                    "timepoints_acquired": embryo_state.timepoints_acquired,
-                })
+                self._emit_event(
+                    EventType.EMBRYO_TERMINATED,
+                    {
+                        "embryo_id": embryo_state.id,
+                        "completion_reason": reason,
+                        "timepoints_acquired": embryo_state.timepoints_acquired,
+                    },
+                )
                 return  # Stop on first matching condition
 
     def _evaluate_single_condition(
-        self,
-        cond: StopCondition,
-        embryo_state: EmbryoState
-    ) -> Optional[str]:
+        self, cond: StopCondition, embryo_state: EmbryoState
+    ) -> str | None:
         """
         Evaluate a single stop condition.
 
@@ -949,7 +988,8 @@ def _evaluate_single_condition(
             # Stop when every role='test' embryo in the active timelapse
             # has hatched (via Claude detector setting hatching_status).
             test_states = [
-                e for e in self._embryo_states.values()
+                e
+                for e in self._embryo_states.values()
                 if getattr(e, "role", "test") == "test" and not e.should_skip
             ]
             if not test_states:
@@ -960,14 +1000,12 @@ def _evaluate_single_condition(
                 if embryo_state.detection_triggered_at is None:
                     embryo_state.detection_triggered_at = embryo_state.timepoints_acquired
                     embryo_state.detection_type = "all_test_hatched"
-                tps_since = (
-                    embryo_state.timepoints_acquired
-                    - embryo_state.detection_triggered_at
-                )
+                tps_since = embryo_state.timepoints_acquired - embryo_state.detection_triggered_at
                 if tps_since >= cond.confirm_timepoints:
-                    return (
-                        f"all test embryos hatched"
-                        + (f" (+{cond.confirm_timepoints} confirm)" if cond.confirm_timepoints > 0 else "")
+                    return "all test embryos hatched" + (
+                        f" (+{cond.confirm_timepoints} confirm)"
+                        if cond.confirm_timepoints > 0
+                        else ""
                     )
             return None
 
@@ -980,9 +1018,11 @@ def _evaluate_single_condition(
             if elapsed_hours >= cond.value:
                 return f"reached {cond.value}h duration"
 
-        elif cond.condition_type in (StopConditionType.STAGE_BASED,
-                                      StopConditionType.HATCHING,
-                                      StopConditionType.COMMA_STAGE):
+        elif cond.condition_type in (
+            StopConditionType.STAGE_BASED,
+            StopConditionType.HATCHING,
+            StopConditionType.COMMA_STAGE,
+        ):
             # Generic stage-based stop: check if current stage is in target set
             target = cond.target_stages or set()
 
@@ -999,7 +1039,8 @@ def _evaluate_single_condition(
                             logger.info(
                                 f"Target stage '{current_stage}' detected for {embryo_state.id} "
                                 f"at t{embryo_state.timepoints_acquired}, "
-                                f"will acquire {cond.confirm_timepoints} more confirmation timepoints"
+                                f"will acquire {cond.confirm_timepoints} more"
+                                " confirmation timepoints"
                             )
 
                         # Check if we've acquired enough confirmation timepoints
@@ -1019,9 +1060,11 @@ def _evaluate_single_condition(
                     # reports 'hatched'. Session has no is_complete() — we
                     # check terminal-stage membership directly.
                     organism = get_organism()
-                    if (current_stage
-                            and current_stage in organism.TERMINAL_STAGES
-                            and target & organism.TERMINAL_STAGES):
+                    if (
+                        current_stage
+                        and current_stage in organism.TERMINAL_STAGES
+                        and target & organism.TERMINAL_STAGES
+                    ):
                         return f"terminal stage '{current_stage}' reached (perception)"
 
             # Fallback: check legacy hatching_status (for manual marking)
@@ -1029,7 +1072,7 @@ def _evaluate_single_condition(
             if target & organism.TERMINAL_STAGES:
                 embryo = self.experiment.embryos.get(embryo_state.id)
                 if embryo:
-                    hatched_via_status = embryo.hatching_status.get('hatched', False)
+                    hatched_via_status = embryo.hatching_status.get("hatched", False)
                     if hatched_via_status:
                         return "terminal stage detected (manual)"
 
@@ -1054,7 +1097,8 @@ def get_status(self) -> TimelapseState:
 
         if self._status == TimelapseStatus.RUNNING and self._embryo_states:
             due_times = [
-                e.next_due_at for e in self._embryo_states.values()
+                e.next_due_at
+                for e in self._embryo_states.values()
                 if not e.is_complete
                 and not e.should_skip
                 and getattr(e, "cadence_phase", "normal") != "paused"
@@ -1062,9 +1106,7 @@ def get_status(self) -> TimelapseState:
             ]
             if due_times:
                 next_round_time = min(due_times)
-                seconds_until_next = max(
-                    0, (next_round_time - datetime.now()).total_seconds()
-                )
+                seconds_until_next = max(0, (next_round_time - datetime.now()).total_seconds())
 
         return TimelapseState(
             status=self._status,
@@ -1081,7 +1123,7 @@ def get_status(self) -> TimelapseState:
     async def add_embryo(
         self,
         embryo_id: str,
-        stop_condition: Optional[str] = None,
+        stop_condition: str | None = None,
         condition_value: Any = None,
     ) -> str:
         """
@@ -1125,6 +1167,7 @@ async def add_embryo(
         # Add embryo to the timelapse: set runtime fields on its EmbryoState
         # and register the reference in _embryo_states.
         from gently.harness.roles import REGISTRY as ROLE_REGISTRY
+
         embryo = self.experiment.embryos[embryo_id]
         embryo.stop_condition = stop_cond
         embryo.is_complete = False
@@ -1144,8 +1187,7 @@ async def add_embryo(
         elif embryo.interval_seconds is None:
             role_def = ROLE_REGISTRY.get(embryo.role)
             embryo.interval_seconds = (
-                role_def.default_cadence_seconds if role_def is not None
-                else 300.0
+                role_def.default_cadence_seconds if role_def is not None else 300.0
             )
         embryo.cadence_phase = "normal"
         embryo.next_due_at = datetime.now()  # picked up on next loop tick
@@ -1242,7 +1284,9 @@ def modify_interval(self, new_interval_seconds: float) -> str:
 
         logger.info(
             "Broadcast interval: base %ss -> %ss; %d embryos rescheduled",
-            old_base, new_interval_seconds, len(changed),
+            old_base,
+            new_interval_seconds,
+            len(changed),
         )
         return (
             f"Interval changed to {new_interval_seconds}s across "
@@ -1252,7 +1296,7 @@ def modify_interval(self, new_interval_seconds: float) -> str:
     async def modify_embryo(
         self,
         embryo_id: str,
-        stop_condition: Optional[str] = None,
+        stop_condition: str | None = None,
         condition_value: Any = None,
     ) -> str:
         """
@@ -1287,7 +1331,10 @@ async def modify_embryo(
             changes.append(f"stop condition: {stop_condition}")
 
         if not changes:
-            return f"No changes specified for {embryo_id}. Note: use modify_interval() to change acquisition interval."
+            return (
+                f"No changes specified for {embryo_id}."
+                " Note: use modify_interval() to change acquisition interval."
+            )
 
         return f"Modified {embryo_id}: {', '.join(changes)}"
 
@@ -1382,10 +1429,13 @@ async def stop(self, reason: str = "user_request") -> str:
                 "total_timepoints": self._total_timepoints,
                 "embryo_count": len(self._embryo_states),
             },
-            source="timelapse_orchestrator"
+            source="timelapse_orchestrator",
         )
 
-        return f"Timelapse stopped (reason: {reason}). Acquired {self._total_timepoints} total timepoints."
+        return (
+            f"Timelapse stopped (reason: {reason})."
+            f" Acquired {self._total_timepoints} total timepoints."
+        )
 
     async def pause(self) -> str:
         """Pause the timelapse"""
@@ -1427,7 +1477,7 @@ def add_speedup_on_stage(
         self,
         stage_name: str,
         new_interval_seconds: float = 30.0,
-        embryo_ids: Optional[List[str]] = None,
+        embryo_ids: list[str] | None = None,
     ):
         """
         Add a rule to speed up imaging when a stage is reached
@@ -1486,7 +1536,7 @@ def add_test_onset_speedup(
         *,
         fast_interval: float = 60.0,
         confirm_timepoints: int = 2,
-        embryo_ids: Optional[List[str]] = None,
+        embryo_ids: list[str] | None = None,
     ):
         """Install the canonical 'TestEmbryo signal-onset → fast cadence' rule.
 
@@ -1499,7 +1549,8 @@ def add_test_onset_speedup(
         """
         if embryo_ids is None:
             embryo_ids = [
-                eid for eid, e in self._embryo_states.items()
+                eid
+                for eid, e in self._embryo_states.items()
                 if getattr(e, "role", "test") == "test"
             ]
         rule = IntervalRule(
@@ -1512,9 +1563,10 @@ def add_test_onset_speedup(
         )
         self.add_interval_rule(rule)
         logger.info(
-            "Test-onset speedup installed: %ss on signal onset for %s "
-            "(confirm_timepoints=%d)",
-            fast_interval, embryo_ids or "all test embryos", confirm_timepoints,
+            "Test-onset speedup installed: %ss on signal onset for %s (confirm_timepoints=%d)",
+            fast_interval,
+            embryo_ids or "all test embryos",
+            confirm_timepoints,
         )
 
     def add_burst_rule(self, rule):
@@ -1529,7 +1581,7 @@ def add_test_burst_on_good_structure(
         mode: str = "1hz",
         num_slices: int = 1,
         confirm_timepoints: int = 2,
-        embryo_ids: Optional[List[str]] = None,
+        embryo_ids: list[str] | None = None,
     ):
         """Install the canonical 'TestEmbryo stably-bright structure → burst' rule.
 
@@ -1542,7 +1594,8 @@ def add_test_burst_on_good_structure(
         """
         if embryo_ids is None:
             embryo_ids = [
-                eid for eid, e in self._embryo_states.items()
+                eid
+                for eid, e in self._embryo_states.items()
                 if getattr(e, "role", "test") == "test"
             ]
         rule = BurstRule(
@@ -1560,7 +1613,10 @@ def add_test_burst_on_good_structure(
         logger.info(
             "Test-burst rule installed: %d frames @ %s on stable structure for %s "
             "(confirm_timepoints=%d)",
-            frames, mode, embryo_ids or "all test embryos", confirm_timepoints,
+            frames,
+            mode,
+            embryo_ids or "all test embryos",
+            confirm_timepoints,
         )
 
     def add_test_saturation_rampdown(
@@ -1571,7 +1627,7 @@ def add_test_saturation_rampdown(
         floor_pct: float = 2.0,
         ceiling_pct: float = 6.0,
         confirm_timepoints: int = 0,
-        embryo_ids: Optional[List[str]] = None,
+        embryo_ids: list[str] | None = None,
     ):
         """Install the canonical 'TestEmbryo saturation → step laser down' rule.
 
@@ -1583,7 +1639,8 @@ def add_test_saturation_rampdown(
         """
         if embryo_ids is None:
             embryo_ids = [
-                eid for eid, e in self._embryo_states.items()
+                eid
+                for eid, e in self._embryo_states.items()
                 if getattr(e, "role", "test") == "test"
             ]
         rule = PowerRule(
@@ -1602,14 +1659,17 @@ def add_test_saturation_rampdown(
         self.add_power_rule(rule)
         logger.info(
             "Test-saturation rampdown installed: %dnm step=%.2f%% floor=%.2f%% for %s",
-            wavelength, step_pct, floor_pct, embryo_ids or "all test embryos",
+            wavelength,
+            step_pct,
+            floor_pct,
+            embryo_ids or "all test embryos",
         )
 
     # ------------------------------------------------------------------
     # Phase 9: overnight persistence (timelapse.yaml)
     # ------------------------------------------------------------------
 
-    def _session_storage_dir(self) -> Optional[Path]:
+    def _session_storage_dir(self) -> Path | None:
         """Resolve the FileStore-indexed folder for this session.
 
         Falls back to ``<root>/sessions/<session_id>`` (the legacy bare-id
@@ -1624,7 +1684,7 @@ def _session_storage_dir(self) -> Optional[Path]:
             sd = self._store.root / "sessions" / self._session_id
         return sd
 
-    def save_state(self) -> Optional[Path]:
+    def save_state(self) -> Path | None:
         """Write orchestrator runtime state to ``timelapse.yaml``.
 
         Captures per-embryo cadence state, installed rules, burst state,
@@ -1639,6 +1699,7 @@ def save_state(self) -> Optional[Path]:
             return None
         try:
             import yaml
+
             path = sd / "timelapse.yaml"
             path.parent.mkdir(parents=True, exist_ok=True)
             doc = self._serialize_runtime_state()
@@ -1665,6 +1726,7 @@ def load_state(self) -> str:
             return "No session — cannot load state."
         try:
             import yaml
+
             candidates = []
             sd = self._store._session_dir(self._session_id)
             if sd is not None:
@@ -1675,7 +1737,7 @@ def load_state(self) -> str:
             path = next((p for p in candidates if p.exists()), None)
             if path is None:
                 return f"No timelapse.yaml at {candidates[0]}"
-            with open(path, "r", encoding="utf-8") as f:
+            with open(path, encoding="utf-8") as f:
                 doc = yaml.safe_load(f) or {}
         except Exception as e:
             return f"Failed to read timelapse.yaml: {e}"
@@ -1692,8 +1754,9 @@ def load_state(self) -> str:
             f"{len(self._exclusive_queue)} queued bursts"
         )
 
-    def _serialize_runtime_state(self) -> Dict[str, Any]:
+    def _serialize_runtime_state(self) -> dict[str, Any]:
         """Build the timelapse.yaml document."""
+
         def _iso(dt):
             return dt.isoformat() if dt is not None else None
 
@@ -1747,7 +1810,8 @@ def _ser_stop_condition(sc):
 
         def _ser_interval_rule(r):
             return {
-                "name": r.name, "trigger_detector": r.trigger_detector,
+                "name": r.name,
+                "trigger_detector": r.trigger_detector,
                 "trigger_stage": r.trigger_stage,
                 "new_interval_seconds": r.new_interval_seconds,
                 "applies_to": list(r.applies_to) if r.applies_to else None,
@@ -1757,12 +1821,14 @@ def _ser_interval_rule(r):
 
         def _ser_power_rule(r):
             return {
-                "name": r.name, "wavelength": r.wavelength,
+                "name": r.name,
+                "wavelength": r.wavelength,
                 "trigger_detector": r.trigger_detector,
                 "trigger_intensity_levels": list(r.trigger_intensity_levels or []),
                 "trigger_stage": r.trigger_stage,
                 "step_pct": r.step_pct,
-                "floor_pct": r.floor_pct, "ceiling_pct": r.ceiling_pct,
+                "floor_pct": r.floor_pct,
+                "ceiling_pct": r.ceiling_pct,
                 "direction": r.direction,
                 "applies_to": list(r.applies_to) if r.applies_to else None,
                 "confirm_timepoints": r.confirm_timepoints,
@@ -1813,10 +1879,10 @@ def _ser_burst_rule(r):
             "embryos": embryos,
         }
 
-    def _apply_runtime_state(self, doc: Dict[str, Any]) -> None:
+    def _apply_runtime_state(self, doc: dict[str, Any]) -> None:
         """Restore orchestrator state from a parsed timelapse.yaml dict."""
-        from .timelapse_models import IntervalRule, PowerRule, BurstRule, StopCondition
         from .exclusive import BurstAcquisition
+        from .timelapse_models import BurstRule, IntervalRule, PowerRule, StopCondition
 
         def _parse_dt(s):
             if not s:
@@ -1826,7 +1892,9 @@ def _parse_dt(s):
             except (TypeError, ValueError):
                 return None
 
-        self._base_interval_seconds = float(doc.get("base_interval_seconds", self._base_interval_seconds))
+        self._base_interval_seconds = float(
+            doc.get("base_interval_seconds", self._base_interval_seconds)
+        )
         self._current_round = int(doc.get("current_round", self._current_round))
         self._total_timepoints = int(doc.get("total_timepoints", self._total_timepoints))
         self._dose_budget_base_ms = doc.get("dose_budget_base_ms")
@@ -1837,62 +1905,70 @@ def _parse_dt(s):
             self._started_at = started
 
         self._interval_rules = []
-        for r in (doc.get("interval_rules") or []):
-            self._interval_rules.append(IntervalRule(
-                name=r["name"],
-                trigger_detector=r.get("trigger_detector"),
-                trigger_stage=r.get("trigger_stage"),
-                new_interval_seconds=float(r.get("new_interval_seconds", 30.0)),
-                applies_to=r.get("applies_to"),
-                confirm_timepoints=int(r.get("confirm_timepoints", 0)),
-                one_time=bool(r.get("one_time", True)),
-            ))
+        for r in doc.get("interval_rules") or []:
+            self._interval_rules.append(
+                IntervalRule(
+                    name=r["name"],
+                    trigger_detector=r.get("trigger_detector"),
+                    trigger_stage=r.get("trigger_stage"),
+                    new_interval_seconds=float(r.get("new_interval_seconds", 30.0)),
+                    applies_to=r.get("applies_to"),
+                    confirm_timepoints=int(r.get("confirm_timepoints", 0)),
+                    one_time=bool(r.get("one_time", True)),
+                )
+            )
 
         self._power_rules = []
-        for r in (doc.get("power_rules") or []):
-            self._power_rules.append(PowerRule(
-                name=r["name"],
-                wavelength=int(r.get("wavelength", 488)),
-                trigger_detector=r.get("trigger_detector"),
-                trigger_intensity_levels=r.get("trigger_intensity_levels") or None,
-                trigger_stage=r.get("trigger_stage"),
-                step_pct=float(r.get("step_pct", 1.0)),
-                floor_pct=float(r.get("floor_pct", 2.0)),
-                ceiling_pct=float(r.get("ceiling_pct", 6.0)),
-                direction=r.get("direction", "down"),
-                applies_to=r.get("applies_to"),
-                confirm_timepoints=int(r.get("confirm_timepoints", 0)),
-                one_time=bool(r.get("one_time", False)),
-            ))
+        for r in doc.get("power_rules") or []:
+            self._power_rules.append(
+                PowerRule(
+                    name=r["name"],
+                    wavelength=int(r.get("wavelength", 488)),
+                    trigger_detector=r.get("trigger_detector"),
+                    trigger_intensity_levels=r.get("trigger_intensity_levels") or None,
+                    trigger_stage=r.get("trigger_stage"),
+                    step_pct=float(r.get("step_pct", 1.0)),
+                    floor_pct=float(r.get("floor_pct", 2.0)),
+                    ceiling_pct=float(r.get("ceiling_pct", 6.0)),
+                    direction=r.get("direction", "down"),
+                    applies_to=r.get("applies_to"),
+                    confirm_timepoints=int(r.get("confirm_timepoints", 0)),
+                    one_time=bool(r.get("one_time", False)),
+                )
+            )
 
         self._burst_rules = []
-        for r in (doc.get("burst_rules") or []):
-            self._burst_rules.append(BurstRule(
-                name=r["name"],
-                trigger_detector=r.get("trigger_detector"),
-                trigger_intensity_levels=r.get("trigger_intensity_levels") or None,
-                trigger_structure_qualities=r.get("trigger_structure_qualities") or None,
-                frames=int(r.get("frames", 60)),
-                mode=r.get("mode", "1hz"),
-                num_slices=int(r.get("num_slices", 1)),
-                applies_to=r.get("applies_to"),
-                confirm_timepoints=int(r.get("confirm_timepoints", 0)),
-            ))
+        for r in doc.get("burst_rules") or []:
+            self._burst_rules.append(
+                BurstRule(
+                    name=r["name"],
+                    trigger_detector=r.get("trigger_detector"),
+                    trigger_intensity_levels=r.get("trigger_intensity_levels") or None,
+                    trigger_structure_qualities=r.get("trigger_structure_qualities") or None,
+                    frames=int(r.get("frames", 60)),
+                    mode=r.get("mode", "1hz"),
+                    num_slices=int(r.get("num_slices", 1)),
+                    applies_to=r.get("applies_to"),
+                    confirm_timepoints=int(r.get("confirm_timepoints", 0)),
+                )
+            )
 
         self._applied_rules = {
             eid: set(names) for eid, names in (doc.get("applied_rules") or {}).items()
         }
 
         self._exclusive_queue.clear()
-        for op_doc in (doc.get("exclusive_queue") or []):
+        for op_doc in doc.get("exclusive_queue") or []:
             if op_doc.get("kind") == "burst":
-                self._exclusive_queue.append(BurstAcquisition(
-                    target_embryo_id=op_doc["target_embryo_id"],
-                    frames=int(op_doc.get("frames", 60)),
-                    mode=op_doc.get("mode", "1hz"),
-                    num_slices=int(op_doc.get("num_slices", 1)),
-                    request_id=op_doc.get("request_id"),
-                ))
+                self._exclusive_queue.append(
+                    BurstAcquisition(
+                        target_embryo_id=op_doc["target_embryo_id"],
+                        frames=int(op_doc.get("frames", 60)),
+                        mode=op_doc.get("mode", "1hz"),
+                        num_slices=int(op_doc.get("num_slices", 1)),
+                        request_id=op_doc.get("request_id"),
+                    )
+                )
 
         def _deser_stop_condition(d):
             """Rebuild a StopCondition from the dict written by _ser_stop_condition."""
@@ -1905,17 +1981,19 @@ def _deser_stop_condition(d):
                     target_stages=set(d.get("target_stages") or []) or None,
                     confirm_timepoints=int(d.get("confirm_timepoints") or 0),
                 )
-                for ad in (d.get("additional") or []):
-                    primary.add_condition(StopCondition(
-                        condition_type=StopConditionType(ad["condition_type"]),
-                        value=ad.get("value"),
-                        target_stages=set(ad.get("target_stages") or []) or None,
-                        confirm_timepoints=int(ad.get("confirm_timepoints") or 0),
-                    ))
+                for ad in d.get("additional") or []:
+                    primary.add_condition(
+                        StopCondition(
+                            condition_type=StopConditionType(ad["condition_type"]),
+                            value=ad.get("value"),
+                            target_stages=set(ad.get("target_stages") or []) or None,
+                            confirm_timepoints=int(ad.get("confirm_timepoints") or 0),
+                        )
+                    )
                 return primary
             except Exception:
                 # Fall back to spec-string parse if shape changed across versions.
-                spec = (d.get("spec") if isinstance(d, dict) else None)
+                spec = d.get("spec") if isinstance(d, dict) else None
                 if isinstance(spec, str) and spec:
                     try:
                         return StopCondition.parse(spec)
@@ -1930,10 +2008,17 @@ def _deser_stop_condition(d):
             if embryo is None:
                 continue
             for attr in (
-                "cadence_phase", "interval_seconds", "laser_power_488_pct",
-                "total_exposure_ms", "timepoints_acquired", "is_complete",
-                "completion_reason", "should_skip", "skip_reason",
-                "detection_triggered_at", "detection_type",
+                "cadence_phase",
+                "interval_seconds",
+                "laser_power_488_pct",
+                "total_exposure_ms",
+                "timepoints_acquired",
+                "is_complete",
+                "completion_reason",
+                "should_skip",
+                "skip_reason",
+                "detection_triggered_at",
+                "detection_type",
                 "no_object_since_timepoint",
             ):
                 if attr in ed:
@@ -1985,6 +2070,7 @@ def queue_burst(
             If True, queue even if this embryo has already had a burst.
         """
         from .exclusive import BurstAcquisition
+
         if embryo_id not in self._embryo_states:
             return f"Embryo '{embryo_id}' not in active timelapse."
         if not force and embryo_id in self._burst_applied:
@@ -2002,18 +2088,24 @@ def queue_burst(
         )
         self._exclusive_queue.append(op)
         logger.info(
-            "Queued burst for %s: frames=%d mode=%s num_slices=%d request_id=%s "
-            "(queue depth=%d)",
-            embryo_id, frames, mode, num_slices, op.request_id,
+            "Queued burst for %s: frames=%d mode=%s num_slices=%d request_id=%s (queue depth=%d)",
+            embryo_id,
+            frames,
+            mode,
+            num_slices,
+            op.request_id,
             len(self._exclusive_queue),
         )
-        self._emit_event(EventType.BURST_QUEUED, {
-            "embryo_id": embryo_id,
-            "request_id": op.request_id,
-            "position_in_queue": len(self._exclusive_queue),
-            "frames": frames,
-            "mode": mode,
-        })
+        self._emit_event(
+            EventType.BURST_QUEUED,
+            {
+                "embryo_id": embryo_id,
+                "request_id": op.request_id,
+                "position_in_queue": len(self._exclusive_queue),
+                "frames": frames,
+                "mode": mode,
+            },
+        )
         return (
             f"Burst queued for {embryo_id} (request_id={op.request_id}, "
             f"frames={frames}, mode={mode}, queue_depth={len(self._exclusive_queue)})"
@@ -2026,9 +2118,9 @@ def queue_burst(
     def run_calibration_pipelines(
         self,
         *,
-        pipelines: Optional[List[str]] = None,
-        source_volumes: Optional[Dict[str, Any]] = None,
-        embryo_bboxes: Optional[Dict[str, Any]] = None,
+        pipelines: list[str] | None = None,
+        source_volumes: dict[str, Any] | None = None,
+        embryo_bboxes: dict[str, Any] | None = None,
     ) -> str:
         """Run the named calibration pipelines on CalibrationEmbryo volumes
         and merge the result into ``self._calibration_data``.
@@ -2042,7 +2134,8 @@ def run_calibration_pipelines(
         ``edge_bbox`` out and applies them as preprocessing.
         """
         from gently.app.calibration import (
-            get_calibration_pipeline, aggregate_calibrations,
+            aggregate_calibrations,
+            get_calibration_pipeline,
         )
 
         if pipelines is None:
@@ -2062,7 +2155,9 @@ def run_calibration_pipelines(
                 captured.append(data)
                 logger.info(
                     "Calibration pipeline '%s' captured: keys=%s notes=%s",
-                    pname, sorted(data.payload.keys()), data.notes,
+                    pname,
+                    sorted(data.payload.keys()),
+                    data.notes,
                 )
             except Exception as e:
                 logger.warning("Calibration pipeline '%s' failed: %s", pname, e)
@@ -2079,7 +2174,7 @@ def run_calibration_pipelines(
         if sd is not None:
             try:
                 import yaml
-                from pathlib import Path
+
                 cal_dir = sd / "calibration"
                 cal_dir.mkdir(parents=True, exist_ok=True)
                 manifest = {
@@ -2098,6 +2193,7 @@ def run_calibration_pipelines(
                     yaml.safe_dump(manifest, f, sort_keys=False)
                 # Save heavy arrays as .npy
                 import numpy as _np
+
                 for c in captured:
                     for key, value in c.payload.items():
                         if isinstance(value, _np.ndarray):
@@ -2129,6 +2225,7 @@ def enable_expression_monitoring(
         for the declarative form.
         """
         from .monitoring_modes import ExpressionMonitoringMode
+
         mode = ExpressionMonitoringMode(
             name="expression_monitoring",
             description="",
@@ -2145,7 +2242,7 @@ def enable_monitoring_mode(
         self,
         name: str,
         *,
-        embryo_ids: Optional[List[str]] = None,
+        embryo_ids: list[str] | None = None,
         **mode_kwargs,
     ) -> str:
         """Activate a named MonitoringMode from the registry.
@@ -2157,11 +2254,11 @@ def enable_monitoring_mode(
         constructor (e.g. ``fast_interval=30.0``).
         """
         from .monitoring_modes import MONITORING_MODES
+
         factory = MONITORING_MODES.get(name)
         if factory is None:
             return (
-                f"Unknown monitoring mode: {name!r}. "
-                f"Available: {sorted(MONITORING_MODES.keys())}"
+                f"Unknown monitoring mode: {name!r}. Available: {sorted(MONITORING_MODES.keys())}"
             )
         mode = factory(**mode_kwargs) if mode_kwargs else factory()
         mode.activate(self, embryo_ids=embryo_ids)
@@ -2171,10 +2268,10 @@ def enable_monitoring_mode(
     def _check_interval_rules(
         self,
         embryo_id: str,
-        detector_name: Optional[str] = None,
-        stage: Optional[str] = None,
-        intensity_level: Optional[str] = None,
-        structure_quality: Optional[str] = None,
+        detector_name: str | None = None,
+        stage: str | None = None,
+        intensity_level: str | None = None,
+        structure_quality: str | None = None,
     ):
         """
         Evaluate all adaptive rules (interval + power) against a fresh
@@ -2238,36 +2335,46 @@ def _check_interval_rules(
             if prule.wavelength == 488:
                 estate.laser_power_488_pct = new_pct
             # (Future wavelengths: extend EmbryoState similarly.)
-            self._emit_event(EventType.POWER_RAMP_STEP, {
-                "embryo_id": embryo_id,
-                "rule": prule.name,
-                "wavelength": prule.wavelength,
-                "old_pct": current,
-                "new_pct": new_pct,
-                "direction": prule.direction,
-                "intensity_level": intensity_level,
-            })
-            # Discrete trigger-fired event so the strategy view can show
-            # rule firings without inferring them from the power-step event.
-            self._emit_event(EventType.TRIGGER_FIRED, {
-                "embryo_id": embryo_id,
-                "rule_name": prule.name,
-                "rule_kind": "power",
-                "trigger_detector": prule.trigger_detector,
-                "trigger_stage": prule.trigger_stage,
-                "trigger_intensity_level": intensity_level,
-                "applied": {
+            self._emit_event(
+                EventType.POWER_RAMP_STEP,
+                {
+                    "embryo_id": embryo_id,
+                    "rule": prule.name,
                     "wavelength": prule.wavelength,
                     "old_pct": current,
                     "new_pct": new_pct,
                     "direction": prule.direction,
+                    "intensity_level": intensity_level,
                 },
-            })
+            )
+            # Discrete trigger-fired event so the strategy view can show
+            # rule firings without inferring them from the power-step event.
+            self._emit_event(
+                EventType.TRIGGER_FIRED,
+                {
+                    "embryo_id": embryo_id,
+                    "rule_name": prule.name,
+                    "rule_kind": "power",
+                    "trigger_detector": prule.trigger_detector,
+                    "trigger_stage": prule.trigger_stage,
+                    "trigger_intensity_level": intensity_level,
+                    "applied": {
+                        "wavelength": prule.wavelength,
+                        "old_pct": current,
+                        "new_pct": new_pct,
+                        "direction": prule.direction,
+                    },
+                },
+            )
             logger.info(
-                "Applied PowerRule '%s' on %s: %dnm %.2f%% -> %.2f%% "
-                "(direction=%s, intensity=%s)",
-                prule.name, embryo_id, prule.wavelength,
-                current, new_pct, prule.direction, intensity_level,
+                "Applied PowerRule '%s' on %s: %dnm %.2f%% -> %.2f%% (direction=%s, intensity=%s)",
+                prule.name,
+                embryo_id,
+                prule.wavelength,
+                current,
+                new_pct,
+                prule.direction,
+                intensity_level,
             )
 
             if prule.one_time:
@@ -2313,24 +2420,30 @@ def _check_interval_rules(
                 new_interval_seconds=rule.new_interval_seconds,
                 reason=f"rule:{rule.name}",
             )
-            self._emit_event(EventType.TRIGGER_FIRED, {
-                "embryo_id": embryo_id,
-                "rule_name": rule.name,
-                "rule_kind": "interval",
-                "trigger_detector": rule.trigger_detector,
-                "trigger_stage": rule.trigger_stage,
-                "trigger_intensity_level": None,
-                "applied": {
-                    "old_interval_s": old_interval,
-                    "new_interval_s": rule.new_interval_seconds,
-                    "one_time": rule.one_time,
-                    "confirm_timepoints": rule.confirm_timepoints,
+            self._emit_event(
+                EventType.TRIGGER_FIRED,
+                {
+                    "embryo_id": embryo_id,
+                    "rule_name": rule.name,
+                    "rule_kind": "interval",
+                    "trigger_detector": rule.trigger_detector,
+                    "trigger_stage": rule.trigger_stage,
+                    "trigger_intensity_level": None,
+                    "applied": {
+                        "old_interval_s": old_interval,
+                        "new_interval_s": rule.new_interval_seconds,
+                        "one_time": rule.one_time,
+                        "confirm_timepoints": rule.confirm_timepoints,
+                    },
                 },
-            })
+            )
             logger.info(
                 "Applied interval rule '%s' on %s: %ss -> %ss (confirm=%d)",
-                rule.name, embryo_id, old_interval,
-                rule.new_interval_seconds, rule.confirm_timepoints,
+                rule.name,
+                embryo_id,
+                old_interval,
+                rule.new_interval_seconds,
+                rule.confirm_timepoints,
             )
 
             if rule.one_time:
@@ -2370,24 +2483,31 @@ def _check_interval_rules(
                 mode=brule.mode,
                 num_slices=brule.num_slices,
             )
-            self._emit_event(EventType.TRIGGER_FIRED, {
-                "embryo_id": embryo_id,
-                "rule_name": brule.name,
-                "rule_kind": "burst",
-                "trigger_detector": brule.trigger_detector,
-                "trigger_intensity_level": intensity_level,
-                "trigger_structure_quality": structure_quality,
-                "applied": {
-                    "frames": brule.frames,
-                    "mode": brule.mode,
-                    "num_slices": brule.num_slices,
-                    "confirm_timepoints": brule.confirm_timepoints,
-                    "queue_result": result,
+            self._emit_event(
+                EventType.TRIGGER_FIRED,
+                {
+                    "embryo_id": embryo_id,
+                    "rule_name": brule.name,
+                    "rule_kind": "burst",
+                    "trigger_detector": brule.trigger_detector,
+                    "trigger_intensity_level": intensity_level,
+                    "trigger_structure_quality": structure_quality,
+                    "applied": {
+                        "frames": brule.frames,
+                        "mode": brule.mode,
+                        "num_slices": brule.num_slices,
+                        "confirm_timepoints": brule.confirm_timepoints,
+                        "queue_result": result,
+                    },
                 },
-            })
+            )
             logger.info(
                 "Applied burst rule '%s' on %s (intensity=%s structure=%s): %s",
-                brule.name, embryo_id, intensity_level, structure_quality, result,
+                brule.name,
+                embryo_id,
+                intensity_level,
+                structure_quality,
+                result,
             )
 
     def _finalize_perception_run(self, status: str = "completed", error_message: str = None):
@@ -2403,7 +2523,7 @@ def _finalize_perception_run(self, status: str = "completed", error_message: str
             except Exception as e:
                 logger.warning(f"Failed to finalize perception run: {e}")
 
-    def _emit_event(self, event_type: EventType, data: Dict):
+    def _emit_event(self, event_type: EventType, data: dict):
         """Emit event to event bus"""
         self._event_bus.publish(
             event_type=event_type,
@@ -2436,7 +2556,7 @@ def _volume_to_b64(self, volume) -> tuple:
         if view_a.ndim == 3:
             z_depth, height, width = view_a.shape
             if width > height * 2:
-                view_a = view_a[:, :, :width // 2]
+                view_a = view_a[:, :, : width // 2]
             bounds = compute_crop_bounds(view_a)
             cropped = apply_crop_bounds(view_a, bounds)
             three_view_img, _ = projection_three_view(cropped)
@@ -2475,7 +2595,8 @@ async def _run_detector(
         if detector is None:
             logger.warning(
                 "Unknown detector '%s' for embryo %s — skipping detection",
-                detector_name, embryo_id,
+                detector_name,
+                embryo_id,
             )
             return
 
@@ -2503,18 +2624,20 @@ async def _run_detector(
 
         # Mirror onto EmbryoState for the agent's prompt + rule machinery.
         try:
-            embryo_state.cv_analyses.setdefault(detector_name, []).append({
-                "timepoint": timepoint,
-                "intensity_level": intensity_level,
-                "structure_quality": structure_quality,
-                "has_hatched": has_hatched,
-                "reasoning": result.reasoning,
-            })
+            embryo_state.cv_analyses.setdefault(detector_name, []).append(
+                {
+                    "timepoint": timepoint,
+                    "intensity_level": intensity_level,
+                    "structure_quality": structure_quality,
+                    "has_hatched": has_hatched,
+                    "reasoning": result.reasoning,
+                }
+            )
             # Keep a rolling cap so cv_analyses doesn't grow unbounded.
             if len(embryo_state.cv_analyses[detector_name]) > 200:
-                embryo_state.cv_analyses[detector_name] = (
-                    embryo_state.cv_analyses[detector_name][-200:]
-                )
+                embryo_state.cv_analyses[detector_name] = embryo_state.cv_analyses[detector_name][
+                    -200:
+                ]
             # If detector flagged hatched, update legacy field too.
             if has_hatched:
                 embryo_state.hatching_status = {
@@ -2562,7 +2685,9 @@ async def _run_detector(
         elif has_hatched:
             pseudo_stage = "hatched"
         else:
-            pseudo_stage = "no_object" if intensity_level == "NONE" else (intensity_level or "unknown")
+            pseudo_stage = (
+                "no_object" if intensity_level == "NONE" else (intensity_level or "unknown")
+            )
 
         # Track consecutive no_object across roles — drives the role-based
         # terminal stop in _check_stop_condition.
@@ -2617,22 +2742,28 @@ async def _run_detector(
             event_data["projection_uid"] = volume_uids.get("projection_uid")
         self._emit_event(EventType.DETECTOR_EVALUATED, event_data)
         # Dedicated Phase 10 event for the per-detector findings stream.
-        self._emit_event(EventType.CLAUDE_DETECTOR_RESULT, {
-            "embryo_id": embryo_id,
-            "timepoint": timepoint,
-            "detector_name": detector_name,
-            "findings": findings,
-            "reasoning": result.reasoning,
-            "description": description,
-        })
-
-        if has_hatched:
-            self._emit_event(EventType.HATCHING_DETECTED, {
+        self._emit_event(
+            EventType.CLAUDE_DETECTOR_RESULT,
+            {
                 "embryo_id": embryo_id,
                 "timepoint": timepoint,
                 "detector_name": detector_name,
-                "stage": "hatched",
-            })
+                "findings": findings,
+                "reasoning": result.reasoning,
+                "description": description,
+            },
+        )
+
+        if has_hatched:
+            self._emit_event(
+                EventType.HATCHING_DETECTED,
+                {
+                    "embryo_id": embryo_id,
+                    "timepoint": timepoint,
+                    "detector_name": detector_name,
+                    "stage": "hatched",
+                },
+            )
 
         # Drive Phase 5 reactive rules — pass both the pseudo-stage and
         # the detailed findings so rules can match either.
@@ -2646,8 +2777,12 @@ async def _run_detector(
 
         logger.info(
             "[%s] T%d: detector=%s intensity=%s structure=%s hatched=%s",
-            embryo_id, timepoint, detector_name,
-            intensity_level, structure_quality, has_hatched,
+            embryo_id,
+            timepoint,
+            detector_name,
+            intensity_level,
+            structure_quality,
+            has_hatched,
         )
 
     async def _run_perception(
@@ -2672,7 +2807,6 @@ async def _run_perception(
         # ad-hoc detector path; otherwise fall through to the original
         # Perceiver-based flow below.
         from gently.harness.roles import REGISTRY as ROLE_REGISTRY
-        from gently.app.detectors import get_detector
 
         role_def = ROLE_REGISTRY.get(getattr(embryo_state, "role", "test"))
         detector_name = role_def.detector_name if role_def else None
@@ -2696,12 +2830,20 @@ async def _run_perception(
                     (timepoints_since // self.NO_OBJECT_RECHECK_INTERVAL + 1)
                     * self.NO_OBJECT_RECHECK_INTERVAL
                 )
-                self._emit_event(EventType.DETECTOR_EVALUATED, {
-                    'embryo_id': embryo_id, 'timepoint': timepoint,
-                    'detector_name': 'perception', 'stage': 'no_object',
-                    'reasoning': f"Skipped (empty field). Rechecking in {next_recheck - timepoint} timepoints.",
-                    'skipped': True,
-                })
+                self._emit_event(
+                    EventType.DETECTOR_EVALUATED,
+                    {
+                        "embryo_id": embryo_id,
+                        "timepoint": timepoint,
+                        "detector_name": "perception",
+                        "stage": "no_object",
+                        "reasoning": (
+                            f"Skipped (empty field). Rechecking in"
+                            f" {next_recheck - timepoint} timepoints."
+                        ),
+                        "skipped": True,
+                    },
+                )
                 return
             else:
                 logger.info(f"Rechecking no_object embryo {embryo_id} at t={timepoint}")
@@ -2728,7 +2870,9 @@ async def _run_perception(
                     logger.info(f"Embryo {embryo_id} marked as no_object at t={timepoint}")
             else:
                 if embryo_state.no_object_since_timepoint is not None:
-                    logger.info(f"Embryo {embryo_id} object found at t={timepoint}, resuming perception")
+                    logger.info(
+                        f"Embryo {embryo_id} object found at t={timepoint}, resuming perception"
+                    )
                     embryo_state.no_object_since_timepoint = None
                 embryo_state.consecutive_no_object = 0
 
@@ -2762,28 +2906,35 @@ async def _run_perception(
 
             # Build and emit perception event
             event_data = {
-                'embryo_id': embryo_id, 'timepoint': timepoint,
-                'detector_name': 'perception',
-                'stage': result.stage,
-                'reasoning': result.reasoning,
+                "embryo_id": embryo_id,
+                "timepoint": timepoint,
+                "detector_name": "perception",
+                "stage": result.stage,
+                "reasoning": result.reasoning,
             }
             if volume_uids:
-                event_data['volume_uid'] = volume_uids.get('volume_uid')
-                event_data['projection_uid'] = volume_uids.get('projection_uid')
+                event_data["volume_uid"] = volume_uids.get("volume_uid")
+                event_data["projection_uid"] = volume_uids.get("projection_uid")
             if session:
-                event_data['stability'] = session.stability
+                event_data["stability"] = session.stability
                 summary = session.summary()
-                if summary.get('temporal'):
+                if summary.get("temporal"):
                     from dataclasses import asdict
-                    event_data['temporal_analysis'] = asdict(summary['temporal'])
+
+                    event_data["temporal_analysis"] = asdict(summary["temporal"])
 
             self._emit_event(EventType.DETECTOR_EVALUATED, event_data)
 
             if result.stage in ("hatching", "hatched"):
-                self._emit_event(EventType.HATCHING_DETECTED, {
-                    'embryo_id': embryo_id, 'timepoint': timepoint,
-                    'detector_name': 'hatching', 'stage': result.stage,
-                })
+                self._emit_event(
+                    EventType.HATCHING_DETECTED,
+                    {
+                        "embryo_id": embryo_id,
+                        "timepoint": timepoint,
+                        "detector_name": "hatching",
+                        "stage": result.stage,
+                    },
+                )
 
             # Check interval rules based on stage
             self._check_interval_rules(embryo_id=embryo_id, stage=result.stage)
@@ -2800,7 +2951,7 @@ def _write_trace_file(self, embryo_id: str, timepoint: int, trace_data: dict) ->
         """Write perception trace to JSON file."""
         filename = f"{embryo_id}_T{timepoint:04d}.json"
         file_path = self._trace_dir / filename
-        with open(file_path, 'w', encoding='utf-8') as f:
+        with open(file_path, "w", encoding="utf-8") as f:
             json.dump(trace_data, f, indent=2, ensure_ascii=False)
         logger.debug(f"Wrote trace: {file_path.name}")
         return file_path
diff --git a/gently/app/orchestration/timelapse_models.py b/gently/app/orchestration/timelapse_models.py
index c3d46fb5..262d2197 100644
--- a/gently/app/orchestration/timelapse_models.py
+++ b/gently/app/orchestration/timelapse_models.py
@@ -8,18 +8,19 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum
-from typing import Any, Dict, List, Optional, Set
+from typing import Any
 
 from gently.organisms import get_organism
 
 
 class StopConditionType(Enum):
     """Types of stop conditions for embryo acquisition"""
-    MANUAL = "manual"                    # Stop only when user says
-    STAGE_BASED = "stage_based"          # Stop when any of target stages reached
+
+    MANUAL = "manual"  # Stop only when user says
+    STAGE_BASED = "stage_based"  # Stop when any of target stages reached
     FIXED_TIMEPOINTS = "fixed_timepoints"  # Stop after N timepoints
-    DURATION = "duration"                # Stop after X hours
-    ALL_TERMINAL = "all_terminal"        # Stop when all embryos reach terminal stage
+    DURATION = "duration"  # Stop after X hours
+    ALL_TERMINAL = "all_terminal"  # Stop when all embryos reach terminal stage
     # Phase 8: stop when every role='test' embryo has hatched
     # (via the dopaminergic detector setting hatching_status.hatched=True).
     ALL_TEST_HATCHED = "all_test_hatched"
@@ -38,19 +39,20 @@ class IntervalRule:
     ``applies_to`` filters which embryos this rule listens to — it is not a
     fan-out target list.
     """
+
     name: str
-    trigger_detector: Optional[str] = None  # Detector name that triggers this rule
-    trigger_stage: Optional[str] = None     # Stage name that triggers (comma, pretzel, etc.)
-    new_interval_seconds: float = 30.0      # New interval when triggered
-    applies_to: Optional[List[str]] = None  # Embryo IDs this rule listens to (None = all)
-    confirm_timepoints: int = 0             # require N consecutive trigger matches before firing
-    one_time: bool = True                   # Only apply once per embryo
+    trigger_detector: str | None = None  # Detector name that triggers this rule
+    trigger_stage: str | None = None  # Stage name that triggers (comma, pretzel, etc.)
+    new_interval_seconds: float = 30.0  # New interval when triggered
+    applies_to: list[str] | None = None  # Embryo IDs this rule listens to (None = all)
+    confirm_timepoints: int = 0  # require N consecutive trigger matches before firing
+    one_time: bool = True  # Only apply once per embryo
 
     def matches(
         self,
         embryo_id: str,
-        detector_name: Optional[str] = None,
-        stage: Optional[str] = None,
+        detector_name: str | None = None,
+        stage: str | None = None,
     ) -> bool:
         """Check if this rule should trigger"""
         if self.applies_to and embryo_id not in self.applies_to:
@@ -77,25 +79,26 @@ class PowerRule:
     The hard safety limit at DiSPIMLightSource.POWER_LIMITS_PCT is the
     bottom-line bound; this is the soft control on top.
     """
+
     name: str
     wavelength: int = 488
-    trigger_detector: Optional[str] = None
-    trigger_intensity_levels: Optional[List[str]] = None  # e.g. ["SATURATING"]
-    trigger_stage: Optional[str] = None
-    step_pct: float = 1.0           # how much to change per firing
-    floor_pct: float = 2.0          # never go below
-    ceiling_pct: float = 6.0        # never go above
-    direction: str = "down"         # "down" (sticky-downward) or "up"
-    applies_to: Optional[List[str]] = None
-    confirm_timepoints: int = 0     # require N consecutive firings before applying
-    one_time: bool = False          # default: fire repeatedly for ramps
+    trigger_detector: str | None = None
+    trigger_intensity_levels: list[str] | None = None  # e.g. ["SATURATING"]
+    trigger_stage: str | None = None
+    step_pct: float = 1.0  # how much to change per firing
+    floor_pct: float = 2.0  # never go below
+    ceiling_pct: float = 6.0  # never go above
+    direction: str = "down"  # "down" (sticky-downward) or "up"
+    applies_to: list[str] | None = None
+    confirm_timepoints: int = 0  # require N consecutive firings before applying
+    one_time: bool = False  # default: fire repeatedly for ramps
 
     def matches(
         self,
         embryo_id: str,
-        detector_name: Optional[str] = None,
-        stage: Optional[str] = None,
-        intensity_level: Optional[str] = None,
+        detector_name: str | None = None,
+        stage: str | None = None,
+        intensity_level: str | None = None,
     ) -> bool:
         if self.applies_to and embryo_id not in self.applies_to:
             return False
@@ -127,22 +130,23 @@ class BurstRule:
     downstream by ``queue_burst`` (which gates on ``_burst_applied``),
     so this rule doesn't need its own ``one_time`` flag.
     """
+
     name: str
-    trigger_detector: Optional[str] = None
-    trigger_intensity_levels: Optional[List[str]] = None  # AND-combined predicate
-    trigger_structure_qualities: Optional[List[str]] = None  # AND-combined predicate
+    trigger_detector: str | None = None
+    trigger_intensity_levels: list[str] | None = None  # AND-combined predicate
+    trigger_structure_qualities: list[str] | None = None  # AND-combined predicate
     frames: int = 60
-    mode: str = "1hz"        # "1hz" | "asap"
+    mode: str = "1hz"  # "1hz" | "asap"
     num_slices: int = 1
-    applies_to: Optional[List[str]] = None  # listen-filter
+    applies_to: list[str] | None = None  # listen-filter
     confirm_timepoints: int = 0  # require N consecutive matches before firing
 
     def matches(
         self,
         embryo_id: str,
-        detector_name: Optional[str] = None,
-        intensity_level: Optional[str] = None,
-        structure_quality: Optional[str] = None,
+        detector_name: str | None = None,
+        intensity_level: str | None = None,
+        structure_quality: str | None = None,
     ) -> bool:
         if self.applies_to and embryo_id not in self.applies_to:
             return False
@@ -173,29 +177,33 @@ class StopCondition:
     specifies how many additional timepoints to acquire after detection before
     actually stopping - useful to verify the detection is real.
     """
+
     condition_type: StopConditionType
     value: Any = None  # e.g., number of timepoints, hours, etc.
-    target_stages: Optional[Set[str]] = None  # Stages that satisfy STAGE_BASED condition
+    target_stages: set[str] | None = None  # Stages that satisfy STAGE_BASED condition
     confirm_timepoints: int = 0  # Extra timepoints to acquire after detection
-    additional_conditions: List['StopCondition'] = field(default_factory=list)
+    additional_conditions: list["StopCondition"] = field(default_factory=list)
 
-    def add_condition(self, condition: 'StopCondition') -> None:
+    def add_condition(self, condition: "StopCondition") -> None:
         """Add another stop condition (OR logic)."""
         self.additional_conditions.append(condition)
 
-    def all_conditions(self) -> List['StopCondition']:
+    def all_conditions(self) -> list["StopCondition"]:
         """Get all conditions including self (flattened)."""
         return [self] + self.additional_conditions
 
     def describe(self) -> str:
         """Human-readable description of the stop condition(s)."""
-        def _describe_single(cond: 'StopCondition') -> str:
+
+        def _describe_single(cond: "StopCondition") -> str:
             confirm_suffix = f"+{cond.confirm_timepoints}tp" if cond.confirm_timepoints > 0 else ""
             if cond.condition_type == StopConditionType.MANUAL:
                 return "manual"
-            elif cond.condition_type in (StopConditionType.STAGE_BASED,
-                                         StopConditionType.HATCHING,
-                                         StopConditionType.COMMA_STAGE):
+            elif cond.condition_type in (
+                StopConditionType.STAGE_BASED,
+                StopConditionType.HATCHING,
+                StopConditionType.COMMA_STAGE,
+            ):
                 stages_str = ",".join(sorted(cond.target_stages)) if cond.target_stages else "?"
                 return f"stages({stages_str}){confirm_suffix}"
             elif cond.condition_type == StopConditionType.FIXED_TIMEPOINTS:
@@ -214,7 +222,7 @@ def _describe_single(cond: 'StopCondition') -> str:
         return " OR ".join(descriptions)
 
     @classmethod
-    def until_hatching(cls, confirm_timepoints: int = 0) -> 'StopCondition':
+    def until_hatching(cls, confirm_timepoints: int = 0) -> "StopCondition":
         """Stop when hatching is detected (backward-compatible convenience method)."""
         organism = get_organism()
         return cls(
@@ -224,7 +232,7 @@ def until_hatching(cls, confirm_timepoints: int = 0) -> 'StopCondition':
         )
 
     @classmethod
-    def until_comma(cls, confirm_timepoints: int = 0) -> 'StopCondition':
+    def until_comma(cls, confirm_timepoints: int = 0) -> "StopCondition":
         """Stop when comma stage is detected (backward-compatible convenience method)."""
         organism = get_organism()
         return cls(
@@ -234,19 +242,19 @@ def until_comma(cls, confirm_timepoints: int = 0) -> 'StopCondition':
         )
 
     @classmethod
-    def fixed_timepoints(cls, n: int) -> 'StopCondition':
+    def fixed_timepoints(cls, n: int) -> "StopCondition":
         return cls(StopConditionType.FIXED_TIMEPOINTS, value=n)
 
     @classmethod
-    def duration_hours(cls, hours: float) -> 'StopCondition':
+    def duration_hours(cls, hours: float) -> "StopCondition":
         return cls(StopConditionType.DURATION, value=hours)
 
     @classmethod
-    def manual(cls) -> 'StopCondition':
+    def manual(cls) -> "StopCondition":
         return cls(StopConditionType.MANUAL)
 
     @classmethod
-    def all_test_hatched(cls, confirm_timepoints: int = 0) -> 'StopCondition':
+    def all_test_hatched(cls, confirm_timepoints: int = 0) -> "StopCondition":
         """Stop when EVERY role='test' embryo's ``hatching_status.hatched``
         flag is True (set by the dopaminergic detector / Phase 2 path)."""
         return cls(
@@ -255,7 +263,7 @@ def all_test_hatched(cls, confirm_timepoints: int = 0) -> 'StopCondition':
         )
 
     @classmethod
-    def composite(cls, *conditions: 'StopCondition') -> 'StopCondition':
+    def composite(cls, *conditions: "StopCondition") -> "StopCondition":
         """Create a composite stop condition from multiple conditions (OR logic)."""
         if not conditions:
             return cls.manual()
@@ -265,7 +273,7 @@ def composite(cls, *conditions: 'StopCondition') -> 'StopCondition':
         return primary
 
     @classmethod
-    def parse(cls, spec: str) -> 'StopCondition':
+    def parse(cls, spec: str) -> "StopCondition":
         """
         Parse a stop condition specification string.
 
@@ -278,29 +286,30 @@ def parse(cls, spec: str) -> 'StopCondition':
         spec : str
             Specification like "hatching", "duration:10", "hatching|duration:10"
         """
-        def _parse_single(s: str) -> 'StopCondition':
+
+        def _parse_single(s: str) -> "StopCondition":
             s = s.strip().lower()
 
             # Check for confirmation timepoints suffix: "hatching+3" or "comma+5"
             confirm_timepoints = 0
-            if '+' in s:
-                base, confirm_str = s.rsplit('+', 1)
+            if "+" in s:
+                base, confirm_str = s.rsplit("+", 1)
                 try:
                     confirm_timepoints = int(confirm_str)
                     s = base
                 except ValueError:
                     pass
 
-            if s == 'manual':
+            if s == "manual":
                 return cls.manual()
-            elif s in ('all_test_hatched', 'test_hatched'):
+            elif s in ("all_test_hatched", "test_hatched"):
                 return cls.all_test_hatched(confirm_timepoints=confirm_timepoints)
-            elif s.startswith('timepoints:'):
-                n = int(s.split(':')[1])
+            elif s.startswith("timepoints:"):
+                n = int(s.split(":")[1])
                 return cls.fixed_timepoints(n)
-            elif s.startswith('duration:'):
-                hours_str = s.split(':')[1]
-                if hours_str.endswith('h'):
+            elif s.startswith("duration:"):
+                hours_str = s.split(":")[1]
+                if hours_str.endswith("h"):
                     hours_str = hours_str[:-1]
                 hours = float(hours_str)
                 return cls.duration_hours(hours)
@@ -319,7 +328,7 @@ def _parse_single(s: str) -> 'StopCondition':
                     f"{', '.join(organism.STOP_CONDITIONS.keys())}"
                 )
 
-        parts = spec.split('|')
+        parts = spec.split("|")
         conditions = [_parse_single(p) for p in parts]
         return cls.composite(*conditions)
 
@@ -334,6 +343,7 @@ def _parse_single(s: str) -> 'StopCondition':
 
 class TimelapseStatus(Enum):
     """Overall timelapse status"""
+
     IDLE = "idle"
     RUNNING = "running"
     PAUSED = "paused"
@@ -344,41 +354,44 @@ class TimelapseStatus(Enum):
 @dataclass
 class TimelapseState:
     """Current state of the timelapse"""
+
     status: TimelapseStatus
-    started_at: Optional[datetime]
+    started_at: datetime | None
     # Dict of embryo_id -> EmbryoState reference (from agent.experiment.embryos).
     # Typed Any to avoid importing harness/ from models/ (dependency direction).
-    embryos: Dict[str, Any]
+    embryos: dict[str, Any]
     total_timepoints: int = 0
     current_round: int = 0
     interval_seconds: float = 120.0
-    next_round_time: Optional[datetime] = None
-    seconds_until_next_round: Optional[float] = None
-    error_message: Optional[str] = None
+    next_round_time: datetime | None = None
+    seconds_until_next_round: float | None = None
+    error_message: str | None = None
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize for display"""
         active = [e for e in self.embryos.values() if not e.is_complete]
         completed = [e for e in self.embryos.values() if e.is_complete]
 
         return {
-            'status': self.status.value,
-            'started_at': self.started_at.isoformat() if self.started_at else None,
-            'duration_minutes': (datetime.now() - self.started_at).total_seconds() / 60 if self.started_at else 0,
-            'total_timepoints': self.total_timepoints,
-            'current_round': self.current_round,
-            'interval_seconds': self.interval_seconds,
-            'next_round_time': self.next_round_time.isoformat() if self.next_round_time else None,
-            'seconds_until_next_round': self.seconds_until_next_round,
-            'active_embryos': len(active),
-            'completed_embryos': len(completed),
-            'embryo_details': {
+            "status": self.status.value,
+            "started_at": self.started_at.isoformat() if self.started_at else None,
+            "duration_minutes": (datetime.now() - self.started_at).total_seconds() / 60
+            if self.started_at
+            else 0,
+            "total_timepoints": self.total_timepoints,
+            "current_round": self.current_round,
+            "interval_seconds": self.interval_seconds,
+            "next_round_time": self.next_round_time.isoformat() if self.next_round_time else None,
+            "seconds_until_next_round": self.seconds_until_next_round,
+            "active_embryos": len(active),
+            "completed_embryos": len(completed),
+            "embryo_details": {
                 eid: {
-                    'timepoints': e.timepoints_acquired,
-                    'is_complete': e.is_complete,
-                    'completion_reason': e.completion_reason,
+                    "timepoints": e.timepoints_acquired,
+                    "is_complete": e.is_complete,
+                    "completion_reason": e.completion_reason,
                 }
                 for eid, e in self.embryos.items()
             },
-            'error': self.error_message,
+            "error": self.error_message,
         }
diff --git a/gently/app/queue_server_client.py b/gently/app/queue_server_client.py
index 82697639..fbe177b3 100644
--- a/gently/app/queue_server_client.py
+++ b/gently/app/queue_server_client.py
@@ -1,4 +1,9 @@
 """Backward-compatibility shim — client moved to gently.hardware.dispim.client."""
-from gently.hardware.dispim.client import DiSPIMMicroscope, QueueServerClient, create_queue_server_client
 
-__all__ = ['DiSPIMMicroscope', 'QueueServerClient', 'create_queue_server_client']
+from gently.hardware.dispim.client import (
+    DiSPIMMicroscope,
+    QueueServerClient,
+    create_queue_server_client,
+)
+
+__all__ = ["DiSPIMMicroscope", "QueueServerClient", "create_queue_server_client"]
diff --git a/gently/app/theme.py b/gently/app/theme.py
index f8fc96ce..ddb8d8a6 100644
--- a/gently/app/theme.py
+++ b/gently/app/theme.py
@@ -6,12 +6,12 @@
 """
 
 from dataclasses import dataclass
-from typing import Dict
 
 
 @dataclass
 class Theme:
     """Theme definition with colors and text indicators."""
+
     name: str
     color_mode: str  # "dark" or "light"
 
@@ -44,7 +44,7 @@ class Theme:
     icon_system: str = "System"
 
 
-THEMES: Dict[str, Theme] = {
+THEMES: dict[str, Theme] = {
     "vibrant": Theme(
         name="Vibrant",
         color_mode="dark",
@@ -193,6 +193,6 @@ def set_theme(name: str) -> None:
         raise ValueError(f"Unknown theme: '{name}'. Available: {available}")
 
 
-def list_themes() -> Dict[str, Theme]:
+def list_themes() -> dict[str, Theme]:
     """Get all available themes."""
     return THEMES.copy()
diff --git a/gently/app/tools/__init__.py b/gently/app/tools/__init__.py
index 99c91e34..d8ab70db 100644
--- a/gently/app/tools/__init__.py
+++ b/gently/app/tools/__init__.py
@@ -6,34 +6,45 @@
 """
 
 # Import all tool modules to register their tools
-from . import experiment_tools
-from . import stage_tools
-from . import led_tools
-from . import light_source_tools
-from . import temperature_tools
-from . import calibration_tools
-from . import acquisition_tools
-from . import volume_tools
-from . import analysis_tools
-from . import timelapse_tools
-from . import session_tools
-from . import focus_tools
-from . import interaction_tools
-from . import detection_tools
-from . import plan_execution_tools
-from . import memory_tools
-from . import resolution_tools
-from gently.harness.plan_mode.tools import lab_context as _lab_context  # query_lab_history in run mode
-
-# Import tool registry utilities
-from gently.harness.tools.registry import get_tool_registry, ToolCategory
+from gently.harness.plan_mode.tools import (
+    lab_context as _lab_context,  # noqa: F401
+)
 
+# query_lab_history in run mode
 # Re-export helper utilities for convenience
 from gently.harness.tools.helpers import (
-    require_agent, get_embryo_or_error, require_microscope,
-    require_interaction_logger, require_developmental_tracker,
-    require_timelapse_orchestrator, require_databroker,
-    get_timestamp_string, format_duration
+    format_duration,
+    get_embryo_or_error,
+    get_timestamp_string,
+    require_agent,
+    require_databroker,
+    require_developmental_tracker,
+    require_interaction_logger,
+    require_microscope,
+    require_timelapse_orchestrator,
+)
+
+# Import tool registry utilities
+from gently.harness.tools.registry import ToolCategory, get_tool_registry
+
+from . import (
+    acquisition_tools,
+    analysis_tools,
+    calibration_tools,
+    detection_tools,
+    experiment_tools,
+    focus_tools,
+    interaction_tools,
+    led_tools,
+    light_source_tools,
+    memory_tools,
+    plan_execution_tools,
+    resolution_tools,
+    session_tools,
+    stage_tools,
+    temperature_tools,
+    timelapse_tools,
+    volume_tools,
 )
 
 
@@ -48,3 +59,36 @@ def register_all_tools():
 
 # Auto-register on import
 _registered = register_all_tools()
+
+__all__ = [
+    # Helper utilities
+    "format_duration",
+    "get_embryo_or_error",
+    "get_timestamp_string",
+    "require_agent",
+    "require_databroker",
+    "require_developmental_tracker",
+    "require_interaction_logger",
+    "require_microscope",
+    "require_timelapse_orchestrator",
+    # Tool registry
+    "ToolCategory",
+    # Tool modules (imported for registration side effects)
+    "acquisition_tools",
+    "analysis_tools",
+    "calibration_tools",
+    "detection_tools",
+    "experiment_tools",
+    "focus_tools",
+    "interaction_tools",
+    "led_tools",
+    "light_source_tools",
+    "memory_tools",
+    "plan_execution_tools",
+    "resolution_tools",
+    "session_tools",
+    "stage_tools",
+    "temperature_tools",
+    "timelapse_tools",
+    "volume_tools",
+]
diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index 0f429982..d73046c0 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -4,32 +4,40 @@
 Tools for acquiring lightsheet volumes and images from the microscope.
 """
 
-import logging
-from typing import Dict, Optional
 import asyncio
+import logging
 
 import numpy as np
 
-logger = logging.getLogger(__name__)
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import get_embryo_or_error
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
+
+logger = logging.getLogger(__name__)
 
 
 @tool(
     name="acquire_volume",
-    description="""Acquire a single 3D lightsheet volume for a specific embryo. Moves to embryo position and uses its calibration data.
-Use when user wants a full 3D stack of an embryo (e.g., "acquire volume of embryo 1", "take a 3D image").
-Embryo must be calibrated first. Default 50 slices at 10ms exposure takes ~2.5 seconds. Turns laser on during acquisition.
-
-The z_buffer_um parameter can override the calibrated Z range to add more empty space above/below the embryo.
-This is useful for segmentation without needing to recalibrate. Set to None to use calibrated range.""",
+    description="""Acquire a single 3D lightsheet volume for a specific embryo. Moves to embryo
+position and uses its calibration data.
+Use when user wants a full 3D stack of an embryo (e.g., "acquire volume of embryo 1",
+"take a 3D image"). Embryo must be calibrated first. Default 50 slices at 10ms exposure
+takes ~2.5 seconds. Turns laser on during acquisition.
+
+The z_buffer_um parameter can override the calibrated Z range to add more empty space
+above/below the embryo. This is useful for segmentation without needing to recalibrate.
+Set to None to use calibrated range.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
     examples=[
         ToolExample("Acquire volume of embryo 1", {"embryo_id": "embryo_1"}),
-        ToolExample("Take a 3D image of embryo 2 with 80 slices", {"embryo_id": "embryo_2", "num_slices": 80}),
-        ToolExample("Acquire with more Z padding", {"embryo_id": "embryo_1", "z_buffer_um": 20.0}),
+        ToolExample(
+            "Take a 3D image of embryo 2 with 80 slices",
+            {"embryo_id": "embryo_2", "num_slices": 80},
+        ),
+        ToolExample(
+            "Acquire with more Z padding",
+            {"embryo_id": "embryo_1", "z_buffer_um": 20.0},
+        ),
     ],
 )
 async def acquire_volume(
@@ -37,11 +45,11 @@ async def acquire_volume(
     num_slices: int = 50,
     exposure_ms: float = 10.0,
     z_buffer_um: float = None,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Acquire single volume - moves to embryo first, uses calibration"""
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return "Error: No agent context"
@@ -53,22 +61,22 @@ async def acquire_volume(
     try:
         # Move to embryo position first
         pos = embryo.stage_position
-        if pos and pos.get('x') is not None and pos.get('y') is not None:
-            await client.move_to_position(pos['x'], pos['y'])
+        if pos and pos.get("x") is not None and pos.get("y") is not None:
+            await client.move_to_position(pos["x"], pos["y"])
 
         # Get calibration parameters (use defaults if not calibrated)
         cal = embryo.calibration or {}
-        galvo_amplitude = cal.get('galvo_amplitude', 0.5)
-        galvo_center = cal.get('galvo_center', 0.0)
-        piezo_amplitude = cal.get('piezo_amplitude', 25.0)
-        piezo_center = cal.get('piezo_center', 50.0)
+        galvo_amplitude = cal.get("galvo_amplitude", 0.5)
+        galvo_center = cal.get("galvo_center", 0.0)
+        piezo_amplitude = cal.get("piezo_amplitude", 25.0)
+        piezo_center = cal.get("piezo_center", 50.0)
 
         # Override Z range if z_buffer_um is specified
         z_buffer_applied = None
         if z_buffer_um is not None and cal:
             # Get the original embryo extent from calibration
-            calibrated_buffer = cal.get('z_buffer_um', 5.0)  # Old default was 5µm
-            slope = cal.get('slope_um_per_deg', 100.0)
+            calibrated_buffer = cal.get("z_buffer_um", 5.0)  # Old default was 5µm
+            slope = cal.get("slope_um_per_deg", 100.0)
 
             # Calculate additional buffer needed
             additional_buffer_um = z_buffer_um - calibrated_buffer
@@ -90,8 +98,8 @@ async def acquire_volume(
             laser_power_488_pct=embryo.laser_power_488_pct,
         )
 
-        if result.get('success'):
-            volume = result.get('volume')
+        if result.get("success"):
+            volume = result.get("volume")
             timepoint = embryo.timepoints_acquired  # Current timepoint (0-indexed)
 
             # Increment timepoints acquired
@@ -105,10 +113,13 @@ async def acquire_volume(
             if agent.store and agent.session_id:
                 try:
                     from pathlib import Path as _Path
+
                     pos = embryo.stage_position or {}
                     agent.store.register_embryo(
-                        agent.session_id, embryo_id,
-                        position_x=pos.get('x'), position_y=pos.get('y'),
+                        agent.session_id,
+                        embryo_id,
+                        position_x=pos.get("x"),
+                        position_y=pos.get("y"),
                         calibration=embryo.calibration,
                         role=embryo.role,
                     )
@@ -126,17 +137,22 @@ async def acquire_volume(
                             "piezo_center": piezo_center,
                         },
                     }
-                    volume_path_ref = result.get('volume_path')
+                    volume_path_ref = result.get("volume_path")
                     if volume_path_ref is not None:
                         saved_path = agent.store.register_volume(
-                            agent.session_id, embryo_id, timepoint,
+                            agent.session_id,
+                            embryo_id,
+                            timepoint,
                             incoming_path=_Path(volume_path_ref),
                             metadata=acq_metadata,
                             volume_data=volume,
                         )
                     elif volume is not None:
                         saved_path = agent.store.put_volume(
-                            agent.session_id, embryo_id, timepoint, volume,
+                            agent.session_id,
+                            embryo_id,
+                            timepoint,
+                            volume,
                             metadata=acq_metadata,
                         )
                 except Exception as store_err:
@@ -158,23 +174,29 @@ async def acquire_volume(
                         uid=f"volume_{session_prefix}{embryo_id}_t{timepoint:04d}",
                         data_type="volume_projection",
                         metadata={
-                            'embryo_id': embryo_id,
-                            'timepoint': timepoint,
-                            'shape': list(volume.shape) if hasattr(volume, 'shape') else None,
-                            'num_slices': num_slices,
-                            'exposure_ms': exposure_ms,
-                        }
+                            "embryo_id": embryo_id,
+                            "timepoint": timepoint,
+                            "shape": list(volume.shape) if hasattr(volume, "shape") else None,
+                            "num_slices": num_slices,
+                            "exposure_ms": exposure_ms,
+                        },
                     )
                 except Exception as viz_err:
                     logger.warning("Failed to push volume to viz: %s", viz_err)
 
             # Build response
-            shape_str = str(result.get('shape', 'unknown'))
+            shape_str = str(result.get("shape", "unknown"))
             z_info = f" (z_buffer: {z_buffer_applied}\u00b5m)" if z_buffer_applied else ""
             if saved_path:
-                return f"Acquired volume for {embryo.id}{z_info}\nShape: {shape_str}\nSaved: {saved_path}"
+                return (
+                    f"Acquired volume for {embryo.id}{z_info}\nShape: {shape_str}"
+                    f"\nSaved: {saved_path}"
+                )
             else:
-                return f"Acquired volume for {embryo.id}{z_info}\nShape: {shape_str}\n(Volume not saved to disk)"
+                return (
+                    f"Acquired volume for {embryo.id}{z_info}\nShape: {shape_str}"
+                    "\n(Volume not saved to disk)"
+                )
         else:
             return f"Acquisition failed: {result.get('error', 'Unknown error')}"
 
@@ -184,12 +206,15 @@ async def acquire_volume(
 
 @tool(
     name="capture_lightsheet",
-    description="""Capture a single 2D lightsheet fluorescence image at specified piezo/galvo position. Uses 50ms exposure by default.
-Use when user says "take a lightsheet image", "lightsheet snap", or wants to see fluorescence at a specific Z position.
-This is a COMPLETE action - do NOT follow up with acquire_volume unless user explicitly asks for a 3D volume.
+    description="""Capture a single 2D lightsheet fluorescence image at specified piezo/galvo
+position. Uses 50ms exposure by default.
+Use when user says "take a lightsheet image", "lightsheet snap", or wants to see fluorescence
+at a specific Z position. This is a COMPLETE action - do NOT follow up with acquire_volume
+unless user explicitly asks for a 3D volume.
 
-IMPORTANT: Always pass embryo_id when capturing for an embryo. This ensures the image is captured at the correct
-focus position from the embryo's focus_history (set by fine_focus). Without embryo_id, focus may be incorrect.
+IMPORTANT: Always pass embryo_id when capturing for an embryo. This ensures the image is
+captured at the correct focus position from the embryo's focus_history (set by fine_focus).
+Without embryo_id, focus may be incorrect.
 
 The piezo position is determined by priority:
 1. Explicit piezo_position parameter (if provided)
@@ -201,8 +226,14 @@ async def acquire_volume(
     requires_microscope=True,
     examples=[
         ToolExample("Take a lightsheet image of embryo 1", {"embryo_id": "embryo_1"}),
-        ToolExample("Lightsheet snap at specific piezo", {"embryo_id": "embryo_1", "piezo_position": 50.0}),
-        ToolExample("Capture at different galvo", {"embryo_id": "embryo_1", "galvo_position": 0.5}),
+        ToolExample(
+            "Lightsheet snap at specific piezo",
+            {"embryo_id": "embryo_1", "piezo_position": 50.0},
+        ),
+        ToolExample(
+            "Capture at different galvo",
+            {"embryo_id": "embryo_1", "galvo_position": 0.5},
+        ),
     ],
 )
 async def capture_lightsheet(
@@ -210,11 +241,11 @@ async def capture_lightsheet(
     galvo_position: float = 0.0,
     embryo_id: str = None,
     show: bool = True,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Capture and optionally display a single lightsheet image"""
-    client = context.get('client')
-    agent = context.get('agent')
+    client = context.get("client")
+    agent = context.get("agent")
 
     try:
         embryo = None
@@ -224,8 +255,7 @@ async def capture_lightsheet(
             if embryo and embryo.stage_position:
                 # Move stage to embryo's position
                 await client.move_to_position(
-                    x=embryo.stage_position['x'],
-                    y=embryo.stage_position['y']
+                    x=embryo.stage_position["x"], y=embryo.stage_position["y"]
                 )
 
         # Determine piezo position for best focus
@@ -234,17 +264,17 @@ async def capture_lightsheet(
         if piezo_position is None:
             # Check embryo's focus history first (from fine_focus)
             if embryo and embryo.focus_history:
-                    # Try interpolation if we have 2+ points
-                    fit = embryo.get_piezo_galvo_fit()
-                    if fit is not None:
-                        slope, intercept = fit
-                        piezo_position = slope * galvo_position + intercept
-                        focus_source = "interpolated"
-                    else:
-                        # Single point or exact match
-                        piezo_position = embryo.get_focus_at_galvo(galvo_position)
-                        if piezo_position is not None:
-                            focus_source = "focus_history"
+                # Try interpolation if we have 2+ points
+                fit = embryo.get_piezo_galvo_fit()
+                if fit is not None:
+                    slope, intercept = fit
+                    piezo_position = slope * galvo_position + intercept
+                    focus_source = "interpolated"
+                else:
+                    # Single point or exact match
+                    piezo_position = embryo.get_focus_at_galvo(galvo_position)
+                    if piezo_position is not None:
+                        focus_source = "focus_history"
 
             # Fall back to hardware query (unreliable)
             if piezo_position is None:
@@ -252,13 +282,12 @@ async def capture_lightsheet(
                 focus_source = "hardware_query"
 
         result = await client.capture_lightsheet_image(
-            piezo_position=piezo_position,
-            galvo_position=galvo_position
+            piezo_position=piezo_position, galvo_position=galvo_position
         )
 
-        if result.get('success'):
-            image = result.get('image')
-            run_uid = result.get('run_uid', 'unknown')
+        if result.get("success"):
+            image = result.get("image")
+            run_uid = result.get("run_uid", "unknown")
 
             # Update embryo's last_imaged and exposure tracking if specified
             if embryo:
@@ -278,21 +307,32 @@ async def capture_lightsheet(
                 # Display the image
                 from datetime import datetime
                 from pathlib import Path
+
                 timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
                 save_path = f"lightsheet_captures/lightsheet_{timestamp}.jpg"
                 Path("lightsheet_captures").mkdir(exist_ok=True)
 
-                view_result = await client.view_image(
+                await client.view_image(
                     image=image,
                     title=f"Lightsheet: piezo={piezo_position:.2f}um, galvo={galvo_position}V",
                     save_path=save_path,
-                    show=True
+                    show=True,
+                )
+                return (
+                    f"\u2713 Captured lightsheet at piezo={piezo_position:.2f}\u03bcm,"
+                    f" galvo={galvo_position}V{focus_info}\nSaved to: {save_path}"
                 )
-                return f"\u2713 Captured lightsheet at piezo={piezo_position:.2f}\u03bcm, galvo={galvo_position}V{focus_info}\nSaved to: {save_path}"
             elif image is None:
-                return f"\u2713 Lightsheet captured at piezo={piezo_position:.2f}\u03bcm, galvo={galvo_position}V{focus_info} (image not displayed)\nRun UID: {run_uid}"
+                return (
+                    f"\u2713 Lightsheet captured at piezo={piezo_position:.2f}\u03bcm,"
+                    f" galvo={galvo_position}V{focus_info} (image not displayed)"
+                    f"\nRun UID: {run_uid}"
+                )
             else:
-                return f"\u2713 Captured lightsheet at piezo={piezo_position:.2f}\u03bcm, galvo={galvo_position}V{focus_info}"
+                return (
+                    f"\u2713 Captured lightsheet at piezo={piezo_position:.2f}\u03bcm,"
+                    f" galvo={galvo_position}V{focus_info}"
+                )
         else:
             return f"Failed: {result.get('error', 'Unknown error')}"
 
@@ -303,7 +343,8 @@ async def capture_lightsheet(
 @tool(
     name="batch_lightsheet",
     description="""Capture lightsheet images from ALL embryos and show them together in the web UI.
-Use when user says "lightsheet all embryos", "capture all embryos", "show me all embryos in lightsheet".
+Use when user says "lightsheet all embryos", "capture all embryos", "show me all embryos in
+lightsheet".
 Moves to each embryo, captures a lightsheet image, saves it, and pushes it to the
 web viewer (live image strip) for everyone watching. Much more efficient than
 capturing one at a time.""",
@@ -314,13 +355,10 @@ async def capture_lightsheet(
         ToolExample("Capture all embryos", {}),
     ],
 )
-async def batch_lightsheet(
-    galvo_position: float = 0.0,
-    context: Dict = None
-) -> str:
+async def batch_lightsheet(galvo_position: float = 0.0, context: dict = None) -> str:
     """Capture lightsheet images from all embryos and show them in the web UI"""
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent or not client:
         return "Error: Agent or microscope not available"
@@ -334,8 +372,7 @@ async def batch_lightsheet(
     errors = []
 
     active_embryos = [
-        (eid, emb) for eid, emb in agent.experiment.embryos.items()
-        if not emb.should_skip
+        (eid, emb) for eid, emb in agent.experiment.embryos.items() if not emb.should_skip
     ]
 
     if not active_embryos:
@@ -347,8 +384,8 @@ async def batch_lightsheet(
         try:
             # Move to embryo position
             if embryo.stage_position:
-                x = embryo.stage_position.get('x', 0)
-                y = embryo.stage_position.get('y', 0)
+                x = embryo.stage_position.get("x", 0)
+                y = embryo.stage_position.get("y", 0)
                 logger.info("Moving to %s at (%.1f, %.1f)...", embryo_id, x, y)
                 await client.move_to_position(x, y)
                 # Wait for stage to settle
@@ -360,24 +397,28 @@ async def batch_lightsheet(
 
             if embryo.calibration:
                 # Get piezo center
-                if embryo.calibration.get('piezo_center'):
-                    piezo_position = embryo.calibration['piezo_center']
-                elif embryo.calibration.get('focus_position'):
-                    piezo_position = embryo.calibration['focus_position']
+                if embryo.calibration.get("piezo_center"):
+                    piezo_position = embryo.calibration["piezo_center"]
+                elif embryo.calibration.get("focus_position"):
+                    piezo_position = embryo.calibration["focus_position"]
 
                 # Get galvo center (critical for light sheet alignment)
-                if embryo.calibration.get('galvo_center'):
-                    embryo_galvo = embryo.calibration['galvo_center']
+                if embryo.calibration.get("galvo_center"):
+                    embryo_galvo = embryo.calibration["galvo_center"]
 
             # Capture lightsheet
-            logger.info("Capturing %s at piezo=%.1f um, galvo=%.2f...", embryo_id, piezo_position, embryo_galvo)
+            logger.info(
+                "Capturing %s at piezo=%.1f um, galvo=%.2f...",
+                embryo_id,
+                piezo_position,
+                embryo_galvo,
+            )
             result = await client.capture_lightsheet_image(
-                piezo_position=piezo_position,
-                galvo_position=embryo_galvo
+                piezo_position=piezo_position, galvo_position=embryo_galvo
             )
 
-            if result.get('success') and result.get('image') is not None:
-                images.append(result['image'])
+            if result.get("success") and result.get("image") is not None:
+                images.append(result["image"])
                 embryo_ids.append(embryo_id)
                 # Track light exposure (default 50ms)
                 embryo.record_exposure(exposure_ms=50.0, num_frames=1)
@@ -393,12 +434,14 @@ async def batch_lightsheet(
     # Save images
     from datetime import datetime
     from pathlib import Path
+
     timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
     save_dir = Path("lightsheet_captures") / f"batch_{timestamp}"
     save_dir.mkdir(parents=True, exist_ok=True)
 
-    for i, (img, eid) in enumerate(zip(images, embryo_ids)):
+    for _i, (img, eid) in enumerate(zip(images, embryo_ids, strict=False)):
         import tifffile
+
         save_path = save_dir / f"{eid}.tiff"
         tifffile.imwrite(str(save_path), img)
 
@@ -408,10 +451,12 @@ async def batch_lightsheet(
     # They appear in the live viewer / recent strip for everyone watching.
     pushed = 0
     if agent.viz_server is not None:
-        for img, eid in zip(images, embryo_ids):
+        for img, eid in zip(images, embryo_ids, strict=False):
             uid = f"batch_lightsheet_{eid}_{timestamp}"
             agent.push_viz(
-                img, uid, "image",
+                img,
+                uid,
+                "image",
                 {"embryo_id": eid, "source": "batch_lightsheet", "label": eid},
             )
             pushed += 1
diff --git a/gently/app/tools/analysis_tools.py b/gently/app/tools/analysis_tools.py
index ff813ad3..6635d9cb 100644
--- a/gently/app/tools/analysis_tools.py
+++ b/gently/app/tools/analysis_tools.py
@@ -4,10 +4,8 @@
 Tools for analyzing embryo images using Claude Vision.
 """
 
-from typing import Dict, Optional
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
-from gently.harness.tools.helpers import require_agent, get_embryo_or_error
+from gently.harness.tools.helpers import get_embryo_or_error, require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
@@ -19,8 +17,8 @@ async def analyze_volume(
     embryo_id: str,
     analysis_prompt: str,
     use_recent_context: bool = False,
-    timepoint: Optional[int] = None,
-    context: Dict = None
+    timepoint: int | None = None,
+    context: dict = None,
 ) -> str:
     """Analyze embryo volume with Claude Vision"""
     agent, err = require_agent(context)
@@ -36,7 +34,7 @@ async def analyze_volume(
             embryo_id=embryo.id,
             prompt=analysis_prompt,
             use_context=use_recent_context,
-            timepoint=timepoint
+            timepoint=timepoint,
         )
         return result
     except Exception as e:
@@ -60,9 +58,9 @@ async def analyze_volume(
     ],
 )
 def get_recent_perceptions(
-    embryo_id: Optional[str] = None,
+    embryo_id: str | None = None,
     n: int = 5,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Read live per-embryo perception state from the perception sessions.
 
@@ -99,8 +97,9 @@ def _one(eid: str) -> str:
             exp = getattr(temporal, "expected_duration_min", None)
             seg = f"  time in stage: {tmin:.0f} min"
             if exp:
-                seg += (f" (expected ~{exp:.0f} min, "
-                        f"{getattr(temporal, 'overtime_ratio', 0.0):.1f}x)")
+                seg += (
+                    f" (expected ~{exp:.0f} min, {getattr(temporal, 'overtime_ratio', 0.0):.1f}x)"
+                )
             lines.append(seg)
             if getattr(temporal, "is_potentially_arrested", False):
                 lines.append("  ** potentially ARRESTED **")
@@ -112,8 +111,9 @@ def _one(eid: str) -> str:
                 reason = (getattr(o, "reasoning", "") or "").strip().replace("\n", " ")
                 if len(reason) > 160:
                     reason = reason[:159] + "…"
-                lines.append(f"    t{getattr(o, 'timepoint', '?')}: "
-                             f"{getattr(o, 'stage', '?')} - {reason}")
+                lines.append(
+                    f"    t{getattr(o, 'timepoint', '?')}: {getattr(o, 'stage', '?')} - {reason}"
+                )
         return "\n".join(lines)
 
     if embryo_id:
@@ -134,7 +134,7 @@ def _one(eid: str) -> str:
     description="Get summary of all detections across all embryos",
     category=ToolCategory.DETECTION,
 )
-def get_detection_summary(context: Dict) -> str:
+def get_detection_summary(context: dict) -> str:
     """Get detection summary"""
     agent, err = require_agent(context)
     if err:
@@ -148,7 +148,10 @@ def get_detection_summary(context: Dict) -> str:
             for det_name, results in embryo.detection_results.items():
                 if results:
                     latest = results[-1]
-                    lines.append(f"  - {det_name}: {latest.get('detected', False)} at t={latest.get('timepoint', '?')}")
+                    lines.append(
+                        f"  - {det_name}: {latest.get('detected', False)}"
+                        f" at t={latest.get('timepoint', '?')}"
+                    )
             lines.append("")
 
     if len(lines) == 2:
diff --git a/gently/app/tools/calibration_tools.py b/gently/app/tools/calibration_tools.py
index f827b8f8..2220e375 100644
--- a/gently/app/tools/calibration_tools.py
+++ b/gently/app/tools/calibration_tools.py
@@ -6,25 +6,25 @@
 """
 
 import logging
-from typing import Dict, List, Optional, Tuple
 from datetime import datetime
-import json
-import asyncio
 
 logger = logging.getLogger(__name__)
 
-import numpy as np
+import numpy as np  # noqa: E402
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
-from gently.harness.tools.helpers import get_embryo_or_error
-from gently.harness.state import CalibrationPrior
-from gently.analysis.core import AdaptiveSweepState, FitFunction, fit_focus_curve
-from gently.ui.web.plots import (
-    generate_focus_curve_plot,
+from gently.analysis.core import AdaptiveSweepState, FitFunction, fit_focus_curve  # noqa: E402
+from gently.harness.state import CalibrationPrior  # noqa: E402
+from gently.harness.tools.helpers import get_embryo_or_error  # noqa: E402
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool  # noqa: E402
+from gently.ui.web.plots import (  # noqa: E402
     generate_calibration_summary_plot,
-    generate_edge_detection_plot,
+    generate_focus_curve_plot,
+)
+
+from .hardware_common import (  # noqa: E402
+    select_best_view,
+    select_view_and_crop_roi,
 )
-from .hardware_common import select_best_view, crop_to_embryo_roi, select_view_and_crop_roi
 
 
 async def _adaptive_focus_sweep(
@@ -37,7 +37,7 @@ async def _adaptive_focus_sweep(
     session_prior: CalibrationPrior,
     select_best_view,
     calculate_focus_score,
-) -> Tuple[Dict, int]:
+) -> tuple[dict, int]:
     """
     Adaptive focus sweep with early stopping.
 
@@ -79,7 +79,7 @@ async def _adaptive_focus_sweep(
 
     # Adaptive parameters based on prior confidence
     SPARSE_STEP = 5.0  # µm - larger steps for survey
-    DENSE_STEP = 0.5   # µm - fine steps for refinement
+    DENSE_STEP = 0.5  # µm - fine steps for refinement
     DENSE_RANGE = 3.0  # µm - narrow window around peak
     MIN_R_SQUARED = 0.75
 
@@ -90,28 +90,29 @@ async def _adaptive_focus_sweep(
     sparse_range = 15.0  # µm sweep range
 
     logger.info("=== ADAPTIVE %s FOCUS SWEEP at galvo=%.3f deg ===", galvo_name.upper(), galvo_pos)
-    logger.info("Using range: +/-%.1f um (prior: %d calibrations)", sparse_range, session_prior.num_calibrations)
+    logger.info(
+        "Using range: +/-%.1f um (prior: %d calibrations)",
+        sparse_range,
+        session_prior.num_calibrations,
+    )
 
     # --- PHASE 1: SPARSE SURVEY ---
     logger.info("Phase 1: Sparse survey +/-%.1f um, %.1f um steps...", sparse_range, SPARSE_STEP)
 
     sparse_state = AdaptiveSweepState()
     sparse_positions = np.arange(
-        expected_piezo - sparse_range,
-        expected_piezo + sparse_range + SPARSE_STEP,
-        SPARSE_STEP
+        expected_piezo - sparse_range, expected_piezo + sparse_range + SPARSE_STEP, SPARSE_STEP
     )
 
     for piezo in sparse_positions:
         result = await client.capture_lightsheet_image(
-            piezo_position=float(piezo),
-            galvo_position=float(galvo_pos)
+            piezo_position=float(piezo), galvo_position=float(galvo_pos)
         )
-        if result.get('success'):
+        if result.get("success"):
             total_exposures += 1
-        if result.get('success') and result.get('image') is not None:
-            img = select_best_view(result['image'])
-            score = calculate_focus_score(img, algorithm='fft_bandpass')
+        if result.get("success") and result.get("image") is not None:
+            img = select_best_view(result["image"])
+            score = calculate_focus_score(img, algorithm="fft_bandpass")
 
             # Add to adaptive state and check for early stopping
             decision = sparse_state.add_point(float(piezo), float(score))
@@ -123,43 +124,52 @@ async def _adaptive_focus_sweep(
                     uid=f"focus_sparse_{embryo_id}_{galvo_name}_{piezo:.1f}",
                     data_type="focus_sweep",
                     metadata={
-                        'embryo_id': embryo_id,
-                        'sweep': 'sparse',
-                        'galvo_name': galvo_name,
-                        'galvo': float(galvo_pos),
-                        'piezo': float(piezo),
-                        'score': float(score),
-                        'peak_detected': sparse_state.peak_detected,
-                    }
+                        "embryo_id": embryo_id,
+                        "sweep": "sparse",
+                        "galvo_name": galvo_name,
+                        "galvo": float(galvo_pos),
+                        "piezo": float(piezo),
+                        "score": float(score),
+                        "peak_detected": sparse_state.peak_detected,
+                    },
                 )
 
-            if decision['should_stop']:
-                logger.info("Early stop: %s (confidence: %.2f)", decision['reason'], decision['confidence'])
+            if decision["should_stop"]:
+                logger.info(
+                    "Early stop: %s (confidence: %.2f)", decision["reason"], decision["confidence"]
+                )
                 break
 
     sparse_best, sparse_r2 = sparse_state.get_best_position()
-    logger.info("Sparse best: %.1f um (R2=%.3f, %d points)", sparse_best, sparse_r2, len(sparse_state.positions))
+    logger.info(
+        "Sparse best: %.1f um (R2=%.3f, %d points)",
+        sparse_best,
+        sparse_r2,
+        len(sparse_state.positions),
+    )
 
     # --- PHASE 2: DENSE REFINEMENT ---
-    logger.info("Phase 2: Dense refinement +/-%.1f um around %.1f um, %.1f um steps...", DENSE_RANGE, sparse_best, DENSE_STEP)
+    logger.info(
+        "Phase 2: Dense refinement +/-%.1f um around %.1f um, %.1f um steps...",
+        DENSE_RANGE,
+        sparse_best,
+        DENSE_STEP,
+    )
 
     dense_state = AdaptiveSweepState()
     dense_positions = np.arange(
-        sparse_best - DENSE_RANGE,
-        sparse_best + DENSE_RANGE + DENSE_STEP,
-        DENSE_STEP
+        sparse_best - DENSE_RANGE, sparse_best + DENSE_RANGE + DENSE_STEP, DENSE_STEP
     )
 
     for piezo in dense_positions:
         result = await client.capture_lightsheet_image(
-            piezo_position=float(piezo),
-            galvo_position=float(galvo_pos)
+            piezo_position=float(piezo), galvo_position=float(galvo_pos)
         )
-        if result.get('success'):
+        if result.get("success"):
             total_exposures += 1
-        if result.get('success') and result.get('image') is not None:
-            img = select_best_view(result['image'])
-            score = calculate_focus_score(img, algorithm='fft_bandpass')
+        if result.get("success") and result.get("image") is not None:
+            img = select_best_view(result["image"])
+            score = calculate_focus_score(img, algorithm="fft_bandpass")
 
             # Add to adaptive state and check for early stopping
             decision = dense_state.add_point(float(piezo), float(score))
@@ -173,18 +183,20 @@ async def _adaptive_focus_sweep(
                     uid=f"focus_dense_{embryo_id}_{galvo_name}_{piezo:.1f}",
                     data_type="focus_sweep",
                     metadata={
-                        'embryo_id': embryo_id,
-                        'sweep': 'dense',
-                        'galvo_name': galvo_name,
-                        'galvo': float(galvo_pos),
-                        'piezo': float(piezo),
-                        'score': float(score),
-                        'r_squared': dense_state.current_r_squared,
-                    }
+                        "embryo_id": embryo_id,
+                        "sweep": "dense",
+                        "galvo_name": galvo_name,
+                        "galvo": float(galvo_pos),
+                        "piezo": float(piezo),
+                        "score": float(score),
+                        "r_squared": dense_state.current_r_squared,
+                    },
                 )
 
-            if decision['should_stop']:
-                logger.info("Early stop: %s (confidence: %.2f)", decision['reason'], decision['confidence'])
+            if decision["should_stop"]:
+                logger.info(
+                    "Early stop: %s (confidence: %.2f)", decision["reason"], decision["confidence"]
+                )
                 break
 
     # Get final result
@@ -196,9 +208,7 @@ async def _adaptive_focus_sweep(
         try:
             positions = np.array(dense_state.positions)
             scores = np.array(dense_state.scores)
-            _, _, params, r_squared = fit_focus_curve(
-                positions, scores, FitFunction.GAUSSIAN.value
-            )
+            _, _, params, r_squared = fit_focus_curve(positions, scores, FitFunction.GAUSSIAN.value)
             if r_squared >= 0.5:
                 best_piezo = float(params[1])
                 best_piezo = max(min(best_piezo, positions.max()), positions.min())
@@ -214,15 +224,20 @@ async def _adaptive_focus_sweep(
         fit_quality = "fallback"
 
     logger.info("Best focus: piezo=%.2f um (R2=%.3f, %s)", best_piezo, r_squared, fit_quality)
-    logger.info("Total exposures: %d (sparse: %d, dense: %d)", total_exposures, len(sparse_state.positions), len(dense_state.positions))
+    logger.info(
+        "Total exposures: %d (sparse: %d, dense: %d)",
+        total_exposures,
+        len(sparse_state.positions),
+        len(dense_state.positions),
+    )
 
     # Build result dict
     result_dict = {
-        'galvo': galvo_pos,
-        'piezo': best_piezo,
-        'max_score': float(max(dense_state.scores)) if dense_state.scores else 0.0,
-        'r_squared': r_squared,
-        'fit_params': None,  # Will be set by focus curve plot generation
+        "galvo": galvo_pos,
+        "piezo": best_piezo,
+        "max_score": float(max(dense_state.scores)) if dense_state.scores else 0.0,
+        "r_squared": r_squared,
+        "fit_params": None,  # Will be set by focus curve plot generation
     }
 
     # Push focus curve plot
@@ -232,7 +247,7 @@ async def _adaptive_focus_sweep(
             scores = np.array(dense_state.scores)
             try:
                 _, _, fit_params, _ = fit_focus_curve(positions, scores, FitFunction.GAUSSIAN.value)
-                result_dict['fit_params'] = fit_params
+                result_dict["fit_params"] = fit_params
             except Exception:
                 fit_params = None
 
@@ -242,21 +257,21 @@ async def _adaptive_focus_sweep(
                 best_position=best_piezo,
                 fit_params=fit_params,
                 r_squared=r_squared,
-                title=f'{embryo_id} - {galvo_name.upper()} Focus Curve (Adaptive)',
+                title=f"{embryo_id} - {galvo_name.upper()} Focus Curve (Adaptive)",
             )
             agent.push_viz(
                 array=plot_img,
                 uid=f"focus_curve_{embryo_id}_{galvo_name}",
                 data_type="focus_plot",
                 metadata={
-                    'embryo_id': embryo_id,
-                    'galvo_name': galvo_name,
-                    'galvo': float(galvo_pos),
-                    'best_piezo': best_piezo,
-                    'r_squared': r_squared,
-                    'adaptive': True,
-                    'exposures': total_exposures,
-                }
+                    "embryo_id": embryo_id,
+                    "galvo_name": galvo_name,
+                    "galvo": float(galvo_pos),
+                    "best_piezo": best_piezo,
+                    "r_squared": r_squared,
+                    "adaptive": True,
+                    "exposures": total_exposures,
+                },
             )
         except Exception as plot_err:
             logger.warning("Failed to generate focus plot: %s", plot_err)
@@ -273,7 +288,7 @@ async def _fine_focus_sweep(
     expected_piezo: float,
     select_best_view,
     calculate_focus_score,
-) -> Tuple[Dict, int]:
+) -> tuple[dict, int]:
     """
     Fine-only focus sweep - assumes heuristic is close.
 
@@ -305,31 +320,33 @@ async def _fine_focus_sweep(
         (result_dict, total_exposures)
         result_dict has 'galvo', 'piezo', 'max_score', 'r_squared', 'fit_params'
     """
-    FINE_RANGE = 5.0   # ±5µm around expected
-    FINE_STEP = 0.5    # 0.5µm steps
+    FINE_RANGE = 5.0  # ±5µm around expected
+    FINE_STEP = 0.5  # 0.5µm steps
     MIN_R_SQUARED = 0.75
     total_exposures = 0
 
     logger.info("=== FINE-ONLY %s FOCUS SWEEP at galvo=%.3f deg ===", galvo_name.upper(), galvo_pos)
-    logger.info("Sweeping +/-%.1f um around heuristic (%.1f um), %.1f um steps...", FINE_RANGE, expected_piezo, FINE_STEP)
+    logger.info(
+        "Sweeping +/-%.1f um around heuristic (%.1f um), %.1f um steps...",
+        FINE_RANGE,
+        expected_piezo,
+        FINE_STEP,
+    )
 
     positions = np.arange(
-        expected_piezo - FINE_RANGE,
-        expected_piezo + FINE_RANGE + FINE_STEP,
-        FINE_STEP
+        expected_piezo - FINE_RANGE, expected_piezo + FINE_RANGE + FINE_STEP, FINE_STEP
     )
 
     piezo_scores = []
     for piezo in positions:
         result = await client.capture_lightsheet_image(
-            piezo_position=float(piezo),
-            galvo_position=float(galvo_pos)
+            piezo_position=float(piezo), galvo_position=float(galvo_pos)
         )
-        if result.get('success'):
+        if result.get("success"):
             total_exposures += 1
-        if result.get('success') and result.get('image') is not None:
-            img = select_best_view(result['image'])
-            score = calculate_focus_score(img, algorithm='fft_bandpass')
+        if result.get("success") and result.get("image") is not None:
+            img = select_best_view(result["image"])
+            score = calculate_focus_score(img, algorithm="fft_bandpass")
             piezo_scores.append((float(piezo), float(score)))
 
             logger.debug("piezo=%.1f: score=%.2e", piezo, score)
@@ -341,13 +358,13 @@ async def _fine_focus_sweep(
                     uid=f"focus_fine_{embryo_id}_{galvo_name}_{piezo:.1f}",
                     data_type="focus_sweep",
                     metadata={
-                        'embryo_id': embryo_id,
-                        'sweep': 'fine_only',
-                        'galvo_name': galvo_name,
-                        'galvo': float(galvo_pos),
-                        'piezo': float(piezo),
-                        'score': float(score),
-                    }
+                        "embryo_id": embryo_id,
+                        "sweep": "fine_only",
+                        "galvo_name": galvo_name,
+                        "galvo": float(galvo_pos),
+                        "piezo": float(piezo),
+                        "score": float(score),
+                    },
                 )
 
     # Fit Gaussian to find peak
@@ -392,11 +409,11 @@ async def _fine_focus_sweep(
 
     # Build result dict
     result_dict = {
-        'galvo': galvo_pos,
-        'piezo': best_piezo,
-        'max_score': max_score,
-        'r_squared': r_squared,
-        'fit_params': fit_params,
+        "galvo": galvo_pos,
+        "piezo": best_piezo,
+        "max_score": max_score,
+        "r_squared": r_squared,
+        "fit_params": fit_params,
     }
 
     # Push focus curve plot
@@ -411,21 +428,21 @@ async def _fine_focus_sweep(
                 best_position=best_piezo,
                 fit_params=fit_params,
                 r_squared=r_squared,
-                title=f'{embryo_id} - {galvo_name.upper()} Focus Curve (Fine-Only)',
+                title=f"{embryo_id} - {galvo_name.upper()} Focus Curve (Fine-Only)",
             )
             agent.push_viz(
                 array=plot_img,
                 uid=f"focus_curve_{embryo_id}_{galvo_name}",
                 data_type="focus_plot",
                 metadata={
-                    'embryo_id': embryo_id,
-                    'galvo_name': galvo_name,
-                    'galvo': float(galvo_pos),
-                    'best_piezo': best_piezo,
-                    'r_squared': r_squared,
-                    'fine_only': True,
-                    'exposures': total_exposures,
-                }
+                    "embryo_id": embryo_id,
+                    "galvo_name": galvo_name,
+                    "galvo": float(galvo_pos),
+                    "best_piezo": best_piezo,
+                    "r_squared": r_squared,
+                    "fine_only": True,
+                    "exposures": total_exposures,
+                },
             )
         except Exception as plot_err:
             logger.warning("Failed to generate focus plot: %s", plot_err)
@@ -437,14 +454,15 @@ async def _fine_focus_sweep(
 # FAST CALIBRATION ALGORITHM (Vision-Guided)
 # ============================================================================
 
+
 async def hybrid_focus_selection(
-    images: List[np.ndarray],
-    offsets: List[float],
+    images: list[np.ndarray],
+    offsets: list[float],
     claude_vision,
     agent,
     embryo_id: str,
-    fft_confidence_threshold: float = 0.85
-) -> Tuple[int, str, float]:
+    fft_confidence_threshold: float = 0.85,
+) -> tuple[int, str, float]:
     """
     Two-stage focus selection: FFT first, Vision if ambiguous.
 
@@ -475,7 +493,7 @@ async def hybrid_focus_selection(
     from gently.analysis.core import calculate_focus_score
 
     # Stage 1: FFT scoring (instant)
-    scores = [calculate_focus_score(img, 'fft_bandpass') for img in images]
+    scores = [calculate_focus_score(img, "fft_bandpass") for img in images]
     max_score = max(scores)
     best_idx = scores.index(max_score)
 
@@ -484,27 +502,29 @@ async def hybrid_focus_selection(
     sorted_ratios = sorted(score_ratios, reverse=True)
     second_best_ratio = sorted_ratios[1] if len(sorted_ratios) > 1 else 0
 
-    confidence_ratio = 1.0 / second_best_ratio if second_best_ratio > 0 else float('inf')
+    confidence_ratio = 1.0 / second_best_ratio if second_best_ratio > 0 else float("inf")
 
     if second_best_ratio < fft_confidence_threshold:
         # FFT is confident - best is >15% better than second
         logger.info("FFT confident: position %d (ratio %.2f)", best_idx, confidence_ratio)
-        return best_idx, 'fft', confidence_ratio
+        return best_idx, "fft", confidence_ratio
 
     # Stage 2: FFT ambiguous - ask Vision
     logger.info("FFT ambiguous (ratio %.2f), consulting Vision...", confidence_ratio)
 
     import tempfile
     from pathlib import Path
+
     from PIL import Image
+
     from gently.analysis.core import create_focus_montage
 
     # Create montage
-    labels = [chr(ord('A') + i) for i in range(len(images))]
+    labels = [chr(ord("A") + i) for i in range(len(images))]
     montage = create_focus_montage(images, labels=labels, offsets=offsets)
 
     # Save to temp file
-    with tempfile.NamedTemporaryFile(suffix='.png', delete=False) as f:
+    with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f:
         montage_path = Path(f.name)
         Image.fromarray(montage).save(montage_path)
 
@@ -522,15 +542,15 @@ async def hybrid_focus_selection(
                 uid=f"focus_montage_{embryo_id}",
                 data_type="focus_montage",
                 metadata={
-                    'embryo_id': embryo_id,
-                    'offsets': offsets,
-                    'fft_scores': scores,
-                    'vision_pick': vision_label,
-                    'reasoning': reasoning,
-                }
+                    "embryo_id": embryo_id,
+                    "offsets": offsets,
+                    "fft_scores": scores,
+                    "vision_pick": vision_label,
+                    "reasoning": reasoning,
+                },
             )
 
-        return vision_idx, 'vision', None
+        return vision_idx, "vision", None
 
     finally:
         # Clean up temp file
@@ -548,8 +568,8 @@ async def binary_edge_search(
     embryo_id: str,
     piezo_heuristic: float,
     max_range: float = 0.25,
-    num_iterations: int = 4
-) -> Tuple[float, int]:
+    num_iterations: int = 4,
+) -> tuple[float, int]:
     """
     Binary search for embryo edge in 4 steps.
 
@@ -582,9 +602,10 @@ async def binary_edge_search(
     """
     import tempfile
     from pathlib import Path
+
     from PIL import Image
 
-    sign = -1 if direction == 'top' else 1
+    sign = -1 if direction == "top" else 1
     low, high = 0.0, max_range * sign
     last_visible = 0.0
     exposures = 0
@@ -600,23 +621,22 @@ async def binary_edge_search(
 
         # Capture image
         result = await client.capture_lightsheet_image(
-            piezo_position=float(piezo),
-            galvo_position=float(mid)
+            piezo_position=float(piezo), galvo_position=float(mid)
         )
         exposures += 1
 
-        if not result.get('success') or result.get('image') is None:
+        if not result.get("success") or result.get("image") is None:
             # Assume not visible on failure
             high = mid if sign > 0 else low
             low = mid if sign < 0 else high
             continue
 
-        img = select_best_view(result['image'])
+        img = select_best_view(result["image"])
 
         # Check visibility with Vision
         img_norm = ((img - img.min()) / (img.max() - img.min() + 1e-8) * 255).astype(np.uint8)
 
-        with tempfile.NamedTemporaryFile(suffix='.png', delete=False) as f:
+        with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f:
             temp_path = Path(f.name)
             Image.fromarray(img_norm).save(temp_path)
 
@@ -628,7 +648,9 @@ async def binary_edge_search(
             except Exception:
                 pass
 
-        logger.debug("iter %d: galvo=%.3f deg, visible=%s, features=%s", i + 1, mid, visible, feature_score)
+        logger.debug(
+            "iter %d: galvo=%.3f deg, visible=%s, features=%s", i + 1, mid, visible, feature_score
+        )
 
         if visible:
             last_visible = mid
@@ -648,10 +670,8 @@ async def binary_edge_search(
 
 
 async def fast_calibrate_embryo(
-    embryo_id: str,
-    context: Dict,
-    z_buffer_um: float = 25.0
-) -> Tuple[bool, str, int]:
+    embryo_id: str, context: dict, z_buffer_um: float = 25.0
+) -> tuple[bool, str, int]:
     """
     Vision-guided fast calibration using session slope.
 
@@ -676,14 +696,14 @@ async def fast_calibrate_embryo(
     """
     from gently.hardware.dispim.claude_client import AsyncClaudeClient
 
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return False, "Error: No agent context", 0
 
-    if not client or not getattr(client, 'is_connected', False):
-        return False, f"Error: Not connected to microscope server", 0
+    if not client or not getattr(client, "is_connected", False):
+        return False, "Error: Not connected to microscope server", 0
 
     embryo, err = get_embryo_or_error(agent, embryo_id)
     if err:
@@ -715,12 +735,12 @@ async def fast_calibrate_embryo(
     piezo_heuristic = session_prior.offset_um if session_prior.num_calibrations > 0 else 0.0
 
     galvo_top, exp_top = await binary_edge_search(
-        client, claude_vision, 'top', agent, embryo_id, piezo_heuristic
+        client, claude_vision, "top", agent, embryo_id, piezo_heuristic
     )
     total_exposures += exp_top
 
     galvo_bottom, exp_bottom = await binary_edge_search(
-        client, claude_vision, 'bottom', agent, embryo_id, piezo_heuristic
+        client, claude_vision, "bottom", agent, embryo_id, piezo_heuristic
     )
     total_exposures += exp_bottom
 
@@ -728,7 +748,11 @@ async def fast_calibrate_embryo(
 
     # Validate edges
     if galvo_top >= galvo_bottom:
-        return False, f"Invalid edges: top {galvo_top:.3f}° >= bottom {galvo_bottom:.3f}°", total_exposures
+        return (
+            False,
+            f"Invalid edges: top {galvo_top:.3f}° >= bottom {galvo_bottom:.3f}°",
+            total_exposures,
+        )
 
     galvo_center = (galvo_top + galvo_bottom) / 2
     galvo_extent = galvo_bottom - galvo_top
@@ -737,7 +761,11 @@ async def fast_calibrate_embryo(
     logger.info("Step 2: Focus at center (galvo=%.3f deg)...", galvo_center)
 
     # Use session slope or heuristic
-    slope = session_prior.slope_um_per_deg if session_prior.is_ready_for_fast_calibration() else HEURISTIC_SLOPE
+    slope = (
+        session_prior.slope_um_per_deg
+        if session_prior.is_ready_for_fast_calibration()
+        else HEURISTIC_SLOPE
+    )
     piezo_expected = slope * galvo_center + session_prior.offset_um
 
     # Capture 3-point focus grid (±2µm)
@@ -746,13 +774,12 @@ async def fast_calibrate_embryo(
 
     for offset in focus_offsets:
         result = await client.capture_lightsheet_image(
-            piezo_position=float(piezo_expected + offset),
-            galvo_position=float(galvo_center)
+            piezo_position=float(piezo_expected + offset), galvo_position=float(galvo_center)
         )
         total_exposures += 1
 
-        if result.get('success') and result.get('image') is not None:
-            img = select_best_view(result['image'])
+        if result.get("success") and result.get("image") is not None:
+            img = select_best_view(result["image"])
             focus_images.append(img)
         else:
             focus_images.append(np.zeros((100, 100), dtype=np.uint8))
@@ -782,12 +809,12 @@ async def fast_calibrate_embryo(
         for ext_offset in extend_offsets:
             result = await client.capture_lightsheet_image(
                 piezo_position=float(piezo_expected + ext_offset),
-                galvo_position=float(galvo_center)
+                galvo_position=float(galvo_center),
             )
             total_exposures += 1
 
-            if result.get('success') and result.get('image') is not None:
-                img = select_best_view(result['image'])
+            if result.get("success") and result.get("image") is not None:
+                img = select_best_view(result["image"])
                 focus_images.append(img)
                 focus_offsets.append(ext_offset)
 
@@ -814,12 +841,12 @@ async def fast_calibrate_embryo(
         for offset in [-2.0, 0.0, 2.0]:
             result = await client.capture_lightsheet_image(
                 piezo_position=float(piezo_expected_second + offset),
-                galvo_position=float(galvo_second)
+                galvo_position=float(galvo_second),
             )
             total_exposures += 1
 
-            if result.get('success') and result.get('image') is not None:
-                img = select_best_view(result['image'])
+            if result.get("success") and result.get("image") is not None:
+                img = select_best_view(result["image"])
                 focus_images_2.append(img)
             else:
                 focus_images_2.append(np.zeros((100, 100), dtype=np.uint8))
@@ -835,7 +862,9 @@ async def fast_calibrate_embryo(
 
         # Lock session slope
         session_prior.lock_session_slope(calibrated_slope, 0.85, embryo_id)
-        logger.info("Session slope locked: %.2f um/deg (bootstrap embryo: %s)", calibrated_slope, embryo_id)
+        logger.info(
+            "Session slope locked: %.2f um/deg (bootstrap embryo: %s)", calibrated_slope, embryo_id
+        )
     else:
         # Fast mode - use session slope, calculate offset
         calibrated_slope = session_prior.slope_um_per_deg
@@ -843,18 +872,22 @@ async def fast_calibrate_embryo(
 
     # --- STEP 6: Store Calibration ---
     embryo.calibration = {
-        'slope_um_per_deg': calibrated_slope,
-        'offset_um': calibrated_offset,
-        'galvo_top_deg': galvo_top,
-        'galvo_bottom_deg': galvo_bottom,
-        'galvo_calib_top_deg': galvo_center,
-        'galvo_calib_bottom_deg': galvo_center + 0.3 * galvo_extent if is_bootstrap else galvo_center,
-        'piezo_calib_top_um': piezo_center,
-        'piezo_calib_bottom_um': piezo_center if not is_bootstrap else piezo_center + calibrated_slope * 0.3 * galvo_extent,
-        'r_squared': 0.85,  # Assumed for Vision-based selection
-        'method': 'fast_vision_guided',
-        'bootstrap': is_bootstrap,
-        'timestamp': datetime.now().isoformat(),
+        "slope_um_per_deg": calibrated_slope,
+        "offset_um": calibrated_offset,
+        "galvo_top_deg": galvo_top,
+        "galvo_bottom_deg": galvo_bottom,
+        "galvo_calib_top_deg": galvo_center,
+        "galvo_calib_bottom_deg": galvo_center + 0.3 * galvo_extent
+        if is_bootstrap
+        else galvo_center,
+        "piezo_calib_top_um": piezo_center,
+        "piezo_calib_bottom_um": piezo_center
+        if not is_bootstrap
+        else piezo_center + calibrated_slope * 0.3 * galvo_extent,
+        "r_squared": 0.85,  # Assumed for Vision-based selection
+        "method": "fast_vision_guided",
+        "bootstrap": is_bootstrap,
+        "timestamp": datetime.now().isoformat(),
     }
 
     # Calculate volume parameters
@@ -862,17 +895,17 @@ async def fast_calibrate_embryo(
     total_range_um = extent_um + 2 * z_buffer_um
     recommended_slices = max(30, min(150, int(total_range_um / 0.5)))  # 0.5µm per slice
 
-    embryo.calibration['volume_params'] = {
-        'piezo_start_um': calibrated_offset + calibrated_slope * galvo_top - z_buffer_um,
-        'piezo_end_um': calibrated_offset + calibrated_slope * galvo_bottom + z_buffer_um,
-        'total_range_um': total_range_um,
-        'recommended_slices': recommended_slices,
+    embryo.calibration["volume_params"] = {
+        "piezo_start_um": calibrated_offset + calibrated_slope * galvo_top - z_buffer_um,
+        "piezo_end_um": calibrated_offset + calibrated_slope * galvo_bottom + z_buffer_um,
+        "total_range_um": total_range_um,
+        "recommended_slices": recommended_slices,
     }
 
     agent._save_state()
 
     msg = f"""\u2713 Fast calibration complete for {embryo_id}
-  Mode: {'BOOTSTRAP' if is_bootstrap else 'FAST'}
+  Mode: {"BOOTSTRAP" if is_bootstrap else "FAST"}
   Slope: {calibrated_slope:.2f} \u00b5m/\u00b0
   Offset: {calibrated_offset:.2f} \u00b5m
   Edges: {galvo_top:.3f}\u00b0 to {galvo_bottom:.3f}\u00b0 ({galvo_extent:.3f}\u00b0 extent)
@@ -900,7 +933,8 @@ async def fast_calibrate_embryo(
 Use after detection to prepare an embryo for volume acquisition. Takes ~2-4 minutes per embryo.
 
 The z_buffer_um parameter controls how much empty space is captured above and below the embryo.
-Default is 25\u00b5m. Increase for more context (useful for segmentation), decrease for faster acquisition.""",
+Default is 25\u00b5m. Increase for more context (useful for segmentation), decrease for faster
+acquisition.""",
     category=ToolCategory.CALIBRATION,
     requires_microscope=True,
     examples=[
@@ -920,7 +954,7 @@ async def calibrate_embryo(
     inset_fraction: float = 0.4,
     z_buffer_um: float = 25.0,
     use_v04_plan: bool = False,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Run piezo-galvo calibration with Claude vision edge detection.
 
@@ -956,20 +990,22 @@ async def calibrate_embryo(
     not on the agent side. If you need it, wire it through the queue server
     plan-submission API. Until then, the surgical path IS the v0.4.0 path.
     """
-    import numpy as np
     import tempfile
     from pathlib import Path
+
+    import numpy as np
     from PIL import Image
-    from gently.analysis.core import calculate_focus_score, fit_focus_curve, FitFunction
+
+    from gently.analysis.core import calculate_focus_score
     from gently.hardware.dispim.claude_client import AsyncClaudeClient
 
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return "Error: No agent context"
 
-    if not client or not getattr(client, 'is_connected', False):
+    if not client or not getattr(client, "is_connected", False):
         return f"Error: Not connected to microscope server. Cannot calibrate {embryo_id}."
 
     if use_v04_plan:
@@ -998,12 +1034,22 @@ async def calibrate_embryo(
     if session_prior.num_calibrations > 0 and session_prior.r_squared_mean >= 0.75:
         HEURISTIC_SLOPE = session_prior.slope_um_per_deg
         HEURISTIC_OFFSET = session_prior.offset_um
-        logger.info("Using session prior: %.1f um/deg, offset %.1f um", HEURISTIC_SLOPE, HEURISTIC_OFFSET)
-        logger.info("Prior from %d embryo(s), R2=%.3f", session_prior.num_calibrations, session_prior.r_squared_mean)
-    elif embryo.calibration and embryo.calibration.get('slope_um_per_deg'):
-        HEURISTIC_SLOPE = embryo.calibration['slope_um_per_deg']
-        HEURISTIC_OFFSET = embryo.calibration.get('offset_um', 0.0)
-        logger.info("Using previous embryo calibration: %.1f um/deg, offset %.1f um", HEURISTIC_SLOPE, HEURISTIC_OFFSET)
+        logger.info(
+            "Using session prior: %.1f um/deg, offset %.1f um", HEURISTIC_SLOPE, HEURISTIC_OFFSET
+        )
+        logger.info(
+            "Prior from %d embryo(s), R2=%.3f",
+            session_prior.num_calibrations,
+            session_prior.r_squared_mean,
+        )
+    elif embryo.calibration and embryo.calibration.get("slope_um_per_deg"):
+        HEURISTIC_SLOPE = embryo.calibration["slope_um_per_deg"]
+        HEURISTIC_OFFSET = embryo.calibration.get("offset_um", 0.0)
+        logger.info(
+            "Using previous embryo calibration: %.1f um/deg, offset %.1f um",
+            HEURISTIC_SLOPE,
+            HEURISTIC_OFFSET,
+        )
     else:
         HEURISTIC_SLOPE = 100.0  # Default empirical value
         HEURISTIC_OFFSET = 0.0
@@ -1015,9 +1061,9 @@ async def calibrate_embryo(
     try:
         # First move to embryo position
         pos = embryo.stage_position
-        if pos and pos.get('x') is not None and pos.get('y') is not None:
+        if pos and pos.get("x") is not None and pos.get("y") is not None:
             logger.info("Moving to %s position...", embryo_id)
-            await client.move_to_position(pos['x'], pos['y'])
+            await client.move_to_position(pos["x"], pos["y"])
 
         # Initialize Claude client for vision
         claude_vision = AsyncClaudeClient()
@@ -1032,37 +1078,48 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
             nonlocal total_exposures
             piezo_pos = HEURISTIC_SLOPE * galvo_pos + HEURISTIC_OFFSET  # Track light sheet
             result = await client.capture_lightsheet_image(
-                piezo_position=float(piezo_pos),
-                galvo_position=float(galvo_pos)
+                piezo_position=float(piezo_pos), galvo_position=float(galvo_pos)
             )
-            if result.get('success'):
+            if result.get("success"):
                 total_exposures += 1
-            if not result.get('success') or result.get('image') is None:
+            if not result.get("success") or result.get("image") is None:
                 return False
 
-            img = result['image']
+            img = result["image"]
             # Select best view from dual-view image
             img_view = select_best_view(img)
 
             # Save to temp file for Claude
-            with tempfile.NamedTemporaryFile(suffix='.png', delete=False) as f:
+            with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f:
                 temp_path = Path(f.name)
                 # Normalize and save
-                img_norm = ((img_view - img_view.min()) / (img_view.max() - img_view.min() + 1e-10) * 255).astype(np.uint8)
+                img_norm = (
+                    (img_view - img_view.min()) / (img_view.max() - img_view.min() + 1e-10) * 255
+                ).astype(np.uint8)
                 Image.fromarray(img_norm).save(temp_path)
 
             try:
                 # Claude now returns (visible, feature_score, description)
-                visible, feature_score, description = await claude_vision.detect_embryo_presence(temp_path)
-                logger.debug("galvo=%+.3f deg: %s (features=%s/10) - %s...", galvo_pos, 'VISIBLE' if visible else 'EMPTY', feature_score, description[:40])
+                visible, feature_score, description = await claude_vision.detect_embryo_presence(
+                    temp_path
+                )
+                logger.debug(
+                    "galvo=%+.3f deg: %s (features=%s/10) - %s...",
+                    galvo_pos,
+                    "VISIBLE" if visible else "EMPTY",
+                    feature_score,
+                    description[:40],
+                )
 
                 # Record for optimal focus position selection
-                edge_detection_data.append({
-                    'galvo': float(galvo_pos),
-                    'piezo': float(piezo_pos),
-                    'visible': visible,
-                    'feature_score': feature_score,
-                })
+                edge_detection_data.append(
+                    {
+                        "galvo": float(galvo_pos),
+                        "piezo": float(piezo_pos),
+                        "visible": visible,
+                        "feature_score": feature_score,
+                    }
+                )
 
                 # Push edge detection image to viz server
                 if agent.viz_server:
@@ -1071,12 +1128,12 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
                         uid=f"edge_detect_{embryo_id}_{galvo_pos:.3f}",
                         data_type="edge_detection",
                         metadata={
-                            'embryo_id': embryo_id,
-                            'galvo': float(galvo_pos),
-                            'piezo': float(piezo_pos),
-                            'visible': visible,
-                            'feature_score': feature_score,
-                        }
+                            "embryo_id": embryo_id,
+                            "galvo": float(galvo_pos),
+                            "piezo": float(piezo_pos),
+                            "visible": visible,
+                            "feature_score": feature_score,
+                        },
                     )
 
                 return visible
@@ -1088,14 +1145,18 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
             # Use provided galvo positions or defaults
             detected_top = galvo_top if galvo_top is not None else -0.15
             detected_bottom = galvo_bottom if galvo_bottom is not None else 0.15
-            logger.info("Skipping edge detection, using galvo range: %.3f deg to %.3f deg", detected_top, detected_bottom)
+            logger.info(
+                "Skipping edge detection, using galvo range: %.3f deg to %.3f deg",
+                detected_top,
+                detected_bottom,
+            )
         else:
             logger.info("Phase 1: Detecting embryo Z extent with Claude vision...")
 
             # Detect TOP edge (sweep from center toward negative)
             logger.info("Detecting TOP edge (sweeping galvo toward negative)...")
             detected_top = 0.0
-            for galvo in np.arange(0.0, -edge_max_range - edge_step/2, -edge_step):
+            for galvo in np.arange(0.0, -edge_max_range - edge_step / 2, -edge_step):
                 visible = await check_embryo_at_position(galvo)
                 if visible:
                     detected_top = galvo
@@ -1106,7 +1167,7 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
             # Detect BOTTOM edge (sweep from center toward positive)
             logger.info("Detecting BOTTOM edge (sweeping galvo toward positive)...")
             detected_bottom = 0.0
-            for galvo in np.arange(0.0, edge_max_range + edge_step/2, edge_step):
+            for galvo in np.arange(0.0, edge_max_range + edge_step / 2, edge_step):
                 visible = await check_embryo_at_position(galvo)
                 if visible:
                     detected_bottom = galvo
@@ -1114,8 +1175,13 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
                     logger.info("Embryo disappeared at galvo=%.3f deg", galvo)
                     break
 
-            logger.info("Detected embryo extent: top=%.3f deg, bottom=%.3f deg, range=%.3f deg (~%.0f um)",
-                         detected_top, detected_bottom, detected_bottom - detected_top, (detected_bottom - detected_top) * 100)
+            logger.info(
+                "Detected embryo extent: top=%.3f deg, bottom=%.3f deg, range=%.3f deg (~%.0f um)",
+                detected_top,
+                detected_bottom,
+                detected_bottom - detected_top,
+                (detected_bottom - detected_top) * 100,
+            )
 
         # === PHASE 2: COMPUTE CALIBRATION POSITIONS (v0.4.0 inset formula) ===
         # Extend the detected edges outward by `edge_tolerance_deg` to get the
@@ -1133,11 +1199,22 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
         calib_bottom = scan_bottom - inset_amount
         # Store on the embryo so the viz server's "scan top"/"scan bot" dashed
         # lines match what the calibration actually scanned.
-        detected_range = detected_bottom - detected_top
-        logger.info("Scan boundaries (edges +/- %.3f tolerance): %.3f to %.3f deg (range %.3f)",
-                     edge_tolerance_deg, scan_top, scan_bottom, scan_range)
-        logger.info("Calibration positions (%.0f%% inset from scan boundary): top=%.3f deg, bottom=%.3f deg (%.3f deg apart)",
-                     inset_fraction * 100, calib_top, calib_bottom, calib_bottom - calib_top)
+        detected_bottom - detected_top
+        logger.info(
+            "Scan boundaries (edges +/- %.3f tolerance): %.3f to %.3f deg (range %.3f)",
+            edge_tolerance_deg,
+            scan_top,
+            scan_bottom,
+            scan_range,
+        )
+        logger.info(
+            "Calibration positions (%.0f%% inset from scan boundary):"
+            " top=%.3f deg, bottom=%.3f deg (%.3f deg apart)",
+            inset_fraction * 100,
+            calib_top,
+            calib_bottom,
+            calib_bottom - calib_top,
+        )
 
         # === PHASE 3: ADAPTIVE FOCUS SWEEPS AT CALIBRATION POSITIONS ===
         logger.info("Phase 3: Adaptive focus sweeps at calibration positions...")
@@ -1166,14 +1243,16 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
             total_exposures += sweep_exposures
 
             # Check for sweep failure
-            if result_dict['r_squared'] < 0.5:
-                logger.warning("Low confidence for %s (R2=%.3f)", galvo_name, result_dict['r_squared'])
+            if result_dict["r_squared"] < 0.5:
+                logger.warning(
+                    "Low confidence for %s (R2=%.3f)", galvo_name, result_dict["r_squared"]
+                )
 
         # === PHASE 4: CALCULATE 2-POINT LINEAR CALIBRATION ===
-        g_top = results['top']['galvo']
-        p_top = results['top']['piezo']
-        g_bottom = results['bottom']['galvo']
-        p_bottom = results['bottom']['piezo']
+        g_top = results["top"]["galvo"]
+        p_top = results["top"]["piezo"]
+        g_bottom = results["bottom"]["galvo"]
+        p_bottom = results["bottom"]["piezo"]
 
         slope = (p_bottom - p_top) / (g_bottom - g_top)
         offset = p_top - slope * g_top
@@ -1198,26 +1277,26 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
 
         # Store calibration
         embryo.calibration = {
-            'slope_um_per_deg': slope,
-            'offset_um': offset,
-            'galvo_top_deg': detected_top,
-            'galvo_bottom_deg': detected_bottom,
-            'galvo_calib_top_deg': g_top,
-            'galvo_calib_bottom_deg': g_bottom,
-            'piezo_top_um': p_top,
-            'piezo_bottom_um': p_bottom,
+            "slope_um_per_deg": slope,
+            "offset_um": offset,
+            "galvo_top_deg": detected_top,
+            "galvo_bottom_deg": detected_bottom,
+            "galvo_calib_top_deg": g_top,
+            "galvo_calib_bottom_deg": g_bottom,
+            "piezo_top_um": p_top,
+            "piezo_bottom_um": p_bottom,
             # Volume acquisition parameters
-            'galvo_center': galvo_center,
-            'galvo_amplitude': galvo_amplitude,
-            'piezo_center': piezo_center,
-            'piezo_amplitude': piezo_amplitude,
-            'z_buffer_um': z_buffer_um,
-            'r_squared_top': results['top']['r_squared'],
-            'r_squared_bottom': results['bottom']['r_squared'],
+            "galvo_center": galvo_center,
+            "galvo_amplitude": galvo_amplitude,
+            "piezo_center": piezo_center,
+            "piezo_amplitude": piezo_amplitude,
+            "z_buffer_um": z_buffer_um,
+            "r_squared_top": results["top"]["r_squared"],
+            "r_squared_bottom": results["bottom"]["r_squared"],
         }
 
         # Update session prior for cross-embryo learning
-        avg_r_squared = (results['top']['r_squared'] + results['bottom']['r_squared']) / 2
+        avg_r_squared = (results["top"]["r_squared"] + results["bottom"]["r_squared"]) / 2
         extent_deg = detected_bottom - detected_top
         session_prior.update_from_calibration(
             slope=slope,
@@ -1225,17 +1304,21 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
             r_squared=avg_r_squared,
             extent_deg=extent_deg,
         )
-        logger.info("Updated session prior (now %d embryo(s), avg R2=%.3f)", session_prior.num_calibrations, session_prior.r_squared_mean)
+        logger.info(
+            "Updated session prior (now %d embryo(s), avg R2=%.3f)",
+            session_prior.num_calibrations,
+            session_prior.r_squared_mean,
+        )
 
         # Add to focus history
-        for name in ['top', 'bottom']:
+        for name in ["top", "bottom"]:
             embryo.add_focus_datapoint(
-                galvo=results[name]['galvo'],
-                piezo=results[name]['piezo'],
-                score=results[name]['max_score'],
-                r_squared=results[name]['r_squared'],
-                method='calibration',
-                algorithm='fft_bandpass',
+                galvo=results[name]["galvo"],
+                piezo=results[name]["piezo"],
+                score=results[name]["max_score"],
+                r_squared=results[name]["r_squared"],
+                method="calibration",
+                algorithm="fft_bandpass",
             )
 
         # Record total light exposure from calibration (50ms default exposure)
@@ -1253,24 +1336,24 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
                     piezo_bottom=p_bottom,
                     slope=slope,
                     offset=offset,
-                    r_squared_top=results['top']['r_squared'],
-                    r_squared_bottom=results['bottom']['r_squared'],
+                    r_squared_top=results["top"]["r_squared"],
+                    r_squared_bottom=results["bottom"]["r_squared"],
                 )
                 agent.push_viz(
                     array=summary_plot,
                     uid=f"calibration_summary_{embryo_id}",
                     data_type="calibration_summary",
                     metadata={
-                        'embryo_id': embryo_id,
-                        'slope': slope,
-                        'offset': offset,
-                        'galvo_top': g_top,
-                        'galvo_bottom': g_bottom,
-                        'piezo_top': p_top,
-                        'piezo_bottom': p_bottom,
-                        'r_squared_top': results['top']['r_squared'],
-                        'r_squared_bottom': results['bottom']['r_squared'],
-                    }
+                        "embryo_id": embryo_id,
+                        "slope": slope,
+                        "offset": offset,
+                        "galvo_top": g_top,
+                        "galvo_bottom": g_bottom,
+                        "piezo_top": p_top,
+                        "piezo_bottom": p_bottom,
+                        "r_squared_top": results["top"]["r_squared"],
+                        "r_squared_bottom": results["bottom"]["r_squared"],
+                    },
                 )
             except Exception as plot_err:
                 logger.warning("Failed to generate calibration summary plot: %s", plot_err)
@@ -1292,6 +1375,7 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
 
     except Exception as e:
         import traceback
+
         return f"Error calibrating embryo: {str(e)}\n{traceback.format_exc()}"
 
 
@@ -1312,13 +1396,13 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
     ],
 )
 async def calibrate_all_embryos(
-    embryo_ids: List[str] = None,
+    embryo_ids: list[str] = None,
     skip_edge_detection: bool = False,
     z_buffer_um: float = 25.0,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Calibrate all embryos sequentially with Claude vision"""
-    agent = context.get('agent')
+    agent = context.get("agent")
 
     if not agent:
         return "Error: No agent context"
@@ -1342,10 +1426,10 @@ async def calibrate_all_embryos(
             embryo_id=eid,
             skip_edge_detection=skip_edge_detection,
             z_buffer_um=z_buffer_um,
-            context=context
+            context=context,
         )
         # Get first two lines of result
-        lines = result.split('\n')
+        lines = result.split("\n")
         summary = lines[0] if len(lines) == 1 else f"{lines[0]} {lines[1]}"
         results.append(f"{eid}: {summary}")
 
@@ -1391,15 +1475,26 @@ def _format_quality(cal: dict) -> str:
 
 @tool(
     name="apply_calibration_to_embryos",
-    description="""Copy one embryo's calibration onto one or more target embryos. Useful when one embryo has a strong piezo-galvo fit and others can borrow it as-is.
-
-**Quality metric is R²**, NOT galvo extent. The right "source" is the embryo with the highest ``min(r_squared_top, r_squared_bottom)`` — both ends of the galvo sweep need a clean Gaussian fit for the calibration to hold up at the volume edges. Wider extent just means a bigger embryo; it does not imply better calibration.
-
-**Auto-pick by quality**: pass ``source_embryo_id="auto"`` to let the tool pick the calibration with the highest min-R² across all currently-calibrated embryos. The response includes the per-embryo R² ranking so the agent can narrate the choice.
-
-Pass ``target_embryo_ids=None`` (or omit it) to apply to ALL other embryos in the experiment that are not skipped.
-
-Caveats — calibration is position-dependent: piezo-galvo slope drifts across the XY field, and embryos may sit at slightly different Z depths. The agent should warn the user about this when applying broadly. Best practice is still to calibrate each embryo individually; this tool is for "good enough" propagation or when individual calibration would burn too much light dose.""",
+    description="""Copy one embryo's calibration onto one or more target embryos. Useful when
+one embryo has a strong piezo-galvo fit and others can borrow it as-is.
+
+**Quality metric is R²**, NOT galvo extent. The right "source" is the embryo with the
+highest ``min(r_squared_top, r_squared_bottom)`` — both ends of the galvo sweep need a clean
+Gaussian fit for the calibration to hold up at the volume edges. Wider extent just means a
+bigger embryo; it does not imply better calibration.
+
+**Auto-pick by quality**: pass ``source_embryo_id="auto"`` to let the tool pick the
+calibration with the highest min-R² across all currently-calibrated embryos. The response
+includes the per-embryo R² ranking so the agent can narrate the choice.
+
+Pass ``target_embryo_ids=None`` (or omit it) to apply to ALL other embryos in the
+experiment that are not skipped.
+
+Caveats — calibration is position-dependent: piezo-galvo slope drifts across the XY field,
+and embryos may sit at slightly different Z depths. The agent should warn the user about this
+when applying broadly. Best practice is still to calibrate each embryo individually; this
+tool is for "good enough" propagation or when individual calibration would burn too much
+light dose.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=False,
     examples=[
@@ -1415,9 +1510,9 @@ def _format_quality(cal: dict) -> str:
 )
 def apply_calibration_to_embryos(
     source_embryo_id: str,
-    target_embryo_ids: Optional[List[str]] = None,
+    target_embryo_ids: list[str] | None = None,
     overwrite_existing: bool = True,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Broadcast one embryo's calibration to others.
 
@@ -1427,6 +1522,7 @@ def apply_calibration_to_embryos(
     to narrate the choice (and the user can audit).
     """
     from gently.harness.tools.helpers import require_agent
+
     agent, err = require_agent(context)
     if err:
         return err
@@ -1447,7 +1543,7 @@ def apply_calibration_to_embryos(
         ranked.sort(key=lambda t: t[1], reverse=True)
         source_embryo_id = ranked[0][0]
         ranking_lines.append("Ranking by min(R²_top, R²_bot):")
-        for eid, score, cal in ranked:
+        for eid, _score, cal in ranked:
             mark = " ← chosen" if eid == source_embryo_id else ""
             ranking_lines.append(f"  {eid}: {_format_quality(cal)}{mark}")
 
@@ -1455,14 +1551,12 @@ def apply_calibration_to_embryos(
         return f"Source embryo '{source_embryo_id}' not found."
     source = agent.experiment.embryos[source_embryo_id]
     if not source.calibration:
-        return (
-            f"{source_embryo_id} has no calibration data to copy. "
-            f"Run calibrate_embryo first."
-        )
+        return f"{source_embryo_id} has no calibration data to copy. Run calibrate_embryo first."
 
     if target_embryo_ids is None:
         target_embryo_ids = [
-            eid for eid, e in agent.experiment.embryos.items()
+            eid
+            for eid, e in agent.experiment.embryos.items()
             if eid != source_embryo_id and not e.should_skip
         ]
 
@@ -1480,6 +1574,7 @@ def apply_calibration_to_embryos(
             continue
         # Deep-ish copy so subsequent mutations don't alias the source.
         import copy
+
         tgt.calibration = copy.deepcopy(source.calibration)
         applied.append(tid)
 
diff --git a/gently/app/tools/detection_tools.py b/gently/app/tools/detection_tools.py
index e30f5f33..89d914d6 100644
--- a/gently/app/tools/detection_tools.py
+++ b/gently/app/tools/detection_tools.py
@@ -9,32 +9,30 @@
 """
 
 import uuid
-from typing import Dict, List, Optional, Tuple
 from datetime import datetime
 from pathlib import Path
 
 import numpy as np
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
-from gently.harness.tools.helpers import require_agent
 from gently.core.coordinates import (
+    DEFAULT_OBJECTIVE_MAG,
+    DEFAULT_PIXEL_SIZE_UM,
+    get_um_per_pixel,
     pixel_to_stage_position,
     stage_to_pixel_position,
-    get_um_per_pixel,
-    DEFAULT_PIXEL_SIZE_UM,
-    DEFAULT_OBJECTIVE_MAG,
 )
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 async def _route_to_map_view(
     agent,
     image: np.ndarray,
-    initial_markers: List[Dict],
-    stage_position: Tuple[float, float],
+    initial_markers: list[dict],
+    stage_position: tuple[float, float],
     default_role: str = "test",
     pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
-    timeout: Optional[float] = None,
-) -> Tuple[Optional[List[Dict]], Optional[str]]:
+    timeout: float | None = None,
+) -> tuple[list[dict] | None, str | None]:
     """Hand off image + markers to the web map view; await user-edited result.
 
     Returns ``(marked, None)`` on success or ``(None, error_message)`` if the
@@ -42,8 +40,7 @@ async def _route_to_map_view(
     """
     if getattr(agent, "viz_server", None) is None:
         return None, (
-            "Map view requires the web visualization server. "
-            "Start it with start_viz_server first."
+            "Map view requires the web visualization server. Start it with start_viz_server first."
         )
 
     from gently.ui.web.embryo_marker import mark_embryos_web
@@ -73,28 +70,38 @@ def _next_embryo_number(experiment) -> int:
 
 
 def _stage_from_pixel(
-    pixel_x: float, pixel_y: float,
-    image_shape: Tuple[int, int],
-    current_stage: Tuple[float, float],
+    pixel_x: float,
+    pixel_y: float,
+    image_shape: tuple[int, int],
+    current_stage: tuple[float, float],
     pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
     objective_mag: float = DEFAULT_OBJECTIVE_MAG,
-) -> Tuple[float, float]:
+) -> tuple[float, float]:
     """Convert a pixel position in the bottom-cam image to a stage XY."""
     h, w = image_shape[:2]
     um_per_px = get_um_per_pixel(pixel_size_um, objective_mag)
     return pixel_to_stage_position(
-        pixel_x, pixel_y,
-        w / 2, h / 2,
-        current_stage[0], current_stage[1],
+        pixel_x,
+        pixel_y,
+        w / 2,
+        h / 2,
+        current_stage[0],
+        current_stage[1],
         um_per_px,
     )
 
 
 @tool(
     name="detect_embryos",
-    description="""Automatically detect embryos in the current field of view using brightness detection + SAM segmentation, then hand off to the web map view for editing and role assignment.
-
-Use when user says "find embryos", "detect embryos", or at the start of an experiment to locate samples. Captures a bottom camera image, runs SAM detection, and opens the web map view with SAM markers pre-placed. User adds/removes markers, cycles each marker's role (Test / Calibration / unassigned), and presses Done. The confirmed embryos are registered with their roles in the experiment.""",
+    description="""Automatically detect embryos in the current field of view using brightness
+detection + SAM segmentation, then hand off to the web map view for editing and role
+assignment.
+
+Use when user says "find embryos", "detect embryos", or at the start of an experiment to
+locate samples. Captures a bottom camera image, runs SAM detection, and opens the web map
+view with SAM markers pre-placed. User adds/removes markers, cycles each marker's role
+(Test / Calibration / unassigned), and presses Done. The confirmed embryos are registered
+with their roles in the experiment.""",
     category=ToolCategory.DETECTION,
     requires_microscope=True,
     examples=[
@@ -111,18 +118,21 @@ async def detect_embryos(
     min_area: int = 5000,
     max_area: int = 150000,
     default_role: str = "test",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Detect embryos via SAM + edit/assign roles in the web map view."""
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return "Error: No agent context"
     if not client:
         return "Error: Microscope not connected. Cannot detect embryos in offline mode."
     if not client.has_sam:
-        return "Error: SAM server not connected. Embryo detection requires the SAM segmentation server."
+        return (
+            "Error: SAM server not connected."
+            " Embryo detection requires the SAM segmentation server."
+        )
 
     try:
         result = await client.detect_embryos(
@@ -134,15 +144,18 @@ async def detect_embryos(
             max_area=max_area,
         )
 
-        if not result.get('success'):
+        if not result.get("success"):
             return f"Detection failed: {result.get('error', 'Unknown error')}"
 
-        sam_embryos = result.get('embryos', [])
-        image = result.get('image')
-        stage_pos = tuple(result.get('stage_position', [0.0, 0.0]))
+        sam_embryos = result.get("embryos", [])
+        image = result.get("image")
+        stage_pos = tuple(result.get("stage_position", [0.0, 0.0]))
 
         if image is None:
-            return f"Detection ran but no image was returned for the map view (got {len(sam_embryos)} SAM detections)."
+            return (
+                f"Detection ran but no image was returned for the map view"
+                f" (got {len(sam_embryos)} SAM detections)."
+            )
 
         # Hand off SAM detections as editable initial markers in the map view.
         initial_markers = [
@@ -184,8 +197,10 @@ async def detect_embryos(
                 next_num += 1
 
             stage_x, stage_y = _stage_from_pixel(
-                m["pixel_x"], m["pixel_y"],
-                image.shape, stage_pos,
+                m["pixel_x"],
+                m["pixel_y"],
+                image.shape,
+                stage_pos,
             )
             position = {"x": stage_x, "y": stage_y}
 
@@ -207,19 +222,20 @@ async def detect_embryos(
         # OPERATOR_MARKED_EMBRYOS — operator confirmed via the web canvas.
         # This is the intent signal eval/shadow listeners hook for ReactiveCandidate.
         if added:
-            bus = getattr(agent, '_event_bus', None)
+            bus = getattr(agent, "_event_bus", None)
             if bus is not None:
                 from gently.core.event_bus import EventType
+
                 try:
                     bus.publish(
                         event_type=EventType.OPERATOR_MARKED_EMBRYOS,
                         data={
-                            'embryo_ids': [eid for eid, _ in added],
-                            'count': len(added),
-                            'stage_origin': list(stage_pos),
-                            'pre_edit_count': len(sam_embryos),
+                            "embryo_ids": [eid for eid, _ in added],
+                            "count": len(added),
+                            "stage_origin": list(stage_pos),
+                            "pre_edit_count": len(sam_embryos),
                         },
-                        source='detect_embryos:web-editor',
+                        source="detect_embryos:web-editor",
                     )
                 except Exception:
                     pass
@@ -230,20 +246,28 @@ async def detect_embryos(
         role_summary = ", ".join(f"{n} {r}" for r, n in sorted(role_counts.items()))
 
         if auto_calibrate and added:
-            return f"Detected & registered {len(added)} embryos ({role_summary}). Starting calibration..."
+            return (
+                f"Detected & registered {len(added)} embryos ({role_summary})."
+                " Starting calibration..."
+            )
         return f"Detection complete: {len(added)} embryo(s) ({role_summary})."
 
     except Exception as e:
         import traceback
+
         traceback.print_exc()
         return f"Error detecting embryos: {str(e)}"
 
 
 @tool(
     name="manual_mark_embryos",
-    description="""Capture a bottom-camera image and open the web map view for manual embryo marking. User clicks to add markers and cycles each marker's role (Test / Calibration / unassigned).
+    description="""Capture a bottom-camera image and open the web map view for manual embryo
+marking. User clicks to add markers and cycles each marker's role (Test / Calibration /
+unassigned).
 
-Use when automatic detection missed embryos, or when the user wants to add embryos manually (e.g., "let me mark embryos", "I'll click on them"). Newly marked embryos are registered with the role assigned in the map view; existing embryos remain untouched.""",
+Use when automatic detection missed embryos, or when the user wants to add embryos manually
+(e.g., "let me mark embryos", "I'll click on them"). Newly marked embryos are registered with
+the role assigned in the map view; existing embryos remain untouched.""",
     category=ToolCategory.DETECTION,
     requires_microscope=True,
     examples=[
@@ -254,11 +278,11 @@ async def detect_embryos(
 async def manual_mark_embryos(
     exposure_ms: float = None,
     default_role: str = "test",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Manual marking via the web map view."""
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return "Error: No agent context"
@@ -285,19 +309,24 @@ async def manual_mark_embryos(
             pos = emb.stage_position or {}
             sx, sy = pos.get("x", 0), pos.get("y", 0)
             px, py = stage_to_pixel_position(
-                stage_x=sx, stage_y=sy,
-                current_stage_x=stage_pos[0], current_stage_y=stage_pos[1],
-                image_center_x=w / 2, image_center_y=h / 2,
+                stage_x=sx,
+                stage_y=sy,
+                current_stage_x=stage_pos[0],
+                current_stage_y=stage_pos[1],
+                image_center_x=w / 2,
+                image_center_y=h / 2,
                 um_per_pixel=um_per_px,
             )
-            initial_markers.append({
-                "pixel_x": px,
-                "pixel_y": py,
-                "role": emb.role,
-                "source": "existing",
-                "embryo_id": embryo_id,
-                "confidence": emb.detection_confidence,
-            })
+            initial_markers.append(
+                {
+                    "pixel_x": px,
+                    "pixel_y": py,
+                    "role": emb.role,
+                    "source": "existing",
+                    "embryo_id": embryo_id,
+                    "confidence": emb.detection_confidence,
+                }
+            )
 
         marked, err = await _route_to_map_view(
             agent=agent,
@@ -321,7 +350,10 @@ async def manual_mark_embryos(
         added_ids, updated_ids = [], []
         for m in marked:
             stage_x, stage_y = _stage_from_pixel(
-                m["pixel_x"], m["pixel_y"], image.shape, stage_pos,
+                m["pixel_x"],
+                m["pixel_y"],
+                image.shape,
+                stage_pos,
             )
             pos = {"x": stage_x, "y": stage_y}
             existing_id = m.get("embryo_id")
@@ -345,10 +377,7 @@ async def manual_mark_embryos(
 
         # Removals: any existing embryo NOT mentioned in marked is dropped.
         seen_ids = {m.get("embryo_id") for m in marked if m.get("embryo_id")}
-        removed_ids = [
-            eid for eid in existing_ids
-            if eid not in seen_ids and eid not in added_ids
-        ]
+        removed_ids = [eid for eid in existing_ids if eid not in seen_ids and eid not in added_ids]
         for rid in removed_ids:
             agent.experiment.embryos.pop(rid, None)
 
@@ -363,15 +392,20 @@ async def manual_mark_embryos(
 
     except Exception as e:
         import traceback
+
         traceback.print_exc()
         return f"Error: {str(e)}"
 
 
 @tool(
     name="edit_embryos",
-    description="""Capture a fresh bottom-camera image and open the web map view to edit current embryos — add, remove, move, or re-label Test/Calibration. Same surface as manual_mark_embryos; this tool exists to match user intent when they say "edit" rather than "mark".
+    description="""Capture a fresh bottom-camera image and open the web map view to edit
+current embryos — add, remove, move, or re-label Test/Calibration. Same surface as
+manual_mark_embryos; this tool exists to match user intent when they say "edit" rather than
+"mark".
 
-Use when user wants to adjust existing detection results (e.g., "edit embryos", "remove embryo_3", "swap roles", "fix detection").""",
+Use when user wants to adjust existing detection results (e.g., "edit embryos",
+"remove embryo_3", "swap roles", "fix detection").""",
     category=ToolCategory.DETECTION,
     requires_microscope=True,
     examples=[
@@ -383,10 +417,10 @@ async def manual_mark_embryos(
 async def edit_embryos(
     exposure_ms: float = None,
     default_role: str = "test",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Edit existing embryos via the web map view."""
-    agent = context.get('agent')
+    agent = context.get("agent")
     if not agent:
         return "Error: No agent context"
     if not agent.experiment.embryos:
@@ -404,9 +438,11 @@ async def edit_embryos(
 
 @tool(
     name="show_detected_embryos",
-    description="""Capture a fresh image and display all tracked embryos with labeled bounding boxes. Shows embryo IDs at their positions.
-Use when user wants to see where embryos are visually (e.g., "show me the embryos", "display embryo positions").
-Captures a new bottom camera image and overlays all active (non-skipped) embryo positions. Image is saved to detection_results/.""",
+    description="""Capture a fresh image and display all tracked embryos with labeled bounding
+boxes. Shows embryo IDs at their positions.
+Use when user wants to see where embryos are visually (e.g., "show me the embryos",
+"display embryo positions"). Captures a new bottom camera image and overlays all active
+(non-skipped) embryo positions. Image is saved to detection_results/.""",
     category=ToolCategory.DETECTION,
     requires_microscope=True,
     examples=[
@@ -414,13 +450,10 @@ async def edit_embryos(
         ToolExample("Display embryo positions", {}),
     ],
 )
-async def show_detected_embryos(
-    save_to_file: bool = True,
-    context: Dict = None
-) -> str:
+async def show_detected_embryos(save_to_file: bool = True, context: dict = None) -> str:
     """Show detected embryos visualization using experiment.embryos as source of truth"""
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return "Error: No agent context"
@@ -433,21 +466,21 @@ async def show_detected_embryos(
 
     try:
         snap = await client.capture_bottom_image()
-        image = snap['image']
+        image = snap["image"]
         if image is None or image.shape == (100, 100):
             return "Failed to capture image for visualization."
 
         current_stage = await client.get_stage_position()
 
         # Archive the bottom camera image with metadata
-        if snap.get('image_path') and agent.store and agent.session_id:
+        if snap.get("image_path") and agent.store and agent.session_id:
             try:
                 from gently.harness.tools.helpers import build_snapshot_metadata
-                meta = build_snapshot_metadata(
-                    current_stage, image.shape, agent.experiment)
+
+                meta = build_snapshot_metadata(current_stage, image.shape, agent.experiment)
                 agent.store.register_snapshot(
-                    agent.session_id, "bottom_camera", snap['image_path'],
-                    metadata=meta)
+                    agent.session_id, "bottom_camera", snap["image_path"], metadata=meta
+                )
             except Exception:
                 pass
 
@@ -461,8 +494,8 @@ async def show_detected_embryos(
         for embryo_id, embryo_state in agent.experiment.embryos.items():
             pos = embryo_state.stage_position or {}
 
-            stage_x = pos.get('x', current_stage[0])
-            stage_y = pos.get('y', current_stage[1])
+            stage_x = pos.get("x", current_stage[0])
+            stage_y = pos.get("y", current_stage[1])
 
             # Convert stage to pixel using centralized function
             pixel_x, pixel_y = stage_to_pixel_position(
@@ -472,17 +505,19 @@ async def show_detected_embryos(
                 current_stage_y=current_stage[1],
                 image_center_x=image_center_x,
                 image_center_y=image_center_y,
-                um_per_pixel=um_per_pixel
+                um_per_pixel=um_per_pixel,
             )
 
-            embryos.append({
-                'embryo_id': embryo_id,
-                'pixel_x': pixel_x,
-                'pixel_y': pixel_y,
-                'stage_x_um': stage_x,
-                'stage_y_um': stage_y,
-                'confidence': embryo_state.detection_confidence,
-            })
+            embryos.append(
+                {
+                    "embryo_id": embryo_id,
+                    "pixel_x": pixel_x,
+                    "pixel_y": pixel_y,
+                    "stage_x_um": stage_x,
+                    "stage_y_um": stage_y,
+                    "confidence": embryo_state.detection_confidence,
+                }
+            )
 
         if not embryos:
             return "No embryos to display."
@@ -496,13 +531,13 @@ async def show_detected_embryos(
             embryos=embryos,
             title=f"Embryos ({len(embryos)})",
             save_path=save_path,
-            show=True
+            show=True,
         )
 
-        if view_result.get('success'):
-            embryo_ids = [e.get('embryo_id', '?') for e in embryos]
+        if view_result.get("success"):
+            embryo_ids = [e.get("embryo_id", "?") for e in embryos]
             return f"Showing {len(embryos)} embryos: {', '.join(embryo_ids)}\nSaved to: {save_path}"
-        elif view_result.get('error'):
+        elif view_result.get("error"):
             return f"Display error: {view_result.get('error')}"
         else:
             return f"Visualization complete. Check {save_path}"
diff --git a/gently/app/tools/experiment_tools.py b/gently/app/tools/experiment_tools.py
index e0da0b8c..2b006348 100644
--- a/gently/app/tools/experiment_tools.py
+++ b/gently/app/tools/experiment_tools.py
@@ -4,25 +4,25 @@
 Tools for managing experiments and tracking embryo states.
 """
 
-from typing import Dict
-from datetime import datetime
 import json
+from datetime import datetime
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
-from gently.harness.tools.helpers import require_agent, get_embryo_or_error
+from gently.harness.tools.helpers import get_embryo_or_error, require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
     name="get_current_time",
-    description="""Get the current date and time. Use this when you need to know what time it is now,
-for example when the user says "image until 4pm" or "run for the next 2 hours" and you need to calculate durations.""",
+    description="""Get the current date and time. Use this when you need to know what time it is
+now, for example when the user says "image until 4pm" or "run for the next 2 hours" and you need
+to calculate durations.""",
     category=ToolCategory.UTILITY,
     examples=[
         ToolExample("What time is it?", {}),
         ToolExample("Image from now to 4pm", {}),
     ],
 )
-def get_current_time(context: Dict) -> str:
+def get_current_time(context: dict) -> str:
     """Get current date and time"""
     now = datetime.now()
     return f"Current time: {now.strftime('%Y-%m-%d %H:%M:%S')} ({now.strftime('%I:%M %p')})"
@@ -30,10 +30,13 @@ def get_current_time(context: Dict) -> str:
 
 @tool(
     name="get_experiment_summary",
-    description="""Get a comprehensive summary of the current experiment including all embryos, their XY stage positions, calibration status, and imaging history.
-Use this tool when the user asks about embryo locations, experiment status, how many embryos exist, or wants an overview.
-This is the primary tool for answering questions like "where are the embryos?" or "what's the current status?"
-Returns all embryo IDs with their coordinates - no parameters needed.""",
+    description="""Get a comprehensive summary of the current experiment including all embryos,
+their XY stage positions, calibration status, and imaging history.
+Use this tool when the user asks about embryo locations, experiment status, how many embryos
+exist, or wants an overview.
+This is the primary tool for answering questions like "where are the embryos?" or
+"what's the current status?" Returns all embryo IDs with their coordinates - no parameters
+needed.""",
     category=ToolCategory.EXPERIMENT,
     examples=[
         ToolExample("Where are all the embryos?", {}),
@@ -41,7 +44,7 @@ def get_current_time(context: Dict) -> str:
         ToolExample("How many embryos do we have?", {}),
     ],
 )
-def get_experiment_summary(context: Dict) -> str:
+def get_experiment_summary(context: dict) -> str:
     """Get full experiment summary"""
     agent, err = require_agent(context)
     if err:
@@ -51,17 +54,19 @@ def get_experiment_summary(context: Dict) -> str:
 
 @tool(
     name="query_embryo_status",
-    description="""Query detailed status of a specific embryo including position, calibration data, imaging history, and detection results.
-Use this when the user asks about a specific embryo by ID or number (e.g., "how is embryo 3?", "check embryo_1").
-Returns JSON with stage_position, piezo_center, galvo_center, timepoints_acquired, and detection_results.
-The embryo_id can be like "embryo_1", "embryo_3", etc.""",
+    description="""Query detailed status of a specific embryo including position, calibration data,
+imaging history, and detection results.
+Use this when the user asks about a specific embryo by ID or number (e.g., "how is embryo 3?",
+"check embryo_1"). Returns JSON with stage_position, piezo_center, galvo_center,
+timepoints_acquired, and detection_results. The embryo_id can be like "embryo_1",
+"embryo_3", etc.""",
     category=ToolCategory.EMBRYO,
     examples=[
         ToolExample("What's happening with embryo 1?", {"embryo_id": "embryo_1"}),
         ToolExample("Check on embryo 3", {"embryo_id": "embryo_3"}),
     ],
 )
-def query_embryo_status(embryo_id: str, context: Dict) -> str:
+def query_embryo_status(embryo_id: str, context: dict) -> str:
     """Query embryo status"""
     agent, err = require_agent(context)
     if err:
@@ -76,15 +81,20 @@ def query_embryo_status(embryo_id: str, context: Dict) -> str:
 
 @tool(
     name="skip_embryo",
-    description="""Mark an embryo to be skipped in future timelapse acquisitions. The embryo remains in the experiment but won't be imaged.
-Use when user wants to temporarily stop imaging an embryo (e.g., "skip embryo 2", "stop imaging embryo_3").
-Requires a reason to document why the embryo is being skipped. Can be resumed later with resume_embryo.""",
+    description="""Mark an embryo to be skipped in future timelapse acquisitions. The embryo
+remains in the experiment but won't be imaged.
+Use when user wants to temporarily stop imaging an embryo (e.g., "skip embryo 2",
+"stop imaging embryo_3"). Requires a reason to document why the embryo is being skipped.
+Can be resumed later with resume_embryo.""",
     category=ToolCategory.EMBRYO,
     examples=[
-        ToolExample("Skip embryo 2, it's dead", {"embryo_id": "embryo_2", "reason": "embryo dead"}),
+        ToolExample(
+            "Skip embryo 2, it's dead",
+            {"embryo_id": "embryo_2", "reason": "embryo dead"},
+        ),
     ],
 )
-def skip_embryo(embryo_id: str, reason: str, context: Dict) -> str:
+def skip_embryo(embryo_id: str, reason: str, context: dict) -> str:
     """Skip embryo in future acquisitions"""
     agent, err = require_agent(context)
     if err:
@@ -102,7 +112,8 @@ def skip_embryo(embryo_id: str, reason: str, context: Dict) -> str:
 
 @tool(
     name="remove_embryo",
-    description="""Permanently remove an embryo from the experiment. This is irreversible - use for false detections or debris.
+    description="""Permanently remove an embryo from the experiment. This is irreversible
+- use for false detections or debris.
 Use when user says "remove embryo X", "delete embryo X", or "that's not an embryo".
 Unlike skip_embryo, this completely removes the embryo from tracking. Use carefully.""",
     category=ToolCategory.EMBRYO,
@@ -110,7 +121,7 @@ def skip_embryo(embryo_id: str, reason: str, context: Dict) -> str:
         ToolExample("Remove embryo 4, it's a false positive", {"embryo_id": "embryo_4"}),
     ],
 )
-def remove_embryo(embryo_id: str, context: Dict) -> str:
+def remove_embryo(embryo_id: str, context: dict) -> str:
     """Remove embryo from experiment completely"""
     agent, err = require_agent(context)
     if err:
@@ -129,14 +140,16 @@ def remove_embryo(embryo_id: str, context: Dict) -> str:
 
 @tool(
     name="resume_embryo",
-    description="""Resume imaging a previously skipped embryo. Clears the skip flag so the embryo will be included in future acquisitions.
-Use when user wants to start imaging an embryo again after it was skipped (e.g., "resume embryo 2", "start imaging embryo_3 again").""",
+    description="""Resume imaging a previously skipped embryo. Clears the skip flag so the embryo
+will be included in future acquisitions.
+Use when user wants to start imaging an embryo again after it was skipped (e.g.,
+"resume embryo 2", "start imaging embryo_3 again").""",
     category=ToolCategory.EMBRYO,
     examples=[
         ToolExample("Resume imaging embryo 2", {"embryo_id": "embryo_2"}),
     ],
 )
-def resume_embryo(embryo_id: str, context: Dict) -> str:
+def resume_embryo(embryo_id: str, context: dict) -> str:
     """Resume skipped embryo"""
     agent, err = require_agent(context)
     if err:
@@ -155,14 +168,15 @@ def resume_embryo(embryo_id: str, context: Dict) -> str:
 @tool(
     name="assign_nickname",
     description="""Assign a memorable nickname to an embryo for easier reference in conversation.
-Use when you notice distinguishing characteristics or the user wants to name an embryo (e.g., "call embryo 1 speedy", "nickname embryo_2 as the fast one").
+Use when you notice distinguishing characteristics or the user wants to name an embryo
+(e.g., "call embryo 1 speedy", "nickname embryo_2 as the fast one").
 Nicknames make conversation more natural - you can then refer to embryos by nickname.""",
     category=ToolCategory.EMBRYO,
     examples=[
         ToolExample("Call embryo 1 speedy", {"embryo_id": "embryo_1", "nickname": "speedy"}),
     ],
 )
-def assign_nickname(embryo_id: str, nickname: str, context: Dict) -> str:
+def assign_nickname(embryo_id: str, nickname: str, context: dict) -> str:
     """Assign nickname to embryo"""
     agent, err = require_agent(context)
     if err:
@@ -183,24 +197,45 @@ def assign_nickname(embryo_id: str, nickname: str, context: Dict) -> str:
 
 @tool(
     name="modify_parameters",
-    description="""Modify acquisition parameters for a specific embryo. Supported keys: interval_seconds, num_slices, exposure_ms, priority, acquisition_mode, laser_power_488_pct.
-Use when user wants to adjust imaging for one embryo (e.g., "image embryo 2 faster", "use snap mode for embryo_1", "drop 488 to 3% for embryo_3").
-acquisition_mode can be "volume" (full 3D stack, default) or "snap" (single 2D lightsheet image - faster, less light exposure).
-laser_power_488_pct is hard-limited at the device layer (currently 2-6% — see DiSPIMLightSource.POWER_LIMITS_PCT). Out-of-range values are rejected at the tool boundary AND at the device.
-Requires a reason to document why parameters are being changed. Changes take effect at the next acquisition.""",
+    description="""Modify acquisition parameters for a specific embryo. Supported keys:
+interval_seconds, num_slices, exposure_ms, priority, acquisition_mode, laser_power_488_pct.
+Use when user wants to adjust imaging for one embryo (e.g., "image embryo 2 faster",
+"use snap mode for embryo_1", "drop 488 to 3% for embryo_3").
+acquisition_mode can be "volume" (full 3D stack, default) or "snap" (single 2D lightsheet
+image - faster, less light exposure).
+laser_power_488_pct is hard-limited at the device layer (currently 2-6% — see
+DiSPIMLightSource.POWER_LIMITS_PCT). Out-of-range values are rejected at the tool boundary
+AND at the device. Requires a reason to document why parameters are being changed.
+Changes take effect at the next acquisition.""",
     category=ToolCategory.EMBRYO,
     examples=[
-        ToolExample("Image embryo 2 every 30 seconds", {"embryo_id": "embryo_2", "changes": {"interval_seconds": 30}, "reason": "pre-hatching monitoring"}),
-        ToolExample("Use snap mode for embryo 1", {"embryo_id": "embryo_1", "changes": {"acquisition_mode": "snap"}, "reason": "reduce light exposure"}),
-        ToolExample("Drop 488 power on embryo 3 to 3%", {"embryo_id": "embryo_3", "changes": {"laser_power_488_pct": 3.0}, "reason": "signal saturating"}),
+        ToolExample(
+            "Image embryo 2 every 30 seconds",
+            {
+                "embryo_id": "embryo_2",
+                "changes": {"interval_seconds": 30},
+                "reason": "pre-hatching monitoring",
+            },
+        ),
+        ToolExample(
+            "Use snap mode for embryo 1",
+            {
+                "embryo_id": "embryo_1",
+                "changes": {"acquisition_mode": "snap"},
+                "reason": "reduce light exposure",
+            },
+        ),
+        ToolExample(
+            "Drop 488 power on embryo 3 to 3%",
+            {
+                "embryo_id": "embryo_3",
+                "changes": {"laser_power_488_pct": 3.0},
+                "reason": "signal saturating",
+            },
+        ),
     ],
 )
-def modify_parameters(
-    embryo_id: str,
-    changes: Dict,
-    reason: str,
-    context: Dict
-) -> str:
+def modify_parameters(embryo_id: str, changes: dict, reason: str, context: dict) -> str:
     """Modify embryo acquisition parameters"""
     agent, err = require_agent(context)
     if err:
@@ -211,34 +246,35 @@ def modify_parameters(
         return err
 
     old_params = {
-        'interval_seconds': embryo.interval_seconds,
-        'num_slices': embryo.num_slices,
-        'exposure_ms': embryo.exposure_ms,
-        'priority': embryo.priority,
-        'acquisition_mode': embryo.acquisition_mode,
-        'laser_power_488_pct': embryo.laser_power_488_pct,
+        "interval_seconds": embryo.interval_seconds,
+        "num_slices": embryo.num_slices,
+        "exposure_ms": embryo.exposure_ms,
+        "priority": embryo.priority,
+        "acquisition_mode": embryo.acquisition_mode,
+        "laser_power_488_pct": embryo.laser_power_488_pct,
     }
 
-    if 'interval_seconds' in changes:
-        embryo.interval_seconds = changes['interval_seconds']
-    if 'num_slices' in changes:
-        embryo.num_slices = changes['num_slices']
-    if 'exposure_ms' in changes:
-        embryo.exposure_ms = changes['exposure_ms']
-    if 'priority' in changes:
-        embryo.priority = changes['priority']
-    if 'acquisition_mode' in changes:
-        mode = changes['acquisition_mode']
-        if mode in ('volume', 'snap'):
+    if "interval_seconds" in changes:
+        embryo.interval_seconds = changes["interval_seconds"]
+    if "num_slices" in changes:
+        embryo.num_slices = changes["num_slices"]
+    if "exposure_ms" in changes:
+        embryo.exposure_ms = changes["exposure_ms"]
+    if "priority" in changes:
+        embryo.priority = changes["priority"]
+    if "acquisition_mode" in changes:
+        mode = changes["acquisition_mode"]
+        if mode in ("volume", "snap"):
             embryo.acquisition_mode = mode
         else:
             return f"Invalid acquisition_mode '{mode}'. Use 'volume' or 'snap'."
-    if 'laser_power_488_pct' in changes:
+    if "laser_power_488_pct" in changes:
         # Soft-validate at the tool layer so the agent gets a clean error
         # without round-tripping to the device. Hard limit is enforced
         # at DiSPIMLightSource.set_power_pct regardless.
         from gently.hardware.dispim.devices.optical import DiSPIMLightSource
-        pct = changes['laser_power_488_pct']
+
+        pct = changes["laser_power_488_pct"]
         lo, hi = DiSPIMLightSource.POWER_LIMITS_PCT.get(488, (0.0, 100.0))
         if pct is not None and not (lo <= pct <= hi):
             return (
@@ -248,32 +284,43 @@ def modify_parameters(
             )
         embryo.laser_power_488_pct = pct
 
-    return (f"Modified {embryo_id} parameters:\n"
-            f"Reason: {reason}\n\n"
-            f"Changes:\n{json.dumps(changes, indent=2)}\n\n"
-            f"Previous: {json.dumps(old_params, indent=2)}")
+    return (
+        f"Modified {embryo_id} parameters:\n"
+        f"Reason: {reason}\n\n"
+        f"Changes:\n{json.dumps(changes, indent=2)}\n\n"
+        f"Previous: {json.dumps(old_params, indent=2)}"
+    )
 
 
 @tool(
     name="assign_embryo_roles",
-    description="""Assign experimental roles (test / calibration / unassigned) to one or more embryos.
-Use when the user has marked embryos in the map view and is classifying which are biological subjects (test) vs reference/calibration samples (calibration).
-Roles drive cadence policy, detector selection, photodose budget, and UI color. Pass a dict mapping embryo_id -> role name.
+    description="""Assign experimental roles (test / calibration / unassigned) to one or more
+embryos. Use when the user has marked embryos in the map view and is classifying which are
+biological subjects (test) vs reference/calibration samples (calibration).
+Roles drive cadence policy, detector selection, photodose budget, and UI color. Pass a dict
+mapping embryo_id -> role name.
 Available roles come from gently.harness.roles.REGISTRY: 'test', 'calibration', 'unassigned'.""",
     category=ToolCategory.EMBRYO,
     examples=[
         ToolExample("Mark embryo 1 as calibration", {"roles": {"embryo_1": "calibration"}}),
         ToolExample(
             "Embryos 1-2 are calibration, 3-5 are test",
-            {"roles": {"embryo_1": "calibration", "embryo_2": "calibration",
-                       "embryo_3": "test", "embryo_4": "test", "embryo_5": "test"}},
+            {
+                "roles": {
+                    "embryo_1": "calibration",
+                    "embryo_2": "calibration",
+                    "embryo_3": "test",
+                    "embryo_4": "test",
+                    "embryo_5": "test",
+                }
+            },
         ),
     ],
 )
-def assign_embryo_roles(roles: Dict[str, str], context: Dict) -> str:
+def assign_embryo_roles(roles: dict[str, str], context: dict) -> str:
     """Assign roles to embryos. Validates against gently.harness.roles.REGISTRY."""
-    from gently.harness.roles import get_role, list_roles
     from gently.core import EventType, get_event_bus
+    from gently.harness.roles import get_role, list_roles
 
     agent, err = require_agent(context)
     if err:
@@ -294,10 +341,7 @@ def assign_embryo_roles(roles: Dict[str, str], context: Dict) -> str:
         except KeyError:
             invalid_roles.append((eid, role_name))
     if invalid_roles:
-        return (
-            f"Invalid role(s): {invalid_roles}. "
-            f"Available roles: {list_roles()}"
-        )
+        return f"Invalid role(s): {invalid_roles}. Available roles: {list_roles()}"
 
     # Apply
     event_bus = get_event_bus()
@@ -314,7 +358,8 @@ def assign_embryo_roles(roles: Dict[str, str], context: Dict) -> str:
         if getattr(agent, "store", None) and getattr(agent, "session_id", None):
             pos = embryo.stage_position or {}
             agent.store.register_embryo(
-                agent.session_id, eid,
+                agent.session_id,
+                eid,
                 position_x=pos.get("x"),
                 position_y=pos.get("y"),
                 calibration=embryo.calibration,
diff --git a/gently/app/tools/focus_tools.py b/gently/app/tools/focus_tools.py
index 50b24ab7..63f043e5 100644
--- a/gently/app/tools/focus_tools.py
+++ b/gently/app/tools/focus_tools.py
@@ -11,34 +11,35 @@
 - Predicting optimal focus for future acquisitions
 """
 
-from typing import Dict, List, Optional
 from datetime import datetime
-import numpy as np
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
-from gently.harness.tools.helpers import get_embryo_or_error
+import numpy as np
 
 # Import focus analysis functions from core
 from gently.analysis.core import (
+    FitFunction,
+    FocusAnalysisConfig,
     calculate_focus_score,
     fit_focus_curve,
-    FocusAlgorithm,
-    FocusAnalysisConfig,
-    FitFunction,
 )
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
     name="fine_focus",
-    description="""Perform fine focus adjustment by scanning piezo positions and finding optimal focus using image analysis.
-Sweeps the piezo through a range of positions, captures lightsheet images at each position, calculates focus scores
-using FFT bandpass or gradient algorithm, fits a Gaussian curve, and optionally moves to the best focus position.
-
-Use when user says "focus", "fine focus", "adjust focus", "find best focus", or after moving to an embryo position.
-Default sweep is ±3μm around 4μm with 1μm steps (7 positions). Algorithm options: 'fft_bandpass' (default, best for lightsheet) or 'gradient'.
-
-If embryo_id is provided, logs the focus measurement to the embryo's focus_history for drift tracking and future reference.
-Returns the optimal piezo position and fit quality (R²). Higher R² indicates more reliable focus detection.""",
+    description="""Perform fine focus adjustment by scanning piezo positions and finding
+optimal focus using image analysis.
+Sweeps the piezo through a range of positions, captures lightsheet images at each position,
+calculates focus scores using FFT bandpass or gradient algorithm, fits a Gaussian curve,
+and optionally moves to the best focus position.
+
+Use when user says "focus", "fine focus", "adjust focus", "find best focus", or after
+moving to an embryo position. Default sweep is ±3μm around 4μm with 1μm steps (7
+positions). Algorithm options: 'fft_bandpass' (default, best for lightsheet) or 'gradient'.
+
+If embryo_id is provided, logs the focus measurement to the embryo's focus_history for
+drift tracking and future reference. Returns the optimal piezo position and fit quality (R²).
+Higher R² indicates more reliable focus detection.""",
     category=ToolCategory.CALIBRATION,
     requires_microscope=True,
     examples=[
@@ -51,12 +52,12 @@
 async def fine_focus(
     range_um: float = 3.0,
     step_um: float = 1.0,
-    center_um: Optional[float] = 4.0,
+    center_um: float | None = 4.0,
     algorithm: str = "fft_bandpass",
     move_to_best: bool = True,
     galvo_position: float = 0.0,
-    embryo_id: Optional[str] = None,
-    context: Dict = None
+    embryo_id: str | None = None,
+    context: dict = None,
 ) -> str:
     """
     Perform fine focus sweep to find optimal piezo position.
@@ -76,18 +77,19 @@ async def fine_focus(
     galvo_position : float
         Galvo position to use during sweep (default: 0.0)
     embryo_id : str, optional
-        Embryo to associate this focus measurement with. If provided, logs to embryo's focus_history.
+        Embryo to associate this focus measurement with. If provided, logs to embryo's
+        focus_history.
     context : dict
         Execution context with client and agent
     """
-    client = context.get('client')
-    agent = context.get('agent')
+    client = context.get("client")
+    agent = context.get("agent")
 
     if not client:
         return "Error: No microscope client connected"
 
     # Validate algorithm
-    valid_algorithms = ['fft_bandpass', 'gradient', 'volath', 'variance']
+    valid_algorithms = ["fft_bandpass", "gradient", "volath", "variance"]
     if algorithm not in valid_algorithms:
         return f"Error: Unknown algorithm '{algorithm}'. Valid options: {valid_algorithms}"
 
@@ -104,14 +106,13 @@ async def fine_focus(
         images = []
         captured_positions = []
 
-        for i, pos in enumerate(positions):
+        for _i, pos in enumerate(positions):
             result = await client.capture_lightsheet_image(
-                piezo_position=float(pos),
-                galvo_position=float(galvo_position)
+                piezo_position=float(pos), galvo_position=float(galvo_position)
             )
 
-            if result.get('success') and result.get('image') is not None:
-                images.append(result['image'])
+            if result.get("success") and result.get("image") is not None:
+                images.append(result["image"])
                 captured_positions.append(pos)
 
         if len(images) < 3:
@@ -121,7 +122,7 @@ async def fine_focus(
         scores = []
         config = FocusAnalysisConfig(algorithm=algorithm)
 
-        for i, img in enumerate(images):
+        for _i, img in enumerate(images):
             score = calculate_focus_score(img, algorithm=algorithm, config=config)
             scores.append(score)
 
@@ -146,14 +147,17 @@ async def fine_focus(
                 fit_quality = "good" if r_squared >= 0.75 else "moderate"
 
                 # Check if fitted peak is within sweep range
-                if best_position < captured_positions.min() or best_position > captured_positions.max():
+                if (
+                    best_position < captured_positions.min()
+                    or best_position > captured_positions.max()
+                ):
                     best_position = best_measured_position
                     fit_quality = "fallback (peak outside range)"
             else:
                 best_position = best_measured_position
                 fit_quality = "poor"
 
-        except Exception as e:
+        except Exception:
             best_position = best_measured_position
             r_squared = 0.0
             fit_quality = "failed"
@@ -162,7 +166,7 @@ async def fine_focus(
         if move_to_best:
             await client.capture_lightsheet_image(
                 piezo_position=float(best_position),
-                galvo_position=float(galvo_position)
+                galvo_position=float(galvo_position),
             )
 
         # Log focus datapoint to embryo's focus_history if embryo_id provided
@@ -175,7 +179,7 @@ async def fine_focus(
                     piezo=best_position,
                     score=float(best_measured_score),
                     r_squared=float(r_squared),
-                    method='fine_focus',
+                    method="fine_focus",
                     algorithm=algorithm,
                 )
                 logged_to_embryo = True
@@ -185,11 +189,12 @@ async def fine_focus(
 
         # Build result message
         result_lines = [
-            f"✓ Fine focus complete",
+            "✓ Fine focus complete",
             f"  Optimal position: {best_position:.2f} μm",
             f"  Fit quality: {fit_quality} (R²={r_squared:.3f})",
             f"  Algorithm: {algorithm}",
-            f"  Sweep: {captured_positions.min():.1f} to {captured_positions.max():.1f} μm ({len(captured_positions)} positions)",
+            f"  Sweep: {captured_positions.min():.1f} to {captured_positions.max():.1f} μm"
+            f" ({len(captured_positions)} positions)",
         ]
 
         if move_to_best:
@@ -199,21 +204,25 @@ async def fine_focus(
             result_lines.append(f"  Logged to: {embryo_id} focus history")
 
         # Add score statistics
-        score_range = scores.max() - scores.min()
+        scores.max() - scores.min()
         score_cv = np.std(scores) / np.mean(scores) if np.mean(scores) > 0 else 0
-        result_lines.append(f"  Score variation: {score_cv:.1%} (higher is better for focus detection)")
+        result_lines.append(
+            f"  Score variation: {score_cv:.1%} (higher is better for focus detection)"
+        )
 
         return "\n".join(result_lines)
 
     except Exception as e:
         import traceback
+
         return f"Error during fine focus: {str(e)}\n{traceback.format_exc()}"
 
 
 @tool(
     name="get_focus_score",
     description="""Calculate focus score for the current lightsheet image without moving the piezo.
-Captures a single lightsheet image and returns its focus quality score using the specified algorithm.
+Captures a single lightsheet image and returns its focus quality score using the specified
+algorithm.
 Use to check focus quality at current position or compare different positions manually.
 If piezo_position is not specified, uses CURRENT position (preserves focus after fine_focus).
 Algorithm options: 'fft_bandpass' (default), 'gradient', 'volath', 'variance'.""",
@@ -228,7 +237,7 @@ async def get_focus_score(
     piezo_position: float = None,
     galvo_position: float = 0.0,
     algorithm: str = "fft_bandpass",
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """
     Get focus score for current or specified position.
@@ -244,12 +253,12 @@ async def get_focus_score(
     context : dict
         Execution context
     """
-    client = context.get('client')
+    client = context.get("client")
 
     if not client:
         return "Error: No microscope client connected"
 
-    valid_algorithms = ['fft_bandpass', 'gradient', 'volath', 'variance']
+    valid_algorithms = ["fft_bandpass", "gradient", "volath", "variance"]
     if algorithm not in valid_algorithms:
         return f"Error: Unknown algorithm '{algorithm}'. Valid options: {valid_algorithms}"
 
@@ -260,14 +269,13 @@ async def get_focus_score(
 
         # Capture image
         result = await client.capture_lightsheet_image(
-            piezo_position=float(piezo_position),
-            galvo_position=float(galvo_position)
+            piezo_position=float(piezo_position), galvo_position=float(galvo_position)
         )
 
-        if not result.get('success') or result.get('image') is None:
+        if not result.get("success") or result.get("image") is None:
             return f"Error: Failed to capture image at piezo={piezo_position}μm"
 
-        image = result['image']
+        image = result["image"]
 
         # Calculate focus score
         config = FocusAnalysisConfig(algorithm=algorithm)
@@ -286,7 +294,8 @@ async def get_focus_score(
 
 @tool(
     name="get_focus_history",
-    description="""Get the focus history for an embryo showing all piezo-galvo measurements over time.
+    description="""Get the focus history for an embryo showing all piezo-galvo measurements
+over time.
 Shows drift rate, piezo-galvo fit, and individual measurements. Use to understand how focus
 has changed during a timelapse and whether recalibration is needed.""",
     category=ToolCategory.ANALYSIS,
@@ -295,10 +304,7 @@ async def get_focus_score(
         ToolExample("Check focus history for embryo 2", {"embryo_id": "embryo_2"}),
     ],
 )
-async def get_focus_history(
-    embryo_id: str,
-    context: Dict = None
-) -> str:
+async def get_focus_history(embryo_id: str, context: dict = None) -> str:
     """
     Get focus measurement history for an embryo.
 
@@ -309,7 +315,7 @@ async def get_focus_history(
     context : dict
         Execution context with agent
     """
-    agent = context.get('agent')
+    agent = context.get("agent")
 
     if not agent:
         return "Error: No agent context available"
diff --git a/gently/app/tools/hardware_common.py b/gently/app/tools/hardware_common.py
index aa48c2b9..60e07534 100644
--- a/gently/app/tools/hardware_common.py
+++ b/gently/app/tools/hardware_common.py
@@ -1,4 +1,5 @@
 """Shared helpers for hardware tools."""
+
 import numpy as np
 
 
diff --git a/gently/app/tools/interaction_tools.py b/gently/app/tools/interaction_tools.py
index ba52c7d5..3e667823 100644
--- a/gently/app/tools/interaction_tools.py
+++ b/gently/app/tools/interaction_tools.py
@@ -6,10 +6,8 @@
 """
 
 import json
-from typing import Dict, List, Optional
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 # Special marker for CLI to detect choice responses
 CHOICE_RESPONSE_TYPE = "_user_choice_request"
@@ -33,28 +31,34 @@
     category=ToolCategory.EXPERIMENT,
     requires_microscope=False,
     examples=[
-        ToolExample("Ask which session", {
-            "question": "Which session to import from?",
-            "options": [
-                {"id": "abc123", "label": "Today's session (4 embryos)"},
-                {"id": "def456", "label": "Yesterday (2 embryos)"},
-            ]
-        }),
-        ToolExample("Yes/No confirmation", {
-            "question": "Start the timelapse?",
-            "options": [
-                {"id": "yes", "label": "Yes, start now"},
-                {"id": "no", "label": "No, cancel"},
-            ]
-        }),
+        ToolExample(
+            "Ask which session",
+            {
+                "question": "Which session to import from?",
+                "options": [
+                    {"id": "abc123", "label": "Today's session (4 embryos)"},
+                    {"id": "def456", "label": "Yesterday (2 embryos)"},
+                ],
+            },
+        ),
+        ToolExample(
+            "Yes/No confirmation",
+            {
+                "question": "Start the timelapse?",
+                "options": [
+                    {"id": "yes", "label": "Yes, start now"},
+                    {"id": "no", "label": "No, cancel"},
+                ],
+            },
+        ),
     ],
 )
 async def ask_user_choice(
     question: str,
-    options: List[Dict[str, str]],
+    options: list[dict[str, str]],
     allow_multiple: bool = False,
-    default_id: Optional[str] = None,
-    context: Dict = None
+    default_id: str | None = None,
+    context: dict = None,
 ) -> str:
     """
     Present user with selectable options.
@@ -88,7 +92,7 @@ async def ask_user_choice(
         return "Error: Must provide at least one option"
 
     for i, opt in enumerate(options):
-        if 'id' not in opt or 'label' not in opt:
+        if "id" not in opt or "label" not in opt:
             return f"Error: Option {i} missing required 'id' or 'label' field"
 
     # Return special format that CLI will intercept and render
@@ -103,7 +107,7 @@ async def ask_user_choice(
     return json.dumps(choice_request)
 
 
-def parse_choice_response(response: str) -> Optional[Dict]:
+def parse_choice_response(response: str) -> dict | None:
     """
     Parse a tool response to check if it's a choice request.
 
@@ -128,7 +132,8 @@ def parse_choice_response(response: str) -> Optional[Dict]:
 
 # Helper functions for common choice patterns
 
-def yes_no_options(yes_label: str = "Yes", no_label: str = "No") -> List[Dict[str, str]]:
+
+def yes_no_options(yes_label: str = "Yes", no_label: str = "No") -> list[dict[str, str]]:
     """Generate standard Yes/No options"""
     return [
         {"id": "yes", "label": yes_label},
@@ -137,10 +142,8 @@ def yes_no_options(yes_label: str = "Yes", no_label: str = "No") -> List[Dict[st
 
 
 def yes_no_cancel_options(
-    yes_label: str = "Yes",
-    no_label: str = "No",
-    cancel_label: str = "Cancel"
-) -> List[Dict[str, str]]:
+    yes_label: str = "Yes", no_label: str = "No", cancel_label: str = "Cancel"
+) -> list[dict[str, str]]:
     """Generate Yes/No/Cancel options"""
     return [
         {"id": "yes", "label": yes_label},
@@ -149,7 +152,7 @@ def yes_no_cancel_options(
     ]
 
 
-def embryo_options(agent) -> List[Dict[str, str]]:
+def embryo_options(agent) -> list[dict[str, str]]:
     """Generate options from available embryos"""
     options = []
     for eid, embryo in agent.experiment.embryos.items():
@@ -168,23 +171,19 @@ def embryo_options(agent) -> List[Dict[str, str]]:
     return options
 
 
-def session_options(sessions: List[Dict]) -> List[Dict[str, str]]:
+def session_options(sessions: list[dict]) -> list[dict[str, str]]:
     """Generate options from available sessions"""
     options = []
     for session in sessions:
-        sid = session.get('session_id', session.get('id', 'unknown'))
-        embryo_count = session.get('embryo_count', 0)
-        message_count = session.get('message_count', 0)
-        last_active = session.get('last_active', 'unknown')
+        sid = session.get("session_id", session.get("id", "unknown"))
+        embryo_count = session.get("embryo_count", 0)
+        message_count = session.get("message_count", 0)
+        last_active = session.get("last_active", "unknown")
 
         label = f"{sid[:8]} - {embryo_count} embryos, {message_count} messages"
-        if last_active != 'unknown':
+        if last_active != "unknown":
             label += f" (last: {last_active})"
 
-        options.append({
-            "id": sid,
-            "label": label,
-            "description": f"Session {sid}"
-        })
+        options.append({"id": sid, "label": label, "description": f"Session {sid}"})
 
     return options
diff --git a/gently/app/tools/led_tools.py b/gently/app/tools/led_tools.py
index d2c3a9e6..92aac49c 100644
--- a/gently/app/tools/led_tools.py
+++ b/gently/app/tools/led_tools.py
@@ -4,9 +4,7 @@
 Tools for controlling microscope LED illumination.
 """
 
-from typing import Dict
-
-from gently.harness.tools.registry import tool, ToolCategory
+from gently.harness.tools.registry import ToolCategory, tool
 
 
 @tool(
@@ -15,13 +13,13 @@
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
 )
-async def set_led(state: str, context: Dict) -> str:
+async def set_led(state: str, context: dict) -> str:
     """Set LED state"""
-    client = context.get('client')
+    client = context.get("client")
 
     try:
         result = await client.set_led(state)
-        if result.get('success'):
+        if result.get("success"):
             return f"LED set to '{state}'"
         else:
             return f"Error setting LED: {result.get('error', 'Unknown error')}"
@@ -35,21 +33,23 @@ async def set_led(state: str, context: Dict) -> str:
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
 )
-async def get_led_status(context: Dict) -> str:
+async def get_led_status(context: dict) -> str:
     """Get LED status"""
-    client = context.get('client')
+    client = context.get("client")
 
     try:
         result = await client.get_led_status()
-        if result.get('success'):
-            current = result.get('current_state', 'unknown')
-            available = result.get('available_configs', [])
-            group = result.get('group_name', 'unknown')
-
-            return (f"LED Status:\n"
-                    f"  Current state: {current}\n"
-                    f"  ConfigGroup: {group}\n"
-                    f"  Available configs: {available}")
+        if result.get("success"):
+            current = result.get("current_state", "unknown")
+            available = result.get("available_configs", [])
+            group = result.get("group_name", "unknown")
+
+            return (
+                f"LED Status:\n"
+                f"  Current state: {current}\n"
+                f"  ConfigGroup: {group}\n"
+                f"  Available configs: {available}"
+            )
         else:
             return f"Error getting LED status: {result.get('error', 'Unknown error')}"
     except Exception as e:
diff --git a/gently/app/tools/light_source_tools.py b/gently/app/tools/light_source_tools.py
index c0093a87..0f144082 100644
--- a/gently/app/tools/light_source_tools.py
+++ b/gently/app/tools/light_source_tools.py
@@ -14,21 +14,25 @@
 ``modify_parameters(embryo_id, {"laser_power_488_pct": ...}, ...)``.
 """
 
-from typing import Dict
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
     name="set_laser_power",
-    description="""Set per-line laser power % directly (not tied to any embryo). Submits a Bluesky plan via the queue server so the change is traceable.
+    description="""Set per-line laser power % directly (not tied to any embryo). Submits a
+Bluesky plan via the queue server so the change is traceable.
 
-Hard-limited at the device layer (DiSPIMLightSource.POWER_LIMITS_PCT). 488 is constrained to 2-6% by default. Out-of-range values are rejected at the device layer (ValueError); the tool returns the error.
+Hard-limited at the device layer (DiSPIMLightSource.POWER_LIMITS_PCT). 488 is constrained
+to 2-6% by default. Out-of-range values are rejected at the device layer (ValueError); the
+tool returns the error.
 
-After setting, the tool reads back the actual setpoint and includes it in the response so the agent can verify.
+After setting, the tool reads back the actual setpoint and includes it in the response so
+the agent can verify.
 
-Use for: pre-experiment setup, ad-hoc inspection, calibration. For experiment-scoped per-embryo changes during a timelapse, use modify_parameters with laser_power_488_pct instead.""",
+Use for: pre-experiment setup, ad-hoc inspection, calibration. For experiment-scoped
+per-embryo changes during a timelapse, use modify_parameters with laser_power_488_pct
+instead.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
     examples=[
@@ -39,7 +43,7 @@
 async def set_laser_power(
     wavelength: int,
     pct: float,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Set laser power and read back the actual setpoint."""
     agent, err = require_agent(context)
@@ -66,16 +70,14 @@ async def set_laser_power(
         actual = None
 
     if actual is not None:
-        return (
-            f"{wavelength}nm power set to {pct}% "
-            f"(readback: {actual:.4f}%)"
-        )
+        return f"{wavelength}nm power set to {pct}% (readback: {actual:.4f}%)"
     return f"{wavelength}nm power set to {pct}% (readback unavailable)"
 
 
 @tool(
     name="get_laser_power",
-    description="""Read the current per-line laser power % from the device. Useful to verify state before/after a change, or to spot-check the current illumination during a long run.""",
+    description="""Read the current per-line laser power % from the device. Useful to verify
+state before/after a change, or to spot-check the current illumination during a long run.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
     examples=[
@@ -85,7 +87,7 @@ async def set_laser_power(
 )
 async def get_laser_power(
     wavelength: int,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Read current laser power %."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/memory_tools.py b/gently/app/tools/memory_tools.py
index a8d0804c..f586d087 100644
--- a/gently/app/tools/memory_tools.py
+++ b/gently/app/tools/memory_tools.py
@@ -4,12 +4,10 @@
 Thin wrappers around AgentMemory. Available in both run and plan modes.
 """
 
-from typing import Dict, Optional
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 
-
-def _get_memory(context: Dict):
+def _get_memory(context: dict):
     """Extract AgentMemory from tool context."""
     agent = context.get("agent") if context else None
     if not agent or not hasattr(agent, "memory") or not agent.memory:
@@ -38,7 +36,7 @@ def _get_memory(context: Dict):
 )
 async def recall_campaigns(
     status: str = "active",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """List campaigns filtered by status."""
     memory = _get_memory(context)
@@ -68,7 +66,7 @@ async def recall_campaigns(
 async def recall_learnings(
     query: str = None,
     limit: int = 20,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Search or list learnings."""
     memory = _get_memory(context)
@@ -80,8 +78,7 @@ async def recall_learnings(
 @tool(
     name="recall_observations",
     description=(
-        "Search or list observations from past sessions. Can filter by "
-        "keyword or embryo ID."
+        "Search or list observations from past sessions. Can filter by keyword or embryo ID."
     ),
     category=ToolCategory.UTILITY,
     examples=[
@@ -99,7 +96,7 @@ async def recall_observations(
     query: str = None,
     embryo_id: str = None,
     limit: int = 20,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Search or list observations."""
     memory = _get_memory(context)
@@ -125,7 +122,7 @@ async def recall_observations(
 )
 async def recall_context(
     campaign_id: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Full context snapshot."""
     memory = _get_memory(context)
diff --git a/gently/app/tools/plan_execution_tools.py b/gently/app/tools/plan_execution_tools.py
index 1d10b18e..38c1cc31 100644
--- a/gently/app/tools/plan_execution_tools.py
+++ b/gently/app/tools/plan_execution_tools.py
@@ -7,13 +7,11 @@
 """
 
 import logging
-from typing import Dict, List, Optional
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import (
     require_agent,
-    require_timelapse_orchestrator,
 )
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
 
@@ -22,6 +20,7 @@
 # execute_plan_item
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="execute_plan_item",
     description=(
@@ -41,8 +40,8 @@
 )
 async def execute_plan_item(
     item_ref: str,
-    embryo_ids: List[str] = None,
-    context: Dict = None,
+    embryo_ids: list[str] = None,
+    context: dict = None,
 ) -> str:
     """Execute a planned imaging item."""
     agent, err = require_agent(context)
@@ -58,7 +57,7 @@ async def execute_plan_item(
     if not item:
         return f"Plan item '{item_ref}' not found"
 
-    from gently.harness.memory.model import PlanItemType, PlanItemStatus
+    from gently.harness.memory.model import PlanItemStatus, PlanItemType
 
     # 2. Verify type and status
     if item.type != PlanItemType.IMAGING:
@@ -77,7 +76,7 @@ async def execute_plan_item(
     if not spec:
         return f"Plan item '{item.title}' has no imaging spec"
 
-    actions: List[str] = []
+    actions: list[str] = []
 
     # 4. Configure acquisition params on the experiment state
     experiment = getattr(agent, "experiment", None)
@@ -113,7 +112,7 @@ async def execute_plan_item(
     if session_id:
         try:
             cs.link_session_campaign(session_id, item.campaign_id)
-            actions.append(f"session linked to campaign")
+            actions.append("session linked to campaign")
         except Exception:
             pass
 
@@ -123,7 +122,7 @@ async def execute_plan_item(
         status=PlanItemStatus.IN_PROGRESS,
         session_id=session_id,
     )
-    actions.append(f"plan item status → in_progress")
+    actions.append("plan item status → in_progress")
 
     # 8. Start timelapse via orchestrator
     orchestrator = getattr(agent, "timelapse_orchestrator", None)
@@ -131,7 +130,7 @@ async def execute_plan_item(
         try:
             stop_cond = spec.stop_condition or "manual"
             interval = spec.interval_s or 120
-            result = await orchestrator.start(
+            await orchestrator.start(
                 embryo_ids=embryo_ids,
                 stop_condition=stop_cond,
                 base_interval_seconds=interval,
@@ -151,11 +150,11 @@ async def execute_plan_item(
                         logger.error(
                             "Failed to install adaptive interval rule "
                             "(stage=%s, new_interval=%s): %s",
-                            stage_key, new_interval, e,
-                        )
-                        actions.append(
-                            f"interval rule FAILED: {stage_key} → {new_interval}s ({e})"
+                            stage_key,
+                            new_interval,
+                            e,
                         )
+                        actions.append(f"interval rule FAILED: {stage_key} → {new_interval}s ({e})")
         except Exception as e:
             actions.append(f"timelapse start error: {e}")
 
@@ -179,6 +178,7 @@ async def execute_plan_item(
 # complete_current_plan_item
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="complete_current_plan_item",
     description=(
@@ -199,7 +199,7 @@ async def execute_plan_item(
 async def complete_current_plan_item(
     item_ref: str,
     outcome: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Complete a plan item and report newly unblocked items."""
     agent, err = require_agent(context)
@@ -253,12 +253,13 @@ async def complete_current_plan_item(
 # Auto-link helper (used by timelapse_tools.py, Feature 3)
 # ---------------------------------------------------------------------------
 
+
 def try_auto_link_plan_item(
     cs,
     session_id: str,
     stop_condition: str,
     interval_seconds: float,
-) -> Optional[str]:
+) -> str | None:
     """
     Best-effort auto-link: find a planned imaging item that matches the
     current timelapse parameters and link the session.
diff --git a/gently/app/tools/resolution_tools.py b/gently/app/tools/resolution_tools.py
index cd659b79..5de2a5bd 100644
--- a/gently/app/tools/resolution_tools.py
+++ b/gently/app/tools/resolution_tools.py
@@ -20,10 +20,9 @@
 """
 
 import logging
-from typing import Dict, List, Optional
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
 
@@ -43,7 +42,7 @@ def _exit_resolution_if_active(agent, outcome: str) -> None:
         logger.warning(f"exit_resolution_mode failed: {e}")
 
 
-def _set_active_plan_item(agent, plan_item_id: Optional[str]) -> None:
+def _set_active_plan_item(agent, plan_item_id: str | None) -> None:
     """Update both copies of the active plan item — ExperimentState
     (persisted) and AgentMemory (in-memory awareness)."""
     try:
@@ -58,7 +57,7 @@ def _set_active_plan_item(agent, plan_item_id: Optional[str]) -> None:
         pass
 
 
-def _short(text: Optional[str], n: int = 80) -> str:
+def _short(text: str | None, n: int = 80) -> str:
     if not text:
         return ""
     return text if len(text) <= n else text[: n - 1] + "…"
@@ -93,7 +92,7 @@ def _short(text: Optional[str], n: int = 80) -> str:
 async def attach_session_to_plan(
     plan_item_id: str,
     rationale: str = "",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Attach the current session to a plan item."""
     agent, err = require_agent(context)
@@ -161,7 +160,7 @@ async def attach_session_to_plan(
 )
 async def mark_session_standalone(
     description: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Mark the session as a standalone (non-plan) run."""
     agent, err = require_agent(context)
@@ -213,7 +212,7 @@ async def mark_session_standalone(
 )
 async def detach_session_from_plan(
     reason: str = "",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Detach the current session from its plan item."""
     agent, err = require_agent(context)
@@ -277,7 +276,7 @@ async def mark_plan_item_status(
     plan_item_id: str,
     status: str,
     notes: str = "",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Update a plan item's status."""
     agent, err = require_agent(context)
@@ -303,10 +302,7 @@ async def mark_plan_item_status(
     }
     key = status.strip().lower()
     if key not in status_map:
-        return (
-            f"Unknown status '{status}'. Valid: "
-            f"{', '.join(status_map.keys())}."
-        )
+        return f"Unknown status '{status}'. Valid: {', '.join(status_map.keys())}."
 
     target = status_map[key]
     try:
@@ -327,7 +323,7 @@ async def mark_plan_item_status(
 # ---------------------------------------------------------------------------
 
 
-def _apply_spec_to_embryo(embryo, spec) -> List[str]:
+def _apply_spec_to_embryo(embryo, spec) -> list[str]:
     """Write per-embryo acquisition fields from an ImagingSpec.
     Returns a list of human-readable changes made."""
     applied = []
@@ -363,8 +359,8 @@ def _apply_spec_to_embryo(embryo, spec) -> List[str]:
 )
 async def apply_plan_acquisition_spec(
     plan_item_id: str,
-    overrides: Dict = None,
-    context: Dict = None,
+    overrides: dict = None,
+    context: dict = None,
 ) -> str:
     """Apply a plan's ImagingSpec to the experiment."""
     agent, err = require_agent(context)
@@ -386,7 +382,7 @@ async def apply_plan_acquisition_spec(
     overrides = overrides or {}
 
     # Apply per-embryo to anything we already have
-    applied_per_embryo: List[str] = []
+    applied_per_embryo: list[str] = []
     embryo_count = 0
     experiment = getattr(agent, "experiment", None)
     if experiment and experiment.embryos:
@@ -395,17 +391,23 @@ async def apply_plan_acquisition_spec(
             # zero out any field the caller asked us to skip.
             class _Filtered:
                 pass
+
             eff = _Filtered()
             eff.num_slices = (
-                None if "num_slices" in overrides and overrides["num_slices"] is None
+                None
+                if "num_slices" in overrides and overrides["num_slices"] is None
                 else (overrides.get("num_slices") if "num_slices" in overrides else spec.num_slices)
             )
             eff.exposure_ms = (
-                None if "exposure_ms" in overrides and overrides["exposure_ms"] is None
-                else (overrides.get("exposure_ms") if "exposure_ms" in overrides else spec.exposure_ms)
+                None
+                if "exposure_ms" in overrides and overrides["exposure_ms"] is None
+                else (
+                    overrides.get("exposure_ms") if "exposure_ms" in overrides else spec.exposure_ms
+                )
             )
             eff.interval_s = (
-                None if "interval_s" in overrides and overrides["interval_s"] is None
+                None
+                if "interval_s" in overrides and overrides["interval_s"] is None
                 else (overrides.get("interval_s") if "interval_s" in overrides else spec.interval_s)
             )
             changes = _apply_spec_to_embryo(embryo, eff)
@@ -428,13 +430,15 @@ class _Filtered:
                 "stop_condition": spec.stop_condition,
                 "detectors": list(spec.detectors) if spec.detectors else None,
                 "success_criteria": spec.success_criteria,
-                "adaptive_intervals": dict(spec.adaptive_intervals) if spec.adaptive_intervals else None,
+                "adaptive_intervals": dict(spec.adaptive_intervals)
+                if spec.adaptive_intervals
+                else None,
             }
         except Exception:
             pass
 
     # Build a narratable summary for the agent to quote
-    parts: List[str] = []
+    parts: list[str] = []
     if spec.strain:
         parts.append(f"strain={spec.strain}")
     if spec.temperature_c is not None:
@@ -508,7 +512,7 @@ class _Filtered:
 async def recall_sibling_sessions(
     identifier: str,
     limit: int = 10,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Return sessions sharing the given plan item's campaign or the campaign itself."""
     agent, err = require_agent(context)
@@ -520,7 +524,7 @@ async def recall_sibling_sessions(
         return "Error: context store unavailable."
 
     # Try plan-item-first; fall back to treating identifier as campaign id
-    campaign_id: Optional[str] = None
+    campaign_id: str | None = None
     plan_item = cs.resolve_plan_item(identifier) if hasattr(cs, "resolve_plan_item") else None
     if plan_item:
         campaign_id = plan_item.campaign_id
@@ -536,10 +540,11 @@ async def recall_sibling_sessions(
         return f"Could not resolve '{identifier}' to a plan item or campaign."
 
     # Get the campaign tree and walk plan items, collecting session ids
-    sessions: List[Dict] = []
+    sessions: list[dict] = []
     try:
         items = cs.get_plan_items(
-            campaign_id=campaign_id, include_children=True,
+            campaign_id=campaign_id,
+            include_children=True,
         )
     except Exception as e:
         return f"Could not list plan items: {e}"
@@ -555,13 +560,17 @@ async def recall_sibling_sessions(
                 meta = file_store.get_session(sid) or {}
             except Exception:
                 meta = {}
-        sessions.append({
-            "plan_item_title": item.title,
-            "plan_item_status": item.status.value if hasattr(item.status, "value") else str(item.status),
-            "session_id": sid,
-            "last_active": meta.get("last_active"),
-            "name": meta.get("name"),
-        })
+        sessions.append(
+            {
+                "plan_item_title": item.title,
+                "plan_item_status": item.status.value
+                if hasattr(item.status, "value")
+                else str(item.status),
+                "session_id": sid,
+                "last_active": meta.get("last_active"),
+                "name": meta.get("name"),
+            }
+        )
 
     if not sessions:
         return f"No sessions yet for campaign {campaign_id[:8]}."
@@ -596,7 +605,7 @@ async def recall_sibling_sessions(
 )
 async def summarize_campaign_history(
     campaign_id: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Compact campaign-progress summary for resolution-mode reasoning."""
     agent, err = require_agent(context)
@@ -625,8 +634,8 @@ async def summarize_campaign_history(
         status = cs.get_plan_status(campaign.id)
         lines.append(
             f"Plan items: {status['completed']}/{status['total']} done"
-            f"{', ' + str(status['in_progress']) + ' in progress' if status.get('in_progress') else ''}"
-            f"{', ' + str(status['blocked']) + ' blocked' if status.get('blocked') else ''}"
+            + (f", {status['in_progress']} in progress" if status.get("in_progress") else "")
+            + (f", {status['blocked']} blocked" if status.get("blocked") else "")
         )
         next_actions = status.get("next_actions") or []
         if next_actions:
@@ -656,7 +665,7 @@ async def summarize_campaign_history(
     ],
 )
 async def list_imaging_candidates(
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Full deterministic listing of unblocked imaging plan items."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/session_tools.py b/gently/app/tools/session_tools.py
index 30f4fb58..c1284442 100644
--- a/gently/app/tools/session_tools.py
+++ b/gently/app/tools/session_tools.py
@@ -4,24 +4,23 @@
 Tools for session statistics, interaction logging, and experiment comparison.
 """
 
-from typing import Dict, List
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import (
-    require_agent, get_embryo_or_error,
-    require_interaction_logger
+    get_embryo_or_error,
+    require_agent,
+    require_interaction_logger,
 )
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
     name="assess_image_quality",
-    description="Assess image quality metrics (focus, brightness, noise) and suggest parameter adjustments",
+    description=(
+        "Assess image quality metrics (focus, brightness, noise) and suggest parameter adjustments"
+    ),
     category=ToolCategory.ANALYSIS,
 )
 async def assess_image_quality(
-    embryo_id: str = None,
-    suggest_parameters: bool = True,
-    context: Dict = None
+    embryo_id: str = None, suggest_parameters: bool = True, context: dict = None
 ) -> str:
     """Assess image quality and suggest improvements"""
     agent, err = require_agent(context)
@@ -80,20 +79,22 @@ async def assess_image_quality(
         response = agent.claude.messages.create(
             model=agent.model,
             max_tokens=800,
-            messages=[{
-                "role": "user",
-                "content": [
-                    {"type": "text", "text": quality_prompt},
-                    {
-                        "type": "image",
-                        "source": {
-                            "type": "base64",
-                            "media_type": "image/jpeg",
-                            "data": image_b64
-                        }
-                    }
-                ]
-            }]
+            messages=[
+                {
+                    "role": "user",
+                    "content": [
+                        {"type": "text", "text": quality_prompt},
+                        {
+                            "type": "image",
+                            "source": {
+                                "type": "base64",
+                                "media_type": "image/jpeg",
+                                "data": image_b64,
+                            },
+                        },
+                    ],
+                }
+            ],
         )
 
         assessment = response.content[0].text
@@ -136,10 +137,13 @@ async def assess_image_quality(
 
 @tool(
     name="get_session_stats",
-    description="Get statistics for the current agent session including interactions, corrections, and tool usage",
+    description=(
+        "Get statistics for the current agent session including interactions,"
+        " corrections, and tool usage"
+    ),
     category=ToolCategory.DATA,
 )
-def get_session_stats(context: Dict = None) -> str:
+def get_session_stats(context: dict = None) -> str:
     """Get session statistics from interaction logger"""
     agent, err = require_agent(context)
     if err:
@@ -168,10 +172,7 @@ def get_session_stats(context: Dict = None) -> str:
     description="Compare developmental progress across multiple embryos in the current experiment",
     category=ToolCategory.ANALYSIS,
 )
-def compare_embryo_development(
-    embryo_ids: List[str] = None,
-    context: Dict = None
-) -> str:
+def compare_embryo_development(embryo_ids: list[str] = None, context: dict = None) -> str:
     """Compare embryo development"""
     agent, err = require_agent(context)
     if err:
@@ -188,14 +189,16 @@ def compare_embryo_development(
 
     lines = ["Embryo Development Comparison:", ""]
 
-    lines.append(f"{'Embryo':<15} {'Timepoints':<12} {'Stage':<15} {'Hatching Est.':<15} {'Status'}")
+    lines.append(
+        f"{'Embryo':<15} {'Timepoints':<12} {'Stage':<15} {'Hatching Est.':<15} {'Status'}"
+    )
     lines.append("-" * 70)
 
     for embryo in embryos:
         stage = "unknown"
         hatching_est = "N/A"
 
-        if hasattr(agent, 'developmental_tracker') and agent.developmental_tracker:
+        if hasattr(agent, "developmental_tracker") and agent.developmental_tracker:
             current = agent.developmental_tracker.get_current_stage(embryo.id)
             if current:
                 stage = current.stage.value
@@ -205,17 +208,18 @@ def compare_embryo_development(
 
         if embryo.should_skip:
             status = f"skipped ({embryo.skip_reason})"
-        elif embryo.hatching_status and embryo.hatching_status.get('detected'):
+        elif embryo.hatching_status and embryo.hatching_status.get("detected"):
             status = "HATCHED"
         else:
             status = "active"
 
         lines.append(
-            f"{embryo.id:<15} {embryo.timepoints_acquired:<12} {stage:<15} {hatching_est:<15} {status}"
+            f"{embryo.id:<15} {embryo.timepoints_acquired:<12} {stage:<15}"
+            f" {hatching_est:<15} {status}"
         )
 
     active = sum(1 for e in embryos if not e.should_skip)
-    hatched = sum(1 for e in embryos if e.hatching_status and e.hatching_status.get('detected'))
+    hatched = sum(1 for e in embryos if e.hatching_status and e.hatching_status.get("detected"))
 
     lines.append("")
     lines.append(f"Summary: {active} active, {hatched} hatched, {len(embryos) - active} skipped")
@@ -225,13 +229,12 @@ def compare_embryo_development(
 
 @tool(
     name="analyze_corrections",
-    description="Analyze user corrections from interaction logs to identify patterns in agent mistakes",
+    description=(
+        "Analyze user corrections from interaction logs to identify patterns in agent mistakes"
+    ),
     category=ToolCategory.DATA,
 )
-def analyze_corrections(
-    limit: int = 50,
-    context: Dict = None
-) -> str:
+def analyze_corrections(limit: int = 50, context: dict = None) -> str:
     """Analyze correction patterns"""
     agent, err = require_agent(context)
     if err:
@@ -252,8 +255,9 @@ def analyze_corrections(
         return f"No corrections detected in {len(interactions)} interactions."
 
     lines = [
-        f"Correction Analysis ({len(corrections)} corrections in {len(interactions)} interactions):",
-        ""
+        f"Correction Analysis ({len(corrections)} corrections in"
+        f" {len(interactions)} interactions):",
+        "",
     ]
 
     indicator_counts = {}
@@ -272,8 +276,8 @@ def analyze_corrections(
 
     lines.append("")
     lines.append("Tools frequently followed by corrections:")
-    for tool, count in sorted(tool_corrections.items(), key=lambda x: -x[1])[:5]:
-        lines.append(f"  {tool}: {count} times")
+    for tool_name, count in sorted(tool_corrections.items(), key=lambda x: -x[1])[:5]:
+        lines.append(f"  {tool_name}: {count} times")
 
     lines.append("")
     lines.append("Recent correction examples:")
@@ -290,10 +294,7 @@ def analyze_corrections(
     description="Export interaction logs for external analysis",
     category=ToolCategory.DATA,
 )
-def export_interaction_log(
-    format: str = "summary",
-    context: Dict = None
-) -> str:
+def export_interaction_log(format: str = "summary", context: dict = None) -> str:
     """Export interaction log"""
     agent, err = require_agent(context)
     if err:
@@ -341,20 +342,24 @@ def export_interaction_log(
 
 @tool(
     name="import_embryos_from_session",
-    description="""Import embryos (positions, calibration, settings) from another session into the current experiment.
-Use when user wants to start a fresh session but keep embryo positions from a previous session (e.g., "import embryos from last session", "load embryos from session X").
-This imports positions and calibration data but NOT conversation history or detection results - it's a fresh start with known embryos.
+    description="""Import embryos (positions, calibration, settings) from another session into
+the current experiment.
+Use when user wants to start a fresh session but keep embryo positions from a previous
+session (e.g., "import embryos from last session", "load embryos from session X").
+This imports positions and calibration data but NOT conversation history or detection
+results - it's a fresh start with known embryos.
 Use list_sessions or /sessions first to find the session_id to import from.""",
     category=ToolCategory.DATA,
     examples=[
         ToolExample("Import embryos from session abc123", {"session_id": "abc123"}),
-        ToolExample("Load embryos from previous session, replacing current ones", {"session_id": "abc123", "clear_existing": True}),
+        ToolExample(
+            "Load embryos from previous session, replacing current ones",
+            {"session_id": "abc123", "clear_existing": True},
+        ),
     ],
 )
 def import_embryos_from_session(
-    session_id: str,
-    clear_existing: bool = False,
-    context: Dict = None
+    session_id: str, clear_existing: bool = False, context: dict = None
 ) -> str:
     """
     Import embryos from another session.
@@ -372,12 +377,9 @@ def import_embryos_from_session(
     if err:
         return err
 
-    result = agent.import_embryos_from_session(
-        session_id=session_id,
-        clear_existing=clear_existing
-    )
+    result = agent.import_embryos_from_session(session_id=session_id, clear_existing=clear_existing)
 
-    if not result.get('success'):
+    if not result.get("success"):
         return f"Import failed: {result.get('error', 'Unknown error')}"
 
     lines = [
@@ -385,16 +387,16 @@ def import_embryos_from_session(
         f"  Imported: {len(result['imported'])} embryo(s)",
     ]
 
-    if result['imported']:
+    if result["imported"]:
         lines.append(f"    {', '.join(result['imported'])}")
 
-    if result['skipped']:
+    if result["skipped"]:
         lines.append(f"  Skipped (already exist): {len(result['skipped'])}")
         lines.append(f"    {', '.join(result['skipped'])}")
 
-    if result.get('errors'):
+    if result.get("errors"):
         lines.append(f"  Errors: {len(result['errors'])}")
-        for err in result['errors']:
+        for err in result["errors"]:
             lines.append(f"    - {err}")
 
     return "\n".join(lines)
@@ -402,19 +404,18 @@ def import_embryos_from_session(
 
 @tool(
     name="list_sessions",
-    description="""List available sessions with their IDs, embryo counts, message counts, and last active times.
-Use when user asks "show sessions", "what sessions exist", or needs to pick a session to resume or import from.
-Returns ALL sessions — do NOT filter by embryo count. Sessions are valuable for conversation history too.""",
+    description="""List available sessions with their IDs, embryo counts, message counts,
+and last active times.
+Use when user asks "show sessions", "what sessions exist", or needs to pick a session to
+resume or import from. Returns ALL sessions — do NOT filter by embryo count. Sessions are
+valuable for conversation history too.""",
     category=ToolCategory.DATA,
     examples=[
         ToolExample("Show available sessions", {}),
         ToolExample("List recent sessions", {"limit": 5}),
     ],
 )
-def list_sessions(
-    limit: int = 20,
-    context: Dict = None
-) -> str:
+def list_sessions(limit: int = 20, context: dict = None) -> str:
     """
     List available sessions.
 
@@ -442,15 +443,16 @@ def list_sessions(
     lines.append("-" * 80)
 
     for s in sessions:
-        session_id = s.get('session_id', 'unknown')[:38]
-        embryo_count = s.get('embryo_count', 0)
-        msg_count = s.get('message_count', 0)
-        last_active = s.get('last_active', '')
+        session_id = s.get("session_id", "unknown")[:38]
+        embryo_count = s.get("embryo_count", 0)
+        msg_count = s.get("message_count", 0)
+        last_active = s.get("last_active", "")
         if last_active:
             # Format datetime string
             try:
                 from datetime import datetime
-                dt = datetime.fromisoformat(last_active.replace('Z', '+00:00'))
+
+                dt = datetime.fromisoformat(last_active.replace("Z", "+00:00"))
                 last_active = dt.strftime("%Y-%m-%d %H:%M")
             except Exception:
                 last_active = last_active[:16]
@@ -462,6 +464,9 @@ def list_sessions(
 
     lines.append("")
     lines.append("To resume a session (full history + state): /resume <session_id>")
-    lines.append("To import only embryo positions into current session: import_embryos_from_session(session_id)")
+    lines.append(
+        "To import only embryo positions into current session:"
+        " import_embryos_from_session(session_id)"
+    )
 
     return "\n".join(lines)
diff --git a/gently/app/tools/stage_tools.py b/gently/app/tools/stage_tools.py
index 3bf9ec49..88a43871 100644
--- a/gently/app/tools/stage_tools.py
+++ b/gently/app/tools/stage_tools.py
@@ -4,17 +4,17 @@
 Tools for controlling microscope XY stage movement.
 """
 
-from typing import Dict
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import get_embryo_or_error
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
     name="move_to_embryo",
-    description="""Move the XY stage to a specific embryo's stored position. The embryo must have been detected and have a valid stage_position.
+    description="""Move the XY stage to a specific embryo's stored position. The embryo must
+have been detected and have a valid stage_position.
 Use when user says "go to embryo X", "move to embryo X", or before imaging a specific embryo.
-This only moves XY - piezo/galvo are controlled separately during acquisition. Movement takes ~0.5 seconds.""",
+This only moves XY - piezo/galvo are controlled separately during acquisition. Movement
+takes ~0.5 seconds.""",
     category=ToolCategory.MOVEMENT,
     requires_microscope=True,
     examples=[
@@ -22,10 +22,10 @@
         ToolExample("Move to embryo 3", {"embryo_id": "embryo_3"}),
     ],
 )
-async def move_to_embryo(embryo_id: str, context: Dict) -> str:
+async def move_to_embryo(embryo_id: str, context: dict) -> str:
     """Move stage to embryo position"""
-    agent = context.get('agent')
-    client = context.get('client')
+    agent = context.get("agent")
+    client = context.get("client")
 
     if not agent:
         return "Error: No agent context"
@@ -38,22 +38,25 @@ async def move_to_embryo(embryo_id: str, context: Dict) -> str:
         return f"Embryo '{embryo_id}' has no stored position. Run calibration first."
 
     try:
-        x = embryo.stage_position.get('x', 0)
-        y = embryo.stage_position.get('y', 0)
+        x = embryo.stage_position.get("x", 0)
+        y = embryo.stage_position.get("y", 0)
         await client.move_to_position(x, y)
 
         return f"Moved to {embryo_id}\nPosition: ({x:.2f}, {y:.2f}) um"
 
     except Exception as e:
         import traceback
+
         return f"Error moving to embryo: {str(e)}\n{traceback.format_exc()}"
 
 
 @tool(
     name="get_stage_position",
-    description="""Get the current XY stage position in micrometers. Returns the real-time position from the hardware.
-Use when user asks "where is the stage?", "current position?", or when you need to know the microscope's current location.
-This reads from hardware - different from embryo stored positions which are in the experiment data.""",
+    description="""Get the current XY stage position in micrometers. Returns the real-time
+position from the hardware.
+Use when user asks "where is the stage?", "current position?", or when you need to know
+the microscope's current location. This reads from hardware - different from embryo stored
+positions which are in the experiment data.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
     examples=[
@@ -61,9 +64,9 @@ async def move_to_embryo(embryo_id: str, context: Dict) -> str:
         ToolExample("Current XY position?", {}),
     ],
 )
-async def get_stage_position(context: Dict) -> str:
+async def get_stage_position(context: dict) -> str:
     """Get current stage position"""
-    client = context.get('client')
+    client = context.get("client")
 
     if not client:
         return "Error: No microscope client connected"
@@ -79,7 +82,8 @@ async def get_stage_position(context: Dict) -> str:
 @tool(
     name="move_stage",
     description="""Move the XY stage to specific coordinates in micrometers.
-Use when user wants to move to arbitrary coordinates (e.g., "move to x=1000, y=500", "move stage to 1200, -600").
+Use when user wants to move to arbitrary coordinates (e.g., "move to x=1000, y=500",
+"move stage to 1200, -600").
 For moving to a specific embryo, use move_to_embryo instead.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
@@ -88,13 +92,9 @@ async def get_stage_position(context: Dict) -> str:
         ToolExample("Move stage to coordinates 1200, -600", {"x": 1200, "y": -600}),
     ],
 )
-async def move_stage(
-    x: float,
-    y: float,
-    context: Dict = None
-) -> str:
+async def move_stage(x: float, y: float, context: dict = None) -> str:
     """Move stage to arbitrary XY coordinates"""
-    client = context.get('client')
+    client = context.get("client")
 
     if not client:
         return "Error: No microscope client connected"
diff --git a/gently/app/tools/temperature_tools.py b/gently/app/tools/temperature_tools.py
index 43ff8ab0..6e12e7e8 100644
--- a/gently/app/tools/temperature_tools.py
+++ b/gently/app/tools/temperature_tools.py
@@ -5,9 +5,8 @@
 development rate, so these let the agent hold or shift the sample temperature as
 part of closed-loop experiments.
 """
-from typing import Dict
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
@@ -26,7 +25,7 @@
         ToolExample("Warm the embryos to 25 C to speed development", {"target_c": 25.0}),
     ],
 )
-async def set_temperature(target_c: float, context: Dict) -> str:
+async def set_temperature(target_c: float, context: dict) -> str:
     """Command the thermal controller to a target temperature.
 
     Parameters
@@ -34,12 +33,14 @@ async def set_temperature(target_c: float, context: Dict) -> str:
     target_c : float
         Target temperature in degrees Celsius (0.0-99.9).
     """
-    client = context.get('client')
+    client = context.get("client")
     try:
         result = await client.set_temperature(target_c)
-        if result.get('success'):
-            return (f"Commanded {target_c} C. Currently {result.get('temperature_c')} C, "
-                    f"state {result.get('state')!r}. Ramping — call get_temperature to confirm lock.")
+        if result.get("success"):
+            return (
+                f"Commanded {target_c} C. Currently {result.get('temperature_c')} C, "
+                f"state {result.get('state')!r}. Ramping — call get_temperature to confirm lock."
+            )
         return f"Error setting temperature: {result.get('error', 'unknown error')}"
     except Exception as e:
         return f"Error setting temperature: {e}"
@@ -59,15 +60,17 @@ async def set_temperature(target_c: float, context: Dict) -> str:
         ToolExample("Has the sample reached temperature yet?"),
     ],
 )
-async def get_temperature(context: Dict) -> str:
+async def get_temperature(context: dict) -> str:
     """Read current temperature, setpoint, and lock state."""
-    client = context.get('client')
+    client = context.get("client")
     try:
         r = await client.get_temperature()
-        if r.get('success'):
-            msg = (f"Temperature {r.get('temperature_c')} C "
-                   f"(setpoint {r.get('setpoint_c')} C, state {r.get('state')!r}")
-            if r.get('peltier_c') is not None:
+        if r.get("success"):
+            msg = (
+                f"Temperature {r.get('temperature_c')} C "
+                f"(setpoint {r.get('setpoint_c')} C, state {r.get('state')!r}"
+            )
+            if r.get("peltier_c") is not None:
                 msg += f", peltier {r.get('peltier_c')} C"
             return msg + ")"
         return f"Error reading temperature: {r.get('error', 'unknown error')}"
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index 316913a8..de7ece90 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -4,13 +4,13 @@
 Tools for managing adaptive timelapse acquisitions.
 """
 
-from typing import Dict, List, Optional
-
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
 from gently.harness.tools.helpers import (
-    require_agent, get_embryo_or_error,
-    require_timelapse_orchestrator, require_developmental_tracker
+    get_embryo_or_error,
+    require_agent,
+    require_developmental_tracker,
+    require_timelapse_orchestrator,
 )
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
@@ -20,13 +20,13 @@
 )
 async def generate_bluesky_plan(
     goal: str,
-    embryo_ids: List[str],
+    embryo_ids: list[str],
     plan_type: str = "adaptive_timelapse",
-    parameters: Dict = None,
-    context: Dict = None
+    parameters: dict = None,
+    context: dict = None,
 ) -> str:
     """Generate Bluesky plan"""
-    agent = context.get('agent')
+    agent = context.get("agent")
 
     if not agent:
         return "Error: No agent context"
@@ -36,7 +36,7 @@ async def generate_bluesky_plan(
             goal=goal,
             embryo_ids=embryo_ids,
             plan_type=plan_type,
-            parameters=parameters or {}
+            parameters=parameters or {},
         )
         return result
 
@@ -47,20 +47,23 @@ async def generate_bluesky_plan(
 @tool(
     name="start_adaptive_timelapse",
     description=(
-        "Start an adaptive timelapse that runs in the background. Agent remains responsive while acquisition continues. "
-        "Pass `monitoring_mode='expression_monitoring'` for fluorescent-reporter experiments to install reactive cadence + power rules at startup. "
-        "Other monitoring_mode values: 'pre_terminal_monitoring' (hatching-timing experiments), 'idle' (plain imaging, no reactive rules)."
+        "Start an adaptive timelapse that runs in the background. Agent remains responsive"
+        " while acquisition continues. "
+        "Pass `monitoring_mode='expression_monitoring'` for fluorescent-reporter experiments"
+        " to install reactive cadence + power rules at startup. "
+        "Other monitoring_mode values: 'pre_terminal_monitoring' (hatching-timing"
+        " experiments), 'idle' (plain imaging, no reactive rules)."
     ),
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
 async def start_adaptive_timelapse(
-    embryo_ids: List[str] = None,
+    embryo_ids: list[str] = None,
     stop_condition: str = "manual",
     interval_seconds: float = 120.0,
     condition_value: int = None,
-    monitoring_mode: Optional[str] = None,
-    context: Dict = None
+    monitoring_mode: str | None = None,
+    context: dict = None,
 ) -> str:
     """Start adaptive timelapse in background"""
     agent, err = require_agent(context)
@@ -84,10 +87,14 @@ async def start_adaptive_timelapse(
             cs = getattr(agent, "context_store", None)
             if cs:
                 from .plan_execution_tools import try_auto_link_plan_item
+
                 session_id = getattr(agent, "session_id", None)
                 if session_id:
                     linked = try_auto_link_plan_item(
-                        cs, session_id, stop_condition, interval_seconds,
+                        cs,
+                        session_id,
+                        stop_condition,
+                        interval_seconds,
                     )
                     if linked:
                         result += f"\n(Auto-linked to plan item: '{linked}')"
@@ -114,7 +121,7 @@ async def start_adaptive_timelapse(
     description="Get current status of the running timelapse including per-embryo progress",
     category=ToolCategory.EXPERIMENT,
 )
-def get_timelapse_status(context: Dict = None) -> str:
+def get_timelapse_status(context: dict = None) -> str:
     """Get timelapse status"""
     agent, err = require_agent(context)
     if err:
@@ -127,12 +134,9 @@ def get_timelapse_status(context: Dict = None) -> str:
     state = orchestrator.get_status()
     status_dict = state.to_dict()
 
-    lines = [
-        f"Timelapse Status: {status_dict['status'].upper()}",
-        ""
-    ]
+    lines = [f"Timelapse Status: {status_dict['status'].upper()}", ""]
 
-    if status_dict['started_at']:
+    if status_dict["started_at"]:
         lines.append(f"Started: {status_dict['started_at']}")
         lines.append(f"Duration: {status_dict['duration_minutes']:.1f} minutes")
         lines.append(f"Total timepoints acquired: {status_dict['total_timepoints']}")
@@ -142,19 +146,19 @@ def get_timelapse_status(context: Dict = None) -> str:
     lines.append(f"Completed embryos: {status_dict['completed_embryos']}")
     lines.append("")
 
-    if status_dict.get('seconds_until_next_round') is not None:
+    if status_dict.get("seconds_until_next_round") is not None:
         lines.append(f"Next acquisition in {status_dict['seconds_until_next_round']:.0f}s")
         lines.append("")
 
-    if status_dict['embryo_details']:
+    if status_dict["embryo_details"]:
         lines.append("Embryo Details:")
-        for eid, details in status_dict['embryo_details'].items():
-            status_marker = "[done]" if details['is_complete'] else "[active]"
+        for eid, details in status_dict["embryo_details"].items():
+            status_marker = "[done]" if details["is_complete"] else "[active]"
             lines.append(f"  {status_marker} {eid}: t={details['timepoints']}")
-            if details['is_complete']:
+            if details["is_complete"]:
                 lines.append(f"      Completed: {details['completion_reason']}")
 
-    if status_dict['error']:
+    if status_dict["error"]:
         lines.append("")
         lines.append(f"Error: {status_dict['error']}")
 
@@ -163,7 +167,10 @@ def get_timelapse_status(context: Dict = None) -> str:
 
 @tool(
     name="modify_timelapse_embryo",
-    description="Modify parameters for a specific embryo during a running timelapse. Note: interval is now global - use modify_timelapse_interval to change it.",
+    description=(
+        "Modify parameters for a specific embryo during a running timelapse."
+        " Note: interval is now global - use modify_timelapse_interval to change it."
+    ),
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
@@ -171,7 +178,7 @@ async def modify_timelapse_embryo(
     embryo_id: str,
     stop_condition: str = None,
     condition_value: int = None,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Modify embryo parameters during timelapse (stop condition only - interval is global)"""
     agent, err = require_agent(context)
@@ -195,7 +202,10 @@ async def modify_timelapse_embryo(
 
 @tool(
     name="add_embryo_to_timelapse",
-    description="Add an embryo to an already running timelapse. The embryo will use the global interval and join on the next round.",
+    description=(
+        "Add an embryo to an already running timelapse. The embryo will use the global"
+        " interval and join on the next round."
+    ),
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
@@ -203,7 +213,7 @@ async def add_embryo_to_timelapse(
     embryo_id: str,
     stop_condition: str = None,
     condition_value: int = None,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Add an embryo to a running timelapse (uses global interval)"""
     agent, err = require_agent(context)
@@ -232,9 +242,7 @@ async def add_embryo_to_timelapse(
     requires_microscope=True,
 )
 async def stop_timelapse_embryo(
-    embryo_id: str,
-    reason: str = "user_request",
-    context: Dict = None
+    embryo_id: str, reason: str = "user_request", context: dict = None
 ) -> str:
     """Stop imaging a specific embryo"""
     agent, err = require_agent(context)
@@ -258,10 +266,7 @@ async def stop_timelapse_embryo(
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def stop_timelapse(
-    reason: str = "user_request",
-    context: Dict = None
-) -> str:
+async def stop_timelapse(reason: str = "user_request", context: dict = None) -> str:
     """Stop entire timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -284,7 +289,7 @@ async def stop_timelapse(
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def pause_timelapse(context: Dict = None) -> str:
+async def pause_timelapse(context: dict = None) -> str:
     """Pause timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -307,7 +312,7 @@ async def pause_timelapse(context: Dict = None) -> str:
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def resume_timelapse(context: Dict = None) -> str:
+async def resume_timelapse(context: dict = None) -> str:
     """Resume timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -326,14 +331,13 @@ async def resume_timelapse(context: Dict = None) -> str:
 
 @tool(
     name="add_stop_condition",
-    description="Add an additional stop condition to a running timelapse (OR logic). E.g., add 'hatching' condition to a timelapse running with a duration limit.",
+    description=(
+        "Add an additional stop condition to a running timelapse (OR logic). E.g., add"
+        " 'hatching' condition to a timelapse running with a duration limit."
+    ),
     category=ToolCategory.EXPERIMENT,
 )
-def add_stop_condition(
-    embryo_id: str,
-    condition: str,
-    context: Dict = None
-) -> str:
+def add_stop_condition(embryo_id: str, condition: str, context: dict = None) -> str:
     """
     Add an additional stop condition to an embryo in a running timelapse.
 
@@ -390,22 +394,22 @@ def add_stop_condition(
     # Get updated description
     new_desc = embryo_state.stop_condition.describe()
 
-    return (
-        f"Added stop condition '{condition}' to {embryo_id}\n"
-        f"Stop conditions: {new_desc}"
-    )
+    return f"Added stop condition '{condition}' to {embryo_id}\nStop conditions: {new_desc}"
 
 
 @tool(
     name="add_interval_speedup_rule",
-    description="Add a rule to automatically speed up imaging when a developmental stage is reached (e.g., 'speed up to 30s when 3fold stage detected')",
+    description=(
+        "Add a rule to automatically speed up imaging when a developmental stage is"
+        " reached (e.g., 'speed up to 30s when 3fold stage detected')"
+    ),
     category=ToolCategory.EXPERIMENT,
 )
 def add_interval_speedup_rule(
     trigger_stage: str,
     new_interval_seconds: float = 30.0,
-    embryo_ids: List[str] = None,
-    context: Dict = None
+    embryo_ids: list[str] = None,
+    context: dict = None,
 ) -> str:
     """Add interval speedup rule based on developmental stage"""
     agent, err = require_agent(context)
@@ -422,7 +426,10 @@ def add_interval_speedup_rule(
         embryo_ids=embryo_ids,
     )
 
-    msg = f"Added interval rule: speed up to {new_interval_seconds}s when '{trigger_stage}' stage is reached"
+    msg = (
+        f"Added interval rule: speed up to {new_interval_seconds}s when"
+        f" '{trigger_stage}' stage is reached"
+    )
     if embryo_ids:
         msg += f" (for embryos: {', '.join(embryo_ids)})"
 
@@ -431,13 +438,13 @@ def add_interval_speedup_rule(
 
 @tool(
     name="enable_pre_hatching_speedup",
-    description="Enable automatic speedup when embryos approach hatching (triggers when 3-fold stage is detected by the perception system)",
+    description=(
+        "Enable automatic speedup when embryos approach hatching (triggers when 3-fold"
+        " stage is detected by the perception system)"
+    ),
     category=ToolCategory.EXPERIMENT,
 )
-def enable_pre_hatching_speedup(
-    fast_interval_seconds: float = 30.0,
-    context: Dict = None
-) -> str:
+def enable_pre_hatching_speedup(fast_interval_seconds: float = 30.0, context: dict = None) -> str:
     """Enable pre-hatching speedup based on developmental stage"""
     agent, err = require_agent(context)
     if err:
@@ -451,13 +458,15 @@ def enable_pre_hatching_speedup(
     orchestrator.add_pre_terminal_speedup(fast_interval_seconds)
 
     from gently.organisms import get_organism
+
     organism = get_organism()
     trigger_stage = organism.PRE_TERMINAL_SPEEDUP_STAGE
 
     return (
         f"Enabled pre-hatching speedup:\n"
         f"  - Perception system will detect developmental stages\n"
-        f"  - When {trigger_stage} stage detected, interval will change to {fast_interval_seconds}s\n"
+        f"  - When {trigger_stage} stage detected, interval will change to"
+        f" {fast_interval_seconds}s\n"
         f"  - This helps capture hatching at high temporal resolution"
     )
 
@@ -467,10 +476,7 @@ def enable_pre_hatching_speedup(
     description="Use Claude Vision to classify the current developmental stage of an embryo",
     category=ToolCategory.ANALYSIS,
 )
-async def classify_embryo_stage(
-    embryo_id: str,
-    context: Dict = None
-) -> str:
+async def classify_embryo_stage(embryo_id: str, context: dict = None) -> str:
     """Classify embryo stage"""
     agent, err = require_agent(context)
     if err:
@@ -486,8 +492,9 @@ async def classify_embryo_stage(
     latest = embryo.recent_images[-1]
 
     # Initialize tracker if needed
-    if not hasattr(agent, 'developmental_tracker') or agent.developmental_tracker is None:
+    if not hasattr(agent, "developmental_tracker") or agent.developmental_tracker is None:
         from ..developmental_tracker import DevelopmentalTracker
+
         agent.developmental_tracker = DevelopmentalTracker(
             claude_client=agent.claude,
             model=agent.model,
@@ -495,10 +502,12 @@ async def classify_embryo_stage(
 
     recent = []
     for img in embryo.recent_images[-5:]:
-        recent.append({
-            'timepoint': img.timepoint,
-            'b64_image': img.max_projection_b64,
-        })
+        recent.append(
+            {
+                "timepoint": img.timepoint,
+                "b64_image": img.max_projection_b64,
+            }
+        )
 
     result = agent.developmental_tracker.classify_stage(
         image_b64=latest.max_projection_b64,
@@ -516,7 +525,10 @@ async def classify_embryo_stage(
 
     if result.predicted_minutes_to_hatching is not None:
         hours = result.predicted_minutes_to_hatching / 60
-        lines.append(f"  Predicted time to hatching: ~{hours:.1f} hours ({result.predicted_minutes_to_hatching} min)")
+        lines.append(
+            f"  Predicted time to hatching: ~{hours:.1f} hours"
+            f" ({result.predicted_minutes_to_hatching} min)"
+        )
 
     return "\n".join(lines)
 
@@ -526,10 +538,7 @@ async def classify_embryo_stage(
     description="Get the developmental stage progression history for an embryo",
     category=ToolCategory.ANALYSIS,
 )
-def get_stage_history(
-    embryo_id: str,
-    context: Dict = None
-) -> str:
+def get_stage_history(embryo_id: str, context: dict = None) -> str:
     """Get stage history"""
     agent, err = require_agent(context)
     if err:
@@ -567,7 +576,7 @@ def get_stage_history(
 
     summary = tracker.get_progression_summary(embryo_id)
 
-    if summary['observations'] == 0:
+    if summary["observations"] == 0:
         return f"No stage classifications for {embryo_id}. Use classify_embryo_stage first."
 
     lines = [
@@ -577,14 +586,14 @@ def get_stage_history(
         f"  Stages observed: {', '.join(summary['stages_observed'])}",
     ]
 
-    if summary['predicted_minutes_to_hatching'] is not None:
-        hours = summary['predicted_minutes_to_hatching'] / 60
+    if summary["predicted_minutes_to_hatching"] is not None:
+        hours = summary["predicted_minutes_to_hatching"] / 60
         lines.append(f"  Predicted time to hatching: ~{hours:.1f} hours")
 
     return "\n".join(lines)
 
 
-def _perceiver_hatching_estimate(session) -> Optional[float]:
+def _perceiver_hatching_estimate(session) -> float | None:
     """Estimate minutes until the 'hatching' stage from the perception session.
 
     Uses gently_perception's own organism stage ordering + typical durations, so
@@ -615,21 +624,20 @@ def _perceiver_hatching_estimate(session) -> Optional[float]:
         elapsed = getattr(t, "time_in_stage_min", 0.0) or 0.0
     remaining = max(0.0, durations.get(stage, 0.0) - elapsed)
     # Plus the full expected duration of each stage between current and hatching.
-    for s in stages[idx + 1:target]:
+    for s in stages[idx + 1 : target]:
         remaining += durations.get(s, 0.0)
     return remaining
 
 
 @tool(
     name="predict_hatching",
-    description="Predict time-to-hatching for an embryo with confidence intervals based on developmental stage",
+    description=(
+        "Predict time-to-hatching for an embryo with confidence intervals based on"
+        " developmental stage"
+    ),
     category=ToolCategory.ANALYSIS,
 )
-def predict_hatching(
-    embryo_id: str = None,
-    all_embryos: bool = False,
-    context: Dict = None
-) -> str:
+def predict_hatching(embryo_id: str = None, all_embryos: bool = False, context: dict = None) -> str:
     """Predict hatching time with confidence intervals"""
     agent, err = require_agent(context)
     if err:
@@ -658,7 +666,7 @@ def _perc_line(eid: str):
             if any(perc):
                 out = ["Hatching predictions (live perception):", ""]
                 out += [p for p in perc if p]
-                missing = [e for e, p in zip(ids, perc) if not p]
+                missing = [e for e, p in zip(ids, perc, strict=False) if not p]
                 if missing:
                     out.append("")
                     out.append(f"(no perception yet for: {', '.join(missing)})")
@@ -684,7 +692,9 @@ def _perc_line(eid: str):
         for eid, pred in predictions.items():
             lines.append(f"  {eid}:")
             lines.append(f"    Current stage: {pred.current_stage.value}")
-            lines.append(f"    Predicted: {pred.predicted_hours:.1f}h ({pred.predicted_minutes} min)")
+            lines.append(
+                f"    Predicted: {pred.predicted_hours:.1f}h ({pred.predicted_minutes} min)"
+            )
             lines.append(f"    Range: {pred.range_hours[0]:.1f} - {pred.range_hours[1]:.1f}h")
             lines.append(f"    Confidence: {pred.confidence}")
             lines.append("")
@@ -710,7 +720,8 @@ def _perc_line(eid: str):
         lines = [
             f"Hatching Prediction for {embryo_id}:",
             f"  Current stage: {pred.current_stage.value}",
-            f"  Predicted time to hatching: {pred.predicted_hours:.1f} hours ({pred.predicted_minutes} min)",
+            f"  Predicted time to hatching: {pred.predicted_hours:.1f} hours"
+            f" ({pred.predicted_minutes} min)",
             f"  Confidence interval: {pred.range_hours[0]:.1f} - {pred.range_hours[1]:.1f} hours",
             f"  Classification confidence: {pred.confidence}",
         ]
@@ -743,7 +754,7 @@ def _perc_line(eid: str):
         ToolExample("Turn off autonomy", {"mode": "off"}),
     ],
 )
-def set_autonomy(mode: str = None, enabled: bool = None, context: Dict = None) -> str:
+def set_autonomy(mode: str = None, enabled: bool = None, context: dict = None) -> str:
     """Set the wake-router mode (off/ask/auto). `enabled` kept for back-compat."""
     agent, err = require_agent(context)
     if err:
@@ -762,13 +773,17 @@ def set_autonomy(mode: str = None, enabled: bool = None, context: Dict = None) -
         return "Specify mode ('off', 'ask', or 'auto')."
     cur = router.mode
     if cur == "auto":
-        return ("Autonomy set to AUTO. I'll wake on stage transitions, arrest, "
-                "hatching, termination, and errors and adapt acquisition on my own "
-                "(irreversible actions still need your okay). Say 'ask mode' or "
-                "'turn off autonomy' to change.")
+        return (
+            "Autonomy set to AUTO. I'll wake on stage transitions, arrest, "
+            "hatching, termination, and errors and adapt acquisition on my own "
+            "(irreversible actions still need your okay). Say 'ask mode' or "
+            "'turn off autonomy' to change."
+        )
     if cur == "ask":
-        return ("Autonomy set to ASK. On a notable event I'll propose a change and "
-                "wait for your Approve / Modify / Skip before doing anything.")
+        return (
+            "Autonomy set to ASK. On a notable event I'll propose a change and "
+            "wait for your Approve / Modify / Skip before doing anything."
+        )
     return "Autonomy OFF. I'll only act when you message me."
 
 
@@ -779,7 +794,8 @@ def set_autonomy(mode: str = None, enabled: bool = None, context: Dict = None) -
 
 @tool(
     name="modify_timelapse_interval",
-    description="""Change the base acquisition interval for ALL embryos on a running timelapse, effective immediately.
+    description="""Change the base acquisition interval for ALL embryos on a running
+timelapse, effective immediately.
 Re-anchors every embryo's next acquisition to now + the new interval and notifies the UI.
 Lower interval = more frequent imaging = more photodose; raise it to be gentler.
 Use when the user says "image every N minutes/seconds now", "speed up/slow down the whole run".
@@ -790,7 +806,7 @@ def set_autonomy(mode: str = None, enabled: bool = None, context: Dict = None) -
         ToolExample("Slow everything down to 10 minutes", {"new_interval_seconds": 600}),
     ],
 )
-def modify_timelapse_interval(new_interval_seconds: float, context: Dict = None) -> str:
+def modify_timelapse_interval(new_interval_seconds: float, context: dict = None) -> str:
     """Globally re-anchor the timelapse interval (live)."""
     agent, err = require_agent(context)
     if err:
@@ -803,14 +819,18 @@ def modify_timelapse_interval(new_interval_seconds: float, context: Dict = None)
 
 @tool(
     name="set_embryo_cadence",
-    description="""Change ONE embryo's acquisition cadence on a running timelapse, effective immediately.
-Set new_interval_seconds to re-anchor that embryo's next acquisition to now + interval (lower = more frequent = more dose).
+    description="""Change ONE embryo's acquisition cadence on a running timelapse, effective
+immediately. Set new_interval_seconds to re-anchor that embryo's next acquisition to now +
+interval (lower = more frequent = more dose).
 Set new_phase to 'normal' to resume a paused embryo, or 'paused' to pause it.
 NOTE: re-issuing the SAME interval with the SAME phase is a no-op (it won't re-anchor).
 Use for per-embryo tuning, e.g. speed up the one that's developing fastest.""",
     category=ToolCategory.EXPERIMENT,
     examples=[
-        ToolExample("Image embryo_2 every minute", {"embryo_id": "embryo_2", "new_interval_seconds": 60}),
+        ToolExample(
+            "Image embryo_2 every minute",
+            {"embryo_id": "embryo_2", "new_interval_seconds": 60},
+        ),
         ToolExample("Resume embryo_3", {"embryo_id": "embryo_3", "new_phase": "normal"}),
     ],
 )
@@ -818,7 +838,7 @@ def set_embryo_cadence(
     embryo_id: str,
     new_interval_seconds: float = None,
     new_phase: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Per-embryo cadence change routed through the re-anchoring path."""
     agent, err = require_agent(context)
@@ -863,10 +883,12 @@ def set_embryo_cadence(
 
 @tool(
     name="set_photodose_budget",
-    description="""Set or clear the per-embryo photodose budget (a hard cap on cumulative laser exposure).
-base_dose_budget_ms is the ceiling for a 1x-role (test) embryo; calibration embryos get 10x.
+    description="""Set or clear the per-embryo photodose budget (a hard cap on cumulative
+laser exposure). base_dose_budget_ms is the ceiling for a 1x-role (test) embryo;
+calibration embryos get 10x.
 When an embryo's cumulative exposure exceeds its budget it is auto-PAUSED to protect the sample.
-Pass null/None to DISABLE the cap. Raising the budget also resumes embryos that were paused for the old cap.
+Pass null/None to DISABLE the cap. Raising the budget also resumes embryos that were paused
+for the old cap.
 Use to enforce gentleness on precious samples, or to lift the cap when the user okays more dose.""",
     category=ToolCategory.EXPERIMENT,
     examples=[
@@ -877,7 +899,7 @@ def set_embryo_cadence(
 def set_photodose_budget(
     base_dose_budget_ms: float = None,
     resume_paused: bool = True,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Set/clear the photodose budget; optionally resume budget-paused embryos."""
     agent, err = require_agent(context)
@@ -904,11 +926,17 @@ def set_photodose_budget(
             # Only resume if the embryo is now UNDER the new budget (or the cap
             # was disabled); otherwise it would just immediately re-pause.
             if base_dose_budget_ms is not None:
-                rdef = ROLE_REGISTRY.get(getattr(e, "role", "test")) if hasattr(ROLE_REGISTRY, "get") else None
+                rdef = (
+                    ROLE_REGISTRY.get(getattr(e, "role", "test"))
+                    if hasattr(ROLE_REGISTRY, "get")
+                    else None
+                )
                 mult = getattr(rdef, "photodose_budget_multiplier", 1.0) if rdef else 1.0
                 if (getattr(e, "total_exposure_ms", 0.0) or 0.0) > base_dose_budget_ms * mult:
                     continue
-            orchestrator.transition_cadence(e, new_phase="normal", reason="agent:budget change resume")
+            orchestrator.transition_cadence(
+                e, new_phase="normal", reason="agent:budget change resume"
+            )
             resumed.append(eid)
     if resumed:
         msg += f" Resumed: {', '.join(sorted(resumed))}."
@@ -917,12 +945,13 @@ def set_photodose_budget(
 
 @tool(
     name="get_photodose_status",
-    description="""Report each embryo's cumulative light exposure vs its photodose budget, and which are paused over budget.
+    description="""Report each embryo's cumulative light exposure vs its photodose budget,
+and which are paused over budget.
 Use to reason about gentleness before/after changing the budget, power, or cadence.""",
     category=ToolCategory.ANALYSIS,
     examples=[ToolExample("How much light has each embryo gotten?", {})],
 )
-def get_photodose_status(context: Dict = None) -> str:
+def get_photodose_status(context: dict = None) -> str:
     """Read-only photodose / budget status across embryos."""
     agent, err = require_agent(context)
     if err:
@@ -988,7 +1017,7 @@ def get_photodose_status(context: Dict = None) -> str:
 )
 def enable_monitoring_mode(
     mode_name: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Install a named reactive monitoring mode on the orchestrator."""
     agent, err = require_agent(context)
@@ -1020,8 +1049,8 @@ def enable_monitoring_mode(
 )
 def add_test_onset_speedup(
     fast_interval: float = 60.0,
-    embryo_ids: Optional[List[str]] = None,
-    context: Dict = None,
+    embryo_ids: list[str] | None = None,
+    context: dict = None,
 ) -> str:
     """Install the canonical signal-onset cadence speedup rule."""
     agent, err = require_agent(context)
@@ -1037,9 +1066,7 @@ def add_test_onset_speedup(
             fast_interval=fast_interval,
             embryo_ids=embryo_ids,
         )
-        target = (
-            ", ".join(embryo_ids) if embryo_ids else "all test-role embryos"
-        )
+        target = ", ".join(embryo_ids) if embryo_ids else "all test-role embryos"
         return (
             f"Installed test-onset speedup: switch to {fast_interval}s interval "
             f"on signal onset for {target}."
@@ -1066,8 +1093,8 @@ def add_test_saturation_rampdown(
     floor_pct: float = 2.0,
     ceiling_pct: float = 6.0,
     confirm_timepoints: int = 0,
-    embryo_ids: Optional[List[str]] = None,
-    context: Dict = None,
+    embryo_ids: list[str] | None = None,
+    context: dict = None,
 ) -> str:
     """Install the canonical 488 saturation rampdown power rule."""
     agent, err = require_agent(context)
@@ -1086,9 +1113,7 @@ def add_test_saturation_rampdown(
             confirm_timepoints=confirm_timepoints,
             embryo_ids=embryo_ids,
         )
-        target = (
-            ", ".join(embryo_ids) if embryo_ids else "all test-role embryos"
-        )
+        target = ", ".join(embryo_ids) if embryo_ids else "all test-role embryos"
         return (
             f"Installed 488 saturation rampdown: step={step_pct}%, "
             f"floor={floor_pct}%, ceiling={ceiling_pct}%, "
@@ -1121,7 +1146,7 @@ def queue_burst(
     mode: str = "1hz",
     num_slices: int = 1,
     force: bool = False,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Queue an exclusive burst acquisition for one embryo."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/volume_tools.py b/gently/app/tools/volume_tools.py
index b1b69e59..b4893e10 100644
--- a/gently/app/tools/volume_tools.py
+++ b/gently/app/tools/volume_tools.py
@@ -5,21 +5,21 @@
 """
 
 import logging
-from typing import Dict, Optional
-from datetime import datetime
 
-logger = logging.getLogger(__name__)
+from gently.core.coordinates import get_um_per_pixel, stage_to_pixel_position
+from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
-from gently.harness.tools.registry import tool, ToolCategory, ToolExample
-from gently.harness.tools.helpers import require_agent, get_embryo_or_error
-from gently.core.coordinates import stage_to_pixel_position, get_um_per_pixel
+logger = logging.getLogger(__name__)
 
 
 @tool(
     name="view_image",
-    description="""Capture and display the current bottom camera widefield image. Shows what's visible at the current stage position.
-Use when user says "show me the view", "take a picture", "what does it look like?", or to check sample positioning.
-This is the widefield/brightfield camera looking up at the sample - good for seeing embryo outlines and overall positioning.
+    description="""Capture and display the current bottom camera widefield image. Shows what's
+visible at the current stage position.
+Use when user says "show me the view", "take a picture", "what does it look like?", or to
+check sample positioning. This is the widefield/brightfield camera looking up at the sample
+- good for seeing embryo outlines and overall positioning.
 Image is automatically saved to camera_captures/ folder.""",
     category=ToolCategory.HARDWARE,
     requires_microscope=True,
@@ -33,15 +33,15 @@ async def view_image(
     exposure_ms: float = None,
     show: bool = True,
     show_embryos: bool = True,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Capture and display bottom camera image with embryo annotations"""
-    client = context.get('client')
-    agent = context.get('agent')
+    client = context.get("client")
+    agent = context.get("agent")
 
     try:
         snap = await client.capture_bottom_image(exposure_ms=exposure_ms)
-        image = snap['image']
+        image = snap["image"]
 
         if image is None or image.shape == (100, 100):
             return "Failed to capture image from bottom camera"
@@ -50,15 +50,16 @@ async def view_image(
         stage_pos = await client.get_stage_position()
 
         # Archive the bottom camera image with metadata
-        if snap.get('image_path') and agent and agent.store and agent.session_id:
+        if snap.get("image_path") and agent and agent.store and agent.session_id:
             try:
                 from gently.harness.tools.helpers import build_snapshot_metadata
+
                 meta = build_snapshot_metadata(
-                    stage_pos, image.shape,
-                    agent.experiment if agent else None)
+                    stage_pos, image.shape, agent.experiment if agent else None
+                )
                 agent.store.register_snapshot(
-                    agent.session_id, "bottom_camera", snap['image_path'],
-                    metadata=meta)
+                    agent.session_id, "bottom_camera", snap["image_path"], metadata=meta
+                )
             except Exception:
                 pass
 
@@ -72,8 +73,8 @@ async def view_image(
             for embryo_id, embryo in agent.experiment.embryos.items():
                 if embryo.stage_position:
                     # Convert stage position to pixel position using centralized function
-                    emb_x = embryo.stage_position.get('x', 0)
-                    emb_y = embryo.stage_position.get('y', 0)
+                    emb_x = embryo.stage_position.get("x", 0)
+                    emb_y = embryo.stage_position.get("y", 0)
                     pixel_x, pixel_y = stage_to_pixel_position(
                         stage_x=emb_x,
                         stage_y=emb_y,
@@ -81,34 +82,47 @@ async def view_image(
                         current_stage_y=stage_pos[1],
                         image_center_x=image_center_x,
                         image_center_y=image_center_y,
-                        um_per_pixel=um_per_pixel
+                        um_per_pixel=um_per_pixel,
                     )
 
-                    embryo_annotations.append({
-                        'embryo_id': embryo_id,
-                        'pixel_x': pixel_x,
-                        'pixel_y': pixel_y,
-                        'label': embryo.user_label or embryo_id
-                    })
+                    embryo_annotations.append(
+                        {
+                            "embryo_id": embryo_id,
+                            "pixel_x": pixel_x,
+                            "pixel_y": pixel_y,
+                            "label": embryo.user_label or embryo_id,
+                        }
+                    )
 
         if show:
             from datetime import datetime
             from pathlib import Path
+
             timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
             save_path = f"camera_captures/bottom_camera_{timestamp}.jpg"
             Path("camera_captures").mkdir(exist_ok=True)
 
-            view_result = await client.view_image(
+            await client.view_image(
                 image=image,
                 title=title,
                 save_path=save_path,
                 show=True,
-                embryo_annotations=embryo_annotations if embryo_annotations else None
+                embryo_annotations=embryo_annotations if embryo_annotations else None,
+            )
+            num_visible = len(
+                [
+                    a
+                    for a in embryo_annotations
+                    if 0 <= a["pixel_x"] < image.shape[1] and 0 <= a["pixel_y"] < image.shape[0]
+                ]
+            )
+            annotation_msg = (
+                f"\nShowing {num_visible} embryo(s) in view" if embryo_annotations else ""
+            )
+            return (
+                f"Captured bottom camera image ({image.shape[0]}x{image.shape[1]})"
+                f"\nSaved to: {save_path}{annotation_msg}"
             )
-            num_visible = len([a for a in embryo_annotations
-                              if 0 <= a['pixel_x'] < image.shape[1] and 0 <= a['pixel_y'] < image.shape[0]])
-            annotation_msg = f"\nShowing {num_visible} embryo(s) in view" if embryo_annotations else ""
-            return f"Captured bottom camera image ({image.shape[0]}x{image.shape[1]})\nSaved to: {save_path}{annotation_msg}"
         else:
             return f"Captured bottom camera image ({image.shape[0]}x{image.shape[1]})"
 
@@ -135,7 +149,7 @@ async def view_volume(
     embryo_id: str = None,
     timepoint: int = None,
     file_path: str = None,
-    context: Dict = None
+    context: dict = None,
 ) -> str:
     """Open a volume in the browser-based viewer (no blocking desktop window)."""
     from pathlib import Path
@@ -162,9 +176,11 @@ async def view_volume(
         except (ValueError, IndexError):
             pass
         if not embryo_id or timepoint is None:
-            return ("Volume viewing is now in-browser and addressed by embryo + "
-                    "timepoint. Please specify embryo_id (and optionally timepoint) "
-                    "rather than a raw file path.")
+            return (
+                "Volume viewing is now in-browser and addressed by embryo + "
+                "timepoint. Please specify embryo_id (and optionally timepoint) "
+                "rather than a raw file path."
+            )
 
     if not embryo_id:
         return "Error: Specify embryo_id (and optionally timepoint)."
@@ -174,7 +190,7 @@ async def view_volume(
         volume_path = agent.store.get_volume_path(session_id, embryo_id, timepoint)
         if not volume_path or not Path(volume_path).exists():
             volumes = agent.store.list_volumes(session_id, embryo_id)
-            available = sorted(v['timepoint'] for v in volumes)
+            available = sorted(v["timepoint"] for v in volumes)
             if not available:
                 return f"No volumes found for {embryo_id} in session {session_id}"
             return f"Timepoint {timepoint} not found for {embryo_id}. Available: {available}"
@@ -182,13 +198,15 @@ async def view_volume(
         volumes = agent.store.list_volumes(session_id, embryo_id)
         if not volumes:
             return f"No volumes found for {embryo_id} in session {session_id}"
-        timepoint = max(v['timepoint'] for v in volumes)
+        timepoint = max(v["timepoint"] for v in volumes)
 
     # Drive the in-browser viewer \u2014 no blocking Qt/desktop window.
     viz = getattr(agent, "viz_server", None)
     if viz is None:
-        return (f"Resolved {embryo_id} t{timepoint:04d}, but the web UI isn't running, "
-                f"so there's nowhere to display it. Start the web UI and try again.")
+        return (
+            f"Resolved {embryo_id} t{timepoint:04d}, but the web UI isn't running, "
+            f"so there's nowhere to display it. Start the web UI and try again."
+        )
 
     try:
         n_clients = await viz.open_volume_in_browser(embryo_id, timepoint)
@@ -198,16 +216,21 @@ async def view_volume(
 
     url = f"http://localhost:{getattr(viz, 'port', 8080)}/"
     if n_clients <= 0:
-        return (f"Resolved {embryo_id} t{timepoint:04d}, but no browser is connected. "
-                f"Open {url} and select that embryo/timepoint to view it.")
-    return (f"\u2713 Opening {embryo_id} t{timepoint:04d} in the web volume viewer "
-            f"({n_clients} view(s) connected) \u2014 {url}")
+        return (
+            f"Resolved {embryo_id} t{timepoint:04d}, but no browser is connected. "
+            f"Open {url} and select that embryo/timepoint to view it."
+        )
+    return (
+        f"\u2713 Opening {embryo_id} t{timepoint:04d} in the web volume viewer "
+        f"({n_clients} view(s) connected) \u2014 {url}"
+    )
 
 
 @tool(
     name="list_volumes",
     description="""List available volumes for an embryo or all embryos.
-Shows volume files with timepoints and file sizes. Scans the storage directory for all volumes (not just recent ones in memory).
+Shows volume files with timepoints and file sizes. Scans the storage directory for all
+volumes (not just recent ones in memory).
 Use to see what data is available before viewing.""",
     category=ToolCategory.ANALYSIS,
     requires_microscope=False,
@@ -216,10 +239,7 @@ async def view_volume(
         ToolExample("List all volumes", {}),
     ],
 )
-async def list_volumes(
-    embryo_id: str = None,
-    context: Dict = None
-) -> str:
+async def list_volumes(embryo_id: str = None, context: dict = None) -> str:
     """List available volumes"""
     agent, err = require_agent(context)
     if err:
@@ -234,14 +254,14 @@ async def list_volumes(
     # Group by embryo_id
     all_volumes = {}  # embryo_id -> list of volume records
     for vol in all_volumes_list:
-        eid = vol['embryo_id']
+        eid = vol["embryo_id"]
         if eid not in all_volumes:
             all_volumes[eid] = []
         all_volumes[eid].append(vol)
 
     # Sort by timepoint
     for eid in all_volumes:
-        all_volumes[eid].sort(key=lambda x: x['timepoint'])
+        all_volumes[eid].sort(key=lambda x: x["timepoint"])
 
     if embryo_id:
         # List volumes for specific embryo
@@ -254,7 +274,7 @@ async def list_volumes(
         lines.append("")
 
         for vol in volumes:
-            tp = vol['timepoint']
+            tp = vol["timepoint"]
             path = agent.store.get_volume_path(session_id, embryo_id, tp)
             if path and path.exists():
                 size_mb = path.stat().st_size / (1024 * 1024)
@@ -268,25 +288,33 @@ async def list_volumes(
             return f"No volumes found in session {session_id}"
 
         total_files = sum(len(v) for v in all_volumes.values())
-        lines.append(f"Available volumes: {total_files} file(s) across {len(all_volumes)} embryo(s)")
+        lines.append(
+            f"Available volumes: {total_files} file(s) across {len(all_volumes)} embryo(s)"
+        )
         lines.append(f"Session: {session_id}")
 
         for eid in sorted(all_volumes.keys()):
             volumes = all_volumes[eid]
-            timepoints = [v['timepoint'] for v in volumes]
-            tp_range = f"t{min(timepoints):04d}-t{max(timepoints):04d}" if len(timepoints) > 1 else f"t{timepoints[0]:04d}"
+            timepoints = [v["timepoint"] for v in volumes]
+            tp_range = (
+                f"t{min(timepoints):04d}-t{max(timepoints):04d}"
+                if len(timepoints) > 1
+                else f"t{timepoints[0]:04d}"
+            )
 
             # Calculate total size
             total_size = 0
             for vol in volumes:
-                path = agent.store.get_volume_path(session_id, eid, vol['timepoint'])
+                path = agent.store.get_volume_path(session_id, eid, vol["timepoint"])
                 if path and path.exists():
                     total_size += path.stat().st_size / (1024 * 1024)
-            lines.append(f"\n{eid}: {len(volumes)} volume(s) [{tp_range}] ({total_size:.1f} MB total)")
+            lines.append(
+                f"\n{eid}: {len(volumes)} volume(s) [{tp_range}] ({total_size:.1f} MB total)"
+            )
 
             # Show last few timepoints
             for vol in volumes[-3:]:
-                tp = vol['timepoint']
+                tp = vol["timepoint"]
                 path = agent.store.get_volume_path(session_id, eid, tp)
                 if path and path.exists():
                     size_mb = path.stat().st_size / (1024 * 1024)
diff --git a/gently/app/video_maker.py b/gently/app/video_maker.py
index 942301cf..fff408fb 100644
--- a/gently/app/video_maker.py
+++ b/gently/app/video_maker.py
@@ -4,19 +4,16 @@
 Creates MP4 videos from max projections of timelapse volumes.
 """
 
-import numpy as np
-from pathlib import Path
-from typing import List, Optional, Dict, Tuple
-from datetime import datetime
 import logging
+from datetime import datetime
+from pathlib import Path
+
+import numpy as np
 
 logger = logging.getLogger(__name__)
 
 
-def discover_volumes(
-    session_dir: Path,
-    embryo_id: Optional[str] = None
-) -> Dict[str, List[Path]]:
+def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict[str, list[Path]]:
     """
     Discover volume files in a session directory.
 
@@ -39,7 +36,7 @@ def discover_volumes(
     tif_files = list(session_dir.glob("*.tif")) + list(session_dir.glob("*.tiff"))
 
     # Group by embryo ID (filename format: embryo_1_20251210_095317.tif)
-    embryo_volumes: Dict[str, List[Tuple[datetime, Path]]] = {}
+    embryo_volumes: dict[str, list[tuple[datetime, Path]]] = {}
 
     for f in tif_files:
         parts = f.stem.split("_")
@@ -82,16 +79,19 @@ def make_max_projection(volume: np.ndarray) -> np.ndarray:
         return volume
 
 
-def normalize_for_video(image: np.ndarray, percentile_low: float = 1, percentile_high: float = 99.5) -> np.ndarray:
+def normalize_for_video(
+    image: np.ndarray, percentile_low: float = 1, percentile_high: float = 99.5
+) -> np.ndarray:
     """Normalize image to 8-bit for video encoding."""
     from gently.core.imaging import normalize_to_uint8
-    return normalize_to_uint8(image, method="percentile", p_low=percentile_low, p_high=percentile_high)
+
+    return normalize_to_uint8(
+        image, method="percentile", p_low=percentile_low, p_high=percentile_high
+    )
 
 
 def add_timestamp_overlay(
-    image: np.ndarray,
-    timestamp: str,
-    position: str = "top-left"
+    image: np.ndarray, timestamp: str, position: str = "top-left"
 ) -> np.ndarray:
     """Add timestamp text overlay to image."""
     import cv2
@@ -126,7 +126,7 @@ def add_timestamp_overlay(
         (x - 2, y - text_height - 2),
         (x + text_width + 2, y + baseline + 2),
         (0, 0, 0),
-        -1
+        -1,
     )
 
     # Draw text
@@ -136,13 +136,13 @@ def add_timestamp_overlay(
 
 
 def create_timelapse_video(
-    volume_paths: List[Path],
+    volume_paths: list[Path],
     output_path: Path,
     fps: int = 10,
     add_timestamps: bool = True,
     embryo_id: str = None,
-    progress_callback=None
-) -> Dict:
+    progress_callback=None,
+) -> dict:
     """
     Create MP4 video from list of volume files.
 
@@ -223,21 +223,17 @@ def create_timelapse_video(
 
                     # Try different codecs in order of preference
                     codecs = [
-                        ('mp4v', '.mp4'),
-                        ('avc1', '.mp4'),
-                        ('XVID', '.avi'),
-                        ('MJPG', '.avi'),
+                        ("mp4v", ".mp4"),
+                        ("avc1", ".mp4"),
+                        ("XVID", ".avi"),
+                        ("MJPG", ".avi"),
                     ]
 
                     for codec, ext in codecs:
                         fourcc = cv2.VideoWriter_fourcc(*codec)
                         test_path = output_path.with_suffix(ext)
                         writer = cv2.VideoWriter(
-                            str(test_path),
-                            fourcc,
-                            fps,
-                            (width, height),
-                            isColor=True
+                            str(test_path), fourcc, fps, (width, height), isColor=True
                         )
                         if writer.isOpened():
                             output_path = test_path
@@ -274,14 +270,14 @@ def create_timelapse_video(
             "frame_count": frame_count,
             "duration_seconds": duration,
             "fps": fps,
-            "resolution": f"{first_shape[1]}x{first_shape[0]}" if first_shape else "unknown"
+            "resolution": f"{first_shape[1]}x{first_shape[0]}" if first_shape else "unknown",
         }
 
     except Exception as e:
         if writer:
             try:
                 writer.release()
-            except:
+            except Exception:
                 pass
         return {"error": str(e)}
 
@@ -289,11 +285,11 @@ def create_timelapse_video(
 def make_session_videos(
     storage_path: Path,
     session_id: str,
-    output_dir: Optional[Path] = None,
-    embryo_ids: Optional[List[str]] = None,
+    output_dir: Path | None = None,
+    embryo_ids: list[str] | None = None,
     fps: int = 10,
-    progress_callback=None
-) -> Dict[str, Dict]:
+    progress_callback=None,
+) -> dict[str, dict]:
     """
     Create videos for all embryos in a session.
 
@@ -344,9 +340,9 @@ def make_session_videos(
 
         output_path = output_dir / f"{embryo_id}_timelapse.mp4"
 
-        def embryo_progress(current, total):
+        def embryo_progress(current, total, _eid=embryo_id):
             if progress_callback:
-                progress_callback(embryo_id, current, total)
+                progress_callback(_eid, current, total)
 
         result = create_timelapse_video(
             volume_paths=volumes,
@@ -354,7 +350,7 @@ def embryo_progress(current, total):
             fps=fps,
             add_timestamps=True,
             embryo_id=embryo_id,
-            progress_callback=embryo_progress
+            progress_callback=embryo_progress,
         )
 
         results[embryo_id] = result
diff --git a/gently/app/wake_router.py b/gently/app/wake_router.py
index 71faa7ce..87f4b577 100644
--- a/gently/app/wake_router.py
+++ b/gently/app/wake_router.py
@@ -20,6 +20,7 @@
 
 Nothing fires until ``set_enabled(True)`` (e.g. via the set_autonomy tool).
 """
+
 from __future__ import annotations
 
 import asyncio
@@ -30,18 +31,20 @@
 logger = logging.getLogger(__name__)
 
 # Tunables (seconds).
-COALESCE_WINDOW = 20.0     # collapse a burst of events into one wake
+COALESCE_WINDOW = 20.0  # collapse a burst of events into one wake
 MIN_WAKE_INTERVAL = 120.0  # throttle non-critical wakes
-ASK_TIMEOUT_SEC = 300.0    # ASK mode: how long to wait for operator approval -> Skip
+ASK_TIMEOUT_SEC = 300.0  # ASK mode: how long to wait for operator approval -> Skip
 
 # Events that always wake immediately (bypass MIN_WAKE_INTERVAL).
-CRITICAL_EVENTS = frozenset({
-    EventType.HATCHING_DETECTED,
-    EventType.EMBRYO_TERMINATED,
-    EventType.ERROR_OCCURRED,
-    EventType.ACQUISITION_FAILED,
-    EventType.ANOMALY_DETECTED,
-})
+CRITICAL_EVENTS = frozenset(
+    {
+        EventType.HATCHING_DETECTED,
+        EventType.EMBRYO_TERMINATED,
+        EventType.ERROR_OCCURRED,
+        EventType.ACQUISITION_FAILED,
+        EventType.ANOMALY_DETECTED,
+    }
+)
 # Non-critical events we also inspect (filtered for real transitions / arrest).
 WATCH_EVENTS = frozenset({EventType.DETECTOR_EVALUATED})
 
@@ -52,12 +55,12 @@ class WakeRouter:
     def __init__(self, agent, bus):
         self.agent = agent
         self.bus = bus
-        self.mode = "off"          # 'off' | 'ask' | 'auto'
+        self.mode = "off"  # 'off' | 'ask' | 'auto'
         self._loop = None
-        self._pending = []          # list[(EventType, dict)]
-        self._flush_handle = None   # TimerHandle for the coalesce window
-        self._last_wake = 0.0       # loop.time() of the last fired wake
-        self._last_stage = {}       # embryo_id -> last stage seen (transition detection)
+        self._pending = []  # list[(EventType, dict)]
+        self._flush_handle = None  # TimerHandle for the coalesce window
+        self._last_wake = 0.0  # loop.time() of the last fired wake
+        self._last_stage = {}  # embryo_id -> last stage seen (transition detection)
         self._in_flight = False
         self._unsubs = []
         self._subscribe()
@@ -97,7 +100,7 @@ def shutdown(self):
 
     # -- subscription ---------------------------------------------------
     def _subscribe(self):
-        for et in (CRITICAL_EVENTS | WATCH_EVENTS):
+        for et in CRITICAL_EVENTS | WATCH_EVENTS:
             try:
                 self._unsubs.append(
                     self.bus.subscribe(et, lambda e, _et=et: self._on_event(_et, e))
@@ -195,10 +198,14 @@ async def _flush(self):
         self._in_flight = True
         self._last_wake = now
         try:
-            ask = (self.mode == "ask")
+            ask = self.mode == "ask"
             note, trigger = self._build_wake_note(events, ask=ask)
-            logger.info("Wake-router firing %s turn (%d event(s)): %s",
-                        self.mode.upper(), len(events), trigger)
+            logger.info(
+                "Wake-router firing %s turn (%d event(s)): %s",
+                self.mode.upper(),
+                len(events),
+                trigger,
+            )
             await self.agent.run_wake_turn(note, trigger=trigger, interactive=ask)
         except Exception:
             logger.exception("wake turn failed")
@@ -209,8 +216,7 @@ async def _flush(self):
             # out another coalesce window. _in_flight is now False so this flush
             # will proceed instead of deferring (no busy-spin).
             if self._pending and self.enabled:
-                self._schedule_flush(
-                    critical=any(et in CRITICAL_EVENTS for et, _ in self._pending))
+                self._schedule_flush(critical=any(et in CRITICAL_EVENTS for et, _ in self._pending))
 
     # -- wake package ---------------------------------------------------
     def _build_wake_note(self, events, ask=False):
@@ -218,6 +224,7 @@ def _build_wake_note(self, events, ask=False):
         trigger_str is the short human-readable reason shown in the chat banner.
         When ask=True the note instructs propose-then-confirm instead of acting."""
         from gently.harness.prompts.templates import build_perception_snapshot
+
         triggers = []
         for et, data in events:
             name = getattr(et, "name", str(et))
@@ -227,8 +234,11 @@ def _build_wake_note(self, events, ask=False):
                 triggers.append(f"{eid}: hatching detected")
             elif et == EventType.EMBRYO_TERMINATED:
                 triggers.append(f"{eid}: terminated ({data.get('completion_reason', '?')})")
-            elif et in (EventType.ERROR_OCCURRED, EventType.ACQUISITION_FAILED,
-                        EventType.ANOMALY_DETECTED):
+            elif et in (
+                EventType.ERROR_OCCURRED,
+                EventType.ACQUISITION_FAILED,
+                EventType.ANOMALY_DETECTED,
+            ):
                 triggers.append(f"{eid}: {name.lower().replace('_', ' ')}")
             elif et == EventType.DETECTOR_EVALUATED:
                 ta = data.get("temporal_analysis") or {}
diff --git a/gently/core/__init__.py b/gently/core/__init__.py
index fc0406ff..dd351143 100644
--- a/gently/core/__init__.py
+++ b/gently/core/__init__.py
@@ -9,43 +9,40 @@
 
 from .event_bus import (
     Event,
-    EventType,
     EventBus,
-    get_event_bus,
-    set_event_bus,
+    EventType,
     emit,
-    on,
+    get_event_bus,
     handles,
+    on,
+    set_event_bus,
 )
-
 from .service import (
     Service,
-    ServiceState,
+    ServiceClient,
     ServiceInfo,
     ServiceRegistry,
-    ServiceClient,
-
+    ServiceState,
     get_service_registry,
     set_service_registry,
 )
 
 __all__ = [
     # Event bus
-    'Event',
-    'EventType',
-    'EventBus',
-    'get_event_bus',
-    'set_event_bus',
-    'emit',
-    'on',
-    'handles',
+    "Event",
+    "EventType",
+    "EventBus",
+    "get_event_bus",
+    "set_event_bus",
+    "emit",
+    "on",
+    "handles",
     # Service
-    'Service',
-    'ServiceState',
-    'ServiceInfo',
-    'ServiceRegistry',
-    'ServiceClient',
-
-    'get_service_registry',
-    'set_service_registry',
+    "Service",
+    "ServiceState",
+    "ServiceInfo",
+    "ServiceRegistry",
+    "ServiceClient",
+    "get_service_registry",
+    "set_service_registry",
 ]
diff --git a/gently/core/coordinates.py b/gently/core/coordinates.py
index 944fa219..0033756a 100644
--- a/gently/core/coordinates.py
+++ b/gently/core/coordinates.py
@@ -15,8 +15,6 @@
 All other files should import from here.
 """
 
-from typing import Tuple
-
 # Default optical parameters for bottom detection camera
 DEFAULT_PIXEL_SIZE_UM = 6.5
 DEFAULT_OBJECTIVE_MAG = 10.0  # 10x objective on bottom camera
@@ -29,7 +27,7 @@
 
 def get_um_per_pixel(
     pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
-    objective_mag: float = DEFAULT_OBJECTIVE_MAG
+    objective_mag: float = DEFAULT_OBJECTIVE_MAG,
 ) -> float:
     """
     Calculate microns per pixel for the optical system.
@@ -56,8 +54,8 @@ def pixel_to_stage_position(
     image_center_y: float,
     stage_x: float,
     stage_y: float,
-    um_per_pixel: float = None
-) -> Tuple[float, float]:
+    um_per_pixel: float = None,
+) -> tuple[float, float]:
     """
     Convert pixel coordinates to stage position (for embryo POSITION calculation).
 
@@ -101,7 +99,8 @@ def pixel_to_stage_position(
     dy_pixels = pixel_y - image_center_y
 
     # X: NOT inverted (stage coords match image coords for X)
-    # Y: IS inverted (stage +Y moves embryo down, but image +Y is also down, need to invert for centering)
+    # Y: IS inverted (stage +Y moves embryo down, but image +Y is also down,
+    # need to invert for centering)
     embryo_stage_x = stage_x + dx_pixels * um_per_pixel
     embryo_stage_y = stage_y - dy_pixels * um_per_pixel
 
@@ -115,8 +114,8 @@ def stage_to_pixel_position(
     current_stage_y: float,
     image_center_x: float,
     image_center_y: float,
-    um_per_pixel: float = None
-) -> Tuple[float, float]:
+    um_per_pixel: float = None,
+) -> tuple[float, float]:
     """
     Convert stage position to pixel coordinates (for DISPLAY/visualization).
 
@@ -155,10 +154,8 @@ def stage_to_pixel_position(
 
 
 def pixel_displacement_to_stage_movement(
-    pixel_displacement_x: float,
-    pixel_displacement_y: float,
-    um_per_pixel: float = None
-) -> Tuple[float, float]:
+    pixel_displacement_x: float, pixel_displacement_y: float, um_per_pixel: float = None
+) -> tuple[float, float]:
     """
     Convert pixel displacement to stage MOVEMENT (for centering an embryo).
 
diff --git a/gently/core/database.py b/gently/core/database.py
index 7e2a6255..59737bee 100644
--- a/gently/core/database.py
+++ b/gently/core/database.py
@@ -11,17 +11,18 @@
 analysis tools and workflows.
 """
 
-import logging
 import json
+import logging
 from datetime import datetime
-
-logger = logging.getLogger(__name__)
 from pathlib import Path
-from typing import Dict, List, Optional, Any
+from typing import Any
+
 import numpy as np
 
+logger = logging.getLogger(__name__)
 
-def format_timestamp(dt: Optional[datetime] = None) -> str:
+
+def format_timestamp(dt: datetime | None = None) -> str:
     """
     Format datetime as ISO 8601 string for JSON storage.
 
@@ -68,7 +69,7 @@ def numpy_to_python(obj: Any) -> Any:
         return obj
 
 
-def format_embryo_calibration_for_json(calibration_data: Dict) -> Dict:
+def format_embryo_calibration_for_json(calibration_data: dict) -> dict:
     """
     Format embryo calibration data from databroker for JSON export.
 
@@ -90,34 +91,34 @@ def format_embryo_calibration_for_json(calibration_data: Dict) -> Dict:
 
     # Ensure required fields exist
     required_fields = [
-        'slope_um_per_deg',
-        'offset_um',
-        'galvo_top_deg',
-        'galvo_bottom_deg',
-        'piezo_top_um',
-        'piezo_bottom_um',
-        'sample_type',
-        'timestamp',
-        'device_piezo',
-        'device_galvo'
+        "slope_um_per_deg",
+        "offset_um",
+        "galvo_top_deg",
+        "galvo_bottom_deg",
+        "piezo_top_um",
+        "piezo_bottom_um",
+        "sample_type",
+        "timestamp",
+        "device_piezo",
+        "device_galvo",
     ]
 
     for field in required_fields:
         if field not in calibration_json:
             # Provide sensible defaults for missing fields
-            if field == 'sample_type':
-                calibration_json[field] = 'embryo'
-            elif field == 'timestamp':
+            if field == "sample_type":
+                calibration_json[field] = "embryo"
+            elif field == "timestamp":
                 calibration_json[field] = format_timestamp()
-            elif 'device' in field:
-                calibration_json[field] = 'unknown'
+            elif "device" in field:
+                calibration_json[field] = "unknown"
             else:
                 calibration_json[field] = None
 
     return calibration_json
 
 
-def format_embryo_entry_for_json(embryo_data: Dict) -> Dict:
+def format_embryo_entry_for_json(embryo_data: dict) -> dict:
     """
     Format single embryo entry from databroker for JSON export.
 
@@ -132,34 +133,31 @@ def format_embryo_entry_for_json(embryo_data: Dict) -> Dict:
         JSON-compatible embryo entry
     """
     entry = {
-        'embryo_number': int(embryo_data.get('embryo_number', 0)),
-        'marking_timestamp': embryo_data.get('marking_timestamp', format_timestamp()),
-        'bottom_camera_position_pixel': {
-            'x': float(embryo_data.get('pixel_x', 0.0)),
-            'y': float(embryo_data.get('pixel_y', 0.0))
+        "embryo_number": int(embryo_data.get("embryo_number", 0)),
+        "marking_timestamp": embryo_data.get("marking_timestamp", format_timestamp()),
+        "bottom_camera_position_pixel": {
+            "x": float(embryo_data.get("pixel_x", 0.0)),
+            "y": float(embryo_data.get("pixel_y", 0.0)),
         },
-        'initial_stage_position_um': {
-            'x': float(embryo_data.get('initial_stage_x', 0.0)),
-            'y': float(embryo_data.get('initial_stage_y', 0.0))
+        "initial_stage_position_um": {
+            "x": float(embryo_data.get("initial_stage_x", 0.0)),
+            "y": float(embryo_data.get("initial_stage_y", 0.0)),
+        },
+        "stage_position_after_centering_um": {
+            "x": float(embryo_data.get("centered_stage_x", 0.0)),
+            "y": float(embryo_data.get("centered_stage_y", 0.0)),
         },
-        'stage_position_after_centering_um': {
-            'x': float(embryo_data.get('centered_stage_x', 0.0)),
-            'y': float(embryo_data.get('centered_stage_y', 0.0))
-        }
     }
 
     # Add calibration data if present
-    if 'calibration' in embryo_data:
-        entry['calibration'] = format_embryo_calibration_for_json(embryo_data['calibration'])
+    if "calibration" in embryo_data:
+        entry["calibration"] = format_embryo_calibration_for_json(embryo_data["calibration"])
 
     return entry
 
 
 def export_multi_embryo_database(
-    databroker_catalog,
-    session_uid: str,
-    output_path: Path,
-    pretty_print: bool = True
+    databroker_catalog, session_uid: str, output_path: Path, pretty_print: bool = True
 ) -> Path:
     """
     Export multi-embryo calibration data from databroker to JSON database file.
@@ -194,25 +192,25 @@ def export_multi_embryo_database(
     try:
         session_run = databroker_catalog[session_uid]
     except KeyError:
-        raise KeyError(f"Session UID {session_uid} not found in databroker")
+        raise KeyError(f"Session UID {session_uid} not found in databroker") from None
 
     # Handle different databroker API versions
     try:
         # v2 API
-        session_metadata = session_run.metadata['start']
+        session_metadata = session_run.metadata["start"]
     except (AttributeError, KeyError):
         # v1 API
-        session_metadata = session_run['start']
+        session_metadata = session_run["start"]
 
     # Initialize database structure
     database = {
-        'created': session_metadata.get('time', format_timestamp()),
-        'embryos': {},
-        'last_updated': format_timestamp()
+        "created": session_metadata.get("time", format_timestamp()),
+        "embryos": {},
+        "last_updated": format_timestamp(),
     }
 
     # Get list of embryo run UIDs from session metadata
-    embryo_uids = session_metadata.get('embryo_runs', [])
+    embryo_uids = session_metadata.get("embryo_runs", [])
 
     if not embryo_uids:
         logger.warning("No embryo runs found in session %s...", session_uid[:8])
@@ -225,17 +223,19 @@ def export_multi_embryo_database(
 
             # Get embryo metadata
             try:
-                embryo_metadata = embryo_run.metadata['start']
+                embryo_metadata = embryo_run.metadata["start"]
             except (AttributeError, KeyError):
-                embryo_metadata = embryo_run['start']
+                embryo_metadata = embryo_run["start"]
 
-            embryo_id = embryo_metadata.get('embryo_id', f"embryo_{len(database['embryos'])+1:03d}")
+            embryo_id = embryo_metadata.get(
+                "embryo_id", f"embryo_{len(database['embryos']) + 1:03d}"
+            )
 
             # Format embryo entry
             embryo_entry = format_embryo_entry_for_json(embryo_metadata)
 
             # Add to database
-            database['embryos'][embryo_id] = embryo_entry
+            database["embryos"][embryo_id] = embryo_entry
 
         except Exception as e:
             logger.warning("Could not export embryo %s...: %s", embryo_uid[:8], e)
@@ -243,19 +243,23 @@ def export_multi_embryo_database(
 
     # Write to JSON file
     output_path = Path(output_path)
-    with open(output_path, 'w') as f:
+    with open(output_path, "w") as f:
         if pretty_print:
             json.dump(database, f, indent=2)
         else:
             json.dump(database, f)
 
-    logger.info("Exported multi-embryo database: File=%s, Embryos=%d, Session=%s...",
-                 output_path, len(database['embryos']), session_uid[:8])
+    logger.info(
+        "Exported multi-embryo database: File=%s, Embryos=%d, Session=%s...",
+        output_path,
+        len(database["embryos"]),
+        session_uid[:8],
+    )
 
     return output_path
 
 
-def load_multi_embryo_database(database_path: Path) -> Dict:
+def load_multi_embryo_database(database_path: Path) -> dict:
     """
     Load existing multi-embryo database from JSON file.
 
@@ -274,18 +278,18 @@ def load_multi_embryo_database(database_path: Path) -> Dict:
     if not database_path.exists():
         # Return empty database structure
         return {
-            'created': format_timestamp(),
-            'embryos': {},
-            'last_updated': format_timestamp()
+            "created": format_timestamp(),
+            "embryos": {},
+            "last_updated": format_timestamp(),
         }
 
-    with open(database_path, 'r') as f:
+    with open(database_path) as f:
         database = json.load(f)
 
     return database
 
 
-def save_multi_embryo_database(database: Dict, database_path: Path):
+def save_multi_embryo_database(database: dict, database_path: Path):
     """
     Save multi-embryo database to JSON file.
 
@@ -299,17 +303,13 @@ def save_multi_embryo_database(database: Dict, database_path: Path):
     database_path = Path(database_path)
 
     # Update last_updated timestamp
-    database['last_updated'] = format_timestamp()
+    database["last_updated"] = format_timestamp()
 
-    with open(database_path, 'w') as f:
+    with open(database_path, "w") as f:
         json.dump(database, f, indent=2)
 
 
-def add_embryo_to_database(
-    database: Dict,
-    embryo_id: str,
-    embryo_data: Dict
-) -> Dict:
+def add_embryo_to_database(database: dict, embryo_id: str, embryo_data: dict) -> dict:
     """
     Add or update embryo entry in database.
 
@@ -331,13 +331,13 @@ def add_embryo_to_database(
     embryo_entry = format_embryo_entry_for_json(embryo_data)
 
     # Add to database
-    database['embryos'][embryo_id] = embryo_entry
-    database['last_updated'] = format_timestamp()
+    database["embryos"][embryo_id] = embryo_entry
+    database["last_updated"] = format_timestamp()
 
     return database
 
 
-def get_embryo_calibration(database: Dict, embryo_id: str) -> Optional[Dict]:
+def get_embryo_calibration(database: dict, embryo_id: str) -> dict | None:
     """
     Get calibration data for specific embryo from database.
 
@@ -353,15 +353,15 @@ def get_embryo_calibration(database: Dict, embryo_id: str) -> Optional[Dict]:
     dict or None
         Calibration dictionary, or None if not found
     """
-    embryo_entry = database.get('embryos', {}).get(embryo_id)
+    embryo_entry = database.get("embryos", {}).get(embryo_id)
 
     if embryo_entry is None:
         return None
 
-    return embryo_entry.get('calibration')
+    return embryo_entry.get("calibration")
 
 
-def list_embryos(database: Dict) -> List[str]:
+def list_embryos(database: dict) -> list[str]:
     """
     List all embryo IDs in database.
 
@@ -375,12 +375,9 @@ def list_embryos(database: Dict) -> List[str]:
     list of str
         Embryo IDs sorted by embryo number
     """
-    embryos = database.get('embryos', {})
+    embryos = database.get("embryos", {})
 
     # Sort by embryo_number
-    sorted_embryos = sorted(
-        embryos.items(),
-        key=lambda x: x[1].get('embryo_number', 0)
-    )
+    sorted_embryos = sorted(embryos.items(), key=lambda x: x[1].get("embryo_number", 0))
 
     return [embryo_id for embryo_id, _ in sorted_embryos]
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index da10b19e..3b98e616 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -10,14 +10,14 @@
 
 import asyncio
 import logging
-import time
+import threading
+import uuid
+from collections import deque
+from collections.abc import Callable
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum, auto
-from typing import Any, Callable, Dict, List, Optional, Set, Union
-from collections import deque
-import threading
-import uuid
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -44,20 +44,22 @@ class EventType(Enum):
     EMBRYO_CENTERED = auto()
     EMBRYO_CALIBRATED = auto()
     EMBRYO_SKIPPED = auto()
-    EMBRYO_TERMINATED = auto()  # {embryo_id, completion_reason} - emitted when an embryo's imaging stops (any reason: no_object terminal, stop condition met, errors, user removal)
+    # {embryo_id, completion_reason} - emitted when an embryo's imaging stops
+    # (any reason: no_object terminal, stop condition met, errors, user removal)
+    EMBRYO_TERMINATED = auto()
 
     # Analysis events
     ANALYSIS_STARTED = auto()
     ANALYSIS_COMPLETED = auto()
-    DETECTOR_EVALUATED = auto()   # Emitted for every detector run (all evaluations)
+    DETECTOR_EVALUATED = auto()  # Emitted for every detector run (all evaluations)
     DETECTION_TRIGGERED = auto()  # Emitted only when detected=True (positive detection)
     HATCHING_DETECTED = auto()
 
     # Verification events (multi-strategy verification for detections)
-    VERIFICATION_STARTED = auto()       # Verification round begins for embryo
-    VERIFICATION_STRATEGY = auto()      # Individual strategy result (adversarial, temporal, etc.)
-    VERIFICATION_PROGRESS = auto()      # Progress update (e.g., "3/5 strategies complete")
-    VERIFICATION_COMPLETED = auto()     # Final verification result with consensus
+    VERIFICATION_STARTED = auto()  # Verification round begins for embryo
+    VERIFICATION_STRATEGY = auto()  # Individual strategy result (adversarial, temporal, etc.)
+    VERIFICATION_PROGRESS = auto()  # Progress update (e.g., "3/5 strategies complete")
+    VERIFICATION_COMPLETED = auto()  # Final verification result with consensus
 
     # CV Subagent events
     SEGMENTATION_COMPLETED = auto()
@@ -81,9 +83,9 @@ class EventType(Enum):
     STAGE_MOVED = auto()
     FOCUS_CHANGED = auto()
     LASER_CHANGED = auto()
-    DEVICE_STATE_UPDATE = auto()   # Periodic device-state snapshot from device layer
-    BOTTOM_CAMERA_FRAME = auto()   # Live JPEG frame from the bottom camera stream
-    EMBRYOS_UPDATE = auto()        # Full embryo list snapshot from agent.experiment
+    DEVICE_STATE_UPDATE = auto()  # Periodic device-state snapshot from device layer
+    BOTTOM_CAMERA_FRAME = auto()  # Live JPEG frame from the bottom camera stream
+    EMBRYOS_UPDATE = auto()  # Full embryo list snapshot from agent.experiment
 
     # Python logging.LogRecord republished onto the bus so the Events page
     # surfaces what would otherwise only land in the terminal. See
@@ -94,9 +96,9 @@ class EventType(Enum):
     # carry intent ("a human did this") rather than just state delta.
     # Candidate orchestrators can subscribe and reason about what the
     # operator just did without having to type it in chat.
-    OPERATOR_EDITED_EMBRYO    = auto()   # Map drag/drop -> PUT /api/embryos/{id}/position
-    OPERATOR_REMOVED_EMBRYO   = auto()   # Map delete  -> DELETE /api/embryos/{id}
-    OPERATOR_MARKED_EMBRYOS   = auto()   # Marking canvas "Done" — operator confirmed N positions
+    OPERATOR_EDITED_EMBRYO = auto()  # Map drag/drop -> PUT /api/embryos/{id}/position
+    OPERATOR_REMOVED_EMBRYO = auto()  # Map delete  -> DELETE /api/embryos/{id}
+    OPERATOR_MARKED_EMBRYOS = auto()  # Marking canvas "Done" — operator confirmed N positions
 
     # System events
     ERROR_OCCURRED = auto()
@@ -104,12 +106,14 @@ class EventType(Enum):
     STATUS_CHANGED = auto()
 
     # Async timelapse — per-embryo cadence transitions (Phase 4)
-    EMBRYO_CADENCE_CHANGED = auto()  # {embryo_id, old_phase, new_phase, old_interval_s, new_interval_s, next_due_at}
+    EMBRYO_CADENCE_CHANGED = (
+        auto()
+    )  # {embryo_id, old_phase, new_phase, old_interval_s, new_interval_s, next_due_at}
 
     # Burst lifecycle (Phase 7 / 10)
-    BURST_QUEUED = auto()    # {embryo_id, request_id, position_in_queue}
-    BURST_START = auto()     # {embryo_id, request_id, frames, mode}
-    BURST_FRAME = auto()     # {embryo_id, request_id, frame_idx, total_frames}
+    BURST_QUEUED = auto()  # {embryo_id, request_id, position_in_queue}
+    BURST_START = auto()  # {embryo_id, request_id, frames, mode}
+    BURST_FRAME = auto()  # {embryo_id, request_id, frame_idx, total_frames}
     BURST_COMPLETE = auto()  # {embryo_id, request_id, mp4_path, sustained_hz, frames_captured}
 
     # Reactive control telemetry (Phase 5 / 10)
@@ -147,17 +151,17 @@ class EventType(Enum):
     MESH_SCOPE_DENIED = auto()
 
     # Mesh topology events
-    MESH_PEER_OFFLINE = auto()      # peer marked offline in verse map (kept in map)
-    MESH_PEER_RETURNED = auto()     # previously offline peer came back online
+    MESH_PEER_OFFLINE = auto()  # peer marked offline in verse map (kept in map)
+    MESH_PEER_RETURNED = auto()  # previously offline peer came back online
 
     # ML pipeline events
     ML_PIPELINE_CREATED = auto()
     ML_TRAINING_STARTED = auto()
-    ML_TRAINING_PROGRESS = auto()   # per-epoch updates
+    ML_TRAINING_PROGRESS = auto()  # per-epoch updates
     ML_TRAINING_COMPLETED = auto()
     ML_TRAINING_FAILED = auto()
     ML_EVALUATION_COMPLETED = auto()
-    ML_SUBAGENT_STATUS = auto()     # subagent thinking/planning updates
+    ML_SUBAGENT_STATUS = auto()  # subagent thinking/planning updates
 
     # Bulk transfer events
     TRANSFER_STARTED = auto()
@@ -169,13 +173,15 @@ class EventType(Enum):
 # High-volume telemetry events that skip the bounded history deque. These
 # fire many times per second and would push out events that humans actually
 # want to inspect later (acquisitions, perceptions, errors).
-_NO_HISTORY_TYPES = frozenset({
-    EventType.DEVICE_STATE_UPDATE,
-    EventType.BOTTOM_CAMERA_FRAME,  # ~2 Hz JPEG frames — would crowd history out
-    EventType.LOG_RECORD,           # log lines can hit hundreds/min during
-                                    # calibration; durable copy is in the
-                                    # gently_*.log file already
-})
+_NO_HISTORY_TYPES = frozenset(
+    {
+        EventType.DEVICE_STATE_UPDATE,
+        EventType.BOTTOM_CAMERA_FRAME,  # ~2 Hz JPEG frames — would crowd history out
+        EventType.LOG_RECORD,  # log lines can hit hundreds/min during
+        # calibration; durable copy is in the
+        # gently_*.log file already
+    }
+)
 
 
 @dataclass
@@ -198,37 +204,40 @@ class Event:
     correlation_id : str, optional
         ID to correlate related events (e.g., request/response)
     """
+
     event_type: EventType
-    data: Dict[str, Any] = field(default_factory=dict)
+    data: dict[str, Any] = field(default_factory=dict)
     source: str = "unknown"
     timestamp: datetime = field(default_factory=datetime.now)
     event_id: str = field(default_factory=lambda: str(uuid.uuid4())[:8])
-    correlation_id: Optional[str] = None
+    correlation_id: str | None = None
 
     def __str__(self) -> str:
         return f"Event({self.event_type.name}, source={self.source}, id={self.event_id})"
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize for storage/transmission"""
         return {
-            'event_type': self.event_type.name,
-            'data': self.data,
-            'source': self.source,
-            'timestamp': self.timestamp.isoformat(),
-            'event_id': self.event_id,
-            'correlation_id': self.correlation_id,
+            "event_type": self.event_type.name,
+            "data": self.data,
+            "source": self.source,
+            "timestamp": self.timestamp.isoformat(),
+            "event_id": self.event_id,
+            "correlation_id": self.correlation_id,
         }
 
     @classmethod
-    def from_dict(cls, d: Dict) -> 'Event':
+    def from_dict(cls, d: dict) -> "Event":
         """Deserialize from dict"""
         return cls(
-            event_type=EventType[d['event_type']],
-            data=d.get('data', {}),
-            source=d.get('source', 'unknown'),
-            timestamp=datetime.fromisoformat(d['timestamp']) if 'timestamp' in d else datetime.now(),
-            event_id=d.get('event_id', str(uuid.uuid4())[:8]),
-            correlation_id=d.get('correlation_id'),
+            event_type=EventType[d["event_type"]],
+            data=d.get("data", {}),
+            source=d.get("source", "unknown"),
+            timestamp=datetime.fromisoformat(d["timestamp"])
+            if "timestamp" in d
+            else datetime.now(),
+            event_id=d.get("event_id", str(uuid.uuid4())[:8]),
+            correlation_id=d.get("correlation_id"),
         )
 
 
@@ -255,17 +264,17 @@ def __init__(self, history_size: int = 100):
         history_size : int
             Number of recent events to keep in history
         """
-        self._handlers: Dict[EventType, List[EventHandler]] = {}
-        self._async_handlers: Dict[EventType, List[AsyncEventHandler]] = {}
-        self._wildcard_handlers: List[EventHandler] = []
-        self._async_wildcard_handlers: List[AsyncEventHandler] = []
+        self._handlers: dict[EventType, list[EventHandler]] = {}
+        self._async_handlers: dict[EventType, list[AsyncEventHandler]] = {}
+        self._wildcard_handlers: list[EventHandler] = []
+        self._async_wildcard_handlers: list[AsyncEventHandler] = []
         self._history: deque = deque(maxlen=history_size)
         self._lock = threading.RLock()
-        self._event_loop: Optional[asyncio.AbstractEventLoop] = None
+        self._event_loop: asyncio.AbstractEventLoop | None = None
 
     def subscribe(
         self,
-        event_type: Union[EventType, str],
+        event_type: EventType | str,
         handler: EventHandler,
     ) -> Callable[[], None]:
         """
@@ -305,7 +314,7 @@ def unsubscribe():
 
     def subscribe_async(
         self,
-        event_type: Union[EventType, str],
+        event_type: EventType | str,
         handler: AsyncEventHandler,
     ) -> Callable[[], None]:
         """
@@ -346,9 +355,9 @@ def unsubscribe():
     def publish(
         self,
         event_type: EventType,
-        data: Optional[Dict] = None,
+        data: dict | None = None,
         source: str = "unknown",
-        correlation_id: Optional[str] = None,
+        correlation_id: str | None = None,
     ) -> Event:
         """
         Publish an event to all subscribers
@@ -477,10 +486,10 @@ def set_event_loop(self, loop: asyncio.AbstractEventLoop):
 
     def get_history(
         self,
-        event_type: Optional[EventType] = None,
-        source: Optional[str] = None,
+        event_type: EventType | None = None,
+        source: str | None = None,
         limit: int = 50,
-    ) -> List[Event]:
+    ) -> list[Event]:
         """
         Get recent event history
 
@@ -515,7 +524,7 @@ def clear_history(self):
         with self._lock:
             self._history.clear()
 
-    def get_handler_count(self, event_type: Optional[EventType] = None) -> int:
+    def get_handler_count(self, event_type: EventType | None = None) -> int:
         """Get count of registered handlers"""
         with self._lock:
             if event_type:
@@ -531,7 +540,7 @@ def get_handler_count(self, event_type: Optional[EventType] = None) -> int:
 
 
 # Global event bus instance
-_global_bus: Optional[EventBus] = None
+_global_bus: EventBus | None = None
 
 
 def get_event_bus() -> EventBus:
@@ -551,20 +560,20 @@ def set_event_bus(bus: EventBus):
 # Convenience functions for common operations
 def emit(
     event_type: EventType,
-    data: Optional[Dict] = None,
+    data: dict | None = None,
     source: str = "unknown",
 ) -> Event:
     """Emit an event on the global bus"""
     return get_event_bus().publish(event_type, data, source)
 
 
-def on(event_type: Union[EventType, str], handler: EventHandler) -> Callable[[], None]:
+def on(event_type: EventType | str, handler: EventHandler) -> Callable[[], None]:
     """Subscribe to events on the global bus"""
     return get_event_bus().subscribe(event_type, handler)
 
 
 # Decorator for event handlers
-def handles(event_type: Union[EventType, str]):
+def handles(event_type: EventType | str):
     """
     Decorator to register a function as an event handler
 
@@ -573,7 +582,9 @@ def handles(event_type: Union[EventType, str]):
         def on_volume(event):
             print(f"Got volume: {event.data}")
     """
+
     def decorator(func: EventHandler) -> EventHandler:
         get_event_bus().subscribe(event_type, func)
         return func
+
     return decorator
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index e4f14009..b9658c0c 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -58,7 +58,7 @@
 import time
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import numpy as np
 import yaml
@@ -66,7 +66,6 @@
 from .store_types import (
     EmbryoInfo,
     GroundTruthEntry,
-    PerceptionRunInfo,
     PredictionInfo,
     ProjectionInfo,
     SessionInfo,
@@ -81,6 +80,7 @@
 # Helpers
 # ---------------------------------------------------------------------------
 
+
 def _slugify(text: str, max_len: int = 30) -> str:
     """Lowercase, replace non-alphanum with hyphens, truncate."""
     if not text:
@@ -108,7 +108,7 @@ def _sanitize_for_yaml(obj):
     return obj
 
 
-def _coarse_from_legacy(record: dict) -> Optional[dict]:
+def _coarse_from_legacy(record: dict) -> dict | None:
     """Extract coarse XY from an embryo.yaml record, accepting either the new
     `position_coarse` dict or the legacy flat `position_x` / `position_y` keys.
     Returns None if neither shape carries usable values.
@@ -127,7 +127,7 @@ def _coarse_from_legacy(record: dict) -> Optional[dict]:
     return out or None
 
 
-def _normalize_embryo_record(record: Optional[dict]) -> Optional[dict]:
+def _normalize_embryo_record(record: dict | None) -> dict | None:
     """Backfill an embryo.yaml dict so callers always see the new schema.
 
     Adds `position_coarse` derived from legacy `position_x` / `position_y` if
@@ -149,13 +149,10 @@ def _write_yaml(path: Path, data: Any) -> None:
     """Write YAML atomically: write to a temp file, then rename."""
     path.parent.mkdir(parents=True, exist_ok=True)
     data = _sanitize_for_yaml(data)
-    fd, tmp = tempfile.mkstemp(
-        suffix=".tmp", prefix=path.stem, dir=str(path.parent)
-    )
+    fd, tmp = tempfile.mkstemp(suffix=".tmp", prefix=path.stem, dir=str(path.parent))
     try:
         with os.fdopen(fd, "w", encoding="utf-8") as f:
-            yaml.safe_dump(data, f, default_flow_style=False, sort_keys=False,
-                           allow_unicode=True)
+            yaml.safe_dump(data, f, default_flow_style=False, sort_keys=False, allow_unicode=True)
             f.flush()
             os.fsync(f.fileno())
         # os.replace is atomic and overwrites on Windows — no unlink gap that
@@ -185,13 +182,13 @@ def _read_yaml(path: Path) -> Any:
     """
     if not path.exists():
         return None
-    with open(path, "r", encoding="utf-8") as f:
+    with open(path, encoding="utf-8") as f:
         text = f.read()
     try:
         return yaml.safe_load(text)
     except yaml.constructor.ConstructorError as err:
         marker = str(err)
-        if 'python/object' not in marker and 'numpy' not in marker:
+        if "python/object" not in marker and "numpy" not in marker:
             raise
         data = yaml.unsafe_load(text)
         return _sanitize_for_yaml(data)
@@ -204,12 +201,12 @@ def _append_jsonl(path: Path, record: dict) -> None:
         f.write(json.dumps(record, ensure_ascii=False, default=str) + "\n")
 
 
-def _read_jsonl(path: Path) -> List[dict]:
+def _read_jsonl(path: Path) -> list[dict]:
     """Read all lines from a JSONL file."""
     if not path.exists():
         return []
     records = []
-    with open(path, "r", encoding="utf-8") as f:
+    with open(path, encoding="utf-8") as f:
         for line in f:
             line = line.strip()
             if line:
@@ -225,6 +222,7 @@ def _now() -> str:
 # FileStore
 # ---------------------------------------------------------------------------
 
+
 class FileStore:
     """Pure file-based storage for Gently.  Drop-in replacement for GentlyStore."""
 
@@ -245,7 +243,7 @@ def __init__(self, root: Path):
 
         # Load session index (session_id -> folder_name)
         self._index_path = self._root / "sessions" / "_index.yaml"
-        self._index: Dict[str, str] = _read_yaml(self._index_path) or {}
+        self._index: dict[str, str] = _read_yaml(self._index_path) or {}
 
     # ------------------------------------------------------------------
     # Properties
@@ -267,7 +265,7 @@ def _save_index(self) -> None:
         """Persist the session index mapping to disk."""
         _write_yaml(self._index_path, self._index)
 
-    def _session_dir(self, session_id: str) -> Optional[Path]:
+    def _session_dir(self, session_id: str) -> Path | None:
         """Return the session folder path, or None if unknown."""
         folder = self._index.get(session_id)
         if folder is None:
@@ -315,7 +313,7 @@ def _generate_projection(
         embryo_id: str,
         timepoint: int,
         volume: np.ndarray,
-    ) -> Optional[Path]:
+    ) -> Path | None:
         """Generate JPEG projection file from volume data."""
         from .imaging import generate_jpeg_projection
 
@@ -368,7 +366,7 @@ def create_session(
         logger.info("Created session %s -> %s", session_id, folder_name)
         return session_id
 
-    def get_session(self, session_id: str) -> Optional[SessionInfo]:
+    def get_session(self, session_id: str) -> SessionInfo | None:
         """Return session info as dict, or None."""
         sd = self._session_dir(session_id)
         if sd is None or not sd.exists():
@@ -378,7 +376,7 @@ def get_session(self, session_id: str) -> Optional[SessionInfo]:
             return None
         return data
 
-    def list_sessions(self) -> List[SessionInfo]:
+    def list_sessions(self) -> list[SessionInfo]:
         """Return all sessions ordered by last_active descending."""
         sessions = []
         for sid in self._index:
@@ -388,7 +386,7 @@ def list_sessions(self) -> List[SessionInfo]:
         sessions.sort(key=lambda s: s.get("last_active", ""), reverse=True)
         return sessions
 
-    def recent_session_ids(self, limit: int = 8) -> List[str]:
+    def recent_session_ids(self, limit: int = 8) -> list[str]:
         """Most-recent session IDs by folder-name date prefix, *cheaply*.
 
         Folder names are ``{YYYYMMDD}_{HHMM}_{slug}_{id8}`` so a reverse lexical
@@ -420,9 +418,7 @@ def save_session_snapshot(self, session_id: str, snapshot: dict) -> None:
         sd = self._require_session_dir(session_id)
         path = sd / "conversation.json"
         # Write atomically via temp file
-        fd, tmp = tempfile.mkstemp(
-            suffix=".tmp", prefix="conversation", dir=str(sd)
-        )
+        fd, tmp = tempfile.mkstemp(suffix=".tmp", prefix="conversation", dir=str(sd))
         try:
             with os.fdopen(fd, "w", encoding="utf-8") as f:
                 json.dump(snapshot, f, indent=2, ensure_ascii=False, default=str)
@@ -437,7 +433,7 @@ def save_session_snapshot(self, session_id: str, snapshot: dict) -> None:
             raise
         self.touch_session(session_id)
 
-    def load_session_snapshot(self, session_id: str) -> Optional[dict]:
+    def load_session_snapshot(self, session_id: str) -> dict | None:
         """Load conversation.json.  Returns None if missing."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -445,7 +441,7 @@ def load_session_snapshot(self, session_id: str) -> Optional[dict]:
         path = sd / "conversation.json"
         if not path.exists():
             return None
-        with open(path, "r", encoding="utf-8") as f:
+        with open(path, encoding="utf-8") as f:
             return json.load(f)
 
     # ------------------------------------------------------------------
@@ -525,9 +521,15 @@ def register_embryo(
                 "session_id": session_id,
                 "embryo_uid": embryo_uid if embryo_uid is not None else existing.get("embryo_uid"),
                 "nickname": nickname if nickname is not None else existing.get("nickname"),
-                "position_coarse": position_coarse if position_coarse is not None else existing_coarse,
-                "position_fine": position_fine if position_fine is not None else existing.get("position_fine"),
-                "calibration": calibration if calibration is not None else existing.get("calibration"),
+                "position_coarse": position_coarse
+                if position_coarse is not None
+                else existing_coarse,
+                "position_fine": position_fine
+                if position_fine is not None
+                else existing.get("position_fine"),
+                "calibration": calibration
+                if calibration is not None
+                else existing.get("calibration"),
                 "role": role if role is not None else existing.get("role", "test"),
                 "created_at": existing.get("created_at", _now()),
             }
@@ -546,7 +548,7 @@ def register_embryo(
 
         _write_yaml(yaml_path, embryo_data)
 
-    def get_embryo(self, session_id: str, embryo_id: str) -> Optional[EmbryoInfo]:
+    def get_embryo(self, session_id: str, embryo_id: str) -> EmbryoInfo | None:
         """Read embryo.yaml. Returns None if not found.
 
         Backfills position_coarse from legacy position_x / position_y so
@@ -559,7 +561,7 @@ def get_embryo(self, session_id: str, embryo_id: str) -> Optional[EmbryoInfo]:
         data = _read_yaml(yaml_path)
         return _normalize_embryo_record(data)
 
-    def list_embryos(self, session_id: str) -> List[EmbryoInfo]:
+    def list_embryos(self, session_id: str) -> list[EmbryoInfo]:
         """List all embryos for a session, sorted by embryo_id."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -577,7 +579,7 @@ def list_embryos(self, session_id: str) -> List[EmbryoInfo]:
                     result.append(_normalize_embryo_record(data))
         return result
 
-    def list_embryo_ids(self, session_id: str) -> List[str]:
+    def list_embryo_ids(self, session_id: str) -> list[str]:
         """Embryo IDs from directory names only — no ``embryo.yaml`` parse.
 
         The directory name *is* the embryo_id in this layout (see
@@ -644,9 +646,7 @@ def put_volume(
         # Generate projection
         self._generate_projection(session_id, embryo_id, timepoint, volume)
 
-        logger.debug(
-            "put_volume: %s/%s t=%d -> %s", session_id, embryo_id, timepoint, vol_path
-        )
+        logger.debug("put_volume: %s/%s t=%d -> %s", session_id, embryo_id, timepoint, vol_path)
         return vol_path
 
     def register_volume(
@@ -695,6 +695,7 @@ def register_volume(
             volume = volume_data
         else:
             from .imaging import load_volume
+
             volume = load_volume(canonical)
 
         # Write sidecar metadata
@@ -715,33 +716,26 @@ def register_volume(
         logger.debug("register_volume: %s -> %s", incoming_path.name, canonical)
         return canonical
 
-    def get_volume(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[np.ndarray]:
+    def get_volume(self, session_id: str, embryo_id: str, timepoint: int) -> np.ndarray | None:
         """Load a volume from disk.  Returns None if not found."""
         path = self.get_volume_path(session_id, embryo_id, timepoint)
         if path is None or not path.exists():
             return None
         import tifffile
+
         return tifffile.imread(str(path))
 
-    def get_volume_path(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[Path]:
+    def get_volume_path(self, session_id: str, embryo_id: str, timepoint: int) -> Path | None:
         """Return the absolute path to a volume TIFF, or None."""
         sd = self._session_dir(session_id)
         if sd is None:
             return None
-        vol_path = (
-            sd / "embryos" / embryo_id / "volumes" / self._volume_filename(timepoint)
-        )
+        vol_path = sd / "embryos" / embryo_id / "volumes" / self._volume_filename(timepoint)
         if vol_path.exists():
             return vol_path
         return None
 
-    def list_volumes(
-        self, session_id: str, embryo_id: str = None
-    ) -> List[VolumeInfo]:
+    def list_volumes(self, session_id: str, embryo_id: str = None) -> list[VolumeInfo]:
         """List volume metadata by scanning sidecar YAML files on disk."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -755,11 +749,9 @@ def list_volumes(
         if embryo_id:
             dirs = [embryos_dir / embryo_id]
         else:
-            dirs = sorted(
-                d for d in embryos_dir.iterdir() if d.is_dir()
-            )
+            dirs = sorted(d for d in embryos_dir.iterdir() if d.is_dir())
 
-        result: List[VolumeInfo] = []
+        result: list[VolumeInfo] = []
         for edir in dirs:
             vol_dir = edir / "volumes"
             if not vol_dir.exists():
@@ -769,9 +761,7 @@ def list_volumes(
                 if data is None:
                     continue
                 # Build a VolumeInfo dict
-                tif_path = meta_file.parent / meta_file.name.replace(
-                    ".meta.yaml", ".tif"
-                )
+                tif_path = meta_file.parent / meta_file.name.replace(".meta.yaml", ".tif")
                 info: VolumeInfo = {
                     "session_id": data.get("session_id", session_id),
                     "embryo_id": data.get("embryo_id", edir.name),
@@ -788,9 +778,7 @@ def list_volumes(
         result.sort(key=lambda v: (v["embryo_id"], v["timepoint"]))
         return result
 
-    def get_acquisition_params(
-        self, session_id: str, embryo_id: str = None
-    ) -> Optional[dict]:
+    def get_acquisition_params(self, session_id: str, embryo_id: str = None) -> dict | None:
         """
         Get acquisition parameters from the most recent volume sidecar.
 
@@ -808,24 +796,19 @@ def get_acquisition_params(
     # Projections
     # ==================================================================
 
-    def get_projection_path(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[Path]:
+    def get_projection_path(self, session_id: str, embryo_id: str, timepoint: int) -> Path | None:
         """Return absolute path to the JPEG projection, or None."""
         sd = self._session_dir(session_id)
         if sd is None:
             return None
         proj_path = (
-            sd / "embryos" / embryo_id / "projections"
-            / self._projection_filename(timepoint)
+            sd / "embryos" / embryo_id / "projections" / self._projection_filename(timepoint)
         )
         if proj_path.exists():
             return proj_path
         return None
 
-    def list_projection_timepoints(
-        self, session_id: str, embryo_id: str
-    ) -> List[int]:
+    def list_projection_timepoints(self, session_id: str, embryo_id: str) -> list[int]:
         """Cheaply list projection timepoints (glob only, no PIL/meta reads).
 
         Used to rehydrate the viz image store on resume without paying the
@@ -837,16 +820,14 @@ def list_projection_timepoints(
         proj_dir = sd / "embryos" / embryo_id / "projections"
         if not proj_dir.exists():
             return []
-        tps: List[int] = []
+        tps: list[int] = []
         for jpg in proj_dir.glob("t*.jpg"):
             m = re.match(r"t(\d+)\.jpg$", jpg.name)
             if m:
                 tps.append(int(m.group(1)))
         return sorted(tps)
 
-    def get_projection_b64(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[str]:
+    def get_projection_b64(self, session_id: str, embryo_id: str, timepoint: int) -> str | None:
         """Return base64-encoded JPEG projection, or None."""
         path = self.get_projection_path(session_id, embryo_id, timepoint)
         if path is None or not path.exists():
@@ -854,9 +835,7 @@ def get_projection_b64(
         with open(path, "rb") as f:
             return base64.b64encode(f.read()).decode("utf-8")
 
-    def list_projections(
-        self, session_id: str, embryo_id: str
-    ) -> List[ProjectionInfo]:
+    def list_projections(self, session_id: str, embryo_id: str) -> list[ProjectionInfo]:
         """List projection info for an embryo by scanning projection files."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -865,7 +844,7 @@ def list_projections(
         if not proj_dir.exists():
             return []
 
-        result: List[ProjectionInfo] = []
+        result: list[ProjectionInfo] = []
         for jpg in sorted(proj_dir.glob("t*.jpg")):
             # Extract timepoint from filename  t0003.jpg -> 3
             match = re.match(r"t(\d+)\.jpg$", jpg.name)
@@ -877,6 +856,7 @@ def list_projections(
             width, height, size_kb = None, None, None
             try:
                 from PIL import Image as PILImage
+
                 img = PILImage.open(str(jpg))
                 width, height = img.size
                 size_kb = round(jpg.stat().st_size / 1024, 1)
@@ -885,10 +865,7 @@ def list_projections(
 
             # Use the volume sidecar's acquired_at as the projection created_at
             # if available; otherwise use the file mtime.
-            meta_path = (
-                sd / "embryos" / embryo_id / "volumes"
-                / self._volume_meta_filename(tp)
-            )
+            meta_path = sd / "embryos" / embryo_id / "volumes" / self._volume_meta_filename(tp)
             vol_meta = _read_yaml(meta_path)
             created = (
                 vol_meta.get("acquired_at", "")
@@ -949,6 +926,7 @@ def register_snapshot(
         # Read shape for the sidecar
         try:
             import tifffile
+
             arr = tifffile.imread(str(canonical))
             sidecar["width"] = int(arr.shape[-1]) if arr.ndim >= 2 else None
             sidecar["height"] = int(arr.shape[-2]) if arr.ndim >= 2 else None
@@ -964,9 +942,7 @@ def register_snapshot(
         logger.debug("register_snapshot: %s -> %s", incoming_path.name, canonical)
         return canonical
 
-    def list_snapshots(
-        self, session_id: str, source: str = None
-    ) -> List[Dict[str, Any]]:
+    def list_snapshots(self, session_id: str, source: str = None) -> list[dict[str, Any]]:
         """List snapshot records for a session, optionally filtered by source."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -1013,9 +989,7 @@ def cleanup_incoming(self, max_age_seconds: float = 300) -> int:
                     deleted += 1
                     logger.debug("cleanup_incoming: deleted %s", f.name)
                 except OSError as e:
-                    logger.warning(
-                        "cleanup_incoming: could not delete %s: %s", f.name, e
-                    )
+                    logger.warning("cleanup_incoming: could not delete %s: %s", f.name, e)
         if deleted:
             logger.info("cleanup_incoming: removed %d stale file(s)", deleted)
         return deleted
@@ -1028,7 +1002,7 @@ def _perception_runs_path(self, session_id: str) -> Path:
         sd = self._require_session_dir(session_id)
         return sd / "perception_runs.yaml"
 
-    def _load_perception_runs(self, session_id: str) -> Dict[int, dict]:
+    def _load_perception_runs(self, session_id: str) -> dict[int, dict]:
         """Load perception_runs.yaml as {run_id: run_metadata}."""
         data = _read_yaml(self._perception_runs_path(session_id))
         if data is None:
@@ -1036,9 +1010,7 @@ def _load_perception_runs(self, session_id: str) -> Dict[int, dict]:
         # Ensure keys are ints
         return {int(k): v for k, v in data.items()}
 
-    def _save_perception_runs(
-        self, session_id: str, runs: Dict[int, dict]
-    ) -> None:
+    def _save_perception_runs(self, session_id: str, runs: dict[int, dict]) -> None:
         _write_yaml(self._perception_runs_path(session_id), runs)
 
     def create_perception_run(
@@ -1163,7 +1135,7 @@ def get_predictions(
         session_id: str,
         embryo_id: str = None,
         run_id: int = None,
-    ) -> List[PredictionInfo]:
+    ) -> list[PredictionInfo]:
         """Query predictions with optional filters."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -1179,7 +1151,7 @@ def get_predictions(
         else:
             dirs = sorted(d for d in embryos_dir.iterdir() if d.is_dir())
 
-        result: List[PredictionInfo] = []
+        result: list[PredictionInfo] = []
         for edir in dirs:
             pred_path = edir / "predictions.jsonl"
             records = _read_jsonl(pred_path)
@@ -1228,23 +1200,23 @@ def set_ground_truth(
         if not found:
             # Auto-increment id
             max_id = max((e.get("id", 0) for e in entries), default=0)
-            entries.append({
-                "id": max_id + 1,
-                "session_id": session_id,
-                "embryo_id": embryo_id,
-                "stage": stage,
-                "start_timepoint": start_timepoint,
-                "end_timepoint": end_timepoint,
-                "annotator": annotator,
-                "notes": notes,
-                "created_at": now,
-            })
+            entries.append(
+                {
+                    "id": max_id + 1,
+                    "session_id": session_id,
+                    "embryo_id": embryo_id,
+                    "stage": stage,
+                    "start_timepoint": start_timepoint,
+                    "end_timepoint": end_timepoint,
+                    "annotator": annotator,
+                    "notes": notes,
+                    "created_at": now,
+                }
+            )
 
         _write_yaml(gt_path, entries)
 
-    def get_ground_truth(
-        self, session_id: str, embryo_id: str
-    ) -> List[GroundTruthEntry]:
+    def get_ground_truth(self, session_id: str, embryo_id: str) -> list[GroundTruthEntry]:
         """Get ground-truth annotations sorted by start_timepoint."""
         sd = self._session_dir(session_id)
         if sd is None:
diff --git a/gently/core/gently_manifest.py b/gently/core/gently_manifest.py
index 75c26345..7ddeff7b 100644
--- a/gently/core/gently_manifest.py
+++ b/gently/core/gently_manifest.py
@@ -4,10 +4,11 @@
 Called once on first initialization of a new storage root.
 """
 
-import yaml
 from datetime import datetime
 from pathlib import Path
 
+import yaml
+
 MANIFEST_VERSION = 3
 
 MANIFEST = {
@@ -47,7 +48,9 @@
         "volumes": "t{NNNN}.tif — zlib-compressed TIFF stacks",
         "projections": "t{NNNN}.jpg — max-intensity JPEG projections",
         "traces": "t{NNNN}.json — complete perception record per timepoint",
-        "predictions.jsonl": "One-line-per-timepoint summary: {timepoint, stage, confidence, timestamp}",
+        "predictions.jsonl": (
+            "One-line-per-timepoint summary: {timepoint, stage, confidence, timestamp}"
+        ),
         "ground_truth.yaml": "Human annotations: [{stage, start_timepoint, end_timepoint}]",
     },
     "agent_memory": {
@@ -70,7 +73,14 @@ def write_manifest(root: Path):
     data["created"] = datetime.now().strftime("%Y-%m-%d")
 
     with open(manifest_path, "w", encoding="utf-8") as f:
-        yaml.dump(data, f, default_flow_style=False, sort_keys=False, allow_unicode=True, width=100)
+        yaml.dump(
+            data,
+            f,
+            default_flow_style=False,
+            sort_keys=False,
+            allow_unicode=True,
+            width=100,
+        )
 
 
 def read_manifest(root: Path) -> dict:
@@ -78,5 +88,5 @@ def read_manifest(root: Path) -> dict:
     manifest_path = root / "gently.yaml"
     if not manifest_path.exists():
         return {}
-    with open(manifest_path, "r", encoding="utf-8") as f:
+    with open(manifest_path, encoding="utf-8") as f:
         return yaml.safe_load(f) or {}
diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index 9f5d2a96..6ff46c14 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -22,7 +22,6 @@
 import io
 import logging
 from pathlib import Path
-from typing import Optional, Tuple
 
 import numpy as np
 
@@ -30,6 +29,7 @@
 
 try:
     from PIL import Image
+
     PIL_AVAILABLE = True
 except ImportError:
     PIL_AVAILABLE = False
@@ -246,8 +246,7 @@ def compress_image_for_api(
             image = np.repeat(image, 10, axis=1)
 
     img = normalize_to_uint8(image, method="percentile", p_low=1, p_high=99.5)
-    b64 = image_to_base64(img, format="JPEG", quality=quality,
-                          max_dimension=max_dimension)
+    b64 = image_to_base64(img, format="JPEG", quality=quality, max_dimension=max_dimension)
     size_kb = len(base64.b64decode(b64)) / 1024
     return b64, size_kb
 
@@ -257,7 +256,7 @@ def generate_jpeg_projection(
     output_path: Path,
     max_dimension: int = 1024,
     quality: int = 90,
-) -> Optional[Path]:
+) -> Path | None:
     """
     Generate a JPEG max-projection from a volume and write to disk.
 
@@ -294,8 +293,7 @@ def generate_jpeg_projection(
         if vol.ndim == 3:
             normalized, _ = projection_three_view(vol)
         else:
-            normalized = normalize_to_uint8(vol, method="percentile",
-                                            p_low=1, p_high=99.5)
+            normalized = normalize_to_uint8(vol, method="percentile", p_low=1, p_high=99.5)
 
         pil_image = Image.fromarray(normalized)
 
@@ -351,13 +349,13 @@ def load_volume(path: Path) -> np.ndarray:
         z_depth, height, width = vol.shape
         # Extract View A (left half) if dual-view format
         if width > height * 2:
-            vol = vol[:, :, :width // 2]
+            vol = vol[:, :, : width // 2]
     return vol
 
 
 def compute_crop_bounds(
     volume: np.ndarray, padding: int = 20, sigma_mult: float = 3.5
-) -> Tuple[int, int, int, int]:
+) -> tuple[int, int, int, int]:
     """Compute crop bounds for 3D volume using center-of-mass of bright pixels.
 
     Parameters
@@ -392,9 +390,7 @@ def compute_crop_bounds(
     return (y_min, y_max, x_min, x_max)
 
 
-def apply_crop_bounds(
-    volume: np.ndarray, bounds: Tuple[int, int, int, int]
-) -> np.ndarray:
+def apply_crop_bounds(volume: np.ndarray, bounds: tuple[int, int, int, int]) -> np.ndarray:
     """Apply pre-computed crop bounds to a volume.
 
     Parameters
@@ -419,8 +415,8 @@ def apply_crop_bounds(
 
 def projection_three_view(
     volume: np.ndarray,
-    voxel_size: Tuple[float, float, float] = (1.0, 0.1625, 0.1625),
-) -> Tuple[np.ndarray, str]:
+    voxel_size: tuple[float, float, float] = (1.0, 0.1625, 0.1625),
+) -> tuple[np.ndarray, str]:
     """Generate three orthogonal views layout from a 3D volume.
 
     Views are scaled to be physically isometric based on voxel dimensions.
@@ -495,9 +491,7 @@ def projection_three_view(
     total_width = top_row.shape[1]
 
     if xz_scaled.shape[1] < total_width:
-        pad = np.zeros(
-            (xz_scaled.shape[0], total_width - xz_scaled.shape[1]), dtype=np.uint8
-        )
+        pad = np.zeros((xz_scaled.shape[0], total_width - xz_scaled.shape[1]), dtype=np.uint8)
         bottom_row = np.concatenate([xz_scaled, pad], axis=1)
     else:
         bottom_row = xz_scaled[:, :total_width]
@@ -507,9 +501,7 @@ def projection_three_view(
     return combined, "Three-view: [XY|YZ] top, [XZ] bottom"
 
 
-def _euler_to_rotation_matrix(
-    rx: float, ry: float, rz: float
-) -> np.ndarray:
+def _euler_to_rotation_matrix(rx: float, ry: float, rz: float) -> np.ndarray:
     """Convert Euler angles (degrees) to a 3x3 rotation matrix.
 
     Matches BVV's sequential rotation order: Rz * Ry * Rx applied from the
@@ -529,11 +521,11 @@ def _euler_to_rotation_matrix(
 
 def clip_volume(
     volume: np.ndarray,
-    z_range: Optional[Tuple[float, float]] = None,
-    y_range: Optional[Tuple[float, float]] = None,
-    x_range: Optional[Tuple[float, float]] = None,
-    center: Optional[Tuple[float, float, float]] = None,
-    rotation: Optional[Tuple[float, float, float]] = None,
+    z_range: tuple[float, float] | None = None,
+    y_range: tuple[float, float] | None = None,
+    x_range: tuple[float, float] | None = None,
+    center: tuple[float, float, float] | None = None,
+    rotation: tuple[float, float, float] | None = None,
 ) -> np.ndarray:
     """Clip a 3D volume using an arbitrarily-oriented 3D box.
 
@@ -643,11 +635,11 @@ def _frac_to_abs(frac_range, dim_size):
 
 def clip_and_project(
     volume: np.ndarray,
-    z_range: Optional[Tuple[float, float]] = None,
-    y_range: Optional[Tuple[float, float]] = None,
-    x_range: Optional[Tuple[float, float]] = None,
-    center: Optional[Tuple[float, float, float]] = None,
-    rotation: Optional[Tuple[float, float, float]] = None,
+    z_range: tuple[float, float] | None = None,
+    y_range: tuple[float, float] | None = None,
+    x_range: tuple[float, float] | None = None,
+    center: tuple[float, float, float] | None = None,
+    rotation: tuple[float, float, float] | None = None,
     projection: str = "max",
     axis: int = 0,
     max_dimension: int = 800,
@@ -701,7 +693,7 @@ def render_volume_view(
     rotation_x: float = 0,
     rotation_y: float = 0,
     threshold: float = 0.2,
-    voxel_size: Tuple[float, float, float] = (1.0, 0.1625, 0.1625),
+    voxel_size: tuple[float, float, float] = (1.0, 0.1625, 0.1625),
 ) -> str:
     """Render a 3D volume from a specific viewing angle using alpha compositing.
 
diff --git a/gently/core/log_bridge.py b/gently/core/log_bridge.py
index d8d7e69f..c0b98836 100644
--- a/gently/core/log_bridge.py
+++ b/gently/core/log_bridge.py
@@ -27,7 +27,7 @@
 import logging
 import os
 import threading
-from typing import Iterable, Optional, Sequence
+from collections.abc import Iterable, Sequence
 
 from .event_bus import EventBus, EventType, get_event_bus
 
@@ -37,18 +37,26 @@
 # Loggers we never want on the Events page — they emit at the wrong layer
 # (their own log lines describe bus dispatch / events page WebSocket frames)
 # so republishing them would create feedback or infinite churn.
-_NEVER_BRIDGE = frozenset({
-    "gently.core.event_bus",
-    "gently.core.log_bridge",
-})
+_NEVER_BRIDGE = frozenset(
+    {
+        "gently.core.event_bus",
+        "gently.core.log_bridge",
+    }
+)
 
 # Loggers that count as "third-party noise" — silenced by default, can be
 # opted in with GENTLY_LOG_BUS_INCLUDE_THIRDPARTY=1.
 _THIRDPARTY_DEFAULTS: Sequence[str] = (
-    "uvicorn", "uvicorn.error", "uvicorn.access",
-    "aiohttp", "aiohttp.access",
-    "anthropic", "httpx", "httpcore",
-    "bluesky", "bluesky.RE.state",
+    "uvicorn",
+    "uvicorn.error",
+    "uvicorn.access",
+    "aiohttp",
+    "aiohttp.access",
+    "anthropic",
+    "httpx",
+    "httpcore",
+    "bluesky",
+    "bluesky.RE.state",
 )
 
 
@@ -117,12 +125,12 @@ def emit(self, record: logging.LogRecord) -> None:
 
 
 def configure_log_bridge(
-    bus: Optional[EventBus] = None,
+    bus: EventBus | None = None,
     *,
-    loggers: Optional[Iterable[str]] = None,
-    level: Optional[str] = None,
-    include_thirdparty: Optional[bool] = None,
-) -> Optional[LogToBusHandler]:
+    loggers: Iterable[str] | None = None,
+    level: str | None = None,
+    include_thirdparty: bool | None = None,
+) -> LogToBusHandler | None:
     """Attach a LogToBusHandler to the requested loggers.
 
     Returns the installed handler (or None if the bridge is disabled).
@@ -170,6 +178,8 @@ def configure_log_bridge(
         # become a LOG_RECORD event.
         logger.info(
             "Log bridge active: level=%s, loggers=%s, include_thirdparty=%s",
-            logging.getLevelName(level_int), attached, include_thirdparty,
+            logging.getLevelName(level_int),
+            attached,
+            include_thirdparty,
         )
     return handler
diff --git a/gently/core/service.py b/gently/core/service.py
index a4bd6bc2..21876ee9 100644
--- a/gently/core/service.py
+++ b/gently/core/service.py
@@ -10,22 +10,22 @@
 
 import asyncio
 import logging
-import time
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum, auto
-from typing import Any, Callable, Dict, List, Optional, Type
+from typing import Any
 
 import aiohttp
 
-from .event_bus import EventType, get_event_bus, Event
+from .event_bus import EventType, get_event_bus
 
 logger = logging.getLogger(__name__)
 
 
 class ServiceState(Enum):
     """Service lifecycle states"""
+
     CREATED = auto()
     STARTING = auto()
     RUNNING = auto()
@@ -37,25 +37,26 @@ class ServiceState(Enum):
 @dataclass
 class ServiceInfo:
     """Information about a registered service"""
+
     name: str
     service_type: str
     host: str = "localhost"
-    port: Optional[int] = None
+    port: int | None = None
     state: ServiceState = ServiceState.CREATED
-    started_at: Optional[datetime] = None
-    metadata: Dict[str, Any] = field(default_factory=dict)
-    health_check_url: Optional[str] = None
+    started_at: datetime | None = None
+    metadata: dict[str, Any] = field(default_factory=dict)
+    health_check_url: str | None = None
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         return {
-            'name': self.name,
-            'service_type': self.service_type,
-            'host': self.host,
-            'port': self.port,
-            'state': self.state.name,
-            'started_at': self.started_at.isoformat() if self.started_at else None,
-            'metadata': self.metadata,
-            'health_check_url': self.health_check_url,
+            "name": self.name,
+            "service_type": self.service_type,
+            "host": self.host,
+            "port": self.port,
+            "state": self.state.name,
+            "started_at": self.started_at.isoformat() if self.started_at else None,
+            "metadata": self.metadata,
+            "health_check_url": self.health_check_url,
         }
 
 
@@ -74,16 +75,16 @@ def __init__(
         name: str,
         service_type: str = "generic",
         host: str = "localhost",
-        port: Optional[int] = None,
+        port: int | None = None,
     ):
         self.name = name
         self.service_type = service_type
         self.host = host
         self.port = port
         self._state = ServiceState.CREATED
-        self._started_at: Optional[datetime] = None
+        self._started_at: datetime | None = None
         self._event_bus = get_event_bus()
-        self._metadata: Dict[str, Any] = {}
+        self._metadata: dict[str, Any] = {}
 
     @property
     def state(self) -> ServiceState:
@@ -108,18 +109,18 @@ async def start(self):
             return
 
         self._state = ServiceState.STARTING
-        self._emit_event(EventType.STATUS_CHANGED, {'state': 'starting'})
+        self._emit_event(EventType.STATUS_CHANGED, {"state": "starting"})
 
         try:
             await self.on_start()
             self._state = ServiceState.RUNNING
             self._started_at = datetime.now()
-            self._emit_event(EventType.STATUS_CHANGED, {'state': 'running'})
+            self._emit_event(EventType.STATUS_CHANGED, {"state": "running"})
             logger.info(f"Service {self.name} started")
 
         except Exception as e:
             self._state = ServiceState.ERROR
-            self._emit_event(EventType.ERROR_OCCURRED, {'error': str(e)})
+            self._emit_event(EventType.ERROR_OCCURRED, {"error": str(e)})
             logger.error(f"Service {self.name} failed to start: {e}")
             raise
 
@@ -129,27 +130,26 @@ async def stop(self):
             return
 
         self._state = ServiceState.STOPPING
-        self._emit_event(EventType.STATUS_CHANGED, {'state': 'stopping'})
+        self._emit_event(EventType.STATUS_CHANGED, {"state": "stopping"})
 
         try:
             await self.on_stop()
             self._state = ServiceState.STOPPED
-            self._emit_event(EventType.STATUS_CHANGED, {'state': 'stopped'})
+            self._emit_event(EventType.STATUS_CHANGED, {"state": "stopped"})
             logger.info(f"Service {self.name} stopped")
 
         except Exception as e:
             self._state = ServiceState.ERROR
             logger.error(f"Service {self.name} failed to stop cleanly: {e}")
 
-    async def health_check(self) -> Dict:
+    async def health_check(self) -> dict:
         """Check service health"""
         return {
-            'name': self.name,
-            'state': self._state.name,
-            'healthy': self._state == ServiceState.RUNNING,
-            'uptime_seconds': (
-                (datetime.now() - self._started_at).total_seconds()
-                if self._started_at else 0
+            "name": self.name,
+            "state": self._state.name,
+            "healthy": self._state == ServiceState.RUNNING,
+            "uptime_seconds": (
+                (datetime.now() - self._started_at).total_seconds() if self._started_at else 0
             ),
         }
 
@@ -163,11 +163,11 @@ async def on_stop(self):
         """Called when service stops - implement in subclass"""
         pass
 
-    def _emit_event(self, event_type: EventType, data: Dict):
+    def _emit_event(self, event_type: EventType, data: dict):
         """Emit event on the bus"""
         self._event_bus.publish(
             event_type=event_type,
-            data={'service': self.name, **data},
+            data={"service": self.name, **data},
             source=f"service:{self.name}",
         )
 
@@ -183,8 +183,8 @@ class ServiceRegistry:
     """
 
     def __init__(self):
-        self._services: Dict[str, Service] = {}
-        self._service_info: Dict[str, ServiceInfo] = {}
+        self._services: dict[str, Service] = {}
+        self._service_info: dict[str, ServiceInfo] = {}
 
     def register(self, service: Service):
         """Register a service"""
@@ -205,20 +205,20 @@ def unregister(self, name: str):
             del self._service_info[name]
         logger.info(f"Unregistered service: {name}")
 
-    def get(self, name: str) -> Optional[Service]:
+    def get(self, name: str) -> Service | None:
         """Get service by name"""
         return self._services.get(name)
 
-    def get_info(self, name: str) -> Optional[ServiceInfo]:
+    def get_info(self, name: str) -> ServiceInfo | None:
         """Get service info by name"""
         if name in self._services:
             return self._services[name].info
         return self._service_info.get(name)
 
-    def find_by_type(self, service_type: str) -> List[ServiceInfo]:
+    def find_by_type(self, service_type: str) -> list[ServiceInfo]:
         """Find all services of a given type"""
         results = []
-        for name, service in self._services.items():
+        for _name, service in self._services.items():
             if service.service_type == service_type:
                 results.append(service.info)
         for name, info in self._service_info.items():
@@ -226,7 +226,7 @@ def find_by_type(self, service_type: str) -> List[ServiceInfo]:
                 results.append(info)
         return results
 
-    def list_all(self) -> List[ServiceInfo]:
+    def list_all(self) -> list[ServiceInfo]:
         """List all registered services"""
         seen = set()
         results = []
@@ -238,7 +238,7 @@ def list_all(self) -> List[ServiceInfo]:
                 results.append(info)
         return results
 
-    async def health_check_all(self) -> Dict[str, Dict]:
+    async def health_check_all(self) -> dict[str, dict]:
         """Check health of all services"""
         results = {}
         for name, service in self._services.items():
@@ -246,28 +246,28 @@ async def health_check_all(self) -> Dict[str, Dict]:
                 results[name] = await service.health_check()
             except Exception as e:
                 results[name] = {
-                    'name': name,
-                    'state': 'ERROR',
-                    'healthy': False,
-                    'error': str(e),
+                    "name": name,
+                    "state": "ERROR",
+                    "healthy": False,
+                    "error": str(e),
                 }
         return results
 
     async def start_all(self):
         """Start all registered services"""
-        for name, service in self._services.items():
+        for _name, service in self._services.items():
             if service.state == ServiceState.CREATED:
                 await service.start()
 
     async def stop_all(self):
         """Stop all registered services"""
-        for name, service in self._services.items():
+        for _name, service in self._services.items():
             if service.state == ServiceState.RUNNING:
                 await service.stop()
 
 
 # Global registry
-_global_registry: Optional[ServiceRegistry] = None
+_global_registry: ServiceRegistry | None = None
 
 
 def get_service_registry() -> ServiceRegistry:
@@ -288,6 +288,7 @@ def set_service_registry(registry: ServiceRegistry):
 # Service Client for Communication
 # =============================================================================
 
+
 class ServiceClient:
     """
     Unified client for communicating with services
@@ -298,9 +299,9 @@ class ServiceClient:
     - Protocol abstraction (HTTP)
     """
 
-    def __init__(self, registry: Optional[ServiceRegistry] = None):
+    def __init__(self, registry: ServiceRegistry | None = None):
         self._registry = registry or get_service_registry()
-        self._connections: Dict[str, Any] = {}
+        self._connections: dict[str, Any] = {}
 
     async def connect(self, service_name: str) -> Any:
         """
@@ -336,7 +337,7 @@ async def disconnect(self, service_name: str):
             conn = self._connections.pop(service_name)
             if isinstance(conn, dict) and "session" in conn:
                 await conn["session"].close()
-            elif hasattr(conn, 'close'):
+            elif hasattr(conn, "close"):
                 if asyncio.iscoroutinefunction(conn.close):
                     await conn.close()
                 else:
@@ -347,13 +348,7 @@ async def disconnect_all(self):
         for name in list(self._connections.keys()):
             await self.disconnect(name)
 
-    async def call(
-        self,
-        service_name: str,
-        method: str,
-        *args,
-        **kwargs
-    ) -> Any:
+    async def call(self, service_name: str, method: str, *args, **kwargs) -> Any:
         """
         Call a method on a service
 
diff --git a/gently/core/store.py b/gently/core/store.py
index 1f347270..e070d734 100644
--- a/gently/core/store.py
+++ b/gently/core/store.py
@@ -31,19 +31,23 @@
 
 import json
 import logging
-import os
 import shutil
 import sqlite3
 from contextlib import contextmanager
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import numpy as np
 
 from .store_types import (
-    SessionInfo, EmbryoInfo, VolumeInfo, ProjectionInfo,
-    PerceptionRunInfo, PredictionInfo, GroundTruthEntry, StoreStats,
+    EmbryoInfo,
+    GroundTruthEntry,
+    PredictionInfo,
+    ProjectionInfo,
+    SessionInfo,
+    StoreStats,
+    VolumeInfo,
 )
 
 logger = logging.getLogger(__name__)
@@ -194,6 +198,7 @@
 # GentlyStore
 # ---------------------------------------------------------------------------
 
+
 class GentlyStore:
     """One class for all Gently storage. Owns one SQLite DB + one directory tree."""
 
@@ -271,8 +276,13 @@ def _abs_path(self, rel_path: str) -> Path:
     # Sessions
     # ==================================================================
 
-    def create_session(self, session_id: str, name: str = None,
-                       description: str = None, metadata: dict = None) -> str:
+    def create_session(
+        self,
+        session_id: str,
+        name: str = None,
+        description: str = None,
+        metadata: dict = None,
+    ) -> str:
         """Create a new session. Returns session_id."""
         now = self._now()
         with self._tx():
@@ -280,13 +290,19 @@ def create_session(self, session_id: str, name: str = None,
                 "INSERT OR IGNORE INTO sessions "
                 "(session_id, name, description, created_at, last_active, metadata) "
                 "VALUES (?, ?, ?, ?, ?, ?)",
-                (session_id, name, description, now, now,
-                 json.dumps(metadata) if metadata else None),
+                (
+                    session_id,
+                    name,
+                    description,
+                    now,
+                    now,
+                    json.dumps(metadata) if metadata else None,
+                ),
             )
         logger.info(f"Created session {session_id}")
         return session_id
 
-    def get_session(self, session_id: str) -> Optional[SessionInfo]:
+    def get_session(self, session_id: str) -> SessionInfo | None:
         """Return session row as dict, or None."""
         row = self._conn.execute(
             "SELECT * FROM sessions WHERE session_id = ?", (session_id,)
@@ -297,11 +313,9 @@ def get_session(self, session_id: str) -> Optional[SessionInfo]:
         self._parse_json_field(d, "metadata")
         return d
 
-    def list_sessions(self) -> List[SessionInfo]:
+    def list_sessions(self) -> list[SessionInfo]:
         """Return all sessions ordered by last_active descending."""
-        rows = self._conn.execute(
-            "SELECT * FROM sessions ORDER BY last_active DESC"
-        ).fetchall()
+        rows = self._conn.execute("SELECT * FROM sessions ORDER BY last_active DESC").fetchall()
         result = []
         for row in rows:
             d = dict(row)
@@ -325,12 +339,12 @@ def save_session_snapshot(self, session_id: str, snapshot: dict):
             json.dump(snapshot, f, indent=2, ensure_ascii=False, default=str)
         self.touch_session(session_id)
 
-    def load_session_snapshot(self, session_id: str) -> Optional[dict]:
+    def load_session_snapshot(self, session_id: str) -> dict | None:
         """Load session snapshot JSON. Returns None if missing."""
         path = self.root / "sessions" / f"{session_id}.json"
         if not path.exists():
             return None
-        with open(path, "r", encoding="utf-8") as f:
+        with open(path, encoding="utf-8") as f:
             return json.load(f)
 
     # ==================================================================
@@ -362,11 +376,19 @@ def register_embryo(
                 "  position_x = COALESCE(excluded.position_x, embryos.position_x), "
                 "  position_y = COALESCE(excluded.position_y, embryos.position_y), "
                 "  calibration = COALESCE(excluded.calibration, embryos.calibration)",
-                (embryo_id, session_id, embryo_uid, nickname,
-                 position_x, position_y, cal_json, now),
+                (
+                    embryo_id,
+                    session_id,
+                    embryo_uid,
+                    nickname,
+                    position_x,
+                    position_y,
+                    cal_json,
+                    now,
+                ),
             )
 
-    def get_embryo(self, session_id: str, embryo_id: str) -> Optional[EmbryoInfo]:
+    def get_embryo(self, session_id: str, embryo_id: str) -> EmbryoInfo | None:
         row = self._conn.execute(
             "SELECT * FROM embryos WHERE session_id = ? AND embryo_id = ?",
             (session_id, embryo_id),
@@ -377,7 +399,7 @@ def get_embryo(self, session_id: str, embryo_id: str) -> Optional[EmbryoInfo]:
         self._parse_json_field(d, "calibration")
         return d
 
-    def list_embryos(self, session_id: str) -> List[EmbryoInfo]:
+    def list_embryos(self, session_id: str) -> list[EmbryoInfo]:
         rows = self._conn.execute(
             "SELECT * FROM embryos WHERE session_id = ? ORDER BY embryo_id",
             (session_id,),
@@ -444,17 +466,23 @@ def put_volume(
 
         # Insert DB rows
         self._insert_volume_row(
-            session_id, embryo_id, timepoint, vol_path,
-            volume.shape, str(volume.dtype), metadata,
+            session_id,
+            embryo_id,
+            timepoint,
+            vol_path,
+            volume.shape,
+            str(volume.dtype),
+            metadata,
         )
         if proj_path is not None:
             self._insert_projection_row(
-                session_id, embryo_id, timepoint, proj_path,
+                session_id,
+                embryo_id,
+                timepoint,
+                proj_path,
             )
 
-        logger.debug(
-            f"put_volume: {session_id}/{embryo_id} t={timepoint} -> {vol_path}"
-        )
+        logger.debug(f"put_volume: {session_id}/{embryo_id} t={timepoint} -> {vol_path}")
         return vol_path
 
     def register_volume(
@@ -510,22 +538,29 @@ def register_volume(
             volume = volume_data
         else:
             from gently.core.imaging import load_volume
+
             volume = load_volume(canonical)
 
         proj_path = self._generate_projection(session_id, embryo_id, timepoint, volume)
 
         self._insert_volume_row(
-            session_id, embryo_id, timepoint, canonical,
-            volume.shape, str(volume.dtype), metadata,
+            session_id,
+            embryo_id,
+            timepoint,
+            canonical,
+            volume.shape,
+            str(volume.dtype),
+            metadata,
         )
         if proj_path is not None:
             self._insert_projection_row(
-                session_id, embryo_id, timepoint, proj_path,
+                session_id,
+                embryo_id,
+                timepoint,
+                proj_path,
             )
 
-        logger.debug(
-            f"register_volume: {incoming_path.name} -> {canonical}"
-        )
+        logger.debug(f"register_volume: {incoming_path.name} -> {canonical}")
         return canonical
 
     # ------------------------------------------------------------------
@@ -577,6 +612,7 @@ def register_snapshot(
 
         # Read shape for DB record
         import tifffile
+
         arr = tifffile.imread(str(canonical))
 
         with self._tx():
@@ -585,7 +621,8 @@ def register_snapshot(
                 "(session_id, source, file_path, width, height, metadata, captured_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?)",
                 (
-                    session_id, source,
+                    session_id,
+                    source,
                     self._rel_path(canonical),
                     arr.shape[-1] if arr.ndim >= 2 else None,
                     arr.shape[-2] if arr.ndim >= 2 else None,
@@ -596,14 +633,11 @@ def register_snapshot(
         logger.debug("register_snapshot: %s -> %s", incoming_path.name, canonical)
         return canonical
 
-    def list_snapshots(
-        self, session_id: str, source: str = None
-    ) -> List[Dict[str, Any]]:
+    def list_snapshots(self, session_id: str, source: str = None) -> list[dict[str, Any]]:
         """List snapshot records for a session, optionally filtered by source."""
         if source:
             rows = self._conn.execute(
-                "SELECT * FROM snapshots WHERE session_id = ? AND source = ? "
-                "ORDER BY captured_at",
+                "SELECT * FROM snapshots WHERE session_id = ? AND source = ? ORDER BY captured_at",
                 (session_id, source),
             ).fetchall()
         else:
@@ -611,10 +645,10 @@ def list_snapshots(
                 "SELECT * FROM snapshots WHERE session_id = ? ORDER BY captured_at",
                 (session_id,),
             ).fetchall()
-        cols = [d[0] for d in self._conn.execute(
-            "SELECT * FROM snapshots LIMIT 0"
-        ).description or []]
-        return [dict(zip(cols, row)) for row in rows]
+        cols = [
+            d[0] for d in self._conn.execute("SELECT * FROM snapshots LIMIT 0").description or []
+        ]
+        return [dict(zip(cols, row, strict=False)) for row in rows]
 
     # ------------------------------------------------------------------
     # Incoming cleanup
@@ -652,19 +686,16 @@ def cleanup_incoming(self, max_age_seconds: float = 300) -> int:
     # Volume retrieval
     # ------------------------------------------------------------------
 
-    def get_volume(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[np.ndarray]:
+    def get_volume(self, session_id: str, embryo_id: str, timepoint: int) -> np.ndarray | None:
         """Load a volume from disk. Returns None if not found."""
         path = self.get_volume_path(session_id, embryo_id, timepoint)
         if path is None or not path.exists():
             return None
         import tifffile
+
         return tifffile.imread(str(path))
 
-    def get_volume_path(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[Path]:
+    def get_volume_path(self, session_id: str, embryo_id: str, timepoint: int) -> Path | None:
         """Return the absolute path to a volume, or None."""
         row = self._conn.execute(
             "SELECT file_path FROM volumes "
@@ -675,14 +706,11 @@ def get_volume_path(
             return None
         return self._abs_path(row["file_path"])
 
-    def list_volumes(
-        self, session_id: str, embryo_id: str = None
-    ) -> List[VolumeInfo]:
+    def list_volumes(self, session_id: str, embryo_id: str = None) -> list[VolumeInfo]:
         """List volume metadata rows for a session (optionally filtered)."""
         if embryo_id:
             rows = self._conn.execute(
-                "SELECT * FROM volumes WHERE session_id = ? AND embryo_id = ? "
-                "ORDER BY timepoint",
+                "SELECT * FROM volumes WHERE session_id = ? AND embryo_id = ? ORDER BY timepoint",
                 (session_id, embryo_id),
             ).fetchall()
         else:
@@ -700,9 +728,7 @@ def list_volumes(
             result.append(d)
         return result
 
-    def get_acquisition_params(
-        self, session_id: str, embryo_id: str = None
-    ) -> Optional[dict]:
+    def get_acquisition_params(self, session_id: str, embryo_id: str = None) -> dict | None:
         """
         Get the acquisition parameters used in a session.
 
@@ -742,9 +768,12 @@ def get_acquisition_params(
     # -- internal helpers --
 
     def _generate_projection(
-        self, session_id: str, embryo_id: str, timepoint: int,
+        self,
+        session_id: str,
+        embryo_id: str,
+        timepoint: int,
         volume: np.ndarray,
-    ) -> Optional[Path]:
+    ) -> Path | None:
         """Generate JPEG projection file from volume data."""
         from .imaging import generate_jpeg_projection
 
@@ -753,8 +782,14 @@ def _generate_projection(
         return generate_jpeg_projection(volume, proj_path)
 
     def _insert_volume_row(
-        self, session_id, embryo_id, timepoint, vol_path,
-        shape, dtype, metadata,
+        self,
+        session_id,
+        embryo_id,
+        timepoint,
+        vol_path,
+        shape,
+        dtype,
+        metadata,
     ):
         now = self._now()
         with self._tx():
@@ -764,7 +799,9 @@ def _insert_volume_row(
                 " acquired_at, metadata) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
                 (
-                    session_id, embryo_id, timepoint,
+                    session_id,
+                    embryo_id,
+                    timepoint,
                     self._rel_path(vol_path),
                     json.dumps(list(shape)),
                     dtype,
@@ -774,7 +811,11 @@ def _insert_volume_row(
             )
 
     def _insert_projection_row(
-        self, session_id, embryo_id, timepoint, proj_path,
+        self,
+        session_id,
+        embryo_id,
+        timepoint,
+        proj_path,
     ):
         from PIL import Image as PILImage
 
@@ -794,9 +835,14 @@ def _insert_projection_row(
                 " size_kb, created_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
                 (
-                    session_id, embryo_id, timepoint,
+                    session_id,
+                    embryo_id,
+                    timepoint,
                     self._rel_path(proj_path),
-                    w, h, size_kb, now,
+                    w,
+                    h,
+                    size_kb,
+                    now,
                 ),
             )
 
@@ -804,9 +850,7 @@ def _insert_projection_row(
     # Projections
     # ==================================================================
 
-    def get_projection_path(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[Path]:
+    def get_projection_path(self, session_id: str, embryo_id: str, timepoint: int) -> Path | None:
         """Return absolute path to the JPEG projection, or None."""
         row = self._conn.execute(
             "SELECT file_path FROM projections "
@@ -817,9 +861,7 @@ def get_projection_path(
             return None
         return self._abs_path(row["file_path"])
 
-    def get_projection_b64(
-        self, session_id: str, embryo_id: str, timepoint: int
-    ) -> Optional[str]:
+    def get_projection_b64(self, session_id: str, embryo_id: str, timepoint: int) -> str | None:
         """Return base64-encoded JPEG projection, or None."""
         import base64
 
@@ -829,12 +871,9 @@ def get_projection_b64(
         with open(path, "rb") as f:
             return base64.b64encode(f.read()).decode("utf-8")
 
-    def list_projections(
-        self, session_id: str, embryo_id: str
-    ) -> List[ProjectionInfo]:
+    def list_projections(self, session_id: str, embryo_id: str) -> list[ProjectionInfo]:
         rows = self._conn.execute(
-            "SELECT * FROM projections "
-            "WHERE session_id = ? AND embryo_id = ? ORDER BY timepoint",
+            "SELECT * FROM projections WHERE session_id = ? AND embryo_id = ? ORDER BY timepoint",
             (session_id, embryo_id),
         ).fetchall()
         return [dict(r) for r in rows]
@@ -862,8 +901,12 @@ def create_perception_run(
                 " source, config, status, created_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?, 'running', ?)",
                 (
-                    session_id, name, method, model_name,
-                    trace_type, source,
+                    session_id,
+                    name,
+                    method,
+                    model_name,
+                    trace_type,
+                    source,
                     json.dumps(config) if config else None,
                     now,
                 ),
@@ -919,10 +962,17 @@ def store_prediction(
                 " created_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
                 (
-                    run_id, session_id, embryo_id, timepoint, predicted_stage,
-                    confidence, reasoning,
+                    run_id,
+                    session_id,
+                    embryo_id,
+                    timepoint,
+                    predicted_stage,
+                    confidence,
+                    reasoning,
                     1 if is_transitional else 0,
-                    ground_truth_stage, is_correct, execution_time_ms,
+                    ground_truth_stage,
+                    is_correct,
+                    execution_time_ms,
                     trace_file_rel,
                     json.dumps(observed_features) if observed_features else None,
                     now,
@@ -947,7 +997,7 @@ def get_predictions(
         session_id: str,
         embryo_id: str = None,
         run_id: int = None,
-    ) -> List[PredictionInfo]:
+    ) -> list[PredictionInfo]:
         """Query predictions with optional filters."""
         clauses = ["session_id = ?"]
         params: list = [session_id]
@@ -961,8 +1011,7 @@ def get_predictions(
 
         where = " AND ".join(clauses)
         rows = self._conn.execute(
-            f"SELECT * FROM predictions WHERE {where} "
-            "ORDER BY timepoint, prediction_id",
+            f"SELECT * FROM predictions WHERE {where} ORDER BY timepoint, prediction_id",
             params,
         ).fetchall()
 
@@ -1000,11 +1049,18 @@ def set_ground_truth(
                 "  end_timepoint = excluded.end_timepoint, "
                 "  annotator = excluded.annotator, "
                 "  notes = excluded.notes",
-                (session_id, embryo_id, stage, start_timepoint,
-                 end_timepoint, annotator, notes),
+                (
+                    session_id,
+                    embryo_id,
+                    stage,
+                    start_timepoint,
+                    end_timepoint,
+                    annotator,
+                    notes,
+                ),
             )
 
-    def get_ground_truth(self, session_id: str, embryo_id: str) -> List[GroundTruthEntry]:
+    def get_ground_truth(self, session_id: str, embryo_id: str) -> list[GroundTruthEntry]:
         rows = self._conn.execute(
             "SELECT * FROM ground_truth "
             "WHERE session_id = ? AND embryo_id = ? ORDER BY start_timepoint",
@@ -1018,8 +1074,15 @@ def get_ground_truth(self, session_id: str, embryo_id: str) -> List[GroundTruthE
 
     def stats(self) -> StoreStats:
         """Return counts and disk-usage summary."""
-        tables = ["sessions", "embryos", "volumes", "projections",
-                  "perception_runs", "predictions", "ground_truth"]
+        tables = [
+            "sessions",
+            "embryos",
+            "volumes",
+            "projections",
+            "perception_runs",
+            "predictions",
+            "ground_truth",
+        ]
         counts = {}
         for t in tables:
             counts[t] = self._conn.execute(f"SELECT COUNT(*) FROM {t}").fetchone()[0]
diff --git a/gently/core/store_types.py b/gently/core/store_types.py
index d3cc45d1..aa3eeaff 100644
--- a/gently/core/store_types.py
+++ b/gently/core/store_types.py
@@ -2,35 +2,36 @@
 
 Use these for type annotations on store methods and their callers.
 """
-from typing import List, Optional, TypedDict
+
+from typing import TypedDict
 
 
 class SessionInfo(TypedDict):
     session_id: str
-    name: Optional[str]
-    description: Optional[str]
+    name: str | None
+    description: str | None
     created_at: str
     last_active: str
-    metadata: Optional[dict]
+    metadata: dict | None
 
 
 class EmbryoInfo(TypedDict, total=False):
     embryo_id: str
     session_id: str
-    embryo_uid: Optional[str]
-    nickname: Optional[str]
+    embryo_uid: str | None
+    nickname: str | None
     # Coarse XY (µm) from bottom-camera detection or manual map placement.
     # Shape: {"x": float, "y": float}. Always present once the embryo exists.
-    position_coarse: Optional[dict]
+    position_coarse: dict | None
     # Fine XY (µm) from SPIM-objective alignment. None until that workflow
     # refines the coarse position. Shape: {"x": float, "y": float}.
-    position_fine: Optional[dict]
+    position_fine: dict | None
     # Legacy flat fields. Still accepted on write and surfaced on read for
     # callers that haven't migrated; new code should use position_coarse.
-    position_x: Optional[float]
-    position_y: Optional[float]
-    calibration: Optional[dict]
-    role: Optional[str]  # key into gently.harness.roles.REGISTRY
+    position_x: float | None
+    position_y: float | None
+    calibration: dict | None
+    role: str | None  # key into gently.harness.roles.REGISTRY
     created_at: str
 
 
@@ -39,10 +40,10 @@ class VolumeInfo(TypedDict):
     embryo_id: str
     timepoint: int
     file_path: str
-    shape: Optional[List[int]]
-    dtype: Optional[str]
+    shape: list[int] | None
+    dtype: str | None
     acquired_at: str
-    metadata: Optional[dict]
+    metadata: dict | None
 
 
 class ProjectionInfo(TypedDict):
@@ -50,25 +51,25 @@ class ProjectionInfo(TypedDict):
     embryo_id: str
     timepoint: int
     file_path: str
-    width: Optional[int]
-    height: Optional[int]
-    size_kb: Optional[float]
+    width: int | None
+    height: int | None
+    size_kb: float | None
     created_at: str
 
 
 class PerceptionRunInfo(TypedDict):
     run_id: int
-    session_id: Optional[str]
+    session_id: str | None
     name: str
     perception_method: str
-    model_name: Optional[str]
+    model_name: str | None
     trace_type: str
     source: str
-    config: Optional[dict]
+    config: dict | None
     status: str
     created_at: str
-    completed_at: Optional[str]
-    error_message: Optional[str]
+    completed_at: str | None
+    error_message: str | None
 
 
 class PredictionInfo(TypedDict):
@@ -78,14 +79,14 @@ class PredictionInfo(TypedDict):
     embryo_id: str
     timepoint: int
     predicted_stage: str
-    confidence: Optional[float]
-    reasoning: Optional[str]
+    confidence: float | None
+    reasoning: str | None
     is_transitional: int
-    ground_truth_stage: Optional[str]
-    is_correct: Optional[int]
-    execution_time_ms: Optional[float]
-    trace_file: Optional[str]
-    observed_features: Optional[dict]
+    ground_truth_stage: str | None
+    is_correct: int | None
+    execution_time_ms: float | None
+    trace_file: str | None
+    observed_features: dict | None
     created_at: str
 
 
@@ -95,9 +96,9 @@ class GroundTruthEntry(TypedDict):
     embryo_id: str
     stage: str
     start_timepoint: int
-    end_timepoint: Optional[int]
-    annotator: Optional[str]
-    notes: Optional[str]
+    end_timepoint: int | None
+    annotator: str | None
+    notes: str | None
     created_at: str
 
 
diff --git a/gently/dataset/__init__.py b/gently/dataset/__init__.py
index f69fff01..9c09aeb8 100644
--- a/gently/dataset/__init__.py
+++ b/gently/dataset/__init__.py
@@ -40,15 +40,15 @@
     stacklevel=2,
 )
 
-from .schema import (
-    init_database,
+from .aggregator import DatasetAggregator  # noqa: E402
+from .embryo_dataset import DatasetEmbryoEntry, EmbryoDataset, ImageData  # noqa: E402
+from .schema import (  # noqa: E402
+    DATABASE_VERSION,
     get_connection,
+    init_database,
     migrate_to_v2,
     migrate_to_v3,
-    DATABASE_VERSION,
 )
-from .aggregator import DatasetAggregator
-from .embryo_dataset import EmbryoDataset, DatasetEmbryoEntry, ImageData
 
 __all__ = [
     "init_database",
diff --git a/gently/dataset/aggregator.py b/gently/dataset/aggregator.py
index 3008ff78..c48a99c3 100644
--- a/gently/dataset/aggregator.py
+++ b/gently/dataset/aggregator.py
@@ -13,9 +13,9 @@
 import sqlite3
 from datetime import datetime
 from pathlib import Path
-from typing import Optional, Iterator, Dict, Any, List
+from typing import Any
 
-from .schema import init_database, get_connection, transaction
+from .schema import init_database
 
 logger = logging.getLogger(__name__)
 
@@ -40,18 +40,21 @@ class DatasetAggregator:
 
     def __init__(
         self,
-        db_path: Optional[Path] = None,
+        db_path: Path | None = None,
         sessions_dir: Path = Path("D:/gently/sessions"),
         data_dir: Path = Path("D:/gently/data"),
         images_dir: Path = Path("D:/gently/images"),
-        ground_truth_dir: Optional[Path] = None,
+        ground_truth_dir: Path | None = None,
     ):
         self.db_path = db_path or Path("D:/gently/dataset.db")
         self.sessions_dir = sessions_dir
         self.data_dir = data_dir
         self.images_dir = images_dir
-        self.ground_truth_dir = ground_truth_dir or Path(__file__).parent.parent.parent / "benchmarks" / "data" / "ground_truth"
-        self.conn: Optional[sqlite3.Connection] = None
+        self.ground_truth_dir = (
+            ground_truth_dir
+            or Path(__file__).parent.parent.parent / "benchmarks" / "data" / "ground_truth"
+        )
+        self.conn: sqlite3.Connection | None = None
 
     def connect(self) -> sqlite3.Connection:
         """Initialize and connect to the database."""
@@ -64,7 +67,7 @@ def close(self):
             self.conn.close()
             self.conn = None
 
-    def aggregate_all(self, incremental: bool = True) -> Dict[str, int]:
+    def aggregate_all(self, incremental: bool = True) -> dict[str, int]:
         """
         Run full aggregation from all sources.
 
@@ -119,7 +122,7 @@ def aggregate_all(self, incremental: bool = True) -> Dict[str, int]:
         logger.info(f"Aggregation complete: {stats}")
         return stats
 
-    def aggregate_sessions(self, since: Optional[datetime] = None) -> Dict[str, int]:
+    def aggregate_sessions(self, since: datetime | None = None) -> dict[str, int]:
         """
         Aggregate session data from JSON files.
 
@@ -149,7 +152,7 @@ def aggregate_sessions(self, since: Optional[datetime] = None) -> Dict[str, int]
                         continue
 
                 try:
-                    with open(session_file, 'r', encoding='utf-8') as f:
+                    with open(session_file, encoding="utf-8") as f:
                         data = json.load(f)
 
                     result = self._process_session(data)
@@ -159,7 +162,9 @@ def aggregate_sessions(self, since: Optional[datetime] = None) -> Dict[str, int]
                         stats["updated"] += 1
 
                     # Count embryos
-                    embryos = data.get("embryo_states", {}) or data.get("experiment_data", {}).get("embryos", {})
+                    embryos = data.get("embryo_states", {}) or data.get("experiment_data", {}).get(
+                        "embryos", {}
+                    )
                     stats["embryos"] += len(embryos)
 
                 except Exception as e:
@@ -169,7 +174,7 @@ def aggregate_sessions(self, since: Optional[datetime] = None) -> Dict[str, int]
                 log_id,
                 stats["added"] + stats["updated"],
                 stats["added"],
-                stats["updated"]
+                stats["updated"],
             )
 
         except Exception as e:
@@ -178,7 +183,7 @@ def aggregate_sessions(self, since: Optional[datetime] = None) -> Dict[str, int]
 
         return stats
 
-    def _process_session(self, data: Dict[str, Any]) -> str:
+    def _process_session(self, data: dict[str, Any]) -> str:
         """
         Insert or update a session record.
 
@@ -193,54 +198,72 @@ def _process_session(self, data: Dict[str, Any]) -> str:
 
         # Check if exists
         existing = self.conn.execute(
-            "SELECT session_id FROM sessions WHERE session_id = ?",
-            (session_id,)
+            "SELECT session_id FROM sessions WHERE session_id = ?", (session_id,)
         ).fetchone()
 
         # Extract metadata
         metadata = {
-            k: v for k, v in data.items()
-            if k not in ("session_id", "name", "description", "created_at",
-                         "last_active", "conversation", "system_prompt",
-                         "experiment_data", "embryo_states")
+            k: v
+            for k, v in data.items()
+            if k
+            not in (
+                "session_id",
+                "name",
+                "description",
+                "created_at",
+                "last_active",
+                "conversation",
+                "system_prompt",
+                "experiment_data",
+                "embryo_states",
+            )
         }
 
         if existing:
-            self.conn.execute("""
+            self.conn.execute(
+                """
                 UPDATE sessions SET
                     name = ?, description = ?, last_active = ?, metadata_json = ?
                 WHERE session_id = ?
-            """, (
-                data.get("name"),
-                data.get("description"),
-                data.get("last_active"),
-                json.dumps(metadata) if metadata else None,
-                session_id,
-            ))
+            """,
+                (
+                    data.get("name"),
+                    data.get("description"),
+                    data.get("last_active"),
+                    json.dumps(metadata) if metadata else None,
+                    session_id,
+                ),
+            )
             result = "updated"
         else:
-            self.conn.execute("""
-                INSERT INTO sessions (session_id, name, description, created_at, last_active, metadata_json)
+            self.conn.execute(
+                """
+                INSERT INTO sessions
+                (session_id, name, description, created_at, last_active, metadata_json)
                 VALUES (?, ?, ?, ?, ?, ?)
-            """, (
-                session_id,
-                data.get("name"),
-                data.get("description"),
-                data.get("created_at"),
-                data.get("last_active"),
-                json.dumps(metadata) if metadata else None,
-            ))
+            """,
+                (
+                    session_id,
+                    data.get("name"),
+                    data.get("description"),
+                    data.get("created_at"),
+                    data.get("last_active"),
+                    json.dumps(metadata) if metadata else None,
+                ),
+            )
             result = "added"
 
         # Process embryos
-        embryos = data.get("embryo_states", {}) or data.get("experiment_data", {}).get("embryos", {})
+        embryos = data.get("embryo_states", {}) or data.get("experiment_data", {}).get(
+            "embryos", {}
+        )
         for embryo_id, embryo_data in embryos.items():
             self._process_embryo(session_id, embryo_id, embryo_data)
 
         self.conn.commit()
         return result
 
-    def _process_embryo(self, session_id: str, embryo_id: str, data: Dict[str, Any]):
+    def _process_embryo(self, session_id: str, embryo_id: str, data: dict[str, Any]):
         """Insert or update an embryo record."""
         stage_pos = data.get("stage_position", {})
         calibration = data.get("calibration", {})
@@ -248,23 +271,26 @@ def _process_embryo(self, session_id: str, embryo_id: str, data: Dict[str, Any])
         # Get UID from data, or generate backward-compatible UID
         embryo_uid = data.get("uid") or f"{session_id}_{embryo_id}"
 
-        self.conn.execute("""
+        self.conn.execute(
+            """
             INSERT OR REPLACE INTO embryos
             (embryo_id, session_id, nickname, user_label,
              stage_position_x, stage_position_y, calibration_json, embryo_uid)
             VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-        """, (
-            embryo_id,
-            session_id,
-            data.get("nickname"),
-            data.get("user_label"),
-            stage_pos.get("x"),
-            stage_pos.get("y"),
-            json.dumps(calibration) if calibration else None,
-            embryo_uid,
-        ))
-
-    def aggregate_volumes(self, since: Optional[datetime] = None) -> Dict[str, int]:
+        """,
+            (
+                embryo_id,
+                session_id,
+                data.get("nickname"),
+                data.get("user_label"),
+                stage_pos.get("x"),
+                stage_pos.get("y"),
+                json.dumps(calibration) if calibration else None,
+                embryo_uid,
+            ),
+        )
+
+    def aggregate_volumes(self, since: datetime | None = None) -> dict[str, int]:
         """
         Aggregate volume data from data directory.
 
@@ -293,7 +319,7 @@ def aggregate_volumes(self, since: Optional[datetime] = None) -> Dict[str, int]:
                                 continue
 
                         try:
-                            with open(meta_file, 'r', encoding='utf-8') as f:
+                            with open(meta_file, encoding="utf-8") as f:
                                 data = json.load(f)
 
                             if self._process_volume(data, meta_file):
@@ -306,7 +332,9 @@ def aggregate_volumes(self, since: Optional[datetime] = None) -> Dict[str, int]:
                             stats["skipped"] += 1
 
                 self.conn.commit()
-                self._complete_aggregation_log(log_id, stats["added"] + stats["skipped"], stats["added"], 0)
+                self._complete_aggregation_log(
+                    log_id, stats["added"] + stats["skipped"], stats["added"], 0
+                )
 
             except Exception as e:
                 self._fail_aggregation_log(log_id, str(e))
@@ -339,7 +367,7 @@ def aggregate_volumes(self, since: Optional[datetime] = None) -> Dict[str, int]:
 
         return stats
 
-    def _process_volume(self, data: Dict[str, Any], meta_file: Path) -> bool:
+    def _process_volume(self, data: dict[str, Any], meta_file: Path) -> bool:
         """
         Process a volume from its metadata JSON.
 
@@ -350,9 +378,7 @@ def _process_volume(self, data: Dict[str, Any], meta_file: Path) -> bool:
             return False
 
         # Check if exists
-        existing = self.conn.execute(
-            "SELECT uid FROM volumes WHERE uid = ?", (uid,)
-        ).fetchone()
+        existing = self.conn.execute("SELECT uid FROM volumes WHERE uid = ?", (uid,)).fetchone()
         if existing:
             return False
 
@@ -370,26 +396,30 @@ def _process_volume(self, data: Dict[str, Any], meta_file: Path) -> bool:
         if session_id and embryo_id:
             result = self.conn.execute(
                 "SELECT embryo_uid FROM embryos WHERE session_id = ? AND embryo_id = ?",
-                (session_id, embryo_id)
+                (session_id, embryo_id),
             ).fetchone()
             embryo_uid = result[0] if result else f"{session_id}_{embryo_id}"
 
-        self.conn.execute("""
+        self.conn.execute(
+            """
             INSERT INTO volumes
-            (uid, session_id, embryo_id, timepoint, file_path, shape_json, dtype, timestamp, metadata_json, embryo_uid)
+            (uid, session_id, embryo_id, timepoint, file_path, shape_json, dtype,
+             timestamp, metadata_json, embryo_uid)
             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-        """, (
-            uid,
-            session_id,
-            embryo_id,
-            metadata.get("timepoint"),
-            str(tiff_path) if tiff_path.exists() else None,
-            json.dumps(data.get("shape")),
-            data.get("dtype"),
-            data.get("timestamp"),
-            json.dumps(metadata) if metadata else None,
-            embryo_uid,
-        ))
+        """,
+            (
+                uid,
+                session_id,
+                embryo_id,
+                metadata.get("timepoint"),
+                str(tiff_path) if tiff_path.exists() else None,
+                json.dumps(data.get("shape")),
+                data.get("dtype"),
+                data.get("timestamp"),
+                json.dumps(metadata) if metadata else None,
+                embryo_uid,
+            ),
+        )
 
         return True
 
@@ -403,9 +433,7 @@ def _process_volume_from_tiff(self, tif_path: Path, session_id: str) -> bool:
         uid = f"tiff_{tif_path.stem}"
 
         # Check if exists
-        existing = self.conn.execute(
-            "SELECT uid FROM volumes WHERE uid = ?", (uid,)
-        ).fetchone()
+        existing = self.conn.execute("SELECT uid FROM volumes WHERE uid = ?", (uid,)).fetchone()
         if existing:
             return False
 
@@ -422,7 +450,10 @@ def _process_volume_from_tiff(self, tif_path: Path, session_id: str) -> bool:
             try:
                 date_str = parts[2]
                 time_str = parts[3]
-                timestamp_str = f"{date_str[:4]}-{date_str[4:6]}-{date_str[6:8]}T{time_str[:2]}:{time_str[2:4]}:{time_str[4:6]}"
+                timestamp_str = (
+                    f"{date_str[:4]}-{date_str[4:6]}-{date_str[6:8]}"
+                    f"T{time_str[:2]}:{time_str[2:4]}:{time_str[4:6]}"
+                )
             except Exception:
                 timestamp_str = datetime.fromtimestamp(tif_path.stat().st_mtime).isoformat()
 
@@ -434,27 +465,30 @@ def _process_volume_from_tiff(self, tif_path: Path, session_id: str) -> bool:
         if session_id and embryo_id:
             result = self.conn.execute(
                 "SELECT embryo_uid FROM embryos WHERE session_id = ? AND embryo_id = ?",
-                (session_id, embryo_id)
+                (session_id, embryo_id),
             ).fetchone()
             embryo_uid = result[0] if result else f"{session_id}_{embryo_id}"
 
-        self.conn.execute("""
+        self.conn.execute(
+            """
             INSERT INTO volumes
             (uid, session_id, embryo_id, file_path, timestamp, metadata_json, embryo_uid)
             VALUES (?, ?, ?, ?, ?, ?, ?)
-        """, (
-            uid,
-            session_id,
-            embryo_id,
-            str(tif_path),
-            timestamp_str,
-            json.dumps({"source": "images_dir"}),
-            embryo_uid,
-        ))
+        """,
+            (
+                uid,
+                session_id,
+                embryo_id,
+                str(tif_path),
+                timestamp_str,
+                json.dumps({"source": "images_dir"}),
+                embryo_uid,
+            ),
+        )
 
         return True
 
-    def aggregate_images(self, since: Optional[datetime] = None) -> Dict[str, int]:
+    def aggregate_images(self, since: datetime | None = None) -> dict[str, int]:
         """
         Aggregate image projection data.
 
@@ -484,7 +518,7 @@ def aggregate_images(self, since: Optional[datetime] = None) -> Dict[str, int]:
                             continue
 
                     try:
-                        with open(meta_file, 'r', encoding='utf-8') as f:
+                        with open(meta_file, encoding="utf-8") as f:
                             data = json.load(f)
 
                         if self._process_image(data):
@@ -497,7 +531,9 @@ def aggregate_images(self, since: Optional[datetime] = None) -> Dict[str, int]:
                         stats["skipped"] += 1
 
             self.conn.commit()
-            self._complete_aggregation_log(log_id, stats["added"] + stats["skipped"], stats["added"], 0)
+            self._complete_aggregation_log(
+                log_id, stats["added"] + stats["skipped"], stats["added"], 0
+            )
 
         except Exception as e:
             self._fail_aggregation_log(log_id, str(e))
@@ -505,7 +541,7 @@ def aggregate_images(self, since: Optional[datetime] = None) -> Dict[str, int]:
 
         return stats
 
-    def _process_image(self, data: Dict[str, Any]) -> bool:
+    def _process_image(self, data: dict[str, Any]) -> bool:
         """
         Process an image from its metadata JSON.
 
@@ -516,9 +552,7 @@ def _process_image(self, data: Dict[str, Any]) -> bool:
             return False
 
         # Check if exists
-        existing = self.conn.execute(
-            "SELECT uid FROM images WHERE uid = ?", (uid,)
-        ).fetchone()
+        existing = self.conn.execute("SELECT uid FROM images WHERE uid = ?", (uid,)).fetchone()
         if existing:
             return False
 
@@ -531,33 +565,36 @@ def _process_image(self, data: Dict[str, Any]) -> bool:
         if session_id and embryo_id:
             result = self.conn.execute(
                 "SELECT embryo_uid FROM embryos WHERE session_id = ? AND embryo_id = ?",
-                (session_id, embryo_id)
+                (session_id, embryo_id),
             ).fetchone()
             embryo_uid = result[0] if result else f"{session_id}_{embryo_id}"
 
-        self.conn.execute("""
+        self.conn.execute(
+            """
             INSERT INTO images
             (uid, parent_uid, session_id, embryo_id, timepoint, projection_type,
              shape_json, dtype, b64_size_kb, timestamp, metadata_json, embryo_uid)
             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-        """, (
-            uid,
-            metadata.get("parent_uid"),
-            session_id,
-            embryo_id,
-            metadata.get("timepoint"),
-            metadata.get("projection_type"),
-            json.dumps(data.get("shape")),
-            data.get("dtype"),
-            metadata.get("b64_size_kb"),
-            data.get("timestamp"),
-            json.dumps(metadata) if metadata else None,
-            embryo_uid,
-        ))
+        """,
+            (
+                uid,
+                metadata.get("parent_uid"),
+                session_id,
+                embryo_id,
+                metadata.get("timepoint"),
+                metadata.get("projection_type"),
+                json.dumps(data.get("shape")),
+                data.get("dtype"),
+                metadata.get("b64_size_kb"),
+                data.get("timestamp"),
+                json.dumps(metadata) if metadata else None,
+                embryo_uid,
+            ),
+        )
 
         return True
 
-    def aggregate_ground_truth(self) -> Dict[str, int]:
+    def aggregate_ground_truth(self) -> dict[str, int]:
         """
         Import ground truth annotations from benchmark data.
 
@@ -586,7 +623,7 @@ def aggregate_ground_truth(self) -> Dict[str, int]:
         try:
             for gt_file in self.ground_truth_dir.glob("*.json"):
                 try:
-                    with open(gt_file, 'r', encoding='utf-8') as f:
+                    with open(gt_file, encoding="utf-8") as f:
                         data = json.load(f)
 
                     session_id = data.get("session_id")
@@ -597,31 +634,53 @@ def aggregate_ground_truth(self) -> Dict[str, int]:
                     for embryo_id, stages in transitions.items():
                         for stage, start_timepoint in stages.items():
                             # Check if exists
-                            existing = self.conn.execute("""
+                            existing = self.conn.execute(
+                                """
                                 SELECT id FROM ground_truth
                                 WHERE session_id = ? AND embryo_id = ? AND stage = ?
-                            """, (session_id, embryo_id, stage)).fetchone()
+                            """,
+                                (session_id, embryo_id, stage),
+                            ).fetchone()
 
                             if existing:
-                                self.conn.execute("""
+                                self.conn.execute(
+                                    """
                                     UPDATE ground_truth SET
                                         start_timepoint = ?, annotator = ?, notes = ?
                                     WHERE id = ?
-                                """, (start_timepoint, annotator, notes, existing[0]))
+                                """,
+                                    (start_timepoint, annotator, notes, existing[0]),
+                                )
                                 stats["updated"] += 1
                             else:
-                                self.conn.execute("""
+                                self.conn.execute(
+                                    """
                                     INSERT INTO ground_truth
-                                    (session_id, embryo_id, stage, start_timepoint, annotator, notes)
+                                    (session_id, embryo_id, stage, start_timepoint,
+                                     annotator, notes)
                                     VALUES (?, ?, ?, ?, ?, ?)
-                                """, (session_id, embryo_id, stage, start_timepoint, annotator, notes))
+                                """,
+                                    (
+                                        session_id,
+                                        embryo_id,
+                                        stage,
+                                        start_timepoint,
+                                        annotator,
+                                        notes,
+                                    ),
+                                )
                                 stats["added"] += 1
 
                 except Exception as e:
                     logger.error(f"Error processing ground truth {gt_file}: {e}")
 
             self.conn.commit()
-            self._complete_aggregation_log(log_id, stats["added"] + stats["updated"], stats["added"], stats["updated"])
+            self._complete_aggregation_log(
+                log_id,
+                stats["added"] + stats["updated"],
+                stats["added"],
+                stats["updated"],
+            )
 
         except Exception as e:
             self._fail_aggregation_log(log_id, str(e))
@@ -629,7 +688,7 @@ def aggregate_ground_truth(self) -> Dict[str, int]:
 
         return stats
 
-    def _get_last_run_time(self) -> Optional[datetime]:
+    def _get_last_run_time(self) -> datetime | None:
         """Get the timestamp of the last successful aggregation."""
         result = self.conn.execute("""
             SELECT MAX(completed_at) FROM aggregation_log
@@ -642,47 +701,56 @@ def _get_last_run_time(self) -> Optional[datetime]:
 
     def _set_last_run_time(self, timestamp: datetime):
         """Record the current aggregation time."""
-        self.conn.execute("""
+        self.conn.execute(
+            """
             INSERT OR REPLACE INTO metadata (key, value, updated_at)
             VALUES ('last_aggregation', ?, ?)
-        """, (timestamp.isoformat(), timestamp.isoformat()))
+        """,
+            (timestamp.isoformat(), timestamp.isoformat()),
+        )
         self.conn.commit()
 
     def _start_aggregation_log(self, source_type: str, source_path: str) -> int:
         """Start a new aggregation log entry."""
-        cursor = self.conn.execute("""
+        cursor = self.conn.execute(
+            """
             INSERT INTO aggregation_log (source_type, source_path, started_at, status)
             VALUES (?, ?, ?, 'running')
-        """, (source_type, source_path, datetime.now().isoformat()))
+        """,
+            (source_type, source_path, datetime.now().isoformat()),
+        )
         self.conn.commit()
         return cursor.lastrowid
 
     def _complete_aggregation_log(self, log_id: int, processed: int, added: int, updated: int):
         """Mark an aggregation log as completed."""
-        self.conn.execute("""
+        self.conn.execute(
+            """
             UPDATE aggregation_log SET
                 items_processed = ?, items_added = ?, items_updated = ?,
                 completed_at = ?, status = 'completed'
             WHERE id = ?
-        """, (processed, added, updated, datetime.now().isoformat(), log_id))
+        """,
+            (processed, added, updated, datetime.now().isoformat(), log_id),
+        )
         self.conn.commit()
 
     def _fail_aggregation_log(self, log_id: int, error_message: str):
         """Mark an aggregation log as failed."""
-        self.conn.execute("""
+        self.conn.execute(
+            """
             UPDATE aggregation_log SET
                 completed_at = ?, status = 'failed', error_message = ?
             WHERE id = ?
-        """, (datetime.now().isoformat(), error_message, log_id))
+        """,
+            (datetime.now().isoformat(), error_message, log_id),
+        )
         self.conn.commit()
 
 
 def get_stage_at_timepoint(
-    conn: sqlite3.Connection,
-    session_id: str,
-    embryo_id: str,
-    timepoint: int
-) -> Optional[str]:
+    conn: sqlite3.Connection, session_id: str, embryo_id: str, timepoint: int
+) -> str | None:
     """
     Get the ground truth stage at a specific timepoint.
 
@@ -705,11 +773,14 @@ def get_stage_at_timepoint(
     str or None
         Stage name or None if not found
     """
-    result = conn.execute("""
+    result = conn.execute(
+        """
         SELECT stage FROM ground_truth
         WHERE session_id = ? AND embryo_id = ? AND start_timepoint <= ?
         ORDER BY start_timepoint DESC
         LIMIT 1
-    """, (session_id, embryo_id, timepoint)).fetchone()
+    """,
+        (session_id, embryo_id, timepoint),
+    ).fetchone()
 
     return result[0] if result else None
diff --git a/gently/dataset/cli.py b/gently/dataset/cli.py
index 964354fb..e7385c01 100644
--- a/gently/dataset/cli.py
+++ b/gently/dataset/cli.py
@@ -13,11 +13,10 @@
 from pathlib import Path
 
 from .aggregator import DatasetAggregator
-from .schema import get_connection, get_database_stats, DEFAULT_DB_PATH
+from .schema import DEFAULT_DB_PATH, get_connection, get_database_stats
 
 logging.basicConfig(
-    level=logging.INFO,
-    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
 )
 logger = logging.getLogger(__name__)
 
@@ -74,7 +73,7 @@ def cmd_stats(args):
     print()
     print(f"Unique Embryo-Sessions: {stats.get('unique_embryo_sessions', 0):,}")
     print()
-    if stats.get('earliest_volume'):
+    if stats.get("earliest_volume"):
         print(f"Date Range: {stats['earliest_volume'][:10]} to {stats['latest_volume'][:10]}")
 
 
@@ -89,6 +88,7 @@ def cmd_serve(args):
 
     try:
         from .explorer_server import DatasetExplorer
+
         explorer = DatasetExplorer(db_path=db_path, port=args.port)
         explorer.run()
     except ImportError as e:
@@ -121,7 +121,7 @@ def cmd_query(args):
         print("-" * 80)
 
         # Print rows
-        for row in rows[:args.limit]:
+        for row in rows[: args.limit]:
             print("\t".join(str(v) if v is not None else "NULL" for v in row))
 
         if len(rows) > args.limit:
@@ -152,22 +152,17 @@ def main():
 
     # Run a SQL query
     python -m gently.dataset.cli query "SELECT * FROM sessions LIMIT 5"
-        """
+        """,
     )
 
-    parser.add_argument(
-        "--db",
-        help=f"Database path (default: {DEFAULT_DB_PATH})"
-    )
+    parser.add_argument("--db", help=f"Database path (default: {DEFAULT_DB_PATH})")
 
     subparsers = parser.add_subparsers(dest="command", help="Command to run")
 
     # Aggregate command
     agg_parser = subparsers.add_parser("aggregate", help="Aggregate data into database")
     agg_parser.add_argument(
-        "--full",
-        action="store_true",
-        help="Run full aggregation (not incremental)"
+        "--full", action="store_true", help="Run full aggregation (not incremental)"
     )
 
     # Stats command
@@ -176,20 +171,14 @@ def main():
     # Serve command
     serve_parser = subparsers.add_parser("serve", help="Start web explorer")
     serve_parser.add_argument(
-        "--port",
-        type=int,
-        default=8765,
-        help="Port to serve on (default: 8765)"
+        "--port", type=int, default=8765, help="Port to serve on (default: 8765)"
     )
 
     # Query command
     query_parser = subparsers.add_parser("query", help="Run SQL query")
     query_parser.add_argument("sql", help="SQL query to run")
     query_parser.add_argument(
-        "--limit",
-        type=int,
-        default=100,
-        help="Max rows to display (default: 100)"
+        "--limit", type=int, default=100, help="Max rows to display (default: 100)"
     )
 
     args = parser.parse_args()
diff --git a/gently/dataset/embryo_dataset.py b/gently/dataset/embryo_dataset.py
index df951710..b6cd3a66 100644
--- a/gently/dataset/embryo_dataset.py
+++ b/gently/dataset/embryo_dataset.py
@@ -25,18 +25,18 @@
             )
 """
 
-import base64
 import json
 import logging
 import sqlite3
+from collections.abc import Iterator
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Optional, Iterator, List, Dict, Any, Tuple
+from typing import Any, Optional
 
 import numpy as np
 
-from .schema import get_connection, DEFAULT_DB_PATH
+from .schema import DEFAULT_DB_PATH, get_connection
 
 logger = logging.getLogger(__name__)
 
@@ -44,40 +44,41 @@
 @dataclass
 class ImageData:
     """Data for a single image in the dataset."""
+
     uid: str
     embryo_id: str
     timepoint: int
     timestamp: str
 
     # Image data (loaded on demand)
-    _image_b64: Optional[str] = field(default=None, repr=False)
-    _volume_path: Optional[str] = None
-    _image_path: Optional[str] = None
+    _image_b64: str | None = field(default=None, repr=False)
+    _volume_path: str | None = None
+    _image_path: str | None = None
 
     # Ground truth (if available)
-    ground_truth_stage: Optional[str] = None
+    ground_truth_stage: str | None = None
 
     # Metadata
-    shape: Optional[Tuple[int, int]] = None
+    shape: tuple[int, int] | None = None
     projection_type: str = "max_z"
-    session_id: Optional[str] = None
+    session_id: str | None = None
 
     # Internal reference to dataset for lazy loading
     _dataset: Optional["EmbryoDataset"] = field(default=None, repr=False)
 
     @property
-    def image_b64(self) -> Optional[str]:
+    def image_b64(self) -> str | None:
         """Load and return base64 image data (lazy loading)."""
         if self._image_b64 is None and self._dataset:
             self._image_b64 = self._dataset._load_image_b64(self)
         return self._image_b64
 
     @property
-    def volume_path(self) -> Optional[str]:
+    def volume_path(self) -> str | None:
         """Path to the source volume TIFF."""
         return self._volume_path
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         """Convert to dictionary (without image data)."""
         return {
             "uid": self.uid,
@@ -95,20 +96,21 @@ def to_dict(self) -> Dict[str, Any]:
 @dataclass
 class DatasetEmbryoEntry:
     """Information about an embryo in the dataset."""
+
     embryo_id: str
-    session_id: Optional[str]
+    session_id: str | None
     num_images: int
     num_volumes: int
-    timepoint_range: Tuple[int, int]  # (min, max)
+    timepoint_range: tuple[int, int]  # (min, max)
     has_ground_truth: bool
-    ground_truth_stages: List[str] = field(default_factory=list)
+    ground_truth_stages: list[str] = field(default_factory=list)
 
     # Internal reference to dataset
     _dataset: Optional["EmbryoDataset"] = field(default=None, repr=False)
 
     def iter_images(
         self,
-        timepoint_range: Optional[Tuple[int, int]] = None,
+        timepoint_range: tuple[int, int] | None = None,
         load_image_data: bool = True,
     ) -> Iterator[ImageData]:
         """
@@ -158,7 +160,7 @@ class EmbryoDataset:
 
     def __init__(
         self,
-        db_path: Optional[Path] = None,
+        db_path: Path | None = None,
         data_dir: Path = Path("D:/gently/data"),
         gently_store=None,
     ):
@@ -170,8 +172,8 @@ def __init__(
             self.db_path = db_path or DEFAULT_DB_PATH
             self.data_dir = data_dir
             self._gently_store = None
-        self._conn: Optional[sqlite3.Connection] = None
-        self._is_gently_schema: Optional[bool] = None
+        self._conn: sqlite3.Connection | None = None
+        self._is_gently_schema: bool | None = None
 
     @classmethod
     def from_store(cls, store) -> "EmbryoDataset":
@@ -195,7 +197,7 @@ def is_gently_schema(self) -> bool:
             self._is_gently_schema = "uid" not in columns
         return self._is_gently_schema
 
-    def _resolve_db_path(self, db_path: Optional[str]) -> Optional[str]:
+    def _resolve_db_path(self, db_path: str | None) -> str | None:
         """Convert DB-stored file path to absolute path string."""
         if db_path is None:
             return None
@@ -215,8 +217,8 @@ def close(self):
 
     def iter_embryos(
         self,
-        session_id: Optional[str] = None,
-        has_ground_truth: Optional[bool] = None,
+        session_id: str | None = None,
+        has_ground_truth: bool | None = None,
         min_images: int = 1,
     ) -> Iterator[DatasetEmbryoEntry]:
         """
@@ -281,11 +283,14 @@ def iter_embryos(
             sess_id = row[1]
 
             # Check ground truth
-            gt_rows = self.conn.execute("""
+            gt_rows = self.conn.execute(
+                """
                 SELECT stage FROM ground_truth
                 WHERE embryo_id = ? AND (session_id = ? OR ? IS NULL)
                 ORDER BY start_timepoint
-            """, (embryo_id, sess_id, sess_id)).fetchall()
+            """,
+                (embryo_id, sess_id, sess_id),
+            ).fetchall()
 
             gt_stages = [r[0] for r in gt_rows]
             has_gt = len(gt_stages) > 0
@@ -310,8 +315,8 @@ def iter_embryos(
     def iter_images(
         self,
         embryo_id: str,
-        session_id: Optional[str] = None,
-        timepoint_range: Optional[Tuple[int, int]] = None,
+        session_id: str | None = None,
+        timepoint_range: tuple[int, int] | None = None,
         load_image_data: bool = True,
     ) -> Iterator[ImageData]:
         """
@@ -404,7 +409,7 @@ def iter_images(
             if row[8]:  # image_shape
                 try:
                     shape = tuple(json.loads(row[8]))
-                except:
+                except Exception:
                     pass
 
             img_data = ImageData(
@@ -425,8 +430,8 @@ def get_image(
         self,
         embryo_id: str,
         timepoint: int,
-        session_id: Optional[str] = None,
-    ) -> Optional[ImageData]:
+        session_id: str | None = None,
+    ) -> ImageData | None:
         """Get a single image by embryo and timepoint."""
         for img in self.iter_images(
             embryo_id=embryo_id,
@@ -440,18 +445,20 @@ def get_image_by_index(
         self,
         embryo_id: str,
         index: int,
-        session_id: Optional[str] = None,
-    ) -> Optional[ImageData]:
+        session_id: str | None = None,
+    ) -> ImageData | None:
         """Get a single image by sequential index (for volumes without timepoints)."""
-        for i, img in enumerate(self.iter_images(
-            embryo_id=embryo_id,
-            session_id=session_id,
-        )):
+        for i, img in enumerate(
+            self.iter_images(
+                embryo_id=embryo_id,
+                session_id=session_id,
+            )
+        ):
             if i == index:
                 return img
         return None
 
-    def get_image_by_uid(self, uid: str) -> Optional[ImageData]:
+    def get_image_by_uid(self, uid: str) -> ImageData | None:
         """Get a single image by its UID.
 
         For GentlyStore schema (no UIDs), returns None.
@@ -461,7 +468,8 @@ def get_image_by_uid(self, uid: str) -> Optional[ImageData]:
             return None
 
         # Legacy schema — query the volume directly
-        row = self.conn.execute("""
+        row = self.conn.execute(
+            """
             SELECT
                 v.uid as volume_uid,
                 v.embryo_id,
@@ -477,7 +485,9 @@ def get_image_by_uid(self, uid: str) -> Optional[ImageData]:
                 AND i.timepoint = v.timepoint
             WHERE v.uid = ? OR i.uid = ?
             LIMIT 1
-        """, (uid, uid)).fetchone()
+        """,
+            (uid, uid),
+        ).fetchone()
 
         if not row:
             return None
@@ -496,7 +506,7 @@ def get_image_by_uid(self, uid: str) -> Optional[ImageData]:
         if row[8]:
             try:
                 shape = tuple(json.loads(row[8]))
-            except:
+            except Exception:
                 pass
 
         return ImageData(
@@ -518,8 +528,8 @@ def get_image_by_uid(self, uid: str) -> Optional[ImageData]:
     def _get_ground_truth_map(
         self,
         embryo_id: str,
-        session_id: Optional[str] = None,
-    ) -> Dict[str, Tuple[int, int]]:
+        session_id: str | None = None,
+    ) -> dict[str, tuple[int, int]]:
         """
         Get ground truth stage → (start_tp, end_tp) mapping.
 
@@ -565,9 +575,9 @@ def set_ground_truth(
         embryo_id: str,
         stage: str,
         start_timepoint: int,
-        end_timepoint: Optional[int] = None,
-        annotator: Optional[str] = None,
-        notes: Optional[str] = None,
+        end_timepoint: int | None = None,
+        annotator: str | None = None,
+        notes: str | None = None,
     ):
         """
         Set or update a ground truth annotation.
@@ -589,11 +599,22 @@ def set_ground_truth(
         notes : str, optional
             Additional notes
         """
-        self.conn.execute("""
+        self.conn.execute(
+            """
             INSERT OR REPLACE INTO ground_truth
             (session_id, embryo_id, stage, start_timepoint, end_timepoint, annotator, notes)
             VALUES (?, ?, ?, ?, ?, ?, ?)
-        """, (session_id, embryo_id, stage, start_timepoint, end_timepoint, annotator, notes))
+        """,
+            (
+                session_id,
+                embryo_id,
+                stage,
+                start_timepoint,
+                end_timepoint,
+                annotator,
+                notes,
+            ),
+        )
         self.conn.commit()
         end_str = f"-{end_timepoint}" if end_timepoint else ""
         logger.info(f"Set ground truth: {embryo_id} {stage} @ t={start_timepoint}{end_str}")
@@ -602,7 +623,7 @@ def delete_ground_truth(
         self,
         session_id: str,
         embryo_id: str,
-        stage: Optional[str] = None,
+        stage: str | None = None,
     ):
         """
         Delete ground truth annotation(s).
@@ -617,29 +638,38 @@ def delete_ground_truth(
             If provided, delete only this stage. Otherwise delete all.
         """
         if stage:
-            self.conn.execute("""
+            self.conn.execute(
+                """
                 DELETE FROM ground_truth
                 WHERE session_id = ? AND embryo_id = ? AND stage = ?
-            """, (session_id, embryo_id, stage))
+            """,
+                (session_id, embryo_id, stage),
+            )
         else:
-            self.conn.execute("""
+            self.conn.execute(
+                """
                 DELETE FROM ground_truth
                 WHERE session_id = ? AND embryo_id = ?
-            """, (session_id, embryo_id))
+            """,
+                (session_id, embryo_id),
+            )
         self.conn.commit()
 
     def get_ground_truth(
         self,
         session_id: str,
         embryo_id: str,
-    ) -> List[Dict[str, Any]]:
+    ) -> list[dict[str, Any]]:
         """Get all ground truth entries for an embryo."""
-        rows = self.conn.execute("""
+        rows = self.conn.execute(
+            """
             SELECT stage, start_timepoint, end_timepoint, annotator, notes, created_at
             FROM ground_truth
             WHERE session_id = ? AND embryo_id = ?
             ORDER BY start_timepoint
-        """, (session_id, embryo_id)).fetchall()
+        """,
+            (session_id, embryo_id),
+        ).fetchall()
 
         return [
             {
@@ -661,12 +691,12 @@ def create_perception_run(
         self,
         name: str,
         perception_method: str,
-        model_name: Optional[str] = None,
-        config: Optional[Dict] = None,
-        description: Optional[str] = None,
-        trace_type: str = 'perception',
-        source: str = 'benchmark',
-        session_id: Optional[str] = None,
+        model_name: str | None = None,
+        config: dict | None = None,
+        description: str | None = None,
+        trace_type: str = "perception",
+        source: str = "benchmark",
+        session_id: str | None = None,
     ) -> int:
         """
         Create a new perception run record.
@@ -698,26 +728,43 @@ def create_perception_run(
         config_json = json.dumps(config) if config else None
 
         if self.is_gently_schema:
-            cursor = self.conn.execute("""
+            cursor = self.conn.execute(
+                """
                 INSERT INTO perception_runs
                 (session_id, name, perception_method, model_name, config,
                  status, trace_type, source, created_at)
                 VALUES (?, ?, ?, ?, ?, 'running', ?, ?, ?)
-            """, (
-                session_id, name, perception_method, model_name,
-                config_json, trace_type, source,
-                datetime.now().isoformat(),
-            ))
+            """,
+                (
+                    session_id,
+                    name,
+                    perception_method,
+                    model_name,
+                    config_json,
+                    trace_type,
+                    source,
+                    datetime.now().isoformat(),
+                ),
+            )
         else:
-            cursor = self.conn.execute("""
+            cursor = self.conn.execute(
+                """
                 INSERT INTO perception_runs
                 (name, perception_method, model_name, config_json, description, status,
                  trace_type, source, session_id)
                 VALUES (?, ?, ?, ?, ?, 'running', ?, ?, ?)
-            """, (
-                name, perception_method, model_name,
-                config_json, description, trace_type, source, session_id,
-            ))
+            """,
+                (
+                    name,
+                    perception_method,
+                    model_name,
+                    config_json,
+                    description,
+                    trace_type,
+                    source,
+                    session_id,
+                ),
+            )
         self.conn.commit()
         return cursor.lastrowid
 
@@ -727,15 +774,15 @@ def store_prediction(
         embryo_id: str,
         timepoint: int,
         predicted_stage: str,
-        confidence: Optional[float] = None,
-        reasoning: Optional[str] = None,
-        image_uid: Optional[str] = None,
-        session_id: Optional[str] = None,
+        confidence: float | None = None,
+        reasoning: str | None = None,
+        image_uid: str | None = None,
+        session_id: str | None = None,
         is_transitional: bool = False,
-        observed_features: Optional[Dict] = None,
-        reasoning_trace: Optional[Dict] = None,
-        execution_time_ms: Optional[float] = None,
-        trace_file_path: Optional[str] = None,
+        observed_features: dict | None = None,
+        reasoning_trace: dict | None = None,
+        execution_time_ms: float | None = None,
+        trace_file_path: str | None = None,
     ) -> int:
         """
         Store a perception prediction.
@@ -759,22 +806,32 @@ def store_prediction(
 
         if self.is_gently_schema:
             # GentlyStore schema: single predictions table with JSON blobs
-            cursor = self.conn.execute("""
+            cursor = self.conn.execute(
+                """
                 INSERT INTO predictions
                 (run_id, session_id, embryo_id, timepoint,
                  predicted_stage, confidence, reasoning, is_transitional,
                  ground_truth_stage, is_correct, execution_time_ms,
                  trace_file, observed_features, created_at)
                 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-            """, (
-                run_id, session_id, embryo_id, timepoint,
-                predicted_stage, confidence, reasoning,
-                1 if is_transitional else 0,
-                gt_stage, is_correct, execution_time_ms,
-                trace_file_path,
-                json.dumps(observed_features) if observed_features else None,
-                datetime.now().isoformat(),
-            ))
+            """,
+                (
+                    run_id,
+                    session_id,
+                    embryo_id,
+                    timepoint,
+                    predicted_stage,
+                    confidence,
+                    reasoning,
+                    1 if is_transitional else 0,
+                    gt_stage,
+                    is_correct,
+                    execution_time_ms,
+                    trace_file_path,
+                    json.dumps(observed_features) if observed_features else None,
+                    datetime.now().isoformat(),
+                ),
+            )
             prediction_id = cursor.lastrowid
         else:
             # Legacy schema: separate observed_features + reasoning_traces tables
@@ -787,56 +844,78 @@ def store_prediction(
                 else:
                     confidence_level = "LOW"
 
-            cursor = self.conn.execute("""
+            cursor = self.conn.execute(
+                """
                 INSERT INTO predictions
                 (perception_run_id, image_uid, session_id, embryo_id, timepoint,
                  predicted_stage, confidence, confidence_level, is_transitional,
                  reasoning, ground_truth_stage, is_correct, execution_time_ms)
                 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-            """, (
-                run_id, image_uid, session_id, embryo_id, timepoint,
-                predicted_stage, confidence, confidence_level,
-                1 if is_transitional else 0,
-                reasoning, gt_stage, is_correct, execution_time_ms,
-            ))
+            """,
+                (
+                    run_id,
+                    image_uid,
+                    session_id,
+                    embryo_id,
+                    timepoint,
+                    predicted_stage,
+                    confidence,
+                    confidence_level,
+                    1 if is_transitional else 0,
+                    reasoning,
+                    gt_stage,
+                    is_correct,
+                    execution_time_ms,
+                ),
+            )
 
             prediction_id = cursor.lastrowid
 
             # Store observed features if provided
             if observed_features:
-                self.conn.execute("""
+                self.conn.execute(
+                    """
                     INSERT INTO observed_features
                     (prediction_id, shape, curvature, shell_status, body_segments,
                      emergence, movement, texture, features_json)
                     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-                """, (
-                    prediction_id,
-                    observed_features.get("shape"),
-                    observed_features.get("curvature"),
-                    observed_features.get("shell_status"),
-                    observed_features.get("body_segments"),
-                    observed_features.get("emergence"),
-                    observed_features.get("movement"),
-                    observed_features.get("texture"),
-                    json.dumps(observed_features),
-                ))
+                """,
+                    (
+                        prediction_id,
+                        observed_features.get("shape"),
+                        observed_features.get("curvature"),
+                        observed_features.get("shell_status"),
+                        observed_features.get("body_segments"),
+                        observed_features.get("emergence"),
+                        observed_features.get("movement"),
+                        observed_features.get("texture"),
+                        json.dumps(observed_features),
+                    ),
+                )
 
             # Store reasoning trace if provided
             if reasoning_trace or trace_file_path:
-                self.conn.execute("""
+                self.conn.execute(
+                    """
                     INSERT INTO reasoning_traces
                     (prediction_id, contrastive_reasoning, steps_json,
                      tool_calls_json, tools_used_json, total_tool_calls, file_path)
                     VALUES (?, ?, ?, ?, ?, ?, ?)
-                """, (
-                    prediction_id,
-                    reasoning_trace.get("contrastive_reasoning") if reasoning_trace else None,
-                    json.dumps(reasoning_trace.get("steps", [])) if reasoning_trace else None,
-                    json.dumps(reasoning_trace.get("tool_calls", [])) if reasoning_trace else None,
-                    json.dumps(reasoning_trace.get("tools_used", [])) if reasoning_trace else None,
-                    reasoning_trace.get("total_tool_calls", 0) if reasoning_trace else 0,
-                    trace_file_path,
-                ))
+                """,
+                    (
+                        prediction_id,
+                        reasoning_trace.get("contrastive_reasoning") if reasoning_trace else None,
+                        json.dumps(reasoning_trace.get("steps", [])) if reasoning_trace else None,
+                        json.dumps(reasoning_trace.get("tool_calls", []))
+                        if reasoning_trace
+                        else None,
+                        json.dumps(reasoning_trace.get("tools_used", []))
+                        if reasoning_trace
+                        else None,
+                        reasoning_trace.get("total_tool_calls", 0) if reasoning_trace else 0,
+                        trace_file_path,
+                    ),
+                )
 
         self.conn.commit()
         return prediction_id
@@ -845,19 +924,23 @@ def complete_perception_run(
         self,
         run_id: int,
         status: str = "completed",
-        error_message: Optional[str] = None,
+        error_message: str | None = None,
     ):
         """Mark a perception run as completed."""
         now = datetime.now().isoformat()
 
         if self.is_gently_schema:
-            self.conn.execute("""
+            self.conn.execute(
+                """
                 UPDATE perception_runs SET
                     status = ?, completed_at = ?, error_message = ?
                 WHERE run_id = ?
-            """, (status, now, error_message, run_id))
+            """,
+                (status, now, error_message, run_id),
+            )
         else:
-            self.conn.execute("""
+            self.conn.execute(
+                """
                 UPDATE perception_runs SET
                     status = ?,
                     completed_at = ?,
@@ -866,14 +949,16 @@ def complete_perception_run(
                         SELECT COUNT(*) FROM predictions WHERE perception_run_id = ?
                     )
                 WHERE id = ?
-            """, (status, now, error_message, run_id, run_id))
+            """,
+                (status, now, error_message, run_id, run_id),
+            )
         self.conn.commit()
 
     # =========================================================================
     # Metrics Methods
     # =========================================================================
 
-    def compute_run_metrics(self, run_id: int) -> Dict[str, Any]:
+    def compute_run_metrics(self, run_id: int) -> dict[str, Any]:
         """
         Compute accuracy metrics for a perception run.
 
@@ -884,11 +969,14 @@ def compute_run_metrics(self, run_id: int) -> Dict[str, Any]:
         """
         # Get predictions with ground truth
         run_col = "run_id" if self.is_gently_schema else "perception_run_id"
-        rows = self.conn.execute(f"""
+        rows = self.conn.execute(
+            f"""
             SELECT predicted_stage, ground_truth_stage, is_correct, confidence
             FROM predictions
             WHERE {run_col} = ? AND ground_truth_stage IS NOT NULL
-        """, (run_id,)).fetchall()
+        """,
+            (run_id,),
+        ).fetchall()
 
         if not rows:
             return {"error": "No predictions with ground truth"}
@@ -938,7 +1026,7 @@ def compute_run_metrics(self, run_id: int) -> Dict[str, Any]:
     # Image Loading
     # =========================================================================
 
-    def _load_image_b64(self, img: ImageData) -> Optional[str]:
+    def _load_image_b64(self, img: ImageData) -> str | None:
         """
         Load base64 image data for an ImageData object.
 
@@ -957,9 +1045,8 @@ def _load_image_b64(self, img: ImageData) -> Optional[str]:
 
     def _load_projection_from_volume(self, volume_path: str) -> str:
         """Load volume and create max projection as base64 JPEG."""
+
         import tifffile
-        from PIL import Image
-        import io
 
         # Load volume
         volume = tifffile.imread(volume_path)
@@ -974,7 +1061,7 @@ def _load_projection_from_volume(self, volume_path: str) -> str:
             z_depth, height, width = volume.shape
             # Extract View A (left half) if dual-view format
             if width > height * 1.5:
-                volume = volume[:, :, :width // 2]
+                volume = volume[:, :, : width // 2]
             # Max projection
             projection = np.max(volume, axis=0)
         else:
@@ -982,10 +1069,11 @@ def _load_projection_from_volume(self, volume_path: str) -> str:
             # Extract View A if 2D dual-view
             height, width = projection.shape
             if width > height * 1.5:
-                projection = projection[:, :width // 2]
+                projection = projection[:, : width // 2]
 
         # Normalize and encode
-        from gently.core.imaging import normalize_to_uint8, image_to_base64
+        from gently.core.imaging import image_to_base64, normalize_to_uint8
+
         projection = normalize_to_uint8(projection, method="percentile", p_low=1, p_high=99.5)
         return image_to_base64(projection, format="JPEG", quality=85, max_dimension=1024)
 
@@ -993,7 +1081,7 @@ def _load_projection_from_volume(self, volume_path: str) -> str:
     # Query Methods
     # =========================================================================
 
-    def get_sessions(self) -> List[Dict[str, Any]]:
+    def get_sessions(self) -> list[dict[str, Any]]:
         """Get list of sessions with summary stats."""
         rows = self.conn.execute("""
             SELECT
@@ -1024,7 +1112,7 @@ def get_sessions(self) -> List[Dict[str, Any]]:
             for r in rows
         ]
 
-    def get_perception_runs(self) -> List[Dict[str, Any]]:
+    def get_perception_runs(self) -> list[dict[str, Any]]:
         """Get list of perception runs with metrics."""
         if self.is_gently_schema:
             # GentlyStore schema — inline the accuracy view
@@ -1062,9 +1150,9 @@ def get_traces_for_image(
         self,
         embryo_id: str,
         timepoint: int,
-        session_id: Optional[str] = None,
-        trace_type: Optional[str] = None,
-    ) -> List[Dict[str, Any]]:
+        session_id: str | None = None,
+        trace_type: str | None = None,
+    ) -> list[dict[str, Any]]:
         """
         Get all traces for a specific image (embryo + timepoint).
 
@@ -1172,8 +1260,8 @@ def get_traces_for_image(
     def get_runs_for_session(
         self,
         session_id: str,
-        trace_type: Optional[str] = None,
-    ) -> List[Dict[str, Any]]:
+        trace_type: str | None = None,
+    ) -> list[dict[str, Any]]:
         """
         Get all perception runs for a session.
 
@@ -1258,8 +1346,8 @@ def get_runs_for_session(
     def get_run_predictions(
         self,
         run_id: int,
-        embryo_id: Optional[str] = None,
-    ) -> List[Dict[str, Any]]:
+        embryo_id: str | None = None,
+    ) -> list[dict[str, Any]]:
         """
         Get all predictions for a run, optionally filtered by embryo.
 
@@ -1338,7 +1426,7 @@ def get_run_predictions(
     # Cross-Session UID Methods
     # =========================================================================
 
-    def get_embryo_by_uid(self, uid: str) -> List[Dict[str, Any]]:
+    def get_embryo_by_uid(self, uid: str) -> list[dict[str, Any]]:
         """
         Get all instances of an embryo across sessions by its UID.
 
@@ -1353,7 +1441,8 @@ def get_embryo_by_uid(self, uid: str) -> List[Dict[str, Any]]:
             All embryo instances matching this UID across different sessions
         """
         if self.is_gently_schema:
-            rows = self.conn.execute("""
+            rows = self.conn.execute(
+                """
                 SELECT
                     e.embryo_id,
                     e.session_id,
@@ -1376,9 +1465,12 @@ def get_embryo_by_uid(self, uid: str) -> List[Dict[str, Any]]:
                 LEFT JOIN sessions s ON e.session_id = s.session_id
                 WHERE e.embryo_uid = ?
                 ORDER BY e.created_at ASC
-            """, (uid,)).fetchall()
+            """,
+                (uid,),
+            ).fetchall()
         else:
-            rows = self.conn.execute("""
+            rows = self.conn.execute(
+                """
                 SELECT
                     e.embryo_id,
                     e.session_id,
@@ -1392,14 +1484,18 @@ def get_embryo_by_uid(self, uid: str) -> List[Dict[str, Any]]:
                     s.name as session_name,
                     s.created_at as session_created_at,
                     (SELECT COUNT(*) FROM volumes v
-                     WHERE v.embryo_uid = e.embryo_uid AND v.session_id = e.session_id) as volume_count,
+                     WHERE v.embryo_uid = e.embryo_uid
+                     AND v.session_id = e.session_id) as volume_count,
                     (SELECT COUNT(*) FROM images i
-                     WHERE i.embryo_uid = e.embryo_uid AND i.session_id = e.session_id) as image_count
+                     WHERE i.embryo_uid = e.embryo_uid
+                     AND i.session_id = e.session_id) as image_count
                 FROM embryos e
                 LEFT JOIN sessions s ON e.session_id = s.session_id
                 WHERE e.embryo_uid = ?
                 ORDER BY e.created_at ASC
-            """, (uid,)).fetchall()
+            """,
+                (uid,),
+            ).fetchall()
 
         return [
             {
@@ -1501,7 +1597,7 @@ def iter_images_by_uid(
             if row[8]:
                 try:
                     shape = tuple(json.loads(row[8]))
-                except:
+                except Exception:
                     pass
 
             img_data = ImageData(
@@ -1518,7 +1614,7 @@ def iter_images_by_uid(
 
             yield img_data
 
-    def get_embryos_with_multiple_sessions(self) -> List[Dict[str, Any]]:
+    def get_embryos_with_multiple_sessions(self) -> list[dict[str, Any]]:
         """
         Get embryos that appear in multiple sessions (imported).
 
@@ -1584,7 +1680,7 @@ def get_embryos_with_multiple_sessions(self) -> List[Dict[str, Any]]:
             for r in rows
         ]
 
-    def get_embryo_timeline_by_uid(self, uid: str) -> Dict[str, Any]:
+    def get_embryo_timeline_by_uid(self, uid: str) -> dict[str, Any]:
         """
         Get complete cross-session timeline for an embryo.
 
@@ -1611,7 +1707,8 @@ def get_embryo_timeline_by_uid(self, uid: str) -> Dict[str, Any]:
 
             # Get timepoint range and image count for this session
             if self.is_gently_schema:
-                stats = self.conn.execute("""
+                stats = self.conn.execute(
+                    """
                     SELECT
                         MIN(v.acquired_at) as first_timestamp,
                         MAX(v.acquired_at) as last_timestamp,
@@ -1622,9 +1719,12 @@ def get_embryo_timeline_by_uid(self, uid: str) -> Dict[str, Any]:
                     JOIN embryos e ON v.embryo_id = e.embryo_id
                         AND v.session_id = e.session_id
                     WHERE e.embryo_uid = ? AND v.session_id = ?
-                """, (uid, session_id)).fetchone()
+                """,
+                    (uid, session_id),
+                ).fetchone()
             else:
-                stats = self.conn.execute("""
+                stats = self.conn.execute(
+                    """
                     SELECT
                         MIN(v.timestamp) as first_timestamp,
                         MAX(v.timestamp) as last_timestamp,
@@ -1633,27 +1733,34 @@ def get_embryo_timeline_by_uid(self, uid: str) -> Dict[str, Any]:
                         MAX(v.timepoint) as max_timepoint
                     FROM volumes v
                     WHERE v.embryo_uid = ? AND v.session_id = ?
-                """, (uid, session_id)).fetchone()
+                """,
+                    (uid, session_id),
+                ).fetchone()
 
             # Get ground truth stages for this session
-            gt_rows = self.conn.execute("""
+            gt_rows = self.conn.execute(
+                """
                 SELECT stage, start_timepoint FROM ground_truth
                 WHERE embryo_id = ? AND session_id = ?
                 ORDER BY start_timepoint
-            """, (instance["embryo_id"], session_id)).fetchall()
-
-            timeline.append({
-                "session_id": session_id,
-                "session_name": instance["session_name"],
-                "embryo_id": instance["embryo_id"],
-                "first_timestamp": stats[0] if stats else None,
-                "last_timestamp": stats[1] if stats else None,
-                "volume_count": stats[2] if stats else 0,
-                "timepoint_range": (stats[3], stats[4]) if stats else (None, None),
-                "ground_truth_stages": [
-                    {"stage": gt[0], "start_timepoint": gt[1]} for gt in gt_rows
-                ],
-            })
+            """,
+                (instance["embryo_id"], session_id),
+            ).fetchall()
+
+            timeline.append(
+                {
+                    "session_id": session_id,
+                    "session_name": instance["session_name"],
+                    "embryo_id": instance["embryo_id"],
+                    "first_timestamp": stats[0] if stats else None,
+                    "last_timestamp": stats[1] if stats else None,
+                    "volume_count": stats[2] if stats else 0,
+                    "timepoint_range": (stats[3], stats[4]) if stats else (None, None),
+                    "ground_truth_stages": [
+                        {"stage": gt[0], "start_timepoint": gt[1]} for gt in gt_rows
+                    ],
+                }
+            )
 
         return {
             "embryo_uid": uid,
diff --git a/gently/dataset/explorer_server.py b/gently/dataset/explorer_server.py
index 254a44cf..510ddd42 100644
--- a/gently/dataset/explorer_server.py
+++ b/gently/dataset/explorer_server.py
@@ -12,32 +12,34 @@
 """
 
 import asyncio
-import logging
+import base64
 import json
+import logging
 from dataclasses import dataclass
-
-logger = logging.getLogger(__name__)
 from datetime import datetime
 from pathlib import Path
-from typing import Optional, List, Tuple, Dict
 
 import numpy as np
 from fastapi import FastAPI, HTTPException, Query, WebSocket, WebSocketDisconnect
-from fastapi.responses import HTMLResponse, JSONResponse, Response
+from fastapi.responses import HTMLResponse
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel
 
-from .schema import get_connection, get_database_stats, DEFAULT_DB_PATH
-from .embryo_dataset import EmbryoDataset
 from gently.core.imaging import (
-    normalize_to_uint8,
-    image_to_base64 as _image_to_base64,
-    load_volume,
-    compute_crop_bounds,
     apply_crop_bounds,
+    compute_crop_bounds,
+    load_volume,
+    normalize_to_uint8,
     projection_three_view,
 )
+from gently.core.imaging import (
+    image_to_base64 as _image_to_base64,
+)
+
+from .embryo_dataset import EmbryoDataset
+from .schema import DEFAULT_DB_PATH, get_connection, get_database_stats
 
+logger = logging.getLogger(__name__)
 # Lazy imports for explorer-specific projection functions
 tifffile = None
 PIL_Image = None
@@ -48,9 +50,11 @@ def ensure_projection_deps():
     global tifffile, PIL_Image
     if tifffile is None:
         import tifffile as _tifffile
+
         tifffile = _tifffile
     if PIL_Image is None:
         from PIL import Image as _Image
+
         PIL_Image = _Image
 
 
@@ -68,15 +72,25 @@ def find_outer_boundary(img: np.ndarray, percentile: float = 50) -> np.ndarray:
     """Find outer boundary of embryo by thresholding and extracting mask edge."""
     thresh = np.percentile(img, percentile)
     mask = img > thresh
-    padded = np.pad(mask, 1, mode='constant', constant_values=True)
-    eroded = (padded[:-2, :-2] & padded[:-2, 1:-1] & padded[:-2, 2:] &
-              padded[1:-1, :-2] & padded[1:-1, 1:-1] & padded[1:-1, 2:] &
-              padded[2:, :-2] & padded[2:, 1:-1] & padded[2:, 2:])
+    padded = np.pad(mask, 1, mode="constant", constant_values=True)
+    eroded = (
+        padded[:-2, :-2]
+        & padded[:-2, 1:-1]
+        & padded[:-2, 2:]
+        & padded[1:-1, :-2]
+        & padded[1:-1, 1:-1]
+        & padded[1:-1, 2:]
+        & padded[2:, :-2]
+        & padded[2:, 1:-1]
+        & padded[2:, 2:]
+    )
     boundary = (mask & ~eroded).astype(np.uint8) * 255
     return boundary
 
 
-def overlay_edges(img: np.ndarray, edges: np.ndarray, color: Tuple[int, int, int] = (255, 200, 0)) -> np.ndarray:
+def overlay_edges(
+    img: np.ndarray, edges: np.ndarray, color: tuple[int, int, int] = (255, 200, 0)
+) -> np.ndarray:
     """Overlay edge contours on image in specified color."""
     if img.ndim == 2:
         rgb = np.stack([img, img, img], axis=-1)
@@ -89,8 +103,8 @@ def overlay_edges(img: np.ndarray, edges: np.ndarray, color: Tuple[int, int, int
 
 def projection_dual_view(
     volume: np.ndarray,
-    voxel_size: Tuple[float, float, float] = (1.0, 0.1625, 0.1625),
-) -> Tuple[np.ndarray, str]:
+    voxel_size: tuple[float, float, float] = (1.0, 0.1625, 0.1625),
+) -> tuple[np.ndarray, str]:
     """Dual-view projection: TOP above, SIDE below with boundary overlay.
 
     voxel_size: (dz, dy, dx) in microns. Used to compute the physically
@@ -126,9 +140,9 @@ def projection_dual_view(
 
 def projection_depth_colored(
     volume: np.ndarray,
-    colormap: str = 'turbo',
-    voxel_size: Tuple[float, float, float] = (1.0, 0.1625, 0.1625),
-) -> Tuple[np.ndarray, str]:
+    colormap: str = "turbo",
+    voxel_size: tuple[float, float, float] = (1.0, 0.1625, 0.1625),
+) -> tuple[np.ndarray, str]:
     """Depth-colored max intensity projection.
 
     voxel_size: (dz, dy, dx) in microns. The side view is rescaled so the
@@ -142,8 +156,9 @@ def projection_depth_colored(
     dz, dy, dx = voxel_size
     try:
         import matplotlib.pyplot as plt
+
         cmap = plt.get_cmap(colormap)
-    except:
+    except Exception:
         cmap = None
     colored_volume = np.zeros((z_depth, height, width, 3), dtype=np.float32)
     for z in range(z_depth):
@@ -168,7 +183,7 @@ def projection_depth_colored(
     return combined, f"Z-depth colored MIP ({colormap}): TOP + SIDE"
 
 
-def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> Tuple[np.ndarray, str]:
+def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> tuple[np.ndarray, str]:
     """Montage of N representative z-slices."""
     if volume.ndim != 3:
         return normalize_image(volume), "2D input"
@@ -184,7 +199,7 @@ def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> Tuple[np.nd
         slices.append(np.zeros_like(slices[0]))
     rows = []
     for r in range(n_rows):
-        row_slices = slices[r * n_cols:(r + 1) * n_cols]
+        row_slices = slices[r * n_cols : (r + 1) * n_cols]
         sep = np.ones((height, 2), dtype=np.uint8) * 64
         row_with_sep = []
         for i, s in enumerate(row_slices):
@@ -198,10 +213,15 @@ def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> Tuple[np.nd
     return montage, f"Multi-slice montage ({n_slices} slices)"
 
 
-def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -0.5,
-                          threshold: float = 0.12, num_slices: int = 48,
-                          perspective: float = 0.4,
-                          voxel_size: Tuple[float, float, float] = (1.0, 0.1625, 0.1625)) -> np.ndarray:
+def render_volume_rotated(
+    volume: np.ndarray,
+    angle_y: float,
+    angle_x: float = -0.5,
+    threshold: float = 0.12,
+    num_slices: int = 48,
+    perspective: float = 0.4,
+    voxel_size: tuple[float, float, float] = (1.0, 0.1625, 0.1625),
+) -> np.ndarray:
     """
     Render volume from a rotated viewpoint with parallax and perspective.
 
@@ -281,23 +301,25 @@ def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -
         perspective_scale = 1.0 + (depth_after_rotation * perspective * 1.5 / z_scale)
         perspective_scale = np.clip(perspective_scale, 0.5, 1.5)
 
-        slice_data_list.append({
-            'z_idx': z_idx,
-            'shift_x': shift_x,
-            'shift_y': shift_y,
-            'depth': depth_after_rotation,
-            'scale': perspective_scale,
-        })
+        slice_data_list.append(
+            {
+                "z_idx": z_idx,
+                "shift_x": shift_x,
+                "shift_y": shift_y,
+                "depth": depth_after_rotation,
+                "scale": perspective_scale,
+            }
+        )
 
     # Sort by depth (back to front for proper alpha compositing)
-    slice_data_list.sort(key=lambda s: s['depth'])
+    slice_data_list.sort(key=lambda s: s["depth"])
 
     # Composite slices
     for slice_info in slice_data_list:
-        z_idx = slice_info['z_idx']
-        shift_x = slice_info['shift_x']
-        shift_y = slice_info['shift_y']
-        scale = slice_info['scale']
+        z_idx = slice_info["z_idx"]
+        shift_x = slice_info["shift_x"]
+        shift_y = slice_info["shift_y"]
+        scale = slice_info["scale"]
 
         # Get slice
         slice_img = vol[z_idx, :, :]
@@ -347,8 +369,8 @@ def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -
         # Alpha composite
         for c in range(3):
             result[dst_y_start:dst_y_end, dst_x_start:dst_x_end, c] = (
-                src_slice * src_alpha +
-                result[dst_y_start:dst_y_end, dst_x_start:dst_x_end, c] * (1 - src_alpha)
+                src_slice * src_alpha
+                + result[dst_y_start:dst_y_end, dst_x_start:dst_x_end, c] * (1 - src_alpha)
             )
 
     # Crop to content (remove empty margins)
@@ -374,8 +396,8 @@ def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -
 
 def projection_spin_3d(
     volume: np.ndarray,
-    voxel_size: Tuple[float, float, float] = (1.0, 0.1625, 0.1625),
-) -> Tuple[np.ndarray, str]:
+    voxel_size: tuple[float, float, float] = (1.0, 0.1625, 0.1625),
+) -> tuple[np.ndarray, str]:
     """Multiple 3D perspective views from different angles (2x3 grid).
 
     voxel_size: (dz, dy, dx) in microns. Forwarded to render_volume_rotated
@@ -392,8 +414,11 @@ def projection_spin_3d(
     views = []
     for angle_y in angles_y:
         view = render_volume_rotated(
-            volume, angle_y=angle_y, angle_x=base_tilt,
-            threshold=py_threshold, perspective=0.5,
+            volume,
+            angle_y=angle_y,
+            angle_x=base_tilt,
+            threshold=py_threshold,
+            perspective=0.5,
             voxel_size=voxel_size,
         )
         views.append(view)
@@ -409,10 +434,10 @@ def projection_spin_3d(
         pad_w = (target_w - w) // 2
         if v.ndim == 3:
             p = np.zeros((target_h, target_w, 3), dtype=v.dtype)
-            p[pad_h:pad_h+h, pad_w:pad_w+w] = v
+            p[pad_h : pad_h + h, pad_w : pad_w + w] = v
         else:
             p = np.zeros((target_h, target_w), dtype=v.dtype)
-            p[pad_h:pad_h+h, pad_w:pad_w+w] = v
+            p[pad_h : pad_h + h, pad_w : pad_w + w] = v
         padded.append(p)
 
     row1 = np.hstack(padded[0:3])
@@ -423,11 +448,11 @@ def projection_spin_3d(
 
 
 PROJECTION_METHODS = {
-    'dual_view': projection_dual_view,
-    'depth_colored': projection_depth_colored,
-    'multi_slice': projection_multi_slice,
-    'three_view': projection_three_view,
-    'spin_3d': projection_spin_3d,
+    "dual_view": projection_dual_view,
+    "depth_colored": projection_depth_colored,
+    "multi_slice": projection_multi_slice,
+    "three_view": projection_three_view,
+    "spin_3d": projection_spin_3d,
 }
 
 
@@ -438,9 +463,11 @@ def projection_spin_3d(
 # Presence Tracking (Collaborative Feature)
 # =============================================================================
 
+
 @dataclass
 class ClientInfo:
     """Information about a connected WebSocket client for presence tracking"""
+
     client_id: str
     name: str
     color: str  # Hex color for avatar background
@@ -452,13 +479,25 @@ class ConnectionManager:
 
     # Colors for avatar backgrounds (pleasant, distinct colors)
     AVATAR_COLORS = [
-        '#4a9eff', '#ff6b6b', '#51cf66', '#ffd43b', '#cc5de8',
-        '#ff922b', '#20c997', '#748ffc', '#f06595', '#69db7c',
-        '#ffa94d', '#9775fa', '#38d9a9', '#e599f7', '#74c0fc'
+        "#4a9eff",
+        "#ff6b6b",
+        "#51cf66",
+        "#ffd43b",
+        "#cc5de8",
+        "#ff922b",
+        "#20c997",
+        "#748ffc",
+        "#f06595",
+        "#69db7c",
+        "#ffa94d",
+        "#9775fa",
+        "#38d9a9",
+        "#e599f7",
+        "#74c0fc",
     ]
 
     def __init__(self):
-        self.active_connections: Dict[WebSocket, ClientInfo] = {}
+        self.active_connections: dict[WebSocket, ClientInfo] = {}
         self._lock = asyncio.Lock()
 
     def _generate_color(self, client_id: str) -> str:
@@ -472,6 +511,7 @@ async def connect(self, websocket: WebSocket, client_id: str = None, name: str =
         # Generate defaults if not provided
         if not client_id:
             import uuid
+
             client_id = str(uuid.uuid4())[:8]
         if not name:
             name = f"Anonymous {client_id[:4]}"
@@ -480,12 +520,14 @@ async def connect(self, websocket: WebSocket, client_id: str = None, name: str =
             client_id=client_id,
             name=name,
             color=self._generate_color(client_id),
-            connected_at=datetime.now().isoformat()
+            connected_at=datetime.now().isoformat(),
         )
 
         async with self._lock:
             self.active_connections[websocket] = client_info
-        logger.info(f"WebSocket connected: {name} ({client_id}). Total: {len(self.active_connections)}")
+        logger.info(
+            f"WebSocket connected: {name} ({client_id}). Total: {len(self.active_connections)}"
+        )
 
         # Broadcast updated presence to all clients
         await self.broadcast_presence()
@@ -494,7 +536,9 @@ async def disconnect(self, websocket: WebSocket):
         async with self._lock:
             client_info = self.active_connections.pop(websocket, None)
         if client_info:
-            logger.info(f"WebSocket disconnected: {client_info.name}. Total: {len(self.active_connections)}")
+            logger.info(
+                f"WebSocket disconnected: {client_info.name}. Total: {len(self.active_connections)}"
+            )
         else:
             logger.info(f"WebSocket disconnected. Total: {len(self.active_connections)}")
 
@@ -510,11 +554,11 @@ async def update_client_name(self, websocket: WebSocket, name: str):
                     client_id=old_info.client_id,
                     name=name,
                     color=old_info.color,
-                    connected_at=old_info.connected_at
+                    connected_at=old_info.connected_at,
                 )
         await self.broadcast_presence()
 
-    def get_client_info(self, websocket: WebSocket) -> Optional[ClientInfo]:
+    def get_client_info(self, websocket: WebSocket) -> ClientInfo | None:
         """Get client info for a websocket"""
         return self.active_connections.get(websocket)
 
@@ -526,12 +570,12 @@ async def broadcast_presence(self):
         # Deduplicate by client_id (same user in multiple tabs = one avatar)
         async with self._lock:
             seen_clients = {}
-            for ws, info in self.active_connections.items():
+            for _ws, info in self.active_connections.items():
                 # Keep the most recent entry for each client_id
                 seen_clients[info.client_id] = {
-                    'client_id': info.client_id,
-                    'name': info.name,
-                    'color': info.color
+                    "client_id": info.client_id,
+                    "name": info.name,
+                    "color": info.color,
                 }
             clients_list = list(seen_clients.values())
 
@@ -541,14 +585,8 @@ async def broadcast_presence(self):
             try:
                 personalized = []
                 for client in clients_list:
-                    personalized.append({
-                        **client,
-                        'is_you': client['client_id'] == info.client_id
-                    })
-                await ws.send_json({
-                    'type': 'presence',
-                    'clients': personalized
-                })
+                    personalized.append({**client, "is_you": client["client_id"] == info.client_id})
+                await ws.send_json({"type": "presence", "clients": personalized})
             except Exception:
                 disconnected.append(ws)
 
@@ -564,15 +602,15 @@ class GroundTruthCreate(BaseModel):
     embryo_id: str
     stage: str
     start_timepoint: int
-    end_timepoint: Optional[int] = None
-    annotator: Optional[str] = None
-    notes: Optional[str] = None
+    end_timepoint: int | None = None
+    annotator: str | None = None
+    notes: str | None = None
 
 
 class GroundTruthDelete(BaseModel):
     session_id: str
     embryo_id: str
-    stage: Optional[str] = None
+    stage: str | None = None
 
 
 class DatasetExplorer:
@@ -658,8 +696,7 @@ async def get_session(session_id: str):
             """Get session details."""
             conn = get_connection(self.db_path)
             session = conn.execute(
-                "SELECT * FROM sessions WHERE session_id = ?",
-                (session_id,)
+                "SELECT * FROM sessions WHERE session_id = ?", (session_id,)
             ).fetchone()
             conn.close()
 
@@ -674,8 +711,8 @@ async def get_session(session_id: str):
 
         @app.get("/api/embryos")
         async def list_embryos(
-            session_id: Optional[str] = None,
-            has_ground_truth: Optional[bool] = None,
+            session_id: str | None = None,
+            has_ground_truth: bool | None = None,
         ):
             """List embryos with optional filters."""
             embryos = []
@@ -683,15 +720,17 @@ async def list_embryos(
                 session_id=session_id,
                 has_ground_truth=has_ground_truth,
             ):
-                embryos.append({
-                    "embryo_id": embryo.embryo_id,
-                    "session_id": embryo.session_id,
-                    "num_images": embryo.num_images,
-                    "num_volumes": embryo.num_volumes,
-                    "timepoint_range": embryo.timepoint_range,
-                    "has_ground_truth": embryo.has_ground_truth,
-                    "ground_truth_stages": embryo.ground_truth_stages,
-                })
+                embryos.append(
+                    {
+                        "embryo_id": embryo.embryo_id,
+                        "session_id": embryo.session_id,
+                        "num_images": embryo.num_images,
+                        "num_volumes": embryo.num_volumes,
+                        "timepoint_range": embryo.timepoint_range,
+                        "has_ground_truth": embryo.has_ground_truth,
+                        "ground_truth_stages": embryo.ground_truth_stages,
+                    }
+                )
             return embryos
 
         @app.get("/api/embryos/{session_id}/{embryo_id}")
@@ -745,8 +784,8 @@ async def get_embryos_with_multiple_sessions():
         async def list_images(
             session_id: str,
             embryo_id: str,
-            start_tp: Optional[int] = None,
-            end_tp: Optional[int] = None,
+            start_tp: int | None = None,
+            end_tp: int | None = None,
         ):
             """List images for an embryo (without image data)."""
             timepoint_range = None
@@ -828,7 +867,10 @@ async def create_ground_truth(data: GroundTruthCreate):
                 notes=data.notes,
             )
             end_str = f"-{data.end_timepoint}" if data.end_timepoint else ""
-            return {"status": "ok", "message": f"Set {data.stage} @ t={data.start_timepoint}{end_str}"}
+            return {
+                "status": "ok",
+                "message": f"Set {data.stage} @ t={data.start_timepoint}{end_str}",
+            }
 
         @app.delete("/api/ground_truth")
         async def delete_ground_truth(data: GroundTruthDelete):
@@ -857,7 +899,7 @@ async def get_run_metrics(run_id: int):
         @app.get("/api/runs/{run_id}/predictions")
         async def get_run_predictions(
             run_id: int,
-            embryo_id: Optional[str] = None,
+            embryo_id: str | None = None,
             limit: int = Query(100, le=1000),
             offset: int = 0,
         ):
@@ -895,31 +937,38 @@ async def get_timeline(session_id: str, embryo_id: str):
             """
             # Get all images
             images = []
-            for idx, img in enumerate(self.dataset.iter_images(
-                embryo_id=embryo_id,
-                session_id=session_id,
-                load_image_data=False,
-            )):
-                images.append({
-                    "index": idx,
-                    "timepoint": img.timepoint,
-                    "timestamp": img.timestamp,
-                    "ground_truth_stage": img.ground_truth_stage,
-                    "uid": img.uid,
-                    "volume_path": img.volume_path,
-                })
+            for idx, img in enumerate(
+                self.dataset.iter_images(
+                    embryo_id=embryo_id,
+                    session_id=session_id,
+                    load_image_data=False,
+                )
+            ):
+                images.append(
+                    {
+                        "index": idx,
+                        "timepoint": img.timepoint,
+                        "timestamp": img.timestamp,
+                        "ground_truth_stage": img.ground_truth_stage,
+                        "uid": img.uid,
+                        "volume_path": img.volume_path,
+                    }
+                )
 
             # Get ground truth transitions
             ground_truth = self.dataset.get_ground_truth(session_id, embryo_id)
 
             # Get predictions if any
             conn = get_connection(self.db_path)
-            predictions = conn.execute("""
+            predictions = conn.execute(
+                """
                 SELECT timepoint, predicted_stage, confidence, perception_run_id, reasoning
                 FROM predictions
                 WHERE session_id = ? AND embryo_id = ?
                 ORDER BY perception_run_id DESC, timepoint
-            """, (session_id, embryo_id)).fetchall()
+            """,
+                (session_id, embryo_id),
+            ).fetchall()
             conn.close()
 
             return {
@@ -949,7 +998,7 @@ async def get_perception_trace(session_id: str, embryo_id: str, timepoint: int):
                 return trace_data
             except Exception as e:
                 logger.error(f"Failed to read trace file: {e}")
-                raise HTTPException(status_code=500, detail=str(e))
+                raise HTTPException(status_code=500, detail=str(e)) from e
 
         @app.get("/api/traces/{session_id}/{embryo_id}")
         async def list_perception_traces(session_id: str, embryo_id: str):
@@ -976,7 +1025,8 @@ async def get_unified_timeline(embryo_uid: str):
             # Get all volumes for this embryo UID
             # Sort by session (using min timestamp per session) then by timepoint within session
             conn = get_connection(self.db_path)
-            rows = conn.execute("""
+            rows = conn.execute(
+                """
                 SELECT
                     v.uid,
                     v.session_id,
@@ -984,11 +1034,14 @@ async def get_unified_timeline(embryo_uid: str):
                     v.timepoint,
                     v.timestamp,
                     v.file_path,
-                    (SELECT MIN(v2.uid) FROM volumes v2 WHERE v2.session_id = v.session_id) as session_min_uid
+                    (SELECT MIN(v2.uid) FROM volumes v2
+                     WHERE v2.session_id = v.session_id) as session_min_uid
                 FROM volumes v
                 WHERE v.embryo_uid = ?
                 ORDER BY session_min_uid ASC, v.uid ASC
-            """, (embryo_uid,)).fetchall()
+            """,
+                (embryo_uid,),
+            ).fetchall()
 
             if not rows:
                 conn.close()
@@ -999,16 +1052,20 @@ async def get_unified_timeline(embryo_uid: str):
             session_embryos = set((r[1], r[2]) for r in rows)
             gt_maps = {}
             for session_id, embryo_id in session_embryos:
-                gt_rows = conn.execute("""
+                gt_rows = conn.execute(
+                    """
                     SELECT stage, start_timepoint, end_timepoint
                     FROM ground_truth
                     WHERE session_id = ? AND embryo_id = ?
                     ORDER BY start_timepoint
-                """, (session_id, embryo_id)).fetchall()
+                """,
+                    (session_id, embryo_id),
+                ).fetchall()
                 gt_maps[(session_id, embryo_id)] = gt_rows
             conn.close()
 
-            # Build unified image list with ground truth based on row index within each session/embryo
+            # Build unified image list with ground truth based on row index
+            # within each session/embryo
             images = []
             session_embryo_counts = {}  # Track row index within each session/embryo
 
@@ -1029,16 +1086,18 @@ async def get_unified_timeline(embryo_uid: str):
                         gt_stage = stage
                         break
 
-                images.append({
-                    "index": idx,
-                    "uid": r[0],
-                    "session_id": session_id,
-                    "embryo_id": embryo_id,
-                    "timepoint": r[3],
-                    "timestamp": r[4],
-                    "file_path": r[5],
-                    "ground_truth_stage": gt_stage,
-                })
+                images.append(
+                    {
+                        "index": idx,
+                        "uid": r[0],
+                        "session_id": session_id,
+                        "embryo_id": embryo_id,
+                        "timepoint": r[3],
+                        "timestamp": r[4],
+                        "file_path": r[5],
+                        "ground_truth_stage": gt_stage,
+                    }
+                )
 
             # Get unique sessions
             sessions = list(set(img["session_id"] for img in images))
@@ -1085,6 +1144,7 @@ async def get_volume_data(session_id: str, embryo_id: str, index: int):
 
             # Apply Gaussian blur along Z axis to reduce banding at side views
             from scipy import ndimage
+
             vol_norm = ndimage.gaussian_filter1d(vol_norm, sigma=1.0, axis=0)
 
             vol_uint8 = (vol_norm * 255).astype(np.uint8)
@@ -1126,11 +1186,13 @@ async def get_projections(session_id: str, embryo_id: str, index: int):
             for method_name, method_func in PROJECTION_METHODS.items():
                 try:
                     proj_img, desc = method_func(vol)
-                    projections.append({
-                        "method": method_name,
-                        "description": desc,
-                        "data": image_to_base64(proj_img),
-                    })
+                    projections.append(
+                        {
+                            "method": method_name,
+                            "description": desc,
+                            "data": image_to_base64(proj_img),
+                        }
+                    )
                 except Exception as e:
                     logger.warning(f"Projection {method_name} failed: {e}")
 
@@ -1159,12 +1221,12 @@ async def websocket_endpoint(websocket: WebSocket):
             try:
                 while True:
                     data = await websocket.receive_json()
-                    msg_type = data.get('type')
+                    msg_type = data.get("type")
 
-                    if msg_type == 'join':
+                    if msg_type == "join":
                         # Client joining with ID and name
-                        client_id = data.get('client_id')
-                        name = data.get('name')
+                        client_id = data.get("client_id")
+                        name = data.get("name")
                         # Update client info
                         async with self.manager._lock:
                             if websocket in self.manager.active_connections:
@@ -1172,18 +1234,20 @@ async def websocket_endpoint(websocket: WebSocket):
                                 self.manager.active_connections[websocket] = ClientInfo(
                                     client_id=client_id or old_info.client_id,
                                     name=name or old_info.name,
-                                    color=self.manager._generate_color(client_id or old_info.client_id),
-                                    connected_at=old_info.connected_at
+                                    color=self.manager._generate_color(
+                                        client_id or old_info.client_id
+                                    ),
+                                    connected_at=old_info.connected_at,
                                 )
                         await self.manager.broadcast_presence()
 
-                    elif msg_type == 'update_name':
+                    elif msg_type == "update_name":
                         # Client updating their display name
-                        name = data.get('name')
+                        name = data.get("name")
                         if name:
                             await self.manager.update_client_name(websocket, name)
 
-                    elif msg_type == 'get_presence':
+                    elif msg_type == "get_presence":
                         # Client requesting current presence list
                         await self.manager.broadcast_presence()
 
@@ -1222,6 +1286,7 @@ def _get_projections_html(self, session_id: str, embryo_id: str, index: int) ->
     def run(self):
         """Start the server."""
         import uvicorn
+
         logger.info("=== Embryo Dataset Explorer ===")
         logger.info("Database: %s", self.db_path)
         logger.info("Open http://localhost:%d in your browser", self.port)
diff --git a/gently/dataset/schema.py b/gently/dataset/schema.py
index 927b95f7..c806b6c8 100644
--- a/gently/dataset/schema.py
+++ b/gently/dataset/schema.py
@@ -13,11 +13,10 @@
 - reasoning_traces: Full VLM reasoning traces
 """
 
-import sqlite3
 import logging
-from pathlib import Path
-from typing import Optional
+import sqlite3
 from contextlib import contextmanager
+from pathlib import Path
 
 logger = logging.getLogger(__name__)
 
@@ -25,7 +24,7 @@
 DEFAULT_DB_PATH = Path("D:/gently/dataset.db")
 
 
-def get_connection(db_path: Optional[Path] = None) -> sqlite3.Connection:
+def get_connection(db_path: Path | None = None) -> sqlite3.Connection:
     """
     Get a database connection with optimized settings.
 
@@ -59,7 +58,7 @@ def transaction(conn: sqlite3.Connection):
         raise
 
 
-def init_database(db_path: Optional[Path] = None) -> sqlite3.Connection:
+def init_database(db_path: Path | None = None) -> sqlite3.Connection:
     """
     Initialize the database with all tables.
 
@@ -84,7 +83,7 @@ def init_database(db_path: Optional[Path] = None) -> sqlite3.Connection:
     # Set version
     conn.execute(
         "INSERT OR REPLACE INTO metadata (key, value) VALUES ('version', ?)",
-        (str(DATABASE_VERSION),)
+        (str(DATABASE_VERSION),),
     )
     conn.commit()
 
@@ -378,7 +377,7 @@ def migrate_to_v2(conn: sqlite3.Connection) -> bool:
     cursor = conn.execute("PRAGMA table_info(perception_runs)")
     columns = {row[1] for row in cursor.fetchall()}
 
-    if 'trace_type' in columns:
+    if "trace_type" in columns:
         logger.info("Database already at v2, no migration needed")
         return False
 
@@ -397,7 +396,7 @@ def migrate_to_v2(conn: sqlite3.Connection) -> bool:
     # Check if file_path column exists in reasoning_traces
     cursor = conn.execute("PRAGMA table_info(reasoning_traces)")
     trace_columns = {row[1] for row in cursor.fetchall()}
-    if 'file_path' not in trace_columns:
+    if "file_path" not in trace_columns:
         statements.append("ALTER TABLE reasoning_traces ADD COLUMN file_path TEXT")
 
     for stmt in statements:
@@ -432,7 +431,7 @@ def migrate_to_v3(conn: sqlite3.Connection) -> bool:
     cursor = conn.execute("PRAGMA table_info(embryos)")
     columns = {row[1] for row in cursor.fetchall()}
 
-    if 'embryo_uid' in columns:
+    if "embryo_uid" in columns:
         logger.info("Database already at v3, no migration needed")
         return False
 
@@ -513,7 +512,7 @@ def migrate_to_v4(conn: sqlite3.Connection) -> bool:
     cursor = conn.execute("PRAGMA table_info(ground_truth)")
     columns = {row[1] for row in cursor.fetchall()}
 
-    if 'end_timepoint' in columns:
+    if "end_timepoint" in columns:
         logger.info("Database already at v4, no migration needed")
         return False
 
@@ -542,28 +541,33 @@ def get_database_stats(conn: sqlite3.Connection) -> dict:
     """
     stats = {}
 
-    tables = ['sessions', 'embryos', 'volumes', 'images', 'ground_truth',
-              'perception_runs', 'predictions']
+    tables = [
+        "sessions",
+        "embryos",
+        "volumes",
+        "images",
+        "ground_truth",
+        "perception_runs",
+        "predictions",
+    ]
 
     for table in tables:
         count = conn.execute(f"SELECT COUNT(*) FROM {table}").fetchone()[0]
         stats[table] = count
 
     # Additional stats
-    stats['unique_embryo_sessions'] = conn.execute(
+    stats["unique_embryo_sessions"] = conn.execute(
         "SELECT COUNT(DISTINCT session_id || embryo_id) FROM volumes"
     ).fetchone()[0]
 
     # Count unique embryos with ground truth (more useful than annotation count)
-    stats['embryos_with_gt'] = conn.execute(
+    stats["embryos_with_gt"] = conn.execute(
         "SELECT COUNT(DISTINCT session_id || '|' || embryo_id) FROM ground_truth"
     ).fetchone()[0]
 
     # Date range
-    result = conn.execute(
-        "SELECT MIN(timestamp), MAX(timestamp) FROM volumes"
-    ).fetchone()
-    stats['earliest_volume'] = result[0]
-    stats['latest_volume'] = result[1]
+    result = conn.execute("SELECT MIN(timestamp), MAX(timestamp) FROM volumes").fetchone()
+    stats["earliest_volume"] = result[0]
+    stats["latest_volume"] = result[1]
 
     return stats
diff --git a/gently/detection.py b/gently/detection.py
index 72adf7e5..4c4e567e 100644
--- a/gently/detection.py
+++ b/gently/detection.py
@@ -10,22 +10,31 @@
 """
 
 import logging
+
 import numpy as np
-from typing import Optional, Tuple, List
-from scipy.ndimage import uniform_filter, gaussian_filter, sobel, label, binary_opening, binary_closing
+from scipy.ndimage import (
+    binary_closing,
+    binary_opening,
+    gaussian_filter,
+    label,
+    sobel,
+    uniform_filter,
+)
 
 logger = logging.getLogger(__name__)
 
 
-def detect_embryo_roi(image: np.ndarray,
-                     kernel_size_fraction: float = 0.1,
-                     min_kernel_size: int = 24,
-                     variance_weight: float = 0.4,
-                     gradient_weight: float = 0.4,
-                     intensity_weight: float = 0.2,
-                     threshold_std: float = 1.5,
-                     min_area_fraction: float = 0.05,
-                     max_area_fraction: float = 0.5) -> Optional[Tuple[int, int, int, int]]:
+def detect_embryo_roi(
+    image: np.ndarray,
+    kernel_size_fraction: float = 0.1,
+    min_kernel_size: int = 24,
+    variance_weight: float = 0.4,
+    gradient_weight: float = 0.4,
+    intensity_weight: float = 0.2,
+    threshold_std: float = 1.5,
+    min_area_fraction: float = 0.05,
+    max_area_fraction: float = 0.5,
+) -> tuple[int, int, int, int] | None:
     """
     Detect embryo region of interest for sparse bottom camera images
 
@@ -83,9 +92,11 @@ def detect_embryo_roi(image: np.ndarray,
         intensity_contrast = np.abs(img_norm - background_level)
 
         # Combine detection methods
-        combined_score = (variance_weight * local_var +
-                         gradient_weight * gradient_mag +
-                         intensity_weight * intensity_contrast)
+        combined_score = (
+            variance_weight * local_var
+            + gradient_weight * gradient_mag
+            + intensity_weight * intensity_contrast
+        )
 
         # Find regions above threshold
         threshold = np.mean(combined_score) + threshold_std * np.std(combined_score)
@@ -104,7 +115,7 @@ def detect_embryo_roi(image: np.ndarray,
         # Find largest connected component (most likely embryo)
         region_sizes = [(labeled_regions == i).sum() for i in range(1, num_regions + 1)]
         largest_region_idx = np.argmax(region_sizes) + 1
-        largest_region_mask = (labeled_regions == largest_region_idx)
+        largest_region_mask = labeled_regions == largest_region_idx
 
         # Get bounding box with padding
         rows, cols = np.where(largest_region_mask)
@@ -123,7 +134,7 @@ def detect_embryo_roi(image: np.ndarray,
         total_area = image.shape[0] * image.shape[1]
 
         # Check if ROI is reasonable size
-        if min_area_fraction <= roi_area/total_area <= max_area_fraction:
+        if min_area_fraction <= roi_area / total_area <= max_area_fraction:
             return (x_min, y_min, w, h)
         else:
             return None
@@ -133,9 +144,9 @@ def detect_embryo_roi(image: np.ndarray,
         return None
 
 
-def detect_multiple_embryos(image: np.ndarray,
-                           max_embryos: int = 5,
-                           min_separation: int = 50) -> List[Tuple[int, int, int, int]]:
+def detect_multiple_embryos(
+    image: np.ndarray, max_embryos: int = 5, min_separation: int = 50
+) -> list[tuple[int, int, int, int]]:
     """
     Detect multiple embryo regions in bottom camera images
 
@@ -187,7 +198,7 @@ def detect_multiple_embryos(image: np.ndarray,
         # Get all regions with their sizes and centers
         regions = []
         for i in range(1, num_regions + 1):
-            region_mask = (labeled_regions == i)
+            region_mask = labeled_regions == i
             region_size = region_mask.sum()
 
             # Skip tiny regions
@@ -211,14 +222,16 @@ def detect_multiple_embryos(image: np.ndarray,
             w = x_max - x_min
             h = y_max - y_min
 
-            regions.append({
-                'roi': (x_min, y_min, w, h),
-                'center': (x_center, y_center),
-                'size': region_size
-            })
+            regions.append(
+                {
+                    "roi": (x_min, y_min, w, h),
+                    "center": (x_center, y_center),
+                    "size": region_size,
+                }
+            )
 
         # Sort by size (largest first)
-        regions.sort(key=lambda x: x['size'], reverse=True)
+        regions.sort(key=lambda x: x["size"], reverse=True)
 
         # Filter out overlapping regions
         selected_regions = []
@@ -226,14 +239,15 @@ def detect_multiple_embryos(image: np.ndarray,
             if len(selected_regions) >= max_embryos:
                 break
 
-            center = region['center']
+            center = region["center"]
 
             # Check separation from already selected regions
             too_close = False
             for selected in selected_regions:
-                selected_center = selected['center']
-                distance = np.sqrt((center[0] - selected_center[0])**2 +
-                                 (center[1] - selected_center[1])**2)
+                selected_center = selected["center"]
+                distance = np.sqrt(
+                    (center[0] - selected_center[0]) ** 2 + (center[1] - selected_center[1]) ** 2
+                )
                 if distance < min_separation:
                     too_close = True
                     break
@@ -241,14 +255,14 @@ def detect_multiple_embryos(image: np.ndarray,
             if not too_close:
                 selected_regions.append(region)
 
-        return [r['roi'] for r in selected_regions]
+        return [r["roi"] for r in selected_regions]
 
     except Exception as e:
         logger.error("Multiple embryo detection failed: %s", e)
         return []
 
 
-def get_embryo_focus_roi(image: np.ndarray) -> Optional[Tuple[int, int, int, int]]:
+def get_embryo_focus_roi(image: np.ndarray) -> tuple[int, int, int, int] | None:
     """
     Simple interface for getting embryo ROI for focus analysis
 
@@ -264,4 +278,4 @@ def get_embryo_focus_roi(image: np.ndarray) -> Optional[Tuple[int, int, int, int
     Optional[Tuple[int, int, int, int]]
         ROI as (x, y, width, height) or None to use full image
     """
-    return detect_embryo_roi(image)
\ No newline at end of file
+    return detect_embryo_roi(image)
diff --git a/gently/eval/__init__.py b/gently/eval/__init__.py
index e93f5d5c..0db29d8f 100644
--- a/gently/eval/__init__.py
+++ b/gently/eval/__init__.py
@@ -15,11 +15,11 @@
 See docs/EVAL.md (TODO) for usage.
 """
 
+from .candidates import ReactiveCandidate
+from .decision_log import Decision, DecisionLog, DecisionTrigger, prompt_hash
 from .event_capture import EventCapture
 from .event_replay import EventReplay
-from .decision_log import Decision, DecisionLog, DecisionTrigger, prompt_hash
-from .shadow import OrchestratorCandidate, ShadowRunner, NoOpCandidate
-from .candidates import ReactiveCandidate
+from .shadow import NoOpCandidate, OrchestratorCandidate, ShadowRunner
 
 __all__ = [
     "EventCapture",
diff --git a/gently/eval/candidates.py b/gently/eval/candidates.py
index 111cc935..d4d9937e 100644
--- a/gently/eval/candidates.py
+++ b/gently/eval/candidates.py
@@ -16,7 +16,7 @@
 
 import logging
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from gently.core.event_bus import Event
 
@@ -33,18 +33,18 @@ class _ReactiveWorldModel:
 
     # {embryo_id: {"coarse": {x, y} | None, "fine": {x, y} | None,
     #              "has_fine": bool, "confidence": float}}
-    embryos: Dict[str, Dict[str, Any]] = field(default_factory=dict)
+    embryos: dict[str, dict[str, Any]] = field(default_factory=dict)
 
     # Last live stage XY (µm) from a STAGE_MOVED event.
-    last_stage_um: Optional[Dict[str, float]] = None
+    last_stage_um: dict[str, float] | None = None
 
     # Last error message + timestamp, so the candidate can avoid
     # spam-proposing escalations for the same recurring failure.
-    last_error: Optional[Dict[str, Any]] = None
+    last_error: dict[str, Any] | None = None
 
     # Count of events seen, by type name — useful debug field that also
     # ends up in the decision context_summary.
-    seen: Dict[str, int] = field(default_factory=dict)
+    seen: dict[str, int] = field(default_factory=dict)
 
 
 class ReactiveCandidate(OrchestratorCandidate):
@@ -126,7 +126,7 @@ def on_event(self, event: Event) -> None:
 
     def _ingest_embryos_update(self, event: Event) -> None:
         embryos = (event.data or {}).get("embryos") or []
-        new_world: Dict[str, Dict[str, Any]] = {}
+        new_world: dict[str, dict[str, Any]] = {}
         for emb in embryos:
             new_world[emb.get("id", "")] = {
                 "coarse": emb.get("position_coarse"),
@@ -147,24 +147,26 @@ def _react_operator_edited(self, event: Event) -> None:
         data = event.data or {}
         eid = data.get("embryo_id") or ""
         invalidated = bool(data.get("fine_position_invalidated"))
-        tool_calls: List[Dict[str, Any]] = []
+        tool_calls: list[dict[str, Any]] = []
         # Only propose a recalibration when there was a fine position
         # that the edit just invalidated. New coarse without any prior
         # fine has nothing to refresh yet.
         if invalidated:
-            tool_calls.append({
-                "name": "recalibrate_embryo",
-                "input": {"embryo_id": eid},
-                "id": None,
-            })
+            tool_calls.append(
+                {
+                    "name": "recalibrate_embryo",
+                    "input": {"embryo_id": eid},
+                    "id": None,
+                }
+            )
         self.log_decision(
             trigger=DecisionTrigger.EVENT,
             trigger_detail="OPERATOR_EDITED_EMBRYO",
             tool_calls=tool_calls,
             response_text=(
                 f"Operator moved {eid}; proposing recalibration."
-                if invalidated else
-                f"Operator moved {eid}; no prior fine -- no action."
+                if invalidated
+                else f"Operator moved {eid}; no prior fine -- no action."
             ),
             recent_event_ids=[event.event_id],
             context_summary=self._summary(),
@@ -174,21 +176,23 @@ def _react_operator_marked(self, event: Event) -> None:
         data = event.data or {}
         ids = data.get("embryo_ids") or []
         count = data.get("count", len(ids))
-        tool_calls: List[Dict[str, Any]] = []
+        tool_calls: list[dict[str, Any]] = []
         if count:
-            tool_calls.append({
-                "name": "calibrate_all_embryos",
-                "input": {"embryo_ids": list(ids)},
-                "id": None,
-            })
+            tool_calls.append(
+                {
+                    "name": "calibrate_all_embryos",
+                    "input": {"embryo_ids": list(ids)},
+                    "id": None,
+                }
+            )
         self.log_decision(
             trigger=DecisionTrigger.EVENT,
             trigger_detail="OPERATOR_MARKED_EMBRYOS",
             tool_calls=tool_calls,
             response_text=(
                 f"Operator marked {count} embryos; proposing calibration."
-                if count else
-                "Operator marked zero embryos; no action."
+                if count
+                else "Operator marked zero embryos; no action."
             ),
             recent_event_ids=[event.event_id],
             context_summary=self._summary(),
@@ -200,11 +204,13 @@ def _react_operator_removed(self, event: Event) -> None:
         self.log_decision(
             trigger=DecisionTrigger.EVENT,
             trigger_detail="OPERATOR_REMOVED_EMBRYO",
-            tool_calls=[{
-                "name": "forget_embryo",
-                "input": {"embryo_id": eid},
-                "id": None,
-            }],
+            tool_calls=[
+                {
+                    "name": "forget_embryo",
+                    "input": {"embryo_id": eid},
+                    "id": None,
+                }
+            ],
             response_text=f"Operator removed {eid}; proposing cache tidy-up.",
             recent_event_ids=[event.event_id],
             context_summary=self._summary(),
@@ -212,6 +218,7 @@ def _react_operator_removed(self, event: Event) -> None:
 
     def _react_error(self, event: Event) -> None:
         from datetime import datetime
+
         data = event.data or {}
         msg = str(data.get("msg") or data.get("error") or data.get("message") or "unknown")
         now = datetime.now()
@@ -227,7 +234,10 @@ def _react_error(self, event: Event) -> None:
                 trigger=DecisionTrigger.EVENT,
                 trigger_detail="ERROR_OCCURRED",
                 tool_calls=[],
-                response_text=f"Suppressed repeat error within {self.ERROR_SUPPRESS_WINDOW_SEC:.0f}s window: {msg[:120]}",
+                response_text=(
+                    f"Suppressed repeat error within"
+                    f" {self.ERROR_SUPPRESS_WINDOW_SEC:.0f}s window: {msg[:120]}"
+                ),
                 recent_event_ids=[event.event_id],
                 context_summary=self._summary(),
             )
@@ -235,11 +245,13 @@ def _react_error(self, event: Event) -> None:
         self.log_decision(
             trigger=DecisionTrigger.EVENT,
             trigger_detail="ERROR_OCCURRED",
-            tool_calls=[{
-                "name": "escalate_to_operator",
-                "input": {"error_message": msg, "source": event.source},
-                "id": None,
-            }],
+            tool_calls=[
+                {
+                    "name": "escalate_to_operator",
+                    "input": {"error_message": msg, "source": event.source},
+                    "id": None,
+                }
+            ],
             response_text=f"New error -- proposing escalation: {msg[:120]}",
             recent_event_ids=[event.event_id],
             context_summary=self._summary(),
@@ -253,5 +265,6 @@ def _summary(self) -> str:
         stage = self.world.last_stage_um
         stage_str = f"({stage['x']:.1f}, {stage['y']:.1f})" if stage else "unknown"
         seen = sum(self.world.seen.values())
-        return (f"{n_emb} embryos ({n_fine} fine-calibrated); "
-                f"stage {stage_str}; {seen} events ingested")
+        return (
+            f"{n_emb} embryos ({n_fine} fine-calibrated); stage {stage_str}; {seen} events ingested"
+        )
diff --git a/gently/eval/decision_log.py b/gently/eval/decision_log.py
index 0a014b61..f8aa334d 100644
--- a/gently/eval/decision_log.py
+++ b/gently/eval/decision_log.py
@@ -19,11 +19,11 @@
 import json
 import logging
 import threading
-from dataclasses import dataclass, field, asdict
+from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from .event_capture import _json_default
 
@@ -54,12 +54,13 @@ def prompt_hash(system_prompt: Any, messages: Any) -> str:
 
 class DecisionTrigger(str, Enum):
     """What woke the agent up for this decision moment."""
+
     USER_MESSAGE = "user_message"
-    EVENT         = "event"           # event-driven (perception, error, etc.)
-    TICK          = "tick"            # scheduled / periodic checkpoint
-    PHASE         = "phase"           # plan phase boundary (between embryos / timepoints)
-    STARTUP       = "startup"         # initial session bring-up
-    UNKNOWN       = "unknown"
+    EVENT = "event"  # event-driven (perception, error, etc.)
+    TICK = "tick"  # scheduled / periodic checkpoint
+    PHASE = "phase"  # plan phase boundary (between embryos / timepoints)
+    STARTUP = "startup"  # initial session bring-up
+    UNKNOWN = "unknown"
 
 
 @dataclass
@@ -75,22 +76,23 @@ class Decision:
     sent to Claude so two candidates with byte-identical input but
     different decisions can be told apart by a single field.
     """
+
     timestamp: datetime
-    agent: str                              # "production" or candidate name
+    agent: str  # "production" or candidate name
     trigger: DecisionTrigger
-    trigger_detail: Optional[str] = None    # event_id, user message excerpt, tick name
+    trigger_detail: str | None = None  # event_id, user message excerpt, tick name
 
-    tool_calls: List[Dict[str, Any]] = field(default_factory=list)
-    response_text: Optional[str] = None
-    prompt_hash: Optional[str] = None
+    tool_calls: list[dict[str, Any]] = field(default_factory=list)
+    response_text: str | None = None
+    prompt_hash: str | None = None
 
-    context_summary: Optional[str] = None   # one-line description of state
-    recent_event_ids: List[str] = field(default_factory=list)
+    context_summary: str | None = None  # one-line description of state
+    recent_event_ids: list[str] = field(default_factory=list)
 
-    duration_ms: Optional[float] = None     # how long the decision took
-    error: Optional[str] = None             # if the decision moment errored
+    duration_ms: float | None = None  # how long the decision took
+    error: str | None = None  # if the decision moment errored
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "timestamp": self.timestamp.isoformat(),
             "agent": self.agent,
@@ -106,7 +108,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "Decision":
+    def from_dict(cls, d: dict[str, Any]) -> Decision:
         return cls(
             timestamp=datetime.fromisoformat(d["timestamp"]),
             agent=d.get("agent", "unknown"),
@@ -176,11 +178,11 @@ def __exit__(self, exc_type, exc, tb):
         self.close()
         return False
 
-    def read(self) -> List[Decision]:
+    def read(self) -> list[Decision]:
         """Read every decision back from disk. Quick + dirty diff substrate."""
         if not self.path.exists():
             return []
-        out: List[Decision] = []
+        out: list[Decision] = []
         with self.path.open("r", encoding="utf-8") as f:
             for line_no, raw in enumerate(f, start=1):
                 raw = raw.strip()
diff --git a/gently/eval/event_capture.py b/gently/eval/event_capture.py
index c92c9fcd..5bb42811 100644
--- a/gently/eval/event_capture.py
+++ b/gently/eval/event_capture.py
@@ -29,9 +29,8 @@
 from datetime import date, datetime
 from enum import Enum
 from pathlib import Path
-from typing import Optional, Set
 
-from gently.core.event_bus import Event, EventBus, EventType, _NO_HISTORY_TYPES
+from gently.core.event_bus import _NO_HISTORY_TYPES, Event, EventBus, EventType
 
 logger = logging.getLogger(__name__)
 
@@ -53,10 +52,9 @@ class EventCapture:
     # itself skips for its history deque. The rationale carries over: at
     # 5 Hz over hours these would dominate the log without adding signal
     # that replay / diff can use.
-    DEFAULT_SKIP: Set[EventType] = frozenset(_NO_HISTORY_TYPES)
+    DEFAULT_SKIP: set[EventType] = frozenset(_NO_HISTORY_TYPES)
 
-    def __init__(self, path: Path, *,
-                 skip: Optional[Set[EventType]] = None):
+    def __init__(self, path: Path, *, skip: set[EventType] | None = None):
         self.path = Path(path)
         self._skip = self.DEFAULT_SKIP if skip is None else frozenset(skip)
         self._fp = None
@@ -92,8 +90,7 @@ def stop(self) -> None:
                 except Exception:
                     logger.exception("EventCapture: file close failed")
                 self._fp = None
-        logger.info("EventCapture: closed (%d captured, %d skipped)",
-                    self._count, self._skipped)
+        logger.info("EventCapture: closed (%d captured, %d skipped)", self._count, self._skipped)
 
     def __del__(self):
         # Best-effort safety net for cases where the owner forgets to call
@@ -149,6 +146,7 @@ def _json_default(obj):
             pass
     try:
         import numpy as np
+
         if isinstance(obj, np.generic):
             return obj.item()
         if isinstance(obj, np.ndarray):
diff --git a/gently/eval/event_replay.py b/gently/eval/event_replay.py
index 092ec719..a209b612 100644
--- a/gently/eval/event_replay.py
+++ b/gently/eval/event_replay.py
@@ -19,9 +19,9 @@
 import json
 import logging
 import time
+from collections.abc import Callable, Iterator
 from datetime import datetime
 from pathlib import Path
-from typing import Callable, Iterator, Optional
 
 from gently.core.event_bus import Event, EventBus
 
@@ -50,19 +50,16 @@ def events(self) -> Iterator[Event]:
                 try:
                     record = json.loads(raw)
                 except json.JSONDecodeError:
-                    logger.warning("EventReplay: malformed line %d in %s",
-                                   line_no, self.path)
+                    logger.warning("EventReplay: malformed line %d in %s", line_no, self.path)
                     continue
                 try:
                     yield Event.from_dict(record)
                 except KeyError:
                     # Unknown EventType — could be a newer enum the
                     # capturing process knew about. Skip rather than abort.
-                    logger.warning("EventReplay: unknown event_type on line %d",
-                                   line_no)
+                    logger.warning("EventReplay: unknown event_type on line %d", line_no)
                 except Exception:
-                    logger.exception("EventReplay: parse failure on line %d",
-                                     line_no)
+                    logger.exception("EventReplay: parse failure on line %d", line_no)
 
     def replay(
         self,
@@ -70,7 +67,7 @@ def replay(
         *,
         real_time: bool = False,
         time_scale: float = 1.0,
-        on_event: Optional[Callable[[Event], None]] = None,
+        on_event: Callable[[Event], None] | None = None,
     ) -> int:
         """Replay the captured events to ``target``. Returns count emitted.
 
@@ -94,7 +91,7 @@ def replay(
             raise ValueError("time_scale must be > 0")
 
         emitted = 0
-        prev_ts: Optional[datetime] = None
+        prev_ts: datetime | None = None
         wall_start = time.monotonic()
         for ev in self.events():
             if real_time and prev_ts is not None:
@@ -112,7 +109,10 @@ def replay(
         wall = time.monotonic() - wall_start
         logger.info(
             "EventReplay: emitted %d events in %.2fs (real_time=%s, time_scale=%g)",
-            emitted, wall, real_time, time_scale,
+            emitted,
+            wall,
+            real_time,
+            time_scale,
         )
         return emitted
 
diff --git a/gently/eval/shadow.py b/gently/eval/shadow.py
index 05335c96..c3e2a92f 100644
--- a/gently/eval/shadow.py
+++ b/gently/eval/shadow.py
@@ -25,13 +25,11 @@
 
 from __future__ import annotations
 
-import asyncio
 import logging
 import threading
 from abc import ABC, abstractmethod
+from collections.abc import Callable
 from datetime import datetime
-from pathlib import Path
-from typing import Awaitable, Callable, Dict, List, Optional
 
 from gently.core.event_bus import Event, EventBus
 
@@ -65,10 +63,10 @@ def __init__(self, name: str, decisions: DecisionLog):
     def on_event(self, event: Event) -> None:
         """Handle one event from the bus. Synchronous, must not block long."""
 
-    def on_start(self) -> None:
+    def on_start(self) -> None:  # noqa: B027
         """Called once when the shadow runner attaches this candidate."""
 
-    def on_stop(self) -> None:
+    def on_stop(self) -> None:  # noqa: B027
         """Called once when the shadow runner detaches this candidate."""
 
     # ---- helpers candidates can use ---------------------------------------
@@ -77,28 +75,30 @@ def log_decision(
         self,
         *,
         trigger: DecisionTrigger,
-        trigger_detail: Optional[str] = None,
-        tool_calls: Optional[List[Dict]] = None,
-        response_text: Optional[str] = None,
-        context_summary: Optional[str] = None,
-        recent_event_ids: Optional[List[str]] = None,
-        prompt_hash: Optional[str] = None,
-        duration_ms: Optional[float] = None,
-        error: Optional[str] = None,
+        trigger_detail: str | None = None,
+        tool_calls: list[dict] | None = None,
+        response_text: str | None = None,
+        context_summary: str | None = None,
+        recent_event_ids: list[str] | None = None,
+        prompt_hash: str | None = None,
+        duration_ms: float | None = None,
+        error: str | None = None,
     ) -> None:
-        self.decisions.append(Decision(
-            timestamp=datetime.now(),
-            agent=self.name,
-            trigger=trigger,
-            trigger_detail=trigger_detail,
-            tool_calls=tool_calls or [],
-            response_text=response_text,
-            context_summary=context_summary,
-            recent_event_ids=recent_event_ids or [],
-            prompt_hash=prompt_hash,
-            duration_ms=duration_ms,
-            error=error,
-        ))
+        self.decisions.append(
+            Decision(
+                timestamp=datetime.now(),
+                agent=self.name,
+                trigger=trigger,
+                trigger_detail=trigger_detail,
+                tool_calls=tool_calls or [],
+                response_text=response_text,
+                context_summary=context_summary,
+                recent_event_ids=recent_event_ids or [],
+                prompt_hash=prompt_hash,
+                duration_ms=duration_ms,
+                error=error,
+            )
+        )
 
 
 class NoOpCandidate(OrchestratorCandidate):
@@ -109,8 +109,7 @@ class NoOpCandidate(OrchestratorCandidate):
     candidate evolves from.
     """
 
-    def __init__(self, name: str, decisions: DecisionLog,
-                 *, watch: Optional[List[str]] = None):
+    def __init__(self, name: str, decisions: DecisionLog, *, watch: list[str] | None = None):
         super().__init__(name, decisions)
         # Optional whitelist of event_type names to react to. None = all.
         self._watch = set(watch) if watch else None
@@ -142,8 +141,8 @@ class ShadowRunner:
 
     def __init__(self, bus: EventBus):
         self.bus = bus
-        self._candidates: List[OrchestratorCandidate] = []
-        self._unsub: Optional[Callable[[], None]] = None
+        self._candidates: list[OrchestratorCandidate] = []
+        self._unsub: Callable[[], None] | None = None
         self._lock = threading.RLock()
         self._running = False
 
@@ -154,9 +153,7 @@ def add(self, candidate: OrchestratorCandidate) -> None:
                 try:
                     candidate.on_start()
                 except Exception:
-                    logger.exception(
-                        "ShadowRunner: on_start failed for %s", candidate.name
-                    )
+                    logger.exception("ShadowRunner: on_start failed for %s", candidate.name)
 
     def remove(self, candidate: OrchestratorCandidate) -> None:
         with self._lock:
@@ -167,9 +164,7 @@ def remove(self, candidate: OrchestratorCandidate) -> None:
             try:
                 candidate.on_stop()
             except Exception:
-                logger.exception(
-                    "ShadowRunner: on_stop failed for %s", candidate.name
-                )
+                logger.exception("ShadowRunner: on_stop failed for %s", candidate.name)
 
     def start(self) -> None:
         """Subscribe to the bus and notify every candidate. Idempotent."""
@@ -181,13 +176,9 @@ def start(self) -> None:
                 try:
                     c.on_start()
                 except Exception:
-                    logger.exception(
-                        "ShadowRunner: on_start failed for %s", c.name
-                    )
+                    logger.exception("ShadowRunner: on_start failed for %s", c.name)
             self._running = True
-        logger.info(
-            "ShadowRunner: started with %d candidate(s)", len(self._candidates)
-        )
+        logger.info("ShadowRunner: started with %d candidate(s)", len(self._candidates))
 
     def stop(self) -> None:
         """Unsubscribe from the bus and notify every candidate. Idempotent."""
@@ -204,14 +195,12 @@ def stop(self) -> None:
                 try:
                     c.on_stop()
                 except Exception:
-                    logger.exception(
-                        "ShadowRunner: on_stop failed for %s", c.name
-                    )
+                    logger.exception("ShadowRunner: on_stop failed for %s", c.name)
             self._running = False
         logger.info("ShadowRunner: stopped")
 
     @property
-    def candidates(self) -> List[OrchestratorCandidate]:
+    def candidates(self) -> list[OrchestratorCandidate]:
         with self._lock:
             return list(self._candidates)
 
@@ -225,5 +214,6 @@ def _on_event(self, event: Event) -> None:
             except Exception:
                 logger.exception(
                     "ShadowRunner: candidate %s raised on %s",
-                    c.name, event,
+                    c.name,
+                    event,
                 )
diff --git a/gently/exceptions.py b/gently/exceptions.py
index cfa4aeec..11b3fc83 100644
--- a/gently/exceptions.py
+++ b/gently/exceptions.py
@@ -29,98 +29,137 @@
 
 class GentlyError(Exception):
     """Base exception for all Gently errors."""
+
     pass
 
 
 class HardwareError(GentlyError):
     """Physical device communication failure."""
+
     pass
 
+
 class DeviceNotFoundError(HardwareError):
     """A requested device was not found in the hardware configuration."""
+
     pass
 
+
 class DeviceTimeoutError(HardwareError):
     """Device operation timed out."""
+
     pass
 
+
 class StageMovementError(HardwareError):
     """Stage movement failed or was out of range."""
+
     pass
 
+
 class AcquisitionError(HardwareError):
     """Image or volume acquisition failed."""
+
     pass
 
 
 class CalibrationError(GentlyError):
     """Piezo-galvo calibration failure."""
+
     pass
 
+
 class FocusFitError(CalibrationError):
     """Focus curve fitting failed (bad R², insufficient data, etc.)."""
+
     pass
 
+
 class EdgeDetectionError(CalibrationError):
     """Embryo edge detection failed (VLM couldn't find boundary)."""
+
     pass
 
+
 class CalibrationQualityError(CalibrationError):
     """Calibration quality below acceptable threshold."""
+
     pass
 
 
 class PerceptionError(GentlyError):
     """VLM perception/classification failure."""
+
     pass
 
+
 class StageClassificationError(PerceptionError):
     """Could not classify developmental stage."""
+
     pass
 
+
 class VerificationError(PerceptionError):
     """Verification subagent disagreed or failed."""
+
     pass
 
 
 class StorageError(GentlyError):
     """Data persistence failure."""
+
     pass
 
+
 class SessionNotFoundError(StorageError):
     """Requested session does not exist."""
+
     pass
 
+
 class VolumeNotFoundError(StorageError):
     """Requested volume does not exist."""
+
     pass
 
 
 class NetworkError(GentlyError):
     """Inter-service communication failure."""
+
     pass
 
+
 class DeviceLayerError(NetworkError):
     """Device layer HTTP API returned an error."""
+
     pass
 
+
 class MeshPeerError(NetworkError):
     """Mesh peer communication failed."""
+
     pass
 
+
 class ServiceUnavailableError(NetworkError):
     """Required service is not running."""
+
     pass
 
 
 class AgentError(GentlyError):
     """Agent/conversation failure."""
+
     pass
 
+
 class ToolExecutionError(AgentError):
     """A tool call failed during execution."""
+
     pass
 
+
 class PlanSynthesisError(AgentError):
     """Plan synthesis (natural language → Bluesky plan) failed."""
+
     pass
diff --git a/gently/gently.py b/gently/gently.py
index 788a5c17..a901e69a 100644
--- a/gently/gently.py
+++ b/gently/gently.py
@@ -32,31 +32,30 @@
     result = await gently.analyze(volume, pipeline="embryo_detection")
 """
 
-import asyncio
 import logging
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
+from .analysis import (
+    Pipeline,
+    PipelineBuilder,
+    create_embryo_detection_pipeline,
+    create_hatching_detection_pipeline,
+    create_morphology_analysis_pipeline,
+)
 from .core import (
     EventBus,
     EventType,
-    ServiceRegistry,
     ServiceClient,
     ServiceInfo,
+    ServiceRegistry,
     get_event_bus,
     get_service_registry,
 )
-from .log_config import configure_logging
-from .settings import settings
 from .core.file_store import FileStore
 from .harness.tools.registry import ToolRegistry, get_tool_registry
-from .analysis import (
-    Pipeline,
-    PipelineBuilder,
-    create_embryo_detection_pipeline,
-    create_hatching_detection_pipeline,
-    create_morphology_analysis_pipeline,
-)
+from .log_config import configure_logging
+from .settings import settings
 
 logger = logging.getLogger(__name__)
 
@@ -99,16 +98,16 @@ def __init__(
         self._store = FileStore(self.storage_path)
 
         # Current session ID (set by start_session or resume_session)
-        self._current_session_id: Optional[str] = None
+        self._current_session_id: str | None = None
 
         # Initialize tool registry
         self._tools = get_tool_registry()
 
         # Pre-built pipelines
-        self._pipelines: Dict[str, Pipeline] = {
-            'embryo_detection': create_embryo_detection_pipeline(),
-            'hatching_detection': create_hatching_detection_pipeline(),
-            'morphology_analysis': create_morphology_analysis_pipeline(),
+        self._pipelines: dict[str, Pipeline] = {
+            "embryo_detection": create_embryo_detection_pipeline(),
+            "hatching_detection": create_hatching_detection_pipeline(),
+            "morphology_analysis": create_morphology_analysis_pipeline(),
         }
 
         # Agent instance (lazy loaded)
@@ -131,21 +130,21 @@ def _register_standard_services(self):
                 service_type="rpc",
                 host="localhost",
                 port=18861,
-                metadata={'description': 'Main microscope control server'},
+                metadata={"description": "Main microscope control server"},
             ),
             ServiceInfo(
                 name="sam_server",
                 service_type="rpc",
                 host="localhost",
                 port=18862,
-                metadata={'description': 'SAM segmentation server'},
+                metadata={"description": "SAM segmentation server"},
             ),
             ServiceInfo(
                 name="queue_server",
                 service_type="http",
                 host="localhost",
                 port=settings.network.device_port,
-                metadata={'description': 'Bluesky queue server'},
+                metadata={"description": "Bluesky queue server"},
             ),
         ]
 
@@ -182,7 +181,7 @@ def tools(self) -> ToolRegistry:
         return self._tools
 
     @property
-    def pipelines(self) -> Dict[str, Pipeline]:
+    def pipelines(self) -> dict[str, Pipeline]:
         """Access pre-built pipelines"""
         return self._pipelines
 
@@ -192,8 +191,8 @@ def pipelines(self) -> Dict[str, Pipeline]:
 
     async def start_session(
         self,
-        name: Optional[str] = None,
-        description: Optional[str] = None,
+        name: str | None = None,
+        description: str | None = None,
     ) -> str:
         """
         Start a new session
@@ -211,13 +210,14 @@ async def start_session(
             Session ID
         """
         import uuid
+
         session_id = str(uuid.uuid4())[:8]
         self._store.create_session(session_id, name=name)
         self._current_session_id = session_id
 
         self._event_bus.publish(
             EventType.SESSION_STARTED,
-            {'session_id': session_id, 'name': name},
+            {"session_id": session_id, "name": name},
             source="gently",
         )
 
@@ -243,14 +243,14 @@ async def resume_session(self, session_id: str) -> bool:
             self._current_session_id = session_id
             self._event_bus.publish(
                 EventType.SESSION_RESTORED,
-                {'session_id': session_id},
+                {"session_id": session_id},
                 source="gently",
             )
             logger.info(f"Resumed session: {session_id}")
             return True
         return False
 
-    def list_sessions(self) -> List[Dict]:
+    def list_sessions(self) -> list[dict]:
         """List available sessions"""
         return self._store.list_sessions()
 
@@ -285,7 +285,7 @@ async def connect_microscope(
             info.port = port
 
         try:
-            conn = await self._client.connect("microscope_server")
+            await self._client.connect("microscope_server")
             logger.info(f"Connected to microscope server at {host}:{port}")
             return True
         except Exception as e:
@@ -318,7 +318,7 @@ async def connect_sam_server(
             info.port = port
 
         try:
-            conn = await self._client.connect("sam_server")
+            await self._client.connect("sam_server")
             logger.info(f"Connected to SAM server at {host}:{port}")
             return True
         except Exception as e:
@@ -333,7 +333,7 @@ async def analyze(
         self,
         data: Any,
         pipeline: str = "embryo_detection",
-        context: Optional[Dict] = None,
+        context: dict | None = None,
     ) -> Any:
         """
         Run analysis pipeline on data
@@ -353,8 +353,9 @@ async def analyze(
             Pipeline result with lineage tracking
         """
         if pipeline not in self._pipelines:
-            raise ValueError(f"Unknown pipeline: {pipeline}. "
-                           f"Available: {list(self._pipelines.keys())}")
+            raise ValueError(
+                f"Unknown pipeline: {pipeline}. Available: {list(self._pipelines.keys())}"
+            )
 
         pipe = self._pipelines[pipeline]
 
@@ -363,9 +364,9 @@ async def analyze(
         self._event_bus.publish(
             EventType.ANALYSIS_COMPLETED,
             {
-                'pipeline': pipeline,
-                'result_uid': result.uid,
-                'success': result.success,
+                "pipeline": pipeline,
+                "result_uid": result.uid,
+                "success": result.success,
             },
             source="gently",
         )
@@ -414,7 +415,7 @@ def on(self, event_type: EventType, handler):
         """
         return self._event_bus.subscribe(event_type, handler)
 
-    def emit(self, event_type: EventType, data: Dict):
+    def emit(self, event_type: EventType, data: dict):
         """Emit an event"""
         self._event_bus.publish(event_type, data, source="gently")
 
@@ -438,10 +439,9 @@ def get_agent(self, **kwargs):
         """
         if self._agent is None:
             from .app.agent import MicroscopyAgent
+
             self._agent = MicroscopyAgent(
-                storage_path=self.storage_path,
-                store=self._store,
-                **kwargs
+                storage_path=self.storage_path, store=self._store, **kwargs
             )
         return self._agent
 
@@ -465,6 +465,7 @@ async def start_visualization_server(self, port: int = settings.network.viz_port
         """
         if self._viz_server is None:
             from .ui.web.server import VisualizationServer
+
             self._viz_server = VisualizationServer(
                 port=port,
                 data_store=None,  # Legacy DataStore removed; viz uses event bus
@@ -479,7 +480,7 @@ async def push_image(
         array,
         uid: str,
         data_type: str = "image",
-        metadata: Optional[Dict] = None,
+        metadata: dict | None = None,
     ):
         """
         Push an image to the visualization server
@@ -520,7 +521,7 @@ async def shutdown(self):
         if self._current_session_id:
             self._event_bus.publish(
                 EventType.SESSION_ENDED,
-                {'session_id': self._current_session_id},
+                {"session_id": self._current_session_id},
                 source="gently",
             )
 
diff --git a/gently/hardware/__init__.py b/gently/hardware/__init__.py
index c8886da7..4ae505f9 100644
--- a/gently/hardware/__init__.py
+++ b/gently/hardware/__init__.py
@@ -16,18 +16,19 @@
 import logging
 import pkgutil
 from types import ModuleType
-from typing import List, Optional
 
 logger = logging.getLogger(__name__)
 
-_active_hardware: Optional[ModuleType] = None
+_active_hardware: ModuleType | None = None
 
 
-def available_hardware() -> List[str]:
+def available_hardware() -> list[str]:
     """Names of the hardware plugins shipped under gently.hardware."""
     import gently.hardware as _pkg
+
     return sorted(
-        m.name for m in pkgutil.iter_modules(_pkg.__path__)
+        m.name
+        for m in pkgutil.iter_modules(_pkg.__path__)
         if m.ispkg and not m.name.startswith("_")
     )
 
@@ -81,7 +82,6 @@ def get_hardware() -> ModuleType:
     """
     if _active_hardware is None:
         raise RuntimeError(
-            "No hardware loaded. Call load_hardware() at startup, "
-            "or set 'hardware' in config.yml."
+            "No hardware loaded. Call load_hardware() at startup, or set 'hardware' in config.yml."
         )
     return _active_hardware
diff --git a/gently/hardware/console_ui.py b/gently/hardware/console_ui.py
index abc8ca64..60e8dfff 100644
--- a/gently/hardware/console_ui.py
+++ b/gently/hardware/console_ui.py
@@ -20,6 +20,7 @@
 * ``out()`` is defensive: any residual ``UnicodeEncodeError`` is caught and the
   line re-emitted with ``errors="replace"`` rather than crashing startup.
 """
+
 from __future__ import annotations
 
 import os
@@ -112,7 +113,7 @@ def out(text: str = "") -> None:
     try:
         print(text, flush=True)
     except UnicodeEncodeError:
-        enc = (getattr(sys.stdout, "encoding", None) or "ascii")
+        enc = getattr(sys.stdout, "encoding", None) or "ascii"
         sys.stdout.write(text.encode(enc, "replace").decode(enc, "replace") + "\n")
         sys.stdout.flush()
 
@@ -162,8 +163,9 @@ def bullet(text: str) -> None:
     out(f"    {c(_BULLET, 'cyan')} {text}")
 
 
-def error_panel(title: str, summary: str, details: str | None = None,
-                hints=None, log_file=None) -> None:
+def error_panel(
+    title: str, summary: str, details: str | None = None, hints=None, log_file=None
+) -> None:
     """A red FAILED panel: one-line summary, optional detail, fix hints, log path.
 
     Used at the top-level startup catch so an operator sees a plain-language
diff --git a/gently/hardware/dispim/__init__.py b/gently/hardware/dispim/__init__.py
index 9d479325..9337a79d 100644
--- a/gently/hardware/dispim/__init__.py
+++ b/gently/hardware/dispim/__init__.py
@@ -7,6 +7,16 @@
 
 from .description import HARDWARE_DESCRIPTION
 
+__all__ = [
+    "HARDWARE_DESCRIPTION",
+    "HARDWARE_NAME",
+    "HARDWARE_DISPLAY_NAME",
+    "CAPABILITIES",
+    "create_device_layer",
+    "create_client",
+    "create_microscope",
+]
+
 HARDWARE_NAME = "dispim"
 HARDWARE_DISPLAY_NAME = "diSPIM"
 CAPABILITIES = {
@@ -35,9 +45,10 @@ def create_device_layer(config: dict):
         The server instance (call .run(port=N) to start)
     """
     from .device_layer import DeviceLayerServer
+
     return DeviceLayerServer(
-        config_path=config.get('config_path', 'config/config.yml'),
-        sam_device=config.get('sam_device', 'cuda'),
+        config_path=config.get("config_path", "config/config.yml"),
+        sam_device=config.get("sam_device", "cuda"),
     )
 
 
@@ -55,6 +66,7 @@ def create_client(http_url: str):
         The microscope instance (call .connect() before use)
     """
     from .client import DiSPIMMicroscope
+
     return DiSPIMMicroscope(http_url=http_url)
 
 
diff --git a/gently/hardware/dispim/calibration.py b/gently/hardware/dispim/calibration.py
index a45d0b21..a13a6d1b 100644
--- a/gently/hardware/dispim/calibration.py
+++ b/gently/hardware/dispim/calibration.py
@@ -12,7 +12,6 @@
 
 from dataclasses import dataclass
 from datetime import datetime
-from typing import Dict, Optional
 
 
 @dataclass
@@ -24,13 +23,14 @@ class CalibrationPrior:
     time by using cross-embryo learning. The prior is updated after each
     successful calibration using an exponential moving average.
     """
+
     # Linear relationship: piezo = slope * galvo + offset
     slope_um_per_deg: float = 100.0  # Default heuristic
     offset_um: float = 0.0
 
     # Confidence metrics
     r_squared_mean: float = 0.0  # Average R-squared from contributing calibrations
-    num_calibrations: int = 0    # Number of embryos contributing to prior
+    num_calibrations: int = 0  # Number of embryos contributing to prior
 
     # Observed ranges (for adaptive sweep window sizing)
     slope_min: float = 90.0
@@ -39,15 +39,15 @@ class CalibrationPrior:
     offset_max: float = 20.0
 
     # Edge detection statistics
-    typical_extent_deg: float = 0.3   # Average embryo Z extent in degrees
-    extent_std_deg: float = 0.1       # Variation in extent
+    typical_extent_deg: float = 0.3  # Average embryo Z extent in degrees
+    extent_std_deg: float = 0.1  # Variation in extent
 
     # Timestamp for staleness checking
-    last_updated: Optional[datetime] = None
+    last_updated: datetime | None = None
 
     # Fast calibration: lock slope after first embryo bootstrap
     session_slope_locked: bool = False
-    bootstrap_embryo_id: Optional[str] = None  # Which embryo established the slope
+    bootstrap_embryo_id: str | None = None  # Which embryo established the slope
 
     def lock_session_slope(self, slope: float, r_squared: float, embryo_id: str):
         """
@@ -82,7 +82,7 @@ def update_from_calibration(
         offset: float,
         r_squared: float,
         extent_deg: float,
-        alpha: float = 0.3
+        alpha: float = 0.3,
     ):
         """
         Update prior with new calibration result using exponential moving average.
@@ -122,41 +122,41 @@ def update_from_calibration(
         self.num_calibrations += 1
         self.last_updated = datetime.now()
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize for JSON storage"""
         return {
-            'slope_um_per_deg': self.slope_um_per_deg,
-            'offset_um': self.offset_um,
-            'r_squared_mean': self.r_squared_mean,
-            'num_calibrations': self.num_calibrations,
-            'slope_min': self.slope_min,
-            'slope_max': self.slope_max,
-            'offset_min': self.offset_min,
-            'offset_max': self.offset_max,
-            'typical_extent_deg': self.typical_extent_deg,
-            'extent_std_deg': self.extent_std_deg,
-            'last_updated': self.last_updated.isoformat() if self.last_updated else None,
-            'session_slope_locked': self.session_slope_locked,
-            'bootstrap_embryo_id': self.bootstrap_embryo_id,
+            "slope_um_per_deg": self.slope_um_per_deg,
+            "offset_um": self.offset_um,
+            "r_squared_mean": self.r_squared_mean,
+            "num_calibrations": self.num_calibrations,
+            "slope_min": self.slope_min,
+            "slope_max": self.slope_max,
+            "offset_min": self.offset_min,
+            "offset_max": self.offset_max,
+            "typical_extent_deg": self.typical_extent_deg,
+            "extent_std_deg": self.extent_std_deg,
+            "last_updated": self.last_updated.isoformat() if self.last_updated else None,
+            "session_slope_locked": self.session_slope_locked,
+            "bootstrap_embryo_id": self.bootstrap_embryo_id,
         }
 
     @classmethod
-    def from_dict(cls, data: Dict) -> 'CalibrationPrior':
+    def from_dict(cls, data: dict) -> "CalibrationPrior":
         """Deserialize from JSON"""
         prior = cls(
-            slope_um_per_deg=data.get('slope_um_per_deg', 100.0),
-            offset_um=data.get('offset_um', 0.0),
-            r_squared_mean=data.get('r_squared_mean', 0.0),
-            num_calibrations=data.get('num_calibrations', 0),
-            slope_min=data.get('slope_min', 90.0),
-            slope_max=data.get('slope_max', 110.0),
-            offset_min=data.get('offset_min', -20.0),
-            offset_max=data.get('offset_max', 20.0),
-            typical_extent_deg=data.get('typical_extent_deg', 0.3),
-            extent_std_deg=data.get('extent_std_deg', 0.1),
-            session_slope_locked=data.get('session_slope_locked', False),
-            bootstrap_embryo_id=data.get('bootstrap_embryo_id'),
+            slope_um_per_deg=data.get("slope_um_per_deg", 100.0),
+            offset_um=data.get("offset_um", 0.0),
+            r_squared_mean=data.get("r_squared_mean", 0.0),
+            num_calibrations=data.get("num_calibrations", 0),
+            slope_min=data.get("slope_min", 90.0),
+            slope_max=data.get("slope_max", 110.0),
+            offset_min=data.get("offset_min", -20.0),
+            offset_max=data.get("offset_max", 20.0),
+            typical_extent_deg=data.get("typical_extent_deg", 0.3),
+            extent_std_deg=data.get("extent_std_deg", 0.1),
+            session_slope_locked=data.get("session_slope_locked", False),
+            bootstrap_embryo_id=data.get("bootstrap_embryo_id"),
         )
-        if data.get('last_updated'):
-            prior.last_updated = datetime.fromisoformat(data['last_updated'])
+        if data.get("last_updated"):
+            prior.last_updated = datetime.fromisoformat(data["last_updated"])
         return prior
diff --git a/gently/hardware/dispim/claude_client.py b/gently/hardware/dispim/claude_client.py
index 722add7f..1998dfbe 100644
--- a/gently/hardware/dispim/claude_client.py
+++ b/gently/hardware/dispim/claude_client.py
@@ -18,18 +18,19 @@
 import base64
 import os
 from pathlib import Path
-from typing import Optional, Tuple, Dict
+
 import anthropic
 
 from gently.settings import settings
+
 from .plans.calibration import EMBRYO_CENTERING_PROMPT, EMBRYO_EDGE_PROMPT
 
 _MEDIA_TYPE_MAP = {
-    '.png': 'image/png',
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.gif': 'image/gif',
-    '.webp': 'image/webp',
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
 }
 
 
@@ -37,6 +38,7 @@
 # ASYNC CLAUDE CLIENT
 # ============================================================================
 
+
 class AsyncClaudeClient:
     """
     Async Claude API client for embryo calibration workflows.
@@ -65,14 +67,14 @@ class AsyncClaudeClient:
 
     def __init__(
         self,
-        api_key: Optional[str] = None,
+        api_key: str | None = None,
         model: str = settings.models.perception,
         max_tokens: int = 100,
-        timeout: float = 30.0
+        timeout: float = 30.0,
     ):
         """Initialize async Claude client."""
         if api_key is None:
-            api_key = os.environ.get('ANTHROPIC_API_KEY')
+            api_key = os.environ.get("ANTHROPIC_API_KEY")
             if api_key is None:
                 raise ValueError(
                     "ANTHROPIC_API_KEY not found in environment. "
@@ -99,12 +101,12 @@ def encode_image(image_path: Path) -> str:
         str
             Base64-encoded image data
         """
-        with open(image_path, 'rb') as f:
+        with open(image_path, "rb") as f:
             image_data = f.read()
-        return base64.standard_b64encode(image_data).decode('utf-8')
+        return base64.standard_b64encode(image_data).decode("utf-8")
 
     @staticmethod
-    def parse_yes_no_response(response_text: str) -> Tuple[bool, str]:
+    def parse_yes_no_response(response_text: str) -> tuple[bool, str]:
         """
         Parse Claude's yes/no response format.
 
@@ -124,14 +126,14 @@ def parse_yes_no_response(response_text: str) -> Tuple[bool, str]:
         str
             Description from remaining lines
         """
-        lines = response_text.strip().split('\n', 1)
+        lines = response_text.strip().split("\n", 1)
 
         if len(lines) == 0:
             return False, "Empty response"
 
         # Parse first line for yes/no
         first_line = lines[0].strip().lower()
-        is_yes = 'yes' in first_line
+        is_yes = "yes" in first_line
 
         # Get description from remaining lines
         description = lines[1].strip() if len(lines) > 1 else "No description provided"
@@ -139,10 +141,8 @@ def parse_yes_no_response(response_text: str) -> Tuple[bool, str]:
         return is_yes, description
 
     async def check_embryo_centered(
-        self,
-        image_path: Path,
-        custom_prompt: Optional[str] = None
-    ) -> Tuple[bool, str]:
+        self, image_path: Path, custom_prompt: str | None = None
+    ) -> tuple[bool, str]:
         """
         Check if embryo is centered and visible in image.
 
@@ -179,7 +179,7 @@ async def check_embryo_centered(
         image_data = self.encode_image(image_path)
 
         # Get media type from file extension
-        media_type = _MEDIA_TYPE_MAP.get(image_path.suffix.lower(), 'image/png')
+        media_type = _MEDIA_TYPE_MAP.get(image_path.suffix.lower(), "image/png")
 
         # Prepare prompt
         prompt = custom_prompt if custom_prompt else EMBRYO_CENTERING_PROMPT
@@ -190,25 +190,24 @@ async def check_embryo_centered(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=self.max_tokens,
-                    messages=[{
-                        "role": "user",
-                        "content": [
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": media_type,
-                                    "data": image_data
-                                }
-                            },
-                            {
-                                "type": "text",
-                                "text": prompt
-                            }
-                        ]
-                    }]
+                    messages=[
+                        {
+                            "role": "user",
+                            "content": [
+                                {
+                                    "type": "image",
+                                    "source": {
+                                        "type": "base64",
+                                        "media_type": media_type,
+                                        "data": image_data,
+                                    },
+                                },
+                                {"type": "text", "text": prompt},
+                            ],
+                        }
+                    ],
                 ),
-                timeout=self.timeout
+                timeout=self.timeout,
             )
 
             # Extract text response
@@ -225,10 +224,8 @@ async def check_embryo_centered(
             return False, f"Claude API error: {str(e)}"
 
     async def detect_embryo_presence(
-        self,
-        image_path: Path,
-        custom_prompt: Optional[str] = None
-    ) -> Tuple[bool, int, str]:
+        self, image_path: Path, custom_prompt: str | None = None
+    ) -> tuple[bool, int, str]:
         """
         Detect if embryo is present at current Z position (for edge detection).
 
@@ -271,7 +268,7 @@ async def detect_embryo_presence(
         image_data = self.encode_image(image_path)
 
         # Get media type
-        media_type = _MEDIA_TYPE_MAP.get(image_path.suffix.lower(), 'image/png')
+        media_type = _MEDIA_TYPE_MAP.get(image_path.suffix.lower(), "image/png")
 
         # Prepare prompt
         prompt = custom_prompt if custom_prompt else EMBRYO_EDGE_PROMPT
@@ -282,35 +279,34 @@ async def detect_embryo_presence(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=self.max_tokens,
-                    messages=[{
-                        "role": "user",
-                        "content": [
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": media_type,
-                                    "data": image_data
-                                }
-                            },
-                            {
-                                "type": "text",
-                                "text": prompt
-                            }
-                        ]
-                    }]
+                    messages=[
+                        {
+                            "role": "user",
+                            "content": [
+                                {
+                                    "type": "image",
+                                    "source": {
+                                        "type": "base64",
+                                        "media_type": media_type,
+                                        "data": image_data,
+                                    },
+                                },
+                                {"type": "text", "text": prompt},
+                            ],
+                        }
+                    ],
                 ),
-                timeout=self.timeout
+                timeout=self.timeout,
             )
 
             # Extract text response
             response_text = response.content[0].text
 
             # Parse response - now 3 lines: yes/no, score, description
-            lines = response_text.strip().split('\n')
+            lines = response_text.strip().split("\n")
 
             # Line 1: yes/no
-            is_present = 'yes' in lines[0].lower() if lines else False
+            is_present = "yes" in lines[0].lower() if lines else False
 
             # Line 2: feature score (1-10)
             feature_score = 0
@@ -320,14 +316,15 @@ async def detect_embryo_presence(
                     score_line = lines[1].strip()
                     # Handle cases like "8" or "Score: 8" or "8/10"
                     import re
-                    match = re.search(r'\d+', score_line)
+
+                    match = re.search(r"\d+", score_line)
                     if match:
                         feature_score = min(10, max(0, int(match.group())))
                 except (ValueError, IndexError):
                     feature_score = 5 if is_present else 0  # Default
 
             # Line 3+: description
-            description = '\n'.join(lines[2:]).strip() if len(lines) > 2 else "No description"
+            description = "\n".join(lines[2:]).strip() if len(lines) > 2 else "No description"
 
             # If not present, ensure score is 0
             if not is_present:
@@ -344,8 +341,8 @@ async def validate_focus_montage(
         self,
         montage_path: Path,
         selected_position_um: float,
-        prompt_template: Optional[str] = None
-    ) -> Tuple[str, str]:
+        prompt_template: str | None = None,
+    ) -> tuple[str, str]:
         """
         Validate algorithmic focus selection by analyzing montage.
 
@@ -384,9 +381,11 @@ async def validate_focus_montage(
 
         # Default validation prompt
         if prompt_template is None:
-            prompt_template = """You are an expert microscopist reviewing focus quality in embryo images.
+            prompt_template = """You are an expert microscopist reviewing focus quality in
+embryo images.
 
-This montage shows a focus sweep through an embryo sample. Each panel is labeled with its Z position in micrometers.
+This montage shows a focus sweep through an embryo sample. Each panel is labeled with its
+Z position in micrometers.
 
 Our FFT-based algorithm selected position: {position:.2f} µm as optimal focus.
 
@@ -412,7 +411,7 @@ async def validate_focus_montage(
 
         # Encode image
         image_data = self.encode_image(montage_path)
-        media_type = 'image/png'
+        media_type = "image/png"
 
         try:
             # Make async API call
@@ -420,41 +419,40 @@ async def validate_focus_montage(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=150,  # Slightly longer for reasoning
-                    messages=[{
-                        "role": "user",
-                        "content": [
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": media_type,
-                                    "data": image_data
-                                }
-                            },
-                            {
-                                "type": "text",
-                                "text": prompt
-                            }
-                        ]
-                    }]
+                    messages=[
+                        {
+                            "role": "user",
+                            "content": [
+                                {
+                                    "type": "image",
+                                    "source": {
+                                        "type": "base64",
+                                        "media_type": media_type,
+                                        "data": image_data,
+                                    },
+                                },
+                                {"type": "text", "text": prompt},
+                            ],
+                        }
+                    ],
                 ),
-                timeout=self.timeout
+                timeout=self.timeout,
             )
 
             # Extract response
             response_text = response.content[0].text
-            lines = response_text.strip().split('\n', 1)
+            lines = response_text.strip().split("\n", 1)
 
             decision = lines[0].strip().upper()
             reasoning = lines[1].strip() if len(lines) > 1 else "No reasoning provided"
 
             # Normalize decision
-            if 'CONFIRM' in decision:
-                decision = 'CONFIRM'
-            elif 'REJECT' in decision:
-                decision = 'REJECT'
+            if "CONFIRM" in decision:
+                decision = "CONFIRM"
+            elif "REJECT" in decision:
+                decision = "REJECT"
             else:
-                decision = 'REJECT'  # Default to reject if unclear
+                decision = "REJECT"  # Default to reject if unclear
                 reasoning = f"Unclear response: {decision}. {reasoning}"
 
             return decision, reasoning
@@ -468,8 +466,8 @@ async def select_best_focus(
         self,
         montage_path: Path,
         offsets: list[float],
-        labels: Optional[list[str]] = None
-    ) -> Tuple[int, str, str]:
+        labels: list[str] | None = None,
+    ) -> tuple[int, str, str]:
         """
         Select the best-focused image from a montage using Vision.
 
@@ -506,16 +504,14 @@ async def select_best_focus(
         montage_path = Path(montage_path)
 
         if not montage_path.exists():
-            return 1, 'B', f"Montage file not found, defaulting to center"
+            return 1, "B", "Montage file not found, defaulting to center"
 
         # Default labels
         if labels is None:
-            labels = [chr(ord('A') + i) for i in range(len(offsets))]
+            labels = [chr(ord("A") + i) for i in range(len(offsets))]
 
         # Build offset description for prompt
-        offset_desc = ", ".join(
-            f"{labels[i]}={offsets[i]:+.1f}µm" for i in range(len(offsets))
-        )
+        offset_desc = ", ".join(f"{labels[i]}={offsets[i]:+.1f}µm" for i in range(len(offsets)))
 
         prompt = f"""You are an expert microscopist comparing focus quality in embryo images.
 
@@ -529,7 +525,7 @@ async def select_best_focus(
 - Best overall image clarity and contrast
 
 RESPOND FORMAT:
-Line 1: Just the letter ({', '.join(labels)})
+Line 1: Just the letter ({", ".join(labels)})
 Line 2: Brief reasoning (1 sentence)
 
 Example:
@@ -538,37 +534,36 @@ async def select_best_focus(
 
         # Encode image
         image_data = self.encode_image(montage_path)
-        media_type = 'image/png'
+        media_type = "image/png"
 
         try:
             response = await asyncio.wait_for(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=100,
-                    messages=[{
-                        "role": "user",
-                        "content": [
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": media_type,
-                                    "data": image_data
-                                }
-                            },
-                            {
-                                "type": "text",
-                                "text": prompt
-                            }
-                        ]
-                    }]
+                    messages=[
+                        {
+                            "role": "user",
+                            "content": [
+                                {
+                                    "type": "image",
+                                    "source": {
+                                        "type": "base64",
+                                        "media_type": media_type,
+                                        "data": image_data,
+                                    },
+                                },
+                                {"type": "text", "text": prompt},
+                            ],
+                        }
+                    ],
                 ),
-                timeout=self.timeout
+                timeout=self.timeout,
             )
 
             # Parse response
             response_text = response.content[0].text.strip()
-            lines = response_text.split('\n', 1)
+            lines = response_text.split("\n", 1)
 
             # Extract selected label (first non-empty character that's a valid label)
             selected = None
@@ -590,16 +585,25 @@ async def select_best_focus(
         except asyncio.TimeoutError:
             # Default to center on timeout
             center_idx = len(offsets) // 2
-            return center_idx, labels[center_idx], f"Claude API timeout, defaulting to center"
+            return (
+                center_idx,
+                labels[center_idx],
+                "Claude API timeout, defaulting to center",
+            )
         except Exception as e:
             center_idx = len(offsets) // 2
-            return center_idx, labels[center_idx], f"Claude API error: {str(e)}, defaulting to center"
+            return (
+                center_idx,
+                labels[center_idx],
+                f"Claude API error: {str(e)}, defaulting to center",
+            )
 
 
 # ============================================================================
 # SYNCHRONOUS WRAPPER FOR BACKWARDS COMPATIBILITY
 # ============================================================================
 
+
 class ClaudeClient:
     """
     Synchronous wrapper around AsyncClaudeClient for backwards compatibility.
@@ -612,19 +616,17 @@ def __init__(self, **kwargs):
         """Initialize sync client (wraps async client)."""
         self.async_client = AsyncClaudeClient(**kwargs)
 
-    def check_embryo_centered(self, image_path: Path) -> Tuple[bool, str]:
+    def check_embryo_centered(self, image_path: Path) -> tuple[bool, str]:
         """Sync version of check_embryo_centered."""
         return asyncio.run(self.async_client.check_embryo_centered(image_path))
 
-    def detect_embryo_presence(self, image_path: Path) -> Tuple[bool, int, str]:
+    def detect_embryo_presence(self, image_path: Path) -> tuple[bool, int, str]:
         """Sync version of detect_embryo_presence."""
         return asyncio.run(self.async_client.detect_embryo_presence(image_path))
 
     def validate_focus_montage(
-        self,
-        montage_path: Path,
-        selected_position_um: float
-    ) -> Tuple[str, str]:
+        self, montage_path: Path, selected_position_um: float
+    ) -> tuple[str, str]:
         """Sync version of validate_focus_montage."""
         return asyncio.run(
             self.async_client.validate_focus_montage(montage_path, selected_position_um)
diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 2490dc24..f44ff8db 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -8,22 +8,20 @@
 import asyncio
 import logging
 import traceback
-from typing import Any, Dict, List, Optional, Tuple
-import numpy as np
-import aiohttp
+from typing import Any
 
-logger = logging.getLogger(__name__)
+import aiohttp
+import numpy as np
 
 from gently.core.coordinates import (
-    pixel_to_stage_position,
-    stage_to_pixel_position,
-    get_um_per_pixel,
-    DEFAULT_PIXEL_SIZE_UM,
     DEFAULT_OBJECTIVE_MAG,
+    DEFAULT_PIXEL_SIZE_UM,
 )
+from gently.exceptions import DeviceLayerError, NetworkError
 from gently.harness.microscope import Microscope
 from gently.settings import settings
-from gently.exceptions import DeviceLayerError, NetworkError, AcquisitionError
+
+logger = logging.getLogger(__name__)
 
 
 class DiSPIMMicroscope(Microscope):
@@ -99,7 +97,7 @@ async def connect(self) -> bool:
                 async with self._session.get(f"{self.http_url}/api/sam/status") as resp:
                     if resp.status == 200:
                         sam_status = await resp.json()
-                        self._sam_available = sam_status.get('available', False)
+                        self._sam_available = sam_status.get("available", False)
             except aiohttp.ClientError:
                 self._sam_available = False
 
@@ -166,9 +164,7 @@ def has_sam(self) -> bool:
     def _ensure_connected(self):
         """Raise error if not connected"""
         if not self.is_connected:
-            raise ConnectionError(
-                "Not connected to Microscope Server. Call connect() first."
-            )
+            raise ConnectionError("Not connected to Microscope Server. Call connect() first.")
 
     # =========================================================================
     # Session Configuration (FileStore integration)
@@ -217,9 +213,10 @@ def _resolve_file_ref(ref: dict) -> tuple:
         -------
         tuple of (np.ndarray, Path)
         """
-        import tifffile
         from pathlib import Path
 
+        import tifffile
+
         path = Path(ref["path"])
         arr = tifffile.imread(str(path))
         return arr, path
@@ -268,9 +265,9 @@ async def _api_post(self, path: str, json: dict = None) -> dict:
     async def _submit_plan_and_wait(
         self,
         plan_name: str,
-        kwargs: Dict = None,
+        kwargs: dict = None,
         timeout: float = 120.0,
-    ) -> Dict:
+    ) -> dict:
         """Submit a Bluesky plan to the server and wait for completion.
 
         Parameters
@@ -300,37 +297,37 @@ async def _submit_plan_and_wait(
             async with self._session.post(
                 f"{self.http_url}/api/queue/item/add",
                 json=payload,
-                timeout=aiohttp.ClientTimeout(total=timeout)
+                timeout=aiohttp.ClientTimeout(total=timeout),
             ) as resp:
                 if resp.status != 200:
                     error_text = await resp.text()
                     return {
-                        'success': False,
-                        'error': f"HTTP {resp.status}: {error_text}",
+                        "success": False,
+                        "error": f"HTTP {resp.status}: {error_text}",
                     }
 
                 result = await resp.json()
 
                 # Resolve file references (zero-copy transfer)
                 if isinstance(result, dict):
-                    docs = result.get('documents', {})
-                    events = docs.get('events', [])
+                    docs = result.get("documents", {})
+                    events = docs.get("events", [])
                     for event in events:
-                        data = event.get('data', {})
+                        data = event.get("data", {})
                         for key, val in list(data.items()):
                             if self._is_file_ref(val):
                                 arr, path = self._resolve_file_ref(val)
                                 data[key] = arr
                                 # Store path for downstream use
-                                if 'volume_path' not in result:
-                                    result['volume_path'] = str(path)
+                                if "volume_path" not in result:
+                                    result["volume_path"] = str(path)
 
                 return result
 
         except asyncio.TimeoutError:
             return {
-                'success': False,
-                'error': f"Plan '{plan_name}' timed out after {timeout}s",
+                "success": False,
+                "error": f"Plan '{plan_name}' timed out after {timeout}s",
             }
         except aiohttp.ClientError as e:
             raise NetworkError(f"Device layer request failed: {e}") from e
@@ -339,7 +336,7 @@ async def _submit_plan_and_wait(
     # Stage Control
     # =========================================================================
 
-    async def move_to_position(self, x: float, y: float) -> Dict:
+    async def move_to_position(self, x: float, y: float) -> dict:
         """
         Move stage to absolute position.
 
@@ -351,16 +348,15 @@ async def move_to_position(self, x: float, y: float) -> Dict:
         logger.info("Moving to (%.1f, %.1f) µm", x, y)
 
         result = await self._submit_plan_and_wait(
-            'move_stage_plan',
-            kwargs={'xy_stage': 'xy_stage', 'x': x, 'y': y}
+            "move_stage_plan", kwargs={"xy_stage": "xy_stage", "x": x, "y": y}
         )
 
-        if result.get('success'):
-            return {'success': True, 'x': x, 'y': y}
+        if result.get("success"):
+            return {"success": True, "x": x, "y": y}
 
         return result
 
-    async def get_stage_position(self) -> Tuple[float, float]:
+    async def get_stage_position(self) -> tuple[float, float]:
         """
         Get current stage position.
 
@@ -369,21 +365,23 @@ async def get_stage_position(self) -> Tuple[float, float]:
         tuple of (float, float)
             Current (x, y) position in micrometers
         """
-        result = await self._submit_plan_and_wait('read_stage_plan', kwargs={'xy_stage': 'xy_stage'})
+        result = await self._submit_plan_and_wait(
+            "read_stage_plan", kwargs={"xy_stage": "xy_stage"}
+        )
 
-        if result.get('success'):
-            docs = result.get('documents', {})
-            events = docs.get('events', [])
+        if result.get("success"):
+            docs = result.get("documents", {})
+            events = docs.get("events", [])
             if events:
-                data = events[0].get('data', {})
+                data = events[0].get("data", {})
                 # Look for stage coordinates
-                for key in ['XY:31', 'xy_stage', 'stage']:
+                for key in ["XY:31", "xy_stage", "stage"]:
                     if key in data:
                         val = data[key]
                         if isinstance(val, (list, tuple)) and len(val) >= 2:
                             return (float(val[0]), float(val[1]))
                         if isinstance(val, dict):
-                            return (float(val.get('x', 0)), float(val.get('y', 0)))
+                            return (float(val.get("x", 0)), float(val.get("y", 0)))
 
         raise DeviceLayerError("Failed to read stage position")
 
@@ -396,20 +394,20 @@ async def get_piezo_position(self) -> float:
         float
             Current Z position in micrometers
         """
-        result = await self._submit_plan_and_wait('read_piezo_plan', kwargs={'piezo': 'piezo'})
+        result = await self._submit_plan_and_wait("read_piezo_plan", kwargs={"piezo": "piezo"})
 
-        if result.get('success'):
-            docs = result.get('documents', {})
-            events = docs.get('events', [])
+        if result.get("success"):
+            docs = result.get("documents", {})
+            events = docs.get("events", [])
             if events:
-                data = events[0].get('data', {})
-                for key in ['PiezoStage:P:34', 'piezo', 'z_stage']:
+                data = events[0].get("data", {})
+                for key in ["PiezoStage:P:34", "piezo", "z_stage"]:
                     if key in data:
                         val = data[key]
                         if isinstance(val, (int, float)):
                             return float(val)
                         if isinstance(val, dict):
-                            return float(val.get('z', val.get('position', 0)))
+                            return float(val.get("z", val.get("position", 0)))
 
         raise DeviceLayerError("Failed to read piezo position")
 
@@ -419,10 +417,10 @@ async def get_piezo_position(self) -> float:
 
     async def calibrate_piezo_galvo(
         self,
-        piezo_positions: Optional[List[float]] = None,
-        galvo_positions: Optional[List[float]] = None,
+        piezo_positions: list[float] | None = None,
+        galvo_positions: list[float] | None = None,
         **kwargs,
-    ) -> Dict:
+    ) -> dict:
         """
         Run piezo-galvo calibration plan.
 
@@ -431,23 +429,21 @@ async def calibrate_piezo_galvo(
         dict
             Calibration results with optimal positions
         """
-        plan_kwargs = {'lightsheet_snap': 'lightsheet_snap'}
+        plan_kwargs = {"lightsheet_snap": "lightsheet_snap"}
         if piezo_positions is not None:
-            plan_kwargs['piezo_positions'] = piezo_positions
+            plan_kwargs["piezo_positions"] = piezo_positions
         if galvo_positions is not None:
-            plan_kwargs['galvo_positions'] = galvo_positions
+            plan_kwargs["galvo_positions"] = galvo_positions
         plan_kwargs.update(kwargs)
 
         result = await self._submit_plan_and_wait(
-            'calibrate_piezo_galvo_plan',
-            kwargs=plan_kwargs,
-            timeout=300.0
+            "calibrate_piezo_galvo_plan", kwargs=plan_kwargs, timeout=300.0
         )
 
-        if result.get('success'):
+        if result.get("success"):
             return {
-                'success': True,
-                'calibration': result.get('calibration', {}),
+                "success": True,
+                "calibration": result.get("calibration", {}),
             }
 
         return result
@@ -456,22 +452,24 @@ async def calibrate_piezo_galvo(
     # Imaging
     # =========================================================================
 
-    def _extract_image(self, result: dict, candidate_keys: List[str], multi_event: bool = False) -> Optional[tuple]:
+    def _extract_image(
+        self, result: dict, candidate_keys: list[str], multi_event: bool = False
+    ) -> tuple | None:
         """Extract image array from plan result documents.
 
         Returns (array, path) or None if not found.
         """
-        if not result.get('success'):
+        if not result.get("success"):
             return None
 
-        docs = result.get('documents', {})
-        events = docs.get('events', [])
+        docs = result.get("documents", {})
+        events = docs.get("events", [])
         if not events:
             return None
 
         search_events = events if multi_event else [events[0]]
         for event in search_events:
-            data = event.get('data', {})
+            data = event.get("data", {})
             for key in candidate_keys:
                 if key in data:
                     val = data[key]
@@ -484,11 +482,11 @@ def _extract_image(self, result: dict, candidate_keys: List[str], multi_event: b
 
     async def capture_lightsheet_image(
         self,
-        piezo_position: Optional[float] = None,
-        galvo_position: Optional[float] = None,
+        piezo_position: float | None = None,
+        galvo_position: float | None = None,
         exposure_ms: float = 10.0,
         **kwargs,
-    ) -> Dict:
+    ) -> dict:
         """
         Capture a single lightsheet image at specified position.
 
@@ -504,35 +502,36 @@ async def capture_lightsheet_image(
         Returns
         -------
         dict
-            ``{'image': np.ndarray, 'piezo_position': float, 'galvo_position': float, 'success': bool}``
+            ``{'image': np.ndarray, 'piezo_position': float,
+            'galvo_position': float, 'success': bool}``
         """
         result = await self._submit_plan_and_wait(
-            'capture_lightsheet_image_plan',
+            "capture_lightsheet_image_plan",
             kwargs={
-                'lightsheet_snap': 'lightsheet_snap',
-                'scanner': 'scanner',
-                'piezo': 'piezo',
-                'laser_control': 'laser_control',
-                'piezo_position': piezo_position if piezo_position is not None else 50.0,
-                'galvo_position': galvo_position if galvo_position is not None else 0.0,
+                "lightsheet_snap": "lightsheet_snap",
+                "scanner": "scanner",
+                "piezo": "piezo",
+                "laser_control": "laser_control",
+                "piezo_position": piezo_position if piezo_position is not None else 50.0,
+                "galvo_position": galvo_position if galvo_position is not None else 0.0,
             },
-            timeout=30.0
+            timeout=30.0,
         )
 
-        extracted = self._extract_image(result, ['HamCam1', 'lightsheet_snap', 'camera'])
+        extracted = self._extract_image(result, ["HamCam1", "lightsheet_snap", "camera"])
         if extracted:
             arr, fpath = extracted
             ret = {
-                'image': arr,
-                'piezo_position': piezo_position or 0.0,
-                'galvo_position': galvo_position or 0.0,
-                'success': True,
+                "image": arr,
+                "piezo_position": piezo_position or 0.0,
+                "galvo_position": galvo_position or 0.0,
+                "success": True,
             }
             if fpath:
-                ret['image_path'] = fpath
+                ret["image_path"] = fpath
             return ret
 
-        return {'error': result.get('error', 'No image data'), 'success': False}
+        return {"error": result.get("error", "No image data"), "success": False}
 
     async def acquire_volume(
         self,
@@ -548,7 +547,7 @@ async def acquire_volume(
         laser_power_405_pct: float = None,
         laser_power_637_pct: float = None,
         **kwargs,
-    ) -> Dict:
+    ) -> dict:
         """
         Acquire a 3D volume via synchronized galvo-piezo scan.
 
@@ -565,7 +564,8 @@ async def acquire_volume(
         laser_config : str, optional
             Laser channel preset ("488 and 561", "488 only", etc.). None
             uses the device-layer default.
-        laser_power_488_pct, laser_power_561_pct, laser_power_405_pct, laser_power_637_pct : float, optional
+        laser_power_488_pct, laser_power_561_pct, laser_power_405_pct,
+        laser_power_637_pct : float, optional
             Per-line laser power %. Hard-limited at the device layer
             (DiSPIMLightSource.POWER_LIMITS_PCT). None leaves current
             setpoint untouched.
@@ -576,48 +576,48 @@ async def acquire_volume(
             ``{'volume': np.ndarray, 'shape': tuple, 'success': bool}``
         """
         plan_kwargs = {
-            'volume_scanner': 'volume_scanner',
-            'num_slices': num_slices,
-            'exposure_ms': exposure_ms,
-            'galvo_amplitude': galvo_amplitude,
-            'galvo_center': galvo_center,
-            'piezo_amplitude': piezo_amplitude,
-            'piezo_center': piezo_center,
+            "volume_scanner": "volume_scanner",
+            "num_slices": num_slices,
+            "exposure_ms": exposure_ms,
+            "galvo_amplitude": galvo_amplitude,
+            "galvo_center": galvo_center,
+            "piezo_amplitude": piezo_amplitude,
+            "piezo_center": piezo_center,
         }
         # Only forward kwargs the user explicitly set — leaves the
         # acquire_single_volume_plan defaults in place otherwise.
         if laser_config is not None:
-            plan_kwargs['laser_config'] = laser_config
+            plan_kwargs["laser_config"] = laser_config
         if laser_power_488_pct is not None:
-            plan_kwargs['laser_power_488_pct'] = laser_power_488_pct
+            plan_kwargs["laser_power_488_pct"] = laser_power_488_pct
         if laser_power_561_pct is not None:
-            plan_kwargs['laser_power_561_pct'] = laser_power_561_pct
+            plan_kwargs["laser_power_561_pct"] = laser_power_561_pct
         if laser_power_405_pct is not None:
-            plan_kwargs['laser_power_405_pct'] = laser_power_405_pct
+            plan_kwargs["laser_power_405_pct"] = laser_power_405_pct
         if laser_power_637_pct is not None:
-            plan_kwargs['laser_power_637_pct'] = laser_power_637_pct
+            plan_kwargs["laser_power_637_pct"] = laser_power_637_pct
 
         result = await self._submit_plan_and_wait(
-            'acquire_single_volume_plan',
-            kwargs=plan_kwargs,
-            timeout=120.0
+            "acquire_single_volume_plan", kwargs=plan_kwargs, timeout=120.0
         )
 
-        extracted = self._extract_image(result, ['volume_scanner', 'camera', 'camera_image'], multi_event=True)
+        extracted = self._extract_image(
+            result, ["volume_scanner", "camera", "camera_image"], multi_event=True
+        )
         if extracted:
             arr, fpath = extracted
             ret = {
-                'volume': arr,
-                'shape': arr.shape,
-                'success': True,
+                "volume": arr,
+                "shape": arr.shape,
+                "success": True,
             }
             if fpath:
-                ret['volume_path'] = str(fpath)
-            elif result.get('volume_path'):
-                ret['volume_path'] = result['volume_path']
+                ret["volume_path"] = str(fpath)
+            elif result.get("volume_path"):
+                ret["volume_path"] = result["volume_path"]
             return ret
 
-        return {'error': result.get('error', 'Acquisition failed'), 'success': False}
+        return {"error": result.get("error", "Acquisition failed"), "success": False}
 
     async def acquire_burst(
         self,
@@ -635,7 +635,7 @@ async def acquire_burst(
         laser_power_405_pct: float = None,
         laser_power_637_pct: float = None,
         timeout: float = None,
-    ) -> Dict:
+    ) -> dict:
         """
         Acquire ``frames`` volumes back-to-back as a single device-layer plan.
 
@@ -657,76 +657,76 @@ async def acquire_burst(
             'volume_path': str|None, 'shape': tuple}``.
         """
         plan_kwargs = {
-            'volume_scanner': 'volume_scanner',
-            'frames': frames,
-            'mode': mode,
-            'num_slices': num_slices,
-            'exposure_ms': exposure_ms,
-            'galvo_amplitude': galvo_amplitude,
-            'galvo_center': galvo_center,
-            'piezo_amplitude': piezo_amplitude,
-            'piezo_center': piezo_center,
+            "volume_scanner": "volume_scanner",
+            "frames": frames,
+            "mode": mode,
+            "num_slices": num_slices,
+            "exposure_ms": exposure_ms,
+            "galvo_amplitude": galvo_amplitude,
+            "galvo_center": galvo_center,
+            "piezo_amplitude": piezo_amplitude,
+            "piezo_center": piezo_center,
         }
         if laser_config is not None:
-            plan_kwargs['laser_config'] = laser_config
+            plan_kwargs["laser_config"] = laser_config
         if laser_power_488_pct is not None:
-            plan_kwargs['laser_power_488_pct'] = laser_power_488_pct
+            plan_kwargs["laser_power_488_pct"] = laser_power_488_pct
         if laser_power_561_pct is not None:
-            plan_kwargs['laser_power_561_pct'] = laser_power_561_pct
+            plan_kwargs["laser_power_561_pct"] = laser_power_561_pct
         if laser_power_405_pct is not None:
-            plan_kwargs['laser_power_405_pct'] = laser_power_405_pct
+            plan_kwargs["laser_power_405_pct"] = laser_power_405_pct
         if laser_power_637_pct is not None:
-            plan_kwargs['laser_power_637_pct'] = laser_power_637_pct
+            plan_kwargs["laser_power_637_pct"] = laser_power_637_pct
 
         if timeout is None:
             # 3 s/frame headroom (1 s pacing + ~1.5 s plan overhead) with a 60 s floor.
             timeout = max(60.0, frames * 3.0)
 
         result = await self._submit_plan_and_wait(
-            'burst_plan',
+            "burst_plan",
             kwargs=plan_kwargs,
             timeout=timeout,
         )
 
-        if not result.get('success'):
-            return {'success': False, 'error': result.get('error', 'Burst failed')}
+        if not result.get("success"):
+            return {"success": False, "error": result.get("error", "Burst failed")}
 
         # _submit_plan_and_wait already swapped file_refs for ndarrays in-place.
         # Walk every event and pull (volume, path) per frame.
-        frames_out: List[Dict] = []
-        docs = result.get('documents', {}) or {}
-        events = docs.get('events', []) or []
-        candidates = ('volume_scanner', 'camera', 'camera_image')
+        frames_out: list[dict] = []
+        docs = result.get("documents", {}) or {}
+        events = docs.get("events", []) or []
+        candidates = ("volume_scanner", "camera", "camera_image")
         for ev in events:
-            data = ev.get('data', {}) or {}
+            data = ev.get("data", {}) or {}
             for key in candidates:
                 if key in data:
                     val = data[key]
-                    entry: Dict[str, Any] = {}
+                    entry: dict[str, Any] = {}
                     # Per-frame epoch time from the Bluesky event doc — lets the
                     # orchestrator stamp each saved frame with its real acquisition
                     # time instead of having to interpolate from the burst's
                     # aggregate timing.
-                    ev_time = ev.get('time')
+                    ev_time = ev.get("time")
                     if ev_time is not None:
-                        entry['acquired_at_epoch'] = float(ev_time)
+                        entry["acquired_at_epoch"] = float(ev_time)
                     if isinstance(val, np.ndarray):
-                        entry['volume'] = val
-                        entry['shape'] = val.shape
+                        entry["volume"] = val
+                        entry["shape"] = val.shape
                     elif self._is_file_ref(val):
                         arr, path = self._resolve_file_ref(val)
-                        entry['volume'] = arr
-                        entry['shape'] = arr.shape
-                        entry['volume_path'] = str(path)
+                        entry["volume"] = arr
+                        entry["shape"] = arr.shape
+                        entry["volume_path"] = str(path)
                     else:
-                        entry['volume'] = np.array(val)
-                        entry['shape'] = entry['volume'].shape
-                    if '__resolved_paths__' in data:
+                        entry["volume"] = np.array(val)
+                        entry["shape"] = entry["volume"].shape
+                    if "__resolved_paths__" in data:
                         # _submit_plan_and_wait doesn't currently populate this
                         # for events, but support it if a future change does.
-                        rp = data['__resolved_paths__']
+                        rp = data["__resolved_paths__"]
                         if isinstance(rp, dict) and key in rp:
-                            entry['volume_path'] = str(rp[key])
+                            entry["volume_path"] = str(rp[key])
                     frames_out.append(entry)
                     break
 
@@ -736,32 +736,32 @@ async def acquire_burst(
         duration_s = 0.0
         sustained_hz = 0.0
         if events:
-            first_t = events[0].get('time')
-            last_t = events[-1].get('time')
+            first_t = events[0].get("time")
+            last_t = events[-1].get("time")
             if first_t is not None and last_t is not None and last_t > first_t:
                 duration_s = float(last_t - first_t)
                 if duration_s > 0:
                     sustained_hz = len(frames_out) / duration_s
 
         return {
-            'success': True,
-            'frames': frames_out,
-            'frames_captured': len(frames_out),
-            'frames_requested': frames,
-            'duration_s': duration_s,
-            'sustained_hz': sustained_hz,
-            'mode': mode,
+            "success": True,
+            "frames": frames_out,
+            "frames_captured": len(frames_out),
+            "frames_requested": frames,
+            "duration_s": duration_s,
+            "sustained_hz": sustained_hz,
+            "mode": mode,
         }
 
     # =========================================================================
     # LED / Camera Controls
     # =========================================================================
 
-    async def set_led(self, state: str = 'Closed') -> Dict:
+    async def set_led(self, state: str = "Closed") -> dict:
         """Set LED state ('Open' or 'Closed')."""
-        return await self._api_post('/api/led/set', {'state': state})
+        return await self._api_post("/api/led/set", {"state": state})
 
-    async def set_laser_power(self, wavelength: int, pct: float) -> Dict:
+    async def set_laser_power(self, wavelength: int, pct: float) -> dict:
         """Set per-line laser power %.
 
         Hits the device layer's ``POST /api/light_source/power`` directly
@@ -777,12 +777,15 @@ async def set_laser_power(self, wavelength: int, pct: float) -> Dict:
         pct : float
             Setpoint percent (must be within hard limit for ``wavelength``).
         """
-        return await self._api_post('/api/light_source/power', {
-            'wavelength': int(wavelength),
-            'pct': float(pct),
-        })
+        return await self._api_post(
+            "/api/light_source/power",
+            {
+                "wavelength": int(wavelength),
+                "pct": float(pct),
+            },
+        )
 
-    async def get_laser_power(self, wavelength: int) -> Dict:
+    async def get_laser_power(self, wavelength: int) -> dict:
         """Read the current per-line laser power %.
 
         Hits ``GET /api/light_source/power?wavelength={wavelength}`` —
@@ -796,13 +799,13 @@ async def get_laser_power(self, wavelength: int) -> Dict:
             ) as resp:
                 return await resp.json()
         except Exception as e:
-            return {'success': False, 'error': str(e)}
+            return {"success": False, "error": str(e)}
 
-    async def get_led_status(self) -> Dict:
+    async def get_led_status(self) -> dict:
         """Get current LED status."""
-        return await self._api_get('/api/led/status')
+        return await self._api_get("/api/led/status")
 
-    async def set_room_light(self, state: str = 'off') -> Dict:
+    async def set_room_light(self, state: str = "off") -> dict:
         """Switch the diSPIM room light on/off via the SwitchBot Bot.
 
         Hits ``POST /api/room_light/set`` directly (no Bluesky queue, no
@@ -810,25 +813,25 @@ async def set_room_light(self, state: str = 'off') -> Dict:
         'on' | 'off' | 'press'. Blocks at the device layer until the BLE
         command lands (~1-2 s).
         """
-        return await self._api_post('/api/room_light/set', {'state': state})
+        return await self._api_post("/api/room_light/set", {"state": state})
 
-    async def get_room_light_status(self) -> Dict:
+    async def get_room_light_status(self) -> dict:
         """Read the room light's cached on/off state (no BLE round-trip)."""
-        return await self._api_get('/api/room_light/status')
+        return await self._api_get("/api/room_light/status")
 
-    async def set_temperature(self, target_c: float) -> Dict:
+    async def set_temperature(self, target_c: float) -> dict:
         """Command the thermal-controller setpoint (Celsius). Non-blocking — the
         controller ramps; poll get_temperature() for the lock state."""
-        return await self._api_post('/api/temperature/set', {'target_c': target_c})
+        return await self._api_post("/api/temperature/set", {"target_c": target_c})
 
-    async def get_temperature(self) -> Dict:
+    async def get_temperature(self) -> dict:
         """Get current temperature, setpoint, and lock state."""
-        return await self._api_get('/api/temperature/status')
+        return await self._api_get("/api/temperature/status")
 
     # ------------------------------------------------------------------
     # Live device-state readout (streamed from the device layer poller)
     # ------------------------------------------------------------------
-    async def get_device_state(self, refresh: bool = False) -> Dict:
+    async def get_device_state(self, refresh: bool = False) -> dict:
         """One-shot snapshot of all device positions + properties.
 
         Parameters
@@ -837,12 +840,12 @@ async def get_device_state(self, refresh: bool = False) -> Dict:
             If True, force the device layer to re-read MMCore right now.
             Otherwise return the most recent poller snapshot (typically <500 ms old).
         """
-        path = '/api/devices/state'
+        path = "/api/devices/state"
         if refresh:
-            path += '?refresh=1'
+            path += "?refresh=1"
         return await self._api_get(path)
 
-    async def stream_device_states(self, timeout: Optional[float] = None):
+    async def stream_device_states(self, timeout: float | None = None):
         """Async generator yielding parsed device-state events from the SSE stream.
 
         Yields each event payload as a dict. Comment-style heartbeats (lines
@@ -892,11 +895,12 @@ async def stream_device_states(self, timeout: Optional[float] = None):
                     raw = b"\n".join(data_lines).decode("utf-8", errors="replace")
                     try:
                         import json as _json
+
                         yield _json.loads(raw)
                     except Exception as exc:
                         logger.warning("Malformed SSE payload skipped: %s", exc)
 
-    async def stream_bottom_camera(self, timeout: Optional[float] = None):
+    async def stream_bottom_camera(self, timeout: float | None = None):
         """Async generator yielding JPEG frames from the bottom-camera SSE stream.
 
         Mirrors :meth:`stream_device_states`. The device layer's streamer task
@@ -935,21 +939,22 @@ async def stream_bottom_camera(self, timeout: Optional[float] = None):
                     raw = b"\n".join(data_lines).decode("utf-8", errors="replace")
                     try:
                         import json as _json
+
                         yield _json.loads(raw)
                     except Exception as exc:
                         logger.warning("Malformed bottom-camera SSE payload skipped: %s", exc)
 
-    async def set_camera_led_mode(self, use_led: bool = False) -> Dict:
+    async def set_camera_led_mode(self, use_led: bool = False) -> dict:
         """Enable/disable automatic LED for bottom camera captures."""
-        return await self._api_post('/api/camera/led_mode', {'use_led': use_led})
+        return await self._api_post("/api/camera/led_mode", {"use_led": use_led})
 
-    async def set_bottom_camera_exposure(self, exposure_ms: float) -> Dict:
+    async def set_bottom_camera_exposure(self, exposure_ms: float) -> dict:
         """Set bottom camera exposure time in milliseconds."""
-        return await self._api_post('/api/camera/exposure', {'exposure_ms': exposure_ms})
+        return await self._api_post("/api/camera/exposure", {"exposure_ms": exposure_ms})
 
-    async def get_bottom_camera_exposure(self) -> Dict:
+    async def get_bottom_camera_exposure(self) -> dict:
         """Get current bottom camera exposure time."""
-        return await self._api_get('/api/camera/exposure')
+        return await self._api_get("/api/camera/exposure")
 
     async def capture_bottom_image(self, use_led: bool = False, exposure_ms: float = None) -> dict:
         """
@@ -973,16 +978,17 @@ async def capture_bottom_image(self, use_led: bool = False, exposure_ms: float =
         await self.set_camera_led_mode(use_led)
 
         result = await self._submit_plan_and_wait(
-            'capture_bottom_image_plan',
-            kwargs={'bottom_camera': 'bottom_camera'}
+            "capture_bottom_image_plan", kwargs={"bottom_camera": "bottom_camera"}
         )
 
-        extracted = self._extract_image(result, ['bottom_camera', 'bottom_camera_image', 'Bottom PCO'])
+        extracted = self._extract_image(
+            result, ["bottom_camera", "bottom_camera_image", "Bottom PCO"]
+        )
         if extracted:
             arr, fpath = extracted
-            return {'image': arr, 'image_path': fpath}
+            return {"image": arr, "image_path": fpath}
 
-        return {'image': np.zeros((100, 100), dtype=np.uint16), 'image_path': None}
+        return {"image": np.zeros((100, 100), dtype=np.uint16), "image_path": None}
 
     # =========================================================================
     # SAM Embryo Detection (HTTP API)
@@ -998,7 +1004,7 @@ async def detect_embryos(
         brightness_percentile: float = 99.0,
         min_area: int = 5000,
         max_area: int = 150000,
-    ) -> Dict:
+    ) -> dict:
         """
         Capture image and detect embryos using brightness detection + SAM.
 
@@ -1031,7 +1037,7 @@ async def detect_embryos(
             'image': np.ndarray, ...}``
         """
         if not self.has_sam:
-            return {'error': 'SAM detection not available on server'}
+            return {"error": "SAM detection not available on server"}
 
         self._ensure_connected()
 
@@ -1039,65 +1045,79 @@ async def detect_embryos(
             logger.info("Calling /api/detect_embryos (server-side capture + SAM)...")
 
             payload = {
-                'pixel_size_um': pixel_size_um,
-                'objective_mag': objective_mag,
-                'use_claude_review': use_claude_review,
-                'min_confidence': min_confidence,
-                'brightness_percentile': brightness_percentile,
-                'min_area': min_area,
-                'max_area': max_area,
+                "pixel_size_um": pixel_size_um,
+                "objective_mag": objective_mag,
+                "use_claude_review": use_claude_review,
+                "min_confidence": min_confidence,
+                "brightness_percentile": brightness_percentile,
+                "min_area": min_area,
+                "max_area": max_area,
             }
             if exposure_ms is not None:
-                payload['exposure_ms'] = exposure_ms
+                payload["exposure_ms"] = exposure_ms
 
             async with self._session.post(
-                f"{self.http_url}/api/detect_embryos",
-                json=payload,
-                timeout=300
+                f"{self.http_url}/api/detect_embryos", json=payload, timeout=300
             ) as resp:
                 result = await resp.json()
 
-            if not result.get('success'):
+            if not result.get("success"):
                 return result
 
             # Ensure the caller has the image to feed into the map view.
-            if result.get('image') is None:
+            if result.get("image") is None:
                 image = await self._get_detection_image(result, exposure_ms)
                 if image is not None:
-                    result['image'] = image
+                    result["image"] = image
 
             return result
 
         except asyncio.TimeoutError:
-            return {'success': False, 'error': 'Detection timed out (5 min limit)'}
+            return {"success": False, "error": "Detection timed out (5 min limit)"}
         except aiohttp.ClientError as e:
-            return {'error': str(NetworkError(f"Device layer request failed: {e}")),
-                    'traceback': traceback.format_exc(), 'success': False}
+            return {
+                "error": str(NetworkError(f"Device layer request failed: {e}")),
+                "traceback": traceback.format_exc(),
+                "success": False,
+            }
         except Exception as e:
-            return {'error': str(e), 'traceback': traceback.format_exc(), 'success': False}
+            return {
+                "error": str(e),
+                "traceback": traceback.format_exc(),
+                "success": False,
+            }
 
-    async def _get_detection_image(self, detection_result: dict, exposure_ms: float = None) -> Optional[np.ndarray]:
+    async def _get_detection_image(
+        self, detection_result: dict, exposure_ms: float = None
+    ) -> np.ndarray | None:
         """Load or capture an image for the detection editor."""
-        image_path = detection_result.get('image_path')
+        image_path = detection_result.get("image_path")
         if image_path:
             try:
                 import tifffile
+
                 return tifffile.imread(image_path)
             except Exception:
                 pass
         # Fallback: capture a fresh image
         snap = await self.capture_bottom_image(exposure_ms=exposure_ms)
-        image = snap['image']
-        if snap.get('image_path'):
+        image = snap["image"]
+        if snap.get("image_path"):
             try:
-                snap['image_path'].unlink(missing_ok=True)
+                snap["image_path"].unlink(missing_ok=True)
             except OSError:
                 pass
         return image
 
-    async def view_image(self, image: np.ndarray = None, title: str = "Image View",
-                         exposure_ms: float = None, save_path: str = None,
-                         show: bool = True, embryo_annotations: list = None) -> Dict:
+    async def view_image(
+        self,
+        image: np.ndarray = None,
+        title: str = "Image View",
+        exposure_ms: float = None,
+        save_path: str = None,
+        show: bool = True,
+        embryo_annotations: list = None,
+    ) -> dict:
         """Save a bottom-camera image to disk (replaces the napari display).
 
         ``show`` and ``title`` are kept for backwards compatibility with
@@ -1107,54 +1127,63 @@ async def view_image(self, image: np.ndarray = None, title: str = "Image View",
         try:
             if image is None:
                 snap = await self.capture_bottom_image(exposure_ms=exposure_ms)
-                image = snap['image']
-                if snap.get('image_path'):
+                image = snap["image"]
+                if snap.get("image_path"):
                     try:
-                        snap['image_path'].unlink(missing_ok=True)
+                        snap["image_path"].unlink(missing_ok=True)
                     except OSError:
                         pass
 
             if image is None:
-                return {'success': False, 'error': 'No image to save'}
+                return {"success": False, "error": "No image to save"}
 
-            result = {'success': True, 'shape': list(image.shape)}
+            result = {"success": True, "shape": list(image.shape)}
             if save_path:
                 # Reuse the existing PNG writer; draws annotations if any.
                 from pathlib import Path as _Path
+
                 _Path(save_path).parent.mkdir(parents=True, exist_ok=True)
                 annots = []
-                for a in (embryo_annotations or []):
-                    px = a.get('pixel_x')
-                    py = a.get('pixel_y')
+                for a in embryo_annotations or []:
+                    px = a.get("pixel_x")
+                    py = a.get("pixel_y")
                     if px is None or py is None:
                         continue
-                    annots.append({
-                        'embryo_number': a.get('label') or a.get('embryo_id') or '?',
-                        'pixel_position': (px, py),
-                    })
+                    annots.append(
+                        {
+                            "embryo_number": a.get("label") or a.get("embryo_id") or "?",
+                            "pixel_position": (px, py),
+                        }
+                    )
                 if annots:
                     from gently.ui.web.embryo_marker import _save_marked_image
+
                     _save_marked_image(image, annots, _Path(save_path))
                 else:
                     from PIL import Image as _PILImage
+
                     arr = image
                     if arr.dtype != np.uint8:
                         lo, hi = arr.min(), arr.max()
                         arr = ((arr - lo) / max(hi - lo, 1) * 255).astype(np.uint8)
                     _PILImage.fromarray(arr).save(save_path)
-                result['saved_to'] = save_path
+                result["saved_to"] = save_path
             return result
         except Exception as e:
-            return {'error': str(e), 'traceback': traceback.format_exc(), 'success': False}
+            return {
+                "error": str(e),
+                "traceback": traceback.format_exc(),
+                "success": False,
+            }
 
     async def view_embryos(
         self,
         image: np.ndarray,
-        embryos: List[Dict],
+        embryos: list[dict],
         title: str = "Embryos",
-        save_path: Optional[str] = None,
+        save_path: str | None = None,
         show: bool = True,
-    ) -> Dict:
+    ) -> dict:
         """Save an annotated PNG of embryos on an image (replaces napari).
 
         Markers in ``embryos`` may use ``center_x``/``center_y`` or
@@ -1163,32 +1192,40 @@ async def view_embryos(
         """
         try:
             if image is None or not embryos:
-                return {'success': False, 'error': 'No image or embryos to display'}
+                return {"success": False, "error": "No image or embryos to display"}
 
             annots = []
             for emb in embryos:
-                px = emb.get('center_x', emb.get('pixel_x', 0))
-                py = emb.get('center_y', emb.get('pixel_y', 0))
-                annots.append({
-                    'embryo_number': emb.get('embryo_id', '?'),
-                    'pixel_position': (px, py),
-                })
-
-            result = {'success': True, 'num_embryos': len(embryos)}
+                px = emb.get("center_x", emb.get("pixel_x", 0))
+                py = emb.get("center_y", emb.get("pixel_y", 0))
+                annots.append(
+                    {
+                        "embryo_number": emb.get("embryo_id", "?"),
+                        "pixel_position": (px, py),
+                    }
+                )
+
+            result = {"success": True, "num_embryos": len(embryos)}
             if save_path:
                 from pathlib import Path as _Path
+
                 _Path(save_path).parent.mkdir(parents=True, exist_ok=True)
                 from gently.ui.web.embryo_marker import _save_marked_image
+
                 _save_marked_image(image, annots, _Path(save_path))
-                result['saved_to'] = save_path
+                result["saved_to"] = save_path
             return result
         except Exception as e:
-            return {'error': str(e), 'traceback': traceback.format_exc(), 'success': False}
+            return {
+                "error": str(e),
+                "traceback": traceback.format_exc(),
+                "success": False,
+            }
 
     async def capture_for_marking(
         self,
         exposure_ms: float = None,
-    ) -> Dict:
+    ) -> dict:
         """
         Capture a bottom-camera image for manual marking in the map view.
 
@@ -1206,34 +1243,38 @@ async def capture_for_marking(
 
         try:
             snap = await self.capture_bottom_image(use_led=True, exposure_ms=exposure_ms)
-            image = snap['image']
+            image = snap["image"]
 
             if image is None or (image.shape == (100, 100) and image.max() == 0):
-                return {'success': False, 'error': 'Failed to capture image'}
+                return {"success": False, "error": "Failed to capture image"}
 
-            if snap.get('image_path'):
+            if snap.get("image_path"):
                 try:
-                    snap['image_path'].unlink(missing_ok=True)
+                    snap["image_path"].unlink(missing_ok=True)
                 except OSError:
                     pass
 
             stage_pos = await self.get_stage_position()
 
             return {
-                'success': True,
-                'image': image,
-                'stage_position': list(stage_pos),
-                'image_shape': list(image.shape),
+                "success": True,
+                "image": image,
+                "stage_position": list(stage_pos),
+                "image_shape": list(image.shape),
             }
 
         except Exception as e:
-            return {'error': str(e), 'traceback': traceback.format_exc(), 'success': False}
+            return {
+                "error": str(e),
+                "traceback": traceback.format_exc(),
+                "success": False,
+            }
 
     # =========================================================================
     # Status
     # =========================================================================
 
-    async def _get_server_status(self) -> Dict:
+    async def _get_server_status(self) -> dict:
         """Query device layer and SAM server status via HTTP."""
         status = {}
 
@@ -1243,18 +1284,18 @@ async def _get_server_status(self) -> Dict:
                 async with self._session.get(f"{self.http_url}/api/status") as resp:
                     if resp.status == 200:
                         server_status = await resp.json()
-                        status['queue_server'] = {
-                            'manager_state': server_status.get('manager_state'),
-                            're_state': server_status.get('re_state', 'idle'),
-                            'devices': server_status.get('devices', []),
-                            'plans': server_status.get('plans', []),
+                        status["queue_server"] = {
+                            "manager_state": server_status.get("manager_state"),
+                            "re_state": server_status.get("re_state", "idle"),
+                            "devices": server_status.get("devices", []),
+                            "plans": server_status.get("plans", []),
                         }
                     else:
-                        status['queue_server'] = {'error': f'HTTP {resp.status}'}
+                        status["queue_server"] = {"error": f"HTTP {resp.status}"}
             except (aiohttp.ClientError, Exception) as e:
-                status['queue_server'] = {'error': str(e)}
+                status["queue_server"] = {"error": str(e)}
         else:
-            status['queue_server'] = {'connected': False}
+            status["queue_server"] = {"connected": False}
 
         # SAM status (via HTTP, same server)
         if self._session and self._qs_connected:
@@ -1262,21 +1303,20 @@ async def _get_server_status(self) -> Dict:
                 async with self._session.get(f"{self.http_url}/api/sam/status") as resp:
                     if resp.status == 200:
                         sam_status = await resp.json()
-                        status['sam_server'] = {
-                            'available': sam_status.get('available', False),
-                            'loaded': sam_status.get('loaded', False),
-                            'device': sam_status.get('device', 'unknown'),
+                        status["sam_server"] = {
+                            "available": sam_status.get("available", False),
+                            "loaded": sam_status.get("loaded", False),
+                            "device": sam_status.get("device", "unknown"),
                         }
                     else:
-                        status['sam_server'] = {'error': f'HTTP {resp.status}'}
+                        status["sam_server"] = {"error": f"HTTP {resp.status}"}
             except (aiohttp.ClientError, Exception) as e:
-                status['sam_server'] = {'error': str(e)}
+                status["sam_server"] = {"error": str(e)}
         else:
-            status['sam_server'] = {'connected': False}
+            status["sam_server"] = {"connected": False}
 
         return status
 
-
     # =========================================================================
     # Microscope plan implementations
     # These map plan names to the existing methods above, enabling
@@ -1325,7 +1365,7 @@ async def _plan_status(self, **kw) -> dict:
 
 async def create_queue_server_client(
     http_url: str = f"http://{settings.network.device_host}:{settings.network.device_port}",
-) -> Optional[DiSPIMMicroscope]:
+) -> DiSPIMMicroscope | None:
     """Create and connect a diSPIM microscope client."""
     client = DiSPIMMicroscope(http_url=http_url)
     if await client.connect():
diff --git a/gently/hardware/dispim/config.py b/gently/hardware/dispim/config.py
index 3255b170..55a620a7 100644
--- a/gently/hardware/dispim/config.py
+++ b/gently/hardware/dispim/config.py
@@ -18,19 +18,17 @@
     >>> camera_config = CameraConfig(mode=CameraMode.EXTERNAL_PROGRESSIVE, exposure_ms=10.0)
 """
 
-import math
 import json
-from dataclasses import dataclass, asdict
+import math
+from dataclasses import asdict, dataclass
 from enum import Enum
 from pathlib import Path
-from typing import Optional, Tuple
-from datetime import datetime
-
 
 # ============================================================================
 # ENUMERATIONS
 # ============================================================================
 
+
 class CameraMode(Enum):
     """
     Camera trigger and sensor mode configurations.
@@ -39,12 +37,14 @@ class CameraMode(Enum):
     - INTERNAL_AREA: For calibration, live view, manual acquisitions
     - EXTERNAL_PROGRESSIVE: For hardware-triggered SPIM volumes
     """
-    INTERNAL_AREA = "internal_area"              # Manual trigger, full sensor
+
+    INTERNAL_AREA = "internal_area"  # Manual trigger, full sensor
     EXTERNAL_PROGRESSIVE = "external_progressive"  # Hardware trigger, progressive readout
 
 
 class ScannerPattern(Enum):
     """Galvo scanner waveform patterns."""
+
     TRIANGLE = "1 - Triangle"
     SAWTOOTH = "2 - Sawtooth"
     RAMP = "3 - Ramp"
@@ -52,6 +52,7 @@ class ScannerPattern(Enum):
 
 class ScannerMode(Enum):
     """Galvo scanner axis control modes."""
+
     DISABLED = "1 - Disabled"
     INTERNAL = "2 - Internal"
     ENABLED_SYNCED = "3 - Enabled with axes synced"
@@ -61,6 +62,7 @@ class ScannerMode(Enum):
 # HARDWARE PROFILES
 # ============================================================================
 
+
 @dataclass
 class HardwareProfile:
     """
@@ -83,17 +85,19 @@ class HardwareProfile:
         Custom profile for faster camera:
         >>> profile = HardwareProfile(camera_reset_ms=2.0, camera_readout_ms=8.0)
     """
-    camera_reset_ms: float = 3.0            # Hamamatsu Flash4 reset time
-    camera_readout_ms: float = 10.0          # Typical for 2048x512 ROI
-    scan_laser_buffer_ms: float = 0.25       # Buffer before/after laser pulse
-    scan_filter_freq_khz: float = 0.2        # Scanner filter frequency
-    has_plogic: bool = False                 # PLogic card present
+
+    camera_reset_ms: float = 3.0  # Hamamatsu Flash4 reset time
+    camera_readout_ms: float = 10.0  # Typical for 2048x512 ROI
+    scan_laser_buffer_ms: float = 0.25  # Buffer before/after laser pulse
+    scan_filter_freq_khz: float = 0.2  # Scanner filter frequency
+    has_plogic: bool = False  # PLogic card present
 
 
 # ============================================================================
 # CAMERA CONFIGURATION
 # ============================================================================
 
+
 @dataclass
 class CameraConfig:
     """
@@ -120,9 +124,10 @@ class CameraConfig:
         ...     exposure_ms=10.0
         ... )
     """
+
     mode: CameraMode
     exposure_ms: float
-    roi: Tuple[int, int, int, int] = (128, 896, 2048, 512)  # Default diSPIM ROI
+    roi: tuple[int, int, int, int] = (128, 896, 2048, 512)  # Default diSPIM ROI
 
     def to_mm_properties(self) -> dict:
         """
@@ -138,15 +143,12 @@ def to_mm_properties(self) -> dict:
             ...     core.setProperty(camera_device, name, value)
         """
         if self.mode == CameraMode.INTERNAL_AREA:
-            return {
-                "TRIGGER SOURCE": "INTERNAL",
-                "SENSOR MODE": "AREA"
-            }
+            return {"TRIGGER SOURCE": "INTERNAL", "SENSOR MODE": "AREA"}
         elif self.mode == CameraMode.EXTERNAL_PROGRESSIVE:
             return {
                 "TRIGGER SOURCE": "EXTERNAL",
                 "SENSOR MODE": "PROGRESSIVE",
-                "TRIGGER ACTIVE": "EDGE"
+                "TRIGGER ACTIVE": "EDGE",
             }
         else:
             raise ValueError(f"Unknown camera mode: {self.mode}")
@@ -156,6 +158,7 @@ def to_mm_properties(self) -> dict:
 # SCANNER/GALVO CONFIGURATION
 # ============================================================================
 
+
 @dataclass
 class GalvoAxisConfig:
     """
@@ -188,6 +191,7 @@ class GalvoAxisConfig:
         ...     mode=ScannerMode.ENABLED_SYNCED
         ... )
     """
+
     amplitude_deg: float
     offset_deg: float
     pattern: ScannerPattern = ScannerPattern.TRIANGLE
@@ -212,7 +216,7 @@ def to_mm_properties(self, axis: str) -> dict:
             f"SingleAxis{axis}Amplitude(deg)": float(self.amplitude_deg),
             f"SingleAxis{axis}Offset(deg)": float(self.offset_deg),
             f"SingleAxis{axis}Pattern": self.pattern.value,
-            f"SingleAxis{axis}Mode": self.mode.value
+            f"SingleAxis{axis}Mode": self.mode.value,
         }
 
 
@@ -234,6 +238,7 @@ class ScannerConfig:
         ...     beam_enabled=True
         ... )
     """
+
     x_axis: GalvoAxisConfig
     y_axis: GalvoAxisConfig
     beam_enabled: bool = True
@@ -262,9 +267,9 @@ def to_mm_properties(self) -> dict:
 # SPIM TIMING CALCULATION
 # ============================================================================
 
+
 def calculate_spim_timing(
-    camera_exposure_ms: float,
-    hardware_profile: Optional[HardwareProfile] = None
+    camera_exposure_ms: float, hardware_profile: HardwareProfile | None = None
 ) -> dict:
     """
     Calculate SPIM hardware timing parameters for synchronized acquisition.
@@ -356,15 +361,15 @@ def ceil_quarter_ms(val: float) -> float:
     frame_rate = 1000.0 / slice_duration if slice_duration > 0 else 0.0
 
     return {
-        'scanDelay': scan_delay,
-        'scanPeriod': scan_period,
-        'laserDelay': laser_delay,
-        'laserDuration': laser_duration,
-        'cameraDelay': camera_delay,
-        'cameraDuration': camera_duration,  # Must be > 0!
-        'cameraExposure': camera_exposure,
-        'sliceDuration': slice_duration,
-        'frameRate': frame_rate
+        "scanDelay": scan_delay,
+        "scanPeriod": scan_period,
+        "laserDelay": laser_delay,
+        "laserDuration": laser_duration,
+        "cameraDelay": camera_delay,
+        "cameraDuration": camera_duration,  # Must be > 0!
+        "cameraExposure": camera_exposure,
+        "sliceDuration": slice_duration,
+        "frameRate": frame_rate,
     }
 
 
@@ -372,6 +377,7 @@ def ceil_quarter_ms(val: float) -> float:
 # PIEZO-GALVO CALIBRATION
 # ============================================================================
 
+
 @dataclass
 class PiezoGalvoCalibration:
     """
@@ -420,6 +426,7 @@ class PiezoGalvoCalibration:
         Calculate piezo position for given galvo angle:
         >>> piezo_pos = calib.galvo_to_piezo(0.15)  # galvo at +0.15°
     """
+
     slope_um_per_deg: float
     offset_um: float
     galvo_top_deg: float
@@ -432,10 +439,10 @@ class PiezoGalvoCalibration:
     device_galvo: str = "Scanner:AB:33"
 
     # Optional metadata
-    edge_top_deg: Optional[float] = None
-    edge_bottom_deg: Optional[float] = None
-    calib_inset_fraction: Optional[float] = None
-    calib_strategy: Optional[str] = None
+    edge_top_deg: float | None = None
+    edge_bottom_deg: float | None = None
+    calib_inset_fraction: float | None = None
+    calib_strategy: str | None = None
 
     def galvo_to_piezo(self, galvo_deg: float) -> float:
         """
@@ -469,7 +476,7 @@ def piezo_to_galvo(self, piezo_um: float) -> float:
         """
         return (piezo_um - self.offset_um) / self.slope_um_per_deg
 
-    def get_scan_range(self, tolerance_multiplier: float = 1.0) -> Tuple[float, float]:
+    def get_scan_range(self, tolerance_multiplier: float = 1.0) -> tuple[float, float]:
         """
         Get galvo scan range with optional tolerance multiplier.
 
@@ -486,7 +493,7 @@ def get_scan_range(self, tolerance_multiplier: float = 1.0) -> Tuple[float, floa
         # If we have edge data, adjust tolerance
         if self.edge_top_deg is not None and self.edge_bottom_deg is not None:
             # Estimate original tolerance
-            original_tolerance = (self.galvo_top_deg - self.edge_top_deg)  # Should be negative
+            original_tolerance = self.galvo_top_deg - self.edge_top_deg  # Should be negative
 
             # Apply multiplier
             new_tolerance = abs(original_tolerance) * tolerance_multiplier
@@ -501,7 +508,7 @@ def get_scan_range(self, tolerance_multiplier: float = 1.0) -> Tuple[float, floa
             return (self.galvo_top_deg, self.galvo_bottom_deg)
 
     @classmethod
-    def from_file(cls, path: Path) -> 'PiezoGalvoCalibration':
+    def from_file(cls, path: Path) -> "PiezoGalvoCalibration":
         """
         Load calibration from JSON file.
 
@@ -523,7 +530,7 @@ def from_file(cls, path: Path) -> 'PiezoGalvoCalibration':
         if not path.exists():
             raise FileNotFoundError(f"Calibration file not found: {path}")
 
-        with open(path, 'r') as f:
+        with open(path) as f:
             data = json.load(f)
 
         return cls(**data)
@@ -542,7 +549,7 @@ def to_file(self, path: Path):
         path = Path(path)
         path.parent.mkdir(parents=True, exist_ok=True)
 
-        with open(path, 'w') as f:
+        with open(path, "w") as f:
             json.dump(asdict(self), f, indent=2)
 
     def __str__(self) -> str:
@@ -560,6 +567,7 @@ def __str__(self) -> str:
 # PRESET CONFIGURATIONS
 # ============================================================================
 
+
 def get_calibration_camera_config(exposure_ms: float = 50.0) -> CameraConfig:
     """
     Get camera configuration for calibration mode.
@@ -570,10 +578,7 @@ def get_calibration_camera_config(exposure_ms: float = 50.0) -> CameraConfig:
     Returns:
         CameraConfig for INTERNAL trigger, AREA sensor mode
     """
-    return CameraConfig(
-        mode=CameraMode.INTERNAL_AREA,
-        exposure_ms=exposure_ms
-    )
+    return CameraConfig(mode=CameraMode.INTERNAL_AREA, exposure_ms=exposure_ms)
 
 
 def get_hardware_spim_camera_config(exposure_ms: float = 10.0) -> CameraConfig:
@@ -586,10 +591,7 @@ def get_hardware_spim_camera_config(exposure_ms: float = 10.0) -> CameraConfig:
     Returns:
         CameraConfig for EXTERNAL trigger, PROGRESSIVE sensor mode
     """
-    return CameraConfig(
-        mode=CameraMode.EXTERNAL_PROGRESSIVE,
-        exposure_ms=exposure_ms
-    )
+    return CameraConfig(mode=CameraMode.EXTERNAL_PROGRESSIVE, exposure_ms=exposure_ms)
 
 
 def get_standard_scanner_config(y_amplitude_deg: float = 0.04) -> ScannerConfig:
@@ -607,13 +609,13 @@ def get_standard_scanner_config(y_amplitude_deg: float = 0.04) -> ScannerConfig:
             amplitude_deg=8.0,
             offset_deg=0.0005,
             pattern=ScannerPattern.TRIANGLE,
-            mode=ScannerMode.ENABLED_SYNCED
+            mode=ScannerMode.ENABLED_SYNCED,
         ),
         y_axis=GalvoAxisConfig(
             amplitude_deg=y_amplitude_deg,
             offset_deg=0.0,
             pattern=ScannerPattern.TRIANGLE,
-            mode=ScannerMode.ENABLED_SYNCED
+            mode=ScannerMode.ENABLED_SYNCED,
         ),
-        beam_enabled=True
+        beam_enabled=True,
     )
diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index c70e68b0..e914b1b1 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -5,15 +5,13 @@
 """
 
 import logging
-from typing import Dict, Optional
-from pathlib import Path
+
 import pymmcore
 
 logger = logging.getLogger(__name__)
 
 
-def create_devices_from_mmcore(core: pymmcore.CMMCore,
-                                config: Optional[Dict] = None) -> Dict:
+def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = None) -> dict:
     """
     Create all necessary Ophyd devices from Micro-Manager core
 
@@ -54,23 +52,23 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
     """
     # Import devices only when needed (avoids ophyd import issues)
     from .devices import (
-        DiSPIMXYStage,
-        DiSPIMVolumeScanner,
         DiSPIMBottomCamera,
         DiSPIMLightSheetSnap,
+        DiSPIMPiezo,
         DiSPIMScanner,
-        DiSPIMPiezo
+        DiSPIMVolumeScanner,
+        DiSPIMXYStage,
     )
 
     # Default device configuration (from MMConfig_tracking_screening.cfg)
     default_config = {
-        'xy_stage_name': 'XYStage:XY:31',
-        'camera_name': 'HamCam1',
-        'scanner_name': 'Scanner:AB:33',
-        'piezo_name': 'PiezoStage:P:34',
-        'fdrive_name': 'ZStage:V:37',
-        'bottom_camera_name': 'Bottom PCO',
-        'led_name': 'LED:X:31'
+        "xy_stage_name": "XYStage:XY:31",
+        "camera_name": "HamCam1",
+        "scanner_name": "Scanner:AB:33",
+        "piezo_name": "PiezoStage:P:34",
+        "fdrive_name": "ZStage:V:37",
+        "bottom_camera_name": "Bottom PCO",
+        "led_name": "LED:X:31",
     }
 
     # Merge with user config
@@ -88,69 +86,77 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
     led = None
 
     try:
-        scanner = DiSPIMScanner(name=cfg['scanner_name'], core=core)
-        devices['scanner'] = scanner
-        logger.info("Created scanner: %s", cfg['scanner_name'])
+        scanner = DiSPIMScanner(name=cfg["scanner_name"], core=core)
+        devices["scanner"] = scanner
+        logger.info("Created scanner: %s", cfg["scanner_name"])
     except Exception as e:
         logger.warning("Could not create scanner: %s", e)
 
     try:
-        piezo = DiSPIMPiezo(name=cfg['piezo_name'], core=core)
-        devices['piezo'] = piezo
-        logger.info("Created piezo: %s", cfg['piezo_name'])
+        piezo = DiSPIMPiezo(name=cfg["piezo_name"], core=core)
+        devices["piezo"] = piezo
+        logger.info("Created piezo: %s", cfg["piezo_name"])
     except Exception as e:
         logger.warning("Could not create piezo: %s", e)
 
     try:
         from .devices import DiSPIMCamera
-        camera = DiSPIMCamera(device_name=cfg['camera_name'], core=core)
-        devices['camera'] = camera
-        logger.info("Created camera: %s", cfg['camera_name'])
+
+        camera = DiSPIMCamera(device_name=cfg["camera_name"], core=core)
+        devices["camera"] = camera
+        logger.info("Created camera: %s", cfg["camera_name"])
     except Exception as e:
         logger.warning("Could not create camera: %s", e)
 
     try:
         from .devices import DiSPIMLightSource
+
         # Single instance, registered under both names: the ophyd name and
         # devices-dict key keep the historical "laser_control" identifier
         # so existing Bluesky plans (which take a `laser_control=...` kwarg)
         # continue to work; "light_source" is the new canonical alias for
         # callers that want the broader concept (power + channel).
-        laser_control = DiSPIMLightSource(core=core, name='laser_control', group_name="Laser")
-        devices['laser_control'] = laser_control
-        devices['light_source'] = laser_control
+        laser_control = DiSPIMLightSource(core=core, name="laser_control", group_name="Laser")
+        devices["laser_control"] = laser_control
+        devices["light_source"] = laser_control
         logger.info("Created light source (laser_control)")
     except Exception as e:
         logger.warning("Could not create light source: %s", e)
 
     try:
-        devices['xy_stage'] = DiSPIMXYStage(name=cfg['xy_stage_name'], core=core)
-        logger.info("Created XY stage: %s", cfg['xy_stage_name'])
+        devices["xy_stage"] = DiSPIMXYStage(name=cfg["xy_stage_name"], core=core)
+        logger.info("Created XY stage: %s", cfg["xy_stage_name"])
     except Exception as e:
         logger.warning("Could not create XY stage: %s", e)
 
     try:
         from .devices import DiSPIMFDrive
-        devices['fdrive'] = DiSPIMFDrive(name=cfg['fdrive_name'], core=core)
-        logger.info("Created F-drive (SPIM head): %s", cfg['fdrive_name'])
+
+        devices["fdrive"] = DiSPIMFDrive(name=cfg["fdrive_name"], core=core)
+        logger.info("Created F-drive (SPIM head): %s", cfg["fdrive_name"])
     except Exception as e:
         logger.warning("Could not create F-drive (SPIM head): %s", e)
 
     try:
-        if cfg.get('led_name'):
+        if cfg.get("led_name"):
             from .devices import DiSPIMLED
-            led = DiSPIMLED(core=core, name=cfg['led_name'], group_name="LED")
-            devices['led'] = led
-            logger.info("Created LED: %s", cfg['led_name'])
+
+            led = DiSPIMLED(core=core, name=cfg["led_name"], group_name="LED")
+            devices["led"] = led
+            logger.info("Created LED: %s", cfg["led_name"])
     except Exception as e:
         logger.warning("Could not create LED: %s", e)
 
     # Compound devices
     try:
         if scanner and camera and piezo and laser_control:
-            devices['volume_scanner'] = DiSPIMVolumeScanner(
-                scanner=scanner, camera=camera, piezo=piezo,
-                laser_control=laser_control, core=core, name='volume_scanner',
+            devices["volume_scanner"] = DiSPIMVolumeScanner(
+                scanner=scanner,
+                camera=camera,
+                piezo=piezo,
+                laser_control=laser_control,
+                core=core,
+                name="volume_scanner",
             )
             logger.info("Created volume scanner")
         else:
@@ -161,11 +167,14 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
     try:
         if led:
             bottom_camera = DiSPIMBottomCamera(
-                device_name=cfg['bottom_camera_name'], core=core,
-                led_control=led, pixel_size_um=6.5, magnification=10.0,
+                device_name=cfg["bottom_camera_name"],
+                core=core,
+                led_control=led,
+                pixel_size_um=6.5,
+                magnification=10.0,
             )
-            devices['bottom_camera'] = bottom_camera
-            logger.info("Created bottom camera: %s", cfg['bottom_camera_name'])
+            devices["bottom_camera"] = bottom_camera
+            logger.info("Created bottom camera: %s", cfg["bottom_camera_name"])
         else:
             logger.warning("Skipping bottom camera (missing LED device)")
     except Exception as e:
@@ -173,8 +182,10 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
 
     try:
         if scanner and camera:
-            devices['lightsheet_snap'] = DiSPIMLightSheetSnap(
-                scanner=scanner, camera=camera, name='lightsheet_snap',
+            devices["lightsheet_snap"] = DiSPIMLightSheetSnap(
+                scanner=scanner,
+                camera=camera,
+                name="lightsheet_snap",
             )
             logger.info("Created lightsheet snap device")
         else:
@@ -186,5 +197,3 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore,
         raise RuntimeError("Failed to create any devices. Check your Micro-Manager configuration.")
 
     return devices
-
-
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 53495cf6..bc8daead 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -19,16 +19,14 @@
 
 import asyncio
 import contextlib
-import logging
 import json
+import logging
 import os
 import sys
 import time
-from pathlib import Path
-from typing import Any, Dict, List, Optional
-
-logger = logging.getLogger(__name__)
 from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
 
 import numpy as np
 
@@ -37,25 +35,27 @@
 if str(project_root) not in sys.path:
     sys.path.insert(0, str(project_root))
 
-from aiohttp import web
-import yaml
-
-from gently.core.service import Service
-from gently.exceptions import HardwareError, AcquisitionError
-from gently.log_config import configure_logging
-from gently.settings import settings
-from gently.hardware import console_ui as cui
+import yaml  # noqa: E402
+from aiohttp import web  # noqa: E402
 
 # Bluesky imports
-from bluesky import RunEngine
+from bluesky import RunEngine  # noqa: E402
+
+from gently.core.service import Service  # noqa: E402
+from gently.hardware import console_ui as cui  # noqa: E402
+from gently.log_config import configure_logging  # noqa: E402
+from gently.settings import settings  # noqa: E402
+
+logger = logging.getLogger(__name__)
 # BestEffortCallback removed — unused
 
 
 @dataclass
 class PlanRequest:
     """A request to run a plan"""
+
     plan_name: str
-    kwargs: Dict[str, Any]
+    kwargs: dict[str, Any]
     future: asyncio.Future = field(default_factory=lambda: asyncio.get_event_loop().create_future())
 
 
@@ -103,7 +103,7 @@ def __init__(
         # When set, large numpy arrays are written as TIFF files instead of
         # being serialized to JSON lists (which can turn a 400MB uint16 volume
         # into ~2GB of JSON text).
-        self._volume_dir: Optional[str] = None
+        self._volume_dir: str | None = None
 
         # Server lifecycle objects (populated in on_start)
         self._app = None
@@ -127,34 +127,34 @@ def __init__(
         # run. Plain stage moves / LED changes / snaps don't pause — the
         # adapter's per-device mutex handles the contention fine, and we
         # want the readout to stay live.
-        self._state_pos_interval_sec = 0.2       # 5 Hz target for XY (hard floor ~4 Hz on ASI)
+        self._state_pos_interval_sec = 0.2  # 5 Hz target for XY (hard floor ~4 Hz on ASI)
         self._state_slow_pos_interval_sec = 1.0  # 1 Hz piezo + galvo
-        self._state_prop_interval_sec = 15.0     # ~0.07 Hz full-state cadence
+        self._state_prop_interval_sec = 15.0  # ~0.07 Hz full-state cadence
         self._state_pause_counter = 0
         self._state_updating_now = False
-        self._state_latest: Dict[str, Any] = {
+        self._state_latest: dict[str, Any] = {
             "positions": {},
             "properties": {},
             "t": 0.0,
             "paused": False,
         }
-        self._state_subscribers: List[asyncio.Queue] = []
-        self._state_pos_task: Optional[asyncio.Task] = None
-        self._state_slow_pos_task: Optional[asyncio.Task] = None
-        self._state_prop_task: Optional[asyncio.Task] = None
+        self._state_subscribers: list[asyncio.Queue] = []
+        self._state_pos_task: asyncio.Task | None = None
+        self._state_slow_pos_task: asyncio.Task | None = None
+        self._state_prop_task: asyncio.Task | None = None
 
         # MMCore push-callback support. Adapters that fire OnPropertyChanged /
         # OnXYStagePositionChanged etc. let us skip polling for those events.
         # Whether the ASI Tiger adapter fires on joystick moves is unknown —
         # the bridge logs every callback and broadcasts to a dedicated SSE
         # stream so it can be tested empirically.
-        self._mm_callback_bridge = None       # MMEventCallback subclass
-        self._mm_callback_loop: Optional[asyncio.AbstractEventLoop] = None
-        self._callback_subscribers: List[asyncio.Queue] = []
+        self._mm_callback_bridge = None  # MMEventCallback subclass
+        self._mm_callback_loop: asyncio.AbstractEventLoop | None = None
+        self._callback_subscribers: list[asyncio.Queue] = []
         # Debounce timer for state-stream broadcasts triggered by callbacks.
         # A flurry of OnPropertyChanged events (e.g. during config-group load)
         # gets coalesced into a single broadcast ~50 ms later.
-        self._callback_broadcast_handle: Optional[asyncio.Handle] = None
+        self._callback_broadcast_handle: asyncio.Handle | None = None
         self._callback_broadcast_debounce_sec: float = 0.05
 
         # Bottom-camera live stream (Phase-1 thumbnail). Off by default; the
@@ -162,27 +162,29 @@ def __init__(
         # so the camera is never grabbed when nobody is watching.
         # Tuned for low latency: small thumbnail + cheap auto-contrast keeps
         # the encode path under ~5 ms per frame on the encoding thread.
-        self._cam_subscribers: List[asyncio.Queue] = []
-        self._cam_task: Optional[asyncio.Task] = None
-        self._cam_interval_sec: float = 0.25            # 4 Hz
-        self._cam_target_max_dim: int = 360             # ~360px thumbnail
+        self._cam_subscribers: list[asyncio.Queue] = []
+        self._cam_task: asyncio.Task | None = None
+        self._cam_interval_sec: float = 0.25  # 4 Hz
+        self._cam_target_max_dim: int = 360  # ~360px thumbnail
         self._cam_jpeg_quality: int = 55
 
         # Plans that hold MMCore for long performance-critical work.
         # Anything in this set runs with state polling paused.
-        self._heavy_plans = frozenset({
-            'acquire_single_volume_plan',
-            'burst_plan',
-            'timelapse_volume_plan',
-            'focus_sweep_plan',
-            'calibrate_piezo_galvo_plan',
-            'multi_embryo_calibration_workflow',
-            # Slow F-drive traverse (25000 -> ~50 um) + fine focus scan + the
-            # XY view-registration loop all hold MMCore for a while.
-            'spim_head_focus_descent_plan',
-            'register_views_xy_plan',
-            'spim_head_focus_and_align_plan',
-        })
+        self._heavy_plans = frozenset(
+            {
+                "acquire_single_volume_plan",
+                "burst_plan",
+                "timelapse_volume_plan",
+                "focus_sweep_plan",
+                "calibrate_piezo_galvo_plan",
+                "multi_embryo_calibration_workflow",
+                # Slow F-drive traverse (25000 -> ~50 um) + fine focus scan + the
+                # XY view-registration loop all hold MMCore for a while.
+                "spim_head_focus_descent_plan",
+                "register_views_xy_plan",
+                "spim_head_focus_and_align_plan",
+            }
+        )
 
     async def initialize(self):
         """Initialize hardware and RunEngine"""
@@ -196,7 +198,7 @@ async def initialize(self):
         # [1/5] Load config
         cui.step(1, 5, "Loading configuration")
         logger.info("[1/5] Loading configuration...")
-        with open(self.config_path, 'r') as f:
+        with open(self.config_path) as f:
             self.config = yaml.safe_load(f)
         logger.info("Config loaded from %s", self.config_path)
         cui.step_done(str(self.config_path))
@@ -212,12 +214,12 @@ async def initialize(self):
         self.system.enable_stderr_log(True)
 
         # Add MM directory to PATH for device adapters
-        mm_directory = self.config.get('mmdirectory', 'C:/Program Files/Micro-Manager-1.4')
+        mm_directory = self.config.get("mmdirectory", "C:/Program Files/Micro-Manager-1.4")
         os.environ["PATH"] += os.pathsep + mm_directory
         self.system.set_device_adapter_search_paths([mm_directory])
 
         # Load system configuration
-        mm_config = self.config.get('mmconfig', 'MMConfig.cfg')
+        mm_config = self.config.get("mmconfig", "MMConfig.cfg")
         mm_config_path = os.path.join(mm_directory, mm_config)
         if not os.path.exists(mm_config_path):
             # Try config.yml directory
@@ -238,9 +240,11 @@ async def initialize(self):
         # [3/5] Create Ophyd devices
         cui.step(3, 5, "Creating devices")
         logger.info("[3/5] Creating Ophyd devices...")
-        from .device_factory import create_devices_from_mmcore
         # Suppress rich console output to avoid Unicode issues on Windows
         import io
+
+        from .device_factory import create_devices_from_mmcore
+
         old_stdout = sys.stdout
         sys.stdout = io.StringIO()
         try:
@@ -255,17 +259,18 @@ async def initialize(self):
         # Micro-Manager adapter, so it's created here (independently of MMCore)
         # and added to the same registry. Plans address it by name, e.g.
         # bps.mv(switchbot, 'on'). Config-gated: no `switchbot:` section => no-op.
-        sb_cfg = self.config.get('switchbot')
+        sb_cfg = self.config.get("switchbot")
         if sb_cfg:
             try:
                 from gently.hardware.switchbot import SwitchBot
-                sb_name = sb_cfg.get('name', 'switchbot')
+
+                sb_name = sb_cfg.get("name", "switchbot")
                 self.devices[sb_name] = SwitchBot(
-                    address=sb_cfg['address'],
+                    address=sb_cfg["address"],
                     name=sb_name,
-                    timeout=sb_cfg.get('timeout', 20.0),
+                    timeout=sb_cfg.get("timeout", 20.0),
                 )
-                logger.info("Created SwitchBot '%s' at %s", sb_name, sb_cfg['address'])
+                logger.info("Created SwitchBot '%s' at %s", sb_name, sb_cfg["address"])
             except Exception as exc:
                 logger.warning("Could not create SwitchBot: %s", exc)
 
@@ -273,14 +278,18 @@ async def initialize(self):
         # not an MMCore adapter — created here from config and added to the same
         # registry. Plans block on it via bps.mv(temperature, 20.0) until the
         # controller reports SYSTEM LOCKED. Config-gated: no `temperature:` => no-op.
-        temp_cfg = self.config.get('temperature')
+        temp_cfg = self.config.get("temperature")
         if temp_cfg:
             try:
                 from gently.hardware.temperature import create_temperature_controller
+
                 tc = create_temperature_controller(temp_cfg)
                 self.devices[tc.name] = tc
-                logger.info("Created temperature controller '%s' (backend=%s)",
-                            tc.name, temp_cfg.get('backend', 'serial'))
+                logger.info(
+                    "Created temperature controller '%s' (backend=%s)",
+                    tc.name,
+                    temp_cfg.get("backend", "serial"),
+                )
             except Exception as exc:
                 logger.warning("Could not create temperature controller: %s", exc)
 
@@ -294,12 +303,15 @@ async def initialize(self):
         # outside the requested envelope — operator must drive into bounds
         # first. We do NOT SaveCardSettings so a code-side limit change always
         # wins on next device-layer restart (config-as-code).
-        xy_stage = self.devices.get('xy_stage')
+        xy_stage = self.devices.get("xy_stage")
         if xy_stage is not None:
             from .devices.stage import (
-                XY_STAGE_X_MIN_UM, XY_STAGE_X_MAX_UM,
-                XY_STAGE_Y_MIN_UM, XY_STAGE_Y_MAX_UM,
+                XY_STAGE_X_MAX_UM,
+                XY_STAGE_X_MIN_UM,
+                XY_STAGE_Y_MAX_UM,
+                XY_STAGE_Y_MIN_UM,
             )
+
             try:
                 xy_stage.set_firmware_limits(
                     x_min_mm=XY_STAGE_X_MIN_UM / 1000.0,
@@ -308,10 +320,11 @@ async def initialize(self):
                     y_max_mm=XY_STAGE_Y_MAX_UM / 1000.0,
                 )
                 logger.info(
-                    "ASI Tiger firmware soft limits applied: "
-                    "X=[%.2f, %.2f] µm, Y=[%.2f, %.2f] µm",
-                    XY_STAGE_X_MIN_UM, XY_STAGE_X_MAX_UM,
-                    XY_STAGE_Y_MIN_UM, XY_STAGE_Y_MAX_UM,
+                    "ASI Tiger firmware soft limits applied: X=[%.2f, %.2f] µm, Y=[%.2f, %.2f] µm",
+                    XY_STAGE_X_MIN_UM,
+                    XY_STAGE_X_MAX_UM,
+                    XY_STAGE_Y_MIN_UM,
+                    XY_STAGE_Y_MAX_UM,
                 )
             except ValueError as exc:
                 # Current position is outside the envelope — refuse to start
@@ -358,6 +371,7 @@ def serialize_value(v):
                 # Large array + staging dir configured -> file ref
                 if self._volume_dir and v.nbytes > 1_000_000:
                     import uuid
+
                     try:
                         import tifffile
                     except ImportError:
@@ -386,14 +400,19 @@ def collect_docs(name, doc):
             # Serialize the document to handle numpy arrays
             serialized_doc = serialize_value(dict(doc))
 
-            if name == 'start':
-                self._last_documents = {'start': serialized_doc, 'descriptors': [], 'events': [], 'stop': None}
-            elif name == 'descriptor':
-                self._last_documents['descriptors'].append(serialized_doc)
-            elif name == 'event':
-                self._last_documents['events'].append(serialized_doc)
-            elif name == 'stop':
-                self._last_documents['stop'] = serialized_doc
+            if name == "start":
+                self._last_documents = {
+                    "start": serialized_doc,
+                    "descriptors": [],
+                    "events": [],
+                    "stop": None,
+                }
+            elif name == "descriptor":
+                self._last_documents["descriptors"].append(serialized_doc)
+            elif name == "event":
+                self._last_documents["events"].append(serialized_doc)
+            elif name == "stop":
+                self._last_documents["stop"] = serialized_doc
                 self._run_history.append(self._last_documents.copy())
 
         self.RE.subscribe(collect_docs)
@@ -414,27 +433,28 @@ def _load_plans(self):
         """Load available plans"""
         try:
             from .plans.acquisition import (
-                move_stage_plan,
-                read_stage_plan,
                 capture_bottom_image_plan,
                 capture_lightsheet_image_plan,
+                get_light_source_power_plan,
                 move_piezo_plan,
                 move_scanner_plan,
-                set_led_plan,
+                move_stage_plan,
+                read_stage_plan,
                 set_laser_plan,
+                set_led_plan,
                 set_light_source_power_plan,
-                get_light_source_power_plan,
             )
-            self.plans['move_stage_plan'] = move_stage_plan
-            self.plans['read_stage_plan'] = read_stage_plan
-            self.plans['capture_bottom_image_plan'] = capture_bottom_image_plan
-            self.plans['capture_lightsheet_image_plan'] = capture_lightsheet_image_plan
-            self.plans['move_piezo_plan'] = move_piezo_plan
-            self.plans['move_scanner_plan'] = move_scanner_plan
-            self.plans['set_led_plan'] = set_led_plan
-            self.plans['set_laser_plan'] = set_laser_plan
-            self.plans['set_light_source_power_plan'] = set_light_source_power_plan
-            self.plans['get_light_source_power_plan'] = get_light_source_power_plan
+
+            self.plans["move_stage_plan"] = move_stage_plan
+            self.plans["read_stage_plan"] = read_stage_plan
+            self.plans["capture_bottom_image_plan"] = capture_bottom_image_plan
+            self.plans["capture_lightsheet_image_plan"] = capture_lightsheet_image_plan
+            self.plans["move_piezo_plan"] = move_piezo_plan
+            self.plans["move_scanner_plan"] = move_scanner_plan
+            self.plans["set_led_plan"] = set_led_plan
+            self.plans["set_laser_plan"] = set_laser_plan
+            self.plans["set_light_source_power_plan"] = set_light_source_power_plan
+            self.plans["get_light_source_power_plan"] = get_light_source_power_plan
             logger.info("Loaded %d plans", len(self.plans))
         except ImportError as e:
             logger.warning("Could not load some plans: %s", e)
@@ -442,13 +462,14 @@ def _load_plans(self):
         # Also load main plans if available
         try:
             from .plans.acquisition import (
-                calibrate_piezo_galvo_plan,
                 acquire_single_volume_plan,
                 burst_plan,
+                calibrate_piezo_galvo_plan,
             )
-            self.plans['calibrate_piezo_galvo_plan'] = calibrate_piezo_galvo_plan
-            self.plans['acquire_single_volume_plan'] = acquire_single_volume_plan
-            self.plans['burst_plan'] = burst_plan
+
+            self.plans["calibrate_piezo_galvo_plan"] = calibrate_piezo_galvo_plan
+            self.plans["acquire_single_volume_plan"] = acquire_single_volume_plan
+            self.plans["burst_plan"] = burst_plan
             logger.info("Loaded main acquisition plans")
         except ImportError:
             logger.info("Main acquisition plans not available")
@@ -456,18 +477,19 @@ def _load_plans(self):
         # SPIM head focus + dual-view registration plans
         try:
             from .plans.acquisition import (
-                spim_head_focus_descent_plan,
                 register_views_xy_plan,
                 spim_head_focus_and_align_plan,
+                spim_head_focus_descent_plan,
             )
-            self.plans['spim_head_focus_descent_plan'] = spim_head_focus_descent_plan
-            self.plans['register_views_xy_plan'] = register_views_xy_plan
-            self.plans['spim_head_focus_and_align_plan'] = spim_head_focus_and_align_plan
+
+            self.plans["spim_head_focus_descent_plan"] = spim_head_focus_descent_plan
+            self.plans["register_views_xy_plan"] = register_views_xy_plan
+            self.plans["spim_head_focus_and_align_plan"] = spim_head_focus_and_align_plan
             logger.info("Loaded SPIM head focus plans")
         except ImportError:
             logger.info("SPIM head focus plans not available")
 
-    def _resolve_device_args(self, kwargs: Dict[str, Any]) -> Dict[str, Any]:
+    def _resolve_device_args(self, kwargs: dict[str, Any]) -> dict[str, Any]:
         """Replace device name strings with actual device objects"""
         resolved = {}
         for key, value in kwargs.items():
@@ -488,13 +510,17 @@ def _get_sam_detector(self):
         keeping server startup fast.
         """
         if self._sam_detector is None:
-            logger.info("Loading SAM detector (%s on %s)...", self._sam_model_type, self._sam_device)
+            logger.info(
+                "Loading SAM detector (%s on %s)...",
+                self._sam_model_type,
+                self._sam_device,
+            )
             from .sam_detection import SAMEmbryoDetector
 
             self._sam_detector = SAMEmbryoDetector(
                 sam_checkpoint=self._sam_checkpoint,
                 sam_model_type=self._sam_model_type,
-                device=self._sam_device
+                device=self._sam_device,
             )
             logger.info("SAM detector ready")
 
@@ -520,7 +546,7 @@ async def pause_state_updates(self):
             if self._state_pause_counter == 0:
                 self._state_latest["paused"] = False
 
-    def _read_xy_position(self) -> Dict[str, Any]:
+    def _read_xy_position(self) -> dict[str, Any]:
         """Read just the XY stage via the ophyd device's ``read()``.
 
         Two ASI serial round-trips (~250 ms) — the cost is in the underlying
@@ -528,12 +554,12 @@ def _read_xy_position(self) -> Dict[str, Any]:
         through ``xy_stage.read()`` so the only place that touches MMCore is
         inside the ophyd device class.
         """
-        out: Dict[str, Any] = {}
-        xy = self.devices.get('xy_stage')
+        out: dict[str, Any] = {}
+        xy = self.devices.get("xy_stage")
         if xy is not None:
             try:
                 data = xy.read()
-                value = data[xy.name]['value']
+                value = data[xy.name]["value"]
                 out[xy.name] = {
                     "X": float(value[0]),
                     "Y": float(value[1]),
@@ -543,30 +569,30 @@ def _read_xy_position(self) -> Dict[str, Any]:
                 logger.debug("XY position read failed: %s", exc)
         return out
 
-    def _read_slow_positions(self) -> Dict[str, Any]:
+    def _read_slow_positions(self) -> dict[str, Any]:
         """Read piezo + galvo via their ophyd ``read()`` methods.
 
         These rarely change on their own — piezo by Z-knob or commands, galvo
         only programmatically — so a 1 Hz cadence is plenty.
         """
-        out: Dict[str, Any] = {}
+        out: dict[str, Any] = {}
 
-        piezo = self.devices.get('piezo')
+        piezo = self.devices.get("piezo")
         if piezo is not None:
             try:
                 data = piezo.read()
                 out[piezo.name] = {
-                    "Position": float(data[piezo.name]['value']),
+                    "Position": float(data[piezo.name]["value"]),
                     "kind": "piezo",
                 }
             except Exception as exc:
                 logger.debug("Piezo position read failed: %s", exc)
 
-        scanner = self.devices.get('scanner')
+        scanner = self.devices.get("scanner")
         if scanner is not None:
             try:
                 data = scanner.read()
-                value = data[scanner.name]['value']
+                value = data[scanner.name]["value"]
                 out[scanner.name] = {
                     "A": float(value[0]),
                     "B": float(value[1]),
@@ -577,7 +603,7 @@ def _read_slow_positions(self) -> Dict[str, Any]:
 
         return out
 
-    def _read_full_state(self) -> Dict[str, Dict[str, str]]:
+    def _read_full_state(self) -> dict[str, dict[str, str]]:
         """Snapshot every property of every loaded MM device via the system state cache.
 
         `update_system_state_cache()` rereads from hardware, then
@@ -593,7 +619,7 @@ def _read_full_state(self) -> Dict[str, Dict[str, str]]:
             logger.debug("System state cache read failed: %s", exc)
             return {}
 
-        by_device: Dict[str, Dict[str, str]] = {}
+        by_device: dict[str, dict[str, str]] = {}
         try:
             size = cfg.size()
         except Exception:
@@ -640,12 +666,14 @@ async def _position_poller(self):
                 if self._state_pause_counter > 0:
                     now = time.time()
                     if now - last_heartbeat > 2.0:
-                        await self._broadcast_state({
-                            **self._state_latest,
-                            "t": now,
-                            "paused": True,
-                            "heartbeat": True,
-                        })
+                        await self._broadcast_state(
+                            {
+                                **self._state_latest,
+                                "t": now,
+                                "paused": True,
+                                "heartbeat": True,
+                            }
+                        )
                         last_heartbeat = now
                     await asyncio.sleep(self._state_pos_interval_sec)
                     continue
@@ -659,7 +687,8 @@ async def _position_poller(self):
                 if read_elapsed > 0.4:
                     logger.warning(
                         "XY position read slow: %.2fs (target<%.2fs)",
-                        read_elapsed, self._state_pos_interval_sec,
+                        read_elapsed,
+                        self._state_pos_interval_sec,
                     )
 
                 now = time.time()
@@ -710,7 +739,8 @@ async def _slow_positions_poller(self):
                 read_elapsed = time.monotonic() - read_start
                 if read_elapsed > 0.6:
                     logger.warning(
-                        "Slow-positions read slow: %.2fs", read_elapsed,
+                        "Slow-positions read slow: %.2fs",
+                        read_elapsed,
                     )
 
                 # Merge — don't clobber XY entries the fast poller maintains.
@@ -758,7 +788,8 @@ async def _property_poller(self):
                 read_elapsed = time.monotonic() - read_start
                 if read_elapsed > 1.0:
                     logger.warning(
-                        "Property read slow: %.2fs", read_elapsed,
+                        "Property read slow: %.2fs",
+                        read_elapsed,
                     )
 
                 self._state_latest = {
@@ -777,11 +808,11 @@ async def _property_poller(self):
             elapsed = time.monotonic() - tick_start
             await asyncio.sleep(max(0.0, self._state_prop_interval_sec - elapsed))
 
-    async def _broadcast_state(self, payload: Dict[str, Any]):
+    async def _broadcast_state(self, payload: dict[str, Any]):
         """Push a state payload to every SSE subscriber. Drop slow clients."""
         if not self._state_subscribers:
             return
-        dead: List[asyncio.Queue] = []
+        dead: list[asyncio.Queue] = []
         for q in self._state_subscribers:
             try:
                 q.put_nowait(payload)
@@ -798,14 +829,14 @@ async def _broadcast_state(self, payload: Dict[str, Any]):
     # Bottom-camera live stream (Phase 1: low-rate thumbnail)
     # =========================================================================
 
-    def _capture_bottom_frame_sync(self) -> Optional[np.ndarray]:
+    def _capture_bottom_frame_sync(self) -> np.ndarray | None:
         """Grab a single frame via the ophyd device's synchronous ``snap()``.
 
         Blocking — call via ``asyncio.to_thread``. All MMCore traffic happens
         inside ``DiSPIMCamera.snap()``; the streamer holds no direct core
         handle.
         """
-        cam = self.devices.get('bottom_camera')
+        cam = self.devices.get("bottom_camera")
         if cam is None:
             return None
         try:
@@ -814,7 +845,7 @@ def _capture_bottom_frame_sync(self) -> Optional[np.ndarray]:
             logger.debug("Bottom-camera grab failed: %s", exc)
             return None
 
-    def _encode_frame_for_stream(self, img: np.ndarray) -> Optional[Dict[str, Any]]:
+    def _encode_frame_for_stream(self, img: np.ndarray) -> dict[str, Any] | None:
         """Downsample + auto-contrast + JPEG-encode a uint16 frame for SSE.
 
         Optimised for streaming throughput:
@@ -827,8 +858,9 @@ def _encode_frame_for_stream(self, img: np.ndarray) -> Optional[Dict[str, Any]]:
         if img is None or img.size == 0:
             return None
         try:
-            import cv2  # opencv ships with the agent env (SAM uses it)
             import base64
+
+            import cv2  # opencv ships with the agent env (SAM uses it)
         except ImportError as exc:
             logger.warning("Cannot encode frame — OpenCV unavailable: %s", exc)
             return None
@@ -857,10 +889,10 @@ def _encode_frame_for_stream(self, img: np.ndarray) -> Optional[Dict[str, Any]]:
             scale = 255.0 / (hi - lo)
             small = np.clip((small.astype(np.float32) - lo) * scale, 0, 255).astype(np.uint8)
 
-        ok, jpeg = cv2.imencode('.jpg', small, [cv2.IMWRITE_JPEG_QUALITY, self._cam_jpeg_quality])
+        ok, jpeg = cv2.imencode(".jpg", small, [cv2.IMWRITE_JPEG_QUALITY, self._cam_jpeg_quality])
         if not ok:
             return None
-        b64 = base64.b64encode(jpeg.tobytes()).decode('ascii')
+        b64 = base64.b64encode(jpeg.tobytes()).decode("ascii")
         return {
             "t": time.time(),
             "shape": [int(small.shape[0]), int(small.shape[1])],
@@ -900,10 +932,10 @@ async def _bottom_camera_streamer(self):
         finally:
             logger.info("Bottom-camera streamer exiting")
 
-    async def _broadcast_camera(self, payload: Dict[str, Any]):
+    async def _broadcast_camera(self, payload: dict[str, Any]):
         if not self._cam_subscribers:
             return
-        dead: List[asyncio.Queue] = []
+        dead: list[asyncio.Queue] = []
         for q in self._cam_subscribers:
             try:
                 q.put_nowait(payload)
@@ -945,7 +977,11 @@ def _register_mmcore_callbacks(self):
         class _Bridge(pymmcore.MMEventCallback):
             def _emit(self, kind: str, **payload):
                 payload = {"t": time.time(), "kind": kind, **payload}
-                logger.info("MMCore callback: %s %s", kind, {k: v for k, v in payload.items() if k != "t"})
+                logger.info(
+                    "MMCore callback: %s %s",
+                    kind,
+                    {k: v for k, v in payload.items() if k != "t"},
+                )
                 loop = outer._mm_callback_loop
                 if loop is None or loop.is_closed():
                     return
@@ -979,8 +1015,7 @@ def onPixelSizeChanged(self, new_pixel_size_um):
                 self._emit("pixel_size_changed", um=new_pixel_size_um)
 
             def onPixelSizeAffineChanged(self, v0, v1, v2, v3, v4, v5):
-                self._emit("pixel_size_affine_changed",
-                           affine=[v0, v1, v2, v3, v4, v5])
+                self._emit("pixel_size_affine_changed", affine=[v0, v1, v2, v3, v4, v5])
 
             def onSystemConfigurationLoaded(self):
                 self._emit("system_configuration_loaded")
@@ -990,7 +1025,7 @@ def onSystemConfigurationLoaded(self):
         self.system.register_callback(self._mm_callback_bridge)
         logger.info("MMCore callback bridge registered")
 
-    def _enqueue_callback(self, payload: Dict[str, Any]):
+    def _enqueue_callback(self, payload: dict[str, Any]):
         """Runs on the asyncio loop (via call_soon_threadsafe).
 
         Two jobs: forward to /api/devices/callbacks/stream subscribers (for
@@ -1000,7 +1035,7 @@ def _enqueue_callback(self, payload: Dict[str, Any]):
         """
         # 1. Forward to the diagnostic callback stream.
         if self._callback_subscribers:
-            dead: List[asyncio.Queue] = []
+            dead: list[asyncio.Queue] = []
             for q in self._callback_subscribers:
                 try:
                     q.put_nowait(payload)
@@ -1017,7 +1052,7 @@ def _enqueue_callback(self, payload: Dict[str, Any]):
         if self._apply_callback_to_state(payload):
             self._schedule_callback_broadcast()
 
-    def _apply_callback_to_state(self, payload: Dict[str, Any]) -> bool:
+    def _apply_callback_to_state(self, payload: dict[str, Any]) -> bool:
         """Translate a callback payload into a `_state_latest` mutation.
 
         Returns True iff something visible changed (the caller will then
@@ -1116,23 +1151,24 @@ async def _plan_executor(self):
         while self._running:
             try:
                 # Wait for a plan request
-                request = await asyncio.wait_for(
-                    self._plan_queue.get(),
-                    timeout=1.0
-                )
+                request = await asyncio.wait_for(self._plan_queue.get(), timeout=1.0)
             except asyncio.TimeoutError:
                 continue
 
             # Log execution start with timestamp
             start_time = datetime.now()
             execution_record = {
-                'plan_name': request.plan_name,
-                'kwargs': {k: str(v) for k, v in request.kwargs.items()},  # Stringify for JSON
-                'start_time': start_time.isoformat(),
-                'start_time_formatted': start_time.strftime('%H:%M:%S.%f')[:-3],
+                "plan_name": request.plan_name,
+                "kwargs": {k: str(v) for k, v in request.kwargs.items()},  # Stringify for JSON
+                "start_time": start_time.isoformat(),
+                "start_time_formatted": start_time.strftime("%H:%M:%S.%f")[:-3],
             }
 
-            logger.info(">>> [%s] Executing: %s", start_time.strftime('%H:%M:%S'), request.plan_name)
+            logger.info(
+                ">>> [%s] Executing: %s",
+                start_time.strftime("%H:%M:%S"),
+                request.plan_name,
+            )
 
             # Reset documents before each plan so stale results from
             # a previous plan (e.g. volume file refs from acquire) don't
@@ -1170,37 +1206,52 @@ async def _plan_executor(self):
                 end_time = datetime.now()
                 duration_ms = (end_time - start_time).total_seconds() * 1000
 
-                execution_record.update({
-                    'end_time': end_time.isoformat(),
-                    'end_time_formatted': end_time.strftime('%H:%M:%S.%f')[:-3],
-                    'duration_ms': duration_ms,
-                    'success': True,
-                    'uid': uid,
-                })
+                execution_record.update(
+                    {
+                        "end_time": end_time.isoformat(),
+                        "end_time_formatted": end_time.strftime("%H:%M:%S.%f")[:-3],
+                        "duration_ms": duration_ms,
+                        "success": True,
+                        "uid": uid,
+                    }
+                )
 
-                logger.info("<<< [%s] Complete: %s (%.0fms)", end_time.strftime('%H:%M:%S'), request.plan_name, duration_ms)
+                logger.info(
+                    "<<< [%s] Complete: %s (%.0fms)",
+                    end_time.strftime("%H:%M:%S"),
+                    request.plan_name,
+                    duration_ms,
+                )
 
                 # Complete the future with result
-                request.future.set_result({
-                    'success': True,
-                    'uid': uid,
-                    'documents': self._last_documents.copy()
-                })
+                request.future.set_result(
+                    {
+                        "success": True,
+                        "uid": uid,
+                        "documents": self._last_documents.copy(),
+                    }
+                )
 
             except Exception as e:
-                import traceback
                 end_time = datetime.now()
                 duration_ms = (end_time - start_time).total_seconds() * 1000
 
-                execution_record.update({
-                    'end_time': end_time.isoformat(),
-                    'end_time_formatted': end_time.strftime('%H:%M:%S.%f')[:-3],
-                    'duration_ms': duration_ms,
-                    'success': False,
-                    'error': str(e),
-                })
+                execution_record.update(
+                    {
+                        "end_time": end_time.isoformat(),
+                        "end_time_formatted": end_time.strftime("%H:%M:%S.%f")[:-3],
+                        "duration_ms": duration_ms,
+                        "success": False,
+                        "error": str(e),
+                    }
+                )
 
-                logger.error("<<< [%s] Failed: %s - %s", end_time.strftime('%H:%M:%S'), request.plan_name, e)
+                logger.error(
+                    "<<< [%s] Failed: %s - %s",
+                    end_time.strftime("%H:%M:%S"),
+                    request.plan_name,
+                    e,
+                )
                 request.future.set_exception(e)
 
             # Store execution record
@@ -1209,17 +1260,13 @@ async def _plan_executor(self):
             if len(self._plan_execution_log) > 1000:
                 self._plan_execution_log = self._plan_execution_log[-1000:]
 
-    async def submit_plan(self, plan_name: str, kwargs: Dict = None) -> Dict:
+    async def submit_plan(self, plan_name: str, kwargs: dict = None) -> dict:
         """Submit a plan and wait for completion"""
         kwargs = kwargs or {}
 
         # Create request with a future
         loop = asyncio.get_event_loop()
-        request = PlanRequest(
-            plan_name=plan_name,
-            kwargs=kwargs,
-            future=loop.create_future()
-        )
+        request = PlanRequest(plan_name=plan_name, kwargs=kwargs, future=loop.create_future())
 
         # Add to queue
         await self._plan_queue.put(request)
@@ -1235,12 +1282,12 @@ async def submit_plan(self, plan_name: str, kwargs: Dict = None) -> Dict:
     async def handle_status(self, request):
         """GET /api/status"""
         status = {
-            'manager_state': 'idle' if self._running else 'stopped',
-            're_state': 'idle',
-            'devices': list(self.devices.keys()),
-            'plans': list(self.plans.keys()),
-            'queue_size': self._plan_queue.qsize(),
-            'sam_loaded': self._sam_detector is not None,
+            "manager_state": "idle" if self._running else "stopped",
+            "re_state": "idle",
+            "devices": list(self.devices.keys()),
+            "plans": list(self.plans.keys()),
+            "queue_size": self._plan_queue.qsize(),
+            "sam_loaded": self._sam_detector is not None,
         }
         return web.json_response(status)
 
@@ -1248,13 +1295,12 @@ async def handle_submit_plan(self, request):
         """POST /api/queue/item/add"""
         try:
             data = await request.json()
-            plan_name = data.get('item', {}).get('name')
-            kwargs = data.get('item', {}).get('kwargs', {})
+            plan_name = data.get("item", {}).get("name")
+            kwargs = data.get("item", {}).get("kwargs", {})
 
             if not plan_name:
                 return web.json_response(
-                    {'success': False, 'error': 'No plan name provided'},
-                    status=400
+                    {"success": False, "error": "No plan name provided"}, status=400
                 )
 
             result = await self.submit_plan(plan_name, kwargs)
@@ -1262,104 +1308,106 @@ async def handle_submit_plan(self, request):
 
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_get_history(self, request):
         """GET /api/history"""
-        return web.json_response({
-            'success': True,
-            'items': self._run_history[-10:]  # Last 10 runs
-        })
+        return web.json_response(
+            {
+                "success": True,
+                "items": self._run_history[-10:],  # Last 10 runs
+            }
+        )
 
     async def handle_get_devices(self, request):
         """GET /api/devices"""
-        return web.json_response({
-            'success': True,
-            'devices': list(self.devices.keys())
-        })
+        return web.json_response({"success": True, "devices": list(self.devices.keys())})
 
     async def handle_get_plans(self, request):
         """GET /api/plans"""
-        return web.json_response({
-            'success': True,
-            'plans': list(self.plans.keys())
-        })
+        return web.json_response({"success": True, "plans": list(self.plans.keys())})
 
     async def handle_get_led_status(self, request):
         """GET /api/led/status - Get current LED state and available configs"""
         try:
-            led = self.devices.get('led')
+            led = self.devices.get("led")
             if led is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'LED device not found'
-                })
+                return web.json_response({"success": False, "error": "LED device not found"})
 
             # Read current state
             current_state = led.read()
-            led_value = current_state.get(led.name, {}).get('value', 'unknown')
+            led_value = current_state.get(led.name, {}).get("value", "unknown")
 
             # Get available configs
             available_configs = led._available_configs
 
-            return web.json_response({
-                'success': True,
-                'current_state': led_value,
-                'available_configs': available_configs,
-                'group_name': led.group_name
-            })
+            return web.json_response(
+                {
+                    "success": True,
+                    "current_state": led_value,
+                    "available_configs": available_configs,
+                    "group_name": led.group_name,
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_set_led(self, request):
         """POST /api/led/set - Set LED state directly (bypass plan queue)"""
         try:
             data = await request.json()
-            state = data.get('state', 'Closed')
+            state = data.get("state", "Closed")
 
-            led = self.devices.get('led')
+            led = self.devices.get("led")
             if led is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'LED device not found'
-                })
+                return web.json_response({"success": False, "error": "LED device not found"})
 
             # Set LED state directly
             status = led.set(state)
             # Wait for completion
             import time
+
             timeout = 5.0
             start = time.time()
             while not status.done and (time.time() - start) < timeout:
                 await asyncio.sleep(0.1)
 
             if status.done and status.success:
-                return web.json_response({
-                    'success': True,
-                    'state': state,
-                    'message': f'LED set to {state}'
-                })
+                return web.json_response(
+                    {"success": True, "state": state, "message": f"LED set to {state}"}
+                )
             else:
-                return web.json_response({
-                    'success': False,
-                    'error': f'Failed to set LED to {state}'
-                })
+                return web.json_response(
+                    {"success": False, "error": f"Failed to set LED to {state}"}
+                )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     def _room_light_device(self):
         """Resolve the room-light SwitchBot from the device registry.
@@ -1368,7 +1416,7 @@ def _room_light_device(self):
         falls back to scanning for any SwitchBot instance so a differently
         named bot still works. Returns None when no bot is configured.
         """
-        bot = self.devices.get('room_light')
+        bot = self.devices.get("room_light")
         if bot is not None:
             return bot
         try:
@@ -1389,14 +1437,27 @@ async def handle_get_room_light_status(self, request):
         try:
             bot = self._room_light_device()
             if bot is None:
-                return web.json_response({'success': False, 'available': False,
-                                          'error': 'room_light device not configured'})
-            state = bot.read().get(bot.name, {}).get('value', 'unknown')
-            return web.json_response({'success': True, 'available': True, 'state': state})
+                return web.json_response(
+                    {
+                        "success": False,
+                        "available": False,
+                        "error": "room_light device not configured",
+                    }
+                )
+            state = bot.read().get(bot.name, {}).get("value", "unknown")
+            return web.json_response({"success": True, "available": True, "state": state})
         except Exception as e:
             import traceback
-            return web.json_response({'success': False, 'available': False, 'error': str(e),
-                                      'traceback': traceback.format_exc()}, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "available": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_set_room_light(self, request):
         """POST /api/room_light/set - drive the room-light SwitchBot.
@@ -1406,50 +1467,78 @@ async def handle_set_room_light(self, request):
         """
         try:
             data = await request.json()
-            state = str(data.get('state', '')).lower()
-            if state not in ('on', 'off', 'press'):
-                return web.json_response({'success': False,
-                                          'error': f"state {state!r} must be on, off, or press"}, status=400)
+            state = str(data.get("state", "")).lower()
+            if state not in ("on", "off", "press"):
+                return web.json_response(
+                    {
+                        "success": False,
+                        "error": f"state {state!r} must be on, off, or press",
+                    },
+                    status=400,
+                )
             bot = self._room_light_device()
             if bot is None:
-                return web.json_response({'success': False,
-                                          'error': 'room_light device not configured'}, status=503)
+                return web.json_response(
+                    {"success": False, "error": "room_light device not configured"},
+                    status=503,
+                )
 
             status = bot.set(state)
             import time
-            timeout = float(getattr(bot, 'timeout', 20.0)) + 5
+
+            timeout = float(getattr(bot, "timeout", 20.0)) + 5
             start = time.time()
             while not status.done and (time.time() - start) < timeout:
                 await asyncio.sleep(0.1)
 
             if status.done and status.success:
-                new_state = bot.read().get(bot.name, {}).get('value', state)
-                return web.json_response({'success': True, 'state': new_state})
-            return web.json_response({'success': False,
-                                      'error': f'failed to set room light to {state}'}, status=502)
+                new_state = bot.read().get(bot.name, {}).get("value", state)
+                return web.json_response({"success": True, "state": new_state})
+            return web.json_response(
+                {"success": False, "error": f"failed to set room light to {state}"},
+                status=502,
+            )
         except Exception as e:
             import traceback
-            return web.json_response({'success': False, 'error': str(e),
-                                      'traceback': traceback.format_exc()}, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_get_temperature_status(self, request):
         """GET /api/temperature/status - current temperature, setpoint, lock state."""
         try:
-            temp = self.devices.get('temperature')
+            temp = self.devices.get("temperature")
             if temp is None:
-                return web.json_response({'success': False, 'error': 'temperature device not found'})
+                return web.json_response(
+                    {"success": False, "error": "temperature device not found"}
+                )
             r = temp.read()
-            return web.json_response({
-                'success': True,
-                'temperature_c': r.get(temp.name, {}).get('value'),
-                'setpoint_c': r.get(f'{temp.name}_setpoint', {}).get('value'),
-                'state': r.get(f'{temp.name}_state', {}).get('value'),
-                'peltier_c': r.get(f'{temp.name}_peltier', {}).get('value'),
-            })
+            return web.json_response(
+                {
+                    "success": True,
+                    "temperature_c": r.get(temp.name, {}).get("value"),
+                    "setpoint_c": r.get(f"{temp.name}_setpoint", {}).get("value"),
+                    "state": r.get(f"{temp.name}_state", {}).get("value"),
+                    "peltier_c": r.get(f"{temp.name}_peltier", {}).get("value"),
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({'success': False, 'error': str(e),
-                                      'traceback': traceback.format_exc()}, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_set_temperature(self, request):
         """POST /api/temperature/set - command setpoint. Body: {target_c, wait?}.
@@ -1459,104 +1548,138 @@ async def handle_set_temperature(self, request):
         """
         try:
             data = await request.json()
-            target = float(data.get('target_c'))
-            wait = bool(data.get('wait', False))
+            target = float(data.get("target_c"))
+            wait = bool(data.get("wait", False))
             if not (0.0 <= target <= 99.9):
-                return web.json_response({'success': False,
-                                          'error': f'target {target} outside [0.0, 99.9]'})
-            temp = self.devices.get('temperature')
+                return web.json_response(
+                    {"success": False, "error": f"target {target} outside [0.0, 99.9]"}
+                )
+            temp = self.devices.get("temperature")
             if temp is None:
-                return web.json_response({'success': False, 'error': 'temperature device not found'})
+                return web.json_response(
+                    {"success": False, "error": "temperature device not found"}
+                )
 
             if not wait:
                 temp.enable(True)
                 temp.setpoint(target)
                 r = temp.read()
-                return web.json_response({
-                    'success': True, 'target_c': target, 'waited': False,
-                    'message': f'commanded {target} C (ramping)',
-                    'temperature_c': r.get(temp.name, {}).get('value'),
-                    'state': r.get(f'{temp.name}_state', {}).get('value'),
-                })
+                return web.json_response(
+                    {
+                        "success": True,
+                        "target_c": target,
+                        "waited": False,
+                        "message": f"commanded {target} C (ramping)",
+                        "temperature_c": r.get(temp.name, {}).get("value"),
+                        "state": r.get(f"{temp.name}_state", {}).get("value"),
+                    }
+                )
 
             import time
+
             status = temp.set(target)
-            timeout = float(getattr(temp, 'stabilize_timeout', 600.0)) + 10
+            timeout = float(getattr(temp, "stabilize_timeout", 600.0)) + 10
             start = time.time()
             while not status.done and (time.time() - start) < timeout:
                 await asyncio.sleep(0.5)
             r = temp.read()
             if status.done and status.success:
-                return web.json_response({
-                    'success': True, 'target_c': target, 'waited': True,
-                    'message': f'locked at {target} C',
-                    'temperature_c': r.get(temp.name, {}).get('value'),
-                    'state': r.get(f'{temp.name}_state', {}).get('value'),
-                })
-            return web.json_response({'success': False, 'target_c': target,
-                                      'error': f'did not stabilize at {target} C within {timeout:.0f}s'})
+                return web.json_response(
+                    {
+                        "success": True,
+                        "target_c": target,
+                        "waited": True,
+                        "message": f"locked at {target} C",
+                        "temperature_c": r.get(temp.name, {}).get("value"),
+                        "state": r.get(f"{temp.name}_state", {}).get("value"),
+                    }
+                )
+            return web.json_response(
+                {
+                    "success": False,
+                    "target_c": target,
+                    "error": f"did not stabilize at {target} C within {timeout:.0f}s",
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({'success': False, 'error': str(e),
-                                      'traceback': traceback.format_exc()}, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_set_camera_led_mode(self, request):
         """POST /api/camera/led_mode - Enable/disable automatic LED for bottom camera"""
         try:
             data = await request.json()
-            use_led = data.get('use_led', False)
+            use_led = data.get("use_led", False)
 
-            bottom_camera = self.devices.get('bottom_camera')
+            bottom_camera = self.devices.get("bottom_camera")
             if bottom_camera is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'Bottom camera device not found'
-                })
+                return web.json_response(
+                    {"success": False, "error": "Bottom camera device not found"}
+                )
 
             # Set the use_led attribute
             bottom_camera.use_led = use_led
 
-            return web.json_response({
-                'success': True,
-                'use_led': use_led,
-                'message': f'Bottom camera LED mode: {"ON" if use_led else "OFF"}'
-            })
+            return web.json_response(
+                {
+                    "success": True,
+                    "use_led": use_led,
+                    "message": f"Bottom camera LED mode: {'ON' if use_led else 'OFF'}",
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_set_camera_exposure(self, request):
         """POST /api/camera/exposure - Set bottom camera exposure time"""
         try:
             data = await request.json()
-            exposure_ms = data.get('exposure_ms', 50.0)
+            exposure_ms = data.get("exposure_ms", 50.0)
 
-            bottom_camera = self.devices.get('bottom_camera')
+            bottom_camera = self.devices.get("bottom_camera")
             if bottom_camera is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'Bottom camera device not found'
-                })
+                return web.json_response(
+                    {"success": False, "error": "Bottom camera device not found"}
+                )
 
             # Set exposure using the device's configure_exposure method
             bottom_camera.configure_exposure(exposure_ms)
 
-            return web.json_response({
-                'success': True,
-                'exposure_ms': exposure_ms,
-                'message': f'Bottom camera exposure set to {exposure_ms} ms'
-            })
+            return web.json_response(
+                {
+                    "success": True,
+                    "exposure_ms": exposure_ms,
+                    "message": f"Bottom camera exposure set to {exposure_ms} ms",
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_set_light_source_power(self, request):
         """POST /api/light_source/power — set per-line laser power %.
@@ -1568,104 +1691,136 @@ async def handle_set_light_source_power(self, request):
         """
         try:
             data = await request.json()
-            wavelength = int(data.get('wavelength', 488))
-            pct = float(data.get('pct'))
-            light_source = self.devices.get('light_source') or self.devices.get('laser_control')
+            wavelength = int(data.get("wavelength", 488))
+            pct = float(data.get("pct"))
+            light_source = self.devices.get("light_source") or self.devices.get("laser_control")
             if light_source is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'Light source device not found',
-                }, status=503)
+                return web.json_response(
+                    {
+                        "success": False,
+                        "error": "Light source device not found",
+                    },
+                    status=503,
+                )
             try:
                 light_source.set_power_pct(wavelength, pct)
             except (ValueError, KeyError) as e:
-                return web.json_response({
-                    'success': False, 'error': str(e),
-                }, status=400)
+                return web.json_response(
+                    {
+                        "success": False,
+                        "error": str(e),
+                    },
+                    status=400,
+                )
             readback = light_source.get_power_pct(wavelength)
-            return web.json_response({
-                'success': True,
-                'wavelength': wavelength,
-                'pct': pct,
-                'readback_pct': readback,
-            })
+            return web.json_response(
+                {
+                    "success": True,
+                    "wavelength": wavelength,
+                    "pct": pct,
+                    "readback_pct": readback,
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc(),
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_get_light_source_power(self, request):
         """GET /api/light_source/power?wavelength=488 — read laser power %."""
         try:
-            wavelength = int(request.query.get('wavelength', 488))
-            light_source = self.devices.get('light_source') or self.devices.get('laser_control')
+            wavelength = int(request.query.get("wavelength", 488))
+            light_source = self.devices.get("light_source") or self.devices.get("laser_control")
             if light_source is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'Light source device not found',
-                }, status=503)
+                return web.json_response(
+                    {
+                        "success": False,
+                        "error": "Light source device not found",
+                    },
+                    status=503,
+                )
             try:
                 pct = light_source.get_power_pct(wavelength)
             except KeyError as e:
-                return web.json_response({
-                    'success': False, 'error': str(e),
-                }, status=400)
-            return web.json_response({
-                'success': True,
-                'wavelength': wavelength,
-                'pct': float(pct),
-            })
+                return web.json_response(
+                    {
+                        "success": False,
+                        "error": str(e),
+                    },
+                    status=400,
+                )
+            return web.json_response(
+                {
+                    "success": True,
+                    "wavelength": wavelength,
+                    "pct": float(pct),
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc(),
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_get_camera_exposure(self, request):
         """GET /api/camera/exposure - Get bottom camera exposure time"""
         try:
-            bottom_camera = self.devices.get('bottom_camera')
+            bottom_camera = self.devices.get("bottom_camera")
             if bottom_camera is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'Bottom camera device not found'
-                })
+                return web.json_response(
+                    {"success": False, "error": "Bottom camera device not found"}
+                )
 
             exposure_ms = bottom_camera.exposure_time
 
-            return web.json_response({
-                'success': True,
-                'exposure_ms': exposure_ms
-            })
+            return web.json_response({"success": True, "exposure_ms": exposure_ms})
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_get_plan_log(self, request):
         """GET /api/plan_log - Get recent plan execution log with timing"""
         try:
-            limit = int(request.query.get('limit', 100))
-            return web.json_response({
-                'success': True,
-                'entries': self._plan_execution_log[-limit:],
-                'total_count': len(self._plan_execution_log),
-            })
+            limit = int(request.query.get("limit", 100))
+            return web.json_response(
+                {
+                    "success": True,
+                    "entries": self._plan_execution_log[-limit:],
+                    "total_count": len(self._plan_execution_log),
+                }
+            )
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     async def handle_session_configure(self, request):
         """POST /session/configure - set staging directory for file-ref protocol.
@@ -1680,25 +1835,33 @@ async def handle_session_configure(self, request):
                 Path(volume_dir).mkdir(parents=True, exist_ok=True)
                 self._volume_dir = volume_dir
                 logger.info("Session configured: volume_dir = %s", volume_dir)
-                return web.json_response({
-                    "success": True,
-                    "volume_dir": volume_dir,
-                })
+                return web.json_response(
+                    {
+                        "success": True,
+                        "volume_dir": volume_dir,
+                    }
+                )
             else:
                 # Clear staging
                 self._volume_dir = None
-                return web.json_response({
-                    "success": True,
-                    "volume_dir": None,
-                    "message": "Volume staging disabled",
-                })
+                return web.json_response(
+                    {
+                        "success": True,
+                        "volume_dir": None,
+                        "message": "Volume staging disabled",
+                    }
+                )
         except Exception as e:
             import traceback
-            return web.json_response({
-                "success": False,
-                "error": str(e),
-                "traceback": traceback.format_exc(),
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     # =========================================================================
     # HTTP API Handlers - SAM Detection
@@ -1706,13 +1869,15 @@ async def handle_session_configure(self, request):
 
     async def handle_sam_status(self, request):
         """GET /api/sam/status - Check SAM model availability"""
-        return web.json_response({
-            'success': True,
-            'available': True,  # SAM is always available (lazy loaded)
-            'loaded': self._sam_detector is not None,
-            'device': self._sam_device,
-            'model_type': self._sam_model_type,
-        })
+        return web.json_response(
+            {
+                "success": True,
+                "available": True,  # SAM is always available (lazy loaded)
+                "loaded": self._sam_detector is not None,
+                "device": self._sam_device,
+                "model_type": self._sam_model_type,
+            }
+        )
 
     async def handle_detect_embryos(self, request):
         """POST /api/detect_embryos - Capture image and detect embryos.
@@ -1746,76 +1911,81 @@ async def handle_detect_embryos(self, request):
             data = await request.json()
 
             # Extract parameters with defaults
-            from gently.core.coordinates import DEFAULT_PIXEL_SIZE_UM, DEFAULT_OBJECTIVE_MAG
+            from gently.core.coordinates import (
+                DEFAULT_OBJECTIVE_MAG,
+                DEFAULT_PIXEL_SIZE_UM,
+            )
 
-            pixel_size_um = data.get('pixel_size_um', DEFAULT_PIXEL_SIZE_UM)
-            objective_mag = data.get('objective_mag', DEFAULT_OBJECTIVE_MAG)
-            use_claude_review = data.get('use_claude_review', True)
-            min_confidence = data.get('min_confidence', 0.7)
-            exposure_ms = data.get('exposure_ms')
-            brightness_percentile = data.get('brightness_percentile', 99.0)
-            min_area = data.get('min_area', 5000)
-            max_area = data.get('max_area', 150000)
+            pixel_size_um = data.get("pixel_size_um", DEFAULT_PIXEL_SIZE_UM)
+            objective_mag = data.get("objective_mag", DEFAULT_OBJECTIVE_MAG)
+            use_claude_review = data.get("use_claude_review", True)
+            data.get("min_confidence", 0.7)
+            exposure_ms = data.get("exposure_ms")
+            brightness_percentile = data.get("brightness_percentile", 99.0)
+            min_area = data.get("min_area", 5000)
+            max_area = data.get("max_area", 150000)
 
             # Set exposure if specified
             if exposure_ms is not None:
-                bottom_camera = self.devices.get('bottom_camera')
+                bottom_camera = self.devices.get("bottom_camera")
                 if bottom_camera:
                     bottom_camera.configure_exposure(exposure_ms)
 
             # Capture image via plan
             logger.info("[detect_embryos] Capturing bottom camera image...")
             capture_result = await self.submit_plan(
-                'capture_bottom_image_plan',
-                kwargs={'bottom_camera': 'bottom_camera'}
+                "capture_bottom_image_plan", kwargs={"bottom_camera": "bottom_camera"}
             )
 
-            if not capture_result.get('success'):
-                return web.json_response({
-                    'success': False,
-                    'error': f"Image capture failed: {capture_result.get('error', 'Unknown')}"
-                }, status=500)
+            if not capture_result.get("success"):
+                return web.json_response(
+                    {
+                        "success": False,
+                        "error": f"Image capture failed: {capture_result.get('error', 'Unknown')}",
+                    },
+                    status=500,
+                )
 
             # Extract image from result
-            docs = capture_result.get('documents', {})
-            events = docs.get('events', [])
+            docs = capture_result.get("documents", {})
+            events = docs.get("events", [])
             image = None
             if events:
-                event_data = events[0].get('data', {})
-                for key in ['bottom_camera', 'bottom_camera_image', 'Bottom PCO']:
+                event_data = events[0].get("data", {})
+                for key in ["bottom_camera", "bottom_camera_image", "Bottom PCO"]:
                     if key in event_data:
                         val = event_data[key]
                         # Handle file ref
-                        if isinstance(val, dict) and val.get('__file_ref__'):
+                        if isinstance(val, dict) and val.get("__file_ref__"):
                             import tifffile
-                            image = tifffile.imread(val['path'])
+
+                            image = tifffile.imread(val["path"])
                         else:
                             image = np.array(val)
                         break
 
             if image is None:
-                return web.json_response({
-                    'success': False,
-                    'error': 'No image data in capture result'
-                }, status=500)
+                return web.json_response(
+                    {"success": False, "error": "No image data in capture result"},
+                    status=500,
+                )
 
             logger.info("[detect_embryos] Image shape: %s", image.shape)
 
             # Read stage position
             logger.info("[detect_embryos] Reading stage position...")
             stage_result = await self.submit_plan(
-                'read_stage_plan',
-                kwargs={'xy_stage': 'xy_stage'}
+                "read_stage_plan", kwargs={"xy_stage": "xy_stage"}
             )
 
             stage_x, stage_y = 0.0, 0.0
-            if stage_result.get('success'):
-                stage_docs = stage_result.get('documents', {})
-                stage_events = stage_docs.get('events', [])
+            if stage_result.get("success"):
+                stage_docs = stage_result.get("documents", {})
+                stage_events = stage_docs.get("events", [])
                 if stage_events:
-                    stage_data = stage_events[0].get('data', {})
+                    stage_data = stage_events[0].get("data", {})
                     # DiSPIMXYStage.read() returns {device_name: [x, y]}
-                    for key in ['xy_stage', 'XYStage:XY:31', 'xy_stage_position']:
+                    for key in ["xy_stage", "XYStage:XY:31", "xy_stage_position"]:
                         if key in stage_data:
                             val = stage_data[key]
                             if isinstance(val, (list, tuple)) and len(val) >= 2:
@@ -1839,15 +2009,17 @@ async def handle_detect_embryos(self, request):
                 use_claude_review,
                 brightness_percentile,
                 min_area,
-                max_area
+                max_area,
             )
 
             # Save image if volume_dir configured
             image_path = None
             if self._volume_dir:
                 import uuid
+
                 try:
                     import tifffile
+
                     uid = uuid.uuid4().hex[:12]
                     image_path = str(Path(self._volume_dir) / f"detection_{uid}.tif")
                     tifffile.imwrite(image_path, image)
@@ -1856,29 +2028,33 @@ async def handle_detect_embryos(self, request):
 
             # Build response
             response = {
-                'success': sam_result.get('success', False),
-                'embryos': sam_result.get('embryos', []),
-                'initial_detections': sam_result.get('initial_detections', 0),
-                'final_detections': sam_result.get('final_detections', 0),
-                'stage_position': list(stage_position),
-                'verification': sam_result.get('verification', {}),
+                "success": sam_result.get("success", False),
+                "embryos": sam_result.get("embryos", []),
+                "initial_detections": sam_result.get("initial_detections", 0),
+                "final_detections": sam_result.get("final_detections", 0),
+                "stage_position": list(stage_position),
+                "verification": sam_result.get("verification", {}),
             }
 
             if image_path:
-                response['image_path'] = image_path
+                response["image_path"] = image_path
 
-            if 'error' in sam_result:
-                response['error'] = sam_result['error']
+            if "error" in sam_result:
+                response["error"] = sam_result["error"]
 
             return web.json_response(response)
 
         except Exception as e:
             import traceback
-            return web.json_response({
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc()
-            }, status=500)
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
 
     def _run_sam_detection(
         self,
@@ -1890,7 +2066,7 @@ def _run_sam_detection(
         use_claude_review: bool,
         brightness_percentile: float,
         min_area: int,
-        max_area: int
+        max_area: int,
     ) -> dict:
         """Run SAM detection synchronously (called from thread).
 
@@ -1912,12 +2088,12 @@ def _run_sam_detection(
                     output_dir=Path("./detection_results"),
                     brightness_percentile=brightness_percentile,
                     min_area=min_area,
-                    max_area=max_area
+                    max_area=max_area,
                 )
             )
 
             # Ensure results are serializable (convert numpy types)
-            embryos = result.get('embryos', [])
+            embryos = result.get("embryos", [])
             for embryo in embryos:
                 for key, value in list(embryo.items()):
                     if isinstance(value, np.floating):
@@ -1928,18 +2104,19 @@ def _run_sam_detection(
                         # Remove mask from response (not JSON serializable)
                         del embryo[key]
 
-            result['success'] = True
+            result["success"] = True
             return result
 
         except Exception as e:
             import traceback
+
             return {
-                'success': False,
-                'error': str(e),
-                'traceback': traceback.format_exc(),
-                'embryos': [],
-                'initial_detections': 0,
-                'final_detections': 0,
+                "success": False,
+                "error": str(e),
+                "traceback": traceback.format_exc(),
+                "embryos": [],
+                "initial_detections": 0,
+                "final_detections": 0,
             }
         finally:
             loop.close()
@@ -1976,12 +2153,36 @@ def _run_sam_detection(
             "input_schema": {
                 "type": "object",
                 "properties": {
-                    "num_slices": {"type": "integer", "description": "Number of Z slices", "default": 50},
-                    "exposure_ms": {"type": "number", "description": "Camera exposure per slice in ms", "default": 10.0},
-                    "galvo_amplitude": {"type": "number", "description": "Galvo scan range in volts", "default": 0.5},
-                    "galvo_center": {"type": "number", "description": "Galvo center position in volts", "default": 0.0},
-                    "piezo_amplitude": {"type": "number", "description": "Piezo Z range in µm", "default": 25.0},
-                    "piezo_center": {"type": "number", "description": "Piezo center position in µm", "default": 50.0},
+                    "num_slices": {
+                        "type": "integer",
+                        "description": "Number of Z slices",
+                        "default": 50,
+                    },
+                    "exposure_ms": {
+                        "type": "number",
+                        "description": "Camera exposure per slice in ms",
+                        "default": 10.0,
+                    },
+                    "galvo_amplitude": {
+                        "type": "number",
+                        "description": "Galvo scan range in volts",
+                        "default": 0.5,
+                    },
+                    "galvo_center": {
+                        "type": "number",
+                        "description": "Galvo center position in volts",
+                        "default": 0.0,
+                    },
+                    "piezo_amplitude": {
+                        "type": "number",
+                        "description": "Piezo Z range in µm",
+                        "default": 25.0,
+                    },
+                    "piezo_center": {
+                        "type": "number",
+                        "description": "Piezo center position in µm",
+                        "default": 50.0,
+                    },
                 },
             },
             "bluesky_plan": "acquire_single_volume_plan",
@@ -1992,9 +2193,19 @@ def _run_sam_detection(
             "input_schema": {
                 "type": "object",
                 "properties": {
-                    "piezo_position": {"type": "number", "description": "Z position in µm"},
-                    "galvo_position": {"type": "number", "description": "Galvo angle in volts"},
-                    "exposure_ms": {"type": "number", "description": "Camera exposure in ms", "default": 10.0},
+                    "piezo_position": {
+                        "type": "number",
+                        "description": "Z position in µm",
+                    },
+                    "galvo_position": {
+                        "type": "number",
+                        "description": "Galvo angle in volts",
+                    },
+                    "exposure_ms": {
+                        "type": "number",
+                        "description": "Camera exposure in ms",
+                        "default": 10.0,
+                    },
                 },
             },
             "bluesky_plan": "capture_lightsheet_image_plan",
@@ -2005,20 +2216,37 @@ def _run_sam_detection(
             "input_schema": {
                 "type": "object",
                 "properties": {
-                    "use_led": {"type": "boolean", "description": "Turn on LED during capture", "default": False},
-                    "exposure_ms": {"type": "number", "description": "Camera exposure in ms"},
+                    "use_led": {
+                        "type": "boolean",
+                        "description": "Turn on LED during capture",
+                        "default": False,
+                    },
+                    "exposure_ms": {
+                        "type": "number",
+                        "description": "Camera exposure in ms",
+                    },
                 },
             },
             "bluesky_plan": "capture_bottom_image_plan",
             "extractor": "_extract_image",
         },
         "calibrate": {
-            "description": "Run piezo-galvo calibration to find optimal focus parameters for an embryo.",
+            "description": (
+                "Run piezo-galvo calibration to find optimal focus parameters for an embryo."
+            ),
             "input_schema": {
                 "type": "object",
                 "properties": {
-                    "piezo_positions": {"type": "array", "items": {"type": "number"}, "description": "Piezo positions to sweep (µm)"},
-                    "galvo_positions": {"type": "array", "items": {"type": "number"}, "description": "Galvo positions to sweep (volts)"},
+                    "piezo_positions": {
+                        "type": "array",
+                        "items": {"type": "number"},
+                        "description": "Piezo positions to sweep (µm)",
+                    },
+                    "galvo_positions": {
+                        "type": "array",
+                        "items": {"type": "number"},
+                        "description": "Galvo positions to sweep (volts)",
+                    },
                 },
             },
             "bluesky_plan": "calibrate_piezo_galvo_plan",
@@ -2029,7 +2257,11 @@ def _run_sam_detection(
             "input_schema": {
                 "type": "object",
                 "properties": {
-                    "state": {"type": "string", "enum": ["Open", "Closed"], "description": "LED state"},
+                    "state": {
+                        "type": "string",
+                        "enum": ["Open", "Closed"],
+                        "description": "LED state",
+                    },
                 },
                 "required": ["state"],
             },
@@ -2043,17 +2275,46 @@ def _run_sam_detection(
             "extractor": None,
         },
         "detect": {
-            "description": "Detect embryos/samples in the current field of view using SAM segmentation.",
+            "description": (
+                "Detect embryos/samples in the current field of view using SAM segmentation."
+            ),
             "input_schema": {
                 "type": "object",
                 "properties": {
-                    "pixel_size_um": {"type": "number", "description": "Camera pixel size in µm", "default": 6.5},
-                    "objective_mag": {"type": "number", "description": "Objective magnification", "default": 10.0},
-                    "min_confidence": {"type": "number", "description": "Minimum detection confidence", "default": 0.7},
-                    "exposure_ms": {"type": "number", "description": "Camera exposure in ms"},
-                    "brightness_percentile": {"type": "number", "description": "Brightness threshold percentile", "default": 99.0},
-                    "min_area": {"type": "integer", "description": "Minimum embryo area in pixels", "default": 5000},
-                    "max_area": {"type": "integer", "description": "Maximum embryo area in pixels", "default": 150000},
+                    "pixel_size_um": {
+                        "type": "number",
+                        "description": "Camera pixel size in µm",
+                        "default": 6.5,
+                    },
+                    "objective_mag": {
+                        "type": "number",
+                        "description": "Objective magnification",
+                        "default": 10.0,
+                    },
+                    "min_confidence": {
+                        "type": "number",
+                        "description": "Minimum detection confidence",
+                        "default": 0.7,
+                    },
+                    "exposure_ms": {
+                        "type": "number",
+                        "description": "Camera exposure in ms",
+                    },
+                    "brightness_percentile": {
+                        "type": "number",
+                        "description": "Brightness threshold percentile",
+                        "default": 99.0,
+                    },
+                    "min_area": {
+                        "type": "integer",
+                        "description": "Minimum embryo area in pixels",
+                        "default": 5000,
+                    },
+                    "max_area": {
+                        "type": "integer",
+                        "description": "Maximum embryo area in pixels",
+                        "default": 150000,
+                    },
                 },
             },
             "bluesky_plan": None,
@@ -2069,9 +2330,9 @@ def _run_sam_detection(
 
     def _extract_from_events(self, documents: dict, candidate_keys: list) -> Any:
         """Pull data from Bluesky event documents by candidate key names."""
-        events = documents.get('events', [])
+        events = documents.get("events", [])
         for event in events:
-            data = event.get('data', {})
+            data = event.get("data", {})
             for key in candidate_keys:
                 if key in data:
                     return data[key]
@@ -2081,45 +2342,57 @@ def _extract_move(self, documents: dict, params: dict) -> dict:
         return {"success": True, "x": params.get("x"), "y": params.get("y")}
 
     def _extract_position(self, documents: dict, params: dict) -> dict:
-        events = documents.get('events', [])
+        events = documents.get("events", [])
         if events:
-            data = events[0].get('data', {})
-            for key in ['XY:31', 'xy_stage', 'stage']:
+            data = events[0].get("data", {})
+            for key in ["XY:31", "xy_stage", "stage"]:
                 if key in data:
                     val = data[key]
                     if isinstance(val, (list, tuple)) and len(val) >= 2:
                         return {"success": True, "x": float(val[0]), "y": float(val[1])}
                     if isinstance(val, dict):
-                        return {"success": True, "x": float(val.get('x', 0)), "y": float(val.get('y', 0))}
+                        return {
+                            "success": True,
+                            "x": float(val.get("x", 0)),
+                            "y": float(val.get("y", 0)),
+                        }
         return {"success": False, "error": "Could not read position"}
 
     def _extract_volume(self, documents: dict, params: dict) -> dict:
-        val = self._extract_from_events(documents, ['volume_scanner', 'camera', 'camera_image'])
+        val = self._extract_from_events(documents, ["volume_scanner", "camera", "camera_image"])
         if val is not None:
             result = {"success": True}
-            if isinstance(val, dict) and val.get('__file_ref__'):
-                result['volume'] = val  # file ref — client resolves
-                result['shape'] = val.get('shape')
+            if isinstance(val, dict) and val.get("__file_ref__"):
+                result["volume"] = val  # file ref — client resolves
+                result["shape"] = val.get("shape")
             else:
-                result['volume'] = val
-                if hasattr(val, 'shape'):
-                    result['shape'] = list(val.shape)
+                result["volume"] = val
+                if hasattr(val, "shape"):
+                    result["shape"] = list(val.shape)
             return result
         return {"success": False, "error": "No volume data in result"}
 
     def _extract_image(self, documents: dict, params: dict) -> dict:
         val = self._extract_from_events(
-            documents, ['HamCam1', 'lightsheet_snap', 'camera', 'bottom_camera', 'bottom_camera_image', 'Bottom PCO']
+            documents,
+            [
+                "HamCam1",
+                "lightsheet_snap",
+                "camera",
+                "bottom_camera",
+                "bottom_camera_image",
+                "Bottom PCO",
+            ],
         )
         if val is not None:
             result = {"success": True}
-            if isinstance(val, dict) and val.get('__file_ref__'):
-                result['image'] = val
-                result['shape'] = val.get('shape')
+            if isinstance(val, dict) and val.get("__file_ref__"):
+                result["image"] = val
+                result["shape"] = val.get("shape")
             else:
-                result['image'] = val
-                if hasattr(val, 'shape'):
-                    result['shape'] = list(val.shape)
+                result["image"] = val
+                if hasattr(val, "shape"):
+                    result["shape"] = list(val.shape)
             return result
         return {"success": False, "error": "No image data in result"}
 
@@ -2132,8 +2405,8 @@ def _extract_success(self, documents: dict, params: dict) -> dict:
 
     async def handle_microscope_info(self, request):
         """GET /api/microscope — handshake: plans as Anthropic tool schemas."""
+        from . import HARDWARE_DISPLAY_NAME, HARDWARE_NAME
         from .description import HARDWARE_DESCRIPTION
-        from . import HARDWARE_NAME, HARDWARE_DISPLAY_NAME
 
         # Build plan list, filtering to actually-available plans
         available_plans = []
@@ -2141,18 +2414,22 @@ async def handle_microscope_info(self, request):
             bluesky_name = schema.get("bluesky_plan")
             if bluesky_name is None or bluesky_name in self.plans:
                 # Return client-facing fields (Anthropic tool format)
-                available_plans.append({
-                    "name": plan_name,
-                    "description": schema["description"],
-                    "input_schema": schema["input_schema"],
-                })
-
-        return web.json_response({
-            "name": HARDWARE_NAME,
-            "display_name": HARDWARE_DISPLAY_NAME,
-            "description": HARDWARE_DESCRIPTION,
-            "plans": available_plans,
-        })
+                available_plans.append(
+                    {
+                        "name": plan_name,
+                        "description": schema["description"],
+                        "input_schema": schema["input_schema"],
+                    }
+                )
+
+        return web.json_response(
+            {
+                "name": HARDWARE_NAME,
+                "display_name": HARDWARE_DISPLAY_NAME,
+                "description": HARDWARE_DESCRIPTION,
+                "plans": available_plans,
+            }
+        )
 
     async def handle_microscope_execute(self, request):
         """POST /api/microscope/execute — execute a named plan.
@@ -2188,11 +2465,17 @@ async def handle_microscope_execute(self, request):
                     return await self.handle_get_led_status(request)
                 elif plan_name == "status":
                     return await self.handle_status(request)
-                return web.json_response({"success": False, "error": f"Plan '{plan_name}' not implemented"}, status=500)
+                return web.json_response(
+                    {"success": False, "error": f"Plan '{plan_name}' not implemented"},
+                    status=500,
+                )
 
             if bluesky_name not in self.plans:
                 return web.json_response(
-                    {"success": False, "error": f"Hardware plan '{bluesky_name}' not loaded"},
+                    {
+                        "success": False,
+                        "error": f"Hardware plan '{bluesky_name}' not loaded",
+                    },
                     status=500,
                 )
 
@@ -2209,8 +2492,13 @@ async def handle_microscope_execute(self, request):
 
         except Exception as e:
             import traceback
+
             return web.json_response(
-                {"success": False, "error": str(e), "traceback": traceback.format_exc()},
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
                 status=500,
             )
 
@@ -2244,6 +2532,7 @@ async def handle_devices_state(self, request):
             return web.json_response(self._state_latest)
         except Exception as exc:
             import traceback
+
             return web.json_response(
                 {"error": str(exc), "traceback": traceback.format_exc()},
                 status=500,
@@ -2272,8 +2561,11 @@ async def handle_callbacks_stream(self, request):
         queue: asyncio.Queue = asyncio.Queue(maxsize=256)
         self._callback_subscribers.append(queue)
         peer = request.remote
-        logger.info("Callback subscriber connected from %s (total=%d)",
-                    peer, len(self._callback_subscribers))
+        logger.info(
+            "Callback subscriber connected from %s (total=%d)",
+            peer,
+            len(self._callback_subscribers),
+        )
 
         try:
             await response.write(b"event: ready\ndata: {}\n\n")
@@ -2285,9 +2577,7 @@ async def handle_callbacks_stream(self, request):
                     continue
                 if payload is None:
                     break  # shutdown sentinel
-                await response.write(
-                    f"data: {json.dumps(payload)}\n\n".encode()
-                )
+                await response.write(f"data: {json.dumps(payload)}\n\n".encode())
         except (asyncio.CancelledError, ConnectionResetError, ConnectionAbortedError):
             pass
         except Exception:
@@ -2297,8 +2587,11 @@ async def handle_callbacks_stream(self, request):
                 self._callback_subscribers.remove(queue)
             except ValueError:
                 pass
-            logger.info("Callback subscriber disconnected from %s (total=%d)",
-                        peer, len(self._callback_subscribers))
+            logger.info(
+                "Callback subscriber disconnected from %s (total=%d)",
+                peer,
+                len(self._callback_subscribers),
+            )
 
         return response
 
@@ -2326,8 +2619,11 @@ async def handle_devices_stream(self, request):
         queue: asyncio.Queue = asyncio.Queue(maxsize=32)
         self._state_subscribers.append(queue)
         peer = request.remote
-        logger.info("Device-state subscriber connected from %s (total=%d)",
-                    peer, len(self._state_subscribers))
+        logger.info(
+            "Device-state subscriber connected from %s (total=%d)",
+            peer,
+            len(self._state_subscribers),
+        )
 
         try:
             # Send the most recent snapshot immediately so the UI doesn't
@@ -2348,9 +2644,7 @@ async def handle_devices_stream(self, request):
                 # shutdown timeout.
                 if payload is None:
                     break
-                await response.write(
-                    f"data: {json.dumps(payload)}\n\n".encode()
-                )
+                await response.write(f"data: {json.dumps(payload)}\n\n".encode())
         except (asyncio.CancelledError, ConnectionResetError, ConnectionAbortedError):
             pass
         except Exception:
@@ -2360,8 +2654,11 @@ async def handle_devices_stream(self, request):
                 self._state_subscribers.remove(queue)
             except ValueError:
                 pass
-            logger.info("Device-state subscriber disconnected from %s (total=%d)",
-                        peer, len(self._state_subscribers))
+            logger.info(
+                "Device-state subscriber disconnected from %s (total=%d)",
+                peer,
+                len(self._state_subscribers),
+            )
 
         return response
 
@@ -2391,8 +2688,11 @@ async def handle_bottom_camera_stream(self, request):
                 self._bottom_camera_streamer(), name="bottom-camera-streamer"
             )
         peer = request.remote
-        logger.info("Bottom-camera subscriber connected from %s (total=%d)",
-                    peer, len(self._cam_subscribers))
+        logger.info(
+            "Bottom-camera subscriber connected from %s (total=%d)",
+            peer,
+            len(self._cam_subscribers),
+        )
 
         try:
             # Initial comment so the client knows the connection is alive
@@ -2406,9 +2706,7 @@ async def handle_bottom_camera_stream(self, request):
                     continue
                 if payload is None:
                     break  # shutdown sentinel
-                await response.write(
-                    f"data: {json.dumps(payload)}\n\n".encode()
-                )
+                await response.write(f"data: {json.dumps(payload)}\n\n".encode())
         except (asyncio.CancelledError, ConnectionResetError, ConnectionAbortedError):
             pass
         except Exception:
@@ -2418,8 +2716,11 @@ async def handle_bottom_camera_stream(self, request):
                 self._cam_subscribers.remove(queue)
             except ValueError:
                 pass
-            logger.info("Bottom-camera subscriber disconnected from %s (total=%d)",
-                        peer, len(self._cam_subscribers))
+            logger.info(
+                "Bottom-camera subscriber disconnected from %s (total=%d)",
+                peer,
+                len(self._cam_subscribers),
+            )
 
         return response
 
@@ -2435,40 +2736,40 @@ async def on_start(self):
         self._app = web.Application()
 
         # Core endpoints (carried forward from simple_server.py)
-        self._app.router.add_get('/api/status', self.handle_status)
-        self._app.router.add_post('/api/queue/item/add', self.handle_submit_plan)
-        self._app.router.add_get('/api/history', self.handle_get_history)
-        self._app.router.add_get('/api/devices', self.handle_get_devices)
-        self._app.router.add_get('/api/plans', self.handle_get_plans)
-        self._app.router.add_get('/api/led/status', self.handle_get_led_status)
-        self._app.router.add_post('/api/led/set', self.handle_set_led)
-        self._app.router.add_get('/api/temperature/status', self.handle_get_temperature_status)
-        self._app.router.add_post('/api/temperature/set', self.handle_set_temperature)
-        self._app.router.add_get('/api/room_light/status', self.handle_get_room_light_status)
-        self._app.router.add_post('/api/room_light/set', self.handle_set_room_light)
-        self._app.router.add_post('/api/camera/led_mode', self.handle_set_camera_led_mode)
-        self._app.router.add_post('/api/camera/exposure', self.handle_set_camera_exposure)
-        self._app.router.add_get('/api/camera/exposure', self.handle_get_camera_exposure)
-        self._app.router.add_post('/api/light_source/power', self.handle_set_light_source_power)
-        self._app.router.add_get('/api/light_source/power', self.handle_get_light_source_power)
-        self._app.router.add_get('/api/plan_log', self.handle_get_plan_log)
-        self._app.router.add_post('/session/configure', self.handle_session_configure)
+        self._app.router.add_get("/api/status", self.handle_status)
+        self._app.router.add_post("/api/queue/item/add", self.handle_submit_plan)
+        self._app.router.add_get("/api/history", self.handle_get_history)
+        self._app.router.add_get("/api/devices", self.handle_get_devices)
+        self._app.router.add_get("/api/plans", self.handle_get_plans)
+        self._app.router.add_get("/api/led/status", self.handle_get_led_status)
+        self._app.router.add_post("/api/led/set", self.handle_set_led)
+        self._app.router.add_get("/api/temperature/status", self.handle_get_temperature_status)
+        self._app.router.add_post("/api/temperature/set", self.handle_set_temperature)
+        self._app.router.add_get("/api/room_light/status", self.handle_get_room_light_status)
+        self._app.router.add_post("/api/room_light/set", self.handle_set_room_light)
+        self._app.router.add_post("/api/camera/led_mode", self.handle_set_camera_led_mode)
+        self._app.router.add_post("/api/camera/exposure", self.handle_set_camera_exposure)
+        self._app.router.add_get("/api/camera/exposure", self.handle_get_camera_exposure)
+        self._app.router.add_post("/api/light_source/power", self.handle_set_light_source_power)
+        self._app.router.add_get("/api/light_source/power", self.handle_get_light_source_power)
+        self._app.router.add_get("/api/plan_log", self.handle_get_plan_log)
+        self._app.router.add_post("/session/configure", self.handle_session_configure)
 
         # SAM endpoints (new - replaces RPyC sam_server.py)
-        self._app.router.add_get('/api/sam/status', self.handle_sam_status)
-        self._app.router.add_post('/api/detect_embryos', self.handle_detect_embryos)
+        self._app.router.add_get("/api/sam/status", self.handle_sam_status)
+        self._app.router.add_post("/api/detect_embryos", self.handle_detect_embryos)
 
         # Microscope API (generic plan-based interface)
-        self._app.router.add_get('/api/microscope', self.handle_microscope_info)
-        self._app.router.add_post('/api/microscope/execute', self.handle_microscope_execute)
+        self._app.router.add_get("/api/microscope", self.handle_microscope_info)
+        self._app.router.add_post("/api/microscope/execute", self.handle_microscope_execute)
 
         # Device state streaming (positions + properties)
-        self._app.router.add_get('/api/devices/state', self.handle_devices_state)
-        self._app.router.add_get('/api/devices/stream', self.handle_devices_stream)
-        self._app.router.add_get('/api/devices/callbacks/stream', self.handle_callbacks_stream)
+        self._app.router.add_get("/api/devices/state", self.handle_devices_state)
+        self._app.router.add_get("/api/devices/stream", self.handle_devices_stream)
+        self._app.router.add_get("/api/devices/callbacks/stream", self.handle_callbacks_stream)
 
         # Bottom-camera live stream (subscriber-gated, off when nobody listens)
-        self._app.router.add_get('/api/bottom_camera/stream', self.handle_bottom_camera_stream)
+        self._app.router.add_get("/api/bottom_camera/stream", self.handle_bottom_camera_stream)
 
         # Start plan executor
         self._executor_task = asyncio.create_task(self._plan_executor())
@@ -2494,7 +2795,10 @@ async def on_start(self):
         logger.info("=" * 60)
         logger.info("HTTP API available at http://%s:%d", self.host, self.port)
         logger.info("=" * 60)
-        logger.info("Endpoints: GET /api/status, GET /api/devices, GET /api/plans, POST /api/queue/item/add, ...")
+        logger.info(
+            "Endpoints: GET /api/status, GET /api/devices, GET /api/plans,"
+            " POST /api/queue/item/add, ..."
+        )
 
         await site.start()
         self._print_ready_panel()
@@ -2505,7 +2809,13 @@ def _categorize_devices(self):
         First-match-wins so 'room_light' lands in Accessory (not Light) and
         'volume_scanner' in Motion. Accessory entries carry live state.
         """
-        buckets = {"Motion": [], "Imaging": [], "Light": [], "Accessory": [], "Other": []}
+        buckets = {
+            "Motion": [],
+            "Imaging": [],
+            "Light": [],
+            "Accessory": [],
+            "Other": [],
+        }
         for name in sorted(self.devices):
             low = name.lower()
             if low in ("room_light", "temperature"):
@@ -2535,6 +2845,7 @@ def _print_ready_panel(self):
         URL the agent connects to, a grouped device inventory and accessory
         states at a glance — instead of a silent console after the banner.
         """
+
         def _fmt(names, limit=6):
             if len(names) <= limit:
                 return " · ".join(names)
@@ -2574,7 +2885,11 @@ async def on_stop(self):
         #    sitting in `wait_for(queue.get(), timeout=10)` and forcing aiohttp
         #    to wait out its shutdown timeout. Done first so handlers drain
         #    before we cancel pollers (which would block on in-flight to_thread).
-        for queues in (self._state_subscribers, self._callback_subscribers, self._cam_subscribers):
+        for queues in (
+            self._state_subscribers,
+            self._callback_subscribers,
+            self._cam_subscribers,
+        ):
             for q in list(queues):
                 try:
                     q.put_nowait(None)
@@ -2592,8 +2907,12 @@ async def on_stop(self):
         #    transfer). If MMCore is hung or a long exposure is set, we'd
         #    otherwise wait forever — so each task gets a 3 s ceiling. A
         #    timed-out thread leaks until interpreter shutdown reaps it.
-        for task_attr in ("_state_pos_task", "_state_slow_pos_task",
-                          "_state_prop_task", "_cam_task"):
+        for task_attr in (
+            "_state_pos_task",
+            "_state_slow_pos_task",
+            "_state_prop_task",
+            "_cam_task",
+        ):
             task = getattr(self, task_attr, None)
             if task is not None:
                 task.cancel()
@@ -2603,7 +2922,8 @@ async def on_stop(self):
                     if not task.done():
                         logger.warning(
                             "%s did not exit within shutdown timeout; "
-                            "leaking thread, continuing shutdown", task_attr,
+                            "leaking thread, continuing shutdown",
+                            task_attr,
                         )
                 setattr(self, task_attr, None)
         if self._executor_task:
@@ -2617,12 +2937,12 @@ async def on_stop(self):
         logger.info("Device layer stopped.")
         cui.note("Device layer stopped.", "grey")
 
-    async def health_check(self) -> Dict:
+    async def health_check(self) -> dict:
         """Return health status with device count, queue size, SAM status."""
         base = await super().health_check()
-        base['device_count'] = len(self.devices)
-        base['queue_size'] = self._plan_queue.qsize()
-        base['sam_loaded'] = self._sam_detector is not None
+        base["device_count"] = len(self.devices)
+        base["queue_size"] = self._plan_queue.qsize()
+        base["sam_loaded"] = self._sam_detector is not None
         return base
 
     async def run(self, host: str = None, port: int = None):
@@ -2656,13 +2976,18 @@ async def main(port: int = settings.network.device_port, sam_device: str = "cuda
 
     parser = argparse.ArgumentParser(description="Gently Device Layer Server")
     parser.add_argument("--port", type=int, default=settings.network.device_port, help="HTTP port")
-    parser.add_argument("--sam-device", default="cuda", choices=["cuda", "cpu"],
-                        help="Device for SAM model (default: cuda)")
+    parser.add_argument(
+        "--sam-device",
+        default="cuda",
+        choices=["cuda", "cpu"],
+        help="Device for SAM model (default: cuda)",
+    )
 
     args = parser.parse_args()
 
-    from pathlib import Path
     from datetime import datetime
+    from pathlib import Path
+
     log_dir = Path(settings.storage.base_path) / "logs"
     log_dir.mkdir(parents=True, exist_ok=True)
     log_file = str(log_dir / f"device_layer_{datetime.now().strftime('%Y%m%d_%H%M%S')}.log")
diff --git a/gently/hardware/dispim/devices/__init__.py b/gently/hardware/dispim/devices/__init__.py
index 5910460a..a41c025e 100644
--- a/gently/hardware/dispim/devices/__init__.py
+++ b/gently/hardware/dispim/devices/__init__.py
@@ -5,20 +5,26 @@
     from gently.devices import DiSPIMCamera, DiSPIMPiezo, ...
 """
 
-from .stage import DiSPIMZstage, DiSPIMXYStage
-from .camera import DiSPIMCamera, DiSPIMDualCamera, DiSPIMBottomCamera
+from .acquisition import DiSPIMLightSheetSnap, DiSPIMVolumeScanner
+from .camera import DiSPIMBottomCamera, DiSPIMCamera, DiSPIMDualCamera
+from .optical import DiSPIMLaserControl, DiSPIMLED, DiSPIMLightSource
 from .piezo import DiSPIMFDrive, DiSPIMPiezo
 from .scanner import DiSPIMScanner
-from .optical import DiSPIMLED, DiSPIMLightSource, DiSPIMLaserControl
-from .acquisition import DiSPIMVolumeScanner, DiSPIMLightSheetSnap
+from .stage import DiSPIMXYStage, DiSPIMZstage
 
 __all__ = [
-    "DiSPIMZstage", "DiSPIMXYStage",
-    "DiSPIMCamera", "DiSPIMDualCamera", "DiSPIMBottomCamera",
-    "DiSPIMFDrive", "DiSPIMPiezo",
+    "DiSPIMZstage",
+    "DiSPIMXYStage",
+    "DiSPIMCamera",
+    "DiSPIMDualCamera",
+    "DiSPIMBottomCamera",
+    "DiSPIMFDrive",
+    "DiSPIMPiezo",
     "DiSPIMScanner",
-    "DiSPIMLED", "DiSPIMLightSource",
+    "DiSPIMLED",
+    "DiSPIMLightSource",
     # Backwards-compatible alias for DiSPIMLightSource:
     "DiSPIMLaserControl",
-    "DiSPIMVolumeScanner", "DiSPIMLightSheetSnap",
+    "DiSPIMVolumeScanner",
+    "DiSPIMLightSheetSnap",
 ]
diff --git a/gently/hardware/dispim/devices/acquisition.py b/gently/hardware/dispim/devices/acquisition.py
index c281aaea..ad8080ce 100644
--- a/gently/hardware/dispim/devices/acquisition.py
+++ b/gently/hardware/dispim/devices/acquisition.py
@@ -2,22 +2,21 @@
 DiSPIM compound acquisition devices (volume scanner and light sheet snap).
 """
 
-import time
 import logging
+import time
 from collections import OrderedDict
-from typing import Dict
 
 import numpy as np
-
-from ophyd.status import Status
 import pymmcore
+from ophyd.status import Status
 
 from gently.settings import settings
+
 from ._common import _safe_obtain
-from .scanner import DiSPIMScanner
 from .camera import DiSPIMCamera
-from .piezo import DiSPIMPiezo
 from .optical import DiSPIMLaserControl
+from .piezo import DiSPIMPiezo
+from .scanner import DiSPIMScanner
 
 logger = logging.getLogger(__name__)
 
@@ -56,13 +55,15 @@ class DiSPIMVolumeScanner:
         Device name (default: "volume_scanner")
     """
 
-    def __init__(self,
-                 scanner: DiSPIMScanner,
-                 camera: DiSPIMCamera,
-                 piezo: DiSPIMPiezo,
-                 laser_control: 'DiSPIMLaserControl',
-                 core: pymmcore.CMMCore,
-                 name: str = "volume_scanner"):
+    def __init__(
+        self,
+        scanner: DiSPIMScanner,
+        camera: DiSPIMCamera,
+        piezo: DiSPIMPiezo,
+        laser_control: "DiSPIMLaserControl",
+        core: pymmcore.CMMCore,
+        name: str = "volume_scanner",
+    ):
         """
         Initialize volume scanner with all required devices.
 
@@ -87,19 +88,21 @@ def __init__(self,
         self._exposure_ms = None
         self._laser_config = None
 
-    def configure(self,
-                  num_slices: int,
-                  exposure_ms: float,
-                  galvo_amplitude: float,
-                  galvo_center: float,
-                  piezo_amplitude: float,
-                  piezo_center: float,
-                  laser_config: str = "488 and 561",
-                  laser_power_488_pct: float = None,
-                  laser_power_561_pct: float = None,
-                  laser_power_405_pct: float = None,
-                  laser_power_637_pct: float = None,
-                  timing_params: Dict = None):
+    def configure(
+        self,
+        num_slices: int,
+        exposure_ms: float,
+        galvo_amplitude: float,
+        galvo_center: float,
+        piezo_amplitude: float,
+        piezo_center: float,
+        laser_config: str = "488 and 561",
+        laser_power_488_pct: float = None,
+        laser_power_561_pct: float = None,
+        laser_power_405_pct: float = None,
+        laser_power_637_pct: float = None,
+        timing_params: dict = None,
+    ):
         """
         Configure all devices for hardware-triggered volume acquisition.
 
@@ -120,7 +123,8 @@ def configure(self,
         laser_config : str
             Laser channel selection preset (default: "488 and 561").
             Common options: "488 and 561", "488 only", "561 only"
-        laser_power_488_pct, laser_power_561_pct, laser_power_405_pct, laser_power_637_pct : float, optional
+        laser_power_488_pct, laser_power_561_pct, laser_power_405_pct,
+        laser_power_637_pct : float, optional
             Per-line laser power %. ``None`` leaves the current setpoint
             unchanged. Out-of-range values are rejected at the device-layer
             setter (see DiSPIMLightSource.POWER_LIMITS_PCT).
@@ -135,14 +139,12 @@ def configure(self,
             galvo_amplitude=galvo_amplitude,
             galvo_center=galvo_center,
             num_slices=num_slices,
-            timing_params=timing_params
+            timing_params=timing_params,
         )
 
         # Configure piezo for volume acquisition
         self.piezo.configure_for_volume_acquisition(
-            amplitude_um=piezo_amplitude,
-            offset_um=piezo_center,
-            num_slices=num_slices
+            amplitude_um=piezo_amplitude, offset_um=piezo_center, num_slices=num_slices
         )
 
         # Apply per-line laser power if specified. Each setter raises if the
@@ -258,6 +260,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -267,8 +270,8 @@ def read(self):
         if self._last_volume is not None:
             data = OrderedDict()
             data[self.name] = {
-                'value': self._last_volume,
-                'timestamp': self._last_volume_time or time.time()
+                "value": self._last_volume,
+                "timestamp": self._last_volume_time or time.time(),
             }
             return data
         else:
@@ -278,10 +281,10 @@ def describe(self):
         """Describe volume data format."""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'array',
-            'shape': getattr(self._last_volume, 'shape', []),
-            'units': 'counts'
+            "source": self.name,
+            "dtype": "array",
+            "shape": getattr(self._last_volume, "shape", []),
+            "units": "counts",
         }
         return data
 
@@ -302,10 +305,12 @@ class DiSPIMLightSheetSnap:
     Used during focus sweeps and piezo-galvo calibration.
     """
 
-    def __init__(self,
-                 scanner: DiSPIMScanner,
-                 camera: DiSPIMCamera,
-                 name: str = "lightsheet_snap"):
+    def __init__(
+        self,
+        scanner: DiSPIMScanner,
+        camera: DiSPIMCamera,
+        name: str = "lightsheet_snap",
+    ):
         self.name = name
         self.parent = None  # Required for Bluesky
         self.scanner = scanner
@@ -314,10 +319,12 @@ def __init__(self,
         self._last_image = None
         self._last_image_time = None
 
-    def configure(self,
-                  sheet_width_deg: float = 8.0,
-                  y_position_deg: float = 0.0,
-                  exposure_ms: float = 50.0):
+    def configure(
+        self,
+        sheet_width_deg: float = 8.0,
+        y_position_deg: float = 0.0,
+        exposure_ms: float = 50.0,
+    ):
         """
         Configure light sheet parameters for single snapshot.
 
diff --git a/gently/hardware/dispim/devices/camera.py b/gently/hardware/dispim/devices/camera.py
index 34daafca..5141d6d4 100644
--- a/gently/hardware/dispim/devices/camera.py
+++ b/gently/hardware/dispim/devices/camera.py
@@ -2,16 +2,16 @@
 DiSPIM camera detector devices (single, dual, and bottom camera).
 """
 
-import time
 import logging
+import time
 from collections import OrderedDict
-from typing import Tuple
 
 import numpy as np
-from ophyd.status import Status
 import pymmcore
+from ophyd.status import Status
+
+from gently.exceptions import AcquisitionError, HardwareError
 
-from gently.exceptions import HardwareError, AcquisitionError
 from ._common import _safe_obtain
 
 logger = logging.getLogger(__name__)
@@ -68,10 +68,10 @@ def wait():
             else:
                 status.set_finished()
 
-
         status = Status(obj=self, timeout=30)
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -81,8 +81,8 @@ def read(self):
         if self._last_image is not None:
             data = OrderedDict()
             data[self.name] = {
-                'value': self._last_image,
-                'timestamp': self._last_image_time or time.time()
+                "value": self._last_image,
+                "timestamp": self._last_image_time or time.time(),
             }
             return data
         else:
@@ -92,9 +92,9 @@ def describe(self):
         """Describe detector data format"""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'array',
-            'shape': getattr(self._last_image, 'shape', [])
+            "source": self.name,
+            "dtype": "array",
+            "shape": getattr(self._last_image, "shape", []),
         }
         return data
 
@@ -191,8 +191,9 @@ def set_trigger_active(self, mode: str):
         """
         self.core.setProperty(self.name, "TRIGGER ACTIVE", mode)
 
-    def configure_for_calibration(self, exposure_ms: float,
-                                   roi: Tuple[int, int, int, int] = (128, 896, 2048, 512)):
+    def configure_for_calibration(
+        self, exposure_ms: float, roi: tuple[int, int, int, int] = (128, 896, 2048, 512)
+    ):
         """
         Configure camera for calibration imaging (single light sheet snapshots).
 
@@ -212,8 +213,9 @@ def configure_for_calibration(self, exposure_ms: float,
         self.core.setExposure(self.name, exposure_ms)
         self.core.waitForDevice(self.name)
 
-    def configure_for_volume_acquisition(self, exposure_ms: float,
-                                          roi: Tuple[int, int, int, int] = (128, 896, 2048, 512)):
+    def configure_for_volume_acquisition(
+        self, exposure_ms: float, roi: tuple[int, int, int, int] = (128, 896, 2048, 512)
+    ):
         """
         Configure camera for hardware-triggered volume acquisition.
 
@@ -280,8 +282,8 @@ def read(self):
         camera_data = self.camera.read()
 
         if self.camera.name in camera_data:
-            stitched_image = camera_data[self.camera.name]['value']
-            timestamp = camera_data[self.camera.name]['timestamp']
+            stitched_image = camera_data[self.camera.name]["value"]
+            timestamp = camera_data[self.camera.name]["timestamp"]
 
             # Split image in the middle (width dimension)
             height, width = stitched_image.shape[:2]
@@ -292,14 +294,8 @@ def read(self):
 
             # Return as separate data entries
             data = OrderedDict()
-            data[f'{self.name}_image_a'] = {
-                'value': image_a,
-                'timestamp': timestamp
-            }
-            data[f'{self.name}_image_b'] = {
-                'value': image_b,
-                'timestamp': timestamp
-            }
+            data[f"{self.name}_image_a"] = {"value": image_a, "timestamp": timestamp}
+            data[f"{self.name}_image_b"] = {"value": image_b, "timestamp": timestamp}
             return data
         else:
             return OrderedDict()
@@ -314,7 +310,7 @@ def describe(self):
         # Describe image_a and image_b outputs
         # Shape will be half width of original stitched image
         if self.camera.name in camera_desc:
-            original_shape = camera_desc[self.camera.name].get('shape', [])
+            original_shape = camera_desc[self.camera.name].get("shape", [])
             if len(original_shape) >= 2:
                 # Split width dimension in half
                 split_shape = [original_shape[0], original_shape[1] // 2]
@@ -323,15 +319,15 @@ def describe(self):
             else:
                 split_shape = original_shape
 
-            data[f'{self.name}_image_a'] = {
-                'source': f'{self.name}_image_a',
-                'dtype': 'array',
-                'shape': split_shape
+            data[f"{self.name}_image_a"] = {
+                "source": f"{self.name}_image_a",
+                "dtype": "array",
+                "shape": split_shape,
             }
-            data[f'{self.name}_image_b'] = {
-                'source': f'{self.name}_image_b',
-                'dtype': 'array',
-                'shape': split_shape
+            data[f"{self.name}_image_b"] = {
+                "source": f"{self.name}_image_b",
+                "dtype": "array",
+                "shape": split_shape,
             }
 
         return data
@@ -362,12 +358,14 @@ class DiSPIMBottomCamera(DiSPIMCamera):
     Used for finding and centering embryos in the sample chamber.
     """
 
-    def __init__(self,
-                 device_name: str,
-                 core: pymmcore.CMMCore,
-                 led_control: 'DiSPIMLED',
-                 pixel_size_um: float = 6.5,
-                 magnification: float = 10.0):
+    def __init__(
+        self,
+        device_name: str,
+        core: pymmcore.CMMCore,
+        led_control: "DiSPIMLED",  # noqa: F821
+        pixel_size_um: float = 6.5,
+        magnification: float = 10.0,
+    ):
         """
         Initialize bottom camera with LED control and calibrated pixel size.
 
@@ -455,6 +453,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
diff --git a/gently/hardware/dispim/devices/optical.py b/gently/hardware/dispim/devices/optical.py
index 87430df8..4108a700 100644
--- a/gently/hardware/dispim/devices/optical.py
+++ b/gently/hardware/dispim/devices/optical.py
@@ -2,12 +2,12 @@
 DiSPIM optical control devices (LED and laser).
 """
 
-import time
 import logging
+import time
 from collections import OrderedDict
 
-from ophyd.status import Status
 import pymmcore
+from ophyd.status import Status
 
 logger = logging.getLogger(__name__)
 
@@ -39,8 +39,7 @@ def _get_available_configs(self):
     def set(self, state: str):
         """Set LED state - called by bps.mv(led, 'Open') or bps.mv(led, 'Closed')"""
         if state not in self._available_configs:
-            raise ValueError(f"State '{state}' not available. "
-                           f"Available: {self._available_configs}")
+            raise ValueError(f"State '{state}' not available. Available: {self._available_configs}")
 
         status = Status(obj=self, timeout=5)
 
@@ -54,6 +53,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -63,23 +63,16 @@ def read(self):
         try:
             current_config = self.core.getCurrentConfig(self.group_name)
         except Exception:
-            current_config = 'unknown'
+            current_config = "unknown"
 
         data = OrderedDict()
-        data[self.name] = {
-            'value': current_config,
-            'timestamp': time.time()
-        }
+        data[self.name] = {"value": current_config, "timestamp": time.time()}
         return data
 
     def describe(self):
         """Describe LED device - required for Bluesky"""
         data = OrderedDict()
-        data[self.name] = {
-            'source': self.name,
-            'dtype': 'string',
-            'shape': []
-        }
+        data[self.name] = {"source": self.name, "dtype": "string", "shape": []}
         return data
 
     def read_configuration(self):
@@ -154,8 +147,9 @@ def _get_available_configs(self):
     def set(self, config_name: str):
         """Set laser configuration - called by bps.mv(laser, 'config_name')"""
         if config_name not in self._available_configs:
-            raise ValueError(f"Config '{config_name}' not available. "
-                           f"Available: {self._available_configs}")
+            raise ValueError(
+                f"Config '{config_name}' not available. Available: {self._available_configs}"
+            )
 
         status = Status(obj=self, timeout=5)
 
@@ -169,6 +163,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -214,7 +209,10 @@ def set_power_pct(self, wavelength: int, pct: float) -> None:
         # No waitForDevice — analog setpoint applies on the next exposure.
         logger.debug(
             "Set %dnm power to %.4f%% (%s / %s)",
-            wavelength, pct, self.POWER_DEVICE_LABEL, prop,
+            wavelength,
+            pct,
+            self.POWER_DEVICE_LABEL,
+            prop,
         )
 
     def get_power_pct(self, wavelength: int) -> float:
@@ -224,32 +222,25 @@ def get_power_pct(self, wavelength: int) -> float:
                 f"Unknown laser wavelength {wavelength}nm. "
                 f"Available: {sorted(self.POWER_PROPERTY.keys())}"
             )
-        return float(self.core.getProperty(
-            self.POWER_DEVICE_LABEL, self.POWER_PROPERTY[wavelength]
-        ))
+        return float(
+            self.core.getProperty(self.POWER_DEVICE_LABEL, self.POWER_PROPERTY[wavelength])
+        )
 
     def read(self):
         """Read current laser configuration - required for Bluesky"""
         try:
             current_config = self.core.getCurrentConfig(self.group_name)
         except Exception:
-            current_config = 'unknown'
+            current_config = "unknown"
 
         data = OrderedDict()
-        data[self.name] = {
-            'value': current_config,
-            'timestamp': time.time()
-        }
+        data[self.name] = {"value": current_config, "timestamp": time.time()}
         return data
 
     def describe(self):
         """Describe laser control device - required for Bluesky"""
         data = OrderedDict()
-        data[self.name] = {
-            'source': self.group_name,
-            'dtype': 'string',
-            'shape': []
-        }
+        data[self.name] = {"source": self.group_name, "dtype": "string", "shape": []}
         return data
 
     def read_configuration(self):
diff --git a/gently/hardware/dispim/devices/piezo.py b/gently/hardware/dispim/devices/piezo.py
index 91161e12..780e507e 100644
--- a/gently/hardware/dispim/devices/piezo.py
+++ b/gently/hardware/dispim/devices/piezo.py
@@ -2,13 +2,12 @@
 DiSPIM piezo and F-drive positioner devices.
 """
 
-import time
 import logging
+import time
 from collections import OrderedDict
-from typing import Tuple
 
-from ophyd.status import Status
 import pymmcore
+from ophyd.status import Status
 
 from gently.exceptions import HardwareError, StageMovementError
 
@@ -58,8 +57,7 @@ class DiSPIMFDrive:
     above — see the safety-limit note above this class.
     """
 
-    def __init__(self, name: str, core: pymmcore.CMMCore,
-                 move_timeout_s: float = 120.0):
+    def __init__(self, name: str, core: pymmcore.CMMCore, move_timeout_s: float = 120.0):
         self.name = name
         self.core = core
         self.parent = None  # Required for Bluesky
@@ -71,7 +69,7 @@ def __init__(self, name: str, core: pymmcore.CMMCore,
         self.tolerance = 0.1  # µm
 
     @property
-    def limits(self) -> Tuple[float, float]:
+    def limits(self) -> tuple[float, float]:
         """Read-only view of the hardware safety limits (module constants)."""
         return (F_DRIVE_MIN_UM, F_DRIVE_MAX_UM)
 
@@ -100,6 +98,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -113,9 +112,9 @@ def read(self):
 
         data = OrderedDict()
         data[self.name] = {
-            'value': float(value),
-            'timestamp': time.time(),
-            'units': 'micrometers'
+            "value": float(value),
+            "timestamp": time.time(),
+            "units": "micrometers",
         }
         return data
 
@@ -123,10 +122,10 @@ def describe(self):
         """Describe F-drive device - required for Bluesky"""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'number',
-            'shape': [],
-            'units': 'micrometers'
+            "source": self.name,
+            "dtype": "number",
+            "shape": [],
+            "units": "micrometers",
         }
         return data
 
@@ -147,8 +146,12 @@ class DiSPIMPiezo:
     Device-agnostic: any plan that moves a positioner will work with this device
     """
 
-    def __init__(self, name: str, core: pymmcore.CMMCore,
-                 limits: Tuple[float, float] = (-200, 200.0)):
+    def __init__(
+        self,
+        name: str,
+        core: pymmcore.CMMCore,
+        limits: tuple[float, float] = (-200, 200.0),
+    ):
         self.name = name
         self.core = core
         self.parent = None  # Required for Bluesky
@@ -180,6 +183,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -194,9 +198,9 @@ def read(self):
 
         data = OrderedDict()
         data[self.name] = {
-            'value': float(value),
-            'timestamp': time.time(),
-            'units': 'micrometers'
+            "value": float(value),
+            "timestamp": time.time(),
+            "units": "micrometers",
         }
         return data
 
@@ -204,10 +208,10 @@ def describe(self):
         """Describe piezo device - required for Bluesky"""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'number',
-            'shape': [],
-            'units': 'micrometers'
+            "source": self.name,
+            "dtype": "number",
+            "shape": [],
+            "units": "micrometers",
         }
         return data
 
@@ -236,10 +240,9 @@ def set_as_focus_device(self):
         """Set this piezo as the Micro-Manager focus device."""
         self.core.setFocusDevice(self.name)
 
-    def configure_amplitude_offset(self,
-                                    amplitude_um: float,
-                                    offset_um: float,
-                                    pattern: str = "1 - Triangle"):
+    def configure_amplitude_offset(
+        self, amplitude_um: float, offset_um: float, pattern: str = "1 - Triangle"
+    ):
         """
         Configure piezo amplitude and offset for scanning.
 
@@ -280,10 +283,9 @@ def configure_for_spim(self, num_slices: int):
         """
         self.core.setProperty(self.name, "SPIMNumSlices", num_slices)
 
-    def configure_for_volume_acquisition(self,
-                                          amplitude_um: float,
-                                          offset_um: float,
-                                          num_slices: int):
+    def configure_for_volume_acquisition(
+        self, amplitude_um: float, offset_um: float, num_slices: int
+    ):
         """
         Configure piezo for hardware-triggered volume acquisition.
 
diff --git a/gently/hardware/dispim/devices/scanner.py b/gently/hardware/dispim/devices/scanner.py
index b4a92995..79732ef1 100644
--- a/gently/hardware/dispim/devices/scanner.py
+++ b/gently/hardware/dispim/devices/scanner.py
@@ -2,15 +2,13 @@
 DiSPIM scanner/galvo mirror control devices.
 """
 
-import time
 import logging
+import time
 from collections import OrderedDict
-from typing import Dict, Tuple
 
 import numpy as np
-
-from ophyd.status import Status
 import pymmcore
+from ophyd.status import Status
 
 from gently.exceptions import HardwareError, StageMovementError
 
@@ -36,9 +34,7 @@ def set(self, value):
 
         def wait():
             try:
-                self.scanner.core.setProperty(
-                    self.scanner.name, self.property_name, float(value)
-                )
+                self.scanner.core.setProperty(self.scanner.name, self.property_name, float(value))
                 self.scanner.core.waitForDevice(self.scanner.name)
             except (RuntimeError, StageMovementError) as exc:
                 status.set_exception(exc)
@@ -46,6 +42,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
         return status
 
@@ -56,38 +53,32 @@ def setPosition(self, value: float) -> None:
         the Status/thread plumbing. MMCore traffic stays inside this ophyd
         boundary.
         """
-        self.scanner.core.setProperty(
-            self.scanner.name, self.property_name, float(value)
-        )
+        self.scanner.core.setProperty(self.scanner.name, self.property_name, float(value))
         self.scanner.core.waitForDevice(self.scanner.name)
 
     def read(self):
         """Read current offset value"""
         try:
-            value = float(self.scanner.core.getProperty(
-                self.scanner.name, self.property_name
-            ))
+            value = float(self.scanner.core.getProperty(self.scanner.name, self.property_name))
         except (RuntimeError, HardwareError):
             value = 0.0
 
-        return OrderedDict({
-            self.name: {
-                'value': value,
-                'timestamp': time.time(),
-                'units': 'degrees'
-            }
-        })
+        return OrderedDict(
+            {self.name: {"value": value, "timestamp": time.time(), "units": "degrees"}}
+        )
 
     def describe(self):
         """Describe component"""
-        return OrderedDict({
-            self.name: {
-                'source': self.name,
-                'dtype': 'number',
-                'shape': [],
-                'units': 'degrees'
+        return OrderedDict(
+            {
+                self.name: {
+                    "source": self.name,
+                    "dtype": "number",
+                    "shape": [],
+                    "units": "degrees",
+                }
             }
-        })
+        )
 
 
 class DiSPIMScanner:
@@ -102,16 +93,20 @@ class DiSPIMScanner:
         bps.mv(scanner.sa_offset_y, y_value)  # Y-axis offset (galvo position)
     """
 
-    def __init__(self, name: str, core: pymmcore.CMMCore,
-                 limits: Tuple[float, float] = (-5.0, 5.0)):
+    def __init__(
+        self,
+        name: str,
+        core: pymmcore.CMMCore,
+        limits: tuple[float, float] = (-5.0, 5.0),
+    ):
         self.name = name
         self.core = core
         self.parent = None  # Required for Bluesky
         self._limits = limits
 
         # Create movable axis offset components for use with bps.mv()
-        self.sa_offset_x = _ScannerAxisOffset(self, 'x', 'SingleAxisXOffset(deg)')
-        self.sa_offset_y = _ScannerAxisOffset(self, 'y', 'SingleAxisYOffset(deg)')
+        self.sa_offset_x = _ScannerAxisOffset(self, "x", "SingleAxisXOffset(deg)")
+        self.sa_offset_y = _ScannerAxisOffset(self, "y", "SingleAxisYOffset(deg)")
 
     @property
     def limits(self):
@@ -143,6 +138,7 @@ def wait():
                     status.set_finished()
 
             import threading
+
             threading.Thread(target=wait).start()
 
             return status
@@ -162,21 +158,17 @@ def read(self):
             ab_pos = np.array([0.0, 0.0])
 
         data = OrderedDict()
-        data[self.name] = {
-            'value': ab_pos,
-            'timestamp': time.time(),
-            'units': 'volts'
-        }
+        data[self.name] = {"value": ab_pos, "timestamp": time.time(), "units": "volts"}
         return data
 
     def describe(self):
         """Describe scanner device - required for Bluesky"""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'array',
-            'shape': [2],
-            'units': 'volts'
+            "source": self.name,
+            "dtype": "array",
+            "shape": [2],
+            "units": "volts",
         }
         return data
 
@@ -224,9 +216,13 @@ def set_spim_state(self, state: str):
         if state == "Idle":
             self.core.waitForDevice(self.name)
 
-    def configure_x_axis(self, amplitude_deg: float, offset_deg: float,
-                         pattern: str = "1 - Triangle",
-                         mode: str = "3 - Enabled with axes synced"):
+    def configure_x_axis(
+        self,
+        amplitude_deg: float,
+        offset_deg: float,
+        pattern: str = "1 - Triangle",
+        mode: str = "3 - Enabled with axes synced",
+    ):
         """
         Configure galvo X-axis (light sheet width scanning).
 
@@ -246,9 +242,13 @@ def configure_x_axis(self, amplitude_deg: float, offset_deg: float,
         self.core.setProperty(self.name, "SingleAxisXPattern", pattern)
         self.core.setProperty(self.name, "SingleAxisXMode", mode)
 
-    def configure_y_axis(self, amplitude_deg: float, offset_deg: float,
-                         pattern: str = "1 - Triangle",
-                         mode: str = "3 - Enabled with axes synced"):
+    def configure_y_axis(
+        self,
+        amplitude_deg: float,
+        offset_deg: float,
+        pattern: str = "1 - Triangle",
+        mode: str = "3 - Enabled with axes synced",
+    ):
         """
         Configure galvo Y-axis (light sheet Z-plane positioning).
 
@@ -282,14 +282,16 @@ def set_y_offset(self, angle_deg: float):
         self.core.setProperty(self.name, "SingleAxisYOffset(deg)", float(angle_deg))
         self.core.waitForDevice(self.name)
 
-    def configure_spim_timing(self,
-                              scan_delay_ms: float = 6.75,
-                              num_scans_per_slice: int = 1,
-                              scan_duration_ms: float = 5.5,
-                              laser_delay_ms: float = 8.0,
-                              laser_duration_ms: float = 5.0,
-                              camera_delay_ms: float = 8.0,
-                              camera_duration_ms: float = 1.0):
+    def configure_spim_timing(
+        self,
+        scan_delay_ms: float = 6.75,
+        num_scans_per_slice: int = 1,
+        scan_duration_ms: float = 5.5,
+        laser_delay_ms: float = 8.0,
+        laser_duration_ms: float = 5.0,
+        camera_delay_ms: float = 8.0,
+        camera_duration_ms: float = 1.0,
+    ):
         """
         Configure SPIM timing parameters for hardware-triggered acquisition.
 
@@ -318,11 +320,13 @@ def configure_spim_timing(self,
         self.core.setProperty(self.name, "SPIMDelayBeforeCamera(ms)", camera_delay_ms)
         self.core.setProperty(self.name, "SPIMCameraDuration(ms)", camera_duration_ms)
 
-    def configure_spim_parameters(self,
-                                   num_slices: int,
-                                   slices_per_piezo: int = 1,
-                                   num_sides: int = 1,
-                                   first_side: str = "A"):
+    def configure_spim_parameters(
+        self,
+        num_slices: int,
+        slices_per_piezo: int = 1,
+        num_sides: int = 1,
+        first_side: str = "A",
+    ):
         """
         Configure SPIM acquisition parameters.
 
@@ -358,11 +362,13 @@ def configure_for_calibration(self):
         self.configure_y_axis(amplitude_deg=0.0001, offset_deg=0.0)
         self.core.waitForDevice(self.name)
 
-    def configure_for_volume_acquisition(self,
-                                          galvo_amplitude: float,
-                                          galvo_center: float,
-                                          num_slices: int,
-                                          timing_params: Dict = None):
+    def configure_for_volume_acquisition(
+        self,
+        galvo_amplitude: float,
+        galvo_center: float,
+        num_slices: int,
+        timing_params: dict = None,
+    ):
         """
         Configure scanner for hardware-triggered volume acquisition.
 
diff --git a/gently/hardware/dispim/devices/stage.py b/gently/hardware/dispim/devices/stage.py
index 3c922d14..d155b5f8 100644
--- a/gently/hardware/dispim/devices/stage.py
+++ b/gently/hardware/dispim/devices/stage.py
@@ -2,15 +2,13 @@
 DiSPIM stage positioner devices (Z-stage and XY-stage).
 """
 
-import time
 import logging
+import time
 from collections import OrderedDict
-from typing import Tuple
 
 import numpy as np
-
-from ophyd.status import Status
 import pymmcore
+from ophyd.status import Status
 
 from gently.exceptions import HardwareError, StageMovementError
 
@@ -39,9 +37,9 @@
 # inset, even a fast-joystick overshoot still lands inside the true safe
 # travel envelope the operator measured by hand.
 XY_STAGE_X_MIN_UM: float = -2252.1
-XY_STAGE_X_MAX_UM: float =   983.0
+XY_STAGE_X_MAX_UM: float = 983.0
 XY_STAGE_Y_MIN_UM: float = -1677.0
-XY_STAGE_Y_MAX_UM: float =   586.6
+XY_STAGE_Y_MAX_UM: float = 586.6
 
 
 class DiSPIMZstage:
@@ -51,8 +49,12 @@ class DiSPIMZstage:
     Device-agnostic: any plan that moves a positioner will work with this device
     """
 
-    def __init__(self, name: str, core: pymmcore.CMMCore,
-                 limits: Tuple[float, float] = (50.0, 250.0)):
+    def __init__(
+        self,
+        name: str,
+        core: pymmcore.CMMCore,
+        limits: tuple[float, float] = (50.0, 250.0),
+    ):
         self.name = name
         self.core = core
         self.parent = None  # Required for Bluesky
@@ -87,6 +89,7 @@ def wait():
                 status.set_finished()
 
         import threading
+
         threading.Thread(target=wait).start()
 
         return status
@@ -101,9 +104,9 @@ def read(self):
 
         data = OrderedDict()
         data[self.name] = {
-            'value': float(value),
-            'timestamp': time.time(),
-            'units': 'micrometers'
+            "value": float(value),
+            "timestamp": time.time(),
+            "units": "micrometers",
         }
         return data
 
@@ -111,10 +114,10 @@ def describe(self):
         """Describe Z stage device - required for Bluesky"""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'number',
-            'shape': [],
-            'units': 'micrometers'
+            "source": self.name,
+            "dtype": "number",
+            "shape": [],
+            "units": "micrometers",
         }
         return data
 
@@ -141,12 +144,12 @@ def __init__(self, name: str, core: pymmcore.CMMCore):
         self.parent = None  # Required for Bluesky
 
     @property
-    def x_limits(self) -> Tuple[float, float]:
+    def x_limits(self) -> tuple[float, float]:
         """Read-only view of the hardware safety limits (module constants)."""
         return (XY_STAGE_X_MIN_UM, XY_STAGE_X_MAX_UM)
 
     @property
-    def y_limits(self) -> Tuple[float, float]:
+    def y_limits(self) -> tuple[float, float]:
         """Read-only view of the hardware safety limits (module constants)."""
         return (XY_STAGE_Y_MIN_UM, XY_STAGE_Y_MAX_UM)
 
@@ -183,6 +186,7 @@ def wait():
                     status.set_finished()
 
             import threading
+
             threading.Thread(target=wait).start()
 
             return status
@@ -198,9 +202,9 @@ def read(self):
 
         data = OrderedDict()
         data[self.name] = {
-            'value': xy_pos,
-            'timestamp': time.time(),
-            'units': 'micrometers'
+            "value": xy_pos,
+            "timestamp": time.time(),
+            "units": "micrometers",
         }
         return data
 
@@ -208,10 +212,10 @@ def describe(self):
         """Describe XY stage device - required for Bluesky"""
         data = OrderedDict()
         data[self.name] = {
-            'source': self.name,
-            'dtype': 'array',
-            'shape': [2],
-            'units': 'micrometers'
+            "source": self.name,
+            "dtype": "array",
+            "shape": [2],
+            "units": "micrometers",
         }
         return data
 
@@ -237,8 +241,10 @@ def describe_configuration(self):
 
     def set_firmware_limits(
         self,
-        x_min_mm: float, x_max_mm: float,
-        y_min_mm: float, y_max_mm: float,
+        x_min_mm: float,
+        x_max_mm: float,
+        y_min_mm: float,
+        y_max_mm: float,
         *,
         readback_tolerance_mm: float = 0.001,
     ) -> None:
@@ -289,13 +295,15 @@ def set_firmware_limits(
         # overshoot we're trying to absorb anyway.
         POS_SLOP_MM = 0.001  # 1 µm
         try:
-            cur = self.read()[self.name]['value']
+            cur = self.read()[self.name]["value"]
             cur_x_mm = float(cur[0]) / 1000.0
             cur_y_mm = float(cur[1]) / 1000.0
         except Exception as exc:
-            raise HardwareError(f"Could not read current XY to validate limits: {exc}")
-        if not (x_min_mm - POS_SLOP_MM <= cur_x_mm <= x_max_mm + POS_SLOP_MM and
-                y_min_mm - POS_SLOP_MM <= cur_y_mm <= y_max_mm + POS_SLOP_MM):
+            raise HardwareError(f"Could not read current XY to validate limits: {exc}") from exc
+        if not (
+            x_min_mm - POS_SLOP_MM <= cur_x_mm <= x_max_mm + POS_SLOP_MM
+            and y_min_mm - POS_SLOP_MM <= cur_y_mm <= y_max_mm + POS_SLOP_MM
+        ):
             raise ValueError(
                 f"Current stage position ({cur_x_mm * 1000:.2f}, {cur_y_mm * 1000:.2f}) µm "
                 f"is outside the requested firmware envelope "
@@ -318,11 +326,11 @@ def set_firmware_limits(
                 raise HardwareError(
                     f"setProperty {prop}={value_mm} failed: {exc}. The ASI adapter "
                     f"may require EnableAdvancedProperties=Yes for this write."
-                )
+                ) from exc
             try:
                 got = float(self.core.getProperty(self.name, prop))
             except RuntimeError as exc:
-                raise HardwareError(f"getProperty {prop} read-back failed: {exc}")
+                raise HardwareError(f"getProperty {prop} read-back failed: {exc}") from exc
             if abs(got - value_mm) > readback_tolerance_mm:
                 raise HardwareError(
                     f"Firmware limit read-back mismatch for {prop}: "
@@ -352,13 +360,13 @@ def enable_joystick(self, enabled: bool = True) -> None:
         except RuntimeError as exc:
             raise HardwareError(
                 f"setProperty {prop}={target} failed on {self.name}: {exc}"
-            )
+            ) from exc
         try:
             got = self.core.getProperty(self.name, prop)
         except RuntimeError as exc:
             raise HardwareError(
                 f"getProperty {prop} read-back failed on {self.name}: {exc}"
-            )
+            ) from exc
         if str(got).strip() != target:
             raise HardwareError(
                 f"{prop} read-back mismatch on {self.name}: "
@@ -382,7 +390,7 @@ def get_position(self) -> np.ndarray:
         the RunEngine for interactive use, setup, and debugging. For use
         within plans, prefer yield from bps.rd(xy_stage).
         """
-        return self.read()[self.name]['value']
+        return self.read()[self.name]["value"]
 
     def get_x(self) -> float:
         """
@@ -408,9 +416,9 @@ def get_y(self) -> float:
 
     # Coordinate conversion utilities for embryo centering
     @staticmethod
-    def pixel_to_stage_offset(pixel_offset_x: float,
-                               pixel_offset_y: float,
-                               pixel_size_um: float) -> Tuple[float, float]:
+    def pixel_to_stage_offset(
+        pixel_offset_x: float, pixel_offset_y: float, pixel_size_um: float
+    ) -> tuple[float, float]:
         """
         Convert pixel offsets to stage movement in micrometers.
 
@@ -436,4 +444,5 @@ def pixel_to_stage_offset(pixel_offset_x: float,
         This method delegates to gently.coordinates for the actual calculation.
         """
         from gently.core.coordinates import pixel_displacement_to_stage_movement
+
         return pixel_displacement_to_stage_movement(pixel_offset_x, pixel_offset_y, pixel_size_um)
diff --git a/gently/hardware/dispim/devices/system.py b/gently/hardware/dispim/devices/system.py
index 66100491..fabcc26a 100644
--- a/gently/hardware/dispim/devices/system.py
+++ b/gently/hardware/dispim/devices/system.py
@@ -31,7 +31,7 @@
 from __future__ import annotations
 
 import logging
-from typing import Any, Dict, List
+from typing import Any
 
 import pymmcore
 
@@ -53,13 +53,13 @@ def __init__(self) -> None:
     def enable_stderr_log(self, enabled: bool) -> None:
         self.core.enableStderrLog(bool(enabled))
 
-    def set_device_adapter_search_paths(self, paths: List[str]) -> None:
+    def set_device_adapter_search_paths(self, paths: list[str]) -> None:
         self.core.setDeviceAdapterSearchPaths(list(paths))
 
     def load_system_configuration(self, path: str) -> None:
         self.core.loadSystemConfiguration(str(path))
 
-    def get_loaded_devices(self) -> List[str]:
+    def get_loaded_devices(self) -> list[str]:
         return list(self.core.getLoadedDevices())
 
     # ----- system-wide property cache ------------------------------------
diff --git a/gently/hardware/dispim/devices/test_temp_usb.py b/gently/hardware/dispim/devices/test_temp_usb.py
index f6394aee..8b635bbd 100644
--- a/gently/hardware/dispim/devices/test_temp_usb.py
+++ b/gently/hardware/dispim/devices/test_temp_usb.py
@@ -1,6 +1,8 @@
-import serial
-import time
 import threading
+import time
+
+import serial
+
 
 class AcuityNanoPrecisionThermalizerSerial:
     def __init__(self, com_port, baud_rate=115200):
@@ -9,12 +11,12 @@ def __init__(self, com_port, baud_rate=115200):
             "water": 20.0,
             "peltier": 20.0,
             "state": "DISCONNECTED",
-            "errors": "0"
+            "errors": "0",
         }
         self.running = True
         self.ser = serial.Serial(com_port, baud_rate, timeout=0.1)
         time.sleep(2)
-        
+
         self.thread = threading.Thread(target=self._read_loop, daemon=True)
         self.thread.start()
 
@@ -22,14 +24,19 @@ def _read_loop(self):
         while self.running and self.ser.is_open:
             try:
                 if self.ser.in_waiting:
-                    line = self.ser.readline().decode('utf-8', errors='ignore').strip()
+                    line = self.ser.readline().decode("utf-8", errors="ignore").strip()
                     if "=" in line:
                         key, val = line.split("=", 1)
-                        if key == "TARGET": self.telemetry["target"] = float(val)
-                        elif key == "WATER": self.telemetry["water"] = float(val)
-                        elif key == "ACTUAL": self.telemetry["peltier"] = float(val)
-                        elif key == "STATE": self.telemetry["state"] = val
-                        elif key == "ERRORS": self.telemetry["errors"] = val
+                        if key == "TARGET":
+                            self.telemetry["target"] = float(val)
+                        elif key == "WATER":
+                            self.telemetry["water"] = float(val)
+                        elif key == "ACTUAL":
+                            self.telemetry["peltier"] = float(val)
+                        elif key == "STATE":
+                            self.telemetry["state"] = val
+                        elif key == "ERRORS":
+                            self.telemetry["errors"] = val
             except Exception:
                 pass
             time.sleep(0.01)
@@ -38,30 +45,30 @@ def close(self):
         self.running = False
         if self.ser.is_open:
             self.ser.close()
-    
+
     def set_temperature(self, target_celsius):
         if 0.0 <= target_celsius <= 99.9:
             cmd = f"TEMP={target_celsius}\n"
-            self.ser.write(cmd.encode('utf-8'))
+            self.ser.write(cmd.encode("utf-8"))
         else:
             raise ValueError("Target must be between 0.0 and 99.9 C")
 
     def enable_tec(self, enable=True):
         val = "1" if enable else "0"
         cmd = f"ENABLE={val}\n"
-        self.ser.write(cmd.encode('utf-8'))
+        self.ser.write(cmd.encode("utf-8"))
 
     def set_feedback_sensor(self, use_peltier=False):
         val = "1" if use_peltier else "0"
         cmd = f"SENSOR={val}\n"
-        self.ser.write(cmd.encode('utf-8'))
+        self.ser.write(cmd.encode("utf-8"))
 
     def get_water_temp(self):
         return self.telemetry["water"]
 
     def get_system_state(self):
         return self.telemetry["state"]
-        
+
     def wait_for_target(self, timeout_seconds=300):
         start = time.time()
         while time.time() - start < timeout_seconds:
@@ -70,9 +77,10 @@ def wait_for_target(self, timeout_seconds=300):
             time.sleep(0.5)
         return False
 
+
 if __name__ == "__main__":
     import time
-    
+
     print("Connecting to ACUITYnano...")
     acuity = AcuityNanoPrecisionThermalizerSerial("COM8")
 
@@ -87,4 +95,4 @@ def wait_for_target(self, timeout_seconds=300):
     else:
         print("Timeout reached before system stabilized.")
 
-    acuity.close()
\ No newline at end of file
+    acuity.close()
diff --git a/gently/hardware/dispim/devices/test_temperature_controller.py b/gently/hardware/dispim/devices/test_temperature_controller.py
index a7efddfe..2bed40c6 100644
--- a/gently/hardware/dispim/devices/test_temperature_controller.py
+++ b/gently/hardware/dispim/devices/test_temperature_controller.py
@@ -2,37 +2,46 @@
 ACUITYnano Third-Party Integration SDK
 Provides a clean, object-oriented API for external software automation.
 """
-import paho.mqtt.client as mqtt
-import time
+
 import threading
+import time
+
+import paho.mqtt.client as mqtt
+
 
 class AcuityNanoPrecisionThermalizerAPI:
-    def __init__(self, broker="d0246aa97d194c9da52a19e6f46063eb.s1.eu.hivemq.cloud", port=8883, user="acuitynano", password="Bg984V!@wfhBrkp"):
+    def __init__(
+        self,
+        broker="d0246aa97d194c9da52a19e6f46063eb.s1.eu.hivemq.cloud",
+        port=8883,
+        user="acuitynano",
+        password="Bg984V!@wfhBrkp",
+    ):
         self.prefix = "acuitynano_hhmi_shroff_diSPIM_001"
         self.telemetry = {
             "target": 20.0,
             "water": 20.0,
             "peltier": 20.0,
             "state": "DISCONNECTED",
-            "errors": "0"
+            "errors": "0",
         }
-        
+
         try:
             self.client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2)
         except AttributeError:
             self.client = mqtt.Client()
-            
+
         self.client.username_pw_set(user, password)
         self.client.tls_set()
         self.client.on_connect = self._on_connect
         self.client.on_message = self._on_message
-        
+
         self.thread = threading.Thread(target=self._start_loop, daemon=True)
         self.thread.start()
         time.sleep(2)
 
     def _start_loop(self):
-        self.client.connect(broker, port, 60)
+        self.client.connect(broker, port, 60)  # noqa: F821
         self.client.loop_forever()
 
     def _on_connect(self, client, userdata, flags, rc, properties=None):
@@ -40,13 +49,18 @@ def _on_connect(self, client, userdata, flags, rc, properties=None):
 
     def _on_message(self, client, userdata, msg):
         topic = msg.topic.split("/")[-1]
-        payload = msg.payload.decode('utf-8')
-        
-        if topic == "target": self.telemetry["target"] = float(payload)
-        elif topic == "water": self.telemetry["water"] = float(payload)
-        elif topic == "actual": self.telemetry["peltier"] = float(payload)
-        elif topic == "state": self.telemetry["state"] = payload
-        elif topic == "errors": self.telemetry["errors"] = payload
+        payload = msg.payload.decode("utf-8")
+
+        if topic == "target":
+            self.telemetry["target"] = float(payload)
+        elif topic == "water":
+            self.telemetry["water"] = float(payload)
+        elif topic == "actual":
+            self.telemetry["peltier"] = float(payload)
+        elif topic == "state":
+            self.telemetry["state"] = payload
+        elif topic == "errors":
+            self.telemetry["errors"] = payload
 
     def set_temperature(self, target_celsius):
         if 0.0 <= target_celsius <= 99.9:
@@ -70,7 +84,7 @@ def get_peltier_temp(self):
 
     def get_system_state(self):
         return self.telemetry["state"]
-        
+
     def wait_for_target(self, timeout_seconds=300):
         start = time.time()
         while time.time() - start < timeout_seconds:
@@ -80,10 +94,9 @@ def wait_for_target(self, timeout_seconds=300):
         return False
 
 
-
 if __name__ == "__main__":
-
     import time
+
     from acuitynano_precision_thermalizer_api import AcuityNanoPrecisionThermalizerAPI
 
     acuity = AcuityNanoPrecisionThermalizerAPI()
diff --git a/gently/hardware/dispim/plans/acquisition.py b/gently/hardware/dispim/plans/acquisition.py
index 9c08c8be..84e49d02 100644
--- a/gently/hardware/dispim/plans/acquisition.py
+++ b/gently/hardware/dispim/plans/acquisition.py
@@ -30,15 +30,14 @@
 
 import logging
 import time
-import numpy as np
-import matplotlib.pyplot as plt
-from typing import Any, Dict, Generator, List, Tuple, Optional
+from collections.abc import Generator
+from typing import Any
+
 import bluesky.plan_stubs as bps
 import bluesky.plans as bp
 import bluesky.preprocessors as bpp
-from pathlib import Path
-import json
-from datetime import datetime
+import matplotlib.pyplot as plt
+import numpy as np
 
 logger = logging.getLogger(__name__)
 
@@ -47,10 +46,13 @@
 # FOCUS ANALYSIS UTILITIES
 # =======================
 
-def compute_fft_bandpass_score(image: np.ndarray,
-                                lower_cutoff: float = 0.025,
-                                upper_cutoff: float = 0.14,
-                                roi: Optional[Tuple[int, int, int, int]] = None) -> float:
+
+def compute_fft_bandpass_score(
+    image: np.ndarray,
+    lower_cutoff: float = 0.025,
+    upper_cutoff: float = 0.14,
+    roi: tuple[int, int, int, int] | None = None,
+) -> float:
     """
     Compute FFT bandpass focus score (ASI diSPIM OughtaFocus algorithm).
 
@@ -95,7 +97,7 @@ def compute_fft_bandpass_score(image: np.ndarray,
 
     # Create distance map from center
     y, x = np.ogrid[:h, :w]
-    distance_from_center = np.sqrt((x - cx)**2 + (y - cy)**2)
+    distance_from_center = np.sqrt((x - cx) ** 2 + (y - cy) ** 2)
 
     # Maximum frequency (corner distance)
     max_freq = np.sqrt(cx**2 + cy**2)
@@ -117,9 +119,9 @@ def compute_fft_bandpass_score(image: np.ndarray,
     return mean_power
 
 
-def detect_embryo_roi(image: np.ndarray,
-                       margin_fraction: float = 0.1,
-                       min_threshold_ratio: float = 1.15) -> Tuple[int, int, int, int]:
+def detect_embryo_roi(
+    image: np.ndarray, margin_fraction: float = 0.1, min_threshold_ratio: float = 1.15
+) -> tuple[int, int, int, int]:
     """
     Detect embryo region and return bounding box ROI for focus analysis.
 
@@ -145,12 +147,14 @@ def detect_embryo_roi(image: np.ndarray,
 
     # Calculate background from edge regions
     edge_margin = min(50, h // 10, w // 10)
-    edge_pixels = np.concatenate([
-        image[:edge_margin, :].flatten(),
-        image[-edge_margin:, :].flatten(),
-        image[:, :edge_margin].flatten(),
-        image[:, -edge_margin:].flatten()
-    ])
+    edge_pixels = np.concatenate(
+        [
+            image[:edge_margin, :].flatten(),
+            image[-edge_margin:, :].flatten(),
+            image[:, :edge_margin].flatten(),
+            image[:, -edge_margin:].flatten(),
+        ]
+    )
 
     background_level = np.median(edge_pixels)
     threshold = background_level * min_threshold_ratio
@@ -228,6 +232,7 @@ def select_best_camera_view(image: np.ndarray) -> np.ndarray:
 # STAGE POSITIONING PLAN STUBS
 # ================================
 
+
 def get_stage_position_plan(xy_stage):
     """
     Read XY stage position within a plan.
@@ -261,10 +266,7 @@ def get_stage_position_plan(xy_stage):
     return (yield from bps.rd(xy_stage))
 
 
-def move_to_pixel_plan(xy_stage,
-                       bottom_camera,
-                       pixel_x: float,
-                       pixel_y: float):
+def move_to_pixel_plan(xy_stage, bottom_camera, pixel_x: float, pixel_y: float):
     """
     Move stage to center on pixel coordinates from bottom camera image.
 
@@ -316,9 +318,7 @@ def move_to_pixel_plan(xy_stage,
 
     # Convert pixel displacement to stage movement
     dx, dy = pixel_displacement_to_stage_movement(
-        pixel_offset_x,
-        pixel_offset_y,
-        bottom_camera.effective_pixel_size
+        pixel_offset_x, pixel_offset_y, bottom_camera.effective_pixel_size
     )
 
     # Calculate target position
@@ -330,10 +330,7 @@ def move_to_pixel_plan(xy_stage,
     return target_pos
 
 
-def center_on_feature_plan(xy_stage,
-                           bottom_camera,
-                           image: np.ndarray,
-                           feature_detector_func):
+def center_on_feature_plan(xy_stage, bottom_camera, image: np.ndarray, feature_detector_func):
     """
     Complete workflow: detect feature in image and center stage on it.
 
@@ -375,24 +372,22 @@ def center_on_feature_plan(xy_stage,
     feature_x, feature_y = feature_detector_func(image)
 
     # Move to center the feature
-    final_pos = yield from move_to_pixel_plan(
-        xy_stage, bottom_camera, feature_x, feature_y
-    )
+    final_pos = yield from move_to_pixel_plan(xy_stage, bottom_camera, feature_x, feature_y)
 
-    return {
-        'feature_pos': (feature_x, feature_y),
-        'stage_pos': final_pos
-    }
+    return {"feature_pos": (feature_x, feature_y), "stage_pos": final_pos}
 
 
 # =======================
 # CALIBRATION PLANS
 # =======================
 
-def focus_sweep_plan(lightsheet_snap,
-                     galvo_positions: List[float],
-                     roi_detection: bool = True,
-                     metadata: Optional[Dict] = None):
+
+def focus_sweep_plan(
+    lightsheet_snap,
+    galvo_positions: list[float],
+    roi_detection: bool = True,
+    metadata: dict | None = None,
+):
     """
     Perform focus sweep by moving galvo Y-offset and analyzing image quality.
 
@@ -425,15 +420,15 @@ def focus_sweep_plan(lightsheet_snap,
     """
     # Prepare storage for results
     results = {
-        'galvo_positions': galvo_positions,
-        'images': [],
-        'focus_scores': [],
-        'rois': [],
-        'timestamp': time.time()
+        "galvo_positions": galvo_positions,
+        "images": [],
+        "focus_scores": [],
+        "rois": [],
+        "timestamp": time.time(),
     }
 
     # Open data collection run
-    _md = {'plan_name': 'focus_sweep'}
+    _md = {"plan_name": "focus_sweep"}
     if metadata:
         _md.update(metadata)
 
@@ -441,8 +436,12 @@ def focus_sweep_plan(lightsheet_snap,
     def inner():
         logger.info("=" * 70)
         logger.info("FOCUS SWEEP: %d positions", len(galvo_positions))
-        logger.info("Galvo Y range: [%.4f, %.4f] deg", min(galvo_positions), max(galvo_positions))
-        logger.info("ROI detection: %s", 'enabled' if roi_detection else 'disabled')
+        logger.info(
+            "Galvo Y range: [%.4f, %.4f] deg",
+            min(galvo_positions),
+            max(galvo_positions),
+        )
+        logger.info("ROI detection: %s", "enabled" if roi_detection else "disabled")
         logger.info("=" * 70)
 
         for idx, galvo_y in enumerate(galvo_positions):
@@ -455,7 +454,7 @@ def inner():
             yield from bps.trigger_and_read([lightsheet_snap])
 
             # Get captured image from device
-            image_data = lightsheet_snap.read()[lightsheet_snap.camera.name]['value']
+            image_data = lightsheet_snap.read()[lightsheet_snap.camera.name]["value"]
 
             # Select best view if dual-camera
             if image_data.shape[1] > image_data.shape[0] * 2:  # Heuristic for stitched image
@@ -473,34 +472,36 @@ def inner():
             focus_score = compute_fft_bandpass_score(image, roi=roi)
 
             # Store results
-            results['images'].append(image)
-            results['focus_scores'].append(focus_score)
-            results['rois'].append(roi)
+            results["images"].append(image)
+            results["focus_scores"].append(focus_score)
+            results["rois"].append(roi)
 
             logger.debug("Score: %.2e", focus_score)
 
     yield from inner()
 
     # Analyze results
-    scores = np.array(results['focus_scores'])
+    scores = np.array(results["focus_scores"])
     best_idx = np.argmax(scores)
-    results['best_position'] = galvo_positions[best_idx]
-    results['best_score'] = scores[best_idx]
-    results['best_image'] = results['images'][best_idx]
+    results["best_position"] = galvo_positions[best_idx]
+    results["best_score"] = scores[best_idx]
+    results["best_image"] = results["images"][best_idx]
 
     logger.info("BEST FOCUS: Position %d/%d", best_idx + 1, len(galvo_positions))
-    logger.info("Galvo Y = %.4f deg", results['best_position'])
-    logger.info("Score = %.2e", results['best_score'])
+    logger.info("Galvo Y = %.4f deg", results["best_position"])
+    logger.info("Score = %.2e", results["best_score"])
 
     return results
 
 
-def calibrate_piezo_galvo_plan(lightsheet_snap,
-                                piezo_positions: List[float],
-                                initial_galvo_position: float = 0.0,
-                                search_range_deg: float = 0.02,
-                                n_sweep_points: int = 21,
-                                metadata: Optional[Dict] = None):
+def calibrate_piezo_galvo_plan(
+    lightsheet_snap,
+    piezo_positions: list[float],
+    initial_galvo_position: float = 0.0,
+    search_range_deg: float = 0.02,
+    n_sweep_points: int = 21,
+    metadata: dict | None = None,
+):
     """
     Calibrate piezo-galvo synchronization using 2-point linear fit.
 
@@ -535,14 +536,14 @@ def calibrate_piezo_galvo_plan(lightsheet_snap,
         Calibration results with slope, offset, and fit quality
     """
     results = {
-        'piezo_positions': piezo_positions,
-        'galvo_positions': [],
-        'focus_scores': [],
-        'sweep_results': [],
-        'timestamp': time.time()
+        "piezo_positions": piezo_positions,
+        "galvo_positions": [],
+        "focus_scores": [],
+        "sweep_results": [],
+        "timestamp": time.time(),
     }
 
-    _md = {'plan_name': 'calibrate_piezo_galvo'}
+    _md = {"plan_name": "calibrate_piezo_galvo"}
     if metadata:
         _md.update(metadata)
 
@@ -558,13 +559,18 @@ def inner():
         current_galvo_guess = initial_galvo_position
 
         for piezo_idx, piezo_z in enumerate(piezo_positions):
-            logger.info("[PIEZO %d/%d] Z = %.2f um", piezo_idx + 1, len(piezo_positions), piezo_z)
+            logger.info(
+                "[PIEZO %d/%d] Z = %.2f um",
+                piezo_idx + 1,
+                len(piezo_positions),
+                piezo_z,
+            )
 
             # Generate galvo sweep positions around current guess
             galvo_sweep = np.linspace(
                 current_galvo_guess - search_range_deg,
                 current_galvo_guess + search_range_deg,
-                n_sweep_points
+                n_sweep_points,
             )
 
             # Perform focus sweep at this piezo position
@@ -572,16 +578,16 @@ def inner():
                 lightsheet_snap,
                 galvo_sweep.tolist(),
                 roi_detection=True,
-                metadata={'piezo_position': piezo_z}
+                metadata={"piezo_position": piezo_z},
             )
 
             # Store results
-            best_galvo = sweep_results['best_position']
-            best_score = sweep_results['best_score']
+            best_galvo = sweep_results["best_position"]
+            best_score = sweep_results["best_score"]
 
-            results['galvo_positions'].append(best_galvo)
-            results['focus_scores'].append(best_score)
-            results['sweep_results'].append(sweep_results)
+            results["galvo_positions"].append(best_galvo)
+            results["focus_scores"].append(best_score)
+            results["sweep_results"].append(sweep_results)
 
             # Update guess for next iteration (assume roughly linear)
             current_galvo_guess = best_galvo
@@ -592,7 +598,7 @@ def inner():
 
     # Compute linear fit: galvo_y = slope * piezo_z + offset
     piezo_array = np.array(piezo_positions)
-    galvo_array = np.array(results['galvo_positions'])
+    galvo_array = np.array(results["galvo_positions"])
 
     # Linear regression
     coeffs = np.polyfit(piezo_array, galvo_array, deg=1)
@@ -605,11 +611,11 @@ def inner():
     rmse = np.sqrt(np.mean(residuals**2))
 
     # Store calibration parameters
-    results['calibration'] = {
-        'slope': slope,
-        'offset': offset,
-        'rmse': rmse,
-        'equation': f"galvo_y = {slope:.6e} * piezo_z + {offset:.6f}"
+    results["calibration"] = {
+        "slope": slope,
+        "offset": offset,
+        "rmse": rmse,
+        "equation": f"galvo_y = {slope:.6e} * piezo_z + {offset:.6f}",
     }
 
     logger.info("=" * 70)
@@ -627,10 +633,10 @@ def inner():
 # EMBRYO DETECTION PLANS
 # =======================
 
-def mark_embryo_interactive_plan(bottom_camera,
-                                  xy_stage,
-                                  embryo_number: int,
-                                  metadata: Optional[Dict] = None):
+
+def mark_embryo_interactive_plan(
+    bottom_camera, xy_stage, embryo_number: int, metadata: dict | None = None
+):
     """
     Interactive plan for user to mark embryo position and center it.
 
@@ -662,7 +668,7 @@ def mark_embryo_interactive_plan(bottom_camera,
     Dict
         Results with embryo position, stage position, and images
     """
-    _md = {'plan_name': 'mark_embryo_interactive', 'embryo_number': embryo_number}
+    _md = {"plan_name": "mark_embryo_interactive", "embryo_number": embryo_number}
     if metadata:
         _md.update(metadata)
 
@@ -675,10 +681,10 @@ def inner():
         # Capture initial image
         logger.info("Capturing initial image...")
         yield from bps.trigger_and_read([bottom_camera])
-        initial_image = bottom_camera.read()[bottom_camera.name]['value']
+        initial_image = bottom_camera.read()[bottom_camera.name]["value"]
 
         # Get current stage position
-        initial_stage_pos = xy_stage.read()[xy_stage.name]['value']
+        initial_stage_pos = xy_stage.read()[xy_stage.name]["value"]
         logger.info("Initial stage: (%.2f, %.2f) um", initial_stage_pos[0], initial_stage_pos[1])
 
         # Display interactive marking interface
@@ -688,15 +694,17 @@ def inner():
 
         # Create interactive figure
         fig, ax = plt.subplots(figsize=(12, 10))
-        img_norm = (initial_image - initial_image.min()) / (initial_image.max() - initial_image.min())
-        ax.imshow(img_norm, cmap='gray')
+        img_norm = (initial_image - initial_image.min()) / (
+            initial_image.max() - initial_image.min()
+        )
+        ax.imshow(img_norm, cmap="gray")
 
         # Draw center crosshair
         h, w = initial_image.shape
-        ax.axvline(w/2, color='red', linestyle='--', linewidth=2, label='Center')
-        ax.axhline(h/2, color='red', linestyle='--', linewidth=2)
+        ax.axvline(w / 2, color="red", linestyle="--", linewidth=2, label="Center")
+        ax.axhline(h / 2, color="red", linestyle="--", linewidth=2)
 
-        ax.set_title(f"Click on Embryo #{embryo_number}", fontsize=14, fontweight='bold')
+        ax.set_title(f"Click on Embryo #{embryo_number}", fontsize=14, fontweight="bold")
 
         # Storage for click
         embryo_position = [None, None]
@@ -706,8 +714,15 @@ def onclick(event):
                 embryo_position[0] = event.xdata
                 embryo_position[1] = event.ydata
                 # Draw marker
-                ax.plot(event.xdata, event.ydata, 'o', color='lime',
-                       markersize=15, markeredgewidth=3, markeredgecolor='white')
+                ax.plot(
+                    event.xdata,
+                    event.ydata,
+                    "o",
+                    color="lime",
+                    markersize=15,
+                    markeredgewidth=3,
+                    markeredgecolor="white",
+                )
                 fig.canvas.draw()
                 logger.info("Marked at pixel (%.0f, %.0f)", event.xdata, event.ydata)
 
@@ -715,26 +730,23 @@ def on_done(event):
             plt.close(fig)
 
         # Connect handlers
-        cid = fig.canvas.mpl_connect('button_press_event', onclick)
+        fig.canvas.mpl_connect("button_press_event", onclick)
 
         # Add Done button
         ax_done = plt.axes([0.81, 0.05, 0.1, 0.04])
-        btn_done = Button(ax_done, 'Done')
+        btn_done = Button(ax_done, "Done")
         btn_done.on_clicked(on_done)
 
         plt.show()
 
         if embryo_position[0] is None:
             logger.warning("No embryo marked!")
-            return {'success': False}
+            return {"success": False}
 
         # Center the embryo (using plan stub for proper Bluesky message flow)
         logger.info("Moving stage to center embryo...")
         yield from move_to_pixel_plan(
-            xy_stage,
-            bottom_camera,
-            embryo_position[0],
-            embryo_position[1]
+            xy_stage, bottom_camera, embryo_position[0], embryo_position[1]
         )
 
         time.sleep(0.5)
@@ -742,19 +754,19 @@ def on_done(event):
         # Capture confirmation image
         logger.info("Capturing confirmation image...")
         yield from bps.trigger_and_read([bottom_camera])
-        centered_image = bottom_camera.read()[bottom_camera.name]['value']
+        centered_image = bottom_camera.read()[bottom_camera.name]["value"]
 
-        final_stage_pos = xy_stage.read()[xy_stage.name]['value']
+        final_stage_pos = xy_stage.read()[xy_stage.name]["value"]
         logger.info("Final stage: (%.2f, %.2f) um", final_stage_pos[0], final_stage_pos[1])
 
-        results['success'] = True
-        results['embryo_number'] = embryo_number
-        results['pixel_position'] = tuple(embryo_position)
-        results['initial_stage_position'] = initial_stage_pos
-        results['final_stage_position'] = final_stage_pos
-        results['initial_image'] = initial_image
-        results['centered_image'] = centered_image
-        results['timestamp'] = time.time()
+        results["success"] = True
+        results["embryo_number"] = embryo_number
+        results["pixel_position"] = tuple(embryo_position)
+        results["initial_stage_position"] = initial_stage_pos
+        results["final_stage_position"] = final_stage_pos
+        results["initial_image"] = initial_image
+        results["centered_image"] = centered_image
+        results["timestamp"] = time.time()
 
         logger.info("Embryo #%d centered!", embryo_number)
 
@@ -767,20 +779,23 @@ def on_done(event):
 # VOLUME ACQUISITION PLANS
 # =======================
 
-def acquire_single_volume_plan(volume_scanner,
-                                 num_slices: int = 100,
-                                 exposure_ms: float = 5.0,
-                                 galvo_amplitude: float = 0.5,
-                                 galvo_center: float = 0.0,
-                                 piezo_amplitude: float = 25.0,
-                                 piezo_center: float = 50.0,
-                                 laser_config: str = "488 and 561",
-                                 laser_power_488_pct: float = None,
-                                 laser_power_561_pct: float = None,
-                                 laser_power_405_pct: float = None,
-                                 laser_power_637_pct: float = None,
-                                 timing_params: Optional[Dict] = None,
-                                 metadata: Optional[Dict] = None):
+
+def acquire_single_volume_plan(
+    volume_scanner,
+    num_slices: int = 100,
+    exposure_ms: float = 5.0,
+    galvo_amplitude: float = 0.5,
+    galvo_center: float = 0.0,
+    piezo_amplitude: float = 25.0,
+    piezo_center: float = 50.0,
+    laser_config: str = "488 and 561",
+    laser_power_488_pct: float = None,
+    laser_power_561_pct: float = None,
+    laser_power_405_pct: float = None,
+    laser_power_637_pct: float = None,
+    timing_params: dict | None = None,
+    metadata: dict | None = None,
+):
     """
     Acquire a single hardware-triggered 3D volume.
 
@@ -822,18 +837,18 @@ def acquire_single_volume_plan(volume_scanner,
         Results with volume data
     """
     _md = {
-        'plan_name': 'acquire_single_volume',
-        'num_slices': num_slices,
-        'exposure_ms': exposure_ms,
-        'galvo_amplitude': galvo_amplitude,
-        'galvo_center': galvo_center,
-        'piezo_amplitude': piezo_amplitude,
-        'piezo_center': piezo_center,
-        'laser_config': laser_config,
-        'laser_power_488_pct': laser_power_488_pct,
-        'laser_power_561_pct': laser_power_561_pct,
-        'laser_power_405_pct': laser_power_405_pct,
-        'laser_power_637_pct': laser_power_637_pct,
+        "plan_name": "acquire_single_volume",
+        "num_slices": num_slices,
+        "exposure_ms": exposure_ms,
+        "galvo_amplitude": galvo_amplitude,
+        "galvo_center": galvo_center,
+        "piezo_amplitude": piezo_amplitude,
+        "piezo_center": piezo_center,
+        "laser_config": laser_config,
+        "laser_power_488_pct": laser_power_488_pct,
+        "laser_power_561_pct": laser_power_561_pct,
+        "laser_power_405_pct": laser_power_405_pct,
+        "laser_power_637_pct": laser_power_637_pct,
     }
     if metadata:
         _md.update(metadata)
@@ -849,10 +864,14 @@ def inner():
         logger.info("Piezo: %.2f um amplitude, %.2f um center", piezo_amplitude, piezo_center)
         logger.info("Lasers: %s", laser_config)
         power_log = []
-        if laser_power_488_pct is not None: power_log.append(f"488@{laser_power_488_pct}%")
-        if laser_power_561_pct is not None: power_log.append(f"561@{laser_power_561_pct}%")
-        if laser_power_405_pct is not None: power_log.append(f"405@{laser_power_405_pct}%")
-        if laser_power_637_pct is not None: power_log.append(f"637@{laser_power_637_pct}%")
+        if laser_power_488_pct is not None:
+            power_log.append(f"488@{laser_power_488_pct}%")
+        if laser_power_561_pct is not None:
+            power_log.append(f"561@{laser_power_561_pct}%")
+        if laser_power_405_pct is not None:
+            power_log.append(f"405@{laser_power_405_pct}%")
+        if laser_power_637_pct is not None:
+            power_log.append(f"637@{laser_power_637_pct}%")
         if power_log:
             logger.info("Laser power: %s", ", ".join(power_log))
         logger.info("=" * 70)
@@ -881,35 +900,37 @@ def inner():
         elapsed = time.time() - start_time
 
         # Get volume data
-        volume_data = volume_scanner.read()[volume_scanner.name]['value']
+        volume_data = volume_scanner.read()[volume_scanner.name]["value"]
 
         logger.info("Volume acquired! Shape: %s, Time: %.2f s", volume_data.shape, elapsed)
 
-        results['volume'] = volume_data
-        results['shape'] = volume_data.shape
-        results['acquisition_time'] = elapsed
-        results['timestamp'] = time.time()
+        results["volume"] = volume_data
+        results["shape"] = volume_data.shape
+        results["acquisition_time"] = elapsed
+        results["timestamp"] = time.time()
 
     yield from inner()
     return results
 
 
-def burst_plan(volume_scanner,
-               frames: int = 60,
-               mode: str = "1hz",
-               num_slices: int = 1,
-               exposure_ms: float = 5.0,
-               galvo_amplitude: float = 0.5,
-               galvo_center: float = 0.0,
-               piezo_amplitude: float = 25.0,
-               piezo_center: float = 50.0,
-               laser_config: str = "488 only",
-               laser_power_488_pct: float = None,
-               laser_power_561_pct: float = None,
-               laser_power_405_pct: float = None,
-               laser_power_637_pct: float = None,
-               timing_params: Optional[Dict] = None,
-               metadata: Optional[Dict] = None):
+def burst_plan(
+    volume_scanner,
+    frames: int = 60,
+    mode: str = "1hz",
+    num_slices: int = 1,
+    exposure_ms: float = 5.0,
+    galvo_amplitude: float = 0.5,
+    galvo_center: float = 0.0,
+    piezo_amplitude: float = 25.0,
+    piezo_center: float = 50.0,
+    laser_config: str = "488 only",
+    laser_power_488_pct: float = None,
+    laser_power_561_pct: float = None,
+    laser_power_405_pct: float = None,
+    laser_power_637_pct: float = None,
+    timing_params: dict | None = None,
+    metadata: dict | None = None,
+):
     """
     Acquire a burst of N volumes back-to-back as a single Bluesky run.
 
@@ -939,7 +960,8 @@ def burst_plan(volume_scanner,
         Scan geometry — same meaning as in ``acquire_single_volume_plan``.
     laser_config : str
         Laser preset, e.g. ``"488 only"``.
-    laser_power_488_pct, laser_power_561_pct, laser_power_405_pct, laser_power_637_pct : float, optional
+    laser_power_488_pct, laser_power_561_pct, laser_power_405_pct,
+    laser_power_637_pct : float, optional
         Per-line laser power %. Hard-limited at the device layer.
     timing_params : Dict, optional
         Custom SPIM timing parameters.
@@ -963,26 +985,26 @@ def burst_plan(volume_scanner,
     target_dt = 1.0 if mode == "1hz" else 0.0
 
     _md = {
-        'plan_name': 'burst',
-        'frames': frames,
-        'mode': mode,
-        'num_slices': num_slices,
-        'exposure_ms': exposure_ms,
-        'laser_config': laser_config,
-        'laser_power_488_pct': laser_power_488_pct,
-        'laser_power_561_pct': laser_power_561_pct,
-        'laser_power_405_pct': laser_power_405_pct,
-        'laser_power_637_pct': laser_power_637_pct,
+        "plan_name": "burst",
+        "frames": frames,
+        "mode": mode,
+        "num_slices": num_slices,
+        "exposure_ms": exposure_ms,
+        "laser_config": laser_config,
+        "laser_power_488_pct": laser_power_488_pct,
+        "laser_power_561_pct": laser_power_561_pct,
+        "laser_power_405_pct": laser_power_405_pct,
+        "laser_power_637_pct": laser_power_637_pct,
     }
     if metadata:
         _md.update(metadata)
 
     results = {
-        'frames_captured': 0,
-        'frames_requested': frames,
-        'mode': mode,
-        'duration_s': 0.0,
-        'sustained_hz': 0.0,
+        "frames_captured": 0,
+        "frames_requested": frames,
+        "mode": mode,
+        "duration_s": 0.0,
+        "sustained_hz": 0.0,
     }
 
     @bpp.run_decorator(md=_md)
@@ -991,10 +1013,14 @@ def inner():
         logger.info("BURST ACQUISITION")
         logger.info("Frames: %d, Mode: %s, Slices/frame: %d", frames, mode, num_slices)
         power_log = []
-        if laser_power_488_pct is not None: power_log.append(f"488@{laser_power_488_pct}%")
-        if laser_power_561_pct is not None: power_log.append(f"561@{laser_power_561_pct}%")
-        if laser_power_405_pct is not None: power_log.append(f"405@{laser_power_405_pct}%")
-        if laser_power_637_pct is not None: power_log.append(f"637@{laser_power_637_pct}%")
+        if laser_power_488_pct is not None:
+            power_log.append(f"488@{laser_power_488_pct}%")
+        if laser_power_561_pct is not None:
+            power_log.append(f"561@{laser_power_561_pct}%")
+        if laser_power_405_pct is not None:
+            power_log.append(f"405@{laser_power_405_pct}%")
+        if laser_power_637_pct is not None:
+            power_log.append(f"637@{laser_power_637_pct}%")
         if power_log:
             logger.info("Laser power: %s", ", ".join(power_log))
         logger.info("=" * 70)
@@ -1021,7 +1047,7 @@ def inner():
             tick_start = time.time()
             # One event per frame, each carrying its own volume file_ref.
             yield from bps.trigger_and_read([volume_scanner])
-            results['frames_captured'] = i + 1
+            results["frames_captured"] = i + 1
 
             # Pacing — only between frames, not after the last.
             if i < frames - 1 and target_dt > 0:
@@ -1031,24 +1057,24 @@ def inner():
                     yield from bps.sleep(wait)
 
         duration = time.time() - burst_start
-        results['duration_s'] = duration
-        results['sustained_hz'] = (
-            results['frames_captured'] / duration if duration > 0 else 0.0
-        )
+        results["duration_s"] = duration
+        results["sustained_hz"] = results["frames_captured"] / duration if duration > 0 else 0.0
 
         logger.info(
             "BURST COMPLETE — %d/%d frames in %.2fs (%.2f Hz)",
-            results['frames_captured'], frames, duration, results['sustained_hz'],
+            results["frames_captured"],
+            frames,
+            duration,
+            results["sustained_hz"],
         )
 
     yield from inner()
     return results
 
 
-def timelapse_volume_plan(volume_scanner,
-                           num_timepoints: int,
-                           interval_seconds: float,
-                           **volume_kwargs):
+def timelapse_volume_plan(
+    volume_scanner, num_timepoints: int, interval_seconds: float, **volume_kwargs
+):
     """
     Acquire time-lapse series of 3D volumes.
 
@@ -1074,16 +1100,16 @@ def timelapse_volume_plan(volume_scanner,
         Results with all volumes and timestamps
     """
     results = {
-        'volumes': [],
-        'timestamps': [],
-        'num_timepoints': num_timepoints,
-        'interval_seconds': interval_seconds
+        "volumes": [],
+        "timestamps": [],
+        "num_timepoints": num_timepoints,
+        "interval_seconds": interval_seconds,
     }
 
     _md = {
-        'plan_name': 'timelapse_volume',
-        'num_timepoints': num_timepoints,
-        'interval_seconds': interval_seconds
+        "plan_name": "timelapse_volume",
+        "num_timepoints": num_timepoints,
+        "interval_seconds": interval_seconds,
     }
 
     @bpp.run_decorator(md=_md)
@@ -1099,20 +1125,18 @@ def inner():
 
             # Acquire volume
             vol_results = yield from acquire_single_volume_plan(
-                volume_scanner,
-                metadata={'timepoint': tp},
-                **volume_kwargs
+                volume_scanner, metadata={"timepoint": tp}, **volume_kwargs
             )
 
-            results['volumes'].append(vol_results['volume'])
-            results['timestamps'].append(vol_results['timestamp'])
+            results["volumes"].append(vol_results["volume"])
+            results["timestamps"].append(vol_results["timestamp"])
 
             # Wait for next timepoint (except after last one)
             if tp < num_timepoints - 1:
                 logger.info("Waiting %d s until next timepoint...", interval_seconds)
                 yield from bps.sleep(interval_seconds)
 
-        logger.info("TIME-LAPSE COMPLETE - Total volumes: %d", len(results['volumes']))
+        logger.info("TIME-LAPSE COMPLETE - Total volumes: %d", len(results["volumes"]))
 
     yield from inner()
     return results
@@ -1122,11 +1146,14 @@ def inner():
 # MULTI-EMBRYO WORKFLOWS
 # =======================
 
-def multi_embryo_calibration_workflow(bottom_camera,
-                                       xy_stage,
-                                       lightsheet_snap,
-                                       num_embryos: int,
-                                       calibration_params: Optional[Dict] = None):
+
+def multi_embryo_calibration_workflow(
+    bottom_camera,
+    xy_stage,
+    lightsheet_snap,
+    num_embryos: int,
+    calibration_params: dict | None = None,
+):
     """
     Full multi-embryo calibration workflow.
 
@@ -1163,21 +1190,14 @@ def multi_embryo_calibration_workflow(bottom_camera,
     # Default calibration parameters
     if calibration_params is None:
         calibration_params = {
-            'piezo_positions': [40.0, 60.0],  # Two-point calibration
-            'search_range_deg': 0.02,
-            'n_sweep_points': 21
+            "piezo_positions": [40.0, 60.0],  # Two-point calibration
+            "search_range_deg": 0.02,
+            "n_sweep_points": 21,
         }
 
-    results = {
-        'embryos': [],
-        'num_embryos': num_embryos,
-        'timestamp': time.time()
-    }
+    results = {"embryos": [], "num_embryos": num_embryos, "timestamp": time.time()}
 
-    _md = {
-        'plan_name': 'multi_embryo_calibration_workflow',
-        'num_embryos': num_embryos
-    }
+    _md = {"plan_name": "multi_embryo_calibration_workflow", "num_embryos": num_embryos}
 
     @bpp.run_decorator(md=_md)
     def inner():
@@ -1193,35 +1213,37 @@ def inner():
 
             # Mark and center embryo
             marking_results = yield from mark_embryo_interactive_plan(
-                bottom_camera,
-                xy_stage,
-                embryo_number=emb_num
+                bottom_camera, xy_stage, embryo_number=emb_num
             )
 
-            if not marking_results.get('success', False):
+            if not marking_results.get("success", False):
                 logger.warning("Skipping embryo %d", emb_num)
                 continue
 
             # Perform calibration
             calib_results = yield from calibrate_piezo_galvo_plan(
                 lightsheet_snap,
-                metadata={'embryo_number': emb_num},
-                **calibration_params
+                metadata={"embryo_number": emb_num},
+                **calibration_params,
             )
 
             # Store results
             embryo_data = {
-                'embryo_number': emb_num,
-                'marking': marking_results,
-                'calibration': calib_results,
-                'timestamp': time.time()
+                "embryo_number": emb_num,
+                "marking": marking_results,
+                "calibration": calib_results,
+                "timestamp": time.time(),
             }
 
-            results['embryos'].append(embryo_data)
+            results["embryos"].append(embryo_data)
 
             logger.info("Embryo %d calibration complete!", emb_num)
 
-        logger.info("WORKFLOW COMPLETE - Calibrated %d/%d embryos", len(results['embryos']), num_embryos)
+        logger.info(
+            "WORKFLOW COMPLETE - Calibrated %d/%d embryos",
+            len(results["embryos"]),
+            num_embryos,
+        )
 
     yield from inner()
     return results
@@ -1231,10 +1253,11 @@ def inner():
 # Utility Plans (simple device operations for HTTP API)
 # =============================================================================
 
+
 def move_stage_plan(xy_stage, x: float, y: float) -> Generator[Any, Any, dict]:
     """Move XY stage to specified position."""
     yield from bps.mv(xy_stage, [x, y])
-    return {'x': x, 'y': y, 'success': True}
+    return {"x": x, "y": y, "success": True}
 
 
 def read_stage_plan(xy_stage) -> Generator[Any, Any, None]:
@@ -1251,13 +1274,13 @@ def capture_bottom_image_plan(bottom_camera, led=None) -> Generator[Any, Any, No
     """Capture a single image from the bottom camera."""
     if led is not None:
         try:
-            yield from bps.mv(led, 'Open')
+            yield from bps.mv(led, "Open")
         except Exception:
             pass
     yield from bp.count([bottom_camera], num=1)
     if led is not None:
         try:
-            yield from bps.mv(led, 'Closed')
+            yield from bps.mv(led, "Closed")
         except Exception:
             pass
 
@@ -1269,7 +1292,7 @@ def capture_lightsheet_image_plan(
     laser_control,
     piezo_position: float = 50.0,
     galvo_position: float = 0.0,
-    laser_config: str = "488 and 561"
+    laser_config: str = "488 and 561",
 ) -> Generator[Any, Any, None]:
     """Capture a single lightsheet image at specified piezo/galvo positions."""
     yield from bps.mv(piezo, piezo_position)
@@ -1285,25 +1308,25 @@ def capture_lightsheet_image_plan(
 def move_piezo_plan(piezo, position: float) -> Generator[Any, Any, dict]:
     """Move piezo to specified position."""
     yield from bps.mv(piezo, position)
-    return {'position': position, 'success': True}
+    return {"position": position, "success": True}
 
 
 def move_scanner_plan(scanner, offset_y: float) -> Generator[Any, Any, dict]:
     """Move scanner galvo to specified offset."""
     yield from bps.mv(scanner.sa_offset_y, offset_y)
-    return {'offset_y': offset_y, 'success': True}
+    return {"offset_y": offset_y, "success": True}
 
 
-def set_laser_plan(laser_control, state: str = 'ON') -> Generator[Any, Any, dict]:
+def set_laser_plan(laser_control, state: str = "ON") -> Generator[Any, Any, dict]:
     """Set laser state."""
     yield from bps.mv(laser_control.state, state)
-    return {'state': state, 'success': True}
+    return {"state": state, "success": True}
 
 
-def set_led_plan(led, state: str = 'Open') -> Generator[Any, Any, dict]:
+def set_led_plan(led, state: str = "Open") -> Generator[Any, Any, dict]:
     """Set LED state."""
     yield from bps.mv(led, state)
-    return {'state': state, 'success': True}
+    return {"state": state, "success": True}
 
 
 def set_light_source_power_plan(
@@ -1320,9 +1343,9 @@ def set_light_source_power_plan(
     light_source.set_power_pct(wavelength, pct)
     yield from bps.null()  # plan must be a generator
     return {
-        'wavelength': wavelength,
-        'pct': pct,
-        'success': True,
+        "wavelength": wavelength,
+        "pct": pct,
+        "success": True,
     }
 
 
@@ -1334,9 +1357,9 @@ def get_light_source_power_plan(
     value = light_source.get_power_pct(wavelength)
     yield from bps.null()
     return {
-        'wavelength': wavelength,
-        'pct': value,
-        'success': True,
+        "wavelength": wavelength,
+        "pct": value,
+        "success": True,
     }
 
 
@@ -1346,6 +1369,7 @@ def get_light_source_power_plan(
 # register the two objective views on top of each other via the XY stage.
 # ============================================================================
 
+
 def spim_head_focus_descent_plan(
     fdrive,
     camera,
@@ -1404,12 +1428,15 @@ def spim_head_focus_descent_plan(
         and fine_curve (list of (z_um, score) tuples).
     """
     from gently.analysis.focus import (
-        FocusAnalysisConfig, FocusDataPoint, analyze_focus_sweep, score_single_image,
+        FocusAnalysisConfig,
+        FocusDataPoint,
+        analyze_focus_sweep,
+        score_single_image,
     )
 
     lo, hi = fdrive.limits
     config = FocusAnalysisConfig(algorithm=focus_algorithm)
-    out: Dict[str, Any] = {}
+    out: dict[str, Any] = {}
 
     def _clamp(z: float) -> float:
         return max(lo, min(hi, float(z)))
@@ -1480,8 +1507,13 @@ def inner():
             start_position_um=start_z,
             fine_curve=[(float(d.position), float(d.score)) for d in sweep],
         )
-        logger.info("[SPIM head focus] locked %.1f um (score %.3g, R2=%.3f, fit=%s)",
-                    best, result.best_score, result.r_squared, result.success)
+        logger.info(
+            "[SPIM head focus] locked %.1f um (score %.3g, R2=%.3f, fit=%s)",
+            best,
+            result.best_score,
+            result.r_squared,
+            result.success,
+        )
 
     def cleanup():
         if led is not None:
@@ -1534,7 +1566,7 @@ def register_views_xy_plan(
     """
     from gently.core.coordinates import pixel_displacement_to_stage_movement
 
-    out: Dict[str, Any] = {"converged": False, "iterations": []}
+    out: dict[str, Any] = {"converged": False, "iterations": []}
 
     def _views(frame):
         if frame.ndim == 2 and frame.shape[1] >= frame.shape[0] * 1.5:
@@ -1560,9 +1592,9 @@ def inner():
             frame = camera.snap()
             views = _views(frame)
             offsets = [_centroid_offset(v) for v in views]
-            out["iterations"].append({
-                "offsets_px": [None if o is None else (float(o[0]), float(o[1])) for o in offsets]
-            })
+            out["iterations"].append(
+                {"offsets_px": [None if o is None else (float(o[0]), float(o[1])) for o in offsets]}
+            )
 
             ref = offsets[reference_view] if reference_view < len(offsets) else None
             if ref is None:
@@ -1577,7 +1609,7 @@ def inner():
                 break
 
             dx_um, dy_um = pixel_displacement_to_stage_movement(ref[0], ref[1], view_pixel_size_um)
-            cur = yield from bps.rd(xy_stage)   # -> [x, y] um (single reading value)
+            cur = yield from bps.rd(xy_stage)  # -> [x, y] um (single reading value)
             target = [cur[0] + x_sign * dx_um, cur[1] + y_sign * dy_um]
             yield from bps.mov(xy_stage, target)
             yield from bps.sleep(settle_s)
@@ -1599,10 +1631,10 @@ def spim_head_focus_and_align_plan(
     xy_stage,
     led=None,
     *,
-    view_pixel_size_um: Optional[float] = None,
+    view_pixel_size_um: float | None = None,
     align: bool = True,
-    focus_kwargs: Optional[Dict] = None,
-    align_kwargs: Optional[Dict] = None,
+    focus_kwargs: dict | None = None,
+    align_kwargs: dict | None = None,
 ) -> Generator[Any, Any, dict]:
     """
     Full SPIM-head focus workflow for one XY-positioned embryo.
@@ -1612,18 +1644,20 @@ def spim_head_focus_and_align_plan(
 
     ``align=True`` requires ``view_pixel_size_um`` (objective-view um/pixel).
     """
-    out: Dict[str, Any] = {}
+    out: dict[str, Any] = {}
     out["focus"] = yield from spim_head_focus_descent_plan(
         fdrive, camera, led=led, **(focus_kwargs or {})
     )
     if align:
         if view_pixel_size_um is None:
             raise ValueError(
-                "align=True requires view_pixel_size_um "
-                "(objective-view um/pixel calibration)"
+                "align=True requires view_pixel_size_um (objective-view um/pixel calibration)"
             )
         out["align"] = yield from register_views_xy_plan(
-            camera, xy_stage, view_pixel_size_um=view_pixel_size_um,
-            led=led, **(align_kwargs or {}),
+            camera,
+            xy_stage,
+            view_pixel_size_um=view_pixel_size_um,
+            led=led,
+            **(align_kwargs or {}),
         )
     return out
diff --git a/gently/hardware/dispim/plans/calibration.py b/gently/hardware/dispim/plans/calibration.py
index 94de95b1..798a203b 100644
--- a/gently/hardware/dispim/plans/calibration.py
+++ b/gently/hardware/dispim/plans/calibration.py
@@ -18,10 +18,11 @@
 
 import logging
 import time
+from datetime import datetime
+from pathlib import Path
+
 import bluesky.plan_stubs as bps
 import numpy as np
-from pathlib import Path
-from datetime import datetime
 
 logger = logging.getLogger(__name__)
 
@@ -39,9 +40,12 @@ def _safe_obtain(obj):
 # CLAUDE VISION PROMPTS
 # ============================================================================
 
-EMBRYO_CENTERING_PROMPT = """You are an expert microscopist examining a diSPIM light sheet microscopy image of a biological embryo sample.
+EMBRYO_CENTERING_PROMPT = """You are an expert microscopist examining a diSPIM light sheet
+microscopy image of a biological embryo sample.
 
-This image shows ONE camera view from the diSPIM system. You should look for an embryo structure somewhere in the field of view. The embryo will appear as a brighter structure against a dark background, but the signal may be MODERATE (not necessarily super bright).
+This image shows ONE camera view from the diSPIM system. You should look for an embryo
+structure somewhere in the field of view. The embryo will appear as a brighter structure
+against a dark background, but the signal may be MODERATE (not necessarily super bright).
 
 IMPORTANT CONTEXT:
 - This is a REAL microscopy image with typical noise and artifacts
@@ -73,11 +77,14 @@ def _safe_obtain(obj):
 
 Example response:
 yes
-An irregularly-shaped embryo structure is visible in the left-center region with moderate brightness and defined boundaries against the dark background."""
+An irregularly-shaped embryo structure is visible in the left-center region with moderate
+brightness and defined boundaries against the dark background."""
 
-EMBRYO_EDGE_PROMPT = """You are an expert microscopist specializing in diSPIM light sheet microscopy of embryos.
+EMBRYO_EDGE_PROMPT = """You are an expert microscopist specializing in diSPIM light sheet
+microscopy of embryos.
 
-This image shows ONE camera view of an embryo captured with light sheet illumination. We are trying to determine if the embryo is still visible at this Z position.
+This image shows ONE camera view of an embryo captured with light sheet illumination. We are
+trying to determine if the embryo is still visible at this Z position.
 
 CONTEXT:
 - We are sweeping through Z positions to find where the embryo appears/disappears
@@ -112,6 +119,7 @@ def _safe_obtain(obj):
 # PLAN: VERIFY EMBRYO CENTERED
 # ============================================================================
 
+
 def verify_embryo_centered(embryo_detector, image_dir=None):
     """
     Verify that embryo is centered and visible.
@@ -149,17 +157,19 @@ def verify_embryo_centered(embryo_detector, image_dir=None):
 
     # Metadata for this phase
     metadata = {
-        'plan_name': 'verify_embryo_centered',
-        'phase': 'centering',
-        'timestamp': datetime.now().isoformat()
+        "plan_name": "verify_embryo_centered",
+        "phase": "centering",
+        "timestamp": datetime.now().isoformat(),
     }
 
     # Start run
-    uid = yield from bps.open_run(md=metadata)
+    yield from bps.open_run(md=metadata)
 
     # Prepare image path
     if image_dir is not None:
-        image_path = Path(image_dir) / f"centering_check_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png"
+        image_path = (
+            Path(image_dir) / f"centering_check_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png"
+        )
     else:
         image_path = None
 
@@ -170,7 +180,7 @@ def verify_embryo_centered(embryo_detector, image_dir=None):
         galvo_deg=0.0,
         piezo_um=0.0,
         prompt=EMBRYO_CENTERING_PROMPT,
-        save_image_path=image_path
+        save_image_path=image_path,
     )
 
     # Log result
@@ -182,16 +192,16 @@ def verify_embryo_centered(embryo_detector, image_dir=None):
     yield from bps.close_run()
 
     # Report result
-    if result['embryo_visible']:
+    if result["embryo_visible"]:
         logger.info("Embryo VISIBLE at center")
-        logger.info("Claude: %s", result['description'])
-        logger.info("Confidence: %.1f%%", result['confidence'] * 100)
+        logger.info("Claude: %s", result["description"])
+        logger.info("Confidence: %.1f%%", result["confidence"] * 100)
         if image_path:
             logger.info("Image: %s", image_path)
         return True
     else:
         logger.warning("Embryo NOT VISIBLE at center")
-        logger.info("Claude: %s", result['description'])
+        logger.info("Claude: %s", result["description"])
         logger.warning("Please adjust sample position and try again")
         return False
 
@@ -200,10 +210,17 @@ def verify_embryo_centered(embryo_detector, image_dir=None):
 # PLAN: DETECT EMBRYO EDGE
 # ============================================================================
 
-def detect_embryo_edge(embryo_detector, direction='top',
-                       start_deg=0.0, end_deg=0.5, step_deg=0.05,
-                       tolerance_deg=0.20, piezo_um=0.0,
-                       image_dir=None):
+
+def detect_embryo_edge(
+    embryo_detector,
+    direction="top",
+    start_deg=0.0,
+    end_deg=0.5,
+    step_deg=0.05,
+    tolerance_deg=0.20,
+    piezo_um=0.0,
+    image_dir=None,
+):
     """
     Detect embryo edge by sweeping until embryo disappears.
 
@@ -263,7 +280,7 @@ def detect_embryo_edge(embryo_detector, direction='top',
     logger.info("=" * 70)
 
     # Determine sweep direction
-    if direction == 'top':
+    if direction == "top":
         # Sweep upward (negative direction)
         step = -abs(step_deg)
         tolerance_sign = -1
@@ -277,23 +294,28 @@ def detect_embryo_edge(embryo_detector, direction='top',
     positions = [start_deg + i * step for i in range(num_steps)]
 
     logger.info("Sweep strategy: Start at %+.3f deg, step %+.3f deg", start_deg, step)
-    logger.info("Testing %d positions from %+.3f deg to %+.3f deg", num_steps, start_deg, end_deg)
+    logger.info(
+        "Testing %d positions from %+.3f deg to %+.3f deg",
+        num_steps,
+        start_deg,
+        end_deg,
+    )
     logger.info("Looking for position where embryo disappears...")
 
     # Metadata
     metadata = {
-        'plan_name': 'detect_embryo_edge',
-        'phase': f'edge_detection_{direction}',
-        'direction': direction,
-        'start_deg': start_deg,
-        'end_deg': end_deg,
-        'step_deg': step,
-        'tolerance_deg': tolerance_deg,
-        'piezo_um': piezo_um,
-        'timestamp': datetime.now().isoformat()
+        "plan_name": "detect_embryo_edge",
+        "phase": f"edge_detection_{direction}",
+        "direction": direction,
+        "start_deg": start_deg,
+        "end_deg": end_deg,
+        "step_deg": step,
+        "tolerance_deg": tolerance_deg,
+        "piezo_um": piezo_um,
+        "timestamp": datetime.now().isoformat(),
     }
 
-    uid = yield from bps.open_run(md=metadata)
+    yield from bps.open_run(md=metadata)
 
     # Sweep through positions
     all_results = []
@@ -303,7 +325,10 @@ def detect_embryo_edge(embryo_detector, direction='top',
     for i, pos in enumerate(positions):
         # Prepare image path
         if image_dir is not None:
-            image_path = Path(image_dir) / f"edge_{direction}_pos{pos:+.3f}deg_{datetime.now().strftime('%H%M%S')}.png"
+            image_path = (
+                Path(image_dir)
+                / f"edge_{direction}_pos{pos:+.3f}deg_{datetime.now().strftime('%H%M%S')}.png"
+            )
         else:
             image_path = None
 
@@ -314,7 +339,7 @@ def detect_embryo_edge(embryo_detector, direction='top',
             galvo_deg=pos,
             piezo_um=piezo_um,
             prompt=EMBRYO_EDGE_PROMPT,
-            save_image_path=image_path
+            save_image_path=image_path,
         )
 
         all_results.append(result)
@@ -325,7 +350,7 @@ def detect_embryo_edge(embryo_detector, direction='top',
         yield from bps.save()
 
         # Check if embryo disappeared
-        if result['embryo_visible']:
+        if result["embryo_visible"]:
             logger.info("  -> visible")
         else:
             logger.info("  -> NOT visible - EDGE FOUND!")
@@ -349,11 +374,11 @@ def detect_embryo_edge(embryo_detector, direction='top',
 
     # Prepare result
     edge_result = {
-        'edge_deg': edge_position,
-        'with_tolerance_deg': edge_with_tolerance,
-        'num_steps': len(all_results),
-        'all_positions': [r['galvo_deg'] for r in all_results],
-        'all_visible': [r['embryo_visible'] for r in all_results]
+        "edge_deg": edge_position,
+        "with_tolerance_deg": edge_with_tolerance,
+        "num_steps": len(all_results),
+        "all_positions": [r["galvo_deg"] for r in all_results],
+        "all_visible": [r["embryo_visible"] for r in all_results],
     }
 
     yield from bps.close_run()
@@ -365,11 +390,21 @@ def detect_embryo_edge(embryo_detector, direction='top',
 # PLAN: CALIBRATE FOCUS AT POSITION
 # ============================================================================
 
-def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
-                                 galvo_deg, piezo_center_um,
-                                 sweep_range_um=20.0, sweep_step_um=2.0,
-                                 min_r_squared=0.75, image_dir=None,
-                                 phase_name="FOCUS CALIBRATION"):
+
+def calibrate_focus_at_position(
+    camera,
+    galvo,
+    piezo,
+    focus_scorer,
+    core,
+    galvo_deg,
+    piezo_center_um,
+    sweep_range_um=20.0,
+    sweep_step_um=2.0,
+    min_r_squared=0.75,
+    image_dir=None,
+    phase_name="FOCUS CALIBRATION",
+):
     """
     Perform focus sweep at a galvo position to find optimal piezo position.
 
@@ -457,16 +492,16 @@ def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
 
     # Metadata
     metadata = {
-        'plan_name': 'calibrate_focus_at_position',
-        'phase': phase_name,
-        'galvo_deg': galvo_deg,
-        'piezo_center_um': piezo_center_um,
-        'sweep_range_um': sweep_range_um,
-        'sweep_step_um': sweep_step_um,
-        'timestamp': datetime.now().isoformat()
+        "plan_name": "calibrate_focus_at_position",
+        "phase": phase_name,
+        "galvo_deg": galvo_deg,
+        "piezo_center_um": piezo_center_um,
+        "sweep_range_um": sweep_range_um,
+        "sweep_step_um": sweep_step_um,
+        "timestamp": datetime.now().isoformat(),
     }
 
-    uid = yield from bps.open_run(md=metadata)
+    yield from bps.open_run(md=metadata)
 
     # Move galvo to position. setPosition() is synchronous — it issues the
     # set + waits for the device to settle, so no explicit wait needed here.
@@ -511,7 +546,12 @@ def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
             view_name = "right"
 
         if pos == positions[0]:  # Only log once at start
-            logger.info("Using %s camera view (L:%.1f vs R:%.1f)", view_name, left_intensity, right_intensity)
+            logger.info(
+                "Using %s camera view (L:%.1f vs R:%.1f)",
+                view_name,
+                left_intensity,
+                right_intensity,
+            )
 
         # Store image for ROI detection
         all_images.append(img)
@@ -524,8 +564,16 @@ def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
             roi_height = y_max - y_min
             roi_width = x_max - x_min
             roi_percent = (roi_width * roi_height) / (img.shape[0] * img.shape[1]) * 100
-            logger.info("Embryo ROI: [%d:%d, %d:%d] (%dx%d px, %.1f%% of frame)",
-                        y_min, y_max, x_min, x_max, roi_width, roi_height, roi_percent)
+            logger.info(
+                "Embryo ROI: [%d:%d, %d:%d] (%dx%d px, %.1f%% of frame)",
+                y_min,
+                y_max,
+                x_min,
+                x_max,
+                roi_width,
+                roi_height,
+                roi_percent,
+            )
 
         # Convert to 8-bit with auto-scaling for better visibility
         # This matches the working calibrate_embryo_piezo_galvo.py behavior
@@ -540,7 +588,10 @@ def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
         # Save image if requested
         if image_dir is not None:
             from PIL import Image
-            image_path = Path(image_dir) / f"focus_pos{pos:.1f}um_{datetime.now().strftime('%H%M%S')}.png"
+
+            image_path = (
+                Path(image_dir) / f"focus_pos{pos:.1f}um_{datetime.now().strftime('%H%M%S')}.png"
+            )
             image_path.parent.mkdir(parents=True, exist_ok=True)
             Image.fromarray(img_8bit).save(image_path)
 
@@ -561,37 +612,37 @@ def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
     logger.info("Fitting Gaussian curve to focus scores...")
     fit_result = focus_scorer.fit_focus_curve(all_positions, all_scores)
 
-    if fit_result['success']:
+    if fit_result["success"]:
         logger.info("Fit successful!")
-        logger.info("Best focus: %.2f um", fit_result['best_position'])
-        logger.info("R-squared: %.3f (%s)", fit_result['r_squared'], fit_result['fit_quality'])
-        logger.info("Peak in center: %s", fit_result['peak_in_center'])
+        logger.info("Best focus: %.2f um", fit_result["best_position"])
+        logger.info("R-squared: %.3f (%s)", fit_result["r_squared"], fit_result["fit_quality"])
+        logger.info("Peak in center: %s", fit_result["peak_in_center"])
 
         result = {
-            'success': True,
-            'optimal_position_um': fit_result['best_position'],
-            'r_squared': fit_result['r_squared'],
-            'all_positions': all_positions,
-            'all_scores': all_scores,
-            'galvo_deg': galvo_deg,
-            'fit_params': fit_result['params']
+            "success": True,
+            "optimal_position_um": fit_result["best_position"],
+            "r_squared": fit_result["r_squared"],
+            "all_positions": all_positions,
+            "all_scores": all_scores,
+            "galvo_deg": galvo_deg,
+            "fit_params": fit_result["params"],
         }
     else:
-        logger.warning("Fit failed: %s", fit_result.get('error_message', 'Unknown error'))
-        logger.warning("R-squared: %.3f (threshold: %.3f)", fit_result['r_squared'], min_r_squared)
+        logger.warning("Fit failed: %s", fit_result.get("error_message", "Unknown error"))
+        logger.warning("R-squared: %.3f (threshold: %.3f)", fit_result["r_squared"], min_r_squared)
         logger.warning("Using maximum score position as fallback")
 
         max_idx = np.argmax(all_scores)
         fallback_position = all_positions[max_idx]
 
         result = {
-            'success': False,
-            'optimal_position_um': fallback_position,
-            'r_squared': fit_result['r_squared'],
-            'all_positions': all_positions,
-            'all_scores': all_scores,
-            'galvo_deg': galvo_deg,
-            'error_message': fit_result.get('error_message', 'Poor fit quality')
+            "success": False,
+            "optimal_position_um": fallback_position,
+            "r_squared": fit_result["r_squared"],
+            "all_positions": all_positions,
+            "all_scores": all_scores,
+            "galvo_deg": galvo_deg,
+            "error_message": fit_result.get("error_message", "Poor fit quality"),
         }
 
     yield from bps.close_run()
@@ -603,8 +654,14 @@ def calibrate_focus_at_position(camera, galvo, piezo, focus_scorer, core,
 # PLAN: FULL CALIBRATION ORCHESTRATION
 # ============================================================================
 
+
 def calibrate_embryo_piezo_galvo(
-    camera, galvo, piezo, focus_scorer, embryo_detector, core,
+    camera,
+    galvo,
+    piezo,
+    focus_scorer,
+    embryo_detector,
+    core,
     calibration_inset_fraction=0.4,
     edge_detection_step_deg=0.05,
     edge_tolerance_deg=0.20,
@@ -614,7 +671,7 @@ def calibrate_embryo_piezo_galvo(
     heuristic_slope=100.0,
     heuristic_offset=0.0,
     image_dir=None,
-    save_path=None
+    save_path=None,
 ):
     """
     Complete embryo-based piezo-galvo calibration workflow.
@@ -716,7 +773,7 @@ def calibrate_embryo_piezo_galvo(
         if not centered:
             logger.error("CALIBRATION ABORTED: Embryo not centered")
             logger.error("Please adjust sample position and try again.")
-            return {'success': False, 'error': 'Embryo not centered'}
+            return {"success": False, "error": "Embryo not centered"}
 
         # ====================================================================
         # PHASE 1.5: EDGE DETECTION
@@ -728,41 +785,53 @@ def calibrate_embryo_piezo_galvo(
         logger.info("Detecting TOP edge (sweeping upward from center)...")
         top_edge_result = yield from detect_embryo_edge(
             embryo_detector,
-            direction='top',
+            direction="top",
             start_deg=0.0,
             end_deg=-0.5,
             step_deg=edge_detection_step_deg,
             tolerance_deg=edge_tolerance_deg,
             piezo_um=0.0,
-            image_dir=image_dir
+            image_dir=image_dir,
         )
 
-        edge_top_deg = top_edge_result['edge_deg']
-        scan_top_deg = top_edge_result['with_tolerance_deg']
+        edge_top_deg = top_edge_result["edge_deg"]
+        scan_top_deg = top_edge_result["with_tolerance_deg"]
 
         # Detect BOTTOM edge (sweep downward from center)
         logger.info("Detecting BOTTOM edge (sweeping downward from center)...")
         bottom_edge_result = yield from detect_embryo_edge(
             embryo_detector,
-            direction='bottom',
+            direction="bottom",
             start_deg=0.0,
             end_deg=0.5,
             step_deg=edge_detection_step_deg,
             tolerance_deg=edge_tolerance_deg,
             piezo_um=0.0,
-            image_dir=image_dir
+            image_dir=image_dir,
         )
 
-        edge_bottom_deg = bottom_edge_result['edge_deg']
-        scan_bottom_deg = bottom_edge_result['with_tolerance_deg']
+        edge_bottom_deg = bottom_edge_result["edge_deg"]
+        scan_bottom_deg = bottom_edge_result["with_tolerance_deg"]
 
         detected_range = scan_bottom_deg - scan_top_deg
 
         logger.info("EDGE DETECTION SUMMARY")
-        logger.info("Detected edges: TOP=%+.3f deg, BOTTOM=%+.3f deg", edge_top_deg, edge_bottom_deg)
-        logger.info("Scan boundaries: TOP=%+.3f deg (incl %.3f deg margin), BOTTOM=%+.3f deg",
-                     scan_top_deg, edge_tolerance_deg, scan_bottom_deg)
-        logger.info("Total scan range: %.3f deg (~%.1f um)", detected_range, detected_range * 100)
+        logger.info(
+            "Detected edges: TOP=%+.3f deg, BOTTOM=%+.3f deg",
+            edge_top_deg,
+            edge_bottom_deg,
+        )
+        logger.info(
+            "Scan boundaries: TOP=%+.3f deg (incl %.3f deg margin), BOTTOM=%+.3f deg",
+            scan_top_deg,
+            edge_tolerance_deg,
+            scan_bottom_deg,
+        )
+        logger.info(
+            "Total scan range: %.3f deg (~%.1f um)",
+            detected_range,
+            detected_range * 100,
+        )
 
         # ====================================================================
         # CALCULATE INTERIOR CALIBRATION POSITIONS
@@ -778,21 +847,37 @@ def calibrate_embryo_piezo_galvo(
         calib_bottom_deg = scan_bottom_deg - inset_amount
         calib_range = calib_bottom_deg - calib_top_deg
 
-        logger.info("Inset fraction: %.0f%%, distance: %.3f deg (~%.1f um)",
-                     calibration_inset_fraction * 100, inset_amount, inset_amount * 100)
-        logger.info("TOP calibration: scan boundary %+.3f deg -> calibrate at %+.3f deg",
-                     scan_top_deg, calib_top_deg)
-        logger.info("BOTTOM calibration: scan boundary %+.3f deg -> calibrate at %+.3f deg",
-                     scan_bottom_deg, calib_bottom_deg)
-        logger.info("Calibration range: %.3f deg, Volume scan range: %.3f deg",
-                     calib_range, detected_range)
+        logger.info(
+            "Inset fraction: %.0f%%, distance: %.3f deg (~%.1f um)",
+            calibration_inset_fraction * 100,
+            inset_amount,
+            inset_amount * 100,
+        )
+        logger.info(
+            "TOP calibration: scan boundary %+.3f deg -> calibrate at %+.3f deg",
+            scan_top_deg,
+            calib_top_deg,
+        )
+        logger.info(
+            "BOTTOM calibration: scan boundary %+.3f deg -> calibrate at %+.3f deg",
+            scan_bottom_deg,
+            calib_bottom_deg,
+        )
+        logger.info(
+            "Calibration range: %.3f deg, Volume scan range: %.3f deg",
+            calib_range,
+            detected_range,
+        )
 
         # Estimate piezo positions using heuristic
         piezo_top_heuristic = calib_top_deg * heuristic_slope + heuristic_offset
         piezo_bottom_heuristic = calib_bottom_deg * heuristic_slope + heuristic_offset
 
-        logger.info("Heuristic piezo positions: TOP=%.1f um, BOTTOM=%.1f um",
-                     piezo_top_heuristic, piezo_bottom_heuristic)
+        logger.info(
+            "Heuristic piezo positions: TOP=%.1f um, BOTTOM=%.1f um",
+            piezo_top_heuristic,
+            piezo_bottom_heuristic,
+        )
 
         # ====================================================================
         # PHASE 2: TOP CALIBRATION
@@ -800,21 +885,28 @@ def calibrate_embryo_piezo_galvo(
         logger.info("[4/8] Phase 2: TOP Interior Focus Calibration")
 
         top_result = yield from calibrate_focus_at_position(
-            camera, galvo, piezo, focus_scorer, core,
+            camera,
+            galvo,
+            piezo,
+            focus_scorer,
+            core,
             galvo_deg=calib_top_deg,
             piezo_center_um=piezo_top_heuristic,
             sweep_range_um=sweep_range_um,
             sweep_step_um=sweep_step_um,
             min_r_squared=min_r_squared,
             image_dir=image_dir,
-            phase_name="PHASE 2: TOP CALIBRATION"
+            phase_name="PHASE 2: TOP CALIBRATION",
         )
 
-        if not top_result['success']:
-            logger.warning("TOP calibration fit quality poor (R-squared=%.3f)", top_result['r_squared'])
+        if not top_result["success"]:
+            logger.warning(
+                "TOP calibration fit quality poor (R-squared=%.3f)",
+                top_result["r_squared"],
+            )
             logger.warning("Using best score position as fallback")
 
-        piezo_top_final = top_result['optimal_position_um']
+        piezo_top_final = top_result["optimal_position_um"]
         logger.info("TOP optimal position: %.2f um", piezo_top_final)
 
         # ====================================================================
@@ -823,21 +915,28 @@ def calibrate_embryo_piezo_galvo(
         logger.info("[5/8] Phase 3: BOTTOM Interior Focus Calibration")
 
         bottom_result = yield from calibrate_focus_at_position(
-            camera, galvo, piezo, focus_scorer, core,
+            camera,
+            galvo,
+            piezo,
+            focus_scorer,
+            core,
             galvo_deg=calib_bottom_deg,
             piezo_center_um=piezo_bottom_heuristic,
             sweep_range_um=sweep_range_um,
             sweep_step_um=sweep_step_um,
             min_r_squared=min_r_squared,
             image_dir=image_dir,
-            phase_name="PHASE 3: BOTTOM CALIBRATION"
+            phase_name="PHASE 3: BOTTOM CALIBRATION",
         )
 
-        if not bottom_result['success']:
-            logger.warning("BOTTOM calibration fit quality poor (R-squared=%.3f)", bottom_result['r_squared'])
+        if not bottom_result["success"]:
+            logger.warning(
+                "BOTTOM calibration fit quality poor (R-squared=%.3f)",
+                bottom_result["r_squared"],
+            )
             logger.warning("Using best score position as fallback")
 
-        piezo_bottom_final = bottom_result['optimal_position_um']
+        piezo_bottom_final = bottom_result["optimal_position_um"]
         logger.info("BOTTOM optimal position: %.2f um", piezo_bottom_final)
 
         # ====================================================================
@@ -855,8 +954,14 @@ def calibrate_embryo_piezo_galvo(
         slope = delta_piezo / delta_galvo
         offset = piezo_top_final - slope * calib_top_deg
 
-        logger.info("Calibration points: TOP galvo=%+.3f deg piezo=%+.2f um, BOTTOM galvo=%+.3f deg piezo=%+.2f um",
-                     calib_top_deg, piezo_top_final, calib_bottom_deg, piezo_bottom_final)
+        logger.info(
+            "Calibration points: TOP galvo=%+.3f deg piezo=%+.2f um,"
+            " BOTTOM galvo=%+.3f deg piezo=%+.2f um",
+            calib_top_deg,
+            piezo_top_final,
+            calib_bottom_deg,
+            piezo_bottom_final,
+        )
         logger.info("Linear fit: piezo(um) = %.2f * galvo(deg) + %.2f", slope, offset)
         logger.info("Slope: %.2f um/deg, Offset: %.2f um", slope, offset)
 
@@ -864,9 +969,15 @@ def calibrate_embryo_piezo_galvo(
         piezo_top_scan = scan_top_deg * slope + offset
         piezo_bottom_scan = scan_bottom_deg * slope + offset
 
-        logger.info("Volume scan range: TOP galvo=%+.3f deg piezo=%+.2f um, BOTTOM galvo=%+.3f deg piezo=%+.2f um, Total=%.1f um",
-                     scan_top_deg, piezo_top_scan, scan_bottom_deg, piezo_bottom_scan,
-                     abs(piezo_bottom_scan - piezo_top_scan))
+        logger.info(
+            "Volume scan range: TOP galvo=%+.3f deg piezo=%+.2f um,"
+            " BOTTOM galvo=%+.3f deg piezo=%+.2f um, Total=%.1f um",
+            scan_top_deg,
+            piezo_top_scan,
+            scan_bottom_deg,
+            piezo_bottom_scan,
+            abs(piezo_bottom_scan - piezo_top_scan),
+        )
 
         # ====================================================================
         # CREATE CALIBRATION OBJECT
@@ -882,8 +993,8 @@ def calibrate_embryo_piezo_galvo(
             piezo_bottom_um=piezo_bottom_scan,
             edge_top_deg=edge_top_deg,
             edge_bottom_deg=edge_bottom_deg,
-            sample_type='embryo',
-            timestamp=datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+            sample_type="embryo",
+            timestamp=datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
         )
 
         logger.info("Calibration object created: %s", calibration)
@@ -910,24 +1021,27 @@ def calibrate_embryo_piezo_galvo(
         logger.info("Calibration: piezo(um) = %.2f * galvo(deg) + %.2f", slope, offset)
         logger.info("Scan range: %+.3f deg to %+.3f deg", scan_top_deg, scan_bottom_deg)
         logger.info("Piezo range: %+.2f to %+.2f um", piezo_top_scan, piezo_bottom_scan)
-        logger.info("Quality: TOP R-squared=%.3f, BOTTOM R-squared=%.3f",
-                     top_result['r_squared'], bottom_result['r_squared'])
+        logger.info(
+            "Quality: TOP R-squared=%.3f, BOTTOM R-squared=%.3f",
+            top_result["r_squared"],
+            bottom_result["r_squared"],
+        )
 
         if save_path:
             logger.info("Calibration saved to: %s", save_path)
 
         # Store result for databroker access
         result = {
-            'success': True,
-            'calibration': calibration,
-            'slope_um_per_deg': slope,
-            'offset_um': offset,
-            'top_r_squared': top_result['r_squared'],
-            'bottom_r_squared': bottom_result['r_squared'],
-            'scan_top_deg': scan_top_deg,
-            'scan_bottom_deg': scan_bottom_deg,
-            'edge_top_deg': edge_top_deg,
-            'edge_bottom_deg': edge_bottom_deg
+            "success": True,
+            "calibration": calibration,
+            "slope_um_per_deg": slope,
+            "offset_um": offset,
+            "top_r_squared": top_result["r_squared"],
+            "bottom_r_squared": bottom_result["r_squared"],
+            "scan_top_deg": scan_top_deg,
+            "scan_bottom_deg": scan_bottom_deg,
+            "edge_top_deg": edge_top_deg,
+            "edge_bottom_deg": edge_bottom_deg,
         }
 
     except Exception as e:
@@ -936,10 +1050,7 @@ def calibrate_embryo_piezo_galvo(
         logger.error("=" * 70)
         logger.error("Error: %s", e, exc_info=True)
 
-        result = {
-            'success': False,
-            'error': str(e)
-        }
+        result = {"success": False, "error": str(e)}
 
     return result
 
@@ -949,10 +1060,10 @@ def calibrate_embryo_piezo_galvo(
 # ============================================================================
 
 __all__ = [
-    'EMBRYO_CENTERING_PROMPT',
-    'EMBRYO_EDGE_PROMPT',
-    'verify_embryo_centered',
-    'detect_embryo_edge',
-    'calibrate_focus_at_position',
-    'calibrate_embryo_piezo_galvo'
+    "EMBRYO_CENTERING_PROMPT",
+    "EMBRYO_EDGE_PROMPT",
+    "verify_embryo_centered",
+    "detect_embryo_edge",
+    "calibrate_focus_at_position",
+    "calibrate_embryo_piezo_galvo",
 ]
diff --git a/gently/hardware/dispim/plans/multi_embryo.py b/gently/hardware/dispim/plans/multi_embryo.py
index 7a4b760a..6536b37c 100644
--- a/gently/hardware/dispim/plans/multi_embryo.py
+++ b/gently/hardware/dispim/plans/multi_embryo.py
@@ -15,36 +15,34 @@
 """
 
 import logging
-import numpy as np
-import time
-from pathlib import Path
 from datetime import datetime
-from typing import Dict, List, Optional, Tuple
-import bluesky.plan_stubs as bps
+from pathlib import Path
 
-logger = logging.getLogger(__name__)
-from bluesky.preprocessors import finalize_wrapper, run_wrapper
+import bluesky.plan_stubs as bps
+import numpy as np
 
 # Import existing calibration infrastructure
-from .calibration import calibrate_embryo_piezo_galvo
-from gently.ui.web.embryo_marker import mark_embryos_web
 from gently.core.database import (
-    export_multi_embryo_database,
     add_embryo_to_database,
-    save_multi_embryo_database
+    save_multi_embryo_database,
 )
+from gently.ui.web.embryo_marker import mark_embryos_web
+
+from .calibration import calibrate_embryo_piezo_galvo
 
+logger = logging.getLogger(__name__)
 
 # ============================================================================
 # PLAN: CENTER AND VERIFY EMBRYO
 # ============================================================================
 
+
 def center_and_verify_embryo_plan(
     bottom_camera,
     xy_stage,
-    embryo_data: Dict,
+    embryo_data: dict,
     save_verification: bool = True,
-    image_dir: Optional[Path] = None
+    image_dir: Path | None = None,
 ):
     """
     Center XY stage on marked embryo position and capture verification image.
@@ -78,9 +76,9 @@ def center_and_verify_embryo_plan(
     dict
         Updated embryo data with 'centered_stage_position_um' and verification info
     """
-    embryo_id = embryo_data['embryo_id']
-    pixel_x, pixel_y = embryo_data['pixel_position']
-    initial_stage_x, initial_stage_y = embryo_data['initial_stage_position']
+    embryo_id = embryo_data["embryo_id"]
+    pixel_x, pixel_y = embryo_data["pixel_position"]
+    initial_stage_x, initial_stage_y = embryo_data["initial_stage_position"]
 
     logger.info("[Centering %s]", embryo_id)
     logger.info("Pixel position: (%.1f, %.1f)", pixel_x, pixel_y)
@@ -108,7 +106,11 @@ def center_and_verify_embryo_plan(
 
     # Debug output matching original code format
     logger.debug("Image center: (%.0f, %.0f) pixels", image_center_x, image_center_y)
-    logger.debug("Pixel displacement: (%+.1f, %+.1f) pixels", pixel_displacement_x, pixel_displacement_y)
+    logger.debug(
+        "Pixel displacement: (%+.1f, %+.1f) pixels",
+        pixel_displacement_x,
+        pixel_displacement_y,
+    )
     logger.debug("Stage movement: (%+.2f, %+.2f) um", dx, dy)
     logger.info("Target stage: (%.2f, %.2f) um", target_pos[0], target_pos[1])
 
@@ -117,15 +119,29 @@ def center_and_verify_embryo_plan(
     y_min, y_max = xy_stage._y_limits
 
     if not (x_min <= target_pos[0] <= x_max):
-        logger.error("Target X position %.2f outside limits (%s, %s)", target_pos[0], x_min, x_max)
+        logger.error(
+            "Target X position %.2f outside limits (%s, %s)",
+            target_pos[0],
+            x_min,
+            x_max,
+        )
         logger.error("Skipping %s - marked position unreachable", embryo_id)
-        embryo_data['error'] = f"Stage X out of bounds: {target_pos[0]:.2f} not in ({x_min}, {x_max})"
+        embryo_data["error"] = (
+            f"Stage X out of bounds: {target_pos[0]:.2f} not in ({x_min}, {x_max})"
+        )
         return embryo_data
 
     if not (y_min <= target_pos[1] <= y_max):
-        logger.error("Target Y position %.2f outside limits (%s, %s)", target_pos[1], y_min, y_max)
+        logger.error(
+            "Target Y position %.2f outside limits (%s, %s)",
+            target_pos[1],
+            y_min,
+            y_max,
+        )
         logger.error("Skipping %s - marked position unreachable", embryo_id)
-        embryo_data['error'] = f"Stage Y out of bounds: {target_pos[1]:.2f} not in ({y_min}, {y_max})"
+        embryo_data["error"] = (
+            f"Stage Y out of bounds: {target_pos[1]:.2f} not in ({y_min}, {y_max})"
+        )
         return embryo_data
 
     # Move stage
@@ -140,14 +156,14 @@ def center_and_verify_embryo_plan(
 
     # Capture verification image
     logger.info("Capturing verification image...")
-    yield from bps.trigger_and_read([bottom_camera], name='verification')
+    yield from bps.trigger_and_read([bottom_camera], name="verification")
 
     # Save verification image if requested
     if save_verification and image_dir is not None:
         image_dir = Path(image_dir)
         image_dir.mkdir(parents=True, exist_ok=True)
 
-        timestamp = datetime.now().strftime('%Y%m%d_%H%M%S')
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
         save_path = image_dir / f"{embryo_id}_AFTER_centering_{timestamp}.png"
 
         # Get image from device
@@ -155,13 +171,14 @@ def center_and_verify_embryo_plan(
 
         if verification_image is not None:
             import tifffile
+
             tifffile.imwrite(save_path, verification_image)
             logger.info("Saved: %s", save_path.name)
 
     # Update embryo data with centered position
-    embryo_data['centered_stage_x'] = float(final_pos[0])
-    embryo_data['centered_stage_y'] = float(final_pos[1])
-    embryo_data['centering_timestamp'] = datetime.now().isoformat()
+    embryo_data["centered_stage_x"] = float(final_pos[0])
+    embryo_data["centered_stage_y"] = float(final_pos[1])
+    embryo_data["centering_timestamp"] = datetime.now().isoformat()
 
     logger.info("%s centered!", embryo_id)
 
@@ -172,12 +189,13 @@ def center_and_verify_embryo_plan(
 # PLAN: CALIBRATE SINGLE EMBRYO IN SESSION
 # ============================================================================
 
+
 def calibrate_single_embryo_in_session_plan(
-    embryo_data: Dict,
+    embryo_data: dict,
     embryo_detector,
     laser_control,
-    image_dir: Optional[Path] = None,
-    calibration_params: Optional[Dict] = None
+    image_dir: Path | None = None,
+    calibration_params: dict | None = None,
 ):
     """
     Calibrate single embryo and store results in databroker.
@@ -207,25 +225,25 @@ def calibrate_single_embryo_in_session_plan(
     dict
         Updated embryo data with calibration results
     """
-    embryo_id = embryo_data['embryo_id']
-    embryo_number = embryo_data['embryo_number']
+    embryo_id = embryo_data["embryo_id"]
+    embryo_number = embryo_data["embryo_number"]
 
     logger.info("=" * 70)
     logger.info("CALIBRATING %s", embryo_id.upper())
     logger.info("=" * 70)
 
     # Prepare metadata for this embryo run
-    embryo_metadata = {
-        'embryo_id': embryo_id,
-        'embryo_number': embryo_number,
-        'pixel_x': embryo_data['pixel_position'][0],
-        'pixel_y': embryo_data['pixel_position'][1],
-        'initial_stage_x': embryo_data['initial_stage_position'][0],
-        'initial_stage_y': embryo_data['initial_stage_position'][1],
-        'centered_stage_x': embryo_data.get('centered_stage_x', 0.0),
-        'centered_stage_y': embryo_data.get('centered_stage_y', 0.0),
-        'marking_timestamp': embryo_data.get('marking_timestamp', ''),
-        'centering_timestamp': embryo_data.get('centering_timestamp', ''),
+    {
+        "embryo_id": embryo_id,
+        "embryo_number": embryo_number,
+        "pixel_x": embryo_data["pixel_position"][0],
+        "pixel_y": embryo_data["pixel_position"][1],
+        "initial_stage_x": embryo_data["initial_stage_position"][0],
+        "initial_stage_y": embryo_data["initial_stage_position"][1],
+        "centered_stage_x": embryo_data.get("centered_stage_x", 0.0),
+        "centered_stage_y": embryo_data.get("centered_stage_y", 0.0),
+        "marking_timestamp": embryo_data.get("marking_timestamp", ""),
+        "centering_timestamp": embryo_data.get("centering_timestamp", ""),
     }
 
     # Merge custom calibration parameters
@@ -242,16 +260,16 @@ def calibrate_single_embryo_in_session_plan(
         embryo_detector=embryo_detector.claude_client,
         core=embryo_detector.core,
         image_dir=image_dir,
-        **calib_params
+        **calib_params,
     )
 
     # Extract calibration data from result
     if calibration_result is not None:
-        embryo_data['calibration'] = calibration_result
+        embryo_data["calibration"] = calibration_result
         logger.info("%s calibration complete!", embryo_id)
     else:
         logger.error("%s calibration failed!", embryo_id)
-        embryo_data['calibration'] = None
+        embryo_data["calibration"] = None
 
     return embryo_data
 
@@ -260,16 +278,18 @@ def calibrate_single_embryo_in_session_plan(
 # PLAN: MULTI-EMBRYO CALIBRATION SESSION
 # ============================================================================
 
+
 def multi_embryo_calibration_session_plan(
     bottom_camera,
     xy_stage,
     embryo_detector,
     laser_control,
     output_database_path: Path,
-    image_dir: Optional[Path] = None,
+    image_dir: Path | None = None,
     auto_mark: bool = False,
-    pre_marked_embryos: Optional[List[Dict]] = None,
-    calibration_params: Optional[Dict] = None
+    pre_marked_embryos: list[dict] | None = None,
+    calibration_params: dict | None = None,
+    **kwargs,
 ):
     """
     Complete multi-embryo calibration workflow with Bluesky architecture.
@@ -352,11 +372,11 @@ def multi_embryo_calibration_session_plan(
 
     # Prepare session metadata
     session_metadata = {
-        'plan_name': 'multi_embryo_calibration_session',
-        'output_database_path': str(output_database_path),
-        'image_dir': str(image_dir),
-        'session_start': datetime.now().isoformat(),
-        'embryo_runs': []  # Will be populated with UIDs
+        "plan_name": "multi_embryo_calibration_session",
+        "output_database_path": str(output_database_path),
+        "image_dir": str(image_dir),
+        "session_start": datetime.now().isoformat(),
+        "embryo_runs": [],  # Will be populated with UIDs
     }
 
     def inner_session_plan():
@@ -369,10 +389,15 @@ def inner_session_plan():
 
         # Use pre-marked embryos if provided (marking done outside plan to avoid Qt threading)
         if pre_marked_embryos is not None:
-            logger.info("Using pre-marked embryo positions (%d embryos)", len(pre_marked_embryos))
+            logger.info(
+                "Using pre-marked embryo positions (%d embryos)",
+                len(pre_marked_embryos),
+            )
             marked_embryos = pre_marked_embryos
         elif auto_mark:
-            raise NotImplementedError("Auto-detection not yet implemented. Use pre-marked positions.")
+            raise NotImplementedError(
+                "Auto-detection not yet implemented. Use pre-marked positions."
+            )
         else:
             # This path requires capturing overview and interactive marking inside plan
             # WARNING: This may cause Qt threading issues with napari!
@@ -381,11 +406,15 @@ def inner_session_plan():
 
             # Get initial stage position
             initial_stage_pos = xy_stage.get_position()
-            logger.info("Initial stage position: (%.2f, %.2f) um", initial_stage_pos[0], initial_stage_pos[1])
+            logger.info(
+                "Initial stage position: (%.2f, %.2f) um",
+                initial_stage_pos[0],
+                initial_stage_pos[1],
+            )
 
             # Capture overview image
             logger.info("Capturing bottom camera overview...")
-            yield from bps.trigger_and_read([bottom_camera], name='overview')
+            yield from bps.trigger_and_read([bottom_camera], name="overview")
 
             # Get overview image from device
             overview_image = bottom_camera._last_image
@@ -394,18 +423,20 @@ def inner_session_plan():
                 raise RuntimeError("Failed to capture overview image!")
 
             # Save overview image
-            timestamp = datetime.now().strftime('%Y%m%d_%H%M%S')
+            timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
             overview_path = image_dir / f"initial_view_{timestamp}.png"
             import tifffile
+
             tifffile.imwrite(overview_path, overview_image)
             logger.info("Saved overview: %s", overview_path.name)
 
             logger.info("Launching interactive embryo marking...")
 
             # Prefer web-based marking (no Qt dependency, works remotely)
-            viz_server = kwargs.get('viz_server')
+            viz_server = kwargs.get("viz_server")
             if viz_server is not None:
                 import asyncio
+
                 logger.info("Using web-based marking via visualization server")
                 marked_embryos = asyncio.get_event_loop().run_until_complete(
                     mark_embryos_web(
@@ -413,7 +444,7 @@ def inner_session_plan():
                         image=overview_image,
                         initial_stage_position=tuple(initial_stage_pos),
                         pixel_size_um=bottom_camera.effective_pixel_size,
-                        save_image_path=image_dir / f"all_embryos_marked_{timestamp}.png"
+                        save_image_path=image_dir / f"all_embryos_marked_{timestamp}.png",
                     )
                 )
             else:
@@ -425,9 +456,7 @@ def inner_session_plan():
                     "interactive marking surface (napari has been retired). "
                     "Start the visualization server before calling this plan."
                 )
-                raise RuntimeError(
-                    "Interactive marking requires the web visualization server."
-                )
+                raise RuntimeError("Interactive marking requires the web visualization server.")
 
         if len(marked_embryos) == 0:
             logger.error("No embryos marked! Aborting session.")
@@ -442,10 +471,9 @@ def inner_session_plan():
         logger.info("[PHASE 2] Calibrating each embryo...")
 
         calibrated_embryos = []
-        embryo_run_uids = []
 
         for i, embryo_data in enumerate(marked_embryos, 1):
-            embryo_id = embryo_data['embryo_id']
+            embryo_id = embryo_data["embryo_id"]
 
             logger.info("-" * 70)
             logger.info("EMBRYO %d/%d: %s", i, len(marked_embryos), embryo_id)
@@ -457,11 +485,11 @@ def inner_session_plan():
                 xy_stage=xy_stage,
                 embryo_data=embryo_data,
                 save_verification=True,
-                image_dir=image_dir
+                image_dir=image_dir,
             )
 
             # Check if centering failed (position out of bounds)
-            if 'error' in embryo_data:
+            if "error" in embryo_data:
                 logger.warning("Skipping calibration for %s due to centering error", embryo_id)
                 calibrated_embryos.append(embryo_data)
                 continue
@@ -472,7 +500,7 @@ def inner_session_plan():
                 embryo_detector=embryo_detector,
                 laser_control=laser_control,
                 image_dir=image_dir / embryo_id,
-                calibration_params=calibration_params
+                calibration_params=calibration_params,
             )
 
             calibrated_embryos.append(embryo_data)
@@ -488,13 +516,13 @@ def inner_session_plan():
 
         # Build database structure
         database = {
-            'created': session_metadata['session_start'],
-            'embryos': {},
-            'last_updated': datetime.now().isoformat()
+            "created": session_metadata["session_start"],
+            "embryos": {},
+            "last_updated": datetime.now().isoformat(),
         }
 
         for embryo_data in calibrated_embryos:
-            embryo_id = embryo_data['embryo_id']
+            embryo_id = embryo_data["embryo_id"]
             database = add_embryo_to_database(database, embryo_id, embryo_data)
 
         # Save JSON database
@@ -503,7 +531,10 @@ def inner_session_plan():
 
         logger.info("Exported database: %s", output_database_path_resolved)
         logger.info("Total embryos: %d", len(calibrated_embryos))
-        logger.info("Successful calibrations: %d", sum(1 for e in calibrated_embryos if e.get('calibration') is not None))
+        logger.info(
+            "Successful calibrations: %d",
+            sum(1 for e in calibrated_embryos if e.get("calibration") is not None),
+        )
 
         # ====================================================================
         # SESSION COMPLETE
diff --git a/gently/hardware/dispim/sam_detection.py b/gently/hardware/dispim/sam_detection.py
index caeb8e5a..cea9990a 100644
--- a/gently/hardware/dispim/sam_detection.py
+++ b/gently/hardware/dispim/sam_detection.py
@@ -5,29 +5,28 @@
 Returns embryo positions (pixel + stage coordinates) for calibration workflow.
 """
 
-import logging
-import time
+import base64
 import json
+import logging
+import os
 import uuid
-import numpy as np
+from io import BytesIO
 from pathlib import Path
+
+import anthropic
 import cv2
-import base64
-from io import BytesIO
+import numpy as np
 from PIL import Image
-import anthropic
-from typing import Dict, List, Tuple, Optional
-import os
 
 from gently.settings import settings
 
 logger = logging.getLogger(__name__)
 
-from gently.core.coordinates import (
-    pixel_to_stage_position,
-    get_um_per_pixel,
-    DEFAULT_PIXEL_SIZE_UM,
+from gently.core.coordinates import (  # noqa: E402
     DEFAULT_OBJECTIVE_MAG,
+    DEFAULT_PIXEL_SIZE_UM,
+    get_um_per_pixel,
+    pixel_to_stage_position,
 )
 
 
@@ -42,11 +41,13 @@ class SAMEmbryoDetector:
     - Returns embryo positions as simple list of coordinates
     """
 
-    def __init__(self,
-                 sam_checkpoint: str = "sam_vit_b_01ec64.pth",
-                 sam_model_type: str = "vit_b",
-                 device: str = "cpu",
-                 anthropic_api_key: Optional[str] = None):
+    def __init__(
+        self,
+        sam_checkpoint: str = "sam_vit_b_01ec64.pth",
+        sam_model_type: str = "vit_b",
+        device: str = "cpu",
+        anthropic_api_key: str | None = None,
+    ):
         """
         Initialize SAM detector
 
@@ -85,7 +86,7 @@ def _load_sam(self):
         if self._mask_generator is not None:
             return
 
-        from segment_anything import sam_model_registry, SamAutomaticMaskGenerator, SamPredictor
+        from segment_anything import SamAutomaticMaskGenerator, SamPredictor, sam_model_registry
 
         if not Path(self.sam_checkpoint).exists():
             raise FileNotFoundError(f"SAM checkpoint not found: {self.sam_checkpoint}")
@@ -108,13 +109,15 @@ def _load_sam(self):
         self._predictor = SamPredictor(sam)
         logger.info("SAM model loaded")
 
-    def preprocess_image(self,
-                         image: np.ndarray,
-                         bg_kernel_size: int = 150,
-                         use_clahe: bool = True,
-                         clahe_clip_limit: float = 3.0,
-                         clahe_tile_size: int = 16,
-                         gaussian_sigma: float = 2.0) -> np.ndarray:
+    def preprocess_image(
+        self,
+        image: np.ndarray,
+        bg_kernel_size: int = 150,
+        use_clahe: bool = True,
+        clahe_clip_limit: float = 3.0,
+        clahe_tile_size: int = 16,
+        gaussian_sigma: float = 2.0,
+    ) -> np.ndarray:
         """
         Preprocess image for better SAM detection.
 
@@ -151,14 +154,18 @@ def preprocess_image(self,
         # This stretches the narrow range (e.g., 84-354) to full 0-255
         logger.debug("Percentile normalization (2-98%%)...")
         p2, p98 = np.percentile(image, (2, 98))
-        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(np.uint8)
+        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(
+            np.uint8
+        )
         logger.debug("Normalized to 0-255")
 
         # Step 2: Background subtraction with large morphological opening
         # Removes large-scale illumination variations
         if bg_kernel_size > 0:
             logger.debug("Background subtraction (kernel=%d)...", bg_kernel_size)
-            kernel_bg = cv2.getStructuringElement(cv2.MORPH_ELLIPSE, (bg_kernel_size, bg_kernel_size))
+            kernel_bg = cv2.getStructuringElement(
+                cv2.MORPH_ELLIPSE, (bg_kernel_size, bg_kernel_size)
+            )
             background = cv2.morphologyEx(img_norm, cv2.MORPH_OPEN, kernel_bg)
             img_no_bg = cv2.subtract(img_norm, background)
             img_no_bg = cv2.normalize(img_no_bg, None, 0, 255, cv2.NORM_MINMAX).astype(np.uint8)
@@ -171,8 +178,7 @@ def preprocess_image(self,
         if use_clahe:
             logger.debug("CLAHE (clip=%.1f, tile=%d)...", clahe_clip_limit, clahe_tile_size)
             clahe = cv2.createCLAHE(
-                clipLimit=clahe_clip_limit,
-                tileGridSize=(clahe_tile_size, clahe_tile_size)
+                clipLimit=clahe_clip_limit, tileGridSize=(clahe_tile_size, clahe_tile_size)
             )
             img_enhanced = clahe.apply(img_no_bg)
             logger.debug("CLAHE applied")
@@ -187,16 +193,20 @@ def preprocess_image(self,
         else:
             img_smooth = img_enhanced
 
-        logger.debug("Preprocessing complete (output range: %s - %s)", img_smooth.min(), img_smooth.max())
+        logger.debug(
+            "Preprocessing complete (output range: %s - %s)", img_smooth.min(), img_smooth.max()
+        )
         return img_smooth
 
-    def find_embryo_candidates(self,
-                               image: np.ndarray,
-                               brightness_percentile: float = 99.0,
-                               min_area: int = 5000,
-                               max_area: int = 150000,
-                               clahe_clip: float = 3.0,
-                               clahe_tile: int = 16) -> Tuple[List[Dict], np.ndarray]:
+    def find_embryo_candidates(
+        self,
+        image: np.ndarray,
+        brightness_percentile: float = 99.0,
+        min_area: int = 5000,
+        max_area: int = 150000,
+        clahe_clip: float = 3.0,
+        clahe_tile: int = 16,
+    ) -> tuple[list[dict], np.ndarray]:
         """
         Find embryo candidates using brightness-based detection.
 
@@ -229,12 +239,16 @@ def find_embryo_candidates(self,
         enhanced_image : np.ndarray
             Contrast-enhanced 8-bit image for SAM
         """
-        logger.info("Finding embryo candidates (brightness percentile=%.1f)...", brightness_percentile)
+        logger.info(
+            "Finding embryo candidates (brightness percentile=%.1f)...", brightness_percentile
+        )
         logger.debug("Input range: %s - %s", image.min(), image.max())
 
         # Step 1: Percentile normalization (handles low dynamic range)
         p2, p98 = np.percentile(image, (2, 98))
-        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(np.uint8)
+        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(
+            np.uint8
+        )
         logger.debug("Normalized to 0-255")
 
         # Step 2: CLAHE for local contrast enhancement
@@ -261,7 +275,9 @@ def find_embryo_candidates(self,
         logger.debug("Morphological cleanup complete")
 
         # Step 7: Find connected components and filter by area
-        num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(mask, connectivity=8)
+        num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(
+            mask, connectivity=8
+        )
 
         candidates = []
         for i in range(1, num_labels):  # Skip background (label 0)
@@ -273,19 +289,14 @@ def find_embryo_candidates(self,
                 h = stats[i, cv2.CC_STAT_HEIGHT]
                 cx, cy = centroids[i]
 
-                candidates.append({
-                    'bbox': (x, y, w, h),
-                    'centroid': (cx, cy),
-                    'area': area
-                })
+                candidates.append({"bbox": (x, y, w, h), "centroid": (cx, cy), "area": area})
 
         logger.info("Found %d embryo candidates", len(candidates))
         return candidates, img_smooth
 
-    def refine_with_sam(self,
-                        image: np.ndarray,
-                        candidates: List[Dict],
-                        padding: int = 20) -> List[Dict]:
+    def refine_with_sam(
+        self, image: np.ndarray, candidates: list[dict], padding: int = 20
+    ) -> list[dict]:
         """
         Refine embryo candidates using SAM with bounding box prompts.
 
@@ -322,7 +333,7 @@ def refine_with_sam(self,
         h, w = image.shape[:2]
 
         for i, candidate in enumerate(candidates):
-            x, y, bw, bh = candidate['bbox']
+            x, y, bw, bh = candidate["bbox"]
 
             # Add padding and clip to image bounds
             x1 = max(0, x - padding)
@@ -335,10 +346,7 @@ def refine_with_sam(self,
 
             # Get SAM prediction with box prompt
             masks, scores, _ = self._predictor.predict(
-                point_coords=None,
-                point_labels=None,
-                box=input_box,
-                multimask_output=True
+                point_coords=None, point_labels=None, box=input_box, multimask_output=True
             )
 
             # Take best mask (highest score)
@@ -348,9 +356,7 @@ def refine_with_sam(self,
 
             # Calculate properties from SAM mask
             contours, _ = cv2.findContours(
-                mask.astype(np.uint8),
-                cv2.RETR_EXTERNAL,
-                cv2.CHAIN_APPROX_SIMPLE
+                mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
             )
 
             if contours:
@@ -364,41 +370,47 @@ def refine_with_sam(self,
                     cx = M["m10"] / M["m00"]
                     cy = M["m01"] / M["m00"]
                 else:
-                    cx, cy = candidate['centroid']
+                    cx, cy = candidate["centroid"]
 
                 # Calculate circularity
                 perimeter = cv2.arcLength(contour, True)
-                circularity = 4 * np.pi * area / (perimeter ** 2) if perimeter > 0 else 0
+                circularity = 4 * np.pi * area / (perimeter**2) if perimeter > 0 else 0
 
                 # Get bounding box from contour
                 bx, by, bw, bh = cv2.boundingRect(contour)
 
-                embryos.append({
-                    'embryo_id': f'embryo_{i + 1}',
-                    'uid': str(uuid.uuid4()),  # Global unique identifier for cross-session tracking
-                    'pixel_x': float(cx),
-                    'pixel_y': float(cy),
-                    'bbox': (bx, by, bw, bh),  # Used by visualization functions
-                    'area_pixels': int(area),
-                    'circularity': float(circularity),
-                    'confidence': float(score),
-                    'mask': mask
-                })
+                embryos.append(
+                    {
+                        "embryo_id": f"embryo_{i + 1}",
+                        "uid": str(
+                            uuid.uuid4()
+                        ),  # Global unique identifier for cross-session tracking
+                        "pixel_x": float(cx),
+                        "pixel_y": float(cy),
+                        "bbox": (bx, by, bw, bh),  # Used by visualization functions
+                        "area_pixels": int(area),
+                        "circularity": float(circularity),
+                        "confidence": float(score),
+                        "mask": mask,
+                    }
+                )
 
         logger.info("SAM refined %d embryos", len(embryos))
         return embryos
 
-    async def detect_embryos(self,
-                            image: np.ndarray,
-                            stage_position: Tuple[float, float],
-                            pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
-                            objective_mag: float = DEFAULT_OBJECTIVE_MAG,
-                            use_claude_review: bool = True,
-                            save_visualizations: bool = True,
-                            output_dir: Optional[Path] = None,
-                            brightness_percentile: float = 99.0,
-                            min_area: int = 5000,
-                            max_area: int = 150000) -> Dict:
+    async def detect_embryos(
+        self,
+        image: np.ndarray,
+        stage_position: tuple[float, float],
+        pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
+        objective_mag: float = DEFAULT_OBJECTIVE_MAG,
+        use_claude_review: bool = True,
+        save_visualizations: bool = True,
+        output_dir: Path | None = None,
+        brightness_percentile: float = 99.0,
+        min_area: int = 5000,
+        max_area: int = 150000,
+    ) -> dict:
         """
         Detect embryos using brightness-based detection + SAM refinement.
 
@@ -462,20 +474,17 @@ async def detect_embryos(self,
         # Step 1: Find candidates using brightness detection
         logger.info("[1/4] Finding embryo candidates (brightness-based)...")
         candidates, image_enhanced = self.find_embryo_candidates(
-            image,
-            brightness_percentile=brightness_percentile,
-            min_area=min_area,
-            max_area=max_area
+            image, brightness_percentile=brightness_percentile, min_area=min_area, max_area=max_area
         )
 
         if len(candidates) == 0:
             logger.warning("No embryo candidates found!")
             return {
-                'embryos': [],
-                'initial_detections': 0,
-                'final_detections': 0,
-                'verification': {'verified': False},
-                'images': {}
+                "embryos": [],
+                "initial_detections": 0,
+                "final_detections": 0,
+                "verification": {"verified": False},
+                "images": {},
             }
 
         # Step 2: Refine with SAM
@@ -489,11 +498,11 @@ async def detect_embryos(self,
         if len(embryos_sam) == 0:
             logger.warning("No embryos detected by SAM!")
             return {
-                'embryos': [],
-                'initial_detections': 0,
-                'final_detections': 0,
-                'verification': {'verified': False},
-                'images': {}
+                "embryos": [],
+                "initial_detections": 0,
+                "final_detections": 0,
+                "verification": {"verified": False},
+                "images": {},
             }
 
         # Save initial detection
@@ -503,8 +512,8 @@ async def detect_embryos(self,
 
         # Claude review (if enabled)
         embryos_final = embryos_sam
-        verification = {'verified': True, 'skipped': not use_claude_review}
-        changes = {'round1': {'removed': [], 'added': []}}
+        verification = {"verified": True, "skipped": not use_claude_review}
+        changes = {"round1": {"removed": [], "added": []}}
 
         if use_claude_review and self.claude_client:
             logger.info("[2/4] Claude Vision review (Round 1)...")
@@ -512,7 +521,7 @@ async def detect_embryos(self,
             review_r1 = await self._review_with_claude(image_8bit, annotated, embryos_sam)
 
             logger.info("[3/4] Applying corrections...")
-            embryos_r1, changes['round1'] = self._apply_corrections(
+            embryos_r1, changes["round1"] = self._apply_corrections(
                 embryos_sam, review_r1, image, self._predictor
             )
 
@@ -524,22 +533,22 @@ async def detect_embryos(self,
             logger.info("[4/4] Claude verification (Round 2)...")
             r1_viz = self._create_annotated_image(image_8bit, embryos_r1)
             verification = await self._verify_with_claude(
-                image_8bit, r1_viz, embryos_r1, changes['round1']
+                image_8bit, r1_viz, embryos_r1, changes["round1"]
             )
 
             # Apply round 2 corrections if needed
             has_r2_changes = (
-                len(verification.get('additional_false_positives', [])) > 0 or
-                len(verification.get('additional_false_negatives', [])) > 0
+                len(verification.get("additional_false_positives", [])) > 0
+                or len(verification.get("additional_false_negatives", [])) > 0
             )
 
             if has_r2_changes:
                 logger.info("Applying Round 2 corrections...")
                 review_r2 = {
-                    'false_positives': verification.get('additional_false_positives', []),
-                    'false_negatives': verification.get('additional_false_negatives', [])
+                    "false_positives": verification.get("additional_false_positives", []),
+                    "false_negatives": verification.get("additional_false_negatives", []),
                 }
-                embryos_final, changes['round2'] = self._apply_corrections(
+                embryos_final, changes["round2"] = self._apply_corrections(
                     embryos_r1, review_r2, image, self._predictor
                 )
             else:
@@ -553,7 +562,7 @@ async def detect_embryos(self,
             stage_position,
             pixel_size_um,
             objective_mag,
-            image_shape=image.shape[:2]  # (height, width)
+            image_shape=image.shape[:2],  # (height, width)
         )
 
         # Save final visualization
@@ -563,19 +572,19 @@ async def detect_embryos(self,
 
         # Package results
         results = {
-            'embryos': embryo_positions,
-            'initial_detections': len(embryos_sam),
-            'final_detections': len(embryos_final),
-            'verification': verification,
-            'changes': changes,
-            'images': {
-                'initial': str(output_dir / "detection_initial.png"),
-                'final': str(output_dir / "detection_final.png")
-            }
+            "embryos": embryo_positions,
+            "initial_detections": len(embryos_sam),
+            "final_detections": len(embryos_final),
+            "verification": verification,
+            "changes": changes,
+            "images": {
+                "initial": str(output_dir / "detection_initial.png"),
+                "final": str(output_dir / "detection_final.png"),
+            },
         }
 
         if use_claude_review and save_visualizations:
-            results['images']['round1'] = str(output_dir / "detection_round1.png")
+            results["images"]["round1"] = str(output_dir / "detection_round1.png")
 
         logger.info("=" * 70)
         logger.info("DETECTION COMPLETE: %d embryos", len(embryo_positions))
@@ -594,7 +603,7 @@ def _to_rgb8(image: np.ndarray) -> np.ndarray:
             return cv2.cvtColor(image, cv2.COLOR_GRAY2RGB)
         return image
 
-    def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
+    def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
         """Run SAM automatic segmentation (extracted from test script)"""
         image_rgb = self._to_rgb8(image)
 
@@ -604,14 +613,16 @@ def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
         # Filter candidates
         embryo_candidates = []
         for mask_data in masks:
-            area = mask_data['area']
+            area = mask_data["area"]
 
             if not (self.min_area <= area <= self.max_area):
                 continue
 
-            bbox = mask_data['bbox']
-            mask = mask_data['segmentation']
-            contours, _ = cv2.findContours(mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
+            bbox = mask_data["bbox"]
+            mask = mask_data["segmentation"]
+            contours, _ = cv2.findContours(
+                mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
+            )
 
             if len(contours) == 0:
                 continue
@@ -620,40 +631,44 @@ def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
             if perimeter == 0:
                 continue
 
-            circularity = 4 * np.pi * area / (perimeter ** 2)
+            circularity = 4 * np.pi * area / (perimeter**2)
 
             if circularity < self.min_circularity:
                 continue
 
-            embryo_candidates.append({
-                'mask': mask,
-                'bbox': bbox,
-                'area': area,
-                'circularity': circularity,
-                'stability_score': mask_data['stability_score'],
-                'predicted_iou': mask_data['predicted_iou']
-            })
+            embryo_candidates.append(
+                {
+                    "mask": mask,
+                    "bbox": bbox,
+                    "area": area,
+                    "circularity": circularity,
+                    "stability_score": mask_data["stability_score"],
+                    "predicted_iou": mask_data["predicted_iou"],
+                }
+            )
 
         # Sort by quality and apply spatial separation
-        embryo_candidates.sort(key=lambda x: (x['area'] * x['stability_score']), reverse=True)
+        embryo_candidates.sort(key=lambda x: x["area"] * x["stability_score"], reverse=True)
 
         selected_embryos = []
         for candidate in embryo_candidates:
             if len(selected_embryos) >= self.max_embryos:
                 break
 
-            bbox = candidate['bbox']
+            bbox = candidate["bbox"]
             candidate_center_x = bbox[0] + bbox[2] / 2
             candidate_center_y = bbox[1] + bbox[3] / 2
 
             too_close = False
             for selected in selected_embryos:
-                sel_bbox = selected['bbox']
+                sel_bbox = selected["bbox"]
                 sel_center_x = sel_bbox[0] + sel_bbox[2] / 2
                 sel_center_y = sel_bbox[1] + sel_bbox[3] / 2
 
-                distance = np.sqrt((candidate_center_x - sel_center_x)**2 +
-                                 (candidate_center_y - sel_center_y)**2)
+                distance = np.sqrt(
+                    (candidate_center_x - sel_center_x) ** 2
+                    + (candidate_center_y - sel_center_y) ** 2
+                )
 
                 if distance < self.min_separation_pixels:
                     too_close = True
@@ -662,19 +677,27 @@ def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
             if not too_close:
                 selected_embryos.append(candidate)
 
-        return selected_embryos, image_8bit
+        return selected_embryos, image_rgb
 
-    def _create_annotated_image(self, image: np.ndarray, embryos: List[Dict]) -> np.ndarray:
+    def _create_annotated_image(self, image: np.ndarray, embryos: list[dict]) -> np.ndarray:
         """Create annotated image with numbered boxes"""
         viz = image.copy()
         if len(viz.shape) == 2:
             viz = cv2.cvtColor(viz, cv2.COLOR_GRAY2RGB)
 
-        colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255), (255, 255, 0),
-                  (255, 0, 255), (0, 255, 255), (128, 128, 0), (128, 0, 128)]
+        colors = [
+            (255, 0, 0),
+            (0, 255, 0),
+            (0, 0, 255),
+            (255, 255, 0),
+            (255, 0, 255),
+            (0, 255, 255),
+            (128, 128, 0),
+            (128, 0, 128),
+        ]
 
         for i, embryo in enumerate(embryos):
-            bbox = embryo['bbox']
+            bbox = embryo["bbox"]
             x, y, w, h = bbox
             color = colors[i % len(colors)]
 
@@ -713,7 +736,7 @@ def _encode_image_base64(self, image: np.ndarray) -> str:
             buffered = BytesIO()
             pil_image.save(buffered, format="JPEG", quality=quality, optimize=True)
             if buffered.tell() <= max_bytes:
-                return base64.b64encode(buffered.getvalue()).decode('utf-8')
+                return base64.b64encode(buffered.getvalue()).decode("utf-8")
             quality -= 5
 
         # Last resort
@@ -722,18 +745,21 @@ def _encode_image_base64(self, image: np.ndarray) -> str:
         pil_image = pil_image.resize(new_size, Image.Resampling.LANCZOS)
         buffered = BytesIO()
         pil_image.save(buffered, format="JPEG", quality=85, optimize=True)
-        return base64.b64encode(buffered.getvalue()).decode('utf-8')
+        return base64.b64encode(buffered.getvalue()).decode("utf-8")
 
-    async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, embryos: List[Dict]) -> Dict:
+    async def _review_with_claude(
+        self, image: np.ndarray, annotated: np.ndarray, embryos: list[dict]
+    ) -> dict:
         """Round 1: Claude reviews detections (from test script)"""
         if not self.claude_client:
-            return {'false_positives': [], 'false_negatives': []}
+            return {"false_positives": [], "false_negatives": []}
 
         image_base64 = self._encode_image_base64(annotated)
 
-        prompt = f"""You are a microscopy expert analyzing embryo detections from a bottom camera view.
+        prompt = f"""You are a microscopy expert analyzing embryo detections from a bottom
+camera view.
 
-CURRENT DETECTIONS: {len(embryos)} embryos labeled 0-{len(embryos)-1} with colored bounding boxes.
+CURRENT DETECTIONS: {len(embryos)} embryos labeled 0-{len(embryos) - 1} with colored bounding boxes.
 
 EMBRYO CHARACTERISTICS:
 - Small, BRIGHT white/light gray oval or rice grain shapes
@@ -764,13 +790,22 @@ async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, em
                 model=settings.models.perception,
                 max_tokens=8000,
                 thinking={"type": "enabled", "budget_tokens": 5000},
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_base64}},
-                        {"type": "text", "text": prompt}
-                    ]
-                }]
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/jpeg",
+                                    "data": image_base64,
+                                },
+                            },
+                            {"type": "text", "text": prompt},
+                        ],
+                    }
+                ],
             )
 
             response_text = next((b.text for b in message.content if b.type == "text"), "")
@@ -787,18 +822,19 @@ async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, em
 
         except Exception as e:
             logger.warning("Claude review failed: %s", e)
-            return {'false_positives': [], 'false_negatives': []}
+            return {"false_positives": [], "false_negatives": []}
 
-    async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
-                                  embryos: List[Dict], previous_changes: Dict) -> Dict:
+    async def _verify_with_claude(
+        self, image: np.ndarray, annotated: np.ndarray, embryos: list[dict], previous_changes: dict
+    ) -> dict:
         """Round 2: Claude verifies corrections (from test script)"""
         if not self.claude_client:
-            return {'verified': True, 'skipped': True}
+            return {"verified": True, "skipped": True}
 
         image_base64 = self._encode_image_base64(annotated)
 
-        removed = previous_changes.get('removed', [])
-        added = previous_changes.get('added', [])
+        removed = previous_changes.get("removed", [])
+        added = previous_changes.get("added", [])
 
         prompt = f"""VERIFICATION ROUND - You previously reviewed this image.
 
@@ -806,7 +842,7 @@ async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
 - Removed: {removed if removed else "none"}
 - Added: {added if added else "none"}
 
-CURRENT: {len(embryos)} detections (numbered 0-{len(embryos)-1})
+CURRENT: {len(embryos)} detections (numbered 0-{len(embryos) - 1})
 
 TASK: Verify corrections and catch any remaining issues.
 Only report CLEAR remaining problems.
@@ -824,13 +860,22 @@ async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
                 model=settings.models.perception,
                 max_tokens=6000,
                 thinking={"type": "enabled", "budget_tokens": 4000},
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_base64}},
-                        {"type": "text", "text": prompt}
-                    ]
-                }]
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/jpeg",
+                                    "data": image_base64,
+                                },
+                            },
+                            {"type": "text", "text": prompt},
+                        ],
+                    }
+                ],
             )
 
             response_text = next((b.text for b in message.content if b.type == "text"), "")
@@ -846,38 +891,41 @@ async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
 
         except Exception as e:
             logger.warning("Verification failed: %s", e)
-            return {'verified': False}
+            return {"verified": False}
 
-    def _apply_corrections(self, embryos: List[Dict], review: Dict,
-                          image: np.ndarray, predictor) -> Tuple[List[Dict], Dict]:
+    def _apply_corrections(
+        self, embryos: list[dict], review: dict, image: np.ndarray, predictor
+    ) -> tuple[list[dict], dict]:
         """Apply Claude's corrections (from test script)"""
         corrected = []
-        changes = {'removed': [], 'added': []}
+        changes = {"removed": [], "added": []}
 
         # Remove false positives
-        false_positives = set(review.get('false_positives', []))
+        false_positives = set(review.get("false_positives", []))
         if false_positives:
-            changes['removed'] = list(false_positives)
+            changes["removed"] = list(false_positives)
 
         for i, embryo in enumerate(embryos):
             if i not in false_positives:
                 corrected.append(embryo)
 
         # Add false negatives
-        false_negatives = review.get('false_negatives', [])
+        false_negatives = review.get("false_negatives", [])
         if false_negatives:
             for fn in false_negatives:
-                point = (fn['x'], fn['y'])
+                point = (fn["x"], fn["y"])
                 new_embryo = self._segment_with_sam(image, predictor, point)
 
-                if new_embryo and (self.min_area <= new_embryo['area'] <= self.max_area and
-                                   new_embryo['circularity'] >= self.min_circularity):
+                if new_embryo and (
+                    self.min_area <= new_embryo["area"] <= self.max_area
+                    and new_embryo["circularity"] >= self.min_circularity
+                ):
                     corrected.append(new_embryo)
-                    changes['added'].append(point)
+                    changes["added"].append(point)
 
         return corrected, changes
 
-    def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optional[Dict]:
+    def _segment_with_sam(self, image: np.ndarray, predictor, point: tuple) -> dict | None:
         """Use SAM predictor to segment region (from test script)"""
         image_rgb = self._to_rgb8(image)
         predictor.set_image(image_rgb)
@@ -886,9 +934,7 @@ def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optio
         point_labels = np.array([1])
 
         masks, scores, _ = predictor.predict(
-            point_coords=point_coords,
-            point_labels=point_labels,
-            multimask_output=True
+            point_coords=point_coords, point_labels=point_labels, multimask_output=True
         )
 
         best_idx = np.argmax(scores)
@@ -903,26 +949,33 @@ def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optio
         bbox = [x_min, y_min, x_max - x_min, y_max - y_min]
 
         area = mask.sum()
-        contours, _ = cv2.findContours(mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
+        contours, _ = cv2.findContours(
+            mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
+        )
 
         if len(contours) > 0:
             perimeter = cv2.arcLength(contours[0], True)
-            circularity = 4 * np.pi * area / (perimeter ** 2) if perimeter > 0 else 0
+            circularity = 4 * np.pi * area / (perimeter**2) if perimeter > 0 else 0
         else:
             circularity = 0
 
         return {
-            'mask': mask,
-            'bbox': bbox,
-            'area': int(area),
-            'circularity': float(circularity),
-            'stability_score': float(scores[best_idx]),
-            'predicted_iou': float(scores[best_idx])
+            "mask": mask,
+            "bbox": bbox,
+            "area": int(area),
+            "circularity": float(circularity),
+            "stability_score": float(scores[best_idx]),
+            "predicted_iou": float(scores[best_idx]),
         }
 
-    def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[float, float],
-                                    pixel_size_um: float, objective_mag: float,
-                                    image_shape: Tuple[int, int] = (2048, 2048)) -> List[Dict]:
+    def _pixel_to_stage_coordinates(
+        self,
+        embryos: list[dict],
+        stage_pos: tuple[float, float],
+        pixel_size_um: float,
+        objective_mag: float,
+        image_shape: tuple[int, int] = (2048, 2048),
+    ) -> list[dict]:
         """
         Convert pixel coordinates to stage coordinates.
 
@@ -938,7 +991,7 @@ def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[floa
 
         embryo_positions = []
         for i, embryo in enumerate(embryos):
-            bbox = embryo['bbox']
+            bbox = embryo["bbox"]
             x, y, w, h = bbox
 
             center_x_px = x + w / 2
@@ -953,24 +1006,26 @@ def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[floa
                 image_center_y=image_center_y,
                 stage_x=stage_x,
                 stage_y=stage_y,
-                um_per_pixel=effective_pixel_um
+                um_per_pixel=effective_pixel_um,
             )
 
-            embryo_positions.append({
-                'embryo_id': f'embryo_{i + 1}',
-                'pixel_x': float(center_x_px),
-                'pixel_y': float(center_y_px),
-                'stage_x_um': float(embryo_stage_x),
-                'stage_y_um': float(embryo_stage_y),
-                'bbox_pixel': tuple(bbox),
-                'area_pixels': embryo.get('area_pixels', embryo.get('area', 0)),
-                'circularity': embryo.get('circularity', 0),
-                'confidence': embryo.get('confidence', embryo.get('stability_score', 0))
-            })
+            embryo_positions.append(
+                {
+                    "embryo_id": f"embryo_{i + 1}",
+                    "pixel_x": float(center_x_px),
+                    "pixel_y": float(center_y_px),
+                    "stage_x_um": float(embryo_stage_x),
+                    "stage_y_um": float(embryo_stage_y),
+                    "bbox_pixel": tuple(bbox),
+                    "area_pixels": embryo.get("area_pixels", embryo.get("area", 0)),
+                    "circularity": embryo.get("circularity", 0),
+                    "confidence": embryo.get("confidence", embryo.get("stability_score", 0)),
+                }
+            )
 
         return embryo_positions
 
-    def show_in_napari(self, image: np.ndarray, embryos: List[Dict], block: bool = False):
+    def show_in_napari(self, image: np.ndarray, embryos: list[dict], block: bool = False):
         """Deprecated: napari display was retired in Phase 1.
 
         SAM detection results are now reviewed via the web map view —
diff --git a/gently/hardware/switchbot.py b/gently/hardware/switchbot.py
index 6a165054..a295a082 100644
--- a/gently/hardware/switchbot.py
+++ b/gently/hardware/switchbot.py
@@ -21,6 +21,7 @@
 
     python gently/hardware/switchbot.py EC:6F:04:06:5B:23 on off
 """
+
 from __future__ import annotations
 
 import asyncio
@@ -32,12 +33,12 @@
 logger = logging.getLogger(__name__)
 
 # SwitchBot Bot GATT. Note the UUID group is 9fb8 — the widely-copied 9fb9 is wrong.
-_CTRL_CHAR = "cba20002-224d-11e6-9fb8-0002a5d5c51b"    # write / write-without-response
+_CTRL_CHAR = "cba20002-224d-11e6-9fb8-0002a5d5c51b"  # write / write-without-response
 _NOTIFY_CHAR = "cba20003-224d-11e6-9fb8-0002a5d5c51b"  # notify (command response)
 
 _COMMANDS = {
-    "on":    bytes([0x57, 0x01, 0x01]),
-    "off":   bytes([0x57, 0x01, 0x02]),
+    "on": bytes([0x57, 0x01, 0x01]),
+    "off": bytes([0x57, 0x01, 0x02]),
     "press": bytes([0x57, 0x01, 0x00]),
 }
 # Dedicated status query: returns battery %, firmware version, mode flags.
@@ -115,15 +116,15 @@ def __init__(self, address: str, name: str = "switchbot", *, timeout: float = 20
         self.address = address
         self.name = name
         self.timeout = timeout
-        self.parent = None              # required for Bluesky bps.mv()
-        self._state = "unknown"         # last commanded on/off state
+        self.parent = None  # required for Bluesky bps.mv()
+        self._state = "unknown"  # last commanded on/off state
         # Status fields populated only by read_status(). Left as None until
         # first contact — action commands deliberately don't update these,
         # see note on _STATUS_BATTERY_IDX above.
         self._battery_pct: int | None = None
         self._firmware: int | None = None
         self._status_ts: float | None = None
-        self._lock = threading.Lock()   # serialize BLE access (one radio, one bot)
+        self._lock = threading.Lock()  # serialize BLE access (one radio, one bot)
 
     # -- Bluesky settable protocol -------------------------------------------
     def set(self, state: str):
@@ -139,9 +140,7 @@ def set(self, state: str):
         def worker():
             with self._lock:
                 try:
-                    data = asyncio.run(
-                        _send_command(self.address, _COMMANDS[state], self.timeout)
-                    )
+                    data = asyncio.run(_send_command(self.address, _COMMANDS[state], self.timeout))
                 except Exception as exc:
                     logger.warning("SwitchBot %s set(%s) failed: %s", self.name, state, exc)
                     status.set_exception(exc)
@@ -167,9 +166,7 @@ def read_status(self) -> dict:
         SwitchBotError on BLE / protocol failure.
         """
         with self._lock:
-            data = asyncio.run(
-                _send_command(self.address, _QUERY_STATUS, self.timeout)
-            )
+            data = asyncio.run(_send_command(self.address, _QUERY_STATUS, self.timeout))
         info = {
             "raw_hex": data.hex(),
             "battery_pct": data[_STATUS_BATTERY_IDX] if len(data) > _STATUS_BATTERY_IDX else None,
@@ -186,9 +183,7 @@ def read_status(self) -> dict:
     # -- Bluesky readable protocol -------------------------------------------
     def read(self):
         ts = time.time()
-        out = OrderedDict({
-            self.name: {"value": self._state, "timestamp": ts}
-        })
+        out = OrderedDict({self.name: {"value": self._state, "timestamp": ts}})
         if self._battery_pct is not None:
             out[f"{self.name}_battery_pct"] = {
                 "value": self._battery_pct,
@@ -202,11 +197,25 @@ def read(self):
         return out
 
     def describe(self):
-        return OrderedDict({
-            self.name: {"source": f"switchbot:{self.address}", "dtype": "string", "shape": []},
-            f"{self.name}_battery_pct": {"source": f"switchbot:{self.address}", "dtype": "integer", "shape": []},
-            f"{self.name}_firmware":    {"source": f"switchbot:{self.address}", "dtype": "integer", "shape": []},
-        })
+        return OrderedDict(
+            {
+                self.name: {
+                    "source": f"switchbot:{self.address}",
+                    "dtype": "string",
+                    "shape": [],
+                },
+                f"{self.name}_battery_pct": {
+                    "source": f"switchbot:{self.address}",
+                    "dtype": "integer",
+                    "shape": [],
+                },
+                f"{self.name}_firmware": {
+                    "source": f"switchbot:{self.address}",
+                    "dtype": "integer",
+                    "shape": [],
+                },
+            }
+        )
 
     def read_configuration(self):
         return OrderedDict()
diff --git a/gently/hardware/temperature.py b/gently/hardware/temperature.py
index 526d576d..dba8865b 100644
--- a/gently/hardware/temperature.py
+++ b/gently/hardware/temperature.py
@@ -24,6 +24,7 @@
 install them on the device-layer machine. Local logic can be exercised with the
 built-in mock backend: `python gently/hardware/temperature.py --mock 20`.
 """
+
 from __future__ import annotations
 
 import logging
@@ -43,12 +44,18 @@ def _make_backend(cfg: dict):
     if backend == "mock":
         return _MockBackend()
     if backend == "serial":
-        from acuitynano_precision_thermalizer_serial import AcuityNanoPrecisionThermalizerSerial
+        from acuitynano_precision_thermalizer_serial import (
+            AcuityNanoPrecisionThermalizerSerial,
+        )
+
         return AcuityNanoPrecisionThermalizerSerial(
             cfg["com_port"], baud_rate=cfg.get("baud_rate", 115200)
         )
     if backend == "mqtt":
-        from acuitynano_precision_thermalizer_api import AcuityNanoPrecisionThermalizerAPI
+        from acuitynano_precision_thermalizer_api import (
+            AcuityNanoPrecisionThermalizerAPI,
+        )
+
         # The vendor package ships with an embedded HiveMQ Cloud broker + creds,
         # so MQTT can run with no config. Pass only the keys actually provided,
         # to override those embedded defaults (and keep secrets in config, not code).
@@ -57,7 +64,7 @@ def _make_backend(cfg: dict):
     raise ValueError(f"unknown temperature backend {backend!r} (use 'serial', 'mqtt', or 'mock')")
 
 
-def create_temperature_controller(cfg: dict) -> "TemperatureController":
+def create_temperature_controller(cfg: dict) -> TemperatureController:
     """Factory used by the device layer: build transport + wrap as a device."""
     backend = _make_backend(cfg)
     if "feedback_peltier" in cfg and hasattr(backend, "set_feedback_sensor"):
@@ -87,8 +94,8 @@ def __init__(self, backend, name: str = "temperature", *, stabilize_timeout: flo
         self._dev = backend
         self.name = name
         self.stabilize_timeout = float(stabilize_timeout)
-        self.parent = None            # required for Bluesky bps.mv()
-        self._setpoint = None         # last commanded target
+        self.parent = None  # required for Bluesky bps.mv()
+        self._setpoint = None  # last commanded target
         self._lock = threading.Lock()
 
     # -- Bluesky settable protocol -------------------------------------------
@@ -105,7 +112,7 @@ def set(self, target_c):
         def worker():
             with self._lock:
                 try:
-                    self._dev.set_temperature(target)   # vendor also validates range
+                    self._dev.set_temperature(target)  # vendor also validates range
                     self._dev.enable_tec(True)
                     locked = self._dev.wait_for_target(timeout_seconds=self.stabilize_timeout)
                 except Exception as exc:
@@ -117,9 +124,12 @@ def worker():
                 logger.info("temperature %s locked at %.2f C", self.name, target)
                 status.set_finished()
             else:
-                status.set_exception(TimeoutError(
-                    f"{self.name} did not stabilize at {target} C within {self.stabilize_timeout}s"
-                ))
+                status.set_exception(
+                    TimeoutError(
+                        f"{self.name} did not stabilize at {target} C"
+                        f" within {self.stabilize_timeout}s"
+                    )
+                )
 
         threading.Thread(target=worker, name=f"{self.name}-set", daemon=True).start()
         return status
@@ -136,13 +146,20 @@ def setpoint(self, target_c):
     def read(self):
         now = time.time()
         data = OrderedDict()
-        data[self.name] = {"value": self._safe(self._dev.get_water_temp), "timestamp": now}
+        data[self.name] = {
+            "value": self._safe(self._dev.get_water_temp),
+            "timestamp": now,
+        }
         data[f"{self.name}_setpoint"] = {"value": self._setpoint, "timestamp": now}
         data[f"{self.name}_state"] = {
-            "value": self._safe(self._dev.get_system_state, default="unknown"), "timestamp": now
+            "value": self._safe(self._dev.get_system_state, default="unknown"),
+            "timestamp": now,
         }
         if self._has_peltier():
-            data[f"{self.name}_peltier"] = {"value": self._safe(self._dev.get_peltier_temp), "timestamp": now}
+            data[f"{self.name}_peltier"] = {
+                "value": self._safe(self._dev.get_peltier_temp),
+                "timestamp": now,
+            }
         return data
 
     def describe(self):
@@ -238,5 +255,7 @@ def close(self):
         print("[mock] read ->", {k: v["value"] for k, v in dev.read().items()})
         print("OK")
     else:
-        print("Real-hardware self-test needs the vendor SDK + a controller. "
-              "Run with --mock to exercise the device logic locally.")
+        print(
+            "Real-hardware self-test needs the vendor SDK + a controller. "
+            "Run with --mock to exercise the device logic locally."
+        )
diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index 812b9e15..400cfc60 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -8,12 +8,11 @@
 """
 
 import asyncio
-import json
 import logging
-import time
-from typing import Any, Callable, Coroutine, Dict, Optional
+from collections.abc import Callable, Coroutine
+from typing import Any
 
-from .commands import get_command_registry, CommandCategory
+from .commands import get_command_registry
 
 logger = logging.getLogger(__name__)
 
@@ -39,16 +38,17 @@ class AgentBridge:
 
     def __init__(self, agent):
         self.agent = agent
-        self._launch_info: Dict[str, Any] = {}
+        self._launch_info: dict[str, Any] = {}
         self._wizard = None  # StartupWizard, set by init_wizard()
-        self._active_remote: Optional[Dict[str, Any]] = None  # {"peer": PeerInfo, "campaign_id": str}
-        self._pending_import: Optional[Dict] = None  # For /import-embryos picker
+        self._active_remote: dict[str, Any] | None = None  # {"peer": PeerInfo, "campaign_id": str}
+        self._pending_import: dict | None = None  # For /import-embryos picker
         # Set by the web layer (register_display_broadcaster) so AGENT-INITIATED
         # turns (the wake-router) can stream to all chat clients + the transcript.
-        self._display_broadcaster: Optional[Callable] = None
+        self._display_broadcaster: Callable | None = None
 
-    def register_display_broadcaster(self, broadcast_fn, choice_factory=None,
-                                     choice_discard=None) -> None:
+    def register_display_broadcaster(
+        self, broadcast_fn, choice_factory=None, choice_discard=None
+    ) -> None:
         """Register the web layer's broadcast fn for autonomous (wake) turns.
 
         The wake-router has no per-connection send_fn, so to make autonomous
@@ -99,7 +99,7 @@ async def handle_choice_response(self, request_id: str, selected: str, send_fn)
             return True
         return False
 
-    def set_launch_info(self, info: Dict[str, Any]) -> None:
+    def set_launch_info(self, info: dict[str, Any]) -> None:
         """Store launch metadata to include in the connect message."""
         self._launch_info = info
 
@@ -122,13 +122,13 @@ def get_session_briefing(self) -> str:
         returns an empty string — the agent's first turn becomes the
         opener instead of static text.
         """
-        if not hasattr(self.agent, 'memory') or not self.agent.memory:
+        if not hasattr(self.agent, "memory") or not self.agent.memory:
             return ""
 
         memory = self.agent.memory
 
         # Restore active_plan_item_id from experiment state (session resume)
-        experiment = getattr(self.agent, 'experiment', None)
+        experiment = getattr(self.agent, "experiment", None)
         if experiment and experiment.active_plan_item_id:
             memory.active_plan_item_id = experiment.active_plan_item_id
         elif experiment:
@@ -140,13 +140,14 @@ def get_session_briefing(self) -> str:
                 logger.info(f"Auto-set active plan item: {active_id}")
 
                 # Link session to the campaign
-                cs = getattr(self.agent, 'context_store', None)
+                cs = getattr(self.agent, "context_store", None)
                 if cs and self.agent.session_id:
                     try:
                         item = cs.get_plan_item(active_id)
                         if item:
                             cs.link_session_campaign(
-                                self.agent.session_id, item.campaign_id,
+                                self.agent.session_id,
+                                item.campaign_id,
                             )
                     except Exception:
                         pass
@@ -156,7 +157,7 @@ def get_session_briefing(self) -> str:
 
         # Invalidate prompt cache so the system prompt picks up the
         # active plan item on the next message
-        prompts = getattr(self.agent, 'prompts', None)
+        prompts = getattr(self.agent, "prompts", None)
         if prompts and memory.active_plan_item_id:
             prompts.invalidate_context_cache()
 
@@ -172,9 +173,9 @@ def should_enter_resolution(self) -> bool:
         replaces the older O(memory-scan) ``resolve_plan_context()`` gate
         that was making the picker take seconds to appear at startup.
         """
-        if not hasattr(self.agent, 'memory') or not self.agent.memory:
+        if not hasattr(self.agent, "memory") or not self.agent.memory:
             return False
-        experiment = getattr(self.agent, 'experiment', None)
+        experiment = getattr(self.agent, "experiment", None)
         if experiment is None:
             return False
         if experiment.active_plan_item_id:
@@ -209,7 +210,7 @@ def _sort_key(t):
         candidates.sort(key=_sort_key)
         return candidates
 
-    def _candidate_to_option(self, item, spec, campaign) -> Dict:
+    def _candidate_to_option(self, item, spec, campaign) -> dict:
         """Turn a ``(item, spec, campaign)`` tuple into a picker option."""
         memory = getattr(self.agent, "memory", None)
         spec_summary = ""
@@ -219,10 +220,11 @@ def _candidate_to_option(self, item, spec, campaign) -> Dict:
             except Exception:
                 spec_summary = ""
 
-        meta: Dict[str, Any] = {}
+        meta: dict[str, Any] = {}
         if campaign is not None:
-            c_name = getattr(campaign, "shorthand", None) or (
-                (getattr(campaign, "description", "") or "")[:60]
+            c_name = (
+                getattr(campaign, "shorthand", None)
+                or ((getattr(campaign, "description", "") or "")[:60])
             )
             if c_name:
                 meta["campaign"] = c_name
@@ -236,8 +238,7 @@ def _candidate_to_option(self, item, spec, campaign) -> Dict:
                 order = getattr(item, "phase_order", 0) or 0
                 if total > 0:
                     meta["sequence"] = (
-                        f"{order} of {total} · {done} done"
-                        if order else f"{done}/{total} done"
+                        f"{order} of {total} · {done} done" if order else f"{done}/{total} done"
                     )
             except Exception:
                 pass
@@ -247,10 +248,15 @@ def _candidate_to_option(self, item, spec, campaign) -> Dict:
             meta["status"] = status_val
 
         if spec is not None:
-            spec_dict: Dict[str, Any] = {}
+            spec_dict: dict[str, Any] = {}
             for field in (
-                "strain", "temperature_c", "num_slices", "exposure_ms",
-                "interval_s", "stop_condition", "success_criteria",
+                "strain",
+                "temperature_c",
+                "num_slices",
+                "exposure_ms",
+                "interval_s",
+                "stop_condition",
+                "success_criteria",
             ):
                 val = getattr(spec, field, None)
                 if val is not None:
@@ -266,8 +272,10 @@ def _candidate_to_option(self, item, spec, campaign) -> Dict:
         }
 
     def _build_resolution_choice_payload(
-        self, candidates: list, full_list: bool = False,
-    ) -> Dict:
+        self,
+        candidates: list,
+        full_list: bool = False,
+    ) -> dict:
         """Build the ``choice_data`` payload for the resolution picker.
 
         Top 3 candidates by default; ``full_list=True`` shows up to 20
@@ -280,26 +288,33 @@ def _build_resolution_choice_payload(
 
         if not full_list and len(candidates) > show_n:
             remaining = len(candidates) - show_n
-            options.append({
-                "id": "show_all",
-                "label": f"See all imaging tasks ({remaining} more)…",
-                "description": "Browse the full unblocked list",
-            })
-
-        options.append({
-            "id": "standalone",
-            "label": "Standalone — just exploring",
-            "description": "No plan attached, default settings",
-        })
-        options.append({
-            "id": "plan_new",
-            "label": "Design a new plan",
-            "description": "Enter plan mode first",
-        })
+            options.append(
+                {
+                    "id": "show_all",
+                    "label": f"See all imaging tasks ({remaining} more)…",
+                    "description": "Browse the full unblocked list",
+                }
+            )
+
+        options.append(
+            {
+                "id": "standalone",
+                "label": "Standalone — just exploring",
+                "description": "No plan attached, default settings",
+            }
+        )
+        options.append(
+            {
+                "id": "plan_new",
+                "label": "Design a new plan",
+                "description": "Enter plan mode first",
+            }
+        )
 
         question = (
             f"All {len(candidates)} unblocked imaging tasks — pick one:"
-            if full_list else "What is this session for?"
+            if full_list
+            else "What is this session for?"
         )
 
         return {
@@ -312,8 +327,8 @@ def _build_resolution_choice_payload(
 
     async def bootstrap_resolution_picker(
         self,
-        send_fn: Callable[[Dict], Coroutine],
-        choice_future_factory: Callable[[Dict], "asyncio.Future[str]"],
+        send_fn: Callable[[dict], Coroutine],
+        choice_future_factory: Callable[[dict], "asyncio.Future[str]"],
     ) -> None:
         """Open the session with a deterministic resolution picker.
 
@@ -345,9 +360,7 @@ async def bootstrap_resolution_picker(
 
         # Kick off the slow candidate scan in the background. By the time
         # the user picks "Continue", this is almost always already done.
-        candidates_task = asyncio.create_task(
-            asyncio.to_thread(self._build_resolution_candidates)
-        )
+        candidates_task = asyncio.create_task(asyncio.to_thread(self._build_resolution_candidates))
 
         # --- Phase 1: fast top-level question -------------------------
         top_payload = {
@@ -374,11 +387,13 @@ async def bootstrap_resolution_picker(
         top_request_id = f"resolve_top_{_uuid.uuid4().hex[:8]}"
         top_payload["request_id"] = top_request_id
         top_future = choice_future_factory(top_payload)
-        await send_fn({
-            "type": "choice_request",
-            "choice_data": top_payload,
-            "request_id": top_request_id,
-        })
+        await send_fn(
+            {
+                "type": "choice_request",
+                "choice_data": top_payload,
+                "request_id": top_request_id,
+            }
+        )
 
         try:
             top_choice = await top_future
@@ -391,7 +406,9 @@ async def bootstrap_resolution_picker(
         if top_choice != "resume_plan":
             candidates_task.cancel()
             await self._dispatch_resolution_pick(
-                top_choice or "standalone", send_fn, choice_future_factory,
+                top_choice or "standalone",
+                send_fn,
+                choice_future_factory,
             )
             return
 
@@ -408,11 +425,13 @@ async def bootstrap_resolution_picker(
             if briefing:
                 await send_fn({"type": "stream_start"})
                 await send_fn({"type": "text", "text": briefing})
-                await send_fn({
-                    "type": "stream_end",
-                    "tokens": self._get_token_snapshot(),
-                    "mode": self.agent.mode,
-                })
+                await send_fn(
+                    {
+                        "type": "stream_end",
+                        "tokens": self._get_token_snapshot(),
+                        "mode": self.agent.mode,
+                    }
+                )
             else:
                 await self._emit_resolution_result(
                     send_fn,
@@ -424,7 +443,8 @@ async def bootstrap_resolution_picker(
         full_list = False
         while True:
             payload = self._build_resolution_choice_payload(
-                candidates, full_list=full_list,
+                candidates,
+                full_list=full_list,
             )
             # Re-label the question for the secondary picker so the user
             # knows they're now picking the specific plan item.
@@ -432,11 +452,13 @@ async def bootstrap_resolution_picker(
             request_id = f"resolve_pick_{_uuid.uuid4().hex[:8]}"
             payload["request_id"] = request_id
             future = choice_future_factory(payload)
-            await send_fn({
-                "type": "choice_request",
-                "choice_data": payload,
-                "request_id": request_id,
-            })
+            await send_fn(
+                {
+                    "type": "choice_request",
+                    "choice_data": payload,
+                    "request_id": request_id,
+                }
+            )
             try:
                 selected = await future
             except asyncio.CancelledError:
@@ -447,15 +469,17 @@ async def bootstrap_resolution_picker(
                 continue
 
             await self._dispatch_resolution_pick(
-                selected, send_fn, choice_future_factory,
+                selected,
+                send_fn,
+                choice_future_factory,
             )
             return
 
     async def _dispatch_resolution_pick(
         self,
         selected: str,
-        send_fn: Callable[[Dict], Coroutine],
-        choice_future_factory: Callable[[Dict], "asyncio.Future[str]"],
+        send_fn: Callable[[dict], Coroutine],
+        choice_future_factory: Callable[[dict], "asyncio.Future[str]"],
     ) -> None:
         """Apply the user's resolution pick.
 
@@ -498,7 +522,8 @@ async def _dispatch_resolution_pick(
                 logger.error(f"attach_session_to_plan failed: {e}", exc_info=True)
                 await self._emit_resolution_result(
                     send_fn,
-                    "Couldn't attach the session to that plan item. You can try again or pick standalone.",
+                    "Couldn't attach the session to that plan item."
+                    " You can try again or pick standalone.",
                 )
                 return
 
@@ -514,7 +539,9 @@ async def _dispatch_resolution_pick(
             spec_dict = self._get_active_plan_spec()
             closer = self._compose_attach_closer(spec_dict)
             await self._emit_resolution_result(
-                send_fn, closer, applied_spec=spec_dict,
+                send_fn,
+                closer,
+                applied_spec=spec_dict,
             )
             return
 
@@ -540,7 +567,8 @@ async def _dispatch_resolution_pick(
                 logger.error(f"enter_plan_mode failed: {e}", exc_info=True)
                 msg = "Plan mode active."
             await self._emit_resolution_result(
-                send_fn, msg or "Plan mode — what are we designing?",
+                send_fn,
+                msg or "Plan mode — what are we designing?",
             )
             return
 
@@ -552,14 +580,17 @@ async def _dispatch_resolution_pick(
         except Exception as e:
             logger.warning(f"enter_resolution_mode failed: {e}")
             await self._emit_resolution_result(
-                send_fn, "Couldn't enter resolution mode.",
+                send_fn,
+                "Couldn't enter resolution mode.",
             )
             return
         await self.stream_response(
-            selected or "(no input)", send_fn, choice_future_factory,
+            selected or "(no input)",
+            send_fn,
+            choice_future_factory,
         )
 
-    def _get_active_plan_spec(self) -> Optional[Dict]:
+    def _get_active_plan_spec(self) -> dict | None:
         """Return the ``active_plan_spec`` dict stashed on
         ``experiment.metadata`` by ``apply_plan_acquisition_spec``."""
         try:
@@ -568,35 +599,40 @@ def _get_active_plan_spec(self) -> Optional[Dict]:
         except Exception:
             return None
 
-    def _compose_attach_closer(self, spec_dict: Optional[Dict]) -> str:
+    def _compose_attach_closer(self, spec_dict: dict | None) -> str:
         """One-line conversational closer to follow attach + apply."""
         title = (spec_dict or {}).get("plan_item_title") or "this plan item"
         return f"Attached to **{title}**. Mark embryo positions when you're ready."
 
     async def _emit_resolution_result(
         self,
-        send_fn: Callable[[Dict], Coroutine],
+        send_fn: Callable[[dict], Coroutine],
         closer_text: str,
-        applied_spec: Optional[Dict] = None,
+        applied_spec: dict | None = None,
     ) -> None:
         """Emit a deterministic stream_start → text → stream_end pair,
         followed by an optional ``applied_spec`` panel message."""
         await send_fn({"type": "stream_start"})
         await send_fn({"type": "text", "text": closer_text})
-        await send_fn({
-            "type": "stream_end",
-            "tokens": self._get_token_snapshot(),
-            "mode": self.agent.mode,
-        })
+        await send_fn(
+            {
+                "type": "stream_end",
+                "tokens": self._get_token_snapshot(),
+                "mode": self.agent.mode,
+            }
+        )
         if applied_spec:
-            await send_fn({
-                "type": "applied_spec",
-                "spec": applied_spec,
-            })
+            await send_fn(
+                {
+                    "type": "applied_spec",
+                    "spec": applied_spec,
+                }
+            )
 
     def init_wizard(self, context_store, claude_client=None) -> None:
         """Create the startup wizard from a ContextStore."""
         from .memory.startup_wizard import StartupWizard
+
         self._context_store = context_store
         self._wizard = StartupWizard(
             context_store=context_store,
@@ -607,8 +643,8 @@ def init_wizard(self, context_store, claude_client=None) -> None:
     async def stream_response(
         self,
         message: str,
-        send_fn: Callable[[Dict], Coroutine],
-        choice_future_factory: Callable[[Dict], "asyncio.Future[str]"],
+        send_fn: Callable[[dict], Coroutine],
+        choice_future_factory: Callable[[dict], "asyncio.Future[str]"],
     ) -> None:
         """
         Stream an agent response over WebSocket.
@@ -636,11 +672,13 @@ async def stream_response(
                         chunk = await stream_iter.__anext__()
                 except StopAsyncIteration:
                     # Stream finished — send token usage summary + current mode
-                    await send_fn({
-                        "type": "stream_end",
-                        "tokens": self._get_token_snapshot(),
-                        "mode": self.agent.mode,
-                    })
+                    await send_fn(
+                        {
+                            "type": "stream_end",
+                            "tokens": self._get_token_snapshot(),
+                            "mode": self.agent.mode,
+                        }
+                    )
                     return
 
                 chunk_type = chunk.get("type")
@@ -679,8 +717,8 @@ async def stream_response(
     async def handle_command(
         self,
         command: str,
-        send_fn: Callable[[Dict], Coroutine],
-        choice_futures: Dict = None,
+        send_fn: Callable[[dict], Coroutine],
+        choice_futures: dict = None,
     ) -> None:
         """
         Execute a slash command and send the result.
@@ -699,69 +737,87 @@ async def handle_command(
         cmd = command.strip().lower()
         cmd_name = cmd.split()[0]
         cmd_def = registry.get(cmd_name)
-        logger.info("handle_command: %s (resolved: %s)", cmd_name, cmd_def.name if cmd_def else "NOT FOUND")
+        logger.info(
+            "handle_command: %s (resolved: %s)",
+            cmd_name,
+            cmd_def.name if cmd_def else "NOT FOUND",
+        )
 
         if not cmd_def:
-            await send_fn({
-                "type": "command_result",
-                "command": command,
-                "error": f"Unknown command: {cmd_name}",
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": command,
+                    "error": f"Unknown command: {cmd_name}",
+                }
+            )
             return
 
         if cmd in ("/quit", "/exit", "/q"):
-            await send_fn({
-                "type": "command_result",
-                "command": cmd,
-                "action": "quit",
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": cmd,
+                    "action": "quit",
+                }
+            )
             return
 
         if cmd == "/status":
             status = self._get_status_data()
-            await send_fn({
-                "type": "command_result",
-                "command": "/status",
-                "content": status,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/status",
+                    "content": status,
+                }
+            )
             return
 
         if cmd in ("/peers", "/mesh") or cmd.startswith("/peers ") or cmd.startswith("/mesh "):
             parts = command.strip().split()
             if len(parts) >= 3 and parts[2].lower() == "campaigns":
                 data = await self._get_peer_campaigns(parts[1])
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/peers",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/peers",
+                        "content": data,
+                    }
+                )
             else:
                 data = self._get_peers_data()
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/peers",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/peers",
+                        "content": data,
+                    }
+                )
             return
 
         if cmd == "/embryos" or cmd.startswith("/embryos "):
             parts = cmd.split(maxsplit=1)
             embryo_id = parts[1].strip() if len(parts) > 1 else None
             data = self._get_embryos_data(embryo_id)
-            await send_fn({
-                "type": "command_result",
-                "command": "/embryos",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/embryos",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/tokens":
             data = self._get_tokens_data()
-            await send_fn({
-                "type": "command_result",
-                "command": "/tokens",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/tokens",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/help" or cmd.startswith("/help "):
@@ -773,111 +829,137 @@ async def handle_command(
                     text = f"Unknown command: {help_cmd}"
             else:
                 text = registry.generate_help_markdown()
-            await send_fn({
-                "type": "command_result",
-                "command": "/help",
-                "content": {"text": text},
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/help",
+                    "content": {"text": text},
+                }
+            )
             return
 
         if cmd.startswith("/theme"):
             parts = cmd.split()
             if len(parts) > 1:
-                from gently.app.theme import set_theme, get_theme
+                from gently.app.theme import get_theme, set_theme
+
                 try:
                     set_theme(parts[1])
                     theme = get_theme()
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/theme",
-                        "content": {"theme": theme.name, "changed": True},
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/theme",
+                            "content": {"theme": theme.name, "changed": True},
+                        }
+                    )
                 except ValueError as e:
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/theme",
-                        "error": str(e),
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/theme",
+                            "error": str(e),
+                        }
+                    )
             else:
-                from gently.app.theme import list_themes, get_theme
+                from gently.app.theme import get_theme, list_themes
+
                 current = get_theme()
                 themes = {k: v.name for k, v in list_themes().items()}
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/theme",
-                    "content": {"themes": themes, "current": current.name},
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/theme",
+                        "content": {"themes": themes, "current": current.name},
+                    }
+                )
             return
 
         if cmd == "/sessions":
-            await send_fn({
-                "type": "command_result",
-                "command": "/sessions",
-                "content": {"sessions": self._get_sessions_list()},
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/sessions",
+                    "content": {"sessions": self._get_sessions_list()},
+                }
+            )
             return
 
         if cmd == "/timelapse" or cmd == "/timelapse watch":
             data = self._get_timelapse_data()
-            await send_fn({
-                "type": "command_result",
-                "command": "/timelapse",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/timelapse",
+                    "content": data,
+                }
+            )
             return
 
         if cmd.startswith("/timeline"):
             parts = command.strip().split()
             data = self._get_timeline_data(parts[1:] if len(parts) > 1 else [])
-            await send_fn({
-                "type": "command_result",
-                "command": "/timeline",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/timeline",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/detectors":
             data = self._get_detectors_data()
-            await send_fn({
-                "type": "command_result",
-                "command": "/detectors",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/detectors",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/history":
             data = self._get_history_data()
-            await send_fn({
-                "type": "command_result",
-                "command": "/history",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/history",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/save":
             success = self.agent.save_session()
             if success:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/save",
-                    "content": {"text": f"Session saved: {self.agent.session_id}"},
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/save",
+                        "content": {"text": f"Session saved: {self.agent.session_id}"},
+                    }
+                )
             else:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/save",
-                    "error": "Failed to save session",
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/save",
+                        "error": "Failed to save session",
+                    }
+                )
             return
 
         if cmd == "/reset-context":
             cs = self._require_context_store()
             if cs is None:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/reset-context",
-                    "error": "Context store not available",
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/reset-context",
+                        "error": "Context store not available",
+                    }
+                )
             else:
                 counts = cs.reset()
                 total = sum(counts.values())
@@ -886,25 +968,32 @@ async def handle_command(
                 self.init_wizard(cs, claude_client)
                 if total > 0:
                     details = ", ".join(f"{v} {k}" for k, v in counts.items())
-                    msg = f"Context cleared: {total} entries removed ({details}).\nRun /wizard to set up again."
+                    msg = (
+                        f"Context cleared: {total} entries removed ({details})."
+                        "\nRun /wizard to set up again."
+                    )
                 else:
                     msg = "Context already empty — nothing to clear."
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/reset-context",
-                    "content": {"text": msg},
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/reset-context",
+                        "content": {"text": msg},
+                    }
+                )
             return
 
         if cmd == "/wizard":
             # Handled by the WebSocket route (agent_ws.py), not the bridge.
             # If we reach here, it means the wizard loop called handle_command
             # — i.e. /wizard was typed while the wizard is already running.
-            await send_fn({
-                "type": "command_result",
-                "command": "/wizard",
-                "content": {"text": "The wizard is already running."},
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/wizard",
+                    "content": {"text": "The wizard is already running."},
+                }
+            )
             return
 
         if cmd == "/campaign" or cmd == "/campaigns" or cmd.startswith("/campaign "):
@@ -913,53 +1002,67 @@ async def handle_command(
 
             if subcmd == "share" and len(parts) >= 3:
                 data = self._share_campaign(parts[2])
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             elif subcmd == "unshare" and len(parts) >= 3:
                 data = self._unshare_campaign(parts[2])
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             elif subcmd == "delete" and len(parts) >= 3:
                 data = self._delete_campaign(parts[2])
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             elif subcmd == "rename" and len(parts) >= 4:
                 data = self._rename_campaign(parts[2], " ".join(parts[3:]))
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             elif subcmd == "pause" and len(parts) >= 3:
                 data = self._pause_campaign(parts[2])
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             elif subcmd == "resume" and len(parts) >= 3:
                 data = self._resume_campaign(parts[2])
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             else:
                 data = self._get_campaigns_data(command.strip())
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/campaign",
-                    "content": data,
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/campaign",
+                        "content": data,
+                    }
+                )
             return
 
         if cmd.startswith("/join-campaign"):
@@ -968,11 +1071,13 @@ async def handle_command(
                 data = await self._join_campaign(parts[1], parts[2])
             else:
                 data = {"text": "Usage: /join-campaign <hostname> <campaign_id>"}
-            await send_fn({
-                "type": "command_result",
-                "command": "/join-campaign",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/join-campaign",
+                    "content": data,
+                }
+            )
             return
 
         if cmd.startswith("/claim"):
@@ -981,11 +1086,13 @@ async def handle_command(
                 data = await self._claim_item(parts[1])
             else:
                 data = {"text": "Usage: /claim <item_id>"}
-            await send_fn({
-                "type": "command_result",
-                "command": "/claim",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/claim",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/pair" or cmd.startswith("/pair "):
@@ -1004,17 +1111,30 @@ async def handle_command(
             elif subcmd == "scopes":
                 extra_args = parts[3] if len(parts) > 3 else ""
                 data = self._pair_scopes(arg, extra_args)
-            elif subcmd and subcmd not in ("accept", "reject", "list", "unpair", "scopes"):
+            elif subcmd and subcmd not in (
+                "accept",
+                "reject",
+                "list",
+                "unpair",
+                "scopes",
+            ):
                 # Treat as hostname — initiate pairing
                 data = await self._pair_initiate(subcmd, send_fn)
             else:
-                data = {"text": "Usage: /pair <hostname> | accept | reject | list | unpair <id> | scopes [hostname] [scope_list]"}
+                data = {
+                    "text": (
+                        "Usage: /pair <hostname> | accept | reject | list"
+                        " | unpair <id> | scopes [hostname] [scope_list]"
+                    )
+                }
 
-            await send_fn({
-                "type": "command_result",
-                "command": "/pair",
-                "content": data,
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/pair",
+                    "content": data,
+                }
+            )
             return
 
         if cmd == "/plan" or cmd.startswith("/plan "):
@@ -1023,28 +1143,32 @@ async def handle_command(
 
             if subcmd == "exit":
                 msg = self.agent.exit_plan_mode()
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/plan",
-                    "content": {
-                        "text": msg,
-                        "mode": self.agent.mode,
-                    },
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/plan",
+                        "content": {
+                            "text": msg,
+                            "mode": self.agent.mode,
+                        },
+                    }
+                )
             elif subcmd == "status":
                 summary = self.agent._get_active_plan_summary()
                 if summary:
                     text = f"Mode: {self.agent.mode}\n\n{summary}"
                 else:
                     text = f"Mode: {self.agent.mode}\nNo active campaigns found."
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/plan",
-                    "content": {
-                        "text": text,
-                        "mode": self.agent.mode,
-                    },
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/plan",
+                        "content": {
+                            "text": text,
+                            "mode": self.agent.mode,
+                        },
+                    }
+                )
             else:
                 # Enter plan mode (or show status if already in it)
                 if self.agent.mode == "plan":
@@ -1053,32 +1177,38 @@ async def handle_command(
                     if summary:
                         text += f"\n\n{summary}"
                     text += "\n\nUse /plan exit to return to run mode."
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/plan",
-                        "content": {
-                            "text": text,
-                            "mode": "plan",
-                        },
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/plan",
+                            "content": {
+                                "text": text,
+                                "mode": "plan",
+                            },
+                        }
+                    )
                 else:
                     msg = self.agent.enter_plan_mode()
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/plan",
-                        "content": {
-                            "text": msg,
-                            "mode": "plan",
-                        },
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/plan",
+                            "content": {
+                                "text": msg,
+                                "mode": "plan",
+                            },
+                        }
+                    )
             return
 
         if cmd == "/clear":
-            await send_fn({
-                "type": "command_result",
-                "command": "/clear",
-                "action": "clear",
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/clear",
+                    "action": "clear",
+                }
+            )
             return
 
         if cmd.startswith("/resume"):
@@ -1089,39 +1219,48 @@ async def handle_command(
                 if success:
                     embryo_count = len(self.agent.experiment.embryos)
                     msg_count = len(self.agent.conversation_history)
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/resume",
-                        "content": {
-                            "text": f"Session resumed: {session_id}\n  {embryo_count} embryos, {msg_count} messages",
-                        },
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/resume",
+                            "content": {
+                                "text": (
+                                    f"Session resumed: {session_id}\n"
+                                    f"  {embryo_count} embryos, {msg_count} messages"
+                                ),
+                            },
+                        }
+                    )
                 else:
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/resume",
-                        "error": f"Session '{session_id}' not found",
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/resume",
+                            "error": f"Session '{session_id}' not found",
+                        }
+                    )
             else:
                 # No session ID — list available sessions for the user
                 sessions = self._get_sessions_list()
                 if sessions:
                     lines = ["Available sessions (use /resume <id>):"]
                     for s in sessions:
-                        lines.append(
-                            f"  {s['session_id']} — {s['embryo_count']} embryos"
-                        )
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/resume",
-                        "content": {"text": "\n".join(lines)},
-                    })
+                        lines.append(f"  {s['session_id']} — {s['embryo_count']} embryos")
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/resume",
+                            "content": {"text": "\n".join(lines)},
+                        }
+                    )
                 else:
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/resume",
-                        "content": {"text": "No saved sessions found."},
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/resume",
+                            "content": {"text": "No saved sessions found."},
+                        }
+                    )
             return
 
         if cmd.startswith("/import-embryos"):
@@ -1133,11 +1272,13 @@ async def handle_command(
                     sessions = self._get_sessions_list()
                     sessions_with = [s for s in sessions if s["embryo_count"] > 0]
                     if not sessions_with:
-                        await send_fn({
-                            "type": "command_result",
-                            "command": "/import-embryos",
-                            "error": "No sessions with embryos found.",
-                        })
+                        await send_fn(
+                            {
+                                "type": "command_result",
+                                "command": "/import-embryos",
+                                "error": "No sessions with embryos found.",
+                            }
+                        )
                         return
                     session_id = sessions_with[0]["session_id"]
                 else:
@@ -1150,6 +1291,7 @@ async def handle_command(
                 sessions_with = [s for s in sessions if s["embryo_count"] > 0]
                 if sessions_with:
                     import uuid as _uuid
+
                     request_id = f"import_embryos_{_uuid.uuid4().hex[:8]}"
                     options = []
                     for s in sessions_with[:10]:
@@ -1162,6 +1304,7 @@ async def handle_command(
                         if last_active:
                             try:
                                 from datetime import datetime
+
                                 dt = datetime.fromisoformat(last_active)
                                 time_str = dt.strftime("%b %d %H:%M")
                             except (ValueError, TypeError):
@@ -1172,21 +1315,25 @@ async def handle_command(
                         desc = f"Import embryos from session {sid}"
                         if name:
                             desc = name
-                        options.append({
-                            "id": sid,
-                            "label": label,
-                            "description": desc,
-                        })
-                    await send_fn({
-                        "type": "choice_request",
-                        "choice_data": {
-                            "_type": "single",
-                            "question": "Import embryos from which session?",
-                            "options": options,
-                            "allow_multiple": False,
-                        },
-                        "request_id": request_id,
-                    })
+                        options.append(
+                            {
+                                "id": sid,
+                                "label": label,
+                                "description": desc,
+                            }
+                        )
+                    await send_fn(
+                        {
+                            "type": "choice_request",
+                            "choice_data": {
+                                "_type": "single",
+                                "question": "Import embryos from which session?",
+                                "options": options,
+                                "allow_multiple": False,
+                            },
+                            "request_id": request_id,
+                        }
+                    )
                     # Register a callback so the choice response triggers the import.
                     # We can't await here (would deadlock the REPL loop), so we
                     # store state for _handle_import_choice to pick up.
@@ -1195,11 +1342,13 @@ async def handle_command(
                         "send_fn": send_fn,
                     }
                 else:
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/import-embryos",
-                        "content": {"text": "No sessions with embryos found."},
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/import-embryos",
+                            "content": {"text": "No sessions with embryos found."},
+                        }
+                    )
             return
 
         if cmd.startswith("/make-video"):
@@ -1222,33 +1371,43 @@ async def handle_command(
 
             session_id = self.agent.session_id
             if not session_id:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/make-video",
-                    "error": "No active session",
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/make-video",
+                        "error": "No active session",
+                    }
+                )
                 return
 
             try:
-                from gently.app.video_maker import discover_volumes, create_timelapse_video
+                from gently.app.video_maker import (
+                    create_timelapse_video,
+                    discover_volumes,
+                )
+
                 storage_path = self.agent.storage_path
                 session_images_dir = storage_path / "images" / session_id
 
                 if not session_images_dir.exists():
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/make-video",
-                        "error": f"No images found for session {session_id}",
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/make-video",
+                            "error": f"No images found for session {session_id}",
+                        }
+                    )
                     return
 
                 all_volumes = discover_volumes(session_images_dir, embryo_id)
                 if not all_volumes:
-                    await send_fn({
-                        "type": "command_result",
-                        "command": "/make-video",
-                        "content": {"text": "No timelapse volumes found."},
-                    })
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/make-video",
+                            "content": {"text": "No timelapse volumes found."},
+                        }
+                    )
                     return
 
                 lines = [f"Creating timelapse videos (fps={fps})..."]
@@ -1257,23 +1416,29 @@ async def handle_command(
                     create_timelapse_video(vol_paths, str(output_path), fps=fps)
                     lines.append(f"  {eid}: {len(vol_paths)} frames → {output_path.name}")
 
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/make-video",
-                    "content": {"text": "\n".join(lines)},
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/make-video",
+                        "content": {"text": "\n".join(lines)},
+                    }
+                )
             except ImportError:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/make-video",
-                    "error": "Video maker module not available.",
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/make-video",
+                        "error": "Video maker module not available.",
+                    }
+                )
             except Exception as e:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/make-video",
-                    "error": str(e),
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/make-video",
+                        "error": str(e),
+                    }
+                )
             return
 
         if cmd.startswith("/test-device") or cmd.startswith("/benchmark"):
@@ -1325,17 +1490,26 @@ async def _benchmark_progress(stage, current, total, timing):
                         text = "  ".join(parts)
                     else:
                         return
-                    await send_fn({
+                    await send_fn(
+                        {
+                            "type": "command_result",
+                            "command": "/test-device",
+                            "content": {"text": text},
+                        }
+                    )
+
+                await send_fn(
+                    {
                         "type": "command_result",
                         "command": "/test-device",
-                        "content": {"text": text},
-                    })
-
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/test-device",
-                    "content": {"text": f"Running device test ({n_volumes} volumes, {n_slices} slices, {n_warmup} warmup)..."},
-                })
+                        "content": {
+                            "text": (
+                                f"Running device test ({n_volumes} volumes,"
+                                f" {n_slices} slices, {n_warmup} warmup)..."
+                            )
+                        },
+                    }
+                )
                 results = await run_benchmark(
                     self.agent,
                     n_volumes=n_volumes,
@@ -1355,65 +1529,80 @@ async def _benchmark_progress(stage, current, total, timing):
                     f"  Throughput: {results.fps:.2f} vol/s",
                     "",
                     "  Stage          Mean      Std       Min       Max",
-                    f"  Acquisition  {acq['mean']:.3f}s  {acq['std']:.3f}s  {acq['min']:.3f}s  {acq['max']:.3f}s",
-                    f"  Storage      {stor['mean']:.3f}s  {stor['std']:.3f}s  {stor['min']:.3f}s  {stor['max']:.3f}s",
+                    f"  Acquisition  {acq['mean']:.3f}s  {acq['std']:.3f}s  "
+                    f"{acq['min']:.3f}s  {acq['max']:.3f}s",
+                    f"  Storage      {stor['mean']:.3f}s  {stor['std']:.3f}s  "
+                    f"{stor['min']:.3f}s  {stor['max']:.3f}s",
                 ]
-                if viz['mean'] > 0:
+                if viz["mean"] > 0:
                     lines.append(
-                        f"  Viz push     {viz['mean']:.3f}s  {viz['std']:.3f}s  {viz['min']:.3f}s  {viz['max']:.3f}s"
+                        f"  Viz push     {viz['mean']:.3f}s  {viz['std']:.3f}s  "
+                        f"{viz['min']:.3f}s  {viz['max']:.3f}s"
                     )
-                lines.extend([
-                    f"  Total        {total['mean']:.3f}s  {total['std']:.3f}s  {total['min']:.3f}s  {total['max']:.3f}s",
-                ])
+                lines.extend(
+                    [
+                        f"  Total        {total['mean']:.3f}s  {total['std']:.3f}s  "
+                        f"{total['min']:.3f}s  {total['max']:.3f}s",
+                    ]
+                )
                 if results.avg_file_size_mb > 0:
                     lines.append(f"  File size:   {results.avg_file_size_mb:.1f} MB avg")
                 if results.failed:
                     lines.append(f"  Failures:    {len(results.failed)}")
 
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/test-device",
-                    "content": {"text": "\n".join(lines)},
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/test-device",
+                        "content": {"text": "\n".join(lines)},
+                    }
+                )
             except ImportError as e:
                 logger.error("Benchmark import failed: %s", e, exc_info=True)
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/test-device",
-                    "error": f"Benchmark module not available: {e}",
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/test-device",
+                        "error": f"Benchmark module not available: {e}",
+                    }
+                )
             except Exception as e:
-                await send_fn({
-                    "type": "command_result",
-                    "command": "/test-device",
-                    "error": str(e),
-                })
+                await send_fn(
+                    {
+                        "type": "command_result",
+                        "command": "/test-device",
+                        "error": str(e),
+                    }
+                )
             return
 
         # Fallback for truly unimplemented commands
-        await send_fn({
-            "type": "command_result",
-            "command": cmd,
-            "content": {"text": f"Command `{cmd}` is not yet available in the TUI."},
-        })
+        await send_fn(
+            {
+                "type": "command_result",
+                "command": cmd,
+                "content": {"text": f"Command `{cmd}` is not yet available in the TUI."},
+            }
+        )
 
     def get_commands_json(self) -> list:
         """Serialize the command registry for the TUI client."""
         registry = get_command_registry()
         commands = []
         for cmd in registry.get_all():
-            commands.append({
-                "name": cmd.name,
-                "description": cmd.description,
-                "aliases": cmd.aliases,
-                "category": cmd.category.name,
-                "usage": cmd.usage_string(),
-                "arg_hint": cmd.arg_hint_string(),
-                "subcommands": [
-                    {"name": s.name, "description": s.description}
-                    for s in cmd.subcommands
-                ],
-            })
+            commands.append(
+                {
+                    "name": cmd.name,
+                    "description": cmd.description,
+                    "aliases": cmd.aliases,
+                    "category": cmd.category.name,
+                    "usage": cmd.usage_string(),
+                    "arg_hint": cmd.arg_hint_string(),
+                    "subcommands": [
+                        {"name": s.name, "description": s.description} for s in cmd.subcommands
+                    ],
+                }
+            )
         return commands
 
     def get_tools_json(self) -> list:
@@ -1425,6 +1614,7 @@ def get_tools_json(self) -> list:
         """
         try:
             from gently.harness.tools.registry import get_tool_registry
+
             registry = get_tool_registry()
         except Exception:
             return []
@@ -1432,15 +1622,18 @@ def get_tools_json(self) -> list:
         for t in registry.list_all():
             desc = (t.description or "").strip().split("\n", 1)[0][:200]
             category = getattr(t.category, "name", None) or str(t.category)
-            tools.append({
-                "name": t.name,
-                "description": desc,
-                "category": category,
-                "params": [
-                    {"name": p.name, "type": p.type, "required": bool(p.required)}
-                    for p in t.parameters if p.name != "context"
-                ],
-            })
+            tools.append(
+                {
+                    "name": t.name,
+                    "description": desc,
+                    "category": category,
+                    "params": [
+                        {"name": p.name, "type": p.type, "required": bool(p.required)}
+                        for p in t.parameters
+                        if p.name != "context"
+                    ],
+                }
+            )
         tools.sort(key=lambda x: x["name"])
         return tools
 
@@ -1479,11 +1672,13 @@ def _get_embryos_data(self, embryo_id: str = None) -> dict:
 
         embryos = []
         for eid, emb in exp.embryos.items():
-            embryos.append({
-                "id": eid,
-                "nickname": emb.nickname,
-                "user_label": emb.user_label,
-            })
+            embryos.append(
+                {
+                    "id": eid,
+                    "nickname": emb.nickname,
+                    "user_label": emb.user_label,
+                }
+            )
         return {"embryos": embryos}
 
     def _get_tokens_data(self) -> dict:
@@ -1506,6 +1701,7 @@ def _get_token_snapshot(self) -> dict:
     def get_connect_metadata(self) -> dict:
         """Metadata sent to the TUI on connect."""
         import gently
+
         exp = self.agent.experiment
         meta = {
             "session_id": self.agent.session_id,
@@ -1588,12 +1784,14 @@ def _get_sessions_list(self) -> list:
             for s in raw:
                 sid = s.get("session_id", "unknown")
                 embryos = self.agent.store.list_embryos(sid)
-                sessions.append({
-                    "session_id": sid,
-                    "name": s.get("name", ""),
-                    "embryo_count": len(embryos) if embryos else 0,
-                    "last_active": s.get("last_active", ""),
-                })
+                sessions.append(
+                    {
+                        "session_id": sid,
+                        "name": s.get("name", ""),
+                        "embryo_count": len(embryos) if embryos else 0,
+                        "last_active": s.get("last_active", ""),
+                    }
+                )
         return sessions
 
     async def _send_import_result(self, send_fn, result: dict, session_label: str):
@@ -1606,17 +1804,21 @@ async def _send_import_result(self, send_fn, result: dict, session_label: str):
                 lines.append(f"  {', '.join(imported)}")
             if skipped:
                 lines.append(f"  Skipped (exist): {', '.join(skipped)}")
-            await send_fn({
-                "type": "command_result",
-                "command": "/import-embryos",
-                "content": {"text": "\n".join(lines)},
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/import-embryos",
+                    "content": {"text": "\n".join(lines)},
+                }
+            )
         else:
-            await send_fn({
-                "type": "command_result",
-                "command": "/import-embryos",
-                "error": result.get("error", "Import failed"),
-            })
+            await send_fn(
+                {
+                    "type": "command_result",
+                    "command": "/import-embryos",
+                    "error": result.get("error", "Import failed"),
+                }
+            )
 
     def _get_timelapse_data(self) -> dict:
         """Build structured timelapse status."""
@@ -1718,7 +1920,9 @@ def _delete_campaign(self, campaign_id: str) -> dict:
         if counts["campaigns"] > 0:
             parts.append(f"{counts['campaigns']} campaign{'s' if counts['campaigns'] != 1 else ''}")
         if counts["plan_items"] > 0:
-            parts.append(f"{counts['plan_items']} plan item{'s' if counts['plan_items'] != 1 else ''}")
+            parts.append(
+                f"{counts['plan_items']} plan item{'s' if counts['plan_items'] != 1 else ''}"
+            )
         detail = f" ({', '.join(parts)})" if parts else ""
         return {"text": f"Deleted **{label}**{detail}."}
 
@@ -1773,6 +1977,7 @@ def _pause_campaign(self, campaign_ref: str) -> dict:
         if not campaign:
             return {"text": f"Campaign '{campaign_ref}' not found."}
         from .memory.model import Status
+
         cs.update_campaign_status(campaign.id, Status.PAUSED)
         label = campaign.shorthand or campaign.display_name
         return {"text": f"Campaign **{label}** paused."}
@@ -1786,6 +1991,7 @@ def _resume_campaign(self, campaign_ref: str) -> dict:
         if not campaign:
             return {"text": f"Campaign '{campaign_ref}' not found."}
         from .memory.model import Status
+
         cs.update_campaign_status(campaign.id, Status.ACTIVE)
         label = campaign.shorthand or campaign.display_name
         return {"text": f"Campaign **{label}** resumed."}
@@ -1839,6 +2045,7 @@ async def _join_campaign(self, hostname: str, campaign_ref: str) -> dict:
             return {"text": "Peer client not available."}
 
         import socket
+
         local_hostname = socket.gethostname()
 
         ok = await pc.join_campaign(peer, campaign_ref, mesh.instance_id, local_hostname)
@@ -1846,12 +2053,19 @@ async def _join_campaign(self, hostname: str, campaign_ref: str) -> dict:
             return {"text": f"Failed to join campaign '{campaign_ref}' on {hostname}."}
 
         self._active_remote = {"peer": peer, "campaign_id": campaign_ref}
-        return {"text": f"Joined campaign **{campaign_ref}** on **{hostname}**.\nUse `/claim <item_id>` to claim items."}
+        return {
+            "text": (
+                f"Joined campaign **{campaign_ref}** on **{hostname}**."
+                "\nUse `/claim <item_id>` to claim items."
+            )
+        }
 
     async def _claim_item(self, item_id: str) -> dict:
         """Claim a plan item from the active remote campaign."""
         if self._active_remote is None:
-            return {"text": "No active remote campaign. Use `/join-campaign <hostname> <id>` first."}
+            return {
+                "text": "No active remote campaign. Use `/join-campaign <hostname> <id>` first."
+            }
 
         mesh = self._require_mesh()
         if mesh is None:
@@ -1862,6 +2076,7 @@ async def _claim_item(self, item_id: str) -> dict:
             return {"text": "Peer client not available."}
 
         import socket
+
         local_hostname = socket.gethostname()
 
         peer = self._active_remote["peer"]
@@ -1869,9 +2084,17 @@ async def _claim_item(self, item_id: str) -> dict:
 
         ok = await pc.claim_item(peer, campaign_id, item_id, mesh.instance_id, local_hostname)
         if not ok:
-            return {"text": f"Failed to claim item `{item_id}` — it may already be claimed by another node."}
+            return {
+                "text": (
+                    f"Failed to claim item `{item_id}` — it may already be claimed by another node."
+                )
+            }
 
-        return {"text": f"Claimed item `{item_id}` from campaign **{campaign_id}** on **{peer.hostname}**."}
+        return {
+            "text": (
+                f"Claimed item `{item_id}` from campaign **{campaign_id}** on **{peer.hostname}**."
+            )
+        }
 
     # ------------------------------------------------------------------
     # /pair helpers
@@ -1898,7 +2121,10 @@ async def _pair_initiate(self, hostname: str, send_fn) -> dict:
             return {"text": "Peer client not available."}
 
         resp = await pc.send_pair_request(
-            peer, pm.instance_id, pm.hostname, nonce_local,
+            peer,
+            pm.instance_id,
+            pm.hostname,
+            nonce_local,
             cert_fingerprint=pm.cert_fingerprint,
             udp_sign_key=pm.udp_sign_key,
         )
@@ -1919,7 +2145,11 @@ async def _pair_initiate(self, hostname: str, send_fn) -> dict:
 
         # Create local session and compute PIN
         session = pm.process_initiation_response(
-            peer_id, peer_host, nonce_local, nonce_remote, pairing_id,
+            peer_id,
+            peer_host,
+            nonce_local,
+            nonce_remote,
+            pairing_id,
         )
         # Store remote peer's TLS cert fingerprint and UDP signing key
         session.responder_cert_fingerprint = remote_cert_fp
@@ -1931,9 +2161,14 @@ async def _pair_initiate(self, hostname: str, send_fn) -> dict:
         await pc.confirm_pair_remote(peer, pairing_id, pm.instance_id)
 
         # Start background polling for confirmation
-        asyncio.create_task(self._pair_poll(
-            mesh, peer, pairing_id, send_fn,
-        ))
+        asyncio.create_task(
+            self._pair_poll(
+                mesh,
+                peer,
+                pairing_id,
+                send_fn,
+            )
+        )
 
         return {
             "text": (
@@ -1961,15 +2196,24 @@ async def _pair_accept(self, send_fn) -> dict:
             mesh.mark_peer_trusted(session.initiator_id)
 
             from gently.core.event_bus import EventType, get_event_bus
+
             get_event_bus().publish(
                 EventType.MESH_PAIRING_COMPLETED,
-                {"pairing_id": session.pairing_id, "peer_hostname": session.initiator_hostname},
+                {
+                    "pairing_id": session.pairing_id,
+                    "peer_hostname": session.initiator_hostname,
+                },
                 source="mesh",
             )
 
             return {"text": f"Paired with **{session.initiator_hostname}**!"}
 
-        return {"text": f"Confirmed pairing with **{session.initiator_hostname}**. Waiting for their confirmation..."}
+        return {
+            "text": (
+                f"Confirmed pairing with **{session.initiator_hostname}**."
+                " Waiting for their confirmation..."
+            )
+        }
 
     async def _pair_reject(self) -> dict:
         """Reject the most recent pending pairing request."""
@@ -2026,6 +2270,7 @@ def _pair_scopes(self, hostname: str, scope_arg: str) -> dict:
                 scope_str = ", ".join(tp.scopes) if tp.scopes else "none"
                 lines.append(f"  **{tp.hostname}** ({tp.instance_id[:8]}): {scope_str}")
             from gently.mesh.pairing import ALL_SCOPES
+
             lines.append("")
             lines.append(f"Available scopes: {', '.join(ALL_SCOPES)}")
             return {"text": "\n".join(lines)}
@@ -2042,9 +2287,12 @@ def _pair_scopes(self, hostname: str, scope_arg: str) -> dict:
         # Set scopes
         new_scopes = [s.strip() for s in scope_arg.split(",") if s.strip()]
         from gently.mesh.pairing import ALL_SCOPES
+
         invalid = [s for s in new_scopes if s not in ALL_SCOPES]
         if invalid:
-            return {"text": f"Invalid scopes: {', '.join(invalid)}. Available: {', '.join(ALL_SCOPES)}"}
+            return {
+                "text": f"Invalid scopes: {', '.join(invalid)}. Available: {', '.join(ALL_SCOPES)}"
+            }
 
         if pm.set_scopes(hostname, new_scopes):
             return {"text": f"Scopes for **{hostname}** updated to: {', '.join(new_scopes)}"}
@@ -2063,12 +2311,18 @@ def _pair_unpair(self, identifier: str) -> dict:
 
         # Mark the peer as untrusted in the mesh
         for peer in mesh.get_all_peers():
-            if (peer.hostname.lower() == identifier.lower()
-                    or peer.instance_id.startswith(identifier)):
+            if peer.hostname.lower() == identifier.lower() or peer.instance_id.startswith(
+                identifier
+            ):
                 peer.is_trusted = False
                 break
 
-        return {"text": f"Unpaired from **{identifier}**. They will need to re-pair to access mesh services."}
+        return {
+            "text": (
+                f"Unpaired from **{identifier}**."
+                " They will need to re-pair to access mesh services."
+            )
+        }
 
     async def _pair_poll(self, mesh, peer, pairing_id, send_fn):
         """Background poll: wait for remote to confirm pairing."""
@@ -2094,35 +2348,42 @@ async def _pair_poll(self, mesh, peer, pairing_id, send_fn):
                 mesh.mark_peer_trusted(peer.instance_id)
 
                 from gently.core.event_bus import EventType, get_event_bus
+
                 get_event_bus().publish(
                     EventType.MESH_PAIRING_COMPLETED,
                     {"pairing_id": pairing_id, "peer_hostname": peer.hostname},
                     source="mesh",
                 )
 
-                await send_fn({
-                    "type": "notification",
-                    "level": "success",
-                    "title": f"Paired with {peer.hostname}",
-                })
+                await send_fn(
+                    {
+                        "type": "notification",
+                        "level": "success",
+                        "title": f"Paired with {peer.hostname}",
+                    }
+                )
                 return
 
             if status in ("rejected", "expired"):
-                await send_fn({
-                    "type": "notification",
-                    "level": "warning",
-                    "title": f"Pairing {status}",
-                    "body": peer.hostname,
-                })
+                await send_fn(
+                    {
+                        "type": "notification",
+                        "level": "warning",
+                        "title": f"Pairing {status}",
+                        "body": peer.hostname,
+                    }
+                )
                 return
 
         # Timeout
-        await send_fn({
-            "type": "notification",
-            "level": "warning",
-            "title": f"Pairing timed out",
-            "body": peer.hostname,
-        })
+        await send_fn(
+            {
+                "type": "notification",
+                "level": "warning",
+                "title": "Pairing timed out",
+                "body": peer.hostname,
+            }
+        )
 
     def _get_campaigns_data(self, command: str) -> dict:
         """Build structured campaign/plan data."""
@@ -2167,7 +2428,9 @@ def _render_campaign_list(self, cs) -> dict:
 
             lines.append("")
 
-        lines.append(f"Use `/campaign <id>` for details, or browse at the viz server /campaigns page.")
+        lines.append(
+            "Use `/campaign <id>` for details, or browse at the viz server /campaigns page."
+        )
         return {"text": "\n".join(lines)}
 
     def _render_campaign_detail(self, cs, campaign_id: str) -> dict:
@@ -2201,7 +2464,10 @@ def _render_campaign_detail(self, cs, campaign_id: str) -> dict:
             lines.append(f"Target: {campaign.target}")
         if campaign.progress:
             lines.append(f"Progress: {campaign.progress}")
-        lines.append(f"Status: {campaign.status.value} · {completed}/{total} complete · {in_progress} in progress")
+        lines.append(
+            f"Status: {campaign.status.value} · {completed}/{total} complete"
+            f" · {in_progress} in progress"
+        )
         lines.append("")
 
         TYPE_ICONS = {
diff --git a/gently/harness/commands.py b/gently/harness/commands.py
index 7002f2f9..a3fed77b 100644
--- a/gently/harness/commands.py
+++ b/gently/harness/commands.py
@@ -10,37 +10,39 @@
 
 from dataclasses import dataclass, field
 from enum import Enum, auto
-from typing import Callable, Dict, List, Optional
 
 
 class CommandCategory(Enum):
     """Categories for organizing commands in help and welcome"""
-    NAVIGATION = auto()    # /quit, /clear, /help
-    INSPECTION = auto()    # /status, /detectors, /embryos, /timelapse, /timeline
-    SESSION = auto()       # /sessions, /resume, /save, /import-embryos
-    PLANNING = auto()      # /plan
-    APPEARANCE = auto()    # /theme, /history, /tokens
-    DIAGNOSTICS = auto()   # /test-device
+
+    NAVIGATION = auto()  # /quit, /clear, /help
+    INSPECTION = auto()  # /status, /detectors, /embryos, /timelapse, /timeline
+    SESSION = auto()  # /sessions, /resume, /save, /import-embryos
+    PLANNING = auto()  # /plan
+    APPEARANCE = auto()  # /theme, /history, /tokens
+    DIAGNOSTICS = auto()  # /test-device
 
 
 @dataclass
 class CommandOption:
     """Definition of a command option/flag"""
-    name: str                                    # e.g., "--filter"
+
+    name: str  # e.g., "--filter"
     description: str = ""
-    short: Optional[str] = None                  # e.g., "-f"
-    takes_value: bool = False                    # True if option requires a value
-    value_choices: List[str] = field(default_factory=list)  # Possible values
-    value_hint: str = ""                         # e.g., "TYPE" for "--filter TYPE"
-    is_flag: bool = False                        # True for boolean flags (no value)
+    short: str | None = None  # e.g., "-f"
+    takes_value: bool = False  # True if option requires a value
+    value_choices: list[str] = field(default_factory=list)  # Possible values
+    value_hint: str = ""  # e.g., "TYPE" for "--filter TYPE"
+    is_flag: bool = False  # True for boolean flags (no value)
 
 
 @dataclass
 class SubCommand:
     """Definition of a sub-command"""
-    name: str                                    # e.g., "watch", "clear"
+
+    name: str  # e.g., "watch", "clear"
     description: str = ""
-    options: List[CommandOption] = field(default_factory=list)
+    options: list[CommandOption] = field(default_factory=list)
 
 
 @dataclass
@@ -53,21 +55,22 @@ class CommandDefinition:
     - Help text generation
     - Welcome message generation
     """
-    name: str                                    # e.g., "/timelapse" (with leading slash)
-    description: str                             # Short description for autocomplete
-    help_text: str = ""                          # Detailed help (multi-line OK)
-    aliases: List[str] = field(default_factory=list)  # e.g., ["/q", "/exit"]
+
+    name: str  # e.g., "/timelapse" (with leading slash)
+    description: str  # Short description for autocomplete
+    help_text: str = ""  # Detailed help (multi-line OK)
+    aliases: list[str] = field(default_factory=list)  # e.g., ["/q", "/exit"]
     category: CommandCategory = CommandCategory.NAVIGATION
 
     # Positional argument
-    positional_arg: Optional[str] = None         # e.g., "embryo_id"
-    positional_hint: str = ""                    # e.g., "ID or 'last'"
+    positional_arg: str | None = None  # e.g., "embryo_id"
+    positional_hint: str = ""  # e.g., "ID or 'last'"
 
     # Sub-commands (e.g., /timelapse watch)
-    subcommands: List[SubCommand] = field(default_factory=list)
+    subcommands: list[SubCommand] = field(default_factory=list)
 
     # Options/flags (e.g., /timeline --filter)
-    options: List[CommandOption] = field(default_factory=list)
+    options: list[CommandOption] = field(default_factory=list)
 
     def usage_string(self) -> str:
         """Generate usage string like '/timeline [clear] [--filter TYPE]'"""
@@ -125,8 +128,8 @@ class CommandRegistry:
     """
 
     def __init__(self):
-        self._commands: Dict[str, CommandDefinition] = {}
-        self._aliases: Dict[str, str] = {}  # alias -> canonical name
+        self._commands: dict[str, CommandDefinition] = {}
+        self._aliases: dict[str, str] = {}  # alias -> canonical name
 
     def register(self, command: CommandDefinition) -> None:
         """Register a command definition"""
@@ -134,21 +137,21 @@ def register(self, command: CommandDefinition) -> None:
         for alias in command.aliases:
             self._aliases[alias] = command.name
 
-    def get(self, name: str) -> Optional[CommandDefinition]:
+    def get(self, name: str) -> CommandDefinition | None:
         """Get command by name or alias"""
         name = name.lower()
         canonical = self._aliases.get(name, name)
         return self._commands.get(canonical)
 
-    def get_all(self) -> List[CommandDefinition]:
+    def get_all(self) -> list[CommandDefinition]:
         """Get all registered commands"""
         return list(self._commands.values())
 
-    def get_by_category(self, category: CommandCategory) -> List[CommandDefinition]:
+    def get_by_category(self, category: CommandCategory) -> list[CommandDefinition]:
         """Get commands in a category"""
         return [c for c in self._commands.values() if c.category == category]
 
-    def get_all_names_and_aliases(self) -> List[str]:
+    def get_all_names_and_aliases(self) -> list[str]:
         """Get all command names and aliases for autocomplete"""
         names = list(self._commands.keys())
         names.extend(self._aliases.keys())
@@ -161,10 +164,10 @@ def generate_help_markdown(self) -> str:
             "",
             "## Natural Language",
             "Just type what you want! Examples:",
-            "- \"What detectors do we have?\"",
-            "- \"Add a detector for comma stage\"",
-            "- \"Test hatching detector on embryo 1\"",
-            "- \"Start imaging all embryos\"",
+            '- "What detectors do we have?"',
+            '- "Add a detector for comma stage"',
+            '- "Test hatching detector on embryo 1"',
+            '- "Start imaging all embryos"',
             "",
             "## Slash Commands",
             "",
@@ -215,18 +218,20 @@ def generate_help_markdown(self) -> str:
             lines.append("")
 
         # Keyboard shortcuts
-        lines.extend([
-            "## Keyboard Shortcuts",
-            "- `Tab` - Autocomplete commands/options",
-            "- `Right Arrow` - Accept shadow suggestion",
-            "- `Ctrl+C` - Exit",
-            "- `Ctrl+L` - Clear screen",
-            "- `Ctrl+R` - Reverse search history",
-        ])
+        lines.extend(
+            [
+                "## Keyboard Shortcuts",
+                "- `Tab` - Autocomplete commands/options",
+                "- `Right Arrow` - Accept shadow suggestion",
+                "- `Ctrl+C` - Exit",
+                "- `Ctrl+L` - Clear screen",
+                "- `Ctrl+R` - Reverse search history",
+            ]
+        )
 
         return "\n".join(lines)
 
-    def generate_command_help(self, name: str) -> Optional[str]:
+    def generate_command_help(self, name: str) -> str | None:
         """Generate detailed help for a specific command"""
         cmd = self.get(name)
         if not cmd:
@@ -278,228 +283,285 @@ def generate_command_help(self, name: str) -> Optional[str]:
 # Default Commands Registration
 # ============================================================================
 
+
 def _register_default_commands(registry: CommandRegistry) -> None:
     """Register all built-in commands"""
 
     # === Navigation Commands ===
-    registry.register(CommandDefinition(
-        name="/quit",
-        description="Exit the agent",
-        help_text="Exit the interactive agent session.",
-        aliases=["/exit", "/q"],
-        category=CommandCategory.NAVIGATION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/clear",
-        description="Clear screen",
-        help_text="Clear the terminal screen and show welcome banner.",
-        category=CommandCategory.NAVIGATION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/help",
-        description="Show help",
-        help_text="Show help for all commands or a specific command.\n\nUsage:\n- `/help` - Show all commands\n- `/help timeline` - Show detailed help for /timeline",
-        positional_arg="command",
-        positional_hint="command",
-        category=CommandCategory.NAVIGATION,
-    ))
-
-    # === Inspection Commands ===
-    registry.register(CommandDefinition(
-        name="/status",
-        description="Show experiment status",
-        help_text="Display current experiment status including microscope connection, active embryos, and detector status.",
-        category=CommandCategory.INSPECTION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/detectors",
-        description="List all detectors",
-        help_text="Show a table of all registered detectors with their status, type, and configuration.",
-        category=CommandCategory.INSPECTION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/embryos",
-        description="List embryos or show details",
-        help_text="List all embryos in the current experiment. Provide an embryo ID to see detailed information about a specific embryo.",
-        positional_arg="embryo_id",
-        positional_hint="ID",
-        category=CommandCategory.INSPECTION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/timelapse",
-        description="Timelapse status [watch]",
-        help_text="Display timelapse acquisition status for all embryos.\n\nUse 'watch' for live updating countdown view that refreshes every second.",
-        subcommands=[
-            SubCommand(
-                name="watch",
-                description="Live countdown mode (Ctrl+C to exit)",
+    registry.register(
+        CommandDefinition(
+            name="/quit",
+            description="Exit the agent",
+            help_text="Exit the interactive agent session.",
+            aliases=["/exit", "/q"],
+            category=CommandCategory.NAVIGATION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/clear",
+            description="Clear screen",
+            help_text="Clear the terminal screen and show welcome banner.",
+            category=CommandCategory.NAVIGATION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/help",
+            description="Show help",
+            help_text=(
+                "Show help for all commands or a specific command.\n\nUsage:\n"
+                "- `/help` - Show all commands\n"
+                "- `/help timeline` - Show detailed help for /timeline"
             ),
-        ],
-        category=CommandCategory.INSPECTION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/timeline",
-        description="Event timeline [--filter, clear]",
-        help_text="""Display timeline of timelapse and detection events.
+            positional_arg="command",
+            positional_hint="command",
+            category=CommandCategory.NAVIGATION,
+        )
+    )
 
-Shows events from the current session by default. Use --all to see events from all sessions.""",
-        subcommands=[
-            SubCommand(
-                name="clear",
-                description="Clear timeline history",
-                options=[
-                    CommandOption(
-                        name="--before",
-                        description="Clear events before time",
-                        takes_value=True,
-                        value_hint="TIME",
-                    ),
-                ],
-            ),
-        ],
-        options=[
-            CommandOption(
-                name="--filter",
-                description="Filter by event type",
-                takes_value=True,
-                value_choices=["timelapse", "detection"],
-                value_hint="TYPE",
-            ),
-            CommandOption(
-                name="--embryo",
-                description="Filter by embryo ID",
-                takes_value=True,
-                value_hint="ID",
-            ),
-            CommandOption(
-                name="--since",
-                description="Show events from time period",
-                takes_value=True,
-                value_hint="TIME",
-            ),
-            CommandOption(
-                name="--all",
-                description="Show events from all sessions",
-                is_flag=True,
-            ),
-            CommandOption(
-                name="--letters",
-                description="Lettered markers with legend (default)",
-                is_flag=True,
+    # === Inspection Commands ===
+    registry.register(
+        CommandDefinition(
+            name="/status",
+            description="Show experiment status",
+            help_text=(
+                "Display current experiment status including microscope connection,"
+                " active embryos, and detector status."
             ),
-            CommandOption(
-                name="--log",
-                description="Git-log style vertical timeline",
-                is_flag=True,
+            category=CommandCategory.INSPECTION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/detectors",
+            description="List all detectors",
+            help_text=(
+                "Show a table of all registered detectors with their status, type,"
+                " and configuration."
             ),
-            CommandOption(
-                name="--table",
-                description="Compact table view",
-                is_flag=True,
+            category=CommandCategory.INSPECTION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/embryos",
+            description="List embryos or show details",
+            help_text=(
+                "List all embryos in the current experiment. Provide an embryo ID to see"
+                " detailed information about a specific embryo."
             ),
-            CommandOption(
-                name="--axis",
-                description="Simple horizontal axis",
-                is_flag=True,
+            positional_arg="embryo_id",
+            positional_hint="ID",
+            category=CommandCategory.INSPECTION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/timelapse",
+            description="Timelapse status [watch]",
+            help_text=(
+                "Display timelapse acquisition status for all embryos.\n\n"
+                "Use 'watch' for live updating countdown view that refreshes every second."
             ),
-        ],
-        category=CommandCategory.INSPECTION,
-    ))
+            subcommands=[
+                SubCommand(
+                    name="watch",
+                    description="Live countdown mode (Ctrl+C to exit)",
+                ),
+            ],
+            category=CommandCategory.INSPECTION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/timeline",
+            description="Event timeline [--filter, clear]",
+            help_text="""Display timeline of timelapse and detection events.
+
+Shows events from the current session by default. Use --all to see events from all sessions.""",
+            subcommands=[
+                SubCommand(
+                    name="clear",
+                    description="Clear timeline history",
+                    options=[
+                        CommandOption(
+                            name="--before",
+                            description="Clear events before time",
+                            takes_value=True,
+                            value_hint="TIME",
+                        ),
+                    ],
+                ),
+            ],
+            options=[
+                CommandOption(
+                    name="--filter",
+                    description="Filter by event type",
+                    takes_value=True,
+                    value_choices=["timelapse", "detection"],
+                    value_hint="TYPE",
+                ),
+                CommandOption(
+                    name="--embryo",
+                    description="Filter by embryo ID",
+                    takes_value=True,
+                    value_hint="ID",
+                ),
+                CommandOption(
+                    name="--since",
+                    description="Show events from time period",
+                    takes_value=True,
+                    value_hint="TIME",
+                ),
+                CommandOption(
+                    name="--all",
+                    description="Show events from all sessions",
+                    is_flag=True,
+                ),
+                CommandOption(
+                    name="--letters",
+                    description="Lettered markers with legend (default)",
+                    is_flag=True,
+                ),
+                CommandOption(
+                    name="--log",
+                    description="Git-log style vertical timeline",
+                    is_flag=True,
+                ),
+                CommandOption(
+                    name="--table",
+                    description="Compact table view",
+                    is_flag=True,
+                ),
+                CommandOption(
+                    name="--axis",
+                    description="Simple horizontal axis",
+                    is_flag=True,
+                ),
+            ],
+            category=CommandCategory.INSPECTION,
+        )
+    )
 
     # === Session Commands ===
-    registry.register(CommandDefinition(
-        name="/sessions",
-        description="Browse saved sessions",
-        help_text="Open interactive session browser to view and select from saved sessions.",
-        category=CommandCategory.SESSION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/resume",
-        description="Resume a session",
-        help_text="Resume a previously saved session. Opens interactive picker if no session ID is provided.",
-        positional_arg="session_id",
-        positional_hint="ID",
-        category=CommandCategory.SESSION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/save",
-        description="Save current session",
-        help_text="Save the current session including embryo states and conversation history.",
-        category=CommandCategory.SESSION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/import-embryos",
-        description="Import embryos from session",
-        help_text="""Import embryo definitions from another session into the current session.
+    registry.register(
+        CommandDefinition(
+            name="/sessions",
+            description="Browse saved sessions",
+            help_text="Open interactive session browser to view and select from saved sessions.",
+            category=CommandCategory.SESSION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/resume",
+            description="Resume a session",
+            help_text=(
+                "Resume a previously saved session."
+                " Opens interactive picker if no session ID is provided."
+            ),
+            positional_arg="session_id",
+            positional_hint="ID",
+            category=CommandCategory.SESSION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/save",
+            description="Save current session",
+            help_text="Save the current session including embryo states and conversation history.",
+            category=CommandCategory.SESSION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/import-embryos",
+            description="Import embryos from session",
+            help_text="""Import embryo definitions from another session into the current session.
 
 Use 'last' to import from the most recent session with embryos.""",
-        positional_arg="session_id",
-        positional_hint="ID|last",
-        category=CommandCategory.SESSION,
-    ))
+            positional_arg="session_id",
+            positional_hint="ID|last",
+            category=CommandCategory.SESSION,
+        )
+    )
 
-    registry.register(CommandDefinition(
-        name="/make-video",
-        description="Create timelapse video",
-        help_text="""Generate MP4 video from timelapse volumes in current session.
+    registry.register(
+        CommandDefinition(
+            name="/make-video",
+            description="Create timelapse video",
+            help_text="""Generate MP4 video from timelapse volumes in current session.
 
-Creates max projection videos for each embryo. Optionally specify embryo ID to generate video for a single embryo.
+Creates max projection videos for each embryo. Optionally specify embryo ID to generate
+video for a single embryo.
 
 Options:
   --fps N     Frames per second (default: 10)
   --all       Include all embryos""",
-        positional_arg="embryo_id",
-        positional_hint="embryo_id",
-        options=[
-            CommandOption(
-                name="--fps",
-                description="Frames per second",
-                takes_value=True,
-                value_hint="N",
-            ),
-        ],
-        category=CommandCategory.SESSION,
-    ))
+            positional_arg="embryo_id",
+            positional_hint="embryo_id",
+            options=[
+                CommandOption(
+                    name="--fps",
+                    description="Frames per second",
+                    takes_value=True,
+                    value_hint="N",
+                ),
+            ],
+            category=CommandCategory.SESSION,
+        )
+    )
 
     # === Appearance Commands ===
-    registry.register(CommandDefinition(
-        name="/theme",
-        description="Switch color theme",
-        help_text="Change the CLI color theme.\n\nAvailable themes: vibrant, scientific, claude, monochrome",
-        positional_arg="name",
-        positional_hint="name",
-        category=CommandCategory.APPEARANCE,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/history",
-        description="Show conversation history",
-        help_text="Display recent conversation history with the agent.",
-        category=CommandCategory.APPEARANCE,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/tokens",
-        description="Show API token usage",
-        help_text="Display token usage statistics and estimated cost for the current session.",
-        category=CommandCategory.APPEARANCE,
-    ))
+    registry.register(
+        CommandDefinition(
+            name="/theme",
+            description="Switch color theme",
+            help_text=(
+                "Change the CLI color theme.\n\n"
+                "Available themes: vibrant, scientific, claude, monochrome"
+            ),
+            positional_arg="name",
+            positional_hint="name",
+            category=CommandCategory.APPEARANCE,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/history",
+            description="Show conversation history",
+            help_text="Display recent conversation history with the agent.",
+            category=CommandCategory.APPEARANCE,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/tokens",
+            description="Show API token usage",
+            help_text="Display token usage statistics and estimated cost for the current session.",
+            category=CommandCategory.APPEARANCE,
+        )
+    )
 
     # === Diagnostics Commands ===
-    registry.register(CommandDefinition(
-        name="/test-device",
-        aliases=["/benchmark"],
-        description="Test device layer pipeline (acquisition FPS benchmark)",
-        help_text="""Run end-to-end volume acquisition benchmark.
+    registry.register(
+        CommandDefinition(
+            name="/test-device",
+            aliases=["/benchmark"],
+            description="Test device layer pipeline (acquisition FPS benchmark)",
+            help_text="""Run end-to-end volume acquisition benchmark.
 
 Measures the full pipeline latency:
 - Acquisition: HTTP → device layer → hardware → file written
@@ -507,42 +569,44 @@ def _register_default_commands(registry: CommandRegistry) -> None:
 - Viz push: Push to visualization server (if running)
 
 Requires microscope connection and at least one registered embryo.""",
-        options=[
-            CommandOption(
-                name="--volumes",
-                short="-n",
-                description="Number of volumes to acquire",
-                takes_value=True,
-                value_hint="N",
-            ),
-            CommandOption(
-                name="--slices",
-                short="-s",
-                description="Slices per volume",
-                takes_value=True,
-                value_hint="N",
-            ),
-            CommandOption(
-                name="--warmup",
-                short="-w",
-                description="Warmup volumes (not timed)",
-                takes_value=True,
-                value_hint="N",
-            ),
-            CommandOption(
-                name="--save",
-                description="Save results to CSV",
-                is_flag=True,
-            ),
-        ],
-        category=CommandCategory.DIAGNOSTICS,
-    ))
+            options=[
+                CommandOption(
+                    name="--volumes",
+                    short="-n",
+                    description="Number of volumes to acquire",
+                    takes_value=True,
+                    value_hint="N",
+                ),
+                CommandOption(
+                    name="--slices",
+                    short="-s",
+                    description="Slices per volume",
+                    takes_value=True,
+                    value_hint="N",
+                ),
+                CommandOption(
+                    name="--warmup",
+                    short="-w",
+                    description="Warmup volumes (not timed)",
+                    takes_value=True,
+                    value_hint="N",
+                ),
+                CommandOption(
+                    name="--save",
+                    description="Save results to CSV",
+                    is_flag=True,
+                ),
+            ],
+            category=CommandCategory.DIAGNOSTICS,
+        )
+    )
 
     # === Planning Commands ===
-    registry.register(CommandDefinition(
-        name="/campaign",
-        description="View or manage campaigns",
-        help_text="""Browse and manage campaigns and experimental plans.
+    registry.register(
+        CommandDefinition(
+            name="/campaign",
+            description="View or manage campaigns",
+            help_text="""Browse and manage campaigns and experimental plans.
 
 Usage:
   /campaign              List all campaigns with progress summary
@@ -552,30 +616,32 @@ def _register_default_commands(registry: CommandRegistry) -> None:
   /campaign unshare <id> Stop sharing a campaign
 
 Use plan mode (/plan) to create and modify campaigns.""",
-        aliases=["/campaigns"],
-        positional_arg="campaign_id",
-        positional_hint="ID",
-        subcommands=[
-            SubCommand(
-                name="delete",
-                description="Delete a campaign and its plan items",
-            ),
-            SubCommand(
-                name="share",
-                description="Share a campaign on the mesh for coordination",
-            ),
-            SubCommand(
-                name="unshare",
-                description="Stop sharing a campaign on the mesh",
-            ),
-        ],
-        category=CommandCategory.PLANNING,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/plan",
-        description="Switch to plan mode for experimental design",
-        help_text="""Enter plan mode to design experiments with the agent.
+            aliases=["/campaigns"],
+            positional_arg="campaign_id",
+            positional_hint="ID",
+            subcommands=[
+                SubCommand(
+                    name="delete",
+                    description="Delete a campaign and its plan items",
+                ),
+                SubCommand(
+                    name="share",
+                    description="Share a campaign on the mesh for coordination",
+                ),
+                SubCommand(
+                    name="unshare",
+                    description="Stop sharing a campaign on the mesh",
+                ),
+            ],
+            category=CommandCategory.PLANNING,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/plan",
+            description="Switch to plan mode for experimental design",
+            help_text="""Enter plan mode to design experiments with the agent.
 
 In plan mode, the agent acts as a scientific collaborator — helping
 design campaigns, choose strains, set imaging parameters, plan controls,
@@ -585,85 +651,103 @@ def _register_default_commands(registry: CommandRegistry) -> None:
   /plan          Enter plan mode (or show status if already in plan mode)
   /plan status   Show current plan progress
   /plan exit     Return to run mode""",
-        subcommands=[
-            SubCommand(
-                name="status",
-                description="Show current plan progress",
+            subcommands=[
+                SubCommand(
+                    name="status",
+                    description="Show current plan progress",
+                ),
+                SubCommand(
+                    name="exit",
+                    description="Return to run mode",
+                ),
+            ],
+            category=CommandCategory.PLANNING,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/reset-context",
+            description="Clear the context database (for testing)",
+            help_text=(
+                "Wipe all campaigns, learnings, session intents, and other context.\n"
+                "The startup wizard will run again on next launch."
             ),
-            SubCommand(
-                name="exit",
-                description="Return to run mode",
+            category=CommandCategory.DIAGNOSTICS,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/wizard",
+            description="Run the startup wizard",
+            help_text=(
+                "Re-run the onboarding wizard to set organism, campaign, and session intent.\n"
+                "Useful after /reset-context or to change your current setup."
             ),
-        ],
-        category=CommandCategory.PLANNING,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/reset-context",
-        description="Clear the context database (for testing)",
-        help_text="Wipe all campaigns, learnings, session intents, and other context.\nThe startup wizard will run again on next launch.",
-        category=CommandCategory.DIAGNOSTICS,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/wizard",
-        description="Run the startup wizard",
-        help_text="Re-run the onboarding wizard to set organism, campaign, and session intent.\nUseful after /reset-context or to change your current setup.",
-        category=CommandCategory.SESSION,
-    ))
-
-    registry.register(CommandDefinition(
-        name="/peers",
-        description="Show mesh peers on the network",
-        help_text="""List all Gently instances discovered on the LAN.
+            category=CommandCategory.SESSION,
+        )
+    )
+
+    registry.register(
+        CommandDefinition(
+            name="/peers",
+            description="Show mesh peers on the network",
+            help_text="""List all Gently instances discovered on the LAN.
 Shows hostname, capabilities (GPU, SAM, microscope), and status for each peer.
 
 Usage:
   /peers                        List all peers
   /peers <hostname> campaigns   Show shared campaigns on a peer""",
-        aliases=["/mesh"],
-        positional_arg="hostname",
-        positional_hint="HOSTNAME",
-        subcommands=[
-            SubCommand(
-                name="campaigns",
-                description="Show shared campaigns on a peer",
-            ),
-        ],
-        category=CommandCategory.INSPECTION,
-    ))
+            aliases=["/mesh"],
+            positional_arg="hostname",
+            positional_hint="HOSTNAME",
+            subcommands=[
+                SubCommand(
+                    name="campaigns",
+                    description="Show shared campaigns on a peer",
+                ),
+            ],
+            category=CommandCategory.INSPECTION,
+        )
+    )
 
     # === Mesh coordination commands ===
-    registry.register(CommandDefinition(
-        name="/join-campaign",
-        description="Join a shared campaign on a peer",
-        help_text="""Join a campaign shared by a mesh peer.
+    registry.register(
+        CommandDefinition(
+            name="/join-campaign",
+            description="Join a shared campaign on a peer",
+            help_text="""Join a campaign shared by a mesh peer.
 
 Usage:
   /join-campaign <hostname> <campaign_id>
 
 After joining, use /claim to claim items for execution.""",
-        positional_hint="HOSTNAME CAMPAIGN_ID",
-        category=CommandCategory.PLANNING,
-    ))
+            positional_hint="HOSTNAME CAMPAIGN_ID",
+            category=CommandCategory.PLANNING,
+        )
+    )
 
-    registry.register(CommandDefinition(
-        name="/claim",
-        description="Claim a plan item from a shared campaign",
-        help_text="""Claim a plan item from a joined remote campaign.
+    registry.register(
+        CommandDefinition(
+            name="/claim",
+            description="Claim a plan item from a shared campaign",
+            help_text="""Claim a plan item from a joined remote campaign.
 
 Usage:
   /claim <item_id>
 
 Requires an active remote campaign (via /join-campaign).""",
-        positional_hint="ITEM_ID",
-        category=CommandCategory.PLANNING,
-    ))
+            positional_hint="ITEM_ID",
+            category=CommandCategory.PLANNING,
+        )
+    )
 
-    registry.register(CommandDefinition(
-        name="/pair",
-        description="Pair with a mesh peer for secure communication",
-        help_text="""Bluetooth-style pairing with mesh peers.
+    registry.register(
+        CommandDefinition(
+            name="/pair",
+            description="Pair with a mesh peer for secure communication",
+            help_text="""Bluetooth-style pairing with mesh peers.
 
 Usage:
   /pair <hostname>   Initiate pairing with a peer (shows PIN)
@@ -673,24 +757,28 @@ def _register_default_commands(registry: CommandRegistry) -> None:
   /pair unpair <id>  Remove trust for a peer (hostname or instance_id)
   /pair scopes       Show scopes for all peers
   /pair scopes <hostname> <scope1,scope2>  Set scopes for a peer""",
-        positional_arg="target",
-        positional_hint="HOSTNAME|accept|reject|list|unpair|scopes",
-        subcommands=[
-            SubCommand(name="accept", description="Accept a pending pairing request"),
-            SubCommand(name="reject", description="Reject a pending pairing request"),
-            SubCommand(name="list", description="Show all trusted peers"),
-            SubCommand(name="unpair", description="Remove trust for a peer"),
-            SubCommand(name="scopes", description="View or set permission scopes for a peer"),
-        ],
-        category=CommandCategory.PLANNING,
-    ))
+            positional_arg="target",
+            positional_hint="HOSTNAME|accept|reject|list|unpair|scopes",
+            subcommands=[
+                SubCommand(name="accept", description="Accept a pending pairing request"),
+                SubCommand(name="reject", description="Reject a pending pairing request"),
+                SubCommand(name="list", description="Show all trusted peers"),
+                SubCommand(name="unpair", description="Remove trust for a peer"),
+                SubCommand(
+                    name="scopes",
+                    description="View or set permission scopes for a peer",
+                ),
+            ],
+            category=CommandCategory.PLANNING,
+        )
+    )
 
 
 # ============================================================================
 # Global Registry
 # ============================================================================
 
-_command_registry: Optional[CommandRegistry] = None
+_command_registry: CommandRegistry | None = None
 
 
 def get_command_registry() -> CommandRegistry:
diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index e5de53d9..e154c724 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -10,14 +10,12 @@
 import logging
 import re
 import time
-from typing import Dict, List, Optional, Any
-
-from ..settings import settings
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
 
-def _extend_tool_calls(out: List[Dict[str, Any]], content_blocks) -> None:
+def _extend_tool_calls(out: list[dict[str, Any]], content_blocks) -> None:
     """Append every tool_use block in content_blocks to out.
 
     Tolerates absent attributes (some SDK versions / mock objects) so it
@@ -29,11 +27,13 @@ def _extend_tool_calls(out: List[Dict[str, Any]], content_blocks) -> None:
         try:
             if getattr(block, "type", None) != "tool_use":
                 continue
-            out.append({
-                "name": getattr(block, "name", None),
-                "input": getattr(block, "input", None),
-                "id": getattr(block, "id", None),
-            })
+            out.append(
+                {
+                    "name": getattr(block, "name", None),
+                    "input": getattr(block, "input", None),
+                    "id": getattr(block, "id", None),
+                }
+            )
         except Exception:
             continue
 
@@ -55,7 +55,7 @@ def __init__(self, client, model, tool_registry):
         self._tool_registry = tool_registry
 
         # Conversation state
-        self.conversation_history: List[Dict] = []
+        self.conversation_history: list[dict] = []
 
         # Token counters
         self.total_input_tokens: int = 0
@@ -76,8 +76,9 @@ def __init__(self, client, model, tool_registry):
 
     # ===== Quick Response =====
 
-    def try_quick_response(self, message: str, experiment, mode: str,
-                           enter_plan_fn, exit_plan_fn) -> Optional[str]:
+    def try_quick_response(
+        self, message: str, experiment, mode: str, enter_plan_fn, exit_plan_fn
+    ) -> str | None:
         """
         Answer simple queries from state without LLM call.
 
@@ -106,7 +107,13 @@ def try_quick_response(self, message: str, experiment, mode: str,
             return experiment.get_summary()
 
         # Plan mode switching via natural language
-        plan_enter_phrases = ("plan mode", "enter plan", "switch to plan", "let's plan", "design an experiment")
+        plan_enter_phrases = (
+            "plan mode",
+            "enter plan",
+            "switch to plan",
+            "let's plan",
+            "design an experiment",
+        )
         plan_exit_phrases = ("exit plan", "leave plan", "back to run", "run mode")
 
         if mode != "plan" and any(p in message_lower for p in plan_enter_phrases):
@@ -142,30 +149,36 @@ def should_use_thinking(self, message: str, mode: str) -> bool:
         if mode == "plan":
             return True
 
-        import re
         msg_lower = message.lower()
 
-        if re.search(r'\bthink(ing)?\b', message, re.IGNORECASE):
+        if re.search(r"\bthink(ing)?\b", message, re.IGNORECASE):
             return True
-        if re.search(r'\bcalibrat', msg_lower):
+        if re.search(r"\bcalibrat", msg_lower):
             return True
-        if re.search(r'\b(plan|timelapse|time-lapse|acquisition)\b', msg_lower):
+        if re.search(r"\b(plan|timelapse|time-lapse|acquisition)\b", msg_lower):
             return True
-        if re.search(r'\b(analy[sz]e|look at|check|inspect|review).*(image|volume|embryo)', msg_lower):
+        if re.search(
+            r"\b(analy[sz]e|look at|check|inspect|review).*(image|volume|embryo)",
+            msg_lower,
+        ):
             return True
-        if re.search(r'\b(all|every|each)\s+(embryo|sample)', msg_lower):
+        if re.search(r"\b(all|every|each)\s+(embryo|sample)", msg_lower):
             return True
-        if re.search(r'\b(first|then|after|next|finally)\b.*\b(first|then|after|next|finally)\b', msg_lower):
+        if re.search(
+            r"\b(first|then|after|next|finally)\b.*\b(first|then|after|next|finally)\b",
+            msg_lower,
+        ):
             return True
-        if re.search(r'\b(why|problem|issue|error|wrong|fail|debug|troubleshoot)', msg_lower):
+        if re.search(r"\b(why|problem|issue|error|wrong|fail|debug|troubleshoot)", msg_lower):
             return True
 
         return False
 
     # ===== Non-Streaming API Call =====
 
-    async def call_claude(self, user_message: str, system_prompt, tools,
-                          mode: str, auto_save_fn) -> str:
+    async def call_claude(
+        self, user_message: str, system_prompt, tools, mode: str, auto_save_fn
+    ) -> str:
         """
         Call Claude API with full context and tool access (non-streaming).
 
@@ -197,8 +210,8 @@ async def call_claude(self, user_message: str, system_prompt, tools,
             interaction = self.interaction_logger.start_interaction(
                 user_prompt=user_message,
                 system_state={
-                    'acquisition_status': 'unknown',
-                }
+                    "acquisition_status": "unknown",
+                },
             )
 
         # Snapshot inputs for decision capture BEFORE the tool loop starts
@@ -209,13 +222,15 @@ async def call_claude(self, user_message: str, system_prompt, tools,
         if self.decision_log is not None:
             try:
                 from gently.eval import prompt_hash as _prompt_hash
+
                 decision_prompt_hash = _prompt_hash(
-                    system_prompt, list(self.conversation_history),
+                    system_prompt,
+                    list(self.conversation_history),
                 )
             except Exception:
                 logger.exception("Failed to compute decision prompt_hash")
 
-        tool_calls_collected: List[Dict[str, Any]] = []
+        tool_calls_collected: list[dict[str, Any]] = []
         assistant_message = ""
         error_occurred = None
 
@@ -231,32 +246,20 @@ async def call_claude(self, user_message: str, system_prompt, tools,
                 budget = 30000 if mode == "plan" else 10000
                 api_kwargs["thinking"] = {"type": "enabled", "budget_tokens": budget}
 
-            response = await self._call_api_with_retry(
-                self.claude.messages.create,
-                **api_kwargs
-            )
+            response = await self._call_api_with_retry(self.claude.messages.create, **api_kwargs)
             self._track_token_usage(response)
             _extend_tool_calls(tool_calls_collected, response.content)
 
             # Process tool calls
             while response.stop_reason == "tool_use":
-                tool_results = await self._execute_tools_with_logging(
-                    response.content, interaction
-                )
+                tool_results = await self._execute_tools_with_logging(response.content, interaction)
 
-                self.conversation_history.append({
-                    "role": "assistant",
-                    "content": response.content
-                })
-                self.conversation_history.append({
-                    "role": "user",
-                    "content": tool_results
-                })
+                self.conversation_history.append({"role": "assistant", "content": response.content})
+                self.conversation_history.append({"role": "user", "content": tool_results})
 
                 api_kwargs["messages"] = self.conversation_history
                 response = await self._call_api_with_retry(
-                    self.claude.messages.create,
-                    **api_kwargs
+                    self.claude.messages.create, **api_kwargs
                 )
                 self._track_token_usage(response)
                 _extend_tool_calls(tool_calls_collected, response.content)
@@ -264,16 +267,14 @@ async def call_claude(self, user_message: str, system_prompt, tools,
             # Extract text response
             assistant_message = ""
             for block in response.content:
-                if hasattr(block, 'text'):
+                if hasattr(block, "text"):
                     assistant_message += block.text
 
-            self.conversation_history.append({
-                "role": "assistant",
-                "content": response.content
-            })
+            self.conversation_history.append({"role": "assistant", "content": response.content})
 
         except Exception as e:
             import traceback
+
             error_occurred = str(e)
             error_tb = traceback.format_exc()
             assistant_message = f"Error: {error_occurred}"
@@ -320,11 +321,11 @@ def _write_production_decision(
         self,
         *,
         user_message: str,
-        tool_calls: List[Dict[str, Any]],
+        tool_calls: list[dict[str, Any]],
         response_text: str,
         duration_ms: float,
-        prompt_hash_value: Optional[str],
-        error: Optional[str],
+        prompt_hash_value: str | None,
+        error: str | None,
     ) -> None:
         """Persist one production Decision row (best-effort).
 
@@ -336,24 +337,28 @@ def _write_production_decision(
             return
         try:
             from datetime import datetime
+
             from gently.eval import Decision, DecisionTrigger
-            self.decision_log.append(Decision(
-                timestamp=datetime.now(),
-                agent="production",
-                trigger=DecisionTrigger.USER_MESSAGE,
-                trigger_detail=(user_message or "")[:200],
-                tool_calls=tool_calls,
-                response_text=response_text,
-                prompt_hash=prompt_hash_value,
-                duration_ms=duration_ms,
-                error=error,
-            ))
+
+            self.decision_log.append(
+                Decision(
+                    timestamp=datetime.now(),
+                    agent="production",
+                    trigger=DecisionTrigger.USER_MESSAGE,
+                    trigger_detail=(user_message or "")[:200],
+                    tool_calls=tool_calls,
+                    response_text=response_text,
+                    prompt_hash=prompt_hash_value,
+                    duration_ms=duration_ms,
+                    error=error,
+                )
+            )
         except Exception:
             logger.exception("Failed to write production Decision")
 
     # ===== Dry-Run Tool Call (Benchmarking) =====
 
-    async def get_tool_call(self, user_message: str, system_prompt, tools) -> Optional[Dict]:
+    async def get_tool_call(self, user_message: str, system_prompt, tools) -> dict | None:
         """
         Get what tool Claude would call without executing it (dry-run mode).
 
@@ -376,10 +381,7 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> Option
         start_time = time.time()
 
         messages = self.conversation_history.copy()
-        messages.append({
-            "role": "user",
-            "content": user_message
-        })
+        messages.append({"role": "user", "content": user_message})
 
         try:
             api_kwargs = {
@@ -390,15 +392,12 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> Option
                 "max_tokens": 4096,
             }
 
-            response = await self._call_api_with_retry(
-                self.claude.messages.create,
-                **api_kwargs
-            )
+            response = await self._call_api_with_retry(self.claude.messages.create, **api_kwargs)
 
             latency_ms = (time.time() - start_time) * 1000
 
-            input_tokens = getattr(response.usage, 'input_tokens', 0)
-            output_tokens = getattr(response.usage, 'output_tokens', 0)
+            input_tokens = getattr(response.usage, "input_tokens", 0)
+            output_tokens = getattr(response.usage, "output_tokens", 0)
 
             for block in response.content:
                 if block.type == "tool_use":
@@ -418,7 +417,7 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> Option
 
     # ===== Tool Execution =====
 
-    async def _execute_tools_with_logging(self, content_blocks, interaction) -> List[Dict]:
+    async def _execute_tools_with_logging(self, content_blocks, interaction) -> list[dict]:
         """
         Execute Claude's tool calls with interaction logging.
 
@@ -450,7 +449,10 @@ async def _execute_tools_with_logging(self, content_blocks, interaction) -> List
                     if self.choice_handler and isinstance(result, str):
                         try:
                             choice_data = json.loads(result)
-                            if isinstance(choice_data, dict) and choice_data.get("_type") == CHOICE_RESPONSE_TYPE:
+                            if (
+                                isinstance(choice_data, dict)
+                                and choice_data.get("_type") == CHOICE_RESPONSE_TYPE
+                            ):
                                 user_selection = await self.choice_handler(choice_data)
                                 result = user_selection
                         except (json.JSONDecodeError, TypeError):
@@ -474,19 +476,20 @@ async def _execute_tools_with_logging(self, content_blocks, interaction) -> List
                         error_message=error_message,
                     )
 
-                results.append({
-                    "type": "tool_result",
-                    "tool_use_id": block.id,
-                    "content": result,
-                    "is_error": is_error,
-                })
+                results.append(
+                    {
+                        "type": "tool_result",
+                        "tool_use_id": block.id,
+                        "content": result,
+                        "is_error": is_error,
+                    }
+                )
 
         return results
 
     # ===== Streaming API Call =====
 
-    async def call_claude_stream(self, system_prompt, tools,
-                                 tool_label_fn, auto_save_fn):
+    async def call_claude_stream(self, system_prompt, tools, tool_label_fn, auto_save_fn):
         """
         Call Claude API with streaming enabled.
 
@@ -517,7 +520,7 @@ def stream_and_collect():
                 system=system_prompt,
                 messages=self.conversation_history,
                 tools=tools,
-                max_tokens=4096
+                max_tokens=4096,
             ) as stream:
                 for event in stream:
                     events.append(event)
@@ -535,15 +538,24 @@ def stream_and_collect():
                 self._track_token_usage(final_message)
                 break
             except APIStatusError as e:
-                error_type = getattr(e, 'body', {})
+                error_type = getattr(e, "body", {})
                 if isinstance(error_type, dict):
-                    error_type = error_type.get('error', {}).get('type', '')
+                    error_type = error_type.get("error", {}).get("type", "")
 
-                if error_type in ('overloaded_error', 'rate_limit_error') or 'overloaded' in str(e).lower():
+                if (
+                    error_type in ("overloaded_error", "rate_limit_error")
+                    or "overloaded" in str(e).lower()
+                ):
                     if attempt < max_retries - 1:
-                        wait_time = retry_delay * (2 ** attempt)
-                        logger.warning(f"API overloaded, retrying in {wait_time:.1f}s (attempt {attempt + 1}/{max_retries})")
-                        yield {'type': 'text', 'text': f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n"}
+                        wait_time = retry_delay * (2**attempt)
+                        logger.warning(
+                            f"API overloaded, retrying in {wait_time:.1f}s"
+                            f" (attempt {attempt + 1}/{max_retries})"
+                        )
+                        yield {
+                            "type": "text",
+                            "text": f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n",
+                        }
                         await asyncio.sleep(wait_time)
                         continue
                 raise
@@ -552,27 +564,31 @@ def stream_and_collect():
 
         # Diagnostic: log stop_reason and tool block counts
         tool_block_count = sum(
-            1 for b in final_message.content
-            if hasattr(b, 'type') and b.type == 'tool_use'
+            1 for b in final_message.content if hasattr(b, "type") and b.type == "tool_use"
         )
         logger.warning(
-            "Claude response: stop_reason=%s, content_blocks=%d, tool_use_blocks=%d, tools_passed=%d, model=%s",
-            final_message.stop_reason, len(final_message.content),
-            tool_block_count, len(tools), self.model,
+            "Claude response: stop_reason=%s, content_blocks=%d, tool_use_blocks=%d,"
+            " tools_passed=%d, model=%s",
+            final_message.stop_reason,
+            len(final_message.content),
+            tool_block_count,
+            len(tools),
+            self.model,
         )
         if tool_block_count > 0 and final_message.stop_reason != "tool_use":
             logger.error(
                 "BUG: Claude returned %d tool_use blocks but stop_reason=%s (expected 'tool_use')",
-                tool_block_count, final_message.stop_reason,
+                tool_block_count,
+                final_message.stop_reason,
             )
 
         # Process events and yield text
         full_text = []
         for event in events:
             if event.type == "content_block_delta":
-                if hasattr(event.delta, 'text'):
+                if hasattr(event.delta, "text"):
                     full_text.append(event.delta.text)
-                    yield {'type': 'text', 'text': event.delta.text}
+                    yield {"type": "text", "text": event.delta.text}
 
         # Detect fake XML tool calls in text (Claude writing tool_use as text)
         joined_text = "".join(full_text)
@@ -580,7 +596,8 @@ def stream_and_collect():
             logger.error(
                 "DETECTED: Claude wrote XML tool tags as plain text instead of "
                 "using API tool_use mechanism. stop_reason=%s, text_preview=%.200s",
-                final_message.stop_reason, joined_text[:200],
+                final_message.stop_reason,
+                joined_text[:200],
             )
 
         response_content = final_message.content
@@ -594,14 +611,14 @@ def stream_and_collect():
 
             tool_results = []
             for block in response_content:
-                if hasattr(block, 'type') and block.type == "tool_use":
+                if hasattr(block, "type") and block.type == "tool_use":
                     start_time = time.time()
 
                     yield {
-                        'type': 'tool_start',
-                        'tool_name': block.name,
-                        'tool_input': block.input,
-                        'tool_label': tool_label_fn(block.name, block.input),
+                        "type": "tool_start",
+                        "tool_name": block.name,
+                        "tool_input": block.input,
+                        "tool_label": tool_label_fn(block.name, block.input),
                     }
 
                     is_error_flag = False
@@ -611,32 +628,44 @@ def stream_and_collect():
 
                         if isinstance(tool_result, str):
                             try:
-                                from gently.app.tools.interaction_tools import CHOICE_RESPONSE_TYPE
+                                from gently.app.tools.interaction_tools import (
+                                    CHOICE_RESPONSE_TYPE,
+                                )
+
                                 choice_data = json.loads(tool_result)
-                                if isinstance(choice_data, dict) and choice_data.get("_type") == CHOICE_RESPONSE_TYPE:
+                                if (
+                                    isinstance(choice_data, dict)
+                                    and choice_data.get("_type") == CHOICE_RESPONSE_TYPE
+                                ):
                                     user_selection = yield {
-                                        'type': 'choice_request',
-                                        'choice_data': choice_data
+                                        "type": "choice_request",
+                                        "choice_data": choice_data,
                                     }
                                     tool_result = user_selection or "cancelled"
                             except (json.JSONDecodeError, TypeError):
                                 pass
 
-                        result_text = tool_result if isinstance(tool_result, str) else str(tool_result)
-                        tool_results.append({
-                            "type": "tool_result",
-                            "tool_use_id": block.id,
-                            "content": tool_result
-                        })
+                        result_text = (
+                            tool_result if isinstance(tool_result, str) else str(tool_result)
+                        )
+                        tool_results.append(
+                            {
+                                "type": "tool_result",
+                                "tool_use_id": block.id,
+                                "content": tool_result,
+                            }
+                        )
                     except Exception as e:
                         is_error_flag = True
                         result_text = f"Error: {str(e)}"
-                        tool_results.append({
-                            "type": "tool_result",
-                            "tool_use_id": block.id,
-                            "content": result_text,
-                            "is_error": True
-                        })
+                        tool_results.append(
+                            {
+                                "type": "tool_result",
+                                "tool_use_id": block.id,
+                                "content": result_text,
+                                "is_error": True,
+                            }
+                        )
 
                     # First non-empty line of the result, trimmed — gives the chat
                     # UI a one-line summary so the operator can see what a tool did
@@ -649,22 +678,16 @@ def stream_and_collect():
                         result_summary = result_summary[:139] + "…"
 
                     yield {
-                        'type': 'tool_call',
-                        'tool_name': block.name,
-                        'tool_input': block.input,
-                        'duration': time.time() - start_time,
-                        'result_summary': result_summary,
-                        'is_error': is_error_flag,
+                        "type": "tool_call",
+                        "tool_name": block.name,
+                        "tool_input": block.input,
+                        "duration": time.time() - start_time,
+                        "result_summary": result_summary,
+                        "is_error": is_error_flag,
                     }
 
-            self.conversation_history.append({
-                "role": "assistant",
-                "content": response_content
-            })
-            self.conversation_history.append({
-                "role": "user",
-                "content": tool_results
-            })
+            self.conversation_history.append({"role": "assistant", "content": response_content})
+            self.conversation_history.append({"role": "user", "content": tool_results})
 
             auto_save_fn()
 
@@ -686,15 +709,12 @@ def stream_and_collect():
 
         else:
             # No tool calls - add final message to history
-            self.conversation_history.append({
-                "role": "assistant",
-                "content": response_content
-            })
+            self.conversation_history.append({"role": "assistant", "content": response_content})
             auto_save_fn()
 
     # ===== Tool Label =====
 
-    def tool_label(self, tool_name: str, tool_input: Dict) -> str:
+    def tool_label(self, tool_name: str, tool_input: dict) -> str:
         """Build a human-readable label for a tool call.
 
         Used in tool_start chunks so the TUI shows biologist-friendly
@@ -708,8 +728,13 @@ def tool_label(self, tool_name: str, tool_input: Dict) -> str:
             campaign = self.context_store.get_campaign(campaign_id)
             if campaign:
                 campaign_label = campaign.shorthand or campaign.description
-                if tool_name in ("propose_plan", "get_plan_status", "export_plan",
-                                 "snapshot_plan", "list_plan_versions"):
+                if tool_name in (
+                    "propose_plan",
+                    "get_plan_status",
+                    "export_plan",
+                    "snapshot_plan",
+                    "list_plan_versions",
+                ):
                     return campaign_label
                 if tool_name == "create_campaign" and inp.get("parent_id"):
                     return f"phase under {campaign_label}"
@@ -727,8 +752,12 @@ def tool_label(self, tool_name: str, tool_input: Dict) -> str:
 
         # Item reference tools
         item_ref = inp.get("item_ref") or inp.get("ref") or inp.get("item_id")
-        if item_ref and tool_name in ("get_plan_item", "update_plan_item",
-                                       "delete_plan_item", "move_plan_item"):
+        if item_ref and tool_name in (
+            "get_plan_item",
+            "update_plan_item",
+            "delete_plan_item",
+            "move_plan_item",
+        ):
             if self.context_store:
                 item = self.context_store.resolve_plan_item(str(item_ref), campaign_id=campaign_id)
                 if item:
@@ -755,8 +784,9 @@ def tool_label(self, tool_name: str, tool_input: Dict) -> str:
 
         return ""
 
-    async def _execute_single_tool(self, tool_name: str, tool_input: Dict,
-                                   context: Optional[Dict] = None) -> str:
+    async def _execute_single_tool(
+        self, tool_name: str, tool_input: dict, context: dict | None = None
+    ) -> str:
         """Execute a single tool call using the tool registry.
 
         Parameters
@@ -776,13 +806,13 @@ async def _execute_single_tool(self, tool_name: str, tool_input: Dict,
 
     def _track_token_usage(self, response):
         """Track token usage from API response, including cache metrics."""
-        if hasattr(response, 'usage'):
+        if hasattr(response, "usage"):
             usage = response.usage
             self.total_input_tokens += usage.input_tokens
             self.total_output_tokens += usage.output_tokens
             self.api_call_count += 1
-            self.cache_creation_tokens += getattr(usage, 'cache_creation_input_tokens', 0)
-            self.cache_read_tokens += getattr(usage, 'cache_read_input_tokens', 0)
+            self.cache_creation_tokens += getattr(usage, "cache_creation_input_tokens", 0)
+            self.cache_read_tokens += getattr(usage, "cache_read_input_tokens", 0)
 
     @property
     def current_context_tokens(self) -> int:
@@ -793,14 +823,14 @@ def current_context_tokens(self) -> int:
 
         conv_chars = 0
         for msg in self.conversation_history:
-            content = msg.get('content', '')
+            content = msg.get("content", "")
             if isinstance(content, str):
                 conv_chars += len(content)
             elif isinstance(content, list):
                 for block in content:
                     if isinstance(block, dict):
-                        conv_chars += len(str(block.get('text', '')))
-                    elif hasattr(block, 'text'):
+                        conv_chars += len(str(block.get("text", "")))
+                    elif hasattr(block, "text"):
                         conv_chars += len(str(block.text))
                     else:
                         conv_chars += len(str(block))
@@ -866,19 +896,22 @@ async def _call_api_with_retry(self, api_func, *args, max_retries=3, **kwargs):
             try:
                 return await asyncio.to_thread(api_func, *args, **kwargs)
             except APIStatusError as e:
-                error_type = getattr(e, 'body', {})
+                error_type = getattr(e, "body", {})
                 if isinstance(error_type, dict):
-                    error_type = error_type.get('error', {}).get('type', '')
+                    error_type = error_type.get("error", {}).get("type", "")
 
                 is_retryable = (
-                    error_type in ('overloaded_error', 'rate_limit_error') or
-                    'overloaded' in str(e).lower() or
-                    'rate_limit' in str(e).lower()
+                    error_type in ("overloaded_error", "rate_limit_error")
+                    or "overloaded" in str(e).lower()
+                    or "rate_limit" in str(e).lower()
                 )
 
                 if is_retryable and attempt < max_retries - 1:
-                    wait_time = retry_delay * (2 ** attempt)
-                    logger.warning(f"API error ({error_type}), retrying in {wait_time:.1f}s (attempt {attempt + 1}/{max_retries})")
+                    wait_time = retry_delay * (2**attempt)
+                    logger.warning(
+                        f"API error ({error_type}), retrying in {wait_time:.1f}s"
+                        f" (attempt {attempt + 1}/{max_retries})"
+                    )
                     await asyncio.sleep(wait_time)
                     continue
 
diff --git a/gently/harness/detection/detector.py b/gently/harness/detection/detector.py
index 8cb5fa8b..d5729681 100644
--- a/gently/harness/detection/detector.py
+++ b/gently/harness/detection/detector.py
@@ -2,21 +2,23 @@
 Generic detector system for runtime-configurable event detection
 """
 
-from dataclasses import dataclass, field, asdict
+from dataclasses import asdict, dataclass, field
 from datetime import datetime
-from typing import Dict, List, Optional, Any
 from enum import Enum
+from typing import Any
 
 
 class DetectionMode(str, Enum):
     """Action mode when detector fires"""
-    PASSIVE = "passive"              # Just flag, no action
-    RECOMMEND = "recommend"          # Suggest actions to user
-    AUTO = "auto"                    # Execute actions automatically
+
+    PASSIVE = "passive"  # Just flag, no action
+    RECOMMEND = "recommend"  # Suggest actions to user
+    AUTO = "auto"  # Execute actions automatically
 
 
 class ConfidenceLevel(str, Enum):
     """Confidence levels for detections"""
+
     LOW = "LOW"
     MEDIUM = "MEDIUM"
     HIGH = "HIGH"
@@ -25,15 +27,20 @@ class ConfidenceLevel(str, Enum):
 @dataclass
 class DetectorConditions:
     """Conditions for when to run a detector"""
-    min_timepoint: Optional[int] = None      # Don't run before this timepoint
-    max_timepoint: Optional[int] = None      # Don't run after this timepoint
-    embryo_ids: Optional[List[str]] = None   # Only run on these embryos (None = all)
-    run_if_detected: bool = True              # Continue running after first detection?
-    min_interval_timepoints: int = 1          # Minimum timepoints between runs
-
-    def should_run(self, embryo_id: str, timepoint: int,
-                   last_run_timepoint: Optional[int],
-                   already_detected: bool) -> bool:
+
+    min_timepoint: int | None = None  # Don't run before this timepoint
+    max_timepoint: int | None = None  # Don't run after this timepoint
+    embryo_ids: list[str] | None = None  # Only run on these embryos (None = all)
+    run_if_detected: bool = True  # Continue running after first detection?
+    min_interval_timepoints: int = 1  # Minimum timepoints between runs
+
+    def should_run(
+        self,
+        embryo_id: str,
+        timepoint: int,
+        last_run_timepoint: int | None,
+        already_detected: bool,
+    ) -> bool:
         """
         Check if detector should run
 
@@ -78,11 +85,12 @@ def should_run(self, embryo_id: str, timepoint: int,
 @dataclass
 class DetectorActions:
     """Actions to take when detector fires"""
+
     mode: DetectionMode = DetectionMode.RECOMMEND
-    parameter_changes: Optional[Dict[str, Any]] = None  # e.g., {"interval_seconds": 60}
-    stop_timelapse: bool = False                        # Stop timelapse when detected
-    custom_message: Optional[str] = None                # Custom notification
-    webhook_url: Optional[str] = None                   # External notification
+    parameter_changes: dict[str, Any] | None = None  # e.g., {"interval_seconds": 60}
+    stop_timelapse: bool = False  # Stop timelapse when detected
+    custom_message: str | None = None  # Custom notification
+    webhook_url: str | None = None  # External notification
 
     def get_recommendation_message(self, detector_name: str, embryo_id: str) -> str:
         """Generate recommendation message for user"""
@@ -103,25 +111,26 @@ def get_recommendation_message(self, detector_name: str, embryo_id: str) -> str:
 @dataclass
 class DetectionResult:
     """Result of a single detection attempt"""
+
     detector_name: str
     embryo_id: str
     timepoint: int
     timestamp: datetime
     detected: bool
-    confidence: Optional[ConfidenceLevel] = None
-    reasoning: Optional[str] = None
+    confidence: ConfidenceLevel | None = None
+    reasoning: str | None = None
     error: bool = False
-    error_message: Optional[str] = None
-    api_duration: Optional[float] = None     # seconds
+    error_message: str | None = None
+    api_duration: float | None = None  # seconds
     num_images: int = 1
-    full_response: Optional[str] = None
+    full_response: str | None = None
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Convert to dictionary"""
         d = asdict(self)
-        d['timestamp'] = self.timestamp.isoformat()
+        d["timestamp"] = self.timestamp.isoformat()
         if self.confidence:
-            d['confidence'] = self.confidence.value
+            d["confidence"] = self.confidence.value
         return d
 
 
@@ -133,22 +142,23 @@ class Detector:
     A detector analyzes volumes using Claude Vision API to detect specific
     events or states (e.g., "comma stage", "hatching", "neural activity").
     """
-    name: str                                    # Unique identifier (e.g., "comma_stage")
-    description: str                             # Human-readable description
-    detection_prompt: str                        # Claude Vision API prompt
-    enabled: bool = True                         # Can be toggled on/off
+
+    name: str  # Unique identifier (e.g., "comma_stage")
+    description: str  # Human-readable description
+    detection_prompt: str  # Claude Vision API prompt
+    enabled: bool = True  # Can be toggled on/off
     conditions: DetectorConditions = field(default_factory=DetectorConditions)
     actions: DetectorActions = field(default_factory=DetectorActions)
     confidence_threshold: ConfidenceLevel = ConfidenceLevel.MEDIUM
-    use_temporal_context: bool = True            # Include recent images?
-    temporal_context_size: int = 5               # How many recent images
+    use_temporal_context: bool = True  # Include recent images?
+    temporal_context_size: int = 5  # How many recent images
     created_at: datetime = field(default_factory=datetime.now)
     modified_at: datetime = field(default_factory=datetime.now)
-    detection_count: int = 0                     # Total detections fired
-    run_count: int = 0                           # Total times run
+    detection_count: int = 0  # Total detections fired
+    run_count: int = 0  # Total times run
 
     # Tracking per-embryo state
-    _last_run_timepoint: Dict[str, int] = field(default_factory=dict, repr=False)
+    _last_run_timepoint: dict[str, int] = field(default_factory=dict, repr=False)
     _detected_embryos: set = field(default_factory=set, repr=False)
 
     def should_run(self, embryo_id: str, timepoint: int) -> bool:
@@ -173,9 +183,7 @@ def should_run(self, embryo_id: str, timepoint: int) -> bool:
         last_run = self._last_run_timepoint.get(embryo_id)
         already_detected = embryo_id in self._detected_embryos
 
-        return self.conditions.should_run(
-            embryo_id, timepoint, last_run, already_detected
-        )
+        return self.conditions.should_run(embryo_id, timepoint, last_run, already_detected)
 
     def mark_run(self, embryo_id: str, timepoint: int):
         """Mark that detector ran for this embryo/timepoint"""
@@ -191,8 +199,9 @@ def was_detected(self, embryo_id: str) -> bool:
         """Check if detector already fired for this embryo"""
         return embryo_id in self._detected_embryos
 
-    def build_detection_content(self, images: List[Dict],
-                                embryo_id: str, timepoint: int) -> List[Dict]:
+    def build_detection_content(
+        self, images: list[dict], embryo_id: str, timepoint: int
+    ) -> list[dict]:
         """
         Build Claude Vision API content array
 
@@ -213,57 +222,59 @@ def build_detection_content(self, images: List[Dict],
         content = []
 
         # Add instruction
-        content.append({
-            "type": "text",
-            "text": f"Analyzing {embryo_id} at timepoint {timepoint}"
-        })
+        content.append({"type": "text", "text": f"Analyzing {embryo_id} at timepoint {timepoint}"})
 
         # Add temporal context if enabled
         if self.use_temporal_context and len(images) > 1:
-            content.append({
-                "type": "text",
-                "text": f"Recent images (for temporal context, {len(images)} timepoints):"
-            })
+            content.append(
+                {
+                    "type": "text",
+                    "text": f"Recent images (for temporal context, {len(images)} timepoints):",
+                }
+            )
 
             # Add older images first
             for img_data in images[:-1]:
-                content.append({
-                    "type": "text",
-                    "text": f"Timepoint {img_data['timepoint']:04d}"
-                })
-                content.append({
-                    "type": "image",
-                    "source": {
-                        "type": "base64",
-                        "media_type": "image/jpeg",
-                        "data": img_data['b64_image']
+                content.append({"type": "text", "text": f"Timepoint {img_data['timepoint']:04d}"})
+                content.append(
+                    {
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": "image/jpeg",
+                            "data": img_data["b64_image"],
+                        },
                     }
-                })
+                )
 
         # Add current/latest image
         latest = images[-1]
-        content.append({
-            "type": "text",
-            "text": f"Current image (timepoint {latest['timepoint']:04d}) - FOCUS YOUR ANALYSIS HERE:"
-        })
-        content.append({
-            "type": "image",
-            "source": {
-                "type": "base64",
-                "media_type": "image/jpeg",
-                "data": latest['b64_image']
+        content.append(
+            {
+                "type": "text",
+                "text": (
+                    f"Current image (timepoint {latest['timepoint']:04d})"
+                    " - FOCUS YOUR ANALYSIS HERE:"
+                ),
+            }
+        )
+        content.append(
+            {
+                "type": "image",
+                "source": {
+                    "type": "base64",
+                    "media_type": "image/jpeg",
+                    "data": latest["b64_image"],
+                },
             }
-        })
+        )
 
         # Add detection prompt
-        content.append({
-            "type": "text",
-            "text": self.detection_prompt
-        })
+        content.append({"type": "text", "text": self.detection_prompt})
 
         return content
 
-    def parse_detection_response(self, response_text: str) -> Dict:
+    def parse_detection_response(self, response_text: str) -> dict:
         """
         Parse Claude's detection response
 
@@ -286,98 +297,102 @@ def parse_detection_response(self, response_text: str) -> Dict:
         confidence = None
         reasoning = None
 
-        lines = response_text.strip().split('\n')
+        lines = response_text.strip().split("\n")
 
         for line in lines:
             line = line.strip()
-            if line.startswith('DETECTED:'):
-                value = line.split(':', 1)[1].strip().upper()
-                detected = value in ['YES', 'TRUE', '1']
-            elif line.startswith('CONFIDENCE:'):
-                conf_str = line.split(':', 1)[1].strip().upper()
+            if line.startswith("DETECTED:"):
+                value = line.split(":", 1)[1].strip().upper()
+                detected = value in ["YES", "TRUE", "1"]
+            elif line.startswith("CONFIDENCE:"):
+                conf_str = line.split(":", 1)[1].strip().upper()
                 try:
                     confidence = ConfidenceLevel(conf_str)
                 except ValueError:
                     confidence = None
-            elif line.startswith('REASONING:'):
-                reasoning = line.split(':', 1)[1].strip()
+            elif line.startswith("REASONING:"):
+                reasoning = line.split(":", 1)[1].strip()
 
         # If multiline reasoning, capture it
         if reasoning is None:
             reasoning_start = False
             reasoning_lines = []
             for line in lines:
-                if line.startswith('REASONING:'):
+                if line.startswith("REASONING:"):
                     reasoning_start = True
-                    reasoning_lines.append(line.split(':', 1)[1].strip())
+                    reasoning_lines.append(line.split(":", 1)[1].strip())
                 elif reasoning_start and line:
                     reasoning_lines.append(line)
             if reasoning_lines:
-                reasoning = ' '.join(reasoning_lines)
+                reasoning = " ".join(reasoning_lines)
 
         return {
-            'detected': detected if detected is not None else False,
-            'confidence': confidence,
-            'reasoning': reasoning or "No reasoning provided"
+            "detected": detected if detected is not None else False,
+            "confidence": confidence,
+            "reasoning": reasoning or "No reasoning provided",
         }
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Convert to dictionary for serialization"""
         return {
-            'name': self.name,
-            'description': self.description,
-            'detection_prompt': self.detection_prompt,
-            'enabled': self.enabled,
-            'conditions': asdict(self.conditions),
-            'actions': {
-                'mode': self.actions.mode.value,
-                'parameter_changes': self.actions.parameter_changes,
-                'custom_message': self.actions.custom_message,
-                'webhook_url': self.actions.webhook_url,
+            "name": self.name,
+            "description": self.description,
+            "detection_prompt": self.detection_prompt,
+            "enabled": self.enabled,
+            "conditions": asdict(self.conditions),
+            "actions": {
+                "mode": self.actions.mode.value,
+                "parameter_changes": self.actions.parameter_changes,
+                "custom_message": self.actions.custom_message,
+                "webhook_url": self.actions.webhook_url,
             },
-            'confidence_threshold': self.confidence_threshold.value,
-            'use_temporal_context': self.use_temporal_context,
-            'temporal_context_size': self.temporal_context_size,
-            'created_at': self.created_at.isoformat(),
-            'modified_at': self.modified_at.isoformat(),
-            'detection_count': self.detection_count,
-            'run_count': self.run_count,
+            "confidence_threshold": self.confidence_threshold.value,
+            "use_temporal_context": self.use_temporal_context,
+            "temporal_context_size": self.temporal_context_size,
+            "created_at": self.created_at.isoformat(),
+            "modified_at": self.modified_at.isoformat(),
+            "detection_count": self.detection_count,
+            "run_count": self.run_count,
         }
 
     @classmethod
-    def from_dict(cls, data: Dict) -> 'Detector':
+    def from_dict(cls, data: dict) -> "Detector":
         """Create detector from dictionary"""
         # Parse dates
-        created_at = datetime.fromisoformat(data['created_at']) if 'created_at' in data else datetime.now()
-        modified_at = datetime.fromisoformat(data['modified_at']) if 'modified_at' in data else datetime.now()
+        created_at = (
+            datetime.fromisoformat(data["created_at"]) if "created_at" in data else datetime.now()
+        )
+        modified_at = (
+            datetime.fromisoformat(data["modified_at"]) if "modified_at" in data else datetime.now()
+        )
 
         # Parse conditions
-        conditions = DetectorConditions(**data.get('conditions', {}))
+        conditions = DetectorConditions(**data.get("conditions", {}))
 
         # Parse actions
-        actions_data = data.get('actions', {})
+        actions_data = data.get("actions", {})
         actions = DetectorActions(
-            mode=DetectionMode(actions_data.get('mode', 'recommend')),
-            parameter_changes=actions_data.get('parameter_changes'),
-            custom_message=actions_data.get('custom_message'),
-            webhook_url=actions_data.get('webhook_url'),
+            mode=DetectionMode(actions_data.get("mode", "recommend")),
+            parameter_changes=actions_data.get("parameter_changes"),
+            custom_message=actions_data.get("custom_message"),
+            webhook_url=actions_data.get("webhook_url"),
         )
 
         # Parse confidence threshold
-        confidence_threshold = ConfidenceLevel(data.get('confidence_threshold', 'MEDIUM'))
+        confidence_threshold = ConfidenceLevel(data.get("confidence_threshold", "MEDIUM"))
 
         return cls(
-            name=data['name'],
-            description=data['description'],
-            detection_prompt=data['detection_prompt'],
-            enabled=data.get('enabled', True),
+            name=data["name"],
+            description=data["description"],
+            detection_prompt=data["detection_prompt"],
+            enabled=data.get("enabled", True),
             conditions=conditions,
             actions=actions,
             confidence_threshold=confidence_threshold,
-            use_temporal_context=data.get('use_temporal_context', True),
-            temporal_context_size=data.get('temporal_context_size', 5),
+            use_temporal_context=data.get("use_temporal_context", True),
+            temporal_context_size=data.get("temporal_context_size", 5),
             created_at=created_at,
             modified_at=modified_at,
-            detection_count=data.get('detection_count', 0),
-            run_count=data.get('run_count', 0),
+            detection_count=data.get("detection_count", 0),
+            run_count=data.get("run_count", 0),
         )
diff --git a/gently/harness/detection/queue.py b/gently/harness/detection/queue.py
index e0f0d2c1..f0d7ee4c 100644
--- a/gently/harness/detection/queue.py
+++ b/gently/harness/detection/queue.py
@@ -3,14 +3,16 @@
 """
 
 import asyncio
-from typing import List, Dict, Optional, Callable
+from collections.abc import Callable
 from datetime import datetime
+
 import anthropic
 
 from gently.settings import settings
-from .detector import Detector, DetectionResult, ConfidenceLevel
-from .registry import DetectorRegistry
+
 from ..state import EmbryoState
+from .detector import ConfidenceLevel, DetectionResult, Detector
+from .registry import DetectorRegistry
 
 
 class DetectionQueue:
@@ -25,8 +27,8 @@ def __init__(
         registry: DetectorRegistry,
         claude_client: anthropic.Anthropic,
         model: str = settings.models.perception,
-        on_detection_callback: Optional[Callable] = None,
-        on_evaluation_callback: Optional[Callable] = None
+        on_detection_callback: Callable | None = None,
+        on_evaluation_callback: Callable | None = None,
     ):
         """
         Parameters
@@ -49,10 +51,8 @@ def __init__(
         self.on_evaluation_callback = on_evaluation_callback
 
     async def run_detectors(
-        self,
-        embryo_state: EmbryoState,
-        timepoint: int
-    ) -> List[DetectionResult]:
+        self, embryo_state: EmbryoState, timepoint: int
+    ) -> list[DetectionResult]:
         """
         Run all applicable detectors for an embryo/timepoint
 
@@ -80,9 +80,7 @@ async def run_detectors(
                 continue
 
             # Run detector
-            result = await self._run_single_detector(
-                detector, embryo_state, timepoint
-            )
+            result = await self._run_single_detector(detector, embryo_state, timepoint)
 
             results.append(result)
 
@@ -107,10 +105,7 @@ async def run_detectors(
         return results
 
     async def _run_single_detector(
-        self,
-        detector: Detector,
-        embryo_state: EmbryoState,
-        timepoint: int
+        self, detector: Detector, embryo_state: EmbryoState, timepoint: int
     ) -> DetectionResult:
         """
         Run a single detector
@@ -135,7 +130,9 @@ async def _run_single_detector(
         try:
             # Get recent images
             num_images = detector.temporal_context_size if detector.use_temporal_context else 1
-            recent_images = embryo_state.recent_images[-num_images:] if embryo_state.recent_images else []
+            recent_images = (
+                embryo_state.recent_images[-num_images:] if embryo_state.recent_images else []
+            )
 
             if not recent_images:
                 # No images available
@@ -146,15 +143,15 @@ async def _run_single_detector(
                     timestamp=datetime.now(),
                     detected=False,
                     error=True,
-                    error_message="No images available"
+                    error_message="No images available",
                 )
 
             # Build image data for detector
             image_data = [
                 {
-                    'timepoint': img.timepoint,
-                    'b64_image': img.max_projection_b64,
-                    'size': img.size_kb
+                    "timepoint": img.timepoint,
+                    "b64_image": img.max_projection_b64,
+                    "size": img.size_kb,
                 }
                 for img in recent_images
             ]
@@ -167,7 +164,7 @@ async def _run_single_detector(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=1024,
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             response_text = response.content[0].text
@@ -181,13 +178,13 @@ async def _run_single_detector(
                 embryo_id=embryo_id,
                 timepoint=timepoint,
                 timestamp=datetime.now(),
-                detected=parsed['detected'],
-                confidence=parsed['confidence'],
-                reasoning=parsed['reasoning'],
+                detected=parsed["detected"],
+                confidence=parsed["confidence"],
+                reasoning=parsed["reasoning"],
                 error=False,
                 api_duration=api_duration,
                 num_images=len(image_data),
-                full_response=response_text
+                full_response=response_text,
             )
 
         except Exception as e:
@@ -202,14 +199,10 @@ async def _run_single_detector(
                 detected=False,
                 error=True,
                 error_message=str(e),
-                api_duration=api_duration
+                api_duration=api_duration,
             )
 
-    def _meets_confidence_threshold(
-        self,
-        result: DetectionResult,
-        detector: Detector
-    ) -> bool:
+    def _meets_confidence_threshold(self, result: DetectionResult, detector: Detector) -> bool:
         """
         Check if detection result meets confidence threshold
 
@@ -232,7 +225,7 @@ def _meets_confidence_threshold(
         confidence_map = {
             ConfidenceLevel.LOW: 1,
             ConfidenceLevel.MEDIUM: 2,
-            ConfidenceLevel.HIGH: 3
+            ConfidenceLevel.HIGH: 3,
         }
 
         result_value = confidence_map.get(result.confidence, 0)
@@ -244,8 +237,8 @@ async def test_detector(
         self,
         detector_name: str,
         embryo_state: EmbryoState,
-        timepoint: Optional[int] = None
-    ) -> Optional[DetectionResult]:
+        timepoint: int | None = None,
+    ) -> DetectionResult | None:
         """
         Test a detector on a specific embryo/timepoint
 
@@ -280,7 +273,7 @@ async def test_detector(
 
         return result
 
-    def get_detection_summary(self, embryo_states: Dict[str, EmbryoState]) -> Dict:
+    def get_detection_summary(self, embryo_states: dict[str, EmbryoState]) -> dict:
         """
         Get summary of all detections across all embryos
 
@@ -294,48 +287,44 @@ def get_detection_summary(self, embryo_states: Dict[str, EmbryoState]) -> Dict:
         dict
             Summary of detections
         """
-        summary = {
-            'detectors': {},
-            'embryos': {}
-        }
+        summary = {"detectors": {}, "embryos": {}}
 
         # Per-detector summary
         for detector in self.registry.list_all():
             detector_summary = {
-                'name': detector.name,
-                'description': detector.description,
-                'enabled': detector.enabled,
-                'total_runs': detector.run_count,
-                'total_detections': detector.detection_count,
-                'embryos_detected': []
+                "name": detector.name,
+                "description": detector.description,
+                "enabled": detector.enabled,
+                "total_runs": detector.run_count,
+                "total_detections": detector.detection_count,
+                "embryos_detected": [],
             }
 
             for embryo_id, embryo_state in embryo_states.items():
                 if embryo_state.was_detected(detector.name):
                     latest = embryo_state.get_latest_detection(detector.name)
-                    detector_summary['embryos_detected'].append({
-                        'embryo_id': embryo_id,
-                        'timepoint': latest.get('timepoint'),
-                        'confidence': latest.get('confidence')
-                    })
+                    detector_summary["embryos_detected"].append(
+                        {
+                            "embryo_id": embryo_id,
+                            "timepoint": latest.get("timepoint"),
+                            "confidence": latest.get("confidence"),
+                        }
+                    )
 
-            summary['detectors'][detector.name] = detector_summary
+            summary["detectors"][detector.name] = detector_summary
 
         # Per-embryo summary
         for embryo_id, embryo_state in embryo_states.items():
-            embryo_summary = {
-                'embryo_id': embryo_id,
-                'detections': {}
-            }
+            embryo_summary = {"embryo_id": embryo_id, "detections": {}}
 
             for detector_name in embryo_state.detection_results.keys():
                 latest = embryo_state.get_latest_detection(detector_name)
-                embryo_summary['detections'][detector_name] = {
-                    'detected': latest.get('detected', False) if latest else False,
-                    'timepoint': latest.get('timepoint') if latest else None,
-                    'confidence': latest.get('confidence') if latest else None
+                embryo_summary["detections"][detector_name] = {
+                    "detected": latest.get("detected", False) if latest else False,
+                    "timepoint": latest.get("timepoint") if latest else None,
+                    "confidence": latest.get("confidence") if latest else None,
                 }
 
-            summary['embryos'][embryo_id] = embryo_summary
+            summary["embryos"][embryo_id] = embryo_summary
 
         return summary
diff --git a/gently/harness/detection/registry.py b/gently/harness/detection/registry.py
index e7da601f..64f920bb 100644
--- a/gently/harness/detection/registry.py
+++ b/gently/harness/detection/registry.py
@@ -2,15 +2,17 @@
 Detector registry for managing all configured detectors
 """
 
-import logging
 import json
-from pathlib import Path
-from typing import Dict, List, Optional
+import logging
 from datetime import datetime
+from pathlib import Path
 
 logger = logging.getLogger(__name__)
 
-from .detector import Detector, DetectorConditions, DetectorActions, DetectionMode, ConfidenceLevel
+from .detector import (  # noqa: E402
+    ConfidenceLevel,
+    Detector,
+)
 
 
 class DetectorRegistry:
@@ -20,14 +22,14 @@ class DetectorRegistry:
     Handles CRUD operations, persistence, and querying of detectors.
     """
 
-    def __init__(self, storage_path: Optional[Path] = None):
+    def __init__(self, storage_path: Path | None = None):
         """
         Parameters
         ----------
         storage_path : Path, optional
             Where to save detector registry JSON
         """
-        self.detectors: Dict[str, Detector] = {}
+        self.detectors: dict[str, Detector] = {}
         self.storage_path = storage_path or Path("./detector_registry.json")
 
         # Load existing detectors if file exists
@@ -76,15 +78,15 @@ def remove(self, name: str) -> bool:
         self.save()
         return True
 
-    def get(self, name: str) -> Optional[Detector]:
+    def get(self, name: str) -> Detector | None:
         """Get detector by name"""
         return self.detectors.get(name)
 
-    def list_all(self) -> List[Detector]:
+    def list_all(self) -> list[Detector]:
         """Get all detectors"""
         return list(self.detectors.values())
 
-    def list_enabled(self) -> List[Detector]:
+    def list_enabled(self) -> list[Detector]:
         """Get all enabled detectors"""
         return [d for d in self.detectors.values() if d.enabled]
 
@@ -162,7 +164,7 @@ def update(self, name: str, **kwargs) -> bool:
         self.save()
         return True
 
-    def get_stats(self) -> Dict:
+    def get_stats(self) -> dict:
         """
         Get registry statistics
 
@@ -177,34 +179,31 @@ def get_stats(self) -> Dict:
         total_runs = sum(d.run_count for d in self.detectors.values())
 
         return {
-            'total_detectors': total,
-            'enabled_detectors': enabled,
-            'disabled_detectors': total - enabled,
-            'total_detections_fired': total_detections,
-            'total_runs': total_runs,
-            'detectors': {
+            "total_detectors": total,
+            "enabled_detectors": enabled,
+            "disabled_detectors": total - enabled,
+            "total_detections_fired": total_detections,
+            "total_runs": total_runs,
+            "detectors": {
                 name: {
-                    'enabled': d.enabled,
-                    'detection_count': d.detection_count,
-                    'run_count': d.run_count
+                    "enabled": d.enabled,
+                    "detection_count": d.detection_count,
+                    "run_count": d.run_count,
                 }
                 for name, d in self.detectors.items()
-            }
+            },
         }
 
     def save(self):
         """Save registry to disk"""
         data = {
-            'version': '1.0',
-            'saved_at': datetime.now().isoformat(),
-            'detectors': {
-                name: detector.to_dict()
-                for name, detector in self.detectors.items()
-            }
+            "version": "1.0",
+            "saved_at": datetime.now().isoformat(),
+            "detectors": {name: detector.to_dict() for name, detector in self.detectors.items()},
         }
 
         self.storage_path.parent.mkdir(parents=True, exist_ok=True)
-        with open(self.storage_path, 'w') as f:
+        with open(self.storage_path, "w") as f:
             json.dump(data, f, indent=2)
 
     def load(self):
@@ -212,18 +211,18 @@ def load(self):
         if not self.storage_path.exists():
             return
 
-        with open(self.storage_path, 'r') as f:
+        with open(self.storage_path) as f:
             data = json.load(f)
 
         self.detectors = {}
-        for name, detector_data in data.get('detectors', {}).items():
+        for name, detector_data in data.get("detectors", {}).items():
             try:
                 detector = Detector.from_dict(detector_data)
                 self.detectors[name] = detector
             except Exception as e:
                 logger.warning("Failed to load detector '%s': %s", name, e)
 
-    def create_preset_detector(self, preset_name: str) -> Optional[Detector]:
+    def create_preset_detector(self, preset_name: str) -> Detector | None:
         """
         Create a detector from preset
 
@@ -243,12 +242,12 @@ def create_preset_detector(self, preset_name: str) -> Optional[Detector]:
 
         preset_data = presets[preset_name]
         detector = Detector(
-            name=preset_data['name'],
-            description=preset_data['description'],
-            detection_prompt=preset_data['prompt'],
-            use_temporal_context=preset_data.get('use_temporal_context', True),
-            temporal_context_size=preset_data.get('temporal_context_size', 5),
-            confidence_threshold=ConfidenceLevel(preset_data.get('confidence_threshold', 'MEDIUM')),
+            name=preset_data["name"],
+            description=preset_data["description"],
+            detection_prompt=preset_data["prompt"],
+            use_temporal_context=preset_data.get("use_temporal_context", True),
+            temporal_context_size=preset_data.get("temporal_context_size", 5),
+            confidence_threshold=ConfidenceLevel(preset_data.get("confidence_threshold", "MEDIUM")),
         )
 
         return detector
@@ -258,6 +257,7 @@ def create_preset_detector(self, preset_name: str) -> Optional[Detector]:
 def get_detector_presets():
     """Get detector presets from the active organism module."""
     from gently.organisms import get_organism
+
     org = get_organism()
     presets_module = __import__(
         f"gently.organisms.{org.ORGANISM_NAME}.detector_presets",
diff --git a/gently/harness/detection/verifier.py b/gently/harness/detection/verifier.py
index 26534842..0370abb7 100644
--- a/gently/harness/detection/verifier.py
+++ b/gently/harness/detection/verifier.py
@@ -12,17 +12,17 @@
 
 import asyncio
 import logging
-import re
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any
 
 import anthropic
 
+from gently.core import EventType, get_event_bus
 from gently.settings import settings
-from .detector import Detector, DetectionResult, ConfidenceLevel
+
 from ..state import EmbryoState
-from gently.core import EventType, get_event_bus
+from .detector import ConfidenceLevel, DetectionResult, Detector
 
 logger = logging.getLogger(__name__)
 
@@ -30,17 +30,19 @@
 @dataclass
 class AdversarialResult:
     """Result of adversarial verification strategy"""
+
     found_counter_evidence: bool
-    concerns: List[str]
-    confidence_in_original: Optional[ConfidenceLevel]
+    concerns: list[str]
+    confidence_in_original: ConfidenceLevel | None
     raw_response: str
 
 
 @dataclass
 class IndependentResult:
     """Result of independent verification strategy"""
+
     detected: bool
-    confidence: Optional[ConfidenceLevel]
+    confidence: ConfidenceLevel | None
     key_evidence: str
     raw_response: str
 
@@ -48,28 +50,31 @@ class IndependentResult:
 @dataclass
 class TemporalResult:
     """Result of temporal comparison strategy"""
+
     change_detected: bool
     description: str
-    confidence: Optional[ConfidenceLevel]
+    confidence: ConfidenceLevel | None
     raw_response: str
 
 
 @dataclass
 class EnsembleResult:
     """Result of ensemble voting strategy"""
+
     votes_yes: int
     votes_no: int
     total_votes: int
     agreement_ratio: float  # votes_yes / total_votes if detected, votes_no / total_votes if not
     consensus_detected: bool  # True if >70% agree on YES
-    raw_responses: List[str] = field(default_factory=list)
+    raw_responses: list[str] = field(default_factory=list)
 
 
 @dataclass
 class HardwareContextResult:
     """Result of hardware context analysis strategy"""
+
     suspicious: bool  # True if hardware errors could have caused false positive
-    concerns: List[str]  # Specific concerns identified
+    concerns: list[str]  # Specific concerns identified
     reasoning: str
     raw_response: str
 
@@ -77,15 +82,16 @@ class HardwareContextResult:
 @dataclass
 class VerificationResult:
     """Combined result of all verification strategies"""
+
     original_detected: bool
-    original_confidence: Optional[ConfidenceLevel]
+    original_confidence: ConfidenceLevel | None
 
     # Strategy results
     adversarial: AdversarialResult
     independent: IndependentResult
     temporal: TemporalResult
-    ensemble: Optional[EnsembleResult] = None  # Only for hatching detection
-    hardware_context: Optional[HardwareContextResult] = None  # Only when errors present
+    ensemble: EnsembleResult | None = None  # Only for hatching detection
+    hardware_context: HardwareContextResult | None = None  # Only when errors present
 
     # Consensus
     consensus: bool = False
@@ -95,44 +101,50 @@ class VerificationResult:
     timestamp: datetime = field(default_factory=datetime.now)
     verification_duration_seconds: float = 0.0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         """Serialize to dictionary"""
         result = {
-            'original_detected': self.original_detected,
-            'original_confidence': self.original_confidence.value if self.original_confidence else None,
-            'adversarial': {
-                'found_counter_evidence': self.adversarial.found_counter_evidence,
-                'concerns': self.adversarial.concerns,
-                'confidence_in_original': self.adversarial.confidence_in_original.value if self.adversarial.confidence_in_original else None,
+            "original_detected": self.original_detected,
+            "original_confidence": self.original_confidence.value
+            if self.original_confidence
+            else None,
+            "adversarial": {
+                "found_counter_evidence": self.adversarial.found_counter_evidence,
+                "concerns": self.adversarial.concerns,
+                "confidence_in_original": self.adversarial.confidence_in_original.value
+                if self.adversarial.confidence_in_original
+                else None,
             },
-            'independent': {
-                'detected': self.independent.detected,
-                'confidence': self.independent.confidence.value if self.independent.confidence else None,
-                'key_evidence': self.independent.key_evidence,
+            "independent": {
+                "detected": self.independent.detected,
+                "confidence": self.independent.confidence.value
+                if self.independent.confidence
+                else None,
+                "key_evidence": self.independent.key_evidence,
             },
-            'temporal': {
-                'change_detected': self.temporal.change_detected,
-                'description': self.temporal.description,
-                'confidence': self.temporal.confidence.value if self.temporal.confidence else None,
+            "temporal": {
+                "change_detected": self.temporal.change_detected,
+                "description": self.temporal.description,
+                "confidence": self.temporal.confidence.value if self.temporal.confidence else None,
             },
-            'consensus': self.consensus,
-            'consensus_reasoning': self.consensus_reasoning,
-            'timestamp': self.timestamp.isoformat(),
-            'verification_duration_seconds': self.verification_duration_seconds,
+            "consensus": self.consensus,
+            "consensus_reasoning": self.consensus_reasoning,
+            "timestamp": self.timestamp.isoformat(),
+            "verification_duration_seconds": self.verification_duration_seconds,
         }
         if self.ensemble:
-            result['ensemble'] = {
-                'votes_yes': self.ensemble.votes_yes,
-                'votes_no': self.ensemble.votes_no,
-                'total_votes': self.ensemble.total_votes,
-                'agreement_ratio': self.ensemble.agreement_ratio,
-                'consensus_detected': self.ensemble.consensus_detected,
+            result["ensemble"] = {
+                "votes_yes": self.ensemble.votes_yes,
+                "votes_no": self.ensemble.votes_no,
+                "total_votes": self.ensemble.total_votes,
+                "agreement_ratio": self.ensemble.agreement_ratio,
+                "consensus_detected": self.ensemble.consensus_detected,
             }
         if self.hardware_context:
-            result['hardware_context'] = {
-                'suspicious': self.hardware_context.suspicious,
-                'concerns': self.hardware_context.concerns,
-                'reasoning': self.hardware_context.reasoning,
+            result["hardware_context"] = {
+                "suspicious": self.hardware_context.suspicious,
+                "concerns": self.hardware_context.concerns,
+                "reasoning": self.hardware_context.reasoning,
             }
         return result
 
@@ -177,7 +189,7 @@ def __init__(
         self.ensemble_threshold = ensemble_threshold
         self._event_bus = event_bus or get_event_bus()
 
-    def _emit_event(self, event_type: EventType, data: Dict):
+    def _emit_event(self, event_type: EventType, data: dict):
         """Emit event to viz server"""
         if self._event_bus:
             self._event_bus.publish(event_type, data)
@@ -211,19 +223,13 @@ async def verify(
         start_time = datetime.now()
 
         # Run all strategies in parallel for speed
-        adversarial_task = self._run_adversarial(
-            detector, embryo_state, original_result, timepoint
-        )
-        independent_task = self._run_independent(
-            detector, embryo_state, timepoint
-        )
-        temporal_task = self._run_temporal_check(
-            detector, embryo_state, timepoint
-        )
+        adversarial_task = self._run_adversarial(detector, embryo_state, original_result, timepoint)
+        independent_task = self._run_independent(detector, embryo_state, timepoint)
+        temporal_task = self._run_temporal_check(detector, embryo_state, timepoint)
 
         # For hatching detection, also run ensemble voting
         ensemble_result = None
-        if detector.name == 'hatching':
+        if detector.name == "hatching":
             ensemble_task = self._run_ensemble_hatching(embryo_state)
             adversarial, independent, temporal, ensemble_result = await asyncio.gather(
                 adversarial_task, independent_task, temporal_task, ensemble_task
@@ -255,7 +261,11 @@ async def verify(
         logger.info(
             f"Verification complete for {detector.name}: "
             f"consensus={consensus}, duration={duration:.2f}s"
-            + (f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES" if ensemble_result else "")
+            + (
+                f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES"
+                if ensemble_result
+                else ""
+            )
         )
 
         return result
@@ -294,21 +304,15 @@ async def verify_with_context(
         start_time = datetime.now()
 
         # Run all strategies in parallel for speed
-        adversarial_task = self._run_adversarial(
-            detector, embryo_state, original_result, timepoint
-        )
-        independent_task = self._run_independent(
-            detector, embryo_state, timepoint
-        )
-        temporal_task = self._run_temporal_check(
-            detector, embryo_state, timepoint
-        )
+        adversarial_task = self._run_adversarial(detector, embryo_state, original_result, timepoint)
+        independent_task = self._run_independent(detector, embryo_state, timepoint)
+        temporal_task = self._run_temporal_check(detector, embryo_state, timepoint)
 
         # For hatching detection, also run ensemble voting
         ensemble_result = None
         hardware_result = None
 
-        if detector.name == 'hatching':
+        if detector.name == "hatching":
             ensemble_task = self._run_ensemble_hatching(embryo_state)
 
             # Run hardware context analysis if there are errors
@@ -316,11 +320,26 @@ async def verify_with_context(
                 hardware_task = self._run_hardware_context_analysis(
                     global_error_context, embryo_state.id
                 )
-                adversarial, independent, temporal, ensemble_result, hardware_result = await asyncio.gather(
-                    adversarial_task, independent_task, temporal_task, ensemble_task, hardware_task
+                (
+                    adversarial,
+                    independent,
+                    temporal,
+                    ensemble_result,
+                    hardware_result,
+                ) = await asyncio.gather(
+                    adversarial_task,
+                    independent_task,
+                    temporal_task,
+                    ensemble_task,
+                    hardware_task,
                 )
             else:
-                adversarial, independent, temporal, ensemble_result = await asyncio.gather(
+                (
+                    adversarial,
+                    independent,
+                    temporal,
+                    ensemble_result,
+                ) = await asyncio.gather(
                     adversarial_task, independent_task, temporal_task, ensemble_task
                 )
         else:
@@ -335,91 +354,151 @@ async def verify_with_context(
 
         # Adversarial result
         strategies_complete += 1
-        self._emit_event(EventType.VERIFICATION_STRATEGY, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'strategy': 'adversarial',
-            'passed': not adversarial.found_counter_evidence,
-            'summary': f"Counter-evidence: {'YES - ' + ', '.join(adversarial.concerns) if adversarial.found_counter_evidence else 'None found'}",
-            'confidence': adversarial.confidence_in_original.value if adversarial.confidence_in_original else None,
-        })
-        self._emit_event(EventType.VERIFICATION_PROGRESS, {
-            'embryo_id': embryo_id,
-            'strategies_complete': strategies_complete,
-            'total_strategies': total_strategies,
-        })
+        self._emit_event(
+            EventType.VERIFICATION_STRATEGY,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "strategy": "adversarial",
+                "passed": not adversarial.found_counter_evidence,
+                "summary": (
+                    "Counter-evidence: "
+                    + (
+                        "YES - " + ", ".join(adversarial.concerns)
+                        if adversarial.found_counter_evidence
+                        else "None found"
+                    )
+                ),
+                "confidence": adversarial.confidence_in_original.value
+                if adversarial.confidence_in_original
+                else None,
+            },
+        )
+        self._emit_event(
+            EventType.VERIFICATION_PROGRESS,
+            {
+                "embryo_id": embryo_id,
+                "strategies_complete": strategies_complete,
+                "total_strategies": total_strategies,
+            },
+        )
 
         # Independent result
         strategies_complete += 1
-        self._emit_event(EventType.VERIFICATION_STRATEGY, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'strategy': 'independent',
-            'passed': independent.detected,
-            'summary': f"Independent detection: {'YES' if independent.detected else 'NO'} - {independent.key_evidence}",
-            'confidence': independent.confidence.value if independent.confidence else None,
-        })
-        self._emit_event(EventType.VERIFICATION_PROGRESS, {
-            'embryo_id': embryo_id,
-            'strategies_complete': strategies_complete,
-            'total_strategies': total_strategies,
-        })
+        self._emit_event(
+            EventType.VERIFICATION_STRATEGY,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "strategy": "independent",
+                "passed": independent.detected,
+                "summary": (
+                    f"Independent detection: {'YES' if independent.detected else 'NO'}"
+                    f" - {independent.key_evidence}"
+                ),
+                "confidence": independent.confidence.value if independent.confidence else None,
+            },
+        )
+        self._emit_event(
+            EventType.VERIFICATION_PROGRESS,
+            {
+                "embryo_id": embryo_id,
+                "strategies_complete": strategies_complete,
+                "total_strategies": total_strategies,
+            },
+        )
 
         # Temporal result
         strategies_complete += 1
-        self._emit_event(EventType.VERIFICATION_STRATEGY, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'strategy': 'temporal',
-            'passed': temporal.change_detected,
-            'summary': f"Change detected: {'YES' if temporal.change_detected else 'NO'} - {temporal.description}",
-            'confidence': temporal.confidence.value if temporal.confidence else None,
-        })
-        self._emit_event(EventType.VERIFICATION_PROGRESS, {
-            'embryo_id': embryo_id,
-            'strategies_complete': strategies_complete,
-            'total_strategies': total_strategies,
-        })
+        self._emit_event(
+            EventType.VERIFICATION_STRATEGY,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "strategy": "temporal",
+                "passed": temporal.change_detected,
+                "summary": (
+                    f"Change detected: {'YES' if temporal.change_detected else 'NO'}"
+                    f" - {temporal.description}"
+                ),
+                "confidence": temporal.confidence.value if temporal.confidence else None,
+            },
+        )
+        self._emit_event(
+            EventType.VERIFICATION_PROGRESS,
+            {
+                "embryo_id": embryo_id,
+                "strategies_complete": strategies_complete,
+                "total_strategies": total_strategies,
+            },
+        )
 
         # Ensemble result (if applicable)
         if ensemble_result:
             strategies_complete += 1
-            self._emit_event(EventType.VERIFICATION_STRATEGY, {
-                'embryo_id': embryo_id,
-                'detector_name': detector.name,
-                'strategy': 'ensemble',
-                'passed': ensemble_result.consensus_detected,
-                'summary': f"Ensemble vote: {ensemble_result.votes_yes}/{ensemble_result.total_votes} YES ({ensemble_result.agreement_ratio*100:.0f}%)",
-                'votes_yes': ensemble_result.votes_yes,
-                'votes_no': ensemble_result.votes_no,
-                'total_votes': ensemble_result.total_votes,
-            })
-            self._emit_event(EventType.VERIFICATION_PROGRESS, {
-                'embryo_id': embryo_id,
-                'strategies_complete': strategies_complete,
-                'total_strategies': total_strategies,
-            })
+            self._emit_event(
+                EventType.VERIFICATION_STRATEGY,
+                {
+                    "embryo_id": embryo_id,
+                    "detector_name": detector.name,
+                    "strategy": "ensemble",
+                    "passed": ensemble_result.consensus_detected,
+                    "summary": (
+                        f"Ensemble vote: {ensemble_result.votes_yes}/{ensemble_result.total_votes}"
+                        f" YES ({ensemble_result.agreement_ratio * 100:.0f}%)"
+                    ),
+                    "votes_yes": ensemble_result.votes_yes,
+                    "votes_no": ensemble_result.votes_no,
+                    "total_votes": ensemble_result.total_votes,
+                },
+            )
+            self._emit_event(
+                EventType.VERIFICATION_PROGRESS,
+                {
+                    "embryo_id": embryo_id,
+                    "strategies_complete": strategies_complete,
+                    "total_strategies": total_strategies,
+                },
+            )
 
         # Hardware context result (if applicable)
         if hardware_result:
             strategies_complete += 1
-            self._emit_event(EventType.VERIFICATION_STRATEGY, {
-                'embryo_id': embryo_id,
-                'detector_name': detector.name,
-                'strategy': 'hardware_context',
-                'passed': not hardware_result.suspicious,
-                'summary': f"Hardware errors suspicious: {'YES - ' + ', '.join(hardware_result.concerns) if hardware_result.suspicious else 'No'}",
-                'reasoning': hardware_result.reasoning,
-            })
-            self._emit_event(EventType.VERIFICATION_PROGRESS, {
-                'embryo_id': embryo_id,
-                'strategies_complete': strategies_complete,
-                'total_strategies': total_strategies,
-            })
+            self._emit_event(
+                EventType.VERIFICATION_STRATEGY,
+                {
+                    "embryo_id": embryo_id,
+                    "detector_name": detector.name,
+                    "strategy": "hardware_context",
+                    "passed": not hardware_result.suspicious,
+                    "summary": (
+                        "Hardware errors suspicious: "
+                        + (
+                            "YES - " + ", ".join(hardware_result.concerns)
+                            if hardware_result.suspicious
+                            else "No"
+                        )
+                    ),
+                    "reasoning": hardware_result.reasoning,
+                },
+            )
+            self._emit_event(
+                EventType.VERIFICATION_PROGRESS,
+                {
+                    "embryo_id": embryo_id,
+                    "strategies_complete": strategies_complete,
+                    "total_strategies": total_strategies,
+                },
+            )
 
         # Determine consensus (with hardware context)
         consensus, reasoning = self._evaluate_consensus_with_hardware(
-            original_result, adversarial, independent, temporal, ensemble_result, hardware_result
+            original_result,
+            adversarial,
+            independent,
+            temporal,
+            ensemble_result,
+            hardware_result,
         )
 
         duration = (datetime.now() - start_time).total_seconds()
@@ -440,26 +519,37 @@ async def verify_with_context(
         logger.info(
             f"Verification (with context) complete for {detector.name}: "
             f"consensus={consensus}, duration={duration:.2f}s"
-            + (f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES" if ensemble_result else "")
+            + (
+                f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES"
+                if ensemble_result
+                else ""
+            )
             + (f", hardware_suspicious={hardware_result.suspicious}" if hardware_result else "")
         )
 
         # Emit VERIFICATION_COMPLETED event with full summary
-        self._emit_event(EventType.VERIFICATION_COMPLETED, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'consensus': consensus,
-            'reasoning': reasoning,
-            'duration_seconds': duration,
-            'strategies': {
-                'adversarial': not adversarial.found_counter_evidence,
-                'independent': independent.detected,
-                'temporal': temporal.change_detected,
-                'ensemble': ensemble_result.consensus_detected if ensemble_result else None,
-                'hardware_context': (not hardware_result.suspicious) if hardware_result else None,
+        self._emit_event(
+            EventType.VERIFICATION_COMPLETED,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "consensus": consensus,
+                "reasoning": reasoning,
+                "duration_seconds": duration,
+                "strategies": {
+                    "adversarial": not adversarial.found_counter_evidence,
+                    "independent": independent.detected,
+                    "temporal": temporal.change_detected,
+                    "ensemble": ensemble_result.consensus_detected if ensemble_result else None,
+                    "hardware_context": (not hardware_result.suspicious)
+                    if hardware_result
+                    else None,
+                },
+                "ensemble_votes": f"{ensemble_result.votes_yes}/{ensemble_result.total_votes}"
+                if ensemble_result
+                else None,
             },
-            'ensemble_votes': f"{ensemble_result.votes_yes}/{ensemble_result.total_votes}" if ensemble_result else None,
-        })
+        )
 
         return result
 
@@ -487,7 +577,8 @@ async def _run_hardware_context_analysis(
             Analysis result
         """
         try:
-            prompt = f"""You are analyzing hardware error context for a microscopy detection verification.
+            prompt = f"""You are analyzing hardware error context for a microscopy detection
+verification.
 
 GLOBAL ERROR LOG:
 {global_error_context}
@@ -500,10 +591,12 @@ async def _run_hardware_context_analysis(
 - Stage positioning errors could cause wrong embryo to be imaged
 - Acquisition timeouts could cause partial/blank images (blank images look like empty FOV = hatched)
 - Camera errors could produce corrupted data
-- Errors on OTHER embryos in the same round could indicate systemic issues (stage drift, hardware instability)
+- Errors on OTHER embryos in the same round could indicate systemic issues
+  (stage drift, hardware instability)
 - Multiple errors in quick succession suggests hardware problems
 
-If ANY errors occurred that could have affected the image quality or positioning for {embryo_id}, report as SUSPICIOUS.
+If ANY errors occurred that could have affected the image quality or positioning for
+{embryo_id}, report as SUSPICIOUS.
 
 Respond in EXACTLY this format:
 SUSPICIOUS: [YES/NO]
@@ -515,7 +608,7 @@ async def _run_hardware_context_analysis(
                 self.claude.messages.create,
                 model=self.ensemble_model,  # Use Haiku for speed
                 max_tokens=300,
-                messages=[{"role": "user", "content": prompt}]
+                messages=[{"role": "user", "content": prompt}],
             )
 
             response_text = response.content[0].text
@@ -536,16 +629,16 @@ def _parse_hardware_context_response(self, response: str) -> HardwareContextResu
         concerns = []
         reasoning = ""
 
-        for line in response.split('\n'):
+        for line in response.split("\n"):
             line = line.strip()
-            if line.startswith('SUSPICIOUS:'):
-                value = line.split(':', 1)[1].strip().upper()
-                suspicious = value == 'YES'
-            elif line.startswith('CONCERNS:'):
-                concerns_str = line.split(':', 1)[1].strip()
-                concerns = [c.strip() for c in concerns_str.split(';') if c.strip()]
-            elif line.startswith('REASONING:'):
-                reasoning = line.split(':', 1)[1].strip()
+            if line.startswith("SUSPICIOUS:"):
+                value = line.split(":", 1)[1].strip().upper()
+                suspicious = value == "YES"
+            elif line.startswith("CONCERNS:"):
+                concerns_str = line.split(":", 1)[1].strip()
+                concerns = [c.strip() for c in concerns_str.split(";") if c.strip()]
+            elif line.startswith("REASONING:"):
+                reasoning = line.split(":", 1)[1].strip()
 
         return HardwareContextResult(
             suspicious=suspicious,
@@ -560,8 +653,8 @@ def _evaluate_consensus_with_hardware(
         adversarial: AdversarialResult,
         independent: IndependentResult,
         temporal: TemporalResult,
-        ensemble: Optional[EnsembleResult] = None,
-        hardware_context: Optional[HardwareContextResult] = None,
+        ensemble: EnsembleResult | None = None,
+        hardware_context: HardwareContextResult | None = None,
     ) -> tuple[bool, str]:
         """
         Evaluate consensus across all verification strategies including hardware context.
@@ -577,7 +670,9 @@ def _evaluate_consensus_with_hardware(
         if not adversarial.found_counter_evidence:
             agreements += 1
         else:
-            disagreements.append(f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}")
+            disagreements.append(
+                f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}"
+            )
 
         # Check independent: should also detect
         if independent.detected:
@@ -617,12 +712,19 @@ def _evaluate_consensus_with_hardware(
         consensus = agreements == total_strategies
 
         if consensus:
-            parts = ["no counter-evidence found", "independent analysis confirms", "temporal change observed"]
+            parts = [
+                "no counter-evidence found",
+                "independent analysis confirms",
+                "temporal change observed",
+            ]
             if ensemble:
                 parts.append(f"ensemble confirms ({ensemble.votes_yes}/{ensemble.total_votes} YES)")
             if hardware_context:
                 parts.append("no hardware error concerns")
-            reasoning = f"All verification strategies agree ({total_strategies}/{total_strategies}): " + ", ".join(parts)
+            reasoning = (
+                f"All verification strategies agree ({total_strategies}/{total_strategies}): "
+                + ", ".join(parts)
+            )
         else:
             reasoning = (
                 f"Verification disagreement ({agreements}/{total_strategies} agree): "
@@ -656,7 +758,7 @@ async def _run_adversarial(
                 )
 
             # Build detector-specific critical review guidance
-            if detector.name == 'hatching':
+            if detector.name == "hatching":
                 specific_guidance = """
 For HATCHING specifically, look for these common FALSE POSITIVE patterns:
 - Is the worm still COILED/PRETZEL-SHAPED inside the eggshell?
@@ -669,11 +771,12 @@ async def _run_adversarial(
             else:
                 specific_guidance = ""
 
-            prompt = f"""You are reviewing a detection result for a C. elegans embryo (diSPIM max projection).
+            prompt = f"""You are reviewing a detection result for a C. elegans embryo
+(diSPIM max projection).
 
 The system detected: {detector.name}
-Original confidence: {original_result.confidence.value if original_result.confidence else 'unknown'}
-Original reasoning: {original_result.reasoning or 'not provided'}
+Original confidence: {original_result.confidence.value if original_result.confidence else "unknown"}
+Original reasoning: {original_result.reasoning or "not provided"}
 
 NOW ACT AS A CRITICAL REVIEWER. Your job is to find reasons why this detection might be INCORRECT:
 - Could this be a false positive?
@@ -693,7 +796,7 @@ async def _run_adversarial(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=500,
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             response_text = response.content[0].text
@@ -732,7 +835,7 @@ async def _run_independent(
                 )
 
             # Build detector-specific criteria
-            if detector.name == 'hatching':
+            if detector.name == "hatching":
                 criteria = """
 TRUE HATCHING criteria (must meet at least one):
 - Worm body is OUTSIDE the eggshell boundary (free-floating, elongated)
@@ -746,7 +849,8 @@ async def _run_independent(
                 criteria = detector.description
 
             # Use a neutral prompt that doesn't reveal the previous detection
-            prompt = f"""Analyze this C. elegans embryo image (diSPIM max projection) at timepoint {timepoint}.
+            prompt = f"""Analyze this C. elegans embryo image (diSPIM max projection) at
+timepoint {timepoint}.
 
 Question: Has '{detector.name}' occurred in this embryo?
 
@@ -767,7 +871,7 @@ async def _run_independent(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=400,
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             response_text = response.content[0].text
@@ -811,14 +915,16 @@ async def _run_temporal_check(
             prev_images = []
             for img in embryo_state.recent_images[-3:-1]:
                 if img.max_projection_b64:
-                    prev_images.append({
-                        "type": "image",
-                        "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": img.max_projection_b64,
+                    prev_images.append(
+                        {
+                            "type": "image",
+                            "source": {
+                                "type": "base64",
+                                "media_type": "image/png",
+                                "data": img.max_projection_b64,
+                            },
                         }
-                    })
+                    )
 
             if not prev_images:
                 return TemporalResult(
@@ -829,7 +935,7 @@ async def _run_temporal_check(
                 )
 
             # Build detector-specific temporal criteria
-            if detector.name == 'hatching':
+            if detector.name == "hatching":
                 temporal_criteria = """For HATCHING, look for:
 - A visible BREACH appearing in the eggshell boundary (not just expansion)
 - The worm physically EXITING the shell (part of body moves outside)
@@ -841,10 +947,11 @@ async def _run_temporal_check(
 - Not just a static state that could have existed before
 - Clear evidence of progression or event occurrence"""
 
-            prompt = f"""Compare these sequential timepoints of a C. elegans embryo (diSPIM max projection).
+            prompt = f"""Compare these sequential timepoints of a C. elegans embryo
+(diSPIM max projection).
 
 PREVIOUS TIMEPOINTS (shown first):
-These are from t={timepoint-2} to t={timepoint-1}
+These are from t={timepoint - 2} to t={timepoint - 1}
 
 CURRENT TIMEPOINT (shown last):
 This is t={timepoint}
@@ -866,7 +973,7 @@ async def _run_temporal_check(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=400,
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             response_text = response.content[0].text
@@ -881,25 +988,23 @@ async def _run_temporal_check(
                 raw_response="",
             )
 
-    def _get_image_content(
-        self,
-        embryo_state: EmbryoState,
-        num_images: int = 1
-    ) -> List[Dict]:
+    def _get_image_content(self, embryo_state: EmbryoState, num_images: int = 1) -> list[dict]:
         """Get image content blocks for Claude API"""
         images = []
         recent = embryo_state.recent_images[-num_images:] if embryo_state.recent_images else []
 
         for img in recent:
             if img.max_projection_b64:
-                images.append({
-                    "type": "image",
-                    "source": {
-                        "type": "base64",
-                        "media_type": "image/png",
-                        "data": img.max_projection_b64,
+                images.append(
+                    {
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": "image/png",
+                            "data": img.max_projection_b64,
+                        },
                     }
-                })
+                )
 
         return images
 
@@ -933,8 +1038,10 @@ async def _run_ensemble_hatching(self, embryo_state: EmbryoState) -> EnsembleRes
 
 Answer ONE question: Has the embryo HATCHED?
 
-HATCHED means: The worm body is OUTSIDE the eggshell (free-floating, elongated, or field is empty because worm left).
-NOT HATCHED means: The worm is still INSIDE the eggshell (coiled/pretzel-shaped, even if shell looks expanded).
+HATCHED means: The worm body is OUTSIDE the eggshell (free-floating, elongated, or field is
+empty because worm left).
+NOT HATCHED means: The worm is still INSIDE the eggshell (coiled/pretzel-shaped, even if
+shell looks expanded).
 
 Respond with ONLY: YES or NO"""
 
@@ -946,7 +1053,7 @@ async def single_vote() -> str:
                         self.claude.messages.create,
                         model=self.ensemble_model,
                         max_tokens=10,  # Very short response expected
-                        messages=[{"role": "user", "content": content}]
+                        messages=[{"role": "user", "content": content}],
                     )
                     return response.content[0].text.strip().upper()
                 except Exception as e:
@@ -954,7 +1061,10 @@ async def single_vote() -> str:
                     return "ERROR"
 
             # Run all votes in parallel
-            logger.info(f"[ENSEMBLE] Running {self.ensemble_size} parallel Haiku calls for hatching verification")
+            logger.info(
+                f"[ENSEMBLE] Running {self.ensemble_size} parallel Haiku calls"
+                " for hatching verification"
+            )
             tasks = [single_vote() for _ in range(self.ensemble_size)]
             responses = await asyncio.gather(*tasks)
 
@@ -1009,16 +1119,16 @@ def _parse_adversarial_response(self, response: str) -> AdversarialResult:
         concerns = []
         confidence = None
 
-        for line in response.split('\n'):
+        for line in response.split("\n"):
             line = line.strip()
-            if line.startswith('COUNTER_EVIDENCE_FOUND:'):
-                value = line.split(':', 1)[1].strip().upper()
-                found_counter = value == 'YES'
-            elif line.startswith('CONCERNS:'):
-                concerns_str = line.split(':', 1)[1].strip()
-                concerns = [c.strip() for c in concerns_str.split(';') if c.strip()]
-            elif line.startswith('CONFIDENCE_IN_ORIGINAL:'):
-                value = line.split(':', 1)[1].strip().upper()
+            if line.startswith("COUNTER_EVIDENCE_FOUND:"):
+                value = line.split(":", 1)[1].strip().upper()
+                found_counter = value == "YES"
+            elif line.startswith("CONCERNS:"):
+                concerns_str = line.split(":", 1)[1].strip()
+                concerns = [c.strip() for c in concerns_str.split(";") if c.strip()]
+            elif line.startswith("CONFIDENCE_IN_ORIGINAL:"):
+                value = line.split(":", 1)[1].strip().upper()
                 try:
                     confidence = ConfidenceLevel(value)
                 except ValueError:
@@ -1037,19 +1147,19 @@ def _parse_independent_response(self, response: str) -> IndependentResult:
         confidence = None
         evidence = ""
 
-        for line in response.split('\n'):
+        for line in response.split("\n"):
             line = line.strip()
-            if line.startswith('DETECTED:'):
-                value = line.split(':', 1)[1].strip().upper()
-                detected = value == 'YES'
-            elif line.startswith('CONFIDENCE:'):
-                value = line.split(':', 1)[1].strip().upper()
+            if line.startswith("DETECTED:"):
+                value = line.split(":", 1)[1].strip().upper()
+                detected = value == "YES"
+            elif line.startswith("CONFIDENCE:"):
+                value = line.split(":", 1)[1].strip().upper()
                 try:
                     confidence = ConfidenceLevel(value)
                 except ValueError:
                     pass
-            elif line.startswith('KEY_EVIDENCE:'):
-                evidence = line.split(':', 1)[1].strip()
+            elif line.startswith("KEY_EVIDENCE:"):
+                evidence = line.split(":", 1)[1].strip()
 
         return IndependentResult(
             detected=detected,
@@ -1064,15 +1174,15 @@ def _parse_temporal_response(self, response: str) -> TemporalResult:
         description = ""
         confidence = None
 
-        for line in response.split('\n'):
+        for line in response.split("\n"):
             line = line.strip()
-            if line.startswith('CHANGE_DETECTED:'):
-                value = line.split(':', 1)[1].strip().upper()
-                change_detected = value == 'YES'
-            elif line.startswith('DESCRIPTION:'):
-                description = line.split(':', 1)[1].strip()
-            elif line.startswith('CONFIDENCE:'):
-                value = line.split(':', 1)[1].strip().upper()
+            if line.startswith("CHANGE_DETECTED:"):
+                value = line.split(":", 1)[1].strip().upper()
+                change_detected = value == "YES"
+            elif line.startswith("DESCRIPTION:"):
+                description = line.split(":", 1)[1].strip()
+            elif line.startswith("CONFIDENCE:"):
+                value = line.split(":", 1)[1].strip().upper()
                 try:
                     confidence = ConfidenceLevel(value)
                 except ValueError:
@@ -1091,7 +1201,7 @@ def _evaluate_consensus(
         adversarial: AdversarialResult,
         independent: IndependentResult,
         temporal: TemporalResult,
-        ensemble: Optional[EnsembleResult] = None,
+        ensemble: EnsembleResult | None = None,
     ) -> tuple[bool, str]:
         """
         Evaluate consensus across all verification strategies.
@@ -1107,7 +1217,9 @@ def _evaluate_consensus(
         if not adversarial.found_counter_evidence:
             agreements += 1
         else:
-            disagreements.append(f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}")
+            disagreements.append(
+                f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}"
+            )
 
         # Check independent: should also detect
         if independent.detected:
@@ -1141,13 +1253,14 @@ def _evaluate_consensus(
                     f"All verification strategies agree ({total_strategies}/{total_strategies}): "
                     f"no counter-evidence found, independent analysis confirms detection, "
                     f"temporal change observed, ensemble voting confirms "
-                    f"({ensemble.votes_yes}/{ensemble.total_votes} = {ensemble.agreement_ratio:.0%} YES)."
+                    f"({ensemble.votes_yes}/{ensemble.total_votes}"
+                    f" = {ensemble.agreement_ratio:.0%} YES)."
                 )
             else:
                 reasoning = (
-                    f"All verification strategies agree: "
-                    f"no counter-evidence found, independent analysis confirms detection, "
-                    f"temporal change observed."
+                    "All verification strategies agree: "
+                    "no counter-evidence found, independent analysis confirms detection, "
+                    "temporal change observed."
                 )
         else:
             reasoning = (
diff --git a/gently/harness/error_log.py b/gently/harness/error_log.py
index 4b741e57..9b2b228f 100644
--- a/gently/harness/error_log.py
+++ b/gently/harness/error_log.py
@@ -6,9 +6,8 @@
 """
 
 import logging
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from datetime import datetime
-from typing import Dict, List, Optional
 
 logger = logging.getLogger(__name__)
 
@@ -16,13 +15,14 @@
 @dataclass
 class ErrorEntry:
     """Single error entry in the global log"""
+
     timestamp: datetime
     round_number: int
     embryo_id: str
     timepoint: int
     error_type: str
     message: str
-    exception: Optional[Exception] = None
+    exception: Exception | None = None
 
 
 class GlobalErrorLog:
@@ -40,7 +40,7 @@ def __init__(self, max_entries: int = 100):
         max_entries : int
             Maximum number of entries to keep (oldest are dropped)
         """
-        self._entries: List[ErrorEntry] = []
+        self._entries: list[ErrorEntry] = []
         self._max_entries = max_entries
 
     def log_error(
@@ -50,7 +50,7 @@ def log_error(
         timepoint: int,
         error_type: str,
         message: str,
-        exception: Optional[Exception] = None,
+        exception: Exception | None = None,
     ):
         """
         Log an error during timelapse acquisition.
@@ -84,22 +84,20 @@ def log_error(
 
         # Trim old entries
         if len(self._entries) > self._max_entries:
-            self._entries = self._entries[-self._max_entries:]
+            self._entries = self._entries[-self._max_entries :]
 
         # Also log to standard logger
-        logger.warning(
-            f"[{error_type}] Round {round_number}, {embryo_id} t{timepoint}: {message}"
-        )
+        logger.warning(f"[{error_type}] Round {round_number}, {embryo_id} t{timepoint}: {message}")
 
-    def get_recent_errors(self, limit: int = 10) -> List[ErrorEntry]:
+    def get_recent_errors(self, limit: int = 10) -> list[ErrorEntry]:
         """Get most recent errors"""
         return self._entries[-limit:]
 
-    def get_errors_for_embryo(self, embryo_id: str) -> List[ErrorEntry]:
+    def get_errors_for_embryo(self, embryo_id: str) -> list[ErrorEntry]:
         """Get all errors for a specific embryo"""
         return [e for e in self._entries if e.embryo_id == embryo_id]
 
-    def get_errors_in_round(self, round_number: int) -> List[ErrorEntry]:
+    def get_errors_in_round(self, round_number: int) -> list[ErrorEntry]:
         """Get all errors from a specific round"""
         return [e for e in self._entries if e.round_number == round_number]
 
diff --git a/gently/harness/memory/__init__.py b/gently/harness/memory/__init__.py
index 3d76b540..ce9083c0 100644
--- a/gently/harness/memory/__init__.py
+++ b/gently/harness/memory/__init__.py
@@ -13,43 +13,50 @@
 """
 
 from .model import (
+    Attention,
+    BenchSpec,
     Campaign,
-    Project,
-    SessionIntent,
-    PlannedSession,
-    PlanItem,
-    PlanItemStatus,
-    PlanItemType,
+    Confidence,
+    Context,
+    ContextUpdates,
+    EmbryoUnderstanding,
+    Expectation,
+    ExpectationStatus,
     ImagingSpec,
-    BenchSpec,
+    Intentions,
     Learning,
     Observation,
-    Expectation,
-    Watchpoint,
+    PlanItem,
+    PlanItemStatus,
+    PlanItemType,
+    PlannedSession,
+    PlannedSessionStatus,
+    Project,
     Question,
-    EmbryoUnderstanding,
-    Intentions,
-    Understanding,
-    Attention,
-    Context,
-    ContextUpdates,
+    QuestionStatus,
+    SessionIntent,
     # Enums
     Significance,
-    Confidence,
     Status,
-    PlannedSessionStatus,
-    ExpectationStatus,
+    Understanding,
+    Watchpoint,
     WatchpointStatus,
-    QuestionStatus,
 )
-from .store import ContextStore  # legacy SQLite store (read-only, replaced by FileContextStore)
+from .store import (
+    ContextStore,
+)
+
 try:
     from .file_store import FileContextStore
 except ImportError:
     FileContextStore = None
-from .serialization import context_to_dict, context_to_json, context_summary
-from .gap_assessment import assess_gaps, ContextGapReport, Gap, GapLayer, GapSeverity
-from .onboarding import generate_onboarding_messages, process_onboarding_response, OnboardingMessage
+from .gap_assessment import ContextGapReport, Gap, GapLayer, GapSeverity, assess_gaps
+from .onboarding import (
+    OnboardingMessage,
+    generate_onboarding_messages,
+    process_onboarding_response,
+)
+from .serialization import context_summary, context_to_dict, context_to_json
 from .startup_wizard import StartupWizard
 
 __all__ = [
diff --git a/gently/harness/memory/_intentions.py b/gently/harness/memory/_intentions.py
index 0de5e540..de1e4e59 100644
--- a/gently/harness/memory/_intentions.py
+++ b/gently/harness/memory/_intentions.py
@@ -9,7 +9,7 @@
 import logging
 import sqlite3
 from datetime import datetime
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from .model import (
     Campaign,
@@ -47,11 +47,11 @@ def _load_intentions(self) -> Intentions:
     def create_campaign(
         self,
         description: str,
-        shorthand: Optional[str] = None,
-        summary: Optional[str] = None,
-        target: Optional[str] = None,
-        parent_id: Optional[str] = None,
-        campaign_id: Optional[str] = None,
+        shorthand: str | None = None,
+        summary: str | None = None,
+        target: str | None = None,
+        parent_id: str | None = None,
+        campaign_id: str | None = None,
     ) -> str:
         """Create a new campaign. Returns campaign ID."""
         cid = campaign_id or self._gen_id()
@@ -59,7 +59,8 @@ def create_campaign(
         with self._tx():
             self._conn.execute(
                 "INSERT INTO campaigns "
-                "(id, description, shorthand, summary, target, parent_id, status, created_at, updated_at) "
+                "(id, description, shorthand, summary, target, parent_id,"
+                " status, created_at, updated_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?)",
                 (cid, description, shorthand, summary, target, parent_id, now, now),
             )
@@ -67,7 +68,7 @@ def create_campaign(
         logger.info(f"Created campaign {cid} [{label}]")
         return cid
 
-    def get_active_campaigns(self) -> List[Campaign]:
+    def get_active_campaigns(self) -> list[Campaign]:
         """Get all active campaigns."""
         rows = self._conn.execute(
             "SELECT * FROM campaigns WHERE status = 'active' ORDER BY created_at DESC"
@@ -83,12 +84,10 @@ def count_non_active_campaigns(self) -> int:
 
     def count_session_intents(self) -> int:
         """Count total session intent records."""
-        row = self._conn.execute(
-            "SELECT COUNT(*) as cnt FROM session_intents"
-        ).fetchone()
+        row = self._conn.execute("SELECT COUNT(*) as cnt FROM session_intents").fetchone()
         return row["cnt"] if row else 0
 
-    def get_all_campaigns(self, limit: int = 50) -> List[Campaign]:
+    def get_all_campaigns(self, limit: int = 50) -> list[Campaign]:
         """Get all campaigns regardless of status, ordered by created_at descending."""
         rows = self._conn.execute(
             "SELECT * FROM campaigns ORDER BY created_at DESC LIMIT ?",
@@ -96,7 +95,7 @@ def get_all_campaigns(self, limit: int = 50) -> List[Campaign]:
         ).fetchall()
         return [self._row_to_campaign(row) for row in rows]
 
-    def get_recent_session_intents(self, limit: int = 50) -> List["SessionIntent"]:
+    def get_recent_session_intents(self, limit: int = 50) -> list["SessionIntent"]:
         """Get recent session intents, ordered by created_at descending."""
         rows = self._conn.execute(
             "SELECT * FROM session_intents ORDER BY created_at DESC LIMIT ?",
@@ -107,24 +106,26 @@ def get_recent_session_intents(self, limit: int = 50) -> List["SessionIntent"]:
             d = dict(row)
             sid = d["session_id"]
             campaign_ids = self.get_campaign_ids_for_session(sid)
-            results.append(SessionIntent(
-                session_id=sid,
-                planned_intent=d.get("planned_intent"),
-                actual_summary=d.get("actual_summary"),
-                campaign_ids=campaign_ids,
-                created_at=datetime.fromisoformat(d["created_at"]),
-                completed_at=datetime.fromisoformat(d["completed_at"]) if d.get("completed_at") else None,
-            ))
+            results.append(
+                SessionIntent(
+                    session_id=sid,
+                    planned_intent=d.get("planned_intent"),
+                    actual_summary=d.get("actual_summary"),
+                    campaign_ids=campaign_ids,
+                    created_at=datetime.fromisoformat(d["created_at"]),
+                    completed_at=datetime.fromisoformat(d["completed_at"])
+                    if d.get("completed_at")
+                    else None,
+                )
+            )
         return results
 
-    def get_campaign(self, campaign_id: str) -> Optional[Campaign]:
+    def get_campaign(self, campaign_id: str) -> Campaign | None:
         """Get a specific campaign by exact ID."""
-        row = self._conn.execute(
-            "SELECT * FROM campaigns WHERE id = ?", (campaign_id,)
-        ).fetchone()
+        row = self._conn.execute("SELECT * FROM campaigns WHERE id = ?", (campaign_id,)).fetchone()
         return self._row_to_campaign(row) if row else None
 
-    def resolve_campaign(self, ref: str) -> Optional[Campaign]:
+    def resolve_campaign(self, ref: str) -> Campaign | None:
         """Resolve a campaign by UUID, shorthand, UUID prefix, or description.
 
         Tries exact ID first, then falls back to _resolve_campaign_label
@@ -159,7 +160,7 @@ def update_campaign_status(self, campaign_id: str, status: Status):
                 (status.value, now, campaign_id),
             )
 
-    def delete_campaign(self, campaign_id: str, cascade: bool = True) -> Dict[str, int]:
+    def delete_campaign(self, campaign_id: str, cascade: bool = True) -> dict[str, int]:
         """
         Delete a campaign and optionally its children and plan items.
 
@@ -195,18 +196,21 @@ def _delete_recursive(cid: str):
 
             # Delete plan items
             r = self._conn.execute(
-                "DELETE FROM plan_items WHERE campaign_id = ?", (cid,),
+                "DELETE FROM plan_items WHERE campaign_id = ?",
+                (cid,),
             )
             counts["plan_items"] += r.rowcount
 
             # Delete campaign participants
             self._conn.execute(
-                "DELETE FROM campaign_participants WHERE campaign_id = ?", (cid,),
+                "DELETE FROM campaign_participants WHERE campaign_id = ?",
+                (cid,),
             )
 
             # Delete campaign
             r = self._conn.execute(
-                "DELETE FROM campaigns WHERE id = ?", (cid,),
+                "DELETE FROM campaigns WHERE id = ?",
+                (cid,),
             )
             counts["campaigns"] += r.rowcount
 
@@ -215,7 +219,7 @@ def _delete_recursive(cid: str):
 
         return counts
 
-    def get_subcampaigns(self, campaign_id: str) -> List[Campaign]:
+    def get_subcampaigns(self, campaign_id: str) -> list[Campaign]:
         """Get direct children of a campaign."""
         rows = self._conn.execute(
             "SELECT * FROM campaigns WHERE parent_id = ? ORDER BY created_at",
@@ -223,14 +227,14 @@ def get_subcampaigns(self, campaign_id: str) -> List[Campaign]:
         ).fetchall()
         return [self._row_to_campaign(row) for row in rows]
 
-    def get_nth_subcampaign(self, parent_id: str, n: int) -> Optional[Campaign]:
+    def get_nth_subcampaign(self, parent_id: str, n: int) -> Campaign | None:
         """Get the nth child campaign (1-indexed) of a parent, ordered by creation."""
         phases = self.get_subcampaigns(parent_id)
         if 1 <= n <= len(phases):
             return phases[n - 1]
         return None
 
-    def get_campaign_tree(self, campaign_id: str) -> Dict[str, Any]:
+    def get_campaign_tree(self, campaign_id: str) -> dict[str, Any]:
         """Get a campaign and all its descendants as a tree."""
         campaign = self.get_campaign(campaign_id)
         if not campaign:
@@ -241,12 +245,11 @@ def get_campaign_tree(self, campaign_id: str) -> Dict[str, Any]:
             "children": [self.get_campaign_tree(c.id) for c in children],
         }
 
-    def get_root_campaigns(self, status: Optional[str] = "active") -> List[Campaign]:
+    def get_root_campaigns(self, status: str | None = "active") -> list[Campaign]:
         """Get top-level campaigns (no parent). If status is None, returns all."""
         if status is None:
             rows = self._conn.execute(
-                "SELECT * FROM campaigns WHERE parent_id IS NULL "
-                "ORDER BY updated_at DESC LIMIT 50"
+                "SELECT * FROM campaigns WHERE parent_id IS NULL ORDER BY updated_at DESC LIMIT 50"
             ).fetchall()
         else:
             rows = self._conn.execute(
@@ -259,11 +262,11 @@ def get_root_campaigns(self, status: Optional[str] = "active") -> List[Campaign]
     def update_campaign(
         self,
         campaign_id: str,
-        description: Optional[str] = None,
-        shorthand: Optional[str] = None,
-        summary: Optional[str] = None,
-        target: Optional[str] = None,
-        parent_id: Optional[str] = None,
+        description: str | None = None,
+        shorthand: str | None = None,
+        summary: str | None = None,
+        target: str | None = None,
+        parent_id: str | None = None,
     ):
         """Update campaign fields. Only non-None values are applied."""
         now = self._now()
@@ -310,7 +313,7 @@ def unshare_campaign(self, campaign_id: str):
                 (self._now(), campaign_id),
             )
 
-    def get_shared_campaigns(self) -> List[Campaign]:
+    def get_shared_campaigns(self) -> list[Campaign]:
         """Get all campaigns marked as shared."""
         rows = self._conn.execute(
             "SELECT * FROM campaigns WHERE is_shared = 1 ORDER BY created_at",
@@ -326,7 +329,7 @@ def add_campaign_participant(self, campaign_id: str, instance_id: str, hostname:
                 (campaign_id, instance_id, hostname, self._now()),
             )
 
-    def get_campaign_participants(self, campaign_id: str) -> List[Dict]:
+    def get_campaign_participants(self, campaign_id: str) -> list[dict]:
         """Get all participants for a campaign."""
         rows = self._conn.execute(
             "SELECT * FROM campaign_participants WHERE campaign_id = ? ORDER BY joined_at",
@@ -380,22 +383,23 @@ def _row_to_campaign(self, row: sqlite3.Row) -> Campaign:
     def create_project(
         self,
         description: str,
-        campaign_id: Optional[str] = None,
-        project_id: Optional[str] = None,
+        campaign_id: str | None = None,
+        project_id: str | None = None,
     ) -> str:
         """Create a new project. Returns project ID."""
         pid = project_id or self._gen_id()
         now = self._now()
         with self._tx():
             self._conn.execute(
-                "INSERT INTO projects (id, description, campaign_id, status, created_at, updated_at) "
+                "INSERT INTO projects"
+                " (id, description, campaign_id, status, created_at, updated_at) "
                 "VALUES (?, ?, ?, 'active', ?, ?)",
                 (pid, description, campaign_id, now, now),
             )
         logger.info(f"Created project {pid}: {description}")
         return pid
 
-    def get_active_projects(self) -> List[Project]:
+    def get_active_projects(self) -> list[Project]:
         """Get all active projects."""
         rows = self._conn.execute(
             "SELECT * FROM projects WHERE status = 'active' ORDER BY created_at DESC"
@@ -420,8 +424,8 @@ def _row_to_project(self, row: sqlite3.Row) -> Project:
     def create_session_intent(
         self,
         session_id: str,
-        planned_intent: Optional[str] = None,
-        campaign_ids: Optional[List[str]] = None,
+        planned_intent: str | None = None,
+        campaign_ids: list[str] | None = None,
     ):
         """Create or update session intent, optionally linking to campaigns."""
         now = self._now()
@@ -436,7 +440,7 @@ def create_session_intent(
             for cid in campaign_ids:
                 self.link_session_campaign(session_id, cid)
 
-    def get_current_session_intent(self) -> Optional[SessionIntent]:
+    def get_current_session_intent(self) -> SessionIntent | None:
         """Get the most recent incomplete session intent."""
         row = self._conn.execute(
             "SELECT * FROM session_intents WHERE completed_at IS NULL "
@@ -453,7 +457,9 @@ def get_current_session_intent(self) -> Optional[SessionIntent]:
             actual_summary=d.get("actual_summary"),
             campaign_ids=campaign_ids,
             created_at=datetime.fromisoformat(d["created_at"]),
-            completed_at=datetime.fromisoformat(d["completed_at"]) if d.get("completed_at") else None,
+            completed_at=datetime.fromisoformat(d["completed_at"])
+            if d.get("completed_at")
+            else None,
         )
 
     def complete_session_intent(self, session_id: str, actual_summary: str):
@@ -476,8 +482,7 @@ def link_session_campaign(self, session_id: str, campaign_id: str):
         with self._tx():
             # Ensure session_intents row exists (FK target)
             self._conn.execute(
-                "INSERT OR IGNORE INTO session_intents "
-                "(session_id, created_at) VALUES (?, ?)",
+                "INSERT OR IGNORE INTO session_intents (session_id, created_at) VALUES (?, ?)",
                 (session_id, now),
             )
             self._conn.execute(
@@ -494,16 +499,15 @@ def unlink_session_campaign(self, session_id: str, campaign_id: str):
                 (session_id, campaign_id),
             )
 
-    def get_campaign_ids_for_session(self, session_id: str) -> List[str]:
+    def get_campaign_ids_for_session(self, session_id: str) -> list[str]:
         """Get campaign IDs linked to a session."""
         rows = self._conn.execute(
-            "SELECT campaign_id FROM session_campaigns WHERE session_id = ? "
-            "ORDER BY linked_at",
+            "SELECT campaign_id FROM session_campaigns WHERE session_id = ? ORDER BY linked_at",
             (session_id,),
         ).fetchall()
         return [row["campaign_id"] for row in rows]
 
-    def get_campaigns_for_session(self, session_id: str) -> List[Campaign]:
+    def get_campaigns_for_session(self, session_id: str) -> list[Campaign]:
         """Get campaigns linked to a session."""
         rows = self._conn.execute(
             "SELECT c.* FROM campaigns c "
@@ -513,7 +517,7 @@ def get_campaigns_for_session(self, session_id: str) -> List[Campaign]:
         ).fetchall()
         return [self._row_to_campaign(row) for row in rows]
 
-    def get_sessions_for_campaign(self, campaign_id: str) -> List[SessionIntent]:
+    def get_sessions_for_campaign(self, campaign_id: str) -> list[SessionIntent]:
         """Get session intents linked to a campaign."""
         rows = self._conn.execute(
             "SELECT si.* FROM session_intents si "
@@ -526,14 +530,18 @@ def get_sessions_for_campaign(self, campaign_id: str) -> List[SessionIntent]:
             d = dict(row)
             sid = d["session_id"]
             cids = self.get_campaign_ids_for_session(sid)
-            results.append(SessionIntent(
-                session_id=sid,
-                planned_intent=d.get("planned_intent"),
-                actual_summary=d.get("actual_summary"),
-                campaign_ids=cids,
-                created_at=datetime.fromisoformat(d["created_at"]),
-                completed_at=datetime.fromisoformat(d["completed_at"]) if d.get("completed_at") else None,
-            ))
+            results.append(
+                SessionIntent(
+                    session_id=sid,
+                    planned_intent=d.get("planned_intent"),
+                    actual_summary=d.get("actual_summary"),
+                    campaign_ids=cids,
+                    created_at=datetime.fromisoformat(d["created_at"]),
+                    completed_at=datetime.fromisoformat(d["completed_at"])
+                    if d.get("completed_at")
+                    else None,
+                )
+            )
         return results
 
     # ==================================================================
@@ -543,14 +551,14 @@ def get_sessions_for_campaign(self, campaign_id: str) -> List[SessionIntent]:
     def create_planned_session(
         self,
         scheduled_date: str,
-        title: Optional[str] = None,
-        notes: Optional[str] = None,
-        scheduled_time: Optional[str] = None,
-        estimated_duration_minutes: Optional[int] = None,
-        acquisition_params: Optional[Dict] = None,
-        source_session_id: Optional[str] = None,
-        campaign_ids: Optional[List[str]] = None,
-        planned_session_id: Optional[str] = None,
+        title: str | None = None,
+        notes: str | None = None,
+        scheduled_time: str | None = None,
+        estimated_duration_minutes: int | None = None,
+        acquisition_params: dict | None = None,
+        source_session_id: str | None = None,
+        campaign_ids: list[str] | None = None,
+        planned_session_id: str | None = None,
     ) -> str:
         """Create a planned imaging session. Returns its ID."""
         psid = planned_session_id or self._gen_id()
@@ -563,19 +571,27 @@ def create_planned_session(
                 " source_session_id, status, created_at, updated_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'planned', ?, ?)",
                 (
-                    psid, title, notes, scheduled_date, scheduled_time,
+                    psid,
+                    title,
+                    notes,
+                    scheduled_date,
+                    scheduled_time,
                     estimated_duration_minutes,
                     json.dumps(acquisition_params) if acquisition_params else None,
-                    source_session_id, now, now,
+                    source_session_id,
+                    now,
+                    now,
                 ),
             )
         if campaign_ids:
             for cid in campaign_ids:
                 self.link_planned_session_campaign(psid, cid)
-        logger.info(f"Created planned session {psid} for {scheduled_date}: {title or notes or '(untitled)'}")
+        logger.info(
+            f"Created planned session {psid} for {scheduled_date}: {title or notes or '(untitled)'}"
+        )
         return psid
 
-    def get_planned_session(self, planned_session_id: str) -> Optional[PlannedSession]:
+    def get_planned_session(self, planned_session_id: str) -> PlannedSession | None:
         """Get a specific planned session."""
         row = self._conn.execute(
             "SELECT * FROM planned_sessions WHERE id = ?",
@@ -585,11 +601,11 @@ def get_planned_session(self, planned_session_id: str) -> Optional[PlannedSessio
 
     def get_planned_sessions(
         self,
-        status: Optional[str] = None,
-        campaign_id: Optional[str] = None,
-        from_date: Optional[str] = None,
-        to_date: Optional[str] = None,
-    ) -> List[PlannedSession]:
+        status: str | None = None,
+        campaign_id: str | None = None,
+        from_date: str | None = None,
+        to_date: str | None = None,
+    ) -> list[PlannedSession]:
         """
         Query planned sessions with optional filters.
 
@@ -627,7 +643,7 @@ def get_planned_sessions(
         rows = self._conn.execute(query, params).fetchall()
         return [self._row_to_planned_session(row) for row in rows]
 
-    def get_upcoming_sessions(self, limit: int = 10) -> List[PlannedSession]:
+    def get_upcoming_sessions(self, limit: int = 10) -> list[PlannedSession]:
         """Get upcoming planned sessions (today and future, status=planned)."""
         today = datetime.now().strftime("%Y-%m-%d")
         rows = self._conn.execute(
@@ -638,7 +654,7 @@ def get_upcoming_sessions(self, limit: int = 10) -> List[PlannedSession]:
         ).fetchall()
         return [self._row_to_planned_session(row) for row in rows]
 
-    def get_todays_sessions(self) -> List[PlannedSession]:
+    def get_todays_sessions(self) -> list[PlannedSession]:
         """Get planned sessions for today."""
         today = datetime.now().strftime("%Y-%m-%d")
         rows = self._conn.execute(
@@ -652,15 +668,15 @@ def get_todays_sessions(self) -> List[PlannedSession]:
     def update_planned_session(
         self,
         planned_session_id: str,
-        title: Optional[str] = None,
-        notes: Optional[str] = None,
-        scheduled_date: Optional[str] = None,
-        scheduled_time: Optional[str] = None,
-        estimated_duration_minutes: Optional[int] = None,
-        acquisition_params: Optional[Dict] = None,
-        source_session_id: Optional[str] = None,
-        status: Optional[PlannedSessionStatus] = None,
-        session_id: Optional[str] = None,
+        title: str | None = None,
+        notes: str | None = None,
+        scheduled_date: str | None = None,
+        scheduled_time: str | None = None,
+        estimated_duration_minutes: int | None = None,
+        acquisition_params: dict | None = None,
+        source_session_id: str | None = None,
+        status: PlannedSessionStatus | None = None,
+        session_id: str | None = None,
     ):
         """Update a planned session. Only non-None values are applied."""
         now = self._now()
@@ -729,7 +745,7 @@ def unlink_planned_session_campaign(self, planned_session_id: str, campaign_id:
                 (planned_session_id, campaign_id),
             )
 
-    def get_campaign_ids_for_planned_session(self, planned_session_id: str) -> List[str]:
+    def get_campaign_ids_for_planned_session(self, planned_session_id: str) -> list[str]:
         """Get campaign IDs linked to a planned session."""
         rows = self._conn.execute(
             "SELECT campaign_id FROM planned_session_campaigns "
@@ -749,7 +765,9 @@ def _row_to_planned_session(self, row: sqlite3.Row) -> PlannedSession:
             scheduled_date=d.get("scheduled_date"),
             scheduled_time=d.get("scheduled_time"),
             estimated_duration_minutes=d.get("estimated_duration_minutes"),
-            acquisition_params=json.loads(d["acquisition_params"]) if d.get("acquisition_params") else None,
+            acquisition_params=json.loads(d["acquisition_params"])
+            if d.get("acquisition_params")
+            else None,
             source_session_id=d.get("source_session_id"),
             status=PlannedSessionStatus(d.get("status", "planned")),
             session_id=d.get("session_id"),
diff --git a/gently/harness/memory/_ml_pipelines.py b/gently/harness/memory/_ml_pipelines.py
index a93f021d..a14a2553 100644
--- a/gently/harness/memory/_ml_pipelines.py
+++ b/gently/harness/memory/_ml_pipelines.py
@@ -9,7 +9,7 @@
 
 import json
 import logging
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -91,10 +91,10 @@ def create_ml_pipeline(
         campaign_id: str,
         name: str,
         task: str = "embryo_stage_classification",
-        model_config: Optional[Dict] = None,
-        data_split: Optional[Dict] = None,
-        training_config: Optional[Dict] = None,
-    ) -> Dict[str, Any]:
+        model_config: dict | None = None,
+        data_split: dict | None = None,
+        training_config: dict | None = None,
+    ) -> dict[str, Any]:
         """Create a new ML pipeline."""
         self._ensure_ml_tables()
         pipeline_id = self._gen_id()
@@ -106,16 +106,20 @@ def create_ml_pipeline(
                     training_config, created_at, updated_at)
                    VALUES (?, ?, ?, ?, 'planned', ?, ?, ?, ?, ?)""",
                 (
-                    pipeline_id, campaign_id, name, task,
+                    pipeline_id,
+                    campaign_id,
+                    name,
+                    task,
                     json.dumps(model_config) if model_config else None,
                     json.dumps(data_split) if data_split else None,
                     json.dumps(training_config) if training_config else None,
-                    now, now,
+                    now,
+                    now,
                 ),
             )
         return self.get_ml_pipeline(pipeline_id)
 
-    def get_ml_pipeline(self, pipeline_id: str) -> Optional[Dict[str, Any]]:
+    def get_ml_pipeline(self, pipeline_id: str) -> dict[str, Any] | None:
         """Get a pipeline by ID."""
         self._ensure_ml_tables()
         row = self._conn.execute(
@@ -125,7 +129,7 @@ def get_ml_pipeline(self, pipeline_id: str) -> Optional[Dict[str, Any]]:
             return None
         return self._row_to_pipeline(row)
 
-    def list_ml_pipelines(self, campaign_id: Optional[str] = None) -> List[Dict[str, Any]]:
+    def list_ml_pipelines(self, campaign_id: str | None = None) -> list[dict[str, Any]]:
         """List pipelines, optionally filtered by campaign."""
         self._ensure_ml_tables()
         if campaign_id:
@@ -139,11 +143,18 @@ def list_ml_pipelines(self, campaign_id: Optional[str] = None) -> List[Dict[str,
             ).fetchall()
         return [self._row_to_pipeline(r) for r in rows]
 
-    def update_ml_pipeline(self, pipeline_id: str, **kwargs) -> Optional[Dict[str, Any]]:
+    def update_ml_pipeline(self, pipeline_id: str, **kwargs) -> dict[str, Any] | None:
         """Update pipeline fields."""
         self._ensure_ml_tables()
-        allowed = {"status", "model_config", "data_split", "training_config",
-                    "best_run_id", "best_accuracy", "name"}
+        allowed = {
+            "status",
+            "model_config",
+            "data_split",
+            "training_config",
+            "best_run_id",
+            "best_accuracy",
+            "name",
+        }
         updates = []
         values = []
         for k, v in kwargs.items():
@@ -168,7 +179,7 @@ def update_ml_pipeline(self, pipeline_id: str, **kwargs) -> Optional[Dict[str, A
             )
         return self.get_ml_pipeline(pipeline_id)
 
-    def _row_to_pipeline(self, row) -> Dict[str, Any]:
+    def _row_to_pipeline(self, row) -> dict[str, Any]:
         return {
             "id": row["id"],
             "campaign_id": row["campaign_id"],
@@ -177,7 +188,9 @@ def _row_to_pipeline(self, row) -> Dict[str, Any]:
             "status": row["status"],
             "model_config": json.loads(row["model_config"]) if row["model_config"] else None,
             "data_split": json.loads(row["data_split"]) if row["data_split"] else None,
-            "training_config": json.loads(row["training_config"]) if row["training_config"] else None,
+            "training_config": json.loads(row["training_config"])
+            if row["training_config"]
+            else None,
             "best_run_id": row["best_run_id"],
             "best_accuracy": row["best_accuracy"],
             "created_at": row["created_at"],
@@ -191,11 +204,11 @@ def _row_to_pipeline(self, row) -> Dict[str, Any]:
     def create_training_run(
         self,
         pipeline_id: str,
-        model_config: Optional[Dict] = None,
-        training_config: Optional[Dict] = None,
-        data_split: Optional[Dict] = None,
+        model_config: dict | None = None,
+        training_config: dict | None = None,
+        data_split: dict | None = None,
         peer_instance_id: str = "",
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         """Create a new training run."""
         self._ensure_ml_tables()
         run_id = self._gen_id()
@@ -206,7 +219,8 @@ def create_training_run(
                     data_split, peer_instance_id)
                    VALUES (?, ?, 'planned', ?, ?, ?, ?)""",
                 (
-                    run_id, pipeline_id,
+                    run_id,
+                    pipeline_id,
                     json.dumps(model_config) if model_config else None,
                     json.dumps(training_config) if training_config else None,
                     json.dumps(data_split) if data_split else None,
@@ -215,7 +229,7 @@ def create_training_run(
             )
         return self.get_training_run(run_id)
 
-    def get_training_run(self, run_id: str) -> Optional[Dict[str, Any]]:
+    def get_training_run(self, run_id: str) -> dict[str, Any] | None:
         """Get a training run by ID."""
         self._ensure_ml_tables()
         row = self._conn.execute(
@@ -225,7 +239,7 @@ def get_training_run(self, run_id: str) -> Optional[Dict[str, Any]]:
             return None
         return self._row_to_run(row)
 
-    def list_training_runs(self, pipeline_id: str) -> List[Dict[str, Any]]:
+    def list_training_runs(self, pipeline_id: str) -> list[dict[str, Any]]:
         """List runs for a pipeline."""
         self._ensure_ml_tables()
         rows = self._conn.execute(
@@ -234,13 +248,22 @@ def list_training_runs(self, pipeline_id: str) -> List[Dict[str, Any]]:
         ).fetchall()
         return [self._row_to_run(r) for r in rows]
 
-    def update_training_run(self, run_id: str, **kwargs) -> Optional[Dict[str, Any]]:
+    def update_training_run(self, run_id: str, **kwargs) -> dict[str, Any] | None:
         """Update training run fields."""
         self._ensure_ml_tables()
         allowed = {
-            "status", "current_epoch", "total_epochs", "train_loss", "val_loss",
-            "val_accuracy", "best_val_accuracy", "model_weights_path", "metrics_path",
-            "started_at", "completed_at", "error_message",
+            "status",
+            "current_epoch",
+            "total_epochs",
+            "train_loss",
+            "val_loss",
+            "val_accuracy",
+            "best_val_accuracy",
+            "model_weights_path",
+            "metrics_path",
+            "started_at",
+            "completed_at",
+            "error_message",
         }
         updates = []
         values = []
@@ -261,13 +284,15 @@ def update_training_run(self, run_id: str, **kwargs) -> Optional[Dict[str, Any]]
             )
         return self.get_training_run(run_id)
 
-    def _row_to_run(self, row) -> Dict[str, Any]:
+    def _row_to_run(self, row) -> dict[str, Any]:
         return {
             "id": row["id"],
             "pipeline_id": row["pipeline_id"],
             "status": row["status"],
             "model_config": json.loads(row["model_config"]) if row["model_config"] else None,
-            "training_config": json.loads(row["training_config"]) if row["training_config"] else None,
+            "training_config": json.loads(row["training_config"])
+            if row["training_config"]
+            else None,
             "data_split": json.loads(row["data_split"]) if row["data_split"] else None,
             "current_epoch": row["current_epoch"],
             "total_epochs": row["total_epochs"],
@@ -289,15 +314,15 @@ def _row_to_run(self, row) -> Dict[str, Any]:
 
     def save_data_assessment(
         self,
-        pipeline_id: Optional[str] = None,
+        pipeline_id: str | None = None,
         total_sessions: int = 0,
         total_embryos: int = 0,
         total_volumes: int = 0,
         annotated_embryos: int = 0,
-        stage_distribution: Optional[Dict] = None,
-        coverage_gaps: Optional[List] = None,
+        stage_distribution: dict | None = None,
+        coverage_gaps: list | None = None,
         quality_notes: str = "",
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         """Save a data assessment snapshot."""
         self._ensure_ml_tables()
         assessment_id = self._gen_id()
@@ -310,16 +335,21 @@ def save_data_assessment(
                     quality_notes, created_at)
                    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)""",
                 (
-                    assessment_id, pipeline_id, total_sessions, total_embryos,
-                    total_volumes, annotated_embryos,
+                    assessment_id,
+                    pipeline_id,
+                    total_sessions,
+                    total_embryos,
+                    total_volumes,
+                    annotated_embryos,
                     json.dumps(stage_distribution) if stage_distribution else None,
                     json.dumps(coverage_gaps) if coverage_gaps else None,
-                    quality_notes, now,
+                    quality_notes,
+                    now,
                 ),
             )
         return self.get_data_assessment(assessment_id)
 
-    def get_data_assessment(self, assessment_id: str) -> Optional[Dict[str, Any]]:
+    def get_data_assessment(self, assessment_id: str) -> dict[str, Any] | None:
         """Get a data assessment by ID."""
         self._ensure_ml_tables()
         row = self._conn.execute(
@@ -334,7 +364,9 @@ def get_data_assessment(self, assessment_id: str) -> Optional[Dict[str, Any]]:
             "total_embryos": row["total_embryos"],
             "total_volumes": row["total_volumes"],
             "annotated_embryos": row["annotated_embryos"],
-            "stage_distribution": json.loads(row["stage_distribution"]) if row["stage_distribution"] else None,
+            "stage_distribution": json.loads(row["stage_distribution"])
+            if row["stage_distribution"]
+            else None,
             "coverage_gaps": json.loads(row["coverage_gaps"]) if row["coverage_gaps"] else None,
             "quality_notes": row["quality_notes"],
             "created_at": row["created_at"],
diff --git a/gently/harness/memory/_plans.py b/gently/harness/memory/_plans.py
index 0a872e2f..5805781a 100644
--- a/gently/harness/memory/_plans.py
+++ b/gently/harness/memory/_plans.py
@@ -9,7 +9,7 @@
 import logging
 import sqlite3
 from datetime import datetime
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from .model import (
     BenchSpec,
@@ -34,15 +34,15 @@ def create_plan_item(
         campaign_id: str,
         type: str,
         title: str,
-        description: Optional[str] = None,
-        spec: Optional[Dict] = None,
-        inherit_from: Optional[str] = None,
-        planned_session_id: Optional[str] = None,
+        description: str | None = None,
+        spec: dict | None = None,
+        inherit_from: str | None = None,
+        planned_session_id: str | None = None,
         phase_order: int = -1,
-        depends_on: Optional[List[str]] = None,
-        item_id: Optional[str] = None,
-        references: Optional[List[Dict]] = None,
-        estimated_days: Optional[int] = None,
+        depends_on: list[str] | None = None,
+        item_id: str | None = None,
+        references: list[dict] | None = None,
+        estimated_days: int | None = None,
     ) -> str:
         """Create a plan item. Returns its ID.
 
@@ -55,8 +55,7 @@ def create_plan_item(
         if phase_order < 0:
             # Auto-assign: next number in this campaign
             row = self._conn.execute(
-                "SELECT COALESCE(MAX(phase_order), 0) FROM plan_items "
-                "WHERE campaign_id = ?",
+                "SELECT COALESCE(MAX(phase_order), 0) FROM plan_items WHERE campaign_id = ?",
                 (campaign_id,),
             ).fetchone()
             phase_order = row[0] + 1
@@ -65,14 +64,23 @@ def create_plan_item(
             self._conn.execute(
                 "INSERT INTO plan_items "
                 "(id, campaign_id, type, title, description, spec, inherit_from, "
-                " planned_session_id, estimated_days, phase_order, \"references\", status, created_at, updated_at) "
+                " planned_session_id, estimated_days, phase_order,"
+                ' "references", status, created_at, updated_at) '
                 "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'planned', ?, ?)",
                 (
-                    pid, campaign_id, type, title, description,
+                    pid,
+                    campaign_id,
+                    type,
+                    title,
+                    description,
                     json.dumps(spec) if spec else None,
-                    inherit_from, planned_session_id, estimated_days, phase_order,
+                    inherit_from,
+                    planned_session_id,
+                    estimated_days,
+                    phase_order,
                     json.dumps(references) if references else None,
-                    now, now,
+                    now,
+                    now,
                 ),
             )
             if depends_on:
@@ -85,16 +93,16 @@ def create_plan_item(
         logger.info(f"Created plan item {pid} [{type}] #{phase_order}: {title}")
         return pid
 
-    def get_plan_item(self, item_id: str) -> Optional[PlanItem]:
+    def get_plan_item(self, item_id: str) -> PlanItem | None:
         """Get a specific plan item."""
-        row = self._conn.execute(
-            "SELECT * FROM plan_items WHERE id = ?", (item_id,)
-        ).fetchone()
+        row = self._conn.execute("SELECT * FROM plan_items WHERE id = ?", (item_id,)).fetchone()
         return self._row_to_plan_item(row) if row else None
 
     def resolve_plan_item(
-        self, ref: str, campaign_id: Optional[str] = None,
-    ) -> Optional[PlanItem]:
+        self,
+        ref: str,
+        campaign_id: str | None = None,
+    ) -> PlanItem | None:
         """Resolve a human-friendly plan item reference.
 
         Supported formats:
@@ -114,16 +122,14 @@ def resolve_plan_item(
         ref = ref.strip().lower()
 
         # --- Direct ID match (UUID prefix) ---
-        row = self._conn.execute(
-            "SELECT * FROM plan_items WHERE id = ?", (ref,)
-        ).fetchone()
+        row = self._conn.execute("SELECT * FROM plan_items WHERE id = ?", (ref,)).fetchone()
         if row:
             return self._row_to_plan_item(row)
 
         # Also try UUID prefix match (e.g. first few chars)
-        if len(ref) >= 4 and re.match(r'^[0-9a-f]+$', ref):
+        if len(ref) >= 4 and re.match(r"^[0-9a-f]+$", ref):
             row = self._conn.execute(
-                "SELECT * FROM plan_items WHERE id LIKE ?", (ref + '%',)
+                "SELECT * FROM plan_items WHERE id LIKE ?", (ref + "%",)
             ).fetchone()
             if row:
                 return self._row_to_plan_item(row)
@@ -133,7 +139,7 @@ def resolve_plan_item(
         task_num = None
 
         # "campaign.phase.task" — e.g. "nerve-ring.1.3" or "ec11.2.1"
-        m = re.match(r'^([^.\s]+)\.(\d+)\.(\d+)$', ref)
+        m = re.match(r"^([^.\s]+)\.(\d+)\.(\d+)$", ref)
         if m:
             campaign_label = m.group(1)
             phase_num, task_num = int(m.group(2)), int(m.group(3))
@@ -144,25 +150,25 @@ def resolve_plan_item(
 
         # "1.3" or "2.1"
         if not task_num:
-            m = re.match(r'^(\d+)\.(\d+)$', ref)
+            m = re.match(r"^(\d+)\.(\d+)$", ref)
             if m:
                 phase_num, task_num = int(m.group(1)), int(m.group(2))
 
         # "task 3 of phase 1" / "task 3 phase 1"
         if not task_num:
-            m = re.search(r'task\s+(\d+)\s+(?:of\s+)?phase\s+(\d+)', ref)
+            m = re.search(r"task\s+(\d+)\s+(?:of\s+)?phase\s+(\d+)", ref)
             if m:
                 task_num, phase_num = int(m.group(1)), int(m.group(2))
 
         # "phase 1 task 3"
         if not task_num:
-            m = re.search(r'phase\s+(\d+)\s+task\s+(\d+)', ref)
+            m = re.search(r"phase\s+(\d+)\s+task\s+(\d+)", ref)
             if m:
                 phase_num, task_num = int(m.group(1)), int(m.group(2))
 
         # "task 3" / "#3" / just "3"
         if not task_num:
-            m = re.match(r'^(?:task\s+|#)?(\d+)$', ref)
+            m = re.match(r"^(?:task\s+|#)?(\d+)$", ref)
             if m:
                 task_num = int(m.group(1))
 
@@ -212,7 +218,7 @@ def resolve_plan_item(
 
         return None
 
-    def _resolve_campaign_label(self, label: str) -> Optional[str]:
+    def _resolve_campaign_label(self, label: str) -> str | None:
         """Resolve a campaign shorthand or UUID prefix to an ID.
 
         Checks shorthand (case-insensitive), then UUID prefix, then
@@ -232,7 +238,7 @@ def _resolve_campaign_label(self, label: str) -> Optional[str]:
         if len(label) >= 4:
             row = self._conn.execute(
                 "SELECT id FROM campaigns WHERE id LIKE ? AND parent_id IS NULL",
-                (label_lower + '%',),
+                (label_lower + "%",),
             ).fetchone()
             if row:
                 return row["id"]
@@ -240,7 +246,7 @@ def _resolve_campaign_label(self, label: str) -> Optional[str]:
         # Description substring match (first word or hyphenated slug)
         row = self._conn.execute(
             "SELECT id FROM campaigns WHERE LOWER(description) LIKE ? AND parent_id IS NULL",
-            ('%' + label_lower + '%',),
+            ("%" + label_lower + "%",),
         ).fetchone()
         if row:
             return row["id"]
@@ -249,11 +255,11 @@ def _resolve_campaign_label(self, label: str) -> Optional[str]:
 
     def get_plan_items(
         self,
-        campaign_id: Optional[str] = None,
-        status: Optional[str] = None,
-        type: Optional[str] = None,
+        campaign_id: str | None = None,
+        status: str | None = None,
+        type: str | None = None,
         include_children: bool = False,
-    ) -> List[PlanItem]:
+    ) -> list[PlanItem]:
         """
         Query plan items with optional filters.
 
@@ -296,17 +302,17 @@ def get_plan_items(
     def update_plan_item(
         self,
         item_id: str,
-        title: Optional[str] = None,
-        description: Optional[str] = None,
-        status: Optional[PlanItemStatus] = None,
-        outcome: Optional[str] = None,
-        spec: Optional[Dict] = None,
-        planned_session_id: Optional[str] = None,
-        session_id: Optional[str] = None,
-        phase_order: Optional[int] = None,
-        campaign_id: Optional[str] = None,
-        references: Optional[List[Dict]] = None,
-        estimated_days: Optional[int] = None,
+        title: str | None = None,
+        description: str | None = None,
+        status: PlanItemStatus | None = None,
+        outcome: str | None = None,
+        spec: dict | None = None,
+        planned_session_id: str | None = None,
+        session_id: str | None = None,
+        phase_order: int | None = None,
+        campaign_id: str | None = None,
+        references: list[dict] | None = None,
+        estimated_days: int | None = None,
     ):
         """Update a plan item. Only non-None values are applied."""
         now = self._now()
@@ -334,7 +340,7 @@ def update_plan_item(
             updates.append("phase_order = ?")
             values.append(phase_order)
         if references is not None:
-            updates.append("\"references\" = ?")
+            updates.append('"references" = ?')
             values.append(json.dumps(references))
         if not updates:
             return
@@ -350,10 +356,12 @@ def update_plan_item(
     def complete_plan_item(self, item_id: str, outcome: str):
         """Mark a plan item as completed with an outcome description."""
         self.update_plan_item(
-            item_id, status=PlanItemStatus.COMPLETED, outcome=outcome,
+            item_id,
+            status=PlanItemStatus.COMPLETED,
+            outcome=outcome,
         )
 
-    def skip_plan_item(self, item_id: str, reason: Optional[str] = None):
+    def skip_plan_item(self, item_id: str, reason: str | None = None):
         """Mark a plan item as skipped."""
         self.update_plan_item(
             item_id,
@@ -369,12 +377,12 @@ def delete_plan_item(self, item_id: str) -> bool:
         with self._tx():
             # Remove dependency links (both directions)
             self._conn.execute(
-                "DELETE FROM plan_item_dependencies "
-                "WHERE item_id = ? OR depends_on_id = ?",
+                "DELETE FROM plan_item_dependencies WHERE item_id = ? OR depends_on_id = ?",
                 (item_id, item_id),
             )
             r = self._conn.execute(
-                "DELETE FROM plan_items WHERE id = ?", (item_id,),
+                "DELETE FROM plan_items WHERE id = ?",
+                (item_id,),
             )
             deleted = r.rowcount > 0
         if deleted:
@@ -394,12 +402,11 @@ def remove_plan_item_dependency(self, item_id: str, depends_on_id: str):
         """Remove a dependency between plan items."""
         with self._tx():
             self._conn.execute(
-                "DELETE FROM plan_item_dependencies "
-                "WHERE item_id = ? AND depends_on_id = ?",
+                "DELETE FROM plan_item_dependencies WHERE item_id = ? AND depends_on_id = ?",
                 (item_id, depends_on_id),
             )
 
-    def get_plan_item_dependencies(self, item_id: str) -> List[str]:
+    def get_plan_item_dependencies(self, item_id: str) -> list[str]:
         """Get IDs of items this item depends on."""
         rows = self._conn.execute(
             "SELECT depends_on_id FROM plan_item_dependencies WHERE item_id = ?",
@@ -407,7 +414,7 @@ def get_plan_item_dependencies(self, item_id: str) -> List[str]:
         ).fetchall()
         return [row["depends_on_id"] for row in rows]
 
-    def get_plan_item_dependents(self, item_id: str) -> List[str]:
+    def get_plan_item_dependents(self, item_id: str) -> list[str]:
         """Get IDs of items that depend on this item."""
         rows = self._conn.execute(
             "SELECT item_id FROM plan_item_dependencies WHERE depends_on_id = ?",
@@ -415,13 +422,15 @@ def get_plan_item_dependents(self, item_id: str) -> List[str]:
         ).fetchall()
         return [row["item_id"] for row in rows]
 
-    def get_unblocked_plan_items(self, campaign_id: str) -> List[PlanItem]:
+    def get_unblocked_plan_items(self, campaign_id: str) -> list[PlanItem]:
         """
         Get plan items that are planned and have all dependencies completed.
         These are the items that can be started next.
         """
         items = self.get_plan_items(
-            campaign_id=campaign_id, status="planned", include_children=True,
+            campaign_id=campaign_id,
+            status="planned",
+            include_children=True,
         )
         unblocked = []
         for item in items:
@@ -433,7 +442,8 @@ def get_unblocked_plan_items(self, campaign_id: str) -> List[PlanItem]:
             for dep_id in item.depends_on:
                 dep = self.get_plan_item(dep_id)
                 if dep and dep.status not in (
-                    PlanItemStatus.COMPLETED, PlanItemStatus.SKIPPED,
+                    PlanItemStatus.COMPLETED,
+                    PlanItemStatus.SKIPPED,
                 ):
                     all_resolved = False
                     break
@@ -441,7 +451,7 @@ def get_unblocked_plan_items(self, campaign_id: str) -> List[PlanItem]:
                 unblocked.append(item)
         return unblocked
 
-    def get_plan_status(self, campaign_id: str) -> Dict[str, Any]:
+    def get_plan_status(self, campaign_id: str) -> dict[str, Any]:
         """
         Get a summary of plan progress for a campaign and its children.
 
@@ -461,7 +471,8 @@ def get_plan_status(self, campaign_id: str) -> Dict[str, Any]:
             }
         """
         items = self.get_plan_items(
-            campaign_id=campaign_id, include_children=True,
+            campaign_id=campaign_id,
+            include_children=True,
         )
         result = {
             "total": len(items),
@@ -488,10 +499,7 @@ def get_plan_status(self, campaign_id: str) -> Dict[str, Any]:
                 result["by_type"][type_key]["completed"] += 1
 
             # Pending decisions
-            if (
-                item.type == PlanItemType.DECISION_POINT
-                and item.status == PlanItemStatus.PLANNED
-            ):
+            if item.type == PlanItemType.DECISION_POINT and item.status == PlanItemStatus.PLANNED:
                 result["pending_decisions"].append(item)
 
         # Next actions = unblocked items
@@ -499,7 +507,7 @@ def get_plan_status(self, campaign_id: str) -> Dict[str, Any]:
 
         return result
 
-    def resolve_imaging_spec(self, item: PlanItem) -> Optional[ImagingSpec]:
+    def resolve_imaging_spec(self, item: PlanItem) -> ImagingSpec | None:
         """
         Resolve the full ImagingSpec for an item, following inheritance.
 
@@ -542,7 +550,7 @@ def resolve_imaging_spec(self, item: PlanItem) -> Optional[ImagingSpec]:
     def save_plan_template(
         self,
         name: str,
-        description: Optional[str],
+        description: str | None,
         campaign_id: str,
     ) -> str:
         """
@@ -568,7 +576,7 @@ def save_plan_template(
         logger.info(f"Saved plan template '{name}' ({tid})")
         return tid
 
-    def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
+    def _serialize_campaign_tree(self, campaign_id: str) -> dict:
         """Recursively serialize a campaign and its children/items."""
         campaign = self.get_campaign(campaign_id)
         if not campaign:
@@ -590,6 +598,7 @@ def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
             # Serialize spec
             if item.imaging_spec:
                 import dataclasses as _dc
+
                 spec_dict = {}
                 for f in _dc.fields(item.imaging_spec):
                     val = getattr(item.imaging_spec, f.name)
@@ -598,6 +607,7 @@ def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
                 item_data["spec"] = spec_dict
             elif item.bench_spec:
                 import dataclasses as _dc
+
                 spec_dict = {}
                 for f in _dc.fields(item.bench_spec):
                     val = getattr(item.bench_spec, f.name)
@@ -633,7 +643,7 @@ def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
             "children": serialized_children,
         }
 
-    def list_plan_templates(self) -> List[Dict]:
+    def list_plan_templates(self) -> list[dict]:
         """List all plan templates (id, name, description, dates)."""
         rows = self._conn.execute(
             "SELECT id, name, description, created_at, updated_at "
@@ -641,7 +651,7 @@ def list_plan_templates(self) -> List[Dict]:
         ).fetchall()
         return [dict(row) for row in rows]
 
-    def get_plan_template(self, id_or_name: str) -> Optional[Dict]:
+    def get_plan_template(self, id_or_name: str) -> dict | None:
         """Get a plan template by ID or name."""
         row = self._conn.execute(
             "SELECT * FROM plan_templates WHERE id = ? OR name = ?",
@@ -656,7 +666,7 @@ def get_plan_template(self, id_or_name: str) -> Optional[Dict]:
     def apply_plan_template(
         self,
         template_id: str,
-        overrides: Optional[Dict] = None,
+        overrides: dict | None = None,
     ) -> str:
         """
         Instantiate a template into a new campaign with plan items.
@@ -673,9 +683,9 @@ def apply_plan_template(
 
     def _instantiate_template_tree(
         self,
-        data: Dict,
-        parent_id: Optional[str],
-        overrides: Dict,
+        data: dict,
+        parent_id: str | None,
+        overrides: dict,
     ) -> str:
         """Recursively create campaigns and items from template data."""
         cid = self.create_campaign(
@@ -687,7 +697,7 @@ def _instantiate_template_tree(
 
         # Create items, track new IDs for dependency wiring
         items_data = data.get("items", [])
-        new_item_ids: List[str] = []
+        new_item_ids: list[str] = []
 
         for item_data in items_data:
             spec = item_data.get("spec")
@@ -697,9 +707,15 @@ def _instantiate_template_tree(
                 spec = dict(spec)  # copy
                 for k, v in overrides.items():
                     if k in spec or k in (
-                        "strain", "genotype", "reporter", "temperature_c",
-                        "num_slices", "exposure_ms", "interval_s",
-                        "num_embryos", "stop_condition",
+                        "strain",
+                        "genotype",
+                        "reporter",
+                        "temperature_c",
+                        "num_slices",
+                        "exposure_ms",
+                        "interval_s",
+                        "num_embryos",
+                        "stop_condition",
                     ):
                         spec[k] = v
 
@@ -720,7 +736,8 @@ def _instantiate_template_tree(
             for dep_idx in dep_indices:
                 if 0 <= dep_idx < len(new_item_ids):
                     self.add_plan_item_dependency(
-                        new_item_ids[idx], new_item_ids[dep_idx],
+                        new_item_ids[idx],
+                        new_item_ids[dep_idx],
                     )
 
         # Recurse into children
@@ -745,8 +762,8 @@ def delete_plan_template(self, template_id: str) -> bool:
     def create_plan_snapshot(
         self,
         campaign_id: str,
-        label: Optional[str] = None,
-        summary: Optional[str] = None,
+        label: str | None = None,
+        summary: str | None = None,
     ) -> str:
         """Create a snapshot of the current plan state.
 
@@ -770,8 +787,7 @@ def create_plan_snapshot(
 
         # Auto-increment version number for this campaign
         row = self._conn.execute(
-            "SELECT COALESCE(MAX(version_number), 0) FROM plan_snapshots "
-            "WHERE campaign_id = ?",
+            "SELECT COALESCE(MAX(version_number), 0) FROM plan_snapshots WHERE campaign_id = ?",
             (campaign_id,),
         ).fetchone()
         version_number = row[0] + 1
@@ -793,12 +809,19 @@ def create_plan_snapshot(
                 " summary, label, parent_version_id, created_at) "
                 "VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
                 (
-                    version_id, campaign_id, version_number,
-                    json.dumps(snapshot_data), summary, label,
-                    parent_version_id, now,
+                    version_id,
+                    campaign_id,
+                    version_number,
+                    json.dumps(snapshot_data),
+                    summary,
+                    label,
+                    parent_version_id,
+                    now,
                 ),
             )
-        logger.info(f"Created plan snapshot v{version_number} ({version_id}) for campaign {campaign_id}")
+        logger.info(
+            f"Created plan snapshot v{version_number} ({version_id}) for campaign {campaign_id}"
+        )
         return version_id
 
     def _generate_snapshot_summary(self, campaign_id: str) -> str:
@@ -811,7 +834,7 @@ def _generate_snapshot_summary(self, campaign_id: str) -> str:
         items = self.get_plan_items(campaign_id=campaign_id, include_children=True)
 
         # Count items by status
-        status_counts: Dict[str, int] = {}
+        status_counts: dict[str, int] = {}
         for item in items:
             key = item.status.value
             status_counts[key] = status_counts.get(key, 0) + 1
@@ -827,8 +850,10 @@ def _generate_snapshot_summary(self, campaign_id: str) -> str:
         return "\n".join(parts)
 
     def list_plan_snapshots(
-        self, campaign_id: str, limit: int = 50,
-    ) -> List[Dict]:
+        self,
+        campaign_id: str,
+        limit: int = 50,
+    ) -> list[dict]:
         """List snapshots for a campaign (metadata only, no blob).
 
         Returns list of dicts with version_id, version_number, label,
@@ -843,7 +868,7 @@ def list_plan_snapshots(
         ).fetchall()
         return [dict(row) for row in rows]
 
-    def get_plan_snapshot(self, version_id: str) -> Optional[Dict]:
+    def get_plan_snapshot(self, version_id: str) -> dict | None:
         """Get a full snapshot including the parsed JSON blob."""
         row = self._conn.execute(
             "SELECT * FROM plan_snapshots WHERE version_id = ?",
@@ -901,7 +926,7 @@ def restore_plan_snapshot(self, version_id: str) -> str:
         )
         return new_campaign_id
 
-    def _get_campaign_tree_ids(self, campaign_id: str) -> List[str]:
+    def _get_campaign_tree_ids(self, campaign_id: str) -> list[str]:
         """Get all campaign IDs in a tree (recursive)."""
         ids = [campaign_id]
         children = self._conn.execute(
@@ -932,16 +957,14 @@ def _row_to_plan_item(self, row: sqlite3.Row) -> PlanItem:
         if spec_data:
             if item_type == PlanItemType.IMAGING:
                 import dataclasses as _dc
+
                 valid = {f.name for f in _dc.fields(ImagingSpec)}
-                imaging_spec = ImagingSpec(**{
-                    k: v for k, v in spec_data.items() if k in valid
-                })
+                imaging_spec = ImagingSpec(**{k: v for k, v in spec_data.items() if k in valid})
             else:
                 import dataclasses as _dc
+
                 valid = {f.name for f in _dc.fields(BenchSpec)}
-                bench_spec = BenchSpec(**{
-                    k: v for k, v in spec_data.items() if k in valid
-                })
+                bench_spec = BenchSpec(**{k: v for k, v in spec_data.items() if k in valid})
 
         references = json.loads(d["references"]) if d.get("references") else []
 
diff --git a/gently/harness/memory/_understanding.py b/gently/harness/memory/_understanding.py
index 19d81f57..3e72d7eb 100644
--- a/gently/harness/memory/_understanding.py
+++ b/gently/harness/memory/_understanding.py
@@ -10,7 +10,6 @@
 import logging
 import sqlite3
 from datetime import datetime
-from typing import Dict, List, Optional
 
 from .model import (
     Attention,
@@ -46,7 +45,7 @@ def _load_understanding(self) -> Understanding:
             learnings=self.get_learnings(),
         )
 
-    def _load_embryo_states(self) -> Dict[str, EmbryoUnderstanding]:
+    def _load_embryo_states(self) -> dict[str, EmbryoUnderstanding]:
         rows = self._conn.execute(
             "SELECT * FROM embryo_understanding WHERE is_tracked = 1"
         ).fetchall()
@@ -56,10 +55,14 @@ def _load_embryo_states(self) -> Dict[str, EmbryoUnderstanding]:
             result[d["embryo_id"]] = EmbryoUnderstanding(
                 embryo_id=d["embryo_id"],
                 current_stage=d.get("current_stage"),
-                stage_confidence=Confidence(d["stage_confidence"]) if d.get("stage_confidence") else None,
+                stage_confidence=Confidence(d["stage_confidence"])
+                if d.get("stage_confidence")
+                else None,
                 health_assessment=d.get("health_assessment"),
                 notes=json.loads(d["notes"]) if d.get("notes") else [],
-                last_observed=datetime.fromisoformat(d["last_observed"]) if d.get("last_observed") else None,
+                last_observed=datetime.fromisoformat(d["last_observed"])
+                if d.get("last_observed")
+                else None,
                 is_tracked=bool(d.get("is_tracked", True)),
                 is_hatched=bool(d.get("is_hatched", False)),
                 needs_attention=bool(d.get("needs_attention", False)),
@@ -98,7 +101,7 @@ def add_observation(self, obs: Observation):
                 ),
             )
 
-    def get_recent_observations(self, limit: int = 50) -> List[Observation]:
+    def get_recent_observations(self, limit: int = 50) -> list[Observation]:
         """Get recent observations."""
         rows = self._conn.execute(
             "SELECT * FROM observations ORDER BY timestamp DESC LIMIT ?",
@@ -106,11 +109,10 @@ def get_recent_observations(self, limit: int = 50) -> List[Observation]:
         ).fetchall()
         return [self._row_to_observation(row) for row in reversed(rows)]
 
-    def get_observations_for_embryo(self, embryo_id: str, limit: int = 20) -> List[Observation]:
+    def get_observations_for_embryo(self, embryo_id: str, limit: int = 20) -> list[Observation]:
         """Get observations for a specific embryo."""
         rows = self._conn.execute(
-            "SELECT * FROM observations WHERE embryo_id = ? "
-            "ORDER BY timestamp DESC LIMIT ?",
+            "SELECT * FROM observations WHERE embryo_id = ? ORDER BY timestamp DESC LIMIT ?",
             (embryo_id, limit),
         ).fetchall()
         return [self._row_to_observation(row) for row in reversed(rows)]
@@ -152,14 +154,14 @@ def add_expectation(self, exp: Expectation):
                 ),
             )
 
-    def get_pending_expectations(self) -> List[Expectation]:
+    def get_pending_expectations(self) -> list[Expectation]:
         """Get all pending expectations."""
         rows = self._conn.execute(
             "SELECT * FROM expectations WHERE status = 'pending' ORDER BY expected_time"
         ).fetchall()
         return [self._row_to_expectation(row) for row in rows]
 
-    def get_expectation_for(self, target: str) -> Optional[Expectation]:
+    def get_expectation_for(self, target: str) -> Expectation | None:
         """Get the pending expectation for a specific target."""
         row = self._conn.execute(
             "SELECT * FROM expectations WHERE target = ? AND status = 'pending' "
@@ -211,7 +213,7 @@ def add_watchpoint(self, wp: Watchpoint):
                 ),
             )
 
-    def get_active_watchpoints(self) -> List[Watchpoint]:
+    def get_active_watchpoints(self) -> list[Watchpoint]:
         """Get all active watchpoints."""
         rows = self._conn.execute(
             "SELECT * FROM watchpoints WHERE status = 'active' ORDER BY priority DESC, created_at"
@@ -253,16 +255,14 @@ def add_question(self, q: Question):
         """Add a question."""
         with self._tx():
             self._conn.execute(
-                "INSERT INTO questions (id, content, status, created_at) "
-                "VALUES (?, ?, ?, ?)",
+                "INSERT INTO questions (id, content, status, created_at) VALUES (?, ?, ?, ?)",
                 (q.id, q.content, q.status.value, q.created_at.isoformat()),
             )
 
-    def get_open_questions(self) -> List[Question]:
+    def get_open_questions(self) -> list[Question]:
         """Get all open questions."""
         rows = self._conn.execute(
-            "SELECT * FROM questions WHERE status IN ('open', 'investigating') "
-            "ORDER BY created_at"
+            "SELECT * FROM questions WHERE status IN ('open', 'investigating') ORDER BY created_at"
         ).fetchall()
         return [self._row_to_question(row) for row in rows]
 
@@ -306,7 +306,7 @@ def add_learning(self, learning: Learning):
                 ),
             )
 
-    def get_learnings(self, limit: int = 50) -> List[Learning]:
+    def get_learnings(self, limit: int = 50) -> list[Learning]:
         """Get learnings."""
         rows = self._conn.execute(
             "SELECT * FROM learnings ORDER BY created_at DESC LIMIT ?",
@@ -331,13 +331,13 @@ def _row_to_learning(self, row: sqlite3.Row) -> Learning:
     def update_embryo_understanding(
         self,
         embryo_id: str,
-        current_stage: Optional[str] = None,
-        stage_confidence: Optional[Confidence] = None,
-        health_assessment: Optional[str] = None,
-        note: Optional[str] = None,
-        is_hatched: Optional[bool] = None,
-        needs_attention: Optional[bool] = None,
-        attention_reason: Optional[str] = None,
+        current_stage: str | None = None,
+        stage_confidence: Confidence | None = None,
+        health_assessment: str | None = None,
+        note: str | None = None,
+        is_hatched: bool | None = None,
+        needs_attention: bool | None = None,
+        attention_reason: str | None = None,
     ):
         """Update understanding of an embryo."""
         now = self._now()
@@ -403,11 +403,9 @@ def update_embryo_understanding(
     # Agent State
     # ==================================================================
 
-    def get_state(self, key: str) -> Optional[str]:
+    def get_state(self, key: str) -> str | None:
         """Get a state value."""
-        row = self._conn.execute(
-            "SELECT value FROM agent_state WHERE key = ?", (key,)
-        ).fetchone()
+        row = self._conn.execute("SELECT value FROM agent_state WHERE key = ?", (key,)).fetchone()
         return row["value"] if row else None
 
     def set_state(self, key: str, value: str):
@@ -415,8 +413,7 @@ def set_state(self, key: str, value: str):
         now = self._now()
         with self._tx():
             self._conn.execute(
-                "INSERT OR REPLACE INTO agent_state (key, value, updated_at) "
-                "VALUES (?, ?, ?)",
+                "INSERT OR REPLACE INTO agent_state (key, value, updated_at) VALUES (?, ?, ?)",
                 (key, value, now),
             )
 
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index f8f797bb..0531dcce 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -36,10 +36,9 @@
 import re
 import shutil
 import uuid
-from contextlib import contextmanager
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import yaml
 
@@ -57,11 +56,11 @@
     Intentions,
     Learning,
     Observation,
-    PlannedSession,
-    PlannedSessionStatus,
     PlanItem,
     PlanItemStatus,
     PlanItemType,
+    PlannedSession,
+    PlannedSessionStatus,
     Project,
     Question,
     QuestionStatus,
@@ -80,8 +79,10 @@
 # YAML helpers -- keep datetimes as ISO strings in files
 # ---------------------------------------------------------------------------
 
+
 class _ISODumper(yaml.SafeDumper):
     """Custom dumper that serialises datetime objects as ISO strings."""
+
     pass
 
 
@@ -96,6 +97,7 @@ def _datetime_representer(dumper, data):
 # FileContextStore
 # ---------------------------------------------------------------------------
 
+
 class FileContextStore:
     """
     File-based storage for the agent's context.
@@ -111,9 +113,9 @@ def __init__(self, agent_dir: Path):
         # O(N^2) re-parsing in campaign-tree builds; auto-invalidated by file
         # mtime/size changes and explicitly on _write_yaml. Set BEFORE the index
         # rebuild below, which reads YAML through the cache.
-        self._yaml_cache: Dict[str, tuple] = {}
+        self._yaml_cache: dict[str, tuple] = {}
         # In-memory index: campaign_id -> folder Path
-        self._campaign_index: Dict[str, Path] = {}
+        self._campaign_index: dict[str, Path] = {}
         self._rebuild_campaign_index()
 
     # ------------------------------------------------------------------
@@ -155,7 +157,7 @@ def _rebuild_campaign_index(self):
                     if data and "id" in data:
                         self._campaign_index[data["id"]] = entry
 
-    def _campaign_folder(self, campaign_id: str) -> Optional[Path]:
+    def _campaign_folder(self, campaign_id: str) -> Path | None:
         """Return the folder for a campaign, or None."""
         return self._campaign_index.get(campaign_id)
 
@@ -180,8 +182,14 @@ def _write_yaml(self, path: Path, data):
         path.parent.mkdir(parents=True, exist_ok=True)
         tmp = path.with_suffix(".tmp")
         with open(tmp, "w", encoding="utf-8") as fh:
-            yaml.dump(data, fh, Dumper=_ISODumper, default_flow_style=False,
-                       allow_unicode=True, sort_keys=False)
+            yaml.dump(
+                data,
+                fh,
+                Dumper=_ISODumper,
+                default_flow_style=False,
+                allow_unicode=True,
+                sort_keys=False,
+            )
         # Atomic rename (on Windows this replaces the target).
         os.replace(str(tmp), str(path))
         # Invalidate the parse cache so the next read reloads (new mtime anyway).
@@ -202,7 +210,7 @@ def _read_yaml(self, path: Path):
         if cached is not None and cached[0] == sig:
             return copy.deepcopy(cached[1])
         try:
-            with open(path, "r", encoding="utf-8") as fh:
+            with open(path, encoding="utf-8") as fh:
                 data = yaml.safe_load(fh)
         except Exception:
             logger.warning(f"Failed to read {path}", exc_info=True)
@@ -239,7 +247,7 @@ def __repr__(self):
 
     def reset(self) -> dict:
         """Delete all data files; return counts of deleted items by category."""
-        counts: Dict[str, int] = {}
+        counts: dict[str, int] = {}
 
         def _count_and_remove(subdir: str, label: str):
             d = self.agent_dir / subdir
@@ -286,7 +294,9 @@ def _count_and_remove(subdir: str, label: str):
 
         self._campaign_index.clear()
         total = sum(counts.values())
-        logger.info(f"File context store reset -- {total} items cleared from {len(counts)} categories")
+        logger.info(
+            f"File context store reset -- {total} items cleared from {len(counts)} categories"
+        )
         return counts
 
     # ==================================================================
@@ -317,8 +327,8 @@ def _load_understanding(self) -> Understanding:
             learnings=self.get_learnings(),
         )
 
-    def _load_embryo_states(self) -> Dict[str, EmbryoUnderstanding]:
-        result: Dict[str, EmbryoUnderstanding] = {}
+    def _load_embryo_states(self) -> dict[str, EmbryoUnderstanding]:
+        result: dict[str, EmbryoUnderstanding] = {}
         eu_dir = self.agent_dir / "embryo_understanding"
         if not eu_dir.exists():
             return result
@@ -346,11 +356,11 @@ def _load_attention(self) -> Attention:
     def create_campaign(
         self,
         description: str,
-        shorthand: Optional[str] = None,
-        summary: Optional[str] = None,
-        target: Optional[str] = None,
-        parent_id: Optional[str] = None,
-        campaign_id: Optional[str] = None,
+        shorthand: str | None = None,
+        summary: str | None = None,
+        target: str | None = None,
+        parent_id: str | None = None,
+        campaign_id: str | None = None,
     ) -> str:
         cid = campaign_id or self._gen_id()
         now = self._now()
@@ -384,7 +394,7 @@ def create_campaign(
         logger.info(f"Created campaign {cid} [{label}]")
         return cid
 
-    def get_campaign(self, campaign_id: str) -> Optional[Campaign]:
+    def get_campaign(self, campaign_id: str) -> Campaign | None:
         folder = self._campaign_folder(campaign_id)
         if not folder:
             return None
@@ -393,9 +403,9 @@ def get_campaign(self, campaign_id: str) -> Optional[Campaign]:
             return None
         return self._dict_to_campaign(data)
 
-    def get_active_campaigns(self) -> List[Campaign]:
+    def get_active_campaigns(self) -> list[Campaign]:
         campaigns = []
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
             if data and data.get("status") == "active":
                 campaigns.append(self._dict_to_campaign(data))
@@ -405,7 +415,7 @@ def get_active_campaigns(self) -> List[Campaign]:
     def count_non_active_campaigns(self) -> int:
         """Count campaigns whose status is not 'active'."""
         count = 0
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
             if data and data.get("status") != "active":
                 count += 1
@@ -418,17 +428,17 @@ def count_session_intents(self) -> int:
             return 0
         return sum(1 for f in si_dir.iterdir() if f.suffix in (".yaml", ".yml"))
 
-    def get_all_campaigns(self, limit: int = 50) -> List[Campaign]:
+    def get_all_campaigns(self, limit: int = 50) -> list[Campaign]:
         """Get all campaigns regardless of status, ordered by created_at descending."""
         campaigns = []
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
             if data:
                 campaigns.append(self._dict_to_campaign(data))
         campaigns.sort(key=lambda c: c.created_at, reverse=True)
         return campaigns[:limit]
 
-    def get_recent_session_intents(self, limit: int = 50) -> List[SessionIntent]:
+    def get_recent_session_intents(self, limit: int = 50) -> list[SessionIntent]:
         """Get recent session intents, ordered by created_at descending."""
         si_dir = self.agent_dir / "session_intents"
         if not si_dir.exists():
@@ -442,7 +452,7 @@ def get_recent_session_intents(self, limit: int = 50) -> List[SessionIntent]:
         intents.sort(key=lambda i: i.created_at, reverse=True)
         return intents[:limit]
 
-    def resolve_campaign(self, ref: str) -> Optional[Campaign]:
+    def resolve_campaign(self, ref: str) -> Campaign | None:
         campaign = self.get_campaign(ref)
         if campaign:
             return campaign
@@ -451,7 +461,7 @@ def resolve_campaign(self, ref: str) -> Optional[Campaign]:
             return self.get_campaign(resolved_id)
         return None
 
-    def _resolve_campaign_label(self, label: str) -> Optional[str]:
+    def _resolve_campaign_label(self, label: str) -> str | None:
         label_lower = label.lower()
 
         # Shorthand match (case-insensitive), root campaigns only
@@ -508,11 +518,11 @@ def update_campaign_status(self, campaign_id: str, status: Status):
     def update_campaign(
         self,
         campaign_id: str,
-        description: Optional[str] = None,
-        shorthand: Optional[str] = None,
-        summary: Optional[str] = None,
-        target: Optional[str] = None,
-        parent_id: Optional[str] = None,
+        description: str | None = None,
+        shorthand: str | None = None,
+        summary: str | None = None,
+        target: str | None = None,
+        parent_id: str | None = None,
     ):
         folder = self._campaign_folder(campaign_id)
         if not folder:
@@ -536,8 +546,8 @@ def update_campaign(
         data["updated_at"] = self._now()
         self._write_yaml(folder / "campaign.yaml", data)
 
-    def delete_campaign(self, campaign_id: str, cascade: bool = True) -> Dict[str, int]:
-        counts: Dict[str, int] = {"campaigns": 0, "plan_items": 0, "dependencies": 0}
+    def delete_campaign(self, campaign_id: str, cascade: bool = True) -> dict[str, int]:
+        counts: dict[str, int] = {"campaigns": 0, "plan_items": 0, "dependencies": 0}
 
         def _delete_recursive(cid: str):
             if cascade:
@@ -562,22 +572,22 @@ def _delete_recursive(cid: str):
         _delete_recursive(campaign_id)
         return counts
 
-    def get_subcampaigns(self, campaign_id: str) -> List[Campaign]:
+    def get_subcampaigns(self, campaign_id: str) -> list[Campaign]:
         children = []
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
             if data and data.get("parent_id") == campaign_id:
                 children.append(self._dict_to_campaign(data))
         children.sort(key=lambda c: c.created_at)
         return children
 
-    def get_nth_subcampaign(self, parent_id: str, n: int) -> Optional[Campaign]:
+    def get_nth_subcampaign(self, parent_id: str, n: int) -> Campaign | None:
         phases = self.get_subcampaigns(parent_id)
         if 1 <= n <= len(phases):
             return phases[n - 1]
         return None
 
-    def get_campaign_tree(self, campaign_id: str) -> Dict[str, Any]:
+    def get_campaign_tree(self, campaign_id: str) -> dict[str, Any]:
         campaign = self.get_campaign(campaign_id)
         if not campaign:
             return {}
@@ -587,10 +597,10 @@ def get_campaign_tree(self, campaign_id: str) -> Dict[str, Any]:
             "children": [self.get_campaign_tree(c.id) for c in children],
         }
 
-    def get_root_campaigns(self, status: Optional[str] = "active") -> List[Campaign]:
+    def get_root_campaigns(self, status: str | None = "active") -> list[Campaign]:
         """Get root campaigns (no parent). If status is None, returns all."""
         roots = []
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
             if data and data.get("parent_id") is None:
                 if status is None or data.get("status") == status:
@@ -624,9 +634,9 @@ def unshare_campaign(self, campaign_id: str):
         data["updated_at"] = self._now()
         self._write_yaml(folder / "campaign.yaml", data)
 
-    def get_shared_campaigns(self) -> List[Campaign]:
+    def get_shared_campaigns(self) -> list[Campaign]:
         shared = []
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
             if data and data.get("is_shared"):
                 shared.append(self._dict_to_campaign(data))
@@ -643,16 +653,18 @@ def add_campaign_participant(self, campaign_id: str, instance_id: str, hostname:
         participants = data.get("participants", [])
         # Replace existing entry for this instance_id
         participants = [p for p in participants if p.get("instance_id") != instance_id]
-        participants.append({
-            "campaign_id": campaign_id,
-            "instance_id": instance_id,
-            "hostname": hostname,
-            "joined_at": self._now(),
-        })
+        participants.append(
+            {
+                "campaign_id": campaign_id,
+                "instance_id": instance_id,
+                "hostname": hostname,
+                "joined_at": self._now(),
+            }
+        )
         data["participants"] = participants
         self._write_yaml(folder / "campaign.yaml", data)
 
-    def get_campaign_participants(self, campaign_id: str) -> List[Dict]:
+    def get_campaign_participants(self, campaign_id: str) -> list[dict]:
         folder = self._campaign_folder(campaign_id)
         if not folder:
             return []
@@ -699,8 +711,8 @@ def unclaim_plan_item(self, item_id: str):
     def create_project(
         self,
         description: str,
-        campaign_id: Optional[str] = None,
-        project_id: Optional[str] = None,
+        campaign_id: str | None = None,
+        project_id: str | None = None,
     ) -> str:
         pid = project_id or self._gen_id()
         now = self._now()
@@ -714,13 +726,14 @@ def create_project(
             "updated_at": now,
         }
         self._write_yaml(
-            self.agent_dir / "projects" / f"{pid}_{slug}.yaml", data,
+            self.agent_dir / "projects" / f"{pid}_{slug}.yaml",
+            data,
         )
         logger.info(f"Created project {pid}: {description}")
         return pid
 
-    def get_active_projects(self) -> List[Project]:
-        projects: List[Project] = []
+    def get_active_projects(self) -> list[Project]:
+        projects: list[Project] = []
         proj_dir = self.agent_dir / "projects"
         if not proj_dir.exists():
             return projects
@@ -739,19 +752,23 @@ def get_active_projects(self) -> List[Project]:
     def create_session_intent(
         self,
         session_id: str,
-        planned_intent: Optional[str] = None,
-        campaign_ids: Optional[List[str]] = None,
+        planned_intent: str | None = None,
+        campaign_ids: list[str] | None = None,
     ):
         now = self._now()
         path = self.agent_dir / "session_intents" / f"{session_id}.yaml"
         existing = self._read_yaml(path)
         data = existing or {}
-        data.update({
-            "session_id": session_id,
-            "planned_intent": planned_intent if planned_intent is not None else data.get("planned_intent"),
-            "created_at": data.get("created_at", now),
-            "campaign_ids": data.get("campaign_ids", []),
-        })
+        data.update(
+            {
+                "session_id": session_id,
+                "planned_intent": planned_intent
+                if planned_intent is not None
+                else data.get("planned_intent"),
+                "created_at": data.get("created_at", now),
+                "campaign_ids": data.get("campaign_ids", []),
+            }
+        )
         if "actual_summary" not in data:
             data["actual_summary"] = None
         if "completed_at" not in data:
@@ -762,7 +779,7 @@ def create_session_intent(
             for cid in campaign_ids:
                 self.link_session_campaign(session_id, cid)
 
-    def get_current_session_intent(self) -> Optional[SessionIntent]:
+    def get_current_session_intent(self) -> SessionIntent | None:
         si_dir = self.agent_dir / "session_intents"
         if not si_dir.exists():
             return None
@@ -822,14 +839,14 @@ def unlink_session_campaign(self, session_id: str, campaign_id: str):
         data["campaign_ids"] = cids
         self._write_yaml(path, data)
 
-    def get_campaign_ids_for_session(self, session_id: str) -> List[str]:
+    def get_campaign_ids_for_session(self, session_id: str) -> list[str]:
         path = self.agent_dir / "session_intents" / f"{session_id}.yaml"
         data = self._read_yaml(path)
         if not data:
             return []
         return data.get("campaign_ids", [])
 
-    def get_campaigns_for_session(self, session_id: str) -> List[Campaign]:
+    def get_campaigns_for_session(self, session_id: str) -> list[Campaign]:
         cids = self.get_campaign_ids_for_session(session_id)
         result = []
         for cid in cids:
@@ -838,8 +855,8 @@ def get_campaigns_for_session(self, session_id: str) -> List[Campaign]:
                 result.append(c)
         return result
 
-    def get_sessions_for_campaign(self, campaign_id: str) -> List[SessionIntent]:
-        results: List[SessionIntent] = []
+    def get_sessions_for_campaign(self, campaign_id: str) -> list[SessionIntent]:
+        results: list[SessionIntent] = []
         si_dir = self.agent_dir / "session_intents"
         if not si_dir.exists():
             return results
@@ -858,14 +875,14 @@ def get_sessions_for_campaign(self, campaign_id: str) -> List[SessionIntent]:
     def create_planned_session(
         self,
         scheduled_date: str,
-        title: Optional[str] = None,
-        notes: Optional[str] = None,
-        scheduled_time: Optional[str] = None,
-        estimated_duration_minutes: Optional[int] = None,
-        acquisition_params: Optional[Dict] = None,
-        source_session_id: Optional[str] = None,
-        campaign_ids: Optional[List[str]] = None,
-        planned_session_id: Optional[str] = None,
+        title: str | None = None,
+        notes: str | None = None,
+        scheduled_time: str | None = None,
+        estimated_duration_minutes: int | None = None,
+        acquisition_params: dict | None = None,
+        source_session_id: str | None = None,
+        campaign_ids: list[str] | None = None,
+        planned_session_id: str | None = None,
     ) -> str:
         psid = planned_session_id or self._gen_id()
         now = self._now()
@@ -885,15 +902,15 @@ def create_planned_session(
             "updated_at": now,
         }
         self._write_yaml(
-            self.agent_dir / "planned_sessions" / f"{psid}.yaml", data,
+            self.agent_dir / "planned_sessions" / f"{psid}.yaml",
+            data,
         )
         logger.info(
-            f"Created planned session {psid} for {scheduled_date}: "
-            f"{title or notes or '(untitled)'}"
+            f"Created planned session {psid} for {scheduled_date}: {title or notes or '(untitled)'}"
         )
         return psid
 
-    def get_planned_session(self, planned_session_id: str) -> Optional[PlannedSession]:
+    def get_planned_session(self, planned_session_id: str) -> PlannedSession | None:
         path = self.agent_dir / "planned_sessions" / f"{planned_session_id}.yaml"
         data = self._read_yaml(path)
         if not data:
@@ -902,12 +919,12 @@ def get_planned_session(self, planned_session_id: str) -> Optional[PlannedSessio
 
     def get_planned_sessions(
         self,
-        status: Optional[str] = None,
-        campaign_id: Optional[str] = None,
-        from_date: Optional[str] = None,
-        to_date: Optional[str] = None,
-    ) -> List[PlannedSession]:
-        results: List[PlannedSession] = []
+        status: str | None = None,
+        campaign_id: str | None = None,
+        from_date: str | None = None,
+        to_date: str | None = None,
+    ) -> list[PlannedSession]:
+        results: list[PlannedSession] = []
         ps_dir = self.agent_dir / "planned_sessions"
         if not ps_dir.exists():
             return results
@@ -930,9 +947,9 @@ def get_planned_sessions(
         results.sort(key=lambda ps: (ps.scheduled_date or "", ps.scheduled_time or ""))
         return results
 
-    def get_upcoming_sessions(self, limit: int = 10) -> List[PlannedSession]:
+    def get_upcoming_sessions(self, limit: int = 10) -> list[PlannedSession]:
         today = datetime.now().strftime("%Y-%m-%d")
-        results: List[PlannedSession] = []
+        results: list[PlannedSession] = []
         ps_dir = self.agent_dir / "planned_sessions"
         if not ps_dir.exists():
             return results
@@ -951,9 +968,9 @@ def get_upcoming_sessions(self, limit: int = 10) -> List[PlannedSession]:
         results.sort(key=lambda ps: (ps.scheduled_date or "", ps.scheduled_time or ""))
         return results[:limit]
 
-    def get_todays_sessions(self) -> List[PlannedSession]:
+    def get_todays_sessions(self) -> list[PlannedSession]:
         today = datetime.now().strftime("%Y-%m-%d")
-        results: List[PlannedSession] = []
+        results: list[PlannedSession] = []
         ps_dir = self.agent_dir / "planned_sessions"
         if not ps_dir.exists():
             return results
@@ -974,15 +991,15 @@ def get_todays_sessions(self) -> List[PlannedSession]:
     def update_planned_session(
         self,
         planned_session_id: str,
-        title: Optional[str] = None,
-        notes: Optional[str] = None,
-        scheduled_date: Optional[str] = None,
-        scheduled_time: Optional[str] = None,
-        estimated_duration_minutes: Optional[int] = None,
-        acquisition_params: Optional[Dict] = None,
-        source_session_id: Optional[str] = None,
-        status: Optional[PlannedSessionStatus] = None,
-        session_id: Optional[str] = None,
+        title: str | None = None,
+        notes: str | None = None,
+        scheduled_date: str | None = None,
+        scheduled_time: str | None = None,
+        estimated_duration_minutes: int | None = None,
+        acquisition_params: dict | None = None,
+        source_session_id: str | None = None,
+        status: PlannedSessionStatus | None = None,
+        session_id: str | None = None,
     ):
         path = self.agent_dir / "planned_sessions" / f"{planned_session_id}.yaml"
         data = self._read_yaml(path)
@@ -1041,7 +1058,7 @@ def unlink_planned_session_campaign(self, planned_session_id: str, campaign_id:
         data["campaign_ids"] = cids
         self._write_yaml(path, data)
 
-    def get_campaign_ids_for_planned_session(self, planned_session_id: str) -> List[str]:
+    def get_campaign_ids_for_planned_session(self, planned_session_id: str) -> list[str]:
         path = self.agent_dir / "planned_sessions" / f"{planned_session_id}.yaml"
         data = self._read_yaml(path)
         if not data:
@@ -1052,7 +1069,7 @@ def get_campaign_ids_for_planned_session(self, planned_session_id: str) -> List[
     # Plan Items
     # ==================================================================
 
-    def _read_plan_items_raw(self, campaign_id: str) -> List[Dict]:
+    def _read_plan_items_raw(self, campaign_id: str) -> list[dict]:
         """Read the raw plan items list for a campaign."""
         folder = self._campaign_folder(campaign_id)
         if not folder:
@@ -1062,7 +1079,7 @@ def _read_plan_items_raw(self, campaign_id: str) -> List[Dict]:
             return []
         return data
 
-    def _write_plan_items(self, campaign_id: str, items: List[Dict]):
+    def _write_plan_items(self, campaign_id: str, items: list[dict]):
         """Write the plan items list for a campaign."""
         folder = self._campaign_folder(campaign_id)
         if not folder:
@@ -1070,8 +1087,9 @@ def _write_plan_items(self, campaign_id: str, items: List[Dict]):
         self._write_yaml(folder / "plan" / "current.yaml", items)
 
     def _find_plan_item_location(
-        self, item_id: str,
-    ) -> Optional[tuple]:
+        self,
+        item_id: str,
+    ) -> tuple | None:
         """Find a plan item across all campaigns.
 
         Returns (campaign_id, items_list, index) or None.
@@ -1088,15 +1106,15 @@ def create_plan_item(
         campaign_id: str,
         type: str,
         title: str,
-        description: Optional[str] = None,
-        spec: Optional[Dict] = None,
-        inherit_from: Optional[str] = None,
-        planned_session_id: Optional[str] = None,
+        description: str | None = None,
+        spec: dict | None = None,
+        inherit_from: str | None = None,
+        planned_session_id: str | None = None,
         phase_order: int = -1,
-        depends_on: Optional[List[str]] = None,
-        item_id: Optional[str] = None,
-        references: Optional[List[Dict]] = None,
-        estimated_days: Optional[int] = None,
+        depends_on: list[str] | None = None,
+        item_id: str | None = None,
+        references: list[dict] | None = None,
+        estimated_days: int | None = None,
     ) -> str:
         pid = item_id or self._gen_id()
         now = self._now()
@@ -1136,7 +1154,7 @@ def create_plan_item(
         logger.info(f"Created plan item {pid} [{type}] #{phase_order}: {title}")
         return pid
 
-    def get_plan_item(self, item_id: str) -> Optional[PlanItem]:
+    def get_plan_item(self, item_id: str) -> PlanItem | None:
         loc = self._find_plan_item_location(item_id)
         if not loc:
             return None
@@ -1144,8 +1162,10 @@ def get_plan_item(self, item_id: str) -> Optional[PlanItem]:
         return self._dict_to_plan_item(items[idx])
 
     def resolve_plan_item(
-        self, ref: str, campaign_id: Optional[str] = None,
-    ) -> Optional[PlanItem]:
+        self,
+        ref: str,
+        campaign_id: str | None = None,
+    ) -> PlanItem | None:
         ref = ref.strip().lower()
 
         # Direct ID match
@@ -1154,7 +1174,7 @@ def resolve_plan_item(
             return item
 
         # UUID prefix match
-        if len(ref) >= 4 and re.match(r'^[0-9a-f]+$', ref):
+        if len(ref) >= 4 and re.match(r"^[0-9a-f]+$", ref):
             for cid in self._campaign_index:
                 for raw in self._read_plan_items_raw(cid):
                     if raw.get("id", "").startswith(ref):
@@ -1165,7 +1185,7 @@ def resolve_plan_item(
         task_num = None
 
         # "campaign.phase.task"
-        m = re.match(r'^([^.\s]+)\.(\d+)\.(\d+)$', ref)
+        m = re.match(r"^([^.\s]+)\.(\d+)\.(\d+)$", ref)
         if m:
             campaign_label = m.group(1)
             phase_num, task_num = int(m.group(2)), int(m.group(3))
@@ -1175,25 +1195,25 @@ def resolve_plan_item(
 
         # "1.3" or "2.1"
         if not task_num:
-            m = re.match(r'^(\d+)\.(\d+)$', ref)
+            m = re.match(r"^(\d+)\.(\d+)$", ref)
             if m:
                 phase_num, task_num = int(m.group(1)), int(m.group(2))
 
         # "task 3 of phase 1"
         if not task_num:
-            m = re.search(r'task\s+(\d+)\s+(?:of\s+)?phase\s+(\d+)', ref)
+            m = re.search(r"task\s+(\d+)\s+(?:of\s+)?phase\s+(\d+)", ref)
             if m:
                 task_num, phase_num = int(m.group(1)), int(m.group(2))
 
         # "phase 1 task 3"
         if not task_num:
-            m = re.search(r'phase\s+(\d+)\s+task\s+(\d+)', ref)
+            m = re.search(r"phase\s+(\d+)\s+task\s+(\d+)", ref)
             if m:
                 phase_num, task_num = int(m.group(1)), int(m.group(2))
 
         # "task 3" / "#3" / just "3"
         if not task_num:
-            m = re.match(r'^(?:task\s+|#)?(\d+)$', ref)
+            m = re.match(r"^(?:task\s+|#)?(\d+)$", ref)
             if m:
                 task_num = int(m.group(1))
 
@@ -1220,7 +1240,7 @@ def resolve_plan_item(
         else:
             phases = self.get_subcampaigns(root_id)
             if phases:
-                all_items: List[PlanItem] = []
+                all_items: list[PlanItem] = []
                 for phase in phases:
                     p_items = self.get_plan_items(campaign_id=phase.id)
                     p_items.sort(key=lambda x: x.phase_order)
@@ -1240,11 +1260,11 @@ def resolve_plan_item(
 
     def get_plan_items(
         self,
-        campaign_id: Optional[str] = None,
-        status: Optional[str] = None,
-        type: Optional[str] = None,
+        campaign_id: str | None = None,
+        status: str | None = None,
+        type: str | None = None,
         include_children: bool = False,
-    ) -> List[PlanItem]:
+    ) -> list[PlanItem]:
         if campaign_id and include_children:
             cids = self._get_campaign_tree_ids(campaign_id)
         elif campaign_id:
@@ -1252,7 +1272,7 @@ def get_plan_items(
         else:
             cids = list(self._campaign_index.keys())
 
-        result: List[PlanItem] = []
+        result: list[PlanItem] = []
         for cid in cids:
             for raw in self._read_plan_items_raw(cid):
                 if status and raw.get("status") != status:
@@ -1266,17 +1286,17 @@ def get_plan_items(
     def update_plan_item(
         self,
         item_id: str,
-        title: Optional[str] = None,
-        description: Optional[str] = None,
-        status: Optional[PlanItemStatus] = None,
-        outcome: Optional[str] = None,
-        spec: Optional[Dict] = None,
-        planned_session_id: Optional[str] = None,
-        session_id: Optional[str] = None,
-        phase_order: Optional[int] = None,
-        campaign_id: Optional[str] = None,
-        references: Optional[List[Dict]] = None,
-        estimated_days: Optional[int] = None,
+        title: str | None = None,
+        description: str | None = None,
+        status: PlanItemStatus | None = None,
+        outcome: str | None = None,
+        spec: dict | None = None,
+        planned_session_id: str | None = None,
+        session_id: str | None = None,
+        phase_order: int | None = None,
+        campaign_id: str | None = None,
+        references: list[dict] | None = None,
+        estimated_days: int | None = None,
     ):
         loc = self._find_plan_item_location(item_id)
         if not loc:
@@ -1318,10 +1338,12 @@ def update_plan_item(
 
     def complete_plan_item(self, item_id: str, outcome: str):
         self.update_plan_item(
-            item_id, status=PlanItemStatus.COMPLETED, outcome=outcome,
+            item_id,
+            status=PlanItemStatus.COMPLETED,
+            outcome=outcome,
         )
 
-    def skip_plan_item(self, item_id: str, reason: Optional[str] = None):
+    def skip_plan_item(self, item_id: str, reason: str | None = None):
         self.update_plan_item(
             item_id,
             status=PlanItemStatus.SKIPPED,
@@ -1378,27 +1400,29 @@ def remove_plan_item_dependency(self, item_id: str, depends_on_id: str):
         items[idx]["depends_on"] = deps
         self._write_plan_items(campaign_id, items)
 
-    def get_plan_item_dependencies(self, item_id: str) -> List[str]:
+    def get_plan_item_dependencies(self, item_id: str) -> list[str]:
         loc = self._find_plan_item_location(item_id)
         if not loc:
             return []
         _, items, idx = loc
         return list(items[idx].get("depends_on", []))
 
-    def get_plan_item_dependents(self, item_id: str) -> List[str]:
+    def get_plan_item_dependents(self, item_id: str) -> list[str]:
         """Get IDs of items that depend on this item."""
-        dependents: List[str] = []
+        dependents: list[str] = []
         for cid in self._campaign_index:
             for raw in self._read_plan_items_raw(cid):
                 if item_id in raw.get("depends_on", []):
                     dependents.append(raw["id"])
         return dependents
 
-    def get_unblocked_plan_items(self, campaign_id: str) -> List[PlanItem]:
+    def get_unblocked_plan_items(self, campaign_id: str) -> list[PlanItem]:
         items = self.get_plan_items(
-            campaign_id=campaign_id, status="planned", include_children=True,
+            campaign_id=campaign_id,
+            status="planned",
+            include_children=True,
         )
-        unblocked: List[PlanItem] = []
+        unblocked: list[PlanItem] = []
         for item in items:
             if not item.depends_on:
                 unblocked.append(item)
@@ -1407,7 +1431,8 @@ def get_unblocked_plan_items(self, campaign_id: str) -> List[PlanItem]:
             for dep_id in item.depends_on:
                 dep = self.get_plan_item(dep_id)
                 if dep and dep.status not in (
-                    PlanItemStatus.COMPLETED, PlanItemStatus.SKIPPED,
+                    PlanItemStatus.COMPLETED,
+                    PlanItemStatus.SKIPPED,
                 ):
                     all_resolved = False
                     break
@@ -1415,11 +1440,12 @@ def get_unblocked_plan_items(self, campaign_id: str) -> List[PlanItem]:
                 unblocked.append(item)
         return unblocked
 
-    def get_plan_status(self, campaign_id: str) -> Dict[str, Any]:
+    def get_plan_status(self, campaign_id: str) -> dict[str, Any]:
         items = self.get_plan_items(
-            campaign_id=campaign_id, include_children=True,
+            campaign_id=campaign_id,
+            include_children=True,
         )
-        result: Dict[str, Any] = {
+        result: dict[str, Any] = {
             "total": len(items),
             "completed": 0,
             "in_progress": 0,
@@ -1442,16 +1468,13 @@ def get_plan_status(self, campaign_id: str) -> Dict[str, Any]:
             if item.status == PlanItemStatus.COMPLETED:
                 result["by_type"][type_key]["completed"] += 1
 
-            if (
-                item.type == PlanItemType.DECISION_POINT
-                and item.status == PlanItemStatus.PLANNED
-            ):
+            if item.type == PlanItemType.DECISION_POINT and item.status == PlanItemStatus.PLANNED:
                 result["pending_decisions"].append(item)
 
         result["next_actions"] = self.get_unblocked_plan_items(campaign_id)
         return result
 
-    def resolve_imaging_spec(self, item: PlanItem) -> Optional[ImagingSpec]:
+    def resolve_imaging_spec(self, item: PlanItem) -> ImagingSpec | None:
         if item.type != PlanItemType.IMAGING:
             return None
         if not item.inherit_from:
@@ -1478,7 +1501,7 @@ def resolve_imaging_spec(self, item: PlanItem) -> Optional[ImagingSpec]:
     def save_plan_template(
         self,
         name: str,
-        description: Optional[str],
+        description: str | None,
         campaign_id: str,
     ) -> str:
         campaign = self.get_campaign(campaign_id)
@@ -1504,7 +1527,7 @@ def save_plan_template(
         logger.info(f"Saved plan template '{name}' ({tid})")
         return tid
 
-    def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
+    def _serialize_campaign_tree(self, campaign_id: str) -> dict:
         campaign = self.get_campaign(campaign_id)
         if not campaign:
             return {}
@@ -1512,9 +1535,9 @@ def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
         items.sort(key=lambda x: x.phase_order)
 
         all_item_ids = [it.id for it in items]
-        serialized_items: List[Dict] = []
+        serialized_items: list[dict] = []
         for item in items:
-            item_data: Dict[str, Any] = {
+            item_data: dict[str, Any] = {
                 "type": item.type.value,
                 "title": item.title,
                 "description": item.description,
@@ -1549,9 +1572,7 @@ def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
             serialized_items.append(item_data)
 
         children = self.get_subcampaigns(campaign_id)
-        serialized_children = [
-            self._serialize_campaign_tree(child.id) for child in children
-        ]
+        serialized_children = [self._serialize_campaign_tree(child.id) for child in children]
 
         return {
             "description": campaign.description,
@@ -1561,9 +1582,9 @@ def _serialize_campaign_tree(self, campaign_id: str) -> Dict:
             "children": serialized_children,
         }
 
-    def list_plan_templates(self) -> List[Dict]:
-        templates: List[Dict] = []
-        for cid, folder in self._campaign_index.items():
+    def list_plan_templates(self) -> list[dict]:
+        templates: list[dict] = []
+        for _cid, folder in self._campaign_index.items():
             tpl_dir = folder / "templates"
             if not tpl_dir.exists():
                 continue
@@ -1571,35 +1592,34 @@ def list_plan_templates(self) -> List[Dict]:
                 if f.suffix in (".yaml", ".yml"):
                     data = self._read_yaml(f)
                     if data:
-                        templates.append({
-                            "id": data.get("id", ""),
-                            "name": data.get("name", ""),
-                            "description": data.get("description"),
-                            "created_at": data.get("created_at", ""),
-                            "updated_at": data.get("updated_at", ""),
-                        })
+                        templates.append(
+                            {
+                                "id": data.get("id", ""),
+                                "name": data.get("name", ""),
+                                "description": data.get("description"),
+                                "created_at": data.get("created_at", ""),
+                                "updated_at": data.get("updated_at", ""),
+                            }
+                        )
         templates.sort(key=lambda t: t.get("created_at", ""), reverse=True)
         return templates
 
-    def get_plan_template(self, id_or_name: str) -> Optional[Dict]:
-        for cid, folder in self._campaign_index.items():
+    def get_plan_template(self, id_or_name: str) -> dict | None:
+        for _cid, folder in self._campaign_index.items():
             tpl_dir = folder / "templates"
             if not tpl_dir.exists():
                 continue
             for f in tpl_dir.iterdir():
                 if f.suffix in (".yaml", ".yml"):
                     data = self._read_yaml(f)
-                    if data and (
-                        data.get("id") == id_or_name
-                        or data.get("name") == id_or_name
-                    ):
+                    if data and (data.get("id") == id_or_name or data.get("name") == id_or_name):
                         return data
         return None
 
     def apply_plan_template(
         self,
         template_id: str,
-        overrides: Optional[Dict] = None,
+        overrides: dict | None = None,
     ) -> str:
         tmpl = self.get_plan_template(template_id)
         if not tmpl:
@@ -1610,9 +1630,9 @@ def apply_plan_template(
 
     def _instantiate_template_tree(
         self,
-        data: Dict,
-        parent_id: Optional[str],
-        overrides: Dict,
+        data: dict,
+        parent_id: str | None,
+        overrides: dict,
     ) -> str:
         cid = self.create_campaign(
             description=data.get("description", "Untitled"),
@@ -1621,7 +1641,7 @@ def _instantiate_template_tree(
             parent_id=parent_id,
         )
         items_data = data.get("items", [])
-        new_item_ids: List[str] = []
+        new_item_ids: list[str] = []
 
         for item_data in items_data:
             spec = item_data.get("spec")
@@ -1629,9 +1649,15 @@ def _instantiate_template_tree(
                 spec = dict(spec)
                 for k, v in overrides.items():
                     if k in spec or k in (
-                        "strain", "genotype", "reporter", "temperature_c",
-                        "num_slices", "exposure_ms", "interval_s",
-                        "num_embryos", "stop_condition",
+                        "strain",
+                        "genotype",
+                        "reporter",
+                        "temperature_c",
+                        "num_slices",
+                        "exposure_ms",
+                        "interval_s",
+                        "num_embryos",
+                        "stop_condition",
                     ):
                         spec[k] = v
 
@@ -1651,7 +1677,8 @@ def _instantiate_template_tree(
             for dep_idx in dep_indices:
                 if 0 <= dep_idx < len(new_item_ids):
                     self.add_plan_item_dependency(
-                        new_item_ids[idx_item], new_item_ids[dep_idx],
+                        new_item_ids[idx_item],
+                        new_item_ids[dep_idx],
                     )
 
         for child_data in data.get("children", []):
@@ -1660,17 +1687,14 @@ def _instantiate_template_tree(
         return cid
 
     def delete_plan_template(self, template_id: str) -> bool:
-        for cid, folder in self._campaign_index.items():
+        for _cid, folder in self._campaign_index.items():
             tpl_dir = folder / "templates"
             if not tpl_dir.exists():
                 continue
             for f in tpl_dir.iterdir():
                 if f.suffix in (".yaml", ".yml"):
                     data = self._read_yaml(f)
-                    if data and (
-                        data.get("id") == template_id
-                        or data.get("name") == template_id
-                    ):
+                    if data and (data.get("id") == template_id or data.get("name") == template_id):
                         f.unlink()
                         return True
         return False
@@ -1682,8 +1706,8 @@ def delete_plan_template(self, template_id: str) -> bool:
     def create_plan_snapshot(
         self,
         campaign_id: str,
-        label: Optional[str] = None,
-        summary: Optional[str] = None,
+        label: str | None = None,
+        summary: str | None = None,
     ) -> str:
         snapshot_data = self._serialize_campaign_tree(campaign_id)
         if not summary:
@@ -1719,7 +1743,9 @@ def create_plan_snapshot(
             "created_at": now,
         }
         self._write_yaml(history_dir / f"{timestamp_slug}.yaml", snapshot)
-        logger.info(f"Created plan snapshot v{version_number} ({version_id}) for campaign {campaign_id}")
+        logger.info(
+            f"Created plan snapshot v{version_number} ({version_id}) for campaign {campaign_id}"
+        )
         return version_id
 
     def _generate_snapshot_summary(self, campaign_id: str) -> str:
@@ -1728,7 +1754,7 @@ def _generate_snapshot_summary(self, campaign_id: str) -> str:
             return "Unknown campaign"
         phases = self.get_subcampaigns(campaign_id)
         items = self.get_plan_items(campaign_id=campaign_id, include_children=True)
-        status_counts: Dict[str, int] = {}
+        status_counts: dict[str, int] = {}
         for item in items:
             key = item.status.value
             status_counts[key] = status_counts.get(key, 0) + 1
@@ -1741,7 +1767,7 @@ def _generate_snapshot_summary(self, campaign_id: str) -> str:
             parts.append(f"  {status_name}: {count}")
         return "\n".join(parts)
 
-    def _read_all_snapshots(self, campaign_id: str) -> List[Dict]:
+    def _read_all_snapshots(self, campaign_id: str) -> list[dict]:
         """Read all snapshot files for a campaign."""
         folder = self._campaign_folder(campaign_id)
         if not folder:
@@ -1749,7 +1775,7 @@ def _read_all_snapshots(self, campaign_id: str) -> List[Dict]:
         history_dir = folder / "plan" / "history"
         if not history_dir.exists():
             return []
-        snapshots: List[Dict] = []
+        snapshots: list[dict] = []
         for f in history_dir.iterdir():
             if f.suffix in (".yaml", ".yml"):
                 data = self._read_yaml(f)
@@ -1758,25 +1784,29 @@ def _read_all_snapshots(self, campaign_id: str) -> List[Dict]:
         return snapshots
 
     def list_plan_snapshots(
-        self, campaign_id: str, limit: int = 50,
-    ) -> List[Dict]:
+        self,
+        campaign_id: str,
+        limit: int = 50,
+    ) -> list[dict]:
         snapshots = self._read_all_snapshots(campaign_id)
         # Return metadata only (no blob)
         result = []
         for s in snapshots:
-            result.append({
-                "version_id": s.get("version_id"),
-                "campaign_id": s.get("campaign_id"),
-                "version_number": s.get("version_number"),
-                "summary": s.get("summary"),
-                "label": s.get("label"),
-                "parent_version_id": s.get("parent_version_id"),
-                "created_at": s.get("created_at"),
-            })
+            result.append(
+                {
+                    "version_id": s.get("version_id"),
+                    "campaign_id": s.get("campaign_id"),
+                    "version_number": s.get("version_number"),
+                    "summary": s.get("summary"),
+                    "label": s.get("label"),
+                    "parent_version_id": s.get("parent_version_id"),
+                    "created_at": s.get("created_at"),
+                }
+            )
         result.sort(key=lambda s: s.get("version_number", 0), reverse=True)
         return result[:limit]
 
-    def get_plan_snapshot(self, version_id: str) -> Optional[Dict]:
+    def get_plan_snapshot(self, version_id: str) -> dict | None:
         for cid in self._campaign_index:
             for snap in self._read_all_snapshots(cid):
                 if snap.get("version_id") == version_id:
@@ -1817,7 +1847,7 @@ def restore_plan_snapshot(self, version_id: str) -> str:
         )
         return new_campaign_id
 
-    def _get_campaign_tree_ids(self, campaign_id: str) -> List[str]:
+    def _get_campaign_tree_ids(self, campaign_id: str) -> list[str]:
         ids = [campaign_id]
         for cid, folder in self._campaign_index.items():
             data = self._read_yaml(folder / "campaign.yaml")
@@ -1843,14 +1873,15 @@ def add_observation(self, obs: Observation):
             "relates_to": obs.relates_to,
         }
         self._write_yaml(
-            self.agent_dir / "observations" / f"{obs.id}_{slug}.yaml", data,
+            self.agent_dir / "observations" / f"{obs.id}_{slug}.yaml",
+            data,
         )
 
-    def get_recent_observations(self, limit: int = 50) -> List[Observation]:
+    def get_recent_observations(self, limit: int = 50) -> list[Observation]:
         obs_dir = self.agent_dir / "observations"
         if not obs_dir.exists():
             return []
-        all_obs: List[Observation] = []
+        all_obs: list[Observation] = []
         for f in obs_dir.iterdir():
             if f.suffix in (".yaml", ".yml"):
                 data = self._read_yaml(f)
@@ -1860,11 +1891,11 @@ def get_recent_observations(self, limit: int = 50) -> List[Observation]:
         # Return in chronological order (oldest first in the window)
         return list(reversed(all_obs[:limit]))
 
-    def get_observations_for_embryo(self, embryo_id: str, limit: int = 20) -> List[Observation]:
+    def get_observations_for_embryo(self, embryo_id: str, limit: int = 20) -> list[Observation]:
         obs_dir = self.agent_dir / "observations"
         if not obs_dir.exists():
             return []
-        matches: List[Observation] = []
+        matches: list[Observation] = []
         for f in obs_dir.iterdir():
             if f.suffix in (".yaml", ".yml"):
                 data = self._read_yaml(f)
@@ -1880,34 +1911,34 @@ def get_observations_for_embryo(self, embryo_id: str, limit: int = 20) -> List[O
     def add_expectation(self, exp: Expectation):
         path = self.agent_dir / "active" / "expectations.yaml"
         items = self._read_yaml(path) or []
-        items.append({
-            "id": exp.id,
-            "target": exp.target,
-            "prediction": exp.prediction,
-            "expected_time": exp.expected_time.isoformat(),
-            "uncertainty": exp.uncertainty,
-            "basis": exp.basis,
-            "status": exp.status.value,
-            "created_at": exp.created_at.isoformat(),
-            "resolved_at": None,
-        })
+        items.append(
+            {
+                "id": exp.id,
+                "target": exp.target,
+                "prediction": exp.prediction,
+                "expected_time": exp.expected_time.isoformat(),
+                "uncertainty": exp.uncertainty,
+                "basis": exp.basis,
+                "status": exp.status.value,
+                "created_at": exp.created_at.isoformat(),
+                "resolved_at": None,
+            }
+        )
         self._write_yaml(path, items)
 
-    def get_pending_expectations(self) -> List[Expectation]:
+    def get_pending_expectations(self) -> list[Expectation]:
         path = self.agent_dir / "active" / "expectations.yaml"
         items = self._read_yaml(path) or []
-        pending = [
-            self._dict_to_expectation(d) for d in items
-            if d.get("status") == "pending"
-        ]
+        pending = [self._dict_to_expectation(d) for d in items if d.get("status") == "pending"]
         pending.sort(key=lambda e: e.expected_time)
         return pending
 
-    def get_expectation_for(self, target: str) -> Optional[Expectation]:
+    def get_expectation_for(self, target: str) -> Expectation | None:
         path = self.agent_dir / "active" / "expectations.yaml"
         items = self._read_yaml(path) or []
         candidates = [
-            self._dict_to_expectation(d) for d in items
+            self._dict_to_expectation(d)
+            for d in items
             if d.get("target") == target and d.get("status") == "pending"
         ]
         if not candidates:
@@ -1933,23 +1964,22 @@ def resolve_expectation(self, exp_id: str, status: ExpectationStatus):
     def add_watchpoint(self, wp: Watchpoint):
         path = self.agent_dir / "active" / "watchpoints.yaml"
         items = self._read_yaml(path) or []
-        items.append({
-            "id": wp.id,
-            "target": wp.target,
-            "condition": wp.condition,
-            "priority": wp.priority.value if wp.priority else "medium",
-            "status": wp.status.value,
-            "created_at": wp.created_at.isoformat(),
-        })
+        items.append(
+            {
+                "id": wp.id,
+                "target": wp.target,
+                "condition": wp.condition,
+                "priority": wp.priority.value if wp.priority else "medium",
+                "status": wp.status.value,
+                "created_at": wp.created_at.isoformat(),
+            }
+        )
         self._write_yaml(path, items)
 
-    def get_active_watchpoints(self) -> List[Watchpoint]:
+    def get_active_watchpoints(self) -> list[Watchpoint]:
         path = self.agent_dir / "active" / "watchpoints.yaml"
         items = self._read_yaml(path) or []
-        active = [
-            self._dict_to_watchpoint(d) for d in items
-            if d.get("status") == "active"
-        ]
+        active = [self._dict_to_watchpoint(d) for d in items if d.get("status") == "active"]
         # Sort: high > medium > low, then by created_at
         priority_order = {"high": 0, "medium": 1, "low": 2}
         active.sort(key=lambda w: (priority_order.get(w.priority.value, 1), w.created_at))
@@ -1980,22 +2010,23 @@ def resolve_watchpoint(self, wp_id: str):
     def add_question(self, q: Question):
         path = self.agent_dir / "active" / "questions.yaml"
         items = self._read_yaml(path) or []
-        items.append({
-            "id": q.id,
-            "content": q.content,
-            "status": q.status.value,
-            "resolution": None,
-            "created_at": q.created_at.isoformat(),
-            "resolved_at": None,
-        })
+        items.append(
+            {
+                "id": q.id,
+                "content": q.content,
+                "status": q.status.value,
+                "resolution": None,
+                "created_at": q.created_at.isoformat(),
+                "resolved_at": None,
+            }
+        )
         self._write_yaml(path, items)
 
-    def get_open_questions(self) -> List[Question]:
+    def get_open_questions(self) -> list[Question]:
         path = self.agent_dir / "active" / "questions.yaml"
         items = self._read_yaml(path) or []
         open_qs = [
-            self._dict_to_question(d) for d in items
-            if d.get("status") in ("open", "investigating")
+            self._dict_to_question(d) for d in items if d.get("status") in ("open", "investigating")
         ]
         open_qs.sort(key=lambda q: q.created_at)
         return open_qs
@@ -2026,20 +2057,21 @@ def add_learning(self, learning: Learning):
             "created_at": learning.created_at.isoformat(),
         }
         self._write_yaml(
-            self.agent_dir / "learnings" / f"{learning.id}_{slug}.yaml", data,
+            self.agent_dir / "learnings" / f"{learning.id}_{slug}.yaml",
+            data,
         )
 
-    def get_learnings(self, limit: int = 50) -> List[Learning]:
+    def get_learnings(self, limit: int = 50) -> list[Learning]:
         learn_dir = self.agent_dir / "learnings"
         if not learn_dir.exists():
             return []
-        all_learnings: List[Learning] = []
+        all_learnings: list[Learning] = []
         for f in learn_dir.iterdir():
             if f.suffix in (".yaml", ".yml"):
                 data = self._read_yaml(f)
                 if data:
                     all_learnings.append(self._dict_to_learning(data))
-        all_learnings.sort(key=lambda l: l.created_at, reverse=True)
+        all_learnings.sort(key=lambda learning: learning.created_at, reverse=True)
         return all_learnings[:limit]
 
     # ==================================================================
@@ -2049,13 +2081,13 @@ def get_learnings(self, limit: int = 50) -> List[Learning]:
     def update_embryo_understanding(
         self,
         embryo_id: str,
-        current_stage: Optional[str] = None,
-        stage_confidence: Optional[Confidence] = None,
-        health_assessment: Optional[str] = None,
-        note: Optional[str] = None,
-        is_hatched: Optional[bool] = None,
-        needs_attention: Optional[bool] = None,
-        attention_reason: Optional[str] = None,
+        current_stage: str | None = None,
+        stage_confidence: Confidence | None = None,
+        health_assessment: str | None = None,
+        note: str | None = None,
+        is_hatched: bool | None = None,
+        needs_attention: bool | None = None,
+        attention_reason: str | None = None,
     ):
         now = self._now()
         path = self.agent_dir / "embryo_understanding" / f"{embryo_id}.yaml"
@@ -2101,7 +2133,7 @@ def update_embryo_understanding(
     # Agent State
     # ==================================================================
 
-    def get_state(self, key: str) -> Optional[str]:
+    def get_state(self, key: str) -> str | None:
         path = self.agent_dir / "state.yaml"
         data = self._read_yaml(path)
         if not data or not isinstance(data, dict):
@@ -2158,10 +2190,10 @@ def create_ml_pipeline(
         campaign_id: str,
         name: str,
         task: str = "embryo_stage_classification",
-        model_config: Optional[Dict] = None,
-        data_split: Optional[Dict] = None,
-        training_config: Optional[Dict] = None,
-    ) -> Dict[str, Any]:
+        model_config: dict | None = None,
+        data_split: dict | None = None,
+        training_config: dict | None = None,
+    ) -> dict[str, Any]:
         pipeline_id = self._gen_id()
         now = self._now()
         data = {
@@ -2179,11 +2211,12 @@ def create_ml_pipeline(
             "updated_at": now,
         }
         self._write_yaml(
-            self.agent_dir / "ml" / "pipelines" / f"{pipeline_id}.yaml", data,
+            self.agent_dir / "ml" / "pipelines" / f"{pipeline_id}.yaml",
+            data,
         )
         return self.get_ml_pipeline(pipeline_id)
 
-    def get_ml_pipeline(self, pipeline_id: str) -> Optional[Dict[str, Any]]:
+    def get_ml_pipeline(self, pipeline_id: str) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "pipelines" / f"{pipeline_id}.yaml"
         data = self._read_yaml(path)
         if not data:
@@ -2203,11 +2236,11 @@ def get_ml_pipeline(self, pipeline_id: str) -> Optional[Dict[str, Any]]:
             "updated_at": data.get("updated_at"),
         }
 
-    def list_ml_pipelines(self, campaign_id: Optional[str] = None) -> List[Dict[str, Any]]:
+    def list_ml_pipelines(self, campaign_id: str | None = None) -> list[dict[str, Any]]:
         pipe_dir = self.agent_dir / "ml" / "pipelines"
         if not pipe_dir.exists():
             return []
-        results: List[Dict[str, Any]] = []
+        results: list[dict[str, Any]] = []
         for f in pipe_dir.iterdir():
             if f.suffix in (".yaml", ".yml"):
                 data = self._read_yaml(f)
@@ -2221,13 +2254,20 @@ def list_ml_pipelines(self, campaign_id: Optional[str] = None) -> List[Dict[str,
         results.sort(key=lambda p: p.get("created_at", ""), reverse=True)
         return results
 
-    def update_ml_pipeline(self, pipeline_id: str, **kwargs) -> Optional[Dict[str, Any]]:
+    def update_ml_pipeline(self, pipeline_id: str, **kwargs) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "pipelines" / f"{pipeline_id}.yaml"
         data = self._read_yaml(path)
         if not data:
             return self.get_ml_pipeline(pipeline_id)
-        allowed = {"status", "model_config", "data_split", "training_config",
-                    "best_run_id", "best_accuracy", "name"}
+        allowed = {
+            "status",
+            "model_config",
+            "data_split",
+            "training_config",
+            "best_run_id",
+            "best_accuracy",
+            "name",
+        }
         changed = False
         for k, v in kwargs.items():
             if k in allowed:
@@ -2245,11 +2285,11 @@ def update_ml_pipeline(self, pipeline_id: str, **kwargs) -> Optional[Dict[str, A
     def create_training_run(
         self,
         pipeline_id: str,
-        model_config: Optional[Dict] = None,
-        training_config: Optional[Dict] = None,
-        data_split: Optional[Dict] = None,
+        model_config: dict | None = None,
+        training_config: dict | None = None,
+        data_split: dict | None = None,
         peer_instance_id: str = "",
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         run_id = self._gen_id()
         data = {
             "id": run_id,
@@ -2272,11 +2312,12 @@ def create_training_run(
             "error_message": "",
         }
         self._write_yaml(
-            self.agent_dir / "ml" / "runs" / f"{run_id}.yaml", data,
+            self.agent_dir / "ml" / "runs" / f"{run_id}.yaml",
+            data,
         )
         return self.get_training_run(run_id)
 
-    def get_training_run(self, run_id: str) -> Optional[Dict[str, Any]]:
+    def get_training_run(self, run_id: str) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "runs" / f"{run_id}.yaml"
         data = self._read_yaml(path)
         if not data:
@@ -2302,11 +2343,11 @@ def get_training_run(self, run_id: str) -> Optional[Dict[str, Any]]:
             "error_message": data.get("error_message", ""),
         }
 
-    def list_training_runs(self, pipeline_id: str) -> List[Dict[str, Any]]:
+    def list_training_runs(self, pipeline_id: str) -> list[dict[str, Any]]:
         runs_dir = self.agent_dir / "ml" / "runs"
         if not runs_dir.exists():
             return []
-        results: List[Dict[str, Any]] = []
+        results: list[dict[str, Any]] = []
         for f in runs_dir.iterdir():
             if f.suffix in (".yaml", ".yml"):
                 data = self._read_yaml(f)
@@ -2316,15 +2357,24 @@ def list_training_runs(self, pipeline_id: str) -> List[Dict[str, Any]]:
                         results.append(run)
         return results
 
-    def update_training_run(self, run_id: str, **kwargs) -> Optional[Dict[str, Any]]:
+    def update_training_run(self, run_id: str, **kwargs) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "runs" / f"{run_id}.yaml"
         data = self._read_yaml(path)
         if not data:
             return self.get_training_run(run_id)
         allowed = {
-            "status", "current_epoch", "total_epochs", "train_loss", "val_loss",
-            "val_accuracy", "best_val_accuracy", "model_weights_path", "metrics_path",
-            "started_at", "completed_at", "error_message",
+            "status",
+            "current_epoch",
+            "total_epochs",
+            "train_loss",
+            "val_loss",
+            "val_accuracy",
+            "best_val_accuracy",
+            "model_weights_path",
+            "metrics_path",
+            "started_at",
+            "completed_at",
+            "error_message",
         }
         changed = False
         for k, v in kwargs.items():
@@ -2341,15 +2391,15 @@ def update_training_run(self, run_id: str, **kwargs) -> Optional[Dict[str, Any]]
 
     def save_data_assessment(
         self,
-        pipeline_id: Optional[str] = None,
+        pipeline_id: str | None = None,
         total_sessions: int = 0,
         total_embryos: int = 0,
         total_volumes: int = 0,
         annotated_embryos: int = 0,
-        stage_distribution: Optional[Dict] = None,
-        coverage_gaps: Optional[List] = None,
+        stage_distribution: dict | None = None,
+        coverage_gaps: list | None = None,
         quality_notes: str = "",
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         assessment_id = self._gen_id()
         now = self._now()
         data = {
@@ -2365,11 +2415,12 @@ def save_data_assessment(
             "created_at": now,
         }
         self._write_yaml(
-            self.agent_dir / "ml" / "assessments" / f"{assessment_id}.yaml", data,
+            self.agent_dir / "ml" / "assessments" / f"{assessment_id}.yaml",
+            data,
         )
         return self.get_data_assessment(assessment_id)
 
-    def get_data_assessment(self, assessment_id: str) -> Optional[Dict[str, Any]]:
+    def get_data_assessment(self, assessment_id: str) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "assessments" / f"{assessment_id}.yaml"
         data = self._read_yaml(path)
         if not data:
@@ -2392,7 +2443,7 @@ def get_data_assessment(self, assessment_id: str) -> Optional[Dict[str, Any]]:
     # ==================================================================
 
     @staticmethod
-    def _dict_to_campaign(d: Dict) -> Campaign:
+    def _dict_to_campaign(d: dict) -> Campaign:
         return Campaign(
             id=d["id"],
             description=d["description"],
@@ -2403,22 +2454,30 @@ def _dict_to_campaign(d: Dict) -> Campaign:
             parent_id=d.get("parent_id"),
             status=Status(d.get("status", "active")),
             is_shared=bool(d.get("is_shared", False)),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d["created_at"], str) else d["created_at"],
-            updated_at=datetime.fromisoformat(d["updated_at"]) if isinstance(d["updated_at"], str) else d["updated_at"],
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d["created_at"], str)
+            else d["created_at"],
+            updated_at=datetime.fromisoformat(d["updated_at"])
+            if isinstance(d["updated_at"], str)
+            else d["updated_at"],
         )
 
     @staticmethod
-    def _dict_to_project(d: Dict) -> Project:
+    def _dict_to_project(d: dict) -> Project:
         return Project(
             id=d["id"],
             description=d["description"],
             campaign_id=d.get("campaign_id"),
             status=Status(d.get("status", "active")),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d["created_at"], str) else d["created_at"],
-            updated_at=datetime.fromisoformat(d["updated_at"]) if isinstance(d["updated_at"], str) else d["updated_at"],
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d["created_at"], str)
+            else d["created_at"],
+            updated_at=datetime.fromisoformat(d["updated_at"])
+            if isinstance(d["updated_at"], str)
+            else d["updated_at"],
         )
 
-    def _dict_to_session_intent(self, d: Dict) -> SessionIntent:
+    def _dict_to_session_intent(self, d: dict) -> SessionIntent:
         session_id = d["session_id"]
         campaign_ids = d.get("campaign_ids", [])
         return SessionIntent(
@@ -2426,12 +2485,16 @@ def _dict_to_session_intent(self, d: Dict) -> SessionIntent:
             planned_intent=d.get("planned_intent"),
             actual_summary=d.get("actual_summary"),
             campaign_ids=campaign_ids,
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
-            completed_at=datetime.fromisoformat(d["completed_at"]) if d.get("completed_at") and isinstance(d["completed_at"], str) else None,
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
+            completed_at=datetime.fromisoformat(d["completed_at"])
+            if d.get("completed_at") and isinstance(d["completed_at"], str)
+            else None,
         )
 
     @staticmethod
-    def _dict_to_planned_session(d: Dict) -> PlannedSession:
+    def _dict_to_planned_session(d: dict) -> PlannedSession:
         return PlannedSession(
             id=d["id"],
             title=d.get("title"),
@@ -2444,12 +2507,16 @@ def _dict_to_planned_session(d: Dict) -> PlannedSession:
             status=PlannedSessionStatus(d.get("status", "planned")),
             session_id=d.get("session_id"),
             campaign_ids=d.get("campaign_ids", []),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
-            updated_at=datetime.fromisoformat(d["updated_at"]) if isinstance(d.get("updated_at"), str) else d.get("updated_at", datetime.now()),
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
+            updated_at=datetime.fromisoformat(d["updated_at"])
+            if isinstance(d.get("updated_at"), str)
+            else d.get("updated_at", datetime.now()),
         )
 
     @staticmethod
-    def _dict_to_plan_item(d: Dict) -> PlanItem:
+    def _dict_to_plan_item(d: dict) -> PlanItem:
         item_type = PlanItemType(d["type"])
         spec_data = d.get("spec")
         imaging_spec = None
@@ -2458,14 +2525,10 @@ def _dict_to_plan_item(d: Dict) -> PlanItem:
         if spec_data:
             if item_type == PlanItemType.IMAGING:
                 valid = {f.name for f in dataclasses.fields(ImagingSpec)}
-                imaging_spec = ImagingSpec(**{
-                    k: v for k, v in spec_data.items() if k in valid
-                })
+                imaging_spec = ImagingSpec(**{k: v for k, v in spec_data.items() if k in valid})
             else:
                 valid = {f.name for f in dataclasses.fields(BenchSpec)}
-                bench_spec = BenchSpec(**{
-                    k: v for k, v in spec_data.items() if k in valid
-                })
+                bench_spec = BenchSpec(**{k: v for k, v in spec_data.items() if k in valid})
 
         references = d.get("references") or []
 
@@ -2488,15 +2551,21 @@ def _dict_to_plan_item(d: Dict) -> PlanItem:
             inherit_from=d.get("inherit_from"),
             estimated_days=d.get("estimated_days"),
             phase_order=d.get("phase_order", 0),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
-            updated_at=datetime.fromisoformat(d["updated_at"]) if isinstance(d.get("updated_at"), str) else d.get("updated_at", datetime.now()),
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
+            updated_at=datetime.fromisoformat(d["updated_at"])
+            if isinstance(d.get("updated_at"), str)
+            else d.get("updated_at", datetime.now()),
         )
 
     @staticmethod
-    def _dict_to_observation(d: Dict) -> Observation:
+    def _dict_to_observation(d: dict) -> Observation:
         return Observation(
             id=d["id"],
-            timestamp=datetime.fromisoformat(d["timestamp"]) if isinstance(d.get("timestamp"), str) else d.get("timestamp", datetime.now()),
+            timestamp=datetime.fromisoformat(d["timestamp"])
+            if isinstance(d.get("timestamp"), str)
+            else d.get("timestamp", datetime.now()),
             type=d["type"],
             content=d["content"],
             embryo_id=d.get("embryo_id"),
@@ -2507,60 +2576,78 @@ def _dict_to_observation(d: Dict) -> Observation:
         )
 
     @staticmethod
-    def _dict_to_expectation(d: Dict) -> Expectation:
+    def _dict_to_expectation(d: dict) -> Expectation:
         return Expectation(
             id=d["id"],
             target=d["target"],
             prediction=d["prediction"],
-            expected_time=datetime.fromisoformat(d["expected_time"]) if isinstance(d.get("expected_time"), str) else d.get("expected_time", datetime.now()),
+            expected_time=datetime.fromisoformat(d["expected_time"])
+            if isinstance(d.get("expected_time"), str)
+            else d.get("expected_time", datetime.now()),
             uncertainty=d.get("uncertainty"),
             basis=d.get("basis"),
             status=ExpectationStatus(d.get("status", "pending")),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
-            resolved_at=datetime.fromisoformat(d["resolved_at"]) if d.get("resolved_at") and isinstance(d["resolved_at"], str) else None,
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
+            resolved_at=datetime.fromisoformat(d["resolved_at"])
+            if d.get("resolved_at") and isinstance(d["resolved_at"], str)
+            else None,
         )
 
     @staticmethod
-    def _dict_to_watchpoint(d: Dict) -> Watchpoint:
+    def _dict_to_watchpoint(d: dict) -> Watchpoint:
         return Watchpoint(
             id=d["id"],
             target=d["target"],
             condition=d["condition"],
             priority=Significance(d.get("priority", "medium")),
             status=WatchpointStatus(d.get("status", "active")),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
         )
 
     @staticmethod
-    def _dict_to_question(d: Dict) -> Question:
+    def _dict_to_question(d: dict) -> Question:
         return Question(
             id=d["id"],
             content=d["content"],
             status=QuestionStatus(d.get("status", "open")),
             resolution=d.get("resolution"),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
-            resolved_at=datetime.fromisoformat(d["resolved_at"]) if d.get("resolved_at") and isinstance(d["resolved_at"], str) else None,
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
+            resolved_at=datetime.fromisoformat(d["resolved_at"])
+            if d.get("resolved_at") and isinstance(d["resolved_at"], str)
+            else None,
         )
 
     @staticmethod
-    def _dict_to_learning(d: Dict) -> Learning:
+    def _dict_to_learning(d: dict) -> Learning:
         return Learning(
             id=d["id"],
             content=d["content"],
             confidence=Confidence(d.get("confidence", "medium")),
             basis=d.get("basis"),
-            created_at=datetime.fromisoformat(d["created_at"]) if isinstance(d.get("created_at"), str) else d.get("created_at", datetime.now()),
+            created_at=datetime.fromisoformat(d["created_at"])
+            if isinstance(d.get("created_at"), str)
+            else d.get("created_at", datetime.now()),
         )
 
     @staticmethod
-    def _dict_to_embryo_understanding(d: Dict) -> EmbryoUnderstanding:
+    def _dict_to_embryo_understanding(d: dict) -> EmbryoUnderstanding:
         return EmbryoUnderstanding(
             embryo_id=d["embryo_id"],
             current_stage=d.get("current_stage"),
-            stage_confidence=Confidence(d["stage_confidence"]) if d.get("stage_confidence") else None,
+            stage_confidence=Confidence(d["stage_confidence"])
+            if d.get("stage_confidence")
+            else None,
             health_assessment=d.get("health_assessment"),
             notes=d.get("notes") or [],
-            last_observed=datetime.fromisoformat(d["last_observed"]) if d.get("last_observed") and isinstance(d["last_observed"], str) else None,
+            last_observed=datetime.fromisoformat(d["last_observed"])
+            if d.get("last_observed") and isinstance(d["last_observed"], str)
+            else None,
             is_tracked=d.get("is_tracked", True),
             is_hatched=bool(d.get("is_hatched", False)),
             needs_attention=bool(d.get("needs_attention", False)),
diff --git a/gently/harness/memory/gap_assessment.py b/gently/harness/memory/gap_assessment.py
index d43a5ec0..4b64a10b 100644
--- a/gently/harness/memory/gap_assessment.py
+++ b/gently/harness/memory/gap_assessment.py
@@ -9,9 +9,9 @@
 import logging
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import List, Optional
 
 from .model import Campaign
+
 try:
     from .file_store import FileContextStore as ContextStore
 except ImportError:
@@ -22,22 +22,25 @@
 
 class GapLayer(str, Enum):
     """Which context layer has a gap."""
-    LAB = "lab"           # Layer 1: lab identity, setup, organism
+
+    LAB = "lab"  # Layer 1: lab identity, setup, organism
     CAMPAIGN = "campaign"  # Layer 2: research direction, goals
-    SESSION = "session"    # Layer 3: today's intent
+    SESSION = "session"  # Layer 3: today's intent
     REALTIME = "realtime"  # Layer 4: current observations (never gapped)
 
 
 class GapSeverity(str, Enum):
     """How critical this gap is."""
-    EMPTY = "empty"        # Nothing at all — full onboarding needed
-    THIN = "thin"          # Some context exists but insufficient
+
+    EMPTY = "empty"  # Nothing at all — full onboarding needed
+    THIN = "thin"  # Some context exists but insufficient
     ADEQUATE = "adequate"  # Enough to function, could be richer
 
 
 @dataclass
 class Gap:
     """A single identified gap in the daemon's knowledge."""
+
     layer: GapLayer
     severity: GapSeverity
     description: str
@@ -51,12 +54,13 @@ class ContextGapReport:
 
     Drives the startup wizard: which steps to show, what to ask.
     """
-    gaps: List[Gap] = field(default_factory=list)
+
+    gaps: list[Gap] = field(default_factory=list)
     readiness: float = 0.0  # 0.0 (blank) to 1.0 (fully oriented)
     needs_lab_onboarding: bool = False
     needs_campaign: bool = False
     needs_session_intent: bool = False
-    active_campaigns: List[Campaign] = field(default_factory=list)  # All active campaigns
+    active_campaigns: list[Campaign] = field(default_factory=list)  # All active campaigns
     past_campaign_count: int = 0  # Completed/paused campaigns
     session_count: int = 0  # How many past sessions exist
     learning_count: int = 0
@@ -102,28 +106,41 @@ def assess_gaps(context_store: ContextStore) -> ContextGapReport:
 
     # Check for lab-level knowledge (learnings about the setup, organism, etc.)
     lab_learnings = [
-        l for l in learnings
-        if l.basis and any(
-            kw in l.basis.lower()
-            for kw in ("lab", "setup", "microscope", "organism", "onboarding", "identity")
+        learning
+        for learning in learnings
+        if learning.basis
+        and any(
+            kw in learning.basis.lower()
+            for kw in (
+                "lab",
+                "setup",
+                "microscope",
+                "organism",
+                "onboarding",
+                "identity",
+            )
         )
     ]
 
     if not learnings:
         report.needs_lab_onboarding = True
-        report.gaps.append(Gap(
-            layer=GapLayer.LAB,
-            severity=GapSeverity.EMPTY,
-            description="No learnings at all — this appears to be a first launch.",
-            suggested_action="Conduct lab onboarding conversation.",
-        ))
+        report.gaps.append(
+            Gap(
+                layer=GapLayer.LAB,
+                severity=GapSeverity.EMPTY,
+                description="No learnings at all — this appears to be a first launch.",
+                suggested_action="Conduct lab onboarding conversation.",
+            )
+        )
     elif not lab_learnings:
-        report.gaps.append(Gap(
-            layer=GapLayer.LAB,
-            severity=GapSeverity.THIN,
-            description="Have learnings but none about lab identity/setup.",
-            suggested_action="Ask about lab setup and research program.",
-        ))
+        report.gaps.append(
+            Gap(
+                layer=GapLayer.LAB,
+                severity=GapSeverity.THIN,
+                description="Have learnings but none about lab identity/setup.",
+                suggested_action="Ask about lab setup and research program.",
+            )
+        )
         readiness_score += 0.1
     else:
         readiness_score += 0.25
@@ -139,19 +156,23 @@ def assess_gaps(context_store: ContextStore) -> ContextGapReport:
         report.needs_campaign = True
 
         if report.past_campaign_count == 0:
-            report.gaps.append(Gap(
-                layer=GapLayer.CAMPAIGN,
-                severity=GapSeverity.EMPTY,
-                description="No campaigns ever created — no research direction.",
-                suggested_action="Ask about research goals or suggest ingesting papers.",
-            ))
+            report.gaps.append(
+                Gap(
+                    layer=GapLayer.CAMPAIGN,
+                    severity=GapSeverity.EMPTY,
+                    description="No campaigns ever created — no research direction.",
+                    suggested_action="Ask about research goals or suggest ingesting papers.",
+                )
+            )
         else:
-            report.gaps.append(Gap(
-                layer=GapLayer.CAMPAIGN,
-                severity=GapSeverity.THIN,
-                description=f"{report.past_campaign_count} past campaigns but none active.",
-                suggested_action="Ask if starting new work or resuming.",
-            ))
+            report.gaps.append(
+                Gap(
+                    layer=GapLayer.CAMPAIGN,
+                    severity=GapSeverity.THIN,
+                    description=f"{report.past_campaign_count} past campaigns but none active.",
+                    suggested_action="Ask if starting new work or resuming.",
+                )
+            )
             readiness_score += 0.1
     else:
         readiness_score += 0.25
@@ -166,19 +187,23 @@ def assess_gaps(context_store: ContextStore) -> ContextGapReport:
         report.session_count = context_store.count_session_intents()
 
         if report.session_count == 0:
-            report.gaps.append(Gap(
-                layer=GapLayer.SESSION,
-                severity=GapSeverity.EMPTY,
-                description="No session history at all.",
-                suggested_action="Establish session intent after campaign context.",
-            ))
+            report.gaps.append(
+                Gap(
+                    layer=GapLayer.SESSION,
+                    severity=GapSeverity.EMPTY,
+                    description="No session history at all.",
+                    suggested_action="Establish session intent after campaign context.",
+                )
+            )
         else:
-            report.gaps.append(Gap(
-                layer=GapLayer.SESSION,
-                severity=GapSeverity.THIN,
-                description=f"{report.session_count} past sessions, but no intent for current.",
-                suggested_action="Quick check-in: continuing campaign or starting fresh?",
-            ))
+            report.gaps.append(
+                Gap(
+                    layer=GapLayer.SESSION,
+                    severity=GapSeverity.THIN,
+                    description=f"{report.session_count} past sessions, but no intent for current.",
+                    suggested_action="Quick check-in: continuing campaign or starting fresh?",
+                )
+            )
             readiness_score += 0.1
     else:
         readiness_score += 0.25
diff --git a/gently/harness/memory/interface.py b/gently/harness/memory/interface.py
index 49712371..7eba1774 100644
--- a/gently/harness/memory/interface.py
+++ b/gently/harness/memory/interface.py
@@ -10,7 +10,6 @@
 """
 
 import logging
-from typing import Dict, List, Optional, Tuple
 
 logger = logging.getLogger(__name__)
 
@@ -40,13 +39,13 @@ def __init__(self, context_store, session_id: str = None):
         self.store = context_store
         self.session_id = session_id
         # Set by startup flow after resolve_plan_context()
-        self.active_plan_item_id: Optional[str] = None
+        self.active_plan_item_id: str | None = None
 
     # ------------------------------------------------------------------
     # Plan context resolution — called at startup
     # ------------------------------------------------------------------
 
-    def resolve_plan_context(self) -> Tuple[Optional[str], List]:
+    def resolve_plan_context(self) -> tuple[str | None, list]:
         """Determine which plan item to activate for this session.
 
         Scans all active campaigns for unblocked imaging items.
@@ -61,6 +60,7 @@ def resolve_plan_context(self) -> Tuple[Optional[str], List]:
         """
         try:
             from .model import PlanItemType
+
             root_campaigns = self.store.get_root_campaigns(status="active")
             imaging_candidates = []
             for campaign in root_campaigns:
@@ -186,13 +186,11 @@ def get_awareness_summary(self) -> str:
             # Session-campaign link
             if self.session_id:
                 try:
-                    session_campaigns = self.store.get_campaigns_for_session(
-                        self.session_id
-                    )
+                    session_campaigns = self.store.get_campaigns_for_session(self.session_id)
                     if session_campaigns:
                         names = [_short_name(c) for c in session_campaigns[:2]]
                         lines.append(
-                            f'- This session: linked to {", ".join(f"{n!r}" for n in names)}'
+                            f"- This session: linked to {', '.join(f'{n!r}' for n in names)}"
                         )
                 except Exception:
                     pass
@@ -291,7 +289,9 @@ def _briefing_for_campaign(self, campaign) -> str:
                 for p in phases:
                     try:
                         ps = self.store.get_plan_status(p.id)
-                        items_str = f" ({ps['completed']}/{ps['total']} items)" if ps["total"] > 0 else ""
+                        items_str = (
+                            f" ({ps['completed']}/{ps['total']} items)" if ps["total"] > 0 else ""
+                        )
                     except Exception:
                         items_str = ""
                     lines.append(f"  - {_friendly_name(p)}{items_str}")
@@ -301,6 +301,7 @@ def _briefing_for_campaign(self, campaign) -> str:
         # Plan status (root campaign)
         try:
             from .model import PlanItemType
+
             status = self.store.get_plan_status(campaign.id)
             if status["total"] > 0:
                 lines.append(
@@ -328,9 +329,9 @@ def _briefing_for_campaign(self, campaign) -> str:
         learnings = self.store.get_learnings(limit=50)
         if learnings:
             lines.append("\n**Recent learnings**:")
-            for l in learnings[:5]:
-                conf = l.confidence.value if l.confidence else "?"
-                lines.append(f"  - [{conf}] {l.content[:150]}")
+            for learning in learnings[:5]:
+                conf = learning.confidence.value if learning.confidence else "?"
+                lines.append(f"  - [{conf}] {learning.content[:150]}")
 
         # Other active root campaigns (brief mention)
         root_campaigns = self.store.get_root_campaigns()
@@ -379,9 +380,7 @@ def _briefing_broad(self) -> str:
                 )
             else:
                 lines.append("## Ready to image")
-                lines.append(
-                    f"{len(candidates)} imaging tasks are unblocked:"
-                )
+                lines.append(f"{len(candidates)} imaging tasks are unblocked:")
                 lines.append("")
                 for item, spec, campaign in candidates:
                     spec_summary = self.format_imaging_spec_summary(spec) if spec else "no spec"
@@ -441,7 +440,11 @@ def recall_campaigns(self, status: str = "active") -> str:
                     for p in phases:
                         try:
                             ps = self.store.get_plan_status(p.id)
-                            items_str = f" ({ps['completed']}/{ps['total']} items)" if ps["total"] > 0 else ""
+                            items_str = (
+                                f" ({ps['completed']}/{ps['total']} items)"
+                                if ps["total"] > 0
+                                else ""
+                            )
                         except Exception:
                             items_str = ""
                         lines.append(f"    - {_friendly_name(p)}{items_str}")
@@ -460,10 +463,11 @@ def recall_learnings(self, query: str = None, limit: int = 20) -> str:
             query_lower = query.lower()
             terms = query_lower.split()
             learnings = [
-                l
-                for l in learnings
+                learning
+                for learning in learnings
                 if any(
-                    term in l.content.lower() or (l.basis and term in l.basis.lower())
+                    term in learning.content.lower()
+                    or (learning.basis and term in learning.basis.lower())
                     for term in terms
                 )
             ]
@@ -471,23 +475,23 @@ def recall_learnings(self, query: str = None, limit: int = 20) -> str:
         learnings = learnings[:limit]
 
         if not learnings:
-            msg = f"No learnings found matching '{query}'." if query else "No learnings recorded yet."
+            msg = (
+                f"No learnings found matching '{query}'." if query else "No learnings recorded yet."
+            )
             return msg
 
         header = f"## Learnings matching '{query}'" if query else "## Recent Learnings"
         lines = [header]
-        for l in learnings:
-            conf = l.confidence.value if l.confidence else "?"
-            lines.append(f"\n- [{conf}] {l.content}")
-            if l.basis:
-                lines.append(f"  _Basis_: {l.basis[:200]}")
-            lines.append(f"  _{l.created_at.strftime('%Y-%m-%d %H:%M')}_")
+        for learning in learnings:
+            conf = learning.confidence.value if learning.confidence else "?"
+            lines.append(f"\n- [{conf}] {learning.content}")
+            if learning.basis:
+                lines.append(f"  _Basis_: {learning.basis[:200]}")
+            lines.append(f"  _{learning.created_at.strftime('%Y-%m-%d %H:%M')}_")
 
         return "\n".join(lines)
 
-    def recall_observations(
-        self, query: str = None, embryo_id: str = None, limit: int = 20
-    ) -> str:
+    def recall_observations(self, query: str = None, embryo_id: str = None, limit: int = 20) -> str:
         """Search or list observations."""
         if embryo_id:
             observations = self.store.get_observations_for_embryo(embryo_id)
@@ -498,15 +502,17 @@ def recall_observations(
             query_lower = query.lower()
             terms = query_lower.split()
             observations = [
-                o
-                for o in observations
-                if any(term in o.content.lower() for term in terms)
+                o for o in observations if any(term in o.content.lower() for term in terms)
             ]
 
         observations = observations[:limit]
 
         if not observations:
-            msg = f"No observations found matching '{query}'." if query else "No observations recorded yet."
+            msg = (
+                f"No observations found matching '{query}'."
+                if query
+                else "No observations recorded yet."
+            )
             return msg
 
         header = "## Observations"
@@ -559,7 +565,9 @@ def recall_full_context(self, campaign_id: str = None) -> str:
             lines.append("\n### Active Campaigns")
             for c in root_campaigns:
                 name = _friendly_name(c)
-                is_focus = " ← this session" if (focus_campaign and c.id == focus_campaign.id) else ""
+                is_focus = (
+                    " ← this session" if (focus_campaign and c.id == focus_campaign.id) else ""
+                )
                 progress = f" — {c.progress}" if c.progress else ""
                 try:
                     status = self.store.get_plan_status(c.id)
@@ -580,7 +588,9 @@ def recall_full_context(self, campaign_id: str = None) -> str:
                         for p in phases:
                             try:
                                 ps = self.store.get_plan_status(p.id)
-                                items_str = f" ({ps['completed']}/{ps['total']})" if ps["total"] > 0 else ""
+                                items_str = (
+                                    f" ({ps['completed']}/{ps['total']})" if ps["total"] > 0 else ""
+                                )
                             except Exception:
                                 items_str = ""
                             lines.append(f"  - {_short_name(p)}{items_str}")
@@ -606,9 +616,9 @@ def recall_full_context(self, campaign_id: str = None) -> str:
         learnings = self.store.get_learnings(limit=10)
         if learnings:
             lines.append("\n### Recent Learnings")
-            for l in learnings[:10]:
-                conf = l.confidence.value if l.confidence else "?"
-                lines.append(f"- [{conf}] {l.content[:150]}")
+            for learning in learnings[:10]:
+                conf = learning.confidence.value if learning.confidence else "?"
+                lines.append(f"- [{conf}] {learning.content[:150]}")
 
         # Expectations
         expectations = self.store.get_pending_expectations()
diff --git a/gently/harness/memory/model.py b/gently/harness/memory/model.py
index d9dc9a4e..2a164176 100644
--- a/gently/harness/memory/model.py
+++ b/gently/harness/memory/model.py
@@ -6,12 +6,13 @@
 
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Dict, List, Optional
 from enum import Enum
+from typing import Any
 
 
 class Significance(str, Enum):
     """How important something is."""
+
     HIGH = "high"
     MEDIUM = "medium"
     LOW = "low"
@@ -19,6 +20,7 @@ class Significance(str, Enum):
 
 class Confidence(str, Enum):
     """How confident we are in a belief."""
+
     HIGH = "high"
     MEDIUM = "medium"
     LOW = "low"
@@ -26,6 +28,7 @@ class Confidence(str, Enum):
 
 class Status(str, Enum):
     """Generic status for things that can be active/completed."""
+
     ACTIVE = "active"
     PAUSED = "paused"
     COMPLETED = "completed"
@@ -33,15 +36,17 @@ class Status(str, Enum):
 
 class PlannedSessionStatus(str, Enum):
     """Status for planned imaging sessions."""
+
     PLANNED = "planned"
-    ACTIVE = "active"        # Currently in progress
+    ACTIVE = "active"  # Currently in progress
     COMPLETED = "completed"
-    SKIPPED = "skipped"      # Decided not to do it
+    SKIPPED = "skipped"  # Decided not to do it
     CANCELLED = "cancelled"
 
 
 class PlanItemStatus(str, Enum):
     """Status for plan items."""
+
     PLANNED = "planned"
     IN_PROGRESS = "in_progress"
     COMPLETED = "completed"
@@ -51,6 +56,7 @@ class PlanItemStatus(str, Enum):
 
 class PlanItemType(str, Enum):
     """Type of plan item."""
+
     IMAGING = "imaging"
     BENCH = "bench"
     GENETICS = "genetics"
@@ -60,6 +66,7 @@ class PlanItemType(str, Enum):
 
 class ExpectationStatus(str, Enum):
     """Status for expectations/predictions."""
+
     PENDING = "pending"
     CONFIRMED = "confirmed"
     SURPRISED = "surprised"
@@ -68,6 +75,7 @@ class ExpectationStatus(str, Enum):
 
 class WatchpointStatus(str, Enum):
     """Status for watchpoints."""
+
     ACTIVE = "active"
     TRIGGERED = "triggered"
     RESOLVED = "resolved"
@@ -75,6 +83,7 @@ class WatchpointStatus(str, Enum):
 
 class QuestionStatus(str, Enum):
     """Status for open questions."""
+
     OPEN = "open"
     INVESTIGATING = "investigating"
     RESOLVED = "resolved"
@@ -84,6 +93,7 @@ class QuestionStatus(str, Enum):
 # Intentions: Why are we doing this?
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class Campaign:
     """
@@ -95,13 +105,14 @@ class Campaign:
 
     Example: "Capture 50 hatching events from wild-type embryos"
     """
+
     id: str
     description: str  # Natural language, as the researcher said it
-    shorthand: Optional[str] = None  # Short label: "temp-division", "hatching-50"
-    summary: Optional[str] = None  # Agent-rephrased structured summary
-    target: Optional[str] = None  # Measurable goal: "50 hatching events"
-    progress: Optional[str] = None  # Current state: "23/50"
-    parent_id: Optional[str] = None  # Parent campaign (for hierarchy)
+    shorthand: str | None = None  # Short label: "temp-division", "hatching-50"
+    summary: str | None = None  # Agent-rephrased structured summary
+    target: str | None = None  # Measurable goal: "50 hatching events"
+    progress: str | None = None  # Current state: "23/50"
+    parent_id: str | None = None  # Parent campaign (for hierarchy)
     status: Status = Status.ACTIVE
     is_shared: bool = False
     created_at: datetime = field(default_factory=datetime.now)
@@ -122,9 +133,10 @@ class Project:
 
     Example: "Optimize imaging parameters for early stages"
     """
+
     id: str
     description: str
-    campaign_id: Optional[str] = None
+    campaign_id: str | None = None
     status: Status = Status.ACTIVE
     created_at: datetime = field(default_factory=datetime.now)
     updated_at: datetime = field(default_factory=datetime.now)
@@ -138,12 +150,13 @@ class SessionIntent:
     Tracks planned intent vs what actually happened.
     A session can belong to multiple campaigns (linked via session_campaigns).
     """
+
     session_id: str
-    planned_intent: Optional[str] = None  # What was planned
-    actual_summary: Optional[str] = None  # What happened
-    campaign_ids: List[str] = field(default_factory=list)  # Linked campaigns
+    planned_intent: str | None = None  # What was planned
+    actual_summary: str | None = None  # What happened
+    campaign_ids: list[str] = field(default_factory=list)  # Linked campaigns
     created_at: datetime = field(default_factory=datetime.now)
-    completed_at: Optional[datetime] = None
+    completed_at: datetime | None = None
 
 
 @dataclass
@@ -159,17 +172,18 @@ class PlannedSession:
     can match the planned session to the actual session and
     pre-populate intent + parameters.
     """
+
     id: str
-    title: Optional[str] = None  # "N2 baseline imaging round 3"
-    notes: Optional[str] = None  # Free-form: what to do, what to watch for
-    scheduled_date: Optional[str] = None  # ISO date: "2026-02-15"
-    scheduled_time: Optional[str] = None  # ISO time: "14:00" (optional)
-    estimated_duration_minutes: Optional[int] = None
-    acquisition_params: Optional[Dict[str, Any]] = None  # From previous session
-    source_session_id: Optional[str] = None  # "use params from this session"
+    title: str | None = None  # "N2 baseline imaging round 3"
+    notes: str | None = None  # Free-form: what to do, what to watch for
+    scheduled_date: str | None = None  # ISO date: "2026-02-15"
+    scheduled_time: str | None = None  # ISO time: "14:00" (optional)
+    estimated_duration_minutes: int | None = None
+    acquisition_params: dict[str, Any] | None = None  # From previous session
+    source_session_id: str | None = None  # "use params from this session"
     status: PlannedSessionStatus = PlannedSessionStatus.PLANNED
-    session_id: Optional[str] = None  # Linked actual session once started
-    campaign_ids: List[str] = field(default_factory=list)
+    session_id: str | None = None  # Linked actual session once started
+    campaign_ids: list[str] = field(default_factory=list)
     created_at: datetime = field(default_factory=datetime.now)
     updated_at: datetime = field(default_factory=datetime.now)
 
@@ -190,40 +204,41 @@ class ImagingSpec:
     Everything needed to auto-configure the microscope when
     it's time to execute this plan item.
     """
+
     # Sample
-    strain: Optional[str] = None              # "OH904"
-    genotype: Optional[str] = None            # "otIs355[rab-3p::2xNLS::TagRFP]"
-    reporter: Optional[str] = None            # "rab-3p::GFP (pan-neuronal)"
-    sample_prep: Optional[str] = None         # "Standard egg prep, poly-lysine pads"
-    temperature_c: Optional[float] = None     # 20.0
-    num_embryos: Optional[int] = None         # 4
+    strain: str | None = None  # "OH904"
+    genotype: str | None = None  # "otIs355[rab-3p::2xNLS::TagRFP]"
+    reporter: str | None = None  # "rab-3p::GFP (pan-neuronal)"
+    sample_prep: str | None = None  # "Standard egg prep, poly-lysine pads"
+    temperature_c: float | None = None  # 20.0
+    num_embryos: int | None = None  # 4
 
     # Acquisition
-    num_slices: Optional[int] = None          # 80
-    exposure_ms: Optional[float] = None       # 10.0
-    laser_wavelength_nm: Optional[int] = None # 488
-    laser_power_pct: Optional[float] = None   # 10.0
-    galvo_amplitude: Optional[float] = None   # 8.0
-    piezo_amplitude_um: Optional[float] = None  # 50.0
+    num_slices: int | None = None  # 80
+    exposure_ms: float | None = None  # 10.0
+    laser_wavelength_nm: int | None = None  # 488
+    laser_power_pct: float | None = None  # 10.0
+    galvo_amplitude: float | None = None  # 8.0
+    piezo_amplitude_um: float | None = None  # 50.0
 
     # Timing
-    interval_s: Optional[int] = None          # 180
-    adaptive_intervals: Optional[Dict[str, int]] = None
+    interval_s: int | None = None  # 180
+    adaptive_intervals: dict[str, int] | None = None
     # e.g. {"early_to_comma": 300, "comma_to_2fold": 60}
 
     # Developmental window
-    target_window: Optional[str] = None       # "comma → pretzel"
-    start_stage: Optional[str] = None         # "comma"
-    stop_condition: Optional[str] = None      # "pretzel"
-    estimated_duration_h: Optional[float] = None  # 4.0
+    target_window: str | None = None  # "comma → pretzel"
+    start_stage: str | None = None  # "comma"
+    stop_condition: str | None = None  # "pretzel"
+    estimated_duration_h: float | None = None  # 4.0
 
     # Detection
-    detectors: Optional[List[str]] = None     # ["comma", "pretzel"]
-    pre_terminal_speedup: Optional[bool] = None
+    detectors: list[str] | None = None  # ["comma", "pretzel"]
+    pre_terminal_speedup: bool | None = None
 
     # Validation
-    success_criteria: Optional[str] = None
-    comparison_to: Optional[str] = None       # "Compare to WT session 1"
+    success_criteria: str | None = None
+    comparison_to: str | None = None  # "Compare to WT session 1"
 
 
 @dataclass
@@ -231,13 +246,14 @@ class BenchSpec:
     """
     Specification for non-imaging tasks (bench work, genetics, analysis).
     """
-    protocol: Optional[str] = None            # "Standard chemotaxis assay"
-    reagents: Optional[List[str]] = None      # ["anti-UNC-33", "secondary 568"]
-    strains: Optional[List[str]] = None       # ["OH904", "N2"]
-    target_genotype: Optional[str] = None     # "unc-6(ev400); otIs355"
-    estimated_days: Optional[int] = None      # 14
-    success_criteria: Optional[str] = None
-    notes: Optional[str] = None
+
+    protocol: str | None = None  # "Standard chemotaxis assay"
+    reagents: list[str] | None = None  # ["anti-UNC-33", "secondary 568"]
+    strains: list[str] | None = None  # ["OH904", "N2"]
+    target_genotype: str | None = None  # "unc-6(ev400); otIs355"
+    estimated_days: int | None = None  # 14
+    success_criteria: str | None = None
+    notes: str | None = None
 
 
 @dataclass
@@ -252,29 +268,30 @@ class PlanItem:
     Dependencies between items (depends_on) enable the agent to track
     what's blocked and what's newly unblocked.
     """
+
     id: str
-    campaign_id: str                          # Which campaign/phase
-    type: PlanItemType                        # imaging, bench, genetics, analysis, decision_point
-    title: str                                # "Pilot — rab-3p::GFP visibility test"
-    description: Optional[str] = None         # Detailed notes, protocols, what to watch for
+    campaign_id: str  # Which campaign/phase
+    type: PlanItemType  # imaging, bench, genetics, analysis, decision_point
+    title: str  # "Pilot — rab-3p::GFP visibility test"
+    description: str | None = None  # Detailed notes, protocols, what to watch for
     status: PlanItemStatus = PlanItemStatus.PLANNED
-    depends_on: List[str] = field(default_factory=list)  # PlanItem IDs
-    outcome: Optional[str] = None             # What happened (filled after completion)
-    claimed_by: Optional[str] = None         # instance_id of claiming node
-    claimed_by_hostname: Optional[str] = None # human-readable hostname
-    references: List[Dict[str, str]] = field(default_factory=list)  # Source citations
+    depends_on: list[str] = field(default_factory=list)  # PlanItem IDs
+    outcome: str | None = None  # What happened (filled after completion)
+    claimed_by: str | None = None  # instance_id of claiming node
+    claimed_by_hostname: str | None = None  # human-readable hostname
+    references: list[dict[str, str]] = field(default_factory=list)  # Source citations
 
     # Specifications (type-dependent)
-    imaging_spec: Optional[ImagingSpec] = None
-    bench_spec: Optional[BenchSpec] = None
+    imaging_spec: ImagingSpec | None = None
+    bench_spec: BenchSpec | None = None
 
     # Linking
-    planned_session_id: Optional[str] = None  # → PlannedSession (for imaging items)
-    session_id: Optional[str] = None          # → Actual session (once executed)
-    inherit_from: Optional[str] = None        # PlanItem ID to inherit spec from
+    planned_session_id: str | None = None  # → PlannedSession (for imaging items)
+    session_id: str | None = None  # → Actual session (once executed)
+    inherit_from: str | None = None  # PlanItem ID to inherit spec from
 
     # Scheduling — relative timeline from Day 0
-    estimated_days: Optional[int] = None     # Duration in days (for Gantt/timeline views)
+    estimated_days: int | None = None  # Duration in days (for Gantt/timeline views)
 
     # Ordering
     phase_order: int = 0
@@ -291,17 +308,19 @@ def is_actionable(self) -> bool:
 @dataclass
 class Intentions:
     """Collection of the agent's intentions at multiple levels."""
-    campaigns: List[Campaign] = field(default_factory=list)
-    projects: List[Project] = field(default_factory=list)
-    planned_sessions: List[PlannedSession] = field(default_factory=list)
-    current_focus: Optional[str] = None
-    session_intent: Optional[SessionIntent] = None
+
+    campaigns: list[Campaign] = field(default_factory=list)
+    projects: list[Project] = field(default_factory=list)
+    planned_sessions: list[PlannedSession] = field(default_factory=list)
+    current_focus: str | None = None
+    session_intent: SessionIntent | None = None
 
 
 # ---------------------------------------------------------------------------
 # Understanding: What do we believe?
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class Learning:
     """
@@ -309,10 +328,11 @@ class Learning:
 
     Example: "Batch 7 develops 20% faster than average"
     """
+
     id: str
     content: str  # Human-readable insight
     confidence: Confidence = Confidence.MEDIUM
-    basis: Optional[str] = None  # What observations support this
+    basis: str | None = None  # What observations support this
     created_at: datetime = field(default_factory=datetime.now)
 
 
@@ -323,31 +343,34 @@ class EmbryoUnderstanding:
 
     This is synthesized understanding, not raw data.
     """
+
     embryo_id: str
-    current_stage: Optional[str] = None
-    stage_confidence: Optional[Confidence] = None
-    health_assessment: Optional[str] = None
-    notes: List[str] = field(default_factory=list)
-    last_observed: Optional[datetime] = None
+    current_stage: str | None = None
+    stage_confidence: Confidence | None = None
+    health_assessment: str | None = None
+    notes: list[str] = field(default_factory=list)
+    last_observed: datetime | None = None
 
     # Tracking flags
     is_tracked: bool = True
     is_hatched: bool = False
     needs_attention: bool = False
-    attention_reason: Optional[str] = None
+    attention_reason: str | None = None
 
 
 @dataclass
 class Understanding:
     """The agent's overall understanding of the experiment."""
-    embryo_states: Dict[str, EmbryoUnderstanding] = field(default_factory=dict)
-    learnings: List[Learning] = field(default_factory=list)
+
+    embryo_states: dict[str, EmbryoUnderstanding] = field(default_factory=dict)
+    learnings: list[Learning] = field(default_factory=list)
 
 
 # ---------------------------------------------------------------------------
 # Observations: What have we seen? (synthesized, not raw)
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class Observation:
     """
@@ -355,21 +378,23 @@ class Observation:
 
     Not raw data — a meaningful note about what happened.
     """
+
     id: str
     timestamp: datetime
     type: str  # stage_transition, anomaly, session_summary, milestone
     content: str  # Human-readable description
-    embryo_id: Optional[str] = None
+    embryo_id: str | None = None
     significance: Significance = Significance.MEDIUM
-    session_id: Optional[str] = None
-    gently_refs: Optional[Dict[str, Any]] = None  # References to FileStore data
-    relates_to: Optional[List[str]] = None  # Related goals/observations
+    session_id: str | None = None
+    gently_refs: dict[str, Any] | None = None  # References to FileStore data
+    relates_to: list[str] | None = None  # Related goals/observations
 
 
 # ---------------------------------------------------------------------------
 # Expectations: What do we predict?
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class Expectation:
     """
@@ -377,21 +402,23 @@ class Expectation:
 
     Example: "embryo_3 will reach comma stage by 14:30"
     """
+
     id: str
     target: str  # What this is about (embryo_id, etc)
     prediction: str  # "will reach comma stage"
     expected_time: datetime
-    uncertainty: Optional[str] = None  # "±30 minutes"
-    basis: Optional[str] = None  # Why we expect this
+    uncertainty: str | None = None  # "±30 minutes"
+    basis: str | None = None  # Why we expect this
     status: ExpectationStatus = ExpectationStatus.PENDING
     created_at: datetime = field(default_factory=datetime.now)
-    resolved_at: Optional[datetime] = None
+    resolved_at: datetime | None = None
 
 
 # ---------------------------------------------------------------------------
 # Attention: What should we watch?
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class Watchpoint:
     """
@@ -399,6 +426,7 @@ class Watchpoint:
 
     Example: Watch embryo_3 for "approaching hatching"
     """
+
     id: str
     target: str  # "embryo_3"
     condition: str  # "approaching hatching"
@@ -414,25 +442,28 @@ class Question:
 
     Example: "Why is batch 7 slower than batch 6?"
     """
+
     id: str
     content: str
     status: QuestionStatus = QuestionStatus.OPEN
-    resolution: Optional[str] = None
+    resolution: str | None = None
     created_at: datetime = field(default_factory=datetime.now)
-    resolved_at: Optional[datetime] = None
+    resolved_at: datetime | None = None
 
 
 @dataclass
 class Attention:
     """What the agent is watching/thinking about."""
-    watchpoints: List[Watchpoint] = field(default_factory=list)
-    open_questions: List[Question] = field(default_factory=list)
+
+    watchpoints: list[Watchpoint] = field(default_factory=list)
+    open_questions: list[Question] = field(default_factory=list)
 
 
 # ---------------------------------------------------------------------------
 # Full Context
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class Context:
     """
@@ -440,24 +471,25 @@ class Context:
 
     This is the agent's "working memory" for a single think.
     """
+
     intentions: Intentions = field(default_factory=Intentions)
     understanding: Understanding = field(default_factory=Understanding)
-    observations: List[Observation] = field(default_factory=list)
-    expectations: List[Expectation] = field(default_factory=list)
+    observations: list[Observation] = field(default_factory=list)
+    expectations: list[Expectation] = field(default_factory=list)
     attention: Attention = field(default_factory=Attention)
 
     @property
-    def active_campaigns(self) -> List[Campaign]:
+    def active_campaigns(self) -> list[Campaign]:
         """Get active campaigns."""
         return [c for c in self.intentions.campaigns if c.status == Status.ACTIVE]
 
     @property
-    def pending_expectations(self) -> List[Expectation]:
+    def pending_expectations(self) -> list[Expectation]:
         """Get pending expectations."""
         return [e for e in self.expectations if e.status == ExpectationStatus.PENDING]
 
     @property
-    def active_watchpoints(self) -> List[Watchpoint]:
+    def active_watchpoints(self) -> list[Watchpoint]:
         """Get active watchpoints."""
         return [w for w in self.attention.watchpoints if w.status == WatchpointStatus.ACTIVE]
 
@@ -466,6 +498,7 @@ def active_watchpoints(self) -> List[Watchpoint]:
 # Context Updates (from agent response)
 # ---------------------------------------------------------------------------
 
+
 @dataclass
 class ContextUpdates:
     """
@@ -473,23 +506,24 @@ class ContextUpdates:
 
     The agent returns these after thinking.
     """
+
     # New items to add
-    new_observations: List[Observation] = field(default_factory=list)
-    new_expectations: List[Expectation] = field(default_factory=list)
-    new_watchpoints: List[Watchpoint] = field(default_factory=list)
-    new_learnings: List[Learning] = field(default_factory=list)
-    new_questions: List[Question] = field(default_factory=list)
+    new_observations: list[Observation] = field(default_factory=list)
+    new_expectations: list[Expectation] = field(default_factory=list)
+    new_watchpoints: list[Watchpoint] = field(default_factory=list)
+    new_learnings: list[Learning] = field(default_factory=list)
+    new_questions: list[Question] = field(default_factory=list)
 
     # Status updates
-    resolved_expectations: Dict[str, ExpectationStatus] = field(default_factory=dict)
-    triggered_watchpoints: List[str] = field(default_factory=list)
-    resolved_questions: Dict[str, str] = field(default_factory=dict)  # id -> resolution
+    resolved_expectations: dict[str, ExpectationStatus] = field(default_factory=dict)
+    triggered_watchpoints: list[str] = field(default_factory=list)
+    resolved_questions: dict[str, str] = field(default_factory=dict)  # id -> resolution
 
     # Understanding updates
-    embryo_updates: Dict[str, Dict[str, Any]] = field(default_factory=dict)
+    embryo_updates: dict[str, dict[str, Any]] = field(default_factory=dict)
 
     # Campaign/project progress
-    campaign_progress: Dict[str, str] = field(default_factory=dict)  # id -> progress
+    campaign_progress: dict[str, str] = field(default_factory=dict)  # id -> progress
 
     # Focus update
-    new_focus: Optional[str] = None
+    new_focus: str | None = None
diff --git a/gently/harness/memory/onboarding.py b/gently/harness/memory/onboarding.py
index 937fba7b..75f24d19 100644
--- a/gently/harness/memory/onboarding.py
+++ b/gently/harness/memory/onboarding.py
@@ -8,20 +8,18 @@
 
 import logging
 import uuid
-from dataclasses import dataclass, field
-from datetime import datetime
-from typing import Any, Dict, List, Optional
+from dataclasses import dataclass
+from typing import Any
 
 from gently.settings import settings
+
 from .gap_assessment import ContextGapReport, GapLayer
 from .model import (
-    Campaign,
+    Confidence,
     Learning,
-    SessionIntent,
     Watchpoint,
-    Confidence,
-    Significance,
 )
+
 try:
     from .file_store import FileContextStore as ContextStore
 except ImportError:
@@ -31,11 +29,13 @@
 @dataclass
 class OnboardingMessage:
     """A message to surface to the researcher during onboarding."""
+
     message: str
     layer: GapLayer
     priority: str = "normal"  # "high", "normal", "low"
     reason: str = ""
 
+
 logger = logging.getLogger(__name__)
 
 
@@ -80,8 +80,8 @@ class OnboardingMessage:
 
 def generate_onboarding_messages(
     gap_report: ContextGapReport,
-    session_id: Optional[str] = None,
-) -> List[OnboardingMessage]:
+    session_id: str | None = None,
+) -> list[OnboardingMessage]:
     """
     Generate onboarding messages based on the gap assessment.
 
@@ -100,12 +100,14 @@ def generate_onboarding_messages(
     messages = []
 
     if gap_report.needs_lab_onboarding:
-        messages.append(OnboardingMessage(
-            message=LAB_ONBOARDING_GREETING,
-            layer=GapLayer.LAB,
-            priority="high",
-            reason="First launch — need to learn about the lab.",
-        ))
+        messages.append(
+            OnboardingMessage(
+                message=LAB_ONBOARDING_GREETING,
+                layer=GapLayer.LAB,
+                priority="high",
+                reason="First launch — need to learn about the lab.",
+            )
+        )
 
     if gap_report.needs_campaign:
         if gap_report.past_campaign_count > 0:
@@ -116,12 +118,14 @@ def generate_onboarding_messages(
         else:
             prompt = CAMPAIGN_PROMPT_FRESH
 
-        messages.append(OnboardingMessage(
-            message=prompt,
-            layer=GapLayer.CAMPAIGN,
-            priority="normal",
-            reason="No active campaign — need research direction.",
-        ))
+        messages.append(
+            OnboardingMessage(
+                message=prompt,
+                layer=GapLayer.CAMPAIGN,
+                priority="normal",
+                reason="No active campaign — need research direction.",
+            )
+        )
 
     if gap_report.needs_session_intent and session_id:
         if gap_report.has_campaigns:
@@ -137,12 +141,14 @@ def generate_onboarding_messages(
         else:
             prompt = SESSION_PROMPT_NO_CAMPAIGN
 
-        messages.append(OnboardingMessage(
-            message=prompt,
-            layer=GapLayer.SESSION,
-            priority="normal",
-            reason="Need to establish session intent.",
-        ))
+        messages.append(
+            OnboardingMessage(
+                message=prompt,
+                layer=GapLayer.SESSION,
+                priority="normal",
+                reason="Need to establish session intent.",
+            )
+        )
 
     if messages:
         logger.info(
@@ -155,8 +161,8 @@ def generate_onboarding_messages(
 
 def get_onboarding_messages(
     gap_report: ContextGapReport,
-    session_id: Optional[str] = None,
-) -> List[str]:
+    session_id: str | None = None,
+) -> list[str]:
     """
     Get plain-text onboarding messages for direct CLI display.
 
@@ -179,10 +185,12 @@ def get_onboarding_messages(
 
     if gap_report.needs_campaign:
         if gap_report.past_campaign_count > 0:
-            messages.append(CAMPAIGN_PROMPT_RETURNING.format(
-                campaign_description="(previous campaigns completed)",
-                campaign_status="completed",
-            ))
+            messages.append(
+                CAMPAIGN_PROMPT_RETURNING.format(
+                    campaign_description="(previous campaigns completed)",
+                    campaign_status="completed",
+                )
+            )
         else:
             messages.append(CAMPAIGN_PROMPT_FRESH)
 
@@ -192,10 +200,12 @@ def get_onboarding_messages(
             if gap_report.session_count > 0:
                 history = f"This is session #{gap_report.session_count + 1}. "
             campaign_name = gap_report.active_campaigns[0].display_name
-            messages.append(SESSION_PROMPT_WITH_CAMPAIGN.format(
-                campaign_description=campaign_name,
-                history_context=history,
-            ))
+            messages.append(
+                SESSION_PROMPT_WITH_CAMPAIGN.format(
+                    campaign_description=campaign_name,
+                    history_context=history,
+                )
+            )
         else:
             messages.append(SESSION_PROMPT_NO_CAMPAIGN)
 
@@ -238,9 +248,9 @@ async def process_onboarding_response(
     response: str,
     topic: str,
     context_store: ContextStore,
-    claude_client: Optional[Any] = None,
-    session_id: Optional[str] = None,
-) -> Dict[str, Any]:
+    claude_client: Any | None = None,
+    session_id: str | None = None,
+) -> dict[str, Any]:
     """
     Process a researcher's response during onboarding.
 
@@ -274,8 +284,7 @@ async def process_onboarding_response(
         extracted = _extract_basic(response, topic, context_store, session_id)
 
     logger.info(
-        f"Onboarding response processed ({topic}): "
-        f"{extracted['entries_created']} entries created"
+        f"Onboarding response processed ({topic}): {extracted['entries_created']} entries created"
     )
     return extracted
 
@@ -285,8 +294,8 @@ async def _extract_with_llm(
     topic: str,
     context_store: ContextStore,
     claude_client: Any,
-    session_id: Optional[str],
-) -> Dict[str, Any]:
+    session_id: str | None,
+) -> dict[str, Any]:
     """Use Claude to extract structured context from a response."""
     import asyncio
     import json
@@ -314,33 +323,37 @@ async def _extract_with_llm(
     entries = 0
 
     # Store learnings
-    for item in (data.get("learnings") or []):
+    for item in data.get("learnings") or []:
         if item and item.get("content"):
-            context_store.add_learning(Learning(
-                id=str(uuid.uuid4())[:8],
-                content=item["content"],
-                confidence=Confidence(item.get("confidence", "medium")),
-                basis=item.get("basis", f"onboarding:{topic}"),
-            ))
+            context_store.add_learning(
+                Learning(
+                    id=str(uuid.uuid4())[:8],
+                    content=item["content"],
+                    confidence=Confidence(item.get("confidence", "medium")),
+                    basis=item.get("basis", f"onboarding:{topic}"),
+                )
+            )
             entries += 1
 
     # Store campaign
     campaign_data = data.get("campaign")
     if campaign_data and campaign_data.get("description"):
-        cid = context_store.create_campaign(
+        context_store.create_campaign(
             description=campaign_data["description"],
             target=campaign_data.get("target"),
         )
         entries += 1
 
     # Store watchpoints
-    for item in (data.get("watchpoints") or []):
+    for item in data.get("watchpoints") or []:
         if item and item.get("target"):
-            context_store.add_watchpoint(Watchpoint(
-                id=str(uuid.uuid4())[:8],
-                target=item["target"],
-                condition=item.get("condition", "monitor"),
-            ))
+            context_store.add_watchpoint(
+                Watchpoint(
+                    id=str(uuid.uuid4())[:8],
+                    target=item["target"],
+                    condition=item.get("condition", "monitor"),
+                )
+            )
             entries += 1
 
     # Store session intent
@@ -356,12 +369,14 @@ async def _extract_with_llm(
     for field_name in ("organism", "microscope"):
         value = data.get(field_name)
         if value:
-            context_store.add_learning(Learning(
-                id=str(uuid.uuid4())[:8],
-                content=f"Lab {field_name}: {value}",
-                confidence=Confidence.HIGH,
-                basis="onboarding:identity",
-            ))
+            context_store.add_learning(
+                Learning(
+                    id=str(uuid.uuid4())[:8],
+                    content=f"Lab {field_name}: {value}",
+                    confidence=Confidence.HIGH,
+                    basis="onboarding:identity",
+                )
+            )
             entries += 1
 
     return {
@@ -375,8 +390,8 @@ def _extract_basic(
     response: str,
     topic: str,
     context_store: ContextStore,
-    session_id: Optional[str],
-) -> Dict[str, Any]:
+    session_id: str | None,
+) -> dict[str, Any]:
     """
     Basic keyword-based extraction when no LLM is available.
 
@@ -385,12 +400,14 @@ def _extract_basic(
     entries = 0
 
     # Store the raw response as a learning
-    context_store.add_learning(Learning(
-        id=str(uuid.uuid4())[:8],
-        content=f"Researcher ({topic}): {response[:500]}",
-        confidence=Confidence.MEDIUM,
-        basis=f"onboarding:{topic}",
-    ))
+    context_store.add_learning(
+        Learning(
+            id=str(uuid.uuid4())[:8],
+            content=f"Researcher ({topic}): {response[:500]}",
+            confidence=Confidence.MEDIUM,
+            basis=f"onboarding:{topic}",
+        )
+    )
     entries += 1
 
     # If this is a session topic and we have a session ID, create intent
@@ -411,8 +428,9 @@ def _extract_basic(
 # Ingestion result → context store
 # ---------------------------------------------------------------------------
 
+
 def apply_ingestion_to_context(
-    result: "IngestionResult",
+    result: "IngestionResult",  # noqa: F821
     context_store: ContextStore,
 ) -> int:
     """
@@ -443,34 +461,40 @@ def apply_ingestion_to_context(
     # Learnings
     for item in result.learnings:
         if item.get("content"):
-            context_store.add_learning(Learning(
-                id=str(uuid.uuid4())[:8],
-                content=item["content"],
-                confidence=Confidence(item.get("confidence", "medium")),
-                basis=f"ingestion:{result.source}",
-            ))
+            context_store.add_learning(
+                Learning(
+                    id=str(uuid.uuid4())[:8],
+                    content=item["content"],
+                    confidence=Confidence(item.get("confidence", "medium")),
+                    basis=f"ingestion:{result.source}",
+                )
+            )
             entries += 1
 
     # Imaging parameters as learnings
     if result.imaging_parameters:
         for key, value in result.imaging_parameters.items():
             if value is not None and key != "notes":
-                context_store.add_learning(Learning(
-                    id=str(uuid.uuid4())[:8],
-                    content=f"Recommended {key}: {value}",
-                    confidence=Confidence.MEDIUM,
-                    basis=f"ingestion:{result.source}",
-                ))
+                context_store.add_learning(
+                    Learning(
+                        id=str(uuid.uuid4())[:8],
+                        content=f"Recommended {key}: {value}",
+                        confidence=Confidence.MEDIUM,
+                        basis=f"ingestion:{result.source}",
+                    )
+                )
                 entries += 1
         # Store notes separately if present
         notes = result.imaging_parameters.get("notes")
         if notes:
-            context_store.add_learning(Learning(
-                id=str(uuid.uuid4())[:8],
-                content=f"Imaging notes: {notes}",
-                confidence=Confidence.MEDIUM,
-                basis=f"ingestion:{result.source}",
-            ))
+            context_store.add_learning(
+                Learning(
+                    id=str(uuid.uuid4())[:8],
+                    content=f"Imaging notes: {notes}",
+                    confidence=Confidence.MEDIUM,
+                    basis=f"ingestion:{result.source}",
+                )
+            )
             entries += 1
 
     # Sample requirements as a learning
@@ -480,22 +504,26 @@ def apply_ingestion_to_context(
             if value and key != "notes":
                 parts.append(f"{key}: {value}")
         if parts:
-            context_store.add_learning(Learning(
-                id=str(uuid.uuid4())[:8],
-                content=f"Sample requirements: {', '.join(parts)}",
-                confidence=Confidence.MEDIUM,
-                basis=f"ingestion:{result.source}",
-            ))
+            context_store.add_learning(
+                Learning(
+                    id=str(uuid.uuid4())[:8],
+                    content=f"Sample requirements: {', '.join(parts)}",
+                    confidence=Confidence.MEDIUM,
+                    basis=f"ingestion:{result.source}",
+                )
+            )
             entries += 1
 
     # Watchpoints
     for item in result.watchpoints:
         if item.get("target"):
-            context_store.add_watchpoint(Watchpoint(
-                id=str(uuid.uuid4())[:8],
-                target=item["target"],
-                condition=item.get("condition", "monitor"),
-            ))
+            context_store.add_watchpoint(
+                Watchpoint(
+                    id=str(uuid.uuid4())[:8],
+                    target=item["target"],
+                    condition=item.get("condition", "monitor"),
+                )
+            )
             entries += 1
 
     logger.info(f"Applied {entries} entries from ingestion of {result.source}")
diff --git a/gently/harness/memory/serialization.py b/gently/harness/memory/serialization.py
index 71442c53..6996997f 100644
--- a/gently/harness/memory/serialization.py
+++ b/gently/harness/memory/serialization.py
@@ -6,29 +6,26 @@
 """
 
 import json
-from datetime import datetime
-from typing import Any, Dict, List
+from typing import Any
 
 from .model import (
     Campaign,
-    Project,
-    SessionIntent,
-    PlannedSession,
-    Learning,
-    Observation,
-    Expectation,
-    Watchpoint,
-    Question,
-    EmbryoUnderstanding,
     Context,
-    Significance,
-    Confidence,
+    EmbryoUnderstanding,
+    Expectation,
     ExpectationStatus,
+    Learning,
+    Observation,
+    PlannedSession,
     PlannedSessionStatus,
+    Project,
+    Question,
+    SessionIntent,
+    Watchpoint,
 )
 
 
-def context_to_dict(context: Context) -> Dict[str, Any]:
+def context_to_dict(context: Context) -> dict[str, Any]:
     """
     Serialize a Context to a dictionary.
 
@@ -38,7 +35,9 @@ def context_to_dict(context: Context) -> Dict[str, Any]:
         "intentions": {
             "campaigns": [_campaign_to_dict(c) for c in context.intentions.campaigns],
             "projects": [_project_to_dict(p) for p in context.intentions.projects],
-            "planned_sessions": [_planned_session_to_dict(ps) for ps in context.intentions.planned_sessions],
+            "planned_sessions": [
+                _planned_session_to_dict(ps) for ps in context.intentions.planned_sessions
+            ],
             "current_focus": context.intentions.current_focus,
             "session_intent": _session_intent_to_dict(context.intentions.session_intent)
             if context.intentions.session_intent
@@ -46,10 +45,11 @@ def context_to_dict(context: Context) -> Dict[str, Any]:
         },
         "understanding": {
             "embryo_states": {
-                eid: _embryo_to_dict(e)
-                for eid, e in context.understanding.embryo_states.items()
+                eid: _embryo_to_dict(e) for eid, e in context.understanding.embryo_states.items()
             },
-            "learnings": [_learning_to_dict(l) for l in context.understanding.learnings],
+            "learnings": [
+                _learning_to_dict(learning) for learning in context.understanding.learnings
+            ],
         },
         "observations": [_observation_to_dict(o) for o in context.observations],
         "expectations": [_expectation_to_dict(e) for e in context.expectations],
@@ -82,8 +82,11 @@ def context_summary(context: Context) -> str:
             lines.append(f"  - {c.display_name}{progress}")
 
     # Planned sessions
-    upcoming = [ps for ps in context.intentions.planned_sessions
-                if ps.status == PlannedSessionStatus.PLANNED]
+    upcoming = [
+        ps
+        for ps in context.intentions.planned_sessions
+        if ps.status == PlannedSessionStatus.PLANNED
+    ]
     if upcoming:
         lines.append(f"Planned sessions: {len(upcoming)} upcoming")
         for ps in upcoming[:2]:
@@ -100,7 +103,10 @@ def context_summary(context: Context) -> str:
         tracked = [e for e in embryos.values() if e.is_tracked]
         hatched = [e for e in embryos.values() if e.is_hatched]
         attention = [e for e in embryos.values() if e.needs_attention]
-        lines.append(f"Embryos: {len(tracked)} tracked, {len(hatched)} hatched, {len(attention)} need attention")
+        lines.append(
+            f"Embryos: {len(tracked)} tracked, {len(hatched)} hatched,"
+            f" {len(attention)} need attention"
+        )
 
     # Expectations
     pending = [e for e in context.expectations if e.status == ExpectationStatus.PENDING]
@@ -113,7 +119,9 @@ def context_summary(context: Context) -> str:
         lines.append(f"Watchpoints: {len(active_wp)} active")
 
     # Questions
-    open_q = [q for q in context.attention.open_questions if q.status.value in ("open", "investigating")]
+    open_q = [
+        q for q in context.attention.open_questions if q.status.value in ("open", "investigating")
+    ]
     if open_q:
         lines.append(f"Questions: {len(open_q)} open")
 
@@ -128,7 +136,8 @@ def context_summary(context: Context) -> str:
 # Helper functions
 # ---------------------------------------------------------------------------
 
-def _campaign_to_dict(c: Campaign) -> Dict[str, Any]:
+
+def _campaign_to_dict(c: Campaign) -> dict[str, Any]:
     return {
         "id": c.id,
         "description": c.description,
@@ -143,7 +152,7 @@ def _campaign_to_dict(c: Campaign) -> Dict[str, Any]:
     }
 
 
-def _project_to_dict(p: Project) -> Dict[str, Any]:
+def _project_to_dict(p: Project) -> dict[str, Any]:
     return {
         "id": p.id,
         "description": p.description,
@@ -154,7 +163,7 @@ def _project_to_dict(p: Project) -> Dict[str, Any]:
     }
 
 
-def _planned_session_to_dict(ps: PlannedSession) -> Dict[str, Any]:
+def _planned_session_to_dict(ps: PlannedSession) -> dict[str, Any]:
     return {
         "id": ps.id,
         "title": ps.title,
@@ -172,7 +181,7 @@ def _planned_session_to_dict(ps: PlannedSession) -> Dict[str, Any]:
     }
 
 
-def _session_intent_to_dict(s: SessionIntent) -> Dict[str, Any]:
+def _session_intent_to_dict(s: SessionIntent) -> dict[str, Any]:
     return {
         "session_id": s.session_id,
         "planned_intent": s.planned_intent,
@@ -183,17 +192,17 @@ def _session_intent_to_dict(s: SessionIntent) -> Dict[str, Any]:
     }
 
 
-def _learning_to_dict(l: Learning) -> Dict[str, Any]:
+def _learning_to_dict(learning: Learning) -> dict[str, Any]:
     return {
-        "id": l.id,
-        "content": l.content,
-        "confidence": l.confidence.value,
-        "basis": l.basis,
-        "created_at": l.created_at.isoformat(),
+        "id": learning.id,
+        "content": learning.content,
+        "confidence": learning.confidence.value,
+        "basis": learning.basis,
+        "created_at": learning.created_at.isoformat(),
     }
 
 
-def _embryo_to_dict(e: EmbryoUnderstanding) -> Dict[str, Any]:
+def _embryo_to_dict(e: EmbryoUnderstanding) -> dict[str, Any]:
     return {
         "embryo_id": e.embryo_id,
         "current_stage": e.current_stage,
@@ -208,7 +217,7 @@ def _embryo_to_dict(e: EmbryoUnderstanding) -> Dict[str, Any]:
     }
 
 
-def _observation_to_dict(o: Observation) -> Dict[str, Any]:
+def _observation_to_dict(o: Observation) -> dict[str, Any]:
     return {
         "id": o.id,
         "timestamp": o.timestamp.isoformat(),
@@ -222,7 +231,7 @@ def _observation_to_dict(o: Observation) -> Dict[str, Any]:
     }
 
 
-def _expectation_to_dict(e: Expectation) -> Dict[str, Any]:
+def _expectation_to_dict(e: Expectation) -> dict[str, Any]:
     return {
         "id": e.id,
         "target": e.target,
@@ -236,7 +245,7 @@ def _expectation_to_dict(e: Expectation) -> Dict[str, Any]:
     }
 
 
-def _watchpoint_to_dict(w: Watchpoint) -> Dict[str, Any]:
+def _watchpoint_to_dict(w: Watchpoint) -> dict[str, Any]:
     return {
         "id": w.id,
         "target": w.target,
@@ -247,7 +256,7 @@ def _watchpoint_to_dict(w: Watchpoint) -> Dict[str, Any]:
     }
 
 
-def _question_to_dict(q: Question) -> Dict[str, Any]:
+def _question_to_dict(q: Question) -> dict[str, Any]:
     return {
         "id": q.id,
         "content": q.content,
diff --git a/gently/harness/memory/startup_wizard.py b/gently/harness/memory/startup_wizard.py
index 4b22b3d7..f82c706e 100644
--- a/gently/harness/memory/startup_wizard.py
+++ b/gently/harness/memory/startup_wizard.py
@@ -13,14 +13,17 @@
 
 import logging
 import uuid
-from typing import Any, Callable, Coroutine, Optional
+from collections.abc import Callable, Coroutine
+from typing import Any
 
 from gently.settings import settings
-from .gap_assessment import assess_gaps, ContextGapReport
+
+from .gap_assessment import ContextGapReport, assess_gaps
 from .model import Confidence, Learning
 from .onboarding import (
     process_onboarding_response,
 )
+
 try:
     from .file_store import FileContextStore as ContextStore
 except ImportError:
@@ -50,12 +53,12 @@ def __init__(
         self,
         context_store: ContextStore,
         session_id: str,
-        claude_client: Optional[Any] = None,
+        claude_client: Any | None = None,
     ):
         self.context_store = context_store
         self.session_id = session_id
         self.claude_client = claude_client
-        self._gap_report: Optional[ContextGapReport] = None
+        self._gap_report: ContextGapReport | None = None
 
     # ------------------------------------------------------------------
     # Public properties
@@ -181,14 +184,15 @@ async def _step_campaign_select(self, send_fn, wait_for_input, wait_for_choice):
         """Show active campaigns in a picker."""
         campaigns = self.context_store.get_active_campaigns()
         options = [
-            {"id": c.id, "label": c.display_name, "description": c.target or ""}
-            for c in campaigns
+            {"id": c.id, "label": c.display_name, "description": c.target or ""} for c in campaigns
         ]
-        options.append({
-            "id": "__new__",
-            "label": "Start something new",
-            "description": "Describe a new research direction",
-        })
+        options.append(
+            {
+                "id": "__new__",
+                "label": "Start something new",
+                "description": "Describe a new research direction",
+            }
+        )
 
         await self._say(send_fn, "Welcome back.")
 
@@ -233,11 +237,13 @@ async def _step_planned_session(self, planned_sessions, send_fn, wait_for_choice
             }
             for ps in planned_sessions
         ]
-        options.append({
-            "id": "__other__",
-            "label": "Something else",
-            "description": "Not one of these",
-        })
+        options.append(
+            {
+                "id": "__other__",
+                "label": "Something else",
+                "description": "Not one of these",
+            }
+        )
 
         count = len(planned_sessions)
         await self._say(
@@ -272,7 +278,7 @@ async def _step_session_intent(self, send_fn, wait_for_input, wait_for_choice):
 
         if campaigns:
             label = campaigns[0].display_name
-            await self._say(send_fn, f"Continuing \"{label}\" — what's the plan?")
+            await self._say(send_fn, f'Continuing "{label}" — what\'s the plan?')
         else:
             await self._say(send_fn, "What's the plan for this session?")
 
@@ -338,12 +344,14 @@ async def _step_session_intent(self, send_fn, wait_for_input, wait_for_choice):
 
     def _store_learning(self, content: str, basis: str = "onboarding:identity"):
         """Write a learning directly — no LLM round-trip."""
-        self.context_store.add_learning(Learning(
-            id=str(uuid.uuid4())[:8],
-            content=content,
-            confidence=Confidence.HIGH,
-            basis=basis,
-        ))
+        self.context_store.add_learning(
+            Learning(
+                id=str(uuid.uuid4())[:8],
+                content=content,
+                confidence=Confidence.HIGH,
+                basis=basis,
+            )
+        )
 
     async def _extract(self, send_fn, response: str, topic: str):
         """Run LLM extraction silently — no acknowledgment message.
@@ -388,9 +396,9 @@ async def _finish(self, send_fn):
         campaign_name = campaigns[0].display_name if campaigns else None
         plan = intent.planned_intent if intent else None
         organism = None
-        for l in learnings:
-            if l.content.startswith("Lab organism:"):
-                organism = l.content.split(":", 1)[1].strip()
+        for learning in learnings:
+            if learning.content.startswith("Lab organism:"):
+                organism = learning.content.split(":", 1)[1].strip()
                 break
 
         # Try LLM-generated summary
@@ -425,22 +433,28 @@ async def _finish(self, send_fn):
 
         if not summary:
             if organism:
-                summary = f"Got it — {organism}. I'm ready to help with your imaging session. What would you like to do?"
+                summary = (
+                    f"Got it — {organism}. I'm ready to help with your imaging session."
+                    " What would you like to do?"
+                )
             else:
                 summary = "All set. What can I help with?"
 
         await send_fn({"type": "text", "text": summary})
-        await send_fn({
-            "type": "stream_end",
-            "tokens": _empty_tokens(),
-            "wizard_complete": True,
-        })
+        await send_fn(
+            {
+                "type": "stream_end",
+                "tokens": _empty_tokens(),
+                "wizard_complete": True,
+            }
+        )
 
 
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
 
+
 def _is_skip(text: str) -> bool:
     return text.strip().lower() in SKIP_PHRASES
 
diff --git a/gently/harness/memory/store.py b/gently/harness/memory/store.py
index f3ae128f..5792981a 100644
--- a/gently/harness/memory/store.py
+++ b/gently/harness/memory/store.py
@@ -12,19 +12,18 @@
 
 import logging
 import sqlite3
+import uuid
 from contextlib import contextmanager
 from datetime import datetime
 from pathlib import Path
-import uuid
-
-from .model import (
-    Context,
-)
 
 from ._intentions import IntentionsMixin
 from ._ml_pipelines import MlPipelinesMixin
 from ._plans import PlansMixin
 from ._understanding import UnderstandingMixin
+from .model import (
+    Context,
+)
 
 logger = logging.getLogger(__name__)
 
@@ -248,8 +247,10 @@
 CREATE INDEX IF NOT EXISTS idx_session_campaigns_campaign ON session_campaigns(campaign_id);
 CREATE INDEX IF NOT EXISTS idx_planned_sessions_date ON planned_sessions(scheduled_date);
 CREATE INDEX IF NOT EXISTS idx_planned_sessions_status ON planned_sessions(status);
-CREATE INDEX IF NOT EXISTS idx_planned_session_campaigns_ps ON planned_session_campaigns(planned_session_id);
-CREATE INDEX IF NOT EXISTS idx_planned_session_campaigns_c ON planned_session_campaigns(campaign_id);
+CREATE INDEX IF NOT EXISTS idx_planned_session_campaigns_ps
+    ON planned_session_campaigns(planned_session_id);
+CREATE INDEX IF NOT EXISTS idx_planned_session_campaigns_c
+    ON planned_session_campaigns(campaign_id);
 CREATE INDEX IF NOT EXISTS idx_plan_items_campaign ON plan_items(campaign_id);
 CREATE INDEX IF NOT EXISTS idx_plan_items_status ON plan_items(status);
 CREATE INDEX IF NOT EXISTS idx_plan_items_type ON plan_items(type);
@@ -257,7 +258,8 @@
 CREATE INDEX IF NOT EXISTS idx_plan_item_deps_item ON plan_item_dependencies(item_id);
 CREATE INDEX IF NOT EXISTS idx_plan_item_deps_dep ON plan_item_dependencies(depends_on_id);
 CREATE INDEX IF NOT EXISTS idx_plan_snapshots_campaign ON plan_snapshots(campaign_id);
-CREATE INDEX IF NOT EXISTS idx_plan_snapshots_version ON plan_snapshots(campaign_id, version_number);
+CREATE INDEX IF NOT EXISTS idx_plan_snapshots_version
+    ON plan_snapshots(campaign_id, version_number);
 """
 
 
@@ -265,6 +267,7 @@
 # ContextStore
 # ---------------------------------------------------------------------------
 
+
 class ContextStore(IntentionsMixin, PlansMixin, UnderstandingMixin, MlPipelinesMixin):
     """
     SQLite-backed storage for the agent's context.
diff --git a/gently/harness/microscope.py b/gently/harness/microscope.py
index af25716c..f76af5c5 100644
--- a/gently/harness/microscope.py
+++ b/gently/harness/microscope.py
@@ -19,7 +19,6 @@
 
 import logging
 from pathlib import Path
-from typing import Dict, Optional, Set
 
 logger = logging.getLogger(__name__)
 
@@ -51,7 +50,7 @@ class Microscope:
     DESCRIPTION: str = ""
 
     @property
-    def plans(self) -> Set[str]:
+    def plans(self) -> set[str]:
         """Discover available plans by inspecting _plan_* methods."""
         return {
             name[6:]  # strip "_plan_" prefix
@@ -154,11 +153,11 @@ def __init__(self, http_url: str):
         self.http_url = http_url
         self._session = None
         self._connected = False
-        self._available_plans: Set[str] = set()
+        self._available_plans: set[str] = set()
         self._plan_schemas: list = []  # Anthropic tool-format schemas
 
     @property
-    def plans(self) -> Set[str]:
+    def plans(self) -> set[str]:
         return self._available_plans
 
     @property
@@ -185,7 +184,8 @@ async def connect(self) -> bool:
                     return False
                 info = await resp.json()
 
-            # Plans come as Anthropic tool schemas (list of dicts with name, description, input_schema)
+            # Plans come as Anthropic tool schemas
+            # (list of dicts with name, description, input_schema)
             plans_data = info.get("plans", [])
             if plans_data and isinstance(plans_data[0], dict):
                 # New format: list of tool schemas
@@ -194,7 +194,14 @@ async def connect(self) -> bool:
             else:
                 # Legacy format: list of plan name strings
                 self._available_plans = set(plans_data)
-                self._plan_schemas = [{"name": p, "description": p, "input_schema": {"type": "object", "properties": {}}} for p in plans_data]
+                self._plan_schemas = [
+                    {
+                        "name": p,
+                        "description": p,
+                        "input_schema": {"type": "object", "properties": {}},
+                    }
+                    for p in plans_data
+                ]
 
             self.DESCRIPTION = info.get("description", "")
             self._connected = True
@@ -256,6 +263,7 @@ def _resolve_file_refs(self, data: dict) -> None:
         for key, val in list(data.items()):
             if self._is_file_ref(val):
                 import tifffile
+
                 path = Path(val["path"])
                 data[key] = tifffile.imread(str(path))
                 data[f"{key}_path"] = str(path)
@@ -293,24 +301,31 @@ def register_microscope_tools(microscope: Microscope, registry=None) -> int:
     """
     if registry is None:
         from gently.harness.tools.registry import get_tool_registry
+
         registry = get_tool_registry()
 
-    from gently.harness.tools.registry import ToolDefinition, ToolParameter, ToolCategory
+    from gently.harness.tools.registry import (
+        ToolCategory,
+        ToolDefinition,
+        ToolParameter,
+    )
 
-    schemas = getattr(microscope, 'plan_schemas', [])
+    schemas = getattr(microscope, "plan_schemas", [])
     if not schemas:
         return 0
 
     def _make_handler(pname):
         """Create an async handler that delegates to microscope.execute()."""
+
         async def handler(context: dict = None, **params):
-            ms = context.get('client') if context else microscope
+            ms = context.get("client") if context else microscope
             if ms is None:
                 return "Error: microscope not connected"
             result = await ms.execute(pname, **params)
-            if not result.get('success', False):
+            if not result.get("success", False):
                 return f"Error: {result.get('error', 'unknown')}"
             return result
+
         handler.__name__ = f"microscope_{pname}"
         return handler
 
diff --git a/gently/harness/orchestration/plan_synthesis.py b/gently/harness/orchestration/plan_synthesis.py
index a3ae54a1..7c31f5cb 100644
--- a/gently/harness/orchestration/plan_synthesis.py
+++ b/gently/harness/orchestration/plan_synthesis.py
@@ -2,19 +2,19 @@
 Bluesky plan synthesis from natural language goals
 """
 
-import logging
-from typing import Dict, List, Optional
-from jinja2 import Template
 import ast
+import logging
 import re
 
+from jinja2 import Template
+
 logger = logging.getLogger(__name__)
 
 
 class PlanValidator:
     """Validates generated Bluesky plans for safety and correctness"""
 
-    def __init__(self, devices: Optional[Dict] = None):
+    def __init__(self, devices: dict | None = None):
         """
         Parameters
         ----------
@@ -22,7 +22,7 @@ def __init__(self, devices: Optional[Dict] = None):
             Available Ophyd devices with their limits
         """
         self.devices = devices or {}
-        self.errors: List[str] = []
+        self.errors: list[str] = []
 
     def is_valid(self, plan_code: str) -> bool:
         """
@@ -55,11 +55,11 @@ def is_valid(self, plan_code: str) -> bool:
 
         # Check for dangerous operations
         dangerous_patterns = [
-            r'import\s+os',
-            r'import\s+subprocess',
-            r'eval\(',
-            r'exec\(',
-            r'__import__',
+            r"import\s+os",
+            r"import\s+subprocess",
+            r"eval\(",
+            r"exec\(",
+            r"__import__",
         ]
 
         for pattern in dangerous_patterns:
@@ -68,19 +68,19 @@ def is_valid(self, plan_code: str) -> bool:
                 return False
 
         # Check for proper yield from usage
-        if 'def ' in plan_code and 'yield from' not in plan_code:
+        if "def " in plan_code and "yield from" not in plan_code:
             self.errors.append("Plan function must use 'yield from' for Bluesky operations")
             return False
 
         # Warnings (not errors, but noted)
-        if 'metadata=' not in plan_code:
+        if "metadata=" not in plan_code:
             self.errors.append("Warning: Plan should include metadata for provenance")
 
         # If we have errors (not just warnings), fail
         actual_errors = [e for e in self.errors if not e.startswith("Warning:")]
         return len(actual_errors) == 0
 
-    def check_parameters(self, params: Dict) -> bool:
+    def check_parameters(self, params: dict) -> bool:
         """
         Validate acquisition parameters
 
@@ -97,19 +97,22 @@ def check_parameters(self, params: Dict) -> bool:
         self.errors = []
 
         # num_slices
-        if 'num_slices' in params:
-            if not (10 <= params['num_slices'] <= 200):
+        if "num_slices" in params:
+            if not (10 <= params["num_slices"] <= 200):
                 self.errors.append(f"num_slices {params['num_slices']} outside range [10, 200]")
 
         # exposure_ms
-        if 'exposure_ms' in params:
-            if not (5 <= params['exposure_ms'] <= 100):
+        if "exposure_ms" in params:
+            if not (5 <= params["exposure_ms"] <= 100):
                 self.errors.append(f"exposure_ms {params['exposure_ms']} outside range [5, 100]")
 
         # interval_seconds
-        if 'interval_seconds' in params:
-            if params['interval_seconds'] < 10:
-                self.errors.append(f"interval_seconds {params['interval_seconds']} too short (min 10s for hardware settle)")
+        if "interval_seconds" in params:
+            if params["interval_seconds"] < 10:
+                self.errors.append(
+                    f"interval_seconds {params['interval_seconds']} too short"
+                    " (min 10s for hardware settle)"
+                )
 
         return len(self.errors) == 0
 
@@ -131,16 +134,16 @@ class PlanLibrary:
     """Collection of plan templates"""
 
     def __init__(self):
-        self.templates: Dict[str, PlanTemplate] = {}
+        self.templates: dict[str, PlanTemplate] = {}
         self._load_default_templates()
 
     def _load_default_templates(self):
         """Load built-in plan templates"""
 
         # Multi-embryo adaptive timelapse
-        self.templates['adaptive_timelapse'] = PlanTemplate(
-            name='adaptive_timelapse',
-            description='Multi-embryo timelapse with adaptive parameters',
+        self.templates["adaptive_timelapse"] = PlanTemplate(
+            name="adaptive_timelapse",
+            description="Multi-embryo timelapse with adaptive parameters",
             template_str='''
 def adaptive_timelapse_plan(
     volume_scanner,
@@ -233,12 +236,13 @@ def adaptive_timelapse_plan(
         # Wait for interval
         if timepoint < num_timepoints - 1:
             yield from bps.sleep(next_interval)
-''')
+''',
+        )
 
         # Single embryo high-resolution scan
-        self.templates['single_highres'] = PlanTemplate(
-            name='single_highres',
-            description='Single embryo high-resolution volume',
+        self.templates["single_highres"] = PlanTemplate(
+            name="single_highres",
+            description="Single embryo high-resolution volume",
             template_str='''
 def single_highres_scan_plan(
     volume_scanner,
@@ -284,15 +288,18 @@ def single_highres_scan_plan(
 
     # Notify agent
     agent.on_volume_acquired(embryo_id, 0, volume_scanner)
-''')
+''',
+        )
 
     def get_template(self, plan_type: str) -> PlanTemplate:
         """Get template by name"""
         if plan_type not in self.templates:
-            raise ValueError(f"Unknown plan type: {plan_type}. Available: {list(self.templates.keys())}")
+            raise ValueError(
+                f"Unknown plan type: {plan_type}. Available: {list(self.templates.keys())}"
+            )
         return self.templates[plan_type]
 
-    def list_templates(self) -> List[str]:
+    def list_templates(self) -> list[str]:
         """List available template names"""
         return list(self.templates.keys())
 
@@ -300,13 +307,21 @@ def list_templates(self) -> List[str]:
 class PlanSynthesizer:
     """Converts scientific goals into executable Bluesky plans"""
 
-    def __init__(self, plan_library: Optional[PlanLibrary] = None,
-                 validator: Optional[PlanValidator] = None):
+    def __init__(
+        self,
+        plan_library: PlanLibrary | None = None,
+        validator: PlanValidator | None = None,
+    ):
         self.library = plan_library or PlanLibrary()
         self.validator = validator or PlanValidator()
 
-    def synthesize(self, goal: str, embryo_ids: List[str],
-                   params: Dict, plan_type: str = 'adaptive_timelapse') -> str:
+    def synthesize(
+        self,
+        goal: str,
+        embryo_ids: list[str],
+        params: dict,
+        plan_type: str = "adaptive_timelapse",
+    ) -> str:
         """
         Generate Bluesky plan from goal
 
@@ -337,10 +352,10 @@ def synthesize(self, goal: str, embryo_ids: List[str],
         plan_code = template.render(
             goal=goal,
             embryo_ids=embryo_ids,
-            num_slices=params.get('num_slices', 50),
-            exposure_ms=params.get('exposure_ms', 10.0),
-            interval_seconds=params.get('interval_seconds', 120),
-            num_timepoints=params.get('num_timepoints', 500),
+            num_slices=params.get("num_slices", 50),
+            exposure_ms=params.get("exposure_ms", 10.0),
+            interval_seconds=params.get("interval_seconds", 120),
+            num_timepoints=params.get("num_timepoints", 500),
         )
 
         # Validate generated code
@@ -366,10 +381,15 @@ def classify_goal(self, goal: str) -> str:
         goal_lower = goal.lower()
 
         # Pattern matching for plan types
-        if any(word in goal_lower for word in ['timelapse', 'time-lapse', 'monitor', 'track', 'all embryos']):
-            return 'adaptive_timelapse'
-        elif any(word in goal_lower for word in ['high-res', 'high resolution', 'detailed', 'single']):
-            return 'single_highres'
+        if any(
+            word in goal_lower
+            for word in ["timelapse", "time-lapse", "monitor", "track", "all embryos"]
+        ):
+            return "adaptive_timelapse"
+        elif any(
+            word in goal_lower for word in ["high-res", "high resolution", "detailed", "single"]
+        ):
+            return "single_highres"
         else:
             # Default to timelapse
-            return 'adaptive_timelapse'
+            return "adaptive_timelapse"
diff --git a/gently/harness/plan_mode/prompt.py b/gently/harness/plan_mode/prompt.py
index 19ea52b7..4228249c 100644
--- a/gently/harness/plan_mode/prompt.py
+++ b/gently/harness/plan_mode/prompt.py
@@ -5,11 +5,8 @@
 rather than a live microscope control agent.
 """
 
-from typing import Optional
-
-from gently.organisms import get_organism
 from gently.hardware import get_hardware
-
+from gently.organisms import get_organism
 
 PLAN_MODE_IDENTITY = """\
 You are a scientific research planner — the same microscopy agent, but right now
@@ -147,9 +144,9 @@
 
 
 def build_plan_prompt(
-    context_summary: Optional[str] = None,
-    active_plan_summary: Optional[str] = None,
-    memory_awareness: Optional[str] = None,
+    context_summary: str | None = None,
+    active_plan_summary: str | None = None,
+    memory_awareness: str | None = None,
 ) -> str:
     """
     Build the system prompt for plan mode.
diff --git a/gently/harness/plan_mode/tools/__init__.py b/gently/harness/plan_mode/tools/__init__.py
index e39e6524..c59de53c 100644
--- a/gently/harness/plan_mode/tools/__init__.py
+++ b/gently/harness/plan_mode/tools/__init__.py
@@ -6,8 +6,6 @@
 """
 
 # Import tool modules so @tool decorators register them
-from . import planning
-from . import lab_context
-from . import research
-from . import validation
-from . import templates
+from . import lab_context, planning, research, templates, validation
+
+__all__ = ["lab_context", "planning", "research", "templates", "validation"]
diff --git a/gently/harness/plan_mode/tools/lab_context.py b/gently/harness/plan_mode/tools/lab_context.py
index 876092ef..401db7d6 100644
--- a/gently/harness/plan_mode/tools/lab_context.py
+++ b/gently/harness/plan_mode/tools/lab_context.py
@@ -5,9 +5,7 @@
 learnings, and hardware specs to inform experimental design.
 """
 
-from typing import Dict, Optional
-
-from ...tools.registry import tool, ToolCategory, ToolExample
+from ...tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
@@ -27,7 +25,7 @@
 )
 async def query_lab_history(
     query: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Search lab history for relevant context."""
     agent = context.get("agent") if context else None
@@ -59,19 +57,19 @@ async def query_lab_history(
     # Search learnings
     learnings = store.get_learnings(limit=100)
     matching_learnings = [
-        l for l in learnings
-        if any(term in l.content.lower() for term in query_lower.split())
+        learning
+        for learning in learnings
+        if any(term in learning.content.lower() for term in query_lower.split())
     ]
     if matching_learnings:
         results.append("\n## Relevant Learnings")
-        for l in matching_learnings[:10]:
-            results.append(f"- {l.content} (confidence: {l.confidence.value})")
+        for learning in matching_learnings[:10]:
+            results.append(f"- {learning.content} (confidence: {learning.confidence.value})")
 
     # Search observations
     observations = store.get_recent_observations(limit=100)
     matching_obs = [
-        o for o in observations
-        if any(term in o.content.lower() for term in query_lower.split())
+        o for o in observations if any(term in o.content.lower() for term in query_lower.split())
     ]
     if matching_obs:
         results.append("\n## Relevant Observations")
@@ -116,7 +114,7 @@ async def query_lab_history(
 )
 async def check_hardware_capability(
     question: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Check hardware capabilities against a question."""
     from gently.hardware import get_hardware
diff --git a/gently/harness/plan_mode/tools/planning.py b/gently/harness/plan_mode/tools/planning.py
index 2c33d43c..b1a976c4 100644
--- a/gently/harness/plan_mode/tools/planning.py
+++ b/gently/harness/plan_mode/tools/planning.py
@@ -7,16 +7,14 @@
 """
 
 import dataclasses
-import json
-from typing import Dict, List, Optional
-
-from ...tools.registry import tool, ToolCategory, ToolExample
 
+from ...tools.registry import ToolCategory, ToolExample, tool
 
 # ---------------------------------------------------------------------------
 # Campaign / Phase Management
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="create_campaign",
     description=(
@@ -42,7 +40,7 @@ async def create_campaign(
     shorthand: str = None,
     target: str = None,
     parent_id: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Create a campaign or sub-campaign (phase)."""
     agent = context.get("agent") if context else None
@@ -53,8 +51,9 @@ async def create_campaign(
     if shorthand:
         import re
         from datetime import datetime
+
         current_year = str(datetime.now().year)
-        shorthand = re.sub(r'-20\d{2}$', f'-{current_year}', shorthand)
+        shorthand = re.sub(r"-20\d{2}$", f"-{current_year}", shorthand)
 
     store = agent.context_store
     cid = store.create_campaign(
@@ -72,6 +71,7 @@ async def create_campaign(
 # Plan Item Management
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="create_plan_item",
     description=(
@@ -113,14 +113,14 @@ async def create_plan_item(
     type: str,
     title: str,
     description: str = None,
-    spec: Dict = None,
+    spec: dict = None,
     inherit_from: str = None,
-    depends_on: List[str] = None,
+    depends_on: list[str] = None,
     phase_number: int = None,
     phase_order: int = -1,
-    references: List[Dict] = None,
+    references: list[dict] = None,
     estimated_days: int = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Create a plan item within a campaign/phase.
 
@@ -202,11 +202,11 @@ async def update_plan_item(
     title: str = None,
     description: str = None,
     outcome: str = None,
-    spec: Dict = None,
-    references: List[Dict] = None,
+    spec: dict = None,
+    references: list[dict] = None,
     estimated_days: int = None,
     campaign_id: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Update a plan item. item_id can be a UUID, task number (e.g. '3'),
     or phase.task reference (e.g. '1.3'). campaign_id scopes resolution
@@ -240,9 +240,9 @@ async def update_plan_item(
     if status:
         changes.append(f"status -> {status}")
     if outcome:
-        changes.append(f"outcome recorded")
+        changes.append("outcome recorded")
     if spec:
-        changes.append(f"spec updated")
+        changes.append("spec updated")
     if title:
         changes.append(f"title -> {title}")
     if references:
@@ -264,7 +264,7 @@ async def link_plan_items(
     item_id: str,
     depends_on_id: str,
     campaign_id: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Add a dependency between plan items. campaign_id scopes resolution
     when using shorthand refs (e.g. '1.3') with multiple plans."""
@@ -309,7 +309,7 @@ async def link_plan_items(
 async def get_plan_item_tool(
     ref: str,
     campaign_id: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Look up a plan item by natural reference."""
     agent = context.get("agent") if context else None
@@ -328,6 +328,7 @@ async def get_plan_item_tool(
 # Plan Review
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="propose_plan",
     description=(
@@ -346,7 +347,7 @@ async def get_plan_item_tool(
 )
 async def propose_plan(
     campaign_id: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Render the full plan for review."""
     agent = context.get("agent") if context else None
@@ -401,7 +402,7 @@ async def propose_plan(
 
     # Summary
     status = store.get_plan_status(campaign_id)
-    lines.append(f"── Summary ──")
+    lines.append("── Summary ──")
     lines.append(f"Total items: {status['total']}")
     lines.append(f"Completed: {status['completed']}")
     if status["pending_decisions"]:
@@ -485,8 +486,8 @@ def _format_plan_item(item, store, task_num: str = "") -> str:
     if item.references:
         ref_strs = []
         for r in item.references:
-            tag = f"[{r.get('source', '').upper()}]" if r.get('source') else ""
-            cite = r.get('citation', '')
+            tag = f"[{r.get('source', '').upper()}]" if r.get("source") else ""
+            cite = r.get("citation", "")
             ref_strs.append(f"{tag} {cite}")
         details.append(f"   Refs: {'; '.join(ref_strs)}")
 
@@ -505,7 +506,7 @@ def _format_plan_item(item, store, task_num: str = "") -> str:
 )
 async def get_plan_status(
     campaign_id: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Get plan progress summary."""
     agent = context.get("agent") if context else None
@@ -551,6 +552,7 @@ async def get_plan_status(
 # Batch Operations
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="batch_update_status",
     description=(
@@ -577,7 +579,7 @@ async def batch_update_status(
     outcome: str = None,
     phase_number: int = None,
     item_type: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Batch-update status of plan items."""
     agent = context.get("agent") if context else None
@@ -613,7 +615,8 @@ async def batch_update_status(
             for dep_id in item.depends_on:
                 dep = store.get_plan_item(dep_id)
                 if dep and dep.status not in (
-                    PlanItemStatus.COMPLETED, PlanItemStatus.SKIPPED,
+                    PlanItemStatus.COMPLETED,
+                    PlanItemStatus.SKIPPED,
                 ):
                     all_resolved = False
                     break
@@ -657,7 +660,7 @@ async def batch_update_spec(
     field_name: str,
     field_value: object,
     phase_number: int = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Batch-update a spec field on imaging items."""
     agent = context.get("agent") if context else None
@@ -668,6 +671,7 @@ async def batch_update_spec(
 
     # Validate field name against ImagingSpec
     from gently.harness.memory.model import ImagingSpec
+
     valid_fields = {f.name for f in dataclasses.fields(ImagingSpec)}
     if field_name not in valid_fields:
         return (
@@ -709,6 +713,7 @@ async def batch_update_spec(
 # Plan Reorganization
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="move_plan_item",
     description=(
@@ -735,7 +740,7 @@ async def move_plan_item(
     to_phase_number: int = None,
     to_campaign_id: str = None,
     position: int = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Move a plan item to a different phase."""
     agent = context.get("agent") if context else None
@@ -795,7 +800,7 @@ async def move_plan_item(
 async def delete_plan_item_tool(
     item_ref: str,
     campaign_id: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Delete a plan item."""
     agent = context.get("agent") if context else None
@@ -850,9 +855,9 @@ async def delete_plan_item_tool(
 )
 async def reorder_plan_items(
     campaign_id: str,
-    item_order: List[str],
+    item_order: list[str],
     phase_number: int = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Reorder plan items within a phase."""
     agent = context.get("agent") if context else None
@@ -917,7 +922,7 @@ async def update_phase(
     description: str = None,
     shorthand: str = None,
     target: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Update a phase's metadata."""
     agent = context.get("agent") if context else None
@@ -958,7 +963,7 @@ async def update_phase(
 async def delete_phase(
     campaign_id: str,
     phase_number: int,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Delete a phase and its contents."""
     agent = context.get("agent") if context else None
@@ -992,6 +997,7 @@ async def delete_phase(
 # Plan Export
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="export_plan",
     description=(
@@ -1011,7 +1017,7 @@ async def delete_phase(
 async def export_plan(
     campaign_id: str,
     include_validation: bool = False,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Export a plan as a shareable markdown document."""
     agent = context.get("agent") if context else None
@@ -1088,7 +1094,7 @@ async def export_plan(
     seen_ids = set()
     for item in all_items:
         for ref in item.references:
-            ref_key = ref.get('id') or ref.get('citation', '')
+            ref_key = ref.get("id") or ref.get("citation", "")
             if ref_key and ref_key not in seen_ids:
                 seen_ids.add(ref_key)
                 all_refs.append(ref)
@@ -1096,10 +1102,10 @@ async def export_plan(
     if all_refs:
         lines.append("---\n## References\n")
         for i, r in enumerate(all_refs, 1):
-            tag = f"[{r.get('source', '').upper()}]" if r.get('source') else ""
-            cite = r.get('citation', '')
-            rid = r.get('id', '')
-            note = r.get('note', '')
+            tag = f"[{r.get('source', '').upper()}]" if r.get("source") else ""
+            cite = r.get("citation", "")
+            rid = r.get("id", "")
+            note = r.get("note", "")
             line = f"{i}. {tag} {cite}"
             if rid:
                 line += f" ({rid})"
@@ -1128,10 +1134,11 @@ async def export_plan(
 def _export_date() -> str:
     """Return current date in human-readable format."""
     from datetime import datetime
+
     return datetime.now().strftime("%Y-%m-%d")
 
 
-def _export_item(item, store, num: str) -> List[str]:
+def _export_item(item, store, num: str) -> list[str]:
     """Format a plan item for the export document."""
     from gently.harness.memory.model import PlanItemStatus
 
@@ -1211,10 +1218,10 @@ def _export_item(item, store, num: str) -> List[str]:
     if item.references:
         lines.append("**References:**")
         for r in item.references:
-            tag = f"[{r.get('source', '').upper()}]" if r.get('source') else ""
-            cite = r.get('citation', '')
-            rid = r.get('id', '')
-            note = r.get('note', '')
+            tag = f"[{r.get('source', '').upper()}]" if r.get("source") else ""
+            cite = r.get("citation", "")
+            rid = r.get("id", "")
+            note = r.get("note", "")
             line = f"- {tag} {cite}"
             if rid:
                 line += f" ({rid})"
@@ -1229,9 +1236,9 @@ def _export_item(item, store, num: str) -> List[str]:
 async def validate_plan_for_export(campaign_id: str, store) -> str:
     """Run validation and return a markdown-formatted report for export."""
     from .validation import (
-        HARDWARE_LIMITS, CONTROL_KEYWORDS,
-        _check_dependency_cycles, _stage_order, _normalise_stage,
-        _get_temp_factor, STAGE_TIMING_20C,
+        CONTROL_KEYWORDS,
+        HARDWARE_LIMITS,
+        _check_dependency_cycles,
     )
 
     items = store.get_plan_items(campaign_id=campaign_id, include_children=True)
@@ -1240,11 +1247,15 @@ async def validate_plan_for_export(campaign_id: str, store) -> str:
 
     try:
         from gently.organisms import get_organism
+
         org = get_organism()
-        presets_mod = __import__(f"gently.organisms.{org.ORGANISM_NAME}.detector_presets", fromlist=["get_detector_presets"])
-        valid_detectors = set(presets_mod.get_detector_presets().keys())
+        presets_mod = __import__(
+            f"gently.organisms.{org.ORGANISM_NAME}.detector_presets",
+            fromlist=["get_detector_presets"],
+        )
+        set(presets_mod.get_detector_presets().keys())
     except ImportError:
-        valid_detectors = set()
+        pass
 
     issues = []
     has_control = False
@@ -1253,9 +1264,18 @@ async def validate_plan_for_export(campaign_id: str, store) -> str:
         label = f"{item.title}"
         text_blob = " ".join(filter(None, [item.title, item.description])).lower()
         if item.imaging_spec:
-            text_blob += " " + " ".join(filter(None, [
-                item.imaging_spec.strain, item.imaging_spec.genotype,
-            ])).lower()
+            text_blob += (
+                " "
+                + " ".join(
+                    filter(
+                        None,
+                        [
+                            item.imaging_spec.strain,
+                            item.imaging_spec.genotype,
+                        ],
+                    )
+                ).lower()
+            )
         if any(kw in text_blob for kw in CONTROL_KEYWORDS):
             has_control = True
 
@@ -1286,6 +1306,7 @@ async def validate_plan_for_export(campaign_id: str, store) -> str:
 # Plan Versioning
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="snapshot_plan",
     description=(
@@ -1307,7 +1328,7 @@ async def validate_plan_for_export(campaign_id: str, store) -> str:
 async def snapshot_plan(
     campaign_id: str,
     label: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Save a snapshot of the current plan."""
     agent = context.get("agent") if context else None
@@ -1346,7 +1367,7 @@ async def snapshot_plan(
 )
 async def list_plan_versions(
     campaign_id: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """List saved plan versions."""
     agent = context.get("agent") if context else None
@@ -1367,10 +1388,7 @@ async def list_plan_versions(
         if s.get("summary"):
             first_line = s["summary"].split("\n")[0]
             summary_line = f"  {first_line}"
-        lines.append(
-            f"  v{s['version_number']}{label}  ({s['version_id']})  "
-            f"{s['created_at']}"
-        )
+        lines.append(f"  v{s['version_number']}{label}  ({s['version_id']})  {s['created_at']}")
         if summary_line:
             lines.append(f"    {summary_line}")
 
@@ -1399,7 +1417,7 @@ async def restore_plan_version(
     campaign_id: str,
     version_id: str = None,
     version_number: int = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Restore a plan to a previous snapshot."""
     agent = context.get("agent") if context else None
diff --git a/gently/harness/plan_mode/tools/research.py b/gently/harness/plan_mode/tools/research.py
index df8e4359..6c3b19b5 100644
--- a/gently/harness/plan_mode/tools/research.py
+++ b/gently/harness/plan_mode/tools/research.py
@@ -14,10 +14,9 @@
 import json
 import logging
 import ssl
-from typing import Dict, List, Optional
 
-from ...tools.registry import tool, ToolCategory, ToolExample
 from ....settings import settings
+from ...tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
 
@@ -37,12 +36,13 @@ def _ssl_context() -> ssl.SSLContext:
     """
     try:
         import certifi
+
         return ssl.create_default_context(cafile=certifi.where())
     except ImportError:
         return ssl.create_default_context()
 
 
-def _ncbi_params(**kwargs) -> Dict:
+def _ncbi_params(**kwargs) -> dict:
     """Add standard NCBI tool/email to query params."""
     kwargs["tool"] = _NCBI_TOOL
     kwargs["email"] = _NCBI_EMAIL
@@ -53,6 +53,7 @@ def _ncbi_params(**kwargs) -> Dict:
 def _http_session():
     """Create an aiohttp ClientSession with explicit SSL certs."""
     import aiohttp
+
     connector = aiohttp.TCPConnector(ssl=_ssl_context())
     return aiohttp.ClientSession(connector=connector)
 
@@ -61,11 +62,12 @@ def _http_session():
 # PubMed literature search
 # ---------------------------------------------------------------------------
 
-async def _pubmed_search(query: str, max_results: int) -> List[Dict]:
+
+async def _pubmed_search(query: str, max_results: int) -> list[dict]:
     """Search PubMed via E-utilities and return article summaries."""
     import aiohttp
 
-    results: List[Dict] = []
+    results: list[dict] = []
 
     try:
         async with _http_session() as session:
@@ -120,21 +122,23 @@ async def _pubmed_search(query: str, max_results: int) -> List[Dict]:
                     else:
                         author_str = first
 
-                results.append({
-                    "pmid": pmid,
-                    "title": article.get("title", ""),
-                    "authors": author_str,
-                    "journal": article.get("fulljournalname", article.get("source", "")),
-                    "year": article.get("pubdate", "")[:4],
-                    "doi": next(
-                        (
-                            aid.get("value", "")
-                            for aid in article.get("articleids", [])
-                            if aid.get("idtype") == "doi"
+                results.append(
+                    {
+                        "pmid": pmid,
+                        "title": article.get("title", ""),
+                        "authors": author_str,
+                        "journal": article.get("fulljournalname", article.get("source", "")),
+                        "year": article.get("pubdate", "")[:4],
+                        "doi": next(
+                            (
+                                aid.get("value", "")
+                                for aid in article.get("articleids", [])
+                                if aid.get("idtype") == "doi"
+                            ),
+                            "",
                         ),
-                        "",
-                    ),
-                })
+                    }
+                )
 
     except Exception as e:
         logger.warning(f"PubMed search failed: {e}", exc_info=True)
@@ -146,11 +150,12 @@ async def _pubmed_search(query: str, max_results: int) -> List[Dict]:
 # NCBI Gene search
 # ---------------------------------------------------------------------------
 
-async def _ncbi_gene_search(query: str, max_results: int = 5) -> List[Dict]:
+
+async def _ncbi_gene_search(query: str, max_results: int = 5) -> list[dict]:
     """Search NCBI Gene database for C. elegans genes."""
     import aiohttp
 
-    results: List[Dict] = []
+    results: list[dict] = []
 
     try:
         async with _http_session() as session:
@@ -199,14 +204,16 @@ async def _ncbi_gene_search(query: str, max_results: int = 5) -> List[Dict]:
                 if org.get("taxid") != 6239:
                     continue
 
-                results.append({
-                    "gene_id": gid,
-                    "name": gene.get("name", ""),
-                    "description": gene.get("description", ""),
-                    "summary": gene.get("summary", ""),
-                    "chromosome": gene.get("chromosome", ""),
-                    "aliases": gene.get("otheraliases", ""),
-                })
+                results.append(
+                    {
+                        "gene_id": gid,
+                        "name": gene.get("name", ""),
+                        "description": gene.get("description", ""),
+                        "summary": gene.get("summary", ""),
+                        "chromosome": gene.get("chromosome", ""),
+                        "aliases": gene.get("otheraliases", ""),
+                    }
+                )
 
     except Exception as e:
         logger.warning(f"NCBI Gene search failed: {e}", exc_info=True)
@@ -218,7 +225,8 @@ async def _ncbi_gene_search(query: str, max_results: int = 5) -> List[Dict]:
 # WormBase strain lookup (by gene ID)
 # ---------------------------------------------------------------------------
 
-async def _wormbase_gene_strains(wbgene_id: str) -> List[Dict]:
+
+async def _wormbase_gene_strains(wbgene_id: str) -> list[dict]:
     """Get strains carrying a gene from WormBase REST API.
 
     Parameters
@@ -228,7 +236,7 @@ async def _wormbase_gene_strains(wbgene_id: str) -> List[Dict]:
     """
     import aiohttp
 
-    results: List[Dict] = []
+    results: list[dict] = []
 
     try:
         url = f"https://rest.wormbase.org/rest/field/gene/{wbgene_id}/strains"
@@ -255,12 +263,14 @@ async def _wormbase_gene_strains(wbgene_id: str) -> List[Dict]:
             for entry in strain_list:
                 if not isinstance(entry, dict):
                     continue
-                results.append({
-                    "name": entry.get("label", ""),
-                    "genotype": entry.get("genotype", ""),
-                    "cgc_available": is_cgc or category == "available_from_cgc",
-                    "category": category,
-                })
+                results.append(
+                    {
+                        "name": entry.get("label", ""),
+                        "genotype": entry.get("genotype", ""),
+                        "cgc_available": is_cgc or category == "available_from_cgc",
+                        "category": category,
+                    }
+                )
 
     except Exception as e:
         logger.warning(f"WormBase strain lookup failed: {e}", exc_info=True)
@@ -268,7 +278,7 @@ async def _wormbase_gene_strains(wbgene_id: str) -> List[Dict]:
     return results
 
 
-async def _wormbase_gene_id_lookup(gene_name: str) -> Optional[str]:
+async def _wormbase_gene_id_lookup(gene_name: str) -> str | None:
     """Look up a WormBase gene ID from an NCBI gene name.
 
     Uses NCBI gene → dbxrefs to find WormBase ID, or falls back to
@@ -314,7 +324,8 @@ async def _wormbase_gene_id_lookup(gene_name: str) -> Optional[str]:
 
             # Look for WBGene ID in the response text
             import re
-            match = re.search(r'(WBGene\d+)', text)
+
+            match = re.search(r"(WBGene\d+)", text)
             if match:
                 return match.group(1)
 
@@ -328,7 +339,8 @@ async def _wormbase_gene_id_lookup(gene_name: str) -> Optional[str]:
 # CGC strain search (HTML scraping fallback)
 # ---------------------------------------------------------------------------
 
-async def _cgc_search(query: str, field: str = "strain") -> List[Dict]:
+
+async def _cgc_search(query: str, field: str = "strain") -> list[dict]:
     """Search CGC (Caenorhabditis Genetics Center) strain database.
 
     Parameters
@@ -338,10 +350,11 @@ async def _cgc_search(query: str, field: str = "strain") -> List[Dict]:
     field : str
         Field to search: "strain", "genotype", "description", "all".
     """
-    import aiohttp
     import re
 
-    results: List[Dict] = []
+    import aiohttp
+
+    results: list[dict] = []
 
     try:
         url = "https://cgc.umn.edu/strain/search"
@@ -361,25 +374,27 @@ async def _cgc_search(query: str, field: str = "strain") -> List[Dict]:
         # CGC uses table rows with strain name, species, genotype, description
         # Pattern: look for strain links like /strain/OH904
         strain_pattern = re.compile(
-            r'/strain/([A-Z]{1,3}\d+).*?'
-            r'<td[^>]*>(.*?)</td>.*?'  # species
-            r'<td[^>]*>(.*?)</td>.*?'  # genotype
-            r'<td[^>]*>(.*?)</td>',     # description
+            r"/strain/([A-Z]{1,3}\d+).*?"
+            r"<td[^>]*>(.*?)</td>.*?"  # species
+            r"<td[^>]*>(.*?)</td>.*?"  # genotype
+            r"<td[^>]*>(.*?)</td>",  # description
             re.DOTALL,
         )
 
         for match in strain_pattern.finditer(html):
             strain_name = match.group(1).strip()
-            genotype = re.sub(r'<[^>]+>', '', match.group(3)).strip()
-            description = re.sub(r'<[^>]+>', '', match.group(4)).strip()
+            genotype = re.sub(r"<[^>]+>", "", match.group(3)).strip()
+            description = re.sub(r"<[^>]+>", "", match.group(4)).strip()
 
             if strain_name:
-                results.append({
-                    "name": strain_name,
-                    "genotype": genotype,
-                    "description": description[:200] if description else "",
-                    "source": "CGC",
-                })
+                results.append(
+                    {
+                        "name": strain_name,
+                        "genotype": genotype,
+                        "description": description[:200] if description else "",
+                        "source": "CGC",
+                    }
+                )
 
         # If regex didn't work, try a simpler approach — find strain names
         if not results:
@@ -389,12 +404,14 @@ async def _cgc_search(query: str, field: str = "strain") -> List[Dict]:
                 name = m.group(1)
                 if name not in seen:
                     seen.add(name)
-                    results.append({
-                        "name": name,
-                        "genotype": "",
-                        "description": "",
-                        "source": "CGC",
-                    })
+                    results.append(
+                        {
+                            "name": name,
+                            "genotype": "",
+                            "description": "",
+                            "source": "CGC",
+                        }
+                    )
 
         # Check for "no results" message
         if "no results for this search" in html.lower():
@@ -410,6 +427,7 @@ async def _cgc_search(query: str, field: str = "strain") -> List[Dict]:
 # Tools
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="search_literature",
     description=(
@@ -430,7 +448,7 @@ async def _cgc_search(query: str, field: str = "strain") -> List[Dict]:
 async def search_literature(
     query: str,
     max_results: int = 5,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Search PubMed for relevant papers.
 
@@ -447,11 +465,10 @@ async def search_literature(
 
     # If no results, try progressively simpler queries
     if not results:
-        import re as _re
         words = query.split()
         if len(words) > 3:
             # Strategy 1: keep first ~60% of terms (drop trailing specifics)
-            shorter = " ".join(words[:max(3, len(words) * 2 // 3)])
+            shorter = " ".join(words[: max(3, len(words) * 2 // 3)])
             results = await _pubmed_search(shorter, max_results)
             if results:
                 used_query = shorter
@@ -459,8 +476,23 @@ async def search_literature(
         if not results and len(words) > 4:
             # Strategy 2: keep only the core noun phrases (drop adjectives/filler)
             # Remove common filler words
-            stopwords = {"and", "or", "the", "of", "in", "for", "with", "a", "an",
-                         "using", "based", "via", "during", "after", "before"}
+            stopwords = {
+                "and",
+                "or",
+                "the",
+                "of",
+                "in",
+                "for",
+                "with",
+                "a",
+                "an",
+                "using",
+                "based",
+                "via",
+                "during",
+                "after",
+                "before",
+            }
             core = [w for w in words if w.lower() not in stopwords]
             if len(core) > 3:
                 core = core[:4]
@@ -514,9 +546,9 @@ async def search_literature(
     lines.append("\n---")
     lines.append("**Citation references for plan items** (pass to `references` param):")
     for r in results:
-        author = r['authors'] or 'Unknown'
-        year = r['year'] or ''
-        journal = r['journal'] or ''
+        author = r["authors"] or "Unknown"
+        year = r["year"] or ""
+        journal = r["journal"] or ""
         cite = f"{author} ({year}) {r['title'][:80]}. {journal}"
         ref = {
             "source": "pubmed",
@@ -558,7 +590,7 @@ async def search_literature(
 async def search_strains(
     query: str,
     organism: str = "celegans",
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Search for strains and genes via NCBI Gene + WormBase REST API.
 
@@ -574,7 +606,7 @@ async def search_strains(
     import re as _re
 
     # Detect if query looks like a strain name (e.g. OH904, N2, CB1370)
-    is_strain_query = bool(_re.match(r'^[A-Z]{1,3}\d+$', query.strip()))
+    is_strain_query = bool(_re.match(r"^[A-Z]{1,3}\d+$", query.strip()))
 
     # Step 0: If it looks like a strain name, search CGC directly
     cgc_results = []
@@ -632,7 +664,8 @@ async def search_strains(
                     lines.append(f"   **Strains ({len(strains)} found):**")
                     # Show up to 6, prioritising CGC-available
                     sorted_strains = sorted(
-                        strains, key=lambda s: (not s["cgc_available"], s["name"]),
+                        strains,
+                        key=lambda s: (not s["cgc_available"], s["name"]),
                     )
                     for s in sorted_strains[:6]:
                         cgc_tag = " [CGC]" if s["cgc_available"] else ""
@@ -663,17 +696,21 @@ async def search_strains(
     citation_refs = []
     if cgc_results:
         for s in cgc_results:
-            citation_refs.append({
-                "source": "cgc",
-                "citation": f"{s['name']} available from CGC",
-                "id": f"CGC:{s['name']}",
-            })
+            citation_refs.append(
+                {
+                    "source": "cgc",
+                    "citation": f"{s['name']} available from CGC",
+                    "id": f"CGC:{s['name']}",
+                }
+            )
     for gene in genes:
-        citation_refs.append({
-            "source": "ncbi_gene",
-            "citation": f"{gene['name']} — {gene['description']}",
-            "id": f"GeneID:{gene['gene_id']}",
-        })
+        citation_refs.append(
+            {
+                "source": "ncbi_gene",
+                "citation": f"{gene['name']} — {gene['description']}",
+                "id": f"GeneID:{gene['gene_id']}",
+            }
+        )
     if citation_refs:
         lines.append("\n---")
         lines.append("**Citation references for plan items** (pass to `references` param):")
@@ -687,7 +724,8 @@ async def search_strains(
 # Paper reading — full text retrieval
 # ---------------------------------------------------------------------------
 
-async def _pmid_to_pmcid(pmid: str) -> Optional[str]:
+
+async def _pmid_to_pmcid(pmid: str) -> str | None:
     """Convert a PMID to a PMCID via the NCBI ID converter."""
     import aiohttp
 
@@ -716,11 +754,12 @@ async def _pmid_to_pmcid(pmid: str) -> Optional[str]:
     return None
 
 
-async def _fetch_pmc_fulltext(pmcid: str) -> Optional[str]:
+async def _fetch_pmc_fulltext(pmcid: str) -> str | None:
     """Fetch full text from PubMed Central as XML, parse into sections."""
-    import aiohttp
     import xml.etree.ElementTree as ET
 
+    import aiohttp
+
     try:
         # Strip "PMC" prefix for efetch — it wants just the number
         pmc_num = pmcid.replace("PMC", "")
@@ -836,7 +875,7 @@ def _find_parent(root, target):
     return None
 
 
-async def _unpaywall_lookup(doi: str) -> Optional[str]:
+async def _unpaywall_lookup(doi: str) -> str | None:
     """Find an open access full text URL via Unpaywall."""
     import aiohttp
 
@@ -861,11 +900,12 @@ async def _unpaywall_lookup(doi: str) -> Optional[str]:
     return None
 
 
-async def _fetch_url_text(url: str) -> Optional[str]:
+async def _fetch_url_text(url: str) -> str | None:
     """Fetch a URL and extract text content (HTML → plain text)."""
-    import aiohttp
     import re as _re
 
+    import aiohttp
+
     try:
         async with _http_session() as session:
             async with session.get(
@@ -884,10 +924,10 @@ async def _fetch_url_text(url: str) -> Optional[str]:
                 html = await resp.text()
 
         # Simple HTML → text: strip tags, collapse whitespace
-        text = _re.sub(r'<script[^>]*>.*?</script>', '', html, flags=_re.DOTALL)
-        text = _re.sub(r'<style[^>]*>.*?</style>', '', html, flags=_re.DOTALL)
-        text = _re.sub(r'<[^>]+>', ' ', text)
-        text = _re.sub(r'\s+', ' ', text).strip()
+        text = _re.sub(r"<script[^>]*>.*?</script>", "", html, flags=_re.DOTALL)
+        text = _re.sub(r"<style[^>]*>.*?</style>", "", html, flags=_re.DOTALL)
+        text = _re.sub(r"<[^>]+>", " ", text)
+        text = _re.sub(r"\s+", " ", text).strip()
 
         if len(text) > 15000:
             text = text[:15000] + "\n\n[... truncated ...]"
@@ -899,7 +939,7 @@ async def _fetch_url_text(url: str) -> Optional[str]:
         return None
 
 
-def _read_pdf_file(path: str) -> Optional[str]:
+def _read_pdf_file(path: str) -> str | None:
     """Extract text from a local PDF file using pymupdf if available."""
     import os
 
@@ -908,6 +948,7 @@ def _read_pdf_file(path: str) -> Optional[str]:
 
     try:
         import fitz  # pymupdf
+
         doc = fitz.open(path)
         pages = []
         for page in doc:
@@ -920,15 +961,16 @@ def _read_pdf_file(path: str) -> Optional[str]:
         return text if text.strip() else None
 
     except ImportError:
-        logger.info("pymupdf not installed — cannot extract PDF text. "
-                     "Install with: pip install pymupdf")
+        logger.info(
+            "pymupdf not installed — cannot extract PDF text. Install with: pip install pymupdf"
+        )
         return None
     except Exception as e:
         logger.warning(f"PDF extraction failed for {path}: {e}")
         return None
 
 
-async def _pubmed_abstract(pmid: str) -> Optional[Dict]:
+async def _pubmed_abstract(pmid: str) -> dict | None:
     """Fetch article metadata + abstract from PubMed."""
     import aiohttp
 
@@ -948,6 +990,7 @@ async def _pubmed_abstract(pmid: str) -> Optional[Dict]:
                 xml_text = await resp.text()
 
         import xml.etree.ElementTree as ET
+
         root = ET.fromstring(xml_text)
 
         article = root.find(".//PubmedArticle")
@@ -998,26 +1041,26 @@ async def _pubmed_abstract(pmid: str) -> Optional[Dict]:
         return None
 
 
-async def _resolve_reference(reference: str) -> Dict:
+async def _resolve_reference(reference: str) -> dict:
     """Parse a reference string and determine what kind of input it is.
 
     Returns a dict with keys: type, pmid, doi, url, path, query
     """
-    import re
     import os
+    import re
 
     ref = reference.strip()
     result = {"type": "unknown", "raw": ref}
 
     # PMID
-    m = re.match(r'^(?:PMID[:\s]*)?(\d{6,9})$', ref, re.IGNORECASE)
+    m = re.match(r"^(?:PMID[:\s]*)?(\d{6,9})$", ref, re.IGNORECASE)
     if m:
         result["type"] = "pmid"
         result["pmid"] = m.group(1)
         return result
 
     # DOI
-    m = re.search(r'(10\.\d{4,}/[^\s]+)', ref)
+    m = re.search(r"(10\.\d{4,}/[^\s]+)", ref)
     if m:
         result["type"] = "doi"
         result["doi"] = m.group(1).rstrip(".,;)")
@@ -1029,13 +1072,13 @@ async def _resolve_reference(reference: str) -> Dict:
         result["url"] = ref if ref.startswith("http") else "https://" + ref
 
         # Extract PMID from PubMed URLs
-        m = re.search(r'pubmed\.ncbi.*?/(\d{6,9})', ref)
+        m = re.search(r"pubmed\.ncbi.*?/(\d{6,9})", ref)
         if m:
             result["type"] = "pmid"
             result["pmid"] = m.group(1)
 
         # Extract PMCID from PMC URLs
-        m = re.search(r'/pmc/articles/(PMC\d+)', ref)
+        m = re.search(r"/pmc/articles/(PMC\d+)", ref)
         if m:
             result["type"] = "pmcid"
             result["pmcid"] = m.group(1)
@@ -1054,7 +1097,7 @@ async def _resolve_reference(reference: str) -> Dict:
     return result
 
 
-async def _search_pmid(query: str) -> Optional[str]:
+async def _search_pmid(query: str) -> str | None:
     """Search PubMed for a citation string and return the best PMID.
 
     Tries multiple query strategies to handle imprecise citations like
@@ -1066,7 +1109,7 @@ async def _search_pmid(query: str) -> Optional[str]:
 
     # Detect "Author et al YEAR topic" pattern
     m = _re.match(
-        r'^([A-Z][a-z]+)\s+(?:et\s+al\.?\s+)?(\d{4})?\s*(.*)?$',
+        r"^([A-Z][a-z]+)\s+(?:et\s+al\.?\s+)?(\d{4})?\s*(.*)?$",
         query.strip(),
     )
     if m:
@@ -1076,8 +1119,10 @@ async def _search_pmid(query: str) -> Optional[str]:
 
         # Fix common organism names in topic
         topic_fixed = _re.sub(
-            r'\bC\.?\s*elegans\b', '"Caenorhabditis elegans"',
-            topic, flags=_re.IGNORECASE,
+            r"\bC\.?\s*elegans\b",
+            '"Caenorhabditis elegans"',
+            topic,
+            flags=_re.IGNORECASE,
         )
 
         # Strategy 1: author + organism MeSH + quoted topic (most specific)
@@ -1087,15 +1132,11 @@ async def _search_pmid(query: str) -> Optional[str]:
             )
 
         # Strategy 2: author + organism MeSH (no topic — topic may not be in title)
-        strategies.append(
-            f'{author}[author] AND "Caenorhabditis elegans"[Mesh]'
-        )
+        strategies.append(f'{author}[author] AND "Caenorhabditis elegans"[Mesh]')
 
         # Strategy 3: author + year + topic (exact year, may be wrong)
         if year and topic_fixed:
-            strategies.append(
-                f'{author}[author] AND {year}[pdat] AND {topic_fixed}'
-            )
+            strategies.append(f"{author}[author] AND {year}[pdat] AND {topic_fixed}")
 
         # Strategy 4: author + year only
         if year:
@@ -1103,8 +1144,10 @@ async def _search_pmid(query: str) -> Optional[str]:
 
     # Strategy 5: original query with organism name fix
     fixed = _re.sub(
-        r'\bC\.?\s*elegans\b', '"Caenorhabditis elegans"',
-        query, flags=_re.IGNORECASE,
+        r"\bC\.?\s*elegans\b",
+        '"Caenorhabditis elegans"',
+        query,
+        flags=_re.IGNORECASE,
     )
     if fixed != query:
         strategies.append(fixed)
@@ -1122,6 +1165,7 @@ async def _search_pmid(query: str) -> Optional[str]:
 
     # Try each strategy
     import aiohttp
+
     for attempt in unique:
         try:
             async with _http_session() as session:
@@ -1145,7 +1189,7 @@ async def _search_pmid(query: str) -> Optional[str]:
     return None
 
 
-async def _doi_to_pmid(doi: str) -> Optional[str]:
+async def _doi_to_pmid(doi: str) -> str | None:
     """Resolve a DOI to a PMID via PubMed search."""
     return await _search_pmid(f"{doi}[doi]")
 
@@ -1177,7 +1221,7 @@ async def _doi_to_pmid(doi: str) -> Optional[str]:
 )
 async def read_paper(
     reference: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Read a scientific paper and return its content.
 
@@ -1229,11 +1273,7 @@ async def read_paper(
         status_lines.append(f"Reading local PDF: {path}")
         text = _read_pdf_file(path)
         if text:
-            return (
-                f"[Paper from local file: {path}]\n\n"
-                f"{text}\n\n---\n"
-                f"Source: local file"
-            )
+            return f"[Paper from local file: {path}]\n\n{text}\n\n---\nSource: local file"
         else:
             return (
                 f"[Paper from local file: {path}]\n\n"
@@ -1308,7 +1348,7 @@ async def read_paper(
         meta = await _pubmed_abstract(pmid)
         if meta:
             lines = [
-                f"[Abstract only — full text not freely available]\n",
+                "[Abstract only — full text not freely available]\n",
                 f"# {meta['title']}\n",
                 f"**Authors:** {meta['authors']}",
                 f"**Journal:** {meta['journal']} ({meta['year']})",
@@ -1319,9 +1359,9 @@ async def read_paper(
             lines.append(f"\n## Abstract\n\n{meta['abstract']}")
 
             lines.append(
-                f"\n---\n"
-                f"*Full text not available through open access channels. "
-                f"If you have a PDF, provide the file path and I can read it.*"
+                "\n---\n"
+                "*Full text not available through open access channels. "
+                "If you have a PDF, provide the file path and I can read it.*"
             )
             lines.append(f"\n*Resolution path: {' → '.join(status_lines)}*")
 
diff --git a/gently/harness/plan_mode/tools/templates.py b/gently/harness/plan_mode/tools/templates.py
index 006c4c95..b75b0e64 100644
--- a/gently/harness/plan_mode/tools/templates.py
+++ b/gently/harness/plan_mode/tools/templates.py
@@ -5,9 +5,7 @@
 dependencies) for re-use with different strains, temperatures, etc.
 """
 
-from typing import Dict, Optional
-
-from ...tools.registry import tool, ToolCategory, ToolExample
+from ...tools.registry import ToolCategory, ToolExample, tool
 
 
 @tool(
@@ -34,7 +32,7 @@ async def save_plan_template(
     campaign_id: str,
     name: str,
     description: str = None,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Save a campaign as a reusable template."""
     agent = context.get("agent") if context else None
@@ -67,7 +65,7 @@ async def save_plan_template(
     category=ToolCategory.UTILITY,
 )
 async def list_templates(
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """List available plan templates."""
     agent = context.get("agent") if context else None
@@ -112,8 +110,8 @@ async def list_templates(
 )
 async def apply_template(
     template_id: str,
-    overrides: Dict = None,
-    context: Dict = None,
+    overrides: dict = None,
+    context: dict = None,
 ) -> str:
     """Instantiate a template into a new campaign."""
     agent = context.get("agent") if context else None
diff --git a/gently/harness/plan_mode/tools/validation.py b/gently/harness/plan_mode/tools/validation.py
index 8e09802a..18e06ae6 100644
--- a/gently/harness/plan_mode/tools/validation.py
+++ b/gently/harness/plan_mode/tools/validation.py
@@ -5,11 +5,9 @@
 detector validity, missing controls, dependency cycles, and completeness.
 """
 
-import json
 import logging
-from typing import Dict, List, Optional, Set, Tuple
 
-from ...tools.registry import tool, ToolCategory, ToolExample
+from ...tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
 
@@ -22,7 +20,7 @@
     "num_slices": (10, 200),
     "exposure_ms": (5.0, 100.0),
     "laser_power_pct": (0.0, 100.0),
-    "interval_s": (10, None),       # minimum 10s, no hard max
+    "interval_s": (10, None),  # minimum 10s, no hard max
     "piezo_amplitude_um": (None, 200.0),  # max ±200 μm
 }
 
@@ -40,9 +38,9 @@
 
 # Temperature scaling factors (relative to 20°C)
 TEMP_SCALE = {
-    15.0: 24.0 / 14.0,   # ~1.71×  slower
+    15.0: 24.0 / 14.0,  # ~1.71×  slower
     20.0: 1.0,
-    25.0: 10.0 / 14.0,   # ~0.71×  faster
+    25.0: 10.0 / 14.0,  # ~0.71×  faster
 }
 
 CONTROL_KEYWORDS = {"control", "wildtype", "n2", "wt", "wild-type", "wild type"}
@@ -52,7 +50,8 @@
 # Helpers
 # ---------------------------------------------------------------------------
 
-def _get_temp_factor(temperature_c: Optional[float]) -> float:
+
+def _get_temp_factor(temperature_c: float | None) -> float:
     """Return scaling factor for developmental timing at given temperature."""
     if temperature_c is None:
         return 1.0
@@ -68,19 +67,19 @@ def _get_temp_factor(temperature_c: Optional[float]) -> float:
     return TEMP_SCALE[20.0] + frac * (TEMP_SCALE[25.0] - TEMP_SCALE[20.0])
 
 
-def _check_dependency_cycles(items) -> List[str]:
+def _check_dependency_cycles(items) -> list[str]:
     """DFS-based cycle detection on the dependency graph."""
     # Build adjacency list: item_id -> list of dependency IDs
-    adj: Dict[str, List[str]] = {}
-    id_to_title: Dict[str, str] = {}
+    adj: dict[str, list[str]] = {}
+    id_to_title: dict[str, str] = {}
     for item in items:
         adj[item.id] = list(item.depends_on)
         id_to_title[item.id] = item.title
 
     WHITE, GRAY, BLACK = 0, 1, 2
-    color: Dict[str, int] = {nid: WHITE for nid in adj}
-    cycles: List[str] = []
-    path: List[str] = []
+    color: dict[str, int] = {nid: WHITE for nid in adj}
+    cycles: list[str] = []
+    path: list[str] = []
 
     def dfs(node: str):
         if node not in color:
@@ -110,13 +109,16 @@ def dfs(node: str):
     return cycles
 
 
-def _stage_order(stage_name: str) -> Optional[int]:
+def _stage_order(stage_name: str) -> int | None:
     """Get ordinal position of a stage, or None if unrecognised."""
     from gently_perception.organism import CELEGANS
+
     stages = CELEGANS.stages
     aliases = {
-        "3fold": "pretzel", "threefold": "pretzel",
-        "1.5-fold": "1.5fold", "2-fold": "2fold",
+        "3fold": "pretzel",
+        "threefold": "pretzel",
+        "1.5-fold": "1.5fold",
+        "2-fold": "2fold",
     }
     normed = stage_name.lower().replace("-", "").replace(" ", "")
     name = aliases.get(normed, normed)
@@ -127,9 +129,10 @@ def _stage_order(stage_name: str) -> Optional[int]:
     return None
 
 
-def _normalise_stage(name: str) -> Optional[str]:
+def _normalise_stage(name: str) -> str | None:
     """Normalise a stage name to canonical form, or None."""
     from gently_perception.organism import CELEGANS
+
     stages = CELEGANS.stages
     low = name.lower().strip()
     for s in stages:
@@ -143,6 +146,7 @@ def _normalise_stage(name: str) -> Optional[str]:
 # Tool
 # ---------------------------------------------------------------------------
 
+
 @tool(
     name="validate_plan",
     description=(
@@ -161,7 +165,7 @@ def _normalise_stage(name: str) -> Optional[str]:
 )
 async def validate_plan(
     campaign_id: str,
-    context: Dict = None,
+    context: dict = None,
 ) -> str:
     """Validate a plan and return errors/warnings."""
     agent = context.get("agent") if context else None
@@ -178,14 +182,18 @@ async def validate_plan(
     if not items:
         return f"Campaign '{campaign.description}' has no plan items to validate."
 
-    errors: List[str] = []
-    warnings: List[str] = []
+    errors: list[str] = []
+    warnings: list[str] = []
 
     # Load detector presets for validation
     try:
         from gently.organisms import get_organism
+
         org = get_organism()
-        presets_mod = __import__(f"gently.organisms.{org.ORGANISM_NAME}.detector_presets", fromlist=["get_detector_presets"])
+        presets_mod = __import__(
+            f"gently.organisms.{org.ORGANISM_NAME}.detector_presets",
+            fromlist=["get_detector_presets"],
+        )
         valid_detectors = set(presets_mod.get_detector_presets().keys())
     except ImportError:
         valid_detectors = set()
@@ -199,16 +207,31 @@ async def validate_plan(
         label = f"[{item.type.value}] '{item.title}'"
 
         # Check for control mentions
-        text_blob = " ".join(filter(None, [
-            item.title, item.description, item.outcome,
-        ])).lower()
+        text_blob = " ".join(
+            filter(
+                None,
+                [
+                    item.title,
+                    item.description,
+                    item.outcome,
+                ],
+            )
+        ).lower()
         if item.imaging_spec:
-            text_blob += " " + " ".join(filter(None, [
-                item.imaging_spec.strain,
-                item.imaging_spec.genotype,
-                item.imaging_spec.reporter,
-                item.imaging_spec.success_criteria,
-            ])).lower()
+            text_blob += (
+                " "
+                + " ".join(
+                    filter(
+                        None,
+                        [
+                            item.imaging_spec.strain,
+                            item.imaging_spec.genotype,
+                            item.imaging_spec.reporter,
+                            item.imaging_spec.success_criteria,
+                        ],
+                    )
+                ).lower()
+            )
         if any(kw in text_blob for kw in CONTROL_KEYWORDS):
             has_control = True
 
@@ -221,13 +244,9 @@ async def validate_plan(
                 if val is None:
                     continue
                 if lo is not None and val < lo:
-                    errors.append(
-                        f"{label}: {field_name}={val} below minimum {lo}"
-                    )
+                    errors.append(f"{label}: {field_name}={val} below minimum {lo}")
                 if hi is not None and val > hi:
-                    errors.append(
-                        f"{label}: {field_name}={val} exceeds maximum {hi}"
-                    )
+                    errors.append(f"{label}: {field_name}={val} exceeds maximum {hi}")
 
             # Stage consistency
             if spec.start_stage and spec.stop_condition:
diff --git a/gently/harness/prompts/manager.py b/gently/harness/prompts/manager.py
index cde5db44..9552be76 100644
--- a/gently/harness/prompts/manager.py
+++ b/gently/harness/prompts/manager.py
@@ -9,13 +9,13 @@
 import json
 import logging
 from datetime import datetime
-from typing import Dict, List, Optional
 
 from gently.settings import settings
-from .templates import build_system_prompt, build_context_message
+
 from ..plan_mode.prompt import build_plan_prompt
 from ..resolution_mode.prompt import build_resolution_prompt
 from ..tools.registry import get_tool_registry
+from .templates import build_system_prompt
 
 logger = logging.getLogger(__name__)
 
@@ -33,21 +33,22 @@ def __init__(self, claude_client, model):
         self.model = model
 
         # Context summary caching
-        self._context_summary_cache: Optional[str] = None
-        self._context_summary_time: Optional[datetime] = None
+        self._context_summary_cache: str | None = None
+        self._context_summary_time: datetime | None = None
         self._context_summary_ttl: int = 300  # 5 minutes
 
         # Memory awareness caching
-        self._memory_awareness_cache: Optional[str] = None
-        self._memory_awareness_time: Optional[datetime] = None
+        self._memory_awareness_cache: str | None = None
+        self._memory_awareness_time: datetime | None = None
         self._memory_awareness_ttl: int = 600  # 10 minutes
 
         # Set by agent after construction
         self.context_store = None
         self.memory = None  # AgentMemory instance
 
-    def update_system_prompt(self, experiment, client, mode: str,
-                             context_summary: str = None, perceiver=None) -> str:
+    def update_system_prompt(
+        self, experiment, client, mode: str, context_summary: str = None, perceiver=None
+    ) -> str:
         """
         Rebuild system prompt with current experiment state and connection status.
 
@@ -86,14 +87,16 @@ def update_system_prompt(self, experiment, client, mode: str,
         # Execution mode
         if client:
             connection_status = {
-                'device_layer': client.is_connected,
-                'sam_detection': client.has_sam,
+                "device_layer": client.is_connected,
+                "sam_detection": client.has_sam,
             }
         else:
             connection_status = None
 
         return build_system_prompt(
-            experiment, connection_status, context_summary,
+            experiment,
+            connection_status,
+            context_summary,
             memory_awareness=memory_awareness,
             microscope=client,
             perceiver=perceiver,
@@ -143,18 +146,32 @@ def get_tools_for_mode(self, mode: str, has_microscope: bool) -> list:
             return [t for t in all_tools if t["name"] in resolution_tool_names]
         if mode == "plan":
             plan_tool_names = {
-                "create_campaign", "create_plan_item", "update_plan_item",
-                "link_plan_items", "propose_plan", "get_plan_status",
+                "create_campaign",
+                "create_plan_item",
+                "update_plan_item",
+                "link_plan_items",
+                "propose_plan",
+                "get_plan_status",
                 "get_plan_item",
-                "move_plan_item", "delete_plan_item", "reorder_plan_items",
-                "update_phase", "delete_phase",
+                "move_plan_item",
+                "delete_plan_item",
+                "reorder_plan_items",
+                "update_phase",
+                "delete_phase",
                 "export_plan",
-                "query_lab_history", "check_hardware_capability",
-                "search_literature", "search_strains",
+                "query_lab_history",
+                "check_hardware_capability",
+                "search_literature",
+                "search_strains",
                 "validate_plan",
-                "batch_update_status", "batch_update_spec",
-                "snapshot_plan", "list_plan_versions", "restore_plan_version",
-                "save_plan_template", "list_templates", "apply_template",
+                "batch_update_status",
+                "batch_update_spec",
+                "snapshot_plan",
+                "list_plan_versions",
+                "restore_plan_version",
+                "save_plan_template",
+                "list_templates",
+                "apply_template",
                 "ask_user_choice",
             }
             all_tools = registry.get_claude_schemas(has_microscope=False)
@@ -167,14 +184,16 @@ def get_cached_memory_awareness(self) -> str:
         if not self.memory:
             return ""
         now = datetime.now()
-        if (self._memory_awareness_cache is None or
-            self._memory_awareness_time is None or
-            (now - self._memory_awareness_time).total_seconds() > self._memory_awareness_ttl):
+        if (
+            self._memory_awareness_cache is None
+            or self._memory_awareness_time is None
+            or (now - self._memory_awareness_time).total_seconds() > self._memory_awareness_ttl
+        ):
             self._memory_awareness_cache = self.memory.get_awareness_summary()
             self._memory_awareness_time = now
         return self._memory_awareness_cache
 
-    def get_active_plan_summary(self) -> Optional[str]:
+    def get_active_plan_summary(self) -> str | None:
         """Get a summary of the active experimental plan, if any."""
         if not self.context_store:
             return None
@@ -192,13 +211,14 @@ def get_active_plan_summary(self) -> Optional[str]:
                     f" ({status['completed']}/{status['total']} items done)"
                 )
                 if status["next_actions"]:
-                    lines.append("  Next: " + ", ".join(
-                        a.title for a in status["next_actions"][:3]
-                    ))
+                    lines.append(
+                        "  Next: " + ", ".join(a.title for a in status["next_actions"][:3])
+                    )
                 if status["pending_decisions"]:
-                    lines.append("  Decisions pending: " + ", ".join(
-                        d.title for d in status["pending_decisions"]
-                    ))
+                    lines.append(
+                        "  Decisions pending: "
+                        + ", ".join(d.title for d in status["pending_decisions"])
+                    )
             return "\n".join(lines) if lines else None
         except Exception:
             return None
@@ -222,36 +242,36 @@ def gather_context_data(self, experiment, timelapse_orch, timeline_mgr) -> dict:
             Context data including timelapse status, events, and detections
         """
         data = {
-            'current_time': datetime.now().isoformat(),
-            'timelapse_status': None,
-            'recent_events': [],
-            'recent_detections': [],
-            'detection_reasoning': [],
+            "current_time": datetime.now().isoformat(),
+            "timelapse_status": None,
+            "recent_events": [],
+            "recent_detections": [],
+            "detection_reasoning": [],
         }
 
         if timelapse_orch:
             try:
                 status = timelapse_orch.get_status()
-                data['timelapse_status'] = {
-                    'state': status.status.value if status.status else 'unknown',
-                    'total_timepoints': status.total_timepoints or 0,
-                    'started_at': status.started_at.isoformat() if status.started_at else None,
-                    'embryo_count': len(status.embryos) if status.embryos else 0,
+                data["timelapse_status"] = {
+                    "state": status.status.value if status.status else "unknown",
+                    "total_timepoints": status.total_timepoints or 0,
+                    "started_at": status.started_at.isoformat() if status.started_at else None,
+                    "embryo_count": len(status.embryos) if status.embryos else 0,
                 }
             except Exception as e:
                 logger.debug(f"Could not get timelapse status: {e}")
 
         if timeline_mgr:
             try:
-                events = timeline_mgr.get_events(limit=20, session_id='current')
-                data['recent_events'] = [
+                events = timeline_mgr.get_events(limit=20, session_id="current")
+                data["recent_events"] = [
                     {
-                        'type': e.event_subtype,
-                        'time': e.timestamp.isoformat(),
-                        'embryo': e.embryo_id,
-                        'detector': e.detector_name,
-                        'timepoint': e.timepoint,
-                        'confidence': e.confidence,
+                        "type": e.event_subtype,
+                        "time": e.timestamp.isoformat(),
+                        "embryo": e.embryo_id,
+                        "detector": e.detector_name,
+                        "timepoint": e.timepoint,
+                        "confidence": e.confidence,
                     }
                     for e in events
                 ]
@@ -260,32 +280,35 @@ def gather_context_data(self, experiment, timelapse_orch, timeline_mgr) -> dict:
 
         try:
             for embryo_id, embryo_state in experiment.embryos.items():
-                if not hasattr(embryo_state, 'detection_results'):
+                if not hasattr(embryo_state, "detection_results"):
                     continue
                 for detector_name, results in embryo_state.detection_results.items():
                     recent_results = results[-3:] if len(results) > 3 else results
                     for r in recent_results:
-                        if r.get('detected'):
-                            data['recent_detections'].append({
-                                'detector': detector_name,
-                                'embryo': embryo_id,
-                                'timepoint': r.get('timepoint'),
-                                'confidence': r.get('confidence'),
-                            })
-                            if r.get('reasoning'):
-                                data['detection_reasoning'].append({
-                                    'detector': detector_name,
-                                    'embryo': embryo_id,
-                                    'timepoint': r.get('timepoint'),
-                                    'reasoning': r.get('reasoning')[:500],
-                                })
+                        if r.get("detected"):
+                            data["recent_detections"].append(
+                                {
+                                    "detector": detector_name,
+                                    "embryo": embryo_id,
+                                    "timepoint": r.get("timepoint"),
+                                    "confidence": r.get("confidence"),
+                                }
+                            )
+                            if r.get("reasoning"):
+                                data["detection_reasoning"].append(
+                                    {
+                                        "detector": detector_name,
+                                        "embryo": embryo_id,
+                                        "timepoint": r.get("timepoint"),
+                                        "reasoning": r.get("reasoning")[:500],
+                                    }
+                                )
         except Exception as e:
             logger.debug(f"Could not get detection results: {e}")
 
         return data
 
-    async def generate_context_summary(self, experiment, timelapse_orch,
-                                       timeline_mgr) -> str:
+    async def generate_context_summary(self, experiment, timelapse_orch, timeline_mgr) -> str:
         """
         Generate concise context summary using Haiku.
 
@@ -302,22 +325,23 @@ async def generate_context_summary(self, experiment, timelapse_orch,
         """
         raw_data = self.gather_context_data(experiment, timelapse_orch, timeline_mgr)
 
-        has_timelapse = raw_data['timelapse_status'] is not None
-        has_events = len(raw_data['recent_events']) > 0
-        has_detections = len(raw_data['recent_detections']) > 0
+        has_timelapse = raw_data["timelapse_status"] is not None
+        has_events = len(raw_data["recent_events"]) > 0
+        has_detections = len(raw_data["recent_detections"]) > 0
 
         if not (has_timelapse or has_events or has_detections):
             return ""
 
-        prompt = f"""Summarize the current microscopy session state in 2-3 sentences for another AI assistant.
-Focus on: timelapse status (is it running, completed, or idle?), time since last activity, and notable detections.
-Be factual and concise.
+        prompt = f"""Summarize the current microscopy session state in 2-3 sentences for
+another AI assistant. Focus on: timelapse status (is it running, completed, or idle?),
+time since last activity, and notable detections. Be factual and concise.
 
 Raw session data:
 {json.dumps(raw_data, indent=2, default=str)}
 
 Write a brief status summary. Examples:
-- "Timelapse completed 10h ago with 233 timepoints. Hatching was detected at timepoints 175-193 with HIGH confidence."
+- "Timelapse completed 10h ago with 233 timepoints. Hatching was detected at timepoints
+  175-193 with HIGH confidence."
 - "Timelapse is currently running for embryo_1 at timepoint 45. No detections yet."
 - "No active timelapse. Last session had 50 timepoints, with comma stage detected at t=30."
 """
@@ -327,15 +351,14 @@ async def generate_context_summary(self, experiment, timelapse_orch,
                 self.claude.messages.create,
                 model=settings.models.fast,
                 max_tokens=150,
-                messages=[{"role": "user", "content": prompt}]
+                messages=[{"role": "user", "content": prompt}],
             )
             return response.content[0].text.strip()
         except Exception as e:
             logger.warning(f"Failed to generate context summary: {e}")
             return ""
 
-    async def get_cached_context_summary(self, experiment, timelapse_orch,
-                                         timeline_mgr) -> str:
+    async def get_cached_context_summary(self, experiment, timelapse_orch, timeline_mgr) -> str:
         """
         Get context summary with caching (5-minute TTL).
 
@@ -351,9 +374,11 @@ async def get_cached_context_summary(self, experiment, timelapse_orch,
             Cached or newly generated context summary
         """
         now = datetime.now()
-        if (self._context_summary_cache is None or
-            self._context_summary_time is None or
-            (now - self._context_summary_time).total_seconds() > self._context_summary_ttl):
+        if (
+            self._context_summary_cache is None
+            or self._context_summary_time is None
+            or (now - self._context_summary_time).total_seconds() > self._context_summary_ttl
+        ):
             self._context_summary_cache = await self.generate_context_summary(
                 experiment, timelapse_orch, timeline_mgr
             )
@@ -384,6 +409,6 @@ def get_cached_system_prompt(self, system_prompt: str) -> list:
             {
                 "type": "text",
                 "text": system_prompt,
-                "cache_control": {"type": "ephemeral", "ttl": "1h"}
+                "cache_control": {"type": "ephemeral", "ttl": "1h"},
             }
         ]
diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index 61d06706..ef2fc3f4 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -2,17 +2,20 @@
 System prompts and context builders for the Microscopy Agent
 """
 
-from typing import Dict, List
-from ..state import ExperimentState
-from gently.organisms import get_organism
 from gently.hardware import get_hardware
+from gently.organisms import get_organism
 
+from ..state import ExperimentState
 
 # Interactive choice guidance
 USER_INTERACTION_GUIDELINES = """
 # Interactive User Choices — MANDATORY
 
-CRITICAL RULE: Whenever you need to ask the user a question — whether it's a yes/no confirmation, a choice between options, or any question where the answer could be one of several discrete responses — you MUST use the `ask_user_choice` tool. NEVER present options as numbered text lists or bullet points. NEVER ask the user to type their choice as text when you could present selectable options instead.
+CRITICAL RULE: Whenever you need to ask the user a question — whether it's a yes/no
+confirmation, a choice between options, or any question where the answer could be one of
+several discrete responses — you MUST use the `ask_user_choice` tool. NEVER present options
+as numbered text lists or bullet points. NEVER ask the user to type their choice as text when
+you could present selectable options instead.
 
 ## When to use ask_user_choice
 
@@ -45,14 +48,21 @@
 GOOD (always do this):
 Call the `ask_user_choice` tool. Example parameters:
   question: "What would you like to work on today?"
-  options: [{"id": "new", "label": "Start a new experiment"}, {"id": "resume", "label": "Resume a session"}]
+  options: [{"id": "new", "label": "Start a new experiment"},
+            {"id": "resume", "label": "Resume a session"}]
 
-The user interface renders these as an interactive picker with arrow-key navigation — much better UX than typing.
-Do NOT write tool calls as XML tags or code blocks in your text — always invoke tools through the tool mechanism.
+The user interface renders these as an interactive picker with arrow-key navigation — much
+better UX than typing.
+Do NOT write tool calls as XML tags or code blocks in your text — always invoke tools through
+the tool mechanism.
 
-IMPORTANT: This is not optional. ALWAYS use ask_user_choice when presenting choices or asking questions. The ONLY exception is when you need a completely free-form text response (like asking for a name or description).
+IMPORTANT: This is not optional. ALWAYS use ask_user_choice when presenting choices or asking
+questions. The ONLY exception is when you need a completely free-form text response (like
+asking for a name or description).
 
-Each option should be a specific, distinct choice. The picker automatically adds a free-text "Something else..." input at the bottom for custom responses, so your options can focus on the most likely concrete answers.
+Each option should be a specific, distinct choice. The picker automatically adds a free-text
+"Something else..." input at the bottom for custom responses, so your options can focus on
+the most likely concrete answers.
 """
 
 
@@ -192,7 +202,7 @@
 
 | User describes... | Mode to install |
 |---|---|
-| reporter expression, GFP/mCherry onset, "neurons lighting up", dopaminergic signal, anything where fluorescence turns on | `expression_monitoring` |
+| reporter onset: GFP/mCherry, dopaminergic signal, neurons lighting up | `expression_monitoring` |
 | hatching timing, pre-hatch dynamics, "track until they hatch" | `pre_terminal_monitoring` |
 | plain imaging, exploratory, no specific signal target | none (idle) |
 
@@ -222,7 +232,8 @@
 1. **Non-blocking operation**: The timelapse runs independently - you can still chat with the user
 2. **Per-embryo stop conditions**: Each embryo can stop at different times (e.g., when hatching)
 3. **Dynamic intervals**: Adjust imaging frequency per-embryo during the experiment
-4. **Detector integration**: Stop conditions triggered by visual detection (hatching, comma stage, etc.)
+4. **Detector integration**: Stop conditions triggered by visual detection
+   (hatching, comma stage, etc.)
 
 ## Stop Conditions
 
@@ -377,14 +388,16 @@ def build_system_prompt(
     str
         Complete system prompt
     """
-    embryo_summary = experiment_state.get_summary() if experiment_state.embryos else "No embryos loaded yet"
+    embryo_summary = (
+        experiment_state.get_summary() if experiment_state.embryos else "No embryos loaded yet"
+    )
 
     # Build connection status section
     if connection_status:
-        device_layer = "connected" if connection_status.get('device_layer') else "NOT CONNECTED"
-        sam = "available" if connection_status.get('sam_detection') else "not available"
+        device_layer = "connected" if connection_status.get("device_layer") else "NOT CONNECTED"
+        sam = "available" if connection_status.get("sam_detection") else "not available"
 
-        if not connection_status.get('device_layer'):
+        if not connection_status.get("device_layer"):
             connection_section = f"""# Hardware Connection Status
 
 ⚠️ **OFFLINE MODE** - Device layer is not connected.
@@ -392,7 +405,8 @@ def build_system_prompt(
 - Device Layer: {device_layer}
 - SAM Detection: {sam}
 
-**Important**: You cannot perform hardware operations (detect embryos, capture images, move stage, etc.)
+**Important**: You cannot perform hardware operations (detect embryos, capture images,
+move stage, etc.)
 without a connected device layer. If the user asks for hardware operations, inform them that
 the microscope is not connected and suggest they start the server or check the connection."""
         else:
@@ -436,13 +450,13 @@ def build_system_prompt(
     biology_knowledge = organism.BIOLOGY_KNOWLEDGE
 
     # Build stop conditions list from organism module
-    stop_condition_names = list(organism.STOP_CONDITIONS.keys())
-    detector_names = list(organism.get_detector_presets().keys())
+    list(organism.STOP_CONDITIONS.keys())
+    list(organism.get_detector_presets().keys())
 
     # Pull hardware description — prefer microscope (from device layer handshake),
     # fall back to the static hardware module
     hardware = get_hardware()
-    hardware_description = getattr(microscope, 'DESCRIPTION', '') or hardware.HARDWARE_DESCRIPTION
+    hardware_description = getattr(microscope, "DESCRIPTION", "") or hardware.HARDWARE_DESCRIPTION
     hardware_display = hardware.HARDWARE_DISPLAY_NAME
 
     return f"""You are Gently — an AI scientific collaborator running {hardware_display}
@@ -484,28 +498,40 @@ def build_system_prompt(
 
 Answer the user's request using relevant tools. Before calling a tool, do some analysis:
 1. Think about which of the provided tools is relevant to answer the user's request
-2. Go through each required parameter and determine if the user has provided or given enough information to infer a value
+2. Go through each required parameter and determine if the user has provided or given enough
+   information to infer a value
 3. If all required parameters are present or can be reasonably inferred, PROCEED WITH THE TOOL CALL
 4. If a required parameter is missing, ask the user to provide it
 5. DO NOT ask for more information on optional parameters if not provided - use defaults
 
 IMPORTANT: When you need information (status, positions, etc.), CALL THE TOOL IMMEDIATELY.
-Do NOT explain what you "would need to do" - just do it. Never say "I would need to query..." - just query it.
+Do NOT explain what you "would need to do" - just do it. Never say "I would need to
+query..." - just query it.
 
 # Behavior Guidelines
 
-1. **Act, then explain**: Call tools first, then explain results. Don't describe what you would do - do it.
-2. **Be scientifically accurate**: Base interpretations on actual developmental biology, not speculation
+1. **Act, then explain**: Call tools first, then explain results. Don't describe what you
+   would do - do it.
+2. **Be scientifically accurate**: Base interpretations on actual developmental biology,
+   not speculation
 3. **Prioritize sample health**: Always minimize photobleaching and photodamage
-4. **Respect embryo roles**: Every embryo line shows `[role=TEST]`, `[role=CALIBRATION]`, or `[role=UNASSIGNED]`. Calibrate / sweep / classify on CALIBRATION embryos; conserve photodose on TEST. Never suggest calibrating against a TEST embryo (see Embryo Roles section).
+4. **Respect embryo roles**: Every embryo line shows `[role=TEST]`, `[role=CALIBRATION]`,
+   or `[role=UNASSIGNED]`. Calibrate / sweep / classify on CALIBRATION embryos; conserve
+   photodose on TEST. Never suggest calibrating against a TEST embryo (see Embryo Roles
+   section).
 5. **Use proper terminology**: Refer to embryos by ID, nickname, or user label naturally
 6. **Track temporal context**: Remember what you've seen in recent images when analyzing new data
 6. **Generate safe plans**: Always validate parameters are within hardware limits
 7. **Be conversational**: You're a scientific colleague, not a robot
-8. **Stop after success**: When a tool returns a success message (starts with ✓), do NOT retry. Report success and wait for next request.
-9. **Single tool = complete action**: Tools like capture_lightsheet, view_image, and acquire_volume are COMPLETE actions. Do NOT chain them unless explicitly asked.
-10. **Use defaults**: If a tool has default parameters and the user doesn't specify values, use the defaults.
-11. **ALWAYS use ask_user_choice**: When asking the user ANY question with selectable answers, MUST use the `ask_user_choice` tool. NEVER list options as text. This is the #1 UX rule.
+8. **Stop after success**: When a tool returns a success message (starts with ✓), do NOT
+   retry. Report success and wait for next request.
+9. **Single tool = complete action**: Tools like capture_lightsheet, view_image, and
+   acquire_volume are COMPLETE actions. Do NOT chain them unless explicitly asked.
+10. **Use defaults**: If a tool has default parameters and the user doesn't specify values,
+    use the defaults.
+11. **ALWAYS use ask_user_choice**: When asking the user ANY question with selectable
+    answers, MUST use the `ask_user_choice` tool. NEVER list options as text. This is the
+    #1 UX rule.
 
 # Embryo Naming
 
@@ -521,7 +547,7 @@ def build_system_prompt(
 """
 
 
-def build_context_message(experiment_state: ExperimentState) -> Dict:
+def build_context_message(experiment_state: ExperimentState) -> dict:
     """
     Build context message with current experiment state
 
@@ -539,5 +565,7 @@ def build_context_message(experiment_state: ExperimentState) -> Dict:
     """
     return {
         "role": "user",
-        "content": f"[System update - current experiment state]\n\n{experiment_state.get_summary()}"
+        "content": (
+            f"[System update - current experiment state]\n\n{experiment_state.get_summary()}"
+        ),
     }
diff --git a/gently/harness/protocols.py b/gently/harness/protocols.py
index 9b8b29e9..eb2e811a 100644
--- a/gently/harness/protocols.py
+++ b/gently/harness/protocols.py
@@ -10,7 +10,7 @@
     from gently.harness.protocols import MicroscopeClientProtocol
 """
 
-from typing import Protocol, runtime_checkable, Dict, List, Set, Tuple, Optional
+from typing import Protocol, runtime_checkable
 
 
 @runtime_checkable
@@ -24,11 +24,11 @@ class OrganismProtocol(Protocol):
 
     ORGANISM_NAME: str
     ORGANISM_DISPLAY_NAME: str
-    SAMPLE_TERM: str              # "embryo", "cell", "organoid"
+    SAMPLE_TERM: str  # "embryo", "cell", "organoid"
     SAMPLE_TERM_PLURAL: str
     STAGES: list
     TERMINAL_STAGES: set
-    BIOLOGY_KNOWLEDGE: str        # Markdown text for LLM context
+    BIOLOGY_KNOWLEDGE: str  # Markdown text for LLM context
     PERCEPTION_SYSTEM_PROMPT: str
 
 
@@ -55,10 +55,10 @@ class HardwareProtocol(Protocol):
 
     HARDWARE_NAME: str
     HARDWARE_DISPLAY_NAME: str
-    HARDWARE_DESCRIPTION: str     # Markdown text for LLM context
-    CAPABILITIES: set             # Set of capability strings
+    HARDWARE_DESCRIPTION: str  # Markdown text for LLM context
+    CAPABILITIES: set  # Set of capability strings
 
 
 # Backward-compat alias — the Microscope base class in harness/microscope.py
 # replaces this Protocol. Import from there for new code.
-from .microscope import Microscope as MicroscopeClientProtocol  # noqa: F401
+from .microscope import Microscope as MicroscopeClientProtocol  # noqa: E402, F401
diff --git a/gently/harness/resolution_mode/prompt.py b/gently/harness/resolution_mode/prompt.py
index 6b3d0e5e..ad4ae321 100644
--- a/gently/harness/resolution_mode/prompt.py
+++ b/gently/harness/resolution_mode/prompt.py
@@ -13,11 +13,8 @@
 and call one of the resolution lifecycle tools to record it.
 """
 
-from typing import Optional
-
-from gently.organisms import get_organism
 from gently.hardware import get_hardware
-
+from gently.organisms import get_organism
 
 RESOLUTION_MODE_IDENTITY = """\
 You're in **session resolution** — figure out what the researcher
@@ -110,8 +107,8 @@
 
 
 def build_resolution_prompt(
-    context_summary: Optional[str] = None,
-    memory_awareness: Optional[str] = None,
+    context_summary: str | None = None,
+    memory_awareness: str | None = None,
 ) -> str:
     """
     Build the system prompt for resolution mode.
diff --git a/gently/harness/roles.py b/gently/harness/roles.py
index 8708f817..beaa59a4 100644
--- a/gently/harness/roles.py
+++ b/gently/harness/roles.py
@@ -20,7 +20,6 @@
 """
 
 from dataclasses import dataclass
-from typing import Dict, List, Optional
 
 
 @dataclass(frozen=True)
@@ -29,10 +28,11 @@ class EmbryoRole:
 
     Frozen so role definitions are immutable references after registry build.
     """
+
     name: str
     description: str
     default_cadence_seconds: float = 300.0
-    detector_name: Optional[str] = None
+    detector_name: str | None = None
     photodose_budget_multiplier: float = 1.0
     ui_color: str = "#888888"
     ui_icon: str = "circle"
@@ -43,10 +43,10 @@ class EmbryoRole:
     # drift back; once they're out of view they stay out, so they get
     # a short threshold. Test embryos can occasionally pop out and
     # back, so they get a longer one.
-    no_object_consecutive_terminal: Optional[int] = None
+    no_object_consecutive_terminal: int | None = None
 
 
-REGISTRY: Dict[str, EmbryoRole] = {
+REGISTRY: dict[str, EmbryoRole] = {
     "unassigned": EmbryoRole(
         name="unassigned",
         description="No role assigned yet — treated like 'test' for safety.",
@@ -94,10 +94,7 @@ class EmbryoRole:
 def get_role(name: str) -> EmbryoRole:
     """Look up a role by name. Raises KeyError with helpful message."""
     if name not in REGISTRY:
-        raise KeyError(
-            f"Unknown embryo role: {name!r}. "
-            f"Available: {sorted(REGISTRY.keys())}"
-        )
+        raise KeyError(f"Unknown embryo role: {name!r}. Available: {sorted(REGISTRY.keys())}")
     return REGISTRY[name]
 
 
@@ -105,6 +102,6 @@ def is_valid_role(name: str) -> bool:
     return name in REGISTRY
 
 
-def list_roles() -> List[str]:
+def list_roles() -> list[str]:
     """All registered role names, sorted."""
     return sorted(REGISTRY.keys())
diff --git a/gently/harness/session/interaction_logger.py b/gently/harness/session/interaction_logger.py
index 15c32ce1..1caa1e90 100644
--- a/gently/harness/session/interaction_logger.py
+++ b/gently/harness/session/interaction_logger.py
@@ -14,12 +14,12 @@
 """
 
 import json
+import logging
 import subprocess
-from dataclasses import dataclass, field, asdict
+from dataclasses import asdict, dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
-import logging
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -27,12 +27,13 @@
 @dataclass
 class ToolCallRecord:
     """Record of a single tool call"""
+
     tool_name: str
-    tool_input: Dict[str, Any]
+    tool_input: dict[str, Any]
     result: str
     duration_seconds: float
     is_error: bool = False
-    error_message: Optional[str] = None
+    error_message: str | None = None
 
 
 @dataclass
@@ -43,6 +44,7 @@ class InteractionRecord:
     An interaction is one user message and the agent's response,
     including any tool calls made during that response.
     """
+
     # Unique ID for this interaction
     interaction_id: str
 
@@ -51,44 +53,42 @@ class InteractionRecord:
     timestamp: datetime
 
     # System state snapshot at time of request
-    system_state: Dict[str, Any] = field(default_factory=dict)
+    system_state: dict[str, Any] = field(default_factory=dict)
 
     # What happened
-    tool_calls: List[ToolCallRecord] = field(default_factory=list)
+    tool_calls: list[ToolCallRecord] = field(default_factory=list)
     assistant_response: str = ""
     total_duration_seconds: float = 0.0
 
     # Errors
-    error: Optional[str] = None
-    error_traceback: Optional[str] = None
+    error: str | None = None
+    error_traceback: str | None = None
 
     # Correction detection (filled in after next turn)
     was_corrected: bool = False
-    correction_prompt: Optional[str] = None
-    correction_indicators: List[str] = field(default_factory=list)
+    correction_prompt: str | None = None
+    correction_indicators: list[str] = field(default_factory=list)
 
     # Metadata
     session_id: str = ""
     codebase_version: str = ""
     model: str = ""
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize to dictionary for JSON storage"""
         d = asdict(self)
         # Convert datetime to ISO format
-        d['timestamp'] = self.timestamp.isoformat()
+        d["timestamp"] = self.timestamp.isoformat()
         # Convert tool calls
-        d['tool_calls'] = [asdict(tc) for tc in self.tool_calls]
+        d["tool_calls"] = [asdict(tc) for tc in self.tool_calls]
         return d
 
     @classmethod
-    def from_dict(cls, d: Dict) -> 'InteractionRecord':
+    def from_dict(cls, d: dict) -> "InteractionRecord":
         """Deserialize from dictionary"""
         d = d.copy()
-        d['timestamp'] = datetime.fromisoformat(d['timestamp'])
-        d['tool_calls'] = [
-            ToolCallRecord(**tc) for tc in d.get('tool_calls', [])
-        ]
+        d["timestamp"] = datetime.fromisoformat(d["timestamp"])
+        d["tool_calls"] = [ToolCallRecord(**tc) for tc in d.get("tool_calls", [])]
         return cls(**d)
 
 
@@ -152,7 +152,7 @@ def __init__(
         self.log_file = self.logs_dir / f"{session_id}.jsonl"
 
         # In-memory buffer of recent interactions (for correction detection)
-        self._recent_interactions: List[InteractionRecord] = []
+        self._recent_interactions: list[InteractionRecord] = []
         self._max_recent = 10
 
         # Get codebase version (git commit)
@@ -171,7 +171,7 @@ def _get_git_version(self) -> str:
                 capture_output=True,
                 text=True,
                 cwd=str(self.storage_path.parent),
-                timeout=5
+                timeout=5,
             )
             if result.returncode == 0:
                 return result.stdout.strip()
@@ -182,7 +182,7 @@ def _get_git_version(self) -> str:
     def start_interaction(
         self,
         user_prompt: str,
-        system_state: Dict[str, Any],
+        system_state: dict[str, Any],
     ) -> InteractionRecord:
         """
         Start recording a new interaction
@@ -219,11 +219,11 @@ def record_tool_call(
         self,
         interaction: InteractionRecord,
         tool_name: str,
-        tool_input: Dict[str, Any],
+        tool_input: dict[str, Any],
         result: str,
         duration_seconds: float,
         is_error: bool = False,
-        error_message: Optional[str] = None,
+        error_message: str | None = None,
     ):
         """
         Record a tool call within an interaction
@@ -268,8 +268,8 @@ def complete_interaction(
         interaction: InteractionRecord,
         assistant_response: str,
         total_duration_seconds: float,
-        error: Optional[str] = None,
-        error_traceback: Optional[str] = None,
+        error: str | None = None,
+        error_traceback: str | None = None,
     ):
         """
         Complete and save an interaction record
@@ -342,17 +342,13 @@ def _detect_correction(self, current: InteractionRecord):
                 f"(indicators: {indicators_found})"
             )
 
-    def _save_interaction(
-        self,
-        interaction: InteractionRecord,
-        append: bool = True
-    ):
+    def _save_interaction(self, interaction: InteractionRecord, append: bool = True):
         """Save interaction to JSONL file"""
         try:
             if append:
                 # Append to log file
-                with open(self.log_file, 'a', encoding='utf-8') as f:
-                    f.write(json.dumps(interaction.to_dict()) + '\n')
+                with open(self.log_file, "a", encoding="utf-8") as f:
+                    f.write(json.dumps(interaction.to_dict()) + "\n")
             else:
                 # Need to update existing record - rewrite file
                 # This is less efficient but corrections are rare
@@ -368,7 +364,7 @@ def _rewrite_with_update(self, updated: InteractionRecord):
         # Read all interactions
         interactions = []
         try:
-            with open(self.log_file, 'r', encoding='utf-8') as f:
+            with open(self.log_file, encoding="utf-8") as f:
                 for line in f:
                     if line.strip():
                         record = InteractionRecord.from_dict(json.loads(line))
@@ -382,30 +378,30 @@ def _rewrite_with_update(self, updated: InteractionRecord):
 
         # Rewrite file
         try:
-            with open(self.log_file, 'w', encoding='utf-8') as f:
+            with open(self.log_file, "w", encoding="utf-8") as f:
                 for record in interactions:
-                    f.write(json.dumps(record.to_dict()) + '\n')
+                    f.write(json.dumps(record.to_dict()) + "\n")
         except Exception as e:
             logger.error(f"Failed to rewrite log file: {e}")
 
-    def _sanitize_state(self, state: Dict[str, Any]) -> Dict[str, Any]:
+    def _sanitize_state(self, state: dict[str, Any]) -> dict[str, Any]:
         """Remove large/sensitive data from state snapshot"""
         sanitized = {}
 
         # Keep summary info
-        if 'embryos' in state:
-            sanitized['embryo_count'] = len(state['embryos'])
-            sanitized['embryo_ids'] = list(state['embryos'].keys())
+        if "embryos" in state:
+            sanitized["embryo_count"] = len(state["embryos"])
+            sanitized["embryo_ids"] = list(state["embryos"].keys())
 
-        if 'detectors' in state:
-            sanitized['detector_count'] = len(state['detectors'])
+        if "detectors" in state:
+            sanitized["detector_count"] = len(state["detectors"])
 
-        if 'acquisition_status' in state:
-            sanitized['acquisition_status'] = state['acquisition_status']
+        if "acquisition_status" in state:
+            sanitized["acquisition_status"] = state["acquisition_status"]
 
         return sanitized
 
-    def _sanitize_tool_input(self, tool_input: Dict[str, Any]) -> Dict[str, Any]:
+    def _sanitize_tool_input(self, tool_input: dict[str, Any]) -> dict[str, Any]:
         """Remove large/binary data from tool input"""
         sanitized = {}
         for key, value in tool_input.items():
@@ -425,14 +421,14 @@ def _sanitize_tool_input(self, tool_input: Dict[str, Any]) -> Dict[str, Any]:
                 sanitized[key] = f"[{type(value).__name__}]"
         return sanitized
 
-    def get_session_stats(self) -> Dict[str, Any]:
+    def get_session_stats(self) -> dict[str, Any]:
         """Get statistics for current session"""
         if not self.log_file.exists():
             return {
-                'total_interactions': 0,
-                'corrections': 0,
-                'errors': 0,
-                'tool_calls': 0,
+                "total_interactions": 0,
+                "corrections": 0,
+                "errors": 0,
+                "tool_calls": 0,
             }
 
         total = 0
@@ -441,35 +437,35 @@ def get_session_stats(self) -> Dict[str, Any]:
         tool_calls = 0
 
         try:
-            with open(self.log_file, 'r', encoding='utf-8') as f:
+            with open(self.log_file, encoding="utf-8") as f:
                 for line in f:
                     if line.strip():
                         record = json.loads(line)
                         total += 1
-                        if record.get('was_corrected'):
+                        if record.get("was_corrected"):
                             corrections += 1
-                        if record.get('error'):
+                        if record.get("error"):
                             errors += 1
-                        tool_calls += len(record.get('tool_calls', []))
+                        tool_calls += len(record.get("tool_calls", []))
         except Exception:
             pass
 
         return {
-            'total_interactions': total,
-            'corrections': corrections,
-            'errors': errors,
-            'tool_calls': tool_calls,
-            'correction_rate': corrections / total if total > 0 else 0,
+            "total_interactions": total,
+            "corrections": corrections,
+            "errors": errors,
+            "tool_calls": tool_calls,
+            "correction_rate": corrections / total if total > 0 else 0,
         }
 
-    def load_session_interactions(self) -> List[InteractionRecord]:
+    def load_session_interactions(self) -> list[InteractionRecord]:
         """Load all interactions from current session"""
         if not self.log_file.exists():
             return []
 
         interactions = []
         try:
-            with open(self.log_file, 'r', encoding='utf-8') as f:
+            with open(self.log_file, encoding="utf-8") as f:
                 for line in f:
                     if line.strip():
                         record = InteractionRecord.from_dict(json.loads(line))
diff --git a/gently/harness/session/manager.py b/gently/harness/session/manager.py
index 47ea38d3..b8d12824 100644
--- a/gently/harness/session/manager.py
+++ b/gently/harness/session/manager.py
@@ -8,7 +8,6 @@
 import json
 import logging
 import uuid
-from typing import Dict, List, Optional
 
 logger = logging.getLogger(__name__)
 
@@ -24,7 +23,7 @@ class SessionManager:
     def __init__(self, store, storage_path):
         self.store = store
         self.storage_path = storage_path
-        self._session_id: Optional[str] = None
+        self._session_id: str | None = None
 
     @property
     def session_id(self) -> str:
@@ -74,31 +73,31 @@ def _resume_session(self, session_id: str, experiment):
         conversation_history = []
 
         if snapshot:
-            raw_history = snapshot.get('conversation_history', [])
+            raw_history = snapshot.get("conversation_history", [])
             conversation_history = self.sanitize_loaded_messages(raw_history)
 
-            experiment_data = snapshot.get('experiment_data', {})
-            experiment.active_plan_item_id = experiment_data.get('active_plan_item_id')
-            embryo_states = experiment_data.get('embryos', {})
+            experiment_data = snapshot.get("experiment_data", {})
+            experiment.active_plan_item_id = experiment_data.get("active_plan_item_id")
+            embryo_states = experiment_data.get("embryos", {})
 
             for embryo_id, embryo_data in embryo_states.items():
-                pos = embryo_data.get('stage_position', {})
+                pos = embryo_data.get("stage_position", {})
                 experiment.add_embryo(
                     embryo_id=embryo_id,
                     position=pos,
-                    calibration=embryo_data.get('calibration', {}),
-                    user_label=embryo_data.get('user_label'),
-                    uid=embryo_data.get('uid'),
+                    calibration=embryo_data.get("calibration", {}),
+                    user_label=embryo_data.get("user_label"),
+                    uid=embryo_data.get("uid"),
                 )
                 embryo = experiment.embryos[embryo_id]
-                embryo.nickname = embryo_data.get('nickname')
-                embryo.interval_seconds = embryo_data.get('interval_seconds')
-                embryo.num_slices = embryo_data.get('num_slices', 50)
-                embryo.exposure_ms = embryo_data.get('exposure_ms', 10.0)
-                embryo.priority = embryo_data.get('priority', 'normal')
-                embryo.timepoints_acquired = embryo_data.get('timepoints_acquired', 0)
-                embryo.should_skip = embryo_data.get('should_skip', False)
-                embryo.skip_reason = embryo_data.get('skip_reason')
+                embryo.nickname = embryo_data.get("nickname")
+                embryo.interval_seconds = embryo_data.get("interval_seconds")
+                embryo.num_slices = embryo_data.get("num_slices", 50)
+                embryo.exposure_ms = embryo_data.get("exposure_ms", 10.0)
+                embryo.priority = embryo_data.get("priority", "normal")
+                embryo.timepoints_acquired = embryo_data.get("timepoints_acquired", 0)
+                embryo.should_skip = embryo_data.get("should_skip", False)
+                embryo.skip_reason = embryo_data.get("skip_reason")
 
         # Also load embryos from store's embryo table. FileStore returns
         # position_coarse / position_fine (with legacy position_x / position_y
@@ -106,13 +105,13 @@ def _resume_session(self, session_id: str, experiment):
         # the resume.
         store_embryos = self.store.list_embryos(session_id)
         for e in store_embryos:
-            eid = e['embryo_id']
+            eid = e["embryo_id"]
             if eid not in experiment.embryos:
                 experiment.add_embryo(
                     embryo_id=eid,
-                    position=e.get('position_coarse') or {},
-                    position_fine=e.get('position_fine') or {},
-                    calibration=json.loads(e['calibration']) if e.get('calibration') else {},
+                    position=e.get("position_coarse") or {},
+                    position_fine=e.get("position_fine") or {},
+                    calibration=json.loads(e["calibration"]) if e.get("calibration") else {},
                 )
 
         self.store.touch_session(session_id)
@@ -141,11 +140,14 @@ def save_session(self, experiment, conversation_history, system_prompt) -> bool:
         if not self._session_id:
             return False
         try:
-            self.store.save_session_snapshot(self._session_id, {
-                'conversation_history': self.serialize_messages(conversation_history),
-                'experiment_data': experiment.to_dict(),
-                'system_prompt': system_prompt,
-            })
+            self.store.save_session_snapshot(
+                self._session_id,
+                {
+                    "conversation_history": self.serialize_messages(conversation_history),
+                    "experiment_data": experiment.to_dict(),
+                    "system_prompt": system_prompt,
+                },
+            )
             self._sync_embryos_to_db(experiment)
             self.store.touch_session(self._session_id)
             return True
@@ -158,11 +160,14 @@ def auto_save(self, experiment, conversation_history, system_prompt):
         if not self._session_id:
             return
         try:
-            self.store.save_session_snapshot(self._session_id, {
-                'conversation_history': self.serialize_messages(conversation_history),
-                'experiment_data': experiment.to_dict(),
-                'system_prompt': system_prompt,
-            })
+            self.store.save_session_snapshot(
+                self._session_id,
+                {
+                    "conversation_history": self.serialize_messages(conversation_history),
+                    "experiment_data": experiment.to_dict(),
+                    "system_prompt": system_prompt,
+                },
+            )
             self._sync_embryos_to_db(experiment)
             self.store.touch_session(self._session_id)
         except Exception:
@@ -173,15 +178,16 @@ def _sync_embryos_to_db(self, experiment):
         for embryo_id, embryo in experiment.embryos.items():
             pos = embryo.stage_position or {}
             self.store.register_embryo(
-                self._session_id, embryo_id,
-                embryo_uid=getattr(embryo, 'uid', None),
-                nickname=getattr(embryo, 'user_label', None),
-                position_x=pos.get('x'),
-                position_y=pos.get('y'),
+                self._session_id,
+                embryo_id,
+                embryo_uid=getattr(embryo, "uid", None),
+                nickname=getattr(embryo, "user_label", None),
+                position_x=pos.get("x"),
+                position_y=pos.get("y"),
                 calibration=embryo.calibration,
             )
 
-    def list_sessions(self) -> List[Dict]:
+    def list_sessions(self) -> list[dict]:
         """
         List available sessions from FileStore.
 
@@ -192,8 +198,9 @@ def list_sessions(self) -> List[Dict]:
         """
         return self.store.list_sessions()
 
-    def resume_session(self, session_id: str, experiment, conversation_mgr,
-                       prompt_mgr_update_fn) -> bool:
+    def resume_session(
+        self, session_id: str, experiment, conversation_mgr, prompt_mgr_update_fn
+    ) -> bool:
         """
         Resume a session (public interface for CLI).
 
@@ -234,7 +241,7 @@ def resume_session(self, session_id: str, experiment, conversation_mgr,
     # ===== Message Serialization =====
 
     @staticmethod
-    def sanitize_loaded_messages(messages: List[Dict]) -> List[Dict]:
+    def sanitize_loaded_messages(messages: list[dict]) -> list[dict]:
         """Fix conversation history loaded from JSON snapshots.
 
         Old snapshots may contain content blocks that were serialized
@@ -244,7 +251,7 @@ def sanitize_loaded_messages(messages: List[Dict]) -> List[Dict]:
         """
         clean = []
         for msg in messages:
-            content = msg.get('content')
+            content = msg.get("content")
             if content is None:
                 continue
             if isinstance(content, str):
@@ -256,16 +263,16 @@ def sanitize_loaded_messages(messages: List[Dict]) -> List[Dict]:
                     if isinstance(block, dict):
                         valid_blocks.append(block)
                     elif isinstance(block, str):
-                        if block.startswith(('TextBlock(', 'ToolUseBlock(')):
+                        if block.startswith(("TextBlock(", "ToolUseBlock(")):
                             continue
                         valid_blocks.append(block)
                 if valid_blocks:
-                    clean.append({**msg, 'content': valid_blocks})
+                    clean.append({**msg, "content": valid_blocks})
                 continue
         return clean
 
     @staticmethod
-    def serialize_messages(messages: List[Dict]) -> List[Dict]:
+    def serialize_messages(messages: list[dict]) -> list[dict]:
         """Convert conversation history to JSON-safe plain dicts.
 
         Anthropic SDK returns content blocks as objects (TextBlock,
@@ -273,30 +280,31 @@ def serialize_messages(messages: List[Dict]) -> List[Dict]:
         repr strings. This converts everything to plain dicts so the
         history round-trips cleanly through JSON.
         """
+
         def _block_to_dict(block):
             if isinstance(block, dict):
                 return block
             if isinstance(block, str):
                 return block
-            if hasattr(block, 'model_dump'):
+            if hasattr(block, "model_dump"):
                 return block.model_dump()
-            if hasattr(block, 'to_dict'):
+            if hasattr(block, "to_dict"):
                 return block.to_dict()
-            if hasattr(block, 'type'):
-                d = {'type': block.type}
-                if block.type == 'text' and hasattr(block, 'text'):
-                    d['text'] = block.text
-                elif block.type == 'tool_use':
-                    d['id'] = getattr(block, 'id', '')
-                    d['name'] = getattr(block, 'name', '')
-                    d['input'] = getattr(block, 'input', {})
+            if hasattr(block, "type"):
+                d = {"type": block.type}
+                if block.type == "text" and hasattr(block, "text"):
+                    d["text"] = block.text
+                elif block.type == "tool_use":
+                    d["id"] = getattr(block, "id", "")
+                    d["name"] = getattr(block, "name", "")
+                    d["input"] = getattr(block, "input", {})
                 return d
             return str(block)
 
         serialized = []
         for msg in messages:
-            content = msg.get('content')
+            content = msg.get("content")
             if isinstance(content, list):
                 content = [_block_to_dict(b) for b in content]
-            serialized.append({**msg, 'content': content})
+            serialized.append({**msg, "content": content})
         return serialized
diff --git a/gently/harness/session/timeline.py b/gently/harness/session/timeline.py
index 5d7ea6f0..b0ae7b92 100644
--- a/gently/harness/session/timeline.py
+++ b/gently/harness/session/timeline.py
@@ -11,12 +11,12 @@
 import json
 import logging
 import threading
-import uuid
 from collections import deque
-from dataclasses import dataclass, field, asdict
+from collections.abc import Callable
+from dataclasses import dataclass, field
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any
 
 from gently.core.event_bus import Event, EventType, get_event_bus
 
@@ -55,83 +55,84 @@ class TimelineEvent:
     severity : str
         Severity level: info | success | warning | error
     """
+
     event_id: str
     event_type: str
     event_subtype: str
     timestamp: datetime
     source: str
-    session_id: Optional[str] = None  # Session this event belongs to
-    embryo_id: Optional[str] = None
-    detector_name: Optional[str] = None
-    timepoint: Optional[int] = None
-    confidence: Optional[str] = None
-    data: Dict[str, Any] = field(default_factory=dict)
+    session_id: str | None = None  # Session this event belongs to
+    embryo_id: str | None = None
+    detector_name: str | None = None
+    timepoint: int | None = None
+    confidence: str | None = None
+    data: dict[str, Any] = field(default_factory=dict)
     icon: str = ">"
     severity: str = "info"
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         """Serialize to dictionary"""
         return {
-            'event_id': self.event_id,
-            'event_type': self.event_type,
-            'event_subtype': self.event_subtype,
-            'timestamp': self.timestamp.isoformat(),
-            'source': self.source,
-            'session_id': self.session_id,
-            'embryo_id': self.embryo_id,
-            'detector_name': self.detector_name,
-            'timepoint': self.timepoint,
-            'confidence': self.confidence,
-            'data': self.data,
-            'icon': self.icon,
-            'severity': self.severity,
+            "event_id": self.event_id,
+            "event_type": self.event_type,
+            "event_subtype": self.event_subtype,
+            "timestamp": self.timestamp.isoformat(),
+            "source": self.source,
+            "session_id": self.session_id,
+            "embryo_id": self.embryo_id,
+            "detector_name": self.detector_name,
+            "timepoint": self.timepoint,
+            "confidence": self.confidence,
+            "data": self.data,
+            "icon": self.icon,
+            "severity": self.severity,
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> 'TimelineEvent':
+    def from_dict(cls, d: dict[str, Any]) -> "TimelineEvent":
         """Deserialize from dictionary"""
         return cls(
-            event_id=d['event_id'],
-            event_type=d['event_type'],
-            event_subtype=d['event_subtype'],
-            timestamp=datetime.fromisoformat(d['timestamp']),
-            source=d.get('source', 'unknown'),
-            session_id=d.get('session_id'),
-            embryo_id=d.get('embryo_id'),
-            detector_name=d.get('detector_name'),
-            timepoint=d.get('timepoint'),
-            confidence=d.get('confidence'),
-            data=d.get('data', {}),
-            icon=d.get('icon', '>'),
-            severity=d.get('severity', 'info'),
+            event_id=d["event_id"],
+            event_type=d["event_type"],
+            event_subtype=d["event_subtype"],
+            timestamp=datetime.fromisoformat(d["timestamp"]),
+            source=d.get("source", "unknown"),
+            session_id=d.get("session_id"),
+            embryo_id=d.get("embryo_id"),
+            detector_name=d.get("detector_name"),
+            timepoint=d.get("timepoint"),
+            confidence=d.get("confidence"),
+            data=d.get("data", {}),
+            icon=d.get("icon", ">"),
+            severity=d.get("severity", "info"),
         )
 
     @property
     def short_label(self) -> str:
         """Short label for timeline display (e.g., 'TL', 'DET')"""
-        if self.event_type == 'timelapse':
-            return 'TL'
-        elif self.event_type == 'detection':
-            return 'DET'
+        if self.event_type == "timelapse":
+            return "TL"
+        elif self.event_type == "detection":
+            return "DET"
         else:
-            return 'SYS'
+            return "SYS"
 
     @property
     def description(self) -> str:
         """Human-readable description of the event"""
-        if self.event_type == 'timelapse':
-            if self.event_subtype == 'started':
-                embryos = self.data.get('embryo_ids', [])
+        if self.event_type == "timelapse":
+            if self.event_subtype == "started":
+                embryos = self.data.get("embryo_ids", [])
                 return f"Started timelapse with {len(embryos)} embryo(s)"
-            elif self.event_subtype == 'volume_acquired':
+            elif self.event_subtype == "volume_acquired":
                 return f"{self.embryo_id} @ t={self.timepoint}"
-            elif self.event_subtype == 'completed':
-                total = self.data.get('total_timepoints', '?')
+            elif self.event_subtype == "completed":
+                total = self.data.get("total_timepoints", "?")
                 return f"Completed ({total} timepoints)"
-            elif self.event_subtype == 'failed':
+            elif self.event_subtype == "failed":
                 return f"Failed: {self.data.get('error', 'unknown error')}"
-        elif self.event_type == 'detection':
-            detected = self.data.get('detected', False)
+        elif self.event_type == "detection":
+            detected = self.data.get("detected", False)
             status = "Detected" if detected else "Not detected"
             conf = f" ({self.confidence})" if self.confidence else ""
             return f"{self.detector_name} on {self.embryo_id} - {status}{conf}"
@@ -141,91 +142,91 @@ def description(self) -> str:
 # Mapping from EventBus EventType to TimelineEvent properties
 EVENT_MAPPING = {
     EventType.ACQUISITION_STARTED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'started',
-        'icon': '>',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "started",
+        "icon": ">",
+        "severity": "info",
     },
     EventType.VOLUME_ACQUIRED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'volume_acquired',
-        'icon': '+',
-        'severity': 'success',
+        "event_type": "timelapse",
+        "event_subtype": "volume_acquired",
+        "icon": "+",
+        "severity": "success",
     },
     EventType.ACQUISITION_COMPLETED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'completed',
-        'icon': '+',
-        'severity': 'success',
+        "event_type": "timelapse",
+        "event_subtype": "completed",
+        "icon": "+",
+        "severity": "success",
     },
     EventType.ACQUISITION_STOPPED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'stopped',
-        'icon': '-',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "stopped",
+        "icon": "-",
+        "severity": "info",
     },
     EventType.ACQUISITION_FAILED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'failed',
-        'icon': 'x',
-        'severity': 'error',
+        "event_type": "timelapse",
+        "event_subtype": "failed",
+        "icon": "x",
+        "severity": "error",
     },
     EventType.DETECTOR_EVALUATED: {
-        'event_type': 'detection',
-        'event_subtype': 'evaluated',
-        'icon': '?',
-        'severity': 'info',
+        "event_type": "detection",
+        "event_subtype": "evaluated",
+        "icon": "?",
+        "severity": "info",
     },
     EventType.DETECTION_TRIGGERED: {
-        'event_type': 'detection',
-        'event_subtype': 'triggered',
-        'icon': '!',
-        'severity': 'success',
+        "event_type": "detection",
+        "event_subtype": "triggered",
+        "icon": "!",
+        "severity": "success",
     },
     EventType.HATCHING_DETECTED: {
-        'event_type': 'detection',
-        'event_subtype': 'hatching',
-        'icon': '+',
-        'severity': 'success',
+        "event_type": "detection",
+        "event_subtype": "hatching",
+        "icon": "+",
+        "severity": "success",
     },
     # Strategy / experiment view persistence — these were already emitted on
     # the EventBus but weren't being captured to timeline.jsonl, so the
     # swimlane view had no event history to replay.
     EventType.EMBRYO_CADENCE_CHANGED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'cadence_changed',
-        'icon': '~',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "cadence_changed",
+        "icon": "~",
+        "severity": "info",
     },
     EventType.POWER_RAMP_STEP: {
-        'event_type': 'timelapse',
-        'event_subtype': 'power_changed',
-        'icon': '*',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "power_changed",
+        "icon": "*",
+        "severity": "info",
     },
     EventType.TRIGGER_FIRED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'trigger_fired',
-        'icon': '<>',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "trigger_fired",
+        "icon": "<>",
+        "severity": "info",
     },
     EventType.BURST_QUEUED: {
-        'event_type': 'timelapse',
-        'event_subtype': 'burst_queued',
-        'icon': 'q',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "burst_queued",
+        "icon": "q",
+        "severity": "info",
     },
     EventType.BURST_START: {
-        'event_type': 'timelapse',
-        'event_subtype': 'burst_started',
-        'icon': '^',
-        'severity': 'info',
+        "event_type": "timelapse",
+        "event_subtype": "burst_started",
+        "icon": "^",
+        "severity": "info",
     },
     EventType.BURST_COMPLETE: {
-        'event_type': 'timelapse',
-        'event_subtype': 'burst_completed',
-        'icon': 'v',
-        'severity': 'success',
+        "event_type": "timelapse",
+        "event_subtype": "burst_completed",
+        "icon": "v",
+        "severity": "success",
     },
 }
 
@@ -243,9 +244,9 @@ class TimelineManager:
 
     def __init__(
         self,
-        storage_path: Optional[Path] = None,
+        storage_path: Path | None = None,
         max_events: int = 1000,
-        session_id: Optional[str] = None,
+        session_id: str | None = None,
     ):
         """
         Parameters
@@ -262,7 +263,7 @@ def __init__(
         self._session_id = session_id
         self._events: deque[TimelineEvent] = deque(maxlen=max_events)
         self._lock = threading.RLock()
-        self._unsubscribers: List[Callable] = []
+        self._unsubscribers: list[Callable] = []
         self._started = False
 
         # Load existing events from storage
@@ -274,7 +275,7 @@ def set_session_id(self, session_id: str) -> None:
         self._session_id = session_id
 
     @property
-    def storage_file(self) -> Optional[Path]:
+    def storage_file(self) -> Path | None:
         """Path to the timeline JSONL file"""
         if self._storage_path:
             return self._storage_path / "timeline.jsonl"
@@ -317,18 +318,18 @@ def _on_event(self, event: Event) -> None:
 
         timeline_event = TimelineEvent(
             event_id=event.event_id,
-            event_type=mapping['event_type'],
-            event_subtype=mapping['event_subtype'],
+            event_type=mapping["event_type"],
+            event_subtype=mapping["event_subtype"],
             timestamp=event.timestamp,
             source=event.source,
             session_id=self._session_id,  # Tag with current session
-            embryo_id=data.get('embryo_id'),
-            detector_name=data.get('detector_name'),
-            timepoint=data.get('timepoint'),
-            confidence=data.get('confidence'),
+            embryo_id=data.get("embryo_id"),
+            detector_name=data.get("detector_name"),
+            timepoint=data.get("timepoint"),
+            confidence=data.get("confidence"),
             data=data,
-            icon=mapping['icon'],
-            severity=mapping['severity'],
+            icon=mapping["icon"],
+            severity=mapping["severity"],
         )
 
         self.add_event(timeline_event)
@@ -352,13 +353,13 @@ def add_event(self, event: TimelineEvent) -> None:
 
     def get_events(
         self,
-        event_type: Optional[str] = None,
-        embryo_id: Optional[str] = None,
-        since: Optional[datetime] = None,
-        until: Optional[datetime] = None,
-        session_id: Optional[str] = "current",
+        event_type: str | None = None,
+        embryo_id: str | None = None,
+        since: datetime | None = None,
+        until: datetime | None = None,
+        session_id: str | None = "current",
         limit: int = 50,
-    ) -> List[TimelineEvent]:
+    ) -> list[TimelineEvent]:
         """
         Get filtered events from timeline
 
@@ -405,7 +406,7 @@ def get_events(
         # Return limited, oldest first (chronological)
         return events[-limit:] if len(events) > limit else events
 
-    def get_time_range(self) -> tuple[Optional[datetime], Optional[datetime]]:
+    def get_time_range(self) -> tuple[datetime | None, datetime | None]:
         """
         Get the time range of events in the timeline
 
@@ -421,7 +422,7 @@ def get_time_range(self) -> tuple[Optional[datetime], Optional[datetime]]:
 
         return events[0].timestamp, events[-1].timestamp
 
-    def clear_events(self, before: Optional[datetime] = None) -> int:
+    def clear_events(self, before: datetime | None = None) -> int:
         """
         Clear events from timeline
 
@@ -443,7 +444,7 @@ def clear_events(self, before: Optional[datetime] = None) -> int:
                 old_count = len(self._events)
                 self._events = deque(
                     (e for e in self._events if e.timestamp >= before),
-                    maxlen=self._max_events
+                    maxlen=self._max_events,
                 )
                 count = old_count - len(self._events)
 
@@ -460,11 +461,11 @@ def _load_from_file(self) -> None:
             return
 
         try:
-            with open(self.storage_file, 'r', encoding='utf-8') as f:
+            with open(self.storage_file, encoding="utf-8") as f:
                 for line in f:
                     line = line.strip()
                     # Only parse lines that look like JSON objects
-                    if line and line.startswith('{'):
+                    if line and line.startswith("{"):
                         try:
                             data = json.loads(line)
                             event = TimelineEvent.from_dict(data)
@@ -484,8 +485,8 @@ def _persist_event(self, event: TimelineEvent) -> None:
             # Ensure directory exists
             self._storage_path.mkdir(parents=True, exist_ok=True)
 
-            with open(self.storage_file, 'a', encoding='utf-8') as f:
-                f.write(json.dumps(event.to_dict()) + '\n')
+            with open(self.storage_file, "a", encoding="utf-8") as f:
+                f.write(json.dumps(event.to_dict()) + "\n")
         except Exception as e:
             logger.error(f"Error persisting timeline event: {e}")
 
@@ -500,9 +501,9 @@ def _rewrite_storage(self) -> None:
             with self._lock:
                 events = list(self._events)
 
-            with open(self.storage_file, 'w', encoding='utf-8') as f:
+            with open(self.storage_file, "w", encoding="utf-8") as f:
                 for event in events:
-                    f.write(json.dumps(event.to_dict()) + '\n')
+                    f.write(json.dumps(event.to_dict()) + "\n")
         except Exception as e:
             logger.error(f"Error rewriting timeline storage: {e}")
 
@@ -512,7 +513,7 @@ def __len__(self) -> int:
             return len(self._events)
 
 
-def parse_time_delta(s: str) -> Optional[timedelta]:
+def parse_time_delta(s: str) -> timedelta | None:
     """
     Parse a time delta string like "1h", "30m", "2d"
 
@@ -531,13 +532,13 @@ def parse_time_delta(s: str) -> Optional[timedelta]:
         return None
 
     try:
-        if s.endswith('m'):
+        if s.endswith("m"):
             return timedelta(minutes=int(s[:-1]))
-        elif s.endswith('h'):
+        elif s.endswith("h"):
             return timedelta(hours=int(s[:-1]))
-        elif s.endswith('d'):
+        elif s.endswith("d"):
             return timedelta(days=int(s[:-1]))
-        elif s.endswith('w'):
+        elif s.endswith("w"):
             return timedelta(weeks=int(s[:-1]))
         else:
             # Try parsing as minutes
diff --git a/gently/harness/state.py b/gently/harness/state.py
index a52f7b79..e5b275ab 100644
--- a/gently/harness/state.py
+++ b/gently/harness/state.py
@@ -27,19 +27,20 @@
 
 import logging
 import re
+from collections.abc import Callable
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Callable, Dict, List, Optional, Tuple
-from pathlib import Path
-import numpy as np
+from typing import Any
 
-logger = logging.getLogger(__name__)
+import numpy as np
 
 # Re-export CalibrationPrior from its hardware-specific home for backward compat.
 # CalibrationPrior is diSPIM-specific (piezo-galvo linear fit). Other hardware
 # modules will define their own calibration models.
 from gently.hardware.dispim.calibration import CalibrationPrior
 
+logger = logging.getLogger(__name__)
+
 
 @dataclass
 class FocusDataPoint:
@@ -59,13 +60,14 @@ class FocusDataPoint:
     - z: primary focus axis (µm) — piezo for diSPIM, Z-motor for 2P/confocal
     - secondary_axis: optional second axis — galvo for diSPIM, unused (0.0) for single-axis systems
     """
-    z: float               # Primary focus position (µm)
+
+    z: float  # Primary focus position (µm)
     secondary_axis: float  # Secondary axis position (galvo deg for diSPIM, 0.0 otherwise)
-    score: float           # Focus quality score (algorithm-dependent)
-    r_squared: float       # Gaussian fit quality (0-1), higher = more reliable
-    timestamp: datetime    # When this measurement was made
-    method: str            # 'calibration', 'fine_focus', 'manual'
-    algorithm: str = 'fft_bandpass'  # Focus algorithm used
+    score: float  # Focus quality score (algorithm-dependent)
+    r_squared: float  # Gaussian fit quality (0-1), higher = more reliable
+    timestamp: datetime  # When this measurement was made
+    method: str  # 'calibration', 'fine_focus', 'manual'
+    algorithm: str = "fft_bandpass"  # Focus algorithm used
 
     # Backward-compatible properties for code that uses the old field names
     @property
@@ -76,38 +78,39 @@ def piezo(self) -> float:
     def galvo(self) -> float:
         return self.secondary_axis
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize for JSON storage"""
         return {
-            'z': self.z,
-            'secondary_axis': self.secondary_axis,
-            'score': self.score,
-            'r_squared': self.r_squared,
-            'timestamp': self.timestamp.isoformat(),
-            'method': self.method,
-            'algorithm': self.algorithm,
+            "z": self.z,
+            "secondary_axis": self.secondary_axis,
+            "score": self.score,
+            "r_squared": self.r_squared,
+            "timestamp": self.timestamp.isoformat(),
+            "method": self.method,
+            "algorithm": self.algorithm,
             # Backward-compatible keys for existing serialized data
-            'galvo': self.secondary_axis,
-            'piezo': self.z,
+            "galvo": self.secondary_axis,
+            "piezo": self.z,
         }
 
     @classmethod
-    def from_dict(cls, data: Dict) -> 'FocusDataPoint':
+    def from_dict(cls, data: dict) -> "FocusDataPoint":
         """Deserialize from JSON. Handles both old (galvo/piezo) and new (z/secondary_axis) keys."""
         return cls(
-            z=data.get('z', data.get('piezo', 0.0)),
-            secondary_axis=data.get('secondary_axis', data.get('galvo', 0.0)),
-            score=data['score'],
-            r_squared=data['r_squared'],
-            timestamp=datetime.fromisoformat(data['timestamp']),
-            method=data['method'],
-            algorithm=data.get('algorithm', 'fft_bandpass'),
+            z=data.get("z", data.get("piezo", 0.0)),
+            secondary_axis=data.get("secondary_axis", data.get("galvo", 0.0)),
+            score=data["score"],
+            r_squared=data["r_squared"],
+            timestamp=datetime.fromisoformat(data["timestamp"]),
+            method=data["method"],
+            algorithm=data.get("algorithm", "fft_bandpass"),
         )
 
 
 @dataclass
 class ImageRecord:
     """Record of a single acquired image/volume"""
+
     embryo_id: str
     timepoint: int
     timestamp: datetime
@@ -115,8 +118,8 @@ class ImageRecord:
     max_projection_b64: str  # Base64-encoded JPEG for Claude Vision
     size_kb: float
     # UID-based data references (new data layer)
-    volume_uid: Optional[str] = None  # UID for volume in DataStore
-    projection_uid: Optional[str] = None  # UID for max projection in DataStore
+    volume_uid: str | None = None  # UID for volume in DataStore
+    projection_uid: str | None = None  # UID for max projection in DataStore
 
 
 @dataclass
@@ -125,9 +128,9 @@ class EmbryoState:
 
     # Identity
     id: str  # "embryo_1"
-    uid: Optional[str] = None  # Global unique identifier for cross-session tracking
-    nickname: Optional[str] = None  # Agent-assigned: "the fast one"
-    user_label: Optional[str] = None  # User-provided: "control_1"
+    uid: str | None = None  # Global unique identifier for cross-session tracking
+    nickname: str | None = None  # Agent-assigned: "the fast one"
+    user_label: str | None = None  # User-provided: "control_1"
     # Role key into gently.harness.roles.REGISTRY. Drives cadence policy,
     # detector selection, photodose budget, UI presentation. Default "test"
     # is the safe choice — accidental Calibration→Test only over-protects;
@@ -139,13 +142,13 @@ class EmbryoState:
     # later by SPIM-objective alignment). Resolved value is exposed by the
     # `stage_position` property so downstream motion/perception can stay
     # agnostic about which stage we're in.
-    position_coarse: Dict[str, float] = field(default_factory=dict)  # {'x': ..., 'y': ...}
-    position_fine: Dict[str, float] = field(default_factory=dict)    # empty until SPIM head alignment
-    calibration: Dict = field(default_factory=dict)  # Galvo/piezo parameters
+    position_coarse: dict[str, float] = field(default_factory=dict)  # {'x': ..., 'y': ...}
+    position_fine: dict[str, float] = field(default_factory=dict)  # empty until SPIM head alignment
+    calibration: dict = field(default_factory=dict)  # Galvo/piezo parameters
     detection_confidence: float = 0.0  # SAM/detection confidence score (0-1)
 
     # Acquisition Parameters (current)
-    interval_seconds: Optional[float] = None  # Per-embryo interval; None = use timelapse default
+    interval_seconds: float | None = None  # Per-embryo interval; None = use timelapse default
     num_slices: int = 50
     exposure_ms: float = 10.0
     priority: str = "normal"  # high/normal/low
@@ -153,13 +156,13 @@ class EmbryoState:
     # Per-embryo 488 laser power %. None = use device-layer default (no
     # change at acquire time). Float values are hard-limited at the device
     # layer by DiSPIMLightSource.POWER_LIMITS_PCT[488] (default 2-6%).
-    laser_power_488_pct: Optional[float] = None
+    laser_power_488_pct: float | None = None
 
     # Status
-    last_imaged: Optional[datetime] = None
+    last_imaged: datetime | None = None
     timepoints_acquired: int = 0
     should_skip: bool = False
-    skip_reason: Optional[str] = None
+    skip_reason: str | None = None
 
     # Timelapse runtime state (consolidated from former EmbryoAcquisitionState).
     # Populated/used by TimelapseOrchestrator while this embryo is part of an
@@ -169,12 +172,12 @@ class EmbryoState:
     # is a Phase 9 concern.
     stop_condition: Any = None
     is_complete: bool = False
-    completion_reason: Optional[str] = None
+    completion_reason: str | None = None
     error_count: int = 0
-    last_error: Optional[str] = None
-    detection_triggered_at: Optional[int] = None
-    detection_type: Optional[str] = None
-    no_object_since_timepoint: Optional[int] = None
+    last_error: str | None = None
+    detection_triggered_at: int | None = None
+    detection_type: str | None = None
+    no_object_since_timepoint: int | None = None
     # Count of consecutive "no_object" detections. Reset to 0 whenever
     # the embryo is detected again. When this crosses the role's
     # ``no_object_consecutive_terminal`` threshold, the orchestrator
@@ -192,58 +195,65 @@ class EmbryoState:
     #     - paused: skip in the due loop (over-budget, manually paused, or
     #               idle during another embryo's burst)
     cadence_phase: str = "normal"
-    next_due_at: Optional[datetime] = None
+    next_due_at: datetime | None = None
 
     # Light exposure tracking (for phototoxicity monitoring)
     exposure_count: int = 0  # Number of imaging events (snaps + volumes)
     total_exposure_ms: float = 0.0  # Cumulative laser-on time in milliseconds
 
     # Analysis Results (cached)
-    hatching_status: Dict = field(default_factory=dict)
+    hatching_status: dict = field(default_factory=dict)
     # {hatched: bool, confidence: str, timepoint: int}
 
-    morphology_history: List[Dict] = field(default_factory=list)
+    morphology_history: list[dict] = field(default_factory=list)
     # [{timepoint, size, shape, activity_score}]
 
-    fluorescence_history: List[Dict] = field(default_factory=list)
+    fluorescence_history: list[dict] = field(default_factory=list)
     # [{timepoint, mean_intensity, photobleaching_estimate}]
 
-    custom_classifications: Dict = field(default_factory=dict)
+    custom_classifications: dict = field(default_factory=dict)
     # User-defined: {"first_cleavage": {detected: bool, timepoint: 42}}
 
     # Verification round tracking (for consecutive confirmation)
     pending_verification: bool = False  # True when detection fired, awaiting verification
     consecutive_detection_count: int = 0  # Must reach 5 consecutive verified detections to stop
-    last_detection_round: Optional[int] = None  # Round when detection was last verified
+    last_detection_round: int | None = None  # Round when detection was last verified
 
     # Detection results from detector system
-    detection_results: Dict[str, List[Dict]] = field(default_factory=dict)
+    detection_results: dict[str, list[dict]] = field(default_factory=dict)
     # detector_name -> list of detection results
     # e.g., {"comma_stage": [{"timepoint": 120, "detected": False, "confidence": "HIGH"}, ...]}
 
     # CV Subagent analysis results (populated from CV_RESULT_READY events)
-    cv_analyses: Dict[str, List[Dict]] = field(default_factory=dict)
+    cv_analyses: dict[str, list[dict]] = field(default_factory=dict)
     # result_type -> list of results by timepoint
     # e.g., {"nuclei_count": [{"timepoint": 5, "num_nuclei": 66, ...}]}
 
     # Quick-access fields for latest CV results (for /embryos display)
-    latest_nuclei_count: Optional[int] = None
-    latest_developmental_stage: Optional[str] = None
-    latest_elongation_ratio: Optional[float] = None
+    latest_nuclei_count: int | None = None
+    latest_developmental_stage: str | None = None
+    latest_elongation_ratio: float | None = None
 
     # Images (recent for context)
-    recent_images: List[ImageRecord] = field(default_factory=list)
+    recent_images: list[ImageRecord] = field(default_factory=list)
     # Keep last 10 for temporal context in Claude Vision calls
 
     # Focus history - accumulated piezo-galvo measurements over time
-    focus_history: List[FocusDataPoint] = field(default_factory=list)
+    focus_history: list[FocusDataPoint] = field(default_factory=list)
     # Each focus operation adds a datapoint, building a focus map for this embryo
 
-    def add_focus_datapoint(self, z: float = None, secondary_axis: float = 0.0,
-                            score: float = 0.0, r_squared: float = 0.0,
-                            method: str = 'manual', algorithm: str = 'fft_bandpass',
-                            # Backward-compatible kwargs
-                            galvo: float = None, piezo: float = None):
+    def add_focus_datapoint(
+        self,
+        z: float = None,
+        secondary_axis: float = 0.0,
+        score: float = 0.0,
+        r_squared: float = 0.0,
+        method: str = "manual",
+        algorithm: str = "fft_bandpass",
+        # Backward-compatible kwargs
+        galvo: float = None,
+        piezo: float = None,
+    ):
         """
         Record a focus measurement for this embryo.
 
@@ -276,19 +286,24 @@ def add_focus_datapoint(self, z: float = None, secondary_axis: float = 0.0,
         if galvo is not None:
             secondary_axis = galvo
 
-        self.focus_history.append(FocusDataPoint(
-            z=z,
-            secondary_axis=secondary_axis,
-            score=score,
-            r_squared=r_squared,
-            timestamp=datetime.now(),
-            method=method,
-            algorithm=algorithm,
-        ))
-
-    def get_focus_at_secondary(self, secondary_position: float,
-                               max_age_hours: Optional[float] = None,
-                               min_r_squared: float = 0.5) -> Optional[float]:
+        self.focus_history.append(
+            FocusDataPoint(
+                z=z,
+                secondary_axis=secondary_axis,
+                score=score,
+                r_squared=r_squared,
+                timestamp=datetime.now(),
+                method=method,
+                algorithm=algorithm,
+            )
+        )
+
+    def get_focus_at_secondary(
+        self,
+        secondary_position: float,
+        max_age_hours: float | None = None,
+        min_r_squared: float = 0.5,
+    ) -> float | None:
         """
         Get the best Z position for a given secondary axis position.
 
@@ -334,35 +349,38 @@ def get_focus_at_secondary(self, secondary_position: float,
             axis_distance = abs(fp.secondary_axis - secondary_position)
             age_hours = (now - fp.timestamp).total_seconds() / 3600
 
-            candidates.append({
-                'z': fp.z,
-                'axis_distance': axis_distance,
-                'age_hours': age_hours,
-                'r_squared': fp.r_squared,
-            })
+            candidates.append(
+                {
+                    "z": fp.z,
+                    "axis_distance": axis_distance,
+                    "age_hours": age_hours,
+                    "r_squared": fp.r_squared,
+                }
+            )
 
         if not candidates:
             return None
 
         # If we have exact matches, use the most recent
-        exact_matches = [c for c in candidates if c['axis_distance'] < 0.01]
+        exact_matches = [c for c in candidates if c["axis_distance"] < 0.01]
         if exact_matches:
             # Sort by recency, return most recent
-            exact_matches.sort(key=lambda x: x['age_hours'])
-            return exact_matches[0]['z']
+            exact_matches.sort(key=lambda x: x["age_hours"])
+            return exact_matches[0]["z"]
 
         # Otherwise, interpolate from nearby measurements
         # Sort by axis distance
-        candidates.sort(key=lambda x: x['axis_distance'])
-        return candidates[0]['z']  # Return closest match
+        candidates.sort(key=lambda x: x["axis_distance"])
+        return candidates[0]["z"]  # Return closest match
 
     # Backward-compatible alias
-    def get_focus_at_galvo(self, galvo_position: float, **kwargs) -> Optional[float]:
+    def get_focus_at_galvo(self, galvo_position: float, **kwargs) -> float | None:
         """Backward-compatible alias for get_focus_at_secondary."""
         return self.get_focus_at_secondary(galvo_position, **kwargs)
 
-    def get_z_axis_fit(self, max_age_hours: Optional[float] = None,
-                       min_r_squared: float = 0.5) -> Optional[Tuple[float, float]]:
+    def get_z_axis_fit(
+        self, max_age_hours: float | None = None, min_r_squared: float = 0.5
+    ) -> tuple[float, float] | None:
         """
         Fit a linear relationship between Z and secondary axis from accumulated data.
 
@@ -415,13 +433,16 @@ def get_z_axis_fit(self, max_age_hours: Optional[float] = None,
             return None
 
     # Backward-compatible alias
-    def get_piezo_galvo_fit(self, **kwargs) -> Optional[Tuple[float, float]]:
+    def get_piezo_galvo_fit(self, **kwargs) -> tuple[float, float] | None:
         """Backward-compatible alias for get_z_axis_fit."""
         return self.get_z_axis_fit(**kwargs)
 
-    def get_focus_drift_rate(self, secondary_position: float = 0.0,
-                             galvo_position: float = None,
-                             min_measurements: int = 3) -> Optional[float]:
+    def get_focus_drift_rate(
+        self,
+        secondary_position: float = 0.0,
+        galvo_position: float = None,
+        min_measurements: int = 3,
+    ) -> float | None:
         """
         Calculate how fast focus is drifting (µm/hour) at a given secondary axis position.
 
@@ -442,8 +463,11 @@ def get_focus_drift_rate(self, secondary_position: float = 0.0,
         if galvo_position is not None:
             secondary_position = galvo_position
         # Get measurements at similar secondary axis position
-        relevant = [fp for fp in self.focus_history
-                    if abs(fp.secondary_axis - secondary_position) < 0.1 and fp.r_squared >= 0.5]
+        relevant = [
+            fp
+            for fp in self.focus_history
+            if abs(fp.secondary_axis - secondary_position) < 0.1 and fp.r_squared >= 0.5
+        ]
 
         if len(relevant) < min_measurements:
             return None
@@ -470,9 +494,12 @@ def get_focus_drift_rate(self, secondary_position: float = 0.0,
         except Exception:
             return None
 
-    def needs_refocus(self, max_age_minutes: float = 60,
-                      secondary_position: float = 0.0,
-                      galvo_position: float = None) -> bool:
+    def needs_refocus(
+        self,
+        max_age_minutes: float = 60,
+        secondary_position: float = 0.0,
+        galvo_position: float = None,
+    ) -> bool:
         """
         Determine if this embryo needs focus re-measurement.
 
@@ -523,7 +550,8 @@ def get_focus_summary(self) -> str:
 
         lines = [
             f"Focus history: {n_points} measurements over {span_hours:.1f} hours",
-            f"Latest: z={last.z:.2f}µm @ secondary={last.secondary_axis:.2f} (R²={last.r_squared:.3f})",
+            f"Latest: z={last.z:.2f}µm @ secondary={last.secondary_axis:.2f}"
+            f" (R²={last.r_squared:.3f})",
         ]
 
         if drift is not None:
@@ -536,7 +564,7 @@ def get_focus_summary(self) -> str:
 
         return "\n".join(lines)
 
-    def add_detection_result(self, detector_name: str, result: Dict):
+    def add_detection_result(self, detector_name: str, result: dict):
         """
         Add detection result from detector system
 
@@ -552,7 +580,7 @@ def add_detection_result(self, detector_name: str, result: Dict):
 
         self.detection_results[detector_name].append(result)
 
-    def get_latest_detection(self, detector_name: str) -> Optional[Dict]:
+    def get_latest_detection(self, detector_name: str) -> dict | None:
         """Get most recent detection result for a detector"""
         if detector_name not in self.detection_results:
             return None
@@ -581,15 +609,15 @@ def was_detected(self, detector_name: str, require_verified: bool = False) -> bo
             return False
 
         for result in self.detection_results[detector_name]:
-            if result.get('detected', False):
+            if result.get("detected", False):
                 if require_verified:
-                    if result.get('verified', False):
+                    if result.get("verified", False):
                         return True
                 else:
                     return True
         return False
 
-    def mark_detection_verified(self, detector_name: str, timepoint: Optional[int] = None) -> bool:
+    def mark_detection_verified(self, detector_name: str, timepoint: int | None = None) -> bool:
         """
         Mark a detection result as verified by the challenger system.
 
@@ -616,19 +644,19 @@ def mark_detection_verified(self, detector_name: str, timepoint: Optional[int] =
         if timepoint is not None:
             # Find by timepoint
             for result in results:
-                if result.get('timepoint') == timepoint and result.get('detected', False):
-                    result['verified'] = True
+                if result.get("timepoint") == timepoint and result.get("detected", False):
+                    result["verified"] = True
                     return True
         else:
             # Mark the most recent detected result
             for result in reversed(results):
-                if result.get('detected', False):
-                    result['verified'] = True
+                if result.get("detected", False):
+                    result["verified"] = True
                     return True
 
         return False
 
-    def add_cv_result(self, result_type: str, result: Dict):
+    def add_cv_result(self, result_type: str, result: dict):
         """
         Add CV analysis result from CV subagent.
 
@@ -643,8 +671,8 @@ def add_cv_result(self, result_type: str, result: Dict):
             self.cv_analyses[result_type] = []
 
         # Add timestamp if not present
-        if 'timestamp' not in result:
-            result['timestamp'] = datetime.now().isoformat()
+        if "timestamp" not in result:
+            result["timestamp"] = datetime.now().isoformat()
 
         self.cv_analyses[result_type].append(result)
 
@@ -656,11 +684,7 @@ def add_cv_result(self, result_type: str, result: Dict):
         elif result_type == "elongation" and "elongation_ratio" in result:
             self.latest_elongation_ratio = result["elongation_ratio"]
 
-    def get_cv_result(
-        self,
-        result_type: str,
-        timepoint: Optional[int] = None
-    ) -> Optional[Dict]:
+    def get_cv_result(self, result_type: str, timepoint: int | None = None) -> dict | None:
         """
         Get CV analysis result, optionally filtered by timepoint.
 
@@ -691,7 +715,7 @@ def get_cv_result(
         # Return most recent
         return results[-1]
 
-    def get_cv_summary(self) -> Dict:
+    def get_cv_summary(self) -> dict:
         """
         Get summary of CV analysis results for display.
 
@@ -705,27 +729,27 @@ def get_cv_summary(self) -> Dict:
             "developmental_stage": self.latest_developmental_stage,
             "elongation_ratio": self.latest_elongation_ratio,
             "analyses_count": {
-                result_type: len(results)
-                for result_type, results in self.cv_analyses.items()
+                result_type: len(results) for result_type, results in self.cv_analyses.items()
             },
         }
 
-    def update_from_analysis(self, analysis_result: Dict):
+    def update_from_analysis(self, analysis_result: dict):
         """Update state with new analysis"""
-        if 'hatching' in analysis_result:
-            self.hatching_status = analysis_result['hatching']
+        if "hatching" in analysis_result:
+            self.hatching_status = analysis_result["hatching"]
 
-        if 'morphology' in analysis_result:
-            self.morphology_history.append({
-                'timepoint': self.timepoints_acquired,
-                **analysis_result['morphology']
-            })
+        if "morphology" in analysis_result:
+            self.morphology_history.append(
+                {"timepoint": self.timepoints_acquired, **analysis_result["morphology"]}
+            )
 
-        if 'fluorescence' in analysis_result:
-            self.fluorescence_history.append({
-                'timepoint': self.timepoints_acquired,
-                **analysis_result['fluorescence']
-            })
+        if "fluorescence" in analysis_result:
+            self.fluorescence_history.append(
+                {
+                    "timepoint": self.timepoints_acquired,
+                    **analysis_result["fluorescence"],
+                }
+            )
 
     def to_summary(self) -> str:
         """Format for Claude system prompt"""
@@ -749,7 +773,7 @@ def to_summary(self) -> str:
             status_parts.append("not yet imaged")
 
         # Status
-        if self.hatching_status.get('hatched'):
+        if self.hatching_status.get("hatched"):
             status_parts.append(f"hatched at t{self.hatching_status['timepoint']:04d}")
         elif self.should_skip:
             status_parts.append(f"skipped ({self.skip_reason})")
@@ -765,7 +789,12 @@ def to_summary(self) -> str:
 
         return " | ".join(status_parts)
 
-    def record_exposure(self, exposure_ms: float, num_frames: int = 1, timestamp: Optional[datetime] = None):
+    def record_exposure(
+        self,
+        exposure_ms: float,
+        num_frames: int = 1,
+        timestamp: datetime | None = None,
+    ):
         """
         Record light exposure for phototoxicity tracking.
 
@@ -798,7 +827,7 @@ def get_exposure_summary(self) -> str:
         return f"{self.exposure_count} exposures, {time_str} total"
 
     @property
-    def stage_position(self) -> Dict[str, float]:
+    def stage_position(self) -> dict[str, float]:
         """Resolved XY position — fine if SPIM-aligned, else coarse.
 
         Coarse comes from the bottom-camera detection / manual map placement.
@@ -810,7 +839,7 @@ def stage_position(self) -> Dict[str, float]:
         return self.position_fine if self.position_fine else self.position_coarse
 
     @stage_position.setter
-    def stage_position(self, value: Dict[str, float]) -> None:
+    def stage_position(self, value: dict[str, float]) -> None:
         """Back-compat setter — writes to coarse.
 
         Legacy callers that assigned `embryo.stage_position = {...}` were
@@ -824,42 +853,42 @@ def has_fine_position(self) -> bool:
         """True once SPIM-objective alignment has refined the coarse position."""
         return bool(self.position_fine)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize for API responses"""
         return {
-            'id': self.id,
-            'uid': self.uid,
-            'nickname': self.nickname,
-            'user_label': self.user_label,
-            'role': self.role,
-            'stage_position': self.stage_position,
-            'position_coarse': self.position_coarse,
-            'position_fine': self.position_fine,
-            'has_fine_position': self.has_fine_position,
-            'calibration': self.calibration,
-            'detection_confidence': self.detection_confidence,
-            'interval_seconds': self.interval_seconds,
-            'num_slices': self.num_slices,
-            'exposure_ms': self.exposure_ms,
-            'priority': self.priority,
-            'acquisition_mode': self.acquisition_mode,
-            'laser_power_488_pct': self.laser_power_488_pct,
-            'last_imaged': self.last_imaged.isoformat() if self.last_imaged else None,
-            'timepoints_acquired': self.timepoints_acquired,
-            'should_skip': self.should_skip,
-            'skip_reason': self.skip_reason,
-            'exposure_count': self.exposure_count,
-            'total_exposure_ms': self.total_exposure_ms,
-            'hatching_status': self.hatching_status,
-            'pending_verification': self.pending_verification,
-            'consecutive_detection_count': self.consecutive_detection_count,
-            'last_detection_round': self.last_detection_round,
-            'recent_analyses': {
-                'morphology': self.morphology_history[-5:] if self.morphology_history else [],
-                'fluorescence': self.fluorescence_history[-5:] if self.fluorescence_history else [],
-                'custom': self.custom_classifications,
+            "id": self.id,
+            "uid": self.uid,
+            "nickname": self.nickname,
+            "user_label": self.user_label,
+            "role": self.role,
+            "stage_position": self.stage_position,
+            "position_coarse": self.position_coarse,
+            "position_fine": self.position_fine,
+            "has_fine_position": self.has_fine_position,
+            "calibration": self.calibration,
+            "detection_confidence": self.detection_confidence,
+            "interval_seconds": self.interval_seconds,
+            "num_slices": self.num_slices,
+            "exposure_ms": self.exposure_ms,
+            "priority": self.priority,
+            "acquisition_mode": self.acquisition_mode,
+            "laser_power_488_pct": self.laser_power_488_pct,
+            "last_imaged": self.last_imaged.isoformat() if self.last_imaged else None,
+            "timepoints_acquired": self.timepoints_acquired,
+            "should_skip": self.should_skip,
+            "skip_reason": self.skip_reason,
+            "exposure_count": self.exposure_count,
+            "total_exposure_ms": self.total_exposure_ms,
+            "hatching_status": self.hatching_status,
+            "pending_verification": self.pending_verification,
+            "consecutive_detection_count": self.consecutive_detection_count,
+            "last_detection_round": self.last_detection_round,
+            "recent_analyses": {
+                "morphology": self.morphology_history[-5:] if self.morphology_history else [],
+                "fluorescence": self.fluorescence_history[-5:] if self.fluorescence_history else [],
+                "custom": self.custom_classifications,
             },
-            'focus_history': [fp.to_dict() for fp in self.focus_history],
+            "focus_history": [fp.to_dict() for fp in self.focus_history],
         }
 
 
@@ -867,17 +896,17 @@ class ExperimentState:
     """Global experiment state"""
 
     def __init__(self):
-        self.embryos: Dict[str, EmbryoState] = {}
-        self.start_time: Optional[datetime] = None
+        self.embryos: dict[str, EmbryoState] = {}
+        self.start_time: datetime | None = None
         self.acquisition_status: str = "idle"  # idle/running/paused/completed
-        self.current_plan_name: Optional[str] = None
-        self.plan_history: List[Dict] = []
-        self.metadata: Dict = {}
+        self.current_plan_name: str | None = None
+        self.plan_history: list[dict] = []
+        self.metadata: dict = {}
 
         # Active plan item — set during plan context resolution at startup.
         # When set, the agent's system prompt includes the full ImagingSpec
         # so it knows what it's here to do without being told.
-        self.active_plan_item_id: Optional[str] = None
+        self.active_plan_item_id: str | None = None
 
         # Session-level calibration prior for cross-embryo learning
         # Updated after each successful calibration, used to initialize subsequent embryos
@@ -886,7 +915,7 @@ def __init__(self):
         # Observer hook — agent wires this at startup to publish EMBRYOS_UPDATE
         # over the event bus. Kept as a plain callback so this module stays
         # bus-agnostic.
-        self.on_embryos_changed: Optional[Callable[[], None]] = None
+        self.on_embryos_changed: Callable[[], None] | None = None
 
     def notify_embryos_changed(self) -> None:
         """Fire the on_embryos_changed observer if one is wired.
@@ -904,10 +933,17 @@ def notify_embryos_changed(self) -> None:
         except Exception:
             logger.exception("ExperimentState.on_embryos_changed callback failed")
 
-    def add_embryo(self, embryo_id: str, position: Dict = None,
-                   calibration: Dict = None, user_label: Optional[str] = None,
-                   confidence: float = 0.0, uid: Optional[str] = None,
-                   role: str = "test", position_fine: Dict = None):
+    def add_embryo(
+        self,
+        embryo_id: str,
+        position: dict = None,
+        calibration: dict = None,
+        user_label: str | None = None,
+        confidence: float = 0.0,
+        uid: str | None = None,
+        role: str = "test",
+        position_fine: dict = None,
+    ):
         """Register new embryo.
 
         ``role`` must be a key in :data:`gently.harness.roles.REGISTRY`
@@ -924,6 +960,7 @@ def add_embryo(self, embryo_id: str, position: Dict = None,
         first acquisition.
         """
         from gently.harness.roles import get_role
+
         get_role(role)  # raises KeyError if unknown
 
         # Auto-start experiment when first embryo is added
@@ -947,6 +984,7 @@ def add_embryo(self, embryo_id: str, position: Dict = None,
         # decoupled from the event bus until first use.
         try:
             from gently.core import EventType, get_event_bus
+
             get_event_bus().publish(
                 event_type=EventType.EMBRYO_DETECTED,
                 data={
@@ -978,7 +1016,7 @@ def assign_nickname(self, embryo_id: str, nickname: str):
             self.embryos[embryo_id].nickname = nickname
             self.notify_embryos_changed()
 
-    def get_embryo_by_any_name(self, name: str) -> Optional[EmbryoState]:
+    def get_embryo_by_any_name(self, name: str) -> EmbryoState | None:
         """Get embryo by ID, nickname, or user label"""
         # Direct ID match
         if name in self.embryos:
@@ -990,7 +1028,7 @@ def get_embryo_by_any_name(self, name: str) -> Optional[EmbryoState]:
                 return embryo
 
         # Try extracting number from name like "embryo 3" -> "embryo_3"
-        match = re.search(r'(\d+)', name)
+        match = re.search(r"(\d+)", name)
         if match:
             num = int(match.group(1))
             # Try simple format first (embryo_3)
@@ -1018,7 +1056,7 @@ def get_summary(self) -> str:
             f"Duration: {hours}h {minutes}m",
             f"Embryos: {len(self.embryos)}",
             "",
-            "Per-embryo status:"
+            "Per-embryo status:",
         ]
 
         for embryo in sorted(self.embryos.values(), key=lambda e: e.id):
@@ -1032,15 +1070,15 @@ def get_summary(self) -> str:
 
         return "\n".join(lines)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Serialize for API responses"""
         return {
-            'start_time': self.start_time.isoformat() if self.start_time else None,
-            'acquisition_status': self.acquisition_status,
-            'current_plan_name': self.current_plan_name,
-            'active_plan_item_id': self.active_plan_item_id,
-            'embryo_count': len(self.embryos),
-            'embryos': {eid: e.to_dict() for eid, e in self.embryos.items()},
-            'metadata': self.metadata,
-            'calibration_prior': self.calibration_prior.to_dict(),
+            "start_time": self.start_time.isoformat() if self.start_time else None,
+            "acquisition_status": self.acquisition_status,
+            "current_plan_name": self.current_plan_name,
+            "active_plan_item_id": self.active_plan_item_id,
+            "embryo_count": len(self.embryos),
+            "embryos": {eid: e.to_dict() for eid, e in self.embryos.items()},
+            "metadata": self.metadata,
+            "calibration_prior": self.calibration_prior.to_dict(),
         }
diff --git a/gently/harness/tools/helpers.py b/gently/harness/tools/helpers.py
index 3d6b03b8..fa98cf62 100644
--- a/gently/harness/tools/helpers.py
+++ b/gently/harness/tools/helpers.py
@@ -5,11 +5,11 @@
 used across multiple tools to reduce code duplication.
 """
 
-from typing import Any, Dict, List, Optional, Tuple
 from datetime import datetime
+from typing import Any
 
 
-def require_agent(context: Dict) -> Tuple[Optional[Any], Optional[str]]:
+def require_agent(context: dict) -> tuple[Any | None, str | None]:
     """
     Extract agent from context or return error message
 
@@ -23,13 +23,13 @@ def require_agent(context: Dict) -> Tuple[Optional[Any], Optional[str]]:
     tuple
         (agent, None) if found, (None, error_message) if not
     """
-    agent = context.get('agent')
+    agent = context.get("agent")
     if not agent:
         return None, "Error: No agent context"
     return agent, None
 
 
-def get_embryo_or_error(agent, embryo_id: str) -> Tuple[Optional[Any], Optional[str]]:
+def get_embryo_or_error(agent, embryo_id: str) -> tuple[Any | None, str | None]:
     """
     Get embryo by any name or return error message
 
@@ -51,7 +51,7 @@ def get_embryo_or_error(agent, embryo_id: str) -> Tuple[Optional[Any], Optional[
     return embryo, None
 
 
-def require_microscope(context: Dict) -> Tuple[Optional[Any], Optional[str]]:
+def require_microscope(context: dict) -> tuple[Any | None, str | None]:
     """
     Get microscope client from context or return error message
 
@@ -65,13 +65,13 @@ def require_microscope(context: Dict) -> Tuple[Optional[Any], Optional[str]]:
     tuple
         (client, None) if connected, (None, error_message) if not
     """
-    client = context.get('client')
+    client = context.get("client")
     if not client:
         return None, "Not connected to microscope. Use connect_microscope first."
     return client, None
 
 
-def require_interaction_logger(agent) -> Tuple[Optional[Any], Optional[str]]:
+def require_interaction_logger(agent) -> tuple[Any | None, str | None]:
     """
     Get interaction logger or return error message
 
@@ -85,12 +85,12 @@ def require_interaction_logger(agent) -> Tuple[Optional[Any], Optional[str]]:
     tuple
         (logger, None) if available, (None, error_message) if not
     """
-    if not hasattr(agent, 'interaction_logger') or not agent.interaction_logger:
+    if not hasattr(agent, "interaction_logger") or not agent.interaction_logger:
         return None, "Interaction logging not enabled."
     return agent.interaction_logger, None
 
 
-def require_developmental_tracker(agent) -> Tuple[Optional[Any], Optional[str]]:
+def require_developmental_tracker(agent) -> tuple[Any | None, str | None]:
     """
     Get developmental tracker or return error message
 
@@ -104,12 +104,15 @@ def require_developmental_tracker(agent) -> Tuple[Optional[Any], Optional[str]]:
     tuple
         (tracker, None) if available, (None, error_message) if not
     """
-    if not hasattr(agent, 'developmental_tracker') or not agent.developmental_tracker:
-        return None, "No stage classifications recorded yet. Use classify_embryo_stage first."
+    if not hasattr(agent, "developmental_tracker") or not agent.developmental_tracker:
+        return (
+            None,
+            "No stage classifications recorded yet. Use classify_embryo_stage first.",
+        )
     return agent.developmental_tracker, None
 
 
-def require_timelapse_orchestrator(agent) -> Tuple[Optional[Any], Optional[str]]:
+def require_timelapse_orchestrator(agent) -> tuple[Any | None, str | None]:
     """
     Get timelapse orchestrator or return error message
 
@@ -123,12 +126,12 @@ def require_timelapse_orchestrator(agent) -> Tuple[Optional[Any], Optional[str]]
     tuple
         (orchestrator, None) if available, (None, error_message) if not
     """
-    if not hasattr(agent, 'timelapse_orchestrator') or agent.timelapse_orchestrator is None:
+    if not hasattr(agent, "timelapse_orchestrator") or agent.timelapse_orchestrator is None:
         return None, "Timelapse orchestrator not initialized."
     return agent.timelapse_orchestrator, None
 
 
-def require_databroker(agent) -> Tuple[Optional[Any], Optional[str]]:
+def require_databroker(agent) -> tuple[Any | None, str | None]:
     """
     Get databroker connection or return error message
 
@@ -142,7 +145,7 @@ def require_databroker(agent) -> Tuple[Optional[Any], Optional[str]]:
     tuple
         (databroker, None) if available, (None, error_message) if not
     """
-    if not hasattr(agent, 'databroker') or agent.databroker is None:
+    if not hasattr(agent, "databroker") or agent.databroker is None:
         return None, "No databroker connection. Data persistence not available."
     return agent.databroker, None
 
@@ -184,13 +187,13 @@ def format_duration(seconds: float) -> str:
 
 
 def build_snapshot_metadata(
-    stage_position: Tuple[float, float],
-    image_shape: Tuple[int, ...],
+    stage_position: tuple[float, float],
+    image_shape: tuple[int, ...],
     experiment=None,
     pixel_size_um: float = 6.5,
     objective_mag: float = 10.0,
-    safety_limits: Optional[Dict] = None,
-) -> Dict:
+    safety_limits: dict | None = None,
+) -> dict:
     """Build metadata dict for a bottom camera snapshot.
 
     Captures everything needed to reconstruct embryo positions
@@ -226,7 +229,7 @@ def build_snapshot_metadata(
         # gently/hardware/dispim/devices/stage.py::DiSPIMXYStage.__init__.
         safety_limits = {"x": (2000.0, 4000.0), "y": (-1000.0, 1000.0)}
 
-    meta: Dict[str, Any] = {
+    meta: dict[str, Any] = {
         "stage_x": stage_position[0],
         "stage_y": stage_position[1],
         "image_width": w,
@@ -242,15 +245,17 @@ def build_snapshot_metadata(
     }
 
     if experiment and experiment.embryos:
-        embryos: List[Dict] = []
+        embryos: list[dict] = []
         for eid, emb in experiment.embryos.items():
             pos = emb.stage_position or {}
-            embryos.append({
-                "embryo_id": eid,
-                "stage_x": pos.get("x"),
-                "stage_y": pos.get("y"),
-                "nickname": getattr(emb, "nickname", None),
-            })
+            embryos.append(
+                {
+                    "embryo_id": eid,
+                    "stage_x": pos.get("x"),
+                    "stage_y": pos.get("y"),
+                    "nickname": getattr(emb, "nickname", None),
+                }
+            )
         meta["embryos"] = embryos
 
     return meta
diff --git a/gently/harness/tools/registry.py b/gently/harness/tools/registry.py
index 48e1cf4f..30f72cf8 100644
--- a/gently/harness/tools/registry.py
+++ b/gently/harness/tools/registry.py
@@ -13,49 +13,56 @@
 import functools
 import inspect
 import logging
+import time
+from collections.abc import Callable
 from dataclasses import dataclass, field
 from enum import Enum, auto
 from typing import (
-    Any, Callable, Dict, List, Optional, Type, Union,
-    get_type_hints, get_origin, get_args
+    Any,
+    Union,
+    get_args,
+    get_origin,
+    get_type_hints,
 )
-import time
 
 logger = logging.getLogger(__name__)
 
 
 class ToolCategory(Enum):
     """Categories for organizing tools"""
-    ACQUISITION = auto()      # Volume/image acquisition
-    MOVEMENT = auto()         # Stage movement, positioning
-    CALIBRATION = auto()      # Calibration procedures
-    ANALYSIS = auto()         # Image/volume analysis
-    DETECTION = auto()        # Detector management
-    EXPERIMENT = auto()       # Experiment state management
-    EMBRYO = auto()           # Embryo-specific operations
-    HARDWARE = auto()         # Direct hardware control
-    DATA = auto()             # Data/Databroker operations
-    UTILITY = auto()          # Utility functions
-    ML = auto()               # Machine learning training
-    TRANSFER = auto()         # Bulk data transfer
+
+    ACQUISITION = auto()  # Volume/image acquisition
+    MOVEMENT = auto()  # Stage movement, positioning
+    CALIBRATION = auto()  # Calibration procedures
+    ANALYSIS = auto()  # Image/volume analysis
+    DETECTION = auto()  # Detector management
+    EXPERIMENT = auto()  # Experiment state management
+    EMBRYO = auto()  # Embryo-specific operations
+    HARDWARE = auto()  # Direct hardware control
+    DATA = auto()  # Data/Databroker operations
+    UTILITY = auto()  # Utility functions
+    ML = auto()  # Machine learning training
+    TRANSFER = auto()  # Bulk data transfer
 
 
 @dataclass
 class ToolParameter:
     """Definition of a tool parameter"""
+
     name: str
     type: str  # JSON schema type
     description: str
     required: bool = True
     default: Any = None
-    enum: Optional[List[str]] = None
+    enum: list[str] | None = None
 
 
 @dataclass
 class ToolExample:
     """Example of when to use a tool"""
+
     user_query: str
-    tool_input: Dict = field(default_factory=dict)
+    tool_input: dict = field(default_factory=dict)
 
 
 @dataclass
@@ -69,17 +76,18 @@ class ToolDefinition:
     - Documentation
     - Filtering/discovery
     """
+
     name: str
     description: str
     handler: Callable
-    parameters: List[ToolParameter] = field(default_factory=list)
+    parameters: list[ToolParameter] = field(default_factory=list)
     category: ToolCategory = ToolCategory.UTILITY
     requires_microscope: bool = False
     is_async: bool = False
-    tags: List[str] = field(default_factory=list)
-    examples: List[ToolExample] = field(default_factory=list)
+    tags: list[str] = field(default_factory=list)
+    examples: list[ToolExample] = field(default_factory=list)
 
-    def to_claude_schema(self) -> Dict:
+    def to_claude_schema(self) -> dict:
         """Generate Claude API tool schema with examples embedded in description"""
         properties = {}
         required = []
@@ -114,7 +122,7 @@ def to_claude_schema(self) -> Dict:
                 "type": "object",
                 "properties": properties,
                 "required": required,
-            }
+            },
         }
 
 
@@ -156,29 +164,29 @@ def _python_type_to_json_schema(python_type) -> str:
     return "string"
 
 
-def _extract_parameters_from_function(func: Callable) -> List[ToolParameter]:
+def _extract_parameters_from_function(func: Callable) -> list[ToolParameter]:
     """Extract parameter definitions from function signature and type hints"""
     sig = inspect.signature(func)
-    hints = get_type_hints(func) if hasattr(func, '__annotations__') else {}
+    hints = get_type_hints(func) if hasattr(func, "__annotations__") else {}
     doc = inspect.getdoc(func) or ""
 
     # Parse docstring for parameter descriptions
     param_docs = {}
     in_params = False
     current_param = None
-    for line in doc.split('\n'):
+    for line in doc.split("\n"):
         line = line.strip()
-        if line.lower().startswith('parameters'):
+        if line.lower().startswith("parameters"):
             in_params = True
             continue
         if in_params:
-            if line.startswith('---'):
+            if line.startswith("---"):
                 continue
-            if line.lower().startswith('returns'):
+            if line.lower().startswith("returns"):
                 in_params = False
                 continue
-            if ' : ' in line:
-                parts = line.split(' : ')
+            if " : " in line:
+                parts = line.split(" : ")
                 current_param = parts[0].strip()
                 param_docs[current_param] = ""
             elif current_param and line:
@@ -187,7 +195,7 @@ def _extract_parameters_from_function(func: Callable) -> List[ToolParameter]:
     parameters = []
     for param_name, param in sig.parameters.items():
         # Skip 'self', 'tool_input' (legacy pattern), and 'context' (injected at runtime)
-        if param_name in ('self', 'tool_input', 'context'):
+        if param_name in ("self", "tool_input", "context"):
             continue
 
         python_type = hints.get(param_name, str)
@@ -200,13 +208,15 @@ def _extract_parameters_from_function(func: Callable) -> List[ToolParameter]:
         # Get description from docstring
         description = param_docs.get(param_name, f"The {param_name} parameter").strip()
 
-        parameters.append(ToolParameter(
-            name=param_name,
-            type=json_type,
-            description=description,
-            required=required,
-            default=default,
-        ))
+        parameters.append(
+            ToolParameter(
+                name=param_name,
+                type=json_type,
+                description=description,
+                required=required,
+                default=default,
+            )
+        )
 
     return parameters
 
@@ -223,8 +233,8 @@ class ToolRegistry:
     """
 
     def __init__(self):
-        self._tools: Dict[str, ToolDefinition] = {}
-        self._context: Dict[str, Any] = {}  # Shared context (agent, client, etc.)
+        self._tools: dict[str, ToolDefinition] = {}
+        self._context: dict[str, Any] = {}  # Shared context (agent, client, etc.)
 
     def set_context(self, key: str, value: Any):
         """Set shared context available to all tools"""
@@ -236,13 +246,13 @@ def get_context(self, key: str) -> Any:
 
     def register(
         self,
-        name: Optional[str] = None,
-        description: Optional[str] = None,
+        name: str | None = None,
+        description: str | None = None,
         category: ToolCategory = ToolCategory.UTILITY,
         requires_microscope: bool = False,
-        tags: Optional[List[str]] = None,
-        parameters: Optional[List[ToolParameter]] = None,
-        examples: Optional[List[ToolExample]] = None,
+        tags: list[str] | None = None,
+        parameters: list[ToolParameter] | None = None,
+        examples: list[ToolExample] | None = None,
     ) -> Callable:
         """
         Decorator to register a function as a tool
@@ -277,9 +287,10 @@ async def acquire_volume(embryo_id: str, num_slices: int = 50) -> str:
         examples : list of ToolExample, optional
             Usage examples showing when to call this tool
         """
+
         def decorator(func: Callable) -> Callable:
             tool_name = name or func.__name__
-            tool_desc = description or (inspect.getdoc(func) or "").split('\n')[0]
+            tool_desc = description or (inspect.getdoc(func) or "").split("\n")[0]
 
             # Extract or use provided parameters
             tool_params = parameters or _extract_parameters_from_function(func)
@@ -311,11 +322,11 @@ async def wrapper(*args, **kwargs):
     def register_function(
         self,
         func: Callable,
-        name: Optional[str] = None,
-        description: Optional[str] = None,
+        name: str | None = None,
+        description: str | None = None,
         category: ToolCategory = ToolCategory.UTILITY,
         requires_microscope: bool = False,
-        tags: Optional[List[str]] = None,
+        tags: list[str] | None = None,
     ):
         """
         Register an existing function as a tool (non-decorator form)
@@ -336,7 +347,7 @@ def register_function(
             Additional tags
         """
         tool_name = name or func.__name__
-        tool_desc = description or (inspect.getdoc(func) or "").split('\n')[0]
+        tool_desc = description or (inspect.getdoc(func) or "").split("\n")[0]
         tool_params = _extract_parameters_from_function(func)
 
         tool_def = ToolDefinition(
@@ -360,23 +371,23 @@ def unregister(self, name: str) -> bool:
             return True
         return False
 
-    def get(self, name: str) -> Optional[ToolDefinition]:
+    def get(self, name: str) -> ToolDefinition | None:
         """Get tool definition by name"""
         return self._tools.get(name)
 
-    def list_all(self) -> List[ToolDefinition]:
+    def list_all(self) -> list[ToolDefinition]:
         """List all registered tools"""
         return list(self._tools.values())
 
-    def list_by_category(self, category: ToolCategory) -> List[ToolDefinition]:
+    def list_by_category(self, category: ToolCategory) -> list[ToolDefinition]:
         """List tools in a category"""
         return [t for t in self._tools.values() if t.category == category]
 
-    def list_by_tag(self, tag: str) -> List[ToolDefinition]:
+    def list_by_tag(self, tag: str) -> list[ToolDefinition]:
         """List tools with a specific tag"""
         return [t for t in self._tools.values() if tag in t.tags]
 
-    def list_available(self, has_microscope: bool = False) -> List[ToolDefinition]:
+    def list_available(self, has_microscope: bool = False) -> list[ToolDefinition]:
         """List tools available given current context"""
         tools = []
         for tool in self._tools.values():
@@ -385,14 +396,11 @@ def list_available(self, has_microscope: bool = False) -> List[ToolDefinition]:
             tools.append(tool)
         return tools
 
-    def get_claude_schemas(self, has_microscope: bool = False) -> List[Dict]:
+    def get_claude_schemas(self, has_microscope: bool = False) -> list[dict]:
         """Get Claude API tool schemas for available tools"""
-        return [
-            tool.to_claude_schema()
-            for tool in self.list_available(has_microscope)
-        ]
+        return [tool.to_claude_schema() for tool in self.list_available(has_microscope)]
 
-    async def execute(self, tool_name: str, tool_input: Dict, context: Dict = None) -> str:
+    async def execute(self, tool_name: str, tool_input: dict, context: dict = None) -> str:
         """
         Execute a tool by name
 
@@ -420,8 +428,8 @@ async def execute(self, tool_name: str, tool_input: Dict, context: Dict = None)
         # 3. Fall back to stored registry context
         if context is not None:
             exec_context = context
-        elif 'context' in tool_input and tool_input['context'] is not None:
-            exec_context = tool_input['context']
+        elif "context" in tool_input and tool_input["context"] is not None:
+            exec_context = tool_input["context"]
         else:
             exec_context = self._context
 
@@ -431,17 +439,19 @@ async def execute(self, tool_name: str, tool_input: Dict, context: Dict = None)
         # them directly. The agent sets these flags around its autonomous turns;
         # user-driven turns are unaffected. The blocked set is supplied by the
         # agent so this layer stays free of app-specific tool names.
-        _agent = exec_context.get('agent') if isinstance(exec_context, dict) else None
-        if _agent is not None and getattr(_agent, '_autonomous_active', False):
-            blocked = getattr(_agent, '_autonomous_blocked_tools', None) or ()
+        _agent = exec_context.get("agent") if isinstance(exec_context, dict) else None
+        if _agent is not None and getattr(_agent, "_autonomous_active", False):
+            blocked = getattr(_agent, "_autonomous_blocked_tools", None) or ()
             if tool_name in blocked:
                 logger.info("Autonomy backstop blocked '%s' (irreversible)", tool_name)
-                return (f"'{tool_name}' is an irreversible action and cannot run "
-                        f"autonomously. Ask the operator to confirm it.")
+                return (
+                    f"'{tool_name}' is an irreversible action and cannot run "
+                    f"autonomously. Ask the operator to confirm it."
+                )
 
         # Check microscope requirement
         if tool.requires_microscope:
-            client = exec_context.get('client')
+            client = exec_context.get("client")
             if client is None:
                 return "Error: Not connected to microscope server. Start the server and reconnect."
 
@@ -453,8 +463,8 @@ async def execute(self, tool_name: str, tool_input: Dict, context: Dict = None)
 
             # Inject context if handler expects it (but don't overwrite if already provided)
             sig = inspect.signature(tool.handler)
-            if 'context' in sig.parameters and 'context' not in kwargs:
-                kwargs['context'] = exec_context
+            if "context" in sig.parameters and "context" not in kwargs:
+                kwargs["context"] = exec_context
 
             # Execute handler
             if tool.is_async:
@@ -469,6 +479,7 @@ async def execute(self, tool_name: str, tool_input: Dict, context: Dict = None)
 
         except Exception as e:
             import traceback
+
             logger.error(f"Tool {tool_name} failed: {e}")
             return f"Error executing {tool_name}: {str(e)}\n{traceback.format_exc()}"
 
@@ -480,7 +491,7 @@ def __len__(self) -> int:
 
 
 # Global registry instance
-_global_registry: Optional[ToolRegistry] = None
+_global_registry: ToolRegistry | None = None
 
 
 def get_tool_registry() -> ToolRegistry:
@@ -499,12 +510,12 @@ def set_tool_registry(registry: ToolRegistry):
 
 # Convenience decorator using global registry
 def tool(
-    name: Optional[str] = None,
-    description: Optional[str] = None,
+    name: str | None = None,
+    description: str | None = None,
     category: ToolCategory = ToolCategory.UTILITY,
     requires_microscope: bool = False,
-    tags: Optional[List[str]] = None,
-    examples: Optional[List[ToolExample]] = None,
+    tags: list[str] | None = None,
+    examples: list[ToolExample] | None = None,
 ) -> Callable:
     """
     Decorator to register a tool with the global registry
diff --git a/gently/log_config.py b/gently/log_config.py
index 4db29ad1..5d5f75b2 100644
--- a/gently/log_config.py
+++ b/gently/log_config.py
@@ -9,6 +9,7 @@
     GENTLY_LOG_FORMAT  — console format string
     GENTLY_LOG_DATEFMT — timestamp format (default: %H:%M:%S)
 """
+
 import logging
 import os
 import sys
@@ -54,9 +55,18 @@ def configure_logging(
         lgr.addHandler(console)
 
     # Suppress noisy third-party loggers on console
-    for name in ("uvicorn", "uvicorn.error", "uvicorn.access",
-                  "httpx", "httpcore", "anthropic", "aiohttp",
-                  "aiohttp.access", "bluesky", "bluesky.RE.state"):
+    for name in (
+        "uvicorn",
+        "uvicorn.error",
+        "uvicorn.access",
+        "httpx",
+        "httpcore",
+        "anthropic",
+        "aiohttp",
+        "aiohttp.access",
+        "bluesky",
+        "bluesky.RE.state",
+    ):
         logging.getLogger(name).setLevel(logging.WARNING)
 
     # File handler — always INFO+ regardless of console level
diff --git a/gently/mesh/audit.py b/gently/mesh/audit.py
index 06e76729..e4f06746 100644
--- a/gently/mesh/audit.py
+++ b/gently/mesh/audit.py
@@ -53,7 +53,7 @@ def _count_lines(self):
         """Count existing lines for rotation tracking."""
         if self._log_file.exists():
             try:
-                with open(self._log_file, "r") as f:
+                with open(self._log_file) as f:
                     self._line_count = sum(1 for _ in f)
             except OSError:
                 self._line_count = 0
@@ -88,7 +88,7 @@ def log(
     def _rotate(self):
         """Keep last KEEP_LINES, discard the rest."""
         try:
-            with open(self._log_file, "r") as f:
+            with open(self._log_file) as f:
                 lines = f.readlines()
             keep = lines[-KEEP_LINES:]
             with open(self._log_file, "w") as f:
diff --git a/gently/mesh/capability_provider.py b/gently/mesh/capability_provider.py
index 2453dce9..7dfc6fd1 100644
--- a/gently/mesh/capability_provider.py
+++ b/gently/mesh/capability_provider.py
@@ -8,18 +8,19 @@
 import logging
 import os
 import platform
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from .models import DatasetAdvertisement, GpuInfo, PeerRole
 
 logger = logging.getLogger(__name__)
 
 
-def _detect_gpus() -> List[GpuInfo]:
+def _detect_gpus() -> list[GpuInfo]:
     """Detect available NVIDIA GPUs via torch.cuda (pynvml fallback)."""
     gpus = []
     try:
         import torch
+
         if torch.cuda.is_available():
             for i in range(torch.cuda.device_count()):
                 props = torch.cuda.get_device_properties(i)
@@ -28,23 +29,26 @@ def _detect_gpus() -> List[GpuInfo]:
                 mem_used_gb = 0.0
                 try:
                     import pynvml
+
                     pynvml.nvmlInit()
                     handle = pynvml.nvmlDeviceGetHandleByIndex(i)
                     util = pynvml.nvmlDeviceGetUtilizationRates(handle)
                     util_pct = float(util.gpu)
                     mem_info = pynvml.nvmlDeviceGetMemoryInfo(handle)
-                    mem_used_gb = mem_info.used / (1024 ** 3)
+                    mem_used_gb = mem_info.used / (1024**3)
                 except Exception:
                     pass
 
-                gpus.append(GpuInfo(
-                    device_index=i,
-                    name=props.name,
-                    vram_gb=round(props.total_mem / (1024 ** 3), 1),
-                    compute_capability=f"{props.major}.{props.minor}",
-                    utilization_pct=util_pct,
-                    memory_used_gb=round(mem_used_gb, 2),
-                ))
+                gpus.append(
+                    GpuInfo(
+                        device_index=i,
+                        name=props.name,
+                        vram_gb=round(props.total_mem / (1024**3), 1),
+                        compute_capability=f"{props.major}.{props.minor}",
+                        utilization_pct=util_pct,
+                        memory_used_gb=round(mem_used_gb, 2),
+                    )
+                )
     except ImportError:
         pass
     except Exception as e:
@@ -52,13 +56,14 @@ def _detect_gpus() -> List[GpuInfo]:
     return gpus
 
 
-def _get_system_info() -> Dict[str, Any]:
+def _get_system_info() -> dict[str, Any]:
     """Get CPU and RAM info."""
     cpu_cores = os.cpu_count() or 0
     ram_gb = 0.0
     try:
         if platform.system() == "Windows":
             import ctypes
+
             kernel32 = ctypes.windll.kernel32
             mem_status = ctypes.c_ulonglong()
             kernel32.GetPhysicallyInstalledSystemMemory(ctypes.byref(mem_status))
@@ -92,12 +97,12 @@ def __init__(
         self,
         gently_store=None,
         device_layer=None,
-        static_caps: Optional[Dict[str, Any]] = None,
+        static_caps: dict[str, Any] | None = None,
     ):
         self._store = gently_store
         self._device_layer = device_layer
         self._static = static_caps or {}
-        self._gpus: List[GpuInfo] = []
+        self._gpus: list[GpuInfo] = []
         self._system_info = _get_system_info()
         # Initial GPU detection (cached, refreshed on demand)
         self._gpus = _detect_gpus()
@@ -106,7 +111,7 @@ def refresh_gpus(self):
         """Re-detect GPUs (call periodically for live utilization)."""
         self._gpus = _detect_gpus()
 
-    def _compute_roles(self) -> List[str]:
+    def _compute_roles(self) -> list[str]:
         """Determine dynamic roles based on current state."""
         roles = []
         # Microscope controller if device is connected and responding
@@ -131,7 +136,7 @@ def _compute_roles(self) -> List[str]:
         roles.append(PeerRole.PLANNER.value)
         return roles
 
-    def _get_datasets(self) -> List[DatasetAdvertisement]:
+    def _get_datasets(self) -> list[DatasetAdvertisement]:
         """Query FileStore for dataset advertisements."""
         if self._store is None:
             return []
@@ -164,15 +169,17 @@ def _get_datasets(self) -> List[DatasetAdvertisement]:
                     except Exception:
                         pass
 
-                datasets.append(DatasetAdvertisement(
-                    session_id=sid,
-                    session_name=sname,
-                    embryo_count=embryo_count,
-                    volume_count=vol_count,
-                    has_ground_truth=gt_count > 0,
-                    ground_truth_count=gt_count,
-                    stages_covered=sorted(stages),
-                ))
+                datasets.append(
+                    DatasetAdvertisement(
+                        session_id=sid,
+                        session_name=sname,
+                        embryo_count=embryo_count,
+                        volume_count=vol_count,
+                        has_ground_truth=gt_count > 0,
+                        ground_truth_count=gt_count,
+                        stages_covered=sorted(stages),
+                    )
+                )
         except Exception as e:
             logger.debug(f"Dataset advertisement failed: {e}")
         return datasets
@@ -186,7 +193,7 @@ def _is_microscope_connected(self) -> bool:
                 pass
         return False
 
-    def __call__(self) -> Dict[str, Any]:
+    def __call__(self) -> dict[str, Any]:
         """Build the full capability dict. Called on each heartbeat."""
         datasets = self._get_datasets()
         roles = self._compute_roles()
@@ -199,10 +206,12 @@ def __call__(self) -> Dict[str, Any]:
         storage_total_gb = 0.0
         try:
             import shutil
+
             from ..settings import settings
+
             usage = shutil.disk_usage(str(settings.storage.base_path))
-            storage_free_gb = round(usage.free / (1024 ** 3), 1)
-            storage_total_gb = round(usage.total / (1024 ** 3), 1)
+            storage_free_gb = round(usage.free / (1024**3), 1)
+            storage_total_gb = round(usage.total / (1024**3), 1)
         except Exception:
             pass
 
diff --git a/gently/mesh/discovery.py b/gently/mesh/discovery.py
index 29fecd4a..878a9b81 100644
--- a/gently/mesh/discovery.py
+++ b/gently/mesh/discovery.py
@@ -15,7 +15,7 @@
 import logging
 import socket
 import time
-from typing import Callable, Optional
+from collections.abc import Callable
 
 from ..settings import settings
 
@@ -74,7 +74,7 @@ def __init__(
         self._pairing_manager = pairing_manager
         self._audit_log = audit_log
         self._known_ids: set = set()
-        self.transport: Optional[asyncio.DatagramTransport] = None
+        self.transport: asyncio.DatagramTransport | None = None
 
     def connection_made(self, transport: asyncio.DatagramTransport):
         self.transport = transport
@@ -101,9 +101,12 @@ def datagram_received(self, data: bytes, addr: tuple):
             logger.debug(f"Mesh: rejected stale packet from {peer_id[:8]} (ts={ts})")
             if self._audit_log:
                 from .audit import AuditEvent
+
                 self._audit_log.log(
-                    AuditEvent.REPLAY_REJECTED, outcome="deny",
-                    peer_id=peer_id, ip=sender_ip,
+                    AuditEvent.REPLAY_REJECTED,
+                    outcome="deny",
+                    peer_id=peer_id,
+                    ip=sender_ip,
                     detail=f"ts_delta={abs(time.time() - ts):.1f}s",
                 )
             return
@@ -120,9 +123,12 @@ def datagram_received(self, data: bytes, addr: tuple):
                     logger.debug(f"Mesh: bad signature from {peer_id[:8]}")
                     if self._audit_log:
                         from .audit import AuditEvent
+
                         self._audit_log.log(
-                            AuditEvent.SIG_INVALID, outcome="deny",
-                            peer_id=peer_id, ip=sender_ip,
+                            AuditEvent.SIG_INVALID,
+                            outcome="deny",
+                            peer_id=peer_id,
+                            ip=sender_ip,
                         )
 
         if msg_type == "nudge":
@@ -138,7 +144,7 @@ def datagram_received(self, data: bytes, addr: tuple):
     def error_received(self, exc: Exception):
         logger.debug(f"Mesh UDP error: {exc}")
 
-    def connection_lost(self, exc: Optional[Exception]):
+    def connection_lost(self, exc: Exception | None):
         pass
 
     def forget_peer(self, instance_id: str):
@@ -169,9 +175,9 @@ def __init__(
         self._pairing_manager = pairing_manager
         self._audit_log = audit_log
 
-        self._protocol: Optional[_MeshProtocol] = None
-        self._transport: Optional[asyncio.DatagramTransport] = None
-        self._broadcast_task: Optional[asyncio.Task] = None
+        self._protocol: _MeshProtocol | None = None
+        self._transport: asyncio.DatagramTransport | None = None
+        self._broadcast_task: asyncio.Task | None = None
         self._running = False
 
         # Callbacks — set by MeshService before start()
@@ -213,8 +219,7 @@ async def start(self):
         self._running = True
         self._broadcast_task = asyncio.create_task(self._broadcast_loop())
         logger.info(
-            f"Mesh discovery started on port {self.mesh_port} "
-            f"(instance={self.instance_id[:8]})"
+            f"Mesh discovery started on port {self.mesh_port} (instance={self.instance_id[:8]})"
         )
 
     async def stop(self):
@@ -259,9 +264,7 @@ def send_nudge(self):
             packet = json.dumps(payload).encode("utf-8")
 
         try:
-            self._transport.sendto(
-                packet, ("255.255.255.255", self.mesh_port)
-            )
+            self._transport.sendto(packet, ("255.255.255.255", self.mesh_port))
         except OSError as e:
             logger.debug(f"Mesh nudge broadcast failed: {e}")
 
@@ -286,9 +289,7 @@ async def _broadcast_loop(self):
 
             try:
                 if self._transport:
-                    self._transport.sendto(
-                        heartbeat, ("255.255.255.255", self.mesh_port)
-                    )
+                    self._transport.sendto(heartbeat, ("255.255.255.255", self.mesh_port))
             except OSError as e:
                 logger.debug(f"Mesh broadcast failed: {e}")
 
diff --git a/gently/mesh/mesh_service.py b/gently/mesh/mesh_service.py
index edac242c..3a4a7e52 100644
--- a/gently/mesh/mesh_service.py
+++ b/gently/mesh/mesh_service.py
@@ -11,12 +11,13 @@
 import asyncio
 import logging
 import time
+from collections.abc import Callable
 from pathlib import Path
-from typing import Callable, Dict, List, Optional
 
 from gently.core.event_bus import EventType
 from gently.core.service import Service
 
+from ..settings import settings
 from .discovery import MeshDiscovery
 from .models import PeerCapability, PeerInfo, PeerStatus
 from .peer_client import PeerClient
@@ -24,8 +25,6 @@
 
 logger = logging.getLogger(__name__)
 
-from ..settings import settings
-
 REAPER_INTERVAL = settings.mesh.reaper_interval_s
 STATUS_REFRESH_INTERVAL = settings.mesh.status_refresh_s
 
@@ -59,7 +58,7 @@ def __init__(
         mesh_port: int = settings.network.mesh_port,
         pairing_manager=None,
         audit_log=None,
-        config_dir: Optional[Path] = None,
+        config_dir: Path | None = None,
     ):
         import socket as _socket
 
@@ -78,12 +77,12 @@ def __init__(
         self._audit_log = audit_log
 
         self._hostname = _socket.gethostname()
-        self._peers: Dict[str, PeerInfo] = {}
-        self._discovery: Optional[MeshDiscovery] = None
-        self._peer_client: Optional[PeerClient] = None
-        self._reaper_task: Optional[asyncio.Task] = None
-        self._refresh_task: Optional[asyncio.Task] = None
-        self._cleanup_task: Optional[asyncio.Task] = None
+        self._peers: dict[str, PeerInfo] = {}
+        self._discovery: MeshDiscovery | None = None
+        self._peer_client: PeerClient | None = None
+        self._reaper_task: asyncio.Task | None = None
+        self._refresh_task: asyncio.Task | None = None
+        self._cleanup_task: asyncio.Task | None = None
 
         # Persistent verse map
         if config_dir is None:
@@ -121,7 +120,8 @@ async def on_start(self):
 
         # When our own status changes, broadcast a nudge to all peers
         self._status_unsub = self._event_bus.subscribe(
-            EventType.STATUS_CHANGED, self._on_local_status_changed,
+            EventType.STATUS_CHANGED,
+            self._on_local_status_changed,
         )
 
     async def on_stop(self):
@@ -156,7 +156,8 @@ def _on_peer_discovered(self, data: dict, sender_ip: str, verified: bool = False
         # Check if this peer is already trusted
         trusted = (
             self._pairing_manager.is_trusted(peer_id)
-            if self._pairing_manager else True  # no manager = trust all (backward compat)
+            if self._pairing_manager
+            else True  # no manager = trust all (backward compat)
         )
 
         # Determine TLS status — trusted peers with a cert fingerprint use TLS
@@ -187,24 +188,28 @@ def _on_peer_discovered(self, data: dict, sender_ip: str, verified: bool = False
         if was_offline:
             # Previously offline peer returned
             self._verse_map.on_peer_returned(peer_id)
-            self._emit_event(EventType.MESH_PEER_RETURNED, {
-                "instance_id": peer_id,
-                "hostname": peer.hostname,
-                "ip_address": sender_ip,
-                "is_trusted": trusted,
-            })
-            logger.info(
-                f"Mesh: peer returned {peer.hostname} ({peer_id[:8]}) at {sender_ip}"
+            self._emit_event(
+                EventType.MESH_PEER_RETURNED,
+                {
+                    "instance_id": peer_id,
+                    "hostname": peer.hostname,
+                    "ip_address": sender_ip,
+                    "is_trusted": trusted,
+                },
             )
+            logger.info(f"Mesh: peer returned {peer.hostname} ({peer_id[:8]}) at {sender_ip}")
         else:
-            self._emit_event(EventType.MESH_PEER_DISCOVERED, {
-                "instance_id": peer_id,
-                "hostname": peer.hostname,
-                "ip_address": sender_ip,
-                "is_trusted": trusted,
-                "udp_verified": verified,
-                "tls_enabled": tls_enabled,
-            })
+            self._emit_event(
+                EventType.MESH_PEER_DISCOVERED,
+                {
+                    "instance_id": peer_id,
+                    "hostname": peer.hostname,
+                    "ip_address": sender_ip,
+                    "is_trusted": trusted,
+                    "udp_verified": verified,
+                    "tls_enabled": tls_enabled,
+                },
+            )
             logger.info(
                 f"Mesh: discovered peer {peer.hostname} ({peer_id[:8]}) at {sender_ip} "
                 f"[trusted={trusted}, udp_verified={verified}, tls={tls_enabled}]"
@@ -257,20 +262,28 @@ async def _reaper_loop(self):
                     self._verse_map.on_peer_offline(pid)
                     if self._discovery:
                         self._discovery.forget_peer(pid)
-                    self._emit_event(EventType.MESH_PEER_OFFLINE, {
-                        "instance_id": pid,
-                        "hostname": peer.hostname,
-                    })
-                    logger.info(f"Mesh: peer offline {peer.hostname} ({pid[:8]}) — kept in verse map")
+                    self._emit_event(
+                        EventType.MESH_PEER_OFFLINE,
+                        {
+                            "instance_id": pid,
+                            "hostname": peer.hostname,
+                        },
+                    )
+                    logger.info(
+                        f"Mesh: peer offline {peer.hostname} ({pid[:8]}) — kept in verse map"
+                    )
                 else:
                     # Untrusted peer: fully remove
                     self._peers.pop(pid, None)
                     if self._discovery:
                         self._discovery.forget_peer(pid)
-                    self._emit_event(EventType.MESH_PEER_LOST, {
-                        "instance_id": pid,
-                        "hostname": peer.hostname,
-                    })
+                    self._emit_event(
+                        EventType.MESH_PEER_LOST,
+                        {
+                            "instance_id": pid,
+                            "hostname": peer.hostname,
+                        },
+                    )
                     logger.info(f"Mesh: lost peer {peer.hostname} ({pid[:8]})")
 
     async def _refresh_loop(self):
@@ -306,10 +319,13 @@ async def _fetch_and_update_peer(self, peer: PeerInfo):
         # Update verse map with latest capabilities
         self._verse_map.on_peer_updated(peer)
 
-        self._emit_event(EventType.MESH_PEER_UPDATED, {
-            "instance_id": peer.instance_id,
-            "hostname": peer.hostname,
-        })
+        self._emit_event(
+            EventType.MESH_PEER_UPDATED,
+            {
+                "instance_id": peer.instance_id,
+                "hostname": peer.hostname,
+            },
+        )
 
     # ------------------------------------------------------------------
     # Pairing integration
@@ -343,19 +359,19 @@ def mark_peer_trusted(self, instance_id: str):
     # Public query API
     # ------------------------------------------------------------------
 
-    def get_peers(self) -> List[PeerInfo]:
+    def get_peers(self) -> list[PeerInfo]:
         """Return all live (non-dead) peers."""
         return [p for p in self._peers.values() if not p.is_dead]
 
-    def get_all_peers(self) -> List[PeerInfo]:
+    def get_all_peers(self) -> list[PeerInfo]:
         """Return all tracked peers including stale/dead ones."""
         return list(self._peers.values())
 
-    def get_peer(self, instance_id: str) -> Optional[PeerInfo]:
+    def get_peer(self, instance_id: str) -> PeerInfo | None:
         """Get a specific peer by instance_id."""
         return self._peers.get(instance_id)
 
-    def find_peers_with(self, capability: str) -> List[PeerInfo]:
+    def find_peers_with(self, capability: str) -> list[PeerInfo]:
         """
         Find live peers that have a given capability flag.
 
@@ -386,11 +402,11 @@ def get_local_info(self) -> dict:
         }
 
     @property
-    def peer_client(self) -> Optional[PeerClient]:
+    def peer_client(self) -> PeerClient | None:
         """Expose the peer client for direct campaign operations."""
         return self._peer_client
 
-    def find_peer_by_hostname(self, hostname: str) -> Optional[PeerInfo]:
+    def find_peer_by_hostname(self, hostname: str) -> PeerInfo | None:
         """Find a live peer by hostname (case-insensitive)."""
         hostname_lower = hostname.lower()
         for p in self.get_peers():
diff --git a/gently/mesh/models.py b/gently/mesh/models.py
index 8c59877f..721525d0 100644
--- a/gently/mesh/models.py
+++ b/gently/mesh/models.py
@@ -14,13 +14,14 @@
 import time
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from ..settings import settings
 
 
 class PeerRole(str, Enum):
     """Dynamic roles a gently node can fill."""
+
     MICROSCOPE_CONTROLLER = "microscope_controller"
     ML_TRAINER = "ml_trainer"
     DATA_SERVER = "data_server"
@@ -30,6 +31,7 @@ class PeerRole(str, Enum):
 @dataclass
 class GpuInfo:
     """Details about a single GPU device."""
+
     device_index: int = 0
     name: str = ""
     vram_gb: float = 0.0
@@ -37,7 +39,7 @@ class GpuInfo:
     utilization_pct: float = 0.0
     memory_used_gb: float = 0.0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "device_index": self.device_index,
             "name": self.name,
@@ -48,7 +50,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "GpuInfo":
+    def from_dict(cls, d: dict[str, Any]) -> "GpuInfo":
         return cls(
             device_index=d.get("device_index", 0),
             name=d.get("name", ""),
@@ -62,16 +64,17 @@ def from_dict(cls, d: Dict[str, Any]) -> "GpuInfo":
 @dataclass
 class DatasetAdvertisement:
     """Advertises what data a node has available for training."""
+
     session_id: str = ""
     session_name: str = ""
     embryo_count: int = 0
     volume_count: int = 0
     has_ground_truth: bool = False
     ground_truth_count: int = 0
-    stages_covered: List[str] = field(default_factory=list)
+    stages_covered: list[str] = field(default_factory=list)
     total_size_gb: float = 0.0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "session_id": self.session_id,
             "session_name": self.session_name,
@@ -84,7 +87,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "DatasetAdvertisement":
+    def from_dict(cls, d: dict[str, Any]) -> "DatasetAdvertisement":
         return cls(
             session_id=d.get("session_id", ""),
             session_name=d.get("session_name", ""),
@@ -107,19 +110,19 @@ class PeerCapability:
     gpu_name: str = ""
     gpu_vram_gb: float = 0.0
     storage_free_gb: float = 0.0
-    tool_categories: List[str] = field(default_factory=list)
+    tool_categories: list[str] = field(default_factory=list)
     organism: str = ""
     hardware_profile: str = ""
     # Enhanced capability fields (backward-compatible — old peers get defaults)
-    gpus: List[GpuInfo] = field(default_factory=list)
-    roles: List[str] = field(default_factory=list)
-    datasets: List[DatasetAdvertisement] = field(default_factory=list)
+    gpus: list[GpuInfo] = field(default_factory=list)
+    roles: list[str] = field(default_factory=list)
+    datasets: list[DatasetAdvertisement] = field(default_factory=list)
     microscope_connected: bool = False
     cpu_cores: int = 0
     ram_gb: float = 0.0
     storage_total_gb: float = 0.0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "has_microscope": self.has_microscope,
             "has_sam": self.has_sam,
@@ -140,7 +143,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "PeerCapability":
+    def from_dict(cls, d: dict[str, Any]) -> "PeerCapability":
         return cls(
             has_microscope=d.get("has_microscope", False),
             has_sam=d.get("has_sam", False),
@@ -174,7 +177,7 @@ class PeerStatus:
     active_plan: str = ""
     version: str = ""
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "session_id": self.session_id,
             "acquisition_status": self.acquisition_status,
@@ -187,7 +190,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "PeerStatus":
+    def from_dict(cls, d: dict[str, Any]) -> "PeerStatus":
         return cls(
             session_id=d.get("session_id", ""),
             acquisition_status=d.get("acquisition_status", "idle"),
@@ -232,7 +235,7 @@ def is_dead(self) -> bool:
         """True if no heartbeat beyond the dead threshold."""
         return (time.time() - self.last_seen) > settings.mesh.dead_threshold_s
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "instance_id": self.instance_id,
             "hostname": self.hostname,
@@ -252,7 +255,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "PeerInfo":
+    def from_dict(cls, d: dict[str, Any]) -> "PeerInfo":
         return cls(
             instance_id=d.get("instance_id", ""),
             hostname=d.get("hostname", ""),
@@ -289,15 +292,15 @@ class PersistedPeer:
     # Persistence fields
     online: bool = True
     last_online: float = field(default_factory=time.time)
-    roles: List[str] = field(default_factory=list)
-    datasets: List[DatasetAdvertisement] = field(default_factory=list)
+    roles: list[str] = field(default_factory=list)
+    datasets: list[DatasetAdvertisement] = field(default_factory=list)
 
     @property
     def base_url(self) -> str:
         scheme = "https" if self.tls_enabled else "http"
         return f"{scheme}://{self.ip_address}:{self.viz_port}"
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "instance_id": self.instance_id,
             "hostname": self.hostname,
@@ -316,7 +319,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "PersistedPeer":
+    def from_dict(cls, d: dict[str, Any]) -> "PersistedPeer":
         return cls(
             instance_id=d.get("instance_id", ""),
             hostname=d.get("hostname", ""),
diff --git a/gently/mesh/pairing.py b/gently/mesh/pairing.py
index 32e939d5..e8eda9d9 100644
--- a/gently/mesh/pairing.py
+++ b/gently/mesh/pairing.py
@@ -24,7 +24,6 @@
 import uuid
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple
 
 logger = logging.getLogger(__name__)
 
@@ -71,7 +70,7 @@ class TrustedPeer:
     paired_at: str = ""  # ISO timestamp
     cert_fingerprint: str = ""  # SHA256 of peer's TLS cert (DER)
     udp_signing_key: str = ""  # hex-encoded key for UDP HMAC verification
-    scopes: List[str] = field(default_factory=lambda: list(ALL_SCOPES))
+    scopes: list[str] = field(default_factory=lambda: list(ALL_SCOPES))
 
 
 class PairingManager:
@@ -94,8 +93,8 @@ def __init__(self, instance_id: str, hostname: str, config_dir: Path, audit_log=
         self._config_dir = config_dir
         self._audit_log = audit_log
 
-        self._sessions: Dict[str, PairingSession] = {}
-        self._trusted: Dict[str, TrustedPeer] = {}  # keyed by instance_id
+        self._sessions: dict[str, PairingSession] = {}
+        self._trusted: dict[str, TrustedPeer] = {}  # keyed by instance_id
         self._trust_file = config_dir / "mesh_trusted_peers.json"
 
         # Phase 2: TLS cert fingerprint (set by launch_gently after cert gen)
@@ -109,7 +108,7 @@ def __init__(self, instance_id: str, hostname: str, config_dir: Path, audit_log=
         ).hexdigest()
 
         # Phase 2: rate limiting state
-        self._pair_attempts: Dict[str, List[float]] = {}  # IP -> timestamps
+        self._pair_attempts: dict[str, list[float]] = {}  # IP -> timestamps
 
         self._load_trusted()
 
@@ -163,7 +162,7 @@ def is_trusted(self, instance_id: str) -> bool:
         """Check if a peer is trusted."""
         return instance_id in self._trusted
 
-    def get_token_for_peer(self, instance_id: str) -> Optional[str]:
+    def get_token_for_peer(self, instance_id: str) -> str | None:
         """Get the current daily auth token for a trusted peer."""
         tp = self._trusted.get(instance_id)
         if tp is None:
@@ -171,7 +170,7 @@ def get_token_for_peer(self, instance_id: str) -> Optional[str]:
         epoch_day = self._current_epoch_day()
         return self._derive_daily_token(tp.base_token, epoch_day)
 
-    def verify_token(self, token: str) -> Optional[str]:
+    def verify_token(self, token: str) -> str | None:
         """
         Check if a token matches any trusted peer (timing-safe).
 
@@ -186,26 +185,26 @@ def verify_token(self, token: str) -> Optional[str]:
                 return tp.instance_id
         return None
 
-    def get_all_trusted(self) -> List[TrustedPeer]:
+    def get_all_trusted(self) -> list[TrustedPeer]:
         """Return all trusted peers."""
         return list(self._trusted.values())
 
-    def get_udp_key_for_peer(self, instance_id: str) -> Optional[str]:
+    def get_udp_key_for_peer(self, instance_id: str) -> str | None:
         """Get the UDP signing key for a trusted peer."""
         tp = self._trusted.get(instance_id)
         return tp.udp_signing_key if tp else None
 
-    def get_cert_fingerprint_for_peer(self, instance_id: str) -> Optional[str]:
+    def get_cert_fingerprint_for_peer(self, instance_id: str) -> str | None:
         """Get the TLS cert fingerprint for a trusted peer."""
         tp = self._trusted.get(instance_id)
         return tp.cert_fingerprint if tp else None
 
-    def get_scopes_for_peer(self, instance_id: str) -> List[str]:
+    def get_scopes_for_peer(self, instance_id: str) -> list[str]:
         """Get the permission scopes for a trusted peer."""
         tp = self._trusted.get(instance_id)
         return list(tp.scopes) if tp else []
 
-    def set_scopes(self, identifier: str, scopes: List[str]) -> bool:
+    def set_scopes(self, identifier: str, scopes: list[str]) -> bool:
         """
         Set permission scopes for a peer (by instance_id, prefix, or hostname).
 
@@ -269,8 +268,10 @@ def unpair(self, identifier: str) -> bool:
             self._save_trusted()
             if self._audit_log:
                 from .audit import AuditEvent
+
                 self._audit_log.log(
-                    AuditEvent.PEER_UNPAIRED, outcome="info",
+                    AuditEvent.PEER_UNPAIRED,
+                    outcome="info",
                     peer_id=removed_id,
                 )
             return True
@@ -281,7 +282,7 @@ def unpair(self, identifier: str) -> bool:
     # Rate limiting
     # ------------------------------------------------------------------
 
-    def check_rate_limit(self, ip: str) -> Tuple[bool, float]:
+    def check_rate_limit(self, ip: str) -> tuple[bool, float]:
         """
         Check if a pairing attempt from this IP is allowed.
 
@@ -298,9 +299,12 @@ def check_rate_limit(self, ip: str) -> Tuple[bool, float]:
             retry_after = RATE_LIMIT_WINDOW - (now - attempts[0])
             if self._audit_log:
                 from .audit import AuditEvent
+
                 self._audit_log.log(
-                    AuditEvent.RATE_LIMITED, outcome="deny",
-                    ip=ip, detail=f"max_attempts={RATE_LIMIT_MAX}",
+                    AuditEvent.RATE_LIMITED,
+                    outcome="deny",
+                    ip=ip,
+                    detail=f"max_attempts={RATE_LIMIT_MAX}",
                 )
             return False, max(retry_after, 1.0)
 
@@ -312,9 +316,12 @@ def check_rate_limit(self, ip: str) -> Tuple[bool, float]:
             if elapsed < backoff:
                 if self._audit_log:
                     from .audit import AuditEvent
+
                     self._audit_log.log(
-                        AuditEvent.RATE_LIMITED, outcome="deny",
-                        ip=ip, detail=f"backoff={backoff:.1f}s",
+                        AuditEvent.RATE_LIMITED,
+                        outcome="deny",
+                        ip=ip,
+                        detail=f"backoff={backoff:.1f}s",
                     )
                 return False, backoff - elapsed
 
@@ -405,7 +412,7 @@ def handle_pair_request(
     # Confirmation
     # ------------------------------------------------------------------
 
-    def confirm_pairing(self, pairing_id: str, confirmer_id: str) -> Optional[PairingSession]:
+    def confirm_pairing(self, pairing_id: str, confirmer_id: str) -> PairingSession | None:
         """
         Mark one side as confirmed.
 
@@ -428,36 +435,39 @@ def confirm_pairing(self, pairing_id: str, confirmer_id: str) -> Optional[Pairin
 
         return session
 
-    def reject_pairing(self, pairing_id: str) -> Optional[PairingSession]:
+    def reject_pairing(self, pairing_id: str) -> PairingSession | None:
         """Reject a pending pairing session."""
         session = self._sessions.get(pairing_id)
         if session and session.status == "pending":
             session.status = "rejected"
             if self._audit_log:
                 from .audit import AuditEvent
+
                 self._audit_log.log(
-                    AuditEvent.PAIR_REJECTED, outcome="deny",
+                    AuditEvent.PAIR_REJECTED,
+                    outcome="deny",
                     peer_id=session.initiator_id,
                 )
         return session
 
-    def get_session(self, pairing_id: str) -> Optional[PairingSession]:
+    def get_session(self, pairing_id: str) -> PairingSession | None:
         """Get a pairing session by ID."""
         return self._sessions.get(pairing_id)
 
-    def get_pending_sessions(self) -> List[PairingSession]:
+    def get_pending_sessions(self) -> list[PairingSession]:
         """Get all pending pairing sessions (for /pair accept)."""
         return [
-            s for s in self._sessions.values()
-            if s.status == "pending"
-            and s.responder_id == self.instance_id
+            s
+            for s in self._sessions.values()
+            if s.status == "pending" and s.responder_id == self.instance_id
         ]
 
     def cleanup_expired(self):
         """Remove expired pending sessions."""
         now = time.time()
         expired = [
-            pid for pid, s in self._sessions.items()
+            pid
+            for pid, s in self._sessions.items()
             if s.status == "pending" and (now - s.created_at) > PAIRING_EXPIRY
         ]
         for pid in expired:
@@ -497,9 +507,12 @@ def _finalize_pairing(self, session: PairingSession):
         logger.info(f"Paired with {peer_hostname} ({peer_id[:8]})")
         if self._audit_log:
             from .audit import AuditEvent
+
             self._audit_log.log(
-                AuditEvent.PAIR_COMPLETED, outcome="info",
-                peer_id=peer_id, detail=f"hostname={peer_hostname}",
+                AuditEvent.PAIR_COMPLETED,
+                outcome="info",
+                peer_id=peer_id,
+                detail=f"hostname={peer_hostname}",
             )
 
     def _load_trusted(self):
diff --git a/gently/mesh/peer_client.py b/gently/mesh/peer_client.py
index c0b1be5e..c6db282b 100644
--- a/gently/mesh/peer_client.py
+++ b/gently/mesh/peer_client.py
@@ -10,12 +10,12 @@
 import asyncio
 import logging
 import ssl
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import aiohttp
 
-from .models import PeerInfo
 from ..settings import settings
+from .models import PeerInfo
 
 logger = logging.getLogger(__name__)
 
@@ -24,7 +24,7 @@ class PeerClient:
     """Fetches full status from a peer's viz server over HTTP."""
 
     def __init__(self, pairing_manager=None, audit_log=None):
-        self._session: Optional[aiohttp.ClientSession] = None
+        self._session: aiohttp.ClientSession | None = None
         self._pairing_manager = pairing_manager
         self._audit_log = audit_log
         self._pinning_verified: set = set()  # track first-success per peer
@@ -40,7 +40,7 @@ async def _ensure_session(self):
             self._session = aiohttp.ClientSession(timeout=timeout, connector=connector)
             self._pinning_verified.clear()
 
-    def _auth_headers(self, peer: PeerInfo) -> Dict[str, str]:
+    def _auth_headers(self, peer: PeerInfo) -> dict[str, str]:
         """Build auth headers for a trusted peer."""
         if self._pairing_manager is None:
             return {}
@@ -59,16 +59,13 @@ def _ssl_for_peer(self, peer: PeerInfo):
         """
         if self._pairing_manager is None:
             return False
-        fingerprint = self._pairing_manager.get_cert_fingerprint_for_peer(
-            peer.instance_id
-        )
+        fingerprint = self._pairing_manager.get_cert_fingerprint_for_peer(peer.instance_id)
         if fingerprint:
             try:
                 return aiohttp.Fingerprint(bytes.fromhex(fingerprint))
             except (ValueError, TypeError):
                 logger.warning(
-                    f"Invalid cert fingerprint for {peer.instance_id[:8]}, "
-                    "falling back to unpinned"
+                    f"Invalid cert fingerprint for {peer.instance_id[:8]}, falling back to unpinned"
                 )
         return False
 
@@ -78,9 +75,12 @@ def _log_pinning_success(self, peer: PeerInfo, ssl_fp):
             self._pinning_verified.add(peer.instance_id)
             if self._audit_log:
                 from .audit import AuditEvent
+
                 self._audit_log.log(
-                    AuditEvent.CERT_PIN_OK, outcome="allow",
-                    peer_id=peer.instance_id, ip=peer.ip_address,
+                    AuditEvent.CERT_PIN_OK,
+                    outcome="allow",
+                    peer_id=peer.instance_id,
+                    ip=peer.ip_address,
                 )
 
     def _log_pinning_failure(self, peer: PeerInfo, error):
@@ -88,13 +88,16 @@ def _log_pinning_failure(self, peer: PeerInfo, error):
         logger.warning(f"CERT PINNING FAILED for {peer.instance_id[:8]}: {error}")
         if self._audit_log:
             from .audit import AuditEvent
+
             self._audit_log.log(
-                AuditEvent.CERT_PIN_FAIL, outcome="deny",
-                peer_id=peer.instance_id, ip=peer.ip_address,
+                AuditEvent.CERT_PIN_FAIL,
+                outcome="deny",
+                peer_id=peer.instance_id,
+                ip=peer.ip_address,
                 detail=str(error),
             )
 
-    async def fetch_peer_info(self, peer: PeerInfo) -> Optional[Dict[str, Any]]:
+    async def fetch_peer_info(self, peer: PeerInfo) -> dict[str, Any] | None:
         """
         GET /api/mesh/status from a peer.
 
@@ -109,9 +112,7 @@ async def fetch_peer_info(self, peer: PeerInfo) -> Optional[Dict[str, Any]]:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     return await resp.json()
-                logger.debug(
-                    f"Peer {peer.instance_id[:8]} returned HTTP {resp.status}"
-                )
+                logger.debug(f"Peer {peer.instance_id[:8]} returned HTTP {resp.status}")
         except aiohttp.ServerFingerprintMismatch as e:
             self._log_pinning_failure(peer, e)
         except (aiohttp.ClientError, asyncio.TimeoutError, OSError) as e:
@@ -123,7 +124,7 @@ async def fetch_peer_info(self, peer: PeerInfo) -> Optional[Dict[str, Any]]:
     # Campaign coordination methods
     # ------------------------------------------------------------------
 
-    async def fetch_peer_campaigns(self, peer: PeerInfo) -> Optional[List]:
+    async def fetch_peer_campaigns(self, peer: PeerInfo) -> list | None:
         """GET /api/campaigns from a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns"
@@ -141,7 +142,7 @@ async def fetch_peer_campaigns(self, peer: PeerInfo) -> Optional[List]:
             logger.debug(f"Failed to fetch campaigns from {peer.instance_id[:8]}: {e}")
         return None
 
-    async def fetch_campaign_export(self, peer: PeerInfo, campaign_id: str) -> Optional[Dict]:
+    async def fetch_campaign_export(self, peer: PeerInfo, campaign_id: str) -> dict | None:
         """GET /api/campaigns/{id}/export from a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/export"
@@ -159,7 +160,11 @@ async def fetch_campaign_export(self, peer: PeerInfo, campaign_id: str) -> Optio
         return None
 
     async def join_campaign(
-        self, peer: PeerInfo, campaign_id: str, instance_id: str, hostname: str,
+        self,
+        peer: PeerInfo,
+        campaign_id: str,
+        instance_id: str,
+        hostname: str,
     ) -> bool:
         """POST /api/campaigns/{id}/join on a peer."""
         await self._ensure_session()
@@ -167,10 +172,15 @@ async def join_campaign(
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.post(url, json={
-                "instance_id": instance_id,
-                "hostname": hostname,
-            }, headers=headers, ssl=ssl_fp) as resp:
+            async with self._session.post(
+                url,
+                json={
+                    "instance_id": instance_id,
+                    "hostname": hostname,
+                },
+                headers=headers,
+                ssl=ssl_fp,
+            ) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                 return resp.status == 200
@@ -194,10 +204,15 @@ async def claim_item(
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.post(url, json={
-                "instance_id": instance_id,
-                "hostname": hostname,
-            }, headers=headers, ssl=ssl_fp) as resp:
+            async with self._session.post(
+                url,
+                json={
+                    "instance_id": instance_id,
+                    "hostname": hostname,
+                },
+                headers=headers,
+                ssl=ssl_fp,
+            ) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                 return resp.status == 200
@@ -208,7 +223,10 @@ async def claim_item(
         return False
 
     async def unclaim_item(
-        self, peer: PeerInfo, campaign_id: str, item_id: str,
+        self,
+        peer: PeerInfo,
+        campaign_id: str,
+        item_id: str,
     ) -> bool:
         """POST /api/campaigns/{id}/items/{item_id}/unclaim on a peer."""
         await self._ensure_session()
@@ -232,12 +250,12 @@ async def update_item_status(
         campaign_id: str,
         item_id: str,
         status: str,
-        outcome: Optional[str] = None,
+        outcome: str | None = None,
     ) -> bool:
         """POST /api/campaigns/{id}/items/{item_id}/status on a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/items/{item_id}/status"
-        body: Dict[str, Any] = {"status": status}
+        body: dict[str, Any] = {"status": status}
         if outcome is not None:
             body["outcome"] = outcome
         headers = self._auth_headers(peer)
@@ -258,9 +276,14 @@ async def update_item_status(
     # ------------------------------------------------------------------
 
     async def send_pair_request(
-        self, peer: PeerInfo, initiator_id: str, hostname: str, nonce: str,
-        cert_fingerprint: str = "", udp_sign_key: str = "",
-    ) -> Optional[Dict]:
+        self,
+        peer: PeerInfo,
+        initiator_id: str,
+        hostname: str,
+        nonce: str,
+        cert_fingerprint: str = "",
+        udp_sign_key: str = "",
+    ) -> dict | None:
         """POST /api/mesh/pair — initiate pairing with a peer.
 
         Returns response dict on success, or {"_error": "..."} on failure.
@@ -278,8 +301,9 @@ async def send_pair_request(
         base = f"{peer.ip_address}:{peer.viz_port}"
         return {"_error": f"Could not reach {base} via HTTPS or HTTP"}
 
-    async def _pairing_request(self, peer: PeerInfo, method: str, path: str,
-                               json_body: Optional[Dict] = None) -> Optional[Dict]:
+    async def _pairing_request(
+        self, peer: PeerInfo, method: str, path: str, json_body: dict | None = None
+    ) -> dict | None:
         """Make an HTTP request trying HTTPS first, then HTTP (for pre-pairing)."""
         await self._ensure_session()
         base = f"{peer.ip_address}:{peer.viz_port}"
@@ -297,18 +321,25 @@ async def _pairing_request(self, peer: PeerInfo, method: str, path: str,
                 continue
         return None
 
-    async def poll_pair_status(self, peer: PeerInfo, pairing_id: str) -> Optional[Dict]:
+    async def poll_pair_status(self, peer: PeerInfo, pairing_id: str) -> dict | None:
         """GET /api/mesh/pair/{id}/status — poll pairing status."""
         return await self._pairing_request(
-            peer, "GET", f"/api/mesh/pair/{pairing_id}/status",
+            peer,
+            "GET",
+            f"/api/mesh/pair/{pairing_id}/status",
         )
 
     async def confirm_pair_remote(
-        self, peer: PeerInfo, pairing_id: str, confirmer_id: str,
+        self,
+        peer: PeerInfo,
+        pairing_id: str,
+        confirmer_id: str,
     ) -> bool:
         """POST /api/mesh/pair/{id}/confirm — confirm pairing on remote side."""
         resp = await self._pairing_request(
-            peer, "POST", f"/api/mesh/pair/{pairing_id}/confirm",
+            peer,
+            "POST",
+            f"/api/mesh/pair/{pairing_id}/confirm",
             json_body={"confirmer_id": confirmer_id},
         )
         return resp is not None
@@ -317,7 +348,7 @@ async def confirm_pair_remote(
     # Data catalog methods (Phase 2 — requires "data" scope)
     # ------------------------------------------------------------------
 
-    async def fetch_peer_sessions(self, peer: PeerInfo) -> Optional[List]:
+    async def fetch_peer_sessions(self, peer: PeerInfo) -> list | None:
         """GET /api/data/sessions from a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/data/sessions"
@@ -335,7 +366,7 @@ async def fetch_peer_sessions(self, peer: PeerInfo) -> Optional[List]:
             logger.debug(f"Failed to fetch sessions from {peer.instance_id[:8]}: {e}")
         return None
 
-    async def fetch_peer_session_detail(self, peer: PeerInfo, session_id: str) -> Optional[Dict]:
+    async def fetch_peer_session_detail(self, peer: PeerInfo, session_id: str) -> dict | None:
         """GET /api/data/sessions/{id} from a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/data/sessions/{session_id}"
@@ -352,7 +383,7 @@ async def fetch_peer_session_detail(self, peer: PeerInfo, session_id: str) -> Op
             logger.debug(f"Failed to fetch session detail from {peer.instance_id[:8]}: {e}")
         return None
 
-    async def fetch_peer_coverage(self, peer: PeerInfo) -> Optional[Dict]:
+    async def fetch_peer_coverage(self, peer: PeerInfo) -> dict | None:
         """GET /api/data/coverage from a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/data/coverage"
@@ -369,7 +400,7 @@ async def fetch_peer_coverage(self, peer: PeerInfo) -> Optional[Dict]:
             logger.debug(f"Failed to fetch coverage from {peer.instance_id[:8]}: {e}")
         return None
 
-    async def fetch_peer_stage_distribution(self, peer: PeerInfo) -> Optional[Dict]:
+    async def fetch_peer_stage_distribution(self, peer: PeerInfo) -> dict | None:
         """GET /api/data/stages from a peer."""
         await self._ensure_session()
         url = f"{peer.base_url}/api/data/stages"
diff --git a/gently/mesh/routes.py b/gently/mesh/routes.py
index 1308340e..2f0edd38 100644
--- a/gently/mesh/routes.py
+++ b/gently/mesh/routes.py
@@ -51,15 +51,21 @@ async def require_mesh_auth(request: Request):
                         if required_scope not in scopes:
                             if audit_log:
                                 audit_log.log(
-                                    AuditEvent.SCOPE_DENIED, outcome="deny",
-                                    peer_id=peer_id, ip=host,
+                                    AuditEvent.SCOPE_DENIED,
+                                    outcome="deny",
+                                    peer_id=peer_id,
+                                    ip=host,
                                     detail=f"scope={required_scope} path={request.url.path}",
                                 )
                             if viz_server.event_bus is not None:
                                 viz_server.event_bus.publish(
                                     EventType.MESH_SCOPE_DENIED,
-                                    {"peer_id": peer_id, "scope": required_scope,
-                                     "ip": host, "path": str(request.url.path)},
+                                    {
+                                        "peer_id": peer_id,
+                                        "scope": required_scope,
+                                        "ip": host,
+                                        "path": str(request.url.path),
+                                    },
                                     source="mesh",
                                 )
                             raise HTTPException(
@@ -68,16 +74,20 @@ async def require_mesh_auth(request: Request):
                             )
                     if audit_log:
                         audit_log.log(
-                            AuditEvent.AUTH_SUCCESS, outcome="allow",
-                            peer_id=peer_id, ip=host,
+                            AuditEvent.AUTH_SUCCESS,
+                            outcome="allow",
+                            peer_id=peer_id,
+                            ip=host,
                         )
                     return
 
             # Auth failed
             if audit_log:
                 audit_log.log(
-                    AuditEvent.AUTH_FAILURE, outcome="deny",
-                    ip=host, detail=f"path={request.url.path}",
+                    AuditEvent.AUTH_FAILURE,
+                    outcome="deny",
+                    ip=host,
+                    detail=f"path={request.url.path}",
                 )
             if viz_server.event_bus is not None:
                 viz_server.event_bus.publish(
@@ -106,13 +116,15 @@ async def mesh_status():
                 shared_list = []
                 for c in shared:
                     status = cs.get_plan_status(c.id)
-                    shared_list.append({
-                        "id": c.id,
-                        "shorthand": c.shorthand,
-                        "description": c.description,
-                        "item_count": status["total"],
-                        "completed_count": status["completed"],
-                    })
+                    shared_list.append(
+                        {
+                            "id": c.id,
+                            "shorthand": c.shorthand,
+                            "description": c.description,
+                            "item_count": status["total"],
+                            "completed_count": status["completed"],
+                        }
+                    )
                 info["shared_campaigns"] = shared_list
             except Exception:
                 pass
@@ -123,12 +135,17 @@ async def mesh_status():
     async def mesh_peers():
         """List all discovered peers."""
         peers = mesh_service.get_peers()
-        return JSONResponse({
-            "peers": [p.to_dict() for p in peers],
-            "count": len(peers),
-        })
+        return JSONResponse(
+            {
+                "peers": [p.to_dict() for p in peers],
+                "count": len(peers),
+            }
+        )
 
-    @router.get("/api/mesh/peers/{instance_id}", dependencies=[Depends(_make_auth_dep("status"))])
+    @router.get(
+        "/api/mesh/peers/{instance_id}",
+        dependencies=[Depends(_make_auth_dep("status"))],
+    )
     async def mesh_peer_detail(instance_id: str):
         """Get specific peer details."""
         peer = mesh_service.get_peer(instance_id)
@@ -144,11 +161,13 @@ async def mesh_topology():
         """Full mesh view: self + all peers."""
         local = mesh_service.get_local_info()
         peers = mesh_service.get_all_peers()
-        return JSONResponse({
-            "self": local,
-            "peers": [p.to_dict() for p in peers],
-            "total_nodes": 1 + len(peers),
-        })
+        return JSONResponse(
+            {
+                "self": local,
+                "peers": [p.to_dict() for p in peers],
+                "total_nodes": 1 + len(peers),
+            }
+        )
 
     # ------------------------------------------------------------------
     # Pairing endpoints (no auth — these bootstrap trust)
@@ -181,15 +200,19 @@ async def pair_request(request: Request):
             raise HTTPException(status_code=400, detail="initiator_id and nonce required")
 
         session = pairing_mgr.handle_pair_request(
-            initiator_id, hostname, nonce,
+            initiator_id,
+            hostname,
+            nonce,
             initiator_cert_fingerprint=initiator_cert_fp,
             initiator_udp_sign_key=initiator_udp_key,
         )
 
         if audit_log:
             audit_log.log(
-                AuditEvent.PAIR_REQUESTED, outcome="info",
-                peer_id=initiator_id, ip=client_ip,
+                AuditEvent.PAIR_REQUESTED,
+                outcome="info",
+                peer_id=initiator_id,
+                ip=client_ip,
                 detail=f"hostname={hostname}",
             )
 
@@ -205,15 +228,17 @@ async def pair_request(request: Request):
                 source="mesh",
             )
 
-        return JSONResponse({
-            "nonce": session.nonce_responder,
-            "pairing_id": session.pairing_id,
-            "status": session.status,
-            "responder_id": mesh_service.instance_id,
-            "responder_hostname": mesh_service._hostname,
-            "cert_fingerprint": pairing_mgr.cert_fingerprint,
-            "udp_sign_key": pairing_mgr.udp_sign_key,
-        })
+        return JSONResponse(
+            {
+                "nonce": session.nonce_responder,
+                "pairing_id": session.pairing_id,
+                "status": session.status,
+                "responder_id": mesh_service.instance_id,
+                "responder_hostname": mesh_service._hostname,
+                "cert_fingerprint": pairing_mgr.cert_fingerprint,
+                "udp_sign_key": pairing_mgr.udp_sign_key,
+            }
+        )
 
     @router.get("/api/mesh/pair/{pairing_id}/status")
     async def pair_status(pairing_id: str):
@@ -225,12 +250,14 @@ async def pair_status(pairing_id: str):
         if session is None:
             raise HTTPException(status_code=404, detail="Pairing session not found")
 
-        return JSONResponse({
-            "pairing_id": session.pairing_id,
-            "status": session.status,
-            "confirmed_by_initiator": session.confirmed_by_initiator,
-            "confirmed_by_responder": session.confirmed_by_responder,
-        })
+        return JSONResponse(
+            {
+                "pairing_id": session.pairing_id,
+                "status": session.status,
+                "confirmed_by_initiator": session.confirmed_by_initiator,
+                "confirmed_by_responder": session.confirmed_by_responder,
+            }
+        )
 
     @router.post("/api/mesh/pair/{pairing_id}/confirm")
     async def pair_confirm(pairing_id: str, request: Request):
@@ -267,10 +294,12 @@ async def pair_confirm(pairing_id: str, request: Request):
                     source="mesh",
                 )
 
-        return JSONResponse({
-            "pairing_id": session.pairing_id,
-            "status": session.status,
-        })
+        return JSONResponse(
+            {
+                "pairing_id": session.pairing_id,
+                "status": session.status,
+            }
+        )
 
     @router.post("/api/mesh/pair/{pairing_id}/reject")
     async def pair_reject(pairing_id: str):
@@ -282,10 +311,12 @@ async def pair_reject(pairing_id: str):
         if session is None:
             raise HTTPException(status_code=404, detail="Pairing session not found")
 
-        return JSONResponse({
-            "pairing_id": session.pairing_id,
-            "status": session.status,
-        })
+        return JSONResponse(
+            {
+                "pairing_id": session.pairing_id,
+                "status": session.status,
+            }
+        )
 
     # ------------------------------------------------------------------
     # Verse map routes (scope: status)
@@ -296,12 +327,14 @@ async def verse_map():
         """Full persistent topology — includes offline peers."""
         vm = mesh_service.verse_map
         peers = vm.get_all_peers()
-        return JSONResponse({
-            "peers": [p.to_dict() for p in peers],
-            "online_count": len(vm.get_online_peers()),
-            "offline_count": len(vm.get_offline_peers()),
-            "total_count": len(peers),
-        })
+        return JSONResponse(
+            {
+                "peers": [p.to_dict() for p in peers],
+                "online_count": len(vm.get_online_peers()),
+                "offline_count": len(vm.get_offline_peers()),
+                "total_count": len(peers),
+            }
+        )
 
     @router.get(
         "/api/mesh/verse-map/resources/{capability}",
@@ -311,11 +344,13 @@ async def verse_map_resources(capability: str):
         """Find peers matching a capability (route-finding)."""
         vm = mesh_service.verse_map
         peers = vm.find_resource(capability)
-        return JSONResponse({
-            "capability": capability,
-            "peers": [p.to_dict() for p in peers],
-            "count": len(peers),
-        })
+        return JSONResponse(
+            {
+                "capability": capability,
+                "peers": [p.to_dict() for p in peers],
+                "count": len(peers),
+            }
+        )
 
     # ------------------------------------------------------------------
     # Data catalog routes (scope: data)
@@ -334,25 +369,32 @@ async def data_sessions():
                 sid = s.session_id if hasattr(s, "session_id") else s.get("session_id", "")
                 name = s.name if hasattr(s, "name") else s.get("name", "")
                 created = s.created_at if hasattr(s, "created_at") else s.get("created_at", "")
-                last_active = s.last_active if hasattr(s, "last_active") else s.get("last_active", "")
+                last_active = (
+                    s.last_active if hasattr(s, "last_active") else s.get("last_active", "")
+                )
                 embryos = store.list_embryos(sid)
                 vol_count = 0
                 for e in embryos:
                     eid = e.embryo_id if hasattr(e, "embryo_id") else e.get("embryo_id", "")
                     vol_count += len(store.list_volumes(sid, eid))
-                result.append({
-                    "session_id": sid,
-                    "name": name,
-                    "embryo_count": len(embryos),
-                    "volume_count": vol_count,
-                    "created_at": created,
-                    "last_active": last_active,
-                })
+                result.append(
+                    {
+                        "session_id": sid,
+                        "name": name,
+                        "embryo_count": len(embryos),
+                        "volume_count": vol_count,
+                        "created_at": created,
+                        "last_active": last_active,
+                    }
+                )
             return JSONResponse({"sessions": result, "count": len(result)})
         except Exception as e:
             return JSONResponse({"error": str(e)}, status_code=500)
 
-    @router.get("/api/data/sessions/{session_id}", dependencies=[Depends(_make_auth_dep("data"))])
+    @router.get(
+        "/api/data/sessions/{session_id}",
+        dependencies=[Depends(_make_auth_dep("data"))],
+    )
     async def data_session_detail(session_id: str):
         """Detailed session info with embryo list."""
         store = getattr(viz_server, "gently_store", None)
@@ -376,26 +418,29 @@ async def data_session_detail(session_id: str):
                 try:
                     gts = store.get_ground_truth(session_id, eid)
                     has_gt = len(gts) > 0
-                    stages = list({
-                        (gt.stage if hasattr(gt, "stage") else gt.get("stage", ""))
-                        for gt in gts
-                    })
+                    stages = list(
+                        {(gt.stage if hasattr(gt, "stage") else gt.get("stage", "")) for gt in gts}
+                    )
                 except Exception:
                     pass
-                embryo_list.append({
-                    "embryo_id": eid,
-                    "nickname": nickname,
-                    "volume_count": vol_count,
-                    "has_ground_truth": has_gt,
-                    "stages_annotated": stages,
-                })
+                embryo_list.append(
+                    {
+                        "embryo_id": eid,
+                        "nickname": nickname,
+                        "volume_count": vol_count,
+                        "has_ground_truth": has_gt,
+                        "stages_annotated": stages,
+                    }
+                )
             sname = session.name if hasattr(session, "name") else session.get("name", "")
-            return JSONResponse({
-                "session_id": session_id,
-                "name": sname,
-                "embryos": embryo_list,
-                "total_volumes": total_vols,
-            })
+            return JSONResponse(
+                {
+                    "session_id": session_id,
+                    "name": sname,
+                    "embryos": embryo_list,
+                    "total_volumes": total_vols,
+                }
+            )
         except HTTPException:
             raise
         except Exception as e:
@@ -406,10 +451,16 @@ async def data_coverage():
         """Annotation coverage summary across all sessions."""
         store = getattr(viz_server, "gently_store", None)
         if store is None:
-            return JSONResponse({
-                "total_embryos": 0, "annotated_embryos": 0,
-                "coverage_pct": 0.0, "stage_counts": {}, "imbalance_ratio": 0.0, "gaps": [],
-            })
+            return JSONResponse(
+                {
+                    "total_embryos": 0,
+                    "annotated_embryos": 0,
+                    "coverage_pct": 0.0,
+                    "stage_counts": {},
+                    "imbalance_ratio": 0.0,
+                    "gaps": [],
+                }
+            )
         try:
             sessions = store.list_sessions()
             total_embryos = 0
@@ -437,14 +488,16 @@ async def data_coverage():
             # Find stages with notably low counts
             avg = sum(counts) / len(counts) if counts else 0
             gaps = [s for s, c in stage_counts.items() if c < avg * 0.5]
-            return JSONResponse({
-                "total_embryos": total_embryos,
-                "annotated_embryos": annotated_embryos,
-                "coverage_pct": round(coverage_pct, 1),
-                "stage_counts": stage_counts,
-                "imbalance_ratio": round(imbalance_ratio, 2),
-                "gaps": gaps,
-            })
+            return JSONResponse(
+                {
+                    "total_embryos": total_embryos,
+                    "annotated_embryos": annotated_embryos,
+                    "coverage_pct": round(coverage_pct, 1),
+                    "stage_counts": stage_counts,
+                    "imbalance_ratio": round(imbalance_ratio, 2),
+                    "gaps": gaps,
+                }
+            )
         except Exception as e:
             return JSONResponse({"error": str(e)}, status_code=500)
 
@@ -475,10 +528,12 @@ async def data_stages():
                         pass
                 if session_dist:
                     by_session[sid] = session_dist
-            return JSONResponse({
-                "stage_distribution": total_dist,
-                "by_session": by_session,
-            })
+            return JSONResponse(
+                {
+                    "stage_distribution": total_dist,
+                    "by_session": by_session,
+                }
+            )
         except Exception as e:
             return JSONResponse({"error": str(e)}, status_code=500)
 
diff --git a/gently/mesh/tls.py b/gently/mesh/tls.py
index 9d1ec01c..412cc485 100644
--- a/gently/mesh/tls.py
+++ b/gently/mesh/tls.py
@@ -12,7 +12,6 @@
 import logging
 import ssl
 from pathlib import Path
-from typing import Optional, Tuple
 
 logger = logging.getLogger(__name__)
 
@@ -21,7 +20,7 @@
 CERT_DAYS = 3650  # ~10 years
 
 
-def ensure_tls_cert(config_dir: Path) -> Tuple[Optional[Path], Optional[Path]]:
+def ensure_tls_cert(config_dir: Path) -> tuple[Path | None, Path | None]:
     """
     Ensure a TLS cert/key pair exists in config_dir.
 
@@ -51,9 +50,11 @@ def ensure_tls_cert(config_dir: Path) -> Tuple[Optional[Path], Optional[Path]]:
         private_key = ec.generate_private_key(ec.SECP256R1())
 
         now = datetime.datetime.now(datetime.timezone.utc)
-        subject = issuer = x509.Name([
-            x509.NameAttribute(NameOID.COMMON_NAME, "gently-mesh"),
-        ])
+        subject = issuer = x509.Name(
+            [
+                x509.NameAttribute(NameOID.COMMON_NAME, "gently-mesh"),
+            ]
+        )
 
         cert = (
             x509.CertificateBuilder()
@@ -64,20 +65,24 @@ def ensure_tls_cert(config_dir: Path) -> Tuple[Optional[Path], Optional[Path]]:
             .not_valid_before(now)
             .not_valid_after(now + datetime.timedelta(days=CERT_DAYS))
             .add_extension(
-                x509.SubjectAlternativeName([
-                    x509.IPAddress(ipaddress.IPv4Address("0.0.0.0")),
-                ]),
+                x509.SubjectAlternativeName(
+                    [
+                        x509.IPAddress(ipaddress.IPv4Address("0.0.0.0")),
+                    ]
+                ),
                 critical=False,
             )
             .sign(private_key, hashes.SHA256())
         )
 
         # Write PEM files
-        key_path.write_bytes(private_key.private_bytes(
-            encoding=serialization.Encoding.PEM,
-            format=serialization.PrivateFormat.PKCS8,
-            encryption_algorithm=serialization.NoEncryption(),
-        ))
+        key_path.write_bytes(
+            private_key.private_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PrivateFormat.PKCS8,
+                encryption_algorithm=serialization.NoEncryption(),
+            )
+        )
         cert_path.write_bytes(cert.public_bytes(serialization.Encoding.PEM))
 
         logger.info(f"Generated TLS cert: {cert_path}")
@@ -85,8 +90,7 @@ def ensure_tls_cert(config_dir: Path) -> Tuple[Optional[Path], Optional[Path]]:
 
     except ImportError:
         logger.warning(
-            "cryptography package not installed — TLS disabled "
-            "(pip install cryptography)"
+            "cryptography package not installed — TLS disabled (pip install cryptography)"
         )
         return None, None
     except Exception as e:
@@ -114,7 +118,8 @@ def get_cert_fingerprint(cert_path: Path) -> str:
 
 
 def build_server_ssl_context(
-    cert_path: Path, key_path: Path,
+    cert_path: Path,
+    key_path: Path,
 ) -> ssl.SSLContext:
     """Build an SSL context for the uvicorn/FastAPI server."""
     ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
diff --git a/gently/mesh/transfer/__init__.py b/gently/mesh/transfer/__init__.py
index d7ec6818..cf8df0fc 100644
--- a/gently/mesh/transfer/__init__.py
+++ b/gently/mesh/transfer/__init__.py
@@ -4,8 +4,14 @@
 Resumable, authenticated transfers for datasets and model weights.
 """
 
-from .models import TransferFile, TransferJob, TransferManifest, TransferStatus, TransferType
 from .client import TransferClient
+from .models import (
+    TransferFile,
+    TransferJob,
+    TransferManifest,
+    TransferStatus,
+    TransferType,
+)
 from .server import TransferService
 from .tracker import TransferTracker
 
diff --git a/gently/mesh/transfer/client.py b/gently/mesh/transfer/client.py
index bdcd3507..066aea08 100644
--- a/gently/mesh/transfer/client.py
+++ b/gently/mesh/transfer/client.py
@@ -3,15 +3,12 @@
 """
 
 import asyncio
-import hashlib
 import logging
 import time
 import uuid
 from pathlib import Path
-from typing import List, Optional
 
 from ...core.event_bus import EventType, get_event_bus
-from ...settings import settings
 from .models import TransferJob, TransferStatus, TransferType
 from .protocol import send_file
 
@@ -42,7 +39,7 @@ async def send_dataset(
         peer_ip: str,
         peer_port: int,
         peer_instance_id: str,
-        file_paths: List[Path],
+        file_paths: list[Path],
         session_id: str = "",
     ) -> TransferJob:
         """Send dataset files to a peer.
@@ -87,7 +84,10 @@ async def send_dataset(
                 reader, writer = await asyncio.open_connection(peer_ip, peer_port)
                 try:
                     success, sha256 = await send_file(
-                        writer, file_path, job.id, auth_token=token,
+                        writer,
+                        file_path,
+                        job.id,
+                        auth_token=token,
                     )
                     if success:
                         job.bytes_transferred += file_path.stat().st_size
diff --git a/gently/mesh/transfer/models.py b/gently/mesh/transfer/models.py
index c1534eae..a932d69e 100644
--- a/gently/mesh/transfer/models.py
+++ b/gently/mesh/transfer/models.py
@@ -2,14 +2,14 @@
 Transfer data models.
 """
 
-import time
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 
 class TransferType(str, Enum):
     """Type of data being transferred."""
+
     DATASET = "dataset"
     MODEL_WEIGHTS = "model_weights"
     SESSION = "session"
@@ -17,6 +17,7 @@ class TransferType(str, Enum):
 
 class TransferStatus(str, Enum):
     """Transfer state machine."""
+
     PENDING = "pending"
     TRANSFERRING = "transferring"
     PAUSED = "paused"
@@ -28,12 +29,13 @@ class TransferStatus(str, Enum):
 @dataclass
 class TransferFile:
     """A single file in a transfer manifest."""
+
     relative_path: str = ""
     total_size: int = 0
     sha256: str = ""
     transferred: int = 0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "relative_path": self.relative_path,
             "total_size": self.total_size,
@@ -42,7 +44,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "TransferFile":
+    def from_dict(cls, d: dict[str, Any]) -> "TransferFile":
         return cls(
             relative_path=d.get("relative_path", ""),
             total_size=d.get("total_size", 0),
@@ -54,11 +56,12 @@ def from_dict(cls, d: Dict[str, Any]) -> "TransferFile":
 @dataclass
 class TransferManifest:
     """List of files to transfer."""
-    files: List[TransferFile] = field(default_factory=list)
+
+    files: list[TransferFile] = field(default_factory=list)
     total_size: int = 0
     file_count: int = 0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "files": [f.to_dict() for f in self.files],
             "total_size": self.total_size,
@@ -66,7 +69,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "TransferManifest":
+    def from_dict(cls, d: dict[str, Any]) -> "TransferManifest":
         files = [TransferFile.from_dict(f) for f in d.get("files", [])]
         return cls(
             files=files,
@@ -78,6 +81,7 @@ def from_dict(cls, d: Dict[str, Any]) -> "TransferManifest":
 @dataclass
 class TransferJob:
     """State of a single transfer (send or receive)."""
+
     id: str = ""
     transfer_type: str = TransferType.DATASET.value
     status: str = TransferStatus.PENDING.value
@@ -103,7 +107,7 @@ def progress_pct(self) -> float:
             return 0.0
         return (self.bytes_transferred / self.total_bytes) * 100
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "id": self.id,
             "transfer_type": self.transfer_type,
@@ -125,7 +129,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "TransferJob":
+    def from_dict(cls, d: dict[str, Any]) -> "TransferJob":
         return cls(
             id=d.get("id", ""),
             transfer_type=d.get("transfer_type", TransferType.DATASET.value),
diff --git a/gently/mesh/transfer/protocol.py b/gently/mesh/transfer/protocol.py
index 89af0258..df72c837 100644
--- a/gently/mesh/transfer/protocol.py
+++ b/gently/mesh/transfer/protocol.py
@@ -22,7 +22,6 @@
 import logging
 import struct
 from pathlib import Path
-from typing import Optional, Tuple
 
 from ...settings import settings
 
@@ -39,7 +38,7 @@ async def send_file(
     auth_token: str = "",
     offset: int = 0,
     chunk_size: int = 0,
-) -> Tuple[bool, str]:
+) -> tuple[bool, str]:
     """Send a file over a TCP connection.
 
     Parameters
@@ -108,7 +107,7 @@ async def send_file(
 async def receive_file(
     reader: asyncio.StreamReader,
     dest_dir: Path,
-) -> Tuple[Optional[dict], Optional[Path], str]:
+) -> tuple[dict | None, Path | None, str]:
     """Receive a file over a TCP connection.
 
     Parameters
diff --git a/gently/mesh/transfer/server.py b/gently/mesh/transfer/server.py
index ff2cfb2b..9ecf0fb9 100644
--- a/gently/mesh/transfer/server.py
+++ b/gently/mesh/transfer/server.py
@@ -4,15 +4,12 @@
 
 import asyncio
 import logging
-import time
 import uuid
 from pathlib import Path
-from typing import Optional
 
 from ...core.event_bus import EventType, get_event_bus
 from ...core.service import Service
 from ...settings import settings
-from .models import TransferJob, TransferStatus
 from .protocol import receive_file
 
 logger = logging.getLogger(__name__)
@@ -46,7 +43,7 @@ def __init__(
         self._dest_dir = dest_dir
         self._pairing_manager = pairing_manager
         self._port = port
-        self._server: Optional[asyncio.AbstractServer] = None
+        self._server: asyncio.AbstractServer | None = None
         self._active_transfers: dict = {}
 
     async def on_start(self):
diff --git a/gently/mesh/transfer/tracker.py b/gently/mesh/transfer/tracker.py
index 43f52cb2..be896b5f 100644
--- a/gently/mesh/transfer/tracker.py
+++ b/gently/mesh/transfer/tracker.py
@@ -5,7 +5,6 @@
 import json
 import logging
 from pathlib import Path
-from typing import Dict, List, Optional
 
 from .models import TransferJob, TransferStatus
 
@@ -24,7 +23,7 @@ class TransferTracker:
     def __init__(self, config_dir: Path):
         self._config_dir = config_dir
         self._state_file = config_dir / "mesh_transfers.json"
-        self._jobs: Dict[str, TransferJob] = {}
+        self._jobs: dict[str, TransferJob] = {}
         self._load()
 
     def _load(self):
@@ -65,20 +64,21 @@ def update_job(self, job_id: str, **kwargs):
                 setattr(job, k, v)
         self._save()
 
-    def get_job(self, job_id: str) -> Optional[TransferJob]:
+    def get_job(self, job_id: str) -> TransferJob | None:
         """Get a transfer job by ID."""
         return self._jobs.get(job_id)
 
-    def list_jobs(self, status: Optional[str] = None) -> List[TransferJob]:
+    def list_jobs(self, status: str | None = None) -> list[TransferJob]:
         """List all jobs, optionally filtered by status."""
         if status:
             return [j for j in self._jobs.values() if j.status == status]
         return list(self._jobs.values())
 
-    def get_resumable(self) -> List[TransferJob]:
+    def get_resumable(self) -> list[TransferJob]:
         """Get transfers that were interrupted and can be resumed."""
         return [
-            j for j in self._jobs.values()
+            j
+            for j in self._jobs.values()
             if j.status == TransferStatus.TRANSFERRING.value
             and j.bytes_transferred > 0
             and j.bytes_transferred < j.total_bytes
@@ -87,9 +87,11 @@ def get_resumable(self) -> List[TransferJob]:
     def cleanup_completed(self, max_age_hours: float = 24.0):
         """Remove old completed/failed transfers."""
         import time
+
         cutoff = time.time() - (max_age_hours * 3600)
         to_remove = [
-            jid for jid, j in self._jobs.items()
+            jid
+            for jid, j in self._jobs.items()
             if j.status in (TransferStatus.COMPLETED.value, TransferStatus.FAILED.value)
             and j.completed_at > 0
             and j.completed_at < cutoff
diff --git a/gently/mesh/verse_map.py b/gently/mesh/verse_map.py
index 7309f753..15265548 100644
--- a/gently/mesh/verse_map.py
+++ b/gently/mesh/verse_map.py
@@ -9,13 +9,9 @@
 import logging
 import time
 from pathlib import Path
-from typing import Dict, List, Optional
 
 from .models import (
-    DatasetAdvertisement,
-    PeerCapability,
     PeerInfo,
-    PeerStatus,
     PersistedPeer,
 )
 
@@ -28,7 +24,7 @@ class VerseMap:
     def __init__(self, config_dir: Path):
         self._config_dir = config_dir
         self._map_file = config_dir / "mesh_verse_map.json"
-        self._peers: Dict[str, PersistedPeer] = {}
+        self._peers: dict[str, PersistedPeer] = {}
         self._load()
 
     # ------------------------------------------------------------------
@@ -109,19 +105,19 @@ def on_peer_returned(self, instance_id: str):
     # Queries
     # ------------------------------------------------------------------
 
-    def get_all_peers(self) -> List[PersistedPeer]:
+    def get_all_peers(self) -> list[PersistedPeer]:
         """All peers, online and offline."""
         return list(self._peers.values())
 
-    def get_online_peers(self) -> List[PersistedPeer]:
+    def get_online_peers(self) -> list[PersistedPeer]:
         """Only online peers."""
         return [p for p in self._peers.values() if p.online]
 
-    def get_offline_peers(self) -> List[PersistedPeer]:
+    def get_offline_peers(self) -> list[PersistedPeer]:
         """Only offline peers."""
         return [p for p in self._peers.values() if not p.online]
 
-    def get_peer(self, instance_id: str) -> Optional[PersistedPeer]:
+    def get_peer(self, instance_id: str) -> PersistedPeer | None:
         """Get a specific peer by instance_id."""
         return self._peers.get(instance_id)
 
@@ -138,27 +134,25 @@ def was_online(self, instance_id: str) -> bool:
     # Route-finding: sorted online-first, then by last_seen recency
     # ------------------------------------------------------------------
 
-    def _sorted_peers(self, peers: List[PersistedPeer]) -> List[PersistedPeer]:
+    def _sorted_peers(self, peers: list[PersistedPeer]) -> list[PersistedPeer]:
         """Sort peers: online first, then by last_seen descending."""
         return sorted(peers, key=lambda p: (not p.online, -p.last_seen))
 
-    def find_gpu_peers(self) -> List[PersistedPeer]:
+    def find_gpu_peers(self) -> list[PersistedPeer]:
         """Find peers with GPU capability, best candidates first."""
-        results = [
-            p for p in self._peers.values()
-            if p.capabilities.has_gpu or p.capabilities.gpus
-        ]
+        results = [p for p in self._peers.values() if p.capabilities.has_gpu or p.capabilities.gpus]
         return self._sorted_peers(results)
 
-    def find_microscope_peers(self) -> List[PersistedPeer]:
+    def find_microscope_peers(self) -> list[PersistedPeer]:
         """Find peers with microscope capability."""
         results = [
-            p for p in self._peers.values()
+            p
+            for p in self._peers.values()
             if p.capabilities.has_microscope or p.capabilities.microscope_connected
         ]
         return self._sorted_peers(results)
 
-    def find_data_peers(self, session_id: str = None) -> List[PersistedPeer]:
+    def find_data_peers(self, session_id: str = None) -> list[PersistedPeer]:
         """Find peers with data, optionally filtering by session."""
         results = []
         for p in self._peers.values():
@@ -171,7 +165,7 @@ def find_data_peers(self, session_id: str = None) -> List[PersistedPeer]:
             results.append(p)
         return self._sorted_peers(results)
 
-    def find_resource(self, capability: str) -> List[PersistedPeer]:
+    def find_resource(self, capability: str) -> list[PersistedPeer]:
         """Find peers matching a generic capability attribute.
 
         The capability string is checked against:
diff --git a/gently/ml/__init__.py b/gently/ml/__init__.py
index 9c817a33..7b4c2dc1 100644
--- a/gently/ml/__init__.py
+++ b/gently/ml/__init__.py
@@ -9,6 +9,7 @@
 - Federated averaging for distributed training
 """
 
+from .architectures import ARCHITECTURE_REGISTRY, get_suitable_architectures
 from .models import (
     DataSplit,
     MLPipeline,
@@ -18,7 +19,6 @@
     TrainingRun,
     TrainingStatus,
 )
-from .architectures import ARCHITECTURE_REGISTRY, get_suitable_architectures
 
 __all__ = [
     "ARCHITECTURE_REGISTRY",
diff --git a/gently/ml/_train_worker.py b/gently/ml/_train_worker.py
index bc905a87..04448de2 100644
--- a/gently/ml/_train_worker.py
+++ b/gently/ml/_train_worker.py
@@ -43,7 +43,7 @@ def main():
         sys.exit(1)
 
     try:
-        import torchvision.models as models
+        import torchvision.models as models  # noqa: F401
     except ImportError:
         _write_progress(progress_file, {"error": "torchvision not installed"})
         sys.exit(1)
@@ -56,7 +56,7 @@ def main():
         sys.exit(1)
 
     # Build datasets
-    from gently.ml.data_loader import GentlyDataset, create_data_splits
+    from gently.ml.data_loader import create_data_splits
 
     architecture = model_config.get("architecture", "resnet18")
     num_classes = model_config.get("num_classes", 8)
@@ -75,8 +75,11 @@ def main():
 
     # Create datasets from labels
     train_data, val_data, test_data = create_data_splits(
-        labels_data, data_root, input_size,
-        train_ratio=0.7, val_ratio=0.15,
+        labels_data,
+        data_root,
+        input_size,
+        train_ratio=0.7,
+        val_ratio=0.15,
     )
 
     train_loader = DataLoader(train_data, batch_size=batch_size, shuffle=True, num_workers=2)
@@ -171,17 +174,20 @@ def main():
             patience_counter += 1
 
         # Write progress
-        _write_progress(progress_file, {
-            "epoch": epoch + 1,
-            "total_epochs": epochs,
-            "train_loss": round(train_loss, 4),
-            "train_accuracy": round(train_acc, 4),
-            "val_loss": round(val_loss, 4),
-            "val_accuracy": round(val_acc, 4),
-            "best_val_accuracy": round(best_val_acc, 4),
-            "lr": optimizer.param_groups[0]["lr"],
-            "timestamp": time.time(),
-        })
+        _write_progress(
+            progress_file,
+            {
+                "epoch": epoch + 1,
+                "total_epochs": epochs,
+                "train_loss": round(train_loss, 4),
+                "train_accuracy": round(train_acc, 4),
+                "val_loss": round(val_loss, 4),
+                "val_accuracy": round(val_acc, 4),
+                "best_val_accuracy": round(best_val_acc, 4),
+                "lr": optimizer.param_groups[0]["lr"],
+                "timestamp": time.time(),
+            },
+        )
 
         # Early stopping
         if patience_counter >= early_stopping_patience:
@@ -218,7 +224,12 @@ def _build_model(architecture, num_classes, pretrained, input_channels, dropout)
         if input_channels != 3:
             old_conv = model.conv1
             model.conv1 = nn.Conv2d(
-                input_channels, 64, kernel_size=7, stride=2, padding=3, bias=False,
+                input_channels,
+                64,
+                kernel_size=7,
+                stride=2,
+                padding=3,
+                bias=False,
             )
             if pretrained and input_channels == 1:
                 # Average RGB weights for grayscale
@@ -241,7 +252,8 @@ def _build_model(architecture, num_classes, pretrained, input_channels, dropout)
             old_conv = model.features[0][0]
             out_channels = old_conv.out_channels
             model.features[0][0] = nn.Conv2d(
-                input_channels, out_channels,
+                input_channels,
+                out_channels,
                 kernel_size=old_conv.kernel_size,
                 stride=old_conv.stride,
                 padding=old_conv.padding,
@@ -260,7 +272,8 @@ def _build_model(architecture, num_classes, pretrained, input_channels, dropout)
             old_conv = model.features[0][0]
             out_channels = old_conv.out_channels
             model.features[0][0] = nn.Conv2d(
-                input_channels, out_channels,
+                input_channels,
+                out_channels,
                 kernel_size=old_conv.kernel_size,
                 stride=old_conv.stride,
                 padding=old_conv.padding,
@@ -278,7 +291,8 @@ def _build_model(architecture, num_classes, pretrained, input_channels, dropout)
             old_conv = model.features[0][0]
             out_channels = old_conv.out_channels
             model.features[0][0] = nn.Conv2d(
-                input_channels, out_channels,
+                input_channels,
+                out_channels,
                 kernel_size=old_conv.kernel_size,
                 stride=old_conv.stride,
                 padding=old_conv.padding,
diff --git a/gently/ml/architectures.py b/gently/ml/architectures.py
index 41f4fe77..2c6f91a8 100644
--- a/gently/ml/architectures.py
+++ b/gently/ml/architectures.py
@@ -5,12 +5,12 @@
 for a given task, dataset size, and hardware constraints.
 """
 
-from typing import Any, Dict, List
+from typing import Any
 
 from .models import ModelArchitectureType
 
 # Architecture registry: metadata per architecture
-ARCHITECTURE_REGISTRY: Dict[str, Dict[str, Any]] = {
+ARCHITECTURE_REGISTRY: dict[str, dict[str, Any]] = {
     ModelArchitectureType.RESNET_18.value: {
         "name": "ResNet-18",
         "family": "resnet",
@@ -147,7 +147,7 @@ def get_suitable_architectures(
     dataset_size: int,
     vram_gb: float,
     image_type: str = "microscopy",
-) -> List[Dict[str, Any]]:
+) -> list[dict[str, Any]]:
     """Filter architectures suitable for given constraints.
 
     Parameters
diff --git a/gently/ml/data_loader.py b/gently/ml/data_loader.py
index 082fae1e..ccf080b0 100644
--- a/gently/ml/data_loader.py
+++ b/gently/ml/data_loader.py
@@ -2,11 +2,10 @@
 GentlyDataset — PyTorch Dataset loading projections + ground_truth from FileStore.
 """
 
-import json
 import logging
 import random
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -14,9 +13,11 @@
     import numpy as np
     import torch
     from torch.utils.data import Dataset
+
     HAS_TORCH = True
 except ImportError:
     HAS_TORCH = False
+
     # Stub for import-time safety
     class Dataset:
         pass
@@ -37,7 +38,7 @@ class GentlyDataset(Dataset):
 
     def __init__(
         self,
-        samples: List[Tuple[str, int]],
+        samples: list[tuple[str, int]],
         input_size: int = 224,
         augment: bool = False,
     ):
@@ -57,6 +58,7 @@ def __getitem__(self, idx):
         # Load image
         try:
             from PIL import Image
+
             img = Image.open(img_path).convert("L")  # grayscale
             img = img.resize((self.input_size, self.input_size))
             img_np = np.array(img, dtype=np.float32) / 255.0
@@ -92,13 +94,13 @@ def _apply_augmentations(self, img: np.ndarray) -> np.ndarray:
 
 
 def create_data_splits(
-    labels_data: Dict[str, Any],
+    labels_data: dict[str, Any],
     data_root: Path,
     input_size: int = 224,
     train_ratio: float = 0.7,
     val_ratio: float = 0.15,
     random_seed: int = 42,
-) -> Tuple:
+) -> tuple:
     """Create train/val/test datasets from a labels file.
 
     Parameters
@@ -141,15 +143,15 @@ def create_data_splits(
     val_samples = []
     test_samples = []
 
-    for label, items in by_label.items():
+    for _label, items in by_label.items():
         random.shuffle(items)
         n = len(items)
         n_train = max(1, int(n * train_ratio))
         n_val = max(1, int(n * val_ratio))
 
         train_samples.extend(items[:n_train])
-        val_samples.extend(items[n_train:n_train + n_val])
-        test_samples.extend(items[n_train + n_val:])
+        val_samples.extend(items[n_train : n_train + n_val])
+        test_samples.extend(items[n_train + n_val :])
 
     train_ds = GentlyDataset(train_samples, input_size=input_size, augment=True)
     val_ds = GentlyDataset(val_samples, input_size=input_size, augment=False)
@@ -158,7 +160,7 @@ def create_data_splits(
     return train_ds, val_ds, test_ds
 
 
-def build_labels_from_store(gently_store, session_ids: Optional[List[str]] = None) -> Dict:
+def build_labels_from_store(gently_store, session_ids: list[str] | None = None) -> dict:
     """Build a labels dict from FileStore ground truth.
 
     Returns
@@ -193,13 +195,15 @@ def build_labels_from_store(gently_store, session_ids: Optional[List[str]] = Non
                     try:
                         proj_path = gently_store.get_projection_path(sid, eid, start_tp)
                         if proj_path:
-                            samples.append({
-                                "path": str(proj_path),
-                                "label": stage_to_idx[stage],
-                                "session_id": sid,
-                                "embryo_id": eid,
-                                "stage": stage,
-                            })
+                            samples.append(
+                                {
+                                    "path": str(proj_path),
+                                    "label": stage_to_idx[stage],
+                                    "session_id": sid,
+                                    "embryo_id": eid,
+                                    "stage": stage,
+                                }
+                            )
                     except Exception:
                         pass
             except Exception:
diff --git a/gently/ml/evaluation.py b/gently/ml/evaluation.py
index b03f35b5..deffce4d 100644
--- a/gently/ml/evaluation.py
+++ b/gently/ml/evaluation.py
@@ -6,7 +6,7 @@
 import logging
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -14,17 +14,18 @@
 @dataclass
 class EvaluationReport:
     """Complete evaluation report for a trained model."""
+
     run_id: str = ""
     accuracy: float = 0.0
-    per_stage_precision: Dict[str, float] = field(default_factory=dict)
-    per_stage_recall: Dict[str, float] = field(default_factory=dict)
-    per_stage_f1: Dict[str, float] = field(default_factory=dict)
-    confusion_matrix: List[List[int]] = field(default_factory=list)
-    class_names: List[str] = field(default_factory=list)
+    per_stage_precision: dict[str, float] = field(default_factory=dict)
+    per_stage_recall: dict[str, float] = field(default_factory=dict)
+    per_stage_f1: dict[str, float] = field(default_factory=dict)
+    confusion_matrix: list[list[int]] = field(default_factory=list)
+    class_names: list[str] = field(default_factory=list)
     total_samples: int = 0
     correct: int = 0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "run_id": self.run_id,
             "accuracy": self.accuracy,
@@ -38,7 +39,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "EvaluationReport":
+    def from_dict(cls, d: dict[str, Any]) -> "EvaluationReport":
         return cls(
             run_id=d.get("run_id", ""),
             accuracy=d.get("accuracy", 0.0),
@@ -66,7 +67,7 @@ def summary(self) -> str:
 def evaluate_model(
     model,
     data_loader,
-    class_names: List[str],
+    class_names: list[str],
     device=None,
     run_id: str = "",
 ) -> EvaluationReport:
@@ -111,7 +112,7 @@ def evaluate_model(
             outputs = model(batch_x)
             _, predicted = outputs.max(1)
 
-            for true, pred in zip(batch_y.cpu().tolist(), predicted.cpu().tolist()):
+            for true, pred in zip(batch_y.cpu().tolist(), predicted.cpu().tolist(), strict=False):
                 cm[true][pred] += 1
                 total += 1
                 if true == pred:
diff --git a/gently/ml/federated.py b/gently/ml/federated.py
index c114b18e..f257bbd5 100644
--- a/gently/ml/federated.py
+++ b/gently/ml/federated.py
@@ -12,11 +12,9 @@
 
 import asyncio
 import copy
-import json
 import logging
-import time
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 from ..core.event_bus import EventType, get_event_bus
 
@@ -24,9 +22,9 @@
 
 
 def federated_average(
-    state_dicts: List[Dict[str, Any]],
-    weights: List[float],
-) -> Dict[str, Any]:
+    state_dicts: list[dict[str, Any]],
+    weights: list[float],
+) -> dict[str, Any]:
     """Compute weighted average of model state dicts.
 
     Parameters
@@ -50,7 +48,7 @@ def federated_average(
     try:
         import torch
     except ImportError:
-        raise ImportError("PyTorch required for federated averaging")
+        raise ImportError("PyTorch required for federated averaging") from None
 
     total_weight = sum(weights)
     if total_weight == 0:
@@ -66,7 +64,7 @@ def federated_average(
         averaged[key] = torch.zeros_like(state_dicts[0][key], dtype=torch.float32)
 
     # Weighted sum
-    for sd, w in zip(state_dicts, norm_weights):
+    for sd, w in zip(state_dicts, norm_weights, strict=False):
         for key in averaged:
             averaged[key] += sd[key].float() * w
 
@@ -98,14 +96,14 @@ def __init__(self, verse_map, transfer_client=None, peer_client=None):
     async def run_federated_training(
         self,
         pipeline_id: str,
-        worker_peers: List,
+        worker_peers: list,
         initial_weights_path: Path,
         local_epochs_per_round: int = 5,
         max_rounds: int = 20,
         convergence_threshold: float = 0.001,
-        training_config: Optional[Dict] = None,
-        model_config: Optional[Dict] = None,
-    ) -> Dict[str, Any]:
+        training_config: dict | None = None,
+        model_config: dict | None = None,
+    ) -> dict[str, Any]:
         """Run federated averaging across mesh peers.
 
         Parameters
@@ -175,10 +173,12 @@ async def run_federated_training(
 
             # 3. Federated average
             state_dicts = [r["state_dict"] for r in worker_results if r.get("state_dict")]
-            dataset_sizes = [r.get("dataset_size", 1) for r in worker_results if r.get("state_dict")]
+            dataset_sizes = [
+                r.get("dataset_size", 1) for r in worker_results if r.get("state_dict")
+            ]
 
             if state_dicts:
-                global_state = federated_average(state_dicts, dataset_sizes)
+                federated_average(state_dicts, dataset_sizes)
             else:
                 logger.warning(f"Round {round_num}: no state dicts to average")
                 continue
@@ -234,13 +234,13 @@ async def run_federated_training(
 
     async def _train_workers(
         self,
-        workers: List,
+        workers: list,
         pipeline_id: str,
         round_num: int,
         local_epochs: int,
-        training_config: Optional[Dict],
-        model_config: Optional[Dict],
-    ) -> List[Dict]:
+        training_config: dict | None,
+        model_config: dict | None,
+    ) -> list[dict]:
         """Send training jobs to all workers and collect results.
 
         In production this uses PeerClient to POST /api/ml/train on each
@@ -253,18 +253,20 @@ async def _train_workers(
         for worker in workers:
             tasks.append(
                 self._train_single_worker(
-                    worker, pipeline_id, round_num, local_epochs,
-                    training_config, model_config,
+                    worker,
+                    pipeline_id,
+                    round_num,
+                    local_epochs,
+                    training_config,
+                    model_config,
                 )
             )
 
         completed = await asyncio.gather(*tasks, return_exceptions=True)
 
-        for worker, result in zip(workers, completed):
+        for worker, result in zip(workers, completed, strict=False):
             if isinstance(result, Exception):
-                logger.warning(
-                    f"Worker {worker.hostname} failed in round {round_num}: {result}"
-                )
+                logger.warning(f"Worker {worker.hostname} failed in round {round_num}: {result}")
                 continue
             if result:
                 results.append(result)
@@ -277,9 +279,9 @@ async def _train_single_worker(
         pipeline_id: str,
         round_num: int,
         local_epochs: int,
-        training_config: Optional[Dict],
-        model_config: Optional[Dict],
-    ) -> Optional[Dict]:
+        training_config: dict | None,
+        model_config: dict | None,
+    ) -> dict | None:
         """Train on a single worker peer via HTTP API.
 
         Returns worker result dict with state_dict, val_accuracy, dataset_size.
@@ -289,7 +291,8 @@ async def _train_single_worker(
 
         # Build a PeerInfo for the HTTP client
         from ..models import PeerInfo
-        peer = PeerInfo(
+
+        PeerInfo(
             instance_id=worker.instance_id,
             hostname=worker.hostname,
             ip_address=worker.ip_address,
diff --git a/gently/ml/models.py b/gently/ml/models.py
index 0a5b5c00..dcf689ab 100644
--- a/gently/ml/models.py
+++ b/gently/ml/models.py
@@ -4,11 +4,12 @@
 
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 
 class TrainingStatus(str, Enum):
     """Status of an ML pipeline or training run."""
+
     PLANNED = "planned"
     DATA_PREP = "data_prep"
     TRAINING = "training"
@@ -20,6 +21,7 @@ class TrainingStatus(str, Enum):
 
 class ModelArchitectureType(str, Enum):
     """Supported model architecture families."""
+
     RESNET_18 = "resnet18"
     RESNET_50 = "resnet50"
     EFFICIENTNET_B0 = "efficientnet_b0"
@@ -33,6 +35,7 @@ class ModelArchitectureType(str, Enum):
 @dataclass
 class ModelConfig:
     """Configuration for a model architecture."""
+
     architecture: str = "resnet18"
     num_classes: int = 8
     pretrained: bool = True
@@ -41,7 +44,7 @@ class ModelConfig:
     dropout: float = 0.2
     freeze_backbone_epochs: int = 5  # freeze backbone for N epochs, then unfreeze
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "architecture": self.architecture,
             "num_classes": self.num_classes,
@@ -53,7 +56,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "ModelConfig":
+    def from_dict(cls, d: dict[str, Any]) -> "ModelConfig":
         return cls(
             architecture=d.get("architecture", "resnet18"),
             num_classes=d.get("num_classes", 8),
@@ -68,6 +71,7 @@ def from_dict(cls, d: Dict[str, Any]) -> "ModelConfig":
 @dataclass
 class TrainingConfig:
     """Training hyperparameters."""
+
     batch_size: int = 32
     epochs: int = 50
     learning_rate: float = 1e-4
@@ -76,13 +80,15 @@ class TrainingConfig:
     warmup_epochs: int = 5
     mixed_precision: bool = True  # AMP on A5000
     early_stopping_patience: int = 10
-    augmentations: List[str] = field(default_factory=lambda: [
-        "random_horizontal_flip",
-        "random_rotation",
-        "random_brightness",
-    ])
+    augmentations: list[str] = field(
+        default_factory=lambda: [
+            "random_horizontal_flip",
+            "random_rotation",
+            "random_brightness",
+        ]
+    )
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "batch_size": self.batch_size,
             "epochs": self.epochs,
@@ -96,7 +102,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "TrainingConfig":
+    def from_dict(cls, d: dict[str, Any]) -> "TrainingConfig":
         return cls(
             batch_size=d.get("batch_size", 32),
             epochs=d.get("epochs", 50),
@@ -113,14 +119,15 @@ def from_dict(cls, d: Dict[str, Any]) -> "TrainingConfig":
 @dataclass
 class DataSplit:
     """Defines how data is split for training."""
+
     train_ratio: float = 0.7
     val_ratio: float = 0.15
     test_ratio: float = 0.15
     stratify_by: str = "stage"  # stratify splits by stage label
-    session_ids: List[str] = field(default_factory=list)
+    session_ids: list[str] = field(default_factory=list)
     random_seed: int = 42
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "train_ratio": self.train_ratio,
             "val_ratio": self.val_ratio,
@@ -131,7 +138,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "DataSplit":
+    def from_dict(cls, d: dict[str, Any]) -> "DataSplit":
         return cls(
             train_ratio=d.get("train_ratio", 0.7),
             val_ratio=d.get("val_ratio", 0.15),
@@ -145,12 +152,13 @@ def from_dict(cls, d: Dict[str, Any]) -> "DataSplit":
 @dataclass
 class TrainingRun:
     """State of a single training run."""
+
     id: str = ""
     pipeline_id: str = ""
     status: str = TrainingStatus.PLANNED.value
-    model_config: Optional[ModelConfig] = None
-    training_config: Optional[TrainingConfig] = None
-    data_split: Optional[DataSplit] = None
+    model_config: ModelConfig | None = None
+    training_config: TrainingConfig | None = None
+    data_split: DataSplit | None = None
     current_epoch: int = 0
     total_epochs: int = 0
     train_loss: float = 0.0
@@ -164,7 +172,7 @@ class TrainingRun:
     completed_at: str = ""
     error_message: str = ""
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "id": self.id,
             "pipeline_id": self.pipeline_id,
@@ -187,7 +195,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "TrainingRun":
+    def from_dict(cls, d: dict[str, Any]) -> "TrainingRun":
         mc = d.get("model_config")
         tc = d.get("training_config")
         ds = d.get("data_split")
@@ -216,20 +224,21 @@ def from_dict(cls, d: Dict[str, Any]) -> "TrainingRun":
 @dataclass
 class MLPipeline:
     """Top-level pipeline that coordinates one ML task."""
+
     id: str = ""
     campaign_id: str = ""
     name: str = ""
     task: str = "embryo_stage_classification"
     status: str = TrainingStatus.PLANNED.value
-    model_config: Optional[ModelConfig] = None
-    data_split: Optional[DataSplit] = None
-    training_config: Optional[TrainingConfig] = None
+    model_config: ModelConfig | None = None
+    data_split: DataSplit | None = None
+    training_config: TrainingConfig | None = None
     best_run_id: str = ""
     best_accuracy: float = 0.0
     created_at: str = ""
     updated_at: str = ""
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "id": self.id,
             "campaign_id": self.campaign_id,
@@ -246,7 +255,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
     @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> "MLPipeline":
+    def from_dict(cls, d: dict[str, Any]) -> "MLPipeline":
         mc = d.get("model_config")
         ds = d.get("data_split")
         tc = d.get("training_config")
diff --git a/gently/ml/trainer.py b/gently/ml/trainer.py
index 67da88cb..2ef764f5 100644
--- a/gently/ml/trainer.py
+++ b/gently/ml/trainer.py
@@ -9,14 +9,12 @@
 import asyncio
 import json
 import logging
-import os
 import sys
 from datetime import datetime
 from pathlib import Path
-from typing import Optional
 
 from ..core.event_bus import EventType, get_event_bus
-from .models import ModelConfig, TrainingConfig, TrainingRun, TrainingStatus
+from .models import TrainingRun, TrainingStatus
 
 logger = logging.getLogger(__name__)
 
@@ -33,8 +31,8 @@ class LocalTrainer:
     def __init__(self, run_dir: Path):
         self._run_dir = run_dir
         self._run_dir.mkdir(parents=True, exist_ok=True)
-        self._process: Optional[asyncio.subprocess.Process] = None
-        self._monitor_task: Optional[asyncio.Task] = None
+        self._process: asyncio.subprocess.Process | None = None
+        self._monitor_task: asyncio.Task | None = None
 
     @property
     def progress_file(self) -> Path:
@@ -95,16 +93,16 @@ async def start_training(
         # Launch subprocess
         train_script = Path(__file__).parent / "_train_worker.py"
         self._process = await asyncio.create_subprocess_exec(
-            sys.executable, str(train_script), str(config_file),
+            sys.executable,
+            str(train_script),
+            str(config_file),
             stdout=asyncio.subprocess.PIPE,
             stderr=asyncio.subprocess.PIPE,
             cwd=str(self._run_dir),
         )
 
         # Start progress monitor
-        self._monitor_task = asyncio.create_task(
-            self._monitor_progress(run.id, run.pipeline_id)
-        )
+        self._monitor_task = asyncio.create_task(self._monitor_progress(run.id, run.pipeline_id))
 
         logger.info(f"Training started: run={run.id}, pid={self._process.pid}")
         return run
@@ -175,7 +173,7 @@ async def cancel(self):
         if self._monitor_task and not self._monitor_task.done():
             self._monitor_task.cancel()
 
-    def get_latest_progress(self) -> Optional[dict]:
+    def get_latest_progress(self) -> dict | None:
         """Read the last line from progress.jsonl."""
         if not self.progress_file.exists():
             return None
diff --git a/gently/organisms/__init__.py b/gently/organisms/__init__.py
index e4f9d522..1db2c317 100644
--- a/gently/organisms/__init__.py
+++ b/gently/organisms/__init__.py
@@ -16,18 +16,19 @@
 import logging
 import pkgutil
 from types import ModuleType
-from typing import List, Optional
 
 logger = logging.getLogger(__name__)
 
-_active_organism: Optional[ModuleType] = None
+_active_organism: ModuleType | None = None
 
 
-def available_organisms() -> List[str]:
+def available_organisms() -> list[str]:
     """Names of the organism plugins shipped under gently.organisms."""
     import gently.organisms as _pkg
+
     return sorted(
-        m.name for m in pkgutil.iter_modules(_pkg.__path__)
+        m.name
+        for m in pkgutil.iter_modules(_pkg.__path__)
         if m.ispkg and not m.name.startswith("_")
     )
 
@@ -82,7 +83,6 @@ def get_organism() -> ModuleType:
     """
     if _active_organism is None:
         raise RuntimeError(
-            "No organism loaded. Call load_organism() at startup, "
-            "or set 'organism' in config.yml."
+            "No organism loaded. Call load_organism() at startup, or set 'organism' in config.yml."
         )
     return _active_organism
diff --git a/gently/organisms/celegans/__init__.py b/gently/organisms/celegans/__init__.py
index b8d353a6..afd4db01 100644
--- a/gently/organisms/celegans/__init__.py
+++ b/gently/organisms/celegans/__init__.py
@@ -10,21 +10,45 @@
 
 from pathlib import Path
 
+from .biology import BIOLOGY_KNOWLEDGE
+from .detection_defaults import DETECTION_DEFAULTS
+from .detector_presets import get_detector_presets
+from .perception_prompt import PERCEPTION_SYSTEM_PROMPT
 from .stages import (
-    DevelopmentalStage,
-    STAGES,
     STAGE_CRITERIA,
+    STAGES,
     TRANSITION_ZONES,
-    get_transition_zone,
-    get_adjacent_stages,
-    get_stage_description,
+    DevelopmentalStage,
     format_stage_criteria_for_prompt,
+    get_adjacent_stages,
     get_all_criteria_for_prompt,
+    get_stage_description,
+    get_transition_zone,
 )
-from .biology import BIOLOGY_KNOWLEDGE
-from .detector_presets import get_detector_presets
-from .detection_defaults import DETECTION_DEFAULTS
-from .perception_prompt import PERCEPTION_SYSTEM_PROMPT
+
+__all__ = [
+    "BIOLOGY_KNOWLEDGE",
+    "DETECTION_DEFAULTS",
+    "get_detector_presets",
+    "PERCEPTION_SYSTEM_PROMPT",
+    "STAGE_CRITERIA",
+    "STAGES",
+    "TRANSITION_ZONES",
+    "DevelopmentalStage",
+    "format_stage_criteria_for_prompt",
+    "get_adjacent_stages",
+    "get_all_criteria_for_prompt",
+    "get_stage_description",
+    "get_transition_zone",
+    "ORGANISM_NAME",
+    "ORGANISM_DISPLAY_NAME",
+    "SAMPLE_TERM",
+    "SAMPLE_TERM_PLURAL",
+    "TERMINAL_STAGES",
+    "STOP_CONDITIONS",
+    "PRE_TERMINAL_SPEEDUP_STAGE",
+    "EXAMPLES_PATH",
+]
 
 # --- Organism identity ---
 ORGANISM_NAME = "celegans"
diff --git a/gently/organisms/celegans/biology.py b/gently/organisms/celegans/biology.py
index be2f44f1..6c47ae70 100644
--- a/gently/organisms/celegans/biology.py
+++ b/gently/organisms/celegans/biology.py
@@ -8,7 +8,8 @@
 BIOLOGY_KNOWLEDGE = """
 # C. elegans Embryonic Development
 
-C. elegans embryogenesis is highly stereotyped and invariant, proceeding through well-defined stages:
+C. elegans embryogenesis is highly stereotyped and invariant, proceeding through
+well-defined stages:
 
 ## Key Developmental Stages
 
diff --git a/gently/organisms/celegans/detector_presets.py b/gently/organisms/celegans/detector_presets.py
index b2a0be4d..30d8d191 100644
--- a/gently/organisms/celegans/detector_presets.py
+++ b/gently/organisms/celegans/detector_presets.py
@@ -5,10 +5,8 @@
 (hatching, comma stage, pretzel, gastrulation, first division).
 """
 
-from typing import Dict
 
-
-def get_detector_presets() -> Dict:
+def get_detector_presets() -> dict:
     """
     Get predefined detector presets for common C. elegans stages.
 
@@ -18,10 +16,11 @@ def get_detector_presets() -> Dict:
         Preset detector configurations keyed by event name.
     """
     return {
-        'hatching': {
-            'name': 'hatching',
-            'description': 'Detects when C. elegans embryo hatches from eggshell',
-            'prompt': """Analyze this C. elegans embryo image (diSPIM light sheet max projection) and determine if the embryo has HATCHED.
+        "hatching": {
+            "name": "hatching",
+            "description": "Detects when C. elegans embryo hatches from eggshell",
+            "prompt": """Analyze this C. elegans embryo image (diSPIM light sheet max
+projection) and determine if the embryo has HATCHED.
 
 TRUE HATCHING looks like (must meet at least one):
 - Most or all of the worm body is OUTSIDE the eggshell boundary
@@ -46,16 +45,16 @@ def get_detector_presets() -> Dict:
 DETECTED: [YES/NO]
 CONFIDENCE: [HIGH/MEDIUM/LOW]
 REASONING: [Brief explanation - specifically state if worm is INSIDE or OUTSIDE the shell]""",
-            'use_temporal_context': True,
-            'temporal_context_size': 10,
-            'confidence_threshold': 'HIGH',
-            'stop_timelapse': True,  # Auto-stop when hatching detected
+            "use_temporal_context": True,
+            "temporal_context_size": 10,
+            "confidence_threshold": "HIGH",
+            "stop_timelapse": True,  # Auto-stop when hatching detected
         },
-
-        'comma': {
-            'name': 'comma',
-            'description': 'Detects comma stage (major morphogenesis)',
-            'prompt': """Analyze this C. elegans embryo and determine if it has reached the COMMA STAGE.
+        "comma": {
+            "name": "comma",
+            "description": "Detects comma stage (major morphogenesis)",
+            "prompt": """Analyze this C. elegans embryo and determine if it has reached the
+COMMA STAGE.
 
 Key characteristics of comma stage (~400 minutes, ~6.5 hours):
 - Distinct comma or bean shape (ventral curvature)
@@ -70,15 +69,15 @@ def get_detector_presets() -> Dict:
 DETECTED: [YES/NO]
 CONFIDENCE: [HIGH/MEDIUM/LOW]
 REASONING: [Brief explanation]""",
-            'use_temporal_context': True,
-            'temporal_context_size': 5,
-            'confidence_threshold': 'MEDIUM'
+            "use_temporal_context": True,
+            "temporal_context_size": 5,
+            "confidence_threshold": "MEDIUM",
         },
-
-        'pretzel': {
-            'name': 'pretzel',
-            'description': 'Detects pretzel/3-fold stage (highly elongated)',
-            'prompt': """Analyze this C. elegans embryo and determine if it has reached the PRETZEL/3-FOLD STAGE.
+        "pretzel": {
+            "name": "pretzel",
+            "description": "Detects pretzel/3-fold stage (highly elongated)",
+            "prompt": """Analyze this C. elegans embryo and determine if it has reached the
+PRETZEL/3-FOLD STAGE.
 
 Key characteristics of 3-fold stage (~550 minutes, ~9 hours):
 - Highly elongated, approximately 3x the eggshell length
@@ -93,15 +92,14 @@ def get_detector_presets() -> Dict:
 DETECTED: [YES/NO]
 CONFIDENCE: [HIGH/MEDIUM/LOW]
 REASONING: [Brief explanation]""",
-            'use_temporal_context': True,
-            'temporal_context_size': 5,
-            'confidence_threshold': 'MEDIUM'
+            "use_temporal_context": True,
+            "temporal_context_size": 5,
+            "confidence_threshold": "MEDIUM",
         },
-
-        'gastrulation': {
-            'name': 'gastrulation',
-            'description': 'Detects onset of gastrulation',
-            'prompt': """Analyze this C. elegans embryo and determine if GASTRULATION has begun.
+        "gastrulation": {
+            "name": "gastrulation",
+            "description": "Detects onset of gastrulation",
+            "prompt": """Analyze this C. elegans embryo and determine if GASTRULATION has begun.
 
 Key characteristics of gastrulation (~210 minutes, ~3.5 hours):
 - Visible internalization of cells (especially E cells - gut precursors)
@@ -115,15 +113,15 @@ def get_detector_presets() -> Dict:
 DETECTED: [YES/NO]
 CONFIDENCE: [HIGH/MEDIUM/LOW]
 REASONING: [Brief explanation]""",
-            'use_temporal_context': True,
-            'temporal_context_size': 5,
-            'confidence_threshold': 'MEDIUM'
+            "use_temporal_context": True,
+            "temporal_context_size": 5,
+            "confidence_threshold": "MEDIUM",
         },
-
-        'first_division': {
-            'name': 'first_division',
-            'description': 'Detects first cell division (1-cell to 2-cell)',
-            'prompt': """Analyze this C. elegans embryo and determine if FIRST CELL DIVISION has occurred.
+        "first_division": {
+            "name": "first_division",
+            "description": "Detects first cell division (1-cell to 2-cell)",
+            "prompt": """Analyze this C. elegans embryo and determine if FIRST CELL DIVISION
+has occurred.
 
 Key characteristics:
 - Transition from single large cell to two cells
@@ -137,8 +135,8 @@ def get_detector_presets() -> Dict:
 DETECTED: [YES/NO]
 CONFIDENCE: [HIGH/MEDIUM/LOW]
 REASONING: [Brief explanation]""",
-            'use_temporal_context': True,
-            'temporal_context_size': 3,
-            'confidence_threshold': 'HIGH'
+            "use_temporal_context": True,
+            "temporal_context_size": 3,
+            "confidence_threshold": "HIGH",
         },
     }
diff --git a/gently/organisms/celegans/developmental_tracker.py b/gently/organisms/celegans/developmental_tracker.py
index bd10a01e..1750ba36 100644
--- a/gently/organisms/celegans/developmental_tracker.py
+++ b/gently/organisms/celegans/developmental_tracker.py
@@ -11,8 +11,8 @@
 import logging
 from dataclasses import dataclass, field
 from datetime import datetime, timedelta
-from typing import Any, Dict, List, Optional, Tuple
 from enum import Enum
+from typing import Any
 
 import anthropic
 
@@ -29,6 +29,7 @@ class DevelopmentalStage(str, Enum):
     distinguish.  The perception enum (in stages.py) maps "early" to
     everything before comma.
     """
+
     ONE_CELL = "1-cell"
     TWO_CELL = "2-cell"
     FOUR_CELL = "4-cell"
@@ -97,12 +98,13 @@ class DevelopmentalStage(str, Enum):
 @dataclass
 class HatchingPrediction:
     """Prediction of time to hatching with confidence interval"""
+
     embryo_id: str
     current_stage: DevelopmentalStage
     predicted_minutes: int
     min_minutes: int  # Lower bound (optimistic)
     max_minutes: int  # Upper bound (conservative)
-    confidence: str   # Based on stage classification confidence
+    confidence: str  # Based on stage classification confidence
     timestamp: datetime = field(default_factory=datetime.now)
 
     @property
@@ -110,20 +112,20 @@ def predicted_hours(self) -> float:
         return self.predicted_minutes / 60
 
     @property
-    def range_hours(self) -> Tuple[float, float]:
+    def range_hours(self) -> tuple[float, float]:
         return (self.min_minutes / 60, self.max_minutes / 60)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         return {
-            'embryo_id': self.embryo_id,
-            'current_stage': self.current_stage.value,
-            'predicted_minutes': self.predicted_minutes,
-            'predicted_hours': self.predicted_hours,
-            'min_minutes': self.min_minutes,
-            'max_minutes': self.max_minutes,
-            'range_hours': self.range_hours,
-            'confidence': self.confidence,
-            'timestamp': self.timestamp.isoformat(),
+            "embryo_id": self.embryo_id,
+            "current_stage": self.current_stage.value,
+            "predicted_minutes": self.predicted_minutes,
+            "predicted_hours": self.predicted_hours,
+            "min_minutes": self.min_minutes,
+            "max_minutes": self.max_minutes,
+            "range_hours": self.range_hours,
+            "confidence": self.confidence,
+            "timestamp": self.timestamp.isoformat(),
         }
 
     def __str__(self) -> str:
@@ -137,25 +139,27 @@ def __str__(self) -> str:
 @dataclass
 class StageClassification:
     """Result of a stage classification"""
+
     stage: DevelopmentalStage
     confidence: str  # HIGH, MEDIUM, LOW
     reasoning: str
     timestamp: datetime = field(default_factory=datetime.now)
     timepoint: int = 0
-    predicted_minutes_to_hatching: Optional[int] = None
+    predicted_minutes_to_hatching: int | None = None
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         return {
-            'stage': self.stage.value,
-            'confidence': self.confidence,
-            'reasoning': self.reasoning,
-            'timestamp': self.timestamp.isoformat(),
-            'timepoint': self.timepoint,
-            'predicted_minutes_to_hatching': self.predicted_minutes_to_hatching,
+            "stage": self.stage.value,
+            "confidence": self.confidence,
+            "reasoning": self.reasoning,
+            "timestamp": self.timestamp.isoformat(),
+            "timepoint": self.timepoint,
+            "predicted_minutes_to_hatching": self.predicted_minutes_to_hatching,
         }
 
 
-STAGE_CLASSIFICATION_PROMPT = """Analyze this C. elegans embryo image and determine its DEVELOPMENTAL STAGE.
+STAGE_CLASSIFICATION_PROMPT = """Analyze this C. elegans embryo image and determine its
+DEVELOPMENTAL STAGE.
 
 Stages in order (earliest to latest):
 - 1-cell: Single cell, spherical, no division
@@ -194,7 +198,7 @@ class DevelopmentalTracker:
 
     def __init__(
         self,
-        claude_client: Optional[anthropic.Anthropic] = None,
+        claude_client: anthropic.Anthropic | None = None,
         model: str = settings.models.perception,
     ):
         """
@@ -209,14 +213,14 @@ def __init__(
         self.model = model
 
         # Stage history per embryo
-        self._stage_history: Dict[str, List[StageClassification]] = {}
+        self._stage_history: dict[str, list[StageClassification]] = {}
 
     def classify_stage(
         self,
         image_b64: str,
         embryo_id: str,
         timepoint: int = 0,
-        recent_images: Optional[List[Dict]] = None,
+        recent_images: list[dict] | None = None,
     ) -> StageClassification:
         """
         Classify the developmental stage of an embryo
@@ -242,49 +246,51 @@ def classify_stage(
 
         # Add temporal context if available
         if recent_images and len(recent_images) > 1:
-            content.append({
-                "type": "text",
-                "text": f"Recent images from {embryo_id} (for temporal context):"
-            })
-            for img in recent_images[:-1]:  # All but last
-                content.append({
+            content.append(
+                {
                     "type": "text",
-                    "text": f"Timepoint {img.get('timepoint', '?')}"
-                })
-                content.append({
-                    "type": "image",
-                    "source": {
-                        "type": "base64",
-                        "media_type": "image/jpeg",
-                        "data": img['b64_image']
+                    "text": f"Recent images from {embryo_id} (for temporal context):",
+                }
+            )
+            for img in recent_images[:-1]:  # All but last
+                content.append({"type": "text", "text": f"Timepoint {img.get('timepoint', '?')}"})
+                content.append(
+                    {
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": "image/jpeg",
+                            "data": img["b64_image"],
+                        },
                     }
-                })
+                )
 
         # Add current image
-        content.append({
-            "type": "text",
-            "text": f"CURRENT image (timepoint {timepoint}) - classify this one:"
-        })
-        content.append({
-            "type": "image",
-            "source": {
-                "type": "base64",
-                "media_type": "image/jpeg",
-                "data": image_b64
+        content.append(
+            {
+                "type": "text",
+                "text": f"CURRENT image (timepoint {timepoint}) - classify this one:",
             }
-        })
+        )
+        content.append(
+            {
+                "type": "image",
+                "source": {
+                    "type": "base64",
+                    "media_type": "image/jpeg",
+                    "data": image_b64,
+                },
+            }
+        )
 
         # Add prompt
-        content.append({
-            "type": "text",
-            "text": STAGE_CLASSIFICATION_PROMPT
-        })
+        content.append({"type": "text", "text": STAGE_CLASSIFICATION_PROMPT})
 
         try:
             response = self.claude.messages.create(
                 model=self.model,
                 max_tokens=500,
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             result = self._parse_classification(response.content[0].text)
@@ -321,31 +327,31 @@ def _parse_classification(self, response_text: str) -> StageClassification:
         confidence = "LOW"
         reasoning = ""
 
-        lines = response_text.strip().split('\n')
+        lines = response_text.strip().split("\n")
 
         for line in lines:
             line = line.strip()
-            if line.startswith('STAGE:'):
-                stage_str = line.split(':', 1)[1].strip().lower()
+            if line.startswith("STAGE:"):
+                stage_str = line.split(":", 1)[1].strip().lower()
                 # Map to enum
                 stage = self._parse_stage_name(stage_str)
-            elif line.startswith('CONFIDENCE:'):
-                confidence = line.split(':', 1)[1].strip().upper()
-            elif line.startswith('REASONING:'):
-                reasoning = line.split(':', 1)[1].strip()
+            elif line.startswith("CONFIDENCE:"):
+                confidence = line.split(":", 1)[1].strip().upper()
+            elif line.startswith("REASONING:"):
+                reasoning = line.split(":", 1)[1].strip()
 
         # Capture multi-line reasoning
         if not reasoning:
             in_reasoning = False
             reasoning_lines = []
             for line in lines:
-                if line.startswith('REASONING:'):
+                if line.startswith("REASONING:"):
                     in_reasoning = True
-                    reasoning_lines.append(line.split(':', 1)[1].strip())
+                    reasoning_lines.append(line.split(":", 1)[1].strip())
                 elif in_reasoning and line:
                     reasoning_lines.append(line)
             if reasoning_lines:
-                reasoning = ' '.join(reasoning_lines)
+                reasoning = " ".join(reasoning_lines)
 
         return StageClassification(
             stage=stage,
@@ -359,43 +365,43 @@ def _parse_stage_name(self, name: str) -> DevelopmentalStage:
 
         # Direct matches
         mappings = {
-            '1-cell': DevelopmentalStage.ONE_CELL,
-            'one-cell': DevelopmentalStage.ONE_CELL,
-            '2-cell': DevelopmentalStage.TWO_CELL,
-            'two-cell': DevelopmentalStage.TWO_CELL,
-            '4-cell': DevelopmentalStage.FOUR_CELL,
-            'four-cell': DevelopmentalStage.FOUR_CELL,
-            '8-cell': DevelopmentalStage.EIGHT_CELL,
-            'eight-cell': DevelopmentalStage.EIGHT_CELL,
-            'gastrulation': DevelopmentalStage.GASTRULATION,
-            'comma': DevelopmentalStage.COMMA,
-            '1.5-fold': DevelopmentalStage.ONE_POINT_FIVE_FOLD,
-            '1.5 fold': DevelopmentalStage.ONE_POINT_FIVE_FOLD,
-            '2-fold': DevelopmentalStage.TWO_FOLD,
-            '2 fold': DevelopmentalStage.TWO_FOLD,
-            'pretzel': DevelopmentalStage.PRETZEL,
-            '3-fold': DevelopmentalStage.PRETZEL,
-            '3 fold': DevelopmentalStage.PRETZEL,
-            'pre-hatching': DevelopmentalStage.PRE_HATCHING,
-            'prehatching': DevelopmentalStage.PRE_HATCHING,
-            'hatching': DevelopmentalStage.HATCHING,
-            'hatched': DevelopmentalStage.HATCHED,
-            'dead': DevelopmentalStage.DEAD,
-            'unknown': DevelopmentalStage.UNKNOWN,
+            "1-cell": DevelopmentalStage.ONE_CELL,
+            "one-cell": DevelopmentalStage.ONE_CELL,
+            "2-cell": DevelopmentalStage.TWO_CELL,
+            "two-cell": DevelopmentalStage.TWO_CELL,
+            "4-cell": DevelopmentalStage.FOUR_CELL,
+            "four-cell": DevelopmentalStage.FOUR_CELL,
+            "8-cell": DevelopmentalStage.EIGHT_CELL,
+            "eight-cell": DevelopmentalStage.EIGHT_CELL,
+            "gastrulation": DevelopmentalStage.GASTRULATION,
+            "comma": DevelopmentalStage.COMMA,
+            "1.5-fold": DevelopmentalStage.ONE_POINT_FIVE_FOLD,
+            "1.5 fold": DevelopmentalStage.ONE_POINT_FIVE_FOLD,
+            "2-fold": DevelopmentalStage.TWO_FOLD,
+            "2 fold": DevelopmentalStage.TWO_FOLD,
+            "pretzel": DevelopmentalStage.PRETZEL,
+            "3-fold": DevelopmentalStage.PRETZEL,
+            "3 fold": DevelopmentalStage.PRETZEL,
+            "pre-hatching": DevelopmentalStage.PRE_HATCHING,
+            "prehatching": DevelopmentalStage.PRE_HATCHING,
+            "hatching": DevelopmentalStage.HATCHING,
+            "hatched": DevelopmentalStage.HATCHED,
+            "dead": DevelopmentalStage.DEAD,
+            "unknown": DevelopmentalStage.UNKNOWN,
         }
 
         return mappings.get(name, DevelopmentalStage.UNKNOWN)
 
-    def get_stage_history(self, embryo_id: str) -> List[StageClassification]:
+    def get_stage_history(self, embryo_id: str) -> list[StageClassification]:
         """Get stage classification history for an embryo"""
         return self._stage_history.get(embryo_id, [])
 
-    def get_current_stage(self, embryo_id: str) -> Optional[StageClassification]:
+    def get_current_stage(self, embryo_id: str) -> StageClassification | None:
         """Get the most recent stage classification"""
         history = self._stage_history.get(embryo_id, [])
         return history[-1] if history else None
 
-    def predict_time_to_hatching(self, embryo_id: str) -> Optional[timedelta]:
+    def predict_time_to_hatching(self, embryo_id: str) -> timedelta | None:
         """
         Predict time to hatching based on current stage
 
@@ -422,7 +428,7 @@ def predict_time_to_stage(
         self,
         embryo_id: str,
         target_stage: DevelopmentalStage,
-    ) -> Optional[timedelta]:
+    ) -> timedelta | None:
         """
         Predict time until embryo reaches target stage
 
@@ -457,7 +463,7 @@ def predict_time_to_stage(
         minutes = target_timing - current_timing
         return timedelta(minutes=minutes)
 
-    def get_progression_summary(self, embryo_id: str) -> Dict[str, Any]:
+    def get_progression_summary(self, embryo_id: str) -> dict[str, Any]:
         """
         Get a summary of stage progression for an embryo
 
@@ -475,28 +481,28 @@ def get_progression_summary(self, embryo_id: str) -> Dict[str, Any]:
 
         if not history:
             return {
-                'embryo_id': embryo_id,
-                'observations': 0,
-                'current_stage': None,
-                'stages_observed': [],
-                'predicted_hatching': None,
+                "embryo_id": embryo_id,
+                "observations": 0,
+                "current_stage": None,
+                "stages_observed": [],
+                "predicted_hatching": None,
             }
 
         current = history[-1]
         stages_observed = list(set(h.stage.value for h in history))
 
         return {
-            'embryo_id': embryo_id,
-            'observations': len(history),
-            'current_stage': current.stage.value,
-            'current_confidence': current.confidence,
-            'stages_observed': stages_observed,
-            'first_observation': history[0].timestamp.isoformat(),
-            'last_observation': current.timestamp.isoformat(),
-            'predicted_minutes_to_hatching': current.predicted_minutes_to_hatching,
+            "embryo_id": embryo_id,
+            "observations": len(history),
+            "current_stage": current.stage.value,
+            "current_confidence": current.confidence,
+            "stages_observed": stages_observed,
+            "first_observation": history[0].timestamp.isoformat(),
+            "last_observation": current.timestamp.isoformat(),
+            "predicted_minutes_to_hatching": current.predicted_minutes_to_hatching,
         }
 
-    def get_hatching_prediction(self, embryo_id: str) -> Optional[HatchingPrediction]:
+    def get_hatching_prediction(self, embryo_id: str) -> HatchingPrediction | None:
         """
         Get detailed hatching prediction with confidence interval
 
@@ -525,9 +531,9 @@ def get_hatching_prediction(self, embryo_id: str) -> Optional[HatchingPrediction
 
         # Adjust confidence interval based on classification confidence
         confidence_multiplier = {
-            'HIGH': 1.0,
-            'MEDIUM': 1.5,
-            'LOW': 2.0,
+            "HIGH": 1.0,
+            "MEDIUM": 1.5,
+            "LOW": 2.0,
         }.get(current.confidence, 2.0)
 
         adjusted_variability = int(variability * confidence_multiplier)
@@ -541,7 +547,7 @@ def get_hatching_prediction(self, embryo_id: str) -> Optional[HatchingPrediction
             confidence=current.confidence,
         )
 
-    def get_all_predictions(self, embryo_ids: List[str]) -> Dict[str, HatchingPrediction]:
+    def get_all_predictions(self, embryo_ids: list[str]) -> dict[str, HatchingPrediction]:
         """
         Get predictions for multiple embryos
 
@@ -562,7 +568,7 @@ def get_all_predictions(self, embryo_ids: List[str]) -> Dict[str, HatchingPredic
                 predictions[embryo_id] = pred
         return predictions
 
-    def estimate_development_rate(self, embryo_id: str) -> Optional[float]:
+    def estimate_development_rate(self, embryo_id: str) -> float | None:
         """
         Estimate relative development rate compared to standard
 
@@ -584,7 +590,9 @@ def estimate_development_rate(self, embryo_id: str) -> Optional[float]:
             return None
 
         # Need at least two different stages
-        stages_seen = [(h.stage, h.timestamp) for h in history if h.stage != DevelopmentalStage.UNKNOWN]
+        stages_seen = [
+            (h.stage, h.timestamp) for h in history if h.stage != DevelopmentalStage.UNKNOWN
+        ]
         if len(stages_seen) < 2:
             return None
 
diff --git a/gently/organisms/celegans/perception_prompt.py b/gently/organisms/celegans/perception_prompt.py
index 2604a6c7..895fa3e6 100644
--- a/gently/organisms/celegans/perception_prompt.py
+++ b/gently/organisms/celegans/perception_prompt.py
@@ -5,7 +5,8 @@
 Extracted from gently/agent/perception/engine.py.
 """
 
-PERCEPTION_SYSTEM_PROMPT = """You are an expert microscopy perception system analyzing C. elegans embryo development.
+PERCEPTION_SYSTEM_PROMPT = """You are an expert microscopy perception system analyzing
+C. elegans embryo development.
 
 IMPORTANT PRINCIPLES:
 1. DESCRIBE FIRST: Always describe what you actually see BEFORE classifying
@@ -23,27 +24,35 @@
 
 - XY (top-left): Looking DOWN - Best for end asymmetry, ventral indentation, folding
 - YZ (top-right): Looking from SIDE - Best for body height/thickness
-- XZ (bottom): Looking from FRONT - CRITICAL for early->bean transition (look for "peanut" or central constriction)
+- XZ (bottom): Looking from FRONT - CRITICAL for early->bean transition (look for "peanut"
+  or central constriction)
 
-**ALWAYS ANALYZE XZ VIEW**: The XZ view often shows bean-stage features (central constriction, "peanut" shape) BEFORE they're visible in XY. If XZ shows ANY central narrowing or figure-8 appearance, this suggests bean stage even if XY looks symmetric.
+**ALWAYS ANALYZE XZ VIEW**: The XZ view often shows bean-stage features (central
+constriction, "peanut" shape) BEFORE they're visible in XY. If XZ shows ANY central
+narrowing or figure-8 appearance, this suggests bean stage even if XY looks symmetric.
 
 DEVELOPMENTAL STAGES:
 
 EARLY: Elongated oval (~2:1), SYMMETRIC ENDS, both edges CONVEX, NO central constriction in XZ
-BEAN: Even SUBTLE end asymmetry OR central constriction/"peanut" shape in XZ view, edges still CONVEX
-COMMA: One edge FLAT or curves INWARD (ventral indentation). XZ shows side-by-side lobes (horizontal figure-8)
-1.5-FOLD: Body folding back. XZ shows STACKED horizontal layers (two parallel bands, one above the other)
+BEAN: Even SUBTLE end asymmetry OR central constriction/"peanut" shape in XZ view, edges
+  still CONVEX
+COMMA: One edge FLAT or curves INWARD (ventral indentation). XZ shows side-by-side lobes
+  (horizontal figure-8)
+1.5-FOLD: Body folding back. XZ shows STACKED horizontal layers (two parallel bands, one
+  above the other)
 2-FOLD: Body doubled back completely. XZ shows TWO DISTINCT HORIZONTAL LINES with dark gap between
 PRETZEL: Tightly coiled, 3+ body segments visible as multiple stacked layers
 HATCHED: Worm exited shell
 
 CRITICAL FOR EARLY vs BEAN vs COMMA:
 - EARLY: Both ends symmetric AND both edges convex AND no central constriction in XZ
-- BEAN: ANY of these: subtle end tapering, central constriction in XZ, "peanut" shape - edges still convex
+- BEAN: ANY of these: subtle end tapering, central constriction in XZ, "peanut" shape -
+  edges still convex
 - COMMA: One edge is flat or curves INWARD (not convex)
 
 CRITICAL FOR BEAN/COMMA vs FOLD STAGES (examine XZ view carefully):
-The XZ view shows two masses in BOTH bean/comma AND fold stages - the key is their VERTICAL ARRANGEMENT:
+The XZ view shows two masses in BOTH bean/comma AND fold stages - the key is their VERTICAL
+ARRANGEMENT:
 
 BEAN/COMMA XZ: Two lobes at the SAME VERTICAL LEVEL
 - Lobes are side-by-side horizontally, spanning the same vertical range
@@ -67,11 +76,14 @@
 - Figure-8 or peanut appearance in any view
 Mark as TRANSITIONAL (early->bean) or BEAN with appropriate confidence.
 
-SPECIAL: If the field of view is EMPTY (no embryo, no eggshell, only background/debris), return "no_object".
+SPECIAL: If the field of view is EMPTY (no embryo, no eggshell, only background/debris),
+return "no_object".
 
 Respond with JSON:
 {
-  "observed_features": {"shape": "...", "curvature": "...", "shell_status": "...", "emergence": "..."},
+  "observed_features": {
+    "shape": "...", "curvature": "...", "shell_status": "...", "emergence": "..."
+  },
   "contrastive_reasoning": {"why_not_previous_stage": "...", "why_not_next_stage": "..."},
   "stage": "early|bean|comma|1.5fold|2fold|pretzel|hatching|hatched|arrested|no_object",
   "is_transitional": true/false,
diff --git a/gently/organisms/celegans/stages.py b/gently/organisms/celegans/stages.py
index 4ad16970..b75f8d34 100644
--- a/gently/organisms/celegans/stages.py
+++ b/gently/organisms/celegans/stages.py
@@ -5,7 +5,7 @@
 """
 
 from enum import Enum
-from typing import List, Dict, Any
+from typing import Any
 
 
 class DevelopmentalStage(str, Enum):
@@ -21,27 +21,34 @@ class DevelopmentalStage(str, Enum):
     Special states:
     - "arrested" is not part of normal progression (dead/arrested embryo)
     """
-    EARLY = "early"           # Gastrulation through early morphogenesis, oval shape
-    BEAN = "bean"             # Elongated oval, "bean-shaped", pre-comma curvature
-    COMMA = "comma"           # Clear C-shape, head/tail distinguishable
-    FOLD_1_5 = "1.5fold"      # Elongation, ~1.5x eggshell length
-    FOLD_2 = "2fold"          # Body folded back twice, between 1.5fold and pretzel
-    PRETZEL = "pretzel"       # Tight coil, 3+ body segments (formerly 3fold)
-    HATCHING = "hatching"     # Active emergence, shell breach visible
-    HATCHED = "hatched"       # Fully emerged L1 larva
-    ARRESTED = "arrested"     # Dead or developmentally arrested embryo (special state)
-    NO_OBJECT = "no_object"   # No embryo visible in field of view (special state)
+
+    EARLY = "early"  # Gastrulation through early morphogenesis, oval shape
+    BEAN = "bean"  # Elongated oval, "bean-shaped", pre-comma curvature
+    COMMA = "comma"  # Clear C-shape, head/tail distinguishable
+    FOLD_1_5 = "1.5fold"  # Elongation, ~1.5x eggshell length
+    FOLD_2 = "2fold"  # Body folded back twice, between 1.5fold and pretzel
+    PRETZEL = "pretzel"  # Tight coil, 3+ body segments (formerly 3fold)
+    HATCHING = "hatching"  # Active emergence, shell breach visible
+    HATCHED = "hatched"  # Fully emerged L1 larva
+    ARRESTED = "arrested"  # Dead or developmentally arrested embryo (special state)
+    NO_OBJECT = "no_object"  # No embryo visible in field of view (special state)
 
     @classmethod
-    def ordered_list(cls) -> List["DevelopmentalStage"]:
+    def ordered_list(cls) -> list["DevelopmentalStage"]:
         """Return stages in developmental order."""
         return [
-            cls.EARLY, cls.BEAN, cls.COMMA, cls.FOLD_1_5,
-            cls.FOLD_2, cls.PRETZEL, cls.HATCHING, cls.HATCHED
+            cls.EARLY,
+            cls.BEAN,
+            cls.COMMA,
+            cls.FOLD_1_5,
+            cls.FOLD_2,
+            cls.PRETZEL,
+            cls.HATCHING,
+            cls.HATCHED,
         ]
 
     @classmethod
-    def ordered_values(cls) -> List[str]:
+    def ordered_values(cls) -> list[str]:
         """Return stage string values in developmental order."""
         return [s.value for s in cls.ordered_list()]
 
@@ -61,7 +68,7 @@ def is_valid(cls, stage: str) -> bool:
         return stage in cls.all_valid_values()
 
     @classmethod
-    def all_valid_values(cls) -> List[str]:
+    def all_valid_values(cls) -> list[str]:
         """Return all valid stage values including special states like 'arrested'."""
         return cls.ordered_values() + ["arrested", "no_object"]
 
@@ -97,7 +104,7 @@ def compare(cls, stage_a: str, stage_b: str) -> int:
 # Each stage has:
 #   - features: what to look for (positive indicators)
 #   - NOT_if: what rules out this stage (negative indicators)
-STAGE_CRITERIA: Dict[str, Dict[str, Any]] = {
+STAGE_CRITERIA: dict[str, dict[str, Any]] = {
     "early": {
         "features": [
             "oval/elliptical shape",
@@ -249,7 +256,7 @@ def compare(cls, stage_a: str, stage_b: str) -> int:
 
 # Transition zones between stages
 # Used for detecting transitional states and setting expectations for temporal analysis
-TRANSITION_ZONES: Dict[str, Dict[str, Any]] = {
+TRANSITION_ZONES: dict[str, dict[str, Any]] = {
     "early_to_bean": {
         "from_stage": "early",
         "to_stage": "bean",
@@ -325,7 +332,7 @@ def compare(cls, stage_a: str, stage_b: str) -> int:
 }
 
 
-def get_transition_zone(from_stage: str, to_stage: str) -> Dict[str, Any]:
+def get_transition_zone(from_stage: str, to_stage: str) -> dict[str, Any]:
     """Get transition zone info between two stages."""
     key = f"{from_stage}_to_{to_stage}"
     return TRANSITION_ZONES.get(key, {})
diff --git a/gently/settings.py b/gently/settings.py
index 5a0bdb89..68cebd38 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -4,6 +4,7 @@
 All configurable values live here. Override via environment variables
 prefixed with GENTLY_ (e.g., GENTLY_VIZ_PORT=9090).
 """
+
 import os
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -29,6 +30,7 @@ def _env(key: str, default):
 @dataclass(frozen=True)
 class NetworkSettings:
     """Ports, hosts, and bind addresses."""
+
     viz_port: int = field(default_factory=lambda: _env("VIZ_PORT", 8080))
     viz_host: str = field(default_factory=lambda: _env("VIZ_HOST", "0.0.0.0"))
     device_port: int = field(default_factory=lambda: _env("DEVICE_PORT", 60610))
@@ -40,7 +42,10 @@ class NetworkSettings:
 @dataclass(frozen=True)
 class MeshSettings:
     """Mesh networking parameters."""
-    broadcast_interval_s: float = field(default_factory=lambda: _env("MESH_BROADCAST_INTERVAL", 5.0))
+
+    broadcast_interval_s: float = field(
+        default_factory=lambda: _env("MESH_BROADCAST_INTERVAL", 5.0)
+    )
     replay_window_s: float = field(default_factory=lambda: _env("MESH_REPLAY_WINDOW", 30.0))
     reaper_interval_s: float = field(default_factory=lambda: _env("MESH_REAPER_INTERVAL", 10.0))
     status_refresh_s: float = field(default_factory=lambda: _env("MESH_STATUS_REFRESH", 30.0))
@@ -52,8 +57,11 @@ class MeshSettings:
 @dataclass(frozen=True)
 class ModelSettings:
     """Claude model identifiers."""
+
     main: str = field(default_factory=lambda: _env("MODEL_MAIN", "claude-opus-4-6"))
-    perception: str = field(default_factory=lambda: _env("MODEL_PERCEPTION", "claude-opus-4-5-20251101"))
+    perception: str = field(
+        default_factory=lambda: _env("MODEL_PERCEPTION", "claude-opus-4-5-20251101")
+    )
     fast: str = field(default_factory=lambda: _env("MODEL_FAST", "claude-haiku-4-5-20251001"))
     medium: str = field(default_factory=lambda: _env("MODEL_MEDIUM", "claude-sonnet-4-5-20250929"))
 
@@ -61,6 +69,7 @@ class ModelSettings:
 @dataclass(frozen=True)
 class StorageSettings:
     """File paths for data storage."""
+
     base_path: Path = field(default_factory=lambda: _env("STORAGE_PATH", Path("D:/Gently3")))
 
     @property
@@ -75,6 +84,7 @@ def traces_dir(self) -> Path:
 @dataclass(frozen=True)
 class TimeoutSettings:
     """Timeout values in seconds."""
+
     plan_execution: int = field(default_factory=lambda: _env("TIMEOUT_PLAN", 300))
     rpc_call: int = field(default_factory=lambda: _env("TIMEOUT_RPC", 60))
     volume_acquisition: int = field(default_factory=lambda: _env("TIMEOUT_VOLUME", 15))
@@ -84,6 +94,7 @@ class TimeoutSettings:
 @dataclass(frozen=True)
 class ApiSettings:
     """External API configuration."""
+
     ncbi_tool: str = field(default_factory=lambda: _env("NCBI_TOOL", "gently"))
     ncbi_email: str = field(default_factory=lambda: _env("NCBI_EMAIL", "pskeshu@gmail.com"))
 
@@ -91,6 +102,7 @@ class ApiSettings:
 @dataclass(frozen=True)
 class MlSettings:
     """Machine learning training parameters."""
+
     model_cache_dir: Path = field(default_factory=lambda: _env("ML_MODEL_CACHE", Path("models")))
     default_batch_size: int = field(default_factory=lambda: _env("ML_BATCH_SIZE", 32))
     default_epochs: int = field(default_factory=lambda: _env("ML_EPOCHS", 50))
@@ -100,14 +112,18 @@ class MlSettings:
 @dataclass(frozen=True)
 class TransferSettings:
     """Bulk transfer protocol parameters."""
+
     transfer_port: int = field(default_factory=lambda: _env("TRANSFER_PORT", 19548))
     chunk_size: int = field(default_factory=lambda: _env("TRANSFER_CHUNK_SIZE", 1048576))  # 1MB
-    max_concurrent_transfers: int = field(default_factory=lambda: _env("TRANSFER_MAX_CONCURRENT", 4))
+    max_concurrent_transfers: int = field(
+        default_factory=lambda: _env("TRANSFER_MAX_CONCURRENT", 4)
+    )
 
 
 @dataclass(frozen=True)
 class Settings:
     """Top-level settings container."""
+
     network: NetworkSettings = field(default_factory=NetworkSettings)
     mesh: MeshSettings = field(default_factory=MeshSettings)
     models: ModelSettings = field(default_factory=ModelSettings)
diff --git a/gently/ui/web/__init__.py b/gently/ui/web/__init__.py
index 1ef5ab2d..ab5bcd57 100644
--- a/gently/ui/web/__init__.py
+++ b/gently/ui/web/__init__.py
@@ -13,20 +13,23 @@
 
 from .embryo_marker import mark_embryos_web
 from .plots import (
-    generate_focus_curve_plot,
     generate_calibration_summary_plot,
     generate_edge_detection_plot,
+    generate_focus_curve_plot,
 )
 
+
 # Lazy import for server (requires FastAPI)
 def get_visualization_server():
     from .server import VisualizationServer, create_visualization_server
+
     return VisualizationServer, create_visualization_server
 
+
 __all__ = [
-    'mark_embryos_web',
-    'get_visualization_server',
-    'generate_focus_curve_plot',
-    'generate_calibration_summary_plot',
-    'generate_edge_detection_plot',
+    "mark_embryos_web",
+    "get_visualization_server",
+    "generate_focus_curve_plot",
+    "generate_calibration_summary_plot",
+    "generate_edge_detection_plot",
 ]
diff --git a/gently/ui/web/accounts.py b/gently/ui/web/accounts.py
index 2a534c44..3da1c1a0 100644
--- a/gently/ui/web/accounts.py
+++ b/gently/ui/web/accounts.py
@@ -27,7 +27,6 @@
 import time
 from datetime import datetime
 from pathlib import Path
-from typing import Optional, Tuple
 
 import yaml
 
@@ -72,8 +71,7 @@ def _load_users(self) -> dict:
 
     def _save_users(self) -> None:
         tmp = self.users_path.with_suffix(".yaml.tmp")
-        tmp.write_text(yaml.safe_dump({"users": self._users}, sort_keys=True),
-                       encoding="utf-8")
+        tmp.write_text(yaml.safe_dump({"users": self._users}, sort_keys=True), encoding="utf-8")
         tmp.replace(self.users_path)  # atomic
 
     def _load_or_create_secret(self) -> bytes:
@@ -92,10 +90,11 @@ def has_users(self) -> bool:
         return bool(self._users)
 
     def list_users(self) -> list:
-        return [{"username": u, "role": r.get("role", "viewer")}
-                for u, r in sorted(self._users.items())]
+        return [
+            {"username": u, "role": r.get("role", "viewer")} for u, r in sorted(self._users.items())
+        ]
 
-    def get_role(self, username: str) -> Optional[str]:
+    def get_role(self, username: str) -> str | None:
         rec = self._users.get(username)
         return rec.get("role") if rec else None
 
@@ -118,7 +117,7 @@ def create_user(self, username: str, password: str, role: str = "viewer") -> Non
         }
         self._save_users()
 
-    def verify_password(self, username: str, password: str) -> Optional[str]:
+    def verify_password(self, username: str, password: str) -> str | None:
         """Return the user's role if the password matches, else None."""
         rec = self._users.get((username or "").strip())
         if not rec:
@@ -134,7 +133,7 @@ def verify_password(self, username: str, password: str) -> Optional[str]:
             return rec.get("role", "viewer")
         return None
 
-    def bootstrap_admin_if_empty(self) -> Optional[Tuple[str, str]]:
+    def bootstrap_admin_if_empty(self) -> tuple[str, str] | None:
         """If no users exist, create an admin with a random password.
 
         Returns (username, password) so the launcher can print it once, or
@@ -150,11 +149,11 @@ def bootstrap_admin_if_empty(self) -> Optional[Tuple[str, str]]:
     # ── Sessions (stateless signed cookie) ────────────────────
     def issue_session(self, username: str, ttl: int = _SESSION_TTL_SECONDS) -> str:
         expiry = int(time.time()) + ttl
-        payload = f"{username}|{expiry}".encode("utf-8")
+        payload = f"{username}|{expiry}".encode()
         sig = hmac.new(self._secret, payload, hashlib.sha256).digest()
         return f"{_b64(payload)}.{_b64(sig)}"
 
-    def verify_session(self, token: str) -> Optional[str]:
+    def verify_session(self, token: str) -> str | None:
         """Return the username for a valid, unexpired token, else None."""
         if not token or "." not in token:
             return None
@@ -178,13 +177,13 @@ def verify_session(self, token: str) -> Optional[str]:
 
 
 # ── Module-level singleton (set during server init) ───────────
-_store: Optional[AccountStore] = None
+_store: AccountStore | None = None
 
 
-def set_account_store(store: Optional[AccountStore]) -> None:
+def set_account_store(store: AccountStore | None) -> None:
     global _store
     _store = store
 
 
-def get_account_store() -> Optional[AccountStore]:
+def get_account_store() -> AccountStore | None:
     return _store
diff --git a/gently/ui/web/auth.py b/gently/ui/web/auth.py
index 2f2d9927..f57ccb2d 100644
--- a/gently/ui/web/auth.py
+++ b/gently/ui/web/auth.py
@@ -36,14 +36,14 @@ async def foo(_=Depends(require_control)):
 # Header name used to upgrade a remote session to control role (legacy
 # single-shared-token path, used only when no user accounts are configured).
 _TOKEN_HEADER = "X-Gently-Token"
-_TOKEN_ENV    = "GENTLY_CONTROL_TOKEN"
+_TOKEN_ENV = "GENTLY_CONTROL_TOKEN"
 
 # Browser session cookie set by the login flow (see routes/auth_routes.py).
 SESSION_COOKIE = "gently_session"
 
 
 class Role(str, Enum):
-    VIEW    = "view"
+    VIEW = "view"
     CONTROL = "control"
 
 
@@ -53,6 +53,7 @@ def current_username(request: Request) -> str | None:
     None when no account store is configured or the cookie is missing/invalid.
     """
     from gently.ui.web.accounts import get_account_store
+
     store = get_account_store()
     if store is None:
         return None
@@ -82,7 +83,8 @@ def resolve_role(request: Request) -> Role:
     GENTLY_CONTROL_TOKEN. This keeps existing single-operator rigs working
     until an admin provisions accounts.
     """
-    from gently.ui.web.accounts import get_account_store, CONTROL_ROLES
+    from gently.ui.web.accounts import CONTROL_ROLES, get_account_store
+
     store = get_account_store()
     if store is not None and store.has_users():
         username = current_username(request)
@@ -116,11 +118,10 @@ def require_control(request: Request) -> Role:
     if role is Role.CONTROL:
         return role
     host = request.client.host if request.client else "unknown"
-    logger.warning("control-route 403 for %s -> %s %s",
-                   host, request.method, request.url.path)
+    logger.warning("control-route 403 for %s -> %s %s", host, request.method, request.url.path)
     raise HTTPException(
         status_code=403,
         detail="control role required (this endpoint moves hardware or "
-               "mutates persistent state; localhost has it by default, "
-               "remote callers need X-Gently-Token)",
+        "mutates persistent state; localhost has it by default, "
+        "remote callers need X-Gently-Token)",
     )
diff --git a/gently/ui/web/connection_manager.py b/gently/ui/web/connection_manager.py
index 266e9cb2..ffaaf11a 100644
--- a/gently/ui/web/connection_manager.py
+++ b/gently/ui/web/connection_manager.py
@@ -9,7 +9,6 @@
 import json
 import logging
 from datetime import datetime
-from typing import Dict, Optional
 
 from .models import ClientInfo, ImageData
 
@@ -18,6 +17,7 @@
 # Optional imports
 try:
     from fastapi import WebSocket
+
     FASTAPI_AVAILABLE = True
 except ImportError:
     FASTAPI_AVAILABLE = False
@@ -28,13 +28,25 @@ class ConnectionManager:
 
     # Colors for avatar backgrounds (pleasant, distinct colors)
     AVATAR_COLORS = [
-        '#4a9eff', '#ff6b6b', '#51cf66', '#ffd43b', '#cc5de8',
-        '#ff922b', '#20c997', '#748ffc', '#f06595', '#69db7c',
-        '#ffa94d', '#9775fa', '#38d9a9', '#e599f7', '#74c0fc'
+        "#4a9eff",
+        "#ff6b6b",
+        "#51cf66",
+        "#ffd43b",
+        "#cc5de8",
+        "#ff922b",
+        "#20c997",
+        "#748ffc",
+        "#f06595",
+        "#69db7c",
+        "#ffa94d",
+        "#9775fa",
+        "#38d9a9",
+        "#e599f7",
+        "#74c0fc",
     ]
 
     def __init__(self):
-        self.active_connections: Dict[WebSocket, ClientInfo] = {}
+        self.active_connections: dict[WebSocket, ClientInfo] = {}
         self._lock = asyncio.Lock()
 
     def _generate_color(self, client_id: str) -> str:
@@ -48,6 +60,7 @@ async def connect(self, websocket: WebSocket, client_id: str = None, name: str =
         # Generate defaults if not provided
         if not client_id:
             import uuid
+
             client_id = str(uuid.uuid4())[:8]
         if not name:
             name = f"Anonymous {client_id[:4]}"
@@ -56,12 +69,14 @@ async def connect(self, websocket: WebSocket, client_id: str = None, name: str =
             client_id=client_id,
             name=name,
             color=self._generate_color(client_id),
-            connected_at=datetime.now().isoformat()
+            connected_at=datetime.now().isoformat(),
         )
 
         async with self._lock:
             self.active_connections[websocket] = client_info
-        logger.info(f"WebSocket connected: {name} ({client_id}). Total: {len(self.active_connections)}")
+        logger.info(
+            f"WebSocket connected: {name} ({client_id}). Total: {len(self.active_connections)}"
+        )
 
         # Broadcast updated presence to all clients
         await self.broadcast_presence()
@@ -70,7 +85,9 @@ async def disconnect(self, websocket: WebSocket):
         async with self._lock:
             client_info = self.active_connections.pop(websocket, None)
         if client_info:
-            logger.info(f"WebSocket disconnected: {client_info.name}. Total: {len(self.active_connections)}")
+            logger.info(
+                f"WebSocket disconnected: {client_info.name}. Total: {len(self.active_connections)}"
+            )
         else:
             logger.info(f"WebSocket disconnected. Total: {len(self.active_connections)}")
 
@@ -86,11 +103,11 @@ async def update_client_name(self, websocket: WebSocket, name: str):
                     client_id=old_info.client_id,
                     name=name,
                     color=old_info.color,
-                    connected_at=old_info.connected_at
+                    connected_at=old_info.connected_at,
                 )
         await self.broadcast_presence()
 
-    def get_client_info(self, websocket: WebSocket) -> Optional[ClientInfo]:
+    def get_client_info(self, websocket: WebSocket) -> ClientInfo | None:
         """Get client info for a websocket"""
         return self.active_connections.get(websocket)
 
@@ -102,12 +119,12 @@ async def broadcast_presence(self):
         # Deduplicate by client_id (same user in multiple tabs = one avatar)
         async with self._lock:
             seen_clients = {}
-            for ws, info in self.active_connections.items():
+            for _ws, info in self.active_connections.items():
                 # Keep the most recent entry for each client_id
                 seen_clients[info.client_id] = {
-                    'client_id': info.client_id,
-                    'name': info.name,
-                    'color': info.color
+                    "client_id": info.client_id,
+                    "name": info.name,
+                    "color": info.color,
                 }
             clients_list = list(seen_clients.values())
 
@@ -117,14 +134,8 @@ async def broadcast_presence(self):
             try:
                 personalized = []
                 for client in clients_list:
-                    personalized.append({
-                        **client,
-                        'is_you': client['client_id'] == info.client_id
-                    })
-                await ws.send_json({
-                    'type': 'presence',
-                    'clients': personalized
-                })
+                    personalized.append({**client, "is_you": client["client_id"] == info.client_id})
+                await ws.send_json({"type": "presence", "clients": personalized})
             except Exception:
                 disconnected.append(ws)
 
@@ -133,7 +144,7 @@ async def broadcast_presence(self):
             for ws in disconnected:
                 self.active_connections.pop(ws, None)
 
-    async def broadcast(self, message: Dict):
+    async def broadcast(self, message: dict):
         """Broadcast message to all connected clients"""
         if not self.active_connections:
             return
@@ -154,18 +165,19 @@ async def broadcast(self, message: Dict):
 
     async def send_image(self, image_data: ImageData):
         """Send image data to all connected clients"""
-        await self.broadcast({
-            'type': 'image',
-            'data': image_data.to_dict()
-        })
+        await self.broadcast({"type": "image", "data": image_data.to_dict()})
 
-    async def send_event(self, event_type: str, data: Dict, source: str = None, event_id: str = None):
+    async def send_event(
+        self, event_type: str, data: dict, source: str = None, event_id: str = None
+    ):
         """Send event notification to all clients"""
-        await self.broadcast({
-            'type': 'event',
-            'event_type': event_type,
-            'data': data,
-            'source': source or 'unknown',
-            'event_id': event_id or '',
-            'timestamp': datetime.now().isoformat()
-        })
+        await self.broadcast(
+            {
+                "type": "event",
+                "event_type": event_type,
+                "data": data,
+                "source": source or "unknown",
+                "event_id": event_id or "",
+                "timestamp": datetime.now().isoformat(),
+            }
+        )
diff --git a/gently/ui/web/embryo_marker.py b/gently/ui/web/embryo_marker.py
index e84b26a4..b6671f71 100644
--- a/gently/ui/web/embryo_marker.py
+++ b/gently/ui/web/embryo_marker.py
@@ -13,9 +13,7 @@
 """
 
 import logging
-from typing import List, Dict, Tuple, Optional
 from pathlib import Path
-from datetime import datetime
 
 import numpy as np
 
@@ -25,13 +23,13 @@
 async def mark_embryos_web(
     viz_server,
     image: np.ndarray,
-    initial_stage_position: Tuple[float, float],
+    initial_stage_position: tuple[float, float],
     pixel_size_um: float = 0.65,
-    timeout: Optional[float] = None,
-    save_image_path: Optional[Path] = None,
-    initial_markers: Optional[List[Dict]] = None,
+    timeout: float | None = None,
+    save_image_path: Path | None = None,
+    initial_markers: list[dict] | None = None,
     default_role: str = "test",
-) -> List[Dict]:
+) -> list[dict]:
     """
     Interactive embryo marking via the web map view.
 
@@ -86,43 +84,52 @@ async def mark_embryos_web(
     return embryos
 
 
-def _save_marked_image(image: np.ndarray, embryos: List[Dict], output_path: Path):
+def _save_marked_image(image: np.ndarray, embryos: list[dict], output_path: Path):
     """Save image with embryo markers drawn on it."""
-    from PIL import Image as PILImage, ImageDraw, ImageFont
+    from PIL import Image as PILImage
+    from PIL import ImageDraw, ImageFont
 
     output_path = Path(output_path)
 
     if image.dtype != np.uint8:
-        img_normalized = ((image - image.min()) /
-                         max(image.max() - image.min(), 1) * 255).astype(np.uint8)
+        img_normalized = ((image - image.min()) / max(image.max() - image.min(), 1) * 255).astype(
+            np.uint8
+        )
     else:
         img_normalized = image
 
     pil_image = PILImage.fromarray(img_normalized)
-    if pil_image.mode != 'RGB':
-        pil_image = pil_image.convert('RGB')
+    if pil_image.mode != "RGB":
+        pil_image = pil_image.convert("RGB")
 
     draw = ImageDraw.Draw(pil_image)
 
     for embryo in embryos:
-        pixel_x, pixel_y = embryo['pixel_position']
-        embryo_num = embryo.get('embryo_number') or embryo.get('embryo_id') or '?'
+        pixel_x, pixel_y = embryo["pixel_position"]
+        embryo_num = embryo.get("embryo_number") or embryo.get("embryo_id") or "?"
 
         marker_size = 20
         draw.line(
             [(pixel_x - marker_size, pixel_y), (pixel_x + marker_size, pixel_y)],
-            fill=(0, 255, 255), width=3
+            fill=(0, 255, 255),
+            width=3,
         )
         draw.line(
             [(pixel_x, pixel_y - marker_size), (pixel_x, pixel_y + marker_size)],
-            fill=(0, 255, 255), width=3
+            fill=(0, 255, 255),
+            width=3,
         )
 
         circle_radius = 40
         draw.ellipse(
-            [pixel_x - circle_radius, pixel_y - circle_radius,
-             pixel_x + circle_radius, pixel_y + circle_radius],
-            outline=(0, 255, 255), width=2
+            [
+                pixel_x - circle_radius,
+                pixel_y - circle_radius,
+                pixel_x + circle_radius,
+                pixel_y + circle_radius,
+            ],
+            outline=(0, 255, 255),
+            width=2,
         )
 
         try:
@@ -130,8 +137,12 @@ def _save_marked_image(image: np.ndarray, embryos: List[Dict], output_path: Path
         except Exception:
             font = ImageFont.load_default()
 
-        draw.text((pixel_x - 10, pixel_y + circle_radius + 5),
-                  str(embryo_num), fill=(0, 255, 255), font=font)
+        draw.text(
+            (pixel_x - 10, pixel_y + circle_radius + 5),
+            str(embryo_num),
+            fill=(0, 255, 255),
+            font=font,
+        )
 
     pil_image.save(output_path)
     logger.info("Saved marked image: %s", output_path)
diff --git a/gently/ui/web/image_store.py b/gently/ui/web/image_store.py
index d27b236c..09fcd49f 100644
--- a/gently/ui/web/image_store.py
+++ b/gently/ui/web/image_store.py
@@ -5,11 +5,13 @@
 Organized storage for images by type and embryo.
 """
 
-from typing import Dict, List, Optional
-
 from .models import (
-    ImageData, EmbryoImageCache, Volume3DData,
-    CALIBRATION_TYPES, VOLUME_TYPES, ANALYSIS_TYPES,
+    ANALYSIS_TYPES,
+    CALIBRATION_TYPES,
+    VOLUME_TYPES,
+    EmbryoImageCache,
+    ImageData,
+    Volume3DData,
 )
 
 
@@ -17,11 +19,11 @@ class ImageStore:
     """Organized storage for images by type and embryo (unlimited)"""
 
     def __init__(self):
-        self._embryo_caches: Dict[str, EmbryoImageCache] = {}
-        self._global_images: List[ImageData] = []  # Images without embryo_id
-        self._calibration_images: List[ImageData] = []  # Global calibration
-        self._volume_images: List[ImageData] = []  # Global volumes
-        self._volumes_3d: Dict[str, Volume3DData] = {}  # 3D volumes by UID
+        self._embryo_caches: dict[str, EmbryoImageCache] = {}
+        self._global_images: list[ImageData] = []  # Images without embryo_id
+        self._calibration_images: list[ImageData] = []  # Global calibration
+        self._volume_images: list[ImageData] = []  # Global volumes
+        self._volumes_3d: dict[str, Volume3DData] = {}  # 3D volumes by UID
 
     def _get_embryo_cache(self, embryo_id: str) -> EmbryoImageCache:
         if embryo_id not in self._embryo_caches:
@@ -30,7 +32,7 @@ def _get_embryo_cache(self, embryo_id: str) -> EmbryoImageCache:
 
     def add_image(self, image: ImageData):
         """Add image to appropriate storage based on type and embryo"""
-        embryo_id = image.metadata.get('embryo_id')
+        embryo_id = image.metadata.get("embryo_id")
         data_type = image.data_type
 
         if data_type in CALIBRATION_TYPES or data_type in ANALYSIS_TYPES:
@@ -55,7 +57,7 @@ def add_image(self, image: ImageData):
             else:
                 self._global_images.append(image)
 
-    def get_all_calibration(self, embryo_id: Optional[str] = None) -> List[ImageData]:
+    def get_all_calibration(self, embryo_id: str | None = None) -> list[ImageData]:
         """Get calibration images, optionally filtered by embryo"""
         if embryo_id:
             cache = self._embryo_caches.get(embryo_id)
@@ -66,7 +68,7 @@ def get_all_calibration(self, embryo_id: Optional[str] = None) -> List[ImageData
             all_cal.extend(cache.calibration)
         return sorted(all_cal, key=lambda x: x.timestamp)
 
-    def get_all_volumes(self, embryo_id: Optional[str] = None) -> List[ImageData]:
+    def get_all_volumes(self, embryo_id: str | None = None) -> list[ImageData]:
         """Get volume images, optionally filtered by embryo"""
         if embryo_id:
             cache = self._embryo_caches.get(embryo_id)
@@ -76,7 +78,7 @@ def get_all_volumes(self, embryo_id: Optional[str] = None) -> List[ImageData]:
             all_vol.extend(cache.volumes)
         return sorted(all_vol, key=lambda x: x.timestamp)
 
-    def get_all_snapshots(self, embryo_id: Optional[str] = None) -> List[ImageData]:
+    def get_all_snapshots(self, embryo_id: str | None = None) -> list[ImageData]:
         """Get snapshot images (including volume projections), optionally filtered by embryo"""
         if embryo_id:
             cache = self._embryo_caches.get(embryo_id)
@@ -91,11 +93,11 @@ def get_all_snapshots(self, embryo_id: Optional[str] = None) -> List[ImageData]:
             all_snap.extend(cache.volumes)
         return sorted(all_snap, key=lambda x: x.timestamp)
 
-    def get_embryo_ids(self) -> List[str]:
+    def get_embryo_ids(self) -> list[str]:
         """Get list of all embryo IDs with images"""
         return list(self._embryo_caches.keys())
 
-    def get_image_by_uid(self, uid: str) -> Optional[ImageData]:
+    def get_image_by_uid(self, uid: str) -> ImageData | None:
         """Find image by UID across all storage"""
         for img in self._global_images:
             if img.uid == uid:
@@ -120,11 +122,11 @@ def add_volume_3d(self, volume_data: Volume3DData):
             oldest_uid = next(iter(self._volumes_3d))
             del self._volumes_3d[oldest_uid]
 
-    def get_volume_3d(self, uid: str) -> Optional[Volume3DData]:
+    def get_volume_3d(self, uid: str) -> Volume3DData | None:
         """Get a 3D volume by UID"""
         return self._volumes_3d.get(uid)
 
-    def get_all_volumes_3d(self) -> List[Dict]:
+    def get_all_volumes_3d(self) -> list[dict]:
         """Get info for all 3D volumes (without heavy data)"""
         return [v.to_info_dict() for v in self._volumes_3d.values()]
 
@@ -132,9 +134,9 @@ def get_sequence(
         self,
         embryo_id: str,
         start: int = 0,
-        end: Optional[int] = None,
-        data_type: Optional[str] = None
-    ) -> List[ImageData]:
+        end: int | None = None,
+        data_type: str | None = None,
+    ) -> list[ImageData]:
         """Get ordered sequence of images for an embryo within a timepoint range.
 
         Args:
@@ -158,8 +160,8 @@ def get_sequence(
             all_images = [img for img in all_images if img.data_type == data_type]
 
         # Filter by timepoint range
-        def get_timepoint(img: ImageData) -> Optional[int]:
-            tp = img.metadata.get('timepoint')
+        def get_timepoint(img: ImageData) -> int | None:
+            tp = img.metadata.get("timepoint")
             if tp is not None:
                 return int(tp)
             return None
@@ -179,7 +181,7 @@ def get_timepoint(img: ImageData) -> Optional[int]:
         filtered.sort(key=lambda x: get_timepoint(x) or 0)
         return filtered
 
-    def get_stats(self) -> Dict:
+    def get_stats(self) -> dict:
         """Get storage statistics"""
         total_cal = len(self._calibration_images)
         total_vol = len(self._volume_images)
@@ -191,10 +193,10 @@ def get_stats(self) -> Dict:
             total_snap += len(cache.snapshots)
 
         return {
-            'embryo_count': len(self._embryo_caches),
-            'calibration_count': total_cal,
-            'volume_count': total_vol,
-            'snapshot_count': total_snap,
-            'volumes_3d_count': len(self._volumes_3d),
-            'embryo_ids': list(self._embryo_caches.keys()),
+            "embryo_count": len(self._embryo_caches),
+            "calibration_count": total_cal,
+            "volume_count": total_vol,
+            "snapshot_count": total_snap,
+            "volumes_3d_count": len(self._volumes_3d),
+            "embryo_ids": list(self._embryo_caches.keys()),
         }
diff --git a/gently/ui/web/models.py b/gently/ui/web/models.py
index b61147fd..43c05498 100644
--- a/gently/ui/web/models.py
+++ b/gently/ui/web/models.py
@@ -5,38 +5,47 @@
 Dataclasses and type constants used across the visualization package.
 """
 
-from dataclasses import dataclass, field, asdict
-from typing import Any, Dict, List, Optional
+from dataclasses import asdict, dataclass, field
+from typing import Any
 
 import numpy as np
 
-
 # Data types for routing to tabs
 CALIBRATION_TYPES = {
-    'focus_sweep', 'focus_plot', 'edge_detection', 'calibration_summary',
-    'focus_snap', 'focus_coarse', 'focus_curve', 'focus_assess'
+    "focus_sweep",
+    "focus_plot",
+    "edge_detection",
+    "calibration_summary",
+    "focus_snap",
+    "focus_coarse",
+    "focus_curve",
+    "focus_assess",
 }
 
-VOLUME_TYPES = {
-    'volume', 'volume_projection', 'z_stack', 'timelapse'
-}
+VOLUME_TYPES = {"volume", "volume_projection", "z_stack", "timelapse"}
 
 # CV/Analysis types - shown in a separate "Analysis" category within Calibration
 ANALYSIS_TYPES = {
-    'segmentation', 'detection', 'classification', 'tracking',
+    "segmentation",
+    "detection",
+    "classification",
+    "tracking",
     # CV agent visualization types
-    'roi_detection', 'cropped_roi', 'vision_prepared', 'timeline', 'cv_visualization'
+    "roi_detection",
+    "cropped_roi",
+    "vision_prepared",
+    "timeline",
+    "cv_visualization",
 }
 
 # 3D types that support Z-slider browsing
-VOLUME_3D_TYPES = {
-    'segmentation_3d'
-}
+VOLUME_3D_TYPES = {"segmentation_3d"}
 
 
 @dataclass
 class ClientInfo:
     """Information about a connected WebSocket client for presence tracking"""
+
     client_id: str
     name: str
     color: str  # Hex color for avatar background
@@ -46,13 +55,14 @@ class ClientInfo:
 @dataclass
 class Volume3DData:
     """Container for 3D volume data with segmentation overlay"""
+
     uid: str
     data_type: str
     timestamp: str
     volume: np.ndarray  # Original volume (Z, H, W)
-    masks: np.ndarray   # Segmentation masks (Z, H, W)
+    masks: np.ndarray  # Segmentation masks (Z, H, W)
     colors: np.ndarray  # Cell colors (num_labels, 3)
-    metadata: Dict[str, Any] = field(default_factory=dict)
+    metadata: dict[str, Any] = field(default_factory=dict)
 
     @property
     def num_slices(self) -> int:
@@ -89,37 +99,39 @@ def get_slice_overlay(self, z: int, alpha: float = 0.4) -> np.ndarray:
 
         return rgb
 
-    def to_info_dict(self) -> Dict:
+    def to_info_dict(self) -> dict:
         """Return metadata without the heavy arrays"""
         return {
-            'uid': self.uid,
-            'data_type': self.data_type,
-            'timestamp': self.timestamp,
-            'shape': list(self.shape),
-            'num_slices': self.num_slices,
-            'num_cells': int(self.masks.max()),
-            'metadata': self.metadata
+            "uid": self.uid,
+            "data_type": self.data_type,
+            "timestamp": self.timestamp,
+            "shape": list(self.shape),
+            "num_slices": self.num_slices,
+            "num_cells": int(self.masks.max()),
+            "metadata": self.metadata,
         }
 
 
 @dataclass
 class ImageData:
     """Container for image data sent to clients"""
+
     uid: str
     data_type: str  # 'volume', 'projection', 'snapshot', 'detection', 'focus_sweep', etc.
     timestamp: str
-    metadata: Dict[str, Any] = field(default_factory=dict)
-    base64_png: Optional[str] = None
-    shape: Optional[tuple] = None
+    metadata: dict[str, Any] = field(default_factory=dict)
+    base64_png: str | None = None
+    shape: tuple | None = None
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         return asdict(self)
 
 
 @dataclass
 class EmbryoImageCache:
     """Per-embryo image organization"""
+
     embryo_id: str
-    volumes: List[ImageData] = field(default_factory=list)
-    calibration: List[ImageData] = field(default_factory=list)
-    snapshots: List[ImageData] = field(default_factory=list)
+    volumes: list[ImageData] = field(default_factory=list)
+    calibration: list[ImageData] = field(default_factory=list)
+    snapshots: list[ImageData] = field(default_factory=list)
diff --git a/gently/ui/web/plots.py b/gently/ui/web/plots.py
index 437f792d..45575f6d 100644
--- a/gently/ui/web/plots.py
+++ b/gently/ui/web/plots.py
@@ -5,11 +5,10 @@
 Uses matplotlib with Agg backend for thread safety.
 """
 
+import matplotlib
 import numpy as np
-from typing import Optional, Tuple, List
 
-import matplotlib
-matplotlib.use('Agg')  # Non-interactive backend for thread safety
+matplotlib.use("Agg")  # Non-interactive backend for thread safety
 import matplotlib.pyplot as plt
 
 
@@ -17,10 +16,10 @@ def generate_focus_curve_plot(
     positions: np.ndarray,
     scores: np.ndarray,
     best_position: float,
-    fit_params: Optional[np.ndarray] = None,
+    fit_params: np.ndarray | None = None,
     r_squared: float = 0.0,
     title: str = "Focus Curve",
-    figsize: Tuple[int, int] = (6, 4),
+    figsize: tuple[int, int] = (6, 4),
     dpi: int = 100,
 ) -> np.ndarray:
     """
@@ -53,24 +52,34 @@ def generate_focus_curve_plot(
     fig, ax = plt.subplots(figsize=figsize, dpi=dpi)
 
     # Data points
-    ax.scatter(positions, scores, c='#2196F3', s=50, zorder=3, label='Measurements')
+    ax.scatter(positions, scores, c="#2196F3", s=50, zorder=3, label="Measurements")
 
     # Gaussian fit curve
     if fit_params is not None and len(fit_params) >= 4:
         a, mu, sigma, c = fit_params[:4]
         x_fit = np.linspace(positions.min(), positions.max(), 200)
-        y_fit = a * np.exp(-((x_fit - mu) ** 2) / (2 * sigma ** 2)) + c
-        ax.plot(x_fit, y_fit, color='#F44336', linewidth=2,
-                label=f'Gaussian fit (R²={r_squared:.3f})')
+        y_fit = a * np.exp(-((x_fit - mu) ** 2) / (2 * sigma**2)) + c
+        ax.plot(
+            x_fit,
+            y_fit,
+            color="#F44336",
+            linewidth=2,
+            label=f"Gaussian fit (R²={r_squared:.3f})",
+        )
 
     # Best position marker
-    ax.axvline(best_position, color='#4CAF50', linestyle='--', linewidth=2,
-               label=f'Best: {best_position:.2f} µm')
+    ax.axvline(
+        best_position,
+        color="#4CAF50",
+        linestyle="--",
+        linewidth=2,
+        label=f"Best: {best_position:.2f} µm",
+    )
 
-    ax.set_xlabel('Piezo Position (µm)', fontsize=11)
-    ax.set_ylabel('Focus Score', fontsize=11)
-    ax.set_title(title, fontsize=12, fontweight='bold')
-    ax.legend(loc='upper right', framealpha=0.9)
+    ax.set_xlabel("Piezo Position (µm)", fontsize=11)
+    ax.set_ylabel("Focus Score", fontsize=11)
+    ax.set_title(title, fontsize=12, fontweight="bold")
+    ax.legend(loc="upper right", framealpha=0.9)
     ax.grid(True, alpha=0.3)
 
     # Tight layout
@@ -94,7 +103,7 @@ def generate_calibration_summary_plot(
     offset: float,
     r_squared_top: float = 0.0,
     r_squared_bottom: float = 0.0,
-    figsize: Tuple[int, int] = (7, 5),
+    figsize: tuple[int, int] = (7, 5),
     dpi: int = 100,
 ) -> np.ndarray:
     """
@@ -135,32 +144,46 @@ def generate_calibration_summary_plot(
     # Calibration points
     galvos = [galvo_top, galvo_bottom]
     piezos = [piezo_top, piezo_bottom]
-    ax.scatter(galvos, piezos, c='#2196F3', s=100, zorder=3,
-               label='Calibration points')
+    ax.scatter(galvos, piezos, c="#2196F3", s=100, zorder=3, label="Calibration points")
 
     # Linear fit line
     margin = 0.05
     galvo_range = np.linspace(
         min(galvo_top, galvo_bottom) - margin,
         max(galvo_top, galvo_bottom) + margin,
-        100
+        100,
     )
     piezo_fit = slope * galvo_range + offset
-    ax.plot(galvo_range, piezo_fit, color='#F44336', linewidth=2,
-            label=f'Linear fit: piezo = {slope:.1f}·galvo + {offset:.1f}')
+    ax.plot(
+        galvo_range,
+        piezo_fit,
+        color="#F44336",
+        linewidth=2,
+        label=f"Linear fit: piezo = {slope:.1f}·galvo + {offset:.1f}",
+    )
 
     # Annotations
-    ax.annotate(f'Top\nR²={r_squared_top:.3f}',
-                (galvo_top, piezo_top), textcoords="offset points",
-                xytext=(10, 10), fontsize=9, color='#666')
-    ax.annotate(f'Bottom\nR²={r_squared_bottom:.3f}',
-                (galvo_bottom, piezo_bottom), textcoords="offset points",
-                xytext=(10, -20), fontsize=9, color='#666')
-
-    ax.set_xlabel('Galvo Position (degrees)', fontsize=11)
-    ax.set_ylabel('Piezo Position (µm)', fontsize=11)
-    ax.set_title(f'{embryo_id} - Piezo-Galvo Calibration', fontsize=12, fontweight='bold')
-    ax.legend(loc='upper left', framealpha=0.9)
+    ax.annotate(
+        f"Top\nR²={r_squared_top:.3f}",
+        (galvo_top, piezo_top),
+        textcoords="offset points",
+        xytext=(10, 10),
+        fontsize=9,
+        color="#666",
+    )
+    ax.annotate(
+        f"Bottom\nR²={r_squared_bottom:.3f}",
+        (galvo_bottom, piezo_bottom),
+        textcoords="offset points",
+        xytext=(10, -20),
+        fontsize=9,
+        color="#666",
+    )
+
+    ax.set_xlabel("Galvo Position (degrees)", fontsize=11)
+    ax.set_ylabel("Piezo Position (µm)", fontsize=11)
+    ax.set_title(f"{embryo_id} - Piezo-Galvo Calibration", fontsize=12, fontweight="bold")
+    ax.legend(loc="upper left", framealpha=0.9)
     ax.grid(True, alpha=0.3)
 
     fig.tight_layout()
@@ -172,12 +195,12 @@ def generate_calibration_summary_plot(
 
 
 def generate_edge_detection_plot(
-    galvo_positions: List[float],
-    visibility: List[bool],
-    edge_top: Optional[float] = None,
-    edge_bottom: Optional[float] = None,
+    galvo_positions: list[float],
+    visibility: list[bool],
+    edge_top: float | None = None,
+    edge_bottom: float | None = None,
     embryo_id: str = "embryo",
-    figsize: Tuple[int, int] = (6, 4),
+    figsize: tuple[int, int] = (6, 4),
     dpi: int = 100,
 ) -> np.ndarray:
     """
@@ -211,31 +234,47 @@ def generate_edge_detection_plot(
     vis_numeric = [1 if v else 0 for v in visibility]
 
     # Plot visibility as step function
-    colors = ['#4CAF50' if v else '#F44336' for v in visibility]
+    colors = ["#4CAF50" if v else "#F44336" for v in visibility]
     ax.scatter(galvo_positions, vis_numeric, c=colors, s=80, zorder=3)
 
     # Draw step-like connecting lines
     for i in range(len(galvo_positions) - 1):
-        color = '#4CAF50' if visibility[i] else '#F44336'
-        ax.hlines(vis_numeric[i], galvo_positions[i], galvo_positions[i+1],
-                  color=color, alpha=0.3, linewidth=2)
+        color = "#4CAF50" if visibility[i] else "#F44336"
+        ax.hlines(
+            vis_numeric[i],
+            galvo_positions[i],
+            galvo_positions[i + 1],
+            color=color,
+            alpha=0.3,
+            linewidth=2,
+        )
 
     # Mark edges if provided
     if edge_top is not None:
-        ax.axvline(edge_top, color='#2196F3', linestyle='--', linewidth=2,
-                   label=f'Top edge: {edge_top:.3f}°')
+        ax.axvline(
+            edge_top,
+            color="#2196F3",
+            linestyle="--",
+            linewidth=2,
+            label=f"Top edge: {edge_top:.3f}°",
+        )
     if edge_bottom is not None:
-        ax.axvline(edge_bottom, color='#FF9800', linestyle='--', linewidth=2,
-                   label=f'Bottom edge: {edge_bottom:.3f}°')
-
-    ax.set_xlabel('Galvo Position (degrees)', fontsize=11)
-    ax.set_ylabel('Embryo Visible', fontsize=11)
+        ax.axvline(
+            edge_bottom,
+            color="#FF9800",
+            linestyle="--",
+            linewidth=2,
+            label=f"Bottom edge: {edge_bottom:.3f}°",
+        )
+
+    ax.set_xlabel("Galvo Position (degrees)", fontsize=11)
+    ax.set_ylabel("Embryo Visible", fontsize=11)
     ax.set_yticks([0, 1])
-    ax.set_yticklabels(['No', 'Yes'])
-    ax.set_title(f'{embryo_id} - Edge Detection', fontsize=12, fontweight='bold')
+    ax.set_yticklabels(["No", "Yes"])
+    ax.set_title(f"{embryo_id} - Edge Detection", fontsize=12, fontweight="bold")
     if edge_top is not None or edge_bottom is not None:
-        ax.legend(loc='best', framealpha=0.9)
-    ax.grid(True, alpha=0.3, axis='x')
+        ax.legend(loc="best", framealpha=0.9)
+    ax.grid(True, alpha=0.3, axis="x")
 
     fig.tight_layout()
     fig.canvas.draw()
diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index 7b76f94d..ebd90770 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -6,17 +6,17 @@
 a FastAPI ``APIRouter`` bound to the server instance.
 """
 
-from .pages import create_router as create_pages_router
-from .sessions import create_router as create_sessions_router
-from .images import create_router as create_images_router
-from .volumes import create_router as create_volumes_router
-from .data import create_router as create_data_router
-from .websocket import create_router as create_websocket_router
 from .agent_ws import create_router as create_agent_ws_router
+from .auth_routes import create_router as create_auth_router
 from .campaigns import create_router as create_campaigns_router
 from .chat import create_router as create_chat_router
+from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
-from .auth_routes import create_router as create_auth_router
+from .images import create_router as create_images_router
+from .pages import create_router as create_pages_router
+from .sessions import create_router as create_sessions_router
+from .volumes import create_router as create_volumes_router
+from .websocket import create_router as create_websocket_router
 
 
 def register_all_routes(server):
diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index 8f3a3262..fdf2fc5f 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -9,8 +9,8 @@
 import asyncio
 import json
 import logging
+from collections.abc import Callable
 from datetime import datetime
-from typing import Callable, Dict, Optional
 
 from fastapi import APIRouter, WebSocket, WebSocketDisconnect
 
@@ -29,7 +29,7 @@ def create_router(server) -> APIRouter:
     router = APIRouter()
 
     # Pending choice futures keyed by request_id
-    _choice_futures: Dict[str, asyncio.Future] = {}
+    _choice_futures: dict[str, asyncio.Future] = {}
 
     # ── Single-driver control arbitration ─────────────────────
     # Shared across all /ws/agent clients (the router is created once).
@@ -37,11 +37,11 @@ def create_router(server) -> APIRouter:
     # everyone else is an observer until they take control. This is the
     # seed of the multi-user control lock and also prevents the shared
     # agent conversation from being corrupted when >1 client connects.
-    _control: Dict[str, Optional[str]] = {"holder": None}
-    _clients: Dict[str, Callable] = {}
-    _client_labels: Dict[str, str] = {}
+    _control: dict[str, str | None] = {"holder": None}
+    _clients: dict[str, Callable] = {}
+    _client_labels: dict[str, str] = {}
     _client_counter = {"n": 0}
-    _raw_clients: Dict[str, WebSocket] = {}  # client_id -> websocket (broadcast)
+    _raw_clients: dict[str, WebSocket] = {}  # client_id -> websocket (broadcast)
 
     # ── Uniform display transcript ────────────────────────────
     # A single conversation history shared by every client of this session.
@@ -56,12 +56,14 @@ async def _broadcast_control_status():
         holder_label = _client_labels.get(holder) if holder else None
         for cid, fn in list(_clients.items()):
             try:
-                await fn({
-                    "type": "control_status",
-                    "holder": holder,
-                    "holder_label": holder_label,
-                    "you_have_control": (cid == holder),
-                })
+                await fn(
+                    {
+                        "type": "control_status",
+                        "holder": holder,
+                        "holder_label": holder_label,
+                        "you_have_control": (cid == holder),
+                    }
+                )
             except Exception:
                 pass
 
@@ -101,12 +103,13 @@ def _load_history_for_session(bridge):
         if not _history and store and sid:
             try:
                 snap = store.load_session_snapshot(sid) or {}
-                for m in (snap.get("conversation_history") or []):
+                for m in snap.get("conversation_history") or []:
                     role = m.get("role")
                     content = m.get("content")
                     if isinstance(content, list):
                         text = "".join(
-                            b.get("text", "") for b in content
+                            b.get("text", "")
+                            for b in content
                             if isinstance(b, dict) and b.get("type") == "text"
                         )
                     else:
@@ -153,8 +156,13 @@ def _record_display(msg):
         if t == "user_message":
             _flush_agent_buf()
             _history_state["autonomous"] = False
-            _record({"role": "user", "text": msg.get("text", ""),
-                     "author": msg.get("author")})
+            _record(
+                {
+                    "role": "user",
+                    "text": msg.get("text", ""),
+                    "author": msg.get("author"),
+                }
+            )
         elif t == "autonomous_start":
             # An autonomous wake turn is beginning — record the trigger banner
             # and mark following text as autonomous until stream_end.
@@ -165,9 +173,14 @@ def _record_display(msg):
             _history_state["agent_buf"] = (_history_state["agent_buf"] or "") + msg.get("text", "")
         elif t == "tool_call":
             _flush_agent_buf()
-            _record({"role": "tool", "name": msg.get("tool_name"),
-                     "duration": msg.get("duration"),
-                     "summary": msg.get("result_summary")})
+            _record(
+                {
+                    "role": "tool",
+                    "name": msg.get("tool_name"),
+                    "duration": msg.get("duration"),
+                    "summary": msg.get("result_summary"),
+                }
+            )
         elif t == "stream_end":
             _flush_agent_buf()
             _history_state["autonomous"] = False
@@ -175,19 +188,21 @@ def _record_display(msg):
     async def _broadcast(msg):
         """Record to history + send a display message to ALL clients."""
         _record_display(msg)
-        for cid, ws in list(_raw_clients.items()):
+        for _cid, ws in list(_raw_clients.items()):
             try:
                 await ws.send_json(msg)
             except Exception:
                 pass
 
-    async def _run_wizard(wizard, websocket, send_fn, _choice_futures, bridge=None, log_transcript=None):
+    async def _run_wizard(
+        wizard, websocket, send_fn, _choice_futures, bridge=None, log_transcript=None
+    ):
         """Run the wizard's interactive loop.
 
         Returns the wizard task so callers can check for exceptions.
         Used both at startup and for the /wizard command.
         """
-        _wizard_input_future: Optional[asyncio.Future] = None
+        _wizard_input_future: asyncio.Future | None = None
 
         async def _wizard_wait_for_input() -> str:
             nonlocal _wizard_input_future
@@ -198,11 +213,13 @@ async def _wizard_wait_for_input() -> str:
         async def _wizard_wait_for_choice(choice_data: dict) -> str:
             request_id = _make_request_id()
             choice_data["request_id"] = request_id
-            await send_fn({
-                "type": "choice_request",
-                "choice_data": choice_data,
-                "request_id": request_id,
-            })
+            await send_fn(
+                {
+                    "type": "choice_request",
+                    "choice_data": choice_data,
+                    "request_id": request_id,
+                }
+            )
             loop = asyncio.get_event_loop()
             future = loop.create_future()
             _choice_futures[request_id] = future
@@ -215,7 +232,8 @@ async def _wizard_wait_for_choice(choice_data: dict) -> str:
         while not wizard_task.done():
             try:
                 raw = await asyncio.wait_for(
-                    websocket.receive_text(), timeout=60.0,
+                    websocket.receive_text(),
+                    timeout=60.0,
                 )
             except asyncio.TimeoutError:
                 await websocket.send_json({"type": "ping"})
@@ -251,12 +269,18 @@ async def _wizard_wait_for_choice(choice_data: dict) -> str:
                     # /reset-context kills the wizard — context is gone
                     if command.strip().lower() == "/reset-context":
                         wizard_task.cancel()
-                        await send_fn({
-                            "type": "stream_end",
-                            "tokens": {"input_tokens": 0, "output_tokens": 0,
-                                       "total_tokens": 0, "api_calls": 0},
-                            "wizard_complete": True,
-                        })
+                        await send_fn(
+                            {
+                                "type": "stream_end",
+                                "tokens": {
+                                    "input_tokens": 0,
+                                    "output_tokens": 0,
+                                    "total_tokens": 0,
+                                    "api_calls": 0,
+                                },
+                                "wizard_complete": True,
+                            }
+                        )
                         return wizard_task
 
             elif msg_type == "ping":
@@ -279,10 +303,12 @@ async def agent_websocket(websocket: WebSocket):
 
         bridge = getattr(server, "agent_bridge", None)
         if bridge is None:
-            await websocket.send_json({
-                "type": "error",
-                "error": "Agent bridge not initialized",
-            })
+            await websocket.send_json(
+                {
+                    "type": "error",
+                    "error": "Agent bridge not initialized",
+                }
+            )
             await websocket.close()
             return
 
@@ -296,8 +322,9 @@ async def agent_websocket(websocket: WebSocket):
         # session cookie (set at login). Viewers may watch but not drive;
         # operators/admins may take the control lock. With no accounts
         # configured we fall back to the legacy "anyone connected can drive".
-        from gently.ui.web.accounts import get_account_store, CONTROL_ROLES
+        from gently.ui.web.accounts import CONTROL_ROLES, get_account_store
         from gently.ui.web.auth import SESSION_COOKIE
+
         _acct = get_account_store()
         username = None
         can_control = True  # legacy default when no accounts are configured
@@ -369,10 +396,16 @@ async def _push_peer_discovered(event):
                                 "_type": "single",
                                 "question": f"New peer discovered: {hostname}",
                                 "options": [
-                                    {"id": "pair", "label": "Pair",
-                                     "description": f"Start pairing with {hostname}"},
-                                    {"id": "ignore", "label": "Ignore",
-                                     "description": "Dismiss (you can pair later via /pair)"},
+                                    {
+                                        "id": "pair",
+                                        "label": "Pair",
+                                        "description": f"Start pairing with {hostname}",
+                                    },
+                                    {
+                                        "id": "ignore",
+                                        "label": "Ignore",
+                                        "description": "Dismiss (you can pair later via /pair)",
+                                    },
                                 ],
                                 "allow_multiple": False,
                             },
@@ -421,12 +454,20 @@ async def _push_pairing_requested(event):
                         "type": "choice_request",
                         "choice_data": {
                             "_type": "single",
-                            "question": f"{hostname} wants to pair\nVerify this code matches: {pin}",
+                            "question": (
+                                f"{hostname} wants to pair\nVerify this code matches: {pin}"
+                            ),
                             "options": [
-                                {"id": "accept", "label": "Accept pairing",
-                                 "description": f"Trust {hostname} and allow mesh communication"},
-                                {"id": "reject", "label": "Reject",
-                                 "description": "Decline this pairing request"},
+                                {
+                                    "id": "accept",
+                                    "label": "Accept pairing",
+                                    "description": f"Trust {hostname} and allow mesh communication",
+                                },
+                                {
+                                    "id": "reject",
+                                    "label": "Reject",
+                                    "description": "Decline this pairing request",
+                                },
                             ],
                             "allow_multiple": False,
                         },
@@ -507,7 +548,9 @@ async def _push_scope_denied(event):
                     pass
 
             # Peer discovery
-            unsub = server.event_bus.subscribe_async(_ET.MESH_PEER_DISCOVERED, _push_peer_discovered)
+            unsub = server.event_bus.subscribe_async(
+                _ET.MESH_PEER_DISCOVERED, _push_peer_discovered
+            )
             _mesh_unsubs.append(unsub)
             unsub = server.event_bus.subscribe_async(_ET.MESH_PEER_LOST, _push_peer_lost)
             _mesh_unsubs.append(unsub)
@@ -515,23 +558,29 @@ async def _push_scope_denied(event):
             _mesh_unsubs.append(unsub)
 
             # Pairing events
-            unsub = server.event_bus.subscribe_async(_ET.MESH_PAIRING_REQUESTED, _push_pairing_requested)
+            unsub = server.event_bus.subscribe_async(
+                _ET.MESH_PAIRING_REQUESTED, _push_pairing_requested
+            )
             _mesh_unsubs.append(unsub)
-            unsub = server.event_bus.subscribe_async(_ET.MESH_PAIRING_COMPLETED, _push_pairing_completed)
+            unsub = server.event_bus.subscribe_async(
+                _ET.MESH_PAIRING_COMPLETED, _push_pairing_completed
+            )
             _mesh_unsubs.append(unsub)
 
             # Security events
             unsub = server.event_bus.subscribe_async(_ET.MESH_AUTH_FAILURE, _push_auth_failure)
             _mesh_unsubs.append(unsub)
-            unsub = server.event_bus.subscribe_async(_ET.MESH_CERT_PIN_FAILURE, _push_cert_pin_failure)
+            unsub = server.event_bus.subscribe_async(
+                _ET.MESH_CERT_PIN_FAILURE, _push_cert_pin_failure
+            )
             _mesh_unsubs.append(unsub)
             unsub = server.event_bus.subscribe_async(_ET.MESH_SCOPE_DENIED, _push_scope_denied)
             _mesh_unsubs.append(unsub)
 
         # Active streaming task (so we can cancel on disconnect)
-        active_task: Optional[asyncio.Task] = None
+        active_task: asyncio.Task | None = None
         wizard_task = None
-        bootstrap_task: Optional[asyncio.Task] = None
+        bootstrap_task: asyncio.Task | None = None
 
         # ── Session transcript ────────────────────────────────
         # Log every WebSocket message (both directions) to a JSONL
@@ -547,7 +596,9 @@ async def _push_scope_denied(event):
                 sdir = store._session_dir(sid)
                 if sdir and sdir.exists():
                     _transcript_file = open(
-                        sdir / "transcript.jsonl", "a", encoding="utf-8",
+                        sdir / "transcript.jsonl",
+                        "a",
+                        encoding="utf-8",
                     )
                     logger.info("Transcript logging to %s", sdir / "transcript.jsonl")
         except Exception as e:
@@ -626,18 +677,28 @@ def _discard_choice(request_id: str) -> None:
             wizard = getattr(bridge, "_wizard", None)
             if wizard is not None and wizard.needed and getattr(server, "wizard_autorun", False):
                 wizard_task = await _run_wizard(
-                    wizard, websocket, send_fn, _choice_futures, bridge,
+                    wizard,
+                    websocket,
+                    send_fn,
+                    _choice_futures,
+                    bridge,
                     log_transcript=_log_transcript,
                 )
                 exc = _handle_wizard_result(wizard_task)
                 if exc:
                     logger.error(f"Wizard error: {exc}", exc_info=exc)
-                    await send_fn({
-                        "type": "stream_end",
-                        "tokens": {"input_tokens": 0, "output_tokens": 0,
-                                   "total_tokens": 0, "api_calls": 0},
-                        "wizard_complete": True,
-                    })
+                    await send_fn(
+                        {
+                            "type": "stream_end",
+                            "tokens": {
+                                "input_tokens": 0,
+                                "output_tokens": 0,
+                                "total_tokens": 0,
+                                "api_calls": 0,
+                            },
+                            "wizard_complete": True,
+                        }
+                    )
 
             # ── Auto-briefing or resolution picker ────────────────
             # New sessions with multiple unblocked imaging candidates
@@ -652,26 +713,33 @@ def _discard_choice(request_id: str) -> None:
             async def _run_resolution_bootstrap():
                 try:
                     await bridge.bootstrap_resolution_picker(
-                        send_fn, choice_future_factory,
+                        send_fn,
+                        choice_future_factory,
                     )
                 except asyncio.CancelledError:
                     raise
                 except Exception as exc:
                     logger.error(
-                        "Resolution picker failed; falling back to "
-                        "static briefing: %s",
-                        exc, exc_info=exc,
+                        "Resolution picker failed; falling back to static briefing: %s",
+                        exc,
+                        exc_info=exc,
                     )
                     try:
                         briefing = bridge.get_session_briefing()
                         if briefing:
                             await send_fn({"type": "stream_start"})
                             await send_fn({"type": "text", "text": briefing})
-                            await send_fn({
-                                "type": "stream_end",
-                                "tokens": {"input_tokens": 0, "output_tokens": 0,
-                                           "total_tokens": 0, "api_calls": 0},
-                            })
+                            await send_fn(
+                                {
+                                    "type": "stream_end",
+                                    "tokens": {
+                                        "input_tokens": 0,
+                                        "output_tokens": 0,
+                                        "total_tokens": 0,
+                                        "api_calls": 0,
+                                    },
+                                }
+                            )
                     except Exception:
                         pass
 
@@ -683,17 +751,24 @@ async def _run_resolution_bootstrap():
                     if briefing:
                         await send_fn({"type": "stream_start"})
                         await send_fn({"type": "text", "text": briefing})
-                        await send_fn({
-                            "type": "stream_end",
-                            "tokens": {"input_tokens": 0, "output_tokens": 0,
-                                       "total_tokens": 0, "api_calls": 0},
-                        })
+                        await send_fn(
+                            {
+                                "type": "stream_end",
+                                "tokens": {
+                                    "input_tokens": 0,
+                                    "output_tokens": 0,
+                                    "total_tokens": 0,
+                                    "api_calls": 0,
+                                },
+                            }
+                        )
 
             # ── Main REPL loop ────────────────────────────────────
             while True:
                 try:
                     raw = await asyncio.wait_for(
-                        websocket.receive_text(), timeout=60.0,
+                        websocket.receive_text(),
+                        timeout=60.0,
                     )
                 except asyncio.TimeoutError:
                     await websocket.send_json({"type": "ping"})
@@ -712,24 +787,28 @@ async def _run_resolution_bootstrap():
                 # A client requesting the wheel.
                 if msg_type == "take_control":
                     if not can_control:
-                        await send_fn({
-                            "type": "notification",
-                            "level": "warning",
-                            "title": "View-only role",
-                            "body": "Your account can watch but not control the microscope.",
-                        })
+                        await send_fn(
+                            {
+                                "type": "notification",
+                                "level": "warning",
+                                "title": "View-only role",
+                                "body": "Your account can watch but not control the microscope.",
+                            }
+                        )
                         await _broadcast_control_status()
                         continue
                     prev = _control["holder"]
                     _control["holder"] = client_id
                     if prev and prev != client_id and prev in _clients:
                         try:
-                            await _clients[prev]({
-                                "type": "notification",
-                                "level": "warning",
-                                "title": f"Control taken by {client_label}",
-                                "body": "You are now viewing.",
-                            })
+                            await _clients[prev](
+                                {
+                                    "type": "notification",
+                                    "level": "warning",
+                                    "title": f"Control taken by {client_label}",
+                                    "body": "You are now viewing.",
+                                }
+                            )
                         except Exception:
                             pass
                     await _broadcast_control_status()
@@ -740,12 +819,14 @@ async def _run_resolution_bootstrap():
                 # single shared conversation.
                 if msg_type in ("chat", "command", "cancel") and client_id != _control["holder"]:
                     holder_label = _client_labels.get(_control["holder"]) or "another client"
-                    await send_fn({
-                        "type": "notification",
-                        "level": "info",
-                        "title": f"Viewing only — control is held by {holder_label}",
-                        "body": "Take control to drive the microscope.",
-                    })
+                    await send_fn(
+                        {
+                            "type": "notification",
+                            "level": "info",
+                            "title": f"Viewing only — control is held by {holder_label}",
+                            "body": "Take control to drive the microscope.",
+                        }
+                    )
                     await _broadcast_control_status()
                     continue
 
@@ -760,8 +841,7 @@ async def _run_resolution_bootstrap():
 
                     # Echo the user's message to ALL clients (so observers see
                     # what was asked), then stream the reply to everyone.
-                    await _broadcast({"type": "user_message", "text": text,
-                                      "author": client_label})
+                    await _broadcast({"type": "user_message", "text": text, "author": client_label})
                     active_task = asyncio.create_task(
                         bridge.stream_response(text, _broadcast, choice_future_factory)
                     )
@@ -795,11 +875,13 @@ async def _run_resolution_bootstrap():
                     if command.lower() in ("/wizard",):
                         w = getattr(bridge, "_wizard", None)
                         if w is None:
-                            await send_fn({
-                                "type": "command_result",
-                                "command": "/wizard",
-                                "error": "Wizard not available",
-                            })
+                            await send_fn(
+                                {
+                                    "type": "command_result",
+                                    "command": "/wizard",
+                                    "error": "Wizard not available",
+                                }
+                            )
                         else:
                             # Re-create wizard so it re-assesses gaps
                             cs = getattr(bridge, "_context_store", None)
@@ -808,40 +890,60 @@ async def _run_resolution_bootstrap():
                             w = bridge._wizard
 
                             # Tell TUI we're entering wizard mode
-                            await send_fn({
-                                "type": "command_result",
-                                "command": "/wizard",
-                                "content": {"wizard_active": True},
-                            })
+                            await send_fn(
+                                {
+                                    "type": "command_result",
+                                    "command": "/wizard",
+                                    "content": {"wizard_active": True},
+                                }
+                            )
 
                             wizard_task = await _run_wizard(
-                                w, websocket, send_fn, _choice_futures, bridge,
+                                w,
+                                websocket,
+                                send_fn,
+                                _choice_futures,
+                                bridge,
                                 log_transcript=_log_transcript,
                             )
                             exc = _handle_wizard_result(wizard_task)
                             if exc:
                                 logger.error(f"Wizard error: {exc}", exc_info=exc)
-                                await send_fn({
-                                    "type": "stream_end",
-                                    "tokens": {"input_tokens": 0, "output_tokens": 0,
-                                               "total_tokens": 0, "api_calls": 0},
-                                    "wizard_complete": True,
-                                })
+                                await send_fn(
+                                    {
+                                        "type": "stream_end",
+                                        "tokens": {
+                                            "input_tokens": 0,
+                                            "output_tokens": 0,
+                                            "total_tokens": 0,
+                                            "api_calls": 0,
+                                        },
+                                        "wizard_complete": True,
+                                    }
+                                )
                     else:
                         try:
-                            await bridge.handle_command(command, send_fn, choice_futures=_choice_futures)
+                            await bridge.handle_command(
+                                command, send_fn, choice_futures=_choice_futures
+                            )
                         except Exception as e:
                             logger.error("Command '%s' failed: %s", command, e, exc_info=True)
-                            await send_fn({
-                                "type": "command_result",
-                                "command": command,
-                                "error": str(e),
-                            })
+                            await send_fn(
+                                {
+                                    "type": "command_result",
+                                    "command": command,
+                                    "error": str(e),
+                                }
+                            )
 
                 elif msg_type == "browse":
                     target = data.get("target", "")
                     await _handle_browse(
-                        target, data, server, bridge, send_fn,
+                        target,
+                        data,
+                        server,
+                        bridge,
+                        send_fn,
                     )
 
                 elif msg_type == "ping":
@@ -916,13 +1018,20 @@ def serialize_campaign(c):
                 else:
                     children = []
                     items_raw = cs.get_plan_items(campaign_id=c.id)
-                    items = [{
-                        "id": item.id,
-                        "title": item.title,
-                        "status": item.status.value if hasattr(item.status, "value") else str(item.status),
-                        "type": item.type.value if hasattr(item.type, "value") else str(item.type),
-                        "claimed_by_hostname": getattr(item, "claimed_by_hostname", None),
-                    } for item in items_raw]
+                    items = [
+                        {
+                            "id": item.id,
+                            "title": item.title,
+                            "status": item.status.value
+                            if hasattr(item.status, "value")
+                            else str(item.status),
+                            "type": item.type.value
+                            if hasattr(item.type, "value")
+                            else str(item.type),
+                            "claimed_by_hostname": getattr(item, "claimed_by_hostname", None),
+                        }
+                        for item in items_raw
+                    ]
                 return {
                     "id": c.id,
                     "shorthand": c.shorthand or "",
@@ -949,17 +1058,19 @@ def serialize_campaign(c):
             peers = mesh_svc.get_peers()
             result = []
             for p in peers:
-                result.append({
-                    "instance_id": p.instance_id,
-                    "hostname": p.hostname,
-                    "ip_address": p.ip_address,
-                    "viz_port": p.viz_port,
-                    "mode": p.status.agent_mode if p.status else "unknown",
-                    "embryo_count": p.status.embryo_count if p.status else 0,
-                    "is_trusted": p.is_trusted,
-                    "tls_enabled": p.tls_enabled,
-                    "shared_campaigns": [],
-                })
+                result.append(
+                    {
+                        "instance_id": p.instance_id,
+                        "hostname": p.hostname,
+                        "ip_address": p.ip_address,
+                        "viz_port": p.viz_port,
+                        "mode": p.status.agent_mode if p.status else "unknown",
+                        "embryo_count": p.status.embryo_count if p.status else 0,
+                        "is_trusted": p.is_trusted,
+                        "tls_enabled": p.tls_enabled,
+                        "shared_campaigns": [],
+                    }
+                )
             await send_fn({"type": "browse_result", "target": "peers", "data": result})
 
         elif target == "peer_campaigns":
@@ -981,25 +1092,29 @@ def serialize_campaign(c):
                 campaigns = []
                 if p.instance_id == peer.instance_id:
                     for c in shared:
-                        campaigns.append({
-                            "id": c.get("id", ""),
-                            "shorthand": c.get("shorthand", ""),
-                            "description": c.get("description", ""),
-                            "total": c.get("item_count", 0),
-                            "completed": c.get("completed_count", 0),
-                            "items": [],
-                        })
-                result.append({
-                    "instance_id": p.instance_id,
-                    "hostname": p.hostname,
-                    "ip_address": p.ip_address,
-                    "viz_port": p.viz_port,
-                    "mode": p.status.agent_mode if p.status else "unknown",
-                    "embryo_count": p.status.embryo_count if p.status else 0,
-                    "is_trusted": p.is_trusted,
-                    "tls_enabled": p.tls_enabled,
-                    "shared_campaigns": campaigns,
-                })
+                        campaigns.append(
+                            {
+                                "id": c.get("id", ""),
+                                "shorthand": c.get("shorthand", ""),
+                                "description": c.get("description", ""),
+                                "total": c.get("item_count", 0),
+                                "completed": c.get("completed_count", 0),
+                                "items": [],
+                            }
+                        )
+                result.append(
+                    {
+                        "instance_id": p.instance_id,
+                        "hostname": p.hostname,
+                        "ip_address": p.ip_address,
+                        "viz_port": p.viz_port,
+                        "mode": p.status.agent_mode if p.status else "unknown",
+                        "embryo_count": p.status.embryo_count if p.status else 0,
+                        "is_trusted": p.is_trusted,
+                        "tls_enabled": p.tls_enabled,
+                        "shared_campaigns": campaigns,
+                    }
+                )
             await send_fn({"type": "browse_result", "target": "peer_campaigns", "data": result})
 
         elif target == "peer_campaign_items":
@@ -1007,31 +1122,53 @@ def serialize_campaign(c):
             campaign_id = data.get("campaign_id", "")
             mesh_svc = getattr(server, "mesh_service", None)
             if not mesh_svc or not hostname or not campaign_id:
-                await send_fn({"type": "browse_result", "target": "peer_campaign_items", "data": []})
+                await send_fn(
+                    {
+                        "type": "browse_result",
+                        "target": "peer_campaign_items",
+                        "data": [],
+                    }
+                )
                 return
             peer = mesh_svc.find_peer_by_hostname(hostname)
             if not peer or not mesh_svc.peer_client:
-                await send_fn({"type": "browse_result", "target": "peer_campaign_items", "data": []})
+                await send_fn(
+                    {
+                        "type": "browse_result",
+                        "target": "peer_campaign_items",
+                        "data": [],
+                    }
+                )
                 return
             export = await mesh_svc.peer_client.fetch_campaign_export(peer, campaign_id)
             if not export:
-                await send_fn({"type": "browse_result", "target": "peer_campaign_items", "data": []})
+                await send_fn(
+                    {
+                        "type": "browse_result",
+                        "target": "peer_campaign_items",
+                        "data": [],
+                    }
+                )
                 return
             items = []
             for item in export.get("items", []):
-                items.append({
-                    "id": item.get("id", ""),
-                    "title": item.get("title", ""),
-                    "status": item.get("status", "planned"),
-                    "claimed_by_hostname": item.get("claimed_by_hostname"),
-                })
-            await send_fn({
-                "type": "browse_result",
-                "target": "peer_campaign_items",
-                "data": items,
-                "campaign_id": campaign_id,
-                "hostname": hostname,
-            })
+                items.append(
+                    {
+                        "id": item.get("id", ""),
+                        "title": item.get("title", ""),
+                        "status": item.get("status", "planned"),
+                        "claimed_by_hostname": item.get("claimed_by_hostname"),
+                    }
+                )
+            await send_fn(
+                {
+                    "type": "browse_result",
+                    "target": "peer_campaign_items",
+                    "data": items,
+                    "campaign_id": campaign_id,
+                    "hostname": hostname,
+                }
+            )
 
     except Exception as e:
         logger.debug(f"Browse error ({target}): {e}")
diff --git a/gently/ui/web/routes/auth_routes.py b/gently/ui/web/routes/auth_routes.py
index dd4e0629..07e338f1 100644
--- a/gently/ui/web/routes/auth_routes.py
+++ b/gently/ui/web/routes/auth_routes.py
@@ -10,7 +10,12 @@
 from fastapi import APIRouter, Request
 from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse
 
-from gently.ui.web.accounts import get_account_store, CONTROL_ROLES, ROLES, _SESSION_TTL_SECONDS
+from gently.ui.web.accounts import (
+    _SESSION_TTL_SECONDS,
+    CONTROL_ROLES,
+    ROLES,
+    get_account_store,
+)
 from gently.ui.web.auth import SESSION_COOKIE, current_username
 
 logger = logging.getLogger(__name__)
@@ -52,9 +57,13 @@ async def login(request: Request):
         token = store.issue_session(username)
         resp = JSONResponse({"ok": True, "username": username, "role": role})
         resp.set_cookie(
-            SESSION_COOKIE, token,
-            httponly=True, samesite="lax", secure=_secure(request),
-            max_age=_SESSION_TTL_SECONDS, path="/",
+            SESSION_COOKIE,
+            token,
+            httponly=True,
+            samesite="lax",
+            secure=_secure(request),
+            max_age=_SESSION_TTL_SECONDS,
+            path="/",
         )
         logger.info("login ok: %s (%s)", username, role)
         return resp
@@ -74,11 +83,15 @@ async def me(request: Request):
         if not username:
             return JSONResponse({"accounts": True, "authenticated": False})
         role = store.get_role(username)
-        return JSONResponse({
-            "accounts": True, "authenticated": True,
-            "username": username, "role": role,
-            "can_control": role in CONTROL_ROLES,
-        })
+        return JSONResponse(
+            {
+                "accounts": True,
+                "authenticated": True,
+                "username": username,
+                "role": role,
+                "can_control": role in CONTROL_ROLES,
+            }
+        )
 
     @router.post("/api/auth/users")
     async def create_user(request: Request):
diff --git a/gently/ui/web/routes/campaigns.py b/gently/ui/web/routes/campaigns.py
index e5e59611..a3fea08c 100644
--- a/gently/ui/web/routes/campaigns.py
+++ b/gently/ui/web/routes/campaigns.py
@@ -4,7 +4,7 @@
 import logging
 from dataclasses import asdict
 from datetime import datetime
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 from fastapi import APIRouter, Depends, HTTPException, Request
 
@@ -121,13 +121,13 @@ async def get_campaign_document(campaign_id: str):
         # Pre-index every item in the tree once. The naive enrichment used to call
         # cs.get_plan_item(...) per dep + per dependent, each one walking the on-disk
         # campaign index — O(items × deps × campaigns) YAML reads per request.
-        items_by_id: Dict[str, Dict] = {}
-        dependents_map: Dict[str, List[str]] = {}
+        items_by_id: dict[str, dict] = {}
+        dependents_map: dict[str, list[str]] = {}
 
         def _index(node):
             for it in node.get("items", []):
                 items_by_id[it["id"]] = it
-                for dep_id in (it.get("depends_on") or []):
+                for dep_id in it.get("depends_on") or []:
                     dependents_map.setdefault(dep_id, []).append(it["id"])
             for child in node.get("children", []):
                 _index(child)
@@ -147,16 +147,12 @@ def _enrich_tree(node):
             for item in node.get("items", []):
                 item_id = item["id"]
                 dep_ids = list(item.get("depends_on") or [])
-                item["dependencies"] = [
-                    {"id": d, "title": _resolve_title(d)} for d in dep_ids
-                ]
+                item["dependencies"] = [{"id": d, "title": _resolve_title(d)} for d in dep_ids]
                 dnt_ids = dependents_map.get(item_id, [])
-                item["dependents"] = [
-                    {"id": d, "title": _resolve_title(d)} for d in dnt_ids
-                ]
+                item["dependents"] = [{"id": d, "title": _resolve_title(d)} for d in dnt_ids]
 
                 # Collect references into bibliography
-                for ref in (item.get("references") or []):
+                for ref in item.get("references") or []:
                     source = ref.get("source", "")
                     key = ref.get("key", ref.get("id", ref.get("title", "")))
                     dedup_key = (source, key)
@@ -227,16 +223,26 @@ async def get_item_detail(campaign_id: str, item_id: str):
         dependencies = []
         for did in dep_ids:
             dep = cs.get_plan_item(did)
-            dependencies.append({"id": did, "title": dep.title if dep else did[:8],
-                                 "status": dep.status.value if dep else None})
+            dependencies.append(
+                {
+                    "id": did,
+                    "title": dep.title if dep else did[:8],
+                    "status": dep.status.value if dep else None,
+                }
+            )
 
         # Dependents with titles
         dnt_ids = cs.get_plan_item_dependents(item_id)
         dependents = []
         for did in dnt_ids:
             dnt = cs.get_plan_item(did)
-            dependents.append({"id": did, "title": dnt.title if dnt else did[:8],
-                               "status": dnt.status.value if dnt else None})
+            dependents.append(
+                {
+                    "id": did,
+                    "title": dnt.title if dnt else did[:8],
+                    "status": dnt.status.value if dnt else None,
+                }
+            )
 
         # Sessions linked to this campaign
         sessions = cs.get_sessions_for_campaign(item.campaign_id)
@@ -280,9 +286,12 @@ async def _require(request: Request):
                     if required_scope not in scopes:
                         if _audit:
                             from gently.mesh.audit import AuditEvent
+
                             _audit.log(
-                                AuditEvent.SCOPE_DENIED, outcome="deny",
-                                peer_id=peer_id, ip=host,
+                                AuditEvent.SCOPE_DENIED,
+                                outcome="deny",
+                                peer_id=peer_id,
+                                ip=host,
                                 detail=f"scope={required_scope} path={request.url.path}",
                             )
                         raise HTTPException(
@@ -291,36 +300,51 @@ async def _require(request: Request):
                         )
                     if _audit:
                         from gently.mesh.audit import AuditEvent
+
                         _audit.log(
-                            AuditEvent.AUTH_SUCCESS, outcome="allow",
-                            peer_id=peer_id, ip=host,
+                            AuditEvent.AUTH_SUCCESS,
+                            outcome="allow",
+                            peer_id=peer_id,
+                            ip=host,
                         )
                     return
             if _audit:
                 from gently.mesh.audit import AuditEvent
+
                 _audit.log(
-                    AuditEvent.AUTH_FAILURE, outcome="deny",
-                    ip=host, detail=f"path={request.url.path}",
+                    AuditEvent.AUTH_FAILURE,
+                    outcome="deny",
+                    ip=host,
+                    detail=f"path={request.url.path}",
                 )
             raise HTTPException(status_code=403, detail="Mesh authentication required")
 
         return _require
 
-    @router.post("/api/campaigns/{campaign_id}/share", dependencies=[Depends(_make_campaign_auth("campaigns:admin"))])
+    @router.post(
+        "/api/campaigns/{campaign_id}/share",
+        dependencies=[Depends(_make_campaign_auth("campaigns:admin"))],
+    )
     async def share_campaign(campaign_id: str):
         cs = _get_store()
         campaign = _resolve(cs, campaign_id)
         cs.share_campaign(campaign.id)
         return {"ok": True}
 
-    @router.post("/api/campaigns/{campaign_id}/unshare", dependencies=[Depends(_make_campaign_auth("campaigns:admin"))])
+    @router.post(
+        "/api/campaigns/{campaign_id}/unshare",
+        dependencies=[Depends(_make_campaign_auth("campaigns:admin"))],
+    )
     async def unshare_campaign(campaign_id: str):
         cs = _get_store()
         campaign = _resolve(cs, campaign_id)
         cs.unshare_campaign(campaign.id)
         return {"ok": True}
 
-    @router.get("/api/campaigns/{campaign_id}/export", dependencies=[Depends(_make_campaign_auth("campaigns"))])
+    @router.get(
+        "/api/campaigns/{campaign_id}/export",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
     async def export_campaign(campaign_id: str):
         cs = _get_store()
         campaign = _resolve(cs, campaign_id)
@@ -328,7 +352,10 @@ async def export_campaign(campaign_id: str):
         _enrich_export_with_claims(tree, cs, campaign.id)
         return tree
 
-    @router.post("/api/campaigns/{campaign_id}/join", dependencies=[Depends(_make_campaign_auth("campaigns"))])
+    @router.post(
+        "/api/campaigns/{campaign_id}/join",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
     async def join_campaign(campaign_id: str, request: Request):
         cs = _get_store()
         campaign = _resolve(cs, campaign_id)
@@ -340,14 +367,20 @@ async def join_campaign(campaign_id: str, request: Request):
         cs.add_campaign_participant(campaign.id, instance_id, hostname)
         return {"ok": True}
 
-    @router.get("/api/campaigns/{campaign_id}/participants", dependencies=[Depends(_make_campaign_auth("campaigns"))])
+    @router.get(
+        "/api/campaigns/{campaign_id}/participants",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
     async def get_participants(campaign_id: str):
         cs = _get_store()
         campaign = _resolve(cs, campaign_id)
         participants = cs.get_campaign_participants(campaign.id)
         return {"participants": participants}
 
-    @router.post("/api/campaigns/{campaign_id}/items/{item_id}/claim", dependencies=[Depends(_make_campaign_auth("campaigns"))])
+    @router.post(
+        "/api/campaigns/{campaign_id}/items/{item_id}/claim",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
     async def claim_item(campaign_id: str, item_id: str, request: Request):
         cs = _get_store()
         _resolve(cs, campaign_id)
@@ -361,14 +394,20 @@ async def claim_item(campaign_id: str, item_id: str, request: Request):
             raise HTTPException(status_code=409, detail="Item already claimed by another node")
         return {"ok": True}
 
-    @router.post("/api/campaigns/{campaign_id}/items/{item_id}/unclaim", dependencies=[Depends(_make_campaign_auth("campaigns"))])
+    @router.post(
+        "/api/campaigns/{campaign_id}/items/{item_id}/unclaim",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
     async def unclaim_item(campaign_id: str, item_id: str):
         cs = _get_store()
         _resolve(cs, campaign_id)
         cs.unclaim_plan_item(item_id)
         return {"ok": True}
 
-    @router.post("/api/campaigns/{campaign_id}/items/{item_id}/status", dependencies=[Depends(_make_campaign_auth("campaigns"))])
+    @router.post(
+        "/api/campaigns/{campaign_id}/items/{item_id}/status",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
     async def update_item_status(campaign_id: str, item_id: str, request: Request):
         cs = _get_store()
         _resolve(cs, campaign_id)
@@ -380,7 +419,7 @@ async def update_item_status(campaign_id: str, item_id: str, request: Request):
         try:
             item_status = PlanItemStatus(status_str)
         except ValueError:
-            raise HTTPException(status_code=400, detail=f"Invalid status: {status_str}")
+            raise HTTPException(status_code=400, detail=f"Invalid status: {status_str}") from None
         cs.update_plan_item(item_id, status=item_status, outcome=outcome)
         return {"ok": True}
 
@@ -388,7 +427,7 @@ async def update_item_status(campaign_id: str, item_id: str, request: Request):
     # Helpers
     # ------------------------------------------------------------------
 
-    def _build_campaign_tree(cs, campaign_id: str) -> Optional[Dict]:
+    def _build_campaign_tree(cs, campaign_id: str) -> dict | None:
         """Recursively build campaign tree with plan items and status."""
         campaign = cs.get_campaign(campaign_id)
         if not campaign:
@@ -410,13 +449,10 @@ def _build_campaign_tree(cs, campaign_id: str) -> Optional[Dict]:
                 "in_progress": status["in_progress"],
                 "planned": status["planned"],
             },
-            "children": [
-                _build_campaign_tree(cs, child.id)
-                for child in children
-            ],
+            "children": [_build_campaign_tree(cs, child.id) for child in children],
         }
 
-    def _enrich_export_with_claims(tree: Dict, cs, campaign_id: str):
+    def _enrich_export_with_claims(tree: dict, cs, campaign_id: str):
         """Walk a serialized campaign tree and annotate items with IDs and claim info."""
         items = cs.get_plan_items(campaign_id=campaign_id)
         items.sort(key=lambda x: x.phase_order)
diff --git a/gently/ui/web/routes/chat.py b/gently/ui/web/routes/chat.py
index 1cdd15f7..8c66dd45 100644
--- a/gently/ui/web/routes/chat.py
+++ b/gently/ui/web/routes/chat.py
@@ -14,7 +14,6 @@
 import logging
 from datetime import datetime
 from pathlib import Path
-from typing import Optional
 
 from fastapi import APIRouter, Depends, HTTPException
 from fastapi.responses import StreamingResponse
@@ -45,21 +44,21 @@ class ChatRequest(BaseModel):
     message: str
 
 
-def _resolve_session_dir(server, sid: str) -> Optional[Path]:
+def _resolve_session_dir(server, sid: str) -> Path | None:
     store = getattr(server, "gently_store", None)
     if store is None:
         return None
     return store._session_dir(sid)
 
 
-def _trace_path(server, sid: str, eid: str, tp: int) -> Optional[Path]:
+def _trace_path(server, sid: str, eid: str, tp: int) -> Path | None:
     sd = _resolve_session_dir(server, sid)
     if sd is None:
         return None
     return sd / "embryos" / eid / "traces" / f"t{tp:04d}.json"
 
 
-def _chat_path(server, sid: str, eid: str, tp: int) -> Optional[Path]:
+def _chat_path(server, sid: str, eid: str, tp: int) -> Path | None:
     sd = _resolve_session_dir(server, sid)
     if sd is None:
         return None
@@ -70,7 +69,7 @@ def _load_history(path: Path) -> list[dict]:
     if not path.exists():
         return []
     turns: list[dict] = []
-    with open(path, "r", encoding="utf-8") as f:
+    with open(path, encoding="utf-8") as f:
         for line in f:
             line = line.strip()
             if not line:
@@ -108,8 +107,13 @@ async def get_chat(sid: str, eid: str, tp: int):
         return {"turns": _load_history(path)}
 
     @router.post("/api/perception/chat/{sid}/{eid}/{tp}")
-    async def post_chat(sid: str, eid: str, tp: int, body: ChatRequest,
-                        _control=Depends(require_control)):
+    async def post_chat(
+        sid: str,
+        eid: str,
+        tp: int,
+        body: ChatRequest,
+        _control=Depends(require_control),  # noqa: B008
+    ):
         """Append a user message and stream the assistant reply as SSE.
 
         Each SSE event is JSON: ``{"type": "delta", "text": "..."}`` for
@@ -129,7 +133,7 @@ async def post_chat(sid: str, eid: str, tp: int, body: ChatRequest,
                 detail=f"No perception trace for T{tp}",
             )
 
-        with open(trace_path, "r", encoding="utf-8") as f:
+        with open(trace_path, encoding="utf-8") as f:
             trace = json.load(f)
         stage = trace.get("predicted_stage", "unknown")
         reasoning = trace.get("reasoning", "")
@@ -167,9 +171,7 @@ async def post_chat(sid: str, eid: str, tp: int, body: ChatRequest,
         }
         seed_assistant = {
             "role": "assistant",
-            "content": [
-                {"type": "text", "text": f"Stage: {stage}\n\n{reasoning}"}
-            ],
+            "content": [{"type": "text", "text": f"Stage: {stage}\n\n{reasoning}"}],
         }
 
         messages: list[dict] = [seed_user, seed_assistant]
@@ -177,9 +179,7 @@ async def post_chat(sid: str, eid: str, tp: int, body: ChatRequest,
             role = turn.get("role")
             content = turn.get("content", "")
             if role in ("user", "assistant") and content:
-                messages.append(
-                    {"role": role, "content": [{"type": "text", "text": content}]}
-                )
+                messages.append({"role": role, "content": [{"type": "text", "text": content}]})
         messages.append(
             {
                 "role": "user",
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index c8c0ebe7..93d49451 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -3,7 +3,6 @@
 import logging
 from datetime import datetime
 from pathlib import Path
-from typing import Optional
 
 import yaml
 from fastapi import APIRouter, Body, Depends, HTTPException
@@ -28,7 +27,7 @@ async def get_status():
             "status": "running",
             "connections": len(server.manager.active_connections),
             **stats,
-            "timestamp": datetime.now().isoformat()
+            "timestamp": datetime.now().isoformat(),
         }
 
     @router.get("/api/device-status")
@@ -77,11 +76,10 @@ def _require_agent_with_experiment():
             raise HTTPException(status_code=503, detail="Agent not ready")
         return agent
 
-    @router.put("/api/embryos/{embryo_id}/position",
-                dependencies=[Depends(require_control)])
+    @router.put("/api/embryos/{embryo_id}/position", dependencies=[Depends(require_control)])
     async def update_embryo_position(
         embryo_id: str,
-        body: dict = Body(...),
+        body: dict = Body(...),  # noqa: B008
     ):
         """Update an embryo's coarse XY position.
 
@@ -102,9 +100,9 @@ async def update_embryo_position(
             x = float(body.get("x"))
             y = float(body.get("y"))
         except (TypeError, ValueError):
-            raise HTTPException(status_code=400, detail="Body needs numeric x and y")
+            raise HTTPException(status_code=400, detail="Body needs numeric x and y") from None
         old_coarse = dict(emb.position_coarse) if emb.position_coarse else None
-        had_fine   = bool(emb.position_fine)
+        had_fine = bool(emb.position_fine)
         emb.position_coarse = {"x": x, "y": y}
         emb.position_fine = {}
         agent.experiment.notify_embryos_changed()
@@ -112,6 +110,7 @@ async def update_embryo_position(
         bus = getattr(agent, "_event_bus", None)
         if bus is not None:
             from gently.core.event_bus import EventType
+
             try:
                 bus.publish(
                     event_type=EventType.OPERATOR_EDITED_EMBRYO,
@@ -127,8 +126,7 @@ async def update_embryo_position(
                 logger.exception("Failed to publish OPERATOR_EDITED_EMBRYO")
         return emb.to_dict()
 
-    @router.delete("/api/embryos/{embryo_id}",
-                   dependencies=[Depends(require_control)])
+    @router.delete("/api/embryos/{embryo_id}", dependencies=[Depends(require_control)])
     async def delete_embryo(embryo_id: str):
         """Remove an embryo from the experiment.
 
@@ -144,7 +142,7 @@ async def delete_embryo(embryo_id: str):
         if emb is not None:
             last_position = {
                 "coarse": dict(emb.position_coarse) if emb.position_coarse else None,
-                "fine":   dict(emb.position_fine) if emb.position_fine else None,
+                "fine": dict(emb.position_fine) if emb.position_fine else None,
             }
         if not agent.experiment.remove_embryo(embryo_id):
             raise HTTPException(status_code=404, detail=f"Embryo {embryo_id} not found")
@@ -152,6 +150,7 @@ async def delete_embryo(embryo_id: str):
         bus = getattr(agent, "_event_bus", None)
         if bus is not None:
             from gently.core.event_bus import EventType
+
             try:
                 bus.publish(
                     event_type=EventType.OPERATOR_REMOVED_EMBRYO,
@@ -201,17 +200,19 @@ async def get_coverslip():
         block in this config and no zone endpoint here.
         """
         try:
-            with open(_HARDWARE_CONFIG_PATH, "r") as f:
+            with open(_HARDWARE_CONFIG_PATH) as f:
                 cfg = yaml.safe_load(f) or {}
         except FileNotFoundError:
             return {"coverslip": None}
         cs = cfg.get("coverslip")
         if not isinstance(cs, dict):
             return {"coverslip": None}
-        return {"coverslip": {
-            "center_um": list(cs.get("center_um") or [0.0, 0.0]),
-            "size_mm":   list(cs.get("size_mm")   or [50.0, 24.0]),
-        }}
+        return {
+            "coverslip": {
+                "center_um": list(cs.get("center_um") or [0.0, 0.0]),
+                "size_mm": list(cs.get("size_mm") or [50.0, 24.0]),
+            }
+        }
 
     @router.get("/api/devices/bottom_camera/status")
     async def get_bottom_camera_status():
@@ -225,8 +226,10 @@ async def get_bottom_camera_status():
             "last_frame_ts": getattr(monitor, "_last_frame_ts", None) if monitor else None,
         }
 
-    @router.post("/api/devices/bottom_camera/stream/start",
-                 dependencies=[Depends(require_control)])
+    @router.post(
+        "/api/devices/bottom_camera/stream/start",
+        dependencies=[Depends(require_control)],
+    )
     async def start_bottom_camera_stream():
         """Start the bottom-camera stream bridge.
 
@@ -244,11 +247,13 @@ async def start_bottom_camera_stream():
             await monitor.start()
         except Exception as exc:
             logger.exception("Failed to start bottom-camera monitor")
-            raise HTTPException(status_code=500, detail=f"start failed: {exc}")
+            raise HTTPException(status_code=500, detail=f"start failed: {exc}") from exc
         return {"streaming": monitor.running}
 
-    @router.post("/api/devices/bottom_camera/stream/stop",
-                 dependencies=[Depends(require_control)])
+    @router.post(
+        "/api/devices/bottom_camera/stream/stop",
+        dependencies=[Depends(require_control)],
+    )
     async def stop_bottom_camera_stream():
         """Stop the bottom-camera stream bridge. Idempotent."""
         bridge = getattr(server, "agent_bridge", None)
@@ -260,7 +265,7 @@ async def stop_bottom_camera_stream():
             await monitor.stop()
         except Exception as exc:
             logger.exception("Failed to stop bottom-camera monitor")
-            raise HTTPException(status_code=500, detail=f"stop failed: {exc}")
+            raise HTTPException(status_code=500, detail=f"stop failed: {exc}") from exc
         return {"streaming": False}
 
     def _resolve_client():
@@ -285,9 +290,8 @@ async def get_room_light_status():
             "state": res.get("state", "unknown"),
         }
 
-    @router.post("/api/devices/room_light/set",
-                 dependencies=[Depends(require_control)])
-    async def set_room_light(payload: dict = Body(...)):
+    @router.post("/api/devices/room_light/set", dependencies=[Depends(require_control)])
+    async def set_room_light(payload: dict = Body(...)):  # noqa: B008
         """Switch the room light on/off. Body: {"state": "on"|"off"|"press"}."""
         state = str(payload.get("state", "")).lower()
         if state not in ("on", "off", "press"):
@@ -299,9 +303,13 @@ async def set_room_light(payload: dict = Body(...)):
             res = await client.set_room_light(state)
         except Exception as exc:
             logger.exception("Room light command failed")
-            raise HTTPException(status_code=502, detail=f"room light command failed: {exc}")
+            raise HTTPException(
+                status_code=502, detail=f"room light command failed: {exc}"
+            ) from exc
         if not res.get("success"):
-            raise HTTPException(status_code=502, detail=res.get("error", "room light command failed"))
+            raise HTTPException(
+                status_code=502, detail=res.get("error", "room light command failed")
+            )
         return {"state": res.get("state", state)}
 
     @router.get("/api/devices/temperature/status")
@@ -328,9 +336,8 @@ async def get_temperature_status():
             "peltier_c": res.get("peltier_c"),
         }
 
-    @router.post("/api/devices/temperature/set",
-                 dependencies=[Depends(require_control)])
-    async def set_temperature(payload: dict = Body(...)):
+    @router.post("/api/devices/temperature/set", dependencies=[Depends(require_control)])
+    async def set_temperature(payload: dict = Body(...)):  # noqa: B008
         """Command the temperature setpoint. Body: {"target_c": float}.
 
         Non-blocking: the controller ramps and the status poll reflects progress
@@ -339,7 +346,7 @@ async def set_temperature(payload: dict = Body(...)):
         try:
             target = float(payload.get("target_c"))
         except (TypeError, ValueError):
-            raise HTTPException(status_code=400, detail="target_c must be a number")
+            raise HTTPException(status_code=400, detail="target_c must be a number") from None
         if not (0.0 <= target <= 99.9):
             raise HTTPException(status_code=400, detail="target_c must be between 0.0 and 99.9 C")
         client = _resolve_client()
@@ -349,9 +356,13 @@ async def set_temperature(payload: dict = Body(...)):
             res = await client.set_temperature(target)
         except Exception as exc:
             logger.exception("Temperature command failed")
-            raise HTTPException(status_code=502, detail=f"temperature command failed: {exc}")
+            raise HTTPException(
+                status_code=502, detail=f"temperature command failed: {exc}"
+            ) from exc
         if not res.get("success"):
-            raise HTTPException(status_code=502, detail=res.get("error", "temperature command failed"))
+            raise HTTPException(
+                status_code=502, detail=res.get("error", "temperature command failed")
+            )
         return {
             "target_c": res.get("target_c", target),
             "temperature_c": res.get("temperature_c"),
@@ -360,38 +371,27 @@ async def set_temperature(payload: dict = Body(...)):
         }
 
     @router.get("/api/calibration")
-    async def list_calibration(embryo_id: Optional[str] = None):
+    async def list_calibration(embryo_id: str | None = None):
         """Get calibration images"""
         images = server.store.get_all_calibration(embryo_id)
-        return {
-            "calibration": [img.to_dict() for img in images],
-            "count": len(images)
-        }
+        return {"calibration": [img.to_dict() for img in images], "count": len(images)}
 
     @router.get("/api/volumes")
-    async def list_volumes(embryo_id: Optional[str] = None):
+    async def list_volumes(embryo_id: str | None = None):
         """Get volume images"""
         images = server.store.get_all_volumes(embryo_id)
-        return {
-            "volumes": [img.to_dict() for img in images],
-            "count": len(images)
-        }
+        return {"volumes": [img.to_dict() for img in images], "count": len(images)}
 
     @router.get("/api/snapshots")
-    async def list_snapshots(embryo_id: Optional[str] = None):
+    async def list_snapshots(embryo_id: str | None = None):
         """Get snapshot images"""
         images = server.store.get_all_snapshots(embryo_id)
-        return {
-            "snapshots": [img.to_dict() for img in images],
-            "count": len(images)
-        }
+        return {"snapshots": [img.to_dict() for img in images], "count": len(images)}
 
     @router.get("/api/embryos")
     async def list_embryos():
         """Get list of embryos with images"""
-        return {
-            "embryos": server.store.get_embryo_ids()
-        }
+        return {"embryos": server.store.get_embryo_ids()}
 
     @router.get("/api/embryos/positions")
     async def embryo_positions():
@@ -415,26 +415,28 @@ async def embryo_positions():
                     # Embryo registered but no position yet (e.g. only the
                     # ID arrived from another path). Skip — nothing to render.
                     continue
-                points.append({
-                    "embryo_id": eid,
-                    "uid": emb.get("uid"),
-                    "x": float(x),
-                    "y": float(y),
-                    "role": emb.get("role", "test"),
-                    "user_label": emb.get("user_label"),
-                    "confidence": emb.get("confidence"),
-                    "cadence_phase": emb.get("cadence_phase"),
-                    "is_complete": bool(emb.get("is_complete")),
-                })
+                points.append(
+                    {
+                        "embryo_id": eid,
+                        "uid": emb.get("uid"),
+                        "x": float(x),
+                        "y": float(y),
+                        "role": emb.get("role", "test"),
+                        "user_label": emb.get("user_label"),
+                        "confidence": emb.get("confidence"),
+                        "cadence_phase": emb.get("cadence_phase"),
+                        "is_complete": bool(emb.get("is_complete")),
+                    }
+                )
         return {"embryos": points}
 
     @router.get("/api/sequence/{embryo_id}")
     async def get_image_sequence(
         embryo_id: str,
         start: int = 0,
-        end: Optional[int] = None,
+        end: int | None = None,
         data_type: str = "volume_projection",
-        buffer_percent: float = 0.15
+        buffer_percent: float = 0.15,
     ):
         """Get ordered sequence of images for timepoint range.
 
@@ -455,7 +457,7 @@ async def get_image_sequence(
             embryo_id=embryo_id,
             start=buffered_start,
             end=buffered_end,
-            data_type=data_type
+            data_type=data_type,
         )
 
         # Return lightweight metadata (no base64 data)
@@ -463,26 +465,25 @@ async def get_image_sequence(
         seen_uids = set()
         for img in images:
             seen_uids.add(img.uid)
-            sequence.append({
-                "uid": img.uid,
-                "timepoint": img.metadata.get("timepoint"),
-                "timestamp": img.timestamp,
-                "data_type": img.data_type,
-                "shape": img.shape,
-                "embryo_id": img.metadata.get("embryo_id")
-            })
+            sequence.append(
+                {
+                    "uid": img.uid,
+                    "timepoint": img.metadata.get("timepoint"),
+                    "timestamp": img.timestamp,
+                    "data_type": img.data_type,
+                    "shape": img.shape,
+                    "embryo_id": img.metadata.get("embryo_id"),
+                }
+            )
 
         # Fallback to persistent DataStore for missing timepoints
         if server.data_store and (len(sequence) == 0 or buffered_end is not None):
             try:
-                refs = server.data_store.query(
-                    data_type=data_type,
-                    embryo_id=embryo_id
-                )
+                refs = server.data_store.query(data_type=data_type, embryo_id=embryo_id)
                 for ref in refs:
                     if ref.uid in seen_uids:
                         continue
-                    tp = ref.metadata.get('timepoint')
+                    tp = ref.metadata.get("timepoint")
                     if tp is None:
                         continue
                     tp = int(tp)
@@ -491,16 +492,18 @@ async def get_image_sequence(
                     if buffered_end is not None and tp > buffered_end:
                         continue
                     seen_uids.add(ref.uid)
-                    sequence.append({
-                        "uid": ref.uid,
-                        "timepoint": tp,
-                        "timestamp": ref.metadata.get('timestamp', ''),
-                        "data_type": ref.data_type,
-                        "shape": ref.metadata.get('shape'),
-                        "embryo_id": embryo_id
-                    })
+                    sequence.append(
+                        {
+                            "uid": ref.uid,
+                            "timepoint": tp,
+                            "timestamp": ref.metadata.get("timestamp", ""),
+                            "data_type": ref.data_type,
+                            "shape": ref.metadata.get("shape"),
+                            "embryo_id": embryo_id,
+                        }
+                    )
                 # Re-sort by timepoint
-                sequence.sort(key=lambda x: x.get('timepoint') or 0)
+                sequence.sort(key=lambda x: x.get("timepoint") or 0)
             except Exception as e:
                 logger.warning(f"DataStore fallback failed: {e}")
 
@@ -509,14 +512,12 @@ async def get_image_sequence(
             "requested_range": {"start": start, "end": end},
             "buffered_range": {"start": buffered_start, "end": buffered_end},
             "sequence": sequence,
-            "count": len(sequence)
+            "count": len(sequence),
         }
 
     @router.get("/api/events")
     async def list_events(
-        event_type: Optional[str] = None,
-        source: Optional[str] = None,
-        limit: int = 100
+        event_type: str | None = None, source: str | None = None, limit: int = 100
     ):
         """Get event history from EventBus"""
         if not server.event_bus:
@@ -524,6 +525,7 @@ async def list_events(
 
         # Get history from event bus
         from gently.core import EventType
+
         et = None
         if event_type:
             try:
@@ -531,24 +533,22 @@ async def list_events(
             except KeyError:
                 pass
 
-        events = server.event_bus.get_history(
-            event_type=et,
-            source=source,
-            limit=limit
-        )
+        events = server.event_bus.get_history(event_type=et, source=source, limit=limit)
 
         return {
             "events": [
                 {
-                    "event_type": e.event_type.name if hasattr(e.event_type, 'name') else str(e.event_type),
+                    "event_type": e.event_type.name
+                    if hasattr(e.event_type, "name")
+                    else str(e.event_type),
                     "data": e.data,
                     "source": e.source,
                     "timestamp": e.timestamp.isoformat(),
-                    "event_id": e.event_id
+                    "event_id": e.event_id,
                 }
                 for e in events
             ],
-            "total": len(events)
+            "total": len(events),
         }
 
     return router
diff --git a/gently/ui/web/routes/experiments.py b/gently/ui/web/routes/experiments.py
index 3b8c9506..c2c5de77 100644
--- a/gently/ui/web/routes/experiments.py
+++ b/gently/ui/web/routes/experiments.py
@@ -61,6 +61,6 @@ async def get_strategy(session_id: str):
             raise HTTPException(
                 status_code=500,
                 detail=f"Failed to build strategy: {e}",
-            )
+            ) from e
 
     return router
diff --git a/gently/ui/web/routes/images.py b/gently/ui/web/routes/images.py
index 5d505b6a..ce690493 100644
--- a/gently/ui/web/routes/images.py
+++ b/gently/ui/web/routes/images.py
@@ -2,11 +2,10 @@
 
 import base64
 import logging
-from typing import Optional
 
 import numpy as np
 from fastapi import APIRouter, HTTPException, Request
-from fastapi.responses import Response, FileResponse
+from fastapi.responses import FileResponse, Response
 
 from ..volume_helpers import parse_volume_uid
 
@@ -66,17 +65,22 @@ async def get_image_png(uid: str):
                 if data is None and parsed:
                     embryo_id, timepoint = parsed
                     if embryo_id in server.timelapse_tracker.projection_uids:
-                        real_uid = server.timelapse_tracker.projection_uids[embryo_id].get(timepoint)
+                        real_uid = server.timelapse_tracker.projection_uids[embryo_id].get(
+                            timepoint
+                        )
                         if real_uid:
                             data = server.data_store.retrieve(real_uid)
                 if data is not None:
                     from io import BytesIO
+
                     from PIL import Image
+
                     from gently.core.imaging import (
-                        projection_three_view,
-                        compute_crop_bounds,
                         apply_crop_bounds,
+                        compute_crop_bounds,
+                        projection_three_view,
                     )
+
                     # Handle numpy array
                     if isinstance(data, np.ndarray):
                         # Handle 4D volumes (Views, Z, Y, X) - take View A
@@ -87,18 +91,24 @@ async def get_image_png(uid: str):
                             z_depth, height, width = data.shape
                             # Handle dual-view format
                             if width > height * 2:
-                                data = data[:, :, :width // 2]
+                                data = data[:, :, : width // 2]
                             # Auto-crop and project
                             bounds = compute_crop_bounds(data)
                             data = apply_crop_bounds(data, bounds)
                             data, _ = projection_three_view(data)
                         # Normalize to uint8 if needed
                         if data.dtype != np.uint8:
-                            data = ((data - data.min()) / (data.max() - data.min() + 1e-8) * 255).astype(np.uint8)
+                            data = (
+                                (data - data.min()) / (data.max() - data.min() + 1e-8) * 255
+                            ).astype(np.uint8)
                         img = Image.fromarray(data)
                         buf = BytesIO()
-                        img.save(buf, format='PNG')
-                        return Response(content=buf.getvalue(), media_type="image/png", headers=cache_headers)
+                        img.save(buf, format="PNG")
+                        return Response(
+                            content=buf.getvalue(),
+                            media_type="image/png",
+                            headers=cache_headers,
+                        )
             except Exception as e:
                 logger.warning(f"Failed to load image {uid} from DataStore: {e}")
 
@@ -131,21 +141,18 @@ async def push_image_http(request: Request):
             data = await request.json()
 
             # Decode the image from base64
-            image_b64 = data.get('image_b64')
-            uid = data.get('uid')
-            shape = data.get('shape')
-            dtype = data.get('dtype', 'uint8')
-            data_type = data.get('data_type', 'cv_visualization')
-            metadata = data.get('metadata', {})
+            image_b64 = data.get("image_b64")
+            uid = data.get("uid")
+            shape = data.get("shape")
+            dtype = data.get("dtype", "uint8")
+            data_type = data.get("data_type", "cv_visualization")
+            metadata = data.get("metadata", {})
 
             if not all([image_b64, uid, shape]):
                 raise HTTPException(status_code=400, detail="Missing required fields")
 
             # Decode array
-            array = np.frombuffer(
-                base64.b64decode(image_b64),
-                dtype=np.dtype(dtype)
-            ).reshape(shape)
+            array = np.frombuffer(base64.b64decode(image_b64), dtype=np.dtype(dtype)).reshape(shape)
 
             # Push using the existing method
             await server.push_image(array, uid, data_type, metadata)
@@ -154,6 +161,6 @@ async def push_image_http(request: Request):
 
         except Exception as e:
             logger.error(f"Failed to push image via HTTP: {e}")
-            raise HTTPException(status_code=500, detail=str(e))
+            raise HTTPException(status_code=500, detail=str(e)) from e
 
     return router
diff --git a/gently/ui/web/routes/pages.py b/gently/ui/web/routes/pages.py
index 3cf5c37a..3858f4e7 100644
--- a/gently/ui/web/routes/pages.py
+++ b/gently/ui/web/routes/pages.py
@@ -16,9 +16,7 @@ async def index(request: Request):
         chat window's "Sign in" affordance), not a gate on the page itself.
         """
         return server.templates.TemplateResponse(
-            request,
-            "index.html",
-            {"active_section": "embryos", "is_live": True}
+            request, "index.html", {"active_section": "embryos", "is_live": True}
         )
 
     # Standalone URLs redirect to SPA with hash fragment for tab routing
diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index 310ae9cf..ccbc3a93 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -43,15 +43,17 @@ async def list_sessions():
                     count = len(store.list_embryos(sid) or [])
                 except Exception:
                     count = 0
-                sessions.append({
-                    "session_id": sid,
-                    "name": s.get("name") or sid,
-                    "created_at": s.get("created_at", ""),
-                    "last_active": s.get("last_active", ""),
-                    "embryo_count": count,
-                    "description": s.get("description", ""),
-                    "active": sid == active_id,
-                })
+                sessions.append(
+                    {
+                        "session_id": sid,
+                        "name": s.get("name") or sid,
+                        "created_at": s.get("created_at", ""),
+                        "last_active": s.get("last_active", ""),
+                        "embryo_count": count,
+                        "description": s.get("description", ""),
+                        "active": sid == active_id,
+                    }
+                )
         except Exception as e:
             logger.warning("Failed to list sessions from FileStore: %s", e)
         return {"sessions": sessions}
@@ -82,7 +84,7 @@ async def recent_images(limit: int = 8, scan: int = 200):
         scan = max(1, min(int(scan), 500))
         out = []
         try:
-            for sid in (store.recent_session_ids(scan) or []):
+            for sid in store.recent_session_ids(scan) or []:
                 try:
                     eids = store.list_embryo_ids(sid)
                 except Exception:
@@ -101,12 +103,14 @@ async def recent_images(limit: int = 8, scan: int = 200):
                         except Exception:
                             info = None
                         sname = (info.get("name") if info else None) or sid
-                    out.append({
-                        "session_id": sid,
-                        "session_name": sname,
-                        "embryo_id": eid,
-                        "timepoint": int(max(tps)),
-                    })
+                    out.append(
+                        {
+                            "session_id": sid,
+                            "session_name": sname,
+                            "embryo_id": eid,
+                            "timepoint": int(max(tps)),
+                        }
+                    )
                     if len(out) >= limit:
                         break
                 if len(out) >= limit:
@@ -139,7 +143,7 @@ async def get_session_projection(session_id: str, embryo: str, t: int):
         except HTTPException:
             raise
         except Exception:
-            raise HTTPException(status_code=404, detail="Not found")
+            raise HTTPException(status_code=404, detail="Not found") from None
         try:
             st = resolved.stat()
             etag = f'"{int(st.st_mtime)}-{st.st_size}"'
@@ -148,11 +152,9 @@ async def get_session_projection(session_id: str, embryo: str, t: int):
         headers = {"Cache-Control": "private, max-age=60"}
         if etag:
             headers["ETag"] = etag
-        return FileResponse(str(resolved), media_type="image/jpeg",
-                            headers=headers)
+        return FileResponse(str(resolved), media_type="image/jpeg", headers=headers)
 
-    @router.post("/api/sessions/{session_id}/resume",
-                 dependencies=[Depends(require_control)])
+    @router.post("/api/sessions/{session_id}/resume", dependencies=[Depends(require_control)])
     async def resume_session(session_id: str):
         """Switch the live agent to a different saved session.
 
@@ -169,13 +171,17 @@ async def resume_session(session_id: str):
         if store is None or store.get_session(session_id) is None:
             raise HTTPException(status_code=404, detail="Session not found")
         if session_id == getattr(agent, "session_id", None):
-            return {"ok": True, "session_id": session_id, "active": True,
-                    "note": "already active"}
+            return {
+                "ok": True,
+                "session_id": session_id,
+                "active": True,
+                "note": "already active",
+            }
         try:
             ok = agent.resume_session(session_id)
         except Exception as e:
             logger.exception("Session resume failed")
-            raise HTTPException(status_code=500, detail=f"resume failed: {e}")
+            raise HTTPException(status_code=500, detail=f"resume failed: {e}") from e
         if not ok:
             raise HTTPException(status_code=500, detail="resume returned false")
         # Rehydrate the viz image store from disk so the resumed session's
@@ -188,12 +194,15 @@ async def resume_session(session_id: str):
         # Tell every connected browser to reload — they'll reconnect to the
         # new session's state (embryos, transcript, rehydrated imagery).
         try:
-            await server.manager.broadcast({"type": "session_changed",
-                                            "session_id": session_id})
+            await server.manager.broadcast({"type": "session_changed", "session_id": session_id})
         except Exception:
             pass
-        return {"ok": True, "session_id": session_id, "active": True,
-                "rehydrated_projections": rehydrated}
+        return {
+            "ok": True,
+            "session_id": session_id,
+            "active": True,
+            "rehydrated_projections": rehydrated,
+        }
 
     @router.get("/api/sessions/{session_id}")
     async def get_session(session_id: str):
diff --git a/gently/ui/web/routes/volumes.py b/gently/ui/web/routes/volumes.py
index e48475c3..d2c66dac 100644
--- a/gently/ui/web/routes/volumes.py
+++ b/gently/ui/web/routes/volumes.py
@@ -3,18 +3,18 @@
 import base64
 import io
 import logging
-from typing import Optional
 
 import numpy as np
 from fastapi import APIRouter, HTTPException, Request
 from fastapi.responses import Response
 
-from ..volume_helpers import load_volume_from_disk, image_to_base64_png
+from ..volume_helpers import image_to_base64_png, load_volume_from_disk
 
 logger = logging.getLogger(__name__)
 
 try:
     from PIL import Image
+
     PIL_AVAILABLE = True
 except ImportError:
     PIL_AVAILABLE = False
@@ -31,7 +31,8 @@ async def get_projections(embryo_id: str, timepoint: int, method: str = "all"):
         Args:
             embryo_id: Embryo identifier
             timepoint: Timepoint number (1-indexed)
-            method: Projection method - 'all', 'three_view', 'dual_view', 'depth_colored', 'multi_slice'
+            method: Projection method - 'all', 'three_view', 'dual_view',
+                'depth_colored', 'multi_slice'
 
         Returns:
             List of projections with method name, description, and base64 PNG data
@@ -41,7 +42,10 @@ async def get_projections(embryo_id: str, timepoint: int, method: str = "all"):
         # Look up volume path (timelapse tracker + FileStore fallback)
         volume_path = server._resolve_volume_path(embryo_id, timepoint)
         if not volume_path:
-            raise HTTPException(status_code=404, detail=f"No volume for {embryo_id} at timepoint {timepoint}")
+            raise HTTPException(
+                status_code=404,
+                detail=f"No volume for {embryo_id} at timepoint {timepoint}",
+            )
 
         # Load volume from disk
         try:
@@ -52,29 +56,32 @@ async def get_projections(embryo_id: str, timepoint: int, method: str = "all"):
             vol = (vol - vol.min()) / (vol.max() - vol.min() + 1e-8)
 
         except FileNotFoundError as e:
-            raise HTTPException(status_code=404, detail=str(e))
+            raise HTTPException(status_code=404, detail=str(e)) from e
         except Exception as e:
             logger.error(f"Failed to load volume: {e}")
-            raise HTTPException(status_code=500, detail=f"Failed to load volume: {e}")
+            raise HTTPException(status_code=500, detail=f"Failed to load volume: {e}") from e
 
         PROJECTION_METHODS = {
-            'three_view': projection_three_view,
+            "three_view": projection_three_view,
         }
 
         # Try to import additional projection methods from explorer
         try:
             from gently.dataset.explorer_server import (
-                projection_dual_view,
                 projection_depth_colored,
+                projection_dual_view,
                 projection_multi_slice,
                 projection_spin_3d,
             )
-            PROJECTION_METHODS.update({
-                'dual_view': projection_dual_view,
-                'depth_colored': projection_depth_colored,
-                'multi_slice': projection_multi_slice,
-                'spin_3d': projection_spin_3d,
-            })
+
+            PROJECTION_METHODS.update(
+                {
+                    "dual_view": projection_dual_view,
+                    "depth_colored": projection_depth_colored,
+                    "multi_slice": projection_multi_slice,
+                    "spin_3d": projection_spin_3d,
+                }
+            )
         except ImportError:
             pass  # Explorer projections not available
 
@@ -84,22 +91,31 @@ async def get_projections(embryo_id: str, timepoint: int, method: str = "all"):
             for method_name, method_func in PROJECTION_METHODS.items():
                 try:
                     proj_img, desc = method_func(vol)
-                    projections.append({
-                        "method": method_name,
-                        "description": desc,
-                        "data": image_to_base64_png(proj_img),
-                    })
+                    projections.append(
+                        {
+                            "method": method_name,
+                            "description": desc,
+                            "data": image_to_base64_png(proj_img),
+                        }
+                    )
                 except Exception as e:
                     logger.warning(f"Projection {method_name} failed: {e}")
         else:
             if method not in PROJECTION_METHODS:
-                raise HTTPException(status_code=400, detail=f"Unknown method: {method}. Available: {list(PROJECTION_METHODS.keys())}")
+                raise HTTPException(
+                    status_code=400,
+                    detail=(
+                        f"Unknown method: {method}. Available: {list(PROJECTION_METHODS.keys())}"
+                    ),
+                )
             proj_img, desc = PROJECTION_METHODS[method](vol)
-            projections.append({
-                "method": method,
-                "description": desc,
-                "data": image_to_base64_png(proj_img),
-            })
+            projections.append(
+                {
+                    "method": method,
+                    "description": desc,
+                    "data": image_to_base64_png(proj_img),
+                }
+            )
 
         return {
             "embryo_id": embryo_id,
@@ -120,7 +136,10 @@ async def get_volume_raw(embryo_id: str, timepoint: int):
         # Look up volume path (timelapse tracker + FileStore fallback)
         volume_path = server._resolve_volume_path(embryo_id, timepoint)
         if not volume_path:
-            raise HTTPException(status_code=404, detail=f"No volume for {embryo_id} at timepoint {timepoint}")
+            raise HTTPException(
+                status_code=404,
+                detail=f"No volume for {embryo_id} at timepoint {timepoint}",
+            )
 
         try:
             vol = load_volume_from_disk(volume_path)
@@ -137,7 +156,7 @@ async def get_volume_raw(embryo_id: str, timepoint: int):
 
             # Encode as base64
             vol_bytes = vol_uint8.tobytes()
-            vol_b64 = base64.b64encode(vol_bytes).decode('utf-8')
+            vol_b64 = base64.b64encode(vol_bytes).decode("utf-8")
 
             # Physical voxel size for isometric 3D rendering.
             # Matches the default in gently.core.imaging.projection_three_view:
@@ -155,17 +174,17 @@ async def get_volume_raw(embryo_id: str, timepoint: int):
             }
 
         except FileNotFoundError as e:
-            raise HTTPException(status_code=404, detail=str(e))
+            raise HTTPException(status_code=404, detail=str(e)) from e
         except Exception as e:
             logger.error(f"Failed to load volume: {e}")
-            raise HTTPException(status_code=500, detail=f"Failed to load volume: {e}")
+            raise HTTPException(status_code=500, detail=f"Failed to load volume: {e}") from e
 
     @router.get("/api/volumes3d")
     async def list_volumes_3d():
         """Get list of 3D volumes (without heavy data)"""
         return {
             "volumes_3d": server.store.get_all_volumes_3d(),
-            "count": len(server.store._volumes_3d)
+            "count": len(server.store._volumes_3d),
         }
 
     @router.get("/api/volumes3d/{uid}")
@@ -188,7 +207,7 @@ async def get_volume_3d_slice(uid: str, z: int):
         if PIL_AVAILABLE:
             img = Image.fromarray(rgb)
             buffer = io.BytesIO()
-            img.save(buffer, format='PNG')
+            img.save(buffer, format="PNG")
             return Response(content=buffer.getvalue(), media_type="image/png")
 
         raise HTTPException(status_code=500, detail="PIL not available")
@@ -209,14 +228,17 @@ async def get_volume_data_for_3d_viewer(uid: str):
                     volume = np.zeros(volume.shape, dtype=np.uint8)
             return {
                 "shape": list(volume.shape),
-                "data": base64.b64encode(volume.tobytes()).decode('utf-8'),
-                "uid": uid
+                "data": base64.b64encode(volume.tobytes()).decode("utf-8"),
+                "uid": uid,
             }
 
         # Check if it's a regular image with stored volume data
         image = server.store.get_image_by_uid(uid)
         if image and image.shape and len(image.shape) == 3:
-            raise HTTPException(status_code=404, detail=f"Volume data for {uid} not available - only segmented volumes supported")
+            raise HTTPException(
+                status_code=404,
+                detail=f"Volume data for {uid} not available - only segmented volumes supported",
+            )
 
         raise HTTPException(status_code=404, detail=f"Volume {uid} not found")
 
@@ -227,27 +249,25 @@ async def push_volume_3d_http(request: Request):
             data = await request.json()
 
             # Decode the volume and masks from base64
-            volume_b64 = data.get('volume_b64')
-            masks_b64 = data.get('masks_b64')
-            uid = data.get('uid')
-            shape = data.get('shape')
-            dtype_vol = data.get('dtype_vol', 'uint16')
-            dtype_mask = data.get('dtype_mask', 'uint16')
-            metadata = data.get('metadata', {})
+            volume_b64 = data.get("volume_b64")
+            masks_b64 = data.get("masks_b64")
+            uid = data.get("uid")
+            shape = data.get("shape")
+            dtype_vol = data.get("dtype_vol", "uint16")
+            dtype_mask = data.get("dtype_mask", "uint16")
+            metadata = data.get("metadata", {})
 
             if not all([volume_b64, masks_b64, uid, shape]):
                 raise HTTPException(status_code=400, detail="Missing required fields")
 
             # Decode arrays
-            volume = np.frombuffer(
-                base64.b64decode(volume_b64),
-                dtype=np.dtype(dtype_vol)
-            ).reshape(shape)
+            volume = np.frombuffer(base64.b64decode(volume_b64), dtype=np.dtype(dtype_vol)).reshape(
+                shape
+            )
 
-            masks = np.frombuffer(
-                base64.b64decode(masks_b64),
-                dtype=np.dtype(dtype_mask)
-            ).reshape(shape)
+            masks = np.frombuffer(base64.b64decode(masks_b64), dtype=np.dtype(dtype_mask)).reshape(
+                shape
+            )
 
             # Push using the existing method
             await server.push_volume_3d(volume, masks, uid, metadata)
@@ -256,6 +276,6 @@ async def push_volume_3d_http(request: Request):
 
         except Exception as e:
             logger.error(f"Failed to push 3D volume via HTTP: {e}")
-            raise HTTPException(status_code=500, detail=str(e))
+            raise HTTPException(status_code=500, detail=str(e)) from e
 
     return router
diff --git a/gently/ui/web/routes/websocket.py b/gently/ui/web/routes/websocket.py
index 3b35f3e1..de66552c 100644
--- a/gently/ui/web/routes/websocket.py
+++ b/gently/ui/web/routes/websocket.py
@@ -14,9 +14,14 @@
 # /ws message types that mutate experiment state (define what gets imaged).
 # These are control actions and are gated by role; pure read/presence
 # messages stay open so anyone can watch.
-_MARKING_TYPES = frozenset({
-    "embryo_marked", "marking_update", "marking_done", "marking_redetect",
-})
+_MARKING_TYPES = frozenset(
+    {
+        "embryo_marked",
+        "marking_update",
+        "marking_done",
+        "marking_redetect",
+    }
+)
 
 
 def _ws_can_control(websocket: WebSocket) -> bool:
@@ -25,8 +30,9 @@ def _ws_can_control(websocket: WebSocket) -> bool:
     Account mode: operators/admins (by session cookie) only. Legacy mode
     (no accounts configured): open, preserving prior behavior.
     """
-    from gently.ui.web.accounts import get_account_store, CONTROL_ROLES
+    from gently.ui.web.accounts import CONTROL_ROLES, get_account_store
     from gently.ui.web.auth import SESSION_COOKIE
+
     store = get_account_store()
     if store is None or not store.has_users():
         return True
@@ -47,11 +53,9 @@ async def websocket_endpoint(websocket: WebSocket):
         try:
             # Send current status on connect
             stats = server.store.get_stats()
-            await websocket.send_json({
-                "type": "connected",
-                **stats,
-                "timestamp": datetime.now().isoformat()
-            })
+            await websocket.send_json(
+                {"type": "connected", **stats, "timestamp": datetime.now().isoformat()}
+            )
 
             # Always send timelapse state on connect so client can reconcile
             # (if IDLE with no session_id, client will clear stale cached state)
@@ -67,18 +71,12 @@ async def websocket_endpoint(websocket: WebSocket):
                         timelapse_state["session_id"] = live_sid
             except Exception:
                 pass
-            await websocket.send_json({
-                "type": "timelapse_state",
-                "data": timelapse_state
-            })
+            await websocket.send_json({"type": "timelapse_state", "data": timelapse_state})
 
             # Keep connection alive and handle incoming messages
             while True:
                 try:
-                    data = await asyncio.wait_for(
-                        websocket.receive_text(),
-                        timeout=30.0
-                    )
+                    data = await asyncio.wait_for(websocket.receive_text(), timeout=30.0)
                     # Handle client messages (e.g., requests)
                     await _handle_ws_message(server, websocket, data)
                 except asyncio.TimeoutError:
@@ -119,39 +117,30 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
 
         if msg_type == "get_calibration":
             images = server.store.get_all_calibration(embryo_id)
-            await websocket.send_json({
-                "type": "calibration",
-                "data": [img.to_dict() for img in images]
-            })
+            await websocket.send_json(
+                {"type": "calibration", "data": [img.to_dict() for img in images]}
+            )
 
         elif msg_type == "get_volumes":
             images = server.store.get_all_volumes(embryo_id)
-            await websocket.send_json({
-                "type": "volumes",
-                "data": [img.to_dict() for img in images]
-            })
+            await websocket.send_json(
+                {"type": "volumes", "data": [img.to_dict() for img in images]}
+            )
 
         elif msg_type == "get_snapshots":
             images = server.store.get_all_snapshots(embryo_id)
-            await websocket.send_json({
-                "type": "snapshots",
-                "data": [img.to_dict() for img in images]
-            })
+            await websocket.send_json(
+                {"type": "snapshots", "data": [img.to_dict() for img in images]}
+            )
 
         elif msg_type == "get_embryos":
-            await websocket.send_json({
-                "type": "embryos",
-                "data": server.store.get_embryo_ids()
-            })
+            await websocket.send_json({"type": "embryos", "data": server.store.get_embryo_ids()})
 
         elif msg_type == "get_image":
             uid = data.get("uid")
             image = server.store.get_image_by_uid(uid)
             if image:
-                await websocket.send_json({
-                    "type": "image",
-                    "data": image.to_dict()
-                })
+                await websocket.send_json({"type": "image", "data": image.to_dict()})
 
         elif msg_type == "pong":
             pass  # Client responding to ping
@@ -165,7 +154,8 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
                 # Sanitize name: strip HTML tags, limit length
                 if name:
                     import re
-                    name = re.sub(r'<[^>]+>', '', name)[:50]
+
+                    name = re.sub(r"<[^>]+>", "", name)[:50]
                 # Update the client's info
                 async with server.manager._lock:
                     if websocket in server.manager.active_connections:
@@ -174,7 +164,7 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
                             client_id=client_id,
                             name=name or old_info.name,
                             color=server.manager._generate_color(client_id),
-                            connected_at=old_info.connected_at
+                            connected_at=old_info.connected_at,
                         )
                 await server.manager.broadcast_presence()
 
@@ -184,7 +174,8 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
             if name:
                 # Sanitize name: strip HTML tags, limit length
                 import re
-                name = re.sub(r'<[^>]+>', '', name)[:50]
+
+                name = re.sub(r"<[^>]+>", "", name)[:50]
                 await server.manager.update_client_name(websocket, name)
 
         elif msg_type == "get_presence":
@@ -195,16 +186,19 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
         elif msg_type == "embryo_marked":
             session_id = data.get("session_id")
             marker = data.get("marker")
-            if session_id and marker and hasattr(server, '_marking_sessions'):
+            if session_id and marker and hasattr(server, "_marking_sessions"):
                 session = server._marking_sessions.get(session_id)
                 if session:
                     session["markers"].append(marker)
-                    logger.info(f"Embryo marked: #{marker['number']} at ({marker['pixelX']}, {marker['pixelY']})")
+                    logger.info(
+                        f"Embryo marked: #{marker['number']}"
+                        f" at ({marker['pixelX']}, {marker['pixelY']})"
+                    )
 
         elif msg_type == "marking_update":
             session_id = data.get("session_id")
             markers = data.get("markers", [])
-            if session_id and hasattr(server, '_marking_sessions'):
+            if session_id and hasattr(server, "_marking_sessions"):
                 session = server._marking_sessions.get(session_id)
                 if session:
                     session["markers"] = markers
@@ -213,7 +207,7 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
         elif msg_type == "marking_done":
             session_id = data.get("session_id")
             markers = data.get("markers", [])
-            if session_id and hasattr(server, '_marking_sessions'):
+            if session_id and hasattr(server, "_marking_sessions"):
                 session = server._marking_sessions.get(session_id)
                 if session:
                     session["markers"] = markers
@@ -223,8 +217,7 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
                         r = m.get("role", "test")
                         role_summary[r] = role_summary.get(r, 0) + 1
                     logger.info(
-                        f"Marking complete: {len(markers)} embryo(s) "
-                        f"(roles: {role_summary})"
+                        f"Marking complete: {len(markers)} embryo(s) (roles: {role_summary})"
                     )
 
         elif msg_type == "marking_redetect":
@@ -234,13 +227,14 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
             # listen for. Once recapture lands, the agent calls
             # start_marking_session again with the new image + markers.
             session_id = data.get("session_id")
-            if session_id and hasattr(server, '_marking_sessions'):
+            if session_id and hasattr(server, "_marking_sessions"):
                 session = server._marking_sessions.get(session_id)
                 if session is not None:
                     session["redetect_requested"] = True
                     logger.info(f"Marking redetect requested for session {session_id}")
                     try:
                         from gently.core import EventType, get_event_bus
+
                         get_event_bus().publish(
                             event_type=EventType.STATUS_CHANGED,
                             data={
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index 58cfbd65..12e47714 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -24,7 +24,6 @@
 import sys
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional
 
 import numpy as np
 
@@ -35,11 +34,12 @@
 
 # Optional imports
 try:
+    import uvicorn
     from fastapi import FastAPI
+    from fastapi.middleware.cors import CORSMiddleware
     from fastapi.staticfiles import StaticFiles
     from fastapi.templating import Jinja2Templates
-    from fastapi.middleware.cors import CORSMiddleware
-    import uvicorn
+
     FASTAPI_AVAILABLE = True
 except ImportError:
     FASTAPI_AVAILABLE = False
@@ -60,8 +60,7 @@ class _InvalidHttpFilter(logging.Filter):
     def filter(self, record: logging.LogRecord) -> bool:
         msg = record.getMessage()
         if "Invalid HTTP request received" in msg:
-            logger.debug("uvicorn dropped non-HTTP bytes on viz port "
-                         "(probable TLS/peer mismatch)")
+            logger.debug("uvicorn dropped non-HTTP bytes on viz port (probable TLS/peer mismatch)")
             return False
         return True
 
@@ -76,25 +75,39 @@ def filter(self, record: logging.LogRecord) -> bool:
 
 try:
     from PIL import Image
+
     PIL_AVAILABLE = True
 except ImportError:
     PIL_AVAILABLE = False
 
 # Import data models and components
-from .models import (
-    ClientInfo, Volume3DData, ImageData, EmbryoImageCache,
-    CALIBRATION_TYPES, VOLUME_TYPES, ANALYSIS_TYPES, VOLUME_3D_TYPES,
+from .connection_manager import ConnectionManager  # noqa: E402
+from .image_store import ImageStore  # noqa: E402
+from .models import (  # noqa: E402
+    ANALYSIS_TYPES,
+    CALIBRATION_TYPES,
+    VOLUME_3D_TYPES,
+    VOLUME_TYPES,
+    ClientInfo,
+    EmbryoImageCache,
+    ImageData,
+    Volume3DData,
 )
-from .image_store import ImageStore
-from .timelapse_tracker import TimelapseStateTracker
-from .connection_manager import ConnectionManager
+from .timelapse_tracker import TimelapseStateTracker  # noqa: E402
 
 # Re-export for backward compatibility
 __all__ = [
-    'VisualizationServer', 'create_visualization_server',
-    'ClientInfo', 'Volume3DData', 'ImageData', 'EmbryoImageCache',
-    'CALIBRATION_TYPES', 'VOLUME_TYPES', 'ANALYSIS_TYPES', 'VOLUME_3D_TYPES',
-    'ImageStore',
+    "VisualizationServer",
+    "create_visualization_server",
+    "ClientInfo",
+    "Volume3DData",
+    "ImageData",
+    "EmbryoImageCache",
+    "CALIBRATION_TYPES",
+    "VOLUME_TYPES",
+    "ANALYSIS_TYPES",
+    "VOLUME_3D_TYPES",
+    "ImageStore",
 ]
 
 
@@ -161,7 +174,7 @@ def __init__(
         self.app = FastAPI(
             title="Gently Visualization Server",
             description="Real-time microscopy visualization",
-            version="2.0.0"
+            version="2.0.0",
         )
 
         # Setup templates and static files
@@ -179,6 +192,7 @@ def __init__(
 
         # Register route groups
         from .routes import register_all_routes
+
         register_all_routes(self)
 
         # Subscribe to events if event bus provided
@@ -193,7 +207,7 @@ def set_context_store(self, context_store) -> None:
         """Set the FileContextStore for campaign/plan data access."""
         self.context_store = context_store
 
-    def _resolve_volume_path(self, embryo_id: str, timepoint: int) -> Optional[str]:
+    def _resolve_volume_path(self, embryo_id: str, timepoint: int) -> str | None:
         """Resolve volume file path from timelapse tracker or FileStore."""
         # 1. Try timelapse tracker (in-memory, fastest)
         if embryo_id in self.timelapse_tracker.volume_paths:
@@ -209,7 +223,9 @@ def _resolve_volume_path(self, embryo_id: str, timepoint: int) -> Optional[str]:
         if self.gently_store and sid:
             try:
                 vol_path = self.gently_store.get_volume_path(
-                    sid, embryo_id, timepoint,
+                    sid,
+                    embryo_id,
+                    timepoint,
                 )
                 if vol_path and vol_path.exists():
                     return str(vol_path)
@@ -218,7 +234,7 @@ def _resolve_volume_path(self, embryo_id: str, timepoint: int) -> Optional[str]:
 
         return None
 
-    def _current_session_id(self) -> Optional[str]:
+    def _current_session_id(self) -> str | None:
         """The live agent session (source of truth), falling back to the
         timelapse tracker. The tracker's session_id goes stale after a resume
         with no active timelapse, so the live agent session is preferred."""
@@ -229,13 +245,15 @@ def _current_session_id(self) -> Optional[str]:
                 return sid
         return self.timelapse_tracker.session_id
 
-    def _resolve_projection_path(self, embryo_id: str, timepoint: int) -> Optional[Path]:
+    def _resolve_projection_path(self, embryo_id: str, timepoint: int) -> Path | None:
         """Resolve projection file path from FileStore (current session)."""
         sid = self._current_session_id()
         if self.gently_store and sid:
             try:
                 proj_path = self.gently_store.get_projection_path(
-                    sid, embryo_id, timepoint,
+                    sid,
+                    embryo_id,
+                    timepoint,
                 )
                 if proj_path and proj_path.exists():
                     return proj_path
@@ -271,12 +289,14 @@ def rehydrate_session(self, session_id: str) -> int:
             except Exception:
                 tps = []
             for tp in tps:
-                self.store.add_image(ImageData(
-                    uid=f"volume_{eid}_t{tp:04d}",
-                    data_type="volume_projection",
-                    timestamp=f"{tp:06d}",  # monotonic with timepoint for ordering
-                    metadata={"embryo_id": eid, "timepoint": tp},
-                ))
+                self.store.add_image(
+                    ImageData(
+                        uid=f"volume_{eid}_t{tp:04d}",
+                        data_type="volume_projection",
+                        timestamp=f"{tp:06d}",  # monotonic with timepoint for ordering
+                        metadata={"embryo_id": eid, "timepoint": tp},
+                    )
+                )
                 added += 1
 
         # Rehydrate the timelapse tracker's per-embryo perception state from
@@ -289,7 +309,11 @@ def rehydrate_session(self, session_id: str) -> int:
             tracker.detection_reasoning = {}
             tracker.projection_uids = {}
             for emb in embryos:
-                eid = emb.get("embryo_id") if isinstance(emb, dict) else getattr(emb, "embryo_id", None)
+                eid = (
+                    emb.get("embryo_id")
+                    if isinstance(emb, dict)
+                    else getattr(emb, "embryo_id", None)
+                )
                 if not eid:
                     continue
                 try:
@@ -307,22 +331,30 @@ def rehydrate_session(self, session_id: str) -> int:
                     puids[tp] = uid
                     stage = p.get("predicted_stage")
                     last_stage = stage or last_stage
-                    items.append({
-                        "timepoint": tp,
-                        "stage": stage,
-                        "detected_stage": stage,
-                        "reasoning": p.get("reasoning"),
-                        "confidence": p.get("confidence"),
-                        "projection_uid": uid,
-                        "image_uid": uid,
-                        "detector_name": "perception",
-                    })
+                    items.append(
+                        {
+                            "timepoint": tp,
+                            "stage": stage,
+                            "detected_stage": stage,
+                            "reasoning": p.get("reasoning"),
+                            "confidence": p.get("confidence"),
+                            "projection_uid": uid,
+                            "image_uid": uid,
+                            "detector_name": "perception",
+                        }
+                    )
                 tracker.detection_reasoning[eid] = items
                 tracker.projection_uids[eid] = puids
-                entry = tracker.embryos.setdefault(eid, {
-                    "embryo_id": eid, "timepoints": 0, "is_complete": False,
-                    "detections": {}, "current_stage": None,
-                })
+                entry = tracker.embryos.setdefault(
+                    eid,
+                    {
+                        "embryo_id": eid,
+                        "timepoints": 0,
+                        "is_complete": False,
+                        "detections": {},
+                        "current_stage": None,
+                    },
+                )
                 entry["timepoints"] = max((it["timepoint"] for it in items), default=0)
                 entry["current_stage"] = last_stage
             tracker.total_timepoints = sum(len(v) for v in tracker.detection_reasoning.values())
@@ -341,7 +373,11 @@ def _subscribe_to_events(self):
 
         async def on_event_async(event):
             """Async handler for all events - broadcasts to WebSocket clients"""
-            event_type_str = event.event_type.name if hasattr(event.event_type, 'name') else str(event.event_type)
+            event_type_str = (
+                event.event_type.name
+                if hasattr(event.event_type, "name")
+                else str(event.event_type)
+            )
 
             # Update timelapse state tracker
             self.timelapse_tracker.handle_event(event_type_str, event.data)
@@ -351,15 +387,17 @@ async def on_event_async(event):
                 event_type=event_type_str,
                 data=event.data,
                 source=event.source,
-                event_id=event.event_id
+                event_id=event.event_id,
             )
 
             # For session events, also broadcast updated timelapse_state so clients can sync
             if event_type_str in ("SESSION_STARTED", "SESSION_RESTORED"):
-                await self.manager.broadcast({
-                    "type": "timelapse_state",
-                    "data": self.timelapse_tracker.to_dict()
-                })
+                await self.manager.broadcast(
+                    {
+                        "type": "timelapse_state",
+                        "data": self.timelapse_tracker.to_dict(),
+                    }
+                )
 
         # Subscribe to ALL events using wildcard with async handler
         self.event_bus.subscribe_async("*", on_event_async)
@@ -377,11 +415,19 @@ def _init_from_event_history(self):
 
             # Process events in chronological order (history is newest-first)
             for event in reversed(history):
-                event_type_str = event.event_type.name if hasattr(event.event_type, 'name') else str(event.event_type)
+                event_type_str = (
+                    event.event_type.name
+                    if hasattr(event.event_type, "name")
+                    else str(event.event_type)
+                )
                 self.timelapse_tracker.handle_event(event_type_str, event.data)
 
             if self.timelapse_tracker.session_id:
-                logger.info(f"Initialized timelapse state from history: session={self.timelapse_tracker.session_id}, status={self.timelapse_tracker.status}")
+                logger.info(
+                    f"Initialized timelapse state from history:"
+                    f" session={self.timelapse_tracker.session_id},"
+                    f" status={self.timelapse_tracker.status}"
+                )
         except Exception as e:
             logger.warning(f"Failed to initialize from event history: {e}")
 
@@ -390,13 +436,13 @@ def _array_to_image_data(
         array: np.ndarray,
         uid: str,
         data_type: str,
-        metadata: Optional[Dict] = None
+        metadata: dict | None = None,
     ) -> ImageData:
         """Convert numpy array to ImageData with base64 PNG"""
         from gently.core.imaging import (
-            projection_three_view,
-            compute_crop_bounds,
             apply_crop_bounds,
+            compute_crop_bounds,
+            projection_three_view,
         )
 
         # Handle 4D arrays (Views, Z, Y, X) - select View A only
@@ -413,7 +459,7 @@ def _array_to_image_data(
                 z_depth, height, width = array.shape
                 # Handle dual-view format (width > 2*height)
                 if width > height * 2:
-                    array = array[:, :, :width // 2]
+                    array = array[:, :, : width // 2]
                 # Auto-crop to embryo region
                 bounds = compute_crop_bounds(array)
                 array = apply_crop_bounds(array, bounds)
@@ -433,8 +479,8 @@ def _array_to_image_data(
         if PIL_AVAILABLE:
             img = Image.fromarray(array)
             buffer = io.BytesIO()
-            img.save(buffer, format='PNG')
-            base64_png = base64.b64encode(buffer.getvalue()).decode('utf-8')
+            img.save(buffer, format="PNG")
+            base64_png = base64.b64encode(buffer.getvalue()).decode("utf-8")
 
         return ImageData(
             uid=uid,
@@ -442,7 +488,7 @@ def _array_to_image_data(
             timestamp=datetime.now().isoformat(),
             metadata=metadata or {},
             base64_png=base64_png,
-            shape=array.shape
+            shape=array.shape,
         )
 
     async def push_image(
@@ -450,7 +496,7 @@ async def push_image(
         array: np.ndarray,
         uid: str,
         data_type: str = "image",
-        metadata: Optional[Dict] = None,
+        metadata: dict | None = None,
     ):
         """
         Push an image to connected clients
@@ -474,14 +520,16 @@ async def push_image(
         # Broadcast to clients
         await self.manager.send_image(image_data)
 
-        logger.debug(f"Pushed image {uid} ({data_type}) to {len(self.manager.active_connections)} clients")
+        logger.debug(
+            f"Pushed image {uid} ({data_type}) to {len(self.manager.active_connections)} clients"
+        )
 
     async def start_marking_session(
         self,
         image: np.ndarray,
         initial_stage_position: tuple = (0.0, 0.0),
         pixel_size_um: float = 0.65,
-        initial_markers: Optional[list] = None,
+        initial_markers: list | None = None,
         default_role: str = "test",
     ) -> str:
         """
@@ -517,7 +565,7 @@ async def start_marking_session(
         """
         import uuid
 
-        if not hasattr(self, '_marking_sessions'):
+        if not hasattr(self, "_marking_sessions"):
             self._marking_sessions = {}
 
         session_id = str(uuid.uuid4())[:8]
@@ -529,15 +577,17 @@ async def start_marking_session(
             py = m.get("pixel_y", m.get("pixelY"))
             if px is None or py is None:
                 continue
-            normalized.append({
-                "number": i + 1,
-                "pixelX": round(float(px), 1),
-                "pixelY": round(float(py), 1),
-                "role": m.get("role", default_role),
-                "source": m.get("source", "sam"),
-                "embryo_id": m.get("embryo_id"),
-                "confidence": m.get("confidence"),
-            })
+            normalized.append(
+                {
+                    "number": i + 1,
+                    "pixelX": round(float(px), 1),
+                    "pixelY": round(float(py), 1),
+                    "role": m.get("role", default_role),
+                    "source": m.get("source", "sam"),
+                    "embryo_id": m.get("embryo_id"),
+                    "confidence": m.get("confidence"),
+                }
+            )
 
         self._marking_sessions[session_id] = {
             "markers": list(normalized),
@@ -550,31 +600,34 @@ async def start_marking_session(
 
         # Encode image as base64 PNG
         from PIL import Image as PILImage
+
         img = image
         if img.dtype != np.uint8:
             img = ((img - img.min()) / max(img.max() - img.min(), 1) * 255).astype(np.uint8)
         pil_img = PILImage.fromarray(img)
         buf = io.BytesIO()
-        pil_img.save(buf, format='PNG')
-        b64 = base64.b64encode(buf.getvalue()).decode('ascii')
+        pil_img.save(buf, format="PNG")
+        b64 = base64.b64encode(buf.getvalue()).decode("ascii")
 
         h, w = image.shape[:2]
 
         # Broadcast to all clients
-        await self.manager.broadcast({
-            "type": "marking_image",
-            "data": {
-                "session_id": session_id,
-                "image_b64": b64,
-                "width": w,
-                "height": h,
-                "initial_markers": normalized,
-                "default_role": default_role,
-                "stage_x_um": float(initial_stage_position[0]),
-                "stage_y_um": float(initial_stage_position[1]),
-                "pixel_size_um": pixel_size_um,
+        await self.manager.broadcast(
+            {
+                "type": "marking_image",
+                "data": {
+                    "session_id": session_id,
+                    "image_b64": b64,
+                    "width": w,
+                    "height": h,
+                    "initial_markers": normalized,
+                    "default_role": default_role,
+                    "stage_x_um": float(initial_stage_position[0]),
+                    "stage_y_um": float(initial_stage_position[1]),
+                    "pixel_size_um": pixel_size_um,
+                },
             }
-        })
+        )
 
         logger.info(
             f"Marking session {session_id} started, image {w}x{h}, "
@@ -610,9 +663,9 @@ async def wait_for_marking(self, session_id: str, timeout: float = None) -> list
 
         markers = session["markers"]
         initial_pos = session["initial_stage_position"]
-        pixel_size = session["pixel_size_um"]
+        session["pixel_size_um"]
         h, w = session["image_shape"][:2]
-        center_x, center_y = w / 2, h / 2
+        _center_x, _center_y = w / 2, h / 2
 
         # Convert to embryo entries. Carries role + source so callers can
         # register each embryo with the right experimental classification.
@@ -620,18 +673,20 @@ async def wait_for_marking(self, session_id: str, timeout: float = None) -> list
         embryos = []
         for m in markers:
             px, py = m["pixelX"], m["pixelY"]
-            embryos.append({
-                "embryo_number": m["number"],
-                "embryo_id": m.get("embryo_id") or f"embryo_{m['number']:03d}",
-                "pixel_position": (px, py),
-                "pixel_x": px,
-                "pixel_y": py,
-                "initial_stage_position": initial_pos,
-                "role": m.get("role", default_role),
-                "source": m.get("source", "manual"),
-                "confidence": m.get("confidence"),
-                "marking_timestamp": m.get("timestamp", datetime.now().isoformat()),
-            })
+            embryos.append(
+                {
+                    "embryo_number": m["number"],
+                    "embryo_id": m.get("embryo_id") or f"embryo_{m['number']:03d}",
+                    "pixel_position": (px, py),
+                    "pixel_x": px,
+                    "pixel_y": py,
+                    "initial_stage_position": initial_pos,
+                    "role": m.get("role", default_role),
+                    "source": m.get("source", "manual"),
+                    "confidence": m.get("confidence"),
+                    "marking_timestamp": m.get("timestamp", datetime.now().isoformat()),
+                }
+            )
 
         # Clean up
         del self._marking_sessions[session_id]
@@ -643,7 +698,7 @@ async def push_volume_3d(
         volume: np.ndarray,
         masks: np.ndarray,
         uid: str,
-        metadata: Optional[Dict] = None,
+        metadata: dict | None = None,
     ):
         """
         Push a 3D segmentation volume to connected clients
@@ -667,24 +722,24 @@ async def push_volume_3d(
 
         volume_data = Volume3DData(
             uid=uid,
-            data_type='segmentation_3d',
+            data_type="segmentation_3d",
             timestamp=datetime.now().isoformat(),
             volume=volume,
             masks=masks,
             colors=colors,
-            metadata=metadata or {}
+            metadata=metadata or {},
         )
 
         # Store the 3D volume
         self.store.add_volume_3d(volume_data)
 
         # Broadcast notification to clients (without the heavy data)
-        await self.manager.broadcast({
-            'type': 'volume_3d',
-            'data': volume_data.to_info_dict()
-        })
+        await self.manager.broadcast({"type": "volume_3d", "data": volume_data.to_info_dict()})
 
-        logger.info(f"Pushed 3D volume {uid} ({volume.shape}) to {len(self.manager.active_connections)} clients")
+        logger.info(
+            f"Pushed 3D volume {uid} ({volume.shape}) to"
+            f" {len(self.manager.active_connections)} clients"
+        )
 
     async def open_volume_in_browser(
         self,
@@ -699,15 +754,21 @@ async def open_volume_in_browser(
         projections) instead of launching a desktop Qt window that would block
         the shared agent/web event loop. Returns the number of clients notified.
         """
-        await self.manager.broadcast({
-            "type": "open_volume",
-            "embryo_id": embryo_id,
-            "timepoint": timepoint,
-            "view": view,
-        })
+        await self.manager.broadcast(
+            {
+                "type": "open_volume",
+                "embryo_id": embryo_id,
+                "timepoint": timepoint,
+                "view": view,
+            }
+        )
         n = len(self.manager.active_connections)
-        logger.info("Requested browser open_volume for %s t%s (%d client(s))",
-                    embryo_id, timepoint, n)
+        logger.info(
+            "Requested browser open_volume for %s t%s (%d client(s))",
+            embryo_id,
+            timepoint,
+            n,
+        )
         return n
 
     async def on_start(self):
@@ -721,6 +782,7 @@ async def on_start(self):
         # off to uvicorn (whose bind error surfaces inside a background
         # task and produces an unhelpful log line).
         import socket
+
         sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
         try:
             sock.bind((self.host, self.port))
@@ -729,7 +791,7 @@ async def on_start(self):
                 f"Port {self.port} is already in use. "
                 "Is another instance of the agent running? "
                 "Close it first and try again."
-            )
+            ) from None
         finally:
             sock.close()
 
@@ -791,10 +853,10 @@ async def on_stop(self):
             self._server_task = None
         logger.info("Visualization server stopped")
 
-    async def health_check(self) -> Dict:
+    async def health_check(self) -> dict:
         """Return health status with connected client count."""
         base = await super().health_check()
-        base['connected_clients'] = len(self.manager.active_connections)
+        base["connected_clients"] = len(self.manager.active_connections)
         return base
 
     async def run_forever(self):
@@ -811,20 +873,20 @@ def signal_handler(*args):
         loop = asyncio.get_running_loop()
 
         signals_installed = False
-        if hasattr(signal, 'SIGINT'):
+        if hasattr(signal, "SIGINT"):
             try:
                 loop.add_signal_handler(signal.SIGINT, signal_handler)
                 signals_installed = True
             except NotImplementedError:
                 pass
 
-        if hasattr(signal, 'SIGTERM'):
+        if hasattr(signal, "SIGTERM"):
             try:
                 loop.add_signal_handler(signal.SIGTERM, signal_handler)
             except NotImplementedError:
                 pass
 
-        if sys.platform == 'win32' and not signals_installed:
+        if sys.platform == "win32" and not signals_installed:
             signal.signal(signal.SIGINT, signal_handler)
             signal.signal(signal.SIGTERM, signal_handler)
 
@@ -833,21 +895,17 @@ def signal_handler(*args):
         logger.info(f"Server running at http://{self.host}:{self.port} - Press Ctrl+C to stop")
 
         try:
-            if sys.platform == 'win32':
+            if sys.platform == "win32":
                 while not stop_event.is_set():
                     try:
-                        await asyncio.wait_for(
-                            asyncio.shield(self._server_task),
-                            timeout=0.5
-                        )
+                        await asyncio.wait_for(asyncio.shield(self._server_task), timeout=0.5)
                         break
                     except asyncio.TimeoutError:
                         continue
             else:
                 stop_task = asyncio.create_task(stop_event.wait())
                 done, pending = await asyncio.wait(
-                    [self._server_task, stop_task],
-                    return_when=asyncio.FIRST_COMPLETED
+                    [self._server_task, stop_task], return_when=asyncio.FIRST_COMPLETED
                 )
                 for task in pending:
                     task.cancel()
diff --git a/gently/ui/web/strategy_snapshot.py b/gently/ui/web/strategy_snapshot.py
index 46569758..91c560e7 100644
--- a/gently/ui/web/strategy_snapshot.py
+++ b/gently/ui/web/strategy_snapshot.py
@@ -22,7 +22,7 @@
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 import yaml
 
@@ -37,10 +37,10 @@
 # ui_icon names but resolves them to actual unicode glyphs the swimlane SVG
 # can render directly.
 _ROLE_ICONS = {
-    "star":     "★",   # ★
-    "diamond":  "◆",   # ◆
-    "circle":   "●",   # ●
-    "triangle": "▲",   # ▲
+    "star": "★",  # ★
+    "diamond": "◆",  # ◆
+    "circle": "●",  # ●
+    "triangle": "▲",  # ▲
 }
 
 # Default per-timepoint exposure when nothing on disk tells us otherwise.
@@ -60,9 +60,9 @@
 # ---------------------------------------------------------------------------
 
 
-def _read_yaml(path: Path) -> Optional[dict]:
+def _read_yaml(path: Path) -> dict | None:
     try:
-        with open(path, "r", encoding="utf-8") as f:
+        with open(path, encoding="utf-8") as f:
             return yaml.safe_load(f) or {}
     except FileNotFoundError:
         return None
@@ -80,7 +80,7 @@ def _pick_timelapse_yaml(session_dir: Path, legacy_session_dir: Path) -> dict:
     orchestrator that hasn't yet been restarted (still writing to legacy)
     isn't shadowed by a stale new-path file.
     """
-    candidates: List[Path] = [
+    candidates: list[Path] = [
         session_dir / "timelapse.yaml",
         legacy_session_dir / "timelapse.yaml",
     ]
@@ -93,6 +93,7 @@ def _pick_timelapse_yaml(session_dir: Path, legacy_session_dir: Path) -> dict:
         return {}
     if len(docs) == 1:
         return docs[0][1]
+
     # Pick by saved_at if present, falling back to file mtime.
     def _saved_at_key(item):
         path, doc = item
@@ -105,11 +106,12 @@ def _saved_at_key(item):
             return path.stat().st_mtime
         except OSError:
             return 0.0
+
     docs.sort(key=_saved_at_key, reverse=True)
     return docs[0][1]
 
 
-def _parse_iso(s: Optional[str]) -> Optional[datetime]:
+def _parse_iso(s: str | None) -> datetime | None:
     if not s:
         return None
     try:
@@ -118,7 +120,7 @@ def _parse_iso(s: Optional[str]) -> Optional[datetime]:
         return None
 
 
-def _elapsed_s(t: Optional[datetime], started_at: datetime) -> Optional[float]:
+def _elapsed_s(t: datetime | None, started_at: datetime) -> float | None:
     if t is None:
         return None
     return (t - started_at).total_seconds()
@@ -132,19 +134,21 @@ def _elapsed_s(t: Optional[datetime], started_at: datetime) -> Optional[float]:
 @dataclass
 class _EmbryoAccum:
     """Mutable accumulator while replaying timeline events for one embryo."""
+
     eid: str
-    phases: List[dict]
-    trigger_events: List[dict]
-    power_history_488: List[dict]
+    phases: list[dict]
+    trigger_events: list[dict]
+    power_history_488: list[dict]
 
-    def open_phase(self, mode: str, start_s: float, cadence_s: Optional[float] = None,
-                   **extra) -> None:
+    def open_phase(
+        self, mode: str, start_s: float, cadence_s: float | None = None, **extra
+    ) -> None:
         # If the last phase has no end yet, close it at start_s.
         if self.phases:
             last = self.phases[-1]
             if "end" not in last or last["end"] is None:
                 last["end"] = start_s
-        ph: Dict[str, Any] = {"mode": mode, "start": start_s, "end": None}
+        ph: dict[str, Any] = {"mode": mode, "start": start_s, "end": None}
         if cadence_s is not None:
             ph["cadence_s"] = cadence_s
         ph.update(extra)
@@ -167,7 +171,7 @@ def build_strategy_snapshot(
     session_id: str,
     *,
     horizon_padding_s: float = 1800.0,
-) -> Dict[str, Any]:
+) -> dict[str, Any]:
     """Read the session folder and return the strategy dict the frontend wants.
 
     Parameters
@@ -272,7 +276,9 @@ def build_strategy_snapshot(
         "now_offset_s": now_offset_s,
         "horizon_s": horizon_s,
         "base_interval_s": base_interval_s,
-        "dose_budget_base_ms": float(dose_budget_base_ms) if dose_budget_base_ms is not None else None,
+        "dose_budget_base_ms": float(dose_budget_base_ms)
+        if dose_budget_base_ms is not None
+        else None,
         "per_timepoint_ms": per_timepoint_ms,
         "monitoring_modes": monitoring_modes,
         "triggers": triggers,
@@ -285,7 +291,7 @@ def build_strategy_snapshot(
 # ---------------------------------------------------------------------------
 
 
-def _build_monitoring_modes(mode_names: List[str]) -> List[dict]:
+def _build_monitoring_modes(mode_names: list[str]) -> list[dict]:
     """Resolve each active monitoring mode name into a serialized dict.
 
     The orchestrator persists only the names in ``timelapse.yaml``; we
@@ -300,16 +306,18 @@ def _build_monitoring_modes(mode_names: List[str]) -> List[dict]:
         logger.debug("Could not import MONITORING_MODES; skipping mode resolution")
         return []
 
-    out: List[dict] = []
+    out: list[dict] = []
     for name in mode_names:
         factory = MONITORING_MODES.get(name)
         if factory is None:
-            out.append({
-                "name": name,
-                "description": "",
-                "applies_to_roles": [],
-                "params": {},
-            })
+            out.append(
+                {
+                    "name": name,
+                    "description": "",
+                    "applies_to_roles": [],
+                    "params": {},
+                }
+            )
             continue
         try:
             mode = factory()
@@ -319,15 +327,16 @@ def _build_monitoring_modes(mode_names: List[str]) -> List[dict]:
         # Pull declarative knobs (fast_interval, rampdown_*) off the instance.
         excluded = {"name", "description", "applies_to_roles"}
         params = {
-            k: v for k, v in vars(mode).items()
-            if not k.startswith("_") and k not in excluded
+            k: v for k, v in vars(mode).items() if not k.startswith("_") and k not in excluded
         }
-        out.append({
-            "name": mode.name,
-            "description": mode.description,
-            "applies_to_roles": list(mode.applies_to_roles),
-            "params": params,
-        })
+        out.append(
+            {
+                "name": mode.name,
+                "description": mode.description,
+                "applies_to_roles": list(mode.applies_to_roles),
+                "params": params,
+            }
+        )
     return out
 
 
@@ -338,31 +347,35 @@ def _build_monitoring_modes(mode_names: List[str]) -> List[dict]:
 
 def _build_triggers(
     *,
-    interval_rules: List[dict],
-    power_rules: List[dict],
-    embryo_roles: Dict[str, str],
-) -> List[dict]:
-    triggers: List[dict] = []
+    interval_rules: list[dict],
+    power_rules: list[dict],
+    embryo_roles: dict[str, str],
+) -> list[dict]:
+    triggers: list[dict] = []
     for r in interval_rules:
-        triggers.append({
-            "id": r["name"],
-            "kind": "interval_rule",
-            "label": _humanize_rule_name(r["name"]),
-            "when_text": _interval_when_text(r),
-            "then_text": _interval_then_text(r),
-            "applies_to": _resolve_applies_to_roles(r.get("applies_to"), embryo_roles),
-            "one_time": bool(r.get("one_time", True)),
-        })
+        triggers.append(
+            {
+                "id": r["name"],
+                "kind": "interval_rule",
+                "label": _humanize_rule_name(r["name"]),
+                "when_text": _interval_when_text(r),
+                "then_text": _interval_then_text(r),
+                "applies_to": _resolve_applies_to_roles(r.get("applies_to"), embryo_roles),
+                "one_time": bool(r.get("one_time", True)),
+            }
+        )
     for r in power_rules:
-        triggers.append({
-            "id": r["name"],
-            "kind": "power_rule",
-            "label": _humanize_rule_name(r["name"]),
-            "when_text": _power_when_text(r),
-            "then_text": _power_then_text(r),
-            "applies_to": _resolve_applies_to_roles(r.get("applies_to"), embryo_roles),
-            "one_time": bool(r.get("one_time", False)),
-        })
+        triggers.append(
+            {
+                "id": r["name"],
+                "kind": "power_rule",
+                "label": _humanize_rule_name(r["name"]),
+                "when_text": _power_when_text(r),
+                "then_text": _power_then_text(r),
+                "applies_to": _resolve_applies_to_roles(r.get("applies_to"), embryo_roles),
+                "one_time": bool(r.get("one_time", False)),
+            }
+        )
     return triggers
 
 
@@ -406,9 +419,9 @@ def _power_then_text(r: dict) -> str:
 
 
 def _resolve_applies_to_roles(
-    applies_to: Optional[List[str]],
-    embryo_roles: Dict[str, str],
-) -> List[str]:
+    applies_to: list[str] | None,
+    embryo_roles: dict[str, str],
+) -> list[str]:
     """``applies_to`` is a list of embryo ids; resolve to a deduplicated
     list of role names for the chips. ``None`` means "all roles in the
     timelapse".
@@ -430,14 +443,14 @@ def _resolve_applies_to_roles(
 # ---------------------------------------------------------------------------
 
 
-def _read_embryo_roles(session_dir: Path) -> Dict[str, str]:
+def _read_embryo_roles(session_dir: Path) -> dict[str, str]:
     """Map embryo_id -> role by scanning ``embryos/*/embryo.yaml``.
 
     We read this from the durable per-embryo file rather than timelapse.yaml
     so the role is correct even when the embryo isn't in the active
     timelapse (yet).
     """
-    out: Dict[str, str] = {}
+    out: dict[str, str] = {}
     embryos_dir = session_dir / "embryos"
     if not embryos_dir.is_dir():
         return out
@@ -451,7 +464,7 @@ def _read_embryo_roles(session_dir: Path) -> Dict[str, str]:
     return out
 
 
-def _stop_condition_from_serialized(d: Any) -> Tuple[str, str]:
+def _stop_condition_from_serialized(d: Any) -> tuple[str, str]:
     """Read the per-embryo stop_condition dict and return ``(spec, kind)``.
 
     ``kind`` is ``"bounded"`` when ANY component of the (possibly composite)
@@ -463,10 +476,10 @@ def _stop_condition_from_serialized(d: Any) -> Tuple[str, str]:
     if not isinstance(d, dict):
         return "manual", "open_ended"
     spec = d.get("spec") or "manual"
-    types: List[str] = []
+    types: list[str] = []
     if d.get("condition_type"):
         types.append(d["condition_type"])
-    for ad in (d.get("additional") or []):
+    for ad in d.get("additional") or []:
         if ad.get("condition_type"):
             types.append(ad["condition_type"])
     auto_stop = any(t != "manual" for t in types)
@@ -476,13 +489,13 @@ def _stop_condition_from_serialized(d: Any) -> Tuple[str, str]:
 def _build_embryos_static(
     *,
     session_dir: Path,
-    tl_embryos: Dict[str, dict],
-    embryo_roles: Dict[str, str],
-    dose_budget_base_ms: Optional[float],
+    tl_embryos: dict[str, dict],
+    embryo_roles: dict[str, str],
+    dose_budget_base_ms: float | None,
     base_interval_s: float,
-    started_at: Optional[datetime] = None,
-    now_offset_s: Optional[float] = None,
-) -> List[dict]:
+    started_at: datetime | None = None,
+    now_offset_s: float | None = None,
+) -> list[dict]:
     """Build the per-embryo static portion of the snapshot.
 
     Dynamic fields (phases, trigger_events, power_history_488) are seeded
@@ -493,7 +506,7 @@ def _build_embryos_static(
     except Exception:
         ROLE_REGISTRY = {}
 
-    out: List[dict] = []
+    out: list[dict] = []
     # Sort embryo ids so the snapshot is deterministic.
     for eid in sorted(tl_embryos.keys()):
         ed = tl_embryos[eid] or {}
@@ -503,9 +516,7 @@ def _build_embryos_static(
         icon = _ROLE_ICONS.get(role_def.ui_icon if role_def else "circle", "●")
         mult = role_def.photodose_budget_multiplier if role_def else 1.0
         dose_budget_ms = (
-            float(dose_budget_base_ms) * float(mult)
-            if dose_budget_base_ms is not None
-            else 0.0
+            float(dose_budget_base_ms) * float(mult) if dose_budget_base_ms is not None else 0.0
         )
         laser_488 = ed.get("laser_power_488_pct")
         if laser_488 is None:
@@ -519,49 +530,47 @@ def _build_embryos_static(
         stop_spec, stop_kind = _stop_condition_from_serialized(ed.get("stop_condition"))
         # Seed: one base-cadence phase from t=0 until now (replay will
         # split it as cadence_changed events come in).
-        out.append({
-            "id": eid,
-            "role": role,
-            "color": color,
-            "icon": icon,
-            "dose_used_ms": float(ed.get("total_exposure_ms") or 0.0),
-            "dose_budget_ms": dose_budget_ms,
-            "tp_acquired": int(ed.get("timepoints_acquired") or 0),
-            "stop_condition": stop_spec,
-            "stop_kind": stop_kind,
-            "laser_488_pct_now": float(laser_488),
-            "phases": [
-                {
-                    "mode": "base",
-                    "start": 0.0,
-                    "end": None,
-                    "cadence_s": initial_cadence,
-                }
-            ],
-            "trigger_events": [],
-            "power_history_488": [
-                {"at": 0.0, "pct": float(laser_488)}
-            ],
-            # Filled in by _project_forward.
-            "projected_cadence_s": initial_cadence,
-            "projected_end_s": None,
-            # When the embryo was marked complete/terminated, as seconds
-            # from session start. Null while still acquiring. The
-            # frontend uses this to draw a TERMINATED cap and stop the
-            # projection bar; without it, a finished embryo's row would
-            # appear to still be acquiring forever.
-            "terminated_at_s": _terminated_at_offset(
-                ed, started_at, now_offset_s
-            ),
-        })
+        out.append(
+            {
+                "id": eid,
+                "role": role,
+                "color": color,
+                "icon": icon,
+                "dose_used_ms": float(ed.get("total_exposure_ms") or 0.0),
+                "dose_budget_ms": dose_budget_ms,
+                "tp_acquired": int(ed.get("timepoints_acquired") or 0),
+                "stop_condition": stop_spec,
+                "stop_kind": stop_kind,
+                "laser_488_pct_now": float(laser_488),
+                "phases": [
+                    {
+                        "mode": "base",
+                        "start": 0.0,
+                        "end": None,
+                        "cadence_s": initial_cadence,
+                    }
+                ],
+                "trigger_events": [],
+                "power_history_488": [{"at": 0.0, "pct": float(laser_488)}],
+                # Filled in by _project_forward.
+                "projected_cadence_s": initial_cadence,
+                "projected_end_s": None,
+                # When the embryo was marked complete/terminated, as seconds
+                # from session start. Null while still acquiring. The
+                # frontend uses this to draw a TERMINATED cap and stop the
+                # projection bar; without it, a finished embryo's row would
+                # appear to still be acquiring forever.
+                "terminated_at_s": _terminated_at_offset(ed, started_at, now_offset_s),
+            }
+        )
     return out
 
 
 def _terminated_at_offset(
     ed: dict,
-    started_at: Optional[datetime],
-    now_offset_s: Optional[float],
-) -> Optional[float]:
+    started_at: datetime | None,
+    now_offset_s: float | None,
+) -> float | None:
     """Map an embryo's ``completed_at`` ISO timestamp into seconds-from-
     session-start. Returns ``None`` if the embryo isn't complete yet or
     we don't have the data to compute the offset.
@@ -590,14 +599,14 @@ def _terminated_at_offset(
 def _resolve_timeline_paths(
     session_dir: Path,
     legacy_session_dir: Path,
-) -> List[Tuple[Path, bool]]:
+) -> list[tuple[Path, bool]]:
     """Return the timeline.jsonl paths to read, with a per-source flag.
 
     The flag indicates whether the file is the global legacy timeline
     (which mixes multiple sessions and must be filtered by session_id) or
     a per-session file (no filtering needed).
     """
-    paths: List[Tuple[Path, bool]] = []
+    paths: list[tuple[Path, bool]] = []
     # Per-session (new) location.
     p = session_dir / "timeline.jsonl"
     if p.exists():
@@ -620,8 +629,8 @@ def _replay_timeline(
     session_dir: Path,
     legacy_session_dir: Path,
     session_id: str,
-    embryo_dicts: List[dict],
-    triggers: List[dict],
+    embryo_dicts: list[dict],
+    triggers: list[dict],
     started_at: datetime,
     now_offset_s: float,
     base_interval_s: float,
@@ -649,20 +658,19 @@ def _replay_timeline(
 
     # We need to know each embryo's current cadence_s as we go (for the
     # phase records). Seed from each embryo's initial phase.
-    current_cadence: Dict[str, float] = {
-        e["id"]: e["phases"][0].get("cadence_s", base_interval_s)
-        for e in embryo_dicts
+    current_cadence: dict[str, float] = {
+        e["id"]: e["phases"][0].get("cadence_s", base_interval_s) for e in embryo_dicts
     }
     # Track last trigger_fired per (embryo, rule) so we can cluster
     # consecutive fires into one event with a count.
-    last_trigger: Dict[Tuple[str, str], dict] = {}
+    last_trigger: dict[tuple[str, str], dict] = {}
 
     # Collect events from all sources, filtering global file by session_id.
-    events: List[Tuple[datetime, dict]] = []
+    events: list[tuple[datetime, dict]] = []
     seen_ids: set = set()
     for path, is_global in paths:
         try:
-            with open(path, "r", encoding="utf-8") as f:
+            with open(path, encoding="utf-8") as f:
                 for line in f:
                     line = line.strip()
                     if not line or not line.startswith("{"):
@@ -711,12 +719,14 @@ def _replay_timeline(
                     pass
             mode = _phase_mode_from_name(new_phase_name)
             _close_open_phase(emb, at_s)
-            emb["phases"].append({
-                "mode": mode,
-                "start": at_s,
-                "end": None,
-                "cadence_s": current_cadence.get(embryo_id, base_interval_s),
-            })
+            emb["phases"].append(
+                {
+                    "mode": mode,
+                    "start": at_s,
+                    "end": None,
+                    "cadence_s": current_cadence.get(embryo_id, base_interval_s),
+                }
+            )
 
         elif subtype == "power_changed" and embryo_id in by_id:
             wavelength = data.get("wavelength")
@@ -726,10 +736,12 @@ def _replay_timeline(
             if new_pct is None:
                 continue
             emb = by_id[embryo_id]
-            emb["power_history_488"].append({
-                "at": at_s,
-                "pct": float(new_pct),
-            })
+            emb["power_history_488"].append(
+                {
+                    "at": at_s,
+                    "pct": float(new_pct),
+                }
+            )
             emb["laser_488_pct_now"] = float(new_pct)
 
         elif subtype == "trigger_fired" and embryo_id in by_id:
@@ -739,10 +751,7 @@ def _replay_timeline(
             emb = by_id[embryo_id]
             key = (embryo_id, rule_name)
             prev = last_trigger.get(key)
-            if (
-                prev is not None
-                and at_s - prev["at"] <= _TRIGGER_CLUSTER_GAP_S
-            ):
+            if prev is not None and at_s - prev["at"] <= _TRIGGER_CLUSTER_GAP_S:
                 prev["count"] = prev.get("count", 1) + 1
                 prev["at"] = at_s  # extend cluster to last fire
             else:
@@ -755,13 +764,15 @@ def _replay_timeline(
             mode = data.get("mode") or "1hz"
             hz = 1.0 if mode == "1hz" else 20.0
             _close_open_phase(emb, at_s)
-            emb["phases"].append({
-                "mode": "burst",
-                "start": at_s,
-                "end": None,
-                "frames": int(data.get("frames") or 0),
-                "hz": hz,
-            })
+            emb["phases"].append(
+                {
+                    "mode": "burst",
+                    "start": at_s,
+                    "end": None,
+                    "frames": int(data.get("frames") or 0),
+                    "hz": hz,
+                }
+            )
 
         elif subtype == "burst_completed" and embryo_id in by_id:
             emb = by_id[embryo_id]
@@ -795,7 +806,12 @@ def _ensure_tail_power(emb: dict, now_offset_s: float) -> None:
     extends the steady segment to the right edge."""
     hist = emb.get("power_history_488") or []
     if not hist:
-        emb["power_history_488"] = [{"at": now_offset_s, "pct": emb.get("laser_488_pct_now", _DEFAULT_INITIAL_POWER_PCT)}]
+        emb["power_history_488"] = [
+            {
+                "at": now_offset_s,
+                "pct": emb.get("laser_488_pct_now", _DEFAULT_INITIAL_POWER_PCT),
+            }
+        ]
         return
     if hist[-1]["at"] < now_offset_s:
         hist.append({"at": now_offset_s, "pct": hist[-1]["pct"]})
@@ -820,7 +836,7 @@ def _phase_mode_from_name(name: str) -> str:
 
 def _project_forward(
     *,
-    embryo_dicts: List[dict],
+    embryo_dicts: list[dict],
     now_offset_s: float,
     per_timepoint_ms: float,
 ) -> None:
@@ -851,7 +867,7 @@ def _project_forward(
 
 def _compute_horizon(
     now_offset_s: float,
-    embryo_dicts: List[dict],
+    embryo_dicts: list[dict],
     padding_s: float,
 ) -> float:
     """Pick a horizon that comfortably contains the past + projected future."""
diff --git a/gently/ui/web/timelapse_tracker.py b/gently/ui/web/timelapse_tracker.py
index 665ef1b7..f980001d 100644
--- a/gently/ui/web/timelapse_tracker.py
+++ b/gently/ui/web/timelapse_tracker.py
@@ -6,7 +6,6 @@
 """
 
 from datetime import datetime
-from typing import Dict, List, Optional
 
 
 class TimelapseStateTracker:
@@ -21,15 +20,17 @@ class TimelapseStateTracker:
     """
 
     def __init__(self):
-        self.session_id: Optional[str] = None  # Unique ID per experiment
+        self.session_id: str | None = None  # Unique ID per experiment
         self.status = "IDLE"  # IDLE, RUNNING, PAUSED, COMPLETED
-        self.started_at: Optional[str] = None
-        self.embryos: Dict[str, dict] = {}  # embryo_id -> state
+        self.started_at: str | None = None
+        self.embryos: dict[str, dict] = {}  # embryo_id -> state
         self.total_timepoints = 0
         self.base_interval = 120
-        self.detection_reasoning: Dict[str, List[dict]] = {}  # embryo_id -> list of detections
-        self.projection_uids: Dict[str, Dict[int, str]] = {}  # embryo_id -> {timepoint -> projection_uid}
-        self.volume_paths: Dict[str, Dict[int, str]] = {}  # embryo_id -> {timepoint -> volume_path}
+        self.detection_reasoning: dict[str, list[dict]] = {}  # embryo_id -> list of detections
+        self.projection_uids: dict[
+            str, dict[int, str]
+        ] = {}  # embryo_id -> {timepoint -> projection_uid}
+        self.volume_paths: dict[str, dict[int, str]] = {}  # embryo_id -> {timepoint -> volume_path}
 
     def handle_event(self, event_type: str, data: dict):
         """Update state based on incoming event"""
@@ -136,9 +137,7 @@ def handle_event(self, event_type: str, data: dict):
             if eid and eid in self.embryos:
                 self.embryos[eid]["is_complete"] = True
                 self.embryos[eid]["completion_reason"] = data.get("completion_reason")
-                self.embryos[eid].setdefault(
-                    "completed_at", datetime.now().isoformat()
-                )
+                self.embryos[eid].setdefault("completed_at", datetime.now().isoformat())
 
         elif event_type == "DETECTOR_EVALUATED":
             # All detector/perception evaluations (with reasoning) - populates reasoning panel
@@ -160,7 +159,8 @@ def handle_event(self, event_type: str, data: dict):
                     "description": data.get("description"),
                     "timepoint": timepoint,
                     "volume_uid": data.get("volume_uid"),
-                    "projection_uid": data.get("projection_uid") or projection_uid,  # Use stored UID as fallback
+                    "projection_uid": data.get("projection_uid")
+                    or projection_uid,  # Use stored UID as fallback
                     "timestamp": datetime.now().isoformat(),
                     # Perception-specific fields
                     "stage": data.get("stage"),
@@ -198,15 +198,18 @@ def handle_event(self, event_type: str, data: dict):
             # before any acquisition has happened.
             eid = data.get("embryo_id")
             if eid:
-                emb = self.embryos.setdefault(eid, {
-                    "embryo_id": eid,
-                    "timepoints": 0,
-                    "is_complete": False,
-                    "first_acquired": None,
-                    "last_acquired": None,
-                    "detections": {},
-                    "current_stage": None,
-                })
+                emb = self.embryos.setdefault(
+                    eid,
+                    {
+                        "embryo_id": eid,
+                        "timepoints": 0,
+                        "is_complete": False,
+                        "first_acquired": None,
+                        "last_acquired": None,
+                        "detections": {},
+                        "current_stage": None,
+                    },
+                )
                 if data.get("x") is not None:
                     emb["stage_x_um"] = data["x"]
                 if data.get("y") is not None:
@@ -227,13 +230,11 @@ def handle_event(self, event_type: str, data: dict):
                 detector_name = data.get("detector_name", "unknown")
                 self.embryos[eid]["detections"][detector_name] = {
                     "detected": True,
-                    "confidence": data.get("confidence")
+                    "confidence": data.get("confidence"),
                 }
                 if detector_name == "hatching":
                     self.embryos[eid]["is_complete"] = True
-                    self.embryos[eid].setdefault(
-                        "completed_at", datetime.now().isoformat()
-                    )
+                    self.embryos[eid].setdefault("completed_at", datetime.now().isoformat())
 
         elif event_type == "VERIFICATION_STARTED":
             # Verification round started for embryo
@@ -262,8 +263,12 @@ def handle_event(self, event_type: str, data: dict):
             # Progress update
             eid = data.get("embryo_id")
             if eid and eid in self.embryos and "verification" in self.embryos[eid]:
-                self.embryos[eid]["verification"]["strategies_complete"] = data.get("strategies_complete", 0)
-                self.embryos[eid]["verification"]["total_strategies"] = data.get("total_strategies", 5)
+                self.embryos[eid]["verification"]["strategies_complete"] = data.get(
+                    "strategies_complete", 0
+                )
+                self.embryos[eid]["verification"]["total_strategies"] = data.get(
+                    "total_strategies", 5
+                )
 
         elif event_type == "VERIFICATION_COMPLETED":
             # Final verification result
@@ -304,10 +309,16 @@ def handle_event(self, event_type: str, data: dict):
             if data.get("change") == "role_assigned":
                 eid = data.get("embryo_id")
                 if eid:
-                    emb = self.embryos.setdefault(eid, {
-                        "embryo_id": eid, "timepoints": 0, "is_complete": False,
-                        "detections": {}, "current_stage": None,
-                    })
+                    emb = self.embryos.setdefault(
+                        eid,
+                        {
+                            "embryo_id": eid,
+                            "timepoints": 0,
+                            "is_complete": False,
+                            "detections": {},
+                            "current_stage": None,
+                        },
+                    )
                     if data.get("new_role"):
                         emb["role"] = data["new_role"]
 
@@ -316,10 +327,16 @@ def handle_event(self, event_type: str, data: dict):
         elif event_type == "EMBRYO_CADENCE_CHANGED":
             eid = data.get("embryo_id")
             if eid:
-                emb = self.embryos.setdefault(eid, {
-                    "embryo_id": eid, "timepoints": 0, "is_complete": False,
-                    "detections": {}, "current_stage": None,
-                })
+                emb = self.embryos.setdefault(
+                    eid,
+                    {
+                        "embryo_id": eid,
+                        "timepoints": 0,
+                        "is_complete": False,
+                        "detections": {},
+                        "current_stage": None,
+                    },
+                )
                 if data.get("new_phase") is not None:
                     emb["cadence_phase"] = data["new_phase"]
                 if data.get("new_interval_s") is not None:
@@ -331,22 +348,30 @@ def handle_event(self, event_type: str, data: dict):
         elif event_type == "POWER_RAMP_STEP":
             eid = data.get("embryo_id")
             if eid:
-                emb = self.embryos.setdefault(eid, {
-                    "embryo_id": eid, "timepoints": 0, "is_complete": False,
-                    "detections": {}, "current_stage": None,
-                })
+                emb = self.embryos.setdefault(
+                    eid,
+                    {
+                        "embryo_id": eid,
+                        "timepoints": 0,
+                        "is_complete": False,
+                        "detections": {},
+                        "current_stage": None,
+                    },
+                )
                 wavelength = data.get("wavelength", 488)
                 if wavelength == 488:
                     emb["laser_power_488_pct"] = data.get("new_pct")
-                emb.setdefault("power_history", []).append({
-                    "wavelength": wavelength,
-                    "old_pct": data.get("old_pct"),
-                    "new_pct": data.get("new_pct"),
-                    "direction": data.get("direction"),
-                    "rule": data.get("rule"),
-                    "intensity_level": data.get("intensity_level"),
-                    "timestamp": datetime.now().isoformat(),
-                })
+                emb.setdefault("power_history", []).append(
+                    {
+                        "wavelength": wavelength,
+                        "old_pct": data.get("old_pct"),
+                        "new_pct": data.get("new_pct"),
+                        "direction": data.get("direction"),
+                        "rule": data.get("rule"),
+                        "intensity_level": data.get("intensity_level"),
+                        "timestamp": datetime.now().isoformat(),
+                    }
+                )
                 # cap history per embryo
                 if len(emb["power_history"]) > 200:
                     emb["power_history"] = emb["power_history"][-200:]
@@ -354,10 +379,16 @@ def handle_event(self, event_type: str, data: dict):
         elif event_type == "CLAUDE_DETECTOR_RESULT":
             eid = data.get("embryo_id")
             if eid:
-                emb = self.embryos.setdefault(eid, {
-                    "embryo_id": eid, "timepoints": 0, "is_complete": False,
-                    "detections": {}, "current_stage": None,
-                })
+                emb = self.embryos.setdefault(
+                    eid,
+                    {
+                        "embryo_id": eid,
+                        "timepoints": 0,
+                        "is_complete": False,
+                        "detections": {},
+                        "current_stage": None,
+                    },
+                )
                 findings = data.get("findings") or {}
                 emb["last_intensity_level"] = findings.get("intensity_level")
                 emb["last_structure_quality"] = findings.get("structure_quality")
@@ -365,13 +396,24 @@ def handle_event(self, event_type: str, data: dict):
                 if findings.get("has_hatched"):
                     emb["hatched"] = True
 
-        elif event_type in ("BURST_QUEUED", "BURST_START", "BURST_FRAME", "BURST_COMPLETE"):
+        elif event_type in (
+            "BURST_QUEUED",
+            "BURST_START",
+            "BURST_FRAME",
+            "BURST_COMPLETE",
+        ):
             eid = data.get("embryo_id")
             if eid:
-                emb = self.embryos.setdefault(eid, {
-                    "embryo_id": eid, "timepoints": 0, "is_complete": False,
-                    "detections": {}, "current_stage": None,
-                })
+                emb = self.embryos.setdefault(
+                    eid,
+                    {
+                        "embryo_id": eid,
+                        "timepoints": 0,
+                        "is_complete": False,
+                        "detections": {},
+                        "current_stage": None,
+                    },
+                )
                 emb.setdefault("burst", {})
                 burst_state = emb["burst"]
                 if event_type == "BURST_QUEUED":
@@ -409,7 +451,7 @@ def to_dict(self) -> dict:
             "embryos": self.embryos,
             "total_timepoints": self.total_timepoints,
             "base_interval": self.base_interval,
-            "detection_reasoning": self.detection_reasoning
+            "detection_reasoning": self.detection_reasoning,
         }
 
     def reset(self):
@@ -436,14 +478,17 @@ def seed_from_experiment(self, experiment) -> int:
             y = pos.get("y") if isinstance(pos, dict) else None
             if x is None or y is None:
                 continue
-            self.handle_event("EMBRYO_DETECTED", {
-                "embryo_id": eid,
-                "uid": getattr(emb, "uid", None),
-                "x": x,
-                "y": y,
-                "role": getattr(emb, "role", "test"),
-                "user_label": getattr(emb, "user_label", None),
-                "confidence": getattr(emb, "detection_confidence", None),
-            })
+            self.handle_event(
+                "EMBRYO_DETECTED",
+                {
+                    "embryo_id": eid,
+                    "uid": getattr(emb, "uid", None),
+                    "x": x,
+                    "y": y,
+                    "role": getattr(emb, "role", "test"),
+                    "user_label": getattr(emb, "user_label", None),
+                    "confidence": getattr(emb, "detection_confidence", None),
+                },
+            )
             seeded += 1
         return seeded
diff --git a/gently/ui/web/volume_helpers.py b/gently/ui/web/volume_helpers.py
index e92954ae..2ff479d9 100644
--- a/gently/ui/web/volume_helpers.py
+++ b/gently/ui/web/volume_helpers.py
@@ -10,11 +10,10 @@
 import re
 from io import BytesIO
 from pathlib import Path
-from typing import Optional
 
 import numpy as np
 
-from gently.core.imaging import normalize_to_uint8, image_to_base64
+from gently.core.imaging import image_to_base64, normalize_to_uint8
 
 logger = logging.getLogger(__name__)
 
@@ -22,7 +21,7 @@
 VOLUME_UID_PATTERN = re.compile(r"volume_(.+)_t(\d+)$")
 
 
-def parse_volume_uid(uid: str) -> Optional[tuple]:
+def parse_volume_uid(uid: str) -> tuple | None:
     """Parse a volume UID into (embryo_id, timepoint) or return None."""
     if not uid.startswith("volume_"):
         return None
@@ -42,9 +41,9 @@ def load_volume_from_disk(volume_path: str) -> np.ndarray:
         Cropped 3D numpy array (Z, H, W)
     """
     from gently.core.imaging import (
-        load_volume,
-        compute_crop_bounds,
         apply_crop_bounds,
+        compute_crop_bounds,
+        load_volume,
     )
 
     path = Path(volume_path)
@@ -67,7 +66,7 @@ def array_to_png_bytes(img_array: np.ndarray) -> bytes:
     img_array = normalize_to_uint8(img_array, method="simple")
     img = Image.fromarray(img_array)
     buf = BytesIO()
-    img.save(buf, format='PNG')
+    img.save(buf, format="PNG")
     return buf.getvalue()
 
 
diff --git a/launch_gently.py b/launch_gently.py
index 57dee885..0663c500 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -21,16 +21,15 @@
     python launch_gently.py --debug              # Debug logging
 """
 
+import argparse
 import asyncio
-import json
 import logging
 import os
-import sys
 import shutil
 import subprocess
-import argparse
-from pathlib import Path
+import sys
 from datetime import datetime
+from pathlib import Path
 
 import yaml
 
@@ -50,13 +49,13 @@
 if not any(flag in sys.argv for flag in ("-h", "--help")):
     print("Starting gently — loading modules (this can take a few seconds)...", flush=True)
 
-from gently.log_config import configure_logging
-from gently.core.log_bridge import configure_log_bridge
 from gently.app.agent import MicroscopyAgent
+from gently.core.file_store import FileStore
+from gently.core.log_bridge import configure_log_bridge
+from gently.hardware import get_hardware, load_hardware
+from gently.log_config import configure_logging
 from gently.organisms import load_organism
-from gently.hardware import load_hardware, get_hardware
 from gently.settings import settings
-from gently.core.file_store import FileStore
 
 logger = logging.getLogger(__name__)
 
@@ -88,11 +87,13 @@ def _build_session_items(store: FileStore) -> list:
         session_id = session.get("session_id", "unknown")
         embryos = store.list_embryos(session_id)
         embryo_count = len(embryos) if embryos else 0
-        items.append({
-            "session_id": session_id,
-            "embryo_count": embryo_count,
-            "time": _format_elapsed(session.get("last_active", "")),
-        })
+        items.append(
+            {
+                "session_id": session_id,
+                "embryo_count": embryo_count,
+                "time": _format_elapsed(session.get("last_active", "")),
+            }
+        )
     return items
 
 
@@ -136,7 +137,7 @@ def _print_banner(viz_url, device_connected, offline, storage_dir, log_file, res
     print(f"    Device:  {dev}")
     print(f"    Storage: {storage_dir}")
     print(f"    Logs:    {log_file}")
-    print(f"    Stop:    Ctrl-C")
+    print("    Stop:    Ctrl-C")
     print(f"    {line}")
     print()
 
@@ -153,7 +154,11 @@ def _open_browser(url: str) -> None:
     override = os.environ.get("GENTLY_BROWSER", "").strip()
 
     # 1) Registered browser names (override first, then Chrome aliases).
-    for name in ([override] if override else []) + ["chrome", "google-chrome", "chromium"]:
+    for name in ([override] if override else []) + [
+        "chrome",
+        "google-chrome",
+        "chromium",
+    ]:
         try:
             webbrowser.get(name).open(url)
             return
@@ -171,8 +176,10 @@ def _open_browser(url: str) -> None:
         try:
             if exe and Path(exe).exists():
                 webbrowser.register(
-                    "gently-browser", None,
-                    webbrowser.BackgroundBrowser(exe), preferred=True,
+                    "gently-browser",
+                    None,
+                    webbrowser.BackgroundBrowser(exe),
+                    preferred=True,
                 )
                 webbrowser.get("gently-browser").open(url)
                 return
@@ -210,13 +217,21 @@ def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
     # Parse the SESSION:<id> protocol line from stdout
     for line in (proc.stdout or "").splitlines():
         if line.startswith("SESSION:"):
-            selected = line[len("SESSION:"):].strip()
+            selected = line[len("SESSION:") :].strip()
             return selected if selected else None
 
     return None
 
 
-async def main(offline: bool = False, resume_session: str = None, show_sessions: bool = False, pick_session: bool = False, log_level: str = "WARNING", no_browser: bool = False, no_api: bool = False):
+async def main(
+    offline: bool = False,
+    resume_session: str = None,
+    show_sessions: bool = False,
+    pick_session: bool = False,
+    log_level: str = "WARNING",
+    no_browser: bool = False,
+    no_api: bool = False,
+):
     # Set up log file in storage directory
     # Unified with FileStore: logs live under the same root as data
     # (settings.storage.base_path reads GENTLY_STORAGE_PATH). Previously this
@@ -250,6 +265,7 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
 
     # Create unified store (FileStore) early for session queries
     from gently.core.gently_manifest import write_manifest
+
     write_manifest(storage_dir)
     store = FileStore(storage_dir)
 
@@ -261,6 +277,7 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     if os.environ.get("GENTLY_NO_AUTH", "").strip().lower() not in ("1", "true", "yes"):
         try:
             from gently.ui.web.accounts import AccountStore, set_account_store
+
             account_store = AccountStore(storage_dir / "auth")
             set_account_store(account_store)
             admin_creds = account_store.bootstrap_admin_if_empty()
@@ -285,8 +302,10 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
         if sessions:
             session_to_resume = sessions[0].get("session_id")
             if pick_session:
-                print(f"Resuming most recent session: {session_to_resume} "
-                      "(interactive session picking is moving into the browser)")
+                print(
+                    f"Resuming most recent session: {session_to_resume} "
+                    "(interactive session picking is moving into the browser)"
+                )
         else:
             print("No sessions found - starting fresh")
     elif resume_session:
@@ -305,11 +324,12 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     if not offline:
         hw = get_hardware()
         http_url = f"http://{settings.network.device_host}:{settings.network.device_port}"
-        if hasattr(hw, 'create_client'):
+        if hasattr(hw, "create_client"):
             client = hw.create_client(http_url=http_url)
         else:
             # Fallback for hardware modules without create_client
             from gently.app.queue_server_client import QueueServerClient
+
             client = QueueServerClient(http_url=http_url)
         connected = await client.connect()
         if not connected:
@@ -320,14 +340,15 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
             # makes Claude hallucinate XML tool calls as plain text.
             logger.debug(
                 "Device layer not reachable at %s — microscope tools "
-                "available but will return errors until connected", http_url,
+                "available but will return errors until connected",
+                http_url,
             )
 
     # Configure device session for zero-copy volume transfer
     if client and client.is_connected:
         try:
             incoming = str(store.incoming_dir)
-            resp = await client.configure_device_session(incoming)
+            await client.configure_device_session(incoming)
             logger.info("Device session configured: volume_dir=%s", incoming)
         except Exception as e:
             logger.error("Failed to configure device session (volumes will be slow): %s", e)
@@ -336,6 +357,7 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     if client and client.is_connected:
         try:
             from gently.harness.microscope import register_microscope_tools
+
             n = register_microscope_tools(client)
             if n:
                 logger.info("Registered %d microscope tools from device layer", n)
@@ -355,6 +377,7 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     cert_path, key_path = None, None
     try:
         from gently.mesh.tls import ensure_tls_cert, get_cert_fingerprint
+
         _config_dir = Path(__file__).parent / "config"
         cert_path, key_path = ensure_tls_cert(_config_dir)
     except Exception:
@@ -364,15 +387,20 @@ async def main(offline: bool = False, resume_session: str = None, show_sessions:
     # self-signed certs trigger browser "unsafe" warnings for visitors).
     await agent.start_viz_server(port=settings.network.viz_port)
     scheme = "http"
-    viz_url = f"{scheme}://localhost:{settings.network.viz_port}" if agent.viz_server is not None else None
+    viz_url = (
+        f"{scheme}://localhost:{settings.network.viz_port}"
+        if agent.viz_server is not None
+        else None
+    )
 
     # ── Mesh discovery ──────────────────────────────────────────────
     mesh = None
     try:
+        import uuid as _uuid
+
         from gently.mesh import MeshService, register_mesh_routes
         from gently.mesh.audit import MeshAuditLog
         from gently.mesh.pairing import PairingManager
-        import uuid as _uuid
 
         # Persistent instance ID
         instance_id_path = Path(__file__).parent / "config" / "mesh_instance_id"
@@ -398,6 +426,7 @@ def _capability_provider():
             # GPU detection — try torch first, fall back to nvidia-smi
             try:
                 import torch
+
                 if torch.cuda.is_available():
                     caps["has_gpu"] = True
                     caps["gpu_name"] = torch.cuda.get_device_name(0)
@@ -407,10 +436,15 @@ def _capability_provider():
             except ImportError:
                 try:
                     import subprocess as _sp
+
                     out = _sp.check_output(
-                        ["nvidia-smi", "--query-gpu=name,memory.total",
-                         "--format=csv,noheader,nounits"],
-                        timeout=5, text=True,
+                        [
+                            "nvidia-smi",
+                            "--query-gpu=name,memory.total",
+                            "--format=csv,noheader,nounits",
+                        ],
+                        timeout=5,
+                        text=True,
                     ).strip()
                     if out:
                         parts = out.split(",", 1)
@@ -430,6 +464,7 @@ def _capability_provider():
 
         def _status_provider():
             import gently as _gently
+
             return {
                 "session_id": agent.session_id or "",
                 "acquisition_status": "idle",
@@ -442,6 +477,7 @@ def _status_provider():
             }
 
         import socket as _socket
+
         config_dir = Path(__file__).parent / "config"
         audit_log = MeshAuditLog(config_dir)
         pairing_mgr = PairingManager(
@@ -474,27 +510,32 @@ def _status_provider():
         await mesh.start()
     except Exception as e:
         import logging as _log
+
         _log.getLogger(__name__).warning(f"Mesh discovery failed to start: {e}")
         mesh = None
     # ── End mesh ────────────────────────────────────────────────────
 
     # Attach the agent bridge to the viz server
     from gently.harness.bridge import AgentBridge
+
     bridge = AgentBridge(agent)
 
-    bridge.set_launch_info({
-        "device_connected": client.is_connected if client else False,
-        "sam_available": client.has_sam if client else False,
-        "offline": offline or (client is None) or not client.is_connected,
-        "store_path": str(storage_dir),
-        "viz_url": viz_url,
-        "log_path": str(log_file),
-        "resumed": session_to_resume is not None,
-        "mesh_service": mesh,
-    })
+    bridge.set_launch_info(
+        {
+            "device_connected": client.is_connected if client else False,
+            "sam_available": client.has_sam if client else False,
+            "offline": offline or (client is None) or not client.is_connected,
+            "store_path": str(storage_dir),
+            "viz_url": viz_url,
+            "log_path": str(log_file),
+            "resumed": session_to_resume is not None,
+            "mesh_service": mesh,
+        }
+    )
 
     # Initialize startup wizard (gap-driven onboarding)
     from gently.harness.memory.file_store import FileContextStore
+
     agent_dir = storage_dir / "agent"
     context_store = FileContextStore(agent_dir)
     agent.set_context_store(context_store)
@@ -540,6 +581,7 @@ def _status_provider():
     # bare Event().wait(), so install signal handlers and poll on a short
     # interval (which also lets a pending KeyboardInterrupt surface).
     import signal as _signal
+
     _loop = asyncio.get_running_loop()
     _stop = asyncio.Event()
     try:
@@ -550,6 +592,7 @@ def _status_provider():
         # signal.signal, waking the loop via call_soon_threadsafe.
         def _sig(*_a):
             _loop.call_soon_threadsafe(_stop.set)
+
         try:
             _signal.signal(_signal.SIGINT, _sig)
             _signal.signal(_signal.SIGTERM, _sig)
@@ -565,6 +608,7 @@ def _sig(*_a):
         # Suppress noisy CancelledError / overlapped IO errors from
         # uvicorn during shutdown on Windows.
         import logging as _logging
+
         _logging.getLogger("uvicorn.error").setLevel(_logging.CRITICAL)
         _logging.getLogger("uvicorn").setLevel(_logging.CRITICAL)
         # Cleanup: stop mesh service
@@ -585,15 +629,29 @@ def cli_main():
     """Sync entry point for ``gently`` console script (pyproject.toml)."""
     parser = argparse.ArgumentParser(description="Launch Microscopy Agent")
     parser.add_argument("--offline", action="store_true", help="Run without server connections")
-    parser.add_argument("--no-api", action="store_true",
-                        help="UI-only mode: boot the web UI without any Anthropic API key. "
-                             "Chat, perception, and plan generation are disabled.")
+    parser.add_argument(
+        "--no-api",
+        action="store_true",
+        help="UI-only mode: boot the web UI without any Anthropic API key. "
+        "Chat, perception, and plan generation are disabled.",
+    )
     parser.add_argument("--sessions", action="store_true", help="List available sessions and exit")
-    parser.add_argument("--resume", nargs="?", const="__PICK__", metavar="ID",
-                        help="Resume a session. Without ID: shows picker. With ID: resumes that session.")
-    parser.add_argument("-v", "--verbose", action="store_true", help="Enable verbose (INFO) logging")
+    parser.add_argument(
+        "--resume",
+        nargs="?",
+        const="__PICK__",
+        metavar="ID",
+        help="Resume a session. Without ID: shows picker. With ID: resumes that session.",
+    )
+    parser.add_argument(
+        "-v", "--verbose", action="store_true", help="Enable verbose (INFO) logging"
+    )
     parser.add_argument("--debug", action="store_true", help="Enable debug logging (most verbose)")
-    parser.add_argument("--no-browser", action="store_true", help="Do not auto-open the web UI in a browser")
+    parser.add_argument(
+        "--no-browser",
+        action="store_true",
+        help="Do not auto-open the web UI in a browser",
+    )
     args = parser.parse_args()
 
     # An API key is required unless running in UI-only mode.
@@ -613,19 +671,21 @@ def cli_main():
     if args.debug:
         log_level = "DEBUG"
 
-    pick_session = (args.resume == "__PICK__")
+    pick_session = args.resume == "__PICK__"
     resume_id = args.resume if args.resume and args.resume != "__PICK__" else None
 
     try:
-        asyncio.run(main(
-            offline=args.offline,
-            show_sessions=args.sessions,
-            resume_session=resume_id,
-            pick_session=pick_session,
-            log_level=log_level,
-            no_browser=args.no_browser,
-            no_api=args.no_api,
-        ))
+        asyncio.run(
+            main(
+                offline=args.offline,
+                show_sessions=args.sessions,
+                resume_session=resume_id,
+                pick_session=pick_session,
+                log_level=log_level,
+                no_browser=args.no_browser,
+                no_api=args.no_api,
+            )
+        )
     except (KeyboardInterrupt, RuntimeError, SystemExit):
         pass
 
diff --git a/pyproject.toml b/pyproject.toml
index 82f2ac3e..003ae9e3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -92,6 +92,8 @@ device = [
 dev = [
     "pytest>=7.0.0",
     "pytest-asyncio>=0.21.0",
+    "ruff>=0.4.0",
+    "pre-commit>=3.7.0",
 ]
 
 [project.scripts]
@@ -136,3 +138,10 @@ exclude = ["tests*", "benchmarks*", "scripts*", "examples*"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
diff --git a/scripts/auto_label_examples.py b/scripts/auto_label_examples.py
index 3ef2b87a..b12f6626 100644
--- a/scripts/auto_label_examples.py
+++ b/scripts/auto_label_examples.py
@@ -16,11 +16,8 @@
 import base64
 import io
 import json
-import os
-import random
 import sys
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple
 
 import anthropic
 import numpy as np
@@ -34,7 +31,8 @@
 STAGES = ["early", "comma", "pretzel", "3fold", "hatching", "hatched"]
 
 # Staging prompt for Claude
-STAGE_PROMPT = """You are classifying C. elegans embryo developmental stages from diSPIM microscopy max projections.
+STAGE_PROMPT = """You are classifying C. elegans embryo developmental stages from diSPIM
+microscopy max projections.
 
 The stages in order are:
 1. EARLY - Round/oval shape, no visible folding, may see cell divisions
@@ -77,7 +75,7 @@ def sample_timelapse(
     timelapse_dir: Path,
     embryo_num: int = 1,
     num_samples: int = 40,
-) -> List[Tuple[int, Path]]:
+) -> list[tuple[int, Path]]:
     """
     Sample images spread across timelapse to cover all stages.
 
@@ -100,8 +98,8 @@ def sample_timelapse(
     def get_timepoint(f: Path) -> int:
         # Pattern: embryo_001_embryo001_t0042_...
         name = f.stem
-        for part in name.split('_'):
-            if part.startswith('t') and part[1:].isdigit():
+        for part in name.split("_"):
+            if part.startswith("t") and part[1:].isdigit():
                 return int(part[1:])
         return 0
 
@@ -122,26 +120,28 @@ async def classify_image(
     client: anthropic.Anthropic,
     image_b64: str,
     timepoint: int,
-) -> Dict:
+) -> dict:
     """Use Claude to classify a single image."""
     response = await asyncio.to_thread(
         client.messages.create,
         model="claude-haiku-4-5-20251001",  # Fast and cheap for bulk labeling
         max_tokens=200,
-        messages=[{
-            "role": "user",
-            "content": [
-                {"type": "text", "text": STAGE_PROMPT},
-                {
-                    "type": "image",
-                    "source": {
-                        "type": "base64",
-                        "media_type": "image/jpeg",
-                        "data": image_b64,
-                    }
-                }
-            ]
-        }]
+        messages=[
+            {
+                "role": "user",
+                "content": [
+                    {"type": "text", "text": STAGE_PROMPT},
+                    {
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": "image/jpeg",
+                            "data": image_b64,
+                        },
+                    },
+                ],
+            }
+        ],
     )
 
     # Parse response
@@ -149,23 +149,29 @@ async def classify_image(
     try:
         # Find JSON in response
         import re
-        json_match = re.search(r'\{[^{}]+\}', text)
+
+        json_match = re.search(r"\{[^{}]+\}", text)
         if json_match:
             result = json.loads(json_match.group())
             result["timepoint"] = timepoint
             return result
-    except:
+    except Exception:
         pass
 
-    return {"stage": "unknown", "confidence": 0.0, "notes": text[:100], "timepoint": timepoint}
+    return {
+        "stage": "unknown",
+        "confidence": 0.0,
+        "notes": text[:100],
+        "timepoint": timepoint,
+    }
 
 
 async def auto_label_batch(
     timelapse_dir: Path,
     embryo_num: int,
     num_samples: int = 40,
-    output_file: Optional[Path] = None,
-) -> Dict[str, List[Dict]]:
+    output_file: Path | None = None,
+) -> dict[str, list[dict]]:
     """
     Auto-label a batch of images from a timelapse.
 
@@ -178,7 +184,7 @@ async def auto_label_batch(
     samples = sample_timelapse(timelapse_dir, embryo_num, num_samples)
 
     # Process images
-    results_by_stage: Dict[str, List[Dict]] = {stage: [] for stage in STAGES}
+    results_by_stage: dict[str, list[dict]] = {stage: [] for stage in STAGES}
     results_by_stage["unknown"] = []
 
     print(f"Classifying {len(samples)} images with Claude...")
@@ -216,15 +222,15 @@ async def auto_label_batch(
         if count > 0:
             avg_conf = sum(r["confidence"] for r in results_by_stage[stage]) / count
             timepoints = [r["timepoint"] for r in results_by_stage[stage]]
-            print(f"  {stage:10s}: {count:3d} images (avg confidence: {avg_conf:.0%}, T={min(timepoints)}-{max(timepoints)})")
+            print(
+                f"  {stage:10s}: {count:3d} images (avg confidence: {avg_conf:.0%},"
+                f" T={min(timepoints)}-{max(timepoints)})"
+            )
 
     # Save results for review
     output_file = output_file or Path("labeled_results.json")
     save_data = {
-        stage: [
-            {k: v for k, v in r.items() if k != "image_b64"}
-            for r in results
-        ]
+        stage: [{k: v for k, v in r.items() if k != "image_b64"} for r in results]
         for stage, results in results_by_stage.items()
     }
     save_data["_metadata"] = {
@@ -241,7 +247,7 @@ async def auto_label_batch(
 
 
 def populate_examples(
-    results_by_stage: Dict[str, List[Dict]],
+    results_by_stage: dict[str, list[dict]],
     examples_dir: Path,
     max_per_stage: int = 3,
     min_confidence: float = 0.7,
@@ -284,11 +290,14 @@ def populate_examples(
 
                 # Save as JPEG
                 img_bytes = base64.b64decode(b64)
-                out_path = stage_dir / f"example_{i+1:03d}.jpg"
+                out_path = stage_dir / f"example_{i + 1:03d}.jpg"
                 with open(out_path, "wb") as f:
                     f.write(img_bytes)
 
-                print(f"  {stage}: Saved {out_path.name} (T={result['timepoint']}, conf={result['confidence']:.0%})")
+                print(
+                    f"  {stage}: Saved {out_path.name}"
+                    f" (T={result['timepoint']}, conf={result['confidence']:.0%})"
+                )
 
     print("\nDone! Examples populated.")
 
@@ -324,9 +333,9 @@ async def interactive_review(results_file: Path, examples_dir: Path):
     while True:
         choice = input("\nChoice: ").strip().lower()
 
-        if choice == 'q':
+        if choice == "q":
             break
-        elif choice == 'a':
+        elif choice == "a":
             # Reload with image data and populate
             print("\nReloading images and populating examples...")
             # We need to reload since we didn't save b64 data
@@ -338,7 +347,7 @@ async def interactive_review(results_file: Path, examples_dir: Path):
             )
             populate_examples(results, examples_dir)
             break
-        elif choice == 'p':
+        elif choice == "p":
             # Just populate from saved file - need to reload images
             print("Reloading images...")
             results_with_images = {}
@@ -354,12 +363,17 @@ async def interactive_review(results_file: Path, examples_dir: Path):
                         results_with_images[stage].append(item_copy)
             populate_examples(results_with_images, examples_dir)
             break
-        elif choice == 's':
-            stage = input("Which stage? (early/comma/pretzel/3fold/hatching/hatched): ").strip().lower()
+        elif choice == "s":
+            stage = (
+                input("Which stage? (early/comma/pretzel/3fold/hatching/hatched): ").strip().lower()
+            )
             if stage in data:
                 print(f"\n{stage} examples:")
                 for item in data[stage]:
-                    print(f"  T={item['timepoint']:04d}: {item.get('notes', 'no notes')} (conf={item.get('confidence', 0):.0%})")
+                    print(
+                        f"  T={item['timepoint']:04d}: {item.get('notes', 'no notes')}"
+                        f" (conf={item.get('confidence', 0):.0%})"
+                    )
             else:
                 print(f"No examples for {stage}")
 
@@ -370,9 +384,16 @@ def main():
     parser.add_argument("--embryo", "-e", type=int, default=1, help="Embryo number to sample")
     parser.add_argument("--samples", "-n", type=int, default=40, help="Number of images to sample")
     parser.add_argument("--review", "-r", action="store_true", help="Review existing labels")
-    parser.add_argument("--output", "-o", default="labeled_results.json", help="Output file for labels")
+    parser.add_argument(
+        "--output", "-o", default="labeled_results.json", help="Output file for labels"
+    )
     parser.add_argument("--examples-dir", default="gently/examples", help="Examples directory")
-    parser.add_argument("--auto-populate", "-a", action="store_true", help="Auto-populate without review")
+    parser.add_argument(
+        "--auto-populate",
+        "-a",
+        action="store_true",
+        help="Auto-populate without review",
+    )
 
     args = parser.parse_args()
 
@@ -391,12 +412,14 @@ def main():
             print(f"Directory not found: {timelapse_dir}")
             return
 
-        results = asyncio.run(auto_label_batch(
-            timelapse_dir,
-            args.embryo,
-            args.samples,
-            output_file,
-        ))
+        results = asyncio.run(
+            auto_label_batch(
+                timelapse_dir,
+                args.embryo,
+                args.samples,
+                output_file,
+            )
+        )
 
         if args.auto_populate:
             populate_examples(results, examples_dir)
diff --git a/scripts/contrast_variants.py b/scripts/contrast_variants.py
index 177b0f94..5e307418 100644
--- a/scripts/contrast_variants.py
+++ b/scripts/contrast_variants.py
@@ -5,6 +5,7 @@
 """
 
 from pathlib import Path
+
 import numpy as np
 import tifffile
 from PIL import Image
@@ -17,7 +18,7 @@
 def preprocess(proj: np.ndarray, recipe: str) -> np.ndarray:
     """Apply one preprocessing variant to a 2D projection."""
     arr = proj.astype(np.float32)
-    if recipe == "current_div16":          # current production
+    if recipe == "current_div16":  # current production
         arr = np.maximum(arr - 100.0, 0.0)
         return np.clip(arr / 16.0, 0, 255).astype(np.uint8)
     if recipe == "div8":
@@ -29,21 +30,21 @@ def preprocess(proj: np.ndarray, recipe: str) -> np.ndarray:
     if recipe == "log":
         arr = np.maximum(arr - 100.0, 1.0)
         return np.clip(np.log10(arr) * 80.0, 0, 255).astype(np.uint8)
-    if recipe == "gamma":                   # divisor 8 + gamma 0.5
+    if recipe == "gamma":  # divisor 8 + gamma 0.5
         arr = np.maximum(arr - 100.0, 0.0)
         scaled = np.clip(arr / 8.0, 0, 255) / 255.0
         return np.clip(np.power(scaled, 0.5) * 255.0, 0, 255).astype(np.uint8)
-    if recipe == "soft_log":               # gentler log: log10(x+1)*60
+    if recipe == "soft_log":  # gentler log: log10(x+1)*60
         arr = np.maximum(arr - 100.0, 0.0)
         return np.clip(np.log10(arr + 1.0) * 60.0, 0, 255).astype(np.uint8)
     raise ValueError(recipe)
 
 
 CASES = [
-    ("embryo_004", 1),    # blank baseline — must stay dark
-    ("embryo_003", 20),   # pre-onset — body should be visible
-    ("embryo_003", 28),   # mid-onset — body + puncta
-    ("embryo_003", 40),   # mature — body + puncta + neurites
+    ("embryo_004", 1),  # blank baseline — must stay dark
+    ("embryo_003", 20),  # pre-onset — body should be visible
+    ("embryo_003", 28),  # mid-onset — body + puncta
+    ("embryo_003", 40),  # mature — body + puncta + neurites
 ]
 
 RECIPES = ["current_div16", "div8", "div4", "log", "gamma", "soft_log"]
@@ -68,12 +69,18 @@ def main():
             continue
         vol = tifffile.imread(str(path))
         proj = make_projection(vol)
-        print(f"\n{embryo} t{tp:04d}: shape={proj.shape} min={proj.min()} max={proj.max()} p99={np.percentile(proj,99):.0f}")
+        print(
+            f"\n{embryo} t{tp:04d}: shape={proj.shape}"
+            f" min={proj.min()} max={proj.max()} p99={np.percentile(proj, 99):.0f}"
+        )
         for recipe in RECIPES:
             out_img = preprocess(proj, recipe)
             p = OUT / f"{embryo}_t{tp:04d}_{recipe}.png"
             Image.fromarray(out_img).save(p)
-            print(f"  {recipe:<15}  display p50={np.percentile(out_img,50):.0f} p90={np.percentile(out_img,90):.0f} max={out_img.max()}")
+            print(
+                f"  {recipe:<15}  display p50={np.percentile(out_img, 50):.0f}"
+                f" p90={np.percentile(out_img, 90):.0f} max={out_img.max()}"
+            )
 
 
 if __name__ == "__main__":
diff --git a/scripts/dry_run_dopaminergic_detector.py b/scripts/dry_run_dopaminergic_detector.py
index 482e965c..53d940b4 100644
--- a/scripts/dry_run_dopaminergic_detector.py
+++ b/scripts/dry_run_dopaminergic_detector.py
@@ -24,20 +24,28 @@
 ROOT = Path(__file__).resolve().parent.parent
 sys.path.insert(0, str(ROOT))
 
-from gently.app.detectors.dopaminergic_signal import DopaminergicSignalDetector
+from gently.app.detectors.dopaminergic_signal import DopaminergicSignalDetector  # noqa: E402
 
 SESSION = Path(r"D:/Gently3/sessions/20260522_1801_unnamed_ec5ea7ba")
 
 # (embryo, timepoint, expected behaviour from human annotation)
 CASES = [
-    ("embryo_004", 1,  "FALSE POSITIVE: blank embryo, no puncta. Expect NONE / NONE."),
+    ("embryo_004", 1, "FALSE POSITIVE: blank embryo, no puncta. Expect NONE / NONE."),
     ("embryo_003", 20, "Just before onset. Expect NONE or WEAK / NONE."),
     ("embryo_003", 21, "Onset starting. Expect WEAK / NONE or PARTIAL."),
     ("embryo_003", 25, "Two bulbs visible. Expect MEDIUM / PARTIAL."),
     ("embryo_003", 26, "Three bulbs. Expect MEDIUM / PARTIAL."),
     ("embryo_003", 28, "Neurite extension starting. Expect MEDIUM / PARTIAL or GOOD."),
-    ("embryo_003", 29, "Neurite extending further. Expect MEDIUM-STRONG / PARTIAL or GOOD."),
-    ("embryo_003", 40, "Mature pattern, multiple bright bodies + neurites. Expect STRONG / GOOD."),
+    (
+        "embryo_003",
+        29,
+        "Neurite extending further. Expect MEDIUM-STRONG / PARTIAL or GOOD.",
+    ),
+    (
+        "embryo_003",
+        40,
+        "Mature pattern, multiple bright bodies + neurites. Expect STRONG / GOOD.",
+    ),
 ]
 
 
@@ -70,22 +78,27 @@ async def _run_one(detector, claude, embryo: str, timepoint: int, expected: str)
     raw = result.raw_response or {}
     if isinstance(raw, dict):
         description = raw.get("description", "(no description)")
-        classifier_raw = raw.get("classifier_raw", "")
+        raw.get("classifier_raw", "")
     else:
         # legacy single-call shape
         description = "(no description — legacy single-call detector)"
-        classifier_raw = raw if isinstance(raw, str) else ""
+        raw if isinstance(raw, str) else ""
 
     print("PERCEIVER (Stage 1):")
     print(description.strip())
-    print(f"\nCLASSIFIER (Stage 2):")
+    print("\nCLASSIFIER (Stage 2):")
     findings = result.findings or {}
-    print(json.dumps({
-        "intensity_level": findings.get("intensity_level"),
-        "structure_quality": findings.get("structure_quality"),
-        "has_hatched": findings.get("has_hatched"),
-        "reasoning": result.reasoning,
-    }, indent=2))
+    print(
+        json.dumps(
+            {
+                "intensity_level": findings.get("intensity_level"),
+                "structure_quality": findings.get("structure_quality"),
+                "has_hatched": findings.get("has_hatched"),
+                "reasoning": result.reasoning,
+            },
+            indent=2,
+        )
+    )
     if result.error:
         print(f"ERROR: {result.error}")
     print(f"elapsed: {result.elapsed_ms:.0f}ms")
diff --git a/scripts/dump_perceiver_input.py b/scripts/dump_perceiver_input.py
index bbf29b58..9c1c1506 100644
--- a/scripts/dump_perceiver_input.py
+++ b/scripts/dump_perceiver_input.py
@@ -17,7 +17,7 @@
 ROOT = Path(__file__).resolve().parent.parent
 sys.path.insert(0, str(ROOT))
 
-from gently.app.detectors.dopaminergic_signal import _volume_to_b64
+from gently.app.detectors.dopaminergic_signal import _volume_to_b64  # noqa: E402
 
 SESSION = Path(r"D:/Gently3/sessions/20260522_1801_unnamed_ec5ea7ba")
 OUT = Path("./perceiver_input")
diff --git a/scripts/extract_stage_examples.py b/scripts/extract_stage_examples.py
index bacf162a..208e49c9 100644
--- a/scripts/extract_stage_examples.py
+++ b/scripts/extract_stage_examples.py
@@ -13,13 +13,16 @@
     python scripts/extract_stage_examples.py --session 3fb70aca --embryo embryo_1
 
     # Using session ID with custom storage path
-    python scripts/extract_stage_examples.py --session exp_20251219_185542_f7df153a --storage D:/Gently --embryo embryo_1
+    python scripts/extract_stage_examples.py \
+        --session exp_20251219_185542_f7df153a --storage D:/Gently --embryo embryo_1
 
     # Using direct source path
-    python scripts/extract_stage_examples.py --source multi_embryo_volumes/20251122_141240 --embryo embryo_001
+    python scripts/extract_stage_examples.py \
+        --source multi_embryo_volumes/20251122_141240 --embryo embryo_001
 
     # Extract specific timepoint range
-    python scripts/extract_stage_examples.py --session 3fb70aca --embryo embryo_1 --start 50 --end 100
+    python scripts/extract_stage_examples.py \
+        --session 3fb70aca --embryo embryo_1 --start 50 --end 100
 """
 
 import argparse
@@ -29,14 +32,13 @@
 import sys
 from datetime import datetime
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple
 
 import numpy as np
 
 # Add parent directory to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
-from gently.harness.perception.stages import STAGES, DevelopmentalStage
+from gently.harness.perception.stages import STAGES
 
 # Lazy imports
 tifffile = None
@@ -49,6 +51,7 @@ def ensure_dependencies():
 
     try:
         import tifffile as _tifffile
+
         tifffile = _tifffile
     except ImportError:
         print("ERROR: tifffile is required. Install with: pip install tifffile")
@@ -56,13 +59,14 @@ def ensure_dependencies():
 
     try:
         from PIL import Image as _Image
+
         PIL_Image = _Image
     except ImportError:
         print("ERROR: Pillow is required. Install with: pip install Pillow")
         sys.exit(1)
 
 
-def discover_volumes(session_dir: Path, embryo_id: Optional[str] = None) -> Dict[str, List[Path]]:
+def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict[str, list[Path]]:
     """
     Discover volume files in a session directory.
 
@@ -145,7 +149,7 @@ def create_dual_view_projection(volume: np.ndarray) -> np.ndarray:
         # Check if width contains dual-view data (views side-by-side in X)
         if width > height * 2:
             # Extract View A (left half)
-            view_a = view_a[:, :, :width // 2]
+            view_a = view_a[:, :, : width // 2]
 
         # TOP projection: max along Z axis (looking down at embryo)
         top_proj = np.max(view_a, axis=0)  # Shape: (Y, X)
@@ -227,16 +231,16 @@ def save_example(image: np.ndarray, stage: str, output_dir: Path) -> Path:
     return filepath
 
 
-def load_hatching_log(session_dir: Path) -> Optional[Dict]:
+def load_hatching_log(session_dir: Path) -> dict | None:
     """Load hatching_detection_log.json if it exists."""
     log_path = session_dir / "hatching_detection_log.json"
     if log_path.exists():
-        with open(log_path, "r") as f:
+        with open(log_path) as f:
             return json.load(f)
     return None
 
 
-def get_stage_from_log(log: Dict, embryo_id: str, timepoint: int) -> Optional[str]:
+def get_stage_from_log(log: dict, embryo_id: str, timepoint: int) -> str | None:
     """
     Extract stage from hatching detection log for a specific timepoint.
 
@@ -263,8 +267,12 @@ def get_stage_from_log(log: Dict, embryo_id: str, timepoint: int) -> Optional[st
     return None
 
 
-def save_preview_image(image: np.ndarray, timepoint: int, preview_dir: Path,
-                       suggested_stage: Optional[str] = None) -> Path:
+def save_preview_image(
+    image: np.ndarray,
+    timepoint: int,
+    preview_dir: Path,
+    suggested_stage: str | None = None,
+) -> Path:
     """Save image to preview folder for manual review."""
     preview_dir.mkdir(parents=True, exist_ok=True)
 
@@ -280,7 +288,9 @@ def save_preview_image(image: np.ndarray, timepoint: int, preview_dir: Path,
     return filepath
 
 
-def interactive_classify(image: np.ndarray, timepoint: int, suggested_stage: Optional[str] = None) -> Optional[str]:
+def interactive_classify(
+    image: np.ndarray, timepoint: int, suggested_stage: str | None = None
+) -> str | None:
     """
     Display image and let user classify interactively.
 
@@ -301,29 +311,40 @@ def interactive_classify(image: np.ndarray, timepoint: int, suggested_stage: Opt
         cv2.putText(display, info, (10, 25), cv2.FONT_HERSHEY_SIMPLEX, 0.6, (255, 255, 255), 1)
 
         # Add stage key legend
-        legend = "Keys: (e)arly (b)ean (c)omma (1).5fold (2)fold (3)fold (h)atching (d)one(hatched) (s)kip (q)uit"
-        cv2.putText(display, legend, (10, display.shape[0] - 10), cv2.FONT_HERSHEY_SIMPLEX, 0.4, (200, 200, 200), 1)
+        legend = (
+            "Keys: (e)arly (b)ean (c)omma (1).5fold (2)fold (3)fold"
+            " (h)atching (d)one(hatched) (s)kip (q)uit"
+        )
+        cv2.putText(
+            display,
+            legend,
+            (10, display.shape[0] - 10),
+            cv2.FONT_HERSHEY_SIMPLEX,
+            0.4,
+            (200, 200, 200),
+            1,
+        )
 
         cv2.imshow("Classify Stage", display)
 
         key = cv2.waitKey(0) & 0xFF
 
         key_map = {
-            ord('e'): 'early',
-            ord('b'): 'bean',
-            ord('c'): 'comma',
-            ord('1'): '1.5fold',
-            ord('2'): '2fold',
-            ord('3'): '3fold',
-            ord('h'): 'hatching',
-            ord('d'): 'hatched',
-            ord('s'): None,  # Skip
-            ord('q'): 'QUIT',
+            ord("e"): "early",
+            ord("b"): "bean",
+            ord("c"): "comma",
+            ord("1"): "1.5fold",
+            ord("2"): "2fold",
+            ord("3"): "3fold",
+            ord("h"): "hatching",
+            ord("d"): "hatched",
+            ord("s"): None,  # Skip
+            ord("q"): "QUIT",
         }
 
         return key_map.get(key, None)
 
-    except Exception as e:
+    except Exception:
         # GUI not available, return None to trigger preview mode
         return "NO_GUI"
 
@@ -333,31 +354,60 @@ def main():
 
     # Source specification (either --session or --source)
     source_group = parser.add_mutually_exclusive_group(required=True)
-    source_group.add_argument("--session", type=str,
-                              help="Session ID (e.g., 3fb70aca or exp_20251219_185542_f7df153a)")
-    source_group.add_argument("--source", type=str,
-                              help="Direct source path (multi_embryo_volumes/SESSION or lightsheet_captures/batch)")
-
-    parser.add_argument("--storage", type=str, default="D:/Gently",
-                        help="Storage path for session data (default: D:/Gently)")
-    parser.add_argument("--embryo", type=str, default=None,
-                        help="Specific embryo ID to process (default: all)")
-    parser.add_argument("--output", type=str, default=None,
-                        help="Output directory (default: gently/examples/stages)")
-    parser.add_argument("--use-log", action="store_true",
-                        help="Use hatching_detection_log.json for auto-labeling")
-    parser.add_argument("--start", type=int, default=0,
-                        help="Start timepoint")
-    parser.add_argument("--end", type=int, default=None,
-                        help="End timepoint")
-    parser.add_argument("--step", type=int, default=10,
-                        help="Sample every N timepoints (default: 10)")
-    parser.add_argument("--auto", action="store_true",
-                        help="Auto-save without interactive review (requires --use-log)")
-    parser.add_argument("--preview", action="store_true",
-                        help="Save images to preview folder instead of interactive classification")
-    parser.add_argument("--list-embryos", action="store_true",
-                        help="Just list available embryos and exit")
+    source_group.add_argument(
+        "--session",
+        type=str,
+        help="Session ID (e.g., 3fb70aca or exp_20251219_185542_f7df153a)",
+    )
+    source_group.add_argument(
+        "--source",
+        type=str,
+        help="Direct source path (multi_embryo_volumes/SESSION or lightsheet_captures/batch)",
+    )
+
+    parser.add_argument(
+        "--storage",
+        type=str,
+        default="D:/Gently",
+        help="Storage path for session data (default: D:/Gently)",
+    )
+    parser.add_argument(
+        "--embryo",
+        type=str,
+        default=None,
+        help="Specific embryo ID to process (default: all)",
+    )
+    parser.add_argument(
+        "--output",
+        type=str,
+        default=None,
+        help="Output directory (default: gently/examples/stages)",
+    )
+    parser.add_argument(
+        "--use-log",
+        action="store_true",
+        help="Use hatching_detection_log.json for auto-labeling",
+    )
+    parser.add_argument("--start", type=int, default=0, help="Start timepoint")
+    parser.add_argument("--end", type=int, default=None, help="End timepoint")
+    parser.add_argument(
+        "--step", type=int, default=10, help="Sample every N timepoints (default: 10)"
+    )
+    parser.add_argument(
+        "--auto",
+        action="store_true",
+        help="Auto-save without interactive review (requires --use-log)",
+    )
+    parser.add_argument(
+        "--preview",
+        action="store_true",
+        help="Save images to preview folder instead of interactive classification",
+    )
+    parser.add_argument(
+        "--list-embryos",
+        action="store_true",
+        help="Just list available embryos and exit",
+    )
 
     args = parser.parse_args()
 
@@ -405,15 +455,15 @@ def main():
     if args.use_log:
         hatching_log = load_hatching_log(source_dir)
         if hatching_log:
-            print(f"\nLoaded hatching detection log")
+            print("\nLoaded hatching detection log")
         else:
-            print(f"\nWARNING: No hatching_detection_log.json found")
+            print("\nWARNING: No hatching_detection_log.json found")
 
     # Process each embryo
     for embryo_id, volume_paths in embryo_volumes.items():
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"Processing {embryo_id}: {len(volume_paths)} timepoints")
-        print(f"{'='*60}")
+        print(f"{'=' * 60}")
 
         # Filter timepoints
         end_tp = args.end if args.end else len(volume_paths)
@@ -450,7 +500,7 @@ def main():
                 # Interactive classification
                 stage = interactive_classify(projection, timepoint, suggested_stage)
 
-            if stage == 'QUIT':
+            if stage == "QUIT":
                 print("\nQuitting...")
                 break
 
@@ -472,8 +522,9 @@ def main():
     # Final cleanup
     try:
         import cv2
+
         cv2.destroyAllWindows()
-    except:
+    except Exception:
         pass
 
     print("\nDone!")
diff --git a/scripts/gemini_stage_test.py b/scripts/gemini_stage_test.py
index bb7b6969..d99d12db 100644
--- a/scripts/gemini_stage_test.py
+++ b/scripts/gemini_stage_test.py
@@ -9,17 +9,18 @@
 
 Usage:
     python scripts/gemini_stage_test.py --session 3fb70aca --embryo embryo_1
-    python scripts/gemini_stage_test.py --session 3fb70aca --embryo embryo_1 --model gemini-3-pro-preview
+    python scripts/gemini_stage_test.py --session 3fb70aca --embryo embryo_1 \
+        --model gemini-3-pro-preview
 """
 
-import os
-import sys
 import argparse
 import json
-import time
+import os
 import re
-from pathlib import Path
+import sys
+import time
 from datetime import datetime
+from pathlib import Path
 
 # Add parent directory to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent))
@@ -38,6 +39,7 @@ def ensure_dependencies():
 
     try:
         import cv2 as _cv2
+
         cv2 = _cv2
     except ImportError:
         print("ERROR: opencv-python is required. Install with: pip install opencv-python")
@@ -45,6 +47,7 @@ def ensure_dependencies():
 
     try:
         import tifffile as _tifffile
+
         tifffile = _tifffile
     except ImportError:
         print("ERROR: tifffile is required. Install with: pip install tifffile")
@@ -52,6 +55,7 @@ def ensure_dependencies():
 
     try:
         from google import genai as _genai
+
         genai = _genai
     except ImportError:
         print("ERROR: google-genai is required. Install with: pip install google-genai")
@@ -62,6 +66,7 @@ def ensure_dependencies():
 # Video Creation (adapted from video_maker.py)
 # ============================================================================
 
+
 def discover_volumes(session_dir: Path, embryo_id: str = None) -> dict:
     """Discover volume files in a session directory."""
     if not session_dir.exists():
@@ -156,7 +161,7 @@ def normalize(img):
         # diSPIM format has width roughly 4x height when dual-view
         if width > height * 2:
             # Extract View A (left half)
-            view_a = view_a[:, :, :width // 2]
+            view_a = view_a[:, :, : width // 2]
 
         # TOP projection: max along Z axis (looking down at embryo)
         top_proj = np.max(view_a, axis=0)  # Shape: (Y, X)
@@ -191,7 +196,9 @@ def normalize(img):
     return normalize(view_a)
 
 
-def normalize_for_video(image: np.ndarray, percentile_low: float = 1, percentile_high: float = 99.5) -> np.ndarray:
+def normalize_for_video(
+    image: np.ndarray, percentile_low: float = 1, percentile_high: float = 99.5
+) -> np.ndarray:
     """Normalize image to 8-bit for video encoding."""
     p_low = np.percentile(image, percentile_low)
     p_high = np.percentile(image, percentile_high)
@@ -206,8 +213,13 @@ def normalize_for_video(image: np.ndarray, percentile_low: float = 1, percentile
     return image
 
 
-def add_text_overlay(image: np.ndarray, text: str, position: str = "top-left",
-                     font_scale: float = 0.6, color=(255, 255, 255)) -> np.ndarray:
+def add_text_overlay(
+    image: np.ndarray,
+    text: str,
+    position: str = "top-left",
+    font_scale: float = 0.6,
+    color=(255, 255, 255),
+) -> np.ndarray:
     """Add text overlay to image."""
     if image.ndim == 2:
         image = cv2.cvtColor(image, cv2.COLOR_GRAY2BGR)
@@ -233,7 +245,7 @@ def add_text_overlay(image: np.ndarray, text: str, position: str = "top-left",
         (x - 2, y - text_height - 2),
         (x + text_width + 2, y + baseline + 2),
         (0, 0, 0),
-        -1
+        -1,
     )
 
     cv2.putText(image, text, (x, y), font, font_scale, color, thickness)
@@ -241,8 +253,13 @@ def add_text_overlay(image: np.ndarray, text: str, position: str = "top-left",
     return image
 
 
-def create_embryo_video(session_id: str, embryo_id: str, storage_path: Path,
-                        fps: int = 10, output_path: Path = None) -> dict:
+def create_embryo_video(
+    session_id: str,
+    embryo_id: str,
+    storage_path: Path,
+    fps: int = 10,
+    output_path: Path = None,
+) -> dict:
     """
     Create timelapse video from embryo images.
 
@@ -306,19 +323,29 @@ def create_embryo_video(session_id: str, embryo_id: str, storage_path: Path,
                 cv2.putText(frame, "TOP", (10, height - 10), font, 0.5, (200, 200, 200), 1)
                 # SIDE label - estimate separator position based on aspect ratio
                 side_start = int(width * 0.75)  # Approximate
-                cv2.putText(frame, "SIDE", (side_start, height - 10), font, 0.5, (200, 200, 200), 1)
+                cv2.putText(
+                    frame,
+                    "SIDE",
+                    (side_start, height - 10),
+                    font,
+                    0.5,
+                    (200, 200, 200),
+                    1,
+                )
 
                 # Initialize writer
                 if writer is None:
                     first_shape = frame.shape
                     height, width = frame.shape[:2]
 
-                    codecs = [('mp4v', '.mp4'), ('avc1', '.mp4'), ('XVID', '.avi')]
+                    codecs = [("mp4v", ".mp4"), ("avc1", ".mp4"), ("XVID", ".avi")]
 
                     for codec, ext in codecs:
                         fourcc = cv2.VideoWriter_fourcc(*codec)
                         test_path = output_path.with_suffix(ext)
-                        writer = cv2.VideoWriter(str(test_path), fourcc, fps, (width, height), isColor=True)
+                        writer = cv2.VideoWriter(
+                            str(test_path), fourcc, fps, (width, height), isColor=True
+                        )
                         if writer.isOpened():
                             output_path = test_path
                             print(f"  Using codec: {codec}")
@@ -352,7 +379,7 @@ def create_embryo_video(session_id: str, embryo_id: str, storage_path: Path,
             "output_path": str(output_path),
             "frame_count": frame_count,
             "duration_seconds": duration,
-            "fps": fps
+            "fps": fps,
         }
 
     except Exception as e:
@@ -365,6 +392,7 @@ def create_embryo_video(session_id: str, embryo_id: str, storage_path: Path,
 # Gemini API Integration
 # ============================================================================
 
+
 def build_stage_classification_prompt(frame_count: int, fps: int, duration_seconds: float) -> str:
     """Build the classification prompt with video-specific information."""
     return f"""You are analyzing a time-lapse microscopy video of a C. elegans embryo developing.
@@ -434,7 +462,8 @@ def build_stage_classification_prompt(frame_count: int, fps: int, duration_secon
 Watch the ENTIRE video and identify each developmental stage. For each stage you observe:
 
 1. Report the FRAME NUMBER (0 to {frame_count - 1}) when that stage BEGINS
-2. Identify the stage name (use lowercase: early, bean, comma, 1.5fold, 2fold, 3fold, hatching, hatched)
+2. Identify the stage name (use lowercase: early, bean, comma, 1.5fold, 2fold, 3fold,
+   hatching, hatched)
 3. Describe the specific morphological features you observe that indicate this stage
 4. Provide your confidence level (HIGH, MEDIUM, or LOW)
 
@@ -464,8 +493,14 @@ def build_stage_classification_prompt(frame_count: int, fps: int, duration_secon
 Be precise with frame numbers. Watch the ENTIRE video to capture all stage transitions."""
 
 
-def analyze_with_gemini(video_path: str, model: str = "gemini-3-pro-preview", api_key: str = None,
-                        frame_count: int = 100, fps: int = 10, duration_seconds: float = 10.0) -> dict:
+def analyze_with_gemini(
+    video_path: str,
+    model: str = "gemini-3-pro-preview",
+    api_key: str = None,
+    frame_count: int = 100,
+    fps: int = 10,
+    duration_seconds: float = 10.0,
+) -> dict:
     """
     Upload video to Gemini and analyze for developmental stages.
 
@@ -479,7 +514,9 @@ def analyze_with_gemini(video_path: str, model: str = "gemini-3-pro-preview", ap
     if not api_key:
         api_key = os.environ.get("GOOGLE_API_KEY")
     if not api_key:
-        return {"error": "No API key found. Set GEMINI_API_KEY environment variable or pass --api-key"}
+        return {
+            "error": "No API key found. Set GEMINI_API_KEY environment variable or pass --api-key"
+        }
 
     print(f"\nInitializing Gemini client with model: {model}")
 
@@ -521,7 +558,7 @@ def analyze_with_gemini(video_path: str, model: str = "gemini-3-pro-preview", ap
     if video_file.state.name != "ACTIVE":
         return {"error": f"Video processing failed. State: {video_file.state.name}"}
 
-    print(f"  Video ready for analysis")
+    print("  Video ready for analysis")
 
     # Analyze with Gemini
     print(f"\nSending to Gemini {model} for analysis...")
@@ -530,7 +567,10 @@ def analyze_with_gemini(video_path: str, model: str = "gemini-3-pro-preview", ap
     try:
         response = client.models.generate_content(
             model=model,
-            contents=[video_file, build_stage_classification_prompt(frame_count, fps, duration_seconds)]
+            contents=[
+                video_file,
+                build_stage_classification_prompt(frame_count, fps, duration_seconds),
+            ],
         )
 
         elapsed = time.time() - start_time
@@ -540,7 +580,7 @@ def analyze_with_gemini(video_path: str, model: str = "gemini-3-pro-preview", ap
             "success": True,
             "response_text": response.text,
             "model": model,
-            "elapsed_seconds": elapsed
+            "elapsed_seconds": elapsed,
         }
 
     except Exception as e:
@@ -555,17 +595,20 @@ def parse_stage_response(response_text: str) -> dict:
     """
     # Try to extract JSON from response
     # Handle cases where response has markdown code blocks
-    json_match = re.search(r'```(?:json)?\s*([\s\S]*?)\s*```', response_text)
+    json_match = re.search(r"```(?:json)?\s*([\s\S]*?)\s*```", response_text)
 
     if json_match:
         json_str = json_match.group(1)
     else:
         # Try to find raw JSON
-        json_match = re.search(r'\{[\s\S]*\}', response_text)
+        json_match = re.search(r"\{[\s\S]*\}", response_text)
         if json_match:
             json_str = json_match.group(0)
         else:
-            return {"error": "Could not find JSON in response", "raw_response": response_text}
+            return {
+                "error": "Could not find JSON in response",
+                "raw_response": response_text,
+            }
 
     try:
         data = json.loads(json_str)
@@ -588,7 +631,10 @@ def timestamp_to_seconds(timestamp: str) -> float:
 # Annotated Video Creation
 # ============================================================================
 
-def create_annotated_video(source_video: str, stage_data: dict, output_path: str, fps: int = 10) -> dict:
+
+def create_annotated_video(
+    source_video: str, stage_data: dict, output_path: str, fps: int = 10
+) -> dict:
     """
     Create annotated video with stage labels overlaid.
 
@@ -626,19 +672,21 @@ def create_annotated_video(source_video: str, stage_data: dict, output_path: str
                 end_seconds = timestamp_to_seconds(next_stage["timestamp"])
                 end_frame = int(end_seconds * fps)
             else:
-                end_frame = float('inf')
+                end_frame = float("inf")
         else:
-            end_frame = float('inf')
-
-        stage_timeline.append({
-            "start_frame": start_frame,
-            "end_frame": end_frame,
-            "stage": stage_info["stage"],
-            "confidence": stage_info.get("confidence", "?"),
-            "features": stage_info.get("features", "")
-        })
+            end_frame = float("inf")
+
+        stage_timeline.append(
+            {
+                "start_frame": start_frame,
+                "end_frame": end_frame,
+                "stage": stage_info["stage"],
+                "confidence": stage_info.get("confidence", "?"),
+                "features": stage_info.get("features", ""),
+            }
+        )
 
-    print(f"\nCreating annotated video...")
+    print("\nCreating annotated video...")
     print(f"  Source: {source_video}")
     print(f"  Output: {output_path}")
     print(f"  Stages: {len(stage_timeline)}")
@@ -667,7 +715,7 @@ def create_annotated_video(source_video: str, stage_data: dict, output_path: str
     output_path = Path(output_path)
     output_path.parent.mkdir(parents=True, exist_ok=True)
 
-    fourcc = cv2.VideoWriter_fourcc(*'mp4v')
+    fourcc = cv2.VideoWriter_fourcc(*"mp4v")
     writer = cv2.VideoWriter(str(output_path), fourcc, source_fps, (width, height), isColor=True)
 
     if not writer.isOpened():
@@ -720,7 +768,7 @@ def create_annotated_video(source_video: str, stage_data: dict, output_path: str
         "success": True,
         "output_path": str(output_path),
         "frame_count": frame_idx,
-        "stages_annotated": len(stage_timeline)
+        "stages_annotated": len(stage_timeline),
     }
 
 
@@ -728,23 +776,44 @@ def create_annotated_video(source_video: str, stage_data: dict, output_path: str
 # Main
 # ============================================================================
 
+
 def main():
     parser = argparse.ArgumentParser(
-        description="Test Gemini video understanding for C. elegans developmental stage classification"
+        description=(
+            "Test Gemini video understanding for C. elegans developmental stage classification"
+        )
     )
     parser.add_argument("--session", default="3fb70aca", help="Session ID")
     parser.add_argument("--embryo", default="embryo_1", help="Embryo ID")
-    parser.add_argument("--model", default="gemini-2.5-flash",
-                        choices=["gemini-2.5-pro", "gemini-2.5-flash", "gemini-3-pro-preview", "gemini-3-flash-preview"],
-                        help="Gemini model to use")
+    parser.add_argument(
+        "--model",
+        default="gemini-2.5-flash",
+        choices=[
+            "gemini-2.5-pro",
+            "gemini-2.5-flash",
+            "gemini-3-pro-preview",
+            "gemini-3-flash-preview",
+        ],
+        help="Gemini model to use",
+    )
     parser.add_argument("--storage", default="D:/Gently", help="Storage path")
     parser.add_argument("--fps", type=int, default=10, help="Video frames per second")
-    parser.add_argument("--skip-video-creation", action="store_true",
-                        help="Skip video creation if video already exists")
-    parser.add_argument("--video-only", action="store_true",
-                        help="Only create video, skip Gemini analysis")
-    parser.add_argument("--api-key", type=str, default=None,
-                        help="Gemini API key (or set GEMINI_API_KEY env var)")
+    parser.add_argument(
+        "--skip-video-creation",
+        action="store_true",
+        help="Skip video creation if video already exists",
+    )
+    parser.add_argument(
+        "--video-only",
+        action="store_true",
+        help="Only create video, skip Gemini analysis",
+    )
+    parser.add_argument(
+        "--api-key",
+        type=str,
+        default=None,
+        help="Gemini API key (or set GEMINI_API_KEY env var)",
+    )
 
     args = parser.parse_args()
 
@@ -768,7 +837,7 @@ def main():
 
     # Video info for Gemini prompt
     video_frame_count = 100  # default
-    video_duration = 10.0    # default
+    video_duration = 10.0  # default
 
     if args.skip_video_creation and video_path.exists():
         print(f"\nUsing existing video: {video_path}")
@@ -779,7 +848,7 @@ def main():
         cap.release()
         print(f"  Frames: {video_frame_count}, Duration: {video_duration:.1f}s")
     else:
-        print(f"\n[Step 1] Creating timelapse video...")
+        print("\n[Step 1] Creating timelapse video...")
         video_result = create_embryo_video(args.session, args.embryo, storage_path, args.fps)
 
         if "error" in video_result:
@@ -789,7 +858,7 @@ def main():
         video_path = Path(video_result["output_path"])
         video_frame_count = video_result["frame_count"]
         video_duration = video_result["duration_seconds"]
-        print(f"\nVideo created successfully!")
+        print("\nVideo created successfully!")
         print(f"  Path: {video_path}")
         print(f"  Frames: {video_frame_count}")
         print(f"  Duration: {video_duration:.1f}s")
@@ -799,10 +868,14 @@ def main():
         return 0
 
     # Step 2: Analyze with Gemini
-    print(f"\n[Step 2] Analyzing with Gemini...")
+    print("\n[Step 2] Analyzing with Gemini...")
     result = analyze_with_gemini(
-        str(video_path), args.model, args.api_key,
-        frame_count=video_frame_count, fps=args.fps, duration_seconds=video_duration
+        str(video_path),
+        args.model,
+        args.api_key,
+        frame_count=video_frame_count,
+        fps=args.fps,
+        duration_seconds=video_duration,
     )
 
     if "error" in result:
@@ -818,18 +891,22 @@ def main():
     # Save raw response
     response_file = video_dir / f"{args.embryo}_gemini_response.json"
     with open(response_file, "w") as f:
-        json.dump({
-            "model": args.model,
-            "session": args.session,
-            "embryo": args.embryo,
-            "response": result["response_text"],
-            "elapsed_seconds": result["elapsed_seconds"],
-            "timestamp": datetime.now().isoformat()
-        }, f, indent=2)
+        json.dump(
+            {
+                "model": args.model,
+                "session": args.session,
+                "embryo": args.embryo,
+                "response": result["response_text"],
+                "elapsed_seconds": result["elapsed_seconds"],
+                "timestamp": datetime.now().isoformat(),
+            },
+            f,
+            indent=2,
+        )
     print(f"\nResponse saved to: {response_file}")
 
     # Step 3: Parse response
-    print(f"\n[Step 3] Parsing response...")
+    print("\n[Step 3] Parsing response...")
     parsed = parse_stage_response(result["response_text"])
 
     if "error" in parsed:
@@ -846,7 +923,7 @@ def main():
         if "frame" in stage:
             loc = f"Frame {stage['frame']}"
         else:
-            loc = stage.get('timestamp', '?')
+            loc = stage.get("timestamp", "?")
         print(f"  {loc} - {stage['stage']} ({stage.get('confidence', '?')})")
 
     print(f"\nFinal stage: {stage_data.get('final_stage', 'unknown')}")
@@ -859,15 +936,10 @@ def main():
     print(f"\nParsed stages saved to: {parsed_file}")
 
     # Step 4: Create annotated video
-    print(f"\n[Step 4] Creating annotated video...")
+    print("\n[Step 4] Creating annotated video...")
     annotated_path = video_dir / f"{args.embryo}_timelapse_gemini_annotated.mp4"
 
-    result = create_annotated_video(
-        str(video_path),
-        stage_data,
-        str(annotated_path),
-        args.fps
-    )
+    result = create_annotated_video(str(video_path), stage_data, str(annotated_path), args.fps)
 
     if "error" in result:
         print(f"ERROR: {result['error']}")
diff --git a/scripts/generate_examples.py b/scripts/generate_examples.py
index e8531005..587212ad 100644
--- a/scripts/generate_examples.py
+++ b/scripts/generate_examples.py
@@ -15,13 +15,12 @@
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
 from scripts.projection_explorer import (
-    ensure_dependencies,
     discover_volumes,
+    ensure_dependencies,
     load_volume,
     normalize_image,
 )
 
-
 # Ground truth for embryo 2
 EMBRYO_2_TRANSITIONS = {
     "early": 0,
@@ -35,12 +34,12 @@
 # Timepoints to sample for each stage (showing progression within stage)
 # Pick timepoints that span the stage duration
 STAGE_TIMEPOINTS = {
-    "early": [5, 12, 20, 28],       # T0-32: 4 timepoints
-    "bean": [34, 36, 38],            # T33-38: 3 timepoints (short stage)
-    "comma": [40, 42, 44],           # T39-44: 3 timepoints (short stage)
-    "1.5fold": [47, 52, 57],         # T45-59: 3 timepoints
-    "2fold": [62, 68, 75],           # T60-79: 3 timepoints
-    "pretzel": [82, 88, 95],         # T80+: 3 timepoints
+    "early": [5, 12, 20, 28],  # T0-32: 4 timepoints
+    "bean": [34, 36, 38],  # T33-38: 3 timepoints (short stage)
+    "comma": [40, 42, 44],  # T39-44: 3 timepoints (short stage)
+    "1.5fold": [47, 52, 57],  # T45-59: 3 timepoints
+    "2fold": [62, 68, 75],  # T60-79: 3 timepoints
+    "pretzel": [82, 88, 95],  # T80+: 3 timepoints
 }
 
 
@@ -56,12 +55,14 @@ def crop_to_content(img, padding=10):
         gray = img.astype(np.float32)
 
     # Estimate background as the median of edge pixels
-    edge_pixels = np.concatenate([
-        gray[0, :],      # top row
-        gray[-1, :],     # bottom row
-        gray[:, 0],      # left column
-        gray[:, -1],     # right column
-    ])
+    edge_pixels = np.concatenate(
+        [
+            gray[0, :],  # top row
+            gray[-1, :],  # bottom row
+            gray[:, 0],  # left column
+            gray[:, -1],  # right column
+        ]
+    )
     background = np.median(edge_pixels)
 
     # Threshold: significantly above background (background + 25% of dynamic range)
@@ -76,6 +77,7 @@ def crop_to_content(img, padding=10):
 
     # Use morphological operations to clean up noise
     from scipy import ndimage as ndi
+
     # Close small gaps, then open to remove small noise
     content_mask = ndi.binary_closing(content_mask, iterations=2)
     content_mask = ndi.binary_opening(content_mask, iterations=2)
@@ -147,7 +149,7 @@ def create_stage_montage(volumes_list, timepoints, stage_name):
     from PIL import Image as PILImage
 
     scaled_sides = []
-    for i, (top, side) in enumerate(zip(top_views, side_views)):
+    for _i, (top, side) in enumerate(zip(top_views, side_views, strict=False)):
         target_width = top.shape[1]  # Match TOP width
         # Scale height to be visible (3x original Z depth)
         target_height = max(top.shape[0] // 3, side.shape[0] * 3)
@@ -174,7 +176,7 @@ def pad_center(img, target_h, target_w):
         x_off = (target_w - w) // 2
         if img.ndim == 3:
             img = img[:, :, 0] if img.shape[2] > 1 else img.squeeze()
-        result[y_off:y_off+h, x_off:x_off+w] = img
+        result[y_off : y_off + h, x_off : x_off + w] = img
         return result
 
     padded_tops = [pad_center(t, max_top_h, cell_w) for t in top_views]
@@ -182,7 +184,7 @@ def pad_center(img, target_h, target_w):
 
     # Create separator
     sep_w = 2
-    n_cols = len(padded_tops)
+    len(padded_tops)
 
     # Build rows with separators
     def build_row(views):
@@ -211,13 +213,13 @@ def build_row(views):
     try:
         font = ImageFont.truetype("arial.ttf", 12)
         small_font = ImageFont.truetype("arial.ttf", 10)
-    except:
+    except Exception:
         font = ImageFont.load_default()
         small_font = font
 
     # Add timepoint labels at bottom
     label_h = 16
-    labeled_img = Image.new('L', (img.width, img.height + label_h), 0)
+    labeled_img = Image.new("L", (img.width, img.height + label_h), 0)
     labeled_img.paste(img, (0, 0))
     draw = ImageDraw.Draw(labeled_img)
 
@@ -231,12 +233,17 @@ def build_row(views):
         # Get text size
         bbox = draw.textbbox((0, 0), label, font=small_font)
         text_w = bbox[2] - bbox[0]
-        draw.text((cell_center - text_w // 2, img.height + 2), label, fill=200, font=small_font)
+        draw.text(
+            (cell_center - text_w // 2, img.height + 2),
+            label,
+            fill=200,
+            font=small_font,
+        )
         x_pos += cell_w
 
     # Add row labels on left
     final_w = labeled_img.width + 35
-    final_img = Image.new('L', (final_w, labeled_img.height), 0)
+    final_img = Image.new("L", (final_w, labeled_img.height), 0)
     final_img.paste(labeled_img, (35, 0))
     draw = ImageDraw.Draw(final_img)
 
@@ -291,9 +298,10 @@ def main():
     output_dir = Path("gently/examples/stages")
     output_dir.mkdir(parents=True, exist_ok=True)
 
-    from PIL import Image
     import json
 
+    from PIL import Image
+
     # Generate montage and save volumes for each stage
     for stage, timepoints in STAGE_TIMEPOINTS.items():
         print(f"\n=== {stage.upper()} ===")
@@ -308,7 +316,7 @@ def main():
             Image.fromarray(montage).save(output_path, quality=95)
             print(f"  Saved: {output_path} ({montage.shape[1]}x{montage.shape[0]})")
         else:
-            print(f"  ERROR: Failed to create montage")
+            print("  ERROR: Failed to create montage")
 
         # Save volumes for all timepoints in this stage
         volumes_dir = stage_dir / "volumes"
@@ -324,11 +332,13 @@ def main():
                 # Save as compressed numpy with timepoint in filename
                 volume_out = volumes_dir / f"T{tp:03d}.npz"
                 np.savez_compressed(volume_out, volume=volume)
-                saved_volumes.append({
-                    "timepoint": tp,
-                    "filename": f"T{tp:03d}.npz",
-                    "shape": list(volume.shape),
-                })
+                saved_volumes.append(
+                    {
+                        "timepoint": tp,
+                        "filename": f"T{tp:03d}.npz",
+                        "shape": list(volume.shape),
+                    }
+                )
                 print(f"  Saved volume: T{tp} ({volume.shape})")
 
         # Save metadata
diff --git a/scripts/launch_viz_server.py b/scripts/launch_viz_server.py
index aabb661a..b10eea91 100644
--- a/scripts/launch_viz_server.py
+++ b/scripts/launch_viz_server.py
@@ -22,16 +22,16 @@
 
 sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
 
+from benchmarks.perception.ground_truth import GroundTruth
+from benchmarks.perception.testset import _discover_volumes
 from gently.core.event_bus import EventBus, EventType
 from gently.core.imaging import (
+    apply_crop_bounds,
+    compute_crop_bounds,
     load_volume,
     projection_three_view,
-    compute_crop_bounds,
-    apply_crop_bounds,
 )
 from gently.settings import settings
-from benchmarks.perception.testset import _discover_volumes
-from benchmarks.perception.ground_truth import GroundTruth
 
 # Benchmark data paths
 REPO_ROOT = Path(__file__).resolve().parents[1]
@@ -44,7 +44,9 @@ def _find_main_worktree() -> Path:
     try:
         out = subprocess.check_output(
             ["git", "worktree", "list", "--porcelain"],
-            cwd=str(REPO_ROOT), text=True, stderr=subprocess.DEVNULL,
+            cwd=str(REPO_ROOT),
+            text=True,
+            stderr=subprocess.DEVNULL,
         )
         for line in out.splitlines():
             if line.startswith("worktree "):
@@ -134,7 +136,11 @@ async def run(
 
     event_bus.publish(
         EventType.ACQUISITION_STARTED,
-        {"session_id": session_id, "embryo_ids": sorted(all_vols.keys()), "total_timepoints": max_tp},
+        {
+            "session_id": session_id,
+            "embryo_ids": sorted(all_vols.keys()),
+            "total_timepoints": max_tp,
+        },
         source="demo",
     )
 
@@ -176,7 +182,11 @@ async def run(
             )
 
             pushed += 1
-            print(f"\r  [{pushed}/{total}] {eid} t={t} [{stage or '?'}]", end="", flush=True)
+            print(
+                f"\r  [{pushed}/{total}] {eid} t={t} [{stage or '?'}]",
+                end="",
+                flush=True,
+            )
 
             if actual_delay:
                 await asyncio.sleep(actual_delay)
@@ -197,9 +207,13 @@ async def run(
 def main():
     parser = argparse.ArgumentParser(description="Launch viz server with benchmark data")
     parser.add_argument("--port", type=int, default=settings.network.viz_port)
-    parser.add_argument("--delay", type=float, default=1.0, help="Seconds between pushes (default 1)")
+    parser.add_argument(
+        "--delay", type=float, default=1.0, help="Seconds between pushes (default 1)"
+    )
     parser.add_argument("--fast", action="store_true", help="Push all data immediately, then serve")
-    parser.add_argument("--timepoints", type=int, default=0, help="Max timepoints per embryo (0=all)")
+    parser.add_argument(
+        "--timepoints", type=int, default=0, help="Max timepoints per embryo (0=all)"
+    )
     parser.add_argument("--embryos", nargs="+", default=None, help="Specific embryo IDs")
     parser.add_argument("--volumes", type=str, default=None, help="Path to volumes dir")
     parser.add_argument("--ground-truth", type=str, default=None, help="Path to ground truth JSON")
@@ -218,15 +232,17 @@ def main():
     gt_path = Path(args.ground_truth) if args.ground_truth else _resolve_data_path(_GT_REL)
 
     try:
-        asyncio.run(run(
-            port=args.port,
-            delay=args.delay,
-            max_timepoints=args.timepoints,
-            embryo_ids=args.embryos,
-            fast=args.fast,
-            volumes_dir=volumes_dir,
-            gt_path=gt_path,
-        ))
+        asyncio.run(
+            run(
+                port=args.port,
+                delay=args.delay,
+                max_timepoints=args.timepoints,
+                embryo_ids=args.embryos,
+                fast=args.fast,
+                volumes_dir=volumes_dir,
+                gt_path=gt_path,
+            )
+        )
     except KeyboardInterrupt:
         pass
 
diff --git a/scripts/projection_explorer.py b/scripts/projection_explorer.py
index 88700941..88319905 100644
--- a/scripts/projection_explorer.py
+++ b/scripts/projection_explorer.py
@@ -29,13 +29,12 @@
 import base64
 import io
 import json
+import socketserver
 import sys
 from datetime import datetime
-from http.server import HTTPServer, BaseHTTPRequestHandler
+from http.server import BaseHTTPRequestHandler, HTTPServer
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple, Callable
 from urllib.parse import parse_qs, urlparse
-import socketserver
 
 import numpy as np
 from scipy import ndimage
@@ -52,6 +51,7 @@ def ensure_dependencies():
 
     try:
         import tifffile as _tifffile
+
         tifffile = _tifffile
     except ImportError:
         print("ERROR: tifffile required. Install: pip install tifffile")
@@ -59,15 +59,17 @@ def ensure_dependencies():
 
     try:
         from PIL import Image as _Image
+
         PIL_Image = _Image
     except ImportError:
         print("ERROR: Pillow required. Install: pip install Pillow")
         sys.exit(1)
 
     try:
-        import matplotlib.pyplot as _plt
         import matplotlib
-        matplotlib.use('Agg')  # Non-interactive backend
+        import matplotlib.pyplot as _plt
+
+        matplotlib.use("Agg")  # Non-interactive backend
         plt = _plt
     except ImportError:
         print("WARNING: matplotlib not available, some features disabled")
@@ -78,7 +80,8 @@ def ensure_dependencies():
 # Volume Loading
 # =============================================================================
 
-def discover_volumes(session_dir: Path, embryo_id: Optional[str] = None) -> Dict[str, List[Path]]:
+
+def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict[str, list[Path]]:
     """Discover volume files in a session directory."""
     if not session_dir.exists():
         return {}
@@ -110,7 +113,7 @@ def discover_volumes(session_dir: Path, embryo_id: Optional[str] = None) -> Dict
     return result
 
 
-def load_volume(path: Path, crop_bounds: Optional[Tuple[int, int, int, int]] = None) -> np.ndarray:
+def load_volume(path: Path, crop_bounds: tuple[int, int, int, int] | None = None) -> np.ndarray:
     """Load a volume from TIFF file, extract View A, and optionally apply crop bounds."""
     vol = tifffile.imread(str(path))
     vol = np.squeeze(vol)
@@ -119,7 +122,7 @@ def load_volume(path: Path, crop_bounds: Optional[Tuple[int, int, int, int]] = N
         z_depth, height, width = vol.shape
         # Extract View A (left half) if dual-view format
         if width > height * 2:
-            vol = vol[:, :, :width // 2]
+            vol = vol[:, :, : width // 2]
 
         # Apply crop bounds if provided
         if crop_bounds is not None:
@@ -132,6 +135,7 @@ def load_volume(path: Path, crop_bounds: Optional[Tuple[int, int, int, int]] = N
 # Image Utilities
 # =============================================================================
 
+
 def normalize_image(img: np.ndarray, p_low: float = 1, p_high: float = 99) -> np.ndarray:
     """Normalize image to 0-255 uint8 using percentile scaling."""
     img = img.astype(np.float32)
@@ -147,8 +151,8 @@ def normalize_image(img: np.ndarray, p_low: float = 1, p_high: float = 99) -> np
 def image_to_base64(img: np.ndarray, format: str = "JPEG", quality: int = 90) -> str:
     """Convert numpy array to base64-encoded image."""
     pil_img = PIL_Image.fromarray(img)
-    if pil_img.mode not in ('RGB', 'RGBA'):
-        pil_img = pil_img.convert('RGB')
+    if pil_img.mode not in ("RGB", "RGBA"):
+        pil_img = pil_img.convert("RGB")
 
     buffer = io.BytesIO()
     pil_img.save(buffer, format=format, quality=quality)
@@ -168,7 +172,10 @@ def resize_to_height(img: np.ndarray, target_height: int) -> np.ndarray:
 # Auto-crop utilities
 # =============================================================================
 
-def find_content_bbox(img: np.ndarray, threshold_percentile: float = 10, padding: int = 20) -> Tuple[int, int, int, int]:
+
+def find_content_bbox(
+    img: np.ndarray, threshold_percentile: float = 10, padding: int = 20
+) -> tuple[int, int, int, int]:
     """
     Find bounding box of content (non-background) in image.
 
@@ -209,7 +216,9 @@ def auto_crop(img: np.ndarray, threshold_percentile: float = 10, padding: int =
     return img[y_min:y_max, x_min:x_max]
 
 
-def compute_crop_bounds(volume: np.ndarray, padding: int = 20, sigma_mult: float = 3.5) -> Tuple[int, int, int, int]:
+def compute_crop_bounds(
+    volume: np.ndarray, padding: int = 20, sigma_mult: float = 3.5
+) -> tuple[int, int, int, int]:
     """
     Compute crop bounds for 3D volume using center-of-mass of bright pixels.
 
@@ -245,7 +254,7 @@ def compute_crop_bounds(volume: np.ndarray, padding: int = 20, sigma_mult: float
     return (y_min, y_max, x_min, x_max)
 
 
-def apply_crop_bounds(volume: np.ndarray, bounds: Tuple[int, int, int, int]) -> np.ndarray:
+def apply_crop_bounds(volume: np.ndarray, bounds: tuple[int, int, int, int]) -> np.ndarray:
     """Apply pre-computed crop bounds to a volume."""
     y_min, y_max, x_min, x_max = bounds
     # Clamp to actual volume dimensions
@@ -260,6 +269,7 @@ def apply_crop_bounds(volume: np.ndarray, bounds: Tuple[int, int, int, int]) ->
 # Projection Methods
 # =============================================================================
 
+
 def find_outer_boundary(img: np.ndarray, percentile: float = 50) -> np.ndarray:
     """
     Find outer boundary of embryo by thresholding and extracting mask edge.
@@ -271,17 +281,27 @@ def find_outer_boundary(img: np.ndarray, percentile: float = 50) -> np.ndarray:
     mask = img > thresh
 
     # Vectorized erosion: pixel is 1 only if all neighbors are 1
-    padded = np.pad(mask, 1, mode='constant', constant_values=True)
-    eroded = (padded[:-2, :-2] & padded[:-2, 1:-1] & padded[:-2, 2:] &
-              padded[1:-1, :-2] & padded[1:-1, 1:-1] & padded[1:-1, 2:] &
-              padded[2:, :-2] & padded[2:, 1:-1] & padded[2:, 2:])
+    padded = np.pad(mask, 1, mode="constant", constant_values=True)
+    eroded = (
+        padded[:-2, :-2]
+        & padded[:-2, 1:-1]
+        & padded[:-2, 2:]
+        & padded[1:-1, :-2]
+        & padded[1:-1, 1:-1]
+        & padded[1:-1, 2:]
+        & padded[2:, :-2]
+        & padded[2:, 1:-1]
+        & padded[2:, 2:]
+    )
 
     # Boundary = mask AND NOT eroded
     boundary = (mask & ~eroded).astype(np.uint8) * 255
     return boundary
 
 
-def overlay_edges(img: np.ndarray, edges: np.ndarray, color: Tuple[int, int, int] = (255, 200, 0)) -> np.ndarray:
+def overlay_edges(
+    img: np.ndarray, edges: np.ndarray, color: tuple[int, int, int] = (255, 200, 0)
+) -> np.ndarray:
     """Overlay edge contours on image in specified color."""
     if img.ndim == 2:
         rgb = np.stack([img, img, img], axis=-1)
@@ -294,7 +314,7 @@ def overlay_edges(img: np.ndarray, edges: np.ndarray, color: Tuple[int, int, int
     return rgb
 
 
-def projection_dual_view(volume: np.ndarray) -> Tuple[np.ndarray, str]:
+def projection_dual_view(volume: np.ndarray) -> tuple[np.ndarray, str]:
     """
     Dual-view projection: TOP above, SIDE below, sharing X axis.
     Includes embryo boundary overlay using Canny edge detection.
@@ -341,7 +361,7 @@ def projection_dual_view(volume: np.ndarray) -> Tuple[np.ndarray, str]:
     return combined, "Dual-view MIP with boundary: TOP (XY) above, SIDE (XZ) below"
 
 
-def projection_depth_colored(volume: np.ndarray, colormap: str = 'turbo') -> Tuple[np.ndarray, str]:
+def projection_depth_colored(volume: np.ndarray, colormap: str = "turbo") -> tuple[np.ndarray, str]:
     """
     Depth-colored max intensity projection with side view.
 
@@ -407,7 +427,7 @@ def projection_depth_colored(volume: np.ndarray, colormap: str = 'turbo') -> Tup
     return combined, f"Z-depth colored MIP ({colormap}): TOP + SIDE views"
 
 
-def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> Tuple[np.ndarray, str]:
+def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> tuple[np.ndarray, str]:
     """
     Montage of N representative z-slices.
 
@@ -439,7 +459,7 @@ def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> Tuple[np.nd
     # Build montage
     rows = []
     for r in range(n_rows):
-        row_slices = slices[r * n_cols:(r + 1) * n_cols]
+        row_slices = slices[r * n_cols : (r + 1) * n_cols]
         # Add thin separator between slices
         sep = np.ones((height, 2), dtype=np.uint8) * 64
         row_with_sep = []
@@ -458,7 +478,7 @@ def projection_multi_slice(volume: np.ndarray, n_slices: int = 6) -> Tuple[np.nd
     return montage, f"Multi-slice montage ({n_slices} slices: {z_labels})"
 
 
-def projection_subvolume(volume: np.ndarray) -> Tuple[np.ndarray, str]:
+def projection_subvolume(volume: np.ndarray) -> tuple[np.ndarray, str]:
     """
     Sub-volume projections: top third, middle third, bottom third.
 
@@ -481,18 +501,33 @@ def projection_subvolume(volume: np.ndarray) -> Tuple[np.ndarray, str]:
     bot_vol = volume[z2:]
 
     # Project each
-    top_proj = normalize_image(np.max(top_vol, axis=0)) if top_vol.size > 0 else np.zeros((height, width), dtype=np.uint8)
-    mid_proj = normalize_image(np.max(mid_vol, axis=0)) if mid_vol.size > 0 else np.zeros((height, width), dtype=np.uint8)
-    bot_proj = normalize_image(np.max(bot_vol, axis=0)) if bot_vol.size > 0 else np.zeros((height, width), dtype=np.uint8)
+    top_proj = (
+        normalize_image(np.max(top_vol, axis=0))
+        if top_vol.size > 0
+        else np.zeros((height, width), dtype=np.uint8)
+    )
+    mid_proj = (
+        normalize_image(np.max(mid_vol, axis=0))
+        if mid_vol.size > 0
+        else np.zeros((height, width), dtype=np.uint8)
+    )
+    bot_proj = (
+        normalize_image(np.max(bot_vol, axis=0))
+        if bot_vol.size > 0
+        else np.zeros((height, width), dtype=np.uint8)
+    )
 
     # Combine horizontally with labels
     sep = np.ones((height, 4), dtype=np.uint8) * 128
     combined = np.concatenate([top_proj, sep, mid_proj, sep, bot_proj], axis=1)
 
-    return combined, f"Sub-volume MIPs: TOP (z=0-{z1}) | MID (z={z1}-{z2}) | BOT (z={z2}-{z_depth})"
+    return (
+        combined,
+        f"Sub-volume MIPs: TOP (z=0-{z1}) | MID (z={z1}-{z2}) | BOT (z={z2}-{z_depth})",
+    )
 
 
-def projection_three_view(volume: np.ndarray) -> Tuple[np.ndarray, str]:
+def projection_three_view(volume: np.ndarray) -> tuple[np.ndarray, str]:
     """
     Three orthogonal views with proper axis alignment:
 
@@ -562,8 +597,9 @@ def projection_three_view(volume: np.ndarray) -> Tuple[np.ndarray, str]:
     return combined, "Three-view: [XY|YZ] top, [XZ] bottom - axes aligned"
 
 
-def render_volume_rotated_v2(volume: np.ndarray, angle_y: float, angle_x: float = -0.5,
-                              threshold: float = 0.12) -> np.ndarray:
+def render_volume_rotated_v2(
+    volume: np.ndarray, angle_y: float, angle_x: float = -0.5, threshold: float = 0.12
+) -> np.ndarray:
     """
     Render volume by actually rotating it in 3D, then projecting.
     Uses scipy.ndimage.rotate for true 3D rotation.
@@ -581,11 +617,19 @@ def render_volume_rotated_v2(volume: np.ndarray, angle_y: float, angle_x: float
 
     # Rotate around Y axis (rotation in XZ plane, axis 1 is Y)
     # axes=(2, 0) means rotate in the X-Z plane
-    rotated = rotate(vol, angle_y_deg, axes=(2, 0), reshape=False, order=1, mode='constant', cval=0)
+    rotated = rotate(vol, angle_y_deg, axes=(2, 0), reshape=False, order=1, mode="constant", cval=0)
 
     # Rotate around X axis (rotation in YZ plane)
     # axes=(1, 0) means rotate in the Y-Z plane
-    rotated = rotate(rotated, angle_x_deg, axes=(1, 0), reshape=False, order=1, mode='constant', cval=0)
+    rotated = rotate(
+        rotated,
+        angle_x_deg,
+        axes=(1, 0),
+        reshape=False,
+        order=1,
+        mode="constant",
+        cval=0,
+    )
 
     # Now do alpha-blended projection along Z (front to back would be back to front after rotation)
     z_depth, height, width = rotated.shape
@@ -609,9 +653,14 @@ def render_volume_rotated_v2(volume: np.ndarray, angle_y: float, angle_x: float
     return result
 
 
-def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -0.5,
-                           threshold: float = 0.12, num_slices: int = 48,
-                           perspective: float = 0.4) -> np.ndarray:
+def render_volume_rotated(
+    volume: np.ndarray,
+    angle_y: float,
+    angle_x: float = -0.5,
+    threshold: float = 0.12,
+    num_slices: int = 48,
+    perspective: float = 0.4,
+) -> np.ndarray:
     """
     Render volume from a rotated viewpoint with parallax and perspective.
 
@@ -680,23 +729,25 @@ def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -
         perspective_scale = 1.0 + (depth_after_rotation * perspective * 1.5 / z_scale)
         perspective_scale = np.clip(perspective_scale, 0.5, 1.5)
 
-        slice_data_list.append({
-            'z_idx': z_idx,
-            'shift_x': shift_x,
-            'shift_y': shift_y,
-            'depth': depth_after_rotation,
-            'scale': perspective_scale,
-        })
+        slice_data_list.append(
+            {
+                "z_idx": z_idx,
+                "shift_x": shift_x,
+                "shift_y": shift_y,
+                "depth": depth_after_rotation,
+                "scale": perspective_scale,
+            }
+        )
 
     # Sort by depth (back to front for proper alpha compositing)
-    slice_data_list.sort(key=lambda s: s['depth'])
+    slice_data_list.sort(key=lambda s: s["depth"])
 
     # Composite slices
     for slice_info in slice_data_list:
-        z_idx = slice_info['z_idx']
-        shift_x = slice_info['shift_x']
-        shift_y = slice_info['shift_y']
-        scale = slice_info['scale']
+        z_idx = slice_info["z_idx"]
+        shift_x = slice_info["shift_x"]
+        shift_y = slice_info["shift_y"]
+        scale = slice_info["scale"]
 
         # Get slice
         slice_img = vol[z_idx, :, :]
@@ -746,8 +797,8 @@ def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -
         # Alpha composite
         for c in range(3):
             result[dst_y_start:dst_y_end, dst_x_start:dst_x_end, c] = (
-                src_slice * src_alpha +
-                result[dst_y_start:dst_y_end, dst_x_start:dst_x_end, c] * (1 - src_alpha)
+                src_slice * src_alpha
+                + result[dst_y_start:dst_y_end, dst_x_start:dst_x_end, c] * (1 - src_alpha)
             )
 
     # Crop to content (remove empty margins)
@@ -771,7 +822,7 @@ def render_volume_rotated(volume: np.ndarray, angle_y: float, angle_x: float = -
     return result
 
 
-def projection_spin_3d(volume: np.ndarray) -> Tuple[np.ndarray, str]:
+def projection_spin_3d(volume: np.ndarray) -> tuple[np.ndarray, str]:
     """
     Multiple 3D perspective views from different angles.
 
@@ -793,7 +844,6 @@ def projection_spin_3d(volume: np.ndarray) -> Tuple[np.ndarray, str]:
     # Different rotation angles around Y axis (horizontal spin)
     # 6 views: front, 60°, 120°, 180° (back), 240°, 300°
     angles_y = [-0.05, 0.5, 1.0, 1.57, 2.1, 2.6]
-    labels = ["front", "60°", "120°", "back", "240°", "300°"]
 
     views = []
     for angle_y in angles_y:
@@ -802,7 +852,7 @@ def projection_spin_3d(volume: np.ndarray) -> Tuple[np.ndarray, str]:
             angle_y=angle_y,
             angle_x=base_tilt,
             threshold=py_threshold,
-            perspective=0.5
+            perspective=0.5,
         )
         views.append(view)
 
@@ -818,10 +868,10 @@ def projection_spin_3d(volume: np.ndarray) -> Tuple[np.ndarray, str]:
         pad_w = (target_w - w) // 2
         if v.ndim == 3:
             p = np.zeros((target_h, target_w, 3), dtype=v.dtype)
-            p[pad_h:pad_h+h, pad_w:pad_w+w] = v
+            p[pad_h : pad_h + h, pad_w : pad_w + w] = v
         else:
             p = np.zeros((target_h, target_w), dtype=v.dtype)
-            p[pad_h:pad_h+h, pad_w:pad_w+w] = v
+            p[pad_h : pad_h + h, pad_w : pad_w + w] = v
         padded.append(p)
 
     # Create 2x3 grid
@@ -834,12 +884,12 @@ def projection_spin_3d(volume: np.ndarray) -> Tuple[np.ndarray, str]:
 
 # Registry of available projection methods
 PROJECTION_METHODS = {
-    'dual_view': projection_dual_view,
-    'depth_colored': projection_depth_colored,
-    'multi_slice': projection_multi_slice,
-    'subvolume': projection_subvolume,
-    'three_view': projection_three_view,
-    'spin_3d': projection_spin_3d,
+    "dual_view": projection_dual_view,
+    "depth_colored": projection_depth_colored,
+    "multi_slice": projection_multi_slice,
+    "subvolume": projection_subvolume,
+    "three_view": projection_three_view,
+    "spin_3d": projection_spin_3d,
 }
 
 
@@ -847,6 +897,7 @@ def projection_spin_3d(volume: np.ndarray) -> Tuple[np.ndarray, str]:
 # Session Manager
 # =============================================================================
 
+
 class SessionManager:
     """Manages volume data for a session with aggressive caching."""
 
@@ -864,11 +915,11 @@ def __init__(self, session_path: Path):
             self.current_embryo = sorted(self.embryo_volumes.keys())[0]
 
     @property
-    def embryo_list(self) -> List[str]:
+    def embryo_list(self) -> list[str]:
         return sorted(self.embryo_volumes.keys())
 
     @property
-    def current_volumes(self) -> List[Path]:
+    def current_volumes(self) -> list[Path]:
         if self.current_embryo:
             return self.embryo_volumes.get(self.current_embryo, [])
         return []
@@ -882,7 +933,7 @@ def switch_embryo(self, embryo_id: str):
             self.current_embryo = embryo_id
             self.current_idx = 0
 
-    def _get_crop_bounds(self) -> Optional[Tuple[int, int, int, int]]:
+    def _get_crop_bounds(self) -> tuple[int, int, int, int] | None:
         """Get or compute crop bounds for current embryo (computed from first volume)."""
         if self.current_embryo is None:
             return None
@@ -899,16 +950,19 @@ def _get_crop_bounds(self) -> Optional[Tuple[int, int, int, int]]:
             if vol.ndim == 3:
                 z_depth, height, width = vol.shape
                 if width > height * 2:
-                    vol = vol[:, :, :width // 2]
+                    vol = vol[:, :, : width // 2]
 
             bounds = compute_crop_bounds(vol, padding=20)
             self._crop_bounds[self.current_embryo] = bounds
             print(f"[ROI] Computed crop bounds for {self.current_embryo}: {bounds}")
-            print(f"[ROI] Original volume shape: {vol.shape}, cropped region: {bounds[1]-bounds[0]}x{bounds[3]-bounds[2]}")
+            print(
+                f"[ROI] Original volume shape: {vol.shape}, cropped region:"
+                f" {bounds[1] - bounds[0]}x{bounds[3] - bounds[2]}"
+            )
 
         return self._crop_bounds[self.current_embryo]
 
-    def get_volume(self, idx: int) -> Optional[np.ndarray]:
+    def get_volume(self, idx: int) -> np.ndarray | None:
         """Load volume at index, with caching and stable crop bounds."""
         volumes = self.current_volumes
         if not volumes or idx < 0 or idx >= len(volumes):
@@ -923,7 +977,7 @@ def get_volume(self, idx: int) -> Optional[np.ndarray]:
                 for k in self._volume_cache:
                     if k[0] != self.current_embryo or abs(k[1] - idx) > 10:
                         keys_to_remove.append(k)
-                for k in keys_to_remove[:len(self._volume_cache) - self._cache_size // 2]:
+                for k in keys_to_remove[: len(self._volume_cache) - self._cache_size // 2]:
                     del self._volume_cache[k]
 
             # Get stable crop bounds for this embryo
@@ -934,7 +988,7 @@ def get_volume(self, idx: int) -> Optional[np.ndarray]:
 
         return self._volume_cache[cache_key]
 
-    def get_projection(self, idx: int, method: str) -> Optional[Tuple[np.ndarray, str]]:
+    def get_projection(self, idx: int, method: str) -> tuple[np.ndarray, str] | None:
         """Get cached projection or compute it."""
         cache_key = (self.current_embryo, idx, method)
 
@@ -958,10 +1012,10 @@ def get_projection(self, idx: int, method: str) -> Optional[Tuple[np.ndarray, st
 
         return self._projection_cache[cache_key]
 
-    def get_current_volume(self) -> Optional[np.ndarray]:
+    def get_current_volume(self) -> np.ndarray | None:
         return self.get_volume(self.current_idx)
 
-    def get_current_path(self) -> Optional[Path]:
+    def get_current_path(self) -> Path | None:
         volumes = self.current_volumes
         if volumes and 0 <= self.current_idx < len(volumes):
             return volumes[self.current_idx]
@@ -978,11 +1032,12 @@ def preload_adjacent(self, idx: int, radius: int = 2):
 # Web UI Server
 # =============================================================================
 
+
 class ExplorerHandler(BaseHTTPRequestHandler):
     """HTTP handler for projection explorer."""
 
     session_manager: SessionManager = None
-    current_methods: List[str] = ['dual_view', 'depth_colored']
+    current_methods: list[str] = ["dual_view", "depth_colored"]
     current_z_slice: int = 0  # For 3D volume viewer
 
     def log_message(self, format, *args):
@@ -1001,7 +1056,9 @@ def do_GET(self):
             elif parsed.path.startswith("/api/goto"):
                 params = parse_qs(parsed.query)
                 idx = int(params.get("idx", [0])[0])
-                self.session_manager.current_idx = max(0, min(idx, self.session_manager.total_timepoints - 1))
+                self.session_manager.current_idx = max(
+                    0, min(idx, self.session_manager.total_timepoints - 1)
+                )
                 self.send_projections()
             elif parsed.path.startswith("/api/embryo"):
                 params = parse_qs(parsed.query)
@@ -1013,7 +1070,9 @@ def do_GET(self):
                 methods = params.get("m", [])
                 if methods:
                     # Update class variable, not instance variable
-                    ExplorerHandler.current_methods = [m for m in methods if m in PROJECTION_METHODS]
+                    ExplorerHandler.current_methods = [
+                        m for m in methods if m in PROJECTION_METHODS
+                    ]
                 self.send_projections()
             elif parsed.path.startswith("/api/zslice"):
                 params = parse_qs(parsed.query)
@@ -1041,17 +1100,19 @@ def send_status(self):
         volume = sm.get_current_volume()
         z_depth = volume.shape[0] if volume is not None and volume.ndim == 3 else 0
         crop_bounds = sm._crop_bounds.get(sm.current_embryo) if sm.current_embryo else None
-        self.send_json({
-            "session": sm.session_path.name,
-            "embryos": sm.embryo_list,
-            "current_embryo": sm.current_embryo,
-            "total": sm.total_timepoints,
-            "idx": sm.current_idx,
-            "methods": list(PROJECTION_METHODS.keys()),
-            "active_methods": ExplorerHandler.current_methods,
-            "z_depth": z_depth,
-            "crop_bounds": crop_bounds,
-        })
+        self.send_json(
+            {
+                "session": sm.session_path.name,
+                "embryos": sm.embryo_list,
+                "current_embryo": sm.current_embryo,
+                "total": sm.total_timepoints,
+                "idx": sm.current_idx,
+                "methods": list(PROJECTION_METHODS.keys()),
+                "active_methods": ExplorerHandler.current_methods,
+                "z_depth": z_depth,
+                "crop_bounds": crop_bounds,
+            }
+        )
 
     def send_zslice(self, z: int):
         sm = self.session_manager
@@ -1071,11 +1132,13 @@ def send_zslice(self, z: int):
         # Convert to RGB
         slice_rgb = np.stack([slice_norm, slice_norm, slice_norm], axis=-1)
 
-        self.send_json({
-            "z": z,
-            "z_depth": z_depth,
-            "data": image_to_base64(slice_rgb),
-        })
+        self.send_json(
+            {
+                "z": z,
+                "z_depth": z_depth,
+                "data": image_to_base64(slice_rgb),
+            }
+        )
 
     def send_volume(self):
         """Send full volume as base64 for 3D rendering."""
@@ -1101,10 +1164,12 @@ def send_volume(self):
         vol_bytes = vol_uint8.tobytes()
         vol_b64 = base64.b64encode(vol_bytes).decode()
 
-        self.send_json({
-            "shape": [z, h, w],
-            "data": vol_b64,
-        })
+        self.send_json(
+            {
+                "shape": [z, h, w],
+                "data": vol_b64,
+            }
+        )
 
     def send_projections(self):
         sm = self.session_manager
@@ -1119,11 +1184,13 @@ def send_projections(self):
             result = sm.get_projection(idx, method_name)
             if result:
                 img, desc = result
-                projections.append({
-                    "method": method_name,
-                    "description": desc,
-                    "data": image_to_base64(img),
-                })
+                projections.append(
+                    {
+                        "method": method_name,
+                        "description": desc,
+                        "data": image_to_base64(img),
+                    }
+                )
 
         if not projections:
             self.send_json({"error": "No volume loaded"})
@@ -1133,18 +1200,21 @@ def send_projections(self):
         volume = sm.get_current_volume()
         volume_shape = list(volume.shape) if volume is not None else []
 
-        self.send_json({
-            "idx": idx,
-            "total": sm.total_timepoints,
-            "filename": path.name if path else "",
-            "embryo": sm.current_embryo,
-            "embryo_list": sm.embryo_list,
-            "projections": projections,
-            "volume_shape": volume_shape,
-        })
+        self.send_json(
+            {
+                "idx": idx,
+                "total": sm.total_timepoints,
+                "filename": path.name if path else "",
+                "embryo": sm.current_embryo,
+                "embryo_list": sm.embryo_list,
+                "projections": projections,
+                "volume_shape": volume_shape,
+            }
+        )
 
         # Preload adjacent volumes in background
         import threading
+
         threading.Thread(target=sm.preload_adjacent, args=(idx,), daemon=True).start()
 
     def send_html(self):
@@ -1316,10 +1386,13 @@ def send_html(self):
 
             <div class="nav-controls">
                 <button onclick="prev()">← Prev</button>
-                <input type="range" class="slider" id="slider" min="0" max="100" value="0" oninput="debouncedGoto(this.value)">
+                <input type="range" class="slider" id="slider" min="0" max="100"
+                  value="0" oninput="debouncedGoto(this.value)">
                 <button onclick="next()">Next →</button>
                 <span class="position" id="position">0 / 0</span>
-                <span class="stage-label" id="stage-label" style="margin-left:12px;padding:2px 8px;background:#238636;border-radius:4px;font-weight:bold;"></span>
+                <span class="stage-label" id="stage-label"
+                  style="margin-left:12px;padding:2px 8px;background:#238636;
+                         border-radius:4px;font-weight:bold;"></span>
             </div>
         </div>
 
@@ -1335,10 +1408,17 @@ def send_html(self):
                 <div class="projection-title">3D Volume</div>
                 <div class="projection-desc">
                     Drag: X/Y | Shift+Drag: Z | Scroll: zoom |
-                    Threshold: <input type="range" id="thresh3d" min="0" max="100" value="30" style="width:80px;vertical-align:middle;">
-                    <span id="thresh-display" style="font-family:monospace;color:#58a6ff;min-width:35px;display:inline-block;">0.30</span>
-                    | <span id="angle-display" style="font-family:monospace;color:#58a6ff;">angle_y: 0.00, angle_x: 0.00, angle_z: 0.00</span>
-                    <button id="copy-angles-btn" onclick="copyAngles()" style="margin-left:8px;padding:2px 8px;font-size:11px;cursor:pointer;background:#21262d;border:1px solid #30363d;color:#c9d1d9;border-radius:4px;">Copy</button>
+                    Threshold: <input type="range" id="thresh3d" min="0" max="100"
+                      value="30" style="width:80px;vertical-align:middle;">
+                    <span id="thresh-display"
+                      style="font-family:monospace;color:#58a6ff;min-width:35px;display:inline-block;">0.30</span>
+                    | <span id="angle-display"
+                      style="font-family:monospace;color:#58a6ff;"
+                      >angle_y: 0.00, angle_x: 0.00, angle_z: 0.00</span>
+                    <button id="copy-angles-btn" onclick="copyAngles()"
+                      style="margin-left:8px;padding:2px 8px;font-size:11px;cursor:pointer;
+                             background:#21262d;border:1px solid #30363d;
+                             color:#c9d1d9;border-radius:4px;">Copy</button>
                 </div>
             </div>
             <div id="viewer3d" style="height:400px;background:#000;"></div>
@@ -1358,13 +1438,19 @@ def send_html(self):
 
         // Ground truth stage transitions (from biologist annotations)
         const GROUND_TRUTH = {
-            "embryo_1": {"early": 0, "bean": 43, "comma": 49, "1.5fold": 55, "2fold": 70, "pretzel": 90},
-            "embryo_2": {"early": 0, "bean": 33, "comma": 39, "1.5fold": 45, "2fold": 60, "pretzel": 80},
-            "embryo_3": {"early": 0, "bean": 27, "comma": 33, "1.5fold": 39, "2fold": 50, "pretzel": 69},
-            "embryo_4": {"early": 0, "bean": 54, "comma": 60, "1.5fold": 69, "2fold": 77, "pretzel": 97}
+            "embryo_1": {"early": 0, "bean": 43, "comma": 49,
+                         "1.5fold": 55, "2fold": 70, "pretzel": 90},
+            "embryo_2": {"early": 0, "bean": 33, "comma": 39,
+                         "1.5fold": 45, "2fold": 60, "pretzel": 80},
+            "embryo_3": {"early": 0, "bean": 27, "comma": 33,
+                         "1.5fold": 39, "2fold": 50, "pretzel": 69},
+            "embryo_4": {"early": 0, "bean": 54, "comma": 60,
+                         "1.5fold": 69, "2fold": 77, "pretzel": 97}
         };
 
-        const STAGE_ORDER = ["early", "bean", "comma", "1.5fold", "2fold", "pretzel", "hatching", "hatched"];
+        const STAGE_ORDER = [
+            "early", "bean", "comma", "1.5fold", "2fold", "pretzel", "hatching", "hatched"
+        ];
         const STAGE_COLORS = {
             "early": "#6e7681",
             "bean": "#8b5cf6",
@@ -1450,7 +1536,8 @@ def send_html(self):
             toggles.innerHTML = '';
             data.methods.forEach((m, i) => {
                 const btn = document.createElement('button');
-                btn.className = 'method-toggle' + (data.active_methods.includes(m) ? ' active' : '');
+                btn.className = 'method-toggle'
+                    + (data.active_methods.includes(m) ? ' active' : '');
                 btn.textContent = (i + 1) + ': ' + m;
                 btn.onclick = () => toggleMethod(m);
                 toggles.appendChild(btn);
@@ -1495,7 +1582,10 @@ def send_html(self):
                         <div class="projection-title">${proj.method}</div>
                         <div class="projection-desc">
                             <span id="${descId}">${proj.description}</span>
-                            <button onclick="copyText('${descId}')" style="margin-left:8px;padding:2px 8px;font-size:11px;cursor:pointer;background:#21262d;border:1px solid #30363d;color:#c9d1d9;border-radius:4px;">Copy</button>
+                            <button onclick="copyText('${descId}')"
+                              style="margin-left:8px;padding:2px 8px;font-size:11px;
+                                     cursor:pointer;background:#21262d;border:1px solid #30363d;
+                                     color:#c9d1d9;border-radius:4px;">Copy</button>
                         </div>
                     </div>
                     <div class="projection-image">
@@ -1654,7 +1744,9 @@ def send_html(self):
                 const zIndex = Math.floor(i * zd / numSlices);
                 const zPos = (i / numSlices - 0.5) * zScale;
                 const tex = createSliceTex(zIndex, threshold);
-                const mat = new THREE.MeshBasicMaterial({ map: tex, transparent: true, side: THREE.DoubleSide, depthWrite: false });
+                const mat = new THREE.MeshBasicMaterial({
+                    map: tex, transparent: true, side: THREE.DoubleSide, depthWrite: false
+                });
                 const geo = new THREE.PlaneGeometry(1, 1 / aspect);
                 const mesh = new THREE.Mesh(geo, mat);
                 mesh.position.z = zPos;
@@ -1751,7 +1843,8 @@ def send_html(self):
             document.getElementById('thresh3d').addEventListener('input', (e) => {
                 const threshVal = parseInt(e.target.value);
                 buildSlices3d(32, threshVal);
-                document.getElementById('thresh-display').textContent = (threshVal / 100).toFixed(2);
+                document.getElementById('thresh-display').textContent =
+                    (threshVal / 100).toFixed(2);
             });
 
             renderer3d.domElement.addEventListener('mousedown', (e) => {
@@ -1784,7 +1877,8 @@ def send_html(self):
             });
             renderer3d.domElement.addEventListener('wheel', (e) => {
                 e.preventDefault();
-                camera3d.position.z = Math.max(0.5, Math.min(5, camera3d.position.z + e.deltaY * 0.002));
+                camera3d.position.z =
+                    Math.max(0.5, Math.min(5, camera3d.position.z + e.deltaY * 0.002));
                 savedZoom = camera3d.position.z;
             });
 
@@ -1978,7 +2072,9 @@ def send_3d_viewer(self):
             const [zd, h, w] = volumeShape;
 
             scene = new THREE.Scene();
-            camera = new THREE.PerspectiveCamera(50, window.innerWidth / window.innerHeight, 0.1, 100);
+            camera = new THREE.PerspectiveCamera(
+                50, window.innerWidth / window.innerHeight, 0.1, 100
+            );
             camera.position.z = 2.5;
 
             renderer = new THREE.WebGLRenderer({ antialias: true });
@@ -2059,6 +2155,7 @@ class ThreadedHTTPServer(socketserver.ThreadingMixIn, HTTPServer):
 # Main
 # =============================================================================
 
+
 def main():
     parser = argparse.ArgumentParser(description="Projection Explorer")
     parser.add_argument("--session", required=True, help="Session ID")
@@ -2117,8 +2214,8 @@ def main():
 
                 # Save image
                 pil_img = PIL_Image.fromarray(img)
-                if pil_img.mode != 'RGB':
-                    pil_img = pil_img.convert('RGB')
+                if pil_img.mode != "RGB":
+                    pil_img = pil_img.convert("RGB")
 
                 filename = f"t{idx:04d}_{method_name}.jpg"
                 pil_img.save(output_dir / filename, quality=90)
@@ -2138,6 +2235,7 @@ def main():
 
     if not args.no_browser:
         import webbrowser
+
         webbrowser.open(url)
 
     try:
diff --git a/scripts/recreate_session_videos.py b/scripts/recreate_session_videos.py
index e725f56d..aa53a48e 100644
--- a/scripts/recreate_session_videos.py
+++ b/scripts/recreate_session_videos.py
@@ -28,9 +28,9 @@
 import logging
 import sys
 from dataclasses import dataclass, field
-from datetime import datetime, timedelta
+from datetime import datetime
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple
+from typing import Any
 
 import cv2
 import numpy as np
@@ -42,22 +42,22 @@
 # ---------------------------------------------------------------------------
 # Presentation palette — dark, projector-friendly. All BGR (cv2 native).
 # ---------------------------------------------------------------------------
-COL_BG          = (22, 17, 14)     # #0E1116 — main background
-COL_PANEL       = (38, 31, 26)     # #1A1F26 — card surface
-COL_PANEL_HI    = (64, 52, 45)     # #2D3440 — borders
-COL_TEXT        = (235, 233, 229)  # off-white primary
-COL_TEXT_DIM    = (175, 162, 156)  # secondary
-COL_ACCENT      = (250, 165, 96)   # sky blue (BGR)
-COL_DIVIDER     = (80, 70, 60)
+COL_BG = (22, 17, 14)  # #0E1116 — main background
+COL_PANEL = (38, 31, 26)  # #1A1F26 — card surface
+COL_PANEL_HI = (64, 52, 45)  # #2D3440 — borders
+COL_TEXT = (235, 233, 229)  # off-white primary
+COL_TEXT_DIM = (175, 162, 156)  # secondary
+COL_ACCENT = (250, 165, 96)  # sky blue (BGR)
+COL_DIVIDER = (80, 70, 60)
 
 # Cadence regimes — interval (seconds) → (label, BGR color, regime key)
-CADENCE_5MIN  = ("5 MIN", (137, 211, 52),  "5min")     # emerald (#34D399)
-CADENCE_1MIN  = ("1 MIN", (36, 191, 251),  "1min")     # amber (#FBBF24)
-CADENCE_BURST = ("BURST", (113, 113, 248), "burst")    # red (#F87171)
-CADENCE_OTHER = ("---",   (160, 160, 160), "other")
+CADENCE_5MIN = ("5 MIN", (137, 211, 52), "5min")  # emerald (#34D399)
+CADENCE_1MIN = ("1 MIN", (36, 191, 251), "1min")  # amber (#FBBF24)
+CADENCE_BURST = ("BURST", (113, 113, 248), "burst")  # red (#F87171)
+CADENCE_OTHER = ("---", (160, 160, 160), "other")
 
 
-def cadence_for_interval(interval_s: float) -> Tuple[str, Tuple[int, int, int], str]:
+def cadence_for_interval(interval_s: float) -> tuple[str, tuple[int, int, int], str]:
     if interval_s <= 5.0:
         return CADENCE_BURST
     if interval_s <= 90.0:
@@ -75,17 +75,17 @@ class FrameRecord:
     timepoint: int
     jpg_path: Path
     acquired_at: datetime
-    role: Optional[str] = None
-    predicted_stage: Optional[str] = None
+    role: str | None = None
+    predicted_stage: str | None = None
     interval_to_next_s: float = 0.0  # filled later
     cadence_label: str = "---"
-    cadence_color: Tuple[int, int, int] = (160, 160, 160)
+    cadence_color: tuple[int, int, int] = (160, 160, 160)
 
 
 @dataclass
 class EmbryoData:
     embryo_id: str
-    frames: List[FrameRecord] = field(default_factory=list)
+    frames: list[FrameRecord] = field(default_factory=list)
 
 
 @dataclass
@@ -93,11 +93,11 @@ class BurstData:
     embryo_id: str
     request_id: str
     burst_dir: Path
-    manifest: Dict[str, Any] = field(default_factory=dict)
-    frames: List[FrameRecord] = field(default_factory=list)
+    manifest: dict[str, Any] = field(default_factory=dict)
+    frames: list[FrameRecord] = field(default_factory=list)
 
 
-def _read_meta(meta_path: Path) -> Dict:
+def _read_meta(meta_path: Path) -> dict:
     try:
         with meta_path.open("r", encoding="utf-8") as f:
             return yaml.safe_load(f) or {}
@@ -106,9 +106,9 @@ def _read_meta(meta_path: Path) -> Dict:
         return {}
 
 
-def _load_predictions(predictions_path: Path) -> Dict[int, str]:
+def _load_predictions(predictions_path: Path) -> dict[int, str]:
     """Map timepoint -> predicted_stage from predictions.jsonl (most-recent wins)."""
-    out: Dict[int, str] = {}
+    out: dict[int, str] = {}
     if not predictions_path.exists():
         return out
     with predictions_path.open("r", encoding="utf-8") as f:
@@ -127,7 +127,7 @@ def _load_predictions(predictions_path: Path) -> Dict[int, str]:
     return out
 
 
-def load_embryo(embryo_dir: Path, *, use_perception: bool = True) -> Optional[EmbryoData]:
+def load_embryo(embryo_dir: Path, *, use_perception: bool = True) -> EmbryoData | None:
     projections_dir = embryo_dir / "projections"
     volumes_dir = embryo_dir / "volumes"
     if not projections_dir.is_dir():
@@ -135,7 +135,7 @@ def load_embryo(embryo_dir: Path, *, use_perception: bool = True) -> Optional[Em
 
     predictions = _load_predictions(embryo_dir / "predictions.jsonl") if use_perception else {}
 
-    frames: List[FrameRecord] = []
+    frames: list[FrameRecord] = []
     for jpg in sorted(projections_dir.glob("t*.jpg")):
         stem = jpg.stem  # e.g. "t0003"
         try:
@@ -151,13 +151,15 @@ def load_embryo(embryo_dir: Path, *, use_perception: bool = True) -> Optional[Em
         else:
             acquired_at = datetime.fromisoformat(str(acquired_raw))
 
-        frames.append(FrameRecord(
-            timepoint=tp,
-            jpg_path=jpg,
-            acquired_at=acquired_at,
-            role=meta.get("metadata", {}).get("role"),
-            predicted_stage=predictions.get(tp),
-        ))
+        frames.append(
+            FrameRecord(
+                timepoint=tp,
+                jpg_path=jpg,
+                acquired_at=acquired_at,
+                role=meta.get("metadata", {}).get("role"),
+                predicted_stage=predictions.get(tp),
+            )
+        )
 
     if not frames:
         return None
@@ -185,7 +187,7 @@ def _looks_like_full_session(path: Path) -> bool:
     return path.is_dir() and (path / "session.yaml").exists() and (path / "embryos").is_dir()
 
 
-def load_burst(burst_dir: Path) -> Optional[BurstData]:
+def load_burst(burst_dir: Path) -> BurstData | None:
     """Load one burst (request_id subfolder) from disk.
 
     Layout written by BurstAcquisition.run:
@@ -201,7 +203,7 @@ def load_burst(burst_dir: Path) -> Optional[BurstData]:
     if not proj_dir.is_dir():
         return None
 
-    manifest: Dict[str, Any] = {}
+    manifest: dict[str, Any] = {}
     manifest_path = burst_dir / "burst.yaml"
     if manifest_path.exists():
         try:
@@ -213,7 +215,7 @@ def load_burst(burst_dir: Path) -> Optional[BurstData]:
     embryo_id = manifest.get("embryo_id") or burst_dir.parent.parent.name
     request_id = manifest.get("request_id") or burst_dir.name
 
-    frames: List[FrameRecord] = []
+    frames: list[FrameRecord] = []
     for jpg in sorted(proj_dir.glob("t*.jpg")):
         stem = jpg.stem
         try:
@@ -226,13 +228,15 @@ def load_burst(burst_dir: Path) -> Optional[BurstData]:
             acquired_at = datetime.fromisoformat(str(acquired_raw))
         else:
             acquired_at = datetime.fromtimestamp(jpg.stat().st_mtime)
-        frames.append(FrameRecord(
-            timepoint=idx,
-            jpg_path=jpg,
-            acquired_at=acquired_at,
-            role="burst",
-            predicted_stage=None,
-        ))
+        frames.append(
+            FrameRecord(
+                timepoint=idx,
+                jpg_path=jpg,
+                acquired_at=acquired_at,
+                role="burst",
+                predicted_stage=None,
+            )
+        )
 
     if not frames:
         return None
@@ -251,13 +255,18 @@ def load_burst(burst_dir: Path) -> Optional[BurstData]:
         fr.cadence_label = label
         fr.cadence_color = color
 
-    return BurstData(embryo_id=embryo_id, request_id=request_id,
-                     burst_dir=burst_dir, manifest=manifest, frames=frames)
+    return BurstData(
+        embryo_id=embryo_id,
+        request_id=request_id,
+        burst_dir=burst_dir,
+        manifest=manifest,
+        frames=frames,
+    )
 
 
-def discover_bursts(session_dir: Path) -> List[BurstData]:
+def discover_bursts(session_dir: Path) -> list[BurstData]:
     """Find every burst across all embryos under this session."""
-    out: List[BurstData] = []
+    out: list[BurstData] = []
     for embryo_dir in sorted((session_dir / "embryos").glob("embryo_*")):
         bursts_root = embryo_dir / "bursts"
         if not bursts_root.is_dir():
@@ -271,13 +280,13 @@ def discover_bursts(session_dir: Path) -> List[BurstData]:
     return out
 
 
-def find_session(storage: Path, requested: Optional[str]) -> Path:
+def find_session(storage: Path, requested: str | None) -> Path:
     sessions_root = storage / "sessions"
     if not sessions_root.is_dir():
         raise FileNotFoundError(f"Sessions root not found: {sessions_root}")
 
     # _index.yaml is the source of truth for short-id -> folder-name mapping.
-    index: Dict[str, str] = {}
+    index: dict[str, str] = {}
     index_path = sessions_root / "_index.yaml"
     if index_path.exists():
         try:
@@ -314,16 +323,16 @@ def find_session(storage: Path, requested: Optional[str]) -> Path:
 # ---------------------------------------------------------------------------
 # Frame rendering
 # ---------------------------------------------------------------------------
-HEADER_H = 80           # px above the projection (per-embryo header)
-FOOTER_H = 28           # px below the projection (cadence bar + spacing)
-GRID_TITLE_H = 110      # px at top of grid
-GRID_GUTTER = 14        # px between cells
-GRID_MARGIN = 18        # px around grid edge
+HEADER_H = 80  # px above the projection (per-embryo header)
+FOOTER_H = 28  # px below the projection (cadence bar + spacing)
+GRID_TITLE_H = 110  # px at top of grid
+GRID_GUTTER = 14  # px between cells
+GRID_MARGIN = 18  # px around grid edge
 
 
 # --- TrueType font loading (Segoe UI on Windows, fall back to Inter / DejaVu) ---
 _FONT_CANDIDATES = [
-    "C:/Windows/Fonts/segoeuib.ttf",   # Segoe UI Bold
+    "C:/Windows/Fonts/segoeuib.ttf",  # Segoe UI Bold
     "C:/Windows/Fonts/segoeui.ttf",
     "C:/Windows/Fonts/Inter-Regular.ttf",
     "C:/Windows/Fonts/calibri.ttf",
@@ -347,7 +356,7 @@ def _load_font(size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
     return ImageFont.load_default()
 
 
-_font_cache: Dict[Tuple[int, bool], ImageFont.FreeTypeFont] = {}
+_font_cache: dict[tuple[int, bool], ImageFont.FreeTypeFont] = {}
 
 
 def font(size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
@@ -357,25 +366,36 @@ def font(size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
     return _font_cache[key]
 
 
-def _bgr_to_rgb(c: Tuple[int, int, int]) -> Tuple[int, int, int]:
+def _bgr_to_rgb(c: tuple[int, int, int]) -> tuple[int, int, int]:
     return (c[2], c[1], c[0])
 
 
-def _draw_text(draw: ImageDraw.ImageDraw, xy: Tuple[int, int], text: str,
-               *, size: int = 16, bold: bool = False,
-               color: Tuple[int, int, int] = COL_TEXT,
-               anchor: str = "la") -> None:
+def _draw_text(
+    draw: ImageDraw.ImageDraw,
+    xy: tuple[int, int],
+    text: str,
+    *,
+    size: int = 16,
+    bold: bool = False,
+    color: tuple[int, int, int] = COL_TEXT,
+    anchor: str = "la",
+) -> None:
     """Draw RGB text via PIL. ``color`` is BGR (project convention)."""
-    draw.text(xy, text, font=font(size, bold=bold),
-              fill=_bgr_to_rgb(color), anchor=anchor)
+    draw.text(xy, text, font=font(size, bold=bold), fill=_bgr_to_rgb(color), anchor=anchor)
 
 
-def _draw_rounded(draw: ImageDraw.ImageDraw, box: Tuple[int, int, int, int],
-                  radius: int, *, fill=None, outline=None, width: int = 1) -> None:
+def _draw_rounded(
+    draw: ImageDraw.ImageDraw,
+    box: tuple[int, int, int, int],
+    radius: int,
+    *,
+    fill=None,
+    outline=None,
+    width: int = 1,
+) -> None:
     fill_rgb = _bgr_to_rgb(fill) if fill else None
     outline_rgb = _bgr_to_rgb(outline) if outline else None
-    draw.rounded_rectangle(box, radius=radius,
-                           fill=fill_rgb, outline=outline_rgb, width=width)
+    draw.rounded_rectangle(box, radius=radius, fill=fill_rgb, outline=outline_rgb, width=width)
 
 
 def _format_elapsed(seconds: float) -> str:
@@ -390,7 +410,7 @@ def _format_elapsed(seconds: float) -> str:
 VIEW_CROP: str = "a"  # "a" | "b" | "both"
 
 
-def _load_projection_bgr(jpg_path: Path) -> Optional[np.ndarray]:
+def _load_projection_bgr(jpg_path: Path) -> np.ndarray | None:
     img = cv2.imread(str(jpg_path), cv2.IMREAD_GRAYSCALE)
     if img is None:
         return None
@@ -402,7 +422,7 @@ def _load_projection_bgr(jpg_path: Path) -> Optional[np.ndarray]:
     return cv2.cvtColor(img, cv2.COLOR_GRAY2BGR)
 
 
-def _proj_to_pil(proj: np.ndarray, target_size: Tuple[int, int]) -> Image.Image:
+def _proj_to_pil(proj: np.ndarray, target_size: tuple[int, int]) -> Image.Image:
     """Resize a BGR ndarray projection and return as PIL RGB Image."""
     resized = cv2.resize(proj, target_size, interpolation=cv2.INTER_AREA)
     return Image.fromarray(cv2.cvtColor(resized, cv2.COLOR_BGR2RGB))
@@ -416,10 +436,10 @@ def _decorate_embryo_frame(
     elapsed_s: float,
     embryo_id: str,
     cadence_label: str,
-    cadence_color: Tuple[int, int, int],
-    stage: Optional[str],
+    cadence_color: tuple[int, int, int],
+    stage: str | None,
     stage_changed: bool,
-    session_label: Optional[str] = None,
+    session_label: str | None = None,
 ) -> np.ndarray:
     """Compose header + projection (with subtle card frame) + cadence bar."""
     margin = 28
@@ -431,28 +451,53 @@ def _decorate_embryo_frame(
 
     # --- Header panel ---
     header_box = (margin, margin, width - margin, margin + HEADER_H - 14)
-    _draw_rounded(draw, header_box, radius=10,
-                  fill=COL_PANEL, outline=COL_PANEL_HI, width=1)
+    _draw_rounded(draw, header_box, radius=10, fill=COL_PANEL, outline=COL_PANEL_HI, width=1)
 
     # Big timecode (left)
-    _draw_text(draw, (margin + 18, margin + 12),
-               _format_elapsed(elapsed_s), size=28, bold=True, color=COL_ACCENT)
-    _draw_text(draw, (margin + 18, margin + 44),
-               embryo_id.replace("_", " ").upper(), size=13,
-               color=COL_TEXT_DIM, bold=True)
+    _draw_text(
+        draw,
+        (margin + 18, margin + 12),
+        _format_elapsed(elapsed_s),
+        size=28,
+        bold=True,
+        color=COL_ACCENT,
+    )
+    _draw_text(
+        draw,
+        (margin + 18, margin + 44),
+        embryo_id.replace("_", " ").upper(),
+        size=13,
+        color=COL_TEXT_DIM,
+        bold=True,
+    )
     if session_label:
-        _draw_text(draw, (margin + 160, margin + 47),
-                   session_label, size=12, color=COL_TEXT_DIM)
+        _draw_text(
+            draw,
+            (margin + 160, margin + 47),
+            session_label,
+            size=12,
+            color=COL_TEXT_DIM,
+        )
 
     # Cadence pill (right top)
     pill_w, pill_h = 110, 30
     pill_x1 = width - margin - 18 - pill_w
     pill_y1 = margin + 12
-    _draw_rounded(draw, (pill_x1, pill_y1, pill_x1 + pill_w, pill_y1 + pill_h),
-                  radius=8, fill=cadence_color)
-    _draw_text(draw, (pill_x1 + pill_w // 2, pill_y1 + pill_h // 2),
-               cadence_label, size=14, bold=True,
-               color=(20, 20, 20), anchor="mm")
+    _draw_rounded(
+        draw,
+        (pill_x1, pill_y1, pill_x1 + pill_w, pill_y1 + pill_h),
+        radius=8,
+        fill=cadence_color,
+    )
+    _draw_text(
+        draw,
+        (pill_x1 + pill_w // 2, pill_y1 + pill_h // 2),
+        cadence_label,
+        size=14,
+        bold=True,
+        color=(20, 20, 20),
+        anchor="mm",
+    )
 
     # Stage chip (right bottom of header)
     if stage:
@@ -462,24 +507,39 @@ def _decorate_embryo_frame(
         chip_y1 = pill_y1 + pill_h + 6
         chip_fill = COL_ACCENT if stage_changed else COL_PANEL_HI
         chip_text_col = (20, 20, 20) if stage_changed else COL_TEXT
-        _draw_rounded(draw, (chip_x1, chip_y1, chip_x1 + chip_w, chip_y1 + 22),
-                      radius=6, fill=chip_fill)
-        _draw_text(draw, (chip_x1 + chip_w // 2, chip_y1 + 11),
-                   stage_txt, size=12, bold=True, color=chip_text_col, anchor="mm")
+        _draw_rounded(
+            draw,
+            (chip_x1, chip_y1, chip_x1 + chip_w, chip_y1 + 22),
+            radius=6,
+            fill=chip_fill,
+        )
+        _draw_text(
+            draw,
+            (chip_x1 + chip_w // 2, chip_y1 + 11),
+            stage_txt,
+            size=12,
+            bold=True,
+            color=chip_text_col,
+            anchor="mm",
+        )
 
     # --- Projection card ---
     proj_x = margin
     proj_y = margin + HEADER_H
     pil_proj = _proj_to_pil(proj, (proj_w, proj_h))
     # Subtle outer border around the projection
-    _draw_rounded(draw, (proj_x - 2, proj_y - 2, proj_x + proj_w + 2, proj_y + proj_h + 2),
-                  radius=6, outline=COL_PANEL_HI, width=2)
+    _draw_rounded(
+        draw,
+        (proj_x - 2, proj_y - 2, proj_x + proj_w + 2, proj_y + proj_h + 2),
+        radius=6,
+        outline=COL_PANEL_HI,
+        width=2,
+    )
     canvas.paste(pil_proj, (proj_x, proj_y))
 
     # --- Footer cadence bar ---
     bar_y = proj_y + proj_h + 10
-    _draw_rounded(draw, (proj_x, bar_y, proj_x + proj_w, bar_y + 6),
-                  radius=3, fill=cadence_color)
+    _draw_rounded(draw, (proj_x, bar_y, proj_x + proj_w, bar_y + 6), radius=3, fill=cadence_color)
 
     return cv2.cvtColor(np.array(canvas), cv2.COLOR_RGB2BGR)
 
@@ -490,7 +550,7 @@ def _decorate_embryo_frame(
 @dataclass
 class VideoParams:
     fps: int = 30
-    speedup: float = 600.0       # real_seconds rendered into 1 video second
+    speedup: float = 600.0  # real_seconds rendered into 1 video second
     min_frame_dt_s: float = 0.06  # don't flash burst frames
     max_frame_dt_s: float = 0.40  # don't drag slow frames
 
@@ -500,7 +560,7 @@ def _video_dt_for_real_interval(interval_s: float, vp: VideoParams) -> float:
     return max(vp.min_frame_dt_s, min(vp.max_frame_dt_s, raw))
 
 
-def _open_writer(path: Path, size: Tuple[int, int], fps: int):
+def _open_writer(path: Path, size: tuple[int, int], fps: int):
     """Try mp4v then avc1 then fall back to AVI codecs (matches video_maker.py)."""
     codecs = (
         ("mp4v", ".mp4"),
@@ -522,15 +582,20 @@ def _open_writer(path: Path, size: Tuple[int, int], fps: int):
 # ---------------------------------------------------------------------------
 # Per-embryo video
 # ---------------------------------------------------------------------------
-def _embryo_proj_dims() -> Tuple[int, int]:
+def _embryo_proj_dims() -> tuple[int, int]:
     """2x-scale the cropped projection for crisp text proportion on slides."""
     if VIEW_CROP in ("a", "b"):
-        return 1024, 512   # 2x of native 512x256
-    return 1024, 256       # native widescreen for both-views
+        return 1024, 512  # 2x of native 512x256
+    return 1024, 256  # native widescreen for both-views
 
 
-def render_embryo_video(emb: EmbryoData, out_path: Path, vp: VideoParams,
-                        *, session_label: Optional[str] = None) -> Optional[Path]:
+def render_embryo_video(
+    emb: EmbryoData,
+    out_path: Path,
+    vp: VideoParams,
+    *,
+    session_label: str | None = None,
+) -> Path | None:
     proj_w, proj_h = _embryo_proj_dims()
     margin = 28
     canvas_w = proj_w + 2 * margin
@@ -542,14 +607,18 @@ def render_embryo_video(emb: EmbryoData, out_path: Path, vp: VideoParams,
         return None
 
     t0 = emb.frames[0].acquired_at
-    prev_stage: Optional[str] = None
-    last_proj: Optional[np.ndarray] = None
+    prev_stage: str | None = None
+    last_proj: np.ndarray | None = None
     written = 0
 
     for fr in emb.frames:
         proj = _load_projection_bgr(fr.jpg_path)
         if proj is None:
-            logger.warning("[%s] could not read %s — reusing previous", emb.embryo_id, fr.jpg_path.name)
+            logger.warning(
+                "[%s] could not read %s — reusing previous",
+                emb.embryo_id,
+                fr.jpg_path.name,
+            )
             if last_proj is None:
                 continue
             proj = last_proj
@@ -559,12 +628,22 @@ def render_embryo_video(emb: EmbryoData, out_path: Path, vp: VideoParams,
         stage_changed = bool(fr.predicted_stage and fr.predicted_stage != prev_stage)
         elapsed_s = (fr.acquired_at - t0).total_seconds()
 
-        def render(_changed: bool) -> np.ndarray:
+        def render(
+            _changed: bool,
+            _proj=proj,
+            _elapsed=elapsed_s,
+            _fr=fr,
+        ) -> np.ndarray:
             return _decorate_embryo_frame(
-                proj, proj_w=proj_w, proj_h=proj_h,
-                elapsed_s=elapsed_s, embryo_id=emb.embryo_id,
-                cadence_label=fr.cadence_label, cadence_color=fr.cadence_color,
-                stage=fr.predicted_stage, stage_changed=_changed,
+                _proj,
+                proj_w=proj_w,
+                proj_h=proj_h,
+                elapsed_s=_elapsed,
+                embryo_id=emb.embryo_id,
+                cadence_label=_fr.cadence_label,
+                cadence_color=_fr.cadence_color,
+                stage=_fr.predicted_stage,
+                stage_changed=_changed,
                 session_label=session_label,
             )
 
@@ -581,16 +660,27 @@ def render(_changed: bool) -> np.ndarray:
             prev_stage = fr.predicted_stage
 
     writer.release()
-    logger.info("[%s] wrote %s (%d video frames, %d input frames, codec=%s)",
-                emb.embryo_id, real_out, written, len(emb.frames), codec)
+    logger.info(
+        "[%s] wrote %s (%d video frames, %d input frames, codec=%s)",
+        emb.embryo_id,
+        real_out,
+        written,
+        len(emb.frames),
+        codec,
+    )
     return real_out
 
 
 # ---------------------------------------------------------------------------
 # Burst-only videos
 # ---------------------------------------------------------------------------
-def render_burst_video(burst: BurstData, out_path: Path, vp: VideoParams,
-                       *, session_label: Optional[str] = None) -> Optional[Path]:
+def render_burst_video(
+    burst: BurstData,
+    out_path: Path,
+    vp: VideoParams,
+    *,
+    session_label: str | None = None,
+) -> Path | None:
     """Render one MP4 for a single burst (request_id) — slower default speedup
     so the embryo actually looks alive."""
     # Reuse the embryo-video composition by wrapping as EmbryoData. The header
@@ -605,27 +695,40 @@ def render_burst_video(burst: BurstData, out_path: Path, vp: VideoParams,
 # ---------------------------------------------------------------------------
 # Grid video (real-time synchronized)
 # ---------------------------------------------------------------------------
-GRID_COLS_BY_N = {1: 1, 2: 2, 3: 3, 4: 2, 5: 3, 6: 3, 7: 4, 8: 4, 9: 3, 10: 5, 11: 4, 12: 4}
-
-
-def _grid_layout(n: int) -> Tuple[int, int]:
+GRID_COLS_BY_N = {
+    1: 1,
+    2: 2,
+    3: 3,
+    4: 2,
+    5: 3,
+    6: 3,
+    7: 4,
+    8: 4,
+    9: 3,
+    10: 5,
+    11: 4,
+    12: 4,
+}
+
+
+def _grid_layout(n: int) -> tuple[int, int]:
     cols = GRID_COLS_BY_N.get(n, max(1, int(np.ceil(np.sqrt(n)))))
     rows = int(np.ceil(n / cols))
     return rows, cols
 
 
-def _grid_cell_dims() -> Tuple[int, int]:
+def _grid_cell_dims() -> tuple[int, int]:
     """Pick cell projection size so view-A-only and both-views both look right."""
     if VIEW_CROP in ("a", "b"):
-        return 540, 270   # 2:1 — matches cropped single view
-    return 600, 150       # 4:1 — matches both-views native aspect
+        return 540, 270  # 2:1 — matches cropped single view
+    return 600, 150  # 4:1 — matches both-views native aspect
 
 
 CELL_HEADER_H = 38
 CELL_FOOTER_H = 6
 
 
-def _build_global_timeline(embryos: List[EmbryoData]) -> List[datetime]:
+def _build_global_timeline(embryos: list[EmbryoData]) -> list[datetime]:
     times = set()
     for emb in embryos:
         for fr in emb.frames:
@@ -633,7 +736,7 @@ def _build_global_timeline(embryos: List[EmbryoData]) -> List[datetime]:
     return sorted(times)
 
 
-def _most_recent_index(frames: List[FrameRecord], t: datetime) -> int:
+def _most_recent_index(frames: list[FrameRecord], t: datetime) -> int:
     # Linear scan is fine for ~60 frames per embryo.
     idx = -1
     for i, fr in enumerate(frames):
@@ -644,63 +747,110 @@ def _most_recent_index(frames: List[FrameRecord], t: datetime) -> int:
     return idx
 
 
-def _draw_cell(canvas: Image.Image, top_left: Tuple[int, int], *,
-               cell_w: int, cell_h: int,
-               proj: Optional[np.ndarray],
-               embryo_id: str,
-               cadence_color: Tuple[int, int, int],
-               cadence_label: str,
-               stage: Optional[str]) -> None:
+def _draw_cell(
+    canvas: Image.Image,
+    top_left: tuple[int, int],
+    *,
+    cell_w: int,
+    cell_h: int,
+    proj: np.ndarray | None,
+    embryo_id: str,
+    cadence_color: tuple[int, int, int],
+    cadence_label: str,
+    stage: str | None,
+) -> None:
     """Paint a single cell onto the grid canvas at top_left."""
     x, y = top_left
     total_h = CELL_HEADER_H + cell_h + CELL_FOOTER_H
     draw = ImageDraw.Draw(canvas)
 
     # Card background + outer border
-    _draw_rounded(draw, (x, y, x + cell_w, y + total_h), radius=12,
-                  fill=COL_PANEL, outline=COL_PANEL_HI, width=1)
+    _draw_rounded(
+        draw,
+        (x, y, x + cell_w, y + total_h),
+        radius=12,
+        fill=COL_PANEL,
+        outline=COL_PANEL_HI,
+        width=1,
+    )
 
     # Header band
-    _draw_text(draw, (x + 14, y + CELL_HEADER_H // 2),
-               embryo_id.replace("_", " ").upper(), size=14, bold=True,
-               color=COL_TEXT, anchor="lm")
+    _draw_text(
+        draw,
+        (x + 14, y + CELL_HEADER_H // 2),
+        embryo_id.replace("_", " ").upper(),
+        size=14,
+        bold=True,
+        color=COL_TEXT,
+        anchor="lm",
+    )
 
     if stage:
-        _draw_text(draw, (x + cell_w // 2, y + CELL_HEADER_H // 2),
-                   stage.upper(), size=12, bold=True,
-                   color=COL_ACCENT, anchor="mm")
+        _draw_text(
+            draw,
+            (x + cell_w // 2, y + CELL_HEADER_H // 2),
+            stage.upper(),
+            size=12,
+            bold=True,
+            color=COL_ACCENT,
+            anchor="mm",
+        )
 
     # Cadence pill (right)
     pill_w, pill_h = 78, 22
     pill_x1 = x + cell_w - 14 - pill_w
     pill_y1 = y + (CELL_HEADER_H - pill_h) // 2
-    _draw_rounded(draw, (pill_x1, pill_y1, pill_x1 + pill_w, pill_y1 + pill_h),
-                  radius=6, fill=cadence_color)
-    _draw_text(draw, (pill_x1 + pill_w // 2, pill_y1 + pill_h // 2),
-               cadence_label, size=11, bold=True,
-               color=(20, 20, 20), anchor="mm")
+    _draw_rounded(
+        draw,
+        (pill_x1, pill_y1, pill_x1 + pill_w, pill_y1 + pill_h),
+        radius=6,
+        fill=cadence_color,
+    )
+    _draw_text(
+        draw,
+        (pill_x1 + pill_w // 2, pill_y1 + pill_h // 2),
+        cadence_label,
+        size=11,
+        bold=True,
+        color=(20, 20, 20),
+        anchor="mm",
+    )
 
     # Projection area
     proj_y = y + CELL_HEADER_H
     if proj is None:
         # "Waiting" placeholder
-        _draw_rounded(draw, (x + 6, proj_y, x + cell_w - 6, proj_y + cell_h),
-                      radius=6, fill=(48, 40, 34))
-        _draw_text(draw, (x + cell_w // 2, proj_y + cell_h // 2),
-                   "WAITING", size=14, bold=True,
-                   color=COL_TEXT_DIM, anchor="mm")
+        _draw_rounded(
+            draw,
+            (x + 6, proj_y, x + cell_w - 6, proj_y + cell_h),
+            radius=6,
+            fill=(48, 40, 34),
+        )
+        _draw_text(
+            draw,
+            (x + cell_w // 2, proj_y + cell_h // 2),
+            "WAITING",
+            size=14,
+            bold=True,
+            color=COL_TEXT_DIM,
+            anchor="mm",
+        )
     else:
         pil_proj = _proj_to_pil(proj, (cell_w, cell_h))
         canvas.paste(pil_proj, (x, proj_y))
 
     # Bottom cadence accent
     bar_y = proj_y + cell_h
-    _draw_rounded(draw, (x + 6, bar_y, x + cell_w - 6, bar_y + 4),
-                  radius=2, fill=cadence_color)
+    _draw_rounded(draw, (x + 6, bar_y, x + cell_w - 6, bar_y + 4), radius=2, fill=cadence_color)
 
 
-def render_grid_video(embryos: List[EmbryoData], out_path: Path, vp: VideoParams,
-                      *, session_label: Optional[str] = None) -> Optional[Path]:
+def render_grid_video(
+    embryos: list[EmbryoData],
+    out_path: Path,
+    vp: VideoParams,
+    *,
+    session_label: str | None = None,
+) -> Path | None:
     if not embryos:
         return None
     timeline = _build_global_timeline(embryos)
@@ -722,8 +872,8 @@ def render_grid_video(embryos: List[EmbryoData], out_path: Path, vp: VideoParams
         logger.error("Grid: no working codec — skipped")
         return None
 
-    cached_proj: Dict[str, Optional[np.ndarray]] = {emb.embryo_id: None for emb in embryos}
-    cached_record_idx: Dict[str, int] = {emb.embryo_id: -1 for emb in embryos}
+    cached_proj: dict[str, np.ndarray | None] = {emb.embryo_id: None for emb in embryos}
+    cached_record_idx: dict[str, int] = {emb.embryo_id: -1 for emb in embryos}
 
     t0 = timeline[0]
     written = 0
@@ -744,19 +894,39 @@ def render_grid_video(embryos: List[EmbryoData], out_path: Path, vp: VideoParams
         draw = ImageDraw.Draw(canvas)
 
         # --- Title bar ---
-        title_box = (GRID_MARGIN, GRID_MARGIN,
-                     canvas_w - GRID_MARGIN, GRID_MARGIN + GRID_TITLE_H - 16)
-        _draw_rounded(draw, title_box, radius=12,
-                      fill=COL_PANEL, outline=COL_PANEL_HI, width=1)
+        title_box = (
+            GRID_MARGIN,
+            GRID_MARGIN,
+            canvas_w - GRID_MARGIN,
+            GRID_MARGIN + GRID_TITLE_H - 16,
+        )
+        _draw_rounded(draw, title_box, radius=12, fill=COL_PANEL, outline=COL_PANEL_HI, width=1)
 
         elapsed_s = (t - t0).total_seconds()
-        _draw_text(draw, (GRID_MARGIN + 22, GRID_MARGIN + 18),
-                   _format_elapsed(elapsed_s), size=36, bold=True, color=COL_ACCENT)
-        _draw_text(draw, (GRID_MARGIN + 22, GRID_MARGIN + 58),
-                   "elapsed", size=12, color=COL_TEXT_DIM, bold=True)
+        _draw_text(
+            draw,
+            (GRID_MARGIN + 22, GRID_MARGIN + 18),
+            _format_elapsed(elapsed_s),
+            size=36,
+            bold=True,
+            color=COL_ACCENT,
+        )
+        _draw_text(
+            draw,
+            (GRID_MARGIN + 22, GRID_MARGIN + 58),
+            "elapsed",
+            size=12,
+            color=COL_TEXT_DIM,
+            bold=True,
+        )
         if session_label:
-            _draw_text(draw, (GRID_MARGIN + 200, GRID_MARGIN + 64),
-                       session_label, size=12, color=COL_TEXT_DIM)
+            _draw_text(
+                draw,
+                (GRID_MARGIN + 200, GRID_MARGIN + 64),
+                session_label,
+                size=12,
+                color=COL_TEXT_DIM,
+            )
 
         # Active cadence pill (right)
         active = None
@@ -778,12 +948,21 @@ def render_grid_video(embryos: List[EmbryoData], out_path: Path, vp: VideoParams
             pill_w, pill_h = 200, 44
             pill_x1 = canvas_w - GRID_MARGIN - 22 - pill_w
             pill_y1 = GRID_MARGIN + (GRID_TITLE_H - 16 - pill_h) // 2
-            _draw_rounded(draw, (pill_x1, pill_y1,
-                                 pill_x1 + pill_w, pill_y1 + pill_h),
-                          radius=10, fill=color)
-            _draw_text(draw, (pill_x1 + pill_w // 2, pill_y1 + pill_h // 2),
-                       f"CADENCE  {label}", size=16, bold=True,
-                       color=(20, 20, 20), anchor="mm")
+            _draw_rounded(
+                draw,
+                (pill_x1, pill_y1, pill_x1 + pill_w, pill_y1 + pill_h),
+                radius=10,
+                fill=color,
+            )
+            _draw_text(
+                draw,
+                (pill_x1 + pill_w // 2, pill_y1 + pill_h // 2),
+                f"CADENCE  {label}",
+                size=16,
+                bold=True,
+                color=(20, 20, 20),
+                anchor="mm",
+            )
 
         # --- Cells ---
         for idx, emb in enumerate(embryos):
@@ -794,18 +973,30 @@ def render_grid_video(embryos: List[EmbryoData], out_path: Path, vp: VideoParams
 
             i = cached_record_idx[emb.embryo_id]
             if i < 0:
-                _draw_cell(canvas, (x, y), cell_w=cell_w, cell_h=cell_h,
-                           proj=None, embryo_id=emb.embryo_id,
-                           cadence_color=COL_PANEL_HI, cadence_label="--",
-                           stage=None)
+                _draw_cell(
+                    canvas,
+                    (x, y),
+                    cell_w=cell_w,
+                    cell_h=cell_h,
+                    proj=None,
+                    embryo_id=emb.embryo_id,
+                    cadence_color=COL_PANEL_HI,
+                    cadence_label="--",
+                    stage=None,
+                )
             else:
                 fr = emb.frames[i]
-                _draw_cell(canvas, (x, y), cell_w=cell_w, cell_h=cell_h,
-                           proj=cached_proj[emb.embryo_id],
-                           embryo_id=emb.embryo_id,
-                           cadence_color=fr.cadence_color,
-                           cadence_label=fr.cadence_label,
-                           stage=fr.predicted_stage)
+                _draw_cell(
+                    canvas,
+                    (x, y),
+                    cell_w=cell_w,
+                    cell_h=cell_h,
+                    proj=cached_proj[emb.embryo_id],
+                    embryo_id=emb.embryo_id,
+                    cadence_color=fr.cadence_color,
+                    cadence_label=fr.cadence_label,
+                    stage=fr.predicted_stage,
+                )
 
         frame_bgr = cv2.cvtColor(np.array(canvas), cv2.COLOR_RGB2BGR)
 
@@ -820,43 +1011,78 @@ def render_grid_video(embryos: List[EmbryoData], out_path: Path, vp: VideoParams
             written += 1
 
     writer.release()
-    logger.info("Grid: wrote %s (%d video frames, %d timeline ticks, codec=%s)",
-                real_out, written, len(timeline), codec)
+    logger.info(
+        "Grid: wrote %s (%d video frames, %d timeline ticks, codec=%s)",
+        real_out,
+        written,
+        len(timeline),
+        codec,
+    )
     return real_out
 
 
 # ---------------------------------------------------------------------------
 # Main
 # ---------------------------------------------------------------------------
-def main(argv: Optional[List[str]] = None) -> int:
+def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--session", default=None,
-                        help="Session folder name or partial id (default: latest)")
-    parser.add_argument("--storage", default="D:/Gently3",
-                        help="Gently storage root (default: D:/Gently3)")
-    parser.add_argument("--out", default=None,
-                        help="Output directory (default: <session>/_recap)")
-    parser.add_argument("--speedup", type=float, default=600.0,
-                        help="real_seconds rendered into one video second (default: 600)")
+    parser.add_argument(
+        "--session",
+        default=None,
+        help="Session folder name or partial id (default: latest)",
+    )
+    parser.add_argument(
+        "--storage",
+        default="D:/Gently3",
+        help="Gently storage root (default: D:/Gently3)",
+    )
+    parser.add_argument("--out", default=None, help="Output directory (default: <session>/_recap)")
+    parser.add_argument(
+        "--speedup",
+        type=float,
+        default=600.0,
+        help="real_seconds rendered into one video second (default: 600)",
+    )
     parser.add_argument("--fps", type=int, default=30, help="Playback FPS (default: 30)")
-    parser.add_argument("--min-frame-dt", type=float, default=0.06,
-                        help="Min seconds per input frame (default: 0.06)")
-    parser.add_argument("--max-frame-dt", type=float, default=0.40,
-                        help="Max seconds per input frame (default: 0.40)")
-    parser.add_argument("--no-perception", action="store_true",
-                        help="Skip predicted-stage overlays")
-    parser.add_argument("--no-grid", action="store_true",
-                        help="Skip the synchronized grid video")
-    parser.add_argument("--no-per-embryo", action="store_true",
-                        help="Skip per-embryo videos")
-    parser.add_argument("--bursts", action="store_true",
-                        help="Also render one MP4 per burst (one per request_id)")
-    parser.add_argument("--bursts-only", action="store_true",
-                        help="Render burst MP4s only — skip timelapse + grid")
-    parser.add_argument("--burst-speedup", type=float, default=10.0,
-                        help="Speedup for burst videos only (default: 10 — near-real-time)")
-    parser.add_argument("--view", choices=("a", "b", "both"), default="a",
-                        help="Which diSPIM view to render (default: a)")
+    parser.add_argument(
+        "--min-frame-dt",
+        type=float,
+        default=0.06,
+        help="Min seconds per input frame (default: 0.06)",
+    )
+    parser.add_argument(
+        "--max-frame-dt",
+        type=float,
+        default=0.40,
+        help="Max seconds per input frame (default: 0.40)",
+    )
+    parser.add_argument(
+        "--no-perception", action="store_true", help="Skip predicted-stage overlays"
+    )
+    parser.add_argument("--no-grid", action="store_true", help="Skip the synchronized grid video")
+    parser.add_argument("--no-per-embryo", action="store_true", help="Skip per-embryo videos")
+    parser.add_argument(
+        "--bursts",
+        action="store_true",
+        help="Also render one MP4 per burst (one per request_id)",
+    )
+    parser.add_argument(
+        "--bursts-only",
+        action="store_true",
+        help="Render burst MP4s only — skip timelapse + grid",
+    )
+    parser.add_argument(
+        "--burst-speedup",
+        type=float,
+        default=10.0,
+        help="Speedup for burst videos only (default: 10 — near-real-time)",
+    )
+    parser.add_argument(
+        "--view",
+        choices=("a", "b", "both"),
+        default="a",
+        help="Which diSPIM view to render (default: a)",
+    )
     parser.add_argument("-v", "--verbose", action="store_true")
     args = parser.parse_args(argv)
 
@@ -884,15 +1110,19 @@ def main(argv: Optional[List[str]] = None) -> int:
         logger.error("No embryos found under %s/embryos", session_dir)
         return 1
 
-    embryos: List[EmbryoData] = []
+    embryos: list[EmbryoData] = []
     for ed in embryo_dirs:
         emb = load_embryo(ed, use_perception=not args.no_perception)
         if emb is None:
             logger.warning("Skipping %s (no projections)", ed.name)
             continue
-        logger.info("Loaded %s: %d frames (%s → %s)", emb.embryo_id, len(emb.frames),
-                    emb.frames[0].acquired_at.isoformat(timespec="seconds"),
-                    emb.frames[-1].acquired_at.isoformat(timespec="seconds"))
+        logger.info(
+            "Loaded %s: %d frames (%s → %s)",
+            emb.embryo_id,
+            len(emb.frames),
+            emb.frames[0].acquired_at.isoformat(timespec="seconds"),
+            emb.frames[-1].acquired_at.isoformat(timespec="seconds"),
+        )
         embryos.append(emb)
 
     if not embryos:
@@ -909,12 +1139,12 @@ def main(argv: Optional[List[str]] = None) -> int:
     render_timelapse = not args.bursts_only
     if render_timelapse and not args.no_per_embryo:
         for emb in embryos:
-            render_embryo_video(emb, out_dir / f"{emb.embryo_id}.mp4", vp,
-                                session_label=session_label)
+            render_embryo_video(
+                emb, out_dir / f"{emb.embryo_id}.mp4", vp, session_label=session_label
+            )
 
     if render_timelapse and not args.no_grid:
-        render_grid_video(embryos, out_dir / "grid.mp4", vp,
-                          session_label=session_label)
+        render_grid_video(embryos, out_dir / "grid.mp4", vp, session_label=session_label)
 
     if args.bursts or args.bursts_only:
         bursts = discover_bursts(session_dir)
@@ -929,13 +1159,20 @@ def main(argv: Optional[List[str]] = None) -> int:
                 min_frame_dt_s=vp.min_frame_dt_s,
                 max_frame_dt_s=max(vp.max_frame_dt_s, 0.6),
             )
-            logger.info("Rendering %d burst(s) at %.0fx speedup",
-                        len(bursts), args.burst_speedup)
+            logger.info(
+                "Rendering %d burst(s) at %.0fx speedup",
+                len(bursts),
+                args.burst_speedup,
+            )
             for burst in bursts:
                 # request_id already contains the embryo_id; uuid8 suffix keeps it unique.
                 out_name = f"{burst.request_id}.mp4"
-                render_burst_video(burst, burst_out_dir / out_name, burst_vp,
-                                   session_label=session_label)
+                render_burst_video(
+                    burst,
+                    burst_out_dir / out_name,
+                    burst_vp,
+                    session_label=session_label,
+                )
 
     logger.info("Done. Videos written to %s", out_dir)
     return 0
diff --git a/scripts/regenerate_examples_three_view.py b/scripts/regenerate_examples_three_view.py
index aa653ee2..bacda92a 100644
--- a/scripts/regenerate_examples_three_view.py
+++ b/scripts/regenerate_examples_three_view.py
@@ -11,18 +11,19 @@
     python scripts/regenerate_examples_three_view.py
 """
 
+# Add parent to path for imports
+import sys
 from pathlib import Path
+
 import numpy as np
 from PIL import Image
 
-# Add parent to path for imports
-import sys
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
 from gently.core.imaging import (
-    projection_three_view,
-    compute_crop_bounds,
     apply_crop_bounds,
+    compute_crop_bounds,
+    projection_three_view,
 )
 
 STAGES_PATH = Path(__file__).parent.parent / "gently" / "examples" / "stages"
@@ -67,7 +68,7 @@ def regenerate_stage(stage: str) -> bool:
     if volume.ndim == 3:
         z_depth, height, width = volume.shape
         if width > height * 2:
-            volume = volume[:, :, :width // 2]
+            volume = volume[:, :, : width // 2]
             print(f"  Extracted View A: {volume.shape}")
 
     # Auto-crop to embryo region
@@ -81,8 +82,8 @@ def regenerate_stage(stage: str) -> bool:
 
     # Save as JPEG
     pil_img = Image.fromarray(three_view_img)
-    if pil_img.mode != 'RGB':
-        pil_img = pil_img.convert('RGB')
+    if pil_img.mode != "RGB":
+        pil_img = pil_img.convert("RGB")
 
     output_path = stage_dir / "three_view.jpg"
     pil_img.save(output_path, quality=90)
diff --git a/scripts/regenerate_projections.py b/scripts/regenerate_projections.py
index 7b6241ff..1e41edf4 100644
--- a/scripts/regenerate_projections.py
+++ b/scripts/regenerate_projections.py
@@ -22,8 +22,8 @@
 if str(_ROOT) not in sys.path:
     sys.path.insert(0, str(_ROOT))
 
-from gently.settings import settings
-from gently.core.imaging import load_volume, generate_jpeg_projection
+from gently.core.imaging import generate_jpeg_projection, load_volume  # noqa: E402
+from gently.settings import settings  # noqa: E402
 
 
 def _regen_folder(folder: Path, only_embryo: str | None = None) -> int:
@@ -83,7 +83,8 @@ def regenerate_all() -> int:
         print(f"No sessions dir at {sessions}")
         return 0
     folders = sorted(
-        p for p in sessions.iterdir()
+        p
+        for p in sessions.iterdir()
         if p.is_dir() and any((p / "embryos").glob("*/volumes/t*.tif"))
     )
     print(f"Regenerating projections for {len(folders)} session(s) with volumes...")
diff --git a/scripts/replay_session.py b/scripts/replay_session.py
index f8ffe208..ec2b02c4 100644
--- a/scripts/replay_session.py
+++ b/scripts/replay_session.py
@@ -76,7 +76,9 @@ def main(argv=None) -> int:
         help="Print event-type histogram, don't replay",
     )
     parser.add_argument(
-        "-v", "--verbose", action="store_true",
+        "-v",
+        "--verbose",
+        action="store_true",
         help="Verbose logging",
     )
     args = parser.parse_args(argv)
@@ -88,7 +90,7 @@ def main(argv=None) -> int:
 
     from gently.core.event_bus import EventBus
     from gently.core.file_store import FileStore
-    from gently.eval import EventReplay, DecisionLog, ShadowRunner, NoOpCandidate
+    from gently.eval import DecisionLog, EventReplay, NoOpCandidate, ShadowRunner
 
     root = args.root or os.environ.get("GENTLY_STORAGE_PATH", "D:/Gently3")
     store = FileStore(root=Path(root))
@@ -135,7 +137,9 @@ def main(argv=None) -> int:
 
     try:
         emitted = rep.replay(
-            bus, real_time=args.real_time, time_scale=args.time_scale,
+            bus,
+            real_time=args.real_time,
+            time_scale=args.time_scale,
         )
         print(f"Replayed {emitted} events from session {session['session_id']}")
     finally:
diff --git a/scripts/stage_annotator.py b/scripts/stage_annotator.py
index 07ce6dbd..6171d603 100644
--- a/scripts/stage_annotator.py
+++ b/scripts/stage_annotator.py
@@ -10,24 +10,24 @@
 """
 
 import argparse
+import base64
+import io
 import json
 import logging
 import os
 import signal
+import socketserver
 import subprocess
 import sys
-from http.server import HTTPServer, BaseHTTPRequestHandler
+from http.server import BaseHTTPRequestHandler, HTTPServer
 from pathlib import Path
 from urllib.parse import parse_qs, urlparse
-import base64
-import io
-import socketserver
 
 import numpy as np
 import tifffile
 from PIL import Image
 
-logging.basicConfig(level=logging.INFO, format='%(message)s')
+logging.basicConfig(level=logging.INFO, format="%(message)s")
 logger = logging.getLogger(__name__)
 
 # Configuration
@@ -67,7 +67,7 @@ def load_and_project(tif_path: Path) -> np.ndarray:
         # Check if width is roughly 4x height (dual-view format)
         if width > height * 2:
             # Extract View A (left half) - shape (Z, Y, X/2)
-            view_a = vol[:, :, :width // 2]
+            view_a = vol[:, :, : width // 2]
         else:
             view_a = vol
 
@@ -122,8 +122,8 @@ def image_to_base64(img: np.ndarray) -> str:
     pil_img = Image.fromarray(img)
 
     # Convert to RGB for JPEG (grayscale works but RGB is more compatible)
-    if pil_img.mode != 'RGB':
-        pil_img = pil_img.convert('RGB')
+    if pil_img.mode != "RGB":
+        pil_img = pil_img.convert("RGB")
 
     buffer = io.BytesIO()
     pil_img.save(buffer, format="JPEG", quality=90)
@@ -162,7 +162,7 @@ class AppState:
 class AnnotatorHandler(BaseHTTPRequestHandler):
     """HTTP handler for annotation interface."""
 
-    protocol_version = 'HTTP/1.1'
+    protocol_version = "HTTP/1.1"
 
     def log_message(self, format, *args):
         pass  # Suppress HTTP logging
@@ -205,12 +205,12 @@ def do_POST(self):
 
             if parsed.path == "/api/save_markers":
                 # Read POST body
-                content_length = int(self.headers.get('Content-Length', 0))
+                content_length = int(self.headers.get("Content-Length", 0))
                 body = self.rfile.read(content_length)
                 data = json.loads(body.decode())
 
                 # Get labels from client
-                labels = data.get('labels', {})
+                labels = data.get("labels", {})
                 count = self.save_with_labels(labels)
                 self.send_json({"ok": True, "saved": count})
             else:
@@ -317,7 +317,8 @@ def send_html(self):
         <div class="nav-container">
             <button class="nav-btn" onclick="prev()">&larr; Prev (A)</button>
             <div class="slider-container">
-                <input type="range" class="slider" id="slider" min="0" max="100" value="0" oninput="gotoIdx(this.value)">
+                <input type="range" class="slider" id="slider" min="0" max="100"
+                  value="0" oninput="gotoIdx(this.value)">
                 <div class="timeline-track" id="timeline-track">
                     <div class="timeline-cursor" id="timeline-cursor"></div>
                 </div>
@@ -335,10 +336,14 @@ def send_html(self):
         <div class="controls">
             <button class="stage-btn" data-stage="early" onclick="label('early')">1: Early</button>
             <button class="stage-btn" data-stage="comma" onclick="label('comma')">2: Comma</button>
-            <button class="stage-btn" data-stage="1.5fold" onclick="label('1.5fold')">3: 1.5-Fold</button>
-            <button class="stage-btn" data-stage="pretzel" onclick="label('pretzel')">4: Pretzel</button>
-            <button class="stage-btn" data-stage="hatching" onclick="label('hatching')">5: Hatching</button>
-            <button class="stage-btn" data-stage="hatched" onclick="label('hatched')">6: Hatched</button>
+            <button class="stage-btn" data-stage="1.5fold"
+              onclick="label('1.5fold')">3: 1.5-Fold</button>
+            <button class="stage-btn" data-stage="pretzel"
+              onclick="label('pretzel')">4: Pretzel</button>
+            <button class="stage-btn" data-stage="hatching"
+              onclick="label('hatching')">5: Hatching</button>
+            <button class="stage-btn" data-stage="hatched"
+              onclick="label('hatched')">6: Hatched</button>
             <button class="stage-btn" data-stage="" onclick="label('')">0: Clear</button>
         </div>
 
@@ -347,12 +352,15 @@ def send_html(self):
         </div>
 
         <p class="keyboard-hint">
-            <strong>How to use:</strong> Navigate to where a stage STARTS, then press the stage key (1-6).<br>
-            All images from that point until the next marked stage will be labeled automatically.<br>
+            <strong>How to use:</strong> Navigate to where a stage STARTS, then press the
+            stage key (1-6).<br>
+            All images from that point until the next marked stage will be labeled
+            automatically.<br>
             Keys: 1-6 = mark stage start, 0 = clear mark, A/D or Arrows = navigate, S = save
         </p>
 
-        <div id="stage-markers" style="margin-top: 15px; padding: 10px; background: #222; border-radius: 6px;">
+        <div id="stage-markers"
+          style="margin-top: 15px; padding: 10px; background: #222; border-radius: 6px;">
             <strong>Stage Transitions:</strong>
             <div id="markers-list" style="margin-top: 8px; font-family: monospace;"></div>
         </div>
@@ -442,7 +450,9 @@ def send_html(self):
             let markerIndices = Object.keys(stageMarkers).map(Number).sort((a, b) => a - b);
 
             if (markerIndices.length === 0) {
-                list.innerHTML = '<span style="color: #666;">No markers set. Navigate to where a stage starts and press 1-7.</span>';
+                list.innerHTML = '<span style="color: #666;">'
+                    + 'No markers set. Navigate to where a stage starts and press 1-7.'
+                    + '</span>';
                 return;
             }
 
@@ -454,13 +464,22 @@ def send_html(self):
                 let nextIdx = markerIndices[i + 1] || totalImages;
                 let count = nextIdx - idx;
 
-                html += '<div style="margin: 4px 0; display: flex; align-items: center; gap: 10px;">';
-                html += '<span style="display: inline-block; width: 12px; height: 12px; background: ' + color + '; border-radius: 2px;"></span>';
-                html += '<span style="color: ' + color + '; font-weight: bold; min-width: 70px;">' + stage.toUpperCase() + '</span>';
+                html += '<div style="margin: 4px 0; display: flex;'
+                    + ' align-items: center; gap: 10px;">';
+                html += '<span style="display: inline-block; width: 12px; height: 12px;'
+                    + ' background: ' + color + '; border-radius: 2px;"></span>';
+                html += '<span style="color: ' + color + '; font-weight: bold;'
+                    + ' min-width: 70px;">' + stage.toUpperCase() + '</span>';
                 html += '<span style="color: #888;">frame ' + (idx + 1) + '</span>';
                 html += '<span style="color: #666;">(' + count + ' frames)</span>';
-                html += '<button onclick="clearMarker(' + idx + ')" style="padding: 2px 8px; background: #c00; color: white; border: none; border-radius: 3px; cursor: pointer; font-size: 11px;">×</button>';
-                html += '<button onclick="gotoIdx(' + idx + ')" style="padding: 2px 8px; background: #555; color: white; border: none; border-radius: 3px; cursor: pointer; font-size: 11px;">Go</button>';
+                html += '<button onclick="clearMarker(' + idx + ')"'
+                    + ' style="padding: 2px 8px; background: #c00; color: white;'
+                    + ' border: none; border-radius: 3px;'
+                    + ' cursor: pointer; font-size: 11px;">×</button>';
+                html += '<button onclick="gotoIdx(' + idx + ')"'
+                    + ' style="padding: 2px 8px; background: #555; color: white;'
+                    + ' border: none; border-radius: 3px;'
+                    + ' cursor: pointer; font-size: 11px;">Go</button>';
                 html += '</div>';
             }
             list.innerHTML = html;
@@ -660,17 +679,19 @@ def send_current_image(self):
         # Get all paths for client-side label computation
         all_paths = [str(p) for p, _ in state.images]
 
-        self.send_json({
-            "data": b64,
-            "path": str(path),
-            "filename": path.name,
-            "idx": state.current_idx,
-            "total": len(state.images),
-            "all_paths": all_paths,
-            "session": state.session_id,
-            "embryo": state.current_embryo,
-            "embryo_list": state.embryo_list,
-        })
+        self.send_json(
+            {
+                "data": b64,
+                "path": str(path),
+                "filename": path.name,
+                "idx": state.current_idx,
+                "total": len(state.images),
+                "all_paths": all_paths,
+                "session": state.session_id,
+                "embryo": state.current_embryo,
+                "embryo_list": state.embryo_list,
+            }
+        )
 
     def switch_embryo(self, embryo_name):
         if embryo_name in state.embryos:
@@ -726,6 +747,7 @@ def save_with_labels(self, labels: dict):
 
 class ThreadedHTTPServer(socketserver.ThreadingMixIn, HTTPServer):
     """Handle requests in separate threads."""
+
     allow_reuse_address = True
     daemon_threads = True
 
@@ -745,6 +767,7 @@ def open_chrome(url):
 
     # Fallback to default browser
     import webbrowser
+
     webbrowser.open(url)
     return False
 
@@ -824,10 +847,10 @@ def signal_handler(sig, frame):
     server = ThreadedHTTPServer(("127.0.0.1", args.port), AnnotatorHandler)
     url = f"http://127.0.0.1:{args.port}"
 
-    logger.info(f"\n{'='*50}")
+    logger.info(f"\n{'=' * 50}")
     logger.info(f"Annotation server running at: {url}")
-    logger.info(f"Press Ctrl+C to stop")
-    logger.info(f"{'='*50}\n")
+    logger.info("Press Ctrl+C to stop")
+    logger.info(f"{'=' * 50}\n")
 
     if not args.no_browser:
         open_chrome(url)
diff --git a/scripts/view_examples.py b/scripts/view_examples.py
index 1d777cf3..1cdb0c9e 100644
--- a/scripts/view_examples.py
+++ b/scripts/view_examples.py
@@ -2,15 +2,15 @@
 Simple web viewer for stage examples with descriptions.
 """
 
-import json
 import base64
-from pathlib import Path
+import json
 from http.server import HTTPServer, SimpleHTTPRequestHandler
-import urllib.parse
+from pathlib import Path
 
 EXAMPLES_DIR = Path(__file__).parent.parent / "gently" / "examples" / "stages"
 STAGES = ["early", "comma", "1.5fold", "pretzel", "hatching", "hatched"]
 
+
 def load_examples():
     """Load all examples with metadata."""
     all_examples = {}
@@ -33,11 +33,13 @@ def load_examples():
                 img_b64 = base64.b64encode(f.read()).decode()
 
             description = metadata.get("examples", {}).get(img_path.name, "")
-            examples.append({
-                "filename": img_path.name,
-                "image_b64": img_b64,
-                "description": description,
-            })
+            examples.append(
+                {
+                    "filename": img_path.name,
+                    "image_b64": img_b64,
+                    "description": description,
+                }
+            )
 
         all_examples[stage] = {
             "description": metadata.get("description", ""),
@@ -46,6 +48,7 @@ def load_examples():
 
     return all_examples
 
+
 def generate_html():
     """Generate HTML page showing all examples."""
     examples = load_examples()
@@ -134,18 +137,22 @@ def generate_html():
     <div class="stage-section">
         <div class="stage-header">
             <span class="stage-name">{stage}</span>
-            <span class="stage-desc">{stage_data['description']}</span>
+            <span class="stage-desc">{stage_data["description"]}</span>
         </div>
         <div class="examples-grid">
 """
 
         for ex in stage_data["examples"]:
-            desc_html = ex["description"] if ex["description"] else '<span class="no-desc">No description</span>'
+            desc_html = (
+                ex["description"]
+                if ex["description"]
+                else '<span class="no-desc">No description</span>'
+            )
             html += f"""
             <div class="example-card">
-                <img src="data:image/jpeg;base64,{ex['image_b64']}" alt="{ex['filename']}">
+                <img src="data:image/jpeg;base64,{ex["image_b64"]}" alt="{ex["filename"]}">
                 <div class="example-info">
-                    <div class="example-filename">{ex['filename']}</div>
+                    <div class="example-filename">{ex["filename"]}</div>
                     <div class="example-description">{desc_html}</div>
                 </div>
             </div>
@@ -179,9 +186,9 @@ def do_GET(self):
 def main():
     port = 8766
     server = HTTPServer(("127.0.0.1", port), ExamplesHandler)
-    print(f"\n{'='*50}")
+    print(f"\n{'=' * 50}")
     print(f"Examples viewer running at: http://127.0.0.1:{port}")
-    print(f"{'='*50}\n")
+    print(f"{'=' * 50}\n")
     server.serve_forever()
 
 
diff --git a/scripts/watch_callbacks.py b/scripts/watch_callbacks.py
index 1c99c974..6d859986 100644
--- a/scripts/watch_callbacks.py
+++ b/scripts/watch_callbacks.py
@@ -25,16 +25,15 @@
 import asyncio
 import json
 import re
-import signal
 import sys
 import time
 from collections import Counter
-from typing import Any, Dict, Optional
+from typing import Any
 
 import aiohttp
 
 
-def _fmt_event(idx: int, payload: Dict[str, Any]) -> str:
+def _fmt_event(idx: int, payload: dict[str, Any]) -> str:
     kind = payload.get("kind", "?")
     t = payload.get("t", 0.0)
     extras = {k: v for k, v in payload.items() if k not in ("kind", "t")}
@@ -42,7 +41,7 @@ def _fmt_event(idx: int, payload: Dict[str, Any]) -> str:
     return f"[{idx:>5}] t={t:.3f}  {kind:<32} {extras_str}"
 
 
-async def watch(host: str, port: int, raw: bool, grep: Optional[str], tally: bool) -> None:
+async def watch(host: str, port: int, raw: bool, grep: str | None, tally: bool) -> None:
     url = f"http://{host}:{port}/api/devices/callbacks/stream"
     pattern = re.compile(grep, re.IGNORECASE) if grep else None
     tally_counts: Counter[str] = Counter()
@@ -100,8 +99,11 @@ def main() -> None:
     p.add_argument("--port", type=int, default=60610)
     p.add_argument("--raw", action="store_true", help="Print full JSON per line")
     p.add_argument("--grep", help="Only print events whose `kind` matches this regex")
-    p.add_argument("--tally", action="store_true",
-                   help="At exit, print a count of each event kind seen")
+    p.add_argument(
+        "--tally",
+        action="store_true",
+        help="At exit, print a count of each event kind seen",
+    )
     args = p.parse_args()
 
     try:
diff --git a/scripts/watch_devices.py b/scripts/watch_devices.py
index c98e16c5..af7c27ca 100644
--- a/scripts/watch_devices.py
+++ b/scripts/watch_devices.py
@@ -18,12 +18,12 @@
 import json
 import sys
 import time
-from typing import Any, Dict
+from typing import Any
 
 import aiohttp
 
 
-def _fmt_positions(positions: Dict[str, Any]) -> str:
+def _fmt_positions(positions: dict[str, Any]) -> str:
     if not positions:
         return "(no positions)"
     parts = []
@@ -40,7 +40,7 @@ def _fmt_positions(positions: Dict[str, Any]) -> str:
     return " | ".join(parts)
 
 
-def _print_event(idx: int, payload: Dict[str, Any], raw: bool) -> None:
+def _print_event(idx: int, payload: dict[str, Any], raw: bool) -> None:
     if raw:
         print(json.dumps(payload), flush=True)
         return
@@ -74,7 +74,7 @@ async def watch_stream(host: str, port: int, raw: bool) -> None:
             if resp.status != 200:
                 print(f"HTTP {resp.status}: {await resp.text()}", file=sys.stderr)
                 sys.exit(1)
-            print(f"Connected. Press Ctrl+C to stop.\n", file=sys.stderr)
+            print("Connected. Press Ctrl+C to stop.\n", file=sys.stderr)
 
             buffer = b""
             idx = 0
@@ -104,7 +104,7 @@ async def watch_stream(host: str, port: int, raw: bool) -> None:
                         continue
                     idx += 1
                     if is_snapshot and not raw:
-                        print(f"-- snapshot --", flush=True)
+                        print("-- snapshot --", flush=True)
                     _print_event(idx, payload, raw)
 
             elapsed = time.monotonic() - t0
@@ -132,12 +132,17 @@ def main() -> None:
     p = argparse.ArgumentParser(description=__doc__)
     p.add_argument("--host", default="127.0.0.1")
     p.add_argument("--port", type=int, default=60610)
-    p.add_argument("--once", action="store_true",
-                   help="Fetch one-shot via /api/devices/state and exit")
-    p.add_argument("--refresh", action="store_true",
-                   help="With --once, force a fresh read (?refresh=1)")
-    p.add_argument("--raw", action="store_true",
-                   help="Print raw JSON (one object per line)")
+    p.add_argument(
+        "--once",
+        action="store_true",
+        help="Fetch one-shot via /api/devices/state and exit",
+    )
+    p.add_argument(
+        "--refresh",
+        action="store_true",
+        help="With --once, force a fresh read (?refresh=1)",
+    )
+    p.add_argument("--raw", action="store_true", help="Print raw JSON (one object per line)")
     args = p.parse_args()
 
     try:
diff --git a/scripts/watch_position.py b/scripts/watch_position.py
index 2a4e2ff9..ff0dfc46 100644
--- a/scripts/watch_position.py
+++ b/scripts/watch_position.py
@@ -19,14 +19,14 @@
 import sys
 import time
 from collections import deque
-from typing import Any, Deque, Dict, Optional, Tuple
+from typing import Any
 
 import aiohttp
 
 
-def _split_positions(positions: Dict[str, Any]) -> Tuple[Optional[float], Optional[float],
-                                                         Optional[float],
-                                                         Optional[float], Optional[float]]:
+def _split_positions(
+    positions: dict[str, Any],
+) -> tuple[float | None, float | None, float | None, float | None, float | None]:
     """(x, y, z, galvo_a, galvo_b) from a positions payload, any missing as None."""
     x = y = z = a = b = None
     for entry in (positions or {}).values():
@@ -40,7 +40,7 @@ def _split_positions(positions: Dict[str, Any]) -> Tuple[Optional[float], Option
     return x, y, z, a, b
 
 
-def _fmt(v: Optional[float], digits: int = 2) -> str:
+def _fmt(v: float | None, digits: int = 2) -> str:
     if v is None:
         return f"{'—':>10}"
     return f"{v:>10.{digits}f}"
@@ -51,7 +51,7 @@ async def watch(host: str, port: int, log_mode: bool) -> None:
     print(f"Connecting to {url}…", file=sys.stderr)
 
     # Track last 20 arrivals for FPS calculation.
-    arrivals: Deque[float] = deque(maxlen=20)
+    arrivals: deque[float] = deque(maxlen=20)
     last_print = 0.0
     count = 0
 
@@ -120,8 +120,11 @@ def main() -> None:
     p = argparse.ArgumentParser(description=__doc__)
     p.add_argument("--host", default="127.0.0.1")
     p.add_argument("--port", type=int, default=60610)
-    p.add_argument("--log", action="store_true",
-                   help="Print one line per update instead of overwriting")
+    p.add_argument(
+        "--log",
+        action="store_true",
+        help="Print one line per update instead of overwriting",
+    )
     args = p.parse_args()
 
     try:
diff --git a/start_device_layer.py b/start_device_layer.py
index 1ce25931..9daae9c6 100644
--- a/start_device_layer.py
+++ b/start_device_layer.py
@@ -13,8 +13,8 @@
     python start_device_layer.py --sam-device cpu
 """
 
-import asyncio
 import argparse
+import asyncio
 import logging
 import signal
 import sys
@@ -37,6 +37,7 @@ def _render_startup_failure(exc, log_file):
     """
     import re
     import traceback
+
     from gently.hardware import console_ui as cui
 
     logging.getLogger("gently.device_layer").error(
@@ -94,29 +95,25 @@ def main():
     - HTTP API on the specified port for plan submission
     - Hardware control via the configured hardware module
     - SAM embryo detection via /api/detect_embryos (if supported)
-        """
-    )
-    parser.add_argument(
-        "--port",
-        type=int,
-        default=60610,
-        help="HTTP API port (default: 60610)"
+        """,
     )
+    parser.add_argument("--port", type=int, default=60610, help="HTTP API port (default: 60610)")
     parser.add_argument(
         "--sam-device",
         default="cuda",
         choices=["cuda", "cpu"],
-        help="Device for SAM model inference (default: cuda)"
+        help="Device for SAM model inference (default: cuda)",
     )
     parser.add_argument(
         "--config",
         default="config/config.yml",
-        help="Path to config.yml (default: config/config.yml)"
+        help="Path to config.yml (default: config/config.yml)",
     )
 
     args = parser.parse_args()
 
     from datetime import datetime
+
     from gently.settings import settings
 
     log_dir = Path(settings.storage.base_path) / "logs"
@@ -137,7 +134,9 @@ def main():
 
     file_handler = logging.FileHandler(str(log_file), encoding="utf-8")
     file_handler.setLevel(logging.INFO)
-    file_handler.setFormatter(logging.Formatter("%(asctime)s %(name)s %(levelname)s %(funcName)s:%(lineno)d %(message)s"))
+    file_handler.setFormatter(
+        logging.Formatter("%(asctime)s %(name)s %(levelname)s %(funcName)s:%(lineno)d %(message)s")
+    )
 
     logging.basicConfig(level=logging.DEBUG, handlers=[console, file_handler])
     logging.getLogger().info("Logging to %s", log_file)
@@ -153,6 +152,7 @@ def main():
     hardware_name = config.get("hardware", "dispim")
 
     from gently.hardware import console_ui as cui
+
     cui.out()
     cui.header(f"GENTLY{cui.MIDDOT}DEVICE LAYER", badge="starting", badge_style="cyan")
     cui.row("Hardware", str(hardware_name))
@@ -164,17 +164,20 @@ def main():
 
     # Load hardware module and create device layer
     from gently.hardware import load_hardware
+
     hw = load_hardware(hardware_name)
 
-    if not hasattr(hw, 'create_device_layer'):
+    if not hasattr(hw, "create_device_layer"):
         print(f"Error: Hardware module '{hardware_name}' does not provide create_device_layer().")
         print("The hardware module must implement this factory function.")
         sys.exit(1)
 
-    server = hw.create_device_layer({
-        'config_path': args.config,
-        'sam_device': args.sam_device,
-    })
+    server = hw.create_device_layer(
+        {
+            "config_path": args.config,
+            "sam_device": args.sam_device,
+        }
+    )
 
     async def run_server():
         # Set up signal handling within the async context
@@ -186,11 +189,11 @@ def request_shutdown():
             logging.getLogger("gently.device_layer.signal").warning(
                 "Interrupt signal received — initiating shutdown"
             )
-            if hasattr(server, '_shutdown_event'):
+            if hasattr(server, "_shutdown_event"):
                 server._shutdown_event.set()
 
         # On Windows, use signal.signal; on Unix, use loop.add_signal_handler
-        if sys.platform == 'win32':
+        if sys.platform == "win32":
             # Windows: use signal module with thread-safe callback
             def win_signal_handler(sig, frame):
                 loop.call_soon_threadsafe(request_shutdown)
diff --git a/tests/conftest.py b/tests/conftest.py
index be2fcb53..08da7e77 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -3,7 +3,6 @@
 """
 
 import pytest
-from pathlib import Path
 
 from gently.core.event_bus import EventBus
 
@@ -20,6 +19,7 @@ def config_dir(tmp_path):
 def store(tmp_path):
     """Fresh GentlyStore for tests."""
     from gently.core.store import GentlyStore
+
     s = GentlyStore(tmp_path / "gently_test")
     yield s
     s.close()
@@ -29,6 +29,7 @@ def store(tmp_path):
 def context_store(tmp_path):
     """Fresh ContextStore for tests."""
     from gently.harness.memory.store import ContextStore
+
     cs = ContextStore(tmp_path / "context_test.db")
     yield cs
     cs.close()
@@ -38,6 +39,7 @@ def context_store(tmp_path):
 def file_store(tmp_path):
     """Fresh FileStore for tests."""
     from gently.core.file_store import FileStore
+
     s = FileStore(tmp_path / "gently3_test")
     yield s
     s.close()
@@ -47,6 +49,7 @@ def file_store(tmp_path):
 def file_context_store(tmp_path):
     """Fresh FileContextStore for tests."""
     from gently.harness.memory.file_store import FileContextStore
+
     cs = FileContextStore(tmp_path / "agent_test")
     yield cs
     cs.close()
diff --git a/tests/test_analysis_core.py b/tests/test_analysis_core.py
index f59b1284..c98571f2 100644
--- a/tests/test_analysis_core.py
+++ b/tests/test_analysis_core.py
@@ -16,14 +16,14 @@
 import pytest
 
 from gently.analysis.core import (
-    calculate_focus_score,
-    fit_focus_curve,
-    analyze_focus_stack,
-    create_focus_montage,
     AdaptiveSweepState,
-    FocusAlgorithm,
     FitFunction,
+    FocusAlgorithm,
     FocusAnalysisConfig,
+    analyze_focus_stack,
+    calculate_focus_score,
+    create_focus_montage,
+    fit_focus_curve,
 )
 
 
@@ -32,13 +32,14 @@ def _make_focused_image(size=128):
     img = np.zeros((size, size), dtype=np.float64)
     # Sharp square in center
     q = size // 4
-    img[q:3*q, q:3*q] = 200.0
+    img[q : 3 * q, q : 3 * q] = 200.0
     return img
 
 
 def _make_blurry_image(size=128):
     """Create a synthetic blurry image (low focus)."""
     from scipy.ndimage import gaussian_filter
+
     return gaussian_filter(_make_focused_image(size), sigma=10.0)
 
 
@@ -60,6 +61,7 @@ def _make_gaussian_focus_stack(n_positions=20, peak_pos=50.0):
 # Focus scoring
 # =========================================================================
 
+
 class TestFocusScoring:
     def test_volath_focus_score_positive(self):
         img = _make_focused_image()
@@ -96,6 +98,7 @@ def test_3d_image_handled(self):
 # Curve fitting
 # =========================================================================
 
+
 class TestCurveFitting:
     def test_gaussian_fit_finds_peak(self):
         # Create perfect Gaussian data
@@ -138,6 +141,7 @@ def test_fit_needs_minimum_points(self):
 # Adaptive sweep
 # =========================================================================
 
+
 class TestAdaptiveSweep:
     def test_adaptive_sweep_detects_peak(self):
         state = AdaptiveSweepState()
@@ -149,7 +153,7 @@ def test_adaptive_sweep_detects_peak(self):
 
         stopped = False
         stop_reason = None
-        for pos, score in zip(positions, scores):
+        for pos, score in zip(positions, scores, strict=False):
             result = state.add_point(float(pos), max(score, 0.1))
             if result["should_stop"]:
                 stopped = True
@@ -164,6 +168,7 @@ def test_adaptive_sweep_detects_peak(self):
 # Montage
 # =========================================================================
 
+
 class TestFocusMontage:
     def test_focus_montage_shape(self):
         imgs = [np.random.randint(0, 255, (64, 64), dtype=np.uint8) for _ in range(3)]
@@ -183,6 +188,7 @@ def test_focus_montage_single_image(self):
 # End-to-end: analyze_focus_stack
 # =========================================================================
 
+
 class TestAnalyzeFocusStack:
     def test_analyze_focus_stack_basic(self):
         positions, images = _make_gaussian_focus_stack(n_positions=15, peak_pos=50.0)
@@ -207,7 +213,5 @@ def test_analyze_focus_stack_length_mismatch(self):
 
     def test_analyze_focus_stack_too_few(self):
         config = FocusAnalysisConfig()
-        result = analyze_focus_stack(
-            [1, 2], [np.zeros((10, 10)), np.zeros((10, 10))], config
-        )
+        result = analyze_focus_stack([1, 2], [np.zeros((10, 10)), np.zeros((10, 10))], config)
         assert result.success is False
diff --git a/tests/test_campaign_coordination.py b/tests/test_campaign_coordination.py
index 18ee49e2..21f10302 100644
--- a/tests/test_campaign_coordination.py
+++ b/tests/test_campaign_coordination.py
@@ -12,8 +12,8 @@
 import json
 import os
 import sys
-import urllib.request
 import urllib.error
+import urllib.request
 
 BASE = os.environ.get("GENTLY_URL", "http://localhost:8080")
 FAKE_PEER = "test-peer-001"
@@ -92,7 +92,10 @@ def check(name, condition, detail=""):
 
 status, tree = req("GET", f"/api/campaigns/{cid}/export")
 check("GET /export returns 200", status == 200)
-check("Export has children", len(tree.get("children", [])) > 0 or len(tree.get("items", [])) > 0)
+check(
+    "Export has children",
+    len(tree.get("children", [])) > 0 or len(tree.get("items", [])) > 0,
+)
 
 # Find the first item with an ID (enriched)
 first_item_id = None
@@ -109,10 +112,15 @@ def find_first_item(node):
 
 
 find_first_item(tree)
-check("Export items are enriched with IDs", first_item_id is not None, f"id={first_item_id}")
+check(
+    "Export items are enriched with IDs",
+    first_item_id is not None,
+    f"id={first_item_id}",
+)
 
 # Check enrichment fields
 if first_item_id:
+
     def find_item(node, target_id):
         for item in node.get("items", []):
             if item.get("id") == target_id:
@@ -133,10 +141,14 @@ def find_item(node, target_id):
 # ------------------------------------------------------------------
 print("\n--- Join ---")
 
-status, data = req("POST", f"/api/campaigns/{cid}/join", {
-    "instance_id": FAKE_PEER,
-    "hostname": FAKE_HOST,
-})
+status, data = req(
+    "POST",
+    f"/api/campaigns/{cid}/join",
+    {
+        "instance_id": FAKE_PEER,
+        "hostname": FAKE_HOST,
+    },
+)
 check("POST /join returns ok", status == 200 and data.get("ok"))
 
 status, data = req("GET", f"/api/campaigns/{cid}/participants")
@@ -145,10 +157,14 @@ def find_item(node, target_id):
 check("Participant is registered", FAKE_PEER in peer_ids)
 
 # Join is idempotent
-status, data = req("POST", f"/api/campaigns/{cid}/join", {
-    "instance_id": FAKE_PEER,
-    "hostname": FAKE_HOST,
-})
+status, data = req(
+    "POST",
+    f"/api/campaigns/{cid}/join",
+    {
+        "instance_id": FAKE_PEER,
+        "hostname": FAKE_HOST,
+    },
+)
 check("Re-join is idempotent", status == 200)
 
 # Missing instance_id
@@ -163,32 +179,49 @@ def find_item(node, target_id):
 
 if first_item_id:
     # Claim the item
-    status, data = req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/claim", {
-        "instance_id": FAKE_PEER,
-        "hostname": FAKE_HOST,
-    })
+    status, data = req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/claim",
+        {
+            "instance_id": FAKE_PEER,
+            "hostname": FAKE_HOST,
+        },
+    )
     check("POST /claim returns ok", status == 200 and data.get("ok"))
 
     # Re-claim by same peer (idempotent)
-    status, data = req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/claim", {
-        "instance_id": FAKE_PEER,
-        "hostname": FAKE_HOST,
-    })
+    status, data = req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/claim",
+        {
+            "instance_id": FAKE_PEER,
+            "hostname": FAKE_HOST,
+        },
+    )
     check("Re-claim by same peer succeeds", status == 200)
 
     # Conflicting claim by different peer
-    status, data = req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/claim", {
-        "instance_id": CONFLICT_PEER,
-        "hostname": "conflict-machine",
-    })
+    status, data = req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/claim",
+        {
+            "instance_id": CONFLICT_PEER,
+            "hostname": "conflict-machine",
+        },
+    )
     check("Conflicting claim returns 409", status == 409)
 
     # Verify claim shows in export
     status, tree = req("GET", f"/api/campaigns/{cid}/export")
     claimed_item = find_item(tree, first_item_id)
-    check("Claimed item shows claimed_by", (claimed_item or {}).get("claimed_by") == FAKE_PEER)
-    check("Claimed item shows hostname",
-          (claimed_item or {}).get("claimed_by_hostname") == FAKE_HOST)
+    check(
+        "Claimed item shows claimed_by",
+        (claimed_item or {}).get("claimed_by") == FAKE_PEER,
+    )
+    check(
+        "Claimed item shows hostname",
+        (claimed_item or {}).get("claimed_by_hostname") == FAKE_HOST,
+    )
 
 
 # ------------------------------------------------------------------
@@ -197,28 +230,42 @@ def find_item(node, target_id):
 print("\n--- Status Update ---")
 
 if first_item_id:
-    status, data = req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/status", {
-        "status": "in_progress",
-    })
+    status, data = req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/status",
+        {
+            "status": "in_progress",
+        },
+    )
     check("POST /status returns ok", status == 200 and data.get("ok"))
 
     # Verify in export
     status, tree = req("GET", f"/api/campaigns/{cid}/export")
     updated = find_item(tree, first_item_id)
-    check("Item status updated to in_progress",
-          (updated or {}).get("status") == "in_progress")
+    check(
+        "Item status updated to in_progress",
+        (updated or {}).get("status") == "in_progress",
+    )
 
     # With outcome
-    status, data = req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/status", {
-        "status": "completed",
-        "outcome": "Test outcome from coordination test",
-    })
+    status, data = req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/status",
+        {
+            "status": "completed",
+            "outcome": "Test outcome from coordination test",
+        },
+    )
     check("POST /status with outcome returns ok", status == 200)
 
     # Invalid status
-    status, data = req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/status", {
-        "status": "bogus_status",
-    })
+    status, data = req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/status",
+        {
+            "status": "bogus_status",
+        },
+    )
     check("Invalid status returns 400", status == 400)
 
 
@@ -234,8 +281,10 @@ def find_item(node, target_id):
     # Verify claim cleared in export
     status, tree = req("GET", f"/api/campaigns/{cid}/export")
     unclaimed = find_item(tree, first_item_id)
-    check("Unclaimed item has claimed_by=None",
-          (unclaimed or {}).get("claimed_by") is None)
+    check(
+        "Unclaimed item has claimed_by=None",
+        (unclaimed or {}).get("claimed_by") is None,
+    )
 
 
 # ------------------------------------------------------------------
@@ -258,10 +307,14 @@ def find_item(node, target_id):
 print("\n--- Cleanup ---")
 
 if first_item_id:
-    req("POST", f"/api/campaigns/{cid}/items/{first_item_id}/status", {
-        "status": "planned",
-        "outcome": None,
-    })
+    req(
+        "POST",
+        f"/api/campaigns/{cid}/items/{first_item_id}/status",
+        {
+            "status": "planned",
+            "outcome": None,
+        },
+    )
     # Remove participant
     # (no delete endpoint, but that's fine — participants table is cleaned up on campaign delete)
     print(f"  Reset item {first_item_id[:8]} to planned")
@@ -271,8 +324,8 @@ def find_item(node, target_id):
 # Summary
 # ------------------------------------------------------------------
 total = passed + failed
-print(f"\n{'='*40}")
+print(f"\n{'=' * 40}")
 print(f"  {passed}/{total} passed, {failed} failed")
-print(f"{'='*40}")
+print(f"{'=' * 40}")
 
 sys.exit(1 if failed else 0)
diff --git a/tests/test_capability_provider.py b/tests/test_capability_provider.py
index fa1da5a2..d3c12ee6 100644
--- a/tests/test_capability_provider.py
+++ b/tests/test_capability_provider.py
@@ -3,7 +3,6 @@
 """
 
 from unittest.mock import MagicMock, patch
-import pytest
 
 from gently.mesh.capability_provider import DynamicCapabilityProvider
 from gently.mesh.models import PeerRole
@@ -32,6 +31,7 @@ def test_no_gpu_detection(self):
     @patch("gently.mesh.capability_provider._detect_gpus")
     def test_gpu_detected(self, mock_detect):
         from gently.mesh.models import GpuInfo
+
         mock_detect.return_value = [
             GpuInfo(device_index=0, name="A5000", vram_gb=24.0),
         ]
@@ -53,6 +53,7 @@ class TestRoleLogic:
     @patch("gently.mesh.capability_provider._detect_gpus")
     def test_ml_trainer_role_with_gpu(self, mock_detect):
         from gently.mesh.models import GpuInfo
+
         mock_detect.return_value = [GpuInfo(name="A5000")]
         provider = DynamicCapabilityProvider()
         provider._gpus = mock_detect()
diff --git a/tests/test_context_store.py b/tests/test_context_store.py
index 5bb8931d..9c1c77d7 100644
--- a/tests/test_context_store.py
+++ b/tests/test_context_store.py
@@ -4,8 +4,6 @@
 
 from datetime import datetime
 
-import pytest
-
 from gently.harness.memory.model import (
     Confidence,
     Learning,
@@ -23,12 +21,23 @@ def test_tables_exist(self, context_store):
         ).fetchall()
         table_names = {row["name"] for row in tables}
         expected = {
-            "campaigns", "projects", "session_intents", "session_campaigns",
-            "planned_sessions", "planned_session_campaigns",
-            "learnings", "embryo_understanding", "observations",
-            "expectations", "watchpoints", "questions",
-            "plan_items", "plan_item_dependencies",
-            "plan_templates", "plan_snapshots", "agent_state",
+            "campaigns",
+            "projects",
+            "session_intents",
+            "session_campaigns",
+            "planned_sessions",
+            "planned_session_campaigns",
+            "learnings",
+            "embryo_understanding",
+            "observations",
+            "expectations",
+            "watchpoints",
+            "questions",
+            "plan_items",
+            "plan_item_dependencies",
+            "plan_templates",
+            "plan_snapshots",
+            "agent_state",
             "campaign_participants",
         }
         for t in expected:
@@ -70,8 +79,8 @@ def test_get_root_campaigns(self, context_store):
 
     def test_subcampaigns(self, context_store):
         root = context_store.create_campaign(description="Root")
-        child1 = context_store.create_campaign(description="Phase 1", parent_id=root)
-        child2 = context_store.create_campaign(description="Phase 2", parent_id=root)
+        context_store.create_campaign(description="Phase 1", parent_id=root)
+        context_store.create_campaign(description="Phase 2", parent_id=root)
         children = context_store.get_subcampaigns(root)
         assert len(children) == 2
 
@@ -118,7 +127,9 @@ class TestPlanItems:
     def test_create_and_get(self, context_store):
         cid = context_store.create_campaign(description="C1")
         item_id = context_store.create_plan_item(
-            campaign_id=cid, type="imaging", title="Image embryos",
+            campaign_id=cid,
+            type="imaging",
+            title="Image embryos",
             description="20C timelapse",
         )
         item = context_store.get_plan_item(item_id)
@@ -138,7 +149,9 @@ def test_auto_phase_order(self, context_store):
     def test_update_status(self, context_store):
         cid = context_store.create_campaign(description="C1")
         item_id = context_store.create_plan_item(
-            campaign_id=cid, type="imaging", title="T1",
+            campaign_id=cid,
+            type="imaging",
+            title="T1",
         )
         context_store.complete_plan_item(item_id, "Successful — 12 embryos")
         item = context_store.get_plan_item(item_id)
@@ -149,7 +162,9 @@ def test_dependencies(self, context_store):
         cid = context_store.create_campaign(description="C1")
         id1 = context_store.create_plan_item(campaign_id=cid, type="bench", title="Prepare worms")
         id2 = context_store.create_plan_item(
-            campaign_id=cid, type="imaging", title="Image worms",
+            campaign_id=cid,
+            type="imaging",
+            title="Image worms",
             depends_on=[id1],
         )
         deps = context_store.get_plan_item_dependencies(id2)
@@ -179,7 +194,9 @@ def test_get_plan_status(self, context_store):
     def test_claim_plan_item(self, context_store):
         cid = context_store.create_campaign(description="C1")
         item_id = context_store.create_plan_item(
-            campaign_id=cid, type="imaging", title="T1",
+            campaign_id=cid,
+            type="imaging",
+            title="T1",
         )
         success = context_store.claim_plan_item(item_id, "peer-1", "workstation")
         assert success is True
@@ -192,7 +209,9 @@ def test_claim_plan_item(self, context_store):
     def test_unclaim_plan_item(self, context_store):
         cid = context_store.create_campaign(description="C1")
         item_id = context_store.create_plan_item(
-            campaign_id=cid, type="imaging", title="T1",
+            campaign_id=cid,
+            type="imaging",
+            title="T1",
         )
         context_store.claim_plan_item(item_id, "peer-1", "ws")
         context_store.unclaim_plan_item(item_id)
@@ -202,7 +221,9 @@ def test_unclaim_plan_item(self, context_store):
     def test_delete_plan_item(self, context_store):
         cid = context_store.create_campaign(description="C1")
         item_id = context_store.create_plan_item(
-            campaign_id=cid, type="imaging", title="T1",
+            campaign_id=cid,
+            type="imaging",
+            title="T1",
         )
         deleted = context_store.delete_plan_item(item_id)
         assert deleted is True
@@ -235,13 +256,15 @@ def test_add_and_retrieve(self, context_store):
 
     def test_filter_by_embryo(self, context_store):
         for i in range(3):
-            context_store.add_observation(Observation(
-                id=f"obs-{i}",
-                timestamp=datetime.now(),
-                type="check",
-                content=f"Check {i}",
-                embryo_id="emb-1" if i < 2 else "emb-2",
-            ))
+            context_store.add_observation(
+                Observation(
+                    id=f"obs-{i}",
+                    timestamp=datetime.now(),
+                    type="check",
+                    content=f"Check {i}",
+                    embryo_id="emb-1" if i < 2 else "emb-2",
+                )
+            )
         emb1_obs = context_store.get_observations_for_embryo("emb-1")
         assert len(emb1_obs) == 2
 
@@ -262,11 +285,13 @@ def test_add_and_retrieve(self, context_store):
 
     def test_multiple_learnings(self, context_store):
         for i in range(5):
-            context_store.add_learning(Learning(
-                id=f"learn-{i}",
-                content=f"Learning {i}",
-                created_at=datetime.now(),
-            ))
+            context_store.add_learning(
+                Learning(
+                    id=f"learn-{i}",
+                    content=f"Learning {i}",
+                    created_at=datetime.now(),
+                )
+            )
         learnings = context_store.get_learnings()
         assert len(learnings) == 5
 
@@ -288,9 +313,13 @@ def test_overwrite(self, context_store):
 class TestReset:
     def test_reset_clears_data(self, context_store):
         context_store.create_campaign(description="C1")
-        context_store.add_learning(Learning(
-            id="l1", content="test", created_at=datetime.now(),
-        ))
+        context_store.add_learning(
+            Learning(
+                id="l1",
+                content="test",
+                created_at=datetime.now(),
+            )
+        )
         counts = context_store.reset()
         assert sum(counts.values()) > 0
         assert len(context_store.get_active_campaigns()) == 0
@@ -300,6 +329,7 @@ def test_reset_clears_data(self, context_store):
 class TestContextManager:
     def test_context_manager(self, tmp_path):
         from gently.harness.memory.store import ContextStore
+
         with ContextStore(tmp_path / "ctx.db") as cs:
             cs.create_campaign(description="Test")
             assert len(cs.get_active_campaigns()) == 1
diff --git a/tests/test_coordinates.py b/tests/test_coordinates.py
index f2b7506b..116753a0 100644
--- a/tests/test_coordinates.py
+++ b/tests/test_coordinates.py
@@ -15,12 +15,12 @@
 import pytest
 
 from gently.core.coordinates import (
+    DEFAULT_OBJECTIVE_MAG,
+    DEFAULT_PIXEL_SIZE_UM,
     get_um_per_pixel,
+    pixel_displacement_to_stage_movement,
     pixel_to_stage_position,
     stage_to_pixel_position,
-    pixel_displacement_to_stage_movement,
-    DEFAULT_PIXEL_SIZE_UM,
-    DEFAULT_OBJECTIVE_MAG,
 )
 
 
@@ -39,9 +39,12 @@ class TestPixelToStage:
     def test_pixel_to_stage_basic(self):
         # Embryo 100px right of center → stage X increases
         sx, sy = pixel_to_stage_position(
-            pixel_x=612, pixel_y=512,
-            image_center_x=512, image_center_y=512,
-            stage_x=1000.0, stage_y=2000.0,
+            pixel_x=612,
+            pixel_y=512,
+            image_center_x=512,
+            image_center_y=512,
+            stage_x=1000.0,
+            stage_y=2000.0,
             um_per_pixel=1.0,
         )
         assert sx == pytest.approx(1100.0)
@@ -51,9 +54,12 @@ def test_pixel_to_stage_basic(self):
     def test_center_pixel_maps_to_stage_origin(self):
         # Embryo at image center → stage position unchanged
         sx, sy = pixel_to_stage_position(
-            pixel_x=512, pixel_y=512,
-            image_center_x=512, image_center_y=512,
-            stage_x=1000.0, stage_y=2000.0,
+            pixel_x=512,
+            pixel_y=512,
+            image_center_x=512,
+            image_center_y=512,
+            stage_x=1000.0,
+            stage_y=2000.0,
             um_per_pixel=1.0,
         )
         assert sx == pytest.approx(1000.0)
@@ -64,9 +70,12 @@ class TestStageToPixel:
     def test_stage_to_pixel_basic(self):
         # Embryo 100um right of current stage → pixel right of center
         px, py = stage_to_pixel_position(
-            stage_x=1100.0, stage_y=2000.0,
-            current_stage_x=1000.0, current_stage_y=2000.0,
-            image_center_x=512, image_center_y=512,
+            stage_x=1100.0,
+            stage_y=2000.0,
+            current_stage_x=1000.0,
+            current_stage_y=2000.0,
+            image_center_x=512,
+            image_center_y=512,
             um_per_pixel=1.0,
         )
         assert px == pytest.approx(612.0)
@@ -83,12 +92,24 @@ def test_round_trip_pixel_stage(self):
 
         # Forward: pixel → stage
         embryo_sx, embryo_sy = pixel_to_stage_position(
-            orig_px, orig_py, cx, cy, stg_x, stg_y, um_per_pixel=um_pp,
+            orig_px,
+            orig_py,
+            cx,
+            cy,
+            stg_x,
+            stg_y,
+            um_per_pixel=um_pp,
         )
 
         # Reverse: stage → pixel (same capture position)
         recovered_px, recovered_py = stage_to_pixel_position(
-            embryo_sx, embryo_sy, stg_x, stg_y, cx, cy, um_per_pixel=um_pp,
+            embryo_sx,
+            embryo_sy,
+            stg_x,
+            stg_y,
+            cx,
+            cy,
+            um_per_pixel=um_pp,
         )
 
         assert recovered_px == pytest.approx(orig_px)
@@ -109,5 +130,5 @@ def test_zero_displacement(self):
 
     def test_negative_displacement(self):
         dx, dy = pixel_displacement_to_stage_movement(-50.0, 30.0, um_per_pixel=2.0)
-        assert dx == pytest.approx(100.0)   # inverted: -(-50)*2
-        assert dy == pytest.approx(60.0)    # not inverted: 30*2
+        assert dx == pytest.approx(100.0)  # inverted: -(-50)*2
+        assert dy == pytest.approx(60.0)  # not inverted: 30*2
diff --git a/tests/test_data_catalog.py b/tests/test_data_catalog.py
index 18fcd861..6668d5bf 100644
--- a/tests/test_data_catalog.py
+++ b/tests/test_data_catalog.py
@@ -4,7 +4,6 @@
 
 from unittest.mock import MagicMock
 
-import pytest
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
@@ -35,10 +34,12 @@ def list_embryos(sid):
             e.nickname = eid
             result.append(e)
         return result
+
     store.list_embryos.side_effect = list_embryos
 
     def list_volumes(sid, eid):
         return [MagicMock(timepoint=i) for i in range(3)]
+
     store.list_volumes.side_effect = list_volumes
 
     def get_ground_truth(sid, eid):
@@ -51,6 +52,7 @@ def get_ground_truth(sid, eid):
             gt.end_tp = 10
             result.append(gt)
         return result
+
     store.get_ground_truth.side_effect = get_ground_truth
 
     def get_session(sid):
@@ -58,6 +60,7 @@ def get_session(sid):
             if s.session_id == sid:
                 return s
         return None
+
     store.get_session.side_effect = get_session
 
     return store
diff --git a/tests/test_database_utils.py b/tests/test_database_utils.py
index b87b503c..a5b05cb6 100644
--- a/tests/test_database_utils.py
+++ b/tests/test_database_utils.py
@@ -3,21 +3,21 @@
 """
 
 import json
-import pytest
-import numpy as np
-from pathlib import Path
 from datetime import datetime
 
+import numpy as np
+import pytest
+
 from gently.core.database import (
-    format_timestamp,
-    numpy_to_python,
+    add_embryo_to_database,
     format_embryo_calibration_for_json,
     format_embryo_entry_for_json,
-    load_multi_embryo_database,
-    save_multi_embryo_database,
-    add_embryo_to_database,
+    format_timestamp,
     get_embryo_calibration,
     list_embryos,
+    load_multi_embryo_database,
+    numpy_to_python,
+    save_multi_embryo_database,
 )
 
 
@@ -57,7 +57,7 @@ def test_result_is_json_serializable(self):
             "array": np.zeros(3),
             "int": np.int32(5),
             "float": np.float32(2.5),
-            "nested": {"x": np.array([1, 2])}
+            "nested": {"x": np.array([1, 2])},
         }
         result = numpy_to_python(data)
         # Must not raise
@@ -83,9 +83,9 @@ class TestFormatCalibration:
 
     def test_fills_missing_required_fields(self):
         result = format_embryo_calibration_for_json({})
-        assert 'slope_um_per_deg' in result
-        assert 'timestamp' in result
-        assert result['sample_type'] == 'embryo'
+        assert "slope_um_per_deg" in result
+        assert "timestamp" in result
+        assert result["sample_type"] == "embryo"
 
     def test_preserves_existing_data(self):
         data = {"slope_um_per_deg": 95.5, "offset_um": 3.0}
@@ -104,18 +104,17 @@ class TestFormatEmbryoEntry:
     def test_basic_entry(self):
         data = {
             "embryo_number": 1,
-            "pixel_x": 500.0, "pixel_y": 300.0,
-            "initial_stage_x": 1000.0, "initial_stage_y": 200.0,
+            "pixel_x": 500.0,
+            "pixel_y": 300.0,
+            "initial_stage_x": 1000.0,
+            "initial_stage_y": 200.0,
         }
         result = format_embryo_entry_for_json(data)
         assert result["embryo_number"] == 1
         assert result["bottom_camera_position_pixel"]["x"] == 500.0
 
     def test_with_calibration(self):
-        data = {
-            "embryo_number": 1,
-            "calibration": {"slope_um_per_deg": 95.0}
-        }
+        data = {"embryo_number": 1, "calibration": {"slope_um_per_deg": 95.0}}
         result = format_embryo_entry_for_json(data)
         assert "calibration" in result
 
@@ -125,7 +124,7 @@ class TestDatabaseFileOps:
 
     def test_load_missing_returns_empty(self, tmp_path):
         db = load_multi_embryo_database(tmp_path / "nonexistent.json")
-        assert db['embryos'] == {}
+        assert db["embryos"] == {}
 
     def test_save_and_load_roundtrip(self, tmp_path):
         path = tmp_path / "db.json"
@@ -143,13 +142,7 @@ def test_add_embryo(self):
         assert "embryo_001" in db["embryos"]
 
     def test_get_calibration(self):
-        db = {
-            "embryos": {
-                "embryo_001": {
-                    "calibration": {"slope_um_per_deg": 95.0}
-                }
-            }
-        }
+        db = {"embryos": {"embryo_001": {"calibration": {"slope_um_per_deg": 95.0}}}}
         cal = get_embryo_calibration(db, "embryo_001")
         assert cal["slope_um_per_deg"] == 95.0
 
diff --git a/tests/test_detector.py b/tests/test_detector.py
index ec66fb35..3a09d140 100644
--- a/tests/test_detector.py
+++ b/tests/test_detector.py
@@ -2,20 +2,22 @@
 Tests for the generic detector system: conditions, scheduling, response parsing.
 """
 
-import pytest
 from datetime import datetime
 
 from gently.harness.detection.detector import (
-    DetectionMode, ConfidenceLevel,
-    DetectorConditions, DetectorActions, DetectionResult,
+    ConfidenceLevel,
+    DetectionMode,
+    DetectionResult,
     Detector,
+    DetectorActions,
+    DetectorConditions,
 )
 
-
 # ===========================================================================
 # DetectorConditions
 # ===========================================================================
 
+
 class TestDetectorConditions:
     """DetectorConditions controls when detectors run."""
 
@@ -57,8 +59,10 @@ def test_min_interval(self):
 
     def test_combined_conditions(self):
         cond = DetectorConditions(
-            min_timepoint=10, max_timepoint=100,
-            embryo_ids=["e1"], min_interval_timepoints=3,
+            min_timepoint=10,
+            max_timepoint=100,
+            embryo_ids=["e1"],
+            min_interval_timepoints=3,
         )
         # Too early
         assert not cond.should_run("e1", 5, None, False)
@@ -74,6 +78,7 @@ def test_combined_conditions(self):
 # Detector
 # ===========================================================================
 
+
 class TestDetector:
     """Detector scheduling and state tracking."""
 
@@ -95,18 +100,14 @@ def test_should_run_disabled(self):
         assert not d.should_run("e1", 10)
 
     def test_mark_run_tracks_timepoint(self):
-        d = self._make_detector(
-            conditions=DetectorConditions(min_interval_timepoints=5)
-        )
+        d = self._make_detector(conditions=DetectorConditions(min_interval_timepoints=5))
         d.mark_run("e1", 10)
         assert d.run_count == 1
         assert not d.should_run("e1", 12)  # Too soon
         assert d.should_run("e1", 15)
 
     def test_mark_detected(self):
-        d = self._make_detector(
-            conditions=DetectorConditions(run_if_detected=False)
-        )
+        d = self._make_detector(conditions=DetectorConditions(run_if_detected=False))
         assert not d.was_detected("e1")
         d.mark_detected("e1")
         assert d.was_detected("e1")
@@ -115,9 +116,7 @@ def test_mark_detected(self):
 
     def test_per_embryo_tracking(self):
         """Detection state is tracked per-embryo."""
-        d = self._make_detector(
-            conditions=DetectorConditions(run_if_detected=False)
-        )
+        d = self._make_detector(conditions=DetectorConditions(run_if_detected=False))
         d.mark_detected("e1")
         assert d.was_detected("e1")
         assert not d.was_detected("e2")
@@ -128,42 +127,40 @@ def test_per_embryo_tracking(self):
 # Response Parsing
 # ===========================================================================
 
+
 class TestDetectorResponseParsing:
     """Detector parses Claude Vision API responses."""
 
     def _make_detector(self):
-        return Detector(
-            name="test", description="test",
-            detection_prompt="detect something"
-        )
+        return Detector(name="test", description="test", detection_prompt="detect something")
 
     def test_parse_yes_high(self):
         d = self._make_detector()
         result = d.parse_detection_response(
             "DETECTED: YES\nCONFIDENCE: HIGH\nREASONING: Clear comma shape visible"
         )
-        assert result['detected'] is True
-        assert result['confidence'] == ConfidenceLevel.HIGH
-        assert "comma" in result['reasoning']
+        assert result["detected"] is True
+        assert result["confidence"] == ConfidenceLevel.HIGH
+        assert "comma" in result["reasoning"]
 
     def test_parse_no_low(self):
         d = self._make_detector()
         result = d.parse_detection_response(
             "DETECTED: NO\nCONFIDENCE: LOW\nREASONING: No visible features"
         )
-        assert result['detected'] is False
-        assert result['confidence'] == ConfidenceLevel.LOW
+        assert result["detected"] is False
+        assert result["confidence"] == ConfidenceLevel.LOW
 
     def test_parse_true_as_detected(self):
         d = self._make_detector()
         result = d.parse_detection_response("DETECTED: TRUE\nCONFIDENCE: MEDIUM")
-        assert result['detected'] is True
+        assert result["detected"] is True
 
     def test_parse_missing_fields(self):
         d = self._make_detector()
         result = d.parse_detection_response("Some random response")
-        assert result['detected'] is False
-        assert result['confidence'] is None
+        assert result["detected"] is False
+        assert result["confidence"] is None
 
     def test_parse_multiline_reasoning(self):
         """Multiline reasoning is captured when it spans multiple lines."""
@@ -174,13 +171,14 @@ def test_parse_multiline_reasoning(self):
         result = d.parse_detection_response(
             "DETECTED: YES\nCONFIDENCE: HIGH\nREASONING: The embryo shows clear elongation"
         )
-        assert "elongation" in result['reasoning']
+        assert "elongation" in result["reasoning"]
 
 
 # ===========================================================================
 # Serialization
 # ===========================================================================
 
+
 class TestDetectorSerialization:
     """Detector serialization roundtrip."""
 
@@ -192,8 +190,8 @@ def test_to_dict(self):
             confidence_threshold=ConfidenceLevel.HIGH,
         )
         data = d.to_dict()
-        assert data['name'] == 'comma_stage'
-        assert data['confidence_threshold'] == 'HIGH'
+        assert data["name"] == "comma_stage"
+        assert data["confidence_threshold"] == "HIGH"
 
     def test_roundtrip(self):
         original = Detector(
@@ -230,9 +228,9 @@ def test_to_dict(self):
             reasoning="Clear comma shape",
         )
         d = r.to_dict()
-        assert d['detected'] is True
-        assert d['confidence'] == 'HIGH'
-        assert isinstance(d['timestamp'], str)
+        assert d["detected"] is True
+        assert d["confidence"] == "HIGH"
+        assert isinstance(d["timestamp"], str)
 
 
 class TestDetectorActions:
diff --git a/tests/test_device_state_monitor.py b/tests/test_device_state_monitor.py
index 9c7b6536..f802da3b 100644
--- a/tests/test_device_state_monitor.py
+++ b/tests/test_device_state_monitor.py
@@ -11,18 +11,16 @@
 
 import asyncio
 
-import pytest
-
 from gently.app.device_state_monitor import DeviceStateMonitor
 from gently.core.event_bus import EventBus, EventType
 
-
 # ---------------------------------------------------------------------------
 # Fake microscope: yields events from an async generator that the test
 # can advance, pause, or replace. Mirrors the shape DiSPIMMicroscope's
 # stream_device_states() exposes (async iterator of payload dicts).
 # ---------------------------------------------------------------------------
 
+
 class _FakeMicroscope:
     """Replaceable stream source. ``connect_count`` tracks reconnects."""
 
@@ -53,6 +51,7 @@ async def _gen():
             # is the only way out.
             while True:
                 await asyncio.sleep(60)
+
         return _gen()
 
 
@@ -64,11 +63,13 @@ def _run(coro):
 def _patch_bus(local_bus):
     """Context-manager style: swap module-level get_event_bus for a local one."""
     from gently.app import device_state_monitor as mod
+
     original = mod.get_event_bus
     mod.get_event_bus = lambda: local_bus
 
     def restore():
         mod.get_event_bus = original
+
     return restore
 
 
@@ -76,6 +77,7 @@ def restore():
 # Tests
 # ---------------------------------------------------------------------------
 
+
 def test_monitor_publishes_each_event():
     """Every payload from the stream becomes a DEVICE_STATE_UPDATE."""
     bus_seen = []
@@ -87,10 +89,12 @@ def test_monitor_publishes_each_event():
     fake.script = [(0.0, {"i": 0}), (0.05, {"i": 1}), (0.05, {"i": 2})]
 
     async def go():
-        mon = DeviceStateMonitor(microscope=fake,
-                                 reconnect_delay_sec=0.1,
-                                 stale_timeout_sec=10.0,
-                                 watchdog_interval_sec=10.0)
+        mon = DeviceStateMonitor(
+            microscope=fake,
+            reconnect_delay_sec=0.1,
+            stale_timeout_sec=10.0,
+            watchdog_interval_sec=10.0,
+        )
         await mon.on_start()
         await asyncio.sleep(0.3)
         await mon.on_stop()
@@ -115,10 +119,12 @@ def test_watchdog_does_not_trip_while_events_flowing():
     result = {}
 
     async def go():
-        mon = DeviceStateMonitor(microscope=fake,
-                                 reconnect_delay_sec=0.1,
-                                 stale_timeout_sec=1.0,
-                                 watchdog_interval_sec=0.1)
+        mon = DeviceStateMonitor(
+            microscope=fake,
+            reconnect_delay_sec=0.1,
+            stale_timeout_sec=1.0,
+            watchdog_interval_sec=0.1,
+        )
         await mon.on_start()
         await asyncio.sleep(1.0)
         result["kicks"] = mon._watchdog_kicks
@@ -133,9 +139,7 @@ async def go():
     assert result["kicks"] == 0, (
         f"watchdog should not trip with healthy stream (kicks={result['kicks']})"
     )
-    assert result["connects"] == 1, (
-        f"no spurious reconnects (connects={result['connects']})"
-    )
+    assert result["connects"] == 1, f"no spurious reconnects (connects={result['connects']})"
 
 
 def test_watchdog_kicks_stalled_stream():
@@ -150,10 +154,12 @@ def test_watchdog_kicks_stalled_stream():
     result = {}
 
     async def go():
-        mon = DeviceStateMonitor(microscope=fake,
-                                 reconnect_delay_sec=0.05,
-                                 stale_timeout_sec=0.4,
-                                 watchdog_interval_sec=0.05)
+        mon = DeviceStateMonitor(
+            microscope=fake,
+            reconnect_delay_sec=0.05,
+            stale_timeout_sec=0.4,
+            watchdog_interval_sec=0.05,
+        )
         await mon.on_start()
         await asyncio.sleep(1.5)
         result["kicks"] = mon._watchdog_kicks
@@ -184,8 +190,6 @@ def test_watchdog_recovers_after_kick():
     # First generator stalls. Second generator yields a real event.
     state = {"swap_done": False}
 
-    real_stream = fake.stream_device_states
-
     def patched_stream():
         if fake.connect_count == 0 and not state["swap_done"]:
             # First connect: hang forever
@@ -194,6 +198,7 @@ def patched_stream():
             async def _gen():
                 while True:
                     await asyncio.sleep(60)
+
             return _gen()
         # Subsequent connects: yield a marker event then hang
         fake.connect_count += 1
@@ -203,15 +208,18 @@ async def _gen2():
             yield {"i": "post-kick"}
             while True:
                 await asyncio.sleep(60)
+
         return _gen2()
 
     fake.stream_device_states = patched_stream
 
     async def go():
-        mon = DeviceStateMonitor(microscope=fake,
-                                 reconnect_delay_sec=0.05,
-                                 stale_timeout_sec=0.3,
-                                 watchdog_interval_sec=0.05)
+        mon = DeviceStateMonitor(
+            microscope=fake,
+            reconnect_delay_sec=0.05,
+            stale_timeout_sec=0.3,
+            watchdog_interval_sec=0.05,
+        )
         await mon.on_start()
         await asyncio.sleep(1.5)
         await mon.on_stop()
@@ -246,10 +254,12 @@ def test_external_cancel_does_not_resurrect_reader():
     result = {}
 
     async def go():
-        mon = DeviceStateMonitor(microscope=fake,
-                                 reconnect_delay_sec=0.05,
-                                 stale_timeout_sec=10.0,
-                                 watchdog_interval_sec=10.0)
+        mon = DeviceStateMonitor(
+            microscope=fake,
+            reconnect_delay_sec=0.05,
+            stale_timeout_sec=10.0,
+            watchdog_interval_sec=10.0,
+        )
         await mon.on_start()
         await asyncio.sleep(0.1)
         # External cancel (mimics event-loop teardown / Ctrl+C path):
@@ -285,10 +295,12 @@ def test_stop_cancels_both_tasks_cleanly():
     result = {}
 
     async def go():
-        mon = DeviceStateMonitor(microscope=fake,
-                                 reconnect_delay_sec=0.05,
-                                 stale_timeout_sec=10.0,
-                                 watchdog_interval_sec=0.05)
+        mon = DeviceStateMonitor(
+            microscope=fake,
+            reconnect_delay_sec=0.05,
+            stale_timeout_sec=10.0,
+            watchdog_interval_sec=0.05,
+        )
         await mon.on_start()
         await asyncio.sleep(0.1)
         await mon.on_stop()
diff --git a/tests/test_dispim_device_safety.py b/tests/test_dispim_device_safety.py
index 1ea296d0..21565677 100644
--- a/tests/test_dispim_device_safety.py
+++ b/tests/test_dispim_device_safety.py
@@ -6,16 +6,16 @@
 """
 
 import time
-import pytest
-import numpy as np
-from unittest.mock import MagicMock, patch, call
-from collections import OrderedDict
+from unittest.mock import MagicMock
 
+import numpy as np
+import pytest
 
 # ---------------------------------------------------------------------------
 # Mock CMMCore — stands in for pymmcore.CMMCore
 # ---------------------------------------------------------------------------
 
+
 class MockCore:
     """Minimal mock of pymmcore.CMMCore for safety tests."""
 
@@ -37,38 +37,38 @@ def __init__(self):
         self.call_log = []
 
     def setPosition(self, device, position):
-        self.call_log.append(('setPosition', device, position))
+        self.call_log.append(("setPosition", device, position))
         self._positions[device] = position
 
     def getPosition(self, device):
         return self._positions.get(device, 0.0)
 
     def waitForDevice(self, device):
-        self.call_log.append(('waitForDevice', device))
+        self.call_log.append(("waitForDevice", device))
 
     def setXYPosition(self, x, y):
-        self.call_log.append(('setXYPosition', x, y))
+        self.call_log.append(("setXYPosition", x, y))
         self._xy_position = (x, y)
 
     def getXYPosition(self):
         return self._xy_position
 
     def setGalvoPosition(self, device, a, b):
-        self.call_log.append(('setGalvoPosition', device, a, b))
+        self.call_log.append(("setGalvoPosition", device, a, b))
         self._galvo_positions[device] = (a, b)
 
     def getGalvoPosition(self, device):
         return self._galvo_positions.get(device, (0.0, 0.0))
 
     def setProperty(self, device, prop, value):
-        self.call_log.append(('setProperty', device, prop, value))
+        self.call_log.append(("setProperty", device, prop, value))
         self._properties[(device, prop)] = value
 
     def getProperty(self, device, prop):
         return self._properties.get((device, prop), "")
 
     def setConfig(self, group, config):
-        self.call_log.append(('setConfig', group, config))
+        self.call_log.append(("setConfig", group, config))
         self._configs[group] = config
 
     def getCurrentConfig(self, group):
@@ -78,7 +78,7 @@ def getAvailableConfigs(self, group):
         return self._available_configs.get(group, [])
 
     def waitForConfig(self, group, config):
-        self.call_log.append(('waitForConfig', group, config))
+        self.call_log.append(("waitForConfig", group, config))
 
     def setCameraDevice(self, name):
         self._camera_device = name
@@ -96,13 +96,13 @@ def getExposure(self):
         return self._exposure
 
     def snapImage(self):
-        self.call_log.append(('snapImage',))
+        self.call_log.append(("snapImage",))
 
     def getImage(self):
         return np.zeros((512, 512), dtype=np.uint16)
 
     def setROI(self, device, x, y, w, h):
-        self.call_log.append(('setROI', device, x, y, w, h))
+        self.call_log.append(("setROI", device, x, y, w, h))
 
     def clearCircularBuffer(self):
         self._circular_buffer = []
@@ -114,17 +114,17 @@ def setCircularBufferMemoryFootprint(self, mb):
         pass
 
     def prepareSequenceAcquisition(self, camera):
-        self.call_log.append(('prepareSequenceAcquisition', camera))
+        self.call_log.append(("prepareSequenceAcquisition", camera))
 
     def startSequenceAcquisition(self, camera, count, interval, stopOnOverflow):
-        self.call_log.append(('startSequenceAcquisition', camera, count))
+        self.call_log.append(("startSequenceAcquisition", camera, count))
         self._sequence_running = True
         self._sequence_expected = count
         # Pre-load images into buffer
         self._circular_buffer = [np.zeros((512, 512), dtype=np.uint16)] * count
 
     def stopSequenceAcquisition(self):
-        self.call_log.append(('stopSequenceAcquisition',))
+        self.call_log.append(("stopSequenceAcquisition",))
         self._sequence_running = False
 
     def isSequenceRunning(self):
@@ -146,6 +146,7 @@ def popNextImage(self):
 # Patch pymmcore and ophyd so device modules can be imported
 # ---------------------------------------------------------------------------
 
+
 @pytest.fixture(autouse=True)
 def _patch_imports(monkeypatch):
     """Patch pymmcore and ophyd.status so device imports succeed."""
@@ -154,20 +155,20 @@ def _patch_imports(monkeypatch):
     # Create minimal mock modules if not installed
     mock_modules = {}
 
-    if 'pymmcore' not in sys.modules:
+    if "pymmcore" not in sys.modules:
         pymmcore_mock = MagicMock()
         pymmcore_mock.CMMCore = MockCore
-        mock_modules['pymmcore'] = pymmcore_mock
+        mock_modules["pymmcore"] = pymmcore_mock
 
-    if 'ophyd' not in sys.modules:
+    if "ophyd" not in sys.modules:
         ophyd_mock = MagicMock()
-        mock_modules['ophyd'] = ophyd_mock
+        mock_modules["ophyd"] = ophyd_mock
 
-    if 'ophyd.status' not in sys.modules:
-        from unittest.mock import MagicMock as _MM
+    if "ophyd.status" not in sys.modules:
 
         class _RealStatus:
             """Minimal Status that actually tracks finished/exception."""
+
             def __init__(self, obj=None, timeout=None):
                 self._finished = False
                 self._exception = None
@@ -207,7 +208,7 @@ def add_callback(self, cb):
 
         ophyd_status_mock = MagicMock()
         ophyd_status_mock.Status = _RealStatus
-        mock_modules['ophyd.status'] = ophyd_status_mock
+        mock_modules["ophyd.status"] = ophyd_status_mock
 
     for name, mod in mock_modules.items():
         monkeypatch.setitem(sys.modules, name, mod)
@@ -217,32 +218,38 @@ def add_callback(self, cb):
 # Device constructors with mock core
 # ---------------------------------------------------------------------------
 
+
 def make_core():
     return MockCore()
 
 
 def make_z_stage(core=None, limits=(50.0, 250.0)):
     from gently.hardware.dispim.devices.stage import DiSPIMZstage
+
     return DiSPIMZstage("ZStage", core or make_core(), limits=limits)
 
 
 def make_xy_stage(core=None, x_limits=(2000.0, 4000.0), y_limits=(-1000.0, 1000.0)):
     from gently.hardware.dispim.devices.stage import DiSPIMXYStage
+
     return DiSPIMXYStage("XYStage", core or make_core(), x_limits=x_limits, y_limits=y_limits)
 
 
 def make_piezo(core=None, limits=(-200.0, 200.0)):
     from gently.hardware.dispim.devices.piezo import DiSPIMPiezo
+
     return DiSPIMPiezo("Piezo", core or make_core(), limits=limits)
 
 
 def make_fdrive(core=None):
     from gently.hardware.dispim.devices.piezo import DiSPIMFDrive
+
     return DiSPIMFDrive("FDrive", core or make_core())
 
 
 def make_scanner(core=None, limits=(-5.0, 5.0)):
     from gently.hardware.dispim.devices.scanner import DiSPIMScanner
+
     return DiSPIMScanner("Scanner", core or make_core(), limits=limits)
 
 
@@ -250,6 +257,7 @@ def make_led(core=None, available_configs=None):
     core = core or make_core()
     core._available_configs["LED"] = available_configs or ["Open", "Closed"]
     from gently.hardware.dispim.devices.optical import DiSPIMLED
+
     return DiSPIMLED(core, name="LED")
 
 
@@ -258,6 +266,7 @@ def make_laser(core=None, available_configs=None):
     configs = available_configs or ["488 and 561", "488 only", "561 only", "ALL OFF"]
     core._available_configs["Laser"] = configs
     from gently.hardware.dispim.devices.optical import DiSPIMLaserControl
+
     return DiSPIMLaserControl(core, name="Laser")
 
 
@@ -265,6 +274,7 @@ def make_laser(core=None, available_configs=None):
 # 1. BOUNDS CHECKING
 # ===========================================================================
 
+
 class TestZStageBounds:
     """Z stage must reject positions outside configured limits."""
 
@@ -310,7 +320,7 @@ def test_core_not_called_on_rejected_position(self):
         stage = make_z_stage(core=core)
         with pytest.raises(ValueError):
             stage.set(300.0)
-        assert ('setPosition', 'ZStage', 300.0) not in core.call_log
+        assert ("setPosition", "ZStage", 300.0) not in core.call_log
 
 
 class TestXYStageBounds:
@@ -351,7 +361,7 @@ def test_core_not_called_on_invalid_x(self):
         stage = make_xy_stage(core=core)
         stage.set([0.0, 0.0])  # x=0 is below x_limits[0]=2000
         time.sleep(0.1)
-        assert not any(c[0] == 'setXYPosition' for c in core.call_log)
+        assert not any(c[0] == "setXYPosition" for c in core.call_log)
 
 
 class TestPiezoBounds:
@@ -419,8 +429,10 @@ def test_just_below_floor_raises(self):
 
     def test_limits_property_is_module_constants(self):
         from gently.hardware.dispim.devices.piezo import (
-            F_DRIVE_MIN_UM, F_DRIVE_MAX_UM,
+            F_DRIVE_MAX_UM,
+            F_DRIVE_MIN_UM,
         )
+
         fdrive = make_fdrive()
         assert fdrive.limits == (F_DRIVE_MIN_UM, F_DRIVE_MAX_UM)
         assert fdrive.limits == (30.0, 25000.0)
@@ -458,13 +470,14 @@ def test_core_not_called_on_invalid_a(self):
         scanner = make_scanner(core=core)
         scanner.set([6.0, 0.0])
         time.sleep(0.1)
-        assert not any(c[0] == 'setGalvoPosition' for c in core.call_log)
+        assert not any(c[0] == "setGalvoPosition" for c in core.call_log)
 
 
 # ===========================================================================
 # 2. CONFIG VALIDATION
 # ===========================================================================
 
+
 class TestLEDConfigValidation:
     """LED must only accept configurations from the cached available set."""
 
@@ -511,6 +524,7 @@ def test_all_off_accepted(self):
 # 3. STATE MACHINE / CONFIGURE-BEFORE-TRIGGER
 # ===========================================================================
 
+
 class TestVolumeScanner:
     """Volume scanner requires configure() before trigger()."""
 
@@ -521,14 +535,15 @@ def _make_volume_scanner(self):
 
         scanner = make_scanner(core=core)
         from gently.hardware.dispim.devices.camera import DiSPIMCamera
+
         camera = DiSPIMCamera("Camera", core)
         piezo = make_piezo(core=core)
         laser = make_laser(core=core)
 
         from gently.hardware.dispim.devices.acquisition import DiSPIMVolumeScanner
+
         return DiSPIMVolumeScanner(
-            scanner=scanner, camera=camera, piezo=piezo,
-            laser_control=laser, core=core
+            scanner=scanner, camera=camera, piezo=piezo, laser_control=laser, core=core
         )
 
     def test_trigger_before_configure_raises(self):
@@ -539,9 +554,12 @@ def test_trigger_before_configure_raises(self):
     def test_configure_then_trigger_succeeds(self):
         vs = self._make_volume_scanner()
         vs.configure(
-            num_slices=10, exposure_ms=5.0,
-            galvo_amplitude=1.0, galvo_center=0.0,
-            piezo_amplitude=50.0, piezo_center=0.0,
+            num_slices=10,
+            exposure_ms=5.0,
+            galvo_amplitude=1.0,
+            galvo_center=0.0,
+            piezo_amplitude=50.0,
+            piezo_center=0.0,
             laser_config="488 and 561",
         )
         assert vs._configured is True
@@ -554,6 +572,7 @@ def test_configure_then_trigger_succeeds(self):
 # 4. HAPPY-PATH CLEANUP — LASER/LED OFF AFTER SUCCESS
 # ===========================================================================
 
+
 class TestVolumeScannerHappyPathCleanup:
     """Volume scanner must disable lasers and reset state after successful acquisition."""
 
@@ -563,19 +582,23 @@ def _make_volume_scanner(self):
 
         scanner = make_scanner(core=core)
         from gently.hardware.dispim.devices.camera import DiSPIMCamera
+
         camera = DiSPIMCamera("Camera", core)
         piezo = make_piezo(core=core)
         laser = make_laser(core=core)
 
         from gently.hardware.dispim.devices.acquisition import DiSPIMVolumeScanner
+
         vs = DiSPIMVolumeScanner(
-            scanner=scanner, camera=camera, piezo=piezo,
-            laser_control=laser, core=core
+            scanner=scanner, camera=camera, piezo=piezo, laser_control=laser, core=core
         )
         vs.configure(
-            num_slices=5, exposure_ms=5.0,
-            galvo_amplitude=1.0, galvo_center=0.0,
-            piezo_amplitude=50.0, piezo_center=0.0,
+            num_slices=5,
+            exposure_ms=5.0,
+            galvo_amplitude=1.0,
+            galvo_center=0.0,
+            piezo_amplitude=50.0,
+            piezo_center=0.0,
         )
         return vs, core
 
@@ -587,8 +610,9 @@ def test_lasers_disabled_after_successful_acquisition(self):
         assert status.success
 
         laser_off_calls = [
-            c for c in core.call_log
-            if c[0] == 'setConfig' and c[1] == 'Laser' and c[2] == 'ALL OFF'
+            c
+            for c in core.call_log
+            if c[0] == "setConfig" and c[1] == "Laser" and c[2] == "ALL OFF"
         ]
         assert len(laser_off_calls) >= 1, "Lasers must be disabled after successful acquisition"
 
@@ -600,8 +624,9 @@ def test_spim_state_idle_after_successful_acquisition(self):
 
         # Both scanner and piezo should be set to Idle
         idle_calls = [
-            c for c in core.call_log
-            if c[0] == 'setProperty' and c[2] == 'SPIMState' and c[3] == 'Idle'
+            c
+            for c in core.call_log
+            if c[0] == "setProperty" and c[2] == "SPIMState" and c[3] == "Idle"
         ]
         assert len(idle_calls) >= 2, "Both scanner and piezo SPIM state must be reset to Idle"
 
@@ -612,10 +637,13 @@ def test_camera_trigger_mode_reset_after_acquisition(self):
         status.wait(timeout=5)
 
         trigger_resets = [
-            c for c in core.call_log
-            if c[0] == 'setProperty' and c[2] == 'TRIGGER SOURCE' and c[3] == 'INTERNAL'
+            c
+            for c in core.call_log
+            if c[0] == "setProperty" and c[2] == "TRIGGER SOURCE" and c[3] == "INTERNAL"
         ]
-        assert len(trigger_resets) >= 1, "Camera must be reset to INTERNAL trigger after acquisition"
+        assert len(trigger_resets) >= 1, (
+            "Camera must be reset to INTERNAL trigger after acquisition"
+        )
 
     def test_laser_sequence_on_then_off(self):
         """Lasers must be enabled THEN disabled — verify ordering."""
@@ -623,19 +651,16 @@ def test_laser_sequence_on_then_off(self):
         status = vs.trigger()
         status.wait(timeout=5)
 
-        laser_calls = [
-            c for c in core.call_log
-            if c[0] == 'setConfig' and c[1] == 'Laser'
-        ]
+        laser_calls = [c for c in core.call_log if c[0] == "setConfig" and c[1] == "Laser"]
         configs = [c[2] for c in laser_calls]
-        assert configs == ["488 and 561", "ALL OFF"], \
-            f"Expected laser on then off, got: {configs}"
+        assert configs == ["488 and 561", "ALL OFF"], f"Expected laser on then off, got: {configs}"
 
 
 # ===========================================================================
 # 5. TIMEOUT PROTECTION
 # ===========================================================================
 
+
 class TestVolumeScannerTimeout:
     """Volume scanner must not hang if image collection stalls."""
 
@@ -646,37 +671,43 @@ def test_timeout_when_images_never_arrive(self):
 
         # Override: startSequenceAcquisition runs but delivers no images
         def stalling_start(camera, count, interval, stopOnOverflow):
-            core.call_log.append(('startSequenceAcquisition', camera, count))
+            core.call_log.append(("startSequenceAcquisition", camera, count))
             core._sequence_running = True
             core._circular_buffer = []  # No images delivered
 
         # Override: sequence stays "running" forever
         def always_running():
             return core._sequence_running
+
         core.startSequenceAcquisition = stalling_start
         core.isSequenceRunning = always_running
 
         scanner = make_scanner(core=core)
         from gently.hardware.dispim.devices.camera import DiSPIMCamera
+
         camera = DiSPIMCamera("Camera", core)
         piezo = make_piezo(core=core)
         laser = make_laser(core=core)
 
         from gently.hardware.dispim.devices.acquisition import DiSPIMVolumeScanner
+
         vs = DiSPIMVolumeScanner(
-            scanner=scanner, camera=camera, piezo=piezo,
-            laser_control=laser, core=core
+            scanner=scanner, camera=camera, piezo=piezo, laser_control=laser, core=core
         )
         vs.configure(
-            num_slices=10, exposure_ms=5.0,
-            galvo_amplitude=1.0, galvo_center=0.0,
-            piezo_amplitude=50.0, piezo_center=0.0,
+            num_slices=10,
+            exposure_ms=5.0,
+            galvo_amplitude=1.0,
+            galvo_center=0.0,
+            piezo_amplitude=50.0,
+            piezo_center=0.0,
         )
 
         # Shorten timeout (frozen dataclass — bypass with object.__setattr__)
         from gently.settings import settings
+
         original = settings.timeouts.volume_acquisition
-        object.__setattr__(settings.timeouts, 'volume_acquisition', 0.5)
+        object.__setattr__(settings.timeouts, "volume_acquisition", 0.5)
 
         try:
             status = vs.trigger()
@@ -685,48 +716,55 @@ def always_running():
 
             # Even on timeout, lasers must be off
             laser_off = [
-                c for c in core.call_log
-                if c[0] == 'setConfig' and c[1] == 'Laser' and c[2] == 'ALL OFF'
+                c
+                for c in core.call_log
+                if c[0] == "setConfig" and c[1] == "Laser" and c[2] == "ALL OFF"
             ]
             assert len(laser_off) >= 1, "Lasers must be disabled even on timeout"
         finally:
-            object.__setattr__(settings.timeouts, 'volume_acquisition', original)
+            object.__setattr__(settings.timeouts, "volume_acquisition", original)
 
 
 # ===========================================================================
 # 6. ERROR CLEANUP — LASER/LED AUTO-DISABLE ON FAILURE
 # ===========================================================================
 
+
 class TestVolumeScannerErrorCleanup:
     """Volume scanner must disable lasers even when acquisition fails."""
 
-    def _make_failing_volume_scanner(self, fail_at='sequence'):
+    def _make_failing_volume_scanner(self, fail_at="sequence"):
         """Create volume scanner where core fails during acquisition."""
         core = make_core()
         core._available_configs["Laser"] = ["488 and 561", "ALL OFF"]
 
-        if fail_at == 'sequence':
-            original_start = core.startSequenceAcquisition
+        if fail_at == "sequence":
+
             def failing_start(*args, **kwargs):
                 core._sequence_running = False
                 raise RuntimeError("Camera sequence failed")
+
             core.startSequenceAcquisition = failing_start
 
         scanner = make_scanner(core=core)
         from gently.hardware.dispim.devices.camera import DiSPIMCamera
+
         camera = DiSPIMCamera("Camera", core)
         piezo = make_piezo(core=core)
         laser = make_laser(core=core)
 
         from gently.hardware.dispim.devices.acquisition import DiSPIMVolumeScanner
+
         vs = DiSPIMVolumeScanner(
-            scanner=scanner, camera=camera, piezo=piezo,
-            laser_control=laser, core=core
+            scanner=scanner, camera=camera, piezo=piezo, laser_control=laser, core=core
         )
         vs.configure(
-            num_slices=10, exposure_ms=5.0,
-            galvo_amplitude=1.0, galvo_center=0.0,
-            piezo_amplitude=50.0, piezo_center=0.0,
+            num_slices=10,
+            exposure_ms=5.0,
+            galvo_amplitude=1.0,
+            galvo_center=0.0,
+            piezo_amplitude=50.0,
+            piezo_center=0.0,
         )
         return vs, core
 
@@ -739,8 +777,9 @@ def test_lasers_disabled_on_acquisition_error(self):
 
         # Verify lasers were turned off in cleanup
         laser_off_calls = [
-            c for c in core.call_log
-            if c[0] == 'setConfig' and c[1] == 'Laser' and c[2] == 'ALL OFF'
+            c
+            for c in core.call_log
+            if c[0] == "setConfig" and c[1] == "Laser" and c[2] == "ALL OFF"
         ]
         assert len(laser_off_calls) >= 1, "Lasers must be disabled on error"
 
@@ -753,8 +792,9 @@ def test_spim_state_reset_on_error(self):
 
         # Verify scanner SPIM state was set to Idle in cleanup
         idle_calls = [
-            c for c in core.call_log
-            if c[0] == 'setProperty' and c[2] == 'SPIMState' and c[3] == 'Idle'
+            c
+            for c in core.call_log
+            if c[0] == "setProperty" and c[2] == "SPIMState" and c[3] == "Idle"
         ]
         assert len(idle_calls) >= 1, "SPIM state must be reset to Idle on error"
 
@@ -763,6 +803,7 @@ def test_spim_state_reset_on_error(self):
 # 7. LED CLEANUP ON BOTTOM CAMERA
 # ===========================================================================
 
+
 class TestBottomCameraLEDCleanup:
     """Bottom camera must turn LED off even when capture fails."""
 
@@ -771,13 +812,16 @@ def _make_bottom_camera(self, snap_fails=False):
         core._available_configs["LED"] = ["Open", "Closed"]
 
         if snap_fails:
+
             def failing_snap():
                 raise RuntimeError("Camera snap failed")
+
             core.snapImage = failing_snap
 
         led = make_led(core=core)
 
         from gently.hardware.dispim.devices.camera import DiSPIMBottomCamera
+
         cam = DiSPIMBottomCamera("BottomCam", core, led_control=led)
         cam.use_led = True
         return cam, core
@@ -788,7 +832,7 @@ def test_led_on_before_capture(self):
         status.wait(timeout=5)
 
         # LED should have been opened then closed
-        config_calls = [c for c in core.call_log if c[0] == 'setConfig' and c[1] == 'LED']
+        config_calls = [c for c in core.call_log if c[0] == "setConfig" and c[1] == "LED"]
         configs_set = [c[2] for c in config_calls]
         assert "Open" in configs_set, "LED must be turned on before capture"
         assert "Closed" in configs_set, "LED must be turned off after capture"
@@ -801,8 +845,8 @@ def test_led_off_on_capture_error(self):
             status.wait(timeout=5)
 
         # Despite error, LED must have been closed
-        config_calls = [c for c in core.call_log if c[0] == 'setConfig' and c[1] == 'LED']
-        closed_calls = [c for c in config_calls if c[2] == 'Closed']
+        config_calls = [c for c in core.call_log if c[0] == "setConfig" and c[1] == "LED"]
+        closed_calls = [c for c in config_calls if c[2] == "Closed"]
         assert len(closed_calls) >= 1, "LED must be turned off even on capture error"
 
     def test_led_not_used_when_disabled(self):
@@ -812,7 +856,7 @@ def test_led_not_used_when_disabled(self):
         status = cam.trigger()
         status.wait(timeout=5)
 
-        led_calls = [c for c in core.call_log if c[0] == 'setConfig' and c[1] == 'LED']
+        led_calls = [c for c in core.call_log if c[0] == "setConfig" and c[1] == "LED"]
         assert len(led_calls) == 0, "LED should not be controlled when use_led=False"
 
 
@@ -820,11 +864,13 @@ def test_led_not_used_when_disabled(self):
 # 8. CALIBRATION PRIOR
 # ===========================================================================
 
+
 class TestCalibrationPrior:
     """CalibrationPrior tracks piezo-galvo relationship across embryos."""
 
     def test_default_state(self):
         from gently.hardware.dispim.calibration import CalibrationPrior
+
         prior = CalibrationPrior()
         assert prior.slope_um_per_deg == 100.0
         assert prior.num_calibrations == 0
@@ -833,6 +879,7 @@ def test_default_state(self):
 
     def test_lock_session_slope(self):
         from gently.hardware.dispim.calibration import CalibrationPrior
+
         prior = CalibrationPrior()
         prior.lock_session_slope(slope=95.5, r_squared=0.98, embryo_id="e1")
         assert prior.session_slope_locked
@@ -842,6 +889,7 @@ def test_lock_session_slope(self):
 
     def test_not_ready_with_low_r_squared(self):
         from gently.hardware.dispim.calibration import CalibrationPrior
+
         prior = CalibrationPrior()
         prior.lock_session_slope(slope=95.0, r_squared=0.5, embryo_id="e1")
         assert prior.session_slope_locked
@@ -849,6 +897,7 @@ def test_not_ready_with_low_r_squared(self):
 
     def test_ema_update(self):
         from gently.hardware.dispim.calibration import CalibrationPrior
+
         prior = CalibrationPrior()
 
         # First calibration — set directly
@@ -864,6 +913,7 @@ def test_ema_update(self):
 
     def test_serialization_roundtrip(self):
         from gently.hardware.dispim.calibration import CalibrationPrior
+
         prior = CalibrationPrior()
         prior.lock_session_slope(slope=97.0, r_squared=0.96, embryo_id="e1")
         prior.update_from_calibration(slope=98.0, offset=3.0, r_squared=0.97, extent_deg=0.25)
@@ -881,6 +931,7 @@ def test_serialization_roundtrip(self):
 # 9. ROUNDING / PRECISION
 # ===========================================================================
 
+
 class TestPositionRounding:
     """Devices should round to avoid floating-point precision issues."""
 
diff --git a/tests/test_eval.py b/tests/test_eval.py
index 879b7fc9..f476d7d7 100644
--- a/tests/test_eval.py
+++ b/tests/test_eval.py
@@ -11,7 +11,7 @@
 import numpy as np
 import pytest
 
-from gently.core.event_bus import EventBus, EventType, Event
+from gently.core.event_bus import Event, EventBus, EventType
 from gently.eval import (
     Decision,
     DecisionLog,
@@ -23,11 +23,11 @@
     ShadowRunner,
 )
 
-
 # =============================================================================
 # EventCapture
 # =============================================================================
 
+
 def test_capture_writes_meaningful_events_skips_telemetry(tmp_path: Path):
     """Capture skips high-volume telemetry by default but keeps the rest."""
     bus = EventBus()
@@ -55,13 +55,17 @@ def test_capture_handles_non_json_native_payloads(tmp_path: Path):
     cap = EventCapture(log)
     cap.start(bus)
 
-    bus.publish(EventType.STAGE_MOVED, {
-        "np_scalar": np.float64(1.5),
-        "np_array": np.array([1, 2, 3]),
-        "path": Path("/tmp/foo.tif"),
-        "now": datetime(2026, 5, 15, 12, 0, 0),
-        "as_set": {"a", "b"},
-    }, source="t")
+    bus.publish(
+        EventType.STAGE_MOVED,
+        {
+            "np_scalar": np.float64(1.5),
+            "np_array": np.array([1, 2, 3]),
+            "path": Path("/tmp/foo.tif"),
+            "now": datetime(2026, 5, 15, 12, 0, 0),
+            "as_set": {"a", "b"},
+        },
+        source="t",
+    )
     cap.stop()
 
     record = json.loads(log.read_text().strip())
@@ -98,8 +102,7 @@ def test_capture_thread_safety(tmp_path: Path):
 
     def worker(idx: int):
         for i in range(N_EVENTS_PER_THREAD):
-            bus.publish(EventType.STAGE_MOVED,
-                        {"t": idx, "i": i}, source=f"thread-{idx}")
+            bus.publish(EventType.STAGE_MOVED, {"t": idx, "i": i}, source=f"thread-{idx}")
 
     threads = [threading.Thread(target=worker, args=(i,)) for i in range(N_THREADS)]
     for t in threads:
@@ -120,17 +123,20 @@ def worker(idx: int):
 # EventReplay
 # =============================================================================
 
+
 def test_replay_preserves_event_fields(tmp_path: Path):
     """Round-trip: capture, then replay, then verify Event field identity."""
     src_bus = EventBus()
     cap = EventCapture(tmp_path / "events.jsonl")
     cap.start(src_bus)
 
-    e1 = src_bus.publish(EventType.EMBRYOS_UPDATE,
-                          {"embryos": [{"id": "e1"}], "count": 1},
-                          source="capture-test", correlation_id="corr-A")
-    e2 = src_bus.publish(EventType.ERROR_OCCURRED,
-                          {"msg": "bang"}, source="capture-test")
+    e1 = src_bus.publish(
+        EventType.EMBRYOS_UPDATE,
+        {"embryos": [{"id": "e1"}], "count": 1},
+        source="capture-test",
+        correlation_id="corr-A",
+    )
+    e2 = src_bus.publish(EventType.ERROR_OCCURRED, {"msg": "bang"}, source="capture-test")
     cap.stop()
 
     rep = EventReplay(tmp_path / "events.jsonl")
@@ -201,7 +207,9 @@ def test_replay_time_scale_speeds_up(tmp_path: Path):
     dest.subscribe("*", lambda ev: None)
     t0 = time.monotonic()
     EventReplay(tmp_path / "events.jsonl").replay(
-        dest, real_time=True, time_scale=4.0,
+        dest,
+        real_time=True,
+        time_scale=4.0,
     )
     elapsed = time.monotonic() - t0
     # 0.4s scaled by 4 -> ~0.1s, with generous slack for scheduling.
@@ -212,17 +220,29 @@ def test_replay_skips_malformed_lines(tmp_path: Path):
     """A garbage line in the log doesn't abort the whole replay."""
     log = tmp_path / "events.jsonl"
     log.write_text(
-        json.dumps({
-            "event_type": "STAGE_MOVED", "data": {}, "source": "t",
-            "timestamp": "2026-01-01T00:00:00", "event_id": "abc",
-            "correlation_id": None,
-        }) + "\n"
+        json.dumps(
+            {
+                "event_type": "STAGE_MOVED",
+                "data": {},
+                "source": "t",
+                "timestamp": "2026-01-01T00:00:00",
+                "event_id": "abc",
+                "correlation_id": None,
+            }
+        )
+        + "\n"
         "not valid json garbage\n"
-        + json.dumps({
-            "event_type": "EMBRYOS_UPDATE", "data": {}, "source": "t",
-            "timestamp": "2026-01-01T00:00:01", "event_id": "def",
-            "correlation_id": None,
-        }) + "\n",
+        + json.dumps(
+            {
+                "event_type": "EMBRYOS_UPDATE",
+                "data": {},
+                "source": "t",
+                "timestamp": "2026-01-01T00:00:01",
+                "event_id": "def",
+                "correlation_id": None,
+            }
+        )
+        + "\n",
         encoding="utf-8",
     )
     rep = EventReplay(log)
@@ -239,6 +259,7 @@ def test_replay_missing_file_raises(tmp_path: Path):
 # DecisionLog
 # =============================================================================
 
+
 def test_decision_log_round_trip(tmp_path: Path):
     log_path = tmp_path / "decisions.jsonl"
     dlog = DecisionLog(log_path)
@@ -257,13 +278,15 @@ def test_decision_log_round_trip(tmp_path: Path):
         duration_ms=820.5,
     )
     dlog.append(d1)
-    dlog.append(Decision(
-        timestamp=datetime(2026, 5, 15, 12, 0, 5),
-        agent="prod",
-        trigger=DecisionTrigger.EVENT,
-        trigger_detail="EMBRYOS_UPDATE",
-        error=None,
-    ))
+    dlog.append(
+        Decision(
+            timestamp=datetime(2026, 5, 15, 12, 0, 5),
+            agent="prod",
+            trigger=DecisionTrigger.EVENT,
+            trigger_detail="EMBRYOS_UPDATE",
+            error=None,
+        )
+    )
     dlog.close()
 
     back = dlog.read()
@@ -279,11 +302,13 @@ def test_decision_log_round_trip(tmp_path: Path):
 def test_decision_log_context_manager(tmp_path: Path):
     log_path = tmp_path / "decisions.jsonl"
     with DecisionLog(log_path) as dlog:
-        dlog.append(Decision(
-            timestamp=datetime.now(),
-            agent="t",
-            trigger=DecisionTrigger.TICK,
-        ))
+        dlog.append(
+            Decision(
+                timestamp=datetime.now(),
+                agent="t",
+                trigger=DecisionTrigger.TICK,
+            )
+        )
     assert log_path.exists()
     assert len(log_path.read_text().splitlines()) == 1
 
@@ -292,6 +317,7 @@ def test_decision_log_context_manager(tmp_path: Path):
 # ShadowRunner + NoOpCandidate
 # =============================================================================
 
+
 def test_shadow_runner_forwards_to_all_candidates(tmp_path: Path):
     bus = EventBus()
     log_a = DecisionLog(tmp_path / "a.jsonl")
@@ -368,9 +394,11 @@ def test_shadow_runner_watch_filter(tmp_path: Path):
 # prompt_hash
 # =============================================================================
 
+
 def test_prompt_hash_stable_and_distinguishing():
     """Identical inputs → identical hash; any change → different hash."""
     from gently.eval import prompt_hash
+
     h1 = prompt_hash("sys-A", [{"role": "user", "content": "hi"}])
     h2 = prompt_hash("sys-A", [{"role": "user", "content": "hi"}])
     h3 = prompt_hash("sys-A", [{"role": "user", "content": "hello"}])
@@ -384,12 +412,13 @@ def test_prompt_hash_stable_and_distinguishing():
 def test_prompt_hash_accepts_list_system_prompt():
     """Cached system prompts use the list-of-blocks shape; hashing must work."""
     from gently.eval import prompt_hash
+
     list_prompt = [{"type": "text", "text": "sys", "cache_control": {"type": "ephemeral"}}]
     str_prompt = "sys"
     # Different shapes, different hashes — that's fine, the point is just
     # that the list case doesn't raise.
     h_list = prompt_hash(list_prompt, [])
-    h_str  = prompt_hash(str_prompt,  [])
+    h_str = prompt_hash(str_prompt, [])
     assert isinstance(h_list, str) and isinstance(h_str, str)
     assert len(h_list) == 16 and len(h_str) == 16
 
@@ -398,10 +427,12 @@ def test_prompt_hash_accepts_list_system_prompt():
 # ConversationManager production-decision capture (success + error paths)
 # =============================================================================
 
+
 def _make_fake_conversation_manager(claude_client):
     """Build a ConversationManager with a fake Claude client and a no-op
     tool registry — enough to exercise call_claude's decision-write path."""
     import asyncio  # noqa: F401  (used by callers)
+
     from gently.harness.conversation import ConversationManager
 
     class _NoopReg:
@@ -461,6 +492,7 @@ class _FakeClient:
     # Bypass actual tool execution
     async def fake_exec(content_blocks, interaction):
         return [{"type": "tool_result", "tool_use_id": "t1", "content": "ok"}]
+
     cm._execute_tools_with_logging = fake_exec
 
     dlog = DecisionLog(tmp_path / "decisions.jsonl")
@@ -486,11 +518,13 @@ async def run():
     assert d.agent == "production"
     assert d.trigger is DecisionTrigger.USER_MESSAGE
     assert d.trigger_detail == "find embryos please"
-    assert d.tool_calls == [{
-        "name": "detect_embryos",
-        "input": {"min_confidence": 0.7},
-        "id": "t1",
-    }]
+    assert d.tool_calls == [
+        {
+            "name": "detect_embryos",
+            "input": {"min_confidence": 0.7},
+            "id": "t1",
+        }
+    ]
     assert d.response_text == "Done."
     assert d.error is None
     assert d.prompt_hash is not None and len(d.prompt_hash) == 16
@@ -566,6 +600,7 @@ async def run():
 # ReactiveCandidate
 # =============================================================================
 
+
 def _publish(bus, event_type_name: str, data: dict, source: str = "test"):
     bus.publish(EventType[event_type_name], data, source=source)
 
@@ -584,12 +619,26 @@ def test_reactive_ingests_embryos_update_silently(tmp_path: Path):
     runner.add(cand)
     runner.start()
 
-    _publish(bus, "EMBRYOS_UPDATE", {"embryos": [
-        {"id": "embryo_1", "position_coarse": {"x": 1.0, "y": 2.0},
-         "position_fine": {}, "has_fine_position": False},
-        {"id": "embryo_2", "position_coarse": {"x": 3.0, "y": 4.0},
-         "position_fine": {"x": 3.1, "y": 4.1}, "has_fine_position": True},
-    ]})
+    _publish(
+        bus,
+        "EMBRYOS_UPDATE",
+        {
+            "embryos": [
+                {
+                    "id": "embryo_1",
+                    "position_coarse": {"x": 1.0, "y": 2.0},
+                    "position_fine": {},
+                    "has_fine_position": False,
+                },
+                {
+                    "id": "embryo_2",
+                    "position_coarse": {"x": 3.0, "y": 4.0},
+                    "position_fine": {"x": 3.1, "y": 4.1},
+                    "has_fine_position": True,
+                },
+            ]
+        },
+    )
 
     runner.stop()
     dlog.close()
@@ -607,21 +656,27 @@ def test_reactive_proposes_recalibrate_when_fine_invalidated(tmp_path: Path):
     runner.add(ReactiveCandidate("reactive", dlog))
     runner.start()
 
-    _publish(bus, "OPERATOR_EDITED_EMBRYO", {
-        "embryo_id": "embryo_2",
-        "old_position_coarse": {"x": 3, "y": 4},
-        "new_position_coarse": {"x": 30, "y": 40},
-        "fine_position_invalidated": True,
-    })
+    _publish(
+        bus,
+        "OPERATOR_EDITED_EMBRYO",
+        {
+            "embryo_id": "embryo_2",
+            "old_position_coarse": {"x": 3, "y": 4},
+            "new_position_coarse": {"x": 30, "y": 40},
+            "fine_position_invalidated": True,
+        },
+    )
     runner.stop()
     dlog.close()
     decs = _decisions_for(dlog)
     assert len(decs) == 1
-    assert decs[0].tool_calls == [{
-        "name": "recalibrate_embryo",
-        "input": {"embryo_id": "embryo_2"},
-        "id": None,
-    }]
+    assert decs[0].tool_calls == [
+        {
+            "name": "recalibrate_embryo",
+            "input": {"embryo_id": "embryo_2"},
+            "id": None,
+        }
+    ]
 
 
 def test_reactive_skips_recalibrate_when_no_fine_existed(tmp_path: Path):
@@ -632,12 +687,16 @@ def test_reactive_skips_recalibrate_when_no_fine_existed(tmp_path: Path):
     runner.add(ReactiveCandidate("reactive", dlog))
     runner.start()
 
-    _publish(bus, "OPERATOR_EDITED_EMBRYO", {
-        "embryo_id": "embryo_1",
-        "old_position_coarse": {"x": 1, "y": 2},
-        "new_position_coarse": {"x": 10, "y": 20},
-        "fine_position_invalidated": False,
-    })
+    _publish(
+        bus,
+        "OPERATOR_EDITED_EMBRYO",
+        {
+            "embryo_id": "embryo_1",
+            "old_position_coarse": {"x": 1, "y": 2},
+            "new_position_coarse": {"x": 10, "y": 20},
+            "fine_position_invalidated": False,
+        },
+    )
     runner.stop()
     dlog.close()
     decs = _decisions_for(dlog)
@@ -654,19 +713,25 @@ def test_reactive_proposes_calibrate_all_on_marked(tmp_path: Path):
     runner.add(ReactiveCandidate("reactive", dlog))
     runner.start()
 
-    _publish(bus, "OPERATOR_MARKED_EMBRYOS", {
-        "embryo_ids": ["embryo_001", "embryo_002", "embryo_003"],
-        "count": 3,
-    })
+    _publish(
+        bus,
+        "OPERATOR_MARKED_EMBRYOS",
+        {
+            "embryo_ids": ["embryo_001", "embryo_002", "embryo_003"],
+            "count": 3,
+        },
+    )
     runner.stop()
     dlog.close()
     decs = _decisions_for(dlog)
     assert len(decs) == 1
-    assert decs[0].tool_calls == [{
-        "name": "calibrate_all_embryos",
-        "input": {"embryo_ids": ["embryo_001", "embryo_002", "embryo_003"]},
-        "id": None,
-    }]
+    assert decs[0].tool_calls == [
+        {
+            "name": "calibrate_all_embryos",
+            "input": {"embryo_ids": ["embryo_001", "embryo_002", "embryo_003"]},
+            "id": None,
+        }
+    ]
 
 
 def test_reactive_proposes_forget_on_removal(tmp_path: Path):
@@ -677,19 +742,25 @@ def test_reactive_proposes_forget_on_removal(tmp_path: Path):
     runner.add(ReactiveCandidate("reactive", dlog))
     runner.start()
 
-    _publish(bus, "OPERATOR_REMOVED_EMBRYO", {
-        "embryo_id": "embryo_5",
-        "last_position": {"coarse": {"x": 1, "y": 2}, "fine": None},
-    })
+    _publish(
+        bus,
+        "OPERATOR_REMOVED_EMBRYO",
+        {
+            "embryo_id": "embryo_5",
+            "last_position": {"coarse": {"x": 1, "y": 2}, "fine": None},
+        },
+    )
     runner.stop()
     dlog.close()
     decs = _decisions_for(dlog)
     assert len(decs) == 1
-    assert decs[0].tool_calls == [{
-        "name": "forget_embryo",
-        "input": {"embryo_id": "embryo_5"},
-        "id": None,
-    }]
+    assert decs[0].tool_calls == [
+        {
+            "name": "forget_embryo",
+            "input": {"embryo_id": "embryo_5"},
+            "id": None,
+        }
+    ]
 
 
 def test_reactive_escalates_first_error_then_suppresses_repeat(tmp_path: Path):
@@ -724,21 +795,39 @@ def test_reactive_full_event_stream_through_replay(tmp_path: Path):
     cap = EventCapture(tmp_path / "events.jsonl")
     cap.start(src)
 
-    src.publish(EventType.EMBRYOS_UPDATE, {"embryos": [
-        {"id": "embryo_1", "position_coarse": {"x": 1.0, "y": 2.0},
-         "position_fine": {"x": 1.05, "y": 2.05}, "has_fine_position": True},
-    ]}, source="agent")
-    src.publish(EventType.OPERATOR_EDITED_EMBRYO, {
-        "embryo_id": "embryo_1",
-        "old_position_coarse": {"x": 1.0, "y": 2.0},
-        "new_position_coarse": {"x": 5.0, "y": 6.0},
-        "fine_position_invalidated": True,
-    }, source="web:map-edit")
-    src.publish(EventType.OPERATOR_MARKED_EMBRYOS, {
-        "embryo_ids": ["embryo_2", "embryo_3"], "count": 2,
-    }, source="detect_embryos:web-editor")
-    src.publish(EventType.ERROR_OCCURRED, {"msg": "lost focus"},
-                source="device-layer")
+    src.publish(
+        EventType.EMBRYOS_UPDATE,
+        {
+            "embryos": [
+                {
+                    "id": "embryo_1",
+                    "position_coarse": {"x": 1.0, "y": 2.0},
+                    "position_fine": {"x": 1.05, "y": 2.05},
+                    "has_fine_position": True,
+                },
+            ]
+        },
+        source="agent",
+    )
+    src.publish(
+        EventType.OPERATOR_EDITED_EMBRYO,
+        {
+            "embryo_id": "embryo_1",
+            "old_position_coarse": {"x": 1.0, "y": 2.0},
+            "new_position_coarse": {"x": 5.0, "y": 6.0},
+            "fine_position_invalidated": True,
+        },
+        source="web:map-edit",
+    )
+    src.publish(
+        EventType.OPERATOR_MARKED_EMBRYOS,
+        {
+            "embryo_ids": ["embryo_2", "embryo_3"],
+            "count": 2,
+        },
+        source="detect_embryos:web-editor",
+    )
+    src.publish(EventType.ERROR_OCCURRED, {"msg": "lost focus"}, source="device-layer")
     cap.stop()
 
     dst = EventBus()
diff --git a/tests/test_event_bus.py b/tests/test_event_bus.py
index 2bcf9e52..c2189543 100644
--- a/tests/test_event_bus.py
+++ b/tests/test_event_bus.py
@@ -16,7 +16,7 @@
 
 import pytest
 
-from gently.core.event_bus import EventBus, Event, EventType
+from gently.core.event_bus import Event, EventBus, EventType
 
 
 @pytest.fixture
@@ -29,12 +29,13 @@ def bus():
 # Subscribe and publish
 # =========================================================================
 
+
 class TestSubscribeAndPublish:
     def test_subscribe_and_publish(self, bus):
         received = []
         bus.subscribe(EventType.IMAGE_ACQUIRED, lambda e: received.append(e))
 
-        event = bus.publish(EventType.IMAGE_ACQUIRED, {"frame": 1}, source="camera")
+        bus.publish(EventType.IMAGE_ACQUIRED, {"frame": 1}, source="camera")
         assert len(received) == 1
         assert received[0].event_type == EventType.IMAGE_ACQUIRED
         assert received[0].data["frame"] == 1
@@ -84,6 +85,7 @@ def test_no_crosstalk(self, bus):
 # Async handlers
 # =========================================================================
 
+
 class TestAsyncHandlers:
     @pytest.mark.asyncio
     async def test_async_handler(self, bus):
@@ -108,6 +110,7 @@ async def handler(event):
 # Event history
 # =========================================================================
 
+
 class TestEventHistory:
     def test_event_history(self, bus):
         bus.publish(EventType.IMAGE_ACQUIRED, {"idx": 0})
@@ -156,6 +159,7 @@ def test_clear_history(self, bus):
 # Serialization
 # =========================================================================
 
+
 class TestEventSerialization:
     def test_event_to_dict_from_dict(self):
         original = Event(
@@ -181,6 +185,7 @@ def test_event_to_dict_from_dict(self):
 # Handler count
 # =========================================================================
 
+
 class TestHandlerCount:
     def test_handler_count_specific(self, bus):
         bus.subscribe(EventType.IMAGE_ACQUIRED, lambda e: None)
diff --git a/tests/test_federated.py b/tests/test_federated.py
index 8d595a8c..5ac287af 100644
--- a/tests/test_federated.py
+++ b/tests/test_federated.py
@@ -2,14 +2,13 @@
 Tests for federated averaging — weighted state dict averaging + orchestrator.
 """
 
-import asyncio
-import copy
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import MagicMock
 
 import pytest
 
 try:
     import torch
+
     HAS_TORCH = True
 except ImportError:
     HAS_TORCH = False
@@ -125,11 +124,13 @@ async def test_convergence_detection(self):
         # Mock _train_workers to return results with state_dict and same accuracy
         # (convergence threshold will trigger after round 2)
         async def fake_train(*args, **kwargs):
-            return [{
-                "val_accuracy": 0.90,
-                "dataset_size": 100,
-                "state_dict": {"w": torch.tensor([1.0])},
-            }]
+            return [
+                {
+                    "val_accuracy": 0.90,
+                    "dataset_size": 100,
+                    "state_dict": {"w": torch.tensor([1.0])},
+                }
+            ]
 
         orch._train_workers = fake_train
 
@@ -152,13 +153,16 @@ async def test_max_rounds_limit(self):
         orch = FederatedOrchestrator(verse_map=vm, peer_client=MagicMock())
 
         call_count = [0]
+
         async def fake_train(*args, **kwargs):
             call_count[0] += 1
-            return [{
-                "val_accuracy": 0.5 + call_count[0] * 0.1,
-                "dataset_size": 100,
-                "state_dict": {"w": torch.tensor([float(call_count[0])])},
-            }]
+            return [
+                {
+                    "val_accuracy": 0.5 + call_count[0] * 0.1,
+                    "dataset_size": 100,
+                    "state_dict": {"w": torch.tensor([float(call_count[0])])},
+                }
+            ]
 
         orch._train_workers = fake_train
 
diff --git a/tests/test_gently_store.py b/tests/test_gently_store.py
index 478faa4a..1a3686c0 100644
--- a/tests/test_gently_store.py
+++ b/tests/test_gently_store.py
@@ -15,8 +15,6 @@
 """
 
 import json
-import shutil
-import tempfile
 from pathlib import Path
 
 import numpy as np
@@ -44,6 +42,7 @@ def store(store_dir):
 # Session tests
 # =========================================================================
 
+
 class TestSessions:
     def test_create_session(self, store):
         sid = store.create_session("sess1", name="Test Session")
@@ -101,6 +100,7 @@ def test_create_duplicate_session_is_noop(self, store):
 # Embryo tests
 # =========================================================================
 
+
 class TestEmbryos:
     def test_register_embryo(self, store):
         store.create_session("s1")
@@ -143,6 +143,7 @@ def test_embryo_with_calibration(self, store):
 # Volume tests
 # =========================================================================
 
+
 def _make_volume(shape=(2, 20, 64, 64), dtype=np.uint16):
     """Create a test volume with some structure."""
     rng = np.random.RandomState(42)
@@ -271,6 +272,7 @@ def test_multiple_timepoints(self, store):
 # Projection tests
 # =========================================================================
 
+
 class TestProjections:
     def test_projection_b64(self, store):
         store.create_session("s1")
@@ -299,11 +301,14 @@ def test_projection_nonexistent(self, store):
 # Perception run lifecycle tests
 # =========================================================================
 
+
 class TestPerception:
     def test_create_and_complete_run(self, store):
         store.create_session("s1")
         run_id = store.create_perception_run(
-            "s1", "test_run", "vlm_stage_classification",
+            "s1",
+            "test_run",
+            "vlm_stage_classification",
             model_name="claude-opus-4-5-20251101",
         )
         assert isinstance(run_id, int)
@@ -340,7 +345,7 @@ def test_store_prediction_with_trace(self, store):
             "perception_result": {"stage": "early"},
             "steps": ["step1", "step2"],
         }
-        pred_id = store.store_prediction(
+        store.store_prediction(
             run_id=run_id,
             session_id="s1",
             embryo_id="e1",
@@ -400,7 +405,9 @@ def test_perception_run_with_config(self, store):
         store.create_session("s1")
         config = {"interval": 120, "stop_condition": "hatched"}
         run_id = store.create_perception_run(
-            "s1", "run1", "vlm",
+            "s1",
+            "run1",
+            "vlm",
             config=config,
         )
         assert run_id > 0
@@ -416,6 +423,7 @@ def test_complete_run_failed(self, store):
 # Ground truth tests
 # =========================================================================
 
+
 class TestGroundTruth:
     def test_set_and_get_ground_truth(self, store):
         store.create_session("s1")
@@ -443,6 +451,7 @@ def test_ground_truth_upsert(self, store):
 # Stats and utility tests
 # =========================================================================
 
+
 class TestUtility:
     def test_stats(self, store):
         store.create_session("s1")
@@ -482,6 +491,7 @@ def test_repr(self, store, store_dir):
 # EmbryoDataset integration with GentlyStore
 # =========================================================================
 
+
 class TestEmbryoDatasetIntegration:
     def test_from_store(self, store):
         from gently.dataset.embryo_dataset import EmbryoDataset
@@ -559,7 +569,8 @@ def test_store_prediction_gently_schema(self, store):
 
         dataset = EmbryoDataset.from_store(store)
         run_id = dataset.create_perception_run(
-            name="test", perception_method="vlm",
+            name="test",
+            perception_method="vlm",
             session_id="s1",
         )
         pred_id = dataset.store_prediction(
@@ -578,7 +589,9 @@ def test_complete_perception_run_gently_schema(self, store):
         store.create_session("s1")
         dataset = EmbryoDataset.from_store(store)
         run_id = dataset.create_perception_run(
-            name="test", perception_method="vlm", session_id="s1",
+            name="test",
+            perception_method="vlm",
+            session_id="s1",
         )
         dataset.complete_perception_run(run_id, status="completed")
         # No exception = success
@@ -596,15 +609,25 @@ def test_compute_run_metrics_gently_schema(self, store):
 
         dataset = EmbryoDataset.from_store(store)
         run_id = dataset.create_perception_run(
-            name="test", perception_method="vlm", session_id="s1",
+            name="test",
+            perception_method="vlm",
+            session_id="s1",
         )
         dataset.store_prediction(
-            run_id=run_id, embryo_id="e1", timepoint=0,
-            predicted_stage="early", confidence=0.9, session_id="s1",
+            run_id=run_id,
+            embryo_id="e1",
+            timepoint=0,
+            predicted_stage="early",
+            confidence=0.9,
+            session_id="s1",
         )
         dataset.store_prediction(
-            run_id=run_id, embryo_id="e1", timepoint=1,
-            predicted_stage="bean", confidence=0.6, session_id="s1",
+            run_id=run_id,
+            embryo_id="e1",
+            timepoint=1,
+            predicted_stage="bean",
+            confidence=0.6,
+            session_id="s1",
         )
 
         metrics = dataset.compute_run_metrics(run_id)
@@ -617,6 +640,7 @@ def test_compute_run_metrics_gently_schema(self, store):
 # Device-side serialize_value file-ref protocol tests
 # =========================================================================
 
+
 class TestSerializeValueFileRef:
     """Test the file-ref protocol in simple_server.serialize_value()."""
 
@@ -624,6 +648,7 @@ def test_large_array_becomes_file_ref(self, tmp_path):
         """Arrays > 1MB should be written as TIFF and return a file ref dict."""
         # Import the function under test
         import sys
+
         backend_path = str(Path(__file__).parent.parent / "backend")
         if backend_path not in sys.path:
             sys.path.insert(0, backend_path)
@@ -651,6 +676,7 @@ def test_large_array_becomes_file_ref(self, tmp_path):
     def test_small_array_stays_inline(self, tmp_path):
         """Arrays < 1MB should be serialized normally (as list)."""
         import sys
+
         backend_path = str(Path(__file__).parent.parent / "backend")
         if backend_path not in sys.path:
             sys.path.insert(0, backend_path)
@@ -673,6 +699,7 @@ def test_small_array_stays_inline(self, tmp_path):
     def test_no_volume_dir_falls_back(self):
         """Without volume_dir, serialize_value behaves as before (list)."""
         import sys
+
         backend_path = str(Path(__file__).parent.parent / "backend")
         if backend_path not in sys.path:
             sys.path.insert(0, backend_path)
@@ -691,6 +718,7 @@ def test_no_volume_dir_falls_back(self):
 # Client-side _resolve_file_refs tests
 # =========================================================================
 
+
 class TestResolveFileRefs:
     """Test _resolve_file_refs() in QueueServerClient."""
 
@@ -740,7 +768,7 @@ def test_resolve_file_refs_nested(self, tmp_path):
                     "dtype": "uint16",
                 },
                 "other_key": "kept",
-            }
+            },
         }
 
         client = QueueServerClient.__new__(QueueServerClient)
diff --git a/tests/test_harness_state.py b/tests/test_harness_state.py
index 62165ec9..ad40f1d1 100644
--- a/tests/test_harness_state.py
+++ b/tests/test_harness_state.py
@@ -2,54 +2,67 @@
 Tests for harness state management: FocusDataPoint, EmbryoState, ExperimentState.
 """
 
-import pytest
-import numpy as np
 from datetime import datetime, timedelta
 
-from gently.harness.state import FocusDataPoint, EmbryoState, ExperimentState
-
+from gently.harness.state import EmbryoState, ExperimentState, FocusDataPoint
 
 # ===========================================================================
 # FocusDataPoint
 # ===========================================================================
 
+
 class TestFocusDataPoint:
     """FocusDataPoint serialization and backward compatibility."""
 
     def test_creation(self):
         fp = FocusDataPoint(
-            z=50.0, secondary_axis=1.5, score=0.9, r_squared=0.95,
-            timestamp=datetime.now(), method='calibration'
+            z=50.0,
+            secondary_axis=1.5,
+            score=0.9,
+            r_squared=0.95,
+            timestamp=datetime.now(),
+            method="calibration",
         )
         assert fp.z == 50.0
         assert fp.secondary_axis == 1.5
 
     def test_backward_compat_properties(self):
         fp = FocusDataPoint(
-            z=50.0, secondary_axis=1.5, score=0.9, r_squared=0.95,
-            timestamp=datetime.now(), method='fine_focus'
+            z=50.0,
+            secondary_axis=1.5,
+            score=0.9,
+            r_squared=0.95,
+            timestamp=datetime.now(),
+            method="fine_focus",
         )
         assert fp.piezo == 50.0
         assert fp.galvo == 1.5
 
     def test_to_dict_has_both_keys(self):
         fp = FocusDataPoint(
-            z=50.0, secondary_axis=1.5, score=0.9, r_squared=0.95,
-            timestamp=datetime.now(), method='manual'
+            z=50.0,
+            secondary_axis=1.5,
+            score=0.9,
+            r_squared=0.95,
+            timestamp=datetime.now(),
+            method="manual",
         )
         d = fp.to_dict()
         # New keys
-        assert d['z'] == 50.0
-        assert d['secondary_axis'] == 1.5
+        assert d["z"] == 50.0
+        assert d["secondary_axis"] == 1.5
         # Backward-compat keys
-        assert d['piezo'] == 50.0
-        assert d['galvo'] == 1.5
+        assert d["piezo"] == 50.0
+        assert d["galvo"] == 1.5
 
     def test_from_dict_new_keys(self):
         d = {
-            'z': 60.0, 'secondary_axis': 2.0, 'score': 0.8,
-            'r_squared': 0.9, 'timestamp': datetime.now().isoformat(),
-            'method': 'calibration'
+            "z": 60.0,
+            "secondary_axis": 2.0,
+            "score": 0.8,
+            "r_squared": 0.9,
+            "timestamp": datetime.now().isoformat(),
+            "method": "calibration",
         }
         fp = FocusDataPoint.from_dict(d)
         assert fp.z == 60.0
@@ -58,9 +71,12 @@ def test_from_dict_new_keys(self):
     def test_from_dict_old_keys(self):
         """Deserializing data with old key names (piezo/galvo) must work."""
         d = {
-            'piezo': 70.0, 'galvo': 3.0, 'score': 0.85,
-            'r_squared': 0.92, 'timestamp': datetime.now().isoformat(),
-            'method': 'fine_focus'
+            "piezo": 70.0,
+            "galvo": 3.0,
+            "score": 0.85,
+            "r_squared": 0.92,
+            "timestamp": datetime.now().isoformat(),
+            "method": "fine_focus",
         }
         fp = FocusDataPoint.from_dict(d)
         assert fp.z == 70.0
@@ -68,8 +84,13 @@ def test_from_dict_old_keys(self):
 
     def test_roundtrip(self):
         original = FocusDataPoint(
-            z=42.0, secondary_axis=1.1, score=0.7, r_squared=0.88,
-            timestamp=datetime.now(), method='calibration', algorithm='gradient'
+            z=42.0,
+            secondary_axis=1.1,
+            score=0.7,
+            r_squared=0.88,
+            timestamp=datetime.now(),
+            method="calibration",
+            algorithm="gradient",
         )
         restored = FocusDataPoint.from_dict(original.to_dict())
         assert restored.z == original.z
@@ -81,6 +102,7 @@ def test_roundtrip(self):
 # EmbryoState — Focus Methods
 # ===========================================================================
 
+
 class TestEmbryoFocus:
     """EmbryoState focus tracking and analysis."""
 
@@ -88,12 +110,16 @@ def _make_embryo_with_focus(self):
         e = EmbryoState(id="embryo_1")
         now = datetime.now()
         for i in range(5):
-            e.focus_history.append(FocusDataPoint(
-                z=50.0 + i * 2, secondary_axis=1.0 + i * 0.1,
-                score=0.9, r_squared=0.95,
-                timestamp=now - timedelta(hours=4 - i),
-                method='calibration',
-            ))
+            e.focus_history.append(
+                FocusDataPoint(
+                    z=50.0 + i * 2,
+                    secondary_axis=1.0 + i * 0.1,
+                    score=0.9,
+                    r_squared=0.95,
+                    timestamp=now - timedelta(hours=4 - i),
+                    method="calibration",
+                )
+            )
         return e
 
     def test_add_focus_datapoint_new_args(self):
@@ -127,10 +153,16 @@ def test_get_focus_empty_history(self):
 
     def test_get_focus_min_r_squared_filter(self):
         e = EmbryoState(id="e1")
-        e.focus_history.append(FocusDataPoint(
-            z=50.0, secondary_axis=0.0, score=0.5, r_squared=0.3,
-            timestamp=datetime.now(), method='manual'
-        ))
+        e.focus_history.append(
+            FocusDataPoint(
+                z=50.0,
+                secondary_axis=0.0,
+                score=0.5,
+                r_squared=0.3,
+                timestamp=datetime.now(),
+                method="manual",
+            )
+        )
         # With default min_r_squared=0.5, this low-quality point is filtered
         assert e.get_focus_at_secondary(0.0) is None
 
@@ -163,10 +195,16 @@ def test_needs_refocus_recent(self):
 
     def test_needs_refocus_old_data(self):
         e = EmbryoState(id="e1")
-        e.focus_history.append(FocusDataPoint(
-            z=50.0, secondary_axis=0.0, score=0.9, r_squared=0.95,
-            timestamp=datetime.now() - timedelta(hours=2), method='manual'
-        ))
+        e.focus_history.append(
+            FocusDataPoint(
+                z=50.0,
+                secondary_axis=0.0,
+                score=0.9,
+                r_squared=0.95,
+                timestamp=datetime.now() - timedelta(hours=2),
+                method="manual",
+            )
+        )
         assert e.needs_refocus(max_age_minutes=60) is True
 
     def test_needs_refocus_galvo_kwarg(self):
@@ -179,6 +217,7 @@ def test_needs_refocus_galvo_kwarg(self):
 # EmbryoState — Detection Methods
 # ===========================================================================
 
+
 class TestEmbryoDetection:
     """EmbryoState detection result tracking."""
 
@@ -231,6 +270,7 @@ def test_mark_detection_verified_by_timepoint(self):
 # EmbryoState — CV Results
 # ===========================================================================
 
+
 class TestEmbryoCVResults:
     """EmbryoState CV analysis result tracking."""
 
@@ -260,6 +300,7 @@ def test_get_cv_result_by_timepoint(self):
 # EmbryoState — Exposure Tracking
 # ===========================================================================
 
+
 class TestEmbryoExposure:
     """EmbryoState light exposure tracking."""
 
@@ -288,28 +329,30 @@ def test_exposure_summary(self):
 # EmbryoState — Serialization
 # ===========================================================================
 
+
 class TestEmbryoSerialization:
     """EmbryoState to_dict serialization."""
 
     def test_to_dict_basic(self):
         e = EmbryoState(id="e1", nickname="the fast one")
         d = e.to_dict()
-        assert d['id'] == 'e1'
-        assert d['nickname'] == 'the fast one'
-        assert d['timepoints_acquired'] == 0
+        assert d["id"] == "e1"
+        assert d["nickname"] == "the fast one"
+        assert d["timepoints_acquired"] == 0
 
     def test_to_dict_with_focus_history(self):
         e = EmbryoState(id="e1")
         e.add_focus_datapoint(z=50.0, score=0.9, r_squared=0.95)
         d = e.to_dict()
-        assert len(d['focus_history']) == 1
-        assert d['focus_history'][0]['z'] == 50.0
+        assert len(d["focus_history"]) == 1
+        assert d["focus_history"][0]["z"] == 50.0
 
 
 # ===========================================================================
 # ExperimentState
 # ===========================================================================
 
+
 class TestExperimentState:
     """ExperimentState management."""
 
@@ -362,9 +405,9 @@ def test_to_dict(self):
         exp = ExperimentState()
         exp.add_embryo("e1")
         d = exp.to_dict()
-        assert d['embryo_count'] == 1
-        assert 'e1' in d['embryos']
-        assert 'calibration_prior' in d
+        assert d["embryo_count"] == 1
+        assert "e1" in d["embryos"]
+        assert "calibration_prior" in d
 
     def test_summary_no_experiment(self):
         exp = ExperimentState()
diff --git a/tests/test_log_bridge.py b/tests/test_log_bridge.py
index 2079d365..34ffca54 100644
--- a/tests/test_log_bridge.py
+++ b/tests/test_log_bridge.py
@@ -3,15 +3,14 @@
 from __future__ import annotations
 
 import logging
-import os
 
 import pytest
 
 from gently.core.event_bus import EventBus, EventType
 from gently.core.log_bridge import (
+    _NEVER_BRIDGE,
     LogToBusHandler,
     configure_log_bridge,
-    _NEVER_BRIDGE,
 )
 
 
@@ -227,8 +226,10 @@ def test_third_party_included_when_opted_in(bus_with_capture, monkeypatch):
     finally:
         # Strip handler from every logger we might have attached to —
         # belt and braces, since the function defaults to a long list.
-        for name in (list(logging.Logger.manager.loggerDict.keys()) +
-                     ["gently", "gently_perception"]):
+        for name in list(logging.Logger.manager.loggerDict.keys()) + [
+            "gently",
+            "gently_perception",
+        ]:
             try:
                 logging.getLogger(name).removeHandler(h)
             except Exception:
diff --git a/tests/test_mesh_models.py b/tests/test_mesh_models.py
index 406952ed..b68c7f94 100644
--- a/tests/test_mesh_models.py
+++ b/tests/test_mesh_models.py
@@ -4,7 +4,6 @@
 """
 
 import time
-import pytest
 
 from gently.mesh.models import (
     DatasetAdvertisement,
@@ -19,8 +18,14 @@
 
 class TestGpuInfo:
     def test_round_trip(self):
-        gpu = GpuInfo(device_index=0, name="A5000", vram_gb=24.0,
-                       compute_capability="8.6", utilization_pct=45.0, memory_used_gb=8.2)
+        gpu = GpuInfo(
+            device_index=0,
+            name="A5000",
+            vram_gb=24.0,
+            compute_capability="8.6",
+            utilization_pct=45.0,
+            memory_used_gb=8.2,
+        )
         d = gpu.to_dict()
         gpu2 = GpuInfo.from_dict(d)
         assert gpu2.name == "A5000"
@@ -37,9 +42,14 @@ def test_defaults(self):
 class TestDatasetAdvertisement:
     def test_round_trip(self):
         ds = DatasetAdvertisement(
-            session_id="s1", session_name="Run 1", embryo_count=12,
-            volume_count=120, has_ground_truth=True, ground_truth_count=50,
-            stages_covered=["early", "comma"], total_size_gb=2.5,
+            session_id="s1",
+            session_name="Run 1",
+            embryo_count=12,
+            volume_count=120,
+            has_ground_truth=True,
+            ground_truth_count=50,
+            stages_covered=["early", "comma"],
+            total_size_gb=2.5,
         )
         d = ds.to_dict()
         ds2 = DatasetAdvertisement.from_dict(d)
@@ -50,8 +60,7 @@ def test_round_trip(self):
 
 class TestPeerCapability:
     def test_round_trip_legacy_fields(self):
-        cap = PeerCapability(has_microscope=True, has_gpu=True,
-                              gpu_name="A5000", gpu_vram_gb=24.0)
+        cap = PeerCapability(has_microscope=True, has_gpu=True, gpu_name="A5000", gpu_vram_gb=24.0)
         d = cap.to_dict()
         cap2 = PeerCapability.from_dict(d)
         assert cap2.has_microscope is True
@@ -89,8 +98,12 @@ def test_enhanced_fields(self):
 
 class TestPeerStatus:
     def test_round_trip(self):
-        status = PeerStatus(session_id="s1", acquisition_status="running",
-                             embryo_count=5, version="0.9.2")
+        status = PeerStatus(
+            session_id="s1",
+            acquisition_status="running",
+            embryo_count=5,
+            version="0.9.2",
+        )
         d = status.to_dict()
         status2 = PeerStatus.from_dict(d)
         assert status2.session_id == "s1"
@@ -104,8 +117,12 @@ def test_defaults(self):
 
 class TestPeerInfo:
     def test_round_trip(self):
-        peer = PeerInfo(instance_id="abc123", hostname="lab-pc",
-                         ip_address="192.168.1.10", viz_port=8080)
+        peer = PeerInfo(
+            instance_id="abc123",
+            hostname="lab-pc",
+            ip_address="192.168.1.10",
+            viz_port=8080,
+        )
         d = peer.to_dict()
         peer2 = PeerInfo.from_dict(d)
         assert peer2.instance_id == "abc123"
@@ -136,8 +153,10 @@ def test_values(self):
 class TestPersistedPeer:
     def test_round_trip(self):
         peer = PersistedPeer(
-            instance_id="abc123", hostname="lab-pc",
-            ip_address="192.168.1.10", online=True,
+            instance_id="abc123",
+            hostname="lab-pc",
+            ip_address="192.168.1.10",
+            online=True,
             roles=["ml_trainer"],
             datasets=[DatasetAdvertisement(session_id="s1")],
         )
@@ -150,8 +169,10 @@ def test_round_trip(self):
 
     def test_from_peer_info(self):
         info = PeerInfo(
-            instance_id="abc123", hostname="lab-pc",
-            ip_address="192.168.1.10", is_trusted=True,
+            instance_id="abc123",
+            hostname="lab-pc",
+            ip_address="192.168.1.10",
+            is_trusted=True,
             capabilities=PeerCapability(
                 has_gpu=True,
                 roles=["ml_trainer"],
diff --git a/tests/test_mesh_pairing.py b/tests/test_mesh_pairing.py
index d2a1055a..61696967 100644
--- a/tests/test_mesh_pairing.py
+++ b/tests/test_mesh_pairing.py
@@ -3,15 +3,12 @@
 """
 
 import time
-from pathlib import Path
 
 import pytest
 
 from gently.mesh.pairing import (
-    ALL_SCOPES,
     PAIRING_EXPIRY,
     PairingManager,
-    PairingSession,
     TrustedPeer,
 )
 
@@ -96,7 +93,8 @@ def test_full_pairing_flow(self, pairing_manager, remote_manager):
 
         # Responder confirms
         remote_manager.confirm_pairing(
-            session_resp.pairing_id, remote_manager.instance_id,
+            session_resp.pairing_id,
+            remote_manager.instance_id,
         )
 
         # Initiator confirms (initiator already auto-confirms, but let's also
@@ -105,14 +103,16 @@ def test_full_pairing_flow(self, pairing_manager, remote_manager):
         # the confirm on the responder's session from the initiator side.
         # In the real flow, the initiator calls POST /confirm on the responder.
         # The confirm_pairing on remote_manager with initiator_id completes it.
-        result = remote_manager.confirm_pairing(
-            session_resp.pairing_id, pairing_manager.instance_id,
+        remote_manager.confirm_pairing(
+            session_resp.pairing_id,
+            pairing_manager.instance_id,
         )
 
         # Both sides confirmed → session should be confirmed
         # But we need to confirm on initiator side too
         pairing_manager.confirm_pairing(
-            session_resp.pairing_id, remote_manager.instance_id,
+            session_resp.pairing_id,
+            remote_manager.instance_id,
         )
 
         # Check trust established on remote
@@ -121,7 +121,9 @@ def test_full_pairing_flow(self, pairing_manager, remote_manager):
     def test_reject_pairing(self, pairing_manager, remote_manager):
         nonce = pairing_manager.create_initiation()
         session = remote_manager.handle_pair_request(
-            pairing_manager.instance_id, pairing_manager.hostname, nonce,
+            pairing_manager.instance_id,
+            pairing_manager.hostname,
+            nonce,
         )
         rejected = remote_manager.reject_pairing(session.pairing_id)
         assert rejected.status == "rejected"
@@ -129,7 +131,9 @@ def test_reject_pairing(self, pairing_manager, remote_manager):
     def test_get_pending_sessions(self, pairing_manager, remote_manager):
         nonce = pairing_manager.create_initiation()
         remote_manager.handle_pair_request(
-            pairing_manager.instance_id, pairing_manager.hostname, nonce,
+            pairing_manager.instance_id,
+            pairing_manager.hostname,
+            nonce,
         )
         pending = remote_manager.get_pending_sessions()
         assert len(pending) == 1
@@ -137,7 +141,9 @@ def test_get_pending_sessions(self, pairing_manager, remote_manager):
     def test_cleanup_expired(self, pairing_manager, remote_manager):
         nonce = pairing_manager.create_initiation()
         session = remote_manager.handle_pair_request(
-            pairing_manager.instance_id, pairing_manager.hostname, nonce,
+            pairing_manager.instance_id,
+            pairing_manager.hostname,
+            nonce,
         )
         # Force expiry
         session.created_at = time.time() - PAIRING_EXPIRY - 10
@@ -163,14 +169,18 @@ def test_save_and_load(self, config_dir):
 
     def test_unpair_by_instance_id(self, pairing_manager):
         pairing_manager._trusted["peer-z"] = TrustedPeer(
-            instance_id="peer-z", hostname="host-z", base_token="abc",
+            instance_id="peer-z",
+            hostname="host-z",
+            base_token="abc",
         )
         assert pairing_manager.unpair("peer-z") is True
         assert not pairing_manager.is_trusted("peer-z")
 
     def test_unpair_by_hostname(self, pairing_manager):
         pairing_manager._trusted["peer-w"] = TrustedPeer(
-            instance_id="peer-w", hostname="Host-W", base_token="abc",
+            instance_id="peer-w",
+            hostname="Host-W",
+            base_token="abc",
         )
         assert pairing_manager.unpair("host-w") is True
 
@@ -181,7 +191,9 @@ def test_unpair_nonexistent(self, pairing_manager):
 class TestTokenAuth:
     def test_verify_valid_token(self, pairing_manager):
         pairing_manager._trusted["peer-auth"] = TrustedPeer(
-            instance_id="peer-auth", hostname="host", base_token="secret123",
+            instance_id="peer-auth",
+            hostname="host",
+            base_token="secret123",
         )
         token = pairing_manager.get_token_for_peer("peer-auth")
         result = pairing_manager.verify_token(token)
@@ -189,7 +201,9 @@ def test_verify_valid_token(self, pairing_manager):
 
     def test_verify_invalid_token(self, pairing_manager):
         pairing_manager._trusted["peer-auth"] = TrustedPeer(
-            instance_id="peer-auth", hostname="host", base_token="secret123",
+            instance_id="peer-auth",
+            hostname="host",
+            base_token="secret123",
         )
         result = pairing_manager.verify_token("invalid-token")
         assert result is None
@@ -201,7 +215,9 @@ def test_token_for_untrusted_returns_none(self, pairing_manager):
 class TestScopes:
     def test_default_scopes(self, pairing_manager):
         pairing_manager._trusted["peer-s"] = TrustedPeer(
-            instance_id="peer-s", hostname="host", base_token="abc",
+            instance_id="peer-s",
+            hostname="host",
+            base_token="abc",
         )
         scopes = pairing_manager.get_scopes_for_peer("peer-s")
         assert "status" in scopes
@@ -210,7 +226,9 @@ def test_default_scopes(self, pairing_manager):
 
     def test_set_scopes(self, pairing_manager):
         pairing_manager._trusted["peer-s2"] = TrustedPeer(
-            instance_id="peer-s2", hostname="host2", base_token="abc",
+            instance_id="peer-s2",
+            hostname="host2",
+            base_token="abc",
         )
         success = pairing_manager.set_scopes("peer-s2", ["status"])
         assert success is True
@@ -219,7 +237,9 @@ def test_set_scopes(self, pairing_manager):
 
     def test_set_invalid_scope(self, pairing_manager):
         pairing_manager._trusted["peer-s3"] = TrustedPeer(
-            instance_id="peer-s3", hostname="host3", base_token="abc",
+            instance_id="peer-s3",
+            hostname="host3",
+            base_token="abc",
         )
         success = pairing_manager.set_scopes("peer-s3", ["invalid_scope"])
         assert success is False
diff --git a/tests/test_mesh_service.py b/tests/test_mesh_service.py
index eded8d30..7397890c 100644
--- a/tests/test_mesh_service.py
+++ b/tests/test_mesh_service.py
@@ -2,15 +2,13 @@
 Tests for MeshService — peer lifecycle, reaper, queries.
 """
 
-import asyncio
 import time
-from pathlib import Path
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import MagicMock
 
 import pytest
 
 from gently.mesh.mesh_service import MeshService
-from gently.mesh.models import PeerCapability, PeerInfo, PeerStatus
+from gently.mesh.models import PeerCapability
 
 
 @pytest.fixture
diff --git a/tests/test_ml_architectures.py b/tests/test_ml_architectures.py
index d337a9a4..01d426a4 100644
--- a/tests/test_ml_architectures.py
+++ b/tests/test_ml_architectures.py
@@ -2,16 +2,22 @@
 Tests for ML architecture registry.
 """
 
-import pytest
-
 from gently.ml.architectures import ARCHITECTURE_REGISTRY, get_suitable_architectures
 
 
 class TestArchitectureRegistry:
     def test_all_entries_have_required_fields(self):
-        required = {"name", "family", "param_count_m", "min_vram_gb",
-                     "recommended_vram_gb", "min_dataset_size",
-                     "recommended_dataset_size", "training_speed", "suitability"}
+        required = {
+            "name",
+            "family",
+            "param_count_m",
+            "min_vram_gb",
+            "recommended_vram_gb",
+            "min_dataset_size",
+            "recommended_dataset_size",
+            "training_speed",
+            "suitability",
+        }
         for arch_id, meta in ARCHITECTURE_REGISTRY.items():
             for field in required:
                 assert field in meta, f"{arch_id} missing '{field}'"
diff --git a/tests/test_ml_data_loader.py b/tests/test_ml_data_loader.py
index 4404b404..0d6ee315 100644
--- a/tests/test_ml_data_loader.py
+++ b/tests/test_ml_data_loader.py
@@ -2,13 +2,14 @@
 Tests for ML data loader — GentlyDataset and data splits.
 """
 
-import pytest
 from pathlib import Path
 from unittest.mock import MagicMock
 
+import pytest
+
 try:
     import torch
-    import numpy as np
+
     HAS_TORCH = True
 except ImportError:
     HAS_TORCH = False
@@ -19,12 +20,14 @@
 class TestGentlyDataset:
     def test_length(self):
         from gently.ml.data_loader import GentlyDataset
+
         samples = [("/fake/img1.png", 0), ("/fake/img2.png", 1)]
         ds = GentlyDataset(samples, input_size=64, augment=False)
         assert len(ds) == 2
 
     def test_getitem_returns_tensor_and_label(self):
         from gently.ml.data_loader import GentlyDataset
+
         samples = [("/nonexistent/img.png", 3)]
         ds = GentlyDataset(samples, input_size=64, augment=False)
         tensor, label = ds[0]
@@ -34,6 +37,7 @@ def test_getitem_returns_tensor_and_label(self):
 
     def test_augmentations(self):
         from gently.ml.data_loader import GentlyDataset
+
         samples = [("/nonexistent/img.png", 0)]
         ds = GentlyDataset(samples, input_size=32, augment=True)
         # Should not crash
@@ -42,6 +46,7 @@ def test_augmentations(self):
 
     def test_empty_dataset(self):
         from gently.ml.data_loader import GentlyDataset
+
         ds = GentlyDataset([], input_size=64)
         assert len(ds) == 0
 
@@ -49,16 +54,17 @@ def test_empty_dataset(self):
 class TestCreateDataSplits:
     def test_basic_split(self):
         from gently.ml.data_loader import create_data_splits
+
         labels_data = {
             "class_names": ["early", "comma"],
-            "samples": [
-                {"path": f"img_{i}.png", "label": i % 2}
-                for i in range(20)
-            ],
+            "samples": [{"path": f"img_{i}.png", "label": i % 2} for i in range(20)],
         }
         train, val, test = create_data_splits(
-            labels_data, data_root=Path("/fake"),
-            train_ratio=0.7, val_ratio=0.15, random_seed=42,
+            labels_data,
+            data_root=Path("/fake"),
+            train_ratio=0.7,
+            val_ratio=0.15,
+            random_seed=42,
         )
         total = len(train) + len(val) + len(test)
         assert total == 20
@@ -67,6 +73,7 @@ def test_basic_split(self):
 
     def test_stratified_preserves_labels(self):
         from gently.ml.data_loader import create_data_splits
+
         # 10 samples of class 0, 10 of class 1
         labels_data = {
             "class_names": ["A", "B"],
@@ -76,7 +83,9 @@ def test_stratified_preserves_labels(self):
             ),
         }
         train, val, test = create_data_splits(
-            labels_data, data_root=Path("/fake"), random_seed=42,
+            labels_data,
+            data_root=Path("/fake"),
+            random_seed=42,
         )
         # Both classes should be present in train set
         train_labels = set(label for _, label in train.samples)
@@ -85,9 +94,11 @@ def test_stratified_preserves_labels(self):
 
     def test_empty_dataset(self):
         from gently.ml.data_loader import create_data_splits
+
         labels_data = {"class_names": [], "samples": []}
         train, val, test = create_data_splits(
-            labels_data, data_root=Path("/fake"),
+            labels_data,
+            data_root=Path("/fake"),
         )
         assert len(train) == 0
         assert len(val) == 0
@@ -95,12 +106,15 @@ def test_empty_dataset(self):
 
     def test_no_overlap_between_splits(self):
         from gently.ml.data_loader import create_data_splits
+
         labels_data = {
             "class_names": ["X"],
             "samples": [{"path": f"x_{i}.png", "label": 0} for i in range(30)],
         }
         train, val, test = create_data_splits(
-            labels_data, data_root=Path("/fake"), random_seed=42,
+            labels_data,
+            data_root=Path("/fake"),
+            random_seed=42,
         )
         train_paths = {p for p, _ in train.samples}
         val_paths = {p for p, _ in val.samples}
@@ -113,6 +127,7 @@ def test_no_overlap_between_splits(self):
 class TestBuildLabelsFromStore:
     def test_build_labels(self):
         from gently.ml.data_loader import build_labels_from_store
+
         store = MagicMock()
         sess = MagicMock()
         sess.session_id = "s1"
@@ -135,6 +150,7 @@ def test_build_labels(self):
 
     def test_build_labels_no_ground_truth(self):
         from gently.ml.data_loader import build_labels_from_store
+
         store = MagicMock()
         sess = MagicMock()
         sess.session_id = "s1"
diff --git a/tests/test_ml_models.py b/tests/test_ml_models.py
index 5eb6062e..757a0091 100644
--- a/tests/test_ml_models.py
+++ b/tests/test_ml_models.py
@@ -2,8 +2,6 @@
 Tests for ML data models — MLPipeline, TrainingRun, ModelConfig, etc.
 """
 
-import pytest
-
 from gently.ml.models import (
     DataSplit,
     MLPipeline,
@@ -17,8 +15,12 @@
 
 class TestModelConfig:
     def test_round_trip(self):
-        mc = ModelConfig(architecture="efficientnet_b2", num_classes=8,
-                          pretrained=True, input_channels=1)
+        mc = ModelConfig(
+            architecture="efficientnet_b2",
+            num_classes=8,
+            pretrained=True,
+            input_channels=1,
+        )
         d = mc.to_dict()
         mc2 = ModelConfig.from_dict(d)
         assert mc2.architecture == "efficientnet_b2"
@@ -35,8 +37,7 @@ def test_defaults(self):
 
 class TestTrainingConfig:
     def test_round_trip(self):
-        tc = TrainingConfig(batch_size=64, epochs=100, learning_rate=3e-4,
-                             mixed_precision=True)
+        tc = TrainingConfig(batch_size=64, epochs=100, learning_rate=3e-4, mixed_precision=True)
         d = tc.to_dict()
         tc2 = TrainingConfig.from_dict(d)
         assert tc2.batch_size == 64
@@ -51,8 +52,7 @@ def test_augmentations(self):
 
 class TestDataSplit:
     def test_round_trip(self):
-        ds = DataSplit(train_ratio=0.8, val_ratio=0.1, test_ratio=0.1,
-                        random_seed=123)
+        ds = DataSplit(train_ratio=0.8, val_ratio=0.1, test_ratio=0.1, random_seed=123)
         d = ds.to_dict()
         ds2 = DataSplit.from_dict(d)
         assert ds2.train_ratio == 0.8
@@ -66,10 +66,13 @@ def test_ratios_sum_to_one(self):
 class TestTrainingRun:
     def test_round_trip(self):
         run = TrainingRun(
-            id="run1", pipeline_id="pipe1",
+            id="run1",
+            pipeline_id="pipe1",
             status=TrainingStatus.TRAINING.value,
-            current_epoch=10, total_epochs=50,
-            val_accuracy=0.85, best_val_accuracy=0.87,
+            current_epoch=10,
+            total_epochs=50,
+            val_accuracy=0.85,
+            best_val_accuracy=0.87,
             model_config=ModelConfig(architecture="resnet18"),
         )
         d = run.to_dict()
@@ -88,7 +91,9 @@ def test_none_configs(self):
 class TestMLPipeline:
     def test_round_trip(self):
         pipeline = MLPipeline(
-            id="p1", campaign_id="c1", name="Embryo Classifier",
+            id="p1",
+            campaign_id="c1",
+            name="Embryo Classifier",
             task="embryo_stage_classification",
             model_config=ModelConfig(architecture="efficientnet_b2"),
             best_accuracy=0.94,
diff --git a/tests/test_ml_pipeline_mixin.py b/tests/test_ml_pipeline_mixin.py
index a7dbb19e..658719c2 100644
--- a/tests/test_ml_pipeline_mixin.py
+++ b/tests/test_ml_pipeline_mixin.py
@@ -2,8 +2,6 @@
 Tests for MlPipelinesMixin — ML tables in ContextStore.
 """
 
-import pytest
-
 
 class TestMlPipelines:
     def test_create_pipeline(self, context_store):
@@ -20,7 +18,8 @@ def test_create_pipeline(self, context_store):
     def test_get_pipeline(self, context_store):
         campaign_id = context_store.create_campaign(description="Test ML")
         created = context_store.create_ml_pipeline(
-            campaign_id=campaign_id, name="P1",
+            campaign_id=campaign_id,
+            name="P1",
         )
         fetched = context_store.get_ml_pipeline(created["id"])
         assert fetched is not None
@@ -40,10 +39,13 @@ def test_list_pipelines(self, context_store):
     def test_update_pipeline(self, context_store):
         campaign_id = context_store.create_campaign(description="Test ML")
         created = context_store.create_ml_pipeline(
-            campaign_id=campaign_id, name="P1",
+            campaign_id=campaign_id,
+            name="P1",
         )
         updated = context_store.update_ml_pipeline(
-            created["id"], status="training", best_accuracy=0.85,
+            created["id"],
+            status="training",
+            best_accuracy=0.85,
         )
         assert updated["status"] == "training"
         assert updated["best_accuracy"] == 0.85
@@ -67,7 +69,8 @@ class TestTrainingRuns:
     def test_create_run(self, context_store):
         campaign_id = context_store.create_campaign(description="Test ML")
         pipeline = context_store.create_ml_pipeline(
-            campaign_id=campaign_id, name="P1",
+            campaign_id=campaign_id,
+            name="P1",
         )
         run = context_store.create_training_run(
             pipeline_id=pipeline["id"],
@@ -79,7 +82,8 @@ def test_create_run(self, context_store):
     def test_update_run(self, context_store):
         campaign_id = context_store.create_campaign(description="Test ML")
         pipeline = context_store.create_ml_pipeline(
-            campaign_id=campaign_id, name="P1",
+            campaign_id=campaign_id,
+            name="P1",
         )
         run = context_store.create_training_run(pipeline_id=pipeline["id"])
         updated = context_store.update_training_run(
@@ -95,7 +99,8 @@ def test_update_run(self, context_store):
     def test_list_runs(self, context_store):
         campaign_id = context_store.create_campaign(description="Test ML")
         pipeline = context_store.create_ml_pipeline(
-            campaign_id=campaign_id, name="P1",
+            campaign_id=campaign_id,
+            name="P1",
         )
         context_store.create_training_run(pipeline_id=pipeline["id"])
         context_store.create_training_run(pipeline_id=pipeline["id"])
@@ -124,7 +129,8 @@ def test_save_and_get(self, context_store):
     def test_assessment_with_pipeline(self, context_store):
         campaign_id = context_store.create_campaign(description="Test ML")
         pipeline = context_store.create_ml_pipeline(
-            campaign_id=campaign_id, name="P1",
+            campaign_id=campaign_id,
+            name="P1",
         )
         assessment = context_store.save_data_assessment(
             pipeline_id=pipeline["id"],
diff --git a/tests/test_prompt_manager.py b/tests/test_prompt_manager.py
index e6b3b6ec..90b79b83 100644
--- a/tests/test_prompt_manager.py
+++ b/tests/test_prompt_manager.py
@@ -2,17 +2,18 @@
 Tests for PromptManager: tool selection, caching, and context data gathering.
 """
 
+from datetime import datetime
+from unittest.mock import MagicMock
+
 import pytest
-from unittest.mock import MagicMock, patch
-from datetime import datetime, timedelta
 
 from gently.harness.prompts.manager import PromptManager
 
-
 # ===========================================================================
 # Tool Selection
 # ===========================================================================
 
+
 class TestToolSelection:
     """PromptManager returns correct tools per mode."""
 
@@ -34,14 +35,29 @@ def test_plan_mode_only_plan_tools(self, mgr):
         plan_tools = mgr.get_tools_for_mode("plan", has_microscope=False)
         plan_tool_names = {t["name"] for t in plan_tools}
         allowed = {
-            "create_campaign", "create_plan_item", "update_plan_item",
-            "link_plan_items", "propose_plan", "get_plan_status",
-            "get_plan_item", "move_plan_item", "delete_plan_item",
-            "reorder_plan_items", "update_phase", "delete_phase",
-            "export_plan", "query_lab_history", "check_hardware_capability",
-            "search_literature", "search_strains", "validate_plan",
-            "batch_update_status", "batch_update_spec",
-            "save_plan_template", "list_templates", "apply_template",
+            "create_campaign",
+            "create_plan_item",
+            "update_plan_item",
+            "link_plan_items",
+            "propose_plan",
+            "get_plan_status",
+            "get_plan_item",
+            "move_plan_item",
+            "delete_plan_item",
+            "reorder_plan_items",
+            "update_phase",
+            "delete_phase",
+            "export_plan",
+            "query_lab_history",
+            "check_hardware_capability",
+            "search_literature",
+            "search_strains",
+            "validate_plan",
+            "batch_update_status",
+            "batch_update_spec",
+            "save_plan_template",
+            "list_templates",
+            "apply_template",
             "ask_user_choice",
         }
         assert plan_tool_names.issubset(allowed)
@@ -51,6 +67,7 @@ def test_plan_mode_only_plan_tools(self, mgr):
 # Memory Awareness Caching
 # ===========================================================================
 
+
 class TestMemoryCaching:
     """PromptManager caches memory awareness with TTL."""
 
@@ -65,7 +82,7 @@ def test_caches_result(self):
         mgr.memory = memory
 
         result1 = mgr.get_cached_memory_awareness()
-        result2 = mgr.get_cached_memory_awareness()
+        mgr.get_cached_memory_awareness()
         assert result1 == "I know things"
         # Should only call once (cached)
         assert memory.get_awareness_summary.call_count == 1
@@ -86,34 +103,43 @@ def test_invalidate_cache(self):
 # Context Data Gathering
 # ===========================================================================
 
+
 class TestContextDataGathering:
     """PromptManager gathers raw context for summarization."""
 
     def test_empty_context(self):
         mgr = PromptManager(claude_client=MagicMock(), model="test")
         from gently.harness.state import ExperimentState
+
         exp = ExperimentState()
         data = mgr.gather_context_data(exp, None, None)
-        assert data['timelapse_status'] is None
-        assert data['recent_events'] == []
-        assert data['recent_detections'] == []
+        assert data["timelapse_status"] is None
+        assert data["recent_events"] == []
+        assert data["recent_detections"] == []
 
     def test_with_detections(self):
         mgr = PromptManager(claude_client=MagicMock(), model="test")
         from gently.harness.state import ExperimentState
+
         exp = ExperimentState()
         exp.add_embryo("e1")
-        exp.embryos["e1"].add_detection_result("comma", {
-            "timepoint": 50, "detected": True, "confidence": "HIGH",
-            "reasoning": "Clear comma shape",
-        })
+        exp.embryos["e1"].add_detection_result(
+            "comma",
+            {
+                "timepoint": 50,
+                "detected": True,
+                "confidence": "HIGH",
+                "reasoning": "Clear comma shape",
+            },
+        )
         data = mgr.gather_context_data(exp, None, None)
-        assert len(data['recent_detections']) == 1
-        assert data['recent_detections'][0]['detector'] == 'comma'
+        assert len(data["recent_detections"]) == 1
+        assert data["recent_detections"][0]["detector"] == "comma"
 
     def test_with_timelapse(self):
         mgr = PromptManager(claude_client=MagicMock(), model="test")
         from gently.harness.state import ExperimentState
+
         exp = ExperimentState()
 
         # Mock timelapse orchestrator
@@ -126,14 +152,15 @@ def test_with_timelapse(self):
         mock_orch.get_status.return_value = status
 
         data = mgr.gather_context_data(exp, mock_orch, None)
-        assert data['timelapse_status'] is not None
-        assert data['timelapse_status']['state'] == 'running'
+        assert data["timelapse_status"] is not None
+        assert data["timelapse_status"]["state"] == "running"
 
 
 # ===========================================================================
 # Prompt Caching Format
 # ===========================================================================
 
+
 class TestPromptCaching:
     """get_cached_system_prompt formats for Anthropic prompt caching."""
 
diff --git a/tests/test_session_manager.py b/tests/test_session_manager.py
index 02c4f169..acc19ad2 100644
--- a/tests/test_session_manager.py
+++ b/tests/test_session_manager.py
@@ -2,16 +2,15 @@
 Tests for SessionManager: message serialization, sanitization, and session lifecycle.
 """
 
-import pytest
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 from gently.harness.session.manager import SessionManager
 
-
 # ===========================================================================
 # Message Sanitization
 # ===========================================================================
 
+
 class TestSanitizeMessages:
     """sanitize_loaded_messages cleans conversation history from JSON snapshots."""
 
@@ -22,28 +21,43 @@ def test_valid_string_content(self):
         assert result[0]["content"] == "hello"
 
     def test_valid_dict_blocks(self):
-        msgs = [{"role": "assistant", "content": [
-            {"type": "text", "text": "hi"},
-        ]}]
+        msgs = [
+            {
+                "role": "assistant",
+                "content": [
+                    {"type": "text", "text": "hi"},
+                ],
+            }
+        ]
         result = SessionManager.sanitize_loaded_messages(msgs)
         assert len(result) == 1
         assert result[0]["content"][0]["type"] == "text"
 
     def test_filters_textblock_repr_strings(self):
         """Old snapshots may have serialized TextBlock repr strings."""
-        msgs = [{"role": "assistant", "content": [
-            "TextBlock(text='hello', type='text')",
-            {"type": "text", "text": "valid"},
-        ]}]
+        msgs = [
+            {
+                "role": "assistant",
+                "content": [
+                    "TextBlock(text='hello', type='text')",
+                    {"type": "text", "text": "valid"},
+                ],
+            }
+        ]
         result = SessionManager.sanitize_loaded_messages(msgs)
         assert len(result) == 1
         assert len(result[0]["content"]) == 1
         assert result[0]["content"][0]["type"] == "text"
 
     def test_filters_tooluseblock_repr(self):
-        msgs = [{"role": "assistant", "content": [
-            "ToolUseBlock(id='x', name='y', input={})",
-        ]}]
+        msgs = [
+            {
+                "role": "assistant",
+                "content": [
+                    "ToolUseBlock(id='x', name='y', input={})",
+                ],
+            }
+        ]
         result = SessionManager.sanitize_loaded_messages(msgs)
         assert len(result) == 0  # No valid blocks left
 
@@ -62,6 +76,7 @@ def test_empty_list_content(self):
 # Message Serialization
 # ===========================================================================
 
+
 class TestSerializeMessages:
     """serialize_messages converts SDK objects to plain dicts."""
 
@@ -71,14 +86,20 @@ def test_dict_passthrough(self):
         assert result == msgs
 
     def test_list_of_dict_blocks(self):
-        msgs = [{"role": "assistant", "content": [
-            {"type": "text", "text": "response"},
-        ]}]
+        msgs = [
+            {
+                "role": "assistant",
+                "content": [
+                    {"type": "text", "text": "response"},
+                ],
+            }
+        ]
         result = SessionManager.serialize_messages(msgs)
         assert result[0]["content"][0] == {"type": "text", "text": "response"}
 
     def test_model_dump_objects(self):
         """Objects with model_dump() (Pydantic) should be converted."""
+
         class FakeBlock:
             def model_dump(self):
                 return {"type": "text", "text": "from pydantic"}
@@ -89,6 +110,7 @@ def model_dump(self):
 
     def test_typed_objects_without_model_dump(self):
         """Objects with .type/.text attrs should be converted."""
+
         class FakeTextBlock:
             type = "text"
             text = "hello"
@@ -115,6 +137,7 @@ class FakeToolUse:
 # Session Lifecycle
 # ===========================================================================
 
+
 class TestSessionLifecycle:
     """SessionManager create/save/list operations."""
 
diff --git a/tests/test_stages.py b/tests/test_stages.py
index 90c65d5d..0beec457 100644
--- a/tests/test_stages.py
+++ b/tests/test_stages.py
@@ -15,9 +15,9 @@
 import pytest
 
 from gently.organisms.celegans.stages import (
-    DevelopmentalStage,
-    STAGES,
     STAGE_CRITERIA,
+    STAGES,
+    DevelopmentalStage,
     get_adjacent_stages,
 )
 
@@ -26,8 +26,14 @@ class TestOrderedValues:
     def test_ordered_values(self):
         vals = DevelopmentalStage.ordered_values()
         assert vals == [
-            "early", "bean", "comma", "1.5fold",
-            "2fold", "pretzel", "hatching", "hatched",
+            "early",
+            "bean",
+            "comma",
+            "1.5fold",
+            "2fold",
+            "pretzel",
+            "hatching",
+            "hatched",
         ]
 
     def test_stages_global_matches(self):
diff --git a/tests/test_text_tool_call_extraction.py b/tests/test_text_tool_call_extraction.py
index 801cb8b5..b79c2fc2 100644
--- a/tests/test_text_tool_call_extraction.py
+++ b/tests/test_text_tool_call_extraction.py
@@ -1,6 +1,7 @@
 """Tests for _extract_text_tool_calls fallback parser."""
 
 import json
+
 from gently.harness.conversation import _extract_text_tool_calls
 
 
@@ -12,13 +13,15 @@ def test_no_tool_calls(self):
         assert calls == []
 
     def test_single_tool_call_with_arguments(self):
-        tc = json.dumps({
-            "name": "ask_user_choice",
-            "arguments": {
-                "question": "What next?",
-                "options": [{"id": "a", "label": "Option A"}],
-            },
-        })
+        tc = json.dumps(
+            {
+                "name": "ask_user_choice",
+                "arguments": {
+                    "question": "What next?",
+                    "options": [{"id": "a", "label": "Option A"}],
+                },
+            }
+        )
         text = f"Hey there!\n\n<tool_call>\n{tc}\n</tool_call>"
         cleaned, calls = _extract_text_tool_calls(text)
         assert "<tool_call>" not in cleaned
@@ -27,10 +30,12 @@ def test_single_tool_call_with_arguments(self):
         assert calls[0]["input"]["question"] == "What next?"
 
     def test_single_tool_call_with_input_key(self):
-        tc = json.dumps({
-            "name": "get_status",
-            "input": {"embryo_id": "embryo_1"},
-        })
+        tc = json.dumps(
+            {
+                "name": "get_status",
+                "input": {"embryo_id": "embryo_1"},
+            }
+        )
         text = f"Checking...\n<tool_call>{tc}</tool_call>"
         cleaned, calls = _extract_text_tool_calls(text)
         assert len(calls) == 1
diff --git a/tests/test_tool_helpers.py b/tests/test_tool_helpers.py
index 1d5da932..a0647b88 100644
--- a/tests/test_tool_helpers.py
+++ b/tests/test_tool_helpers.py
@@ -4,25 +4,25 @@
 from unittest.mock import MagicMock
 
 from gently.harness.tools.helpers import (
+    build_snapshot_metadata,
+    format_duration,
+    get_embryo_or_error,
+    get_timestamp_string,
     require_agent,
-    require_microscope,
-    require_interaction_logger,
+    require_databroker,
     require_developmental_tracker,
+    require_interaction_logger,
+    require_microscope,
     require_timelapse_orchestrator,
-    require_databroker,
-    get_embryo_or_error,
-    get_timestamp_string,
-    format_duration,
-    build_snapshot_metadata,
 )
 
-
 # ── Context extractors ──────────────────────────────────────────────
 
+
 class TestRequireAgent:
     def test_returns_agent_when_present(self):
         agent = MagicMock()
-        result, err = require_agent({'agent': agent})
+        result, err = require_agent({"agent": agent})
         assert result is agent
         assert err is None
 
@@ -32,7 +32,7 @@ def test_returns_error_when_missing(self):
         assert "No agent" in err
 
     def test_returns_error_when_none(self):
-        result, err = require_agent({'agent': None})
+        result, err = require_agent({"agent": None})
         assert result is None
         assert err is not None
 
@@ -40,7 +40,7 @@ def test_returns_error_when_none(self):
 class TestRequireMicroscope:
     def test_returns_client_when_present(self):
         client = MagicMock()
-        result, err = require_microscope({'client': client})
+        result, err = require_microscope({"client": client})
         assert result is client
         assert err is None
 
@@ -136,11 +136,12 @@ def test_returns_error_when_not_found(self):
 
 # ── Utility functions ────────────────────────────────────────────────
 
+
 class TestGetTimestampString:
     def test_format(self):
         ts = get_timestamp_string()
         assert len(ts) == 15  # YYYYMMDD_HHMMSS
-        assert ts[8] == '_'
+        assert ts[8] == "_"
 
 
 class TestFormatDuration:
@@ -165,6 +166,7 @@ def test_zero(self):
 
 # ── build_snapshot_metadata ──────────────────────────────────────────
 
+
 class TestBuildSnapshotMetadata:
     def test_basic_fields(self):
         meta = build_snapshot_metadata(
@@ -289,6 +291,7 @@ def test_custom_optics(self):
     def test_metadata_is_json_serializable(self):
         """Metadata must round-trip through JSON for DB storage."""
         import json
+
         emb = MagicMock()
         emb.stage_position = {"x": 1000.0, "y": 500.0}
         emb.nickname = "test"
diff --git a/tests/test_tool_registry.py b/tests/test_tool_registry.py
index 273361bb..7b1b573b 100644
--- a/tests/test_tool_registry.py
+++ b/tests/test_tool_registry.py
@@ -13,16 +13,11 @@
 - Execution of non-existent tool
 """
 
-import asyncio
-
 import pytest
 
 from gently.harness.tools.registry import (
-    ToolRegistry,
     ToolCategory,
-    ToolParameter,
-    _python_type_to_json_schema,
-    _extract_parameters_from_function,
+    ToolRegistry,
 )
 
 
@@ -36,6 +31,7 @@ def registry():
 # Registration
 # =========================================================================
 
+
 class TestRegistration:
     def test_register_and_get(self, registry):
         def my_tool(x: int) -> str:
@@ -49,7 +45,9 @@ def my_tool(x: int) -> str:
         assert tool.description == "test tool"
 
     def test_register_with_decorator(self, registry):
-        @registry.register(name="deco_tool", description="decorated", category=ToolCategory.ANALYSIS)
+        @registry.register(
+            name="deco_tool", description="decorated", category=ToolCategory.ANALYSIS
+        )
         async def deco_tool(value: float) -> str:
             return f"result: {value}"
 
@@ -78,6 +76,7 @@ def test_unregister_nonexistent(self, registry):
 # Schema generation
 # =========================================================================
 
+
 class TestSchemaGeneration:
     def test_schema_generation_from_type_hints(self, registry):
         def typed_tool(name: str, count: int, ratio: float, flag: bool) -> str:
@@ -122,6 +121,7 @@ def mixed_tool(required_param: str, optional_param: int = 10) -> str:
 # Filtering
 # =========================================================================
 
+
 class TestFiltering:
     def test_list_by_category(self, registry):
         def tool_a():
@@ -168,6 +168,7 @@ def hw_tool():
 # Execution
 # =========================================================================
 
+
 class TestExecution:
     @pytest.mark.asyncio
     async def test_execute_sync_tool(self, registry):
diff --git a/tests/test_transfer_protocol.py b/tests/test_transfer_protocol.py
index 73e51706..fc395c60 100644
--- a/tests/test_transfer_protocol.py
+++ b/tests/test_transfer_protocol.py
@@ -4,13 +4,10 @@
 
 import asyncio
 import hashlib
-from pathlib import Path
 
 import pytest
 
 from gently.mesh.transfer.protocol import (
-    HEADER_LENGTH_FORMAT,
-    HEADER_LENGTH_SIZE,
     receive_file,
     send_file,
 )
@@ -53,7 +50,8 @@ async def server_handler(reader, writer):
         try:
             reader, writer = await asyncio.open_connection("127.0.0.1", port)
             success, sha256_sent = await send_file(
-                writer, sample_file,
+                writer,
+                sample_file,
                 transfer_id="test-001",
                 auth_token="tok123",
                 chunk_size=1024,
@@ -104,7 +102,10 @@ async def handler(reader, writer):
         try:
             reader, writer = await asyncio.open_connection("127.0.0.1", port)
             ok, sha = await send_file(
-                writer, small_file, transfer_id="tiny-01", chunk_size=4096,
+                writer,
+                small_file,
+                transfer_id="tiny-01",
+                chunk_size=4096,
             )
             writer.close()
             await writer.wait_closed()
@@ -137,7 +138,10 @@ async def handler(reader, writer):
         try:
             reader, writer = await asyncio.open_connection("127.0.0.1", port)
             ok, _ = await send_file(
-                writer, large_file, transfer_id="large-01", chunk_size=4096,
+                writer,
+                large_file,
+                transfer_id="large-01",
+                chunk_size=4096,
             )
             writer.close()
             await writer.wait_closed()
@@ -178,8 +182,11 @@ async def handler(reader, writer):
         try:
             reader, writer = await asyncio.open_connection("127.0.0.1", port)
             await send_file(
-                writer, sample_file, transfer_id="hdr-test",
-                auth_token="mytoken", chunk_size=4096,
+                writer,
+                sample_file,
+                transfer_id="hdr-test",
+                auth_token="mytoken",
+                chunk_size=4096,
             )
             writer.close()
             await writer.wait_closed()
diff --git a/tests/test_transfer_service.py b/tests/test_transfer_service.py
index 59a743e1..dca6f226 100644
--- a/tests/test_transfer_service.py
+++ b/tests/test_transfer_service.py
@@ -2,11 +2,7 @@
 Tests for TransferService + TransferTracker.
 """
 
-import asyncio
-import json
 import time
-from pathlib import Path
-from unittest.mock import MagicMock
 
 import pytest
 
@@ -38,7 +34,9 @@ def test_update_job(self, config_dir):
             status=TransferStatus.PENDING.value,
         )
         tracker.add_job(job)
-        tracker.update_job("job-2", status=TransferStatus.TRANSFERRING.value, bytes_transferred=1024)
+        tracker.update_job(
+            "job-2", status=TransferStatus.TRANSFERRING.value, bytes_transferred=1024
+        )
         updated = tracker.get_job("job-2")
         assert updated.status == TransferStatus.TRANSFERRING.value
         assert updated.bytes_transferred == 1024
@@ -46,10 +44,14 @@ def test_update_job(self, config_dir):
     def test_list_jobs(self, config_dir):
         tracker = TransferTracker(config_dir)
         for i in range(3):
-            tracker.add_job(TransferJob(
-                id=f"job-{i}",
-                status=TransferStatus.PENDING.value if i < 2 else TransferStatus.COMPLETED.value,
-            ))
+            tracker.add_job(
+                TransferJob(
+                    id=f"job-{i}",
+                    status=TransferStatus.PENDING.value
+                    if i < 2
+                    else TransferStatus.COMPLETED.value,
+                )
+            )
         all_jobs = tracker.list_jobs()
         assert len(all_jobs) == 3
         pending = tracker.list_jobs(status=TransferStatus.PENDING.value)
@@ -66,35 +68,43 @@ def test_persistence(self, config_dir):
     def test_get_resumable(self, config_dir):
         tracker = TransferTracker(config_dir)
         # Job in progress with partial transfer
-        tracker.add_job(TransferJob(
-            id="resume-1",
-            status=TransferStatus.TRANSFERRING.value,
-            bytes_transferred=5000,
-            total_bytes=10000,
-        ))
+        tracker.add_job(
+            TransferJob(
+                id="resume-1",
+                status=TransferStatus.TRANSFERRING.value,
+                bytes_transferred=5000,
+                total_bytes=10000,
+            )
+        )
         # Completed job (not resumable)
-        tracker.add_job(TransferJob(
-            id="done-1",
-            status=TransferStatus.COMPLETED.value,
-            bytes_transferred=10000,
-            total_bytes=10000,
-        ))
+        tracker.add_job(
+            TransferJob(
+                id="done-1",
+                status=TransferStatus.COMPLETED.value,
+                bytes_transferred=10000,
+                total_bytes=10000,
+            )
+        )
         resumable = tracker.get_resumable()
         assert len(resumable) == 1
         assert resumable[0].id == "resume-1"
 
     def test_cleanup_completed(self, config_dir):
         tracker = TransferTracker(config_dir)
-        tracker.add_job(TransferJob(
-            id="old-1",
-            status=TransferStatus.COMPLETED.value,
-            completed_at=time.time() - 100000,  # very old
-        ))
-        tracker.add_job(TransferJob(
-            id="recent-1",
-            status=TransferStatus.COMPLETED.value,
-            completed_at=time.time(),
-        ))
+        tracker.add_job(
+            TransferJob(
+                id="old-1",
+                status=TransferStatus.COMPLETED.value,
+                completed_at=time.time() - 100000,  # very old
+            )
+        )
+        tracker.add_job(
+            TransferJob(
+                id="recent-1",
+                status=TransferStatus.COMPLETED.value,
+                completed_at=time.time(),
+            )
+        )
         tracker.cleanup_completed(max_age_hours=1.0)
         assert tracker.get_job("old-1") is None
         assert tracker.get_job("recent-1") is not None
@@ -110,6 +120,7 @@ class TestTransferServiceLifecycle:
     @pytest.mark.asyncio
     async def test_start_and_stop(self, tmp_path):
         from gently.mesh.transfer.server import TransferService
+
         dest = tmp_path / "received"
         dest.mkdir()
         svc = TransferService(dest_dir=dest, port=0)
@@ -122,6 +133,7 @@ async def test_start_and_stop(self, tmp_path):
     @pytest.mark.asyncio
     async def test_active_transfer_count(self, tmp_path):
         from gently.mesh.transfer.server import TransferService
+
         dest = tmp_path / "received"
         dest.mkdir()
         svc = TransferService(dest_dir=dest, port=0)
diff --git a/tests/test_verse_map.py b/tests/test_verse_map.py
index 86ad6f62..9b5a8e8c 100644
--- a/tests/test_verse_map.py
+++ b/tests/test_verse_map.py
@@ -2,17 +2,12 @@
 Tests for VerseMap — persistent topology map.
 """
 
-import json
-import time
 import pytest
 
 from gently.mesh.models import (
     DatasetAdvertisement,
-    GpuInfo,
     PeerCapability,
     PeerInfo,
-    PeerStatus,
-    PersistedPeer,
 )
 from gently.mesh.verse_map import VerseMap
 
@@ -22,8 +17,15 @@ def verse_map(config_dir):
     return VerseMap(config_dir)
 
 
-def _make_peer(instance_id="p1", hostname="lab-pc", ip="192.168.1.10",
-               has_gpu=False, has_microscope=False, roles=None, datasets=None):
+def _make_peer(
+    instance_id="p1",
+    hostname="lab-pc",
+    ip="192.168.1.10",
+    has_gpu=False,
+    has_microscope=False,
+    roles=None,
+    datasets=None,
+):
     caps = PeerCapability(
         has_gpu=has_gpu,
         has_microscope=has_microscope,
@@ -101,8 +103,7 @@ def test_update_capabilities(self, verse_map):
         verse_map.on_peer_discovered(peer)
 
         # Update with GPU capabilities
-        peer.capabilities = PeerCapability(has_gpu=True, gpu_name="A5000",
-                                            roles=["ml_trainer"])
+        peer.capabilities = PeerCapability(has_gpu=True, gpu_name="A5000", roles=["ml_trainer"])
         verse_map.on_peer_updated(peer)
 
         pp = verse_map.get_peer("p1")
@@ -145,9 +146,7 @@ def test_find_microscope_peers(self, verse_map):
 
     def test_find_data_peers_by_session(self, verse_map):
         ds = DatasetAdvertisement(session_id="s1", embryo_count=10)
-        verse_map.on_peer_discovered(
-            _make_peer("p1", datasets=[ds])
-        )
+        verse_map.on_peer_discovered(_make_peer("p1", datasets=[ds]))
         verse_map.on_peer_discovered(_make_peer("p2"))
 
         # Find peers with session s1
@@ -160,9 +159,7 @@ def test_find_data_peers_by_session(self, verse_map):
         assert len(found_all) == 1
 
     def test_find_resource_by_role(self, verse_map):
-        verse_map.on_peer_discovered(
-            _make_peer("p1", roles=["ml_trainer"])
-        )
+        verse_map.on_peer_discovered(_make_peer("p1", roles=["ml_trainer"]))
         verse_map.on_peer_discovered(_make_peer("p2"))
 
         found = verse_map.find_resource("ml_trainer")
diff --git a/tests/validate_recursive_autofocus.py b/tests/validate_recursive_autofocus.py
index 113e524e..3fd2d088 100644
--- a/tests/validate_recursive_autofocus.py
+++ b/tests/validate_recursive_autofocus.py
@@ -7,11 +7,13 @@
 Tests the plan structure and parameter handling without requiring real hardware.
 """
 
-import sys
 import logging
-from unittest.mock import Mock, MagicMock
+import sys
+from unittest.mock import Mock
+
 import numpy as np
 
+
 # Mock pymmcore for testing without hardware
 class MockPyMMCore:
     class CMMCore:
@@ -33,15 +35,16 @@ def getImage(self):
             # Return mock image data
             return np.random.randint(0, 1000, (100, 100), dtype=np.uint16)
 
+
 # Install mock
-if 'pymmcore' not in sys.modules:
-    sys.modules['pymmcore'] = MockPyMMCore()
+if "pymmcore" not in sys.modules:
+    sys.modules["pymmcore"] = MockPyMMCore()
 
 # Import after mocking
-from gently.hardware.dispim.devices import DiSPIMCamera, DiSPIMZstage
-from gently.hardware.dispim.plans.acquisition import recursive_focus_single_round
-from bluesky import RunEngine
-import bluesky.plan_stubs as bps
+from bluesky import RunEngine  # noqa: E402
+
+from gently.hardware.dispim.devices import DiSPIMCamera, DiSPIMZstage  # noqa: E402
+from gently.hardware.dispim.plans.acquisition import recursive_focus_single_round  # noqa: E402
 
 
 def test_device_limits():
@@ -60,7 +63,7 @@ def test_device_limits():
 
     for pos in test_positions:
         try:
-            status = z_stage.set(pos)
+            z_stage.set(pos)
             print(f"✓ Position {pos} handled successfully")
         except ValueError as e:
             print(f"✗ Position {pos} failed: {e}")
@@ -91,26 +94,27 @@ def test_recursive_autofocus_plan():
     coarse_steps = 5  # Fewer steps for quick test
     fine_steps = 7
 
-    print(f"Testing with:")
-    print(f"  Coarse range: ±{coarse_range/2} μm ({coarse_steps} steps)")
-    print(f"  Fine range: ±{fine_range/2} μm ({fine_steps} steps)")
+    print("Testing with:")
+    print(f"  Coarse range: ±{coarse_range / 2} μm ({coarse_steps} steps)")
+    print(f"  Fine range: ±{fine_range / 2} μm ({fine_steps} steps)")
     print(f"  Starting position: {mock_core.current_position} μm")
     print()
 
     try:
         # Run the recursive autofocus plan
         plan = recursive_focus_single_round(
-            z_stage, camera,
+            z_stage,
+            camera,
             coarse_range=coarse_range,
             fine_range=fine_range,
             coarse_steps=coarse_steps,
-            fine_steps=fine_steps
+            fine_steps=fine_steps,
         )
 
         # Execute plan
-        result = RE(plan)
+        RE(plan)
 
-        print(f"✓ Recursive autofocus plan executed successfully")
+        print("✓ Recursive autofocus plan executed successfully")
         print(f"Final position: {mock_core.current_position:.2f} μm")
 
         # Verify position is within limits
@@ -122,6 +126,7 @@ def test_recursive_autofocus_plan():
     except Exception as e:
         print(f"✗ Recursive autofocus plan failed: {e}")
         import traceback
+
         traceback.print_exc()
 
     print()
@@ -146,7 +151,7 @@ def test_position_bounds():
 
     for pos, description, should_pass in test_cases:
         try:
-            status = z_stage.set(pos)
+            z_stage.set(pos)
             if should_pass:
                 print(f"✓ {description} ({pos}): Accepted")
             else:
@@ -193,4 +198,4 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
\ No newline at end of file
+    main()

From f89562585ac61ff1b99b68d5220c2eeeb776b499 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 22:12:04 +0100
Subject: [PATCH 076/314] Add incremental mypy config, CI, and pre-commit
 wiring (#46)

Adds a lenient [tool.mypy] config with an explicit ignore_errors
override list for the 113 modules that don't yet pass, runs mypy in
the lint CI job and as a pre-commit hook, and adds mypy to the dev
dependency group. New code is held to the standard; the override
list shrinks as modules are cleaned up.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .github/workflows/lint.yml |   6 ++
 .pre-commit-config.yaml    |   7 ++
 pyproject.toml             | 129 +++++++++++++++++++++++++++++++++++++
 3 files changed, 142 insertions(+)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 5a92ceac..58d2538e 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -24,3 +24,9 @@ jobs:
 
       - name: ruff format check
         run: ruff format --check .
+
+      - name: Install mypy
+        run: pip install mypy
+
+      - name: mypy
+        run: mypy .
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7b184093..7f6f8bdf 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -5,3 +5,10 @@ repos:
       - id: ruff
         args: [--fix]
       - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v2.1.0  # run `pre-commit autoupdate` to pin to latest
+    hooks:
+      - id: mypy
+        pass_filenames: false
+        args: ["."]
diff --git a/pyproject.toml b/pyproject.toml
index 003ae9e3..82cc2dcf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -94,6 +94,7 @@ dev = [
     "pytest-asyncio>=0.21.0",
     "ruff>=0.4.0",
     "pre-commit>=3.7.0",
+    "mypy>=1.8.0",
 ]
 
 [project.scripts]
@@ -145,3 +146,131 @@ target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B"]
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true
+explicit_package_bases = true
+mypy_path = "."
+
+# Modules with pre-existing mypy errors, exempted while the codebase is
+# incrementally annotated (see issue #46). New modules should not be added
+# here; PRs that substantively touch a listed module should fix its errors
+# and remove it from this list as part of that change.
+[[tool.mypy.overrides]]
+module = [
+    "benchmarks.perception.live_viewer",
+    "benchmarks.perception.metrics",
+    "benchmarks.perception.testset",
+    "diagnostics.benchmark_gentlystore_fps",
+    "diagnostics.benchmark_volume_fps",
+    "diagnostics.plot_benchmark_results",
+    "diagnostics.switchbot_webgui",
+    "examples.example_dispim_workflows",
+    "gently",
+    "gently.agent",
+    "gently.analysis.core",
+    "gently.analysis.steps",
+    "gently.app.agent",
+    "gently.app.benchmark",
+    "gently.app.calibration.edge_roi",
+    "gently.app.detectors.dopaminergic_signal",
+    "gently.app.orchestration.timelapse",
+    "gently.app.tools.acquisition_tools",
+    "gently.app.tools.analysis_tools",
+    "gently.app.tools.calibration_tools",
+    "gently.app.tools.detection_tools",
+    "gently.app.tools.experiment_tools",
+    "gently.app.tools.focus_tools",
+    "gently.app.tools.interaction_tools",
+    "gently.app.tools.led_tools",
+    "gently.app.tools.light_source_tools",
+    "gently.app.tools.memory_tools",
+    "gently.app.tools.plan_execution_tools",
+    "gently.app.tools.resolution_tools",
+    "gently.app.tools.session_tools",
+    "gently.app.tools.stage_tools",
+    "gently.app.tools.temperature_tools",
+    "gently.app.tools.timelapse_tools",
+    "gently.app.tools.volume_tools",
+    "gently.app.video_maker",
+    "gently.core.coordinates",
+    "gently.core.event_bus",
+    "gently.core.file_store",
+    "gently.core.imaging",
+    "gently.core.service",
+    "gently.core.store",
+    "gently.dataset.aggregator",
+    "gently.dataset.embryo_dataset",
+    "gently.dataset.explorer_server",
+    "gently.detection",
+    "gently.eval.decision_log",
+    "gently.eval.event_capture",
+    "gently.gently",
+    "gently.hardware.dispim.client",
+    "gently.hardware.dispim.device_factory",
+    "gently.hardware.dispim.device_layer",
+    "gently.hardware.dispim.devices.acquisition",
+    "gently.hardware.dispim.devices.camera",
+    "gently.hardware.dispim.devices.optical",
+    "gently.hardware.dispim.devices.scanner",
+    "gently.hardware.dispim.devices.test_temperature_controller",
+    "gently.hardware.dispim.plans.acquisition",
+    "gently.hardware.dispim.sam_detection",
+    "gently.hardware.switchbot",
+    "gently.harness.conversation",
+    "gently.harness.detection.detector",
+    "gently.harness.detection.queue",
+    "gently.harness.detection.verifier",
+    "gently.harness.memory",
+    "gently.harness.memory.file_store",
+    "gently.harness.memory.gap_assessment",
+    "gently.harness.memory._intentions",
+    "gently.harness.memory.interface",
+    "gently.harness.memory._ml_pipelines",
+    "gently.harness.memory.onboarding",
+    "gently.harness.memory._plans",
+    "gently.harness.memory.startup_wizard",
+    "gently.harness.memory._understanding",
+    "gently.harness.microscope",
+    "gently.harness.plan_mode.tools.lab_context",
+    "gently.harness.plan_mode.tools.planning",
+    "gently.harness.plan_mode.tools.research",
+    "gently.harness.plan_mode.tools.templates",
+    "gently.harness.plan_mode.tools.validation",
+    "gently.harness.prompts.manager",
+    "gently.harness.prompts.templates",
+    "gently.harness.session.interaction_logger",
+    "gently.harness.session.manager",
+    "gently.harness.session.timeline",
+    "gently.harness.state",
+    "gently.harness.tools.registry",
+    "gently.log_config",
+    "gently.mesh.capability_provider",
+    "gently.mesh.discovery",
+    "gently.mesh.peer_client",
+    "gently.mesh.verse_map",
+    "gently.ml.data_loader",
+    "gently.ml.federated",
+    "gently.organisms.celegans.developmental_tracker",
+    "gently.ui.web.connection_manager",
+    "gently.ui.web.routes.agent_ws",
+    "gently.ui.web.routes.campaigns",
+    "gently.ui.web.routes.data",
+    "gently.ui.web.routes.volumes",
+    "gently.ui.web.routes.websocket",
+    "gently.ui.web.server",
+    "gently.ui.web.strategy_snapshot",
+    "launch_gently",
+    "scripts.auto_label_examples",
+    "scripts.extract_stage_examples",
+    "scripts.gemini_stage_test",
+    "scripts.launch_viz_server",
+    "scripts.projection_explorer",
+    "scripts.replay_session",
+    "scripts.stage_annotator",
+    "tests.test_campaign_coordination",
+    "tests.test_text_tool_call_extraction",
+    "tests.validate_recursive_autofocus",
+]
+ignore_errors = true

From baeaa4b9fd8080c753463d733a5ae250c78b2f0e Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 22:12:11 +0100
Subject: [PATCH 077/314] Document incremental mypy typing policy in
 CONTRIBUTING.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CONTRIBUTING.md | 35 ++++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7e75550a..b936732d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -2,14 +2,13 @@
 
 ## Code quality toolchain
 
-This project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting, and [pre-commit](https://pre-commit.com/) to enforce this automatically before every commit.
-
-> **Note:** Type checking with mypy is not yet enforced. See the tracking issue for gradually
-> introducing mypy across the codebase.
+This project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting, and
+[mypy](https://mypy-lang.org/) for type checking, enforced automatically before every
+commit via [pre-commit](https://pre-commit.com/).
 
 ### First-time setup
 
-Install the dev dependencies (includes ruff and pre-commit):
+Install the dev dependencies (includes ruff, mypy, and pre-commit):
 
 ```bash
 uv sync
@@ -21,7 +20,8 @@ Then install the pre-commit hooks:
 pre-commit install
 ```
 
-From this point on, ruff runs automatically on staged files whenever you `git commit`.
+From this point on, ruff runs on staged files and mypy runs across the whole
+project whenever you `git commit`.
 
 ### Running manually
 
@@ -46,6 +46,27 @@ To update hook versions to their latest releases:
 pre-commit autoupdate
 ```
 
+### Type checking
+
+Run mypy the same way pre-commit and CI do:
+
+```bash
+mypy .
+```
+
+The codebase is being typed incrementally (see issue #46). Modules with
+pre-existing errors are listed in the `[[tool.mypy.overrides]]` block in
+`pyproject.toml` with `ignore_errors = true`, so `mypy .` passes today even
+though not every module is fully typed yet.
+
+Policy for working with this list:
+
+- **New modules** must pass `mypy .` cleanly — do not add them to the
+  overrides list.
+- **PRs that substantively touch a module on the overrides list** should fix
+  that module's type errors and remove it from the list as part of the
+  change.
+
 ### CI
 
-Every pull request runs the lint job (`.github/workflows/lint.yml`), which checks ruff lint and formatting across the entire project. Fix any failures locally with `pre-commit run --all-files` before pushing.
+Every pull request runs the lint job (`.github/workflows/lint.yml`), which checks ruff lint and formatting and runs mypy across the entire project. Fix any failures locally with `pre-commit run --all-files` before pushing.

From 0b4927f4dcbfafd861ddbe7392ee5731e0e00237 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 22:12:19 +0100
Subject: [PATCH 078/314] Fix mypy errors in gently/harness/bridge.py

Annotates two implicit-Optional defaults and fixes a str/Path
arg-type mismatch in create_timelapse_video. Removes the file from
the mypy override list before it's even added.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 gently/harness/bridge.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index 400cfc60..ddbfa9ca 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -718,7 +718,7 @@ async def handle_command(
         self,
         command: str,
         send_fn: Callable[[dict], Coroutine],
-        choice_futures: dict = None,
+        choice_futures: dict | None = None,
     ) -> None:
         """
         Execute a slash command and send the result.
@@ -1413,7 +1413,7 @@ async def handle_command(
                 lines = [f"Creating timelapse videos (fps={fps})..."]
                 for eid, vol_paths in all_volumes.items():
                     output_path = session_images_dir / f"{eid}_timelapse.mp4"
-                    create_timelapse_video(vol_paths, str(output_path), fps=fps)
+                    create_timelapse_video(vol_paths, output_path, fps=fps)
                     lines.append(f"  {eid}: {len(vol_paths)} frames → {output_path.name}")
 
                 await send_fn(
@@ -1654,7 +1654,7 @@ def _get_status_data(self) -> dict:
             "has_sam": client.has_sam if client else False,
         }
 
-    def _get_embryos_data(self, embryo_id: str = None) -> dict:
+    def _get_embryos_data(self, embryo_id: str | None = None) -> dict:
         """Build structured embryo data."""
         exp = self.agent.experiment
         if embryo_id:

From b4dc3b7fc6faea86a40c81edc005d1c8b3f8c6bf Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 23:00:44 +0100
Subject: [PATCH 079/314] Fix implicit-Optional parameter defaults across 45
 modules

Changes def f(x: T = None) to def f(x: T | None = None) to match
PEP 484 / mypy's no_implicit_optional, matching the pattern already
applied to bridge.py in #42. Removes 14 modules from the mypy
ignore_errors override list (113 -> 99) that are now fully clean.
---
 gently/app/agent.py                           |  10 +-
 gently/app/benchmark.py                       |   6 +-
 gently/app/orchestration/timelapse.py         |   8 +-
 gently/app/tools/acquisition_tools.py         |  12 +-
 gently/app/tools/analysis_tools.py            |   4 +-
 gently/app/tools/calibration_tools.py         |  12 +-
 gently/app/tools/detection_tools.py           |  14 +--
 gently/app/tools/focus_tools.py               |   8 +-
 gently/app/tools/interaction_tools.py         |   2 +-
 gently/app/tools/light_source_tools.py        |   4 +-
 gently/app/tools/memory_tools.py              |  16 +--
 gently/app/tools/plan_execution_tools.py      |   8 +-
 gently/app/tools/resolution_tools.py          |  18 +--
 gently/app/tools/session_tools.py             |  16 +--
 gently/app/tools/stage_tools.py               |   2 +-
 gently/app/tools/timelapse_tools.py           |  76 +++++++------
 gently/app/tools/volume_tools.py              |  14 +--
 gently/app/video_maker.py                     |   2 +-
 gently/core/coordinates.py                    |   6 +-
 gently/core/file_store.py                     |  64 +++++------
 gently/core/store.py                          |  58 +++++-----
 gently/dataset/explorer_server.py             |   4 +-
 gently/hardware/dispim/client.py              |  42 +++----
 gently/hardware/dispim/device_layer.py        |   4 +-
 gently/hardware/dispim/devices/acquisition.py |  10 +-
 gently/hardware/dispim/devices/optical.py     |   4 +-
 gently/hardware/dispim/devices/scanner.py     |   2 +-
 gently/hardware/dispim/plans/acquisition.py   |  16 +--
 gently/harness/memory/interface.py            |  12 +-
 gently/harness/microscope.py                  |   2 +-
 gently/harness/plan_mode/tools/lab_context.py |   4 +-
 gently/harness/plan_mode/tools/planning.py    | 106 +++++++++---------
 gently/harness/plan_mode/tools/research.py    |   6 +-
 gently/harness/plan_mode/tools/templates.py   |  10 +-
 gently/harness/plan_mode/tools/validation.py  |   2 +-
 gently/harness/prompts/manager.py             |   2 +-
 gently/harness/prompts/templates.py           |   6 +-
 gently/harness/state.py                       |  16 +--
 gently/harness/tools/registry.py              |   2 +-
 gently/log_config.py                          |   4 +-
 gently/mesh/verse_map.py                      |   2 +-
 gently/ui/web/connection_manager.py           |   6 +-
 gently/ui/web/server.py                       |   6 +-
 launch_gently.py                              |   2 +-
 pyproject.toml                                |  14 ---
 scripts/gemini_stage_test.py                  |   6 +-
 46 files changed, 327 insertions(+), 323 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 5122e80f..4a5f6602 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -79,7 +79,7 @@ def __init__(
         model: str = settings.models.main,
         microscope_client=None,
         session_id: str | None = None,
-        store: FileStore = None,
+        store: FileStore | None = None,
         no_api: bool = False,
     ):
         """
@@ -411,7 +411,7 @@ def enter_resolution_mode(self) -> str:
         logger.info("Entered resolution mode")
         return "Resolution mode active. Determining what this session is for."
 
-    def exit_resolution_mode(self, outcome: str = None) -> str:
+    def exit_resolution_mode(self, outcome: str | None = None) -> str:
         """Leave resolution mode for run mode.
 
         Called by resolution tools (attach_session_to_plan,
@@ -490,7 +490,7 @@ def exit_plan_mode(self) -> str:
 
     # ===== Prompt & System Prompt =====
 
-    def _update_system_prompt(self, context_summary: str = None):
+    def _update_system_prompt(self, context_summary: str | None = None):
         """Rebuild system prompt via PromptManager."""
         self.system_prompt = self.prompts.update_system_prompt(
             self.experiment,
@@ -1065,7 +1065,9 @@ async def handle_message_stream(self, user_message: str):
             if acquired:
                 lock.release()
 
-    async def run_wake_turn(self, wake_note: str, trigger: str = None, interactive: bool = False):
+    async def run_wake_turn(
+        self, wake_note: str, trigger: str | None = None, interactive: bool = False
+    ):
         """Drive one autonomous (no-user) turn for the wake-router.
 
         Runs through the normal streaming pipeline (so it acquires the turn-lock
diff --git a/gently/app/benchmark.py b/gently/app/benchmark.py
index 643e296f..9263d7fe 100644
--- a/gently/app/benchmark.py
+++ b/gently/app/benchmark.py
@@ -138,9 +138,9 @@ async def run_benchmark(
     exposure_ms: float = 10.0,
     warmup: int = 1,
     # Legacy parameters (ignored, kept for API compat with bridge)
-    n_volumes: int = None,
-    n_slices: int = None,
-    n_warmup: int = None,
+    n_volumes: int | None = None,
+    n_slices: int | None = None,
+    n_warmup: int | None = None,
     progress_fn: callable | None = None,
 ) -> BenchmarkResults:
     """
diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index 5a22eea0..5d0783e4 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -739,7 +739,7 @@ async def _run_loop(self):
                 },
             )
 
-    async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime = None):
+    async def _acquire_embryo(self, embryo_state: EmbryoState, round_time: datetime | None = None):
         """Acquire a single volume for one embryo
 
         Parameters
@@ -2510,7 +2510,7 @@ def _check_interval_rules(
                 result,
             )
 
-    def _finalize_perception_run(self, status: str = "completed", error_message: str = None):
+    def _finalize_perception_run(self, status: str = "completed", error_message: str | None = None):
         """Mark the perception run as finished in FileStore."""
         if self._store and self._perception_run_id is not None:
             try:
@@ -2575,7 +2575,7 @@ async def _run_detector(
         volume,
         embryo_state: EmbryoState,
         detector_name: str,
-        volume_uids: dict = None,
+        volume_uids: dict | None = None,
     ):
         """Run a role-declared Detector (Phase 2) and persist + emit results.
 
@@ -2791,7 +2791,7 @@ async def _run_perception(
         timepoint: int,
         volume,
         embryo_state: EmbryoState,
-        volume_uids: dict = None,
+        volume_uids: dict | None = None,
     ):
         """Run the per-role detector on the acquired volume and emit results.
 
diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index d73046c0..83a2deae 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -44,8 +44,8 @@ async def acquire_volume(
     embryo_id: str,
     num_slices: int = 50,
     exposure_ms: float = 10.0,
-    z_buffer_um: float = None,
-    context: dict = None,
+    z_buffer_um: float | None = None,
+    context: dict | None = None,
 ) -> str:
     """Acquire single volume - moves to embryo first, uses calibration"""
     agent = context.get("agent")
@@ -237,11 +237,11 @@ async def acquire_volume(
     ],
 )
 async def capture_lightsheet(
-    piezo_position: float = None,
+    piezo_position: float | None = None,
     galvo_position: float = 0.0,
-    embryo_id: str = None,
+    embryo_id: str | None = None,
     show: bool = True,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Capture and optionally display a single lightsheet image"""
     client = context.get("client")
@@ -355,7 +355,7 @@ async def capture_lightsheet(
         ToolExample("Capture all embryos", {}),
     ],
 )
-async def batch_lightsheet(galvo_position: float = 0.0, context: dict = None) -> str:
+async def batch_lightsheet(galvo_position: float = 0.0, context: dict | None = None) -> str:
     """Capture lightsheet images from all embryos and show them in the web UI"""
     agent = context.get("agent")
     client = context.get("client")
diff --git a/gently/app/tools/analysis_tools.py b/gently/app/tools/analysis_tools.py
index 6635d9cb..1e897b61 100644
--- a/gently/app/tools/analysis_tools.py
+++ b/gently/app/tools/analysis_tools.py
@@ -18,7 +18,7 @@ async def analyze_volume(
     analysis_prompt: str,
     use_recent_context: bool = False,
     timepoint: int | None = None,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Analyze embryo volume with Claude Vision"""
     agent, err = require_agent(context)
@@ -60,7 +60,7 @@ async def analyze_volume(
 def get_recent_perceptions(
     embryo_id: str | None = None,
     n: int = 5,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Read live per-embryo perception state from the perception sessions.
 
diff --git a/gently/app/tools/calibration_tools.py b/gently/app/tools/calibration_tools.py
index 2220e375..5769cee1 100644
--- a/gently/app/tools/calibration_tools.py
+++ b/gently/app/tools/calibration_tools.py
@@ -946,15 +946,15 @@ async def fast_calibrate_embryo(
 async def calibrate_embryo(
     embryo_id: str,
     skip_edge_detection: bool = False,
-    galvo_top: float = None,
-    galvo_bottom: float = None,
+    galvo_top: float | None = None,
+    galvo_bottom: float | None = None,
     edge_step: float = 0.05,
     edge_max_range: float = 0.5,
     edge_tolerance_deg: float = 0.20,
     inset_fraction: float = 0.4,
     z_buffer_um: float = 25.0,
     use_v04_plan: bool = False,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Run piezo-galvo calibration with Claude vision edge detection.
 
@@ -1396,10 +1396,10 @@ async def check_embryo_at_position(galvo_pos: float) -> bool:
     ],
 )
 async def calibrate_all_embryos(
-    embryo_ids: list[str] = None,
+    embryo_ids: list[str] | None = None,
     skip_edge_detection: bool = False,
     z_buffer_um: float = 25.0,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Calibrate all embryos sequentially with Claude vision"""
     agent = context.get("agent")
@@ -1512,7 +1512,7 @@ def apply_calibration_to_embryos(
     source_embryo_id: str,
     target_embryo_ids: list[str] | None = None,
     overwrite_existing: bool = True,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Broadcast one embryo's calibration to others.
 
diff --git a/gently/app/tools/detection_tools.py b/gently/app/tools/detection_tools.py
index 89d914d6..b821ec72 100644
--- a/gently/app/tools/detection_tools.py
+++ b/gently/app/tools/detection_tools.py
@@ -113,12 +113,12 @@ async def detect_embryos(
     auto_calibrate: bool = False,
     min_confidence: float = 0.7,
     use_claude_review: bool = False,
-    exposure_ms: float = None,
+    exposure_ms: float | None = None,
     brightness_percentile: float = 99.0,
     min_area: int = 5000,
     max_area: int = 150000,
     default_role: str = "test",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Detect embryos via SAM + edit/assign roles in the web map view."""
     agent = context.get("agent")
@@ -276,9 +276,9 @@ async def detect_embryos(
     ],
 )
 async def manual_mark_embryos(
-    exposure_ms: float = None,
+    exposure_ms: float | None = None,
     default_role: str = "test",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Manual marking via the web map view."""
     agent = context.get("agent")
@@ -415,9 +415,9 @@ async def manual_mark_embryos(
     ],
 )
 async def edit_embryos(
-    exposure_ms: float = None,
+    exposure_ms: float | None = None,
     default_role: str = "test",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Edit existing embryos via the web map view."""
     agent = context.get("agent")
@@ -450,7 +450,7 @@ async def edit_embryos(
         ToolExample("Display embryo positions", {}),
     ],
 )
-async def show_detected_embryos(save_to_file: bool = True, context: dict = None) -> str:
+async def show_detected_embryos(save_to_file: bool = True, context: dict | None = None) -> str:
     """Show detected embryos visualization using experiment.embryos as source of truth"""
     agent = context.get("agent")
     client = context.get("client")
diff --git a/gently/app/tools/focus_tools.py b/gently/app/tools/focus_tools.py
index 63f043e5..cef6ca81 100644
--- a/gently/app/tools/focus_tools.py
+++ b/gently/app/tools/focus_tools.py
@@ -57,7 +57,7 @@ async def fine_focus(
     move_to_best: bool = True,
     galvo_position: float = 0.0,
     embryo_id: str | None = None,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """
     Perform fine focus sweep to find optimal piezo position.
@@ -234,10 +234,10 @@ async def fine_focus(
     ],
 )
 async def get_focus_score(
-    piezo_position: float = None,
+    piezo_position: float | None = None,
     galvo_position: float = 0.0,
     algorithm: str = "fft_bandpass",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """
     Get focus score for current or specified position.
@@ -304,7 +304,7 @@ async def get_focus_score(
         ToolExample("Check focus history for embryo 2", {"embryo_id": "embryo_2"}),
     ],
 )
-async def get_focus_history(embryo_id: str, context: dict = None) -> str:
+async def get_focus_history(embryo_id: str, context: dict | None = None) -> str:
     """
     Get focus measurement history for an embryo.
 
diff --git a/gently/app/tools/interaction_tools.py b/gently/app/tools/interaction_tools.py
index 3e667823..cf3f6f45 100644
--- a/gently/app/tools/interaction_tools.py
+++ b/gently/app/tools/interaction_tools.py
@@ -58,7 +58,7 @@ async def ask_user_choice(
     options: list[dict[str, str]],
     allow_multiple: bool = False,
     default_id: str | None = None,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """
     Present user with selectable options.
diff --git a/gently/app/tools/light_source_tools.py b/gently/app/tools/light_source_tools.py
index 0f144082..065b981f 100644
--- a/gently/app/tools/light_source_tools.py
+++ b/gently/app/tools/light_source_tools.py
@@ -43,7 +43,7 @@
 async def set_laser_power(
     wavelength: int,
     pct: float,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Set laser power and read back the actual setpoint."""
     agent, err = require_agent(context)
@@ -87,7 +87,7 @@ async def set_laser_power(
 )
 async def get_laser_power(
     wavelength: int,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Read current laser power %."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/memory_tools.py b/gently/app/tools/memory_tools.py
index f586d087..0c0306e2 100644
--- a/gently/app/tools/memory_tools.py
+++ b/gently/app/tools/memory_tools.py
@@ -36,7 +36,7 @@ def _get_memory(context: dict):
 )
 async def recall_campaigns(
     status: str = "active",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """List campaigns filtered by status."""
     memory = _get_memory(context)
@@ -64,9 +64,9 @@ async def recall_campaigns(
     ],
 )
 async def recall_learnings(
-    query: str = None,
+    query: str | None = None,
     limit: int = 20,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Search or list learnings."""
     memory = _get_memory(context)
@@ -93,10 +93,10 @@ async def recall_learnings(
     ],
 )
 async def recall_observations(
-    query: str = None,
-    embryo_id: str = None,
+    query: str | None = None,
+    embryo_id: str | None = None,
     limit: int = 20,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Search or list observations."""
     memory = _get_memory(context)
@@ -121,8 +121,8 @@ async def recall_observations(
     ],
 )
 async def recall_context(
-    campaign_id: str = None,
-    context: dict = None,
+    campaign_id: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Full context snapshot."""
     memory = _get_memory(context)
diff --git a/gently/app/tools/plan_execution_tools.py b/gently/app/tools/plan_execution_tools.py
index 38c1cc31..f07e8af0 100644
--- a/gently/app/tools/plan_execution_tools.py
+++ b/gently/app/tools/plan_execution_tools.py
@@ -40,8 +40,8 @@
 )
 async def execute_plan_item(
     item_ref: str,
-    embryo_ids: list[str] = None,
-    context: dict = None,
+    embryo_ids: list[str] | None = None,
+    context: dict | None = None,
 ) -> str:
     """Execute a planned imaging item."""
     agent, err = require_agent(context)
@@ -198,8 +198,8 @@ async def execute_plan_item(
 )
 async def complete_current_plan_item(
     item_ref: str,
-    outcome: str = None,
-    context: dict = None,
+    outcome: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Complete a plan item and report newly unblocked items."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/resolution_tools.py b/gently/app/tools/resolution_tools.py
index 5de2a5bd..f5a6c19f 100644
--- a/gently/app/tools/resolution_tools.py
+++ b/gently/app/tools/resolution_tools.py
@@ -92,7 +92,7 @@ def _short(text: str | None, n: int = 80) -> str:
 async def attach_session_to_plan(
     plan_item_id: str,
     rationale: str = "",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Attach the current session to a plan item."""
     agent, err = require_agent(context)
@@ -160,7 +160,7 @@ async def attach_session_to_plan(
 )
 async def mark_session_standalone(
     description: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Mark the session as a standalone (non-plan) run."""
     agent, err = require_agent(context)
@@ -212,7 +212,7 @@ async def mark_session_standalone(
 )
 async def detach_session_from_plan(
     reason: str = "",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Detach the current session from its plan item."""
     agent, err = require_agent(context)
@@ -276,7 +276,7 @@ async def mark_plan_item_status(
     plan_item_id: str,
     status: str,
     notes: str = "",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Update a plan item's status."""
     agent, err = require_agent(context)
@@ -359,8 +359,8 @@ def _apply_spec_to_embryo(embryo, spec) -> list[str]:
 )
 async def apply_plan_acquisition_spec(
     plan_item_id: str,
-    overrides: dict = None,
-    context: dict = None,
+    overrides: dict | None = None,
+    context: dict | None = None,
 ) -> str:
     """Apply a plan's ImagingSpec to the experiment."""
     agent, err = require_agent(context)
@@ -512,7 +512,7 @@ class _Filtered:
 async def recall_sibling_sessions(
     identifier: str,
     limit: int = 10,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Return sessions sharing the given plan item's campaign or the campaign itself."""
     agent, err = require_agent(context)
@@ -605,7 +605,7 @@ async def recall_sibling_sessions(
 )
 async def summarize_campaign_history(
     campaign_id: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Compact campaign-progress summary for resolution-mode reasoning."""
     agent, err = require_agent(context)
@@ -665,7 +665,7 @@ async def summarize_campaign_history(
     ],
 )
 async def list_imaging_candidates(
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Full deterministic listing of unblocked imaging plan items."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/session_tools.py b/gently/app/tools/session_tools.py
index c1284442..bfe79988 100644
--- a/gently/app/tools/session_tools.py
+++ b/gently/app/tools/session_tools.py
@@ -20,7 +20,7 @@
     category=ToolCategory.ANALYSIS,
 )
 async def assess_image_quality(
-    embryo_id: str = None, suggest_parameters: bool = True, context: dict = None
+    embryo_id: str | None = None, suggest_parameters: bool = True, context: dict | None = None
 ) -> str:
     """Assess image quality and suggest improvements"""
     agent, err = require_agent(context)
@@ -143,7 +143,7 @@ async def assess_image_quality(
     ),
     category=ToolCategory.DATA,
 )
-def get_session_stats(context: dict = None) -> str:
+def get_session_stats(context: dict | None = None) -> str:
     """Get session statistics from interaction logger"""
     agent, err = require_agent(context)
     if err:
@@ -172,7 +172,9 @@ def get_session_stats(context: dict = None) -> str:
     description="Compare developmental progress across multiple embryos in the current experiment",
     category=ToolCategory.ANALYSIS,
 )
-def compare_embryo_development(embryo_ids: list[str] = None, context: dict = None) -> str:
+def compare_embryo_development(
+    embryo_ids: list[str] | None = None, context: dict | None = None
+) -> str:
     """Compare embryo development"""
     agent, err = require_agent(context)
     if err:
@@ -234,7 +236,7 @@ def compare_embryo_development(embryo_ids: list[str] = None, context: dict = Non
     ),
     category=ToolCategory.DATA,
 )
-def analyze_corrections(limit: int = 50, context: dict = None) -> str:
+def analyze_corrections(limit: int = 50, context: dict | None = None) -> str:
     """Analyze correction patterns"""
     agent, err = require_agent(context)
     if err:
@@ -294,7 +296,7 @@ def analyze_corrections(limit: int = 50, context: dict = None) -> str:
     description="Export interaction logs for external analysis",
     category=ToolCategory.DATA,
 )
-def export_interaction_log(format: str = "summary", context: dict = None) -> str:
+def export_interaction_log(format: str = "summary", context: dict | None = None) -> str:
     """Export interaction log"""
     agent, err = require_agent(context)
     if err:
@@ -359,7 +361,7 @@ def export_interaction_log(format: str = "summary", context: dict = None) -> str
     ],
 )
 def import_embryos_from_session(
-    session_id: str, clear_existing: bool = False, context: dict = None
+    session_id: str, clear_existing: bool = False, context: dict | None = None
 ) -> str:
     """
     Import embryos from another session.
@@ -415,7 +417,7 @@ def import_embryos_from_session(
         ToolExample("List recent sessions", {"limit": 5}),
     ],
 )
-def list_sessions(limit: int = 20, context: dict = None) -> str:
+def list_sessions(limit: int = 20, context: dict | None = None) -> str:
     """
     List available sessions.
 
diff --git a/gently/app/tools/stage_tools.py b/gently/app/tools/stage_tools.py
index 88a43871..39f433f3 100644
--- a/gently/app/tools/stage_tools.py
+++ b/gently/app/tools/stage_tools.py
@@ -92,7 +92,7 @@ async def get_stage_position(context: dict) -> str:
         ToolExample("Move stage to coordinates 1200, -600", {"x": 1200, "y": -600}),
     ],
 )
-async def move_stage(x: float, y: float, context: dict = None) -> str:
+async def move_stage(x: float, y: float, context: dict | None = None) -> str:
     """Move stage to arbitrary XY coordinates"""
     client = context.get("client")
 
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index de7ece90..c794b9ac 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -22,8 +22,8 @@ async def generate_bluesky_plan(
     goal: str,
     embryo_ids: list[str],
     plan_type: str = "adaptive_timelapse",
-    parameters: dict = None,
-    context: dict = None,
+    parameters: dict | None = None,
+    context: dict | None = None,
 ) -> str:
     """Generate Bluesky plan"""
     agent = context.get("agent")
@@ -58,12 +58,12 @@ async def generate_bluesky_plan(
     requires_microscope=True,
 )
 async def start_adaptive_timelapse(
-    embryo_ids: list[str] = None,
+    embryo_ids: list[str] | None = None,
     stop_condition: str = "manual",
     interval_seconds: float = 120.0,
-    condition_value: int = None,
+    condition_value: int | None = None,
     monitoring_mode: str | None = None,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Start adaptive timelapse in background"""
     agent, err = require_agent(context)
@@ -121,7 +121,7 @@ async def start_adaptive_timelapse(
     description="Get current status of the running timelapse including per-embryo progress",
     category=ToolCategory.EXPERIMENT,
 )
-def get_timelapse_status(context: dict = None) -> str:
+def get_timelapse_status(context: dict | None = None) -> str:
     """Get timelapse status"""
     agent, err = require_agent(context)
     if err:
@@ -176,9 +176,9 @@ def get_timelapse_status(context: dict = None) -> str:
 )
 async def modify_timelapse_embryo(
     embryo_id: str,
-    stop_condition: str = None,
-    condition_value: int = None,
-    context: dict = None,
+    stop_condition: str | None = None,
+    condition_value: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Modify embryo parameters during timelapse (stop condition only - interval is global)"""
     agent, err = require_agent(context)
@@ -211,9 +211,9 @@ async def modify_timelapse_embryo(
 )
 async def add_embryo_to_timelapse(
     embryo_id: str,
-    stop_condition: str = None,
-    condition_value: int = None,
-    context: dict = None,
+    stop_condition: str | None = None,
+    condition_value: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Add an embryo to a running timelapse (uses global interval)"""
     agent, err = require_agent(context)
@@ -242,7 +242,7 @@ async def add_embryo_to_timelapse(
     requires_microscope=True,
 )
 async def stop_timelapse_embryo(
-    embryo_id: str, reason: str = "user_request", context: dict = None
+    embryo_id: str, reason: str = "user_request", context: dict | None = None
 ) -> str:
     """Stop imaging a specific embryo"""
     agent, err = require_agent(context)
@@ -266,7 +266,7 @@ async def stop_timelapse_embryo(
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def stop_timelapse(reason: str = "user_request", context: dict = None) -> str:
+async def stop_timelapse(reason: str = "user_request", context: dict | None = None) -> str:
     """Stop entire timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -289,7 +289,7 @@ async def stop_timelapse(reason: str = "user_request", context: dict = None) ->
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def pause_timelapse(context: dict = None) -> str:
+async def pause_timelapse(context: dict | None = None) -> str:
     """Pause timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -312,7 +312,7 @@ async def pause_timelapse(context: dict = None) -> str:
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def resume_timelapse(context: dict = None) -> str:
+async def resume_timelapse(context: dict | None = None) -> str:
     """Resume timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -337,7 +337,7 @@ async def resume_timelapse(context: dict = None) -> str:
     ),
     category=ToolCategory.EXPERIMENT,
 )
-def add_stop_condition(embryo_id: str, condition: str, context: dict = None) -> str:
+def add_stop_condition(embryo_id: str, condition: str, context: dict | None = None) -> str:
     """
     Add an additional stop condition to an embryo in a running timelapse.
 
@@ -408,8 +408,8 @@ def add_stop_condition(embryo_id: str, condition: str, context: dict = None) ->
 def add_interval_speedup_rule(
     trigger_stage: str,
     new_interval_seconds: float = 30.0,
-    embryo_ids: list[str] = None,
-    context: dict = None,
+    embryo_ids: list[str] | None = None,
+    context: dict | None = None,
 ) -> str:
     """Add interval speedup rule based on developmental stage"""
     agent, err = require_agent(context)
@@ -444,7 +444,9 @@ def add_interval_speedup_rule(
     ),
     category=ToolCategory.EXPERIMENT,
 )
-def enable_pre_hatching_speedup(fast_interval_seconds: float = 30.0, context: dict = None) -> str:
+def enable_pre_hatching_speedup(
+    fast_interval_seconds: float = 30.0, context: dict | None = None
+) -> str:
     """Enable pre-hatching speedup based on developmental stage"""
     agent, err = require_agent(context)
     if err:
@@ -476,7 +478,7 @@ def enable_pre_hatching_speedup(fast_interval_seconds: float = 30.0, context: di
     description="Use Claude Vision to classify the current developmental stage of an embryo",
     category=ToolCategory.ANALYSIS,
 )
-async def classify_embryo_stage(embryo_id: str, context: dict = None) -> str:
+async def classify_embryo_stage(embryo_id: str, context: dict | None = None) -> str:
     """Classify embryo stage"""
     agent, err = require_agent(context)
     if err:
@@ -538,7 +540,7 @@ async def classify_embryo_stage(embryo_id: str, context: dict = None) -> str:
     description="Get the developmental stage progression history for an embryo",
     category=ToolCategory.ANALYSIS,
 )
-def get_stage_history(embryo_id: str, context: dict = None) -> str:
+def get_stage_history(embryo_id: str, context: dict | None = None) -> str:
     """Get stage history"""
     agent, err = require_agent(context)
     if err:
@@ -637,7 +639,9 @@ def _perceiver_hatching_estimate(session) -> float | None:
     ),
     category=ToolCategory.ANALYSIS,
 )
-def predict_hatching(embryo_id: str = None, all_embryos: bool = False, context: dict = None) -> str:
+def predict_hatching(
+    embryo_id: str | None = None, all_embryos: bool = False, context: dict | None = None
+) -> str:
     """Predict hatching time with confidence intervals"""
     agent, err = require_agent(context)
     if err:
@@ -754,7 +758,9 @@ def _perc_line(eid: str):
         ToolExample("Turn off autonomy", {"mode": "off"}),
     ],
 )
-def set_autonomy(mode: str = None, enabled: bool = None, context: dict = None) -> str:
+def set_autonomy(
+    mode: str | None = None, enabled: bool | None = None, context: dict | None = None
+) -> str:
     """Set the wake-router mode (off/ask/auto). `enabled` kept for back-compat."""
     agent, err = require_agent(context)
     if err:
@@ -806,7 +812,7 @@ def set_autonomy(mode: str = None, enabled: bool = None, context: dict = None) -
         ToolExample("Slow everything down to 10 minutes", {"new_interval_seconds": 600}),
     ],
 )
-def modify_timelapse_interval(new_interval_seconds: float, context: dict = None) -> str:
+def modify_timelapse_interval(new_interval_seconds: float, context: dict | None = None) -> str:
     """Globally re-anchor the timelapse interval (live)."""
     agent, err = require_agent(context)
     if err:
@@ -836,9 +842,9 @@ def modify_timelapse_interval(new_interval_seconds: float, context: dict = None)
 )
 def set_embryo_cadence(
     embryo_id: str,
-    new_interval_seconds: float = None,
-    new_phase: str = None,
-    context: dict = None,
+    new_interval_seconds: float | None = None,
+    new_phase: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Per-embryo cadence change routed through the re-anchoring path."""
     agent, err = require_agent(context)
@@ -897,9 +903,9 @@ def set_embryo_cadence(
     ],
 )
 def set_photodose_budget(
-    base_dose_budget_ms: float = None,
+    base_dose_budget_ms: float | None = None,
     resume_paused: bool = True,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Set/clear the photodose budget; optionally resume budget-paused embryos."""
     agent, err = require_agent(context)
@@ -951,7 +957,7 @@ def set_photodose_budget(
     category=ToolCategory.ANALYSIS,
     examples=[ToolExample("How much light has each embryo gotten?", {})],
 )
-def get_photodose_status(context: dict = None) -> str:
+def get_photodose_status(context: dict | None = None) -> str:
     """Read-only photodose / budget status across embryos."""
     agent, err = require_agent(context)
     if err:
@@ -1017,7 +1023,7 @@ def get_photodose_status(context: dict = None) -> str:
 )
 def enable_monitoring_mode(
     mode_name: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Install a named reactive monitoring mode on the orchestrator."""
     agent, err = require_agent(context)
@@ -1050,7 +1056,7 @@ def enable_monitoring_mode(
 def add_test_onset_speedup(
     fast_interval: float = 60.0,
     embryo_ids: list[str] | None = None,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Install the canonical signal-onset cadence speedup rule."""
     agent, err = require_agent(context)
@@ -1094,7 +1100,7 @@ def add_test_saturation_rampdown(
     ceiling_pct: float = 6.0,
     confirm_timepoints: int = 0,
     embryo_ids: list[str] | None = None,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Install the canonical 488 saturation rampdown power rule."""
     agent, err = require_agent(context)
@@ -1146,7 +1152,7 @@ def queue_burst(
     mode: str = "1hz",
     num_slices: int = 1,
     force: bool = False,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Queue an exclusive burst acquisition for one embryo."""
     agent, err = require_agent(context)
diff --git a/gently/app/tools/volume_tools.py b/gently/app/tools/volume_tools.py
index b4893e10..02f1afd0 100644
--- a/gently/app/tools/volume_tools.py
+++ b/gently/app/tools/volume_tools.py
@@ -30,10 +30,10 @@
 )
 async def view_image(
     title: str = "Bottom Camera Image",
-    exposure_ms: float = None,
+    exposure_ms: float | None = None,
     show: bool = True,
     show_embryos: bool = True,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Capture and display bottom camera image with embryo annotations"""
     client = context.get("client")
@@ -146,10 +146,10 @@ async def view_image(
     ],
 )
 async def view_volume(
-    embryo_id: str = None,
-    timepoint: int = None,
-    file_path: str = None,
-    context: dict = None,
+    embryo_id: str | None = None,
+    timepoint: int | None = None,
+    file_path: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Open a volume in the browser-based viewer (no blocking desktop window)."""
     from pathlib import Path
@@ -239,7 +239,7 @@ async def view_volume(
         ToolExample("List all volumes", {}),
     ],
 )
-async def list_volumes(embryo_id: str = None, context: dict = None) -> str:
+async def list_volumes(embryo_id: str | None = None, context: dict | None = None) -> str:
     """List available volumes"""
     agent, err = require_agent(context)
     if err:
diff --git a/gently/app/video_maker.py b/gently/app/video_maker.py
index fff408fb..f081ae23 100644
--- a/gently/app/video_maker.py
+++ b/gently/app/video_maker.py
@@ -140,7 +140,7 @@ def create_timelapse_video(
     output_path: Path,
     fps: int = 10,
     add_timestamps: bool = True,
-    embryo_id: str = None,
+    embryo_id: str | None = None,
     progress_callback=None,
 ) -> dict:
     """
diff --git a/gently/core/coordinates.py b/gently/core/coordinates.py
index 0033756a..9948ad97 100644
--- a/gently/core/coordinates.py
+++ b/gently/core/coordinates.py
@@ -54,7 +54,7 @@ def pixel_to_stage_position(
     image_center_y: float,
     stage_x: float,
     stage_y: float,
-    um_per_pixel: float = None,
+    um_per_pixel: float | None = None,
 ) -> tuple[float, float]:
     """
     Convert pixel coordinates to stage position (for embryo POSITION calculation).
@@ -114,7 +114,7 @@ def stage_to_pixel_position(
     current_stage_y: float,
     image_center_x: float,
     image_center_y: float,
-    um_per_pixel: float = None,
+    um_per_pixel: float | None = None,
 ) -> tuple[float, float]:
     """
     Convert stage position to pixel coordinates (for DISPLAY/visualization).
@@ -154,7 +154,7 @@ def stage_to_pixel_position(
 
 
 def pixel_displacement_to_stage_movement(
-    pixel_displacement_x: float, pixel_displacement_y: float, um_per_pixel: float = None
+    pixel_displacement_x: float, pixel_displacement_y: float, um_per_pixel: float | None = None
 ) -> tuple[float, float]:
     """
     Convert pixel displacement to stage MOVEMENT (for centering an embryo).
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index b9658c0c..8cd23095 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -328,9 +328,9 @@ def _generate_projection(
     def create_session(
         self,
         session_id: str,
-        name: str = None,
-        description: str = None,
-        metadata: dict = None,
+        name: str | None = None,
+        description: str | None = None,
+        metadata: dict | None = None,
     ) -> str:
         """Create a new session.  Returns session_id."""
         # If session already exists, return silently (matches INSERT OR IGNORE)
@@ -477,14 +477,14 @@ def register_embryo(
         self,
         session_id: str,
         embryo_id: str,
-        embryo_uid: str = None,
-        nickname: str = None,
-        position_x: float = None,
-        position_y: float = None,
-        position_coarse: dict = None,
-        position_fine: dict = None,
-        calibration: dict = None,
-        role: str = None,
+        embryo_uid: str | None = None,
+        nickname: str | None = None,
+        position_x: float | None = None,
+        position_y: float | None = None,
+        position_coarse: dict | None = None,
+        position_fine: dict | None = None,
+        calibration: dict | None = None,
+        role: str | None = None,
     ) -> None:
         """Register or update an embryo in a session.
 
@@ -605,7 +605,7 @@ def put_volume(
         embryo_id: str,
         timepoint: int,
         volume: np.ndarray,
-        metadata: dict = None,
+        metadata: dict | None = None,
     ) -> Path:
         """
         Write a volume to disk, generate a JPEG projection, write sidecar metadata.
@@ -655,7 +655,7 @@ def register_volume(
         embryo_id: str,
         timepoint: int,
         incoming_path: Path,
-        metadata: dict = None,
+        metadata: dict | None = None,
         volume_data: np.ndarray = None,
     ) -> Path:
         """
@@ -735,7 +735,7 @@ def get_volume_path(self, session_id: str, embryo_id: str, timepoint: int) -> Pa
             return vol_path
         return None
 
-    def list_volumes(self, session_id: str, embryo_id: str = None) -> list[VolumeInfo]:
+    def list_volumes(self, session_id: str, embryo_id: str | None = None) -> list[VolumeInfo]:
         """List volume metadata by scanning sidecar YAML files on disk."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -778,7 +778,7 @@ def list_volumes(self, session_id: str, embryo_id: str = None) -> list[VolumeInf
         result.sort(key=lambda v: (v["embryo_id"], v["timepoint"]))
         return result
 
-    def get_acquisition_params(self, session_id: str, embryo_id: str = None) -> dict | None:
+    def get_acquisition_params(self, session_id: str, embryo_id: str | None = None) -> dict | None:
         """
         Get acquisition parameters from the most recent volume sidecar.
 
@@ -895,7 +895,7 @@ def register_snapshot(
         session_id: str,
         source: str,
         incoming_path: Path,
-        metadata: dict = None,
+        metadata: dict | None = None,
     ) -> Path:
         """Move a transient TIFF from incoming/ to ``snapshots/``."""
         incoming_path = Path(incoming_path)
@@ -942,7 +942,7 @@ def register_snapshot(
         logger.debug("register_snapshot: %s -> %s", incoming_path.name, canonical)
         return canonical
 
-    def list_snapshots(self, session_id: str, source: str = None) -> list[dict[str, Any]]:
+    def list_snapshots(self, session_id: str, source: str | None = None) -> list[dict[str, Any]]:
         """List snapshot records for a session, optionally filtered by source."""
         sd = self._session_dir(session_id)
         if sd is None:
@@ -1018,10 +1018,10 @@ def create_perception_run(
         session_id: str,
         name: str,
         method: str,
-        model_name: str = None,
+        model_name: str | None = None,
         trace_type: str = "perception",
         source: str = "live",
-        config: dict = None,
+        config: dict | None = None,
     ) -> int:
         """Create a perception run.  Returns run_id (auto-increment)."""
         runs = self._load_perception_runs(session_id)
@@ -1047,7 +1047,7 @@ def create_perception_run(
         return run_id
 
     def complete_perception_run(
-        self, run_id: int, status: str = "completed", error_message: str = None
+        self, run_id: int, status: str = "completed", error_message: str | None = None
     ) -> None:
         """Mark a perception run as completed or failed.
 
@@ -1071,14 +1071,14 @@ def store_prediction(
         embryo_id: str,
         timepoint: int,
         predicted_stage: str,
-        confidence: float = None,
-        reasoning: str = None,
+        confidence: float | None = None,
+        reasoning: str | None = None,
         is_transitional: bool = False,
-        execution_time_ms: float = None,
-        trace_data: dict = None,
-        observed_features: dict = None,
-        ground_truth_stage: str = None,
-        is_correct: int = None,
+        execution_time_ms: float | None = None,
+        trace_data: dict | None = None,
+        observed_features: dict | None = None,
+        ground_truth_stage: str | None = None,
+        is_correct: int | None = None,
     ) -> int:
         """
         Append a prediction to predictions.jsonl and optionally write trace JSON.
@@ -1133,8 +1133,8 @@ def store_prediction(
     def get_predictions(
         self,
         session_id: str,
-        embryo_id: str = None,
-        run_id: int = None,
+        embryo_id: str | None = None,
+        run_id: int | None = None,
     ) -> list[PredictionInfo]:
         """Query predictions with optional filters."""
         sd = self._session_dir(session_id)
@@ -1174,9 +1174,9 @@ def set_ground_truth(
         embryo_id: str,
         stage: str,
         start_timepoint: int,
-        end_timepoint: int = None,
-        annotator: str = None,
-        notes: str = None,
+        end_timepoint: int | None = None,
+        annotator: str | None = None,
+        notes: str | None = None,
     ) -> None:
         """Insert or update a ground-truth annotation."""
         ed = self._embryo_dir(session_id, embryo_id)
diff --git a/gently/core/store.py b/gently/core/store.py
index e070d734..d33764da 100644
--- a/gently/core/store.py
+++ b/gently/core/store.py
@@ -279,9 +279,9 @@ def _abs_path(self, rel_path: str) -> Path:
     def create_session(
         self,
         session_id: str,
-        name: str = None,
-        description: str = None,
-        metadata: dict = None,
+        name: str | None = None,
+        description: str | None = None,
+        metadata: dict | None = None,
     ) -> str:
         """Create a new session. Returns session_id."""
         now = self._now()
@@ -355,11 +355,11 @@ def register_embryo(
         self,
         session_id: str,
         embryo_id: str,
-        embryo_uid: str = None,
-        nickname: str = None,
-        position_x: float = None,
-        position_y: float = None,
-        calibration: dict = None,
+        embryo_uid: str | None = None,
+        nickname: str | None = None,
+        position_x: float | None = None,
+        position_y: float | None = None,
+        calibration: dict | None = None,
     ):
         """Register or update an embryo in a session."""
         now = self._now()
@@ -433,7 +433,7 @@ def put_volume(
         embryo_id: str,
         timepoint: int,
         volume: np.ndarray,
-        metadata: dict = None,
+        metadata: dict | None = None,
     ) -> Path:
         """
         Write a volume to disk, generate a JPEG projection, insert DB rows.
@@ -491,7 +491,7 @@ def register_volume(
         embryo_id: str,
         timepoint: int,
         incoming_path: Path,
-        metadata: dict = None,
+        metadata: dict | None = None,
         volume_data: np.ndarray = None,
     ) -> Path:
         """
@@ -575,7 +575,7 @@ def register_snapshot(
         session_id: str,
         source: str,
         incoming_path: Path,
-        metadata: dict = None,
+        metadata: dict | None = None,
     ) -> Path:
         """Move a transient TIFF from *incoming/* to ``snapshots/{session}/``.
 
@@ -633,7 +633,7 @@ def register_snapshot(
         logger.debug("register_snapshot: %s -> %s", incoming_path.name, canonical)
         return canonical
 
-    def list_snapshots(self, session_id: str, source: str = None) -> list[dict[str, Any]]:
+    def list_snapshots(self, session_id: str, source: str | None = None) -> list[dict[str, Any]]:
         """List snapshot records for a session, optionally filtered by source."""
         if source:
             rows = self._conn.execute(
@@ -706,7 +706,7 @@ def get_volume_path(self, session_id: str, embryo_id: str, timepoint: int) -> Pa
             return None
         return self._abs_path(row["file_path"])
 
-    def list_volumes(self, session_id: str, embryo_id: str = None) -> list[VolumeInfo]:
+    def list_volumes(self, session_id: str, embryo_id: str | None = None) -> list[VolumeInfo]:
         """List volume metadata rows for a session (optionally filtered)."""
         if embryo_id:
             rows = self._conn.execute(
@@ -728,7 +728,7 @@ def list_volumes(self, session_id: str, embryo_id: str = None) -> list[VolumeInf
             result.append(d)
         return result
 
-    def get_acquisition_params(self, session_id: str, embryo_id: str = None) -> dict | None:
+    def get_acquisition_params(self, session_id: str, embryo_id: str | None = None) -> dict | None:
         """
         Get the acquisition parameters used in a session.
 
@@ -887,10 +887,10 @@ def create_perception_run(
         session_id: str,
         name: str,
         method: str,
-        model_name: str = None,
+        model_name: str | None = None,
         trace_type: str = "perception",
         source: str = "live",
-        config: dict = None,
+        config: dict | None = None,
     ) -> int:
         """Create a perception run. Returns run_id."""
         now = self._now()
@@ -920,14 +920,14 @@ def store_prediction(
         embryo_id: str,
         timepoint: int,
         predicted_stage: str,
-        confidence: float = None,
-        reasoning: str = None,
+        confidence: float | None = None,
+        reasoning: str | None = None,
         is_transitional: bool = False,
-        execution_time_ms: float = None,
-        trace_data: dict = None,
-        observed_features: dict = None,
-        ground_truth_stage: str = None,
-        is_correct: int = None,
+        execution_time_ms: float | None = None,
+        trace_data: dict | None = None,
+        observed_features: dict | None = None,
+        ground_truth_stage: str | None = None,
+        is_correct: int | None = None,
     ) -> int:
         """
         Insert a prediction row. Optionally writes trace JSON file.
@@ -981,7 +981,7 @@ def store_prediction(
             return cursor.lastrowid
 
     def complete_perception_run(
-        self, run_id: int, status: str = "completed", error_message: str = None
+        self, run_id: int, status: str = "completed", error_message: str | None = None
     ):
         """Mark a perception run as completed or failed."""
         now = self._now()
@@ -995,8 +995,8 @@ def complete_perception_run(
     def get_predictions(
         self,
         session_id: str,
-        embryo_id: str = None,
-        run_id: int = None,
+        embryo_id: str | None = None,
+        run_id: int | None = None,
     ) -> list[PredictionInfo]:
         """Query predictions with optional filters."""
         clauses = ["session_id = ?"]
@@ -1033,9 +1033,9 @@ def set_ground_truth(
         embryo_id: str,
         stage: str,
         start_timepoint: int,
-        end_timepoint: int = None,
-        annotator: str = None,
-        notes: str = None,
+        end_timepoint: int | None = None,
+        annotator: str | None = None,
+        notes: str | None = None,
     ):
         """Insert or update a ground-truth annotation."""
         with self._tx():
diff --git a/gently/dataset/explorer_server.py b/gently/dataset/explorer_server.py
index 510ddd42..3c9e816d 100644
--- a/gently/dataset/explorer_server.py
+++ b/gently/dataset/explorer_server.py
@@ -505,7 +505,9 @@ def _generate_color(self, client_id: str) -> str:
         hash_val = sum(ord(c) for c in client_id)
         return self.AVATAR_COLORS[hash_val % len(self.AVATAR_COLORS)]
 
-    async def connect(self, websocket: WebSocket, client_id: str = None, name: str = None):
+    async def connect(
+        self, websocket: WebSocket, client_id: str | None = None, name: str | None = None
+    ):
         await websocket.accept()
 
         # Generate defaults if not provided
diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index f44ff8db..9401fd37 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -256,7 +256,7 @@ async def _api_get(self, path: str) -> dict:
         async with self._session.get(f"{self.http_url}{path}") as resp:
             return await resp.json()
 
-    async def _api_post(self, path: str, json: dict = None) -> dict:
+    async def _api_post(self, path: str, json: dict | None = None) -> dict:
         """POST request using the shared session."""
         self._ensure_connected()
         async with self._session.post(f"{self.http_url}{path}", json=json) as resp:
@@ -265,7 +265,7 @@ async def _api_post(self, path: str, json: dict = None) -> dict:
     async def _submit_plan_and_wait(
         self,
         plan_name: str,
-        kwargs: dict = None,
+        kwargs: dict | None = None,
         timeout: float = 120.0,
     ) -> dict:
         """Submit a Bluesky plan to the server and wait for completion.
@@ -541,11 +541,11 @@ async def acquire_volume(
         galvo_center: float = 0.0,
         piezo_amplitude: float = 25.0,
         piezo_center: float = 50.0,
-        laser_config: str = None,
-        laser_power_488_pct: float = None,
-        laser_power_561_pct: float = None,
-        laser_power_405_pct: float = None,
-        laser_power_637_pct: float = None,
+        laser_config: str | None = None,
+        laser_power_488_pct: float | None = None,
+        laser_power_561_pct: float | None = None,
+        laser_power_405_pct: float | None = None,
+        laser_power_637_pct: float | None = None,
         **kwargs,
     ) -> dict:
         """
@@ -629,12 +629,12 @@ async def acquire_burst(
         galvo_center: float = 0.0,
         piezo_amplitude: float = 25.0,
         piezo_center: float = 50.0,
-        laser_config: str = None,
-        laser_power_488_pct: float = None,
-        laser_power_561_pct: float = None,
-        laser_power_405_pct: float = None,
-        laser_power_637_pct: float = None,
-        timeout: float = None,
+        laser_config: str | None = None,
+        laser_power_488_pct: float | None = None,
+        laser_power_561_pct: float | None = None,
+        laser_power_405_pct: float | None = None,
+        laser_power_637_pct: float | None = None,
+        timeout: float | None = None,
     ) -> dict:
         """
         Acquire ``frames`` volumes back-to-back as a single device-layer plan.
@@ -956,7 +956,9 @@ async def get_bottom_camera_exposure(self) -> dict:
         """Get current bottom camera exposure time."""
         return await self._api_get("/api/camera/exposure")
 
-    async def capture_bottom_image(self, use_led: bool = False, exposure_ms: float = None) -> dict:
+    async def capture_bottom_image(
+        self, use_led: bool = False, exposure_ms: float | None = None
+    ) -> dict:
         """
         Capture image from bottom camera.
 
@@ -1000,7 +1002,7 @@ async def detect_embryos(
         objective_mag: float = DEFAULT_OBJECTIVE_MAG,
         use_claude_review: bool = True,
         min_confidence: float = 0.7,
-        exposure_ms: float = None,
+        exposure_ms: float | None = None,
         brightness_percentile: float = 99.0,
         min_area: int = 5000,
         max_area: int = 150000,
@@ -1088,7 +1090,7 @@ async def detect_embryos(
             }
 
     async def _get_detection_image(
-        self, detection_result: dict, exposure_ms: float = None
+        self, detection_result: dict, exposure_ms: float | None = None
     ) -> np.ndarray | None:
         """Load or capture an image for the detection editor."""
         image_path = detection_result.get("image_path")
@@ -1113,10 +1115,10 @@ async def view_image(
         self,
         image: np.ndarray = None,
         title: str = "Image View",
-        exposure_ms: float = None,
-        save_path: str = None,
+        exposure_ms: float | None = None,
+        save_path: str | None = None,
         show: bool = True,
-        embryo_annotations: list = None,
+        embryo_annotations: list | None = None,
     ) -> dict:
         """Save a bottom-camera image to disk (replaces the napari display).
 
@@ -1224,7 +1226,7 @@ async def view_embryos(
 
     async def capture_for_marking(
         self,
-        exposure_ms: float = None,
+        exposure_ms: float | None = None,
     ) -> dict:
         """
         Capture a bottom-camera image for manual marking in the map view.
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index bc8daead..6d606621 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -1260,7 +1260,7 @@ async def _plan_executor(self):
             if len(self._plan_execution_log) > 1000:
                 self._plan_execution_log = self._plan_execution_log[-1000:]
 
-    async def submit_plan(self, plan_name: str, kwargs: dict = None) -> dict:
+    async def submit_plan(self, plan_name: str, kwargs: dict | None = None) -> dict:
         """Submit a plan and wait for completion"""
         kwargs = kwargs or {}
 
@@ -2945,7 +2945,7 @@ async def health_check(self) -> dict:
         base["sam_loaded"] = self._sam_detector is not None
         return base
 
-    async def run(self, host: str = None, port: int = None):
+    async def run(self, host: str | None = None, port: int | None = None):
         """Start the server and run until interrupted."""
         if host is not None:
             self.host = host
diff --git a/gently/hardware/dispim/devices/acquisition.py b/gently/hardware/dispim/devices/acquisition.py
index ad8080ce..9b2658ef 100644
--- a/gently/hardware/dispim/devices/acquisition.py
+++ b/gently/hardware/dispim/devices/acquisition.py
@@ -97,11 +97,11 @@ def configure(
         piezo_amplitude: float,
         piezo_center: float,
         laser_config: str = "488 and 561",
-        laser_power_488_pct: float = None,
-        laser_power_561_pct: float = None,
-        laser_power_405_pct: float = None,
-        laser_power_637_pct: float = None,
-        timing_params: dict = None,
+        laser_power_488_pct: float | None = None,
+        laser_power_561_pct: float | None = None,
+        laser_power_405_pct: float | None = None,
+        laser_power_637_pct: float | None = None,
+        timing_params: dict | None = None,
     ):
         """
         Configure all devices for hardware-triggered volume acquisition.
diff --git a/gently/hardware/dispim/devices/optical.py b/gently/hardware/dispim/devices/optical.py
index 4108a700..a6544cc0 100644
--- a/gently/hardware/dispim/devices/optical.py
+++ b/gently/hardware/dispim/devices/optical.py
@@ -20,7 +20,7 @@ class DiSPIMLED:
     Device-agnostic: any plan that sets device state will work
     """
 
-    def __init__(self, core: pymmcore.CMMCore, name: str = "LED", group_name: str = None):
+    def __init__(self, core: pymmcore.CMMCore, name: str = "LED", group_name: str | None = None):
         self.core = core
         self.name = name
         self.group_name = group_name or name
@@ -128,7 +128,7 @@ class DiSPIMLightSource:
         637: (0.0, 100.0),
     }
 
-    def __init__(self, core: pymmcore.CMMCore, name: str = "Laser", group_name: str = None):
+    def __init__(self, core: pymmcore.CMMCore, name: str = "Laser", group_name: str | None = None):
         self.core = core
         self.name = name
         self.group_name = group_name or name
diff --git a/gently/hardware/dispim/devices/scanner.py b/gently/hardware/dispim/devices/scanner.py
index 79732ef1..1197c5c1 100644
--- a/gently/hardware/dispim/devices/scanner.py
+++ b/gently/hardware/dispim/devices/scanner.py
@@ -367,7 +367,7 @@ def configure_for_volume_acquisition(
         galvo_amplitude: float,
         galvo_center: float,
         num_slices: int,
-        timing_params: dict = None,
+        timing_params: dict | None = None,
     ):
         """
         Configure scanner for hardware-triggered volume acquisition.
diff --git a/gently/hardware/dispim/plans/acquisition.py b/gently/hardware/dispim/plans/acquisition.py
index 84e49d02..02aabba8 100644
--- a/gently/hardware/dispim/plans/acquisition.py
+++ b/gently/hardware/dispim/plans/acquisition.py
@@ -789,10 +789,10 @@ def acquire_single_volume_plan(
     piezo_amplitude: float = 25.0,
     piezo_center: float = 50.0,
     laser_config: str = "488 and 561",
-    laser_power_488_pct: float = None,
-    laser_power_561_pct: float = None,
-    laser_power_405_pct: float = None,
-    laser_power_637_pct: float = None,
+    laser_power_488_pct: float | None = None,
+    laser_power_561_pct: float | None = None,
+    laser_power_405_pct: float | None = None,
+    laser_power_637_pct: float | None = None,
     timing_params: dict | None = None,
     metadata: dict | None = None,
 ):
@@ -924,10 +924,10 @@ def burst_plan(
     piezo_amplitude: float = 25.0,
     piezo_center: float = 50.0,
     laser_config: str = "488 only",
-    laser_power_488_pct: float = None,
-    laser_power_561_pct: float = None,
-    laser_power_405_pct: float = None,
-    laser_power_637_pct: float = None,
+    laser_power_488_pct: float | None = None,
+    laser_power_561_pct: float | None = None,
+    laser_power_405_pct: float | None = None,
+    laser_power_637_pct: float | None = None,
     timing_params: dict | None = None,
     metadata: dict | None = None,
 ):
diff --git a/gently/harness/memory/interface.py b/gently/harness/memory/interface.py
index 7eba1774..2e27db8d 100644
--- a/gently/harness/memory/interface.py
+++ b/gently/harness/memory/interface.py
@@ -35,7 +35,7 @@ class AgentMemory:
     or prompt injection.
     """
 
-    def __init__(self, context_store, session_id: str = None):
+    def __init__(self, context_store, session_id: str | None = None):
         self.store = context_store
         self.session_id = session_id
         # Set by startup flow after resolve_plan_context()
@@ -243,7 +243,7 @@ def get_awareness_summary(self) -> str:
     # Briefing layer — auto-briefing at session start
     # ------------------------------------------------------------------
 
-    def get_session_briefing(self, campaign_id: str = None) -> str:
+    def get_session_briefing(self, campaign_id: str | None = None) -> str:
         """Generate a session briefing for new sessions.
 
         If campaign_id is provided (or session is linked to a campaign),
@@ -455,7 +455,7 @@ def recall_campaigns(self, status: str = "active") -> str:
 
         return "\n".join(lines)
 
-    def recall_learnings(self, query: str = None, limit: int = 20) -> str:
+    def recall_learnings(self, query: str | None = None, limit: int = 20) -> str:
         """Search or list learnings."""
         learnings = self.store.get_learnings(limit=max(limit, 50))
 
@@ -491,7 +491,9 @@ def recall_learnings(self, query: str = None, limit: int = 20) -> str:
 
         return "\n".join(lines)
 
-    def recall_observations(self, query: str = None, embryo_id: str = None, limit: int = 20) -> str:
+    def recall_observations(
+        self, query: str | None = None, embryo_id: str | None = None, limit: int = 20
+    ) -> str:
         """Search or list observations."""
         if embryo_id:
             observations = self.store.get_observations_for_embryo(embryo_id)
@@ -531,7 +533,7 @@ def recall_observations(self, query: str = None, embryo_id: str = None, limit: i
 
         return "\n".join(lines)
 
-    def recall_full_context(self, campaign_id: str = None) -> str:
+    def recall_full_context(self, campaign_id: str | None = None) -> str:
         """Full context snapshot — the 'catch me up' method.
 
         If campaign_id provided (or session is linked), focuses there.
diff --git a/gently/harness/microscope.py b/gently/harness/microscope.py
index f76af5c5..6c684469 100644
--- a/gently/harness/microscope.py
+++ b/gently/harness/microscope.py
@@ -317,7 +317,7 @@ def register_microscope_tools(microscope: Microscope, registry=None) -> int:
     def _make_handler(pname):
         """Create an async handler that delegates to microscope.execute()."""
 
-        async def handler(context: dict = None, **params):
+        async def handler(context: dict | None = None, **params):
             ms = context.get("client") if context else microscope
             if ms is None:
                 return "Error: microscope not connected"
diff --git a/gently/harness/plan_mode/tools/lab_context.py b/gently/harness/plan_mode/tools/lab_context.py
index 401db7d6..574a725d 100644
--- a/gently/harness/plan_mode/tools/lab_context.py
+++ b/gently/harness/plan_mode/tools/lab_context.py
@@ -25,7 +25,7 @@
 )
 async def query_lab_history(
     query: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Search lab history for relevant context."""
     agent = context.get("agent") if context else None
@@ -114,7 +114,7 @@ async def query_lab_history(
 )
 async def check_hardware_capability(
     question: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Check hardware capabilities against a question."""
     from gently.hardware import get_hardware
diff --git a/gently/harness/plan_mode/tools/planning.py b/gently/harness/plan_mode/tools/planning.py
index b1a976c4..34785e5f 100644
--- a/gently/harness/plan_mode/tools/planning.py
+++ b/gently/harness/plan_mode/tools/planning.py
@@ -37,10 +37,10 @@
 )
 async def create_campaign(
     description: str,
-    shorthand: str = None,
-    target: str = None,
-    parent_id: str = None,
-    context: dict = None,
+    shorthand: str | None = None,
+    target: str | None = None,
+    parent_id: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Create a campaign or sub-campaign (phase)."""
     agent = context.get("agent") if context else None
@@ -112,15 +112,15 @@ async def create_plan_item(
     campaign_id: str,
     type: str,
     title: str,
-    description: str = None,
-    spec: dict = None,
-    inherit_from: str = None,
-    depends_on: list[str] = None,
-    phase_number: int = None,
+    description: str | None = None,
+    spec: dict | None = None,
+    inherit_from: str | None = None,
+    depends_on: list[str] | None = None,
+    phase_number: int | None = None,
     phase_order: int = -1,
-    references: list[dict] = None,
-    estimated_days: int = None,
-    context: dict = None,
+    references: list[dict] | None = None,
+    estimated_days: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Create a plan item within a campaign/phase.
 
@@ -198,15 +198,15 @@ async def create_plan_item(
 )
 async def update_plan_item(
     item_id: str,
-    status: str = None,
-    title: str = None,
-    description: str = None,
-    outcome: str = None,
-    spec: dict = None,
-    references: list[dict] = None,
-    estimated_days: int = None,
-    campaign_id: str = None,
-    context: dict = None,
+    status: str | None = None,
+    title: str | None = None,
+    description: str | None = None,
+    outcome: str | None = None,
+    spec: dict | None = None,
+    references: list[dict] | None = None,
+    estimated_days: int | None = None,
+    campaign_id: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Update a plan item. item_id can be a UUID, task number (e.g. '3'),
     or phase.task reference (e.g. '1.3'). campaign_id scopes resolution
@@ -263,8 +263,8 @@ async def update_plan_item(
 async def link_plan_items(
     item_id: str,
     depends_on_id: str,
-    campaign_id: str = None,
-    context: dict = None,
+    campaign_id: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Add a dependency between plan items. campaign_id scopes resolution
     when using shorthand refs (e.g. '1.3') with multiple plans."""
@@ -308,8 +308,8 @@ async def link_plan_items(
 )
 async def get_plan_item_tool(
     ref: str,
-    campaign_id: str = None,
-    context: dict = None,
+    campaign_id: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Look up a plan item by natural reference."""
     agent = context.get("agent") if context else None
@@ -347,7 +347,7 @@ async def get_plan_item_tool(
 )
 async def propose_plan(
     campaign_id: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Render the full plan for review."""
     agent = context.get("agent") if context else None
@@ -506,7 +506,7 @@ def _format_plan_item(item, store, task_num: str = "") -> str:
 )
 async def get_plan_status(
     campaign_id: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Get plan progress summary."""
     agent = context.get("agent") if context else None
@@ -576,10 +576,10 @@ async def get_plan_status(
 async def batch_update_status(
     campaign_id: str,
     new_status: str,
-    outcome: str = None,
-    phase_number: int = None,
-    item_type: str = None,
-    context: dict = None,
+    outcome: str | None = None,
+    phase_number: int | None = None,
+    item_type: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Batch-update status of plan items."""
     agent = context.get("agent") if context else None
@@ -659,8 +659,8 @@ async def batch_update_spec(
     campaign_id: str,
     field_name: str,
     field_value: object,
-    phase_number: int = None,
-    context: dict = None,
+    phase_number: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Batch-update a spec field on imaging items."""
     agent = context.get("agent") if context else None
@@ -737,10 +737,10 @@ async def batch_update_spec(
 async def move_plan_item(
     campaign_id: str,
     item_ref: str,
-    to_phase_number: int = None,
-    to_campaign_id: str = None,
-    position: int = None,
-    context: dict = None,
+    to_phase_number: int | None = None,
+    to_campaign_id: str | None = None,
+    position: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Move a plan item to a different phase."""
     agent = context.get("agent") if context else None
@@ -799,8 +799,8 @@ async def move_plan_item(
 )
 async def delete_plan_item_tool(
     item_ref: str,
-    campaign_id: str = None,
-    context: dict = None,
+    campaign_id: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Delete a plan item."""
     agent = context.get("agent") if context else None
@@ -856,8 +856,8 @@ async def delete_plan_item_tool(
 async def reorder_plan_items(
     campaign_id: str,
     item_order: list[str],
-    phase_number: int = None,
-    context: dict = None,
+    phase_number: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Reorder plan items within a phase."""
     agent = context.get("agent") if context else None
@@ -919,10 +919,10 @@ async def reorder_plan_items(
 async def update_phase(
     campaign_id: str,
     phase_number: int,
-    description: str = None,
-    shorthand: str = None,
-    target: str = None,
-    context: dict = None,
+    description: str | None = None,
+    shorthand: str | None = None,
+    target: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Update a phase's metadata."""
     agent = context.get("agent") if context else None
@@ -963,7 +963,7 @@ async def update_phase(
 async def delete_phase(
     campaign_id: str,
     phase_number: int,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Delete a phase and its contents."""
     agent = context.get("agent") if context else None
@@ -1017,7 +1017,7 @@ async def delete_phase(
 async def export_plan(
     campaign_id: str,
     include_validation: bool = False,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Export a plan as a shareable markdown document."""
     agent = context.get("agent") if context else None
@@ -1327,8 +1327,8 @@ async def validate_plan_for_export(campaign_id: str, store) -> str:
 )
 async def snapshot_plan(
     campaign_id: str,
-    label: str = None,
-    context: dict = None,
+    label: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Save a snapshot of the current plan."""
     agent = context.get("agent") if context else None
@@ -1367,7 +1367,7 @@ async def snapshot_plan(
 )
 async def list_plan_versions(
     campaign_id: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """List saved plan versions."""
     agent = context.get("agent") if context else None
@@ -1415,9 +1415,9 @@ async def list_plan_versions(
 )
 async def restore_plan_version(
     campaign_id: str,
-    version_id: str = None,
-    version_number: int = None,
-    context: dict = None,
+    version_id: str | None = None,
+    version_number: int | None = None,
+    context: dict | None = None,
 ) -> str:
     """Restore a plan to a previous snapshot."""
     agent = context.get("agent") if context else None
diff --git a/gently/harness/plan_mode/tools/research.py b/gently/harness/plan_mode/tools/research.py
index 6c3b19b5..dabd92b5 100644
--- a/gently/harness/plan_mode/tools/research.py
+++ b/gently/harness/plan_mode/tools/research.py
@@ -448,7 +448,7 @@ async def _cgc_search(query: str, field: str = "strain") -> list[dict]:
 async def search_literature(
     query: str,
     max_results: int = 5,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Search PubMed for relevant papers.
 
@@ -590,7 +590,7 @@ async def search_literature(
 async def search_strains(
     query: str,
     organism: str = "celegans",
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Search for strains and genes via NCBI Gene + WormBase REST API.
 
@@ -1221,7 +1221,7 @@ async def _doi_to_pmid(doi: str) -> str | None:
 )
 async def read_paper(
     reference: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Read a scientific paper and return its content.
 
diff --git a/gently/harness/plan_mode/tools/templates.py b/gently/harness/plan_mode/tools/templates.py
index b75b0e64..03557477 100644
--- a/gently/harness/plan_mode/tools/templates.py
+++ b/gently/harness/plan_mode/tools/templates.py
@@ -31,8 +31,8 @@
 async def save_plan_template(
     campaign_id: str,
     name: str,
-    description: str = None,
-    context: dict = None,
+    description: str | None = None,
+    context: dict | None = None,
 ) -> str:
     """Save a campaign as a reusable template."""
     agent = context.get("agent") if context else None
@@ -65,7 +65,7 @@ async def save_plan_template(
     category=ToolCategory.UTILITY,
 )
 async def list_templates(
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """List available plan templates."""
     agent = context.get("agent") if context else None
@@ -110,8 +110,8 @@ async def list_templates(
 )
 async def apply_template(
     template_id: str,
-    overrides: dict = None,
-    context: dict = None,
+    overrides: dict | None = None,
+    context: dict | None = None,
 ) -> str:
     """Instantiate a template into a new campaign."""
     agent = context.get("agent") if context else None
diff --git a/gently/harness/plan_mode/tools/validation.py b/gently/harness/plan_mode/tools/validation.py
index 18e06ae6..031918ca 100644
--- a/gently/harness/plan_mode/tools/validation.py
+++ b/gently/harness/plan_mode/tools/validation.py
@@ -165,7 +165,7 @@ def _normalise_stage(name: str) -> str | None:
 )
 async def validate_plan(
     campaign_id: str,
-    context: dict = None,
+    context: dict | None = None,
 ) -> str:
     """Validate a plan and return errors/warnings."""
     agent = context.get("agent") if context else None
diff --git a/gently/harness/prompts/manager.py b/gently/harness/prompts/manager.py
index 9552be76..9405c820 100644
--- a/gently/harness/prompts/manager.py
+++ b/gently/harness/prompts/manager.py
@@ -47,7 +47,7 @@ def __init__(self, claude_client, model):
         self.memory = None  # AgentMemory instance
 
     def update_system_prompt(
-        self, experiment, client, mode: str, context_summary: str = None, perceiver=None
+        self, experiment, client, mode: str, context_summary: str | None = None, perceiver=None
     ) -> str:
         """
         Rebuild system prompt with current experiment state and connection status.
diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index ef2fc3f4..f75fc7a5 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -365,9 +365,9 @@ def build_perception_snapshot(perceiver, embryos) -> str:
 
 def build_system_prompt(
     experiment_state: ExperimentState,
-    connection_status: dict = None,
-    context_summary: str = None,
-    memory_awareness: str = None,
+    connection_status: dict | None = None,
+    context_summary: str | None = None,
+    memory_awareness: str | None = None,
     microscope=None,
     perceiver=None,
 ) -> str:
diff --git a/gently/harness/state.py b/gently/harness/state.py
index e5b275ab..34b7d8f6 100644
--- a/gently/harness/state.py
+++ b/gently/harness/state.py
@@ -244,15 +244,15 @@ class EmbryoState:
 
     def add_focus_datapoint(
         self,
-        z: float = None,
+        z: float | None = None,
         secondary_axis: float = 0.0,
         score: float = 0.0,
         r_squared: float = 0.0,
         method: str = "manual",
         algorithm: str = "fft_bandpass",
         # Backward-compatible kwargs
-        galvo: float = None,
-        piezo: float = None,
+        galvo: float | None = None,
+        piezo: float | None = None,
     ):
         """
         Record a focus measurement for this embryo.
@@ -440,7 +440,7 @@ def get_piezo_galvo_fit(self, **kwargs) -> tuple[float, float] | None:
     def get_focus_drift_rate(
         self,
         secondary_position: float = 0.0,
-        galvo_position: float = None,
+        galvo_position: float | None = None,
         min_measurements: int = 3,
     ) -> float | None:
         """
@@ -498,7 +498,7 @@ def needs_refocus(
         self,
         max_age_minutes: float = 60,
         secondary_position: float = 0.0,
-        galvo_position: float = None,
+        galvo_position: float | None = None,
     ) -> bool:
         """
         Determine if this embryo needs focus re-measurement.
@@ -936,13 +936,13 @@ def notify_embryos_changed(self) -> None:
     def add_embryo(
         self,
         embryo_id: str,
-        position: dict = None,
-        calibration: dict = None,
+        position: dict | None = None,
+        calibration: dict | None = None,
         user_label: str | None = None,
         confidence: float = 0.0,
         uid: str | None = None,
         role: str = "test",
-        position_fine: dict = None,
+        position_fine: dict | None = None,
     ):
         """Register new embryo.
 
diff --git a/gently/harness/tools/registry.py b/gently/harness/tools/registry.py
index 30f72cf8..88c37241 100644
--- a/gently/harness/tools/registry.py
+++ b/gently/harness/tools/registry.py
@@ -400,7 +400,7 @@ def get_claude_schemas(self, has_microscope: bool = False) -> list[dict]:
         """Get Claude API tool schemas for available tools"""
         return [tool.to_claude_schema() for tool in self.list_available(has_microscope)]
 
-    async def execute(self, tool_name: str, tool_input: dict, context: dict = None) -> str:
+    async def execute(self, tool_name: str, tool_input: dict, context: dict | None = None) -> str:
         """
         Execute a tool by name
 
diff --git a/gently/log_config.py b/gently/log_config.py
index 5d5f75b2..69a673a0 100644
--- a/gently/log_config.py
+++ b/gently/log_config.py
@@ -20,8 +20,8 @@
 
 
 def configure_logging(
-    level: str = None,
-    log_file: str = None,
+    level: str | None = None,
+    log_file: str | None = None,
 ):
     """Configure root logger for the Gently system.
 
diff --git a/gently/mesh/verse_map.py b/gently/mesh/verse_map.py
index 15265548..7fd36934 100644
--- a/gently/mesh/verse_map.py
+++ b/gently/mesh/verse_map.py
@@ -152,7 +152,7 @@ def find_microscope_peers(self) -> list[PersistedPeer]:
         ]
         return self._sorted_peers(results)
 
-    def find_data_peers(self, session_id: str = None) -> list[PersistedPeer]:
+    def find_data_peers(self, session_id: str | None = None) -> list[PersistedPeer]:
         """Find peers with data, optionally filtering by session."""
         results = []
         for p in self._peers.values():
diff --git a/gently/ui/web/connection_manager.py b/gently/ui/web/connection_manager.py
index ffaaf11a..11cc3fe4 100644
--- a/gently/ui/web/connection_manager.py
+++ b/gently/ui/web/connection_manager.py
@@ -54,7 +54,9 @@ def _generate_color(self, client_id: str) -> str:
         hash_val = sum(ord(c) for c in client_id)
         return self.AVATAR_COLORS[hash_val % len(self.AVATAR_COLORS)]
 
-    async def connect(self, websocket: WebSocket, client_id: str = None, name: str = None):
+    async def connect(
+        self, websocket: WebSocket, client_id: str | None = None, name: str | None = None
+    ):
         await websocket.accept()
 
         # Generate defaults if not provided
@@ -168,7 +170,7 @@ async def send_image(self, image_data: ImageData):
         await self.broadcast({"type": "image", "data": image_data.to_dict()})
 
     async def send_event(
-        self, event_type: str, data: dict, source: str = None, event_id: str = None
+        self, event_type: str, data: dict, source: str | None = None, event_id: str | None = None
     ):
         """Send event notification to all clients"""
         await self.broadcast(
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index 12e47714..c16c548d 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -143,8 +143,8 @@ def __init__(
         event_bus=None,
         sessions_dir: str = str(settings.storage.sessions_dir),
         gently_store=None,
-        ssl_certfile: str = None,
-        ssl_keyfile: str = None,
+        ssl_certfile: str | None = None,
+        ssl_keyfile: str | None = None,
     ):
         super().__init__(name="visualization", service_type="http", host=host, port=port)
         if not FASTAPI_AVAILABLE:
@@ -636,7 +636,7 @@ async def start_marking_session(
         )
         return session_id
 
-    async def wait_for_marking(self, session_id: str, timeout: float = None) -> list:
+    async def wait_for_marking(self, session_id: str, timeout: float | None = None) -> list:
         """
         Wait for a marking session to complete.
 
diff --git a/launch_gently.py b/launch_gently.py
index 0663c500..64efdc15 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -225,7 +225,7 @@ def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
 
 async def main(
     offline: bool = False,
-    resume_session: str = None,
+    resume_session: str | None = None,
     show_sessions: bool = False,
     pick_session: bool = False,
     log_level: str = "WARNING",
diff --git a/pyproject.toml b/pyproject.toml
index 82cc2dcf..bb3d5b40 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -182,7 +182,6 @@ module = [
     "gently.app.tools.detection_tools",
     "gently.app.tools.experiment_tools",
     "gently.app.tools.focus_tools",
-    "gently.app.tools.interaction_tools",
     "gently.app.tools.led_tools",
     "gently.app.tools.light_source_tools",
     "gently.app.tools.memory_tools",
@@ -194,7 +193,6 @@ module = [
     "gently.app.tools.timelapse_tools",
     "gently.app.tools.volume_tools",
     "gently.app.video_maker",
-    "gently.core.coordinates",
     "gently.core.event_bus",
     "gently.core.file_store",
     "gently.core.imaging",
@@ -212,8 +210,6 @@ module = [
     "gently.hardware.dispim.device_layer",
     "gently.hardware.dispim.devices.acquisition",
     "gently.hardware.dispim.devices.camera",
-    "gently.hardware.dispim.devices.optical",
-    "gently.hardware.dispim.devices.scanner",
     "gently.hardware.dispim.devices.test_temperature_controller",
     "gently.hardware.dispim.plans.acquisition",
     "gently.hardware.dispim.sam_detection",
@@ -226,40 +222,30 @@ module = [
     "gently.harness.memory.file_store",
     "gently.harness.memory.gap_assessment",
     "gently.harness.memory._intentions",
-    "gently.harness.memory.interface",
     "gently.harness.memory._ml_pipelines",
     "gently.harness.memory.onboarding",
     "gently.harness.memory._plans",
     "gently.harness.memory.startup_wizard",
     "gently.harness.memory._understanding",
     "gently.harness.microscope",
-    "gently.harness.plan_mode.tools.lab_context",
-    "gently.harness.plan_mode.tools.planning",
     "gently.harness.plan_mode.tools.research",
-    "gently.harness.plan_mode.tools.templates",
-    "gently.harness.plan_mode.tools.validation",
     "gently.harness.prompts.manager",
-    "gently.harness.prompts.templates",
     "gently.harness.session.interaction_logger",
     "gently.harness.session.manager",
     "gently.harness.session.timeline",
-    "gently.harness.state",
     "gently.harness.tools.registry",
     "gently.log_config",
     "gently.mesh.capability_provider",
     "gently.mesh.discovery",
     "gently.mesh.peer_client",
-    "gently.mesh.verse_map",
     "gently.ml.data_loader",
     "gently.ml.federated",
     "gently.organisms.celegans.developmental_tracker",
-    "gently.ui.web.connection_manager",
     "gently.ui.web.routes.agent_ws",
     "gently.ui.web.routes.campaigns",
     "gently.ui.web.routes.data",
     "gently.ui.web.routes.volumes",
     "gently.ui.web.routes.websocket",
-    "gently.ui.web.server",
     "gently.ui.web.strategy_snapshot",
     "launch_gently",
     "scripts.auto_label_examples",
diff --git a/scripts/gemini_stage_test.py b/scripts/gemini_stage_test.py
index d99d12db..0a9a44b1 100644
--- a/scripts/gemini_stage_test.py
+++ b/scripts/gemini_stage_test.py
@@ -67,7 +67,7 @@ def ensure_dependencies():
 # ============================================================================
 
 
-def discover_volumes(session_dir: Path, embryo_id: str = None) -> dict:
+def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict:
     """Discover volume files in a session directory."""
     if not session_dir.exists():
         return {}
@@ -258,7 +258,7 @@ def create_embryo_video(
     embryo_id: str,
     storage_path: Path,
     fps: int = 10,
-    output_path: Path = None,
+    output_path: Path | None = None,
 ) -> dict:
     """
     Create timelapse video from embryo images.
@@ -496,7 +496,7 @@ def build_stage_classification_prompt(frame_count: int, fps: int, duration_secon
 def analyze_with_gemini(
     video_path: str,
     model: str = "gemini-3-pro-preview",
-    api_key: str = None,
+    api_key: str | None = None,
     frame_count: int = 100,
     fps: int = 10,
     duration_seconds: float = 10.0,

From 06ced015e4b38c3a4e412ce719704764d0602dbd Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 23:06:22 +0100
Subject: [PATCH 080/314] Add StoreProtocol for ContextStore memory mixins, fix
 remaining type errors

The four ContextStore mixins (_intentions, _plans, _understanding,
_ml_pipelines) call methods/attributes defined on the host class or
sibling mixins (_conn, _tx, _now, _gen_id, get_plan_items,
create_campaign, etc.), which mypy couldn't see on the mixins
themselves. Add gently/harness/memory/_protocols.py declaring a
StoreProtocol with these members and have each mixin inherit from it
for typing only.

Also fixes the remaining errors this didn't cover: two untyped dict
literals in _plans.py needed explicit dict[str, Any] annotations, and
three _ml_pipelines.py methods returning an Optional lookup right
after an insert now assert the row exists.

All four mixins are now mypy-clean; removes them from the
ignore_errors override list (99 -> 95).
---
 gently/harness/memory/_intentions.py    |  3 +-
 gently/harness/memory/_ml_pipelines.py  | 16 +++++--
 gently/harness/memory/_plans.py         |  7 +--
 gently/harness/memory/_protocols.py     | 59 +++++++++++++++++++++++++
 gently/harness/memory/_understanding.py |  3 +-
 pyproject.toml                          |  4 --
 6 files changed, 79 insertions(+), 13 deletions(-)
 create mode 100644 gently/harness/memory/_protocols.py

diff --git a/gently/harness/memory/_intentions.py b/gently/harness/memory/_intentions.py
index de1e4e59..59de4048 100644
--- a/gently/harness/memory/_intentions.py
+++ b/gently/harness/memory/_intentions.py
@@ -11,6 +11,7 @@
 from datetime import datetime
 from typing import Any
 
+from ._protocols import StoreProtocol
 from .model import (
     Campaign,
     Intentions,
@@ -24,7 +25,7 @@
 logger = logging.getLogger(__name__)
 
 
-class IntentionsMixin:
+class IntentionsMixin(StoreProtocol):
     """Campaign management, projects, session intents, and planned sessions."""
 
     # ------------------------------------------------------------------
diff --git a/gently/harness/memory/_ml_pipelines.py b/gently/harness/memory/_ml_pipelines.py
index a14a2553..e15a8eb6 100644
--- a/gently/harness/memory/_ml_pipelines.py
+++ b/gently/harness/memory/_ml_pipelines.py
@@ -11,6 +11,8 @@
 import logging
 from typing import Any
 
+from ._protocols import StoreProtocol
+
 logger = logging.getLogger(__name__)
 
 ML_SCHEMA_SQL = """\
@@ -74,7 +76,7 @@
 """
 
 
-class MlPipelinesMixin:
+class MlPipelinesMixin(StoreProtocol):
     """ContextStore mixin for ML pipeline management."""
 
     def _ensure_ml_tables(self):
@@ -117,7 +119,9 @@ def create_ml_pipeline(
                     now,
                 ),
             )
-        return self.get_ml_pipeline(pipeline_id)
+        pipeline = self.get_ml_pipeline(pipeline_id)
+        assert pipeline is not None
+        return pipeline
 
     def get_ml_pipeline(self, pipeline_id: str) -> dict[str, Any] | None:
         """Get a pipeline by ID."""
@@ -227,7 +231,9 @@ def create_training_run(
                     peer_instance_id,
                 ),
             )
-        return self.get_training_run(run_id)
+        run = self.get_training_run(run_id)
+        assert run is not None
+        return run
 
     def get_training_run(self, run_id: str) -> dict[str, Any] | None:
         """Get a training run by ID."""
@@ -347,7 +353,9 @@ def save_data_assessment(
                     now,
                 ),
             )
-        return self.get_data_assessment(assessment_id)
+        assessment = self.get_data_assessment(assessment_id)
+        assert assessment is not None
+        return assessment
 
     def get_data_assessment(self, assessment_id: str) -> dict[str, Any] | None:
         """Get a data assessment by ID."""
diff --git a/gently/harness/memory/_plans.py b/gently/harness/memory/_plans.py
index 5805781a..96e4d18a 100644
--- a/gently/harness/memory/_plans.py
+++ b/gently/harness/memory/_plans.py
@@ -11,6 +11,7 @@
 from datetime import datetime
 from typing import Any
 
+from ._protocols import StoreProtocol
 from .model import (
     BenchSpec,
     ImagingSpec,
@@ -22,7 +23,7 @@
 logger = logging.getLogger(__name__)
 
 
-class PlansMixin:
+class PlansMixin(StoreProtocol):
     """Plan items, templates, snapshots, and dependency management."""
 
     # ==================================================================
@@ -474,7 +475,7 @@ def get_plan_status(self, campaign_id: str) -> dict[str, Any]:
             campaign_id=campaign_id,
             include_children=True,
         )
-        result = {
+        result: dict[str, Any] = {
             "total": len(items),
             "completed": 0,
             "in_progress": 0,
@@ -589,7 +590,7 @@ def _serialize_campaign_tree(self, campaign_id: str) -> dict:
         all_item_ids = [it.id for it in items]
         serialized_items = []
         for item in items:
-            item_data = {
+            item_data: dict[str, Any] = {
                 "type": item.type.value,
                 "title": item.title,
                 "description": item.description,
diff --git a/gently/harness/memory/_protocols.py b/gently/harness/memory/_protocols.py
new file mode 100644
index 00000000..7fddeb77
--- /dev/null
+++ b/gently/harness/memory/_protocols.py
@@ -0,0 +1,59 @@
+"""
+StoreProtocol — typing-only interface for members the memory mixins expect
+from their host class (ContextStore) and from each other.
+
+IntentionsMixin, PlansMixin, UnderstandingMixin, and MlPipelinesMixin are
+combined into ContextStore via multiple inheritance. Each mixin calls
+methods/attributes defined either on ContextStore itself (_conn, _tx, _now,
+_gen_id) or on one of the sibling mixins (e.g. PlansMixin.get_plan_items
+called from IntentionsMixin). Declaring this Protocol as a base lets mypy
+see those members without introducing a runtime dependency between mixins.
+"""
+
+import sqlite3
+from contextlib import AbstractContextManager
+from typing import Protocol
+
+from .model import Campaign, PlanItem
+
+
+class StoreProtocol(Protocol):
+    _conn: sqlite3.Connection
+
+    def _tx(self) -> AbstractContextManager[sqlite3.Connection]: ...
+
+    def _now(self) -> str: ...
+
+    def _gen_id(self) -> str: ...
+
+    def get_state(self, key: str) -> str | None: ...
+
+    def get_campaign(self, campaign_id: str) -> Campaign | None: ...
+
+    def get_root_campaigns(self, status: str | None = "active") -> list[Campaign]: ...
+
+    def get_subcampaigns(self, campaign_id: str) -> list[Campaign]: ...
+
+    def create_campaign(
+        self,
+        description: str,
+        shorthand: str | None = None,
+        summary: str | None = None,
+        target: str | None = None,
+        parent_id: str | None = None,
+        campaign_id: str | None = None,
+    ) -> str: ...
+
+    def delete_campaign(self, campaign_id: str, cascade: bool = True) -> dict[str, int]: ...
+
+    def update_campaign_progress(self, campaign_id: str, progress: str) -> None: ...
+
+    def get_plan_items(
+        self,
+        campaign_id: str | None = None,
+        status: str | None = None,
+        type: str | None = None,
+        include_children: bool = False,
+    ) -> list[PlanItem]: ...
+
+    def _resolve_campaign_label(self, label: str) -> str | None: ...
diff --git a/gently/harness/memory/_understanding.py b/gently/harness/memory/_understanding.py
index 3e72d7eb..29cc9c9a 100644
--- a/gently/harness/memory/_understanding.py
+++ b/gently/harness/memory/_understanding.py
@@ -11,6 +11,7 @@
 import sqlite3
 from datetime import datetime
 
+from ._protocols import StoreProtocol
 from .model import (
     Attention,
     Confidence,
@@ -31,7 +32,7 @@
 logger = logging.getLogger(__name__)
 
 
-class UnderstandingMixin:
+class UnderstandingMixin(StoreProtocol):
     """Observations, expectations, watchpoints, questions, learnings,
     embryo understanding, agent state, and batch updates."""
 
diff --git a/pyproject.toml b/pyproject.toml
index bb3d5b40..8f00eacf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -221,12 +221,8 @@ module = [
     "gently.harness.memory",
     "gently.harness.memory.file_store",
     "gently.harness.memory.gap_assessment",
-    "gently.harness.memory._intentions",
-    "gently.harness.memory._ml_pipelines",
     "gently.harness.memory.onboarding",
-    "gently.harness.memory._plans",
     "gently.harness.memory.startup_wizard",
-    "gently.harness.memory._understanding",
     "gently.harness.microscope",
     "gently.harness.plan_mode.tools.research",
     "gently.harness.prompts.manager",

From 4e24a923a7bd17504543515c9fdc1b281ee90db4 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 14 Jun 2026 23:31:32 +0100
Subject: [PATCH 081/314] Type the tool-execution context dict, clearing
 gently.app.tools.* mypy overrides

Adds ctx_get(context, key) and retypes the require_* helpers in
harness/tools/helpers.py to accept context: dict | None and return
non-Optional success values, eliminating the dominant union-attr/arg-type
pattern across the tool modules. Applies the same fix to memory_tools'
local _get_memory and a handful of independent var-annotated/type issues.

Removes all 16 gently.app.tools.* modules from the mypy override list
(95 -> 79), cutting the underlying error count from 610 to 369.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 gently/app/tools/acquisition_tools.py  | 14 ++++----
 gently/app/tools/calibration_tools.py  | 14 ++++----
 gently/app/tools/detection_tools.py    | 19 +++++------
 gently/app/tools/focus_tools.py        |  9 +++---
 gently/app/tools/led_tools.py          |  5 +--
 gently/app/tools/light_source_tools.py |  6 ++--
 gently/app/tools/memory_tools.py       |  2 +-
 gently/app/tools/resolution_tools.py   | 11 +++----
 gently/app/tools/session_tools.py      |  4 +--
 gently/app/tools/stage_tools.py        | 10 +++---
 gently/app/tools/temperature_tools.py  |  5 +--
 gently/app/tools/timelapse_tools.py    |  5 +--
 gently/app/tools/volume_tools.py       |  8 ++---
 gently/harness/tools/helpers.py        | 44 +++++++++++++++++++-------
 pyproject.toml                         | 16 ----------
 15 files changed, 91 insertions(+), 81 deletions(-)

diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index 83a2deae..8efcef79 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -9,7 +9,7 @@
 
 import numpy as np
 
-from gently.harness.tools.helpers import get_embryo_or_error
+from gently.harness.tools.helpers import ctx_get, get_embryo_or_error
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
@@ -48,8 +48,8 @@ async def acquire_volume(
     context: dict | None = None,
 ) -> str:
     """Acquire single volume - moves to embryo first, uses calibration"""
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return "Error: No agent context"
@@ -244,8 +244,8 @@ async def capture_lightsheet(
     context: dict | None = None,
 ) -> str:
     """Capture and optionally display a single lightsheet image"""
-    client = context.get("client")
-    agent = context.get("agent")
+    client = ctx_get(context, "client")
+    agent = ctx_get(context, "agent")
 
     try:
         embryo = None
@@ -357,8 +357,8 @@ async def capture_lightsheet(
 )
 async def batch_lightsheet(galvo_position: float = 0.0, context: dict | None = None) -> str:
     """Capture lightsheet images from all embryos and show them in the web UI"""
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent or not client:
         return "Error: Agent or microscope not available"
diff --git a/gently/app/tools/calibration_tools.py b/gently/app/tools/calibration_tools.py
index 5769cee1..3db84e79 100644
--- a/gently/app/tools/calibration_tools.py
+++ b/gently/app/tools/calibration_tools.py
@@ -14,7 +14,7 @@
 
 from gently.analysis.core import AdaptiveSweepState, FitFunction, fit_focus_curve  # noqa: E402
 from gently.harness.state import CalibrationPrior  # noqa: E402
-from gently.harness.tools.helpers import get_embryo_or_error  # noqa: E402
+from gently.harness.tools.helpers import ctx_get, get_embryo_or_error  # noqa: E402
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool  # noqa: E402
 from gently.ui.web.plots import (  # noqa: E402
     generate_calibration_summary_plot,
@@ -462,7 +462,7 @@ async def hybrid_focus_selection(
     agent,
     embryo_id: str,
     fft_confidence_threshold: float = 0.85,
-) -> tuple[int, str, float]:
+) -> tuple[int, str, float | None]:
     """
     Two-stage focus selection: FFT first, Vision if ambiguous.
 
@@ -696,8 +696,8 @@ async def fast_calibrate_embryo(
     """
     from gently.hardware.dispim.claude_client import AsyncClaudeClient
 
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return False, "Error: No agent context", 0
@@ -999,8 +999,8 @@ async def calibrate_embryo(
     from gently.analysis.core import calculate_focus_score
     from gently.hardware.dispim.claude_client import AsyncClaudeClient
 
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return "Error: No agent context"
@@ -1402,7 +1402,7 @@ async def calibrate_all_embryos(
     context: dict | None = None,
 ) -> str:
     """Calibrate all embryos sequentially with Claude vision"""
-    agent = context.get("agent")
+    agent = ctx_get(context, "agent")
 
     if not agent:
         return "Error: No agent context"
diff --git a/gently/app/tools/detection_tools.py b/gently/app/tools/detection_tools.py
index b821ec72..fd7d826b 100644
--- a/gently/app/tools/detection_tools.py
+++ b/gently/app/tools/detection_tools.py
@@ -21,6 +21,7 @@
     pixel_to_stage_position,
     stage_to_pixel_position,
 )
+from gently.harness.tools.helpers import ctx_get
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
@@ -48,7 +49,7 @@ async def _route_to_map_view(
     marked = await mark_embryos_web(
         viz_server=agent.viz_server,
         image=image,
-        initial_stage_position=tuple(stage_position),
+        initial_stage_position=stage_position,
         pixel_size_um=pixel_size_um,
         initial_markers=initial_markers,
         default_role=default_role,
@@ -121,8 +122,8 @@ async def detect_embryos(
     context: dict | None = None,
 ) -> str:
     """Detect embryos via SAM + edit/assign roles in the web map view."""
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return "Error: No agent context"
@@ -240,7 +241,7 @@ async def detect_embryos(
                 except Exception:
                     pass
 
-        role_counts = {}
+        role_counts: dict[str, int] = {}
         for _, r in added:
             role_counts[r] = role_counts.get(r, 0) + 1
         role_summary = ", ".join(f"{n} {r}" for r, n in sorted(role_counts.items()))
@@ -281,8 +282,8 @@ async def manual_mark_embryos(
     context: dict | None = None,
 ) -> str:
     """Manual marking via the web map view."""
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return "Error: No agent context"
@@ -420,7 +421,7 @@ async def edit_embryos(
     context: dict | None = None,
 ) -> str:
     """Edit existing embryos via the web map view."""
-    agent = context.get("agent")
+    agent = ctx_get(context, "agent")
     if not agent:
         return "Error: No agent context"
     if not agent.experiment.embryos:
@@ -452,8 +453,8 @@ async def edit_embryos(
 )
 async def show_detected_embryos(save_to_file: bool = True, context: dict | None = None) -> str:
     """Show detected embryos visualization using experiment.embryos as source of truth"""
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return "Error: No agent context"
diff --git a/gently/app/tools/focus_tools.py b/gently/app/tools/focus_tools.py
index cef6ca81..11769eb4 100644
--- a/gently/app/tools/focus_tools.py
+++ b/gently/app/tools/focus_tools.py
@@ -22,6 +22,7 @@
     calculate_focus_score,
     fit_focus_curve,
 )
+from gently.harness.tools.helpers import ctx_get
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
@@ -82,8 +83,8 @@ async def fine_focus(
     context : dict
         Execution context with client and agent
     """
-    client = context.get("client")
-    agent = context.get("agent")
+    client = ctx_get(context, "client")
+    agent = ctx_get(context, "agent")
 
     if not client:
         return "Error: No microscope client connected"
@@ -253,7 +254,7 @@ async def get_focus_score(
     context : dict
         Execution context
     """
-    client = context.get("client")
+    client = ctx_get(context, "client")
 
     if not client:
         return "Error: No microscope client connected"
@@ -315,7 +316,7 @@ async def get_focus_history(embryo_id: str, context: dict | None = None) -> str:
     context : dict
         Execution context with agent
     """
-    agent = context.get("agent")
+    agent = ctx_get(context, "agent")
 
     if not agent:
         return "Error: No agent context available"
diff --git a/gently/app/tools/led_tools.py b/gently/app/tools/led_tools.py
index 92aac49c..df02a8ae 100644
--- a/gently/app/tools/led_tools.py
+++ b/gently/app/tools/led_tools.py
@@ -4,6 +4,7 @@
 Tools for controlling microscope LED illumination.
 """
 
+from gently.harness.tools.helpers import ctx_get
 from gently.harness.tools.registry import ToolCategory, tool
 
 
@@ -15,7 +16,7 @@
 )
 async def set_led(state: str, context: dict) -> str:
     """Set LED state"""
-    client = context.get("client")
+    client = ctx_get(context, "client")
 
     try:
         result = await client.set_led(state)
@@ -35,7 +36,7 @@ async def set_led(state: str, context: dict) -> str:
 )
 async def get_led_status(context: dict) -> str:
     """Get LED status"""
-    client = context.get("client")
+    client = ctx_get(context, "client")
 
     try:
         result = await client.get_led_status()
diff --git a/gently/app/tools/light_source_tools.py b/gently/app/tools/light_source_tools.py
index 065b981f..a190b929 100644
--- a/gently/app/tools/light_source_tools.py
+++ b/gently/app/tools/light_source_tools.py
@@ -14,7 +14,7 @@
 ``modify_parameters(embryo_id, {"laser_power_488_pct": ...}, ...)``.
 """
 
-from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.helpers import ctx_get, require_agent
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
@@ -49,7 +49,7 @@ async def set_laser_power(
     agent, err = require_agent(context)
     if err:
         return err
-    client = context.get("client")
+    client = ctx_get(context, "client")
     if not client:
         return "Error: Microscope not connected."
 
@@ -93,7 +93,7 @@ async def get_laser_power(
     agent, err = require_agent(context)
     if err:
         return err
-    client = context.get("client")
+    client = ctx_get(context, "client")
     if not client:
         return "Error: Microscope not connected."
 
diff --git a/gently/app/tools/memory_tools.py b/gently/app/tools/memory_tools.py
index 0c0306e2..d58d3e5d 100644
--- a/gently/app/tools/memory_tools.py
+++ b/gently/app/tools/memory_tools.py
@@ -7,7 +7,7 @@
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
-def _get_memory(context: dict):
+def _get_memory(context: dict | None):
     """Extract AgentMemory from tool context."""
     agent = context.get("agent") if context else None
     if not agent or not hasattr(agent, "memory") or not agent.memory:
diff --git a/gently/app/tools/resolution_tools.py b/gently/app/tools/resolution_tools.py
index f5a6c19f..c3a152da 100644
--- a/gently/app/tools/resolution_tools.py
+++ b/gently/app/tools/resolution_tools.py
@@ -20,6 +20,8 @@
 """
 
 import logging
+from types import SimpleNamespace
+from typing import Any
 
 from gently.harness.tools.helpers import require_agent
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
@@ -389,10 +391,7 @@ async def apply_plan_acquisition_spec(
         for embryo in experiment.embryos.values():
             # Build an "effective" spec respecting overrides — copy then
             # zero out any field the caller asked us to skip.
-            class _Filtered:
-                pass
-
-            eff = _Filtered()
+            eff = SimpleNamespace()
             eff.num_slices = (
                 None
                 if "num_slices" in overrides and overrides["num_slices"] is None
@@ -554,10 +553,10 @@ async def recall_sibling_sessions(
         sid = getattr(item, "session_id", None)
         if not sid:
             continue
-        meta = {}
+        meta: dict[str, Any] = {}
         if file_store is not None:
             try:
-                meta = file_store.get_session(sid) or {}
+                meta = dict(file_store.get_session(sid) or {})
             except Exception:
                 meta = {}
         sessions.append(
diff --git a/gently/app/tools/session_tools.py b/gently/app/tools/session_tools.py
index bfe79988..5490c8bc 100644
--- a/gently/app/tools/session_tools.py
+++ b/gently/app/tools/session_tools.py
@@ -262,8 +262,8 @@ def analyze_corrections(limit: int = 50, context: dict | None = None) -> str:
         "",
     ]
 
-    indicator_counts = {}
-    tool_corrections = {}
+    indicator_counts: dict[str, int] = {}
+    tool_corrections: dict[str, int] = {}
 
     for corr in corrections[:limit]:
         for indicator in corr.correction_indicators:
diff --git a/gently/app/tools/stage_tools.py b/gently/app/tools/stage_tools.py
index 39f433f3..c4e9ab55 100644
--- a/gently/app/tools/stage_tools.py
+++ b/gently/app/tools/stage_tools.py
@@ -4,7 +4,7 @@
 Tools for controlling microscope XY stage movement.
 """
 
-from gently.harness.tools.helpers import get_embryo_or_error
+from gently.harness.tools.helpers import ctx_get, get_embryo_or_error
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
@@ -24,8 +24,8 @@
 )
 async def move_to_embryo(embryo_id: str, context: dict) -> str:
     """Move stage to embryo position"""
-    agent = context.get("agent")
-    client = context.get("client")
+    agent = ctx_get(context, "agent")
+    client = ctx_get(context, "client")
 
     if not agent:
         return "Error: No agent context"
@@ -66,7 +66,7 @@ async def move_to_embryo(embryo_id: str, context: dict) -> str:
 )
 async def get_stage_position(context: dict) -> str:
     """Get current stage position"""
-    client = context.get("client")
+    client = ctx_get(context, "client")
 
     if not client:
         return "Error: No microscope client connected"
@@ -94,7 +94,7 @@ async def get_stage_position(context: dict) -> str:
 )
 async def move_stage(x: float, y: float, context: dict | None = None) -> str:
     """Move stage to arbitrary XY coordinates"""
-    client = context.get("client")
+    client = ctx_get(context, "client")
 
     if not client:
         return "Error: No microscope client connected"
diff --git a/gently/app/tools/temperature_tools.py b/gently/app/tools/temperature_tools.py
index 6e12e7e8..d9fd303c 100644
--- a/gently/app/tools/temperature_tools.py
+++ b/gently/app/tools/temperature_tools.py
@@ -6,6 +6,7 @@
 part of closed-loop experiments.
 """
 
+from gently.harness.tools.helpers import ctx_get
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
@@ -33,7 +34,7 @@ async def set_temperature(target_c: float, context: dict) -> str:
     target_c : float
         Target temperature in degrees Celsius (0.0-99.9).
     """
-    client = context.get("client")
+    client = ctx_get(context, "client")
     try:
         result = await client.set_temperature(target_c)
         if result.get("success"):
@@ -62,7 +63,7 @@ async def set_temperature(target_c: float, context: dict) -> str:
 )
 async def get_temperature(context: dict) -> str:
     """Read current temperature, setpoint, and lock state."""
-    client = context.get("client")
+    client = ctx_get(context, "client")
     try:
         r = await client.get_temperature()
         if r.get("success"):
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index c794b9ac..d5ec3d76 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -5,6 +5,7 @@
 """
 
 from gently.harness.tools.helpers import (
+    ctx_get,
     get_embryo_or_error,
     require_agent,
     require_developmental_tracker,
@@ -26,7 +27,7 @@ async def generate_bluesky_plan(
     context: dict | None = None,
 ) -> str:
     """Generate Bluesky plan"""
-    agent = context.get("agent")
+    agent = ctx_get(context, "agent")
 
     if not agent:
         return "Error: No agent context"
@@ -966,7 +967,7 @@ def get_photodose_status(context: dict | None = None) -> str:
     if err:
         return err
     base = getattr(orchestrator, "_dose_budget_base_ms", None)
-    exceeded = getattr(orchestrator, "_dose_budget_exceeded", set()) or set()
+    exceeded: set[str] = getattr(orchestrator, "_dose_budget_exceeded", set()) or set()
     states = getattr(orchestrator, "_embryo_states", {}) or {}
     if base is None:
         lines = ["Photodose budget: DISABLED (no cap).", ""]
diff --git a/gently/app/tools/volume_tools.py b/gently/app/tools/volume_tools.py
index 02f1afd0..dd05cec5 100644
--- a/gently/app/tools/volume_tools.py
+++ b/gently/app/tools/volume_tools.py
@@ -7,7 +7,7 @@
 import logging
 
 from gently.core.coordinates import get_um_per_pixel, stage_to_pixel_position
-from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.helpers import ctx_get, require_agent
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
@@ -36,8 +36,8 @@ async def view_image(
     context: dict | None = None,
 ) -> str:
     """Capture and display bottom camera image with embryo annotations"""
-    client = context.get("client")
-    agent = context.get("agent")
+    client = ctx_get(context, "client")
+    agent = ctx_get(context, "agent")
 
     try:
         snap = await client.capture_bottom_image(exposure_ms=exposure_ms)
@@ -252,7 +252,7 @@ async def list_volumes(embryo_id: str | None = None, context: dict | None = None
     all_volumes_list = agent.store.list_volumes(session_id, embryo_id)
 
     # Group by embryo_id
-    all_volumes = {}  # embryo_id -> list of volume records
+    all_volumes: dict[str, list[dict]] = {}  # embryo_id -> list of volume records
     for vol in all_volumes_list:
         eid = vol["embryo_id"]
         if eid not in all_volumes:
diff --git a/gently/harness/tools/helpers.py b/gently/harness/tools/helpers.py
index fa98cf62..b4c58f39 100644
--- a/gently/harness/tools/helpers.py
+++ b/gently/harness/tools/helpers.py
@@ -9,13 +9,35 @@
 from typing import Any
 
 
-def require_agent(context: dict) -> tuple[Any | None, str | None]:
+def ctx_get(context: dict | None, key: str) -> Any:
+    """
+    Look up a key in a (possibly missing) tool execution context
+
+    Parameters
+    ----------
+    context : dict | None
+        Tool execution context
+    key : str
+        Key to look up
+
+    Returns
+    -------
+    Any
+        The value for ``key``, or ``None`` if ``context`` is ``None`` or
+        the key is absent.
+    """
+    if context is None:
+        return None
+    return context.get(key)
+
+
+def require_agent(context: dict | None) -> tuple[Any, str | None]:
     """
     Extract agent from context or return error message
 
     Parameters
     ----------
-    context : dict
+    context : dict | None
         Tool execution context
 
     Returns
@@ -23,13 +45,13 @@ def require_agent(context: dict) -> tuple[Any | None, str | None]:
     tuple
         (agent, None) if found, (None, error_message) if not
     """
-    agent = context.get("agent")
+    agent = ctx_get(context, "agent")
     if not agent:
         return None, "Error: No agent context"
     return agent, None
 
 
-def get_embryo_or_error(agent, embryo_id: str) -> tuple[Any | None, str | None]:
+def get_embryo_or_error(agent, embryo_id: str) -> tuple[Any, str | None]:
     """
     Get embryo by any name or return error message
 
@@ -51,13 +73,13 @@ def get_embryo_or_error(agent, embryo_id: str) -> tuple[Any | None, str | None]:
     return embryo, None
 
 
-def require_microscope(context: dict) -> tuple[Any | None, str | None]:
+def require_microscope(context: dict | None) -> tuple[Any, str | None]:
     """
     Get microscope client from context or return error message
 
     Parameters
     ----------
-    context : dict
+    context : dict | None
         Tool execution context
 
     Returns
@@ -65,13 +87,13 @@ def require_microscope(context: dict) -> tuple[Any | None, str | None]:
     tuple
         (client, None) if connected, (None, error_message) if not
     """
-    client = context.get("client")
+    client = ctx_get(context, "client")
     if not client:
         return None, "Not connected to microscope. Use connect_microscope first."
     return client, None
 
 
-def require_interaction_logger(agent) -> tuple[Any | None, str | None]:
+def require_interaction_logger(agent) -> tuple[Any, str | None]:
     """
     Get interaction logger or return error message
 
@@ -90,7 +112,7 @@ def require_interaction_logger(agent) -> tuple[Any | None, str | None]:
     return agent.interaction_logger, None
 
 
-def require_developmental_tracker(agent) -> tuple[Any | None, str | None]:
+def require_developmental_tracker(agent) -> tuple[Any, str | None]:
     """
     Get developmental tracker or return error message
 
@@ -112,7 +134,7 @@ def require_developmental_tracker(agent) -> tuple[Any | None, str | None]:
     return agent.developmental_tracker, None
 
 
-def require_timelapse_orchestrator(agent) -> tuple[Any | None, str | None]:
+def require_timelapse_orchestrator(agent) -> tuple[Any, str | None]:
     """
     Get timelapse orchestrator or return error message
 
@@ -131,7 +153,7 @@ def require_timelapse_orchestrator(agent) -> tuple[Any | None, str | None]:
     return agent.timelapse_orchestrator, None
 
 
-def require_databroker(agent) -> tuple[Any | None, str | None]:
+def require_databroker(agent) -> tuple[Any, str | None]:
     """
     Get databroker connection or return error message
 
diff --git a/pyproject.toml b/pyproject.toml
index 8f00eacf..4b5c78f1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -176,22 +176,6 @@ module = [
     "gently.app.calibration.edge_roi",
     "gently.app.detectors.dopaminergic_signal",
     "gently.app.orchestration.timelapse",
-    "gently.app.tools.acquisition_tools",
-    "gently.app.tools.analysis_tools",
-    "gently.app.tools.calibration_tools",
-    "gently.app.tools.detection_tools",
-    "gently.app.tools.experiment_tools",
-    "gently.app.tools.focus_tools",
-    "gently.app.tools.led_tools",
-    "gently.app.tools.light_source_tools",
-    "gently.app.tools.memory_tools",
-    "gently.app.tools.plan_execution_tools",
-    "gently.app.tools.resolution_tools",
-    "gently.app.tools.session_tools",
-    "gently.app.tools.stage_tools",
-    "gently.app.tools.temperature_tools",
-    "gently.app.tools.timelapse_tools",
-    "gently.app.tools.volume_tools",
     "gently.app.video_maker",
     "gently.core.event_bus",
     "gently.core.file_store",

From b6d9e598d0805fe0f7233a82ef14bf622cf8aad1 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Mon, 15 Jun 2026 01:08:10 +0100
Subject: [PATCH 082/314] Address PR #48 review findings: fix view_image
 None-client crash and remaining type gaps

- volume_tools.view_image: guard against a disconnected microscope client
  via require_microscope() instead of crashing on client.capture_bottom_image()
- file_store/store register_volume: volume_data: np.ndarray = None ->
  np.ndarray | None = None (implicit-Optional missed in the earlier pass)
- StoreProtocol: mark @runtime_checkable for consistency with
  gently.harness.protocols
- TimelapseOrchestrator.start: embryo_ids: list[str] -> list[str] | None = None
  to match its actual None-handling and the docstring

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 gently/app/orchestration/timelapse.py | 2 +-
 gently/app/tools/volume_tools.py      | 6 ++++--
 gently/core/file_store.py             | 2 +-
 gently/core/store.py                  | 2 +-
 gently/harness/memory/_protocols.py   | 3 ++-
 5 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index 5d0783e4..f4a2692a 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -195,7 +195,7 @@ def __init__(
 
     async def start(
         self,
-        embryo_ids: list[str],
+        embryo_ids: list[str] | None = None,
         stop_condition: str = "manual",
         base_interval_seconds: float = 120.0,
         condition_value: Any = None,
diff --git a/gently/app/tools/volume_tools.py b/gently/app/tools/volume_tools.py
index dd05cec5..3a9d3d5c 100644
--- a/gently/app/tools/volume_tools.py
+++ b/gently/app/tools/volume_tools.py
@@ -7,7 +7,7 @@
 import logging
 
 from gently.core.coordinates import get_um_per_pixel, stage_to_pixel_position
-from gently.harness.tools.helpers import ctx_get, require_agent
+from gently.harness.tools.helpers import ctx_get, require_agent, require_microscope
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 logger = logging.getLogger(__name__)
@@ -36,7 +36,9 @@ async def view_image(
     context: dict | None = None,
 ) -> str:
     """Capture and display bottom camera image with embryo annotations"""
-    client = ctx_get(context, "client")
+    client, err = require_microscope(context)
+    if err:
+        return err
     agent = ctx_get(context, "agent")
 
     try:
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 8cd23095..5a8b7f01 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -656,7 +656,7 @@ def register_volume(
         timepoint: int,
         incoming_path: Path,
         metadata: dict | None = None,
-        volume_data: np.ndarray = None,
+        volume_data: np.ndarray | None = None,
     ) -> Path:
         """
         Zero-copy path: move an existing TIFF to its canonical location.
diff --git a/gently/core/store.py b/gently/core/store.py
index d33764da..6a60a202 100644
--- a/gently/core/store.py
+++ b/gently/core/store.py
@@ -492,7 +492,7 @@ def register_volume(
         timepoint: int,
         incoming_path: Path,
         metadata: dict | None = None,
-        volume_data: np.ndarray = None,
+        volume_data: np.ndarray | None = None,
     ) -> Path:
         """
         Zero-copy path: rename an existing TIFF to canonical location.
diff --git a/gently/harness/memory/_protocols.py b/gently/harness/memory/_protocols.py
index 7fddeb77..16162a29 100644
--- a/gently/harness/memory/_protocols.py
+++ b/gently/harness/memory/_protocols.py
@@ -12,11 +12,12 @@
 
 import sqlite3
 from contextlib import AbstractContextManager
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from .model import Campaign, PlanItem
 
 
+@runtime_checkable
 class StoreProtocol(Protocol):
     _conn: sqlite3.Connection
 

From 7da8443d5f23ed3a9e5cf08fdd04abf8a7ad9a77 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 04:13:07 +0530
Subject: [PATCH 083/314] mypy: pin to 2.1.0 across CI/pre-commit/dev; fix
 missed implicit-Optional
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CI installed mypy unpinned (`pip install mypy`) while the pre-commit hook
pinned mirrors-mypy v2.1.0, so the two would diverge the moment a newer
mypy released — "passes my pre-commit" would stop implying "passes CI".
Pin all three sources to 2.1.0 (CI install, pyproject dev group, and the
pre-commit rev) and cross-reference them so they move together.

Also convert the one implicit-Optional missed in Phase 1: `view_image`'s
`image: np.ndarray = None` in dispim/client.py (the other three params in
that same signature were already converted).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .github/workflows/lint.yml       | 4 +++-
 .pre-commit-config.yaml          | 4 +++-
 gently/hardware/dispim/client.py | 2 +-
 pyproject.toml                   | 5 ++++-
 4 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 58d2538e..d11c7f22 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -25,8 +25,10 @@ jobs:
       - name: ruff format check
         run: ruff format --check .
 
+      # Pin to match the pre-commit mirrors-mypy rev and the pyproject dev
+      # group so CI, local commits, and `uv sync` never run different mypys.
       - name: Install mypy
-        run: pip install mypy
+        run: pip install mypy==2.1.0
 
       - name: mypy
         run: mypy .
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7f6f8bdf..88476e0c 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -7,7 +7,9 @@ repos:
       - id: ruff-format
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v2.1.0  # run `pre-commit autoupdate` to pin to latest
+    # Keep in sync with the mypy pin in pyproject.toml dev group and
+    # .github/workflows/lint.yml. Run `pre-commit autoupdate` to bump.
+    rev: v2.1.0
     hooks:
       - id: mypy
         pass_filenames: false
diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 9401fd37..2e4567e1 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -1113,7 +1113,7 @@ async def _get_detection_image(
 
     async def view_image(
         self,
-        image: np.ndarray = None,
+        image: np.ndarray | None = None,
         title: str = "Image View",
         exposure_ms: float | None = None,
         save_path: str | None = None,
diff --git a/pyproject.toml b/pyproject.toml
index 4b5c78f1..d2a0c9a4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -94,7 +94,10 @@ dev = [
     "pytest-asyncio>=0.21.0",
     "ruff>=0.4.0",
     "pre-commit>=3.7.0",
-    "mypy>=1.8.0",
+    # Pinned so local runs, the pre-commit hook, and CI all use the same
+    # mypy. Keep in sync with the mirrors-mypy rev in .pre-commit-config.yaml
+    # and the install step in .github/workflows/lint.yml.
+    "mypy==2.1.0",
 ]
 
 [project.scripts]

From 4530ab130d47456a626d12268f2da2438aafc20b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 03:03:46 +0530
Subject: [PATCH 084/314] UX v2 Phase 0: unify connection status across the
 three indicators
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The header pill, the home landing line, and the agent dock each computed
connection state from their own signal at their own time. home.js read
state.connected exactly once at tab init — before the /ws handshake — and
never corrected, so the landing showed "Offline — start the agent to
connect" while the header pill showed "Online" and state.connected was true.

Add a single sticky ConnectionStatus store (status-store.js) holding three
distinct signals — gentlyConnected (/ws), microscopeConnected
(/api/device-status poll), agentConnected (/ws/agent) — which replays its
current snapshot to every new subscriber, so a late subscriber can never
miss the initial state (the root of the bug). All three surfaces now read
from / write to this store:
- websocket.js onopen/onclose -> setGently (via updateGentlyStatus)
- app.js fetchDeviceStatus -> setMicroscope; header renders via subscriber
- home.js updateStatus reads the store and re-renders on every change
- agent-chat.js setConn -> setAgent

Verified live: after reload the home line and header pill agree (no more
"Offline while Online"); no console errors.

Bug #3 (idle event-count inflation) needs no code change: the high-frequency
telemetry (DEVICE_STATE_UPDATE/BOTTOM_CAMERA_FRAME) is already excluded from
the events table + count at websocket.js, and idle measurement showed the
count is calm and dominated by LOG_RECORD.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/static/js/agent-chat.js   |  2 +
 gently/ui/web/static/js/app.js          | 37 ++++++++++++-----
 gently/ui/web/static/js/home.js         | 14 ++++++-
 gently/ui/web/static/js/status-store.js | 54 +++++++++++++++++++++++++
 gently/ui/web/templates/index.html      |  1 +
 5 files changed, 96 insertions(+), 12 deletions(-)
 create mode 100644 gently/ui/web/static/js/status-store.js

diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 63339b92..620c9d60 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -636,6 +636,8 @@ const AgentChat = (() => {
         conn.classList.toggle('ac-conn-bad', !ok);
         conn.textContent = label || (ok ? 'Connected' : 'Reconnecting…');
         if (toggleDot) toggleDot.classList.toggle('ok', ok);
+        // Feed the shared connection store (agent /ws/agent liveness).
+        if (typeof ConnectionStatus !== 'undefined') ConnectionStatus.setAgent(ok);
     }
 
     // ── Transport ─────────────────────────────────────────────
diff --git a/gently/ui/web/static/js/app.js b/gently/ui/web/static/js/app.js
index d1e75a72..3395c89b 100644
--- a/gently/ui/web/static/js/app.js
+++ b/gently/ui/web/static/js/app.js
@@ -538,11 +538,13 @@ function fetchDeviceStatus() {
         .then(r => r.json())
         .then(data => {
             _microscopeConnected = data.microscope;
-            _setBadge('status-microscope-badge', data.microscope, 'Online', 'Offline');
-            updateTopLevelDot();
+            ConnectionStatus.setMicroscope(data.microscope);
         })
         .catch(() => {
-            _setBadge('status-microscope-badge', false, '', '--');
+            // Transient poll failure: keep the last-known badge. The next
+            // successful poll re-renders via the store if the value changed
+            // (writing '--' here could stick, since the store only re-renders
+            // on an actual change, not on an unchanged success).
         });
 }
 
@@ -555,23 +557,26 @@ function _setBadge(id, isOn, onText, offText) {
 }
 
 function updateGentlyStatus(connected) {
-    _setBadge('status-gently-badge', connected, 'Online', 'Offline');
-    updateTopLevelDot();
+    // Feed the single source of truth; the header re-renders via the
+    // ConnectionStatus subscriber (renderConnectionUI).
+    ConnectionStatus.setGently(connected);
 }
 
-function updateTopLevelDot() {
+// Single renderer for the header connection UI, driven by a ConnectionStatus
+// snapshot. Subscribed once at startup, so the pill, both popover badges, and
+// the dot always reflect the same shared state.
+function renderConnectionUI(s) {
+    _setBadge('status-gently-badge', s.gentlyConnected, 'Online', 'Offline');
+    _setBadge('status-microscope-badge', s.microscopeConnected, 'Online', 'Offline');
     const dot = document.getElementById('status-dot');
     const text = document.getElementById('status-text');
     if (!dot || !text) return;
 
-    const gentlyUp = state.connected;
-    const scopeUp = _microscopeConnected;
-
     dot.classList.remove('connected', 'partial');
-    if (gentlyUp && scopeUp) {
+    if (s.gentlyConnected && s.microscopeConnected) {
         dot.classList.add('connected');
         text.textContent = 'Connected';
-    } else if (gentlyUp) {
+    } else if (s.gentlyConnected) {
         dot.classList.add('partial');
         text.textContent = 'Online';
     } else {
@@ -579,6 +584,11 @@ function updateTopLevelDot() {
     }
 }
 
+// Back-compat shim: any legacy caller re-renders from the current snapshot.
+function updateTopLevelDot() {
+    renderConnectionUI(ConnectionStatus.get());
+}
+
 document.addEventListener('DOMContentLoaded', () => {
     // Initialize presence manager (before WebSocket so ID is ready)
     PresenceManager.init();
@@ -620,6 +630,11 @@ document.addEventListener('DOMContentLoaded', () => {
         }
     });
 
+    // Connection status: one source of truth, three writers (this /ws, the
+    // device-status poll, and the agent /ws/agent). Subscribe the header
+    // renderer BEFORE connecting so the first handshake renders correctly.
+    ConnectionStatus.subscribe(renderConnectionUI);
+
     // Start WebSocket connection
     connectWebSocket();
 
diff --git a/gently/ui/web/static/js/home.js b/gently/ui/web/static/js/home.js
index 089d7de3..bf5cad17 100644
--- a/gently/ui/web/static/js/home.js
+++ b/gently/ui/web/static/js/home.js
@@ -136,7 +136,13 @@ const HomeApp = (() => {
     function updateStatus() {
         const el = document.getElementById('home-status');
         if (!el) return;
-        const connected = (typeof state !== 'undefined' && state.connected);
+        // Read the shared ConnectionStatus store, not a one-shot snapshot of
+        // state.connected — the latter was read once at tab init (before the
+        // /ws handshake) and never corrected, showing "Offline" while the
+        // header pill said "Online".
+        const connected = (typeof ConnectionStatus !== 'undefined')
+            ? ConnectionStatus.get().gentlyConnected
+            : (typeof state !== 'undefined' && state.connected);
         const n = (typeof state !== 'undefined' && Array.isArray(state.embryos)) ? state.embryos.length : 0;
         el.textContent = connected
             ? `Connected · ${n} embryo${n === 1 ? '' : 's'} in view`
@@ -162,6 +168,12 @@ const HomeApp = (() => {
                     if (AgentChat.runCommand) setTimeout(() => AgentChat.runCommand('/wizard'), 250);
                 }
             });
+            // Re-render the status line on every connection change. subscribe()
+            // replays the current snapshot immediately, so a late init still
+            // renders correct state. Registered once (inside the _inited guard).
+            if (typeof ConnectionStatus !== 'undefined') {
+                ConnectionStatus.subscribe(() => updateStatus());
+            }
         }
         refresh();  // re-fetch on every entry to the tab
     }
diff --git a/gently/ui/web/static/js/status-store.js b/gently/ui/web/static/js/status-store.js
new file mode 100644
index 00000000..0e50dd30
--- /dev/null
+++ b/gently/ui/web/static/js/status-store.js
@@ -0,0 +1,54 @@
+/**
+ * ConnectionStatus — the single source of truth for connection liveness.
+ *
+ * Fixes the "three disagreeing indicators" bug where the header pill, the home
+ * landing line, and the agent dock each computed connection state from their
+ * own signal at their own time (home.js read state.connected ONCE at tab init,
+ * before the /ws handshake, and never corrected — showing "Offline" while the
+ * header showed "Online").
+ *
+ * Three genuinely distinct signals (kept separate, not flattened):
+ *   - gentlyConnected     : the main /ws telemetry socket          (websocket.js)
+ *   - microscopeConnected : the /api/device-status health poll     (app.js)
+ *   - agentConnected      : the /ws/agent chat socket              (agent-chat.js)
+ *
+ * Writers call set*(); readers subscribe(). The store is STICKY: subscribe()
+ * immediately replays the current snapshot to the new subscriber, so a late
+ * subscriber can never miss the initial state. Events only fire on real change.
+ */
+const ConnectionStatus = (() => {
+    const s = { gentlyConnected: false, microscopeConnected: false, agentConnected: false };
+
+    function emit() {
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.emit('CONNECTION_STATUS', { ...s });
+        }
+    }
+
+    function set(key, val) {
+        val = !!val;
+        if (s[key] === val) return;   // only emit on actual change
+        s[key] = val;
+        emit();
+    }
+
+    return {
+        setGently(v) { set('gentlyConnected', v); },
+        setMicroscope(v) { set('microscopeConnected', v); },
+        setAgent(v) { set('agentConnected', v); },
+        get() { return { ...s }; },
+
+        /**
+         * Subscribe to status changes AND immediately receive the current
+         * snapshot (sticky replay). This is the guard against the original bug:
+         * a subscriber that registers after the first emit still renders from
+         * the correct current state instead of a stale default.
+         */
+        subscribe(handler) {
+            if (typeof ClientEventBus !== 'undefined') {
+                ClientEventBus.on('CONNECTION_STATUS', handler);
+            }
+            try { handler({ ...s }); } catch (e) { console.error('ConnectionStatus subscriber error', e); }
+        }
+    };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 85a60345..9aaf279a 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -616,6 +616,7 @@ <h3 class="devices-properties-title">Properties</h3>
 
     <script src="/static/js/utils.js"></script>
     <script src="/static/js/event-bus.js"></script>
+    <script src="/static/js/status-store.js"></script>
     <script src="/static/js/websocket.js"></script>
     <script src="/static/js/zoom-pan.js"></script>
     <script src="/static/js/lightbox.js"></script>

From 4571a58cba470a1e704c4fd66fa0344a80e69057 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 03:23:23 +0530
Subject: [PATCH 085/314] UX v2 Phase 1 (scaffold): add GENTLY_UX_V2 feature
 flag

Adds UISettings.ux_v2 (env GENTLY_UX_V2, default off) and threads it into
the index.html template context from pages.py. This is the coexistence
switch for the agent-first UX: the v2 markup/JS will mount only under this
flag, so the v1 dashboard stays the default and prod is unaffected while
the migration soaks behind the flag.

No behaviour change yet (flag off by default; nothing reads it client-side
until the Phase 1 dual-render lands).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/settings.py            | 11 +++++++++++
 gently/ui/web/routes/pages.py |  6 +++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/gently/settings.py b/gently/settings.py
index 68cebd38..8b16f871 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -120,6 +120,16 @@ class TransferSettings:
     )
 
 
+@dataclass(frozen=True)
+class UISettings:
+    """Web UI feature flags."""
+    # New agent-first UX paradigm (welcome→shell unfold, dual-rendered agent
+    # asks, inference-first plan mode, shared-visibility surface). Off by
+    # default; flip per-deployment via GENTLY_UX_V2=1 while the migration
+    # soaks behind the flag. The v1 dashboard stays the default until then.
+    ux_v2: bool = field(default_factory=lambda: _env("UX_V2", False))
+
+
 @dataclass(frozen=True)
 class Settings:
     """Top-level settings container."""
@@ -132,6 +142,7 @@ class Settings:
     api: ApiSettings = field(default_factory=ApiSettings)
     ml: MlSettings = field(default_factory=MlSettings)
     transfer: TransferSettings = field(default_factory=TransferSettings)
+    ui: UISettings = field(default_factory=UISettings)
 
 
 # Singleton — import this everywhere
diff --git a/gently/ui/web/routes/pages.py b/gently/ui/web/routes/pages.py
index 3858f4e7..04a1a959 100644
--- a/gently/ui/web/routes/pages.py
+++ b/gently/ui/web/routes/pages.py
@@ -3,6 +3,8 @@
 from fastapi import APIRouter, Request
 from fastapi.responses import HTMLResponse, RedirectResponse
 
+from gently.settings import settings
+
 
 def create_router(server) -> APIRouter:
     router = APIRouter()
@@ -16,7 +18,9 @@ async def index(request: Request):
         chat window's "Sign in" affordance), not a gate on the page itself.
         """
         return server.templates.TemplateResponse(
-            request, "index.html", {"active_section": "embryos", "is_live": True}
+            request,
+            "index.html",
+            {"active_section": "embryos", "is_live": True, "ux_v2": settings.ui.ux_v2},
         )
 
     # Standalone URLs redirect to SPA with hash fragment for tab routing

From 17e66cbfb81567dc2b69aee6c2c20ea24f4601dd Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 03:58:13 +0530
Subject: [PATCH 086/314] UX v2 Phase 1: dual-render agent asks (chat
 transcript + main stage)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The agent's structured asks (choice_request / choice_response over /ws/agent)
already ARE the one-payload protocol. This makes the SAME ask render both in
the chat transcript and prominently on a new main-stage surface (#ask-stage),
behind GENTLY_UX_V2 — the foundation for the agent-first paradigm.

Frontend only; no wire-protocol or backend change. The double-answer and
turn-wedge concerns are handled without touching the server:
- agent-chat.js renderChoice is factored into a pure buildAskCard(data, {reqId,
  isWake, hasControl, onPick}) reused by both surfaces; exported alongside
  answerChoice + a hasControl getter.
- A module-level answeredAsks Set keyed by request_id makes answering idempotent
  across both surfaces (only ONE choice_response is ever sent), so the existing
  holder-gate + _choice_futures.pop on the server stay correct and never see a
  duplicate.
- The CLEAR signal fires off the CHOICE lifecycle: answerChoice emits
  ASK_CLEARED{request_id} the instant a response is sent (NOT stream_end, which
  lands after the answer for in-turn asks and never for a cancelled turn). Both
  surfaces clear on it; '*' clears all on cancel/error/socket-drop.
- Read-only when !hasControl on both surfaces (observers can't answer), matching
  the server's holder gate — no dismiss-without-answer path, so asend can't wedge.
- Adds the free-text "Something else…" escape the web cards lacked (the bridge
  routes unknown selections to LLM resolution).

ask-stage.js (new) renders the current ask into #ask-stage via AgentChat.buildAskCard
and clears on ASK_CLEARED; no-ops unless #ask-stage is present (flag off → v1
untouched). Verified: node --check on all touched JS, Jinja parse on index.html.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/static/css/ask-stage.css |  42 ++++++++
 gently/ui/web/static/js/agent-chat.js  | 132 ++++++++++++++++++++-----
 gently/ui/web/static/js/ask-stage.js   |  53 ++++++++++
 gently/ui/web/templates/index.html     |   7 +-
 4 files changed, 211 insertions(+), 23 deletions(-)
 create mode 100644 gently/ui/web/static/css/ask-stage.css
 create mode 100644 gently/ui/web/static/js/ask-stage.js

diff --git a/gently/ui/web/static/css/ask-stage.css b/gently/ui/web/static/css/ask-stage.css
new file mode 100644
index 00000000..d706a05c
--- /dev/null
+++ b/gently/ui/web/static/css/ask-stage.css
@@ -0,0 +1,42 @@
+/* Main-stage ask surface (ux_v2): the agent's current pending ask, rendered
+   prominently outside the chat transcript. Reuses the .ac-choice card markup
+   from agent-chat.css; this file frames the stage container and adds the
+   shared free-text ("Something else…") escape styling. Only #ask-stage is
+   gated behind the flag, so loading this CSS unconditionally is harmless. */
+
+.ask-stage { margin: 14px 16px 0; }
+.ask-stage.hidden { display: none; }
+
+.ask-stage .ac-choice {
+    border: 1px solid var(--border, #e4e9f0);
+    border-radius: 14px;
+    padding: 16px 18px;
+    background: var(--surface, #fff);
+    box-shadow: 0 8px 28px rgba(15, 23, 42, .08);
+}
+.ask-stage .ac-choice-q {
+    font-size: 1.02rem;
+    font-weight: 600;
+    margin-bottom: 12px;
+}
+
+/* Free-text "Something else…" escape — present on ask cards in BOTH surfaces. */
+.ac-choice-otherwrap { margin-top: 6px; }
+.ac-choice-other.hidden,
+.ac-choice-otherform.hidden { display: none; }
+.ac-choice-otherform { display: flex; gap: 6px; align-items: center; margin-top: 4px; }
+.ac-choice-otherinput {
+    flex: 1; min-width: 0;
+    padding: 8px 10px;
+    border: 1px solid var(--border, #cbd5e1);
+    border-radius: 8px;
+    font: inherit;
+    background: var(--surface, #fff);
+    color: inherit;
+}
+.ac-choice-otherinput:focus { outline: none; border-color: var(--accent, #2f6df6); }
+.ac-choice-othergo {
+    border: 0; cursor: pointer;
+    background: var(--accent, #2f6df6); color: #fff;
+    border-radius: 8px; padding: 8px 12px; line-height: 1;
+}
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 620c9d60..c032e67a 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -16,6 +16,7 @@ const AgentChat = (() => {
 
     let panelOpen = false;
     let hasControl = true;        // optimistic until the server says otherwise
+    const answeredAsks = new Set();  // request_ids answered from EITHER surface (transcript / main stage)
     let holderLabel = null;
     let streaming = false;
     let currentAgentEl = null;    // the agent content element being streamed into
@@ -211,6 +212,8 @@ const AgentChat = (() => {
                 hasControl = !!msg.you_have_control;
                 holderLabel = msg.holder_label || null;
                 renderControl();
+                // The main-stage ask renderer re-renders read-only on control loss.
+                if (typeof ClientEventBus !== 'undefined') ClientEventBus.emit('AGENT_CONTROL', { hasControl });
                 break;
 
             case 'history':
@@ -342,6 +345,7 @@ const AgentChat = (() => {
                 hideActivity();
                 setBusy(false);
                 addSystemLine(msg.error || 'Unknown error', 'error');
+                clearPendingAsks();  // a cancelled/errored turn sends no choice_response
                 break;
 
             case 'ping':
@@ -353,12 +357,19 @@ const AgentChat = (() => {
         }
     }
 
-    function renderChoice(msg) {
-        const data = msg.choice_data || {};
-        const reqId = msg.request_id || data.request_id || '';
-        const isWake = msg.origin === 'wake';
+    // Build an ask card from a choice_data payload. Pure: the caller supplies
+    // hasControl + onPick, so the SAME builder renders in the chat transcript
+    // and on the main stage (#ask-stage) — one payload, two renderers.
+    function buildAskCard(data, opts) {
+        opts = opts || {};
+        const reqId = opts.reqId || '';
+        const isWake = !!opts.isWake;
+        const canAct = !!opts.hasControl && !answeredAsks.has(reqId);
+        const onPick = opts.onPick || function () {};
+
         const wrap = document.createElement('div');
         wrap.className = 'ac-choice' + (isWake ? ' ac-choice-wake' : '');
+        wrap.dataset.reqId = reqId;
         if (isWake) {
             const tag = document.createElement('div');
             tag.className = 'ac-choice-origin';
@@ -373,30 +384,101 @@ const AgentChat = (() => {
         (data.options || []).forEach(opt => {
             const btn = document.createElement('button');
             btn.className = 'ac-choice-opt';
-            btn.disabled = !!opt.disabled || !hasControl;  // observers see it read-only
+            btn.disabled = !!opt.disabled || !canAct;  // observers / already-answered → read-only
             const desc = opt.description ? `<span class="ac-choice-desc">${escapeHtml(opt.description)}</span>` : '';
             btn.innerHTML = `<span class="ac-choice-label">${escapeHtml(opt.label)}</span>${desc}`;
-            btn.addEventListener('click', () => {
-                send({ type: 'choice_response', request_id: reqId, selected: opt.id });
-                [...wrap.querySelectorAll('button')].forEach(b => b.disabled = true);
-                wrap.classList.add('ac-choice-answered');
-                btn.classList.add('ac-choice-picked');
-                if (streaming) setActivity('Working…');
-                if (isWake && pendingSlot) {
-                    setTimeout(() => { pendingSlot.classList.add('hidden'); pendingSlot.innerHTML = ''; }, 700);
-                }
-            });
+            btn.addEventListener('click', () => onPick(opt.id));
             wrap.appendChild(btn);
         });
-        // ASK approvals pin to the sticky slot above the composer so they can't
-        // scroll out of reach; ordinary choices stay inline in the transcript.
+
+        // Free-text escape — the bridge routes an unknown selection to LLM
+        // resolution, so the agent's asend always unblocks. (The TUI had this;
+        // the web ask cards previously did not.)
+        if (canAct) {
+            const ow = document.createElement('div');
+            ow.className = 'ac-choice-otherwrap';
+            const otherBtn = document.createElement('button');
+            otherBtn.className = 'ac-choice-opt ac-choice-other';
+            otherBtn.innerHTML = '<span class="ac-choice-label">Something else…</span>';
+            const form = document.createElement('div');
+            form.className = 'ac-choice-otherform hidden';
+            const ti = document.createElement('input');
+            ti.type = 'text';
+            ti.className = 'ac-choice-otherinput';
+            ti.placeholder = 'Type your own answer…';
+            const go = document.createElement('button');
+            go.className = 'ac-choice-othergo';
+            go.textContent = '→';
+            const submitOther = () => { const v = ti.value.trim(); if (v) onPick(v); };
+            otherBtn.addEventListener('click', () => { otherBtn.classList.add('hidden'); form.classList.remove('hidden'); ti.focus(); });
+            go.addEventListener('click', submitOther);
+            ti.addEventListener('keydown', e => { if (e.key === 'Enter') { e.preventDefault(); submitOther(); } });
+            form.appendChild(ti); form.appendChild(go);
+            ow.appendChild(otherBtn); ow.appendChild(form);
+            wrap.appendChild(ow);
+        }
+
+        if (answeredAsks.has(reqId)) wrap.classList.add('ac-choice-answered');
+        return wrap;
+    }
+
+    // Send the answer ONCE (idempotent across both surfaces), then fire the
+    // clear off the CHOICE lifecycle — NOT stream_end (which lands after the
+    // answer for in-turn asks, and never for a cancelled turn).
+    function answerChoice(reqId, selected) {
+        if (!reqId || answeredAsks.has(reqId)) return;
+        answeredAsks.add(reqId);
+        send({ type: 'choice_response', request_id: reqId, selected });
+        if (streaming) setActivity('Working…');
+        if (typeof ClientEventBus !== 'undefined') ClientEventBus.emit('ASK_CLEARED', { request_id: reqId });
+    }
+
+    // Disable + mark-answered any transcript / sticky-slot ask card for this
+    // request_id ('*' = all). The main stage clears itself via its own handler.
+    function markAnswered(reqId) {
+        [log, pendingSlot].forEach(scope => {
+            if (!scope) return;
+            scope.querySelectorAll('.ac-choice').forEach(card => {
+                if (reqId !== '*' && card.dataset.reqId !== reqId) return;
+                card.querySelectorAll('button').forEach(b => b.disabled = true);
+                card.classList.add('ac-choice-answered');
+            });
+        });
+        if (pendingSlot) {
+            const slotCard = pendingSlot.querySelector('.ac-choice');
+            if (reqId === '*' || (slotCard && slotCard.dataset.reqId === reqId)) {
+                setTimeout(() => { pendingSlot.classList.add('hidden'); pendingSlot.innerHTML = ''; }, 700);
+            }
+        }
+    }
+
+    // Retire all pending asks (turn cancelled/errored, or socket dropped).
+    function clearPendingAsks() {
+        if (typeof ClientEventBus !== 'undefined') ClientEventBus.emit('ASK_CLEARED', { request_id: '*' });
+        else markAnswered('*');
+    }
+
+    function renderChoice(msg) {
+        const data = msg.choice_data || {};
+        const reqId = msg.request_id || data.request_id || '';
+        const isWake = msg.origin === 'wake';
+        const card = buildAskCard(data, {
+            reqId, isWake, hasControl,
+            onPick: (sel) => answerChoice(reqId, sel),
+        });
+        // Mirror onto the main stage (ask-stage.js renders it prominently).
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.emit('AGENT_ASK', { request_id: reqId, choice_data: data, origin: msg.origin });
+        }
+        // ASK approvals pin to the sticky slot above the composer; ordinary
+        // choices stay inline in the transcript.
         if (isWake && pendingSlot) {
             pendingSlot.innerHTML = '';
-            pendingSlot.appendChild(wrap);
+            pendingSlot.appendChild(card);
             pendingSlot.classList.remove('hidden');
             return;
         }
-        log.appendChild(wrap);
+        log.appendChild(card);
         scrollToBottom();
     }
 
@@ -655,6 +737,7 @@ const AgentChat = (() => {
             setBusy(false);
             streaming = false;
             hideActivity();
+            clearPendingAsks();  // stale asks: clear the stage on socket drop
             setTimeout(connect, reconnectDelay);
             reconnectDelay = Math.min(reconnectDelay * 2, MAX_DELAY);
         };
@@ -873,6 +956,11 @@ const AgentChat = (() => {
         if (!panel) return;  // markup not present
 
         restorePrefs();
+        // Dual-render: retire a transcript ask card when its ask is answered
+        // (from the transcript OR the main stage) or the turn is cancelled.
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('ASK_CLEARED', ({ request_id }) => markAnswered(request_id));
+        }
         if (toggleBtn) toggleBtn.addEventListener('click', () => togglePanel());
         closeBtn.addEventListener('click', () => togglePanel(false));
         if (pinBtn) pinBtn.addEventListener('click', togglePin);
@@ -914,7 +1002,7 @@ const AgentChat = (() => {
             stopBtn.className = 'ac-stop hidden';
             stopBtn.textContent = 'Stop';
             stopBtn.title = 'Stop the current turn';
-            stopBtn.addEventListener('click', () => { send({ type: 'cancel' }); setBusy(false); });
+            stopBtn.addEventListener('click', () => { send({ type: 'cancel' }); setBusy(false); clearPendingAsks(); });
             inputWrap.appendChild(stopBtn);
 
             // Sticky ASK-approval slot — above the queue + composer, never scrolls away.
@@ -951,7 +1039,7 @@ const AgentChat = (() => {
             // Escape mirrors Stop: cancel a cancellable (user) turn and clear busy
             // (a cancelled turn emits no stream_end, so clear optimistically).
             if (e.key === 'Escape' && agentBusy && busySource === 'user') {
-                e.preventDefault(); send({ type: 'cancel' }); setBusy(false);
+                e.preventDefault(); send({ type: 'cancel' }); setBusy(false); clearPendingAsks();
             }
         });
     }
@@ -966,5 +1054,5 @@ const AgentChat = (() => {
         actuallySend(text);
     }
 
-    return { togglePanel, runCommand };
+    return { togglePanel, runCommand, buildAskCard, answerChoice, hasControl: () => hasControl };
 })();
diff --git a/gently/ui/web/static/js/ask-stage.js b/gently/ui/web/static/js/ask-stage.js
new file mode 100644
index 00000000..b5e63db1
--- /dev/null
+++ b/gently/ui/web/static/js/ask-stage.js
@@ -0,0 +1,53 @@
+/**
+ * AskStage (ux_v2) — renders the agent's CURRENT pending ask prominently on the
+ * main stage, in addition to the chat transcript. One payload, two renderers:
+ * it reuses AgentChat.buildAskCard so the stage and the transcript can't drift,
+ * and answering from either surface clears both (via the ASK_CLEARED event that
+ * AgentChat fires off the CHOICE lifecycle — not stream_end, which arrives only
+ * after an in-turn answer and never for a cancelled turn).
+ *
+ * No-ops unless #ask-stage is present (gated behind GENTLY_UX_V2 in the
+ * template), so it never affects the v1 dashboard.
+ */
+const AskStage = (() => {
+    let stageEl = null;
+    let current = null;  // { reqId, data, isWake }
+
+    function clear() {
+        current = null;
+        if (stageEl) { stageEl.innerHTML = ''; stageEl.classList.add('hidden'); }
+    }
+
+    function render() {
+        if (!stageEl || !current || typeof AgentChat === 'undefined' || !AgentChat.buildAskCard) return;
+        const hasControl = AgentChat.hasControl ? AgentChat.hasControl() : true;
+        const card = AgentChat.buildAskCard(current.data, {
+            reqId: current.reqId,
+            isWake: current.isWake,
+            hasControl,
+            onPick: (sel) => AgentChat.answerChoice(current.reqId, sel),
+        });
+        stageEl.innerHTML = '';
+        stageEl.appendChild(card);
+        stageEl.classList.remove('hidden');
+    }
+
+    function init() {
+        stageEl = document.getElementById('ask-stage');
+        if (!stageEl || typeof ClientEventBus === 'undefined') return;  // ux_v2 off → no-op
+
+        ClientEventBus.on('AGENT_ASK', ({ request_id, choice_data, origin }) => {
+            current = { reqId: request_id, data: choice_data || {}, isWake: origin === 'wake' };
+            render();
+        });
+        ClientEventBus.on('ASK_CLEARED', ({ request_id }) => {
+            if (!current) return;
+            if (request_id === '*' || request_id === current.reqId) clear();
+        });
+        // Re-render read-only / actionable when control changes hands mid-ask.
+        ClientEventBus.on('AGENT_CONTROL', () => { if (current) render(); });
+    }
+
+    document.addEventListener('DOMContentLoaded', init);
+    return { clear };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 9aaf279a..b02568d8 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -15,8 +15,9 @@
     <link rel="stylesheet" href="/static/css/review.css">
     <link rel="stylesheet" href="/static/css/experiment.css">
     <link rel="stylesheet" href="/static/css/agent-chat.css">
+    <link rel="stylesheet" href="/static/css/ask-stage.css">
 </head>
-<body>
+<body class="{% if ux_v2 %}ux-v2{% endif %}">
     {% include '_header.html' %}
     {% include '_navbar.html' %}
     <!-- App shell: main content + docked agent panel (flex row for pin-to-dock).
@@ -24,6 +25,9 @@
     <div class="app-shell">
     <div class="app-main">
 
+    {# ux_v2: the agent's current pending ask, dual-rendered here + in the chat. #}
+    {% if ux_v2 %}<div id="ask-stage" class="ask-stage hidden" aria-live="polite"></div>{% endif %}
+
     <!-- Calibration Tab -->
     <!-- Home Tab (landing) -->
     <div id="home-content" class="tab-content active">
@@ -637,5 +641,6 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/campaigns.js"></script>
     <script src="/static/js/review.js"></script>
     <script src="/static/js/agent-chat.js"></script>
+    <script src="/static/js/ask-stage.js"></script>
 </body>
 </html>

From 52503e706914e03732b51b12240fb0258a524bcc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 04:15:58 +0530
Subject: [PATCH 087/314] UX v2 Phase 2: grouped rail nav + session-context
 strip (behind flag)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replaces the flat 8-tab bar with a calm grouped left rail (Now / Library /
System) and adds a session-context strip at the top of the main area — the
structural transformation toward the prototype's shell. All scoped under
body.ux-v2; v1 markup/CSS untouched (no consolidation of the known duplicate
.tab rulesets — deferred to the final cleanup phase).

- shell.js (new): wires each rail item to switchTab(tabId) — it ROUTES through
  the single init chokepoint, never reimplements tab activation, so every tab's
  lazy-init side-effect still fires. Keeps the rail's active state in sync via a
  new TAB_CHANGED event; populates the strip's status/embryo count from the
  Phase 0 ConnectionStatus store. Wires the rail's "Talk to Gently" to the
  existing AgentChat dock. No-ops unless body.ux-v2 is present.
- app.js: switchTab now emits TAB_CHANGED(tabName) — additive; v1 has no
  listener, so no behaviour change.
- index.html: the rail (first child of the flex-row .app-shell) + the strip
  (top of .app-main) + shell.css/shell.js includes, all under {% if ux_v2 %}.
- shell.css (new): rail + strip styling and a subtle unfold animation, every
  rule scoped under body.ux-v2.

Deferred to keep this phase low-risk: History-API routing and the
session_changed in-place re-hydration (current hash routing + reload still
work). Verified: node --check on all touched JS, Jinja parse on index.html.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/static/css/shell.css | 79 ++++++++++++++++++++++++++++++
 gently/ui/web/static/js/app.js     |  2 +
 gently/ui/web/static/js/shell.js   | 58 ++++++++++++++++++++++
 gently/ui/web/templates/index.html | 28 +++++++++++
 4 files changed, 167 insertions(+)
 create mode 100644 gently/ui/web/static/css/shell.css
 create mode 100644 gently/ui/web/static/js/shell.js

diff --git a/gently/ui/web/static/css/shell.css b/gently/ui/web/static/css/shell.css
new file mode 100644
index 00000000..7501572f
--- /dev/null
+++ b/gently/ui/web/static/css/shell.css
@@ -0,0 +1,79 @@
+/* ux_v2 shell chrome: grouped left-rail nav + session-context strip.
+   Everything is scoped under body.ux-v2 so the v1 dashboard is byte-for-byte
+   untouched — no consolidation of the existing duplicate .tab rulesets here
+   (that cleanup is deferred to the final phase). */
+
+/* Replace the flat 8-tab bar with the rail. */
+body.ux-v2 .tabs { display: none; }
+
+/* ── Left rail ─────────────────────────────────────────────── */
+body.ux-v2 .v2-rail {
+    flex: 0 0 212px;
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    padding: 14px 10px;
+    border-right: 1px solid var(--border, #e4e9f0);
+    background: var(--bg-card, #fff);
+    overflow-y: auto;
+    animation: v2-rise .45s ease backwards;
+}
+body.ux-v2 .v2-nav-group { margin-bottom: 6px; }
+body.ux-v2 .v2-nav-label {
+    font-size: 10px; letter-spacing: .1em; text-transform: uppercase;
+    color: var(--text-muted, #94a3b8); padding: 10px 10px 4px;
+}
+body.ux-v2 .v2-nav-item {
+    display: flex; align-items: center; gap: 8px; width: 100%;
+    background: none; border: 0; cursor: pointer; text-align: left;
+    padding: 8px 10px; border-radius: 8px;
+    font: inherit; font-size: 13.5px;
+    color: var(--text-secondary, #475569);
+    transition: background .15s, color .15s;
+}
+body.ux-v2 .v2-nav-item:hover { background: var(--bg-hover, #f1f5f9); color: var(--text, #0f172a); }
+body.ux-v2 .v2-nav-item.active {
+    background: var(--accent-soft, #eaf1ff);
+    color: var(--accent, #2f6df6);
+    font-weight: 600;
+}
+body.ux-v2 .v2-rail-chat {
+    margin-top: auto;
+    display: flex; align-items: center; gap: 9px;
+    background: none; border: 1px solid var(--border, #e4e9f0); border-radius: 10px;
+    padding: 9px 12px; cursor: pointer;
+    font: inherit; font-size: 13px;
+    color: var(--text-secondary, #475569);
+    transition: border-color .15s, color .15s;
+}
+body.ux-v2 .v2-rail-chat:hover { border-color: var(--accent, #2f6df6); color: var(--accent, #2f6df6); }
+body.ux-v2 .v2-rail-orb {
+    width: 18px; height: 18px; border-radius: 50%; flex: none;
+    background: radial-gradient(closest-side at 38% 34%, #fff, #bcd3ff 42%, var(--accent, #2f6df6) 100%);
+}
+
+/* ── Session-context strip (top of main) ───────────────────── */
+body.ux-v2 .v2-strip {
+    flex: none;
+    display: flex; align-items: center; gap: 12px;
+    padding: 9px 16px;
+    border-bottom: 1px solid var(--border, #e4e9f0);
+    background: var(--bg-card, #fff);
+    font-size: 12.5px; color: var(--text-muted, #94a3b8);
+    animation: v2-rise .45s ease backwards .05s;
+}
+body.ux-v2 .v2-strip-live {
+    display: inline-flex; align-items: center; gap: 6px;
+    font-size: 10.5px; font-weight: 700; letter-spacing: .08em; color: #ef4444;
+}
+body.ux-v2 .v2-strip-dot {
+    width: 8px; height: 8px; border-radius: 50%; background: #ef4444;
+}
+body.ux-v2 .v2-strip-status { margin-left: auto; font-variant-numeric: tabular-nums; }
+
+body.ux-v2 .app-main { animation: v2-rise .5s ease backwards .1s; }
+
+@keyframes v2-rise { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: none; } }
+@media (prefers-reduced-motion: reduce) {
+    body.ux-v2 .v2-rail, body.ux-v2 .v2-strip, body.ux-v2 .app-main { animation: none; }
+}
diff --git a/gently/ui/web/static/js/app.js b/gently/ui/web/static/js/app.js
index 3395c89b..a8c6450c 100644
--- a/gently/ui/web/static/js/app.js
+++ b/gently/ui/web/static/js/app.js
@@ -60,6 +60,8 @@ function updateCalibrationCount() {
 function switchTab(tabName) {
     if (!tabName) return;
     state.tab = tabName;
+    // ux_v2 grouped rail mirrors the active tab off this single chokepoint.
+    if (typeof ClientEventBus !== 'undefined') ClientEventBus.emit('TAB_CHANGED', tabName);
 
     // Update tab styling
     document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
diff --git a/gently/ui/web/static/js/shell.js b/gently/ui/web/static/js/shell.js
new file mode 100644
index 00000000..c85b2474
--- /dev/null
+++ b/gently/ui/web/static/js/shell.js
@@ -0,0 +1,58 @@
+/**
+ * Shell (ux_v2): the grouped left-rail nav (Now / Library / System) + the
+ * session-context strip that replace the flat 8-tab bar.
+ *
+ * CRITICAL: the rail ROUTES THROUGH switchTab(tabId) for every reveal — it
+ * never reimplements tab activation, so each tab's lazy-init side-effect
+ * (HomeApp.init, EmbryosManager.clearDetectionBadge, CampaignsApp.init, …)
+ * still fires. switchTab emits TAB_CHANGED, which keeps the rail's active
+ * state in sync no matter who switched (rail, keyboard shortcut, home card,
+ * hash route). No-ops unless body.ux-v2 is present (flag off → v1 untouched).
+ */
+const Shell = (() => {
+    let railItems = [];
+
+    function setActive(tabName) {
+        railItems.forEach(b => b.classList.toggle('active', b.dataset.tab === tabName));
+    }
+
+    function currentTab() {
+        const active = document.querySelector('.tab.active');
+        return (active && active.dataset.tab) ||
+            (typeof state !== 'undefined' && state.tab) || 'home';
+    }
+
+    function renderStrip(status) {
+        const el = document.getElementById('v2-strip-status');
+        if (!el) return;
+        const s = status || (typeof ConnectionStatus !== 'undefined' ? ConnectionStatus.get() : {});
+        const n = (typeof state !== 'undefined' && Array.isArray(state.embryos)) ? state.embryos.length : 0;
+        const conn = s.gentlyConnected ? (s.microscopeConnected ? 'Connected' : 'Online') : 'Offline';
+        el.textContent = `${n} embryo${n === 1 ? '' : 's'} · ${conn}`;
+    }
+
+    function init() {
+        if (!document.body.classList.contains('ux-v2')) return;  // flag off → no-op
+
+        railItems = Array.from(document.querySelectorAll('.v2-nav-item'));
+        railItems.forEach(btn => btn.addEventListener('click', () => {
+            if (typeof switchTab === 'function') switchTab(btn.dataset.tab);
+        }));
+        setActive(currentTab());
+
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('TAB_CHANGED', (tabName) => setActive(tabName));
+            ClientEventBus.on('CONNECTION_STATUS', (s) => renderStrip(s));
+        }
+
+        const chatBtn = document.getElementById('v2-rail-chat');
+        if (chatBtn) chatBtn.addEventListener('click', () => {
+            if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) AgentChat.togglePanel(true);
+        });
+
+        renderStrip();
+    }
+
+    document.addEventListener('DOMContentLoaded', init);
+    return {};
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index b02568d8..4bcf99c0 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -16,6 +16,7 @@
     <link rel="stylesheet" href="/static/css/experiment.css">
     <link rel="stylesheet" href="/static/css/agent-chat.css">
     <link rel="stylesheet" href="/static/css/ask-stage.css">
+    <link rel="stylesheet" href="/static/css/shell.css">
 </head>
 <body class="{% if ux_v2 %}ux-v2{% endif %}">
     {% include '_header.html' %}
@@ -23,8 +24,34 @@
     <!-- App shell: main content + docked agent panel (flex row for pin-to-dock).
          Header + navbar stay full-width above this. -->
     <div class="app-shell">
+    {% if ux_v2 %}
+    <aside class="v2-rail" id="v2-rail">
+      <nav class="v2-nav">
+        <div class="v2-nav-group">
+          <div class="v2-nav-label">Now</div>
+          <button class="v2-nav-item" data-tab="home">Home</button>
+          <button class="v2-nav-item" data-tab="experiment">Experiment</button>
+          <button class="v2-nav-item" data-tab="embryos">Embryos</button>
+        </div>
+        <div class="v2-nav-group">
+          <div class="v2-nav-label">Library</div>
+          <button class="v2-nav-item" data-tab="plans">Plans</button>
+          <button class="v2-nav-item" data-tab="sessions">Sessions</button>
+        </div>
+        <div class="v2-nav-group">
+          <div class="v2-nav-label">System</div>
+          <button class="v2-nav-item" data-tab="devices">Devices</button>
+          <button class="v2-nav-item" data-tab="calibration">Calibration</button>
+          <button class="v2-nav-item" data-tab="events">Logs</button>
+        </div>
+      </nav>
+      <button class="v2-rail-chat" id="v2-rail-chat"><span class="v2-rail-orb"></span>Talk to Gently</button>
+    </aside>
+    {% endif %}
     <div class="app-main">
 
+    {% if ux_v2 %}<div class="v2-strip" id="v2-strip"><span class="v2-strip-live"><span class="v2-strip-dot"></span>LIVE</span><span class="v2-strip-status" id="v2-strip-status"></span></div>{% endif %}
+
     {# ux_v2: the agent's current pending ask, dual-rendered here + in the chat. #}
     {% if ux_v2 %}<div id="ask-stage" class="ask-stage hidden" aria-live="polite"></div>{% endif %}
 
@@ -642,5 +669,6 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/review.js"></script>
     <script src="/static/js/agent-chat.js"></script>
     <script src="/static/js/ask-stage.js"></script>
+    <script src="/static/js/shell.js"></script>
 </body>
 </html>

From 288f97b8e6caf3e18e5f1add65104442cb40cf73 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 04:33:43 +0530
Subject: [PATCH 088/314] UX v2 Phase 3a: inference-first plan mode
 (model-driven, with provenance)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Flips plan mode from ASK-FIRST to INFERENCE-FIRST: the agent arrives with a
draft instead of interrogating the researcher. Per Keshu's call, the genotype
-> imaging-channel inference is done by the MODEL (it reads the reporters and
knows fluorophore spectra) — NOT a hardcoded heuristic table, which would only
cover a fraction of real fluorophores/dyes and force needless "asks".

- prompt.py: the stance now says infer what you can (channels from the strain
  genotype via your own fluorophore knowledge, organism defaults, lab/campaign
  context), record each inferred value's source + confidence in the spec's
  provenance, state a wavelength only when confident (else mark low-confidence
  and confirm via ask_user_choice — never guess a number), and ask ONLY for
  genuine gaps / low-confidence / consequential choices.
- model.py: ImagingSpec gains a `provenance` map (field -> {source, confidence}).
  It's a valid dataclass field, so it flows end-to-end with no extra plumbing:
  the model passes it in create_plan_item(spec=...), the store rebuilds it via
  ImagingSpec(**valid-fields), and it round-trips through serialization.

Backend only; needs a server restart to load the new prompt. The actual
inference behaviour is validated live in plan mode (see handoff).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/harness/memory/model.py     |  5 +++++
 gently/harness/plan_mode/prompt.py | 21 +++++++++++++++++----
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/gently/harness/memory/model.py b/gently/harness/memory/model.py
index 2a164176..58c8ee84 100644
--- a/gently/harness/memory/model.py
+++ b/gently/harness/memory/model.py
@@ -240,6 +240,11 @@ class ImagingSpec:
     success_criteria: str | None = None
     comparison_to: str | None = None  # "Compare to WT session 1"
 
+    # Per-field provenance for INFERRED values — field name -> {source, confidence}.
+    # e.g. {"laser_wavelength_nm": {"source": "inferred:genotype", "confidence": "medium"}}
+    # Lets the UI tag each value with where it came from and what to confirm.
+    provenance: Dict[str, Dict[str, str]] = field(default_factory=dict)
+
 
 @dataclass
 class BenchSpec:
diff --git a/gently/harness/plan_mode/prompt.py b/gently/harness/plan_mode/prompt.py
index 4228249c..62df77d7 100644
--- a/gently/harness/plan_mode/prompt.py
+++ b/gently/harness/plan_mode/prompt.py
@@ -21,8 +21,17 @@
 6. Challenge assumptions — suggest controls the researcher might not have thought of
 7. Suggest experiments outside of imaging where appropriate (bench assays, genetics, analysis)
 
-DO NOT rush to a plan. Gather information first. Ask questions. Search the literature.
-Understand the researcher's goals and constraints before proposing.
+Work INFERENCE-FIRST: arrive with a draft, don't interrogate. Infer what you
+reasonably can — read the reporters in the strain's genotype and set the
+excitation wavelengths from your knowledge of fluorophore spectra (e.g.
+TagRFP/mCherry ≈ 561 nm, GFP/GCaMP ≈ 488 nm), let the organism set sensible
+defaults, and let lab/campaign context fill the rest. Record each inferred
+value's source and confidence in the imaging spec's ``provenance``. State a
+wavelength only when you're confident; if a reporter is unfamiliar or ambiguous,
+mark it low-confidence and confirm via ask_user_choice rather than guessing a
+number. Then surface the draft for review, asking ONLY for genuine gaps,
+low-confidence guesses, or consequential choices. Search the literature to
+confirm, not to stall.
 
 ## How to Design an Experimental Plan
 
@@ -115,8 +124,12 @@
 PLAN_MODE_GUIDELINES = """\
 # Behavior in Plan Mode
 
-1. **Ask before assuming**: Don't assume the researcher's constraints. Ask about
-   available strains, timeline, equipment access, collaborators.
+1. **Infer, then confirm — don't interrogate**: Fill what you can from the strain
+   genotype, organism defaults, and lab/campaign context, and record where each
+   value came from (database citation, or your own fluorophore/biology knowledge)
+   in the spec's ``provenance``. Ask — via ask_user_choice — only for genuine
+   gaps, low-confidence guesses, or consequential choices, not for things you can
+   derive or look up.
 2. **Think about the full story**: What would reviewers want to see? What controls
    would strengthen the claims?
 3. **Be realistic about timelines**: Genetic crosses take weeks. Behavioral assays

From e9475060eaddf149628ba69774c029ab3dc606ac Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 04:46:29 +0530
Subject: [PATCH 089/314] UX v2 Phase 3b: surface inferred imaging spec +
 per-field provenance in the UI
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Makes Phase 3a's inference visible. renderSpec now shows the channel
(laser_wavelength_nm) and reporter/genotype rows — which it omitted before —
and tags each value with its provenance ("561 nm · inferred · medium") read
from spec.provenance, so the researcher can see what was inferred vs. cited and
what to confirm.

- agent-chat.js renderSpec: keyed rows (label, value, fieldKey) with a small
  source/confidence tag per row when spec.provenance carries that field; adds
  Genotype/Reporter/Channel rows.
- bridge.py: the spec payload builder now includes genotype/reporter/
  laser_wavelength_nm and the provenance map (was a curated subset that dropped
  the channel), so the UI has the data to render.
- ask-stage.css: styling for the .ac-spec-src provenance tag.

Frontend + a contained backend payload enrichment; node --check + bridge import
verified. Note: this surfaces provenance wherever the spec panel is shown and in
the plan document (which already serializes provenance); threading it through
every spec-emission path (e.g. the apply_plan_acquisition_spec stash) and a full
plan_confirm ask with inline edit/confirm is the remaining 3b polish.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/harness/bridge.py               |  8 ++++++
 gently/ui/web/static/css/ask-stage.css | 14 +++++++++++
 gently/ui/web/static/js/agent-chat.js  | 34 +++++++++++++++++++-------
 3 files changed, 47 insertions(+), 9 deletions(-)

diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index ddbfa9ca..fdd21040 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -251,9 +251,12 @@ def _candidate_to_option(self, item, spec, campaign) -> dict:
             spec_dict: dict[str, Any] = {}
             for field in (
                 "strain",
+                "genotype",
+                "reporter",
                 "temperature_c",
                 "num_slices",
                 "exposure_ms",
+                "laser_wavelength_nm",
                 "interval_s",
                 "stop_condition",
                 "success_criteria",
@@ -261,6 +264,11 @@ def _candidate_to_option(self, item, spec, campaign) -> dict:
                 val = getattr(spec, field, None)
                 if val is not None:
                     spec_dict[field] = val
+            # Carry per-field provenance so the UI can tag inferred values
+            # (e.g. "561 nm · inferred · medium") and show what to confirm.
+            prov = getattr(spec, "provenance", None)
+            if prov:
+                spec_dict["provenance"] = prov
             if spec_dict:
                 meta["spec"] = spec_dict
 
diff --git a/gently/ui/web/static/css/ask-stage.css b/gently/ui/web/static/css/ask-stage.css
index d706a05c..dc15c623 100644
--- a/gently/ui/web/static/css/ask-stage.css
+++ b/gently/ui/web/static/css/ask-stage.css
@@ -40,3 +40,17 @@
     background: var(--accent, #2f6df6); color: #fff;
     border-radius: 8px; padding: 8px 12px; line-height: 1;
 }
+
+/* Per-field provenance tag on imaging-spec rows (Phase 3b): shows where an
+   inferred value came from, e.g. "inferred · medium". */
+.ac-spec-src {
+    margin-left: 6px;
+    font-size: 10px;
+    letter-spacing: .02em;
+    color: var(--text-muted, #94a3b8);
+    background: var(--bg-hover, #f1f5f9);
+    border-radius: 999px;
+    padding: 1px 7px;
+    white-space: nowrap;
+    vertical-align: middle;
+}
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index c032e67a..c55c358a 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -483,19 +483,35 @@ const AgentChat = (() => {
     }
 
     function renderSpec(spec) {
+        const prov = spec.provenance || {};
         const rows = [];
-        const add = (k, v) => { if (v !== undefined && v !== null && v !== '') rows.push([k, v]); };
-        add('Strain', spec.strain);
-        add('Temperature', spec.temperature_c != null ? `${spec.temperature_c} °C` : null);
-        add('Slices', spec.num_slices);
-        add('Exposure', spec.exposure_ms != null ? `${spec.exposure_ms} ms` : null);
-        add('Interval', spec.interval_s != null ? `${spec.interval_s} s` : null);
-        add('Stop at', spec.stop_condition);
+        // (label, value, fieldKey) — fieldKey ties a row to its provenance entry.
+        const add = (label, value, key) => {
+            if (value === undefined || value === null || value === '') return;
+            rows.push({ label, value, src: key ? prov[key] : null });
+        };
+        add('Strain', spec.strain, 'strain');
+        add('Genotype', spec.genotype, 'genotype');
+        add('Reporter', spec.reporter, 'reporter');
+        add('Channel', spec.laser_wavelength_nm != null ? `${spec.laser_wavelength_nm} nm` : null, 'laser_wavelength_nm');
+        add('Temperature', spec.temperature_c != null ? `${spec.temperature_c} °C` : null, 'temperature_c');
+        add('Slices', spec.num_slices, 'num_slices');
+        add('Exposure', spec.exposure_ms != null ? `${spec.exposure_ms} ms` : null, 'exposure_ms');
+        add('Interval', spec.interval_s != null ? `${spec.interval_s} s` : null, 'interval_s');
+        add('Stop at', spec.stop_condition, 'stop_condition');
         if (!rows.length) return;
+        // A small "where did this come from" tag for inferred values.
+        const srcTag = (src) => {
+            if (!src || !src.source) return '';
+            const where = String(src.source).split(':')[0];
+            const conf = src.confidence ? ` · ${src.confidence}` : '';
+            const title = escapeHtml(String(src.source) + (src.confidence ? ` (confidence: ${src.confidence})` : ''));
+            return ` <span class="ac-spec-src" title="${title}">${escapeHtml(where + conf)}</span>`;
+        };
         const el = document.createElement('div');
         el.className = 'ac-spec';
-        el.innerHTML = '<div class="ac-spec-title">Imaging spec applied</div>' +
-            rows.map(([k, v]) => `<div class="ac-spec-row"><span>${escapeHtml(k)}</span><span>${escapeHtml(v)}</span></div>`).join('');
+        el.innerHTML = '<div class="ac-spec-title">Imaging spec</div>' +
+            rows.map(r => `<div class="ac-spec-row"><span>${escapeHtml(r.label)}</span><span class="ac-spec-val">${escapeHtml(r.value)}${srcTag(r.src)}</span></div>`).join('');
         log.appendChild(el);
         scrollToBottom();
     }

From 2387225d30614a70954fc5ae47594bff74ef9042 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 05:28:05 +0530
Subject: [PATCH 090/314] UX v2 Phase 4: co-editable shared-visibility surface
 (the agent's mind, live)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Renders the agent's expectations (beliefs), watchpoints (attention), and open
questions (uncertainty) as a calm panel on the landing, updating live and
resolvable by the control holder.

The "store has no event bus" blocker is solved via the EXISTING global bus
rather than dependency injection (matches agent.py's `emit` usage, so no
__init__/launch_gently changes):
- core/event_bus.py: new EventType.CONTEXT_UPDATED.
- file_store.py: FileContextStore._notify_context_change() emits it (lazy import,
  best-effort) from add/resolve of expectations, watchpoints, and questions. The
  server already broadcasts ALL bus events to /ws (subscribe_async("*")), and
  websocket.js re-emits them on ClientEventBus — so the surface refreshes live
  with zero new transport. Verified: the emit fires on the bus (unit check).
- routes/context.py (new, registered): GET /api/context (read the 3 lenses,
  defensive on cold start) + POST .../{id}/resolve for questions/watchpoints/
  expectations, each gated by Depends(require_control) (data.py pattern, NOT the
  mesh-scoped campaigns auth) so viewers can't mutate the agent's mind. Read side
  reuses campaigns._serialize.
- context-surface.js (new, ux_v2 only): fetches /api/context, renders the three
  lenses, re-fetches on CONTEXT_UPDATED + AGENT_CONTROL, and lets the holder
  answer a question (inline input — no native prompt), resolve a watchpoint, or
  confirm an expectation. shell.css: scoped styling. index.html: panel mounted at
  the top of the home landing under {% if ux_v2 %}.

Backend needs a server restart to load; live push + render is validated in-app.
Proactive #ask-stage cards from watchpoint creation are the remaining Phase-4
polish (noted).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/core/event_bus.py                   |   4 +
 gently/harness/memory/file_store.py        |  15 +++
 gently/ui/web/routes/__init__.py           |   2 +
 gently/ui/web/routes/context.py            |  71 ++++++++++++++
 gently/ui/web/static/css/shell.css         |  25 +++++
 gently/ui/web/static/js/context-surface.js | 105 +++++++++++++++++++++
 gently/ui/web/templates/index.html         |   2 +
 7 files changed, 224 insertions(+)
 create mode 100644 gently/ui/web/routes/context.py
 create mode 100644 gently/ui/web/static/js/context-surface.js

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 3b98e616..09edd389 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -92,6 +92,10 @@ class EventType(Enum):
     # gently/core/log_bridge.py — opt-in handler.
     LOG_RECORD = auto()
 
+    # Agent context/mind updates (expectations / watchpoints / questions) —
+    # drives the shared-visibility surface in the v2 UI.
+    CONTEXT_UPDATED = auto()
+
     # Operator-action events. Distinct from EMBRYOS_UPDATE because they
     # carry intent ("a human did this") rather than just state delta.
     # Candidate orchestrators can subscribe and reason about what the
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 0531dcce..3672ba88 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1908,6 +1908,15 @@ def get_observations_for_embryo(self, embryo_id: str, limit: int = 20) -> list[O
     # Expectations
     # ==================================================================
 
+    def _notify_context_change(self, kind: str = "context") -> None:
+        """Emit CONTEXT_UPDATED on the global bus so the shared-visibility
+        surface refreshes live. Best-effort — a bus failure never breaks a write."""
+        try:
+            from gently.core.event_bus import emit, EventType
+            emit(EventType.CONTEXT_UPDATED, {"kind": kind}, source="context_store")
+        except Exception:
+            pass
+
     def add_expectation(self, exp: Expectation):
         path = self.agent_dir / "active" / "expectations.yaml"
         items = self._read_yaml(path) or []
@@ -1925,6 +1934,7 @@ def add_expectation(self, exp: Expectation):
             }
         )
         self._write_yaml(path, items)
+        self._notify_context_change("expectation")
 
     def get_pending_expectations(self) -> list[Expectation]:
         path = self.agent_dir / "active" / "expectations.yaml"
@@ -1956,6 +1966,7 @@ def resolve_expectation(self, exp_id: str, status: ExpectationStatus):
                 item["resolved_at"] = now
                 break
         self._write_yaml(path, items)
+        self._notify_context_change("expectation")
 
     # ==================================================================
     # Watchpoints
@@ -1975,6 +1986,7 @@ def add_watchpoint(self, wp: Watchpoint):
             }
         )
         self._write_yaml(path, items)
+        self._notify_context_change("watchpoint")
 
     def get_active_watchpoints(self) -> list[Watchpoint]:
         path = self.agent_dir / "active" / "watchpoints.yaml"
@@ -2002,6 +2014,7 @@ def resolve_watchpoint(self, wp_id: str):
                 item["status"] = "resolved"
                 break
         self._write_yaml(path, items)
+        self._notify_context_change("watchpoint")
 
     # ==================================================================
     # Questions
@@ -2021,6 +2034,7 @@ def add_question(self, q: Question):
             }
         )
         self._write_yaml(path, items)
+        self._notify_context_change("question")
 
     def get_open_questions(self) -> list[Question]:
         path = self.agent_dir / "active" / "questions.yaml"
@@ -2042,6 +2056,7 @@ def resolve_question(self, q_id: str, resolution: str):
                 item["resolved_at"] = now
                 break
         self._write_yaml(path, items)
+        self._notify_context_change("question")
 
     # ==================================================================
     # Learnings
diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index ebd90770..bdbf3db7 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -10,6 +10,7 @@
 from .auth_routes import create_router as create_auth_router
 from .campaigns import create_router as create_campaigns_router
 from .chat import create_router as create_chat_router
+from .context import create_router as create_context_router
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
 from .images import create_router as create_images_router
@@ -33,6 +34,7 @@ def register_all_routes(server):
         create_websocket_router,
         create_agent_ws_router,
         create_chat_router,
+        create_context_router,
     ):
         router = factory(server)
         server.app.include_router(router)
diff --git a/gently/ui/web/routes/context.py b/gently/ui/web/routes/context.py
new file mode 100644
index 00000000..2d7c39df
--- /dev/null
+++ b/gently/ui/web/routes/context.py
@@ -0,0 +1,71 @@
+"""Context (shared-visibility) routes.
+
+Exposes the agent's "mind" — its open questions (uncertainty), active
+watchpoints (attention), and pending expectations (beliefs) — read by anyone,
+resolvable only by the control holder. Live updates ride the CONTEXT_UPDATED
+event the FileContextStore emits on the global bus, which the server already
+broadcasts to /ws; the client just re-fetches /api/context on it (no polling).
+"""
+
+from fastapi import APIRouter, Body, Depends
+
+from gently.ui.web.auth import require_control
+from .campaigns import _serialize
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _store():
+        # Defensive: the store is wired after construction; tolerate cold start.
+        return getattr(server, "context_store", None)
+
+    @router.get("/api/context")
+    async def get_context():
+        cs = _store()
+        empty = {"available": False, "expectations": [], "watchpoints": [], "questions": []}
+        if cs is None:
+            return empty
+        try:
+            return {
+                "available": True,
+                "questions": [_serialize(q) for q in cs.get_open_questions()],
+                "watchpoints": [_serialize(w) for w in cs.get_active_watchpoints()],
+                "expectations": [_serialize(e) for e in cs.get_pending_expectations()],
+            }
+        except Exception:
+            return empty
+
+    @router.post("/api/context/questions/{q_id}/resolve",
+                 dependencies=[Depends(require_control)])
+    async def resolve_question(q_id: str, resolution: str = Body("", embed=True)):
+        cs = _store()
+        if cs is None:
+            return {"ok": False, "error": "context store unavailable"}
+        cs.resolve_question(q_id, resolution or "")
+        return {"ok": True}
+
+    @router.post("/api/context/watchpoints/{wp_id}/resolve",
+                 dependencies=[Depends(require_control)])
+    async def resolve_watchpoint(wp_id: str):
+        cs = _store()
+        if cs is None:
+            return {"ok": False, "error": "context store unavailable"}
+        cs.resolve_watchpoint(wp_id)
+        return {"ok": True}
+
+    @router.post("/api/context/expectations/{exp_id}/resolve",
+                 dependencies=[Depends(require_control)])
+    async def resolve_expectation(exp_id: str, status: str = Body("confirmed", embed=True)):
+        cs = _store()
+        if cs is None:
+            return {"ok": False, "error": "context store unavailable"}
+        from gently.harness.memory.model import ExpectationStatus
+        try:
+            st = ExpectationStatus(status)
+        except ValueError:
+            st = ExpectationStatus.CONFIRMED
+        cs.resolve_expectation(exp_id, st)
+        return {"ok": True}
+
+    return router
diff --git a/gently/ui/web/static/css/shell.css b/gently/ui/web/static/css/shell.css
index 7501572f..211be553 100644
--- a/gently/ui/web/static/css/shell.css
+++ b/gently/ui/web/static/css/shell.css
@@ -77,3 +77,28 @@ body.ux-v2 .app-main { animation: v2-rise .5s ease backwards .1s; }
 @media (prefers-reduced-motion: reduce) {
     body.ux-v2 .v2-rail, body.ux-v2 .v2-strip, body.ux-v2 .app-main { animation: none; }
 }
+
+/* ── Shared-visibility surface (the agent's view) ──────────── */
+body.ux-v2 .cx-surface {
+    margin: 0 0 16px;
+    border: 1px solid var(--border, #e4e9f0);
+    border-radius: 14px;
+    background: var(--bg-card, #fff);
+    padding: 14px 16px;
+}
+body.ux-v2 .cx-surface.hidden { display: none; }
+body.ux-v2 .cx-title { font-size: 11px; letter-spacing: .1em; text-transform: uppercase; color: var(--text-muted, #94a3b8); margin-bottom: 8px; }
+body.ux-v2 .cx-lens { margin-bottom: 10px; }
+body.ux-v2 .cx-lens-h { font-size: 11px; font-weight: 600; color: var(--text-secondary, #475569); margin: 6px 0 4px; }
+body.ux-v2 .cx-item { display: flex; align-items: center; gap: 9px; padding: 5px 0; flex-wrap: wrap; }
+body.ux-v2 .cx-text { flex: 1; min-width: 0; font-size: 13px; color: var(--text, #0f172a); }
+body.ux-v2 .cx-dot { width: 7px; height: 7px; border-radius: 50%; flex: none; }
+body.ux-v2 .cx-dot.cx-q { background: #d97706; }
+body.ux-v2 .cx-dot.cx-w { background: var(--accent, #2f6df6); }
+body.ux-v2 .cx-dot.cx-e { background: var(--accent-green, #16a34a); }
+body.ux-v2 .cx-act { flex: none; border: 1px solid var(--border, #e4e9f0); background: none; color: var(--text-secondary, #475569); border-radius: 8px; padding: 3px 10px; font: inherit; font-size: 12px; cursor: pointer; }
+body.ux-v2 .cx-act:hover { border-color: var(--accent, #2f6df6); color: var(--accent, #2f6df6); }
+body.ux-v2 .cx-answer { display: flex; gap: 6px; align-items: center; flex: 1 0 100%; margin-top: 4px; }
+body.ux-v2 .cx-answer.hidden { display: none; }
+body.ux-v2 .cx-answer-input { flex: 1; min-width: 0; border: 1px solid var(--border, #cbd5e1); border-radius: 8px; padding: 6px 9px; font: inherit; font-size: 12px; }
+body.ux-v2 .cx-answer-go { border: 0; background: var(--accent, #2f6df6); color: #fff; border-radius: 8px; padding: 6px 10px; cursor: pointer; }
diff --git a/gently/ui/web/static/js/context-surface.js b/gently/ui/web/static/js/context-surface.js
new file mode 100644
index 00000000..d8c2d0de
--- /dev/null
+++ b/gently/ui/web/static/js/context-surface.js
@@ -0,0 +1,105 @@
+/**
+ * ContextSurface (ux_v2): renders the agent's "mind" as a calm, always-visible
+ * panel — open questions (uncertainty), watchpoints (attention), expectations
+ * (beliefs) — read from /api/context and refreshed live on the CONTEXT_UPDATED
+ * event (the store emits it; the server broadcasts it to /ws; no polling).
+ *
+ * The control holder can resolve items inline (answer a question, resolve a
+ * watchpoint, confirm an expectation); observers see it read-only. No-ops
+ * unless #context-surface is present (flag off → v1 untouched).
+ */
+const ContextSurface = (() => {
+    let el = null, loading = false;
+
+    const esc = (s) => (typeof escapeHtml === 'function')
+        ? escapeHtml(String(s == null ? '' : s)) : String(s == null ? '' : s);
+    const hasControl = () =>
+        (typeof AgentChat !== 'undefined' && AgentChat.hasControl) ? AgentChat.hasControl() : true;
+
+    async function fetchAndRender() {
+        if (!el || loading) return;
+        loading = true;
+        try { render(await (await fetch('/api/context')).json()); }
+        catch (e) { /* keep last render */ }
+        finally { loading = false; }
+    }
+
+    function section(label, html) { return html ? `<div class="cx-lens"><div class="cx-lens-h">${label}</div>${html}</div>` : ''; }
+
+    function render(data) {
+        if (!el) return;
+        const hc = hasControl();
+        const questions = data.questions || [], watchpoints = data.watchpoints || [], expectations = data.expectations || [];
+        if (!questions.length && !watchpoints.length && !expectations.length) {
+            el.innerHTML = ''; el.classList.add('hidden'); return;
+        }
+        el.classList.remove('hidden');
+
+        const qHtml = questions.map(it => `
+            <div class="cx-item" data-kind="questions" data-id="${esc(it.id)}">
+                <span class="cx-dot cx-q"></span>
+                <span class="cx-text">${esc(it.content)}</span>
+                ${hc ? '<button class="cx-act" data-act="answer">Answer</button>' : ''}
+                ${hc ? '<div class="cx-answer hidden"><input class="cx-answer-input" placeholder="Answer / resolve…"><button class="cx-answer-go">→</button></div>' : ''}
+            </div>`).join('');
+        const wHtml = watchpoints.map(it => `
+            <div class="cx-item" data-kind="watchpoints" data-id="${esc(it.id)}">
+                <span class="cx-dot cx-w"></span>
+                <span class="cx-text">${esc(it.target)}${it.condition ? ' — ' + esc(it.condition) : ''}</span>
+                ${hc ? '<button class="cx-act" data-act="resolve">Resolve</button>' : ''}
+            </div>`).join('');
+        const eHtml = expectations.map(it => `
+            <div class="cx-item" data-kind="expectations" data-id="${esc(it.id)}">
+                <span class="cx-dot cx-e"></span>
+                <span class="cx-text">${esc(it.target)}${it.prediction ? ': ' + esc(it.prediction) : ''}</span>
+                ${hc ? '<button class="cx-act" data-act="confirm" title="Mark confirmed">✓</button>' : ''}
+            </div>`).join('');
+
+        el.innerHTML = '<div class="cx-title">Agent’s view</div>' +
+            section('Open questions', qHtml) + section('Watching', wHtml) + section('Expectations', eHtml);
+        wire();
+    }
+
+    function wire() {
+        el.querySelectorAll('.cx-item').forEach(item => {
+            const kind = item.dataset.kind, id = item.dataset.id;
+            const actBtn = item.querySelector('.cx-act');
+            if (!actBtn) return;
+            const act = actBtn.dataset.act;
+            if (act === 'answer') {
+                const box = item.querySelector('.cx-answer');
+                const input = item.querySelector('.cx-answer-input');
+                const submit = () => resolve(kind, id, { resolution: input.value.trim() });
+                actBtn.addEventListener('click', () => { box.classList.toggle('hidden'); if (!box.classList.contains('hidden')) input.focus(); });
+                item.querySelector('.cx-answer-go').addEventListener('click', submit);
+                input.addEventListener('keydown', e => { if (e.key === 'Enter') { e.preventDefault(); submit(); } });
+            } else if (act === 'resolve') {
+                actBtn.addEventListener('click', () => resolve(kind, id, {}));
+            } else if (act === 'confirm') {
+                actBtn.addEventListener('click', () => resolve(kind, id, { status: 'confirmed' }));
+            }
+        });
+    }
+
+    async function resolve(kind, id, body) {
+        try {
+            await fetch(`/api/context/${kind}/${encodeURIComponent(id)}/resolve`, {
+                method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body || {}),
+            });
+        } catch (e) { /* ignore; surface stays as-is */ }
+        fetchAndRender();  // CONTEXT_UPDATED also re-fetches for every client
+    }
+
+    function init() {
+        el = document.getElementById('context-surface');
+        if (!el) return;  // ux_v2 off → no-op
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('CONTEXT_UPDATED', () => fetchAndRender());
+            ClientEventBus.on('AGENT_CONTROL', () => fetchAndRender());  // re-render with/without resolve controls
+        }
+        fetchAndRender();
+    }
+
+    document.addEventListener('DOMContentLoaded', init);
+    return { refresh: fetchAndRender };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 4bcf99c0..9a4ff9dd 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -59,6 +59,7 @@
     <!-- Home Tab (landing) -->
     <div id="home-content" class="tab-content active">
         <div class="home-scroll">
+        {% if ux_v2 %}<aside id="context-surface" class="cx-surface hidden"></aside>{% endif %}
             <div class="home-hero">
                 <div class="home-hero-text">
                     <h2 class="home-hero-title">Welcome to Gently</h2>
@@ -670,5 +671,6 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/agent-chat.js"></script>
     <script src="/static/js/ask-stage.js"></script>
     <script src="/static/js/shell.js"></script>
+    <script src="/static/js/context-surface.js"></script>
 </body>
 </html>

From e8ce2bfd0498a1188f1d1034025c43b9a658e5fc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 05:33:42 +0530
Subject: [PATCH 091/314] UX v2 Phase 4 follow-up: show an empty-state for the
 agent's-view panel
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The context surface hid itself entirely when the agent had no expectations/
watchpoints/questions — so on a fresh session it was invisible and read as
"missing". Render a calm "nothing yet" empty-state instead, so the surface is
discoverable before the agent has formed any beliefs. Static JS/CSS only —
hard-reload to pick it up, no restart.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/static/css/shell.css         | 1 +
 gently/ui/web/static/js/context-surface.js | 8 ++++++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/static/css/shell.css b/gently/ui/web/static/css/shell.css
index 211be553..c38ae89a 100644
--- a/gently/ui/web/static/css/shell.css
+++ b/gently/ui/web/static/css/shell.css
@@ -102,3 +102,4 @@ body.ux-v2 .cx-answer { display: flex; gap: 6px; align-items: center; flex: 1 0
 body.ux-v2 .cx-answer.hidden { display: none; }
 body.ux-v2 .cx-answer-input { flex: 1; min-width: 0; border: 1px solid var(--border, #cbd5e1); border-radius: 8px; padding: 6px 9px; font: inherit; font-size: 12px; }
 body.ux-v2 .cx-answer-go { border: 0; background: var(--accent, #2f6df6); color: #fff; border-radius: 8px; padding: 6px 10px; cursor: pointer; }
+body.ux-v2 .cx-empty { font-size: 12.5px; color: var(--text-muted, #94a3b8); font-style: italic; padding: 2px 0 4px; }
diff --git a/gently/ui/web/static/js/context-surface.js b/gently/ui/web/static/js/context-surface.js
index d8c2d0de..2e10000d 100644
--- a/gently/ui/web/static/js/context-surface.js
+++ b/gently/ui/web/static/js/context-surface.js
@@ -30,10 +30,14 @@ const ContextSurface = (() => {
         if (!el) return;
         const hc = hasControl();
         const questions = data.questions || [], watchpoints = data.watchpoints || [], expectations = data.expectations || [];
+        el.classList.remove('hidden');
         if (!questions.length && !watchpoints.length && !expectations.length) {
-            el.innerHTML = ''; el.classList.add('hidden'); return;
+            // Show an empty-state rather than vanishing, so the surface is
+            // discoverable before the agent has formed any beliefs.
+            el.innerHTML = '<div class="cx-title">Agent’s view</div>' +
+                '<div class="cx-empty">Nothing yet — the agent’s expectations, watchpoints, and open questions appear here as it works.</div>';
+            return;
         }
-        el.classList.remove('hidden');
 
         const qHtml = questions.map(it => `
             <div class="cx-item" data-kind="questions" data-id="${esc(it.id)}">

From c98a33fd9ad980d0760908e6ece34a752a728b9e Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 05:38:44 +0530
Subject: [PATCH 092/314] Put the free-the-port command in the "port in use"
 error
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

When the viz server can't bind its port, the error now tells you how to free
it (fuser -k <port>/tcp, or lsof -ti | xargs kill) instead of just "close it
first" — uses self.port so it's always the right port. (Standalone DX fix.)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/server.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index c16c548d..faf2a2d8 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -788,9 +788,9 @@ async def on_start(self):
             sock.bind((self.host, self.port))
         except OSError:
             raise OSError(
-                f"Port {self.port} is already in use. "
-                "Is another instance of the agent running? "
-                "Close it first and try again."
+                f"Port {self.port} is already in use — another instance may be running. "
+                f"Free it with:  fuser -k {self.port}/tcp  "
+                f"(or: lsof -ti:{self.port} | xargs -r kill), then try again."
             ) from None
         finally:
             sock.close()

From 927900ada57471306cd8d970de7f95f4c5bbd11e Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 05:47:24 +0530
Subject: [PATCH 093/314] =?UTF-8?q?UX=20v2=20Phase=205:=20Experiment=20vie?=
 =?UTF-8?q?w=20shows=20real=20tactics=20only=20=E2=80=94=20drop=20stubbed?=
 =?UTF-8?q?=20data?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Experiment view's job is to show the live experimental TACTIC patterns
(cadence: base/fast/burst/cooldown + reactive-monitoring rules). It was
falling back to a ~130-line STUB_STRATEGY (and a "mockup · stubbed data" badge)
whenever there was no active experiment or the fetch wasn't ready — i.e.
production could render fake tactics.

- Removed the STUB_STRATEGY const entirely.
- loadStrategy() now returns null on non-OK / error (no stub fallback).
- render(null) shows a calm empty state ("No active experiment — the imaging
  tactics will appear here once a run is live"), never fabricated data.
- Removed both "mockup · stubbed data" badges; the header just shows "live".

Affects v1 and v2 (the Experiment tab isn't flag-gated) — removing fake data
is correct for both; it only changes the no-active-experiment case (stub →
empty state), real live runs render as before. node --check clean.

NOT done (deliberately): the large carve of a new per-embryo renderer out of
the 4,556-line embryos.js — the existing ExperimentOverview already renders the
tactic patterns from /api/experiments/current/strategy, and the detailed
contents are yours to define. The reconcileWithServerState/clearAllState
contract in embryos.js is left untouched.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../ui/web/static/js/experiment-overview.js   | 176 ++----------------
 1 file changed, 19 insertions(+), 157 deletions(-)

diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index 33032a40..9e7fc221 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -1,147 +1,12 @@
 /**
- * Experiment Overview Tab — vector-graphics view of the planned timelapse.
+ * Experiment Overview Tab — vector-graphics view of the live imaging tactics
+ * (cadence patterns + reactive-monitoring rules) for the running experiment.
  *
- * Data source priority:
- *   1. GET /api/experiments/current/strategy  — live snapshot from FileStore.
- *   2. STUB_STRATEGY below                    — used when the live fetch
- *                                               fails or no session exists.
- *
- * The render path is data-shape-driven and doesn't care which source the
- * snapshot came from — only ``ExperimentOverview.isLive`` differs so the
- * header badge can say "live" or "mockup · stubbed data".
+ * Data source: GET /api/experiments/current/strategy — the live snapshot from
+ * FileStore. When there is no active experiment (or the fetch isn't ready), the
+ * view shows a calm empty state; it never renders stubbed/mock data.
  */
 
-const STUB_STRATEGY = {
-    session_id: "20260522_1430_dopaminergic_demo_a3f8e1c2",
-    session_name: "dopaminergic-reporter demo",
-    started_at: "2026-05-22T14:30:00",
-    now_offset_s: 8100,         // 2h 15min into the run
-    horizon_s: 14400,           // 4h total view window (past + projected)
-    base_interval_s: 120,
-    dose_budget_base_ms: 50000,
-    per_timepoint_ms: 500,      // 50 slices × 10ms
-    monitoring_modes: [
-        {
-            name: "expression_monitoring",
-            description: "Anticipating fluorescent-reporter onset on Test embryos: accelerate to 60s on signal, ramp 488 down on saturation.",
-            applies_to_roles: ["test"],
-            params: {
-                fast_interval: 60,
-                rampdown_step_pct: 1.0,
-                rampdown_floor_pct: 2.0,
-                rampdown_ceiling_pct: 6.0
-            }
-        },
-        {
-            name: "pre_terminal_monitoring",
-            description: "Anticipating organism pre-terminal stage (pretzel): accelerate to 30s on detection.",
-            applies_to_roles: ["test"],
-            params: { fast_interval: 30 }
-        }
-    ],
-    triggers: [
-        { id: "t1", kind: "interval_rule", label: "signal onset",
-          when_text: "dopaminergic ≥ WEAK", then_text: "120s → 60s",
-          applies_to: ["test"], one_time: true },
-        { id: "t2", kind: "power_rule", label: "488 ramp down",
-          when_text: "intensity = SATURATING (×3)", then_text: "488 ↓ 1%/step, floor 2%",
-          applies_to: ["test"] },
-        { id: "t3", kind: "burst", label: "structure-triggered burst",
-          when_text: "structure_quality = GOOD", then_text: "burst 200 frames @ 20 Hz",
-          applies_to: ["test"] },
-        { id: "t4", kind: "interval_rule", label: "pre-terminal speedup",
-          when_text: "stage = pretzel", then_text: "60s → 30s",
-          applies_to: ["test"], one_time: true }
-    ],
-    embryos: [
-        {
-            id: "E1", role: "test", color: "#ff66cc", icon: "★",
-            dose_used_ms: 12500, dose_budget_ms: 50000,
-            tp_acquired: 25,
-            stop_condition: "hatching+3 OR 24h duration",
-            stop_kind: "bounded",
-            laser_488_pct_now: 3.0,
-            phases: [
-                { mode: "base",     start: 0,    end: 1800, cadence_s: 120 },
-                { mode: "fast",     start: 1800, end: 3600, cadence_s: 60 },
-                { mode: "burst",    start: 3600, end: 3610, frames: 200, hz: 20 },
-                { mode: "cooldown", start: 3610, end: 3640, cadence_s: 60 },
-                { mode: "fast",     start: 3640, end: 8100, cadence_s: 60 }
-            ],
-            trigger_events: [
-                { trigger_id: "t1", at: 1800 },
-                { trigger_id: "t3", at: 3600 },
-                { trigger_id: "t2", at: 5400, count: 3 }
-            ],
-            power_history_488: [
-                { at: 0,    pct: 5.0 },
-                { at: 5400, pct: 4.0 },
-                { at: 5460, pct: 3.0 },
-                { at: 8100, pct: 3.0 }
-            ],
-            // Future projection at current cadence (60s, fast). Hatching not
-            // deterministic so projected_end_s is null — render fades to ∞.
-            projected_cadence_s: 60,
-            projected_end_s: null
-        },
-        {
-            id: "E2", role: "test", color: "#ff66cc", icon: "★",
-            dose_used_ms: 6500, dose_budget_ms: 50000,
-            tp_acquired: 13,
-            stop_condition: "hatching+3 OR 24h duration",
-            stop_kind: "bounded",
-            laser_488_pct_now: 5.0,
-            phases: [
-                { mode: "base", start: 0, end: 8100, cadence_s: 120 }
-            ],
-            trigger_events: [],
-            power_history_488: [
-                { at: 0,    pct: 5.0 },
-                { at: 8100, pct: 5.0 }
-            ],
-            projected_cadence_s: 120,
-            projected_end_s: null
-        },
-        {
-            id: "E3", role: "test", color: "#ff66cc", icon: "★",
-            dose_used_ms: 38000, dose_budget_ms: 50000,
-            tp_acquired: 76,
-            stop_condition: "manual",
-            stop_kind: "open_ended",
-            laser_488_pct_now: 5.0,
-            phases: [
-                { mode: "base", start: 0, end: 8100, cadence_s: 120 }
-            ],
-            trigger_events: [],
-            power_history_488: [
-                { at: 0,    pct: 5.0 },
-                { at: 8100, pct: 5.0 }
-            ],
-            // Projected dose-exhaust horizon = 4.0h from now (warning condition)
-            projected_cadence_s: 120,
-            projected_end_s: null,
-            dose_exhaust_at_s: 12000   // budget will run out at this elapsed time
-        },
-        {
-            id: "C1", role: "calibration", color: "#22d3ee", icon: "◆",
-            dose_used_ms: 33500, dose_budget_ms: 500000,   // 10× multiplier
-            tp_acquired: 67,
-            stop_condition: "manual",
-            stop_kind: "open_ended",
-            laser_488_pct_now: 5.0,
-            phases: [
-                { mode: "base", start: 0, end: 8100, cadence_s: 120 }
-            ],
-            trigger_events: [],
-            power_history_488: [
-                { at: 0,    pct: 5.0 },
-                { at: 8100, pct: 5.0 }
-            ],
-            projected_cadence_s: 120,
-            projected_end_s: null
-        }
-    ]
-};
 
 const ExperimentOverview = {
     initialized: false,
@@ -164,23 +29,19 @@ const ExperimentOverview = {
                 cache: 'no-store'
             });
             if (!resp.ok) {
-                console.warn(
-                    '[ExperimentOverview] strategy fetch returned',
-                    resp.status, '- falling back to stub'
-                );
+                // No active experiment / not ready yet — show the empty state,
+                // never stubbed data.
+                console.warn('[ExperimentOverview] strategy fetch returned', resp.status);
                 this.isLive = false;
-                return STUB_STRATEGY;
+                return null;
             }
             const data = await resp.json();
             this.isLive = true;
             return data;
         } catch (e) {
-            console.warn(
-                '[ExperimentOverview] strategy fetch error - falling back to stub:',
-                e
-            );
+            console.warn('[ExperimentOverview] strategy fetch error:', e);
             this.isLive = false;
-            return STUB_STRATEGY;
+            return null;
         }
     },
 
@@ -193,7 +54,7 @@ const ExperimentOverview = {
         });
         // Re-render against the last fetched strategy (no re-fetch on tab
         // switch — refresh happens on tab activation in the bootstrap).
-        this.render(this.activeStrategy || STUB_STRATEGY);
+        this.render(this.activeStrategy);
     },
 
     render(s) {
@@ -204,6 +65,12 @@ const ExperimentOverview = {
         }
         // Tear down any prior ticker before we blow away the SVG it pointed at.
         this._stopNowTicker();
+        if (!s) {
+            // No active experiment — a calm empty state, never stubbed data.
+            root.innerHTML = '<div style="padding:32px;text-align:center;color:var(--text-muted,#94a3b8);font-size:13px;">' +
+                'No active experiment — the imaging tactics (cadence, reactive rules) will appear here once a run is live.</div>';
+            return;
+        }
         try {
             root.innerHTML = '';
             if (this.activeView === 'rules') {
@@ -301,7 +168,6 @@ const ExperimentOverview = {
         const metaRow = el('div', 'expov-header-row expov-header-row-meta');
         metaRow.appendChild(elText('span', 'expov-session-name', s.session_name));
         metaRow.appendChild(elText('span', 'expov-session-id', s.session_id));
-        metaRow.appendChild(elText('span', 'expov-mockup-badge', 'mockup · stubbed data'));
         header.appendChild(metaRow);
         root.appendChild(header);
 
@@ -330,11 +196,7 @@ const ExperimentOverview = {
         if (s.session_name && s.session_name !== s.session_id) {
             metaRow.appendChild(elText('span', 'expov-session-name', s.session_name));
         }
-        if (this.isLive) {
-            metaRow.appendChild(elText('span', 'expov-live-badge', 'live'));
-        } else {
-            metaRow.appendChild(elText('span', 'expov-mockup-badge', 'mockup · stubbed data'));
-        }
+        metaRow.appendChild(elText('span', 'expov-live-badge', 'live'));
         wrap.appendChild(metaRow);
 
         // Compact key-metric strip

From f69bc4e881da74910ac63ea06a5104fd0eb01bad Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 05:54:17 +0530
Subject: [PATCH 094/314] UX v2 Phase 6 (step 1): flip GENTLY_UX_V2 default ON,
 keep v1 fallback
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

v2 is now the default UI — no env var needed. The v1 dashboard stays reachable
as a fallback via GENTLY_UX_V2=0 (and its markup is NOT deleted yet). This is
the reversible "flip → soak" step; the irreversible v1 markup/CSS deletion is
deferred until v2 has run as the default and is confirmed good.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/settings.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/gently/settings.py b/gently/settings.py
index 8b16f871..d197bc0d 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -124,10 +124,10 @@ class TransferSettings:
 class UISettings:
     """Web UI feature flags."""
     # New agent-first UX paradigm (welcome→shell unfold, dual-rendered agent
-    # asks, inference-first plan mode, shared-visibility surface). Off by
-    # default; flip per-deployment via GENTLY_UX_V2=1 while the migration
-    # soaks behind the flag. The v1 dashboard stays the default until then.
-    ux_v2: bool = field(default_factory=lambda: _env("UX_V2", False))
+    # asks, inference-first plan mode, shared-visibility surface). Now ON by
+    # default; the v1 dashboard remains available as a fallback via
+    # GENTLY_UX_V2=0 until the v1 markup is removed in a later cleanup step.
+    ux_v2: bool = field(default_factory=lambda: _env("UX_V2", True))
 
 
 @dataclass(frozen=True)

From e4de3a117449b9214cd2399c9c7b6295b78a01a4 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 07:39:10 +0530
Subject: [PATCH 095/314] =?UTF-8?q?UX=20v2:=20agent-first=20landing=20?=
 =?UTF-8?q?=E2=86=92=20in-page=20plan=20wizard=20(flag-gated)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add the entry landing the prototype sketched — agent orb, time-aware greeting, and choice cards (Plan / quick look / free-text escape), behind GENTLY_UX_V2 and receding into the workspace.

Crucially, the plan dialogue renders IN the landing, not the chat REPL: 'Plan an experiment' switches to an in-place plan-wizard screen, enters /plan, and renders the agent's ask_user_choice questions as button cards there (reusing AgentChat.buildAskCard), with the plan assembling from each pick. agent-chat.js: runCommand is now connection-aware (connect + queue/flush on open) so the page drives the agent without opening the chat panel.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/static/css/landing.css  | 227 ++++++++++++++++++++++++++
 gently/ui/web/static/js/agent-chat.js |  18 +-
 gently/ui/web/static/js/landing.js    | 214 ++++++++++++++++++++++++
 gently/ui/web/templates/index.html    |  82 ++++++++++
 4 files changed, 539 insertions(+), 2 deletions(-)
 create mode 100644 gently/ui/web/static/css/landing.css
 create mode 100644 gently/ui/web/static/js/landing.js

diff --git a/gently/ui/web/static/css/landing.css b/gently/ui/web/static/css/landing.css
new file mode 100644
index 00000000..c5152cf5
--- /dev/null
+++ b/gently/ui/web/static/css/landing.css
@@ -0,0 +1,227 @@
+/* ux_v2 landing — the agent-first welcome that the prototype sketched, ported
+   into production. A full-bleed overlay shown on first entry that recedes into
+   the workspace once the user picks a path. Everything is scoped under
+   body.ux-v2 and the #v2-landing node only renders when the flag is on, so v1
+   is byte-for-byte untouched. Visual language mirrors ux-prototype/landing.html
+   but reuses production's CSS variables (with the prototype hexes as fallback)
+   so it tracks the app theme. */
+
+.v2-landing {
+    position: fixed;
+    inset: 0;
+    z-index: 200;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 24px;
+    overflow: hidden;
+    background:
+        radial-gradient(1100px 700px at 78% -8%, #eaf1ff 0%, transparent 55%),
+        radial-gradient(900px 600px at 8% 108%, #eafaf0 0%, transparent 55%),
+        var(--bg, #f6f8fb);
+    transition: opacity .5s cubic-bezier(.22,1,.36,1), transform .5s cubic-bezier(.22,1,.36,1), visibility .5s;
+}
+/* The calm screen "unfolds" into the workspace: fade + slight scale-up, then
+   the node is pulled from the layout (display:none set by JS after the
+   transition) so it never traps clicks. */
+.v2-landing.dismissed {
+    opacity: 0;
+    visibility: hidden;
+    transform: scale(1.015);
+    pointer-events: none;
+}
+.v2-landing::before {
+    content: "";
+    position: absolute;
+    inset: -20vmax;
+    background: radial-gradient(closest-side, rgba(47,109,246,.10), transparent 70%);
+    filter: blur(30px);
+    animation: v2land-drift 26s cubic-bezier(.22,1,.36,1) infinite alternate;
+    pointer-events: none;
+}
+@keyframes v2land-drift {
+    0%   { transform: translate(-6vw,-4vh) scale(1); }
+    100% { transform: translate(8vw,6vh) scale(1.15); }
+}
+
+.v2-landing-inner {
+    position: relative;
+    z-index: 1;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    max-width: 760px;
+    width: 100%;
+}
+.v2-landing-rise { animation: v2land-rise .6s cubic-bezier(.22,1,.36,1) backwards; }
+.v2-landing-rise[data-i="1"] { animation-delay: .07s; }
+.v2-landing-rise[data-i="2"] { animation-delay: .14s; }
+.v2-landing-rise[data-i="3"] { animation-delay: .21s; }
+@keyframes v2land-rise { from { opacity: 0; transform: translateY(14px); } to { opacity: 1; transform: none; } }
+
+/* agent presence */
+.v2-landing-agent { display: flex; flex-direction: column; align-items: center; gap: 16px; }
+.v2-landing-orb {
+    width: 52px; height: 52px; border-radius: 50%;
+    background: radial-gradient(closest-side at 38% 34%, #ffffff, #bcd3ff 40%, var(--accent, #2f6df6) 100%);
+    box-shadow: 0 6px 22px rgba(47,109,246,.45), inset 0 0 12px rgba(255,255,255,.6);
+    animation: v2land-breathe 4s ease-in-out infinite;
+}
+@keyframes v2land-breathe { 0%,100% { transform: scale(1); } 50% { transform: scale(1.06); } }
+.v2-landing-say {
+    font-size: clamp(20px, 3vw, 28px); font-weight: 600; letter-spacing: -.02em;
+    text-align: center; max-width: 22ch; line-height: 1.25; color: var(--text, #0f172a);
+}
+.v2-landing-say .dim { color: var(--text-muted, #94a3b8); font-weight: 500; }
+
+/* choice cards */
+.v2-landing-choices {
+    display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 18px;
+    margin-top: 34px; width: min(720px, 92vw);
+}
+@media (max-width: 620px) { .v2-landing-choices { grid-template-columns: 1fr; } }
+.v2-choice {
+    text-align: left; cursor: pointer; position: relative; overflow: hidden;
+    border: 1px solid var(--border, #e4e9f0); background: var(--bg-card, #fff);
+    border-radius: 18px; padding: 22px 22px 20px;
+    box-shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
+    font: inherit; color: var(--text, #0f172a);
+    transition: transform .26s cubic-bezier(.22,1,.36,1), box-shadow .26s cubic-bezier(.22,1,.36,1), border-color .26s;
+}
+.v2-choice:hover {
+    transform: translateY(-4px); border-color: #cfdcf5;
+    box-shadow: 0 2px 6px rgba(15,23,42,.06), 0 18px 50px rgba(47,109,246,.14);
+}
+.v2-choice:active { transform: translateY(-1px) scale(.995); }
+.v2-choice-ic {
+    width: 40px; height: 40px; border-radius: 11px; display: grid; place-items: center;
+    background: var(--accent-soft, #eaf1ff); color: var(--accent, #2f6df6); margin-bottom: 14px;
+}
+.v2-choice.alt .v2-choice-ic { background: var(--accent-green-soft, #e7f6ec); color: var(--accent-green, #16a34a); }
+.v2-choice h3 { margin: 0 0 6px; font-size: 17px; letter-spacing: -.01em; }
+.v2-choice p { margin: 0; color: var(--text-secondary, #475569); font-size: 13.5px; line-height: 1.5; }
+.v2-choice-tag {
+    position: absolute; top: 16px; right: 16px;
+    font-size: 10.5px; letter-spacing: .06em; text-transform: uppercase; color: var(--text-muted, #94a3b8);
+    border: 1px solid var(--border, #e4e9f0); border-radius: 999px; padding: 3px 9px;
+}
+.v2-choice-go {
+    margin-top: 16px; display: flex; align-items: center; gap: 6px;
+    color: var(--accent, #2f6df6); font-size: 13px; font-weight: 600;
+    opacity: 0; transform: translateX(-4px); transition: .26s cubic-bezier(.22,1,.36,1);
+}
+.v2-choice.alt .v2-choice-go { color: var(--accent-green, #16a34a); }
+.v2-choice:hover .v2-choice-go { opacity: 1; transform: none; }
+
+/* escape hatch — chat is the last resort, an obvious pill */
+.v2-escape { margin-top: 26px; display: flex; flex-direction: column; align-items: center; }
+.v2-escape-toggle {
+    display: inline-flex; align-items: center; gap: 7px; cursor: pointer; font: inherit; font-size: 13px;
+    background: var(--bg-card, #fff); border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
+    padding: 8px 15px; border-radius: 999px;
+    box-shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
+    transition: color .2s, border-color .2s, transform .2s cubic-bezier(.22,1,.36,1);
+}
+.v2-escape-toggle:hover { color: var(--text, #0f172a); border-color: #cfd9e6; transform: translateY(-1px); }
+.v2-escape-toggle .v2-escape-caret { display: inline-block; transition: transform .3s cubic-bezier(.22,1,.36,1); opacity: .55; }
+.v2-escape.open .v2-escape-toggle .v2-escape-caret { transform: rotate(180deg); }
+.v2-escape-field {
+    display: flex; align-items: center; gap: 8px; width: min(520px, 90vw);
+    max-height: 0; opacity: 0; overflow: hidden;
+    transition: max-height .4s cubic-bezier(.22,1,.36,1), opacity .4s cubic-bezier(.22,1,.36,1), margin .4s cubic-bezier(.22,1,.36,1);
+}
+.v2-escape.open .v2-escape-field { max-height: 64px; opacity: 1; margin-top: 12px; }
+.v2-escape-field input {
+    flex: 1; min-width: 0; border: 1px solid var(--border, #e4e9f0); background: var(--bg-card, #fff);
+    border-radius: 12px; padding: 12px 14px; font: inherit; font-size: 14px; color: var(--text, #0f172a);
+    outline: none; box-shadow: 0 1px 2px rgba(15,23,42,.04);
+    transition: border-color .2s, box-shadow .2s;
+}
+.v2-escape-field input:focus { border-color: var(--accent, #2f6df6); box-shadow: 0 0 0 4px rgba(47,109,246,.12); }
+.v2-escape-send {
+    appearance: none; border: 0; cursor: pointer; flex: none; width: 42px; height: 42px; border-radius: 12px;
+    background: var(--accent, #2f6df6); color: #fff; display: grid; place-items: center;
+    box-shadow: 0 6px 16px rgba(47,109,246,.35); transition: transform .2s cubic-bezier(.22,1,.36,1), filter .2s;
+}
+.v2-escape-send:hover { transform: translateY(-1px); filter: brightness(1.05); }
+
+/* one-way skip into the workspace (e.g. a reload mid-session) */
+.v2-landing-skip {
+    margin-top: 28px; background: none; border: 0; cursor: pointer; font: inherit; font-size: 12.5px;
+    color: var(--text-muted, #94a3b8); padding: 6px 10px; border-radius: 8px;
+    transition: color .2s;
+}
+.v2-landing-skip:hover { color: var(--text-secondary, #475569); }
+
+/* Under ux_v2 the landing IS the welcome moment, so the legacy home hero
+   (static "Welcome to Gently" + start button) would be a duplicate behind it —
+   hide it. The recent-* cards and the context surface stay. */
+body.ux-v2 .home-hero { display: none; }
+
+/* ── Two-screen system: welcome ↔ in-place plan wizard ───────── */
+.v2-landing-inner { max-width: 980px; }   /* widen for the plan layout */
+.v2-landing .v2-screen { display: none; width: 100%; }
+.v2-landing[data-screen="welcome"] .v2-screen-welcome {
+    display: flex; flex-direction: column; align-items: center;
+    max-width: 760px; margin: 0 auto;
+}
+.v2-landing[data-screen="plan"] .v2-screen-plan {
+    display: flex; flex-direction: column;
+    animation: v2land-rise .45s cubic-bezier(.22,1,.36,1) backwards;
+}
+
+/* plan header */
+.v2-plan-head { display: flex; align-items: center; gap: 12px; margin-bottom: 18px; }
+.v2-plan-orb { width: 34px; height: 34px; }
+.v2-plan-who { font-size: 11px; letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8); }
+.v2-plan-title { font-size: 18px; font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); }
+.v2-plan-back {
+    margin-left: auto; background: none; border: 0; cursor: pointer; font: inherit; font-size: 13px;
+    color: var(--text-muted, #94a3b8); padding: 6px 10px; border-radius: 8px; transition: color .2s, background .2s;
+}
+.v2-plan-back:hover { color: var(--text, #0f172a); background: rgba(15,23,42,.05); }
+
+/* plan body: ask stage + assembling plan */
+.v2-plan-wrap { display: grid; grid-template-columns: 1.35fr .9fr; gap: 20px; align-items: start; }
+@media (max-width: 720px) { .v2-plan-wrap { grid-template-columns: 1fr; } }
+.v2-plan-main { min-height: 220px; }
+.v2-plan-ask:empty { display: none; }
+.v2-plan-thinking { display: flex; align-items: center; gap: 9px; color: var(--text-muted, #94a3b8); font-size: 13.5px; padding: 22px 4px; }
+.v2-plan-thinking.hidden { display: none; }
+.v2-typing { display: inline-flex; gap: 5px; align-items: center; }
+.v2-typing i { width: 7px; height: 7px; border-radius: 50%; background: var(--accent, #2f6df6); opacity: .4; animation: v2-blink 1.1s infinite; }
+.v2-typing i:nth-child(2) { animation-delay: .15s; }
+.v2-typing i:nth-child(3) { animation-delay: .3s; }
+@keyframes v2-blink { 0%,100% { opacity: .25; transform: translateY(0); } 50% { opacity: 1; transform: translateY(-3px); } }
+
+.v2-plan-side {
+    background: var(--bg-card, #fff); border: 1px solid var(--border, #e4e9f0); border-radius: 14px; padding: 16px 18px;
+    box-shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
+}
+.v2-plan-side-h { font-size: 11px; letter-spacing: .1em; text-transform: uppercase; color: var(--text-muted, #94a3b8); margin-bottom: 12px; }
+.v2-plan-side-empty { color: var(--text-muted, #94a3b8); font-size: 13px; font-style: italic; }
+.v2-plan-row { display: flex; flex-direction: column; gap: 2px; padding: 9px 0; border-top: 1px dashed var(--border, #e4e9f0); }
+.v2-plan-row:first-child { border-top: 0; }
+.v2-plan-row .k { font-size: 10.5px; letter-spacing: .05em; text-transform: uppercase; color: var(--text-muted, #94a3b8); }
+.v2-plan-row .v { font-size: 14px; color: var(--text, #0f172a); font-weight: 550; }
+
+/* plan footer */
+.v2-plan-foot { display: flex; align-items: center; gap: 10px; margin-top: 22px; }
+.v2-plan-chat {
+    margin-right: auto; background: none; border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
+    border-radius: 999px; padding: 8px 14px; font: inherit; font-size: 13px; cursor: pointer; transition: border-color .2s, color .2s;
+}
+.v2-plan-chat:hover { border-color: #cfd9e6; color: var(--text, #0f172a); }
+.v2-plan-continue {
+    background: var(--accent, #2f6df6); color: #fff; border: 0; border-radius: 10px; padding: 10px 16px;
+    font: inherit; font-size: 13.5px; font-weight: 600; cursor: pointer; transition: transform .2s cubic-bezier(.22,1,.36,1), filter .2s;
+}
+.v2-plan-continue:hover { transform: translateY(-1px); filter: brightness(1.05); }
+
+@media (prefers-reduced-motion: reduce) {
+    .v2-landing, .v2-landing::before, .v2-landing-rise, .v2-landing-orb,
+    .v2-landing[data-screen="plan"] .v2-screen-plan, .v2-typing i {
+        animation: none !important;
+        transition-duration: .12s !important;
+    }
+}
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index c55c358a..33dcf2b3 100644
--- a/gently/ui/web/static/js/agent-chat.js
+++ b/gently/ui/web/static/js/agent-chat.js
@@ -12,6 +12,9 @@
 const AgentChat = (() => {
     let ws = null;
     let reconnectDelay = 1000;
+    // Commands/messages requested before the socket is open (e.g. from the
+    // landing, with the chat panel closed) — flushed in order on ws.onopen.
+    let pendingProgrammatic = [];
     const MAX_DELAY = 30000;
 
     let panelOpen = false;
@@ -743,11 +746,17 @@ const AgentChat = (() => {
         if (ws && ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify(obj));
     }
 
+    // Flush programmatic sends queued before the socket opened (see runCommand).
+    function flushProgrammatic() {
+        if (!pendingProgrammatic.length) return;
+        pendingProgrammatic.splice(0).forEach(t => actuallySend(t));
+    }
+
     function connect() {
         const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
         setConn(false, 'Connecting…');
         ws = new WebSocket(`${proto}//${location.host}/ws/agent`);
-        ws.onopen = () => { reconnectDelay = 1000; setConn(true); };
+        ws.onopen = () => { reconnectDelay = 1000; setConn(true); flushProgrammatic(); };
         ws.onclose = () => {
             setConn(false, 'Reconnecting…');
             setBusy(false);
@@ -1067,7 +1076,12 @@ const AgentChat = (() => {
     function runCommand(text) {
         if (!text) return;
         if (!hasControl) { renderControl(); return; }
-        actuallySend(text);
+        // Works whether or not the chat panel is open, so the landing can drive
+        // the agent (enter plan mode) without foregrounding the chat REPL. If the
+        // socket isn't up yet, queue and connect — it flushes on open.
+        if (ws && ws.readyState === WebSocket.OPEN) { actuallySend(text); return; }
+        pendingProgrammatic.push(text);
+        if (!ws) connect();
     }
 
     return { togglePanel, runCommand, buildAskCard, answerChoice, hasControl: () => hasControl };
diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
new file mode 100644
index 00000000..35eaf1fa
--- /dev/null
+++ b/gently/ui/web/static/js/landing.js
@@ -0,0 +1,214 @@
+/**
+ * V2Landing (ux_v2): the agent-first welcome AND the in-place plan wizard.
+ *
+ * The key paradigm fix: the plan dialogue renders IN THE LANDING, not the chat
+ * REPL. Clicking "Plan an experiment" doesn't recede to the dashboard — it
+ * switches the landing to a plan screen, enters plan mode, and renders the
+ * agent's ask_user_choice questions as button cards right there (#v2-plan-ask),
+ * reusing AgentChat.buildAskCard so it's the same card/answer path as elsewhere.
+ * The plan assembles on the right from each pick. Chat is never the surface
+ * (it's one click away via "Open conversation" as the last resort).
+ *
+ *   Plan an experiment → switch to plan screen; /plan + kickoff; asks render here
+ *   Take a quick look  → scope (Devices view)
+ *   "just tell me…"    → free-text into the agent loop (then chat as transcript)
+ *
+ * No-ops unless #v2-landing is present (flag off → v1 untouched, overlay absent).
+ */
+const V2Landing = (() => {
+    let el = null;
+    let current = null;  // { reqId, data, isWake } — the ask showing in the plan stage
+
+    const $ = (id) => document.getElementById(id);
+
+    function greet() {
+        const g = $('v2-landing-greeting');
+        if (!g) return;
+        const h = new Date().getHours();
+        const t = h < 5 ? 'Still here.' : h < 12 ? 'Good morning.'
+            : h < 18 ? 'Good afternoon.' : 'Good evening.';
+        g.innerHTML = t + '<br><span class="dim">What are we doing today?</span>';
+    }
+
+    function setScreen(name) { if (el) el.dataset.screen = name; }
+    function planActive() {
+        return !!el && el.dataset.screen === 'plan' && !el.classList.contains('dismissed')
+            && el.style.display !== 'none';
+    }
+
+    function dismiss() {
+        if (!el || el.classList.contains('dismissed')) return;
+        el.classList.add('dismissed');
+        let done = false;
+        const finish = () => {
+            if (done) return;
+            done = true;
+            el.style.display = 'none';
+            el.setAttribute('aria-hidden', 'true');
+        };
+        el.addEventListener('transitionend', finish, { once: true });
+        setTimeout(finish, 650);
+    }
+
+    // ── plan stage helpers ────────────────────────────────────────────
+    function showThinking(on) {
+        const t = $('v2-plan-thinking');
+        if (t) t.classList.toggle('hidden', !on);
+    }
+    function clearAsk() { const m = $('v2-plan-ask'); if (m) m.innerHTML = ''; }
+    function resetSummary() {
+        const list = $('v2-plan-summary');
+        if (list) list.innerHTML = '<div class="v2-plan-side-empty">Assembling from your choices…</div>';
+    }
+    function labelFor(data, sel) {
+        const opts = (data && data.options) || [];
+        const one = (s) => {
+            const o = opts.find(o => o && (o.id === s || o.value === s || o.label === s));
+            return o ? o.label : String(s);
+        };
+        if (Array.isArray(sel)) return sel.map(one).join(', ');
+        return one(sel);
+    }
+    function recordPick(data, sel) {
+        const list = $('v2-plan-summary');
+        if (!list) return;
+        const empty = list.querySelector('.v2-plan-side-empty');
+        if (empty) empty.remove();
+        const row = document.createElement('div');
+        row.className = 'v2-plan-row';
+        row.innerHTML = '<span class="k"></span><span class="v"></span>';
+        row.querySelector('.k').textContent = (data && data.question) || 'Choice';
+        row.querySelector('.v').textContent = labelFor(data, sel);
+        list.appendChild(row);
+    }
+    function renderAsk() {
+        const mount = $('v2-plan-ask');
+        if (!mount || !current || typeof AgentChat === 'undefined' || !AgentChat.buildAskCard) return;
+        showThinking(false);
+        const data = current.data, reqId = current.reqId;
+        const hasControl = AgentChat.hasControl ? AgentChat.hasControl() : true;
+        const card = AgentChat.buildAskCard(data, {
+            reqId, isWake: current.isWake, hasControl,
+            onPick: (sel) => {
+                recordPick(data, sel);
+                AgentChat.answerChoice(reqId, sel);
+                current = null;
+                clearAsk();
+                showThinking(true);  // agent computing the next step
+            },
+        });
+        mount.innerHTML = '';
+        mount.appendChild(card);
+    }
+
+    function startPlan() {
+        setScreen('plan');     // stay on the overlay; swap welcome → plan wizard
+        resetSummary();
+        clearAsk();
+        current = null;
+        showThinking(true);
+        // /plan deterministically enters plan mode; the kickoff draws out the
+        // first question, which the agent asks via ask_user_choice (its prompt
+        // mandates it) → renders here, not in chat. runCommand connects on its
+        // own and flushes both in order without opening the chat panel.
+        if (typeof AgentChat !== 'undefined' && AgentChat.runCommand) {
+            AgentChat.runCommand('/plan');
+            AgentChat.runCommand("Let's design this run — what should it capture?");
+        }
+    }
+
+    function openScope() {
+        dismiss();
+        if (typeof switchTab === 'function') switchTab('devices');
+    }
+
+    function sendFreeform(text) {
+        const v = (text || '').trim();
+        dismiss();  // free-text is the chat last-resort → recede, then open chat
+        if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
+            AgentChat.togglePanel(true);
+            if (v && AgentChat.runCommand) setTimeout(() => AgentChat.runCommand(v), 300);
+        }
+    }
+
+    function init() {
+        el = $('v2-landing');
+        if (!el || typeof ClientEventBus === 'undefined') return;  // flag off → no-op
+        greet();
+
+        // welcome choices
+        el.querySelectorAll('[data-landing]').forEach(btn => btn.addEventListener('click', () => {
+            const kind = btn.dataset.landing;
+            if (kind === 'plan') startPlan();
+            else if (kind === 'standalone') openScope();
+        }));
+
+        // welcome escape field
+        const esc = $('v2-escape'), escToggle = $('v2-escape-toggle'),
+            escInput = $('v2-escape-input'), escSend = $('v2-escape-send');
+        if (escToggle && esc && escInput) {
+            escToggle.addEventListener('click', () => {
+                const open = esc.classList.toggle('open');
+                if (open) setTimeout(() => escInput.focus(), 120);
+            });
+            const submit = () => sendFreeform(escInput.value);
+            if (escSend) escSend.addEventListener('click', submit);
+            escInput.addEventListener('keydown', e => {
+                if (e.key === 'Enter') { e.preventDefault(); submit(); }
+                else if (e.key === 'Escape') { e.stopPropagation(); esc.classList.remove('open'); }
+            });
+        }
+
+        const skip = $('v2-landing-skip');
+        if (skip) skip.addEventListener('click', dismiss);
+
+        // plan-screen controls
+        const back = $('v2-plan-back');
+        if (back) back.addEventListener('click', () => setScreen('welcome'));
+        const planChat = $('v2-plan-chat');
+        if (planChat) planChat.addEventListener('click', () => {
+            dismiss();  // chat panel lives under the overlay → recede first
+            if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
+                setTimeout(() => AgentChat.togglePanel(true), 300);
+            }
+        });
+        const cont = $('v2-plan-continue');
+        if (cont) cont.addEventListener('click', dismiss);
+
+        // The agent's questions render in the plan stage while it's active; once
+        // we've receded into the workspace, AskStage (#ask-stage) takes over.
+        ClientEventBus.on('AGENT_ASK', ({ request_id, choice_data, origin }) => {
+            if (!planActive()) return;
+            current = { reqId: request_id, data: choice_data || {}, isWake: origin === 'wake' };
+            renderAsk();
+        });
+        ClientEventBus.on('ASK_CLEARED', ({ request_id }) => {
+            if (request_id === '*' || (current && request_id === current.reqId)) {
+                current = null;
+                clearAsk();
+                if (planActive()) showThinking(true);
+            }
+        });
+        ClientEventBus.on('AGENT_CONTROL', () => { if (current && planActive()) renderAsk(); });
+
+        document.addEventListener('keydown', e => {
+            if (e.key !== 'Escape' || !el || el.classList.contains('dismissed')) return;
+            if (el.dataset.screen === 'plan') setScreen('welcome');  // step back, don't bail
+            else dismiss();
+        });
+    }
+
+    document.addEventListener('DOMContentLoaded', init);
+
+    return {
+        dismiss,
+        show: () => {
+            if (!el) return;
+            el.style.display = '';
+            el.removeAttribute('aria-hidden');
+            el.classList.remove('dismissed');
+            setScreen('welcome');
+            greet();
+        },
+    };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 9a4ff9dd..c972dc3d 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -17,8 +17,89 @@
     <link rel="stylesheet" href="/static/css/agent-chat.css">
     <link rel="stylesheet" href="/static/css/ask-stage.css">
     <link rel="stylesheet" href="/static/css/shell.css">
+    <link rel="stylesheet" href="/static/css/landing.css">
 </head>
 <body class="{% if ux_v2 %}ux-v2{% endif %}">
+    {% if ux_v2 %}
+    {# Agent-first welcome — shown on entry, recedes into the workspace once the
+       user picks a path. Chat is the last resort (the escape pill), not the
+       first thing. Only rendered when the flag is on. #}
+    <div id="v2-landing" class="v2-landing" data-screen="welcome" aria-label="Welcome to Gently">
+      <div class="v2-landing-inner">
+
+        {# ── Screen 1: welcome ── #}
+        <section class="v2-screen v2-screen-welcome">
+          <div class="v2-landing-agent v2-landing-rise" data-i="0">
+            <div class="v2-landing-orb"></div>
+            <div class="v2-landing-say" id="v2-landing-greeting">Hello.<br><span class="dim">What are we doing today?</span></div>
+          </div>
+
+          <div class="v2-landing-choices">
+            <button class="v2-choice v2-landing-rise" data-i="1" data-landing="plan">
+              <span class="v2-choice-tag">guided</span>
+              <span class="v2-choice-ic"><svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M4 19V5M4 7h11l-2-2M4 12h15l-2-2M4 17h9l-2-2"/></svg></span>
+              <h3>Plan an experiment</h3>
+              <p>Design a run with me — targets, cadence, and when to adapt. I'll handle the rest and keep watch.</p>
+              <span class="v2-choice-go">Start planning <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span>
+            </button>
+
+            <button class="v2-choice alt v2-landing-rise" data-i="2" data-landing="standalone">
+              <span class="v2-choice-tag">standalone</span>
+              <span class="v2-choice-ic"><svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7Z"/><circle cx="12" cy="12" r="3"/></svg></span>
+              <h3>Take a quick look</h3>
+              <p>Straight to the scope to see what's there — no plan, no commitment.</p>
+              <span class="v2-choice-go">Open the scope <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span>
+            </button>
+          </div>
+
+          <div class="v2-escape v2-landing-rise" data-i="3" id="v2-escape">
+            <button class="v2-escape-toggle" id="v2-escape-toggle">
+              <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2Z"/></svg>
+              or just tell me what you need
+              <span class="v2-escape-caret"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 9l6 6 6-6"/></svg></span>
+            </button>
+            <div class="v2-escape-field">
+              <input id="v2-escape-input" placeholder="e.g. watch these embryos overnight and ping me if one stalls" />
+              <button class="v2-escape-send" id="v2-escape-send" aria-label="Send"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 2L11 13M22 2l-7 20-4-9-9-4 20-7Z"/></svg></button>
+            </div>
+          </div>
+
+          <button class="v2-landing-skip" id="v2-landing-skip">Skip to workspace ›</button>
+        </section>
+
+        {# ── Screen 2: the plan wizard, hosted IN the landing. The agent's
+           ask_user_choice questions render here as button cards (#v2-plan-ask),
+           NOT in the chat panel. The plan assembles on the right as you pick. #}
+        <section class="v2-screen v2-screen-plan">
+          <div class="v2-plan-head">
+            <span class="v2-landing-orb v2-plan-orb"></span>
+            <div class="v2-plan-headtext">
+              <div class="v2-plan-who">Gently · planning</div>
+              <div class="v2-plan-title">Let's design your run</div>
+            </div>
+            <button class="v2-plan-back" id="v2-plan-back">‹ Back</button>
+          </div>
+          <div class="v2-plan-wrap">
+            <div class="v2-plan-main">
+              <div class="v2-plan-ask" id="v2-plan-ask" aria-live="polite"></div>
+              <div class="v2-plan-thinking" id="v2-plan-thinking"><span class="v2-typing"><i></i><i></i><i></i></span> thinking through the next step…</div>
+            </div>
+            <aside class="v2-plan-side">
+              <div class="v2-plan-side-h">The plan</div>
+              <div class="v2-plan-side-list" id="v2-plan-summary">
+                <div class="v2-plan-side-empty">Assembling from your choices…</div>
+              </div>
+            </aside>
+          </div>
+          <div class="v2-plan-foot">
+            <button class="v2-plan-chat" id="v2-plan-chat">Open conversation</button>
+            <button class="v2-plan-continue" id="v2-plan-continue">Continue in workspace ›</button>
+          </div>
+        </section>
+
+      </div>
+    </div>
+    {% endif %}
     {% include '_header.html' %}
     {% include '_navbar.html' %}
     <!-- App shell: main content + docked agent panel (flex row for pin-to-dock).
@@ -672,5 +753,6 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/ask-stage.js"></script>
     <script src="/static/js/shell.js"></script>
     <script src="/static/js/context-surface.js"></script>
+    <script src="/static/js/landing.js"></script>
 </body>
 </html>

From 37bc534bffa372ef81f1b3b074887ab8ae66956f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 07:39:28 +0530
Subject: [PATCH 096/314] Add UX v2 entry-paradigm prototype + migration plan
 (design reference)

Self-contained landing prototype (ux-prototype/landing.html) and the 8-phase migration plan it was built from. A sketch space, kept separate from the live frontend.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 ux-prototype/MIGRATION-PLAN.md | 102 +++++
 ux-prototype/landing.html      | 674 +++++++++++++++++++++++++++++++++
 2 files changed, 776 insertions(+)
 create mode 100644 ux-prototype/MIGRATION-PLAN.md
 create mode 100644 ux-prototype/landing.html

diff --git a/ux-prototype/MIGRATION-PLAN.md b/ux-prototype/MIGRATION-PLAN.md
new file mode 100644
index 00000000..8e906515
--- /dev/null
+++ b/ux-prototype/MIGRATION-PLAN.md
@@ -0,0 +1,102 @@
+# Gently web UI → agent-first paradigm: migration plan
+
+Strangler-fig migration of the **existing** stack (FastAPI + Jinja2 + vanilla-JS, `gently/ui/web/`). **No SPA rewrite.** Everything new is gated behind a `GENTLY_UX_V2` flag and layered onto the seams that already exist. Target paradigm is the prototype in `ux-prototype/landing.html`.
+
+## Why this is cheap (the load-bearing discoveries)
+
+- **The structured-ask protocol already exists as data.** The agent emits `{type:'choice_request', request_id, choice_data:{question, options[], _type, allow_multiple}}` over `/ws/agent` (`conversation.py:617`, `bridge.stream_response:648`); the client replies `{type:'choice_response', request_id, selected}` (`agent_ws.py:769`). "One payload, two renderers" = add a `_kind` discriminator + factor `agent-chat.js renderChoice` (L356-390) into a pure `buildAskCard()` + a second mount. **Not a protocol rewrite.**
+- **There's already an inference-first precedent**: `bridge.bootstrap_resolution_picker` builds inferred pickers in-memory from candidates without persisting. Plan-mode's draft-first flow models on it.
+- **One init chokepoint**: `switchTab(name)` (`app.js:60-103`) is the *only* caller of every tab's manager init. The new shell **calls** it for each region reveal — never reimplements activation.
+- **Two separate sockets**: `/ws` (telemetry + server `EventBus` fan-out) and `/ws/agent` (chat + asks). They have different lifecycles — the context surface (Phase 4) rides `/ws`, the ask-stage rides `/ws/agent`.
+
+## Coexistence (how old + new run side by side)
+
+A Jinja2 flag: `pages.py GET /` passes `ux_v2` (new `GENTLY_UX_V2` setting, default off) into `index.html`. The template keeps **both** the current 8-tab markup and the new grouped-rail markup, mutually exclusive via `{% if ux_v2 %}` + a `body.ux-v2` class. New JS modules (`status-store.js`, `ask-stage.js`, `shell.js`, `context-surface.js`) load on every page but **no-op without `body.ux-v2`**, so they can't regress v1. Same URL, same shell, same uvicorn process. Flip default-on after a soak (Phase 6), then delete v1 markup. Both UIs read the same state objects and sockets, so v1/v2 can be compared side-by-side on identical live data.
+
+> CSS hazard: `main.css` has **duplicate** `.tab`/`.tab-content`/`.status-dot` rulesets (~L547 and ~L2892). Consolidate or strictly scope v2 under `body.ux-v2` **before** Phase 2 touches nav CSS.
+
+## Phase sequence
+
+| # | Phase | Ships | Flag | Depends |
+|---|-------|-------|------|---------|
+| 0 | Bug-fix beachhead: sticky status store + idle-telemetry | Status unification + quiet idle channel, **to prod now** | none | — |
+| 1 | Dual-render the ask protocol + correct clear-signal | The paradigm enabler | ux_v2 | 0 |
+| 2 | Shell unfold + grouped nav + session-context strip | The calm welcome→workspace | ux_v2 | 1 |
+| 3a | Inference-first plan mode **backend** (headless) | Draft-from-strain + per-field provenance | — | 2 |
+| 3b | Inference-first plan mode **UI** (`plan_confirm` renderer) | Draft renders with provenance | ux_v2 | 3a |
+| 4 | Co-editable FileContextStore surface + proactive cards | Shared visibility (beliefs/attention/uncertainty) | ux_v2 | 3b |
+| 5 | Carve per-embryo tactical Experiment view out of `embryos.js` | The tactical view mount (contents TBD) | ux_v2 | 4 |
+| 6 | Default-on flip + v1 deletion | Irreversible cutover, isolated/soaked | flip | 5 |
+
+## Phase detail
+
+### Phase 0 — Bug-fix beachhead (no flag, pure value)
+- **Single sticky/replaying `ConnectionStatus` store** (`status-store.js`) holding `{gentlyConnected, microscopeConnected, agentConnected}` and emitting `CONNECTION_STATUS`. Must **replay last state to late subscribers** or bug #1 just moves.
+- **Bug #1**: header pill (`updateTopLevelDot` `app.js:562`), home line (`home.js updateStatus:136` — today reads `state.connected` once, the literal "Offline while connected" bug), and dock dot all **subscribe** and re-render on every event.
+- **Bug #3 (measure first)**: code shows **15s** polls (not 1-2s); the real idle cost is likely the ~5Hz `DEVICE_STATE_UPDATE` WS stream. **Ship unconditionally:** decouple `#events-count` from `DEVICE_STATE_UPDATE`/`BOTTOM_CAMERA_FRAME`. **Gate polls only if** measurement implicates them; if it's the SSE stream, coalesce/backoff in `device_state_monitor.py`. Gate on a stable `DevicesManager.active` flag, **not** switchTab internals (Phase 2 rewrites those).
+- **Bug #2**: capture the prototype's correct multi-select contract (Continue mounts with disabled state *derived from current selection*) for `buildAskCard`.
+- Files: `status-store.js` (new), `websocket.js`, `app.js`, `home.js`, `agent-chat.js`, `devices.js`, `events.js`, `index.html`.
+- Verify: cold + reload + kill each socket independently — all three indicators agree within one handshake; kill device layer → microscope badge flips in 15s, gently stays Online.
+
+### Phase 1 — Dual-render the ask protocol (the enabler)
+- `_kind` always-present discriminator + additive `_surface` ∈ {transcript,stage,both} (default transcript so the Ink TUI/older clients are unaffected). Set on each payload the bridge builds.
+- Factor `renderChoice` → pure `buildAskCard()` + a module-level `answered` Set keyed by **opaque** `request_id` (never parse a prefix — ids mix `req_N` and `resolve_*_<uuid>`). New `ask-stage.js` renders the same card into `#ask-stage`.
+- **BLOCKER fixed — clear signal**: fire `ASK_CLEARED` the instant a `choice_response` is sent (plus on cancel/error/control-loss/socket-close), **not** on `stream_end` — an in-turn ask suspends on `asend` (`bridge.py:657`) and `stream_end` only arrives *after* the answer; a cancelled turn emits none.
+- **BLOCKER fixed — dismiss vs control**: `agent_ws.py:772` silently drops non-holder responses. Stage renders read-only when `!hasControl`; only the holder answers/dismisses; a holder's escape posts a real empty `choice_response` so the turn-lock releases.
+- **BLOCKER fixed — leak cleanup**: pop orphaned `_choice_futures` on holder-change and answerer-disconnect, not only last-client (`agent_ws.py:889`).
+- Add the **free-text "Something else"** affordance web cards lack today (`bridge._dispatch_resolution_pick:462` already routes unknown selections to LLM resolution).
+- Verify: trigger the session-open bootstrap picker — appears in chat **and** `#ask-stage`; answering either clears both; cancel a turn mid-ask → stage clears and next turn works; lose control mid-ask → stage goes read-only.
+
+### Phase 2 — Shell unfold + grouped nav + session strip
+- `shell.js` screen-state machine sets `body[data-screen]` (welcome|plan|standalone|shell) and **calls `switchTab()`** for every reveal (+ a dev assertion if a region shows without its init).
+- Grouped left rail (Now / Library / System) → each item maps to an existing `data-tab` id via `switchTab`. Session-context strip reuses `ExperimentStrip` (fix stale `switchTab('tasks')` at `experiment-strip.js:176`), fed by `/api/experiments/current/strategy`, reading live status from the Phase 0 store.
+- **Real routing**: replace the consume-once hash (`app.js:633` `replaceState` to `/`) with deliberate URL/state sync so refresh/back-button + the `/review`→`/#sessions` redirects resolve correctly.
+- Decouple welcome→plan from the brittle `togglePanel(true)+setTimeout(250ms,'/wizard')` (`home.js:159`): the picker renders in `#ask-stage` on connect, driven by the bootstrap `choice_request`.
+- **Resume**: replace the `window.location.href='/'` hard reload on `session_changed` (`websocket.js:147`, `review.js:108`) with in-place re-hydration (jarring otherwise).
+- Verify: cold load → calm welcome; choosing a plan unfolds (no hard cut); each rail item fires its manager's init side-effect (verify the side-effect, not just visibility).
+
+### Phase 3a — Inference-first plan backend (headless-testable)
+- Flip the plan-mode prompt from ask-first to **infer-first** (`plan_mode_system_prompt.tex`, `harness/plan_mode/prompt.py`): arrive with a draft, ask only for genuine gaps / low-confidence / consequential confirmations.
+- Deterministic **strain→channel** inference in `research.py`: parse genotype from `search_strains` (TagRFP→561, GFP→488), attach source ref. **Must degrade to "confirm" — never fabricate a wavelength.** Network-dependent (WormBase REST + CGC scraping), so the degrade path is load-bearing.
+- **Per-field provenance** (`model.py:186`): `ImagingSpec` fields are flat scalars with no per-field source (`references[]` is on `PlanItem`, not the spec). Add a parallel `{field → {source, confidence, citation}}` map; reuse the existing `Confidence` enum.
+- **Drafts stay in-memory** (like `bootstrap_resolution_picker`), materialized via `create_campaign`/`create_plan_item` only on explicit confirm — avoids a `PlanItemStatus` enum change *and* orphan-folder cleanup.
+- Use `gap_assessment.assess_gaps()` to *select* which gaps to ask (don't re-enable the deliberately-disabled multi-question wizard; note `conversation_weight` short-circuits after onboarding).
+- Verify (no UI): known strain → draft with channels pre-filled + per-field source/confidence; unknown/offline → "confirm channel", never fabricated; reject → no folder written; confirm → materializes and `GET /api/campaigns/{id}/document` returns the tree.
+
+### Phase 3b — Inference-first plan UI
+- `_kind:'plan_confirm'` ask: bridge emits the in-memory draft as `choice_data`; `ask-stage.js` renders cards with per-field source tags + confidence + edit affordances; chat shows a **compact reference line** (not a duplicate) so the surfaces can't drift.
+- Extend `renderSpec` (`agent-chat.js:403`, today a flat key→value table) with a **source column**.
+- Confirm posts the same `choice_response`; bridge materializes; stage clears via `ASK_CLEARED`.
+
+### Phase 4 — Co-editable context surface + proactive cards
+- **BLOCKER fixed — real store change**: `FileContextStore` has no event bus. (1) add `CONTEXT_UPDATED` to the closed `EventType` enum (`core/event_bus.py`); (2) inject a bus/callback into the store; (3) emit a **single coalesced** event from each mutator (`add_expectation:1880`, `add_watchpoint:1933`, `add_question:1980`, `update_embryo_understanding:2049`, …); (4) wire in `launch_gently.py:497`.
+- New `routes/context.py`: **read** side models on `campaigns.py` (`_serialize`); **write** side uses `Depends(require_control)` from `data.py`/`sessions.py` (NOT the `campaigns.py` mesh/account auth) so a viewer can't mutate the agent's mind.
+- Live updates over `/ws` (telemetry socket) → `websocket.js:117` → `context-surface.js`. **Push on change, never poll** (`load_active` scans ~50 observations + YAML).
+- `context-surface.js` renders beliefs/attention/uncertainty as a calm panel in the Now region with inline edit/resolve (disabled when `!hasControl`).
+- **Proactive cards**: wire watchpoint/question creation + the existing wake-router `origin:'wake'` approvals (`agent.py:1079`) to surface prominent `#ask-stage` cards — real backing for the prototype's attention card, no new mechanism.
+
+### Phase 5 — Carve the tactical Experiment view (behind the flag, before the flip)
+- Make Experiment a distinct renderer over `EmbryosManager.state` + the strategy snapshot rather than overloading the 4556-line `embryos.js`. **Preserve `reconcileWithServerState`/`clearAllState` as the contract.** Don't over-specify contents yet — it's a mount point.
+- **Remove the `STUB_STRATEGY` fallback** (`experiment-overview.js:14` + the "mockup · stubbed data" badge) → real loading/empty state. Production must never render stubs.
+- Stays behind the flag through its own soak so a reconciliation regression is caught before the irreversible flip.
+
+### Phase 6 — Default-on flip + v1 cleanup (irreversible, isolated)
+- Flip `GENTLY_UX_V2` default-on after soak; delete v1 `{% else %}` nav markup, superseded v1 status writers, and the dead/duplicate `.tab` CSS. Isolated from Phase 5 so the high-regression carve-out never coincides with deletion.
+
+## Blockers the adversarial pass caught (now folded in)
+1. **Clear signal must follow the choice lifecycle, not the stream lifecycle** (asend suspension; cancelled turns emit no `stream_end`).
+2. **Dismiss vs control gate** — non-holder responses are silently dropped; only the holder dismisses; server cleans orphaned futures on holder-change/disconnect.
+3. **Phase 4 store change is real, not free** — new `EventType`, bus injection, coalesced emit from every mutator, launch wiring.
+4. Two answer paths (`_choice_futures` vs bridge-owned `_pending_import`) → client-authoritative `answered` Set + bridge idempotency guard.
+5. `switchTab` is the sole init chokepoint → shell calls it, never reimplements.
+6. Per-field provenance doesn't exist today → added in 3a.
+7. Phase 3 split into headless backend (3a) + UI (3b); embryos.js carve-out isolated in Phase 5.
+
+## Open decisions (yours)
+- **Measure bug #3 first**: is idle chatter the ~5Hz `DEVICE_STATE_UPDATE` stream or the 15s polls? Determines the lever (coalesce in `device_state_monitor.py` vs gate polls).
+- **Status**: client-computed sticky store (chosen for Phase 0) vs a single server-emitted status object over `/ws`.
+- **Routing**: History API vs hash-fragment for region state (keeping the `/review`→`/#sessions` redirects working without reload).
+- **Co-edit concurrency**: optimistic last-write-wins vs per-item version/lock, given the agent mutates the same YAML.
+- **Slash-command demotion**: re-render `/status`,`/embryos` rich content as affordances vs button-per-command.
+- **Per-field provenance schema**: parallel map on `ImagingSpec` vs sibling dataclass vs extending `PlanItem.references[]`.
+- **Experiment tactical view contents** — deferred to Phase 5 design.
diff --git a/ux-prototype/landing.html b/ux-prototype/landing.html
new file mode 100644
index 00000000..59e7bd94
--- /dev/null
+++ b/ux-prototype/landing.html
@@ -0,0 +1,674 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Gently — entry paradigm sketch</title>
+<style>
+  :root {
+    --bg: #f6f8fb;
+    --ink: #0f172a;
+    --ink-soft: #475569;
+    --muted: #94a3b8;
+    --line: #e4e9f0;
+    --card: #ffffff;
+    --blue: #2f6df6;
+    --blue-soft: #eaf1ff;
+    --green: #16a34a;
+    --green-soft: #e7f6ec;
+    --shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
+    --shadow-lift: 0 2px 6px rgba(15,23,42,.06), 0 18px 50px rgba(47,109,246,.14);
+    --ease: cubic-bezier(.22,1,.36,1);
+    --r: 18px;
+    --dur: .52s;
+  }
+  * { box-sizing: border-box; }
+  html, body { height: 100%; margin: 0; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, Roboto, system-ui, sans-serif;
+    color: var(--ink);
+    background:
+      radial-gradient(1100px 700px at 78% -8%, #eaf1ff 0%, transparent 55%),
+      radial-gradient(900px 600px at 8% 108%, #eafaf0 0%, transparent 55%),
+      var(--bg);
+    -webkit-font-smoothing: antialiased;
+    overflow: hidden;
+  }
+  body::before {
+    content: ""; position: fixed; inset: -20vmax;
+    background: radial-gradient(closest-side, rgba(47,109,246,.10), transparent 70%);
+    filter: blur(30px); animation: drift 26s var(--ease) infinite alternate;
+    pointer-events: none; z-index: 0;
+  }
+  @keyframes drift { 0%{ transform: translate(-6vw,-4vh) scale(1);} 100%{ transform: translate(8vw,6vh) scale(1.15);} }
+
+  .shell { position: relative; z-index: 1; height: 100%; display: flex; flex-direction: column; }
+
+  /* top bar */
+  .topbar { display: flex; align-items: center; justify-content: space-between; padding: 18px 26px; flex: none; }
+  .brand { display: flex; align-items: center; gap: 9px; font-weight: 650; letter-spacing: -.01em; font-size: 16px; }
+  .brand .mark { width: 22px; height: 22px; border-radius: 7px; background: linear-gradient(135deg, var(--blue), #6aa0ff); box-shadow: 0 2px 10px rgba(47,109,246,.4); position: relative; }
+  .brand .mark::after { content:""; position:absolute; inset:6px; border-radius:50%; background: rgba(255,255,255,.92); }
+  .topbar-right { display: flex; align-items: center; gap: 10px; }
+
+  .pill { display: inline-flex; align-items: center; gap: 8px; padding: 7px 13px; border-radius: 999px; background: var(--card); border: 1px solid var(--line); font-size: 12.5px; color: var(--ink-soft); box-shadow: var(--shadow); }
+  .pill .dot { width: 8px; height: 8px; border-radius: 50%; background: var(--green); animation: breathe 3.4s ease-in-out infinite; }
+  @keyframes breathe { 0%,100%{ box-shadow: 0 0 0 0 rgba(22,163,74,.45);} 50%{ box-shadow: 0 0 0 5px rgba(22,163,74,0);} }
+  .pill .mono { font-variant-numeric: tabular-nums; color: var(--muted); }
+
+  .ghost-btn { appearance: none; border: 1px solid var(--line); background: var(--card); color: var(--ink-soft); border-radius: 999px; padding: 7px 14px; font-size: 13px; cursor: pointer; box-shadow: var(--shadow); transition: transform .2s var(--ease), border-color .2s, color .2s, opacity .3s; display: inline-flex; align-items: center; gap: 7px; }
+  .ghost-btn:hover { transform: translateY(-1px); border-color: #cfd9e6; color: var(--ink); }
+  .back-btn { opacity: 0; pointer-events: none; }
+  body[data-screen]:not([data-screen="landing"]) .back-btn { opacity: 1; pointer-events: auto; }
+
+  /* stage / screens */
+  .stage { position: relative; flex: 1; min-height: 0; }
+  .screen { position: absolute; inset: 0; display: flex; flex-direction: column; align-items: center; justify-content: center; padding: 12px 24px 40px; opacity: 0; visibility: hidden; transform: translateY(10px) scale(.992); transition: opacity var(--dur) var(--ease), transform var(--dur) var(--ease), visibility var(--dur); pointer-events: none; }
+  .screen.is-active { opacity: 1; visibility: visible; transform: none; pointer-events: auto; }
+  .screen.is-active .rise { animation: rise .6s var(--ease) backwards; }
+  .rise { animation-delay: calc(var(--i, 0) * 70ms); }
+  @keyframes rise { from { opacity: 0; transform: translateY(14px); } to { opacity: 1; transform: none; } }
+
+  /* agent presence */
+  .agent { display: flex; flex-direction: column; align-items: center; gap: 16px; }
+  .orb { width: 52px; height: 52px; border-radius: 50%; position: relative; background: radial-gradient(closest-side at 38% 34%, #ffffff, #bcd3ff 40%, var(--blue) 100%); box-shadow: 0 6px 22px rgba(47,109,246,.45), inset 0 0 12px rgba(255,255,255,.6); animation: orbBreathe 4s ease-in-out infinite; }
+  @keyframes orbBreathe { 0%,100%{ transform: scale(1);} 50%{ transform: scale(1.06);} }
+  .say { font-size: clamp(20px, 3vw, 28px); font-weight: 600; letter-spacing: -.02em; text-align: center; max-width: 22ch; line-height: 1.25; }
+  .say .dim { color: var(--muted); font-weight: 500; }
+
+  /* typing dots */
+  .typing { display: inline-flex; gap: 5px; height: 20px; align-items: center; }
+  .typing i { width: 7px; height: 7px; border-radius: 50%; background: var(--blue); opacity:.4; animation: blink 1.1s infinite; }
+  .typing i:nth-child(2){ animation-delay: .15s; } .typing i:nth-child(3){ animation-delay: .3s; }
+  @keyframes blink { 0%,100%{ opacity:.25; transform: translateY(0);} 50%{ opacity:1; transform: translateY(-3px);} }
+
+  /* choice cards (landing) */
+  .choices { display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 18px; margin-top: 34px; width: min(720px, 92vw); }
+  .choice { text-align: left; cursor: pointer; border: 1px solid var(--line); background: var(--card); border-radius: var(--r); padding: 22px 22px 20px; box-shadow: var(--shadow); transition: transform .26s var(--ease), box-shadow .26s var(--ease), border-color .26s; position: relative; overflow: hidden; }
+  .choice:hover { transform: translateY(-4px); box-shadow: var(--shadow-lift); border-color: #cfdcf5; }
+  .choice:active { transform: translateY(-1px) scale(.995); }
+  .choice .ic { width: 40px; height: 40px; border-radius: 11px; display: grid; place-items: center; background: var(--blue-soft); color: var(--blue); margin-bottom: 14px; }
+  .choice.alt .ic { background: var(--green-soft); color: var(--green); }
+  .choice h3 { margin: 0 0 6px; font-size: 17px; letter-spacing: -.01em; }
+  .choice p { margin: 0; color: var(--ink-soft); font-size: 13.5px; line-height: 1.5; }
+  .choice .tag { position: absolute; top: 16px; right: 16px; font-size: 10.5px; letter-spacing: .06em; text-transform: uppercase; color: var(--muted); border: 1px solid var(--line); border-radius: 999px; padding: 3px 9px; }
+  .choice .go { margin-top: 16px; display:flex; align-items:center; gap:6px; color: var(--blue); font-size: 13px; font-weight: 600; opacity: 0; transform: translateX(-4px); transition: .26s var(--ease); }
+  .choice.alt .go { color: var(--green); }
+  .choice:hover .go { opacity: 1; transform: none; }
+
+  /* landing escape hatch (chat = last resort) — now an obvious pill */
+  .escape { margin-top: 26px; display: flex; flex-direction: column; align-items: center; }
+  .escape-toggle { display:inline-flex; align-items:center; gap:7px; background: var(--card); border: 1px solid var(--line); color: var(--ink-soft); font-size: 13px; cursor: pointer; padding: 8px 15px; border-radius: 999px; box-shadow: var(--shadow); transition: color .2s, border-color .2s, transform .2s var(--ease); }
+  .escape-toggle:hover { color: var(--ink); border-color: #cfd9e6; transform: translateY(-1px); }
+  .escape-toggle .caret { display:inline-block; transition: transform .3s var(--ease); opacity:.55; }
+  .escape.open .escape-toggle .caret { transform: rotate(180deg); }
+  .escape-field { display: flex; align-items: center; gap: 8px; width: min(520px, 90vw); max-height: 0; opacity: 0; overflow: hidden; transition: max-height .4s var(--ease), opacity .4s var(--ease), margin .4s var(--ease); }
+  .escape.open .escape-field { max-height: 64px; opacity: 1; margin-top: 12px; }
+  .escape-field input { flex: 1; border: 1px solid var(--line); background: var(--card); border-radius: 12px; padding: 12px 14px; font-size: 14px; color: var(--ink); box-shadow: var(--shadow); outline: none; transition: border-color .2s, box-shadow .2s; }
+  .escape-field input:focus { border-color: var(--blue); box-shadow: 0 0 0 4px rgba(47,109,246,.12); }
+  .send { appearance:none; border:0; cursor:pointer; width: 42px; height: 42px; border-radius: 12px; background: var(--blue); color: #fff; display:grid; place-items:center; box-shadow: 0 6px 16px rgba(47,109,246,.35); transition: transform .2s var(--ease), filter .2s; flex: none; }
+  .send:hover { transform: translateY(-1px); filter: brightness(1.05); }
+  .send.sm { width: 40px; height: 40px; }
+
+  /* plan mode */
+  .plan-wrap { width: min(960px, 94vw); display: grid; grid-template-columns: 1.35fr .9fr; gap: 22px; align-items: start; }
+  @media (max-width: 760px){ .plan-wrap { grid-template-columns: 1fr; } }
+  .ask-card, .plan-card { background: var(--card); border: 1px solid var(--line); border-radius: var(--r); box-shadow: var(--shadow); }
+  .ask-card { padding: 24px; min-height: 340px; }
+  .ask-head { display: flex; align-items: center; gap: 12px; margin-bottom: 4px; }
+  .ask-head .mini-orb { width: 30px; height: 30px; border-radius: 50%; flex:none; background: radial-gradient(closest-side at 38% 34%, #fff, #bcd3ff 42%, var(--blue) 100%); box-shadow: 0 3px 10px rgba(47,109,246,.4); animation: orbBreathe 4s ease-in-out infinite; }
+  .ask-head .who { font-size: 11.5px; letter-spacing: .08em; text-transform: uppercase; color: var(--muted); }
+  .step-back { margin-left: auto; background: none; border: 0; color: var(--muted); font-size: 12.5px; cursor: pointer; padding: 5px 9px; border-radius: 8px; display: none; align-items: center; gap: 4px; transition: color .2s, background .2s; }
+  .step-back:hover { color: var(--ink); background: #f1f5f9; }
+  .step-back.show { display: inline-flex; }
+  .ask-prompt { font-size: 19px; font-weight: 600; letter-spacing: -.01em; margin: 12px 0 18px; line-height: 1.35; min-height: 26px; }
+
+  .opts { display: grid; gap: 10px; }
+  .opt { display: flex; align-items: center; gap: 13px; text-align: left; cursor: pointer; border: 1px solid var(--line); background: #fff; border-radius: 13px; padding: 14px 15px; transition: transform .2s var(--ease), border-color .2s, box-shadow .2s, background .2s; }
+  .opt:hover { transform: translateX(3px); border-color: #cfdcf5; box-shadow: var(--shadow); }
+  .opt .otick { width: 30px; height: 30px; border-radius: 9px; flex:none; display:grid; place-items:center; background: var(--blue-soft); color: var(--blue); transition: background .2s, color .2s; }
+  .opt.primary { border-color: #bfe6cc; background: var(--green-soft); }
+  .opt.primary .otick { background: #d2efda; color: var(--green); }
+  .opt .ol b { display:block; font-size: 14.5px; letter-spacing: -.01em; }
+  .opt .ol span { font-size: 12.5px; color: var(--ink-soft); }
+  /* multi-select look */
+  .opt.multi .otick { border-radius: 8px; background: #fff; color: #fff; border: 1.5px solid #cbd5e1; }
+  .opt.multi.selected { border-color: #bfe6cc; background: var(--green-soft); }
+  .opt.multi.selected .otick { background: var(--green); border-color: var(--green); }
+
+  .ask-action { margin-top: 14px; display: none; }
+  .ask-action.show { display: block; }
+  .continue-btn { width: 100%; appearance:none; border:0; cursor:pointer; padding: 13px; border-radius: 12px; background: var(--blue); color:#fff; font-size: 14.5px; font-weight: 650; box-shadow: 0 6px 16px rgba(47,109,246,.32); transition: transform .2s var(--ease), filter .2s, opacity .2s; }
+  .continue-btn:hover:not(:disabled) { transform: translateY(-1px); filter: brightness(1.05); }
+  .continue-btn:disabled { opacity: .42; cursor: not-allowed; box-shadow:none; }
+
+  /* inline escape-to-text within a step (no more alert) */
+  .ask-escape { display: flex; gap: 8px; align-items: center; max-height: 0; opacity: 0; overflow: hidden; transition: max-height .34s var(--ease), opacity .34s var(--ease), margin .34s var(--ease); }
+  .ask-escape.open { max-height: 60px; opacity: 1; margin-top: 12px; }
+  .ask-escape input { flex:1; border: 1px solid var(--line); background:#fff; border-radius: 11px; padding: 11px 13px; font-size: 14px; color: var(--ink); outline: none; transition: border-color .2s, box-shadow .2s; }
+  .ask-escape input:focus { border-color: var(--blue); box-shadow: 0 0 0 4px rgba(47,109,246,.12); }
+  .opt-escape { margin-top: 14px; }
+  .opt-escape button { background:none; border:0; color: var(--muted); font-size: 12.5px; cursor:pointer; padding: 4px; }
+  .opt-escape button:hover { color: var(--ink-soft); }
+
+  .swap-leave { opacity: 0; transform: translateY(-8px); transition: opacity .22s var(--ease), transform .22s var(--ease); }
+  .swap-enter { opacity: 0; transform: translateY(10px); }
+  .swap-enter.in { opacity: 1; transform: none; transition: opacity .34s var(--ease), transform .34s var(--ease); }
+
+  .plan-card { padding: 20px 20px 18px; }
+  .plan-card h4 { margin: 0 0 4px; font-size: 12px; letter-spacing: .1em; text-transform: uppercase; color: var(--muted); }
+  .plan-card .sub { font-size: 12.5px; color: var(--muted); margin: 0 0 14px; }
+  .plan-list { display: flex; flex-direction: column; gap: 0; }
+  .plan-item { display: flex; gap: 11px; padding: 11px 0; border-top: 1px dashed var(--line); }
+  .plan-item:first-child { border-top: 0; }
+  .plan-item .k { font-size: 11px; letter-spacing: .06em; text-transform: uppercase; color: var(--muted); width: 78px; flex:none; padding-top: 2px; }
+  .plan-item .v { font-size: 14px; color: var(--ink); font-weight: 550; }
+  .plan-item.fresh { opacity: 0; transform: translateX(12px); }
+  .plan-item.fresh.in { opacity: 1; transform: none; transition: opacity .4s var(--ease), transform .4s var(--ease); }
+  .plan-empty { color: var(--muted); font-size: 13px; font-style: italic; padding: 10px 0; }
+  .plan-cta { margin-top: 16px; display: none; }
+  .plan-cta.show { display: block; animation: rise .5s var(--ease); }
+  .run-btn { width: 100%; appearance:none; border:0; cursor:pointer; padding: 14px; border-radius: 13px; background: var(--green); color:#fff; font-size: 15px; font-weight: 650; letter-spacing: -.01em; box-shadow: 0 8px 22px rgba(22,163,74,.35); transition: transform .2s var(--ease), filter .2s; }
+  .run-btn:hover { transform: translateY(-2px); filter: brightness(1.04); }
+
+  .steps { display:flex; gap:7px; margin-top: 18px; justify-content:center; }
+  .steps i { width: 22px; height: 4px; border-radius: 99px; background: var(--line); transition: background .3s, transform .2s; }
+  .steps i.on { background: var(--blue); }
+  .steps i.done { background: #b9ccf7; cursor: pointer; }
+  .steps i.done:hover { background: var(--blue); transform: scaleY(1.6); }
+
+  /* standalone & running */
+  .panel { width: min(560px, 92vw); background: var(--card); border: 1px solid var(--line); border-radius: var(--r); box-shadow: var(--shadow); padding: 30px; text-align: center; }
+  .panel .ic-lg { width: 56px; height: 56px; border-radius: 16px; display:grid; place-items:center; margin: 0 auto 16px; background: var(--green-soft); color: var(--green); }
+  .panel h3 { margin: 0 0 8px; font-size: 20px; letter-spacing: -.01em; }
+  .panel p { margin: 0 0 22px; color: var(--ink-soft); font-size: 14px; line-height: 1.55; }
+  .panel .row { display:flex; gap:10px; justify-content:center; }
+  .primary-btn { appearance:none; border:0; cursor:pointer; padding: 12px 20px; border-radius: 12px; background: var(--blue); color:#fff; font-size: 14px; font-weight: 600; box-shadow: 0 6px 16px rgba(47,109,246,.35); transition: transform .2s var(--ease), filter .2s; }
+  .primary-btn:hover { transform: translateY(-1px); filter: brightness(1.05); }
+  .live-dot { width: 10px; height: 10px; border-radius: 50%; background: #ef4444; display:inline-block; margin-right: 7px; }
+  @keyframes liveb { 0%,100%{ box-shadow:0 0 0 0 rgba(239,68,68,.5);} 50%{ box-shadow:0 0 0 6px rgba(239,68,68,0);} }
+
+  /* ===== working shell — the calm screen "unfolds" into the workspace ===== */
+  .screen.shell-screen { justify-content: flex-start; padding-top: 22px; }
+  .shell-view { width: min(1120px, 96vw); display: grid; grid-template-columns: 210px 1fr; grid-template-rows: auto 1fr; gap: 16px; }
+  .reveal { opacity: 0; transform: translateY(12px); }
+  .reveal.in { opacity: 1; transform: none; transition: opacity .5s var(--ease) var(--d,0ms), transform .5s var(--ease) var(--d,0ms); }
+
+  /* session-context strip — the plan carried over, telemetry demoted to ambient */
+  .session-strip { grid-column: 1 / -1; display: flex; align-items: center; gap: 16px; background: var(--card); border: 1px solid var(--line); border-radius: 14px; padding: 12px 16px; box-shadow: var(--shadow); }
+  .session-strip .live { display:inline-flex; align-items:center; gap:7px; font-size: 11px; font-weight:700; letter-spacing:.08em; color:#ef4444; }
+  .session-strip .live .live-dot { animation: liveb 1.6s ease-in-out infinite; }
+  .session-strip .intent { font-weight: 650; letter-spacing:-.01em; font-size: 14.5px; }
+  .session-strip .params { color: var(--muted); font-size: 12.5px; }
+  .session-strip .telemetry { margin-left: auto; color: var(--muted); font-size: 12.5px; font-variant-numeric: tabular-nums; }
+
+  /* left rail — persistent agent presence (chat) + calm grouped nav */
+  .rail { display:flex; flex-direction: column; gap: 12px; background: var(--card); border:1px solid var(--line); border-radius: 14px; padding: 14px; box-shadow: var(--shadow); align-self:start; }
+  .rail-agent { display:flex; align-items:center; gap:10px; cursor:pointer; padding:6px; border-radius:10px; transition: background .2s; }
+  .rail-agent:hover { background:#f1f5f9; }
+  .rail-agent .mini-orb { width:28px; height:28px; border-radius:50%; flex:none; background: radial-gradient(closest-side at 38% 34%, #fff, #bcd3ff 42%, var(--blue) 100%); box-shadow:0 3px 10px rgba(47,109,246,.4); animation: orbBreathe 4s ease-in-out infinite; }
+  .rail-agent b { font-size: 13.5px; line-height:1.1; } .rail-agent .st2 { font-size: 11px; color: var(--green); }
+  .rail-compose { display:flex; gap:6px; max-height:0; opacity:0; overflow:hidden; transition: max-height .3s var(--ease), opacity .3s var(--ease), margin .3s var(--ease); }
+  .rail-compose.open { max-height:50px; opacity:1; margin-bottom:2px; }
+  .rail-compose input { flex:1; min-width:0; border:1px solid var(--line); border-radius:9px; padding:8px 10px; font-size:12.5px; outline:none; }
+  .nav-group .gl { font-size: 10px; letter-spacing:.1em; text-transform:uppercase; color:#b4bfce; padding: 10px 8px 4px; }
+  .nav-item { display:flex; align-items:center; gap:9px; padding: 8px 9px; border-radius:9px; font-size:13px; color: var(--ink-soft); cursor:pointer; transition: background .15s, color .15s; }
+  .nav-item:hover { background:#f1f5f9; color: var(--ink); }
+  .nav-item.active { background: var(--blue-soft); color: var(--blue); font-weight:600; }
+  .nav-item .nd { width:7px; height:7px; border-radius:50%; background: currentColor; opacity:.45; flex:none; }
+
+  /* center work area — biology is primary */
+  .work { display:flex; flex-direction: column; gap: 14px; min-width:0; }
+  .attention-card { background: linear-gradient(180deg,#fffdf6,#fff); border:1px solid #f0e3c2; border-radius: 14px; padding: 16px 18px; box-shadow: var(--shadow); }
+  .attention-card .ah { font-size:11px; letter-spacing:.07em; text-transform:uppercase; color:#b88407; font-weight:700; margin-bottom:8px; }
+  .attention-card .aq { font-size: 15px; font-weight:550; letter-spacing:-.01em; line-height:1.45; margin-bottom: 14px; }
+  .attention-card .aq .prov { color: var(--muted); font-weight: 400; font-size:13px; }
+  .attn-actions { display:flex; gap:9px; flex-wrap:wrap; }
+  .chip-btn { appearance:none; cursor:pointer; border:1px solid var(--line); background:#fff; border-radius:10px; padding:9px 14px; font-size:13px; font-weight:600; color:var(--ink-soft); transition: transform .15s var(--ease), border-color .15s, color .15s; }
+  .chip-btn:hover { transform: translateY(-1px); border-color:#cfd9e6; color:var(--ink); }
+  .chip-btn.primary { background:var(--green-soft); border-color:#bfe6cc; color:var(--green); }
+  .chip-btn.ghost { border-style:dashed; }
+  .work-head { display:flex; align-items:baseline; justify-content:space-between; gap:10px; padding: 2px 2px 0; }
+  .work-head h3 { margin:0; font-size: 14px; letter-spacing:-.01em; }
+  .work-head .hint { font-size: 11.5px; color:#b4bfce; }
+  .emb-grid { display:grid; grid-template-columns: repeat(3, 1fr); gap: 12px; }
+  @media (max-width: 820px){ .emb-grid { grid-template-columns: 1fr 1fr; } }
+  .emb-card { background:var(--card); border:1px solid var(--line); border-radius:13px; padding:14px; box-shadow:var(--shadow); position:relative; transition: transform .2s var(--ease), box-shadow .2s; }
+  .emb-card:hover { transform: translateY(-2px); box-shadow: var(--shadow-lift); }
+  .emb-card .thumb { height: 60px; border-radius:9px; margin-bottom:10px; background: repeating-linear-gradient(135deg,#eef2f8 0 8px,#e7edf5 8px 16px); position:relative; overflow:hidden; }
+  .emb-card .thumb::after { content:""; position:absolute; width:26px;height:26px;border-radius:50%; left:50%; top:50%; transform:translate(-50%,-50%); background: radial-gradient(closest-side,#cfe0ff,#9bbcf6); }
+  .emb-card.warn { border-color:#f0d9b0; } .emb-card.warn .thumb::after { background: radial-gradient(closest-side,#ffe0b0,#f4b860); }
+  .emb-card.go .thumb::after { background: radial-gradient(closest-side,#c8efd3,#7fd29a); }
+  .emb-card b { font-size:13.5px; }
+  .emb-card .st { font-size:12px; color:var(--ink-soft); margin-top:3px; }
+  .badge { font-size:10px; font-weight:700; letter-spacing:.04em; padding:2px 7px; border-radius:99px; text-transform:uppercase; margin-left:6px; }
+  .badge.live { background:#eaf1ff; color:var(--blue);} .badge.warn{ background:#fdf0db; color:#b88407;} .badge.ok{ background:var(--green-soft); color:var(--green);}
+  .emb-card .ask-chip { position:absolute; top:11px; right:11px; font-size:11px; color:var(--muted); background:none; border:0; cursor:pointer; padding:3px 7px; border-radius:7px; }
+  .emb-card .ask-chip:hover { background:#f1f5f9; color:var(--ink); }
+  .mini-compose { display:flex; gap:6px; max-height:0; opacity:0; overflow:hidden; transition: max-height .3s var(--ease), opacity .3s var(--ease), margin .3s var(--ease); }
+  .mini-compose.open { max-height:50px; opacity:1; margin-top:10px; }
+  .mini-compose input { flex:1; min-width:0; border:1px solid var(--line); border-radius:9px; padding:8px 10px; font-size:12px; outline:none; }
+  .mini-compose button { border:0; background:var(--blue); color:#fff; border-radius:9px; width:34px; cursor:pointer; flex:none; }
+
+  @media (prefers-reduced-motion: reduce) {
+    *, *::before, *::after { animation-duration: .001s !important; transition-duration: .12s !important; }
+    body::before { animation: none; }
+  }
+</style>
+</head>
+<body data-screen="landing">
+  <div class="shell">
+    <div class="topbar">
+      <div class="brand"><span class="mark"></span><span>Gently</span></div>
+      <div class="topbar-right">
+        <button class="ghost-btn back-btn" id="backBtn">
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 18l-6-6 6-6"/></svg>
+          <span class="lbl">Back</span>
+        </button>
+        <span class="pill"><span class="dot"></span>Scope ready <span class="mono">· 36.9 °C · stage idle</span></span>
+      </div>
+    </div>
+
+    <div class="stage">
+      <!-- ============ LANDING ============ -->
+      <section class="screen is-active" id="s-landing">
+        <div class="agent rise" style="--i:0">
+          <div class="orb"></div>
+          <div class="say" id="greeting">Good evening.<br><span class="dim">What are we doing today?</span></div>
+        </div>
+
+        <div class="choices">
+          <button class="choice rise" style="--i:1" data-go="plan">
+            <span class="tag">guided</span>
+            <span class="ic"><svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M4 19V5M4 7h11l-2-2M4 12h15l-2-2M4 17h9l-2-2"/></svg></span>
+            <h3>Plan an experiment</h3>
+            <p>Design a run with me — targets, cadence, and when to adapt. I'll handle the rest and keep watch.</p>
+            <span class="go">Start planning <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span>
+          </button>
+
+          <button class="choice alt rise" style="--i:2" data-go="standalone">
+            <span class="tag">standalone</span>
+            <span class="ic"><svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7Z"/><circle cx="12" cy="12" r="3"/></svg></span>
+            <h3>Take a quick look</h3>
+            <p>Straight to the scope for a single acquisition. No plan, no commitment — just see what's there.</p>
+            <span class="go">Open the scope <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span>
+          </button>
+        </div>
+
+        <div class="escape rise" style="--i:3" id="escape">
+          <button class="escape-toggle" id="escapeToggle">
+            <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2Z"/></svg>
+            or just tell me what you need
+            <span class="caret"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 9l6 6 6-6"/></svg></span>
+          </button>
+          <div class="escape-field">
+            <input id="escapeInput" placeholder="e.g. watch these embryos overnight and ping me if one stalls" />
+            <button class="send" id="escapeSend"><svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 2L11 13M22 2l-7 20-4-9-9-4 20-7Z"/></svg></button>
+          </div>
+        </div>
+      </section>
+
+      <!-- ============ PLAN MODE ============ -->
+      <section class="screen" id="s-plan">
+        <div class="plan-wrap">
+          <div class="ask-card rise" style="--i:0">
+            <div id="askBody">
+              <div class="ask-head">
+                <span class="mini-orb"></span><span class="who">Gently</span>
+                <button class="step-back" id="stepBack"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M15 18l-6-6 6-6"/></svg> Back</button>
+              </div>
+              <div class="ask-prompt" id="askPrompt"></div>
+              <div class="opts" id="askOpts"></div>
+              <div class="ask-action" id="askAction"></div>
+              <div class="ask-escape" id="askEscape">
+                <input id="askEscapeInput" placeholder="Type your own answer…" />
+                <button class="send sm" id="askEscapeSend"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg></button>
+              </div>
+              <div class="opt-escape"><button id="askType">⌨︎ type a different answer instead</button></div>
+            </div>
+            <div class="steps" id="steps"></div>
+          </div>
+
+          <div class="plan-card rise" style="--i:1">
+            <h4>The plan</h4>
+            <p class="sub">assembling from your choices</p>
+            <div class="plan-list" id="planList">
+              <div class="plan-empty" id="planEmpty">Nothing yet — pick above and watch it fill in.</div>
+            </div>
+            <div class="plan-cta" id="planCta"><button class="run-btn" id="runBtn">Start run →</button></div>
+          </div>
+        </div>
+      </section>
+
+      <!-- ============ STANDALONE (stub) ============ -->
+      <section class="screen" id="s-standalone">
+        <div class="panel rise" style="--i:0">
+          <div class="ic-lg"><svg width="26" height="26" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7Z"/><circle cx="12" cy="12" r="3"/></svg></div>
+          <h3>Quick look</h3>
+          <p>I'll take one careful volume right where the stage is now — nothing scheduled, nothing committed. <br><span style="color:var(--muted)">(We'll design this surface next — it's a stub for now.)</span></p>
+          <div class="row"><button class="primary-btn" id="captureBtn">Capture now</button></div>
+        </div>
+      </section>
+
+      <!-- ============ WORKING SHELL (unfolds from the plan) ============ -->
+      <section class="screen shell-screen" id="s-shell">
+        <div class="shell-view">
+          <div class="session-strip reveal">
+            <span class="live"><span class="live-dot"></span>LIVE</span>
+            <span class="intent" id="stripIntent">run</span>
+            <span class="params" id="stripParams"></span>
+            <span class="telemetry">0h 12m elapsed · next 1:43</span>
+          </div>
+
+          <aside class="rail reveal">
+            <div class="rail-agent" id="railAgent" title="Talk to Gently">
+              <span class="mini-orb"></span><span><b>Gently</b><br><span class="st2">Connected</span></span>
+            </div>
+            <div class="rail-compose" id="railCompose"><input placeholder="Message Gently…"><button class="send sm">→</button></div>
+            <div class="nav-group">
+              <div class="gl">Now</div>
+              <div class="nav-item active"><span class="nd"></span>Overview</div>
+              <div class="nav-item"><span class="nd"></span>Embryos</div>
+            </div>
+            <div class="nav-group">
+              <div class="gl">Library</div>
+              <div class="nav-item"><span class="nd"></span>Plans</div>
+              <div class="nav-item"><span class="nd"></span>Sessions</div>
+            </div>
+            <div class="nav-group">
+              <div class="gl">System</div>
+              <div class="nav-item"><span class="nd"></span>Devices</div>
+              <div class="nav-item"><span class="nd"></span>Calibration</div>
+            </div>
+          </aside>
+
+          <div class="work">
+            <div class="attention-card reveal">
+              <div class="ah">⚠ Needs you</div>
+              <div class="aq">Embryo 3 has been quiet for 40 min — past its expected division window. Keep waiting, or flag it for you?</div>
+              <div class="attn-actions">
+                <button class="chip-btn primary">Keep waiting</button>
+                <button class="chip-btn">Flag it</button>
+                <button class="chip-btn ghost">Ask why</button>
+              </div>
+            </div>
+
+            <div class="work-head reveal"><h3>Embryos · 3 tracked</h3><span class="hint">representative — the embryo-wise tactical view is yours to define</span></div>
+            <div class="emb-grid reveal">
+              <div class="emb-card go"><button class="ask-chip">ask</button><div class="thumb"></div><b>Embryo 1</b><span class="badge ok">on track</span><div class="st">4-cell · imaging normally</div><div class="mini-compose"><input placeholder="Ask about Embryo 1…"><button>→</button></div></div>
+              <div class="emb-card"><button class="ask-chip">ask</button><div class="thumb"></div><b>Embryo 2</b><span class="badge live">dividing</span><div class="st">sped up to every 30 s</div><div class="mini-compose"><input placeholder="Ask about Embryo 2…"><button>→</button></div></div>
+              <div class="emb-card warn"><button class="ask-chip">ask</button><div class="thumb"></div><b>Embryo 3</b><span class="badge warn">stalled</span><div class="st">40 min quiet · flagged above</div><div class="mini-compose"><input placeholder="Ask about Embryo 3…"><button>→</button></div></div>
+            </div>
+          </div>
+        </div>
+      </section>
+
+    </div>
+  </div>
+
+<script>
+(function(){
+  const body = document.body;
+  const $ = (s, r=document) => r.querySelector(s);
+  const reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
+
+  function go(screen){
+    body.setAttribute('data-screen', screen);
+    document.querySelectorAll('.screen').forEach(s => s.classList.toggle('is-active', s.id === 's-'+screen));
+    $('#backBtn').querySelector('.lbl').textContent = (screen === 'plan' || screen === 'shell') ? 'Start over' : 'Back';
+  }
+  // top-right button always exits to landing / starts over
+  $('#backBtn').addEventListener('click', () => { resetPlan(); go('landing'); });
+  // Escape key: step back within plan, else exit
+  document.addEventListener('keydown', e => {
+    if (e.key !== 'Escape') return;
+    const scr = body.getAttribute('data-screen');
+    if (scr === 'plan') stepBack();
+    else if (scr !== 'landing') { resetPlan(); go('landing'); }
+  });
+
+  // time-aware greeting
+  (function(){
+    const h = new Date().getHours();
+    const t = h < 5 ? "Still here." : h < 12 ? "Good morning." : h < 18 ? "Good afternoon." : "Good evening.";
+    $('#greeting').innerHTML = t + '<br><span class="dim">What are we doing today?</span>';
+  })();
+
+  // landing escape hatch — the pill toggles the field open/closed; Esc also closes
+  const escape = $('#escape'), escToggle = $('#escapeToggle'), escInput = $('#escapeInput');
+  escToggle.addEventListener('click', () => {
+    const opened = escape.classList.toggle('open');
+    if (opened) setTimeout(()=>escInput.focus(), 120);
+    else escToggle.focus();
+  });
+  escInput.addEventListener('keydown', e => {
+    if (e.key === 'Enter') submitEscape();
+    if (e.key === 'Escape') { escape.classList.remove('open'); escToggle.focus(); }
+  });
+  $('#escapeSend').addEventListener('click', submitEscape);
+  function submitEscape(){ const v = escInput.value.trim(); startPlan(v ? ('“'+v+'”') : null); }
+
+  // landing choices
+  document.querySelectorAll('.choice').forEach(c => c.addEventListener('click', () => {
+    c.getAttribute('data-go') === 'plan' ? startPlan() : go('standalone');
+  }));
+  $('#captureBtn').addEventListener('click', () => { resetPlan(); go('landing'); });
+
+  /* =================== PLAN MODE =================== */
+  const STEPS = [
+    { id:'goal', key:'Goal', kind:'choice',
+      prompt: () => "What should this run capture?",
+      options: [
+        { label:"Developmental time-lapse", desc:"Watch embryos develop over hours.", value:"Developmental time-lapse" },
+        { label:"Single high-quality volume", desc:"One careful 3D snapshot.", value:"Single volume" },
+        { label:"Find & track", desc:"Locate targets and follow them as they move.", value:"Find & track" },
+        { label:"Compare conditions", desc:"Image across samples to screen a difference.", value:"Compare conditions" },
+      ] },
+    { id:'cadence', key:'Cadence', kind:'proposal',
+      prompt: (p) => `For a ${ (p.Goal||'run').toLowerCase() }, I'd image every 2 min for 6 h. Good?`,
+      options: [
+        { label:"Sounds right", desc:"every 2 min · 6 h", primary:true, value:"every 2 min · 6 h" },
+        { label:"Gentler — every 5 min", desc:"less light on the sample", value:"every 5 min · 6 h" },
+        { label:"Finer — every 30 s", desc:"catch fast events", value:"every 30 s · 6 h" },
+        { label:"Run longer — 12 h", desc:"overnight", value:"every 2 min · 12 h" },
+      ] },
+    { id:'channels', key:'Channels', kind:'multi', min:1,
+      prompt: () => "Which channels are we imaging?  (pick any)",
+      options: [
+        { label:"GFP", desc:"488 nm", value:"GFP" },
+        { label:"mCherry", desc:"561 nm", value:"mCherry" },
+        { label:"Brightfield", desc:"transmitted light", value:"BF" },
+        { label:"DIC", desc:"label-free contrast", value:"DIC" },
+      ] },
+    { id:'reactive', key:'Adapt', kind:'choice',
+      prompt: () => "Want me to adapt on my own while it runs?",
+      options: [
+        { label:"Speed up during divisions", desc:"I'll watch and bump cadence when an embryo divides.", primary:true, value:"Speed up on division" },
+        { label:"…and flag anything unusual", desc:"Same, plus ping you on anomalies.", value:"Division + anomaly alerts" },
+        { label:"Keep it fixed", desc:"Do exactly what we set, nothing more.", value:"Fixed — no changes" },
+      ] },
+  ];
+  const REVIEW_KEY = 'Targets';
+
+  let stepIndex = 0, plan = {}, planOrder = [], answers = [], multiSel = new Set(), intro = null, reviewOpen = false;
+
+  function resetPlan(){
+    stepIndex = 0; plan = {}; planOrder = []; answers = []; multiSel = new Set(); intro = null; reviewOpen = false;
+    $('#planList').innerHTML = '<div class="plan-empty" id="planEmpty">Nothing yet — pick above and watch it fill in.</div>';
+    $('#planCta').classList.remove('show');
+    $('#askEscape').classList.remove('open');
+  }
+  function startPlan(introText){
+    resetPlan(); intro = introText || null; go('plan'); buildDots();
+    renderThinking(); setTimeout(()=>renderStep(0), reduced?60:600);
+  }
+  function buildDots(){
+    const w = $('#steps'); w.innerHTML = '';
+    STEPS.forEach((_,i) => { const d = document.createElement('i'); d.dataset.i = i;
+      d.addEventListener('click', ()=>{ if (d.classList.contains('done')) jumpTo(i); }); w.appendChild(d); });
+  }
+  function paintDots(){
+    document.querySelectorAll('#steps i').forEach((d,i) => {
+      d.classList.toggle('on', i === stepIndex && !reviewOpen);
+      d.classList.toggle('done', i < stepIndex || reviewOpen);
+    });
+  }
+  function renderThinking(){
+    $('#askPrompt').innerHTML = '<span class="typing"><i></i><i></i><i></i></span>';
+    $('#askOpts').innerHTML = ''; $('#askAction').innerHTML = ''; $('#askAction').classList.remove('show');
+    $('#askEscape').classList.remove('open'); $('#stepBack').classList.remove('show');
+  }
+  function renderStep(i){
+    stepIndex = i; reviewOpen = false; multiSel = new Set(); paintDots();
+    const step = STEPS[i];
+    $('#stepBack').classList.add('show');
+    const promptEl = $('#askPrompt'), optsEl = $('#askOpts'), actionEl = $('#askAction');
+    swap(promptEl, () => { promptEl.textContent = (intro && i===0) ? `${intro} — let's shape that. What should this run capture?` : step.prompt(plan); });
+    swap(optsEl, () => {
+      optsEl.innerHTML = '';
+      const multi = step.kind === 'multi';
+      step.options.forEach(opt => {
+        const b = document.createElement('button');
+        b.className = 'opt' + (opt.primary ? ' primary' : '') + (multi ? ' multi' : '');
+        b.innerHTML = `<span class="otick">${ multi ? '' : chevronOrCheck(opt) }</span><span class="ol"><b>${opt.label}</b><span>${opt.desc}</span></span>`;
+        b.addEventListener('click', () => { multi ? toggleMulti(b, opt, step) : commit(step, [[step.key, opt.value]]); });
+        optsEl.appendChild(b);
+      });
+    });
+    actionEl.innerHTML = ''; actionEl.classList.remove('show');
+    if (step.kind === 'multi'){
+      const btn = document.createElement('button'); btn.className = 'continue-btn'; btn.id = 'multiContinue';
+      btn.addEventListener('click', () => { if (multiSel.size >= (step.min||1)) commit(step, [[step.key, Array.from(multiSel).join(', ')]]); });
+      // mount with state derived from current selection — so picks made before mount aren't lost
+      setTimeout(()=>{
+        btn.disabled = multiSel.size < (step.min||1);
+        btn.textContent = multiSel.size ? `Continue · ${multiSel.size} selected` : 'Continue';
+        actionEl.appendChild(btn); actionEl.classList.add('show');
+      }, reduced?0:200);
+    }
+  }
+  function chevronOrCheck(opt){
+    return opt.primary
+      ? '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M20 6L9 17l-5-5"/></svg>'
+      : '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round"><path d="M9 6l6 6-6 6"/></svg>';
+  }
+  function toggleMulti(btn, opt, step){
+    const tickSvg = '<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M20 6L9 17l-5-5"/></svg>';
+    if (multiSel.has(opt.value)){ multiSel.delete(opt.value); btn.classList.remove('selected'); btn.querySelector('.otick').innerHTML = ''; }
+    else { multiSel.add(opt.value); btn.classList.add('selected'); btn.querySelector('.otick').innerHTML = tickSvg; }
+    const c = $('#multiContinue'); if (c){ c.disabled = multiSel.size < (step.min||1); c.textContent = multiSel.size ? `Continue · ${multiSel.size} selected` : 'Continue'; }
+  }
+  function commit(step, keysPairs){
+    const added = []; keysPairs.forEach(([k,v]) => { addToPlan(k,v); added.push(k); });
+    answers[stepIndex] = { keys: added }; answers.length = stepIndex + 1;
+    const next = stepIndex + 1;
+    if (next < STEPS.length){ renderThinking(); paintDots(); setTimeout(()=>renderStep(next), reduced?60:520); }
+    else enterReview();
+  }
+  function enterReview(){
+    reviewOpen = true; stepIndex = STEPS.length; paintDots();
+    $('#stepBack').classList.add('show');
+    swap($('#askPrompt'), () => { $('#askPrompt').textContent = "Here's the run. I added the obvious defaults — adjust anything, or send it."; });
+    $('#askAction').innerHTML = ''; $('#askAction').classList.remove('show'); $('#askEscape').classList.remove('open');
+    swap($('#askOpts'), () => { $('#askOpts').innerHTML =
+      `<button class="opt" id="tweakBtn"><span class="otick"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 12h18M3 6h18M3 18h18"/></svg></span><span class="ol"><b>Adjust details</b><span>step back through the choices</span></span></button>`; });
+    if (!plan[REVIEW_KEY]) setTimeout(()=>addToPlan(REVIEW_KEY,'auto-detect embryos'), reduced?40:280);
+    setTimeout(()=>$('#planCta').classList.add('show'), reduced?60:500);
+  }
+
+  /* ---- BACK / navigation ---- */
+  function stepBack(){
+    if (reviewOpen){
+      removePlanKey(REVIEW_KEY);
+      const last = STEPS.length - 1;
+      if (answers[last]) answers[last].keys.forEach(removePlanKey);
+      answers.length = last; $('#planCta').classList.remove('show');
+      renderThinking(); setTimeout(()=>renderStep(last), reduced?40:260); return;
+    }
+    if (stepIndex > 0){
+      const prev = stepIndex - 1;
+      if (answers[prev]) answers[prev].keys.forEach(removePlanKey);
+      answers.length = prev;
+      renderThinking(); setTimeout(()=>renderStep(prev), reduced?40:260);
+    } else { resetPlan(); go('landing'); }
+  }
+  function jumpTo(i){
+    for (let k = answers.length - 1; k >= i; k--){ if (answers[k]) answers[k].keys.forEach(removePlanKey); }
+    if (reviewOpen) removePlanKey(REVIEW_KEY);
+    answers.length = i; $('#planCta').classList.remove('show');
+    renderThinking(); setTimeout(()=>renderStep(i), reduced?40:260);
+  }
+  $('#stepBack').addEventListener('click', stepBack);
+  // "Adjust details" at review → step back into the questions
+  $('#askOpts').addEventListener('click', e => { if (e.target.closest('#tweakBtn')) stepBack(); });
+
+  /* ---- plan panel ---- */
+  function addToPlan(key, value){
+    const empty = $('#planEmpty'); if (empty) empty.remove();
+    if (plan[key] !== undefined){ plan[key] = value; const v = document.querySelector(`.plan-item[data-k="${key}"] .v`); if (v){ v.textContent = value; v.animate?.([{opacity:.3},{opacity:1}],{duration:300}); } return; }
+    plan[key] = value; planOrder.push(key);
+    const item = document.createElement('div'); item.className = 'plan-item fresh'; item.dataset.k = key;
+    item.innerHTML = `<span class="k">${key}</span><span class="v">${value}</span>`;
+    $('#planList').appendChild(item);
+    requestAnimationFrame(()=>requestAnimationFrame(()=>item.classList.add('in')));
+  }
+  function removePlanKey(key){
+    if (plan[key] === undefined) return;
+    delete plan[key]; planOrder = planOrder.filter(k => k !== key);
+    const node = document.querySelector(`.plan-item[data-k="${key}"]`); if (node) node.remove();
+    if (planOrder.length === 0 && !$('#planEmpty')) $('#planList').innerHTML = '<div class="plan-empty" id="planEmpty">Nothing yet — pick above and watch it fill in.</div>';
+  }
+
+  /* ---- inline escape-to-text (replaces the alert) ---- */
+  $('#askType').addEventListener('click', () => {
+    const ae = $('#askEscape'); ae.classList.toggle('open');
+    if (ae.classList.contains('open')) setTimeout(()=>$('#askEscapeInput').focus(), 100);
+  });
+  function submitAskEscape(){
+    const inp = $('#askEscapeInput'); const v = inp.value.trim(); if (!v) return;
+    inp.value = ''; if (reviewOpen) return;
+    const step = STEPS[stepIndex]; commit(step, [[step.key, v]]);
+  }
+  $('#askEscapeSend').addEventListener('click', submitAskEscape);
+  $('#askEscapeInput').addEventListener('keydown', e => { if (e.key==='Enter') submitAskEscape(); if (e.key==='Escape'){ e.stopPropagation(); $('#askEscape').classList.remove('open'); } });
+
+  /* ---- run → the plan unfolds into the working shell ---- */
+  $('#runBtn').addEventListener('click', () => {
+    $('#stripIntent').textContent = plan.Goal || 'run';
+    $('#stripParams').textContent = ['Cadence','Channels','Adapt'].filter(k => plan[k]).map(k => '· ' + plan[k]).join('  ');
+    revealShell();
+    go('shell');
+  });
+  function revealShell(){
+    const rs = document.querySelectorAll('#s-shell .reveal');
+    rs.forEach((r,i) => { r.style.setProperty('--d', (i*90)+'ms'); r.classList.remove('in'); });
+    requestAnimationFrame(()=>requestAnimationFrame(()=> rs.forEach(r => r.classList.add('in'))));
+  }
+
+  /* ---- chat entry points: global (rail) + contextual (per embryo) ---- */
+  $('#railAgent').addEventListener('click', () => {
+    const c = $('#railCompose'); const open = c.classList.toggle('open');
+    if (open) setTimeout(()=>c.querySelector('input').focus(), 80);
+  });
+  document.querySelectorAll('#s-shell .emb-card .ask-chip').forEach(btn => btn.addEventListener('click', () => {
+    const mc = btn.parentElement.querySelector('.mini-compose'); const open = mc.classList.toggle('open');
+    if (open) setTimeout(()=>mc.querySelector('input').focus(), 80);
+  }));
+  /* ---- the agent's open-loop decision card (push + provenance) ---- */
+  document.querySelectorAll('#s-shell .attn-actions .chip-btn').forEach(b => b.addEventListener('click', () => {
+    const card = b.closest('.attention-card'), aq = card.querySelector('.aq'), t = b.textContent;
+    if (/Ask/.test(t)) { aq.innerHTML += ' <span class="prov">Why: Embryo 3 reached 4-cell at 23:51; its siblings divided ~32 min after that stage, so a division was due by ~00:23 — it\'s 14 min overdue.</span>'; b.style.display = 'none'; return; }
+    aq.textContent = /Flag/.test(t) ? 'Flagged — I\'ll keep imaging it and ping you on any change.' : 'Okay — I\'ll keep waiting and tell you the moment it moves.';
+    card.querySelector('.ah').textContent = '✓ noted'; card.querySelector('.attn-actions').style.display = 'none';
+  }));
+
+  function swap(el, mutate){
+    if (reduced){ mutate(); return; }
+    el.classList.add('swap-leave');
+    setTimeout(() => { mutate(); el.classList.remove('swap-leave'); el.classList.add('swap-enter');
+      requestAnimationFrame(()=>requestAnimationFrame(()=>{ el.classList.add('in'); setTimeout(()=>el.classList.remove('swap-enter','in'), 360); })); }, 200);
+  }
+})();
+</script>
+</body>
+</html>

From 6c6bc7095ab51719521ce6ff29c3be35d9e23344 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 07:39:28 +0530
Subject: [PATCH 097/314] Detectors: forced-tool structured output for hatching
 + verifier
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Convert hatching.py and the verifier's four challenger strategies from JSON-in-prose / startswith-scraping with silent defaults to forced tool_choice — the verdict arrives as a validated dict on the tool_use block. Deletes the regex/parse layer; downstream vote-tally/consensus is untouched.

Also drop self-rated confidence from these schemas (a heuristics-era artifact — the boolean/categorical judgment is the signal); the ensemble's derived agreement ratio stays. docs/HEURISTICS-AUDIT.md ranks the remaining candidates and the keep-deterministic boundary.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs/HEURISTICS-AUDIT.md             | 112 ++++
 gently/app/detectors/hatching.py     | 124 +++--
 gently/harness/detection/verifier.py | 758 +++++++++++----------------
 3 files changed, 488 insertions(+), 506 deletions(-)
 create mode 100644 docs/HEURISTICS-AUDIT.md

diff --git a/docs/HEURISTICS-AUDIT.md b/docs/HEURISTICS-AUDIT.md
new file mode 100644
index 00000000..249b27cc
--- /dev/null
+++ b/docs/HEURISTICS-AUDIT.md
@@ -0,0 +1,112 @@
+# Heuristics audit — where to use the model (as a typed-output function) instead
+
+Codebase sweep (5 parallel scanners + synthesis) for heuristics that **fake
+judgment** an LLM would do better — in the spirit of the genotype→channel
+refactor (drop the lookup table, let the model infer, keep a typed provenance
+record + confirm-when-unsure). The flip side — logic that **must stay
+deterministic** (safety, math, calibration, transport) — is listed at the end so
+we don't mistakenly LLM-ify it.
+
+The unifying move for every candidate: **LLM with a typed structured-output
+schema + provenance + a confirm/UNCERTAIN escape**, never free-text-then-parse.
+
+## Model candidates (ranked)
+
+### High value
+
+1. **Hatching / time-to-stage prediction** — `organisms/celegans/developmental_tracker.py`
+   *(the closest twin of genotype→channel; medium effort)*
+   Three hardcoded 20 °C lookup tables (`STAGE_TIMING_20C`, `TIME_TO_HATCHING`,
+   `TIMING_VARIABILITY`) plus magic `{HIGH:1.0, MEDIUM:1.5, LOW:2.0}` uncertainty
+   fudge factors. Structurally **can't use the rig's actual temperature** (we run
+   a TEC), the strain, or the embryo's observed progression rate. Let the model
+   produce a calibrated, explained interval; **keep the literature table as a
+   deterministic sanity bracket** and flag when the estimate falls outside it.
+   → `{ predicted_minutes_to_hatching, low, high, basis, assumptions{temperature_c,strain,used_observed_rate}, confidence, reasoning }`
+
+2. **Citation → PubMed query** — `harness/plan_mode/tools/research.py` (`_search_pmid`)
+   A regex that only handles "Surname et al YEAR …" + six hand-rolled query-
+   relaxation strategies + a stopword/word-position ladder that drops load-bearing
+   nouns. The model parses the sloppy citation and proposes relaxed queries; **code
+   keeps the deterministic esearch call and never fabricates a PMID.**
+   → `{ author_last, year, journal, topic_keywords[], organism, pubmed_query, alt_queries[], confidence }`
+
+3. **Lab-history retrieval** — `harness/plan_mode/tools/lab_context.py`, `harness/memory/interface.py`
+   Semantic recall faked by substring-OR over query tokens (matches "we"/"before",
+   misses every paraphrase). Feed the model the candidate records and have it
+   **rank/select from provided ids only** (no fabrication). Read-only, no
+   acquisition risk.
+   → `{ matches:[{kind,id,summary,relevance,why_relevant}], answer }`
+
+4. **Stage-label parse via 22-entry synonym dict** — `developmental_tracker.py` (`_parse_stage_name`)
+   *(small effort, pure robustness win)* The Vision call already classifies; the
+   brittleness is a plain-text `STAGE:/CONFIDENCE:` block scraped line-by-line, with
+   off-vocabulary phrasings silently collapsing to `UNKNOWN` (which kills the
+   downstream hatching prediction). Constrained-enum structured output deletes the
+   parser + synonym table.
+   → `{ stage: enum(...), confidence: enum(high|medium|low), is_transitional, reasoning }`
+
+### Medium value (mostly small — fix the output contract, not the judgment)
+
+5. **Calibration Vision calls** — `hardware/dispim/claude_client.py`
+   Four Vision calls return positional free text recovered by `'yes' in first_line`
+   / `re.search(r'\d+')` / first-valid-letter, with silent defaults (so "no, this is
+   not yes…" reads as *yes*). Typed output deletes the parse + silent-default layer.
+
+6. **ML architecture ranking** — `ml/architectures.py` (`get_suitable_architectures`)
+   Hard feasibility gates (VRAM / dataset) are correct **and stay**; the `+2/+1/+1`
+   point-score ranking that follows discards the per-arch prose. Let the model rank
+   the *pre-filtered feasible set* (ids constrained to that set).
+
+7. **Training label normalization** — `ml/data_loader.py` (`build_labels_from_store`)
+   Class space built by exact-string identity over free-text human annotations —
+   "1.5-fold" and "1.5 fold" become different classes. Model normalizes to the
+   canonical staging vocabulary, flags novel/ambiguous ones.
+
+### Lower value
+
+8. **"Plan has a control?"** — `plan_mode/tools/validation.py` — substring scan of a
+   6-word keyword set; a scientific judgment over the whole plan. Non-blocking
+   warning → safe for the model.
+9. **CGC HTML scraping** — `research.py` (`_cgc_search`) — positional multi-group
+   regex over fetched HTML; structured extraction the model does better (HTTP GET
+   stays code; **mark strain names low-confidence to avoid sending someone to order
+   a hallucinated strain**).
+
+### Cross-cutting batch (small each): typed output for the detector/verifier cluster
+`harness/detection/verifier.py`, `app/detectors/hatching.py`,
+`app/detectors/dopaminergic_signal.py`, `hardware/dispim/sam_detection.py` — all
+already make the right model call but reconstruct the verdict via
+`startswith`/regex-JSON-scraping with silent defaults. A batch move to native
+structured output **strictly reduces parse-induced false negatives** without
+touching the deterministic vote-tally/consensus/enum-dispatch downstream.
+
+**Reference implementations already in the repo (imitate, don't change):**
+`dopaminergic_signal`'s perceiver→classifier rubric (typed enums, UNCERTAIN
+escape, conservative-on-tie) and onboarding's `_extract_with_llm` (typed
+extraction, degrade-to-verbatim fallback).
+
+## Keep deterministic (do NOT LLM-ify)
+Safety, math, calibration, and transport — where a hallucinated value is unsafe
+or breaks reproducibility:
+- Laser-power safety limits + wavelength→MM-property map (`hardware/dispim/devices/optical.py`)
+- SPIM trigger-timing arithmetic, piezo–galvo calibration, MM framing (`dispim/config.py`)
+- Calibration prior EMA + R²≥0.75 slope-lock gate (`dispim/calibration.py`)
+- SwitchBot GATT byte commands / status decoding (`hardware/switchbot.py`)
+- Temperature setpoint bound [0,99.9] °C + stabilization I/O (`hardware/temperature.py`)
+- Autofocus signal-processing, curve fitting, adaptive-sweep stop rules (`analysis/core.py`, `analysis/focus.py`)
+- Classical-CV ROI detection + pixel→stage coordinate transforms (`detection.py`, `sam_detection.py` geometry)
+- Timelapse rule dispatch + `confirm_timepoints` debounce + monotonic power ramp (`app/orchestration/timelapse.py`)
+- Volume→b64 dark/flat calibration + fixed brightness scaling (`dopaminergic_signal._volume_to_b64` — deliberately non-adaptive)
+- Wake-router debounce/throttle/stage-transition gate (`app/wake_router.py`)
+- Plan hardware limits, detector-preset membership, dependency-cycle DFS, stage-order normalization (`plan_mode/tools/validation.py`)
+- Ensemble vote tally + 0.70 quorum / unanimity consensus (`detection/verifier.py`)
+- ML metric/aggregation math: confusion matrix, F1, federated averaging (`ml/evaluation.py`, `federated.py`)
+- Core imaging geometry (max-projection, crop bounds, Euler rotations) + UI event reduction/routing/security (`core/imaging.py`, `ui/web/*`)
+- Device-state SSE watchdog/staleness timers (`app/device_state_monitor.py`)
+- Reference-type dispatch (PMID/DOI/URL by canonical syntax), `os.path.isfile` checks (`research.py`)
+
+## Note
+`gap_assessment.conversation_weight` (the 0.25/0.1/0.05 readiness scalar) is now
+largely **vestigial** — it only returns 'heavy' (lab onboarding) or 'none' — so
+it's not worth an API call. Left off the candidate list.
diff --git a/gently/app/detectors/hatching.py b/gently/app/detectors/hatching.py
index 62dd31cb..ca63acd3 100644
--- a/gently/app/detectors/hatching.py
+++ b/gently/app/detectors/hatching.py
@@ -5,12 +5,16 @@
 pipeline trains on. The dopaminergic-signal detector already returns
 ``has_hatched`` as part of its richer schema; this is a lighter-weight
 yes/no for use cases where structure / intensity assessment isn't needed.
+
+The verdict comes back as a forced tool call (``tool_choice`` pins the model
+to ``record_hatching``), so the structured fields arrive already parsed as
+``block.input`` — no JSON-from-prose scraping, no silent-default parse layer.
 """
 
 import asyncio
 import logging
 import time
-from typing import Any
+from typing import Any, Dict, Optional
 
 import numpy as np
 
@@ -20,8 +24,7 @@
 logger = logging.getLogger(__name__)
 
 
-_HATCHING_PROMPT = """You are observing a C. elegans embryo on a microscope. Decide whether
-the embryo has HATCHED.
+_HATCHING_PROMPT = """You are observing a C. elegans embryo on a microscope. Decide whether the embryo has HATCHED, then record your decision with the record_hatching tool.
 
 A HATCHED embryo:
 - Has visibly broken out of the eggshell
@@ -32,39 +35,53 @@
 - Is still contained within an intact eggshell
 - May be at any pre-hatching stage (bean, comma, 1.5-fold, 2-fold, pretzel)
 
-Respond with ONLY a JSON object exactly matching this schema:
+Default to has_hatched=false unless you are confident. Don't over-call hatching.
+"""
 
-{
-  "has_hatched": true|false,
-  "confidence": "LOW|MEDIUM|HIGH",
-  "reasoning": "..."
-}
 
-Default to false unless you are confident. Don't over-call hatching.
-"""
+# Forced tool schema — the model is pinned to this via tool_choice, so the
+# fields come back as a validated dict on the tool_use block. The conservative
+# "default to false" guidance lives in the prompt. We deliberately do NOT ask
+# the model to self-rate confidence — that's a heuristics-era artifact; the
+# has_hatched judgment is the signal.
+_HATCHING_TOOL = {
+    "name": "record_hatching",
+    "description": "Record whether the C. elegans embryo has hatched, with brief reasoning.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "has_hatched": {
+                "type": "boolean",
+                "description": "True only if the embryo has visibly broken out of the eggshell.",
+            },
+            "reasoning": {
+                "type": "string",
+                "description": "One short sentence citing the visual evidence for the call.",
+            },
+        },
+        "required": ["has_hatched", "reasoning"],
+    },
+}
 
 
 class HatchingDetector(Detector):
-    """Claude-vision hatching yes/no, with confidence."""
+    """Claude-vision hatching yes/no."""
 
     name = "hatching"
 
-    def __init__(self, claude_client=None, model: str | None = None):
+    def __init__(self, claude_client=None, model: Optional[str] = None):
         self._claude = claude_client
         self._model = model
 
     async def run(
         self,
         volume: np.ndarray,
-        context: dict[str, Any],
+        context: Dict[str, Any],
     ) -> DetectorResult:
+        from gently.settings import settings
         import json
-        import re
-
         import anthropic
 
-        from gently.settings import settings
-
         embryo_id = context.get("embryo_id", "?")
         timepoint = int(context.get("timepoint", 0))
         start = time.time()
@@ -84,7 +101,7 @@ async def run(
                 detector_name=self.name,
                 embryo_id=embryo_id,
                 timepoint=timepoint,
-                findings={"has_hatched": False, "confidence": "LOW"},
+                findings={"has_hatched": False},
                 reasoning="Empty / unreadable volume",
                 elapsed_ms=(time.time() - start) * 1000,
             )
@@ -93,41 +110,40 @@ async def run(
             response = await asyncio.to_thread(
                 claude.messages.create,
                 model=self._model or settings.models.fast,
-                max_tokens=200,
-                messages=[
-                    {
-                        "role": "user",
-                        "content": [
-                            {"type": "text", "text": _HATCHING_PROMPT},
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": "image/png",
-                                    "data": b64_image,
-                                },
-                            },
-                        ],
-                    }
-                ],
+                max_tokens=256,
+                tools=[_HATCHING_TOOL],
+                tool_choice={"type": "tool", "name": _HATCHING_TOOL["name"]},
+                messages=[{
+                    "role": "user",
+                    "content": [
+                        {"type": "text", "text": _HATCHING_PROMPT},
+                        {"type": "image", "source": {
+                            "type": "base64",
+                            "media_type": "image/png",
+                            "data": b64_image,
+                        }},
+                    ],
+                }],
+            )
+
+            # Forced tool_choice guarantees a tool_use block; read its parsed
+            # input directly. No regex, no JSON-from-prose fallback.
+            tool_input = next(
+                (b.input for b in response.content
+                 if getattr(b, "type", None) == "tool_use"),
+                None,
             )
-            raw = response.content[0].text if response.content else ""
 
-            findings = {"has_hatched": False, "confidence": "LOW"}
+            findings = {"has_hatched": False}
             reasoning = None
             err = None
-            try:
-                m = re.search(r"\{.*?\}", raw, re.DOTALL)
-                blob = m.group(0) if m else raw.strip()
-                parsed = json.loads(blob)
-                findings["has_hatched"] = bool(parsed.get("has_hatched", False))
-                confidence = str(parsed.get("confidence", "LOW")).upper()
-                if confidence not in {"LOW", "MEDIUM", "HIGH"}:
-                    confidence = "LOW"
-                findings["confidence"] = confidence
-                reasoning = parsed.get("reasoning")
-            except (json.JSONDecodeError, AttributeError) as e:
-                err = f"parse error: {e}"
+            if isinstance(tool_input, dict):
+                findings["has_hatched"] = bool(tool_input.get("has_hatched", False))
+                reasoning = tool_input.get("reasoning")
+            else:
+                # Shouldn't happen with forced tool_choice — keep the
+                # conservative default and record why.
+                err = "no tool_use block in response"
 
             return DetectorResult(
                 detector_name=self.name,
@@ -135,16 +151,12 @@ async def run(
                 timepoint=timepoint,
                 findings=findings,
                 reasoning=reasoning,
-                raw_response=raw,
+                raw_response=json.dumps(tool_input) if isinstance(tool_input, dict) else None,
                 elapsed_ms=(time.time() - start) * 1000,
                 error=err,
             )
 
-        except (
-            anthropic.APIConnectionError,
-            anthropic.RateLimitError,
-            anthropic.APIStatusError,
-        ) as e:
+        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
             logger.error("[%s] Claude API error for %s: %s", self.name, embryo_id, e)
             return DetectorResult(
                 detector_name=self.name,
diff --git a/gently/harness/detection/verifier.py b/gently/harness/detection/verifier.py
index 0370abb7..849fbdbf 100644
--- a/gently/harness/detection/verifier.py
+++ b/gently/harness/detection/verifier.py
@@ -14,35 +14,102 @@
 import logging
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any
+from typing import Any, Callable, Dict, List, Optional
 
 import anthropic
 
-from gently.core import EventType, get_event_bus
 from gently.settings import settings
-
+from .detector import Detector, DetectionResult, ConfidenceLevel
 from ..state import EmbryoState
-from .detector import ConfidenceLevel, DetectionResult, Detector
+from gently.core import EventType, get_event_bus
 
 logger = logging.getLogger(__name__)
 
 
+# Each verification strategy is pinned to its tool via tool_choice, so the
+# verdict arrives as a validated dict on the tool_use block — no
+# startswith()-scraping of a "FIELD: VALUE" plain-text format, no silent
+# defaults from a missed line. Downstream vote-tally / consensus logic is
+# untouched: these helpers still produce the same strategy dataclasses.
+#
+# We deliberately don't ask the model to self-rate confidence (a heuristics-era
+# artifact) — the boolean verdict is the signal, and the only confidence-like
+# measure we keep is the ensemble's agreement ratio, which is *derived* from
+# many independent votes rather than introspected by one call.
+_ADVERSARIAL_TOOL = {
+    "name": "record_adversarial_review",
+    "description": "Record the critical review verdict: whether counter-evidence against the detection was found.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "found_counter_evidence": {"type": "boolean", "description": "True only if there is real evidence the detection is wrong."},
+            "concerns": {"type": "array", "items": {"type": "string"}, "description": "Specific doubts or alternative explanations; empty list if none."},
+        },
+        "required": ["found_counter_evidence", "concerns"],
+    },
+}
+
+_INDEPENDENT_TOOL = {
+    "name": "record_independent_assessment",
+    "description": "Record an unbiased fresh assessment of whether the event occurred in this image.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "detected": {"type": "boolean", "description": "True if the event is observed in this image."},
+            "key_evidence": {"type": "string", "description": "What specifically supports the conclusion."},
+        },
+        "required": ["detected", "key_evidence"],
+    },
+}
+
+_TEMPORAL_TOOL = {
+    "name": "record_temporal_comparison",
+    "description": "Record whether a real change consistent with the event occurred between the previous and current frames.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "change_detected": {"type": "boolean", "description": "True if a clear change consistent with the event is visible across frames."},
+            "description": {"type": "string", "description": "The specific change observed between previous and current frames."},
+        },
+        "required": ["change_detected", "description"],
+    },
+}
+
+_HARDWARE_CONTEXT_TOOL = {
+    "name": "record_hardware_context",
+    "description": "Record whether hardware errors could have caused a false-positive detection.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "suspicious": {"type": "boolean", "description": "True if hardware errors could have affected image quality or positioning for this embryo."},
+            "concerns": {"type": "array", "items": {"type": "string"}, "description": "Specific hardware concerns; empty list if none."},
+            "reasoning": {"type": "string", "description": "Brief explanation of the analysis."},
+        },
+        "required": ["suspicious", "concerns", "reasoning"],
+    },
+}
+
+
+def _tool_input(response) -> Optional[Dict[str, Any]]:
+    """Return the parsed input of the first tool_use block, or None."""
+    for block in getattr(response, "content", None) or []:
+        if getattr(block, "type", None) == "tool_use":
+            return block.input
+    return None
+
+
 @dataclass
 class AdversarialResult:
     """Result of adversarial verification strategy"""
-
     found_counter_evidence: bool
-    concerns: list[str]
-    confidence_in_original: ConfidenceLevel | None
+    concerns: List[str]
     raw_response: str
 
 
 @dataclass
 class IndependentResult:
     """Result of independent verification strategy"""
-
     detected: bool
-    confidence: ConfidenceLevel | None
     key_evidence: str
     raw_response: str
 
@@ -50,31 +117,27 @@ class IndependentResult:
 @dataclass
 class TemporalResult:
     """Result of temporal comparison strategy"""
-
     change_detected: bool
     description: str
-    confidence: ConfidenceLevel | None
     raw_response: str
 
 
 @dataclass
 class EnsembleResult:
     """Result of ensemble voting strategy"""
-
     votes_yes: int
     votes_no: int
     total_votes: int
     agreement_ratio: float  # votes_yes / total_votes if detected, votes_no / total_votes if not
     consensus_detected: bool  # True if >70% agree on YES
-    raw_responses: list[str] = field(default_factory=list)
+    raw_responses: List[str] = field(default_factory=list)
 
 
 @dataclass
 class HardwareContextResult:
     """Result of hardware context analysis strategy"""
-
     suspicious: bool  # True if hardware errors could have caused false positive
-    concerns: list[str]  # Specific concerns identified
+    concerns: List[str]  # Specific concerns identified
     reasoning: str
     raw_response: str
 
@@ -82,16 +145,15 @@ class HardwareContextResult:
 @dataclass
 class VerificationResult:
     """Combined result of all verification strategies"""
-
     original_detected: bool
-    original_confidence: ConfidenceLevel | None
+    original_confidence: Optional[ConfidenceLevel]
 
     # Strategy results
     adversarial: AdversarialResult
     independent: IndependentResult
     temporal: TemporalResult
-    ensemble: EnsembleResult | None = None  # Only for hatching detection
-    hardware_context: HardwareContextResult | None = None  # Only when errors present
+    ensemble: Optional[EnsembleResult] = None  # Only for hatching detection
+    hardware_context: Optional[HardwareContextResult] = None  # Only when errors present
 
     # Consensus
     consensus: bool = False
@@ -101,50 +163,41 @@ class VerificationResult:
     timestamp: datetime = field(default_factory=datetime.now)
     verification_duration_seconds: float = 0.0
 
-    def to_dict(self) -> dict[str, Any]:
+    def to_dict(self) -> Dict[str, Any]:
         """Serialize to dictionary"""
         result = {
-            "original_detected": self.original_detected,
-            "original_confidence": self.original_confidence.value
-            if self.original_confidence
-            else None,
-            "adversarial": {
-                "found_counter_evidence": self.adversarial.found_counter_evidence,
-                "concerns": self.adversarial.concerns,
-                "confidence_in_original": self.adversarial.confidence_in_original.value
-                if self.adversarial.confidence_in_original
-                else None,
+            'original_detected': self.original_detected,
+            'original_confidence': self.original_confidence.value if self.original_confidence else None,
+            'adversarial': {
+                'found_counter_evidence': self.adversarial.found_counter_evidence,
+                'concerns': self.adversarial.concerns,
             },
-            "independent": {
-                "detected": self.independent.detected,
-                "confidence": self.independent.confidence.value
-                if self.independent.confidence
-                else None,
-                "key_evidence": self.independent.key_evidence,
+            'independent': {
+                'detected': self.independent.detected,
+                'key_evidence': self.independent.key_evidence,
             },
-            "temporal": {
-                "change_detected": self.temporal.change_detected,
-                "description": self.temporal.description,
-                "confidence": self.temporal.confidence.value if self.temporal.confidence else None,
+            'temporal': {
+                'change_detected': self.temporal.change_detected,
+                'description': self.temporal.description,
             },
-            "consensus": self.consensus,
-            "consensus_reasoning": self.consensus_reasoning,
-            "timestamp": self.timestamp.isoformat(),
-            "verification_duration_seconds": self.verification_duration_seconds,
+            'consensus': self.consensus,
+            'consensus_reasoning': self.consensus_reasoning,
+            'timestamp': self.timestamp.isoformat(),
+            'verification_duration_seconds': self.verification_duration_seconds,
         }
         if self.ensemble:
-            result["ensemble"] = {
-                "votes_yes": self.ensemble.votes_yes,
-                "votes_no": self.ensemble.votes_no,
-                "total_votes": self.ensemble.total_votes,
-                "agreement_ratio": self.ensemble.agreement_ratio,
-                "consensus_detected": self.ensemble.consensus_detected,
+            result['ensemble'] = {
+                'votes_yes': self.ensemble.votes_yes,
+                'votes_no': self.ensemble.votes_no,
+                'total_votes': self.ensemble.total_votes,
+                'agreement_ratio': self.ensemble.agreement_ratio,
+                'consensus_detected': self.ensemble.consensus_detected,
             }
         if self.hardware_context:
-            result["hardware_context"] = {
-                "suspicious": self.hardware_context.suspicious,
-                "concerns": self.hardware_context.concerns,
-                "reasoning": self.hardware_context.reasoning,
+            result['hardware_context'] = {
+                'suspicious': self.hardware_context.suspicious,
+                'concerns': self.hardware_context.concerns,
+                'reasoning': self.hardware_context.reasoning,
             }
         return result
 
@@ -189,7 +242,7 @@ def __init__(
         self.ensemble_threshold = ensemble_threshold
         self._event_bus = event_bus or get_event_bus()
 
-    def _emit_event(self, event_type: EventType, data: dict):
+    def _emit_event(self, event_type: EventType, data: Dict):
         """Emit event to viz server"""
         if self._event_bus:
             self._event_bus.publish(event_type, data)
@@ -223,13 +276,19 @@ async def verify(
         start_time = datetime.now()
 
         # Run all strategies in parallel for speed
-        adversarial_task = self._run_adversarial(detector, embryo_state, original_result, timepoint)
-        independent_task = self._run_independent(detector, embryo_state, timepoint)
-        temporal_task = self._run_temporal_check(detector, embryo_state, timepoint)
+        adversarial_task = self._run_adversarial(
+            detector, embryo_state, original_result, timepoint
+        )
+        independent_task = self._run_independent(
+            detector, embryo_state, timepoint
+        )
+        temporal_task = self._run_temporal_check(
+            detector, embryo_state, timepoint
+        )
 
         # For hatching detection, also run ensemble voting
         ensemble_result = None
-        if detector.name == "hatching":
+        if detector.name == 'hatching':
             ensemble_task = self._run_ensemble_hatching(embryo_state)
             adversarial, independent, temporal, ensemble_result = await asyncio.gather(
                 adversarial_task, independent_task, temporal_task, ensemble_task
@@ -261,11 +320,7 @@ async def verify(
         logger.info(
             f"Verification complete for {detector.name}: "
             f"consensus={consensus}, duration={duration:.2f}s"
-            + (
-                f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES"
-                if ensemble_result
-                else ""
-            )
+            + (f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES" if ensemble_result else "")
         )
 
         return result
@@ -304,15 +359,21 @@ async def verify_with_context(
         start_time = datetime.now()
 
         # Run all strategies in parallel for speed
-        adversarial_task = self._run_adversarial(detector, embryo_state, original_result, timepoint)
-        independent_task = self._run_independent(detector, embryo_state, timepoint)
-        temporal_task = self._run_temporal_check(detector, embryo_state, timepoint)
+        adversarial_task = self._run_adversarial(
+            detector, embryo_state, original_result, timepoint
+        )
+        independent_task = self._run_independent(
+            detector, embryo_state, timepoint
+        )
+        temporal_task = self._run_temporal_check(
+            detector, embryo_state, timepoint
+        )
 
         # For hatching detection, also run ensemble voting
         ensemble_result = None
         hardware_result = None
 
-        if detector.name == "hatching":
+        if detector.name == 'hatching':
             ensemble_task = self._run_ensemble_hatching(embryo_state)
 
             # Run hardware context analysis if there are errors
@@ -320,26 +381,11 @@ async def verify_with_context(
                 hardware_task = self._run_hardware_context_analysis(
                     global_error_context, embryo_state.id
                 )
-                (
-                    adversarial,
-                    independent,
-                    temporal,
-                    ensemble_result,
-                    hardware_result,
-                ) = await asyncio.gather(
-                    adversarial_task,
-                    independent_task,
-                    temporal_task,
-                    ensemble_task,
-                    hardware_task,
+                adversarial, independent, temporal, ensemble_result, hardware_result = await asyncio.gather(
+                    adversarial_task, independent_task, temporal_task, ensemble_task, hardware_task
                 )
             else:
-                (
-                    adversarial,
-                    independent,
-                    temporal,
-                    ensemble_result,
-                ) = await asyncio.gather(
+                adversarial, independent, temporal, ensemble_result = await asyncio.gather(
                     adversarial_task, independent_task, temporal_task, ensemble_task
                 )
         else:
@@ -354,151 +400,88 @@ async def verify_with_context(
 
         # Adversarial result
         strategies_complete += 1
-        self._emit_event(
-            EventType.VERIFICATION_STRATEGY,
-            {
-                "embryo_id": embryo_id,
-                "detector_name": detector.name,
-                "strategy": "adversarial",
-                "passed": not adversarial.found_counter_evidence,
-                "summary": (
-                    "Counter-evidence: "
-                    + (
-                        "YES - " + ", ".join(adversarial.concerns)
-                        if adversarial.found_counter_evidence
-                        else "None found"
-                    )
-                ),
-                "confidence": adversarial.confidence_in_original.value
-                if adversarial.confidence_in_original
-                else None,
-            },
-        )
-        self._emit_event(
-            EventType.VERIFICATION_PROGRESS,
-            {
-                "embryo_id": embryo_id,
-                "strategies_complete": strategies_complete,
-                "total_strategies": total_strategies,
-            },
-        )
+        self._emit_event(EventType.VERIFICATION_STRATEGY, {
+            'embryo_id': embryo_id,
+            'detector_name': detector.name,
+            'strategy': 'adversarial',
+            'passed': not adversarial.found_counter_evidence,
+            'summary': f"Counter-evidence: {'YES - ' + ', '.join(adversarial.concerns) if adversarial.found_counter_evidence else 'None found'}",
+        })
+        self._emit_event(EventType.VERIFICATION_PROGRESS, {
+            'embryo_id': embryo_id,
+            'strategies_complete': strategies_complete,
+            'total_strategies': total_strategies,
+        })
 
         # Independent result
         strategies_complete += 1
-        self._emit_event(
-            EventType.VERIFICATION_STRATEGY,
-            {
-                "embryo_id": embryo_id,
-                "detector_name": detector.name,
-                "strategy": "independent",
-                "passed": independent.detected,
-                "summary": (
-                    f"Independent detection: {'YES' if independent.detected else 'NO'}"
-                    f" - {independent.key_evidence}"
-                ),
-                "confidence": independent.confidence.value if independent.confidence else None,
-            },
-        )
-        self._emit_event(
-            EventType.VERIFICATION_PROGRESS,
-            {
-                "embryo_id": embryo_id,
-                "strategies_complete": strategies_complete,
-                "total_strategies": total_strategies,
-            },
-        )
+        self._emit_event(EventType.VERIFICATION_STRATEGY, {
+            'embryo_id': embryo_id,
+            'detector_name': detector.name,
+            'strategy': 'independent',
+            'passed': independent.detected,
+            'summary': f"Independent detection: {'YES' if independent.detected else 'NO'} - {independent.key_evidence}",
+        })
+        self._emit_event(EventType.VERIFICATION_PROGRESS, {
+            'embryo_id': embryo_id,
+            'strategies_complete': strategies_complete,
+            'total_strategies': total_strategies,
+        })
 
         # Temporal result
         strategies_complete += 1
-        self._emit_event(
-            EventType.VERIFICATION_STRATEGY,
-            {
-                "embryo_id": embryo_id,
-                "detector_name": detector.name,
-                "strategy": "temporal",
-                "passed": temporal.change_detected,
-                "summary": (
-                    f"Change detected: {'YES' if temporal.change_detected else 'NO'}"
-                    f" - {temporal.description}"
-                ),
-                "confidence": temporal.confidence.value if temporal.confidence else None,
-            },
-        )
-        self._emit_event(
-            EventType.VERIFICATION_PROGRESS,
-            {
-                "embryo_id": embryo_id,
-                "strategies_complete": strategies_complete,
-                "total_strategies": total_strategies,
-            },
-        )
+        self._emit_event(EventType.VERIFICATION_STRATEGY, {
+            'embryo_id': embryo_id,
+            'detector_name': detector.name,
+            'strategy': 'temporal',
+            'passed': temporal.change_detected,
+            'summary': f"Change detected: {'YES' if temporal.change_detected else 'NO'} - {temporal.description}",
+        })
+        self._emit_event(EventType.VERIFICATION_PROGRESS, {
+            'embryo_id': embryo_id,
+            'strategies_complete': strategies_complete,
+            'total_strategies': total_strategies,
+        })
 
         # Ensemble result (if applicable)
         if ensemble_result:
             strategies_complete += 1
-            self._emit_event(
-                EventType.VERIFICATION_STRATEGY,
-                {
-                    "embryo_id": embryo_id,
-                    "detector_name": detector.name,
-                    "strategy": "ensemble",
-                    "passed": ensemble_result.consensus_detected,
-                    "summary": (
-                        f"Ensemble vote: {ensemble_result.votes_yes}/{ensemble_result.total_votes}"
-                        f" YES ({ensemble_result.agreement_ratio * 100:.0f}%)"
-                    ),
-                    "votes_yes": ensemble_result.votes_yes,
-                    "votes_no": ensemble_result.votes_no,
-                    "total_votes": ensemble_result.total_votes,
-                },
-            )
-            self._emit_event(
-                EventType.VERIFICATION_PROGRESS,
-                {
-                    "embryo_id": embryo_id,
-                    "strategies_complete": strategies_complete,
-                    "total_strategies": total_strategies,
-                },
-            )
+            self._emit_event(EventType.VERIFICATION_STRATEGY, {
+                'embryo_id': embryo_id,
+                'detector_name': detector.name,
+                'strategy': 'ensemble',
+                'passed': ensemble_result.consensus_detected,
+                'summary': f"Ensemble vote: {ensemble_result.votes_yes}/{ensemble_result.total_votes} YES ({ensemble_result.agreement_ratio*100:.0f}%)",
+                'votes_yes': ensemble_result.votes_yes,
+                'votes_no': ensemble_result.votes_no,
+                'total_votes': ensemble_result.total_votes,
+            })
+            self._emit_event(EventType.VERIFICATION_PROGRESS, {
+                'embryo_id': embryo_id,
+                'strategies_complete': strategies_complete,
+                'total_strategies': total_strategies,
+            })
 
         # Hardware context result (if applicable)
         if hardware_result:
             strategies_complete += 1
-            self._emit_event(
-                EventType.VERIFICATION_STRATEGY,
-                {
-                    "embryo_id": embryo_id,
-                    "detector_name": detector.name,
-                    "strategy": "hardware_context",
-                    "passed": not hardware_result.suspicious,
-                    "summary": (
-                        "Hardware errors suspicious: "
-                        + (
-                            "YES - " + ", ".join(hardware_result.concerns)
-                            if hardware_result.suspicious
-                            else "No"
-                        )
-                    ),
-                    "reasoning": hardware_result.reasoning,
-                },
-            )
-            self._emit_event(
-                EventType.VERIFICATION_PROGRESS,
-                {
-                    "embryo_id": embryo_id,
-                    "strategies_complete": strategies_complete,
-                    "total_strategies": total_strategies,
-                },
-            )
+            self._emit_event(EventType.VERIFICATION_STRATEGY, {
+                'embryo_id': embryo_id,
+                'detector_name': detector.name,
+                'strategy': 'hardware_context',
+                'passed': not hardware_result.suspicious,
+                'summary': f"Hardware errors suspicious: {'YES - ' + ', '.join(hardware_result.concerns) if hardware_result.suspicious else 'No'}",
+                'reasoning': hardware_result.reasoning,
+            })
+            self._emit_event(EventType.VERIFICATION_PROGRESS, {
+                'embryo_id': embryo_id,
+                'strategies_complete': strategies_complete,
+                'total_strategies': total_strategies,
+            })
 
         # Determine consensus (with hardware context)
         consensus, reasoning = self._evaluate_consensus_with_hardware(
-            original_result,
-            adversarial,
-            independent,
-            temporal,
-            ensemble_result,
-            hardware_result,
+            original_result, adversarial, independent, temporal, ensemble_result, hardware_result
         )
 
         duration = (datetime.now() - start_time).total_seconds()
@@ -519,37 +502,26 @@ async def verify_with_context(
         logger.info(
             f"Verification (with context) complete for {detector.name}: "
             f"consensus={consensus}, duration={duration:.2f}s"
-            + (
-                f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES"
-                if ensemble_result
-                else ""
-            )
+            + (f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES" if ensemble_result else "")
             + (f", hardware_suspicious={hardware_result.suspicious}" if hardware_result else "")
         )
 
         # Emit VERIFICATION_COMPLETED event with full summary
-        self._emit_event(
-            EventType.VERIFICATION_COMPLETED,
-            {
-                "embryo_id": embryo_id,
-                "detector_name": detector.name,
-                "consensus": consensus,
-                "reasoning": reasoning,
-                "duration_seconds": duration,
-                "strategies": {
-                    "adversarial": not adversarial.found_counter_evidence,
-                    "independent": independent.detected,
-                    "temporal": temporal.change_detected,
-                    "ensemble": ensemble_result.consensus_detected if ensemble_result else None,
-                    "hardware_context": (not hardware_result.suspicious)
-                    if hardware_result
-                    else None,
-                },
-                "ensemble_votes": f"{ensemble_result.votes_yes}/{ensemble_result.total_votes}"
-                if ensemble_result
-                else None,
+        self._emit_event(EventType.VERIFICATION_COMPLETED, {
+            'embryo_id': embryo_id,
+            'detector_name': detector.name,
+            'consensus': consensus,
+            'reasoning': reasoning,
+            'duration_seconds': duration,
+            'strategies': {
+                'adversarial': not adversarial.found_counter_evidence,
+                'independent': independent.detected,
+                'temporal': temporal.change_detected,
+                'ensemble': ensemble_result.consensus_detected if ensemble_result else None,
+                'hardware_context': (not hardware_result.suspicious) if hardware_result else None,
             },
-        )
+            'ensemble_votes': f"{ensemble_result.votes_yes}/{ensemble_result.total_votes}" if ensemble_result else None,
+        })
 
         return result
 
@@ -577,8 +549,7 @@ async def _run_hardware_context_analysis(
             Analysis result
         """
         try:
-            prompt = f"""You are analyzing hardware error context for a microscopy detection
-verification.
+            prompt = f"""You are analyzing hardware error context for a microscopy detection verification.
 
 GLOBAL ERROR LOG:
 {global_error_context}
@@ -591,28 +562,33 @@ async def _run_hardware_context_analysis(
 - Stage positioning errors could cause wrong embryo to be imaged
 - Acquisition timeouts could cause partial/blank images (blank images look like empty FOV = hatched)
 - Camera errors could produce corrupted data
-- Errors on OTHER embryos in the same round could indicate systemic issues
-  (stage drift, hardware instability)
+- Errors on OTHER embryos in the same round could indicate systemic issues (stage drift, hardware instability)
 - Multiple errors in quick succession suggests hardware problems
 
-If ANY errors occurred that could have affected the image quality or positioning for
-{embryo_id}, report as SUSPICIOUS.
+If ANY errors occurred that could have affected the image quality or positioning for {embryo_id}, mark it suspicious.
 
-Respond in EXACTLY this format:
-SUSPICIOUS: [YES/NO]
-CONCERNS: [list specific concerns, separated by semicolons]
-REASONING: [brief explanation of your analysis]
+Record your analysis with the record_hardware_context tool.
 """
 
             response = await asyncio.to_thread(
                 self.claude.messages.create,
                 model=self.ensemble_model,  # Use Haiku for speed
                 max_tokens=300,
-                messages=[{"role": "user", "content": prompt}],
+                tools=[_HARDWARE_CONTEXT_TOOL],
+                tool_choice={"type": "tool", "name": _HARDWARE_CONTEXT_TOOL["name"]},
+                messages=[{"role": "user", "content": prompt}]
             )
 
-            response_text = response.content[0].text
-            return self._parse_hardware_context_response(response_text)
+            data = _tool_input(response)
+            if not isinstance(data, dict):
+                raise ValueError("no tool_use block in response")
+            concerns = data.get("concerns") or []
+            return HardwareContextResult(
+                suspicious=bool(data.get("suspicious", True)),
+                concerns=[str(c) for c in concerns],
+                reasoning=str(data.get("reasoning", "")),
+                raw_response=str(data),
+            )
 
         except Exception as e:
             logger.error(f"Hardware context analysis failed: {e}")
@@ -623,38 +599,14 @@ async def _run_hardware_context_analysis(
                 raw_response="",
             )
 
-    def _parse_hardware_context_response(self, response: str) -> HardwareContextResult:
-        """Parse hardware context analysis response"""
-        suspicious = False
-        concerns = []
-        reasoning = ""
-
-        for line in response.split("\n"):
-            line = line.strip()
-            if line.startswith("SUSPICIOUS:"):
-                value = line.split(":", 1)[1].strip().upper()
-                suspicious = value == "YES"
-            elif line.startswith("CONCERNS:"):
-                concerns_str = line.split(":", 1)[1].strip()
-                concerns = [c.strip() for c in concerns_str.split(";") if c.strip()]
-            elif line.startswith("REASONING:"):
-                reasoning = line.split(":", 1)[1].strip()
-
-        return HardwareContextResult(
-            suspicious=suspicious,
-            concerns=concerns,
-            reasoning=reasoning,
-            raw_response=response,
-        )
-
     def _evaluate_consensus_with_hardware(
         self,
         original: DetectionResult,
         adversarial: AdversarialResult,
         independent: IndependentResult,
         temporal: TemporalResult,
-        ensemble: EnsembleResult | None = None,
-        hardware_context: HardwareContextResult | None = None,
+        ensemble: Optional[EnsembleResult] = None,
+        hardware_context: Optional[HardwareContextResult] = None,
     ) -> tuple[bool, str]:
         """
         Evaluate consensus across all verification strategies including hardware context.
@@ -670,9 +622,7 @@ def _evaluate_consensus_with_hardware(
         if not adversarial.found_counter_evidence:
             agreements += 1
         else:
-            disagreements.append(
-                f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}"
-            )
+            disagreements.append(f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}")
 
         # Check independent: should also detect
         if independent.detected:
@@ -712,19 +662,12 @@ def _evaluate_consensus_with_hardware(
         consensus = agreements == total_strategies
 
         if consensus:
-            parts = [
-                "no counter-evidence found",
-                "independent analysis confirms",
-                "temporal change observed",
-            ]
+            parts = ["no counter-evidence found", "independent analysis confirms", "temporal change observed"]
             if ensemble:
                 parts.append(f"ensemble confirms ({ensemble.votes_yes}/{ensemble.total_votes} YES)")
             if hardware_context:
                 parts.append("no hardware error concerns")
-            reasoning = (
-                f"All verification strategies agree ({total_strategies}/{total_strategies}): "
-                + ", ".join(parts)
-            )
+            reasoning = f"All verification strategies agree ({total_strategies}/{total_strategies}): " + ", ".join(parts)
         else:
             reasoning = (
                 f"Verification disagreement ({agreements}/{total_strategies} agree): "
@@ -753,12 +696,11 @@ async def _run_adversarial(
                 return AdversarialResult(
                     found_counter_evidence=False,
                     concerns=["No images available for verification"],
-                    confidence_in_original=None,
                     raw_response="",
                 )
 
             # Build detector-specific critical review guidance
-            if detector.name == "hatching":
+            if detector.name == 'hatching':
                 specific_guidance = """
 For HATCHING specifically, look for these common FALSE POSITIVE patterns:
 - Is the worm still COILED/PRETZEL-SHAPED inside the eggshell?
@@ -771,12 +713,10 @@ async def _run_adversarial(
             else:
                 specific_guidance = ""
 
-            prompt = f"""You are reviewing a detection result for a C. elegans embryo
-(diSPIM max projection).
+            prompt = f"""You are reviewing a detection result for a C. elegans embryo (diSPIM max projection).
 
 The system detected: {detector.name}
-Original confidence: {original_result.confidence.value if original_result.confidence else "unknown"}
-Original reasoning: {original_result.reasoning or "not provided"}
+Original reasoning: {original_result.reasoning or 'not provided'}
 
 NOW ACT AS A CRITICAL REVIEWER. Your job is to find reasons why this detection might be INCORRECT:
 - Could this be a false positive?
@@ -784,10 +724,7 @@ async def _run_adversarial(
 - Is the evidence actually conclusive, or could it be interpreted differently?
 - Are there alternative explanations for what is observed?
 {specific_guidance}
-Analyze the image(s) carefully and respond in EXACTLY this format:
-COUNTER_EVIDENCE_FOUND: [YES/NO]
-CONCERNS: [list specific doubts or alternative explanations, separated by semicolons]
-CONFIDENCE_IN_ORIGINAL: [HIGH/MEDIUM/LOW]
+Analyze the image(s) carefully and record your review with the record_adversarial_review tool.
 """
 
             content = [{"type": "text", "text": prompt}] + images
@@ -796,18 +733,26 @@ async def _run_adversarial(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=500,
-                messages=[{"role": "user", "content": content}],
+                tools=[_ADVERSARIAL_TOOL],
+                tool_choice={"type": "tool", "name": _ADVERSARIAL_TOOL["name"]},
+                messages=[{"role": "user", "content": content}]
             )
 
-            response_text = response.content[0].text
-            return self._parse_adversarial_response(response_text)
+            data = _tool_input(response)
+            if not isinstance(data, dict):
+                raise ValueError("no tool_use block in response")
+            concerns = data.get("concerns") or []
+            return AdversarialResult(
+                found_counter_evidence=bool(data.get("found_counter_evidence", False)),
+                concerns=[str(c) for c in concerns],
+                raw_response=str(data),
+            )
 
         except Exception as e:
             logger.error(f"Adversarial verification failed: {e}")
             return AdversarialResult(
                 found_counter_evidence=False,
                 concerns=[f"Verification error: {str(e)}"],
-                confidence_in_original=None,
                 raw_response="",
             )
 
@@ -829,13 +774,12 @@ async def _run_independent(
             if not images:
                 return IndependentResult(
                     detected=False,
-                    confidence=None,
                     key_evidence="No images available",
                     raw_response="",
                 )
 
             # Build detector-specific criteria
-            if detector.name == "hatching":
+            if detector.name == 'hatching':
                 criteria = """
 TRUE HATCHING criteria (must meet at least one):
 - Worm body is OUTSIDE the eggshell boundary (free-floating, elongated)
@@ -849,8 +793,7 @@ async def _run_independent(
                 criteria = detector.description
 
             # Use a neutral prompt that doesn't reveal the previous detection
-            prompt = f"""Analyze this C. elegans embryo image (diSPIM max projection) at
-timepoint {timepoint}.
+            prompt = f"""Analyze this C. elegans embryo image (diSPIM max projection) at timepoint {timepoint}.
 
 Question: Has '{detector.name}' occurred in this embryo?
 
@@ -859,10 +802,7 @@ async def _run_independent(
 Provide an independent assessment based SOLELY on what you observe in this image.
 Do not assume any prior state - analyze only what is visible now.
 
-Respond in EXACTLY this format:
-DETECTED: [YES/NO]
-CONFIDENCE: [HIGH/MEDIUM/LOW]
-KEY_EVIDENCE: [what specifically do you observe that supports your conclusion?]
+Record your assessment with the record_independent_assessment tool.
 """
 
             content = [{"type": "text", "text": prompt}] + images
@@ -871,17 +811,24 @@ async def _run_independent(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=400,
-                messages=[{"role": "user", "content": content}],
+                tools=[_INDEPENDENT_TOOL],
+                tool_choice={"type": "tool", "name": _INDEPENDENT_TOOL["name"]},
+                messages=[{"role": "user", "content": content}]
             )
 
-            response_text = response.content[0].text
-            return self._parse_independent_response(response_text)
+            data = _tool_input(response)
+            if not isinstance(data, dict):
+                raise ValueError("no tool_use block in response")
+            return IndependentResult(
+                detected=bool(data.get("detected", False)),
+                key_evidence=str(data.get("key_evidence", "")),
+                raw_response=str(data),
+            )
 
         except Exception as e:
             logger.error(f"Independent verification failed: {e}")
             return IndependentResult(
                 detected=False,
-                confidence=None,
                 key_evidence=f"Verification error: {str(e)}",
                 raw_response="",
             )
@@ -904,7 +851,6 @@ async def _run_temporal_check(
                 return TemporalResult(
                     change_detected=True,  # Can't disprove without history
                     description="Insufficient temporal history for comparison",
-                    confidence=ConfidenceLevel.LOW,
                     raw_response="",
                 )
 
@@ -915,27 +861,24 @@ async def _run_temporal_check(
             prev_images = []
             for img in embryo_state.recent_images[-3:-1]:
                 if img.max_projection_b64:
-                    prev_images.append(
-                        {
-                            "type": "image",
-                            "source": {
-                                "type": "base64",
-                                "media_type": "image/png",
-                                "data": img.max_projection_b64,
-                            },
+                    prev_images.append({
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": "image/png",
+                            "data": img.max_projection_b64,
                         }
-                    )
+                    })
 
             if not prev_images:
                 return TemporalResult(
                     change_detected=True,
                     description="No previous images available",
-                    confidence=ConfidenceLevel.LOW,
                     raw_response="",
                 )
 
             # Build detector-specific temporal criteria
-            if detector.name == "hatching":
+            if detector.name == 'hatching':
                 temporal_criteria = """For HATCHING, look for:
 - A visible BREACH appearing in the eggshell boundary (not just expansion)
 - The worm physically EXITING the shell (part of body moves outside)
@@ -947,11 +890,10 @@ async def _run_temporal_check(
 - Not just a static state that could have existed before
 - Clear evidence of progression or event occurrence"""
 
-            prompt = f"""Compare these sequential timepoints of a C. elegans embryo
-(diSPIM max projection).
+            prompt = f"""Compare these sequential timepoints of a C. elegans embryo (diSPIM max projection).
 
 PREVIOUS TIMEPOINTS (shown first):
-These are from t={timepoint - 2} to t={timepoint - 1}
+These are from t={timepoint-2} to t={timepoint-1}
 
 CURRENT TIMEPOINT (shown last):
 This is t={timepoint}
@@ -960,10 +902,7 @@ async def _run_temporal_check(
 
 {temporal_criteria}
 
-Respond in EXACTLY this format:
-CHANGE_DETECTED: [YES/NO]
-DESCRIPTION: [what specific change do you see between the previous and current frames?]
-CONFIDENCE: [HIGH/MEDIUM/LOW]
+Record your comparison with the record_temporal_comparison tool.
 """
 
             # Combine: previous images first, then prompt, then current
@@ -973,38 +912,47 @@ async def _run_temporal_check(
                 self.claude.messages.create,
                 model=self.model,
                 max_tokens=400,
-                messages=[{"role": "user", "content": content}],
+                tools=[_TEMPORAL_TOOL],
+                tool_choice={"type": "tool", "name": _TEMPORAL_TOOL["name"]},
+                messages=[{"role": "user", "content": content}]
             )
 
-            response_text = response.content[0].text
-            return self._parse_temporal_response(response_text)
+            data = _tool_input(response)
+            if not isinstance(data, dict):
+                raise ValueError("no tool_use block in response")
+            return TemporalResult(
+                change_detected=bool(data.get("change_detected", True)),
+                description=str(data.get("description", "")),
+                raw_response=str(data),
+            )
 
         except Exception as e:
             logger.error(f"Temporal verification failed: {e}")
             return TemporalResult(
                 change_detected=True,  # Don't block on error
                 description=f"Verification error: {str(e)}",
-                confidence=None,
                 raw_response="",
             )
 
-    def _get_image_content(self, embryo_state: EmbryoState, num_images: int = 1) -> list[dict]:
+    def _get_image_content(
+        self,
+        embryo_state: EmbryoState,
+        num_images: int = 1
+    ) -> List[Dict]:
         """Get image content blocks for Claude API"""
         images = []
         recent = embryo_state.recent_images[-num_images:] if embryo_state.recent_images else []
 
         for img in recent:
             if img.max_projection_b64:
-                images.append(
-                    {
-                        "type": "image",
-                        "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": img.max_projection_b64,
-                        },
+                images.append({
+                    "type": "image",
+                    "source": {
+                        "type": "base64",
+                        "media_type": "image/png",
+                        "data": img.max_projection_b64,
                     }
-                )
+                })
 
         return images
 
@@ -1038,10 +986,8 @@ async def _run_ensemble_hatching(self, embryo_state: EmbryoState) -> EnsembleRes
 
 Answer ONE question: Has the embryo HATCHED?
 
-HATCHED means: The worm body is OUTSIDE the eggshell (free-floating, elongated, or field is
-empty because worm left).
-NOT HATCHED means: The worm is still INSIDE the eggshell (coiled/pretzel-shaped, even if
-shell looks expanded).
+HATCHED means: The worm body is OUTSIDE the eggshell (free-floating, elongated, or field is empty because worm left).
+NOT HATCHED means: The worm is still INSIDE the eggshell (coiled/pretzel-shaped, even if shell looks expanded).
 
 Respond with ONLY: YES or NO"""
 
@@ -1053,7 +999,7 @@ async def single_vote() -> str:
                         self.claude.messages.create,
                         model=self.ensemble_model,
                         max_tokens=10,  # Very short response expected
-                        messages=[{"role": "user", "content": content}],
+                        messages=[{"role": "user", "content": content}]
                     )
                     return response.content[0].text.strip().upper()
                 except Exception as e:
@@ -1061,10 +1007,7 @@ async def single_vote() -> str:
                     return "ERROR"
 
             # Run all votes in parallel
-            logger.info(
-                f"[ENSEMBLE] Running {self.ensemble_size} parallel Haiku calls"
-                " for hatching verification"
-            )
+            logger.info(f"[ENSEMBLE] Running {self.ensemble_size} parallel Haiku calls for hatching verification")
             tasks = [single_vote() for _ in range(self.ensemble_size)]
             responses = await asyncio.gather(*tasks)
 
@@ -1113,95 +1056,13 @@ async def single_vote() -> str:
                 raw_responses=[f"Error: {str(e)}"],
             )
 
-    def _parse_adversarial_response(self, response: str) -> AdversarialResult:
-        """Parse adversarial strategy response"""
-        found_counter = False
-        concerns = []
-        confidence = None
-
-        for line in response.split("\n"):
-            line = line.strip()
-            if line.startswith("COUNTER_EVIDENCE_FOUND:"):
-                value = line.split(":", 1)[1].strip().upper()
-                found_counter = value == "YES"
-            elif line.startswith("CONCERNS:"):
-                concerns_str = line.split(":", 1)[1].strip()
-                concerns = [c.strip() for c in concerns_str.split(";") if c.strip()]
-            elif line.startswith("CONFIDENCE_IN_ORIGINAL:"):
-                value = line.split(":", 1)[1].strip().upper()
-                try:
-                    confidence = ConfidenceLevel(value)
-                except ValueError:
-                    pass
-
-        return AdversarialResult(
-            found_counter_evidence=found_counter,
-            concerns=concerns,
-            confidence_in_original=confidence,
-            raw_response=response,
-        )
-
-    def _parse_independent_response(self, response: str) -> IndependentResult:
-        """Parse independent strategy response"""
-        detected = False
-        confidence = None
-        evidence = ""
-
-        for line in response.split("\n"):
-            line = line.strip()
-            if line.startswith("DETECTED:"):
-                value = line.split(":", 1)[1].strip().upper()
-                detected = value == "YES"
-            elif line.startswith("CONFIDENCE:"):
-                value = line.split(":", 1)[1].strip().upper()
-                try:
-                    confidence = ConfidenceLevel(value)
-                except ValueError:
-                    pass
-            elif line.startswith("KEY_EVIDENCE:"):
-                evidence = line.split(":", 1)[1].strip()
-
-        return IndependentResult(
-            detected=detected,
-            confidence=confidence,
-            key_evidence=evidence,
-            raw_response=response,
-        )
-
-    def _parse_temporal_response(self, response: str) -> TemporalResult:
-        """Parse temporal strategy response"""
-        change_detected = False
-        description = ""
-        confidence = None
-
-        for line in response.split("\n"):
-            line = line.strip()
-            if line.startswith("CHANGE_DETECTED:"):
-                value = line.split(":", 1)[1].strip().upper()
-                change_detected = value == "YES"
-            elif line.startswith("DESCRIPTION:"):
-                description = line.split(":", 1)[1].strip()
-            elif line.startswith("CONFIDENCE:"):
-                value = line.split(":", 1)[1].strip().upper()
-                try:
-                    confidence = ConfidenceLevel(value)
-                except ValueError:
-                    pass
-
-        return TemporalResult(
-            change_detected=change_detected,
-            description=description,
-            confidence=confidence,
-            raw_response=response,
-        )
-
     def _evaluate_consensus(
         self,
         original: DetectionResult,
         adversarial: AdversarialResult,
         independent: IndependentResult,
         temporal: TemporalResult,
-        ensemble: EnsembleResult | None = None,
+        ensemble: Optional[EnsembleResult] = None,
     ) -> tuple[bool, str]:
         """
         Evaluate consensus across all verification strategies.
@@ -1217,9 +1078,7 @@ def _evaluate_consensus(
         if not adversarial.found_counter_evidence:
             agreements += 1
         else:
-            disagreements.append(
-                f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}"
-            )
+            disagreements.append(f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}")
 
         # Check independent: should also detect
         if independent.detected:
@@ -1253,14 +1112,13 @@ def _evaluate_consensus(
                     f"All verification strategies agree ({total_strategies}/{total_strategies}): "
                     f"no counter-evidence found, independent analysis confirms detection, "
                     f"temporal change observed, ensemble voting confirms "
-                    f"({ensemble.votes_yes}/{ensemble.total_votes}"
-                    f" = {ensemble.agreement_ratio:.0%} YES)."
+                    f"({ensemble.votes_yes}/{ensemble.total_votes} = {ensemble.agreement_ratio:.0%} YES)."
                 )
             else:
                 reasoning = (
-                    "All verification strategies agree: "
-                    "no counter-evidence found, independent analysis confirms detection, "
-                    "temporal change observed."
+                    f"All verification strategies agree: "
+                    f"no counter-evidence found, independent analysis confirms detection, "
+                    f"temporal change observed."
                 )
         else:
             reasoning = (

From 4910d061e43a1fc1058742477429ee1203d7f498 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 07:39:28 +0530
Subject: [PATCH 098/314] Fix recurring port-8080 false positive: SO_REUSEADDR
 on the viz preflight bind
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

uvicorn binds with SO_REUSEADDR; the preflight check did not, making it stricter than the server it guards — a just-exited instance leaves client sockets in TIME_WAIT that fail a bare bind() even though uvicorn would bind fine, so quick restarts hit 'port in use' repeatedly. Set SO_REUSEADDR on the preflight so it fails only on a genuine live listener.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/server.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index faf2a2d8..daf91dba 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -784,6 +784,15 @@ async def on_start(self):
         import socket
 
         sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        # Match uvicorn's own bind semantics. uvicorn sets SO_REUSEADDR before it
+        # binds, so a bare preflight bind WITHOUT it is *stricter* than the real
+        # server: when a previous instance has just exited, its browser/websocket
+        # connections linger in TIME_WAIT holding this local port, and a plain
+        # bind() fails with EADDRINUSE even though uvicorn would bind fine. That
+        # false positive was the recurring "port in use" on quick restarts. With
+        # SO_REUSEADDR the preflight now fails only on a genuine live listener
+        # (a real second instance) — exactly when uvicorn would also fail.
+        sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
         try:
             sock.bind((self.host, self.port))
         except OSError:

From 5ee9e326c31ca24267269ff3c449e42033f4a541 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 07:40:14 +0530
Subject: [PATCH 099/314] chore: gitignore the stray D:/ storage dir

On Linux the Windows default GENTLY_STORAGE_PATH (D:\Gently3) gets created literally as ./D:/ under the repo, full of logs/sessions. Ignore it so it stops cluttering status and can't be committed by accident.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index cce868ec..8bdd129d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -145,3 +145,7 @@ electron/
 /stage_definitions_for_review.txt
 gently/ui/tui/node_modules/
 gently/ui/tui/dist/
+
+# Stray local storage: on Linux the Windows default GENTLY_STORAGE_PATH
+# (D:\Gently3) is created literally as ./D:/ under the repo. Not data we track.
+/D:/

From a8fd3e53ef38eab241337ef0177d47c7930f6734 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 13:17:07 +0530
Subject: [PATCH 100/314] =?UTF-8?q?UX=20v2=20landing:=20fix=20welcome?=
 =?UTF-8?q?=E2=86=92plan=20jump,=20dark=20mode,=20and=20the=20entry=20flow?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Polish + flow fixes for the agent-first landing and in-page plan wizard.

- Kill the welcome→plan "lift-up" lurch: top-anchor both screens to one
  shared offset so the orb no longer teleports ~140px on swap (now ~1px),
  with a single coordinated cross-fade keyframe.
- Fix broken dark mode: define the tokens landing.css relied on but the
  theme never set (--bg, --text-secondary, --accent-soft, --accent-green-soft),
  scoped to body.ux-v2 with a light override; route the page background, drift
  glow, and accent-keyed shadows through real per-theme tokens.
- A11y + polish: visible :focus-visible rings, animated tool-card reveal
  (grid-rows), feed scrolls internally with anchored header/footer, single-
  column mobile without a nested-scroll trap, consistent type scale + 4px
  spacing, ~40px touch targets, aria-expanded on disclosures, expanded
  prefers-reduced-motion coverage.
- Entry flow: under ux_v2 the landing owns session entry, so suppress the
  legacy connect-time resolution picker server-side (it duplicated and
  contradicted the landing's Plan/Standalone choice). Guard the design
  kickoff so it fires once per session (no Back/forward pile-up).
- "Plan an experiment" now offers continue-vs-fresh when an active campaign
  exists: continue it (default) or start a brand-new campaign from scratch.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/routes/agent_ws.py     |  15 +-
 gently/ui/web/static/css/landing.css | 239 +++++++++++++----
 gently/ui/web/static/js/landing.js   | 386 +++++++++++++++++++++++----
 gently/ui/web/templates/index.html   |   9 +-
 4 files changed, 548 insertions(+), 101 deletions(-)

diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index fdf2fc5f..887fdd25 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -14,6 +14,8 @@
 
 from fastapi import APIRouter, WebSocket, WebSocketDisconnect
 
+from gently.settings import settings
+
 logger = logging.getLogger(__name__)
 
 
@@ -744,9 +746,18 @@ async def _run_resolution_bootstrap():
                         pass
 
             if not wizard_ran:
-                if bridge.should_enter_resolution():
+                enter_resolution = bridge.should_enter_resolution()
+                # Under ux_v2 the agent-first landing owns the session-entry
+                # decision ("Plan an experiment" / "Take a quick look"), so the
+                # legacy connect-time resolution picker would just duplicate it —
+                # and contradict it, by offering "Standalone" after the user has
+                # already chosen to plan. Stay quiet on connect for new sessions;
+                # the landing drives plan-mode (/plan) or standalone instead.
+                if enter_resolution and not settings.ui.ux_v2:
                     bootstrap_task = asyncio.create_task(_run_resolution_bootstrap())
-                else:
+                elif not enter_resolution:
+                    # Resume / already-resolved sessions still get their briefing
+                    # (it sits behind the landing overlay until dismissed).
                     briefing = bridge.get_session_briefing()
                     if briefing:
                         await send_fn({"type": "stream_start"})
diff --git a/gently/ui/web/static/css/landing.css b/gently/ui/web/static/css/landing.css
index c5152cf5..fff753e8 100644
--- a/gently/ui/web/static/css/landing.css
+++ b/gently/ui/web/static/css/landing.css
@@ -6,19 +6,46 @@
    but reuses production's CSS variables (with the prototype hexes as fallback)
    so it tracks the app theme. */
 
+/* ux_v2 landing fills the gaps in the production token set (main.css defines
+   --bg-dark/-card/-hover, --border, --text, --text-muted, --accent, --accent-green
+   but NOT a page-bg alias, a secondary-text, or accent tints). Scope to
+   body.ux-v2 so v1 is untouched; both themes resolved here so landing.css can
+   reference these like any real token. dark is the default theme (main.css :root). */
+body.ux-v2 {
+    --bg: var(--bg-dark);                       /* page background, theme-aware */
+    --text-secondary: var(--text-muted);
+    --accent-soft: rgba(96,165,250,.15);        /* tint of dark --accent #60a5fa */
+    --accent-green-soft: rgba(74,222,128,.15);  /* tint of dark --accent-green */
+    /* one disciplined type scale for the landing/plan surface */
+    --v2-fs-body: 14px;
+    --v2-fs-sm: 13px;
+    --v2-fs-cap: 12px;
+    --v2-fs-eyebrow: 11px;
+}
+body.ux-v2[data-theme="light"] {
+    --accent-soft: rgba(59,130,246,.10);        /* tint of light --accent #3b82f6 */
+    --accent-green-soft: rgba(34,197,94,.12);   /* tint of light --accent-green */
+}
+/* accent-keyed glows can't put var() inside rgba channels, so the dark defaults
+   live on the elements (re-keyed off the dead #2f6df6 onto the real #60a5fa) and
+   light overrides ride here next to the tokens. */
+body.ux-v2[data-theme="light"] .v2-landing-orb { box-shadow: 0 6px 22px rgba(59,130,246,.35), inset 0 0 12px rgba(255,255,255,.6); }
+body.ux-v2[data-theme="light"] .v2-escape-field input:focus { box-shadow: 0 0 0 4px rgba(59,130,246,.12); }
+body.ux-v2[data-theme="light"] .v2-escape-send { box-shadow: 0 6px 16px rgba(59,130,246,.35); }
+
 .v2-landing {
     position: fixed;
     inset: 0;
     z-index: 200;
     display: flex;
-    align-items: center;
+    align-items: flex-start;   /* BOTH screens top-anchored — no discrete switch on swap */
     justify-content: center;
     padding: 24px;
     overflow: hidden;
     background:
-        radial-gradient(1100px 700px at 78% -8%, #eaf1ff 0%, transparent 55%),
-        radial-gradient(900px 600px at 8% 108%, #eafaf0 0%, transparent 55%),
-        var(--bg, #f6f8fb);
+        radial-gradient(1100px 700px at 78% -8%, var(--accent-soft) 0%, transparent 55%),
+        radial-gradient(900px 600px at 8% 108%, var(--accent-green-soft) 0%, transparent 55%),
+        var(--bg);
     transition: opacity .5s cubic-bezier(.22,1,.36,1), transform .5s cubic-bezier(.22,1,.36,1), visibility .5s;
 }
 /* The calm screen "unfolds" into the workspace: fade + slight scale-up, then
@@ -34,9 +61,10 @@
     content: "";
     position: absolute;
     inset: -20vmax;
-    background: radial-gradient(closest-side, rgba(47,109,246,.10), transparent 70%);
+    background: radial-gradient(closest-side, var(--accent-soft), transparent 70%);
     filter: blur(30px);
     animation: v2land-drift 26s cubic-bezier(.22,1,.36,1) infinite alternate;
+    will-change: transform;
     pointer-events: none;
 }
 @keyframes v2land-drift {
@@ -52,6 +80,8 @@
     align-items: center;
     max-width: 760px;
     width: 100%;
+    margin-top: 7vh;      /* shared anchor for welcome AND plan — orb stays put on swap */
+    margin-bottom: 5vh;
 }
 .v2-landing-rise { animation: v2land-rise .6s cubic-bezier(.22,1,.36,1) backwards; }
 .v2-landing-rise[data-i="1"] { animation-delay: .07s; }
@@ -64,7 +94,7 @@
 .v2-landing-orb {
     width: 52px; height: 52px; border-radius: 50%;
     background: radial-gradient(closest-side at 38% 34%, #ffffff, #bcd3ff 40%, var(--accent, #2f6df6) 100%);
-    box-shadow: 0 6px 22px rgba(47,109,246,.45), inset 0 0 12px rgba(255,255,255,.6);
+    box-shadow: 0 6px 22px rgba(96,165,250,.45), inset 0 0 12px rgba(255,255,255,.6);
     animation: v2land-breathe 4s ease-in-out infinite;
 }
 @keyframes v2land-breathe { 0%,100% { transform: scale(1); } 50% { transform: scale(1.06); } }
@@ -76,33 +106,44 @@
 
 /* choice cards */
 .v2-landing-choices {
-    display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 18px;
-    margin-top: 34px; width: min(720px, 92vw);
+    display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 16px;
+    margin-top: 32px; width: min(720px, 92vw);
 }
 @media (max-width: 620px) { .v2-landing-choices { grid-template-columns: 1fr; } }
 .v2-choice {
     text-align: left; cursor: pointer; position: relative; overflow: hidden;
     border: 1px solid var(--border, #e4e9f0); background: var(--bg-card, #fff);
-    border-radius: 18px; padding: 22px 22px 20px;
+    border-radius: 18px; padding: 20px;
     box-shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
     font: inherit; color: var(--text, #0f172a);
     transition: transform .26s cubic-bezier(.22,1,.36,1), box-shadow .26s cubic-bezier(.22,1,.36,1), border-color .26s;
 }
 .v2-choice:hover {
-    transform: translateY(-4px); border-color: #cfdcf5;
-    box-shadow: 0 2px 6px rgba(15,23,42,.06), 0 18px 50px rgba(47,109,246,.14);
+    transform: translateY(-4px);
+    border-color: color-mix(in srgb, var(--accent) 45%, var(--border));
+    box-shadow: 0 2px 6px rgba(15,23,42,.06),
+                0 18px 50px color-mix(in srgb, var(--accent) 16%, transparent);
 }
 .v2-choice:active { transform: translateY(-1px) scale(.995); }
+
+/* Visible keyboard focus for every landing/plan control (mouse clicks get no ring) */
+#v2-landing :focus-visible {
+    outline: 2px solid var(--accent);
+    outline-offset: 2px;
+    border-radius: 12px;            /* hug the pill/card corners */
+}
+#v2-landing .v2-choice:focus-visible { outline-offset: -2px; }  /* inset: the card clips outside outlines */
+#v2-landing .v2-escape-field input:focus-visible { outline-offset: 0; }
 .v2-choice-ic {
     width: 40px; height: 40px; border-radius: 11px; display: grid; place-items: center;
     background: var(--accent-soft, #eaf1ff); color: var(--accent, #2f6df6); margin-bottom: 14px;
 }
 .v2-choice.alt .v2-choice-ic { background: var(--accent-green-soft, #e7f6ec); color: var(--accent-green, #16a34a); }
 .v2-choice h3 { margin: 0 0 6px; font-size: 17px; letter-spacing: -.01em; }
-.v2-choice p { margin: 0; color: var(--text-secondary, #475569); font-size: 13.5px; line-height: 1.5; }
+.v2-choice p { margin: 0; color: var(--text-secondary, #475569); font-size: var(--v2-fs-sm); line-height: 1.5; }
 .v2-choice-tag {
     position: absolute; top: 16px; right: 16px;
-    font-size: 10.5px; letter-spacing: .06em; text-transform: uppercase; color: var(--text-muted, #94a3b8);
+    font-size: var(--v2-fs-eyebrow); letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8);
     border: 1px solid var(--border, #e4e9f0); border-radius: 999px; padding: 3px 9px;
 }
 .v2-choice-go {
@@ -114,15 +155,15 @@
 .v2-choice:hover .v2-choice-go { opacity: 1; transform: none; }
 
 /* escape hatch — chat is the last resort, an obvious pill */
-.v2-escape { margin-top: 26px; display: flex; flex-direction: column; align-items: center; }
+.v2-escape { margin-top: 24px; display: flex; flex-direction: column; align-items: center; }
 .v2-escape-toggle {
     display: inline-flex; align-items: center; gap: 7px; cursor: pointer; font: inherit; font-size: 13px;
     background: var(--bg-card, #fff); border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
-    padding: 8px 15px; border-radius: 999px;
+    padding: 11px 16px; border-radius: 999px;
     box-shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
     transition: color .2s, border-color .2s, transform .2s cubic-bezier(.22,1,.36,1);
 }
-.v2-escape-toggle:hover { color: var(--text, #0f172a); border-color: #cfd9e6; transform: translateY(-1px); }
+.v2-escape-toggle:hover { color: var(--text, #0f172a); border-color: var(--border-strong); transform: translateY(-1px); }
 .v2-escape-toggle .v2-escape-caret { display: inline-block; transition: transform .3s cubic-bezier(.22,1,.36,1); opacity: .55; }
 .v2-escape.open .v2-escape-toggle .v2-escape-caret { transform: rotate(180deg); }
 .v2-escape-field {
@@ -133,22 +174,22 @@
 .v2-escape.open .v2-escape-field { max-height: 64px; opacity: 1; margin-top: 12px; }
 .v2-escape-field input {
     flex: 1; min-width: 0; border: 1px solid var(--border, #e4e9f0); background: var(--bg-card, #fff);
-    border-radius: 12px; padding: 12px 14px; font: inherit; font-size: 14px; color: var(--text, #0f172a);
+    border-radius: 12px; padding: 12px 14px; font: inherit; font-size: var(--v2-fs-body); color: var(--text, #0f172a);
     outline: none; box-shadow: 0 1px 2px rgba(15,23,42,.04);
     transition: border-color .2s, box-shadow .2s;
 }
-.v2-escape-field input:focus { border-color: var(--accent, #2f6df6); box-shadow: 0 0 0 4px rgba(47,109,246,.12); }
+.v2-escape-field input:focus { border-color: var(--accent, #2f6df6); box-shadow: 0 0 0 4px rgba(96,165,250,.18); }
 .v2-escape-send {
     appearance: none; border: 0; cursor: pointer; flex: none; width: 42px; height: 42px; border-radius: 12px;
     background: var(--accent, #2f6df6); color: #fff; display: grid; place-items: center;
-    box-shadow: 0 6px 16px rgba(47,109,246,.35); transition: transform .2s cubic-bezier(.22,1,.36,1), filter .2s;
+    box-shadow: 0 6px 16px rgba(96,165,250,.40); transition: transform .2s cubic-bezier(.22,1,.36,1), filter .2s;
 }
 .v2-escape-send:hover { transform: translateY(-1px); filter: brightness(1.05); }
 
 /* one-way skip into the workspace (e.g. a reload mid-session) */
 .v2-landing-skip {
-    margin-top: 28px; background: none; border: 0; cursor: pointer; font: inherit; font-size: 12.5px;
-    color: var(--text-muted, #94a3b8); padding: 6px 10px; border-radius: 8px;
+    margin-top: 24px; background: none; border: 0; cursor: pointer; font: inherit; font-size: var(--v2-fs-cap);
+    color: var(--text-muted, #94a3b8); padding: 10px 12px; border-radius: 8px;
     transition: color .2s;
 }
 .v2-landing-skip:hover { color: var(--text-secondary, #475569); }
@@ -164,29 +205,46 @@ body.ux-v2 .home-hero { display: none; }
 .v2-landing[data-screen="welcome"] .v2-screen-welcome {
     display: flex; flex-direction: column; align-items: center;
     max-width: 760px; margin: 0 auto;
+    animation: v2land-plan-in .42s cubic-bezier(.22,1,.36,1) backwards;
 }
 .v2-landing[data-screen="plan"] .v2-screen-plan {
     display: flex; flex-direction: column;
-    animation: v2land-rise .45s cubic-bezier(.22,1,.36,1) backwards;
+    animation: v2land-plan-in .42s cubic-bezier(.22,1,.36,1) backwards;
+}
+/* One swap motion shared by both screens: a soft opacity + rise + settle. The
+   scale .992→1 echoes the dismissed-state scale(1.015) so the surface feels like
+   one continuous fabric folding, not two slides swapping. */
+@keyframes v2land-plan-in {
+    from { opacity: 0; transform: translateY(10px) scale(.992); }
+    to   { opacity: 1; transform: none; }
 }
 
 /* plan header */
-.v2-plan-head { display: flex; align-items: center; gap: 12px; margin-bottom: 18px; }
-.v2-plan-orb { width: 34px; height: 34px; }
-.v2-plan-who { font-size: 11px; letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8); }
+.v2-plan-head { display: flex; align-items: center; gap: 12px; margin-bottom: 16px; }
+.v2-plan-orb { width: 40px; height: 40px; transition: width .42s cubic-bezier(.22,1,.36,1), height .42s cubic-bezier(.22,1,.36,1); }
+.v2-plan-who { font-size: var(--v2-fs-eyebrow); letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8); }
 .v2-plan-title { font-size: 18px; font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); }
 .v2-plan-back {
     margin-left: auto; background: none; border: 0; cursor: pointer; font: inherit; font-size: 13px;
-    color: var(--text-muted, #94a3b8); padding: 6px 10px; border-radius: 8px; transition: color .2s, background .2s;
+    color: var(--text-muted, #94a3b8); padding: 9px 12px; border-radius: 8px; transition: color .2s, background .2s;
 }
 .v2-plan-back:hover { color: var(--text, #0f172a); background: rgba(15,23,42,.05); }
 
 /* plan body: ask stage + assembling plan */
 .v2-plan-wrap { display: grid; grid-template-columns: 1.35fr .9fr; gap: 20px; align-items: start; }
-@media (max-width: 720px) { .v2-plan-wrap { grid-template-columns: 1fr; } }
+@media (max-width: 720px) {
+    .v2-plan-wrap { grid-template-columns: 1fr; }
+    /* single column: THE PLAN sits BELOW the feed — drop the internal scroll
+       and let the whole plan screen scroll as one document instead. The
+       descendant selector outranks the plain `.v2-plan-main { max-height }`
+       rule that appears later in the file (equal specificity → source order),
+       so the cap is genuinely lifted here, not silently re-applied. */
+    .v2-landing[data-screen="plan"] .v2-plan-main { height: auto; max-height: none; overflow-y: visible; padding-right: 0; }
+    .v2-landing[data-screen="plan"] { overflow-y: auto; }
+}
 .v2-plan-main { min-height: 220px; }
 .v2-plan-ask:empty { display: none; }
-.v2-plan-thinking { display: flex; align-items: center; gap: 9px; color: var(--text-muted, #94a3b8); font-size: 13.5px; padding: 22px 4px; }
+.v2-plan-thinking { display: flex; align-items: center; gap: 9px; color: var(--text-muted, #94a3b8); font-size: var(--v2-fs-sm); padding: 20px 4px; }
 .v2-plan-thinking.hidden { display: none; }
 .v2-typing { display: inline-flex; gap: 5px; align-items: center; }
 .v2-typing i { width: 7px; height: 7px; border-radius: 50%; background: var(--accent, #2f6df6); opacity: .4; animation: v2-blink 1.1s infinite; }
@@ -195,33 +253,124 @@ body.ux-v2 .home-hero { display: none; }
 @keyframes v2-blink { 0%,100% { opacity: .25; transform: translateY(0); } 50% { opacity: 1; transform: translateY(-3px); } }
 
 .v2-plan-side {
-    background: var(--bg-card, #fff); border: 1px solid var(--border, #e4e9f0); border-radius: 14px; padding: 16px 18px;
-    box-shadow: 0 1px 2px rgba(15,23,42,.04), 0 8px 28px rgba(15,23,42,.06);
+    background: var(--bg-card, #fff); border: 1px solid var(--border, #e4e9f0); border-radius: 14px; padding: 14px 16px;
+    box-shadow: 0 1px 2px rgba(15,23,42,.04);
 }
-.v2-plan-side-h { font-size: 11px; letter-spacing: .1em; text-transform: uppercase; color: var(--text-muted, #94a3b8); margin-bottom: 12px; }
-.v2-plan-side-empty { color: var(--text-muted, #94a3b8); font-size: 13px; font-style: italic; }
+.v2-plan-side-h { font-size: var(--v2-fs-eyebrow); letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8); margin-bottom: 10px; }
+.v2-plan-side-empty { color: var(--text-muted, #94a3b8); font-size: var(--v2-fs-sm); font-style: italic; }
 .v2-plan-row { display: flex; flex-direction: column; gap: 2px; padding: 9px 0; border-top: 1px dashed var(--border, #e4e9f0); }
 .v2-plan-row:first-child { border-top: 0; }
-.v2-plan-row .k { font-size: 10.5px; letter-spacing: .05em; text-transform: uppercase; color: var(--text-muted, #94a3b8); }
-.v2-plan-row .v { font-size: 14px; color: var(--text, #0f172a); font-weight: 550; }
+.v2-plan-row .k { font-size: var(--v2-fs-eyebrow); letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8); }
+.v2-plan-row .v { font-size: var(--v2-fs-body); color: var(--text, #0f172a); font-weight: 600; }
 
-/* plan footer */
-.v2-plan-foot { display: flex; align-items: center; gap: 10px; margin-top: 22px; }
+/* plan footer: "Open conversation" (quiet, left), a spacer, then "Continue in
+   workspace" demoted to a text link (right). The agent's recommended option in
+   the ask card is the real primary action now — the footer no longer competes. */
+.v2-plan-foot { display: flex; align-items: center; gap: 10px; margin-top: 20px; padding-top: 16px; border-top: 1px solid var(--border, #e4e9f0); }
+.v2-plan-foot-spacer { flex: 1; }
 .v2-plan-chat {
-    margin-right: auto; background: none; border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
-    border-radius: 999px; padding: 8px 14px; font: inherit; font-size: 13px; cursor: pointer; transition: border-color .2s, color .2s;
+    background: none; border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
+    border-radius: 999px; padding: 11px 16px; font: inherit; font-size: var(--v2-fs-sm); cursor: pointer; transition: border-color .2s, color .2s;
 }
-.v2-plan-chat:hover { border-color: #cfd9e6; color: var(--text, #0f172a); }
-.v2-plan-continue {
-    background: var(--accent, #2f6df6); color: #fff; border: 0; border-radius: 10px; padding: 10px 16px;
-    font: inherit; font-size: 13.5px; font-weight: 600; cursor: pointer; transition: transform .2s cubic-bezier(.22,1,.36,1), filter .2s;
+.v2-plan-chat:hover { border-color: var(--border-strong); color: var(--text, #0f172a); }
+.v2-plan-skip {
+    background: none; border: 0; cursor: pointer; font: inherit; font-size: var(--v2-fs-sm);
+    color: var(--text-muted, #94a3b8); padding: 11px 10px; border-radius: 8px; transition: color .2s;
 }
-.v2-plan-continue:hover { transform: translateY(-1px); filter: brightness(1.05); }
+.v2-plan-skip:hover { color: var(--text-secondary, #475569); }
+
+/* ── Agent-activity feed: claude.ai-style collapsible tool cards ──────────── */
+/* Both screens share the .v2-landing-inner top anchor (no per-screen align flip —
+   that was the welcome→plan lurch). The feed is a fixed-height viewport (height
+   set above) so the streaming activity column scrolls on its own without ever
+   reflowing the anchored header/footer around it. Short feeds stay compact
+   (min-height above); long feeds cap at 66vh and scroll internally. The header
+   never moves because the inner is top-anchored — only the footer rides down as
+   the feed grows, up to the cap. */
+.v2-plan-main { max-height: 66vh; overflow-y: auto; padding-right: 4px; }
+
+.v2-plan-activity { display: flex; flex-direction: column; gap: 8px; margin-bottom: 12px; }
+.v2-plan-activity:empty { display: none; margin: 0; }
+
+/* agent prose between tool calls */
+.v2-act-text { font-size: var(--v2-fs-sm); line-height: 1.55; color: var(--text-secondary, #475569); white-space: pre-wrap; }
+
+/* collapsed-by-default tool card; the header toggles .open to reveal the body */
+.v2-act-tool { border: 1px solid var(--border, #e4e9f0); border-radius: 11px; background: var(--bg-card, #fff); overflow: hidden; }
+.v2-act-tool-head {
+    display: flex; align-items: center; gap: 8px; width: 100%;
+    background: none; border: 0; cursor: pointer; text-align: left; font: inherit;
+    padding: 11px 12px; color: var(--text, #0f172a);
+}
+.v2-act-tool-head:hover { background: var(--bg-hover, #f1f5f9); }
+.v2-act-ic { width: 16px; flex: none; text-align: center; font-size: 12px; }
+.v2-act-tool.done .v2-act-ic { color: var(--accent-green, #16a34a); }
+.v2-act-tool.err .v2-act-ic { color: #ea580c; }
+body.ux-v2[data-theme="dark"] .v2-act-tool.err .v2-act-ic { color: #fb923c; }
+.v2-act-spin {
+    display: inline-block; width: 11px; height: 11px; border-radius: 50%;
+    border: 2px solid var(--border, #e4e9f0); border-top-color: var(--accent, #2f6df6);
+    animation: v2-act-spin .7s linear infinite;
+}
+@keyframes v2-act-spin { to { transform: rotate(360deg); } }
+.v2-act-label { font-size: var(--v2-fs-sm); font-weight: 600; flex: none; }
+.v2-act-summary { font-size: var(--v2-fs-cap); color: var(--text-muted, #94a3b8); flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.v2-act-chev { flex: none; color: var(--text-muted, #94a3b8); transition: transform .2s; font-size: 13px; }
+.v2-act-tool.open .v2-act-chev { transform: rotate(90deg); }
+/* animatable collapse: grid-template-rows 0fr→1fr eases in step with the chevron
+   (display:none isn't animatable). Needs exactly ONE min-height:0 child — landing.js
+   wraps the blocks in a single inner div for this. */
+.v2-act-tool-body {
+    display: grid; grid-template-rows: 0fr; opacity: 0;
+    padding: 0 12px 0 37px;
+    transition: grid-template-rows .26s cubic-bezier(.22,1,.36,1),
+                opacity .26s cubic-bezier(.22,1,.36,1),
+                padding-bottom .26s cubic-bezier(.22,1,.36,1);
+}
+.v2-act-tool-body > * { min-height: 0; overflow: hidden; }
+.v2-act-tool.open .v2-act-tool-body { grid-template-rows: 1fr; opacity: 1; padding-bottom: 11px; }
+.v2-act-tool.open .v2-act-summary { white-space: normal; }
+.v2-act-block-label { font-size: var(--v2-fs-eyebrow); letter-spacing: .08em; text-transform: uppercase; color: var(--text-muted, #94a3b8); margin-top: 8px; }
+.v2-act-block {
+    font: 12px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace;
+    background: var(--bg-hover); border: 1px solid var(--border, #e4e9f0); border-radius: 8px;
+    padding: 8px 10px; margin-top: 4px; white-space: pre-wrap; word-break: break-word;
+    color: var(--text-secondary, #475569); max-height: 220px; overflow: auto;
+}
+
+/* error + fallback states */
+.v2-plan-error {
+    font-size: var(--v2-fs-sm); color: #b91c1c;
+    background: rgba(239,68,68,.10); border: 1px solid rgba(239,68,68,.35);
+    border-radius: 11px; padding: 11px 13px;
+}
+body.ux-v2[data-theme="dark"] .v2-plan-error {
+    color: #fca5a5; background: rgba(239,68,68,.14); border-color: rgba(239,68,68,.40);
+}
+.v2-plan-error.hidden { display: none; }
+.v2-plan-fallback { font-size: 13px; color: var(--text-muted, #94a3b8); padding: 8px 2px; }
+.v2-plan-fallback a { color: var(--accent, #2f6df6); cursor: pointer; }
+
+/* plan-panel: phases + tasks (real plan), and a free-text-answer row variant */
+.v2-plan-phase { margin-top: 12px; }
+.v2-plan-phase:first-child { margin-top: 0; }
+.v2-plan-phase-h { font-size: 13px; font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); margin-bottom: 5px; }
+.v2-plan-task { display: flex; gap: 8px; font-size: var(--v2-fs-cap); color: var(--text-secondary, #475569); padding: 2px 0; }
+.v2-plan-task::before { content: "·"; color: var(--text-muted, #94a3b8); }
+.v2-plan-title-row { font-size: var(--v2-fs-sm); font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); margin-bottom: 8px; }
+.v2-plan-row.v2-plan-row-freetext .v { font-style: italic; }
 
 @media (prefers-reduced-motion: reduce) {
-    .v2-landing, .v2-landing::before, .v2-landing-rise, .v2-landing-orb,
-    .v2-landing[data-screen="plan"] .v2-screen-plan, .v2-typing i {
+    .v2-landing, .v2-landing::before, .v2-landing-rise, .v2-landing-orb, .v2-plan-orb,
+    .v2-landing[data-screen="plan"] .v2-screen-plan,
+    .v2-landing[data-screen="welcome"] .v2-screen-welcome,
+    .v2-typing i, .v2-act-spin, .v2-act-chev,
+    .v2-act-tool-body, .v2-act-tool-head,
+    .v2-choice, .v2-escape-field, .v2-escape-toggle {
         animation: none !important;
         transition-duration: .12s !important;
     }
+    /* keep the collapsible usable without the height tween */
+    .v2-act-tool-body { transition: none !important; }
+    .v2-act-tool.open .v2-act-tool-body { grid-template-rows: 1fr; opacity: 1; }
 }
diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
index 35eaf1fa..2f524c1e 100644
--- a/gently/ui/web/static/js/landing.js
+++ b/gently/ui/web/static/js/landing.js
@@ -1,23 +1,26 @@
 /**
  * V2Landing (ux_v2): the agent-first welcome AND the in-place plan wizard.
  *
- * The key paradigm fix: the plan dialogue renders IN THE LANDING, not the chat
- * REPL. Clicking "Plan an experiment" doesn't recede to the dashboard — it
- * switches the landing to a plan screen, enters plan mode, and renders the
- * agent's ask_user_choice questions as button cards right there (#v2-plan-ask),
- * reusing AgentChat.buildAskCard so it's the same card/answer path as elsewhere.
- * The plan assembles on the right from each pick. Chat is never the surface
- * (it's one click away via "Open conversation" as the last resort).
- *
- *   Plan an experiment → switch to plan screen; /plan + kickoff; asks render here
- *   Take a quick look  → scope (Devices view)
- *   "just tell me…"    → free-text into the agent loop (then chat as transcript)
+ * Clicking "Plan an experiment" switches the landing to a plan screen, enters
+ * plan mode, and renders the agent's work IN THE WIZARD — not the chat REPL:
+ *   - the agent's reasoning + tool calls render as a tidy, claude.ai-style
+ *     collapsible activity feed (#v2-plan-activity), fed by the AGENT_ACTIVITY
+ *     event that agent-chat.js mirrors off the /ws/agent stream;
+ *   - the agent's ask_user_choice questions render as button cards
+ *     (#v2-plan-ask) via AgentChat.buildAskCard;
+ *   - "THE PLAN" panel (#v2-plan-summary) mirrors the REAL plan (phases→tasks)
+ *     fetched from /api/campaigns once a turn settles.
+ * Chat is the last resort (the escape pill / "Open conversation").
  *
  * No-ops unless #v2-landing is present (flag off → v1 untouched, overlay absent).
  */
 const V2Landing = (() => {
     let el = null;
-    let current = null;  // { reqId, data, isWake } — the ask showing in the plan stage
+    let current = null;            // the ask currently in #v2-plan-ask
+    let feedTextEl = null;         // current accumulating prose paragraph in the feed
+    let runningTools = {};         // tool name -> stack of running card elements
+    let feedHadContent = false;    // did this turn surface anything in the feed?
+    let capturedCampaignId = null; // best-effort id scraped from tool results
 
     const $ = (id) => document.getElementById(id);
 
@@ -50,32 +53,255 @@ const V2Landing = (() => {
         setTimeout(finish, 650);
     }
 
-    // ── plan stage helpers ────────────────────────────────────────────
-    function showThinking(on) {
-        const t = $('v2-plan-thinking');
-        if (t) t.classList.toggle('hidden', !on);
+    // ── status / error helpers ────────────────────────────────────────
+    function showThinking(on) { const t = $('v2-plan-thinking'); if (t) t.classList.toggle('hidden', !on); }
+    function errorVisible() { const e = $('v2-plan-error'); return !!e && !e.classList.contains('hidden'); }
+    function showPlanError(msg) {
+        const e = $('v2-plan-error'); if (!e) return;
+        e.textContent = msg; e.classList.remove('hidden');
+        showThinking(false);
     }
+    function hidePlanError() { const e = $('v2-plan-error'); if (e) e.classList.add('hidden'); }
+
     function clearAsk() { const m = $('v2-plan-ask'); if (m) m.innerHTML = ''; }
     function resetSummary() {
         const list = $('v2-plan-summary');
-        if (list) list.innerHTML = '<div class="v2-plan-side-empty">Assembling from your choices…</div>';
+        if (list) list.innerHTML = '<div class="v2-plan-side-empty">The plan will take shape here as Gently designs it.</div>';
+    }
+
+    // ── activity feed (claude.ai-style collapsible tool cards) ─────────
+    function feedEl() { return $('v2-plan-activity'); }
+    function clearActivity() {
+        const f = feedEl(); if (f) f.innerHTML = '';
+        feedTextEl = null; runningTools = {}; feedHadContent = false;
+        capturedCampaignId = null;
+        hidePlanError();
+    }
+    function scrollFeedIfNearBottom() {
+        const m = document.querySelector('.v2-screen-plan .v2-plan-main');
+        if (m && (m.scrollHeight - m.scrollTop - m.clientHeight) < 140) m.scrollTop = m.scrollHeight;
+    }
+    function clearFallback() { feedEl()?.querySelectorAll('.v2-plan-fallback').forEach(n => n.remove()); }
+
+    // Render the agent's prose like the chat does (reuses AgentChat.mdToHtml —
+    // escapes then renders bold/italic/code/line-breaks), so the feed isn't raw
+    // markdown. Falls back to escaped text if the helper isn't available.
+    function renderMd(s) {
+        if (typeof AgentChat !== 'undefined' && AgentChat.mdToHtml) return AgentChat.mdToHtml(s);
+        const esc = (typeof escapeHtml === 'function') ? escapeHtml(String(s)) : String(s);
+        return esc.replace(/\n/g, '<br>');
+    }
+
+    // Plan-writing tools → refresh THE PLAN panel during the turn (debounced),
+    // not only at turn_end (ask_user_choice pauses the turn before it ends).
+    const PLAN_TOOLS = new Set([
+        'create_campaign', 'create_plan_item', 'link_plan_items', 'update_plan_item',
+        'delete_plan_item', 'propose_plan', 'get_plan_status', 'validate_plan',
+    ]);
+    let planRefreshTimer = null;
+    function schedulePlanRefresh() {
+        if (planRefreshTimer) clearTimeout(planRefreshTimer);
+        planRefreshTimer = setTimeout(() => { planRefreshTimer = null; refreshPlanPanel(); }, 600);
+    }
+
+    function safeStringify(v) {
+        try {
+            const s = (typeof v === 'string') ? v : JSON.stringify(v, null, 2);
+            return s.length > 4000 ? s.slice(0, 4000) + '\n…' : s;
+        } catch (e) { return String(v); }
+    }
+    function fillToolBody(body, act) {
+        body.innerHTML = '';
+        // grid-template-rows reveal (landing.css) needs ONE collapsible child —
+        // append blocks into a single inner wrapper, not directly onto body.
+        const inner = document.createElement('div');
+        body.appendChild(inner);
+        const inputStr = (act.input != null) ? safeStringify(act.input) : '';
+        const full = act.full || act.summary || '';
+        const block = (label, text) => {
+            const l = document.createElement('div'); l.className = 'v2-act-block-label'; l.textContent = label;
+            const b = document.createElement('pre'); b.className = 'v2-act-block'; b.textContent = text;
+            inner.append(l, b);
+        };
+        if (inputStr) block('input', inputStr);
+        if (full) block('result', full);
+        if (!inputStr && !full) {
+            const e = document.createElement('div'); e.className = 'v2-act-block-label'; e.textContent = 'no details';
+            inner.append(e);
+        }
     }
+    function buildToolCard(act, done) {
+        const card = document.createElement('div');
+        card.className = 'v2-act-tool' + (done ? (act.is_error ? ' done err' : ' done') : '');
+        const head = document.createElement('button');
+        head.className = 'v2-act-tool-head'; head.type = 'button';
+        head.setAttribute('aria-expanded', 'false');
+        const ic = document.createElement('span'); ic.className = 'v2-act-ic';
+        ic.innerHTML = done ? (act.is_error ? '⚠' : '✓') : '<span class="v2-act-spin"></span>';
+        const label = document.createElement('span'); label.className = 'v2-act-label';
+        label.textContent = act.label || act.name || 'tool';
+        const sum = document.createElement('span'); sum.className = 'v2-act-summary';
+        sum.textContent = done ? (act.summary || '') : '';
+        const chev = document.createElement('span'); chev.className = 'v2-act-chev'; chev.textContent = '›';
+        head.append(ic, label, sum, chev);
+        const body = document.createElement('div'); body.className = 'v2-act-tool-body';
+        fillToolBody(body, act);
+        head.addEventListener('click', () => {
+            const open = card.classList.toggle('open');
+            head.setAttribute('aria-expanded', open ? 'true' : 'false');
+        });
+        card.append(head, body);
+        return card;
+    }
+    function updateToolCard(card, act) {
+        card.classList.add('done');
+        if (act.is_error) card.classList.add('err');
+        const ic = card.querySelector('.v2-act-ic'); if (ic) ic.textContent = act.is_error ? '⚠' : '✓';
+        const sum = card.querySelector('.v2-act-summary'); if (sum) sum.textContent = act.summary || '';
+        const body = card.querySelector('.v2-act-tool-body'); if (body) fillToolBody(body, act);
+    }
+    function captureCampaignId(text) {
+        if (!text) return;
+        const s = String(text);
+        const m = s.match(/campaign_id[=:\s]+([0-9a-f]{6,})/i) || s.match(/\(id:\s*([0-9a-f]{6,})/i);
+        if (m) capturedCampaignId = m[1];
+    }
+
+    function applyActivity(act) {
+        if (!planActive() || !act) return;
+        const f = feedEl(); if (!f) return;
+        switch (act.kind) {
+            case 'turn_start':
+                feedTextEl = null; hidePlanError(); clearFallback(); showThinking(true);
+                break;
+            case 'thinking':
+                showThinking(true);
+                break;
+            case 'text': {
+                const chunk = act.text || '';
+                if (!chunk) break;
+                if (!feedTextEl) {
+                    feedTextEl = document.createElement('div');
+                    feedTextEl.className = 'v2-act-text';
+                    feedTextEl._raw = '';
+                    f.appendChild(feedTextEl);
+                }
+                feedTextEl._raw += chunk;
+                feedTextEl.innerHTML = renderMd(feedTextEl._raw);
+                feedHadContent = true; showThinking(true); scrollFeedIfNearBottom();
+                break;
+            }
+            case 'tool_start': {
+                // ask_user_choice IS the active question (rendered separately in
+                // #v2-plan-ask) — don't also show it as a feed card.
+                if (act.name === 'ask_user_choice') break;
+                feedTextEl = null;
+                const card = buildToolCard(act, false);
+                f.appendChild(card);
+                (runningTools[act.name] = runningTools[act.name] || []).push(card);
+                feedHadContent = true; showThinking(true); scrollFeedIfNearBottom();
+                break;
+            }
+            case 'tool_result': {
+                captureCampaignId(act.summary);
+                captureCampaignId(act.full);
+                if (PLAN_TOOLS.has(act.name)) schedulePlanRefresh();
+                if (act.name === 'ask_user_choice') break;
+                feedTextEl = null;
+                const arr = runningTools[act.name] || [];
+                const card = arr.pop();
+                if (card) updateToolCard(card, act);
+                else f.appendChild(buildToolCard(act, true));
+                feedHadContent = true; scrollFeedIfNearBottom();
+                break;
+            }
+            case 'turn_end':
+                showThinking(false); feedTextEl = null;
+                refreshPlanPanel();
+                if (!current && !feedHadContent) showFallback();
+                break;
+            case 'turn_error':
+                showPlanError(act.error || 'Something went wrong — open the conversation for detail.');
+                break;
+        }
+    }
+
+    function showFallback() {
+        const f = feedEl(); if (!f || f.querySelector('.v2-plan-fallback')) return;
+        const d = document.createElement('div');
+        d.className = 'v2-plan-fallback';
+        d.innerHTML = 'Gently replied in prose — <a>open the conversation</a> to read it.';
+        d.querySelector('a').addEventListener('click', openChat);
+        f.appendChild(d);
+    }
+
+    // ── THE PLAN panel: mirror the real campaign tree ──────────────────
+    async function refreshPlanPanel() {
+        try {
+            let tree = null;
+            if (capturedCampaignId) {
+                const r = await fetch(`/api/campaigns/${encodeURIComponent(capturedCampaignId)}/tree`);
+                if (r.ok) tree = await r.json();
+            }
+            if (!tree) {
+                const r = await fetch('/api/campaigns');
+                if (r.ok) { const d = await r.json(); tree = (d.campaigns || [])[0] || null; }
+            }
+            if (tree) renderPlanTree(tree);
+        } catch (e) { /* keep whatever is shown */ }
+    }
+    function planName(c) {
+        c = c || {};
+        return c.shorthand || c.display_name || c.description || 'Plan';
+    }
+    function renderPlanTree(tree) {
+        const list = $('v2-plan-summary');
+        if (!list || !tree) return;
+        const phases = tree.children || [];
+        const rootItems = tree.items || [];
+        if (!phases.length && !rootItems.length) return;  // nothing to show yet — keep placeholder
+        list.innerHTML = '';
+        const title = document.createElement('div');
+        title.className = 'v2-plan-title-row';
+        title.textContent = planName(tree.campaign);
+        list.appendChild(title);
+        const addTask = (parent, it) => {
+            const t = document.createElement('div');
+            t.className = 'v2-plan-task';
+            t.textContent = it.title || it.shorthand || '(task)';
+            parent.appendChild(t);
+        };
+        rootItems.forEach(it => addTask(list, it));
+        phases.forEach(phase => {
+            if (!phase) return;
+            const wrap = document.createElement('div');
+            wrap.className = 'v2-plan-phase';
+            const h = document.createElement('div');
+            h.className = 'v2-plan-phase-h';
+            h.textContent = planName(phase.campaign);
+            wrap.appendChild(h);
+            (phase.items || []).forEach(it => addTask(wrap, it));
+            list.appendChild(wrap);
+        });
+    }
+
+    // ── ask rendering (the active question) ────────────────────────────
     function labelFor(data, sel) {
         const opts = (data && data.options) || [];
         const one = (s) => {
             const o = opts.find(o => o && (o.id === s || o.value === s || o.label === s));
             return o ? o.label : String(s);
         };
-        if (Array.isArray(sel)) return sel.map(one).join(', ');
-        return one(sel);
+        return Array.isArray(sel) ? sel.map(one).join(', ') : one(sel);
     }
     function recordPick(data, sel) {
         const list = $('v2-plan-summary');
         if (!list) return;
         const empty = list.querySelector('.v2-plan-side-empty');
         if (empty) empty.remove();
+        const matched = (data && data.options || []).some(o => o && (o.id === sel || o.value === sel || o.label === sel));
         const row = document.createElement('div');
-        row.className = 'v2-plan-row';
+        row.className = 'v2-plan-row' + (matched ? '' : ' v2-plan-row-freetext');
         row.innerHTML = '<span class="k"></span><span class="v"></span>';
         row.querySelector('.k').textContent = (data && data.question) || 'Choice';
         row.querySelector('.v').textContent = labelFor(data, sel);
@@ -84,7 +310,7 @@ const V2Landing = (() => {
     function renderAsk() {
         const mount = $('v2-plan-ask');
         if (!mount || !current || typeof AgentChat === 'undefined' || !AgentChat.buildAskCard) return;
-        showThinking(false);
+        showThinking(false); hidePlanError(); clearFallback();
         const data = current.data, reqId = current.reqId;
         const hasControl = AgentChat.hasControl ? AgentChat.hasControl() : true;
         const card = AgentChat.buildAskCard(data, {
@@ -92,39 +318,104 @@ const V2Landing = (() => {
             onPick: (sel) => {
                 recordPick(data, sel);
                 AgentChat.answerChoice(reqId, sel);
-                current = null;
-                clearAsk();
-                showThinking(true);  // agent computing the next step
+                current = null; clearAsk(); showThinking(true);
             },
         });
         mount.innerHTML = '';
         mount.appendChild(card);
+        const first = mount.querySelector('button:not([disabled])');
+        if (first) setTimeout(() => first.focus(), 30);
     }
 
-    function startPlan() {
-        setScreen('plan');     // stay on the overlay; swap welcome → plan wizard
-        resetSummary();
-        clearAsk();
+    let planKickedOff = false;   // guard: design-kickoff fires once per session
+    async function startPlan() {
+        setScreen('plan');
+        // Re-entering the wizard (Back → Plan again) must NOT re-fire the
+        // kickoff — that stacked duplicate "/plan" + design turns. Just show
+        // the wizard with its existing state.
+        if (planKickedOff) return;
+        planKickedOff = true;
+        resetSummary(); clearAsk(); clearActivity();
         current = null;
         showThinking(true);
-        // /plan deterministically enters plan mode; the kickoff draws out the
-        // first question, which the agent asks via ask_user_choice (its prompt
-        // mandates it) → renders here, not in chat. runCommand connects on its
-        // own and flushes both in order without opening the chat panel.
-        if (typeof AgentChat !== 'undefined' && AgentChat.runCommand) {
-            AgentChat.runCommand('/plan');
+        // Campaigns are persistent agent memory (not session state), so the
+        // agent always builds on an existing one — which leaves a user wanting a
+        // fresh plan stuck. So if an active campaign exists, ask up front:
+        // continue it (the default) or start a brand-new one. With NO campaign
+        // there's nothing to continue, so skip the gate and design straight away
+        // (that path is fresh anyway).
+        let campaign = null;
+        try {
+            const r = await fetch('/api/campaigns');
+            if (r.ok) { const d = await r.json(); campaign = (d.campaigns || [])[0] || null; }
+        } catch (e) { /* offline / no API — just design */ }
+        if (campaign) renderCampaignChoice(campaign);
+        else kickoffDesign('continue');
+    }
+
+    // Enter plan mode, then prompt design. The prompt differs by intent: build
+    // on the active campaign, or set it aside and create a new one. A free-typed
+    // answer from the choice card becomes the design brief directly.
+    function kickoffDesign(mode) {
+        showThinking(true);
+        if (typeof AgentChat === 'undefined' || !AgentChat.runCommand) return;
+        AgentChat.runCommand('/plan');
+        if (mode === 'fresh') {
+            AgentChat.runCommand(
+                "I want to start a brand-new experiment, not continue any existing " +
+                "campaign. Create a new campaign and let's design it from scratch — " +
+                "what should we capture?"
+            );
+        } else if (mode === 'continue') {
             AgentChat.runCommand("Let's design this run — what should it capture?");
+        } else {
+            // free text from the choice card's "Something else…" escape
+            AgentChat.runCommand(String(mode));
         }
     }
 
+    // Continue-vs-fresh gate, shown only when an active campaign exists. Reuses
+    // the agent ask-card styling so it's visually identical to the agent's own
+    // questions; picking routes into kickoffDesign rather than the agent bridge.
+    function renderCampaignChoice(tree) {
+        const mount = $('v2-plan-ask');
+        if (!mount || typeof AgentChat === 'undefined' || !AgentChat.buildAskCard) {
+            kickoffDesign('continue');
+            return;
+        }
+        showThinking(false); hidePlanError(); clearFallback();
+        const name = planName((tree && tree.campaign) || {});
+        const data = {
+            question: `You have an active campaign — **${name}**. Design the next run inside it, or start something new?`,
+            options: [
+                { id: 'continue', label: `Continue ${name}`, description: 'Design the next run inside your existing campaign' },
+                { id: 'fresh', label: 'Start a brand-new campaign', description: 'Set the existing plan aside and plan from scratch' },
+            ],
+        };
+        const hasControl = AgentChat.hasControl ? AgentChat.hasControl() : true;
+        const card = AgentChat.buildAskCard(data, {
+            reqId: 'landing-campaign-choice', isWake: false, hasControl,
+            onPick: (sel) => { clearAsk(); kickoffDesign(sel); },
+        });
+        mount.innerHTML = '';
+        mount.appendChild(card);
+        const first = mount.querySelector('button:not([disabled])');
+        if (first) setTimeout(() => first.focus(), 30);
+    }
+
     function openScope() {
         dismiss();
         if (typeof switchTab === 'function') switchTab('devices');
     }
-
+    function openChat() {
+        dismiss();
+        if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
+            setTimeout(() => AgentChat.togglePanel(true), 300);
+        }
+    }
     function sendFreeform(text) {
         const v = (text || '').trim();
-        dismiss();  // free-text is the chat last-resort → recede, then open chat
+        dismiss();
         if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
             AgentChat.togglePanel(true);
             if (v && AgentChat.runCommand) setTimeout(() => AgentChat.runCommand(v), 300);
@@ -136,47 +427,40 @@ const V2Landing = (() => {
         if (!el || typeof ClientEventBus === 'undefined') return;  // flag off → no-op
         greet();
 
-        // welcome choices
         el.querySelectorAll('[data-landing]').forEach(btn => btn.addEventListener('click', () => {
             const kind = btn.dataset.landing;
             if (kind === 'plan') startPlan();
             else if (kind === 'standalone') openScope();
         }));
 
-        // welcome escape field
         const esc = $('v2-escape'), escToggle = $('v2-escape-toggle'),
             escInput = $('v2-escape-input'), escSend = $('v2-escape-send');
         if (escToggle && esc && escInput) {
             escToggle.addEventListener('click', () => {
                 const open = esc.classList.toggle('open');
+                escToggle.setAttribute('aria-expanded', open ? 'true' : 'false');
                 if (open) setTimeout(() => escInput.focus(), 120);
             });
             const submit = () => sendFreeform(escInput.value);
             if (escSend) escSend.addEventListener('click', submit);
             escInput.addEventListener('keydown', e => {
                 if (e.key === 'Enter') { e.preventDefault(); submit(); }
-                else if (e.key === 'Escape') { e.stopPropagation(); esc.classList.remove('open'); }
+                else if (e.key === 'Escape') { e.stopPropagation(); esc.classList.remove('open'); escToggle.setAttribute('aria-expanded', 'false'); }
             });
         }
 
         const skip = $('v2-landing-skip');
         if (skip) skip.addEventListener('click', dismiss);
 
-        // plan-screen controls
         const back = $('v2-plan-back');
         if (back) back.addEventListener('click', () => setScreen('welcome'));
         const planChat = $('v2-plan-chat');
-        if (planChat) planChat.addEventListener('click', () => {
-            dismiss();  // chat panel lives under the overlay → recede first
-            if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
-                setTimeout(() => AgentChat.togglePanel(true), 300);
-            }
-        });
+        if (planChat) planChat.addEventListener('click', openChat);
         const cont = $('v2-plan-continue');
         if (cont) cont.addEventListener('click', dismiss);
 
-        // The agent's questions render in the plan stage while it's active; once
-        // we've receded into the workspace, AskStage (#ask-stage) takes over.
+        // The agent's questions + work render in the plan stage while it's active;
+        // once we've receded into the workspace, AskStage (#ask-stage) takes over.
         ClientEventBus.on('AGENT_ASK', ({ request_id, choice_data, origin }) => {
             if (!planActive()) return;
             current = { reqId: request_id, data: choice_data || {}, isWake: origin === 'wake' };
@@ -184,12 +468,12 @@ const V2Landing = (() => {
         });
         ClientEventBus.on('ASK_CLEARED', ({ request_id }) => {
             if (request_id === '*' || (current && request_id === current.reqId)) {
-                current = null;
-                clearAsk();
-                if (planActive()) showThinking(true);
+                current = null; clearAsk();
+                if (planActive() && !errorVisible()) showThinking(true);
             }
         });
         ClientEventBus.on('AGENT_CONTROL', () => { if (current && planActive()) renderAsk(); });
+        ClientEventBus.on('AGENT_ACTIVITY', (act) => applyActivity(act));
 
         document.addEventListener('keydown', e => {
             if (e.key !== 'Escape' || !el || el.classList.contains('dismissed')) return;
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index c972dc3d..36688f8a 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -53,7 +53,7 @@ <h3>Take a quick look</h3>
           </div>
 
           <div class="v2-escape v2-landing-rise" data-i="3" id="v2-escape">
-            <button class="v2-escape-toggle" id="v2-escape-toggle">
+            <button class="v2-escape-toggle" id="v2-escape-toggle" aria-expanded="false">
               <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2Z"/></svg>
               or just tell me what you need
               <span class="v2-escape-caret"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 9l6 6 6-6"/></svg></span>
@@ -81,19 +81,22 @@ <h3>Take a quick look</h3>
           </div>
           <div class="v2-plan-wrap">
             <div class="v2-plan-main">
+              <div class="v2-plan-activity" id="v2-plan-activity"></div>
               <div class="v2-plan-ask" id="v2-plan-ask" aria-live="polite"></div>
               <div class="v2-plan-thinking" id="v2-plan-thinking"><span class="v2-typing"><i></i><i></i><i></i></span> thinking through the next step…</div>
+              <div class="v2-plan-error hidden" id="v2-plan-error" role="alert"></div>
             </div>
             <aside class="v2-plan-side">
               <div class="v2-plan-side-h">The plan</div>
               <div class="v2-plan-side-list" id="v2-plan-summary">
-                <div class="v2-plan-side-empty">Assembling from your choices…</div>
+                <div class="v2-plan-side-empty">The plan will take shape here as Gently designs it.</div>
               </div>
             </aside>
           </div>
           <div class="v2-plan-foot">
             <button class="v2-plan-chat" id="v2-plan-chat">Open conversation</button>
-            <button class="v2-plan-continue" id="v2-plan-continue">Continue in workspace ›</button>
+            <span class="v2-plan-foot-spacer"></span>
+            <button class="v2-plan-skip" id="v2-plan-continue">Continue in workspace ›</button>
           </div>
         </section>
 

From 1cefe2ffc51cfa44b954c00f5da0c8fb56dc89ed Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 13:18:53 +0530
Subject: [PATCH 101/314] UX v2: agent-activity events + GFM markdown rendering
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

agent-chat.js mirrors the agent stream onto a new AGENT_ACTIVITY event (turn/thinking/text/tool_start/tool_result/turn_end/error) so the plan wizard can render the agent's work as collapsible tool cards instead of leaving it in the chat. Replaces the inline-only mdToHtml with a block-aware, escape-first GFM renderer (headings, pipe tables, lists, fenced code, links — XSS-safe and streaming-safe) and exports it; agent-chat.css styles the ac-md-* output for both the chat and the wizard feed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/ui/web/static/css/agent-chat.css |  39 ++++++++++++++++++++++++
 gently/ui/web/static/js/agent-chat.js   | Bin 51841 -> 63820 bytes
 2 files changed, 39 insertions(+)

diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index fdaaa8e3..29d64646 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -441,3 +441,42 @@ body.chat-docked .agent-chat:not(.open) {
     color: var(--text-muted); cursor: pointer; font-size: 12px; line-height: 1;
 }
 .ac-queue-remove:hover { color: var(--color-danger, #f87171); }
+
+/* ── Rendered markdown (mdToHtml output, ac-md-* classes) ──────────────────
+   Shared by the chat transcript and the ux_v2 plan-wizard activity feed — the
+   same renderer feeds both, so these styles cover headings, lists, tables,
+   code blocks, quotes and links the agent emits. */
+.ac-md { line-height: 1.55; }
+.ac-md > :first-child { margin-top: 0; }
+.ac-md > :last-child { margin-bottom: 0; }
+.ac-md-h1, .ac-md-h2, .ac-md-h3, .ac-md-h4, .ac-md-h5, .ac-md-h6 {
+    margin: 14px 0 6px; font-weight: 650; line-height: 1.3; letter-spacing: -.01em; color: var(--text);
+}
+.ac-md-h1 { font-size: 1.25em; }
+.ac-md-h2 { font-size: 1.15em; }
+.ac-md-h3 { font-size: 1.05em; }
+.ac-md-h4, .ac-md-h5, .ac-md-h6 { font-size: 1em; }
+.ac-md-p { margin: 7px 0; }
+.ac-md-ul, .ac-md-ol { margin: 7px 0; padding-left: 22px; }
+.ac-md-li { margin: 3px 0; }
+.ac-md-quote {
+    margin: 8px 0; padding: 4px 12px; border-left: 3px solid var(--border, #e4e9f0);
+    color: var(--text-muted); font-style: italic;
+}
+.ac-md-hr { border: 0; border-top: 1px solid var(--border, #e4e9f0); margin: 12px 0; }
+.ac-md-link { color: var(--accent, #2f6df6); text-decoration: underline; text-underline-offset: 2px; }
+.ac-md-pre {
+    margin: 8px 0; padding: 10px 12px; border-radius: 8px; overflow-x: auto;
+    background: var(--bg, #f6f8fb); border: 1px solid var(--border, #e4e9f0);
+}
+.ac-md-pre .ac-md-code-block, .ac-md-pre code {
+    font-family: 'JetBrains Mono', ui-monospace, monospace; font-size: 12px;
+    color: var(--text); background: none; padding: 0; white-space: pre;
+}
+/* GFM tables — wrapped so a wide table scrolls instead of blowing out the column */
+.ac-md-table-wrap { margin: 9px 0; overflow-x: auto; border: 1px solid var(--border, #e4e9f0); border-radius: 8px; }
+.ac-md-table { border-collapse: collapse; width: 100%; font-size: 12.5px; }
+.ac-md-table th, .ac-md-table td { padding: 6px 10px; text-align: left; border-bottom: 1px solid var(--border, #e4e9f0); border-right: 1px solid var(--border, #e4e9f0); }
+.ac-md-table th:last-child, .ac-md-table td:last-child { border-right: 0; }
+.ac-md-table tr:last-child td { border-bottom: 0; }
+.ac-md-table thead th { background: var(--bg, #f6f8fb); font-weight: 650; color: var(--text); }
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 33dcf2b37908d8f5cf612d0a59c73cde286e66cd..0e8514df3e603df1220675ba2cff1c2ce566e7d4 100644
GIT binary patch
delta 10374
zcmbVS+ix3JdXJkp7srj0wd~m2q&|`rb4KKllAJm)bunbwv5oo`+X<Q#WokHcNRBm}
zVdkPsESbqmfkm)Icc<OwHL$@xZIOl1mjVm4DA0#ui*z6Q(xSjNf5E0e-}=zs_njGX
zNXbD`J&5F)bH4li%%^|->~H@2*)MLroP1e->G%yZShxL6Pki;~KM|qXl;Y~W8`qN`
z|FD((Zt`HSQV|zj-&!}!O*4?<%DXp27&k&0RYhBxw&S(JlIS{JDI&AsO8jU_&yse<
z@oecu(iWC)%hDl%Kfv+>TLyR<d+9gfI$?xU4MOr!>_-Hm9RQ{on602^cH7~ca6H%X
zq-gjq07s_lSd|Q77zNI{tPqw8Hm!$caY=?w%LD4BABem6?p$8FaqZ@ns<2Gg#cCkC
z(gbDhw(vb+idNunf{zSfH;_$dt0Y2SI8je@;xH1P+>n8Y+SmyeMBDUQbQUy5j_HED
zZX5}%ZMsdsV?mUJ>17aO&vN~c=poVIiLe0x#J0rL6v125%VNoOMI^T(;e<klmf6Mr
zhD`qcz;iu-+7=z?Deh(<vB|V;Z29VwzY?A=0&|n~29m;%=!{!!er9?$MC`3Yrm~4c
z&|zq`Wk(wLZ>>waoPx|C6CHtU$t|gNyH3xOW*{_R@ni_ORZRPVX+gOn_8NW+J=@}=
z*z_W&>Bt}yzLJ&9Ackf~3d;pyx`=#XZukzY!i-F)&hNGzOEgStJqqxTL_#{T0U|U5
zl5OPod{_8!1QCzY%9g1>3lCUAp^?hNXq$wqSA}UA9b0Idf!XcKK!@mQ!D!Ev%jvgs
zebZD6-E2?nX5WB6`|3K`H#XJm2kbRtHiZ(9ni&@vroq;ot+0I<MAOhp_Jg!lK9s?O
zDZmHh)u`iYdTJP<I3wo8qG-VAJU@c)$!+G;r=g68ZQqRG9M~mA97-j;CX6w1AY*J>
z!eb3edC17fLjxJb0YA%dhI+XNhjF2Btuj$*l|<nT;hQVy<^Fm>t)D)79?NqKZMV+>
z42rzQgS&BfVQW-22w%M;A4n?_56lfSv;wCaRVy}3qgvT$q`yUvY#1((iNx|f7>+Bf
zwh3!9VJ=Yw+ku02oK_oF86p_@BJ9MimMh_H3K_XZ1RsVilI3T%1PWX;ayF!R|IT$7
z5X@Zd*8$oVr%kVCwS7Va*FgaBH#48<i;~#73is0Bg?VWr-ra=)x?<_>^0jLSgn7D)
zVzcc)ZCyxKXbwU|nIcEUlbeu`B<$OpZ3IivbG*KS0FpQWsT7~^bsL`K6(WQR;@c+1
z8-X;}d0Waj^NSszU2#pS1~m{z9JpeEsq|VzzS!9jg}iE4YFoYOX`{9^J6+p)r@6|S
z&Xi1WK+#erVMHZYMiG3sVmmD-3M<8mQ7OX~mE1&QTNJ7VkODV_G!fP+;(|CmN>v9m
zfwFSPjI6d+uH4sFOylDv;|Hth=d^LYSgskXQ+l<M8XVE$G=<hle)rz%hdIOnN@rze
zH94^U#w~i3ier3XK@{3i)GdfJXEM_Ji{YNtj_J6OU(hq}@M70ZzCJkyzhG|xrK2`~
zP30>n*F!o(@Npfbo2Bc>MwdP`F5g{Vx_$W)NBpw5MOhIMo<)Z|g^(fmY-aLgdtIOf
z5JW=JbOPwEr?FeMkrXMX>ZwII0b3g4Gutc~M<9)E;9D|;h4dp8jK|~D01ElL>~z~^
z=)fs2?i1D5rR-uKsTk&I21e9#I-^0QV=K<JG=t^6K^YwJ7D6#At4e0639Zrk8hhND
z`o5N?HqU4UQrg=k7&?MD(svB9rPqpn&@NHxOC2U07!hnx5RR0HL7dXo9?q0zcXe&$
z{#wmjeK=kElj-T*3wmva%v!6LL_Go?-%h^%`PdOAwcL%vwnkr*SJsc8E<Ce*>(b?d
zC<<N+%S=gI7-B}pV&R#>Tw;zNqq1qmHQ{or8YNzxnc)Q#4<V7=pnNB(^q~#3!l59n
zps0`@qIsHH2W$~b;eeUi3fQQvDn4exhmIc_)-=5)!i+h+rZaDyl3?@-ou2&o(g};h
zF<@rlizywbCG)6p+R(RthBC)~ZzFvpyapV?p&5$oCBcRQ-)GxSUR@vS73NKqq!%Vs
zPNa<!%=f|s$+Dk|7*Vkw?T7;UD@-6X1}zyaOw=2$NrwaJE=+j7-<2L*2i2r(${^sc
zD%wme5@e$GWtTKFUojU4%DD)qDWSfjQWB*e*N|!1R2G*_tBq_y-sn*|h75vo0;wdc
zc3^@}SIbmw3QCwFz073xg*6VG^HlOAw-0~+^oTO+b)2c^&(!P5yN4%xBm1=bJAl2a
z?}vjiOwP>9&f?_kd<7r*IK3aBdTn!6--}thFup=h0I(+t-xlJdM_}Pmo`pw`6w|hJ
z7XhV0pLvqtBzI6zQYs(^Qz1{lJ&?d$F;8o~MIl{Os|aRKl{mYkR<n!xGlY-a*wMwp
zB6Ln5*beARxKeahl_{w8T;@nac{m!#dv_7KBUk`6K3up7>H!=Nc{U9%z{b(ufZK8)
z7M65fMA56LAJ7qH`?6S0%@XR2+KwtP(5XNG@D`+XS9Mes)WQyYq$L_XZj-pdN(Iob
zI+&VeLZwke-Y3-3vyo6sp|KG+v05k$Je`VWjUG98FpYK#<t4!^yN4*ywy{zyCVzS5
zI7%VxphqiCE`XDdQi7$Ylw4~yPNHfbBtEmM)_0IZA2R+TcI^}x?i`el-ocCIoY)<5
z{X9r@bY6*;V=~y#5hXKbo(hF_0G-uF&OX*-)eO$}@xc}^Q8+^qjJAceTd+x%9}=e>
zqoJkRWv_nrsHZOqMwDg;lo<?cWxBUoMy%<elxIOf9*U!|?KC4TXOPVMzA)5*LEd=^
z#IE1X!%Gdkr%rdwu4a*oj3jJsGpv+EUEf>Fr#=8rb~>nD1M-Hd*f9)ar)n5ge5vjT
zO;P|QOsecR1UfO)(nxT?kBs-#4?mv~hORuiZ_rM7k46ZWoDBzl^c16xQu|A39Hhhh
zwVj>X&Ll^ie2^hQjz?MgN<Oz<J(tQNDu?9U8Vpe{Q-i;)WKy|b3#Y0VjAHcyzD!oi
zsL~_NN<QtLOn&k5iJmHC!T<uyDrauoVfj=VqM$7lz%i}m6sk^<OK>C(tPFe2%ag0N
zQIR)XBMrQ>r#dS#G#Kq|9+O~7LY{yWNYx|iM6^@{Nm?<tHZWo|MT{H+8W$xEx7ljy
zlJ^15aAvSw7I*z-#3u~yCqhKI5PA{jRT_I>G{ZQh<)gWuZv=~j@JyuAmJtpVXN;VP
z77NMDKO9Rwxqa|C+MJAkb~5>o+M!;<x3_VU)=>X<HS{O@o2d)?EI;raPb(1qybwt?
z5TUBw3iI9J>Z7Yl14hJ!K{t2!Z8|IVqkng9Ab7NHC<nAGPA32I;E#`xbU`=^8PPHM
zZEY<1-`1fXEu_|(gFr~2zIS<823<k2JS3=!wY4>x2|arBNN9eSdUYg26g{ojY)K4?
z-p5oe=r|sYu==V?!SR3z$))4i21*TSc65ymA%>PHWqG#YHw`tf;?WTgwrHMJPG0LA
zU1k8_f`U{Bjjrmz(15KyJX_k`c|`wptvsbq=KC(fPJYIx6Z7%dp}v~6WajOYV>G-%
zuvkzNF!W?A)2qp^PMtUbKCYt;89Yb}YI>*>(|6F5W>06cP?x$+r4|+|I)VEA8z+-b
z&K{hn6WE>}90Z4z`>KCL-&il!jB?h-mP6EkQkyP`v$I6#1y;nc=Mi)ChZH!-m}*H-
z4?koGyZ`t`@-ySP<khp!zhY5qoteX2GJftDE&riK-7UI(&I8G(=U-2z|K_=6toT%A
zDhX9lltW{w*l5s!@|{yL#ZEz0FZNRVgN_V`q>K3uVOZn5(Sb}j!K46?e@0Z84{RNs
z`e3Uw5EtY+S;3?SaWTcZh*p|aMcM_22VY1f!fX-8)3ZmD^0^n2FOBb!1P+rV)8@$~
zE}x|m;@8Goq^C2apk<l}rplt2*|%{+74BZ^C*t*cc{ipykq%{T1SYi;i(KOkuM=uD
za?2noTyS=FeWJOfsyCJJh*T9xC>V1iH_sF0#rX=5EGGZ8c&wKdDMLP&j=3^(fJa{h
zZ|kh~YCcd>M@?~c=rk!S^|XFH@KD8P3X#a)Y<1+p(c4*tGz0+%m+t*pHj1xelu|y;
ze`>NoK7D~owmtrQ8qLW$w2Wa9-i!`7oH~tEm&;eg64BS*$Divi!UkD)8?Kz1$X?&b
zsjkh6;6qTtu(pPu^%YdvuQX||%&uno89uj|95^+`HukGi$F8Vya!68pHFebwoR1+{
zgx4T;WmTYxDPbZ%g)u<AF0`}7<kNpT`W8IL;NVxA;*UDVz^p7t1)HorKK4>S=q0}|
zjGfA}kC9B?aNEJe5WT%`MQ^_aK{dr1SLN5xbPZPv`O=K$s~^P<90%>ikT_sCgPlF3
z2G|(JN*(mX1?qTJucKkeXbRUyX5%{^&T(O6Zij+P3SCW;a^{bKh}zF|agYW91d6Uj
z(rkn>S^-9rhvAjuv6+fqj0S+N9ZdV_9#W<orL9{{uGa+3>x>x+Tn;rDX~WW=$I$xT
zaxz@u&16Ck^U_GVj}MNdtP^y*#VKo~&!RMO8#UH4JerC$weP7;0E7!-R?SPO0-{8m
zf-Vj;kbM2->t!lP?)aOdEn6nsZ%Q>h#T`mD=g4<4Lgg%zbsIF@#oCY{sShzQyy7a4
zv(y_IAu4?5_zzq?7s@AlROv+x3Iv6D+u0a4az4k`90<}%>qAb!OZ14ufe(~$dt*qy
zGo@l1ov8&yXTqQB39DGdof0UZeiD$l*VmMMSFBay7fDR@{Pc7$g8pGN-H7%XF(iWh
zw)aH?!Y;pnHb+APl>GMgamsnG^no!mlxD7fBLk!K+lqdG+(SGbv2w=xIEdhsq2!nE
zok)JU_2NSAA#(tRsHFm9P*1iyGbsA(2PvF{Wgl;Rt4PH6ZhY%hMIRxlT<y>lC+&|#
z0erAE(v+0D5psMV13X-4P*8oXa(}TFUPxOj+DZX*#09T22IxIME6#`?@rJzP?|}`s
zUnTgYBaMM7%g!8TQ1~dSxbn#vI@c`cNuVG`o&PSK31ucki+(%8b-v<l$RT)Xv^N=S
z{!UfMb-GojJVDcPzsWs7)(oO=?<n=8HxEz_q6Ku5UM$dte0Zcr1!K^Oo8^ffE^H=l
z>Jud{IdK7;UE^z%I!mI62IVH&WhzQ>q(2gC;*M<;q-M)*)D|0#NjXN1zR;S`YXd5h
z00P}!co_eKMDnEQD2PNG<WZ7>NO32ubK_Es-5YdS1O<^+2Ym|)8-2x?Dz2(Zhx!)k
z%-;9EVSmj=addunrL5;p4Tlbjt{F-MnH1VSrP9$%Knr4gJllrm=KGOJol5o;^{?;J
z)SwW%$rq<ip0RjzmwT)x=jkT(Lv1aRy8a(YLyz<Q$u~)in-sJz6<oRwI-21V`^hXj
zcbqz&0V{w~6|t*2qEp7f1D&j?NEVCF7naZnXC*X67SHz#Hd!>U>6jG8&D{<;^em~O
z@5y`8oi+|OQ4K)$$ohjMM@L6{mbX}vDmLs_eRjC|%ms$Ya?Y)(#3iNX3S3$uMdlli
ziwX$^5Db=iO6@wsnbUPt6u@(woX2Y|7*M1Q3S~1&EJv`O!}y(o!zI}?V;67m48}t0
zT@lNQJ25;}ssT4e1e(L7vmTx=4L2}6rQvBRY2bUK?E^YK+>`!kzb@WqAi1}2P`s01
zRZEuTZ_Z#({`2s^y;+u+Jucxjh7Bj$)(Uh9TSrkEM1>N@%Vr$;p5O6f#J?sAQJMT~
z>v(ee!pSGUnfl^@@vYBBLEJx@{IvAJ@sX2gyy<-vitaF^7m~GwqfeeUesQ2UvJYcG
zri<o*RnZAsm?z>jA1+N&(w<M=nLYF5-^(97J27(D_uU+8^o~n4c|1M#R(hLP<qIyn
zp28EI6gr*Z-x>5L@65jY;vek;8TSsbgF-2J{Kipoh=Y9uM@A5En}1~IAl|8A4*EDs
z!j1#HKjC}oN%pHmCl*oeVg#{`afbSW;UgxbYNtY8rv=a-)^UC3V|?j^mxJ_mnzXEW
z3Cbf0jX(Lk`sIO9HIVWV8HUvG7xS$@m>l7k_Yn$KMv5%?^&;jqTgRUK&*G1+)1~bV
zhqiDo<TOK9gP5YB%0Y{?j9Yv!y1apZ7vnI!ZWr-ZePfoo8Bc6FADaQa+vIVs13Z-g
zk>4T*)q|PZEQUNtXj~ha-OxdWhU&=g;guE~#|t@|PSl12;20*jzNf}~fEMB%IT_(y
zG23={u1h04@={EQBE$7tDL&4=9=)c93n<(*AQR)YADZ&*d3PlzrPsDK7&NX$VV;3W
zEmHEHb~gFDzkPFoc4>vBE0=HHt1m6zyY|7gdmloMw;J^FP8lN^++t}D1sxZ=DFCwY
fhr75#NLF`FJ^Adje_edBW8d>>;*xy$&)WY1&ggNl

delta 434
zcmX@}iMeqq^9FxzPc1D4-^{$s+{7Fmh2q4tRE6BcqU@CX@;obr)Z*mCf>edH%%b8F
z9fgvN)I5bmg|yUih0MI1%)C^ElA^@C;<Wst++sZiE&a)7W!39*QcDyvN^)})Y@xb6
zfE<mI)QS>KYc2&SfGPk{dPS)PIf==s8u|$u(Qyf}+L{Ua={gGPHp%%Zsdg%cHu_+O
zIw9RLS}|Hc1DLg9wI?qV*Nnkx1y~7Cg=UNv#FErpuoXaxumyP#ElEXolNGCkSwI$S
z{%3YocJhW;_R0HlcqbPGvTZg9-M|PJxDd`h*)}{B#@~D)d@V>)ck`>rFy_r0VtqM)
oJdMq!>E{u83IaJcdu66FZDz^o^_e_>F6U;ST^H;otNm010GiyCBLDyZ


From 64f9338398444cf9a00164bcad5f875daf46e0c3 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 13:19:13 +0530
Subject: [PATCH 102/314] Models: migrate to Fable 5 / Opus 4.8 / Sonnet 4.6
 with refusal+400 fallback
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

settings.py tiers: main→claude-fable-5, perception+medium→claude-opus-4-8, fast→claude-sonnet-4-6, plus a refusal_fallback (claude-opus-4-8).

Strip the params the new models reject: thinking budget_tokens → output_config.effort (conversation.py, sam_detection.py); drop the obsolete interleaved-thinking beta header (agent.py). conversation.py: a main-tier 400 (e.g. Fable 5 under <30-day org data retention) OR a stop_reason='refusal' transparently retries the turn on Opus 4.8 in both the streaming and non-streaming paths; get_tool_call guards empty refusal content; dopaminergic detector guarded. chat.py model centralized to settings.

Quiet log noise: the per-response diagnostic WARNING→DEBUG (it fired on every tool-use turn), and the benign send-after-close websocket WARNING→DEBUG.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 gently/app/agent.py                         | 505 ++++++++------------
 gently/app/detectors/dopaminergic_signal.py |   8 +-
 gently/hardware/dispim/sam_detection.py     | 471 ++++++++----------
 gently/harness/conversation.py              | 458 +++++++++---------
 gently/settings.py                          |  54 ++-
 gently/ui/web/connection_manager.py         |   5 +-
 gently/ui/web/routes/chat.py                |   4 +-
 7 files changed, 701 insertions(+), 804 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 4a5f6602..40618718 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -14,41 +14,38 @@
 import asyncio
 import logging
 import os
-from collections.abc import Callable
+from typing import Dict, List, Optional, Callable, Any, TYPE_CHECKING
 from datetime import datetime
 from pathlib import Path
-from typing import TYPE_CHECKING, Any
 
 import anthropic
 import numpy as np
 
-from ..exceptions import StorageError
+from ..exceptions import StorageError, AgentError
 from ..settings import settings
 
 if TYPE_CHECKING:
     from ..ui.web.server import VisualizationServer
-from gently_perception import Perceiver
 
-from ..core import EventType, emit, get_event_bus
-from ..core.file_store import FileStore
-from ..harness.conversation import ConversationManager
-from ..harness.orchestration.plan_synthesis import (
-    PlanLibrary,
-    PlanSynthesizer,
-    PlanValidator,
-)
-from ..harness.prompts.manager import PromptManager
-from ..harness.session.interaction_logger import InteractionLogger
-from ..harness.session.manager import SessionManager
-from ..harness.session.timeline import TimelineManager
-from ..harness.state import ExperimentState
+logger = logging.getLogger(__name__)
+
+from ..harness.state import ExperimentState, EmbryoState, ImageRecord
+from ..harness.orchestration.plan_synthesis import PlanSynthesizer, PlanLibrary, PlanValidator
 from ..harness.tools.registry import get_tool_registry
+from gently_perception import Perceiver
 
 # Import tools package to trigger @tool decorator registration
 from . import tools as _tools  # noqa: F401
+from ..harness.session.interaction_logger import InteractionLogger
 from .orchestration.timelapse import TimelapseOrchestrator
+from ..harness.session.timeline import TimelineManager
+from ..core import EventType, get_event_bus, emit
+from ..core.file_store import FileStore
+
+from ..harness.conversation import ConversationManager
+from ..harness.session.manager import SessionManager
+from ..harness.prompts.manager import PromptManager
 
-logger = logging.getLogger(__name__)
 
 # Shown when the agent is launched in UI-only mode (--no-api). The web UI is
 # fully browsable, but anything that would call Claude is disabled.
@@ -74,7 +71,7 @@ class MicroscopyAgent:
 
     def __init__(
         self,
-        api_key: str | None = None,
+        api_key: Optional[str] = None,
         storage_path: Path = Path("./experiment_data"),
         model: str = settings.models.main,
         microscope_client=None,
@@ -112,12 +109,11 @@ def __init__(
         # the message entry points refuse to call Claude.
         self.api_enabled = not no_api
 
-        # API client with interleaved thinking support
+        # Shared API client. No interleaved-thinking beta header: it's GA on the
+        # 4.6+ models and obsolete on Fable 5 (always-on thinking); the header is
+        # dropped so it can't conflict with the new model family.
         self.claude = anthropic.Anthropic(
-            api_key=api_key
-            or os.getenv("ANTHROPIC_API_KEY")
-            or ("no-api-mode" if no_api else None),
-            default_headers={"anthropic-beta": "interleaved-thinking-2025-05-14"},
+            api_key=api_key or os.getenv("ANTHROPIC_API_KEY") or ("no-api-mode" if no_api else None),
         )
         self.model = model
 
@@ -129,7 +125,7 @@ def __init__(
         self.mode: str = "run"
 
         # Context store (agent's mind — set via set_context_store)
-        self.context_store: Any | None = None
+        self.context_store: Optional[Any] = None
 
         # Experiment state
         self.experiment = ExperimentState()
@@ -145,7 +141,8 @@ def __init__(
 
         # Plan synthesis
         self.plan_synthesizer = PlanSynthesizer(
-            plan_library=PlanLibrary(), validator=PlanValidator()
+            plan_library=PlanLibrary(),
+            validator=PlanValidator()
         )
 
         # Event bus for async messaging (must be before perception manager)
@@ -166,8 +163,8 @@ def __init__(
         self.client = self.microscope
 
         # Callbacks
-        self.on_message_callback: Callable | None = None
-        self.choice_handler: Callable | None = None
+        self.on_message_callback: Optional[Callable] = None
+        self.choice_handler: Optional[Callable] = None
 
         # Serializes conversation turns: user turns and autonomous wake turns
         # must not interleave on the shared conversation_history.
@@ -178,18 +175,14 @@ def __init__(
         # human). User turns are unaffected. _wake_choice_factory is set by the
         # web bridge so ASK-mode wake turns can round-trip an approval picker.
         self._autonomous_active = False
-        self._autonomous_blocked_tools = frozenset(
-            {
-                "set_laser_power",
-                "remove_embryo",
-                "stop_timelapse",
-            }
-        )
+        self._autonomous_blocked_tools = frozenset({
+            "set_laser_power", "remove_embryo", "stop_timelapse",
+        })
         self._wake_choice_factory = None
         self._wake_choice_discard = None
 
         # Interaction logger for structured logging (research data collection)
-        self.interaction_logger: InteractionLogger | None = None
+        self.interaction_logger: Optional[InteractionLogger] = None
 
         # Event capture — durable log of every EventBus event during this
         # session. Substrate for offline replay / shadow-mode A/B of
@@ -202,13 +195,13 @@ def __init__(
         self.decision_log = None
 
         # Timelapse orchestrator (initialized when microscope connected)
-        self.timelapse_orchestrator: TimelapseOrchestrator | None = None
+        self.timelapse_orchestrator: Optional[TimelapseOrchestrator] = None
 
         # Timeline manager for tracking events
-        self.timeline_manager: TimelineManager | None = None
+        self.timeline_manager: Optional[TimelineManager] = None
 
         # Visualization server for real-time feedback
-        self.viz_server: VisualizationServer | None = None
+        self.viz_server: Optional["VisualizationServer"] = None
 
         # Device-state monitor (bridges device-layer SSE → EventBus)
         self.device_state_monitor = None
@@ -226,10 +219,10 @@ def __init__(
         )
         # Wire tool execution context
         self.conversation._tool_context = {
-            "agent": self,
-            "client": getattr(self, "microscope", None),
-            "microscope": getattr(self, "microscope", None),
-            "databroker": getattr(self, "databroker", None),
+            'agent': self,
+            'client': getattr(self, 'microscope', None),
+            'microscope': getattr(self, 'microscope', None),
+            'databroker': getattr(self, 'databroker', None),
         }
 
         # Session manager (persistence)
@@ -249,22 +242,16 @@ def __init__(
             success, history = self.sessions._resume_session(session_id, self.experiment)
             if success:
                 self.conversation.conversation_history = history
-            self._emit_event(
-                EventType.SESSION_RESTORED,
-                {
-                    "session_id": session_id,
-                    "embryo_count": len(self.experiment.embryos),
-                    "message_count": len(self.conversation.conversation_history),
-                },
-            )
+            self._emit_event(EventType.SESSION_RESTORED, {
+                'session_id': session_id,
+                'embryo_count': len(self.experiment.embryos),
+                'message_count': len(self.conversation.conversation_history),
+            })
         else:
             self.sessions.create_session()
-            self._emit_event(
-                EventType.SESSION_STARTED,
-                {
-                    "session_id": self.sessions.session_id,
-                },
-            )
+            self._emit_event(EventType.SESSION_STARTED, {
+                'session_id': self.sessions.session_id,
+            })
 
         # Initialize interaction logger (for research data collection)
         self._init_interaction_logger()
@@ -297,7 +284,6 @@ def __init__(
         # autonomously; enabled via the set_autonomy tool.
         try:
             from gently.app.wake_router import WakeRouter
-
             self.wake_router = WakeRouter(self, self._event_bus)
         except Exception:
             logger.exception("Failed to init wake-router")
@@ -314,7 +300,7 @@ def session_id(self) -> str:
         return self.sessions.session_id
 
     @property
-    def _session_id(self) -> str | None:
+    def _session_id(self) -> Optional[str]:
         """Internal session ID (backward compat)."""
         return self.sessions._session_id
 
@@ -323,7 +309,7 @@ def _session_id(self, value):
         self.sessions._session_id = value
 
     @property
-    def conversation_history(self) -> list[dict]:
+    def conversation_history(self) -> List[Dict]:
         """Get conversation history."""
         return self.conversation.conversation_history
 
@@ -368,7 +354,6 @@ def set_context_store(self, context_store) -> None:
         self.prompts.context_store = context_store
         # Create agent memory harness
         from ..harness.memory.interface import AgentMemory
-
         self.memory = AgentMemory(context_store, session_id=self.session_id)
         self.prompts.memory = self.memory
 
@@ -378,13 +363,8 @@ def enter_plan_mode(self) -> str:
             return "Already in plan mode."
         self.mode = "plan"
         import gently.harness.plan_mode.tools  # noqa: F401
-
         self._update_system_prompt()
-        emit(
-            EventType.STATUS_CHANGED,
-            {"field": "agent_mode", "value": "plan"},
-            source="agent",
-        )
+        emit(EventType.STATUS_CHANGED, {"field": "agent_mode", "value": "plan"}, source="agent")
         logger.info("Entered plan mode")
         return "Switched to plan mode. I'm now your experimental design collaborator."
 
@@ -462,8 +442,7 @@ def exit_plan_mode(self) -> str:
                 if item and self.session_id and self.context_store:
                     try:
                         self.context_store.link_session_campaign(
-                            self.session_id,
-                            item.campaign_id,
+                            self.session_id, item.campaign_id,
                         )
                     except Exception:
                         pass
@@ -480,11 +459,7 @@ def exit_plan_mode(self) -> str:
             self.prompts.invalidate_context_cache()
 
         self._update_system_prompt()
-        emit(
-            EventType.STATUS_CHANGED,
-            {"field": "agent_mode", "value": "run"},
-            source="agent",
-        )
+        emit(EventType.STATUS_CHANGED, {"field": "agent_mode", "value": "run"}, source="agent")
         logger.info("Exited plan mode")
         return result
 
@@ -493,14 +468,11 @@ def exit_plan_mode(self) -> str:
     def _update_system_prompt(self, context_summary: str | None = None):
         """Rebuild system prompt via PromptManager."""
         self.system_prompt = self.prompts.update_system_prompt(
-            self.experiment,
-            self.client,
-            self.mode,
-            context_summary,
+            self.experiment, self.client, self.mode, context_summary,
             perceiver=getattr(self, "perceiver", None),
         )
 
-    def _get_active_plan_summary(self) -> str | None:
+    def _get_active_plan_summary(self) -> Optional[str]:
         """Delegation shim for agent bridge access."""
         return self.prompts.get_active_plan_summary()
 
@@ -530,7 +502,7 @@ def _auto_save(self):
             self.experiment, self.conversation.conversation_history, self.system_prompt
         )
 
-    def list_sessions(self) -> list[dict]:
+    def list_sessions(self) -> List[Dict]:
         """List available sessions."""
         return self.sessions.list_sessions()
 
@@ -563,7 +535,6 @@ def _init_event_capture(self):
         a stripped-down agent) — replay just won't have a log to read.
         """
         from gently.eval import EventCapture
-
         try:
             session_dir = None
             sid = self.session_id
@@ -571,8 +542,7 @@ def _init_event_capture(self):
                 session_dir = self.store._session_dir(sid)
             if session_dir is None:
                 logging.getLogger(__name__).debug(
-                    "EventCapture: no session dir for %s — skipping", sid
-                )
+                    "EventCapture: no session dir for %s — skipping", sid)
                 return
             path = session_dir / "events.jsonl"
             self.event_capture = EventCapture(path)
@@ -599,7 +569,6 @@ def _init_decision_log(self):
         logs and the two are diffed offline.
         """
         from gently.eval import DecisionLog
-
         try:
             session_dir = None
             sid = self.session_id
@@ -607,8 +576,7 @@ def _init_decision_log(self):
                 session_dir = self.store._session_dir(sid)
             if session_dir is None:
                 logging.getLogger(__name__).debug(
-                    "DecisionLog: no session dir for %s — skipping", sid
-                )
+                    "DecisionLog: no session dir for %s — skipping", sid)
                 return
             path = session_dir / "decisions.jsonl"
             self.decision_log = DecisionLog(path)
@@ -706,15 +674,12 @@ def on_stage_detected(event):
                     embryo_id = data.get("embryo_id")
                     if embryo_id and embryo_id in self.experiment.embryos:
                         embryo = self.experiment.embryos[embryo_id]
-                        embryo.add_cv_result(
-                            "stage_classification",
-                            {
-                                "stage": data.get("stage"),
-                                "confidence": data.get("confidence"),
-                                "nuclei_count": data.get("nuclei_count"),
-                                "timepoint": data.get("timepoint"),
-                            },
-                        )
+                        embryo.add_cv_result("stage_classification", {
+                            "stage": data.get("stage"),
+                            "confidence": data.get("confidence"),
+                            "nuclei_count": data.get("nuclei_count"),
+                            "timepoint": data.get("timepoint"),
+                        })
                 except Exception as e:
                     logger.warning(f"Error handling stage detected event: {e}")
 
@@ -737,34 +702,23 @@ def on_perception(event):
                     stage = data.get("stage")
                     # 'no_object' is an empty-field sentinel, not a developmental
                     # stage — don't mirror it into latest_developmental_stage.
-                    if (
-                        not stage
-                        or stage == "no_object"
-                        or not embryo_id
-                        or embryo_id not in self.experiment.embryos
-                    ):
+                    if (not stage or stage == "no_object" or not embryo_id
+                            or embryo_id not in self.experiment.embryos):
                         return
                     embryo = self.experiment.embryos[embryo_id]
                     if stage == getattr(embryo, "latest_developmental_stage", None):
                         return  # steady state — nothing new to mirror
-                    embryo.add_cv_result(
-                        "stage_classification",
-                        {
-                            "stage": stage,
-                            "timepoint": data.get("timepoint"),
-                            "stability": data.get("stability"),
-                            "temporal_analysis": data.get("temporal_analysis"),
-                            "detector_name": "perception",
-                        },
-                    )
+                    embryo.add_cv_result("stage_classification", {
+                        "stage": stage,
+                        "timepoint": data.get("timepoint"),
+                        "stability": data.get("stability"),
+                        "temporal_analysis": data.get("temporal_analysis"),
+                        "detector_name": "perception",
+                    })
                     self.invalidate_context_cache()
                     self._auto_save()
-                    logger.info(
-                        "Perception: %s -> stage %s (t%s)",
-                        embryo_id,
-                        stage,
-                        data.get("timepoint"),
-                    )
+                    logger.info("Perception: %s -> stage %s (t%s)",
+                                embryo_id, stage, data.get("timepoint"))
                 except Exception as e:
                     logger.warning(f"Error handling perception event: {e}")
 
@@ -779,9 +733,7 @@ def on_perception(event):
 
     # ===== Visualization Server Methods =====
 
-    async def start_viz_server(
-        self, port: int = settings.network.viz_port, ssl_certfile=None, ssl_keyfile=None
-    ):
+    async def start_viz_server(self, port: int = settings.network.viz_port, ssl_certfile=None, ssl_keyfile=None):
         """Start the visualization server for real-time feedback."""
         if self.viz_server is not None:
             logger.info("Visualization server already running")
@@ -831,7 +783,6 @@ async def start_viz_server(
         if self.microscope is not None and self.device_state_monitor is None:
             try:
                 from .device_state_monitor import DeviceStateMonitor
-
                 self.device_state_monitor = DeviceStateMonitor(self.microscope)
                 await self.device_state_monitor.start()
                 logger.info("Device-state monitor started")
@@ -845,7 +796,6 @@ async def start_viz_server(
         if self.microscope is not None and self.bottom_camera_monitor is None:
             try:
                 from .bottom_camera_monitor import BottomCameraStreamMonitor
-
                 self.bottom_camera_monitor = BottomCameraStreamMonitor(self.microscope)
                 logger.info("Bottom-camera monitor ready (not started)")
             except Exception as e:
@@ -876,14 +826,16 @@ def push_viz(
         array: np.ndarray,
         uid: str,
         data_type: str = "image",
-        metadata: dict[str, Any] | None = None,
+        metadata: Optional[Dict[str, Any]] = None,
     ):
         """Non-blocking push of image to visualization server."""
         if self.viz_server is None:
             return
 
         try:
-            asyncio.create_task(self.viz_server.push_image(array, uid, data_type, metadata or {}))
+            asyncio.create_task(
+                self.viz_server.push_image(array, uid, data_type, metadata or {})
+            )
         except RuntimeError:
             pass
         except Exception as e:
@@ -902,7 +854,7 @@ def _has_microscope(self) -> bool:
         """
         return self.client is not None
 
-    def _emit_event(self, event_type: EventType, data: dict | None = None):
+    def _emit_event(self, event_type: EventType, data: Optional[Dict] = None):
         """Emit an event to the event bus."""
         self._event_bus.publish(
             event_type=event_type,
@@ -943,13 +895,10 @@ def _publish_embryos_update(self) -> None:
     def _mark_significant_action(self, action_type: str):
         """Mark that a significant action occurred (triggers auto-save)."""
         self._auto_save()
-        self._emit_event(
-            EventType.SESSION_SAVED,
-            {
-                "session_id": self.sessions._session_id,
-                "action_type": action_type,
-            },
-        )
+        self._emit_event(EventType.SESSION_SAVED, {
+            'session_id': self.sessions._session_id,
+            'action_type': action_type,
+        })
 
     # ===== Public Message API =====
 
@@ -968,11 +917,8 @@ async def handle_message(self, user_message: str) -> str:
             Response from agent
         """
         if quick_response := self.conversation.try_quick_response(
-            user_message,
-            self.experiment,
-            self.mode,
-            self.enter_plan_mode,
-            self.exit_plan_mode,
+            user_message, self.experiment, self.mode,
+            self.enter_plan_mode, self.exit_plan_mode,
         ):
             return quick_response
 
@@ -986,7 +932,10 @@ async def handle_message(self, user_message: str) -> str:
         self._update_system_prompt(context_summary)
 
         # Add user message to history
-        self.conversation.conversation_history.append({"role": "user", "content": user_message})
+        self.conversation.conversation_history.append({
+            "role": "user",
+            "content": user_message
+        })
 
         tools = self._get_tools_for_mode()
         cached_prompt = self._get_cached_system_prompt()
@@ -1013,17 +962,14 @@ async def handle_message_stream(self, user_message: str):
             Chunks with 'type' and data
         """
         if quick_response := self.conversation.try_quick_response(
-            user_message,
-            self.experiment,
-            self.mode,
-            self.enter_plan_mode,
-            self.exit_plan_mode,
+            user_message, self.experiment, self.mode,
+            self.enter_plan_mode, self.exit_plan_mode,
         ):
-            yield {"type": "text", "text": quick_response}
+            yield {'type': 'text', 'text': quick_response}
             return
 
         if not self.api_enabled:
-            yield {"type": "text", "text": _NO_API_NOTICE}
+            yield {'type': 'text', 'text': _NO_API_NOTICE}
             return
 
         # Hold the turn-lock for the whole streamed turn so an autonomous wake
@@ -1039,14 +985,16 @@ async def handle_message_stream(self, user_message: str):
             )
             self._update_system_prompt(context_summary)
 
-            self.conversation.conversation_history.append({"role": "user", "content": user_message})
+            self.conversation.conversation_history.append({
+                "role": "user",
+                "content": user_message
+            })
 
             tools = self._get_tools_for_mode()
             cached_prompt = self._get_cached_system_prompt()
 
             inner_gen = self.conversation.call_claude_stream(
-                cached_prompt,
-                tools,
+                cached_prompt, tools,
                 tool_label_fn=self.conversation.tool_label,
                 auto_save_fn=self._auto_save,
             )
@@ -1141,11 +1089,8 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
         choice_data = chunk.get("choice_data", {}) if isinstance(chunk, dict) else {}
         factory = getattr(self, "_wake_choice_factory", None)
         if not interactive or factory is None:
-            logger.info(
-                "Wake picker auto-cancelled (interactive=%s, channel=%s)",
-                interactive,
-                factory is not None,
-            )
+            logger.info("Wake picker auto-cancelled (interactive=%s, channel=%s)",
+                        interactive, factory is not None)
             return "cancelled"
         try:
             future = factory(choice_data)  # registers future + sets request_id
@@ -1155,7 +1100,6 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
         request_id = choice_data.get("request_id", "")
         await emit({**chunk, "origin": "wake", "request_id": request_id})
         from gently.app.wake_router import ASK_TIMEOUT_SEC
-
         try:
             selected = await asyncio.wait_for(future, timeout=ASK_TIMEOUT_SEC)
         except asyncio.TimeoutError:
@@ -1178,7 +1122,7 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
                     pass
         return selected or "skip"
 
-    async def get_tool_call(self, user_message: str) -> dict | None:
+    async def get_tool_call(self, user_message: str) -> Optional[Dict]:
         """Dry-run tool call (for benchmarking)."""
         context_summary = await self.prompts.get_cached_context_summary(
             self.experiment, self.timelapse_orchestrator, self.timeline_manager
@@ -1190,25 +1134,25 @@ async def get_tool_call(self, user_message: str) -> dict | None:
 
     # === Experiment Management Methods ===
 
-    def load_embryos_from_database(self, database: dict):
+    def load_embryos_from_database(self, database: Dict):
         """Load embryos from calibration database."""
-        if "embryos" not in database:
+        if 'embryos' not in database:
             return
 
-        for embryo_id, embryo_data in database["embryos"].items():
-            position = embryo_data.get("stage_position_after_centering_um", {})
-            calibration = embryo_data.get("calibration", {})
+        for embryo_id, embryo_data in database['embryos'].items():
+            position = embryo_data.get('stage_position_after_centering_um', {})
+            calibration = embryo_data.get('calibration', {})
 
             self.experiment.add_embryo(
                 embryo_id=embryo_id,
                 position=position,
                 calibration=calibration,
-                uid=embryo_data.get("uid"),
+                uid=embryo_data.get('uid'),
             )
 
         self._update_system_prompt()
 
-    def import_embryos_from_session(self, session_id: str, clear_existing: bool = False) -> dict:
+    def import_embryos_from_session(self, session_id: str, clear_existing: bool = False) -> Dict:
         """
         Import embryos from another session into the current experiment.
 
@@ -1264,14 +1208,14 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         if not embryo_states:
             session_data = self.store.load_session_snapshot(session_id)
             if session_data:
-                embryo_states = session_data.get("embryo_states", {})
+                embryo_states = session_data.get('embryo_states', {})
 
         if not embryo_states:
             return {
-                "success": False,
-                "error": "No embryos found in session",
-                "imported": [],
-                "skipped": [],
+                'success': False,
+                'error': "No embryos found in session",
+                'imported': [],
+                'skipped': [],
             }
 
         if clear_existing:
@@ -1291,30 +1235,30 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 # Prefer explicit coarse/fine when the snapshot has them
                 # (FileStore path); fall back to flat stage_position for the
                 # legacy JSON-snapshot path which only carries the resolved view.
-                position_coarse = embryo_data.get("position_coarse")
-                position_fine = embryo_data.get("position_fine")
+                position_coarse = embryo_data.get('position_coarse')
+                position_fine = embryo_data.get('position_fine')
                 if position_coarse is None and position_fine is None:
-                    position_coarse = embryo_data.get("stage_position", {})
-                calibration = embryo_data.get("calibration", {})
-                source_uid = embryo_data.get("uid") or f"{session_id}_{embryo_id}"
+                    position_coarse = embryo_data.get('stage_position', {})
+                calibration = embryo_data.get('calibration', {})
+                source_uid = embryo_data.get('uid') or f"{session_id}_{embryo_id}"
 
                 self.experiment.add_embryo(
                     embryo_id=embryo_id,
                     position=position_coarse or {},
                     position_fine=position_fine or {},
                     calibration=calibration,
-                    user_label=embryo_data.get("user_label"),
+                    user_label=embryo_data.get('user_label'),
                     uid=source_uid,
-                    role=embryo_data.get("role") or "unassigned",
+                    role=embryo_data.get('role') or 'unassigned',
                 )
 
                 embryo = self.experiment.embryos[embryo_id]
-                embryo.nickname = embryo_data.get("nickname")
-                embryo.interval_seconds = embryo_data.get("interval_seconds")
-                embryo.num_slices = embryo_data.get("num_slices", 50)
-                embryo.exposure_ms = embryo_data.get("exposure_ms", 10.0)
-                embryo.priority = embryo_data.get("priority", "normal")
-                embryo.acquisition_mode = embryo_data.get("acquisition_mode", "volume")
+                embryo.nickname = embryo_data.get('nickname')
+                embryo.interval_seconds = embryo_data.get('interval_seconds')
+                embryo.num_slices = embryo_data.get('num_slices', 50)
+                embryo.exposure_ms = embryo_data.get('exposure_ms', 10.0)
+                embryo.priority = embryo_data.get('priority', 'normal')
+                embryo.acquisition_mode = embryo_data.get('acquisition_mode', 'volume')
 
                 # Light budget import. Prefer fields already on embryo_data
                 # (future schema may persist these directly on embryo.yaml);
@@ -1325,22 +1269,27 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 # removed and the import should fail loudly if dose is
                 # missing.
                 dose = self._compute_imported_dose(session_id, embryo_id)
-                embryo.exposure_count = embryo_data.get("exposure_count") or dose["exposure_count"]
+                embryo.exposure_count = (
+                    embryo_data.get('exposure_count')
+                    or dose['exposure_count']
+                )
                 embryo.total_exposure_ms = (
-                    embryo_data.get("total_exposure_ms") or dose["total_exposure_ms"]
+                    embryo_data.get('total_exposure_ms')
+                    or dose['total_exposure_ms']
                 )
                 embryo.timepoints_acquired = (
-                    embryo_data.get("timepoints_acquired") or dose["exposure_count"]
+                    embryo_data.get('timepoints_acquired')
+                    or dose['exposure_count']
                 )
 
-                last_imaged_str = embryo_data.get("last_imaged")
+                last_imaged_str = embryo_data.get('last_imaged')
                 if last_imaged_str:
                     try:
                         embryo.last_imaged = datetime.fromisoformat(last_imaged_str)
                     except (ValueError, TypeError):
-                        embryo.last_imaged = dose["last_imaged"]
+                        embryo.last_imaged = dose['last_imaged']
                 else:
-                    embryo.last_imaged = dose["last_imaged"]
+                    embryo.last_imaged = dose['last_imaged']
 
                 imported.append(embryo_id)
 
@@ -1351,14 +1300,14 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         self._mark_significant_action("embryo_import")
 
         return {
-            "success": len(imported) > 0,
-            "imported": imported,
-            "skipped": skipped,
-            "errors": errors,
-            "source_session": session_id,
+            'success': len(imported) > 0,
+            'imported': imported,
+            'skipped': skipped,
+            'errors': errors,
+            'source_session': session_id,
         }
 
-    def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> dict:
+    def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> Dict:
         """Reconstruct an embryo's realized 488 nm photodose from the source
         session's per-volume meta files.
 
@@ -1373,68 +1322,66 @@ def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> dict
         TODO: replace with reading a persisted ``dose:`` block from
         embryo.yaml once dose-tracking is first-class.
         """
+        import yaml
         from datetime import datetime
         from pathlib import Path
 
-        import yaml
-
         result = {
-            "exposure_count": 0,
-            "total_exposure_ms": 0.0,
-            "last_imaged": None,
+            'exposure_count': 0,
+            'total_exposure_ms': 0.0,
+            'last_imaged': None,
         }
 
         if not self.store:
             return result
 
         # FileStore exposes _session_dir(session_id) → resolved Path.
-        session_dir_fn = getattr(self.store, "_session_dir", None)
+        session_dir_fn = getattr(self.store, '_session_dir', None)
         sd = session_dir_fn(source_session_id) if callable(session_dir_fn) else None
         if sd is None:
             return result
 
-        vols_dir = Path(sd) / "embryos" / embryo_id / "volumes"
+        vols_dir = Path(sd) / 'embryos' / embryo_id / 'volumes'
         if not vols_dir.is_dir():
             return result
 
         latest = None
-        for meta_path in sorted(vols_dir.glob("*.meta.yaml")):
+        for meta_path in sorted(vols_dir.glob('*.meta.yaml')):
             try:
                 doc = yaml.safe_load(meta_path.read_text()) or {}
             except Exception:
                 continue
-            md = doc.get("metadata") or {}
-            num_slices = md.get("num_slices")
+            md = doc.get('metadata') or {}
+            num_slices = md.get('num_slices')
             if num_slices is None:
-                shape = doc.get("shape") or []
+                shape = doc.get('shape') or []
                 num_slices = shape[0] if shape else 0
-            exposure_ms = md.get("exposure_ms") or 0.0
+            exposure_ms = md.get('exposure_ms') or 0.0
             try:
-                result["total_exposure_ms"] += float(num_slices) * float(exposure_ms)
+                result['total_exposure_ms'] += float(num_slices) * float(exposure_ms)
             except (TypeError, ValueError):
                 pass
-            result["exposure_count"] += 1
-            acq = doc.get("acquired_at")
+            result['exposure_count'] += 1
+            acq = doc.get('acquired_at')
             if acq and (latest is None or acq > latest):
                 latest = acq
 
         if latest:
             try:
-                result["last_imaged"] = datetime.fromisoformat(latest)
+                result['last_imaged'] = datetime.fromisoformat(latest)
             except (ValueError, TypeError):
                 pass
 
         return result
 
-    async def on_volume_acquired(
-        self, embryo_id: str, timepoint: int, volume_data, volume_path=None
-    ):
+    async def on_volume_acquired(self, embryo_id: str, timepoint: int,
+                                volume_data, volume_path=None):
         """Callback when a volume is acquired."""
         embryo = self.experiment.embryos.get(embryo_id)
         if not embryo:
             return
 
-        if hasattr(volume_data, "read_volume"):
+        if hasattr(volume_data, 'read_volume'):
             volume = volume_data.read_volume()
         else:
             volume = volume_data
@@ -1443,8 +1390,7 @@ async def on_volume_acquired(
         if self.store and self.session_id:
             try:
                 self.store.register_embryo(
-                    self.session_id,
-                    embryo_id,
+                    self.session_id, embryo_id,
                     position_coarse=embryo.position_coarse or None,
                     position_fine=embryo.position_fine or None,
                     calibration=embryo.calibration,
@@ -1461,19 +1407,14 @@ async def on_volume_acquired(
                 }
                 if volume_path is not None:
                     stored_path = self.store.register_volume(
-                        self.session_id,
-                        embryo_id,
-                        timepoint,
+                        self.session_id, embryo_id, timepoint,
                         incoming_path=Path(volume_path),
                         metadata=acq_metadata,
                         volume_data=volume,
                     )
                 else:
                     stored_path = self.store.put_volume(
-                        self.session_id,
-                        embryo_id,
-                        timepoint,
-                        volume,
+                        self.session_id, embryo_id, timepoint, volume,
                         metadata=acq_metadata,
                     )
             except StorageError:
@@ -1488,9 +1429,9 @@ async def on_volume_acquired(
         if self.viz_server and volume is not None:
             try:
                 from gently.core.imaging import (
-                    apply_crop_bounds,
-                    compute_crop_bounds,
                     projection_three_view,
+                    compute_crop_bounds,
+                    apply_crop_bounds,
                 )
 
                 view_a = volume[0] if volume.ndim == 4 else volume
@@ -1498,18 +1439,14 @@ async def on_volume_acquired(
                 if view_a.ndim == 3:
                     z_depth, height, width = view_a.shape
                     if width > height * 2:
-                        view_a = view_a[:, :, : width // 2]
+                        view_a = view_a[:, :, :width // 2]
                     bounds = compute_crop_bounds(view_a)
                     cropped = apply_crop_bounds(view_a, bounds)
                     three_view_img, _ = projection_three_view(cropped)
                 else:
                     three_view_img = view_a.astype(np.float32)
                     if three_view_img.max() > three_view_img.min():
-                        three_view_img = (
-                            (three_view_img - three_view_img.min())
-                            / (three_view_img.max() - three_view_img.min())
-                            * 255
-                        )
+                        three_view_img = (three_view_img - three_view_img.min()) / (three_view_img.max() - three_view_img.min()) * 255
                     three_view_img = three_view_img.astype(np.uint8)
 
                 self.push_viz(
@@ -1517,32 +1454,29 @@ async def on_volume_acquired(
                     uid=projection_uid,
                     data_type="volume_projection",
                     metadata={
-                        "embryo_id": embryo_id,
-                        "timepoint": timepoint,
-                        "shape": list(volume.shape),
-                        "projection_uid": projection_uid,
-                        "volume_uid": volume_uid,
-                        "projection_type": "three_view",
-                    },
+                        'embryo_id': embryo_id,
+                        'timepoint': timepoint,
+                        'shape': list(volume.shape),
+                        'projection_uid': projection_uid,
+                        'volume_uid': volume_uid,
+                        'projection_type': 'three_view',
+                    }
                 )
             except Exception as e:
                 logger.warning(f"Failed to push to viz: {e}")
 
-        self._emit_event(
-            EventType.VOLUME_ACQUIRED,
-            {
-                "embryo_id": embryo_id,
-                "timepoint": timepoint,
-                "volume_uid": volume_uid,
-                "projection_uid": projection_uid,
-                "volume_path": str(stored_path) if stored_path else None,
-                "shape": list(volume.shape),
-            },
-        )
+        self._emit_event(EventType.VOLUME_ACQUIRED, {
+            'embryo_id': embryo_id,
+            'timepoint': timepoint,
+            'volume_uid': volume_uid,
+            'projection_uid': projection_uid,
+            'volume_path': str(stored_path) if stored_path else None,
+            'shape': list(volume.shape),
+        })
 
         return {
-            "volume_uid": volume_uid,
-            "projection_uid": projection_uid,
+            'volume_uid': volume_uid,
+            'projection_uid': projection_uid,
         }
 
     def should_stop_experiment(self) -> bool:
@@ -1551,31 +1485,22 @@ def should_stop_experiment(self) -> bool:
             return False
         return all(e.should_skip for e in self.experiment.embryos.values())
 
-    def get_embryo_acquisition_order(self) -> list[str]:
+    def get_embryo_acquisition_order(self) -> List[str]:
         """Get embryo acquisition order based on priority."""
-        high = [
-            e.id
-            for e in self.experiment.embryos.values()
-            if e.priority == "high" and not e.should_skip
-        ]
-        normal = [
-            e.id
-            for e in self.experiment.embryos.values()
-            if e.priority == "normal" and not e.should_skip
-        ]
-        low = [
-            e.id
-            for e in self.experiment.embryos.values()
-            if e.priority == "low" and not e.should_skip
-        ]
+        high = [e.id for e in self.experiment.embryos.values() if e.priority == "high" and not e.should_skip]
+        normal = [e.id for e in self.experiment.embryos.values() if e.priority == "normal" and not e.should_skip]
+        low = [e.id for e in self.experiment.embryos.values() if e.priority == "low" and not e.should_skip]
         return high + normal + low
 
-    def decide_parameters(self, embryo_id: str, timepoint: int) -> dict:
+    def decide_parameters(self, embryo_id: str, timepoint: int) -> Dict:
         """Get current acquisition parameters for embryo."""
         embryo = self.experiment.embryos.get(embryo_id)
         if not embryo:
-            return {"num_slices": 50, "exposure_ms": 10.0}
-        return {"num_slices": embryo.num_slices, "exposure_ms": embryo.exposure_ms}
+            return {'num_slices': 50, 'exposure_ms': 10.0}
+        return {
+            'num_slices': embryo.num_slices,
+            'exposure_ms': embryo.exposure_ms
+        }
 
     def decide_next_interval(self, timepoint: int) -> float:
         """Decide interval until next timepoint."""
@@ -1600,9 +1525,8 @@ async def check_blank_image(
                 logger.warning(f"[BLANK_CHECK] {embryo_id}: Numerical check indicates blank image")
                 return True
 
-            import base64
             import io
-
+            import base64
             from PIL import Image
 
             if max_proj.max() > 0:
@@ -1612,11 +1536,10 @@ async def check_blank_image(
 
             img = Image.fromarray(normalized)
             buffer = io.BytesIO()
-            img.save(buffer, format="PNG")
+            img.save(buffer, format='PNG')
             b64_image = base64.b64encode(buffer.getvalue()).decode()
 
-            prompt = """Look at this microscopy image. Is this a VALID microscopy image or a
-BLANK/CORRUPTED image?
+            prompt = """Look at this microscopy image. Is this a VALID microscopy image or a BLANK/CORRUPTED image?
 
 A BLANK or CORRUPTED image shows:
 - Mostly uniform gray/black with no structure
@@ -1634,22 +1557,20 @@ async def check_blank_image(
                 self.claude.messages.create,
                 model=settings.models.fast,
                 max_tokens=10,
-                messages=[
-                    {
-                        "role": "user",
-                        "content": [
-                            {"type": "text", "text": prompt},
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": "image/png",
-                                    "data": b64_image,
-                                },
-                            },
-                        ],
-                    }
-                ],
+                messages=[{
+                    "role": "user",
+                    "content": [
+                        {"type": "text", "text": prompt},
+                        {
+                            "type": "image",
+                            "source": {
+                                "type": "base64",
+                                "media_type": "image/png",
+                                "data": b64_image
+                            }
+                        }
+                    ]
+                }]
             )
 
             result = response.content[0].text.strip().upper()
@@ -1660,11 +1581,7 @@ async def check_blank_image(
 
             return is_blank
 
-        except (
-            anthropic.APIConnectionError,
-            anthropic.RateLimitError,
-            anthropic.APIStatusError,
-        ) as e:
+        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
             logger.error(f"[BLANK_CHECK] Claude API error for {embryo_id}: {e}")
             return False
         except Exception as e:
diff --git a/gently/app/detectors/dopaminergic_signal.py b/gently/app/detectors/dopaminergic_signal.py
index 7fb09408..9e9edbd9 100644
--- a/gently/app/detectors/dopaminergic_signal.py
+++ b/gently/app/detectors/dopaminergic_signal.py
@@ -273,7 +273,9 @@ async def _call_perceiver(
                 }
             ],
         )
-        raw = response.content[0].text if response.content else ""
+        if response.stop_reason == "refusal" or not response.content:
+            return "(perception model declined the request)", ""
+        raw = response.content[0].text
         return raw.strip(), raw
 
     async def _call_classifier(
@@ -290,7 +292,9 @@ async def _call_classifier(
             max_tokens=300,
             messages=[{"role": "user", "content": prompt}],
         )
-        raw = response.content[0].text if response.content else ""
+        if response.stop_reason == "refusal" or not response.content:
+            return dict(_DEFAULT_FINDINGS), "", "Safety refusal"
+        raw = response.content[0].text
         findings, parse_err = _parse_response(raw)
         return findings, raw, parse_err
 
diff --git a/gently/hardware/dispim/sam_detection.py b/gently/hardware/dispim/sam_detection.py
index cea9990a..7014338a 100644
--- a/gently/hardware/dispim/sam_detection.py
+++ b/gently/hardware/dispim/sam_detection.py
@@ -5,28 +5,29 @@
 Returns embryo positions (pixel + stage coordinates) for calibration workflow.
 """
 
-import base64
-import json
 import logging
-import os
+import time
+import json
 import uuid
-from io import BytesIO
+import numpy as np
 from pathlib import Path
-
-import anthropic
 import cv2
-import numpy as np
+import base64
+from io import BytesIO
 from PIL import Image
+import anthropic
+from typing import Dict, List, Tuple, Optional
+import os
 
 from gently.settings import settings
 
 logger = logging.getLogger(__name__)
 
-from gently.core.coordinates import (  # noqa: E402
-    DEFAULT_OBJECTIVE_MAG,
-    DEFAULT_PIXEL_SIZE_UM,
-    get_um_per_pixel,
+from gently.core.coordinates import (
     pixel_to_stage_position,
+    get_um_per_pixel,
+    DEFAULT_PIXEL_SIZE_UM,
+    DEFAULT_OBJECTIVE_MAG,
 )
 
 
@@ -41,13 +42,11 @@ class SAMEmbryoDetector:
     - Returns embryo positions as simple list of coordinates
     """
 
-    def __init__(
-        self,
-        sam_checkpoint: str = "sam_vit_b_01ec64.pth",
-        sam_model_type: str = "vit_b",
-        device: str = "cpu",
-        anthropic_api_key: str | None = None,
-    ):
+    def __init__(self,
+                 sam_checkpoint: str = "sam_vit_b_01ec64.pth",
+                 sam_model_type: str = "vit_b",
+                 device: str = "cpu",
+                 anthropic_api_key: Optional[str] = None):
         """
         Initialize SAM detector
 
@@ -86,7 +85,7 @@ def _load_sam(self):
         if self._mask_generator is not None:
             return
 
-        from segment_anything import SamAutomaticMaskGenerator, SamPredictor, sam_model_registry
+        from segment_anything import sam_model_registry, SamAutomaticMaskGenerator, SamPredictor
 
         if not Path(self.sam_checkpoint).exists():
             raise FileNotFoundError(f"SAM checkpoint not found: {self.sam_checkpoint}")
@@ -109,15 +108,13 @@ def _load_sam(self):
         self._predictor = SamPredictor(sam)
         logger.info("SAM model loaded")
 
-    def preprocess_image(
-        self,
-        image: np.ndarray,
-        bg_kernel_size: int = 150,
-        use_clahe: bool = True,
-        clahe_clip_limit: float = 3.0,
-        clahe_tile_size: int = 16,
-        gaussian_sigma: float = 2.0,
-    ) -> np.ndarray:
+    def preprocess_image(self,
+                         image: np.ndarray,
+                         bg_kernel_size: int = 150,
+                         use_clahe: bool = True,
+                         clahe_clip_limit: float = 3.0,
+                         clahe_tile_size: int = 16,
+                         gaussian_sigma: float = 2.0) -> np.ndarray:
         """
         Preprocess image for better SAM detection.
 
@@ -154,18 +151,14 @@ def preprocess_image(
         # This stretches the narrow range (e.g., 84-354) to full 0-255
         logger.debug("Percentile normalization (2-98%%)...")
         p2, p98 = np.percentile(image, (2, 98))
-        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(
-            np.uint8
-        )
+        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(np.uint8)
         logger.debug("Normalized to 0-255")
 
         # Step 2: Background subtraction with large morphological opening
         # Removes large-scale illumination variations
         if bg_kernel_size > 0:
             logger.debug("Background subtraction (kernel=%d)...", bg_kernel_size)
-            kernel_bg = cv2.getStructuringElement(
-                cv2.MORPH_ELLIPSE, (bg_kernel_size, bg_kernel_size)
-            )
+            kernel_bg = cv2.getStructuringElement(cv2.MORPH_ELLIPSE, (bg_kernel_size, bg_kernel_size))
             background = cv2.morphologyEx(img_norm, cv2.MORPH_OPEN, kernel_bg)
             img_no_bg = cv2.subtract(img_norm, background)
             img_no_bg = cv2.normalize(img_no_bg, None, 0, 255, cv2.NORM_MINMAX).astype(np.uint8)
@@ -178,7 +171,8 @@ def preprocess_image(
         if use_clahe:
             logger.debug("CLAHE (clip=%.1f, tile=%d)...", clahe_clip_limit, clahe_tile_size)
             clahe = cv2.createCLAHE(
-                clipLimit=clahe_clip_limit, tileGridSize=(clahe_tile_size, clahe_tile_size)
+                clipLimit=clahe_clip_limit,
+                tileGridSize=(clahe_tile_size, clahe_tile_size)
             )
             img_enhanced = clahe.apply(img_no_bg)
             logger.debug("CLAHE applied")
@@ -193,20 +187,16 @@ def preprocess_image(
         else:
             img_smooth = img_enhanced
 
-        logger.debug(
-            "Preprocessing complete (output range: %s - %s)", img_smooth.min(), img_smooth.max()
-        )
+        logger.debug("Preprocessing complete (output range: %s - %s)", img_smooth.min(), img_smooth.max())
         return img_smooth
 
-    def find_embryo_candidates(
-        self,
-        image: np.ndarray,
-        brightness_percentile: float = 99.0,
-        min_area: int = 5000,
-        max_area: int = 150000,
-        clahe_clip: float = 3.0,
-        clahe_tile: int = 16,
-    ) -> tuple[list[dict], np.ndarray]:
+    def find_embryo_candidates(self,
+                               image: np.ndarray,
+                               brightness_percentile: float = 99.0,
+                               min_area: int = 5000,
+                               max_area: int = 150000,
+                               clahe_clip: float = 3.0,
+                               clahe_tile: int = 16) -> Tuple[List[Dict], np.ndarray]:
         """
         Find embryo candidates using brightness-based detection.
 
@@ -239,16 +229,12 @@ def find_embryo_candidates(
         enhanced_image : np.ndarray
             Contrast-enhanced 8-bit image for SAM
         """
-        logger.info(
-            "Finding embryo candidates (brightness percentile=%.1f)...", brightness_percentile
-        )
+        logger.info("Finding embryo candidates (brightness percentile=%.1f)...", brightness_percentile)
         logger.debug("Input range: %s - %s", image.min(), image.max())
 
         # Step 1: Percentile normalization (handles low dynamic range)
         p2, p98 = np.percentile(image, (2, 98))
-        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(
-            np.uint8
-        )
+        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(np.uint8)
         logger.debug("Normalized to 0-255")
 
         # Step 2: CLAHE for local contrast enhancement
@@ -275,9 +261,7 @@ def find_embryo_candidates(
         logger.debug("Morphological cleanup complete")
 
         # Step 7: Find connected components and filter by area
-        num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(
-            mask, connectivity=8
-        )
+        num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(mask, connectivity=8)
 
         candidates = []
         for i in range(1, num_labels):  # Skip background (label 0)
@@ -289,14 +273,19 @@ def find_embryo_candidates(
                 h = stats[i, cv2.CC_STAT_HEIGHT]
                 cx, cy = centroids[i]
 
-                candidates.append({"bbox": (x, y, w, h), "centroid": (cx, cy), "area": area})
+                candidates.append({
+                    'bbox': (x, y, w, h),
+                    'centroid': (cx, cy),
+                    'area': area
+                })
 
         logger.info("Found %d embryo candidates", len(candidates))
         return candidates, img_smooth
 
-    def refine_with_sam(
-        self, image: np.ndarray, candidates: list[dict], padding: int = 20
-    ) -> list[dict]:
+    def refine_with_sam(self,
+                        image: np.ndarray,
+                        candidates: List[Dict],
+                        padding: int = 20) -> List[Dict]:
         """
         Refine embryo candidates using SAM with bounding box prompts.
 
@@ -333,7 +322,7 @@ def refine_with_sam(
         h, w = image.shape[:2]
 
         for i, candidate in enumerate(candidates):
-            x, y, bw, bh = candidate["bbox"]
+            x, y, bw, bh = candidate['bbox']
 
             # Add padding and clip to image bounds
             x1 = max(0, x - padding)
@@ -346,7 +335,10 @@ def refine_with_sam(
 
             # Get SAM prediction with box prompt
             masks, scores, _ = self._predictor.predict(
-                point_coords=None, point_labels=None, box=input_box, multimask_output=True
+                point_coords=None,
+                point_labels=None,
+                box=input_box,
+                multimask_output=True
             )
 
             # Take best mask (highest score)
@@ -356,7 +348,9 @@ def refine_with_sam(
 
             # Calculate properties from SAM mask
             contours, _ = cv2.findContours(
-                mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
+                mask.astype(np.uint8),
+                cv2.RETR_EXTERNAL,
+                cv2.CHAIN_APPROX_SIMPLE
             )
 
             if contours:
@@ -370,47 +364,41 @@ def refine_with_sam(
                     cx = M["m10"] / M["m00"]
                     cy = M["m01"] / M["m00"]
                 else:
-                    cx, cy = candidate["centroid"]
+                    cx, cy = candidate['centroid']
 
                 # Calculate circularity
                 perimeter = cv2.arcLength(contour, True)
-                circularity = 4 * np.pi * area / (perimeter**2) if perimeter > 0 else 0
+                circularity = 4 * np.pi * area / (perimeter ** 2) if perimeter > 0 else 0
 
                 # Get bounding box from contour
                 bx, by, bw, bh = cv2.boundingRect(contour)
 
-                embryos.append(
-                    {
-                        "embryo_id": f"embryo_{i + 1}",
-                        "uid": str(
-                            uuid.uuid4()
-                        ),  # Global unique identifier for cross-session tracking
-                        "pixel_x": float(cx),
-                        "pixel_y": float(cy),
-                        "bbox": (bx, by, bw, bh),  # Used by visualization functions
-                        "area_pixels": int(area),
-                        "circularity": float(circularity),
-                        "confidence": float(score),
-                        "mask": mask,
-                    }
-                )
+                embryos.append({
+                    'embryo_id': f'embryo_{i + 1}',
+                    'uid': str(uuid.uuid4()),  # Global unique identifier for cross-session tracking
+                    'pixel_x': float(cx),
+                    'pixel_y': float(cy),
+                    'bbox': (bx, by, bw, bh),  # Used by visualization functions
+                    'area_pixels': int(area),
+                    'circularity': float(circularity),
+                    'confidence': float(score),
+                    'mask': mask
+                })
 
         logger.info("SAM refined %d embryos", len(embryos))
         return embryos
 
-    async def detect_embryos(
-        self,
-        image: np.ndarray,
-        stage_position: tuple[float, float],
-        pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
-        objective_mag: float = DEFAULT_OBJECTIVE_MAG,
-        use_claude_review: bool = True,
-        save_visualizations: bool = True,
-        output_dir: Path | None = None,
-        brightness_percentile: float = 99.0,
-        min_area: int = 5000,
-        max_area: int = 150000,
-    ) -> dict:
+    async def detect_embryos(self,
+                            image: np.ndarray,
+                            stage_position: Tuple[float, float],
+                            pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
+                            objective_mag: float = DEFAULT_OBJECTIVE_MAG,
+                            use_claude_review: bool = True,
+                            save_visualizations: bool = True,
+                            output_dir: Optional[Path] = None,
+                            brightness_percentile: float = 99.0,
+                            min_area: int = 5000,
+                            max_area: int = 150000) -> Dict:
         """
         Detect embryos using brightness-based detection + SAM refinement.
 
@@ -474,17 +462,20 @@ async def detect_embryos(
         # Step 1: Find candidates using brightness detection
         logger.info("[1/4] Finding embryo candidates (brightness-based)...")
         candidates, image_enhanced = self.find_embryo_candidates(
-            image, brightness_percentile=brightness_percentile, min_area=min_area, max_area=max_area
+            image,
+            brightness_percentile=brightness_percentile,
+            min_area=min_area,
+            max_area=max_area
         )
 
         if len(candidates) == 0:
             logger.warning("No embryo candidates found!")
             return {
-                "embryos": [],
-                "initial_detections": 0,
-                "final_detections": 0,
-                "verification": {"verified": False},
-                "images": {},
+                'embryos': [],
+                'initial_detections': 0,
+                'final_detections': 0,
+                'verification': {'verified': False},
+                'images': {}
             }
 
         # Step 2: Refine with SAM
@@ -498,11 +489,11 @@ async def detect_embryos(
         if len(embryos_sam) == 0:
             logger.warning("No embryos detected by SAM!")
             return {
-                "embryos": [],
-                "initial_detections": 0,
-                "final_detections": 0,
-                "verification": {"verified": False},
-                "images": {},
+                'embryos': [],
+                'initial_detections': 0,
+                'final_detections': 0,
+                'verification': {'verified': False},
+                'images': {}
             }
 
         # Save initial detection
@@ -512,8 +503,8 @@ async def detect_embryos(
 
         # Claude review (if enabled)
         embryos_final = embryos_sam
-        verification = {"verified": True, "skipped": not use_claude_review}
-        changes = {"round1": {"removed": [], "added": []}}
+        verification = {'verified': True, 'skipped': not use_claude_review}
+        changes = {'round1': {'removed': [], 'added': []}}
 
         if use_claude_review and self.claude_client:
             logger.info("[2/4] Claude Vision review (Round 1)...")
@@ -521,7 +512,7 @@ async def detect_embryos(
             review_r1 = await self._review_with_claude(image_8bit, annotated, embryos_sam)
 
             logger.info("[3/4] Applying corrections...")
-            embryos_r1, changes["round1"] = self._apply_corrections(
+            embryos_r1, changes['round1'] = self._apply_corrections(
                 embryos_sam, review_r1, image, self._predictor
             )
 
@@ -533,22 +524,22 @@ async def detect_embryos(
             logger.info("[4/4] Claude verification (Round 2)...")
             r1_viz = self._create_annotated_image(image_8bit, embryos_r1)
             verification = await self._verify_with_claude(
-                image_8bit, r1_viz, embryos_r1, changes["round1"]
+                image_8bit, r1_viz, embryos_r1, changes['round1']
             )
 
             # Apply round 2 corrections if needed
             has_r2_changes = (
-                len(verification.get("additional_false_positives", [])) > 0
-                or len(verification.get("additional_false_negatives", [])) > 0
+                len(verification.get('additional_false_positives', [])) > 0 or
+                len(verification.get('additional_false_negatives', [])) > 0
             )
 
             if has_r2_changes:
                 logger.info("Applying Round 2 corrections...")
                 review_r2 = {
-                    "false_positives": verification.get("additional_false_positives", []),
-                    "false_negatives": verification.get("additional_false_negatives", []),
+                    'false_positives': verification.get('additional_false_positives', []),
+                    'false_negatives': verification.get('additional_false_negatives', [])
                 }
-                embryos_final, changes["round2"] = self._apply_corrections(
+                embryos_final, changes['round2'] = self._apply_corrections(
                     embryos_r1, review_r2, image, self._predictor
                 )
             else:
@@ -562,7 +553,7 @@ async def detect_embryos(
             stage_position,
             pixel_size_um,
             objective_mag,
-            image_shape=image.shape[:2],  # (height, width)
+            image_shape=image.shape[:2]  # (height, width)
         )
 
         # Save final visualization
@@ -572,19 +563,19 @@ async def detect_embryos(
 
         # Package results
         results = {
-            "embryos": embryo_positions,
-            "initial_detections": len(embryos_sam),
-            "final_detections": len(embryos_final),
-            "verification": verification,
-            "changes": changes,
-            "images": {
-                "initial": str(output_dir / "detection_initial.png"),
-                "final": str(output_dir / "detection_final.png"),
-            },
+            'embryos': embryo_positions,
+            'initial_detections': len(embryos_sam),
+            'final_detections': len(embryos_final),
+            'verification': verification,
+            'changes': changes,
+            'images': {
+                'initial': str(output_dir / "detection_initial.png"),
+                'final': str(output_dir / "detection_final.png")
+            }
         }
 
         if use_claude_review and save_visualizations:
-            results["images"]["round1"] = str(output_dir / "detection_round1.png")
+            results['images']['round1'] = str(output_dir / "detection_round1.png")
 
         logger.info("=" * 70)
         logger.info("DETECTION COMPLETE: %d embryos", len(embryo_positions))
@@ -603,7 +594,7 @@ def _to_rgb8(image: np.ndarray) -> np.ndarray:
             return cv2.cvtColor(image, cv2.COLOR_GRAY2RGB)
         return image
 
-    def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
+    def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
         """Run SAM automatic segmentation (extracted from test script)"""
         image_rgb = self._to_rgb8(image)
 
@@ -613,16 +604,14 @@ def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
         # Filter candidates
         embryo_candidates = []
         for mask_data in masks:
-            area = mask_data["area"]
+            area = mask_data['area']
 
             if not (self.min_area <= area <= self.max_area):
                 continue
 
-            bbox = mask_data["bbox"]
-            mask = mask_data["segmentation"]
-            contours, _ = cv2.findContours(
-                mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
-            )
+            bbox = mask_data['bbox']
+            mask = mask_data['segmentation']
+            contours, _ = cv2.findContours(mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
 
             if len(contours) == 0:
                 continue
@@ -631,44 +620,40 @@ def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
             if perimeter == 0:
                 continue
 
-            circularity = 4 * np.pi * area / (perimeter**2)
+            circularity = 4 * np.pi * area / (perimeter ** 2)
 
             if circularity < self.min_circularity:
                 continue
 
-            embryo_candidates.append(
-                {
-                    "mask": mask,
-                    "bbox": bbox,
-                    "area": area,
-                    "circularity": circularity,
-                    "stability_score": mask_data["stability_score"],
-                    "predicted_iou": mask_data["predicted_iou"],
-                }
-            )
+            embryo_candidates.append({
+                'mask': mask,
+                'bbox': bbox,
+                'area': area,
+                'circularity': circularity,
+                'stability_score': mask_data['stability_score'],
+                'predicted_iou': mask_data['predicted_iou']
+            })
 
         # Sort by quality and apply spatial separation
-        embryo_candidates.sort(key=lambda x: x["area"] * x["stability_score"], reverse=True)
+        embryo_candidates.sort(key=lambda x: (x['area'] * x['stability_score']), reverse=True)
 
         selected_embryos = []
         for candidate in embryo_candidates:
             if len(selected_embryos) >= self.max_embryos:
                 break
 
-            bbox = candidate["bbox"]
+            bbox = candidate['bbox']
             candidate_center_x = bbox[0] + bbox[2] / 2
             candidate_center_y = bbox[1] + bbox[3] / 2
 
             too_close = False
             for selected in selected_embryos:
-                sel_bbox = selected["bbox"]
+                sel_bbox = selected['bbox']
                 sel_center_x = sel_bbox[0] + sel_bbox[2] / 2
                 sel_center_y = sel_bbox[1] + sel_bbox[3] / 2
 
-                distance = np.sqrt(
-                    (candidate_center_x - sel_center_x) ** 2
-                    + (candidate_center_y - sel_center_y) ** 2
-                )
+                distance = np.sqrt((candidate_center_x - sel_center_x)**2 +
+                                 (candidate_center_y - sel_center_y)**2)
 
                 if distance < self.min_separation_pixels:
                     too_close = True
@@ -677,27 +662,19 @@ def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
             if not too_close:
                 selected_embryos.append(candidate)
 
-        return selected_embryos, image_rgb
+        return selected_embryos, image_8bit
 
-    def _create_annotated_image(self, image: np.ndarray, embryos: list[dict]) -> np.ndarray:
+    def _create_annotated_image(self, image: np.ndarray, embryos: List[Dict]) -> np.ndarray:
         """Create annotated image with numbered boxes"""
         viz = image.copy()
         if len(viz.shape) == 2:
             viz = cv2.cvtColor(viz, cv2.COLOR_GRAY2RGB)
 
-        colors = [
-            (255, 0, 0),
-            (0, 255, 0),
-            (0, 0, 255),
-            (255, 255, 0),
-            (255, 0, 255),
-            (0, 255, 255),
-            (128, 128, 0),
-            (128, 0, 128),
-        ]
+        colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255), (255, 255, 0),
+                  (255, 0, 255), (0, 255, 255), (128, 128, 0), (128, 0, 128)]
 
         for i, embryo in enumerate(embryos):
-            bbox = embryo["bbox"]
+            bbox = embryo['bbox']
             x, y, w, h = bbox
             color = colors[i % len(colors)]
 
@@ -736,7 +713,7 @@ def _encode_image_base64(self, image: np.ndarray) -> str:
             buffered = BytesIO()
             pil_image.save(buffered, format="JPEG", quality=quality, optimize=True)
             if buffered.tell() <= max_bytes:
-                return base64.b64encode(buffered.getvalue()).decode("utf-8")
+                return base64.b64encode(buffered.getvalue()).decode('utf-8')
             quality -= 5
 
         # Last resort
@@ -745,21 +722,18 @@ def _encode_image_base64(self, image: np.ndarray) -> str:
         pil_image = pil_image.resize(new_size, Image.Resampling.LANCZOS)
         buffered = BytesIO()
         pil_image.save(buffered, format="JPEG", quality=85, optimize=True)
-        return base64.b64encode(buffered.getvalue()).decode("utf-8")
+        return base64.b64encode(buffered.getvalue()).decode('utf-8')
 
-    async def _review_with_claude(
-        self, image: np.ndarray, annotated: np.ndarray, embryos: list[dict]
-    ) -> dict:
+    async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, embryos: List[Dict]) -> Dict:
         """Round 1: Claude reviews detections (from test script)"""
         if not self.claude_client:
-            return {"false_positives": [], "false_negatives": []}
+            return {'false_positives': [], 'false_negatives': []}
 
         image_base64 = self._encode_image_base64(annotated)
 
-        prompt = f"""You are a microscopy expert analyzing embryo detections from a bottom
-camera view.
+        prompt = f"""You are a microscopy expert analyzing embryo detections from a bottom camera view.
 
-CURRENT DETECTIONS: {len(embryos)} embryos labeled 0-{len(embryos) - 1} with colored bounding boxes.
+CURRENT DETECTIONS: {len(embryos)} embryos labeled 0-{len(embryos)-1} with colored bounding boxes.
 
 EMBRYO CHARACTERISTICS:
 - Small, BRIGHT white/light gray oval or rice grain shapes
@@ -789,23 +763,14 @@ async def _review_with_claude(
             message = self.claude_client.messages.create(
                 model=settings.models.perception,
                 max_tokens=8000,
-                thinking={"type": "enabled", "budget_tokens": 5000},
-                messages=[
-                    {
-                        "role": "user",
-                        "content": [
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": "image/jpeg",
-                                    "data": image_base64,
-                                },
-                            },
-                            {"type": "text", "text": prompt},
-                        ],
-                    }
-                ],
+                output_config={"effort": "high"},  # was thinking budget_tokens (Opus 4.8 rejects it)
+                messages=[{
+                    "role": "user",
+                    "content": [
+                        {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_base64}},
+                        {"type": "text", "text": prompt}
+                    ]
+                }]
             )
 
             response_text = next((b.text for b in message.content if b.type == "text"), "")
@@ -822,19 +787,18 @@ async def _review_with_claude(
 
         except Exception as e:
             logger.warning("Claude review failed: %s", e)
-            return {"false_positives": [], "false_negatives": []}
+            return {'false_positives': [], 'false_negatives': []}
 
-    async def _verify_with_claude(
-        self, image: np.ndarray, annotated: np.ndarray, embryos: list[dict], previous_changes: dict
-    ) -> dict:
+    async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
+                                  embryos: List[Dict], previous_changes: Dict) -> Dict:
         """Round 2: Claude verifies corrections (from test script)"""
         if not self.claude_client:
-            return {"verified": True, "skipped": True}
+            return {'verified': True, 'skipped': True}
 
         image_base64 = self._encode_image_base64(annotated)
 
-        removed = previous_changes.get("removed", [])
-        added = previous_changes.get("added", [])
+        removed = previous_changes.get('removed', [])
+        added = previous_changes.get('added', [])
 
         prompt = f"""VERIFICATION ROUND - You previously reviewed this image.
 
@@ -842,7 +806,7 @@ async def _verify_with_claude(
 - Removed: {removed if removed else "none"}
 - Added: {added if added else "none"}
 
-CURRENT: {len(embryos)} detections (numbered 0-{len(embryos) - 1})
+CURRENT: {len(embryos)} detections (numbered 0-{len(embryos)-1})
 
 TASK: Verify corrections and catch any remaining issues.
 Only report CLEAR remaining problems.
@@ -859,23 +823,14 @@ async def _verify_with_claude(
             message = self.claude_client.messages.create(
                 model=settings.models.perception,
                 max_tokens=6000,
-                thinking={"type": "enabled", "budget_tokens": 4000},
-                messages=[
-                    {
-                        "role": "user",
-                        "content": [
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": "image/jpeg",
-                                    "data": image_base64,
-                                },
-                            },
-                            {"type": "text", "text": prompt},
-                        ],
-                    }
-                ],
+                output_config={"effort": "high"},  # was thinking budget_tokens (Opus 4.8 rejects it)
+                messages=[{
+                    "role": "user",
+                    "content": [
+                        {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_base64}},
+                        {"type": "text", "text": prompt}
+                    ]
+                }]
             )
 
             response_text = next((b.text for b in message.content if b.type == "text"), "")
@@ -891,41 +846,38 @@ async def _verify_with_claude(
 
         except Exception as e:
             logger.warning("Verification failed: %s", e)
-            return {"verified": False}
+            return {'verified': False}
 
-    def _apply_corrections(
-        self, embryos: list[dict], review: dict, image: np.ndarray, predictor
-    ) -> tuple[list[dict], dict]:
+    def _apply_corrections(self, embryos: List[Dict], review: Dict,
+                          image: np.ndarray, predictor) -> Tuple[List[Dict], Dict]:
         """Apply Claude's corrections (from test script)"""
         corrected = []
-        changes = {"removed": [], "added": []}
+        changes = {'removed': [], 'added': []}
 
         # Remove false positives
-        false_positives = set(review.get("false_positives", []))
+        false_positives = set(review.get('false_positives', []))
         if false_positives:
-            changes["removed"] = list(false_positives)
+            changes['removed'] = list(false_positives)
 
         for i, embryo in enumerate(embryos):
             if i not in false_positives:
                 corrected.append(embryo)
 
         # Add false negatives
-        false_negatives = review.get("false_negatives", [])
+        false_negatives = review.get('false_negatives', [])
         if false_negatives:
             for fn in false_negatives:
-                point = (fn["x"], fn["y"])
+                point = (fn['x'], fn['y'])
                 new_embryo = self._segment_with_sam(image, predictor, point)
 
-                if new_embryo and (
-                    self.min_area <= new_embryo["area"] <= self.max_area
-                    and new_embryo["circularity"] >= self.min_circularity
-                ):
+                if new_embryo and (self.min_area <= new_embryo['area'] <= self.max_area and
+                                   new_embryo['circularity'] >= self.min_circularity):
                     corrected.append(new_embryo)
-                    changes["added"].append(point)
+                    changes['added'].append(point)
 
         return corrected, changes
 
-    def _segment_with_sam(self, image: np.ndarray, predictor, point: tuple) -> dict | None:
+    def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optional[Dict]:
         """Use SAM predictor to segment region (from test script)"""
         image_rgb = self._to_rgb8(image)
         predictor.set_image(image_rgb)
@@ -934,7 +886,9 @@ def _segment_with_sam(self, image: np.ndarray, predictor, point: tuple) -> dict
         point_labels = np.array([1])
 
         masks, scores, _ = predictor.predict(
-            point_coords=point_coords, point_labels=point_labels, multimask_output=True
+            point_coords=point_coords,
+            point_labels=point_labels,
+            multimask_output=True
         )
 
         best_idx = np.argmax(scores)
@@ -949,33 +903,26 @@ def _segment_with_sam(self, image: np.ndarray, predictor, point: tuple) -> dict
         bbox = [x_min, y_min, x_max - x_min, y_max - y_min]
 
         area = mask.sum()
-        contours, _ = cv2.findContours(
-            mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
-        )
+        contours, _ = cv2.findContours(mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
 
         if len(contours) > 0:
             perimeter = cv2.arcLength(contours[0], True)
-            circularity = 4 * np.pi * area / (perimeter**2) if perimeter > 0 else 0
+            circularity = 4 * np.pi * area / (perimeter ** 2) if perimeter > 0 else 0
         else:
             circularity = 0
 
         return {
-            "mask": mask,
-            "bbox": bbox,
-            "area": int(area),
-            "circularity": float(circularity),
-            "stability_score": float(scores[best_idx]),
-            "predicted_iou": float(scores[best_idx]),
+            'mask': mask,
+            'bbox': bbox,
+            'area': int(area),
+            'circularity': float(circularity),
+            'stability_score': float(scores[best_idx]),
+            'predicted_iou': float(scores[best_idx])
         }
 
-    def _pixel_to_stage_coordinates(
-        self,
-        embryos: list[dict],
-        stage_pos: tuple[float, float],
-        pixel_size_um: float,
-        objective_mag: float,
-        image_shape: tuple[int, int] = (2048, 2048),
-    ) -> list[dict]:
+    def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[float, float],
+                                    pixel_size_um: float, objective_mag: float,
+                                    image_shape: Tuple[int, int] = (2048, 2048)) -> List[Dict]:
         """
         Convert pixel coordinates to stage coordinates.
 
@@ -991,7 +938,7 @@ def _pixel_to_stage_coordinates(
 
         embryo_positions = []
         for i, embryo in enumerate(embryos):
-            bbox = embryo["bbox"]
+            bbox = embryo['bbox']
             x, y, w, h = bbox
 
             center_x_px = x + w / 2
@@ -1006,26 +953,24 @@ def _pixel_to_stage_coordinates(
                 image_center_y=image_center_y,
                 stage_x=stage_x,
                 stage_y=stage_y,
-                um_per_pixel=effective_pixel_um,
+                um_per_pixel=effective_pixel_um
             )
 
-            embryo_positions.append(
-                {
-                    "embryo_id": f"embryo_{i + 1}",
-                    "pixel_x": float(center_x_px),
-                    "pixel_y": float(center_y_px),
-                    "stage_x_um": float(embryo_stage_x),
-                    "stage_y_um": float(embryo_stage_y),
-                    "bbox_pixel": tuple(bbox),
-                    "area_pixels": embryo.get("area_pixels", embryo.get("area", 0)),
-                    "circularity": embryo.get("circularity", 0),
-                    "confidence": embryo.get("confidence", embryo.get("stability_score", 0)),
-                }
-            )
+            embryo_positions.append({
+                'embryo_id': f'embryo_{i + 1}',
+                'pixel_x': float(center_x_px),
+                'pixel_y': float(center_y_px),
+                'stage_x_um': float(embryo_stage_x),
+                'stage_y_um': float(embryo_stage_y),
+                'bbox_pixel': tuple(bbox),
+                'area_pixels': embryo.get('area_pixels', embryo.get('area', 0)),
+                'circularity': embryo.get('circularity', 0),
+                'confidence': embryo.get('confidence', embryo.get('stability_score', 0))
+            })
 
         return embryo_positions
 
-    def show_in_napari(self, image: np.ndarray, embryos: list[dict], block: bool = False):
+    def show_in_napari(self, image: np.ndarray, embryos: List[Dict], block: bool = False):
         """Deprecated: napari display was retired in Phase 1.
 
         SAM detection results are now reviewed via the web map view —
diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index e154c724..29573e6a 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -10,12 +10,14 @@
 import logging
 import re
 import time
-from typing import Any
+from typing import Dict, List, Optional, Any
+
+from ..settings import settings
 
 logger = logging.getLogger(__name__)
 
 
-def _extend_tool_calls(out: list[dict[str, Any]], content_blocks) -> None:
+def _extend_tool_calls(out: List[Dict[str, Any]], content_blocks) -> None:
     """Append every tool_use block in content_blocks to out.
 
     Tolerates absent attributes (some SDK versions / mock objects) so it
@@ -27,13 +29,11 @@ def _extend_tool_calls(out: list[dict[str, Any]], content_blocks) -> None:
         try:
             if getattr(block, "type", None) != "tool_use":
                 continue
-            out.append(
-                {
-                    "name": getattr(block, "name", None),
-                    "input": getattr(block, "input", None),
-                    "id": getattr(block, "id", None),
-                }
-            )
+            out.append({
+                "name": getattr(block, "name", None),
+                "input": getattr(block, "input", None),
+                "id": getattr(block, "id", None),
+            })
         except Exception:
             continue
 
@@ -55,7 +55,7 @@ def __init__(self, client, model, tool_registry):
         self._tool_registry = tool_registry
 
         # Conversation state
-        self.conversation_history: list[dict] = []
+        self.conversation_history: List[Dict] = []
 
         # Token counters
         self.total_input_tokens: int = 0
@@ -76,9 +76,8 @@ def __init__(self, client, model, tool_registry):
 
     # ===== Quick Response =====
 
-    def try_quick_response(
-        self, message: str, experiment, mode: str, enter_plan_fn, exit_plan_fn
-    ) -> str | None:
+    def try_quick_response(self, message: str, experiment, mode: str,
+                           enter_plan_fn, exit_plan_fn) -> Optional[str]:
         """
         Answer simple queries from state without LLM call.
 
@@ -107,13 +106,7 @@ def try_quick_response(
             return experiment.get_summary()
 
         # Plan mode switching via natural language
-        plan_enter_phrases = (
-            "plan mode",
-            "enter plan",
-            "switch to plan",
-            "let's plan",
-            "design an experiment",
-        )
+        plan_enter_phrases = ("plan mode", "enter plan", "switch to plan", "let's plan", "design an experiment")
         plan_exit_phrases = ("exit plan", "leave plan", "back to run", "run mode")
 
         if mode != "plan" and any(p in message_lower for p in plan_enter_phrases):
@@ -149,36 +142,54 @@ def should_use_thinking(self, message: str, mode: str) -> bool:
         if mode == "plan":
             return True
 
+        import re
         msg_lower = message.lower()
 
-        if re.search(r"\bthink(ing)?\b", message, re.IGNORECASE):
+        if re.search(r'\bthink(ing)?\b', message, re.IGNORECASE):
             return True
-        if re.search(r"\bcalibrat", msg_lower):
+        if re.search(r'\bcalibrat', msg_lower):
             return True
-        if re.search(r"\b(plan|timelapse|time-lapse|acquisition)\b", msg_lower):
+        if re.search(r'\b(plan|timelapse|time-lapse|acquisition)\b', msg_lower):
             return True
-        if re.search(
-            r"\b(analy[sz]e|look at|check|inspect|review).*(image|volume|embryo)",
-            msg_lower,
-        ):
+        if re.search(r'\b(analy[sz]e|look at|check|inspect|review).*(image|volume|embryo)', msg_lower):
             return True
-        if re.search(r"\b(all|every|each)\s+(embryo|sample)", msg_lower):
+        if re.search(r'\b(all|every|each)\s+(embryo|sample)', msg_lower):
             return True
-        if re.search(
-            r"\b(first|then|after|next|finally)\b.*\b(first|then|after|next|finally)\b",
-            msg_lower,
-        ):
+        if re.search(r'\b(first|then|after|next|finally)\b.*\b(first|then|after|next|finally)\b', msg_lower):
             return True
-        if re.search(r"\b(why|problem|issue|error|wrong|fail|debug|troubleshoot)", msg_lower):
+        if re.search(r'\b(why|problem|issue|error|wrong|fail|debug|troubleshoot)', msg_lower):
             return True
 
         return False
 
     # ===== Non-Streaming API Call =====
 
-    async def call_claude(
-        self, user_message: str, system_prompt, tools, mode: str, auto_save_fn
-    ) -> str:
+    async def _create_with_refusal_fallback(self, api_kwargs):
+        """messages.create with main-tier resilience: if the model rejects the
+        request with a 400 (e.g. Fable 5 under <30-day org data retention, or
+        unavailable) OR declines it (stop_reason="refusal", empty content), retry
+        the SAME request once on the fallback model (Opus 4.8) — so gently keeps
+        working whether or not Fable 5 is currently serviceable. The moment the
+        org retention is fixed, Fable 5 serves with no code change."""
+        from anthropic import BadRequestError
+        fb = settings.models.refusal_fallback
+        model = api_kwargs.get("model")
+        try:
+            response = await self._call_api_with_retry(self.claude.messages.create, **api_kwargs)
+        except BadRequestError:
+            if not fb or fb == model:
+                raise
+            logger.warning("Model %s rejected the request (400); falling back to %s", model, fb)
+            return await self._call_api_with_retry(self.claude.messages.create, **{**api_kwargs, "model": fb})
+        if response.stop_reason == "refusal" and fb and fb != model:
+            logger.warning("Model %s declined the turn; retrying on %s", model, fb)
+            response = await self._call_api_with_retry(
+                self.claude.messages.create, **{**api_kwargs, "model": fb}
+            )
+        return response
+
+    async def call_claude(self, user_message: str, system_prompt, tools,
+                          mode: str, auto_save_fn) -> str:
         """
         Call Claude API with full context and tool access (non-streaming).
 
@@ -210,8 +221,8 @@ async def call_claude(
             interaction = self.interaction_logger.start_interaction(
                 user_prompt=user_message,
                 system_state={
-                    "acquisition_status": "unknown",
-                },
+                    'acquisition_status': 'unknown',
+                }
             )
 
         # Snapshot inputs for decision capture BEFORE the tool loop starts
@@ -222,15 +233,13 @@ async def call_claude(
         if self.decision_log is not None:
             try:
                 from gently.eval import prompt_hash as _prompt_hash
-
                 decision_prompt_hash = _prompt_hash(
-                    system_prompt,
-                    list(self.conversation_history),
+                    system_prompt, list(self.conversation_history),
                 )
             except Exception:
                 logger.exception("Failed to compute decision prompt_hash")
 
-        tool_calls_collected: list[dict[str, Any]] = []
+        tool_calls_collected: List[Dict[str, Any]] = []
         assistant_message = ""
         error_occurred = None
 
@@ -243,38 +252,51 @@ async def call_claude(
                 "max_tokens": 16000 if use_thinking else 4096,
             }
             if use_thinking:
-                budget = 30000 if mode == "plan" else 10000
-                api_kwargs["thinking"] = {"type": "enabled", "budget_tokens": budget}
+                # Fable 5 / Opus 4.8 reject thinking budget_tokens (400) — thinking
+                # is adaptive; control depth via effort instead of a token budget.
+                api_kwargs["output_config"] = {"effort": "high" if mode == "plan" else "medium"}
 
-            response = await self._call_api_with_retry(self.claude.messages.create, **api_kwargs)
+            response = await self._create_with_refusal_fallback(api_kwargs)
             self._track_token_usage(response)
             _extend_tool_calls(tool_calls_collected, response.content)
 
             # Process tool calls
             while response.stop_reason == "tool_use":
-                tool_results = await self._execute_tools_with_logging(response.content, interaction)
+                tool_results = await self._execute_tools_with_logging(
+                    response.content, interaction
+                )
 
-                self.conversation_history.append({"role": "assistant", "content": response.content})
-                self.conversation_history.append({"role": "user", "content": tool_results})
+                self.conversation_history.append({
+                    "role": "assistant",
+                    "content": response.content
+                })
+                self.conversation_history.append({
+                    "role": "user",
+                    "content": tool_results
+                })
 
                 api_kwargs["messages"] = self.conversation_history
-                response = await self._call_api_with_retry(
-                    self.claude.messages.create, **api_kwargs
-                )
+                response = await self._create_with_refusal_fallback(api_kwargs)
                 self._track_token_usage(response)
                 _extend_tool_calls(tool_calls_collected, response.content)
 
-            # Extract text response
-            assistant_message = ""
-            for block in response.content:
-                if hasattr(block, "text"):
-                    assistant_message += block.text
+            # Extract text response. Fable 5 may refuse (stop_reason="refusal")
+            # with empty content — surface it instead of returning blank.
+            if response.stop_reason == "refusal":
+                assistant_message = "(The request was declined by the model's safety system. Try rephrasing.)"
+            else:
+                assistant_message = ""
+                for block in response.content:
+                    if hasattr(block, 'text'):
+                        assistant_message += block.text
 
-            self.conversation_history.append({"role": "assistant", "content": response.content})
+            self.conversation_history.append({
+                "role": "assistant",
+                "content": response.content
+            })
 
         except Exception as e:
             import traceback
-
             error_occurred = str(e)
             error_tb = traceback.format_exc()
             assistant_message = f"Error: {error_occurred}"
@@ -321,11 +343,11 @@ def _write_production_decision(
         self,
         *,
         user_message: str,
-        tool_calls: list[dict[str, Any]],
+        tool_calls: List[Dict[str, Any]],
         response_text: str,
         duration_ms: float,
-        prompt_hash_value: str | None,
-        error: str | None,
+        prompt_hash_value: Optional[str],
+        error: Optional[str],
     ) -> None:
         """Persist one production Decision row (best-effort).
 
@@ -337,28 +359,24 @@ def _write_production_decision(
             return
         try:
             from datetime import datetime
-
             from gently.eval import Decision, DecisionTrigger
-
-            self.decision_log.append(
-                Decision(
-                    timestamp=datetime.now(),
-                    agent="production",
-                    trigger=DecisionTrigger.USER_MESSAGE,
-                    trigger_detail=(user_message or "")[:200],
-                    tool_calls=tool_calls,
-                    response_text=response_text,
-                    prompt_hash=prompt_hash_value,
-                    duration_ms=duration_ms,
-                    error=error,
-                )
-            )
+            self.decision_log.append(Decision(
+                timestamp=datetime.now(),
+                agent="production",
+                trigger=DecisionTrigger.USER_MESSAGE,
+                trigger_detail=(user_message or "")[:200],
+                tool_calls=tool_calls,
+                response_text=response_text,
+                prompt_hash=prompt_hash_value,
+                duration_ms=duration_ms,
+                error=error,
+            ))
         except Exception:
             logger.exception("Failed to write production Decision")
 
     # ===== Dry-Run Tool Call (Benchmarking) =====
 
-    async def get_tool_call(self, user_message: str, system_prompt, tools) -> dict | None:
+    async def get_tool_call(self, user_message: str, system_prompt, tools) -> Optional[Dict]:
         """
         Get what tool Claude would call without executing it (dry-run mode).
 
@@ -381,7 +399,10 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> dict |
         start_time = time.time()
 
         messages = self.conversation_history.copy()
-        messages.append({"role": "user", "content": user_message})
+        messages.append({
+            "role": "user",
+            "content": user_message
+        })
 
         try:
             api_kwargs = {
@@ -392,13 +413,19 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> dict |
                 "max_tokens": 4096,
             }
 
-            response = await self._call_api_with_retry(self.claude.messages.create, **api_kwargs)
+            response = await self._call_api_with_retry(
+                self.claude.messages.create,
+                **api_kwargs
+            )
 
             latency_ms = (time.time() - start_time) * 1000
 
-            input_tokens = getattr(response.usage, "input_tokens", 0)
-            output_tokens = getattr(response.usage, "output_tokens", 0)
+            input_tokens = getattr(response.usage, 'input_tokens', 0)
+            output_tokens = getattr(response.usage, 'output_tokens', 0)
 
+            # A refusal returns empty content — treat as "no tool call".
+            if response.stop_reason == "refusal" or not response.content:
+                return None
             for block in response.content:
                 if block.type == "tool_use":
                     return {
@@ -417,7 +444,7 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> dict |
 
     # ===== Tool Execution =====
 
-    async def _execute_tools_with_logging(self, content_blocks, interaction) -> list[dict]:
+    async def _execute_tools_with_logging(self, content_blocks, interaction) -> List[Dict]:
         """
         Execute Claude's tool calls with interaction logging.
 
@@ -449,10 +476,7 @@ async def _execute_tools_with_logging(self, content_blocks, interaction) -> list
                     if self.choice_handler and isinstance(result, str):
                         try:
                             choice_data = json.loads(result)
-                            if (
-                                isinstance(choice_data, dict)
-                                and choice_data.get("_type") == CHOICE_RESPONSE_TYPE
-                            ):
+                            if isinstance(choice_data, dict) and choice_data.get("_type") == CHOICE_RESPONSE_TYPE:
                                 user_selection = await self.choice_handler(choice_data)
                                 result = user_selection
                         except (json.JSONDecodeError, TypeError):
@@ -476,20 +500,19 @@ async def _execute_tools_with_logging(self, content_blocks, interaction) -> list
                         error_message=error_message,
                     )
 
-                results.append(
-                    {
-                        "type": "tool_result",
-                        "tool_use_id": block.id,
-                        "content": result,
-                        "is_error": is_error,
-                    }
-                )
+                results.append({
+                    "type": "tool_result",
+                    "tool_use_id": block.id,
+                    "content": result,
+                    "is_error": is_error,
+                })
 
         return results
 
     # ===== Streaming API Call =====
 
-    async def call_claude_stream(self, system_prompt, tools, tool_label_fn, auto_save_fn):
+    async def call_claude_stream(self, system_prompt, tools,
+                                 tool_label_fn, auto_save_fn):
         """
         Call Claude API with streaming enabled.
 
@@ -509,24 +532,31 @@ async def call_claude_stream(self, system_prompt, tools, tool_label_fn, auto_sav
         dict
             Chunks as they arrive from Claude
         """
-        from anthropic import APIStatusError
-
-        def stream_and_collect():
-            events = []
-            final_message = None
-
-            with self.claude.messages.stream(
-                model=self.model,
-                system=system_prompt,
-                messages=self.conversation_history,
-                tools=tools,
-                max_tokens=4096,
-            ) as stream:
-                for event in stream:
-                    events.append(event)
-                final_message = stream.get_final_message()
-
-            return events, final_message
+        from anthropic import APIStatusError, BadRequestError
+
+        def stream_and_collect(model):
+            def _run(m):
+                events = []
+                with self.claude.messages.stream(
+                    model=m,
+                    system=system_prompt,
+                    messages=self.conversation_history,
+                    tools=tools,
+                    max_tokens=4096
+                ) as stream:
+                    for event in stream:
+                        events.append(event)
+                    return events, stream.get_final_message()
+            try:
+                return _run(model)
+            except BadRequestError:
+                # Fable 5 under <30-day org data retention (or unavailable) rejects
+                # with a 400 — fall back to Opus 4.8 so the turn still streams.
+                fb = settings.models.refusal_fallback
+                if not fb or fb == model:
+                    raise
+                logger.warning("Stream model %s rejected the request (400); falling back to %s", model, fb)
+                return _run(fb)
 
         # Run streaming in thread with retry logic
         max_retries = 3
@@ -534,61 +564,66 @@ def stream_and_collect():
 
         for attempt in range(max_retries):
             try:
-                events, final_message = await asyncio.to_thread(stream_and_collect)
+                events, final_message = await asyncio.to_thread(stream_and_collect, self.model)
                 self._track_token_usage(final_message)
                 break
             except APIStatusError as e:
-                error_type = getattr(e, "body", {})
+                error_type = getattr(e, 'body', {})
                 if isinstance(error_type, dict):
-                    error_type = error_type.get("error", {}).get("type", "")
+                    error_type = error_type.get('error', {}).get('type', '')
 
-                if (
-                    error_type in ("overloaded_error", "rate_limit_error")
-                    or "overloaded" in str(e).lower()
-                ):
+                if error_type in ('overloaded_error', 'rate_limit_error') or 'overloaded' in str(e).lower():
                     if attempt < max_retries - 1:
-                        wait_time = retry_delay * (2**attempt)
-                        logger.warning(
-                            f"API overloaded, retrying in {wait_time:.1f}s"
-                            f" (attempt {attempt + 1}/{max_retries})"
-                        )
-                        yield {
-                            "type": "text",
-                            "text": f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n",
-                        }
+                        wait_time = retry_delay * (2 ** attempt)
+                        logger.warning(f"API overloaded, retrying in {wait_time:.1f}s (attempt {attempt + 1}/{max_retries})")
+                        yield {'type': 'text', 'text': f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n"}
                         await asyncio.sleep(wait_time)
                         continue
                 raise
         else:
             raise RuntimeError("API overloaded after multiple retries")
 
-        # Diagnostic: log stop_reason and tool block counts
+        # Refusal → retry the whole streamed turn on the fallback model (Opus 4.8)
+        # before giving up. The original partial output is discarded (we re-collect
+        # and only yield the fallback's events below).
+        fb = settings.models.refusal_fallback
+        if final_message.stop_reason == "refusal" and fb and fb != self.model:
+            logger.warning("Model %s declined the streamed turn; retrying on %s", self.model, fb)
+            events, final_message = await asyncio.to_thread(stream_and_collect, fb)
+            self._track_token_usage(final_message)
+
+        # Last resort: if even the fallback declined, surface it and stop —
+        # discard any partial, don't iterate empty content or process tools.
+        if final_message.stop_reason == "refusal":
+            logger.warning("Claude declined the request (model=%s)", self.model)
+            yield {'type': 'text', 'text': "(The request was declined by the model's safety system. Try rephrasing.)"}
+            return
+
+        # Diagnostic: per-response counts. DEBUG, not WARNING — stop_reason=tool_use
+        # with matching tool blocks is normal; the genuine anomaly is the
+        # logger.error below (tool blocks present but stop_reason != tool_use).
         tool_block_count = sum(
-            1 for b in final_message.content if hasattr(b, "type") and b.type == "tool_use"
+            1 for b in final_message.content
+            if hasattr(b, 'type') and b.type == 'tool_use'
         )
-        logger.warning(
-            "Claude response: stop_reason=%s, content_blocks=%d, tool_use_blocks=%d,"
-            " tools_passed=%d, model=%s",
-            final_message.stop_reason,
-            len(final_message.content),
-            tool_block_count,
-            len(tools),
-            self.model,
+        logger.debug(
+            "Claude response: stop_reason=%s, content_blocks=%d, tool_use_blocks=%d, tools_passed=%d, model=%s",
+            final_message.stop_reason, len(final_message.content),
+            tool_block_count, len(tools), self.model,
         )
         if tool_block_count > 0 and final_message.stop_reason != "tool_use":
             logger.error(
                 "BUG: Claude returned %d tool_use blocks but stop_reason=%s (expected 'tool_use')",
-                tool_block_count,
-                final_message.stop_reason,
+                tool_block_count, final_message.stop_reason,
             )
 
         # Process events and yield text
         full_text = []
         for event in events:
             if event.type == "content_block_delta":
-                if hasattr(event.delta, "text"):
+                if hasattr(event.delta, 'text'):
                     full_text.append(event.delta.text)
-                    yield {"type": "text", "text": event.delta.text}
+                    yield {'type': 'text', 'text': event.delta.text}
 
         # Detect fake XML tool calls in text (Claude writing tool_use as text)
         joined_text = "".join(full_text)
@@ -596,8 +631,7 @@ def stream_and_collect():
             logger.error(
                 "DETECTED: Claude wrote XML tool tags as plain text instead of "
                 "using API tool_use mechanism. stop_reason=%s, text_preview=%.200s",
-                final_message.stop_reason,
-                joined_text[:200],
+                final_message.stop_reason, joined_text[:200],
             )
 
         response_content = final_message.content
@@ -611,14 +645,14 @@ def stream_and_collect():
 
             tool_results = []
             for block in response_content:
-                if hasattr(block, "type") and block.type == "tool_use":
+                if hasattr(block, 'type') and block.type == "tool_use":
                     start_time = time.time()
 
                     yield {
-                        "type": "tool_start",
-                        "tool_name": block.name,
-                        "tool_input": block.input,
-                        "tool_label": tool_label_fn(block.name, block.input),
+                        'type': 'tool_start',
+                        'tool_name': block.name,
+                        'tool_input': block.input,
+                        'tool_label': tool_label_fn(block.name, block.input),
                     }
 
                     is_error_flag = False
@@ -628,44 +662,32 @@ def stream_and_collect():
 
                         if isinstance(tool_result, str):
                             try:
-                                from gently.app.tools.interaction_tools import (
-                                    CHOICE_RESPONSE_TYPE,
-                                )
-
+                                from gently.app.tools.interaction_tools import CHOICE_RESPONSE_TYPE
                                 choice_data = json.loads(tool_result)
-                                if (
-                                    isinstance(choice_data, dict)
-                                    and choice_data.get("_type") == CHOICE_RESPONSE_TYPE
-                                ):
+                                if isinstance(choice_data, dict) and choice_data.get("_type") == CHOICE_RESPONSE_TYPE:
                                     user_selection = yield {
-                                        "type": "choice_request",
-                                        "choice_data": choice_data,
+                                        'type': 'choice_request',
+                                        'choice_data': choice_data
                                     }
                                     tool_result = user_selection or "cancelled"
                             except (json.JSONDecodeError, TypeError):
                                 pass
 
-                        result_text = (
-                            tool_result if isinstance(tool_result, str) else str(tool_result)
-                        )
-                        tool_results.append(
-                            {
-                                "type": "tool_result",
-                                "tool_use_id": block.id,
-                                "content": tool_result,
-                            }
-                        )
+                        result_text = tool_result if isinstance(tool_result, str) else str(tool_result)
+                        tool_results.append({
+                            "type": "tool_result",
+                            "tool_use_id": block.id,
+                            "content": tool_result
+                        })
                     except Exception as e:
                         is_error_flag = True
                         result_text = f"Error: {str(e)}"
-                        tool_results.append(
-                            {
-                                "type": "tool_result",
-                                "tool_use_id": block.id,
-                                "content": result_text,
-                                "is_error": True,
-                            }
-                        )
+                        tool_results.append({
+                            "type": "tool_result",
+                            "tool_use_id": block.id,
+                            "content": result_text,
+                            "is_error": True
+                        })
 
                     # First non-empty line of the result, trimmed — gives the chat
                     # UI a one-line summary so the operator can see what a tool did
@@ -678,16 +700,22 @@ def stream_and_collect():
                         result_summary = result_summary[:139] + "…"
 
                     yield {
-                        "type": "tool_call",
-                        "tool_name": block.name,
-                        "tool_input": block.input,
-                        "duration": time.time() - start_time,
-                        "result_summary": result_summary,
-                        "is_error": is_error_flag,
+                        'type': 'tool_call',
+                        'tool_name': block.name,
+                        'tool_input': block.input,
+                        'duration': time.time() - start_time,
+                        'result_summary': result_summary,
+                        'is_error': is_error_flag,
                     }
 
-            self.conversation_history.append({"role": "assistant", "content": response_content})
-            self.conversation_history.append({"role": "user", "content": tool_results})
+            self.conversation_history.append({
+                "role": "assistant",
+                "content": response_content
+            })
+            self.conversation_history.append({
+                "role": "user",
+                "content": tool_results
+            })
 
             auto_save_fn()
 
@@ -709,12 +737,15 @@ def stream_and_collect():
 
         else:
             # No tool calls - add final message to history
-            self.conversation_history.append({"role": "assistant", "content": response_content})
+            self.conversation_history.append({
+                "role": "assistant",
+                "content": response_content
+            })
             auto_save_fn()
 
     # ===== Tool Label =====
 
-    def tool_label(self, tool_name: str, tool_input: dict) -> str:
+    def tool_label(self, tool_name: str, tool_input: Dict) -> str:
         """Build a human-readable label for a tool call.
 
         Used in tool_start chunks so the TUI shows biologist-friendly
@@ -728,13 +759,8 @@ def tool_label(self, tool_name: str, tool_input: dict) -> str:
             campaign = self.context_store.get_campaign(campaign_id)
             if campaign:
                 campaign_label = campaign.shorthand or campaign.description
-                if tool_name in (
-                    "propose_plan",
-                    "get_plan_status",
-                    "export_plan",
-                    "snapshot_plan",
-                    "list_plan_versions",
-                ):
+                if tool_name in ("propose_plan", "get_plan_status", "export_plan",
+                                 "snapshot_plan", "list_plan_versions"):
                     return campaign_label
                 if tool_name == "create_campaign" and inp.get("parent_id"):
                     return f"phase under {campaign_label}"
@@ -752,12 +778,8 @@ def tool_label(self, tool_name: str, tool_input: dict) -> str:
 
         # Item reference tools
         item_ref = inp.get("item_ref") or inp.get("ref") or inp.get("item_id")
-        if item_ref and tool_name in (
-            "get_plan_item",
-            "update_plan_item",
-            "delete_plan_item",
-            "move_plan_item",
-        ):
+        if item_ref and tool_name in ("get_plan_item", "update_plan_item",
+                                       "delete_plan_item", "move_plan_item"):
             if self.context_store:
                 item = self.context_store.resolve_plan_item(str(item_ref), campaign_id=campaign_id)
                 if item:
@@ -784,9 +806,8 @@ def tool_label(self, tool_name: str, tool_input: dict) -> str:
 
         return ""
 
-    async def _execute_single_tool(
-        self, tool_name: str, tool_input: dict, context: dict | None = None
-    ) -> str:
+    async def _execute_single_tool(self, tool_name: str, tool_input: Dict,
+                                   context: Optional[Dict] = None) -> str:
         """Execute a single tool call using the tool registry.
 
         Parameters
@@ -806,13 +827,13 @@ async def _execute_single_tool(
 
     def _track_token_usage(self, response):
         """Track token usage from API response, including cache metrics."""
-        if hasattr(response, "usage"):
+        if hasattr(response, 'usage'):
             usage = response.usage
             self.total_input_tokens += usage.input_tokens
             self.total_output_tokens += usage.output_tokens
             self.api_call_count += 1
-            self.cache_creation_tokens += getattr(usage, "cache_creation_input_tokens", 0)
-            self.cache_read_tokens += getattr(usage, "cache_read_input_tokens", 0)
+            self.cache_creation_tokens += getattr(usage, 'cache_creation_input_tokens', 0)
+            self.cache_read_tokens += getattr(usage, 'cache_read_input_tokens', 0)
 
     @property
     def current_context_tokens(self) -> int:
@@ -823,14 +844,14 @@ def current_context_tokens(self) -> int:
 
         conv_chars = 0
         for msg in self.conversation_history:
-            content = msg.get("content", "")
+            content = msg.get('content', '')
             if isinstance(content, str):
                 conv_chars += len(content)
             elif isinstance(content, list):
                 for block in content:
                     if isinstance(block, dict):
-                        conv_chars += len(str(block.get("text", "")))
-                    elif hasattr(block, "text"):
+                        conv_chars += len(str(block.get('text', '')))
+                    elif hasattr(block, 'text'):
                         conv_chars += len(str(block.text))
                     else:
                         conv_chars += len(str(block))
@@ -896,22 +917,19 @@ async def _call_api_with_retry(self, api_func, *args, max_retries=3, **kwargs):
             try:
                 return await asyncio.to_thread(api_func, *args, **kwargs)
             except APIStatusError as e:
-                error_type = getattr(e, "body", {})
+                error_type = getattr(e, 'body', {})
                 if isinstance(error_type, dict):
-                    error_type = error_type.get("error", {}).get("type", "")
+                    error_type = error_type.get('error', {}).get('type', '')
 
                 is_retryable = (
-                    error_type in ("overloaded_error", "rate_limit_error")
-                    or "overloaded" in str(e).lower()
-                    or "rate_limit" in str(e).lower()
+                    error_type in ('overloaded_error', 'rate_limit_error') or
+                    'overloaded' in str(e).lower() or
+                    'rate_limit' in str(e).lower()
                 )
 
                 if is_retryable and attempt < max_retries - 1:
-                    wait_time = retry_delay * (2**attempt)
-                    logger.warning(
-                        f"API error ({error_type}), retrying in {wait_time:.1f}s"
-                        f" (attempt {attempt + 1}/{max_retries})"
-                    )
+                    wait_time = retry_delay * (2 ** attempt)
+                    logger.warning(f"API error ({error_type}), retrying in {wait_time:.1f}s (attempt {attempt + 1}/{max_retries})")
                     await asyncio.sleep(wait_time)
                     continue
 
diff --git a/gently/settings.py b/gently/settings.py
index d197bc0d..33254621 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -4,7 +4,6 @@
 All configurable values live here. Override via environment variables
 prefixed with GENTLY_ (e.g., GENTLY_VIZ_PORT=9090).
 """
-
 import os
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -30,7 +29,6 @@ def _env(key: str, default):
 @dataclass(frozen=True)
 class NetworkSettings:
     """Ports, hosts, and bind addresses."""
-
     viz_port: int = field(default_factory=lambda: _env("VIZ_PORT", 8080))
     viz_host: str = field(default_factory=lambda: _env("VIZ_HOST", "0.0.0.0"))
     device_port: int = field(default_factory=lambda: _env("DEVICE_PORT", 60610))
@@ -42,10 +40,7 @@ class NetworkSettings:
 @dataclass(frozen=True)
 class MeshSettings:
     """Mesh networking parameters."""
-
-    broadcast_interval_s: float = field(
-        default_factory=lambda: _env("MESH_BROADCAST_INTERVAL", 5.0)
-    )
+    broadcast_interval_s: float = field(default_factory=lambda: _env("MESH_BROADCAST_INTERVAL", 5.0))
     replay_window_s: float = field(default_factory=lambda: _env("MESH_REPLAY_WINDOW", 30.0))
     reaper_interval_s: float = field(default_factory=lambda: _env("MESH_REAPER_INTERVAL", 10.0))
     status_refresh_s: float = field(default_factory=lambda: _env("MESH_STATUS_REFRESH", 30.0))
@@ -56,20 +51,40 @@ class MeshSettings:
 
 @dataclass(frozen=True)
 class ModelSettings:
-    """Claude model identifiers."""
-
-    main: str = field(default_factory=lambda: _env("MODEL_MAIN", "claude-opus-4-6"))
-    perception: str = field(
-        default_factory=lambda: _env("MODEL_PERCEPTION", "claude-opus-4-5-20251101")
-    )
-    fast: str = field(default_factory=lambda: _env("MODEL_FAST", "claude-haiku-4-5-20251001"))
-    medium: str = field(default_factory=lambda: _env("MODEL_MEDIUM", "claude-sonnet-4-5-20250929"))
+    """Claude model identifiers — the single source of truth for every tier.
+
+    Tiers are split by role; capability-first per the latest models:
+      - main:       Claude Fable 5 ($10/$50 per MTok). Per-user-turn reasoning +
+                    tool orchestration (plan mode) and the dopaminergic classifier
+                    stage. Always-on thinking (no thinking budget — control depth
+                    via output_config.effort), ~30%-heavier tokenizer, may refuse
+                    (stop_reason="refusal", empty content); needs ≥30-day org
+                    data retention.
+      - perception: Opus 4.8 (high-res vision, $5/$25). Highest-frequency tier
+                    (per timepoint); Opus-tier vision for perception accuracy.
+      - medium:     Opus 4.8. Onboarding / wizard summaries.
+      - fast:       Sonnet 4.6 ($3/$15). The cheaper/faster tier — drives the
+                    verifier's parallel ensemble (ensemble_size calls per
+                    verification) and blank-image / summary checks.
+
+    API note: Fable 5 and Opus 4.8 reject thinking budget_tokens and sampling
+    params (temperature/top_p/top_k) — adaptive thinking only, depth via effort.
+    Sonnet 4.6 supports adaptive thinking. No assistant prefills anywhere (4.6+
+    family rejects them).
+    """
+    main: str = field(default_factory=lambda: _env("MODEL_MAIN", "claude-fable-5"))
+    perception: str = field(default_factory=lambda: _env("MODEL_PERCEPTION", "claude-opus-4-8"))
+    fast: str = field(default_factory=lambda: _env("MODEL_FAST", "claude-sonnet-4-6"))
+    medium: str = field(default_factory=lambda: _env("MODEL_MEDIUM", "claude-opus-4-8"))
+    # When the main tier (Fable 5) declines a turn (stop_reason="refusal"), the
+    # main-tier calls transparently retry it on this model instead of surfacing
+    # the refusal. Empty disables the fallback.
+    refusal_fallback: str = field(default_factory=lambda: _env("MODEL_REFUSAL_FALLBACK", "claude-opus-4-8"))
 
 
 @dataclass(frozen=True)
 class StorageSettings:
     """File paths for data storage."""
-
     base_path: Path = field(default_factory=lambda: _env("STORAGE_PATH", Path("D:/Gently3")))
 
     @property
@@ -84,7 +99,6 @@ def traces_dir(self) -> Path:
 @dataclass(frozen=True)
 class TimeoutSettings:
     """Timeout values in seconds."""
-
     plan_execution: int = field(default_factory=lambda: _env("TIMEOUT_PLAN", 300))
     rpc_call: int = field(default_factory=lambda: _env("TIMEOUT_RPC", 60))
     volume_acquisition: int = field(default_factory=lambda: _env("TIMEOUT_VOLUME", 15))
@@ -94,7 +108,6 @@ class TimeoutSettings:
 @dataclass(frozen=True)
 class ApiSettings:
     """External API configuration."""
-
     ncbi_tool: str = field(default_factory=lambda: _env("NCBI_TOOL", "gently"))
     ncbi_email: str = field(default_factory=lambda: _env("NCBI_EMAIL", "pskeshu@gmail.com"))
 
@@ -102,7 +115,6 @@ class ApiSettings:
 @dataclass(frozen=True)
 class MlSettings:
     """Machine learning training parameters."""
-
     model_cache_dir: Path = field(default_factory=lambda: _env("ML_MODEL_CACHE", Path("models")))
     default_batch_size: int = field(default_factory=lambda: _env("ML_BATCH_SIZE", 32))
     default_epochs: int = field(default_factory=lambda: _env("ML_EPOCHS", 50))
@@ -112,12 +124,9 @@ class MlSettings:
 @dataclass(frozen=True)
 class TransferSettings:
     """Bulk transfer protocol parameters."""
-
     transfer_port: int = field(default_factory=lambda: _env("TRANSFER_PORT", 19548))
     chunk_size: int = field(default_factory=lambda: _env("TRANSFER_CHUNK_SIZE", 1048576))  # 1MB
-    max_concurrent_transfers: int = field(
-        default_factory=lambda: _env("TRANSFER_MAX_CONCURRENT", 4)
-    )
+    max_concurrent_transfers: int = field(default_factory=lambda: _env("TRANSFER_MAX_CONCURRENT", 4))
 
 
 @dataclass(frozen=True)
@@ -133,7 +142,6 @@ class UISettings:
 @dataclass(frozen=True)
 class Settings:
     """Top-level settings container."""
-
     network: NetworkSettings = field(default_factory=NetworkSettings)
     mesh: MeshSettings = field(default_factory=MeshSettings)
     models: ModelSettings = field(default_factory=ModelSettings)
diff --git a/gently/ui/web/connection_manager.py b/gently/ui/web/connection_manager.py
index 11cc3fe4..00aeaef2 100644
--- a/gently/ui/web/connection_manager.py
+++ b/gently/ui/web/connection_manager.py
@@ -158,7 +158,10 @@ async def broadcast(self, message: dict):
                 try:
                     await connection.send_text(message_json)
                 except Exception as e:
-                    logger.warning(f"Failed to send to websocket: {e}")
+                    # Expected when a client disconnects/reloads mid-broadcast
+                    # (send after websocket.close). The connection is dropped
+                    # below, so this is debug-level, not a warning.
+                    logger.debug("Dropping a websocket that errored on send (client likely gone): %s", e)
                     disconnected.append(connection)
 
             # Remove disconnected clients
diff --git a/gently/ui/web/routes/chat.py b/gently/ui/web/routes/chat.py
index 8c66dd45..1fffcb7f 100644
--- a/gently/ui/web/routes/chat.py
+++ b/gently/ui/web/routes/chat.py
@@ -20,10 +20,12 @@
 from pydantic import BaseModel
 
 from gently.ui.web.auth import require_control
+from gently.settings import settings
 
 logger = logging.getLogger(__name__)
 
-CHAT_MODEL = "claude-opus-4-7"
+# Per-timepoint VLM chat → perception tier (Opus 4.8); centralized, not hardcoded.
+CHAT_MODEL = settings.models.perception
 SYSTEM_PROMPT = (
     "You are helping a biologist interpret a microscopy perception "
     "assessment of a C. elegans embryo at a specific timepoint. You can "

From 0457975b0fa9434cb3a9f63ecc5663083b648c4d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Fri, 12 Jun 2026 19:52:35 +0530
Subject: [PATCH 103/314] Add UX v2 landing screenshot for the PR

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 screenshots/ux-v2-landing.png | Bin 0 -> 299550 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 screenshots/ux-v2-landing.png

diff --git a/screenshots/ux-v2-landing.png b/screenshots/ux-v2-landing.png
new file mode 100644
index 0000000000000000000000000000000000000000..62502ce3dfe59b147cb61f8aa119e4e87b907228
GIT binary patch
literal 299550
zcmXt<Q*>rsvxQ@JY}-c1wr$(CopfyDjcs@E#<p$SM)&#pALHEan>}{zv1-owRIMl_
z1xW-rTsROA5Cmx{F%=LHC?OCK@G}^&|DM3&lrDjQAcIJY39EVKUIF#%8GucMYCm5D
zs6a`Bg<yVzkc9m{Oy8YWggHQrf)7C_ML{M<mHs`3_0IKq1(axvxNf?fbm-dTKhe7-
ze4bgY)=+G}taM4+v|n}k`=|cThvHo!(sx8;WPBCzRVn<nd;yT$^r1}~8`}xbdILA&
zC3v18Z<q|PYgh@uD54&=-P;}KQPupbX9Q7J4E9)Yk|e_XPqCh~y5Uy}%%Z!~Gs>Mi
zx8eBp<fXbvQjSB45^K%|(*0ANZ*Jc+o<f48LA}d5Wi2>?Tbx-m77X5BIVl5D?6f28
zf<26Z0{{6uR4Rr&Ic)O!27-gA2AtgbGLu}%7ds&4-q(BJz1+Tdk|e+3_0;p~kC{<$
zgtj0>k7};cQ(Gp2wZgZfLPPFZN3UeJxVX;m%*sLpT}HmV7#O*~qX3SEqqR$eKd?{q
zCQW~Nzv}5Q1O=4D;3P72c{lLhJD(-APZVZ$v|=%gXBaYJct%ux{+|CDuImZ<buAcr
zDYA<`fNik)jiERDalGr(Re8x^v-ONBoKY`%eacAp#{Xa~UtZ_wv!ZwVTyXBpg2;uG
z^;j{-MuV-HLdDtJ`jW)&D`KcUb53`YhfA^1yqv%Xea-X`a0Eg4_qcfv+49TJ`Py)V
zUgv}{VSZp<^>z+Sa}JK~ok}3+wGS&HAF>AN+k!f-`Ip;Z%vmMn=^P-b5yBD_YR9M(
zjTzT|m<*Q}lG5r@!k3~mb`d#Sa96s^y+g#X@UOW_vwOhtcyD62KY?m}Te_zGOLhIe
z9n&Yu3<<y?$G^4A_@_E}*p?pFzR06%`V(hnj<>@Ezqo!b-O}(maBP2^V#2t@C+VdE
z!QhAl`3P$bJlDVpqG%>#);HCLy0OqOZT&CB>@1r9reR7ZFJNRxd|}Zg)Kqb>!&`*9
zt%V4exYxw;gqepm765JYHT$UVTeDi+lMwgh!nx?AglD+gJ(o8irDpD%L%?qRZW!Y;
zcG^192rgmJt}OIr<~cpIW`sne?d_L2|J~<=))b%3T^K|(ZKJ(`^#$Ai>)XW%{F%k{
zKA3UFeNnDZ|H<sOan+Z({VoW}|BO@k)&MAS-z=4CRdmo4`(8EVruSTvonss{>XsE2
zERCE?DyIu}eku@Z-?v@?QrmYsbREgw{|S>25Fjl={n)?(4h~>}*+~`O<{?7;vdzB)
zon1X);y2_>Wd)8<62ckEP5`Uk%NY%?tpq+r_FX?|pu<oVvmLz%X*j{(<JhyeH<GVG
zdc<t`&BvF*_JtoLusx%!2p=wcB{MzH@i^?#o?<ASdLw^^yBvp;+*+1-1>9@BN6#_P
zC+=&}OT!GrNO>n!E~Op?1PVm$W<e^9+1e}l)*6#Jio~Q$#BlNSP=5#oAkD@oqOwUB
z!#kEQsKVkg57fxK%%0NCR+FZ3h2xD2*BBKq1U#0y<aq+v+A<m>uW3dis=#e<_DW*e
zvVg=>y%=1o;0udYF?5P-Foka_^QA3vMbPku6H5bZKkt5sAljlQMn;ZU<_<5C8`=+V
zh`&icl|A)U!6yzV5(d^o+?g9F(Dhfk6^`^WAA!nUm^{0D&H55m#z}VVTuIl3m31Ap
z-WXl)O={L@#3{jf!Fa)VXZ{ZGjOtG#d`Mc!c03dvgHBKIm3%I{Szn{O_`UCas$a<Y
zAXe>7pQ+;IJJ(z&FZD62<cU?Arpa@$kN_1rKNy#8zocSr332Gmgk2qzWb!q~JeibE
z6onvo*R1{~$M6nyi$~0y65s*B^~@J6_6ns)hxYTj62+IxtsBdv#o?rn%=ixCmjq}+
z(-HL_Gb8`AjPj0l!!V#*6)+9!`6uXO>nigV$0kpNOisaX3x!~1h8@!qi3}8(0iEuw
zHX9ac!@|=H)Lzbv*DAfL-lqw<3M!;6i~0|YTyw(WRg*dx-k#Q7HEBGOeO7Z!D^K(D
z5ZLrIS1-TyhUKh#Fpkb>*X3e2g+*~gxapL?A!~1|OaQlmE}!N5fkeTFijQdU19|H*
zc}wWTzl<;n%Bzb~B!WfWy0z{K-e^mluXrCFP3tYlNvIP#?by?2&qBFK=)P=nvHQ(Q
zQf1yw)4!ZM(a#JO2o;g8VT%c4wnz&`4Trpg)joN$%bw!gvXb3H4c5GS4k`OL?>uou
z%+fh}!|00%s(cKQ0$3Xap5PbtZlG?6##c9WgMGmFAb)5Jlpk$@82OVNHVKn<0U%X#
zhO!;qp_7Q$gm|Ve7{s#o<lP*R{YhG<%4U!(#ap-1d77t=$p{D&W!bwcw7nRKIv|Ek
z4;mi^&X@od&%)V<MO&qEQII%D8RU&o$+UzJsB0Sn#>Z$Jv|NRE7_*mfrUP(v`gZRo
z_4Eyv<5;qO)9{mgvkua0l2<${G<=rXQUFWGB?}jme9Vw5?3w=k9O-VS$3InCsvsTt
zQ|ZoY>@(To$(<EZU^|zXTr>kwVC5qkZd8q~IbY2u>}hElt2s*cU<dL!^oET;i5<$@
zjeW^S#}Tm(AmW<EkvD_iLx}h5{h^D97%WgTLw^#ZqUiAD@)N}+1n*S0f4(PYaBDB0
zDtn<*E5gq`Ok_W{q^B%Dv-dxqDH@BdofR0nVcU{%XeWe9d1Jb+Nm=u6&Qsh?5iiIx
zyeFD6*=Lc>@=U48i?b^y29uJ)OG#wynbWwJE0C*1efW_kPd4{qmMglgii_2pngKI1
zvY42~Y=34`lhAjRi%jMKlKHWp=vyuq(5f60XUu5c^dZcVYId~vn!T8cuf2Xhec__m
z1@Co$Q;Jf>iZSy*&7yPYGUF~;QlHI(<0JW?C;Kf9#|@@&7U%cp`$|Tt_{ACuN}>m#
zzll!W;D9axoDp1I@q^KZFcLVjB@2BovZzdhG<@qtY`arSENSf`^6#e<p;mqcsAqdo
zNUX_TUNiKx*TZJk13|z&@$4~#iv6YTNRta{b*EZD3DKao@T~CuK>AdNcq*}NP^x>)
zK)Bz?K4A5zFwp(D&{$PpX;j8Dl`<6t{EQD14^iAJ8KflNU=1`6J1koi0e!MIdYeb!
z?|DIwUe$_vq_1q{h<ZexT`O+!T&6`DN+F~m@k(G_gCo30vf}VwGOkiSdp|&cC;(<r
z8=En|ZV;KAJOc{bYsG}U>CmjGfHQbD1N||W>;rOlxzVYk;7G+~6FkQ$qM1{pR2c}}
ztL+35TVHSEh{nY#8*q)k{#LDVJ^<;!Ev@~`vZ|FRAw~fWYg6JE1GjOflOqJ<ReoyU
z$*dMj$z+?TC$P$wZ@du=voQBp)YpsS?d=p)agI)$zPGJb_0JZV&*Oa`bM=z0umoKr
zP7ZdBK<>n*|9VYItEN%k%X0Pe6&{~uTvj?}Qbn5s|86uyzjzZfr>B(^?|lLcui$Pb
z_92&Rm4@ir9r({)Sg#i)&WOh?k-Pq|(i?uTSrG^(4-;E=U5+A+haICF-sC}z-4tD#
zlML~op~^<#g6I*Nwp>>UExJ7OXbMO`Hd6$#%Mcfue6~>D8f2Sap*)L@jLO=NnKINC
zZ;!_Ea~d1}l4esg?ef6_-e@;ZbLIDH4+@0366i`jkk*VD)urggn{iFMqE+0P<dig1
zFsZ`o+|3Sk-cA!kTzsSj%HgymRXADJ!f~JqSK-#?+t%{(;+Zt-E=<)aogEa_a<iS1
zkwQVzb(FNjg9^m)gt;APTgmKmsLu=By|e-KM!iZH4c)BOa1@7`0<e;*K1sYz_IxD@
z@RKTrhiYRi7B#V(rW9HrqO&1wYF%p?i6S7RhtbGe^#Me+C9zZLk9qj1>Up@n!8yFn
zt1xUj)u`sS=pX3;jg3Vp3O}|U&*2e;G0F7c$k!D_uj9r#OC<haVEB=?=25ror@>k2
zNXlT7ZF}Qs<ouwdNewRq515-IRB1-67|YC?a@~26H+Pe{ufl#kh1O0y5H=q>Kj*Zh
zP=t(00G#FIY+bnkw#Q2OZ*tUogf>6T#v+3sSav!0?$w+JVBiH7W-tE)!zu_3Bmet4
zCHT3}Fp6>~5#^>}ScA$5VC~a$v7rKX!@2RHGa~TA3nj|tk}%L`KH`}0$8XL#s3Xg>
zTAn%;--`SqUN^GF5LHdiEvBM}hF0a_<~787{HU!MB@QtY|JuUq-S)L^AzdsQAI={R
z=`ihDMnQ}0eCNssC#8UFZpq5c6LOB_WRv>0Wo+*&O*8<JTkxCutbAu5)Cay#c3h-+
z0=#_7oc{eZ<DkPFeo;cU(m|8MAg_(0@u^)+(#q`Nyix6xNQ8l<Pqc@qm+N^ec2fJ4
zJu#*Dwv7G{Ruu>4r|l0D%c}v|8E5c63Zj^g0y+}B^Pk=`9qpXvy!k)=GqtQwH_LSB
zf{QK5zd~|A>%piu>_-|*K)Fm0I?^{R-m=o~dLC=*Kzx&2CjD1<Nl_s<QC|Xk;;{#W
zG1Z+$uVy7!bHYoPd`(;;NDQ|t6d0!fc#&6xjgru<J`T8VaMFA@iKCRS#~_e|{aBy~
zRENr3!o(2as%m!ZVp5Qnn>qI0EF~^xUYbgG#EMrohqj5$j}@3f7ICpPN9El@?102=
zInx+tk<HRrXCF}*Sq|Qyo66{v=EenkZ_t9s8s806OY8il__}*)<~Gzdmo^y!zawO~
zuti^V?b%-^*V<0c?@y(&Ni5}jhEJ7S>nm#zcYUKKy~&xar?y0se?rP`l^%$h;ltJi
z#ybG-HufFQ=x2nvaWG*#tdSh{p97bG_v#V}_&7ZYIAk1snZa1?SiE!HQqX`b;m4|%
zi7*?1bFxSt6fv7EwAIDG%NNVCu(_jPEnA}1^%HVQAL)+hJoRO3gX%P&sbXP0xk27d
zNjY^Tt{@~6labdi`t{Ibn?@t6&zT^>=D8H2lZSVmxW!_2D}=8AVtz@V)F<}+U<S1j
zLR&sPpPnYX4!#<IB+J|ncxADQm@V9SVe~sI;-X1`=InUtCse=1$v7QyfVMmq^7keL
z^x+pw@3;lnvFV;yxb~-9oLfu>&e}t?&sc&>y@VBbef(UA52>bsP>L1Mazi_K=>1=F
zWD*h<q7_+FxRfUh=3D$gjn)RK__HQXcX109q-j(U;c!=ir7sc=9oU;thw}&lRBRO;
zKXv=d1Bsp_G~inKfHgGYNo)P5Vfyz6z5;5s0--Lo5h9*bt#+<4T5R-blX-1z3*{RH
zT3C9?xW(4=m?PB~r*3Y!uVvXNcvn&<=<+limEJH;ZkgMeve$4|#kLIaLbV~r(0WQ6
z+XQX#nT0CzDc^WE4x^P@dl3cn3-!F{Fm)FeUzKpJ*n^GWlx~@m6h*$!QX@d0lP4(4
z%k@NU&T~W;N?*VVW)wyE@T|{_#+uXcmtM(aaG`M5U!TXd9tm4Nrrf&<EYh8kKb007
z$$=xr^_)!L`mFmj=Gj3)^%r>B>3fPnTubIaB|7W>X93q1tBKxq1V#phG?R)F5WD!r
zz?B?>D=P3y(cSEg74r;_g#F)JM-Wo$Pgg-42_~3Awr=I~Wy_pOjK~-HkIXKnUaCD9
zEdACt->rLmnvoFw3IkF3o=KRpGS=0+bzgqaRl0@AfyTugM38_*OM_{_OsX;SjjTXm
zbHP40ideu1bCZmWcu@ttA^Req<x>eNT>f5kXt5AEh_EkoBHxfr<H}TM3&`WNkG-bG
zv?l_Rdpc%X>%NrQdX|_KRR&2b6BTQ|To!`<l;$epTUWsB!}rh^x3FBk(U4o6>L4r+
zFBHVgh2VMT0F8%Izc+g3lt5p0gW6||3#>`~=DO0Uu{2t;$m-XZI5+S-i#2NO>Z7PH
z*SY8<Mt4o$JTJV^ql6`}3!w>IW2y-~Q#u{;ahA0Zff+pCTE!W)l1;DA#DS~v`RX#^
z*R`ZKYm6ws^LEl$@+#*T28fH2dS5)IQNdS{VovK)<CTpmL@bM}gYKzdSb?62$E28r
zf<tFa10@{v@+=(^VVD}5f3f;HW>J9sr+-(x)(6%QLH2zXx7Hxdvfjy?b3~NZuvAdT
zF}flZM<_Z$c5V`5WHGb+3OL}vV9>&EO1R?#{H0{W{u>cce&g==F1qt-$IyQ#K$<Jr
zuUGk{kumY;-;*{0EaG83i&X7i(9EDMazB4o=P}XKiMxs{d9EVEh7qLc$Gre6#N3lu
zqJFLN*6aZ7P8hdD%d*sXjEm6ThmInG_(RL=r&HMA_qCLQf+EPmCW5S}`-qMiK@Q3s
z(4^_Y^=!BQPmLU9U2kV$@T`H2=NVteWtI+^>42O~n`(8CxVrv625d9a-68tyhR+OM
zEATzjPW>2Z?!u;9Fi$#d3aOfnM6HC#KorgJbq*$_tmCC~<a!)^6pt4TI6TrO-?r(f
zne4q}itTALr%sN9grp*h;7%UcTi!c51ND7M`WXU3$gg33ikF&MqDt|q1=PlE8-?^|
z7CuK}lU0~|qGWgMh0NAl_hPb<pR%Zfl?s>Ml&5CyZu?zM5(k}KGdnD<9O=VsGe0l&
ziNr3I^InFR32O|ffPX)*_tRB$)*dCDoL*LRD`HMt2pA{A`NQ&9;5c#o@&2ikH^THJ
zl#YbJ_9w=E`p#9<$G=p#nKT}BhU`GNiG`;N%Dv2fkx#H-?#gR_+^j}v)sN2RnLnVU
zD`K}!x_QP<zWMt52%ahmqTgcR?9?`r9n`YR58kOc%vCUYgI+SD?~y}0<dCHI%_K=t
zuL=jY%^UWirZjb-l6=zFxykL*9TiX84ic7zkal1o#(#J#XewSA1}{ImU;!DE(AERn
z=uliC<w*FdSfdpuO;}giSutrS0x@Sm+fyuS_C-31QcbW1nnICW_c^PWB<*;KB%Cep
z6{4&>laovOTHIAJ`1)r;v-zF*ro~P!5Nss^j*9yBfwxn8STka*+OBH_LwB^R;!^*N
zPv-vpJ$j0#7j-R&U129LfMRwzCDTR>d#b=mCJ^2~)*qyy?B-qT4lu%(Bmk^#``Xi@
z^Zm2OhHEDF`>gL>${Ja(#I0CDGWtm_5rC5)x9l?Ef|X`hvvJ4(UvU2Xs3YS+kD|Hv
z+TBi1ZP8DxDY%|e`JhNU-fv$6Lz<L&lQ5yWcYV<L{Po6jAsHEaW>*R}Z|DeEC*<R4
z+VRrYKPPd^Mr1%U)J%u=)c2)1_oG{HCidy}L6R(b#Q(!D=Vf$nFy2fhi$vvrqaGD$
z#K+mTFbmeem!o$dtobMf$zTJvlR&;db|^`OcTPQGIUY)Yv5y>>=!>zB6=C%j$Hd}z
zAKGV#Ab0=BB1Cv(0O^NQ`D23^E~LCljCx?$x9Nb5W4&2F_bTh3hw*31_RW)66Tf7b
zCegF~&%C9&sRi1VSZ^cLlJ$RMzvPh3YxBurJ8{mdSE#x*V-B7GL)tgpz_(+PE;do`
z{G|SnR-iwoEUz{w!^<wLArG_LiLXKB_P|CdWk|wUOQg~yIG)|NmMe8flDz#!D*e&a
zVsM>^m39+SC~5o(1!j<e{ur=%LP`TOQykqcZ`AC!7SPU9iHFD{shl`FEE&+NGkne>
z3thPU+p9LVz=p9|@kTfv<}kSQdkoyT@t5_9Uj=}1yFyy{!3_$mdh%;stD$U7Z@bvF
zzlOldXDWYRSGsZR;U?Q5=YHY!5l9#6GQx`Dm~R3wL~l*%lvtRBCxV<TXax(M;qG+L
z@*ztgsMNUgG$%N3a&k30eV`B8!)c_x67t$wgBWN$J$(M}Y{>`u{lg6UQrFLMXYs-Q
z(I?2Hf2S7AmaRXxL@pPc*U<-gBVo&;@CI+adelMN9ZJPXg&X1;{ytI`MebG4L4+*|
zwj<w8-d{m`X^?o$`SlmQHwnV>@uK)`?xVM7tAN;;4@RVGa&`F6`B6_9fpZQ=J5t2d
z&N#y>B>XGu=DEH!x9UbE@q4ZI0+(}S^L19cfC`tl;Rgv4!=WRkh;%tIOD779-5j6H
z35paGDM+nczr`Z~w(jvGtTwE|dxmN_bQ-_pOergE@|sv+r7E|<-*P=FnGOYF&*Xj&
zp<yT!Nn8S^?&^oNi4E`4Ra{3W+^L~cv&y{djZjbvFre<vOp<XfhH>_*D&z3;UT*fr
zalILbj3I-a6-|Bvl-~@lF1>&>^cC#SX_~YcHpiJBVd`Bv@<0>B4pn!#^DV5fj!SDp
zsNN&khjG1<r;toe^A-5ReJD36@Nn}9YP(L&Pe}@;OJ`!=3Dla$pme0kFQD3aoTk^t
z65`yQjGBz&{a4}eS)wOUgP-rn7B(Jf^1wG)@IkA{gCaI$g^VM_#9$o)Y`ZXU1w#ZG
zvh=oS;X+EEu&NAS*qt5kTt&8_8=rf#StS-&FlrW_JL)9Zw#w4`9_1@xX0Z1wq&s<N
zN^y1~WybMAk#kPb{?5;zHdv%OshWzFy`B+SxDPU++1vW?c<O(WQ%{wwyh;%k*Rr#Q
zKek?$aika}@jS|yy|OU}_oEwJ$eX=Sg9o8(o`2iS3Va4-8(sh%!{$i>AN+%m`a^7<
zR$7$cODE%3ZNEC}+C&wm0csmgxm9FQT20K7uq^cd(hrkXkVxZ4SfxTK3P<sgo+85_
z62IV6U9vITHRI(D#`M~t1RLH*=1`V3P?hYc{3}CGA^oYdd<5w@&MMM_AYAa=?$6Ge
z?C?R~oGB5~4>H+@%MZD26hCiQd^1Tdd(qLj1!KKlzr%`|dgT{-G>^FEJF`be%5Y%;
zvbHr#m78ggzL^wUrajH;+l5jrVW<wT0R0m4qZmNY?_Nt^E<qeEq7RvDg&*rYLkt`o
z(5Ua0RPvjag0(RtKnX3#zNY*Cg3umBA<I+%)wmcBiZ$K-%M8J!^sO5CgHX@i9xdO;
z`wF@v+bIre>UzYEqU|C?$6pCOlgSe+HVhEtuAT|%Oko(l5UR)ql<`M&Ga3*2YHZ+O
zR!%$DaCdo{jc)3MeJ6SIY!qCf$RsAnDERHD41hf!dBatxphN;R@TSHCyv>{~j$s7W
zg9=S3FBmLdQ4dq&D&<nJiF;vOtnXA#+3f^A=(+Ah8I|gH-ZJA1*e^|nR4keV6N5Jl
z_wH)Ox{|}DWD_g?-4|1I$a_Xl_tzCq>Wv@%KRyITxN`ihhIa>k7hK7`qj`|HU=WaZ
zGoC{9i@70>(T5t86zF8*Soixq2x0vkFs0dR#$AxDwG4Sw(Wabw=S?nQ)h>BWcT)cl
z=^zxx|JfST+;Uk0%)8LUm5wDedz{~R#x)#3B!84~J1S~Oh(UiDeDm>*KeBpQCGjHO
zcG-^Q11CSc)SuM4P4<>>nTqleds2G@A>H2$@KX(7Jyc#sx_s8jmcu+Jx#1Q;j@z7m
z7!WYB14~c1QUdrxdZItKl9U!NPd@Zh4|Ok~gc%gEg=r0scK(<FiWJ5$%M8~0*GuFM
zBY_3}<nR_$&fLUEStOsMJ;Ekgbw)1=cfP@Jo7b_u%!(R_1)cc^)_P)3G{V~!OnlK`
zGB)#SeCTn(9pL3{?X3u)98wMNHm&0pjo?VGUX6t{_vPo~-smvI@94||p|d<uVbdn?
zBLhjiStR#aRfmwO>Wz!rinY9})`oIW5$@eK6P)S_F-{(>=&Be8!cQb4h_?4SOZI9q
ze7Q8Khoqq_Q$m`fukWdOM*Jooud!A{9({S`_RAY2_DoTmN4%Xb64S7Vp{v=)0s6Ku
zIwES1LbyJ}h@B4Ua1bdNXW5ztJj`N;9lgJj(tP_bDvkyA@d@zy14|o6+mnl^=U#Bc
zqYuuNm{(YU@MnO_9);U>Nk6-|u`Y#3AMp1x(S2aSyBbZ?b*G8!3wNm&no|K;mGiU7
zC^k^Tfq-L4!u{AW{Ca<vxM6oq4C~`eDDDMftxoH-@qaQ5I(-~vM{wj^3*-)izdmqV
zww`aOSq|Gu`-!q7c*&`s%!ntd7tT`RY6MZ{bF-pBWYG!XD2DyLC1i~y{wLMI@0Z<K
zg?IB5Q&C2O5`WLhb4IR}Nc?FDu5#H|wB<p5Hnd^-MVs9ddd-OGTLc2TA{Z5St};&5
zv)boiX;{UP|HeS^;c$TCq3}bW00lpMPNG^~pFH9sz0%F2YgYNM2PkT8ZCLwn1ru)f
znBIKseKp_J3ELl|%__lczwEdLsQts^COUKynk;j8S>0zu*GX>AF!$7I_C2(JDp+x`
z^l1ke3f&XB57K)?^xyBX$=g7~XhuXN3f)453K+}WmD*8Pa${noaUGUjclu5p@L>ga
z_-V7|$*Qwxda``}g=By^id7|MDo-%}(*&3uH)+;rH)`Qla7~DjgQh<<+YjA*E(e~e
z+Vy#Oz)M9>pbB#{(YR~0@<Fb%u)fON8+lW!y!nRLdRFnH1$uF;kOfvMr3SBn7(tUk
zaFXL}S6Y}>#uD~_@(~{@C;9vEX%XgddR&y8PO|-u&-=)!qYL=jB>S^wGPR2O14&<i
zzR*y{5yjMWPk9=A{9(bj(sd<`zW7WD1$~X7B|%^p?h}(34W*8~82S>XG2UGatWXoa
z$;hmFEGC?WaB~o4ITnZ#!2H&KWB?mTH|O&vyjO4TO*&zjC=ri*Y`}eV<b`p2uc}_G
zu4rrokiHjB4fv?m4$fsLDf`!IeK@U=Zcqj!bnNWF_H|-XTFdD}K|PaBd`e;tC;ZFB
zG9ubK$1up#8ZbAlp}P}rf-fufMww9ma&W&caw`%y3W&I+29r+yH}%2$)@4GS4N&8b
zD&IVD4_i|B$`b#*@|C<#<#3WbWYFTn(kpkkbL+Fp#zSOTHw`aUoIdN*!yRVDdD4w*
z`np3!2Bry!b{&g(*1)R;+TFv)mFebU=)OZAj1#gTq)|%!B=-VK!`eHJFERyP1SNRs
zQjgi2`(Bm!z&Zba7C;EO<UR86%tfdA(A4d+{hvomk^mUe_F}j@@6@bmu8$_9MB32v
z-z5&dc%Cm?pJD&i){*ErBZ>U<^@Do+hYW6uyT1d};M)=0es8U@4?ymxJd|tJI~7Nr
zJf$7X%6PsqM5o*D?bO2ogutM%cARfCKs|5(<ZgnmN;bMDT7?QJU6On+fdLdnBn%wt
zG7z6HZ>%!wimK+!+Q`0!O=``U_dcYdY_dsJ-geJE?7n0%$a-ZzD&$f~mF{eM8@G>|
zWXYM7jyE5o1aoQ9dy!YY5<B>Y!A$B~vxAgzT43Nv#=i{`QrKtO6nDH#46Y24cQ%LA
zmfAk4kb@g+u4#hhjV<gLsOZLrvv*S;v|$Xh$WoI>qUq83!>d-S5GZy(WDm$E%X?2B
z+i)V+D4<+AG|hl9QogHnhY>0PhJR>tUl^lsAS@#N<V+m?Xgr>ni78Q$j){qNULKcI
zlKRbl{3eb|_nz{PX5{fnN@jRDx{?aj^C4RT5QxkBZxk<&i6!1mx$x+s3opp_KVnO0
z%s9CzLor|xKMDfDd;#=NRUOe<J&={ajfdLXK5_G&WT3K-TH_DzPbbD7l&w1Gs@U@-
zP1a^5ldN%s{q8R+)P~DXtHEQE2c?%i-)}NCNvmpUPDU(_?-QZFZ+w+}+;`E?>qkbY
zv%8^b6VwR>4i2T}IUruAiXt63oRzP<t9c2}FD3Ev5QfM~=H}1LB?W6U@EEG?;Wg@G
ztSa_bXR|NHN8jT9ip`?O^gf2!jG>GbwgQ>vJd#!oI|(_h`U|eTT8CpnPyPwgju=|K
z0Zf+_uoTwI_F6$h--}Fq&8i5p1GgV%AjZY}qBCuV#5yeJUaB*CdLd2;Vg0qVozyEo
z8_U}BFQPeY*WFh27sV`WM4CxJ(+93X<DwKU-h-X5x>lqsLZPEb5yPXAM5Zt-pkB_q
zOxUZ&3Oc7dE691JgBW461+0@Rk9yl;*MUF5=gY4!5OK3x2rlH6vG_-wIB0Y?p5Zs2
zMF3K;D~j?CBiL?^6aHrA03^wla>>zOwUV=nEDoHwz*Bc`xtEzWYIPhKz9C8NHorJ7
ze2LwnYJ4@KSPn9bN?l7H;-(dJ360~&4y{9;ocA3^GKPUB%Pf|^P!}(eFP*^|0A&}{
zLFGqFDVV!iy(OP<oMBkxO}8xO#QWKSm%CYICJUq%t*e=)x{`T=D|528*7Li6A;*nZ
zo*Z#+#yGI?zuHY+&#2|4=S(+Gi^03d_U@G;4w!f7(B8<~lTvaCcaS+bLTQnpLinEP
zjLOR@WogV<zmW75=R1nAlY5aJcR&hl6Un9*ah!r1#3cE#l%GrzQr`K=-j%{t>B_H1
z>Z~^u9%Cq=b2W}#z_P6gDFQoT#!adp_d*s)Anp|ml%)aJ8coVJ<G=iWI^My=KnlHP
zk8ljEzieXcI)R0Ku7y;6ts<qd9+EI~sWXO7dG6)up2*UoI}xORPB;&)a!XW3Op{r0
z;j!XKl5^Qe8~`sPvflI>GL#!`2tzm3<9Q06D9^Ty1YmEnmTS63F)U*{>LQpq#?k77
zgajt9l%1p549P7DkX;3$uCiR3E@-GAy<Ll@+PhJm_*&@GAYhQ+;e^t}A$#|dzW-*;
zh!jP?DEqDetiby#wOqU=IA}8a_c=RLn;VCsIMB@wAj;o^oCr?dkD97XTgwlR*R@I%
zE=cy5B`IKd`_!~Y(r`ZK5?|jXh0Bsp?lYmOcjI$wdV_DjITlFi6BsbHf2Z%g{YD2~
z`3llkj;8QJSB=J4x$o?FVGwlwAe9x{t?_4OtX(m4zq*ip_)*ytUu5UwE+N9>d4rKK
z9#B(f`ulzsO!W>-kbSD)EgI8H4NIq`JlW4h8sG@;6^c28mSS_0CWZ*c{fJR_x}2gf
zc#okF@SxHA{SPb|@c8J8u8EiH@Pv3aS#J@uw>M1-G>Z^~u!UtD6}`Jc=cyPX-$1CI
z)6&Ye2R(^EHQb8bVP0cedm`<KAFWCrF+rtWA)wjc4A87Z)xmUa3AJ-4^L~}Qgej`p
z?^wpiIykMF<Zk*zr(bhFG2;4Y&d{z~ZBoOXttrQ+vU462c1N#Yjf?to#uS-?of1=B
z+Id9@BH|5Kp>Qw&RL7tfpnFH=GBm^?JC$rr&bU*X;N_p5nQOBBg=C?N5OngejU<e>
zKd;}q8<^;UE4zuEZ^vAJC61ADwxrg)9}W-*I^^pWL^Wb~TI^W2z+AYo<-KG@eH9Zt
zH_?0F{uMw1w`Y5wKXj8`zFdSpXb84;r`P9atu;n$h7WX_Rc0AE>T7@^a{4l7(9Lvv
z2!G4E3CXeicCHB6hO846Sa;(!ycj`<Vem$cR0guyM9X@V-dzDtRD-W)lbx^CTvg}>
z2|82?Z?uoA+Rb_J#;a&t^BC$nOM!EU&{~$YJXwj2%+CBVfz-678a9a?7=#Ej4ofPV
zq`|y~!sB>S#@hn+p|vb8m@XF88i7I#+J9RDjZ7#p$IYb>hS%$<99%3T=l6V>v#;%Z
z*@z132?a#_7M9pQk)}r*04Ju!AP^Qx%6ojZ*Dme3HDN`Ej)-j5Qx=MU(z?i9n&jMq
z2Cn>W)!QDEKgOhs2}no362J{j-2_#-IZvX8+1~NOg`ffFq%apl!9`;-xQzzd<Vmrt
zk$fxOOyWDb1C<aZ3(6;!X;%Zdo_Z5f<n@mCIOu>yH>wUUih9}4)Tyoo9G>W?4R<1%
z1D|Hy))Ik3DCkvdH~v%O>D690f5?ud7VQ;n%7zj=D&e#;XvtOc1Uf|{r1>6lKH4$y
zXnxg%K~^Sde$|nAWv7ughIA~ANC3?aBDGtB*WW4o;^-x;u=pafQUfp%z5_^up%*6k
zhh`A`dbj!6R2~OieUPb4q{d!Y{jaf_hlY?wehEf^!(M(6$-@bkKuG5po5=bh_Ps@}
zouckO@Sk(v7D21`_)lE^Ymj#38~mNdGK^4L*4Zm=zm&R3+q=K)N@Qc;VH)s|^uo-n
z1^ISgK<@YtZq;n!+g|3|$*Nqlc@&d-nbTOsyXz74sy#1p|2OzKMb5FIQn5uauAnVG
zcz4#erL%_%7>59FVdJ{=L^aLj3#_e2gnK*(G;vkFECqW$^A;b}Ec?Rp9RCae^C`!x
z^|YRHyJG*2gsIM-8K?cmHez%{N#O!VwIxZ>iFJCJnqLf2<It!J<Owlbc1VC%1wCkt
zKa9v`^=mxbU$0KuU6ogp@gJ<f&)#1XvTSN}8&tJ8dtk2!?GA7){Eq4&Tw#~VXI-(l
zh;Y$0YVUrkSVM9irrtmfEj&J3kv+<<t#D7BJ%}Ohj;G4OPZ+ey|7oG7ht3hgTskat
zeRhKV-byIg;-_`~kJx`d*=yF9rBFHrWF`w{9GMU%I~(xmrB;~dqgOfVr@|kA2lz&2
z?%|tr;e9{ylt^rDnGy$MI|lr`_|CQa-aFkEi{ImveWtV1BPEhhYf?Zr1lv#gI9B$O
z`Kp$oML?P|?R;JC*%SUFL`Op_8y|H-a$h<$(7r-##nui&tb^7}IvBdc1BtvyZRKhX
z(r6NX!oT%E?43BEvyKAE<0?k1=DP=``=LNuI#f$VR3FZR7N)h|`Ks%c$TbY#LJZ7c
zbgJ53JrPfJZA$foH6KDxYa+m(8HlNG6Mpy5eGkD)%`9z7i6x$co$8jwzw1u<5pQ`P
zIW0uZBWgm~A*<(^(4Q-^Fk>oX2@<SFSfDfE2Ree28>hlY@|U*;6{{2+L~H~(Qs1p1
z3v68AB_?{#Zx&FI{1YrcW!M~!Z%Xt>LkEIOB}#8zI$D##HPY+|*l0B~^<^j*m$#&s
z-MCW??$7E8)Nqdw=wVGNOal_xnaFW%<+D0j|H)O@#WYD+l1P_Uo2UX-A9TYlI`6!0
zmEu7|>(%*<TFY5&0UmYQMZfRmOSZAXLk45mOLGDQ69L-F(Mx=~@z8zV(no{K{WEU@
zf^Z^9?a|@^7c=OG&d??0J7S3(j)x`U28skD6)d&`YkjY<C3E|VG@q;1;w*x}LlhUx
zUi_?nOXl+}y6+Yfbpl1BIgwKu90B!U@3J7KM}#=cAv-ZsDCFjli}8O4?Yg9xQz#6`
zzP&S4eU4-I>lJ@;_{MN%KCFxkqTEqGIp$=Rpr!6N<<?cM<~{oc!OuElq-Ut4c54>N
z&(1?$WW+xnQsgTRQZ+e4y$xxY|JktTVdTxNn;&iFxo&r_8^}r9&~*ls?`Uo+;;1uo
z%@|{W<n5K^l(n=cquY2-(`*c%bZlALRr0`UJ`_lF5pH(Dr-B)jr0r@>bF`P5_}?r2
zTzpwpNfWw;#$=0L3^u@`dGFhj`&&OP^bT28Q{Y(|dn9zvQqL63SKA6~{3%$rsm{y@
z&n~1bg8DA}tscZTyy~jC&yLHHbyC-DpKH%JcL#QY%Sl!j!4L-lFGAc?C&J%~3*=hy
z0LxoX-J8Al|CGoI5BQ9MVi|f8KLnSX7)amF9_)Heu-I94DKdXhi)XdydAOrmmkuHp
z#F6jf4x3PFuMw@|e=T@Q^n=GE1G`%`h9rsX?I%o^Aa&qOW}CwaNzi)a^i7aYnaK`Y
z3~`bTvFy+0evU__Pdf}TQ1V7)(J}MwOExx5yE(|2kT7&443c1PG~{=ABUYKU9VH!6
zD?=jRZ$|B6i^kS0_9XuDPzK@`)52Q%#KTJLGGnrf!y1H`I*P$bf9s@cuyfhSzIS2_
zJPEGCUnybg<0f@$VV+6T))O?mN3Pk?^c`rr-XOj<P%a9XtU;@s2#aTBS3f*Pv0KZ9
zTONNz{M!0da&3~k!SEt7C46hte$S@2EGm939*RwuJoLo~oEcZi6nDJ9PV#$<j*_}}
zuI)}zln@orrXNh&IcpsY^<<0*CYoU@??&f#Q8#<$!~Bgkb}6+TNr#CUSH@~y9(_zb
zOSO8$#1@S*=*#=x42W0+BY&NhSm%>kxAYCBu9}CqInL^YC+c!0#Wew@Jbe}ZFL?$=
zsU&tF!AadLF}^LX4y@w6%~iBdGv^J8yEog+U}6G4PEC6|OZ34hO1P!IcyaW8C^h2s
z-bg!#43`1_r_g<H&*1!2!ls2CwBRC)JBumnBN>o(txqtVF<|Luhi0u|#Mtp-zu>vZ
z(H;PxyoGbL#zPhmBD(ts4fy)Eg#eZ9B`CHgLN~qj3$A{mw)To;vPO)-H|wrj>Bl;}
zo3*q_{xO~YfT=ZG+lCF4x8kM9l&^L5@vg*gH*c(@M5R;CcP8^X;=tfCl_}57rLX@2
z51uqG9_bviV!M1{Vh8K0kXy5uu7xHnNx9t7aF#VFnKJaWTZ42f-V9HD>F;S*suMSY
zQ*6BFRPwn@CNHc;1NQ~QL24M%0r)n)esQ84=0DDEnTSfab<EQ0@NU#USH%9G1sD$M
zHFtABFN^k#pbWJ>ynaS+`T19_V#KqwlwsZQ<HfXqY-6nt`dXT*6PmSnkZK<0vM%bB
z<hOjeh*BwDeYjWfh84i9>|mccB2LP&eUY~npVTKKN6c)ZgesGQG$LB%#1jmTvvkzV
zh?%|>HK2siFkp7A^O+xTC>9b#6Zr7{FZE=_8xT8hBDX(PY=7&-99R-R2{~As%nHk1
zu2Xn5@hZ*y)C@n-osITrq1E4CGxG+w_|?2Gfi_NQ3&3zHTXq=G?emPp?{6nFM!5PG
z`f?Ry-Pt|VMsIoDnaF7ZS@c_fgs|!|n>(?r>tw)Fro-cC=^n^}Mz?dNxq@$AYk<9?
zD_0uFqos9%5uRy&)LbTnE#Pa6QAATUzwo81N@&&*O<x198`-WPuaKp|gK*ENXd^9x
zZCj&fjb2U2*zq9AZY56S{(43=RPlggdil=;!m%o`%Be`<$!e2~8Cr^l;|w7-pZ4FX
z@e1tMl-F8MO^+V%(ML4{%r%%r;}B8*l)Z(i=3<d~&X8D|-sAj5I^;RVDU`7qD+Fvp
z{wcvuxAn@B*U&G#PfS?}!@O7ml!;&L<}yh6IjH&gKwBOQ)tfz1)JbUfpyqC<eiQ-X
zAYYz{kXItka_MUw36NpK;%oVM@Twn#{(CEr0FAYp$f0XyaZ6fT4sD~We-ZgA7V(G3
z3QdR8w(smCmaH|!EK?fLp!hyZBO8gIHu`sv=1#TjMV`AjgTw%g%8JDBuhP~Z+Pu^`
zV#Q)1<DI_#;y4Lv4(!EvGr%I^(8~Wp4~%}nKJ+jr1HPl{D6T~%B)cPMWKvf-hduYJ
zOi>)*1ghNc10Kl{ZT%lHm|2|PBpYDVv9|um^JtsT@)^C<$m`85wkBYj9DWp;|MHGg
zsQdvoAmG>yBQdX_*2E9+-V*a{t3B6cRF)n{{GJgrkq;Ykk^F+!m45v7U(S)Xp?WN8
zu(uLN6Z5FgjKI9)p#I|mYdNZcV4Qcpz&fRAKIGk)vc?1Om_`(p!R$LRol7TJaeg7!
zdu|`krN8v$H-?;NRrXFi091_EN6xT~&M(P1kAqwNkWZ(2rnu))x>-gcn@CPrPS6ND
zBx}RZ2LC8A*_I5bfRWjre2*AmO3U*363=yFGNyXDhZ1T(TeDuWA-DLcdsc#pMz}n;
za|jz6$>lcs@ADNF?uJosiO#^XC&&7{z1W^l!s^DiNp7<B{1;1<>;!+`7gW2a(c#`N
zHxsllU0UWio0)P?)Bd$X5OfpdMD;I*pgW&I>rm?jYt2ew3_gu?`HL`=R#dRlMaDQu
zsFN47dQoXzw?nP(kXOx#3(F@0Ou^ZM0KjwD;Zn7zOpjx87lX0GOi%B<$SRYlSqa~a
zV%i2B2^UPO5S{018w=3Fsk*4V158D9M_Q4~2WmX&!E=qARotM``?b9%PUV*IYwc1F
z^j}J1qvgG_pBQ7B*GjH>IJUDA6z8lmg^gBRF$Q~w1YlEG&DYBVAQM6etep%_Nky)(
zsnSp_?oO-Ja@&aX-T1^6G#>eJXbNwW9)KtAf+%S<eN%KtanP0GqKK8Fs*iB*QZcB!
z8*HF&b~UJz2~k!P0U1Q+sDFu@La4$0IntL<#1zfpHT}oWWkK^<Fp)sd8O);wBuhIK
z-cvg*K=Eo*6^2>4;mc|~oJwP}(^JxX!fZ6%B|t9LvI<m*4tlJ}oG;)bA4&{*y*rtx
zE&^IsO*=%xye>NN0!iUram=&FRG#VEoRM$^Pq~9cksz)c8C}Nj(eDQ)dL+?_*5)=w
zAKct-)QzAU$YP1YP5ierw<NgvS=oVe4;oC-`2-qF$Ueciv!L`u0$9<jjrOAYshHSS
zp!2F+LWmdE2HsW?x5T%;B3K>wenIi4<<@imU~9G8lSWiSIA#vFh<llGH#N#K5tjA0
z`JWm+J{ok<7y3NIZlSf4Fij(f76f(ssGI4Qki1OZmgRv}>w2s})rm_4?Or|vVS{6q
z?o1rlESdx8Wvu<yyzvRn+%32LPp^sH26yr(gVK5VU&#8RV6`+zC<+{k4;pYeg>M$C
z6cF8v+NbgCu=a3lPYNg(YxacYN=XVY`p~WzIn$p!{;(6fOcG%|X&=j26?v!TehJ}_
zNegJ&-<6`F@jk>3(Zp3ck)CNi858Axmu+ZedahG|o@PRWv>FluAM^}XJX>TG@~hC|
z$TG5D;o&9a>KVYf6;8R~3!MdRLSEp?v9Bq-g3l^MZ{<51IYdsR#yo>$5WVId6$rz5
z*9x-RQ<bTsg{7M|6}T{mH69_E=gFPxKnkX=xWKmhKNnj&e`k-z6mM5mYQ2$D8GK+#
zkB*49VV39)IXi*z$^bjex0>Cw1*$It?B{#Cb{>!qa9^j#{+{z?t!?9AitJ$>y=YHU
zc2AB*E2Z4XNjMEI;uhP6U*`L0Qfn_&61q^C;K@+86*5tmx;N?3g^<cU|Gr7<U+C$2
zEt;@|2crR~X@vJ_%LXIk>!@mkv24gt=ODcm>5W88&y-G+2F)&;?9{*nZSJ#kxkEwE
zHY<CkT?jR08kWgxlaJ4>FNR4bJ=A%yP46uM(k1+6rc7K>*%y;Vbhvk3B}RL7rq+dK
zsVFVI_`>8La8we?Vj^KCf0ZYy<sQv2f->U$IWglqrp8J}5`14GSMvQ7nqQ~Ws>=|t
z*B^j0<t3@kdjUh>W>&~5R#O<8Fl6}Ql6vH=wagv;RHhtN@U%Ptp-JkPPM%ho1R;=P
zAXUFZlI9AbT&Z{=?ea<WsRm@t2jcpaLnaC6OWoP`wZg|8w5uC3J{m#HAo3H|)|x>f
zr(F&2`5fk`hh8z{**_tBMEvgQMl_ObDVAvuxVee)==Ab|Y4rTAxccvJ|7lpIulMba
zV_1nXAtWI3vN!@lEAPD>0Ko-X2)%WKTXh>jBJbmr60nnQY^G{9g7Hj`VKC2OY<?Ui
z<DqWcXA)hCvxY`}Y2`hukQMgr$^@i$B<Iu2eaQ>jiX0)6c`91E_`MB<{kz2@7OFSR
z^QCIw)sv4}x*PZ(cx9K~P~|7FD@?P9C$4Sf(sq=g9>5HpqOpR^C*h+(5q&|grK=9M
zbLq2XX0;DF&?)MAsJ*dPpF^xRD2xmE5bz0|hZ%Yj>eZ_B4rO911hhOkZil8UZOoAa
z3~ZsUWx!imvm>Z=26>qJj1Agsm>*LvwZCq0U!Ippbm&!Ajh6#v6*l)vXp1Ag3O=4)
z8Av}a4BB|^aju!4`m~{WB$jNa{CaP58K0|Dml9}7^)bJxCzn?vI}7yQopvpAZ3w?9
zUP^nI*?U&cgT7X<B%|Zpcz$ptQLq-SLh(2p=T&L}0oNWOc(Rx7?`{pI!zx*oqxEM$
zX>6!qx7Ckcia&*3n~^y#H~)zgfJWC!I77T%w0o5f3Z*6N@gFsy@mc&lmGSHToA$ee
zF&5S{z}V?HUR9)VyPcM0`&U(zs+e4Z9FOw}u6_{7U0*~UCj*9B3+FDJvE**te@kw>
zFs-tFuidmfq`%{)PR#Q(Tc^ca%$bu|e9iT$))Ta95+B>>#rH@OY7N?9o)M{(Hb+e%
zwS<PV!pw1Eqsa{&i=r0&E&{9tYERM{6BpVauoeODyq?FG)-H}3BttNT;&jfe9MMi~
zBU1+KyF%`ruhd_cE+3jM^{oC>NlIEO$Ht8WX6@2bt^YRM*6Sy-RGDtFnh(O{Hz4v^
zVs_|xms@-1p7lqz-t6#>0z*ojA~JLOpKvG`NFV+i#Qwcp{cklpI|UMvje2Ti7sAka
zVC<DVfPf%K=^OdD(+r#D0WNIk?IG+TZ3@6C!%*-H)^hs_JDVF*Heh-&@<1U|DxNU=
zMk9`Yx31;o#(|08O-Ls(uj$I+`vIjK#VC?8b|7BBZ+Q1pc*%eYivTD^Lh$pME}t^H
zia%JUy=$I$&y@o+@)GU8LFw^_n%1w#k!y%1pWb0`K*TB)eT{FJ+HDv=jHtj1>8Uc;
z9xnj@j`6~HY!d)yk9VX?AlBZ51e2o{JkMqQ1ex&*BYsfdUtBbxrG>0&94PXPZ|$?J
zP`tO!zA$`jFx=UY5PZkZA$(8m)-8f~V?71~+d1~Qn@R=K6SEbk52R+!{5KTEo!^p0
zA7IS3wdSoFtZHUT`Q4A++@wXGOUXxuGM$fg_C?1tz*xW8BG<qT!CK`Xcd_DFEI-00
zjNP;w+%rQ7EjFOWXUPya{upIknwekI6QO#gl{^x`*Ok|g+0qTqFy6RSSes(pA3Cv}
z?HGVq-rK)b!!Y71DHQYGeW_sVkv4I8iEJ6<U3+VV<BE==#xf~+zy{__$upw`SlSWr
z5o9Oi!eeT2XncqS5XMLn>Sp^zr#+P=-G!01e{uBcl^Gg79DrxG@(JMCZYilgRLmH2
zVBU4vQrX}ua%A(osIB_mh>kkAqZg{5q9CX=cGuvLN55j;na+fSLk4PTTq{0G@*LQ)
ztxCb%@I%Xs(FOc)Ks-ynu|*J;l(d_T`QT${I$MB0XkuimyUlKRtX{;-SuASxo-qGc
zzKeySYOEWa8>hlj&iYFEQW2x*-pOiB)ux&~chnU?#u#U<n|l7r&otr}uWjicD8#=-
zmYc>l;otEw*Ti9Rd>F`mWJi=pjVZqjU^SMg-s)2Q5rk^=KxTCykg}ODSNzt=AOYVn
zJ!-=4)inQ~d7{9mFtzn_J8N8jHevkKNrzD${~YvhiH-gtGIo;$6ia;%_{A_H4Oe(k
zd1moY+V^rGYoP(x>c)tg&a~qEq+UFvFDYO1P?rv00E{93Ta;^^+%qte$-7RmG>wn4
zqwWMp7_Q7JlFS7@Rq@6uaB5ntf<&oqn9mw!*6x$6b}ku(<L2>WD3hB?_K*pRp`g&4
z7&egXkNG$Pc`~>5A97se?kmFm52iR~!4xhJ7p7`eQ{=u}))bzntfbY;Wd?G`t?<^p
zFL(jGn0lDFuS(J5_Sr2a>n7w}V+dgKw2X38e7!k09{j;#cweg3d(mg;;pDp5`f1vc
z^t479`nRlVIa7Zu|F!$s9hWk62%)pN?oaqj^2HHLcW-SrDfC+g<a?(OEDElk)k6jw
zd?GKkv)}<XQN<TOhQe5#I3(FkEcPZUs~iYE7~ME~)O4W$F&PSK|4pkAvYcgEek)%x
z%SBl}rV8I14D{=0qaKLp`Z3|Sx@&I~0o4s^2B54pNn%%dL*PZYq6D%Ne|=){!E}mF
zydYG^KusC?0nI<2kXYXF${424zPbQW1u4a*UVatS@ZX)_&KqrKF9ki|^Rx}_z3<mG
zIf!@;Uw+Pb;!F7A%?SQ=!#?cBap>uJ40>;pR83T(Uo(~QMME;sxM*7czl~lGkML>O
zorrWZvFh9mkn745qDU$hqL)k>f$slj0R>{4wke%~+$1X+xI1$_!|74)^8S*lZ_hVR
zNfh@L*A8soos(iV7#LkUzs&@Sa2VuLGU6Fk2nVWluqCy9>rFFdo@oAJZ=F9w3P9TV
zQ?ts$V`U6LIQA;9-H#0Nz~ZB<#gdpR*6X*Ito<KN=ipsu_q_d>jqNl}<Hoja+qP{d
zjeTO<Xx!LlW1A;V`kv?auJ2!PueH}bduCsAeP(JE?%3)MTz44Ll2*2Vk}cH7@|_-0
z-fLuIx??~;#Z6r8BD)LjRA4YK*mCAA*$zTJEZR2@Ya}s=PyAOC0}>1teg)Q{F}AQ}
zOg6Z-aHVVYJ2DUFdZ^s;z-O}Vi=7lmIddxxwKyqqFkSPhUfx3tA<v#zxJ*D_PPGr(
z!x1Hsb|l`Oz6afq#lQvVs+B>R$&%(1En0B9B!!;)4PHY{sN~5ld37$*$kBOH0VAsU
z#37cxzT4!II$_(HfYoRUeP_cc36lX7gG1DckFC%!g{*lb4_r=%{OyBoBu6NrhmV=%
z%0EMl$t`-Ec=4*@_Xy5nQ`oe1!78{#a&3+7kEjItbtw^Nxdvz;DTY|=o4}&>z;wY5
zcxetqqs^Fwq$;L{pbt6N594|3xXB;~xv?jlX5f2c1Q$9B>eQ=d&Wne2D4eZWj*tKJ
zJt$I~HsC?XZBo3jgB;rfrMLh%KOO>i1v~JVo_QaO>pR#HouK2&ym;}~>Qs<FM?w`<
zd)l{JA_yoOPOCpIu023rRAXkEHm)<Cj98=?RM8zJ7FWD*Mj%1yu5idQUq#00F8x(U
z78H${JSbKo)w_n2llB2eT1@Ldof6|w$p28OHJck>T9jx<QN}vv_LM@Xo?chpSne-4
zzY-Ypb+ymkfo^rqK*~TqDrYLKWV(9Vg~#bK3v*yRDoTID$AIg*ZaQ!WCe(P+9wjsz
z3pW^r(oN$dP<4V<QNdX};Pn{g&iN`ctRL}aQc^tIQ$*gQGs>ecbO)(lkndaim^_Q)
z?7C}>8~3l|p_T$=S(NNh2`iSbBvwz%M3k8SlQ$_D5cS`CK$^!#TJ%4$j!;;~_PXIb
ztYc{kS(d&RJs&;Va;UKHmA>{Y3N*9=UPvg%4?r;K^~BzV1t^;=)1~NE&H(>>(kRo2
zKJn&L7XpO-I!)D~RUJxklAMifuiG=TGfyaW>T(fZD+pfCffgCooHWWS_z@6IRU1>b
z3d3m{he32~YPO$fK83+`G>u1azlpV?*{BZ~VRdBAba#{UG17LG_7kACZ6o>pg0gfU
zP+<y7j8Y<+q^eYb^L}7a=F&7`08Y^giRp)C{JLvb!wRY!n1usVoTpoAza#W2pL+ch
zR~vp8e^WL~ifj56$amYIKp>qUk;x4haX+*&x_Cqb>@^<jd!05e`dz}yFMUgNoi?QW
z{zCIsbW#lKiFC@r>lR0F8g-<tv~hFRs*vH9^`!DoZ1aL!A5J-SAg*fazgk)Clx7&L
zJw9OZzeBV_KEcfNNgKA`>CUO^weo90n2lYOM9?o1Cu$Z7t6iwCmDh_XY>`$ywtv;|
ztvUP;crck-d-X;H>EQ9GfOly`;i93z^68rvb`(CrYFD`FjCRT0ETzaqhj^M<>mrpt
zG`!rpDS$-o;5cR0&!a6P+N+_;Q%0{_N}aG6$M@OcQ6xj8@810!dDVQT<WWw^YboWq
zbtQeznhsW(=ET86w9iwN3ip{g-;>={BS|yn>~a$0$s$#~GiF|FWhV5s!&B}@*IgWx
zTWcqlegPzQUl!EkOBX!ZsjG*EPg7B&Jlf1h59zoQFM*$uGm2>Q19+5`f#M}Cta@w#
zXV_|i<1eAjno8G=<@MNQF^V;C;82PNvH0IyBL7j62llBPn^_+gN=SFS8GK($K61%W
zi_fgLG{wrV%nsqPm(&r;j|UpbcZM0ji+BoX0f1NeWMZ_2l^X+j5>RHZ8WT|!J1?rB
z7VYeQRc+0dR}{4~B~9=H@SGE2890&=C*`?yJKUbresN*zcYWbNRJCs0t3a}cXP{ei
zzkMI+SI@}{n7hkO@QmkU{Q>)xn2=FCM7l2ogotvMj#p;yGB3HflTYO{QS%SpXJMV_
zAsYzAogNdols@HMLZo_3E?q#(HP{=Au7yRrYKC;HyjAu686t$}HrlCqZcX<qHY;($
zLru{&STB9p1e%-X<G&#5IXz`SHb$&vV|_N^-rP6tp>^&UK#paaDyP`Tb3SzxkhSG0
zdOO%!fZT|HI&a?d5%pX!kDW%1xZHZgUcN5lT#x-YG`>aDwQiiI<2n-f-kLRsWgLq{
z*h-gO0cY+#kD5_4!5Oym^FSQ8QKO@J)$6CAO-fj^q7Tu-eFoLT5xxaVWEJcn&y38G
zq1}MgmUsh38c!oee%X?6z_&lZF|GP=j3x<Uk)=c~EPw4&NUT)WYmo=$!ayIj0anCd
z380H!C~6G^`IgUV<3`m1PqAx<7lra_{u7UKYV3DkdHr&OPmZR$^G)z%-ih8L<6SaW
zH~bm>CFdRC$1Mam-3OwcmPG5Tp{TCBbYQjz+K?}QIbFBuvby^J*$G$Am)WLE#dj$h
z{`jcwqt+$Lx%$v1HHcL>WaC776T65MQJLs;z;cf9Gi?>F2T`;paZ>LQ)Ej`3R(OZy
zoj(Zzh2$+FD)HxEIxMdXx<J0^)Q{HI<PwV4t{hECNyFoeO1{|&J}Tlu{}v=}R<vLg
z?H_A8Z3+wz>zs)rIBF;}Kf$;)8Ks84h*ROh`J!!nb6oOS6?2EUF>P)%*Xr4lf~b41
ze#h`zF8K*p%pxgU3GcCG(s2Md>2k4IX?u-jBdw3*Vk`x;WRDEs4G!q95OWb&gZ%z5
z{_cRb^l2BPcg&QgT%LsU8Es|oOgf0&10h8ZT?=$L<S4NEQw1!lD6HTu`lo8?iy;&i
zoy|xQI9$4dy))N^hxD|TP=&d8C7*K}gmEM>ceSr28z=QI;9;;Kz>(E(%NYf9{NRPb
zAvC;Rp?(z;LU~LdYvSr?h^q=W_@Gn&Ie?Pa?&T!ueroUfprSK}#soS9eWwC5K^k{#
zGeKd@s-@}c7?GGWqzmSjcD<P#fv{3U`N7x%-^lzZpYvC7Co)gFi4#%e>byaQrTg%e
zpnBbU1(n@VX~u>#={c=y&+6oes1=}I8GgWZ=)q{@K>>3t>H8t<{A#P<n$%6aJNbK9
zaXfxr?sd_3)UJM^Q71JtavRl<OD?^N@(jY0(7)9|v%U6i^8$E$X{p%241s3^dKdoU
zm2I*YMi-1|Cro)SR9a9B3EF1+4v2P$#Cj?U>DZz%jfXJMozpQbSPt*OYXi%wc^Ki%
zg9*O*s&p0EGY93vzFXOvMmrcTu5UDhAiIp|N2=yrROuorMc)ZSFL9v{2>H^?o3_eV
zN)>w>yD`=SJiA>mJ5gB|8V5y`Dmd31n%w6aZYtiP?YV==Zz`7wWHwVy{JT6JjEj!v
z>MooVLW7GftKlBM4Cyw5wIyJ$qA?9{bWax{caao#<ALl0!$~}JRf&G2T2T;cLJ2wC
z3S;=bQu~1Aluci%mUh~cWu`)`IcdRi=`oc*;+DpMG9EBn&Wj5uR*pwLB%w&Wysi66
ztP5JfE(KWNN$<iM!zz9A;InnxbGh*~1$fc39y8jBBp|*Z!_K95ekx`?9FIG;29R*k
zQnOl8d`fkh**EONs#D-~uJ3fAcLx$IPGtW`lE&mCwzxb$#YMBcnQCXW=3|wJ^-5zO
zpS+t>X80mK`>8j?^zO3q8l`fa0-G6j5Zbv7$+|enqvx+L)`^p-Ua&#r&~saWxEUZG
zeCe}&e+gKN;wA87l1%8qJP^w(g5sr3l+J<OoZO~#0H$DDia;S0Rf0=-7kmbJvd_;c
zI^iTS6Ki|7=D|H$sjwD%SGDUfTHk)TKaEKF4oV$ZKqFfkMSWMM?29_&dGV8pzHIhS
z)7J643P!b0ij3(Q-%n!<npf>Bm`W{)izbeOtH+Q7TLlf9hF!6E?Y)y8H@EIvp5PrL
zhi$1kQ^Ek6EONn~bNE?Jj`XqdAMFwE4={nP>c+YPq-~dAzQowkiymUrZW8KO7ea{I
z7Ww1&<Ej?P<|_5*_v2!5hWDh3x6(UwP!iC+OAcy4&<LX*bg>cePS+%%ha>oHKixED
zRR|E$&Y)}n8n{s3uCfuFZBCzWgmu-Q=GXH`x><F9HTGu=z{(dbDc;!qqEOMbO}DoX
zyxf%fneC>1=cNW{Kcb!VvMmN3|J=bgog2JpZ~CCDq(EFk26<2-{%rO9NIW0Ah~yJy
zDIQ({tB)85cxuwvR|+}X0#RJTuFC`|J~wz=0;wBRVeD=(OZWZKtkKU|#Iskw=KUOO
zictja<In}TenDU+gu!>o;rDW<+mffTWy}E+m?Yn{YEbF&C1?He7U`6PO@JH1y+~t#
z6X~>tym+%#4z<Uv4ZN1!sEw&s;q+RyK7$y78H6#FjLlJk?{bZXb?hgY%ln~M&QIkP
z`@KA>h&}0=$;s)DSk7-|Rb2uy72Z;6s2dU4JPFg53;99DDI#6=F!v`p;YmbE9Qmkt
zI`eDqjMY3<;Z`{t&YVDDa#YDYF+BmWc8Pcoxu$if9xj_dpV~Bo%q{1Qlm3{muKc{#
zN-+B~oBroBKQ4w)=|)aWwIK<T4{v{!<3-u7YqdCpbi_3>oEXP5G$i^t0)k#G@FkTP
zP%gdE{t$7TxkV7d*Cs@BJPlL!l<C9X86;*e?1#io{`l`^;XS8jBK_wF%N+4kkc}Sc
z#GhoQ!^A}kH#;Vy^F3e6Em=biBiUKeXNLAHZm-L?9Oe*Ixas`Gaif6qNPf&C(5#oj
z@T1(Dp9M(trB_uxe3$aZ&`<xM<kdbl%%B@OO7YyKC8`$#B0AGPgnQQ|XCI#zjaK@x
z*B98>+2q$Rq2Fh072G3P`sWLClk6vB{(B<`25h$4p*581byAs6JxW%p25deRZ5q@a
zg8M0?Y}3u?z2Z0l-=nh>t$54N$B1O-)`Uzi_Ms+ab1OB)9U%-gnTE|S7l&)Es9f+G
za%Delc+Rd_Rs%47m!j%OSOW$)>x;{;B;z~pC~kjm*=^rRV9uzyRen)<7tEmqe!T|O
zh);~)zYM$>_w(u-h$<{X<YAAn>N24wP5k+3Amdb{JWkcG>6ome;zV5i%0~spb%TXg
z?zJ~Q=QaTQJi~=PnSnRS#tcFn&SJ?fDNz<4iklnb<Vnq;k6$W1PQ@b=uSakqFE*Lo
zjU3r_6~oe-p<{~+D#+`8uNu0TFI-p#-eHl{4!9SzzTLT(fMFd*W(nhxjlv`1UI?=t
zk9J=W?c~7rpv2SzIG@;NbrrGsi0|0q3MM8`CsDEL$#LEewCp(ZGALg0wbLbyVdE}^
zV(N=Yl%N07SzWUdCXJY~Po0IscKy0D-lGYYfZ(=aI7~q%M49if1XOLg)|X%l(~DB0
zOHbdN{!a_AXOo`#?_XhB=(U2|<Ed?7folFsXpp9!(_t1#E3C7P4+<DC``KLzhL}yt
zrw}U%Fy4wDcRMRLloFZMOIC`oD=W&as1FJTI^SY<4XX@FX)85Dt$QX4CQGT(Da<<%
z!Rn+!paYQ$$tRlR*UQ!39ka4SKc9}5BXT+qV2)~I$Qz+0u*tmeV;lNg$b3eQnWGzX
zMR<V8t^EcQB5-^bKv-Tq)a#5&+k#0efnDh!+=0rjllC}jOjsCC3;gWGqEX<@=J@t+
z*>id=g(!b!qzDhi@fjD@wk*GvD1nb35He8Hz3M%dOp*^J85u&L$SNcoINkE9cQFcW
z_p!MhZDjc(Fzxlz<LxeF&3=jCgx_#dE_tV-zu(~`C;t>z5J3J2)Gr5z!rol99dB&G
z)+qJ|tUwoyuB8~GYX4`nvlQF01je-6KeI(js-I}oI~A2e(k|ZoDu;^B(J)Knt#`XE
z>L6=0yU;6kpGO|Ss(RJ1rY`IntCXnUB0^&s;6Nve^vtss583qxLE)3Nf92UE8=$%#
zRJZqoUSVgs3ICC)?pK!#r5w*^Tv{d9o3m6OOK0FI;#j_yW$q(xDCB@Cu?|a>W>6v`
zek})iY0~>;J0=}S*Fa}__w7AQp}*3_)6AT!WDcaCt#k<*3Ser()HX$0JBO?hz>dJ1
z{OdM`X~el=@tpZn^{Tzht4)swN9v&=Tp|{<9z7gG@|u!vo=NsY+uHu$&fZeFOAzyq
z;A6a&>2Vd_Wf)cuZw~Y6@j<e<%P;Qb#p1_0;A~Z*o=C5XYtvyTvr5KBo;-LZbjI0V
z#&0f71%Rgz5%OzW;HSXC^>P7bybQcZaldA8$fA9}9xRqWdrKU3`-S|@i0bqoh%AO8
zg@?V1`l8(L%OANR&5d(91&&Bc-Sm@q_7eg`0I4D0R+Ogplv}w;!Ti~Yck~qh2EPM#
zu3>n56h5}hiz>tW26)`3)!$ydCJImwW6pq^jNqg1$CbVTsu?J<%%Q(e^rJsj#Cg_1
z?!2A^T<#|37%sf%Z!voCjr?11s7D3T??L#k8!zxH5PVM~^F#?@%pj9%Z!5hTiB4-A
z5Q616$1-?XmXEjpf#MNgpm2~nTeQxrrBuuzzYS`DUZfzcRICp0)wT%rAHSCmP1L=O
z8QCSVXipfdZRel`)WU}O3!kleo=vKUmFnn|V<3NsoybF;J?uytz@_itfI%#5$>1vG
z`MKG@2{yYZJ$&65S*rcs4J%J}j}bS(WJfto($<Mc-MYTuZhWPo<4}-6En@auXFDq!
zfW8g)P_p380ly_+Z&f%g$@G-hGK*;uBAQ$3rxBVS(dM;ftdM@+kC*!~=nhvAng64K
zj$gU-u)Ac0m+8vN`HirJth!qVz2<o-^)%@O6<E9=d3uoa6~5tZJG;$Yyvj^UL)hBQ
zKPi3tIbfDh_Cu$%;(^Q8qi!+!f(_9EV^3@@rztr8g)=4Y(P%1h0&<vfzq9>yAaiBa
zlT&}ed1D#%ru8rtJAgSGW~urMq=#ND_BbYv32ye&vvJn(FxZL*OHDi`|Lr0LchXVn
ze7LgIr%d%4&s4u&rS~@Dg*-CFV6<u)sQ(6<HYf4dTr-cdz!xkL{#}sz=C3$giMG&9
z(Gy3VY{k22(YIp~cj8=c#$|d0arY@KUHCMdktB}=-w3_)Tr~ZOJS|i_49Y{S9n@o0
zUzZhJW1_tvZ}957Bhq?5IUKCsyaiyY@2dT1atLb!M6O6?gTWq2KW}v@thhtM+PK~O
zw$^Xz6Bcutt6bXXl>YmIS!wWw?!j;I^-tc(Q<A8e(xwv8cth1#H>Vn3NpI4Ag*A`l
zRRZiDsvtVe5g<{k2#KQh{(#;L6grBp_yhLwN;QGP{so&JsXj9fq2`a2z=>~;m4gkk
zkNWUM(N-(l?3w3`k0tvppDwFj+12<s^gI|$TXHsKyF6nOhxe}NlD<n<)F;mQtq>pT
zDfn}&aJj7iK4-=ekKCorCpfi(CcV^nR}hQGZGTN=$r|6cllmb$wvqMF5Hc_NFqQ=%
zEFAnw`&XGv>`hwt&q)7DYPnL-dFvmC{2dHF^h)O5Czr=qJ8@XhjrUj(EGx2SHySxW
z?kfrJq4;!{%jJN1P3l{Z$p9e5QeQeJO2U-aO`<KSR~?=+20LbCn?mWd;-R+0Kt>YN
zN1Xh}i=_;+OnZ5<zYaVKo6f0p<rB?-XKTL{A`5KFwn=Lc=?`DDN6^o~p!#961h+?4
z%jN`SQ9Jy{hupd1i%Z@WU;kG)HPq2NV`bZqgwozcfCh&i)oYP^TPG4Tg+B9G&^3Pu
zQEvpcT9^DgPObK?290Gj6eEB)y)X4BLAf*&rMmbxkk7*A4~lgzaJqZ%tZ*3)X(Ip#
zUelqBZX4)w1@<8Llb6yi?zPj$74nCV(t{Ya5plHm5M_Oe->G}ri6(>o@O||Q$)(3c
zeh(~6ng}X|7hQEZqt(|&U0NJ@6U%T&qvM3@4xO8VBpX4^NA=yK=_PlxZx_puBu&Ff
z#@|xEJi-psElYXUl?y2bn{M1l`z&`n<ULa?=)js)wI@|3l#6fiq~jO^R4s@vf0{zL
z4tIn_z;Bk5>r3N8{>xNr{WJe%Dk<Kk#vmob(sv%DkI3OCV78lBaJ~=z)k7EKuTxq+
zp-t9-H4Fhftv>Cyu8i>@s`Le?0I@-G?HvoCjWClhEH<s|q}k0(*WizbsyTPhVb<gL
z4H{a_tHHCjwt3pnxU+ONI@B%Ce?g(2`Qg5G7{D{IV-FfmRFN%H`VU0wJQNmCKkD47
z_i`Fywg{?Trgu3tKFm_xuBqn1(S_?GPW4)P#EM-c2+SCV0Y3NYc!jD1<9E>PIl8OK
zSB%MwjWMw=OfuKNJ&g}*Y1~?qr)#r4uP%b}-9(jn1VVtL;I#-tI(~i{qhY_FM|YiE
z3?<WFwgYO^PRQxwOa+qBHrc6{;vVP!-b?;oa?}V%9g3(R6CD1DS?~~(%Z|)H1bsF`
z2lp3MUB4>Xo;nDaZ#!%v<EGQ>G&%)yaGmwy2`XnI0-Q48uo-)mjN-rXozHF^MZ9_9
zj)F1shXnG<d`L|J?x}oH&HWYL$iw9jr4RF59I_l5&$;y42%2r_)|70zX!XCsPe}H_
z^Ig{)*74l5`P%%D+SavmMO((mqb`iI0!Q4l`B7|%Gnij$`Oq$fc%xqXtLQ9sqy^}E
zGzrtWXsrEK(jIR~5!Bp*Vn|8MjVa#7?4QCI^MRTku@dO^u-tVp<Y~+L@yjKWgFzYO
z)MIF^N_#nFaXYtrYuBUy-t-oIph3Jve@g(Srr61^)ASc<9NXZSc14wche%27k^w<_
z5{%J|44K1WN1)PWvt)0QV$eO?!8FROr_*@ZR2yz}IX^(z5HswgWa&54S?dqRXuljv
z(>tf|2I;<yIjSy;c;r0}uVjZ{A358u%Y_f2b=_|tKrs<kZc{Lx2^wM7KNX*6=dPKR
zwVcZO%jePBXq`y4Rw0MPm0F>;Ya;=xC|AqK%01k6B6TyD=dGfLMyYxI>lYVKvQ-H7
zBmacHkrM95A<6L5_UL{h;h>D~XC~XaZkR^u<O<kHJz`G#-b)v*6vs%B<piUrAKBH=
z<12J5Eg@yh;?v#a3X%W2+t#h+Co;<_pK%{hv}rM!1=LKv?Ig4U=&OT3V^d3tTn=X|
z_ycA3h~}uS{0#b)GF!n~w1+&pN)Eyr@xQLp^_KTVR%g`ynHhbqR8T_v73)9+$B-(^
z7QJ&-(dc|txt&?ZUbQ={s(&Umn75VJyNIqvpY@>yta5H?dVp~bjZrphf=(&Q<%aay
z|0$WYBdOtEv&TPfGD&hVUZjs6IPfWpb6L%MJWBhSlIN8*E)U7Z)T>(D4L`(*4iT)-
zkwwD#2I%kLQR~!E?&%To1<=Eyn|;ucDMI9j-u9c4SnV1q!L)QDR=yi9iE0+DQT*xx
z_OQeumd3Mh@qKP43P_U{>T`7RhY!vOiP}<cZ(7IljyzMjDbTMBn6HLv-!q9Z{aUG+
z73Op7PEc7Xue0vO0Om|Yq_;fxnZkGW86Eyete^S#=UxTF>j%-UO{7Oj(jNi&gfM;&
z<CjoWA(!3;$&vyD)d6;_l=sSaPGJ`OmC(c8TJ=LqS4pE!Et3_=ZXBg6$X(qFb-D4B
zt8!`7zP(<t9S+{bO!&k?x$*2#D^r5QoOp(7#CDcZiuhF?Mv8xCfG|A8X_fo@zro=Q
zHkt{o6NFQv(a0?+UU`Jn1ot-x)Y(wHW!=@NEd_z^jklC=5$-16iWE-T)om*-O4#rP
zdxn?Rpur7&OIB?Gk>ERbWPFF?0C)DM^Yhn%4uk~QVOTWIYxXF+ixJK_gRRR5$)~$n
z4Ne<v-l+NdAM*tNe!n3%rTg$qbi(Qojm{#M%6@|8Vbb$d6{A5Z-a;}kFBCnvwdpKf
zt8{9*Mg0Q>Pfk&>r)*d(+g3jsx)wyJrkQbnUIBdkO6e{)8u0qrO3m2-n6C~kidybC
zy|9A=DcWU$APM(72yY|qA!tRdqs~e5x31l*yp=E~daHMU_E+)=-5(hiL2dtNsY?*2
z9N}@?LghlBv-3-=dQvC|M`E-{$qf53`)s@B)lwh)kh}Vj&f?2bYZ5btA!P|wurv^5
z?Kk%$&nWDbYHbs^V9A%i`Kj6zl?}4Liu)SP?#OgYEYd)T3{UTiK6K4!LQlKd-<q)a
zMYbNL#g+juZ1ju}M!(iaOxv9SF4M_JiWwpJ-7zZU0hX(m5Mr#4{hJ8M&MvAt)$)KH
z$jXzf)*24}Q`MMylD2wTe9{|h{@K9qK(hIVRyBjIJEyNnj&MmpgSgsgJVZ{abF}&N
zX|ICp+X$x|=b?pwNU^`c2J}9lfn|dnV@mfDbeaT(O*osBe|LKxSc7Y;HBE)dwZ*Nw
zE54HKYrC~Y=%6iV`E7Ozlak?Ztn`ageKmZ#5@VdY3jVO;X3u1kiK(&Hdhq8Mh=uGj
z4xU=7ULnKRN?B0aS-owA;RIMzUhhhOxd-MEu%Jv;N5econOl6bPgJ-o<pCkGv_`E>
z#-fvSx%Gld>D*=%D74jMx9qcU{e|Ih_N}2z&?2{1)4m|eR-WAtBjOip^RBXsqfPXb
zpkc@&&h*+vj(PG6nCpd0_(M{iCSMijvU@7GHmUb!`0h}0Fqp|RRyXXuC-I_f<;bkY
zPcCRfdTq}{M8lt3=oYW~f(6I{A=pG{iIjbiL)%;({I1dK4<?E^v!ryIG;8pR9Sd0D
zf*I>5$!ha=t)m3@xq<U76{`>HTC~)%PXc&~U@Fu%PPVk1GF|#tw4~|?@nB&IL6lLv
z*~tRbh%fU@gNkQ#uv{7X$?ik=%^S$APy>QFL@w!uCs1U=oG3#kwxnM(|I-5aeJwQT
zQe<YaiHq!vNiVU}KHL>j+tmFKYRdaSvl`06JY-T|%glNhH>4Bh$@m>$Rb~@6@bucz
zdB<GcUU(k-wAuvD@9KuWlce`ZJ+9_Zx6>^>+~T7dl|cxE*ud|<4kqDBR2b|$K0!T_
zLvnxzP@IWrTb7)k+Flk&L<IM`90rs7Z{g06^HoH;J?h=gCaCBO8rDe6c^Ls{ca_s=
z*!C@HqROeon<04BlNBvh9wbV|)z$buZ6OPK{>x^%1;x*DVHa$xBaZ}32K6k-;ah$5
z^Aheb%jKnqx=g_15PG%1zl?Q>yN~`7Z$7TP5RqruwCKkD_9aMgC{}n+Sp1Og4lJ7<
zZyq$`iX#6XriHbaz{+sO1`P3pA1lHkVoj@^sGJbQtTad=a>>iX4a<ze6JhXgZl4QJ
z87A)4kdwG&{L$_W<?P6M756Oor9Yfs{t27Zbes>RdVWrD?&x|`&#QH}@HWVv(2AUj
zF)p?OZarX>;gXTe93y0eIjpVId9OClf<w!^NSD#vSb?2FX4CIoj{gn!^}euq79cKe
z{LbImLwA_;-12pN*dv=TZp@7fFjzWZ+Sfz-tsF#>r=!h(9)T>l<f$vFkWr1U8T>f%
zDvnX3^Iw=vE?(8=ab0|2NI4aD78XP=S64SZ)f;e&!NzpF?_{`#pC@h((+=S9AWw#6
zd+h-2TnV}{3%++^mcWrs+n_Ya_@X9Qfpc`_Q<|_><mdx?{u@CYyTlv1PBO_VGO)^B
z<U22CzsxT&=Sn{<T8-@fBMj_5Pr9pm8<z@<SCx~uuE5nm2@bMnl)yY>j4y)>jaw|%
zCme?<G7X2fsQ-5=PpIfM*5v156Cy$~Z1|#)Lg~hi0yhp>ANh&R5o@vvy4d(-g+3!o
z@&0;S>OZ`lQ12-|t0~gUZ{iJlK-J7>C@A-Pan_(2Q-}dol_-NVZN*qTOh?be?*jE<
z&dYp151C8xYc>do0#rV#rOK(6AG&K4lc&d<1lISX%oMOi3J@##YQpmJ<LV#cT(EVg
z@8@*D;N#g0J>Okth*;ooY$sBLeO;b-!0;tW#O5=g$kJ}Gnj$sjix)kTLw`3nO5GJ+
z+Y?TXxF%f`b7ehglkuDw^LI$Pi9LIVF`q-{?`6#!@%^+C5GT{gk^LH1R7WM3#yYBR
zpO+8=$Mh6(-MUpQy6rk*vFoG8X$YNr0F%F%gWSU;c|!K-U7U>E7Ga!?A`K|RO@y8e
z#bxD3QC<@2k4%!<<2K1Vu`^Pfx3Z(-4~S3<w8db_4kkWYf&&xr#67<rF^KUhB_}>x
zn@7~UPFtQF4w;W)a{)6}AMj*H2Uq|aNWEbS0S<HB6;-@Z{&Q&AoBtI+8*F}8Amqt)
z`dd;zI&L=^+%n0@sZ@s0c67{x%JzHsK<t9XFnlKt{Iru_TN;tu3S71aS93Z4T7osg
z6V{fAIEU^9n?DZWZ>b*mTSmk8@XAyW;duU^i=w1U!^Alz>w<nzcdpl=jB$g9pEvda
z{n+w1_))VEo0=v}@JUlL4wHZ^GYWIDwd-Z@n}zFJ^5{3TW9|>N*zI}(!kc(;RF70X
zH2D&B&1GNwRvRQkL-Lcx5NZtDppeKU?0Sr8Mlbh(`a<haeO>~@i9hAGu-9>J5IRSO
z9$p$?&LzCM$~8e{&*dhaIVd`-RD{qD{GE<U<#%k#Ctx}my`(7BI7ArRDgXx;Inj%F
zE?bRJ!w|>F_J^Y5QHeN-?<~HwF1{R{60%*RoP_7YNO%TqeTv@^OQhGAj<%kR#X!QU
zVdgfF%tr|0jKDYKR0#FhXpnB7%FTKZ8)~l!(@qfdF`1qgpH}*WQUl<xZqM&3bu(<v
zcrfrGi(%-K=96N#yVxSnu5Bujxcu=hHEr6q0MuUC1l`K1xXS5&6_<cCytu>Ir|j~#
zeKHw0Ker1w^|#_X7o@QR3T23I^CBd*IhoomB{H{^>5VbXniM;r)hR3%bD5CJ{!^F*
z!;-cszsRp!@pO{irMj_Dy?PHJmZs=yc8058+)0|cb72=0rmQp5Zj#RBD-3WB&6YQt
zuxBm5i1RmC+PbG~;ar>Wk7Zs-Md0qoa9M*k2w<oC0?u5U)Tp(4O&DF&*(!7CjeJ*{
z+#T6LzM;T;hQlh#JnYw)UE4&X1!Vsf$PQKO62yhY!1`Y$9w8^HrrDZ(UsLPhUqg7a
zqR!`*$L8?8V#Bdhm~oe+ikLok!xt|;F-$)>&hExFwCtDbE`E+r7>axo^(hmBi)3hX
z<ydEB=xaQ}k!j&`tLuAlu`qnzPVp;;+GXPWwa7CX(v1umpjC8mkZb}d^M<$xPLK2$
zzTMvZ6V=~9C_#9Z3@P=PN+`&^(2BGr8aw)D&B5icavruAO-`JXhWM~0>$NKHWZaA)
z`UH`yH{nD_GRnQ=+EpxmL<vYa?|wgybt{9Y*6scCt=zIk+#i8e<e{W3k2XKk=LrG~
z>UjJeBxA5!?=xWTkxjEVc%C6B%8YXws(8N*2Ph)|QXp=oyL@thsZt$M6^8(u>z@%~
z<x7ch#yBN%n?dnb2)FRHCbzuPt|7fzAHG(*9PS#yJ`rgD1~qi-T(dtkI&I>Y6fWVz
zeCMko^okExHoSN|4b~{9u&AMtj{Xh34GX`=-b&6a55qTaYc&V70j(Y4eEOVJ9=|#p
z&&#ZeFz}BiQu67ibfgSY#UgdMoHAxcWPG(3ixgrYkFraIw1n*PSI?QNq@u}s{)Szp
zdAmb(WOK5ySau}Gvm5%$Cn2K!#v6A}HdQ-`W~TXlAW=r#hxC(PxI=nvOu%!Y@S55&
zAx>*$cxHT~dLI2A<I3|Cl#MRt>zjRABNIwVd(A(gGmv6sh6*t;1<S1^eqno$``GS>
zsdY%0Yd&-j*O`zCJB2Gf4FV)*iH%qa-??>ZiyTvo!f#9W>oN2TDq7Vb`aI9jr4Ch3
zx!KPBxgk)yCkO}Lj?13FY~7W3^AFjk^GgoUqwZIC0B3aWofMis4rOr3p@Q|u*;s4i
zP>DoRkE>-;Idy+%o-35CaZ;uAs0j3=OTyp9_cf{haMA%dZ!A)hO+iziGdeORDLl|F
zjtuqvY&H;j9U^J?-D>ngL33i37L}YS{4lPcjHgtaFu&xj1%$cxOU`LF1^jgVek(NG
zE|A7&J*Cx_U%|kKIpyQ{_d0)--y`UJ$jl8KOMWSu%3CG+Nu?a^iCxAN-1@478s|p5
zr8~fM$fW>-AvZqlZxBxsuD91R{vuD34j5(@+JmKO=h(7x?jn`9dCaS@7<FK=-O>Wn
zN4$tR=PzZFIIyiT8(@CL72d;Kb;=@DA!ik4U*>5BJTa{M1lz94d&nF6-mTA*gtz}h
za{MUeHZb6(6ZJl50&*EwVD~%mKYuZ!p~<m@gV{H2O@7`;@(2=j<SW%Q*W#>w-{Ro*
z&~df%vjmYHt8cLEp(_84xl7mu&=%zL7O*vKSl<jswc{I?D4$r{vWFZix5`2?^xLBO
zj)AP5IOO;}sbqTPog5L&M)2@}jO3fX5@0G^I+Sb}BH7%BcZ`PH_`*!AZaQVjAbZup
zYGnk+&=~X<`}fOe?K1m*i0t9cs>H$WMcnGgw5E*H83W=8EDo~m&q>f$BR^+)^RlS_
zwi@M+%Iy;w+zcs@)nEq1)7e>|75S;Od|%(C|A11MzZP2RYW<u>XH9eFe(0<mEhdh3
z`zufzRr=FD;nvgXiKoV7=Ht(i+4@sP#dJRr;Y}9g)cU7|pF6I0MLvKPKRN<MLh7a`
z*;28LR#AfdMW{ury2avs7WQqsxe;dm)2pECYw9Lo0%R|w^n#HNx!GWC+f1e-;kO+*
z&Q5ogo{*8vxXurscV^lOB?nPZi3_44y+54C2ujP5_|)c+8!dAT(bBaaYRm>g(X0{m
z7yK8Zh<ctjU*XhJT)N)bhb{mQpj##F6tpG+iP;Dz*|FIt{DW1p$cHI!V8=O$3Yy*9
zOW?vrK0Vz>dbR0Mp&Y-9J`ZcB*)M4GzSb&}t2s2mdB4aX%i`|>H*46R{2LKBv0L#l
zrDulCzxafX6DB&-C!H2q8KL_R4QeNrsA=iAX-u2EV9+;UwPD{k)C5#Dq!@zj@QTeR
zh1Bi^Iz<pscPZjoN4}vyOje7pTSUfdzMr5oK#%D@`%YO?W4lU7XRDR%U1iO>`>0c{
zH~($%fhr|!G4&m`CM~fyO3iGAoyet%CxQMtcNa?w6zB{zRG0ED?%%nS`02L*n-i(2
zKlR1^fEFNtf+&@TE>2N2et#v0*Qh(=dj<zYP}BG05a!(~dz5<9p~U=9TQ-mX@YXu#
zd1nZ$M@{tz!NIfi<2Tn83=h3G6H1?BllPk$@qw2;GX&~6`C{WjTbd?CLG&Us@PHK{
z(HRv(nrk3>Ts<6;A58!w6R6y)(AWst;%X0d-@00j0Zhwuy$XF(Rr`>eLa1q7hDGQW
zbq5^*uRQ0kPbad~^-a=W+${#>k~F*DyBU4;yh9#Q-FwqwxT5&xeC$S3dQKwAMVUg}
z9GarU66Q!<a=>=T=NhSp+SE<Y2BOrigaXc$qDVMuFE@n~8XYd<fu%u?K1oNF`M%H*
zk!3j0__V!isy6dp+$0$I$~ibm3nJ<Ed||g|dTADiP2h6|n99ljK>r4%)qW539$W3-
zE;M)m4!EOsR|u=dur?ZQQ!HC;)Gv39jrEL^YJj$3%M7P;a2q4ut~pnDTTxXDn1eJ*
ztVask@oDWK)fwVyVH@h}*~Bi6^YU<deF0^o>3Dq6TC=)|hL}PT|8^JkUine&pSq5D
z=v>jM79-0@R=YYQ7?vGqN+X~g9{yfNAEml=RP*XhuS|sR7K$p!5!5BO>v&>j{h>d;
zb*&R@Sb7x2Qx%8m`}3W(R$?E1);faXw#dh%K5#WL0sJgL><h*!5X!0aZ8aOZ?|P|h
z%$gc-n?zJ@LL{F_?Q14l01#hjbei)tvHK=_1_?-np@kv7f2WB`70Bg;YhFn)P1tS6
zP~g+L-Jez&)xF|FacX)`B)z`R1-0gwgg)DeFa>XdoFBJagP`73c9jONsx`}Neq3i7
z^mHwG+SU(f38cFz%w?rD(QOz9SYYJp^=zQxl(#(5D1G#ccQGKH^lO|3AV&|D6#9<-
z;0u40C_)~nm!t5Q9lI<srW?3ZG9>war(Ah#vv$m8laKnyn`Y+CsgiCp+BEHRBtSjp
zuTLvcP)a6q>pq$cYQ@4<lH3;i$YtC@?KdLF_*b|Fz<yIiw&A0hf(aa6KYsR`QL`zF
z)3%3g&1%}S<NIM?3}b95wZkcvq$tJ!NjdTjp}DDCfVLQq^q|~N2lc?w0inPf-CzH9
zRUqyC1SAGFIB{T~!n&R9Jd#Qogi&|`q$xZnS^uX6T!hrrZ$>)4e9!w^a>q$fbgNFF
zdK^}>bf7{$$H#v4%e84??y07VvmTX2i!DY|w@JdPSJUfsZ{0PnEFSjcDmn1*8yle{
z<Fk}N2yL5ae~uKm!7l5QGn&||Nbd}H9GmBc@>hg)b76GH0zaYo+Z)8cigFY2Vx(tT
zug@S@ZzA5+YJ*wOJBVn;TrHCv!uUFs<*YI9tqyjtz|wdO)|Ba+cT_jqy&2y=Xqq=$
z)tV(`ST`!_Gc@gX0=lu7&=e=65}$ylJ$gb6*MdGj?<1F<TOvU6)T^|ZP#M%%$yikw
z#gXWq7xA%M921l#X8_AyUA_h?-cD%x@y{l`fb5$)c@TznVNOY91h|8l_J~X|Lcme@
z?796^I6c(hFMxZt21Tq-F+Dc?37o96Ooi1xgg&ahm16I*0AEB|KZ7-@=$3I9xld#q
z_|}T#PO6kv_Y~SIPBKn28zZZDw@tI*=MRNM4}9bHqu!#E-TS_lrZGgqfqZNZOMCn+
zBL|Dkwrw#hRlR7Eut+N&K9%yXH}25BEum(jvOC#XHg!geQ>C03TUbKLlmRBNyUwqz
zv213rfi6*Y)nA$@LF~zXCA8yGmp&c47dRA_!ao4r=5NYiC_|JvR`W}c#$GjL<2XG?
z@~O0djhAEc1aC~)-(bvtY$FTq;Jk4$F)aA%T#lt`0J_iJ)mlLXj(F}PJ9EiRlBkJ3
ztdKY#g(q<@?&sp*Pm<`fH)zLRyfRTqB}S*~xA^)^e@cXlB|e+MJUxIc6;$Rax|zDg
zKM?=x;`KhtKb@Z#=^+(CqGeL<S_@<76ue}S>whYRRrqe}O&SC{rncJjpY}F81ZuPt
z@S{cMJk%OdPxHKXvrGR<b7~cZ>2OG8Aw5U^;6}UoVwrVybK;BYw8$y30!$!+2GT<r
z8jLG%*~oxbry=Exp3NhKshi-`O2GZ0tza16Z^?X}E)U>Ndep=Ohq7?W{EkhCAoeHr
z>eeEEb(+Q{Tcrjq8?-RYzjB-67jJtNCu_cI)5{dS(w%w}1L5(#&MOU^tn}VE{uxuW
zWDAjnXQJ%v&%}s~S4<^EW$#Zo(@AI2;|pZhk=zYMJhlZBvss?`t|)znd1Gr_GViT}
z_HvWp{fA;%U&jI>Y)ghmpXh(D4^s@bvTYrceCqKnWlI`%(mt|I=kixB?qr!x&^alT
z?y%f5ACKK2EV!!mF#l2R2kV9n-u;Ogt-w00%K}l=fYjZ(z-vzC<#)B-m*{B+QDPfn
zY<ESy3G(qpLy}vgnW-x8ROP%Skj@a;Ikd#hRiV1?P-&jsL97KP=8@AXCvf06l3X&=
z$a5~=z$e!IT$Jevu$Dbp2GM^>5LYpA^iSI~=)!5|#^j?d3Vl&Y-|?k$w+`KDRwjim
zD3$!0BMxA_EnUQbengS2z2|sKZf*zNf!I#ZO$l=VT6swgxl|o;HNRW82mE=Z;y1N$
zAw;<R8IUun=D@WcY$Nvs^azl*-Y<pQLzv#`L4+|tPr4DTym`DhGI{SHg%I^fD#PkD
zt25WuIX}y}Em7K<(C#ADDe6EVUnFLZxm~CyM-aN64-jfcymb>b{P3ul;ZvFw**9F1
z$riL@tqZ_rt?c>BKn6RV8=R@VaN*#Sclw6^sy(&jK+HzL!qi$%7oWJwVv^q@^8}N9
z_AD()9GXi3F2h^49hnc#mX+tWv_|`H+5>l6hh60Km4hMktLkp^0#^?AC4^oj@EhGe
z<N#PUgyznz`(x)%OO(9^g|k?(gp*;>uv_@`hkmRKo@}*QPqDS+xQwJS!bE>Mb9z(R
z3F5OSBXNTJ=M)kMYU5tv+qo~!g=F~zf^5c3IB$^^<g2nDwL;xyJ;?q)8+yr+cCvp3
z_F}`>1v`@#o%yKD>EGmo&So?Jq*Y7p(66s%GK94Xo=G5QBt+L_FVzY%Otr3VUYqw@
zg)Ir6Z7&QuQ_D};c0^{-IIr0Rr~62kUYPYJi;JkA!&1}x14|+komPAqlmyT}68$6;
zJCXgMe=zw<-}*earouh-3|<9d8>aXUmMvNOVK$mSFHBD{!(;ogx@|Sq*!d%dN3aS|
zQ*Qmze@p}Za^<|Au^ATR2`t%jJCTOYL{vDI6;xpfKAn!)F{*p2Y+LpV*0?j}frpz^
z2w1qa_SG<|^OHdxf7RwOl)i_%jJLOr7c*SlvT);Fh{?#DbQ0FckT|^4)t7l+-}Em_
zepYXdG`tfO_eh=zwbHB^h2eu>lGIi_eW(XaP`ei1vY}@q#QP8%pgYTHge<oB$ToM!
z%@LyvB6p6D(h(pUS*769VuIRFmL&9b_QjQ*5Dj!Cm&EM&nPca7+@^51MvuEpVF~BI
zX8n@*HZFb^Rhm(Qp!aFhcO7#+lNL0`B6&~q8ltgAMB4}>t5Q7Kkb})kjHjj(;k)1y
zLT^&yJ7)meS`^qQ>}&?j8<^eUTkom(=UAIhSTHflV%yJk>1-59c-AhMuJ^|5gvVMe
z|7$F*o<}qFdvS6j1|!O683827#49VPxsmpb<zs1v*RrHLvUz^=z@z`tQ7n}~7AoU{
z7^JQd;Yz`u<!alBYfh@VHbY0A%CQZ)NA}n}AALbO<k%tEXTt*32?=J#$O9^hh}**(
zG8;H1I$q(MUrA@glYtC9vp#82rS})4vrKF#rxS8$iXth(Kn$+v^PjQ@1Uf8&1muql
zBtLv$94sokL)Cl5OLj$#d-$Le*LQC?xqGuPk2i9%6YogShhyaT>Y2!T2+URzd)N2#
zFLqojdA4(b9c7D2K#>Jlp4E4^nUsevSFiGCn{f=f9pEi;pBqQ|Ah|)d1sOiDofhXx
zbgR!w=*q8=XKaDljo^k14U+fdpI^&45PxOsUYIz2kB-VPa(8#Ti^fOm<kqg<r8Kmy
zSf4K3TuNKz;iVs-srbBs78pMQ9_G6zCsrM!w-dTH!V?yXX3ER3PTgzVRk*#j?e_Ny
z8Agr%C?uBD18KK9zYJ9LaTe_%V%^WK4hBi%dQt4JELR^qX^%h@VmWK&DT;v3bpL#r
zQus!<M<f6{Pp_v7AKEgl_8#OV|CMP(u;-PkMI?+%vc>nb`~98)6j~V+gkQN`XM>7a
z7ounhD1c|KFYz)lE5oe?z7@JD^2BnGaZh>cRtZ%m7aFU=lhx|xM}^C1suaJkD?=z?
zH>no6puMQj5WNovyaJ03r~sV~JKhW}#S`$FZSV*C!9@`O<&p+l;!xpNwa^>4aw$5f
z@ncljL<0{a<lGi%$+Uy?$n1#O0d+`$>DNfU3KR%84Em?u*2~Dh`KR8aiah}JC3akT
zYFqd|fJy(VF~jpLH!f`0LCN1eGo_S==~ZYV<~|GJ%8#a&r~<<Y)TO1InV#2_frSGa
z3^(TzFBg?rt@74N<dTV5DUd?sSMDjy?lm{kz;QGBr;A;w?mBUne?&!<SuA}JN%;4O
zBaBtBtcpv8Mv*$z$wAEwON;9@=IkDwepl2+xRe_=s!iajtrV~B+AiW^2;`R&YY+JD
z5fIp;DcF@@Zg#yon~vYYnocuXItMZM6YRLF!Ku0A;kKdN4CM{L4nXyay3Oq^Z&cif
z()hnEWC6hklHZibqZ8?Wp`f4@&PAUVzz%D9a+$!TaJ>gL<PcZJ`IC<I6itkJR2)c@
z)UOh0F%`^fYZkb<%|gfI)24a$)E~pFjl6OME^bto8!RS-oIwaJ!$C0AkVCPe8Y#v`
zv5Tno-h!;<y@*6TO5gPgJAYFfoP%QPxU}HSG>uBFAz9;MCQ8V4maNvwS$d<0wBtJR
zQCwT|B0B=LuCfnNg1r0DRuXz!onh3?@gmD(^VL3#I^cn*Vn(WAhAGrg%$y2JFc?p*
zFDCu6mk|k71*Z_kx8Rz#pms;P#vtpy$ohVAk8%paauy1{HWP;2E=pPDviO5{u@@Wp
zq+%x+_K!S(J3nQa{UimOtQwMWN;&(q-)C{$fzH9htsPI)Ei5LtCYt5&!&|-enf*t&
zQfmLYmM9mwak{ISdtrbnxKj4nu1l3ctj6%<f_|XCTOlXUQIqF6_O}}ma&s+e0_!$*
zT-%bm-^pFVDneYgiN5E==iUcK6<)BUniElN{L6Sqy%5J;{>P&yRqvmlKTEgB?umzf
z^Z&QYkl}P>nJ%}-7vhh4J>6!%>31Bc>7Lg8Y&hj-+`#I9Z4FynC$FEQwh|daf3+u0
zB>FYY^z#;$#&(=0mSJ$?EO!5JeF0H*y*vNDw|pzu5-EZ2<uyJj|2OF<y}m&4w0=kc
zamyP-9~v!}*JlBcWzWZ8f~Jwsvc|0mg5o%qF0_B|I@d3~jKy!sWF4z8k1sq1RS3rk
zTs??3+X%svV{=vnibxE7s!5<-3n*_C_)dOj-zu;*_>?E6_T$h46md<c;_-+q)Vdp7
z+Y|>3oqv27d54qq=eH*}Timbi1KdZ6t4PlMD3$y_&*cOL<@X{z+Hj<`=R6t+n3&0j
zx}plB<1BwLnZJw1(ykmO^=U?xD)pY<H&CE37=6HNt0RJyCY=-l;wjm&@P`fZPO}87
zvp&IV+Fk7?Dq27erh~MT6yV3w&vhE1BkuTi;_xHhASb(gdeF`f`COh<FT%Cjd&(`P
zIP?QFQAx6hRp|$B8r1nJFGBs%?8s$;%6m_>Pj{(#&R)%U;!mFb9j(j1yvaXTmbAZl
znK_y2pI7#88~{SR^oV?i3q9xeUNyE;z@@~(4i74vlfof;Sq)xK6C}Yv#2`zJz3`eV
zp?03LuNetcc6%sE<k=W<YteCGr}W1q*k=tIkHm&Mz(k(+V0kK$E#$Z{jY&tSpEEwr
z)0=@U0JS+Bbo1gY-s&Un@yNHZ3^8v_D3`+1I+@2CUDvvo`t!{T=)HQHBQkCCopfr(
zpn7Cie2b<&&Hii7PJXs3a{Dtv#_QhG-)7C@8>@d;HPFAUC)!Ci?M9K}akstWK7)@F
zU*r6tj;Bkvp3E|g#*5MgxlmY_t~(no>yGE{NDAJOB{<76z2DIRK6^J~Y6%Uv@2ap^
zF+MPjZ|OY>_NUtU)MpmGPmB#fjkUl!nhF0~;1|o}ljv;jl6fxKQaJ5<UV=*#MFCt9
z-}j3KR$y(GA#s%Jr$-lt81eSr@Y(`)d>4SpE6ua*(1xr8<%--DEYitGbc>~~QmrQG
zf^bRMkdr7;1YB`M7RwNFA@N%`2d051AJIzXS%5n`g#=b1|Ea~Ks+T_p$_4(kFMeH>
zJ8aZcOmADa7d8$b(HB`>+p>=69|@op_F3;A^RkxBL!Kxc`pzoZ{}VDa7vgV>#smqN
z<vIxsl2qmZkM@m?orzAJ{!_DGsx4&@WO}Gjwr&CawAz}J@^bGEir4CayMS)y6$ha7
zH>NyRjB@Zfb5@ko^P=4L|7ihiU1%UgiZSd7R@~t5<z$s&6RjT7!$3~vl7_PM(_=j4
zcye7XJCN#2x++X9#(&U++Ylity}W|{h9es`0H^A=pG*n%zXwO|oYHi4udJTv<}Lt)
z4mTab%VeC=q=&0$EH-O_KPPMVAWGvn<_xl-&o7->k=En}b+6_D_*Ph~#H%>!UzyT-
ziCyVx(nuk8Bs9Esj8GP7k<j-ROZjV1+Yg#A+=)|H7NSSOr$u^Y)}#?XlQm@xpI@?@
z!TcQDAT%FEl=xaazn&%-Uobrt%^Q&o*%#Ice~@;U!PyyWF#Q%dyuso?(cCcSE%*)4
zwZ&FiA+2}s0Vsm2t|--gJC>Q0v^u$~TnvQTQ9%0<s_k?>7lq^TXFuzno`JC$xIpt3
zX0hyKb#doHv$tMw94iR+&i4#G^l9RCc*jtsTBme$1jGX2qrh`B5yIjlgO%02s8#IH
zxed^A8-vqS+;rys6aM%}%cI8s2mC+-zkw%9&u3mngpZUul9-6=Mq-eAMK!t)M*v|k
zwtu@M_-I5DqgKQtg!xt-o2XH=#|L9F2;DVrbd+O$)3;E-D;=w~%~L5H+ev8Wc<tfA
z(=*UWxO~$>PY{4T&=LxbP?buT{EYr&V0|HJkCcRPg{JTB1DI-SM$Uu?xUzILQERbr
zToZx*o)wx?p-DO|YeA3`xq1_cjkx8T&(bLcjqq!6w*`YDoVs*G4b@fs2DHEF-NxKP
zczEG^(%r@+VF>~??a6Z{_lu}JYJa+Vmwe7kMJQ&FU4*d}aRGBf9!}m+-!K0nnjo=y
z6=S|e^VSY>h`O#2;jeEC<XhQ{U;8Ak+@O$0vSRbEcE#bDO+$?sn|kXwiZusufMKGU
zwO$jqj}#|raS?jHJRRv!-)mnErh$sa@p~t-%|%vu<r~oKsaPYt2V}p2IM3I{y~2FG
z<izzx+NpS?LHmF(lTFrm(%080Hs<+L*p6s!xC#t&7y049l`=vRd$9~}qf54$(6{UP
z`0hTM(sWUa9^AV%lI?#ou)d6LS-rxAyN9ndxYpJg5mm_9C&t~cWNmk}OIVA0+Sj5^
z_Q+X5r)0s2gRbzRzbz^l0l-T~T-6;v*g&y0P8g`6+7r#5u6CR!5(HmKtQVReus>f-
zG)HhVA%NLz#`d-;_v>Wo-n3IgdbhKbZg-Tcr>6N<g-0$nRF*`(SS}%F95nt_meaCR
zN)_dFhiA!=!u%<_^fg0Dc~$j&?PX^YcA&NcS$I+A`dLA2x~DNTr=R8Yp`r{zI{)ZZ
z64ozsk=n<0c{d>Tfq|5Tq00xakkmbIB^gm>g`{@sez@MnExWq{bLmZuIhDx&&`98S
ze72V8Wr5$HzCnU#%)&DXV$W3gQSZYyZ`3(iAUqa~mr7kg>C#S#($gE#d-CXcX~PE=
zDN&TQD<FDDYE)e>)>LIERE?O&cA}Gx!H~zsSBX?j(zHg)qwylbI0}43WbHT~B#e$x
zq+lKbTBN9`(R@CU&Dw1cS?Z*`GAg9Q_b9Yy9>Uu70xhyRg*<O8khOW`^MDpa^dZk?
z4MqU2^DH?^YGkN9cCPFC^_03857iDlp#^k#2zZ3Z@~`IzjG_R~@@jnRpV=gNa2^|Z
zc)*8|VtMN495GMSKkEu@qz~+`<}<?)225n>ahRshx*~5MF>*rm><H`tLU)MAb7*cw
zLdAf`Y7PjVk787T`c$HbZ`!%|3N-?78Vx+tX~f~Ey>6^U<}uLalY#X$M58wfgwr&A
z>lOfbvVD2;8D)<fcVd<*9=4AmJ54M2vyhW6u`K9<@73w-d&Cu?%L;1gSLI&>APJ`~
z9Z|t^S+9t0X>^|fFA@&^_J#Cq>@!6qELUGE@?Q`e->DSyVRdx3UPVh{U$jk?btQl{
z1%uajwP2KxajYnU5R|W@zMmO<D4dPw3S~Z8r-kBdsU<Uc%me)6hVn{^X^40Q6ZmaG
z@&Z2$9e+xnDbIPfN<qFx=xPXJ(%th?8ank9_0l&6ek-GlZAh^$M{y?sOj)vTq$SF0
z7lGEs^D(pl1r|VQ4Uj<P`Csz7<pVU(`*j#W{8fi;ow1|Q5gg?z%T}kZ0<!(+x~(7Z
zybRy3)64UssrD;R-S%N34-3?Id#q{v>zKxQSThbd=5gLgaDf&9`RJ=<!85^cq$Rt>
zHykz;m3Blrl)H%nIQnTjrIClI`KH}HUZ<ex83KIHz<NK`9kz(@QeV&AdK~~B)jN3U
zLMR(qr<9$3qg!boSKEIB{w(KYX3(&gV@YS!!934+%}`F=e4f@7)S~gy>J>4;RSF#G
zgl{!Gc+svQZElnV!TSi?4<4mfy^&~0@JkUw-8(IOeuXJBSLQ+U#o(GJeuu%f|EcGH
zsBSf7BeJ|f2q5OxuPm7M+gEF1<p_XJM@nLzCB=gBsWCtQ_M?{ROK*_R#v<Tv{1I2L
z6Z?XSKWUiqyr|@SNt-<Lb@3kFRx2=_w3RZ#Qg&G8@wI-0sU)nsm$8|64k}RvyxL{u
z9!yXK-)`U}H&z(L9((Og*~?^4xM0i_;0MrM3qrVk=a2Tf8ULfT4^Xnns>0xB^J4G4
z?XH8`%}#vIAZt6u5O^$s<E387c+WZv5a%YK<mG-o^C0sbGLmpF-F9c=vo6nK4yhdl
z`}ql7YS^4CgH=1Jb<<alZ%xUU*0q;e)81(~=JXt->XT8%2k6szQjb67b<wlR#YMN}
zhwSU)dHD;Z#VfRZpp8*4p1<!YJu~yoZq)21?TO&7gUj0@dbaB*qcX?<ve%1Y{IJ;i
zMW5)T`b%9$e?2`=AEL*x4hKA}l%dUDPiE%+g8E6<UOUjklLp^sA7Kl)*1t!ZN{ca%
zdOU1pQIO&u97fR8b?Ipoo^K^RQ+q4`fxfQn04}d;c)k@3&bPuiasj&6t^EOl5d)lu
z%SZ|Bh7jdjx%0ooNJzuc5(td$)()U}JBC-jsAc)8u;)uJG+ySHfgP*$(^hB-ULz4x
zP-BpJFdC_#(He<na%rF1tbo=Cs}}LBAmjgJV7--&UPus5)7-5?0LM+t2szLZ)gMc=
z@;bNDKCZTp=lW^wb@Zf=MJY)VoFi<q&Y1fwoqwxGxF~(=f&w1=eS*$yaZk|IKJv8H
zbW4OG`)2y(mZGkZeC3xj7$DIFVI_ORRLlM9YnY*~5Q*8+^9f>xs$MjqbStZbzD4mj
zY-mAjg__NI)VCrAtsyE)^6Wn-m1$_C`hYIkJnC_C_D#bK!t%>~x?79%i;}x>=&Q9m
z^?Y6YlD2s1I43KNI7AtJ6oQ-SR3myalp~}o)X*PLeYb%Y5!8){s6-jaOE3u*Za|zL
z0(D7G4K0LuAr)(?_Ju>84rVL!Ez{X53*axsYWHS8+K2Ii%f4|lEduR5k6MJj0rL?4
zNxLm}4C2@H*Mh_)_tFi$(;I^sLMlHQSns2w#iLXGjtjS5T)moUe<T9o{=}=5_I2IE
z_ETLvmk@Pe86yY3an=<ZEgddEi`{wF$(hy_tdjX-VDA_0ph!F5n#&3>X-5w>6JGBl
zNpH_266VAxwd#JN4#6))c;N@ixh=L#DGT}VsKz5&zV2I=$AvB*vV?NI&Y9G1B(!;U
z;%yhy{m)!teeW$_N_t)Yxq4NxQCn7_@^Qqx76W7+A~`Zs%2YZb>vc|69xt;Lk&TtO
zSEADM`TX&tLFS>AsGP%<)sPtnX75_=Z@0Gvxldk9-_G!Q3CLeq<6xoM`G_W41S>C2
zxB!1TkIGG89VBMVpO&O&`M{yT43-DbXJfTqE;bQ-#jpE<`4B((Q#>mEBCLFTvFU<J
z7o`_8{{b+&-&ht&rgX6$TL%!TU+&ZX*7PE+m)`#eLKH7mC^Tw3@bg{s?V%$y1rS<C
zywOzVWO+@!)>$a9tWv1RRZ##cBJyc*QA9+17AWn2%^?&Inx`^^VPH2<e1`m_=b_yq
z{%7F6ntt#|OFH_Ht=6IvZG`rCu8v_}sD8;_FsMU4o=>$yTc>rlJTZ!|`!?ZNmam`0
zavoMsyT;>0og=Fr^bY8;$mI&zv3KYpMbXIX8XrY>=;4+pmuCc{XzD$W%y<Plie+@O
zwHiNVe>>U~e%5aN(XVz`Z{+OS0pju5>JCHQ<!Gs&7hQeZD9xH;q^Wp{jkE*D8}A*S
zd&N35Z!}scjWFPY8A6^VeloD$L&J9%gwr&A>kz<kLx*y@?PI{L(h>N@_Hnjx9Q<vX
zrof~6<1Q&q-fDGR7NqY#MW-ZIv0o%wgNXmK*vt+vQM+5|ixz7zWN)P}(zMXKv^-Bd
z|K_QY$OMtRsKjNah$o@=p!zaY&b`X5zy7%li+PIN4SG_Y_9BZUA%5Ty6}ebIXcJ>`
z5R=NudLiO<nR2;K0#TWR-_P?v!I-PWc{5SK!3oRz8-@)LpD70Q?IOg#Ov=%WSnG7&
zGaZlhC8F=KRC`BP)EP7za<WEQQ9k10xFdKT$DQR_^hC!FnpxDoDr@fZQ4sT_#v+F3
zdHx5t%Qj(bQ+f@~7dzsc=M3!p5bL>F>lye$;1u|?G}?XJl!`@H+h1`{XI1K4F95JJ
z3N3lURa*6M0dy2WBFYNp4!@BmAkW!z(GIeq-VDb-@nLH}4xrg5(FHR#johui`c91y
z+9I3N<&%N+4*J^FtBDkVOO7|u{&^8|;BmHnU2z&Yp2I)YJ_5fvofon4E{%8g#ZGZ&
zC9+BJD?~dSaGA>S37eNoa2GrfPI&*C4#UR&30C(IIfAdF+qB$9ywj-O7+<g*4`St|
zO@cIE){lT^QF3=NS3z~FDFrNB61CMUN`K8+SM|3K%wLjvz31Zt%{o#3%-HM3XZaHZ
zLU3rgVoIxeosIRn^jbh@-jo)|3ar;HPd-K~9j}##f^^rDEd%PEoWyDcfaO8*p|MI%
zR@(ji`3}rwPDF#2Bqutm_NFXR*je)xv+3Dq&degpGo~1ScpeslnDP1!M+d>|hfB|l
zcAIl0$S<ZjQG|-E!0u+3zLq@ihd-E4_>n;C)f6JDf#b6iJjGaK_V$e~B+iNgl_`)<
zNs}Hzu4|iig@@8pWjWXF^B1jwdoVbO2JH6=dlul4Hf8AW;c(bAl|05gwYMN)4WRg(
zETU(A>Pnk5-y@fqB3&O-HzU+5K`vV=?fGH=?GzpWdmY5}=FjqUB+KUm`r7pryMy{b
z3w#QKr@el*1kF=D@ULIzu$`Pu7D_DbA8N`LQ`b8st?+q#H$7PUH0be;hZv8F@`hvy
z_KNmo>ESrIei%V5;>J;#yQ_?=&@Krc6fbOU`FMmuu=!Rv;>{=*j)cYzV8+-!Z^!4#
zgRlcD?0KaxDxM(B`DH$OD#e=eqY)s~PC5=rCxUjX&`6cR(;0<lqAtmud&T(0Y$^|h
zpA4+KX=4556iwVW@v04DTL1tM07*naRF;J&e>Woq18#}t-V#?D$F;_<9P~W}9@QVW
zh=}B^-a$15dg-<cbbf&VzfQCO(f!L3jH{}6+T7xM*Kx2GchlFdPi1<GqPJ6BJCJ4f
z7dW_Ks^xz5s0CS-7gn%l%9NL1s9z9!y*@v9I`*1mQC@@~Jwc;9w{p^IJ5-v<vgiR~
zErY?dmlV|3K<}fb>-AJAxq3x<Z+y)(vAsaQIWIOTt<vc{BDLfCc%YhE!*wDULO8~+
zOXRGvxFP0yzWVH7J3+Hw4Aj{H8Z#XSRb(ca(sJ0zon{twZ#pax>rTxM{ZjSsoE?m`
zNrX!YN6xlEHkK*D<onRhez|lcR>YoenU*fki{J)&RzesA4dHyhz!%Z9G9@AgQ6ol}
z?*@NcLt_Ch-|E)>UC?(?iyqud7GBj(%mlC__>+NkFWvPbG&AsCTfLg0Q6>V`KTb;7
zxq5{P$OyK*?F>z|k2xq$+GkpYCTvL%)|0r>R@fcGQ;!x^W5V-ihe^5D0v4}0e1TCm
zANQ_aZ2(s3y;(>u&FTiCugk8&{?Av)-29WKbNNG3s;p=6q%!lVi`yAJ<q8p}Qs#dV
zgDDRvmDoxs2UTJHNFegdNf~E7J;j&)h?f~K|C>P&t5>{+@=Py(B#*OtVq3k^r?=$%
zl$<!3_*Y(0{Vw58ls|HIRb2#w{H4NF=1NJ~mtIf#rk67aGG<^|kk6A!A3n@yB$3WE
zk$dTW=d<x7Ue`R&U6fYh5Zf2uvb)N&NT}J<?C545>JG5rCFbk`Sr<NVZ2mkfjUVLB
zaQcU2HIK}l;-PdQ&1d|m_;Q}t&n|heT(Vh9#I{A9okUg_Jk|>oFGs3p`sU-4Gavxk
zK7Rx5vI9VR2tfO0rPDOfjy;F?yMa|Zh%}{6P8NXkoIan`hMYlDJBfrf1W%f0-BEd3
zhcEA<`5T2kf+&t4!KZPk9#{o|-7;UEIAO$T9vzRo_U-N5>Q}GG*HPC2)fZ$>6heri
zyVWmwSfe@}K8^qV_NmN+=xqC$$2$J|-)8?9wNNtGtYv(@4;fze4#d4v#x&QnFy^Hf
zNpFd~tK*rPr+#ix#E+szL>ai~t9&Lh5iR?r!>fLQf_ac{rEH7JhJiih!_1F<bYve8
z_5nTia%7c$9M}PZF<(C;obH|Hi_j6mr)`C$GzF&-DBeFY5400rI?@gUUd{yS3;{I%
z$-ugcj^2V0PSeD#6YpTS{EJBu*!{~ST>*bschETY?wO|9S6_Z=-zY*0TfGC%2!cyq
zeNti;dtUCQ)d~!_6G$%E&(qH4-n6WP>W`b~K3(p`{r%;4i0ARp=D6|~rc$OJud5&4
z8sm{w`LFf8;^$I8dH*c`$fqnQ{dAiLV*R&!<rO9WD&L%6nI0YSlxLQ0^nb0<P?N<I
zJIudAr3~3GSUDx@?}^tV^88T<%yU7QHIu?_tu6UFdzH<fY>3~8N@p<U`ZluF$w_&p
zG|AXY`}pN4=@oy>Yx8TnT^^wP*X~#&AA^CW1fbq?W@FQ5wJe7Cvf}kLE_*A*p3<TN
zNbm>t;aO2Xg1S7JM7yAlP~<F;>bl5DYX)e&Vcfl<BzZmLs~x9IqIj{o9M!2OMvdEn
zQ5`ymTt2hH>s9XHdi71;BXG6THLaUIR2Z=hi(-AsMn}=5!{0;`@MAk4-+b7pv<VAv
zqeNmQ9}hxjXiDE+rJ+W#$)t9Z7T%?udE%3v6$lWY46Iw|d#_&MMXwtrDWDW_M#|22
zOATQFTUR`3oGIi*(w!oluqDc?@9$i_x{&sADeLO2P>11qH09UfU5|nb(P!vgNl6SC
zw;`8Aj$kX{MvE_q3V*&Mwd@ZNvti&lpW(9-C?-dB1_P=@$Cv7;ZZ+jgl*qjT&Ui#l
zdrBv`Khho_K2y3vN;1fqDUTnVb(Jx-SCePa^!dsgdj0L0(yo5wGQGq8Nc!<M=j;D;
zC_KJ)8na6#eaf7S_^qi}2Gcl^P!nsx^Gn{}W@}^JOs#x&`;w(aChsOR6NvV?6JkE^
z(3Z>&&aF!_OV5J6!8BxcR_hxS<Ci<JO&6l4#4og<*1v*UE<-D^<m1#_3E_>TGL@v4
z5{T<cFU-bGiCJd%7@S^e=eZo6l)kXZnImYrg_JgxbNl((JUJ(e>drZ9L{2+0Iayhv
z_}6pTOe4)Cw1!gV+(UUqW&{YW%XJa6A~z?<&k`Aq(i&8rpU80`!a!J~Sw^1DgM#nb
zr`AtLpRqT>(P=@@u0#3oY6}MAYNezS;o^#@PoS(?^mn!eFnl{rshwE{+%IUehaftY
zsrHD^JgV2TmBV(9uBRTyZvABanRW)(@f`AI0gSIp3uD*vXs?T&s&hYC${zQgAU&k(
zQOX0ao^K^1g1YBhsp~T0Y6&JnYw07sGXg{-MjJ_*o!!XOo-Z70gV9Xchaj*I#Jsaf
z8GDUQm;xScDfMknI#T&o>RBoD1*fSjNsR64=_WLi4kh!g3gV`n)2ICn+ok4j0H!49
zoqOeG1ywKjWMJJu6E8>zr|Ia{>uYCtx_wlCtkU$0C9YOEY#IGMD>S=wCH}ZYgcG(z
z2yI+gz3&`dT1vq8SaO6Q;Fe%q7zQHR*4*|bo`}%=xtDHI;U2K>YW}N<{3L4di@54k
zoBit0`~urwbA6)nG6g(8%P*7&?X>krTH&I6kj$$R*4HD-|M-yamk!v*s`MM=H-kre
zJ5oFGC=Or5iU`~7Saq*l)d`!X;@v})#z5z?01hlqzPh{lupz9|>^7ec`}blZgM&i{
zzBGv+@|yt9FUU3!mJ|rvK=QkRVSkl(Azuk74lO)@wsba@Ykpbl^1aS8)@t{(cc*>?
zWzDLKV9#BwVmxTzG03z2OaV7+TuwtKhG9Ca^AIQft(0V<`&`R#D{_G_G(FCB&0(i3
zQ!gqfOz%Cp<MT;}4*v$4RO?Km(`6eOHe#5Dc?kKWUW<mgNxM=SuRFs3$-vr7!xtyy
zpHnn(>&4Zpv4m0bLc8;%c5^SBXRJ4F`9gn8wco^?6*V$@U)VC`?bCOyUac#oh2ncG
z*^z$1Yd8gH*Xk8s9aRJo6Wm1%6>%Tx7m*{_LFj(=5#HPUcOt!CXG^GifT9G)1Me#W
zG``GuOvy8$Rvi_Ra)pyqkk_Y@XO<(Eo}8KWv#lSmbFaz{<d1y7d&<drrt`2~$Nyl-
z>iXH<Gksx@Qbxfm8w*|wPCrtE&(uWzaN&;x?MFEqE198;3mFd)=Y>%@77I#N7+VGE
zd04N%QvJj11FQY>HZN4CPVmT21v_77V{!X}XFJCyVwCn#?zm$9E*P{PZ*C!9Uh9r4
zRLmgogWavo?N|J*e+A}Pmuf4<ue}tdUS+`6nMz6*G%n7v(w7QTPS#WSZTIYw?2w#?
zm36`5np!Uep_iVAc)nQYNv)?yYp1gbK<DV?e-+y_1;rOl9Z&vjEKr*Ec-GoyVU%8g
zh^LfsR@JuFpqS4a`8H~X5tKx=v$4o$YJjt0ZUUVRA>fneKgYHWqq2-(QM7{2`gx{E
zdD;8{gtPrJ!>jYQOdS~TsV0u<q=ELJ9e8~cBdmk+8ya2YW9@kS4Xqkp7rlV}UVHJ+
zPLGEkVtMlUR)GhGJkiwoRx&y~A4eHjz8ATQ7db}|<Xathpd4clBdCtmIOLUmK#iOs
z&t^CnlR=N+YHT0t-g$O3-N`NnQ}l#VPq756x)rUS<P~|f*GOrHkw(Vr#7rR6<&%N6
zljvae>Kfr`(G&L{)flyp0XI+6Z=2JN<5bHy_}d&!FI~aSma)Q??^qTjZ(gJGiwk%@
zf-bLU;KJ20hRegiy5tdEw#*@+`Ev{11bY+4t*ZVeh=ft<v?~84&s~O<`ut)0nkRnC
z1E_QUIvZ=ZOFsRJ!g4X6r(XWuMLP*A)x>hl`_JNE{WbmDzk<K|BmE)Gt^V@&@HhVg
z|J}cUfA4SN<B{fw<>kCAMLl>j_tUF?_sD0}zp$0x)&SCJSpW?`3MGpv+Cz|k+vbI>
z5gJ;RtBw45((>wt%K4j3Ln!b=o#TqPP#VcP@gcL0E;Q@04!>$B&$-K6sn)AoJ?xfF
zSIv_=Axmr2<I@s?djH|3rue3{(BaTv+zk095A|DqM7#vEy40o{o^P*#$e~yx3k6@0
zgi%Jd(AQ(T+3UxeI4&X;AZ7qL;AvdPp0_p23;TEKJQ(w!9njbJBR?O12Y0rwn!;>k
zg?!+F7<sAm<cx2ES4O#qyjnQtMaK<I3mA`zIFI21bz$mf;*?%<=3BD-RgJWlT8&W6
zUP2I`1*~m!^iFl5(~oXFEqW4Dw|(sXWs)|pUg1K^=<ivfS>$+g`$7_|Qhs)wx$O*H
zTXev4Vt1@`V8ERNaOn}Z?fH2BqE)7g5oYNdFIwF(b$K`4?G<(PWWEe%V25`-_`87w
zYP}=B2iMgoWK>XRQR(F-tyraxYw`7TQWZRZwEe*Rj|EFIR;u$a|1JFEfBy4_{?#Ag
zk3ZnAf6$+Pz#sqgs{OmiYZ2-%e*beN>+$dWCH*J=KKz&eG5oE+fq7*r{WHQ>8U&Rz
zmy{Kc`Q4K8>rBd%FK4~i1L84Pt2TMCrj^I@W!Lgh-g-M#ba~i5fLM-N>t$C``6{Bj
zo)Dv&IG3)D{>4ykC%|9Zr@mbGQYiRx;o0hETZZj~e9CQU-!%hv1M0qIlgcB@r>%*W
zA3xVqr=>Uk#m;KYy*a0KJuOIUD)?vTy3#a@dHt2d1Z)DEuu|_j`s=LGZ2i_g#Pu__
zYTGOz!cT+i>4dnnidS*6`*!h@u)oA_`-M9FB}?vWf4%kB;Cko-t>jTCmish#nihtK
z=(<MkEl@4<9Q8Oj%j=$c_ImK=E{C~3=TWy_Kjyn5fF74dksI>f(^l{tU^_ATEnyJj
zupggeo1E3R-xsS|yQiBso_l&)?ZjjCxc%VzsFV-v&jQvSx^eaD=<XxY-TNmojoL@`
z$10shepq+VGKTC5O~9_rpAj+JzLvCForq4Yc%7kjjjF)&fpcCc%bvP4mVPbn*Ts(L
zvO&g#=Fcs32j;T?w<>lU-Q3F?C|EV%^5EC4lIDjkmtVD2AE=>8^;hMFcEUQ9rK|kT
zSJtY2yx#HP^)EeMD-o}0++Y6@{^37^fAr7bpZ{z6t3SdY{z!i${JGTi<N3Px=UP}|
z$`aVmwWr_z4*v2l;NSZj_#gf){LlUa`fvWz$6x+FoxOs*N>!Fy3feql{J9{7{8o<G
zv_q^q@xCP#t;{@+`l~{rB_~PD(Wg4?nDVMa$@GcKhW|wS0843EN4ij}G`L}46l#zT
ztJ49}WnwQHN;iID@zaSog-$O_7>r=C$0^G?X`aq6#EW^gPgytb#8=mb-rF-d9ue*J
zIW1<Yx9(VM{IJGSxVV1+-T(j)07*naROz<qbjx!}oNs@wfyJ9e&mQDq4NLEJ$14IE
z5M7yWZ=->7nIwPQ&|#xT!o;dgT;(P@gw`sZ(DAgyJGASsPaOjKoPo80`tJ<LKc{Ho
z?&0goHR*@#Bb;uZ62T30U(0Ka;~C4WgFi22@wT^jG+sLB>Y5J(%FgTGq;DAb@p>ye
z3^FDLiCa`|fVW^q_j9(HuP2%y_}-*mc*&MfW-wIe-*R5gm0nk<&SPHl%aj%ZJlAZc
z8s!R~EcB2s;8<3w@<-eL^do&b@cAk!twQ}s*Z-LQ_>s2df3iOa{`Y?j|HI#d|Mefz
zEAi^D=&xV-R`5HZ-#s8@UA^9be(t8{VeC&o;156G-~18&<-dV{@-OJ`|KsQX^nbvA
z|35$f&Oi9M^7YE%`jHmPp6NKAbm&%k_-2$(cry63hL%>esQn|U-0#F+LM(jA;HdM$
zS3cLz79Pyk>*dwBbU=p(VQuEqCl=EoT?wn`S<4sulR8fd9M3(A`CnL8{6-fddk#p&
z+2b32dX`9$x&XBEYpOkax=_^x%aQt37wf&v-O2I9_Dugcm8vdMFX_o>&&Fzc$po`z
zPoaw>qaCHQv4Cd<9FNSiwLyAITTaEU)*!To7N^Z~GD;i2{S%0?(&Arup|l2Qp0$3x
z;XL_dH*J}~N+fw~wi4H?O+ed6e&5sEt!qOnpB=T4NFw@*=TnaVZiEWu#r3ivZt9Tc
zbN45A?$!bDy!?7<P=^tdsWZhR<n!Ztb;{E&x))5;#|U44P+z-(yk`L{^9gmP(h)xz
zV@1!twmv$Z(D9<!)4Vr^JUFk0$n%R?IuTTP9PoPV!sz;71OUm4@iX>VG4h0C@_{`;
z*bv;PxM&}52k>^lp&c;N-H)`S^zCX5?0SL^GzFn)R!GHEiwKC~u4se-f92dO5Hp8Q
z2G&&?zB3@4riojJqK})vD~%(Z)^6@CYo&3VZ5hp<D>VCZh_{-hiGdS@P0IBB?@^~p
zJ0CJ9C2H|gmj===MEttU5$&+XfN+zhh4!L785`e#Ztk^xbirCA?k=+y{zc)b&An7v
zMLS-#>G*O+I~Kk+AQphil_yV=TbWk3ej>{mRgnI9;s5i`AAkR!!2kDeUdvcNSEfn}
z`Iz>fOHn^w>rFqNFXrd6)KBJ5&sVi4SAH#TrGHoW`v?4uzkvVnZ$19o{~Z47{{(+-
zy#FpiPpeDxJN2$!{z<}vr-0QkWm3qK-Gun{YF2oX&&M{t@_dmEiOmRIYafw7i?rIz
zK^LZ%P0~G%Vxlf}S%6&7uEGiQA~BB-Z<z7qq~e3~FUB_P>$s%71>4RT;&{YfoSK_W
zA05SPC1d|X%eR-BsphpHTC`3R?k>4#(sDX>6K|FJI;lE+#q7U_o#iQrZb=0d4wdfF
zan-Y_SX7G>El+50^vW=R%`qEaKjvv%C+GAr4DC5Ro^>)FST0ZSZ=kVx@Mr{>Z76Is
zDtjYaY{LPb3p9Y=Wa($$g1!;-rs+Up#Gld5%`~v5(PZ~C|H;6*M0dS!968IxX8Wbc
z8a0l&?UU_);p!FFUPeA)ZPENXEwo=`tc%GrH!2&s)AygzXHgv?>%!XKwMdMuGGi!W
zI@c{7Bqxak!DhnJLCD__yi9kXUG#12b^YB$9fFO7cm7<%#ru|RHUp9e&PovFYpQ}g
zVPT#iAAz2~r4{gyz5|F@ZlSz3gjsmHj_n<UGnmShiqeWzTA9M<lb&hq>978p{+It7
z|IR;vfBA1HxAvF6$G`a9>*x2c^6~q}<L8y%KVE<R{qOO2kH^n-sQi=D6@EPF4}YRR
z{1JX`9sc1@@UQ;>|LC7R|Hr@g{M&!``EUP_KBV?a{(1%5k1}TGr6{bx@(*QW)C3;>
z)k}-lAu5<)Ck3^&mF1JUD~~*ntk>JD(U;Y3Tq5&1C+qcHt&$`mdO3*~d?|%nh=wTR
z&)@RPIa#R$v2zPf7q#mvOMZpd4qS7xY6LPIve3ltG?3N{vtF3flB{0nX6JRc8Mu$I
z9PIy08ADH@U8vVX=%qWShNv7*2=pAOXs5FY5R&x#K$F=AD74mm>&@(r?t6t0^I7*-
znU;NtGYd#&83>*;)SzC^nnFD_sWe}BS!UrmPw>gn-wfeOd!2-%v#ki@?3Gs#zP?dt
z?MBsOA-<l1uhz+Zt#h*2hhGDezb<W#+Rhvvh%OXOzwp-&c|PL<wHeg*<M=v%kJ4V3
zSEB2X7Vk&(IgUnn`Uv?k(9twM2L=`cRM#WR$34Y8j?n4x@}*0NJO?K{%6VqbV=>CT
z0umzzbt0ukRw@Nwu7{B*Ba}?e(ZmP<ZOjz?I38_C*x&KJku9>J9WC{o?SNNyKvj~;
zPEyxFJmUl}bp)@k)Ec1j5NK*0Ry_3>eeNlUNj+8N)3#|ra;Bl4+D4;trMegj4-|mv
zbLW$Rb)JsiHxNz}UXcrvqVYug2&eU$dp%oh9Oqlk)tAA~H-2LM<<u+dvWZANZ07Dc
zMQ7Bx;87<fYT0YQ2t{8A^c8^<NN%B>$yR&Usy0`=fp&JySL$&W$(MRLMH&4%t{S&o
z@~y($E1s0Kbs=i!WK%k}DrZzto-7gli@(DE?H|%V{nwa3M_4xJc@p+|(aCvODdp;w
zf%SYH<(|{8{`$wO{NoRL{WZ1wa{=OakJl0JzyBTl#pCs{!vEqwe*Aa;)#E?<Ta=S5
z@}kY}5+42*;Y;p=lVp(J;Gs?sSwUp3RHf!WJR=vgNoupnW>vwTaN@AL9{g{P&Nrc^
z)zoxxPJyRjSMr$`%g$(E&6mLMFwX{MAn{1elV+&>70adat`(am%*N^|Aoy`MO}{ak
z7!q1LAcJ?ArtT>#!ud^3MO<Bdi>~W8=Nj4+sa;M=>e(~8&M&8$BEx;ZQ?aNPtIf`7
za8OIN?=42|`nX3_X(L7Uc*(;O*W*%pl;FP=O%8#XBp)}_<EKl+1w1#=6#NtVO6sd|
zx7G(5EtL^{GO$ik|IGyX=M){?I<abYEP7DsOINQJ31?eAmp8JK6LBVcXwfF?ewEhm
z-?MtPVk;>KuXxl=t5-8}H?3Z6u)qzG#i-5%O+X|Fb`Xvp$NuLXL>+=v!v4>1j!5kO
zk=qFbQnQ?R#shhjvwWT*wbiS{KkBVS$cJFnMTTcxy~_ReTD|&t<+Z(@&SIy3^w06{
z{9o`-|MlypM^3Q%x$u+@W&gSM^fz8V_&5Iof0lpw`&XHmN6yd6HGlu0-=}{(h^ft2
z2G$>6CujZq`NN;!-~JK)&wuj#+kf}R-~WHpd0Wr2O7<h|+2#XwvfawRh)g*1>kr6r
zUhG&FU6=>(>sH7mw)2cY<_qL8pmUy-;|sLTd05Ys(w1<Sbl}o;b(dK1!Yvqo<st9Z
zV#5#lbR-J*v?0RZ)dk9PQ%14Zh1`iD6+e3~YVVcnSslGd?zdCPF@%)MmS1UEFRFS8
zT@Z#kwz&KM*?SX!-IAg(wCeo#-dPxCVPJqkHU&i#6-7~rC@Kh;h&~k|xL~3_mzP9+
zn#JccFN#SFYD_e4sF1`&lb5Ga6iG;M0Z|ZzD2lAZz#z*o!^|+-UH((=^j_6_pYMGC
zy?5r;{L{Do{`*u{Raf`vu2ZKDRd8=yXp=`#UQ!vY05ZD4d`go`o!0;`4QSlt#tI`6
zW^|kpOycF-SRB`qnea_Co@S61C~=Uu(-j7snBF9g=xr$V6vz3+3bT^w88dp;uQZdW
zhs;<+_1de3&RE&Fcx$ou8nQTwdeLST?#H*(hVu2=%`+A0lel@LZHhf&Fyf-5dKBiG
z#?X9ER%o?0A_8Y?Z!+RG4y$G@iA6CywM@uaFF=fEX8~65LQX5_%WuVTh-0r}tKcg}
zr1NyOspvml*|NA(71UQw{~IvbA*TmO;?5vh+oLQ|5XYUx_l{Whz_gPZoH?^QZ|05$
ziPVt4<JTnZl!)K;3U|XuqR8qlL}0Cf>d6FQ9duk*?HBsH#!=!}xvmW@wg)L=KUvd!
z4conkPlOd}=_M|^8EQ`A*3y01IIKCP!%l9IRXwt<d#Wn^?!ftAhgCMV2lU16unCjH
zMt>x*UbG`(@O%PdTCsa>_Xm!%Mqu|h26DJ>Zv8tbw&Eei%5H?zwrz%Rt!X^l;4Jm2
z^fQNW!_Dxn55nE26*YALp5Q>A>n3!YXR~eB+1JnLeDJ4D?9~}Kb*OOVs5*p`XXx}&
zb6N#qEjusL`LGuEmin1MzlsP~T#Ao-C_d&|y!aT{)K@whOQp!N-6`!%=1d2OVKudR
zvixDd9zv&#y6p*>Yu;~7d87u{aBlc2e@X`p3j-KOPox)D2?b$6oZKK8{at{6tuJDS
z%VPdeuwEKaN=`1Y-n!x>fa;(${+Kl7%%-`qQb}W}O}QdBmXoxTw?wH_C(r4?PTLV`
z|J^MR>5MDk;XsORBKjGM8Qe;cpT$<fND)p!)Eo=(MLg&nJ8HHGI`6gz@I248HrX6u
zG|&q{r#8|yl(bJr1S_LS>1;CUoF*~*`f)Km_78Q{A~a_18lv5u)mJU-=Vu4#(n)Up
z@4i^#C8;|I>?&zu`B;*!(=2k#U5LOMhP`;NIy&9NdxeE|d-7g&usuSVao>H69A>+Z
zXHR<#eHeqWE_~D#j$OG=MeWwn&OL%t#(Epx$a{rnN&E^p&ET%mk&Ic`ovrF0)1SQn
zB`|dP{uw;K!R*cff)7RMDZxSFR+$pFPw>F*(##K<7#80~A8!a50hYK!U819#W*Z@7
z(yr6{Z^7$tRNgD~(jO{k(+TZtQjt~%c=7S+;uCnuas6{b1z|0SEtdwz;iBV9OYNMR
z)Q|c`;emF3O^UwuZNcKzQiyhS-Fhee*?Z`nA6y(>q@%zTXF7ijne;>|@IvR8QpYm?
zI93T0WZ@gt*?*l7V{Hq~qoqSW90Acr2Y6?KED=CB88CE?5aXdt9-o_cFO{>9k8+L>
zr6q(DpdWFcUxuid4~y3@pa^rN*1UhWE69?|B!aBo8=3LQ2)QV$6#u-PKYK^>MK+x=
zN-J!Ro^pG+Y=Sr=qti2lFLGiksgT<FOwi++wKO*tRB`Z;4mOjWvm(kwPvkW~#ByVq
z@y$eMq_};v*5ZzQHbTV8PL$1=#gtORDd>&kA*MjbvLX8VMm8dh*F#s2OwSnV6*jXr
zJZloLv0z!2tc6e`-xlgPuM!<#^&sk_vCgy)xutS+s`WOZVX3{DtPsgt<|NSoVp%i9
z@=|3qhDrN$L~<kO>X8b0tY*E4H!UZr4;GkODWtfxa6Svt*^$NbGtSM#=FClJx?c?(
z(F~p+(|GNL`l@9YW47W29YR<YgASdtQe5Z+1zw4_%B=Ye&+Eb8J0K%3_!zxZ>L4SN
zRNicL$)$6EOj3+WZl;P4A^-po07*naRQd6aBED0nck`49hTAa(QC^6^8i0<|3&Lu^
zUHXO2u5kr@gmrRl$Tn}-eTKvpOn1Ak_NS202aJNdSB+eG1cI=>R?UyK-MLQtYfJs^
zFs*mI7<LuE1n7$$VMq1`S=fT(4j2&Xh&VbjI1BRljS9+5i~Xh2DB8nunx=w12J}09
z`v{-hHwWztdS-)&rgGMPg5|XGq1)jd?_ZosCS{d!U>&GvDeZ@v@R;^P9hf7!4(vKy
z$eKh~+97r7j4kgztrEANJgwdqT<}werd0XbCqx~71?Ek|<HzvC0X+E1>C-+M9&(lX
z6Y5YeQ2DSFlRgm3*88kjcF*ci2%aEuzaoA!W&6uqX#wR%9jG~=1EXAk_=9LIOCaXo
zwEWNfj~jz$Z&a?>Zn0|HwlhJLUkWlqR;ACbx_&5S=916+^Ae3q-AtTRCPtm3L%=+Y
zV=!<{PX;J|_Jc4(iR%^%GuPxx%FJSO_AB7jldTNxe{KZ5JoT|7hC>#&3aPfq;S@N@
zwTa`fz<L2{oQtxi6P|r6uhqG+uI5X(g^xy=!`cjDdxw_!*wO&UH|`)iUTj4Qx-Iaw
zCm7PtN_kiHzF$d^E%tjbkqZ%6y-+>Up!-<`)l2*OMOf9SFQ#CPTpORdag^*Z&wZ*e
zwD(DTE%0<#-Ed@r;A$&c?=0J`Q`_$j(|X5?1sj`zW(jwVw;~3xU%<{)ZWo{g;2sOu
z`Z;O{J9Sw?^vo^%Io=7`EkBs=)3I;WsXCt>$vov;PIx%`e%-T8bM7FM01L=?ua^Hm
zau>blCgr^{uA)hMuT&t_0q8_maIp@yQt?(Nrb|w!2&_vN{30ESbwdC3go?vDVN+s(
z$((g?fX3}*UMxCuNIJi}`#GcHu-<>`{1<<vQf{5mX`{?%1`qY?Sms$gxZGH(Jk;Sa
z+V{5L;W38O7?F6w89l3K=cpJ5V9&Jet&c@m_~W3_uEW{k)z-UFjx%m}K4V-DfC)JZ
zCc^m_qaS$YII^!&vN*CvJ}e;@0DlV2pTpaTq#n6Q;=+>o20tU0)h&MxA3e9XpP-~T
z=NH6yA|1-GIw>{frS_Hs#J;uXHIPI%KokvOITYuAIj@7%98Ys&aolTzYX+f+m$XD~
z8Q>!bRa~kqqc?$@xFZ`9DfJ2QtOTJ?q|}p@%+}eY%1dW)6_;f(Ta%dzR#%hLTYh}~
z*kPeQw0E4u^`-U>x5HLyZw!<h_@tFMg>S7=RciKqz@!Z&d8uN2g8I6e$4w{ZZBsVl
z+(P{JB(<E#(kj;2wCWfyXO#2xo8`AE;F(n-hv&zu9B*ZLgUl)iWjxgnF#SNPt5he2
zRV(PEeqYGy!N{n2!+_`SPz|Xeb7xPb6Otm6)JsGHw>zz}bU})&L=fW_BCxukb)-R9
z2d(Qi=@-`#NAb@PwAdabi^F6`neLzr=Ag3zM$W_I9iZ)EjY0=uL=e{3-j$a0IQoZd
zr)%f*ju-DBcm*)}cOC4`+hG5@v0H#%DfZI&ws0P>*bl_yv3qy-2adD7jw=l?oLozv
zyB$pSE1OgX4#@-_sK3qDBy?J5<qkmY?xDL+!#h3zH{7He9q1q_<-Iyk;Zes9+*^T*
zHww|b5@>c@3!y{(ox#&*;H3FEMR%WBsL@@g;jUAP>{6<%?Wg9uRX!}`t}^jlJ_u_e
zzWBTrFW6%rGCls`i$`oe(B~SptFzxFGzTpA1kz{Ya%Ui~4|HnrSyWPWlRcL*%`^W3
z<uoktm~IW`t^v&RsZWNOt@jsmkv(q623gq2a5Kn7B-y_}*^*<NdMrGakzK^U^H|bt
zS?n%_q>PJi?fJuIVg3eu7U$9;yAsdmPU_>6Eesh2bKHIr09HWnMeUffWL6sT<oq?o
zHj;c}T!JDfThCVjyRP{9In>uy3|mjxmBe{)Fk4@0&+46Hv(PX9il66jrUvJ%o=O^1
zlx2M=Q`0VtRB;5&#11%cI4f~j^$D6S4aDr1W^UgK(C8qy+SK$Pt9BdcVn4T@S1*7J
z(`7{ujL1fi&Y+^CJ4nRw3lUgt*q8U}toGaTUZL5Uz&P10_l1syjma_?pggYcLAF<F
zdr&iL%x0DT@d*2B1NL`{tLGN(a`7Gncl_+c*E%!Hv(nvg2X+%63GEBE?0gfz!p}Vi
z{4NuKodkfL4ICboRt*xjPx-*@Wi4(`GTN(U@}JuT)8IZnXk1sz?`IC-=G*aoA2vY^
zs-^n!p!%`iD-(fr(Q&*;MOwin$Km1=aEZp%&oQ3{YiR?E&+CNtcDZ*C)y8X5S=p`B
zXH>>__2Qv+et`+dI(eGj@qziTZl%K+%~$9Sb#%y~j>rJBJ9P6KOyU=E@{?1mE6JoV
zvRSm;vrwjOp?MUiG61G?i9@+eSnwOy_^mEGfXQ=XkWXS2O(z9-4-_RMPV70q>%cz^
zR=CNNrF~)1(_<+G6>ODKxxhr$5QX!SlR`fK7jki{)`T!z%oOBCHI~cb=wi)WhAb<u
zcq$%81PDQG_sC>2_7LObB;vTSD68RMMXl^JlhHf|Z3OEgZWh8sbcakEyaZl@tR9nk
zgiw!G^&Z!wNwcqqOw<WaILCEpFOP9i>cU1BQqVJTJr}YXL01+eO<rV8O2&mpKUoW$
zv|6Kjl3ARLYHa-!>a*>kUe9JFk@=!xTwiL>>UDJGRP5J%#jhw)s~$@lGxMF-a}8%T
zUmMwI1jCvv*E%=jQp?F$ny^MupIS1u>a#Ni`J4)6X2vD!SSVcw4IJ6pi1GSaTWzGC
zB@TSnfZQK8aG@W*qGF^UVCyiCNXp!^fZek)_X6;^9d~PusUDbg7+=JsX7aewNs3Hj
zWKv^P^0^7|ye>$(i$uWWx)6cYfQ|zX!U||z)arMjQyio0_i@9prLJ&@EUaU?lk&O|
z?j!EH7zMvf_g}CIMx@}qt?6!MU#`o6+O*S^>gn&N#lW_JyUGK*F?Ix&S%C)U+jqDL
zoTF?VF|cEMTsHp9N`C-AcM;irtBJQVHDGpdHf6hRrf}^8_{d%K*7r~E`|zxiUQOz~
zzY_;8ar<$&NPDjq{Ma!#u0JDqU|v<TdEa#cES3EV?mne*UEO(#?mD%Uppm7Vmr_S#
zk%`7y{8swqMEj1Rc91Eb*V4<!JZSptN8@D|D}mH^2z}lwJ<H7=(biOgu;#*&K;FM&
zHkf{YpD8V%+{`xyvpveQBsoA{6N+Q9k}^mEVLvS_3Sw+E5TC~7n5_H-G3Onbi7I5s
zMq}0WNh|(RhgNPZgU5fKsb^lhE-bz-4#gQott%cU=)B-7`ssp|(KLm7oIgWG#Cd&Y
zcC&HOHB?y#OeykhL1D!(XHij4g?iiGyzCpbsk8@9c`ml+lu<v!s7sgfT+*0XX!+?K
zqWS2~<g1`|*^$Lz^-RrZ{n<+gtul<uhP>?nMP_rW*-AZh_q$gp-C=Pfb15n5LIhR~
zss|x-KS$gz^mm%_*QR{_d9QFC)BE#Y*(W5uFx<g-x~o<DJR0o<to;m*204J0keP<f
z$r(D`brRz)>fO|P<%Hg0TSE+B6=3iEXtVW`63F+n#|66|u>5lY*r^~_f;$PI+_Ums
z5&8X)d!9L4T-DCJFXgLpUkB5Rs!n~Sx?0>%AHD-Vc-w59+iq2x76+61Q9dT+X*vcM
z9jE{+6@jJ0uP${#SSsr3n0*=WxN=3g>{liY{G@VVO;Z?rmHOR<UmecY1!iKh-uq#C
z|1An3eMDRS)9*j(|8)$<q^H2-kF+y+N0vY3qE(;Q40&~%`C??(Q5!6phQ}13qeC)>
z6lUnV-KNP(rVwKNy5XX*2W43;h>AI+Ai)7$E-Ev2MBWBGo;(c>IGAic=)RPvsu0=n
z0)s4EF4H-~iOJ<~h-0#ZEX<yrT*2H^tEM~-_PISKIJ#&o60sFd>H-d|Wh7k*rwDK5
z#v)=?<Z+c1JCk(?A{+#+z0I?*YKc=0N3JDk<K_k<bOmMH&p1GaLl(D+bHCR0Y^Q9%
z?JIf2>b;(Qy^F&V^_kht#zlXfP<g|tlC24$v`UB-BU2AP<}TabXe7E8y6CewtfW1s
zOk}^nIF%_=MA?1MG}RcHSr%!yJR&I$R3Bx?T7|cql6BSato4>xhTfTytVP*bnc|t5
zp2M+)hjD=zkH@7n%Thh(?gjN#ROn5v$^IS`^g~Q1Y;Et=iDpXNQ@rfJi4~;I-qEls
zHD>VA9o9;ky^8^plt}@RM9HpzOLrjxs|eDFQ$Sb&t&3WnLTA6YhWK7Xjk-zW0OfTY
z_c09q6tEZKu7d%<Kz!uNy^6s5IjW9ae*?8?r>ji8uZKPcHUZp~83Q}A)W^g&tQu%D
zyk&2ra5nqi9JVyq{!W<^?HR!R!Q<hpSiCf?G;a4x2>OjPo7qagGpPJ21m^WX^>&_i
z-yqpE=y=E7^v3JqL${IfH}Q7{FFuYJsTTuv9F}@j5KcH>)q#${T0BiA`_<j2)z3+t
z@yf(r-Ek7`I62>WQsGO@T?>9%Bd6473e8szbq*}l-y(#IT&EAa8b0r_(|s;Reag4r
z95iY;Hrb5R6WSX4jY4zka;FQZ8zs}8J?{a>k)J;eaGYy?WQ64?OEM_EjYXadxQ$KV
za)Cd``n`2d7T&>H!_Uf<#zO_XDob>pNiMF*7{(OLFhXU}s3^@a*wckO{WRyYz};)T
zflzLaM|eIrR?adRKh&joUz!ml7&QD|1#TINRhSXE*<Hj5>{+zZ#%3Hx+mRn%%(Z9r
z#M@+XlVPgfCWpH?EM8B1qm;=GHli8o)kZW5^N#z1q7|)<!>TVQ+0wI;#m72W)p33G
zh^?-Z&mEvkl-!zJy<kM?To2s@b_BsVhFeoc(w)tyq9nKwfmMR)t{wL?7kXS~d+FB_
zUU~PVj#g_(@9E&w%P<aWgxJHht}X^)+<S$)^fCarGU^J}17@qRv(x=dBk1UTGpoj(
zBCR+->sZ3xWn+iMMM9ooEc_fPoXx)LKsy5*Ik+dK4tF~wkhuDz`RbM{ZLkEGKqdXJ
z`=lUCouo3j>u4jeWOR0Sa+|KhnQpraZu*FN&180uiH#P_F>unMSjOLUpwq5v$CeGk
zx=1^-bfA{bb%i$SYO+5z@0B8Izw~a|Fx}}mEIQP2SceY(;B9!*?KC^lXZOOR;nsTN
z2+X2D;BoCY0h?=?{Kps5(mx{wn;%Nz_B(gx8)pFGOlZ0ZIJg-g%cNWVbx7x^h<2rB
z^nHMu9|L40!byPGCfCVAL@uU`#RYg7CI3Q}@Ko94)<Iuyty9i#`2?G><DPh<v*%gA
zs%oN>fI>Y)&(ae-91iRSM#dO-O>+2TzF461I(ez1XX!yWfwMJ@gxnr;k_OyG0hm!h
zUhkqLpn``l+&OKa)HRK?aR2}i07*naR0as#shfi7B$|PIga~53-suM<u4e&dvI1rF
z)`Nq@$*o>Y%>+!jS)AB_cs&EgxS@?0k3|Is9ix<M6S6h=I4m&QnCv)a+p~H*Xi0s@
z9u?yFWPPc<!_}OP>vNn-YwXHPW!I1bomd;uC`?|fVWjFKD=h&avI=K8hSUlR%v*A5
z`Gwh$;t=6-hSqVu)}^z)v0`A>>OibKxs@ub+!PmjLxJ;EG{q}xa$Y}_!y%&w5IdqY
z@0FWh%%IFD2MqvZq-J+Fc{da#C3&y1cUX|6XM!^XsYJ3AN=nEagA0&Ab=Qut8gO-|
z(BCianf?gP5wbW&b_Kf~WLMMfCaybxQSggY{{`bPA_DJctgkh_Bwdbz?R5RzU4P}y
z@<v?ju>Lq$!O|L&-2#fNZbN<u&O(<J*wU`fF<|?oObNNY5#J#xPtC;A*bo7GG-!_S
zvwHD}4vkAed1$Qn>riK~djBnS@{IO0k#l2_*f*g|IJM9^Fs~Nsw*_aNXMH+UHHh-Z
zc>)lFDOs`_F&jZeVOBn`Iry+tHuv}5JU#fT<!nagfIsUGBbqYkXJHlTz)`nfT?7al
zz;YQ*3&MB6cBr$*o$pVvg6>2YO30Pv&TX6pfPCu#1s++2KLZGIl*nQ^HydFQN5)P&
z!1w(Ci9}Y1=*9_zt+Hi7u!G2OZo@e1TlwsBR9RV&$%XzTAQdtBQw_3umIobdc7KO6
z=`i$8V7-T2YBnMeh7Or<7^=C{LIA2jRlibXBV}=aZuIqB8v-Y$jpd)o1WY2E<5p@)
zO@y?QZU&(lqYbFw=x|Egu;Zk~jVUej&VB^~cvM}CJ7rA{Ct07>v$tYrI^2wMxchz|
zSxZRtAKI8BbG41cRXK&jrKpd_H`FX^!pz1x^cbR(SUnZ$wXM!HP1r|A)=!hpG@o*7
z-ULLp*17t!21Yan<ns@vZ6-Hr<VUSzl!GM@!}V~wrq(wptt-M)E5$6HT7F{&HE`E4
z78m!z>?Vn)t3-Asfdr4og4wE9ZXFl;WUD2mYb=%ZhRIru4V~DrX7>WGNRamwhC^O<
zD-Y8EKt^f`RoT0tkWSu7p;d;CNiret>4|hqG0CMDBCulEm-lLYr@j4Rp`CsBQoCl2
zTw9;ad&%M|cK3JQtEo4JHM|@8BbTl0V(1br%CI=QjY8ZV%AZn?_Cd$`xx4bpHCoO0
z?=y?7mw_0-UZ7_*x*)?UZb*I|oP{o_3UE&cwnr3YZf`_@a-U@PzT~$#v(1Q&;3AAn
z9^cvG=4`39d}j`)_urzPrRyIv3aSSekfn(0FJ@Wy)9ii@b>b=;9z{+DSNZ`nSAlbe
z5LgG<%$#K^@QPC=xZ&od#^#ecRLo8@JJZ-_tx7mFVN&EyHet8NCX?Hc0&rHnuYqZg
z{4-wr<vuWR7GQRkI%gJHkutflqK+xS-4501UmwK7Fbe*YOhY7bf0pK>?{IPvWag`6
zwqJ^Klz9I0IJ(t%D#!&;$&D4sWn!`@o5uuW9FR{5G~X+XWDMs4Gj>cac^=SuAotZU
zV3IN%@;HZB(h_d0%I0I@+8~J|P!wel&U?iSI3RIrjU+7)*+`XflDOATiq9~kYy$}n
zSsWzpy+2%^MAk{1w&5$k&@+UaR5}*K#)6f+Ubczq^ZB+o?(a&(W?~19^){6pUJZP*
z?|Kqj<;-7apD&NqV?zTG9<<%iFmIFK*^w>d&Oo!4V|XfATFy#o1W#v2b2eEfD8X|x
z7h5=GBJVOQi5Uux*Ypokhbdl~#i_3H>n+n2C2Mtp$NB-L2ZMva(|bxrc3bA|Rv1ev
zq{a*$MV4{g>=q!02T9rR0FwwJ>7Xhd1nDm1z!K0p7$B^G)<s)&ildYf)=AW2Sai_e
zs*~(!-m6}2aj&X?6{_~PoIQ3iz<<=qenz3%W#*T9cdO>>NI&JSHv`;7id~q&O`7yU
zjnB<GslyR<6T#Njat{PzV`KNP?hhOf`y?HKMRT}3oMF_7NFTTKud_|jtin>P=ZMtH
zgRlH^H7x4YzX^{`CKo$id|dyWfJ=_!B`On^dTsDx{m$Tmn;clP&w+K?=D@nke1-6&
z$$_OZUfsTwCsjTyQ*+ny>uFkAE}-(eo7WHR7Y}tBEd9~LOHRPw_|$`|?`z&h)TcB3
ziraznsDKFya~sXci0c#=js#=s=67eaPZg!nzQt`%rlS=%ySQ6_E=0exmN>t*Mkpfc
z_&0pI{WpZu2-W(^bWSiNSHg~~M|*UNt-6a4335_^AY)RaTj7|7D|LO4$&J;X<0iVQ
zteL1Zy_5v22^`B+;&XPR#y=O?(G}&p&B6FQ@{^_wL&PciH~Jgq$d<A`QB?1Sw6H*t
z&WDw)#|C{0hxlAeo;l55Is&!k4fU>{J;jT|8q%^x99ddK2ecbrElYRy6vsNBdw?#n
z<m$Tl01T1Y1VoSWE*VRjEn5<G^;;!*Ap*;Se}GT`+|wM{U#Dl!dxZm>V;5OR5%=Z2
z8dpWjV0NN!PFRCHtq}o60Y?Vc^|He$9n*VgyF1u1<O){X!#4g1l&>C*!|u#r<BuDx
zhr}RHeqW33k#=K%3IG?N3hv3O!`&_l5?t(q-8(G4Mzu2UzPa<T&fBhIsdSKssh{;%
z|4tvGd6)3;P`|`S;roDx>|24S57p1fGbU5J{W*C`{kl9BJgoz=>?PzcC;jO|o9@cz
zz48gU$OT~$56jZuCA{G#`+>n(KbSV*3$rsV)b9-HJ4gK7(x?a=;(yJTDExh~=4A;8
zJ~9gc_|tOBSLisD!RV298{=q6ns+e}*kgN0o<+-xDIyv@8AkVf*yZ-(F<B5jZMJfW
z(n^446NNrJHb^FAp;*RD?127#wtC}M&2TFhVj{0R*by*!fsa~Tqs54FV+l#^IYAG=
z6o%1s=3H(N$sKSfufQqIjm2>nVF3aUxs4!-N-#J|T&rEbAMBX6rjy5Atb`(AwdZPh
zBn77RJeJKe3b~jp`(cS-$*dkSQ8PwAvl;ZHrL#a`YXH72IBN+L07Si=otb(+Ucp$E
zjksJ<fuw7RqP>fmA|2~Wyu+wH>(GDWFVi0VmqwHNY<or@!#FYyeM=vQ<?9jbOH-)^
zWC=mrl-F>0(VG1Mk`YNq7TfiZtv8Qjn5F4@Zh;QZTQb(_*?K}AcO5tIuyB`VYjM`+
z@p#36c!h~@segeNv>LDZB%+YwdcUGV6p;kZK%@>q+ziA$D_!#~?$ycf9pchN54Pk|
zLq-D_l?6$uDk(uya<+1k#wF#A2q>>GjbF%t)dL9Ypmp8;4lw(myfIB2B|AI{y_9ip
zlvi5LxtHz=VUPMR^jG`6(%st0+TBl~->m@G3$TKd?#^~nD~CLjn~^_K(k0m6!hUaq
zXfG9&(Vht+R{`q$N0WB>=nOgjxB>3?<D)0cfqFS}+;TgfIn>#UT_UY%aXg{&JuN<|
zgVU(uq$ZVoY9TS5Rs@&J4i0p>bhOT<Q->-J%lNQVd4|*rhTi$*UJ}&4EtRGn^rnqW
zX@67}7mMrq58k$%<EDi(_w{$>fN{rd^^eM_<lZ7Y(74NX<Yf$c(`sc4CM(0~g5w1r
zmOsAX6z$ZFp6!2zNmCOhB&D76ovSOu_xt>7H0IbFGJK)9*nQ;85kjvqiX}4jCj0U-
zb`#3XP{g*}p|lc+S+43PXMd3_7}r>yF>lp+0hyAFC*Dg%iGo<k&xDD*fc%W)rSrM5
zY-TR50VXMh#T3~9`qKo+#g<8p365cr%xNQ!!!-GG6eL-4BHUbTGN9?nfb8fK<H$>+
zH-NZ4Q-iZVS6jWgGMvPCwya>uZUF5h4D7HPTaxt_^LnR$NTx2EwDI%+*@h3OsLy3+
zGWC<I&t#YaKaM2-D#o3cynbRd^X=VYP^S~sqs_Dhf<s0VqWZc9pk6OE>GdGGG3CV9
zkYvOQmcT58Qp>T{Wxb?13uKm=T5`$4<JE(ea{Vddl;F{9&CmK$eLUg}hdeIzFK~)W
zx#H#S1+sLR*M!$e>J8(2kRPy&t{^J&_XvMaOiU7`ok95-IJZD?cdJXvOQ_ye!}=mh
z%WhuM)QCiW#<;u?fu*2)-asf0|Nc51=oi^fA7$TqOs>8oS+}}yh%Bt&wwGZX9^XB>
z9qnnQAJ#BG$Um-_1>?O$-Iaf@bhp!F#UoK>ive6C06FNt1jpv;u4^DM*aP_r?2)tw
zN&qgvroi^%qRj4`K;SA!iS(h~o!M-Vl6GF%Y*w?~y{RqQ9Vf|nmu&php^daM4yn`1
zIYlQ=!^uNBby|gA-F*t~Is<o}f;&&cohNl1)@c=lrGMz;nWY(>(pR0)M6^pwIjt5q
z+2S`bX|sUsq0NsDtrCf`7Rs}G+DXRhR5K-)7SY5L8R0-=!m=lpH1iIcL`uGU{?s%?
zH&|Dn-?<V>+z{e8Wb<Jer<_}>)2tjMadfh{(HHr=d?X9V{2&mlLdt>yFUe(NvMOKe
z<8ncaiw!lG(dm{X?&V5loZZW=LPktv#27ax=SW_0I<oo?(pemX2B@0L32jUk@l%r%
znrTCBmQvi9aXUAb*9<|(x9y~6bHA7yOGjf-s0ZLUa4Yp1gAl(HMiZHpG97}^8xjp<
z7ee#)q1SCi=ge=KM(7BgyIBxshpdlrJ=Co>eK;Rq6EkJ&d+h<6Z30c|wK4GWpseAf
zWIg%~Qm%cXB?t$qq>Zy%Rv(QZ7U~TyErD5x@L$AnRYXk-Of5NU?G~qeeRlmxactpK
z&4?%J-6~-f-#PkH|G;z$IX%ZZM}cQnPNHaa6?&8Fa6?z%mLd^*72hLDdayW~abeU7
zQVR`qNXqa2(VaBC<AA?gL5v4$AIf_rcMcbFU;)*<SF51oy6PckpkExKjId6qDz|Y5
z{Z0DF4l~_Fc9kl+^)N^r!(uc7WBd=(-@A%3{l!>kcWY<ro~J`M1FQI7$Hv$c-2sa1
zZA1R(=ti*V=wE;_AU4c)7v=t7aDDm?ZVxi=47wAF@(Sr1^ZFjSnpuB;aJlU6)AXBf
zpqp=3PtGTmZAzu1IyS)xm5~Z{x+}a$CBrgVu~hx>V=DWV$v@>?PR2{M?5%VrEV}y?
z-KAbLR5`FrdFN7NvSO*fD&A0cr^CB+r#kVLOM`_MAHY?Y;g>#PT51$yCJqZ|npDWu
zq!OzmIwIsA@S7#vYE0{7Lg+SMlIjjPF<+tE%i2G2-0orl>RqPEVhY{*y=+WgURoqX
zDIpX@%^scOM8G13D*YCqZ>{K&5v|jva6wTn$#jl%EVU`gSP^Em&GAIz>!C9@76#n7
zax?1yKv6R`^HEbUfm6E;I}0KReOB4=)2NFbA7N2oAq!nkMK?={RUz9u8%AgjL3KW6
z$&MH_^-~@-u8bu(%kh0j)>V+ETfYDR5CBO;K~$ej35&3Xi5x?sbRCywXo_QN*6bB3
zVg(*@D`(^4e!;j-5|Z^xH-YqSjwPwPB`UGlrERFey*&c!tei$R=@fHA+wxwmfo?a`
zSO-nAXf|zwblcooio@y{@#2jTNAYB-_nMI|#_6w7(VAXDXKRLIw|R6{I+Y9{uHb?k
zz#z1`!gV^~Kn(Ukz5@HAO9{XQI7{H3#5&yVt{}oE`$0QkeijAp6L&5XmU_VF^0=!e
zvwpmI>I|wx?1!X&X61xBb*SR4^p6UvS{zb~?`iQ#-KpJAOL>>UHFDQ!m6zSr+@ZWw
z^V0I}Gi0N&mLKKVBJJLyrK2-vGN&qX@{-FUvy`W2m6?m2k51K1_RERH&MMAj=XQrI
zwm~XG>xY$)mKe0naSYF0y_ZMRlsI^N()~?r1z@F{SL7nd!oD_(2U#eU0z+U>axr>I
z8ULXKCKr=M>(A!NvN8gbQN(09@CwCv3lp9sM{;r5nM4$_4%xg>5Iw68Q-WO_aKjw9
zr{!^^fRi*IlQolxPz?0}2c`irqzLxL#?3m9d#Sw{^yJ23xb92l#-di9EQPVrbn51+
zPw^lgQ5<1m_388jI)cx<PHMeun8!n0gVkHCTap=$ygj7#PXAflyh2%Tqm;typ@kz+
zcsq$NVG<8_%yJuvqy5>ErYlkWHIhht`O(!+c0CC7IF4JJER0$k&sl}HoRW2!J4ML?
z!QrMe>Y4=^oX@Nb4w+d=>+)N1+zw-Vg@NYSp};HgR{7O3Sy6?4vTHIxZgql;P9VM)
zKupHkNze&EK@aS%B<^4FT`awuXYY)_OU6oy3+ZH;F0o}YQXY5Ny*dY0`80yC8d{fD
zk3c*0Tc?cTpKWL+)H_=>X=3zmA9S&bus0<P0tV`X4DCTJaSunPBFtc&eXXA>Yp&eV
z25=?oqdbgF%N?M>*aki9g;ompCjZoaHMtL9JIhQ7$-at=GskX=)V5H+T<3RADnE|N
z7zK7mi1VRxGl9yvu38+-IP0uC?m(cfoAp`ma9-R`xOljZP3C)rnl-Y)Tqec);-Wff
zN*#x#UMgJhGpfd9c{e^R3vPpGf8$3mU7k5JA08gSakS2!MSw%a<g8s-gw~TKc7$3F
zQ(<?=PBLLf$V!BCr^`+$+<TQR0g^o~$X?_@L+sHJqlTF>8hs%Pvdyv}#H7g7gdKb&
z5uo+07`n`67|sWb%`Y#CJM-t19laCeOXM=nwi^VIA<Mczfa6j@xlARjMiX)hOR~=p
zRdQo-i9lrVnUW!o@m!81eSQ<RC-AIhkmbhW*>j+rCrgdyghW}5RdC|je{z|FoDOGl
zxwOh{I1Z+Ua@mW({#E0%Ip+r-VVpmU<9;mcn`{)-3w$=2yx16(aBxFnr<oYuxQ*=<
z^EQyS@4>B+^k3`OMRW&rN~CjHtLhq{8cwA)UbpE;h5EvXi+YAjE27lWob47ZFtTLF
z+`x=TXI6x#vl3g`?f{^&0{HQ0=C^{Lu_HDXOrMm_&`5{rD%xB<fa%TH8+aTFI!Wps
znV<)V?<qMwh`SQMXZgFBlbYZ4#NDt`hVDtSlDj*{QbVzXT<K&{<-Ioo>#UqrHt7^&
z!)#H;(nSsE;I^AA_S1wF+;%H=A4>3)$FxC2Fl-M4{I3ca8BW8rsu$PSAcVe#FZDgH
zk#3{40#~Saln3lJL|mbbF2*qVIfsEHz<CeY{d2xTywd{qlrpogLYuV5W^p!Kef1aR
zIKoM9`zJCJ6X}fdQ>efCj|`sD{-(RnXy2254e&1g0^pseRJJVjbN7P4?W&}YoTS@N
z>0eL69e0yTiFK0hI;pQ(d{_$|n;6S_vQE1MSamR?wX{5SX10eFyOGvAU>)m0CV~u1
zmMN7a-UyoC5z2g0!0G|Q?$DRy>-{rl|E#!-gV|?OCLfl?U1S!S;3zXt=HO*zVcC(O
zm<J@5D>#|Z#bgEkozcX2Bv&k>Jw=dZO(R?`%L7v=Cd&1<0RB#we}0a@{C8Oyy<DVS
zN<@&0!@{zRTv8!5IL$LjgVZCrv1EN183d*o0KW5~1m_DfiF&4)2xtB^J8DcDY)xR9
zcjnospKGjy2hxB+hfHq~t~EA$!_H<MLS&<Fb?#y+MU+hjkH(^eLmVHMtru}v_Czb|
z{dm>uAzSapG+STBvEIf&56w1*Tmv!=3+s4B!w7}hL6rYOWoE`zM!#S=sdX9LyXmr4
z8d<Wtm3GaD%FGh8ERLEi&tka-0%TT(Iu5zDH#-(7Uehz?^qj1sDIV($n0^cn0w=27
z<1+ezaDU;rm%U3H$TZ+3r6j{wQ&LDI_0mBNCz<PtkAmeJi;~_;b6}OvDhR8gb!qj0
zG|(>&QASuNRF&I6x(zr$6Zga_ihnjEo9m;u;hu;)7(R{T{<~nEHGVJkwSIOUrF6M|
z$2sq3V376>OPq!xW4jVQBBC3O?70AY(fHZ#xo>>PFQwr2%5GUjn*`l9nSCa#rE>8Z
zq0W0{Jw9NPWglw4)!nDySN~|f^)3~Mb>>i?Jty@=zk>;mAK>u=U#c8c$8`d%V>%tx
zG}&F8A*kcCybDZwthC=s<-^j^SjwMuO4S%{wU<Q^F*&df7UD~fCI{AWl?LmgV|eLB
z@Rgr=?4o0{NzR3)oKym=NxKRr%`Li{s7iyScbPgnmP(sNG6xp+YFesW;^g1V3LYOv
zzkql3l>mSK3}L@3$`1aC;gH8|VkPGT&EZ}aqt!J);-8q!B5M|q5x@z1FHTNY3Auo0
zG%#DdCpQ*kMr4hqN|}j@f|5JoxHX}P+s#kKq%!ps>UkT6yCb99)<)7}-59BJFej&<
zCi{Z57W;lfSejW$eb+oVmr`QIslkK>7)@vRNt+^06~meM*VeM5U$crLt~)Cx(?Y%x
z?GT`7`8g&!XIYC3tQ*CC7#1<N5_VtQ!gnCE2}o-fck1H$zn!EWZ(Z7edt(IFUJfuV
zm2cv`!d%nZc@klT+4lt_tRV|~fIjaPjxs#LZ8vc=H#Zto#W3glKBBMf0#jWzbr<?t
zvwq{cq2J7VHQqme_`Dt9I#r}x1;#M>*%G!SN)q6F0<8Y*aOsXeXHjUgih|o8Yi4j_
zyCRo;Ce%+BS8%{e<Ksd77NL0+V1g6JEy=}FPR%L;OGitQ@jB_)D-~L0BCu}18$NP3
z-F}ija@T?@<aQH>WrDCy>L@LnvfagDowjjU@uNez;RBH(Pf2s}@yUeTklo~AI2P#k
z=1oT@i}^KdIA<NOb2ytfA;U9I;H8UYgS7N}T!y>I7adikUt%;qEW>dLk4i|(DTK{=
z77YLHD~3j{B)%+prX5NI_YgV6;yGDJ$c5H4?2~85Kgg%khX2__y4e~k$VllBYevFe
zov9XNOqSC#0A+Kdm`Eb>kwlTa9*1z56~l!C%P5RUQlWv#UL<p4fp~@wL3Wn<j9imw
z?Vv2qS84M-JEsS(8RD9eT0-+OE%jyIQUAMd6j~j6910OA;J(`6?KZ*D2u#L8X2?ap
zxTuFrl!y67VN&m+cwGJLD0}^r7>jJw4}xtON1*t6aB*0?9x@r4e2H$@^X)BVn`w)z
z3R~@6tF)eRONQGzom`D#IWG~<2)5K48=g3wL}RQTBF%>p(c_iYS1qAkA6XP6aaGJ=
zS+iJxjOB|N0U4aS@$76(ae(OjHGpGW%5mW<6^i;~_T^VXVD|{{diFOV0J(5y)?|zG
zH5?-SK&%r<9?T5QgVTc_!NOgMig~YU8fZ!ieUd^-21=4Tz)X3si@>5S97&_sZPh9E
zQ$|=PPR9YSn=B5H#pr?#=sJsz>tXPS+eh4qw-@3JhR^4?|1Mlljo-5!t(}p3Gyaj@
z2U+OseT3?I^%<xxFB`(f<jxZ>)u7ZHE9o8r+<!5f9g^7%nJ@#L_sV~H(A4PQEY(<f
zbCy%04wyRBmz+MtSNyNT_kP&EGkE%pip*N*nJibwCNv)<Ja&M`Rh$&+N*4@e_R9-d
zQhlie?T0oF>y*oTb+?PdTJV{<HBeuEpd+~q&Ev=HCl2kW50AlvuAH9sNqFKInFy@O
z1Z^$If$Dj(UmmpIPXy*I5c^bcCqf9lo6|C^1LybgUJ{KHQP>$1AEaHTW_m3mN*jpe
z>ZM3*ensSrIWbwB#vt9&!#Yh;21}b@p|t&G$FU_BD+&5k88x3oW}mcqxT>qJ40Xlk
z1vL}CBrZA*+#hhlmX^l#CQ2Ni1=J}op9`@bN+nUVO=)~f;-*LIRNVMmiqvRt8kN-M
z>mv)v^qa9#RhZDFRHAIO)ZA+tLbqN}bgc6FoVYLmbyd1De1CIA$p!H91y_<eVi*=N
zXD9=NS^{^fc~2k&O7Cd$ZoVOl`>=|8Q3TdmdHlXrr<e?Lk+N;N#wuE@;s99;H2a)l
z0}OZ3T&0KZ!NLKa(Nf;4_iC6v!l?IZtue=n>QUSd-YbOhD>s^_XiuUeEbJ#TXpIs)
z6j{O@38%0DIZ6P|Q9$`q{UbJ-pMyYKz*vuF4@7YZb_a&+>9O22nS<73K7B{zG`zT;
zE;^wdQf_awxS~!Sf`0E0?$X~Myz><3FAUloSULhr#aroUERzh&gkPCFSsKx}kHb27
zI!=A%M;P70Y)bE|np6Z9`5T%M4DBbf$i4Jte+7Fi3wR+q!)Po-F_>5$DrJ@-JIVqN
zyIzh1hM25ER12_Y{t@mvjx%4Ni_G#eDwb!%la~b&9OB$q9yg@Xy4=7YJ%d-m<CEjx
z?e%5O8pl78d3)8xWI-%fM#f-%!7Ru<dj~&8e7p+sR&rwj8wEBO!to^|H3ZySl$Ba%
zF4GYulteTLsSU3EttN)WYXD=-0MiTv3j}#fBFbn96P&FHIb24F*pb!obWqOh0~s7M
zx`mRSNjr_0ZlQ^XI4p=FL?YaHOj@&E;Mi`H=03}>Bmu|B@+p@MDxz6$Z-_SAYo>B^
za+C#*d5LCnYYUTl@=`Q33^v<(G9th-%B3S~@u}ZJ#B2ptA6cw<rc<_Ls91h9Q-IB&
z+AM>3y#hDG(^*`{v#Uh9u2w9Buhm%`WV8`MekGJMx}{G)AR;2Ep`V(rAly4DdSJNI
z1~P4UJiVjIyE&wHL&hR7=^&C6V!U`4gLuaR2_8%5_`kPAU{!a<2)h8T>lFI?#UaXA
zx~KsyZo6sX5KS1(d(}hJY>i+LMvhP2#4#*Jy%!9^2yxTH{=0BJHGa?b1?&3i??HA)
zyL89;9qhTk-$BCbSF=1zyRD7|*p=u;qqYyg6@NK0Sgp5nfcF5Dt6>`|g_|%d^Nah=
zpbf~F^$SBY=p4(+YooqQc&LvQr_aC}uctq~eqMY`Hg}aywSIW0_I8uWhjpOJV+S^0
z6{^T7HT}&;*UY&@eT&crVJ+Vsyr2L85CBO;K~$F$&j-KMaQ=;At(R)@p<X%x)`5DT
z(ImiH%1?ag^!P{Ov5A&ulMb`eIk2=}0988r=>YZVA`^jS?uTY0ipVs^*eF>>Ch~=t
zK``9xeFaXgUktWqcFFCIt3Z@x!LmC*J|hd|>zORzT!x6uO~K?6JPh4%DgR4B<+X7P
znW`B7H4?Tggrgu+OoY!t&g!L!ROxSh(4$fzqC1dg>e(MWj?OU^)$gJ=iDO3_j#KA!
zMR$I!40VjVIJLTn+3~HG?p#_H3;k@RVw(h~UYe}FT~ZvW$2E{@bso?#MfDtFOD;_n
z9L1@mf?^z&>#=0{DUKl5{0^P$3HsH8*%fT;;<BOS@SwLU$@J1qK;DVO-3m(U`G|BS
zcK0r+CU>uhz}k!V3f<3|PNBbF?57;~85U|Y@6{Mh*o*hd5FUgP%6sA&R!|;4ksd)8
zkkwMNV;4%W4#viXKhfO{Fq{-ex`xdF<<Br=RIwAiCWkAD5(7B5pe)+Pnk)kK0hGC`
z|D010^Jexj6!z1^;;<;h+K`E`uu)f}OO7k=4?XaT#W{u6H{{;bTP{0&XoIkH0xY`Y
zZZbKrbi9>HfTdGk=}cJaM~7nRHcNv$b*$Fir<5lvwOvHFin!G5+C}9`{j+$r9(W~S
zn$N;-10_zm((j}xZZ2?98oih_MCJpB{$fYS`VA>~Z~~5OM6{ePGAr=UC4yENx((4-
zf*n7kR<1NOA=rcKJyMDz>ScjM7H~X!4~WNYy?n}T>FSP!yaAkD$oZDd41y3ns}FJ!
zd(J=GXe=H#QHspskp)h<xkv;85usplo3o5uexF1GQ2b(Jk~_&rPZ`ZH+^dxR>hxo9
zVp@tUGp;ALR*+vS=6O!*Qym5yHWqH9K9l@e64&X^m}ycIN8+=aj|&Lgm_D-lHja%p
zZrz|bdIjP(vL1^OPb_ANd_Jr~n*@hmnu51-%#@*NA_}Lx22!m~Zklyy7^8YVYHo^(
zkp<SK+d}e|mRPCjGgF_nc53Fd!orNp;%tUG7{Jq2A{yl$Jime^t6Ve|a)q=wUqzFZ
z0Wx~at<|0+gaw%C3ZS492c8^=J1Lsg)yW7>Ql<fb3Qpk;2$|atKq{#$i^|K96s6NY
zluK{7_xuQ~>S+gIHQ?$_VW?m1r;IDbX>kj^4C5HhA$B_mIwl6yFhF?({L0>c#Yp2-
z#P_9{Twl#9-pdXXanE{db=TebP`|_TZ4jv91m6-iAh+{)Z3Q?~y*WgBII3>XC-6D2
zmJ@>t3UOgFX%4IfpV1}1RyZCWD*Y}sx1YlQ`Db+FZSzSTFr`AV4&k(poH{exU@im~
zFr^>&>o6!gB1Go<hRS_lg0Kz`RU)m!!sZjf`mGKo>!{M-H&mZEJfRa{ozMxe?spk}
z(I+2Va>69Q(jixqPAzPGUOECxzvNblz_OdfRw9&6C`Q3Ba?E>`FYN_G9YeKS%1Fe&
zn%7In;?z)<lV$b|F|%LiFq|Zd#6Nj9p*^Nuk#uoMU8Eu4<{~IZ>p;!YhK*otbQ|?+
z&&uLFmF5DDCzrKt#+S=nrMafh9Nwj+@my@hr-xiuoNir*rkV<W&1ksK+}O11quJmv
z!l|-Sq$(Y;*IHY|azq~V+ESs+TceM|O0Ak(dy_n8@T@?pwoaZ`UOXcFFh6^MOpo#|
zyg7?UDd{~t0_)uKUSWT~Y12Gq9HJT%?C`a9kVbyXqK-4?e!N$>zgU<t{hH_2-Ob0w
zZ-i}6ANHmh-V3HTh>C3Xf&R*gi2K*uHk}Xk+oFm)P525k>q%w_?L>~sK|^N=aHx7U
z2*KqKZlc+HE{N?qd%_6>>^U>|T|2r5|H|((&vuQRR9^N6+*kRD4qWJyM$ov5K&5`S
z(O7rt{8lFF>W;fz?3MfV4*jLVyS4x8uy!ai9w=M7s4FzD6Z#;m2VQ~44^&8qzH#c4
z)U1zM1jcU#6I<k6DKknqEyXbi5ELV_S1@938k%~maGih3L}r1%N87`tevVD-sc!+d
z!kFk4aBu3^de)i5)2tamF0@fS{Q0)YljUWJ<sykAum|EuOif;{yo`|GQREQ@&H2&y
zauwyBKz^^#$?J5^$4=mK7U*s%Xdo9s02txOrc;nwXafYU^-nq)i{hvUrvVea!t-I-
z5kZ7j)-VKttC59ZkPRGL+M^5(%FandQed>UM45w7#9<Y6tLe<M`8sN-mpDkAI1V-3
z-$H6_1g>4<nR+{RPVeNtdnoGDv9{{5@kf|jc|vU0tiSr#laq^0N6hw%j88|u!lA=$
zJ!<QXHDGXZiwH$)lx$znHdaQ>o)?l4xAdom6;*I7;NX~|a$HquMu^#w%%-lHDDnJE
zPjJlPxoEov9<5pc`IQaCmLjKTV7j%2AaE*WeJbSz1EwFy+zSTugI*_z20C+HaSbr(
zO1M+xprn|`Gm>IPx_fd27M+XUtCgKlJ7Qv3qAIH+WO0-x4EdRQ53x9=fnKtMibc5$
z^<B{m-8?7sM}%0_OX#DgE54`PrLRs{D^b$jAh$jJ_L1CSz3N&$c86VQ?L0<10(RDI
z0^1qJ1qfg_RA`^%`!j*dfu%|nd!=_qvks@S$gGoJ10E8cIh<~|d4AQKNq;fWM_?_b
z3c^ycRQhLj(O6*%5A0WH-vbcr0~enC%0*!51X#yR4lKO*I6nE~@uRNB>A-$%a48QC
zjLS#)Hzs{vo+fij(GghMKj%->2=>kd?mo#_cKb`lSQalRJtkzmP!w*+DNe3Si|0FD
zvmnImP+pdHOjfEOj+2aQ0DCqt_zXg>60Uz8y`zYK+HB@Z(=T#jT_mV(B3uI&Kf>Ht
zYd-!ccWOm7kUa-Z+MDTpBGASus*eYQ)mxAH+&2~Z>}a*GMfa3&VWat>uwQJHqHst=
zv`b^f+$J}O-mw5J^Gp`tn4ik`{^EKsX|(c44FpSL*1pN8Z4igWTRPl0;T<ll)ZYx8
zPq4ghmo>a^=r>->u0jdkO~_UD;5(4n5CjjwOI6m)DoML~Z;@XEtOFz0JvIWXd_utW
zI&59K$r&u|WFJSn4w@Z`l1(~2V)t0@6>7rJPkGD~*MvmjnlIwP7>o&GyBL;!O<%B5
zqNLMtZae$!Be`<D3b8yXy&YD;9HCt~JbT`&0{`3SM}d%$^5In3p9?SwVXtO(Y4+);
zS(uscfB@}*K@W%in3`#%y+89+m*E30H%=v$to@krD<K}Rq*Nw03M@VS&Y=Dw_ugWI
zRd*vq{;5G7_I02;Qa=Z_)BE2SuDXwk$wKqtK^1jno}&`DTc7b4pmAlPmDluS&sPv^
z%j{pBGQ#NvK<qdpJnS7k?zgB8*Ve5fRsc-NJXQ=x3?mZwk8!P@(0yDI(`JDk8`A+S
zCd&{o`Jv*7q*yL0$Y>6QCQB64C)sEFlaz&s=fh$$YD*!KS+Qb82e9!PsuDf3XzC+2
zGqDm(1G?LJmN7&D=cKux4jt=2#3L6n8n7d7a$`Z18;fZsi4^dfvE(rtcAf!8=!V@y
zNa&1fFX)HDfRnS*67Hf=j8)S>wjlQvPGEY*tj@^}uWth^;zQzYT#(^V!S#F7`8Jf`
zHa-Ol^|n;?^K9a<Y@8j)D5R(!*<X|T&_2X=O%*y(Jr?R6pVsyo912M%tZ2aQ@Pj4^
zr6#K*f}JB3TLOqUEMY|ji|VmbBaN^3)($D2ogHE}1w72TZXDxMW<6`I7&5}Byduf5
zcKU~SEaaN+W@x-Z3OxsNU~6xB8=+*a1~>G1aQeZhOtN97`k`?5DQd>uwK<EBvdA?M
zmy}l|5N64EsoYpVxr}8LcU8TEx<^J}RgXgms{vPc3Z4DpC|O)1PRDVvk1Y1m#He*2
zbRBDPKV&s&7=uo-YlwIA%!rTlu-1cs;-CIr)|l;HHCE_uoX`G#amT+8F|fn3w=JQa
z$7K|-vu=0rC*%uowt(C&N$0@Q(MP1-;6s(_N<E3zhfp1IrMF(HR5`F<J_Pk$LLHxV
z`ZT`lCV1W3=Q~f*sWYU%9;kw_)b|AEI0%a<Z25XD8;$jG?-dKbI<6wH@c1!spCH6b
zPT*&J3_ju-{oO<T{Xx{5)MF-GVWI=)vs&sW_41*0&rN9eo#=xQD7sq`v8g~Hw(dB1
zKP!w!=)h!M;XbUW^zF(Wui+>o7iBtWhwx+-WJ^lxgLEt=tD@Vr(O8*Zx>$DC^yD(j
ztFL4(IU&iKC_?$tESVL9KA0G*i$0$z(DOY$a%XIFRK&0}q4T%qFLsel?ZGSCUaH&>
z-GfC%XN1nyv-WE;ZM8<!(i|RkYSS$Kxp1{jrkH7uY+d7;q~?sM&!Eaz0!=w*>bXUw
zxNbsq1DVQkYG)B@DlC*WLPMp265dVz$UyWf?>?qxr3O~?z7GvV*6zxCU<B5YACP)F
zT{(_5vIysh_i9f86#MXAb+d{?LuP_2x|@#^U!mTyE!>LXTO|dKUgta7zs90Yaae~v
z{bH9q!#d(T<mv4SxSA^io%-1tF#ZiU(S`z&02jPh=M0Erf=&-b^2woc^ngxy0{RiY
zOTlfvIXE5A{V$_yuT-&D$0j@o4yF)<b-=z7XdFnWQ;Jq>AT;oA4%$rcEc|Lh-6`nE
zFV)=xuYhZ=P`RF`$r5oA%{E~RsVdEePd817?zz2T$VD_55-u9WxV8xVt~bdzV|s)%
zZ<NHr<ECIwas6|9(qDFiaGuZR!_s|u99TSp*}8&w`_0QD<q~*&ej}GB3x!-Rr9YEP
z;>@I+Tmjc+#OkA`-;<Lo=$6Ulb}?i=^cds?i11k6@E#;)V<N1)(Yb;}W*Pr$E)tFW
zX(7R}m>UZc&47rVQ8v)bjpa1sEYQA_icA}rXhvvBiJ!MpN^w0^()z3>9c`j!hM*AD
zV&bqu1Oe6ZXMy=rDpax;#W)t~8E!-|nf|yXLxPJ{0>p|DjjzT{%v7dL5x3)s<u>kp
z?%b+X!?D)J%*yIt>-AhS;5YnCdnL^mW>9G~p+5SUi^C#neJc>KZm}jFGi&*foi$Zl
z+#_-`G{v*Cn|8@>1%(x<fX8D2OwTC}0vBs+DeF^7pAgpbUR_}Zr&5+HR|C$wI;H`L
zaSY57pAdnJ@Rr7RWJqv7v(h_0vKb_-{hk_u)jA*{tbo=<)lLU`#7?r9ZQcc&=?B{c
zF^hIUi%Cv(fO0R{Va0ZmT|v2@XGVXdlR^5dm+UXiE`}AbAIoWWw+9{ek=$rfuUhAF
zuoI!3hhqq^S+NVy1^?9f0L1o9ME=-l&grVb8GYc=A0kv|FCBrU+J$!jmr9+c{jYAO
zKX@D6aZ+W%auHbS=gc9U(cxEzq)Y4f0P>qMe~#8=v|OS&GV9X1!^|s+CicpFg7BD5
zfOUYEUW8A4G(O~NJTd9$D($5$V!{9b5CBO;K~!-&cA(sE*4MUBATUu^x+L`$A?VU^
zgHtI2D=5uZ+ifkdZEfIv;8tfZPH<v8koF|H)4nZjUkq<`OoJ>)xhPLwglyCaMMT{W
z8^~2loDw`M;y`Q*wSUKo1{iKKm=SN(z)2WN$y_3B_}o~$KF3=^vfC(J56}<cfLUw8
z`3yOmD(XRYvSqq$;$|#ns&@eC`LkFWvOdBK+T&&W=xASxNGjvZ$<d?<(9JXD>+R}?
z9TXy*z*}sG)CABN1zWP4L~dlGnV7*TUyrfXvGvxHr&71863J}_^`XF&=iC~*iclLz
z+<@eUklrgXr<1S&%9eF@%d8J+V3l}my-Iflb}p;(9{v?V39D4vx@ar!)d<-=(d^?E
zL&FXxaa0L?g1e{Q-86g24i8!XFb(Tr*n2g?{y2RY)sN_6>{8sRuQlMh>+Uv$-t>}g
zHd$jKd+=W2I)2)W9VP6hgdhTitW_7_`~c#cALlR7JDyp5tk33?GP`!|4>FJa)Oa5t
zU3Fi4$o-UG>G-7lO2^EPb~7EDz<(u>e=E=jWSP5DgiJDpmc9HSc&|(s2M0FtYw7gb
zEAguP;PJ^#CcR^uwa-k4Da^A@=ClYlnJ4p;iEco@g|z2Ydq5E-xe`sTBJ^JYL;Hm<
z5SI!vGBg3w5(UmjL5zsYmKAo}eCO?U<m{PqDvR6<V2OnocW1VoTm(+TJ~L69sC&K*
z=rd$N*mIMVE6$UZ<TN20>f^qT881L=b!DqHvBR-o)5Tm^&AS?~xF1JlQnnt0HquB0
zM;e7fsSwp-<6oRyJ~!4Zzh{@kWHoT`n&G*zcwB&sXp1zK#hDR-+=$xf38y!Y+plmY
z^#SKmFeVPm>5!<ArO4ccg8fq|XPIw<P>I~}dNV7AUmU%4<#1b0L7{9pXhbBnaI{<2
z9-7cevy2-HBpRonCvD+Nkrc*=MG@9Vp*6F_=yzL-w6qw{T5lE))}GFS<_uyuCb(B8
z6u*~O!!xS{W$^6EBQ3$<5aX3u7G`d4<rF&1+#;Ah0Wx}H%Z^`&0mNM|))mF~%F?}t
z<h_Y$K(LtN!b)W+l-eRGq{e(1OG;3Y6qsE1s0gg>eMzm0sy#wyr#MO$*T~Xwp6not
zy#z76paZ%Ny|@ROnl6k05sfgiC!QJo?jBZo7O<--+r^mZ!?wLjoTSH*Zu@)09sl0L
zz)BifSWj!`Q5XWuqPqY)=iIa59xkHTm%3kdJ}kS7I@B+*nVLggsa_p(UnkVKa$KnB
zszbc-cKYLY(2cjz=|hzU>(n8gJ_BbCRT$S96?;V{4VDSQ;@>(1xmEQ__lKO|%$nG1
zgU59EmHq_b@ndl1rTFQOnjUz?(ts8x*K+NFUgr<=Vt=6DuQ|}sRVu%`?gs65J6t9#
zc3WU)h7L8Rd(*H9Ukk((!ASdkHruV*EHKEPz7F=(W`qj+?<|d4Y(hb<pg1hZo9yqg
z%=+%%E9_#Hl^I(Zl(bzsIy^U4iTo^7=+x3}l-O_j3AQ8goLtqMME*ny&hzCi#wb26
zUv^~0YUWzXj1+B5)1E@9i{{)*v#EjL)2Bh2^B7I)qD*0}lcS8zvRaqMWomUflU!rT
z8v>uXor6##w7N7<?x2&;BLmSdyN@8VI^0?6uHN^p0Y1NS`vkftMPS`4yjQqJl)h+)
zF}j<3ulksTZTVbJ7COCGxMIvkd;#IevIpX>3rW2xQs`n#^fijw&2Qp*9MN90N9-N-
z;h7x5g4WY0ae}L9?K}!Yz=jNW6`vU3R=PaPfUTc<8>pe3z&th8!5=!pNWW|c%I#zG
zVd>K5z?$^`aBx6Z-v>Vap?KweRBV)SEiHbf<HpUTgQQGi^<yqR>%a$O$(XEZ3Ypq@
zOOxnoA!S}0v|Svi_Xn@I1V8a%`eTSD!>-+@&L)D)<im1NJT_+vnm95w7fn{L#Zh+%
z?sY{4u1vDhuzJ5U=DTE{jVL1KCO$&g=7)Myn0mXnCR^j5nfrJFhN~tvCM%!s1AxUr
z2wBKtF1J@C7XZZhuq5vJM`XCUsgcei<U3@(Qi^coxc^>ZBCq3LWPK{gYnLgeXiStY
z<h64hqv!t!GE$(Dy@it8SQz8}bm5&YygsK5fg9T+(-|ZY7R5|A_L$8qGZ)z*@mPCM
z)};Reo!l=~aQ`bYM{lHO@QTp}!ElK2ID#g`#1Yl<XAR*1l&{a?;Fiux8$FKAHX!*i
zt8Sa-WO#r+`WV?E|Ete3*27_ibB>$!YSoBfI<gevB`I$q&Ynem&eBqA1WUQglKo#Y
zv!*bEnlllSnS0dvt;8&Vcx3~D6YY@e3gUZ^Q(RGRMIB;JS0r$Lf8my&(F`!nFsUKZ
z0K|Av1O6_989c86WKv^BQa)3n9fHU2ArV;R6BNQaXkAAe`OC1MEW!$Ls(c2zU4UIQ
zkvHvw4kiuh0kXX`SEv+dSY@4*dwFKWyL%WU&bp}lp6y~-qx-PxR(FGa_V<XZ|Jd2}
z+9hpwPCV?U{~=g2SVcHGw)Y2H>Ea#>#GbxG*p<QIvhOjU9W*a~C?}7~g04#aUBac!
zg6o%pbOe@8adr9-ue*`{{QAS&PwH<G9>VFFR1nr794@5|zoIAzi{$GT2=+k(fPKeM
zd$mw!ZTD{`s<#MD?A4_g;U|0)e)KhX(Xr*^M&1jC`fVQV9YeF#JJ5)I{}HvPWNB{#
z0`xZ0WOg^(SJjATz{zTlSy+nuOOb$J)odzsKombi_LJ4*$+G?8ib+gO7NXMj70VkS
z6Q|HroGmRO0w=HE>*r+5%DYuGR)tyHk;6si{JNwTr!f_i_cCCl8IR9-G6a=T%gH<#
ziZy0!72;*XFRRe|k!Lk?Jx8J5;k@4ARH%=~G5An;JuiJd0PwSMsXYxxIk7ho^L8R)
zyP}L#`I2gXWmNN$7VDkS<+Pe=a>3{FD98~cQ4jo1AIvImEmX3uIuvbtlQ^uNSt-<<
zoAo8UN(h2{9e93r43ggviXtZWg`(buv@ycT#u_Mynvv9%wqJ+e6C$wAG4IuSI7hu#
z=zc(W=*#5B`0P_Ao(tZq<Y2NH@up()#5-?O!^Bw^mEW^n3>)b_th&`*cc0{-NtDf!
zN~<vtU3YZQ4J)a1YGXTCv787X2Iq<Q3R^!HpbaR!G^BStlfQ}DjUJi^CjDriY%~*u
zla%>5;E7}Ou=~NIubnQtSOrEM*SXb0s&$PVV@a}jm=*uw^*qwb241PG?aF(#)LeEk
zKI)q3VOOhYFJvK4$~|ShJW4(^39krz+AAf|q`yGupHF)4m5<n(z59-c*mG=Gdey}^
z+pTIAz<o>%eK@kwt<`X;bbC{hxZSfRyH#{~vh=b;ygn+SSel3$jAUVW{63eJkw1C%
zeHnHsWXNKKDBFR5Hm*w(9mbxSyHm&HV(5tSxlTZQuaHb1{JDLyJcN2J38vXt9OJ}=
z@Z;#C4}!5o(Fzzw9GM0XZI^;*qT*nIlhw~mp);o?YnhYNfVWIz^X5yML1WA+WPBDd
z<;`h5GL2bnSp!Fimy;qsvs)y&-oPs$gCqJcNJec~B#z2br`~&ZK8_?-3o<yEG;EbN
zW*kGbBd^EYSnDrB`1qz``|*e*yUG>vc7d^WU(Yg9m1#0Q3leFX1xbtbP|$W>lM6mo
z+E?nCCD<8Jv!VjdEs)_k5SGlEu^Ay}N@fP3sE=nN7VD##9<7aOz3GzVVl7q}fM`vQ
z#t!0{l8g~Rx)M^l%u{AXHHHOMJqO#CYkN&^>|Q`r)f)jT^LM47nYg4#sQ`%vAVX4=
zd;^C0GR&_8rvwi>1Q7UnAAwapO(Cp+)<xAGp{G+EB8!!aYS7}dn<n-WMBcg&I+!%1
z2gvr)9A)*~3A`F1KS<nl(Nh(5F>ImxFzISvd(a#1`1hW!S1n_kaAIHwwT}W;e(Svc
z2)W$_wi(n5kV5c-fIWIEm%(gzR6hHaNok_KMX3I&8j<;`puU1!R;<HAg`Yfy@A$y{
zjt|gncd0KDsvKA<6BaFhJ@lU=3>p84JSS|6Z`?_!lUS)Y3U&CEPT7to2y5|P-S-lF
z!~^hA55h}Mm{=_`Un)fXW}^wk0)32BxQe~fJ}l#(3h&n_kAV9wp>{Tb<soc26F}h$
zVfqAdG)T+PF2VW+ERZA5f3kD+J9YEd{8!I<`^&SCu#?DGAX5vFsFvi;$q?<)A)KtJ
zCE}`pEK2Ko7!Mz}EOC_~L`^-2a&|)HI`Eo-tU7a}R?^<!cOJ)#Y&?dgXk{3;z#(<|
zW2`;#M*4B}_B~~c>jM+6H0Nr)wkDm)_QP>lo%ygR!&RZAI)`9mS1Xccv|*y#VrID}
zb4J}eQjARw4T~Bx&#o(1$6<}z=XQifI!ITEm3;02M8Ac*AvPIZ%lg^Uz^J6>cLdhP
z-YaZhw7d7}Xvl8ny=oCe_OlhuxQDauy<(5@x>|RGe^@ubO8=&7n7HdA`5o(B;ONNX
z3R5{U?^S<axZ~e<=z0Wj1t*@FBk>2hB?RLIr3Xj?oQr_4PPTml-8(>wY6B@|cSQ1^
z)mmU8gPW)E<id4Se3L3C)!^de^ymjqk9{cK|Gvt#bkPA^bZq&-6URaQ=*X$1@`U+O
zu~evXu^&@EIw?Ea0ILJt?3n&B*Qz$E{^H|s^=0@855dP=i<cZ%9NHij`+-3BeAV6&
z$vv7^ek;4roAsdzXfoa_3}4W*Q4AjU!lTiSQPSean|)-K%!fso;t+0&h5(vLY>#^A
z$lD<Ri4$`|kb7>7362sEvS>boTwtGL3mm`?EyKaBHX$O($P#dhGkthjVtGv)^EEmb
zbpnhKppdagUSQuc3p!_VMYz@^d3ht*AvvJ(_l+W{D;lup@L9hr%c2s1KerE~!>tZ8
z7Ff}YHGTVy!Z3nf8&t`SmC+cLvhdJsSdHp4nl$g;BC~4W2Be1F4M>^8JhN(Q;V36c
zGA=>SB*umMaLm*LtDkexLwrpA>?4!Z4KS*Qr2TLlmJaYj>d4y#qj6Yy4m%_*;w25w
zGo_<2b&iyriQE$W?ToTkgbhoB9FCz%TD37XHamDdw($6Vfo&YzO@rJTo?SCjJiDr-
zxE(tXI8j%AtID`obwUo$t|VD~Vg}FTy2{-X!7T@|e!w&Bw8S(3kv5XM8#QxXaXh}m
zN)0gS09#TIN_rkgV9~bTtB#9y?-7T{V&$S5RQVhvhz)|6MO)C~(9;`}y^HK9O`z_}
z_Q5S9K0<zwxa*?+d)mdYZSGY?<?i~r?d%R$|FN^{l{8XVLuhB6_W(94>fle6=MtO~
z939E<o$Ekh`>KC+TP<QW`U8UMH~nS~9v&`!pJ^uhVL<{@q6*Oh<r|vy7YyHb3ta!f
z`Nmt}j#KK>gopZbgiD)4OHd!!vzY(@5CBO;K~z&FxutctGGsa3br6>N_~3#5{@|q-
z<NYtgM_vODzG|tlhvg~6UQzfJlzYR3Ujf-%TBaBMT|(=zn%q{@1_OZG%6p|i8JCbo
zW{Hh)i3~*pQWz)9;N-n*9=AJJ`#jb$#&Dk7t1Jr?`N*@=kTFBUG{CG}r4E9OW{d7R
zaHkj7BbT=z;$T!!j75L1Gj6&oj(+}PYHCAtK;@BTS^}vt;NG9s2<o|sX?+na?Oxa_
z6pR1aPDsT17$rDmW){Oq#$h3==eQwiaSEB6L_Nc^nW4(KAILtM)In2w^H*?K(tyK-
zBPG%*CZhwbk&;dF(D)qcPC)e@du|<An0FY@&=_Aulri3cBX*Imli3rb_q8s)HJR=c
zqqa5{2(Jg$LGf-L-5E{44EIc&uMt=qZ_}|oCfobVDr5sc!<4u2USZ(jyzpLyhwUA7
zdx86sds=rxH@A#<|GspXxa*=DbO-0S_X@4ju&dinrL~BynXPfx8{8_p#m+GU`vQy^
z!(L89E3)rsZJ?yhV5PR#0kr@wfChik(4Zgh+hZU3*9o<k$7GVC#cf13x`gy;$F!Uk
z8JnA3d77@h5+3)k>Ej-P555X7yU4_0sZgwo4$$ByOnKb@Df6ppf6TVO^aNac6+Y&{
z__&ATL$1aHlhI1^ug_dItO?jD3w#uY5zm}FC*_aR+?tpy6Vc$WwLcKfS8OXPagwEu
z%pzlYrpZ(|N(kKdV%#|{j?8G%mhAlLaqguGIP+e4$^v(JvSJy5F$Ypc@G>gih#jUX
z$0Y>kgo#RY<ViC=+nXe$M7g{uWrPfl5_h)EpI~#H%vLPEAO%KwrLRHqj04E1G{!jh
z3i%6&D4R9LT4{<0)q78qASyagrZ&&B&r4^Y!%G}pd#5GsTCiQ^qu3(c0M|e$zgtcm
z=>`d|wPh2|f!CS9LE^>~()x0HR_k;QvHndwf{(v*%4^^#+9x<d$Tx?wp5wsr1y$cz
zs75L=nx!@jNAu+gXwgKc0e}`w>k+_F4yl22e^#tjABWXFI>iz9I6%5d<6B2Q$1`oP
ziiZfpC>oLMdQzD|5l$%{&(Ik6Ga3>+vod(xjaOl{0lq%xS1Mp*8ZSthmC$Ge^5E*(
zN^4h-u&RJqVS@F>_qFW3AjT=&H}m%zRwJ|_OQCEKc!{u;7MU(EU&d0G?%)y^cSeYD
zFZFpDfmPk6BdmbdMb#dmvs3IRi=`_X&~bq2pozT%F}<J#T}LdxkZwqmk?w3rz31ey
zVH)Aq(eLhI4e|Q#S^8rV?^{1fcOxBkc89C~IMnZ|)oXh;HU{*?;57=4gu@=#X>5kz
zoDunag|Gn%2LN3<#JHri!^--r4%JIbc&MBXs<h!(8c{6|&991rx(eZz+voS)3?H}+
zKYYi0^0Xr8KSW3rIx>JROR<TlI?xeVCywFem%@Xt!UtUm_q)vIw?hA!Lj4w*ubI#^
z(3{3d-IxyahHjed19BIJWj=Oqa)GOI;YYn|GwU+i*G7BXQLyKmK{8bQCDYQ87AMAB
z=~$8nI$S+xDPf^oZAop+2JzLc-T?{Oft_ADbUr42I4swiR2T;rjfK60C{L)QXe#Ga
zvI1u;A<fWVDS7rHNhT)(`=<vs55)p&4>&k~;~9uKJQ~eLNz~JFjAn8$uaB3TE^V5t
zIV@<b_L#dg=;bTATJ0?kD}S-kjK{mi+L6PE5J`NKvIQHF*$W6B<T}5(9!kAuIN670
zSZBzlV&%?mq0GcR%z?F5)wr&^j*H8UYGe^s$g&BaykUhPM*sFfmw#<g?!Lp`AW`=e
zrSGx<;)6%iy}GU-y}5MJAJgUL7Sify4;sVOf9&jZ{VihUmHT&*U>5DX^4#;_Y<3fm
z;DWDeAHbi{xf=Ue(}qJ3&Q|$0cRNgQs8YM*tV;D_;PR(KomOh`Of3h7L*?Akp;;=(
zi4IA%y!j5e<qo*@F1YPZy8SM?>$G-nf%Rc|K(IcnX@W~m;C(M%Tvv42C3xkf@PPZG
ze>d>Je=9JgX$PHtM?0!q9GS+|u5LojnG0H2YV2Et?qKV;fyR8<?$Bx@*++(;0-~^o
zHjxqO4%^o+9EmK&I@lweDtVlO<A;ro@gidAOX3tFDaLRwqZ2-6$VPlX9(TSE@}X=}
zt}1RinYo^ILbZa71$m()<J{DP8!u;o&J^w5CXw1m>YmxD@AToY)W+%tM~9>}QgNgZ
zZ7OVllJ+3e7xh{W(^$4XgM0d{-frJ>xO?N$)w3C4N5GE-k$*eW;gH42a?8ds+eY9y
zog~(4^^jV19(Oe7nx13b_R*|Z`()z3Onr^d_MD=yPBt_n>)lMDytXIA?1(f+HXVIn
zmSZP#RPU|MuF^$oEL$~X>!)ez9<>JEvj#>hfLt+Zc#VhQ)hrno$louZJnMJVRlnY#
zxQedQ0MypKyarZ`$j%x#{~TCU+wqSdm3Hb5`g_DqvY2h&hHd!7E`r0Zf)+tWZ-8c-
zpd{T(mK{AhF6*T{!mXp+&Gj1MJyj9?0WEHBz#ZM~M_t&g*rn5z#5Uz&V;CEY07t=F
z1y-uG6X+~Ur(wS$o<m@jZO$qH#443{N#|C!p;cs8{6qccL;I`xF5zrHM5qWHn#PC5
zrGbY&%t}XN-F*sfzZ>p6NlSUxNjP;#%g>oJ(;4k8J9dD_4rY_w{nCr3%PwAgSakU%
zc+m;73sccpfVM>7u~(?RGpJoxrqs>MUyZlG9${>})nrF_Ia3)Yms3M{qHE4?7JQ3N
zJgaI?pPizp>rx5UH$j0Y@4(6xj%@N=D&#84XdEBoU{8brkIP(Fu607l@=%bm)Pa3Z
z$E!!<b0V*hoxy<Ml)(}qYK+(8m;xRyrUucd12a)_L<uS#Q>48N&TP1MayVi7t$ol4
zyQtF8e$if0Ar*j~-g}0KT9a7F-$7HDbG8je*`_EznOF_gdoPU;)o!8Q{xVP+@jino
zAH)#HFJhPHt(ww$Kd(J)p|{*@s&oLQ4o1u(!VxznzabPwXZw@linOT!t2MI*SZA3#
zl-rHi37O)344r2VtgYNhoz0KbdxfRuZP?a(RicKK-&%0?yjLT9Vj$bPY-{l&%Kf{|
zbIx_uBw6TUJ?zWVheOq)o$gbmT?}jnyDSWFkMvvZ-Cea8uJ1WeaA4VeE`d(pPWp>|
z_N_quoL~C`&gj-U7tGR3Jv=`&X;Nlg+V<+~aOl##+a3{4pP^+xrPI3O8I|H)RUhbN
z?Z*z3PwJxM%AbX10QI*5C;f|iNs!3DLI}=pWs<lrp!`!bncbZVmBHY>GSOS4Jzg`J
zs08!=pbGk#ee6Tt@5A?$m9lbe{vyPDJ%zhmzFz<rf6?H1v<&-Zz^KQ_U<zdtlO^Oz
z;?7Jd;;<YKlmBz7=QMJ}lyh2NZ6DWb8^GL%^C2+?ZHk%2XGMCbX<*7kzSKF4#yX?1
zpw^k|FlZpMQph~R@8`#;s-wM#&P(cJiwY5okv{znxZupA@?lQl%!D&-h)OY8Nt|6S
zUL%gaDYf@j3XOOQX@@=W7uNEjljfYZ$=0-}wKOAftMw44!!*y<!gSPXBO8srT&~#v
zsijdZX12Ok6laRQv-HlOv_5|`sMZhBFV?4PvWPZ{XJ|SS;kRf2+{(EPpFL~%u-+04
zq}JQBwtH=4|B&H)%MuC<olg#|j#B}`5a2G|b@he)WU+Kb12*6jyQpE>x(^y0jtjoM
z_sXv9{jd*iAuN&GQ)culznAFuvNUEJyPfmL>~W|sY*zHa*>zp*(~W|a-+C_ICvTN*
z_X2y7WnawRE5Hs2THNe*$n7=Bd!1Yy7P#D1CcXP%2+>k+uc!|Z>Mg(aN1@JvWir8|
z$p=5r<_@CE*^%ZuUB?W%1>PV!)@nHw*x(v;?+NOc2hn)1e2wy9sY3~xU%_~_+;$to
z$yL|ukS2S;Cv)})J69<02<7e^dKJzLHnZ#1(hf`#N`5bNklpWsQ%KLe+$AQfslv=<
zQSX2?#T82eDQ|pItq$Xu$b*X;A1FW^G&IT+DqT$FtXRe2p}K`f-A;((!%`s+QaAn3
zH44Nj4_wiPVQyQ5$LAeounNt#WQ`W9R)+H<A6ADw$C=~u-IW%a-U-uDwxF}yvjRna
za^9J`r^Z4FU(LxHVgrC|9q#o{jlg;H6~YcT%~4uuS6^wP;(-=RS2SQ(@0C>BK3*H_
z@Lr9LUEgtW&>jZ7R|AyW;zyLbX%A9{l<j&~nmXA=z2c4y;;!DSZr(ckLMV}3Gb`gx
z%hWrV+PU{_K*}&K5ix+H16-%Z5>NuL3E*lYxd1WvhvBl)Y@@WV2lY|It#EGRL?$}Q
z`ju2kCb#;5j+fCHspw!*+ol5(52fGQJ2+6~WFo3eLaPJa%Yh1sGUYT`9}_wTY=U;}
zy;4_Ac%buJ*_Q_uLxlQ8M)L`H#fg42F08}Ji1K&q%OK{xBLDp?bl>?hdq?L!V~Rj@
zBrNHG6YDa3u`a>crj*Q_G0DalNrDm{^`)cDbdwN;0pba>zyV?$<k#hZ;f6WQY%EtK
zqmb8@EdIjR6LA?akt=xfG%=cIbF&4nb0#B5c^!^6pux%LZ8hlM>mm6DmUh09;G~S(
z4+l8=;s<oI^pV7o*DK-XNHao96yXR|`kEL4N*qkQ;cO;ysy#&iX-Qu172&k%N0w>N
z<FktW5n9dThWr$cV7@+Bpv1k^VO9SQN5?mtDG83|3!&DD?nX?Gm&DP|sahKa^E@}(
zFdX^Pn{7kdHpXbS+C;bG^wuo@3c;!esg-el?-n|Murky}5c+0i)}k^v=Id*gT)_QI
zQSa9KS;J=#U$+bE802uQ;(nDV;e5SKSD1K3%HeK=^6P)^Smf?Cm2Wcgdln>kMu))k
z2258>ClKk!uSFHjh&!6o3>LLPkp?i2$9LhvojNbIQ!U3clA6Wqe2KtH7b6D<E1-2z
z^;pvG5r=4E<)R`~IqW8gy#z68-2rV55%wT;Al=!Ddc9YBV%6<T_CZ-wAE-6-VTgVY
zNlBm9(Pv%sbv4uxcGivdxMqD?wWjT)*e0x40BrMpa#iYcW7t)My)bnFY7h=+Y}*X}
zjA36Sv<Uf_Ed93Ep>?^0HZ#}|Ezs{3s?e+1UZNVzc7snQ0&B7volIZh1gf`dCIn>h
zTLJrGp!RL)a4P+0|M5XEdED)bgnDDDGm-e%E9(w}K;NP6ygS=ARuAYFcZoX%QMewU
zhG%uoES*|p5OH`?&Ed$&JEP<|wx6#hyd=v|*hM0*H?9t~QHD@>%cjtQz}=1?T?h8;
zLBRkb*@Xs%geCD$PxFXbM3js-ErjxfvN(XqES8j%>5NJpgP%SO5A(RxhL=QTxndj<
zTN5h+>iIK<>Ae9>@H7X&8|B6{sh?m9#fcyQ01yC4L_t(rtagi)!D7@)t$UO*4gFdQ
zbxSJ*-Fmt?tEQ5*+j~#NtQ(z;;oOibUG<aP6A0eYwYQ|_9d*^>XGmjfpkN85yAMWp
z?UacThR%-&tc{OAE$tk+_X<Z%XdCZUA3<DY-<x}{qURx1x_xA^pXL}0kR4R+jtnFF
zDbj~g`q(eVZv12DZPShlB!`VN?s47B8NVjq`!>J^caX1ra+QUZ>dpd5fECc3Z08W*
zJ?}^F>BG*KZHmO>RqNdG0i8O>$ANYxP1?OQX<yL+`lu^i>NW=^I7`P*smcSIfDR5|
z@l8z!>QBcG>|ae-mPTl4c5qB_u(Sl!7ov&JqDj9Yc%YJD;lX6mUIF_Yp~iy@q`YS{
z`3IHu*|Pb~lykgaB>N0A#%*cz<`U+F9kx*x!zow#lZMB0m%2T)j>%HlYFvG|xKvKA
zFB_AkR1*9$$u7Bq1IK~MrSE_|njpxVu!AwqjwFmg&@(St@8MLVbF<M**$%?U3VG3d
z42m2b9lHlpEIY*-&?ZC_$7eYfK^(M|{gIno0>X3qSQ`XP8+xd1<dN42*9?iM3T~Oy
z#?68~vy1sK<c9?Ph(i)lf(cIUJYQ_XBP?8kI$vMGje5BLEt@?!WN`FxSQzTXh-Gl>
zXroOt+ztC^Vw+~ZzCe?lj3t_yL$<^V+f1(lX3}FER%v>=6yfCJuredqKl;*&?Ch>s
z+LW_WC|Y|Rk5))Z7rX52gD`VBUYOndK9yS;l9dEPS8U}0R-dd?m9b-%1L+Ex)Fe7j
z?mJG0>|QBXa#0opfK)%_lB*wp4MmY~xYIceG)l`!4$o+SJwb`^NNVDPl$H==JP#tU
z%I61!b%1;94u@zWtdOGHkJH<vP7rz1KG=u%s;^-mO$;;#)YJz9$6XZvY)M&mQ2d<}
zhf(59l9K*Tj*I~t9O?*%s{6ZJvofu@W}ogMT)`2IC6ZeW8+Wpk8jnQawQx=|w{Nhc
zYFB%<QFA*=a&2b!o|}0o%v9<x59$o=)<=ZKS)_xsOg=2N<+hF^^T~J6KBGx}#84k1
z12g`aHM%dTneE+V_HmPWE6jfBX|nrJbP3(TT?l5Ah+zE`7{afJKZl<t+t##+)Pl&4
z7;fJT+0t<jtL8|BBySV6go744d(w7P{SG*@Z>}&=fKh(@NeTO8k1x*lPHY}mMhc0`
zZkPxf=-{MR*l-M73#_M_Kx|u*=Q*nxGuO&Qsh~ILngx#c97CB)iLfoBo3n_rs|vLB
zPh8mp!`0PvWL}UjHX<0vQV+pi*&FTFa7bg+^0P8FK-;inKNTDE7mG=g>mcCe*-@Wm
zWhNkIq6~W=xfc-p@bxx&rm{{~JMyz7;Z~OhE!=-`55sn@M_}#qgqG=R$L_E|cA)hJ
zfW2#jhO^+k8l<@=@70)^`e4L+g}oy+N?B8nDA#*h<-OV;^Sl%HhD=9SL-V&la!e@E
z9kQQc7&f!r7ppQS{;i~Qfu9Ig>Nf@2F~G{RbM^ttKlf^|X9Tji-zoVQwa~S3X{RPr
zZNB?s@?jn5L#6fy`FvPQo7r8WJ_~rDBVcTlmb#3N9Vl8Ra>{&RaQR(*XK*r|T3;3F
zXXBv4xKz!7K4ctBs!}yrE}3-VE$iC?l@CiFeGbqHWkr~S_sWLv=ztWRWro6YPVl=)
zpAReSEbTM!fb%D-WN%njgSIr!@Ey)ed%O&uGH}nR1p%#mEualC(+<M$Y{@@ZmnHf7
z$?~AxcRoXwlTqSAMo6Ef^T;E+Cb-BU0wxzo8HKz6?ki5FtFGKw&Mdunw%!b))xYb2
zm^;eGL^!E|<;F5?lH6Es6mlBSktP&rAcLd3FMB|-g=pr<0=MdN%?Lb1SRgP>dd*lI
z6C7;^{t$_QoWLRAnANJlfoq$U5M}|_ZNMkY*Q1yb1~>V(Aet#=jAGorcUWnI*2isw
zWzsf<@daa*2!%G_Xy)ouoX_<zqrIiLztKEr>r3r}ofg`MI4p!ZhYrV@L_PJfhJmjq
z(dgI}N!Cv}I+WzDg2Zx6{mkO9vX%xc4hxdFs;sqFW(Rf5vJ}tETqxpH&S}MQNN{HW
z-ag`W+l@|nl`D-eX7EgYE6Ch~*jim(ZT#xQbW*~Dp_Ouhfxj!U(FY*N-_e3*n4~2<
zXoKRsSJ}I;&;T&0y_y9J(R|NHdQL}R(Qd&|Ll;$#F}>YkKUsuzQf$B{c2cv33M0@y
z4Gs$4eY_lzy_Y8Rv)aoiihs7Goa+YaJ>fdyu)SLHJ?uqG*jYE)*P7Wpe9cbYmKv;#
zw{jQn6*eP3ti3%8c3yCBUIVdXl;50_wFGn<aq!L^0(}fHaabzI$^>K)xxX%dI@H(B
z%Cn$P{Di>sNb8MZ`bZ!|UFn^q`Fff^tC+wmM0b=h?=ZRzo_TYS+~)<+-I)2EoQGez
zV>|!|KLfdrjIfAdtBgKMqY|$a<F(mDjJ*`kl1wRR{&A=S_tqqN8Qm_~$z{n3+vsAb
z!c0xxObkxD+k}VA_X;^4cR<_>2*Q|>j1F*e34CnXS$j(o*4Pxt9=LKEE300F;bg5P
z;8f}u3LTd+0i~L^BSMk|-iDQ>IIIFr%{F2l^^R3nyK~^vgutz!MsN$kJK0O-GNtuy
z4r1EAGMZR2US?4yw;<N7kqR9YJ0>Vh(Z;%z!{d8Rue@FO5kR_fVoA>^?m?NdE=-?b
z6}|0CORUS<eS~Yk@WAjLnX{`UoU5?0_iE38Ikq-&itUeJi5doR#%T7P4+m&=6YQo*
z1OqgC$?nN}H5eX(Lu?NckGklBmEIO~X=(bp=n<r<nlXcn`x;Y8bmdsTd+=VZ<ev0A
zS}*zl>_na<z&Q<=`?&x+0s2T07eZuqO2{%NdqulPh;Er?Z|Y6@usZ2C2Tg|c1GRO+
z107SPzDtPy>w#()hb{{{8Xi<h7Dx5%LNH%2wAruJ2|;(Jdpa;w2+WrX5nTigg6D@V
zlR8|>Ic+c;QTVRWl&HQYro(!4YWjJWaac}EBx16>TEZ?9!-hSL$#P1@aDEmz+pI>o
zD9NQ=B9;@1mwvCzaK-s#N7cn5g*`MeSxCy2#}l^nBEpuDM6Mi;*%O7<Jbz~H^smM6
zK1xqW=f;||9mr?+hAS42#^vSFSV9{jdy82(t#_4agO%<~j?N4K+3>_5<FkSgv(7G*
z(VmE~0LKVYSDq|p$@6R+&rv=2D2C86%EPD_Dk2`4Vzo-3BOF8Y3fDG|aPcDoGV+Db
zln}KsyU-zD?{GF=p&q@PuGC(yLOS1EF5j70`hb_1tCtZ*##_(p<I>rQWj0&SXT%I`
zI#E4V+6NBNMUFsCA{LdK(Tt{+)0osGMH()TAdlARYVYc~<wO=`<FKe;X|A4IY-Hil
zA|+-7$Z4t93SVEDiM(FkYpVIJTvx1Hf-F0h6#%&gm7S(+1uN*kRG+S#MLn~pL6of3
zu|5;Qgx=yZxp$;1r_>Be{RF*WzQhF2-X*DwgM4np@o=}QFvsOh7&I51yAfFDM)*}%
zUpPjSFS)(Yar){ehz)`m{o4l}u~(am3`0y(^a1iMXhJWa!-KxcyHx$16NgdauxIA?
zs~_yF>+f#WBD62lS^>C9fc^24ft4yAnU7}$&RWNHIOiRFy^#6Llb6ixnZkaFopcO3
zQ`nXxnDZot_wr2kE4TYKm(O5dr*K<WO?^VPGc%`XG9DJ=(!g+{v(6TDE*JgwBDfm6
zCr0KhvQ7gE=P0tW%k6Iq$UOr`r#YfPndC+|-g!$(&<6t~v)6VmTomS+j>#foKCGy;
zfc-+aE4o)vCMm6xoj1z#%j8XzOQr6)@6w;aQm#fmR=9Ev$$pxxAW&CCn;=xy7-c%3
zqJb7l<TE{Gh?mjoQ<WF|-0v#8CaYa|BIVaCusxt-VN<j<!4A5c$6=K;R<=y4m{pp)
z3d&=h@=1Kz2fun_o*`e(0~VfLN#t!KHQz4%G|O`eimT;n!TR)8<mc%1#@D^V{S=cY
zMhdoLOUxZOC*deJ)4O=Du+ZpS^j@L;=?g{};INC}*gbCRa0&CIVrv-Sb8ygi^j=}L
zvq4p0i=HIDX6(kgfD!%V=njh`x*Ov(>bDoRp8|mg9P(aSPN*|<aYw*)#xNFUwSENG
z0j`s46QFK@dkW-4i}9IcC;?ax5!jSfii|xIx;QM<nXuIN2X&pzwr;*ls9*O}aag+M
z0Ch|jsTeC&ukvK++*nKffub}WOg0~uvIs(p+u)&Nx_ceqWurE1DtE^o>ZmKA5RDZ?
z0DF`(skJm_jgD++4e-)G12=y(ky$415~caDeDn%3)j2(qtwMXZb$^XAZlK@&3r|EV
zKa|JGq@~h%sVK-5;~3<1U*HP)q1X;PpTz?zxv@Ay#-jM{B9RxQj827dK9{n*ZcI^j
zJF_*J$s2I=xE>vw%Z5ox=1YZz>@6}kR#7t`ag?Wf)&}GrEXtE*rlcQ1uNjb9(l`oV
zK$7_dNNUggLzJnvpRr_CP5v~FAnT!wn>Z|?c}Pb=+X<p`rZNl3M$@Q&shQP?;o#pL
zOWXJ{a&IE*adcxxwOm?QsAuD@hp*ly;OzU1r8X)Ki>TRe#3zDZx8pW}L+qtiX=B!)
zJm(PSr2;=XQ*i`GM!8@)+@cK5%G{ce$FmlWbzGaNpG}a78%lCoWn!!v`K=&_+rh}L
zFxl0qh4Yz`#fz(@)i&3EOXtA!3__nk9rwYy-hk;U(aegxS3w(WS3u=lR~$DJMo0|;
z2RE9S;CZRpEISt?uxJO5(r9z4I__Z=`5H|e6rsT(4Cn-VsF{WXO!g2QJur8)8c`z#
znyt$==hIW|r942EQEyjq;sa9dM<H=1d+7y-syq7{p1#A^tXE@=g*D608d-;7eJ6b@
z4;&#JX=euZVlDSju&Tm<W4wdXr$)QM0(*q=p;+PF4F6Y$kh^D+*}d6s6zV7|{aTF8
z6+%dM4;Xg&{-cC8C6FR9P4=0*pSY7gwxj!?1-U=DZe2_3Mt}}=2+bf0oLrk}vTve6
zC0?n7N8NZ<B_5S|GBx%=glwc8q%!7WvK*-n8FSDRHj=PL!?IIMXdnlTD#>?jZOt2x
zKT;)822Mcm6q}=?X{}tExF+iYfjg)5SP@zqu%0POh*G8lYBRyg_`7U*CLGtT8RW;M
zE31*kiL+eN3@NWSHrZr2b+myrqf-$NY}VTQ8Qae%m3Z?UQa`mChu9q-XTVH5gJnlB
z9c9RkG89yq3V>{lsF^~J(K23~5%J7wT1#KIM-1t`fUkrI(4L87`b_YMpQG1dq05YB
z*nK42Q%vs+-;u4l)aP6TR$)hu`!MNUcK^77<~i@Z8vXoOhXRMgJvv&As8MfQux&tN
z2G(sk1L>S#*dQ~MOP%>=#UoPgLm^3o5{FL!01yC4L_t&+TboB=tUF9Vb|m`3Q3K(Z
z^+Md~27v2$*uPt3r9z28yY=>Wj8Zqa*UqR6Z~?j@>*7KFCzb)l;`+F$y;dqY3#t$M
z*}I7fs3M)N%6^4Vec}mq1Qzf(DHU%8=wh|p=LK!HEAykMO(Apzr%8nk=}#D<p{AbR
zqtB>CP>Q{B;zW{DD7||Q!jpWTH;U~_4K)>AqBKB0XBIkjxgBcQwS(MRTKYQo4DSos
z(FrpLtAva!oynUFS*S}j6U?^@-A+2lNJ1`)YkjIO#JN0KUKWya<?#$#U;|OCd2yA;
zM@5EXUUm}lijwQxl4d!=u-KW?hKT@T?}{2*awpGlGD);yJhuShuTC3<tTAXMz`Qv^
zQfuq|y5@wSyl`3o&7h0PVv!xdYJf+47<=aW%tnq_93hH~U^wg2Gen|38P2c=i{h|y
zI66F+)u@D<8D|~un2X{89nm?fPeXu=5~|>u<3=0fyYHikgf_&q)}Gm0FP~^%-A;J(
z98SLXA<8kX$8{iP3jO$Eegr#5Ik6T$<-A!lYlMuI7V*Twt1}{=K`w4Lo^i#QD7y7C
zI-cpkRse|Cj@(Lup`NeRwUw%v->SGOLIr2{9jLC!9vAwQWnm!!l4X%RG96*Nw4CJd
zjAlqkjhMgN7PZ03AT`7|K~3s&D*~&$BS%;PxUMhg=?;f!LV72!!x4M0M)~VILk^G}
z@Cx;{G6Z{Dcf%N;-Gs-FqgebUOL@%tdRwnNMI-D(=Qvc|)6uGhXFujN&cKN6trT<s
zR`zht_^OVgj|)DjeM5Lg@9?mv;wNSZJ1}CqZNE7)=U`orbJ)W9%@{=+F8A^Z*&q%3
zz}@7=(g(yzM+Ui1529NmL+SR8CMe1@^ye49QN^`(N^J8V?NI$bRY(Mw-&8g_$@g0+
zN2LIOMobppbC)w@t!E<Tq0BAoWH7svClU2nkT)r*)P2wcu=5+clxOW}1Hn2C4&_41
zYA;`!DVk(5Dw?JxpJ<ii&3Tb6XU0&gy~t{06;wA7s;~@B!+o9eNz-VPW^`(eMS~`c
z=K_OH4!dNhCT}I9$ive4oFBnBX3CHnQRNzIgi!%}i-`T<(Lbj^@FrJ3zAE+`;-EgO
z{2aXw+0dqUMwHsfXl6SW8mkSQGjNo9_apUQq4^mb)orwame(dV9JIP^y;t4Q1iftf
z#{#X^I3#*EpI~ksorFio!Vu4a^1$ehDFoKQUUZJzb~HLA!ZrIar$HY2xFE8LRQ7ly
z^ehcRZ;;U%+ACn=KIlS3)!7BJD56Et*HV~0?)fe0SSW+r04sAXx@_wQ7FXk{<FLrY
z2l;X$aQU#*es7xa09+iFj>%HqtEG*O)zVQ~Dt{Ka_+1lkrQ4XyTq<sBwg;$ivjZ2I
z<(LKF7R6EPoCDv4+_P~o&y%O9%;dvT&F9%forL|X)f<aC0T8$eoI)Qy<zg26$$_6D
zfM>w~Oyoi)m#H^I$)?HjF<E3U^6?9H7fv=B3+*eKJWm$*_<}^P44yDVDkx$0^~Bo9
zs3M--Db8sE2@Vnm&xlz;Ts|6r;>nh5jfuuGHMXUZx|tixd?}AQvc_2E!e=sT8WUP_
z-zWrTvE&pR@DR0;$&HoA(HrlKOnYq3rZHLUo!@Ls7PA&*eSQ=$ZX-rya+61lOCC4Y
z>}M#*h#OH422Z|w$Z!ZTQ`8wrgp6jT%}_?CN@l3QvoX(Jno!6EwwA+cM4OofSq*y}
zBAlQ!f?<4<k*!+@lySB`XRI-`WK3}=;^`XYzHB>~--^w8z6(m%Opq%EcH_;JN{nwV
zzZJ&^#wA@bAjV_eHdio@gVP~q@BpEM#$7CEhLX%*l);Odaq185<XCFX8YOI|lE%9N
zgP$uASmnJt!U||zw5~f`L(p6{CPl|drh_0hsA1)|Ds&yRu$N%>v293)+tcjkQ<Lo`
zJVF*K3}cD%fQXx0X_<aUS3UG`#b25otyyyRt-8M6`?#R<I^JrJtnZ8T*28@Pc7iY(
z7=FdD%Obmgvrw$C9Yx!Ib~`P%pHhD_pDc7|8`a3-?u@Ex^eZmY0owQr5Vs3t&&%x&
z611y9?@rBWYI30)mQ5$ll<r(tDF?BL`~7IZneNbYFY9AG=@XpD{`WOxvUJ0R`CL)N
zpCr%BHwQw-th_N^hI%kjB0EL9_I9@k4;gt=6$d<y#sXtw4yObUPM8UUmg<Tj@lPiV
z#$f@nZi?cD)1ZwRiFg*8cP=J}Q&$ImA;@>k>cjWoC_m(KTzY32`iYfq<HyufEsb>!
zCsEHuM586l*5}(RM<vzUdk<*6U*LtbRbJyichN01RoX!GVZt`fd5qgcF;m3bV8xUH
zydfuTim{oD9gj<EuZTjWMI|%(aP}cx&rw=P+wvQ$=m;M1Ry7&yC9@V-m!-QN^IPS2
z2ph84uYq&)D})aAV)pBf6DwI6zib=t)c~~tf_*U&1Bs3H;l1kK#BZ)fN4Ae}mohoo
zgf6n5Jmmoq$F#BXOrB+T6@9GT3wE&Q;R!q3-KOpgm$t5t3)A~vR#nc@pc09}ri42I
zHzZ9tfD3Rgf!K1nU-{<S-a}X@mc0VW*Vrsq;fQL_l|C9Pe0gwk-zX%T2}?y+sW1T2
zM+Ea;qAGQGmwO`Wv$Qy88tTmM6FScVinG~-fo1pJAwbEj&AyysoO`LVxI3MOovW`g
zv|NrM_7oZ*!YMA%#z2`<C2*})$aqyToJj;O#LJXmzp-dZ#4;L*OfIm=WYe+HSO7(N
zV;rQ?S?Lx6k_>uwVjTU)@wn{b`8=1}JuMe{P$5PUQU44)>e9IDf`3-)U+2c+kqEXv
zicm0F(yW$5L<83hd5Z-=UT^Fs*)aNJlekBVNDWaE6Uz=bx^0^fokfnAdJ{7OJfei8
zhLP2yQ+6g|1)_R07ovK=(B2B*XFXwJ?mU{q*^-}MAjS*g$Q@IkeD_d}qpK%BA9+0%
z+Q;<}*ZUZ~uJ%)rj;|-~Q^rPnV5ObovZbYFBH*STNwJ~<zv5BXh!|=-)I?5lplHN1
zmcY$ASd_I7WHa4b8c~nM0<n8aWchN<(e;>}S&(Owk~tgCXbE8j$ks=r48!@Y#L9-9
zmhV?c@GB=lL13usS(ajL=ff^vAx*n-7ASCgu`Dscvv)D7;*}jjq?znsLo%@0k`mm_
zcSqjMuX7>-tGvZW7=_jq)#C)NBV443Fe*aFX{V1MwyB{n`k?nDhP^bqk9OSz{p!|k
zyE&7NY#-ravfZ`gt}ED^HWK1HP0t=0I|wqo*z95M40YPwKiS>so?s>6?)3z=gY9*2
z!9R7LLKru16yyujfb4qi>P-#VgQnfIf!n*!Y`-;Ayzk`C)dLBA8QPEA>u(h5|LvaA
zIHiDm5Q_gt9$u{X%C{+7<QiM$hpDjF4=0vrn<>QxFU3G#45u>Tm0*V>+NH3LiJju2
zUAu7wSlEG;W>it42dL!Y$zNaUE=O9Hl&y~pnsTR_DV+1G98!VN77RsW)rku=n3H6Z
zYiXAJOIcc+vknIIKNt0%mN;Q&OR-oa0~20hwab|lI2}lf6T>0KfyrJn)41NbZgTBS
zeSUjgq@UcJCAWea<=ezMG?3HqK<+a>BJ%(>s#uP#r`Wm}G^P&?vJb&r1PdA;oT~eU
zBL5g}Gq^(dRR0_Dwhj4#?vdSY)3u%ZvlOI5zA-yp8aVqASX+9pS{+sUs&$7|vgK>W
zMA*iA<wV)`WYt9t&u;9MdpzDIxH*%WEbhsBmF+Cw)wuVnR~yyoQ>WkCPm_L`2JR#X
zuF%+k32iYGS*Jt&>nE3E@{RE`On59VX#>93vzi4NT(#vIdjXCT!p(}npUH_C3fdP#
z?23vyL#-(t36+rwo&U&w8PJ{NL1(HmCAxE*{}$n7zEr51+GpdFZevQ)J?fAl8^vLs
z7|;49$B#dN<{O2cXMuyq0o>+PGs2bxZo}aTs;ejV?48&%`QXVikz&dRC-P+3waQB2
zV@6m!LWH{$g~S2VJXxAME|-)s#)Dv1I^Etf<?4~i%b(Ai{9jYNgSXGpJ)UNL%Hoc>
zS${N<%U;uiJ-UXdqOh|s<;DV$S4Dw~J_{zz&B$v2!R5wE>(dB@I5&#_k{V)=BBLdp
zXbKa}G;uQVDT&7HAjdd5#Sj~Ord49v);G#X!#Xrd=f-k4(<(1>8G<n2{w@re=$N2e
zy>Mu8)A|HA>jPkA93wn8reLo%bJhep*+XHL4y)I(UD^6DyZzdg*5}%rNX$GPQ*UD!
z8+3eqh&su%w6>J2MTtaA16b4y1xc%;z(*=_^omg~=B_GPj;%*1=dm)wTeR5R+S0@!
zAMF_SM%5V#@hl!$4IsDnW^pRzI5YM@0*4%48AqXisNony?8tQmwOm(F#evx~<nBcA
zU5u^a9H$&^#d0`AxR)B3268xKkVl_|{8ka3)xcSfz;Z^O1%wrVd+7^@Xkz`MB2+o-
zCWviP82#IV7Gs{+rUV_)E`mS<+Uca(%cLgTO?ZSXWEsW^*)gNre7thRJ3497$JKvq
z_A;QcG3BmOTD9N){x|D7g;mRPzcyBq-<X64+M^~fz&Qb7gfaYz5cb;61`zy-gZO>c
z+nd>AAu`I=8|D6B_g>`h7i6Eb&o+-cPBtTq>d(b4nOm!6jB$n&^1eCG9Pige?Qcx5
zoLm}a_Y^l}Lb6?FF4C#Qo8$+<IERdEth0=~rW7&~?#xgnRH3YgOf*)eTPk-~RWZX!
z)cXN&-4HWKj%)94d{lP~fIr%@OUGa&zJuz2i$&L7fRaj*aGBQNv)O@weAYDdPt-X^
z=s(<$w#k%Ks29ga#%S5R&@FiFHZYL4Yo=zK?AQ9r10XE6NR3+5`gE9yoN|m5aAu!L
zo9w#OWfd$_TQrz{UCWC|gY1J>Uk3IXhb8#Wt}p=6DpXsw1_iF+6+X*mH9~R(3f*V4
z<VwG^MR&l>Ssc<v7S3h_R{3mzn+#lEU(oCe*U%h>4ZK$aY8z<U78A`HupPlbx2sk8
zJ?ix^Fu1s<q*oAW0L#NR?!D?AuW_C|{jN@W=$G#cJ6Ij=YrepGr4{<^X4O8Sr0u7}
zsJ=Wu9$<U&+mkRb!1nnBc;QF>IK6n3!mq>{p#=z!4JWJ62~BvF`9b2JfTOT`hJdSv
zHWQYPx6+x0Kz)_a>=9L#cip4*^4N19>YVYDWr+M>f{EmznZ>*q5&X_CEg``JQS%W$
z$3G;pl;tvKY2B~p(?83#DrF2QcFiOM;>?jN{fR5a!K(x$$+Eou;!<fYCZD~lEH7FQ
zBY6X`-!2R?=5Z(w29GNNrU%Aa4$pk6-s*uQdCm`5Nr9NBsoIUtsskY&!D%K$F=TL~
zNo4iGGAYDik;sbG&SK*sio=pX60`HWeoue^01yC4L_t(NJj0L0rAT!9{x7k5Zwa~{
z1CA!1(bog9QSk8#wo3~6w)|pJ!kr6{*Fz5Xna+59U?Rq`P%rRhGQi|C$4!diE>elb
z>xp`Svlz@`8;jfIg0(gwa;i<!eq9s_Ex}V``3Lh-2Q6Vmdp3>@BhwMM96@JyIZI%(
z)z(jO8^~G_&(s!Krlpy)SYhEA_T!ln%^=`&&kuSAax)i0eSHOB_qbAis~E4WRLE8~
zV7~PTha8Rx?)Aw_Dw&lmt6g!eK_F2sn|Gy*mPlwLy#pG&s2NtW!DQM<*d%CagY61@
z$w{2G2&`Q^N~0I8>#NR0ktV_l{<ra7byMr-uj}MFBJWsOQ%4g|a7;&481r6jPScTY
z{LaY^jKH1-OLo!MNe_Ko@t0;VV-s|&^%h<ato)X3y*F3Onx%M*nN^GZj#ox-4{}s(
zrjyMG?E&^QTGk5O=8LbaVqebMh2559k8*pmN$$^V)f_gqQJyTnt42vZy65EkLZm!*
z{m{5HKFT?6GYmz6D>>+YR-cd$vv)UnnOsp+i`>%(CxED-jEo};jYca}vSMYrrIGH4
z&HpgK`EDvqD0hVZMj=8tD`s#%^~OhUt5B@8VMLj0bx;lQh-ANeSY(9~CUSVzVhd$0
z#}*eOL`v>PGpuPak|hdgOKM2eNo@;x8@%O5lZMtt-j-WYG6f4PBpKfVJ2LpM8>sY$
z&Ev3&@}?_{j4B!^y-YjsULKcBSNjFVO6swSw3N}<e%RSv8|UCx2shT&J`N}6V(gV8
zRicLW=iK*RIZk_8x%@tTt-D|#Kx{AGD<Ke8)nPZy10%5cU`51x6M<C>6&h0a4S2Sf
zflK)XU9eru4u+ol`rnWLWlU3^lbUBg`*T#hMR4ARSz+~OGg{{|?3eAu9Q0kq0ND@O
z1^PZ9D?CV-Y$2NG<aT#uOBP#%x)*i%JiG4_qCNGvXYAzSeQe*lAG_e|8giw577c>F
z`3l%fv*8fkqT+D!EQft92yxi0wGxxX@?jBs#w+t-@p`+wAuxu(29D~#lB~B3@}o4D
z*AjM05_v`d6S?y8GP%G-wfHfzTzPrJQ+@K$SY$p}$YqBF2QIr{&fq$du8|wdGy```
zmTskLZY*Q27$P-n;Fr??*G4dGN6s4-_tP01*~k*BHy6!|CPSnH<#DY^tr<nA5P3lv
z>ou`Lx%z0BErwXk$U{uS+P^fjyF;W^pAU=G7c-QJYqj!bV_iu-WN<8IHIjH7hlLef
zyxtkLF+rqe74kW@cpE6tghCsRM_HmEv8ADU@{X2{_Wr}7C5b}LDX2^8&-Pf+HUQN|
zp+1_4CFq}$g~aonM1-IaQHo3X`Y@RBn!{&GJcE$6$j`pw46V=f>}o)z{8s4-BiC@q
z;d#q}WW1n;V-PnU3rO{x&2I&nHNTF#?lbonrnmS`M3wwjC5<^2{arFx0;_@C-8Qco
zUnaX3ODw(nBh!Gx&rSqZ^~``U3b>b!a0N|-QT|)UrxrErC52Jz7Bm<`@y`YXCEYeP
zX40F{?BdYT?4vq<JjM)GAv<PnU9Hz1>AOs<NgP-IvEIub6jkhN4PX|nwBD%Sl<+Wg
zak7T+##GKXUlnw&27{FD^-!>ar#$sbZn^c=#YV2V<^lihH~x#Na!QMqTM9JtJA2cX
zBmurXR*@;5K*)#{QaReK1cf&4e8uV+&iV?wL)irGyz|Z{KjoRG@{=C-2`~QnpM*6a
z#H8Td2)Jp5EC9gbDGkgIM=9tal@W!!1O?fL!F7h-cf;g$XC8;Mku|M^ysH@M3|nw)
z5_H%A`gZKE#g0;P2FusS$1-7=F4GW!)L0=7i)$~ooB|wKD3*sgqlWw_aGaNJJ{Jtc
z&nEqUrar+Tmo=%3Q@ssE8dyhD2y6tbW{IN2SPOK*s_4JQSfS&rms(ONVdox6A<ht&
z;5=Jbg$^4*%3DIgT3U+nC1qLg85DVafbLn+b4}0mEXtm&2AEq(YB+XUZwEfYKW<5W
zq+^2yZ<MG>|LO;a;~TO#q?sW?$Kc4}$W9R(yUCg`PI6c8RUavg{@smQOm#DY-88Y^
zgtir#k?kWqXzG~3>STN6>utB*b+xlX`fd<wyBIKpJ=x3#{j*)-p4QN<C-pX~?5<SK
z2fr0IejoeuX0Tdyx83@YU;Zz@`kwc^_r@D<{Hyo9{{tWR;1!o&e$`c1U31O-zu+lP
ze#SGNdeMm!ursWDHvwz)=wej@$Q_<<i|!h-du6^Kvww4YM08&#G~TO#qt0&y4oAL6
zXK&sq((V<+)Q8e84NsVnnB=z5vY$H)d08A~>g_!({dfHeUy=7ufbBbIRk>Jc6jOMg
zOZwU%-zbrH_HiqA)aJTeD$6@|>c=xp1r6}iK0mo7vSUtainC?u!Ltz-AsfBApG?z~
z<B+S&l>Fk1ihW+NIi`~x&Cs4%1ui--XiT=}^v&GO)FS{$FBnSi6E}Qf&Sd9V(D5o0
zPLa5JI;!8~D43xmp9wz0zpr=8Mnx{y9+S9<F+JqkFEw+m-*EaRXaCk7N_K+sTZbUq
zJEJ83VbR3$)Ap#o(>hb7{bDV~uBvp*FF0uiDa^Y>B1_GTWL-0U?D85mZw2;fSd0kd
z+fNM(Y1Q);z{~+dv$R&2HHFQHc&_*xAVv2R2s19|d9k#~*Y{ZR5!6?15()p!8CukH
zV@-}qM;WMnhsxRK_GK3*sRo**p<lxLcsS|^tPNc@%_~+ruquBmACHGQ-^NLVZBpoq
zKIl7_Zc5M*?V={v%WY_Oap-7vP+fKK!wgm;JD~o3C_xh6LLs=~FU>B7C*@vsRqnB~
z+s!&n7#M-0@>{JZbZ&dBuwA>E0tFnIT3+^BulTWl{nH=1>84VH#hLY;-~O$C<F7v*
zjuz?;FBO4x%dHEdBCvi_MPS7WlUMV<qHI}EbU0*z+{yV}paSXB!716dd1k8PnQr;+
zy8Gn+`Q6`R{`$~|ebhhv?(Ycv<7%5TXMFGkvisonmUgbmRbr2;Eqhvkt$|0Q*m2D6
z``zI>+_7=}`aLu{o%xuon!8n<bkb6N<<tSvD<^SPnv*j>)pQ$vx2{G8gNl@?azWt_
zk=g(|4v8d`Y9KS3t{!$*f@74CMP6TOpSKN;a~nwNbM2`@C!C+NN9O{ERN~MJ%c&J5
z^}p8u-T2yHt0QPfxsYOO!kX_RtE48Aja+zZfJQqi>ZI)BNLP=Q<rdH+zg<^-{0#Z0
zQWlR;GrQ71N(WYX1HFSdINBF9yDR;<NE2aHgl!yo*hLLTc<VTwZc0s4gibIH@6M)u
zFm|ZxlYRW4*kwSL?3khLiD5%~GbQ6tb+e1%<z#b{?(Vdw=X1kv1zn2+>;~(vKZl)G
zDE?`*+6m6O5)Ka!zvp{@;1&P#cX}Fs?bkf#+yBlt!#M+=|I}yQa;tD)dC2Hhj+bbV
zG&VcMkgi=_OF4f>D5oj*{zRUj{K-G-Nr67xG48&&7`C@0{8QoCHS3F3JOeL1>(->*
z?H(C!SaZ1JzlAIEGD}f-W^M(G<aI3OcrZLqHoPh)Bg1E6(O88xLJt!6_Xv%1*-d?l
zJ4McUd2<@DI0anCdh~I~h(;Qtg7&<cu~&OkYm>uG1dZU|Y_ak<Wwjk^7?=ebFN3d_
z&YMCURt*O?<J#@#Ij%40!FUY1^#=7evmM8Nnsdp1M0>T&HEm4eTA%ecnQ><;Ov)kj
zXb(EAu4bhfYj0S^Tw1SGq-0?oYtuwwr5>MfitD}QQ#>P}F`GON9v_?aJL8pgJHnx9
zb-m+Nz(u@Od~YhP;X%)xyfyG$wFkMoWQsR5;Ac|-4;pBXRM;(?g;xl-f$DbO&!5pN
zaRp6;1~>hr7{xZQ4P{rm4rq~ru*2Jg+7RH@1kWY!)gH+1mGWlV7@IjgT?|v)%ndiz
zX-BuF$K6$w>Af4eq~4Xq_1AB{ChP#^JHd8CcrMACfnWMhzrwv&S6*?&lb-a%kA3u`
z9{Gref8c{3xc=QY{I5TK)1Up>UzorCyMO=7pZY1E^yJU^Y&iEItLO9?vTr5+fa!&*
zJh1*DvnA6fZE#*2(?*@a$orK{OYb8f;e-HljOI8xoP3RI!g0fMg!|ISPErmow^ag$
zdb5d@rxXef4ZlAID}|E|gIvI51Y~ka+>DFm+3s%r3892*(UFnIAa6L)#X>R}B~ENB
zlAOu}Zv9+FUd@B^6aet|voMuiEc^~PvIiq1b{BCt+JT#b`AF|oR0BDDW@b%H8yTFy
z1|Ry9hSL(d&NB6ex!Jr}D>ViTH~d)j360fol_lMspFwD{2M3As`?TTT9IHe<i@#)}
zzzxU#66rtS=JcP|r?`33laH*QW#DHSItAzIi#TQKDW<7aBJ1<`WUZaqfNv9UZ3AhW
z3{EU+uh3@Zr*Uy@liRYSbEo#~>w@_<d@AtySRC<*?6(BsHs-y*Ont%97(Q8>28gZK
z`s_06Nw^}xTeFEgPUL5z(?fX{ixr>;XR8e+t4$q`tqAhCAFmQ#97hni)e#l-9P6Bz
zKAllUcym<@YiZ$bRn#6ZEd{2EcwRHDyK_bZBynWgNOlWH=fFC$o%d?*)moa{lIq|P
zd#P<4d$lpO5t`Ob+tIEY2F5hp1-7Fp31XA%nB{KH?HJ`A`Z!eGLx0WW-k+kX-8H)v
zd+JTQ?t>0rHtY=RNt|nbD@cXeK|klXm#PFe-0)XF^|Qa=e|^rgzwDd7;rUlyc}3Lh
z7hduoe&Q!zWbhyVH!u3^&wApqV+Xv!2R`t@U;fX(a^1V$^RDaPebY@hJ?vo*eZ<2b
z_Lz@*^jAIm%T63Wp6&WKe)Hw8|C9f9{q^sD=XKX#cG-QF_K$e@L%;Z$PkZdgKPGK_
z>#euF_}~4<KmYT;{L8nz^+6AO;1i$tY0v$tFMr6j4?Z|(e3UsFm*v<0`qG#E@gKkO
zy6cvnZ}_N(T)TMcp7_Kk{EaVux@q{PH~q!eeEqkW#*cl>$Nk4&{8@dK`NEef-}t9*
z`ucD9Hq+qKKJ`<6?x+71=|lZ;0{^w&c-iY;|Ay<{Whp=EV;0Jv_Sc{JbiXlN%75~L
zfAQ-teVMuZ)xZ1li!Z+Tw_g5=-+KA~c*|SgcINb%Yp;FKmw)-QzU*0F?Dw*F-gW1b
zKhGy|f9x;(+)o-}U;5?GyWxiSE|s7BNuT%&FZzi)?!5E={r`UL_g?jyx4-=zmtK15
z!yfuk|Hrp|(<eRd6M$_?7izcOdh3f{@*n>E&42lhcf4~Molk$lr#=1YU-;k$J?J~X
z>wA9hRlmPbyU%?t{k`9Q8Q)3wmOA>(=KKPP`bCG&&L3nmE7`LI5ck%J5*Zm*?|p3$
z{UKj6ZdDjZBTJVkeKgj9Hj>`W)?U6fVamAx01yC4L_t)AmzUkh+xJGHb4Gb>7)NG@
zbe@yUi%<MPe4;&N=Uv*HoF9RxLt`%f%c?xCFN_OeY8Lh|=j_npWa%<6BKk$2T?rx@
zPLy#r9GjC!#4>Qpq~ML3bM=tZLq@|TJ=E%rG0pBA*+&QEcoo{KFR@O2{3yo`i)vgg
zuc<M43CkQBNheRa$ze7Q%gthAPZiGN5l0)vmRQbAbDEJYYf-!&ayPVKvCfB;*sm~r
zdlu@l9PG@nwqcpxBbwz{FX^ltD&6{Q6w2`pc-u&O6;8r(xT6Mk;2|oH$bofUc&~7X
zCN{6@CbbqS)Z*o52T~Ey&8T&g+lTRtc(1zn+>?c$V}Vz_X0^(71v{C<fU(1o+a5;$
z*1Lr5VWXvBOvx2kL+EU~b#UeVqXp-wyDEiWd+E#Wy7MlBf9m5u>F<Bn-^(_8{?|Tt
zad2F9)m5MIgirnSPk%i3UM;Hl<^S|6KmDQ?f8-;#`^q=J`7O)O;+pxjm;ToG{a@d`
zcwRWQ#cTG0fA+(#`=dYcHOsZ{d*28C;1B<3@xpxdbD#Z9-}wBCFTTkC^_|zf>pQ>u
zd*A);8_cioc;|J?&#(RZ%YOKWz8^;5#v4EMegEX2zxH*n_cd>Q+uN6)-~6ptyy{hd
z@V(#jU6)^e-^V@fu^;`>4`19{N{Y9<<%2hV=$Z%I-<Xj)7Xkdv@4nh!{){jB0{w;(
zeDH${<$sn^e%Z@k@v2w<;rITd@4D~hmziDNrI%h3q`vJVKl)?;=2w38rM~9Y+irWo
z55Dlm58SwD!0wf~p;6czE}kZ@x{us`$KU;X-~Fd=vQct(+;Qh3={JANxBrWO{sT{X
z(i6cQ-QRiLb>H>(|L=Fd`#q-FqW|UR*IxRYKlh@axK+P~xxghCUt&E7;Lk1b9u!I?
z$o(t0U96YF;i}q1+!)TN>)4_jk|l<oB<rhOqAYEechkMwh4US`#V2+SPkdMaLUvw4
zt~CEy&w^)-vMi$)F;QnyqNoA%(OBq7q-9Z8l)+;yu^jol9un=r48kV@%$9(cJmN$9
z;9PJ~s#{i%KB`Wdf}Ay00J~^&Hx_#*3;3--M#iP%A{7>5VSHB}XZ0p>4J;4D+EXa4
zw=3l8mi0+F0MkG$zuCNF1v&&U*_omSZ7R@#j(U*wo<rzqKgo#Br2Wi2eR+OF&0Nup
zb;Xo4Hdyb@@O-4w5oDvRmW-_B#C9SrigNYA9)m%PEerEuWh|fAj3~^Ye7&5T+Gj1i
zgn2K<x{|LjwRMS=)GD(hND!}_1<lKnn8qcZE%RDscS&rOMO{IrY-%Ymi!rlUE`?^O
zQD%rbJiAY5JaXJWU^I(*FFGpNAYf_$u)oRCy*X%x2zv=`@4doKE7_LA0jUR%pjH}W
zKMk^7Twwof8b325^bG@PD3iz%7~mXI=7*P%UKMTOS#ZqtFiEtj_X<}icAws>VSYGQ
zXUogeV0us{$^qO{;4N=`o5#Q7?|y5k+48*oB|ra@|MG`_@VU?V@<)BlNAo|u=okL|
z3xD*-z4z+c2S4ajKKXI?z3*k_*LS}2y1)HRf9LJ*c&BfF%PqG)|8IY*_g*cIs!#ZY
z$2{^84>ud}GiMH8^6!6Xac}wd^F059fAmkh_v)h``H1H|_ba~Q%fIBRtFHV<|JM)P
zb@xf=gHxwZ|L@=Wo!-avq|bih*L}@%KJ$rBFu%UyfBw!t{pUYw2KQ-S_!NKD|9s`|
zdE9KzUimw==AsiPzVHj4vecYBb^3q*w(pRXpX(|AkA?CN{V14sm<Ugt2=QqD?G>-&
z-YXA3`}6<yy6fMKat|7K(Dgp9?e4qpe$mgp#CxwioIG`E@s2H0gFd_-9v=R~fAs%&
z@72Q0$3N!dKIWqz`QG=w?>oNpdv3nv7E?bROycwsM`Z9_HRX5MMBz*VIwlKMNkHk|
zniOj@K=!;5M<Ic^pOw5nZdRIli0avi!tJf~t7XcMMqC!NdvWqQ@4)0vxgn!ake8h(
z1P(b|b!qs}GI~Z+TwfEyp}=c{m}U%)L1RH`e|{xVFExgmW$%P@Bgi@v8pD8-76q8b
zAkiKKy)i!v$05dzmSz<RlGm!h&4w@4JQQ&^cA`FP?`*w(6Ac37N6L>2v69yt+}EQ#
z=uvG<XH%1ob&R9+0M^=AsRd06ZGgAe_CRcA*)~c0Wo6FRC+*Qq6sojWQCe|*K_XhF
zBSKkHqggX+TH1q7?Lifn7J~VD9fuWJj<+auILO7z)2v%{7MC-nP#@#Q_ZQE~ImD^S
zSuEGgbd_l0*_B7LQ^YZ-Cy#f`nlM8VK|U7|<C2a=M(3Ev<9h^U^p@g9O}cKwT`blN
zXO=kQc`ZTiZp+uGSTo=W5o8{`#CQL~Zs8~*unK#0gmr+U9knhi|BbeD5^X~b+oVR-
z+Tv=A>Xzp*KkGVM_rVB<T{H(p9;CT;mb5AN0!IICN_-4<qkqIU+^aX-i{3U8b_4TU
zLt@{CR07PR<wi|7TY{Vw__IHIvq6j_2?pU^*T4J4FZo4-Uv$xl7kvNse!)|o3_3CV
zFZ|p8@KZni3kHATkNo)0{N%qh&HnXI{Orviw(gQAe#R4i_=mpV1QT8NuIs=1AO1g!
z!wd8$5uf!pp84rdc>IF@_V2#>9lCOXM?dOgUi4ExcKH?eUGN)ky6Kz0<vW+F`Z$GO
z`lbJG;nv_k@-KeiDWCT_24DL6-hcdqpxsGd|NOuCv5$V#GoSv{pLx+s%wK>1HGlY=
zXMdR|@}@uk%lEwJy#{~slb>|O7580i<(Gc>zr5>Rp7INx@)S*(;AJm=#rJ;S3l{Xh
zzv7jD>-o?7*hf7I?OS9Pe)i}7?dLq{Gr#4Vzu}`k>e|=8{tf^5`~R8o11=W$tH1iv
z@BH>}<GWG=ev9a--1wmn{qleQm9KyP^Pcr3UwqkR_j&1Wy!>DN>z^`zy8hkoe$8uM
z`+1-H*Ou0=eC6-G^SXDL`lZ=V{lt$v_OTzo;BR>2pZ?u%{|9&8d8g>b`>GV~-W3Aj
zeE{}M9(V~M5W?sI?9LUP0BpByPLKBduPZ`KR`$&r0AxNL6!qXb44W=rAI=pXN1*Vu
z%V+kfWFB#EB=L9L)L%+C<aJ`s5&gNbOv!4BS$M)bP2lo0&AeV{FK9;N6F7Z(S0XZ;
zoW{8Jz}f?{vr5ov&>k5pa%Y%UmK@_#m}hgM!-|I4A&y6sI7^6dr)`sO%lyXMU^tff
zQSj%$+(@x{;wQ#rykgw+D#s2o<4Dc19>c9aB8lya+xU7a)LWcIiY3{FqV}l$V!<<#
z={HbgXX!GB(;WOVnG9vx6~jDn;~Im)DC9?$TZM?j64qkpOUa^=#Vf@V3(r`xpB<RR
zbF)d#KC|YNsAuninwd`Ntf%}cQNj5N6XTG_ORHIIfl#m?HZBNqy`}cJWL6lywlh4h
z=gR#hw5e;)3IMTYIJ3wZ&uht*{BA28Q?X{)-CPibyaxDP5<?8;ej~67PnZ$dJnRBw
zKjprv*AGLDU|4Flpyntx02`#7dIr>cHoRB8>~)|01_%z&#BG^`HG=mlesh&_%HrP&
z<vMXJR<9j99J2InZMfN2*F+=-unpjlQW{;4FVY2OdVv_g(E{2DpC}M>KV_f<;9djo
ze)kQx-gcY8AO5h1!Z`feufOc%$x{Y@-gCdwc&`>XI5_ymzxB1B_=z8He*L4@zrlD<
z?!NovfBp5}G?k0r>YxAM_xV@h9{Gre|J`r>22c6F{<=*R^}E0K8ejR<fAcGi_iBL$
zTz&P|Jnz}i4KID!e>2F(ee9#W_iBM>KI5rN*9QOj7ypN)eCR_T@;LX-<7;2{`rB{6
z!#Doz-+h(GpZ>JZS0`bjm;R=pY<GJIizDojkMxv((YXi$-0yx@{^$$;>0>_b(U)C%
zpU?f=Cw=QT2k~!s?_Wi`QUJF(l=Y`ipLympp7w3u@{JFD$hB8qamCj@@2j5n)X(=<
zyyph%ZhQ5s|Ik-H|7-u|$3NyV#@avSlOOjrU;P}Az;@oiPBni2jb27}h5_ce0I}O9
zzuVU3#BdBdY+I^>lJHDLB?KHbc_hB2kN4kfhn<$v%VtJXW#mEICf38`^iSxcu>hh|
zhrl6+2iYlpj!kl`oe=1c3;^lDA;R60e_umnmbsuk;`*U*R$(LS#C9VXI-sayJzyl`
z1-SOyXljiC^Mo=Scs=rZf3PLWYuNfc(fS2MJ;)kBZX$+zZY~g7hGEE|;qs`;I3{Ha
zS5m+&A9lPTW0<zys#d6<AUp2noSY63Z?Ee^G)*+5c8>FUEYye6#9^iNnfAs8pw_R8
z5zA0WIhp*Dk<*O1mm8lQU{+(ieQiW6SGke$BbzaXQoWDEDp(X>C7h)|#lrm@fyDCF
zgwrvwdhMdZdL?EYmS!T0!vf)(@MXLLKw-s*>iG(T$XBGOOja-m_5ggv^DAMt+n}-x
z?lqs5$+$Gu`RsimdvE19O6^ge^;}tGJm@6W62GUU+K^?DP)P&H4#AAtdHWSY3FV^#
zR<CRQxp=|Ybw}X6S^-_8uvgM8Pir{jz3PH7Pg5V&T|~wv&0*85!Ae&5tA`!NuJ_Ub
zC2r)p693k_+irw66?0d%wp|;yhsGd{uz#;|QPsgmBrS0D)%QyqJo~wSi@*Kn;p@KU
zIe+i(eDi|*<y*oVh+q1wFOHgh!RLMMo8Dw2yx#Jbw|(>@AMvI?4{y4C;pcze6<1u&
z+kejIeD>ncy5o*JO?y*$!+UP<4gT6+`%K<`ar(dyz7RTKahzS};*XXtUjN5$;D3F<
z1FklaT)+RC*P5EAec|Vu4=<iMbNHG+c-_;U`V>>|Ki7EGl~+FLNuRacX*uOf73DwS
z_umKH|7w#?YoSbJ-lPlgrC;*J2geS~E)WSn|MNcQhhF$&=1=c`{|8X+O${FQ?!@Ul
z6WFfw$)EGt|NRxOG=KWQ`#)fi_uLTF_|(P2#iq<Np8kbD!xH&Jx;xLDZIGQ_(sv&~
zoMh6SH$MqL=B#2eWVsV>Zs#3u>5XD?XA;&|=b6ODTvT@ClPl-&Mq%zmr#Xpm5ZW-3
z+U*PXZ&Jdn4}B{OWK9XeX(6vMaWX+!V|+}MdA5(vI4IXW<jylubjAcOb5<0$#Y*wD
zGNV<RXUJsXaYHU~0#@&EUOKsSL$7%+Msj~ZD_g!k0g7)|u0&B|BMm7RZ5OvUT5#$w
zwCD9G>d8kvL>3;k$IxC3b*r9zWzVe-bvjg|A7YgHIV@<#>a9m(ff#gUI!i_>1{X=1
z1J|CST4{li#pW!T;Z_aNjF4p^k5y*I*_lhp3}xRTO=d0|3{%rsF>)(RZbcIH$h<8m
z?-5Cf`EGql89a<jx>hH6Wt~SXmQX6CokM~*yW}`&000mGNkl<Z$^zq9F0&d4xGXCj
zP_8U#V2=*0Bir2X!+VvdiOuV}NlA(|z%Ei4HEls-bi(So1vN&rtJRigdj-9wh?|QH
zT<RuuOLKsWuBNMIVwV@MNg0Q#d+2Yi9N1>1>YjhDuPrQm!-Z&fhBjqp4<HPBt*{q7
zRwcORng@9N#v5;fariUmpE`d0*h8*;aP-&3G34>TeCykv@${$u#hc&iYaaU0heYj{
zo#-_Wc))dcTn{>N`(1b4eaR&kzr(qQmcK4;Bi?@b^`eVT_z<uPERHsB27mH~KmDd}
z`HpO}JMX-6)*sk<`WJn{kN()dF_*mhHLo=ethc@W9sd2nrRK!(W6R$;<u_C*s}DTs
zpaBmLe4x_5|9;>7?|=2NV+V`NY^hvi2YbR7Q^5NsI6Uy0YXHK@<iQVmp#Rfdcc0X|
zReC2=<FyZdko~jXR4xODE^mvjQ_%gDF>o1<vR~^XCq?jN@p>(h56dx62;8Yg<Fk(f
z2!0vL;NrwW{CsZvD&f9giQDW>>a;fHWOw)kQubV%1ZO&NJQ$v*$sI2U<kIIfgANz<
zP6HCR?@}>uh0edFM%HN{@)}5-xRxf#`J9u2bO)1@BGszJ=V6UmFUf=*?V~TLmD^AD
zyNAH6%WK}s6|B)(4X=;d_-kECqqtsJxEmw=ubTzFKEX|R3x8vgo!i;C8x6Rz%Xo#{
zn9iWz*PH7$0Pd|fsN0NLHv8;K8^SzS+K6`vo760BzPA{+F)Ln4s|g-vUE0RkOuR;=
zqwH|=;;c0XVJ-IbAJ=2L2FBKlrCDPwxnlWTKOHm9J*9|eQ)6~B9CE8f9dB7<9}ZNx
zU!-G~9mh7Gd%(GSDWl2O9WB2mRJD=E+oPGeo3s0VWw)@mR|tvDy7#IG=za!hh6^g!
z^^qC^Y?H#U)b#>wdX(L8tleF|-LN%=0eacPUa?6-U)x|b*h3SCl)tI?oGfnOy()+@
zFlvE54h=Z2>}3sL&-}A3Xp<c6W4Zt*V^Pd8VkJ%nw7s*=2Y52391MC~SdswuYQW0R
zBOmz)-|k)4U+)fSJr<(=`u_KS(C1ECoG)nJRbW4tUw(zZz+_?fNyHbp@~SIRx>sC&
zUyr}@o$peg*mLROufE?^Y5U7BzZ^Q?z3+W5^ug^Pxx@7J#LxINQ}e1<z2@*xIhFX!
zj9>J$F93c2xuKi#ZMWTSj;bE+d*91}?*%8k_~MK0-;C`?BcKjY%a#zME#T!>+}GcP
zN#%DxAudv1D!jw1@qYKaDmcZ=-WT!etFPvlIDeLzKIAz;8J85?FJYgmvtRr8EWq%D
z7J%Vlr*5bDWa)!D-|_4l%a3`N%G8sq=iVy_xO!nmvxCHxn8%%50w;#6+|oJ^liQ;w
zdeHsa*rMR|gYn#0I=wqtkBS_^Br}WtA(YV~BEyS2hk?!Q<wiEVm4@|fGUmNSGcZD9
z`kaG2NfOtX`@&<QNsmtm!StL~2?U<ajWrXNb7nCOPuv1)BVvq;>~|Z9X`bU;|CKfz
z_d13G9WyfaU%7iL;e6>p6ypwTd_xVU_287QC!F@k1U|~`{miMfA)*dC4xgran=xt{
zp9=NCjpcM%)i(NhleRGyXlv!H%vypL!alT!EXQw58dhhllv`{$E1daBX9Tvg&c%3k
zR=QbC&Qq43-3<3D1Eo0R@#>0XS028a<#9hFD1$>4kH@04R=3u96!B~Fej)XV8NIn0
zV44gJ#&||!ndds<j+x>@OC&7Ncfd3NdCg>Z1>kj}t~>fy2yw&a)f2^FM-`fw!B&#W
z5$$PG@m`HW$1!YxYTu!*k08S4N5p-2ub>xD{8Ohnpz?jN$|!e`Uu%uyoUfe3BVDYA
zwz_b$zF>teYEG*oWCLLPdF=r!6>G)3$2qF@Hj5ZsbmGKAANmjzRdo9FnZ;A{<R?Fg
zH~7!L^kR=M9;h$<is$jaKHvfO_Yp%k-}K>>{)aytD(`>)`!7OW^T2C-&26`SBo)(t
z4$siP?6S)iCQqJHF;+L-{9&^%bbnW;{SSSpD{yS_uX+57p8EO!><7QEdCAkh@F{=z
zTJ>SUTW`DVjeq*4Pka0)|K6*u1M3kFf7qvd@+Vp*CFOtmg73rlIix80F%;bflkE{1
z_<C03_JYW7e+HfS-cgdd?6UiKHQs#lhr?b{!*VLS=_aX0z7sV^djcK*0(I$Fi4Lb&
z1F6)qG%}iiiuhVR&n+hnGJNkYyQOd+=;DWIV6I3#iE~R<_MX!GXWrAPbA|qZNz@R+
z5F=LO=2D~?e~d~_VtH8{6GD^5hh<$O75>#IyO^>*{kSYV*k^&B=X@*x$p{W+;hFZ6
z>b;~5tGHMXDtcuKb2-dwZh`>*5K2^7`Q1s=1yZ@%X7o^G;Bk8!>tz1R3>1&!;KD_b
zkDl5*;nbqzZE~rZEB(rx?)e^>L?OFYq#2>N;C9VxxLEH<lkxgdTo2$Z!3<|)X+XlG
z#O?((%d|G1*5kUhMZfhtdR6GFXTgoivA#;H&~UfO>gSJZoAbO;Il$G9n%RL9z67k6
zbT1KD<pTi15DYfo9X9lc?Q{x4(OZYVpqICH?A3^reZH^`ifHc8of_LnSlh4IzVAv<
zknW=iG@|o;u<8i+jnyjeRj*-%IF~U~!~p?zoSUW>#CmUNZw$1Nr))qM?U1YWJPfaa
z8)={iFzf=y*Rk_I%nHjtM+A>xx!eEEPyalOz`?=6BOd;6gD=hz?T`|1<A**JI(oS3
zh^LCb>86{b_RBcF?|tt#_~LW9=9&jAd*=r}=o<gm58rYtYmOhf>1H|fMZI17;P86m
z;s}Edc<L8E<)VvhDAVg+`^PuD_pf|DuV+5vsU^yGPgyP_dDWS9wq?w|-#aD}#&<s*
ziDUNYlqG|~b-46-vrwaQ8pbmSLodGcF<D#|v8(21vrw9ttWYE5if~;buw$cJ9{ep=
zHJ`28>N|BtUd<^_*efXD)skxf)q8R<q1}c6g)-=2a;5aMfH=D{ErBTQIe8|ole7#B
z8fTF+ib`qSp3be5(IGn#0kd0;y9e_q{#xnSMjOUVFs+gfo6%k&uE}O;w_sB9@tF#Y
z{`F};&HiJ{;0Xo&bwaeGkk6mxV-v__H+QA4k46ev92O*I7tL;j;tCe(`BarrLQtv4
zLj45BsuA)w6V;=uDYhq~4m!S^0Bij+YBdh)k{WP&!_Y_o7Jki)l%AWpdN#7sa?JXZ
z*4rNtHWn;U+A6bH<5vQRty+JHB0D3(e3^P@87rBqTZ<U(R;`j+C2~Ajg|a>xNbp9<
z?}^kd^XoIivCmT@bO;G9%K=S7f<s12MU7FT%n)@rzk^e*jP(Fa8&1;weuYp1ZrglA
zXH$(Jihp(@l@MJ`irt;CpIX~{wIQ{Bz#(eevbXC%6lj{QU0a)_Z;O=3_Ox4b2*)ns
z70T6%2Zs!Yh6P3kaR<A_@|GoTw2><WH<J!mD0by#d-4Qf{DYW7&pMxb1FZg>efX+p
zf4Rrs_V#!D&<p=nHl@^}@IQXz|4QqPTgt$zU-O62Uw`NKexJ2`7)S@!AH4SU^E~tR
zfAEKYbo%regFotHKE@!|JRl_M`eT`V{lCBBw;_hSo*(?+2OT?hU|Rgeo8NNthi~E6
z{N-ET_KtU6x47F*oj&a=?{l9^Ki9>hEuy`OeZ}wT`u#xz5#^gcd<(Mk##`R9DD}Dz
zedt3cPn|}$GZw&}d0L+Z7lm?Wg2^4o?i5W%nD_$YZFwNeclN4R{XQ_luYBe2rd)yk
z65_kAfA@9ox?UywXFGfIwLUX;=?RML(JI=(#~up1Dtl#lhQfY5)Dy~jcee3w!)fxd
zKMUNd9tiVy?%ZI6T|2MOoN8=6ftB3_cM;pW^GG7no-CB_k~sZ1+1bus;D)k$TL;|n
z!r?jAgH<5grErb8-HY*97|r-EtOe~66|@Ijdnh&L9E4U&23IhXs7Iz@gS%J1<mrea
zoFr~XfoVG)1>iWw^$_ErUzeO!%v63v65PCsC+i{8-hXwDk6j)|Y`3w4n5j?ff!wV&
ztq-^vW&M4LU_q2^51wYW-nO4<?xSM`$k#iV**E*BCMkGH?P`%uY+|#?c3#1u(#FkV
zQD3zL^CD)(qBId^EeW2n*pgM7TwvCRMd|FYGst}hHl1ZD4iOIiZZ#V`o%JQ0uNc`C
zhA3WzGB{iRJ)T|hQaqk1a=p!rV_~h1*ZBf2bPfUsc~1exT7g+g7*90mOMW+Gey&7g
z;0Y0A?!xFtAELXt(?)!kk2K)ShihOT4y>a&53KWEVfk-I=)F28NsWoPoqGr^HSBNQ
zg5E>vh{*f!uZ?)GdSQ+03VXE*YoL3`%&IqNhhqxg#C6r`aJP<<9{Zr!DZ(nP!n(^g
zlD)}_9FFm|YfpUc0dSWgJYx9l&-#q7e%@F4U;oqp`zz1;+Hd@Kzxd0)_3~G|?vMWD
z^?&?^-~OFf{mjq4_$$8Z>we$`|H3!B_~MHU@)ckHrM~iKe(uHZd!PO0-QtJ(iJyGY
zo8Dx<Ir!MeKIREec>IEV+{Zr3=azcsJFk1u&;46}`J3PJ)*tzoKjDA<>gRo>K|bfN
zeU`8Msh{};pGJLQ?<aqzGh_^p9Xs}{FZt`{mpkvg^ZQ@$Li4S|1z!8Q*Z<A0`Npq&
z&ewm@Gr!`6Kl0=JGXL?xH~-~Zf8#e_Zty33+T%a!qptOB7Vp)wzT}HN<sZ<L&93ov
zf21fs`?-qp5C7<o6Xcd{zmFtgFX~J)v)~Zc9w;^}PZ?3ZIl~SeT#Y~WuYc;TZ+p8T
z{Khx_*-!lB&!${0@LhlZ|Ne?+f9+R()z>ZM2XDL)STDLn<;enjCZzC`HDtaBCn)^~
zpCOB#l$;8X?c=SCVe8HJbTV6qJ5A2v4I_}dc@Vi&Og+o)1Z*Ggg#kv$_lxMq$Ygpl
zhlI&F4!P_CCqS7O%<u10Jk^O3&P06hzvfsE0mjbL#BnEz!%c21=gDH83BX*&8Ky~0
zw2DGY;H}#7JO`zSdf+&k+*o#RlV;WNngp)lnc{jDr6O^}R`wrVTC1*%l(9@Vvt-sY
zqjKLq;Qst($EApK%Ph13mSd}B4~=?}-H9zv**5+46wccn?J=L7%GXfvgES?=k~Zv`
z;k;PJ<hn+rfX^%rD>LH2N8eZoCRUNRt_YvTt=f)eI%|l{EQFCfR>*K$Z+$cX@$8m(
zSpVadBwk_gsPbF!n*k+wWqr<!S9g9Zlq+O}M~0ujD+$IEO}f%rLcpP*vE*)x;w~I(
zhIyudz4r?2E|0k^nUQ8T&VjYfsQ_VzURoFT6I?^73E2Pll9-q_-3EFIZhZE0e%}_{
zQ{)}%e4zCj?^PdEDC1D|2;~+W+3>X|9B$JQ2JTOE000mGNkl<ZC)NwKPS?zs?bgq=
z&{A`|T?*&6yJ|0YnoihOGvD?t-|(LI-0-_DTI!wGy=!rBRN8;>Grs8gU-vx2!>2#t
z@z4L7=f33M|I&gluBEU4#&7$q&-{$z#}9t{cV6w^5L~=nFZd_lbK>}MbICvc-hc3%
zum0P&-KO3*{F$G7$s7OlO^^AwNB#L<yyf*Qy6S)XvM>4k&wH}Lzv6#;)-V3Y|9s<(
z|37>G0dUuG9EQR(7rlc30d^2z6U8D@q(o7LYE+jjQ<5dil8amvCvLG5D~|KOm*gcc
ziSx&fOQKkEk!4%5)qA%JRVa~^M2bc11W6D8Nr0$C$M@ZR=bmk|efONbA3l(G1TE*A
zvuAd8c6QIs+&OzjZzDeV(5AQi%sZ~W`bAGXvF|(AUB6-dnY(xI=IK;Po&46X|FiFY
z?|L3$`_{Lw`-y9Q<`pl0>86JtR_(4_vErY-^B3qXS3UoE%a$$W$DcPbEKYpoD_-K`
ze1pmPC7T}JOgX>vSAIeIEhgxFuz8j53)?7(QC<2W6qJi0_@KpRl;iN0pStEBKJ>B2
z9@_?^Gu`+7+%Np<IcINZ;*1YG_|U1Row9J@LideMt6eRXEi+Rd8ah`4rRRh!v6Cja
zw^W{?#dD~#5`btU$VO^L<u5oqlQ*lrCr$^`=gxFJxkmo74Jry2lTF%3NCOrf<=I$_
zG2>LMz^Oyx+$iQ~EPBq=ke)C_)$KGeWC3l{Z)1^h=ik2zwQE})OUNn5YcNRnYk(+E
z#bOzH7#4ona~NuuKYc7Ok<v{IQFO9K5;};Gq;PE+p<8PYq0?(Q_2YDoxpYDSkK}=#
zqIG7Ir5QtGa>)pch;`nXJyMcq%A%+R4jB0gC$S~_3!65dVXo!K`sR#7a|T&c8lrTn
zXG?F8zXG^T8DGtV^vdI1!6dFNCt5mvndveqn=Z3Dl-3M`-jY-;Yi3~0W+ws7g)8fZ
zPWM$0u2q4Am&>0v{aHColeNZ?*_7sl@`;_ntwh2+o};OkKU1>Vmd?IBjYc$3JU4vI
z>o5xQuM@orONjFEIrGu0Sfd?PTD;cP>v#x|{4)vJ;?1%L6FUFu1Iq@e3QcI~fBujE
z@}K_W@1L-8WxVEj=bqD4YyLI2DB`dG+B@I%uYPmMlEn?aZQJ%wf9CTa`}k*6G~|+t
zFMR)B|DQA0tyA?+I%)0SzVH7$^O?`!f8KE85B~P=Kcr$kixw~XjbD4`zxmg{r8?Wh
zzy9dI|G%qOui_OBA35@cFaFcFzw^B&D)fK<|K7D?h4_@=^wd;b_$Czf-gp1W<(FN`
z|J=Q2&qqG?$?I?U0Y8Mkk?Jqs`=@JGpGZe}-n_Xld&!F^lLhnVzx?W#_&EQu$@x>1
z^IyF8Pu8Bent7jKWVdRV72Q)RU_2p**#^i7w4`j>!?fqmU(k&5nl&d1bxlv-eb0SO
zuyXmbW&iiTd)Hu)*i{P2QR8mOO<4GmbQezcuVCZ)ge(=C(7pDRS`g+bL7wXbENjOP
zXq=5jOGuTf@4VMQd|F_-WK4d_k9)Au{XKw<18BYJ*&i>td@LZiOV@cgBarlf4@vT{
z^!N%*YD*?1&)DL5SX8&@6OMn3z^iRdH#JQ2unf9Gfi?o@rGt^lGT_p-u6q3ZEF`!X
zFN)I=`Mb9+-J$Sd^wG&OLG8h!gJBOQ9c;Q<VZ_4)ZMp=Djsd#j26=oW(bKM`=%-#*
zPf^ib&9s?QgpQCkBEFH8`bWn$AZ9sgrf3R3e~spB0;3kL@~}J>j(L_3W?mH#+&|;g
z45jNKGwDn!(z^l}D+6eXxso{In7OnNU%}|}j-^X&Gia}_01#Q3BPGxk$;Hhw(lLAG
z40Hm+rB^c=x1N>Z2AHpOpWyaWp7fMKPy^L6u%cUGgnCfDArHf@^7i!yFu|&uTp3d3
zGR}@(<yEPjdzBTvBLC^j&C5GlqmbuV<ZKy_iE~{;>dqhfPe!>T8FMRUa~Tk8vHL<h
zlZwrk03+ADFecghLCwb>g<09z5xn-*ue|a(SA6W_pW3{6>$dHWZ{7OHBac4DrCopK
zy5~RdIaj^ldCzWN1GJ!teZ2Lj-}J&4KL4X1`_#sb4?ehQ)9&4S&T8&ix9-wQFS_RS
zuSI9!T6e}7fBENs`kBvu;ij8!duY?9CX8~z2`6kgbKRL|p7G{4T|-~c<8a}H=l|7v
z{_OAn;lp>{b<aZ&J-lK4y5~LjiZ{LC^-VaY32Z&^;6qKFC-&`Ay2Zd!*>HaE|M}yO
zf8sMY-*Q{S=Ya<wT)k>lLww1LuWGu_V{j(mD_-%^Pk!d}>hGqT%a<<;aQ>ek|HNlo
z&ZBdq6zA8x>J>|uE*85?ckrF~g+(_kQEo`pyL%R0?IsBu?K7Nz{(0~FtN;Ch4}9eI
zAK&r7gPYc`KjS%9JnPMGc>PHypQOTn^XAV(ZlyjQGN#`%qE(pn+k5-^V=||JP*kRa
z=z#9KtgpJEWkCI=jG)V?%IGAc78f$8XbYpi?Gs#hmEt@gk}n`S>BosY?G3EWGa4{L
zxBEM=`|GLW(T}F^I0Fs_mS!9rr20g!rG*4=@|866TXG?dDJ?NeV*^urMtv0>BR%!V
zKR_lEPOQ-f*Af_?5u^Mjm+sRlW^0~l$3I+WptECgc|wY(dM(w=!}8P@ksGSdc1+Qn
z5rodHIu_1&HqbCuN8)n%3Dl8mRFV(Jk;>+Bj&pP7czl#;He7PlFfs~|Ihq=mCOow3
z3_W>R%$g~bPAnX}mfwbg&^sgaYywQJBnFOXuK;4LL3d@y!@VnvZ%pGW7+4k+k$=p1
zXcaP6u=w+(hnD;ri%1fF+G<-3K9$mR6%j+_85}y2_^~k)7>jJCOLp+sxs~9}Sjw;@
z%#mQ_FwMChVufBb3JIyk641e%Dy(YsDpxi!sp~P6Od-h^i+I8q<dkgl^d8}iP<|!E
zxonb+NhiLBQk|^Pip4Sku@=kJ*zwM)UG_GQ@ylKqhg9{T`@kre-5q?2LMX6R4rPN&
zeKJOOsIuf2_+~Hr1{<db$#8m*4HNrderbAY`ikd^W9hGa&a?japZy{91G-yfZ6u4*
zjs6<@W_2OhM?bC`Hc;vZXREXKwB_yvZ_ph8jt-T6q}xJv`DR?eLs8<oBkmWdP<{ox
z7lBSt9kP&NhUi%{aR~BIsgw{B#{rhqXC6~fz81&Zky59iBb`|e&iLRXVeH^S4`fdp
z8efUC%n8Bch8e(eE~B2Py|_Wys>@W-ftz<ON0v<fh8=G)H439jp1G+;Uzv<W_gjlt
zX0)ZrI<}=brRPHx;)dW%iLXWNEc4OBU@k)1U|c<8?!?V$wj2TjpE1^UEJnyl@UeC#
zKHsr_<2efoY0Q3VgWN@UHIsrmuMk#?UiE6FxS?qDss^ikrkKwP@<q&JmBlU3iOL>@
zV-md@3&T9V2;=ZV#}vI{Ed=h5Fi5jDI2TXZLjK(Vkw5$+LR4r)GfQiMNeJHEWy!*#
zxnHl#8N%fCYy48>1BU;V0rLS&VD>@1kt#DDy}x8~=VzA6gHkw{xY|eREvkt#{#~|F
ze;5xZ2yY4mJ{(Rzyk+b6e{j>MKK=PyZo5qcSw?OL-gd{GO4Rl1&qN|Kn)1tTIJor3
z0F0Om$A=@anEt*y?Jt@*aL<{0L$UrEeFq!YeV3vQnc>Z%;|WL{K|V`#-<g3!yyQQE
zH_Z(h)dNtS3}kh3rWLdG5Tt0$v=*&&DCkmjiMM7cE`wX@!BpBq(G|vw$dngP8KxX@
z6Cbf2>Nh?8<p9K-B7QzZ1!^Y%^Uxif@j!y2IHMr&cBGi74#v!K@K)I}6M>E(c*c>-
z=g^rm);P*XGrmkm>J$2q+zZAR@xY{GfG%+4FL92t{Nj8>e?dk_LhW)>O7S7w{OvNr
z&CkKn%!u2-<YQ=TDDi<;^J$!=@PM_n?@jya*p?P3U8|1F4)2UmxL7@0JX{86G}tRZ
zN;D4+=)nckRB5k%=4#nxe4S^RcRde|MWEFB40MG>aa()tQ%~N&QVm431lH3T3_PY8
zUn!u)E4)HjbBB#ku@#J7O+~NbcUJ|{)Qm>2upX-tU~r70S6G{2%QUCbYzVPs@{WYA
zda~}3cva57BcxiHnZ+)rweIWFv6=Ng2{3Za3$rqs({Uswk*Oyic*nFyu9n(c`mUM2
zR-_DiEbcbe+-u6X2Jf0~_J$jN_#6N7UHtF!&O7IC|N778FPPuZ4;?x3H-Gc@O2XH@
z`V~N?2i<rZU9@mCdgqqXE91hU?eF>hG#+1IQFllC1G=lOhamRcjMoUL(DDt?{^B@<
z{eeKq82>05BJmsy525kZhwA+!;vr;|AbqEyd>09*9|Z=U@TS1PX({|t9`*2bl<C3u
zn`aY27%B=94U3oyY7P5JejAHBe5OE*zc*zH=keJ}O3pV@hl~!oqiNR>UZ1R}>CUN1
zAvzGcq>Rq(7Vj0>r!`3&<z382H+)WQS0-K6FQH2lE9c{rkcnYT_f%@e(wM7B3~65B
zVga-0d}R5F>F$Vku{4ZX+CW+|Gp$;S<(n4_n9kR<)+jzM5SxRlG@eu7;EXY6b%oNB
zd2lIWqI6e3x+-R_t5#{~9~|5)GdsyF%{wKgN{`0O5**xMEpe7AZJhwo3>1_CIHl(+
zgsELPLMEgth8x0eETaLeY_TJ(OpY<Y7$1!M)lsCfZss{!*@DTvL=~R7P9Q?n&T6KR
zG&9I&n8UB-$;x?V^ghlOi^y@#1=Fkgs6|`BL@Q<MLbADNTb=If)o85gs(^*7+U$t+
z^d0=!9<i!q+_M5^v8F4%d&ty(u*-g0Y$0i=fYO2Nxk1E4v{%+p-~7|>;OB)kaKQ!V
zzwoN(?cMvt^*8)r<HiR#@n?VLEx+^Izpgzr;6Ao+jF1cwf^3&|iKEWR7fOD#zu|>m
zdZ0dw=t1?@)`NHin5QOt&c-7C7_+{CB^xo$aFKg)q6bR1^dNicj!TP+Zxn{k*>Nd;
zoHygGLo~(=%OTxRIHTvM49O`o?Nh+klA$pcI44WU;H8U9Kp$P>>U)u~emVGnI$jXK
z8Ou1iM(CvFnKKsRo0u76=bHsS99T}fjIr#~omjGtILU69)9$d3eR^brnDz#Fqrl8j
zfVfo9S7RmTY6;nRaM!gu9&d_Rqie~06bMe~#;JMsEE@*sL7YYEw1Q`y+~iqpnCDC@
zipOVtwsm#KW6v6UEP~GnGIT_Tky2_V^t6)N(~=lZAKz|)%!|+yr;Khq^#rczKr}Gc
z09MIHE#*3v-q|C11x1oaWy@fN30CMuQxKC%41I4tCdZswoLffis$q-l{^l~2Ol{1|
zuwc--#x-)-rg%p<Ba~l>a6a}53A7R&NT>k4!DbUz000mGNkl<Zjj&`vt=x2P2x>Vj
z+F0c&fi8MK_QH3!mZumT^MS%XLuEv=D6TH>&8Lfdwzoo{G`@N3)?fe4-`%`<EBLze
z<~LpQo4@g^OBOHE?aC04NAyl$?sUoS7BJLb?FqE8hID`Z4F~9C6oX?Sy)Wnwy7NwB
z92I9{wc$qU8xT)PEm2+^5h*=v6(t>Fv<DcfLOR5}S{?c{tV*Sv*udtm&&qpLUYtpH
zaF(t!ba)yaFghj!FnS7E<4EaQXKW2Y`0?R7jKpWXbjM~`fG!0WI6{Jt=zP9?#@ij?
zLl80RKuz(j0EZj;HN&_Hz1nNVYH^ktg?1HkM^MKItW(%R7DBC#`K?aOwa{8Y=^7aL
z>7th!4=e`m><g4E)GZy!GU=5euuLQ^P~lGG1u(rzRO=W*fzHbsjI(x{p-)&F=V(An
z<`cXCdIhkmMX#dO!>wQ^eqn|PrDFGuUIAT1SoC^<U<s+REhXCr!<-t~+ng-%3j9N?
z%`neUs^?yHj9#S#O|r!za-4In=~W-HXcN)Jr^X|*Uw1l6P<@(rmY{46J9eR;UPC=Y
zV%IRo33P|?4|3;t7Gpqii#nDOSHr4#=+L1rf8}dmzxG>Ow><jTw(ZN7Ej{P#4eQsR
zdCgD0=By1Hg5DrASPsq2FzJllu2+Ug$rYJbpSgSPv>t{&ZXi5Z-QSeY<|(Cnq47`&
z7}Jl=hUjh&{B-J6O~$gdM_vLHu>;=KsKyx48#-*j%+3(y0A*$k@txF&3p%s(6U-6d
zPMA2Wn+}zB&S*Id&`EvS0hNd4vv45~V6L1b4+|3YN93%W2x0^A`Yhe<(9Jsw)lc`A
z&$gueZM(yGO~=l&dJ4Y!TK@nUJ!Sct_pOICJBAUvvMp1-3G1;~lA`9$>!AE3M~vz@
zkOvgZ58^X7xE>CCchMEY#l4K^>g3`xTtdz|N#%?#B)MfJ31>hv9vQ4Xk|d8QfQ3*5
z*rAEoZIR|HMz5f&cy6s!{!6Z48BP@D_cDuHHnY5HSq!stuc~sBOpX6U7#3Jlx@yPh
z6(o4iX!I)UzHtm$v<XZ!QM@SRa1XTAgU1-!?FG(ynv&?ai(AdK!2Jwy0ySX<N4{%3
zi$(Ubq*lomSO}ErJ|?#4*6npNlECbc+}{uAn~#q7B1_h>zhS|1-sa#elIl!D#6onc
z67zY#36DZ)OzayIn#t}5v&7G_a2BFQG&~55f)<}a2lZzOtX*nHVl?p~e?QTolagt(
z&YG=gjaPUohWu5_P6h*v*^l&)`5!*IRUiExHMpKO3(%#45hHwbyX^!(h)B*OYf&#+
z)0sIgVf{mL6j<3f1}sEUi8<5yQM-*!fY`-BWR(kaD>Mm04fRV;PC;Nb>k@eZ(iykI
z;}k!$9BY#?{X|E<Cv^V`VYTSh48rV+UZI@0iRe`od5Sq6|IsTL1EBFAAC$YbX+b;j
zL}g%|*`k+i2Z3|%t7-trrXnISmMe0ifdsG?po4@x?qL#O48T9)h-yuZO2i1j3;{a-
z3Se9UW5&M;%pRD*k?Ll0?bZ?7L;+Q5zXDW=b_ouyOCUZQ$Gs*0PT%O$aLm}hDkmM=
z6UXJ}>;`1TXr&U}<PuUn5ZtD7itZ!NO=wS#9?8SM5vJ&NuTf?(pwV~GKDic1_nkr8
z3mAZTM*HZ$?UxFf&Mau@7S1(6aPi#n;t<B!kZJueFmNs#w#<z4o`{yhxY8JKHmx?0
zXh!44H|ZD<x{J4ZQ_f<etD(YmG}FdG+=E2hZ6}G5+W3&k6Lz#;t+gupC`8K|1!0qn
zNrNLJV&NhL=+ZT=CZw1!gigXXdMwOv4n%MUEL4Y?IA+jsbh7x+OJ{113pxhqM*X2a
z0m{!OpUxLZ49Y{iXsNwWO}<v-X$InTnB<cjDYYzm>v;H>mZNb#1;z4hTN(;IF|Wl&
zEk8Cp+?mD5%<|CX%r$T^qm9|ERshlE@XDZ8f}E8{u2d2atY-05(TfYEy5k7WnhazG
zfY{pZ9~bhxVBXaa!Omzyu%A#!H0i@ljTuiv=jrKc0}L%GQ#GE^##38?vB@z8nP^6p
z*fj$yx|c#I1+3f(mU2TV6}ztnFwF;Py}lv=i4yl_)v|+JNU|zmm?4;AmS&jCjWD$_
zFT(;&R~J&U#R@zz@>eG3tebN6)kzh;Rxs8E^o8D*T)cwLi~_S{Ko4yu#qdJ;BZ<J+
zrR^o%lSG2?zzmxi%%ljJKTR_-y3}(3={mW%dxKGm<~_K3tHSwj_2FAJ2Xa#vFxq8$
z*CTNLx7&B4k1Q&viCb;^XagyPSG9yCi?a`bW)d<9Mw_>X%A+Ml{d22qw^m4$L~toO
zBRJT&D|b@<=xxlzy%q@031z+kXE_6|@a)`>fLWmDI?|n+S;ssKjQRPPc>LrejWYlv
z8WJqgmxo15rs5{F4hSz=)e+oe9+u71uFpbzkPb$ek73nAhIxI=D9t=9N5h^xtk|eA
zi1UF=K9ZFWB1RjvcIKs{<VY2x#Yq`yScC$x6M+7Xg;p?OEvDsoR!9fW8<$$*Lr~`?
zp4&JkhTp>J6Vu&AU_?vxfQ!>T18dw+H+lt$8wzeJ{Vg=mqF|L(F9T+fRT1Q{!c6f>
z1WPmQ7QKqdS{S{;F$f8K+Y)D-!_yS5>j2eTwt7!G6h(CWdPlEv$FyGbs$gj924YZ}
z8cn%EBuYlV3^NkFipr4zi~w{4%>Gvsu+zUME6f5tjIF606ZQS_3GJ~-*ybak#Kl!m
zzo`-&(Af@~xcKE6<X+Z?i;N`l%e>8|Rf|k%qHBxQB?p(i^Yj-ToH6df(*830_vCgZ
zYX#-aW4Q0M<XO9_*R=2a(W3VH0d-=Oy;&+>0!EG^FM01Q&43)8HX94t92t>~71UBN
zdc_~{j1kQ+Q%fSi<!DdivKu@Lk9JJB-EN0vSNUbFVetEGF0QsFt~oPld+HP|F$ye-
zGrnPvR#aLN;gA>slR9uagDlla2WQ+Klz%Qq*21}Is&S8$!y%)#;ntCK<Go!59=jTG
z1LmbW^)b#zbRx{he^;uHnPo_;dNi?Y)LcAd73kpF#=viT?Uz6k_UW^HwCPF^#yWS=
zC{YRSTLGdaI=Fx339MQ!Zds0Jg>-Ps1~NJ<O9+e_(P{{{n?f6>PhnMpTl$(wYftG1
z3_PYKUnzj%Kr|B-xl0CCc*BHH3fQ5Q*lpN>8<vS(AykBEKB$T+B4u~6V(t}_IhnP%
z<yFkmT<2I=!oYHSldjh#bOqHqj$SmMZ9P3e7ghN9r<R)X#VgPdBpT|+qiTyi084CS
zMuJuxx({PzA^X|W>}=^N2IDu{F|?5Uv6=;Tz;frxf|W3Ga~kMP>UVn~v&Dv4XfHJ}
zGDEa~(&Fw3<$*r3;{FDzdB3aWD?6Tz#YjV`O2Lc|DhdlkvUm$I?Quq#-LSR~>5U^x
z{OyH!9+nttmSgM`r`d)10!J$5q{$e6#m7+$Rcfq(WzP5P93>X7!%%j%1~<q*`HORd
zDt!b%#-gJT%)?3!uL*@&NU@^@DJ#{LVY<7X1(I_Mb}QTJlQ$G6VFjiuhS#*<T4!|_
zlH*tbT=BhSO>uJOJ~0AYS8AHhpk|6QumZb$?4m#{Z6$SE2W~STy{Zjqzbjj)8INA&
z!Yqki#TXXMfONf%zI2U_oBhb{e&GI8Q)$jK5WVWOcv059JCZ8_l7IbL><*}N{8F;?
zO=8LxDPJuX^v$%w@W1*nb1hAvh4E_}>zh!>qz#vi*(HdbI#W4WKz?Oa-Xq!$jsCHi
z0T7&l^V@H`$5n9|aqJHeIso~-SDcf@B#QD($F>UX8Z-K?DEb#*NoUTl#G{jafLXqZ
z(1W1?l;>oTgap}N6zVhefKm@Y=;UlHF&5NKCi-a;Zb&1>c_={XK<FH4)y8Ba;Fdx{
zl82>76NG=lM^<XabMnh*1V>+XGw6o)K!muEXbByS34CDC<?hj}V|10<h1M|I+GeV!
z<jgE)ox-EdnNiJ$Pxg@_P<*5Z|42Eb#yoYvp##e}V~dQbn4v(Xw@K%DShNmvmjf6j
zKr+Vc+3n!`Jgj(~d|c*;CF`fp|B9SERmv?c6&Q4gXg)&sjVwk+oLfcQatJP7s`OeT
zBNnSHd;lJ6kIocO=l!8E%OG@KRR)gs`BtJcO}j&dQ@Vxg6{h0(R!CMwaApt?8vuiD
zc7-|Ja>kC7#%kkzMxbs4?G;Zl(i+yR&9kn^Q_OtId!L5%DaovJuYhPwnJ3dy&<%;P
zH*ua~QYb=KrPKh&i!-nS8-0WhfJIF}vX#)~AVY*w$vewt)r$B_Nb7Z%N3pBND!Y$)
zDJ>NR<NUH1mUya|L(-f0P7J}zunf`}cKJLp@>dSqdaCFcQ*il**O^YsR-hFKw$hJ5
zSv}~hx0nEE{58V@xX^L*s)^UzdS*!*F3i*jR)g_=t0)cQR97u)&B*=X7u3#};4FMY
z8Sa$<l)vS>Ra7-7#Y$mJZxCFZ(eD)k>AMsWk?gsVY`~L!4@k;VXJc7jVx*~HmwC<5
z)L^tpW;E~M9_<M)&i+1~RSId55!}+GPb76cYhE)C76mU`-CcRK5v9}8OHZHjCY0o%
zgHM{^H{+-f)|@~;E9s+RXnc*%50iCT@dlWzqg~RlT}g*0M>YVu*$&k4oER12HcW8K
z)0mz?EW$@oAUsk=B@c)b=mIs+zuW?e2@z!kz7?Aqe7lR5Y=s@lt1UZ&h>-EDF;^aY
z4HrE%S1Qpk!L!F5IzvWR?9u7lY+;k`P5>eCBz5tM;EGw6fmL%~i<O%QscS}}S7mT~
zMz3-qFQw%e2-cIEw^PSHdX=H;Bu^y&Oj-$B%<N(o=N==4dKv|qs=>c^FLKodMU$m=
z=mGs-6`VN%{8Dvzg3GLwPV>wAuMXf0w807ijyE{gy&KD@`FVF`&lpcoXgv`1d#PE{
zUA~EvQ;kUcLWmc@#jn;Tj*2326~-Ad{mUw4$tevsXjdYBLY7|_+-YMrPU9(F96^19
z%<MawIFOty>H<deFaW(DGW$N1=4kwu?kN$XDi4-Sk2?^Z7*2o~omNDiey8*n)fh;f
z48<4pJkcwqF~;o&yqc6a$Zu2XY%D2jqN^yB)S?Kcw!y%8IpnjzR0%3vf6GnLjrR(@
z^kE=B%NR8V`lK^uX{}o6sL8I&j2oloXciDU0<l;*NJf1{*XNh(4#@hn^8+>5Zih8p
zpSEVwo%$HzquO<I#6s;R={yt5pm*ggrHX4z--{;Q&^);djS;j;W{jyp7komNqkIu!
zfo)T0)A=*NP*2#xoh}-6)XbuD3KU(ffrOqa(VEe~$Z8N;J&e`H!RfjLo|Ou~#=R?{
zS3v;b(wxy2ZmbMZT*$1NMMwW;38B*0j9-(16~lo_000mGNkl<Zoj~$QYT*&hP{5p$
z>=qPWkbxE5`5_bmc4!4Vu#Cx!WinUjJ|_7<{%KVi8}VFbd3*XSUX0A33fwXUtJzJk
zWWzYa+~KO&Uz2T$aSl&R65>3Mu@cNCFu}ZVsq!_Ef<zYzB&fI=lmb~FYuH!~C?2}L
zg7vnQ8RI@vL-3S<@#J%jXMlQgO`QtlyO4WUj%>msBqP@Ey)|*J5TpOCpjhqOw0QQ}
zSn`Hce=V_HuuLwjAC|9XmTDzXn?ar^HXRTHd01x23=ank+z^3uslx{f)BEEjPvVki
zs$qbbF*#W7L}5^T9##snG|9@jv5*f2!U^`%jSF@jmajfoHwEgWyA|};WJ%4HJPx8>
zBGpv}D-Q?9#wa~zZ_ID8?)ne8mgEyJYkA2B=3Ps59u|qS$V)lvkDi2{&O_Le>p{ub
zRT3w(&;*){X|ILxE6F3ir<_#*tUgU(5x1JrE6D0T=J0{cV9e}{UU7aIb!zpIGpow2
z<rw_KVwlx(uIdV1P*g=9hL|M8+2(ex`WS`zV}gH=Ww&=Ps;Vp9To*tv_BSwtO?#os
zaCH}KEYIYcOpCg9@Zh2U{6F5)Ag_Dni=X$LOJM^2pmtzO59Q~-@~!WD@1_L{=Ksfk
z`)g1RfAGhDy=U(eS6p_{8(#M^C<M7H&5S<SkqE<!K)<tY`3(M&S8?#hTf6h_jeq;0
zPd6g|#yj73+Nmem+wY<5Ks!6s4-||sHD1QfyQTYNu<24KS@n5b4~4Ucu1<tJjL4?w
zZC*ngH4``zx(}!EEa}a1d3-qCBQ^RQGDBljHLXBgs-YpFiTgAlaM6osoz`-ab$G@Q
zp$`T=4O_TUjohC}?S*je54&`s?I9DVVo|!Kc@rPtAUPr}&NAwV;E$I+wCh7wyS_2<
z=yOzm7}m4K^TuWLpGX~UlPJE3$}-wb%hrx2nm)O=r!3hb*H};kT9ZStEZH1|_C4jS
zIU65M!3QyG#D!7&Ef&=GH>HIS1M81DgIMNl0<Ml>j)i#i*>#2Kh=*1@H5g#w<|^vq
z{&DfH9zLD3<XEKT3_g_{4FsQVnRGWYDCpu3AVxv71i`0&5SQg#$lc}Ci(VbOCb}_;
z3YNzXbNB#O>}DRPq(}w4__WEYmxesSfbPsHaC2nC2)C@3>xxHsrWj`!TOKXKw(6uT
zR00LG{u|=oL*CxwSkQKE)gBrPwTjl?Gt+bc%7&|0q^j0irJ29_yN})fz{B(A&i(iQ
z_SfdlndA28v2Bn4>3crVAkVn)ytlsTHC`rPXhI>^-_#(#`On_Aa>a5O8yr4-<eS%h
zzX>Q@c>X!?)BvxI^@wWm8>>zwJe_4w8{G4@vEtU^?of)A;_gx?R*HLZclY9M#oZl>
zySux)26ssafq$NP=l6buAv2l7oIShuUVE>63i`GQyx@!T=pox{SxevUZm*t5od!AH
z=9&J@=7eOSRqDm=XUCGyR?gPJl&yl%ZtzpW?6cl55gco5MZUDWUm~?4eL=%WJpPaC
z*IclDzF<sFe^#w}kD<FGw(hevKz76SB0N+RbC*a{j$cfib3aqbn@{vBwfX#n_Y;fO
zZ?Dg@ftCP1h*yOWJ;J+>bP3yq5(&N0fYuTHU~wQ{8&8E0ZycMPcjeO@?a*8iPhAl#
zKe3yGVWaU6t2C?3{r+3GlX-QOjp~A+7>++t?kFD<viJc*TIACqxO@?2WdCHchFAib
zzDsq(L{ta@MJKN`$;iG(EW*z5qb==`5)yFt$&AxS)9E5bi=nPaa!GM`?JdBRaT!rg
zEsLP?ACFS<{k*c6Up=BU)uWH~ig9Je@2zv7z(m|uJcwRH$bniEYh4&%&<c}kv*XU7
z8t)n&B;cWU@>+zfx4sh<IlcoET?Lw^ONalY^Ahu8S!hbt!c3N?Vfqje2L;eumUA5l
z+a6Kut|Wp6pZ6^;u@5t{ToKiKc|<{MB>nCW5&E85FGSRO^A#}a<!~@+2IN(v3>q)S
z*j*K47}gUhXhU<A=-($oCeQpzPt^DTaPgCcG0|ypd|pG^$lH2q8WG3iuq>6R@_n?u
z9{HlCL)6J4O>$}N@2I<-&ODq)bLHjWEC11r!j3E7cpCSeXT!3QXS>bCztDcU@X=w@
zSH;!FqdDuIdq~HXCrr+I?~j1r|9%ul9d$k`)V>wxdLMlDz}+W1s(6mN>~?S={&m0c
ztUO3CSTi@+1Z`mi4D8*=8$hNXMOu^jzf<WB_lU|2`m}BfF^LfsGK*auW1I5v+kJ>x
zipE4<pu11KD9nA4!;$fGSV+<9c;@D~9i1yj^mJG_e)hjfqId%mq-ijex%}bhmv#qH
zWydFe&$_+l_?aCLbS@TN#<%#_gEI2tU;RKO4YwrJ72^B7aVOrbr&!$?9A=7$UHGJF
zCC59<G!NB&O56`rdB_FM@8J%FH};uE=d{#nYNA4giQjcFR>Ww-=%wV|JjgL6O374o
z-B(n@hNHsrInpNQ!*@PR=-Oc)aATvI^0AnutWO`%Jsb^8>YGIWg5f!4({`~(N#||1
z9!0*m-}OkMBsN2sVcuE`PDlhf@}19hd@Eb!VWA2RiV4DsW1Q0w@AV^1{`Z+&2QbF*
zag>8v{ab-^O1{zY09A>QM3QJ@sl(SsNh%2k%07vRFn6?5^s3tqCP&fFVUc6HzFJ0@
z6lM5b;wL3_`T;3N(r3j~JllU)CZ?C8KH6z1Xk6G3xr}#J^fv3L8Y^`EW(Ih}5h;jP
zMUcA_tkl?j9hU4TvRY)5MKLkA=m+Mn<D3x@WPyijebA%>E0A)Q5gV9WpWl%9oPak8
z3OeL`_YbO7sNg3G51Wkx45vO%^S(5ri4++lILyU~`TZ7?HPDM|sW|;-u^+=J27S-r
zf~kX}V+CMYL@SLh&vWC2OUrE&H1zzR*N+@N;zwI32{QJljV_W7Tc~X<$B<bu;&u0j
zhtyPq*YOtn?#Ea}5l|5qL5}}ZM5PkpB$43L>Osqv<Mq>s`?eE!iz$W8dugIJ(p%w`
z$2R_2<C{GE?n&^2_8v7!l*hjscgc(p6BM%pT#OefblI|R)j}|59~{FFZFk0=QfJSj
zh>v<_Z<GN>ftOKUU5xZU`U*7ZRAuxQKElF3$BGx>s<b<h?c10|(<FA1EIz;zyK3up
z-&@QnU@4o!g9IghMtUC3#>|hMp(eB2>1ut$Li2J$dmhy(_!^H*(TyA8Ygu4UTG4Q}
zsj^FC4IeAunl&_Ek73Klc<v-eOZM$jxf>wGk`*X~mh}lVd8^AsK*r7!xI3BErszYf
z#eE*YUp}j)W`d%!$(-Ma@S95Xa!_5O9=+!4wx(4XCyCkKysy*gr*QfvAvD3Ca6^5w
zpF+_4rY_;P;DO`ywb-#JXZ*4pcwOT#ll!V%Udd=gdIO}fpHm@Uz6Pa;Qpr0;D-~9?
zuc4z+R$l%sZeyOeaW#V$#wcZ!wvqk?3ERz_>Y(b-`p~@P3yTejgi|uIg~%BC!LfjS
z!PNR8;jrvy1N_6oQ_ic~jHOCL+_LpUeIcL26L>6J%Xrt)Y{3fWoglkxfvfg78o)EA
zq0!k+icGWVauxX6BRFdgt9KO_TfL?u?iZhyt<oW8ef8iieZYsj!cR^#(c#1DdfS`(
zFbK~c`79)$DQ3p{0_W^VA<mvJgP$sOI-1ASV$ZS)2AkF!L38#k_G0>vofH1|xm}lM
z1bU!ov|P8_g_*7wsToMN0T?9D%HPxWP<{PoI1;-xd7Bzc8;TSn`?u^dula}W3G7_w
zV$gitxT*3E9Q;08g2e}Zzk1(g0pNJT=0JYQ*J|_lj%;;raY-?xIGO^k@<NT@@uJ`|
z^v0ed2c}TGUJ@$ApBpigl1YPc-yG}^*1wd603Eu<*rmn3nD)Xm^(Oa+*HgFdTgFnt
zTaB%YRxL~+$6C>2LR`~Apcp{==aV9YQcMfdJ|!M#u%mut*Fsvni?`#UBAJNS-6uRJ
zGyc|#w@5h0-JW3{tn?efcgJei#ftAtYrl#0Mw|ZS^tW(^d_drW7CeFs)^?6w@hP!P
zNe{c6Icr}w9!$C*5lf?7Yh|Q%NLm{;5pPcg|6z^IIx!1Z>l3`6_f5^%w6?-9+Qscp
zmv-vYP@x%Iz;~0>2TRl8e}_D*NARk{acSyt_#e}*%dM=@k;&3%T9?s*oDy7!vQ^sq
z5$IL@Q|h?bvFwKF2u*NC9Q~!yI@v};KI&S3Ou@x?ZALe7teb{567hJ44|jvS8;XLe
zU+J5bO=N|ZGq>*m%|gObQ_a#*rpn6nlkEQEjk8*TfZPs0aBQ}K`{j0>^URqV(@8Oy
zJ9e8%x83A+h(O48Aw}l8?Yb|u3)r@N`3mU+-5=*TKc)W_HlNNa=>#nc*tZ|W%24>e
zjy^1on@+I$ysTk_@xdR+RF$8eX4<zM9B*8$H-RIdR9PmE{dRq^Ja?7A;}M&u{sL$1
z{n(7}<8Y=O0Ep%PaByr8)cF`w+kIG2D%HOHa4xX2^Ez8nt#q;B4;)Ph-55Wb_%AtP
z^J;etUJetvEvDG=Tk!;Bfuiia2Vz7zA3J!q?^d74?7bipxvr-no&A0AVKtEH7#;Gh
zW?S&|>E6RSjz+fAd<KE=wH8AaDH#xN9_(%poC9?G*xqMe_Plo)*gr_HL7=H!@51t1
z?G6MGMZi{+`gUh8vW|ek=JnEM?|pC0XL?Sv(fth3X|~;&lWlV7`_p8tk?nXk#^%+B
zhd+bt1NIiN8Lola#Ab7tUuLM8XZelG>pMu5-Q{$FGxEl0;_U3TN$dAAa5Qo|%^r_t
zIvuiQyK%Ob!dl-4Pq3f2yr15lMLZ3HUf0=r9-|kOx*wl9di?L>C_GKTbEoA;6Dj&0
zZ);N))9J?1;J%<Rl4{|H8=5%5X5ZU_kn<Vd%MTjD_lv4ZFE<R`9ut@DxlL~m1|U#w
zB3S;>5v1aBBGa-3$yf3T<XEe7e!hM$6|swFV(sv7$?`eZ=8o|Lw^P_y@pt+H-XKWo
zwfy;~j|<aU?~~?&dbS!v9a6~dTlc-t1Fufl>&=(2)~Mxw{M$4&TEWL6BoweL;=kEc
zhBwhB<=AE8W8uv42V)-j{$hd^@u>fM>*dI^&k2r!P5kic)fP}Wh*|UNJ9OizR3}@V
zw;w2~w)5zzBSVD31Nu33(?hAtYF~zkn^vsb@*<=Uzd2$D^^vr(Ix9EX_TQcFX=rPv
zzpKQMK;M2`fO-49U%_(2y6K$zHP@D-q&UN9csF)?fBG;I%QQMahhvW8ykvrOsaT<p
zeBEP2(}?M=zOA$HZZ%Do(%$}r%B<YSp69Rete$zX5gblmus^lO$j3}T_q>E#T1)1H
znJ(RChX+^Z<>364B|G4xGa6I(&5sU@r4LiGBYv4ayW86rtWxgK4e|+zxZCp(Z`Lhu
zm1@$`OBr?{BUin(T$=xvh}xL}U_x$z&c_J6^c%HA@zf{%PYYlPtL1V$|5L-8)SB_p
z#e8cYzN<UEfsvC5!uxWX;9PYW8Q2EUfd#66QFfUbH>(bAkE($HPb)ZA&IpCR;u{Jv
znHuMqM}p9ua^yrCG1_AbjkF7-U@5gj%7z1GVafU)7f8j1C&V+TX5d0b-1PRK*ox4}
z0_w3d6K>ldw6J90A$RJ=0Ds`uHG#?UR9IIU$zrP!QoF~hZm$Qc<>2(;Z~Ri1CaWe4
z-NF7VIumwfO)hzl2C^1d!)V6;;xpn3uYOdPUA>lOPc4XEbpqZ9bS+6OUEIB4mbFNx
zd9AlBG3ueo2off_ZoS3Fk1$vMhPb`_))1om_3-4gflWT(8<yW0IS7%uaj(d_r{R8&
zCGKr}rtAAhEDGVf?H-5)4y&cTWj_<c)kcdy_&`ABS_uNoG4LJ9%v4r!wtPIpnHD_w
z%c9f5HCF>Qw6C>-w}mnikq_t4@bfy#&@*|9H<4PSSyvS?$~l)FCj8Pik#qaNV{k90
z<~+Tba3~X}xaG8=m;3s<!Xo@Ea&r?V3>x~csJczXQLnKG-t0W8qraG!+}sAXrwSeP
z--{2p?Sag>V5^3&w;C<a+stcKAK;NNZ%@=Fd{hU-^fJgXd2IcP#HIzj$;>wfbGlz2
z&r3?fpk<_O!B^-xwEG{FfUkC3CN7^lAuP2=;}N3H2P49eBYJYqpDP7YOd8A^-Nq}>
z3U9~zU1BQ!mOuKm_URQ^0~UTuujR}yZgU23=BJm;$xv)`pYB!jY`f^-47`l3bT;OD
zkYq5ODrf?rM+e%t>eSHl@)@bI*MAN&+uQ-6i4=#&u=wr{<l2V9ug_^UI_$BCbc0hU
zb{>;z+g@h#2Qca^WiQxHr(3x|bWsE~0tbJy1)iZnI4|M8QC0CzLP*u2YxCvmZ6KC^
zO<it@Dl{q7=`ee&(eus({wfSEA+Yxxs8rOf)3w#^@g88wh0OD4g8*5LW{-UmVSWzx
zmkLuFJ+EI_8Md6?Kbxpv*>_zemi8QFXmD}O==;A^s4+oj`Ft1Rt~{nq39uf6u~i?J
z1*9{y+FcxRZnm1tXQB*lE{4ly*C0GcC=69L;$1P{Ir~f%RoHRueMgXtw=4S@=K2^I
z$%yH2>}sYhoQK7O+p-+A3J^l%CpgX=-UPSvdazSRv{TS!YJD*gPg1i6!Q$HA<US6-
z?e~el)LbOK$Mt06{#vt$R_=y5CS%h|uny?SwV3yf{7Wp$xD?4xG=6N5fP;${WfYi3
ze^5Ftu$lEz*kf9gH4(<{FBzTwkyFVR{}BF#r43!!!ki=hF>GMZ@N2ky4Fn_`)r)AP
z@M5Medk<6L4)dYdnD4jQ&vxU$VNuNWmHsVES*8!}dS7y7&Qy-u_^Y^eq}+WqPOXy4
zb=xt|mu7|p;!>kD5<Q3I4p2<@`-!`x3FdzEe0w$@&=2Tia)lIob(@m@13Y5J|NLc_
zgon4y_S3Loydq2sLp?SGc4FC1@7BpPmd5L7Ps{ipINd<ojCA5~;WeLlcak$$t7tst
zn0w72nn-_DfiP@%xmLh+um6L>Vjc=N7cBD^Wt?M+ap&b+zcWVbOl*mR?Hy>&InxOZ
zMEyZn_ChWvvO$87P7M5wYsl`hP)DxEz<G_Z`9OQIJibV`^U6w(t1%9R<-VBvrtkX)
zC4o#0@FJjRx==%5bQh!{n8a|p>3a?TesjylSy%1<3MB9c=f3M6tashCrSiN(r<7hY
zvpb%$+^<4&p-=olwp9lBq*S^tR8>(Qys*-_U)01PPQnbHW$1BP5rUeuJx-TqH@p#j
z^N!--7vh2_?R36vHZ1GCMBf8;4W}}evSxOCZjuzR_o^OC-!C!^S}f*1>zs`y6e=j6
zcJRENP>8&RBr~PnKQrlBz=>9BRIfr)q+x|jOPDCYR+ih@Iz9PwuLShR^S-cVPAUe%
z;-Q%B5t~1Z2EbB#9$607S|YMwPU0**?<a0O@7;VBe~3GU|4Ps65p)bh>ft8)+<t$q
zGPV1L?~8YhW#j4MHn+!M;Kou4cNs#V!{KSqLxcTK6xH0<%@w=Xy=sw8(1=1f0Ln4h
zHB<WHgYsU_ns%()UsXjwkr?JV%dz0ATL1e{v(3!1wM+NyQs}(hBdC@uKlixCy%Umg
zzrNYk1%85##_U*#`|V4lut?Me@k}(#XuD5qoeSTUv+ektXG1A|FrepQ!HU2Scrw@H
zu_N<LA=p|_T&vq1ZLgPUVOH3P#A6G&AgG0aay^A=cMzyOA1Y3-*`Nm~eH+USd&%~G
zRcHVielD^KW~&=$EQ1by+MI-8Qh>g;l<5#ht<P%y8UU`P>fapI`akDS=}_#@sS*=u
z;94^Sa=_#kZ>_KMXqmCPjv$Uk@;O#$Ub;Z2A5_I}6mlkzItJd79+>zvNAz{aVQ#|{
zf9)8aCH=+|loFh>yBmyA<byKgw@MsWlGhm-*`M4WZT6Gyx&tgPEJyKUzf4%Iw3GM8
z(7#X#<<dRgx9WMpGS#uhZ5J}VJIs5wY`zx;)(qvycXY}wJ9$)`FbnH;12t+<T(#10
zhD7Hmm(${}9ED-pQlIA!%V!2ipd3V%MS^f88hp1kxn8L0-5Hpp6nBW?@m{%T3JAcQ
z3b?oU6y2fx9gk!xTxj*+q}EdB?+jebCy2{4Ew9=)`?WLFfGQi&6(K~gr}X<4+TR5l
zD92TVd!I-JwZ0W7Bbq!W@$!H9k<#~=?kVTsP{>X(?L+6qxa%)Y$7N}O7e4%BQ<GSg
z&Pm`lS$`_r(fwwZNHcJYFQeXEwACxu{alyt=UgRR9T+)fOeSYKeu(vw@d!oj+_h&p
zz^OnZq$JUf3xfmq(_=61poH45-^hHbtGf}Pr0!r__97+gKd}LP+0iU)AEJI2a4(Dy
zKYVEXg|D{79;eTaa$2D^kjzM!Qg4iq_r(DvBij*Y%JR);w{L1;Vd3n|c!PYW;Tgq3
zwK3!F0;4o&a_pzWOcx2CQy&PRIoTpye@U?8H-(p~x7oUL510{Xas=-Hzq~E$;7shg
z#*${YA6(6S)Fv?S(8tOB`7x<9yJK%?#@{W-#@`3fJmN0Ox9M}Pr>i4!U!rk)g4cL$
z)%A!`tG|hu??H`@bVXw0>9R3D6y>*PyQ2FPjmFvrd{tE<r{nQ`o7l1XgABdKz~WqA
znmB!~Sr-6<{^LIVB3H#tG1NbWvroWc;OAct{|yLJt}9CP@9)FK;B}W~RYmOvo3+G3
zRaJwxVfRcCww}X3E8Y7cU&LMdBacMh7ev+uLorDOAEwT`De8)(@2<BUoP)Cb&b~iv
z%|LJFTf0WL#m*bNI%LM@mW1Ywp$a(E(o^?16Eeo7BK!8X+foA-!};U5PShkK%I=0G
z^g7B0*(71@d4S`)vfjSI(YRk##^J?r<rbPpxF$Z7n(<%uyqj7$l283FcM!Pz+Z1=b
zO4o)8pl`hnUj9IwEzJ5Gdk46Tq3}>a^*%oH{tKsTA3R-Rh2!cwcc1g2kaHkLr&(~=
z{ZPR@55u4vG9|*EMnmocz5Ed9Hxpx$x#}#Jg61;!EBzsZ1%5tQsV`codXol;kT-=E
zSY-gZzt0LpRke`usY;&B%6-5~dSPq|?|sdU7oSDfVQyh2smqKKZ0FZ9$NN24(kRWZ
za_I9=+?|{V&0bYp`bVG9P}EXDetg3(7X(xkGL)hIWHUs{LnH@9xKFTz=T!w?r^CN&
z{O099&i(GMIX~C011cU47ct8T;P`r?eQ)Lq^GDtmr<T{l4}Xu6)8=56U+GfEu#bPd
zRKiHcrKsQIib#h>es;Tw*q2>8I96Ex-z}ADoAw)jVr*YSyCzcmD`uhdZ(Nx70*VFL
z?VEC_HFFx7HChhkF`py)0P$=F&skcbVYkR=C(RJ(Q0qhP3cI{=%JF`zsnd}cb4moA
z<m`sfSXon`dx_*s-9DM=aD+Tj>6R8iCr}?}QS_U$nhGykm0(0N>gX4Op;N2VngV@N
zp98x%8ZQT9UBV$)=4^o(+~e8H(oej^>f?DCoPPmUpI$S5(IGnCdz$<;OcCdpj03}K
z9z2*k!JwTpd|)+PZMoKrz&gAYD<fWm4(lvwHpQPeE&rxlE#~{y#Xe({cC1d?B^N>T
zJNz)$nGV+N;S0gP09)9`?A{akztMe@0DYs9k4MWjcsNun`C_Pzyg9|>9C*K&C3e`S
z@h1O7w)gjnd;qlUP-NwhZ%f2l_Eg5GWw)LMn_i0j64ZCj^;`xEUBYUX=G3c`sTV_4
z>}kQv#Uu+bG^0JRRIt^xkxUn{-@b-SxW6sezFk=ByFvE~tdR_&*~JMr4={Wie(!py
zV0xdjhurl5k6LQ9x-#Z7370KPYeG~!?81tpOTZdJ*ILeq&bYU;`GxLVU{U8&sKrU@
zJg5gCWd1j*(Q=~DJ9m}h=S`cfi`o6MjOQ1OFffG&p)`f9pf{+#IL>yb51y6O!y>NK
zn#;J(e&=)a-FRwO@4PJzPum4ip<t_yeGfxHf=siW_iqCl5?!~k5d1K6eJ8O(RJpY_
z>zRQ|8S-4nWYmd~+9q<Y@0!%CpJRQ5k{E7=qsUQFlS^j`v;Lq6?mzRmQBZs3l(^L{
z-%NYj_6Bo1o6lPVdSnrFLR1s1=;Vq!O8m{w;uj9Cfa8)}7lo~Ru7)u9lm2^i#}&Xl
zc*k)DGCQnKz^0wo+@etT5}XXkYEpDFfMy_GOU~PmIz5Zpi(h`_&{`K1+$$#IFMY1K
z9n1Xs`8^MSWe=)zo7VQ-ygN|g-b^>o;^tpK4Y(>iNwKo>dRZ_4u5VqMyhdpB6cO32
zxgQK-Pf&;g2<(Yc#Y%AGfz1@f8p8tRHz|*zXZq&|r&K2M67YZv5?u2TO?&Q-k*;{6
zJs*Zg&mDKO5Ehpu;~jri2*uE-6fY9WhKcxmi9sjl<!!imdiAD-?rRJRgrDnlR$La{
z|2yqlq@p`dn2jwQub*24Pb5~3yL<0G`VBhqaGBwGZXxvbA+9^5Pz;GAl_MOaXh6;D
zl#TW3dV->i-ua*mL5N*@^nG36l3<7pIY&QbyknnYaA+!@WkCH<4M(jm_M4}9DRAZ6
zf_jYMbol4ke11ayB|B`v9n}6-_aQ_6?gIl)!OA48xGIlj)Uh(5e}v?9utKpWwn+01
zhPtC1aK7ejf5hShtN#w;>RF=0D@mvt@2=2#Qmc~2n8!zO#01r2`#NKbm>E!^3&0b0
zVSUvaFjH6VQm3>j0g9?zpZ%*iyG;qsvZ|{G{Wh>$GL?XdcD_7RWH{vXI9BBNp?<js
zDwXi)s;-k{Xyd_KsUaj{m!{3@(ymMUM~U(|94Q}E+aWvj%mFux_pcL4Nx&R_M`%+4
zPV-fv#d!ulu&A_!Z>Hv7*Z;Htb%jP#Rg&X?C+w^0OLN%FjV(kau0ldmAlOdnVu31i
zD2gD*X`c9YnJ~~)KGo@Pc5gr#^U_moVkO%x(%bTMpKg|X=}@2F8^ZqrDBKv7!J4`0
zqV*`@UF?j|y+9Dz<s(_fLgeM*>axUrCbB$;V8FcCZ1SFpsKjT}cR6lX4ID&>Q&ix}
zXT^T8p>{8Hu1{gntDi){>_5R6RB>=vxe}@#IS<S3ct%#4;a&R{>gf#7&R%~5DwYRx
z=&GNuWV3o)t>f`bC#}pIw@EfcZ7huc(q7o+Zm=J^E52&YbzV*v)SKAP_h&5bn89CE
zbg}ZXdd~R>fWDN|TUzZrdTqbgB9A7B`>&)~ct3^qR5LyVES?^cYX52$NaN6S?Y~no
z1w3z<$~Q_mjyL4;MG|t~j+lvmPjNVzO#rXEJ3+<258uePLD|85Z}3Pv_uW`Kz=4en
z<b#>cQ?AtJ9co;#(`EG<?<hr&Ec%B4FI@CX9Or@7S&(StG?$3UOT+KKcBvMpNWFa+
zrg5Uf#e~I4p9B8EVj~G8cq@<w07;4t9ZBV2H+V=K&4bAoxx;x90|0%FQ%S(QtB%<(
z8E-n+NIa>10zavfK79DVEHWF!F<hl`u8(Ob`()$ABC01fKSzq7XRroyBFLP1wF_m6
znz>YjwVO4`?k}o8E4iEs74^%K)p*J$u}-JzS-X5zl=-LheV;euYQK9m-e}2YG_heI
z3~Zh<8H+&KFyFiNxDa-4Ik`A7Ih^+*?~Zr(-vXYsR!y}=3rss`W;_;(!xX1q_ycOi
zH@pyOu{s!$ZY7GO<bq5VV}y=mNyRs?%LiXsVjtw^r1#7?ib3^R>?1`#D{R^T1Hrsc
zy?_Q2_AurBW~HE=R%Ab^nQ;UU-l`&E3w3WhdP7H+P8ZGwTpqZV()t8bkB*HSh1srv
zboPa9a<>0Gl^T7h+C4Xb?7FHl*G`;SyK#4tL(vy1y$f7#14CEzF>JpUgK(tBn9n`4
z>7(nP2A81OBh<Ja>#lc}?0NJVDc3D!!g;Npj{J6TdpQk=F;nY%A1Xt><!AT~m3J}M
zUqlURzrCylGt|7l#o0k_g`jVQ|88#}jZEqOk7IO1Gy<aU-{S=7W3}H4-Fqnd|M`w!
zdJW=*Kp~B40pFrk=xp_*F|~V3>3VLHU$8yzLF0y>&kR&|F_=eWgz8lC4fl59^5+{g
z_Y_;gUha1hzF_}%5y<zl(_s(d%WUSIghs;^){ngfAV({hj9J3!&X}H70>V~2CP_g@
z4H7D9X=|Npr=3e$dM<I`+GUil`OQo&kNeR$o`Cz68(T#7gXmQ<O7^vk8hXv?pH)Jv
zqm-(xd{(`7kC|--X))Gi$$d#2nxhkpT428V^B*A9g6hDzzr#dz%TAa34s5LyBO)N%
zTb;vzxC6WwXD9N$`N#s_3W@bD2^%O0nrQ|4+_OS*rn^XZd`}Jxcs)*LLphYZCrI?S
z27%GtGV+u=Ru9rY(?(^!b_&>|pd$Sf<blM9uP80h#j$(pD>>@Ht6>(kh|n6ea*(7J
zLqh)+pe^H;(y8t+<#};%@>xwS+m06&j?87Qs}}<rfw0X;I$)oRd_vja__(c{u@8*)
zv%LrAHW8mdgfiz20;%?;e-J2YW>l!TVWxM#zMpEFt>v6z-Y#T|0>^Lp{nn^|*3t4r
zBcP%djq_%Y&v)wOCUg-AxeO7J4TY%|m`;9a)f-}&W%X6xTJ3y^g+-e#yr@sG3h2EU
zjap75<%Vxj|AkaqEF4Jw$`seZuQfh!_l^C^3<cAU^I|}&qVW-(8xx8Od@D1;Neg1&
z93##8&}3r4Y)p6ov&<`$)xE1~)^ws)Iy_NfXx61WdZfzKBQaAG-TuAI!m@adX>u>6
za!azyskDngVzNleL;Z}`g<@ZF^b?p^i2);ZYW<dxVVxAZb49U(@w0Uo7;f!odOD*V
z=u)?P3dmj>)XH!edm<B9snTz{4GhbKna$!0YM9|y<?_B-Gw0q*ghBx)N0)(e&&_pd
z^q5XB<v9p+N(6I3{s#g)en-|Tjy_`rQr7CVb_JHRp}8LXpT5SmC!*T?M)H5tpjhuR
zXKSQL(`h#u`z}vlOd`E!P+Rx|xa|YgaPT*v0b3kVa9dKRDv-)%TF6?ja21I=qM?Sn
z`5G%{D<{VFNvlw|H0I8vjDGY(bt2Lwid=`g2rSV*W5AU%%sEQ>ZIR;j&)Lxq<!<p&
z)13|(&X(13^h+da5-vprh5Hs_#!-z`lU#P&A|y=GKM62sCI_MG1T0y(t+^L*un&G-
zEf@U-A!sTKZ61Y`>-!-z3tqo>0z;<_Y7UdfFx7&o@te3jbvidY?B8?Wm%>=0h&^=|
z3urUVVA%YRLst9%VE3)A+nYTaXw7I%{jFu2-OK-`0Bu_Dt9{M7jx%8+Rs5xZo9_)x
zuI2u31<`vJdyirdNQ@6nBKx}aIfQG=;7~DLe#IX5i(E98yCe{FM45)lKhv3KfNgw8
zXhl`Z3n%q1$L3hFoqjjJF^Wl3y2x>mEx8^3=*ur16#q>~!fRCYBpNvOD@oFcD&>32
z?MMFE?T%<A&mGo7-Z-N=3o>{l$9A8*X&9*re3H<!@Q<{G!!ykdC-kg`oF|eI{JQ*B
z?l8hqQ8tWxZku9%c|9E03N^ET=ytMO-7+*wo?z!yzDW4BQ^?=+HH(#;S`|mi;SCoO
z2Q_kw-Wg%)#Z+a@Q^}7Gu?VwQ9xqt)PUe0Hav@6@7>Np7Va>#xmZMfT5ly|Skv)+-
zR0-|1@ft=gKM^JgAHOD&2_p9?`8x;U!oXN)(s+gSQ*fJ)&LvM^&@na!qZ)Y}4E_dh
z-Pk5;V~H7*hkrC#I;T?-LsGpvtQ&wf7vqQIexwsuA&+pj=x!}1$21I1qt}IB9BF;E
z9-eg{A{yySxe0T6Gd=(QEXHg<@OI6+E*Fj+%3AI235UDGq1f~*0BuGD9A!Y}dvjIe
zO<_|Y3ngBZgK7=j*E`!@Jbky<&TBjNO2S%%=YfZ4_>+L^?(7wEnA%6NkE-9J5u$nD
zc1x-Sy<DF{IsDET49f2m3?G~}x8HBguY+oC5|n)EBDgsFd)~O%+FpMiAe6=V+)aqI
zUrv+K%cn*T7Vo@kTsPh&Gdmz@*iK9fxI;wrz+GW2g5x4_g9B=Xo!r4q*3xtBBkmVg
zaQx7Q-zIQ&K=kK!3M&!a=l@C|e+bF-O*0Cka(-D564sPX^J07Zb+6b<>G(Xq!_BS_
zU?Oy3fJ($SOCArN$YJm%DP-jHm`>K`E1SKWy~21nT0;9$##C0Vg7&;uq<Db~dU~hb
z-Omoo=++Vj)B;X7vsA_{>-^!~YFUc&B6ksNj8R_rEuV3z{WZ1!{$6+m@TD4TBK#{U
zDXo3qt7h}LI)dULhvvCL=k-zPCg>*T+po99wZ5eh`qlhKM>;j0N20)xP~viFDLdpp
zs$Tny!I&mIY;d&E9^Z(Ox_StlGF+4muxY#wvc;5x*0@J;;Z>3>Nz>wlXPr^!z|9&P
z-p3#1D#w=pDNBN<GxF8`_K)c#+a)WRE~@x}PkxaR{`8+*ZVo(e;T=MtBGSxX@adK3
zxea{SyX4>fEbD*%^;g)4APhRc+UJGHg*Wo@AU($f8vJsaP^oqCv{GVbsS#0M%Uo8y
zby`&-C3a!%9EM~HrKPbw2?mxI>3AhJNvRv{KLtsoOmRoDYQt5W0VFAGl1?i%`O)8i
zW+`dfq9@fhKA^_aZzonW7S12yT?%9i#Jl<p12B&x54HNVOHi?@gYn6bw*;<`pBg5u
zR>=h9o(0hYq7%r;D*XAOE*C7>T=>X(uODZN&ai2Sjm5kqlk%#<E$GYGwNO22?Xm*#
zR+ni&sYrW~Ml<=r{#hi%@2ArY6#qU^i~^FDI?^%uVklWw>kL0Qsl~BZQ=l=yS509j
zqNjW9A1M+{CN#+J%sC@ROtgE%<S9tDfrqA-ek@b3edpNbmemR5_HIt5lEO|y_-v}h
z-9Ge;i-y?jLPp18(&M#+qELl!$hSWX4ys=c#VDQ1<!Lz`hY}v!FRR>sFTnpab9uAp
zzm{^c@SB$gtqy%NkcV^22h>5aYcivE*pJK}V`>_jbCrls!U+?ekK=gagq|-R!e#oo
zZsXtO@mctt4o^y^;soD-H6;cNxs7Iha387o&nHzrEpI)G%t|^p+xS-Xv9<1!)?DH!
z5;l=9ORRG)P6Q}C40g3El~6irHvJ@(;gVB!0$y#?CC;_};=?9#C&v(U8Rg%yS=@D4
zMORL5UJCVjtiWqWyGzwn?l?=qyfh~@a#?Ku*8%}!!EhAdDU{<(N%I&RpN$vfJWirX
zMLEe-GRs|DZ&Wg=GXog<cAU;nbU`}Tt)&rUP~mszg+sAe1y+yR#@9ul(cl*$I-)E$
z7P1pftpNHWS~2e<BJ|w;#v;ZJuW8mG{r05U$8|1XGTa}MQc7+0Q}!5>eQoDe6qK+N
zJ>Hci4dg9#BSS`^Yh>5XDWmtLBZdn+M}l*=NLv<hmgzgdk$cI*^V(eyEFaTt4=mhC
zLU2d;FmpnrLpk7%Nk&R4Y4;~A7EvlBol5_UofaLCSGL|&pG1BsZdT?ehSQmV@555`
zT=_6!9sl;iN!5G|S(=NU_~fV0WD+R@bdg%+Ms;P~r<PjX^=|GZ9_H9XeSJj6fwD2?
z(lQ$GmeZ5^Mubt_AsI0pmANsQbc6B+#&ufPu^&D41FqL#VK)gs-U#LkQl1WF{8hq;
zl*wVEtVSl?6rdHyGTa?TvNN3g3a{W2aKLsJoD6L2od3C3hs<Z{Qs>kep%l)%w0vH&
zn;N@?tIbF+qs}pT=47{|*nqMS4I*!$DN>uGaY_C_bzO%&X@nuGSzc|i0Q=dly(1CL
z?i|16i(LuYHKq64X`=$P(c=RgE!>dqerN+^eXpF!6nLKGkQw2y-E0JPFX!e8m`|^n
zSD$Y#$h5>@rfYYYC1>6_kLW#1XzT_CASyaz8i;t@%t~O{hX`uA{s}+bbiI~7fdw=&
zm<Zj>rhv%_kE(1n-7CJuVO$z%VhJ~b-ku<RNy}CGUz9@m^J6}fWoLL9E({QH2VV8y
zeLFuh^1SN)GZ%QPLk?fqz{J;Y;M54*W{9XXZSrxjHMS(_U2pQ9>Eou0?9YDQ+(7`#
z9#|@aSLo#Nr?Lf*r1w^)CfDZdcIu+ShBJ(8X|>y&h<dsrhR(XGm`N~yzI=qj9{mN1
z_RQm(E9BJpbZ+gGPcMQh=LsXtB6arfQ!SgYg)?IMy(C7L&!}@QfBmjo{6RgCupLl@
zMwjN#2OF-OB@^pwX?($L%MN0#Hx&4R9fuu+Ko68b5=qZ)fqW)Xv5}y7<==E^ymQc9
zpzLGY2C)Cr0+<1l%;+5jpJpQ9f~na;kC956!<dObz+~g~`;gPLZ&MoYRpx(u0H)U;
z8u<P5_51hg9~@3laqJ@S!rdifncH-of;>EKs4pc>aElgZw>&~iL50U2?BKg_K{+cx
zfmDh<qI54O9kZQ(?^M<(6t4LPX~aU3v2f6Y3^{pspHLgJXl@AFweS&LUdftQD;j(p
zdnrjsNqJjR+A~AJ&LM*pY^&HXCic*W!A%W4*1J*aGYoSXdo9*5ekjMlykhCn=7;Jk
z%y68`vaoNq{Gk;ZHf!aHLv->*(I<F|L4x{PmTX%5GqL)`ZECUlYOcVjLJbI^+t=q<
zqY~U1r{>f2d>%W!yh^I0FStnx4_FM2WK?U(A?u_PC#W2*nzNkH`DIszC^Hf%;BN}p
ziPe#cEdOmp!Y)78ldzW8*3-UvQ+Y*wZ)%Rc&A9|kh4}M?Fz%SFCkztBT#;IEI!xg~
zm~^?Qo8Rnoc87iEDR-=rf)W$I#`)snudK`8o&j?>W{E2B25&E}uN%$_!M4bX!j_li
zrB$}^B;Ed%Bvw#HHs$?E<ozy)0<t;xR}hdR^mBb6lVVS$qG8nhjk^)HPa%`S_n(5#
z0iS^G5`lpOYuvdn6om?x$R6vd^}Bx&@p=ZopRQj^MIS>eV}O0Yw$DWND~<KpJeI#p
z7@ga~LehFequ)&-g;M&srFPFAQcLeiz*8|)XIWp9Q&S`t8R)L76S(504hoASh4hQ~
zZgeuvuZIiUJ{3e@_no*jD?s6{=BK6=J%60WxNdV@2YuCPBJ|~^orKQ&oERi5(gNXm
zXieftUSJV?n#wN2r+duSVnB^w+)3Ph&~x&~IhC0>gr*kq6r+G%cUza^yB6}I{>JjP
z1i~an0i)-hj41tX6#G1(B5sbU=UL%nDxMPrAAuZx%JVI#V4q98?N5!bl=K!`4Gukj
zzT?gAItQ*t<#+DgoeFD5T9-hcZl3uClaum2luisf%)nV=UYajvlJ`F*CU2<#r^_ld
z)H5GdX~Z2}9J;?4mQ4qoBW&^eNT#v>iB`6#irM`W%PkZTr?}1F5>n_%EsR_uO-7KK
zIC2K_yFGTc<2yspms7&L^B3D>s<X*@2j6e$9nUo>DTklY!w;8{kG1~9s7C!BEcmT%
zwYOV3VUPT6Rt3Ipx{T;>;K*Wu$b3IyExSJg6}}Qx%kz~<4HwDz5&ot+UU-wxUD^@G
z`l7&EKo4|jju4+L#}X)QY44SOZE0$a7qD-VFw5)ga6I%K#f*_tI%mDa3}I-f>!^33
zOE{o}9$7L|^mDK_+)CmXIweP>0h@YF(-Vd`tizMG6xl4T3?0ac+7-|+(Wt4MwoQr<
zv4}C@YvqCQ8J8CEfQ|PF2TMa3pLhhjXgx|9Oxb(X0d)Tw>mcz|&Wcp~rH8rStQCIX
z8VBn;w9+?N&B^uMis2bJdAQ}+0#DmFG&T#@+b$fdz?`1~axjDfWUw<d2cWI_p!pqW
zOomMKfL9w>yBv&2!mQSRK6<*%59p9vQ<KH?=C7PDXSGJUAD-`Yiuumev>i1Vybj0N
zbwIb0dD1sJ^7~P`BV>&9lNdbLmu&jq?7qK5VQqInjhv2XWMciEhbbVCFyRe^QG8ZS
z(KwWQI4nb3PZJV<_9U5d-Yh7VCl!S+*bH&Z8FJRI)W`gfH6D`B#VV}D5q|B)@_C&b
zX}&kI@`ALn>49VH4c>vVdJHuwAmx*~HEER8Mv6{vi~D6P|Fft#JMY)gg!1DWd*A1<
zT+lvGN@nSA3`7s;ax=Kg@|$Z&W}J=huQK2B!i^p9TilIqn?}#Y2WP-!UDGe&foYLv
z<{X13XhscA7?E^ZfHHe;dxg0hE%xtUW^^KRu5K4vGdh}uy5SEyQfk{@KnnlL=jOe)
zpA$N+y$x4ip1h$%-2*|7+W?jf)!YPI*U4d$;vsmQDc2XJu@FSy|6GSe;rE|xE8u?J
zby?&6pFnAS)F`mdRT(1Xd#ST>y;>L6fgTn|4w)oCk6K^Q{JVY{`-{Kzfrtj;e+@3Y
z+2JFZ*6em+tWc<Ts#+f^bliA*^`)@Oc)MHauJrm*5W7krm6!i1<P$%?%aQZ=n<y}b
z!*99O^UT&eP^)JK%jBQjPhNX&{yeQ<=YSXZjQMsLd@|aaEp~YG*P)nv<V2PBVHK6p
z2#&Nc=h{gX9E&+bZGd!e|DehNzj+w1(Q$+zd?MesPZoJHfwAG_3;ENR1@^x4FYt*Q
ziM)Z~albk-v3wZL9LO+D2Vu+9Tn5YWEcw%TPe_Xm$;hcoT)y=N3nR}$hw%V~mwcb`
zF3E}-VUM)$_Ow!99OZX;+g(g8B_Im$E8n`zHP&3ngxJj@W01`7z08ZBnqM0P0s&RD
zK1?>pff<#mFkxRYcXg;t;g3P;`Ho02#v%9By8MindZN%@;1ZDi7Sk2_**i3rMDT-@
zbaOEp3rSv{xYjFN0I}937RN}qg%G;!_0jq3RH<y4l}f3X&p+KtDs`>LVf?Os<d#ig
z`ZK&t95-{qZjMazVtt8sPh5*cSCLz*s&6Y9L43BW?_@GMZz-zE%N8Snq)}g!QyM>|
z91W}lf1Tz#pWL`^bq7ofQ4X-;XSKcrn@*$%-VVMMf~C{hl>FBbPhi<Ru1s5YJg=cd
z=sOhV=(q~a%=p@uP^hX<bPR=3diKu<F4nuAr@gtip=^eL+hzCetFu0Eb7Cde@eFz|
zZQ=CaXDB*5+8~h=tnJ6HY|d-bxgyt4FVs^Rk;kKwV~Q>?grQoG!~bp5cEcSrY=Gze
zkSTL^%#|ma+Qt9&Esn*Y`;cJUOF^<<RY?mRW$%9=BMd6u^3DNfV)^{;`vYRA(yfEs
zk_nz3&qq!B`;t6F3_u}X=rcG~Xj^m)MQ&I%4Sh_np>J2mc}`4bv*0>H|1|xW7KY$;
zq<m(=%e+R<*5JRl2O$c=55Cy$m&7rO4FW!oO!^+DLx6>R&R7A<Jt#%qcH0-`ezopA
zVe8KIZqdWa|DILrbI|dHa<&&b-_Qk_s)hQw_WTDCzMr$b<wxWxC@5T}ns@Q^>#m0m
zbOvCOZ}?H^-e**b0B`AaU3X`;?*o&eAw>6UPsILIItPHo-sjQ18$6J0O9A!Y@Zh;!
zrvJ1;>Hm7wV?RFZ@wR0D`dT1`_P!?IcLsgS`=J95Z<iu|UT=RqnNnDxC>}$P^FVrO
z*O}>z2K1ZgdTcASY&z}?D@@IH0(>ccVsOH{Ofea}Vo`u~H`Zk(FmiK!9+xOUi>VnN
zC(!?by&}2RV&_Qn^)7zX8G@0@weS0gI<vvuy?vM2?f!?(WG2?0Gy}LCvXZAhbw004
zo6(@OiFG9;$~BuP{!4nF-T}!^=yV+4(2u*bnup9q-ak=<9<nR`3A;;Fc{4M=VAV3s
zay}2c0UMpvTOMd8Y5}Vy?902ok=HfY9bZg)m3z=3aocpHhGlV|MyQ3b!kD?-wq(92
zAAeu<OPZTtF*g~Z&D3QfG$3PXk0=~}Kv{~oXI#{L;>E1IsjI(-^9kiU_*wTu?x>E!
z8WAt~O~u*V*OM=NC7(%6-(TS2oG|4!Sy`lcjE3~wvMPukk`k{njTbk|fOXi;;OkuS
z{|rp-ZhXZtg!!nC<n-ier>pEXse&?*KWGFv`IB2ijkKISmq~VNDrIh_#4b9hUDYnw
z>w+os2*{Llh*(^$8w=&EqY`EssUOIjN^@KCQ4Ae*eKBYLKpC$+C?$zm$aAsG$&Psf
zt1x=J;(uf-0-U>4D9q#*sW-pwR#no!pRcTGg=RCEm9@S{Q6-@ZSc0vfy{Wi6mw&09
zH{)T=g7v3+GQ>Vtn|#nR6wA?0oTW6^ZQi}6$MOI^)BR$#$!)3vpzC*=JkuSF_L`y5
zdGm6;GcWl)mR!OA<|?aU8S>Nv1VK4VNOhdu#uIQFDk$mJ`GBA;Zr`g0HcM*ZcqD)w
zZxGVIX<he7S4&8GA&h!ZR?}W|UoUw-Km?Gkz<V7^vH5ah94FEaxg8#XUa~W2s@iil
zKB1&(>ApjJG%TbE?T*z##%FvU77VtVZDnxWvNCe)3OG^?oc5S%{raX_Viip@_~i`x
z2BLEOrin_kU#HIPe2OgXHV&Yz1N!zxpVR$RUDqKHAo~LyHkNU=_jLOEorZtS+<y^e
zquY1n)$_i_XPHjHT%%eWl+Dc?QYUkNG7kdSdR*b9`dkm|tdIYDkxYnQ4o3FB*Vu8p
zZ0YIolrOv^gFa|>aN+W)%-y@E<_3^{rVZZURU9mb8+m*Gfzlpe446mwb?^-mhDBld
z@cvMm4arFDao}aqXA*ESiM)1X^9}u1MxO=*juxmJc!D^j@tb~Y6+ZvR+Uz9ZhrsMp
z%@|%rR4!-x$r*2;5lr_0|J<h)q4}eXl5bs*)2th_M0Cvja5H!}wHO)%xy@?GsrL1%
zT}?O|Y#kU8za5II{$kYkGPUr)6m|TIOD|CVh|dNRf+siS=wKo?(GvcY22}RD)Q>ve
z&HHR|o{lVLRl!EiPxFa{EOmNRjhvv+r32S7kaUNcjT%3ClrRM*Bhv`$=NwB-&3NEn
zS6yAx2N;C2vN4k-*!h~?p)y{VNVMfS{@=8l{AQ;~<9~IZS*u{*_KBZ~6SeQ6!--g|
zdX7e3wBS6TUE2AyQ6>|=b5{pDeR@4@bZK)8lhiZs@+W5U_#>oCwG}-&>Z5-#0YP0b
zqltVTHoj<o2?w<*qGK4f?x`Bzisa&s`+AA;O<iMa_I{+Enj?Ht2t|tKYyBK(f$npZ
zPovrm;S^^KzCKCu3z6FV>Zi(05oUbn6^^C-e#toVL%KG=uHvQs4|BP;9iv~eb1h|(
z4$G8k%4!%1enJ<zb68EV`NshVidcmQR3~#pm*d<C;;zL=j3MGU@xF~e#yAIQ^g2+a
zU8yEFoL(9B4^@6}ar96;^^f-(|M#isY;O-Qvfsx(a?fHH0ds>wL`b1Lqk5m}_&$n}
zbv+lmU_Zn4$vpJDfa7@BYXL%l`IWA_A^o>@y*vCF(Vmf!3!HJaj!T2AX)s%kX}EL?
zUj;QIOe5-bjsdxX`9}!hoxmIh0=i}NY<l5$2d>lkOzfiUu%UB~JA7LE!OAh1Y$ZJU
z1FhI2WOH0ogueOC5)K8xTf?cC7UZ{nyPAQe_g6xXQ(_8ChzrHGG^=KXu>1-vRi=)4
znyJc`iLqDb%Trz7f|s>S`bZG9Pd%qPB_6_g8P}H{cWeMWUkZHj9gw+Gk0b0YowYzQ
z81pV%K<MB^j(U}sLj`=EQKN-9_Je19G*WC|Sd>~gV6uZc@K)c=$+Qp>Q<GKB)keM*
zzu;LiYmOn?2kT=^6U>FPtSQ^yN>5eA{?P{e|9c0@&CCX{0%E=G$&Pc|h{g}qQ<Z88
zKkX+uEXW_77F3W2@OjlNa`jae9AsQZt{`h#*tN~_D2AmsVh?OOGVN)hKI%cp2Y!vA
ze_>HLks6s*u1L3Ianmg~`_bi_XLvjXXUXujvacSy>#+#`h@Cq4cJN=$YD-Uo(P`q)
zUtZGsF7I{w4>iKD;gjXE_&wwMsmZE&x6pOjc5I(_q^0nIrR}pgs=LX*8pZ7gKr@gy
zn+-pIFziTWO(!~?o()3UreRP~P|4`^71b<Gc3D<E1<SO{`&>_s>Id!iUw+{?eUjgO
zT#0(}Tn0MwylC_hNZJCTkBwAf*yri~MA>C(<7s@*v;6VGQr13kTE-|YT4AL9?ZzU_
zdujMPkElbwaE5~Y{L-$2twWn6W;pJz*zjdO0_^y-@_GrW6`F$oEX#*8KY!xmK+`la
znL0s7TM|3t$;crm^QCPQEW*TA`s9L-Ws)^(a`U{nr`jk&5sUT9g<iLmtj2<@h8<?q
zqORi?ZF9JAyTH#xERS=CdXLnvCM@#>P#?sSzt-uyLq~%3%m!1${HlT+v6CO;(GWE`
zRHp6f6^S|4^<fdNwAc^j`X7ifz4SgY#WhfW6l||oX=jY@a>`(;Fuy#4B(~<XJ$ZaM
zEoxN%0!!$z8~~ziUXi|DpU}k!y8SCTv#?OfF86Hx!$n6&QQ24$3spq8TRaWMC_YWA
zOXJ~7P+ViJ_MIqwrIo%ai|`1mSID6OmYtUJ{`Sh$w;)muX#XGYjv40e@Sb}u%obM@
zZT91r_0n8#@XRlP7oBqR_B2upde|>tNjlI^z$;jAlRlhga6b&;=yqEuY88x4<wc;g
zhW_tKJ#Y5!_iR0Gm(R>@Ew4b<H;h3Xjp_$E64R^{g{#b?*z}9c$7w<cunaX0*`ij7
zJ$WkDPSh_SMcnroZH0R@1d!X{bmT<uKKbR#-jL-OSYeZYwiOTE@?Ai-)(&$!<&tq)
zo5Rp!%g>%vfpoN+A{^^_jwB%Job|LO!z0gRJ<6>S_4jAyQt7{hHgc!bbeLYjzcE?m
z={<i=WzxanEmjv6FtF6fOcf=mNC=e>5@{L1H)Gi>f22Yyja7?%;ho+5f#pfNCmNIb
zWB1=#D=!U5_>DivE&FVSfrLOVrYU(yfe*MvOGPvE`p_#&R2U~#8NQ2M9JRFG_~T~(
zH%64U@JW+(<2bvyUtklt*Qr}MLC%Sls0KQfaDl$s=y)N1tn#TPOaaD(RuKNQ4L=R;
zGib@wConp@zmE_t(%3H|hasc*JBc~BP(j@+HYy|l>De0nVhb)>AYjRpDNd~|nKSD2
zOIOWC{CJmmllb%g!rgcRD|o1#^DqW#C8;)|_xdxncu}(Wn>n6&dnw|8oL*?Gc!3}5
z3+sae*c&;kIH`g=o+gZDiLjqKnLh;Nrsk#-)~cpP$vg)FAoIN;Eg<A*E8A&rnfLwy
z-9s7wCNVo8l$M2dSOtGC{eybQr?B}y@>?jGh>Sdc{4ttcTE|x*1l#0&ELIxG%t$ua
zO>{`!emgnT@<jW=#}uas+~NQF5R}=>`J=|~*17kw6^_pNMn&fbHyw=~%sxrT;E<^F
z3&pSK5bO6aMhaft^^Zu1vG(ZIm}EO?R+B8n+sZD|?%z~mzcjxDHY!DlX29VS^RMw5
z*HyyF=zQjML?E<?i#nxLFB?2jYb&KG3>9wwJcO2YLZL9iWOtuNh|p<zN@W~ir_&!V
z$)fcS`d67cRnvK&a&5|6<ufZHw0yqNQs8w9iw7uKxC}CzJpoapero+60Q^7$zk37I
zLOhleuq$5)T}#Hy$qeS24AvS*76x=@>*z-Xh|c;*X{;(Po>xMs3@<UvS7HRGHVJgx
zJC?@E1IAd`<C0M#d5T$hnI_AJkUqy1uC?Tp;NYY3;9>XVRD>c3RF7_Ju#{iS3oQ}2
zvsBjg5FfPabr;4m(jI&=<>B_5RWA*>JMWA>cG$#YgjJUKRr?5ax`~m$k_>C~x<ZV}
z*M}bde-DAv3K^3&Xak8MtsNPu*Q3HmL|p+oHr|1yk30!iP2iY7?8QBnMGC>;!$<z|
z?>@HWk!{eP<-calswejDdt(2A=Fb(&m%ig|*POKW#7tJ0e$uhX1+j;AJw{0RlhTXh
z`(x!reDbqjz44~oR1>d%^-HdN_9ckg8?o?o3EB@KXJZ+3(-UCQTVQIp%9!3MGUd=H
z6>wC)ONgeN-jhKXi=U-3bST8{b?HnF2BLDrDIF-C43CzOzoR#_PT0|JsW9>G52dGY
zKtziVxHz-v#`#$iXF`7dP88Dy<i(jaQs$@`dO-6$EDzqEhn1+K-p8D+=V3|9iMBgr
z={gn9{1TFf=(T&txeY7v5uNnZ5htuc(pp%=qNrtpJ9BNz=h0pNj2Q7TXA^{GS!7m9
zT#UXo>sfj=aBwD83GmOLVBf<l8?ly<Mb)Pp&nEL(K%WuLxDYyh)`Xr=NjzMJo}N~e
z%F$}?(%F(9lK>WW;OFOtP$X^C_ek-<EIw#e?JQ48*HS)JUN}ac-O!T{<obA+!!M7O
zWawfRs~T|}%`FSEEF#V=5$A|=tJLL^fp9ou@LE^45SKZ~HrIqZG0z4J{I_Bg!8UzR
z&|Kleq4sPlZ$Fbwl<ydZ<5)o@{T+Ysq#3~x1mi@kfJ$L%ditgx{rIL^?%cU&@BaM<
z7A;t~bm`)A&RX}1mppI&{CQ=(BI4x<M)#=(J`}rHej$YOKnKUaaovsAefOsQ2M?}X
zvHUf!eBs6CpDRTqx#kFQJSdOYrWspzAA2^0zK|0cG<_Z$SN;hXU1`jBvb*7j$QvME
zV}ft1o}j@n|HXv1TUA&BIwCNFgCD0`qzv5#|L{SY;Sh9+UaG@rxo&=(h3XiVFa-5+
zRm(!a@Rq?_$HL{Q-cB9Er)2@Uf#U!(d}EfZ(}qdVWBIm(%rCjbLt66TOr23>)#3ee
zM<g_YEL=zP83yWTh`JKFD>IO3lwg9bPzn#sIA+mR$+_8GPfZTLz#duonuZFe^eo(2
z6>VHLj%HX)kTdWxL11n4Tum5e=;kC-Ujy+cc!4~;K_`G!qSSERZlNM9;)d~?@|Za6
zk{3gK(5>28o|3L*I9F*tBI?|mPo6xGId{u~L>A^{mDOyz(y@zPL6V)#twxtSIq<Ow
zfgO2<ITDC27vo``4H)=uE&jm<12DGGRow}m%`u-xzgan3p@x#4(s29@ddw$biN8BT
z?(;9}LGO!V#D9q$X8mUCeuv)KTQiH2<e6xTv!TCcGsT{vbU(eD{Ge|1vjS6cvMgzb
zS-L_`c7XqC%x~eow@knQ8h3zfnH{YT0x>LSFvC}wO|f~}9x1cvTz=Q5rM->~wqtwV
z4xr@b#%nT1$JS(EtcM-Ap_t++d&}aMVS!oJ((oB(tq-h*JY1`+Kc9Av1S53Xq99>2
ze&d!_3Sj4`g5TPu2tz_AC74lrZPcCSBcMtkGiQ39-iWUJbBeB<u1?sjDKkSj^m&n5
zLP+UqxTl1XHNU!M0zd;;;ab7F{p8MxPMFUPBX{^=Rt2yU!XVV)BYEX;%BYiOmFx9k
zJyxbvF%!ztL`A_WbQ6<=IJX*Io=wrK9{TL9iYgHe3~T18lXX?v)AA=%>h3O2u2~5E
z6jKStq_mRXipLGdjaB%S<`=(Lr%G?`^J*b@H_4`}!Yd(aJjZ+S_<KU!f*xAT+}Mh!
z)c&WxCH2*$)KdEno#C}|Pn&um38lNG5Yfifdq!blixs2tu+;rn;xnrbQIR{uTUk^>
z$YPV#_s+3kPZbu-4AO65@UiyQv2c~`Xe*c2A2L7P@_XY^KX<lbpxs8KA*5U6>I(NR
zH-E~V*35V~XFki~2M}vL=Wt5$$pVi=YI36!!x|=s&YX|3jS*h*<Vwlxg8t@cT149>
ziO_azMGn4&A9HXQ<M?!`$u6$R3^p7xWjn6FLRerashApOwo@zpDg}A#U6tq+Lf*mc
z73XD|Rkz$LjIc_#iB$!I;~{#5#XPeBBfMD)&;`<>27}$X>vW7clmpuTg6qT>60d^Y
zDHwuW)zR7sH70G|{Z|g=-6@Vt0?cZtp%@cb4S?|gs{v34u$p0x8T=jhOWms@rMk!%
zju<oH8-U|8$X}JUcOh|Aj;fDRG6+TEoT>fAJ*K>OzUS6BQxsLUlE?%jexeW<bdY<2
z_KQ5?jTy<(ETxKgFTkOX&>^E*B{*1gPO(b;JG{z6k@%3D8qWB8WTqy?nKGiZt_qDI
z(WIhNeNs(ITr0?-llnk35B%gNO*isH^oU@9t|`L0<SAF~h!8xBu0~CbRC;7tkgiH5
zzH(^O#Z^LQN&0B4hYHtq3>;lL^VJtKTaB`}zKo69bnJj*q7K&;rJF4#d!*<YTH-v#
zl0`LKHX_3I(D)32X$hknnOGoG7KIR5Lm11nWD)$Aa|Fmt0X2ij%;M36;EZ$VK<J=n
zH`6%E5Jh}tuqQ2-IkqBsS1{j-XRL(GC>aJ;R6S@$>5MxNIw%#`<AwUNhfba^`dPz_
z@k)#cAkn-@5gMkew`AmM5^^*thlPbp(8HC6`WaZ!Z3>q13vxp!61clmn8gHZ2~*Oq
zj2&SH6Jo19xn(&FSc#8h=fNyiS!&4BRgqvRmMrDTCkPR4HM-o%{X^@&*0oMN9p*mp
zbFMV>oyEq$e{1oNwb`?w;-^6!b1HubMHxidRaN_#pqD<5hYlV~sF&n5d-YuMf+6(m
zNaoF*PspPCS{GN|p#G)T$;mRZMU0zOS#UNM#VwWt<<nZ#TlQ+x<z<-z9rCb<qiy2u
z2|iLwAx(<l2J!1W-SFZ3Y<Ew6V+aetn}=oM4B`V$nw5SXLZU0oFMdEmh=UL?3%cZC
zF|TLUj@<ykD~nbZiz`>*!I`CTW+<yWAMj5(6X(o~VeZ6@=I;1431RD{e6pW4GmwXs
zVc`@P61jB-fh<T!4~|WT;zw0nXy(%OJD6ZB0rn~vqD#j9RWyLl0Jv(fN+A`54LREs
z(xq%5{Om}`Rs=mVu!<YR(#z54RRQ#gspT*!5~oVkDT7ZQw2Lz)D`iME<IyWERY<<N
z{#ysZI&;G$p@dsj3w;@mi6=;XVubDZqE|uY1%PAbPa7)NQW+a>)pWbbrm?8m7>_i&
zOp#^^F#0bGSO8!GQD9+!GUz*k<AYd_Jd*YjJG0x_N=A2^Ejef>h5q^t<o9qFZ=H4~
zzD#e?(ZoSeyf{-%7{TeU**p)6@r(5La1_a2O)&rrH5Dl>9m+rG1y!Q>!CPqwvvH}V
zkS4`v2AMwpi1!Y{xa<J)YjprZaexsOFb5xUalt<d-0vp1<8Yxz9L8A65D;PpVw5bH
z;X-je{j_C*9$AHptS&vu-VzN8`s#2kIoz-vHFSWLWdHyW07*naR8*~-iep}$ExomO
zyN-!tYm@#uEWjsFA7vg^kdIh91|ANXJ>s|u-vl*j8B;*>qF<04J3uiFD20p~V|r$R
zX+>aJ7edq~qZUqa<0WibM`l6#ROp$B0eX0Ldjx`n(2-S0to)SjeO`p<P`HYMoU<+t
znquKtT3XK+(-^(lws7!0(SjOgw)X52g4(k+3HB4b1Mmzigbv`lDZD93H-VYl5Q+p&
z?UOL`Vu%mARXYol-L<^UU%HBVxb|d~wd1cGy$bw6S>>8ZZNXCfa{PG@n!~L|m&^S(
z!V`l`p)=1gctkB*%&>rSG2fU%dh++Q2E7}qq`IPZJ3V{C48rWHD!dAG>H6&J#Zw6S
zWo*rsfy+Lc$NzUe<UTUfT4j+7XyRfw44%@uq3modn~{k}MfaaL-pV<YZ*%m4lmfHZ
zGbhzXNbY1GFzY=U<@4m1O7o%v5@%&HQ|Ry|LASruesa!<2kB@JQwDPE^RU8ILfn`a
zjY6$%c23fC8D*M(icPjWtO}nPBl3|&hyw<;-T4+yO6FY--5%xH3QKe?UOhO?5|06E
z&39HaQhHbH+|ipMh%K=MT#C&igcp^CY^p$c1{TVH4)obuV^wZFn)P2i-lA7|Fq6@%
z@j$>5^P^W-xq}(}BDRE?0)@EM=yIpg90yNG^6bGjq3NDW8K#)mn=-vMUu<@m(`dZi
zZl)gK5o6aQr=}uc;9nY8-^`#1)P#P+(ZvA90SWnS0lQ0^d1r<ugG%Fm1(-g@2zP$z
zMGzhf=!^yi=C8*P#dX;>On<2sVGM$+5=oYjV1P!12-<8c9O0nZP~0w=>bnS{&{Qj-
zQ>tFD^v0CRz{(n6U}}t?ip8wcUX19K{yH8hS>X41LFbwmi?<%0ks@Tr#7SYK+l*+~
zgENtu5~u@eL<EiwjwY_o*urofu;>8h2|)yBL(&!I!O`ljQ3p)i8u0**={nq<=O;ad
z>IlWzCM9gF3y#Wey>-Nb;G;YBF~SGv!jh26sbgt?v6Qy;e2mn|=EEY^qDJ3e$2p_Q
zN4G6DWZ_9%s5mgoLbEk8i@md+tPJLgK{}bg@+dkBeu<K)Ms!J5NIhKCGJ(*+riX2V
z(COOleHNHF^F340_YATq{-+o<7Y6aCp-0bhxR`?*rC1N43Y2GHh3kfQAy~>XxV7?E
z?;uhJA51Vo>%V=3$?jUlra42N+}x`)x7<xULN!)|4@UT8b+3xT3AYr#2sg~6dAa4<
zV67oA8Dfkhbb(HC)=&cLC@|$7TNwKD*X=~1WMa;2i)GK7=-t>?k{N+o53C8yb|_5I
znnhz>a{fp!u~}y^@^~;Z->e<8&c-nD(bxApH-mXIX|@Ds#(o7Y_Oy<2Z9^=RP$3n|
z@V;oq0ZIEHbg5P5*D&#Rn4wQux~I|@k}#W|!s}%7(bpW)XKZmb=xz<eVh+gH7=v9Q
z&w%*ok2?>Gbzqe#l^WdstWv81<m}5cSV5((Wq*+nXw=ZP7IBVM){%Yw$%mlg#7PTp
zapqYj-A?7LS1cqnsvwQk8RoBV;Ci)T8kY?!oS(Etp9`W&2#20q*6xte-PG7&!TRZ8
zoodF_aF$e+pxRdmJMX;5XBkzZSE=i{;#Y}Y)q!@_VphFcBBfcCMz0bavjk69Dzj=#
zuo_qNDi<)$t-ABvm0_oj=bCCl3D6PR%|QDv!o0VJk^F=14P~)$Z|Kothc-hD!i-{h
zC1VE+|BC_Zp3yUbSqFtfS!^xigP6>=biIU(cQsFYF<o(=1VG1Aj9=G5$5RwO$}?i*
zmw8DiC5pqVL<8W(xtqvL-1zl-bPNkK=!2HApo|_L^ju`+4?tcS`?*L6ffBbe2xN(-
z_ViWerAtjBQ|Dn(4WkFArRP){14kqp#<1oU&Qn6X3St6B@Z}>IBZb;4vrqX6;ox`o
zEPN;vaH3s7FWoJf`^`jJk|Y)IB()G6{dDC1p$;|Z4x^$wxH?yh(jid41|1{y8~I1m
ziLo5XNl(c-04eQR_(%m98Ii=O$#P&)SZ~~0@})Lm;c9lEZ%y;fBP5hSCsCN4BPdhZ
zQe@VP>I3g8;jAiR#g47{IwvTw;u$#5mC&<t8Wso+E&)qRy8gR3`o_q`85x}tbMdU$
z;KBV`1;6$XDgz!oJXLf<NQAMcUx}&(8W?~2Rjx2;e=?6%#<n<vk20v<tg^Q08NDlw
zUO|{+#q_HJe-gX1!c1C-;SBfG;)yY)&;??mMpuSjoS~x<6l=8puE;#d6uP#OyKdEK
zvEM^0p;)M++n!MAL2zuL`sU&o!faJ@Ns87n?t@=cmPN{h^lqj`jtNuS@{A*`$WQZ;
zlBMfVrr~}WH<2_i^BtcM8$Z-d%n31PWWms}LZ13yW;a+R5I<9NY=A)>W)53e&Vs&$
zYel$8JuonJGK?As4b6E<VF@hWU2U;x3&|R8Z#P+z;DcFp7?z&b{rD8f!?O6qM;1WN
zsiYNUEJ!3#hRj^@z0^Els_^#6tQQ3&Hehx>b~+*06n9lY_kBQXMGAaB@tA{WcBjfQ
zvUZy>@yMgntv)6w%)knW(`{dlK7PUU3Nhbvp;z=Oi%AtpIAqCFD|(g3C(WwlN9O)~
zpg^Q7b=H!q7j&53#t+oTtfz^uSB@k1YJAZvL#1VaNel16+-e9aw30Qmb32upb=3)^
z3<$=*av8<|2obRyD9p+k8(`|+lL=;PPfLv97|ZRK(<4rI*^+nW=_<xX`z^wcwSOhX
zwvwi_r#?aWES0tr(l{3y4UlcS2<J!~G=0d1#y1LiIUq3$M5a=X<U4u*;+Hald$Ku3
zt<qDC9AyzvjHfD9vrM=m^tK$foSF5zI`<NR_>EwCkHnt@LKoT_vH{Vgky|m~+SVFI
zqG3%3lC~s9c?hm*T1^U9!W<FvL>`k4`kRtUdFJ_9Ba#{^O1DNZMyKV#LkG(ev~81f
zk-+J64qd7Q+Fn|84Aqx(@X^h4wS4vYJnGL!&@sXXlz!5Zqglt+n3s=7!>tKMG|xQW
z0rZ_+6|xX+X)1pTvn&k^ixqgY7J;^E39>#Yx)jKq9mbjl<{U&Y(*LX(YRp`7M)NN}
zx@)g@O{Ob}CvN3kk-%BOK&*I-u6WXN2=1p7Rhf1LgboH>jV~Cd>G{Up&bKn?fMi87
zDYP+Wn3}Venolv0=7CUvXdBEDh*nJvj0p-eumTcwixy!%D}*9#bd$%u9!<Z3Op(&t
zue_e+ZFy5nh;8@blP8Z_w0iStc?JJad~$6hQLoI^jP|iG_X^^&dEAKvRP8Bc7+wm>
zm#wZwatylf=O0?1YVnUiZWCFfQgOECv5Vg{7L|5}S`VNx!wl>ip2TpB#_hPs%*xBj
zDi$yQhCaDPbU!`9Wi9oaJQAE&qGw~FmB65HAPtt{v`3O|$VUFl%GuY=LZaYL)nR%o
zB)m#O_iEVIDx#(<&q}+5PLwdE0t}t8W#G{-$FX$B9W`k7w$+(<;shcFk?b40OlS14
z0NupfJS>;a?E1m4XDYg-D}R02$G&{bK3epl#xcb~h!xS2vhuV6vIL)yAzO46+XBa0
zRQ?q8exg?AxAm;0l?qA+P0|tVuZyyTf*^E=7Y>YH2#f{5OE*^-C8L~S9(u_$cPtPY
zcMdtYpOMS7Q<I^!+OO@1gkyue3@nuYd@%OtRU!0>UZwa*HDD&ISrxs4e7RG?<c(Ci
zsSeRAZx>1|2P=uhnbn=AF>XfURgHn{KHa)31sx%1Y{#(sqJ7lkfF9=Kj$Y+9f%$7g
zh32q}c{(>a_h;v=)P>yMFcV<hvPAw(pbs1)C70OGF&k{Zc<An?%LL2sOy1<eIF$yS
ze80~FcX`k}8;jCOi6R>dOiv(;Gv!1gj|<3Cu_T@TuI}Q34F=d-bf!;Svh-qaVyRM@
zS)$gPDu+Wo6grCmDUKH1t6>W_w2j158t~pBxY+>^!$*m3gq|E7Pl@e0Ws;&48Y!KO
z33D_dgRXHYI2z8Tr}Sj>SU6^?LFDzA^i~bDK8Dmr`9M<5sD`T_pD2AG<wwlr5W$r^
zto&Y!4-3?>=evw)yB0F!c|%2(<|~Jcd6g1WJ$mRobIP4@E>31EhGwo_0q80L`Xnso
z%?85Iie%&N3Z_Z{%qhcwrKN8@kBnDr9GQ(9<Ki<x8afqv1`p1nxUE&9J%ky8ybP?c
zIGv+Kn9mI(cVsg$c_pt`$-M%A^ky`JQ|C>a%?C2iZtp3K<dbTwfK})Z$|p+)wR#81
z&{dojX3|`4xu#dIr-~sa7?v+vU4=}yRK5F(DSD|rIs2OmLvHA*Mx|t1T_0EJNl;0d
z9iW0*D#MIz3MP;VGcx{FPJtN{cw}RVzvGZ!yU+LLXcgvc_06~d|Cs^}u1LHBpj9Eo
z&MZYw1RhtWa<B3kSJxGkac0&Zw!(;pO<bM_@09J$;?1CZMWB1embf4S2~Mwkon@K5
zc4|kJn`AW-Sw3joE?RVTvQM~VIcggKhSW(Y%&ShTKKf4kGU_ue6{TBvnh%l6r4tIK
zIM}`OmJmP1O!qFvN9RukMpj(~5}I&9SW(2zEM^fV{%gL4-LG8K^>gQ`F{3Fy%7OK*
z0|7P>pNtiExi+Ni%^3H{SSOe!8^~#rWkk$7NIM3o_7y@0u=H9udWHG=8LLx))_+rw
z7AAvJy&lbE^ePRta<3}FjP(vZ1nkT$tA)M{A<3|OXv&4eOe07rvq$&QBag`(`T|yv
zKX<C68ydrk8W=@F8(Y(mC)kXu1vCB~1Hf7T@0h}j2$gMb$3P(-*=!NY^pamSLnmoY
zqn$U6p17sV3>swwfY{lC_g8C?jiopEAso!#$rT>Y?$MDQ#U_k{Vvkx`lp-59l%;%s
z-Y=WZg=GFAu;^_$(!crpJOjUmt@E>(rklPim!E}CD6=WN{%~lI0*Lx8F5Ot0E)~J?
zfyQNGo*cmxjxHU<$eJe*F&9S%#|(NH$DI1|+lw|G#DV*asFR-HL!)DIL)hj4x^#uN
z=Qp8Chf+RKx}ty%kHjRGb1kSPZp~@UV~md){m{sQ);yxmLa0UY1+U05DbAJST0Wf-
zWTs%731w$E%DE|mOoMi4dFh{_B3siw#|i=~fQ)fVy0emiT#L+-|3_1_O=%p!`NO{w
zx+|x--g<H7;NCTyto8!;mSXIfA16%Bb<eYAnoltxqX6L&1nz2MhM`vmR<~RyEMkRF
zq@QjgS=XcKSGmF@c2{|!-@I*W7N3j;(=~G4w&c%B1@0euFpE`|4l0V&a>HV77~z)B
zs`ogS``&2%*Sgl#nGebtT@AXkh3=x7D!`hYJ&gn)D{eJYZFPNUVVqDyjrmaP$ueV7
z%+dyqLm0oAjn7^%e?Vt)HaUXXjdu|y=bpORSal;al>h(`07*naRO$x0Qx_gZ``}kN
z5IVUz<C9=QZa?lhxrxZeh^t~Wo6!`{&`D^a)AbJLZ84HD;lUAsXrB0}qEcuSFp$lW
zaUK>+j}B3*d*Y9Y7g&GiZ}xdD0mENdlQ;|AD{vO$!wef^Nee{T!`QSSd05zok13T~
z4&@#W;~J1?yiVd2Gmf(apZxCtMow$XO~OKAOOEv#`BO%HFU~}Z0Y27D9C~M^n3N2h
znQrwAz*!~0Ll1*rH5HSv;%dvYHv>;IO*R&8CboV$qY#tun8KJcu(0?-IV%@>MXypq
z6x~0wZdd|zxIG3L3&639UWN3Z9lc7xxT9B5`@tesDX6G?lOfh(7-i>Wi1{<Ht}-17
z0%D9idX-K$C|IGeZ(GHH{vkxVPaH#9Q(B}nR1*xt|LVZl8z=>q2XJfvGyaXUg&t6%
zx*4?rTQIxvaoJ>sHZmGT^1HX^xBd2h?u$CVRD<ygHoCuZdpwFTK5S2JQj&~HY`;t=
zI)MZEEieY2-|dZ(vy_x!=*wujM2i9z?kbXrAyBxa*tk`yXp|pk#_3~>W@of25WmSf
zqre!=;2`)={D`Z^#m3R1gM-t9py-J|zR{E$1|WPu*I@*wClIk<i7p-EIE3ivucPo*
zm?4Q0(mGTPjKp)9W9F(9`AX3`2$)ePvoxn2$#dZzFS=R+uQo8IrA)k?xsj0)r{E<<
zUr$aJup%)qXi}^)X0a-N%CP+KtigDl;7qh|5NoD2)1ea%zLf`P2~k{vyZR+dtxn(C
z>yCR82Ndf+ICy*<!F>9twGjeOE*G~o3<f@XpnC>Zw`h^~LW~vWsw-m$lfE9!y#jzr
z!sK--dxx6hLsq%Ye6l@_u^fFBG@C3%W~eAvB+d^@S%q)NW|eDt#j+*1VS-!Xa#n6;
zHHNs4pDa{>^*QSn!Z53{uCll!t7Df&D?zQNNyVmS3-@CeOR5axIoP7Ma;oy1ojF;C
zRQ_hmgvr_urB#vFC=&$+O82}WeS^SR@aDV{>Bf`Uf<<(iWUuxx=;xB5BCpq1OZlX>
zod=|H1Q^F<WQ6#}-ja8fpQ;m8P-@h`z+-t>x)XsvOh{;tLB96-e6Q205@N*+V`s(~
z`S6UqFi>%>zI<A*2OWVGW!Rqc1zC{LQtsLteY_Se;4FuUTgkRkX3$CLIWsO;GLh0|
z&N3d_qVzUS=gdkvbD<5<__BV2$|+k*f;V*AFu0RGz3NIKa(x=sqp@)Fh)`eJV+7$0
zEF}LN=(gD{Qv_DjTrWmw{Wk?O<q2ddh%uH?ua=_6b#QwRK4~amh1el_6=9dlDtE!d
z2)8a83%8qRS7p#OdR5N06mV>uqfjsF3X;Z_)0dJ4eGd<l(9tG~A^IdEP$w-2OUEUj
zBX;J_YG*>>IREv8x;@S4aaDeuprm)T)SN4o-7LDojIB{W<TZ-?bRILHK{B)WHwq~Q
zJimAcPiq1~0f){@b+nCWMoOj9NO*ER<8)cJ{s}!#hq9Ev@be#^5a>xjAoU`0D*!yD
z)Gea9GiID?dzBf(L2!r8{B%a>!y!K*OVD+W0C@5RNa>uP#l7g^Ff<~$bRZ+e`yib>
zN=KqN6b2Ea+oKG2P8J<;hYse6NW^kXx>;Z6@sT<*PA2IxKggylO9N_GVY)h3D_S2b
z@iFM$nnM`6J@WMw1N4B#0wWS1S?5$We|=uc$!XJ>PD*SEmZee4bS<{yj6nH?P}#aO
z<J3$Xm{*y7@|~swXbSL^*0(YU)x}pB@rN1;vVwtHf0#|z6K-_Dw?Y~#Co@)8bL}N-
zGFhMLifymqYBaSd;qh{x9T+Ns=pWK0=w@dxgfp<Bf=9OqSaiY93L|%9GjZ6(uZNhR
z_22%&WN^yciKdv48PSVRS{TWyyV;n0qJJCP;zCwkMS?!P!%SL;RhH>tF1IWot95{3
z`O;R>W$4>$=-6?^G&b)$bM~|Yh5XC(-d8`J9$*+DR8n2J3<0Pn&sZMyWlSsTcGhlO
z#%euXv$tvsRfAu(ER0G}_k^sR+O-mbq^~b=FmMK--acdUf{8O0yP1?iZX5TXO*537
zl*2*lB%9Kb#~No|x}h2e#+8TV%gz8My=9Poud2g{Z|RJVsOOHFyn*0GiApJC)N;?m
zBBK+kpFXS0-5h$=Ni+C@kTDRdgNZw{#x!CZWR@|T?&HI<9#Skq&GN*ee3USd!vI-m
zr1Ttj=ssM<w(UAbkK$GY%tMzJE_7qeh}290U5A_eU?AtHIV-`Op-NbkLQ}esE~MeI
zg(P@`mp>*|=qwMajU?W&fs%%GtdLSn9ODwsdgyWnR(O|;k?vy|t19wDTF$**I-Ch%
zaOR>{{r&%JVOl;omgtphQi2cW$eyTC7QO1kDj+6yU=;@J7z&9ogn0C-oMB8tPr$CX
z_4Zp^Fe1iSqgNhn&^yZ3qw(n{)SM}zNr-iAd@=-}S3VB<{&fV5{)++g<rZP3f3p^F
zod3Kk?I%=^PWFSmF3jAR+rnV-Q6Gbx+S%Ptx5X<OzfRNNtB3llSU`T|mN+UL2;Eci
zhLjs2aVCFVH|X+IEbbHX$**wwJ3mHBdCrkwjBeu|97uhO!qsjES(t;f7@axzaH#!c
zJ4b-h9UM(u``(QCMoNtZvcMQA@4Ed8oAR`o!s%!#ZVKmW8U&O(;y+}m0Wg*B9~dr?
z*eWyd*J0T>J*P==KqGSmY5h<cIqzx24O^=Q1jl;)_0uh4=-$zoA$gC$$04p6RSI+W
zj)E!&EfyFlJ;wp!qmOZ%4n@!!IgTE>JqsKhvg&Y(%$%}kC3t5m_-8RM)k1EpD@<wz
z%$39k@xk#7U}z;I_T#Rokc|V1wHh4U(=hXlwNZix_pW;u?mp3uFX)ni6%Am8TgqpJ
zkvp=Pn7m?uK_=)$J4(XYr1{i|UIEY;eJ?&a@?>zz4TMGiK4!UB&}~L|Z;A=#3FRc9
zgj*IwN3$El7(Z50J*!@)UK^Y-z`i$U!QV@*mvxo6C)tZmkFnTdSxIjtG6bN4B-I}B
z#f)6xkGl=W@dd7}^f+Lv-W2G{DO>ol&sL8lEb(^|SZRv|cgN~7!_f$yjfE(;WY*=9
zQsh{ebg?R6*3+4hMT4>d-}l`>FwW!aKuw)XhAhF!F(W6-gMs$3MXxP?4^<r_4~ybj
zL4@ud9kWSi>`X;#e>IecrF+RdbYJ}nnV2ldij}g;k%t-o>CVSw7rKz0hsC-JL#)Ld
zo4`o9RzY!TODtkJw8fxJ+TTm1vw)u#=gbK2OkoByGUFl#sD;6QaVC?n@)l!r{Vam?
z_!c&7;)r9De3n6R0IOTH2#Z*S+{Yp&gje!nDtZN(@}ykQ-b@IuB%6#nX+By09#-Ph
z^73F7pDZn6HF=Ux+qChd$X-^xyIDPY#Te_f-eH7ccHJI4%OIF}UnL3?;!!VpRly|6
zN7=8k8HrofT2%Y69}6Q(=Hq><F*~7KK#KL^P-9X^9^DN4IEiF+X`PiemwT(fuHn~7
z-1hy9k_G4xij`P6I8hRkxxf?!$yLlNLEVHT*rIV3p!2*TLnxtb(3?XPn>Um=zsx9I
zE0m**sqxZPM!8W8iR+BA$*^vj%BXVb+$h5JS%ME3bR2ymGE$$pbTUT5jOZv^bfLE)
z$A>mOP#;Af-B5(W1E#F-_6TmiH!}4v`a<Z;TZiHyJ_bIl#E10GUvtn}6nJ_~>nF9;
z&U%(LBET|7D$0kUJ{jGxD6;;H`W2lKEHYCJKA7S&^z$+27qu2L>5ZArymS$pGnWIs
zk}zk5A*&Dr&ys1F2JbIoc=hw)d1Yu#w#0JAI*8XP#R7bM?<^|@uwrV!B320bO6?X<
zv#zIN5H)-xtidEt7`g;>W>O$bido(!8xwykJ~Pxc$ql>kK`0@6x%KO2p<|OU_D-Rz
zLJ4yls1TqD@C_PsH@4)i9x|8d9Xqy?ygykTyENAi>P~@t#^Yi)NwAtFkROv`J?@3V
z08PxEd(5`ka8y>s<FT@~8nG@H_SB4IQJlA8I4Qz&;NceGMYy=l$XEI^beIYhnRGBY
z_!^PbFxq&KvA|h}8BsV3A`F=a6Mq}tvW<(8iq&D}2paeZhLW!03sMl_P#eA|qkbvV
zag7#;LSyG)4OIgWtdqmXJ9yqYGQ#54VMTl($j88;5+5;C!K;h`iBiQ|OlVtJW|B`-
zp1d9bkZ84OT_b!Hd*YRc!F7g&={#1=dlH#74lZI?7L+Gp1+T<bk}x}cd&poVj=n5Z
zRjPKpxYa;MJiFo4m=;QY+(O_Ctk46ZlS_a_tPt{bTPY`k`K9R1<d{JX+sy4zs;v&1
zK_AzO8ZL-l)!{P^ZsTEvwYbGP%UZ~;o>kAovl0}sWdt(o$1aymWDGTtBMcTV8z}BE
z?;PJi7)_TNSPnnzqJ<Q%w46d(c^pSIK_<`@@@KJU$QXm%+tZ_+D@hN#$(t<WHAc_l
z!01Tj)}vkS*p~JUL@oetMc~>qWbL|1QbRz~1r8SOEBz-W4LFWAoy1B&#93OO$H9RI
zQV88F+ub=5#un~7<VUiEK#36lb(h(=7&}HOqzdztDnis5$1qMu(0dwM>)W%@#i8d*
zZR+c6T!$3r++6wyAGEp)-y7irejHu8YhCJGEq@)tCt7DF`6RBQo}v(M5j)|Y5gBBS
zS^{Ti*$<=ZgR;OuaGi-;wXoZ+vqqKbB&?PM77otr7E8Z(c_#B5%S*CSp$fav6^u84
zfz>aua;oT|gBRG9ceMu(o*q-6<7nWZ`+M9&AOp+SzvwO}rVz|$g;1p1j16MqVnzl{
zmOQEbWep~I!eo4Tu%0j(oH}$WW-wUBs*^l~6&AC?2)BGzJ-V6QLCOy!+&V3GF^1W7
zd+;m(+4<r{FQ-lqnR}}x*-GD$#e%kKKvlD^{0z@sRG&0kho>NPd*4t2%i_SQ&7-bt
z>ZZ(8Xq^TBh(mhkQLCpcc4eSa6v#5cWHy%e8)YSoWM<Kl%kR?l*9n~*76h9Tz|s85
zn}ahJXX&Jv(8nwbs;U4mbRHHEA<BThu4IoC=f-rtiHQ#lI?sQJj%*uI;`g-lA@N{o
zeX-3p^K0l>^S8ic4;(uo^o;x<7N8R)F{vp+XQg~H<r%8>`tccQBazR=)NBgZY4HRf
zOEZBHQBB$-D`F4>PaYrhScv!n0|TGskn`O{gG|S3OiN~dtEOKP^vnnsSZL1Wot~C;
z-M?s)>TyFLI76#nElx9MDZN7jLEPJLh%RvqXIlBH+gG2I(B&(HMKC_~rToTd%UKsO
zQ~a1Dxjb@$aS29z-u3Evt}tz58JtR^S25wUHQ7%d)mRr+=x2omtTM(qmsKucZEhtD
zbH}u<kXdY#oKtnMBWJ9mmZ}jYG{iC`tld_qb@&AJ@&Eu307*naR1aik%8U~-7A?m3
zzbE%*;z<uZEzPn7^z#RMuJviJ6OW8#t&)V9ts70%Y`5Cdfw3#YA*0z?06;Pw$jLH5
zJXjwN&M)&kuZMcVBYYqmW(d@`N8->(f0zaEq4bR*kau8}06=pYMtL8)DG~c&))x=$
z64B9RWTcIOqhrWaiAEJ>mta#!zKJtZKt{@>^N53NmPez8BrX{q*-?WsV{0%ng;B|z
z>@9sSdMrU56Xd;0>0JLVo!}UtCvf!eA+KZk?uCFnM*a57eHHkKxe)8c0CgNE+G~v0
zQR5XI5j4le#{FM4Mc0ZjVO>6pMb~=6xc-tL`0My*mehn@5;}rGcV;@$|D;RwtwMCc
zb62YD>?-tST2b6-EQOOb9K7=yJh(g7_P98>qtz!H<Yr)X@Y6!qs-$0KgnQE0Q|VV(
z!c@t<f+{`A+KQ#+$=cFkB|fG+7~+$qMXVtY<cxpHa>9f-t8{hDWt9b}3im?YSQxkr
zb7w}~E*m^UOHQ0^pQ*~|PPzE*f+jlNoUDswZS{k341HPuyWOnf5EGcS&@-K?3J2-*
zvYrP~rRPGAX?hG3vZ`cb<v#VRbd%*a!3=kXmkj-MlRtV`c)ou(w3sqKYubR_SWG8U
z5EkeQ@vlt!Ad)#H8J2-pNan%vm?dYTe?Y{I@*;DxSF}!01zt$Zf}C4q(RDaT#SYN%
zV|gAHp}VR_lHC)ugwU{A*5c#CO8KClkI#}>1wN@+z}mL@@Cj+y9W`+dns2PVBd$xZ
z?qVvQ;;LU;AaSAS5)!iN@=0OxVOdNvW+p3=C&Nta0WaboTrIPkOqVWuI_`n$fiZpZ
zgPDPa@?QZ|(i=j(A;6sLRian5V9b7CZOG6~tsZ4ZuQK@LLv$8oN3YUQsHM6#8RItg
z=v8l?J$^h-$QfbVp;470G;E=V*pOVHlgvw2cc-pN=+}{)ru~vCeL^On^RJgw!E2*U
zB8%nMOkh?4^Fap=&<CWoD9cIxQivVJ?qUC_R>o-To_4Xg=}h@jnyk=A)r8^Nvvdi8
z-{e&}syJjoDe{~hq!}pcsw|mueJos1xLp#8EHR#w#n}%CF6l#+=faz^arDsblIbB~
z<ktd5=<+|5PHq*$LGWBUr>GJooj==$;#uEN*!1)?xTDE4eMY$b^}}X+z%}kfG?+yP
z#YgGfp@WmzA?gp^tN!{yI{5iCYtz7>U=IJZJcF)sva+5cZwtC>CZu6HB66g#eFv6)
z<1#klrsYtI2y_j=V`(FcQuV>MSksbGTRtnB5$??L&NzF9vcQb?mY9Vzv{xHHE=u&S
zY^nqo53H7?0bODg50+9hdgaI1(*Zy~N1lRUW?-SeQlIBKX0k%a-y)=TY$-k%V}jOy
z`$&Q{nB>V52`A?>$rC31@?hs4`K=`_bxJu!lRG+U5muNagji*nNk^#?+yX+EGlYnQ
z9&Y`*+(|se6zL!NZ1a~vw`N-4u^D;psv5bYL`yxO>MZ6^-ue9dd(4yx90!p9vvapp
ztcc|>lWo+-dYE6QTT4?^YC-Btg%EEyU#2=8WCcwyve59b5~VBu1j&UUuD>)dZ#EdI
zQ?JR@4BUURk55`Z&TOFu@{FxOv&>5mLFzoLGK1`E0EUOJvtTG=#(?0)2}BV7Dq@H(
zG|A7yGOZ<KIo_`&5}X-y;(H7FQ2N#Cv?gM#q&_q54dX5!1BWa=Vsq!^PxGF<J>n4`
zu78FZbB)F8Pz{Ghq#ZS8(Q`&TWJPqkOL6oWe5rX5c5TWYa1~C%A`6Uvl~7*{q;#P}
z!aRjDfU*@Yjbm2BkXp~P+4SDz9?w7mSYb6pe|#&rP$hZ=o#e5qcsT_9+F~(4tfYOJ
zNLI-j*gL3~FH8ofqE2Cw59YE;@JR!zBA*q;x#jT57~%NkE&(hI@`7T>?rFMuCx*FT
zE;N|SHpiYrb#n6~f_L>Y@4{yr#>wLe)>OCcDv$IOi{n0S^(5c+nETr*+$z-JkYmz}
zk+?t>XO_dQ{MH~GlUECkMguD@q##GK3Sq3&b>odf)6?djze&k0M{lB8bTE8)=0qH_
zO2BZtDQSn<a?0Iok!Xx4)TWCqWHegrxP$t1d`VaDh4KCpJWxWcrzRz!y~JJK7Fnj9
zL`O554+QxP3oSV%Ps?XmiBD3VM$hTC(tHx*mC>&}4q6^a>cnY_S~BQKn4S^t4#J2!
z`92`wouQ~-clMS{<ERA`nxXV?A4|uP&v&YyWQj!3lGZzxUj07>AsxWV&pSw7@Uz0m
z9obAwUdijx09GYQ^4Rq14q+3$S}%G9Ii6kC{?LPY`OI+i3Sul%anB60%coy72MRi9
za;p=-Dwi$G7_oq1F1uLA`-Gn&Rjk{~wb5(n3m<S8`fEIKE2wSQ`HVZ>!;aTe*e5%k
z5VTuu%+*i-Fji6M%5%w%dN5y=9#DSwu{t3u70JqNm*uxoe0Nz4D|COJ10_m+Q#=og
z6&@9%IM`VUK4~M@5VV6Uyik&dmGE5&_n-(NWisPGnb0|cX?)AjC3<UyE!etIXJwLQ
zUE|Eu825MsIM7p;{B>B64~Z0j@3bZ;jP=-Y7H<jlVqu{kwdHX10xrh2C%TxUVP{0l
zQ4>j#A#2NiJjJZsYm;$4F(x^}umUEuuCopVW7*!-Lp7c)D>E7<c;0DfsZuq9kv`_%
zIspUZ8Cc`l@l&W0sTp7NsuW^OFt<Y$B*E}fQ5`b+RT{mD@xclcw>b9-tFXcvA}MY$
zRu!XH<=hg`HTMb&80JEk5lJ@3!~r2ewiZAcbRYVXse_T~)lDMVA`rbnH?9SXM*5!C
z>6*3Q5X8KHUHIt(y=MKt9*>DpS1ooCz2%r?pG3|ye<sh;Yfs$q)#y6(^zIT!&DI{m
zWVCBEVz-+GnBR*3ZcK2;1pn}*(f!)*%`3(4|HGleLHf+(EFsi%aWha?o6>dJI)-9n
z27HMCg2(7129hrE_Q-5{iW8wr90@L#UnGejZNCUzO<+oI|1aViyc3E}MoB%$QC4AO
zMUX>c4IFyu3WmgZ_-RCvv#u;pDIy}s)`cXJ2QT%hMv@|N#`%cvTFO`nWA^tD6<rLb
zLnk-}`S5b!@FBT810;Nq@bSl$nAr6@bd5KK&PWRK3D9YY!5+2r0T4bhO=6aY!J!)?
zh~@}_RjLuEmIG?(&~!BDU|SlCS+Y$J%?O(gf%-tc)ktSzVCGV~xdH(4HPEH|SB!Rr
zK|u$y=7d+Oc8wOnNGYOkCB!J5uBZkD2pt54#Y-TwyZVFk$ptb4E1;y*!@J;`pB09x
zSC&Uzk9&P}B*7}($r6T<x!H?PLK4oV5+75Zps8eO5qk?G`9zybnN5@sVU_M<tqwxO
zz_FMWVHkkue6Pna1@^dNF3)&##{Sj0lomC;-gZ<);nS|8a(Y1RA@2Bi$0T(;-LD0G
zcQrHjv&XT9_8^h2R-$iY;Y;xw<^AdPr1%nTizV*uI^3mU<b<m0TV3jGtb!I<ek%pH
zW?hf+XJC3V22S%nWXUV>91w*o??|#>25VZ<W*pYh(_vVEZfd~v%}{1iczQ>Ub`6N*
zYYNd%XQcT&aL2`@6pTA!Y$1xg^2{7D{An!8#}+r4bj8Y~XPmOc0(8MK!UyvCw7Bur
zypTLl%qLKjMSIOljMotpD6C;}0-6R|U)&V6qbf;Qnh(oj6625u2*ytgiZA^RsiJ#l
zw=Bt`MWjUX?6Y0UA$S^&;ijOn^nBelyi_3?Yi|UPvgy6Idn&=)x(-0-La)G6RVLB<
zvzXL!Y^w07V(T5EPCfagd1ZABdkZ7^M4NM2VT2WAu<G4A=w?4ykJa%Iy)t-W0ndy}
z=+c`D!|CZ}$1?i-kog1b1ST+n;{s5^U@({-Hsu@uZ$Jtl>~=EobtwI3sJYN3zIL$T
z^qc`UtBOkNfC)@s0>=;Vu+;zud{LP*Z!R!~rX$OfZ`#UW(Gk_j`#O(lIAp2wurMzd
ziMNY6HT@;Dd05d?hlbhQ()|*7VXO|H)Vqy*M51+gE3CI9?IT0Qw#euM8GQl4cnVKf
zk^vdND=vNAK+uevTPT(!`kaV2adEjFdg#r@*w9H!AM_h3yEJVwLtMMme2UubSx%x?
zg@6Z-Oogs>3mBCJu=1iA2_}+J3^2i=UI44sG3SsDVbu8YVD6q6tMEbNKM_7Xf*l5*
zEQk%6mk);cWQsJS;W@$z{TIspqM&TECUj-a=o-<hNa(8l0QU6M)byeSbDMv28sB$-
zyo3o%U;@VvG%m+<`-)x@H9C0Y=z&8==gyrwY<@}~%nAMe9C|j&tc3V_;-NRqkHS`y
z^<)AQIL^UZPYyQg$-KFvNY<Rtdcr~<Ys<;QA~)o2oI0QOWnB;PVUfRll?OgPhHsy@
zC#=w~mQ6+-)>{(JhV^E`jQ>P9ur!mT7#M1Z1ZKSl?zvGg4nrD_GgQxV<go=}wm{*M
z1tVF5bkY=JafoaJRUjC^3Ojf)<<HXS6(j;!hOgUGlH8Rl6$MK{I}`dc$&dtcI#n8v
z!#JO;-uIUWk|Q5Am~67eYSu)rKrG#zxCOw&t;cBg$T+}|wRL-!#~ZzBQzC|qqd9kg
z%a<%zFn=ygU;-0(a>1d)Q+o~^o*w;{K9{wb6z+r9=Uo)9Gi`<ygW+gBSut5pCNO~~
zBOE?5y=VWSW<8ldcP?vlvq0^{#4^H=?79gZ=t{#znJfc|1Es4qisxY&bYJ}u9~p8W
z89+KyjLDOI6y44rk$gN^NJf2{7v|%GK|V(PA<cX8^Wn-0axmnv>8htANrpr-mWDN*
zMKnx@&BI6285uQINxCU$38CE=Wg$Ei1N!uRLYHC)&yi_*pd@EYsqjvVi__B`x({!^
zvFNKqJETg8<tR}L)MG@0VdmJic=!W{szr&j0KMp2kf~CI%W~rl6Ntgs16VP4F?$UA
zhI^vXD@cYhiX_Qk(?5E}*`z9@`Q!$kQk<#;u(Cru$2fZByQxH^9swQb64UW_6T7g2
zV%cUkdWC`iX7VhGUbTNuH}R{bi{>p_Fb^g$feAc$;o#w;`wtx*!eE*WyoZS-k1^7J
z1lE~3IBYz#$$Bz@2|Ve6uP2BDz&XC_<~zvbLT(-w^WGhV@#SH$Qa)M2@K8++K1q2H
zGel-JB!L=9SP3rvhZiA8oCWA3aL=*wmO>b&x6X?0J^7Bs1Y#jUW2f?gLk|kdz!gZ`
zM}D+o;NmJK<@7y>PoN46ywr;6SCwk_fUM|N7NkAu3el@PNuUOk97(WN^h)we+E72k
zC=jMoTODrFX=PbA*N$EV8toJaE0HbTS*#nqB5aNSX7bFBUh%_drj8zIewbOaa`D95
zoWKO0^w3Q66IU#rJ78@3sQ3;bF!4#F)GuV#>d?gwM*sj207*naRAF7?>&bBH=$yf1
zJ(<7+o)W;<lV%IiY$W&!0LGpLX%vEP9_<B$1#p8^v_21444I#<aSYInc!^6#COmw_
zhsF8u&-bP3wCO#V$tTJUUAj>Y%>ay53OX4&pSF2&tsl(rq<dXAZhi_GgXM_JfY^+u
zM1#USxIU<j*SB#raBs;~ivxm7y7~esc<*9zSX4d~Ai;w|+c>Ds0L{I!O91_CR<P)x
zV{jzjkmAh3r7ck$`nt9g@PI!9t6~7l&k7-bG{>KQRY{V(=y>1ma3<-~uhM*S16ci;
z5P2}pr(b*risZpAd@z&d^2xQbsxh6&@O8`N@^fO@b-Oam12L$Dp({v4uh6YIoSs^|
zaL)3@3t$2hn7~sB_Uu2j|Iic+MqwuRCvovIP5{U{!wkxBYRRIxll5c*6L_k@-u;IT
z9-f{v*SntB=V7Vk!#Ij4zDs8SkhP&2>tR?dN$4O?M%QLA2`j;8hLf<2|Ck{1r=-ip
zf+dSwg}^yhKHML?^V<nhE4T3Mld5PrOmvcTfQOxo(dHKiGG8ostJC)h%m8>YuzKV^
zjFD9U`iF6HVMd}?xw6bq^s1WrDo4SN2_Kw^wW(H22jlW~d=IfERFq9I>=?bultleZ
z+Wcg?c)=ukHGv5{6=B7ag-aLCW7DHw{@k@iWoC)wECOa_RO`ub>gbY%ljzk1Ch$~*
z<x3VWS}=F&=+V(1JR?Z?(u&fe2s*l9{i^1ri~4A@wD~X(AMn>lN(TVDKJt_q#vDE<
zLJ%JQ(3y^QXvwV~;$TWneqZ-$U_^{-Mr85$=~A}P2pV*GY89C3Mj|$n#*9+aMRaIj
z(@8EBa-5uXr6Mwdjsd!zGsWrP=3WuHDna0kNy{+kj1k<T+fgc%Q7txP=%a%t--=;~
zK4OGMj+JE7Jk>QzUkNaYUL6DQWMFkmzj80f{6>V#vCd4(k5`F%uvkG7$O&L&IMP{6
zGMcIq=<$aG%J~>vFv6tFzQTNR<iTP-2qk2TPnL=0vC4wr*fGYkWO2EHpIb@wt_;(>
zkp5B1&|AmKy;60ir=}Ln!&S={!2~8Sfu}0$*mLmk6oY{{zb1Y#jra^W0rkR869`*4
zf3luTU;<BR*tzH6(IJ~NXReG6s0D-vEKvU;A@?vWeOuP%DwX4t!Gs0*u*hFsgyC$e
z@L|czd9EVsEs2g=dU?6$PX%!1%A|rkB7Z87(xmPp$30ne(H9=20&fJz5U3T0c?3ne
zduJqE$HIJkLJLl=piJQLbF2u?ylhYgfn7aJ;8=m3fmJJd6|0vWz3L0m=oN~8Rialg
zLx8=a10@Y%vaReW7}}V(%8W&?usC`ZkPhobud-QXK`eR&#ZWhTRkx>#XLp8y=oNUQ
zSHtP40m8)FoWKO0;;?$fq5+J)LCXJhvo-0TqqHmu^lB5mnlqTJCli>!Qyo^VSkz`N
z4TaOqRDO+cV?b`62C@VdN8l{1TrE$D(W?d@2wmmAJlP%5?H9TvlVI-ug0UPOBQO`z
zK>aiyFU7>QU+UID*=?8Zln5yer%Up7o_&>{9wjLxmgM4`(}*%aqYe)@jqpL6XB9fT
z3fm+kKb_#rLkIskR+i8n920d!l*-Mb;?XZb0rM*O&#r>VnO1ThD4ajNk<5>f)lFc=
zU;xJea>u=^Lz~}7R;5~*Q!~OO4ON)bf*J1-R^n5o!8Fv0ULpBc%q?HA9-S@fDd`Rx
ze|KdVxsm=kJw3f*>3o>L1Sas5htX2Nrb1VBl*${-5?kWoWIdU{1SSBZcM0booti>B
zaYW!ut|Pj1DfLRopeJy$?uE8uEU;w^*Y^RY>+99ncU9sT*TB%}QHPR_BL?cAQ))VY
zqm4PIQ!y`&p7-5A#%sXyt{iwu4A6O8$9I<-MS}1dRh>!}D#3$e^rU%j2@Y<R6POKP
z1h6VP@YVg>ZoCR#2kQiN%sC@^CFWx<K3PMYad3OVONimPNryKO`$BpA27_0Eko{6*
zqEg5Ci1uIDhno-TzB!m}PA(UJv@V~auUc@-o9NZtIfI4s=fVUgFoCB$EHr&%bfjId
z^~AO(wlzs6wmq@UiEZ1qF)=!}C$^1=ZL9P3d+&GG>R-KjJ-yDUs#8__IkmSoi#-#v
zh_t4(rCkm$4E6aK=zB2Bm1ORSsh^^z4L31#2g2VV4+UFOYj{Y=a3(9s9S9EBZ@xNw
zbT^L{3J*N_0|7^cH+*=%)0T~z1Qs&Qpts8H^YIUt6FX$26kcA~`vNGNVeUBkEeUxo
z#!Jc1Hfb6K&SS!RAh=jgxG4u6k493_W6>XU0_iN^)$~)P?PVbipt0|g>-sQ+O?ocq
z{MXh4M!TK(0<}^<Siwf8`$T90%l)$_Dm!ZoE4q9KN3DLBUi9d<(hG@XX!FoU1|5p$
zf=D!P#=ggPh+_NjHtbCVyY3KN7(p-L#d&xw0K~*%<ZCp4a9etUazH=;mMjj5^njBF
z%C*-3n9={lH^%HN1MJ^Z+C$l3FYAh}tBB-3;xWHfcZR}6p$mC3+BipH`ofFTk$c|$
zbykwgx)EkGrO$cz#x&tyg+>=kvL!5Q3NYQ3$?=prusHrIYYICrzd@$BuVINR7Ke$9
z-}Zc*^X2*upK6vpG=y1uYPe6AUWqAbK!ok#h}zar2{&mz3szmXA5Kd5sex0ZZ)q1i
zcOPRV6{|&U`RMPNF!K&XKQ1v?G8D-$dY-6MCNv_;5h+!M2leqofw<M6v=GN>Hud%I
z5V@a9_3M#CZ*aCEW*feX06BbN!Dcr|x?}J^D}zl1vDgSJk;$TVvv*kh@4`ty3s))D
zhzTEGz%Ha#t)N~%AAYhS_a#euTFT^fwg^E9IC6eH|3$Fp(sZ6t61Cs~C>mx}Eh`Yq
zpQH+9HP@TEI)xpSR^}^8p4AumE1J4*9#^4N#6zhkX3Dd7_XnvAIr(q#UN-7vz6kcO
zoCu>K%*tCOssda@f9zB`$$B_@rX^T=j{QOi|4D5Z!ftSRFbtT#V12qMmf$0p=4Xfu
z>_9eP*xBkD1M6}ZD(;hck>;aCk|F#3fROY9UG-E(-Uu*GA2mqXXyhc7_)H<($4&|;
z9TcuJvq=w-q6=FJ0Z?rp{kMFOx<EdR&3flc2sY(16V3l*`-}i6gyWg)yu2e%T1$(m
z0&xqu{G(~ut?{L^uqpy##astCWaL1V{KcP4PJn@>3dOlMTtM(0L6sP@W>l>NX{ofF
z<ti;HK1}APsS;00@t4jmc@fDozrcyc518i^5{Fx-ic}4#+w%Ng$hhL+nt7Oh1dI$y
z5^&A^$8LnFf|ZG2wr{xcCb+YlpHVZdndcg*Y3MOxA$(h^C3fTzgSQd@uhtBeVxd3t
z*r}m$tX`=^{i}SZJR_8%AVK(p-{6AQTAynlFD)K>4ho<WhsEf2pndrc4PJXr@c+j)
z4mM-X1{1d2>zU|q#17LwbBjL{xq8d9-Ta0Z7YQj;lS6S&gpubfqyx#L<crWv{b_@M
z*VW@~z4KH?8IVK>MHYAV8x;q}f`h*AY`d$I>DEU@pvU8I5kv(*CSp!0ciU{m;)lPL
z(0xt7>wt$XVsuwlc`f+;eD2$5JdE{y9q#-aPn>zaNvL^Ts`(hK_xJ8pd&_xrp?E(y
zkE;v{qbVXOb3-FA4yEQzkD?1Q)CQK*_a|d;N;&0#+h|YLh$f2PRIt(lY`pgIu`H{P
zMSjw~`FfZjQM)Zpn0w7BDdIWxGXFQXMo3Q_o)omUYe<g6oPO3<^Yi~syfuWWhCUp$
zj)2)sdU}-TeXjp$so=O~84zm9V%dAmLlFG^SWG8x4iYW)MhUy_R>e`}a!w#A2<9YU
z23gmBZdKUd8s)v=7GS`2KVTALmlGH72Na5OTAM$>4pt}{O|ciVz*<h8p~bd)oSjP{
z&Eq0P{)=hpqRTRwRojGd(fE6;26g&IKo6uS{y?I<TbP2{8Z7}Q>_eCr);+uyce1mb
zC6%FWF+Eh%0!j1~JiT@MHo;92Sswq>TmV2GWKF)z1EONwB({a*q*ACII+iCvGjd%n
zUA-`vG05g(xvF{*tmDVYK^I&~+|<onD_(GDJky~an?jNRtDyYcbK4eVn&h~%|26{-
zHiNB?bm9}W(2vsdf8*c5uqp2bV^R7lH433gfcuOkNZ9_Gnn-}0TOc8KYkzNY8tZOR
zdKQKS61y_rKtu?=(S}^oQ2@_HDo-#p@A{dWOM;!D2V#`(c^(Z0bl#W$O}=ya6S>HG
zYPm$)r*;s1tk~}I-Gt+msa98r8~{J$4UowFHtnL1g|6$2-HR@abyJtQW*P?vNt!em
zH-s~cpeAD2Z8j6}c)%v3FSvaqU2~#VlUk;}NE;90_d~LBWdzFwU5*D8_u}=ut+?LF
zsi{nbRcslia-cfx)!}A#j$CCyGERY$@_E!8g}uM{6~ykF&sjzb(xZXlH%tlSxVynk
z8i`#Mx+nezSNrY1D9OXD`}zl>Uj19F(&(5qgM0I6s()|4Z8$dYItw8&0j?7G{qhTR
zg%HL*rf+<&(EU{g(}?nGiQRuFob}67uF21Y2tq7<8r-MLRfvjF{MF-ty%rhojUtc+
zhGwCLj<wt<#HIs&+k;F@NI?QdMzYFgp_lLBX#B*VNiS6{U22Dk-PpDX5=Fr{lxCH}
zII)NzNbnhcFgR6d95RpR*F7e5@4h5(Aykyg@Hm>%IECd5OROBHJ8SKs3bXk8xoj<q
zD|RE_)WOft-|DXcAVv3)?D?(gb>SgYYex(|(PwQJ{<i8V-2DI9BfQzk?90w)&fUUc
zJ*^f~;r;cgmiC1<Wxh7Imy?H{U`Ykt_CNRgMW@>PZ74@12DH^u*iieFhyQia`vh6i
z4=;J2K5oo<e7(X)lb%t-re$T}Q(jI@ddg44oBn&_L&3EO<Ay17V-n{OK@prRV(5|}
z@+|({Ool)nGJV5T`8J!A;%v%eVnDK*NQ6IFzOVxQuM$a$Y4oHJ6de~AGOn98rPpo=
zmx{;{q}ezlIN;Ce=8;XFGsNn`WBo>({TO7zU#nI}TyZiJPmu37mdlQ0B}Kz3-r#J|
z&JaDiNaWnu8;!SR3}%m&#}mN`947N}=D@>#-27_Ff+QBrDwXC8)l}+PUOr&4Muzwq
zRyVw3aY^g{)JGH`q-9AAuv|?5RcqKHvfsgwBj|2KzYAhf)M>fYYP32H@^mhsA8k{6
zpWyr&(jwt$PF4?tll$ipCK_Irb+QympC%_zx+a9tuCw@|!!mxz=kjv0Z0oJaXEZh-
zfIyP0#meqQc^@X^0i>XZ>C5&FE-1#&i90cWyZMDAc24nHFsK!R67Ssh09Jm280Aw^
z$H(JON5z&t;sZdU+t)?Mp5^N|A*Yn!<_ki{$(oxk#L-yZ8%gvNQsS#HMO4*X>FdIg
zs(R<|`adk-fi3j@L0Co-VWmVsgJ`OY4*!@9Tx~aK9z0j5-yn%6a7)Y<h;ahG<i~Of
z8ufG^wcTy2Z^6TCQdeOkb*l00oq&n2a8%_MsY?D}TRg3uqrdnInn+<$Or(m%uy+Q>
z7!9TJdK?V=TL#c$%`Vo!X7@WfrLOTX{wkF4C<i-=>d$ACGEn~CO``G|Dto2yIvf~)
zx?g`hxG5AkhnqhMj^m1u4Q=Bp!IxqP-di2!(Cr9D(GiH5rQa)ete)9%PrV&l{lnWm
zJv&KK&RQN_EG)@fTVzv+{=>n*cNxwC`zpn7Z;yiE$A4H5YRu)Wik-U&a^T^Q$R0s1
z@<zB~<5`(TsQF5?nSYr99m3BfDFnV8`($bsOT{o-I|Pu5ou9=TSKdK>c_u$senW@H
z4<!E1_}*|z>T-@17dIKu4v`}m&IlsJrc!)|Bj7c>%npv#K^P&;X>%Go8hOfb12xm!
ze`d^xkzwjhYEtf5u`|MU`*#z`FHSJC^S*Oe>wUK(7-{Fqh;}~O?-HLX3QAV#pfZH;
zcfR4uJz|5lR=};HF00kszSR@Kq$PUVFnVYzMyplixa*NTO2Zu>#ko#xX19EY0)A9{
z@G<;4<(+G}xG(!b#?hmn{6Q;ef*9-0SHsgR3v4JUnB}V=#q&+0QToW+8+@D{%Li9H
z!ek!$w(62_{Y``p5Va3scM()O&V(`Sc_5!um-q0iOZXOfh4ozt4Jok87;{a7-D@dZ
z8kspn8-r~Bv)@I9n>^aJNJEp6Cz#gA%b8n(8KsEs?KW_IuIk_FBM-kV;#?Ki-%PEM
zEW*+4zjeOE8{Qd&S;i`Q#Tv5$3fUX@R8hMskC<C<1m6Gbkp~<RsPpO$ZuQ;^VOYS=
z6dU2q`B)}EsNJ*Nwg1COZK;j1rsNv?c}EdD=g(G7ISIrv(B}{ao0<g-`D02rLkM0S
zpxb5g40ZxdVLT9qNgRYPEnF<{-4Rb1$DqpjqysbXd%MPpOM%PO$e-ZcT+HH$1{~tY
z$L^drM`;oMyV*>67&ZTIps8(M<u^JO|Cq@d!JCEC2oq@Eg3Az}_jo^;1b5aP?o_4{
zufFi)Ku6nN0C_&tBe#NKX@7R08mD<C)TiDED^I@VhXwRt2Icyw$&ZP&z*|Xx44rz6
z{?K~4<p*??pUK82h|GAJu?lKn_HSC(PfcI7Orn9>;NpTMu77=KTt9{sG(!}Z8eOOz
zCja#n7T+IFMRswweSrvf{I1r+e+vGzV9{*w*llFy|ANxcon-!;_V;=2eV@wLYt%k)
z>3aXn@A$ww*7ID0LIQ?gzuqh{w_Rl7<Zk@?x<Ub3?ScsYj%Pr6Ehn_r8lQ{j`b}1c
zcVRu=*F8J$%-36WSC~u7P{+0YpY(Y+?L!ElDwyBp;G|zvlGi_dR-4nDL|_{-!%gnm
zwn%{mdX<yUC4*3p-{O@5%Nm^EiJ0$){Z-CrHb@hT@O4Dd*Y)^{`g>RA5wkDQOp*6J
z2Kp=5{YzBk%GcOmW%myUHT%m<&+TDZenY7+@XEyCwV%=bbGP@a`Sl)h<J`Vu|C1Ov
z@BgyW>oC5)G?l;Me(`$W`@Y!wm1|&m^Xz{h>%Q}K6LlzC8mGXl%k`C|(fu#yu}ldp
zi?;VI<nZfFW2cB_im@!$XK%vbg+X>P+rIZ1!JyNK#e&6sx}f4Fs|ujo?nB#jKGq4m
z_uhUAOYc7LOux(eI{Nax_V-$0{z)%Qz8Ws@`Ix*?t1Jf+2B&B0z99h6VKZj9pNuXB
z21{Zy(|s|K&Jb8F=n9!@uu7-b;{p%4Oz92`bM*&Zd`S$lOn921UAQe3uc7^s(}js&
zPWiU`4RG)0L?4lO#$lz@KZT*cS_~YegZQTk;(=@_BkeHkfYT>fD<0^R4uQcF+dUP0
zE)mZk-KEiQR02^JNb)>)jhARc-J%gk%47Szavh@ts-yybOZ^s55okGmxA0fa<*OZC
zME@9qGo$%Sz9r+Z4W85(gvbP^DC||DL*W~&tHLm*bn#`3P$OvyU5+Dl$OT4KQ~b@E
zt8%&>Zg-P!o~t@_JYr{;zu@DFGMdV5%fZMH=HlTX^w&C?0lw{*<#)8)iezh}*mxbx
zY(Ga1_Z}uz_`D3|`#s{7#pP_z02kc9&cELN`M-7>XtDTX+Gw{K_V<21wqkAVg@Pf+
z$;mT=P{3-`@}<%%d>Hx7%1HfK4(ZC@#_tb#RAC$_o%s%efz(I@x!<QF{rK;rciN2B
z<|%t0mRHzcwtZoM|NQ-L1bffZk0<eNPG6g^H=7(6$gh1itkph2BA=jqduJwV*KtWi
z)Oh5uSBd5SKF91${V1FNB}Ww7@p%OUJOBthb$)%6t>pXt=ymxD)+sA1;}mFWjx4Cr
zZf77nu5q{fc#r>DxCWl-fL{L%9?hWmAK`y}eci`@&0GWby4uO}%iEuw4L(8q*LgeD
zO3Sez9`DbU9Y>^teu6>rg}+0;koRnPiO|07zuSc{IikgX6HkBn<@~Q61q}@%IgaPZ
z_y8&MdHh6ryEE!mc@(Xxcqa}q)ia6WrMxXq&@QzQ57X!2`Q1|bOtSYk*W|~v3Ged1
z-YlSiiBjfssEoNbVTyRg2P?((h9}{Gyv-f<Zt{04Z*D0@PIuknZQ3K<%*0id?{UPe
z^P(z@abaUok3|};>PcNRnjJNK0-1M)zml8vi5UEyQJu8Rq%qi2I$q6sp1mSq_c0A;
z3PJrP7s&klkRZ5EZXmIE;r_3|ZKuWlUy$H{?*@m){nU1tYuU$$|6?5JU07(o$LqZU
z|LLH;p1<stP8Jh8VW16-{L(@6jDw~H)+&FuJ+%HUes>Yq#iRKlWFGtMV8!uNZ0L`8
z0`88lKH)fKgN~P8;D-Bj<PpTz&2r}qm+R$3ZO2E)^^U?Rj)1K%hCJ{J#gCx<xv0$6
zV<{T&@}U9HNU`5?n7Ge#oukCb@!fj152o?iJzp`nuf(}IQG>95jl|)c;!t7)9`A`G
z7`Pmk$g3i}^>=wX#}Qp75w7(pN!(d;g_@p3pkoR|`M#XbMko@%)ZK+?aydapW}s2*
z$)JKv<BdQu7F!DSYBAe>#9HflV=z@DOAyIlAS!uFDeT)UI#x3yJ45?Aifx}Ua@{8X
zPa3WrtUBSHpk<M6I0aNg>PcR{m60AU#P#y>eJIo0EXE6`76S_Yiv0ZPK-n)7?1e~*
z9epe6_D~7as$X3P&k2iUACk?(Rk}z!74j+h??hAo;kGaF_cA+YAlxJ_L1tDS@skbl
zTFZSkn_@}rMbx2h{9OA@*P{-RZ`T#0JWf`e5X!IUuqb8PKUZE2_8vE|RrhOy6a+*>
zwpqb&e21h0Q}`Z-(fPh3{3xH{f?i*eg5H<zc3qdFb0Lv_?_oLsuW7cd@`Yjf_>1-X
zkRs0HLqdDcr4hleso-#9#fIn^LD{L3zv1z~n`Li(k3&jkzwHwF1=P@ymP@ZU?(@a`
z2#+hRGJ8+c!Ki%4&-E&R&A?Tx>MTSDfcngr6V)OC#FUrt>(>gJ2fj^$N1dvVlgvq+
zNdq$f2K_G>=XII8-RtMaYb6m4z5>ijh(K2G<Y0GG%4x_r$d!iyC(K&{8hBV9)Xk!I
z!x$#jPfqi$*-n_okuhKRf%-4lD;uus-)RK8sbHsTKQZh{j#%f)NT2?x6sUo2=);eY
zebNnoW_(PdSuCAyRym3R`2IO%*IOty4z0U;NaQ=e$JdG9JFpBR4MS2TAgByRzi(>v
zKA$ohtdJb%y1sP+hja?*Cv$lv>-j+~CGXB-_}M(~4zPosiC@rff{Ua*Z_#W2zoJE9
z#!~Dwa<^Z+&Cm&V8FJ5IAj<6P@!9`yJ2t!Za@F@!-reUgTkxgV@BMgjR~_4Cr{3b8
zd?Vj?>{Z_KeJ!02B>J-RmJIL_=v|!r(@b6KGi`?B^MSDAa~NF<%fSgsv!}mVi@yY)
zrXhYs?E&}Mo_Vh4ysy=S#D&o?(FV7@nbC@=tk~yzhjHcES%*|r*ew@V>v15J7-*uP
z61KgsQ9Qagf&T8^t@hV;6BpByX`MSG$0j>h)Ar^T7UmW`@7Zer9ES6aD%tZivm4Pp
z{d|Zw7fyuLS<7|g@@>V0KUGW_50mt4L?5TkZ^b*zdd2ouz>hx0sfo==v?k$et>m0B
zEO|K*^2CFcy`r<O#>IQvRt{eFg$3%Qy+_f>RtzG^wBuD9$p>ril6=vvHTLy5YfXv;
zVwqmsMD&5QDrw$o_kL3ytn`Z+&d-`WbpO#=)i2sA+oXmX{<5s5pW$47^GYN8ct$U{
z90QW;&QRgJJdhS)sF!2Gs*qCC`v#Qbv#_pqA+R!tjyY_q??V<N@PWxNTl?)^seT<}
zw;?J5#2iTaf@H!!f~B(I^e172W0ZW6qU5n1ujlJ89~67+Y+?rLZYCp(cP+L`F9C}0
za{Sub%82loq><vA^mJ9SQPB~E=bX0JOZ@du@{LJ*y`OI*aY4A~*|3?{PW9AJS|K6X
z-%Av3Tf_r}nZ>kaqT!PMmM?V;`lypwD%)yv5^wfWf5h-U-57iwu9;Q+%wTi|u5Dgd
zS)bW;9M7EP+iG*HKr&#x-1qDVdaefOo6ps3wbfWSfmL(wFhw%frK+Y2e0kM}1}xS4
zo*!EOY_{K!*?=h87_x|8$#-7u)4$wk&Uzf`intO-)kS#!uGxZYT{_4^D2+za{#_|#
z9gvdJ0*@|DqmE~xy;fM6o+i$4X3vp&bWEXs)X;!YFC+b-jlLt%BpvA&%d)?7YmlZP
zc2T<mj4G<fnl1k6#-K4^tT!T~HyJY`B9bk8zWz4%>`q0}o{)_>Mz2QOhMuPA(5;9N
ze4ir8Bn#$9{xJS21FM?DoI%4Yf?A^=S^w82>Tmnx;eqh?Z;#{c@{)@`UuFef&}oyh
zH338%<p%L-Q?mJ)JmlYFQ^&%FhZT<)X0cU>S6kn`iG9^}P_u0xrh*P(=;>fi&7V!d
zMOHUoC)}>K1%YkkaQHF8#t_rs8W0L}SHgoru8ZM#0~~W+K?gsfUOgYv1Y!X4@0gV>
z9o=T{SN!kDXT57>Fht`9zO4_n+02=DBl-O^{=l1sVM~{xEcrL*g2=X)>RW(fwymYn
zQpXhWjF!VL-oBytNUg69s4g9`x6`QkJo>WB=rwH~f*g(<A$~l1m}wm<BPQa~d|i~i
z4$k24ama64U=nm6cyH{f1-Nr-wD$DW_o;as@0*eDx_6Ytule2E4%F@BUrz2wXcSt)
zr@JDf249x$q&(}_0Zhc@TGUcwPoD6BR4KOQdryVKz36H8N&zr4hA71M5rj`FuzFkc
zf>5EeSWL}$yDNEo&R#_^w7Z=c)#;+Sc!f;WT$WS($^e45BXopSWs2Va!va(W@xYhp
z>qT(UtQqmfhu(=G_;fzUpQREv|F8%Gmb?1;-^cQSH%Y%6j|ARcCVtf;6I2q+mTer+
zPpii3yDUet1bnOkzP7rmwb;LRo7@eV6T|zwrJja{zOt}fZFS#Ya_SZ^R;sD!fOx@s
z%5#@H%<hTxJ=0uKMTHFL84lhzi8%a->09KjNdy)zz4qpkbfgSvN8>e_&s-iu%esDE
zHh%T+`TF|ESKTY{_NaK9fLZT0H2>P+pr$SVfiWEOvX?#dd+)KF9D3@_C$G}3D!`J%
z{<hNh9p&&?lFGo(Jlu_yxpL-+iGbHCW7)268ra?G$M3&(JA$|pR36U6YaudYM;K4Y
zN+EJub?vK;WGku1Z+W7j=ip>cw$WnexaTMt&{cb>)$JGEQ-LQ?K68o@M@hv_CzD7I
zCVMTJoIx$sj1{elLtt{9CuM9`kaU`we1&IfL`@pJ>U}FF|5>IgSuAHyzI8E#`9+)5
zZoqHQO=fH(xb#jdf^^C0$tZrw-;SxH$Rzt!p?S2XIXY=;d?9PrD42P0z%91@PeYD5
zgA}|a;=)`WH$XvC3$CVeX}c2dxMz)@^&~-QL&yy~#zu>vN#`hb#yP6=V}D+%l5yWe
z4m_>EbT!k6)i@gy8ccTd5cQniSRD`nkvd`m7X4k5blRaDqrJmgA>4v?MWS7<Bx6#@
ze##K3`T&E)dDrby*R|xsQq=c3jxkclO+A9J?*|xGvk9Jn3R?VXH%NNvcj6kuz&{n0
z4Tti|7GLY-rNd^rZqH*dN<d%RS0ye?3=I<B<ycFY?=~lmL!jQ>1}a7CT61rMc;mnx
zSx&B<sH?57xEi6icM;enoaNQ89Ww3YBpcl(lm~G#R#N>)#$S0{lG0CsO|NFZ-?6rS
z&Z&a9KZYJYr9)+@X-}3gw)|wucYz159hr6&Zs;5G7-&;7U?p;&6DI_fo!I*>R^FKJ
z^z&sDX8y^9LtG<C7F3w6P0sVJSjnFhmvLp+iv3nZ+>Lq0+{i02t9-VY-Ux`abAGJa
zzaoOkf6_XBaH-|2Nm3ZHg|Zym!}>$Ba1%fq{h%sFLpw{&Nbv~9c#K+$<EJ`H<#Lkm
z{sFstX1uj4>xe8zDB=|4RwMI#0iY-}bN4KXo-2iK_5jOx{Ts_XGxCow1&#RkO66MK
z9bM2WSUaSr_@>BIYwC*)r@R_zW!Roe_RmY!HO1!Q!4n_X-gOq!E5$s;$Dh(iEnZkz
z_9?sEX&YIe9zD1vDjT8~0I7U*4BkZ^>f*VOm*bPTa_zj!t#q(t-?hku_={s40pjkF
z!|$3`xn*6Aea!f`)WL8HFihq)n*dGzJlJ5gnMHcK0az2Kigz}#3JvhG(~|r{H`7Dq
z?jKQeovr|yDq-e)X`N^Mk!FBM#gowxKBOb`!~RAq?S=}G3=+bhR%F|8SnAuctwr5B
z^gADyss6A^H8mY|4O{MmOB}>R8#0mKoy#Sie;L%gza1!sFPG#f;F&MzKHLw{aD2!w
zJkd~DNXReCM%5f*l8W8e{xI;Rr5(b(Pz07n-2ziwi>p`se#k}|C!se!psKt-y}NEK
zl8iifUuYB-{eB)*vshh&#8e>{D@qLDvLMllJi4_11<c{-&U+jyk0$RAMISKW?XKJ{
z`oU%CCWlrO6xqQGrVAKPBs}lL3ULMOy(~o8>;N`_HkXGZhxvkZzR=5G-Kq$^#BBxT
zI@v5O4pPWyIyWU+b7{FSh7tH_?I9e^NSzZVXQ`b_RzWk%S^UfwFE7~;^lnS3*1Wvf
z%|vU)|FCiu&a^k<NFp#6E0LDEY^%&Exzbru&(`1g57i3vv81iOC7VEZnz<_vW1B<7
zHr>!R?l!&pX1=qvkpDcMZE6pp6_8K)?a%J~Nn6}T7WSSE;>x3xKc*1;vUEZ=8XXH!
z(UkgyaqaF^kuO~UG!WdwYz}q($&_@#H<S;JhFzY3Q2+cO<+0<0YZN@?95oXqMa%>z
zQ7+26=i9a_ue3kN6-lLemI|rTwH%|s<`Ge0ZHP9ex-?vr(MzgLEN?*DUY%jLU9~CL
z{G@?{{b(8f9UI-!aCN!aWP<;lzUut!-ttc!34ldV@r&?{1T~h<^)c2JDYi~&XLhua
zKn>k$PNeL@^$8AHe|!6L$s~KbGTL9L&O$o8u%z3_MEdY8cBylFgWvsV+q3nV>$>`B
z1Rc^5+)`7Ir)gD3AL`9sKLmTQs{IiMy&+?Gn1-F|@i8_wYJL{=a=9>+6Jd{{BXm(j
zReG)tz3@kjC3bo3d**6f6+iU5N-GEXx*w%4uMxFxuN7&MW-*-`YbKGR{BhNlZrBsX
z#@tKC_368cvTQcrpGm-|aklA!E!7xp-j!0uGE}Qf*g!`^n=W}&G1PSIBv+%M`A{sO
zg%WIY{3`hgR^X`4QEPZ=`cOPPm+0vF<p(=uFgcSay(hQ4Y6n^?&Y}5TK`{ifVmb$0
z;@>}#JsP!VSyodJV6tXIEi@mvL_DgZ=8U#ocDkAxqY_Rq<x-bA>FP_1!9QKf8`PH~
zr4qggBMonm)M8;BHCyS+waq>1E@Yu4+p*sU3EFyKK{BkiwZChXwc;=R==~iEfIv#U
zzIr<o)Y<vk538`QYW@5(@(L-O^X&(i>iu|D$6J`CxSHO#s&<R=OSp0maVXE4>~vH+
z%+OoHjttgDatkI2a&`{B{T8din;aJ$>hO&?)TAmz1x-0TYn<3`_<^KVOwft35xWVF
z$&_dcz0{=G7cn<FBxFn>aHI-~Hn5DOn=?4V)KN@NnNJ7uA}-#)YpGC_*=Bxd{DLVZ
z*d~j2rH`$LxTiv9%N<#4PnASs2)bFQZVO1z&D2jhf=?{9pdG^j>fg<-9}8@@7U&5_
zhrj80YicpCHvTdGJ3h`>$J$msk}yxC;g-qO<(dD!BJe&u%}n>b(tqw4K8OUFmXV1f
z0y7Kx{?scfcsN7{O$ryah{3}&MA+|cAR-(Dq;9-N?k=z9?=^oMkO@>F){je}J)zAV
z@YWb69bet<cnBcmVez4<4Qc8AFmmoKs+O>kdOmFC7&!DhOuWWo?PNLzoL3Y)pccBx
zeP)YkVOWoQKf+tC<RD*~^B|b`Q@-B6KU&0%;?L4bT3C@tB^aG-cq~?a*l&av=p)fx
z-j0AJtBq9c)c7BM@*7xF=PUtNJH7M}!I#;>w;uhgfNaj!UE7qofD<2dVN?p$(VP6F
zWORM<0Z8<--GB6a3YzBTFZR}`3?yser$VEi(zjCHKhDV;B$;<UWu$&UY88l>l3V%b
zc#(f8MMn$*+U@+si)z<YyUC^<$VNt=8H$gbiZvg{i#;QHlyv|;?UlE?oaZeU2*!7)
zkV;A}e~51Pq+dS^n-%SHw=2r0h@m$NDm93&b-tY~jiy256M5l$5G)z@b#@;6wfM6V
zSn2(GdI#flqp^7$OnXjKw;_QIf`qbi6?30WmGt3pn_wQz59$9NoX}32hYL5%mFSyd
z@#LV~bbai_GVY9yV2w0q)C%M<8cy{UBbY8leJfp$uwFR`MK%_5<5C7x6M1iH9N6aK
zRPx}FTAk8IwkZR|7&osHy$-iHqIRQGW2@Z67!@p)M3B{!VGOE1_pyd*WZ{BHz$Ebn
zJ)Xc{SI+aocTgVM8`S(VJ1jg8sa||N%Wi#TdHxQU<SOL2J1pIe$L?#RkUJusr~B4^
z+(!9-SZ&>_gntE*z$U4A961hN(qbr9;5dJSI0(VY)8zV>KUrRYft?fu0X8uo`L|e^
z(m)s?w#nYUzj3C3Wk}REhGlmcwt1`HFl4L_pS;wqJU<!6^Ky1lo;6gdz)Kua9_r&z
zy0rx^f9(xgTs4mjmMnNOw4P5}S5b)vyM=DrT02Kd&zFT!UA(oJ0#N5`Gyz?bNCJya
zqC9*L9c@HQ70z&(F=g?SBMG*TBAH7ja?O!>5k5?984HcxXw6rA;=-=3jMOfK4jayh
zV;~<<X(A^w@jzG05tZg<z({@nl(Pm`J;EV!jlG0q-`gp)%>W9LR1`cv_Ll;$uoA%L
z63P&Zai1vo`fO=6&{HE${&zCHwe)W^VN^(?gES(GFR#n{=UU)(vgnmf;tt}|1M?+x
zufh7QbSL<)itqZ{w{Rca<y!8KA9rC<-s*zQomYK;H+^|j$T5YGQN_GJgCA{Iu&o%_
zM)P%C(sGjsspCe;`mO2YzbP4T#uD{Lv0Sk4A@@1zoH+JFbvcvYQ@5lyuQc*VmYl~|
zBa(H*2s;ecpcVKTAgyrIok!@+mm;+dvc5e=l@1P?jrUc4QyGSweLky4IlK0)a5I4F
z*%d|&NsY9Xkh5_<h+Fq{2V^z$_JBX-Y?_PhBr)v}X?i{;?HKevDBdI263td`y!@0*
zX!CM?uA~<3<|(<HJ0pS=4uWjfI-`zU5QwSLXHX#l=tFz6n%*0C#N?u>BLw1hM9YRW
zdE$#e6#hEIhbGbta}VC}jM@nf_KeG@V)syiwe=Afmo!E8PagM+f(?-}3|WG8&BWzQ
zhN0~xB#lIi{zf{v{(VFwX1ZDl1=Q_v|6y30Z-Q3WV%<`&-Q;Y((!jxVvy6<Fh7`_t
zG25v+lYVIQMF8l$odo*=c#1rC{88F3YxJBei(MU>D3m>Zm)%nIY`zCu=Wl3$q+@<c
zZm%3W1(8T)?B@22n2Ny?Jyzo8)bV9j9%)g}^N}Ss!j|wFDM`{B6=JB{iBwtP&%5L0
zT3n19dGTb2BI+!|ATffbRst!J;3O515v1vtM=;KfHS-5kp-ZhDAJqFRrP`Lflw(#+
z9_{)g8^%bgSJT0v$>lO&HLot}{){Y5Ii33r3DW*pqKKxQK#)WDgBK}L{M-8hpWQDA
z-S%R;p3-q5PW0zWkDKJfmwqi9ub0bpm-jR+$@J+WL4E-&8B|T`YS+C`%28Ff+Di?i
zuUQLN?>(%BcSExu^Tcoe?U!|(&YqB1Vi*3$ET-i7IDux@;l>T~f#Fa>#kQJ}b_VE9
z>?TUspi#*6<e;DrDT<$h68I3-CPrI%i?OCSqDYo;#`o@(j?NHITijt_UB=$C0})A2
zfOAtCu>iF5)Vk^s78{9GNVKZdI!(rmvf{Cztp|By>p(`z%(O`c&FXIwn<XKxqkGE&
z1CmiNX<Fv8Zify4eQq+ED-Ey+=}Dx+9s-!NRA=%<x9}N{T77O#kq8|%g#bbo>+LB5
zm#zo_=HL#out$~?U!o;?5mZPxKJ3fL1HTk7_ouF#x(5Atdq13}N}N{z&0eh)zY;zC
zqS*5)_v(suZNeIBo!Jjb{^`tBb4XCm@HqM4((INCY4d{|fIY`@rWXAr_R|9cVb^`2
zA!r9Kn)o^=`=e7L1S%fe@mU2N!$K?~!u-0JQV<EzV(n#xR*sn1xRWL2|F8fTaz5@K
z`-9Kp^=Oh|p|BFuI<nMOiTBzAeoBi+_U;kBVt5C&uCKRuV``eH(as+6qeCNJZ$?Ov
z!VMWJ>qNfB=YPwtUynfEiLF*0PVD*>V7@hd#`3n<B8elu+2%$DyT_fzFSaE-f#%nN
z##XFuK!Lf;+0Z&vpzdK5vH&h01GIT>O8E_)uY+I%+upx8M<6tYOD&-*W4a+312<ww
zOL3*qPg8M6kC^R63EzJ9=h=RUF`?}tRgH;9sXxMmcks|PQYN*cS!nC+%JwuE2iwg)
zI8PlmC<2nA(wR3VFh3YcjrZ(HSY@@n+*V5;4z!0jiB-Q&;36>6G|<+x;9@b-J^*ZF
zu$)ieY46QdgIWnFz3*6mLqn!Mqfkh%G(@OS?j+5e!%Uv(t!zTMevlpO;%Igncoym_
zjVyzg=vN?KhMi#rku+F>&PzYoAQBK&3EQzHhkL7nW*)53B0JtXlXwgUcA^!js)D9E
z%M96p`#@2ox9mJ4x54;UO){pnen)e>Ljsg26>wm8$y6Jq=%(*8%H!0}EX&?+@*Tri
z%x?R&!J!kXPz6w)!+S76j+mbfo0R%8PdyyR6%+#7ZhxAAAN;L{fn8$N=11qgep7J@
zFImgQ&50B0U_eNKnL4a|8MzYK%4gKik}>*L@*PIV!Ou##v+W?*XL=d&rWl*ERGnvf
zPR`KMFY!o~XL>Rk)-Ie9Yfj7c9Wl$1q3q1yJEFm!E*hb5CdgZOMekcQL1?5Nu_zMm
z2=tMIf~_`b7nulg7x1t^M2YeMFif~UnwX<m4|VY(|H$%NWOV%jf#F^H!~xy3iwy(C
z1b@bUOE5nF67sVK@e0GqQ^!1qKmnCn2Quz8mlaKUC0fE>%)9%DXAm|RbU?S*2xA&Z
zT$PR;VmhV@Ip(J6eab`#s|*){kjlwOFGD~p_0aCBTmFYq-0c=Q7RDIXk<rjob?%k=
z9a6X!dH+lU*lEB$C>4gf=Qm^?viiLcdEUY{oRxJkmQYf9?4iFwCcc|L{46z=!(8R*
z=15Jc2Zf*9fJ{7LGprOSRk#|j2!p-<439P_y7{b`W39=gLqC&KC-$O<R;y5uVfqUV
zXU~QGcsVE)>xeZ)jGE!NOy&|@W$Y=@#TXo01<W-R_0=E^%7}96$}B<>fb3Lq<Z;p^
zBeu<lA?sKD7fXoOSk}I7k-mT{U#zR909B8bM~)<dn&wtoP(t$0!#5c+aWwn<7f*I&
zk!X;61qxj?1+ZUGp?d{!2Gg?2rmqg~0f*X8B1Gh7p#}WbX0!;r3_TZvP?c_~fOiXq
z`H1mbfb#1rjil>njA#0v<UfB2pQR>e22UGAI$*IabNaajs-SV?&pjW*j7pb;<~@;*
zN0pBx;RPMAvoo1crU8`Z<KZs(#9?iTXi15bv1ud!kzK*=F<#|<({&x&{HeT2hntNy
z1f1Bvimk(dM6kI*8KHOs<H{M>BYxRLpeqGWJA@As(WYl+xcR$u<aOYEnEIZYZm%te
z$`I&TtS>E*27ff3f`ibi(=0Sy8@I0U??6o2P6k2RC{I$YoFtz8@2LRn9>Su?Bs!Hz
zV3F#<QcjOZmH{>`6>N}4+=t^YkDNM@-~=!!p)Rn&9z*0DD2lF^$D}-ZZL8gd0Xq@%
zA#BS*Q1~Jv3<986<}wOs@t#mn#wZ6*(Y1$v5`Yp;BDMt`?otZjxIuRApAk=8MEgsI
z_-Jb~ozw)r*Zipf8trt$cywX#04np62~BWILfVPqd3?->B6)phQ0Dz-=mjQ8;C7??
zcpB2i0qZ!hH{$z4GlomriiF2WF7hAhzNSjQIuoA0EWV+$D4{Bx#uJ(b*X5^&Ms9=X
zrrJfi{jq2a`Uq|!wa1a)AvS6L4C>xrN~;Ea%d}Z1V9bFUAOswMu%0sOlPRjef~@rK
zKo}AZJ4;c$Bjb=LA#MG*nV|r^_b2=?DLjhl4@lujA!-I{w8(_~1B1BmeH9>woZRtC
z0aNfxgk$eu+b^Dqc_s@xmEpt^SdJBcgu!6*`33c)ortP<l=TZ1xiFk~orNNq!y!dN
zVrQTglV@_dH?REgDu`UZyFt`=cN8M90?$@m%5=6mA?TKmz=ljJ0d1u(plOk*x8%>O
zuVD*er3NgzrDkVxUb*4NULq<r1L;@-mlR?y1~!Ji91zu5_$u0GkPZATw{o`AK*<iF
z`uB~PB!Upe*(DOz$wNwsgvS!SiCE3LLP%Ryr&Dh$rHFJinYOl+)p=@%#5$_l_u|3k
zd1xm!zYy%B#3G-dd90v=?`R@AN2zItsj8CaXDM&cCH2CQbhRLgFz!S}@>h010(Oc}
z@qfRB3|=)wcDLSAF5-YrlW;k1mxWFSL-SxGs_!ItcBhyEmn?;o4F+Im+*XH3_y3I<
z$3lc;7?TnHrkl^lAi{LC2S0dvra=IgbnZtf6yty@G3$$VpJJhIk@K$49aQ>BKc1Jf
z0QI6zd7b=c<%cKx5z7(-qcSLYA0H%2ZK5EgYfB~&40hIce>k>%HfNLw<NP2omNZNf
z#_9>F(~DTrDjms5r2&RWQE!UqL^wQzO??HbD<D1M9{rZpfH3)eBX^q^c?^^h@o78g
zSZROm!ea4E;O1A&@B)qV^I(yK&Is5&wmaT>ksOGZvTIg}L4+?EP2;!l7wBYsgR%g~
zQNP-L21BKGli#1hK<s5JJdkveVs?XW#Npi~Q`kJ!9BdG}Rt-%fPDbNP#qF6!peJSq
zr9u+q(MQLc&isSTp&GzrAvp_k+&H|(bhfGS)+iX%7=pr}kSR_xJ9#Dl$N(;y)U*y-
zE3>pB_%@LixuYUw0^Ce47$%q{P(|hk>O)BoNvuR;x(nFEaY=Ckg|HUXWMjqD;txEZ
zkOk)`ZakvqWYu@GR9p>B+G(PGiV)KO78T^7D3nuo0sX4~uz^X&OTV|;ZWp0dwyJ-H
zN-^x1dF!UT&w^xhTE9OkLK3L+hmB?csWp_P95CN~_F}*s0apO!{GQ-Ys*l%hfQHAI
zu9LcBCNo&BF{zyRH@jqzluue@haO}mNMZ2E_vvgMK?cQvwgwS-ca?KCG3t;BH;>`2
zY6VR@#E5VwA{-ppM6sxV)X#}l3zS73wt)j_>LZaLrb%8oXe^__)wqc<FDD+#B2^Y-
zF*jGxGeIA|@MaA16}V{BG!BapMCF&yx{Rd$4erUT>5@Su9|!1~7jRyNRZl~u=W%}e
zNu>x&(H9*xZ#7PeJ+vjDV|Kl&l{3{~1WGdK3Ju^xNOf{gmE{S8uypHk;IfDb>A!zK
z6=S;Uq*;tjym>a{-pv=664SgfYKX?f=;F#iz?0iW4aY5lUB(<>c}3D9Yh7PO8iz6^
zS9&?DsBX{xc-i%%9E3${eZXo|H8nV+=y2REh5~slWMfqfiIf8AVRu8}5DAwNnqNM|
z#pBS}^6htljK&NqFxdu0+TM4}d?<hn>)$ht52v1&<77qHOao@IsPx0Xlyt@Xp7Uj*
zv2P@Pou>_z8r7d%QL+Z4umdPqE88G<%^(|ulO6Rm5_*e}URA!D-!(uCS<g-oSpVTV
z-~`OtdCm5N!Hf6=Yp?S#3_T(m)z}j)Ab{%6O|7F2cG5AF4z>{2luI7>H=aFXXq-tY
z$PBJ-yDOJOg`6w4=BJ_40)ZCkru!7Wbwd1j&PuEX6iu<>box_dh_G7wA-m`VcCe(R
zhESxOjQq3%zc$6$i`!MJ4{QJ1jIT2d<)hE`@5J0P(na%TF+&GTzGn6#fr_ccDmRWG
zmqd|CIzU!!K!r?%T1mlK&P(}=s_cN*SZtWr^@1`vh?5+0!yJ9oyzni1B;cj#p9(+j
zs+VE?HqDM?z#Trxv3w6AjX$E+KGd)|>GAq^EgS~lyMmD`jiO7Cw-+RZl0@v>Fn<h~
zD)nHbp*n10A_qCc1t|y3_(p2NYYsSVUsFv6lO0Trz+5s7wx`GPA^`ai4-mn{+6>Gl
z;oVbJ&7bN0$kTS^kJCE?ZSP22ee}ZIRvU896vZFmg;DYTjB7%gF+d8hqB0A%M+J7k
z9l#Xg`<LLAuBUyrf84}-m3L#PClu78$UuY>eGEb}OiBX&RZ*vS6cRW-*ArIz4V{mU
z&%$?hV;f-0ryKRBqCtQRc_6%o(At=V-U<yFL=pi-g$yzPN!N`cMM^I^_HJ|EhraTU
zyAcEKkc3H>n*jkAXG1g{O>D>35np_(wSWfR;8our0W(32{WSUdW0V5AHBC&tDXn;C
zJ0j}6dvcNf5;?24wL+{vsX>oLF6ba;!z2WG{vaYsS#L-`IEH>xRT49$8=OxuAq+BP
z4z>*;?50=pSZBP#Jy!lA*ob!DKw(~(y!s9EzY+Vuz<|lUQljR(?KT7HiNyeqz*k#}
z06SgKqlbUhhNFN?Y-Dhi_I26mL(Skv4DLtG0Ax>K_&%}=0T0KI282p&*VPp7+qr?m
z8y~-HgwOT0%~<SH&`V3JB6aC4Vv1*7|EY=%A>f%X^bEEHI$ijnQ$ZWf1#7&Ib^y&-
zV~{=v9xc^52?qCQM-{7!uua*wE5g2*2x9SYhjhRlh|Hi3;e(ysDluX1V4LD-Z4!E6
zVChScXcfq(19R%#>x+ciw?-?{e>D=bm~6D7R!O=arXa_d?kYM?s9&E6AXmupcv5>7
zd^q0neyX76`v~{%15VU-#*$F+J-m;QL^E|`H^Pqnp6+;o_BBa*YP1}KZww%<1aWH-
zDKj5O19}<-oR6w!me}yWf3KOrTpc#n36UDX=LGkrW+-(Tbsx9`SCl}#lXUjm->pf>
z#wurp%JkXa+FnE!Xczm12@Y==p<k~Y4Y3O-n{Fy|*wsC8d^qec^{<d6KOJt1k!r$7
zfKj&9+dAVo-#y-+>B+fWZk(EsfisqzA<`R(6YvuH5*XB}?b?l7vgY*p9LokF-o?$r
zMOk@;qR=gt`VxCJYdP)rhQ<Cn`h>hqD)DJ)KgoBg1qD&)cx{?&lq5jNlq;?T?cxhV
z|9*BgF4L{3T0HB3s6)fNkxU&TWPs1TD4Cc$GA>jY3zvg5HS9zyn^wUl_C->^ldjlz
zDOCQlHq;`0?&vABuCvrnYYFDIw}yM-jxUAP)ehTZYkS47dlN;wwU+%g9R06b6aZBO
zVS@LKXqVZ0oSuQtV{R!jNd%Y;QdarZC^^b@iQVGzG7{Gv#cJD|6LDpjs!TSA_ijZm
zI^@`Ig6a@)+W!)K;O{ObZX~&}2*rrq7Q<xdff{{H%D-3Ws|>$T7^KAfwBR8NrA!T3
zvqWeZ*eaILCT{-(Q2bI7sB&xkis0NsBSRGy&so1h4RL9glp3fYX{EKwCaQeDg}l9W
zxtzak$*w(}t3j|~)@i50i>9FaKP=!r<ns`Q=yjo2q4!@0siY#$;ik3W`!DeluakpD
zz!|sc#Uf{^eD>{aD(5Ea$Ld0D_o>B3%Qbt9R0?5R{MW~fbMkb%*UcPtJn!W^jNg6w
zdI!(y*VTiTq3OQ}xa<}im6@)q(#}Oso;gd9I?2n)f(BsAp&yGAh0t|;HJSNsqc?wU
zQe9Pj%lGSAf$I^y?%SC6)6hz@D8~Mn_hro~%GWM2>dln9MXCJ8-2B(P^>v=}X{_PF
zv%e?!(@fs|6o=pkp6+zK-<#~E@zlJ1E=q#lNS=#8$X2~GXO8oAus;Q?aYU<p64bA2
z&{eh?1V9Ir6_RQc@0F*==kQdR1@QPZy+D<i4ahgU5NT#6x8KOz(*r!}l+1IOj;OZ~
z@zv<=Lk#4BN>!+dnT5^qRI<6-@6GoDLzeeEGFuIU7Uq4O_V$PHrrPmh23e=gXdgQQ
z;f!2&<#1&O__nctWRmmzi7w^8v%61{IEc&wE)PS2!gSCz;rG%n+4v~gYtVENMf_p9
z7<nwR?|J6ABJlLm7#lm>h`Hc|E*uo{PkpSWJpggBggV$lF5M%{<Ax@YKzsoQOVpVZ
z`4f&{Bw8fZ@WTKi8s>E#<%>a*)HQm?kroy^M5ukC&%S?A&H;3Sq7diI;B+*TgD&S}
zF-ZSDRv<JiW~%sO*~fC)aBk=SQGpW;k1)gQJ%7ZwVf5a=L-m0c6&3aGS?7A{V?yw2
zqspQc1hOfb&*XmWd$Yl46kUAl^?70Te>um1K~d9n>d!R1%ml^4X?Jhnr$z41-Mi@N
z+KP(q=Rm=Pw!FvN3&47l-D9hu0BR&?ni?G+S7Y1d-S_kDfxz_vExXn3zj*5Tc=N97
z?djRwtMY#sKfi9Kq3^sHXneY)57z`f&*NLg4BggU&wM=iGxyAOYCLy!J(Q(p`Tc4$
z#9S{?36ITg0a}kcJGef7p3O1k@-B0-cX582%yv~TfSkfaGCqfW*Mn=ltNLMD$3BC_
zj$Ihl`a`{e=;Lz74_GDXezoa5_i7=AUu@sSwhz<#VW8*hyZ*aT;Qg*O9#~}-ef0G{
zlP{#$S{vh4psnY-uh<K`dY8tCzg{ZFUj)4y5y~0oyWjAPwrjsnr`G`BvlrNR{;Vlf
zu#KD8eD(AkB%QU(alJ)C)!5nQR}lEkFo<lmvM|$~<+*-9yaO>cSKQlfzqx8sZ3}!f
zPz+8yq+iMTaT@}<`J!ECxfa{{`O%(^&KBDHa<+j`+l6<~SQreW>jOOPbi4L^xK{DI
z^G7jTm!6OgA}NxJz>{mcwo}4JSbRVUuh+x~0XT*J#&U)XE!3qnfiHxi4CILF!;wK_
z3%JA<peQO}ijNeX{OAw(XSADg>L-rW0xsDiFd>}vYS(YPitG4d^gDdHW@oWQzN)@B
z-tU1^5GK+3#VGiy=gXZ<;Nv15We1@$K|8s{ZioBxu`HW|9?$=yer4y*Up5V(U2nBz
z6#PC>*Jw56<x2Cue*bm0T!MiZ7N6|^W~nCFY5Rjl00sC#y~Cu5NY0O|2y_M+aXp{-
zRXp6yw)r0tQY@#gH*HLm(fd=UKaw(9j^`<qMbFz&Q^|zJ--w6Y3KbH562@Gw?dGq~
zohl7|Cp!kuM9sIJ*Q<AwZNC=xnX9^P&@8TR<>CV|mxtxL_1DzQOy^Cdj$z-&!#%+F
zVcPlg{qbtCo}b2S!NTt?Jp8I&p;ughz<*N;*J&o_(ewB3#tr+PG!j@|KlaLk4!iXR
ztjdo^4Ff)-O~(~oH(=WWlU}FaLc?KIJg$IPZq2t|q2~6-G8AlVY`({t9h4YmItx9#
zM<t=9Z|@_7&WrJ&3IFfM7z*vC3u(5*{!eCKJ>B!@Y=>*<yU+FH@jkDay`qcx{;!vy
zGgnymwyakX?9p@YrC#y#-u>n{F`U@#OVmGX`Dk2rW}(zjRb5@r{eH{)Id#YRSpGPd
zV{F|}?i#3AUH>*x+^Z~ZRaY^-X^}5bUtNu7GxELGnyLNk%PzDyUEgDw_E`UZ`klCc
zIKw2qVN@Ct4Q}CrKfZcZ`yd~J2Cg4%Bhv&VU~LxkgHm&lLBxtDGGY!qHvD*0CsG{T
z0?nK=%-Rrc?tN?GAa83d;pD-Iu&t}XFjVT8wv`qOguCU-e_UxWt=PF+Q*33_puMjJ
zPMb7vMV~H_1rrKSzS&H7AY~hx>;Uh~=#AN6;)z&4-l~`sc#$4(KHr%2ct*C*G*s0I
zE6YQkKhCBxMu;G+5Nr^6Z3;RpHlA{S4<ys@8u+pi`?cDyKra%n(lF2j^xuRN`-71y
zqXtAp!GAp-8{~tM1&Y8OC)ZnW6*H0lKz#*{m_j59T43^UEHs$)P-SyM47b6EIS~@x
zq5&Z(3ehT{NvrV@pA(?f>L}E^efEkm60fvG&n7|42EJIeI`ni31&*!j^yRVY=j%0K
zkNcpmuBKI%&rggx$ZCbL_y4GR>!3K|Em%0XyE_C31b2rG79a!(!QI^n5Oi@39w0b`
z1a}X%xNC5CcUyGfP40K^SMU8vQMENYJM%kzy8HB*DPrg3JWK1RnRz}={DQhz@58Ae
z5ZrQmjF5+N*h>X!_TT>0Jwu?)l8-(hz1VR09vwc#78G;8#u>P_r9xWnF(C<MVRb+z
zN))o1Ei~$K!u>u2x*6WEad>3+T!na#K1}AnU-s=zZb07fwmUkc6=%xf(_C@ud&?AP
zjl|y98mj2+afV((b1Zf>oiv>vjC>s`2KVRiN_Z_Gz#<_D^))$4Fi&dm#;<RHhE}!R
z&6$2z&=ZO}mblK)w7e8Z{+Vl#N$p&UyP7-!xi{_`ClzKMlC`s>LAT<VIH74W&xxxe
zgE*789T%fakLba854Q9No85w<p7UDwC1r;M!gvD?iI)+h=e6?QUfDFO_R9yK$~JMo
z`zZcJ7G)c2boFp(<W27p1v$gQLc5t@WZbMbHd#guc#p&VADrVFg85JK%uB$&U!+yn
z*{rZQnC(@Fi*8!3Wl3Q8tK~2Kj!A3jV`Re6WdN<uH@hp|t%%*DH3(dQ6qa9x1z;h<
zAiN%|hh3S=4wUUhrkt#1>%l04mRr*7T%}u|`<vT0MxJj`HL6C{$TS2T7asr!gVSSL
z`@3HK=OpvA(7g3ZNoX@l-z$g3x*FW75%R;sL-L7a<NT3Jgy=(C9XE(U)z^b4lW?rp
zDfX*1RQ}T5bqNYB4dqGU4YG-%OAR*VNS{>ZTOC>&`nj0!7~&D%xtV;v@>*#ssz#EV
zbE?#l9~-+PS3BG!=`nbHmsK^teoaJgTJx7vPS%P}^_DQw2afgp%KKNe^%G+P7|jbg
zh>l`dy%J&5Usgydf>!8MYfObOE76$niLb5_SNH1Lty1D{U`@Bt_I_?{%}96Aey~R4
zA7<(i{(1bxo+bllzTF_BpW06qVl?GlAa=!5qy<22$u})~fuL5wn?XJeNANwIJaS}9
zcCpW5z0C@pqX$ri9NRb0VS_+{{@ZZ%8lKp;P6-rrE=kp-J7}N&uCaL&#gk7!KuQ#$
z#?{R18h|ehCzQCR)IQf*FSo;M4vVcPl`p;z?JfQ?rtY2XJc&&yUoQATtJQ9|J0w}K
zfl5;vY2W?ZICg_}5njdw`Cl5t#5*Y1r<|ao(?F>2TD$8BqB~<5Rg1^m%p3_ZVf>Gb
zAJv<hYHFAdmx00I9pv152}Ud8w;4!IDv#%>I4?UfBs7iGt?q}UrH_xdG!tQ7KG0Jw
z9QT9i>d*bqLxDOi@n+9YjWYxyp2xXl+#|qIhq?5P2d;Wv)Fd+c&C*7uEGeSztytm(
zyVP`i4e}bXOKKVTLfF~Mq7!>4^_9<jh$o96*76lfn{32mGTay=*IT5Io7<A%@Ab34
zOFA!C&fh<@oGI9QY*a;V^~X~4!%x$=gQcbOIX$o`!~%NyTv5DlkFh=0twtAPfGIak
zs@Ex%`d9mFh3_~w(wL~lP4D7o>}Fq1IpYd-eh44Axo_pG>~@@uWr@_;FZd4R&Lg&E
zwLmFFFXgL*&5gmNXx+GtvR6E>36HLqaL-^JP2%Tg_PA>k$yhlVv1hxS@Hgn_0@gdK
zWA!*Z`zvUVw<mtf-1O@8JCJcDgFoI>kt);-n8_|DVM@7%33utL&bn(7;*Ab*f4Is0
z@AHg&HOj`@f0RDoAM6<&tyGHi$^LwJ2y@zF55nRqZO{s%l(6S|dN%jynl4k>yQbvv
z=ty7+Ecu<~cHw39w0TO?SwC*nH0^xvB`$|a0S}RMe)$U3I?M*9`B43XFa77&pC?r7
z90;z6vYs~z4<{{HXW8Pw98md{#LzI|NZL%*KEL<Q94Dr7&BX7h3IowrH;8V`BbfeF
z-<Ay1xs)B+R4NQ)d`Svc<3xN+IUTs}NaScitq!=&h*^)4@R#XY;qtoY=<-tcS4XEi
zOy&-J!2H>dNj~rN5S}xdCVGYg_A|ZB_6x_>=qP;__qhdK7J^r<fqd6S-oyQF&OhrT
zT83b!%ko=gQqSce*<lHo?`c&xa+b(NNb|!(&eNK7eZ4!V=>b@%LJ92;KNCNBvdi&5
z)eutBt9k<z0H+s!@6N8@065FK0rn7Qi28pKe`?=IS6l^JsVEIQr$1ZIt8LA}N~F9-
z{*wz<40Bm{p|TGS-5$rdSJMG5mwu4v&y~~$POYarL9}E=N=i=_m5VGqqULB8=ehn2
z?PDt|w=Wd{DqS1VLq#7>H5vzRBsc!uUi{1yOCbpTG2VXnkZtt*47?XsW#7b`-Qg6D
z*7MM<)pFaxTt{wPm$N>+d4@RqbB~wN<C8hQQ#Yw=TwuH&|AYF*&Pg20QDhBkr@v?z
z__Jj?3K|+W?t*LXox+8F5_=h+<fyP?l1=hq!#<9pFP9nZ03-$2g>uEcSm15M^;qS(
zXK~oA{16U3@qg+r1>f%V)4-O#Prb=1digFxo*S_Ol&=^6%li!QB}PPB>r=-gFDMj-
zv+UE-thr7@-MrVgbm{}NBy$e)%f-@<o|~7mURFvX^kz|Cbd@)4-$p>rD?=E`K1`tX
z5%_xMnTA2+jq`?t^}US;DTvXFY**Q+h+biQJHJ01aEI_jCz2m;eGD#ppNVYwoU8a{
z@Iv9#M6Hw5HD;0AC6)TDc4wEO;%?(6wb5qAwJ$uU-f3?4EKcI<nTpfFYW)>}C#u0O
zaAzm+ch09q;Ai)_F{&KD3oO#0t^sHy1cuy~1Acx?;@U^b@O;@0cP7XDJVW&Tto2q9
z1)Cw0o}7Y$=H<wVJbyA&G3EAj0Y>8aLb}a>pF?&%HvN{1j~(QEexJH#JK1_)E@*Id
zWHhf*{UuQ6!2uy#2>PQs-|PdW{42difEqN7O=S4feKhNTU4*AP4aC%O9Zd;8LQ_G{
zbKz%yu6F6eaNvm0LVnaG(X_u5%7%tsk#P9A94>uJ#+xoJe1U~?_fyvc#gK7W>*b+c
zl=|uZ1b`0OUXXzQaRDAj4Oxdg=ibI388{99i@!uy#BBf2zSF|bP>(v`h{jn17d{|`
zQHgrMPUk$OH%(e9DkQF&A8t<o{LIv!<IJYtYv-hdvU14OsPDO?G-sae)y<y@Jy}6u
zXjpsN$mvP+Ic+`QgtUMs0@}}%a*#gI3@mes-H=$5P3HqZ%kStn)A|RXBYukUwES}P
z7mWvHOpx#QIMCHBp9`5>Y!!`5@BI4KxMq<UER|%t719g&fC)iT_64IH_iO9frl@hU
zx_U^L+NwRG+nchdCYAhlVw&;)qx_07n-Bex;?2-o>dEh5O!lT5UE7+D5F1t}>(0rf
z3@<n~f3%V9*nuBzdr!KV9zvK}otsYk4s5EkZLRRc{9L9`t3G56!Me3c>+dWvE20ey
z5z>}p55B+&(bcyon^R1$fjEd==V5j=hJeKY^2@{eFw?kp7)C6Q^+UzAPMpkh@i&El
zBOIE~Wqm3>q9jiM^j9t|2tSgcnf@Y-ak6!v(w0Y1e)qm_p5v#Z@$9U8!6ym~%r>P$
zn*lLLYf0|qFImW;OhVPVp$7FGg5(yL9co|MnHM>EF+Q4M^zsSOqn9ETh{Q+P@GLXi
zD<9LpVGyrkPT;_ZiVphRX4>Hx#+Gv`-893>{Wah4({tn|{z_%0yuf#xR5yD6`0rIA
zC0YV|%^H=<{1iWzD*;hqIpHuycH6TSVAAlv>Y{_5G<)c~(G>ZX&BT#&aHugpdXYw4
zSWa+{D)|0-lvyN{x<A!|I_s`qt(r2BWU&}@9vKc3hYAM6+kE<Z?9Yg^Wv;zK_2y;>
z+W<}8G0gLlHi%Xy?Cc614-pM-SK2})9a}PCo-=3+<Hea1QK|Z@Tijm`&XU;(9#ulm
zEoz%kDr3R&Z4+S?v!XMxlY$)%+W~vJ6rplwra~eKElhhwee6DX<W#HYQ<BVR`43%V
zmfEM$pOTY5V`(t$2LWo&9{w|oCYJ4&o~c3@;OPfG>8~KxXH&t@_<|F_xpbH#6pAYu
z&!=60dnkAfhr!$c5Y42oP89t84H@tw`KcKEKIG00X{*rjiTw(8M<!}Pl8%0=MLqe(
zH3B!{%Y85rv7&)%2pFj>eHIF;<um06gj$s7Jcy5-Qax)?Bb8h;$1mNuqFfy*2Rn9N
zpC+zrREp6t$c{v(QeYCpCt~_j)Ht?C-?AcO2z+&?qZ9n6d;tzYhLA5CVuxBNooE;v
zD55hgYFBW)3vVUys*1EuR8bc{x3uDJsUF(Zp5-aBfXO3hA+zfeC4QctumkWi#UlPA
z(9uTtA$8rM+G(k}3cl|#mXrAS+3+jd4;8)*xq6B#`_1S;2S&C;tdK1h)vrVWh8>B*
z;ECvU{1x*rpKz6ZX-H9I%FkJ_0{y$Uem^F6wo0acwF)t*;IIHK{Z&RUGW?H7htJmP
zwUqNs_W5g|&oT)zJ1v93htkY1b<QzM>zUP}4FNoAMQF2xQazf(d-gK;D8iZ$*MLZ@
z1f@Sq=B@>S__GU-iwDcjWO+8={pXZ<NteG<LwuW?K`zLz|8paBUO@;_go9AdR#ELv
zjqj@XAq2!sV<|rFHi3ds9ZOnUxCGH|tYcES-hGM!XxfIT_d-orK}Sj9Hn=u#u*S6@
zJQ2NrLf<_&_de1C)*e$NKqmq`K~2uB<X_PDTFG9UZd=Gf?cnl$h!7y7#gOPDvkLVf
zvEigkNsbk1Ld8{MPeKhOh;lmN5fZ7I5Px-9i5bD7XaJ*-nq%ZaDoR$*n;zH@(H-`G
zB)@pt*KQw&g>x@nqp|3xb=(9^DX^vF3T$k5U+i|?6U3v(!gWQz10LaC+Q%a>v@QTY
zt5D1xlKAFZfqrPIw$zb-axCl32d1G&g8u68!2kS;>n100NS$b`81ZW$%pfLRE=t-~
zB>uAapXl1tYohx~%ka86RWVLer>sl;DECX8sczv^D2axSMZs;#Y(g^ekI5m&JnoR1
z*FrcL|9di=xzDIkBroL!t*j?Yz&lE*@ik>3y(EE|7?Xd~cxzGbB^6khaCZWCe0a&f
z9HehgpbDd&Y9X@k1MgD=19z<5B`rVye;-s2{kFH}RUJ9VBnmEebeJoxxs`MT_|9Z(
zA!sP@DZeU>d5C8yn~J|LJr)lJEqP*OqE*$K_%>6lu^u=|EUf!85|L>np4b*YtN-un
zi0R8Y<qc@QgqSn2g(V=~7SRccM7<6RY)2_vCT1(6?WE0Um$D9hI>Xtmv!o=>w1D4f
z=tx9PD>Y*LPCW#9NG9YFZzjXlnEY`vv99HaDESm>su)Nc!4R|_Vxb_ES=Ch)o1DDD
zwf(Adk9HFaPpZ0Tp?i%NtHqx%cL6M{Zj8{ZPsrVx0i_q3;xE*n<7^Ba;sXqaw9210
zdjzYc0iDiD^<XnW)yZ>7TkH-0<1eNlD`Gmv>{iB&*sf?Yo{z=O9t|`|xIP&As23fZ
zM(t5+LFP{tvCj_<-qB^@)dXjsb%wdU5BwR&gIEzcQ^`aeVZCciYd6eKPj@6>pY_Q?
zE8okQDT->JGdR>$(wIbNp2s8EI58-^JtZ)3c+!=8IF|ErI*6pGnM7Od(cOTR;faej
zk_9RIS&}}mw*e6s+*@K~!2IZUJN453B=L9;$HqmjKo(syaGz<v(Ehmg;zQxOmE!Y)
zK65zZ2`VqC(7+jeFqO#1EB`>Q=3fO*o|(SbTn7syk})cFm{hwPnI_|ez_`&6j{h8D
z#j*sY-<2GaH|4qCU^VR7v1>#);)(*~efBSg+w-zBIhb;Q*tuUJlf3U2Wbh0go7uN2
zbZrh^zJ=(dQph}!``7|_I{1>|9e1@pEUH+PT}s%s={@1&fn?EN<-fFwVOPtT7OoIi
z`Si!++VAJ>IM<`F!`Y*;3}A3m+;w~#V~n)X`o5Vd+h^|6In+T<>bzB6d(SV&dF0&3
zsSRErrF^x@_<{vr-4fj9+)exzepZxsPhE2sm*H`OpGCxp?R6zRc8L)%)4Sx<v|b5$
znB3V@(yy`YzH;(K1)4}9KG;?zS&X&DU%W7)kTx~Z4<_$W&C>bndiM7Ay3e|Te3xkF
z)sS$lHNHJUsn=Vlc32Dy%XaWRKs;+}Cedi80{M5Tovsnmtg&l)q2~_1##P`%x~J`-
zC&?iPI^a#p=4bA7%TIp)Zpr#ljgD?(bT}Q0X4%U5g&Iff0dqjR3TyD|QLyk8NhQ2X
ziCcezmXT2LuO{o6W_FsfXYAE9xz`DuFrRFJXVR}uPgiS7UQf54T{bj+5@%b&K;cJ!
zgdW#8>}7AoQj1t_Px#QJxjq${C~7(isq4&?$S&}cWc{sBQuLcHopta(%l~sE;CM7q
zF*E<ETZP>1*Yo}=3<Z4O|B}t^a$OhK?!A9{MDuXumQ*R^CjXM{ydNqk5%oS_%RuM=
z!l}Z^!7^X%16Fb{ke1#;D$H>P29wi6-*PG+%~#wkB*g}wguguKM-%^UGyqH3gKi(f
zWkZpG);8^GbQ5D->|*pFXKqeV0(za1yWcr!;4?(?G{xI;OSM0h@1~o6n@rPucB_&t
z>~j4#`Ka-1S#aYHFIj^>{#iPC#wyEqc|Sj_LwL#K*b7>pHrZ!w;0OCt7%T2-4eshJ
z<J=wBYqh<3DBnQ=HgB86u3Rm>bPT+7FI;hmxh;3JujGJX(gV#ue+Es;Q6V=Tdx9W%
zV>(sl{L52aPfzlO+l$dEz=EHXsmhOQZMPlYNmfPux~eUHGujBw*|UIUEpDbhTb1dz
z6iY8@67*3cd6IefLua};+jUwU=2o)}M6=y5_d73qu2;H}oj&HQ{PeO}(qxyf(bv+L
zdp@hj0fw1z1doa~5XOWp*ksH-2q5W=*I8*sQYFZ@M_#@61bMmS$b$5|8iyyMXLVa7
z?0Oi#8^LFeb4K3ezrQ?Iw8i5%pQr}t32=@MD^8l9dGEV0e+B0FOUuh4C#hi2OC5o-
zunWU6<R$K<ZU37~Pf-WyY%V86PsH<?rwUT}WPINl<&q!w<4f1140W}jffBfwhxqry
zbJ+keMJv8Tk|}{*LScV<JbMv4NJ6~5H#al$;yz?Yq%i||+=~{}_vp)ygZv~?XBOsc
z=eJuJ!g8)Ns;o%O5zJF6C9Z`SB5L6Cl|6)ok*sCb``)}~PGgE8y8up-xMfkDHqI;J
z@*p)h*`0GbzlxS^K5LI_A{iyjr{c<KAVk6c`6ewUX0qt#H_};}!^)K7I>Ih$X5A{Q
zo3Qe%rN+RYKZ$!s4)Y<<kp{dPudS4<@iqas{!_oUW>0w02`;H?r&f^9MU=ZUIU&MV
zhlw`DM_@qs$@`hdni_|)WEq@m+BJ`NF3pyaP{$|TZjnC2gyZVI`ZM|F21~Uy4rJM6
zJ9HjZw!}d~1m{t(vQuNp_|Q|jfI;%Sd%ZAW+bJ+jVhxwuZhdj6#{#AJ4!vXMU@>(P
z(dH^0BM!ylYFTNnF`wvKl28biE!)ZaHmX?jiKjuTDc3YZh;x$Bz+2+S8oUpNy*qQY
zA+d{!G6^yR+c{)p&zm_^+UMGMsG5;Z$DLCz#N6%7im6>H3|Y+2P3jLj>EgK!_oq*W
z#*%M;b1fpCNM|9ySN4-|7`UxDXh}Hl)#nm)%Hw;qKb#iQ$B}-S8%<sH+UjkA9<Mdk
z5AK*8#fn$9UJYWU=D575RB$+Gwt8#{xPz{v1RPiHr)UhHCJg4JpGUG=RB7n1&vX1O
zkoPUXtuL0O%B|P4Wzs|%4+O@ox>{?h8X8xHD2{=W=_WPwc+KWJ4-}O`S9^_yF546S
zXTEp8pZ6yM+cYcJ;3;PKfx*ETAVyEkX)66jFAVFjJbMb_Irm8p8yTjoQ5oRWZiF4x
z4We!r=N-kR`UW<haJ^+uH2}uW&-|`6ZaJuoTm6Qb63+Va!y*9xIm@@dXDzUyBTi9R
z<lY)mUWoIn?u-hmB_(oCzHdyUu9(ObrL#`=y($&(pVnt?B|>GMA1aQV+8-!YiDqKo
zVuok?9{3F~%Fh7P<S<yVAT32j`#zx%BE1@^h0gLa-+I(yo&9shOUuSjUKQWdn>1Qj
zN72oUO^%^2^bYjAS>WH+QbOQsEOQGC{dd2*$)+*z@0obcXgpI320br}s{W;Jx*{K_
z1HRV9j;G>?<7PURo>2yrY&l|W*)3S=d+MeoRxpL>50)Efrvq$3DfQigVV&<u%?yPZ
z$<1<$9F4?2Nu!bbsB9sJK|S5*bUd86i8>m^@SOcIFls+^CxGhJa+`ufjhl4HgYnG-
zD`;M;a*4-(Bq4r$&d~SpXi5ShEli%#?9@0+Fr^A=bv%&A*?PY*hXHVoEo6kmq?Xd3
zRkgKW%^>n&Fe7tq&yq|7X%kVgu?GL+0(AaZPC0;@*0n$_*mcRbpJ9=f;|7T2+;vQz
zYrY4b(VBhX+L6-E!>8>#YVj5%9MLNhen^u+N38tngCGz$(HF#s+y1#M!K17DTv2PQ
zg5S7M-xlW`w0`R6dFe(fe{G|BW^zp$@w6F~*GLIFJzKGN-JFgh_U|~Eja9u0M<37^
z`yS7l$kClsl~1U_rw;f|43dtbc7I(i)LhUBr?Y&ZdV=&eHUfO5a7xVk)~W<~gUuV4
zydc=2&x9ss<v_!U>nA*(GgsYBuxody^P*fWB-k5E_!TH?vGE@INc8aahMnjU>w}MP
zl_1qOQcbI)E=!M=`g}|F)|;ehxsNU4)Yo>1vUu}z_gw|SU)?yLs8fbe`hP`W0TcI+
z_rYSFI%XGsu(Dh|)mFSNq&lL4H|bIFD(s1O){H89A4lpjWDuy8Z&~jRLT1@Bx>ZAZ
z#Eepu#GaYI8sNk%EF|^$HsT`3|N8X{RRne<;1HfQVRSZAo<!{2y-UUA9MpK~j2f2k
zkh&*FIcs#2vA<BiwR$Q2uz&eFLGCmQ6EB&Ngj(X4lfU6=#n)q-jtmF+NZA^c>jOhg
zUHs^udWEp!PnZ<bDEOFUEvBP={%y@32lLoraOaoc@#kQK2M<ABRBq_O0#XGd@91Fk
zAqwOXdI&GwnIDFw+K5A077)|RI@`&maHANs-i>k#vt3ntjT%i!!EOI;X_g!4GiD9U
z-eU*%bmuTJQTZB^3Y%KLRAeo7LKV#3PfyPViv4P|cX7Mvu(kz~HMkz&(VU!LvLR1{
zGgM3U2NM-Um^zX?)|zUF#cD~2h4l_o@HKc1a?}#4ZIZaY_lGfinLNl18|LxUb(03W
zN>7I^zr%43P^vq$Z=<dNpFk@baVIbL$K)a4{q5)Y(^MtBH0yKQ-^%nZkV@2+G;%zO
ziYHeqy*LlSr(2##fEJq6NBPHQSh)zBcIsU^#->~Df8H8+KsCXhK@{+IKO>A`0pLNT
zm3+4P*M&a>$`U5qg+~6MozPoH@H)*o1z*p|R9z6dJE9C$lagvmF3+j5I8bk>oNo#6
z=hL>X!^gxe*t91ca}1hIHSnWut2+IRTa-$7yOD2^kvcb@@`AmCRpBo~GzksVX(H<C
z>PXRv2qBS7lt@8u)mNQ}%SZ(uoQoQ8%{MRTX~FMcfeuZSGjQl12(3jXGDU3PkBpRb
z#Dwt$xFUKXQFwlAM<qA!X03^tmX)n)AAZ2puXh}N>MfP*42(i}AjJC;Jl!9jUl5!%
zayX(k&*RkSG4M0A@oOS7QQZ62_$XiOwK|et;n^*6_2PRoVAJ^K$TItpv7K&6&lfs)
z1?PN5Ert%`k9lIB4hPc0je+a4an`K#uLwe*9KAuM8Dl??ha3VySjWVfUuB~8VJxU|
z;eI<PdVHLrF~LL{<LwV{Py0BqyG1vvQJq(3Avn|}hjT4Q{3ObMV*#;La4J%>Trb6D
zsaF>15IIJb(d^GHfJPoRj?WrSmJ!;(rio~PLKVT7-ijohZf#4L8~Me0$riRtrKsgV
zI$ep<dSqDb{rRz>9Qo$NvHFYF)nEK*zN97;88#8}T2=L5j-TDRed4QWE3a8EiHV4<
zm+S=XAICAE7%?}etM>(^;{sylDQ3FqtfjWbAq9?hg7A*}w~BN7{q{hOJe#Vmg<9>7
zvQIPW<v$sJbcT~vfYmDc_Moz?QcQtzAYYRYEAwJ&X#4&qnz9>5*Ql}IwZ(m$gqG?e
zb2mpC=b1gu4z7>N`#Q$zoPWgp{2M-4+E2eEF4*Ifs->;1?M(qT#r)&KoJ2sGVY|qi
zRd*P%`2<z&giVqL@4u7$b@L%^BnhObpXQys!^(75l1OoU^hG}v9H^?=Z*KLaP2{S&
zaP8}U#nIH*<fZLPU{vv$Km0;b3A?KJO`(S7T!XTRK~Pn;Dcu6C`K+gO?g!h1#Ce!Q
z!?+ssuktJj0GALJi=bAPH-Yl?mpGf)%t9quHEQKQdZVuMhDyGE8|C|)yC50%u9bLH
zo;=L5UL5y4)l>g!a_@@T?}=z$;^92dN}1B(tE|QhKal%hggWb~gOG@*Hg^06Bge<V
zGOmJ(0|fplLNbHfM}cU{r;tJ%og%k$@zPf7f8}A?AET9tbjDH#;w|M>G#PGPdHC;%
zt3n$ZR(X=PXV3l7gtt>7>O1d<a^r_rF@uUB7-8S4z~GS;P+eUoZ*+Xss-!=LjN17d
zneDolPqY%9Z;d~Z$l=NfJsg%S>F>4cN&Z<;TfU$a2>5>0^h&ISO1*<@bF&6(ywnUG
zG3){WoXw|+Q}X(pO}jroPv4V!D^q~b{Q(&MG7nz+ant*hk3;k8G~ChK!C<Pe(|Do_
zpT0=Avi<hJuhF1*Z28a5DnvJjCMmP-_jg;{=ux>Z-eH*g^{%4@$#w!c{1;6r>_Y`$
zG0(H-U@m-m*8t{bcgL5GtT|HZ(9ZF*vqw4?48_>a2>Hj486NcOVX-uB+dF&86FJ2%
zz6=8zHiEZxNwI@`t0l4@!{OU%y!1aUR(YXBVB~;ntziWxkcS2LP^5dHV!U)i3}3s5
z7kywtpeiex4tjy*>D@?pTfR##P0Fb*Eh<_4V+SdL=R(eT9-K=n=K00PVbHm6Ky}sq
zl?UXG#fFP0>S^8b^}ac*?|l=8D)T#JgL?mA1+%z1d0$H`-L`DRplKup{8epVcFgZ}
zvcq$+iXvn0JPcf(dyHWBIs@Fbv?>suHlIBx*y~)b3ijM@#2GifGyUqOu%VdL?LOmO
zve>UFR2G&}-2*}oV$9OG?2*H%1|`K4`fuF5R-<olTRUP4G}U{4vub3NmO1KXQzGsI
zSy1^=rjy^y-;7U`AxH41W{Ok$6IW`#R9db50|(u#54(><|9kGntLei!aLgBZKU)P5
z7Adov_nf;9;RuL_+3Qi)k{~OaytPkj)O(yd;N_+bvHr62UK}-e)3|WmJlwX+o#?x2
z@5@JAS9(<h3}zr#X%y)@+YjG<&@;Bw8|@AG7uU!gR*P;#QlzT7cQM^uy2e51E|8xB
z#6SMZm$Oxc{W@jSj(6<z@^5j03^m<6DO%qj5u!=oR_?Mto|ti7pHAvfxyDI6RHfBI
zG~DAES?3_aThV=e`{EGTc&x#ru}VL*Jnyri+Fw5Wfa-;mlNLdz=yEs2%7@a=RN5o+
zbq-pk#1^(HR8q3Z)@?ht(~^++8v5N}1T?)C6IK(m{SL!utuln_0*mOs65^tjYprHG
zi=#l9ECm%7RpqwlB}5p{=St8bl_*AbI)rx4H&FSY(jXz-V_j@lZ)@jd8>~A@1qPYC
zq^`Z0^%8d6p76rZ>e^55*$H^d*{Y?rhMPyo*XhmW;OYiStEF`)A>7x5`FK9=N8dBF
zpD&y}-@j)5Tm_izQ6?g3lj!6L6Nxl(<pU&dmYml(^wGBX`0oJJy7p`wYwPg9wC3CB
z{Ch!z#%DSnNpUWK2Y%Mj>yZHW*GQ1G%s+^)>)fqQ_8u`GHp@QTerL&Tf41t=;rtDY
zXaAcDgleLY!XD>%2>~B@Q+M&hsyB}vE*iPIbNA)t5>2o(f(2TGo!t@W{?ccl;;B`v
zNI#5cc9yE;vHyx-deDiO%}KsIfHsy*zkzrgleuUL^xP+6TOPDO$-=L$(4?cN<w$#R
zCI$RkISalFG$mzC|7J!`)K=Rs4ExxxsOAH^Vh*@%KXPw%G<rKm#C5{Th+UmTBI9CE
zP*qO7zZ<p_KD}M8+vsI<FF8QGWGRzl$y>`Z!3H`nw3<dN^+Zgx`YOxjkUAA*{56%A
z_i2!%(2v+?4vnwo)L>CiF*&U+C90`evd3h&JJ`X5{(YmK==Oe^_5A65(8m{-XPpqk
z0Xvf)B#B4}=KjCpCKB}DKM+c#U7ZOP(9|Fmx)QwWX;9@kY}Vo}XK47GnY#W5%E7=|
zvp!h3q48n6|7w29sf5DIE1{Y`+`#)(;V`E#h6V|tf9)BDMEXtA^Jxe}C5)h=+4ye;
zuSEFsb^E2Xfk=b+^N)>3D3cidVxxmQ^cVNb*9UeXtcRm>@*GB}Su7==&uQ1cLx6Pr
z9rK;n=?%`=4_`WMUa^;Lf>{5}dr!&la50uWRdDG!3H$)qG`gMk_}ZwlDWRVwTK5*D
zohAU@t_o~3se6?_v9`*acK%6C|La~1iTLB<$Svr(nHB{394>GuCQ2Pkx%d)uYZZL$
z(d$Kk>GlzPDV)?N#_Rsz2La=s_Fm+N1;)M-1&A)!9V8~u#giywuPj#>C9iAI!@)y7
zHqG6D8D}Q=0WD3CB-a0V^rzW-%!9eo($#17xy-9;)+z9pwYBx_S|+NwHpOrSCQ2+M
z8vuXfZvAqh*Q!{#-h27@uRHq&Iz{DL1qdEVzn0sBgdd()-K^sP$wS8V({bh};rnM$
zGgQB}6#4gY(3HyE7Q_ht6WW)+C9rdz&iP3TbnNMPsjkwGtl%(gczoa+>Z+&ym)*$E
zhQ3Z?o{GlTLJvjVe<j|$q7=xTd#v5fcD85Jdw?F+m|S@X#r#Op36|%=n;r;&|JuJD
zEs+UZ0T`{o-T6ER)`<u(<qHe^z$QROHLkqOtMH&7)_w;4nB2%n{Q1*Og$hICv7F4P
zPC;|TERM3(bhH5F<@%$)|EdmCT!W#!aw%<+`>mEy@!8Wx?>I!_3LxQv$0UF*(uQDR
zM6Jj~(@!09>AkhBKhQvpL!Rk+wAIzmgNMf=WcJAj-p@_Xf}R@pw%pVY96&-w^%J#v
z{Xmsyf1FGuBAQ9f=9P3Gtaf~VZ6m;23eQit2v<}~lsrRQ{Eq)%x*h9Su<0kf>5_+V
zIck{a{Ya9WU8L4ryvW}7YA3(*-b)P%Nq_jf!~VfDn<CW@^(j$YYq=%g)4YJ4!_=lH
z5R3o3Cwgpa$7$B2sU|HXY(Mta&@$jH6S0>JYc1f_{4{qM-nAo9Ab#B3^2xjtjh>iV
z&yL#+q5YF+iBMNEyW1khAznqQS(=v#kGq30wywVu8X)TxM4$&3ZPEb0qZlw6!*$ic
z0~_WNN}9K}>0Euq&pX5xxByI%-I8=ABA37vR}cjSEKNGS{`{pdvHLMq8QKr~fK{p^
zzm|L8QwPeQWR4N=I3u0Fv01w>1snKGzU}_pmWg|ocGK%idjGNsEsbE^9gFjFjghcL
zMH2(3U9zAuGc-;vhL4KkOea0nwZC~PX7^5>we8Fa<!b^m)~I~mdEU*@gFb1YkMjVe
zw)L1`^jX^tdeHVOQ>RA36Y4sqTza|0()T4;(X*|5u(W2Tz^(@a*5T@E15QO3V@a2!
zSEi*s3o$1;A|um0n88SYQjL?5Ww9J{-iHdpMLn)ZL5E*AEh##`K20U^68Ik%Kx!mg
zfYiGfF=Z}9QN}#>jsBYvos3izJ#3hL`62ZcpennyHix|X9f&T>h?V2YLrd-Oy13No
z?x6Ce-g!Y6UvJ+^(ZRrvX5~X;MCu6e1m|S`&^7oxH%}UR`xN{DrKO~#Mkc!K==^Xr
zo<f&rcGBl?`ve6Y%6)?9)s=Y0jp-B{(nZ+8&zxSUY+^`_r=Z;X`TPl{uVlMRd)3HV
zaEFYgYeZAslOusnoS=#eWy(bOl`Id4b8M*Y5d64|naZ9fqYFLM%oi6E$!CD%&jikH
zComTiejccG^W#Z|V?_TqDq;JjSaHbxlAG7PS6hpxh}mX!5Bp*3@cLAZ?7^pQWL$=5
zfQ=po=<#P5#PjE*^-;=bWgJ)^UJ^IPxz0yjKD>7<#E&qu78UK*0<mK0O=yRah2t`E
z4~@PGU0n{?3NQ0;+?ha>o3cn0O}VKM_Y$&GHI6J-iCU!NJY?GmD3+RnT_ZuYZ$l(T
zY1F$3G>;3O|M-z@INy8t!$q@WVejFHkW^vXqU^~G^xQ&t%4{q~%+cv$ROswckH6C(
zO13iT72*Qn3-oNCQ3>>l!_$=`ZjJ2eH#21iBqGO0*`&f0*Ry1;UD2X83ZfC`4d9m$
zxqIz7_Xx#i5t)5EN4o`)8k0mEf_Q%gx}cj}+Di_0ybVdLPLmoqxTNJ4s`R#yI}Dhm
z3Pj~-dAeF8$;)*?!ogO1iur90Z}dS&`l>|hfK=~Yp~-(l&@Ke<c&HooYoFASLh6)j
zYhj4h=v3kF%jTXm?h8Z`u6MO=*v@vHbVACglugLQrkGYsge<?9<)oaSA`)|%3JN>_
zNbApkml4040J1ZHQ7_)0rMFnh@PB;|S9GexvZ;oRU3AxJ)Qve88BM4~yaEy7h7sbz
z*ov^#UEgyr?8Ro=J)1$d%%6?rA6S>$wN95Sm;2uI!Atn#{pb2*OauqtyH?Jh)KLH2
z#KBouKqBUm>2;}yiy*ENqs+ccKtik1d8H_ln1AgF|7OF(d8dDY5p_ZuVbe;{;?6m3
zj7A0*aU*yL%oIwC`cux8Q)`<|N=E3eOwyH-6^=ER^_`cdU3cv(Vt0aNn$(<W4vAo-
z1!Z$f=BSYyq`&J?QR$ES=%;H<m-KE)$X_5*xC|fp4z!BQ=}<SZ`jnJZb!kf0&@GdG
zEJ(V4SATpiAMs*|#KFB6+#B2wEch6NQf977B8Qk6+lJg9;(*1r`^b7f`Yy#M-bG+Y
z#`_tA!7c+c9Gx5jCB#&zBi*EG0`B3*K;k#|lWGn$(D!(VE*PI5I}fB78L-3#a##`^
zY8`%HbLEg8wsU(NyHR=q92Ytnb_^a#))mDV2}apTy5QN6!NPcKfex6+eqr5YB_G;f
zP4x~i5r=#W9YqeJ-RQ8;O1ea{iji{FJ5*v)u_UDPns<J~>q%40{8xu|8ezDF=S>?=
zE`k=+?D@-f4s6f--UBb>iOe1j@|euZY($RvLlmqdtHF;aY2eqr-9o*h<v;PMsGg$1
zVZOC{GbDBG`3`6!5hyrYFD9owL7_1(kD~;NniX?S)*U-f51ixpl5DyS&{esDj=m&L
zWgi%9flab*7yuk_e?EQIlM|DK`ej~j*3A|8y$=exVSIV=RN>IBNv9>}CW|gI%g;2R
zP-N|E7>yNWNR!1yRA5AnwfApPojmpp+7LO->kAFok+p#O!8s|zH~an=Sf4Hq{iZDD
zZnwIipnTz5MfY3Et0}ClgYUe>h?}Xq;u?(;;cO)HvyP7RlNodlL(txY{E~=pn`C=0
z!MNLB*z^J>;jMygSo6wtiNfx3$4dWepU~^_><0}P9)q<u)Y;ebd4uA#TG(W#BS7(W
zpgiQ-i%Vj(RLTf1Z99Vs)j6vNKVgSq7bonMKMKd|K`D>*seY7=s`V!@5X{<gOa0@r
z%coF92pZA-(01{B3^01KuM>a{i&Mx<|CZxqY7Bf)t~0FZSX5MUI#+rG9E{deB}m7<
zz<pa|(_U?G9|q(_YpV*~#{0Io-HN5Aa_JULGdV1f%}7GkRYf>8jo);<dqzVlO_B9n
z!_EwevTl|6XlrjNK>DNmjETFKx!bmQ9=szR7#|0w8RGWFjAqMz?E_qICZIK09{jmY
zc-tRG4(z`QlTOws*ZpqbHu?5sv97GR+~=~_M%3esm6iQqrOhqfrOCy~kIU+LQ^PAk
zelONx1OG!*bX|UJ`;SV4u}FX&@d5S$-;9lLcJ6LSKj?c7+I;_8a=7@?2JIYMc?6~y
z<H#k}Ge7qo8ofSU0iUOWpU%h#<WwH_OT$mw+nb7*ueLRg8hnKwTmI?UpMxK7#T=fv
z$3HqW$I*w~%$1#hR4*=<YBkGO)YR03%->ZGk7toaP5_CuZB0eS{im>a7A~L8113s=
zs?-I)kzdUPP(iSd|I-h8rf*c$4*l6yMj2!d-)3j#x=%!1t=Vk5F+%Eg_V$u#%8E)#
zVpt}l$H_rePM)K?$CV_K)1a0E{CWSKER|i~mTf0UJCT&%BallY@dyP}ftv*_49K13
zMT3ElkH^W^*}?pck{ekPj{8zCMY<e1mH(=S8L9jTpIe~cL3f2#9%rHxg>qImyZADU
zP_`*U0(3hK=zld;&&7-Al=79@vv)76D-{qv&0T;O%T5zPfXd`gX0M3+lRW<EUI7%1
z$G)faX{rYRU5eNVKyLgPmbB5y)HU`{3M@fSKvn`&Gm=b~uGBRSxZ2QAB&}>Pk9LE&
z$x!r^ZX=uBO3fcl72s)fmcL3PkmEG?<NrA3M-WQ`R~#C)scLbf!$gB}Ld4+InK+|*
zgmHC6@0DQ3De>Daydg~M;UW|1xST8~g!sY$kIW_@oFA($92+cvyz$-{e?k$}cSABr
zaUSq&V-am2b>U;Yj;Vs+xP+K|LJtZ`u?)-`K&jJ2eT$=I^acGX+qXB37Vcxl%?x0~
zK80)@qMWuCC>DCefo?q(2WeT$^lJ|qX!OrZa|}>|yMcCu+@mYN;k4BP_wZDYLtOpS
z@9YKA7zx<Ww~gS(r;FzdNyyiOa-BoEeca>aTAD9WMr-ckMHE1cG}deRx!998F{0@f
ztti0??qW8h1?8fWJ`XG7PKcfRH#Rvl(jRvZ7Mk4mRKQ;^q&*FA?uC6$rRLGPcY#FA
z<3DDXvhj2_eTCqso37t>r!6N#z_k*;-{Nc+Rs{21xdILcRAGcjohEyB`|j-i9G^m3
z5Dm}$s$S(Cz>*mGH_ABCadN8t|5_cK-^BU0)*9@~HeT>)^Zj2@r`E4?*)WR6(}^{?
zwtB(B@vwE;5P-P_jGu;B%@oIoSayR$H-d&PyW>u6n*({U)%$bB+Q%Pg+aqh)-c+XH
ztmPHOKG%`OOq9G&?Ms!d&oxsyU!M&~2Qv(5f3wcoKU}!)bq)dwg5Tk9n}<tLdsU|a
z+a{%|HrJCks>mB}`WogOB<ziyCh`okpl^$)!B4$PFmF#J_rzbsEBq7<?E)vfxCCIg
zaV+#thEX}Me6L`x^Y?M#PIHbNe`Q?#JOjlsm~~Z`XdCllrIB>%#6Io5z#xsHbq+|f
z@aXduZ9A$LH+i|VFhH=Ty?fpu5u^gTEQ0Yi493nXVfaUY8Wwfys>WIMVz=HOZ{<Pw
z&>IYD!~O=o+<{LaP`|!WSK_rc_gr&bkhRLXTa_~kRK=FP{q91)7NdoQTl-H(EaFuC
zB1gr&f2Ps~w_y48cdRZi;@~H-yIl<rHp4)Ao_qNrGleaFHoUx7NNfl~5Zl00-fY|u
zuLI;?%YKifGWww*HlC8Sdce90ohsAi{qCzPQ@86k)F62E;HaVRNMU{7DAE6FgnN`5
zR|)1i-LCiyne1)u9ED+>=0AM?DD=#HGtw%*o#4ZyBKBOAxY^YmevOpDWvhV`_*HUq
zYXopLG`I{azYZj}_zf_(2Kwsrr9Oq$>Tf}+HVN7E*he_&c=p%Fi!M(0bo1IZt_TC>
zxei1`#NULyt<x_6ItxM6n9^`8OWbC}6GKaPZNyE5Y^lK=Bcky?stXOGgY|zE8*F~o
zw?TMkKtMZ>bPR<bqKt`$tAYYvk<>qZi%;L@qPVTuohKUhpr`@?q`G%w2xz%_d(d29
zOc_wFutm+ZR?4TI?=&b@<-{+NllGH1m5!G4%F}-Vl`Bvc>9^FVcvG#>sGhA$Anw~t
z9EyG#UVDH54<<@ZzW_A0M!P9jpn2DrsgL=DbUJz2bYATZo81V0c$a{HR{}n(Fvi8U
zxve-T@NK+4r-LEio}nE;HlLC>K~6y_F@D}2f%<<PITDrCx_@qJ5|Fv~7~hq1Ua`(O
zN_gpy;Nh370&GL@dJ%{QUCqYk0_X$QpOwWnnBzloyVCjP9G2<=x-e}{mTDCNX+osI
z4r{5+=L-i&HBYxzyfYrS&;OsshJOO|5=BcW*nL3(&Y=HSHnTZUX;A~>6Jm{VL{zb=
zBs&y6N4AcU7?F4{sj}nhWkfJTlgaH5g58!G3reJ@I0KSxf;hhlbY~;1woO&#xb?ee
zi-#`$4(vs})v*;JtT3N<uKM|bh(Dm_?>uIibh46<ysyL}0G)KIEt5nNDW^FFCNUdC
z-L3PpCtgc9DeerPrT7Cy&_VPzAmo>d^VPQSsG=fE>2Ee*%22n=QRX$b1q=D@5x1g>
z%csC*NqY6j9335vl`<U{U0Z(I)NH>Sgu6-TF)IiaKUv2#JvEtuK$?zm2gR%;rkSfX
z%0!$0`@$fo9lEUJM*PoB5FB3eaC7QC8k%(ZF$Gz##bt@&Y}^oHBj+cL@U#F?Y24Nz
zIs7a;a+V*4KNo3xcsM3>pzV%>dA6|#_~eQ_u;u-UNs7`m6tyfY_?hz-ZKNM=5z`Q+
z`EW~+p(he2`IUV^V;cTND&u3hZ(F%xSNG9c#ngr+>qRJz9{~Q9mtajy$GbiwnlyJd
zw5RJ7{*|QM%0#MHeDX|Ib(B%E+C?61atebjrF>?t7JkxhM9=V#W`a{26O*6$sDEwE
zE}s{(jpa?m)EOkoYl`Golo12J`$E3N7+SB^TY(=N*m*0z1KmNeE@k{mUaVZFFy079
z)3wdF%V3l*$T<k+MuF+zs9uv(uUz$wcEr8Gsy`e(;>t*D{=P=>IQ&iaVUTlFRvN=5
zBeHqaAozVDEPNIV<78FRdpiy-qKj%%pas2Q5`zt0pJpw+>~zv}LLX_s<qrdVtZyqS
z6nw4Ej9m{G7O|EL{m!Ny9b424-1h;uUkO?9hbYZ(mQt)xd@}7{OiA-Z8gnH}X-NmP
zqjUOSJ}iC|_t346z}k9wo+y7vt~KIIC;J~4keQ7cd@|J+2do!uxdlPj1TFoz!G9y^
zd4uO>XI@SQ=YS~wT|oU@ABQM=jlSmSe*Ezs;F`xku)FXVC?)F0s+Ag9oyM^f8o(g|
z6Sj>dGt4c}D*25ObQFh8HSaT<dGB*eg9ulub*p?Nc&6R%O;Dse@sj;KxO|h*@N#H1
zM?}0`xl{+kdGUTb%Ck&(lA@umakg9!ajN7%bO{m3SCxt`B;EoJh4M{LN|yF!IfM^V
z8kbPXt0v#kH_QlOqX`T-z!n0=t$s?c`#%KNqQf|vKy$>9bfSnCY6Rj5e`%;*@tYFc
z#yovXR*b85>B7iq#FZ_@tRRKnd-6N8U;33MFCF6b5*Rzr7Y)}m5Vg@biol3Fa4<qO
zog}j8R5(AD@)`hXGbdy@z6fUWqbhP1N3km<7&z95|8Vuh1nLq{;|yAT%UKltc$lh(
zMhYBSjH^mYWC8CUXNk<w5yiALu%&|VXT<wt-~iSr2fBvR0(oD&>k*5>yJ~rrH?*U^
z{9v+eZq#>1V|wWxU#=&^M>Am#N)8{7bZT5-8NBWCqLN_YG(Ju{0rPj`ji4X-&%&@I
zr*^%jzmtQ2rOL<uF^8%J+L;}DqSt7v1B}-Fg2a(O;!wgX*}lt}*FB(pRle5Rwkl>4
zcFP@ueWL4bySDq2SJ@X}cRMeuB>mo10AQa#GIh|ZU~Im@EUp)cL$BV&$jd%`X3vNd
zS@gGppkQ(!%p35T`s^$!1wY&b*c~hu|6?z)sHQV|&{wmm4MYRHXGmkD7IV)#;+_-Z
z#BB$He%nE5iUMGjt*}90J&Qogi0tsJf19zeq!?n93;<Cj(#3Hajt(gRJ4(?Q{p_og
zOI3?xmI(0k%}>AyD#)2=wM6M+YM^pMDd@W28p<lk_U1x_9}w~nNAz&obmYP5m1IHY
z7}&%$oArQQ8ChEB$ysrBmr}V!a(SZ-*fpqAL9_E-3A+n{h$ep|WGf%JrjCiOV>s>q
zVw0^tk{W#0dpTdrt}HGNrEi3-Kh-6Tr}6DB6w{3CpDQVRngslZNJLuz`wFax<mTFK
zeH2uwb6j}(w`j%!M}L!B4m-%?u=4rI{*y^3UieLL&Yt1RIpD7gN&trCpY9{IB=4-(
z8fFeI2Ce0=PiQiB8@&3rhsR%ip0uuWQt3S9B|aG3E{n_uzl^7z-k%U~8B4fa<I(s+
z%b)jcw&Vh<Zk8aBS3{rN-A|H9vNMVGTQZ}^D6Ont!nLwt$ECc~cT>DT#}!0=lW#Z9
zxNDxBnM(5KFi62^?2eMJ$!{mT`HQ{J6L<H`tqWk0v(?6pjHTk<4g`sp0~==nMc{1Y
zsm5w9wnr!$*=kizx-Uk8Ql^y2DBa`8eQ(8UOLn|n;0hK8;TRY{o6b{8y%UkNBoQ*z
ze%Uj8RCS+hKI~Gkv6RdSLhL3g_7{P9yJrd5owCpMbSaB$?DuE;y8(sV`2?8JMoc&w
ze@T0&&ES|cx&(}+=lx(v9pHz?y>Wc$47I#ROQ+x0cdkafz-30rb$Wi_d|9fkZ1qXS
zF3c4A0It(fm{f6WI=`O-AtKcl6|JMBX5mGuF6~ATEP0o}jZP+$WIpv=oqZ=H2^8YD
z+*V~S)tC{mtQ2zE1Wds5jasREdBl?OqzlJBgtQYV{hVBTZp6A8cIUB*E`>XvGuFQi
zE9qfLkVU<nBb2hepbn-J+Cta-4$SFjBe3EvM`lDyIxo!|{LUeFOh@u`M^iS(*eZ4A
z37r^27@i@Nk{eRAEFC@TNOtVph~fGe(56LSU)>SV7LeQ^mgy1eNH1(49@$J&M_t0_
zaW<bA64FBBzj+w_28(JwgI2ijJ4s=^qmBo#qXzXgS-Ic8INjjHoLTbjoI|w5FbQKx
zhL0yeaCSD_zcH5f<{AbCZ11|=UQ=oD8Dp;T_Og-#)ZxEDn`}*+d>)}(QO+q+VKB!1
zVAj~6rM@v|G)$InrY->{zUAk=jvDdv3=F-`vwFW1c%i?LLf<x-I`r6(YnSG-ZvFYt
z;1{a;ce|f9a7P<4><_au9Gli#=Q`h(Z^SX5+g#lfajirIZdrGSB~$;!*#b`dzD~BT
zTx^^!LHj(RS#(M%WQ-?yc9N$tGGUo@M7CCy#KBA99}>FfZTn$Wr>ZBZYsN-EC|RTN
zV<4^kJ2cI!ZEcF5h<e(1^7`#z+(N6e$XrR<+&`qOb#PA#adnknZ)Lx--gEB~2FIHq
zlgYu8>Y5agMLdB21`*7zbC@-@gnY!9?uoK-*5W;jh`0~#NkCdc6!J83-42xP;sVDP
z3%HEZe2GW1sh0-1#qT%N4F+#yNkz~`*sB%bCf*TB!7yDj|NZU8Q-Is2DPWQ=RpdzV
zk&Yq66P<dGPznJfDtKOpQ*xb9Dxb^O?bQiKpcQ%^c{W{m6G84dQe)P;l6gHYtl^Lg
zM)@4seS7nKA>Qm#q05f0<66n~Fo(C)cop;aF3ka{rRz@-6ObA_FlCe2u%dk%kU549
zWP0QFfPTeD{#fJ(8n|t|!|U*kL4uk>dWjJP<)Yb+OQV31-OG_P|K#C+d9p&v=tobI
zR8OhvL-0!v|8lw5a=!tj<)-lI9u87K)i78h2nJndSR!_j!}aMBYsTdh+9Zh!%FV6b
zLDWmxh$r~>o5cs<g@hV)XTK6$AC6G3BBX<RU5dz7fmDS$46kj%WLJr^X7Ck5`6s}N
za))p3qe#ZbC*-%$7KEi&@{^pi8SAR2TwyLC<9e>2GZ361vZa{DeU32LY6&v44qQB~
z!gLJz-m-0;+bR605)s;A(&XC$BcWkqpQr0V!p!OWHw+boNH*IZg_EUFad!U8m^{-9
zj^Gxp>JeS%eB*cwc~d$B?kI5!m2Th{hW7s8CiyDkd=}zuv6_hiHvA?L-`2XYTcbuf
z)|wOW&4~{;flrM1(!(biyDHxdQh4*1phFmo8D-tmG(ISP-UWAq`<Pl=pD4~2g1Z*~
z<0bP{OR3)?`l{LqlK^|3BhXdb_+w~J^4ka^vK3%l?jri@quDCQXM20#P8|cW%!!f9
zhy$L%>rA;SJcMzsxcWU=RL6lsU91q$5J@JlM<j73Z9A#kgFS&!j<|Ly9^!^vWH39h
z@8H?=Z{B832(uS{&e?!ttBs}%o@2;1wxtU#E}ikGd-t$DKdWE(+3=AXOyS(;v;>?T
z3SdOFQ)V@Iy`5KjY<Ey(NnHOjJ~m%hdLTWOnonXw8%6xpCtCe=Dk*&PI27WF)lk~i
zZULX^Y9#JXi}4-c_flZoh_qn-YgQUe8=-iYfny)Qg>o(((ub&k*r7HQVg;W9gPqr2
zfBmG}YWRQ1`pbZ*zHt2?CWfwI2$Ajv>6EUa8;0%<2|<t^!eQtR2Lz-+q@|?0TSBBk
z0cinI^uPU{bAB(L=M}G5d-mGvzE@q>=Z0%M_o>zY9m7Q8^h8OuQf;-DmH_z)ATMLN
zkTU~B`^JH=cqXK6h%o3rK9$Ttouu2%Hc09QOF7!ZHomX>i$V7mG<)ZJlbDajyV{{o
zWfMNYhY(xgJxvDS{OE_=Mu?Ox*W?@lo_7XkvXt*c3_!f%?Mgr4(uw^qc>eU|{i**I
zk%q?Gr}GnzlSca{Nb@2sk`bYm&Zl*G5#>h-XAHbs7r%Nz_hMq}j!7}T4{+2pIQI5h
z!)3lkWuXxeK!O_IrH=dcq<f<S5P1re4iLrSwmi{{Q2s~^${nIRqbUpw4*KH1<iLqG
z`kQE6_#KGN?5vL*L-7sz9k~*QLN+c;QkD$gjuGKi_ZFTb`2&<7!;y;#fGRQX?Et<Z
z5rt3O9!S8vuN<rZ{v?18t6V+2gBY!vp>-`i@xfq>@EP|4o;_&evlYjPu=Hz>9&AUN
z)XOPDt?0?1*|L2;TBQ8&ov2uz88i5UmBZbm?+)PvgYEDTF#Dz*7jrHi@SC9XBm_Vk
z_z^Vtp5>O&yJpt)Z;}O4Sv+j_gS^f+{w7>vslnw<xLg}bZC90mK?w$tYM4YI1WsaP
zFdNVq1${_gfG%DYg|n|FZ2cEpKzzB{9zI=!PDOOJzsv{KeqNdgvw@J}Nx{%^ZEdm^
zZn5gm1tb46qa~+dd92-catkKoIyx1Z(uFX+04GGv#PnklXsVMHj}lPFJ%3pli5q0@
z|GF1PtS|e&te>j4)$zJIu>V4(09?O|K%i@;>%joL;N@02O*rQ;+bqw!jlY*?1uxky
z%-wc!7Eekk^=+l&{yh=bo`heOpJ-E!E$WP9LZ`?koKgZzswP$&6`K*CIvXVuy`{t@
z>kbC_MykAx`Zwt%gEw7+iU^=jWh87Jk{M+)2ol;Ryj-bNcQc=~o!!Y=Nsb7P{{1`=
z98X}o-3t`v(5GtUSQ%x+WyT%fC=4P+`8(}dhEGfo$a<yH_F|$FctGGW`LsT!09)?A
zbZAsh@S3H_Mg@TzgJU9=L&Y6j&6h=sl@);pI0Qz`&T+@*Dk`B^Ne7<%%>Q*T2>Z>w
zgWVanhL+qyDyoBozOHuULeX|CmMaG3*!RdK?YW;DzIAIBgPah<F<_4c{;3eo6R^h^
zv_LwT9m>o=`}?QHR!^Y9Pk3jN4Xok1JQQbGiSI<$BmtzSanYB;hyeR+0JK3+iHCvh
zfR{}yi>uxVS)TrAtL~mlnz+6X_+*i3n{hiT*6#^~zu$0A`M)q~8k`niY((X#E&Ks4
zJ^sBLoRIibQEf$f&5ThEs*P!)PJ~jVQgV)c<R(2uIi3t9j_i2!-|xfi$0trp6^M3V
zpwa791P{V(TZ-#C$h&7s{->oeVxIt8*?OBXEN2Ed5M7j^?NKqr!v?PsJ^@KMzZn~}
zP6kr2B>RF5dWDC;ll-kUcpAwF<nN%0yWZcstS4W@C9b!X<^OEo0do)mttjbAAutxu
zlRyVGG7v8ZVIX)z6wjje-}k1xf0T-1eyzbv%t8tx#c~LNPZ0wstlpbJIZwYYbsrMN
zr)>oOD(RkM@$x$2rnAN9{ncoeo7GNK)%R8fvtqeYS|&0z$N;8LvKQau9egZf8KI+N
z_oDUn1*)MjAMWs;bQcE}U&>zG*Eu?fXaK$RymCsh%L%^RU#=AUZ^Ti`Hx;#z25L|y
zd#Bd2gRp3ii{1dtZ0I!UQT!V_!=lFWFtrpskixuMqGAHA$9_7Wuth?JZ3w{7m6|Pd
z<PSx9WR3QjosqZTgYd{XZJ7`iwl2((uJ5I$z6AHXlHs6$2(9$O5+MM*6i4*$yi7^v
zBnB&u-4Lq({qCe7-M4e+sa{WFx6)zhcxDIVI{ew9gQmcjDTVXV_D64B4tVQqlE!!i
z@tEsd>Hd2K+Un|rbm&Qq-32zL2=73AjN5m0qrMwpwtvoDeeBAbzHFHq3E%i-iG3!!
zBixFSeJwA`?DT(U0YXS(E;H;__noa7O&x+DVKRA+##Z`&zq3@&bQ3K<D?9}<B9#gM
z*E^3Fmqm*nQ7HZ{6wjY%GSSb(CHNZUL?jFSJtXnBAxyz?t4@gHWyZy-yl8;Lfijp?
zLEB5I)(tUuuip>{7Yl1$to^8-tmDA(ufq`7%^bm`3&A7dq_cm-rc;zsKVxI@vL^JY
zf$gzE7)YmUJ@m$T+=0hJQJ2Wv7^gNd?a;-XFI`_}YO74gN$mc0I{b1xUv<drLktjU
zd#pfz1BUNJ#f9bKB9ZyoS(sIV4jC>y^(g<o<6boy%VQ@(g_+cN0IAHZ{mMWmVNu-v
zUn7LBx<%2X>Mw1pU@tVmF_^qiXqy5$fkLY1&?07k9)*S-FFxkny{cb*<G%^+ing})
zomZmB6aygenDDttdMVV*(Gu`)R6}<4oV<+Gzi!k?bAuH0@)i9s$?JjoEX*T0^a;Og
zRkrxPbt^3aUxwCsGwSH*-j(&{r^0$4{HHxE4QlK)&>ao50@cAxk`EKf&r#ElQ3Q+C
zm+wja8%U2=WRa}O_c^Vze&)|0Uy@bdHkVYN+OqLmM>9%}M~$y383Pth<=6C;_N`Re
zt=#_3A@j4)|GG(%(CBaVQAcI}Vxc2_3tDGAF5Hnv@`-J1MbwKdgV1m$1V!Ajc5VT7
z&(-A>_1kM(;|(TSe`e^ZZ++u|yo$D!LoL_nZ)@0sn3qAVP+3S=h`}fM37&cxg;YzR
zatHE=8r*)Bw3Z<<E5}1INyOUO2l0+YL+2Ucp!|vD()vnDB0U<x?T51Jy;D{+H)Ys}
zsC3p1rU2s9C6c@6OwUW3u9!4#Om^`)rTpW?O=&rQ$1NjZ-cPqU;d?KoXSO~IWzPE^
zKM;=GO-?!~ZrGQKJb_`kw1MhYxQLAb3-}(8fxxU;cm3bj;?h?b8<M)Zp5ARx850|S
z5*1Ok$fn35rvO5wG3RLQ<!r5oI}J@1lr^O~2~AyuAf70_!w#wuQX<mA@gr$Gs=DKT
z*p<gq7tFdIb+ZS&y^O1=NP5m%p@<hJR|uH(b)<dL5o3R}Cpv+}m(Lhy;t;9kG{?2T
z1H5}dmrT{SNu|}T#oY}JjB@Xd-F$sXyGi6zJu&0*_g~poK7RMk)VBHYSc0qO5*5<q
z{($+0Sg!i3jvm4(#6W)u&0$T^Rd@Vfzw!c|z#bb7rcY9Jn2NUwDd}tbj1G)de(*6<
zaRw`V4+FM9XUFO6R#`CZnz<;>`GW|6>=_Ff@Nsc-a*e;@ce9Qe{#CXzp`0o}n#7&N
z$kul@>>A*OS!pVwSmROR`<)x|OD?_p9AoLDR;zW-aI1`di9olp`>{Obd-x4Ckkj!*
z^S<LP?%xluyrSD#qnPs4y%xYXMqg^09l`dEz1b(TfwS15+gvaK-^nqV)k?yyYCSkO
zScCP3yG87Vl&P${fl{g}t?f*1JQf$Cx;Q4C6tlQAqFR`#x1`DZPS<mr-|m>lZn;oi
zOQb|T+JGWsGIQ;ItvVk&ASMAwH!-9Ec7c_B7sD}&;t;Eld7~<}cAH{E3?tM8n1|qu
z>9`Nlsn6{uT(MKR9TXzS9eJso`X`KkxSq^761%FBcTSgXOVuGK_+4L~bc7M}QYE9R
zj1ieVKe4|&#`9@1;A2akw<V7S|6m-#4Iu9+5LJ_y9B}-DQz0cC+T-4UU!PWhn^gHK
z@^@Emit@qAyyqoj15~B!-6;9E@OnmDBE`bc_Duf0V@QcI8G3-je0g@Cz8zG|DOq0x
zQ)K_yVQJDA;kN?!JbV&>WGnVb8+C}Gm7b7iC&}s4KvT*}E1w}LkpQ1oGuRM&+eX+2
zY5i>iZyGWE2=W^L^ue%N^8DFaS7p7Bbc&)bV2!D%*PE`fEEk??$x*6;+Q6GwW=dd<
zD{sI<znB_~6ejtjIWBI(tWz!Jz-!yS$gS6FFhJ%~6qyCloL%H8dB?iH_q-p%x(~{i
z7wy|I%4#iGR(4gRS|@X#EgTG_(v-_j9Wvo1KXU(yz%bD`8HDvVHn~%xWd2M_6vU{a
zPn<qoulGeySTkl0OD*-zS}x2LbE;-=EvNH{&;?eYz(;}oOPOF+y8PexcEdUzX$j?l
z?qp$_UgYlNhU2Zpkt%l}-hK{SQd#r_9|Bm6X0KmiWFlv8WaNu&w__n6>OJ*z2Xr32
zqb#HVM=jNXgQ80Okz;M9QjEgb{FxC=lt}!fT}XNx#p3T@r?u@6T=WDOr!Rl>dOEW$
zX^yPkavvK3Z2L#AJANSrhKc>e{p23K@X)vwkl?pDUjHzxI`-je8#Sf<myZ?f^)igJ
z9}nlP1!~-is07W)Ji9}s`z7#>*9ZhkV7zu7QFMN3x?1`-hlyXH%CzC=ne%uOvG;Nz
zr)t_SJ+*qwB*vGV9wCZA_epyIOFT&;d>C%}J6oF(d<`$>50Z~v*jv@@1@eThMNxu|
zkg_No%4#cId*wLJA@PnTdUr^78plPMj35ROWp;ff_tJ#kjIkWLK1J@UL-3d+&l`C~
z@VBDK*tek|1xRU?`JyZ73wx<)tzQd8>qqw2qaXUQ7Gzy0QFL3LHdWt=JI|-d7!T7@
zi>1KHcN_fuQ?yYDh96Z2N2feB(tfOD`8MZOiI)+XeScolEcbeijO7il3B+z=pPnu5
z__D1brq2rJur@3AYQEl8*OLbS*o#^20(dJX3@lzynsU%fnnuI5=DX-UP84>df4@co
z98%-!JPZ}RdFEGfAq}Irj>i>i|5Ye5$|me3!(}n~DgyaKQshQok=-sqkSRtRN8DZa
z`i1hpCCP92TNzSz{o+z!Wj6g^6hp}<bzp<jDhZB>^oDAM*vETcX9TSVH`u;Lu?=Es
zjxsVSVeMY^GS~SYgj2Y34Xy$wvp+eOh(#N8fBwy!E7aS-H*-^G_Z%>HZ+6XLnT;L)
zum$`pZ(B4wzp%T?FQ*sf+u<MO$}jYXzOVxc)ce1uwkH&mWiJSFjOAV`O=j^DWiVAT
zp`xcOiRr-vC5h0+gJ-;j_R{2&Px}IO^XVOZL}1_5nL*n_F9_^((VT6+z9CNh9v{0)
z;metP9O!KKE0GbmALHL3SPv485a`YIfK^3678J^V(ql3pn;EM*XE7)EgAg+Ho`C|i
z>S$Qw4+Oz3^sp$^T0{6x&N+9Igf$gfqzPpR!Yo9Qjxyl1Yl2@FrH7?P!Yc<S$lK(o
zm-)wNkt7730cXUnCln&uV6F{g^NFPf;bAOC%V+zt?7A9CvsTN@jr?1yfzVU_Ez46a
zfi)FK!H>?pF~4&=b^ax}hCwJ>;x2RfH)!39lxPFccJGhg6yFEx9rtE8szLRT9os%S
znSW~;61VDxw~^VuC=!HM*O~t{g$Xn@=0!ec80)zHD29b7VP)!e?#$FzBu)!^kSj(a
zR!^j)0*q})D+tXB7J7Hg<q;<StJLk@Y`DVdw0Rn)_J~TW3pJBv+~<p5tlJkmxMQ1M
zwD8FG--}`X_hN!8qP+I}o}?Vfkgt!U+Ink?#@PvwJipF$rG>p392eN?5YZxtXSzFQ
zc>Mv<gr)@*ppiqUtIu3v{fXLtB_KS2m2xU-1e1ezwNl^5CN?QfW#I)xbA)Go+wo-t
z`6J&C!msFIwG{~5{A~yF+U<<QJ=hcbefu63ZPZFLhZqqunudHu<?|{MsKs-ktSd3P
ziW0{=?$+q=__x>w{~J9}7FPemR3lyyUL^*cW4r1<y4N4Z?Gz8GGkEF=39JaYeh^zy
zCPjDN4DO(Kl{!^vKe9yi*Pf1f|GyR-pHvpL585LsQ*vUw7>w{Xgv1bXKAB`!CQ(k-
z7Cz9|t1iLRy5z&8lI92OqBP%ogrUkU9Q|hn5l-k?ysWs;^X*1S<@!k%o|O$HF!8^A
z8%Ui)_MllxgQ}|zmCWFFkg3S;gKy_k4qhAX_fytb%$`T{FvqCz7iCN2i&7=%5LVYg
zp2lRp)yNl(D-|jzqEchP<}CZ|;HPe&hzs8(SCoTy61+YTb@PS4!vbDh8Tk6o4T0kd
zG>coZ_4ua}u>w4}2UcX~TYmbC(MEAYr7;nYornEFtsJc`*tAMcsS>m`H6FcJL}v{O
zs-RsnAQ9uHPXJjB*!&Sr$ftz~xNSbx?zT_^fbyeFE3}Z>7i^yG)u0xEHAiO+tKIwl
zX#1_lZZvOyN@n7_>5}g_`gm+VIUrWwJ%UM5xaiA+Y4=#X?cU)ihGPF%jzIyHOwybF
zr+KW-#Ik<59bNMQt{8<}Md(fm<~D1X0rw_wzArhnL>;UB2i$g)dP|+V%_^(*m9lpy
z1C^O6+_JE8#rj>#L0#OI`E75!ew>T*>2o6uUwkGt*G*?{NRR)Q*OmGmihj|a;o3Yc
zln!LY|0R>tZ9i{ZiUwbnbu!c2=VR1o#pfl6xi^DbO=Kn|A_j5(>8$$@_mJ{eqkbK}
zcFO@8oJ}6ZFkj0SDC@w<CWjW(Sa+aM2145fEINT$#s6=L%JpfuPPB_4H-7gyX2ffJ
zG+)>%`5CD%+r%QQ)$C~(rO>pCImwqbsB>4{sivN{Q-`fP|NBO$k;Gf@MQVA;ai@PC
z534u^GEx|5lMtAjN#kdTv7z;&(>uMFu_3Aik8$QNd1%VP247Ta+Ztm!h%%zS_D_n(
z&T?^KhPeA=3LxI`$HD%1SUZ#bIw5lo9hs``vA2uc=H20a-!FLX|9f9F_IoqC=xlM=
z0T~7zZ3XzA^r?jP8z7pYTD>K!O&Z>_@-jGhVA#UYPJa}0Voc8pF0>1F$fYmvCI8z0
z`BgX{yv8OtA=TBIRqTa{eo4b$%yfb;rTu!kzI37%^3RU)dmbQ7Jc;teHT=#EaH64P
zZdIPI90?z*nkeq=)caps8t)C#H#0}6kSh?5HRdNnF=YPD?w?u0W2x;}LC?wgn;x<K
zG?soHZ;JivEz*wh$8W@Zs#?jpshh8zor1M>j4HFp6O28RPqUkKK6S?Hu10Q&st!FA
zWvz9^)#dyLUdmT*MHCZHV_Oc39R5BTv3-k_7*JRxGiqCTs>HUXus;gdlm`#;{m;g8
zXC>MoJvVC|Ka+Xu60<2eWTEBj=c0L^{kCJzf`EYsyl?o=Ylb_rrxG;ruLv%$pr@p$
z+YjiJBW2+DZ>90fpK2?M0<O}5{m0t<@TJmHT30`(U{(Xl9rkqVIBbyg{w$9fw*-F4
z*dLFEKH>K~%KxilpIBv+IV-$E>ExLYE6(;4KYC573*wrF3HhL{XT2Assd0B0wkD#e
zYEz##mznqJJ6+38e148?6eSarQ!@(Wl&agY6aRM>u-B(+rmhgI;uYZa5i*v-{l^2w
zgzc}y4qFkzyM5^&q(sVExz~kb5)@}D0luc4^iviPdtmBIXrnRn`D67ACnSjk_alA|
zL8CODb8CM$<Eo5`21Rpb$N|LaMCoNLEA4xHx8|_*`7US-BNNk$=fh%r8UR$$>Q~K<
zVod`N<t|ELbEG+(e~15Wt>8zR-h@1`cgB8rTH9O44QJG{{Y&Dj#^@cEihP60)7D-;
z={8+MnzCV)8g>d9y-)4Mh;8y;Z`{Gqc>80pOTZ=lW4OCSmxAA8-oL|ps@+=~GXeD<
zkc`k)NG1m@@&(Grr6?oaw)^DW?EV{yhaSbEqeq`7OSI^Qd3<eIQba^}O1@i&vfx63
zii)zy_w~!7zK++cp0{v^QZlOhfPj;L9ms!?>e;K015w-S|E>JAVXvX~RoMfcqP)JW
z*E+@$535MCo3&-GTBd9CJx4;EQ?qd9CAw@pI8cvC3CwEoFDwaVg#e{6?wdc~yhL9x
zSZF{=9ps{RN6IZlJ7iyUn;{`nTE(llHt}MV$|YYzVq=Ion}b>Lv0x7wRs;CyXfa`I
zAUv{FV~2(Zg??Zix@=2CA{z87Rd2y4awEC(t|pR-KsK2st2yHFK+s%J5NXoTO1HrL
zO0hPVLMnK^A;7H=vh?TLncpt(n@#tN)cRNd4r|-`OnUoq2q6-F!wK}ia&Xfb^^Y<2
zSg~5=mUUn{b3|+3r{-Lh)b-Kp){<i~ySkvhzJ+3GsaR?hgUeJ3p>bD~TXc^7zk?4w
zu<;R=zRv|hhg1TQ4H!(_I}wKz71u04mblahO`(ym`bLwpLD-6=UAMCp)s<=vR6q)f
znl<w~P(Mnhi*Y<)PoXUKC;W$WPLE`Ai88GB!+V6$IYnNNEw<RUnzckS*|S`{zK)Ro
zPKn>xUayY1j<PV0jPU{&Q}xK=XAhi)G#oy*j_C8rcY!Qu{>@|mb1ElsG;C*M!I*j_
zd*HItc@}!ymSBcG(SpSmASuX<rgHa?XjM>zQSF>L1d~yuc3|*RN=-GiOjVnjXji95
zy`;4jJi0PuB($dJJGr8=>Wt1T33|nt+;>4@uP!_0m$_nu2bv=#6OynV@WVbF++2|v
zxxHV{jBNX}?=t<W<1<qEBkrxaN$7MTq86NArt#T&zG$FkLQ8dx?MPRzBuONNa!;D9
zp4iwZ43KiQ(0s@%nEhb-2{5-=nV18Iv^@9<y(JnB4i2nO^b3nCUw^|wQ8!H2%4xdd
zX`?}?2WJlZcUaI+HgLx9^dG>I<qo=ay`Wb^CCUD!Dn=VlqVN)nT|ceN&bLBPHc{6V
z#&tw-!Z9~rg0YkO53b`qHx3vC?IrRt{z>)BEnz<QF%Ed}AgH>2Uva*wO1vwZ;d{HX
zuVxy<^xH89==&+yhf+cOPsSZExET>Cwihh9cz+<FzzL95<!tn%&F`7N@>yulF)kyw
zmVPQDg`T}xD7~aWi^b(tOw@r9ezEQst!?hXGYuAKQwh!_r;sR=YxCZ11?-MyUk$N-
z278EkvcYo!)j!}Y<$vlx8<GmtX8;r^owa62f)zj;b$Q7Q;DUq*8(lV|07jP3eu~_J
z7{U}V8LIl~Z<igS2K^eh%dj#49ZL80%?Lm(THQeb+$lX&9Lec=DKD4fcB3euU<lam
zGqudMF<Xa*4%t17ys~Xe3;)}1EuTA|(t@S{zJ=OgY6g<U+PKR%=A*ujGG?FmeAR(%
zx%!~^gN8ajVKL`x_YE1iYSxuLXkLFvor|##9RW%uLkE4~Z}n+<C?xO?!3tX4zX{cj
zD9)!RC9|?b-K1Uqq0O@CSof%`&4aimXEwV%&OTk`u*rb%JkM5I-ZO4a@fdRg7zlY`
zI<pPkrd=yry~0Y`Z>eE;E8pZX(2~#KL}FycIDl_xm8he>VOv4=r#}xyE7D|?Zuag;
z)ViXOT*2nbHTZ<b&TJ^_JT2YNUo<4!)cw)>^l+g77TXI$Gvg}&<`i;6hfsYh(;3ip
zcXHu0rBV3u+e71gx>Jq#&B@v}p!ocxv;4IFH0b=z{{qD7uK<7;ydL0(x&05&tggC)
z9THD?x_Q-nG4jvidHNBjyzBhSH!?tZQrqM1xcunqkk7gW&~#p6QXCda1p-QOz!iYA
znDPH0UGD<me}7$G!+$@8o=?mCVoGz-rN&G<T{HaB;@>%z^Ty1;5@u}mtLKyKN_z-E
z=ib#Hz(M(s!ya<6_=_DnmtAzFh+7%{9Q*T`XMPEM_*wt(`Iv!{Vz}H#u@ca;dHoM|
zN)o_uk<hFV{Qq;lT-!P-Yy{hy0VYF-!>2Fn;XYCKK!Kx=3mr~Zn$z@u0c0OwKc+r?
zvNu`9kqp23@O|Z~_f6p(YQpvxQ1~`k%04xF`hU<|jet=D;GXfy!34dpNi%dLsBe^d
z|DTOO>6A`VgtBFu4RB$~{M>1#>%3Lq2k;hoEBZ!80^!$bZ$jI*07F0uonX-E?|q;~
zOS0VQDD$DPMO0UAq)JH@8Ro(vUb%^#SraZFPf5?2bOQ$~()01%&V;^=!UIU*uJ=8d
znP1^dc#uq)e`&jV(HENo-Cy<+)UE?N#d(9RS&+aa_%RJ3e`lo=o>Bkp=!#kP>HYs|
zuYUlzgU=BoOPx2_J+fYbyllZ~u@lSI{@bh{Uph_HoP|qWA{1V1gnla!x9;+o`IBVv
z!ZK`*tDd2hUwa3gJ&|s%#i3JuHyQiEX=B(+xBL1JK#d6A{B8;ly}GUVQolr_fNkF7
zyFLY&c#q#$nVNq37Z7sYr(J;degiPqciVKt4LZGr{|;>{0a$=Lug^?Fe{Mj+&H*CK
zJL?`Sv1*SaYHFGfp6g{_;G)ML08|c*n7pUd_R0W5$k)~ZlH*^~uWb71^+x{5(xD;$
zD@zXpOe}U4+hs{~lFtEM{44Hi+s+0-{9uW|MS;{K>(E^m=-w0Wo+Ch)1*qWZW=j!t
zK6y2tydKLPKu2c)H^YyAntyQ-`Fw^j`y;#&!dE99|Erh>UrzG>1f0%F)bt(4_tNY(
zjt!GN^t07EPfu}Y-xX2O)&jMs(}L`l$Hk%%Cyf;2-7}-qZ_fdcDV>DYd0{H2gCy@(
zaUd5idA<E8uMV@9LxUP>Kn{Is6I2>WN3A1qFbC3%+x=Yx^D{40yc-Vi(<2PzG)Hc1
zg$$urIRWSZj+BJ<o4vz*Iyv{YR$G%Z`hs8ACp&{wTwGij-yAo}zx$XKwO=1CkBN<<
zp5-J`t@U_R1lEVm=aP!H1n}|%{y1K0X{)TSuP?I5xv94@f}zRTI{uAP@==*EefIP)
zQ_#n}DV-TSaWHLDP68MK7@$m0Zonb{l)sc}U2h9;Q8E5e_<)0R{hgSDkZzGigljhC
zW#Dmh&u{PvfDBp!=wKiJiMY=JQk=qpuqF%uL%n?d{ciPhZ2d>uu_K-D>+;nH(-!#V
zu-7J24h<xy3+2WMEi}1%rOWT~Z@-aVp^lb58j4hBGE`c2+0)?~0|cYk0-4T0TG_TU
z)2r-!tIPB(8dU}giwy=Lm&rLLJet&oBD;XIdAr}Pw?`CYNR)cFbHoHovz2_P4+}cx
zE5l;;N8SvS`ZU0H84<5-&cu60qb<iZb<-gv9YX)Ph9v~L^-M8WNO-TUpt_t#DRhX7
z550Uikp#gz?nwkt6G{-I?jQ5m+zaB}Hfa}ImzYXBDg>#Mlxg4ZPAmQF)41CxsWp0N
z3U*U>GEQpMroG(tm?;o->C=2RB^6XzZF5%l$x?#r$>xC{v58UGKjE>%8X!DA&URWZ
zUThC%4R>krN=22-RlZcYl@(HvZudH-ysroB;&f}R<~_k9^TssTKaLyxXZ}#sh_^gj
zch}oIt;RtGZdWTnZp&Ue+#dq)NrR1o%gb78!DQK^dNZ3zY5$$C!3m~x()Ng#Np$NU
zmUTG2OhPLg^9A%QORda#RiTqn(G<VNNp!l8^}|eZt^Ayf1Dc$NjtUQ)rf`Le?C3%k
z!TmVo&P`7ooI?`?)Bphu{rp+@%BORPgN?7RGU4Qnm5Bv#>Yc&K3i14b+44B%O-y7g
z!y~1Bl^`Ul&vpR-Yqw<K=sb+Fw`EZ)x0StF6loJ=R}ME&uBF<SWqZt&r`=G%SsMOW
z)17wpO-F6#=+d&N`|%M0f%bzdplnt*#o^($XhFECGS*gxc*eWQj18JBEmDrWjYRza
z!eG=nlABu>N@`c{1l6p=PeA~$j>GR&{+}MX=N{_5X{(Y-*w^L&ENxu$^-O+{<pibE
zf?Q$ei@$vX*f(O*5%(N6?>Czt0E}8)J!1qAMG<$OGzU?0YDB?5KI)pjTkm?l|MG`N
zoKF&k)DS+aqTbibOZ)l4^lQ=Dx;i#OdH2r$p~rlEQ7ud<{G{DXy}{W;W<-<v?YEk)
zvZSXUeR>*ebQKQ`;`P^+V)RcX+d$J>s2KAH<!_W1xxBf7+@eG<HqowJMXJjNA>tno
zvC@BKg6K+vC=yOMsm^!5l^~jX3(#1pbZ6T}GN>Z>qsZ`Ljg5A-rd_>INGG3gkw5AR
zJ4gUAyXkjk1BmWj4`!Op{Fj_YiQKH0YXJ@=!&D*8I&gj1bjS|`(i6=@y0w<IMh9_E
zfCKg}N%!8vGw}<6+&o!nA!(IveYR2UWTvjJA7hZ(aYREs4}V0yCoUq=KkUo$YTBX=
z0(!FYC1Pt9pln7vf{C|~09xng4UYe!Tt&p?6yQH8FA#oi`yMcah^oHjv&aMxX2Ad%
z>Yqs?6!9(g*+xT!+9%>7YlT$Z1K!AWkeqW4b|Y!-OXnjTz|-x$`n0?p7=CsHId#UL
zKHi6aqXsttK9JQ8<E!6YU3}{=`lbPft^mH)0QQe4;qAbTpuAw`qeL(18(<g%GWKp{
zgaKH2^2s3|+ZPBH`H+eV<2Ib-V;fqwYv?C%gDyNK%O}gK)-7r%nkz=pdhJjsH)=<L
zgPp?`Pgx{}0-H1o>N@6#f^rT%PR6Sl<n+!!U!_k<&%Yl|w;!n?p0a6tInladijr#x
zTQ|v5TW@y%Qm4(6u=S5GF{=>%kn{KZs_7R1Rbi+@t3oC5Gv?nsv+<<I3WIwLVTUO{
zJU)?N8PHcM?h<NkvswTCw_Z-N7r?QUu>7R|iX?Qe;SnIjkHK?LbL~s{U$Tau$j?jR
zx~{D~j>3qF(l%VycY-Xh;5y28ciUMma=(reasFIu)lil(*7RYO7YG0bqySwn)5F^+
z+@*G<*O$>*Zo))Aw4^3Pn}`1IEZ{!{FPS5I+pzksYMo{0xBpe}3U-Ou0%>*ocax5+
z&O;NB%ySCFw;TR;<H4s3!*J?4?-qAT6j$UfV%~;deK-sWI1>ql+T2YUOlu+u&bls2
zfaT9m05b#_XkQ%7mTQLo6d2Hy_1O8k`S+>}5VR|Mn$^syg`Tf|7*ujUrg7l5VI?Q2
zvZN&{{xhURDN)L(L+Z1j|3aaW&fNHQ&^s5|?D|^hS|hiK74xqSSBlU4%^RGf{6Ra~
z-I@fR4g!X1=*wGq7I}SDVLo*$Rnc3EJ5QRnh!<v_-j~I_cK6BVQizcW%vc(RMZacc
zyt<L5{b{(ovg#dW=Hvbv&7I;iq#OkMqEk(BTKz(P$;R6$ClgeU(ws{2fy${9Skj>e
zUA`Oq5tEs_&cy|`Es(=cic^909P0OFL$(4Lf)!(~M7$4i5HH?I(~edT9n|?JuJ?Qv
zA1|^!rX_dk!<A(Xtx?MzPOGsli7W_7>A>#*cW6fLe!}8zsO`Kl;I{9cGih(%<E`w2
zsvob*`8R`Mefvw1-Re=HSiMJS6V3|a%mEHe-Ik0E>e2R(rFW~A`vUkfR>zPnSg*;F
zUL>HRa)Vadi0aH5<Qs@|sK|<_uuX9R^WtFL3O0x5kKxZmtFo2B=SDn~YS(=fYLr57
z8Z2YWxTQP+>0WkQF4_jN1n(R#pIE`b3DcmPzW52FQZpYtQ*GXQEQsUNoY7bvlKT|K
zVs-+2fxm1ZPBIYhTl$yt?}s*8;{E#Jx0s)6+BszMD^syHV(nhjsx$-**+M{#Jk^U!
z;*^vUu#qs^9(oS?7ct^T6!ks7i|&Wy2NRLwM~^o11AbR-x7S(^9Y!g(h}sab$hWMr
zN!X9|cD_dDr7*T*F5iNqY?$_jcE?=nu#qShmxV3Lc$avg5%!&S4#`&Uag$eOIpN~J
zr-J{iX!D8eXKo8_{0jbr2Tt?4kz~|AfjH-XlU*A+$cb}G=O2oSb240sVd`p*?7LSj
zYwhk!iwsx`Dt{cI7__B3v!}wWM#LZwChPtgJ_MvSn#K1cW*NyWl3HG24q+_C!F_ZA
zh{vS9KPL>jXX*Ff^}j*Gj=*2I!oa9;$tuclOkc`iko^4qX>W8$ijw%?vqn4oV(s%b
zyyNIVL!`u^z%ZX)_ZE9Zy*3l;^g&-9R>d?g)y(H6+(J!5-1z8g4&K>v?TS7;I{*R^
zN<bLBZpxe!FD~$G)n0&hOEc0Ug2AN;x2lX(c4K6JvQvcM-ch2qyNZicFh_4tS#iVr
zv^}Pu&E8?kWJ5D)Mi`}t+XJ|%6RxN`16`xeXwuFB6Y%;iZM7luQ4XbW1y~jGrrzjU
zS`>!g^W#J=drWJY61IhsgHmyzN#%m~7$3V`oe6!Y4RkWEmo<e)X3>A%CRZFWJSV3l
zAO_V=UN>1VhJJI&>#LARUh8A4XYJiV?2{|XqVueBwi6bL*ab#@-xb4GJ2829t*6U0
zN$7ohIU7t3<9P$f&_NTXxK^^yhqgm7;F>_q%h|2kVbuPsp1XYwbQ27}szyjLm3K!|
zufa<v7xqn#-{h}*WH<sPiOIG-Sr5e%`RFx|SV+w`p*N<BU=SYPepX9>{=&=Rg|Itc
z#<tQ5CfNCh;JQnrz{B3?X*IojajiD002k(W*DvR)0;{YaW99g)`x@E5`V8V`u5P+I
zFLqaglOzCl7G{VHm!|$lD27c2)76`<NsN7QMkSVC;e}HL;(^IN1ymK~gU=ljH-D4O
zahg0S3mDUze^E*nuS}f<H4X^-CpKe^5fKqF`LxJ`pVV&lxc^~t3?3+(`h;shHtvf5
zq5T3$4P34WYLkTL5wXeE`JuL)8NaNN=Qa&E`KQqubmG_faLA8A5g`QLzRn7EpAV^2
zV*CbCkT|l3@9qSnhG!zYg25^*&E<tBpH0<)r=4)WuXaNy3W_})m-9`b=>Eyr811){
z7g^$Cks3AdQyH2ZStf5nTx6e6A59M{MteO`KX5isc8+zJSYXSf75!Iz%uWIEn-$de
z$8b;v*;*MTEsY;RD!yFr_?cyBuFXskAADs|+zg0yD!PDU)yfqsYhw$BGQl$*lF#oa
zy|@x7CFWBv*J8=u9FW|*^legn_LWF#LsLQNv55Y?I5+|hKXDFta}Ux?wcias_VFxl
z$aJLnBZCJw$|hGheX7oa3|2OY2ggac&9tO24e*CAwx?qovU`1!jgLszk|DtUtIy_F
z+2Os}=MG#}+nx0tA&;bDODj$9kwq38x*DHU(u`_i2W}q}ScxXJ0wqj;4ob>M7NEri
zaDZd<d(*8g6@gu|_30x8|0f?n4CZjMUOAFE3hiUUF}`rmXjXK$)a@60!%)Q_h`);W
zt6bzC8wKj@Nxu@kA0g>(c(%~!eBg*4>L79^ud;Fa@by(}OytHd9ui~t%Pbs~PxbBK
zn$ga{9!Nemz(?T^)ZXuX$)dQ_qmq9vczn0c+Nui%^u1uxm?2Ef5=<Q^#8v~k*Th)O
zv9fr%rPeo*|L93P!9^zssig|`ATtf#_GyBWR70m;H|vKYd62<_?$o=?CMO9o`^GKn
zfeh}RgQ6R0k$~#0&1<GOdMSWtZUx`FoPj~B&4$Z4tDnZe;rb&1H^{~9JRmzvg7i7S
zszm=2S0us1?jz;1J<BNG_lust5n$2W%QM*xZu-5h8S1Y3wIhb39Qg6hq<^Pb9yHbN
zpc((sA(K-<Tkx|Z$z-ur8TCAq`$d58yw_`+xNJh|H+IS_X<hJ8m9d)IB=2?8_A~ha
zk$h1N!E_?|sLvrq?!UUnt2<N`FE0r$m&T&+(^0K`N|8XES0bW9yRUliZoJWXGqzBF
z3|E<)E>o{a9))%=BXBSAARNmn913y5QBggzgUN#yqB|^FWurm`T$J{^E<@i2P@9TK
zJ{<{2uQ{99Wri>VNQ~q@v#lVKV+W}WLs)F{uzh=6gHX@HTSIWM#W_;*mY5tuxaVA*
z0vxQu9E`ofCK`82;9dRjr+|E4A28b+ZU)t3gmWd$t>k|{?}-&ripSlD3iK`WYI*K@
zY>@Y}NEJOz{|@q%(nL&>4W$qcx^tle*8!}&MfhWc{wC@a<WzWy)NL8t$~HgR82vSR
z1Wj?HUZ{1&Wx46SaXkLo{Faf3^P(M*q+eFTZf<CUhe5e#=4%(;w1WXAy0n)QL<h=T
z(3a@yRh8&r*u4cbW#z5(<IZ#^$l*txGYJH+18dWlGh7}IvDyXtTDMX@J(m@B71+di
z-Mc>s2UGhpWxn<TSFI2hmEN5bm<9H2*hzs*^xq<@_(^-R$}Q~2XVKS;*Eck!n`5q<
z`};Umpw5rM+MgId5VAgd<yDC1(+`QshJ3g+gZ|V*^jZwOwR>!t#N4@oNO`a)b-}fW
zmx;qe#A0MIDl+Ti<10F8lP4N|QXw&3QnTeCLe3){dEC(r$*I|p+zvx7ZK{`-Zfhuo
zrmeV3NGCZ2JU7_sC{a0uy3F`APH^~JVKc2!9^{XmJ2LI4sIlW84R)k^CffM2KviP2
z&OVxsFJu-|lkiWqK)b>XH1%Z{pJdd85<u0f8!c~S)i@;;@=cKh%F1iBDd=RbE`l!x
zecWNJ{`^d1<hjZj#hF~#!uW>HVZ$G)xE;6})MFW$7sXhURkKv1CE$Pegfwgob~B)j
za$eVQkpq?PLrIU>rqUy6>&5K@1g8ACxA7{gW`cvc$gr#CKH(9jAmx4QKNXX{Qm~@d
zCluG7hAP$nCPz^A8$KlXqw`L09YDLu=s&yuWe^v`8+H0Yl-4!PMfr}r4U0F-s@%k7
z)w%22in{tAma_vcUUkQI+=N-kLdvBXG*y5%C&o<!D_%`XxI4%CmQtu0EoXa`7aG_P
zF_Xwc)uVVco^rV%7qt_S?g=%wo+n7QawTt(1ig*7(*&grW-vDwgWWADJ08WWt(+1~
zdrx)VUvO$vMSR0^m8ZQ%tJ`BV1+xQOwvQ7$ybT<Izk|8079ZY}TO>08RoR_ftKBN@
zVPg_ZSB_0~k>Ahd)qlQf6SgP#OQ^g#BB_mct~ketOV%ii9P56hQTglg{W+EkQZYPu
zAHhT@tA~2b$@&*lKPUABD3ii~?NCgrdA^vxRW>RZ)fux@{l>hc)S2px$d2GFttY*N
zm<BHgyBOE+0AkP#+S5W#t5%&8SN^6hm1>>6en!AO+>zxiZAR~^5j@K$;)ptt?_$?#
z_fiK{i7l_VD%G**2I>>OpQLBAY9ueUCI$3qlNh4+dp2u2!U`H2I#hxN??3PSLBiEI
zJ6pOve7Lqo(eMa>tMK20J&Ra1QwmfFFstdg)d#VbR9A`5!&^lg`V#Mz8szFmpTQ{>
z#MeEe4A0*!QRe8^@iT2$#Y)6&V)z1;0tSLIn2N7E-jS8er!}COEL=JV1J3vAeHR7g
zcuA`5o>Hbma?-CY)Gf`*wTfKv;R^Txl<Hu;NlhAKIbDvA0Xq0feoH(foNmLFZJ|Ep
zKSah#)Sq{fxlQnfnENRG;1=c2nGyo73+x>fa<9lgkYLShl-VDWteM%?WK7R9&ZjA>
z|1!lWdCe9*@xtE5@f1&4i*n5CZ!~Q?RpS;U)f4?wFFqSSlOH`Pzo0)euDKLZai}$g
z2)K|veCO%Iw|)2~{7n#0Z_QI#-q!#wM5C{_Bw&t@^eIh4S}n-<MlReY<xewf{msbN
z=1x2|L+WTi%hl9R1$2wwDkLNxOiz|_Sep(m17#=mw;Jt=tnnD9lJ&4`##S=^xQvUr
zjR&tgQWf?-c{-+0?l<VZ?n{05<B1tQ?jzzlxP}=T4{ngYC`RZ{T)bL%><~MS-J|-u
z5!UV$$!L+UDufpYlum<?lJw%rC-w26lWJ?c?fbsj9R^Ymw>_x4hF-gYvw^>$?z=7C
zM|CyS6}kz1cT^NvgyXk;Q_V)|^YtL>_sIA-igmL1N}EtkIlk>`a*Jj`Uj)?{ES|hm
zvpVRBSTwJ;p&UZ%xvaJ->4ni$j8amKvmA?xRF*a(Bi8=qN8*#ONh_MB_i|PHdkXqW
z)NK0<4l#p6&tiJE!IH$}2eAEULJo<po>85TI4`2gAVL<tzO!@cb<x6$vO`iqTQ;$;
zI@y_`n5}?}D?`9=6@=&VhCioinkT4pqpLa*t#mNjDTORnm@Me5TJJ9xKg*5O<0d-l
zQa?6EnXy`?bWz^h4>NA^A47}cL@gl+mDSlV_qlGW%wAb6hka<$_;~qY9I<Hd;y~d0
z7i7BI<f}>bq&1(4{=ob`JgFbZZzZ1J6QbWbZAJbtZ`^fz=0|~EfIdR-S0;m}JBB7a
zNhG-^mV^9b(1N(0mKnz}zIKR^awMrTq%U7F_dBNBv_i4*x$<(m=uGAnQp$5zT6Qzx
z|IPyHd(+W21O$1hq+dw1gPv)2Ge3<WS~%mRZa>v5$4yg?hy5I57b7XCzw^nZx>``t
zW+gAF;_8Uts)$oT3_VxW#~K^N<GIq!muyM>TE?lO{mf75^+ATy-q*qP4B_v4`Elp-
zo7|$-+%;d?Z?c8B%}YYxduo}<b_b9IDMgF@3jX6bu+M2S+7=seV1=E`cW#5b^zOY&
zg1wgl6|LkqWqM;@RQTKjR)pG|(2~+Eb4wBEoT<ryGiJ+~4o<aQ5V_wstAU7v8_#0b
z*;VmA;<mfY1H7V4dfd^{cgCtDd;*8!@5v}h{T-@ibYRL0W7j;)Khp?H-n6pMRgFAY
z8MghdM`ZD2cPO_k)QC-TiV^WN0Ng?Mt~Iz>JjjW+K8rHp3s6W(?jsUmyoeF{9`bW6
z!pq2I>V=_E&s_&l+BgKV$$%&Z3cj64w{M3a+Sp9e%%=Up2_($<AOeNRAKax?XvOOC
zMd0kOMV4WKi{+M}AAMSYzf0|0og}naMR{8RA4~#%Qu1>TjRFKQW2*LUo5DG`qwwJ1
z{ga8yy76ty>lf?M0qeXHVph^yM6f-%O{tkDTbd}LbWeR}0D(-er9;}6JC;4Zh%Aju
zZ%heF(5Fs^ZRoKtR8vfSOuAYF-CL6$cX~dK{!>(ZGRi5idP-Vm&4q0d(}#E+D32f=
z+IgSKIFF@8Wp}h}`)HGPv&E<#Pw%cfb@C0GGB|gvRv8z<Zg6j8pCEbE`Sfn~!r%^$
z1KKc#PAaulm)xO}zQHjnNCiQ|g+&%`1y21vQzPb4zCz>y&J5e^{-|ftm%4@NvrX6N
zqKH?n-<bZSb-8E2S*I^FaP6O^7N2MK2B*IxNMF?nd!APTs@!)}RsBwB*XJ8ox>0}z
z#ZKOyRL$7hp1_&I)0_X3`do%yE@hCp;^f<yxs&pIm>L_`7GTYVoZW5<G&{!TbvCc{
z@O=ms*NmNv&iI8tJl>Ie{R<QzKrwoTWE@tMGFow215w+?M{Rbst&{%E885`7+I**1
z#bd{osMkI8!)U&4Xnue61lA$^2uHQta^Fm-VJw0x>#9}Od0{S5u_<x<^Rq+bQnT<B
z#222>nN3}l-ms0isA#pLn{)ay7Pp!=gifKLiykVyI{Gj!!Rlm9GNJLse&v}#uTUyr
z`Xx1TX1Z;{P#^iK`sy2;tuob&)RO7TXSMMU7^ao`!t6oM6iq(JA`Yo=Va3@@sc7j^
zV&oi@rTv!YdkNgz@=WwlTVA(WwwUqPW22$%nf}C#rrqVBR`q!MV!H-2pFDnXrh>A;
zu4Lp=J+8V{DXK=1HB@nrH$F?klT+aFj`;vHyAY-N_oCx&Q)n%jV(rVD#Nd5@f9=@m
ze&GZqdGac+sy^!vZLQ_7)v?cRbODAE)Y}H{VQKHJgWZ+wK5U5*(I&lV5<vvjIz1M8
z&A~bw^RWD@=Hc=1X>-(A_)noAkT((U*nQ5~l4W-2uJO6vkb6{QU$p|xn)=-Sk|b0$
zXr^U1^0V=QqX3HYDE;^Hh02%w-mVO=#h1h*@GAz&xogdEq68SL(vRVien2&P8sy~6
z>R&OJSIpqbPWPTwwMa6sJw;VrSe@vmV`$A~{2f=0OZmMuS1Siu2zj}c!FIB);O9MY
z_9?_U?ZJy4p>z#8k$vw2l9zhZikoOG)?4qd=xDZGS1~-Fu8+2=eEzvHqS#{p_KD+}
z2Yrv6(zi~G{Z~e5&-<DCky$l0uH*Qzn|KKXBgDk>8lD+m-SIKQIxz1cX71)pZp8yg
z`KngX!f3z{a|~6bj$6G4Y*2ZaIZz{eJI@TQW`@*dJxlNXp!5Jl0hZU;bu$^wtC*|u
zTtxpX)}6KBeoE63&w~GW6sbRf(8haO<%5>A+1}mqY99+*fhTBxPb+tG{cFyHu@0)G
z8>?K{z!eE?zpQ_ka`e^}o!@S;S;N(sJDLmisH`zuK@I%SG4!E6K|5hm6jOKS$&Dhp
zH-SzfXS@yNr<oUOG2fJxsqmSQvwr-O`KPL!+Cr2Sk~N*L&xifQFf~8C$*(1Hq*IP|
z<Ql7KnhYDN+i4h5hMhL?VV|1*j$hDn^YwXL%6>$lS*$^;p$oUCixJqKe?S_G*~h<O
zc`jdF{Anf(uiy#GEl(cj<y*$-65Nopja$$iRS2bAGU*_pu1vk76anr)v<ni;9z}5S
z<%|C&jt&9ptX3V3ADt8tG{Sb|$Hv=N27kFV=bXPs_?Ju8UKN4MQl$fnfz4zK%P6%0
zW8-P!okkRYGp;G`uNC{!QaQ|ouAPex`)?vR4wqa!nN9}<sRZ`%2vU`2#wfD`C||M%
z+u+6>w=nrzg~GRZdoIP`TOPbIT-<5PG0xlH3WIFcj{dmbWhp;KYx)S!tWuvp3j5Se
z+9N<&&v~o-^lGb{0H@NDv9aj$gso%~V=?d5F-9IGihY4#L(N_2j$#c>)Q}6VMV4%s
zQ@_h@N+hJDzacc3O{R|>F#ft^ZGWl$MAN9BCIQ?p>!KI2$ZTs!+r>ae$X_*|vR^9s
zhd?6;O1kYQNs8};QvOC5D`~JR-^xtqA{%rRKI9U^E^`;tZ!<zsK?<q^Y)$%?7%-jm
z9d>k$aXEwYqSx7U`lI}KOrvaZloq~ZC^_``q#*rXKhg?A+>dBsT;Fk_+QiI~CPC!(
zKg$Hz33y}sw*7~k#PIpDyq}eAjqk@gblC^eP~fP>ln!Rml`~fg<n74MdB`7_9j&<T
z*rZTXvYl!>)4ukyHq#oNe`71N&hwo0N$hqwfm>1jB9HfT_2n@s`^1WB)5jN(*U$5E
zg_02sdVmivTj*pD^p=M-JN9G@4BuJwP!AQd3}AzA$=iMH-FJGjdV65xj1kJ<y@eQy
zlTUmdI=@wVo7B{Ga;Hx9$oJ8m&}@NM9$xD4A9k6xdJrN)t{^JCE9KNd-}B2-jRdOc
zKmt=GNA2)MsvOogO3N(fR!0dgb8mtsMNqBQ=5tBjF@bn(pY5%hjp;f>A2sRsS6Q?5
z`GkJr%IcVKlR%CW74e&deUIqJ=-+|b+GC0UY1rVVr6fk(RGDd~NwLB@Ui9mi@;OVn
zoB;I}Tb`$q46iuFA}q>B>==((+XR`_e0@-mic?debS9-Z|4fXLQ`6ezb_PlVwHc}P
zMso1MUZ-v(aH7Z-h%U}_O^w==iDbNy2kSI`=ZR4~x589}z>>Nt>{$GZ9YUi!pDc#w
z+c8hH+EQK0BjQw)VYr!J$zmL-C`5Ad79EjN51hrmzNX3^u$WT5c(%b3_v}GqLZ$^g
z<C8`$x?dTK9(Fkm5EEtIB2^4bClnu)7BvK^8O4@%i`U5AcX3#FS~zJc_Vm_@VcA^R
zJ|)&BS2Nah;|e!c@Nwvoas7Q)`w}Ke{a>T6S&vA-jBoZ$f@k<JmcsDK`OCq6#^i@*
zVvVH5yCwB|<u2;`@4hz-RSytFgs5qMG87niC}JMMeYPz8%G8rsjA%IYH8K}tM26y9
zL1sE+?nlf>VWLaucown^rosmplZ2IfGr41_!ro8K)xU9yGwq$T!f5)G#W_+FRN7w{
ziFAgYH!IllT(qUU;wn{8Z|aoLKg!~{<&kaMc%SRtRq^q$EZ$@mDc46jl4!Dq*zqP%
zkX~K?7t$GSjF-Z!OLV+1i+dL_6E68$GzX4jOY6Hv9i`OS%~H_}2_|DlZnXr4?Y70+
z@JA@gk5qKd_r*P2i>DCpiP97it;i1?-L~ZwJaIa@7+XA$%#e?N9T}O|NHoopzs2;f
zJYm{Iu_ey%YKv=HW)i3g5B#xDee+{6b|I;<M!k!GG)EHorB!QaIXIu<)pG9qd)O-J
z8_a3`{Fw)&(nle<jU;~bFA5J{h4Xtn?~Jb?lZ`w_VHg!_`WpTCV9x8v7uM{jKxZeJ
z!!Xu~XgocAun(X3Eq+o*WS&LeYBg9m+Xd}u)}`}~!Wj+7cG?lnwu2S+y(q#Oi$~JK
z)r6yETv@z7-7IK-dLuc_Mvh8OEL>8|3kj{X9HXGgHW}2AZDrwJcF1uBrTYNMC$mSB
z=!w$`Tn*7dac|9#-jfL*p2_*osvC(d!}L7)q#0qSrtmjN<N^zNRlV6(_)to!rodQ>
z-t+#jkMZ9i?H?KvaHr)k>>_fuWF?;IlYdgUO!ryr0h0~B2b*sjM~&W?;)9N}vCL+9
z{B-2Um0k*2>Zp+CL(pGj@Tllu@Hkf_bkMSWn|S+rcXvM7?IpQKO|~Gi?q$^@p28R&
z@(Vl9+SEY~f(52xl}?NsE)zWR4H6rCqY)mJ6Vu7(coX0QknOuOSVo=;294HQGu2aH
zD~az)lHF&tc{5>~mHSBBI{90kFjpMP%7y)PI(D`f`UZct#rM7<pycs6MM0$uPJD_l
zrHfC6VyWjaC_UsN&n})632`su3>a^OX}lW@%xhQCyMt%+ww|2iY<<I8kwz;6UuPFc
zo?(=@HBt$lMG^3Fm59_TLr3!7;<gNfA8T7=s&z>eBNppvQ-;Yt{eJ-6Kq9}W5{X1Y
zq-3QkZ_e+Hz`L19fjEm9g-xb<Wu9y&v88HZT<J``vqDfZ|7J|0ga+JA<~S(jUiS=~
zr6>sQS7yk~IiW)&#q43oY{5JmnJie|1x3H*X?f%zL`g-wMRvI`upgFgm@mlj!1AE>
z+eIP&u5(_bMD>T?0;hgNa;w$_^j6B!T=>Lirn8L4Z0@6Sn-xL0v+1yESlmWf5Mf84
zhSh`w4J%_Ebn!BUBG?tnSqc^XkD8E3l0dcRdN(WGaNd<}CFBk!l0xEMSF(CPy5c88
zy)wZvi!u+Us#k84M4D7oPE&-@{fgfRBZ|S65OeHMpH{!(x?l%-jsuL^b6NG*J^?;i
z@E6HB5X3H=C=~4<jx;jmKerQ^!gbgb6nAnQt2MBw)p{a|?ZjIucO5AE1n@$+zIQJ9
z^3zGn4(iYHL-wd?O6@gp-bXnW;u*+n*T6!`Es$JV6Xr8wp^{d@vbvn~V}UJ-jA+;6
z_ClI6gd;0N6(AvrNg-iJL;@Wr$sp3E1}5REAhPT!Br}mht9BwEY167ygrAHy*Lh%7
zqG@{FrOyEmYIla;3SW!@)7!NAjOa{I(&F)B+MvVOoT^tAFG%Dl?21`*PT=a)=?0x{
zEeQ7D5dxnC=E_JAq#rjH#N8LucHM(p@1zI@yz`fK6P>2k{sjO}a67}gCdKw#DX^tq
z;S0`>Z*L2NWIqdWw}?9;1evOaBG-H(3KcoAa1M<5$LEw!!E^|-cw}us_D%N)Au3pk
z5uWlOCR3Br1pk1aa;@erO$&2xI7M~RE=_-h%zCNSUQtNaWOWUz+PxDfW9f06Lro@V
zO2v|w)rJ?&J!lk?-gHGtXeOkVU!8g-G8X%xmy_eE5}Vs}8mL#IDw<-u!wfN#2MHyD
z>#@uP-E{x}5CBO;K~x)aez{+9;aM+C4E)JuwcxvoCs}~-{l<HDD`i?hknF@q0V~);
z?U1WKDY5vJ&CJ6*hdt%+AbFr08eHasH}~D9jtEh~gw#WaMilKGozbxjwa9IfsPzsP
z)&$iW?G2^yI;d!>jfAfgHpP)}_)=vo8O?|=T{fu5OIp)fR}xV4@i_BoV#mg%%f0WF
zSh!z78QI}5>St+Z)%613<KTC{G9nBet<*GnF8zCK!5*(1a9F|4x)Hp&!kw$KZi`v*
za};0D%5YBM&sPY8(M)8)BU9ofV6}9JlzZXuF6f5SJQi5epg1$)ob+q)ZzZe@Lp)X#
zLGSYgt?|#D7$u>zh-oeoiOsa;wzwtICb~5<N~bI}BT;A)KccOt{Dd9Zmy^5;Qr5c4
zNVX*P%6=^^yV%llSM2&wqOLkncI5b!aVCQZa=&6Sq8M6m6w)jiu1L4w<XVg^q#EKN
z3mRgN;D55`z%U1kQ;5M~xHUEcmiz2W?~Ay>_qHk2=?~THVq=&uLE#H-YJoH@al(z{
zA);a^U%9j-5hvLo=z^G|Vmapb6QwCJtSM2<_R8_;5cImvSw1t|J_#CDhB_vvj>oMk
zDN2?kLLp`;=0Eai%62)+v}e3^kf&ZHZMsyiObim<dmvQ3vX6_+yoA=?<#h!oC8?pE
zsaGzKdqwaYKRxC}g7peGEzn$DJzc|o7B)|C+t|5hCEF*!vOb7e0L$$qWS6)TmR2WN
z_~U^k2)yNT$szSuTDQgIMW01F>@4u7A)FT6;!G}+iK6{WgES{r#H|r45*b@l9LS7J
z21Q_GSz2R~RI-R%8A}&g%8$SJl?<x?(xHTzoQi>Zr8^)=y<$p<?J4$h7$c(9D+xlF
zdpn|5ztZ7*ZFGr{$%E2*BMwsH#)5G*cVfYoAT-p>NbVB`<e}xe1)t%*0L(+g6kNpJ
zUlbCgp{#H`Tn5Yd4C-J798(L#?{%!Gi`Cq@5MqG{E89t9RK&vkRu)XJTOkSW7X~9j
zQes6@DjAI^S_Tr~i7_|Db@LO~C@x{b4H{UE{h|NxD3R2<D+)=jjn%Y6J~`D7Or7&3
zMYl4D(^6pKgWtGfY>=CD^@<k@QwnjA0m9~bbKg$~GZ1;*CD@bU2?}Ex`1MnM^~zJI
z>Er<U?pF*w4#JDQ1^IU&ryh8SHCPye2#*IA*B!;;zyi)9^t7+QdmYB%1KjO%fPn>v
z{g{9_VR3qW^P%Ydu!PugkgJN-F7CUNkt9L2$$=l1V(W*cko5UkLQqVNODj(5q(Uu^
zh;NlE>qwm~sCc4Y>57f`*zAofj-wUk;$+}^#rulF%9Km>iX%yi=^wntoE)ayt6v#~
zW-=o8iRv6_{g9AJV4UD3*aerU;xU_+m<CUR3&QGk5zD!zWI-(mHPWXL`YXY323JBL
zA<1o_@F^vppmpesQG$_BMUV<6#*0VcO-2gdPb5@~H7w^^n0X8-rsQZ?_JI`pzMq_C
z!AQnZY?H(vqmpnCL?z2LDY+-J^;6QKRf~$OB4V#JF~pgcGHL1+FV?2qrq%s5rnc}d
z?PwR}TD=m290x8j&t;M&cy}Q(-LE(kATpL9<NMGu)MN8pP>xU?v&DW2p@caX8VVu)
z-XY%;Af33Uv7b)^ndQeLgv>*9Vu55D@q8Ac0S0Ms7>{Pb_#(Z+?=mUs?kK{i#fdN_
zK2@34_{xuz6sFo&&GXh5_Q=%Dxb3706Y^Hq5#KIYylC<A9lLioFDvWbwe#`EjcnJZ
z^_;o$cJAJD{#mDJr_KKI+dX^t>G#CYbraQR<?6K?I<#xkvSkY*ocKN2wteTTZ@z!~
zE!WBOx>Dg+uM`(H88J|=MEPEsm~!KO<#Q#<P_NviNAN(1+5Jk;`->)|Ig-nFo>I6i
zFr^_Y+I)tK;LSrtbfrLy2widXDZx3^RTB%R2NveL?=G6e|GVJLt3Sn)3(ek_c|JX`
z#lK>eejy6ev0yl1iSj4%$lt_Oc(>Q6So>jRxJn5o7KMR*nJrBGs<iJFCcTQXoxOYa
z&-n1Oabu79>5nE~dGWchXX@+I49`5_xRD9<O7pj(L}{8Tn7B9JeE0o<gB3(9ih=J{
z@_=~k9lKmTPsJ!Z#!(B*2QKTP8ib&ZkloyP7uTY2TkseGa;(32*gdwqo7piY%9@b?
zf@CdzF5=GkHrn((Ia_$@`ZaqzkixxmG<CUdG+S^nSS5mb<gUV49Nbu7z65>?rg(0F
zKR>0QzY1@Ym=c?iQq5tcDKVnz7poo9Oc&^vlxm94UCO|qo1kXLh_S1bFcLCZY%6Vj
zcNIAmK*@+bxg!hv<$Ly*w`|e8U!R_^U0hsv#>wL=tE==U9IB}N&(kkmc<$*Nw`|?B
zXW#i}pZc3W{$u1(hi}`ybML<WBS#EBe#|KC<gdP-zkb7(g9j_ek2`kIfWDu9`R(GR
zE1?(Au3hU>PafC2tW-S>0zUKHYd^hxGHky+?W0}0_e{R_QrLdsmA4KbHl%Bpj&Hp)
zv%aA|8YRaaJ7V}@gSPG1`SyDsb!guf0-kl+gt!eT5z15lo7%r$@8d=uIrHPsckSLw
zBav>MJDzmnnC&}uz5dROZk;>rD=)9DtDkt{n1TI!LzquLpSyC^y4w1BICS=z6Z7-(
z_Lm=kGk5OX)4f~gGfzFKP3u+%4^_VL_Vn7?dWhnzGbVKH+%YA;+!g_`eo4}-nZOo_
zNcBo_9(|?}BHV}%7K9LlWCS5I6HgQ39^Z2^_-dvtoDEJ$<_{`-!Fgg3hhJTuEbM9p
z4(V%P5xK1umJxeAd0Hq^6A-EgUU17~xNn3|Cw%s}9368P7vJSLa|%<eL<~{>T#0yy
zNEauAv?+`?gW)8}CCWT2yl5>H{i}15b#7Tbx^)I6=-uhF)~?@Fe&AqXQ9<igEw!VK
zjnS80eRsn6F+F>9P40_%#uXM8Tyw<*@bl^HxqJ8S*Ule(%!pPkTbyy~cu=pFtysNe
z>8cy9zT~DGu4rs%ob|~Z?X<RST7&p_;J`uH-oAZTV?(sAz5%wkZr$0ZcaN8*zI)V>
zLvOt9@^jCe`1X4<Ayp9?DL-(aTh~rEUU!*xJEqV4v`wp4<Hn3yv1)DkfkW3_b<wp~
zTmTx@=B?Y{7D1{&T)W|#OO6|L<U8+w2-SA$_MP(<EV=6P^KQQW@*O*OFIlz<jJ*8X
zv>^lg-+Ai~+P7;92I10Pdi9<D{d?bZ!(}I(c-)Iq-_eV+6_r(wKK9hcP221;HKlT;
z7F_|ZDq^dfsCkG&1S5fV9H20!L{vo1uE-=A3PVI933fL!G)_ZVpnqk7g2q4=j6@W^
z;6f~zBDECdMiJ$ONx%wjRt7@8mHyyi%zq`wEmkT4PO9<j10kuU`gNV1CxbAQgw&*Z
z(j~Ibo%F+L8icTvIK*AEreqB5h)aB}0d|p#A7Ki(Tn>HBMv)Y&wK<GMk=r09%`3W}
zn1quxN>)j6@#JeSsjja1=#wx0^3VT1^TKNzHf@a^h&%1QJ7ZSgK0OZ~Hdsj=eE03$
zlf-qX&Ye4K+p){g^70jHh8;E#6fwxB5l0-hZTn9B(Ox~eZ`!=As;auEupnk+`;I+(
z_qAwIR#RP5e(=EXp@ZR^P8~aR?9guOww;jGQAIg+<PotfkLNnbPrG*SJ@>3huw7JC
zv}0FHkcvi?2`3)cvwKWyD<~}J)~z#a3>!MAqM{1u+PULTZ@ZycNl8IG#`5w5AdT%S
z-+$aOBOnt_pLF7tm!4N%eh|!#9(5!H9MG><aZ&N+EjzR{mo;m4#l>e$eQVkton~i^
zD0xVd!Bl0<#G0E(L{&&G6-?JQC?aBToEU#P{|b9D_~q2(|90@FK}cpwepZOI;5eyb
zu1(=QE@DI`I4Avqzi#oK5fDO?&|JgMDTHwpk^}3w%bcR(1#Ib8xaT1<+zXpilpxOm
z^cthg$eMg`l?>lo8xvv+7V&&+L2)`EQ9Z*tF9gmd6i1VWrJsmOSfXhX9nB7lnn7uw
zi1bN?DM|1E-I$G%rdSmvq=FV`Iv1aR25i*UHO%~Y_6x7R^|RZ52)Vm<{f4^w`ibL@
zHwe<KMBOMZDypujH8fjMS=FngD0zM}(8%;hd-d$PdCRuE{JienyR>QDa^t40Wu?t}
z_v{X#iVKTL@-9Q#s;jFBX;oZUm<Xwms_N?LGe7Owvs)w*J7+-u-e-}MzMa45{h6O0
zb;Qsy#~w}M!kju#%FoLyD9Ep_sVT@Wc>lvsSFT<Msu}DbH};rA6;&Wn5#5;TP-SI9
zL&L9r`*$s!`}UXj=-yc?|D8K_7&&72%#Xjg{Gzjn9aNO#6*2U^5~yC8N6Qw8NH;Ep
z*G@nt52oYlY69~9+b8c=##kIkV4SHAy#G{)2TF_t*CRwQsQVytVHL2boOPfWd+d^8
z_tJtD0>&*(CJcsi3d<mmFA+9_L#sfHA%dWrgiym$WH?y_q(bp)SXLISDg?6;QHgP4
zirWqmWGW?LO{N5uM`I0$3ngh-xMjn*sMe89UmnZr{%tbWw9!#&4*1^bHohN}ZrQp$
z8jbddc`Yf0Mfqo*cG9Ay%MTnl00-N)Zgtif6Q6wg<^Fwp>gN>#H8r3{#rD+H)|Qo)
z7}^Fws-~t+-L9&tDlKiMKiaQP&w29~LjrpD>fXL>n;9Q|R$5v*bZ~zNRa;l9-CWSB
z%F3FhS&mS8(+yWV{oHFymaQ5(WB`e2Sbg9Jl&KeAdnXc!4D8>#wl*QFH8w`;>l?uM
zr*r1QmEQf6AA;?--un;^wJ0lv)6}@?>gu-d*xjN<DM)fZzw2hRyxYEW7bs=dU2!3?
z%VEg_EwSnq@AF8ADIbQWGFvG(Q~wyxaFT9W?pH|*Vd>IQxl5<>ry&fOtk@tj`()n=
zZhv;Ro2c*w=ZsxMaK8p?p&BEG8vZq~vj1KM;R-#e^CEf!yf(!2NDT4t(JLek3bzIR
zG!Q|>Uyu<+d~I}_pNa@0sdmI&8dG`{rYSc9YfZwGn9EFYWg^5$(Xcr+aai(<LM<Yr
zxcqtKDCs}yWH(CG$%cylhj>9#QsR-4rXSMuLln?=-h6lFp1pfXTnhYt(X!&A;<jzt
zz|mH%TD5E2X3TLTUw><Qn(^-!E+z4`*tc)r)var1{h|E)yvD{x*cd#p-@?Vq>+9;F
zCp`cArG5JJ(4W?_WsAD{h7B9HcJJB+V%fX@z_x8Wd-d$zwoU66&6_V=vJ8^56(prS
z`+D{4mJ&B5#l^+V%Sz8XYtp;ZKL&+s&fIw)eflMd`-Qb{+qS4E=Bw4v(6D&P3fNe*
zWO<u5txAfEcJJQTwM!?+fCC2)ty#CBF&b^vss#vhi(`vnDPMf`-6ylZf<N1~X|-S>
z#7>XRWx4<W5CBO;K~!pM>t20xdVOp)_XHJ{RWH5z-o@vg(XMUl%&bmHqlB4*;u{l7
z6t*FZs8j{Yj*$_*o5&nmu}Ov~gh*ig7A%vYa9d!3`QgVUfr)7JJ@3AX$CCs|90z$t
za4$hx11pTs%fw#c`xHWctUM(|S>Ufp@|}11^TCQBINiw4!#IkPGOfm~6&njOZ&!*x
zoPdZ7Or+ln=doxO<Q7~5m?N}whe_$C`{`4rPmx1^F1DQDzO<%%q}q201>Eus-!7-2
ziIy(W#vLam5f{<CvC@i{&t&9)R~l9_YOC0K_ULlV$RpmH{_(c$JBy2pdiCgj?UfhC
zrsgGD7c%D9qZcn(`Q_L1^`Y9dZS(a1rtUv*aQwLAS~M@y9~#)d&x^0VGjaUbV~#$2
z&%XUro_VFZrn;=O^z1VyrX{UwmyVmZY%hy@X0>hIvbL_iu&@9QTye?SZ@m4%mva~F
z-m~ZQQ^uDR7ndJ6lzvTwbnn*rh+%`?d}rqQ=bZY%N3&mk?Y)DC4i)6*pEl{lJ$v@H
zY|&!pu03;~c^PD~Gfo*#;tR}!61RBSiqev1CyhI9=0~6R?%D0Ki_U!Q?HRAX^**HV
zic8Lc(=NT}tT*5J;Jf*YXe0s}TtO^J2_UI={`mUTi%3Vv{IxU#Vr{Zo^F_T<oJ4P8
zCpDzG9hsHTwfhwVtfCK*H<nX$|Az<PQX7vrH^$ZcI<J)lhCH-+z2?z9@SxWd4rCA8
z5%<ul+6Kl`&HM3`Ww%*y%2ppuV`tVHEXN^s7O3^RJpKg4-*WQ=PfdnN*TaDYR|!yU
zP)8Q1lVmW@LZVi|nMf~~)UgqUe2{!0+DtIl7Sb$PS#W+Wngu71WSaJ`D}BK<B@E{p
z9H6#F*waHfC$FU>*WMI03g*s~J+#S`$X=MvZ026p(9Vp@#3;sG7&v&yBai;;mdRJP
zY}taiz;u8uvV?#bH}#G8fAXX2G7mY3(fM&1>J<^{&&85L#q@|{Q;cK?ST0Qo5wL`~
zUzzxX+SpOdESR2UbA(?<Gq#{OxKIDj-k+$+s_V+as9fKA|F`|mzI&bXmF}pdNg6jH
zDQw6pVvd<bf(gkD#twwjlac-LQ0UW!!Qa+5Bpx?1S8<yG=w1#dG;$GCf22I$)a<6i
zhXDds`xU~V15%$Xf(%+e-J1niMO91pxSoUUtGi+7ob2QeHZZ(GXf9J-{`pP^t%t`~
zAWN(3=Zy2b4ty|_Rfhl~WvD$|9g}l{-wGu$TDeasuj_841`?JtbPT)pHh8^Cl<20N
z<%SKU#=n5Pd*w>6si_A?Y(>Rw1&yj6qIy*&7gn3wmy!%nujbtY2UO{(UWIrd^-4|Z
zmD7`))i`d@k?G;@g&0?)aS;uNI@GIMpu2(=1fX6q5LK^kdisN3hA+nT7GwyIldf8-
z&4}x-Jq@K8KZSE2=U{;7Gl--M?CpVCAR)55mFoWa-{7p(6uS2@#^t}W#2bq3oJ?I-
z#X6FA#;TU<BV*kHdVCu9suVpQ=m}IW13Wq>;mS-a$3EU+L_q~?bbkhU9Ri+N3Y1;|
z&wTY3fa>+~iR1_1&$Q>?G;J}GgtPv1dN|Vm`B~r-Eidz1g!|*wH^|yPRA2Lnzr<H%
zSl$tmb|SX}?OX)kBE;U@Nihec{!(Z8P14qmGXwVSPmMuZ48_QCn4#%|w?^=Hn$rHm
z!LVa$G9&}Tmc-I+AF~sGk+5}bwhttP2eiR^k<jqADUe6fn{<0Z&iy*?q>UTC7ze&l
zD7Er`hC02m54p-8=nR`(*Ku;zv;(JLFArjNC@<OVs5DBoRo)vs=J*JkKk=6bMeMKL
zY0DFYq{*P~Kj;{)<MQnSdXXw?4q{me`H;Ds8zev{b3VJ_1|j+>_Y;I_VQBlH@gM-L
z?ERGY2c_8tT)D7_J8J4us!xPak~$HA{J|byjB&*u0Mvuu9dZ95hNnfnp^PNI>1jr-
zzrHq~-m61NJV(~SFC>Bw+Ub2Dk5IFm3TJK4(MT~c8cVjBINE(W+kV)zn@zFX8dMO5
zz$nbG*2I#Qwf-H&(NEm<JF8bgo*V)^uzGbsSw}PQP)G_4aiHpzp9Cei!#yCVpvjnA
ze8LQ_B|rU+JAOced+=a|VGXQKhz&coG;v2RNBj{4%ykjqENDLl7#)jnkeK+!XDI#d
zrx&igShS~FKV{)*_@fLSIrGG%XD!J?UhLhIE*jRsPgHnN!{}=G6||Gj-jnBNyhq3K
z$SQ#^?sY)ISETa#)g^ao@f-t62-xAPS7EAy;J*9o<vH?oCi%G0CS%eOWazJ>wS7P>
z;0)K@j=B%{2_aw~fpR8H&EQhpK>dHvACrKER#LDp?yNvvj`&lE?mqmLF1U)GgOW4G
z4O9A)U@DmX=}K+{ZzgfU$TRZdh>iq3Cs*U&=^EBMhw10_X-ePN*4h|#SX0V6V_$Bo
z!lH*G4~*CpV3L#zeHvG?IqPM>J*J+lln**F72V!!m=hobBT>4<UTKudaDKU>h*=Aw
z9642nGDw=BmB)ob_SOr^h>k+ionY*sy$ddP00W^tlqiBFU^`vI3=eLPH3I7fy;y$)
zo3DO;3~HPKD}la(%clil<w+9yHh3`+SPqo|w!J-DW=rZMfo<%p1md3FXp>YYP>S=^
z46vjk4;8Lq(K|!lPZKu$L??>1W}Fd{WGHqnzLhNbh+FX;u`5HM1@!ab<Uj$yK`lsE
zd-aNe4okL!LY`u#QsyN@q976z!gf3gm}|o0&u&bj>sHWGtDI3!Z8<6^dIplXh?Yp<
zR|@Xy<3oZY54_4nybDra5^B$`VY<FEui-<K-w9qZ`sZ{HCS3mtArC`3!LAJREVzbI
z?Ym<}x`jm;fEJ^M89)r1C7lf2<k6OkMBjg3|E|`sj64W5{)U}L!&0rxqPUIqRA?M}
zt;<-pY+NVm!PrS@vlOTus_PeEUounlUypDk6AYpfP^XGoVdON^_x32jvU<g1196ht
z3F?)uA7`{GDyM>Zo!Qwkt5@9y19A1r%Vh<X{o)C&h7MC~P>>x&Y319Q!8t5^V8sRH
z_*C78!Yp9*3<7MoqH-{;bO*@<P=GykG{SrsYXkO7m>!VK6I~yx3EJ@{JzPA}!{6@s
zm^%YS!;(XDiN#@2c#dq`0WpbfHzR+~qiD>sW3Je)Gc~O2C8P@`9y?(srM+6AxqrVN
zg<Pi%PU(i?)LOKD`)(f8s(J+xnXr^6of%TZU{esAhsw`(Qm>ro*3}G=C&pZG_Ey;~
z{L1V~eqcOm%F}&}3S^{50GCO<GV`5q@w|_LU<g=G=>YP<?!f55zym9`0@jt+4|6b8
zMW`!;?i#VI0CzXS9c9d~uWPTqY-7SdU^e)03P+i2@&}F@I_y5vse<_#+9YtTYK0_%
zd+`u{l+dnWEpb@X#?vy%=afU<OXQG-rG^yUCYCrRB`cj&lI`)rznep`e;X9a;mX{e
zbe~?HoHQ~LNK@Q1Qdw_$S1&w^Pek>qSL~JeM7nseQh^5|(FTbJ-4&C5U|+%cj99Gr
zi^86f+uk%rw5Xn$*Ov#&mJ>nw2?sQe>J5vDi`wmNFPBfke||oulI+^&ua%W*Ne~zQ
zU5BdqXA(^l1dM5Qs=~Mj*D6+Jgo<Ufl5;rjXs@iQjXIyU*q&h$kYPEKQW}|xGG;`O
zy!ftZyC+3|T==<q*Ds0XkGgp>ga)c&C$eMv`A&;fOc@WOHM7e`$zjr+@ZD^wCF91i
zrrrlCjveQwatjy>G9E_J31&ITBW@fF2|43O^@>C8Q&KF1F)FHhrD3WQV(L|(F`A_`
zWso4y&Hos>g<stV@%9EW#KW%$(9mIkzkgv4kcFzb0QIllB@MV>N-gjJXh!P!64>oK
zjoaZrG91;p(|y&7H+}{&v4?oki6{a}NlJ+X&Vq&+ins}bbgxP}{3@8!nsk*>HwJ39
zK&p-QR4<dLEzqCY7eQQt2t8EWbm_R8<=d8a*05w1SvdXrt~{L%8<d?n>3hC<Szl2a
zjmb6x20iPpIO!?(@|&ew+06;LD3mW<Ny}k}c67tos~nv2BzeM<d2;l5xH9~TlxRXZ
zBPdBc{HlLpw(}BtX@+sm2ZsdS25<@Vk^-M9_?6haLI}5<Pj3qG4zWj<YC=35^bVCc
z(1%{#A_cp0aM=M%QkQ@4FI2cHR2d{ko<P&0@F>rpJu89g?HK6-q!Y@v0K4`Qrx(iJ
zwiUcYEc2G!D{PlT&+gsN$s%$-cj($;I29@2UMmyz<EI+r6^LG=UL72;6NW&H3(JLH
zg?KjbP*O_i3BLju3}7{q0tR)Dt?;Y<ZZOvT?GLRSP^dXIN;23W@%cq3bQ+D^Yn1T7
zjza_%C2WTj|4>F65y4bOypS%>0t4|NEEw7j<MJ9wgm<ZMU|wo7tb_1A)tRDio3wZx
z^+XvYxUB>o<M{KUydVy1)A)1Oft?V7?n0#q7vPq8MXLL}9!T{R3AA_$F1rOXo-BjL
zR>u0|qB>^P!uIXp6ne~ae}+*QBh@Rn0iu({*eg^B>mF7zBV}G5H1n9Jm)$PeP7~cW
zhIK-4XZs1^S8eo<73j`zc`?Sr9WeY3h8pg0MLgJIFJLjGnFiVuu!}`BgaMoI#e8Tj
zgB71B{;P)(zhzRL-3=7-y0wZ|7GUZ;$*~;l&KgT{sg-K&03^xaMxX{lZhEX)gr{o0
z+VY3hrFIu;Bcxx0oir?&w30qIDT1PeI;I<&%VYLiKg_86mimn9bl{|r4`;xR29I}^
zuBO1NwE0d#!eg&IgdwCveshpgYFACAVCN|+7~^@*`oG@|69MzpKlL(H(S_tpdVTm6
z<1%S0Xao8K4KqYdga}f21^OOnjp=DzARcwhfv?jZs4C#6qds(R>HYgP3d7wcZMYCR
zx{-T?*b`dy!A)UH)hny^R^4kvmG#6rzhm7J+B^y!i21YEHwgv*ra&EQw8^(y)SK~%
zmfZYz{2|ZPR5eGtpE-ijKL0)vDf6lzkR2dZljUTW4TWVUBRZ>B+?iR3%_(a_JRYjk
z*vZ4wMR;<N{QeoB^Ahk-^qt~i1izp{?=aJR9JpUY`qUB5-S8zh16Z-O7CE48K(hN?
z+UUnk2nIWB>D@Z|6<5Jb4E=KAx?4oEQ^Gh6s|elx32Rsz)rq$L{fiCPuypPKwV1*}
zh+?lX@%xCjjHRc4H8Q(hi7RLiE<&#2urWfc85blo9$tJ&dYR~~UPZC*V+rb&zNuL1
zRmdL`ltGfsH^0+c3fNT8p75)^0hV&azrS^Z%he$gr{?!*J;m<=c4fuO;T|RV8TI-5
zTiq~Z1*{R}`x|uS5n0fx{b=7bilN34595k6Snzv#ALYnK7LvxKpK>4F%n|C&fINcn
z)Z8w$a-skL5CBO;K~yJdSbLW^8kS3P0;UI@G%VSMVhxwE4yhYVsCzqE?4(LOxGDBE
zh02>?+h}rmBr`iYwZl^jKRQ2W+;WYd2xF2HTfJ(d)iB7hS37g8(UDpYQewCYBwenE
z3*f&BJXYf2SMg4x#n5)+4h%v3f-%6r*;(J}=vo)gV9y7C1XjF{t0Kst3<gr7GTKvO
z9`Ysfi*E4|^uOJ@pv@_A+znknq9h$~_5`!U@`so&qK36=7Th1%F>6>_Iq=qEgob|1
zXDfnOX*UsbAG_1(9wqCB2-S;1NfdBkpPWBj$OT?;tkjhzpQw@&O>dGuu~%AW>vb1J
z0Ci&r+^1inc;XDdYBPwqZve>dIPqY{G3|VSl~#8MG)wGe5M&787X+H5LNt9DU5oU}
zUjFytcCQc$T*Lh@tvlW@4(N1wpP*eC27=*+QW^$DexjgD)zpHp{L_+|00s0!u}M*L
zrkXr|jG<u(Tf;hvCSrkZ{$<gxVW*V3buFlj1+{23wftj=`sI=bR1}mWplU6tU<ZWX
zd*}O1rWHdt5=_YSR{Om<C=s??_*H->R!HXVNJ%`Xt(y!uZD2`Y-4J#ItC}bLN@UpN
z?hg3KtM$R<2nkrh%j2`f-RTi!?=0w$OM6i7Q8bgvE6zk1Ob9Y)zsG=pCemO)urF>(
z5SGgmR$Dwy8CaKUOvBnGVQN@}+!>`hBPYA7+$(M!f1nbT_6*vT*@2ym^*N)`--A=h
z8*j{vUag>=@vxDuMyXdC4>zG-4#d0@eIu(^7OH-OP*2bkN@635d%~*gU{S{<Fgzo!
z=T)7W(r_aL6OEBQp!LO_P|@HIDJnECbD6MQQ-)lq{b0?LAuakr7XK;i|Cx_V2yuqr
zfkru`_D{~=q%OiFYc6v%Ksf+zR82q(AoNGPlqh=D3tX67%(9F`am>+0*;zsK=Uqe-
zX*g?(Z?C9<@J~9s8f2r|-<)$W0<9`{S34v7n4xkmw!0cV&>6|>gD?y8K?aW5KA6Om
zyq}y@HAFU7mtYuX2pq(SPP8xqb1e0WMPO?u23xFFK#{=c_bHznqh`n*oBdzJXUAud
z7%(toxB@<+H9nV&8>a}Y4iEOcCfX@d{WT@+cwrb)bcU(*XA3?)XuHD|IJ&>q%#L0`
zSlzI+2kqpBmqhD4SQn+ds3Pu^l;zct?aFrv_5JtM!Rvum`rv2Dp4Y!_o$@;)w!#6q
z4L<DL;5+k&Q7BS1^g3*3q&JSsT`hY%s#i5<K(qA1IdvWW>~9^@!{6&b5hz(@&L3cG
zMl;&Gxc3I)aZlCMVF?VzCyeBs6GOFJiMNoS26PxC#n>|7?E{VpI}7Fde&EG_<WgK6
zTR{kbdUZ5Wh7SqCisLuAacdI$mBp$Wh2oXQHH4QXtvZAA2+T7bti~lN&IW@)Wz1>*
zyc+t1VkMt55rENHb7E;h@uYIHu$#<3ky$2iLNMT~1OY{BXhY2htY~JW{KZ5Yb$CBx
z46)7K!fu~mnqcKL9hbf$HYaoL_|4mU_8lY}`Hb+Zuq$KkN+WLljf?<|>i6HEZ*pbD
z@oO^j`w(5kJ@mG-){baB1>`{g9#e0jF5lt7ODBe00aHp`aUXCF?eSbuy0@`XE55Yj
zK6-R^#&_|t;;<l|L8BDiZZblU>^WV}gQvtDL$RjNj9#6yp34Wxi@_I<+a8zxI10gQ
zt^f{FORKuX!zPOba~#xl3N3zd(1x(@GwHpCpO75x1UsUI%OH)>RWWdM=RAO?Qw=wS
z;E9DGG#4Ae0HIU(71f8n(3b~5Mr$ds(P@|gnd7UI!8Ys+GE`WoXPohj(;}!uV2#kR
z?|^vB!iSVp+|9dZ^j(#MJf)cFMdAs<(uE|sNirw~VeM^Y{NXG<wc&Yfj*G*>sFYC7
zC&!|9S7J`{oIKi<Tn;|V8jHm54UWw>0qas7XM+OJ3+_Ci`Tp(5Eb@$3DM@DZQ<09)
zK^6`C{)sxlXYNlx5Od8^i^wV%2+pjs2+FnGQvx%)p}jl-R0ewrvu8tAbOA=wL)_@j
z@L<JLn12`12&@)DdbzG2oqY&mh~)nPS7}_czr(|m`vzgzn?M&&+E4~b9^N=C;^lJ;
zb!jKZjE9S8?-+GGEOEqPspKBxYv)*@jEIv`*X1Pg7MU?wu4_MgX4*r3JAnMUp1b;M
z<cOSaJoYp6ZM2`oRF3L8_6bJI^hWzp>QxL{{DOdX`Q$+no@{WEC`f|l=*qnOI)*Gv
zeGC@66lVAps1)pN3&Gl9CEB~a9mk-57XPU}18=L@LVk+wLEM2B1ElJw#&Hqpcu5lq
z0s0v)CFFv@0Z_DyTsbw8qq+Q|h(f!z*6WdOvFy~ljcSx?CESD{$<=XK#a5&vL$PFB
zG}de_W3+lE<dGieaTJaGvJfq7(Co^fvDG6mh#hh0IHN=n$Ipzg2`9d3W?KU=k<=db
z%IRC`xb#&ST6G3YZL`I_eLx4}>Q(IoPKGpioP$xfmDVjF?nd{F#P4FG7&>CO7<$dH
z=kI8popA9Y?oE8kJbImgxxGyTmvZkXr(qM(T1MchY>}kDpm}m*?~A>jv^2dux>2Ks
zNy_KT&pU)6l8Q4$5@V*aJV29PsFtKdH7xj&<4T`BG%PX69Q#sVypppX!`6IH23Hf^
zZz_5)I`73^Ei?yip?Rs7?a|xJ`S;Ma`cF~(Kx_}yt@iY%s4G6u+(o4;3HqNpcL6nA
zsb1BfO&&0LXZ32wa~dCcNI-PBVkq$)ooD;n_}*rS`yjs3x1Muh_|<VdbbBb_dSF~p
z9iA<9z%9m3zYiP%D>(PKLkLxzp)Y_5FeeC0bwoyo6{ijf!pbojtApYRi$pp((^bQA
zc<1Hey7Xq7wqm(ERv$^j5^;xOH5!zfLY7>pn&{OLWfVFAa(B@{wk>bn>1pAR;h<8I
zyfIq3l2YK+rP7te)vKugDf3Qobo_Z@iAhcj<kTyVS2mYAH)@J{Rfd71Z}=6b9EbFi
zZ46R6TB`IQHzEvo2%fr}!E(BxMjVxQr!mii41NTx)c1GpqeNPW3b_$zWpx`v0Vh5!
z2up*3OIZe&5`oDgc1g}Di0qkMB&_yI<PqV#yyhzBjQu>q3Y{J_te-H!s4%1l4NJrm
zid8r!(km1zZ$e~PNKwW#VjWeo@(;v?iZKOsDO?>S0($h231d{Vjg<_)TSDnkbc`Qq
z-4o(Yw(PQEl*&|{d6dLshOLNh6@JyaU?37Fw8?-eM>h~n24O(YjgAXqHlj4~$2%R1
z@@CEH4-B6!LUR%KK}BD0a34|sz%>(B--j@?i+k|1u4~ZgIY3W0CMb<WgCufx#v3ya
z^WeybC)m#?Kv%YPE1bcj?nzqKeMd`uIR7S3F9;u+v7+Z}^?+urBiYo`zX#)Ct%Xzl
z4y-_(ulJmFGU{!3XVPfDi+Yvk^wX{yM4M&cb^FeyTRUukB^Xh7E^vmGBd5~Yb^{<8
z)F6jwB|-?lYTb+58R;`<8H$h6A`K1ehNGrm&{{6XEMVn}GCJA-z-v~ui7{p+`Y0na
z<?jKSg?>Y6dMD@@`(GeG9TkJ0f0Rz@NTMCv*@nAUgHBEjtIdNIjGi}H8WzN(R5pvH
zL<?klGdnb_>gBv+?skvQSs6FR(X#`loVGhd#s2+zDEzNQ10q+OW6N5*UN~<wvl+>A
z$^?#u)hp@s<{*WW#pd8C74EI3SS4pjof$>FGT<g<i@Q-O=i5piA9R14T%8}M1%Q_1
zjf>`r=A<N^2cyx9z#50p!-O^{3=NVIAykB}=O(?EGJcwbI{7$ZxC+*>YHl^^a%os<
z;JFSI4NJFUnh=f`NRQXC%^H@LzODPb<Yqr~wK6aoE8~E;1iPrGBz@-s3~}2;QxJ4U
zmE9C_C4+oOErsqVWm#OvsaH|Z<GBnv5s-a)Xjr`3Z9zt5b2c6Xfky4Qn;2}_e9EVW
zN5!4PuP7ZTW2JA%kOVPAH@U+!wnhRMLY(36VAKHMPolMm`@h0Z8eUPO$}msVB#u;B
zJO#@{3NF8LgSMI|OHfIOLE<HO4~96D<VFfFr)5IrqO@lx-htGp&i(*B$|lLOnf!}k
zi8$8PDwc|R*eu3K*Ts?ZXP0+LtW#mEJV^##$nRVb+iV+|lAI3!x!$Je=<?qfhFNoI
zP%-*Jvz~PH;iO(w5t6PXo{>U)C0)Jp6B1{Aj?8L>2Tk7c=QccM62(0+;5Ei>+v){<
zyJ0-zh#|U9oP<%booi=YNe(Cs+pxv!f@QGjJV-rhi%03B;2nW=lb)yy#?t@-8YClv
zum;@dbW9&~pLr4GkpioMDddU$9^#CxJ$dBh0i6jvU-ctD3G{;)hov0Hbh~+q)Npg|
zswx<YRe>Wq$>_)1n=~66Il|CvyH5)oESFqHAB0F*73yVpkuMi=>c7_2gj|%_*{Oa1
zWg#yyxseleqO`Njy(?>j0+MAjpH`t7f9o7Mw-4Ad-$88ZRjd?r_os=Dp3pF2!UZM?
z;}d3W5E#l)H{3^s=r-DXz{Idu2%$z_X*A$PbBAWvy`yptiSjJj;m44tB0D#52DOm9
zhjcoiVu~g%YL-zAYgcB`(u+E?;ZcMKn3wALo42M|xhoQqHLTaS9?jCMG&MA=jG!YO
zu{Za6Cu>mGvGbv*WI3|0mVdtkJ#t#Eg0Y3SSj%b9eWw;pa}nvPM_vl*6@fEz=g7h{
zRCBhavJjSMtF&4xmC+@k3?^Rx3=gF*8iO72<M28BYGlv5*uo{Sl6N<e8(PzZcH!Qn
zZ47M&Czzg-#TXbO8phG;vs|7SPP(*4{{TP%i}F|?4o16g;SQbhUF3WvqyVfaWBlK-
zZCEOlLQ>>OwjeBF2rHYqQ8&ryd^R}3Q&hvs=nn0ZFlyoSu03?IFztS@shL{Y?dvRK
z70eO(D7PmWF-sntpwgw5s-o4{HlbO6`g#JIbDJ-eZ4|j{mZM(n3H_V}^(sacF1fOL
zW!NnvULItTP-ZuuN79o)aEYNoay^4I^Aex0b$ZzUS@=7nnrHmR!fp+$lwE2>SxakF
ziI#)uSFC*00<BC-NR*YZMz7q2GMI{QbVk-xn;~V#%AU0i>4&cVC+E6#M5p@JPrKz5
z?VnoG`usoCp7qc)6KzQ>5%)@4P$ek4D4OPEwYZKsMlDM#IcFr}548kvt^q@^YwzN=
znS5_d@sjmW12&xFY>P)ZNr(VCtw(G!PkO_7*UVNU;U4#D^WBx2k0c3|i6SI%H=x|m
ze25kQUDSjz7g@o|!0@Y%VEOO}OrHY&D}?>(Ue}K}O%<&y0FT{zhfw{vFr>p%LJEo*
z4xHmUj*b4$68n+p`>(zO0mKZoIim)uKxB&UG8ir7jAO<#GKaUFPPh%|Zj<>gp&nwF
z@H3^MzcK&-5CBO;K~%R*ONyPWhD>;HvbcS(a8$pQ^Jli5_K;D~)4#hBT2U>@i=3J+
zPr1M!(BgZq(W62k6L5;X;;2{qmRaR&l>=A3>O5^LJEjgQZ#Ivu%fRD_1v`1#aojb&
zr|XV^lY;K0*Zqmr!0;=|UAhay$f3)FUxVYX5SD|ml<~|JB1!#1s3@6enh=>LI1y8W
zBhePG{S5s82VoV9+>#LrNrqI+?Sa);2|QY8(XKKv^3=)>&6=(Jl^B;aBM^s`PZf4=
zUnH+d@=qPpe(7QtC}g933w7H~stFHvCH6Kt;GQCNmnQ5Sn-7oey|2Gj7!itP=#7_s
zuF?SlG#U|z((#={4tf;Vs$Q`;d#P7&eYpB!X!p^j7;;%7$_XA}E||J}6`>^lE=!#x
zYIXz44JZ6cea81BHMGeh85w(zA!tt}iaRK1{-^R?P9pmGpon3MxDUm(y%LL|4ei(+
zut@&o<*KE<y`JMmrx1SpA|5?##;A@}5{tvi%uX03cAS^-etK_L0`cG=Et*i435O%I
zQ5`)L%^~AKIzj$6u+q4+I(5Db3m*1$EEPk~3Vzs&s$V;NUx}H{($A^qUNS~_+Q(3@
z!fY%mR_xVf;{i317&1j6`2cWoqv0f^Zam7N(EO;Kmli_+&%j`dr!+nYuz;n~{V73M
z+C<MDaKBLGQBmXgsE(;`=h)AU!ko6n5U71iX%ws9MuNMG$sb-%YAu@e=p%XFCCty;
zOG&MlWUT$uH7q@(B57DhQAYZ}Ja@HUs{N+N8)#O>y5jc=575HDH!ua~_W;Omt++-*
zrL0@^^{s3-1Fao2nV@BAR<EecPHz<_6pnhOXqA*Q&|kfx@R+GsJOpHadC-0Zl@C_A
zltBV9KqT>759Q`{6E}uH*N+eblFBt~Go?S97%>MCLbvf323;fZpYyJCgBQn2J}CUU
zM*m#kzC6ItxkTShqG70`A1rEn^JZCIc={Al8t_gc$hQ2A^(05%67nvgNOSf2l{e9r
zVBft?NP1HvlbK{)+<iW+(&93O{Ij=v|36zh*cIgA#ZVNRRAo4I`yWDigEe@)4C^9v
zX}@;}aM3{<$E{Xq8O*6y1X44L*7^FVR~Vb}sEkkM!gZmUEfynkB(8#0$4W!{qVDr&
zPHr@KoP%Gr%5V__RlL!+-H#c;Jn$m@&;S0v^WOa6HSPX1Q62%88B+W7RA+!3__^jJ
z$bh)<T2m%P7@9sLX_5d_kyQL50<VmdVm?e9Hj-rY<jv47c*@i+^Ga57kbs`JGG(2q
z?y>}2unjVkKgq^c?L#oC)S$wEI#xcTc-Y>YAX=fVhjn6J;Nef$%_C^VgR=F`QwAQK
zj&>?x*TDKihOFydsMDMu!*$Y?5c7EI5(v!cs9ph_SE*OJ`%{7<RPE#=;>&Wm6Nj8&
z7M}X4SG6@CP@eJOS88?xswJRfZ;$}L#>#M`l^5&|rIiCG<=w_$^TDP&=Sdn(!X=?w
zZuG^BB=jAfm@|fp-cJ6&j{ju$b`D=si4N-TzyOeFGf~)$wU+u_8d`aTj{<E`lxiun
zz(H6%oDA75!)Lgvi51M1E?&@GaF+}h&0_I_IIIL6)`d{GQo^zx)?Gre78*TDi<@J)
zBm9!dW6Pg1)<0nAVk)9z9{Zqot&K%(COI^x=C=iFNjQca=n;73bl9d|h5WRtR|--=
zXIQE3#&fs+<npVYir>{+GY~HkQkh0+Ze6uT^~%Qc;Lflt;;t1D)(WkecpXgTg=|2i
z#*#XeX9aPFxXgbC2I<={3T|k`s`Hs8;faC1Sj2#QM)RK7N3*7Ou3J$<{X84KkU!n1
zlth&$1Rek)ghtM`$rC42dSMi)>zdE4zta!LVtm=2|H&_b4*B<su&i%&YKlX1n!6Ab
zQm<ULKtoRQo2XYd&Y|iRN_8U5LwQt9o_AyU`KebEm$|DiG|W_6H4h~&hhG`;L<zq#
zLCtOmX-XBpkVm*NWNvsP26Z+GBJz`|arj;1k>7!ize3o#Wk0Qn3#BBf0BsMQE7mMO
zML`k5ghxWquy#Cs>Z_$blc*Xv=8@Z{K^hj8S;aYRd@oK(yo_f=H=m59wRyLeBuJ+@
zC-Q>etYjJHK@UC<OXbfso>y}QwSYp)2OLn3rv+Oa%;aqKN|qlSRQ%r7Dw&S=3qS;^
zxOPMJiiKOng7v@Gpyk|>z{2%4s=^071R`Xo`;-d9tp^zc2V)KN_T)Y}{Z05X-r**U
z8+A#+Jm^9HCk7A$Fb<0NKw;Q%sgr>+BCkDfONC%jr&aHn#?C1J8W!s+Vrf`@3XM1;
zJWWkVE$~3NL+n1}l5Z3`+*QNk(H6-a{J`Wof6!+x04-JhTgkfhIP-x8lWtWEwi;U5
zg{H1hw_<nGDU(_F_k1Msd=Zt=GFvWoCvxf)5zb;Hs#hf{QeJHtEZ-ealDs`V->xIh
zI6Qz(QmY%j&Z0on8-wRld3JO@)yoG912!FNXz4-d`cd-%r*he+Cw&maPXyK<E$=bI
z$WJQV?!FG3H1_TKFCyt%LDvOy*{Lv1XUh|iK9Bd#aMjbbAzg=%(?60xvnifwPELNE
z&?V<(X<XAyQYo2`kucI*>UhGkJ{g-}tAcJd6mIFt=kI`A&lkwfM4U7UTXAz1J4mQ)
z!pgBoA6xS(h9i~k{`h$ibeo!f>^ReidFT;$qunn7Bam>PFs!Q{c0;)9h@xM!e8y0J
z1oJC|*=si6yezkt6n=Bt&j9%VA=>RiL0CZ_+HPRw&|UXIVGP2`QlR}<-$w@vPtF}B
zX;_)@Ut8kIPwB<xif+I7c<L_Ik_QeOvE&u%mtevT8iY{U7&%ewHKytHHzqPNmRPZ=
zA8i<7sAe1#o%uyeW&H_ERYsRB+(^YRDB!N39;bU>LAi^9P_WLfM%kQ#5vpI=al+gb
zJPp1SdnHD$GS97qCrY0H-0Rw&2=0vcQ6j(q0-7&U+!!*GvJdBu3=k;Os60#D2N>~O
zG^pCc?-(u`Vg7z}Tm$QY1s4o+J%HS#^t^qG#L}U#de5EUv)@a=bzP+EmH;C)0@n#t
zwh<*w!#bi(2oHKxxL1#!Wi0mPxf_u?!vr#$b#rgLqo6K8rn+|PWU;IBK?s{lc~?{R
z@K_YuFs55cWl_1d(KDH_pi(H|2<7Yi%wxqCbIWW+i}AtQBh@oNbg$R_T^-6*0NV1W
zk~D0qi4U3g4yvpXrNPO{P43qD8Am@;4;~DLOTe-;)~->4jH@R0`~gOH1|T2y_?jF;
zSi_1Vm0t(T4M`0o1zeDwGH&FIZvS#FNDaEQr&1Eto^9ETUDPi3EQLHx(s(`aN%83t
zD5N_RCg(TO0ai%)D!5d}%FAkV$E&p4-UA!9qSdxiGKnrgq0!d-*|jF7bj3uWkU7kz
z^v%pUs-THn?3K6)&FYo%sQROGr)|tyKNSptZXHQTy84Z!8h%B|QB*hv(_KD~n}%c(
z!?5v5<(G0UFUbn5JsNd{Oq{<wXrm!u-QlhPcEL^t&JCs2`Hs1>E9+j;7lzPN^AO4l
zZ>D=ahim}rh}#XXLx+wIo-m3gl|7HC8i!>aNrfALi%{#wPSc&`2e!gEDJ-2eEO9GJ
zI=>7BCB2c1C8cKgh*_7RCR)k0HBogb4?WLZqei=AKNsd1va;5bwZxicd-N4M^$KvM
zUI)Z16V<C7RiF_ihhUU5N2$j=iCF<lo=kN>$1)kqfMK-4=uQDyDbNg@J#{S4>qck~
z?t=epzf5h-@`_i_24wW+^PwM++kd@=ssf%;vh!~a8lNK<J(=^;NM#{udorJt-D^SK
zAB!_9kDRG+o=x#(<P5t%E1QL?(N`SVyk70u7NapXak^*h9;ciAKUzi?v$MT23lqoe
zIjv}+U1pOmrlLk^IM_WpHYduu_YCc<sLW;)ka{=@l0*ZFCS)4*SfNT+>-lE!C90Tt
zaFlhzFwgYHt5+K;D;LWpj$l+<?sl{|f`?yutw5)?njh!VZt{GN1V(8mqZ?aa8<?T%
z@5&FxqWuct=V<3{9|rZpKsm&_U`i+6y&vfMRHvKwYW1W@qj?r#_>+mla=}$cnVZds
zI4nD8R7z!AfD#&?eNp|~j2oxLfcX9VF$+!;YKmAorYeWt42G8K^fn%TJX(bbH==GR
zxTnp&KxKI$<i_gND`VspueRi;eHvG<5>L~SntJ6dhXIn4Tt~&~^!j$5#%%d#E2w%!
z@ni_5(Zv8afXj<B7mjsi93LRW=R0>`Xi&9zuCA{K75qnhn1cr9KLJ1tm5_wj+$7#c
z;u(Q#bT>mY@IzDz^7yF^=(47G;~_bDu8bh8{`k4Qk*5S0h&k6tJXeTH4MAAq_lnLY
znFfo8|CFxM`54#Fh9^l9`raN+nkyC&V_?)K?G%It4_odNkTs!X{l~Y%Xvya4uN-Jq
z3t(4Vw+yq|!aC<yD3#l;aLXsHFUIzPS$zXM=~yz__zuD|eNrBkz*H*Ky0=mJ1)~#D
zoQLL24HO>Aga42Pg_DkYa^HB0FzOylsNWmi{4iIdy?N-odkq!-4!i=E5&l`zfQueB
z5t{qGtfa6)0r=3!4`l`$pQ#$$_<3Uyke?`?Gzt$B!rIW{G}_ie^8Os1$xOx}gf82?
z#g4kk!7f9?s)<5pwk369ze~u#u_k`LzeaP6>d2`))7mx6y3RLWznt_s1AaC6Xx*ux
zbw|E=XVTT*!>!;Z00Ke%z6zJO)Z<TmFF`a`g)d$4%ZI+))sB4XC<NxmEcZ~aLK<b5
zt$C1gLP5PU!>^1O%o&oV?8}3?`!fuwyOcH#gTk-+yMg_7vl4u`g??3JxJkQ`{+`??
zr@s{$0qZ;v&QHu}vn`0IIysCpPyo5nnj43URj1e~nuZl~sCG7Ae)4)^0Z+r4?q^Y_
zFb!)6&(gMOT|*YPiJaQAX%`KP5r>swo@A_E;eK60v81BW_++g4oO%?__Jn<s`zcu^
zH!>|Mb28Y*ZV%(A@s7E2&p%lzP{-J!v!QM^pm|w=V6U%w#VC-DFE$3K>gv^qOYvlb
zGRb6lPKj4Ck!TN33?$By)5<rG8^Wl=M$bG-%!o^17{h?eRa-tpSUQ~aU@+nlSOYK2
z8z35l6=VQ?;M7S=1!K%n(b8zo&k<nS)734SrL<;v)Sz+Hc-mN~G#G@HulUA`gd)T^
ztT~MU#ug1rLZU_{1BT1QRKL?WfEJ3i_j!KFoI4QEH~rRDq|7&zz@?wBo%z_kVzO31
zy(cm#ygY-HY1N$vr;*SJg;M#f^GmGo&LGWDzxX4rHgqJ^%$C)d(?ia5v50!xHWi=q
zGO?*w29K)39Lhscuet;7WuofUGF_4g2?7;{1lD4JCKU|riO~`$Wg5nPZ_^KM0#v|?
z2Vr#$p#pz4$vEf$01yC4L_t)nF787MA47soiD!}`7vyR8>?C?5mrLjovnQIJG^>Y4
z7=>H}D`d}GQ$^LlwH_AHv7%iX;Q|t2u3TQsjMh_-u~HA=qu3-wLQ2+J5I{86G2y+H
zEYPLKT|;h)&mQbLB3!u2&q(P?bWyL)2T1rx^@@~xqIxx?RhX$*UJ-f97bB~nP*twg
zMQiy~fCN^rx`L;5I`}>qs04;Ec*_hPLMX`KuDqHjj23a@!P4(RUcfTW{*1}3=srC!
zJ=b@0HRe7qtxY2&P!N`MF0|E+m=(j!oY2s;ccFMRtlZvS&NLbZv3wRwdy8~s$Bz8f
zUU#foF8dsEG^~t4D9$J^tpLolN;$PK?G%kArPdsela<{3x;&`Q*ObU@W3npvE2H^4
zz&C~FN>^?-oVMirsF7(!#rWDFY@9A#No_({yAwf#CfL*~52`UrF&>bvPscVSJdH&%
zu5YKvMmN!(;#Kn+kTg?a%29tjBY+2=f-ece(%4z?x;JJpSn6-AF<~_6@s<I#Cj|gq
zKhDVJMUCZrjO1_RnK$9@Ieg6X*s~U0SV5gsb#R}e)E#rwcPyvcfpcZnGc9$Hlrte*
z6I)wHM6;8-2+G&ImO7iXfjoH7XcCQEmYyRhVt1i(%jAzxelGw1Pmc<vTEHFED}Tw4
z5+coPW%X+RryouRSY@R(?GdHAkMJZnafWco{-Ax^<vd}EPZhemF^;0lL6HK*hJK^y
znu%w;HwFd)tF!zR_kqFyJr=m)I^;7@Fyz6}3g<Hlt$c$?aCk`6G{!1XSo~q@J7@Ze
z;^-=8yRxQDLJONT*)o|9Ygl<%#Bertc>a=J)69O*P90aVnT5LRoG{h8ZuAke9vpy)
zRt?=s(c}hy%GSu}Z7aPxF0<y0lSj_4a~{>JA}S`GwOMXRL@lhWUYQ%R)2rynstC%Q
zXoxcc`qLUsg-JGC#UmOf0Ra%i-AF0=I~9f&qCpaDa>TzsJb2(iQNYUHS31isq06E&
zTlO#wVX)nGJplSvn4~gz5|||B$&2SEj~S{w@hfE&6fC|H{ox2tyQ@+|R69z6sfKD;
zdt#*$?qSeD?2Vo0aPBsu7U#{jYD$(wpqY7>w)^mI{yg{uw3G!c?aef>R%;9RgEeQL
z#VPPALrk;P?@}rkSCsa|)TQu!NIbQXIN%?mUKw1fJ{Kg8FrnNz24*%FLu#)X6!nTi
z5(H*|GUbfVjN;K~N}7Y@XY*%<8}yiW>9qeQ!mkj%(YYeMJ@pwwde{-&E0mFzBlPKd
zHBn!fyT~X>4Mt~1jd*NS890VYEUFzPPQ}x(VA<lh8E#bE0z5DuGc+luLc^)RUOT$I
zQq+)*=+j+H#>%AX<j;f4k=pTAM#MVxYD?>LU#?x?w42oWj3?8-luW?J%heacOncNO
z!-PAunpycEv619suT&hx=<FncIdCm?*jy8%I)BKsTR9U%J1>A2ggKft!><^#yebW4
zjFIcLI^kCH#5?joSn*YFF6U$M8$iEX2t|cnm<B<E$Kw_(Bqgp<PhB?d*oI$TPul&p
zLOc*OYp$c9=Di!aT+)a|1c8DwDq=2fhKA+!(>H4-Ybym&Nw`+F=Co31{uz<xxv?_N
zdzChj2cL;*CDvMpmQ-Z*Ub!c)s%H5pU(`&C<)Y@0_h5d{11+@LdFa)HEkEAaY~rQa
zS9P-U<YiO492qTbbZC+3S8UEShW{AJo~v@O{`l~nE{g7Rt1f-(6_#lF7YNQg$a}9b
z_5=?u#DC<2po0Cp*OIP`BEz%~yHY}K=sd~`{!CS3{H9xC{V<$Lmxzih%<Rf!P`(6m
zW++cF=O(I!<@i^Y+mbzZ`3tpiT}$?)B4KL%E@6@EZEu%fZ)O{24YakEoGBya_*^qF
z?WS7E+RbE}V{~8DVz`H#&fIu4r}(@dG5lLFO&uZdDm?jKxuO`=juzjYQszkOOaOhQ
zE3v6p3UcBnDU}VU+UPqbM!$MRm;>i=3qj4LUIjoO0CWTpenk=ES`6W71NwL}$k1eg
zliVMT0tx4l`$XYE9n&j>q!By^H@Qka=3=FE)&Lq$VG1MHJc-mvKxfoIqK@${nznY#
z)194s)y+Sc0`@0XWgztMcMor;uRN+enn5wGO3`yVhKGTS8|zayGe#;hO}tw)mh7*g
zooQO=lOCTDD|+Q><+`A`_ke^}r4;L23;#N~Cq>7);B7RMZw{(`5jx?oBlT9VNX*sd
zSH>mk)vnRm2uG<`;VQNhgt~N>zuFwVmrld%QEpO|@T<(G4*)?hlnm}?DScy<gmhyd
z<t0AJ2^jB}`autP*1#GaPdJ_dZkf@WP_N(QGNbFgXAi1|bqkUaJoZU!ZB{Hcuy_Ws
z1sb!m3FSES(m3IkE2G7rr&?0zi+z1>f^_T7kqzn+^R>(|t)|`E<NAnM_XJk>-YY{n
zbBLCv))7B;^(<A8?dCFwS;3~P-PNnNr!}9O&4FIash@fkCiK9jUKs%N04PuO_)wlv
z>Qzf{)G!I+37n%K28CaBX1IwP#Oqgj;u)I_2I&>TsY95<x+!zBWIeJ?^6w*cbz>ZZ
zYzw!9)O?>ye{K#!@C2yicBU!C^5P-XbIqA#cu|g*sh4FMUk=B7d8;g0Uc%b7;~ZaN
zy~<jra%DE=+x`-M(VL3S1k_ci97No&D;ltOMd!gEX+gt^(FvIhN-&RyQ&WET{vdGv
z`u%y$us?#6L-n6(L%QNs!JYMtazZn$tCixx*2w^f3QnH(^f-XPDHcv;6CzZ(T!XwU
ziHA$2wOvE{;f;~*v*lqo7PRqF912Td7zxFb0VKM9#AybS(7OJ>84oVU8i8f2z4%iI
zf9I=V2E>Qx&<7?O7KEjZ`5;rRkM#w^pBr@Vx~_YGpeU7wW@JVvW)Wx05H+rDduA(y
z&1dFEPF^Qgaup55^70EAnerPIaFnk)ruAz3z_i9<<4PyU13Qex*pR2Rw3pWDUG}Qr
z+xjae^CVL6O?Oh4R`PNgMw#DaJLV#qRy{?bgVZa;0|u|*HY@F^3Q-7S@vsU%HW9Pb
zSV-|{jfG6bag*C$-^uA4YQMB|BvCiy<_r&hE4C3>ntd3Y-<yRYX^aapMDd21rHYN8
zq2On%=B~{kteGTMa&UHDL0E#?+A@OPy*<(9nMw-gTBtN*F1PPuB;$havh{yoW`Sm`
zr9c&LD3-G0u=bowK`^e|e4~Jvq4tzZG)vX2(e~EXapL!{kUB?WZSCb-kq9Z)seDl%
z?G{g#dh+vt?}^gdf-<s4Q`pkA(VCEtKtb`jnIRxyKl!EyGnX^51NSnI#4?*MDiD2|
zze2}Q+adKzojm4(v78W6uTYZyIvSA#)ShkuN_RRsFFt#XN7`W*9-(bKpjQa96TRx}
zNRcUay1{SorO>NJ00}}gQjhEW&K;bPlAQ)9qMnhbd%jZFUlR1X-`A@cC#xBd*!BX3
zvNWs{^Yo=I;nhyX5_OTWGE#AR{WnC2DXQFPVOou3Ozo1yd)wl}?cXkJdB>Dcu?!y4
z4+)k5e9-9ZxCvdaHSwZ7$0W-)d2(3bXj*mFzM9zlD63cI@^nhH%A*pDN_T%4=%QX#
zFhmUx@sK;0{+;Dd-xan3U7i|d0Nn^=$Kr;941hbod{pyb1!)beE(mD>uO@txm9Q|p
zCb1Dqqk^zx+e@byi9|h-cd$|ll8Dgarzj*#mh>zd%slaS>2xVfwYxma8SD;i24RU<
z1G}t-7Y!@SSp-_1jf-GSL=Q~EZ0Rgxi40R-v{d_iABwtJZ8(M{Gz(iIpQLSt2kSZ{
zg%e$+7PAjSY;wgKm|x=AqYFcwILq*qz|O;%xY<{7B2u~3E5A!#^-3MiSn?E=(zHfm
zD%^%ADg(l=bd~r6BrsTyJcCI{d7<4|P$7(KVr(z{U`9y5x-x`nnOR)vgMmba5QG(X
z<8B~jdoYhn^_XB6j3g`1Ie8G5*3A^AYP+?(|9N8d3OaVlsg|KNg(0x3EJT!PdA(Vw
z{tV>_70AxSOH7^l*|%}csx)2ozLNu6Y=Xi%DOqCZ&)^Pg3yAuc4#+;^<~SrW!tRE4
z_oNVb1@~Gl43e%aB97v;_<71EG_(B>S{Xk^y>j9H;ZAIx5Q%0tdm^r0wUV&hka6Kx
zAI<>5R%M?tg!m&k2v}hu;63>XQ*l6XV+e`P)7Ru?0NrRU8pTxfVlLa>-7Cb~g@uM3
zkHV+bc>=J<VJS;^>V*sYjJ7Cg(6BsKmlk!4P^<udk{-WNIMW~Y4G+kY?3Ld|$;xHA
zo)Ake;St#2OLS1pn$7g_>vqyr<IdT^qSYMi&LH)Q$4sZ~R{|%RvEzxoG0H`x6)L+{
z5pqdAJWgR$1<zMhU)Vg0${jI)5`GoIyS23KTrUptK*|d(H+iDOT>Z+(|DY$(2&{fn
z%j8~5Ycu8R6@&%PB7`zIMEkxJb7PRGH}*xsxF>CYuHady+BMHcEeAz!>_J%j05d(t
zVYzC*s5gl)*K`-IhPC;|3&qL=qZ#6`q**4%6fa4&Uo@6@YL<_D>1@X_G-oO_$(9`E
zsN*I>X9%4K#vHVUzgOs1MYDWo3Q<=A*@~)HoF_>>KBvUMkG*oD5_IM$R!@Grsm|Iy
zz*4UaxE0SRl0kA0r)<N{Vs2=dLF%gBZG)#iY4Gu&Kh6SHagvaoz~!eyN({nkk+h9K
zZZzg~s*?KWWtQ*<T%?WF+;Q!xo~1XBT^g{XmMMx5b~hxmQlQizETX2vbxfR%%Bx{X
zNU-RqVM*3!o5S7?wof#c9L1x}w=R)TkTb<r(bt)xaWe;wF2hm`7j)m3=~koj+EQV<
z_`?cI@mlGvUOD;wb3dng<?(aWtB7W{yQxJju-dr_c2X-EWr$#;HBU6VSq2b(MS-^6
zXxn0FPrqs&Q_RevG~7=!s=<a<sDb}Mf29BOzyCM8U*Ns@0eY&Rgpq&@sm72Ff1N%E
zC}6dwD}WoKP=-TpOf;>DDKzzJJw9GZTG|~%0{F9j;3Ns$m*w&1%RaL$W=(ul85)Jt
zx~SSj>G0jnb|l`TM%X96wu?HUv@l}T1a*GJyGAz=Csn>(Cs-3NdAbXqVe^-1RV!{K
zT1^=Lwx9%~uHaN%OFJT6IrWA5sUG!;A+hQ9??ClRc~m)~GKY=oPrf`z5wIBQl|cC-
z1cE{8m5>B1RP^z&RPP8!k_H3d#`;kwc?7HnXV?~T&pv9e24UR?ZHH2OA$AGp3UK2!
z;|r3Id?6r>eh1J)Vk(J53g$|@pfFZVUK@w?BBHU?Q6p@WX1*U_#9?h{7aw>TFBYsI
zZbL0BUotAw@Qzu1dy9+Ft%c63iB(Z7tZ^}74*GBpGQOZ2xQ#<M)UD(q=}M<Qt$46?
zGKSs--ig05;J=gr01yC4L_t(XuvlO9Dol8{*el8?e+8?Z3<)b6rCvcK6i-;{Roh6q
zfqG>@oTcw=Ye<8);!&?|htRJO5|P|1VL=QGKwcnj07UKiUV{XG2QW^e3rXx!W{n(b
znX+hDDx6_VEnmh)TU2=LZ=M#t%DB`ni9Q<Eo;7fR+uiGsWvqScPQ#M75F-TD!&2#`
zv*#0<=`w9}+N-^ktkdNy+|sl9v!bXQ&Pgwe6x*Y#7ipBC+ki67>w!z&7Mu)AzURO!
z64a{>(v{jwD9#LXULJdO{^DU1m`!<90#gA}2*k6YBY`D6U5^f359{Gy4GEelFg#I)
z1lH8iVxF4AuQ=#^Km8k{mQTZ1VSll<vIlO`GiKc|wYx!&1)5-7ERY-8u!ZFXd&Dua
zTl5U+ay$r$hO%aCEwzjZ2^p8#8B~-C!cwM6VH1ygqqAI~RU&hapG>~BQkWd4)aQPo
z8KavWsh8a*H1FGjw1NCqG|J$Y0I13<OJQ~_Qx~19Cnf*w$>>+1<T+WZ-uFW$Qlxwe
zgsH1~wPWM1+FpfCy)tvN3N7l={?1iR7xss6eQmi~#}%2WwH->$rLTZY-Q=G8N8Kp&
z?PoWDR%JKcE%k$8=ox`EKNO$;G~o}zLM=dO#br>8wMo*CB@L2bo(L;P6^9ZUK0~d`
zo=A@1DGruJ(o)7JdmI)V8rE(p>W}Wpv*;X;wXvHz#9{p$bN&cvzEBu(SaK+amAU9`
z7zXlf5_`LzWUM|f6-uUzH#@EleQFfk)$Tno0~qvQS&v7}C4;{1rBr#nrfS;g7hSI@
zlB=0tadPyeS`v!nQRCFZ-x%8tW=d9OwHABDg<(E!(iHA~!+7~e=`aWOx(%KLy*|ir
zrhoWV92bRO<w4Tpv@`z$KPm#2ZOR>(Sb~83X{li1nQxiB7*HC5c!Ro8rD5hJRs%Lq
z%C=ZJ+VKRkMl4}Fl|{qyvIR7(%&wS*B@_>vU?@#{DNiURu%(;H4#%h(Sycj@12enI
zSaK}GxAneiAb?se$Z2@==vg<x%@wN^t-$9C=MUr=Usvf$g#6xIky(t)SE*M!E)StU
z*UF<3j7oQZLR5RkFpq(%5q?GCS-3hJw7P-P5qfgqC$|`GjKEE_Cwpnwoq0x5zXe~8
zi%0PWVC?-van$NNXm<mfNCfXaugU8z`ZXA>Clxn&J+sV{%K)*fqdY&^P$|nh3yU`G
z=8st`P7i;@|5y@4YmirgT63*PL7tiSCD8Txl7Sq`N%`>W^&(nZ#!WA7^GY&;cJ9+2
z@?aD!CEv3l!+86d_ocg&X>(C)#(EV-@48+KyBgm)MkvFOj$>A@{0^u5i<3@5XRg(x
zUXh@?KOmy&6=cm&_|<_8iD!0+LPF`9p!=!B5nf^ib%PUrwU9ZFHB#6lu+I0%qBA7B
z&lv0uV7@|_?(uVksr_Suafj|h(m;ZOHIx&{_3C9)a}D)|waHM6q~*!-*CqqzT+^^K
z5EA2^M12v-MUhinwuMErfk=Vyne~)p@UYP;iwO9+wVf#ep*6pJ-prmC%k^-$XsdrT
zR?Y#PzRw-SJp!_%+0@eWvSCk*cn-`)Dg_%Bc6IR~5)otcF=WfiZ>Lm{*>GOtIK4pV
zlQbuxTB$se6Q$9x)T^#fYCG^y)GLZ7#IA0Tlr|6)?WrR^@wWTmLZtus@BfqH2)HV0
z<aQQE(n;{iUv)U%A}LQoQg+kl29_OQUePMy6eU4D0dfRSldAV{o#%@Pk2HB=?zGwo
zdSu5F%bIa6nht-rL}Erkc*s(<vuR<2Sn`{J*}K=nmbPG}#d^k6`o_~QSj{qY6->5<
zjHgm%-~Ch}Ly<g^77o|g{YJ%G4YrbTuKptFYG*>t<O(v|&htrELQ}8w_{BC-p}u`a
z(Nor>iS+Vd)GGz46yMv5D`yE$P}YF=9@_q30+vQe7NQynWA!V@6H@q<A_7)BOWI&S
z91)u;t#vAxr_ROUe=rdB2rRYEBa(X|b}AAtE~bojb^te8B+4K`JfT)jKB8mm$+)&q
z%UZTr9ImCqVp!ukw_4s<@hsfPN^cw%jj+ibj+rXbk`}Jo%vYnqXjKy%c%rcYT|H~A
zb2Qf3f&4t}1~FL&Y~3)#XT8t=^Qu;O+<7zIYI5gl>8cRGV(BZ4wxTSci4NuWsp{39
z(@M&XI2)l}y^o^^^(`8u`cU=C#&aw6YVCf5B;(Lgy)wh1UfEcf`0L}P`(qZcx+^}G
z>24<#Y%^JbNE+`Gfl(6y`Dx?uEignDM8R^#qG8o)o$>;pc=Gk4%JI3V#2~&jt^y-l
zmFTG1>`l`(ENNc;;<++QGEh-BDw<E{GpUy+L)tUsD&KskQ-?f?*csj(N$+vhodlr#
zgr#~)V}ST;<SoXm;J!uij<?GAIMnU5{Jdb!s<Df}%n?`+D}4&Khjb-l)GOU?j%s5C
zJKX%TVy{{t3SnsLY^hh*gDQi%S^XqIOYnV4dy~KbB(MMp3%y(ZSlRJG4b3&MV5w%o
z#WIJ!qY~n7P&BM4&>$?SI|Kw_%@0Z>iiR_A)o3(F7!L~<YginrB3v4lbO=Y%4jPtt
zoUG-&Cf-zN;g-q}nA#?0*0U9xiFW5CQV1_nnR}#v7DtU5_U`J|t#soT45d6egG!D*
zECY+^2E)M{R^<+F(Mn3rULalNZUz|a&K4R8Te|9IVz_$ccRLkV{vyd?;^(BRS7kMb
z=vWJi^DtVYC4-~FuSgd%Kts9RVBuF3)D&Y{UgY|F;1hoJz=5}bRi2jQCri+*1fx2m
zQxKMvroTb5DuN=y@XJUU+S5!VQhkxo7n<R~k1a~3uvYK7HpJ=DVse_`caFo7^Ssns
zMJBanucj0=ES#`l!6??WE1Is~ZJB4X!#ApoCD|-^f|6nvMS7VWC>!mI_pqB^$X#)8
zlF_3AxPdZt#wU$R@AH!2il|~@^p`7Gw5=$?gjV?5Y1>Cav`#`1-<q0K*@D}j+)!5Y
zWl%j-qtq*uhea}?KQxYb@)&z_R3Q{ik-!{&MJYjoGak#g9M$|?Fn@(`1!H<vM|IMy
zU=Wr@<tK;$L5oPI^#Y?s3e`)?7faleKw6k9gy%>SbBEPplWj4qnomxb^cXvmoK%*^
z-KgruVHffmmUQTR+ERr!H7t?%s!~St>^BN$)~FSzS#1fA(OA>>E0iobURrYhn5-;5
z#m_&A>Pv!hN%hU0Ro-^5>BxYnE9tCW(KV(Pt)Dr=shO=1VUC)?W+u$XUWsR>&zjH@
zC&mK>qZagD6aE{O3<&M(#s#&b6gQqR%!40%ZNCg@&1lQ(=M1y$4}44FmyuXNd6c0h
z9`!yRy>1{v_ex7t7qaPjQ!||6gjW1)oabUb)9U6Q49%Y3;X2J{!Dh&qxBS`8Mi@k{
zX4caF3G%$es|O#Cv|?J&usFRQI&gnGRRrLVy*u;XVr-bLWZd(Vvl7*->hUUV7xl`)
z8?8Pyv5_Pvd*KlrLyhJuL9H&?6}mbX<K#9ECH%@VQ;2&KClOLj^(8TfUv*0TLU@!O
z<9{$5U(yHpJL1sMSHX>&lH8}O5=525%S0I@b=<96xlVY}^<%qBJyZ=4H7xP_rtd7<
zhP+MM3>bGun*e0gurfVthp8Y*)>QD0P!sfk33eyc#O<_|BOW{`<0x9ybgQ9*r$g)2
zl15&E%j@b@!z_ffhPh>|m~ob_QZan2pL*p)UA+<tVSzn=u(NuVse|_}16$OwjUOXM
z!fH^jIR5CEsngpW0~kxd*3dHPPXZ$|H@U)%2fqqO0jqr9&BJveqbK<v{V9Wl;t2^l
z$x5ZjXA8!6Ta{7U*k=*KQ;QU$GCW>uQK3+(PGpx*+KKWoNur2boir?9jM!w(YcZwN
zer(3a)T_RsD2WM%9BOH5b%kJ5oyIRm(gyP2!PHh|{s)LwBSsfH-!^SE=RvOtUQ6_0
zN>>#1s#HVCEnQWS8q%JhwoFD>ugrx&SFea{Au4o+Qe(5bJ2Zopd}($wg4RR#`2AO9
znSTxHl8bA`P{tBF5^s+BjcU;8{RZg?zxsQ?*TDLbPsD=c{Mj;q<TH`tYjRC@g{}*G
z!91+0`B~lzTF{;0jLs&bJUGnPO&6nUzLRH7_k0GX4&A<{dyUZb69Fpa^{_G?qVW0&
z)p#aR%-b#V%=iA5i2MgznXH-(*{+dymd@wB=iWo_8pk<o_Q-Ys^lNTv4-mZW+RK+>
z&0p3evO{yNe5=EfcA%!Pv87$Cgl0JEW_CKC=hWRF4(Fb_2F2OLp<X#=#T7PTfH*52
z=u*3^ZdE>%$K++z+fFhLl%CBc7-4u+p$8FUULmwT=W#t+8ah@x=ZN_PfT_uM>~72)
z0F9~l(ayC_xl0{*N>5o4s_K*8ER`ZIp(q>W#$j>qKvp&_{Ecw#>HFQhQD*Oj({b3b
zw^B4@u+_TK3MbU!Ag&u56>_ri^@+^-_1IN$tySCFJr}JOXz|UM56m<TW%bGodvDV+
zS-n|@n9H<vGIM_%zq8oXD;rWhZkotuVZ@{&MfL*WCy-a1V%ORcMbep^>Hjn+rt7-w
zQEe4l%Vl?-y&D^}JaP?dZFy8P|AULr<yQz-q`vV}D$=?w@mgJC{2U>rKt{z+u}Tnj
zrX9J{@CS~=nrx*g&+OHRuFcqTUS26N4$Fdek<_Zv>)XP~uMidM&-|f27?@qz(p?;u
zbPdH4PBfMry~UGmZKRF$Iq3yKPiK!ZN9G?goGR*x%=%=&6N4*jIYDnLyDr$U4^BF#
zEsr5J@Jr{4?li~s&<-yI181uJ=HPJ)VUq|t6b5T{jR|TL9^n-PNd>F&+%6C-Mq+_W
zFglYw<C+H@KohVG^DE<2tdr<tm?f1-_Ix9RjGwL`jWPz9!D<KAo}ei!z!RmRNjx(T
zqr&VOmXJg`sh1aB5J~oT31#cw$=ME)O^deO<kxhl?&H<41UC_bRz%4;MK6H{>S201
z&_wHoqtmfR%=$3w!fe|$_NS#QR_Kb;oEE>(Ojx0AW~cwH*eg$`GdA|h=3tSnmwKh(
zL3g1Y477PvkUTO~FvhjT@@Fg<IrsMo5ZUf2i}`FCi1ph${OZANkr%Lt0U9Y?7lbvG
z1VyVr0B71OVL?2w_C(>qFtRF8i6Kg4(XcQogKIx+rDTJsVI6&I&DNWQ4!J?+_$%4|
zEqZ8!Ix8hs=~>y`)nJRo!j^R!6>l?V&h0yUrBknt$&&K~B%dT5hh>kRbrV=d-q%+d
zU$k<aG&n*hW6mX5<Oxb98fO>|b}FvKUiXS1HrdoG8|K@MV74)~Dv0V8Q3@H`3qjTz
zi41W@{_AK%(sBmV05$B1+~JnN1~L5Vn!@=^E%i?z{m*~@U+Gw3#9W@p;XJ8%5<rrp
zs~^mgq;on0wR_<J01yC4L_t)yCrLn_)@-C1`1F$^N`iQT<p`TxwYjh$ET%u(zX(ri
zvNfroYDo|kgp?&q9yWW)$7<6zY2RfyaX5=~2rb&R7|6YM)MCl7^%2%Zit{y2Fx;N5
zfhC7eh}J0V0<0k1rBXUdSC;bz&DARwwfF@=Erh{#9(tS`g4CehXdDh+g3#7Y)@i6$
z#vBuT(-2jDGB$MSt9AzKJeu8f`$PNX!M5-O+-ch+m@i5oDJz$j@T+1Xqo9))u&~=x
z`yg-$fS_dd!B98^Ea7NaVvu`kBnwduslkx8iTrL%ToeIIpiIR{5Kq_|mQ?A+YFJXz
zcS<~{R$8G73s_>v-NH6X!>X#)9!|$BJr({2X^-?`p*8e#kc<_$srFO%s<sN~EMp0%
zWPPrTwc^pUD5wVS)Nx<wiX&PXPraFRC027D$-o|SWFZ${iM3v%D^7Qvw0m|u2{G>M
z{nC1oX{>s+Bym%jh19|7Rcj=zhrbf@M@c+Qf1o!ac~V-abJ*}S8;mzow^FYJx(YzJ
z_#a$~nt&zJGYCrt3RuF_uqYu*ZJvdzaeR!1C4vZZW8<)dCw$m6ERk>=RycQJ%iuzo
z&bz!+RoG=LW@a<O)g3e}!FxL!zx@WA>N`3}A?(KN8C0~@bLo<I7R=h#BWcxP9MErZ
z$AUe+bDBxwb=!J%_K6{~S=8be1d5n|&O?tA<(oF`zHrR9e~POL5}r~6C<<7b-;Gce
z08lANwNG8$1uT7q=8;nPl`*ttH~r2?UFfm#v`ADCuQlw+M5AGnTKk6Yccko0JZd1Z
z3RpE~2wnc8Ufmr&0ZXVFmf%D4n*?D=Bh(_Eoi|sL14wf_4T~gT$yFLws#6I-b%BPJ
zZ{uDKOU#8I%d*wOqI{M7oJ9*K05Z3qzxpb)6~%J;02xdC+1{R+Sk8<CXI$mINbiTz
z-IzQ8eRM0EGXzGHMQH9{gCbT8=RwE&6<TvGFwb3oXyBDNd`z{U9drs|1z>E7P)UXD
zaDWwiB{8qINh&;g_#1L&VrmOdf)O=&M!h^()Oy5~orZvQOZ7@>w$<#<BVhdjGz2W+
zX;@VOOTdA%e<iF<lI|;EwbT%dWT9#u#+JyVXix2Y8D8A0`UI;ytSNC@z+}Z?5m$-w
zt4=u?>mC}Gkr1UT$~5B4c!3M2?IY)Xf{azL6tw6cX{6@f4+&-JGT6Fp-n$JhKcKE_
zZ%Dln%ZTOd@w!#Us20C8p(aCyQ`<?R<R;q94A)0ZFA940iRzV5^Xt1t)aKG~^{S=K
zX?D}?50E=fq~ye-(GHdpQ0B-{t=Xu7r$~bMV^Oah<@~5u57Phq?@Pd{w1nP4SkhE8
zFp`C+fr5sWD&IVwh$IFH;LJ}q8z#X#fiiWg7YRj76EO3;gi<sQOB>-ldg8DoPwA4e
z?7ofG>`tN`Q^S&|x7|v^c>7J2ece<HUc;shHfr~^4^grXc*bFMd`_Kq)row%aUcD~
zU{w8f+ry?}?%=H5N4=UU1CMLs-YT2$#8%aT44hGM$B<LO8}V56N{~Eak_1WX8MX9P
zJod`wi3Ule-o!6ZuS9SG3sOljDv%L5;SsRzk43-|vWAsCR$U#&&{pCaR!fPXXirca
z7DaoSnBqK?AS{eW4*sMHPhf_><ALDOu$D7hJ4!r5Gq@0zWoGffD6#}(JGY2Xm$Aay
zM8Mlv1E9)S`;*8;1X#>rcubbmWvmIGDP|$~#Btkit&4I*$r0WX;Okb>uR17ESJ3E$
zz08xvM5y$dMdZA}2fbCCP~45O%w!|vzA<WLD^9mQB=*WGT?yh3mODbeUNk@&iZhMz
zwpG0nxkv1kpz4+FLaI^$CmB*d>eWZ!KkrR-3|wvJyi{$aP=%m%Pf)Z-RJ1MkP&^S*
z@d3_ENBK1s;~m&|NZ1v1+kJWl%Z+pDxXo>{=wYCR=Q-Vk(|z@w?L9r~N<3hGEUfJ(
znRN}PCaF|SZ1=)#Xfda|GoidVQFGI2H`J%>bDlf!o-h42CF_@E=aVqE+0Ez~=r{tF
z?C2!B*zBs=y5SL4=cp^`q208Yi*w2tEd*>T8=<d8oSAX0dgX*)nJm)zjyu#V03;O*
zGec>btT!3&0E&9`-~k<*2rL;9gjJ(Tf_EJ^3Bqc5A~Nbl!s-1MX@e1mMSGD@nsHcg
z5SH+QIF6AzIF%^~D?`;Y5~s*kxJtzXI1bCAd!w8Nx_pFDg!X8`M;mMBhzaB1tY5$y
zW;BN(KUwG@N_~sv!Ec5_^Mr8g;_Fs1UaM(!8byaAzb5c%PpMw=9_xQ`^*e3k-9|`g
z=jvyx&1%MlU!i$C@TiXp>GwvxIrw^TN8mvfA8PoO)=An$s9{e;Ea6w;6-r5hH6_0f
zuEc*N3MI}DNPt{w$4?E+SEuNYUiev^sx_A*<>(5YM%7<L)eTu6Uyj)?07c`liUBSG
zP7IqH?DBF>BGB$F<O9cq5Q<exgqSe)Ya3hpDuc4)#Fn#|O@sAwDreW;Xth6wH)Eei
z%zDs7%6CFpxSCU-4PG8ZP>s4G+r3n}l3;c!uMKK|`R3}?BwdyJVqrHD+jN_#`L<q|
zB2ihuQrmx@SYQ>NVk9*#ih33H;wEelej)Y|So6MoQeV)MAqXqgPr^t*hSVTw1mWPG
zz+q+W6}6gpg_WT>4><z`VL?1EuEuvm92PNl!x@K_#Iid})sFLksUW0^(@w$yT)#`$
zNE(p|QpX6RKsBLd;x}O*Gp5S73!|~34)_PphBGJk{H7lK3hZ=Q>oe`RNed`*FgGf4
zO!j*n&D1nWMf;lo$={UME!nOnLh+PCEfB+#?@*Q*>QzIAD4v66cHq)if_TNsT3l*h
zo+5<H2Xv-&U7C7eZIT28EZeP04J5WJs!D~>Mfo4x4|fu<-l-YNQJn-5u!N*xQL+O#
zlV%nmQQR4#h6M{)@&Ou_L%=#x#q#Kx%r}M+j<Fz7uyb)5kSe{-C&*Z0Qw;Hw!Q`#J
zl!{Jmpvg@*|B1}{%Sg~#?6HOsZdUgWxvK5;CFMve{-`Sn7G_Dh((M-t?b(L$IJX?M
zJ&!f#ohaD3GkZR8!#4+|tw)elCnfP9`i*jU&@MF8X>545e@Z07)GHC5fMs{-5wQLq
zasrk(G%R%N-k@R%SQyWkUnEQebM)#RF|8}&$x6c#j8bMR%QINRG74Bi(XhmENtLM}
z6xF&EAuJ#eiWL%T%8W(Hnjtp?d=3{2V#RXDPW2uA)frOX<)>#-xL(wKaBIvD^UdSn
zE7hxOL#{Fogw?BhYMP$npNK|FvJ!aJ?X^L<gL*YFR+(&sL}ka#)()b{pT<(J1kdJ~
zN*z?U$r>DcCCz*pdQpv&NTrN`CjrpmPT^O!E2>IWO>QF>&t3b$m9Pm|;?=Mkl0+sc
zMe%_ItSpIDz!CwpCxFQjuaqGXMROi?Mi6bz`XXVf^MnN~5wXc?#>*kq*#u)7s?%)<
znHrXuwHxSaql<TY<^&7wK7K2??Uw2?flwd`lhdLL#LL`mfy}aX_!&vvABW~;9R7wc
zkTAjJAy?9tu2AcSr&4iUsrlUDGU-a({5_;A0&R}5$~0WPl16A!CLMNQpu{7fssM!2
zFw`qSb4Pi3@P`Dlb}s=-K_SK~U{S)a?6Fs3R<8tXbOHVcx5WJfEP>*B+9VsU1`-lV
z1NlRV!(wSzKsuiG)V>*61f#>&ndkNz*5*uj_nGYy4XYqvx!AU6XK+6aYmv_rmo{U<
zMsB#V5=zE$8&CCp{belSbj}0|WTNV0l?NBVGs!eC4LbYsV5=3tOD>FQW!7SZ=C10M
zLDE2I3pViMoT#4@XElUrxOx?fy@DcWvQ%(JIqH?xs5HA7aY+TC3U+0>l8jWZloIh&
zD<Gg>-SLE-5vqXY64VUWy^H_BEnyb0M8+(J6&mQb%x02M7Q+H&p%h^SRpsIW7UmCB
zUseq(HF?aEX@LiHX}pGoUIa#ksL9s4{Egi_mRZ9|0a^^HPzWFLI$_vQ{d_R(?~}2_
zS_OQTN7cFn@2L)fX7s5m?htP^fwk7vQ0WRwRWQUU)vS6|oI6Hn4>rVnoUdNBr?11+
zE5T#01Q)Pa(McjB)GILxSeSYxG{LB)jwgxo7@VmJb07Tjpx8PAhkykv1_#2$|KOG=
z2w1x$#~mXCEJ5WSY0pVe8RxfYSc1f1QJh(*+P7VVDiyyRc#?r9;LpP5Rdo}%ufzsb
zHCw~l|2+`8dV0IwbV0_qr0)+R^Ui{}$PJ}$FLM(`J$bL9gB@tW?@X7Wj+69|i)R$(
z!?`JVN3^^aK2Ed}rrTuz3tgdZkfbY^tl2A5)DRQDZvO^ucD%*QF-~!K+X}pr3)CwO
zu|Wbvp3IO_mPj{f-79HGJO-W(UGbQb1U}H8=2E0^rW7G*d(Dy3)(?=!BZteg`qhIB
zJOY-8=S9MHKuzWZv`K}6u&4r-3{vGFo?reVp+q$fF}NfZMWarY#Iiffc8!#iDz1lg
zu^jHEVXe&Ry-8%wk(&6?-pJC-+$>1iWHuTD<=)ZHY_IdhlA~WgWTVO)T!Xy`R@_>;
zl8|}@Cgq0McnuMXw^Vwyxucu;U_;Eu$HiWG)hmg&4TE}>VS@ySA`{%b^Q7BR3%Bq7
zI7v=)6()he@TXOA<nXJ2dL<+Q>wYf}idh|daBt8BETL&wseTeha-ypr1lHtc$UP$$
z!%_vTF)}srbkMLQ=N}e?RXRII1;L|Xr8=8nY~e~IzD}4Tgk{|Cb;6>66=vR<DB(Ub
zmi_jgn)`;xSYq;><5HKg&`@Ekjsau6PA!8sPNh0{foLV&%J>Lk)D?ctn5ZkjP_&Tq
z{JQ@2^M^dwKC}fwZ7|t5$HrdCuT-y2Co|M55gE8}yCBn*77y%9J8Qoz{0dM!3v9Sc
z=DviI<p(!{Q@|3chINaOrBowHAPMLUmMK&-0^9-8u>5JubL2Rzaq`^4mdsQH4QsSi
zw;`<d032y!&uKg<K#L-k+T!)0SPcS0B2!+ldcTj1B^M}J9?O?8PKalm;+fBh{=?94
ztLW3%Z>U>I2k8nL$HeFD=rAX2$ZA5*n@$tN_#-CmDQPS6!Xt-C+iVL8vdMukq`H#T
zD*<bH+`{bw30Rz$2jx@OZYQZ%LKCpyuD~r|kzO9O^FO#f00B!J8dkFM^?#AD#giI5
z>6|X&%)lTlAuZ_660l&Z)c9`Du-b{9IIIR?Dl&>0oir>jGeDcFMt)5wmcV&2-t$v)
z$3P`Zc=wbZHt%lZx1&QlyjZsyd1ZA8xf&#0VM#dZfYn4M;>BYkT1x6>Hj9<O#MQ>h
z6*r&QtKtraOIQYJ>ea}X2c;1xd7s!TF*vhODN16vv|3akBXYu{UVSt=30P7eNp}*k
zB;XP(U<qgIN@L>y01yC4L_t*YlNcnpGf9M@g|S{FG*Fek9C*UYj)?Tuur_A``$}vV
z=r|1xOK-HSyQL(}sL5EpH7wLbxOo_C;dJ$c{F20Rg_313`+3Gb0V5k2-{1%6Rz=H<
zn1{M)HzoRb?lSdCw_jMySxd%)^kB3r)T<}<>UbQ8y^@bpuO=peKvA!R6noW>!S3_&
zpm+o<mrI5YfRg10w*w|%i9^FmR=(>stj%%CyM(P*BL&PCLBk>mSb#GNRr8)jdXZ2r
z)Uc9=3Yx^%*)Gs=8X8uLa25buKAyu7CE{4+y~2pX{-gaRr=Yw;fLfy(D`Razzjo*@
zjKK#D?5=7mGSUUQOu#}jT&T3G1j9X;B_|<$>eYc)K>_Qc*9OI*Gy(c2SG^Kb_J_w_
z37B8v<xrv0>}COXQ?FDxR220J<f&;z2a-YRl~kPC^1xTAnq9JW0CxTdpMd|!MbOg#
z`RBe>yxNsCo{sXE&adTY+MOu*T20ih_G<BNd0N^)n@8rS1y$t{;}Os+3`)u!#8#pr
z=BEs&Z*9VY_xd6=u8I|KvT>@`8=iP&2;JoW#j<{TllK-lApe0bp_y*IyEk*RJ#1;%
z`$n}tKT=IGG%nEH_^gwAtlM4Gi3b3BmJ=`NpbJ`2R~^0L2GqoCS-3ze)WYl(cqOb_
z*rZPFCEMi!^~#I(Lt|dk;>^Ysr@G+{f+d8Jvc^!aEaqe=TIyAZh>2$;^J@_mu*wrQ
z`WPG~Y|SAdo(jok))mg6LK+rjRy=77(+s@z#D`RIEhcNeN;Auu2XdU+EK3e809p~s
zwVThk?1F?&4NHinNEg}$Fw3!Q^{8P<RN81)Fk9d0CHVn%XCucQuYI_P#>UC996E|w
zb+YT_tv`l=t?%Zdm9zqde2(Gg(DVo()dkWO+r$T{SLB4O>Qgo$&IadoOs8QznUz6`
z&@;)SlwOl8Jhf4C+Wg*Ml%&o?1Mm{@gTD?!1XfkU64O{aPi3YFKzAVkgr8(0MP#se
zC?HN~Epb?Y9-)MGVhqCi_mO-WRutjP(tUFgwrf_hjji1+c$qOwt!>d)j?Uag#xiuC
zd+Eqw3t@>_7r9W$njI;n>nLVDxC*1H@&2Nf^wF)N4v5PEj&#Kt|5RCnOE!kHpxu~p
z+Kz3^mVK*w)p!QMdvg#5lwX!e$LiCDt3?g4{GsqzULItDr-GH)22}dp+SLOG;5D$`
zXJqz`Sj}DDvqc1Mmkvp)D;c5w+~^kxUlVUb{w3ni#KfXX#V==`R!p04T-vZDGh3>#
z;Z#60p^dPObohHd?B^`QyR3UVU2Ih>*$Y=p@}r$H;EPdU&`QiZOsJKr&<fTETb?d(
z^%<L4F}8|43yxd_>`C~CL|tJCxv@nyE4uy-Ss`S>sa`pyD{b(ZY3cf%iIAaQ37BhQ
zpjm<zZWoT~q%u+ngKvtAtcg(8Zs#rBE<E8$@t(om%V0Mh5NhCm@KN9hSR#LRHFt)F
zl^7(rGf74-=q?_8r$}|!Dp8GAc52zIQzdX;h0uJFRoNgkt^nhDSSQ*tr|~2-QCMY2
zmDb6SFc_+<xjtxx7L~CQ!G~_Ry`DwEO@@3QT6mwMSWV#0v3;q@TFGZfSMmE0S-648
z&5mn@)7!wL!dWoTJZ@5mpfPd#;(~9i6!q$rB#{<w7sRWv>Q$1273huBD**+pyQ){>
z?PyZxwcEv<>jyW*00B#A8kSMO66vU6F$JuN2kjVJJfJ`AIIO#CSR&OptgwJ3Vw!3;
z@>rotrrjmNSbqH)RyE76yM!_0g134*vjH^$D@?vKR6qP1WvtWLeM>lkzaeHlXo2`X
z#W29ny-Cl(9iI632-20XYUl2+4HlC0C?AEI+!e7`n<U&f2it@<Q?Io0t$^X`Rg;aw
zLs73pI0BYMy%LX9l&3*?oV`qe4LHe=`cbcb4gLvO|99Ge&nO-l@gkv7!wLylOOg>m
zSQF1c4T~jUiNG3G^QK0M!`ktfwbLq_0Bl~JE;V=5*%%@YJrrvt<SJSBe4TJ%hYBQ&
z@iG>}D9+V9&wHWuM`(ETNLn9?z_9qPy43_NegR>)gR&;%mNTxDt`>S_nBatudDJVf
z^9}XtV(Cg;4YD@nASpX2+ro$>0R$|PdL>XcdFqwGcVvosB^;g?SEDV(Vz0z{&r*Zr
z<cqx$+s&wti3gtpyMQH^24TIEQsfm>!>I;g3CWp>i6yD927;IzhPc!rYpF?PZg*uW
z2$yPD&>2h(V#mo3#S)L$1X=1)2s{3I8y&MSmcfvrdT2&tg9xbiy`LE5$@C*>-4L-s
z@Lej@@~qqMGjvm@OIJ6Kx{`x75Hj>xfmbW7*7!a`y;5iw$aax>g~eV8GiHhxqg3}w
zw+|EpJVMIa^YUQ*I2;1p1S{7MZjDvIlDh?A$xY(0APsA%fCcejN(L}&V)?USBTP6U
z6%*62pcJ+_WUCUnOJdz44om8lJMMKt!3#mmL0(3r>hS5qqp^h8iUMN_v=6?G3`7_|
zJ(AX7@J7AYR~#H7A-zSb33rvQgi=}6s4MAfVzmT9yD^`5Ta+KBUbTnOyw?UrMyOYE
z&{r|sZRsn^-IgOf4G^#>Yq$4%d9Y@+b+9S)!yx7Q!M))Uu&T+Q7YPH-paNE#2lOY2
zDCZt9d@(F(%2=>~1tl^#7LGNuhGO0SUBZb}oUpsfC<Jkq!-2h_>j?*p2JE@HGYc><
zxUi|dw-kUvL#s#9BI0*MS8ZWjRV0)Js&r-a<WAC+wB}>+*9Q9qUIFAz=hHoZa8Ru3
zmEZ!_ZPlwfn^nNN-NNnvS{hoe4ArUCdQG>LhJa;gFBB=~H~jLTMDOemZigEQSYp$#
zY~J?QuvmiHiwf*8DH_&45=M-YT&H2BCe?TiYa;Y!(>5JHvt6cPO{|TuChtAuQ)R4o
zEA1|02`w*%N+Na+MpE#+zocXx@CaKabQ{awsKCd(A!t3ni-g3Hu4r{vpN!o_x+)~>
z_u63XG<9;el9(sd4&|;kyJ*WgcT}%rZK@b<7kj0x_J&bivh<adxh(1xM@loPSAtZG
z7}yZTDF1_xML@t3$9&8zU`cIi%F?h<0ZVSCVHpIY77uV~Q#GviJss?{Qf4blb%BNz
z%H|Lai<{pKZDR!J9=`X}uw3L842;Iw7z`RR-xFvpDm>Om%^h2Oh|ohGf&F@UtIwGA
z?uBNY3HY;Pd!9pkEy$Dn;^nS(7UC-`_EN9<g{RdPy%JR2$Z}R;Rxqrbq1Y?AoqDCs
z9XVicC680D6r4c;RFpO8P3l!!429~1r{geR9u!Y(6hpvz)T>{Kt$;P}5ghCwtcwIJ
zj0)1QgeLUR7Q+(EC7Ko{5cnEaBMyrcj3Wleph|2tCv5kbjU?QNDZgjVau*S}pBR;<
zi;Lo5pj|RTgR!7IG|tqc0<z>+#AKauqtRHW61&-m^8;E%ro`Bam5=3;Rjw@7J4;vk
z{&N@UN*&~W-&?N@`W3M<JQCi}*ehekxm6FS52$af*ehXn6a&>OX=`&PVXhW?C3v-v
z1S~c4DAy&!CBo7WAAAhD2v`zRixS9Y)Ucug){=@MV98Jo3zFwBO@XKHBpwwQhjodD
z6_)C3ktAm}DAz_#2(1gEPaKxix{D~YIE&(J;4U(j!Bz(uON=><jX`Xh@FzznJ!3To
zKDD}y3*Qckw-V#Djqb!S-AdZhmFz?;x|Nf$Hq=TkZr^LMSKd;&!<&Pl*ekwzC3u#B
z*ejlTCFn?x*If)&uY@I?w10W<-s+Vv_DT$oUU>Wueg)0~mKcV=^)7lu9G0zJb`8Qx
z*-gJchTKs!tbe_yp$H`C&%zcHcaCf~jl+_lh+x&Qq(dl{cRpXM;^e0lzqgDwz>u+O
z9mcTN2|X4&C|S65-blo7ReiFUCCoDWCHUyt{DDQZqGgsHawRt3n9`LHiv_5Q+q^UA
z3A`$w*}}?PZkQq3GHmLVkI)}`CAJp9&F|3ID?wL#V=8nEDvNq0Ea{~E%Y*k2u<Wr{
zVs_~fupR)230T!LMhIAPFAYo1Q&Yb)6W!<_EFkG^H7qO+OD+k<p=Glb*Hj?9EDlTR
z*F--JOKP2l#QDjgSmNkK17-`bnY&cU603bH%`c41dho%p5A>rAwNJ=Z7tyMh13q)Q
z|L9@jY!87a@JgJyXonz)m6_>nOVG(AEq&kP!(*=mbZ>a<l_H0+rLWpv4SspB9eX8r
zQLlt5VAZ=&Ba9{<d_J-QmYAmop0R$i9_X)OVLa_PEQ{#QSj`>a5p)7MIu45;geCWk
z!y@H0RlZdS4NVf}G@vNEB|qnhyns8uQ7E4tjU}e0#dn~?*d&4bgkLoe9_%pe^}rz4
zBVC>C+~}tU#|B<a<kd!cUEq~m8hdq>di6?$=?=W`tAXm(lwz!UrRztW2WnAJ82~&W
zjNw;uO9AUquYNa30+u+2_+|mC%$7|4MuV`HRMj9X!OL*ei-dR?VZswagxtdtkLpF2
z**Z{JUWRC<7_+APo1?j-LP%2XKI?Tt=^TnBA<y3?nhp0CMPnJxxgsX3$~35U9{f?b
zUa8=>z4imK#2rz1&KRs)wJnljubA&(j#aOK*9OJGd=vHRm&IP~DR|PAaMde;d_$Lr
z;>1ifrxDDB+a;=AiKD13{YJ|>vljLUSPu~V4gqUAhZ^@J(D8B*)@d{34^ic5^CU>(
z;bm=NgYJoD4NIi_Mk-0X5bNBvRh7o|u&TSygodjG<}~0KZ?r$qQNxnkhhoX0bnYQz
zc`Tam9!w>RJzz=TzAYXx>wyV(5UtRg>kV`(iyK3tu69NStaz2N3Lft#T`5#VAyKSq
z+?K@3Nzil0uY0v5B*tFd?ajfJ3bV;lc^Y}Nc9IPNE1We?r%e;E?CO;mTDP!XnSAhp
zNdLe8{=eL4+gtJ3VOS|_%EdQC!vc7!8rG78<<C$7Yf1(DDB)-gizr~d*)Gv9Vj7m%
zXVv$L!;(%KmN<PTiFy)sel^fEU1d<)-P0{ryilyg3vICA#idA*;uK4;;O_2HtT+XV
zTX82iMS>Q0cef&eBEjX&^UnM~X7c6E{mt$@d(PS2xlZ9PAKGM2X!%yO2fKgcdvsz3
zyr}{)dN<Jjy;{-aY^kxI<-6nKm1*JrPT{sGmgSP=9m-`B&WU79X9yWTQ@*S60sL}M
zZ6n#2)XE-u&j95?(*08)qS171m>OE#W;fcx(4gIp@h~D-MOv;iJuWhhqhr}F@9igb
z#UV9KRs3=mL+okV=!haC*gznUhFN7?7yuFG8WA=-#Nj8(+8iG}i^VOkyu@<w5;;&;
z_M7P<Wg$tE=0|p;{46t8F7q7G%o-~&rbxnEj^we`1#i68R_g7|3wOq*gesgnnZJv;
z(xo+upC%J^_YDh88J@%EUxrq$#CW+(y!HX)&jRZWUQFc~>4}%6|1sH&FIvOL1*hV?
zym7gS`ge2pej@?p3=14UA%>d#C+-hK>wjE8P{EIjl}+WBC`W$XO!&As-9+hP^}W^T
zS*5YaIbDQVC)a<BLU}7@R=)1HG0ao$m0@w}^l)FgKMw8K7OjS^2vOkf;%0f3CSVX}
z<eZ4y7@EGEfP1$qmJ1n%xVo9F%Hye5a7`s?mmYK*7&_Fr<FrvAYYMunLmVVN$I*4j
zD1i(bqS!oDzL4p#KC-|<jv})JK~RR7wn*yuzQCLh_sNI}{NEfR!%+6VIT2Z}efAj0
zG5oh!SwWqEr!%1+?gS3<>fP!><Nuww-xzInTl%TR`SolyA8WDFj|*<{^7!kW0#U-5
z30@Kf$uS3fao9j*ehuEw+zYr<l<1EYOh)95_tTM?n0*Q9S)tCrd<;-*nc8}DCN#-=
z7};lF-p^$BkTvv23OB|(_t+p8LTU`1>1Xh2q$1~<kV|h@5+OmcY4ZkX<}lTOwtQYm
z5LbI6*#nhkpMRyP7_6Jt;B47Z^Rr(fxAlT6x;;8-@eCo3FC(15;%X<ZDQ~|6bk{#|
zy~6#VnB<@&dC~iQQj)3cBeRt5JJDR0P+~<qUD7Dy@;yn?m(#hq7)P5@(Mtp)1A^}R
z@%1O@AlD=@H;~M@x;O1Vn!NJkEzVJ-=CQ~EcKd)V`U{oL#j%~Fsc<XFI(9nsFXeyR
zL6D&d7?%1bg;5Zg(%zEdJ!{BS0^%e<*S$%)#i^+E5>}6j!0dQU%W4?GgT};EXRpzN
z3c1O<d7tn_goFJ9cJ;5;a6%Z8wZq^IKjLM@wjwV5FVzv*{K-5cwxgrm#P%J%08^3u
z6xs@C|AML%x-C87>KZNKE8oQ_&e*3W+N}jLbiy?5Vk-d76LvVX&4!fcRiWdwb?1rF
zH#%$iVOt%7Pk5>;D*om|Rs#mzjV!2QQ@)9`86D652?dyzg495NS#g_iNrcdom^#rU
zDp$V@3+LDGyqRLtqInQ%!(eR&_iSN<PYWD#hzPV$c`EwargsR)zDrM6LrlTk*?nEU
zDV#`ddVxLBd8rc3Qh$~jt9YNq)=AP*!IQY*W^*bPPt>3|VUS|Lfyhn*^3$oDv{vii
zPzNUKC6CiH3g;SciW#)~lorwR@rJG?N&L*!T?w^mw$@H*fx};^6$64@W7>U~gmvW&
zios(;Hy?(UfqZbvd{Rn4Tz(e0n|~nMCDz=jW~)HD?*?5pAW0Au-64((NZ?QHj+%_+
z!0TZVC|;`;J5~J-rF<-SbaGh)7t@IW`+zLc{Uhx!Be^<3t^%spwb9aXJqe$XYRt!W
z##4X^Mmn*|pmP*1_7hpttYi+~KWure=d<|9py6DxLdRRohNk$cpqcHtChly%fP+Z0
z)caVl2XV2>UxiPVH$RcNL?5eXraZd_6jc4%Wk~0D7ScA+w<59h*AO8e!f0r8o*DXD
zZ2v3ti9#I3Mw!+8?%^an30;jGgEc-iEJ-yRz15W;{|I0lU*ZV;#VGFioWiZE&BsJ6
z<!AT#ZFtX8HAy?KAQWW16#8EzeqyCi_<{4x2^j9A7LC#5&JR<rZ>>g48HR+sw&uZv
z$p?-JYt+}W%z8{$?ktr6^Qqwu#sL(Mh0Ua*sL(%}@032ifeD5?<sCr=^=E-!>WnIV
z07c#VB_RB~`*KkBQT2$H(g_#c&&{sjxbCl=33L=%QY`WUl&ohwo_wwwXIfNbR&)H|
z9!Vs5?hOc!-VN`OSK_OOJI+SB-W(Z5^%?0yjo5Z(<rA=6a5q(1PXH73D6?KFD0!d#
zKj*(5AN+aVY>bD9UiSXA-a9qCFwt9iY++EY8(~D#`xW|9N<Y4m1h1YcYllAq#&Xgv
z7z5u0{ehg7KwL+AKqa7VqH0y74I-h_b7`VyT`1{Rh*iB|%uv_spF;fWYN;xHJOx5v
zvH)vxSm;>+!}!n0LZhzp0N*SQE-P@ihC919fkLOyJ`R{t85)+P*b1yqF$+*xQ|L?h
z@xtRx+UciBaL}6}alo+GC)m#_N{A?0E5n`s>s7mGf6)nLlMMDN6hgPchF}sG&5KwK
z{dIB@jng9%&rq(6!txO-x&wI;>;1rm@|D}`XqdJ7=pm_2XXW6VHEQN4`CPu2W<OXA
zOTYE|@@g#(4VE&{JXq^77-CeuMY@*w>rlIYzQ{h~AZje-i*D!{yd8pI6H+EC<%9t+
ztnI0iWqYh&Wm0_e?|ZL37R6hk6Fn)<=KsglRBhQ3{4IXIN<`F=%CB~Wyf9V!6CZbZ
zP{+rOqxk{5cXv(_1xZoI?R21oHx*m{KcoS}c+-xb9G41@8qjuza$)7(q>(T++D+a=
z(oXjXZ$O9N0nlXKxcyzZE!KPgZltwGY3KiwLmtv`HCtWHS;!X`zH#WM-a~X4{hH|D
z=_~nAUL<g<S}JfJn?rvZ#wPwQ1ex5%tbVT?5Upi5Yrd)xUPx7CJ<yidR`B{-p4i)l
z`$FUsp$uz)2=|f1n-zvB`94ftrQdo@M8`E9YSeFu-K6<6Hs<+`3J;TRjG^pW(1H10
zz!3!da^Ob=l2}92>72QHT`ai_W(_t+$fNtZs8WGUk}AE!7DEJ1qY3=cB2kl(=IFXW
z09@c5Wd@s?+zYrIy3nh(!(PHqhWJtM4PgnL2`Izm5yyD~tj$tAM5?V;Sp=t5j*!Gh
zs(=(#)(Ae0dXEErc?%zL63S)EK3u#v%-YJy*#N$6^7K`*)uS~ro&eYKu*G|M&}@B*
z97yNEn7*IrRV0jvlf6hrhM=umV7La<d=XIt(kp%CZ!aqJ5ZUPH0~<Igf|!*~?1k58
zCSE9t+))0*26H11@I6{H%ZLbr)#@hMk;Ry5juxvsA@={P&tlaH1IFVscB8Ol4b(@T
z3KIGh)zvhIe9<MjX|M)?S>PJo7tB;SpOoc~img;Ij%e&RQCjZp!hf|;zkpgExjX+Z
z27@Knmv&wv_w{&IaAtvsD>YK1#>d69U_xL2A?0EWR(W%`!pI0=AXvfREWllr@LG_4
zR6`LVKe7pm3q%BlAWe6A_~pJ~%ku9{8FJD|aRcS~D==0=-x!l6?KjG`Z7N$38hqfX
zhQ0L&V6jcH0;^IEI_C)i2fScm06Ws6x-h_x^bxN9Bx#}tnS;OudgZU*e+#SOF?Z66
z^fdYZZZhWmwwZs5^S&KGf_ByTOOH;UoUNN!p=a<dGMv_lJpuLyhko4pFz&w|3qFt)
zOJ*x<ZuiDHE-;J;a!jfOBU0_e8Fs1oSB?}JI58?@VRze>NJ_Qs4R$Dpp_#hxMpVd$
zls+3UHzrJ+IjuI<V1k(_yQ%iSqXzA?%ueYDr)RbuM-`)AJ(PB_)8R$+9ZqVbUrl*|
z99l65g?F$#Jf^r3=05(qFp^qrBYf-P@o&;wRFFYI^jlk=bG)k=7e!=?_1AjkPE<fk
z8OU-WK3=QBtCI{?OWF%ng--C>Yv(mW3L%;<L*6cqvZP2X??G&TlQhh=j3G60AG{u>
ziv^YdVq4gJU+UC&NASxCutgGEVT57}>NUb9i7Z48jmQOqA_e9jcyc{WD`*zS&x*H<
zV5&Xbj&G+B-lhNQ7su^U8e0cv<+Xm=gMGCK@ZR$IJ09#1(pakx_b6YHw`i_$U&z15
z%;I&R7Da>3a1OTVz?O;+Yqm&bY;*-<Abv?*Ia<gn@$`CcV~AG=hFTzZJ{-(-An$va
z^lKAD^tZd3-%&yYbuO5G35kZKsot^iW0gy!h9?4I!vNvjD7PP-&PoQHz{lEmniR=5
zI%Y|P7^1JrTUsT3%s7{_#Uystmi0#h+<B6vqJTD};g&~+O)s*4(QY+vsg&ygnJ^xj
zF`ORn14ZUq542EKVt&H$v|FqT58rq;WCxdm^b3K}>%=~VF{j4+JnmyV6dLCV@N)%Y
zXb8g@56FA74CH*Y0K`T<5+v2(ivj;|QLw??F+D7q{raQ&6i(n3K_apubm{&d=GDQx
ztVpAeTjZLZXvIhh8l6h}>rERl>DU*lx!5^Jd<0VnRe&Zv!OB_p(>kPYh`*Gl+m-Z>
zKda>?YRfvE)uVAWl5jkH#p#!7Ul`hfrl_z;>5x!0HEaF(opBtt|4eFnYA=OP@2rz;
z<~tI-+Et<vw+=VxA7m%Xhhiirg~SCh>d*&cVcV@PS~M0zIYmR%@f$EcZj$Fqw!iF+
zcvD+Q&?QcB^6(IZsQy!AB=?=Ez;ZxQs?WJH5<rbZC%YEe7rA;DCT)UvV{hF!y?OuT
z2z80QXM6V7>(~7w?``pAzQ1<)PC><}!=;G&VqcQ~M-`s2)Pi142{1w)Bsm@wmYN&?
zx1Ze`kn_eTv=oH87hDX9h=%;uKOyqR;Ai8(CY#6ZwnrYX2Zmk|o>YaJtXfN83I4%~
z(#$jYx{zKV?oFG*f&%jK?*?vH|GI1FH;PC#rEs_Xdg&%<1<DBF<fb^1BtLS+)?+q7
zQQjeRu9)X6-Trs<x-sYmFE>*5Gz|;?n{><JuMLk#iRs^h7Ura+HajM>Ks#SC6edEK
zuM=n!)o##*8jxe(DY*~8k}s4sL=$(6ejHmHMwE*KMw<bqBw+^Ny+lzk{S$PuP1ZvJ
zH3EdlsxD&ZwaD~zZ|N<hD~pc~PVu%oVCPm;U$hq5g;L99pswlX!L){l&zpGOoM!#V
z1^R_W1JYt^HOoF5Rtd#AQ1>gZBF*P*yw=C}!&1O7O}rbDFZVaoKs*)}{m{LD97<1&
z#Ega}f^b-iJdA?U2N8=;RRNLHExzxq0a=ul;Hi*R(;yBdDEUwnB7+T)xsxlcqKJD(
zy^e=fW5w!Bu{2y=>t}SS5zKpZl7h@-5z236el+3^a}Q=Wg%n!C#Z$dn6g}JV>mPnc
zG=|FW_wdX#zU}-9z~|>9%FItI`R<4Lm7gMSRqvu@(J@(HOQc;~LZ8|>$s_mkA1g67
z<^ss=$FeqopE!RVM#$4ViX}dS6IwR&cz>diQTMz`3Zg^<c37vKa?S!ballBVLiEjm
z=CWj1vwM!*{Bs=At{5nc116e?utlBoeWlPtq(wF7)bjV*B5(WaCTUjZ>ldKu%`&$j
ztpDig4+Y*cV8QxV<VRJx;GlZUn5sxX2oA3g=dZsMMe(T>_dsn)SLeSQhvb9$K~L~o
z?@8+g-g~q}``P!0Wj1&-n#iCj%3}BhS!MiJcJqjSg6qnsqi0*@e)<aKh#pZkS_DE0
z59+WMn`2G3I6V{_apaoSQ%eGWwvqqd_=>~QPgx~o4C*4^nGCV3j2h5cZ$0sG;Vlbw
zXMX@vMTbQm*r7SQNyHO2=(|F8K_eP$r(f*RTmb;F=Wj(QYCOsCOl6iSeUsW9Z?2=D
zuX7)(kG{pnB%8pW;<bo35UC$N)S&zQ$RgmoDJ)lokk%WAgNJ@ay(k9wUse8(3t(^-
z{Fi799YJ<Qyg;s8aX(JdtF~^fKaZ-z)-2xc5P7Q({WIN^&q2Ums%vX(Xp?2icZoC`
zkNrb(xZyv#Rd5cauo>IFbXu!vquQi>HJ8G-flKJ3qV~BzBhksXFaSFF@ayjYq%?d-
z(mRNLxx<TO?M9D(koDDOO)E*tqsq7Wtq#y@r1^q4C<8^`cYKs->}lugd4KODje-M=
z)fQTe`Q_$D3G<mra%B<C@SgqLa!xWV9R-oYM3hm-n|{#PStu?C^`DeUg=(cJd|>&C
z^y7cHk`K8*-^hoEat5*+Mp*pLywSo#(v7^V5elB$ND5T4Up&;v8&>7k{m9G8H2|I=
zEExCCQtfP^&NG5PYbl1DCfA%l^N<5cpJJ~I0xkXgZB4ZZX?M;B_DnJLaUXwtDaWq%
z<#a%}obfAwI6jL{C=3vaaZmsp#O&dOadY`}`bChg%B{SGa=uMzB>dyJvfeEJ_qH<z
zmhg2G#115Q;><)oM5I*5cqc(8e`Z$zU{vhQG$OU$ESohzrtr+96Ie1wp?Eb1hYl%h
z_miaO8X;BGtTgHv1a?%bLW$02{v#BOg)5X()qWOjT>*t=XwSF++~e10%G+?>%Es!E
z9BJWuK}qSUNf}apSN;QetDT1870^paL@Cc<W^C#o;eLpI;|b}+XlgBX1I+!^3(}D=
z$~F-up8r@-nx7kQs-;SzjNB%w6C&)|!W!fR>?J&gO$dyslJ$NWxkX~iA*E?ap3kB@
ztm*#zdVLiCe{&U__SyKc*2Ocu#y#xVt?fmEJuNbWIGU$eIXPX+c3i*C#r6@MqztQ(
z=M}$Dmv`pAALUh%BvtJ|4rdwQg+R!vIBe?WK605>Z3)OuGD?|IqqIcEW3>fjtO+gH
zEJ9i}+8XBmvsVY>cw>P-)-6!Q(`ZFgkbUheLoQ7szhkHSD1fS!#V4wv*VkgN<iTYL
z)|izMAvSk~GX|D4pc%ENL<2_8$?I6=tcQK92dW(9Yqvrq<det7Ui?eB$+vj)cdgnS
z_vUwu3R$z*@0cPMUHgZM9VV^cV7IE<68WPkXZmUq@v<B=#d{^c7=n!Hx9F_a$E3P2
zdStZgtLG!lP$mC>P-K3mq(f0)qWjWGZjWEiz`mpI!pj<skG#*xnnqClV8K^y8_MGG
z7OR>s!repHX#2fo_&*>0oxocJy$PQ%oVPG>zPr9bnD6rsfKgwz+nqUayrtnBc(#b{
z?_SuGq0U+tSdf3&t2_AiV2IWk@UsLspa+JvbQ#0%UF6qQZjk7+%(ZZ%o$3V1cQ!`g
zaa~2qBJvW=kCS|nZnCw7a-7`q4zHPVOl9A&KvMpn;@ukZkk3f+2fYG7=f*ySr&KGD
z%o;jn8vM^^&NX0~LVUQL<CVe#g;p`@p!PT3_5~&0mFoK_Z4>&4sb538^cr{D+~;@?
z6>sx-!en-?n{jNXH0`XVC8Y?lvt2n3<Ui_axh7QwJ-8);6hLoX6ndxkVo^7ahrb{W
zk?KIbyR_bQnZj|>yR>&@Ao?AC%-&L<C=#)K3rA-36o=}ML0T<1;Hm7iU%B8)Bsdl-
z?D(tSUA|SFnx-#swBD4doZFyiiMHgf2PKXaZ2ap^ksNp?F)wS9Yay$0)FGKn^+?w+
z{`4!R{G?!1)G)7S<9@5iIIf8(PRH;Y<CiX!?U4y_BUB*=yv4&B$>uD*7IcV}d3glQ
zA!*xRO|Nxq*RvCPgnViZh<@f@xlbQN4%r90F!d`~<z_ZGBk-LeHmFA)R`CnDho0A?
z_PY!<eoRkLoz+AHVWUzLX-W;dK7j&q6{DQS29wh{4=Qqi5U7vH-=rktcT6;(Lw_*A
zwlxH8%N|WR%JV}d0ftqlA9SgyExz79c0dx@mqbxZhk_T?LbQoRmJ}iZV50CbixA<S
z$j0MI?2Lk78`uURYoR{3;V|>v_CwMcRM~Qn^Z_y{&i3>oD<N;h3l!PT1eO1yd4eXA
zSFuOZ#Hv84ffG_{)QiDdGkTXwKbCRPmb7asOQZiba+kPzN1dl4xs-&r-b`}x5XxSw
z9K^w(a3^dok@9Um-+C2iHEiCa)C^QTi*+zWo*^#(Nv%ak3CG$r+8fZ$TpdSSBNgB<
zCho&Mp=kUSx^q<nk{*Mv*{o4%u;@me4HZIJ50mPtFYm69&q>&J4|+v1oz)WeA0zVM
z>JP`ue1ka?)qFu?VDj?(up~ldp3je$6eSoaF%zBz-M+B;l)50&*W3QX#0es6j>1By
z?$p6XGfS&AZwKDj$u1m5X1_mJ*31;Fi(=w@$GGZNK1cqZYJgmGCTN{X?4NZ`<9Z~B
zsad*}Yr=k^D<t{4`ELzKgw57SDi+Dk*}|-RkCRruz=$kvG&}hd0ujg~I!>Uo<__?K
z&(~?cBjhz7ze>{iV3fOM&Gn!vn+%hQ%O1q`3<VenE*i&p7S$r{i{qNBlOLMg2#)(E
zc+g7@Y1vKERNfN(XjrdTu5l<kji$^K#Q|aGzZ_~}4^W|dsQpnsC%0V)Y#1fQ`~o5a
zMt1^{eZkH!Z_QYkTGth6=j>@XdCseKms$6k{d#JjUc!UpIKmnEU9#$IHz>^tp(2Wc
z@f4AN-@o4KkTSB@=&T2MMs8THk_&vR+IpQt<vu&AtY3N(T0@K{<vSS-<(NpK)@XFX
zp5%FwZ|lFZ47Pv20~pUmMt!&MkU4DWdUw+lu9g1CNAFQ3|6ubK<P7ZuCb(*@n9+M6
zhgxtX*ScyN=3*j=e1trRj|ZrSkT0nLsc}dk<;a}{;OnE|;HiHzC)suPUxOns35MR`
zg4HN7TXifj@yp-7Q5XIuoNt0*l*L#6u3aI#mYkRM9WQ9;;A}d?+3|c08MvVvk8Y9@
zB4P>a>=eV!4P2ow`g#SVdaPR|BxRIb(c^ss!54UYCvo>pc}RV&>l1^yxIN~9R%N1$
zJP3yZAgv!UQ4lF#78PKp+R_JEBoPHG8Dc`@2oN|pZDk#-R=aJj-hhyQ<tQ~EJ4WRC
zX3U(I?f(%4K*0(gWqT}~UY9T%aOr4ITn~{(4}HH83{vqqRP+ZShMyekm(C@pb5qvS
zowoAm-Ll%{K`<k*axKE?^PY^hyaR2B>VSaSNgN6-rTZlwg1zf|1KIY<>4Tk~KZn7t
zbtYx;$C#+$75+o{4`q6Kq@DmtO=$h-A_x{#2+VDa9As@ud;P}#d9}Rpy@s_I^3NUY
z4sY>4NWp}Uh2e&`!c<gTZ$jVL$ap#Aj{vJ{x4RtG9GsW+<NlRO;*VmZ2p98LgSl7p
z*yXK9JIJ0vCo<)+iQks2Wg$FLeMFLi+h1ncuxNqi5v?+`8fWovI(i*DkC?%S-#^L^
zy;9oPN?snYSjW=30bV19SoM)*@7Cejl3}72K>*4G8dPfGkn~dm&C}kmw;z3wEp#iW
zbHqM~jqBW~K!C?&H4@k2#q@An@&<-UXTcINSS1j+Uq9!*3pqxXf=RpMlhx?t-(3B&
zR6i;A4fzREZms4ugIa$7Lop_!c$wD27^Q6?lHY^oufF^Aj!9?r(}Hz3wPaOZ;Z9@=
z4*7pgnE+t!LV4g6KNvQJd^<jUhPBuplsn-zi6MPdldfY(z~`8s5(prHzZB>x{+Syj
zxyO?ih+wdL&&A7%LVd*WmuEqhH==y|a-!PYJfxvN0lbwNNi11|oVJp^?r1&V&76uB
zX@f*N>3i|g<5Z>iW-Xi`^MI6W(*Dr*W5x9Tgs<v!Jl6G^aDIbMFRHMb6KcL9*?fx~
z|EZ*#&oBEiAy)3hFDf8z;rlK0SMnu?q)w~AX06UG4nMaVZ@}1ncQB^dUnavrq`&s8
z*Qju>lyf$_=9@K@){uRp<1+6mBi{%&sE0_e@0{)E$tV{*C5Pm9_iX`DbSf*NNdDY5
zY^B9Taqbm%RRt?jpzQ)wSLpk#d1&Xu1{H#UEm9x8{VnR<QT$q0Dgo5buPVs!Hk(5j
zQs)LwxyF0*PHtLd9E8`#euoz+7~KAU4K+4~oEhNV+3!GDy%MI%OBe9U^H~9Rdi?5$
zwE1Fx-s{=>L_+p$r4fK-IqEB?qX8q&ky2b3Z+zkq-M4#j|Hd%D6a5gm^`auW3+5*@
zokL%AkGMf1=0D}$7f*k+352>n^$hyAeqm_;@TYWy>qfIH*oqe%mA)sdFPG8@MA_D}
zW)vQ_Zu8zvtlBX~$a6ZR+0K`O;1jY@-n_~MK1g^HK<0-O93(ovFu^0FP_GZo_pkRV
zbKp-Y-9H=eGjb9GLi3rsM4l6rAz5)nO=8U3F1c9tRYpdP6VjPkmS46=^qzRym6@pJ
zH~y?psa)ap4*grcBY=`J8gfN(1XQ~mQknSvNC<@|(@-P7jsrNk*^2ge0o~f6XczXI
zFg>NB@0#<EAZyuIJ*Rk)`4a<Evk7zb^wmiW`9EaYzYUYYbg&lFc|XIfKhU%Lg{qcX
zT{9u%Gx?)13D#~B#ta+3@={JUxrf*@n(D^gtJ~<B7cyt;(a!S^TsYhV3y+^-#Ma%O
zJ#HWS=a>>5zIDNbopS(1Z_tC>H|i(H2JuG-EBDtHDVQpD+{iBCg*wiMWizFB_!+5O
zFsH-%4Aa;IR;o3L4vDbSpNkvlXdOvy=?G|kO4zd9O?8WcsL|F~Jw-9Ntvn*M%@eJt
z3n7TN%Oh4QVdz13B7YO2LetjiOpwr<*N<u{m{?kJ7C10Cj&ugw;*~KNzzYsl83-D^
z0p_0xXgdGWeB=H0#GZR%9OW7#xYVzBz(97euLOhp>ys2hN8N?&Iz+~g1Dd&DkNkD*
z*C|cAl?4{l1$-*$O&$C6tA&gEyMJ|=<DiN(L)IyKyE;q7rM>Q}xB8M2tGWVR-?y$*
zD;S)L=dpW_;gU4K$hk$7eLMXx^J*-*wipktSZg&&3gZTBmpQ(git4D>MwlQGI-LMA
zM-dFyn{)G>tZ(R4vUiMY8q?orQS2x`fKT%#N|y=CEIe<E6GwMtCRb~*i7%IafoXSs
z$!)e`cVy{N`e2C25fN`*se}%#cdBR*S_@IHTulT=v^n~mjmW~h#U-w>DzMwHg!)mk
z#8L*{YtJSF>@6deg-!#Qx!0E;DKRYS{FZVc4!GIZ<7GemJDNQ1d0P$ktdyA_Ju+nX
z9}SqZyxODu=gxuZG}pV0O3&Q)FphD%TiPQgJ8OwZ56YXls4*XCYs&ROd?K5rwvbQx
zJHLoFx5l6+3z`p0_Em3Yt!}j!F5{j8NjRpkMbT;-pB9+FbSzqb4-9&|SS^?_z5caM
z6enx?r4SN)I}V|SW?NrJ>P6~eavsJXYBJRo%;{dB&AQJfzE)sfwB*9*@_o}sbf|fl
zG<2!~UDC)e-7dlX9~UrNPSIu?yrOF>ima|;-;#XerMv&9EggL%2h&KJiDjJHjlPIH
zSbjWe+__T8sk2wtgB{``U}FrN%eB^XM|NGSlN#p2`!=ls=Z6~h%iQy$-WR>+23}1z
zZb^qAaVM6D)b1kA&Pl>7q~emT%6i5S@5!Xq`GdBUJhHbD%snOEgE{u@&!Dp%6|w5K
zzwtuZj+Gg~oMiKT*Gp@3;k#VNo(fGw?D^EXwDoprCRso^jVa@>2jiFNuR$scaxLEY
zo$3frd*VQ8SkM%5-St8H5k!u4SSPppCyXdlG)ZW2#=oG;s{LukWVZ_q_ocL9(mZIW
zV(}-%a%nr;X=<r-=wwWo+me`_g4;96cfg&NJN<H$W4_ba&-PdMX0eGu=MAel=evz;
z%OO7l+$*cp9@}3s+%`H%%@Y>CocOL^wLb;d4UQxG_S}dA#u90kRuB%AtU(QXU`oy&
zy2qN`TEq&GQ4Ky3eRXS6ge4V3_^UafA=*=cne-h&Uy%CiQ1?2Ocrg<Z)R>q_-g>O#
z_Os!sjbNnXxNH*a->e_AH-qx|U~#fMhX=V+3>=oPD&&n_@*s&Qo6#+V;}X{3&Wnu{
z)v#q6?;{D`%MA%!7=5)yqZ5CN47IO{Lmu43-5gW^3!AYQF0^IUWFNAssa7Pwy$6t9
zab%{ic31)%T*jAMC?}|<z63MEuT*e0_>{WOGgh@mlXZ25^v28}rO;y?{eyZf&{7kz
zD6}bQ4S~}+(W~npi=XHA$B3@&Du;omfQB|QH0u!2p~4(d_p6p~S%!GkGMh$v6#qIk
zQr0!mvk?7+*f<w<hHlq9Y1UT`N4qYqcEskamCX2M9PMuESF-p{KOuIonWI_y-Gz4G
zI{8TEk_<FREnFK3LQ<(;{uW&#6vrv1u7oW5gy~$!s~nSdT8b8@6g_M}=|31AoWVu@
zUfkac7p_ds!#Amir&p3?D7;{AnpQcETE4Pmz_0x$ua~{j;M!!vg>nXqm#5>?{*O;p
zMJar7whKts?fPI^7?wFMnl$L+1CrgZ)i-IVzPp3WjkC<$t5A_I`KzUawwI1M8tlHI
z*nl5@#)=gib){kbY`%40Y^WF_GxFQ!VAlTH(kdrddXE1oCR~i(&5eqOlF|8^^+Y#Z
zi;V)B_`U#WRq_*^7CAxV{$ooCO>seTXSs?Rl&5tusLSZL_+LZ`aGygBN@5xuS&UU&
zTSUXsKx^A-(T)xaqY>dmiknIA&0fXx8fuIQM#`EJBkFwZuQ`@Wt2?N7FEtm$0>)3q
zo$SYR$I#xWZQLC1N7zvwXIvFqx!hCDBG$4$;+`q;{w`Bii(Zqbj~Qq!)rV<8bGkQ`
zzv}eEKY346Bj-X=B!~OyPy+E4J{=z>?8h$FRUFC$Bt`?;yH9)F9JtEc#<O=M41Vu9
zTwD9rH>30FV$=$U=uxi(W^@`J44HlP3oEb!`YaT&r^(WjIluqG=;nR1yi>2mewUiG
zVxIhlBNJwjtZG|=4W>4MvK&;CJPpg+X|U1i=Oq-QxsZGR>kQqZ057k{3Hy#s3OOWM
zHwENF4hj~a_n_S^8)8J_2l(^=33kItPLtbOhov+W9w6H;&3C`PET&vI+UD3~u-7m?
zet&V$&>pY`5nk+h+TL$@W;`!RhK${hFO!NPMvFopTCP<5G}!%e+n;7{KvsyFQ4Y>X
zGJlxUa#g!Q!FnBgV<XJ&UazUcOxvV<k$gEj*vs3U!Xy2sTrfdc!BwdKrGDQFuedii
z<63JLsW$Rw(+L4-shN{O+M>6A>M|OF^EShTm@?W0o2Onnqao9_Ii|DDc>7-tN!{n6
zQpDqFEaGzuy60k9a{RoevscclWu1y0-Ch{*o-8WE*n?ax&=WH_>DHKt*xT(G>SU`9
zTQY4P-?b+<#>P<qN>4Wudr?qc)M|0<$~-dbt<Ik~1hU8u@9=Ce1Xp2p5S(JMCYj(3
zpL@lYFZrKb4KueFU8Y6Fq<^xh`5LM?^C~$9#`wk{?IZkYqeKRCfo2#j3jYjMF`?7e
zMN~^`e#tla>U4SGJh^0N>*;El*`_D$$Rpbm&`h`bC}C+gTKRq4$JsG@$-YDr_|{!Z
z<a(m2SF<|x@cVt5j3O`RzgbDtZP~WZDT=L|+XS(eDjLxiD`-u)jb(AncVcTVjEF1U
z<?^##XDXE~9PP{qmK7IptIJ0$e64T+{K?o-M=1&~lt(bo=w9lJy|r~<FUghEaeG}=
zRgt=mqdPnr=xuhQgW5<VQvLqFm7MFQI$lHV`Z`WlEnpWbWXj%uo3nBiR|y@x%6nnk
zWB?R0yE<xFnDKwMK`^B?#C2c&Nt1g&C34;NSgE5ly`^Zk-oA!7U&{d|u3k+6cBcv&
z@F?9r+|M@X03H3Puih*#%v0H5)c0^yRunWIYeORycq>9FGlKoA!ZbIVN*ft~NLOF{
z@Xw0-0kE3Wo<H|o2$CM_^ZoQ$hIYnx!+%5R?Lrzm0*87FcSS%TcytB((~U)2)yMD_
zmEF{?NQL{OVn{Apb&o;Ftv6zbyB#10a;8McJ6G_lLL=R>`Z`3I+U+$(k@5d;ixE{p
z*M`8Z(Tx`OV`8|6?gc-aPm}{BI<!iHpPyxQ;_n`OsOQP;-p6a-sYz^B0Jv<Us6(e@
zeNm9^aPZTBa6z75OCooXk7&xD0dC9E{9zF><8D))wR}-j<PNmf4lA&XpkN%7+c1VR
zng}vpMRcy`{o~tyqDcNd47Z(!;N;|*-ZCHE0KLhmOPjanN|coSMNi7X*d91IKfL4J
z%%i<$-@6w%_aVpN)g?Vh{R*=|mXDwKuW)uXKA*ei-6Q)Q=+|mOFMKW*fGDCo*IY=B
z%8;j>;z*OaY1;puw<{eHzS@XY8>^O%#&`LT8Npk?m*X;I)pa(Sy}b{VVQ%VZdlZFv
z=__9}Z2F!)S2<}lG7=11&2%-duI=nLl<IJBd9901w`Mk(weMUTL@iX4&L8SDO<zXE
zs2MmY)Y=_PtX=xdWjVtyR>F2?#;$?CVNDjp%d_i4oYDFfKoX|D?3T(%vrDf+*%UU%
z^A6i^z_`O_Yf()qM)dQBrt+9MkE>|Y7As82GS<Dk;sA8V@F|*eOvf^Ow#US$=b4AN
zrEq%!_xod2PqU%GWqlT}BfJ?pY8|FQ9=!ZsC1tAjgzHAS8>B)bPG{qMcvcxZJ|189
zN8MJD_=Qs?Wg@eIIPIw1dI@shvN}bWF>`SQpBu3~@yCpW8N1d5m~LEdNFv8rDrn$7
z3Fgo^9K`aLS%Zs8js}k!%d)RIa!P-WL$$Ph$B&|NVwKAxOBMNR<U+^MYYHirK~Zp3
z``Vj1)_ZNO?!aDwg2P-7Va3x3|GJP5x}fHy)mSqDpKQ1C{i6`i!LgANjz)#!1WVQh
zX@^^%mNdFuE$;LmQhL+Bc(MN7H+Q2Y9ud5>5dDpILTQcxnRvn^g;l%BedQ2%a{X!O
z%=mhAR$l`D;DjJH*4v<o6#A#^Z`a7B77r$b+__H^>iTF{J(`JAE75%N3sU;Ma<@WA
zV0a%<gV>P3Yh4dZd~BR)l#X4lwLfywm0#v)*ag-F+*_^ZBwO|Iksb7_$=^Sw>nyKV
z@(^1vjE?s-pE5kV>za=Ptw=T}PnpM<%%*)i<hPTcNp|^NSwl)qOG>bZj`>l&iaGy)
z#x)hVg|PlgL(OO5%mARw+`4W>{U)uffd$Qb9K=o3cZHbnb_Mf}$E%5R&bj%z@_GmM
z(|7OD%nX{$DC;M;#4=Q86dYu1&8kH)LvJT-M*lKk6(w8BNk&bUfa_3VsJ_zrWhrd8
z9iV&t3&e+f%x`$0_aNtbUR-0paoR%=u>8E`th_ufG~)3-ca8Qo8%Q~M+Hm~7_6|G4
z`x}kNuj&#|R-cL8l2yH7DbawY$%J;R*lS!84d|~59-`&~%{cE+{4l#r*XVl0#yD~>
zalrFweT~)S03S-rSDEu8Ikp<k{mXs$wS|y(+arnB5$`e&6z#zG#PnTZQ}4yo`+f5c
zRwr=(BSv;wdHg3jkqccj=z%?-pSJ_!;Ou4Yiq^VXIeXDB%90bqN#uqJ5{{09iu7aq
z0Q38|`YF1*c56@Bk1Kr^q;uoxYnFdDaC@y!%U0g9jR4StR4tD}0sXK4L|!y5L;JW|
z!(P`4)nRpw<0s**BiKXFq^v|abBq6oq;nTFxOIta)C>Y8uZyAfNx~6kH7D}L|LBV&
zdhxP3?-wfEQSmbR&|O><w*B0Gy>k7r5GY*qetyaH;|#KOx6G`$v~bRgI`dnV@+k5x
zc(-}PyX#O1LgM)T0oz888oqw`gN3m@?RK;&rEdLtN1vkI^n)!U+p&Qc#Ba+gfcbI!
zs-t!4+QVBEJ8){;On)B~ViDORpO}!Oz)@~5AR9S5Y-f*YaNE%03gW<-*Jo)+)L32f
zJ6YPlHjk-v_VI7HJ^lPs%RZ?|d+<(v`O#VDBM`P-r*Q?eaB}eZHz7e)ZcN?>fH{0s
z@@Mm|@Pu%a*N`q<@nCIwM%L-CK1oxh<`ER&&gcg<R<p*1GQ5vTClS8bn9uu+doYo}
z_H*+Ka0%cSGRU>s@~6RJl3Q`krQvfu*rT@ul4j(fQB9t8J9();Th3n3REJC*h7SIA
zl3e0+e9QlS_nM<tK(y~Jx16Tf_PT<7jAA+uV>Q2mn+S5$bWyA!l~(R|z9;6-_X@pf
zVQcHZmlA`gDejm2=~0LoII}STiX6K(tL$@8W~7{hz3xfyCjFV1@9>#k_xcNs07!yw
zxy~|t`%b&K4K#t2hSr31!rRaT3gm2!D&D7Uf0_RA94l7vB4e)Wc1Z^9B$)78+DLn<
z=?la&ul@;3Mu|p<r<lx4zy`+tEn>c^^2g)BbzqsZjAL1xkKrVG7RIuQK9OBpAqE_X
z#-919p2M0GL-cBB4psOMq+wr~4<)J+qA9y;fif(POK8mK_VIcHg}~rEyJKOl%G%*n
zOvOp4_-#&iy3)SDue&F~*n@jUGV>?B%r8-&6OEnLXcz4r{R1)t_CNhfma%GwH)Z79
zMH(mSi-4*i_29TAo#&$k|5$k0<dx}NWzRM1<w_$cqxMJ9{Pi&h&0+l`qAoJs)TANy
z$l`zs1*G%Q#s||y)I`cbxJs3k#C;s}zN9)Vm1$q)tX7CZZF&(ipXmVuTvxT+@dM45
z|J9S{(AUoMv+4H*`vFu1R6AXa`7T-3>*iLuc&0G{%ywR82cz$<-D5c)54=^@k)BfT
z`fwjZAmq)lS4{z1IY=<YZjsZ|{;Wmz+el^!B~$T6XBd-YFVc2+(*GpO2ldvp&0C!T
zo~8Qy3&c@DPqq*Fc6YVu!l%6od5@}Wr8XI{>hFi?QL)V2@!ar9gZ*(Nhq<-T<bPZM
zOQzg$CbwO2UQV%H<-X0@lXdZ}^`3`|g2S%g>KOX#<0G>vPcqSx)t3cSp-sgqYW6;i
zaeHL5l0trLcde!m@NH%W8@_D+xn9K!cmKx<CH5I_F}aPkG;$`45Ci##S73Y3p1hj#
zMv*3S=M$0Yet&On>)`dE+@E(ACebn2Du3pbI31(cn)_ldYoa|yqJ(^p-svbgj#_=T
zkYY{8qze1R7qIC5vufx;M+_5<RUeV7zYtF%cN1z`F3|p8$0zwvb~!{&blyU8M7<Y#
zQ~mzGn}~$!iwryI4%KK3xC<*Ewq+Ik-1Av|4@G33b4f9qHFg*b4KFv>_W{hVbGQ@b
zE_A|%1_Wg<Eh8@4VBu7jcX#f*9dNkI;#f|x_u_1pyj4u)MPr5WcFiMIne=?Vv%JfV
zUat%@v=C4XFKp*qK3~hu(<-PppUX^{ziLu`t-6b-+ks`V21lk~b7q}=%}7~CseCNT
z?und}$)gyG-?SYUeB!qKU46SL={S(OCN?>Xc?eWmL~pK7wEpu7YxMCbNF!8aW3wfX
zX7Y#P<z}=8(o*Yv34gT+1Tky-4m3oylU;wAbEYxut%7LZ*qND`@^ymW5qiZ*@)?9l
zN#gZ!Rr8fps4iy&rxxQ7=_tcZPP)+e&R>I%eEnA4eaBwvrO0hsxiHkCBajnV60L9b
zvbNrg-Mh7lWnIw<HXW>YRCw+%pLHx+A9SRPBqDVD_wkNy-`pwhKCD4l6bh@_JE>P1
zug2}LE9YS;)0lhTa^J5>MJM^``N>6fyFotMG_mE)MKO?e?D+BRPW=!fWK5VN$V)O^
zvg5Yc=FFL9-0D*u&{Yxf;(c%WM@#SXxl1k#E&FdJ+X>gqiNSl6*AkL%rxrf(?hG9T
z%0%xm$+tR-kM`cBtxaieVzss6MY)^2+b0|F#?Y&P47wq`?H1wXkV<vJpM>@R6zM^i
znzHG+U`*<NNfEk>Wef_o!&*vSr=|A8%xj1Ln0MhH5|*FqswdV~U3{k>O26B&9q05*
zq&=#e@42<c-R~oRr=acg!6-bn8gEk&)tBS}t|{vQwzm)MO&u=x7iR4up7IDGeUrZh
zvoEKPnqCzWLW{+hr|lHyR+6Whv!J7Pbr$y!QzyW0P5k?%hpkPo(F(YGy27t&^ErE;
zKKIcIvde#Fj~-!XGTEEZcXt&ub-}vKB$9=mhAxe$JUPU;z9j;NxC7}T2egTRIeEcO
zGL}3E8zdpPuKMBq&a~t9iq)n;fDIYvP_fUl|Ee3CSY8Vdzt*8@t5(>NMI&X>vSUg4
z4N%{th&9=DFU9`Ld^zalgw-g1t>(*EvMSqdp^Sxz0Y~RDP=i9%X2HHSTlU9?<hzZo
z=p1A%>FhdMG}_+e7CR+)Ixc24_b8-llLz-_tAPHL%ZE1X*WEX9$xg?PK0z;@t{asT
zTSl6RcR@zaZCTFu2A;)>cEcHUseAR0YSZrbuf;wtLwVCLb#1K7ccmkDy;z=eD9Yy!
z%9{(^(>;17FP`*-6%%aA)5b3^?jsZ^6TFAt1T1_Vg77;SB-lPKRi?Rx4^EXf?97h{
z(MhzvvR^*=6gHD<$=Z`TVGiK+0FS0QtdHIMK~q^<h4YPT|LAM!t_TYpdG`=3{B_Do
zP>MIF&UZeHZX#;=&h?GsXELwL%SZ9i(QR$UmP0Kif4h^C?!C4H_7LvnFPl4-Liw(<
zMF?JJX)JOt4@j`}dvuW)L92F1v)TCu3Z_9TIH_Am%Q-w$F2SIODZ+HSa*B@+Q{RKR
zQoi5(S@@IX*WZ_f0hepZ+fS#=cXG8>5aQ<J=0xY21!(hQ;$@D~vkvt^rOfVhW}`v8
z`VTR+b^oN#cX!r>^K(!7w;iTwE`IQ%>-$#7sk61<{Z*pf_gmh^Mmx{7r>EOTsntGG
zGTo<4!NE#G##1<`0GvLb;6ptO%|Spu9$DyDKi+A(%xIctRpbbXvS`;<rMb0a>i2Lg
z%UM&bc%Itrgw{|rvJRxG8<4Yf@t~-SC;NGd(laRdVz`NOV{BL=3}p385E3um%%%+g
zgtLf0{tcghoF;Mrd^e_>4{chB)=W}3;)ah4TPtTAqVx<cgF*fo*p$tMPhKhe*;)yl
z(6BfAh(l7vfq~X((NHY5EN?cs6uK={7Xq4Jsqd@zI5LOz0K~mXk@pRauVx-z8Zf|)
zuT?UZ;gzMMPv<IEcIau_Pfb7Qqpsqwa)zIv)Bb7O)#nG(prKQaLY3za?<$K_FrMRX
z(<3d7g+Z%84x2REp({Ou)5p3gHR$@KX2rGo?tv~(*>#eoicqhSUy|MFBd6;`GB}Q>
zb?V$0a`uQYFdK!61h~x4*)3<4sMqXN7#2}!sUZi%=k42{2+B$p>c|Q`NLLGOk3{2B
zy&prRO6Vc8-~2->UaT;J+bTSR-B&X8Td6H61ZQG5`emi;Fltg2Ux2r^;9?K4)(z<j
zC`_q^`_R}?r<Y({{SDDY#<bLeF@hIc8Y>r%mnby57d0fA0jwA$WMy+|guIx`F3_jG
z!%OBc_%?;yQL+8i{JfRUHME>}*Epb^|9+PQ_~G_(ox7jbZc1?(TFzy5-NE}VemmPv
zN=1IX_z`Hq2P-4HN|_p-2bC4AOA!^Cus7bOH+HnQUzs&1xiDR*Qze_4EPenP6!SL9
zBm8w7fQ5Fz+J?dDeWLGx?*bKDkvjC09((N~Sxv=y4h+c(zH{|rb)x;TY|Hz+bz}(Z
zCI82!i1CD;#x{qf#@56E29hYzA?@48rT__Q6Ok4k0#kJ!3LDXWT^rxO_Z-JF6pNdK
z5#(b;!ky$l@<IbX=Pq<$x~)K8ke>)px-S>Ad)8%aRdV-sUvoMx*9s(-Zz<$eEs?D&
z3)wARU{FrI49L|Q;rHVyjdV->Ky4Te3rg@lNtKf9l*{+VsLS=-)&7bYk^!<S@7s;q
zoOA_0eR<wT07I;NKsp(PWOIz%wnt?$u>HJbxU`&L)nomla`B_IN72Xu$%_ve3x$Bw
z>8pC0Ij?6MVbZJ9#ty|yR41CojyJD+_xE#=+r6rk(kgbZ5Npc2wW4zhW{*&%$FVzz
z`E%*x@tO>)=D&pghbOio?#%T8-G)LB2fwwoC;x)*pN-O;1F^G`I=>0-`IA!wD&&gG
zD$<fJ7_;zG3<-L<*L(6N!KjNo+Hys!S}u)5=h4_L-;H<MdAV2^%5nYbzX<Q&TI;34
zl$9RULM~>E*e9DZn~wJeIje!O;_(!Pz;rh|-;_W$#-`OD<3sKr^o3*L?43;d*kj{t
z<f~H@wF?q03G8A5zwg!QKJ2araOqUpk1PgenzoxB{Fk}N4H9(w<)utJu6`IUd#_ae
zITc5;$XDua$YR@S^=Zvk#Yrs#e(4?Qvc{pH<$Q0}`Y5V@pYbR+MK_wQUMG?SzxB9t
zzgKuNJ+Ec{{$_c8-aeoi4|lo0<wrB#N4F1^Z>#(=(wg@Btry)IVwV$Ea~gA?h`M%2
zVeQHM$dLVVD(mX&H;o2gmd~}XIJmSgirJUXiN6;{h4H0iQyJG52~-5w2NVLVo$LJP
zTFjG2mTR>c70wVbd&Mb{>u?R$Qh*Rw2|n&Ct?nl9=XUEjs9moK`*;|F&~-m<vSAkJ
z;%_@KErvRUT{Qhs8NnK~IdSyl$Nj}Cl23V{83JA$9ix3b+$wAO0+&uvII3;0vpMfs
z_7pKYVNv@m32G)cv?=N93Vs{N&6weh(d9y0;1U$lC;^HZMXzMr^k(>DU7uVA|Ih%K
zC_nB(qus-*Al8UI1I((3_6@h~i}b=nA4z0BUYs<UWsO1)M|`MD>Q}`CLv0n@$O{fS
zx+iB?i55xZGA?YGX@6CFU_4h=^1Lk`u`R5<TWTNoWPMhHg^xIaTY37uRa)P+NM?97
zmD8s1fPOEsQeRUoU3pWpMr!V=rHv~pmFrSAs>VLV(Ak}c)n)Z8IYxOm*pDLthhIUJ
z#TC49Q_JiN#VZQ=Bg}a%)N4W3bgRsLtXxmvm+u_{GQFlToZZZubQotF@~Y`_*Vvys
zPPPVUve7)8c(uA^Qhxpo>~K|$N?+v8O_3?WC&tNM2^tL`&CCRIw<;*Mka)&9J6gs@
z66WzveA!onN=3^P?^VPQe_D1yN)@8NvD@8q-=B`J3Q5g2L?-aB$rrq31nk>+m22qY
zo5|-dKL*)5h)qkl$wL9(8|erAbyGSi1q&xDtoh*MPVG}2^tn5_bs~VLoN?%ke833k
zQ^&blX?wfr8K<tj`iGg)2L;5rdZmKxd}Eav=yaXf0yf&VJR8MJ+=EfC8GlW)C~fY?
z(c$U2U=ZDd48Mjlw`ozs&&)2u23G~6tTzp!kBI<z8;U5_=CwXkze1>V_hLn&+Y@!q
zb>rCSCVNYs#-<-mO!xh<hl2uL27|7kJg=EugC|efD~54FNv1U%vJ{QVHCU7x_As}_
z$cxISD0(>EC#HX=U3Qa|cLJ5e8%(si?kbSADummtZZ{-_$7J<W3_(&@SDtxe%Uf^V
zuJb|(Vx|!`G6s(r=+cfm0w=$r6lA9i>WyI_`Djh9GKQS_=46hi>Z8>6__qt~734Lz
zC0=N0`Qpb;8!RSY&~E&yp45TYDY;Rarz2obF#~S)e05R%tZ;bXMoPmiQaakfB6a_G
zDp29#9j}BU@xUeqAm&Kkz4bm7lZk{6d+Cr8l|nE5<&?+or>pSWNUBzsOdH(Yz$WDr
z48`vEnzrNL_ihk#&F8C^jaMmKf_p+B?7O+OD;_T%OghTpR<7ygb3q0h`Rtt|y&6&*
zWEHG?xGZC0w}89Oi8KXTitLk68+NNcStz#OUhK&lWMmCLq|@KG{?$&)Dn`#*Hd;*h
zXpp{`*Q2|Kl2V_7_FKio73j40s<BWS$cFRTJvt%A^@9N(4?%&cpB<sR9SB+y!l71r
zm)@Ajkg7^3iDqr%R`3dGLc5;!f_smOdLoyREZ>wmvyzg4k}{9fkn*RNk<r>3JZCn`
zBz?YEv8AVlEe-r3KC7OyU)1jU2;w8({8-mVmmyH`_@wWh)#JQ&U;KQ25b$t2cK-9m
zq5-h~oWOxB0Q6Vpu5I?m$I+^2hMGm@o!MtV{yzF93g?LIwHkeRBTw_EUiaB$({}vR
znR1WPBHmXv@`AHEOa4VjKE7;0$tu&NVGj;+Dt5t;KT{7_!<+3%*RCDWP7z?uvYL*Q
zWV~HxU#UoJI1cb)U$<&rZ>Q)V_r6N#xo_6`{%vwj>T<5+$7nU3G}~;9cOO~HvxR%0
z>HulK>+L=;(+`~N^4Bbw?8)heGa-Gw$E&Beu2S*t_M|BdVY3Nh2Cc6OqV^%{Z`ltf
z@woyw0=r7=W3G7WKVmPd<&f&S<L!KOqCIcI|Fk1r^gk{jQ0wN9v^6+gFf`Is3u-7y
zWvvd~*aIshAv;C7*8A#T&Y5e8*>#8&kHW9mo2$47tRC~>Pn!5%>r{!)AKQgy&(y7D
zb&nKl=6ljVb^JauB42E$pkct=AMBCz`SO1N)Icl0$KQx7x2qq~=@r{G(;Va7(mJlr
zwdZ|P-aGLclWgO#)`oJ}hWhlC_gnSc^vb6}<g10vON)B4d~CAsYTO^Im|T9pzzV}T
zvA7jm_<VS6ED?Kg@Rr94o!LD;XmZS(uj|6HRtz=Xzd9CNTBf(akdnS)tUsy=<qU_P
z3iNf~<sQQ!WxC;W$YxX}lJUOftZfqt?kmGyT!NdRmyfQr=1Oay;L)JzoGnt9dZiGd
z0XK`i68A-{PIC_)T!F8Atcq0Pt>(|vTK{OfUyiX<>&i__=esBx`)&1YOL<!j+d6Hh
zc>(j|{$*PW`y1OoMNvufZRQ00{5F-t<l&(VH|4CSwZKZ-Gtbx8uHH-S0dH5j#CFLk
zzHirVf6n@r+;1Strsd0Ke|o1Bc^`e{dbh2j-^+IPbJmt7&%aX2teLeMSq5p#o;40@
z!g+hTsmz{Fp)9kvQw8c<v69R>S>JEpL{|-LipDxms$JtG8)8rVmW7!**itDCj@2|+
z$cF&fII<3yhv~7RZbFypSOY5zn0>n-ENg|9|M8Iu5IXeF|D$4D#r<Gl#sDW|xkAlz
z{-1x_&Y_q4-s&JZq!Bj=)oL?3TXS0MUd}pOVQ>{;ZpoWJWb&E0O>Q5R!L%k$?ZAnv
zS2kKMVU05RW3OuHbBh^w6M67}g7km>``>BiKi|HN+jBZS$G^-6pzZgA-}?6Uv$X&9
zNr{TeSWHcexq`?C2<^60q2P4t`p*S7iyvPV&g^#1PjAVz;;@!{rADbrt|Z&-VF{=K
z+St0rR?4;8&Gy%}o$DN9rEiP-?MYvHXR=29mD#^X+TJ2I`cS37-WkOQqBHT<+If3X
zvfkTYOA6gcmzoV~noYniZD2U(w$WIN0c;;`*HfMZA6ASA%ZlYuTR#;#9GAH>E@<n|
zqnjYr#J#FmDMit_-G-ijP_XUMNfT_VXLcdRpLe>5kWE{cuAqG_7z@o{qDK)egS;+<
zZ&$C{iL8atB;66BwLw>}I>lbq64v|-^<gfH4<1~HuXQFbz}i(wcCj#W+?LX|?6>8#
zy-;tqOZ#7+YqU`z=I9j{v+SpQrmsz$+Pr_={x0l)Z-2kUlGo>}&s+BYU`;Rkb7fYe
z%62o`IX}0bYRL7fG!@Hv+SYAdH0$x7hx2_`H_}S3owVB3yY0=tpSWqCg*N=XZRe@A
zvfI0MWE-oss8qY{@ALk&|J3cCS)x4urr|=f+kQE&?>)=sZk?=Y`}ItG`gPHHzbtvF
zt&{b$HkPdW<rRmuC|t7reA!6$=YD3)R-CXs+mG4W7{yI)?9Qfbr#5}COLCk-sK6hS
zH6blQA97h_)&ZLPHv*{&c>p7|AmeaBL#lftn=8&c5075;2m+NwEp3fBlX1i9nZfQm
z-_E=T3LH+T1MW(86MfaIMxC#R>CED*(^g?PI1TC*dWC3Rpz*XZ?YHjLqh39D(8enQ
zYZJFp`8)=S+~AWJhc#t#iaA=gC*A6}{ZkUz{r`lS&GuU#Ie&hg_Q=Ay{hWDTi$Z1g
zXSUz|tjbr)$7+eBW<1v{;7r@C^{~Vd_10JgZ1qzttwMBdtH(CHYv;#;nXuhntj}6r
zO4%m33bCgm6R6)`BPpOPPBIjXa+pTNj;z(WeAmNjSv!7%I|m00h{l_wzUGo?H)z*c
zumm?I42<y!MP?oRq!k+zw{+@-fwepu_a1rQy4X`nQU8Xtt8f*QoLp$U{;2uD9xl<r
zpLdsZVuuzDY2_RX?B!<Q@1gGL%52Lhl-lTUkHD*T`5p<OoT-5jg;~8aFk_t9c}{bv
z(FYH%L;C;z_rJ>wf6_tP+go*DvptIhrR{@0lGA_=dQhtCLDT;4@9$Jpi@qu<Qt|Vv
zk)~?#7~NC(6hOn;cxBE@%TKs`q~YOSkNZOOwRQhb8$7iEIkcazuT~qAUHhC5HrsRB
z?`f5%ejn<tn$z9>t!$?I?Nd$7xhrhHyiHprZj+-)PSkZ(`<3(isI@KIX<7en-G0@$
zY_|1lvz@ZrQ$5=5be{WSXtJGRauQ;}aRjmZr<5!q<X1PM@Qv{d4gUgeEmW<}aV9Fd
z`_mNxhsmOqu%!x<e;(6;{@g#?H>Rx{QgB}x_Kc{>f`=bVG&38V>7iZ;QXmdawGy^7
z*GS>Ncoiiap<W4Jz~bB#9z5uV^#A?$zp}_mKiF@}E*fROz5TTAuY7Ku*lJ#{{xY34
zub*Fb`_ArP(x>cx)%gvn{Qk7g%wKc+efocj!(4p({kp!Zbvk#Oe%k+a+COPT`SfYl
zo62@G`(J)${NLpFt5goV@|<fWr#J1>FG5Q?)nloCr51;^wx2KAMR>K^+m^G`wzF|q
z+wD2w{21^@xBXt?u+nTjz3*fvZRp48QgGKP&}*yZt#}vMIio2_`2szoph2819IVNH
zovgRD<1ZMl{N`I;cU|dZ&|uMFizQ=8s8s9l(~TChB%1d$)MpCFmHl8iKB2ua6|2mb
z9*9k-c<yzRuAsx>vaS*=fli7{_N0m}HSI3Im=|3?I`U&FjOtZ4=}Ow%)<S6ddL)E0
z*GIil8zJ0w>{?Q^SF>Au@ZdIBV_RgJ5FfVZ=Dpuuruds}S@-1k>*lD|KV^x{S)y##
z{b{p5ZT7!@hc2_fls*$%bl$&2mq;%CYsDow@1L&u&30}7_o8B~`%{uC&-Y<}$?o3I
zdVastp{%myCT}Hc8=-biubch*dMwrNt5NOKyxY>+u72K#)P1|!wZlVO{VB+=RBhX7
zX<W<tQ`4UO%2_Xs>07?$mD*oN*ZsR~-E1!_qlvu3rB2)Px>T>iedQv*X4c!!sQ`5O
zNy+`iCz;PF7hkXPn)9_5`s;JE{Zg!Eug>da&7<J$?-(wh$^90XT_Kt-6*qKQ8w;?U
z76<{b)xGuIshnAupNm=`b?AGb9LW2tb*Jq=S}FE|7XCfB548I4UeMfCAa1-fIw;rS
zJ}2znDWhJOGM+eEkIni_>MsFrPRX`%g%h}?qEM3sBfo)qnjcusfYNztw&jDhkdZv?
z2%$n~CvslD3K80SMn!1HV7$c#4;+{yu#N#9LqE^)R<jC__HjV!cw_Dzqa@q?b3{p6
z-k;iP3X2jn@A-P~e@h^fSKs;l(`d1<|Cm0V_U|H+&ir2~zrU3JUtad{Vr%HpK5na6
zJ}IY{)!$DPJ(hX7u4m7o^{~F?9O132wMyFhndi(k%q97vqh(^X-V`!5UrAZ#j&WEE
z&-c20yj-`HJUgE1nLEG|jk2}&l`XPk9F|OCqq=T?=5q*<HAY9R7L#eW)w+`=3qKd3
z7Eq+hHxI^n-W$xO@W3$XxG|<Y#I%0HUOK{)D2AUWj+l;C{SLrvJ>12a<sKijZAhCt
zTJT6$y~r067_%CZ8`3!|SBacZDW_Y+Ug`SLB(z@!UiHd<eS0lFcyJqhZRhHHRYmt2
z(>m!sZ)<iN{!FLseT)yFUQN+Pnf+2wSmda-$T{xmw13$%ZOa;mwF(<)l{ZAwMx)v6
zKc-imlD_v(zxPv0zXTCw>=yj|DVgb!$X;DK<X1}Nvr_}>rTwn8BWJm;WsSpHem^nO
zPUdzsDTcfKQrZ5==@N%kZrk&olw?zqvewR0jp?mny`r&FD#vQQKSkGH!<-bW<>;!?
z&N-4rC;eGd>}wOBCEM*xOxCyluzYXhvogPFD0A%9tG<8U8(n*VLrm7Zo#YUcwY-Ze
z=lCp{<FJ<PuQWd=v<(2Kb1bJ!ty&_mL}PI*zN|VjyIOxcpl+s;OCB7(>WF=Yjdhnn
zN{4^ZQoIb>;ooQBFX#OSv)^g=qk;ab@>mSx3Ww331pF*Cgn(C^ax++e`yVoD&#%ke
zYe1E%QCFwpbKW`)Cm1c*3(7F&P+JQ^(|H<m%Z(nxfMiy$8eaOl7p-yr|Ji%j1=m$x
zTTt@*ziHq5^zO62{$X_)5J=p?*h$r7tSqLA*hmQ3v6T_IW2@nD@saEm&1>A)_$CMj
zmIXnc$Wd%_oEmd`!C4rfY`vtMOqAA>O1VNcnW(ru_`HC5qeB*lxjd+Kzu;l%?TL5G
z^v5zL{m$&{_Q=VE>X=$K%izW=%{T8K<<CR;HmU^{$p|681J$}?Dh7-{OYw8PbKvL`
z4;2rKhspO?$LW5lJjljLr^_fo$SUMHS-?LNB-WM680{QBWT>D(E;6P;RGuRA6KCp&
zLEvH8Q3WT<SBO`7yOoZidpcEhgKCGA;`E#S222hUVZkVG(Xz1e*Im3cg^i72$k1GH
z%R$3$ti_7ErWK|pW8BW8b#zrRnPm|FOkiB;l&)7;S1>W1p^x=PePsv#eCq0n2M)qV
zxL30|X!UPp%)tPiGWG7MZfCDH{s@kcdjbH#cIoC)<v2C1`cowtF{<m7<qFkg&kRbp
z0Z~IL;#EOjhE#?`M#IB`{5BMB^NZU6Fb|7FKicn6v)jv*K-IQrUhbO*Jzwn~04VU$
ztbDpk-pD+x%36S_^JT;{UEg9199W4Ta2YN#%qFVGr;lMgtZ{`n2a)Unn`&}P2Z42!
z$hIn0sDX7UD08yxz9*FHXL0`5TgV?Ky5Fsim2Jk>%9l${whgj8EG47OgGzpuYF!4_
z+2&;c&BOZXcUe5HlNGX8z)@invNki>1>#pPTx?H*)s5*KQ%bd24Js}fK*?(cw|16>
z-B^)M=-JW=T9yZ9_*wTy-Po9e3qK6(s#}Lx<}9)1^wEz+XNh~J7N)!61LYRR3<$Hh
zwRTgp9@kZ6T|s_9W+pW}9s3C~GCqu9aPWai_ii_1^RLNX(No#0!oauB5=A_A?X<I3
z8-E9PYG4KK6?0_#Z^vd@JF=9+eLF<5I1F=g7$LI_*7q&SSlcGg!&08cLciJ`b$^D)
zAh);A=IgXS8nd=d$C$#N0tbzgJp`Q82^lUx^-IQlJOI>VMrgq_CbMl<rL7Qq-N(WO
zn_dg)ro2(|TSu$Ke?Vg4Fe6BnX&K@W(F@pdC=(0=rH05^oXPU7(}7U7x}j(Qx9LCV
zn}?L*^qZqL%n!DBptm?#7TD~#k7z~@XxRAIVLv=!EvT#OIjoq`ZG#H~tjMNy_reMr
zsQAYa-pE_=PEB3Z*;mFxX_{N(kBmOD(_m6;3~jeejM-x`jya*d>8<Ql_ki8T-Z1sn
z$&Y3<Zftxdj)<!g$<)Wa@>z-L?3MktA(G2HDbO-R{TDOH-{5DqiTfcWSjzpNwu$7c
z)>7IJh3(7zWWRLbe&lcdOM2apx3FegG%q)1%|Gqd0q_6-5CBO;K~z-nTk3!08e6*G
zrENlH)BJH#V0bn2Q|%1bdCEA{a;Ck;JY<G6ihPKU0tk84NcOFnqjL<3>=lLqoQx4C
z3-WSkA!Pjy2tDA~PeBGPpN7$wKD#iHL0K4v@zD+<@_ok2$t3Dz37f^U3+3|)f8II#
zs)5gF^?>-*3m1*^AZO!<W@PkiTpgGurd+gv?u?hUY7#^Kxebb66us^{B;vtriq^&?
z)B&nVe>2Amr7s=)nJwPHqBFofg9|ghZCifaA^+a6;nq4%DSc2EWjdbx^mhlyz#h-K
z%M-7<cIq8@e3hxkEu*gJnU*rOcYbs$B~%=9AbYjyOnUnaSwhjk$24wiJPZ7<|NMXM
zc3j-f@{wDsV-@aE`MwkYMrC)qpOM9}HY=BTSU5jE*0xzv56jEQa*Z>EoHXbgv(G<$
zV;*sTi`(Va7Xjs3*W<+g>GM92#+$FZ)EBp||0EUdA)OPoBAW@hZG8XXT#DfU3I|q6
z_E|0KCMi4ZS|$RY$pvW27zdrSAvYBwlGEw{ijiE8cW9|Lme)tFnAs2pFPM7MWE~oZ
zu8RBg_6<3IdGRDCYr$CW(y}7VEb9c)IX<j#<Li)(^7Xe3G|>AFR-~&IAve<P?>TO~
zea8&SNE3J|Z$(|YsM*nhDNhb4demd~>U410eU}*%W_JucF>G_x`0Ka6VS5K00QshK
z%#npFZd<hW?ul?*<Hp9<<8XC_QVvV2j+M(D<oGiEvgTFs9XJLqPfmu8ej^@|XT%hi
zOQu49hYaR{Y>?l^)Nd;7OMzH3sQ2;?&n06IK`2`^GJe@VZcLeIvD+v=+XC)x2a_$q
zV%;vi)*#ot9w!#upNlvDEWEzBb^VTq)naU!N?V@a#5pgK_yOmn%Ny4UUn^ykW8m3X
zPIf#jP@JsryaMXvXZidcv4WyZa8<=3VwM&nuxzIi*U2(Lq1jlW#kA#*`BR1t8JB_Q
zUd7KVM4#?NQk<+ljD3=ifAN^rNb=u>dP%&hTTQ|rL8B`BaCa0GfVaV3paMCI*7yn&
zc&^sUrP%lalwt>SfN2y%bZOwuV$B>c+%~@8hI{6<9oz5s0W-o}7A)@6^vBh?OUO5L
z4QnCKMjTK9V;CHKY|_2P&zRjYaR0F4gSLCjft8`I0mneTsgF5+DAu;UeZs6LeOcqi
z#v8CTu)?qZq)gRcZvkfzz~?6X3CiEN%lmxjla+M~`eUAv+WH2>nHE!xxqjXr3;pr-
znDomp^W*Ii=4MnQK{&r*p<nli{&>t}dz;^C#Dk6>5ozw8AmVT#|CX~Ey%=~{r-<I1
zUe)$&W7@+pys)*U=3#+sd3ogWL*QY_f!q!yHNoGNMUL82{>E@1urM06;xfFdznkj*
zik~&1s~0QTSTLr4NHyMkzlF@<xfrW0`~YyMdlkZGD{Oo_(inaGet;(5dm1YyzSRC?
zuzMB`rxxm%F^1GX(|99q#rt*YqRL+#7@m>4e0o&NK=wstZI+Hd6=v;`M~5A**S^RP
zPiL=SIE-#sd+WHT8I2noUyp-y#;PZKg%Mwd;^)@+i~z<Q9KMytJZH*&H67%3zeun|
z93t5|4vy{dG6@-`WlZ`l4-1Ri|L8q?#vwy;lKu7xefjMT@nyz-F(zcjR6Wwq%Kz+8
zx4y?wT1USZnQ<tIhY&M5eoS368CTglSwGz;cEm6^9@fDY)_7Rlo@S<!p9Q{0$tN7)
zxrZvbgsMgIOeplN>xbm|h7f*7`6C`o=cCZ?Sz3OP9D(ZMVZmvsgW(B=K*c&)^0AEw
zDG$qjB%-+5Q8I@JNm)L-&~ma4G*7W4$<KmrP8RX27dO6j&nX?bq!?07?e|A?H;thQ
zU)Hh4!WHW^4a&bBplC^iS*Nd!k0Puyh5}U);66&xMWympix1s?tef~c`*Y5?ZDE&f
zohvbHOuY2-nDWDvM)T!eQ&%#jnF)?(uZFdZ`)%Z!#9a;d@6@~L%v!I`UQySD+ywEe
z?Xsyup6#Xfn1f+d+kDw)M^SZNDQs-~a$GgAChAyezLhveJ}nb)zCg%i@98t!V4>gM
zc{`;2<nPE6su}Y3=Si9V&|>x7Fb*W+pFY!(vj^Ny#A^1Z{dUZX4=cWk*Me(f#oV{N
zj5xHu@t6p?n7lG*eevvaWS0j{FNbPbQg-PabcLJRi)Y#cfU>R+GOGfiHuQV7uA73(
z49_cF5=?gx^5Ik~qF2%J-lZk;3qU^-7B#q-B|j>8*ACUj>fbV85yuCkf1l9aH};GZ
zEQ-d=5BbP&UqH)BfkWNT;l6WTH~A^tkCL}9?rHdq4`PvXmQF1<*b7Ok{_Td7R@J|U
zFzbgYrG2a`>g=mxJawi1c|^s~EW)MU;_+uzoS<j$(UAwTR|BqCZ)X^mddD1GI_eyD
zaPKFTZftx#j=4Hk{_YnAM+P!7B(mo3*xT&|vfw2pGN9}yA)mHTc+yXT-<0Wht;ry`
z`|apmqT}FV<>|ZbF@scoSLr=<|8X$eC}$6dk^AR$99Z;2Mpk}~*MbWo73+4X7$C~W
zNh+IobI+H|#-WVWvooHB2M#e)%*dYWghiGX<XfJL{Xp>yES4$AM7~B<sFUSnNa|!+
z2AN@F0bpmHtn(7i6Ggu<Gv;JD3&C3=h5^aRO8HrSv5h@uq`)16n1^MrUu?$e5Kk}!
zz5r@n29bF6Vkvi^>#NIDd*{Y|Ll1i(GA3is<ai~}%@J`q+hqYL_bPTj2kZk3&gAuZ
z3>(vL9(Dtkqhav}J>9@k=PaFCVX%94j+xi9-LNqfS#tM;3BwpyYCq$lOC4o*9>lOq
z2Pte*t{a-gX!fet_~%x9Xk>d;)ZFZelkNPN)HUW{yw)~vnEK4;z#|`U8yla%RRc@>
z9tzj+s+5KWM<79-{Xsl@PYZkxoog|(egAZ^Hr>{D<6UPHOvdM5UB&%Q=95&ve=t}1
zC}}fgo!m5289O}yE+bW%d2Vl#pN~aHBny*?bC>zD`K<G-{Q{9kkUT7%pDKmd!4?mM
zEc(!-QY*~~JTD%CC@=f9!e|Z4%TqprI)E7|SrR#I=PG=uHWqY+=!oi}tLqNcGgG>;
z-*4e$S$rikD*{fx`HQe*A^yVUb(b5yI%wCe!qRE>-C-^p^xoFPCXxE*4qoyG4XdNd
zUwwGNtFt+v-oXhbrrx!~jOD9;HrP367<0fCPnc>4rv5Ppmu@zD1vk$GG^uoB<M-h3
zcjl-$EPN-NmCdeNmOPs4(8=_J=!fY#Q>mP^`Tn0>jswels59QaDT9-t+K;Y)Nq+mz
ze(#Nw`#r-e)obJ*H=G6k6x$YS478UT>k?KRp|#d@!bzdO9akoq7RMpRvO9^RFgJ;F
zm8G&gEUZ?}VjdQiI9ZU$=V?tr(eIN_E=#3lGhJVq-X)+C8D#%q#!q=zZU>UAC~MA7
zwvJHpup-&F%#*UuD2$(7Xs4F&u$=G7efjD8(L2IttP)O^`R^x#^%E5Cmxb>3xVtvi
z7;cjbq-q*6p@%X+$!o-(VH61$ljD^zKA{|NB}wEVP~la5b9U7~1zZ96a&#@z?_0~I
ztMJS;lfhOP+-2d=d}d5iVRH+!-WXpm3L0Ss&woabd-aC*dKJ*{BKPhvY&oqjdS%CL
zZsEopa|JcWoH4cPgy%kz+QZJD35ssT@Bet+*cbu+KmYlU`B%jJYMH>@lV@b!Hti2B
zg1Y6`{dR9rNk^KXD(rZf?2p`X+nAC?!J=Ln+uQJMe0Ccc(B(2bp<kSS_4e*;g;Bqr
zZ=s*+KD61Nn68&!FBE~$Sofd&$Z(8ZznW}s@3UR9Ul{5-P<d12zarVPgb+FX27#YN
zqOO)(1=5RPY{n>{gFB*r4E=h@cz9lLa*4J2;fG-d?+u=IUKY-y!ZQk^n9d<A1ID8&
znSVv-ehn%kuv-^&ZIZ*66S8tTR&Sf2X4tKP9~{f#H&C>)=ySz-hix$E*4y8VCvRq!
zx+NKGMSgAl*5m1e;vW;Z=aUibG^v!bVmGGTJNQZZaO!Gk^P%yF^LmN2VAwEX->^%M
z!pZm_Azt;G(y>*SwUeg=x}|hu<5$5wg^llQvoa(yP$E-VM$b=CGR2%7%GH^28G&Ly
z*eXSNo)l)~>v?vCZLSB%nW8=R{$KRFGDUfr{Lj6>B^8ow3}+}mj%m+ae`$NwZ`nv0
z+dP9t_v`r<{1CWZSs$L-|JC&Zzar3Dcd}3VqrSLuNtgpmF{$D<{OHc4g^+nzqDNN9
zl5M7P76?ujd&6h1{ERaEEU?)tjB93rkWntO<zcDCry$2XEHhPf^}O`63$^SyS*-m$
zFIRYqmyeuGZ7eE1qfpAaWlol2f!X=_M4jhhLEvG5e^Q~b!EmyGLR>)u#IG?d`sR(b
zkLaKI0)Nb&Njzzo1Wm7638(?T22_6aZB^axAH|rv{*E`FISQU}OKz~+md}{i-1>%9
zYdrRzcCqcKQc@bnFrdq6u$-C!MN>W;P!S$A_`vwHmecBCf%=DCdK6Bc6GpOEgGbB2
z$m0Xd?DnfJdp0(D!3-?-SK$!Av5z^_@<dxzD>ck(W*%1d-DBQ%ti9`g1$9p^j*g6z
zGfKE!vX#M6Ul(OJ)GCp={gE5$8Qs2{{WQu1kjaXq{jx{PrY?RQnwbBMVX5C|%Jfu!
zMjluetOp&h8E3d$8j57UaAj^FlMZyl_4yvlb<<kFj8t5V_?R_0#C}}`J$+cm-@!Q(
zIt>^fd(t5i8QT_&n&Oc`Vddg}CvN!dDVINnnU(z8tN-+U%Tn)UKfqTe+7@lZn7wU=
zRermd%bVPzUny1o>cj8^N&WMP3azQJ5zVRSwf{N)%-P%=cRYLbgsD6-4U9P$zSKW*
z_pbALclK)Iufj60j99EUq&Y7@br};GW4YZzB14`J1w!`sy?z@M{jqF$SZP049#)X4
zDO0y>d06Fb&Yp3|{<=!{drnNoPO90DWtq==S%2o&CAVIn7;}vpTc%=^A=_kQsT6w`
z4-3)v$hg(<OghfpyTCo1X+kgC=N>va;$g)tbkxrhEpx{}^n*(!$*dW({H_H*<pOe>
z*28i#xT;mIA5tC`M0K*x%cRp*Q8TMd#PzBGk~&%B*jQ*~VJwLaO$)5uM^DHdgxXkg
z+0r^$$2FU)-_^#VxHeWbA3@?ZfZN~v3j>H?JY&*n!0^PTyb&Q|7%dq%0u^3&fg14F
zK=Uu^dBKaXmN7Gf{xv)q&#!uKh5ciucFt$sw>E}v`|ZZ!PAweo(WzAHm<*M%3Hp=6
zh^{Fgj)l{#iY`oLuiD1X+1%rl<=Lwnhhc5(d#9b+(Cv{Y&keOHt^O3)*!Uv!*1#eF
zEXlmB?WYW3MaucQROv{4a%WqdnBW6N+hE%%Ss6g;FiQXc5CBO;K~&q@@NM=2y{P+{
zhgGp{cwQ~mm~BUDhnc6#o&2M+LOlG87}qt!T)agwX`PF;Y3X`c-OeEXLM`MVgp8_A
z*5Ts{Gc~gyl7SO8-9e27cLbS-ck=18OS}y=>tu;sp5GxS2fdVgGG@h0v0)+=7DLs>
zvd<`Vzf?sYpE{UM%?*lJ#@WI5Z0OcBZ<5DboUF%(w)pE5t&Lxdw{A|B9s=dT)=h^N
zY@u=YwswUJZ`d%ap2qZ2Rvf`pUIs?h&8Gjlx1(<(UUdyV8(@vk$nn%wd+YgQVdR&C
zFlP1G$b$pS?6$L48-E*zy?b^fjIxZLIih4)&nQ>_=sJ8N8A~#hWk}?Rg3@ZCB;#?A
z=od0vd??*dO&L7T#mKT>j&ELRKY6__JCz&1YJ*8nX<bsLLVwvm=4%eaLTdXNBDuJx
zCI@jGSdE7tFW7oynP(}=c#C9fu#eSTJlh<X`#Bo<go<WtK`isvo}9a}GP11eWSwC~
znVMO#?A9X7(sF61s69c@?*KB3KtV=B_HwS_`1BdKa-A$w9Y55`!ob6lve6sY#sX0@
z%Nq`f%*P9P?c~{5>1oJjucF#mRtur$VR42Fsy7WJUSpX2-Y;W9!eJS-Vd%c1PtS})
z+P2Yv1%r5SXbVgL8yla%E1^h_98=Z77EPz7V|q%rY;(#MWUppzm|a2MuT!s9GZ{0(
zbF{u4R5#_x0Tt#-WllvGX2al#k%=#2)(#6zgXhl`gW0R0p<#ODTPIqYRJyV8`=M)K
zF$iMDL}%ME(!{7ZWd#m=>eS9_H_ie$trR--;>5_4=QaL)nNu728O8c`tPwg{S0Z!f
zOPOm{HMGVNkgK$H*A=Wj{Ju~3Co+oZV&&I`x&_V<^*9py4-21sJ5TbmQYC0rrc3Tz
zDb|&Nj6fXP)9oStNf#hDs?A^FOl>R}+g4yHJqKs4c#e<-)1HZtw{Xqa?~Pl+W@&9K
z$LqHrPsVUE_M+K!**rI~TNbW6A>1%y$_5%%N?CCb!>KFr&m$_drrxcGiC1H(HyA}<
z9L~lVL2Cjy%)NRjbw$y?J;M%0^NmE(t+NG9D&5%l{WzG<0uZ<@fQgK;oNpmpuL^{$
z`Vq?Ys`UMHttM0=Ln1>Yla>t+%UGG&hTP{sW?yK?RNIDmSfy<uz0fZk*Olx<Q8P&S
zq2!;OKU3NJAJTQntS|Fu&^-~d7$?k8IWfoSE5;$habOg;X`F-Q{%}9Ice8S+oP`&8
z4A}uFoDqI=hn}A`mc248q%s>Tsgq^C0CTN(GbN6<Hn@zHc}AhnUS*zRs5x1tJp)}W
z)XainZLFWyfi4iE+E{VU$?e2Z3gMTSbp6g$E{1b-S{uuJ=lP@YaJ8{us5X|>OcU1;
zi?{=9!|ZL(s2L-(o%Bou%+f|Ed949;yjB8pfQ^klJRd*r9ubAH*Uhfi=81_duy958
z>V_G!3rg-fp+{-5wv!<=JI!Hrv!3iV#a*dCbJ`zvku~VC?3FA!SQ!?FvsX`|Z0@~P
zYaDL1!Ec><Ydb#_hZ`H;hKqsa?gf2|;nauX5E1fR9jmCVY8aN)q-?*mK%!)&trJw(
z2BBkynb~5^3jqA<sifcQE%aw((ESh+0lDpMYNcb$2(tEed0n7m8#O;&7c8D}Qno5%
zbv7p5Z(1qR8sePyH+8w#K>Kbp=uE1lZ=yEyqUvO&vWXWX|73s8>vxDr%`7Y&Ks})b
zi7Y}y^RUprjj>aN`|KW)xTQ#30dx{iC0T`>X#$x1(TXU)EZ5eQJ%Xy}+bV~ZOq_d{
zAk&s~YrSQjN6pSP8Y*~PL5j`Q`p5B!TZ`vIu5u7Bn{V$d=4QLXPFmvW+qct`I}LsR
z(dg*F@H9#N^Pr+`E#k`KDHSm3sK*933Yw#bVF#A0z3J?sLH#GF!SHHqj?G^VPJ$*i
zZfyK592pJ^WouUf_0_S0M2@H++(Jc;IX>+=P>}Xx$|q9&5Xpz&Vd-svd`3+6^NEDF
zQT?GMcM6TOCw2u8v;F>F+_6oP@mu!Td`vQ?-=6qhU-l>dQ66^h9@JhJpu#$8nXR^8
z*JR?v#Sa;pjj2lJqS41#Jti+678Q6~RH~>2QU*^p60(^EcpjEYkYM0pf#zgUv1XQ^
zi<7ThDjp|!+j5*Nken>$VTGktJS>3JsqUzQ3=hk!rk0tL1*SHZdUm1E8*{R3YwDeW
z@1flD3f++sx2&Bf>?m`f7RK|iY{m-E)cmrwu}<RS2s&zG*{G-Ki}Ga`5F{#O%~~?`
z<!b+iQ<iC9g_J>emZAq#cs&R#05<*>KD5v;#&cQ2()o7HVtTf>>~tzAoU8BQhR3F6
z&pY+#&3Sk-z-Fg8tZPcqpcb0QUJa<2b<{(HcUg{}c-3o2d(#_BIgq^?AHN2CDtooD
zvEkqtSniMfVdZbly*$xYH5B^?u*6Da9#-L9tjwy>k9jY6nR0r?HrUh)h5p)%Fh4JB
z`O_K<ZD8wN9)uGuIYydl5ss1d<S7Vi>!WvZc67i}ma>@N9`zEU&oqVXkH~8I{FLuu
zLrZnC2C8ED_R2|dkg4HC%TtwMaV3g!!{vEcv9A*MG<=@CgU}o)UmJ^BaoN_>f$t$?
zS<Knft$2Zj9v@|9eLzzMo3!<{cs?ODgty`(r)RY*dgn4R=LM!NJtQB!i>~j~shT?b
zT9}zB!F#$`U*|^OMZAK6u$<0|QRlE@E7sV0eko~q*lxpVbmWl%CU^d_&!dfv$8i)m
zR<iXs+;{3#K_WxcPoiJQ&?#dg<A5CQY)$Q?OuzGw?uSf2<@+h_k7QS~sW=Wb##i<z
z`ww)_Maj&IY`(^iAN!}|Pp7H9E|gnS#oKZ*KyGI4xsbV70v9KSR0FR1yNtt3d~zfs
zGtw~PVMXoblT)q&c<z;yB|q!3+0P;@13|JR;3r{b8d5|~M$O5hP(|xFuN)Jefq_-3
zlSNlud|p~vGfQ)_6hG_W5Yap=pS_A|V|m%JvEtfT%+-RVHkO?uT4%T(muCt_*_@M&
zAL58|<GV{oX9I{Ou@{v7mza>NjV1YC_JXYInvbThp_g4!toWXPj&4B7t8c?wsF65m
zz@~ek>gy$73$XDFzRdIVfq<;)S?!AUT<*;IuBlEXEzDlc+H-HwsiC^+<Vn4gGo{yb
z_0Egj<r{t-@#?Yc6<>KYtjC$`Rof@C2W*3Qb?=l_vl*MjtJwor>_4t|W8*IZ|Ht(d
zLV|EQuFFyD1{sty=(k|GHCfs7q0()*V;mhjEqOFyx*fW!FM`tCnRyiVH)W!}^}^;h
zX3(HP<S{aud9NecCff#W>|yem4&I+)4<KgtXG2IC>$5poV^bN++r&I9DH~%rw`DVr
zn5~mV*K-4@>XL$!RJ|(ZWJ%d)xOn~fvlFFLG!H8$m!c8t5fTu`c$MSma#l{IC>Tbn
zcvuttTgF&TrNJAvI6TbB0=RFYz<1EHzD4mUHj~TZS6%3TZpo^*fAE5u`&%0<uy*x<
z^W4pI&wdr{)U*E}rgAarpJ#QADzYkuO&i!@Ci~Vm{9LxQIkp;hV503!AIe@8_URrR
zh6nH4`$@eU8-Eeu8E}ekWn{?6Q45f(ZA4yf*Q;_e7P(YVkx|Q_?|zH@u}rCaAZGjR
z$5$d#z291G7$c7Pq56e<gro@N#-TpFv25)}x4M+^gL`%x0Z`FbS$`sy*9fcqxjJPO
zV#bc1iytRnPwRt|IQGg>>Umg~Z0a$Inp62ITFx8gI$5e_mP^+hmgogsnhCs|xDp)Q
zD7e-666$rb$n&u9l(n(qI$3CVSi~&_jhR**=%#8|IOv6pj<1)mll7DNGVA5pSb~QI
zJ}W0=v`3k!mZf=Eyt$B*RymqNwJeTJa6ByFELEtDMK+)1@_^8L8A$#x9K}+$g0V!>
zvZgMK=1ijG)xGU4V1@reV`i-bm0#ZlTnG3Ba1r2JKpn5o>1RCSz^)12amT#1PMJ8n
zF2W55-U|udFRQ&{==o5b^uPG0U(vX(UYCmPaNHRKJIu_29?V|#L_bR6)qrQ(o8CB5
z){ePu@MY(cLA@Ire-x5|)ok4^a|a?p%&M4ZQwt`o>9o0a0>5$AXrAbv;bAof$NGN7
zors4`*ClDOvcAqdm&|Edt874sEo!&S@T%Bi$HSp<+cw8;!a{#`Lg>>x$k{GRT0g~*
z9UDK`9APQ9gz@m;X;m2PwC_;QnnP!Wva&<7U5$7&zZFGUG;ADGI~hE~h(X`X;l5RU
z%5RuhK*wqA<M<*|Ha>?Z4*YSH4wt8HhnC*m7I4@2sq9G;w{M$o?ONAP&Hbk^JLQ?*
z$j@dv#y0)BidS~<4h_?TH^)}ltHHs$h8@P{UTtjrLpaopsgQGZhyZTXtHR+LRiNcY
z4JpT+5i-<e$o5M<6dZ@Y2Ue}w{w(xowuh+SktQ5>CNoY!FONfgdh_$*uXz$bke3Ns
zK1}`ZYk0~2+&X4u9UI03TX8AqF4xjJ#gFc&5yOF*<q|IW%5K4{W-6tcS&+)tkUygw
zsOx7rM}y*IArsCBbp0$hoc(;_p?${cXAfJ~DX_704h!NsS)PprvSyZbNvTfOHID-!
zCbT7WvH}mwc+LEd@@h%)u;MydOjHBQy+YvGLBzw#Jg+dcHU`Ka5zN3cmNM}SvbC|`
zVmlr-hAu7SGn(oMYJv3eIDn;$25rxcB-DMXMW09Lj_b0(5>JGxuUA1GuZ=%|k1jFw
zy#($b^&Lj6*ffW`#s|fV7wDc#Zy3Y7&T7Bqhe@T@|ARWGbahQlMx*1^53A^%%;XyN
zX&4>cUqCd+z7bl>hvmWPiD7wgm>qoONo7Ru#>QU<{*V9sw-v-e){qIp>AYW#+Ad9r
z{4k`|qL<FrEOF8+Sli~F-T*Alt8%^v82ij_53AR-R&OiJiZf~<e^H(-`lhZq(Z+sm
ztr|v_Q#uQuo3l!c#S}(qhdA~f637+8IAg^*pr~dRN=}yBzOOcxoVsLVaX%JoWAP@J
zD&dHjljSxFGApn@?vpE7ix9b|dp`rLj%3%-Cc+R<M%^GL4;hQ6I9a!hx^UC5ZvD3n
zEuhVa`~~<OR{k@1;!s_IZo8hm`RPg!+{7aLY57V%daK;C(~tqw?C8dP0&!gFjkMsv
zc23K%bq}Ym^uJ37?>Zjhkq7*9BMsCXmIj6$T+-s^T{h1jQV+RnW8;tD;vhiEv8vXw
z!VIs<_CwO2+!|-=C}sN7`csM<CFF%I=J`-~P=1??Ohf%t+divTZ-18U>6sT+y+K))
zncFun+cXNu^=hndE*?TG5d?Y=)@r309@aJJX$UqxCbRME6a%xa%tQFN2YkPk(J`|C
z_~~`X{RHt7JkvT^#v?o<axxTU%JQ%hPL`{Ub(jV%H=6(e5CBO;K~!v%Z829fOL4MX
zwkyxZitA*7UkpRCx*iUR(mhnHjb*1{wmDB=CSAKW7Kqwdhht+&PF7!?EaFy?-%K<!
zC(BMq)W+fpadsBwm=sSc90Bob21^+b9(U_x0o>&{Q1ZIF;UF+ULoGdL%QU{)xIc&Q
zj)rl&8i&AQQ`+0jVS)X@2%4b$^w<XTnDq@QGkP{p7UC11Ty_-(mCibOOc7Tz9kp&?
zhgpxcm5jQGhwM5YFl9IQYv>$y4CI@o!|L(p2ETK%t76>=d}HGm!!xjoAV>)r!>v>H
z)ZsjbbY>-)An<hJe$yWFzQM*enje(5n6oEiCl=<Y=cWDQ&XQAitzE1QEcM1QgHAq)
zur*r{p6vz#)T?5N7RhCPmCj4H?`8LtmZy8>%)vg_IGJ1;2|`vVm&rm^CkrP6wpJTU
zwm$uZ-dxB>d!|knyQs?Mt3*Q3nA^8KlAq#T0@M874;INP{56DEs%72teK&gN@{&0(
z;P1?21Wz1L@1lDKuiWAET65FycjrPGX%!y5L+;<Z(+rw;r-~by#9@uIy2ccdRW##|
z-hJjL(xG8uaEkuz9DLo;e=B=MGsE`TUfb$P?p0&AoxR%FusH0;pUDy2sa*wSxmd3X
zdSzYXNy^~_HX%27QbI<_hl=`5dnP^IEj6}by`^oapdAX^L&W*gJTL7Zcad>c{Fz@D
z^l1yKuJ6g=X10V(oH&_tA{SQ*5i9kxyv2>WY_0{@<E~qvUO6k|G)|r!Lc+<)wys7P
z*U9on2L!5+kjWcpk4@(e&(8`OD3(pxErco$E9PX0XB4J9tV(Sx=@M>HWUt~nSw5CX
zRKg0iv2>lRv^JI%n3LsljlrmtlLcNQxrh}`G~YAw>gQ@>`R5gqd2*<$>cw$82!hES
zmwcsPvWKmjw{C%XlzVk-LbvSB0Xz9A)baWqpnvl9t++jd-T+=~W$z^BuwX7h{rUj7
z?dKcr5zeic(OQW4C7NHFOB=nIy=oxw4->CuhUvoOMEcl*Q-gQKfLiX}>2_^*BQHr0
z3@gW<9sK5ruZo8bgpG~gh>L+m5WbMD%l?q;kr$!gx*3@uJcX=7mjB27VtdH-S7mH(
zqjYDsIeO*-S`L1w*W2<*i$OnkU#Rq*lo7lgzVK5Nd$K)*^-zdsj1>?Y-HLGppA)Hg
zAg!6@EJyk4NH?UEd0?!V00kG2NF4!ZvZU;OH-|}WEc;g<GmGRe4fU?^FtY5GOGzaY
z4sx+hRuoUs)Kl+kVDe|ixd<rPS5`XB^9nnIw2E6pJkH6wJ;8+*4xABQ!PwN^vuoq`
zWALE)#61k%db=A7rbZcQAs)Rk?%%t|44Qtkj9X+Gm{EHp!7;EABHmb;u07``(r4Ig
z_NqO6JaVt2+S^UroQln1N0zs?ZQJHshd9ma-PriYaM<jLJ!ldcBH7)qm+DyAJ7Jdj
zP*nAj#@l|L)QpUh>(rKk?_)Flw`4MG52|g$dQ01!gLBb-_{m?mb;|kb`Y-UXdVI^#
z6moObmZBaJGtMqF9o8CzkOhh2P{yj^VR@S~agLIW<@r`Wy@z3?$;w&w!y}N6?9kPk
zS#g~#C)*cMzGfE7Zg?gPF*zyp%R>>BOmG~BV>X%oGv#DKwl)^HStp#VY@IB#1fuGE
zTpJ5=JS@|5o>qoX8w(T<3q@@#As?EJMVgZZpm|uCmN=}Gb1ezYMS`r2#g(uQdvuWh
zm8px&anPNsn+24F3@E(lrh$qH0{1|<SI1UQ0f$H~)c4x>^SB)bV}bXSxs5IEVA<4y
zDeI4}Mb5ur70;<|M)%or81vI7m@C3KtFfUe^}<y4YRs9luInXUjgD_W?|ZDrh<MdC
z-S&1j7Pn@}?Sr&o`NP?(8+tc3{yhW+R<?B;J#|#3AjoqmDmG@?eqNQ$h7f0h`eoou
zN@9T@dBkGhVq=?@Ua&v&s@o6BPSrXcS-)L#8mjgc){glLvOh)NIXe0_sLYIzcCcqU
zZ0#Cc920KTqu(2T@DV@uIY&>M7t|&{!=RkKa`oW#uM0z-tADAl-`N%3#i%xxXu;>d
zvOKJ!4~t7v+&Z&iZSRP&D36g)%dC4r2F)12Gn_1NhAo(&!@JC^b#@P8!8AW+`^Gxl
zh=PyasL-vqN3eLB?xJNqR@iyluyCQ#HijnNX<^<8v**M4)W+a;Q>iN$a^|e}$TzD8
z?>$=7-~%&mZ+gooP}G3s-_nka4`btZ4=}ms&R%V7WO0Q1Jyll-XtH*d;#<jn)iN)J
zPo`cj^Lk3PqH_Hx`mx&2nI`|cDya1f8Qhk(9}3&UuuS5aZn<sx^!CpyZtZ&J{dQFZ
zI`!(**ClL;h;n`7b$9VV@pBKe@k1bD%sjD9$6*w=WL$Qd@#8pm(H=9i+~}4o75G^o
zWa68A=b6j$z|RWv4YIY(zH2mGmLp)HW){YEvJ6!SEKdr23$e^~vRomui%ll_ZM7_)
zpUPIqx_(cJW$snBPL_R;BLoNdHmQw;l9T0r?U?6bL9sR#^S=OPkIxBePF85`3fj=K
z5h%!PvK|&`8O2dxs<4>~S*J-4_I*cM0C`L1@E9q>SVjH?H?h!8%Dp-^sqV1|n8VNr
zUADh5l??-$di7yJv@D)UW1st2GfiiZI6<vG3>GcNtYO;kO=J4bgfp0R0)KqGs&Puu
z@O}f%oS#b{VQnrxJ12k<@oL@J^AQC#4J(e;BHBy2{v;Gs!^Xx&4)}kYrx2nz`f&b8
z^ml`m{<d7;OxZ1pvg8?+`u(j~S(bh%^$Y)q@7!~KLn!;R){l+t(LB|zY#a8>3(NBb
z#q-iW#K7}P)}pjtz6CC=U5NoK^cS4vH!55($vGO96w3bCzJhMf$3=FCu~CkZu1Qsc
z@Vm`0`XPyOd&&#1QfPXam)ZT`PMI9n#sZ&lBdyE*<}q8~DxQ{NW96os8OCL`4i`BD
zoB?!3@V<rGSmz1iV}8i{yj5{;UQwU5l>AE0b``>N5DP|mjFV;H0%#3hFPODrr$u;v
znKrud<Wg9C^d@9-daJy$a_*%5S&l`f-ZM{pIuGvA*WHI3u9*D7V^(9AGD;N<8#%Va
z<aGKz7iLpe<Ae83`a!e9_%uB7$ePjU;C*{PuX<zSU&Y1FP<P(Cz7>cJ2+Nf=!>`G3
zsakT({c$qXW$fq|45ori(9s`ce{UW46Wr=2+f&^B#~!A<#QhlVu}9|>`r+c39C;rS
zS2D`1MQOc6Y#0sI7@$(UtxVK~UnYiZ2I#n@kb|&1EEVUWMG?m`rd_oxSuIZRuzZ~?
z%fljOjah3n8HuxJ2`393j|^4KEFe;xEC{)t(-DbswXvk^=4~I!Xw(=p(aj~PjRkRS
zEbvb%l>Ly_$+Bx<QhjJiO2Ua^y3E5;GG0n-9WL<vEVJ&!zU4O{Cm+Urhvk%kuZ@**
zvZR?le8l*|apvgr`9xhC%jI*KpXD!zZ(YRrA#RQGEStj~or_ox3r(fMYyD1(fMvja
z(2Ccu!>4EZ?3#9AczO?cW!>B<VOlK?&85q<#=Md-eJgd#OE+A>ddD^2(>ShZc)zh7
zrlvzK)ceMV8H^9!JL%`l7C}YDVHX{_#qnW&?_0q4J~%cuekB|OYbnUzI<s7BDdAfc
zxIeOu``u)oI+L^}-1y*`Jq`7oITxwMLg$$q-`&TDwaBhZDvJ!4V|dkLBU@FfZG9)Z
z0Slw05v3wc{OYVSwEU+qQtnuA&w^AMs{3HoFZn~l=E5+0*kCA9h3(o{luHDvwo)4_
znuZ<{{Vxr3gUWelW}gN?M-0hrvwK@9jFd#R+cRiyY3jg&A)xz+m;(A{71mmN&$Oiz
zTZCuXTN?#@)9u8X09YGF5BP_Cvm8sUy=|fyplMQvnt4lZIb`;X^k^<7+7xF_=EL)v
zP1C4<mku7rrT)QZ9NahZ7;5=Ye3ErlS1~fi<eocwwXxB}5$?^d<HgFlc9oRF8Kokp
zoSIteeuE?A!1pQElZyKx$Y5nC%dlF;kg>>aL&1eZ<CArNZ5w1B*1~ytUrC-9M1Bsn
zx;koa=_*2j;YIb>ICD`1nb;#{ZrQw;B>Y(aiv^If>_L`E$(*r3&QO>ye1h(bjDpu=
zZ||M`HdQ0#kPWfyCsRtw$>=PnT1&nK&%Kf|o4`ylD<1ZTpw4D;E<ny(L9I5H<X&N`
zP8MKX8;j)Bxy7)nmru)_I=v@DJuIx%#<JQx8w<D|R!~k9A|u=)A&JX8^~+$v$x;y;
zN41a1>2G>dEEvMu^UNiYu`sYC;689EdxZ+GdwZ{#=Pa-fu+ahR27DOvvG-5}ulEmW
zzSRTA**a?%IntJ@Y?)M5bJvnthln%(%Ss0~m6zy)x&|;cBN68<ZKH!zSfR%7%JLZp
z*D!yq(M<MgA=)Z#9sP7m^~S~qG#FU^_IF4ofKn|aC)0dgs^yn7%kafKEEv*`<0=pf
zgdQcw>x+ir6~#jmGpOa1x8)4v^h}VGdRy6P7T>MUh>~XrYCHTy`$ttHF&oSMB`8zb
zI$8Etfo@1C*VG<{A>}QN26bXwCyRCYI$6D(Eb{51!pQ?e$``@~6<rCp%*2B1IazK8
z5Fh_CZada13lw{Yk&xSHU2G-`!#YwJ<1W^W0$pc}`@nVfUU<~zdzLPp=NI7Dk-Yxg
z75}9F-#Ds&71PRMsm&`4wVw$cR?+mE9k`KPfI00q7GgjhNp&-34yUeQ4p07Ou=Crb
zc<>oFcMm==_GEsi+x*6c4a*mt187q9#>NKYCxP`p^S7HKU+|?Z@srx3j2IKK><xA4
zZh5&(@<UzsGYh47qurMEO?qlWD?5PwbHUO!1j4u4{}-X>5bH9qjwhXcTOI?kfiAyb
zSy@<)a6dg%GLXtgaEqQo1e|?K`cZImyo|Yi48PY)+n;w&Tbn%3hsw6hU~=`durz$+
z083B8F<n<;sb@>A-u~x*C|Ghpc}#%n_^}U(J*m9}9c?=P0cnK$+F|9$=VLkK3RmFw
zB(wPJw-#TV&ssOe#-GKl=zT4}xc+X6)IZN*o#jhSrM6)$eILqO%_gmGDP_f@o4%8}
zg2{OeP?aafC*SlBJ~r>?QdbSzZy!7D4ZAFVEP=JNR~sAsC^4|o1O|=gxzg;C_<(uw
zBJ53kkcZWw9r_KxnZW^WeC1MzFd08b!qvijeo7>1II-9?Y}WLm<@`Q`3})Sc?C~Y+
zFKH;uymPTp%!3b0pT<)PtXR%rd6O$VESGQXuZ<=1ZqCr_2dLp%2eIiN5NkECb=_ad
z7|3mX%z>-d0b>^6E#A#yW|qY}#_z<|#voRP<qIMH$Q{&MNh|oxc`LE)NcRZdr(D6^
z73oz<k-F!zSF?G*UM<spo8ex~BnkUQ9zx4GrID7G;A;Q?5CBO;K~zUpjwZ(M+xvO#
z8ygz}2cPWh2b7n~b*w1q@$7>*hXtbF%I@BUWw0`=s8Pj}U{Rb3so38uQ%8SlNNyXd
z>|2xhx9oL$>|K6!E(E20Gcw5j@KgE9T9|$M*Ura-$U`8N>Yc$Uwh^(H#^>cRu9Rdn
zh<KK94kGe@wmu2Hi%3q@`c=y4WuHHjNgGic%d&nh4-$C?7&qB%5S&atZR2I@a<tqZ
z<fIOG){n6yu8MWa9;Y#u`92!C_R}@+flL?**(jFn(kHAa$!xk)8_Ub+do)|hR~EDR
zuk%{p6F}F)lCle5Q5);04QflZvD}7!?NJ;B;U|tfCg-h4#39$iG@WHs6l~Xp6$C|E
znxQ*}5R@+I?if0U?rx+zq)WOPYUl=$p;J1fL%KV@dET|Yzsw)zUT5yu=i2*-`prbE
zBw*q{XZ8kB1{tGy;y0az`}X?fAqyZ@bZN%a{UQL6_pHtq#m$R(9`$S>KHc{iSie%)
zc>N9Yk0k}9;<E8K_r3e|v8!x`;Y9tQS&bah7lnM2@smI>t#gyt)i0CjF?>SxxYrn?
zez8(xVX+eax<nf3+0>my-9GK5Z4OP$)J(21#fww%eaPHlkv>g+pkB<49$BVvk4Z|a
zt5Xn{WLQ}9X_IfZNg}n+j(%P*2K`EKi``O&Sw!e6CM>Km4S$$;z}$L4O0C3JsqzoH
z=-{-4@~}z|?Q`0=r+aE5Y5acw1-5L|GT76gs7cq??@cSrY>x+E=49zf;6YHh6x~yz
zPkIf$Wg)QuCXO^SaTn3i44%AoHj!F4jx@xci!Zqkru*tZ^tTY)tJ7!N@%0Dc#OOa6
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

literal 0
HcmV?d00001


From b526b232483d3f8014b7ca918fbf2e1e1d15c1ba Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 15 Jun 2026 02:05:57 +0530
Subject: [PATCH 104/314] lint: conform UX v2 + model-migration code to #47
 ruff tooling

Rebasing feature/ux-v2 onto development (now carrying #47's ruff/format
gate) left the model-migration and detector-rewrite files in their
pre-#47 formatting. Run ruff --fix + ruff format and fix the violations
that aren't auto-fixable:

- model.py: provenance annotation used unimported `Dict` (F821, would
  NameError at import) -> `dict[str, dict[str, str]]` (PEP 585).
- sam_detection._detect_with_sam: returned undefined `image_8bit`
  (F821) -> `image_rgb`, the 8-bit RGB image computed at the top.
- agent.py / sam_detection.py: moved the `logger = ...` assignment below
  the import block to clear E402 (import execution order unchanged).
- verifier.py / conversation.py: wrapped long log/summary f-strings and
  tool-schema descriptions; reflowed prompt prose (content preserved) to
  satisfy E501.

ruff check . and ruff format --check . both pass (lint.yml CI gate).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/agent.py                     | 480 +++++++++++++---------
 gently/app/detectors/hatching.py        |  50 ++-
 gently/hardware/dispim/sam_detection.py | 480 ++++++++++++----------
 gently/harness/conversation.py          | 350 +++++++++-------
 gently/harness/detection/verifier.py    | 525 +++++++++++++++---------
 gently/harness/memory/file_store.py     |   3 +-
 gently/harness/memory/model.py          |   2 +-
 gently/settings.py                      |  23 +-
 gently/ui/web/connection_manager.py     |   4 +-
 gently/ui/web/routes/chat.py            |   2 +-
 gently/ui/web/routes/context.py         |  15 +-
 11 files changed, 1134 insertions(+), 800 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 40618718..f68d67a7 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -14,38 +14,38 @@
 import asyncio
 import logging
 import os
-from typing import Dict, List, Optional, Callable, Any, TYPE_CHECKING
+from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
+from typing import TYPE_CHECKING, Any
 
 import anthropic
 import numpy as np
 
-from ..exceptions import StorageError, AgentError
+from ..exceptions import StorageError
 from ..settings import settings
 
 if TYPE_CHECKING:
     from ..ui.web.server import VisualizationServer
 
-logger = logging.getLogger(__name__)
+from gently_perception import Perceiver
 
-from ..harness.state import ExperimentState, EmbryoState, ImageRecord
-from ..harness.orchestration.plan_synthesis import PlanSynthesizer, PlanLibrary, PlanValidator
+from ..core import EventType, emit, get_event_bus
+from ..core.file_store import FileStore
+from ..harness.conversation import ConversationManager
+from ..harness.orchestration.plan_synthesis import PlanLibrary, PlanSynthesizer, PlanValidator
+from ..harness.prompts.manager import PromptManager
+from ..harness.session.interaction_logger import InteractionLogger
+from ..harness.session.manager import SessionManager
+from ..harness.session.timeline import TimelineManager
+from ..harness.state import ExperimentState
 from ..harness.tools.registry import get_tool_registry
-from gently_perception import Perceiver
 
 # Import tools package to trigger @tool decorator registration
 from . import tools as _tools  # noqa: F401
-from ..harness.session.interaction_logger import InteractionLogger
 from .orchestration.timelapse import TimelapseOrchestrator
-from ..harness.session.timeline import TimelineManager
-from ..core import EventType, get_event_bus, emit
-from ..core.file_store import FileStore
-
-from ..harness.conversation import ConversationManager
-from ..harness.session.manager import SessionManager
-from ..harness.prompts.manager import PromptManager
 
+logger = logging.getLogger(__name__)
 
 # Shown when the agent is launched in UI-only mode (--no-api). The web UI is
 # fully browsable, but anything that would call Claude is disabled.
@@ -71,7 +71,7 @@ class MicroscopyAgent:
 
     def __init__(
         self,
-        api_key: Optional[str] = None,
+        api_key: str | None = None,
         storage_path: Path = Path("./experiment_data"),
         model: str = settings.models.main,
         microscope_client=None,
@@ -113,7 +113,9 @@ def __init__(
         # 4.6+ models and obsolete on Fable 5 (always-on thinking); the header is
         # dropped so it can't conflict with the new model family.
         self.claude = anthropic.Anthropic(
-            api_key=api_key or os.getenv("ANTHROPIC_API_KEY") or ("no-api-mode" if no_api else None),
+            api_key=api_key
+            or os.getenv("ANTHROPIC_API_KEY")
+            or ("no-api-mode" if no_api else None),
         )
         self.model = model
 
@@ -125,7 +127,7 @@ def __init__(
         self.mode: str = "run"
 
         # Context store (agent's mind — set via set_context_store)
-        self.context_store: Optional[Any] = None
+        self.context_store: Any | None = None
 
         # Experiment state
         self.experiment = ExperimentState()
@@ -141,8 +143,7 @@ def __init__(
 
         # Plan synthesis
         self.plan_synthesizer = PlanSynthesizer(
-            plan_library=PlanLibrary(),
-            validator=PlanValidator()
+            plan_library=PlanLibrary(), validator=PlanValidator()
         )
 
         # Event bus for async messaging (must be before perception manager)
@@ -163,8 +164,8 @@ def __init__(
         self.client = self.microscope
 
         # Callbacks
-        self.on_message_callback: Optional[Callable] = None
-        self.choice_handler: Optional[Callable] = None
+        self.on_message_callback: Callable | None = None
+        self.choice_handler: Callable | None = None
 
         # Serializes conversation turns: user turns and autonomous wake turns
         # must not interleave on the shared conversation_history.
@@ -175,14 +176,18 @@ def __init__(
         # human). User turns are unaffected. _wake_choice_factory is set by the
         # web bridge so ASK-mode wake turns can round-trip an approval picker.
         self._autonomous_active = False
-        self._autonomous_blocked_tools = frozenset({
-            "set_laser_power", "remove_embryo", "stop_timelapse",
-        })
+        self._autonomous_blocked_tools = frozenset(
+            {
+                "set_laser_power",
+                "remove_embryo",
+                "stop_timelapse",
+            }
+        )
         self._wake_choice_factory = None
         self._wake_choice_discard = None
 
         # Interaction logger for structured logging (research data collection)
-        self.interaction_logger: Optional[InteractionLogger] = None
+        self.interaction_logger: InteractionLogger | None = None
 
         # Event capture — durable log of every EventBus event during this
         # session. Substrate for offline replay / shadow-mode A/B of
@@ -195,13 +200,13 @@ def __init__(
         self.decision_log = None
 
         # Timelapse orchestrator (initialized when microscope connected)
-        self.timelapse_orchestrator: Optional[TimelapseOrchestrator] = None
+        self.timelapse_orchestrator: TimelapseOrchestrator | None = None
 
         # Timeline manager for tracking events
-        self.timeline_manager: Optional[TimelineManager] = None
+        self.timeline_manager: TimelineManager | None = None
 
         # Visualization server for real-time feedback
-        self.viz_server: Optional["VisualizationServer"] = None
+        self.viz_server: VisualizationServer | None = None
 
         # Device-state monitor (bridges device-layer SSE → EventBus)
         self.device_state_monitor = None
@@ -219,10 +224,10 @@ def __init__(
         )
         # Wire tool execution context
         self.conversation._tool_context = {
-            'agent': self,
-            'client': getattr(self, 'microscope', None),
-            'microscope': getattr(self, 'microscope', None),
-            'databroker': getattr(self, 'databroker', None),
+            "agent": self,
+            "client": getattr(self, "microscope", None),
+            "microscope": getattr(self, "microscope", None),
+            "databroker": getattr(self, "databroker", None),
         }
 
         # Session manager (persistence)
@@ -242,16 +247,22 @@ def __init__(
             success, history = self.sessions._resume_session(session_id, self.experiment)
             if success:
                 self.conversation.conversation_history = history
-            self._emit_event(EventType.SESSION_RESTORED, {
-                'session_id': session_id,
-                'embryo_count': len(self.experiment.embryos),
-                'message_count': len(self.conversation.conversation_history),
-            })
+            self._emit_event(
+                EventType.SESSION_RESTORED,
+                {
+                    "session_id": session_id,
+                    "embryo_count": len(self.experiment.embryos),
+                    "message_count": len(self.conversation.conversation_history),
+                },
+            )
         else:
             self.sessions.create_session()
-            self._emit_event(EventType.SESSION_STARTED, {
-                'session_id': self.sessions.session_id,
-            })
+            self._emit_event(
+                EventType.SESSION_STARTED,
+                {
+                    "session_id": self.sessions.session_id,
+                },
+            )
 
         # Initialize interaction logger (for research data collection)
         self._init_interaction_logger()
@@ -284,6 +295,7 @@ def __init__(
         # autonomously; enabled via the set_autonomy tool.
         try:
             from gently.app.wake_router import WakeRouter
+
             self.wake_router = WakeRouter(self, self._event_bus)
         except Exception:
             logger.exception("Failed to init wake-router")
@@ -300,7 +312,7 @@ def session_id(self) -> str:
         return self.sessions.session_id
 
     @property
-    def _session_id(self) -> Optional[str]:
+    def _session_id(self) -> str | None:
         """Internal session ID (backward compat)."""
         return self.sessions._session_id
 
@@ -309,7 +321,7 @@ def _session_id(self, value):
         self.sessions._session_id = value
 
     @property
-    def conversation_history(self) -> List[Dict]:
+    def conversation_history(self) -> list[dict]:
         """Get conversation history."""
         return self.conversation.conversation_history
 
@@ -354,6 +366,7 @@ def set_context_store(self, context_store) -> None:
         self.prompts.context_store = context_store
         # Create agent memory harness
         from ..harness.memory.interface import AgentMemory
+
         self.memory = AgentMemory(context_store, session_id=self.session_id)
         self.prompts.memory = self.memory
 
@@ -363,6 +376,7 @@ def enter_plan_mode(self) -> str:
             return "Already in plan mode."
         self.mode = "plan"
         import gently.harness.plan_mode.tools  # noqa: F401
+
         self._update_system_prompt()
         emit(EventType.STATUS_CHANGED, {"field": "agent_mode", "value": "plan"}, source="agent")
         logger.info("Entered plan mode")
@@ -442,7 +456,8 @@ def exit_plan_mode(self) -> str:
                 if item and self.session_id and self.context_store:
                     try:
                         self.context_store.link_session_campaign(
-                            self.session_id, item.campaign_id,
+                            self.session_id,
+                            item.campaign_id,
                         )
                     except Exception:
                         pass
@@ -468,11 +483,14 @@ def exit_plan_mode(self) -> str:
     def _update_system_prompt(self, context_summary: str | None = None):
         """Rebuild system prompt via PromptManager."""
         self.system_prompt = self.prompts.update_system_prompt(
-            self.experiment, self.client, self.mode, context_summary,
+            self.experiment,
+            self.client,
+            self.mode,
+            context_summary,
             perceiver=getattr(self, "perceiver", None),
         )
 
-    def _get_active_plan_summary(self) -> Optional[str]:
+    def _get_active_plan_summary(self) -> str | None:
         """Delegation shim for agent bridge access."""
         return self.prompts.get_active_plan_summary()
 
@@ -502,7 +520,7 @@ def _auto_save(self):
             self.experiment, self.conversation.conversation_history, self.system_prompt
         )
 
-    def list_sessions(self) -> List[Dict]:
+    def list_sessions(self) -> list[dict]:
         """List available sessions."""
         return self.sessions.list_sessions()
 
@@ -535,6 +553,7 @@ def _init_event_capture(self):
         a stripped-down agent) — replay just won't have a log to read.
         """
         from gently.eval import EventCapture
+
         try:
             session_dir = None
             sid = self.session_id
@@ -542,7 +561,8 @@ def _init_event_capture(self):
                 session_dir = self.store._session_dir(sid)
             if session_dir is None:
                 logging.getLogger(__name__).debug(
-                    "EventCapture: no session dir for %s — skipping", sid)
+                    "EventCapture: no session dir for %s — skipping", sid
+                )
                 return
             path = session_dir / "events.jsonl"
             self.event_capture = EventCapture(path)
@@ -569,6 +589,7 @@ def _init_decision_log(self):
         logs and the two are diffed offline.
         """
         from gently.eval import DecisionLog
+
         try:
             session_dir = None
             sid = self.session_id
@@ -576,7 +597,8 @@ def _init_decision_log(self):
                 session_dir = self.store._session_dir(sid)
             if session_dir is None:
                 logging.getLogger(__name__).debug(
-                    "DecisionLog: no session dir for %s — skipping", sid)
+                    "DecisionLog: no session dir for %s — skipping", sid
+                )
                 return
             path = session_dir / "decisions.jsonl"
             self.decision_log = DecisionLog(path)
@@ -674,12 +696,15 @@ def on_stage_detected(event):
                     embryo_id = data.get("embryo_id")
                     if embryo_id and embryo_id in self.experiment.embryos:
                         embryo = self.experiment.embryos[embryo_id]
-                        embryo.add_cv_result("stage_classification", {
-                            "stage": data.get("stage"),
-                            "confidence": data.get("confidence"),
-                            "nuclei_count": data.get("nuclei_count"),
-                            "timepoint": data.get("timepoint"),
-                        })
+                        embryo.add_cv_result(
+                            "stage_classification",
+                            {
+                                "stage": data.get("stage"),
+                                "confidence": data.get("confidence"),
+                                "nuclei_count": data.get("nuclei_count"),
+                                "timepoint": data.get("timepoint"),
+                            },
+                        )
                 except Exception as e:
                     logger.warning(f"Error handling stage detected event: {e}")
 
@@ -702,23 +727,31 @@ def on_perception(event):
                     stage = data.get("stage")
                     # 'no_object' is an empty-field sentinel, not a developmental
                     # stage — don't mirror it into latest_developmental_stage.
-                    if (not stage or stage == "no_object" or not embryo_id
-                            or embryo_id not in self.experiment.embryos):
+                    if (
+                        not stage
+                        or stage == "no_object"
+                        or not embryo_id
+                        or embryo_id not in self.experiment.embryos
+                    ):
                         return
                     embryo = self.experiment.embryos[embryo_id]
                     if stage == getattr(embryo, "latest_developmental_stage", None):
                         return  # steady state — nothing new to mirror
-                    embryo.add_cv_result("stage_classification", {
-                        "stage": stage,
-                        "timepoint": data.get("timepoint"),
-                        "stability": data.get("stability"),
-                        "temporal_analysis": data.get("temporal_analysis"),
-                        "detector_name": "perception",
-                    })
+                    embryo.add_cv_result(
+                        "stage_classification",
+                        {
+                            "stage": stage,
+                            "timepoint": data.get("timepoint"),
+                            "stability": data.get("stability"),
+                            "temporal_analysis": data.get("temporal_analysis"),
+                            "detector_name": "perception",
+                        },
+                    )
                     self.invalidate_context_cache()
                     self._auto_save()
-                    logger.info("Perception: %s -> stage %s (t%s)",
-                                embryo_id, stage, data.get("timepoint"))
+                    logger.info(
+                        "Perception: %s -> stage %s (t%s)", embryo_id, stage, data.get("timepoint")
+                    )
                 except Exception as e:
                     logger.warning(f"Error handling perception event: {e}")
 
@@ -733,7 +766,9 @@ def on_perception(event):
 
     # ===== Visualization Server Methods =====
 
-    async def start_viz_server(self, port: int = settings.network.viz_port, ssl_certfile=None, ssl_keyfile=None):
+    async def start_viz_server(
+        self, port: int = settings.network.viz_port, ssl_certfile=None, ssl_keyfile=None
+    ):
         """Start the visualization server for real-time feedback."""
         if self.viz_server is not None:
             logger.info("Visualization server already running")
@@ -783,6 +818,7 @@ async def start_viz_server(self, port: int = settings.network.viz_port, ssl_cert
         if self.microscope is not None and self.device_state_monitor is None:
             try:
                 from .device_state_monitor import DeviceStateMonitor
+
                 self.device_state_monitor = DeviceStateMonitor(self.microscope)
                 await self.device_state_monitor.start()
                 logger.info("Device-state monitor started")
@@ -796,6 +832,7 @@ async def start_viz_server(self, port: int = settings.network.viz_port, ssl_cert
         if self.microscope is not None and self.bottom_camera_monitor is None:
             try:
                 from .bottom_camera_monitor import BottomCameraStreamMonitor
+
                 self.bottom_camera_monitor = BottomCameraStreamMonitor(self.microscope)
                 logger.info("Bottom-camera monitor ready (not started)")
             except Exception as e:
@@ -826,16 +863,14 @@ def push_viz(
         array: np.ndarray,
         uid: str,
         data_type: str = "image",
-        metadata: Optional[Dict[str, Any]] = None,
+        metadata: dict[str, Any] | None = None,
     ):
         """Non-blocking push of image to visualization server."""
         if self.viz_server is None:
             return
 
         try:
-            asyncio.create_task(
-                self.viz_server.push_image(array, uid, data_type, metadata or {})
-            )
+            asyncio.create_task(self.viz_server.push_image(array, uid, data_type, metadata or {}))
         except RuntimeError:
             pass
         except Exception as e:
@@ -854,7 +889,7 @@ def _has_microscope(self) -> bool:
         """
         return self.client is not None
 
-    def _emit_event(self, event_type: EventType, data: Optional[Dict] = None):
+    def _emit_event(self, event_type: EventType, data: dict | None = None):
         """Emit an event to the event bus."""
         self._event_bus.publish(
             event_type=event_type,
@@ -895,10 +930,13 @@ def _publish_embryos_update(self) -> None:
     def _mark_significant_action(self, action_type: str):
         """Mark that a significant action occurred (triggers auto-save)."""
         self._auto_save()
-        self._emit_event(EventType.SESSION_SAVED, {
-            'session_id': self.sessions._session_id,
-            'action_type': action_type,
-        })
+        self._emit_event(
+            EventType.SESSION_SAVED,
+            {
+                "session_id": self.sessions._session_id,
+                "action_type": action_type,
+            },
+        )
 
     # ===== Public Message API =====
 
@@ -917,8 +955,11 @@ async def handle_message(self, user_message: str) -> str:
             Response from agent
         """
         if quick_response := self.conversation.try_quick_response(
-            user_message, self.experiment, self.mode,
-            self.enter_plan_mode, self.exit_plan_mode,
+            user_message,
+            self.experiment,
+            self.mode,
+            self.enter_plan_mode,
+            self.exit_plan_mode,
         ):
             return quick_response
 
@@ -932,10 +973,7 @@ async def handle_message(self, user_message: str) -> str:
         self._update_system_prompt(context_summary)
 
         # Add user message to history
-        self.conversation.conversation_history.append({
-            "role": "user",
-            "content": user_message
-        })
+        self.conversation.conversation_history.append({"role": "user", "content": user_message})
 
         tools = self._get_tools_for_mode()
         cached_prompt = self._get_cached_system_prompt()
@@ -962,14 +1000,17 @@ async def handle_message_stream(self, user_message: str):
             Chunks with 'type' and data
         """
         if quick_response := self.conversation.try_quick_response(
-            user_message, self.experiment, self.mode,
-            self.enter_plan_mode, self.exit_plan_mode,
+            user_message,
+            self.experiment,
+            self.mode,
+            self.enter_plan_mode,
+            self.exit_plan_mode,
         ):
-            yield {'type': 'text', 'text': quick_response}
+            yield {"type": "text", "text": quick_response}
             return
 
         if not self.api_enabled:
-            yield {'type': 'text', 'text': _NO_API_NOTICE}
+            yield {"type": "text", "text": _NO_API_NOTICE}
             return
 
         # Hold the turn-lock for the whole streamed turn so an autonomous wake
@@ -985,16 +1026,14 @@ async def handle_message_stream(self, user_message: str):
             )
             self._update_system_prompt(context_summary)
 
-            self.conversation.conversation_history.append({
-                "role": "user",
-                "content": user_message
-            })
+            self.conversation.conversation_history.append({"role": "user", "content": user_message})
 
             tools = self._get_tools_for_mode()
             cached_prompt = self._get_cached_system_prompt()
 
             inner_gen = self.conversation.call_claude_stream(
-                cached_prompt, tools,
+                cached_prompt,
+                tools,
                 tool_label_fn=self.conversation.tool_label,
                 auto_save_fn=self._auto_save,
             )
@@ -1089,8 +1128,11 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
         choice_data = chunk.get("choice_data", {}) if isinstance(chunk, dict) else {}
         factory = getattr(self, "_wake_choice_factory", None)
         if not interactive or factory is None:
-            logger.info("Wake picker auto-cancelled (interactive=%s, channel=%s)",
-                        interactive, factory is not None)
+            logger.info(
+                "Wake picker auto-cancelled (interactive=%s, channel=%s)",
+                interactive,
+                factory is not None,
+            )
             return "cancelled"
         try:
             future = factory(choice_data)  # registers future + sets request_id
@@ -1100,6 +1142,7 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
         request_id = choice_data.get("request_id", "")
         await emit({**chunk, "origin": "wake", "request_id": request_id})
         from gently.app.wake_router import ASK_TIMEOUT_SEC
+
         try:
             selected = await asyncio.wait_for(future, timeout=ASK_TIMEOUT_SEC)
         except asyncio.TimeoutError:
@@ -1122,7 +1165,7 @@ async def _resolve_wake_choice(self, chunk, emit, interactive):
                     pass
         return selected or "skip"
 
-    async def get_tool_call(self, user_message: str) -> Optional[Dict]:
+    async def get_tool_call(self, user_message: str) -> dict | None:
         """Dry-run tool call (for benchmarking)."""
         context_summary = await self.prompts.get_cached_context_summary(
             self.experiment, self.timelapse_orchestrator, self.timeline_manager
@@ -1134,25 +1177,25 @@ async def get_tool_call(self, user_message: str) -> Optional[Dict]:
 
     # === Experiment Management Methods ===
 
-    def load_embryos_from_database(self, database: Dict):
+    def load_embryos_from_database(self, database: dict):
         """Load embryos from calibration database."""
-        if 'embryos' not in database:
+        if "embryos" not in database:
             return
 
-        for embryo_id, embryo_data in database['embryos'].items():
-            position = embryo_data.get('stage_position_after_centering_um', {})
-            calibration = embryo_data.get('calibration', {})
+        for embryo_id, embryo_data in database["embryos"].items():
+            position = embryo_data.get("stage_position_after_centering_um", {})
+            calibration = embryo_data.get("calibration", {})
 
             self.experiment.add_embryo(
                 embryo_id=embryo_id,
                 position=position,
                 calibration=calibration,
-                uid=embryo_data.get('uid'),
+                uid=embryo_data.get("uid"),
             )
 
         self._update_system_prompt()
 
-    def import_embryos_from_session(self, session_id: str, clear_existing: bool = False) -> Dict:
+    def import_embryos_from_session(self, session_id: str, clear_existing: bool = False) -> dict:
         """
         Import embryos from another session into the current experiment.
 
@@ -1208,14 +1251,14 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         if not embryo_states:
             session_data = self.store.load_session_snapshot(session_id)
             if session_data:
-                embryo_states = session_data.get('embryo_states', {})
+                embryo_states = session_data.get("embryo_states", {})
 
         if not embryo_states:
             return {
-                'success': False,
-                'error': "No embryos found in session",
-                'imported': [],
-                'skipped': [],
+                "success": False,
+                "error": "No embryos found in session",
+                "imported": [],
+                "skipped": [],
             }
 
         if clear_existing:
@@ -1235,30 +1278,30 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 # Prefer explicit coarse/fine when the snapshot has them
                 # (FileStore path); fall back to flat stage_position for the
                 # legacy JSON-snapshot path which only carries the resolved view.
-                position_coarse = embryo_data.get('position_coarse')
-                position_fine = embryo_data.get('position_fine')
+                position_coarse = embryo_data.get("position_coarse")
+                position_fine = embryo_data.get("position_fine")
                 if position_coarse is None and position_fine is None:
-                    position_coarse = embryo_data.get('stage_position', {})
-                calibration = embryo_data.get('calibration', {})
-                source_uid = embryo_data.get('uid') or f"{session_id}_{embryo_id}"
+                    position_coarse = embryo_data.get("stage_position", {})
+                calibration = embryo_data.get("calibration", {})
+                source_uid = embryo_data.get("uid") or f"{session_id}_{embryo_id}"
 
                 self.experiment.add_embryo(
                     embryo_id=embryo_id,
                     position=position_coarse or {},
                     position_fine=position_fine or {},
                     calibration=calibration,
-                    user_label=embryo_data.get('user_label'),
+                    user_label=embryo_data.get("user_label"),
                     uid=source_uid,
-                    role=embryo_data.get('role') or 'unassigned',
+                    role=embryo_data.get("role") or "unassigned",
                 )
 
                 embryo = self.experiment.embryos[embryo_id]
-                embryo.nickname = embryo_data.get('nickname')
-                embryo.interval_seconds = embryo_data.get('interval_seconds')
-                embryo.num_slices = embryo_data.get('num_slices', 50)
-                embryo.exposure_ms = embryo_data.get('exposure_ms', 10.0)
-                embryo.priority = embryo_data.get('priority', 'normal')
-                embryo.acquisition_mode = embryo_data.get('acquisition_mode', 'volume')
+                embryo.nickname = embryo_data.get("nickname")
+                embryo.interval_seconds = embryo_data.get("interval_seconds")
+                embryo.num_slices = embryo_data.get("num_slices", 50)
+                embryo.exposure_ms = embryo_data.get("exposure_ms", 10.0)
+                embryo.priority = embryo_data.get("priority", "normal")
+                embryo.acquisition_mode = embryo_data.get("acquisition_mode", "volume")
 
                 # Light budget import. Prefer fields already on embryo_data
                 # (future schema may persist these directly on embryo.yaml);
@@ -1269,27 +1312,22 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
                 # removed and the import should fail loudly if dose is
                 # missing.
                 dose = self._compute_imported_dose(session_id, embryo_id)
-                embryo.exposure_count = (
-                    embryo_data.get('exposure_count')
-                    or dose['exposure_count']
-                )
+                embryo.exposure_count = embryo_data.get("exposure_count") or dose["exposure_count"]
                 embryo.total_exposure_ms = (
-                    embryo_data.get('total_exposure_ms')
-                    or dose['total_exposure_ms']
+                    embryo_data.get("total_exposure_ms") or dose["total_exposure_ms"]
                 )
                 embryo.timepoints_acquired = (
-                    embryo_data.get('timepoints_acquired')
-                    or dose['exposure_count']
+                    embryo_data.get("timepoints_acquired") or dose["exposure_count"]
                 )
 
-                last_imaged_str = embryo_data.get('last_imaged')
+                last_imaged_str = embryo_data.get("last_imaged")
                 if last_imaged_str:
                     try:
                         embryo.last_imaged = datetime.fromisoformat(last_imaged_str)
                     except (ValueError, TypeError):
-                        embryo.last_imaged = dose['last_imaged']
+                        embryo.last_imaged = dose["last_imaged"]
                 else:
-                    embryo.last_imaged = dose['last_imaged']
+                    embryo.last_imaged = dose["last_imaged"]
 
                 imported.append(embryo_id)
 
@@ -1300,14 +1338,14 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         self._mark_significant_action("embryo_import")
 
         return {
-            'success': len(imported) > 0,
-            'imported': imported,
-            'skipped': skipped,
-            'errors': errors,
-            'source_session': session_id,
+            "success": len(imported) > 0,
+            "imported": imported,
+            "skipped": skipped,
+            "errors": errors,
+            "source_session": session_id,
         }
 
-    def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> Dict:
+    def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> dict:
         """Reconstruct an embryo's realized 488 nm photodose from the source
         session's per-volume meta files.
 
@@ -1322,66 +1360,68 @@ def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> Dict
         TODO: replace with reading a persisted ``dose:`` block from
         embryo.yaml once dose-tracking is first-class.
         """
-        import yaml
         from datetime import datetime
         from pathlib import Path
 
+        import yaml
+
         result = {
-            'exposure_count': 0,
-            'total_exposure_ms': 0.0,
-            'last_imaged': None,
+            "exposure_count": 0,
+            "total_exposure_ms": 0.0,
+            "last_imaged": None,
         }
 
         if not self.store:
             return result
 
         # FileStore exposes _session_dir(session_id) → resolved Path.
-        session_dir_fn = getattr(self.store, '_session_dir', None)
+        session_dir_fn = getattr(self.store, "_session_dir", None)
         sd = session_dir_fn(source_session_id) if callable(session_dir_fn) else None
         if sd is None:
             return result
 
-        vols_dir = Path(sd) / 'embryos' / embryo_id / 'volumes'
+        vols_dir = Path(sd) / "embryos" / embryo_id / "volumes"
         if not vols_dir.is_dir():
             return result
 
         latest = None
-        for meta_path in sorted(vols_dir.glob('*.meta.yaml')):
+        for meta_path in sorted(vols_dir.glob("*.meta.yaml")):
             try:
                 doc = yaml.safe_load(meta_path.read_text()) or {}
             except Exception:
                 continue
-            md = doc.get('metadata') or {}
-            num_slices = md.get('num_slices')
+            md = doc.get("metadata") or {}
+            num_slices = md.get("num_slices")
             if num_slices is None:
-                shape = doc.get('shape') or []
+                shape = doc.get("shape") or []
                 num_slices = shape[0] if shape else 0
-            exposure_ms = md.get('exposure_ms') or 0.0
+            exposure_ms = md.get("exposure_ms") or 0.0
             try:
-                result['total_exposure_ms'] += float(num_slices) * float(exposure_ms)
+                result["total_exposure_ms"] += float(num_slices) * float(exposure_ms)
             except (TypeError, ValueError):
                 pass
-            result['exposure_count'] += 1
-            acq = doc.get('acquired_at')
+            result["exposure_count"] += 1
+            acq = doc.get("acquired_at")
             if acq and (latest is None or acq > latest):
                 latest = acq
 
         if latest:
             try:
-                result['last_imaged'] = datetime.fromisoformat(latest)
+                result["last_imaged"] = datetime.fromisoformat(latest)
             except (ValueError, TypeError):
                 pass
 
         return result
 
-    async def on_volume_acquired(self, embryo_id: str, timepoint: int,
-                                volume_data, volume_path=None):
+    async def on_volume_acquired(
+        self, embryo_id: str, timepoint: int, volume_data, volume_path=None
+    ):
         """Callback when a volume is acquired."""
         embryo = self.experiment.embryos.get(embryo_id)
         if not embryo:
             return
 
-        if hasattr(volume_data, 'read_volume'):
+        if hasattr(volume_data, "read_volume"):
             volume = volume_data.read_volume()
         else:
             volume = volume_data
@@ -1390,7 +1430,8 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
         if self.store and self.session_id:
             try:
                 self.store.register_embryo(
-                    self.session_id, embryo_id,
+                    self.session_id,
+                    embryo_id,
                     position_coarse=embryo.position_coarse or None,
                     position_fine=embryo.position_fine or None,
                     calibration=embryo.calibration,
@@ -1407,14 +1448,19 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
                 }
                 if volume_path is not None:
                     stored_path = self.store.register_volume(
-                        self.session_id, embryo_id, timepoint,
+                        self.session_id,
+                        embryo_id,
+                        timepoint,
                         incoming_path=Path(volume_path),
                         metadata=acq_metadata,
                         volume_data=volume,
                     )
                 else:
                     stored_path = self.store.put_volume(
-                        self.session_id, embryo_id, timepoint, volume,
+                        self.session_id,
+                        embryo_id,
+                        timepoint,
+                        volume,
                         metadata=acq_metadata,
                     )
             except StorageError:
@@ -1429,9 +1475,9 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
         if self.viz_server and volume is not None:
             try:
                 from gently.core.imaging import (
-                    projection_three_view,
-                    compute_crop_bounds,
                     apply_crop_bounds,
+                    compute_crop_bounds,
+                    projection_three_view,
                 )
 
                 view_a = volume[0] if volume.ndim == 4 else volume
@@ -1439,14 +1485,18 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
                 if view_a.ndim == 3:
                     z_depth, height, width = view_a.shape
                     if width > height * 2:
-                        view_a = view_a[:, :, :width // 2]
+                        view_a = view_a[:, :, : width // 2]
                     bounds = compute_crop_bounds(view_a)
                     cropped = apply_crop_bounds(view_a, bounds)
                     three_view_img, _ = projection_three_view(cropped)
                 else:
                     three_view_img = view_a.astype(np.float32)
                     if three_view_img.max() > three_view_img.min():
-                        three_view_img = (three_view_img - three_view_img.min()) / (three_view_img.max() - three_view_img.min()) * 255
+                        three_view_img = (
+                            (three_view_img - three_view_img.min())
+                            / (three_view_img.max() - three_view_img.min())
+                            * 255
+                        )
                     three_view_img = three_view_img.astype(np.uint8)
 
                 self.push_viz(
@@ -1454,29 +1504,32 @@ async def on_volume_acquired(self, embryo_id: str, timepoint: int,
                     uid=projection_uid,
                     data_type="volume_projection",
                     metadata={
-                        'embryo_id': embryo_id,
-                        'timepoint': timepoint,
-                        'shape': list(volume.shape),
-                        'projection_uid': projection_uid,
-                        'volume_uid': volume_uid,
-                        'projection_type': 'three_view',
-                    }
+                        "embryo_id": embryo_id,
+                        "timepoint": timepoint,
+                        "shape": list(volume.shape),
+                        "projection_uid": projection_uid,
+                        "volume_uid": volume_uid,
+                        "projection_type": "three_view",
+                    },
                 )
             except Exception as e:
                 logger.warning(f"Failed to push to viz: {e}")
 
-        self._emit_event(EventType.VOLUME_ACQUIRED, {
-            'embryo_id': embryo_id,
-            'timepoint': timepoint,
-            'volume_uid': volume_uid,
-            'projection_uid': projection_uid,
-            'volume_path': str(stored_path) if stored_path else None,
-            'shape': list(volume.shape),
-        })
+        self._emit_event(
+            EventType.VOLUME_ACQUIRED,
+            {
+                "embryo_id": embryo_id,
+                "timepoint": timepoint,
+                "volume_uid": volume_uid,
+                "projection_uid": projection_uid,
+                "volume_path": str(stored_path) if stored_path else None,
+                "shape": list(volume.shape),
+            },
+        )
 
         return {
-            'volume_uid': volume_uid,
-            'projection_uid': projection_uid,
+            "volume_uid": volume_uid,
+            "projection_uid": projection_uid,
         }
 
     def should_stop_experiment(self) -> bool:
@@ -1485,22 +1538,31 @@ def should_stop_experiment(self) -> bool:
             return False
         return all(e.should_skip for e in self.experiment.embryos.values())
 
-    def get_embryo_acquisition_order(self) -> List[str]:
+    def get_embryo_acquisition_order(self) -> list[str]:
         """Get embryo acquisition order based on priority."""
-        high = [e.id for e in self.experiment.embryos.values() if e.priority == "high" and not e.should_skip]
-        normal = [e.id for e in self.experiment.embryos.values() if e.priority == "normal" and not e.should_skip]
-        low = [e.id for e in self.experiment.embryos.values() if e.priority == "low" and not e.should_skip]
+        high = [
+            e.id
+            for e in self.experiment.embryos.values()
+            if e.priority == "high" and not e.should_skip
+        ]
+        normal = [
+            e.id
+            for e in self.experiment.embryos.values()
+            if e.priority == "normal" and not e.should_skip
+        ]
+        low = [
+            e.id
+            for e in self.experiment.embryos.values()
+            if e.priority == "low" and not e.should_skip
+        ]
         return high + normal + low
 
-    def decide_parameters(self, embryo_id: str, timepoint: int) -> Dict:
+    def decide_parameters(self, embryo_id: str, timepoint: int) -> dict:
         """Get current acquisition parameters for embryo."""
         embryo = self.experiment.embryos.get(embryo_id)
         if not embryo:
-            return {'num_slices': 50, 'exposure_ms': 10.0}
-        return {
-            'num_slices': embryo.num_slices,
-            'exposure_ms': embryo.exposure_ms
-        }
+            return {"num_slices": 50, "exposure_ms": 10.0}
+        return {"num_slices": embryo.num_slices, "exposure_ms": embryo.exposure_ms}
 
     def decide_next_interval(self, timepoint: int) -> float:
         """Decide interval until next timepoint."""
@@ -1525,8 +1587,9 @@ async def check_blank_image(
                 logger.warning(f"[BLANK_CHECK] {embryo_id}: Numerical check indicates blank image")
                 return True
 
-            import io
             import base64
+            import io
+
             from PIL import Image
 
             if max_proj.max() > 0:
@@ -1536,10 +1599,11 @@ async def check_blank_image(
 
             img = Image.fromarray(normalized)
             buffer = io.BytesIO()
-            img.save(buffer, format='PNG')
+            img.save(buffer, format="PNG")
             b64_image = base64.b64encode(buffer.getvalue()).decode()
 
-            prompt = """Look at this microscopy image. Is this a VALID microscopy image or a BLANK/CORRUPTED image?
+            prompt = """\
+Look at this microscopy image. Is this a VALID microscopy image or a BLANK/CORRUPTED image?
 
 A BLANK or CORRUPTED image shows:
 - Mostly uniform gray/black with no structure
@@ -1557,20 +1621,22 @@ async def check_blank_image(
                 self.claude.messages.create,
                 model=settings.models.fast,
                 max_tokens=10,
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "text", "text": prompt},
-                        {
-                            "type": "image",
-                            "source": {
-                                "type": "base64",
-                                "media_type": "image/png",
-                                "data": b64_image
-                            }
-                        }
-                    ]
-                }]
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {"type": "text", "text": prompt},
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/png",
+                                    "data": b64_image,
+                                },
+                            },
+                        ],
+                    }
+                ],
             )
 
             result = response.content[0].text.strip().upper()
@@ -1581,7 +1647,11 @@ async def check_blank_image(
 
             return is_blank
 
-        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
+        except (
+            anthropic.APIConnectionError,
+            anthropic.RateLimitError,
+            anthropic.APIStatusError,
+        ) as e:
             logger.error(f"[BLANK_CHECK] Claude API error for {embryo_id}: {e}")
             return False
         except Exception as e:
diff --git a/gently/app/detectors/hatching.py b/gently/app/detectors/hatching.py
index ca63acd3..6dc0705d 100644
--- a/gently/app/detectors/hatching.py
+++ b/gently/app/detectors/hatching.py
@@ -14,7 +14,7 @@
 import asyncio
 import logging
 import time
-from typing import Any, Dict, Optional
+from typing import Any
 
 import numpy as np
 
@@ -24,7 +24,9 @@
 logger = logging.getLogger(__name__)
 
 
-_HATCHING_PROMPT = """You are observing a C. elegans embryo on a microscope. Decide whether the embryo has HATCHED, then record your decision with the record_hatching tool.
+_HATCHING_PROMPT = """\
+You are observing a C. elegans embryo on a microscope. Decide whether the embryo has HATCHED,
+then record your decision with the record_hatching tool.
 
 A HATCHED embryo:
 - Has visibly broken out of the eggshell
@@ -69,19 +71,21 @@ class HatchingDetector(Detector):
 
     name = "hatching"
 
-    def __init__(self, claude_client=None, model: Optional[str] = None):
+    def __init__(self, claude_client=None, model: str | None = None):
         self._claude = claude_client
         self._model = model
 
     async def run(
         self,
         volume: np.ndarray,
-        context: Dict[str, Any],
+        context: dict[str, Any],
     ) -> DetectorResult:
-        from gently.settings import settings
         import json
+
         import anthropic
 
+        from gently.settings import settings
+
         embryo_id = context.get("embryo_id", "?")
         timepoint = int(context.get("timepoint", 0))
         start = time.time()
@@ -113,24 +117,28 @@ async def run(
                 max_tokens=256,
                 tools=[_HATCHING_TOOL],
                 tool_choice={"type": "tool", "name": _HATCHING_TOOL["name"]},
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "text", "text": _HATCHING_PROMPT},
-                        {"type": "image", "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": b64_image,
-                        }},
-                    ],
-                }],
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {"type": "text", "text": _HATCHING_PROMPT},
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/png",
+                                    "data": b64_image,
+                                },
+                            },
+                        ],
+                    }
+                ],
             )
 
             # Forced tool_choice guarantees a tool_use block; read its parsed
             # input directly. No regex, no JSON-from-prose fallback.
             tool_input = next(
-                (b.input for b in response.content
-                 if getattr(b, "type", None) == "tool_use"),
+                (b.input for b in response.content if getattr(b, "type", None) == "tool_use"),
                 None,
             )
 
@@ -156,7 +164,11 @@ async def run(
                 error=err,
             )
 
-        except (anthropic.APIConnectionError, anthropic.RateLimitError, anthropic.APIStatusError) as e:
+        except (
+            anthropic.APIConnectionError,
+            anthropic.RateLimitError,
+            anthropic.APIStatusError,
+        ) as e:
             logger.error("[%s] Claude API error for %s: %s", self.name, embryo_id, e)
             return DetectorResult(
                 detector_name=self.name,
diff --git a/gently/hardware/dispim/sam_detection.py b/gently/hardware/dispim/sam_detection.py
index 7014338a..45355438 100644
--- a/gently/hardware/dispim/sam_detection.py
+++ b/gently/hardware/dispim/sam_detection.py
@@ -5,30 +5,28 @@
 Returns embryo positions (pixel + stage coordinates) for calibration workflow.
 """
 
-import logging
-import time
+import base64
 import json
+import logging
+import os
 import uuid
-import numpy as np
+from io import BytesIO
 from pathlib import Path
+
+import anthropic
 import cv2
-import base64
-from io import BytesIO
+import numpy as np
 from PIL import Image
-import anthropic
-from typing import Dict, List, Tuple, Optional
-import os
-
-from gently.settings import settings
-
-logger = logging.getLogger(__name__)
 
 from gently.core.coordinates import (
-    pixel_to_stage_position,
-    get_um_per_pixel,
-    DEFAULT_PIXEL_SIZE_UM,
     DEFAULT_OBJECTIVE_MAG,
+    DEFAULT_PIXEL_SIZE_UM,
+    get_um_per_pixel,
+    pixel_to_stage_position,
 )
+from gently.settings import settings
+
+logger = logging.getLogger(__name__)
 
 
 class SAMEmbryoDetector:
@@ -42,11 +40,13 @@ class SAMEmbryoDetector:
     - Returns embryo positions as simple list of coordinates
     """
 
-    def __init__(self,
-                 sam_checkpoint: str = "sam_vit_b_01ec64.pth",
-                 sam_model_type: str = "vit_b",
-                 device: str = "cpu",
-                 anthropic_api_key: Optional[str] = None):
+    def __init__(
+        self,
+        sam_checkpoint: str = "sam_vit_b_01ec64.pth",
+        sam_model_type: str = "vit_b",
+        device: str = "cpu",
+        anthropic_api_key: str | None = None,
+    ):
         """
         Initialize SAM detector
 
@@ -85,7 +85,7 @@ def _load_sam(self):
         if self._mask_generator is not None:
             return
 
-        from segment_anything import sam_model_registry, SamAutomaticMaskGenerator, SamPredictor
+        from segment_anything import SamAutomaticMaskGenerator, SamPredictor, sam_model_registry
 
         if not Path(self.sam_checkpoint).exists():
             raise FileNotFoundError(f"SAM checkpoint not found: {self.sam_checkpoint}")
@@ -108,13 +108,15 @@ def _load_sam(self):
         self._predictor = SamPredictor(sam)
         logger.info("SAM model loaded")
 
-    def preprocess_image(self,
-                         image: np.ndarray,
-                         bg_kernel_size: int = 150,
-                         use_clahe: bool = True,
-                         clahe_clip_limit: float = 3.0,
-                         clahe_tile_size: int = 16,
-                         gaussian_sigma: float = 2.0) -> np.ndarray:
+    def preprocess_image(
+        self,
+        image: np.ndarray,
+        bg_kernel_size: int = 150,
+        use_clahe: bool = True,
+        clahe_clip_limit: float = 3.0,
+        clahe_tile_size: int = 16,
+        gaussian_sigma: float = 2.0,
+    ) -> np.ndarray:
         """
         Preprocess image for better SAM detection.
 
@@ -151,14 +153,18 @@ def preprocess_image(self,
         # This stretches the narrow range (e.g., 84-354) to full 0-255
         logger.debug("Percentile normalization (2-98%%)...")
         p2, p98 = np.percentile(image, (2, 98))
-        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(np.uint8)
+        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(
+            np.uint8
+        )
         logger.debug("Normalized to 0-255")
 
         # Step 2: Background subtraction with large morphological opening
         # Removes large-scale illumination variations
         if bg_kernel_size > 0:
             logger.debug("Background subtraction (kernel=%d)...", bg_kernel_size)
-            kernel_bg = cv2.getStructuringElement(cv2.MORPH_ELLIPSE, (bg_kernel_size, bg_kernel_size))
+            kernel_bg = cv2.getStructuringElement(
+                cv2.MORPH_ELLIPSE, (bg_kernel_size, bg_kernel_size)
+            )
             background = cv2.morphologyEx(img_norm, cv2.MORPH_OPEN, kernel_bg)
             img_no_bg = cv2.subtract(img_norm, background)
             img_no_bg = cv2.normalize(img_no_bg, None, 0, 255, cv2.NORM_MINMAX).astype(np.uint8)
@@ -171,8 +177,7 @@ def preprocess_image(self,
         if use_clahe:
             logger.debug("CLAHE (clip=%.1f, tile=%d)...", clahe_clip_limit, clahe_tile_size)
             clahe = cv2.createCLAHE(
-                clipLimit=clahe_clip_limit,
-                tileGridSize=(clahe_tile_size, clahe_tile_size)
+                clipLimit=clahe_clip_limit, tileGridSize=(clahe_tile_size, clahe_tile_size)
             )
             img_enhanced = clahe.apply(img_no_bg)
             logger.debug("CLAHE applied")
@@ -187,16 +192,20 @@ def preprocess_image(self,
         else:
             img_smooth = img_enhanced
 
-        logger.debug("Preprocessing complete (output range: %s - %s)", img_smooth.min(), img_smooth.max())
+        logger.debug(
+            "Preprocessing complete (output range: %s - %s)", img_smooth.min(), img_smooth.max()
+        )
         return img_smooth
 
-    def find_embryo_candidates(self,
-                               image: np.ndarray,
-                               brightness_percentile: float = 99.0,
-                               min_area: int = 5000,
-                               max_area: int = 150000,
-                               clahe_clip: float = 3.0,
-                               clahe_tile: int = 16) -> Tuple[List[Dict], np.ndarray]:
+    def find_embryo_candidates(
+        self,
+        image: np.ndarray,
+        brightness_percentile: float = 99.0,
+        min_area: int = 5000,
+        max_area: int = 150000,
+        clahe_clip: float = 3.0,
+        clahe_tile: int = 16,
+    ) -> tuple[list[dict], np.ndarray]:
         """
         Find embryo candidates using brightness-based detection.
 
@@ -229,12 +238,16 @@ def find_embryo_candidates(self,
         enhanced_image : np.ndarray
             Contrast-enhanced 8-bit image for SAM
         """
-        logger.info("Finding embryo candidates (brightness percentile=%.1f)...", brightness_percentile)
+        logger.info(
+            "Finding embryo candidates (brightness percentile=%.1f)...", brightness_percentile
+        )
         logger.debug("Input range: %s - %s", image.min(), image.max())
 
         # Step 1: Percentile normalization (handles low dynamic range)
         p2, p98 = np.percentile(image, (2, 98))
-        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(np.uint8)
+        img_norm = np.clip((image.astype(np.float32) - p2) / (p98 - p2) * 255, 0, 255).astype(
+            np.uint8
+        )
         logger.debug("Normalized to 0-255")
 
         # Step 2: CLAHE for local contrast enhancement
@@ -261,7 +274,9 @@ def find_embryo_candidates(self,
         logger.debug("Morphological cleanup complete")
 
         # Step 7: Find connected components and filter by area
-        num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(mask, connectivity=8)
+        num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(
+            mask, connectivity=8
+        )
 
         candidates = []
         for i in range(1, num_labels):  # Skip background (label 0)
@@ -273,19 +288,14 @@ def find_embryo_candidates(self,
                 h = stats[i, cv2.CC_STAT_HEIGHT]
                 cx, cy = centroids[i]
 
-                candidates.append({
-                    'bbox': (x, y, w, h),
-                    'centroid': (cx, cy),
-                    'area': area
-                })
+                candidates.append({"bbox": (x, y, w, h), "centroid": (cx, cy), "area": area})
 
         logger.info("Found %d embryo candidates", len(candidates))
         return candidates, img_smooth
 
-    def refine_with_sam(self,
-                        image: np.ndarray,
-                        candidates: List[Dict],
-                        padding: int = 20) -> List[Dict]:
+    def refine_with_sam(
+        self, image: np.ndarray, candidates: list[dict], padding: int = 20
+    ) -> list[dict]:
         """
         Refine embryo candidates using SAM with bounding box prompts.
 
@@ -322,7 +332,7 @@ def refine_with_sam(self,
         h, w = image.shape[:2]
 
         for i, candidate in enumerate(candidates):
-            x, y, bw, bh = candidate['bbox']
+            x, y, bw, bh = candidate["bbox"]
 
             # Add padding and clip to image bounds
             x1 = max(0, x - padding)
@@ -335,10 +345,7 @@ def refine_with_sam(self,
 
             # Get SAM prediction with box prompt
             masks, scores, _ = self._predictor.predict(
-                point_coords=None,
-                point_labels=None,
-                box=input_box,
-                multimask_output=True
+                point_coords=None, point_labels=None, box=input_box, multimask_output=True
             )
 
             # Take best mask (highest score)
@@ -348,9 +355,7 @@ def refine_with_sam(self,
 
             # Calculate properties from SAM mask
             contours, _ = cv2.findContours(
-                mask.astype(np.uint8),
-                cv2.RETR_EXTERNAL,
-                cv2.CHAIN_APPROX_SIMPLE
+                mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
             )
 
             if contours:
@@ -364,41 +369,47 @@ def refine_with_sam(self,
                     cx = M["m10"] / M["m00"]
                     cy = M["m01"] / M["m00"]
                 else:
-                    cx, cy = candidate['centroid']
+                    cx, cy = candidate["centroid"]
 
                 # Calculate circularity
                 perimeter = cv2.arcLength(contour, True)
-                circularity = 4 * np.pi * area / (perimeter ** 2) if perimeter > 0 else 0
+                circularity = 4 * np.pi * area / (perimeter**2) if perimeter > 0 else 0
 
                 # Get bounding box from contour
                 bx, by, bw, bh = cv2.boundingRect(contour)
 
-                embryos.append({
-                    'embryo_id': f'embryo_{i + 1}',
-                    'uid': str(uuid.uuid4()),  # Global unique identifier for cross-session tracking
-                    'pixel_x': float(cx),
-                    'pixel_y': float(cy),
-                    'bbox': (bx, by, bw, bh),  # Used by visualization functions
-                    'area_pixels': int(area),
-                    'circularity': float(circularity),
-                    'confidence': float(score),
-                    'mask': mask
-                })
+                embryos.append(
+                    {
+                        "embryo_id": f"embryo_{i + 1}",
+                        "uid": str(
+                            uuid.uuid4()
+                        ),  # Global unique identifier for cross-session tracking
+                        "pixel_x": float(cx),
+                        "pixel_y": float(cy),
+                        "bbox": (bx, by, bw, bh),  # Used by visualization functions
+                        "area_pixels": int(area),
+                        "circularity": float(circularity),
+                        "confidence": float(score),
+                        "mask": mask,
+                    }
+                )
 
         logger.info("SAM refined %d embryos", len(embryos))
         return embryos
 
-    async def detect_embryos(self,
-                            image: np.ndarray,
-                            stage_position: Tuple[float, float],
-                            pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
-                            objective_mag: float = DEFAULT_OBJECTIVE_MAG,
-                            use_claude_review: bool = True,
-                            save_visualizations: bool = True,
-                            output_dir: Optional[Path] = None,
-                            brightness_percentile: float = 99.0,
-                            min_area: int = 5000,
-                            max_area: int = 150000) -> Dict:
+    async def detect_embryos(
+        self,
+        image: np.ndarray,
+        stage_position: tuple[float, float],
+        pixel_size_um: float = DEFAULT_PIXEL_SIZE_UM,
+        objective_mag: float = DEFAULT_OBJECTIVE_MAG,
+        use_claude_review: bool = True,
+        save_visualizations: bool = True,
+        output_dir: Path | None = None,
+        brightness_percentile: float = 99.0,
+        min_area: int = 5000,
+        max_area: int = 150000,
+    ) -> dict:
         """
         Detect embryos using brightness-based detection + SAM refinement.
 
@@ -462,20 +473,17 @@ async def detect_embryos(self,
         # Step 1: Find candidates using brightness detection
         logger.info("[1/4] Finding embryo candidates (brightness-based)...")
         candidates, image_enhanced = self.find_embryo_candidates(
-            image,
-            brightness_percentile=brightness_percentile,
-            min_area=min_area,
-            max_area=max_area
+            image, brightness_percentile=brightness_percentile, min_area=min_area, max_area=max_area
         )
 
         if len(candidates) == 0:
             logger.warning("No embryo candidates found!")
             return {
-                'embryos': [],
-                'initial_detections': 0,
-                'final_detections': 0,
-                'verification': {'verified': False},
-                'images': {}
+                "embryos": [],
+                "initial_detections": 0,
+                "final_detections": 0,
+                "verification": {"verified": False},
+                "images": {},
             }
 
         # Step 2: Refine with SAM
@@ -489,11 +497,11 @@ async def detect_embryos(self,
         if len(embryos_sam) == 0:
             logger.warning("No embryos detected by SAM!")
             return {
-                'embryos': [],
-                'initial_detections': 0,
-                'final_detections': 0,
-                'verification': {'verified': False},
-                'images': {}
+                "embryos": [],
+                "initial_detections": 0,
+                "final_detections": 0,
+                "verification": {"verified": False},
+                "images": {},
             }
 
         # Save initial detection
@@ -503,8 +511,8 @@ async def detect_embryos(self,
 
         # Claude review (if enabled)
         embryos_final = embryos_sam
-        verification = {'verified': True, 'skipped': not use_claude_review}
-        changes = {'round1': {'removed': [], 'added': []}}
+        verification = {"verified": True, "skipped": not use_claude_review}
+        changes = {"round1": {"removed": [], "added": []}}
 
         if use_claude_review and self.claude_client:
             logger.info("[2/4] Claude Vision review (Round 1)...")
@@ -512,7 +520,7 @@ async def detect_embryos(self,
             review_r1 = await self._review_with_claude(image_8bit, annotated, embryos_sam)
 
             logger.info("[3/4] Applying corrections...")
-            embryos_r1, changes['round1'] = self._apply_corrections(
+            embryos_r1, changes["round1"] = self._apply_corrections(
                 embryos_sam, review_r1, image, self._predictor
             )
 
@@ -524,22 +532,22 @@ async def detect_embryos(self,
             logger.info("[4/4] Claude verification (Round 2)...")
             r1_viz = self._create_annotated_image(image_8bit, embryos_r1)
             verification = await self._verify_with_claude(
-                image_8bit, r1_viz, embryos_r1, changes['round1']
+                image_8bit, r1_viz, embryos_r1, changes["round1"]
             )
 
             # Apply round 2 corrections if needed
             has_r2_changes = (
-                len(verification.get('additional_false_positives', [])) > 0 or
-                len(verification.get('additional_false_negatives', [])) > 0
+                len(verification.get("additional_false_positives", [])) > 0
+                or len(verification.get("additional_false_negatives", [])) > 0
             )
 
             if has_r2_changes:
                 logger.info("Applying Round 2 corrections...")
                 review_r2 = {
-                    'false_positives': verification.get('additional_false_positives', []),
-                    'false_negatives': verification.get('additional_false_negatives', [])
+                    "false_positives": verification.get("additional_false_positives", []),
+                    "false_negatives": verification.get("additional_false_negatives", []),
                 }
-                embryos_final, changes['round2'] = self._apply_corrections(
+                embryos_final, changes["round2"] = self._apply_corrections(
                     embryos_r1, review_r2, image, self._predictor
                 )
             else:
@@ -553,7 +561,7 @@ async def detect_embryos(self,
             stage_position,
             pixel_size_um,
             objective_mag,
-            image_shape=image.shape[:2]  # (height, width)
+            image_shape=image.shape[:2],  # (height, width)
         )
 
         # Save final visualization
@@ -563,19 +571,19 @@ async def detect_embryos(self,
 
         # Package results
         results = {
-            'embryos': embryo_positions,
-            'initial_detections': len(embryos_sam),
-            'final_detections': len(embryos_final),
-            'verification': verification,
-            'changes': changes,
-            'images': {
-                'initial': str(output_dir / "detection_initial.png"),
-                'final': str(output_dir / "detection_final.png")
-            }
+            "embryos": embryo_positions,
+            "initial_detections": len(embryos_sam),
+            "final_detections": len(embryos_final),
+            "verification": verification,
+            "changes": changes,
+            "images": {
+                "initial": str(output_dir / "detection_initial.png"),
+                "final": str(output_dir / "detection_final.png"),
+            },
         }
 
         if use_claude_review and save_visualizations:
-            results['images']['round1'] = str(output_dir / "detection_round1.png")
+            results["images"]["round1"] = str(output_dir / "detection_round1.png")
 
         logger.info("=" * 70)
         logger.info("DETECTION COMPLETE: %d embryos", len(embryo_positions))
@@ -594,7 +602,7 @@ def _to_rgb8(image: np.ndarray) -> np.ndarray:
             return cv2.cvtColor(image, cv2.COLOR_GRAY2RGB)
         return image
 
-    def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
+    def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
         """Run SAM automatic segmentation (extracted from test script)"""
         image_rgb = self._to_rgb8(image)
 
@@ -604,14 +612,16 @@ def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
         # Filter candidates
         embryo_candidates = []
         for mask_data in masks:
-            area = mask_data['area']
+            area = mask_data["area"]
 
             if not (self.min_area <= area <= self.max_area):
                 continue
 
-            bbox = mask_data['bbox']
-            mask = mask_data['segmentation']
-            contours, _ = cv2.findContours(mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
+            bbox = mask_data["bbox"]
+            mask = mask_data["segmentation"]
+            contours, _ = cv2.findContours(
+                mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
+            )
 
             if len(contours) == 0:
                 continue
@@ -620,40 +630,44 @@ def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
             if perimeter == 0:
                 continue
 
-            circularity = 4 * np.pi * area / (perimeter ** 2)
+            circularity = 4 * np.pi * area / (perimeter**2)
 
             if circularity < self.min_circularity:
                 continue
 
-            embryo_candidates.append({
-                'mask': mask,
-                'bbox': bbox,
-                'area': area,
-                'circularity': circularity,
-                'stability_score': mask_data['stability_score'],
-                'predicted_iou': mask_data['predicted_iou']
-            })
+            embryo_candidates.append(
+                {
+                    "mask": mask,
+                    "bbox": bbox,
+                    "area": area,
+                    "circularity": circularity,
+                    "stability_score": mask_data["stability_score"],
+                    "predicted_iou": mask_data["predicted_iou"],
+                }
+            )
 
         # Sort by quality and apply spatial separation
-        embryo_candidates.sort(key=lambda x: (x['area'] * x['stability_score']), reverse=True)
+        embryo_candidates.sort(key=lambda x: x["area"] * x["stability_score"], reverse=True)
 
         selected_embryos = []
         for candidate in embryo_candidates:
             if len(selected_embryos) >= self.max_embryos:
                 break
 
-            bbox = candidate['bbox']
+            bbox = candidate["bbox"]
             candidate_center_x = bbox[0] + bbox[2] / 2
             candidate_center_y = bbox[1] + bbox[3] / 2
 
             too_close = False
             for selected in selected_embryos:
-                sel_bbox = selected['bbox']
+                sel_bbox = selected["bbox"]
                 sel_center_x = sel_bbox[0] + sel_bbox[2] / 2
                 sel_center_y = sel_bbox[1] + sel_bbox[3] / 2
 
-                distance = np.sqrt((candidate_center_x - sel_center_x)**2 +
-                                 (candidate_center_y - sel_center_y)**2)
+                distance = np.sqrt(
+                    (candidate_center_x - sel_center_x) ** 2
+                    + (candidate_center_y - sel_center_y) ** 2
+                )
 
                 if distance < self.min_separation_pixels:
                     too_close = True
@@ -662,19 +676,27 @@ def _detect_with_sam(self, image: np.ndarray) -> Tuple[List[Dict], np.ndarray]:
             if not too_close:
                 selected_embryos.append(candidate)
 
-        return selected_embryos, image_8bit
+        return selected_embryos, image_rgb
 
-    def _create_annotated_image(self, image: np.ndarray, embryos: List[Dict]) -> np.ndarray:
+    def _create_annotated_image(self, image: np.ndarray, embryos: list[dict]) -> np.ndarray:
         """Create annotated image with numbered boxes"""
         viz = image.copy()
         if len(viz.shape) == 2:
             viz = cv2.cvtColor(viz, cv2.COLOR_GRAY2RGB)
 
-        colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255), (255, 255, 0),
-                  (255, 0, 255), (0, 255, 255), (128, 128, 0), (128, 0, 128)]
+        colors = [
+            (255, 0, 0),
+            (0, 255, 0),
+            (0, 0, 255),
+            (255, 255, 0),
+            (255, 0, 255),
+            (0, 255, 255),
+            (128, 128, 0),
+            (128, 0, 128),
+        ]
 
         for i, embryo in enumerate(embryos):
-            bbox = embryo['bbox']
+            bbox = embryo["bbox"]
             x, y, w, h = bbox
             color = colors[i % len(colors)]
 
@@ -713,7 +735,7 @@ def _encode_image_base64(self, image: np.ndarray) -> str:
             buffered = BytesIO()
             pil_image.save(buffered, format="JPEG", quality=quality, optimize=True)
             if buffered.tell() <= max_bytes:
-                return base64.b64encode(buffered.getvalue()).decode('utf-8')
+                return base64.b64encode(buffered.getvalue()).decode("utf-8")
             quality -= 5
 
         # Last resort
@@ -722,18 +744,21 @@ def _encode_image_base64(self, image: np.ndarray) -> str:
         pil_image = pil_image.resize(new_size, Image.Resampling.LANCZOS)
         buffered = BytesIO()
         pil_image.save(buffered, format="JPEG", quality=85, optimize=True)
-        return base64.b64encode(buffered.getvalue()).decode('utf-8')
+        return base64.b64encode(buffered.getvalue()).decode("utf-8")
 
-    async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, embryos: List[Dict]) -> Dict:
+    async def _review_with_claude(
+        self, image: np.ndarray, annotated: np.ndarray, embryos: list[dict]
+    ) -> dict:
         """Round 1: Claude reviews detections (from test script)"""
         if not self.claude_client:
-            return {'false_positives': [], 'false_negatives': []}
+            return {"false_positives": [], "false_negatives": []}
 
         image_base64 = self._encode_image_base64(annotated)
 
-        prompt = f"""You are a microscopy expert analyzing embryo detections from a bottom camera view.
+        prompt = f"""\
+You are a microscopy expert analyzing embryo detections from a bottom camera view.
 
-CURRENT DETECTIONS: {len(embryos)} embryos labeled 0-{len(embryos)-1} with colored bounding boxes.
+CURRENT DETECTIONS: {len(embryos)} embryos labeled 0-{len(embryos) - 1} with colored bounding boxes.
 
 EMBRYO CHARACTERISTICS:
 - Small, BRIGHT white/light gray oval or rice grain shapes
@@ -763,14 +788,25 @@ async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, em
             message = self.claude_client.messages.create(
                 model=settings.models.perception,
                 max_tokens=8000,
-                output_config={"effort": "high"},  # was thinking budget_tokens (Opus 4.8 rejects it)
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_base64}},
-                        {"type": "text", "text": prompt}
-                    ]
-                }]
+                output_config={
+                    "effort": "high"
+                },  # was thinking budget_tokens (Opus 4.8 rejects it)
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/jpeg",
+                                    "data": image_base64,
+                                },
+                            },
+                            {"type": "text", "text": prompt},
+                        ],
+                    }
+                ],
             )
 
             response_text = next((b.text for b in message.content if b.type == "text"), "")
@@ -787,18 +823,19 @@ async def _review_with_claude(self, image: np.ndarray, annotated: np.ndarray, em
 
         except Exception as e:
             logger.warning("Claude review failed: %s", e)
-            return {'false_positives': [], 'false_negatives': []}
+            return {"false_positives": [], "false_negatives": []}
 
-    async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
-                                  embryos: List[Dict], previous_changes: Dict) -> Dict:
+    async def _verify_with_claude(
+        self, image: np.ndarray, annotated: np.ndarray, embryos: list[dict], previous_changes: dict
+    ) -> dict:
         """Round 2: Claude verifies corrections (from test script)"""
         if not self.claude_client:
-            return {'verified': True, 'skipped': True}
+            return {"verified": True, "skipped": True}
 
         image_base64 = self._encode_image_base64(annotated)
 
-        removed = previous_changes.get('removed', [])
-        added = previous_changes.get('added', [])
+        removed = previous_changes.get("removed", [])
+        added = previous_changes.get("added", [])
 
         prompt = f"""VERIFICATION ROUND - You previously reviewed this image.
 
@@ -806,7 +843,7 @@ async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
 - Removed: {removed if removed else "none"}
 - Added: {added if added else "none"}
 
-CURRENT: {len(embryos)} detections (numbered 0-{len(embryos)-1})
+CURRENT: {len(embryos)} detections (numbered 0-{len(embryos) - 1})
 
 TASK: Verify corrections and catch any remaining issues.
 Only report CLEAR remaining problems.
@@ -823,14 +860,25 @@ async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
             message = self.claude_client.messages.create(
                 model=settings.models.perception,
                 max_tokens=6000,
-                output_config={"effort": "high"},  # was thinking budget_tokens (Opus 4.8 rejects it)
-                messages=[{
-                    "role": "user",
-                    "content": [
-                        {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_base64}},
-                        {"type": "text", "text": prompt}
-                    ]
-                }]
+                output_config={
+                    "effort": "high"
+                },  # was thinking budget_tokens (Opus 4.8 rejects it)
+                messages=[
+                    {
+                        "role": "user",
+                        "content": [
+                            {
+                                "type": "image",
+                                "source": {
+                                    "type": "base64",
+                                    "media_type": "image/jpeg",
+                                    "data": image_base64,
+                                },
+                            },
+                            {"type": "text", "text": prompt},
+                        ],
+                    }
+                ],
             )
 
             response_text = next((b.text for b in message.content if b.type == "text"), "")
@@ -846,38 +894,41 @@ async def _verify_with_claude(self, image: np.ndarray, annotated: np.ndarray,
 
         except Exception as e:
             logger.warning("Verification failed: %s", e)
-            return {'verified': False}
+            return {"verified": False}
 
-    def _apply_corrections(self, embryos: List[Dict], review: Dict,
-                          image: np.ndarray, predictor) -> Tuple[List[Dict], Dict]:
+    def _apply_corrections(
+        self, embryos: list[dict], review: dict, image: np.ndarray, predictor
+    ) -> tuple[list[dict], dict]:
         """Apply Claude's corrections (from test script)"""
         corrected = []
-        changes = {'removed': [], 'added': []}
+        changes = {"removed": [], "added": []}
 
         # Remove false positives
-        false_positives = set(review.get('false_positives', []))
+        false_positives = set(review.get("false_positives", []))
         if false_positives:
-            changes['removed'] = list(false_positives)
+            changes["removed"] = list(false_positives)
 
         for i, embryo in enumerate(embryos):
             if i not in false_positives:
                 corrected.append(embryo)
 
         # Add false negatives
-        false_negatives = review.get('false_negatives', [])
+        false_negatives = review.get("false_negatives", [])
         if false_negatives:
             for fn in false_negatives:
-                point = (fn['x'], fn['y'])
+                point = (fn["x"], fn["y"])
                 new_embryo = self._segment_with_sam(image, predictor, point)
 
-                if new_embryo and (self.min_area <= new_embryo['area'] <= self.max_area and
-                                   new_embryo['circularity'] >= self.min_circularity):
+                if new_embryo and (
+                    self.min_area <= new_embryo["area"] <= self.max_area
+                    and new_embryo["circularity"] >= self.min_circularity
+                ):
                     corrected.append(new_embryo)
-                    changes['added'].append(point)
+                    changes["added"].append(point)
 
         return corrected, changes
 
-    def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optional[Dict]:
+    def _segment_with_sam(self, image: np.ndarray, predictor, point: tuple) -> dict | None:
         """Use SAM predictor to segment region (from test script)"""
         image_rgb = self._to_rgb8(image)
         predictor.set_image(image_rgb)
@@ -886,9 +937,7 @@ def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optio
         point_labels = np.array([1])
 
         masks, scores, _ = predictor.predict(
-            point_coords=point_coords,
-            point_labels=point_labels,
-            multimask_output=True
+            point_coords=point_coords, point_labels=point_labels, multimask_output=True
         )
 
         best_idx = np.argmax(scores)
@@ -903,26 +952,33 @@ def _segment_with_sam(self, image: np.ndarray, predictor, point: Tuple) -> Optio
         bbox = [x_min, y_min, x_max - x_min, y_max - y_min]
 
         area = mask.sum()
-        contours, _ = cv2.findContours(mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
+        contours, _ = cv2.findContours(
+            mask.astype(np.uint8), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE
+        )
 
         if len(contours) > 0:
             perimeter = cv2.arcLength(contours[0], True)
-            circularity = 4 * np.pi * area / (perimeter ** 2) if perimeter > 0 else 0
+            circularity = 4 * np.pi * area / (perimeter**2) if perimeter > 0 else 0
         else:
             circularity = 0
 
         return {
-            'mask': mask,
-            'bbox': bbox,
-            'area': int(area),
-            'circularity': float(circularity),
-            'stability_score': float(scores[best_idx]),
-            'predicted_iou': float(scores[best_idx])
+            "mask": mask,
+            "bbox": bbox,
+            "area": int(area),
+            "circularity": float(circularity),
+            "stability_score": float(scores[best_idx]),
+            "predicted_iou": float(scores[best_idx]),
         }
 
-    def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[float, float],
-                                    pixel_size_um: float, objective_mag: float,
-                                    image_shape: Tuple[int, int] = (2048, 2048)) -> List[Dict]:
+    def _pixel_to_stage_coordinates(
+        self,
+        embryos: list[dict],
+        stage_pos: tuple[float, float],
+        pixel_size_um: float,
+        objective_mag: float,
+        image_shape: tuple[int, int] = (2048, 2048),
+    ) -> list[dict]:
         """
         Convert pixel coordinates to stage coordinates.
 
@@ -938,7 +994,7 @@ def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[floa
 
         embryo_positions = []
         for i, embryo in enumerate(embryos):
-            bbox = embryo['bbox']
+            bbox = embryo["bbox"]
             x, y, w, h = bbox
 
             center_x_px = x + w / 2
@@ -953,24 +1009,26 @@ def _pixel_to_stage_coordinates(self, embryos: List[Dict], stage_pos: Tuple[floa
                 image_center_y=image_center_y,
                 stage_x=stage_x,
                 stage_y=stage_y,
-                um_per_pixel=effective_pixel_um
+                um_per_pixel=effective_pixel_um,
             )
 
-            embryo_positions.append({
-                'embryo_id': f'embryo_{i + 1}',
-                'pixel_x': float(center_x_px),
-                'pixel_y': float(center_y_px),
-                'stage_x_um': float(embryo_stage_x),
-                'stage_y_um': float(embryo_stage_y),
-                'bbox_pixel': tuple(bbox),
-                'area_pixels': embryo.get('area_pixels', embryo.get('area', 0)),
-                'circularity': embryo.get('circularity', 0),
-                'confidence': embryo.get('confidence', embryo.get('stability_score', 0))
-            })
+            embryo_positions.append(
+                {
+                    "embryo_id": f"embryo_{i + 1}",
+                    "pixel_x": float(center_x_px),
+                    "pixel_y": float(center_y_px),
+                    "stage_x_um": float(embryo_stage_x),
+                    "stage_y_um": float(embryo_stage_y),
+                    "bbox_pixel": tuple(bbox),
+                    "area_pixels": embryo.get("area_pixels", embryo.get("area", 0)),
+                    "circularity": embryo.get("circularity", 0),
+                    "confidence": embryo.get("confidence", embryo.get("stability_score", 0)),
+                }
+            )
 
         return embryo_positions
 
-    def show_in_napari(self, image: np.ndarray, embryos: List[Dict], block: bool = False):
+    def show_in_napari(self, image: np.ndarray, embryos: list[dict], block: bool = False):
         """Deprecated: napari display was retired in Phase 1.
 
         SAM detection results are now reviewed via the web map view —
diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 29573e6a..9085e96b 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -10,14 +10,14 @@
 import logging
 import re
 import time
-from typing import Dict, List, Optional, Any
+from typing import Any
 
 from ..settings import settings
 
 logger = logging.getLogger(__name__)
 
 
-def _extend_tool_calls(out: List[Dict[str, Any]], content_blocks) -> None:
+def _extend_tool_calls(out: list[dict[str, Any]], content_blocks) -> None:
     """Append every tool_use block in content_blocks to out.
 
     Tolerates absent attributes (some SDK versions / mock objects) so it
@@ -29,11 +29,13 @@ def _extend_tool_calls(out: List[Dict[str, Any]], content_blocks) -> None:
         try:
             if getattr(block, "type", None) != "tool_use":
                 continue
-            out.append({
-                "name": getattr(block, "name", None),
-                "input": getattr(block, "input", None),
-                "id": getattr(block, "id", None),
-            })
+            out.append(
+                {
+                    "name": getattr(block, "name", None),
+                    "input": getattr(block, "input", None),
+                    "id": getattr(block, "id", None),
+                }
+            )
         except Exception:
             continue
 
@@ -55,7 +57,7 @@ def __init__(self, client, model, tool_registry):
         self._tool_registry = tool_registry
 
         # Conversation state
-        self.conversation_history: List[Dict] = []
+        self.conversation_history: list[dict] = []
 
         # Token counters
         self.total_input_tokens: int = 0
@@ -76,8 +78,9 @@ def __init__(self, client, model, tool_registry):
 
     # ===== Quick Response =====
 
-    def try_quick_response(self, message: str, experiment, mode: str,
-                           enter_plan_fn, exit_plan_fn) -> Optional[str]:
+    def try_quick_response(
+        self, message: str, experiment, mode: str, enter_plan_fn, exit_plan_fn
+    ) -> str | None:
         """
         Answer simple queries from state without LLM call.
 
@@ -106,7 +109,13 @@ def try_quick_response(self, message: str, experiment, mode: str,
             return experiment.get_summary()
 
         # Plan mode switching via natural language
-        plan_enter_phrases = ("plan mode", "enter plan", "switch to plan", "let's plan", "design an experiment")
+        plan_enter_phrases = (
+            "plan mode",
+            "enter plan",
+            "switch to plan",
+            "let's plan",
+            "design an experiment",
+        )
         plan_exit_phrases = ("exit plan", "leave plan", "back to run", "run mode")
 
         if mode != "plan" and any(p in message_lower for p in plan_enter_phrases):
@@ -142,22 +151,25 @@ def should_use_thinking(self, message: str, mode: str) -> bool:
         if mode == "plan":
             return True
 
-        import re
         msg_lower = message.lower()
 
-        if re.search(r'\bthink(ing)?\b', message, re.IGNORECASE):
+        if re.search(r"\bthink(ing)?\b", message, re.IGNORECASE):
             return True
-        if re.search(r'\bcalibrat', msg_lower):
+        if re.search(r"\bcalibrat", msg_lower):
             return True
-        if re.search(r'\b(plan|timelapse|time-lapse|acquisition)\b', msg_lower):
+        if re.search(r"\b(plan|timelapse|time-lapse|acquisition)\b", msg_lower):
             return True
-        if re.search(r'\b(analy[sz]e|look at|check|inspect|review).*(image|volume|embryo)', msg_lower):
+        if re.search(
+            r"\b(analy[sz]e|look at|check|inspect|review).*(image|volume|embryo)", msg_lower
+        ):
             return True
-        if re.search(r'\b(all|every|each)\s+(embryo|sample)', msg_lower):
+        if re.search(r"\b(all|every|each)\s+(embryo|sample)", msg_lower):
             return True
-        if re.search(r'\b(first|then|after|next|finally)\b.*\b(first|then|after|next|finally)\b', msg_lower):
+        if re.search(
+            r"\b(first|then|after|next|finally)\b.*\b(first|then|after|next|finally)\b", msg_lower
+        ):
             return True
-        if re.search(r'\b(why|problem|issue|error|wrong|fail|debug|troubleshoot)', msg_lower):
+        if re.search(r"\b(why|problem|issue|error|wrong|fail|debug|troubleshoot)", msg_lower):
             return True
 
         return False
@@ -172,6 +184,7 @@ async def _create_with_refusal_fallback(self, api_kwargs):
         working whether or not Fable 5 is currently serviceable. The moment the
         org retention is fixed, Fable 5 serves with no code change."""
         from anthropic import BadRequestError
+
         fb = settings.models.refusal_fallback
         model = api_kwargs.get("model")
         try:
@@ -180,7 +193,9 @@ async def _create_with_refusal_fallback(self, api_kwargs):
             if not fb or fb == model:
                 raise
             logger.warning("Model %s rejected the request (400); falling back to %s", model, fb)
-            return await self._call_api_with_retry(self.claude.messages.create, **{**api_kwargs, "model": fb})
+            return await self._call_api_with_retry(
+                self.claude.messages.create, **{**api_kwargs, "model": fb}
+            )
         if response.stop_reason == "refusal" and fb and fb != model:
             logger.warning("Model %s declined the turn; retrying on %s", model, fb)
             response = await self._call_api_with_retry(
@@ -188,8 +203,9 @@ async def _create_with_refusal_fallback(self, api_kwargs):
             )
         return response
 
-    async def call_claude(self, user_message: str, system_prompt, tools,
-                          mode: str, auto_save_fn) -> str:
+    async def call_claude(
+        self, user_message: str, system_prompt, tools, mode: str, auto_save_fn
+    ) -> str:
         """
         Call Claude API with full context and tool access (non-streaming).
 
@@ -221,8 +237,8 @@ async def call_claude(self, user_message: str, system_prompt, tools,
             interaction = self.interaction_logger.start_interaction(
                 user_prompt=user_message,
                 system_state={
-                    'acquisition_status': 'unknown',
-                }
+                    "acquisition_status": "unknown",
+                },
             )
 
         # Snapshot inputs for decision capture BEFORE the tool loop starts
@@ -233,13 +249,15 @@ async def call_claude(self, user_message: str, system_prompt, tools,
         if self.decision_log is not None:
             try:
                 from gently.eval import prompt_hash as _prompt_hash
+
                 decision_prompt_hash = _prompt_hash(
-                    system_prompt, list(self.conversation_history),
+                    system_prompt,
+                    list(self.conversation_history),
                 )
             except Exception:
                 logger.exception("Failed to compute decision prompt_hash")
 
-        tool_calls_collected: List[Dict[str, Any]] = []
+        tool_calls_collected: list[dict[str, Any]] = []
         assistant_message = ""
         error_occurred = None
 
@@ -262,18 +280,10 @@ async def call_claude(self, user_message: str, system_prompt, tools,
 
             # Process tool calls
             while response.stop_reason == "tool_use":
-                tool_results = await self._execute_tools_with_logging(
-                    response.content, interaction
-                )
+                tool_results = await self._execute_tools_with_logging(response.content, interaction)
 
-                self.conversation_history.append({
-                    "role": "assistant",
-                    "content": response.content
-                })
-                self.conversation_history.append({
-                    "role": "user",
-                    "content": tool_results
-                })
+                self.conversation_history.append({"role": "assistant", "content": response.content})
+                self.conversation_history.append({"role": "user", "content": tool_results})
 
                 api_kwargs["messages"] = self.conversation_history
                 response = await self._create_with_refusal_fallback(api_kwargs)
@@ -283,20 +293,20 @@ async def call_claude(self, user_message: str, system_prompt, tools,
             # Extract text response. Fable 5 may refuse (stop_reason="refusal")
             # with empty content — surface it instead of returning blank.
             if response.stop_reason == "refusal":
-                assistant_message = "(The request was declined by the model's safety system. Try rephrasing.)"
+                assistant_message = (
+                    "(The request was declined by the model's safety system. Try rephrasing.)"
+                )
             else:
                 assistant_message = ""
                 for block in response.content:
-                    if hasattr(block, 'text'):
+                    if hasattr(block, "text"):
                         assistant_message += block.text
 
-            self.conversation_history.append({
-                "role": "assistant",
-                "content": response.content
-            })
+            self.conversation_history.append({"role": "assistant", "content": response.content})
 
         except Exception as e:
             import traceback
+
             error_occurred = str(e)
             error_tb = traceback.format_exc()
             assistant_message = f"Error: {error_occurred}"
@@ -343,11 +353,11 @@ def _write_production_decision(
         self,
         *,
         user_message: str,
-        tool_calls: List[Dict[str, Any]],
+        tool_calls: list[dict[str, Any]],
         response_text: str,
         duration_ms: float,
-        prompt_hash_value: Optional[str],
-        error: Optional[str],
+        prompt_hash_value: str | None,
+        error: str | None,
     ) -> None:
         """Persist one production Decision row (best-effort).
 
@@ -359,24 +369,28 @@ def _write_production_decision(
             return
         try:
             from datetime import datetime
+
             from gently.eval import Decision, DecisionTrigger
-            self.decision_log.append(Decision(
-                timestamp=datetime.now(),
-                agent="production",
-                trigger=DecisionTrigger.USER_MESSAGE,
-                trigger_detail=(user_message or "")[:200],
-                tool_calls=tool_calls,
-                response_text=response_text,
-                prompt_hash=prompt_hash_value,
-                duration_ms=duration_ms,
-                error=error,
-            ))
+
+            self.decision_log.append(
+                Decision(
+                    timestamp=datetime.now(),
+                    agent="production",
+                    trigger=DecisionTrigger.USER_MESSAGE,
+                    trigger_detail=(user_message or "")[:200],
+                    tool_calls=tool_calls,
+                    response_text=response_text,
+                    prompt_hash=prompt_hash_value,
+                    duration_ms=duration_ms,
+                    error=error,
+                )
+            )
         except Exception:
             logger.exception("Failed to write production Decision")
 
     # ===== Dry-Run Tool Call (Benchmarking) =====
 
-    async def get_tool_call(self, user_message: str, system_prompt, tools) -> Optional[Dict]:
+    async def get_tool_call(self, user_message: str, system_prompt, tools) -> dict | None:
         """
         Get what tool Claude would call without executing it (dry-run mode).
 
@@ -399,10 +413,7 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> Option
         start_time = time.time()
 
         messages = self.conversation_history.copy()
-        messages.append({
-            "role": "user",
-            "content": user_message
-        })
+        messages.append({"role": "user", "content": user_message})
 
         try:
             api_kwargs = {
@@ -413,15 +424,12 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> Option
                 "max_tokens": 4096,
             }
 
-            response = await self._call_api_with_retry(
-                self.claude.messages.create,
-                **api_kwargs
-            )
+            response = await self._call_api_with_retry(self.claude.messages.create, **api_kwargs)
 
             latency_ms = (time.time() - start_time) * 1000
 
-            input_tokens = getattr(response.usage, 'input_tokens', 0)
-            output_tokens = getattr(response.usage, 'output_tokens', 0)
+            input_tokens = getattr(response.usage, "input_tokens", 0)
+            output_tokens = getattr(response.usage, "output_tokens", 0)
 
             # A refusal returns empty content — treat as "no tool call".
             if response.stop_reason == "refusal" or not response.content:
@@ -444,7 +452,7 @@ async def get_tool_call(self, user_message: str, system_prompt, tools) -> Option
 
     # ===== Tool Execution =====
 
-    async def _execute_tools_with_logging(self, content_blocks, interaction) -> List[Dict]:
+    async def _execute_tools_with_logging(self, content_blocks, interaction) -> list[dict]:
         """
         Execute Claude's tool calls with interaction logging.
 
@@ -476,7 +484,10 @@ async def _execute_tools_with_logging(self, content_blocks, interaction) -> List
                     if self.choice_handler and isinstance(result, str):
                         try:
                             choice_data = json.loads(result)
-                            if isinstance(choice_data, dict) and choice_data.get("_type") == CHOICE_RESPONSE_TYPE:
+                            if (
+                                isinstance(choice_data, dict)
+                                and choice_data.get("_type") == CHOICE_RESPONSE_TYPE
+                            ):
                                 user_selection = await self.choice_handler(choice_data)
                                 result = user_selection
                         except (json.JSONDecodeError, TypeError):
@@ -500,19 +511,20 @@ async def _execute_tools_with_logging(self, content_blocks, interaction) -> List
                         error_message=error_message,
                     )
 
-                results.append({
-                    "type": "tool_result",
-                    "tool_use_id": block.id,
-                    "content": result,
-                    "is_error": is_error,
-                })
+                results.append(
+                    {
+                        "type": "tool_result",
+                        "tool_use_id": block.id,
+                        "content": result,
+                        "is_error": is_error,
+                    }
+                )
 
         return results
 
     # ===== Streaming API Call =====
 
-    async def call_claude_stream(self, system_prompt, tools,
-                                 tool_label_fn, auto_save_fn):
+    async def call_claude_stream(self, system_prompt, tools, tool_label_fn, auto_save_fn):
         """
         Call Claude API with streaming enabled.
 
@@ -542,11 +554,12 @@ def _run(m):
                     system=system_prompt,
                     messages=self.conversation_history,
                     tools=tools,
-                    max_tokens=4096
+                    max_tokens=4096,
                 ) as stream:
                     for event in stream:
                         events.append(event)
                     return events, stream.get_final_message()
+
             try:
                 return _run(model)
             except BadRequestError:
@@ -555,7 +568,9 @@ def _run(m):
                 fb = settings.models.refusal_fallback
                 if not fb or fb == model:
                     raise
-                logger.warning("Stream model %s rejected the request (400); falling back to %s", model, fb)
+                logger.warning(
+                    "Stream model %s rejected the request (400); falling back to %s", model, fb
+                )
                 return _run(fb)
 
         # Run streaming in thread with retry logic
@@ -568,15 +583,24 @@ def _run(m):
                 self._track_token_usage(final_message)
                 break
             except APIStatusError as e:
-                error_type = getattr(e, 'body', {})
+                error_type = getattr(e, "body", {})
                 if isinstance(error_type, dict):
-                    error_type = error_type.get('error', {}).get('type', '')
+                    error_type = error_type.get("error", {}).get("type", "")
 
-                if error_type in ('overloaded_error', 'rate_limit_error') or 'overloaded' in str(e).lower():
+                if (
+                    error_type in ("overloaded_error", "rate_limit_error")
+                    or "overloaded" in str(e).lower()
+                ):
                     if attempt < max_retries - 1:
-                        wait_time = retry_delay * (2 ** attempt)
-                        logger.warning(f"API overloaded, retrying in {wait_time:.1f}s (attempt {attempt + 1}/{max_retries})")
-                        yield {'type': 'text', 'text': f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n"}
+                        wait_time = retry_delay * (2**attempt)
+                        logger.warning(
+                            f"API overloaded, retrying in {wait_time:.1f}s "
+                            f"(attempt {attempt + 1}/{max_retries})"
+                        )
+                        yield {
+                            "type": "text",
+                            "text": f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n",
+                        }
                         await asyncio.sleep(wait_time)
                         continue
                 raise
@@ -596,34 +620,41 @@ def _run(m):
         # discard any partial, don't iterate empty content or process tools.
         if final_message.stop_reason == "refusal":
             logger.warning("Claude declined the request (model=%s)", self.model)
-            yield {'type': 'text', 'text': "(The request was declined by the model's safety system. Try rephrasing.)"}
+            yield {
+                "type": "text",
+                "text": "(The request was declined by the model's safety system. Try rephrasing.)",
+            }
             return
 
         # Diagnostic: per-response counts. DEBUG, not WARNING — stop_reason=tool_use
         # with matching tool blocks is normal; the genuine anomaly is the
         # logger.error below (tool blocks present but stop_reason != tool_use).
         tool_block_count = sum(
-            1 for b in final_message.content
-            if hasattr(b, 'type') and b.type == 'tool_use'
+            1 for b in final_message.content if hasattr(b, "type") and b.type == "tool_use"
         )
         logger.debug(
-            "Claude response: stop_reason=%s, content_blocks=%d, tool_use_blocks=%d, tools_passed=%d, model=%s",
-            final_message.stop_reason, len(final_message.content),
-            tool_block_count, len(tools), self.model,
+            "Claude response: stop_reason=%s, content_blocks=%d, "
+            "tool_use_blocks=%d, tools_passed=%d, model=%s",
+            final_message.stop_reason,
+            len(final_message.content),
+            tool_block_count,
+            len(tools),
+            self.model,
         )
         if tool_block_count > 0 and final_message.stop_reason != "tool_use":
             logger.error(
                 "BUG: Claude returned %d tool_use blocks but stop_reason=%s (expected 'tool_use')",
-                tool_block_count, final_message.stop_reason,
+                tool_block_count,
+                final_message.stop_reason,
             )
 
         # Process events and yield text
         full_text = []
         for event in events:
             if event.type == "content_block_delta":
-                if hasattr(event.delta, 'text'):
+                if hasattr(event.delta, "text"):
                     full_text.append(event.delta.text)
-                    yield {'type': 'text', 'text': event.delta.text}
+                    yield {"type": "text", "text": event.delta.text}
 
         # Detect fake XML tool calls in text (Claude writing tool_use as text)
         joined_text = "".join(full_text)
@@ -631,7 +662,8 @@ def _run(m):
             logger.error(
                 "DETECTED: Claude wrote XML tool tags as plain text instead of "
                 "using API tool_use mechanism. stop_reason=%s, text_preview=%.200s",
-                final_message.stop_reason, joined_text[:200],
+                final_message.stop_reason,
+                joined_text[:200],
             )
 
         response_content = final_message.content
@@ -645,14 +677,14 @@ def _run(m):
 
             tool_results = []
             for block in response_content:
-                if hasattr(block, 'type') and block.type == "tool_use":
+                if hasattr(block, "type") and block.type == "tool_use":
                     start_time = time.time()
 
                     yield {
-                        'type': 'tool_start',
-                        'tool_name': block.name,
-                        'tool_input': block.input,
-                        'tool_label': tool_label_fn(block.name, block.input),
+                        "type": "tool_start",
+                        "tool_name": block.name,
+                        "tool_input": block.input,
+                        "tool_label": tool_label_fn(block.name, block.input),
                     }
 
                     is_error_flag = False
@@ -663,31 +695,37 @@ def _run(m):
                         if isinstance(tool_result, str):
                             try:
                                 from gently.app.tools.interaction_tools import CHOICE_RESPONSE_TYPE
+
                                 choice_data = json.loads(tool_result)
-                                if isinstance(choice_data, dict) and choice_data.get("_type") == CHOICE_RESPONSE_TYPE:
+                                if (
+                                    isinstance(choice_data, dict)
+                                    and choice_data.get("_type") == CHOICE_RESPONSE_TYPE
+                                ):
                                     user_selection = yield {
-                                        'type': 'choice_request',
-                                        'choice_data': choice_data
+                                        "type": "choice_request",
+                                        "choice_data": choice_data,
                                     }
                                     tool_result = user_selection or "cancelled"
                             except (json.JSONDecodeError, TypeError):
                                 pass
 
-                        result_text = tool_result if isinstance(tool_result, str) else str(tool_result)
-                        tool_results.append({
-                            "type": "tool_result",
-                            "tool_use_id": block.id,
-                            "content": tool_result
-                        })
+                        result_text = (
+                            tool_result if isinstance(tool_result, str) else str(tool_result)
+                        )
+                        tool_results.append(
+                            {"type": "tool_result", "tool_use_id": block.id, "content": tool_result}
+                        )
                     except Exception as e:
                         is_error_flag = True
                         result_text = f"Error: {str(e)}"
-                        tool_results.append({
-                            "type": "tool_result",
-                            "tool_use_id": block.id,
-                            "content": result_text,
-                            "is_error": True
-                        })
+                        tool_results.append(
+                            {
+                                "type": "tool_result",
+                                "tool_use_id": block.id,
+                                "content": result_text,
+                                "is_error": True,
+                            }
+                        )
 
                     # First non-empty line of the result, trimmed — gives the chat
                     # UI a one-line summary so the operator can see what a tool did
@@ -700,22 +738,16 @@ def _run(m):
                         result_summary = result_summary[:139] + "…"
 
                     yield {
-                        'type': 'tool_call',
-                        'tool_name': block.name,
-                        'tool_input': block.input,
-                        'duration': time.time() - start_time,
-                        'result_summary': result_summary,
-                        'is_error': is_error_flag,
+                        "type": "tool_call",
+                        "tool_name": block.name,
+                        "tool_input": block.input,
+                        "duration": time.time() - start_time,
+                        "result_summary": result_summary,
+                        "is_error": is_error_flag,
                     }
 
-            self.conversation_history.append({
-                "role": "assistant",
-                "content": response_content
-            })
-            self.conversation_history.append({
-                "role": "user",
-                "content": tool_results
-            })
+            self.conversation_history.append({"role": "assistant", "content": response_content})
+            self.conversation_history.append({"role": "user", "content": tool_results})
 
             auto_save_fn()
 
@@ -737,15 +769,12 @@ def _run(m):
 
         else:
             # No tool calls - add final message to history
-            self.conversation_history.append({
-                "role": "assistant",
-                "content": response_content
-            })
+            self.conversation_history.append({"role": "assistant", "content": response_content})
             auto_save_fn()
 
     # ===== Tool Label =====
 
-    def tool_label(self, tool_name: str, tool_input: Dict) -> str:
+    def tool_label(self, tool_name: str, tool_input: dict) -> str:
         """Build a human-readable label for a tool call.
 
         Used in tool_start chunks so the TUI shows biologist-friendly
@@ -759,8 +788,13 @@ def tool_label(self, tool_name: str, tool_input: Dict) -> str:
             campaign = self.context_store.get_campaign(campaign_id)
             if campaign:
                 campaign_label = campaign.shorthand or campaign.description
-                if tool_name in ("propose_plan", "get_plan_status", "export_plan",
-                                 "snapshot_plan", "list_plan_versions"):
+                if tool_name in (
+                    "propose_plan",
+                    "get_plan_status",
+                    "export_plan",
+                    "snapshot_plan",
+                    "list_plan_versions",
+                ):
                     return campaign_label
                 if tool_name == "create_campaign" and inp.get("parent_id"):
                     return f"phase under {campaign_label}"
@@ -778,8 +812,12 @@ def tool_label(self, tool_name: str, tool_input: Dict) -> str:
 
         # Item reference tools
         item_ref = inp.get("item_ref") or inp.get("ref") or inp.get("item_id")
-        if item_ref and tool_name in ("get_plan_item", "update_plan_item",
-                                       "delete_plan_item", "move_plan_item"):
+        if item_ref and tool_name in (
+            "get_plan_item",
+            "update_plan_item",
+            "delete_plan_item",
+            "move_plan_item",
+        ):
             if self.context_store:
                 item = self.context_store.resolve_plan_item(str(item_ref), campaign_id=campaign_id)
                 if item:
@@ -806,8 +844,9 @@ def tool_label(self, tool_name: str, tool_input: Dict) -> str:
 
         return ""
 
-    async def _execute_single_tool(self, tool_name: str, tool_input: Dict,
-                                   context: Optional[Dict] = None) -> str:
+    async def _execute_single_tool(
+        self, tool_name: str, tool_input: dict, context: dict | None = None
+    ) -> str:
         """Execute a single tool call using the tool registry.
 
         Parameters
@@ -827,13 +866,13 @@ async def _execute_single_tool(self, tool_name: str, tool_input: Dict,
 
     def _track_token_usage(self, response):
         """Track token usage from API response, including cache metrics."""
-        if hasattr(response, 'usage'):
+        if hasattr(response, "usage"):
             usage = response.usage
             self.total_input_tokens += usage.input_tokens
             self.total_output_tokens += usage.output_tokens
             self.api_call_count += 1
-            self.cache_creation_tokens += getattr(usage, 'cache_creation_input_tokens', 0)
-            self.cache_read_tokens += getattr(usage, 'cache_read_input_tokens', 0)
+            self.cache_creation_tokens += getattr(usage, "cache_creation_input_tokens", 0)
+            self.cache_read_tokens += getattr(usage, "cache_read_input_tokens", 0)
 
     @property
     def current_context_tokens(self) -> int:
@@ -844,14 +883,14 @@ def current_context_tokens(self) -> int:
 
         conv_chars = 0
         for msg in self.conversation_history:
-            content = msg.get('content', '')
+            content = msg.get("content", "")
             if isinstance(content, str):
                 conv_chars += len(content)
             elif isinstance(content, list):
                 for block in content:
                     if isinstance(block, dict):
-                        conv_chars += len(str(block.get('text', '')))
-                    elif hasattr(block, 'text'):
+                        conv_chars += len(str(block.get("text", "")))
+                    elif hasattr(block, "text"):
                         conv_chars += len(str(block.text))
                     else:
                         conv_chars += len(str(block))
@@ -917,19 +956,22 @@ async def _call_api_with_retry(self, api_func, *args, max_retries=3, **kwargs):
             try:
                 return await asyncio.to_thread(api_func, *args, **kwargs)
             except APIStatusError as e:
-                error_type = getattr(e, 'body', {})
+                error_type = getattr(e, "body", {})
                 if isinstance(error_type, dict):
-                    error_type = error_type.get('error', {}).get('type', '')
+                    error_type = error_type.get("error", {}).get("type", "")
 
                 is_retryable = (
-                    error_type in ('overloaded_error', 'rate_limit_error') or
-                    'overloaded' in str(e).lower() or
-                    'rate_limit' in str(e).lower()
+                    error_type in ("overloaded_error", "rate_limit_error")
+                    or "overloaded" in str(e).lower()
+                    or "rate_limit" in str(e).lower()
                 )
 
                 if is_retryable and attempt < max_retries - 1:
-                    wait_time = retry_delay * (2 ** attempt)
-                    logger.warning(f"API error ({error_type}), retrying in {wait_time:.1f}s (attempt {attempt + 1}/{max_retries})")
+                    wait_time = retry_delay * (2**attempt)
+                    logger.warning(
+                        f"API error ({error_type}), retrying in {wait_time:.1f}s "
+                        f"(attempt {attempt + 1}/{max_retries})"
+                    )
                     await asyncio.sleep(wait_time)
                     continue
 
diff --git a/gently/harness/detection/verifier.py b/gently/harness/detection/verifier.py
index 849fbdbf..1a714bcd 100644
--- a/gently/harness/detection/verifier.py
+++ b/gently/harness/detection/verifier.py
@@ -14,14 +14,15 @@
 import logging
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any
 
 import anthropic
 
+from gently.core import EventType, get_event_bus
 from gently.settings import settings
-from .detector import Detector, DetectionResult, ConfidenceLevel
+
 from ..state import EmbryoState
-from gently.core import EventType, get_event_bus
+from .detector import ConfidenceLevel, DetectionResult, Detector
 
 logger = logging.getLogger(__name__)
 
@@ -38,12 +39,22 @@
 # many independent votes rather than introspected by one call.
 _ADVERSARIAL_TOOL = {
     "name": "record_adversarial_review",
-    "description": "Record the critical review verdict: whether counter-evidence against the detection was found.",
+    "description": (
+        "Record the critical review verdict: whether counter-evidence "
+        "against the detection was found."
+    ),
     "input_schema": {
         "type": "object",
         "properties": {
-            "found_counter_evidence": {"type": "boolean", "description": "True only if there is real evidence the detection is wrong."},
-            "concerns": {"type": "array", "items": {"type": "string"}, "description": "Specific doubts or alternative explanations; empty list if none."},
+            "found_counter_evidence": {
+                "type": "boolean",
+                "description": "True only if there is real evidence the detection is wrong.",
+            },
+            "concerns": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Specific doubts or alternative explanations; empty list if none.",
+            },
         },
         "required": ["found_counter_evidence", "concerns"],
     },
@@ -51,12 +62,20 @@
 
 _INDEPENDENT_TOOL = {
     "name": "record_independent_assessment",
-    "description": "Record an unbiased fresh assessment of whether the event occurred in this image.",
+    "description": (
+        "Record an unbiased fresh assessment of whether the event occurred in this image."
+    ),
     "input_schema": {
         "type": "object",
         "properties": {
-            "detected": {"type": "boolean", "description": "True if the event is observed in this image."},
-            "key_evidence": {"type": "string", "description": "What specifically supports the conclusion."},
+            "detected": {
+                "type": "boolean",
+                "description": "True if the event is observed in this image.",
+            },
+            "key_evidence": {
+                "type": "string",
+                "description": "What specifically supports the conclusion.",
+            },
         },
         "required": ["detected", "key_evidence"],
     },
@@ -64,12 +83,23 @@
 
 _TEMPORAL_TOOL = {
     "name": "record_temporal_comparison",
-    "description": "Record whether a real change consistent with the event occurred between the previous and current frames.",
+    "description": (
+        "Record whether a real change consistent with the event occurred "
+        "between the previous and current frames."
+    ),
     "input_schema": {
         "type": "object",
         "properties": {
-            "change_detected": {"type": "boolean", "description": "True if a clear change consistent with the event is visible across frames."},
-            "description": {"type": "string", "description": "The specific change observed between previous and current frames."},
+            "change_detected": {
+                "type": "boolean",
+                "description": (
+                    "True if a clear change consistent with the event is visible across frames."
+                ),
+            },
+            "description": {
+                "type": "string",
+                "description": "The specific change observed between previous and current frames.",
+            },
         },
         "required": ["change_detected", "description"],
     },
@@ -81,8 +111,18 @@
     "input_schema": {
         "type": "object",
         "properties": {
-            "suspicious": {"type": "boolean", "description": "True if hardware errors could have affected image quality or positioning for this embryo."},
-            "concerns": {"type": "array", "items": {"type": "string"}, "description": "Specific hardware concerns; empty list if none."},
+            "suspicious": {
+                "type": "boolean",
+                "description": (
+                    "True if hardware errors could have affected image quality "
+                    "or positioning for this embryo."
+                ),
+            },
+            "concerns": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Specific hardware concerns; empty list if none.",
+            },
             "reasoning": {"type": "string", "description": "Brief explanation of the analysis."},
         },
         "required": ["suspicious", "concerns", "reasoning"],
@@ -90,7 +130,7 @@
 }
 
 
-def _tool_input(response) -> Optional[Dict[str, Any]]:
+def _tool_input(response) -> dict[str, Any] | None:
     """Return the parsed input of the first tool_use block, or None."""
     for block in getattr(response, "content", None) or []:
         if getattr(block, "type", None) == "tool_use":
@@ -101,14 +141,16 @@ def _tool_input(response) -> Optional[Dict[str, Any]]:
 @dataclass
 class AdversarialResult:
     """Result of adversarial verification strategy"""
+
     found_counter_evidence: bool
-    concerns: List[str]
+    concerns: list[str]
     raw_response: str
 
 
 @dataclass
 class IndependentResult:
     """Result of independent verification strategy"""
+
     detected: bool
     key_evidence: str
     raw_response: str
@@ -117,6 +159,7 @@ class IndependentResult:
 @dataclass
 class TemporalResult:
     """Result of temporal comparison strategy"""
+
     change_detected: bool
     description: str
     raw_response: str
@@ -125,19 +168,21 @@ class TemporalResult:
 @dataclass
 class EnsembleResult:
     """Result of ensemble voting strategy"""
+
     votes_yes: int
     votes_no: int
     total_votes: int
     agreement_ratio: float  # votes_yes / total_votes if detected, votes_no / total_votes if not
     consensus_detected: bool  # True if >70% agree on YES
-    raw_responses: List[str] = field(default_factory=list)
+    raw_responses: list[str] = field(default_factory=list)
 
 
 @dataclass
 class HardwareContextResult:
     """Result of hardware context analysis strategy"""
+
     suspicious: bool  # True if hardware errors could have caused false positive
-    concerns: List[str]  # Specific concerns identified
+    concerns: list[str]  # Specific concerns identified
     reasoning: str
     raw_response: str
 
@@ -145,15 +190,16 @@ class HardwareContextResult:
 @dataclass
 class VerificationResult:
     """Combined result of all verification strategies"""
+
     original_detected: bool
-    original_confidence: Optional[ConfidenceLevel]
+    original_confidence: ConfidenceLevel | None
 
     # Strategy results
     adversarial: AdversarialResult
     independent: IndependentResult
     temporal: TemporalResult
-    ensemble: Optional[EnsembleResult] = None  # Only for hatching detection
-    hardware_context: Optional[HardwareContextResult] = None  # Only when errors present
+    ensemble: EnsembleResult | None = None  # Only for hatching detection
+    hardware_context: HardwareContextResult | None = None  # Only when errors present
 
     # Consensus
     consensus: bool = False
@@ -163,41 +209,43 @@ class VerificationResult:
     timestamp: datetime = field(default_factory=datetime.now)
     verification_duration_seconds: float = 0.0
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         """Serialize to dictionary"""
         result = {
-            'original_detected': self.original_detected,
-            'original_confidence': self.original_confidence.value if self.original_confidence else None,
-            'adversarial': {
-                'found_counter_evidence': self.adversarial.found_counter_evidence,
-                'concerns': self.adversarial.concerns,
+            "original_detected": self.original_detected,
+            "original_confidence": self.original_confidence.value
+            if self.original_confidence
+            else None,
+            "adversarial": {
+                "found_counter_evidence": self.adversarial.found_counter_evidence,
+                "concerns": self.adversarial.concerns,
             },
-            'independent': {
-                'detected': self.independent.detected,
-                'key_evidence': self.independent.key_evidence,
+            "independent": {
+                "detected": self.independent.detected,
+                "key_evidence": self.independent.key_evidence,
             },
-            'temporal': {
-                'change_detected': self.temporal.change_detected,
-                'description': self.temporal.description,
+            "temporal": {
+                "change_detected": self.temporal.change_detected,
+                "description": self.temporal.description,
             },
-            'consensus': self.consensus,
-            'consensus_reasoning': self.consensus_reasoning,
-            'timestamp': self.timestamp.isoformat(),
-            'verification_duration_seconds': self.verification_duration_seconds,
+            "consensus": self.consensus,
+            "consensus_reasoning": self.consensus_reasoning,
+            "timestamp": self.timestamp.isoformat(),
+            "verification_duration_seconds": self.verification_duration_seconds,
         }
         if self.ensemble:
-            result['ensemble'] = {
-                'votes_yes': self.ensemble.votes_yes,
-                'votes_no': self.ensemble.votes_no,
-                'total_votes': self.ensemble.total_votes,
-                'agreement_ratio': self.ensemble.agreement_ratio,
-                'consensus_detected': self.ensemble.consensus_detected,
+            result["ensemble"] = {
+                "votes_yes": self.ensemble.votes_yes,
+                "votes_no": self.ensemble.votes_no,
+                "total_votes": self.ensemble.total_votes,
+                "agreement_ratio": self.ensemble.agreement_ratio,
+                "consensus_detected": self.ensemble.consensus_detected,
             }
         if self.hardware_context:
-            result['hardware_context'] = {
-                'suspicious': self.hardware_context.suspicious,
-                'concerns': self.hardware_context.concerns,
-                'reasoning': self.hardware_context.reasoning,
+            result["hardware_context"] = {
+                "suspicious": self.hardware_context.suspicious,
+                "concerns": self.hardware_context.concerns,
+                "reasoning": self.hardware_context.reasoning,
             }
         return result
 
@@ -242,7 +290,7 @@ def __init__(
         self.ensemble_threshold = ensemble_threshold
         self._event_bus = event_bus or get_event_bus()
 
-    def _emit_event(self, event_type: EventType, data: Dict):
+    def _emit_event(self, event_type: EventType, data: dict):
         """Emit event to viz server"""
         if self._event_bus:
             self._event_bus.publish(event_type, data)
@@ -276,19 +324,13 @@ async def verify(
         start_time = datetime.now()
 
         # Run all strategies in parallel for speed
-        adversarial_task = self._run_adversarial(
-            detector, embryo_state, original_result, timepoint
-        )
-        independent_task = self._run_independent(
-            detector, embryo_state, timepoint
-        )
-        temporal_task = self._run_temporal_check(
-            detector, embryo_state, timepoint
-        )
+        adversarial_task = self._run_adversarial(detector, embryo_state, original_result, timepoint)
+        independent_task = self._run_independent(detector, embryo_state, timepoint)
+        temporal_task = self._run_temporal_check(detector, embryo_state, timepoint)
 
         # For hatching detection, also run ensemble voting
         ensemble_result = None
-        if detector.name == 'hatching':
+        if detector.name == "hatching":
             ensemble_task = self._run_ensemble_hatching(embryo_state)
             adversarial, independent, temporal, ensemble_result = await asyncio.gather(
                 adversarial_task, independent_task, temporal_task, ensemble_task
@@ -320,7 +362,11 @@ async def verify(
         logger.info(
             f"Verification complete for {detector.name}: "
             f"consensus={consensus}, duration={duration:.2f}s"
-            + (f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES" if ensemble_result else "")
+            + (
+                f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES"
+                if ensemble_result
+                else ""
+            )
         )
 
         return result
@@ -359,21 +405,15 @@ async def verify_with_context(
         start_time = datetime.now()
 
         # Run all strategies in parallel for speed
-        adversarial_task = self._run_adversarial(
-            detector, embryo_state, original_result, timepoint
-        )
-        independent_task = self._run_independent(
-            detector, embryo_state, timepoint
-        )
-        temporal_task = self._run_temporal_check(
-            detector, embryo_state, timepoint
-        )
+        adversarial_task = self._run_adversarial(detector, embryo_state, original_result, timepoint)
+        independent_task = self._run_independent(detector, embryo_state, timepoint)
+        temporal_task = self._run_temporal_check(detector, embryo_state, timepoint)
 
         # For hatching detection, also run ensemble voting
         ensemble_result = None
         hardware_result = None
 
-        if detector.name == 'hatching':
+        if detector.name == "hatching":
             ensemble_task = self._run_ensemble_hatching(embryo_state)
 
             # Run hardware context analysis if there are errors
@@ -381,7 +421,13 @@ async def verify_with_context(
                 hardware_task = self._run_hardware_context_analysis(
                     global_error_context, embryo_state.id
                 )
-                adversarial, independent, temporal, ensemble_result, hardware_result = await asyncio.gather(
+                (
+                    adversarial,
+                    independent,
+                    temporal,
+                    ensemble_result,
+                    hardware_result,
+                ) = await asyncio.gather(
                     adversarial_task, independent_task, temporal_task, ensemble_task, hardware_task
                 )
             else:
@@ -400,84 +446,133 @@ async def verify_with_context(
 
         # Adversarial result
         strategies_complete += 1
-        self._emit_event(EventType.VERIFICATION_STRATEGY, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'strategy': 'adversarial',
-            'passed': not adversarial.found_counter_evidence,
-            'summary': f"Counter-evidence: {'YES - ' + ', '.join(adversarial.concerns) if adversarial.found_counter_evidence else 'None found'}",
-        })
-        self._emit_event(EventType.VERIFICATION_PROGRESS, {
-            'embryo_id': embryo_id,
-            'strategies_complete': strategies_complete,
-            'total_strategies': total_strategies,
-        })
+        adversarial_summary = (
+            "YES - " + ", ".join(adversarial.concerns)
+            if adversarial.found_counter_evidence
+            else "None found"
+        )
+        self._emit_event(
+            EventType.VERIFICATION_STRATEGY,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "strategy": "adversarial",
+                "passed": not adversarial.found_counter_evidence,
+                "summary": f"Counter-evidence: {adversarial_summary}",
+            },
+        )
+        self._emit_event(
+            EventType.VERIFICATION_PROGRESS,
+            {
+                "embryo_id": embryo_id,
+                "strategies_complete": strategies_complete,
+                "total_strategies": total_strategies,
+            },
+        )
 
         # Independent result
         strategies_complete += 1
-        self._emit_event(EventType.VERIFICATION_STRATEGY, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'strategy': 'independent',
-            'passed': independent.detected,
-            'summary': f"Independent detection: {'YES' if independent.detected else 'NO'} - {independent.key_evidence}",
-        })
-        self._emit_event(EventType.VERIFICATION_PROGRESS, {
-            'embryo_id': embryo_id,
-            'strategies_complete': strategies_complete,
-            'total_strategies': total_strategies,
-        })
+        self._emit_event(
+            EventType.VERIFICATION_STRATEGY,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "strategy": "independent",
+                "passed": independent.detected,
+                "summary": (
+                    f"Independent detection: {'YES' if independent.detected else 'NO'}"
+                    f" - {independent.key_evidence}"
+                ),
+            },
+        )
+        self._emit_event(
+            EventType.VERIFICATION_PROGRESS,
+            {
+                "embryo_id": embryo_id,
+                "strategies_complete": strategies_complete,
+                "total_strategies": total_strategies,
+            },
+        )
 
         # Temporal result
         strategies_complete += 1
-        self._emit_event(EventType.VERIFICATION_STRATEGY, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'strategy': 'temporal',
-            'passed': temporal.change_detected,
-            'summary': f"Change detected: {'YES' if temporal.change_detected else 'NO'} - {temporal.description}",
-        })
-        self._emit_event(EventType.VERIFICATION_PROGRESS, {
-            'embryo_id': embryo_id,
-            'strategies_complete': strategies_complete,
-            'total_strategies': total_strategies,
-        })
+        self._emit_event(
+            EventType.VERIFICATION_STRATEGY,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "strategy": "temporal",
+                "passed": temporal.change_detected,
+                "summary": (
+                    f"Change detected: {'YES' if temporal.change_detected else 'NO'}"
+                    f" - {temporal.description}"
+                ),
+            },
+        )
+        self._emit_event(
+            EventType.VERIFICATION_PROGRESS,
+            {
+                "embryo_id": embryo_id,
+                "strategies_complete": strategies_complete,
+                "total_strategies": total_strategies,
+            },
+        )
 
         # Ensemble result (if applicable)
         if ensemble_result:
             strategies_complete += 1
-            self._emit_event(EventType.VERIFICATION_STRATEGY, {
-                'embryo_id': embryo_id,
-                'detector_name': detector.name,
-                'strategy': 'ensemble',
-                'passed': ensemble_result.consensus_detected,
-                'summary': f"Ensemble vote: {ensemble_result.votes_yes}/{ensemble_result.total_votes} YES ({ensemble_result.agreement_ratio*100:.0f}%)",
-                'votes_yes': ensemble_result.votes_yes,
-                'votes_no': ensemble_result.votes_no,
-                'total_votes': ensemble_result.total_votes,
-            })
-            self._emit_event(EventType.VERIFICATION_PROGRESS, {
-                'embryo_id': embryo_id,
-                'strategies_complete': strategies_complete,
-                'total_strategies': total_strategies,
-            })
+            self._emit_event(
+                EventType.VERIFICATION_STRATEGY,
+                {
+                    "embryo_id": embryo_id,
+                    "detector_name": detector.name,
+                    "strategy": "ensemble",
+                    "passed": ensemble_result.consensus_detected,
+                    "summary": (
+                        f"Ensemble vote: {ensemble_result.votes_yes}/{ensemble_result.total_votes}"
+                        f" YES ({ensemble_result.agreement_ratio * 100:.0f}%)"
+                    ),
+                    "votes_yes": ensemble_result.votes_yes,
+                    "votes_no": ensemble_result.votes_no,
+                    "total_votes": ensemble_result.total_votes,
+                },
+            )
+            self._emit_event(
+                EventType.VERIFICATION_PROGRESS,
+                {
+                    "embryo_id": embryo_id,
+                    "strategies_complete": strategies_complete,
+                    "total_strategies": total_strategies,
+                },
+            )
 
         # Hardware context result (if applicable)
         if hardware_result:
             strategies_complete += 1
-            self._emit_event(EventType.VERIFICATION_STRATEGY, {
-                'embryo_id': embryo_id,
-                'detector_name': detector.name,
-                'strategy': 'hardware_context',
-                'passed': not hardware_result.suspicious,
-                'summary': f"Hardware errors suspicious: {'YES - ' + ', '.join(hardware_result.concerns) if hardware_result.suspicious else 'No'}",
-                'reasoning': hardware_result.reasoning,
-            })
-            self._emit_event(EventType.VERIFICATION_PROGRESS, {
-                'embryo_id': embryo_id,
-                'strategies_complete': strategies_complete,
-                'total_strategies': total_strategies,
-            })
+            hardware_summary = (
+                "YES - " + ", ".join(hardware_result.concerns)
+                if hardware_result.suspicious
+                else "No"
+            )
+            self._emit_event(
+                EventType.VERIFICATION_STRATEGY,
+                {
+                    "embryo_id": embryo_id,
+                    "detector_name": detector.name,
+                    "strategy": "hardware_context",
+                    "passed": not hardware_result.suspicious,
+                    "summary": f"Hardware errors suspicious: {hardware_summary}",
+                    "reasoning": hardware_result.reasoning,
+                },
+            )
+            self._emit_event(
+                EventType.VERIFICATION_PROGRESS,
+                {
+                    "embryo_id": embryo_id,
+                    "strategies_complete": strategies_complete,
+                    "total_strategies": total_strategies,
+                },
+            )
 
         # Determine consensus (with hardware context)
         consensus, reasoning = self._evaluate_consensus_with_hardware(
@@ -502,26 +597,37 @@ async def verify_with_context(
         logger.info(
             f"Verification (with context) complete for {detector.name}: "
             f"consensus={consensus}, duration={duration:.2f}s"
-            + (f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES" if ensemble_result else "")
+            + (
+                f", ensemble={ensemble_result.votes_yes}/{ensemble_result.total_votes} YES"
+                if ensemble_result
+                else ""
+            )
             + (f", hardware_suspicious={hardware_result.suspicious}" if hardware_result else "")
         )
 
         # Emit VERIFICATION_COMPLETED event with full summary
-        self._emit_event(EventType.VERIFICATION_COMPLETED, {
-            'embryo_id': embryo_id,
-            'detector_name': detector.name,
-            'consensus': consensus,
-            'reasoning': reasoning,
-            'duration_seconds': duration,
-            'strategies': {
-                'adversarial': not adversarial.found_counter_evidence,
-                'independent': independent.detected,
-                'temporal': temporal.change_detected,
-                'ensemble': ensemble_result.consensus_detected if ensemble_result else None,
-                'hardware_context': (not hardware_result.suspicious) if hardware_result else None,
+        self._emit_event(
+            EventType.VERIFICATION_COMPLETED,
+            {
+                "embryo_id": embryo_id,
+                "detector_name": detector.name,
+                "consensus": consensus,
+                "reasoning": reasoning,
+                "duration_seconds": duration,
+                "strategies": {
+                    "adversarial": not adversarial.found_counter_evidence,
+                    "independent": independent.detected,
+                    "temporal": temporal.change_detected,
+                    "ensemble": ensemble_result.consensus_detected if ensemble_result else None,
+                    "hardware_context": (not hardware_result.suspicious)
+                    if hardware_result
+                    else None,
+                },
+                "ensemble_votes": f"{ensemble_result.votes_yes}/{ensemble_result.total_votes}"
+                if ensemble_result
+                else None,
             },
-            'ensemble_votes': f"{ensemble_result.votes_yes}/{ensemble_result.total_votes}" if ensemble_result else None,
-        })
+        )
 
         return result
 
@@ -549,7 +655,8 @@ async def _run_hardware_context_analysis(
             Analysis result
         """
         try:
-            prompt = f"""You are analyzing hardware error context for a microscopy detection verification.
+            prompt = f"""\
+You are analyzing hardware error context for a microscopy detection verification.
 
 GLOBAL ERROR LOG:
 {global_error_context}
@@ -562,10 +669,12 @@ async def _run_hardware_context_analysis(
 - Stage positioning errors could cause wrong embryo to be imaged
 - Acquisition timeouts could cause partial/blank images (blank images look like empty FOV = hatched)
 - Camera errors could produce corrupted data
-- Errors on OTHER embryos in the same round could indicate systemic issues (stage drift, hardware instability)
+- Errors on OTHER embryos in the same round could indicate systemic issues
+  (stage drift, hardware instability)
 - Multiple errors in quick succession suggests hardware problems
 
-If ANY errors occurred that could have affected the image quality or positioning for {embryo_id}, mark it suspicious.
+If ANY errors occurred that could have affected the image quality or positioning
+for {embryo_id}, mark it suspicious.
 
 Record your analysis with the record_hardware_context tool.
 """
@@ -576,7 +685,7 @@ async def _run_hardware_context_analysis(
                 max_tokens=300,
                 tools=[_HARDWARE_CONTEXT_TOOL],
                 tool_choice={"type": "tool", "name": _HARDWARE_CONTEXT_TOOL["name"]},
-                messages=[{"role": "user", "content": prompt}]
+                messages=[{"role": "user", "content": prompt}],
             )
 
             data = _tool_input(response)
@@ -605,8 +714,8 @@ def _evaluate_consensus_with_hardware(
         adversarial: AdversarialResult,
         independent: IndependentResult,
         temporal: TemporalResult,
-        ensemble: Optional[EnsembleResult] = None,
-        hardware_context: Optional[HardwareContextResult] = None,
+        ensemble: EnsembleResult | None = None,
+        hardware_context: HardwareContextResult | None = None,
     ) -> tuple[bool, str]:
         """
         Evaluate consensus across all verification strategies including hardware context.
@@ -622,7 +731,9 @@ def _evaluate_consensus_with_hardware(
         if not adversarial.found_counter_evidence:
             agreements += 1
         else:
-            disagreements.append(f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}")
+            disagreements.append(
+                f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}"
+            )
 
         # Check independent: should also detect
         if independent.detected:
@@ -662,12 +773,19 @@ def _evaluate_consensus_with_hardware(
         consensus = agreements == total_strategies
 
         if consensus:
-            parts = ["no counter-evidence found", "independent analysis confirms", "temporal change observed"]
+            parts = [
+                "no counter-evidence found",
+                "independent analysis confirms",
+                "temporal change observed",
+            ]
             if ensemble:
                 parts.append(f"ensemble confirms ({ensemble.votes_yes}/{ensemble.total_votes} YES)")
             if hardware_context:
                 parts.append("no hardware error concerns")
-            reasoning = f"All verification strategies agree ({total_strategies}/{total_strategies}): " + ", ".join(parts)
+            reasoning = (
+                f"All verification strategies agree ({total_strategies}/{total_strategies}): "
+                + ", ".join(parts)
+            )
         else:
             reasoning = (
                 f"Verification disagreement ({agreements}/{total_strategies} agree): "
@@ -700,7 +818,7 @@ async def _run_adversarial(
                 )
 
             # Build detector-specific critical review guidance
-            if detector.name == 'hatching':
+            if detector.name == "hatching":
                 specific_guidance = """
 For HATCHING specifically, look for these common FALSE POSITIVE patterns:
 - Is the worm still COILED/PRETZEL-SHAPED inside the eggshell?
@@ -713,10 +831,11 @@ async def _run_adversarial(
             else:
                 specific_guidance = ""
 
-            prompt = f"""You are reviewing a detection result for a C. elegans embryo (diSPIM max projection).
+            prompt = f"""\
+You are reviewing a detection result for a C. elegans embryo (diSPIM max projection).
 
 The system detected: {detector.name}
-Original reasoning: {original_result.reasoning or 'not provided'}
+Original reasoning: {original_result.reasoning or "not provided"}
 
 NOW ACT AS A CRITICAL REVIEWER. Your job is to find reasons why this detection might be INCORRECT:
 - Could this be a false positive?
@@ -735,7 +854,7 @@ async def _run_adversarial(
                 max_tokens=500,
                 tools=[_ADVERSARIAL_TOOL],
                 tool_choice={"type": "tool", "name": _ADVERSARIAL_TOOL["name"]},
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             data = _tool_input(response)
@@ -779,7 +898,7 @@ async def _run_independent(
                 )
 
             # Build detector-specific criteria
-            if detector.name == 'hatching':
+            if detector.name == "hatching":
                 criteria = """
 TRUE HATCHING criteria (must meet at least one):
 - Worm body is OUTSIDE the eggshell boundary (free-floating, elongated)
@@ -793,7 +912,8 @@ async def _run_independent(
                 criteria = detector.description
 
             # Use a neutral prompt that doesn't reveal the previous detection
-            prompt = f"""Analyze this C. elegans embryo image (diSPIM max projection) at timepoint {timepoint}.
+            prompt = f"""\
+Analyze this C. elegans embryo image (diSPIM max projection) at timepoint {timepoint}.
 
 Question: Has '{detector.name}' occurred in this embryo?
 
@@ -813,7 +933,7 @@ async def _run_independent(
                 max_tokens=400,
                 tools=[_INDEPENDENT_TOOL],
                 tool_choice={"type": "tool", "name": _INDEPENDENT_TOOL["name"]},
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             data = _tool_input(response)
@@ -861,14 +981,16 @@ async def _run_temporal_check(
             prev_images = []
             for img in embryo_state.recent_images[-3:-1]:
                 if img.max_projection_b64:
-                    prev_images.append({
-                        "type": "image",
-                        "source": {
-                            "type": "base64",
-                            "media_type": "image/png",
-                            "data": img.max_projection_b64,
+                    prev_images.append(
+                        {
+                            "type": "image",
+                            "source": {
+                                "type": "base64",
+                                "media_type": "image/png",
+                                "data": img.max_projection_b64,
+                            },
                         }
-                    })
+                    )
 
             if not prev_images:
                 return TemporalResult(
@@ -878,7 +1000,7 @@ async def _run_temporal_check(
                 )
 
             # Build detector-specific temporal criteria
-            if detector.name == 'hatching':
+            if detector.name == "hatching":
                 temporal_criteria = """For HATCHING, look for:
 - A visible BREACH appearing in the eggshell boundary (not just expansion)
 - The worm physically EXITING the shell (part of body moves outside)
@@ -890,10 +1012,11 @@ async def _run_temporal_check(
 - Not just a static state that could have existed before
 - Clear evidence of progression or event occurrence"""
 
-            prompt = f"""Compare these sequential timepoints of a C. elegans embryo (diSPIM max projection).
+            prompt = f"""\
+Compare these sequential timepoints of a C. elegans embryo (diSPIM max projection).
 
 PREVIOUS TIMEPOINTS (shown first):
-These are from t={timepoint-2} to t={timepoint-1}
+These are from t={timepoint - 2} to t={timepoint - 1}
 
 CURRENT TIMEPOINT (shown last):
 This is t={timepoint}
@@ -914,7 +1037,7 @@ async def _run_temporal_check(
                 max_tokens=400,
                 tools=[_TEMPORAL_TOOL],
                 tool_choice={"type": "tool", "name": _TEMPORAL_TOOL["name"]},
-                messages=[{"role": "user", "content": content}]
+                messages=[{"role": "user", "content": content}],
             )
 
             data = _tool_input(response)
@@ -934,25 +1057,23 @@ async def _run_temporal_check(
                 raw_response="",
             )
 
-    def _get_image_content(
-        self,
-        embryo_state: EmbryoState,
-        num_images: int = 1
-    ) -> List[Dict]:
+    def _get_image_content(self, embryo_state: EmbryoState, num_images: int = 1) -> list[dict]:
         """Get image content blocks for Claude API"""
         images = []
         recent = embryo_state.recent_images[-num_images:] if embryo_state.recent_images else []
 
         for img in recent:
             if img.max_projection_b64:
-                images.append({
-                    "type": "image",
-                    "source": {
-                        "type": "base64",
-                        "media_type": "image/png",
-                        "data": img.max_projection_b64,
+                images.append(
+                    {
+                        "type": "image",
+                        "source": {
+                            "type": "base64",
+                            "media_type": "image/png",
+                            "data": img.max_projection_b64,
+                        },
                     }
-                })
+                )
 
         return images
 
@@ -986,8 +1107,10 @@ async def _run_ensemble_hatching(self, embryo_state: EmbryoState) -> EnsembleRes
 
 Answer ONE question: Has the embryo HATCHED?
 
-HATCHED means: The worm body is OUTSIDE the eggshell (free-floating, elongated, or field is empty because worm left).
-NOT HATCHED means: The worm is still INSIDE the eggshell (coiled/pretzel-shaped, even if shell looks expanded).
+HATCHED means: The worm body is OUTSIDE the eggshell (free-floating, elongated,
+or field is empty because worm left).
+NOT HATCHED means: The worm is still INSIDE the eggshell (coiled/pretzel-shaped,
+even if shell looks expanded).
 
 Respond with ONLY: YES or NO"""
 
@@ -999,7 +1122,7 @@ async def single_vote() -> str:
                         self.claude.messages.create,
                         model=self.ensemble_model,
                         max_tokens=10,  # Very short response expected
-                        messages=[{"role": "user", "content": content}]
+                        messages=[{"role": "user", "content": content}],
                     )
                     return response.content[0].text.strip().upper()
                 except Exception as e:
@@ -1007,7 +1130,10 @@ async def single_vote() -> str:
                     return "ERROR"
 
             # Run all votes in parallel
-            logger.info(f"[ENSEMBLE] Running {self.ensemble_size} parallel Haiku calls for hatching verification")
+            logger.info(
+                f"[ENSEMBLE] Running {self.ensemble_size} parallel Haiku calls "
+                "for hatching verification"
+            )
             tasks = [single_vote() for _ in range(self.ensemble_size)]
             responses = await asyncio.gather(*tasks)
 
@@ -1062,7 +1188,7 @@ def _evaluate_consensus(
         adversarial: AdversarialResult,
         independent: IndependentResult,
         temporal: TemporalResult,
-        ensemble: Optional[EnsembleResult] = None,
+        ensemble: EnsembleResult | None = None,
     ) -> tuple[bool, str]:
         """
         Evaluate consensus across all verification strategies.
@@ -1078,7 +1204,9 @@ def _evaluate_consensus(
         if not adversarial.found_counter_evidence:
             agreements += 1
         else:
-            disagreements.append(f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}")
+            disagreements.append(
+                f"Adversarial found counter-evidence: {', '.join(adversarial.concerns[:2])}"
+            )
 
         # Check independent: should also detect
         if independent.detected:
@@ -1112,13 +1240,14 @@ def _evaluate_consensus(
                     f"All verification strategies agree ({total_strategies}/{total_strategies}): "
                     f"no counter-evidence found, independent analysis confirms detection, "
                     f"temporal change observed, ensemble voting confirms "
-                    f"({ensemble.votes_yes}/{ensemble.total_votes} = {ensemble.agreement_ratio:.0%} YES)."
+                    f"({ensemble.votes_yes}/{ensemble.total_votes} = "
+                    f"{ensemble.agreement_ratio:.0%} YES)."
                 )
             else:
                 reasoning = (
-                    f"All verification strategies agree: "
-                    f"no counter-evidence found, independent analysis confirms detection, "
-                    f"temporal change observed."
+                    "All verification strategies agree: "
+                    "no counter-evidence found, independent analysis confirms detection, "
+                    "temporal change observed."
                 )
         else:
             reasoning = (
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 3672ba88..6a8c5eb3 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1912,7 +1912,8 @@ def _notify_context_change(self, kind: str = "context") -> None:
         """Emit CONTEXT_UPDATED on the global bus so the shared-visibility
         surface refreshes live. Best-effort — a bus failure never breaks a write."""
         try:
-            from gently.core.event_bus import emit, EventType
+            from gently.core.event_bus import EventType, emit
+
             emit(EventType.CONTEXT_UPDATED, {"kind": kind}, source="context_store")
         except Exception:
             pass
diff --git a/gently/harness/memory/model.py b/gently/harness/memory/model.py
index 58c8ee84..3757a0fe 100644
--- a/gently/harness/memory/model.py
+++ b/gently/harness/memory/model.py
@@ -243,7 +243,7 @@ class ImagingSpec:
     # Per-field provenance for INFERRED values — field name -> {source, confidence}.
     # e.g. {"laser_wavelength_nm": {"source": "inferred:genotype", "confidence": "medium"}}
     # Lets the UI tag each value with where it came from and what to confirm.
-    provenance: Dict[str, Dict[str, str]] = field(default_factory=dict)
+    provenance: dict[str, dict[str, str]] = field(default_factory=dict)
 
 
 @dataclass
diff --git a/gently/settings.py b/gently/settings.py
index 33254621..37ea4336 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -4,6 +4,7 @@
 All configurable values live here. Override via environment variables
 prefixed with GENTLY_ (e.g., GENTLY_VIZ_PORT=9090).
 """
+
 import os
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -29,6 +30,7 @@ def _env(key: str, default):
 @dataclass(frozen=True)
 class NetworkSettings:
     """Ports, hosts, and bind addresses."""
+
     viz_port: int = field(default_factory=lambda: _env("VIZ_PORT", 8080))
     viz_host: str = field(default_factory=lambda: _env("VIZ_HOST", "0.0.0.0"))
     device_port: int = field(default_factory=lambda: _env("DEVICE_PORT", 60610))
@@ -40,7 +42,10 @@ class NetworkSettings:
 @dataclass(frozen=True)
 class MeshSettings:
     """Mesh networking parameters."""
-    broadcast_interval_s: float = field(default_factory=lambda: _env("MESH_BROADCAST_INTERVAL", 5.0))
+
+    broadcast_interval_s: float = field(
+        default_factory=lambda: _env("MESH_BROADCAST_INTERVAL", 5.0)
+    )
     replay_window_s: float = field(default_factory=lambda: _env("MESH_REPLAY_WINDOW", 30.0))
     reaper_interval_s: float = field(default_factory=lambda: _env("MESH_REAPER_INTERVAL", 10.0))
     status_refresh_s: float = field(default_factory=lambda: _env("MESH_STATUS_REFRESH", 30.0))
@@ -72,6 +77,7 @@ class ModelSettings:
     Sonnet 4.6 supports adaptive thinking. No assistant prefills anywhere (4.6+
     family rejects them).
     """
+
     main: str = field(default_factory=lambda: _env("MODEL_MAIN", "claude-fable-5"))
     perception: str = field(default_factory=lambda: _env("MODEL_PERCEPTION", "claude-opus-4-8"))
     fast: str = field(default_factory=lambda: _env("MODEL_FAST", "claude-sonnet-4-6"))
@@ -79,12 +85,15 @@ class ModelSettings:
     # When the main tier (Fable 5) declines a turn (stop_reason="refusal"), the
     # main-tier calls transparently retry it on this model instead of surfacing
     # the refusal. Empty disables the fallback.
-    refusal_fallback: str = field(default_factory=lambda: _env("MODEL_REFUSAL_FALLBACK", "claude-opus-4-8"))
+    refusal_fallback: str = field(
+        default_factory=lambda: _env("MODEL_REFUSAL_FALLBACK", "claude-opus-4-8")
+    )
 
 
 @dataclass(frozen=True)
 class StorageSettings:
     """File paths for data storage."""
+
     base_path: Path = field(default_factory=lambda: _env("STORAGE_PATH", Path("D:/Gently3")))
 
     @property
@@ -99,6 +108,7 @@ def traces_dir(self) -> Path:
 @dataclass(frozen=True)
 class TimeoutSettings:
     """Timeout values in seconds."""
+
     plan_execution: int = field(default_factory=lambda: _env("TIMEOUT_PLAN", 300))
     rpc_call: int = field(default_factory=lambda: _env("TIMEOUT_RPC", 60))
     volume_acquisition: int = field(default_factory=lambda: _env("TIMEOUT_VOLUME", 15))
@@ -108,6 +118,7 @@ class TimeoutSettings:
 @dataclass(frozen=True)
 class ApiSettings:
     """External API configuration."""
+
     ncbi_tool: str = field(default_factory=lambda: _env("NCBI_TOOL", "gently"))
     ncbi_email: str = field(default_factory=lambda: _env("NCBI_EMAIL", "pskeshu@gmail.com"))
 
@@ -115,6 +126,7 @@ class ApiSettings:
 @dataclass(frozen=True)
 class MlSettings:
     """Machine learning training parameters."""
+
     model_cache_dir: Path = field(default_factory=lambda: _env("ML_MODEL_CACHE", Path("models")))
     default_batch_size: int = field(default_factory=lambda: _env("ML_BATCH_SIZE", 32))
     default_epochs: int = field(default_factory=lambda: _env("ML_EPOCHS", 50))
@@ -124,14 +136,18 @@ class MlSettings:
 @dataclass(frozen=True)
 class TransferSettings:
     """Bulk transfer protocol parameters."""
+
     transfer_port: int = field(default_factory=lambda: _env("TRANSFER_PORT", 19548))
     chunk_size: int = field(default_factory=lambda: _env("TRANSFER_CHUNK_SIZE", 1048576))  # 1MB
-    max_concurrent_transfers: int = field(default_factory=lambda: _env("TRANSFER_MAX_CONCURRENT", 4))
+    max_concurrent_transfers: int = field(
+        default_factory=lambda: _env("TRANSFER_MAX_CONCURRENT", 4)
+    )
 
 
 @dataclass(frozen=True)
 class UISettings:
     """Web UI feature flags."""
+
     # New agent-first UX paradigm (welcome→shell unfold, dual-rendered agent
     # asks, inference-first plan mode, shared-visibility surface). Now ON by
     # default; the v1 dashboard remains available as a fallback via
@@ -142,6 +158,7 @@ class UISettings:
 @dataclass(frozen=True)
 class Settings:
     """Top-level settings container."""
+
     network: NetworkSettings = field(default_factory=NetworkSettings)
     mesh: MeshSettings = field(default_factory=MeshSettings)
     models: ModelSettings = field(default_factory=ModelSettings)
diff --git a/gently/ui/web/connection_manager.py b/gently/ui/web/connection_manager.py
index 00aeaef2..1d1f2a23 100644
--- a/gently/ui/web/connection_manager.py
+++ b/gently/ui/web/connection_manager.py
@@ -161,7 +161,9 @@ async def broadcast(self, message: dict):
                     # Expected when a client disconnects/reloads mid-broadcast
                     # (send after websocket.close). The connection is dropped
                     # below, so this is debug-level, not a warning.
-                    logger.debug("Dropping a websocket that errored on send (client likely gone): %s", e)
+                    logger.debug(
+                        "Dropping a websocket that errored on send (client likely gone): %s", e
+                    )
                     disconnected.append(connection)
 
             # Remove disconnected clients
diff --git a/gently/ui/web/routes/chat.py b/gently/ui/web/routes/chat.py
index 1fffcb7f..e07d4501 100644
--- a/gently/ui/web/routes/chat.py
+++ b/gently/ui/web/routes/chat.py
@@ -19,8 +19,8 @@
 from fastapi.responses import StreamingResponse
 from pydantic import BaseModel
 
-from gently.ui.web.auth import require_control
 from gently.settings import settings
+from gently.ui.web.auth import require_control
 
 logger = logging.getLogger(__name__)
 
diff --git a/gently/ui/web/routes/context.py b/gently/ui/web/routes/context.py
index 2d7c39df..66c7f25c 100644
--- a/gently/ui/web/routes/context.py
+++ b/gently/ui/web/routes/context.py
@@ -10,6 +10,7 @@
 from fastapi import APIRouter, Body, Depends
 
 from gently.ui.web.auth import require_control
+
 from .campaigns import _serialize
 
 
@@ -36,8 +37,7 @@ async def get_context():
         except Exception:
             return empty
 
-    @router.post("/api/context/questions/{q_id}/resolve",
-                 dependencies=[Depends(require_control)])
+    @router.post("/api/context/questions/{q_id}/resolve", dependencies=[Depends(require_control)])
     async def resolve_question(q_id: str, resolution: str = Body("", embed=True)):
         cs = _store()
         if cs is None:
@@ -45,8 +45,9 @@ async def resolve_question(q_id: str, resolution: str = Body("", embed=True)):
         cs.resolve_question(q_id, resolution or "")
         return {"ok": True}
 
-    @router.post("/api/context/watchpoints/{wp_id}/resolve",
-                 dependencies=[Depends(require_control)])
+    @router.post(
+        "/api/context/watchpoints/{wp_id}/resolve", dependencies=[Depends(require_control)]
+    )
     async def resolve_watchpoint(wp_id: str):
         cs = _store()
         if cs is None:
@@ -54,13 +55,15 @@ async def resolve_watchpoint(wp_id: str):
         cs.resolve_watchpoint(wp_id)
         return {"ok": True}
 
-    @router.post("/api/context/expectations/{exp_id}/resolve",
-                 dependencies=[Depends(require_control)])
+    @router.post(
+        "/api/context/expectations/{exp_id}/resolve", dependencies=[Depends(require_control)]
+    )
     async def resolve_expectation(exp_id: str, status: str = Body("confirmed", embed=True)):
         cs = _store()
         if cs is None:
             return {"ok": False, "error": "context store unavailable"}
         from gently.harness.memory.model import ExpectationStatus
+
         try:
             st = ExpectationStatus(status)
         except ValueError:

From ec64daf6f8a2b46b36bd9d38ba31e38b62f7fc02 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 15 Jun 2026 02:15:48 +0530
Subject: [PATCH 105/314] Models: revert main tier from Fable 5 to Opus 4.8
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fable 5 was declining benign planning turns (stop_reason="refusal"),
which tripped the refusal fallback on essentially every turn — adding a
full extra round-trip of latency per message. Point MODEL_MAIN at Opus
4.8 so the common path is a single call; refusal_fallback is now inert
(the guard skips it when fallback == main). Set MODEL_MAIN=claude-fable-5
to switch back once Fable 5 stops refusing. Prune the now-stale Fable-5
notes from the tier docstring.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/settings.py | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/gently/settings.py b/gently/settings.py
index 37ea4336..9e7d2e68 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -59,12 +59,11 @@ class ModelSettings:
     """Claude model identifiers — the single source of truth for every tier.
 
     Tiers are split by role; capability-first per the latest models:
-      - main:       Claude Fable 5 ($10/$50 per MTok). Per-user-turn reasoning +
-                    tool orchestration (plan mode) and the dopaminergic classifier
-                    stage. Always-on thinking (no thinking budget — control depth
-                    via output_config.effort), ~30%-heavier tokenizer, may refuse
-                    (stop_reason="refusal", empty content); needs ≥30-day org
-                    data retention.
+      - main:       Opus 4.8 ($5/$25). Per-user-turn reasoning + tool
+                    orchestration (plan mode) and the dopaminergic classifier
+                    stage. (Fable 5 was tried here but declined benign planning
+                    turns — stop_reason="refusal" — forcing a fallback on every
+                    turn; set MODEL_MAIN=claude-fable-5 to retry it.)
       - perception: Opus 4.8 (high-res vision, $5/$25). Highest-frequency tier
                     (per timepoint); Opus-tier vision for perception accuracy.
       - medium:     Opus 4.8. Onboarding / wizard summaries.
@@ -72,19 +71,20 @@ class ModelSettings:
                     verifier's parallel ensemble (ensemble_size calls per
                     verification) and blank-image / summary checks.
 
-    API note: Fable 5 and Opus 4.8 reject thinking budget_tokens and sampling
-    params (temperature/top_p/top_k) — adaptive thinking only, depth via effort.
-    Sonnet 4.6 supports adaptive thinking. No assistant prefills anywhere (4.6+
-    family rejects them).
+    API note: Opus 4.8 rejects thinking budget_tokens and sampling params
+    (temperature/top_p/top_k) — adaptive thinking only, depth via effort.
+    Sonnet 4.6 supports adaptive thinking. No assistant prefills anywhere
+    (4.6+ family rejects them).
     """
 
-    main: str = field(default_factory=lambda: _env("MODEL_MAIN", "claude-fable-5"))
+    main: str = field(default_factory=lambda: _env("MODEL_MAIN", "claude-opus-4-8"))
     perception: str = field(default_factory=lambda: _env("MODEL_PERCEPTION", "claude-opus-4-8"))
     fast: str = field(default_factory=lambda: _env("MODEL_FAST", "claude-sonnet-4-6"))
     medium: str = field(default_factory=lambda: _env("MODEL_MEDIUM", "claude-opus-4-8"))
-    # When the main tier (Fable 5) declines a turn (stop_reason="refusal"), the
-    # main-tier calls transparently retry it on this model instead of surfacing
-    # the refusal. Empty disables the fallback.
+    # If the main tier declines a turn (stop_reason="refusal"), retry it on this
+    # model instead of surfacing the refusal. Inert while main is Opus 4.8 (the
+    # guard skips it when fallback == main); relevant if main is set to Fable 5.
+    # Empty disables the fallback.
     refusal_fallback: str = field(
         default_factory=lambda: _env("MODEL_REFUSAL_FALLBACK", "claude-opus-4-8")
     )

From d5dac56bde090c9a9ba9cd21d311b45afaffa31c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 04:28:30 +0530
Subject: [PATCH 106/314] UX v2: expandable tool cards show full (bounded) tool
 results

Stream a bounded result_full alongside the 140-char result_summary so the
web UI's expandable tool card can show what a tool actually returned, not
just the one-line preview. Frontend (landing.js/css) renders the expandable
card; the thinking indicator's label is wrapped in a span so it can be
updated live.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/conversation.py       |   9 ++
 gently/ui/web/static/css/landing.css |  41 ++++-
 gently/ui/web/static/js/landing.js   | 222 +++++++++++++++++++++++----
 gently/ui/web/templates/index.html   |   2 +-
 4 files changed, 241 insertions(+), 33 deletions(-)

diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 9085e96b..6ba26262 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -737,12 +737,21 @@ def _run(m):
                     if len(result_summary) > 140:
                         result_summary = result_summary[:139] + "…"
 
+                    # Full result (bounded) so the UI's expandable tool card can
+                    # show what the tool actually returned — not just the 140-char
+                    # one-liner. The web client caps/scrolls this further; keep the
+                    # streamed payload sane.
+                    result_full = result_text or ""
+                    if len(result_full) > 4000:
+                        result_full = result_full[:4000] + "\n…(truncated)"
+
                     yield {
                         "type": "tool_call",
                         "tool_name": block.name,
                         "tool_input": block.input,
                         "duration": time.time() - start_time,
                         "result_summary": result_summary,
+                        "result_full": result_full,
                         "is_error": is_error_flag,
                     }
 
diff --git a/gently/ui/web/static/css/landing.css b/gently/ui/web/static/css/landing.css
index fff753e8..dad23d0b 100644
--- a/gently/ui/web/static/css/landing.css
+++ b/gently/ui/web/static/css/landing.css
@@ -292,6 +292,21 @@ body.ux-v2 .home-hero { display: none; }
 .v2-plan-activity { display: flex; flex-direction: column; gap: 8px; margin-bottom: 12px; }
 .v2-plan-activity:empty { display: none; margin: 0; }
 
+/* Paginated feed — one agent step (turn) per page, flipped with ‹ Prev / Next ›.
+   The pager bar / dots reuse .v2-plan-pager / .v2-plan-dots styling. */
+.v2-feed-pages { display: flex; flex-direction: column; }
+.v2-act-page { display: none; flex-direction: column; gap: 8px; }
+.v2-act-page.active { display: flex; }
+/* beat .v2-plan-pager/.v2-plan-dots { display:flex } so [hidden] actually hides */
+.v2-plan-pager[hidden], .v2-plan-dots[hidden] { display: none; }
+.v2-feed-pager-bar { margin: 0 0 4px; }
+.v2-feed-dots { margin-top: 10px; }
+/* the current question, pinned below the paged feed, set off by a divider —
+   only once there are steps above it (no stray line on the first choice card) */
+#v2-plan-activity:has(.v2-act-page) + .v2-plan-ask:not(:empty) {
+    margin-top: 14px; padding-top: 14px; border-top: 1px solid var(--border, #e4e9f0);
+}
+
 /* agent prose between tool calls */
 .v2-act-text { font-size: var(--v2-fs-sm); line-height: 1.55; color: var(--text-secondary, #475569); white-space: pre-wrap; }
 
@@ -359,6 +374,29 @@ body.ux-v2[data-theme="dark"] .v2-plan-error {
 .v2-plan-task::before { content: "·"; color: var(--text-muted, #94a3b8); }
 .v2-plan-title-row { font-size: var(--v2-fs-sm); font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); margin-bottom: 8px; }
 .v2-plan-row.v2-plan-row-freetext .v { font-style: italic; }
+.v2-plan-task-empty { color: var(--text-muted, #94a3b8); font-style: italic; }
+.v2-plan-task-empty::before { color: transparent; }
+
+/* THE PLAN pager: ‹ Prev · "Phase · i of N" · Next › + dots, one phase per page */
+.v2-plan-pager { display: flex; align-items: center; gap: 8px; margin: 2px 0 12px; }
+.v2-plan-pager-btn {
+    flex: none; background: none; border: 0; cursor: pointer; font: inherit;
+    font-size: var(--v2-fs-cap); font-weight: 600; color: var(--accent, #2f6df6);
+    padding: 5px 7px; border-radius: 7px; transition: background .15s, color .15s, opacity .15s;
+}
+.v2-plan-pager-btn:hover:not(:disabled) { background: var(--accent-soft); }
+.v2-plan-pager-btn:disabled { color: var(--text-muted, #94a3b8); opacity: .45; cursor: default; }
+.v2-plan-pager-pos {
+    flex: 1; min-width: 0; text-align: center; font-size: var(--v2-fs-cap); font-weight: 600;
+    color: var(--text, #0f172a); overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
+.v2-plan-dots { display: flex; gap: 6px; justify-content: center; margin-top: 12px; }
+.v2-plan-dot {
+    width: 7px; height: 7px; padding: 0; border: 0; border-radius: 50%; cursor: pointer;
+    background: var(--border, #e4e9f0); transition: background .2s, transform .2s;
+}
+.v2-plan-dot:hover { transform: scale(1.25); }
+.v2-plan-dot.active { background: var(--accent, #2f6df6); }
 
 @media (prefers-reduced-motion: reduce) {
     .v2-landing, .v2-landing::before, .v2-landing-rise, .v2-landing-orb, .v2-plan-orb,
@@ -366,7 +404,8 @@ body.ux-v2[data-theme="dark"] .v2-plan-error {
     .v2-landing[data-screen="welcome"] .v2-screen-welcome,
     .v2-typing i, .v2-act-spin, .v2-act-chev,
     .v2-act-tool-body, .v2-act-tool-head,
-    .v2-choice, .v2-escape-field, .v2-escape-toggle {
+    .v2-choice, .v2-escape-field, .v2-escape-toggle,
+    .v2-plan-pager-btn, .v2-plan-dot {
         animation: none !important;
         transition-duration: .12s !important;
     }
diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
index 2f524c1e..bb4a0923 100644
--- a/gently/ui/web/static/js/landing.js
+++ b/gently/ui/web/static/js/landing.js
@@ -54,7 +54,22 @@ const V2Landing = (() => {
     }
 
     // ── status / error helpers ────────────────────────────────────────
-    function showThinking(on) { const t = $('v2-plan-thinking'); if (t) t.classList.toggle('hidden', !on); }
+    function setThinkingLabel(text) {
+        const l = document.querySelector('#v2-plan-thinking .v2-plan-thinking-label');
+        if (l && text) l.textContent = text;
+    }
+    function showThinking(on, label) {
+        const t = $('v2-plan-thinking');
+        if (t) t.classList.toggle('hidden', !on);
+        if (on && label) setThinkingLabel(label);
+    }
+    // Human-readable "what's happening right now" from a tool activity event,
+    // so the status line names the live operation instead of a static string.
+    function prettyTool(act) {
+        const raw = (act && (act.label || act.name)) || 'the next step';
+        const s = String(raw).replace(/_/g, ' ').trim();
+        return s.charAt(0).toUpperCase() + s.slice(1) + '…';
+    }
     function errorVisible() { const e = $('v2-plan-error'); return !!e && !e.classList.contains('hidden'); }
     function showPlanError(msg) {
         const e = $('v2-plan-error'); if (!e) return;
@@ -67,17 +82,90 @@ const V2Landing = (() => {
     function resetSummary() {
         const list = $('v2-plan-summary');
         if (list) list.innerHTML = '<div class="v2-plan-side-empty">The plan will take shape here as Gently designs it.</div>';
+        planPage = 0; planPages = []; planTitleText = '';
     }
 
-    // ── activity feed (claude.ai-style collapsible tool cards) ─────────
+    // ── activity feed: paginated, ONE agent step (turn) per page ───────
+    // Instead of one ever-growing scroll, each agent turn — its reasoning +
+    // the tool calls it made — is a page you flip through with ‹ Prev / Next ›.
+    // The current question stays pinned below the feed (#v2-plan-ask). A new
+    // turn auto-advances to its page; you can flip back to review earlier steps.
+    let feedPages = [];        // .v2-act-page elements, one per turn
+    let feedPage = 0;          // index currently shown
+    let curPageEl = null;      // page receiving this turn's content
+    let pendingNewPage = false; // a turn started; open a fresh page on first content
+
     function feedEl() { return $('v2-plan-activity'); }
+    function feedPagesWrap() { return feedEl()?.querySelector('.v2-feed-pages'); }
     function clearActivity() {
-        const f = feedEl(); if (f) f.innerHTML = '';
+        const f = feedEl();
+        if (f) {
+            f.innerHTML =
+                '<div class="v2-plan-pager v2-feed-pager-bar" hidden></div>' +
+                '<div class="v2-feed-pages"></div>' +
+                '<div class="v2-plan-dots v2-feed-dots" hidden></div>';
+        }
+        feedPages = []; feedPage = 0; curPageEl = null; pendingNewPage = false;
         feedTextEl = null; runningTools = {}; feedHadContent = false;
         capturedCampaignId = null;
         hidePlanError();
     }
+    function newFeedPage() {
+        const wrap = feedPagesWrap(); if (!wrap) return null;
+        const page = document.createElement('div');
+        page.className = 'v2-act-page';
+        wrap.appendChild(page);
+        feedPages.push(page);
+        curPageEl = page;
+        feedPage = feedPages.length - 1;   // auto-advance to the live step
+        feedTextEl = null;
+        drawFeedPager();
+        return page;
+    }
+    // Where this turn's prose/tool cards land. Opens a fresh page the first time
+    // content arrives after a turn_start (so content-less command turns don't
+    // leave empty pages), and lazily on the very first content.
+    function feedTarget() {
+        if (pendingNewPage || !curPageEl) { newFeedPage(); pendingNewPage = false; }
+        return curPageEl;
+    }
+    function viewingLatest() { return feedPage >= feedPages.length - 1; }
+    function drawFeedPager() {
+        const f = feedEl(); if (!f) return;
+        const n = feedPages.length;
+        const i = Math.min(Math.max(feedPage, 0), Math.max(n - 1, 0));
+        feedPages.forEach((p, idx) => p.classList.toggle('active', idx === i));
+        const bar = f.querySelector('.v2-feed-pager-bar');
+        const dots = f.querySelector('.v2-feed-dots');
+        if (!bar || !dots) return;
+        if (n <= 1) { bar.hidden = true; dots.hidden = true; return; }
+        bar.hidden = false; dots.hidden = false;
+        bar.innerHTML = '';
+        const mkBtn = (txt, disabled, fn) => {
+            const b = document.createElement('button');
+            b.className = 'v2-plan-pager-btn'; b.type = 'button'; b.textContent = txt;
+            b.disabled = disabled; b.addEventListener('click', fn);
+            return b;
+        };
+        const pos = document.createElement('span');
+        pos.className = 'v2-plan-pager-pos'; pos.textContent = `Step ${i + 1} of ${n}`;
+        bar.append(
+            mkBtn('‹ Prev', i === 0, () => { if (feedPage > 0) { feedPage--; drawFeedPager(); } }),
+            pos,
+            mkBtn('Next ›', i === n - 1, () => { if (feedPage < n - 1) { feedPage++; drawFeedPager(); } }),
+        );
+        dots.innerHTML = '';
+        for (let d = 0; d < n; d++) {
+            const dot = document.createElement('button');
+            dot.className = 'v2-plan-dot' + (d === i ? ' active' : '');
+            dot.type = 'button';
+            dot.setAttribute('aria-label', `Step ${d + 1} of ${n}`);
+            dot.addEventListener('click', () => { feedPage = d; drawFeedPager(); });
+            dots.appendChild(dot);
+        }
+    }
     function scrollFeedIfNearBottom() {
+        if (!viewingLatest()) return;   // don't yank the user off an earlier step
         const m = document.querySelector('.v2-screen-plan .v2-plan-main');
         if (m && (m.scrollHeight - m.scrollTop - m.clientHeight) < 140) m.scrollTop = m.scrollHeight;
     }
@@ -172,10 +260,11 @@ const V2Landing = (() => {
         const f = feedEl(); if (!f) return;
         switch (act.kind) {
             case 'turn_start':
-                feedTextEl = null; hidePlanError(); clearFallback(); showThinking(true);
+                feedTextEl = null; pendingNewPage = true; hidePlanError(); clearFallback();
+                showThinking(true, 'reviewing your campaign and plan…');
                 break;
             case 'thinking':
-                showThinking(true);
+                showThinking(true, 'thinking through the next step…');
                 break;
             case 'text': {
                 const chunk = act.text || '';
@@ -184,11 +273,11 @@ const V2Landing = (() => {
                     feedTextEl = document.createElement('div');
                     feedTextEl.className = 'v2-act-text';
                     feedTextEl._raw = '';
-                    f.appendChild(feedTextEl);
+                    feedTarget().appendChild(feedTextEl);
                 }
                 feedTextEl._raw += chunk;
                 feedTextEl.innerHTML = renderMd(feedTextEl._raw);
-                feedHadContent = true; showThinking(true); scrollFeedIfNearBottom();
+                feedHadContent = true; showThinking(true, 'composing the response…'); scrollFeedIfNearBottom();
                 break;
             }
             case 'tool_start': {
@@ -197,9 +286,9 @@ const V2Landing = (() => {
                 if (act.name === 'ask_user_choice') break;
                 feedTextEl = null;
                 const card = buildToolCard(act, false);
-                f.appendChild(card);
+                feedTarget().appendChild(card);
                 (runningTools[act.name] = runningTools[act.name] || []).push(card);
-                feedHadContent = true; showThinking(true); scrollFeedIfNearBottom();
+                feedHadContent = true; showThinking(true, prettyTool(act)); scrollFeedIfNearBottom();
                 break;
             }
             case 'tool_result': {
@@ -211,8 +300,8 @@ const V2Landing = (() => {
                 const arr = runningTools[act.name] || [];
                 const card = arr.pop();
                 if (card) updateToolCard(card, act);
-                else f.appendChild(buildToolCard(act, true));
-                feedHadContent = true; scrollFeedIfNearBottom();
+                else feedTarget().appendChild(buildToolCard(act, true));
+                feedHadContent = true; setThinkingLabel('working through the next step…'); scrollFeedIfNearBottom();
                 break;
             }
             case 'turn_end':
@@ -232,7 +321,7 @@ const V2Landing = (() => {
         d.className = 'v2-plan-fallback';
         d.innerHTML = 'Gently replied in prose — <a>open the conversation</a> to read it.';
         d.querySelector('a').addEventListener('click', openChat);
-        f.appendChild(d);
+        feedTarget().appendChild(d);
     }
 
     // ── THE PLAN panel: mirror the real campaign tree ──────────────────
@@ -254,35 +343,101 @@ const V2Landing = (() => {
         c = c || {};
         return c.shorthand || c.display_name || c.description || 'Plan';
     }
+    // THE PLAN renders as a pager — one phase per page with ‹ Prev / Next ›,
+    // a position label, and dots — instead of one long scroll. planPage is held
+    // across re-renders (the panel refetches on every plan-writing tool) so the
+    // page you're reading doesn't snap back to the start mid-design.
+    let planPage = 0;
+    let planPages = [];     // [{ name, items }]
+    let planTitleText = '';
+
     function renderPlanTree(tree) {
-        const list = $('v2-plan-summary');
-        if (!list || !tree) return;
+        if (!tree) return;
         const phases = tree.children || [];
         const rootItems = tree.items || [];
         if (!phases.length && !rootItems.length) return;  // nothing to show yet — keep placeholder
+        const pages = [];
+        if (rootItems.length) pages.push({ name: 'Tasks', items: rootItems });
+        phases.forEach(phase => {
+            if (!phase) return;
+            pages.push({ name: planName(phase.campaign), items: phase.items || [] });
+        });
+        planPages = pages;
+        planTitleText = planName(tree.campaign);
+        if (planPage >= pages.length) planPage = pages.length - 1;
+        if (planPage < 0) planPage = 0;
+        drawPlanPage();
+    }
+
+    function drawPlanPage() {
+        const list = $('v2-plan-summary');
+        if (!list) return;
+        const pages = planPages;
+        const n = pages.length;
+        if (!n) return;
+        const i = Math.min(Math.max(planPage, 0), n - 1);
+        const page = pages[i];
+
         list.innerHTML = '';
         const title = document.createElement('div');
         title.className = 'v2-plan-title-row';
-        title.textContent = planName(tree.campaign);
+        title.textContent = planTitleText;
         list.appendChild(title);
-        const addTask = (parent, it) => {
-            const t = document.createElement('div');
-            t.className = 'v2-plan-task';
-            t.textContent = it.title || it.shorthand || '(task)';
-            parent.appendChild(t);
-        };
-        rootItems.forEach(it => addTask(list, it));
-        phases.forEach(phase => {
-            if (!phase) return;
-            const wrap = document.createElement('div');
-            wrap.className = 'v2-plan-phase';
+
+        if (n > 1) {
+            const bar = document.createElement('div');
+            bar.className = 'v2-plan-pager';
+            const prev = document.createElement('button');
+            prev.className = 'v2-plan-pager-btn'; prev.type = 'button'; prev.textContent = '‹ Prev';
+            prev.disabled = i === 0;
+            prev.addEventListener('click', () => { if (planPage > 0) { planPage--; drawPlanPage(); } });
+            const pos = document.createElement('span');
+            pos.className = 'v2-plan-pager-pos';
+            pos.textContent = `${page.name} · ${i + 1} of ${n}`;
+            const next = document.createElement('button');
+            next.className = 'v2-plan-pager-btn'; next.type = 'button'; next.textContent = 'Next ›';
+            next.disabled = i === n - 1;
+            next.addEventListener('click', () => { if (planPage < n - 1) { planPage++; drawPlanPage(); } });
+            bar.append(prev, pos, next);
+            list.appendChild(bar);
+        } else {
             const h = document.createElement('div');
             h.className = 'v2-plan-phase-h';
-            h.textContent = planName(phase.campaign);
-            wrap.appendChild(h);
-            (phase.items || []).forEach(it => addTask(wrap, it));
-            list.appendChild(wrap);
-        });
+            h.textContent = page.name;
+            list.appendChild(h);
+        }
+
+        const tasks = document.createElement('div');
+        tasks.className = 'v2-plan-phase';
+        const items = page.items || [];
+        if (items.length) {
+            items.forEach(it => {
+                const t = document.createElement('div');
+                t.className = 'v2-plan-task';
+                t.textContent = it.title || it.shorthand || '(task)';
+                tasks.appendChild(t);
+            });
+        } else {
+            const e = document.createElement('div');
+            e.className = 'v2-plan-task v2-plan-task-empty';
+            e.textContent = 'no items in this phase yet';
+            tasks.appendChild(e);
+        }
+        list.appendChild(tasks);
+
+        if (n > 1) {
+            const dots = document.createElement('div');
+            dots.className = 'v2-plan-dots';
+            for (let d = 0; d < n; d++) {
+                const dot = document.createElement('button');
+                dot.className = 'v2-plan-dot' + (d === i ? ' active' : '');
+                dot.type = 'button';
+                dot.setAttribute('aria-label', `Go to ${pages[d].name} (${d + 1} of ${n})`);
+                dot.addEventListener('click', () => { planPage = d; drawPlanPage(); });
+                dots.appendChild(dot);
+            }
+            list.appendChild(dots);
+        }
     }
 
     // ── ask rendering (the active question) ────────────────────────────
@@ -470,6 +625,11 @@ const V2Landing = (() => {
             if (request_id === '*' || (current && request_id === current.reqId)) {
                 current = null; clearAsk();
                 if (planActive() && !errorVisible()) showThinking(true);
+                // A question was just answered — the agent's continuation is the
+                // next step, so open a fresh feed page for it. (A turn stays one
+                // stream across an ask_user_choice pause, so turn_start alone
+                // would lump every step of the design into a single page.)
+                pendingNewPage = true;
             }
         });
         ClientEventBus.on('AGENT_CONTROL', () => { if (current && planActive()) renderAsk(); });
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 36688f8a..e83eda63 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -83,7 +83,7 @@ <h3>Take a quick look</h3>
             <div class="v2-plan-main">
               <div class="v2-plan-activity" id="v2-plan-activity"></div>
               <div class="v2-plan-ask" id="v2-plan-ask" aria-live="polite"></div>
-              <div class="v2-plan-thinking" id="v2-plan-thinking"><span class="v2-typing"><i></i><i></i><i></i></span> thinking through the next step…</div>
+              <div class="v2-plan-thinking" id="v2-plan-thinking"><span class="v2-typing"><i></i><i></i><i></i></span> <span class="v2-plan-thinking-label">working through the next step…</span></div>
               <div class="v2-plan-error hidden" id="v2-plan-error" role="alert"></div>
             </div>
             <aside class="v2-plan-side">

From d777cddbb04cdb54bdf26e3a33d2cc7b4c063533 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 05:11:26 +0530
Subject: [PATCH 107/314] Release 0.22.0: finalize version, changelog, ignore
 stray runtime dir

Drop the .dev0 pre-release marker, add the v0.22.0 changelog entry, and
gitignore the literal D:/ runtime storage dir that gets created on Linux
when GENTLY_STORAGE_PATH resolves to a Windows path.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .gitignore     |  3 +++
 CHANGELOG.md   | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 pyproject.toml |  2 +-
 3 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index cce868ec..935470d1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -145,3 +145,6 @@ electron/
 /stage_definitions_for_review.txt
 gently/ui/tui/node_modules/
 gently/ui/tui/dist/
+
+# Runtime storage accidentally created on Linux when GENTLY_STORAGE_PATH="D:/" resolves literally
+D:/
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 30669817..0097853a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -394,6 +394,52 @@ Net: ~3,500 lines removed across P6–P7.
 
 ---
 
+## v0.22.0
+
+File-based storage, a redesigned web UI, new hardware, and the tooling to
+keep it all honest.
+
+**File-based storage (Gently3)**
+Retired the SQLite databases. All state now lives as human-browsable files
+under `D:\Gently3\` — sessions, embryos, volumes, projections, traces,
+campaigns, learnings, agent memory, all YAML/JSONL/TIFF.
+- `FileStore` replaces `GentlyStore`; `FileContextStore` replaces the
+  `agent_mind.db` `ContextStore`. Drop-in API replacements.
+- A root `gently.yaml` manifest documents the layout for humans and agents.
+- YAML parses are cached in `FileContextStore` — fixes slow Plans/campaign
+  loading.
+
+**Web UI redesign**
+- Agent chat became a docked, sliding side panel (overlay + pin-to-dock)
+  instead of owning the screen.
+- Added a Home landing tab; the chat no longer auto-runs the startup wizard.
+- Login is non-blocking — a "Continue in view-only" escape hatch.
+- Recent images aggregate across previous sessions.
+
+**Hardware**
+- Integrated the ACUITYnano temperature controller (config, web control,
+  SDKs) with a live HiveMQ cloud SIM for hardware-free testing.
+- Added the SPIM-head F-drive device, hard limits, and focus/align plans.
+- Room-light toggle and a device-layer terminal UI.
+
+**Agent + perception**
+- Integrated the agent with perception: pull tool, prompt context, event
+  bridge, wake-router.
+- Live acquisition control with observable, permissioned autonomy and a
+  refreshed prompt.
+- Retired napari from the agent; added web-chat autocomplete and pruned
+  dead tools.
+
+**Tooling and environment**
+- Added ruff lint/format tooling and fixed all violations.
+- Adopted incremental mypy typing — config, CI, pre-commit wiring, and a
+  documented policy in `CONTRIBUTING.md`; pinned mypy to 2.1.0.
+- Switched environment setup to uv with an offline/UI-only launch path;
+  pinned pymmcore to device-interface 70.
+- Relicensed and updated the author list.
+
+---
+
 ## Notes on how we think about this
 
 Things we've learned building this, roughly in order:
diff --git a/pyproject.toml b/pyproject.toml
index d2a0c9a4..561326b8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gently"
-version = "0.22.0.dev0"
+version = "0.22.0"
 description = "Agentic harnessing for microscopy"
 readme = "docs/README.md"
 license = {text = "GPL-3.0-or-later"}

From d77bb12a7ef09a1387e1b9cc02610c3b04049e2f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 05:16:51 +0530
Subject: [PATCH 108/314] README: bump status to 0.22.0

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8fdc3efe..78039e70 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 Agentic harness for microscopy.
 
-**Status**: 0.22.0.dev0 — actively developed at Shroff Lab, Janelia.
+**Status**: 0.22.0 — actively developed at Shroff Lab, Janelia.
 
 ![Safety Architecture](docs/images/safety_architecture.png)
 

From a26ee99f9ad96b5c19bed24e4950257c94f217aa Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 05:09:01 +0530
Subject: [PATCH 109/314] WIP: 3D optical-space view in the Devices tab

Live digital-twin of the addressable imaging volume: the acquisition cuboid
+ light-sheet plane, driven by a new SCAN_GEOMETRY_UPDATE backend signal
(emitted from acquire_volume, bootstrapped via /api/devices/scan_geometry)
and live DEVICE_STATE_UPDATE positions. Sits as the Map / Details / 3D view
switcher inside the Devices tab (not a top-level nav tab). Includes a demo
driver for offline development.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/tools/acquisition_tools.py  |  75 ++++
 gently/core/event_bus.py               |   1 +
 gently/ui/web/routes/data.py           |  42 +++
 gently/ui/web/static/js/devices.js     |   9 +-
 gently/ui/web/static/js/occupancy3d.js | 489 +++++++++++++++++++++++++
 gently/ui/web/static/js/utils.js       |  60 +++
 gently/ui/web/templates/index.html     |  36 ++
 screenshots/occupancy3d-demo.png       | Bin 0 -> 244754 bytes
 8 files changed, 711 insertions(+), 1 deletion(-)
 create mode 100644 gently/ui/web/static/js/occupancy3d.js
 create mode 100644 screenshots/occupancy3d-demo.png

diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index 8efcef79..79f69732 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -6,6 +6,8 @@
 
 import asyncio
 import logging
+import time
+from typing import Any
 
 import numpy as np
 
@@ -15,6 +17,62 @@
 logger = logging.getLogger(__name__)
 
 
+def _publish_scan_geometry(
+    agent: Any,
+    *,
+    embryo_id: str,
+    stage_position: dict | None,
+    num_slices: int,
+    exposure_ms: float,
+    galvo_amplitude: float,
+    galvo_center: float,
+    piezo_amplitude: float,
+    piezo_center: float,
+) -> None:
+    """Emit SCAN_GEOMETRY_UPDATE describing the cuboid being acquired.
+
+    Drives the 3D optical-space view (the addressable volume + the scan cuboid
+    and light-sheet mode). Telemetry only — callers guard against exceptions so
+    this never interferes with an acquisition. The payload is also stashed on
+    the agent for REST bootstrap (``/api/devices/scan_geometry``).
+    """
+    from gently.core import EventType, get_event_bus
+
+    z_extent_um = 2.0 * piezo_amplitude
+    slice_spacing_um = z_extent_um / (num_slices - 1) if num_slices > 1 else 0.0
+    sx = stage_position.get("x") if stage_position else None
+    sy = stage_position.get("y") if stage_position else None
+
+    payload: dict[str, Any] = {
+        "embryo_id": embryo_id,
+        "stage_position_um": {"x": sx, "y": sy},
+        "scan": {
+            "num_slices": num_slices,
+            "exposure_ms": exposure_ms,
+            "galvo_amplitude_deg": galvo_amplitude,
+            "galvo_center_deg": galvo_center,
+            "piezo_amplitude_um": piezo_amplitude,
+            "piezo_center_um": piezo_center,
+        },
+        "derived": {
+            "z_extent_um": z_extent_um,
+            "slice_spacing_um": slice_spacing_um,
+            "z_min_um": piezo_center - piezo_amplitude,
+            "z_max_um": piezo_center + piezo_amplitude,
+        },
+        # diSPIM here is scanned-light-sheet only; a future pencil/beam tool
+        # would emit "pencil". See the 3D optical-space view notes.
+        "mode": "sheet",
+        "ts": time.time(),
+    }
+    agent.last_scan_geometry = payload
+    get_event_bus().publish(
+        event_type=EventType.SCAN_GEOMETRY_UPDATE,
+        data=payload,
+        source="acquisition-tools",
+    )
+
+
 @tool(
     name="acquire_volume",
     description="""Acquire a single 3D lightsheet volume for a specific embryo. Moves to embryo
@@ -88,6 +146,23 @@ async def acquire_volume(
                 piezo_amplitude = piezo_amplitude + (additional_buffer_um * abs(slope) / 100.0)
                 z_buffer_applied = z_buffer_um
 
+        # Publish the resolved scan geometry for the 3D optical-space view.
+        # Telemetry only — must never break the acquisition.
+        try:
+            _publish_scan_geometry(
+                agent,
+                embryo_id=embryo_id,
+                stage_position=pos,
+                num_slices=num_slices,
+                exposure_ms=exposure_ms,
+                galvo_amplitude=galvo_amplitude,
+                galvo_center=galvo_center,
+                piezo_amplitude=piezo_amplitude,
+                piezo_center=piezo_center,
+            )
+        except Exception:
+            logger.debug("SCAN_GEOMETRY_UPDATE publish failed", exc_info=True)
+
         result = await client.acquire_volume(
             num_slices=num_slices,
             exposure_ms=exposure_ms,
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 09edd389..d3ab0e7a 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -86,6 +86,7 @@ class EventType(Enum):
     DEVICE_STATE_UPDATE = auto()  # Periodic device-state snapshot from device layer
     BOTTOM_CAMERA_FRAME = auto()  # Live JPEG frame from the bottom camera stream
     EMBRYOS_UPDATE = auto()  # Full embryo list snapshot from agent.experiment
+    SCAN_GEOMETRY_UPDATE = auto()  # Scan cuboid + light-sheet mode for the 3D optical-space view
 
     # Python logging.LogRecord republished onto the bus so the Events page
     # surfaces what would otherwise only land in the terminal. See
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 93d49451..a609526a 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -214,6 +214,48 @@ async def get_coverslip():
             }
         }
 
+    @router.get("/api/devices/scan_geometry")
+    async def get_scan_geometry():
+        """Return the most recent scan geometry for the 3D optical-space view.
+
+        SCAN_GEOMETRY_UPDATE is published only when a volume is acquired, so a
+        page opened before the first acquisition would have no cuboid to draw.
+        This serves the last emitted payload (stashed on the agent by
+        acquisition_tools._publish_scan_geometry), or nominal defaults so the
+        scene is never empty.
+        """
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        last = getattr(agent, "last_scan_geometry", None) if agent else None
+        if isinstance(last, dict):
+            return last
+        # Nominal defaults (calibration defaults; no acquisition yet).
+        num_slices = 50
+        piezo_amplitude = 25.0
+        piezo_center = 50.0
+        z_extent = 2.0 * piezo_amplitude
+        return {
+            "embryo_id": None,
+            "stage_position_um": {"x": None, "y": None},
+            "scan": {
+                "num_slices": num_slices,
+                "exposure_ms": 10.0,
+                "galvo_amplitude_deg": 0.5,
+                "galvo_center_deg": 0.0,
+                "piezo_amplitude_um": piezo_amplitude,
+                "piezo_center_um": piezo_center,
+            },
+            "derived": {
+                "z_extent_um": z_extent,
+                "slice_spacing_um": z_extent / (num_slices - 1),
+                "z_min_um": piezo_center - piezo_amplitude,
+                "z_max_um": piezo_center + piezo_amplitude,
+            },
+            "mode": "sheet",
+            "ts": None,
+            "is_default": True,
+        }
+
     @router.get("/api/devices/bottom_camera/status")
     async def get_bottom_camera_status():
         """Return whether the bottom-camera stream bridge is running."""
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index caa1bf48..040b11d1 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -14,7 +14,7 @@
  */
 const DevicesManager = (function () {
     const STALE_AFTER_MS = 4000;
-    const VIEWS = ['map', 'details'];
+    const VIEWS = ['map', 'details', 'optical3d'];
     const SVG_NS = 'http://www.w3.org/2000/svg';
 
     // Status / details DOM
@@ -1500,6 +1500,12 @@ const DevicesManager = (function () {
         if (typeof updateViewButtons === 'function') {
             updateViewButtons('devices-view-switcher', viewName);
         }
+        // The 3D optical-space view owns its own WebGL module. Build it lazily
+        // on first activation (the panel was display:none, so its container had
+        // no size until now); init() is idempotent and resizes on re-entry.
+        if (viewName === 'optical3d' && typeof Occupancy3DManager !== 'undefined') {
+            Occupancy3DManager.init();
+        }
     }
 
     function setupViewSwitcher() {
@@ -1511,6 +1517,7 @@ const DevicesManager = (function () {
             if (e.target.matches('input, textarea, select, [contenteditable]')) return;
             if (e.key === 'm') { e.preventDefault(); switchView('map'); }
             else if (e.key === 'd') { e.preventDefault(); switchView('details'); }
+            else if (e.key === 'v') { e.preventDefault(); switchView('optical3d'); }
         });
     }
 
diff --git a/gently/ui/web/static/js/occupancy3d.js b/gently/ui/web/static/js/occupancy3d.js
new file mode 100644
index 00000000..b9cfb7ee
--- /dev/null
+++ b/gently/ui/web/static/js/occupancy3d.js
@@ -0,0 +1,489 @@
+// ══════════════════════════════════════════════════════════════════════
+//  3D Optical Space — live digital-twin of the addressable imaging volume
+//
+//  Renders the acquisition cuboid (the box of voxels being scanned) with the
+//  live light-sheet plane inside it, plus a Z-neighbourhood reference frame.
+//  An HTML overlay (mode badge + readouts + a top-down minimap) carries the
+//  GLOBAL context: where in the addressable XY stage range this cuboid sits,
+//  and the embryos around it.
+//
+//  Why two representations: the addressable stage XY (~tens of mm), the cuboid
+//  footprint (~hundreds of µm) and the piezo Z range (~µm) differ by ~100x, so
+//  a single literal-scale 3D box would draw the cuboid invisibly small. The 3D
+//  scene therefore stays in one µm scale around the cuboid; the minimap (2D)
+//  handles the much larger stage extent. Some scales are local by design — see
+//  FOV_UM / the outer-frame sizing below.
+//
+//  Data:
+//    DEVICE_STATE_UPDATE  → live Piezo.Position (sheet Z), Galvo.A/B, XYStage,
+//                            and the firmware box (minimap extent).
+//    SCAN_GEOMETRY_UPDATE → cuboid extents, num_slices, pencil/sheet mode.
+//    EMBRYOS_UPDATE       → minimap markers.
+//  Bootstrap via /api/devices/scan_geometry + /api/embryos/current.
+//
+//  Mirrors the DevicesManager IIFE pattern (devices.js) and reuses the
+//  Three.js scaffold + drag-orbit from projection-viewer.js.
+// ══════════════════════════════════════════════════════════════════════
+
+const Occupancy3DManager = (function () {
+    'use strict';
+
+    // --- Tunables / approximations (v1) --------------------------------
+    // Camera FOV footprint of the SPIM cuboid in µm. SPIM is 0.1625 µm/px;
+    // a ~2048px sCMOS ROI ≈ 333 µm. Not currently streamed, so we use a
+    // constant until SCAN_GEOMETRY_UPDATE carries fov_um. (Documented approx.)
+    const FOV_UM = 333.0;
+    const MAX_SLICE_LINES = 30;       // cap drawn slice outlines for perf
+    const COLORS = {
+        outer: 0x33414d,
+        cuboid: 0x14b8c4,
+        cuboidFace: 0x14b8c4,
+        sheet: 0x39d0ff,
+        slice: 0x2a6f78,
+        beam: 0xffd166,
+    };
+
+    // --- Module state --------------------------------------------------
+    let _initialized = false;
+    let _scene = null, _camera = null, _renderer = null, _root = null;
+    let _animationId = null, _resizeObserver = null, _resizeRaf = null, _onLayoutChanged = null;
+    let _isDragging = false, _prevMouse = { x: 0, y: 0 };
+    const _rot = { x: -0.6, y: 0.6 };
+    let _zoom = 1.7;
+
+    // Live data caches
+    let _geom = null;                 // last SCAN_GEOMETRY_UPDATE.data
+    let _firmwareBox = null;          // {x:[min,max], y:[min,max]} µm
+    let _stage = { x: null, y: null };
+    let _piezoZ = null;               // live axial position (µm)
+    let _galvo = { a: null, b: null };
+    let _embryos = [];                // [{x,y,role,id}]
+    let _scaler = null;
+
+    // Scene object handles (rebuilt as geometry changes)
+    let _outerBox = null, _cuboid = null, _cuboidEdges = null;
+    let _sheet = null, _beam = null, _sliceGroup = null;
+
+    // DOM
+    let _container = null, _modeEl = null, _readoutsEl = null, _minimapEl = null, _demoBtn = null;
+    let _demoTimer = null;
+
+    // ===================================================================
+    // Init / scene scaffold
+    // ===================================================================
+    function init() {
+        if (_initialized) { _resize(); return; }
+        if (typeof THREE === 'undefined') {
+            console.warn('[occupancy3d] THREE not loaded');
+            return;
+        }
+        _container = document.getElementById('occ3d-container');
+        _modeEl = document.getElementById('occ3d-mode');
+        _readoutsEl = document.getElementById('occ3d-readouts');
+        _minimapEl = document.getElementById('occ3d-minimap');
+        _demoBtn = document.getElementById('occ3d-demo-btn');
+        if (!_container) return;
+
+        _buildScene();
+        _wireInteraction();
+        if (_demoBtn) _demoBtn.addEventListener('click', toggleDemo);
+
+        // Subscribe to live data (mirror devices.js:1553-1559)
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('DEVICE_STATE_UPDATE', handleDeviceState);
+            ClientEventBus.on('SCAN_GEOMETRY_UPDATE', handleScanGeometry);
+            ClientEventBus.on('EMBRYOS_UPDATE', handleEmbryos);
+        }
+        _bootstrap();
+
+        _initialized = true;
+        _rebuildSceneObjects();
+        _renderReadouts();
+        _renderMinimap();
+        _animate();
+        // Container is 0×0 while the tab is hidden; size once it's visible.
+        requestAnimationFrame(_resize);
+    }
+
+    function _buildScene() {
+        const w = _container.clientWidth || 600;
+        const h = _container.clientHeight || 460;
+
+        _scene = new THREE.Scene();
+        _camera = new THREE.PerspectiveCamera(45, w / h, 0.01, 100);
+        _camera.position.set(0, 0, _zoom);
+
+        _renderer = new THREE.WebGLRenderer({ antialias: true });
+        _renderer.setSize(w, h);
+        _renderer.setClearColor(0x0a0e12);
+        _container.innerHTML = '';
+        _container.appendChild(_renderer.domElement);
+
+        _root = new THREE.Group();
+        _root.rotation.x = _rot.x;
+        _root.rotation.y = _rot.y;
+        _scene.add(_root);
+
+        // Keep the canvas in sync with its container (chat dock / window resize).
+        if (_resizeObserver) _resizeObserver.disconnect();
+        _resizeObserver = new ResizeObserver(() => {
+            if (_resizeRaf) cancelAnimationFrame(_resizeRaf);
+            _resizeRaf = requestAnimationFrame(_resize);
+        });
+        _resizeObserver.observe(_container);
+        if (!_onLayoutChanged) {
+            _onLayoutChanged = () => _resize();
+            window.addEventListener('gently:layout-changed', _onLayoutChanged);
+        }
+    }
+
+    function _resize() {
+        if (!_renderer || !_container) return;
+        const w = _container.clientWidth || 600;
+        const h = _container.clientHeight || 460;
+        if (w === 0 || h === 0) return;
+        _camera.aspect = w / h;
+        _camera.updateProjectionMatrix();
+        _renderer.setSize(w, h);
+    }
+
+    function _wireInteraction() {
+        const el = _renderer.domElement;
+        el.addEventListener('mousedown', (e) => {
+            _isDragging = true; _prevMouse = { x: e.clientX, y: e.clientY };
+        });
+        el.addEventListener('mousemove', (e) => {
+            if (!_isDragging) return;
+            _root.rotation.y += (e.clientX - _prevMouse.x) * 0.01;
+            _root.rotation.x += (e.clientY - _prevMouse.y) * 0.01;
+            _rot.x = _root.rotation.x; _rot.y = _root.rotation.y;
+            _prevMouse = { x: e.clientX, y: e.clientY };
+        });
+        window.addEventListener('mouseup', () => { _isDragging = false; });
+        el.addEventListener('wheel', (e) => {
+            e.preventDefault();
+            _zoom = Math.max(0.4, Math.min(6, _zoom + e.deltaY * 0.002));
+            _camera.position.z = _zoom;
+        }, { passive: false });
+        el.addEventListener('dblclick', () => {
+            _rot.x = -0.6; _rot.y = 0.6; _zoom = 1.7;
+            _root.rotation.x = _rot.x; _root.rotation.y = _rot.y;
+            _camera.position.z = _zoom;
+        });
+    }
+
+    function _animate() {
+        _animationId = requestAnimationFrame(_animate);
+        if (_renderer && _scene && _camera) _renderer.render(_scene, _camera);
+    }
+
+    // ===================================================================
+    // Scene geometry (rebuilt when scan geometry changes)
+    // ===================================================================
+    function _disposeObj(obj) {
+        if (!obj) return;
+        _root.remove(obj);
+        obj.traverse?.((c) => {
+            c.geometry?.dispose?.();
+            if (c.material) (Array.isArray(c.material) ? c.material : [c.material]).forEach(m => m.dispose());
+        });
+        obj.geometry?.dispose?.();
+        if (obj.material) (Array.isArray(obj.material) ? obj.material : [obj.material]).forEach(m => m.dispose());
+    }
+
+    function _currentGeom() {
+        // Fall back to nominal defaults so the scene is never empty.
+        const g = _geom || {};
+        const scan = g.scan || {};
+        const derived = g.derived || {};
+        const piezoCenter = scan.piezo_center_um != null ? scan.piezo_center_um : 50.0;
+        const zExtent = derived.z_extent_um != null ? derived.z_extent_um : 50.0;
+        return {
+            numSlices: scan.num_slices != null ? scan.num_slices : 50,
+            piezoCenter,
+            zExtent,
+            mode: g.mode || 'sheet',
+        };
+    }
+
+    function _rebuildSceneObjects() {
+        if (!_root) return;
+        [_outerBox, _cuboid, _cuboidEdges, _sheet, _beam, _sliceGroup].forEach(_disposeObj);
+        _outerBox = _cuboid = _cuboidEdges = _sheet = _beam = _sliceGroup = null;
+
+        const g = _currentGeom();
+        const fov = FOV_UM;
+        // Outer Z neighbourhood centred on the cuboid so it's always framed.
+        const halfZ = Math.max(g.zExtent * 2.5, 75);
+        const zMin = g.piezoCenter - halfZ;
+        const zMax = g.piezoCenter + halfZ;
+        const halfXY = fov * 1.5;
+
+        _scaler = makeSceneScaler({
+            xRange: [-halfXY, halfXY],
+            yRange: [-halfXY, halfXY],
+            zRange: [zMin, zMax],
+        });
+        const L = (um) => _scaler.scaleLen(um);
+        const Z = (um) => _scaler.toScene(um, 'z');
+
+        // --- Outer reference frame (addressable Z × local XY) ----------
+        _outerBox = new THREE.LineSegments(
+            new THREE.EdgesGeometry(new THREE.BoxGeometry(L(2 * halfXY), L(zMax - zMin), L(2 * halfXY))),
+            new THREE.LineBasicMaterial({ color: COLORS.outer })
+        );
+        _outerBox.position.y = Z(g.piezoCenter); // box centred on its own midpoint == piezoCenter
+        _root.add(_outerBox);
+
+        // --- Acquisition cuboid (footprint × z-extent) -----------------
+        // Three.js Y is our axial (Z µm) axis; X/Z are the lateral footprint.
+        const cw = L(fov), cd = L(fov), ch = L(g.zExtent);
+        _cuboid = new THREE.Mesh(
+            new THREE.BoxGeometry(cw, ch, cd),
+            new THREE.MeshBasicMaterial({
+                color: COLORS.cuboidFace, transparent: true, opacity: 0.06,
+                depthWrite: false, side: THREE.DoubleSide,
+            })
+        );
+        _cuboid.position.y = Z(g.piezoCenter);
+        _root.add(_cuboid);
+        _cuboidEdges = new THREE.LineSegments(
+            new THREE.EdgesGeometry(new THREE.BoxGeometry(cw, ch, cd)),
+            new THREE.LineBasicMaterial({ color: COLORS.cuboid })
+        );
+        _cuboidEdges.position.y = Z(g.piezoCenter);
+        _root.add(_cuboidEdges);
+
+        // --- Slice planes (faint outlines through the cuboid) ----------
+        _sliceGroup = new THREE.Group();
+        const n = Math.max(1, Math.min(g.numSlices, MAX_SLICE_LINES));
+        const sliceMat = new THREE.LineBasicMaterial({ color: COLORS.slice, transparent: true, opacity: 0.5 });
+        for (let i = 0; i < n; i++) {
+            const frac = n === 1 ? 0.5 : i / (n - 1);
+            const zUm = (g.piezoCenter - g.zExtent / 2) + frac * g.zExtent;
+            const ring = new THREE.LineLoop(_rectXZ(cw, cd), sliceMat);
+            ring.position.y = Z(zUm);
+            _sliceGroup.add(ring);
+        }
+        _root.add(_sliceGroup);
+
+        // --- Light sheet / pencil beam ---------------------------------
+        if (g.mode === 'pencil') {
+            // Pencil: a thin beam along the lateral axis through cuboid centre.
+            _beam = new THREE.LineSegments(
+                new THREE.BufferGeometry().setFromPoints([
+                    new THREE.Vector3(-cw / 2, 0, 0), new THREE.Vector3(cw / 2, 0, 0),
+                ]),
+                new THREE.LineBasicMaterial({ color: COLORS.beam })
+            );
+            _root.add(_beam);
+        } else {
+            _sheet = new THREE.Mesh(
+                new THREE.PlaneGeometry(cw, cd),
+                new THREE.MeshBasicMaterial({
+                    color: COLORS.sheet, transparent: true, opacity: 0.35,
+                    side: THREE.DoubleSide, depthWrite: false,
+                })
+            );
+            _sheet.rotation.x = -Math.PI / 2; // lie in the lateral (X-Z) plane
+            _root.add(_sheet);
+        }
+        _updateSheetPosition();
+    }
+
+    // A rectangle outline in the lateral (X-Z) plane, centred at origin.
+    function _rectXZ(w, d) {
+        const hw = w / 2, hd = d / 2;
+        return new THREE.BufferGeometry().setFromPoints([
+            new THREE.Vector3(-hw, 0, -hd), new THREE.Vector3(hw, 0, -hd),
+            new THREE.Vector3(hw, 0, hd), new THREE.Vector3(-hw, 0, hd),
+        ]);
+    }
+
+    // Move the sheet/beam to the live axial position (piezo µm), clamped to
+    // the cuboid extent. Falls back to the cuboid centre when no live value.
+    function _updateSheetPosition() {
+        if (!_scaler) return;
+        const g = _currentGeom();
+        const zMin = g.piezoCenter - g.zExtent / 2;
+        const zMax = g.piezoCenter + g.zExtent / 2;
+        let zUm = _piezoZ != null ? _piezoZ : g.piezoCenter;
+        zUm = Math.max(zMin, Math.min(zMax, zUm));
+        const y = _scaler.toScene(zUm, 'z');
+        if (_sheet) _sheet.position.y = y;
+        if (_beam) _beam.position.y = y;
+    }
+
+    // ===================================================================
+    // Event handlers
+    // ===================================================================
+    function handleDeviceState(payload) {
+        if (!payload) return;
+        const pos = payload.positions || {};
+        for (const name of Object.keys(pos)) {
+            const e = pos[name] || {};
+            if (e.kind === 'xy_stage') {
+                if (e.X != null) _stage.x = e.X;
+                if (e.Y != null) _stage.y = e.Y;
+            } else if (e.kind === 'piezo') {
+                if (e.Position != null) _piezoZ = e.Position;
+            } else if (e.kind === 'galvo') {
+                if (e.A != null) _galvo.a = e.A;
+                if (e.B != null) _galvo.b = e.B;
+            }
+        }
+        const box = extractFirmwareBox(payload.properties);
+        if (box) _firmwareBox = box;
+        _updateSheetPosition();
+        _renderReadouts();
+        _renderMinimap();
+    }
+
+    function handleScanGeometry(payload) {
+        if (!payload) return;
+        _geom = payload;
+        if (payload.stage_position_um) {
+            if (payload.stage_position_um.x != null) _stage.x = payload.stage_position_um.x;
+            if (payload.stage_position_um.y != null) _stage.y = payload.stage_position_um.y;
+        }
+        _rebuildSceneObjects();
+        _renderReadouts();
+        _renderMinimap();
+    }
+
+    function handleEmbryos(payload) {
+        if (!payload || !Array.isArray(payload.embryos)) return;
+        _embryos = payload.embryos.map((e) => {
+            const fine = e.position_fine || {};
+            const coarse = e.position_coarse || {};
+            const x = fine.x != null ? fine.x : coarse.x;
+            const y = fine.y != null ? fine.y : coarse.y;
+            return { x, y, role: e.role, id: e.id };
+        }).filter((e) => e.x != null && e.y != null);
+        _renderMinimap();
+    }
+
+    async function _bootstrap() {
+        try {
+            const r = await fetch('/api/devices/scan_geometry');
+            if (r.ok) handleScanGeometry(await r.json());
+        } catch (_) { /* offline — demo button covers it */ }
+        try {
+            const r = await fetch('/api/embryos/current');
+            if (r.ok) handleEmbryos(await r.json());
+        } catch (_) { /* ignore */ }
+    }
+
+    // ===================================================================
+    // HTML overlay: mode badge, readouts, minimap
+    // ===================================================================
+    function _fmt(v, digits = 1, unit = '') {
+        return v == null ? '—' : (Number(v).toFixed(digits) + unit);
+    }
+
+    function _renderReadouts() {
+        const g = _currentGeom();
+        if (_modeEl) {
+            _modeEl.textContent = g.mode === 'pencil' ? 'PENCIL' : 'SHEET';
+            _modeEl.classList.toggle('is-pencil', g.mode === 'pencil');
+        }
+        if (!_readoutsEl) return;
+        const scan = (_geom && _geom.scan) || {};
+        const derived = (_geom && _geom.derived) || {};
+        const rows = [
+            ['stage X', _fmt(_stage.x, 0, ' µm')],
+            ['stage Y', _fmt(_stage.y, 0, ' µm')],
+            ['piezo Z', _fmt(_piezoZ, 1, ' µm')],
+            ['galvo A/B', `${_fmt(_galvo.a, 3)} / ${_fmt(_galvo.b, 3)}°`],
+            ['slices', scan.num_slices != null ? String(scan.num_slices) : '—'],
+            ['Z extent', _fmt(derived.z_extent_um, 1, ' µm')],
+            ['slice step', _fmt(derived.slice_spacing_um, 3, ' µm')],
+        ];
+        _readoutsEl.innerHTML = rows
+            .map(([k, v]) => `<div class="occ3d-row"><span>${k}</span><b>${escapeHtml(v)}</b></div>`)
+            .join('');
+    }
+
+    function _renderMinimap() {
+        if (!_minimapEl) return;
+        const VB = { w: 200, h: 120, pad: 8 };
+        const box = _firmwareBox || { x: [-25000, 25000], y: [-12000, 12000] };
+        const bw = box.x[1] - box.x[0], bh = box.y[1] - box.y[0];
+        if (!(bw > 0 && bh > 0)) return;
+        const sx = (VB.w - 2 * VB.pad) / bw;
+        const sy = (VB.h - 2 * VB.pad) / bh;
+        const s = Math.min(sx, sy);
+        const ox = VB.pad + (VB.w - 2 * VB.pad - bw * s) / 2;
+        const oy = VB.pad + (VB.h - 2 * VB.pad - bh * s) / 2;
+        const px = (x) => ox + (x - box.x[0]) * s;
+        const py = (y) => oy + (box.y[1] - y) * s; // flip Y for screen
+
+        const parts = [];
+        parts.push(`<rect x="${ox.toFixed(1)}" y="${oy.toFixed(1)}" width="${(bw * s).toFixed(1)}" height="${(bh * s).toFixed(1)}" class="occ3d-mm-box"/>`);
+        for (const e of _embryos) {
+            parts.push(`<circle cx="${px(e.x).toFixed(1)}" cy="${py(e.y).toFixed(1)}" r="2" class="occ3d-mm-embryo"/>`);
+        }
+        if (_stage.x != null && _stage.y != null) {
+            const fovPx = FOV_UM * s;
+            parts.push(`<rect x="${(px(_stage.x) - fovPx / 2).toFixed(1)}" y="${(py(_stage.y) - fovPx / 2).toFixed(1)}" width="${Math.max(fovPx, 3).toFixed(1)}" height="${Math.max(fovPx, 3).toFixed(1)}" class="occ3d-mm-cuboid"/>`);
+            parts.push(`<circle cx="${px(_stage.x).toFixed(1)}" cy="${py(_stage.y).toFixed(1)}" r="2.5" class="occ3d-mm-stage"/>`);
+        }
+        _minimapEl.innerHTML = parts.join('');
+    }
+
+    // ===================================================================
+    // Demo driver — develop without live hardware (launch_gently.py --offline)
+    // ===================================================================
+    function toggleDemo() {
+        if (_demoTimer) {
+            clearInterval(_demoTimer); _demoTimer = null;
+            if (_demoBtn) _demoBtn.classList.remove('is-on');
+            return;
+        }
+        if (_demoBtn) _demoBtn.classList.add('is-on');
+        // Seed a firmware box, a scan geometry, and a few embryos.
+        _firmwareBox = { x: [-25000, 25000], y: [-12000, 12000] };
+        handleScanGeometry({
+            embryo_id: 'demo_2',
+            stage_position_um: { x: 4200, y: -1800 },
+            scan: {
+                num_slices: 60, exposure_ms: 5.0,
+                galvo_amplitude_deg: 0.5, galvo_center_deg: 0.0,
+                piezo_amplitude_um: 25.0, piezo_center_um: 50.0,
+            },
+            derived: { z_extent_um: 50.0, slice_spacing_um: 50 / 59, z_min_um: 25, z_max_um: 75 },
+            mode: 'sheet', ts: 0,
+        });
+        handleEmbryos({
+            embryos: [
+                { id: 'demo_1', role: 'test', position_coarse: { x: 4200, y: -1800 } },
+                { id: 'demo_2', role: 'control', position_coarse: { x: -8000, y: 5200 } },
+                { id: 'demo_3', role: 'test', position_coarse: { x: 12000, y: 2400 } },
+            ],
+        });
+        // Sweep the sheet in Z to animate the plane.
+        let t = 0;
+        _demoTimer = setInterval(() => {
+            t += 0.08;
+            const g = _currentGeom();
+            _piezoZ = g.piezoCenter + (g.zExtent / 2) * Math.sin(t);
+            _galvo.a = 0.5 * Math.sin(t);
+            _updateSheetPosition();
+            _renderReadouts();
+        }, 60);
+    }
+
+    function cleanup() {
+        if (_animationId) cancelAnimationFrame(_animationId);
+        if (_demoTimer) { clearInterval(_demoTimer); _demoTimer = null; }
+        if (_resizeObserver) _resizeObserver.disconnect();
+        if (_renderer) { _renderer.dispose(); }
+    }
+
+    return { init, cleanup, toggleDemo, handleDeviceState, handleScanGeometry, handleEmbryos };
+})();
+
+document.addEventListener('DOMContentLoaded', () => {
+    // Build lazily on first tab activation (container is 0×0 while hidden),
+    // so init() is invoked from app.js switchTab(), not here.
+});
diff --git a/gently/ui/web/static/js/utils.js b/gently/ui/web/static/js/utils.js
index 4b8ff62b..8b4a3d79 100644
--- a/gently/ui/web/static/js/utils.js
+++ b/gently/ui/web/static/js/utils.js
@@ -5,6 +5,66 @@
 // Tab and view name constants
 const TABS = { HOME: 'home', EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment' };
 
+/**
+ * Extract the XY firmware fence (the addressable stage box) from a device-state
+ * properties map. The ASI adapter exposes LowerLimX/UpperLimX/LowerLimY/
+ * UpperLimY in mm; we convert to µm. Single source of truth for both the 2D
+ * devices map and the 3D optical-space view.
+ *
+ * @param {Object} propsByDevice - payload.properties from DEVICE_STATE_UPDATE
+ * @returns {{x:[number,number], y:[number,number]}|null}
+ */
+function extractFirmwareBox(propsByDevice) {
+    if (!propsByDevice) return null;
+    for (const name of Object.keys(propsByDevice)) {
+        const p = propsByDevice[name] || {};
+        const xMinMm = parseFloat(p['LowerLimX(mm)']);
+        const xMaxMm = parseFloat(p['UpperLimX(mm)']);
+        const yMinMm = parseFloat(p['LowerLimY(mm)']);
+        const yMaxMm = parseFloat(p['UpperLimY(mm)']);
+        if (isFinite(xMinMm) && isFinite(xMaxMm) &&
+            isFinite(yMinMm) && isFinite(yMaxMm)) {
+            return {
+                x: [xMinMm * 1000, xMaxMm * 1000],   // mm → µm
+                y: [yMinMm * 1000, yMaxMm * 1000],
+            };
+        }
+    }
+    return null;
+}
+
+/**
+ * Build a coordinate mapper from device microns to Three.js scene units.
+ * Centers each axis on its range midpoint and divides by the LARGEST span so
+ * the whole scene fits a ~[-0.5, 0.5] cube while keeping axes proportional
+ * (anisotropic Z vs XY preserved). Returns helpers used by all scene objects
+ * so a single scale governs geometry and camera distance.
+ *
+ * @param {{xRange:[number,number], yRange:[number,number], zRange:[number,number]}} ranges (µm)
+ */
+function makeSceneScaler(ranges) {
+    const xc = (ranges.xRange[0] + ranges.xRange[1]) / 2;
+    const yc = (ranges.yRange[0] + ranges.yRange[1]) / 2;
+    const zc = (ranges.zRange[0] + ranges.zRange[1]) / 2;
+    const xs = Math.abs(ranges.xRange[1] - ranges.xRange[0]);
+    const ys = Math.abs(ranges.yRange[1] - ranges.yRange[0]);
+    const zs = Math.abs(ranges.zRange[1] - ranges.zRange[0]);
+    const maxExtent = Math.max(xs, ys, zs, 1e-6);
+    return {
+        maxExtent,
+        center: { x: xc, y: yc, z: zc },
+        // Map an absolute µm position on one axis into scene space.
+        toScene(um, axis) {
+            const c = axis === 'x' ? xc : axis === 'y' ? yc : zc;
+            return (um - c) / maxExtent;
+        },
+        // Map a µm length (span) into scene units (no centering).
+        scaleLen(um) {
+            return um / maxExtent;
+        },
+    };
+}
+
 /**
  * HTML-escape a string (safe for insertion into innerHTML).
  * Uses the browser's built-in text node escaping.
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index e83eda63..3e704938 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -417,6 +417,7 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     <div class="view-switcher" id="devices-view-switcher">
                         <button class="view-btn active" data-view="map" title="XY Map (m)">Map</button>
                         <button class="view-btn" data-view="details" title="Details (d)">Details</button>
+                        <button class="view-btn" data-view="optical3d" title="3D volume (v)">3D</button>
                     </div>
                 </div>
                 <div class="devices-status">
@@ -648,6 +649,40 @@ <h3 class="devices-properties-title">Properties</h3>
                     </div>
                 </div>
             </div>
+
+            <!-- 3D view: live digital-twin of the addressable imaging volume -->
+            <div class="devices-view devices-view-optical3d" id="devices-view-optical3d" style="display:none">
+              <style>
+                .occ3d-wrap { position: relative; width: 100%; height: calc(100vh - 200px); min-height: 420px; }
+                .occ3d-canvas { position: absolute; inset: 0; background: #0a0e12; border-radius: 8px; }
+                .occ3d-overlay { position: absolute; top: 12px; left: 12px; display: flex; flex-direction: column; gap: 10px; pointer-events: none; }
+                .occ3d-overlay > * { pointer-events: auto; }
+                .occ3d-mode { align-self: flex-start; font: 600 12px/1 'Inter Tight', system-ui, sans-serif; letter-spacing: .08em; color: #39d0ff; border: 1px solid #39d0ff; border-radius: 4px; padding: 5px 9px; background: rgba(10,14,18,.7); }
+                .occ3d-mode.is-pencil { color: #ffd166; border-color: #ffd166; }
+                .occ3d-readouts { font: 12px/1.5 ui-monospace, monospace; color: #cdd6df; background: rgba(10,14,18,.7); border: 1px solid #1f2a33; border-radius: 6px; padding: 8px 10px; min-width: 172px; }
+                .occ3d-row { display: flex; justify-content: space-between; gap: 14px; }
+                .occ3d-row span { color: #7d8b97; }
+                .occ3d-row b { color: #e7eef4; font-weight: 600; }
+                .occ3d-minimap { width: 200px; height: 120px; background: rgba(10,14,18,.7); border: 1px solid #1f2a33; border-radius: 6px; }
+                .occ3d-mm-box { fill: rgba(51,65,77,.25); stroke: #4a5a66; stroke-width: 1; }
+                .occ3d-mm-cuboid { fill: none; stroke: #14b8c4; stroke-width: 1; }
+                .occ3d-mm-stage { fill: #ff5a4d; }
+                .occ3d-mm-embryo { fill: #6fae46; }
+                .occ3d-hint { font: 11px/1 system-ui, sans-serif; color: #5e6b76; }
+                .occ3d-demo-btn { align-self: flex-start; font: 600 11px/1 system-ui; color: #cdd6df; background: rgba(10,14,18,.7); border: 1px solid #2a3a44; border-radius: 4px; padding: 6px 10px; cursor: pointer; }
+                .occ3d-demo-btn.is-on { color: #39d0ff; border-color: #39d0ff; }
+              </style>
+              <div class="occ3d-wrap">
+                <div id="occ3d-container" class="occ3d-canvas"></div>
+                <div class="occ3d-overlay">
+                  <div class="occ3d-mode" id="occ3d-mode">SHEET</div>
+                  <div class="occ3d-readouts" id="occ3d-readouts"></div>
+                  <svg class="occ3d-minimap" id="occ3d-minimap" viewBox="0 0 200 120" preserveAspectRatio="xMidYMid meet"></svg>
+                  <button class="occ3d-demo-btn" id="occ3d-demo-btn">▶ Demo (no hardware)</button>
+                  <div class="occ3d-hint">drag rotate · wheel zoom · dbl-click reset</div>
+                </div>
+              </div>
+            </div>
         </div>
     </div>
 
@@ -748,6 +783,7 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/experiment-overview.js"></script>
     <!-- Three.js for 3D volume viewer -->
     <script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>
+    <script src="/static/js/occupancy3d.js"></script>
     <script src="/static/js/app.js"></script>
     <script src="/static/js/home.js"></script>
     <script src="/static/js/campaigns.js"></script>
diff --git a/screenshots/occupancy3d-demo.png b/screenshots/occupancy3d-demo.png
new file mode 100644
index 0000000000000000000000000000000000000000..d76885724a4a54650e4e917f0f7359c5ec71be5b
GIT binary patch
literal 244754
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
TrFVG4Cmh;Z274avatQi=n=0Ej

literal 0
HcmV?d00001


From 91ec6d2f5befd489b007c35ddbca8660c8412afe Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 06:59:57 +0530
Subject: [PATCH 110/314] docs: UX v2 interaction-flow / IA audit
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Flow/IA audit (not visual) from a live click-audit with the agent on, plus
code cross-check. Prioritized findings + fixes: P0 loading-state legibility
(stream thinking summary — set thinking display:summarized + handle
thinking_delta), first-character truncation in the plan feed, control/auth
wall hidden in chat, double ask-mount, ASK_CLEARED never emitted, no path
back to welcome, non-stateful routing, resume hard-reload, and the
workspace-IA placement of the 3D optical-space view.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/ux-v2-flow-audit.md | 106 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 docs/ux-v2-flow-audit.md

diff --git a/docs/ux-v2-flow-audit.md b/docs/ux-v2-flow-audit.md
new file mode 100644
index 00000000..00bba3e7
--- /dev/null
+++ b/docs/ux-v2-flow-audit.md
@@ -0,0 +1,106 @@
+# UX v2 — interaction-flow / IA audit
+
+**Branch:** `feature/ux-v2` (now includes the 3D optical-space view).
+**Scope:** the *flow* of the agent-first UI — clicks, how each step renders, how the
+workspace is unveiled, moving back/forth between views, resume — **not** the visual look
+(the look is fine). Plus where the 3D optical-space view belongs in the new workspace IA.
+
+**Method:** live click-audit driven through a real browser as a *dev biologist* would use
+it, with the agent **live** (Opus 4.8, `--offline` hardware, `GENTLY_NO_AUTH=1` single
+controller), cross-checked against the code. Screenshots from the run are in `screenshots/audit-*.png`.
+
+> Correction to an earlier automated pass: the plan-wizard helpers
+> (`buildAskCard`/`answerChoice`/`togglePanel`) are **not** missing — `agent-chat.js`
+> exports them and the module loads; the plan wizard works. The real issues are below.
+
+---
+
+## What works (keep it)
+
+- **The forward path is good.** Entry → one calm choice (Plan / Quick look / "just tell me")
+  → overlay dismisses to reveal the workspace → grouped rail (NOW / LIBRARY / SYSTEM) drives
+  everything through one chokepoint (`app.js switchTab`). The welcome→workspace unveil is genuinely nice.
+- **The agent-driven plan wizard is strong.** Live, it asked a well-framed scientific question
+  ("What's the core scientific question this run should capture?") with real C. elegans options,
+  ran a `query_lab_history` tool with visible provenance, and **assembled THE PLAN panel as each
+  answer landed** (strain → wavelengths, etc.). The "plan builds as you answer" feel is excellent.
+- **The dual-render** (ask shows in the plan stage *and* the chat transcript) is implemented.
+
+---
+
+## Findings (prioritized)
+
+| # | Pri | Symptom (felt) | Root cause / evidence | Fix |
+|---|-----|----------------|------------------------|-----|
+| 1 | **P0** | First plan step sat on "working through the next step…" for **~90s** with a static spinner — feels hung. | The wait is the model *thinking*. The streaming call requests **no thinking config** and the stream loop reads only text deltas. `conversation.py:272-275` (only `output_config.effort`), `conversation.py:654-657` (only `event.delta.text`). | Set `thinking={"type":"adaptive","display":"summarized"}` on the stream (`conversation.py:552`); handle `thinking_delta` in the loop (`:654`) and emit as a `thinking` activity; render it live + add an elapsed timer. See §1. |
+| 2 | **P1** | Agent's first line renders as **"'d love to help…"** — leading "I" dropped. | Plan-feed streaming path drops the first character of the turn's first text block; the chat transcript renders it correctly (`12_41` vs `12_3` in the run). Plan feed: `landing.js applyActivity` `'text'` case (`:269`). | Most likely the first `AGENT_ACTIVITY`/`text` delta is missed by `landing.js`'s listener (subscribed after the first delta) or coalesced wrong. Confirm with a 1-line repro; the transcript path is the reference. |
+| 3 | **P1** | Clicked the primary "Plan an experiment" → plan stage spun forever; the *real* blocker ("Viewing only — control is held by another client / sign in to control") was **hidden in the chat panel**. | Control/auth state isn't surfaced on the landing/plan surface — only in the chat dock. A viewer can enter the plan flow and dead-end. | Surface control/sign-in state on the landing **before** the primary CTA; gate or relabel "Plan an experiment" when `!hasControl`; show the wall on the plan stage, not just chat. |
+| 4 | **P1** | (Structural) The same ask renders in **two** stage mounts plus the transcript. | `#v2-plan-ask` **and** `#ask-stage` both render the ask (the overlay covers the workspace copy, so only cosmetic/perf today). Two live regions seen in the run (`12_10` + `12_24`). | One stage mount at a time — suppress `#ask-stage` while the landing overlay owns the ask. |
+| 5 | **P1** | Cross-surface clear can desync. | `ASK_CLEARED` is **listened for but emitted nowhere** (`landing.js:624`, `ask-stage.js:43` listen; no emit in repo). Answering works locally because `renderAsk.onPick` clears directly, but stage↔transcript sync relies on the missing signal. | Emit `ASK_CLEARED` the instant a `choice_response` is sent (per the migration plan's Phase-1 blocker), plus on cancel/control-loss/socket-close. |
+| 6 | **P1** | **No way back.** Once the landing dismisses, there's no path back to welcome / "start a new plan" from the workspace — must reload. | `dismiss()` is one-way (`landing.js:42-54`); `V2Landing.show()` exists but is never called from the workspace. | Add a "New plan" / "Talk to Gently" entry in the rail or header that re-summons the welcome/plan surface. |
+| 7 | **P2** | Browser **Back / refresh don't mean anything**; refresh mid-plan loses state and may re-show the landing. | Entry hash is consumed (`app.js` → `replaceState('/')`, ~`:650-662`); no deliberate URL/state sync; in-memory plan state (`planKickedOff`, feed pages) resets on reload. | Real routing: sync screen/tab to URL/History so Back/forward/refresh resolve; persist or re-hydrate plan progress. |
+| 8 | **P2** | **Resume = full page reload** — jarring, re-shows landing, drops chat position. | `session_changed` → `window.location.href='/'` (`websocket.js:147`; `review.js resumeSession ~:101-116`). Flagged in the migration plan. | In-place re-hydration on `session_changed` instead of a hard reload. |
+| 9 | **P1 (IA)** | The **3D optical-space view is buried**: SYSTEM → Devices → (Map / Details / **3D**) — a sub-sub-toggle. | It was integrated into the *legacy* Devices tab structure; the ux-v2 grouped rail doesn't surface it. | Promote "the scope in space" to a first-class run-time surface (NOW tier), reconciled with the grouped rail. See §2. |
+| 10 | **P2** | Offline / agent-silent dead-ends the wizard at "working…". | `startPlan` campaign fetch falls through silently if offline (`landing.js ~:502-508`); no error path. | Timeout + inline error/retry on the plan stage. |
+
+---
+
+## §1 — Make the loading state legible (P0, the one the user wants first)
+
+The 90s "working…" is the agent reasoning. The Claude streaming API exposes this on three
+channels; gently currently surfaces none of the reasoning:
+
+- **Thinking** — `content_block_delta` → `thinking_delta`. **Opus 4.8 defaults to
+  `display:"omitted"` (empty thinking text)**, and gently doesn't set the thinking config at
+  all on the stream, so there's nothing to show. Unlock: `thinking={"type":"adaptive","display":"summarized"}`.
+- **Tool activity** — `input_json_delta` + tool start/stop. **Already flowing** — the plan feed
+  renders tool cards (saw the `query_lab_history` card with input/result).
+- **Text** — `text_delta`. Already flowing (this is the path with the bug #2 truncation).
+
+**Backend (`gently/harness/conversation.py`):**
+1. `:552` `self.claude.messages.stream(...)` — add `thinking={"type":"adaptive","display":"summarized"}`
+   (keep `output_config.effort`).
+2. `:654` event loop — currently only `if hasattr(event.delta, "text")`. Add a branch for
+   `event.delta.type == "thinking_delta"` → `yield {"type":"thinking","text": event.delta.thinking}`.
+
+**Frontend (`gently/ui/web/static/js/landing.js`):** `applyActivity` already has a `thinking`
+case (`:266`) that only sets a static label — render the streamed thinking text instead, and add
+an elapsed timer to `#v2-plan-thinking` so a long think reads as progress, not a hang.
+
+Net: the reasoning summary + current tool + a timer fill the wait. Only the backend `display`
+flag is a new capability; the rest is surfacing data gently already receives.
+
+---
+
+## §2 — Workspace organization & where the 3D view belongs (P1, IA)
+
+The ux-v2 workspace is organized differently from the old flat tab bar: a **grouped rail**
+(NOW: Home/Experiment/Embryos · LIBRARY: Plans/Sessions · SYSTEM: Devices/Calibration/Logs),
+a **session-context strip**, and the **AGENT'S VIEW** surface. The 3D optical-space view,
+however, lives in the *legacy* Devices structure (`devices.js switchView`, VIEWS =
+`['map','details','optical3d']`; `index.html` devices-content Map/Details/3D switcher).
+
+During an actual run, "where the scope is in space" + the live experiment + the agent's view are
+**NOW-tier** concerns, not a System utility three clicks deep. Proposal (to design next):
+- Promote the 3D optical-space + live experiment to a first-class run-time surface in the rail
+  (or make it the default workspace view while a run is active).
+- Keep the Devices Map/Details as the System-tier hardware utility; the 3D "scope in space"
+  graduates out of that toggle.
+
+---
+
+## Recommended sequencing
+
+1. **P0 loading state** (§1) — highest felt value, mostly surfacing existing data.
+2. **P1 quick correctness**: #2 truncation, #3 control-wall surfacing, #4 single ask mount, #5 `ASK_CLEARED` emit.
+3. **P1 reachability**: #6 "new plan"/back entry; then #9 the workspace-IA / 3D-placement redesign (its own design pass).
+4. **P2 navigation**: #7 real routing, #8 resume re-hydration, #10 offline error path.
+
+---
+
+## Notes / housekeeping
+
+- Findings 1–5, 10 verified live with the agent on; 6–9 verified from code + the live rail.
+- `screenshots/audit-*.png` (live run) and `screenshots/uxv2-*.png` are local evidence (untracked).
+- The earlier visual-design exploration (`docs/superpowers/mockups/`, `screenshots/dir-*.png`) is
+  superseded — the look is staying as-is — and can be deleted.

From 9edb766255720b0e50c3d1e63d97d77955b18da3 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 07:20:37 +0530
Subject: [PATCH 111/314] UX v2 P0: live-stream the agent turn + show reasoning
 during the wait
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The streaming path collected the entire turn before yielding anything, so the
plan wizard sat on a static "working…" spinner for the whole turn (~90s). And
the streamed call requested no thinking, so there was no reasoning to show even
if it had streamed.

- conversation.py: rewrite call_claude_stream to stream live — a worker thread
  drains the SDK stream and pushes events onto an asyncio queue as they arrive;
  the coroutine yields text/thinking deltas in real time. Enable adaptive
  thinking with display="summarized" (+ effort=medium) and emit thinking_delta
  as {"type":"thinking"} chunks. Full assistant content (incl. thinking blocks)
  is still replayed from final_message, so the tool loop stays valid. Retry /
  400-fallback / refusal-fallback preserved (clean while nothing's been yielded).
- agent-chat.js: forward the thinking text on the 'thinking' activity.
- landing.js: render streamed reasoning as a dim block in the plan feed and add
  an elapsed-time counter to the thinking indicator so a long think reads as
  progress, not a hang.

Verified live (Opus 4.8): reasoning + prose stream into the plan feed during the
turn with a ticking timer; no console errors.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/conversation.py        | 190 +++++++++++++++++---------
 gently/ui/web/static/js/agent-chat.js | Bin 63820 -> 63846 bytes
 gently/ui/web/static/js/landing.js    |  63 ++++++++-
 3 files changed, 178 insertions(+), 75 deletions(-)

diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 6ba26262..067e2f85 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -546,80 +546,142 @@ async def call_claude_stream(self, system_prompt, tools, tool_label_fn, auto_sav
         """
         from anthropic import APIStatusError, BadRequestError
 
-        def stream_and_collect(model):
-            def _run(m):
-                events = []
-                with self.claude.messages.stream(
-                    model=m,
-                    system=system_prompt,
-                    messages=self.conversation_history,
-                    tools=tools,
-                    max_tokens=4096,
-                ) as stream:
-                    for event in stream:
-                        events.append(event)
-                    return events, stream.get_final_message()
-
-            try:
-                return _run(model)
-            except BadRequestError:
-                # Fable 5 under <30-day org data retention (or unavailable) rejects
-                # with a 400 — fall back to Opus 4.8 so the turn still streams.
-                fb = settings.models.refusal_fallback
-                if not fb or fb == model:
-                    raise
-                logger.warning(
-                    "Stream model %s rejected the request (400); falling back to %s", model, fb
-                )
-                return _run(fb)
+        # Live streaming: a worker thread drains the SDK's (blocking) stream and
+        # pushes each event onto an asyncio queue as it arrives, so this coroutine
+        # can yield text/thinking deltas in real time instead of collecting the
+        # whole turn first (which left the UI on a blank spinner for the entire
+        # turn). thinking=summarized surfaces the model's reasoning during the
+        # wait. The full assistant content (incl. thinking blocks) is replayed from
+        # final_message below, so the tool-loop continuation stays valid.
+        _DONE = object()
+
+        async def _stream_live(model, sink):
+            """Stream one attempt live: yield delta dicts as they arrive; record
+            events / final_message / error / full_text into `sink`."""
+            loop = asyncio.get_running_loop()
+            queue: asyncio.Queue = asyncio.Queue()
+            state: dict = {}
+
+            def worker():
+                try:
+                    with self.claude.messages.stream(
+                        model=model,
+                        system=system_prompt,
+                        messages=self.conversation_history,
+                        tools=tools,
+                        max_tokens=16000,
+                        # Adaptive thinking with a streamed, human-readable summary —
+                        # this is what fills the "working…" wait. Opus 4.8 defaults to
+                        # display="omitted" (empty thinking text), so it must be set.
+                        thinking={"type": "adaptive", "display": "summarized"},
+                        output_config={"effort": "medium"},
+                    ) as stream:
+                        for event in stream:
+                            loop.call_soon_threadsafe(queue.put_nowait, event)
+                        state["final"] = stream.get_final_message()
+                except BaseException as exc:  # noqa: BLE001 — re-raised to caller below
+                    state["error"] = exc
+                finally:
+                    loop.call_soon_threadsafe(queue.put_nowait, _DONE)
+
+            task = asyncio.create_task(asyncio.to_thread(worker))
+            events: list = []
+            full_text: list = []
+            while True:
+                item = await queue.get()
+                if item is _DONE:
+                    break
+                events.append(item)
+                if item.type != "content_block_delta":
+                    continue
+                delta = item.delta
+                dtype = getattr(delta, "type", None)
+                if dtype == "thinking_delta":
+                    chunk = getattr(delta, "thinking", "") or ""
+                    if chunk:
+                        yield {"type": "thinking", "text": chunk}
+                elif dtype == "text_delta" or hasattr(delta, "text"):
+                    chunk = getattr(delta, "text", "") or ""
+                    if chunk:
+                        full_text.append(chunk)
+                        yield {"type": "text", "text": chunk}
+            await task
+            sink["events"] = events
+            sink["full_text"] = full_text
+            sink["final"] = state.get("final")
+            sink["error"] = state.get("error")
 
-        # Run streaming in thread with retry logic
         max_retries = 3
         retry_delay = 1.0
+        fb = settings.models.refusal_fallback
+        model_in_use = self.model
+        sink: dict = {}
 
         for attempt in range(max_retries):
-            try:
-                events, final_message = await asyncio.to_thread(stream_and_collect, self.model)
-                self._track_token_usage(final_message)
+            sink = {}
+            yielded_any = False
+            async for chunk in _stream_live(model_in_use, sink):
+                yielded_any = True
+                yield chunk
+            err = sink.get("error")
+            if err is None:
                 break
-            except APIStatusError as e:
-                error_type = getattr(e, "body", {})
+            # Fable 5 under <30-day data retention (or unavailable) rejects with a
+            # 400 — fall back to Opus 4.8. Only safe before any partial was streamed.
+            if isinstance(err, BadRequestError) and fb and fb != model_in_use and not yielded_any:
+                logger.warning(
+                    "Stream model %s rejected the request (400); falling back to %s",
+                    model_in_use,
+                    fb,
+                )
+                model_in_use = fb
+                continue
+            if isinstance(err, APIStatusError):
+                error_type = getattr(err, "body", {})
                 if isinstance(error_type, dict):
                     error_type = error_type.get("error", {}).get("type", "")
-
-                if (
+                overloaded = (
                     error_type in ("overloaded_error", "rate_limit_error")
-                    or "overloaded" in str(e).lower()
-                ):
-                    if attempt < max_retries - 1:
-                        wait_time = retry_delay * (2**attempt)
-                        logger.warning(
-                            f"API overloaded, retrying in {wait_time:.1f}s "
-                            f"(attempt {attempt + 1}/{max_retries})"
-                        )
-                        yield {
-                            "type": "text",
-                            "text": f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n",
-                        }
-                        await asyncio.sleep(wait_time)
-                        continue
-                raise
+                    or "overloaded" in str(err).lower()
+                )
+                if overloaded and attempt < max_retries - 1 and not yielded_any:
+                    wait_time = retry_delay * (2**attempt)
+                    logger.warning(
+                        "API overloaded, retrying in %.1fs (attempt %d/%d)",
+                        wait_time,
+                        attempt + 1,
+                        max_retries,
+                    )
+                    yield {
+                        "type": "text",
+                        "text": f"\n*[API busy, retrying in {wait_time:.0f}s...]*\n",
+                    }
+                    await asyncio.sleep(wait_time)
+                    continue
+            raise err
         else:
             raise RuntimeError("API overloaded after multiple retries")
 
-        # Refusal → retry the whole streamed turn on the fallback model (Opus 4.8)
-        # before giving up. The original partial output is discarded (we re-collect
-        # and only yield the fallback's events below).
-        fb = settings.models.refusal_fallback
-        if final_message.stop_reason == "refusal" and fb and fb != self.model:
-            logger.warning("Model %s declined the streamed turn; retrying on %s", self.model, fb)
-            events, final_message = await asyncio.to_thread(stream_and_collect, fb)
+        final_message = sink["final"]
+        full_text = sink["full_text"]
+        self._track_token_usage(final_message)
+
+        # Refusal → retry on the fallback model. Re-streaming live is only safe when
+        # the refusal came before any visible output (pre-output refusals carry empty
+        # content, so nothing was yielded); otherwise we keep the partial we showed.
+        if final_message.stop_reason == "refusal" and fb and model_in_use != fb and not full_text:
+            logger.warning("Model %s declined the streamed turn; retrying on %s", model_in_use, fb)
+            sink = {}
+            async for chunk in _stream_live(fb, sink):
+                yield chunk
+            model_in_use = fb
+            final_message = sink["final"]
+            full_text = sink["full_text"]
             self._track_token_usage(final_message)
 
-        # Last resort: if even the fallback declined, surface it and stop —
-        # discard any partial, don't iterate empty content or process tools.
+        # Last resort: if even the fallback declined, surface it and stop.
         if final_message.stop_reason == "refusal":
-            logger.warning("Claude declined the request (model=%s)", self.model)
+            logger.warning("Claude declined the request (model=%s)", model_in_use)
             yield {
                 "type": "text",
                 "text": "(The request was declined by the model's safety system. Try rephrasing.)",
@@ -639,7 +701,7 @@ def _run(m):
             len(final_message.content),
             tool_block_count,
             len(tools),
-            self.model,
+            model_in_use,
         )
         if tool_block_count > 0 and final_message.stop_reason != "tool_use":
             logger.error(
@@ -648,14 +710,6 @@ def _run(m):
                 final_message.stop_reason,
             )
 
-        # Process events and yield text
-        full_text = []
-        for event in events:
-            if event.type == "content_block_delta":
-                if hasattr(event.delta, "text"):
-                    full_text.append(event.delta.text)
-                    yield {"type": "text", "text": event.delta.text}
-
         # Detect fake XML tool calls in text (Claude writing tool_use as text)
         joined_text = "".join(full_text)
         if "<tool_use>" in joined_text or "<function_calls>" in joined_text:
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 0e8514df3e603df1220675ba2cff1c2ce566e7d4..58be6e5c13b417fd95d0f16b42ae953a0a0c3467 100644
GIT binary patch
delta 22
ecmX@}iTT+l<_#;uCr^kpnY=HDck_ktnuP$3atpoy

delta 22
ecmaF%iTTVY<_#;uCp)bWnH&%-x%oqQ*+Kw_+6z7a

diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
index bb4a0923..4f0f2917 100644
--- a/gently/ui/web/static/js/landing.js
+++ b/gently/ui/web/static/js/landing.js
@@ -18,6 +18,7 @@ const V2Landing = (() => {
     let el = null;
     let current = null;            // the ask currently in #v2-plan-ask
     let feedTextEl = null;         // current accumulating prose paragraph in the feed
+    let feedThinkingEl = null;     // current accumulating reasoning (thinking) block
     let runningTools = {};         // tool name -> stack of running card elements
     let feedHadContent = false;    // did this turn surface anything in the feed?
     let capturedCampaignId = null; // best-effort id scraped from tool results
@@ -58,10 +59,39 @@ const V2Landing = (() => {
         const l = document.querySelector('#v2-plan-thinking .v2-plan-thinking-label');
         if (l && text) l.textContent = text;
     }
+    // Elapsed-time counter so a long think reads as progress, not a hang. Starts
+    // when the thinking indicator first shows and runs until it's hidden (turn end).
+    let _thinkTimer = null;
+    let _thinkStart = 0;
+    function _thinkTick() {
+        const t = $('v2-plan-thinking');
+        if (!t) return;
+        let el = t.querySelector('.v2-plan-elapsed');
+        if (!el) {
+            el = document.createElement('span');
+            el.className = 'v2-plan-elapsed';
+            el.style.cssText = 'margin-left:6px;opacity:.55;font-variant-numeric:tabular-nums;';
+            t.appendChild(el);
+        }
+        const s = Math.round((Date.now() - _thinkStart) / 1000);
+        el.textContent = s > 0 ? s + 's' : '';
+    }
     function showThinking(on, label) {
         const t = $('v2-plan-thinking');
         if (t) t.classList.toggle('hidden', !on);
         if (on && label) setThinkingLabel(label);
+        if (on) {
+            if (!_thinkTimer) {
+                _thinkStart = Date.now();
+                _thinkTick();
+                _thinkTimer = setInterval(_thinkTick, 1000);
+            }
+        } else if (_thinkTimer) {
+            clearInterval(_thinkTimer);
+            _thinkTimer = null;
+            const el = t && t.querySelector('.v2-plan-elapsed');
+            if (el) el.textContent = '';
+        }
     }
     // Human-readable "what's happening right now" from a tool activity event,
     // so the status line names the live operation instead of a static string.
@@ -106,7 +136,7 @@ const V2Landing = (() => {
                 '<div class="v2-plan-dots v2-feed-dots" hidden></div>';
         }
         feedPages = []; feedPage = 0; curPageEl = null; pendingNewPage = false;
-        feedTextEl = null; runningTools = {}; feedHadContent = false;
+        feedTextEl = null; feedThinkingEl = null; runningTools = {}; feedHadContent = false;
         capturedCampaignId = null;
         hidePlanError();
     }
@@ -260,15 +290,34 @@ const V2Landing = (() => {
         const f = feedEl(); if (!f) return;
         switch (act.kind) {
             case 'turn_start':
-                feedTextEl = null; pendingNewPage = true; hidePlanError(); clearFallback();
+                feedTextEl = null; feedThinkingEl = null; pendingNewPage = true; hidePlanError(); clearFallback();
                 showThinking(true, 'reviewing your campaign and plan…');
                 break;
-            case 'thinking':
-                showThinking(true, 'thinking through the next step…');
+            case 'thinking': {
+                // Stream the model's reasoning summary live into the feed as a dim
+                // block, so the wait shows what the agent is actually considering.
+                showThinking(true);
+                const chunk = act.text || '';
+                if (!chunk) { setThinkingLabel('thinking through the next step…'); break; }
+                if (!feedThinkingEl) {
+                    feedThinkingEl = document.createElement('div');
+                    feedThinkingEl.className = 'v2-act-think';
+                    feedThinkingEl.style.cssText =
+                        'font-style:italic;opacity:.7;white-space:pre-wrap;margin:2px 0 8px;font-size:12.5px;line-height:1.5;';
+                    feedThinkingEl._raw = '';
+                    feedTarget().appendChild(feedThinkingEl);
+                }
+                feedThinkingEl._raw += chunk;
+                feedThinkingEl.textContent = feedThinkingEl._raw;
+                feedHadContent = true;
+                setThinkingLabel('reasoning…');
+                scrollFeedIfNearBottom();
                 break;
+            }
             case 'text': {
                 const chunk = act.text || '';
                 if (!chunk) break;
+                feedThinkingEl = null;   // reasoning block ends when prose begins
                 if (!feedTextEl) {
                     feedTextEl = document.createElement('div');
                     feedTextEl.className = 'v2-act-text';
@@ -284,7 +333,7 @@ const V2Landing = (() => {
                 // ask_user_choice IS the active question (rendered separately in
                 // #v2-plan-ask) — don't also show it as a feed card.
                 if (act.name === 'ask_user_choice') break;
-                feedTextEl = null;
+                feedTextEl = null; feedThinkingEl = null;
                 const card = buildToolCard(act, false);
                 feedTarget().appendChild(card);
                 (runningTools[act.name] = runningTools[act.name] || []).push(card);
@@ -296,7 +345,7 @@ const V2Landing = (() => {
                 captureCampaignId(act.full);
                 if (PLAN_TOOLS.has(act.name)) schedulePlanRefresh();
                 if (act.name === 'ask_user_choice') break;
-                feedTextEl = null;
+                feedTextEl = null; feedThinkingEl = null;
                 const arr = runningTools[act.name] || [];
                 const card = arr.pop();
                 if (card) updateToolCard(card, act);
@@ -305,7 +354,7 @@ const V2Landing = (() => {
                 break;
             }
             case 'turn_end':
-                showThinking(false); feedTextEl = null;
+                showThinking(false); feedTextEl = null; feedThinkingEl = null;
                 refreshPlanPanel();
                 if (!current && !feedHadContent) showFallback();
                 break;

From f209874a23bd97731ac5c42f222794a6a45fc069 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 07:31:02 +0530
Subject: [PATCH 112/314] Fix create/update_plan_item crash when
 spec/references passed as JSON strings
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The model often serializes nested tool args (spec, references) as JSON strings
instead of objects. create_plan_item stored the raw string, and read-back via
_dict_to_plan_item did spec_data.items() on a str → AttributeError, leaving a
malformed, unreadable plan item persisted.

- planning.py: _coerce_plan_args() parses string spec/references (and int-casts
  estimated_days) in both create_plan_item and update_plan_item before storing.
- file_store.py: _dict_to_plan_item tolerates spec/references persisted as JSON
  strings (parse on read; fall back cleanly on garbage), so existing bad items
  load instead of crashing.

Verified: string spec/refs hydrate to ImagingSpec/list; malformed spec → None
(no crash).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/memory/file_store.py        | 13 +++++++++++
 gently/harness/plan_mode/tools/planning.py | 27 ++++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 6a8c5eb3..451e7df5 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -2538,6 +2538,14 @@ def _dict_to_plan_item(d: dict) -> PlanItem:
         imaging_spec = None
         bench_spec = None
 
+        # Tolerate specs persisted as JSON strings (older tool calls that passed
+        # spec as a string instead of an object) so read-back never crashes.
+        if isinstance(spec_data, str):
+            try:
+                spec_data = json.loads(spec_data)
+            except (json.JSONDecodeError, TypeError):
+                spec_data = None
+
         if spec_data:
             if item_type == PlanItemType.IMAGING:
                 valid = {f.name for f in dataclasses.fields(ImagingSpec)}
@@ -2547,6 +2555,11 @@ def _dict_to_plan_item(d: dict) -> PlanItem:
                 bench_spec = BenchSpec(**{k: v for k, v in spec_data.items() if k in valid})
 
         references = d.get("references") or []
+        if isinstance(references, str):
+            try:
+                references = json.loads(references) or []
+            except (json.JSONDecodeError, TypeError):
+                references = []
 
         return PlanItem(
             id=d["id"],
diff --git a/gently/harness/plan_mode/tools/planning.py b/gently/harness/plan_mode/tools/planning.py
index 34785e5f..09e529d3 100644
--- a/gently/harness/plan_mode/tools/planning.py
+++ b/gently/harness/plan_mode/tools/planning.py
@@ -7,9 +7,34 @@
 """
 
 import dataclasses
+import json
 
 from ...tools.registry import ToolCategory, ToolExample, tool
 
+
+def _coerce_plan_args(spec, references, estimated_days):
+    """The model often serializes nested args (spec/references) as JSON strings
+    instead of objects — accept either so plan-item creation doesn't store a raw
+    string (which later breaks ImagingSpec/BenchSpec hydration). Returns the
+    normalized (spec, references, estimated_days)."""
+    if isinstance(spec, str):
+        try:
+            spec = json.loads(spec)
+        except (json.JSONDecodeError, TypeError):
+            spec = None
+    if isinstance(references, str):
+        try:
+            references = json.loads(references)
+        except (json.JSONDecodeError, TypeError):
+            references = None
+    if isinstance(estimated_days, str):
+        try:
+            estimated_days = int(estimated_days)
+        except (ValueError, TypeError):
+            estimated_days = None
+    return spec, references, estimated_days
+
+
 # ---------------------------------------------------------------------------
 # Campaign / Phase Management
 # ---------------------------------------------------------------------------
@@ -132,6 +157,7 @@ async def create_plan_item(
         return "Error: Context store not available"
 
     store = agent.context_store
+    spec, references, estimated_days = _coerce_plan_args(spec, references, estimated_days)
 
     # Resolve phase_number → subcampaign ID
     target_campaign_id = campaign_id
@@ -226,6 +252,7 @@ async def update_plan_item(
     from gently.harness.memory.model import PlanItemStatus
 
     status_enum = PlanItemStatus(status) if status else None
+    spec, references, estimated_days = _coerce_plan_args(spec, references, estimated_days)
     store.update_plan_item(
         item_id=resolved_id,
         status=status_enum,

From 144d8ddda5d1287fb8530324076e59ecda35a50b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 08:56:41 +0530
Subject: [PATCH 113/314] UX v2: add a concision/communication-style section to
 the plan-mode prompt
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The plan-mode prompt specified what to design in detail but nothing about how to
write to the user, so (with Opus 4.8's stronger narration) the agent produced
dense questions, paragraph-long ask_user_choice options, and over-explained
prose — cognitively heavy for a working biologist. Add an explicit
communication-style section: lead with the ask/finding, short questions + short
options, plain words over process jargon, one-clause rationale (full reasoning
goes to provenance/references), one idea per message.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/plan_mode/prompt.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/gently/harness/plan_mode/prompt.py b/gently/harness/plan_mode/prompt.py
index 62df77d7..782bd7af 100644
--- a/gently/harness/plan_mode/prompt.py
+++ b/gently/harness/plan_mode/prompt.py
@@ -79,6 +79,29 @@
 IMPORTANT: ALWAYS use ask_user_choice when asking the researcher questions. Never
 present options as text lists.
 
+## Communication style — keep it light to read
+
+You're talking to a working biologist, not a software user. Optimize every
+user-facing message for fast reading, not completeness:
+
+- **Lead with the ask or the finding.** The first sentence should be the question,
+  the decision, or what you found — supporting detail comes after, and only when it
+  changes what they'd do next.
+- **Short questions, short options.** Keep an ask_user_choice question to one line,
+  and each option to a few-word label plus at most a one-line rationale — never a
+  paragraph. Trust the biologist to know the domain; don't re-explain standard
+  concepts (what a histone marker is, why controls matter).
+- **Plain words, not process jargon.** Use the field's real terms (strain names,
+  stages, wavelengths) but drop software/workflow jargon and hedging.
+- **Give the short "why", not the survey.** One clause of rationale beats an
+  exhaustive list of everything you weighed. Put the full reasoning in the spec's
+  provenance and references, not in the message.
+- **One idea per message.** Don't stack caveats, alternatives, and next steps into
+  one dense block. If something is optional, say so briefly or leave it out.
+
+Readability and brevity are different — choose readability, but get there by
+saying less, not by compressing into fragments or abbreviations.
+
 ## Reading Papers
 
 Use read_paper to retrieve and read scientific papers. It accepts:

From d061e9d8d1ab65f23e5dae565fb021066ae6451c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 09:14:25 +0530
Subject: [PATCH 114/314] UX v2: run independent read-only tool calls
 concurrently

A turn's tool calls were always awaited one-by-one, so several independent
lookups (e.g. search_strains for dlg-1 then ajm-1) ran serially even when the
model could issue them together. Add a concurrency fast-path: when EVERY tool in
a turn is non-hardware (requires_microscope=False) and non-interactive (not
ask_user_choice), fire their tool_start events, asyncio.gather the executions,
then emit results. Any microscope action or ask_user_choice in the batch falls
back to the existing serial path, so hardware is never raced and interactive
prompts/stateful ordering are preserved.

Also nudge the plan-mode prompt to batch independent lookups into one turn so the
model actually produces parallelizable tool calls.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/conversation.py     | 67 ++++++++++++++++++++++++++++++
 gently/harness/plan_mode/prompt.py |  4 ++
 2 files changed, 71 insertions(+)

diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 067e2f85..8f6b8b11 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -730,7 +730,74 @@ def worker():
             await asyncio.sleep(0.05)
 
             tool_results = []
+
+            # Concurrency fast-path: run a turn's tool calls in parallel when ALL of
+            # them are non-hardware and non-interactive (e.g. several strain / paper /
+            # lab-history lookups). Any microscope action or ask_user_choice in the
+            # batch falls back to the serial path below, so we never race hardware or
+            # an interactive prompt, and ordering of stateful ops is preserved.
+            tool_blocks = [b for b in response_content if getattr(b, "type", None) == "tool_use"]
+            _interactive = {"ask_user_choice"}
+
+            def _parallel_safe(b):
+                td = self._tool_registry.get(b.name)
+                return td is not None and not td.requires_microscope and b.name not in _interactive
+
+            handled_parallel = False
+            if len(tool_blocks) > 1 and all(_parallel_safe(b) for b in tool_blocks):
+                handled_parallel = True
+                starts = {b.id: time.time() for b in tool_blocks}
+                for b in tool_blocks:
+                    yield {
+                        "type": "tool_start",
+                        "tool_name": b.name,
+                        "tool_input": b.input,
+                        "tool_label": tool_label_fn(b.name, b.input),
+                    }
+                gathered = await asyncio.gather(
+                    *[self._execute_single_tool(b.name, b.input) for b in tool_blocks],
+                    return_exceptions=True,
+                )
+                for b, res in zip(tool_blocks, gathered, strict=True):
+                    if isinstance(res, BaseException):
+                        is_error_flag = True
+                        result_text = f"Error: {res}"
+                        tool_results.append(
+                            {
+                                "type": "tool_result",
+                                "tool_use_id": b.id,
+                                "content": result_text,
+                                "is_error": True,
+                            }
+                        )
+                    else:
+                        is_error_flag = False
+                        result_text = res if isinstance(res, str) else str(res)
+                        tool_results.append(
+                            {"type": "tool_result", "tool_use_id": b.id, "content": res}
+                        )
+                    result_summary = next(
+                        (ln.strip() for ln in (result_text or "").splitlines() if ln.strip()),
+                        "",
+                    )
+                    if len(result_summary) > 140:
+                        result_summary = result_summary[:139] + "…"
+                    result_full = result_text or ""
+                    if len(result_full) > 4000:
+                        result_full = result_full[:4000] + "\n…(truncated)"
+                    yield {
+                        "type": "tool_call",
+                        "tool_name": b.name,
+                        "tool_input": b.input,
+                        "duration": time.time() - starts[b.id],
+                        "result_summary": result_summary,
+                        "result_full": result_full,
+                        "is_error": is_error_flag,
+                    }
+
             for block in response_content:
+                if handled_parallel:
+                    break
                 if hasattr(block, "type") and block.type == "tool_use":
                     start_time = time.time()
 
diff --git a/gently/harness/plan_mode/prompt.py b/gently/harness/plan_mode/prompt.py
index 782bd7af..7aefbe3f 100644
--- a/gently/harness/plan_mode/prompt.py
+++ b/gently/harness/plan_mode/prompt.py
@@ -176,6 +176,10 @@
    items, search to confirm strain availability, check the literature for recent
    protocols, and attach references. Your built-in knowledge is a great starting
    point for brainstorming — the databases are where you confirm before finalizing.
+11. **Batch independent lookups**: When you need several independent reads — multiple
+   strains, several papers, or a few lab-history queries — request them together in
+   one turn so they run in parallel. Don't fetch one, wait for it, then fetch the
+   next; that's slow. (The system runs same-turn read-only lookups concurrently.)
 """
 
 

From a779901bb8f5147c7ddb39a96546bc11e37b3cfd Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 09:29:51 +0530
Subject: [PATCH 115/314] Fix create_plan_item crash when phase_number is a
 string
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

phase_number arrived as "1" (stringified, like spec/references), so
get_nth_subcampaign did `1 <= "1"` → TypeError. Coerce phase_number/phase_order
to int in the create tool, and make get_nth_subcampaign tolerant of a numeric
string.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/memory/file_store.py        |  5 +++++
 gently/harness/plan_mode/tools/planning.py | 10 ++++++++++
 2 files changed, 15 insertions(+)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 451e7df5..c19f785b 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -582,6 +582,11 @@ def get_subcampaigns(self, campaign_id: str) -> list[Campaign]:
         return children
 
     def get_nth_subcampaign(self, parent_id: str, n: int) -> Campaign | None:
+        # Tolerate n arriving as a numeric string (tool args are often stringified).
+        try:
+            n = int(n)
+        except (ValueError, TypeError):
+            return None
         phases = self.get_subcampaigns(parent_id)
         if 1 <= n <= len(phases):
             return phases[n - 1]
diff --git a/gently/harness/plan_mode/tools/planning.py b/gently/harness/plan_mode/tools/planning.py
index 09e529d3..87715acd 100644
--- a/gently/harness/plan_mode/tools/planning.py
+++ b/gently/harness/plan_mode/tools/planning.py
@@ -158,6 +158,16 @@ async def create_plan_item(
 
     store = agent.context_store
     spec, references, estimated_days = _coerce_plan_args(spec, references, estimated_days)
+    if isinstance(phase_number, str):
+        try:
+            phase_number = int(phase_number)
+        except (ValueError, TypeError):
+            phase_number = None
+    if isinstance(phase_order, str):
+        try:
+            phase_order = int(phase_order)
+        except (ValueError, TypeError):
+            phase_order = -1
 
     # Resolve phase_number → subcampaign ID
     target_campaign_id = campaign_id

From 06741eb8b99ca6a0296058eda9ab573fcf9c4381 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 09:29:51 +0530
Subject: [PATCH 116/314] Restrict tool concurrency to read-only tools; nudge
 batched plan-item creation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The concurrency fast-path gated only on requires_microscope=False, which would
also have run mutating tools (create_/update_/delete_plan_item) in parallel —
they share a campaign's plan file and are order-dependent, so concurrent runs
could corrupt it. Tighten the gate to genuinely read-only tools (search_/read_/
query_/get_/list_/recall_/find_/fetch_/lookup_ prefixes). Mutating creates stay
serial.

The latency win for plan construction is fewer model turns, not parallel writes:
add a prompt nudge to emit several create_plan_item calls in one turn (executed
serially, safely) instead of one item per turn.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/conversation.py     | 22 +++++++++++++++++++++-
 gently/harness/plan_mode/prompt.py |  4 ++++
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index 8f6b8b11..a3955df0 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -738,10 +738,30 @@ def worker():
             # an interactive prompt, and ordering of stateful ops is preserved.
             tool_blocks = [b for b in response_content if getattr(b, "type", None) == "tool_use"]
             _interactive = {"ask_user_choice"}
+            # Only parallelize genuinely read-only tools (independent lookups). Mutating
+            # tools (create_/update_/delete_/set_…) must stay serial — they share state
+            # (e.g. a campaign's plan file) and are order-dependent, so concurrent runs
+            # could race or corrupt it.
+            _readonly_prefixes = (
+                "search_",
+                "read_",
+                "query_",
+                "get_",
+                "list_",
+                "recall_",
+                "find_",
+                "fetch_",
+                "lookup_",
+            )
 
             def _parallel_safe(b):
                 td = self._tool_registry.get(b.name)
-                return td is not None and not td.requires_microscope and b.name not in _interactive
+                return (
+                    td is not None
+                    and not td.requires_microscope
+                    and b.name not in _interactive
+                    and b.name.startswith(_readonly_prefixes)
+                )
 
             handled_parallel = False
             if len(tool_blocks) > 1 and all(_parallel_safe(b) for b in tool_blocks):
diff --git a/gently/harness/plan_mode/prompt.py b/gently/harness/plan_mode/prompt.py
index 7aefbe3f..df30bbf9 100644
--- a/gently/harness/plan_mode/prompt.py
+++ b/gently/harness/plan_mode/prompt.py
@@ -180,6 +180,10 @@
    strains, several papers, or a few lab-history queries — request them together in
    one turn so they run in parallel. Don't fetch one, wait for it, then fetch the
    next; that's slow. (The system runs same-turn read-only lookups concurrently.)
+12. **Build the plan in few turns**: Each turn is a model round-trip, so creating one
+   item per turn makes plan construction crawl. When writing a phase's items, emit
+   several create_plan_item calls in a single turn (then set any dependencies in a
+   follow-up). Fewer turns = a much faster plan.
 """
 
 

From faee1819003eed0ee8e682845ab46880ce74d5da Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 10:12:26 +0530
Subject: [PATCH 117/314] UX v2: plan-done state + restructured THE PLAN panel
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two flow/IA fixes to the plan wizard, both surfaced in a live click-audit:

1. Plan-ready completion state. When propose_plan lands and the turn
   settles with no pending question, the wizard now flips to a "ready"
   state instead of leaving the user parked on the last feed step: the
   header reads "Your plan is ready — N items across M phases" (counted
   from the real plan tree), the eyebrow/orb turn green, and the footer
   link is promoted to a filled primary "Open the workspace ›" button.
   Resets on the next turn_start so refining drops the banner cleanly.

2. THE PLAN panel readability. Items were a flat gray bullet list with
   phases labeled by machine shorthand ("nrp-p1"). Each item is now a
   structured row — phase-relative number (1.1), a type-colored marker
   (imaging=blue, genetics=purple, analysis=green, bench=amber,
   decision_point=rose gate-square), the title, and an optional duration.
   Phases read by their human name ("Phase 1 — Reporter validation").

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/landing.css | 49 ++++++++++++++--
 gently/ui/web/static/js/landing.js   | 88 ++++++++++++++++++++++++++--
 2 files changed, 126 insertions(+), 11 deletions(-)

diff --git a/gently/ui/web/static/css/landing.css b/gently/ui/web/static/css/landing.css
index dad23d0b..49d27d9e 100644
--- a/gently/ui/web/static/css/landing.css
+++ b/gently/ui/web/static/css/landing.css
@@ -279,6 +279,21 @@ body.ux-v2 .home-hero { display: none; }
 }
 .v2-plan-skip:hover { color: var(--text-secondary, #475569); }
 
+/* ── Plan-ready state: the design is done, signpost the finish line ───────── */
+.v2-screen-plan.ready .v2-plan-orb {
+    background: radial-gradient(closest-side at 38% 34%, #ffffff, #c8f0d4 40%, var(--accent-green, #16a34a) 100%);
+}
+.v2-screen-plan.ready .v2-plan-who { color: var(--accent-green, #16a34a); }
+.v2-screen-plan.ready .v2-plan-foot { border-top-color: color-mix(in srgb, var(--accent-green) 35%, var(--border)); }
+/* promote "open the workspace" from a quiet skip link to the primary action */
+.v2-screen-plan.ready #v2-plan-continue {
+    background: var(--accent-green, #16a34a); color: #fff;
+    border-radius: 999px; padding: 11px 20px; font-weight: 600;
+}
+.v2-screen-plan.ready #v2-plan-continue:hover {
+    color: #fff; background: color-mix(in srgb, var(--accent-green) 88%, #000);
+}
+
 /* ── Agent-activity feed: claude.ai-style collapsible tool cards ──────────── */
 /* Both screens share the .v2-landing-inner top anchor (no per-screen align flip —
    that was the welcome→plan lurch). The feed is a fixed-height viewport (height
@@ -369,13 +384,37 @@ body.ux-v2[data-theme="dark"] .v2-plan-error {
 /* plan-panel: phases + tasks (real plan), and a free-text-answer row variant */
 .v2-plan-phase { margin-top: 12px; }
 .v2-plan-phase:first-child { margin-top: 0; }
-.v2-plan-phase-h { font-size: 13px; font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); margin-bottom: 5px; }
-.v2-plan-task { display: flex; gap: 8px; font-size: var(--v2-fs-cap); color: var(--text-secondary, #475569); padding: 2px 0; }
-.v2-plan-task::before { content: "·"; color: var(--text-muted, #94a3b8); }
+.v2-plan-phase-h {
+    font-size: var(--v2-fs-eyebrow); font-weight: 700; letter-spacing: .06em;
+    text-transform: uppercase; color: var(--text-secondary, #475569); margin-bottom: 6px;
+}
+/* a plan item: "P.I" number · type-color dot · title · optional duration.
+   the type dot encodes the item kind (imaging/genetics/analysis/…) at a glance. */
+.v2-plan-task {
+    display: grid; grid-template-columns: auto 8px 1fr auto; align-items: baseline;
+    gap: 9px; font-size: var(--v2-fs-cap); color: var(--text-secondary, #475569);
+    padding: 6px 0; border-top: 1px solid color-mix(in srgb, var(--border, #e4e9f0) 55%, transparent);
+}
+.v2-plan-phase .v2-plan-task:first-child { border-top: 0; }
+.v2-task-num {
+    font: 600 11px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace;
+    color: var(--text-muted, #94a3b8); font-variant-numeric: tabular-nums;
+}
+.v2-task-dot { width: 8px; height: 8px; border-radius: 50%; align-self: center; background: var(--text-muted, #94a3b8); }
+.v2-task-ttl { min-width: 0; color: var(--text, #0f172a); line-height: 1.45; }
+.v2-task-days {
+    font-size: 10.5px; font-weight: 600; color: var(--text-muted, #94a3b8);
+    font-variant-numeric: tabular-nums; white-space: nowrap;
+}
+.v2-plan-task.type-imaging .v2-task-dot { background: var(--accent, #2f6df6); }
+.v2-plan-task.type-genetics .v2-task-dot { background: #8b5cf6; }
+.v2-plan-task.type-analysis .v2-task-dot { background: var(--accent-green, #16a34a); }
+.v2-plan-task.type-bench .v2-task-dot { background: #d97706; }
+/* decision points read as gates — a rotated square, not a round bead */
+.v2-plan-task.type-decision_point .v2-task-dot { background: #e11d48; border-radius: 1px; transform: rotate(45deg); }
 .v2-plan-title-row { font-size: var(--v2-fs-sm); font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); margin-bottom: 8px; }
 .v2-plan-row.v2-plan-row-freetext .v { font-style: italic; }
-.v2-plan-task-empty { color: var(--text-muted, #94a3b8); font-style: italic; }
-.v2-plan-task-empty::before { color: transparent; }
+.v2-plan-task-empty { grid-column: 1 / -1; color: var(--text-muted, #94a3b8); font-style: italic; }
 
 /* THE PLAN pager: ‹ Prev · "Phase · i of N" · Next › + dots, one phase per page */
 .v2-plan-pager { display: flex; align-items: center; gap: 8px; margin: 2px 0 12px; }
diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
index 4f0f2917..623576fc 100644
--- a/gently/ui/web/static/js/landing.js
+++ b/gently/ui/web/static/js/landing.js
@@ -22,6 +22,7 @@ const V2Landing = (() => {
     let runningTools = {};         // tool name -> stack of running card elements
     let feedHadContent = false;    // did this turn surface anything in the feed?
     let capturedCampaignId = null; // best-effort id scraped from tool results
+    let planProposed = false;      // propose_plan ran → plan is ready to commit
 
     const $ = (id) => document.getElementById(id);
 
@@ -137,7 +138,8 @@ const V2Landing = (() => {
         }
         feedPages = []; feedPage = 0; curPageEl = null; pendingNewPage = false;
         feedTextEl = null; feedThinkingEl = null; runningTools = {}; feedHadContent = false;
-        capturedCampaignId = null;
+        capturedCampaignId = null; planProposed = false;
+        clearPlanReady();
         hidePlanError();
     }
     function newFeedPage() {
@@ -291,6 +293,7 @@ const V2Landing = (() => {
         switch (act.kind) {
             case 'turn_start':
                 feedTextEl = null; feedThinkingEl = null; pendingNewPage = true; hidePlanError(); clearFallback();
+                clearPlanReady();   // new work in flight — drop any "ready" state
                 showThinking(true, 'reviewing your campaign and plan…');
                 break;
             case 'thinking': {
@@ -344,6 +347,7 @@ const V2Landing = (() => {
                 captureCampaignId(act.summary);
                 captureCampaignId(act.full);
                 if (PLAN_TOOLS.has(act.name)) schedulePlanRefresh();
+                if (act.name === 'propose_plan' && !act.is_error) planProposed = true;
                 if (act.name === 'ask_user_choice') break;
                 feedTextEl = null; feedThinkingEl = null;
                 const arr = runningTools[act.name] || [];
@@ -357,6 +361,10 @@ const V2Landing = (() => {
                 showThinking(false); feedTextEl = null; feedThinkingEl = null;
                 refreshPlanPanel();
                 if (!current && !feedHadContent) showFallback();
+                // Plan proposed and the agent has settled (no pending question) →
+                // the design is done. Surface a clear "ready" state instead of
+                // leaving the user parked on the last wizard step.
+                if (planProposed && !current) showPlanReady();
                 break;
             case 'turn_error':
                 showPlanError(act.error || 'Something went wrong — open the conversation for detail.');
@@ -373,6 +381,48 @@ const V2Landing = (() => {
         feedTarget().appendChild(d);
     }
 
+    // ── plan-ready state ───────────────────────────────────────────────
+    // Once the agent has proposed the plan and gone quiet, the wizard is done.
+    // Mark the screen "ready": rename the header, count phases/items from the
+    // panel, and promote "open workspace" to the obvious primary action — so the
+    // finish line is signposted instead of looking like one more wizard step.
+    function planCounts() {
+        let phases = 0, items = 0;
+        planPages.forEach(p => {
+            if (p.name !== 'Tasks') phases++;
+            items += (p.items || []).length;
+        });
+        return { phases, items };
+    }
+    function showPlanReady() {
+        const sec = document.querySelector('.v2-screen-plan');
+        if (!sec) return;
+        sec.classList.add('ready');
+        showThinking(false);
+        const who = sec.querySelector('.v2-plan-who');
+        const title = sec.querySelector('.v2-plan-title');
+        if (who) who.textContent = 'Gently · plan ready';
+        if (title) {
+            const { phases, items } = planCounts();
+            title.textContent = items
+                ? `Your plan is ready — ${items} item${items === 1 ? '' : 's'} across ${phases} phase${phases === 1 ? '' : 's'}`
+                : 'Your plan is ready';
+        }
+        const cont = $('v2-plan-continue');
+        if (cont) cont.textContent = 'Open the workspace ›';
+    }
+    function clearPlanReady() {
+        const sec = document.querySelector('.v2-screen-plan');
+        if (!sec || !sec.classList.contains('ready')) return;
+        sec.classList.remove('ready');
+        const who = sec.querySelector('.v2-plan-who');
+        const title = sec.querySelector('.v2-plan-title');
+        if (who) who.textContent = 'Gently · planning';
+        if (title) title.textContent = "Let's design your run";
+        const cont = $('v2-plan-continue');
+        if (cont) cont.textContent = 'Continue in workspace ›';
+    }
+
     // ── THE PLAN panel: mirror the real campaign tree ──────────────────
     async function refreshPlanPanel() {
         try {
@@ -392,6 +442,12 @@ const V2Landing = (() => {
         c = c || {};
         return c.shorthand || c.display_name || c.description || 'Plan';
     }
+    // Phases read better by their human name ("Phase 1 — Reporter validation")
+    // than by their code shorthand ("nrp-p1"), which looks like a machine id.
+    function phaseName(c) {
+        c = c || {};
+        return c.display_name || c.description || c.shorthand || 'Phase';
+    }
     // THE PLAN renders as a pager — one phase per page with ‹ Prev / Next ›,
     // a position label, and dots — instead of one long scroll. planPage is held
     // across re-renders (the panel refetches on every plan-writing tool) so the
@@ -409,7 +465,7 @@ const V2Landing = (() => {
         if (rootItems.length) pages.push({ name: 'Tasks', items: rootItems });
         phases.forEach(phase => {
             if (!phase) return;
-            pages.push({ name: planName(phase.campaign), items: phase.items || [] });
+            pages.push({ name: phaseName(phase.campaign), items: phase.items || [] });
         });
         planPages = pages;
         planTitleText = planName(tree.campaign);
@@ -442,7 +498,8 @@ const V2Landing = (() => {
             prev.addEventListener('click', () => { if (planPage > 0) { planPage--; drawPlanPage(); } });
             const pos = document.createElement('span');
             pos.className = 'v2-plan-pager-pos';
-            pos.textContent = `${page.name} · ${i + 1} of ${n}`;
+            pos.textContent = page.name;   // position shown by the dots below
+            pos.title = `${page.name} · ${i + 1} of ${n}`;
             const next = document.createElement('button');
             next.className = 'v2-plan-pager-btn'; next.type = 'button'; next.textContent = 'Next ›';
             next.disabled = i === n - 1;
@@ -459,11 +516,30 @@ const V2Landing = (() => {
         const tasks = document.createElement('div');
         tasks.className = 'v2-plan-phase';
         const items = page.items || [];
+        // phase ordinal (1-based) for "P.I" numbering; the rootItems "Tasks" page
+        // isn't a phase, so it numbers items bare (1, 2, …).
+        const phaseOrd = pages.slice(0, i + 1).filter(p => p.name !== 'Tasks').length;
         if (items.length) {
-            items.forEach(it => {
+            items.forEach((it, idx) => {
+                const type = String(it.type || '').toLowerCase();
                 const t = document.createElement('div');
-                t.className = 'v2-plan-task';
-                t.textContent = it.title || it.shorthand || '(task)';
+                t.className = 'v2-plan-task type-' + (type || 'other');
+                const num = document.createElement('span');
+                num.className = 'v2-task-num';
+                num.textContent = phaseOrd ? `${phaseOrd}.${idx + 1}` : `${idx + 1}`;
+                const dot = document.createElement('span');
+                dot.className = 'v2-task-dot';
+                dot.title = type || 'task';
+                const ttl = document.createElement('span');
+                ttl.className = 'v2-task-ttl';
+                ttl.textContent = it.title || it.shorthand || '(task)';
+                t.append(num, dot, ttl);
+                if (it.estimated_days) {
+                    const d = document.createElement('span');
+                    d.className = 'v2-task-days';
+                    d.textContent = `${it.estimated_days}d`;
+                    t.append(d);
+                }
                 tasks.appendChild(t);
             });
         } else {

From f6f2ba310c99b1e626d728e386f2d082cf9fa559 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 10:19:08 +0530
Subject: [PATCH 118/314] UX v2: drop wrap-up reasoning litter from the plan
 feed
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The streamed thinking summary fills the wait, but the trailing "wrap-up"
reasoning ("let me wrap this up concisely and offer to export…") was left
in the feed as a dim block right next to the answer it precedes — reading
as leaked narration. It's a thinking block, not the agent's text output.

When the spoken answer begins, remove the immediately-preceding thinking
block from the DOM instead of only nulling the pointer. Thinking that
precedes a TOOL is kept (it's the rationale for that action); only the
reasoning that precedes the answer text is dropped.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/js/landing.js | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
index 623576fc..a8cc751c 100644
--- a/gently/ui/web/static/js/landing.js
+++ b/gently/ui/web/static/js/landing.js
@@ -320,7 +320,13 @@ const V2Landing = (() => {
             case 'text': {
                 const chunk = act.text || '';
                 if (!chunk) break;
-                feedThinkingEl = null;   // reasoning block ends when prose begins
+                // The reasoning that immediately precedes the spoken answer is
+                // wrap-up meta ("let me wrap this up concisely and offer to
+                // export…") — drop the block entirely so the feed keeps the
+                // answer, not the narration of getting there. Reasoning that
+                // precedes a TOOL is left in place (tool_start only nulls the
+                // pointer) as the rationale for that action.
+                if (feedThinkingEl) { feedThinkingEl.remove(); feedThinkingEl = null; }
                 if (!feedTextEl) {
                     feedTextEl = document.createElement('div');
                     feedTextEl.className = 'v2-act-text';

From b8df61074cdd89f5a3675d562540de2a3af9f4e7 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 11:12:46 +0530
Subject: [PATCH 119/314] UX v2: export-plan button replaces the end-of-plan
 prose upsell
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The agent used to close a finished plan by asking "want me to export this
as markdown, or save it as a template?" — a question the plan wizard can't
answer (no text input there). Replace it with a real action.

- Plan-ready footer gains a quiet "↓ Export plan" button. It fetches the
  existing /api/campaigns/{id}/export tree and renders a shareable markdown
  doc client-side (title, goal, phases, numbered items with type, specs,
  references), then downloads it as {shorthand}.md. Revealed in the ready
  state, hidden again if a new turn starts.
- Plan-mode prompt: after propose_plan, close on the summary and do NOT
  offer to export / save-as-template / ask "what next?" — the interface
  owns those now.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/plan_mode/prompt.py   |  6 ++
 gently/ui/web/static/css/landing.css |  8 +++
 gently/ui/web/static/js/landing.js   | 87 ++++++++++++++++++++++++++++
 gently/ui/web/templates/index.html   |  1 +
 4 files changed, 102 insertions(+)

diff --git a/gently/harness/plan_mode/prompt.py b/gently/harness/plan_mode/prompt.py
index df30bbf9..055d0df2 100644
--- a/gently/harness/plan_mode/prompt.py
+++ b/gently/harness/plan_mode/prompt.py
@@ -76,6 +76,12 @@
 3. Set dependencies between items
 4. Present the full plan for review with propose_plan
 
+After propose_plan, close with a short confirmation of what the plan contains
+(item/phase count, the critical path, anything notable) and stop there. Do NOT
+offer to export it, save it as a template, or ask "what would you like to do
+next?" — exporting and opening the workspace are handled by the interface, not
+this conversation. End on the summary, not an upsell.
+
 IMPORTANT: ALWAYS use ask_user_choice when asking the researcher questions. Never
 present options as text lists.
 
diff --git a/gently/ui/web/static/css/landing.css b/gently/ui/web/static/css/landing.css
index 49d27d9e..046675de 100644
--- a/gently/ui/web/static/css/landing.css
+++ b/gently/ui/web/static/css/landing.css
@@ -278,6 +278,14 @@ body.ux-v2 .home-hero { display: none; }
     color: var(--text-muted, #94a3b8); padding: 11px 10px; border-radius: 8px; transition: color .2s;
 }
 .v2-plan-skip:hover { color: var(--text-secondary, #475569); }
+.v2-plan-export {
+    background: none; border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
+    border-radius: 999px; padding: 11px 16px; font: inherit; font-size: var(--v2-fs-sm);
+    font-weight: 600; cursor: pointer; transition: border-color .2s, color .2s, background .2s;
+}
+.v2-plan-export:hover { border-color: var(--border-strong); color: var(--text, #0f172a); background: var(--bg-hover); }
+.v2-plan-export:disabled { opacity: .6; cursor: default; }
+.v2-plan-export[hidden] { display: none; }
 
 /* ── Plan-ready state: the design is done, signpost the finish line ───────── */
 .v2-screen-plan.ready .v2-plan-orb {
diff --git a/gently/ui/web/static/js/landing.js b/gently/ui/web/static/js/landing.js
index a8cc751c..6d058ebe 100644
--- a/gently/ui/web/static/js/landing.js
+++ b/gently/ui/web/static/js/landing.js
@@ -416,6 +416,8 @@ const V2Landing = (() => {
         }
         const cont = $('v2-plan-continue');
         if (cont) cont.textContent = 'Open the workspace ›';
+        const exp = $('v2-plan-export');
+        if (exp) exp.hidden = false;   // the plan is final → offer the download
     }
     function clearPlanReady() {
         const sec = document.querySelector('.v2-screen-plan');
@@ -427,6 +429,89 @@ const V2Landing = (() => {
         if (title) title.textContent = "Let's design your run";
         const cont = $('v2-plan-continue');
         if (cont) cont.textContent = 'Continue in workspace ›';
+        const exp = $('v2-plan-export');
+        if (exp) exp.hidden = true;
+    }
+
+    // ── export the finished plan as a shareable markdown doc ────────────
+    // Replaces the agent's end-of-plan "want me to export this?" prose with a
+    // real action: pull the enriched plan tree (/export) and render it to
+    // markdown client-side so the biologist can drop it in a doc or share it.
+    function specToLines(spec) {
+        let s = spec;
+        if (typeof s === 'string') { try { s = JSON.parse(s); } catch { return s ? ['- ' + s] : []; } }
+        if (!s || typeof s !== 'object') return [];
+        const out = [];
+        const fmt = (v) => Array.isArray(v) ? v.join(', ') : (typeof v === 'object' ? JSON.stringify(v) : String(v));
+        const pick = (k, label) => { if (s[k] != null && s[k] !== '') out.push(`- **${label}:** ${fmt(s[k])}`); };
+        pick('strain', 'Strain'); pick('goal', 'Goal');
+        if (Array.isArray(s.channels) && s.channels.length) {
+            out.push('- **Channels:** ' + s.channels.map(c => `${c.name || '?'} (${c.excitation_nm || '?'} nm${c.exposure_ms ? `, ${c.exposure_ms} ms` : ''})`).join(', '));
+        }
+        pick('num_slices', 'Slices'); pick('interval_s', 'Interval (s)'); pick('temperature_c', 'Temperature (°C)');
+        pick('num_embryos', 'Embryos'); pick('start_stage', 'Start stage'); pick('stop_condition', 'Stop condition');
+        pick('criteria', 'Criteria'); pick('success_criteria', 'Success criteria');
+        return out;
+    }
+    function buildPlanMarkdown(tree) {
+        const L = [];
+        L.push(`# ${tree.description || tree.shorthand || 'Experimental plan'}`, '');
+        if (tree.target) L.push(`**Goal:** ${tree.target}`, '');
+        if (tree.shorthand) L.push(`**Plan ID:** \`${tree.shorthand}\``, '');
+        L.push(`_Exported from Gently — ${new Date().toLocaleString()}_`, '');
+        const renderItems = (items, prefix) => {
+            (items || []).slice().sort((a, b) => (a.phase_order || 0) - (b.phase_order || 0)).forEach((it, idx) => {
+                L.push(`### ${prefix}${idx + 1} ${it.title || '(task)'}  \`${it.type || 'task'}\``, '');
+                if (it.description) L.push(it.description, '');
+                const sl = specToLines(it.spec);
+                if (sl.length) L.push(...sl, '');
+                const refs = it.references || [];
+                if (refs.length) {
+                    L.push('**References:**');
+                    refs.forEach((r, i) => L.push(`${i + 1}. ${r.citation || r.id || ''}${r.source ? ` _(${r.source})_` : ''}`));
+                    L.push('');
+                }
+            });
+        };
+        if ((tree.items || []).length) { L.push('## Tasks', ''); renderItems(tree.items, ''); }
+        (tree.children || []).forEach((ph, pi) => {
+            if (!ph) return;
+            L.push(`## ${ph.display_name || ph.description || ph.shorthand || `Phase ${pi + 1}`}`, '');
+            if (ph.target) L.push(ph.target, '');
+            renderItems(ph.items, `${pi + 1}.`);
+        });
+        return L.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
+    }
+    async function resolveCampaignId() {
+        if (capturedCampaignId) return capturedCampaignId;
+        try {
+            const r = await fetch('/api/campaigns');
+            if (r.ok) { const d = await r.json(); const t = (d.campaigns || [])[0]; return (t && t.campaign && t.campaign.id) || null; }
+        } catch (e) { /* offline */ }
+        return null;
+    }
+    async function exportPlan() {
+        const btn = $('v2-plan-export');
+        const id = await resolveCampaignId();
+        if (!id) { showPlanError('No plan to export yet.'); return; }
+        if (btn) { btn.disabled = true; btn.textContent = '↓ Exporting…'; }
+        try {
+            const r = await fetch(`/api/campaigns/${encodeURIComponent(id)}/export`);
+            if (!r.ok) throw new Error(`export ${r.status}`);
+            const tree = await r.json();
+            const md = buildPlanMarkdown(tree);
+            const blob = new Blob([md], { type: 'text/markdown' });
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = `${(tree.shorthand || 'plan').replace(/[^\w.-]+/g, '_')}.md`;
+            document.body.appendChild(a); a.click(); a.remove();
+            setTimeout(() => URL.revokeObjectURL(url), 1000);
+        } catch (e) {
+            showPlanError('Could not export the plan — open the conversation to export it manually.');
+        } finally {
+            if (btn) { btn.disabled = false; btn.textContent = '↓ Export plan'; }
+        }
     }
 
     // ── THE PLAN panel: mirror the real campaign tree ──────────────────
@@ -744,6 +829,8 @@ const V2Landing = (() => {
         if (planChat) planChat.addEventListener('click', openChat);
         const cont = $('v2-plan-continue');
         if (cont) cont.addEventListener('click', dismiss);
+        const exp = $('v2-plan-export');
+        if (exp) exp.addEventListener('click', exportPlan);
 
         // The agent's questions + work render in the plan stage while it's active;
         // once we've receded into the workspace, AskStage (#ask-stage) takes over.
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 3e704938..cd0b1fba 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -96,6 +96,7 @@ <h3>Take a quick look</h3>
           <div class="v2-plan-foot">
             <button class="v2-plan-chat" id="v2-plan-chat">Open conversation</button>
             <span class="v2-plan-foot-spacer"></span>
+            <button class="v2-plan-export" id="v2-plan-export" hidden>↓ Export plan</button>
             <button class="v2-plan-skip" id="v2-plan-continue">Continue in workspace ›</button>
           </div>
         </section>

From dedc4189be2c091eda2665eb3f28a6836bab4ada Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:01:51 +0530
Subject: [PATCH 120/314] Design doc: active shared lab notebook (memory model)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Captures the brainstormed design for gently's memory substrate — the
agent+human shared lab notebook (concept trace: gently-project/gently#52):

- 3-kind model (Observation/Finding/Question) with author/status/confidence/
  scope/links/artifacts as orthogonal fields, not kinds
- working-memory vs durable-notebook lifespan split; Question as the hinge
  between the notebook (knowing) and the plan layer (doing)
- two-faced presentation: Notebook tab in LIBRARY + Agent's View reborn as
  the ambient live edge
- retrieval principle: structure→indexes, meaning→models, grounded structured
  output; embeddings as a rebuildable sidecar
- what we keep from the old agent mind vs what we fix (dormant apply_updates
  loop, siloed types, no provenance/links/consolidation)
- build decomposition into 5 increments; first slice = the foundation keystone

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../2026-06-16-shared-lab-notebook-design.md  | 162 ++++++++++++++++++
 1 file changed, 162 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md

diff --git a/docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md b/docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md
new file mode 100644
index 00000000..c715d57d
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md
@@ -0,0 +1,162 @@
+# Design: The Active, Shared Lab Notebook (agent + human memory)
+
+Status: design approved in brainstorm (2026-06-16). Concept trace: gently-project/gently#52.
+Branch: `feature/memory-model` (off `feature/ux-v2`, which it depends on for UI).
+
+## 1. Overview
+
+Gently should have one **active, shared lab notebook** — a living memory the agent and
+the scientist co-author. The agent writes from doing the work; the human adds notes,
+literature, thoughts, and annotations; both read it and *think with* it. It accumulates
+across timepoints, sessions, and (eventually) systems.
+
+This replaces today's "agent mind" — a clean conceptual model (`Context`: intentions,
+understanding, observations, expectations, attention) that was never engineered into a
+working system. We keep its good bones and redesign the structure.
+
+### What we keep from the old agent mind
+- The **file-based, human-browsable YAML store** (`FileContextStore`) — auditable, no DB lock-in.
+- **`Observation` as the entry template** (`model.py:379`) — content + refs + significance + embryo/session is already ~90% of a notebook entry.
+- **`basis` + derived `confidence`** on knowledge (`Learning`, `model.py:329`).
+- **`gently_refs`** for pointing at artifacts (`model.py:394`).
+- The **sense → believe → predict → attend** cognitive framing, as the *meaning* of entries.
+- The **event bus + `CONTEXT_UPDATED` → browser** path and the existing `/api/context` surface and "Agent's View" panel (`context-surface.js`).
+
+### What was wrong (and we fix)
+- The write loop is **dormant**: `apply_updates()` (`file_store.py:2178`) is never called anywhere. The mind was designed but never wired to fill.
+- **Six parallel silos, no links** — `Observation.relates_to` exists but is never populated. A set of disconnected lists, not a connected mind.
+- **No author/provenance dimension** — everything is implicitly agent-authored, so it can't be shared/curated.
+- **Working and durable memory are mixed** — live per-embryo predictions sit beside things you'd keep forever.
+- **No consolidation** — raw never becomes distilled on its own.
+- **Type proliferation** — distinctions that should be *fields* (author, status) were encoded as separate *kinds*.
+
+## 2. The data model
+
+### Principle
+A **kind** exists only if the system stores, reasons about, or *shows* it differently.
+Otherwise it is a **field**. This prevents re-proliferation.
+
+### Three kinds
+- **Observation** — a record of something seen, done, read, or noted. *Immutable.* Timestamped evidence.
+- **Finding** — a believed claim / conclusion / insight. *Revisable and supersedable*, with a `basis` (the observations it rests on) and a confidence *derived from evidence*. Can be contradicted — a signal, not an error.
+- **Question** — an open inquiry being chased. Open→answered lifecycle. The large, long-lived ones **are the organizing spine** (the inquiry thread).
+
+### Orthogonal fields (shared by all kinds; NOT new kinds)
+- `author` — human | agent | perception (a human note, a literature ref, and an agent observation are all Observations with different authors).
+- `status` — proposed | confirmed | superseded | answered | … (lifecycle).
+- `confidence` — derived from supporting/contradicting evidence; never self-rated by the model.
+- `scope` — strain / embryo / session / thread (the cross-cut indexes).
+- `links` — typed edges to other entries (supports / contradicts / refines / answers / produced-by). The graph that makes it a wiki, not a log.
+- `artifacts` — pointers into `FileStore` (images, volumes, projections, traces, sessions) by reference, never copied.
+
+### The inquiry thread (the spine)
+A `Question` that grew a body: holds the question, a rolling synthesis, status
+(open/investigating/resolved), and denormalized scope. Membership lives on the entries
+(`threads: [...]`), not in the thread — a flat note pool, derived reverse-indexes
+(`by_thread`, `by_strain`, `by_embryo`) that are rebuildable caches. This lets "by question"
++ "by strain" + links coexist over the flat YAML store with no database.
+
+### Working memory vs. notebook (the lifespan split)
+- **Working memory** (transient, the live loop): the agent's predictions and things-to-watch
+  during a run. A thin runtime layer, *not* notebook entries. When one matters (a violated
+  prediction), it **graduates** into an Observation.
+- **Notebook** (durable): Observations, Findings, Questions — what accumulates.
+
+### The Question is the hinge between knowing and doing
+"What experiments next?" is a Question, but it resolves into **plan items (action)** in the
+existing campaign/plan layer, whereas a scientific question resolves into a **Finding
+(knowledge)**. Same kind, different exit — the system tells them apart by *what they link to*
+(plan items vs findings), no hardcoded subtype. The loop:
+
+```
+Question ("what next?") → brainstorm over Observations + Findings
+   → plan items (a campaign) → run them
+   → Observations → Findings → may answer the scientific Question → thread converges
+```
+
+Knowledge → action → knowledge. The plan/campaign layer (and its export) is the "action" arm.
+
+### Mapping the old six types
+| Old type | New representation |
+|---|---|
+| `Observation` | `Observation` (near-identity; `embryo_id/session_id` → `scope`, `gently_refs` → `artifacts`, `relates_to` → `links`) |
+| `Learning` | `Finding` (`content`→body, `basis`/`confidence` kept) |
+| `Expectation` | working memory; graduates to `Observation` when violated |
+| `Watchpoint` | working memory (live monitoring) |
+| `Question` | `Question` (passing) or inquiry thread (recurring) |
+| `EmbryoUnderstanding` | `Finding`(s) scoped to an embryo; supersession gives stage history |
+
+## 3. Presentation (two faces)
+
+The notebook is **active**, so it can't live only in a tab (the write-only-junk-drawer failure).
+It has two faces:
+
+1. **The Notebook tab** (LIBRARY group, beside Plans and Sessions): the reading room.
+   *Plans = what we'll do · Sessions = what we did · Notebook = what we know.* Landing view
+   organized by the **inquiry-thread spine**, with strain/embryo **filters** and **search +
+   link-graph** navigation. A thread page reads like a living entry — the question, its rolling
+   synthesis, Findings and Observations beneath, and **links out to its campaign(s) in Plans and
+   runs in Sessions**. The three library tabs interlink rather than duplicate.
+
+2. **The ambient edge** — the notebook coming to you, in context (Home, mid-session, planning):
+   the session-start brief, the one-thing surfacing, the brainstorm reply. **This is what
+   "Agent's View" becomes** — repurposed from near-empty transient cognition into the notebook's
+   live edge.
+
+## 4. Retrieval & extraction
+
+Principle: **structure → indexes (deterministic); meaning & judgment → models.**
+(Exact structural retrieval is not a heuristic — it's an index lookup, and a model must not do it.)
+
+Three-layer pipeline:
+1. **Narrow — structural (instant).** Fields/indexes filter by strain, embryo, thread, time,
+   status, link-traversal. Cuts thousands → dozens.
+2. **Recall + rank — semantic.** Embeddings (computed once per entry, kept in a rebuildable
+   sidecar vector cache; YAML stays source of truth) pull semantically-near candidates; an LLM
+   **re-ranks/selects** with reasons. Recall cheap, precision is judgment.
+3. **Synthesize — generation (model).** Thread summaries, session-start briefs, brainstorm
+   answers, contradiction calls, consolidated Findings. Non-negotiable: **grounded + cited**
+   (uncited claim = bug; "not in notebook" is valid), **forced structured output** (validated
+   objects, never re-scraped prose), **ranking from structural facts not self-rated confidence**.
+
+Two query faces:
+- **Agent**: full pipeline feeding its reasoning.
+- **Human search**: *Filter* mode (instant, structural, as-you-type) + *Ask* mode (full grounded
+  LLM answer with citations). No model in the typeahead path.
+
+"Unlimited API credits" removes **cost** (lean on models for judgment/synthesis, frequent
+consolidation, regenerate thread summaries on change) but not **latency** (keep interactive
+filtering model-free) or **hallucination** (grounding + citation + structured output remain the
+guardrails).
+
+## 5. Trust principles
+- Append-only evidence; **supersede, never overwrite**, conclusions (the chain is the history).
+- Agent and human are **separate, attributed voices**; the agent appends/proposes/links, never
+  silently rewrites the human's words.
+- Every claim **carries its basis** and cites the entries it rests on.
+- Confidence is **derived from evidence**, never self-rated.
+- **Revisiting is designed in** — stale findings/questions/unrevisited results resurface.
+
+## 6. Build decomposition (increments)
+
+The full vision is several independently-shippable increments. Ordered by value-vs-risk:
+
+1. **Foundation / keystone — make memory accumulate and be browsable.**
+   Unified `Note` (3 kinds + fields) + store + indexes; wire the dormant producer loop
+   (`apply_updates`) so a session actually writes Observations/Findings; surface a read-only
+   **Notebook tab** (thread-organized) + repurpose Agent's View as the live edge.
+   *Produce (perception/agent) → store (notebook) → consume (tab + ambient read).*
+2. **Retrieval & brainstorm** — structural indexes + embeddings sidecar + grounded LLM
+   synthesis; the "Ask the notebook" + agent brainstorm pipeline.
+3. **Human authorship & curation** — human-authored entries/annotations (on images/embryos),
+   proposed→confirmed curation, supersession UI.
+4. **Active surfacing & consolidation** — structural triggers (contradiction / answered-question
+   / violated-expectation / echo), throttled one-at-a-moment; scheduled reflection passes.
+5. **Cross-system** — sharing/sync of the notebook across instances ("shared brain").
+
+**First slice = Increment 1** (the keystone): it proves the model end-to-end and turns the
+"wired but starving" problem into the first visible win. Increment 1 gets its own
+implementation plan.
+
+## 7. Out of scope (for now)
+Cross-system sync (incr. 5), proactive surfacing tuning (incr. 4) — designed here, built later.

From e89161fee45f649a98b418bc501f7a5fa6b71e40 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:07:12 +0530
Subject: [PATCH 121/314] =?UTF-8?q?plan:=20notebook=20foundation=20(Note?=
 =?UTF-8?q?=20model=20+=20NotebookStore)=20=E2=80=94=20increment=201=20key?=
 =?UTF-8?q?stone?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../plans/2026-06-16-notebook-foundation.md   | 645 ++++++++++++++++++
 1 file changed, 645 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-16-notebook-foundation.md

diff --git a/docs/superpowers/plans/2026-06-16-notebook-foundation.md b/docs/superpowers/plans/2026-06-16-notebook-foundation.md
new file mode 100644
index 00000000..4d6a480c
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-16-notebook-foundation.md
@@ -0,0 +1,645 @@
+# Notebook Foundation Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Build the unit-testable foundation of the shared lab notebook — the unified `Note` model and a file-backed `NotebookStore` (write / read / scope-query / rebuildable reverse-indexes / link & supersede) — with no UI, API, or agent wiring.
+
+**Architecture:** A new self-contained module `gently/harness/memory/notebook.py`. One `Note` dataclass (three kinds: observation/finding/question) with author, status, confidence, scope facets (strains/embryos/sessions/threads), typed links, basis, and artifact pointers — orthogonal fields, not subtypes. `NotebookStore` persists one YAML per note under `notebook/notes/{id}_{slug}.yaml` (atomic write, mirroring `FileContextStore`), maintains rebuildable reverse-indexes by strain/embryo/thread, and answers scope+kind+status queries. This is Increment 1's keystone from the design doc (`docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md`).
+
+**Tech Stack:** Python 3.11, dataclasses, `str`-Enums, PyYAML, pytest (fixtures in `tests/conftest.py`, flat `tests/` layout).
+
+**Follow-on plans (NOT in scope here):** producer wiring (`apply_updates` → notebook), `/api/notebook` + Notebook tab (UI), retrieval/embeddings + brainstorm. Each ships on top of this foundation.
+
+---
+
+### Task 1: The `Note` model
+
+**Files:**
+- Create: `gently/harness/memory/notebook.py`
+- Test: `tests/test_notebook_store.py`
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_notebook_store.py
+"""Tests for the shared lab notebook: Note model + NotebookStore."""
+
+from datetime import datetime
+
+from gently.harness.memory.model import Confidence
+from gently.harness.memory.notebook import (
+    Author,
+    Note,
+    NoteKind,
+    NoteStatus,
+    note_from_dict,
+    note_to_dict,
+)
+
+
+class TestNoteModel:
+    def test_round_trip_minimal(self):
+        n = Note(id="abc123", kind=NoteKind.OBSERVATION, body="dim rings at 10 ms")
+        d = note_to_dict(n)
+        assert d["kind"] == "observation"
+        assert d["author"] == "agent"            # default
+        assert d["status"] == "confirmed"        # default
+        back = note_from_dict(d)
+        assert back == n
+
+    def test_round_trip_full(self):
+        n = Note(
+            id="def456",
+            kind=NoteKind.FINDING,
+            body="temperature shifts timing ~12 min/degC",
+            author=Author.AGENT,
+            title="Temp shifts timing",
+            status=NoteStatus.PROPOSED,
+            confidence=Confidence.MEDIUM,
+            strains=["N2", "OH904"],
+            embryos=["emb_0007"],
+            sessions=["20260615_1432_x"],
+            threads=["q_division_temp"],
+            basis=["obs_1", "obs_2"],
+            links=[{"rel": "supports", "to": "q_division_temp"}],
+            artifacts=[{"kind": "projection", "session": "s1", "embryo": "emb_0007", "t": 42}],
+            created_at=datetime(2026, 6, 16, 11, 0, 0),
+            updated_at=datetime(2026, 6, 16, 11, 0, 0),
+        )
+        back = note_from_dict(note_to_dict(n))
+        assert back == n
+        assert note_to_dict(n)["confidence"] == "medium"
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNoteModel -v`
+Expected: FAIL — `ModuleNotFoundError: No module named 'gently.harness.memory.notebook'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# gently/harness/memory/notebook.py
+"""
+The shared lab notebook — unified memory entry (Note) and file-backed store.
+
+One Note kind taxonomy (observation / finding / question); everything else
+(author, status, confidence, scope, links) is an orthogonal field. See
+docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from typing import Any
+
+from .model import Confidence
+
+
+class NoteKind(str, Enum):
+    OBSERVATION = "observation"  # immutable record of what was seen/done/read/noted
+    FINDING = "finding"          # revisable, supersedable believed claim
+    QUESTION = "question"        # open inquiry; large ones are the thread spine
+
+
+class Author(str, Enum):
+    HUMAN = "human"
+    AGENT = "agent"
+    PERCEPTION = "perception"
+
+
+class NoteStatus(str, Enum):
+    OPEN = "open"              # questions not yet answered
+    PROPOSED = "proposed"      # agent-drafted finding awaiting human confirm
+    CONFIRMED = "confirmed"    # accepted observation/finding (default)
+    ANSWERED = "answered"      # question resolved
+    SUPERSEDED = "superseded"  # replaced by a newer note
+
+
+@dataclass
+class Note:
+    id: str
+    kind: NoteKind
+    body: str
+    author: Author = Author.AGENT
+    title: str | None = None
+    status: NoteStatus = NoteStatus.CONFIRMED
+    confidence: Confidence | None = None
+    strains: list[str] = field(default_factory=list)
+    embryos: list[str] = field(default_factory=list)
+    sessions: list[str] = field(default_factory=list)
+    threads: list[str] = field(default_factory=list)
+    basis: list[str] = field(default_factory=list)        # note ids this rests on
+    links: list[dict] = field(default_factory=list)        # [{"rel": ..., "to": ...}]
+    artifacts: list[dict] = field(default_factory=list)    # FileStore pointers
+    superseded_by: str | None = None
+    created_at: datetime = field(default_factory=datetime.now)
+    updated_at: datetime = field(default_factory=datetime.now)
+
+
+def note_to_dict(n: Note) -> dict[str, Any]:
+    return {
+        "id": n.id,
+        "kind": n.kind.value,
+        "body": n.body,
+        "author": n.author.value,
+        "title": n.title,
+        "status": n.status.value,
+        "confidence": n.confidence.value if n.confidence else None,
+        "strains": list(n.strains),
+        "embryos": list(n.embryos),
+        "sessions": list(n.sessions),
+        "threads": list(n.threads),
+        "basis": list(n.basis),
+        "links": list(n.links),
+        "artifacts": list(n.artifacts),
+        "superseded_by": n.superseded_by,
+        "created_at": n.created_at.isoformat(),
+        "updated_at": n.updated_at.isoformat(),
+    }
+
+
+def note_from_dict(d: dict[str, Any]) -> Note:
+    conf = d.get("confidence")
+    return Note(
+        id=d["id"],
+        kind=NoteKind(d["kind"]),
+        body=d.get("body", ""),
+        author=Author(d.get("author", "agent")),
+        title=d.get("title"),
+        status=NoteStatus(d.get("status", "confirmed")),
+        confidence=Confidence(conf) if conf else None,
+        strains=list(d.get("strains") or []),
+        embryos=list(d.get("embryos") or []),
+        sessions=list(d.get("sessions") or []),
+        threads=list(d.get("threads") or []),
+        basis=list(d.get("basis") or []),
+        links=list(d.get("links") or []),
+        artifacts=list(d.get("artifacts") or []),
+        superseded_by=d.get("superseded_by"),
+        created_at=datetime.fromisoformat(d["created_at"]),
+        updated_at=datetime.fromisoformat(d["updated_at"]),
+    )
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNoteModel -v`
+Expected: PASS (2 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook.py tests/test_notebook_store.py
+git commit -m "feat(notebook): unified Note model + dict serialization"
+```
+
+---
+
+### Task 2: `NotebookStore` — write & read a note
+
+**Files:**
+- Modify: `gently/harness/memory/notebook.py` (append `NotebookStore`)
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+from gently.harness.memory.notebook import NotebookStore
+
+
+class TestNotebookStoreReadWrite:
+    def test_write_assigns_id_and_persists(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        n = Note(id="", kind=NoteKind.OBSERVATION, body="bean stage at t40")
+        note_id = store.write_note(n)
+        assert note_id  # non-empty id assigned
+        files = list((tmp_path / "notebook" / "notes").glob("*.yaml"))
+        assert len(files) == 1
+        assert files[0].name.startswith(note_id + "_")
+
+    def test_get_note_round_trip(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        n = Note(id="", kind=NoteKind.FINDING, body="x", strains=["N2"], threads=["t1"])
+        note_id = store.write_note(n)
+        got = store.get_note(note_id)
+        assert got is not None
+        assert got.id == note_id
+        assert got.kind == NoteKind.FINDING
+        assert got.strains == ["N2"]
+
+    def test_get_missing_returns_none(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        assert store.get_note("nope") is None
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookStoreReadWrite -v`
+Expected: FAIL — `ImportError: cannot import name 'NotebookStore'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# append to gently/harness/memory/notebook.py
+import copy
+import os
+import re
+import uuid
+from pathlib import Path
+
+import yaml
+
+
+class NotebookStore:
+    """File-backed store for notebook Notes. One YAML per note under notes/;
+    flat pool, rebuildable reverse-indexes (added in Task 3)."""
+
+    def __init__(self, notebook_dir: Path):
+        self.root = Path(notebook_dir)
+        self.notes_dir = self.root / "notes"
+        self.index_dir = self.root / "index"
+        self.notes_dir.mkdir(parents=True, exist_ok=True)
+        self.index_dir.mkdir(parents=True, exist_ok=True)
+
+    # ---- helpers (mirror FileContextStore conventions) ----
+    @staticmethod
+    def _gen_id() -> str:
+        return str(uuid.uuid4())[:8]
+
+    @staticmethod
+    def _slugify(text: str) -> str:
+        slug = re.sub(r"[^a-z0-9]+", "-", (text or "").lower()).strip("-")
+        return slug[:30]
+
+    def _write_yaml(self, path: Path, data: dict) -> None:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        tmp = path.with_suffix(".tmp")
+        with open(tmp, "w", encoding="utf-8") as fh:
+            yaml.safe_dump(data, fh, default_flow_style=False, allow_unicode=True, sort_keys=False)
+        os.replace(str(tmp), str(path))
+
+    def _read_yaml(self, path: Path) -> dict | None:
+        try:
+            with open(path, encoding="utf-8") as fh:
+                return yaml.safe_load(fh)
+        except OSError:
+            return None
+
+    def _note_path(self, note_id: str) -> Path | None:
+        return next(self.notes_dir.glob(f"{note_id}_*.yaml"), None)
+
+    # ---- read/write ----
+    def write_note(self, note: Note) -> str:
+        if not note.id:
+            note.id = self._gen_id()
+        note.updated_at = datetime.now()
+        slug = self._slugify(note.title or note.body or note.kind.value)
+        # remove any stale file for this id (slug may have changed)
+        old = self._note_path(note.id)
+        if old is not None:
+            old.unlink()
+        self._write_yaml(self.notes_dir / f"{note.id}_{slug}.yaml", note_to_dict(note))
+        return note.id
+
+    def get_note(self, note_id: str) -> Note | None:
+        path = self._note_path(note_id)
+        if path is None:
+            return None
+        data = self._read_yaml(path)
+        return note_from_dict(data) if data else None
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookStoreReadWrite -v`
+Expected: PASS (3 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook.py tests/test_notebook_store.py
+git commit -m "feat(notebook): NotebookStore write_note/get_note with atomic YAML"
+```
+
+---
+
+### Task 3: Reverse-indexes (by strain / embryo / thread) + rebuild
+
+**Files:**
+- Modify: `gently/harness/memory/notebook.py` (`NotebookStore`)
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+class TestNotebookIndex:
+    def test_index_updated_on_write(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="a", strains=["N2"]))
+        b = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="b", strains=["N2", "OH904"]))
+        assert set(store.ids_for_strain("N2")) == {a, b}
+        assert store.ids_for_strain("OH904") == [b]
+        assert store.ids_for_strain("missing") == []
+
+    def test_index_by_embryo_and_thread(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.FINDING, body="a",
+                                  embryos=["e1"], threads=["t1"]))
+        assert store.ids_for_embryo("e1") == [a]
+        assert store.ids_for_thread("t1") == [a]
+
+    def test_rebuild_index_from_disk(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="a", strains=["N2"]))
+        # a fresh store over the same dir must rebuild the index by scanning notes/
+        store2 = NotebookStore(tmp_path / "notebook")
+        assert store2.ids_for_strain("N2") == [a]
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookIndex -v`
+Expected: FAIL — `AttributeError: 'NotebookStore' object has no attribute 'ids_for_strain'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+Modify `NotebookStore.__init__` to add index state + rebuild, extend `write_note` to update the index, and add the index methods. Replace the existing `__init__` and `write_note` with these versions and add the new methods:
+
+```python
+    # --- replace __init__ ---
+    def __init__(self, notebook_dir: Path):
+        self.root = Path(notebook_dir)
+        self.notes_dir = self.root / "notes"
+        self.index_dir = self.root / "index"
+        self.notes_dir.mkdir(parents=True, exist_ok=True)
+        self.index_dir.mkdir(parents=True, exist_ok=True)
+        # reverse indexes: facet -> {value: [note_id, ...]}
+        self._index: dict[str, dict[str, list[str]]] = {
+            "strain": {}, "embryo": {}, "thread": {}
+        }
+        self.rebuild_index()
+
+    # --- add: facet extraction + index maintenance ---
+    _FACETS = {"strain": "strains", "embryo": "embryos", "thread": "threads"}
+
+    def _index_note(self, note: Note) -> None:
+        for facet, attr in self._FACETS.items():
+            for value in getattr(note, attr):
+                bucket = self._index[facet].setdefault(value, [])
+                if note.id not in bucket:
+                    bucket.append(note.id)
+
+    def rebuild_index(self) -> None:
+        """Rebuild reverse-indexes by scanning notes/ (the notes are authoritative;
+        indexes are disposable caches)."""
+        self._index = {"strain": {}, "embryo": {}, "thread": {}}
+        for f in sorted(self.notes_dir.glob("*.yaml")):
+            data = self._read_yaml(f)
+            if data:
+                self._index_note(note_from_dict(data))
+
+    def ids_for_strain(self, strain: str) -> list[str]:
+        return list(self._index["strain"].get(strain, []))
+
+    def ids_for_embryo(self, embryo: str) -> list[str]:
+        return list(self._index["embryo"].get(embryo, []))
+
+    def ids_for_thread(self, thread: str) -> list[str]:
+        return list(self._index["thread"].get(thread, []))
+```
+
+Then add an index-update at the end of `write_note` (just before `return note.id`):
+
+```python
+        self._index_note(note)
+        return note.id
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookIndex -v`
+Expected: PASS (3 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook.py tests/test_notebook_store.py
+git commit -m "feat(notebook): rebuildable reverse-indexes by strain/embryo/thread"
+```
+
+---
+
+### Task 4: `query_notes` — filter by kind / author / status / scope
+
+**Files:**
+- Modify: `gently/harness/memory/notebook.py` (`NotebookStore`)
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+class TestNotebookQuery:
+    def _seed(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        store.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="o", strains=["N2"]))
+        store.write_note(Note(id="f1", kind=NoteKind.FINDING, body="f",
+                              status=NoteStatus.PROPOSED, strains=["N2"], threads=["t1"]))
+        store.write_note(Note(id="q1", kind=NoteKind.QUESTION, body="q",
+                              status=NoteStatus.OPEN, threads=["t1"]))
+        return store
+
+    def test_query_by_kind(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(kind=NoteKind.FINDING)}
+        assert ids == {"f1"}
+
+    def test_query_by_thread_scope(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(thread="t1")}
+        assert ids == {"f1", "q1"}
+
+    def test_query_by_thread_and_kind(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(thread="t1", kind=NoteKind.QUESTION)}
+        assert ids == {"q1"}
+
+    def test_query_by_status(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(status=NoteStatus.OPEN)}
+        assert ids == {"q1"}
+
+    def test_query_all_sorted_newest_first(self, tmp_path):
+        store = self._seed(tmp_path)
+        notes = store.query_notes()
+        assert len(notes) == 3
+        ts = [n.created_at for n in notes]
+        assert ts == sorted(ts, reverse=True)
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookQuery -v`
+Expected: FAIL — `AttributeError: 'NotebookStore' object has no attribute 'query_notes'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# add to NotebookStore
+    def query_notes(
+        self,
+        *,
+        kind: NoteKind | None = None,
+        author: Author | None = None,
+        status: NoteStatus | None = None,
+        strain: str | None = None,
+        embryo: str | None = None,
+        thread: str | None = None,
+    ) -> list[Note]:
+        """Structural query: narrow by scope via the indexes, then filter by
+        kind/author/status. Returned newest-first. (No semantic ranking here —
+        that's a later increment.)"""
+        # 1. candidate ids — intersect any scope facets given, else all notes
+        scope_sets: list[set[str]] = []
+        if strain is not None:
+            scope_sets.append(set(self.ids_for_strain(strain)))
+        if embryo is not None:
+            scope_sets.append(set(self.ids_for_embryo(embryo)))
+        if thread is not None:
+            scope_sets.append(set(self.ids_for_thread(thread)))
+        if scope_sets:
+            candidate_ids: set[str] | None = set.intersection(*scope_sets)
+        else:
+            candidate_ids = None  # means "all"
+
+        # 2. load + filter
+        results: list[Note] = []
+        if candidate_ids is not None:
+            notes = [n for n in (self.get_note(i) for i in candidate_ids) if n]
+        else:
+            notes = [
+                note_from_dict(d)
+                for d in (self._read_yaml(f) for f in self.notes_dir.glob("*.yaml"))
+                if d
+            ]
+        for n in notes:
+            if kind is not None and n.kind != kind:
+                continue
+            if author is not None and n.author != author:
+                continue
+            if status is not None and n.status != status:
+                continue
+            results.append(n)
+        results.sort(key=lambda n: n.created_at, reverse=True)
+        return results
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookQuery -v`
+Expected: PASS (5 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook.py tests/test_notebook_store.py
+git commit -m "feat(notebook): query_notes by kind/author/status/scope"
+```
+
+---
+
+### Task 5: `link_notes` and `supersede_note`
+
+**Files:**
+- Modify: `gently/harness/memory/notebook.py` (`NotebookStore`)
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+class TestNotebookLinkSupersede:
+    def test_link_notes_adds_typed_edge(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.FINDING, body="a"))
+        b = store.write_note(Note(id="", kind=NoteKind.QUESTION, body="b"))
+        store.link_notes(a, "supports", b)
+        got = store.get_note(a)
+        assert {"rel": "supports", "to": b} in got.links
+
+    def test_supersede_marks_old_and_points_new(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        old = store.write_note(Note(id="", kind=NoteKind.FINDING, body="old claim"))
+        new = store.write_note(Note(id="", kind=NoteKind.FINDING, body="better claim"))
+        store.supersede_note(old, new)
+        old_n = store.get_note(old)
+        new_n = store.get_note(new)
+        assert old_n.status == NoteStatus.SUPERSEDED
+        assert old_n.superseded_by == new
+        assert {"rel": "refines", "to": old} in new_n.links
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestNotebookLinkSupersede -v`
+Expected: FAIL — `AttributeError: 'NotebookStore' object has no attribute 'link_notes'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# add to NotebookStore
+    def link_notes(self, from_id: str, rel: str, to_id: str) -> None:
+        """Add a typed edge from one note to another (append-only)."""
+        note = self.get_note(from_id)
+        if note is None:
+            raise KeyError(from_id)
+        edge = {"rel": rel, "to": to_id}
+        if edge not in note.links:
+            note.links.append(edge)
+            self.write_note(note)
+
+    def supersede_note(self, old_id: str, new_id: str) -> None:
+        """Mark old as superseded (kept, never deleted) and link the new note
+        back to it as a refinement — the chain is the intellectual history."""
+        old = self.get_note(old_id)
+        if old is None:
+            raise KeyError(old_id)
+        old.status = NoteStatus.SUPERSEDED
+        old.superseded_by = new_id
+        self.write_note(old)
+        self.link_notes(new_id, "refines", old_id)
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py -v`
+Expected: PASS (all tests across all classes pass)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook.py tests/test_notebook_store.py
+git commit -m "feat(notebook): link_notes + supersede_note (append-only history)"
+```
+
+---
+
+## Self-Review
+
+**Spec coverage (against the design doc §2 data model):**
+- Three kinds (Observation/Finding/Question) → Task 1 `NoteKind`. ✓
+- Orthogonal fields (author/status/confidence/scope/links/artifacts) → Task 1 `Note`. ✓
+- Flat note pool + rebuildable reverse-indexes (strain/embryo/thread) → Tasks 2-3. ✓
+- "By question + by strain + links coexist over flat YAML, no DB" → Tasks 3-4 (indexes + scope-intersect query). ✓
+- Append-only / supersede-never-overwrite → Task 5 `supersede_note`. ✓
+- Typed links graph → Tasks 1 (`links`) + 5 (`link_notes`). ✓
+- *Deferred to follow-on plans (correctly out of scope):* inquiry-thread object, working-memory split, producer wiring, API/tab, embeddings/retrieval, consolidation. Noted in header.
+
+**Placeholder scan:** No TBD/TODO; every code step shows complete code; commands have expected output. ✓
+
+**Type consistency:** `Note`, `NoteKind`, `Author`, `NoteStatus`, `note_to_dict`/`note_from_dict`, and `NotebookStore.{write_note,get_note,rebuild_index,ids_for_strain,ids_for_embryo,ids_for_thread,query_notes,link_notes,supersede_note}` are named identically across all tasks and tests. `Confidence` is imported from `.model` (confirmed to exist). ✓

From 60cd40a49cb9abf2c4528e669df74271fa099f15 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:12:56 +0530
Subject: [PATCH 122/314] feat(notebook): unified Note model + dict
 serialization

---
 gently/harness/memory/notebook.py | 109 ++++++++++++++++++++++++++++++
 tests/test_notebook_store.py      |  47 +++++++++++++
 2 files changed, 156 insertions(+)
 create mode 100644 gently/harness/memory/notebook.py
 create mode 100644 tests/test_notebook_store.py

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
new file mode 100644
index 00000000..49e35b1c
--- /dev/null
+++ b/gently/harness/memory/notebook.py
@@ -0,0 +1,109 @@
+"""
+The shared lab notebook — unified memory entry (Note) and file-backed store.
+
+One Note kind taxonomy (observation / finding / question); everything else
+(author, status, confidence, scope, links) is an orthogonal field. See
+docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md.
+"""
+
+from __future__ import annotations
+
+import copy
+import os
+import re
+import uuid
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+from .model import Confidence
+
+
+class NoteKind(str, Enum):
+    OBSERVATION = "observation"  # immutable record of what was seen/done/read/noted
+    FINDING = "finding"          # revisable, supersedable believed claim
+    QUESTION = "question"        # open inquiry; large ones are the thread spine
+
+
+class Author(str, Enum):
+    HUMAN = "human"
+    AGENT = "agent"
+    PERCEPTION = "perception"
+
+
+class NoteStatus(str, Enum):
+    OPEN = "open"              # questions not yet answered
+    PROPOSED = "proposed"      # agent-drafted finding awaiting human confirm
+    CONFIRMED = "confirmed"    # accepted observation/finding (default)
+    ANSWERED = "answered"      # question resolved
+    SUPERSEDED = "superseded"  # replaced by a newer note
+
+
+@dataclass
+class Note:
+    id: str
+    kind: NoteKind
+    body: str
+    author: Author = Author.AGENT
+    title: str | None = None
+    status: NoteStatus = NoteStatus.CONFIRMED
+    confidence: Confidence | None = None
+    strains: list[str] = field(default_factory=list)
+    embryos: list[str] = field(default_factory=list)
+    sessions: list[str] = field(default_factory=list)
+    threads: list[str] = field(default_factory=list)
+    basis: list[str] = field(default_factory=list)        # note ids this rests on
+    links: list[dict] = field(default_factory=list)        # [{"rel": ..., "to": ...}]
+    artifacts: list[dict] = field(default_factory=list)    # FileStore pointers
+    superseded_by: str | None = None
+    created_at: datetime = field(default_factory=datetime.now)
+    updated_at: datetime = field(default_factory=datetime.now)
+
+
+def note_to_dict(n: Note) -> dict[str, Any]:
+    return {
+        "id": n.id,
+        "kind": n.kind.value,
+        "body": n.body,
+        "author": n.author.value,
+        "title": n.title,
+        "status": n.status.value,
+        "confidence": n.confidence.value if n.confidence else None,
+        "strains": list(n.strains),
+        "embryos": list(n.embryos),
+        "sessions": list(n.sessions),
+        "threads": list(n.threads),
+        "basis": list(n.basis),
+        "links": list(n.links),
+        "artifacts": list(n.artifacts),
+        "superseded_by": n.superseded_by,
+        "created_at": n.created_at.isoformat(),
+        "updated_at": n.updated_at.isoformat(),
+    }
+
+
+def note_from_dict(d: dict[str, Any]) -> Note:
+    conf = d.get("confidence")
+    return Note(
+        id=d["id"],
+        kind=NoteKind(d["kind"]),
+        body=d.get("body", ""),
+        author=Author(d.get("author", "agent")),
+        title=d.get("title"),
+        status=NoteStatus(d.get("status", "confirmed")),
+        confidence=Confidence(conf) if conf else None,
+        strains=list(d.get("strains") or []),
+        embryos=list(d.get("embryos") or []),
+        sessions=list(d.get("sessions") or []),
+        threads=list(d.get("threads") or []),
+        basis=list(d.get("basis") or []),
+        links=list(d.get("links") or []),
+        artifacts=list(d.get("artifacts") or []),
+        superseded_by=d.get("superseded_by"),
+        created_at=datetime.fromisoformat(d["created_at"]),
+        updated_at=datetime.fromisoformat(d["updated_at"]),
+    )
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
new file mode 100644
index 00000000..fa04a667
--- /dev/null
+++ b/tests/test_notebook_store.py
@@ -0,0 +1,47 @@
+"""Tests for the shared lab notebook: Note model + NotebookStore."""
+
+from datetime import datetime
+
+from gently.harness.memory.model import Confidence
+from gently.harness.memory.notebook import (
+    Author,
+    Note,
+    NoteKind,
+    NoteStatus,
+    note_from_dict,
+    note_to_dict,
+)
+
+
+class TestNoteModel:
+    def test_round_trip_minimal(self):
+        n = Note(id="abc123", kind=NoteKind.OBSERVATION, body="dim rings at 10 ms")
+        d = note_to_dict(n)
+        assert d["kind"] == "observation"
+        assert d["author"] == "agent"            # default
+        assert d["status"] == "confirmed"        # default
+        back = note_from_dict(d)
+        assert back == n
+
+    def test_round_trip_full(self):
+        n = Note(
+            id="def456",
+            kind=NoteKind.FINDING,
+            body="temperature shifts timing ~12 min/degC",
+            author=Author.AGENT,
+            title="Temp shifts timing",
+            status=NoteStatus.PROPOSED,
+            confidence=Confidence.MEDIUM,
+            strains=["N2", "OH904"],
+            embryos=["emb_0007"],
+            sessions=["20260615_1432_x"],
+            threads=["q_division_temp"],
+            basis=["obs_1", "obs_2"],
+            links=[{"rel": "supports", "to": "q_division_temp"}],
+            artifacts=[{"kind": "projection", "session": "s1", "embryo": "emb_0007", "t": 42}],
+            created_at=datetime(2026, 6, 16, 11, 0, 0),
+            updated_at=datetime(2026, 6, 16, 11, 0, 0),
+        )
+        back = note_from_dict(note_to_dict(n))
+        assert back == n
+        assert note_to_dict(n)["confidence"] == "medium"

From d15607dc62f81e76c46874c3f1661bb68fa4b20d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:15:26 +0530
Subject: [PATCH 123/314] feat(notebook): NotebookStore write_note/get_note
 with atomic YAML

---
 gently/harness/memory/notebook.py | 60 ++++++++++++++++++++++++++++++-
 tests/test_notebook_store.py      | 26 ++++++++++++++
 2 files changed, 85 insertions(+), 1 deletion(-)

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
index 49e35b1c..f3ec01e5 100644
--- a/gently/harness/memory/notebook.py
+++ b/gently/harness/memory/notebook.py
@@ -8,7 +8,6 @@
 
 from __future__ import annotations
 
-import copy
 import os
 import re
 import uuid
@@ -107,3 +106,62 @@ def note_from_dict(d: dict[str, Any]) -> Note:
         created_at=datetime.fromisoformat(d["created_at"]),
         updated_at=datetime.fromisoformat(d["updated_at"]),
     )
+
+
+class NotebookStore:
+    """File-backed store for notebook Notes. One YAML per note under notes/;
+    flat pool, rebuildable reverse-indexes (added in Task 3)."""
+
+    def __init__(self, notebook_dir: Path):
+        self.root = Path(notebook_dir)
+        self.notes_dir = self.root / "notes"
+        self.index_dir = self.root / "index"
+        self.notes_dir.mkdir(parents=True, exist_ok=True)
+        self.index_dir.mkdir(parents=True, exist_ok=True)
+
+    # ---- helpers (mirror FileContextStore conventions) ----
+    @staticmethod
+    def _gen_id() -> str:
+        return str(uuid.uuid4())[:8]
+
+    @staticmethod
+    def _slugify(text: str) -> str:
+        slug = re.sub(r"[^a-z0-9]+", "-", (text or "").lower()).strip("-")
+        return slug[:30]
+
+    def _write_yaml(self, path: Path, data: dict) -> None:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        tmp = path.with_suffix(".tmp")
+        with open(tmp, "w", encoding="utf-8") as fh:
+            yaml.safe_dump(data, fh, default_flow_style=False, allow_unicode=True, sort_keys=False)
+        os.replace(str(tmp), str(path))
+
+    def _read_yaml(self, path: Path) -> dict | None:
+        try:
+            with open(path, encoding="utf-8") as fh:
+                return yaml.safe_load(fh)
+        except OSError:
+            return None
+
+    def _note_path(self, note_id: str) -> Path | None:
+        return next(self.notes_dir.glob(f"{note_id}_*.yaml"), None)
+
+    # ---- read/write ----
+    def write_note(self, note: Note) -> str:
+        if not note.id:
+            note.id = self._gen_id()
+        note.updated_at = datetime.now()
+        slug = self._slugify(note.title or note.body or note.kind.value)
+        # remove any stale file for this id (slug may have changed)
+        old = self._note_path(note.id)
+        if old is not None:
+            old.unlink()
+        self._write_yaml(self.notes_dir / f"{note.id}_{slug}.yaml", note_to_dict(note))
+        return note.id
+
+    def get_note(self, note_id: str) -> Note | None:
+        path = self._note_path(note_id)
+        if path is None:
+            return None
+        data = self._read_yaml(path)
+        return note_from_dict(data) if data else None
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index fa04a667..c157ea81 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -8,6 +8,7 @@
     Note,
     NoteKind,
     NoteStatus,
+    NotebookStore,
     note_from_dict,
     note_to_dict,
 )
@@ -45,3 +46,28 @@ def test_round_trip_full(self):
         back = note_from_dict(note_to_dict(n))
         assert back == n
         assert note_to_dict(n)["confidence"] == "medium"
+
+
+class TestNotebookStoreReadWrite:
+    def test_write_assigns_id_and_persists(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        n = Note(id="", kind=NoteKind.OBSERVATION, body="bean stage at t40")
+        note_id = store.write_note(n)
+        assert note_id  # non-empty id assigned
+        files = list((tmp_path / "notebook" / "notes").glob("*.yaml"))
+        assert len(files) == 1
+        assert files[0].name.startswith(note_id + "_")
+
+    def test_get_note_round_trip(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        n = Note(id="", kind=NoteKind.FINDING, body="x", strains=["N2"], threads=["t1"])
+        note_id = store.write_note(n)
+        got = store.get_note(note_id)
+        assert got is not None
+        assert got.id == note_id
+        assert got.kind == NoteKind.FINDING
+        assert got.strains == ["N2"]
+
+    def test_get_missing_returns_none(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        assert store.get_note("nope") is None

From 5225811727179ba401690c92450fac8cf5a55262 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:17:39 +0530
Subject: [PATCH 124/314] feat(notebook): rebuildable reverse-indexes by
 strain/embryo/thread

---
 gently/harness/memory/notebook.py | 33 +++++++++++++++++++++++++++++++
 tests/test_notebook_store.py      | 24 ++++++++++++++++++++++
 2 files changed, 57 insertions(+)

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
index f3ec01e5..3f776e68 100644
--- a/gently/harness/memory/notebook.py
+++ b/gently/harness/memory/notebook.py
@@ -112,12 +112,44 @@ class NotebookStore:
     """File-backed store for notebook Notes. One YAML per note under notes/;
     flat pool, rebuildable reverse-indexes (added in Task 3)."""
 
+    _FACETS = {"strain": "strains", "embryo": "embryos", "thread": "threads"}
+
     def __init__(self, notebook_dir: Path):
         self.root = Path(notebook_dir)
         self.notes_dir = self.root / "notes"
         self.index_dir = self.root / "index"
         self.notes_dir.mkdir(parents=True, exist_ok=True)
         self.index_dir.mkdir(parents=True, exist_ok=True)
+        # reverse indexes: facet -> {value: [note_id, ...]}
+        self._index: dict[str, dict[str, list[str]]] = {
+            "strain": {}, "embryo": {}, "thread": {}
+        }
+        self.rebuild_index()
+
+    # ---- reverse indexes (notes are authoritative; indexes are caches) ----
+    def _index_note(self, note: Note) -> None:
+        for facet, attr in self._FACETS.items():
+            for value in getattr(note, attr):
+                bucket = self._index[facet].setdefault(value, [])
+                if note.id not in bucket:
+                    bucket.append(note.id)
+
+    def rebuild_index(self) -> None:
+        """Rebuild reverse-indexes by scanning notes/."""
+        self._index = {"strain": {}, "embryo": {}, "thread": {}}
+        for f in sorted(self.notes_dir.glob("*.yaml")):
+            data = self._read_yaml(f)
+            if data:
+                self._index_note(note_from_dict(data))
+
+    def ids_for_strain(self, strain: str) -> list[str]:
+        return list(self._index["strain"].get(strain, []))
+
+    def ids_for_embryo(self, embryo: str) -> list[str]:
+        return list(self._index["embryo"].get(embryo, []))
+
+    def ids_for_thread(self, thread: str) -> list[str]:
+        return list(self._index["thread"].get(thread, []))
 
     # ---- helpers (mirror FileContextStore conventions) ----
     @staticmethod
@@ -157,6 +189,7 @@ def write_note(self, note: Note) -> str:
         if old is not None:
             old.unlink()
         self._write_yaml(self.notes_dir / f"{note.id}_{slug}.yaml", note_to_dict(note))
+        self._index_note(note)
         return note.id
 
     def get_note(self, note_id: str) -> Note | None:
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index c157ea81..75b85381 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -71,3 +71,27 @@ def test_get_note_round_trip(self, tmp_path):
     def test_get_missing_returns_none(self, tmp_path):
         store = NotebookStore(tmp_path / "notebook")
         assert store.get_note("nope") is None
+
+
+class TestNotebookIndex:
+    def test_index_updated_on_write(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="a", strains=["N2"]))
+        b = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="b", strains=["N2", "OH904"]))
+        assert set(store.ids_for_strain("N2")) == {a, b}
+        assert store.ids_for_strain("OH904") == [b]
+        assert store.ids_for_strain("missing") == []
+
+    def test_index_by_embryo_and_thread(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.FINDING, body="a",
+                                  embryos=["e1"], threads=["t1"]))
+        assert store.ids_for_embryo("e1") == [a]
+        assert store.ids_for_thread("t1") == [a]
+
+    def test_rebuild_index_from_disk(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="a", strains=["N2"]))
+        # a fresh store over the same dir must rebuild the index by scanning notes/
+        store2 = NotebookStore(tmp_path / "notebook")
+        assert store2.ids_for_strain("N2") == [a]

From 9ba23c9d3e34f3bfae0e85cf8827f6ea93c1a9bc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:19:30 +0530
Subject: [PATCH 125/314] feat(notebook): query_notes by
 kind/author/status/scope

---
 gently/harness/memory/notebook.py | 46 +++++++++++++++++++++++++++++++
 tests/test_notebook_store.py      | 38 +++++++++++++++++++++++++
 2 files changed, 84 insertions(+)

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
index 3f776e68..0678d9f4 100644
--- a/gently/harness/memory/notebook.py
+++ b/gently/harness/memory/notebook.py
@@ -198,3 +198,49 @@ def get_note(self, note_id: str) -> Note | None:
             return None
         data = self._read_yaml(path)
         return note_from_dict(data) if data else None
+
+    def query_notes(
+        self,
+        *,
+        kind: NoteKind | None = None,
+        author: Author | None = None,
+        status: NoteStatus | None = None,
+        strain: str | None = None,
+        embryo: str | None = None,
+        thread: str | None = None,
+    ) -> list[Note]:
+        """Structural query: narrow by scope via the indexes, then filter by
+        kind/author/status. Returned newest-first. (No semantic ranking here —
+        that's a later increment.)"""
+        # 1. candidate ids — intersect any scope facets given, else all notes
+        scope_sets: list[set[str]] = []
+        if strain is not None:
+            scope_sets.append(set(self.ids_for_strain(strain)))
+        if embryo is not None:
+            scope_sets.append(set(self.ids_for_embryo(embryo)))
+        if thread is not None:
+            scope_sets.append(set(self.ids_for_thread(thread)))
+        candidate_ids: set[str] | None = (
+            set.intersection(*scope_sets) if scope_sets else None
+        )
+
+        # 2. load + filter
+        if candidate_ids is not None:
+            notes = [n for n in (self.get_note(i) for i in candidate_ids) if n]
+        else:
+            notes = [
+                note_from_dict(d)
+                for d in (self._read_yaml(f) for f in self.notes_dir.glob("*.yaml"))
+                if d
+            ]
+        results: list[Note] = []
+        for n in notes:
+            if kind is not None and n.kind != kind:
+                continue
+            if author is not None and n.author != author:
+                continue
+            if status is not None and n.status != status:
+                continue
+            results.append(n)
+        results.sort(key=lambda n: n.created_at, reverse=True)
+        return results
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index 75b85381..492aa7fd 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -95,3 +95,41 @@ def test_rebuild_index_from_disk(self, tmp_path):
         # a fresh store over the same dir must rebuild the index by scanning notes/
         store2 = NotebookStore(tmp_path / "notebook")
         assert store2.ids_for_strain("N2") == [a]
+
+
+class TestNotebookQuery:
+    def _seed(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        store.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="o", strains=["N2"]))
+        store.write_note(Note(id="f1", kind=NoteKind.FINDING, body="f",
+                              status=NoteStatus.PROPOSED, strains=["N2"], threads=["t1"]))
+        store.write_note(Note(id="q1", kind=NoteKind.QUESTION, body="q",
+                              status=NoteStatus.OPEN, threads=["t1"]))
+        return store
+
+    def test_query_by_kind(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(kind=NoteKind.FINDING)}
+        assert ids == {"f1"}
+
+    def test_query_by_thread_scope(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(thread="t1")}
+        assert ids == {"f1", "q1"}
+
+    def test_query_by_thread_and_kind(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(thread="t1", kind=NoteKind.QUESTION)}
+        assert ids == {"q1"}
+
+    def test_query_by_status(self, tmp_path):
+        store = self._seed(tmp_path)
+        ids = {n.id for n in store.query_notes(status=NoteStatus.OPEN)}
+        assert ids == {"q1"}
+
+    def test_query_all_sorted_newest_first(self, tmp_path):
+        store = self._seed(tmp_path)
+        notes = store.query_notes()
+        assert len(notes) == 3
+        ts = [n.created_at for n in notes]
+        assert ts == sorted(ts, reverse=True)

From 458810ad36e0d99f6615b1174cd601d8c9497935 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:22:09 +0530
Subject: [PATCH 126/314] feat(notebook): link_notes + supersede_note
 (append-only history)

---
 gently/harness/memory/notebook.py | 22 ++++++++++++++++++++++
 tests/test_notebook_store.py      | 21 +++++++++++++++++++++
 2 files changed, 43 insertions(+)

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
index 0678d9f4..f6e23b4d 100644
--- a/gently/harness/memory/notebook.py
+++ b/gently/harness/memory/notebook.py
@@ -244,3 +244,25 @@ def query_notes(
             results.append(n)
         results.sort(key=lambda n: n.created_at, reverse=True)
         return results
+
+    # ---- links + supersession (append-only history) ----
+    def link_notes(self, from_id: str, rel: str, to_id: str) -> None:
+        """Add a typed edge from one note to another (append-only)."""
+        note = self.get_note(from_id)
+        if note is None:
+            raise KeyError(from_id)
+        edge = {"rel": rel, "to": to_id}
+        if edge not in note.links:
+            note.links.append(edge)
+            self.write_note(note)
+
+    def supersede_note(self, old_id: str, new_id: str) -> None:
+        """Mark old as superseded (kept, never deleted) and link the new note
+        back to it as a refinement — the chain is the intellectual history."""
+        old = self.get_note(old_id)
+        if old is None:
+            raise KeyError(old_id)
+        old.status = NoteStatus.SUPERSEDED
+        old.superseded_by = new_id
+        self.write_note(old)
+        self.link_notes(new_id, "refines", old_id)
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index 492aa7fd..3a7b5294 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -133,3 +133,24 @@ def test_query_all_sorted_newest_first(self, tmp_path):
         assert len(notes) == 3
         ts = [n.created_at for n in notes]
         assert ts == sorted(ts, reverse=True)
+
+
+class TestNotebookLinkSupersede:
+    def test_link_notes_adds_typed_edge(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        a = store.write_note(Note(id="", kind=NoteKind.FINDING, body="a"))
+        b = store.write_note(Note(id="", kind=NoteKind.QUESTION, body="b"))
+        store.link_notes(a, "supports", b)
+        got = store.get_note(a)
+        assert {"rel": "supports", "to": b} in got.links
+
+    def test_supersede_marks_old_and_points_new(self, tmp_path):
+        store = NotebookStore(tmp_path / "notebook")
+        old = store.write_note(Note(id="", kind=NoteKind.FINDING, body="old claim"))
+        new = store.write_note(Note(id="", kind=NoteKind.FINDING, body="better claim"))
+        store.supersede_note(old, new)
+        old_n = store.get_note(old)
+        new_n = store.get_note(new)
+        assert old_n.status == NoteStatus.SUPERSEDED
+        assert old_n.superseded_by == new
+        assert {"rel": "refines", "to": old} in new_n.links

From fed68218b868c8622dd14846295ae525cb212ab9 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:33:35 +0530
Subject: [PATCH 127/314] plan: notebook producer bridge (apply_updates ->
 notebook)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../2026-06-16-notebook-producer-bridge.md    | 251 ++++++++++++++++++
 1 file changed, 251 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-16-notebook-producer-bridge.md

diff --git a/docs/superpowers/plans/2026-06-16-notebook-producer-bridge.md b/docs/superpowers/plans/2026-06-16-notebook-producer-bridge.md
new file mode 100644
index 00000000..d518f621
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-16-notebook-producer-bridge.md
@@ -0,0 +1,251 @@
+# Notebook Producer Bridge Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax.
+
+**Goal:** Make the existing agent-memory write path actually populate the shared notebook — when `FileContextStore.apply_updates()` records observations and learnings, mirror them into the `NotebookStore` as Notes.
+
+**Architecture:** Pure converters (`observation_to_note`, `learning_to_note`) in `notebook.py`; a lazy `FileContextStore.notebook` property rooted at `agent_dir/notebook`; a guarded mirror step at the end of `apply_updates`. Builds on the foundation plan (`2026-06-16-notebook-foundation.md`). Backend-only, no UI/agent-loop changes. Transitional dual-write (legacy YAML + notebook) — legacy silos retire in a later increment.
+
+**Tech Stack:** Python 3.11, dataclasses, PyYAML, pytest (`file_context_store` fixture in `tests/conftest.py`).
+
+**Out of scope:** wiring the live loop to *call* `apply_updates` (separate increment); read API + Notebook tab; mapping expectations/watchpoints (they're working memory, not notebook entries — see design doc §2).
+
+---
+
+### Task 1: Converters — Observation/Learning → Note
+
+**Files:**
+- Modify: `gently/harness/memory/notebook.py`
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+from datetime import datetime as _dt
+
+from gently.harness.memory.model import Learning, Observation
+from gently.harness.memory.notebook import learning_to_note, observation_to_note
+
+
+class TestConverters:
+    def test_observation_to_note(self):
+        obs = Observation(
+            id="o1", timestamp=_dt(2026, 6, 16, 9, 0, 0), type="milestone",
+            content="nerve ring formed", embryo_id="e1", session_id="s1",
+            relates_to=["o0"], gently_refs={"kind": "projection", "t": 42},
+        )
+        n = observation_to_note(obs)
+        assert n.id == "o1"
+        assert n.kind == NoteKind.OBSERVATION
+        assert n.body == "nerve ring formed"
+        assert n.author == Author.AGENT
+        assert n.embryos == ["e1"]
+        assert n.sessions == ["s1"]
+        assert {"rel": "relates_to", "to": "o0"} in n.links
+        assert n.artifacts == [{"kind": "projection", "t": 42}]
+        assert n.created_at == _dt(2026, 6, 16, 9, 0, 0)
+
+    def test_learning_to_note(self):
+        lrn = Learning(id="l1", content="rings form by comma", confidence=Confidence.HIGH)
+        n = learning_to_note(lrn)
+        assert n.id == "l1"
+        assert n.kind == NoteKind.FINDING
+        assert n.body == "rings form by comma"
+        assert n.status == NoteStatus.PROPOSED   # agent-drafted, awaits confirm
+        assert n.confidence == Confidence.HIGH
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestConverters -v`
+Expected: FAIL — `ImportError: cannot import name 'observation_to_note'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+Add the model imports and converters to `notebook.py`. Extend the existing model import line:
+
+```python
+from .model import Confidence, Learning, Observation
+```
+
+Append at end of `notebook.py` (module-level functions, after `note_from_dict`):
+
+```python
+def observation_to_note(obs: Observation) -> Note:
+    """Bridge a legacy Observation into a notebook Note (kind=observation)."""
+    return Note(
+        id=obs.id,
+        kind=NoteKind.OBSERVATION,
+        body=obs.content,
+        author=Author.AGENT,
+        embryos=[obs.embryo_id] if obs.embryo_id else [],
+        sessions=[obs.session_id] if obs.session_id else [],
+        links=[{"rel": "relates_to", "to": r} for r in (obs.relates_to or [])],
+        artifacts=[obs.gently_refs] if obs.gently_refs else [],
+        created_at=obs.timestamp,
+        updated_at=obs.timestamp,
+    )
+
+
+def learning_to_note(learning: Learning) -> Note:
+    """Bridge a legacy Learning into a notebook Note (kind=finding, proposed)."""
+    return Note(
+        id=learning.id,
+        kind=NoteKind.FINDING,
+        body=learning.content,
+        author=Author.AGENT,
+        status=NoteStatus.PROPOSED,
+        confidence=learning.confidence,
+        created_at=learning.created_at,
+        updated_at=learning.created_at,
+    )
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestConverters -v`
+Expected: PASS (2 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook.py tests/test_notebook_store.py
+git commit -m "feat(notebook): Observation/Learning -> Note converters"
+```
+
+---
+
+### Task 2: `FileContextStore.notebook` property
+
+**Files:**
+- Modify: `gently/harness/memory/file_store.py` (add property near `apply_updates`)
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+class TestContextStoreNotebook:
+    def test_notebook_property_rooted_under_agent_dir(self, file_context_store):
+        nb = file_context_store.notebook
+        assert nb.root == file_context_store.agent_dir / "notebook"
+
+    def test_notebook_property_is_cached(self, file_context_store):
+        assert file_context_store.notebook is file_context_store.notebook
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestContextStoreNotebook -v`
+Expected: FAIL — `AttributeError: 'FileContextStore' object has no attribute 'notebook'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `gently/harness/memory/file_store.py`, add this property immediately **before** `def apply_updates(self, updates: ContextUpdates):` (line ~2178):
+
+```python
+    @property
+    def notebook(self):
+        """The shared lab notebook, rooted at agent_dir/notebook (lazy)."""
+        nb = getattr(self, "_notebook", None)
+        if nb is None:
+            from .notebook import NotebookStore
+            nb = NotebookStore(self.agent_dir / "notebook")
+            self._notebook = nb
+        return nb
+
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestContextStoreNotebook -v`
+Expected: PASS (2 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/file_store.py tests/test_notebook_store.py
+git commit -m "feat(notebook): FileContextStore.notebook lazy property"
+```
+
+---
+
+### Task 3: Mirror observations & learnings in `apply_updates`
+
+**Files:**
+- Modify: `gently/harness/memory/file_store.py` (`apply_updates`)
+- Test: `tests/test_notebook_store.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_store.py
+class TestApplyUpdatesMirror:
+    def test_apply_updates_mirrors_observations_and_learnings(self, file_context_store):
+        from gently.harness.memory.model import ContextUpdates
+
+        cs = file_context_store
+        obs = Observation(id="o1", timestamp=_dt(2026, 6, 16, 9, 0, 0),
+                          type="milestone", content="ring formed", embryo_id="e1")
+        lrn = Learning(id="l1", content="rings form by comma", confidence=Confidence.HIGH)
+        cs.apply_updates(ContextUpdates(new_observations=[obs], new_learnings=[lrn]))
+
+        bodies = {n.body for n in cs.notebook.query_notes()}
+        assert "ring formed" in bodies
+        assert "rings form by comma" in bodies
+        assert cs.notebook.ids_for_embryo("e1") == ["o1"]
+
+    def test_apply_updates_empty_is_noop_for_notebook(self, file_context_store):
+        from gently.harness.memory.model import ContextUpdates
+
+        cs = file_context_store
+        cs.apply_updates(ContextUpdates())
+        assert cs.notebook.query_notes() == []
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestApplyUpdatesMirror -v`
+Expected: FAIL — `assert "ring formed" in set()` (notebook not populated yet)
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `gently/harness/memory/file_store.py`, at the END of `apply_updates` (after the `if updates.new_focus is not None:` block), append:
+
+```python
+        # Mirror new observations & learnings into the shared notebook
+        # (best-effort — a notebook failure never breaks the legacy write).
+        from .notebook import learning_to_note, observation_to_note
+
+        try:
+            for obs in updates.new_observations:
+                self.notebook.write_note(observation_to_note(obs))
+            for learning in updates.new_learnings:
+                self.notebook.write_note(learning_to_note(learning))
+        except Exception:
+            logger.warning("notebook mirror failed", exc_info=True)
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_store.py::TestApplyUpdatesMirror -v`
+Expected: PASS (2 passed)
+
+- [ ] **Step 5: Run full notebook suite + commit**
+
+Run: `python -m pytest tests/test_notebook_store.py -q`
+Expected: all pass
+
+```bash
+git add gently/harness/memory/file_store.py tests/test_notebook_store.py
+git commit -m "feat(notebook): apply_updates mirrors observations & learnings into notebook"
+```
+
+---
+
+## Self-Review
+
+**Spec coverage:** Producer wiring (design doc increment 1b) — `apply_updates` now populates the notebook. ✓ Converters honor the model (Observation→observation note, Learning→finding/proposed). ✓ Working-memory types (expectation/watchpoint) intentionally not mirrored (design §2). ✓
+**Placeholder scan:** none; complete code + commands throughout. ✓
+**Type consistency:** `observation_to_note`/`learning_to_note`, `FileContextStore.notebook`, `NoteKind`/`Author`/`NoteStatus`/`Confidence` match the foundation module and `model.py` (`Observation`, `Learning`, `ContextUpdates` confirmed at `file_store.py:2178-2203`). ✓

From 9ca55930ae7e910ac340a8b2efd78de4f79d20e9 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:36:02 +0530
Subject: [PATCH 128/314] feat(notebook): Observation/Learning -> Note
 converters

---
 gently/harness/memory/notebook.py | 32 ++++++++++++++++++++++++++++++-
 tests/test_notebook_store.py      | 32 ++++++++++++++++++++++++++++++-
 2 files changed, 62 insertions(+), 2 deletions(-)

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
index f6e23b4d..7f3176d9 100644
--- a/gently/harness/memory/notebook.py
+++ b/gently/harness/memory/notebook.py
@@ -19,7 +19,7 @@
 
 import yaml
 
-from .model import Confidence
+from .model import Confidence, Learning, Observation
 
 
 class NoteKind(str, Enum):
@@ -108,6 +108,36 @@ def note_from_dict(d: dict[str, Any]) -> Note:
     )
 
 
+def observation_to_note(obs: Observation) -> Note:
+    """Bridge a legacy Observation into a notebook Note (kind=observation)."""
+    return Note(
+        id=obs.id,
+        kind=NoteKind.OBSERVATION,
+        body=obs.content,
+        author=Author.AGENT,
+        embryos=[obs.embryo_id] if obs.embryo_id else [],
+        sessions=[obs.session_id] if obs.session_id else [],
+        links=[{"rel": "relates_to", "to": r} for r in (obs.relates_to or [])],
+        artifacts=[obs.gently_refs] if obs.gently_refs else [],
+        created_at=obs.timestamp,
+        updated_at=obs.timestamp,
+    )
+
+
+def learning_to_note(learning: Learning) -> Note:
+    """Bridge a legacy Learning into a notebook Note (kind=finding, proposed)."""
+    return Note(
+        id=learning.id,
+        kind=NoteKind.FINDING,
+        body=learning.content,
+        author=Author.AGENT,
+        status=NoteStatus.PROPOSED,
+        confidence=learning.confidence,
+        created_at=learning.created_at,
+        updated_at=learning.created_at,
+    )
+
+
 class NotebookStore:
     """File-backed store for notebook Notes. One YAML per note under notes/;
     flat pool, rebuildable reverse-indexes (added in Task 3)."""
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index 3a7b5294..07867b5f 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -2,15 +2,17 @@
 
 from datetime import datetime
 
-from gently.harness.memory.model import Confidence
+from gently.harness.memory.model import Confidence, Learning, Observation
 from gently.harness.memory.notebook import (
     Author,
     Note,
     NoteKind,
     NoteStatus,
     NotebookStore,
+    learning_to_note,
     note_from_dict,
     note_to_dict,
+    observation_to_note,
 )
 
 
@@ -154,3 +156,31 @@ def test_supersede_marks_old_and_points_new(self, tmp_path):
         assert old_n.status == NoteStatus.SUPERSEDED
         assert old_n.superseded_by == new
         assert {"rel": "refines", "to": old} in new_n.links
+
+
+class TestConverters:
+    def test_observation_to_note(self):
+        obs = Observation(
+            id="o1", timestamp=datetime(2026, 6, 16, 9, 0, 0), type="milestone",
+            content="nerve ring formed", embryo_id="e1", session_id="s1",
+            relates_to=["o0"], gently_refs={"kind": "projection", "t": 42},
+        )
+        n = observation_to_note(obs)
+        assert n.id == "o1"
+        assert n.kind == NoteKind.OBSERVATION
+        assert n.body == "nerve ring formed"
+        assert n.author == Author.AGENT
+        assert n.embryos == ["e1"]
+        assert n.sessions == ["s1"]
+        assert {"rel": "relates_to", "to": "o0"} in n.links
+        assert n.artifacts == [{"kind": "projection", "t": 42}]
+        assert n.created_at == datetime(2026, 6, 16, 9, 0, 0)
+
+    def test_learning_to_note(self):
+        lrn = Learning(id="l1", content="rings form by comma", confidence=Confidence.HIGH)
+        n = learning_to_note(lrn)
+        assert n.id == "l1"
+        assert n.kind == NoteKind.FINDING
+        assert n.body == "rings form by comma"
+        assert n.status == NoteStatus.PROPOSED   # agent-drafted, awaits confirm
+        assert n.confidence == Confidence.HIGH

From 19c2ff4d1dcfc6207a0229d10fdb3a36b04aff5b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:37:43 +0530
Subject: [PATCH 129/314] feat(notebook): FileContextStore.notebook lazy
 property

---
 gently/harness/memory/file_store.py | 11 +++++++++++
 tests/test_notebook_store.py        |  9 +++++++++
 2 files changed, 20 insertions(+)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index c19f785b..71752461 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -2175,6 +2175,17 @@ def set_state(self, key: str, value: str):
     # Batch Updates
     # ==================================================================
 
+    @property
+    def notebook(self):
+        """The shared lab notebook, rooted at agent_dir/notebook (lazy)."""
+        nb = getattr(self, "_notebook", None)
+        if nb is None:
+            from .notebook import NotebookStore
+
+            nb = NotebookStore(self.agent_dir / "notebook")
+            self._notebook = nb
+        return nb
+
     def apply_updates(self, updates: ContextUpdates):
         for obs in updates.new_observations:
             self.add_observation(obs)
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index 07867b5f..f0f48219 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -184,3 +184,12 @@ def test_learning_to_note(self):
         assert n.body == "rings form by comma"
         assert n.status == NoteStatus.PROPOSED   # agent-drafted, awaits confirm
         assert n.confidence == Confidence.HIGH
+
+
+class TestContextStoreNotebook:
+    def test_notebook_property_rooted_under_agent_dir(self, file_context_store):
+        nb = file_context_store.notebook
+        assert nb.root == file_context_store.agent_dir / "notebook"
+
+    def test_notebook_property_is_cached(self, file_context_store):
+        assert file_context_store.notebook is file_context_store.notebook

From 9224b0fbffd01f5574e46499fa0d737d529cad2f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:39:25 +0530
Subject: [PATCH 130/314] feat(notebook): apply_updates mirrors observations &
 learnings into notebook

---
 gently/harness/memory/file_store.py | 12 ++++++++++++
 tests/test_notebook_store.py        | 23 +++++++++++++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 71752461..7c153073 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -2213,6 +2213,18 @@ def apply_updates(self, updates: ContextUpdates):
         if updates.new_focus is not None:
             self.set_state("current_focus", updates.new_focus)
 
+        # Mirror new observations & learnings into the shared notebook
+        # (best-effort — a notebook failure never breaks the legacy write).
+        from .notebook import learning_to_note, observation_to_note
+
+        try:
+            for obs in updates.new_observations:
+                self.notebook.write_note(observation_to_note(obs))
+            for learning in updates.new_learnings:
+                self.notebook.write_note(learning_to_note(learning))
+        except Exception:
+            logger.warning("notebook mirror failed", exc_info=True)
+
     # ==================================================================
     # ML Pipelines
     # ==================================================================
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index f0f48219..4fdd48f7 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -193,3 +193,26 @@ def test_notebook_property_rooted_under_agent_dir(self, file_context_store):
 
     def test_notebook_property_is_cached(self, file_context_store):
         assert file_context_store.notebook is file_context_store.notebook
+
+
+class TestApplyUpdatesMirror:
+    def test_apply_updates_mirrors_observations_and_learnings(self, file_context_store):
+        from gently.harness.memory.model import ContextUpdates
+
+        cs = file_context_store
+        obs = Observation(id="o1", timestamp=datetime(2026, 6, 16, 9, 0, 0),
+                          type="milestone", content="ring formed", embryo_id="e1")
+        lrn = Learning(id="l1", content="rings form by comma", confidence=Confidence.HIGH)
+        cs.apply_updates(ContextUpdates(new_observations=[obs], new_learnings=[lrn]))
+
+        bodies = {n.body for n in cs.notebook.query_notes()}
+        assert "ring formed" in bodies
+        assert "rings form by comma" in bodies
+        assert cs.notebook.ids_for_embryo("e1") == ["o1"]
+
+    def test_apply_updates_empty_is_noop_for_notebook(self, file_context_store):
+        from gently.harness.memory.model import ContextUpdates
+
+        cs = file_context_store
+        cs.apply_updates(ContextUpdates())
+        assert cs.notebook.query_notes() == []

From 03ea7c621128679e1a966f2867646f9c5a11a35f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:44:54 +0530
Subject: [PATCH 131/314] plan: notebook read API

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../plans/2026-06-16-notebook-read-api.md     | 265 ++++++++++++++++++
 1 file changed, 265 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-16-notebook-read-api.md

diff --git a/docs/superpowers/plans/2026-06-16-notebook-read-api.md b/docs/superpowers/plans/2026-06-16-notebook-read-api.md
new file mode 100644
index 00000000..f4a5f20d
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-16-notebook-read-api.md
@@ -0,0 +1,265 @@
+# Notebook Read API Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans (or subagent-driven-development) to implement task-by-task. Steps use checkbox (`- [ ]`) syntax.
+
+**Goal:** Expose the shared notebook over HTTP so the frontend can read it — list/filter notes, fetch one note, and list inquiry-threads with counts.
+
+**Architecture:** A new route module `gently/ui/web/routes/notebook.py` exposing `create_router(server)` (the established pattern), reading `server.context_store.notebook` (the `NotebookStore` added in the producer-bridge plan) and serializing via `note_to_dict`. Registered in `routes/__init__.py`. Read-only; authoring/curation is a later increment.
+
+**Tech Stack:** FastAPI `APIRouter`, pytest + `fastapi.testclient.TestClient`, the `file_context_store` fixture (`tests/conftest.py`).
+
+**Out of scope:** the Notebook tab UI (next plan, browser-verified); the Agent's-View rewire; retrieval/embeddings.
+
+---
+
+### Task 1: Route module — list & get notes
+
+**Files:**
+- Create: `gently/ui/web/routes/notebook.py`
+- Modify: `gently/ui/web/routes/__init__.py`
+- Test: `tests/test_notebook_api.py`
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_notebook_api.py
+"""Tests for the notebook read API."""
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.harness.memory.notebook import Note, NoteKind, NoteStatus
+
+
+def _make_app(context_store):
+    from gently.ui.web.routes.notebook import create_router
+
+    app = FastAPI()
+
+    class _Server:
+        pass
+
+    server = _Server()
+    server.context_store = context_store
+    app.include_router(create_router(server))
+    return app
+
+
+def _seed(cs):
+    nb = cs.notebook
+    nb.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"]))
+    nb.write_note(Note(id="f1", kind=NoteKind.FINDING, body="rings by comma",
+                       status=NoteStatus.PROPOSED, strains=["N2"], threads=["t1"]))
+    return cs
+
+
+class TestListNotes:
+    def test_no_store_available_false(self):
+        client = TestClient(_make_app(None))
+        data = client.get("/api/notebook/notes").json()
+        assert data == {"available": False, "notes": []}
+
+    def test_list_all(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes").json()
+        assert data["available"] is True
+        assert {n["id"] for n in data["notes"]} == {"o1", "f1"}
+
+    def test_filter_by_kind(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?kind=finding").json()
+        assert {n["id"] for n in data["notes"]} == {"f1"}
+
+    def test_filter_by_strain(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?strain=N2").json()
+        assert {n["id"] for n in data["notes"]} == {"o1", "f1"}
+
+    def test_invalid_kind_is_ignored(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?kind=bogus").json()
+        assert {n["id"] for n in data["notes"]} == {"o1", "f1"}
+
+
+class TestGetNote:
+    def test_get_existing(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes/o1").json()
+        assert data["id"] == "o1"
+        assert data["body"] == "ring formed"
+
+    def test_get_missing_404(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        resp = client.get("/api/notebook/notes/nope")
+        assert resp.status_code == 404
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_api.py -v`
+Expected: FAIL — `ModuleNotFoundError: No module named 'gently.ui.web.routes.notebook'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+Create `gently/ui/web/routes/notebook.py`:
+
+```python
+"""Notebook (shared lab notebook) read routes.
+
+Exposes the notebook's Notes for the Notebook tab + Agent's-View live edge.
+Read-only here; authoring/curation come in a later increment.
+"""
+
+from fastapi import APIRouter, HTTPException
+
+from gently.harness.memory.notebook import Author, NoteKind, NoteStatus, note_to_dict
+
+
+def _coerce(enum_cls, value):
+    """Parse a query-param string into an enum; invalid/None → None (no filter)."""
+    if value is None:
+        return None
+    try:
+        return enum_cls(value)
+    except ValueError:
+        return None
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _nb():
+        cs = getattr(server, "context_store", None)
+        return cs.notebook if cs is not None else None
+
+    @router.get("/api/notebook/notes")
+    async def list_notes(
+        kind: str | None = None,
+        author: str | None = None,
+        status: str | None = None,
+        strain: str | None = None,
+        embryo: str | None = None,
+        thread: str | None = None,
+    ):
+        nb = _nb()
+        if nb is None:
+            return {"available": False, "notes": []}
+        notes = nb.query_notes(
+            kind=_coerce(NoteKind, kind),
+            author=_coerce(Author, author),
+            status=_coerce(NoteStatus, status),
+            strain=strain,
+            embryo=embryo,
+            thread=thread,
+        )
+        return {"available": True, "notes": [note_to_dict(n) for n in notes]}
+
+    @router.get("/api/notebook/notes/{note_id}")
+    async def get_note(note_id: str):
+        nb = _nb()
+        if nb is None:
+            raise HTTPException(status_code=404, detail="notebook unavailable")
+        note = nb.get_note(note_id)
+        if note is None:
+            raise HTTPException(status_code=404, detail="note not found")
+        return note_to_dict(note)
+
+    return router
+```
+
+Then register it in `gently/ui/web/routes/__init__.py`. Add the import after the `images` import line:
+
+```python
+from .notebook import create_router as create_notebook_router
+```
+
+And add `create_notebook_router,` to the factory tuple in `register_all_routes` (after `create_context_router,`):
+
+```python
+        create_context_router,
+        create_notebook_router,
+    ):
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_api.py -v`
+Expected: PASS (7 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/routes/notebook.py gently/ui/web/routes/__init__.py tests/test_notebook_api.py
+git commit -m "feat(notebook): read API — GET /api/notebook/notes + /notes/{id}"
+```
+
+---
+
+### Task 2: `GET /api/notebook/threads`
+
+**Files:**
+- Modify: `gently/ui/web/routes/notebook.py`
+- Test: `tests/test_notebook_api.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_api.py
+class TestThreads:
+    def test_no_store(self):
+        client = TestClient(_make_app(None))
+        assert client.get("/api/notebook/threads").json() == {"available": False, "threads": []}
+
+    def test_thread_counts(self, file_context_store):
+        cs = file_context_store
+        nb = cs.notebook
+        nb.write_note(Note(id="a", kind=NoteKind.QUESTION, body="q", threads=["t1"]))
+        nb.write_note(Note(id="b", kind=NoteKind.FINDING, body="f", threads=["t1", "t2"]))
+        client = TestClient(_make_app(cs))
+        data = client.get("/api/notebook/threads").json()
+        assert data["available"] is True
+        assert data["threads"] == [{"id": "t1", "count": 2}, {"id": "t2", "count": 1}]
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `python -m pytest tests/test_notebook_api.py::TestThreads -v`
+Expected: FAIL — 404 (route not defined)
+
+- [ ] **Step 3: Write minimal implementation**
+
+Add this endpoint inside `create_router`, just before `return router`:
+
+```python
+    @router.get("/api/notebook/threads")
+    async def list_threads():
+        nb = _nb()
+        if nb is None:
+            return {"available": False, "threads": []}
+        counts: dict[str, int] = {}
+        for n in nb.query_notes():
+            for t in n.threads:
+                counts[t] = counts.get(t, 0) + 1
+        threads = [{"id": t, "count": c} for t, c in sorted(counts.items())]
+        return {"available": True, "threads": threads}
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `python -m pytest tests/test_notebook_api.py -q`
+Expected: all pass
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/routes/notebook.py tests/test_notebook_api.py
+git commit -m "feat(notebook): read API — GET /api/notebook/threads with counts"
+```
+
+---
+
+## Self-Review
+
+**Spec coverage:** read surface API for the notebook (design increment 1c, backend half) — query notes by kind/author/status/scope, fetch one, list threads. ✓ Reuses `NotebookStore.query_notes` + `note_to_dict` from the foundation. ✓ Follows `create_router(server)` + `server.context_store` convention (`context.py`). ✓
+**Placeholder scan:** none — complete code + commands. ✓
+**Type consistency:** `create_router`, `note_to_dict`, `NoteKind`/`Author`/`NoteStatus`, `server.context_store.notebook`, `nb.query_notes`/`get_note` all match the foundation + producer-bridge modules. Registration matches the existing tuple in `routes/__init__.py`. ✓

From 7d51e20a8fb93f04677b61849e1b4ae9aab34635 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:47:34 +0530
Subject: [PATCH 132/314] =?UTF-8?q?feat(notebook):=20read=20API=20?=
 =?UTF-8?q?=E2=80=94=20GET=20/api/notebook/notes=20+=20/notes/{id}?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/ui/web/routes/__init__.py |  2 +
 gently/ui/web/routes/notebook.py | 61 ++++++++++++++++++++++++++++
 tests/test_notebook_api.py       | 69 ++++++++++++++++++++++++++++++++
 3 files changed, 132 insertions(+)
 create mode 100644 gently/ui/web/routes/notebook.py
 create mode 100644 tests/test_notebook_api.py

diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index bdbf3db7..9f8cd903 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -14,6 +14,7 @@
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
 from .images import create_router as create_images_router
+from .notebook import create_router as create_notebook_router
 from .pages import create_router as create_pages_router
 from .sessions import create_router as create_sessions_router
 from .volumes import create_router as create_volumes_router
@@ -35,6 +36,7 @@ def register_all_routes(server):
         create_agent_ws_router,
         create_chat_router,
         create_context_router,
+        create_notebook_router,
     ):
         router = factory(server)
         server.app.include_router(router)
diff --git a/gently/ui/web/routes/notebook.py b/gently/ui/web/routes/notebook.py
new file mode 100644
index 00000000..a285a3d4
--- /dev/null
+++ b/gently/ui/web/routes/notebook.py
@@ -0,0 +1,61 @@
+"""Notebook (shared lab notebook) read routes.
+
+Exposes the notebook's Notes for the Notebook tab + Agent's-View live edge.
+Read-only here; authoring/curation come in a later increment.
+"""
+
+from fastapi import APIRouter, HTTPException
+
+from gently.harness.memory.notebook import Author, NoteKind, NoteStatus, note_to_dict
+
+
+def _coerce(enum_cls, value):
+    """Parse a query-param string into an enum; invalid/None → None (no filter)."""
+    if value is None:
+        return None
+    try:
+        return enum_cls(value)
+    except ValueError:
+        return None
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _nb():
+        cs = getattr(server, "context_store", None)
+        return cs.notebook if cs is not None else None
+
+    @router.get("/api/notebook/notes")
+    async def list_notes(
+        kind: str | None = None,
+        author: str | None = None,
+        status: str | None = None,
+        strain: str | None = None,
+        embryo: str | None = None,
+        thread: str | None = None,
+    ):
+        nb = _nb()
+        if nb is None:
+            return {"available": False, "notes": []}
+        notes = nb.query_notes(
+            kind=_coerce(NoteKind, kind),
+            author=_coerce(Author, author),
+            status=_coerce(NoteStatus, status),
+            strain=strain,
+            embryo=embryo,
+            thread=thread,
+        )
+        return {"available": True, "notes": [note_to_dict(n) for n in notes]}
+
+    @router.get("/api/notebook/notes/{note_id}")
+    async def get_note(note_id: str):
+        nb = _nb()
+        if nb is None:
+            raise HTTPException(status_code=404, detail="notebook unavailable")
+        note = nb.get_note(note_id)
+        if note is None:
+            raise HTTPException(status_code=404, detail="note not found")
+        return note_to_dict(note)
+
+    return router
diff --git a/tests/test_notebook_api.py b/tests/test_notebook_api.py
new file mode 100644
index 00000000..a6e088f1
--- /dev/null
+++ b/tests/test_notebook_api.py
@@ -0,0 +1,69 @@
+"""Tests for the notebook read API."""
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.harness.memory.notebook import Note, NoteKind, NoteStatus
+
+
+def _make_app(context_store):
+    from gently.ui.web.routes.notebook import create_router
+
+    app = FastAPI()
+
+    class _Server:
+        pass
+
+    server = _Server()
+    server.context_store = context_store
+    app.include_router(create_router(server))
+    return app
+
+
+def _seed(cs):
+    nb = cs.notebook
+    nb.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"]))
+    nb.write_note(Note(id="f1", kind=NoteKind.FINDING, body="rings by comma",
+                       status=NoteStatus.PROPOSED, strains=["N2"], threads=["t1"]))
+    return cs
+
+
+class TestListNotes:
+    def test_no_store_available_false(self):
+        client = TestClient(_make_app(None))
+        data = client.get("/api/notebook/notes").json()
+        assert data == {"available": False, "notes": []}
+
+    def test_list_all(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes").json()
+        assert data["available"] is True
+        assert {n["id"] for n in data["notes"]} == {"o1", "f1"}
+
+    def test_filter_by_kind(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?kind=finding").json()
+        assert {n["id"] for n in data["notes"]} == {"f1"}
+
+    def test_filter_by_strain(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?strain=N2").json()
+        assert {n["id"] for n in data["notes"]} == {"o1", "f1"}
+
+    def test_invalid_kind_is_ignored(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?kind=bogus").json()
+        assert {n["id"] for n in data["notes"]} == {"o1", "f1"}
+
+
+class TestGetNote:
+    def test_get_existing(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes/o1").json()
+        assert data["id"] == "o1"
+        assert data["body"] == "ring formed"
+
+    def test_get_missing_404(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        resp = client.get("/api/notebook/notes/nope")
+        assert resp.status_code == 404

From 1a0121df46e2e420ac74e4e147caed42cff84c59 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 16:48:56 +0530
Subject: [PATCH 133/314] =?UTF-8?q?feat(notebook):=20read=20API=20?=
 =?UTF-8?q?=E2=80=94=20GET=20/api/notebook/threads=20with=20counts?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/ui/web/routes/notebook.py | 12 ++++++++++++
 tests/test_notebook_api.py       | 16 ++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/gently/ui/web/routes/notebook.py b/gently/ui/web/routes/notebook.py
index a285a3d4..a0176630 100644
--- a/gently/ui/web/routes/notebook.py
+++ b/gently/ui/web/routes/notebook.py
@@ -58,4 +58,16 @@ async def get_note(note_id: str):
             raise HTTPException(status_code=404, detail="note not found")
         return note_to_dict(note)
 
+    @router.get("/api/notebook/threads")
+    async def list_threads():
+        nb = _nb()
+        if nb is None:
+            return {"available": False, "threads": []}
+        counts: dict[str, int] = {}
+        for n in nb.query_notes():
+            for t in n.threads:
+                counts[t] = counts.get(t, 0) + 1
+        threads = [{"id": t, "count": c} for t, c in sorted(counts.items())]
+        return {"available": True, "threads": threads}
+
     return router
diff --git a/tests/test_notebook_api.py b/tests/test_notebook_api.py
index a6e088f1..7510d5b7 100644
--- a/tests/test_notebook_api.py
+++ b/tests/test_notebook_api.py
@@ -67,3 +67,19 @@ def test_get_missing_404(self, file_context_store):
         client = TestClient(_make_app(_seed(file_context_store)))
         resp = client.get("/api/notebook/notes/nope")
         assert resp.status_code == 404
+
+
+class TestThreads:
+    def test_no_store(self):
+        client = TestClient(_make_app(None))
+        assert client.get("/api/notebook/threads").json() == {"available": False, "threads": []}
+
+    def test_thread_counts(self, file_context_store):
+        cs = file_context_store
+        nb = cs.notebook
+        nb.write_note(Note(id="a", kind=NoteKind.QUESTION, body="q", threads=["t1"]))
+        nb.write_note(Note(id="b", kind=NoteKind.FINDING, body="f", threads=["t1", "t2"]))
+        client = TestClient(_make_app(cs))
+        data = client.get("/api/notebook/threads").json()
+        assert data["available"] is True
+        assert data["threads"] == [{"id": "t1", "count": 2}, {"id": "t2", "count": 1}]

From 0760578df5ae820b8b9c39ce2089120d352e497d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 17:58:13 +0530
Subject: [PATCH 134/314] feat(notebook): Notebook tab (read view) in LIBRARY
 rail

Thread rail + kind filter + note cards (color-coded by kind, with author,
status, and scope chips), consuming /api/notebook. Wired into the v2 rail
and the legacy tab bar, lazy-init via switchTab, live-refresh on
CONTEXT_UPDATED.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/notebook.css |  62 +++++++++++
 gently/ui/web/static/js/app.js        |   7 +-
 gently/ui/web/static/js/notebook.js   | 142 ++++++++++++++++++++++++++
 gently/ui/web/static/js/utils.js      |   2 +-
 gently/ui/web/templates/_navbar.html  |   2 +
 gently/ui/web/templates/index.html    |  22 ++++
 6 files changed, 235 insertions(+), 2 deletions(-)
 create mode 100644 gently/ui/web/static/css/notebook.css
 create mode 100644 gently/ui/web/static/js/notebook.js

diff --git a/gently/ui/web/static/css/notebook.css b/gently/ui/web/static/css/notebook.css
new file mode 100644
index 00000000..14810510
--- /dev/null
+++ b/gently/ui/web/static/css/notebook.css
@@ -0,0 +1,62 @@
+/* ── Notebook tab (LIBRARY) ──────────────────────────────────────────────
+   The reading room for the shared lab notebook: thread rail + kind filter +
+   note cards. Tokens reuse the app theme (--accent, --accent-green, --border …). */
+
+.nb-container { max-width: 1100px; margin: 0 auto; padding: 24px 28px; }
+
+.nb-header {
+    display: flex; align-items: center; justify-content: space-between;
+    gap: 16px; margin-bottom: 18px; flex-wrap: wrap;
+}
+.nb-title { font-size: 22px; font-weight: 600; letter-spacing: -.01em; color: var(--text, #0f172a); margin: 0; }
+
+.nb-kinds { display: flex; gap: 6px; }
+.nb-kind {
+    background: none; border: 1px solid var(--border, #e4e9f0); color: var(--text-secondary, #475569);
+    border-radius: 999px; padding: 6px 13px; font: inherit; font-size: 13px; cursor: pointer;
+    transition: border-color .15s, color .15s, background .15s;
+}
+.nb-kind:hover { color: var(--text, #0f172a); border-color: var(--border-strong, #cbd5e1); }
+.nb-kind.active { background: var(--accent, #2f6df6); border-color: var(--accent, #2f6df6); color: #fff; }
+
+.nb-body-wrap { display: grid; grid-template-columns: 220px 1fr; gap: 22px; align-items: start; }
+@media (max-width: 760px) { .nb-body-wrap { grid-template-columns: 1fr; } }
+
+/* thread rail (the inquiry spine) */
+.nb-threads { display: flex; flex-direction: column; gap: 4px; position: sticky; top: 12px; }
+.nb-thread {
+    text-align: left; background: none; border: 0; cursor: pointer; font: inherit; font-size: 13px;
+    color: var(--text-secondary, #475569); padding: 8px 11px; border-radius: 9px;
+    transition: background .15s, color .15s; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+.nb-thread:hover { background: var(--bg-hover, #f1f5f9); color: var(--text, #0f172a); }
+.nb-thread.active { background: var(--accent-soft, #eaf1ff); color: var(--accent, #2f6df6); font-weight: 600; }
+
+/* notes */
+.nb-notes { display: flex; flex-direction: column; gap: 12px; }
+.nb-empty { color: var(--text-muted, #94a3b8); font-size: 14px; font-style: italic; padding: 28px 4px; }
+
+.nb-card {
+    border: 1px solid var(--border, #e4e9f0); border-radius: 13px; padding: 14px 16px;
+    background: var(--bg-card, #fff); box-shadow: 0 1px 2px rgba(15, 23, 42, .04);
+}
+.nb-card-head { display: flex; align-items: center; gap: 10px; margin-bottom: 8px; }
+.nb-badge {
+    font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase;
+    padding: 2px 9px; border-radius: 999px; color: #fff; background: var(--text-muted, #94a3b8);
+}
+.nb-badge.nb-k-obs { background: var(--accent, #2f6df6); }
+.nb-badge.nb-k-find { background: var(--accent-green, #16a34a); }
+.nb-badge.nb-k-q { background: #d97706; }
+.nb-author { font-size: 12px; color: var(--text-secondary, #475569); }
+.nb-status {
+    margin-left: auto; font-size: 11px; color: var(--text-muted, #94a3b8);
+    text-transform: uppercase; letter-spacing: .05em;
+}
+.nb-body-text { font-size: 14px; line-height: 1.5; color: var(--text, #0f172a); white-space: pre-wrap; }
+
+.nb-chips { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 10px; }
+.nb-chip {
+    font-size: 11.5px; color: var(--text-secondary, #475569);
+    background: var(--bg-hover, #f1f5f9); border-radius: 7px; padding: 2px 8px;
+}
diff --git a/gently/ui/web/static/js/app.js b/gently/ui/web/static/js/app.js
index a8c6450c..41bad885 100644
--- a/gently/ui/web/static/js/app.js
+++ b/gently/ui/web/static/js/app.js
@@ -100,6 +100,11 @@ function switchTab(tabName) {
         ExperimentOverview.init();
     }
 
+    // Lazy-init Notebook tab
+    if (tabName === TABS.NOTEBOOK && typeof NotebookApp !== 'undefined') {
+        NotebookApp.init();
+    }
+
     // Update statusbar for context
     updateStatusbar();
 }
@@ -651,7 +656,7 @@ document.addEventListener('DOMContentLoaded', () => {
     const hash = window.location.hash.slice(1); // remove #
     if (hash) {
         const [tab, param] = hash.split(':');
-        if (tab === TABS.HOME || tab === TABS.PLANS || tab === TABS.SESSIONS || tab === TABS.EMBRYOS || tab === TABS.CALIBRATION || tab === TABS.EVENTS || tab === TABS.EXPERIMENT) {
+        if (tab === TABS.HOME || tab === TABS.PLANS || tab === TABS.SESSIONS || tab === TABS.EMBRYOS || tab === TABS.CALIBRATION || tab === TABS.EVENTS || tab === TABS.EXPERIMENT || tab === TABS.NOTEBOOK) {
             switchTab(tab);
             if (tab === TABS.PLANS && param && typeof openCampaign === 'function') {
                 setTimeout(() => openCampaign(param), 200);
diff --git a/gently/ui/web/static/js/notebook.js b/gently/ui/web/static/js/notebook.js
new file mode 100644
index 00000000..2fe94c6c
--- /dev/null
+++ b/gently/ui/web/static/js/notebook.js
@@ -0,0 +1,142 @@
+/**
+ * NotebookApp — the LIBRARY "Notebook" tab.
+ *
+ * The reading room for the shared lab notebook: a thread rail (the inquiry
+ * spine) + kind filter, rendering Notes from the read API (/api/notebook).
+ * Read-only for now; authoring/curation arrive in a later increment.
+ */
+const NotebookApp = (() => {
+    let inited = false;
+    let kindFilter = '';      // '' | observation | finding | question
+    let threadFilter = '';    // '' = all notes
+
+    const $ = (id) => document.getElementById(id);
+
+    async function fetchJSON(url) {
+        try {
+            const r = await fetch(url);
+            if (!r.ok) return null;
+            return await r.json();
+        } catch (e) {
+            return null;
+        }
+    }
+
+    function kindMeta(kind) {
+        return ({
+            observation: { label: 'Observation', cls: 'nb-k-obs' },
+            finding: { label: 'Finding', cls: 'nb-k-find' },
+            question: { label: 'Question', cls: 'nb-k-q' },
+        })[kind] || { label: kind || 'note', cls: '' };
+    }
+
+    async function loadThreads() {
+        const rail = $('nb-threads');
+        if (!rail) return;
+        const data = await fetchJSON('/api/notebook/threads');
+        const threads = (data && data.threads) || [];
+        rail.innerHTML = '';
+        const mk = (id, label, count, active) => {
+            const b = document.createElement('button');
+            b.className = 'nb-thread' + (active ? ' active' : '');
+            b.textContent = label + (count != null ? `  ${count}` : '');
+            b.addEventListener('click', () => { threadFilter = id; loadThreads(); loadNotes(); });
+            return b;
+        };
+        rail.appendChild(mk('', 'All notes', null, threadFilter === ''));
+        threads.forEach(t => rail.appendChild(mk(t.id, t.id, t.count, threadFilter === t.id)));
+    }
+
+    function card(n) {
+        const km = kindMeta(n.kind);
+        const el = document.createElement('div');
+        el.className = 'nb-card';
+
+        const head = document.createElement('div');
+        head.className = 'nb-card-head';
+        const badge = document.createElement('span');
+        badge.className = 'nb-badge ' + km.cls;
+        badge.textContent = km.label;
+        const author = document.createElement('span');
+        author.className = 'nb-author';
+        author.textContent = n.author || '';
+        const status = document.createElement('span');
+        status.className = 'nb-status';
+        status.textContent = n.status || '';
+        head.append(badge, author, status);
+
+        const body = document.createElement('div');
+        body.className = 'nb-body-text';
+        body.textContent = n.title || n.body || '';
+
+        el.append(head, body);
+
+        const chips = []
+            .concat((n.strains || []).map(s => '🧬 ' + s))
+            .concat((n.embryos || []).map(e => '◌ ' + e))
+            .concat((n.threads || []).map(t => '# ' + t));
+        if (chips.length) {
+            const row = document.createElement('div');
+            row.className = 'nb-chips';
+            chips.forEach(text => {
+                const c = document.createElement('span');
+                c.className = 'nb-chip';
+                c.textContent = text;
+                row.appendChild(c);
+            });
+            el.appendChild(row);
+        }
+        return el;
+    }
+
+    async function loadNotes() {
+        const list = $('nb-notes');
+        if (!list) return;
+        const params = new URLSearchParams();
+        if (kindFilter) params.set('kind', kindFilter);
+        if (threadFilter) params.set('thread', threadFilter);
+        const qs = params.toString();
+        const data = await fetchJSON('/api/notebook/notes' + (qs ? `?${qs}` : ''));
+        if (!data || data.available === false) {
+            list.innerHTML = '<div class="nb-empty">Notebook unavailable.</div>';
+            return;
+        }
+        const notes = data.notes || [];
+        if (!notes.length) {
+            list.innerHTML =
+                '<div class="nb-empty">No notes yet — the notebook fills as the agent ' +
+                'records observations, findings, and open questions.</div>';
+            return;
+        }
+        list.innerHTML = '';
+        notes.forEach(n => list.appendChild(card(n)));
+    }
+
+    function setupFilters() {
+        document.querySelectorAll('#notebook-content [data-nb-kind]').forEach(btn => {
+            btn.addEventListener('click', () => {
+                kindFilter = btn.dataset.nbKind;
+                document.querySelectorAll('#notebook-content [data-nb-kind]')
+                    .forEach(b => b.classList.toggle('active', b === btn));
+                loadNotes();
+            });
+        });
+    }
+
+    function refresh() { loadThreads(); loadNotes(); }
+
+    function init() {
+        if (inited) { refresh(); return; }
+        inited = true;
+        setupFilters();
+        refresh();
+        // Notebook writes ride the CONTEXT_UPDATED event — live-refresh if visible.
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('CONTEXT_UPDATED', () => {
+                if (typeof state !== 'undefined' && state.tab === 'notebook') refresh();
+            });
+        }
+    }
+
+    return { init };
+})();
diff --git a/gently/ui/web/static/js/utils.js b/gently/ui/web/static/js/utils.js
index 8b4a3d79..b321506c 100644
--- a/gently/ui/web/static/js/utils.js
+++ b/gently/ui/web/static/js/utils.js
@@ -3,7 +3,7 @@
 // ══════════════════════════════════════════════════════════
 
 // Tab and view name constants
-const TABS = { HOME: 'home', EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment' };
+const TABS = { HOME: 'home', EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment', NOTEBOOK: 'notebook' };
 
 /**
  * Extract the XY firmware fence (the addressable stage box) from a device-state
diff --git a/gently/ui/web/templates/_navbar.html b/gently/ui/web/templates/_navbar.html
index 33d5f675..ed02ba49 100644
--- a/gently/ui/web/templates/_navbar.html
+++ b/gently/ui/web/templates/_navbar.html
@@ -23,6 +23,7 @@
     <div class="tab-divider"></div>
     <div class="tab" data-tab="plans">Plans</div>
     <div class="tab" data-tab="sessions">Sessions</div>
+    <div class="tab" data-tab="notebook">Notebook</div>
     {% else %}
     {# Standalone pages — all tabs link back to the SPA #}
     <a href="/" class="tab tab-link">Home</a>
@@ -34,5 +35,6 @@
     <div class="tab-divider"></div>
     <a href="/" class="tab tab-link">Plans</a>
     <a href="/" class="tab tab-link">Sessions</a>
+    <a href="/" class="tab tab-link">Notebook</a>
     {% endif %}
 </div>
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index cd0b1fba..242e5441 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -18,6 +18,7 @@
     <link rel="stylesheet" href="/static/css/ask-stage.css">
     <link rel="stylesheet" href="/static/css/shell.css">
     <link rel="stylesheet" href="/static/css/landing.css">
+    <link rel="stylesheet" href="/static/css/notebook.css">
 </head>
 <body class="{% if ux_v2 %}ux-v2{% endif %}">
     {% if ux_v2 %}
@@ -122,6 +123,7 @@ <h3>Take a quick look</h3>
           <div class="v2-nav-label">Library</div>
           <button class="v2-nav-item" data-tab="plans">Plans</button>
           <button class="v2-nav-item" data-tab="sessions">Sessions</button>
+          <button class="v2-nav-item" data-tab="notebook">Notebook</button>
         </div>
         <div class="v2-nav-group">
           <div class="v2-nav-label">System</div>
@@ -409,6 +411,25 @@ <h2 class="experiment-title">Experiment</h2>
         {% include '_sessions_panel.html' %}
     </div>
 
+    <!-- Notebook Tab -->
+    <div id="notebook-content" class="tab-content">
+        <div class="nb-container">
+            <div class="nb-header">
+                <h2 class="nb-title">Notebook</h2>
+                <div class="nb-kinds">
+                    <button class="nb-kind active" data-nb-kind="">All</button>
+                    <button class="nb-kind" data-nb-kind="observation">Observations</button>
+                    <button class="nb-kind" data-nb-kind="finding">Findings</button>
+                    <button class="nb-kind" data-nb-kind="question">Questions</button>
+                </div>
+            </div>
+            <div class="nb-body-wrap">
+                <aside class="nb-threads" id="nb-threads"></aside>
+                <div class="nb-notes" id="nb-notes"></div>
+            </div>
+        </div>
+    </div>
+
     <!-- Devices Tab -->
     <div id="devices-content" class="tab-content">
         <div class="devices-container devices-container-map">
@@ -785,6 +806,7 @@ <h3 class="devices-properties-title">Properties</h3>
     <!-- Three.js for 3D volume viewer -->
     <script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>
     <script src="/static/js/occupancy3d.js"></script>
+    <script src="/static/js/notebook.js"></script>
     <script src="/static/js/app.js"></script>
     <script src="/static/js/home.js"></script>
     <script src="/static/js/campaigns.js"></script>

From 1c87896382ecbce01dee31eb78a1f23c7821c7b1 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 18:02:38 +0530
Subject: [PATCH 135/314] plan: notebook live edge (Agent's view recent notes)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../plans/2026-06-16-notebook-live-edge.md    | 188 ++++++++++++++++++
 1 file changed, 188 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-16-notebook-live-edge.md

diff --git a/docs/superpowers/plans/2026-06-16-notebook-live-edge.md b/docs/superpowers/plans/2026-06-16-notebook-live-edge.md
new file mode 100644
index 00000000..9265d769
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-16-notebook-live-edge.md
@@ -0,0 +1,188 @@
+# Notebook Live Edge Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans. Steps use checkbox (`- [ ]`) syntax.
+
+**Goal:** Make the Home "Agent's view" panel surface recent notebook activity — the ambient "live edge" of the notebook (design §3, two-faced presentation), complementing the Notebook tab (the reading room).
+
+**Architecture:** Add an optional `limit` to the notes read API (TDD). Extend `context-surface.js` to also fetch recent notes and render a "From the notebook" section whose rows click through to the Notebook tab. Reuse the existing `cx-dot` colors (amber/blue/green) for kinds — no new CSS.
+
+**Tech Stack:** FastAPI, pytest + TestClient (venv), vanilla JS.
+
+**Out of scope:** retrieval/"Ask the notebook" (next increment); proactive surfacing.
+
+---
+
+### Task 1: `limit` param on `GET /api/notebook/notes`
+
+**Files:**
+- Modify: `gently/ui/web/routes/notebook.py`
+- Test: `tests/test_notebook_api.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_api.py
+class TestLimit:
+    def test_limit_returns_newest(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?limit=1").json()
+        assert len(data["notes"]) == 1  # newest-first, capped
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_api.py::TestLimit -v`
+Expected: FAIL — returns 2 notes, not 1.
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `gently/ui/web/routes/notebook.py`, add a `limit` param to `list_notes` and slice. Replace the `list_notes` signature and the final return:
+
+```python
+    @router.get("/api/notebook/notes")
+    async def list_notes(
+        kind: str | None = None,
+        author: str | None = None,
+        status: str | None = None,
+        strain: str | None = None,
+        embryo: str | None = None,
+        thread: str | None = None,
+        limit: int | None = None,
+    ):
+        nb = _nb()
+        if nb is None:
+            return {"available": False, "notes": []}
+        notes = nb.query_notes(
+            kind=_coerce(NoteKind, kind),
+            author=_coerce(Author, author),
+            status=_coerce(NoteStatus, status),
+            strain=strain,
+            embryo=embryo,
+            thread=thread,
+        )
+        if limit is not None and limit >= 0:
+            notes = notes[:limit]
+        return {"available": True, "notes": [note_to_dict(n) for n in notes]}
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_api.py -q`
+Expected: all pass
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/routes/notebook.py tests/test_notebook_api.py
+git commit -m "feat(notebook): limit param on GET /api/notebook/notes"
+```
+
+---
+
+### Task 2: "From the notebook" section in the Agent's-view panel
+
+**Files:**
+- Modify: `gently/ui/web/static/js/context-surface.js`
+
+Verification is browser-based (chrome-devtools), not pytest.
+
+- [ ] **Step 1: Extend `fetchAndRender` to also pull recent notes**
+
+Replace `fetchAndRender` with a version that fetches both endpoints and passes notes to `render`:
+
+```javascript
+    async function fetchAndRender() {
+        if (!el || loading) return;
+        loading = true;
+        try {
+            const [ctx, nb] = await Promise.all([
+                fetch('/api/context').then(r => r.json()).catch(() => ({})),
+                fetch('/api/notebook/notes?limit=5').then(r => r.json()).catch(() => ({})),
+            ]);
+            render(ctx || {}, (nb && nb.notes) || []);
+        } catch (e) { /* keep last render */ }
+        finally { loading = false; }
+    }
+```
+
+- [ ] **Step 2: Render the notebook section**
+
+Replace `render(data)` with `render(data, notes)`. Add the notebook section and include notes in the empty-state check. Replace the whole `render` function body:
+
+```javascript
+    function render(data, notes) {
+        if (!el) return;
+        notes = notes || [];
+        const hc = hasControl();
+        const questions = data.questions || [], watchpoints = data.watchpoints || [], expectations = data.expectations || [];
+        el.classList.remove('hidden');
+        if (!questions.length && !watchpoints.length && !expectations.length && !notes.length) {
+            el.innerHTML = '<div class="cx-title">Agent’s view</div>' +
+                '<div class="cx-empty">Nothing yet — the agent’s notes, expectations, and open questions appear here as it works.</div>';
+            return;
+        }
+
+        const qHtml = questions.map(it => `
+            <div class="cx-item" data-kind="questions" data-id="${esc(it.id)}">
+                <span class="cx-dot cx-q"></span>
+                <span class="cx-text">${esc(it.content)}</span>
+                ${hc ? '<button class="cx-act" data-act="answer">Answer</button>' : ''}
+                ${hc ? '<div class="cx-answer hidden"><input class="cx-answer-input" placeholder="Answer / resolve…"><button class="cx-answer-go">→</button></div>' : ''}
+            </div>`).join('');
+        const wHtml = watchpoints.map(it => `
+            <div class="cx-item" data-kind="watchpoints" data-id="${esc(it.id)}">
+                <span class="cx-dot cx-w"></span>
+                <span class="cx-text">${esc(it.target)}${it.condition ? ' — ' + esc(it.condition) : ''}</span>
+                ${hc ? '<button class="cx-act" data-act="resolve">Resolve</button>' : ''}
+            </div>`).join('');
+        const eHtml = expectations.map(it => `
+            <div class="cx-item" data-kind="expectations" data-id="${esc(it.id)}">
+                <span class="cx-dot cx-e"></span>
+                <span class="cx-text">${esc(it.target)}${it.prediction ? ': ' + esc(it.prediction) : ''}</span>
+                ${hc ? '<button class="cx-act" data-act="confirm" title="Mark confirmed">✓</button>' : ''}
+            </div>`).join('');
+        // kind → existing cx-dot color: observation=blue, finding=green, question=amber
+        const dotFor = (k) => k === 'finding' ? 'cx-e' : (k === 'question' ? 'cx-q' : 'cx-w');
+        const nHtml = notes.map(n => `
+            <div class="cx-item cx-note" data-note="1">
+                <span class="cx-dot ${dotFor(n.kind)}"></span>
+                <span class="cx-text">${esc(n.title || n.body)}</span>
+            </div>`).join('');
+
+        el.innerHTML = '<div class="cx-title">Agent’s view</div>' +
+            section('Open questions', qHtml) + section('Watching', wHtml) +
+            section('Expectations', eHtml) + section('From the notebook', nHtml);
+        wire();
+    }
+```
+
+- [ ] **Step 3: Make notebook rows click through to the Notebook tab**
+
+In `wire()`, after the existing `.cx-item` loop, add a handler for note rows (append inside `wire`, before its closing brace):
+
+```javascript
+        el.querySelectorAll('.cx-note').forEach(row => {
+            row.style.cursor = 'pointer';
+            row.addEventListener('click', () => {
+                if (typeof switchTab === 'function') switchTab('notebook');
+            });
+        });
+```
+
+- [ ] **Step 4: Verify in the browser**
+
+Restart the server, open `http://localhost:8080`, confirm the Home "Agent's view" panel shows a "From the notebook" section with recent notes, and clicking a row switches to the Notebook tab. Use chrome-devtools (navigate, evaluate_script to click, take_screenshot, list_console_messages → zero errors).
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/static/js/context-surface.js
+git commit -m "feat(notebook): Agent's-view live edge — recent notes section -> Notebook tab"
+```
+
+---
+
+## Self-Review
+**Spec coverage:** design §3 two-faced presentation — the ambient live edge now surfaces recent notebook notes on Home, clicking through to the tab. ✓ Reuses `/api/notebook/notes` (+ new `limit`) and existing `cx-dot` colors. ✓
+**Placeholder scan:** none. ✓
+**Type consistency:** `render(data, notes)`, `dotFor`, `limit` param, `switchTab('notebook')` all consistent; kinds map to existing cx classes. ✓

From 9b28fa8b3d5a3b1e4fc2c733d274419953b2b306 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 18:04:31 +0530
Subject: [PATCH 136/314] feat(notebook): limit param on GET
 /api/notebook/notes

---
 gently/ui/web/routes/notebook.py | 3 +++
 tests/test_notebook_api.py       | 7 +++++++
 2 files changed, 10 insertions(+)

diff --git a/gently/ui/web/routes/notebook.py b/gently/ui/web/routes/notebook.py
index a0176630..b1585ff8 100644
--- a/gently/ui/web/routes/notebook.py
+++ b/gently/ui/web/routes/notebook.py
@@ -34,6 +34,7 @@ async def list_notes(
         strain: str | None = None,
         embryo: str | None = None,
         thread: str | None = None,
+        limit: int | None = None,
     ):
         nb = _nb()
         if nb is None:
@@ -46,6 +47,8 @@ async def list_notes(
             embryo=embryo,
             thread=thread,
         )
+        if limit is not None and limit >= 0:
+            notes = notes[:limit]
         return {"available": True, "notes": [note_to_dict(n) for n in notes]}
 
     @router.get("/api/notebook/notes/{note_id}")
diff --git a/tests/test_notebook_api.py b/tests/test_notebook_api.py
index 7510d5b7..b24abbd9 100644
--- a/tests/test_notebook_api.py
+++ b/tests/test_notebook_api.py
@@ -83,3 +83,10 @@ def test_thread_counts(self, file_context_store):
         data = client.get("/api/notebook/threads").json()
         assert data["available"] is True
         assert data["threads"] == [{"id": "t1", "count": 2}, {"id": "t2", "count": 1}]
+
+
+class TestLimit:
+    def test_limit_returns_newest(self, file_context_store):
+        client = TestClient(_make_app(_seed(file_context_store)))
+        data = client.get("/api/notebook/notes?limit=1").json()
+        assert len(data["notes"]) == 1  # newest-first, capped

From b6439724442c54e1a7a821ebb19bd85b3447bcd6 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 01:01:24 +0530
Subject: [PATCH 137/314] =?UTF-8?q?feat(notebook):=20Agent's-view=20live?=
 =?UTF-8?q?=20edge=20=E2=80=94=20recent=20notes=20section=20=E2=86=92=20No?=
 =?UTF-8?q?tebook=20tab?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/ui/web/static/js/context-surface.js | 33 ++++++++++++++++++----
 1 file changed, 27 insertions(+), 6 deletions(-)

diff --git a/gently/ui/web/static/js/context-surface.js b/gently/ui/web/static/js/context-surface.js
index 2e10000d..2c11e27e 100644
--- a/gently/ui/web/static/js/context-surface.js
+++ b/gently/ui/web/static/js/context-surface.js
@@ -19,23 +19,29 @@ const ContextSurface = (() => {
     async function fetchAndRender() {
         if (!el || loading) return;
         loading = true;
-        try { render(await (await fetch('/api/context')).json()); }
-        catch (e) { /* keep last render */ }
+        try {
+            const [ctx, nb] = await Promise.all([
+                fetch('/api/context').then(r => r.json()).catch(() => ({})),
+                fetch('/api/notebook/notes?limit=5').then(r => r.json()).catch(() => ({})),
+            ]);
+            render(ctx || {}, (nb && nb.notes) || []);
+        } catch (e) { /* keep last render */ }
         finally { loading = false; }
     }
 
     function section(label, html) { return html ? `<div class="cx-lens"><div class="cx-lens-h">${label}</div>${html}</div>` : ''; }
 
-    function render(data) {
+    function render(data, notes) {
         if (!el) return;
+        notes = notes || [];
         const hc = hasControl();
         const questions = data.questions || [], watchpoints = data.watchpoints || [], expectations = data.expectations || [];
         el.classList.remove('hidden');
-        if (!questions.length && !watchpoints.length && !expectations.length) {
+        if (!questions.length && !watchpoints.length && !expectations.length && !notes.length) {
             // Show an empty-state rather than vanishing, so the surface is
             // discoverable before the agent has formed any beliefs.
             el.innerHTML = '<div class="cx-title">Agent’s view</div>' +
-                '<div class="cx-empty">Nothing yet — the agent’s expectations, watchpoints, and open questions appear here as it works.</div>';
+                '<div class="cx-empty">Nothing yet — the agent’s notes, expectations, and open questions appear here as it works.</div>';
             return;
         }
 
@@ -59,8 +65,17 @@ const ContextSurface = (() => {
                 ${hc ? '<button class="cx-act" data-act="confirm" title="Mark confirmed">✓</button>' : ''}
             </div>`).join('');
 
+        // kind → existing cx-dot color: observation=blue, finding=green, question=amber
+        const dotFor = (k) => k === 'finding' ? 'cx-e' : (k === 'question' ? 'cx-q' : 'cx-w');
+        const nHtml = notes.map(n => `
+            <div class="cx-item cx-note" data-note="1">
+                <span class="cx-dot ${dotFor(n.kind)}"></span>
+                <span class="cx-text">${esc(n.title || n.body)}</span>
+            </div>`).join('');
+
         el.innerHTML = '<div class="cx-title">Agent’s view</div>' +
-            section('Open questions', qHtml) + section('Watching', wHtml) + section('Expectations', eHtml);
+            section('Open questions', qHtml) + section('Watching', wHtml) +
+            section('Expectations', eHtml) + section('From the notebook', nHtml);
         wire();
     }
 
@@ -83,6 +98,12 @@ const ContextSurface = (() => {
                 actBtn.addEventListener('click', () => resolve(kind, id, { status: 'confirmed' }));
             }
         });
+        el.querySelectorAll('.cx-note').forEach(row => {
+            row.style.cursor = 'pointer';
+            row.addEventListener('click', () => {
+                if (typeof switchTab === 'function') switchTab('notebook');
+            });
+        });
     }
 
     async function resolve(kind, id, body) {

From 814e322f9722cffdf58d3a342d965effd4181e9d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 01:17:39 +0530
Subject: [PATCH 138/314] plan: ask the notebook (increment 2 backend)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../plans/2026-06-17-notebook-ask.md          | 408 ++++++++++++++++++
 1 file changed, 408 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-17-notebook-ask.md

diff --git a/docs/superpowers/plans/2026-06-17-notebook-ask.md b/docs/superpowers/plans/2026-06-17-notebook-ask.md
new file mode 100644
index 00000000..c03ea526
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-17-notebook-ask.md
@@ -0,0 +1,408 @@
+# "Ask the Notebook" Implementation Plan (Increment 2, backend)
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans. Steps use checkbox (`- [ ]`) syntax.
+
+**Goal:** Let the notebook be *reasoned with* — given a question (+ optional scope), retrieve relevant Notes, ask Claude to synthesize a **grounded, cited** answer, and return it as a validated structured object.
+
+**Architecture:** A new module `gently/harness/memory/notebook_ask.py`: structural retrieval (`select_notes`) + a forced-`tool_choice` synthesis call (`answer_question`) that reuses gently's conventions — `anthropic.AsyncAnthropic` (per `chat.py:198`), `settings.models.main` (Opus 4.8), structured output via a pinned tool (per `verifier.py`), and **no self-rated confidence** (per the lab rule). A `POST /api/notebook/ask` route wires retrieval → synthesis. The Claude client is injected so everything is unit-testable with a fake.
+
+**Tech Stack:** Python 3.11, `anthropic` SDK, FastAPI, pytest + TestClient (venv).
+
+**Out of scope (later plans):** embeddings/semantic recall (structural-only here); the "Ask" UI box on the Notebook tab; proactive surfacing.
+
+---
+
+### Task 1: Structural retrieval — `select_notes`
+
+**Files:**
+- Create: `gently/harness/memory/notebook_ask.py`
+- Test: `tests/test_notebook_ask.py`
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_notebook_ask.py
+"""Tests for 'Ask the notebook' — retrieval + grounded synthesis."""
+
+from gently.harness.memory.notebook import Note, NoteKind
+from gently.harness.memory.notebook_ask import select_notes
+
+
+def _seed(cs):
+    nb = cs.notebook
+    nb.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"], threads=["t1"]))
+    nb.write_note(Note(id="f1", kind=NoteKind.FINDING, body="12 min/degC", strains=["N2"], threads=["t1"]))
+    nb.write_note(Note(id="x1", kind=NoteKind.OBSERVATION, body="unrelated", strains=["OH904"]))
+    return nb
+
+
+class TestSelectNotes:
+    def test_scope_by_thread(self, file_context_store):
+        nb = _seed(file_context_store)
+        ids = {n.id for n in select_notes(nb, thread="t1")}
+        assert ids == {"o1", "f1"}
+
+    def test_scope_by_strain(self, file_context_store):
+        nb = _seed(file_context_store)
+        ids = {n.id for n in select_notes(nb, strain="OH904")}
+        assert ids == {"x1"}
+
+    def test_no_scope_returns_recent_capped(self, file_context_store):
+        nb = _seed(file_context_store)
+        notes = select_notes(nb, limit=2)
+        assert len(notes) == 2  # newest-first, capped
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_ask.py::TestSelectNotes -v`
+Expected: FAIL — `ModuleNotFoundError: No module named 'gently.harness.memory.notebook_ask'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# gently/harness/memory/notebook_ask.py
+"""Ask the notebook — retrieve relevant Notes and synthesize a grounded,
+cited answer with Claude. Structural retrieval only (semantic recall is a
+later increment). See docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md §4.
+"""
+
+from __future__ import annotations
+
+from .notebook import Note, NotebookStore
+
+
+def select_notes(
+    store: NotebookStore,
+    *,
+    thread: str | None = None,
+    strain: str | None = None,
+    limit: int = 12,
+) -> list[Note]:
+    """Structural narrowing: scope by thread/strain when given, else recent.
+    Returns newest-first, capped at `limit`."""
+    notes = store.query_notes(thread=thread, strain=strain)
+    return notes[:limit]
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_ask.py::TestSelectNotes -v`
+Expected: PASS (3 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook_ask.py tests/test_notebook_ask.py
+git commit -m "feat(notebook): select_notes — structural retrieval for ask"
+```
+
+---
+
+### Task 2: Grounded synthesis — `answer_question` (forced tool)
+
+**Files:**
+- Modify: `gently/harness/memory/notebook_ask.py`
+- Test: `tests/test_notebook_ask.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_ask.py
+import asyncio
+
+from gently.harness.memory.notebook_ask import ASK_TOOL, answer_question, build_ask_messages
+
+
+class _FakeBlock:
+    def __init__(self, inp):
+        self.type = "tool_use"
+        self.input = inp
+
+
+class _FakeResp:
+    def __init__(self, inp):
+        self.content = [_FakeBlock(inp)]
+        self.stop_reason = "tool_use"
+
+
+class _FakeMessages:
+    def __init__(self, captured, inp):
+        self._captured, self._inp = captured, inp
+
+    async def create(self, **kwargs):
+        self._captured.update(kwargs)
+        return _FakeResp(self._inp)
+
+
+class _FakeClient:
+    def __init__(self, inp):
+        self.captured = {}
+        self.messages = _FakeMessages(self.captured, inp)
+
+
+class TestAnswerQuestion:
+    def test_build_messages_embeds_note_ids(self):
+        notes = [Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed")]
+        msgs = build_ask_messages("what formed?", notes)
+        text = msgs[0]["content"]
+        assert "o1" in text and "ring formed" in text and "what formed?" in text
+
+    def test_answer_returns_structured_and_forces_tool(self):
+        canned = {"answer": "A ring formed.", "points": [{"text": "ring formed", "note_ids": ["o1"]}],
+                  "suggested_next": [], "coverage": "covered"}
+        client = _FakeClient(canned)
+        notes = [Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed")]
+        out = asyncio.run(answer_question(client, "m", "what formed?", notes))
+        assert out == canned
+        # tool_choice is pinned to the ask tool (forced structured output)
+        assert client.captured["tool_choice"] == {"type": "tool", "name": ASK_TOOL["name"]}
+        assert client.captured["model"] == "m"
+
+    def test_answer_no_notes_short_circuits_without_api(self):
+        client = _FakeClient({"should": "not be used"})
+        out = asyncio.run(answer_question(client, "m", "anything?", []))
+        assert out["coverage"] == "not_in_notebook"
+        assert client.captured == {}  # no API call when nothing to ground on
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_ask.py::TestAnswerQuestion -v`
+Expected: FAIL — `ImportError: cannot import name 'ASK_TOOL'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+Append to `gently/harness/memory/notebook_ask.py`:
+
+```python
+# ASK_TOOL pins the structured output. No confidence field — we don't ask the
+# model to self-rate (lab rule); "coverage" is a factual grounding classification.
+ASK_TOOL = {
+    "name": "answer_from_notebook",
+    "description": "Return a grounded answer built ONLY from the provided notebook entries.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "answer": {"type": "string", "description": "Direct synthesis grounded in the notes."},
+            "points": {
+                "type": "array",
+                "description": "Supporting points, each citing the note ids it rests on.",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "text": {"type": "string"},
+                        "note_ids": {"type": "array", "items": {"type": "string"}},
+                    },
+                    "required": ["text", "note_ids"],
+                },
+            },
+            "suggested_next": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Concrete next experiments/moves if the question asks what to do; else empty.",
+            },
+            "coverage": {
+                "type": "string",
+                "enum": ["covered", "partial", "not_in_notebook"],
+                "description": "How well the provided notes cover the question.",
+            },
+        },
+        "required": ["answer", "points", "coverage"],
+    },
+}
+
+_SYSTEM = (
+    "You reason over a shared lab notebook. Answer ONLY from the notebook entries "
+    "provided — every claim must cite the note id(s) it rests on. If the notes do "
+    "not contain the answer, say so plainly and set coverage to 'not_in_notebook'. "
+    "Never invent facts not in the notes. Call the answer_from_notebook tool."
+)
+
+
+def _render_notes(notes: list[Note]) -> str:
+    lines = []
+    for n in notes:
+        scope = []
+        if n.strains:
+            scope.append("strains=" + ",".join(n.strains))
+        if n.embryos:
+            scope.append("embryos=" + ",".join(n.embryos))
+        tag = f" [{'; '.join(scope)}]" if scope else ""
+        lines.append(f"[{n.id}] ({n.kind.value}){tag} {n.body}")
+    return "\n".join(lines)
+
+
+def build_ask_messages(question: str, notes: list[Note]) -> list[dict]:
+    body = (
+        "Notebook entries:\n"
+        + _render_notes(notes)
+        + f"\n\nQuestion: {question}\n\n"
+        "Answer using only these entries, citing note ids."
+    )
+    return [{"role": "user", "content": body}]
+
+
+async def answer_question(client, model: str, question: str, notes: list[Note]) -> dict:
+    """Force the ask tool and return its validated input dict. Short-circuits
+    (no API call) when there are no notes to ground on."""
+    if not notes:
+        return {
+            "answer": "The notebook doesn't cover this yet.",
+            "points": [],
+            "suggested_next": [],
+            "coverage": "not_in_notebook",
+        }
+    resp = await client.messages.create(
+        model=model,
+        max_tokens=2048,
+        system=_SYSTEM,
+        tools=[ASK_TOOL],
+        tool_choice={"type": "tool", "name": ASK_TOOL["name"]},
+        messages=build_ask_messages(question, notes),
+    )
+    for block in resp.content:
+        if getattr(block, "type", None) == "tool_use":
+            return block.input
+    return {"answer": "", "points": [], "suggested_next": [], "coverage": "not_in_notebook"}
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_ask.py -q`
+Expected: all pass
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/harness/memory/notebook_ask.py tests/test_notebook_ask.py
+git commit -m "feat(notebook): answer_question — forced-tool grounded synthesis"
+```
+
+---
+
+### Task 3: `POST /api/notebook/ask`
+
+**Files:**
+- Modify: `gently/ui/web/routes/notebook.py`
+- Test: `tests/test_notebook_api.py` (append)
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# append to tests/test_notebook_api.py
+class _AskBlock:
+    def __init__(self, inp):
+        self.type = "tool_use"
+        self.input = inp
+
+
+class _AskResp:
+    def __init__(self, inp):
+        self.content = [_AskBlock(inp)]
+        self.stop_reason = "tool_use"
+
+
+class _AskMessages:
+    def __init__(self, inp):
+        self._inp = inp
+
+    async def create(self, **kwargs):
+        return _AskResp(self._inp)
+
+
+class _AskClient:
+    def __init__(self, inp):
+        self.messages = _AskMessages(inp)
+
+
+def _make_app_with_client(context_store, client):
+    from gently.ui.web.routes.notebook import create_router
+
+    app = FastAPI()
+
+    class _Server:
+        pass
+
+    server = _Server()
+    server.context_store = context_store
+    server.claude_async = client
+    app.include_router(create_router(server))
+    return app
+
+
+class TestAsk:
+    def test_ask_returns_grounded_answer(self, file_context_store):
+        cs = _seed(file_context_store)
+        canned = {"answer": "A ring formed.", "points": [{"text": "ring", "note_ids": ["o1"]}],
+                  "suggested_next": [], "coverage": "covered"}
+        client = TestClient(_make_app_with_client(cs, _AskClient(canned)))
+        resp = client.post("/api/notebook/ask", json={"question": "what happened?"})
+        assert resp.status_code == 200
+        assert resp.json()["coverage"] == "covered"
+
+    def test_ask_no_store(self):
+        client = TestClient(_make_app(None))
+        resp = client.post("/api/notebook/ask", json={"question": "x"})
+        assert resp.json() == {"available": False}
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_api.py::TestAsk -v`
+Expected: FAIL — 404/405 (route not defined)
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `gently/ui/web/routes/notebook.py`, add `Body` to the fastapi import and add the route inside `create_router`, before `return router`:
+
+```python
+    @router.post("/api/notebook/ask")
+    async def ask(
+        question: str = Body(..., embed=True),
+        thread: str | None = Body(None, embed=True),
+        strain: str | None = Body(None, embed=True),
+    ):
+        nb = _nb()
+        if nb is None:
+            return {"available": False}
+        from gently.harness.memory.notebook_ask import answer_question, select_notes
+        from gently.settings import settings
+
+        notes = select_notes(nb, thread=thread, strain=strain)
+        client = getattr(server, "claude_async", None)
+        if client is None:
+            import anthropic
+
+            client = anthropic.AsyncAnthropic()
+        result = await answer_question(client, settings.models.main, question, notes)
+        result["available"] = True
+        result["note_ids"] = [n.id for n in notes]
+        return result
+```
+
+Update the import line at the top of the file:
+
+```python
+from fastapi import APIRouter, Body, HTTPException
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `.venv/bin/python -m pytest tests/test_notebook_api.py -q`
+Expected: all pass
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/routes/notebook.py tests/test_notebook_api.py
+git commit -m "feat(notebook): POST /api/notebook/ask — grounded notebook Q&A"
+```
+
+---
+
+## Self-Review
+**Spec coverage (design §4):** structural retrieval (`select_notes`) → grounded synthesis (`answer_question`, forced tool, cited, "not_in_notebook" valid) → endpoint. ✓ No self-rated confidence (`coverage` is grounding, not correctness-confidence). ✓ Reuses `settings.models.main`, `anthropic.AsyncAnthropic`, the `verifier.py` forced-tool pattern. ✓ Client injected → unit-testable without real API. ✓
+**Deferred (correct):** embeddings/semantic recall; the "Ask" UI; proactive surfacing.
+**Placeholder scan:** none — complete code + commands. ✓
+**Type consistency:** `select_notes`, `answer_question`, `ASK_TOOL`, `build_ask_messages` named consistently across tasks/tests; route uses `server.claude_async` (tests inject) with a real `AsyncAnthropic` fallback. ✓

From 8928084f513916f7378f52418a10533fa9973024 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 01:19:33 +0530
Subject: [PATCH 139/314] =?UTF-8?q?feat(notebook):=20ask=20backend=20?=
 =?UTF-8?q?=E2=80=94=20select=5Fnotes=20retrieval=20+=20forced-tool=20grou?=
 =?UTF-8?q?nded=20synthesis?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/harness/memory/notebook_ask.py | 112 ++++++++++++++++++++++++++
 tests/test_notebook_ask.py            |  87 ++++++++++++++++++++
 2 files changed, 199 insertions(+)
 create mode 100644 gently/harness/memory/notebook_ask.py
 create mode 100644 tests/test_notebook_ask.py

diff --git a/gently/harness/memory/notebook_ask.py b/gently/harness/memory/notebook_ask.py
new file mode 100644
index 00000000..acfed322
--- /dev/null
+++ b/gently/harness/memory/notebook_ask.py
@@ -0,0 +1,112 @@
+"""Ask the notebook — retrieve relevant Notes and synthesize a grounded,
+cited answer with Claude. Structural retrieval only (semantic recall is a
+later increment). See docs/superpowers/specs/2026-06-16-shared-lab-notebook-design.md §4.
+"""
+
+from __future__ import annotations
+
+from .notebook import Note, NotebookStore
+
+
+def select_notes(
+    store: NotebookStore,
+    *,
+    thread: str | None = None,
+    strain: str | None = None,
+    limit: int = 12,
+) -> list[Note]:
+    """Structural narrowing: scope by thread/strain when given, else recent.
+    Returns newest-first, capped at ``limit``."""
+    notes = store.query_notes(thread=thread, strain=strain)
+    return notes[:limit]
+
+
+# ASK_TOOL pins the structured output. No confidence field — we don't ask the
+# model to self-rate (lab rule); "coverage" is a factual grounding classification.
+ASK_TOOL = {
+    "name": "answer_from_notebook",
+    "description": "Return a grounded answer built ONLY from the provided notebook entries.",
+    "input_schema": {
+        "type": "object",
+        "properties": {
+            "answer": {"type": "string", "description": "Direct synthesis grounded in the notes."},
+            "points": {
+                "type": "array",
+                "description": "Supporting points, each citing the note ids it rests on.",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "text": {"type": "string"},
+                        "note_ids": {"type": "array", "items": {"type": "string"}},
+                    },
+                    "required": ["text", "note_ids"],
+                },
+            },
+            "suggested_next": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Concrete next experiments/moves if the question asks what to do; else empty.",
+            },
+            "coverage": {
+                "type": "string",
+                "enum": ["covered", "partial", "not_in_notebook"],
+                "description": "How well the provided notes cover the question.",
+            },
+        },
+        "required": ["answer", "points", "coverage"],
+    },
+}
+
+_SYSTEM = (
+    "You reason over a shared lab notebook. Answer ONLY from the notebook entries "
+    "provided — every claim must cite the note id(s) it rests on. If the notes do "
+    "not contain the answer, say so plainly and set coverage to 'not_in_notebook'. "
+    "Never invent facts not in the notes. Call the answer_from_notebook tool."
+)
+
+
+def _render_notes(notes: list[Note]) -> str:
+    lines = []
+    for n in notes:
+        scope = []
+        if n.strains:
+            scope.append("strains=" + ",".join(n.strains))
+        if n.embryos:
+            scope.append("embryos=" + ",".join(n.embryos))
+        tag = f" [{'; '.join(scope)}]" if scope else ""
+        lines.append(f"[{n.id}] ({n.kind.value}){tag} {n.body}")
+    return "\n".join(lines)
+
+
+def build_ask_messages(question: str, notes: list[Note]) -> list[dict]:
+    body = (
+        "Notebook entries:\n"
+        + _render_notes(notes)
+        + f"\n\nQuestion: {question}\n\n"
+        "Answer using only these entries, citing note ids."
+    )
+    return [{"role": "user", "content": body}]
+
+
+async def answer_question(client, model: str, question: str, notes: list[Note]) -> dict:
+    """Force the ask tool and return its validated input dict. Short-circuits
+    (no API call) when there are no notes to ground on."""
+    if not notes:
+        return {
+            "answer": "The notebook doesn't cover this yet.",
+            "points": [],
+            "suggested_next": [],
+            "coverage": "not_in_notebook",
+        }
+    resp = await client.messages.create(
+        model=model,
+        max_tokens=2048,
+        system=_SYSTEM,
+        tools=[ASK_TOOL],
+        tool_choice={"type": "tool", "name": ASK_TOOL["name"]},
+        messages=build_ask_messages(question, notes),
+    )
+    for block in resp.content:
+        if getattr(block, "type", None) == "tool_use":
+            return block.input
+    return {"answer": "", "points": [], "suggested_next": [], "coverage": "not_in_notebook"}
diff --git a/tests/test_notebook_ask.py b/tests/test_notebook_ask.py
new file mode 100644
index 00000000..9f501090
--- /dev/null
+++ b/tests/test_notebook_ask.py
@@ -0,0 +1,87 @@
+"""Tests for 'Ask the notebook' — retrieval + grounded synthesis."""
+
+import asyncio
+
+from gently.harness.memory.notebook import Note, NoteKind
+from gently.harness.memory.notebook_ask import (
+    ASK_TOOL,
+    answer_question,
+    build_ask_messages,
+    select_notes,
+)
+
+
+def _seed(cs):
+    nb = cs.notebook
+    nb.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"], threads=["t1"]))
+    nb.write_note(Note(id="f1", kind=NoteKind.FINDING, body="12 min/degC", strains=["N2"], threads=["t1"]))
+    nb.write_note(Note(id="x1", kind=NoteKind.OBSERVATION, body="unrelated", strains=["OH904"]))
+    return nb
+
+
+class TestSelectNotes:
+    def test_scope_by_thread(self, file_context_store):
+        nb = _seed(file_context_store)
+        ids = {n.id for n in select_notes(nb, thread="t1")}
+        assert ids == {"o1", "f1"}
+
+    def test_scope_by_strain(self, file_context_store):
+        nb = _seed(file_context_store)
+        ids = {n.id for n in select_notes(nb, strain="OH904")}
+        assert ids == {"x1"}
+
+    def test_no_scope_returns_recent_capped(self, file_context_store):
+        nb = _seed(file_context_store)
+        notes = select_notes(nb, limit=2)
+        assert len(notes) == 2  # newest-first, capped
+
+
+class _FakeBlock:
+    def __init__(self, inp):
+        self.type = "tool_use"
+        self.input = inp
+
+
+class _FakeResp:
+    def __init__(self, inp):
+        self.content = [_FakeBlock(inp)]
+        self.stop_reason = "tool_use"
+
+
+class _FakeMessages:
+    def __init__(self, captured, inp):
+        self._captured, self._inp = captured, inp
+
+    async def create(self, **kwargs):
+        self._captured.update(kwargs)
+        return _FakeResp(self._inp)
+
+
+class _FakeClient:
+    def __init__(self, inp):
+        self.captured = {}
+        self.messages = _FakeMessages(self.captured, inp)
+
+
+class TestAnswerQuestion:
+    def test_build_messages_embeds_note_ids(self):
+        notes = [Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed")]
+        msgs = build_ask_messages("what formed?", notes)
+        text = msgs[0]["content"]
+        assert "o1" in text and "ring formed" in text and "what formed?" in text
+
+    def test_answer_returns_structured_and_forces_tool(self):
+        canned = {"answer": "A ring formed.", "points": [{"text": "ring formed", "note_ids": ["o1"]}],
+                  "suggested_next": [], "coverage": "covered"}
+        client = _FakeClient(canned)
+        notes = [Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed")]
+        out = asyncio.run(answer_question(client, "m", "what formed?", notes))
+        assert out == canned
+        assert client.captured["tool_choice"] == {"type": "tool", "name": ASK_TOOL["name"]}
+        assert client.captured["model"] == "m"
+
+    def test_answer_no_notes_short_circuits_without_api(self):
+        client = _FakeClient({"should": "not be used"})
+        out = asyncio.run(answer_question(client, "m", "anything?", []))
+        assert out["coverage"] == "not_in_notebook"
+        assert client.captured == {}  # no API call when nothing to ground on

From 13b4dd245c5b540d1cc1dd7d56ae63f854a563c8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 01:21:20 +0530
Subject: [PATCH 140/314] =?UTF-8?q?feat(notebook):=20POST=20/api/notebook/?=
 =?UTF-8?q?ask=20=E2=80=94=20grounded=20notebook=20Q&A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/ui/web/routes/notebook.py | 25 +++++++++++++-
 tests/test_notebook_api.py       | 56 ++++++++++++++++++++++++++++++++
 2 files changed, 80 insertions(+), 1 deletion(-)

diff --git a/gently/ui/web/routes/notebook.py b/gently/ui/web/routes/notebook.py
index b1585ff8..b9cb27da 100644
--- a/gently/ui/web/routes/notebook.py
+++ b/gently/ui/web/routes/notebook.py
@@ -4,7 +4,7 @@
 Read-only here; authoring/curation come in a later increment.
 """
 
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter, Body, HTTPException
 
 from gently.harness.memory.notebook import Author, NoteKind, NoteStatus, note_to_dict
 
@@ -73,4 +73,27 @@ async def list_threads():
         threads = [{"id": t, "count": c} for t, c in sorted(counts.items())]
         return {"available": True, "threads": threads}
 
+    @router.post("/api/notebook/ask")
+    async def ask(
+        question: str = Body(..., embed=True),
+        thread: str | None = Body(None, embed=True),
+        strain: str | None = Body(None, embed=True),
+    ):
+        nb = _nb()
+        if nb is None:
+            return {"available": False}
+        from gently.harness.memory.notebook_ask import answer_question, select_notes
+        from gently.settings import settings
+
+        notes = select_notes(nb, thread=thread, strain=strain)
+        client = getattr(server, "claude_async", None)
+        if client is None:
+            import anthropic
+
+            client = anthropic.AsyncAnthropic()
+        result = await answer_question(client, settings.models.main, question, notes)
+        result["available"] = True
+        result["note_ids"] = [n.id for n in notes]
+        return result
+
     return router
diff --git a/tests/test_notebook_api.py b/tests/test_notebook_api.py
index b24abbd9..1d18333b 100644
--- a/tests/test_notebook_api.py
+++ b/tests/test_notebook_api.py
@@ -90,3 +90,59 @@ def test_limit_returns_newest(self, file_context_store):
         client = TestClient(_make_app(_seed(file_context_store)))
         data = client.get("/api/notebook/notes?limit=1").json()
         assert len(data["notes"]) == 1  # newest-first, capped
+
+
+class _AskBlock:
+    def __init__(self, inp):
+        self.type = "tool_use"
+        self.input = inp
+
+
+class _AskResp:
+    def __init__(self, inp):
+        self.content = [_AskBlock(inp)]
+        self.stop_reason = "tool_use"
+
+
+class _AskMessages:
+    def __init__(self, inp):
+        self._inp = inp
+
+    async def create(self, **kwargs):
+        return _AskResp(self._inp)
+
+
+class _AskClient:
+    def __init__(self, inp):
+        self.messages = _AskMessages(inp)
+
+
+def _make_app_with_client(context_store, client):
+    from gently.ui.web.routes.notebook import create_router
+
+    app = FastAPI()
+
+    class _Server:
+        pass
+
+    server = _Server()
+    server.context_store = context_store
+    server.claude_async = client
+    app.include_router(create_router(server))
+    return app
+
+
+class TestAsk:
+    def test_ask_returns_grounded_answer(self, file_context_store):
+        cs = _seed(file_context_store)
+        canned = {"answer": "A ring formed.", "points": [{"text": "ring", "note_ids": ["o1"]}],
+                  "suggested_next": [], "coverage": "covered"}
+        client = TestClient(_make_app_with_client(cs, _AskClient(canned)))
+        resp = client.post("/api/notebook/ask", json={"question": "what happened?"})
+        assert resp.status_code == 200
+        assert resp.json()["coverage"] == "covered"
+
+    def test_ask_no_store(self):
+        client = TestClient(_make_app(None))
+        resp = client.post("/api/notebook/ask", json={"question": "x"})
+        assert resp.json() == {"available": False}

From c7be82a81bd87431c2fa50494d2450fe5e886308 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 01:39:59 +0530
Subject: [PATCH 141/314] feat(notebook): 'Ask the notebook' box on the
 Notebook tab

Question field -> POST /api/notebook/ask, rendering the grounded answer with
a coverage badge, cited 'Why' points (note-id chips), and 'Try next' steps.
Asks within the selected thread scope. Verified live against Opus 4.8.
---
 gently/ui/web/static/css/notebook.css | 42 +++++++++++++++++++++
 gently/ui/web/static/js/notebook.js   | 54 +++++++++++++++++++++++++++
 gently/ui/web/templates/index.html    |  6 +++
 3 files changed, 102 insertions(+)

diff --git a/gently/ui/web/static/css/notebook.css b/gently/ui/web/static/css/notebook.css
index 14810510..fa4cebab 100644
--- a/gently/ui/web/static/css/notebook.css
+++ b/gently/ui/web/static/css/notebook.css
@@ -19,6 +19,48 @@
 .nb-kind:hover { color: var(--text, #0f172a); border-color: var(--border-strong, #cbd5e1); }
 .nb-kind.active { background: var(--accent, #2f6df6); border-color: var(--accent, #2f6df6); color: #fff; }
 
+/* Ask the notebook */
+.nb-ask { display: flex; gap: 9px; margin-bottom: 14px; }
+.nb-ask-input {
+    flex: 1; border: 1px solid var(--border, #e4e9f0); border-radius: 11px;
+    padding: 11px 14px; font: inherit; font-size: 14px; color: var(--text, #0f172a);
+    background: var(--bg-card, #fff);
+}
+.nb-ask-input:focus { outline: none; border-color: var(--accent, #2f6df6); box-shadow: 0 0 0 4px rgba(96, 165, 250, .15); }
+.nb-ask-go {
+    flex: none; border: 0; border-radius: 11px; padding: 11px 20px; font: inherit; font-size: 14px;
+    font-weight: 600; color: #fff; background: var(--accent, #2f6df6); cursor: pointer; transition: background .15s;
+}
+.nb-ask-go:hover { background: color-mix(in srgb, var(--accent) 88%, #000); }
+
+.nb-ask-result {
+    border: 1px solid var(--border, #e4e9f0); border-radius: 13px; padding: 16px 18px; margin-bottom: 18px;
+    background: var(--accent-soft, #f5f8ff);
+}
+.nb-ask-result[hidden] { display: none; }
+.nb-ask-loading, .nb-ask-empty { color: var(--text-muted, #94a3b8); font-size: 14px; font-style: italic; }
+.nb-ask-cov {
+    display: inline-block; font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase;
+    padding: 2px 9px; border-radius: 999px; margin-bottom: 10px; color: #fff; background: var(--text-muted, #94a3b8);
+}
+.nb-cov-covered { background: var(--accent-green, #16a34a); }
+.nb-cov-partial { background: #d97706; }
+.nb-cov-not_in_notebook { background: var(--text-muted, #94a3b8); }
+.nb-ask-answer { font-size: 14.5px; line-height: 1.55; color: var(--text, #0f172a); }
+.nb-ask-h {
+    font-size: var(--v2-fs-eyebrow, 11px); font-weight: 700; letter-spacing: .06em; text-transform: uppercase;
+    color: var(--text-secondary, #475569); margin: 14px 0 6px;
+}
+.nb-ask-points { list-style: none; padding: 0; margin: 0; display: flex; flex-direction: column; gap: 7px; }
+.nb-ask-point { font-size: 13.5px; line-height: 1.45; color: var(--text, #0f172a); display: flex; flex-wrap: wrap; align-items: baseline; gap: 6px; }
+.nb-cite {
+    font: 600 11px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace;
+    color: var(--accent, #2f6df6); background: var(--bg-card, #fff);
+    border: 1px solid var(--border, #e4e9f0); border-radius: 6px; padding: 1px 6px;
+}
+.nb-ask-next { margin: 0; padding-left: 18px; font-size: 13.5px; line-height: 1.5; color: var(--text-secondary, #475569); }
+.nb-ask-next li { margin: 2px 0; }
+
 .nb-body-wrap { display: grid; grid-template-columns: 220px 1fr; gap: 22px; align-items: start; }
 @media (max-width: 760px) { .nb-body-wrap { grid-template-columns: 1fr; } }
 
diff --git a/gently/ui/web/static/js/notebook.js b/gently/ui/web/static/js/notebook.js
index 2fe94c6c..1130a31a 100644
--- a/gently/ui/web/static/js/notebook.js
+++ b/gently/ui/web/static/js/notebook.js
@@ -123,12 +123,66 @@ const NotebookApp = (() => {
         });
     }
 
+    // ── Ask the notebook ───────────────────────────────────────────────
+    function renderAskResult(data) {
+        const box = $('nb-ask-result');
+        if (!box) return;
+        box.hidden = false;
+        if (!data || data.available === false) {
+            box.innerHTML = '<div class="nb-ask-empty">The notebook is unavailable right now.</div>';
+            return;
+        }
+        const cov = data.coverage || 'covered';
+        const covLabel = { covered: 'Grounded in the notebook', partial: 'Partially covered', not_in_notebook: 'Not in the notebook yet' }[cov] || cov;
+        const points = (data.points || []).map(p => `
+            <li class="nb-ask-point">
+                <span>${esc(p.text)}</span>
+                ${(p.note_ids || []).map(id => `<span class="nb-cite">${esc(id)}</span>`).join('')}
+            </li>`).join('');
+        const nexts = (data.suggested_next || []).map(s => `<li>${esc(s)}</li>`).join('');
+        box.innerHTML =
+            `<div class="nb-ask-cov nb-cov-${esc(cov)}">${esc(covLabel)}</div>` +
+            `<div class="nb-ask-answer">${esc(data.answer || '')}</div>` +
+            (points ? `<div class="nb-ask-h">Why</div><ul class="nb-ask-points">${points}</ul>` : '') +
+            (nexts ? `<div class="nb-ask-h">Try next</div><ul class="nb-ask-next">${nexts}</ul>` : '');
+    }
+
+    async function ask() {
+        const input = $('nb-ask-input');
+        const box = $('nb-ask-result');
+        const q = (input && input.value || '').trim();
+        if (!q) return;
+        if (box) { box.hidden = false; box.innerHTML = '<div class="nb-ask-loading">Thinking over the notebook…</div>'; }
+        const body = { question: q };
+        if (threadFilter) body.thread = threadFilter;   // ask within the selected thread
+        try {
+            const r = await fetch('/api/notebook/ask', {
+                method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body),
+            });
+            renderAskResult(await r.json());
+        } catch (e) {
+            if (box) box.innerHTML = '<div class="nb-ask-empty">Something went wrong asking the notebook.</div>';
+        }
+    }
+
+    function setupAsk() {
+        const go = $('nb-ask-go'), input = $('nb-ask-input');
+        if (go) go.addEventListener('click', ask);
+        if (input) input.addEventListener('keydown', e => { if (e.key === 'Enter') { e.preventDefault(); ask(); } });
+    }
+
+    function esc(s) {
+        return (typeof escapeHtml === 'function') ? escapeHtml(String(s == null ? '' : s))
+            : String(s == null ? '' : s).replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+    }
+
     function refresh() { loadThreads(); loadNotes(); }
 
     function init() {
         if (inited) { refresh(); return; }
         inited = true;
         setupFilters();
+        setupAsk();
         refresh();
         // Notebook writes ride the CONTEXT_UPDATED event — live-refresh if visible.
         if (typeof ClientEventBus !== 'undefined') {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 242e5441..8bc8bf06 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -423,6 +423,12 @@ <h2 class="nb-title">Notebook</h2>
                     <button class="nb-kind" data-nb-kind="question">Questions</button>
                 </div>
             </div>
+            <div class="nb-ask">
+                <input id="nb-ask-input" class="nb-ask-input"
+                       placeholder="Ask the notebook…  e.g. what should I try next on pioneer guidance?">
+                <button id="nb-ask-go" class="nb-ask-go">Ask</button>
+            </div>
+            <div id="nb-ask-result" class="nb-ask-result" hidden></div>
             <div class="nb-body-wrap">
                 <aside class="nb-threads" id="nb-threads"></aside>
                 <div class="nb-notes" id="nb-notes"></div>

From ecd52390da8deb4cf1dbc234feec3661cec6c971 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 02:48:48 +0530
Subject: [PATCH 142/314] feat(imaging): Run button on actionable imaging plan
 items
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a context-placed '▶ Run this imaging item' button to the plan-item
inspector (imaging + planned only). Routes through the agent
(AgentChat.runCommand) to execute_plan_item, which applies that item's
ImagingSpec and starts the timelapse — agent-first, so it stays in the loop
and can confirm/adjust. First slice of the multi-entry-point imaging
triggers (workspace 'embryos mounted' CTA + resolution-picker continuation
to follow).
---
 gently/ui/web/static/js/campaigns.js | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/gently/ui/web/static/js/campaigns.js b/gently/ui/web/static/js/campaigns.js
index 36d29623..da1bd515 100644
--- a/gently/ui/web/static/js/campaigns.js
+++ b/gently/ui/web/static/js/campaigns.js
@@ -117,6 +117,7 @@ function boot() {
             case 'select-item': selectItem(id); break;
             case 'open-campaign': openCampaign(id); break;
             case 'navigate-item': e.stopPropagation(); navigateToItem(id); break;
+            case 'run-item': e.stopPropagation(); runPlanItem(id); break;
             case 'filter-type': applyTypeFilter(el.dataset.filterType); break;
             case 'view-version': viewVersion(el.dataset.versionId, el.dataset.isCurrent === 'true'); break;
             case 'back-to-current': backToCurrent(); break;
@@ -639,6 +640,19 @@ function renderInspector(data) {
         <span class="detail-id">${item.id}</span>
     </div>`;
 
+    // Run affordance — only for an actionable imaging item. Routes through the
+    // agent (it applies this item's spec via execute_plan_item), in keeping with
+    // the agent-first paradigm.
+    if (item.type === 'imaging' && item.status === 'planned') {
+        html += `<div class="detail-actions" style="margin:4px 0 14px">
+            <button data-action="run-item" data-id="${item.id}"
+                style="background:var(--accent,#2f6df6);color:#fff;border:0;border-radius:9px;padding:9px 16px;font:inherit;font-size:13px;font-weight:600;cursor:pointer">
+                ▶ Run this imaging item
+            </button>
+            <span style="margin-left:10px;color:var(--text-muted,#94a3b8);font-size:12px">Hands it to the agent to apply the spec and start</span>
+        </div>`;
+    }
+
     // Description
     if (item.description) {
         html += section('Description', `<div class="detail-section-content">${esc(item.description)}</div>`);
@@ -727,6 +741,15 @@ function renderInspector(data) {
     if ($inspectorBody) $inspectorBody.innerHTML = html;
 }
 
+// Hand a planned imaging item to the agent to execute. The agent resolves the
+// item ref, applies its spec, and starts the timelapse (execute_plan_item). We
+// open the chat so the user sees it pick up and can confirm/adjust.
+function runPlanItem(id) {
+    if (typeof AgentChat === 'undefined' || !AgentChat.runCommand) return;
+    AgentChat.runCommand(`Start imaging for plan item ${id}`);
+    if (AgentChat.togglePanel) AgentChat.togglePanel(true);
+}
+
 function closeInspector() {
     state.selectedItemId = null;
     $workspace?.classList.remove('inspector-open');

From 6eac3e6ded9f8aa23ac123e7041dc4ab83fb13a3 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 03:05:58 +0530
Subject: [PATCH 143/314] deps: declare opencv-python-headless (cv2) as a
 runtime dependency
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

cv2 is imported unguarded by sam_detection, the device layer, analysis/steps,
and video_maker, but was never declared — so a clean install breaks detection/
analysis with 'No module named cv2'. headless avoids the libGL.so requirement
of full opencv-python on headless servers/agents.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 pyproject.toml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index d2a0c9a4..6f2408cd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -36,6 +36,11 @@ dependencies = [
     "tifffile>=2023.0.0",
     "scipy>=1.10.0",
     "scikit-image>=0.21.0",
+    # OpenCV is imported (unguarded) by detection (sam_detection), the device
+    # layer, analysis steps, and video_maker — so it's a true runtime dep, not
+    # optional. headless avoids the libGL.so requirement of full opencv-python
+    # on headless servers/agents.
+    "opencv-python-headless>=4.8.0",
     "jinja2>=3.1.0",
     "pyyaml>=6.0",
     "matplotlib>=3.7.0",

From 0d01229ef604e3bc1d87c335c005f5a5145a7a86 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 18:42:16 -0400
Subject: [PATCH 144/314] fix(dispim): correct stage-position read keys; bottom
 camera never uses LED

Two fixes from live testing on integration/ux2-all:

1. get_stage_position() in the client parsed the read_stage_plan event
   with a stale key list (["XY:31", "xy_stage", "stage"]) that never
   matched the device's actual key ("XYStage:XY:31"/"xy_stage_position"),
   so every read raised "Failed to read stage position" (also broke
   view_image, which reads the stage). Align the key list with the one
   the device layer's own handle_detect_embryos already uses.

2. The bottom camera no longer drives the LED at all. trigger() ignores
   the persistent use_led flag and captures under room light only, so no
   caller (manual marking, detection, live preview) can flash the LED.
   capture_for_marking no longer requests use_led=True, and
   handle_detect_embryos turns the room light on before capturing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/client.py         | 17 ++++++++++--
 gently/hardware/dispim/device_layer.py   | 35 ++++++++++++++++++++++++
 gently/hardware/dispim/devices/camera.py | 33 ++++++----------------
 3 files changed, 58 insertions(+), 27 deletions(-)

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 2e4567e1..56a9a33c 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -374,8 +374,18 @@ async def get_stage_position(self) -> tuple[float, float]:
             events = docs.get("events", [])
             if events:
                 data = events[0].get("data", {})
-                # Look for stage coordinates
-                for key in ["XY:31", "xy_stage", "stage"]:
+                # Look for stage coordinates. Keys must match what
+                # read_stage_plan (bp.count on the xy_stage device) actually
+                # emits — the device-layer's own handle_detect_embryos uses
+                # "XYStage:XY:31"/"xy_stage_position", so include those here too
+                # (the bare "XY:31" was stale and never matched).
+                for key in [
+                    "xy_stage",
+                    "XYStage:XY:31",
+                    "xy_stage_position",
+                    "XY:31",
+                    "stage",
+                ]:
                     if key in data:
                         val = data[key]
                         if isinstance(val, (list, tuple)) and len(val) >= 2:
@@ -1244,7 +1254,8 @@ async def capture_for_marking(
         self._ensure_connected()
 
         try:
-            snap = await self.capture_bottom_image(use_led=True, exposure_ms=exposure_ms)
+            # No LED ever — the bottom camera images under room light only.
+            snap = await self.capture_bottom_image(use_led=False, exposure_ms=exposure_ms)
             image = snap["image"]
 
             if image is None or (image.shape == (100, 100) and image.max() == 0):
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 6d606621..55e8225d 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -1428,6 +1428,26 @@ def _room_light_device(self):
                 return dev
         return None
 
+    async def _set_room_light(self, state: str) -> bool:
+        """Drive the room-light SwitchBot to ``state`` ('on'/'off'/'press').
+
+        Blocks until the BLE command lands (or times out). Returns True on
+        success, False if no bot is configured or the command failed. Shared
+        by the HTTP handler and internal callers (e.g. detect_embryos, which
+        images under room light rather than the camera LED).
+        """
+        bot = self._room_light_device()
+        if bot is None:
+            return False
+        import time
+
+        status = bot.set(state)
+        timeout = float(getattr(bot, "timeout", 20.0)) + 5
+        start = time.time()
+        while not status.done and (time.time() - start) < timeout:
+            await asyncio.sleep(0.1)
+        return bool(status.done and status.success)
+
     async def handle_get_room_light_status(self, request):
         """GET /api/room_light/status - cached on/off state of the room light.
 
@@ -1931,6 +1951,21 @@ async def handle_detect_embryos(self, request):
                 if bottom_camera:
                     bottom_camera.configure_exposure(exposure_ms)
 
+            # Detection always images under ROOM LIGHT, never the camera LED.
+            # use_led is a persistent device flag that other flows (e.g. manual
+            # marking via capture_for_marking) leave switched on, so force it
+            # off here and turn the room light on so there's illumination.
+            bottom_camera = self.devices.get("bottom_camera")
+            if bottom_camera is not None:
+                bottom_camera.use_led = False
+            if await self._set_room_light("on"):
+                logger.info("[detect_embryos] Room light ON, camera LED disabled")
+            else:
+                logger.warning(
+                    "[detect_embryos] Could not turn room light on "
+                    "(no SwitchBot configured?) — capturing under ambient light"
+                )
+
             # Capture image via plan
             logger.info("[detect_embryos] Capturing bottom camera image...")
             capture_result = await self.submit_plan(
diff --git a/gently/hardware/dispim/devices/camera.py b/gently/hardware/dispim/devices/camera.py
index 5141d6d4..505dcf3b 100644
--- a/gently/hardware/dispim/devices/camera.py
+++ b/gently/hardware/dispim/devices/camera.py
@@ -388,7 +388,9 @@ def __init__(
         self.pixel_size_um = pixel_size_um
         self.magnification = magnification
         self.effective_pixel_size = pixel_size_um / magnification
-        self.use_led = False  # Set to True to enable automatic LED control
+        # Retained for API compatibility but ignored: the bottom camera never
+        # drives the LED (see trigger()). Imaging uses room light only.
+        self.use_led = False
 
     def pixel_to_um(self, pixels: float) -> float:
         """
@@ -408,14 +410,12 @@ def pixel_to_um(self, pixels: float) -> float:
 
     def trigger(self):
         """
-        Trigger image acquisition with optional LED management.
+        Trigger image acquisition.
 
-        Overrides parent trigger() to add LED control (if use_led=True):
-        1. Turn LED on (if use_led=True)
-        2. Capture image
-        3. Turn LED off (if use_led=True, always even on error)
-
-        Set self.use_led = False to capture without LED (ambient light only).
+        The bottom camera NEVER drives the LED — imaging is done under room
+        light only. The ``use_led`` flag is retained for API compatibility but
+        is intentionally ignored here so that no caller (manual marking,
+        detection, live preview, …) can ever flash the LED.
 
         Returns
         -------
@@ -426,28 +426,13 @@ def trigger(self):
 
         def wait():
             try:
-                # Turn LED on for transmitted light imaging (if enabled)
-                if self.use_led:
-                    self.led_control.set("Open").wait(timeout=5)
-                    time.sleep(0.1)  # Allow LED to stabilize
-
-                # Capture image
+                # LED is never used — capture under ambient/room light only.
                 self._ensure_active()
                 self.core.snapImage()
                 self._last_image = _safe_obtain(self.core.getImage())
                 self._last_image_time = time.time()
 
-                # Turn LED off (if enabled - important to prevent sample heating!)
-                if self.use_led:
-                    self.led_control.set("Closed").wait(timeout=5)
-
             except Exception as exc:
-                # Critical: always turn off LED even on error (if enabled)
-                if self.use_led:
-                    try:
-                        self.led_control.set("Closed").wait(timeout=5)
-                    except Exception:
-                        pass
                 status.set_exception(exc)
             else:
                 status.set_finished()

From 9abcf6e608a1c03a943263cde75e7ce236930787 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 18:42:17 -0400
Subject: [PATCH 145/314] chore(deps): lock opencv-python-headless (uv.lock
 sync)

Regenerate uv.lock for the opencv-python-headless runtime dep declared in
pyproject (6eac3e6d).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 uv.lock | 558 ++++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 457 insertions(+), 101 deletions(-)

diff --git a/uv.lock b/uv.lock
index 60a87123..56e9f456 100644
--- a/uv.lock
+++ b/uv.lock
@@ -2,15 +2,15 @@ version = 1
 revision = 3
 requires-python = ">=3.10, <3.13"
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 conflicts = [[
     { package = "gently", extra = "torch-cpu" },
@@ -159,6 +159,30 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
 ]
 
+[[package]]
+name = "ast-serialize"
+version = "0.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/81/9d/09e27731bd5864a9ce04e3244074e674bb8936bf62b45e0357248717adac/ast_serialize-0.5.0.tar.gz", hash = "sha256:5880091bfe6f4f986f22866375c2e884843e7a0b6343ae41aeea659613d879b6", size = 61157, upload-time = "2026-05-17T17:48:29.429Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/9e/dc2530acb3a60dc6e46d65abf27d1d9f86721694757906a148d90a6860de/ast_serialize-0.5.0-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:0668aa9459cfa8c9c49ddd2163ebcf43088ba045ef7492af6fe22e0098303101", size = 1191380, upload-time = "2026-05-17T17:48:03.738Z" },
+    { url = "https://files.pythonhosted.org/packages/26/0a/bd3d18a582f273d6c843d16bb9e22e9e16365ff7991e92f18f798e9f1224/ast_serialize-0.5.0-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:bf683d6363edf2b39eed6b6d4fe22d34b6203867a67e27134d9e2a2680c4bc4a", size = 1183879, upload-time = "2026-05-17T17:48:05.463Z" },
+    { url = "https://files.pythonhosted.org/packages/40/ae/1f919100f8620887af58fcc381c61a1f218cdf89c6e155f87b213e61010a/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9cc22cf0c9be65e71cf88fda130af60d61eb4a79370ad4cfe7900d48a4aa2211", size = 1244529, upload-time = "2026-05-17T17:48:07.008Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/ca/6376559dcce707cdbc1d0d9a13c8d3baaaa501e949ce0ebdc4230cd881aa/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f66173891548c9f2726bf27957b41cabce12fa679dc6da505ddbde4d4b3b31cf", size = 1240560, upload-time = "2026-05-17T17:48:08.46Z" },
+    { url = "https://files.pythonhosted.org/packages/35/b2/a620e206b5aeb7efbf2710336df57d457cffbb3991076bbcc1147ef9abd4/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e42d729ef2be96a14efbad355093284739e3670ece3e534f82cc8832790911d9", size = 1451172, upload-time = "2026-05-17T17:48:09.922Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/e0/4ad5c04c24a40481b2935ce9a0ccdb6023dc8b667167d06ae530cc3512f2/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b725026bafa801dbd7310eb13a75f0a2e370e7e51b2cb225f9d21fcfadf919ee", size = 1265072, upload-time = "2026-05-17T17:48:11.469Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/71/4d1d479aa56d0101c40e17720c3d6ac2af7269ea0487a80b18e7bfd1a5b7/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b54f60c1d78767a53b67eaa663f0dfac3afe606aa07f1301572f588b73d64809", size = 1270488, upload-time = "2026-05-17T17:48:13.575Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/4f/0de1bbe06f6edef9fde4ed12ca8e7b3ec7e6e2bd4e672c5af487f7957665/ast_serialize-0.5.0-cp39-abi3-manylinux_2_31_riscv64.whl", hash = "sha256:27d51654fc240a1e87e742d353d98eb45b75f62f129086b3596ab53df2ac2a43", size = 1260702, upload-time = "2026-05-17T17:48:15.141Z" },
+    { url = "https://files.pythonhosted.org/packages/75/61/e00872439cfdddcc3c1b6cdaa6e5d904ba8e26a18807c67c4e14409d0ca8/ast_serialize-0.5.0-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c36237c46dd1674542f2109740ea5ea485a169bf1431939ada0434e17934", size = 1311182, upload-time = "2026-05-17T17:48:16.779Z" },
+    { url = "https://files.pythonhosted.org/packages/76/8e/699a5b955f7926956c95e9e1d74132acad73c2fe7a426f94da89123c20aa/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:1943db345233cc7194a470f13afa9c59772c0b123dea0c9414c4d4ca54369759", size = 1421410, upload-time = "2026-05-17T17:48:18.527Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/ae/d5b7626874478997adc7a29ab28accf21e596fb590c944290401dfd0b29e/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:df1c00022cbbcb064bfaa505aa9c9295362443ce5dacb459d1331d3da353f887", size = 1516587, upload-time = "2026-05-17T17:48:20.133Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/ce/b59e02a82d9c4244d64cde502e0b00e83e38816abe19155ceb5437402c7f/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:cae65289fc456fde04af979a2be09302ef5d8ab92ef23e596d6746dc267ada27", size = 1515171, upload-time = "2026-05-17T17:48:21.921Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/38/d8d90042747d05aa08d4efcf1c99035a5f670a6bf4c214d31644392afbca/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:239a4c354e8d676e9d94631d1d4a64edc6b266f86ff3a5a80aedd344f342c01d", size = 1464668, upload-time = "2026-05-17T17:48:23.544Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/51/5b840c4df7334104cecffa28f23904fe81ca89ca223d2450e288de39fd3c/ast_serialize-0.5.0-cp39-abi3-win32.whl", hash = "sha256:143a4ef63285a075871908fda3672dc21864b83a8ec3ee12304aa3e4c5387b9a", size = 1068311, upload-time = "2026-05-17T17:48:25.027Z" },
+    { url = "https://files.pythonhosted.org/packages/41/11/ca5672c7d491825bc4cd6702dea106a6b60d928707712ec257c7833ae476/ast_serialize-0.5.0-cp39-abi3-win_amd64.whl", hash = "sha256:cf25572c526add400f26a4750dc6ce0c3bb93fc1f75e7ae0cad4ce4f2cd5c590", size = 1108931, upload-time = "2026-05-17T17:48:26.591Z" },
+    { url = "https://files.pythonhosted.org/packages/45/19/cc8bd127d28a43da249aa955cfd164cf8fd534e79e42cea96c4854d72fd0/ast_serialize-0.5.0-cp39-abi3-win_arm64.whl", hash = "sha256:92a31c9c20d25a076edaeec76b128a3535d74a24f340b9a8a7e96c9b86dc9642", size = 1081181, upload-time = "2026-05-17T17:48:28.122Z" },
+]
+
 [[package]]
 name = "async-timeout"
 version = "5.0.1"
@@ -242,6 +266,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/59/8c/57e832b7af6d7c5abe66eb3fbe3a3a32f4d11ea23a1aa7131371035be991/certifi-2026.5.20-py3-none-any.whl", hash = "sha256:3c52e209ba0a4ad7aebe60436a4ab349c39e1e602e8c134221e546902ad25897", size = 134134, upload-time = "2026-05-20T11:46:48.578Z" },
 ]
 
+[[package]]
+name = "cfgv"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4e/b5/721b8799b04bf9afe054a3899c6cf4e880fcf8563cc71c15610242490a0c/cfgv-3.5.0.tar.gz", hash = "sha256:d5b1034354820651caa73ede66a6294d6e95c1b00acc5e9b098e917404669132", size = 7334, upload-time = "2025-11-19T20:55:51.612Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/3c/33bac158f8ab7f89b2e59426d5fe2e4f63f7ed25df84c036890172b412b5/cfgv-3.5.0-py2.py3-none-any.whl", hash = "sha256:a8dc6b26ad22ff227d2634a65cb388215ce6cc96bbcc5cfde7641ae87e8dacc0", size = 7445, upload-time = "2025-11-19T20:55:50.744Z" },
+]
+
 [[package]]
 name = "click"
 version = "8.4.1"
@@ -268,10 +301,9 @@ name = "contourpy"
 version = "1.3.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -321,11 +353,12 @@ name = "contourpy"
 version = "1.3.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -399,6 +432,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c5/f8/1070ab5973dda406f735f6f73a4bc50debf7c43301f5e113fd3657bfca58/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a8b2c92f82af04d59c50cbccf65f995fa2e321ce7850e3c1b613e94680a8044e", size = 860033, upload-time = "2026-05-27T19:27:55.167Z" },
 ]
 
+[[package]]
+name = "distlib"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/02/bd72be9134d25ed783ecbbc38a539ffaefbf90c78418c7fb7229600dbac7/distlib-0.4.3.tar.gz", hash = "sha256:f152097224a0ae24be5a0f6bae1b9359af82133bce63f98a95f86cae1aede9ed", size = 615141, upload-time = "2026-06-12T08:04:52.847Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/02/08/9c41fb51ab5b43eb21674aff13df270e8ba6c4b29c8624e328dc7a9482af/distlib-0.4.3-py2.py3-none-any.whl", hash = "sha256:4b0ce306c966eb73bc3a7b6abad017c556dadd92c44701562cd528ac7fde4d5b", size = 470628, upload-time = "2026-06-12T08:04:50.506Z" },
+]
+
 [[package]]
 name = "distro"
 version = "1.9.0"
@@ -605,6 +647,7 @@ dependencies = [
     { name = "jinja2" },
     { name = "matplotlib" },
     { name = "numpy" },
+    { name = "opencv-python-headless" },
     { name = "ophyd" },
     { name = "pillow" },
     { name = "pymmcore" },
@@ -642,8 +685,11 @@ torch-gpu = [
 
 [package.dev-dependencies]
 dev = [
+    { name = "mypy" },
+    { name = "pre-commit" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
+    { name = "ruff" },
 ]
 
 [package.metadata]
@@ -658,6 +704,7 @@ requires-dist = [
     { name = "matplotlib", specifier = ">=3.7.0" },
     { name = "numpy", specifier = ">=1.24.0,<2" },
     { name = "nvidia-ml-py", marker = "extra == 'torch-gpu'", specifier = ">=12.0.0" },
+    { name = "opencv-python-headless", specifier = ">=4.8.0" },
     { name = "ophyd", specifier = ">=1.9.0" },
     { name = "paho-mqtt", marker = "extra == 'device'", specifier = ">=1.6.0" },
     { name = "pillow", specifier = ">=10.0.0" },
@@ -679,8 +726,11 @@ provides-extras = ["sam", "torch-gpu", "torch-cpu", "device"]
 
 [package.metadata.requires-dev]
 dev = [
+    { name = "mypy", specifier = "==2.1.0" },
+    { name = "pre-commit", specifier = ">=3.7.0" },
     { name = "pytest", specifier = ">=7.0.0" },
     { name = "pytest-asyncio", specifier = ">=0.21.0" },
+    { name = "ruff", specifier = ">=0.4.0" },
 ]
 
 [[package]]
@@ -689,20 +739,62 @@ version = "0.1.0"
 source = { editable = "../gently-perception" }
 dependencies = [
     { name = "anthropic" },
+    { name = "moderngl" },
     { name = "numpy" },
     { name = "pillow" },
+    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 
 [package.metadata]
 requires-dist = [
     { name = "anthropic", specifier = ">=0.40.0" },
     { name = "matplotlib", marker = "extra == 'benchmark'", specifier = ">=3.7.0" },
+    { name = "moderngl", specifier = ">=5.10" },
     { name = "numpy", specifier = ">=1.24.0" },
     { name = "pillow", specifier = ">=10.0.0" },
+    { name = "scipy", specifier = ">=1.10" },
     { name = "tifffile", marker = "extra == 'benchmark'", specifier = ">=2024.1.30" },
 ]
 provides-extras = ["benchmark"]
 
+[[package]]
+name = "glcontext"
+version = "3.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3a/80/8238a0e6e972292061176141c1028b5e670aa8c94cf4c2f819bd730d314e/glcontext-3.0.0.tar.gz", hash = "sha256:57168edcd38df2fc0d70c318edf6f7e59091fba1cd3dadb289d0aa50449211ef", size = 16422, upload-time = "2024-08-10T20:01:20.004Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6a/44/f605689047cca15d5e5d31c0a4b9ca87dd1d52bfabf3c3a05d70a4636c08/glcontext-3.0.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b154c25a57e16dbb073478d0cbe2c0090649d135c4c9f87e753b6181b97ec848", size = 9329, upload-time = "2024-08-10T19:59:49.485Z" },
+    { url = "https://files.pythonhosted.org/packages/10/fd/461c9e37ad50514dac82fda04a7a0aabb1a5e6b0f76476538caa4e74a25a/glcontext-3.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:fa5a14778d13ecf4a0dd60a7825427bf6ac0383eacb3b8b1a9c23e4976aa0c8c", size = 9735, upload-time = "2024-08-10T19:59:51.329Z" },
+    { url = "https://files.pythonhosted.org/packages/db/86/c879bf61d4f52d8b0cd702db5f7180b5eae8804d29a798de8da0568a64b2/glcontext-3.0.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7c229290a3a33004a59799b94a50bc5e6f8addd1b5bc5039ef9e78f86d888b31", size = 50476, upload-time = "2024-08-10T19:59:52.854Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/c4/8b45b1c910f4a9b4df1ee3449b4c1aaa798fc25d86390e8eb2a18bc59669/glcontext-3.0.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1445a03d8795113034e1f9ffa662f795df65ae69ee21b26ed3b1d66100ba3f8c", size = 51480, upload-time = "2024-08-10T19:59:54.149Z" },
+    { url = "https://files.pythonhosted.org/packages/91/00/159f7df65554f30e0cc6f7fb78869e95717ed5319729f386dcc81ae9ee3d/glcontext-3.0.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:09247011c09c37b8d30eca9aa24659288de2febaeaa6a817b33b1498b5ef164c", size = 44902, upload-time = "2024-08-10T19:59:55.268Z" },
+    { url = "https://files.pythonhosted.org/packages/91/85/21d2b619576690d48e4967dce37fabe616aeee06b7c6a6c6ceb48d99d3ef/glcontext-3.0.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:c8c1223f1cbcfc0b88428e1717baca829ee863ed5d88e9b5574c7ed6598249cd", size = 47035, upload-time = "2024-08-10T20:00:03.972Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/99/6c200c6d16b55d19dfd13bfed1ed5794e17e49ea8ccf9e4fab52e2d0e2d0/glcontext-3.0.0-cp310-cp310-win32.whl", hash = "sha256:c13dedb3636328b133c4d53c047ce69040ae784095e8f239432ad74d6f921712", size = 12218, upload-time = "2024-08-10T20:00:06.285Z" },
+    { url = "https://files.pythonhosted.org/packages/93/36/8a8f25366ab80dc4e6c9ded7b21f11152bba65fd6b8c0f28641ef3e133f5/glcontext-3.0.0-cp310-cp310-win_amd64.whl", hash = "sha256:4817f4cd52c7fe5410c92ca12b6712435548918719373882ade76f8f75d80abd", size = 12973, upload-time = "2024-08-10T20:00:07.733Z" },
+    { url = "https://files.pythonhosted.org/packages/01/36/3d0d09f7352b179a7ecc5fc3322beb85c8995c66db780acf791853e49043/glcontext-3.0.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3a9e56fa3597cc709cfd0fdf2ae682cda36510a13faac2b3142f401e823b64f4", size = 9328, upload-time = "2024-08-10T20:00:09.43Z" },
+    { url = "https://files.pythonhosted.org/packages/44/9d/0c8fd9c660db000071ebace14a40bd381a41775c10faa262fedfae8227e3/glcontext-3.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a0484308af75e04b0e56066dc2324a8fb9f1443b76ddb98833439982322b2a39", size = 9738, upload-time = "2024-08-10T20:00:10.831Z" },
+    { url = "https://files.pythonhosted.org/packages/78/cf/7bcadb995830cdd6a1a31f0527a52b2c441a499feabed9749106f7e41e67/glcontext-3.0.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:983231394396aa2a1e2b96df49404cc8f8aa729d462ed40e605a74b079c46342", size = 50663, upload-time = "2024-08-10T20:00:12.301Z" },
+    { url = "https://files.pythonhosted.org/packages/43/fb/646c2773cb097b914afe1f06c95e65deb8a544d770389bf29c76a8f3a8fd/glcontext-3.0.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7fa413f4420abff2bbb5aa5770a3e1deffcdc13e0ef2f459b145fa79c36909e7", size = 51680, upload-time = "2024-08-10T20:00:13.646Z" },
+    { url = "https://files.pythonhosted.org/packages/89/b7/04aac6c50071b858cfd02a9bccafb42a21f567992fa448c8ad8aa62939b9/glcontext-3.0.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:7d0ac35ac07fc91eccea093beb9d1c1a4eae250bc33836047deff01a3b5f4757", size = 45063, upload-time = "2024-08-10T20:00:15.137Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/6e/6e398492b55f3c453cc6a2ecc2886a01b2a465623aa0c476d3e115be85c4/glcontext-3.0.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7145d17a70adc5784ca59ebbe19a56435ba21816070b8b433f43aa2dfb8be71a", size = 47281, upload-time = "2024-08-10T20:00:16.679Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/fd/4f59118e5067a3c88217862d8672463aff29f29c1ea9f47971f8ca67e83c/glcontext-3.0.0-cp311-cp311-win32.whl", hash = "sha256:b31808ca2517fedcac8ca5b296ff46c8af012911eaa2080889a1f244d329ef9a", size = 12222, upload-time = "2024-08-10T20:00:18.108Z" },
+    { url = "https://files.pythonhosted.org/packages/20/1b/f402574ae4644e7fb389b9534de9d1be575b8a4da901a9023d1cec72c4aa/glcontext-3.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:ef4b4ec35e2b720f4cd250bb92cf6417add445490bf780345596da5a796a0e6f", size = 12975, upload-time = "2024-08-10T20:00:19.236Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/61/d8f77d44bbf477b235ecbff8d421a5511d4b4f6dc676dacd84d012348516/glcontext-3.0.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:848f870a2bc72a29de7ab6756b9e8f2e6ce052e17873ebc6b3f25129b6e0d58a", size = 9360, upload-time = "2024-08-10T20:00:20.42Z" },
+    { url = "https://files.pythonhosted.org/packages/de/46/680a97d974cfe7af798542918b65bd8e65a5f8f7647edfd9fdb91a95df6c/glcontext-3.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4b3b12a66f57379566dd4d36899ac265abdbe040f3fc3293f50cd6678a1dcc9b", size = 9733, upload-time = "2024-08-10T20:00:21.624Z" },
+    { url = "https://files.pythonhosted.org/packages/74/2c/be188c4eb63b4d0cc74c644a1519b5e3a37488da3cbda724570cd5fed8d3/glcontext-3.0.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:449eaefd89c0519900715b8363ead59ac4aa32457722ca521ce01297441edb34", size = 50409, upload-time = "2024-08-10T20:00:22.827Z" },
+    { url = "https://files.pythonhosted.org/packages/32/ba/9ccb80650e5bd61e739f16f33aec3bb290a80f314631be8f7dc0a2b22b5f/glcontext-3.0.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:04921720740438ceea8fb8a38b5665963520c7c8f27bef03df8aeb3ea3cfbfb6", size = 51440, upload-time = "2024-08-10T20:00:23.987Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/99/f6c9a0e614809ba5b83bd8403c475b788bd574d694bd5bc6b6ae2e2cefdf/glcontext-3.0.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:25538bdb106f673638d70e8a16a0c037a92a24c4cf40a05f0d3fa14b483d6194", size = 44820, upload-time = "2024-08-10T20:00:25.436Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/29/fdbb94e4c9374390639b741774384f7413efcd7634cc9c4baacc2cf00a1f/glcontext-3.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:d11f7701b900a5a34c994e1d91c547be1cc469b73f881471460fd905f69f9e4c", size = 47055, upload-time = "2024-08-10T20:00:26.723Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/fe/25b5348fe5e856697dacad34fc07e80f48eecfb38bd09806679fe0e62769/glcontext-3.0.0-cp312-cp312-win32.whl", hash = "sha256:5d2b567eaf34adb016aadce81fd2f1d4c8e4a39e3d6f2a395ce528e2a350dd3f", size = 12219, upload-time = "2024-08-10T20:00:27.76Z" },
+    { url = "https://files.pythonhosted.org/packages/17/d3/6619693ddad97011ca1c9aaeb82216ab2bfd54757be752b12f4e9a2fc489/glcontext-3.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:e80bb37ba727bd20c192f2754aea40c437a7665005c1001c10752f91913964e9", size = 12971, upload-time = "2024-08-10T20:00:29.575Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/84/8f6ca5b8005ec58adbf51e2e6c3b5a20f234ea8f7a2e1df52835c9b23274/glcontext-3.0.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:f4e285e5d40e7a9bafeb0651c3d8f1a7c822525dec7091e97109ba87a70dbd1e", size = 9272, upload-time = "2024-08-10T20:01:00.133Z" },
+    { url = "https://files.pythonhosted.org/packages/39/a2/a0d1e7492f14727682820120062717a118f0196cda8cf6c1a6e6c4ab6d12/glcontext-3.0.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:96d1bbe62c5bc5315ca2f84a2abae6fa7b7d645dd368415a0cd1ee5ba6f3f8f7", size = 9581, upload-time = "2024-08-10T20:01:01.098Z" },
+    { url = "https://files.pythonhosted.org/packages/07/ba/2f093542218c9c38b293df0f501509fdfeb5dad975135a5467431aa9a774/glcontext-3.0.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3a190b1cdb39110c7b56c33857dbff493a364633bfd0ff402a1ce205956c94ca", size = 17842, upload-time = "2024-08-10T20:01:02.308Z" },
+    { url = "https://files.pythonhosted.org/packages/01/e5/5209be64858f9d7f9861f03ed5662491642d8d31b51a6a8495f084869386/glcontext-3.0.0-pp310-pypy310_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d467cce2dac8c3928847e90310eb6bdfdfa69f8df39b76a74734046faa15e688", size = 17226, upload-time = "2024-08-10T20:01:03.362Z" },
+    { url = "https://files.pythonhosted.org/packages/06/cb/0995eef99e56394b93bea3aa20bc269ae09125b66c0b7c1e3338f44c93cb/glcontext-3.0.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:2b0c5240125d75498a8f14596484233e4effe98a6a035f566872dd2fdf472ceb", size = 12988, upload-time = "2024-08-10T20:01:04.728Z" },
+]
+
 [[package]]
 name = "h11"
 version = "0.16.0"
@@ -778,6 +870,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
 ]
 
+[[package]]
+name = "identify"
+version = "2.6.19"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/52/63/51723b5f116cc04b061cb6f5a561790abf249d25931d515cd375e063e0f4/identify-2.6.19.tar.gz", hash = "sha256:6be5020c38fcb07da56c53733538a3081ea5aa70d36a156f83044bfbf9173842", size = 99567, upload-time = "2026-04-17T18:39:50.265Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/84/d9273cd09688070a6523c4aee4663a8538721b2b755c4962aafae0011e72/identify-2.6.19-py2.py3-none-any.whl", hash = "sha256:20e6a87f786f768c092a721ad107fc9df0eb89347be9396cadf3f4abbd1fb78a", size = 99397, upload-time = "2026-04-17T18:39:49.221Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.17"
@@ -992,6 +1093,52 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/8a/a1/8d812e53a5da1687abb10445275d41a8b13adb781bbf7196ddbcf8d88505/lazy_loader-0.5-py3-none-any.whl", hash = "sha256:ab0ea149e9c554d4ffeeb21105ac60bed7f3b4fd69b1d2360a4add51b170b005", size = 8044, upload-time = "2026-03-06T15:45:07.668Z" },
 ]
 
+[[package]]
+name = "librt"
+version = "0.11.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/40/08/9e7f6b5d2b5bed6ad055cdd5925f192bb403a51280f86b56554d9d0699a2/librt-0.11.0.tar.gz", hash = "sha256:075dc3ef4458a278e0195cbf6ac9d38808d9b906c5a6c7f7f79c3888276a3fb1", size = 200139, upload-time = "2026-05-10T18:17:25.138Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/83/10/37fd9e9ba96cb0bd742dfb20fc3d082e54bdbec759d7300df927f360ef07/librt-0.11.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:6e94ebfcfa2d5e9926d6c3b9aa4617ffc42a845b4321fb84021b872358c82a0f", size = 141706, upload-time = "2026-05-10T18:15:16.129Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/72/1b1466f358e4a0b728051f69bc27e67b432c6eaa2e05b88db49d3785ae0d/librt-0.11.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ae627397a2f351560440d872d6f7c8dbb4072e57868e7b2fc5b8b430fe489d45", size = 142605, upload-time = "2026-05-10T18:15:18.148Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/85/ed26dd2f6bc9a0baf48306433e579e8d354d70b2bcb78134ed950a5d0e1e/librt-0.11.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dc329359321b67d24efdf4bc69012b0597001649544db662c001db5a0184794c", size = 476555, upload-time = "2026-05-10T18:15:19.569Z" },
+    { url = "https://files.pythonhosted.org/packages/66/fe/11891191c0e0a3fd617724e891f6e67a71a7658974a892b9a9a97fdb2977/librt-0.11.0-cp310-cp310-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:7e82e642ab0f7608ce2fe53d76ca2280a9ee33a1b06556142c7c6fe80a86fc33", size = 468434, upload-time = "2026-05-10T18:15:20.87Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/50/5ec949d7f9ce1a07af903aa3e13abb98b717923bdead6e719b2f824ccc07/librt-0.11.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:88145c15c67731d54283d135b03244028c750cc9edc334a96a4f5950ebdb2884", size = 496918, upload-time = "2026-05-10T18:15:22.616Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/c4/177336c7524e34875a38bf668e88b193a6723a4eb4045d07f74df6e1506c/librt-0.11.0-cp310-cp310-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9d36a51b3d93320b686588e27123f4995804dbf1bce81df78c02fc3c6eea9280", size = 490334, upload-time = "2026-05-10T18:15:24.2Z" },
+    { url = "https://files.pythonhosted.org/packages/13/1f/da3112f7569eda3b49f9a2629bae1fe059812b6085df16c885f6454dff49/librt-0.11.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:d00f3ac06a2a8b246327f11e186a53a100a4d5c7ed52346367e5ec751d51586c", size = 511287, upload-time = "2026-05-10T18:15:26.226Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/94/03fec301522e172d105581431223be56b27594ff46440ebfbb658a3735d5/librt-0.11.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:461bbceede621f1ffb8839755f8663e886087ee7af16294cab7fb4d782c62eeb", size = 517202, upload-time = "2026-05-10T18:15:27.965Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/6e/339f6e5a7b413ce014f1917a756dae630fe59cc99f34153205b1cb540901/librt-0.11.0-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:0cad8a4d6a8ff03c9b76f9414caccd78e7cfbc8a2e12fa334d8e1d9932753783", size = 497517, upload-time = "2026-05-10T18:15:29.614Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/43/acdd5ce317cb46e8253ca9bfbdb8b12e68a24d745949336a7f3d5fb79ba0/librt-0.11.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:f37aa505b3cf60701562eddb32df74b12a9e380c207fd8b06dd157a943ac7ea0", size = 538878, upload-time = "2026-05-10T18:15:30.928Z" },
+    { url = "https://files.pythonhosted.org/packages/29/b5/7a25bb12e3172839f647f196b3e988318b7bb1ca7501732a225c4dce2ec0/librt-0.11.0-cp310-cp310-win32.whl", hash = "sha256:94663a21534637f0e787ec2a2a756022df6e5b7b2335a5cdd7d8e33d68a2af89", size = 100070, upload-time = "2026-05-10T18:15:32.551Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/0d/ebbcf4d77999c02c937b05d2b90ff4cd4dcc7e9a365ba132329ac1fe7a0f/librt-0.11.0-cp310-cp310-win_amd64.whl", hash = "sha256:dec7db73758c2b54953fd8b7fe348c45188fe26b39ee18446196edd08453a5d4", size = 117918, upload-time = "2026-05-10T18:15:33.678Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/87/2bf31fe17587b29e3f93ec31421e2b1e1c3e349b8bf6c7c313dbad1d5340/librt-0.11.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:93d95bd45b7d58343d8b90d904450a545144eec19a002511163426f8ab1fae29", size = 141092, upload-time = "2026-05-10T18:15:34.795Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/08/5c5bf772920b7ebac6e32bc91a643e0ab3870199c0b542356d3baa83970a/librt-0.11.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ee278c769a713638cdacd4c0436d72156e75df3ebc0166ab2b9dc43acc386c9", size = 142035, upload-time = "2026-05-10T18:15:36.242Z" },
+    { url = "https://files.pythonhosted.org/packages/06/20/662a03d254e5b000d838e8b345d83303ddb768c080fd488e40634c0fa66b/librt-0.11.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f230cb1cbc9faaa616f9a678f530ebcf186e414b6bcbd88b960e4ba1b92428d5", size = 475022, upload-time = "2026-05-10T18:15:37.56Z" },
+    { url = "https://files.pythonhosted.org/packages/de/f3/aa81523e45184c6ec23dc7f63263362ec55f80a09d424c012359ecbe7e35/librt-0.11.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:5d63c855d86938d9de93e265c9bd8c705b51ec494de5738340ee93767a686e4b", size = 467273, upload-time = "2026-05-10T18:15:39.182Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/6f/59c74b560ca8853834d5501d589c8a2519f4184f273a085ffd0f37a1cc47/librt-0.11.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:993f028be9e96a08d31df3479ac80d99be374d17f3b78e4796b3fd3c913d4e89", size = 497083, upload-time = "2026-05-10T18:15:40.634Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/7b/5aa4d2c9600a719401160bf7055417df0b2a47439b9d88286ce45e56b65f/librt-0.11.0-cp311-cp311-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:258d73a0aa66a055e65b2e4d1b8cdb23b9d132c5bb915d9547d804fcaed116cc", size = 489139, upload-time = "2026-05-10T18:15:41.934Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/31/9143803d7da6856a69153785768c4936864430eec0fd9461c3ea527d9922/librt-0.11.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:0827efe7854718f04aaddf6496e96960a956e676fe1d0f04eb41511fd8ad06d5", size = 508442, upload-time = "2026-05-10T18:15:43.206Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/5a/bce08184488426bda4ccc2c4964ac048c8f68ae89bd7120082eef4233cfd/librt-0.11.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:7753e57d6e12d019c0d8786f1c09c709f4c3fcc57c3887b24e36e6c06ec938b7", size = 514230, upload-time = "2026-05-10T18:15:44.761Z" },
+    { url = "https://files.pythonhosted.org/packages/89/8c/bb5e213d254b7505a0e658da199d8ab719086632ce09eef311ab27976523/librt-0.11.0-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:11bd19822431cc21af9f27374e7ae2e58103c7d98bda823536a6c47f6bb2bb3d", size = 494231, upload-time = "2026-05-10T18:15:46.308Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/fb/541cdad5b1ab1300398c74c4c9a497b88e5074c21b1244c8f49731d3a284/librt-0.11.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:22bdf239b219d3993761a148ffa134b19e52e9989c84f845d5d7b71d70a17412", size = 537585, upload-time = "2026-05-10T18:15:47.629Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/f2/464bb69295c320cb06bddb4f14a4ec67934ee14b2bffb12b19fb7ab287ba/librt-0.11.0-cp311-cp311-win32.whl", hash = "sha256:46c60b61e308eb535fbd6fa622b1ee1bb2815691c1ad9c98bf7b84952ec3bc8d", size = 100509, upload-time = "2026-05-10T18:15:49.157Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/e7/a17ee1788f9e4fbf548c19f4afa07c92089b9e24fef6cb2410863781ef4c/librt-0.11.0-cp311-cp311-win_amd64.whl", hash = "sha256:902e546ff044f579ff1c953ff5fce97b636fe9e3943996b2177710c6ef076f73", size = 118628, upload-time = "2026-05-10T18:15:50.345Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/c7/6c766214f9f9903bcfcfbef97d807af8d8f5aa3502d247858ab17582d212/librt-0.11.0-cp311-cp311-win_arm64.whl", hash = "sha256:65ac3bc20f78aa0ee5ae84baa68917f89fef4af63e941084dd019a0d0e749f0c", size = 103122, upload-time = "2026-05-10T18:15:52.068Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/d0/07c77e067f0838949b43bd89232c29d72efebb9d2801a9750184eb706b71/librt-0.11.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b87504f1690a23b9a2cca841191a04f83895d4fc2dd04df91d82b1a04ca2ad46", size = 144147, upload-time = "2026-05-10T18:15:53.227Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/24/8493538fa4f62f982686398a5b8f68008138a75086abdea19ade64bf4255/librt-0.11.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:40071fc5fe0ce8daa6de616702314a01e1250711682b0523d6ab8d4525910cb3", size = 143614, upload-time = "2026-05-10T18:15:54.657Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/1e/f8bad050810d9171f34a1648ed910e56814c2ba61639f2bd53c6377ae24b/librt-0.11.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:137e79445c896a0ea7b265f52d23954e05b64222ee1af69e2cb34219067cbb67", size = 485538, upload-time = "2026-05-10T18:15:56.117Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/fe/3594ebfbaf03084ba4b120c9ba5c3183fd938a48725e9bbe6ff0a5159ad8/librt-0.11.0-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:cca6644054e78746d8d4ef238681f9c34ff8b584fe6b988ecebb8db3b15e622a", size = 479623, upload-time = "2026-05-10T18:15:57.544Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/da/5d1876984b3746c85dbd219dbfcb73c85f54ee263fd32e5b2a632ec14571/librt-0.11.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d5b0eea49f5562861ee8d757a32ef7d559c1d35be2aaaa1ec28941d74c9ffc8a", size = 513082, upload-time = "2026-05-10T18:15:58.805Z" },
+    { url = "https://files.pythonhosted.org/packages/19/6e/55bdf5d5ca00c3e18430690bf2c953d8d3ffd3c337418173d33dec985dc9/librt-0.11.0-cp312-cp312-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0d1029d7e1ae1a7e647ed6fb5df8c4ce2dffefb7a9f5fd1376a4554d96dac09f", size = 508105, upload-time = "2026-05-10T18:16:00.2Z" },
+    { url = "https://files.pythonhosted.org/packages/07/10/f1f23a7c595ee90ece4d35c851e5d104b1311a887ed1b4ac4c35bbd13da8/librt-0.11.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:bc3ce6b33c5828d9e80592011a5c584cb2ce86edbc4088405f70da47dc1d1b3b", size = 522268, upload-time = "2026-05-10T18:16:01.708Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/02/5720f5697a7f54b78b3aefbe20df3a48cedcff1276618c4aa481177942ed/librt-0.11.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:936c5995f3514a42111f20099397d8177c79b4d7e70961e396c6f5a0a3566766", size = 527348, upload-time = "2026-05-10T18:16:03.496Z" },
+    { url = "https://files.pythonhosted.org/packages/50/db/b4a47c6f91db4ff76348a0b3dd0cc65e090a078b765a810a62ff9434c3d3/librt-0.11.0-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:9bc0ca6ad9381cbe8e4aa6e5726e4c80c78115a6e9723c599ed1d73e092bc49d", size = 516294, upload-time = "2026-05-10T18:16:05.173Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/58/9384b2f4eb1ed1d273d40948a7c5c4b2360213b402ef3be4641c06299f9c/librt-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:070aa8c26c0a74774317a72df8851facc7f0f012a5b406557ac56992d92e1ec8", size = 553608, upload-time = "2026-05-10T18:16:06.839Z" },
+    { url = "https://files.pythonhosted.org/packages/21/7b/5aa8848a7c6a9278c79375146da1812e695754ceec5f005e6043461a7315/librt-0.11.0-cp312-cp312-win32.whl", hash = "sha256:6bf14feb84b05ae945277395451998c89c54d0def4070eb5c08de544930b245a", size = 101879, upload-time = "2026-05-10T18:16:08.103Z" },
+    { url = "https://files.pythonhosted.org/packages/37/33/8a745436944947575b584231750a41417de1a38cf6a2e9251d1065651c09/librt-0.11.0-cp312-cp312-win_amd64.whl", hash = "sha256:75672f0bc524ede266287d532d7923dbce94c7514ad07627bac3d0c6d92cc4d9", size = 119831, upload-time = "2026-05-10T18:16:09.174Z" },
+    { url = "https://files.pythonhosted.org/packages/59/67/a6739ac96e28b7855808bdb0370e250606104a859750d209e5a0716fe7ab/librt-0.11.0-cp312-cp312-win_arm64.whl", hash = "sha256:2f10cf143e4a9bb0f4f5af568a00df94a2d69ef41c2579584454bb0fe5cc642c", size = 103470, upload-time = "2026-05-10T18:16:10.369Z" },
+]
+
 [[package]]
 name = "markupsafe"
 version = "3.0.3"
@@ -1079,6 +1226,41 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/6f/87/afead29192170917537934c6aff4b008c805fff7b1ccea0c79120d96beda/matplotlib-3.10.9-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3fc0364dfbe1d07f6d15c5ebd0c5bf89e126916e5a8667dd4a7a6e84c36653d4", size = 8774002, upload-time = "2026-04-24T00:14:09.816Z" },
 ]
 
+[[package]]
+name = "moderngl"
+version = "5.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "glcontext" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/da/52/540e2f8c45060bb2709f56eb5a44ae828dfcc97ccecb342c1a7deb467889/moderngl-5.12.0.tar.gz", hash = "sha256:52936a98ccb2f2e1d6e3cb18528b2919f6831e7e3f924e788b5873badce5129b", size = 193232, upload-time = "2024-10-17T12:36:28.002Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/4b/988c5f4ef55bf0c62a0b63a4b32fe6d6dd755d12f5951e8fd56e8a30d3f6/moderngl-5.12.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:105cdee2ee29a7e6ebbc76cf178941503656a185c6945933bc7ef395ba8e65a7", size = 111803, upload-time = "2024-10-17T12:36:34.271Z" },
+    { url = "https://files.pythonhosted.org/packages/97/40/272d38d9d096d591db08e4aa1c983a8ed34cd1717b6524a88539b0df4341/moderngl-5.12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:18deb8bebd0a4277d92c76dbedf8e4b4b68bf0a8a878404c6b26aed750890d3b", size = 109223, upload-time = "2024-10-17T12:36:35.957Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/5c/a6f2743c8ae1c95cd6531510bf76fa6be650a5e0a1dffdf138b5ed186f61/moderngl-5.12.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f0c4f7c42425177168938386a4fabd734ca3bbb5de2d1fd1176cfa6f980fc13", size = 291432, upload-time = "2024-10-17T12:36:37.122Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/2d/b6bfc4fe7df343a4f410030dbd8261566282049e56e9ffc3cbd2e626656e/moderngl-5.12.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:878cdf593204d85c020305f21d306f979353a67c932b9df58ea936f6e5ad13e7", size = 265422, upload-time = "2024-10-17T12:36:38.767Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/ae/35f8f4c833aca90870110509dddad641f5adf9597da15b3c9e7c75db319f/moderngl-5.12.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:00d94f9cb485d87c85088edad624201e152d8ac401793a024b16cd9e2bc4dbf6", size = 1342266, upload-time = "2024-10-17T12:36:40.405Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/4b/2e0b6d0e8a5273da93ed82c8eb91b54a37413b1b9d65bb223d67b595fc96/moderngl-5.12.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:edd91057b8d76beebac0d7b0c741466ee8f37eaf3c07856785c2872afe0b35ac", size = 1270055, upload-time = "2024-10-17T12:36:42.243Z" },
+    { url = "https://files.pythonhosted.org/packages/48/2f/b590f86d42630fbbaffd83f1890ef6278ec12d5cb336b6a2efcbb3c2ca21/moderngl-5.12.0-cp310-cp310-win32.whl", hash = "sha256:3d066eae2eb44e81bd7addf565adebc041bdee119e7ac6e4f95831d6f327a938", size = 101044, upload-time = "2024-10-17T12:36:43.94Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/6d/f9b77797d3a0f3e5b67a75092c6c63b26360042fd8e43be017c706e308a8/moderngl-5.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:76d966194d51852f48c42a6e786a4520f1e1be5f93e2626423d673663422d559", size = 108272, upload-time = "2024-10-17T12:36:44.995Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/ea/569c2c08bfef84f4acf633a8e6d956f4f75cfaa8832d7d812dbf2ff6843a/moderngl-5.12.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:28cdba5dcf2d03c89bb25dc3b2f5770ac4104470ed5bbe680a15494fa52a537d", size = 111802, upload-time = "2024-10-17T12:36:47.377Z" },
+    { url = "https://files.pythonhosted.org/packages/00/ef/98f36133ab010ce9831b75a16e75a627c12a4c1d6ef2e353eca1769a1e09/moderngl-5.12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dad93893e3fcb2410bfd31e854f20e1370b4fbafa07a737f1046f5fbd29ba0f4", size = 109227, upload-time = "2024-10-17T12:36:49.24Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/bb/ab371acacd2497bddb5f02b209e3bfae452b2be59d0cf8fa728a3b87de1f/moderngl-5.12.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7fc0f8788bc84433d2124e9a4893adbe40f93c7d213abb8ad7b909540cb0161f", size = 293468, upload-time = "2024-10-17T12:36:50.8Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/9e/7ebf2b98da310c90c2b295e91b6c25f864f0f5583ce86bee72d387cb577a/moderngl-5.12.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6efd3fe0d2c9652af21e2c1f5a936a2b971abac5bdd777da7182a54962466cab", size = 267348, upload-time = "2024-10-17T12:36:52.526Z" },
+    { url = "https://files.pythonhosted.org/packages/61/0a/87fb24f4cd2aa07150b84fbf400edf4d8a8f71784cbf064f1ed92b756fea/moderngl-5.12.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:6f3bd2d534fc081cde30545b84ebca63aef847ba8bd533217b9a37f565614ade", size = 1343953, upload-time = "2024-10-17T12:36:54.601Z" },
+    { url = "https://files.pythonhosted.org/packages/83/42/11b0306e630d9a38b8bac20563b326f6d5fba4dfc45cc90b0666ed3e7141/moderngl-5.12.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:eaa3de9446c6febec4d5f888e6f1a4e9398bc5a5ea70b1570ea447213641d4a6", size = 1271832, upload-time = "2024-10-17T12:36:56.383Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/dd/74d300275fe4834e63b8d70450801f206d005f2047898d4eb2a30efc3913/moderngl-5.12.0-cp311-cp311-win32.whl", hash = "sha256:9fdb76f1fd890db67727c8cdee4db2ee6319068c7ce92be0308366f8745e28ab", size = 101043, upload-time = "2024-10-17T12:36:58.281Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/08/5f615a4605d343cd5c1112d2b175270e6a5586008bc10a85b822c340cf86/moderngl-5.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:0c210e8d52a60025f6586ca015c39feb1e57e6dc792c3ff44800f6493a541b1a", size = 108279, upload-time = "2024-10-17T12:37:01.125Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/66/31161e81bc85ca3cdbb9d94f703f21575e4ae9a2919e9d1af98fc7fdb1ba/moderngl-5.12.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:2750547707c1ec3790dfbeb9c90fb808672ff13f61cac392c706ba09fda10db0", size = 112101, upload-time = "2024-10-17T12:37:02.267Z" },
+    { url = "https://files.pythonhosted.org/packages/84/b2/7229a89a40d33a95119a7c64c7ee36a6a6e376c57c39fb577ea513602f37/moderngl-5.12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:c5c2a5fe06c7021183d9274df798f25516409c8d55898c324dae8a0b2de10144", size = 109377, upload-time = "2024-10-17T12:37:03.843Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/96/bcb5141eae24474d80b8157b0c3055d25fa75f9804d4abb4a514695bbba9/moderngl-5.12.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b6c4972f3ddd10a3de6c30311da2c25bc493d023796e16c5d4e0f8bd6d5770be", size = 296394, upload-time = "2024-10-17T12:37:04.967Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/79/a9998ddf6757f4f15888b0a106d80a64a8c8991a8ce5c14047830704b9e6/moderngl-5.12.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a4d497ec6a3f6afa9ebd0be816d9bfe2fe20fec2105acfb88d956619c3ed8eb4", size = 270548, upload-time = "2024-10-17T12:37:07.57Z" },
+    { url = "https://files.pythonhosted.org/packages/17/f4/313dc301db936b231035b961e004f1914c2954bdcdf4985e24bff15e7ed5/moderngl-5.12.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:2f3d240e9bc5d83257378bae59f8f35638b89d22bb003cf674b88fd7932161ce", size = 1345817, upload-time = "2024-10-17T12:37:09.105Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/6f/7b3587e7e3ae633b8c85038f035dfeb348ebf805de4beb01241c59c6b97c/moderngl-5.12.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:6fa667d560d842e778e2a5968305fb78f9781616a11b1b93acd2562f97262ccf", size = 1274968, upload-time = "2024-10-17T12:37:11.092Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/e8/0f3b3cd1be7b0a93f33dc613f76a42021d1393b4949c5b6a1ca2a01c6772/moderngl-5.12.0-cp312-cp312-win32.whl", hash = "sha256:0a02fddd54dccee1ca6060bfed75a2e6a17dd3ee06920fac418506d8a8233849", size = 101221, upload-time = "2024-10-17T12:37:12.642Z" },
+    { url = "https://files.pythonhosted.org/packages/56/85/35498b1821cf31c731b1882168db8924207ff3c06d8f0da53e1cc373a89d/moderngl-5.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:8698a59ad03539a2982125b7998efc1c107ba31d5d03437b6fcd72cb2c226922", size = 108525, upload-time = "2024-10-17T12:37:13.816Z" },
+]
+
 [[package]]
 name = "mpmath"
 version = "1.3.0"
@@ -1201,15 +1383,61 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/81/08/7036c080d7117f28a4af526d794aab6a84463126db031b007717c1a6676e/multidict-6.7.1-py3-none-any.whl", hash = "sha256:55d97cc6dae627efa6a6e548885712d4864b81110ac76fa4e534c03819fa4a56", size = 12319, upload-time = "2026-01-26T02:46:44.004Z" },
 ]
 
+[[package]]
+name = "mypy"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "ast-serialize" },
+    { name = "librt", marker = "platform_python_implementation != 'PyPy' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "mypy-extensions" },
+    { name = "pathspec" },
+    { name = "tomli", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/82/15/cca9d88503549ed6fedeaa1d448cdddd542ee8a490232d732e278036fbf2/mypy-2.1.0.tar.gz", hash = "sha256:81e76ad12c2d804512e9b13240d1588316531bfba07558286078bfbce9613633", size = 3898359, upload-time = "2026-05-11T18:37:36.237Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a4/71/d351dca3e9b30da2328ee9d445c88b8388072808ebfbc49eb69d30b67749/mypy-2.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:11a6beb180257a805961aea9ec591bbd0bd17f1e18d35b8456d57aee5bedfedc", size = 14778792, upload-time = "2026-05-11T18:36:23.605Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/45/7d51594b644c17c0bcf74ed8cd5fc33b324276d708e8506f220b70dab9d9/mypy-2.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8ef78c1d306bbf9a8a12f526c44902c9c28dffd6c52c52bf6a72641ce18d3849", size = 13645739, upload-time = "2026-05-11T18:37:22.752Z" },
+    { url = "https://files.pythonhosted.org/packages/65/01/455c31b170e9468265074840bf18863a8482a24103fdaabe4e199392aa5f/mypy-2.1.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c209a90853081ff01d01ee895cafe10f7db1474e0d95beaeef0f6c1db9119bbd", size = 14074199, upload-time = "2026-05-11T18:35:09.292Z" },
+    { url = "https://files.pythonhosted.org/packages/41/5a/93093f0b29a9e982deafde698f740a2eb2e05886e79ccf0594c7fd5413a3/mypy-2.1.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:47cebf61abde7c088a4e27718a8b13a81655686b2e9c251f5c0915a802248166", size = 14953128, upload-time = "2026-05-11T18:31:57.678Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/2f/a196f5331d96170ad3d28f144d2aba690d4b2911381f68d51e489c7ab82a/mypy-2.1.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:d57a90ae5e872138a425ec328edbc9b235d1934c4377881a33ec05b341acc9a8", size = 15249378, upload-time = "2026-05-11T18:33:00.101Z" },
+    { url = "https://files.pythonhosted.org/packages/54/de/94d321cc12da9f71341ac0c270efbed5c725750c7b4c334d957de9a087d9/mypy-2.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:aea7f7a8a55b459c34275fc468ada6ca7c173a5e43a68f5dbe588a563d8a06b8", size = 11060994, upload-time = "2026-05-11T18:33:18.848Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/62/0c27ca55219a7c764a7fb88c7bb2b7b2f9780ade8bbf16bc8ed8400eef6b/mypy-2.1.0-cp310-cp310-win_arm64.whl", hash = "sha256:c989640253f0d76843e9c6c1bbf4bd48c5e85ada61bde4beb37cb3eca035685e", size = 9976743, upload-time = "2026-05-11T18:31:25.554Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/a1/639f3024794a2a15899cb90707fe02e044c4412794c39c5769fd3df2e2ef/mypy-2.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:a683016b16fe2f572dc04c72be7ee0504ac1605a265d0200f5cea695fb788f41", size = 14691685, upload-time = "2026-05-11T18:33:27.973Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/08/9a585dea4325f20d8b80dc78623fa50d1fd2173b710f6237afd6ba6ab39b/mypy-2.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1a293c534adb55271fef24a26da04b855540a8c13cc07bc5917b9fd2c394f2ca", size = 13555165, upload-time = "2026-05-11T18:32:16.107Z" },
+    { url = "https://files.pythonhosted.org/packages/81/dc/7c42cc9c6cb01e8eb09961f1f738741d3e9c7e9d5c5b30ec69222625cd5f/mypy-2.1.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7406f4d048e71e576f5356d317e5b0a9e666dfd966bd99f9d14ca06e1a341538", size = 13994376, upload-time = "2026-05-11T18:32:39.256Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/fa/285946c33bce716e082c11dfeee9ee196eaf1f5042efb3581a31f9f205e4/mypy-2.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e0210d626fc8b31ccc90233754c7bc90e1f43205e85d96387f7db1285b55c398", size = 14864618, upload-time = "2026-05-11T18:34:49.765Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/83/82397f48af6c27e295d57979ded8490c9829040152cf7571b2f026aeb9a0/mypy-2.1.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3712c20deed54e814eaaa825603bada8ea1c390670a397c95b98405347acc563", size = 15102063, upload-time = "2026-05-11T18:34:05.855Z" },
+    { url = "https://files.pythonhosted.org/packages/40/68/b02dec39057b88eb03dc0aa854732e26e8361f34f9d0e20c7614967d1eba/mypy-2.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:fcaa0e479066e31f7cceb6a3bea39cb22b2ff51a6b2f24f193d19179ba17c389", size = 11060564, upload-time = "2026-05-11T18:35:36.494Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/a8/ea3dcbef31f99b634f2ee23bb0321cbc8c1b388b76a861eb849f13c347dc/mypy-2.1.0-cp311-cp311-win_arm64.whl", hash = "sha256:0b1a5260c95aa443083f9ed3592662941951bca3d4ca224a5dc517c38b7cf666", size = 9966983, upload-time = "2026-05-11T18:37:14.139Z" },
+    { url = "https://files.pythonhosted.org/packages/95/b1/55861beb5c339b44f9a2ba92df9e2cb1eeb4ae1eee674cdf7772c797778b/mypy-2.1.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:244358bf1c0da7722230bce60683d52e8e9fd030554926f15b747a84efb5b3af", size = 14874381, upload-time = "2026-05-11T18:37:31.784Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/b3/b7f770114b7d0ac92d0f76e8d93c2780844a70488a90e91821927850da86/mypy-2.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4ec7c57657493c7a75534df2751c8ae2cda383c16ecc55d2106c54476b1b16f6", size = 13665501, upload-time = "2026-05-11T18:34:23.063Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/f3/8ae2037967e2126689a0c11d99e2b707134a565191e92c60ca2572aec60a/mypy-2.1.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d8161b6ff4392410023224f0969d17db93e1e154bc3e4ba62598e720723ae211", size = 14045750, upload-time = "2026-05-11T18:31:48.151Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/32/615eb5911859e43d054941b0d0a7d06cfa2870eba86529cf385b052b111c/mypy-2.1.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bf03e12003084a67395184d3eb8cbd6a489dc3655b5664b28c210a9e2403ab0b", size = 15061630, upload-time = "2026-05-11T18:37:06.898Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/03/4eafbfff8bfab1b87082741eae6e6a624028c984e6708b73bce2a8570c9d/mypy-2.1.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:20509760fd791c51579d573153407d226385ec1f8bcce55d730b354f3336bc22", size = 15288831, upload-time = "2026-05-11T18:31:18.07Z" },
+    { url = "https://files.pythonhosted.org/packages/99/ee/919661478e5891a3c96e549c036e467e64563ab85995b10c53c8358e16a3/mypy-2.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:6753d0c1fdd6b1a23b9e4f283ce80b2153b724adcb2653b20b85a8a28ac6436b", size = 11135228, upload-time = "2026-05-11T18:34:31.23Z" },
+    { url = "https://files.pythonhosted.org/packages/24/0a/6a12b9782ca0831a553192f351679f4548abc9d19a7cc93bb7feb02084c7/mypy-2.1.0-cp312-cp312-win_arm64.whl", hash = "sha256:98ebb6589bb3b6d0c6f0c459d53ca55b8091fbc13d277c4041c885392e8195e8", size = 10040684, upload-time = "2026-05-11T18:36:48.199Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/2a/13ca1f292f6db1b98ff495ef3467736b331621c5917cad984b7043e7348d/mypy-2.1.0-py3-none-any.whl", hash = "sha256:a663814603a5c563fb87a4f96fb473eeb30d1f5a4885afcf44f9db000a366289", size = 2693302, upload-time = "2026-05-11T18:31:29.246Z" },
+]
+
+[[package]]
+name = "mypy-extensions"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/6e/371856a3fb9d31ca8dac321cda606860fa4548858c0cc45d9d1d4ca2628b/mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558", size = 6343, upload-time = "2025-04-22T14:54:24.164Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
+]
+
 [[package]]
 name = "networkx"
 version = "3.4.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/fd/1d/06475e1cd5264c0b870ea2cc6fdb3e37177c1e565c43f56ff17a10e3937f/networkx-3.4.2.tar.gz", hash = "sha256:307c3669428c5362aab27c8a1260aa8f47c4e91d3891f48be0141738d8d053e1", size = 2151368, upload-time = "2024-10-21T12:39:38.695Z" }
 wheels = [
@@ -1221,17 +1449,27 @@ name = "networkx"
 version = "3.6.1"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/6a/51/63fe664f3908c97be9d2e4f1158eb633317598cfa6e1fc14af5383f17512/networkx-3.6.1.tar.gz", hash = "sha256:26b7c357accc0c8cde558ad486283728b65b6a95d85ee1cd66bafab4c8168509", size = 2517025, upload-time = "2025-12-08T17:02:39.908Z" }
 wheels = [
     { url = "https://files.pythonhosted.org/packages/9e/c9/b2622292ea83fbb4ec318f5b9ab867d0a28ab43c5717bb85b0a5f6b3b0a4/networkx-3.6.1-py3-none-any.whl", hash = "sha256:d47fbf302e7d9cbbb9e2555a0d267983d2aa476bac30e90dfbe5669bd57f3762", size = 2068504, upload-time = "2025-12-08T17:02:38.159Z" },
 ]
 
+[[package]]
+name = "nodeenv"
+version = "1.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/bf/d1bda4f6168e0b2e9e5958945e01910052158313224ada5ce1fb2e1113b8/nodeenv-1.10.0.tar.gz", hash = "sha256:996c191ad80897d076bdfba80a41994c2b47c68e224c542b48feba42ba00f8bb", size = 55611, upload-time = "2025-12-20T14:08:54.006Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl", hash = "sha256:5bb13e3eed2923615535339b3c620e76779af4cb4c6a90deccc9e36b274d3827", size = 23438, upload-time = "2025-12-20T14:08:52.782Z" },
+]
+
 [[package]]
 name = "numpy"
 version = "1.26.4"
@@ -1313,7 +1551,7 @@ name = "nvidia-cudnn-cu11"
 version = "9.1.0.70"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-cublas-cu11" },
+    { name = "nvidia-cublas-cu11", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux')" },
 ]
 wheels = [
     { url = "https://files.pythonhosted.org/packages/00/3b/0b776f04e364cd99e4cf152c2a9eadb5934c67c9a91429da55169a9447fd/nvidia_cudnn_cu11-9.1.0.70-py3-none-manylinux2014_x86_64.whl", hash = "sha256:e6135ac63fe9d5b0b89cfb35c3fc1c1349f2b995becadf2e9dc21bca89d9633d", size = 663919573, upload-time = "2024-04-22T15:20:24.839Z" },
@@ -1347,7 +1585,7 @@ name = "nvidia-cusolver-cu11"
 version = "11.4.1.48"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-cublas-cu11" },
+    { name = "nvidia-cublas-cu11", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux')" },
 ]
 wheels = [
     { url = "https://files.pythonhosted.org/packages/55/ee/939ff0104991dd7bdabb4c9767994c612ba0e1c9a55672a1ddd42f5e5b16/nvidia_cusolver_cu11-11.4.1.48-py3-none-manylinux1_x86_64.whl", hash = "sha256:ca538f545645b7e6629140786d3127fe067b3d5a085bd794cde5bfe877c8926f", size = 128240842, upload-time = "2022-10-03T23:30:24.348Z" },
@@ -1395,6 +1633,23 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3f/3f/0e1dd2bc4d89f838b86c76956ffa514307d3be4d8b5ee0da4e9d12a8b54b/nvidia_nvtx_cu11-11.8.86-py3-none-win_amd64.whl", hash = "sha256:54031010ee38d774b2991004d88f90bbd7bbc1458a96bbc4b42662756508c252", size = 66297, upload-time = "2022-10-03T23:39:12.132Z" },
 ]
 
+[[package]]
+name = "opencv-python-headless"
+version = "4.11.0.86"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "numpy" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/2f/5b2b3ba52c864848885ba988f24b7f105052f68da9ab0e693cc7c25b0b30/opencv-python-headless-4.11.0.86.tar.gz", hash = "sha256:996eb282ca4b43ec6a3972414de0e2331f5d9cda2b41091a49739c19fb843798", size = 95177929, upload-time = "2025-01-16T13:53:40.22Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/53/2c50afa0b1e05ecdb4603818e85f7d174e683d874ef63a6abe3ac92220c8/opencv_python_headless-4.11.0.86-cp37-abi3-macosx_13_0_arm64.whl", hash = "sha256:48128188ade4a7e517237c8e1e11a9cdf5c282761473383e77beb875bb1e61ca", size = 37326460, upload-time = "2025-01-16T13:52:57.015Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/43/68555327df94bb9b59a1fd645f63fafb0762515344d2046698762fc19d58/opencv_python_headless-4.11.0.86-cp37-abi3-macosx_13_0_x86_64.whl", hash = "sha256:a66c1b286a9de872c343ee7c3553b084244299714ebb50fbdcd76f07ebbe6c81", size = 56723330, upload-time = "2025-01-16T13:55:45.731Z" },
+    { url = "https://files.pythonhosted.org/packages/45/be/1438ce43ebe65317344a87e4b150865c5585f4c0db880a34cdae5ac46881/opencv_python_headless-4.11.0.86-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6efabcaa9df731f29e5ea9051776715b1bdd1845d7c9530065c7951d2a2899eb", size = 29487060, upload-time = "2025-01-16T13:51:59.625Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/5c/c139a7876099916879609372bfa513b7f1257f7f1a908b0bdc1c2328241b/opencv_python_headless-4.11.0.86-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0e0a27c19dd1f40ddff94976cfe43066fbbe9dfbb2ec1907d66c19caef42a57b", size = 49969856, upload-time = "2025-01-16T13:53:29.654Z" },
+    { url = "https://files.pythonhosted.org/packages/95/dd/ed1191c9dc91abcc9f752b499b7928aacabf10567bb2c2535944d848af18/opencv_python_headless-4.11.0.86-cp37-abi3-win32.whl", hash = "sha256:f447d8acbb0b6f2808da71fddd29c1cdd448d2bc98f72d9bb78a7a898fc9621b", size = 29324425, upload-time = "2025-01-16T13:52:49.048Z" },
+    { url = "https://files.pythonhosted.org/packages/86/8a/69176a64335aed183529207ba8bc3d329c2999d852b4f3818027203f50e6/opencv_python_headless-4.11.0.86-cp37-abi3-win_amd64.whl", hash = "sha256:6c304df9caa7a6a5710b91709dd4786bf20a74d57672b3c31f7033cc638174ca", size = 39402386, upload-time = "2025-01-16T13:52:56.418Z" },
+]
+
 [[package]]
 name = "opentelemetry-api"
 version = "1.42.1"
@@ -1443,6 +1698,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c4/cb/00451c3cf31790287768bb12c6bec834f5d292eaf3022afc88e14b8afc94/paho_mqtt-2.1.0-py3-none-any.whl", hash = "sha256:6db9ba9b34ed5bc6b6e3812718c7e06e2fd7444540df2455d2c51bd58808feee", size = 67219, upload-time = "2024-04-29T19:52:48.345Z" },
 ]
 
+[[package]]
+name = "pathspec"
+version = "1.1.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5a/82/42f767fc1c1143d6fd36efb827202a2d997a375e160a71eb2888a925aac1/pathspec-1.1.1.tar.gz", hash = "sha256:17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a", size = 135180, upload-time = "2026-04-27T01:46:08.907Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f1/d9/7fb5aa316bc299258e68c73ba3bddbc499654a07f151cba08f6153988714/pathspec-1.1.1-py3-none-any.whl", hash = "sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189", size = 57328, upload-time = "2026-04-27T01:46:07.06Z" },
+]
+
 [[package]]
 name = "pillow"
 version = "12.2.0"
@@ -1496,10 +1760,9 @@ name = "pint"
 version = "0.24.4"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "flexcache", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -1517,11 +1780,12 @@ name = "pint"
 version = "0.25.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "flexcache", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -1552,6 +1816,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
 ]
 
+[[package]]
+name = "pre-commit"
+version = "4.6.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8e/22/2de9408ac81acbb8a7d05d4cc064a152ccf33b3d480ebe0cd292153db239/pre_commit-4.6.0.tar.gz", hash = "sha256:718d2208cef53fdc38206e40524a6d4d9576d103eb16f0fec11c875e7716e9d9", size = 198525, upload-time = "2026-04-21T20:31:41.613Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/80/6e/4b28b62ecb6aae56769c34a8ff1d661473ec1e9519e2d5f8b2c150086b26/pre_commit-4.6.0-py2.py3-none-any.whl", hash = "sha256:e2cf246f7299edcabcf15f9b0571fdce06058527f0a06535068a86d38089f29b", size = 226472, upload-time = "2026-04-21T20:31:40.092Z" },
+]
+
 [[package]]
 name = "propcache"
 version = "0.5.2"
@@ -1741,7 +2021,7 @@ name = "pyobjc-framework-cocoa"
 version = "12.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "pyobjc-core" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/6d/cc/927169225e72bab9c9b44285656768fb75052a0bc85fdbca62740e1ca43c/pyobjc_framework_cocoa-12.2.tar.gz", hash = "sha256:20b392e2b7241caad0538dfde12143343e5dfe48f72e7df660a7548e635903dc", size = 3125555, upload-time = "2026-05-30T12:35:09.273Z" }
 wheels = [
@@ -1755,8 +2035,8 @@ name = "pyobjc-framework-corebluetooth"
 version = "12.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "pyobjc-core" },
-    { name = "pyobjc-framework-cocoa" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-framework-cocoa", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/52/df/bee7ba216f9fb513710aac1701b78c97b087b37fca8ec1806f8572e0bbb3/pyobjc_framework_corebluetooth-12.2.tar.gz", hash = "sha256:8b4e5ca99953c360c391a695b0782a5328fcecafd56fdf790ad709e932feb306", size = 37552, upload-time = "2026-05-30T12:35:33.863Z" }
 wheels = [
@@ -1770,8 +2050,8 @@ name = "pyobjc-framework-libdispatch"
 version = "12.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "pyobjc-core" },
-    { name = "pyobjc-framework-cocoa" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-framework-cocoa", marker = "sys_platform == 'darwin' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/1b/fe/e23be301e46c30450955cdb096f16f6a86e7609787a4b8225ec24d6fdc9d/pyobjc_framework_libdispatch-12.2.tar.gz", hash = "sha256:4a41879ef7716b73d70f2e40ff39353d686cbc59d48c93217ed362d2b2baf1ba", size = 40345, upload-time = "2026-05-30T12:39:09.474Z" }
 wheels = [
@@ -1842,6 +2122,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" },
 ]
 
+[[package]]
+name = "python-discovery"
+version = "1.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "filelock" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0b/1a/cbbaf13b730abb0a16b964d984e19f2fe520c21a4dc664051359a3f5a9e7/python_discovery-1.4.2.tar.gz", hash = "sha256:8f3746c4b4968d22afbb97d36e1a0e5b66e6c0f297290f2e95f05b9b8bf18690", size = 70277, upload-time = "2026-06-11T16:10:42.383Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/82/a70006589557f267f15bd384c0642ad49f0d97b690c3a05b166b9dcbad3b/python_discovery-1.4.2-py3-none-any.whl", hash = "sha256:475803f53b7b2ed6e490e27373f9d8340f7d2eebf9acdaf645d7d714c97bb500", size = 33886, upload-time = "2026-06-11T16:10:41.192Z" },
+]
+
 [[package]]
 name = "python-dotenv"
 version = "1.2.2"
@@ -1907,10 +2200,9 @@ name = "rpds-py"
 version = "0.30.0"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
 wheels = [
@@ -1977,11 +2269,12 @@ name = "rpds-py"
 version = "2026.5.1"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/2e/43/25a8dcd3feedd735039a8f0b5b7e3b118232b5eae288c4fd9ab200d41094/rpds_py-2026.5.1.tar.gz", hash = "sha256:07b24fea40541e28570e5b795a4a38fbdcd12550c06bd0748005ecc8116ca256", size = 64459, upload-time = "2026-05-28T12:02:13.232Z" }
 wheels = [
@@ -2029,15 +2322,39 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ea/ea/e7b0251441da9adfeaebcf29601d10f2a1455fcf0772fae9e7e19032bd96/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:8c43a8a973270fd173bf48cdf80bbe66312421cba68d40845034f174f2389049", size = 586326, upload-time = "2026-05-28T12:02:11.47Z" },
 ]
 
+[[package]]
+name = "ruff"
+version = "0.15.17"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/a9/3abdf488f1bf3d24c699415e454ed554a6350d5d89ce183be1ee0a3361ac/ruff-0.15.17.tar.gz", hash = "sha256:2ec446937fd16c8c4de2674a209cc5af64d9c6f17d21fbf1151054fa0bcf5219", size = 4743346, upload-time = "2026-06-11T17:54:47.663Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/4d/e11259f5da07cb6afb2d074c31bf09da9671993f7329d4f15d2fdc458301/ruff-0.15.17-py3-none-linux_armv6l.whl", hash = "sha256:d9feddb927fc68bd295f5eebc587a7e42cfaf9b65f60ca4a2386febff575da8f", size = 10856677, upload-time = "2026-06-11T17:54:49.533Z" },
+    { url = "https://files.pythonhosted.org/packages/29/3e/772d679e1a0dc058e58875bd2c0cb713a0530877b4a76fee3c7966df0d49/ruff-0.15.17-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:25805a226d741c47d274a35ad5c10a7dde175fcddfa511d7cf3da0a21eb3eab7", size = 11223443, upload-time = "2026-06-11T17:55:00.573Z" },
+    { url = "https://files.pythonhosted.org/packages/68/58/bd41f7688b2fd5623012605130ed70e60aa7f2244baa3d5066bdd61530c8/ruff-0.15.17-py3-none-macosx_11_0_arm64.whl", hash = "sha256:f6ad73b14c2d18a3bf8ad7cb6974294d7f613a7898604826058e6ac64918ef4d", size = 10566458, upload-time = "2026-06-11T17:55:07.52Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/5b/733371013fcf1ec339e477ece6ab42bfe10bdd9bba8ee88a9516aa56bfc0/ruff-0.15.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ba0c1e4f95bcb3869d0d30cbd5917071ef2e28665abfec970cdab0492c713ed", size = 10914483, upload-time = "2026-06-11T17:55:05.501Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/cc/6f24251cc0252f7239391ccb85833f320efad14ebe5b443943f37ced6332/ruff-0.15.17-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:81647960f10bff57d2e51cadd0c3950fe598400c852863a038720ef5b8cca91e", size = 10647497, upload-time = "2026-06-11T17:54:57.733Z" },
+    { url = "https://files.pythonhosted.org/packages/68/dd/0d10c17ce1a1624d6fc3156309c3f834fdb5dfaad026ec90c85684f3990e/ruff-0.15.17-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0e01a84ddbc8c16c23055ba3924476850f1bbc1917cebbb9376665a63e74260d", size = 11416967, upload-time = "2026-06-11T17:54:51.461Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/91/556bfb156f6144f355e831c23db00b2fc4120f86b3ce81cc5f7fd2df51f3/ruff-0.15.17-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:84fe9f653152f8f294f9f7e03bf3a453d8b4a27f7a59c78c8666167f2b17b96c", size = 12335770, upload-time = "2026-06-11T17:54:45.793Z" },
+    { url = "https://files.pythonhosted.org/packages/88/82/8b5999aa13355e926f06d9f42a32dcca862f623bf0363785ff89d607dffd/ruff-0.15.17-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c0fe88a7676e7a05b73174d4d4a59cb2ac21ff8263583f87a81a6018475a978", size = 11575441, upload-time = "2026-06-11T17:54:32.661Z" },
+    { url = "https://files.pythonhosted.org/packages/11/93/f10377bb04109ca0e8cbc483ff1982c54b6d418210041776f93e8cdc7fa9/ruff-0.15.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ecfc3c7878fff94633ab0348524e093f9ce3243080416dd7d14f8ba400174719", size = 11557614, upload-time = "2026-06-11T17:54:34.698Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/a6/eeeae7f7d5493df41649ab3db92f086b2d0a30199e4efdf8e3dd7a033f24/ruff-0.15.17-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:b8461180b22420b1bdc289909410930761629fddf2a5aaf60fae1ab26cedc4c4", size = 11544450, upload-time = "2026-06-11T17:54:39.042Z" },
+    { url = "https://files.pythonhosted.org/packages/32/88/5991ce565129a24dd4a00db1254b3b5db2e53018cbe4018ea5a89738e727/ruff-0.15.17-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:6eccbe50a038b503e7140b441aa9c7fc8c1f36edf23ebef9f4165c2f28f568b7", size = 10892524, upload-time = "2026-06-11T17:55:09.432Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/1d/0fdd248313425f55223968af04b0a42125466a8d88d21c1d99c6af0a51e8/ruff-0.15.17-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:382fc0521025f5a8ad447d8bdd523545d0d7646adb718eb1c2dac5065ec27c0f", size = 10659573, upload-time = "2026-06-11T17:54:36.824Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/0e/072e8260deb9461062ce9311ced27a8e541229a6ffd483013dd37661e43e/ruff-0.15.17-py3-none-musllinux_1_2_i686.whl", hash = "sha256:456d41fcd1b2777ad63f09a6e7121d43f7b688bbc76a800c10f7f8fb1f912c3f", size = 11127818, upload-time = "2026-06-11T17:55:03.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/b4/55060a34163121498014696b5f656db5b8c6963768f227dbf0d76b311073/ruff-0.15.17-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:b1a04bcc94ae6194e9db05d16ad31f298a7194bfbcb08258bbe589cee1d587b8", size = 11655901, upload-time = "2026-06-11T17:54:53.562Z" },
+    { url = "https://files.pythonhosted.org/packages/49/71/9b29d6b87cef468d697f43c6a91e3fae4a80185779d7d5a4ef27d173439f/ruff-0.15.17-py3-none-win32.whl", hash = "sha256:596065960ab1ff593f744220c9fe6580eda00a95003cffa9f4048bb5b1bf0392", size = 10925574, upload-time = "2026-06-11T17:54:55.723Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/b2/8fc77f3723228836fa5d12497eb71c808f83782e10d058d2b15cfa14640b/ruff-0.15.17-py3-none-win_amd64.whl", hash = "sha256:6769e5fa1710b179b92e0bfa5a51735b35baea9013dadb06d5f44cbcf9547084", size = 12058788, upload-time = "2026-06-11T17:54:41.042Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/c7/c53e8dbff9c9dc4b7928773421ae294a5d28fcb8dcda1a089579d3a7e510/ruff-0.15.17-py3-none-win_arm64.whl", hash = "sha256:f3be1fbb34bcdfd146240d8fb92a709d4c2c8191348580a3c044ec60fa0b4456", size = 11355275, upload-time = "2026-06-11T17:54:43.635Z" },
+]
+
 [[package]]
 name = "scikit-image"
 version = "0.25.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "imageio", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -2073,11 +2390,12 @@ name = "scikit-image"
 version = "0.26.0"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "imageio", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -2114,10 +2432,9 @@ name = "scipy"
 version = "1.15.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -2158,11 +2475,12 @@ name = "scipy"
 version = "1.17.1"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -2257,10 +2575,9 @@ name = "tifffile"
 version = "2025.5.10"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version < '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -2275,11 +2592,12 @@ name = "tifffile"
 version = "2026.3.3"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
-    "python_full_version >= '3.12' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version == '3.11.*' and extra != 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform != 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
-    "python_full_version >= '3.11' and extra != 'extra-6-gently-torch-cpu' and extra != 'extra-6-gently-torch-gpu'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -2330,9 +2648,15 @@ name = "torch"
 version = "2.7.1+cu118"
 source = { registry = "https://download.pytorch.org/whl/cu118" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
-    "python_full_version < '3.11'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "filelock" },
@@ -2370,7 +2694,8 @@ name = "torch"
 version = "2.12.0"
 source = { registry = "https://download.pytorch.org/whl/cpu" }
 resolution-markers = [
-    "python_full_version >= '3.11' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
     "python_full_version < '3.11' and sys_platform == 'darwin'",
 ]
 dependencies = [
@@ -2394,8 +2719,12 @@ name = "torch"
 version = "2.12.0+cpu"
 source = { registry = "https://download.pytorch.org/whl/cpu" }
 resolution-markers = [
-    "python_full_version >= '3.11' and sys_platform != 'darwin'",
-    "python_full_version < '3.11' and sys_platform != 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "filelock", marker = "sys_platform != 'darwin'" },
@@ -2429,9 +2758,15 @@ name = "torchvision"
 version = "0.22.1+cu118"
 source = { registry = "https://download.pytorch.org/whl/cu118" }
 resolution-markers = [
-    "python_full_version >= '3.12'",
-    "python_full_version == '3.11.*'",
-    "python_full_version < '3.11'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version < '3.11' and sys_platform == 'darwin'",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy" },
@@ -2452,7 +2787,8 @@ name = "torchvision"
 version = "0.27.0"
 source = { registry = "https://download.pytorch.org/whl/cpu" }
 resolution-markers = [
-    "python_full_version >= '3.11' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and sys_platform == 'darwin'",
+    "python_full_version == '3.11.*' and sys_platform == 'darwin'",
     "python_full_version < '3.11' and sys_platform == 'darwin'",
 ]
 dependencies = [
@@ -2471,8 +2807,12 @@ name = "torchvision"
 version = "0.27.0+cpu"
 source = { registry = "https://download.pytorch.org/whl/cpu" }
 resolution-markers = [
-    "python_full_version >= '3.11' and sys_platform != 'darwin'",
-    "python_full_version < '3.11' and sys_platform != 'darwin'",
+    "python_full_version >= '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version >= '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version == '3.11.*' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version == '3.11.*' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version == '3.11.*' and sys_platform != 'darwin' and sys_platform != 'linux')",
+    "python_full_version < '3.11' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "(python_full_version < '3.11' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform != 'darwin' and sys_platform != 'linux')",
 ]
 dependencies = [
     { name = "numpy", marker = "sys_platform != 'darwin'" },
@@ -2508,7 +2848,7 @@ name = "triton"
 version = "3.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "setuptools" },
+    { name = "setuptools", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux')" },
 ]
 wheels = [
     { url = "https://files.pythonhosted.org/packages/8d/a9/549e51e9b1b2c9b854fd761a1d23df0ba2fbc60bd0c13b489ffa518cfcb7/triton-3.3.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b74db445b1c562844d3cfad6e9679c72e93fdfb1a90a24052b03bb5c49d1242e", size = 155600257, upload-time = "2025-05-29T23:39:36.085Z" },
@@ -2588,6 +2928,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/99/39/6b3f7d234ba3964c428a6e40006340f53ba37993f46ed6e111c6e9141d18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:512fec6815e2dd45161054592441ef76c830eddaad55c8aa30952e6fe1ed07c0", size = 4296343, upload-time = "2025-10-16T22:16:35.149Z" },
 ]
 
+[[package]]
+name = "virtualenv"
+version = "21.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+    { name = "python-discovery" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f1/a5/81f987504738e6defeed61ec1c47e2aefab3c35d8eeb87e1b3f38cf28254/virtualenv-21.5.1.tar.gz", hash = "sha256:dca3bf98275a59c652b69d68e73433e597d977c2da9198882479d1a7188009c8", size = 4578798, upload-time = "2026-06-16T16:23:58.603Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/02/3623e6169bed617ed1e2d372f7c69f92ec28d54c4dfc997055c8578ec148/virtualenv-21.5.1-py3-none-any.whl", hash = "sha256:55aa670b67bbfb991b03fda39bd3276d92c419d702376e98c5df1c9989a26783", size = 4558820, upload-time = "2026-06-16T16:23:56.963Z" },
+]
+
 [[package]]
 name = "watchfiles"
 version = "1.2.0"
@@ -2690,7 +3046,7 @@ name = "winrt-runtime"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions" },
+    { name = "typing-extensions", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/16/dd/acdd527c1d890c8f852cc2af644aa6c160974e66631289420aa871b05e65/winrt_runtime-3.2.1.tar.gz", hash = "sha256:c8dca19e12b234ae6c3dadf1a4d0761b51e708457492c13beb666556958801ea", size = 21721, upload-time = "2025-06-06T14:40:27.593Z" }
 wheels = [
@@ -2710,7 +3066,7 @@ name = "winrt-windows-devices-bluetooth"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/b2/a0/1c8a0c469abba7112265c6cb52f0090d08a67c103639aee71fc690e614b8/winrt_windows_devices_bluetooth-3.2.1.tar.gz", hash = "sha256:db496d2d92742006d5a052468fc355bf7bb49e795341d695c374746113d74505", size = 23732, upload-time = "2025-06-06T14:41:20.489Z" }
 wheels = [
@@ -2730,7 +3086,7 @@ name = "winrt-windows-devices-bluetooth-advertisement"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/06/fc/7ffe66ca4109b9e994b27c00f3d2d506e6e549e268791f755287ad9106d8/winrt_windows_devices_bluetooth_advertisement-3.2.1.tar.gz", hash = "sha256:0223852a7b7fa5c8dea3c6a93473bd783df4439b1ed938d9871f947933e574cc", size = 16906, upload-time = "2025-06-06T14:41:21.448Z" }
 wheels = [
@@ -2750,7 +3106,7 @@ name = "winrt-windows-devices-bluetooth-genericattributeprofile"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/44/21/aeeddc0eccdfbd25e543360b5cc093233e2eab3cdfb53ad3cabae1b5d04d/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1.tar.gz", hash = "sha256:cdf6ddc375e9150d040aca67f5a17c41ceaf13a63f3668f96608bc1d045dde71", size = 38896, upload-time = "2025-06-06T14:41:22.687Z" }
 wheels = [
@@ -2770,7 +3126,7 @@ name = "winrt-windows-devices-enumeration"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/9e/dd/75835bfbd063dffa152109727dedbd80f6e92ea284855f7855d48cdf31c9/winrt_windows_devices_enumeration-3.2.1.tar.gz", hash = "sha256:df316899e39bfc0ffc1f3cb0f5ee54d04e1d167fbbcc1484d2d5121449a935cf", size = 23538, upload-time = "2025-06-06T14:41:26.787Z" }
 wheels = [
@@ -2790,7 +3146,7 @@ name = "winrt-windows-devices-radios"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/5e/02/9704ea359ad8b0d6faa1011f98fb477e8fb6eac5201f39d19e73c2407e7b/winrt_windows_devices_radios-3.2.1.tar.gz", hash = "sha256:4dc9b9d1501846049eb79428d64ec698d6476c27a357999b78a8331072e18a0b", size = 5908, upload-time = "2025-06-06T14:41:44.868Z" }
 wheels = [
@@ -2810,7 +3166,7 @@ name = "winrt-windows-foundation"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/0c/55/098ce7ea0679efcc1298b269c48768f010b6c68f90c588f654ec874c8a74/winrt_windows_foundation-3.2.1.tar.gz", hash = "sha256:ad2f1fcaa6c34672df45527d7c533731fdf65b67c4638c2b4aca949f6eec0656", size = 30485, upload-time = "2025-06-06T14:41:53.344Z" }
 wheels = [
@@ -2830,7 +3186,7 @@ name = "winrt-windows-foundation-collections"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/ef/62/d21e3f1eeb8d47077887bbf0c3882c49277a84d8f98f7c12bda64d498a07/winrt_windows_foundation_collections-3.2.1.tar.gz", hash = "sha256:0eff1ad0d8d763ad17e9e7bbd0c26a62b27215016393c05b09b046d6503ae6d5", size = 16043, upload-time = "2025-06-06T14:41:53.983Z" }
 wheels = [
@@ -2850,7 +3206,7 @@ name = "winrt-windows-storage-streams"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux') or (sys_platform == 'darwin' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu') or (sys_platform == 'linux' and extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/00/50/f4488b07281566e3850fcae1021f0285c9653992f60a915e15567047db63/winrt_windows_storage_streams-3.2.1.tar.gz", hash = "sha256:476f522722751eb0b571bc7802d85a82a3cae8b1cce66061e6e758f525e7b80f", size = 34335, upload-time = "2025-06-06T14:43:23.905Z" }
 wheels = [

From 33ce5b09a4fd87d1662a8e10b722aeb4565291fd Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 18:43:30 -0400
Subject: [PATCH 146/314] fix(timelapse): accept comma-separated embryo_ids
 string in start()

When an agent tool call passed embryo_ids as "embryo_1,embryo_2,..."
(a string) instead of a JSON list, start() iterated the string
character by character and reported every letter as a missing embryo
("Embryos not found: ['e','m','b','r','y','o',...]"). Coerce a string
into a list by splitting on commas before the membership check.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/orchestration/timelapse.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index f4a2692a..6b140922 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -231,6 +231,13 @@ async def start(
         # Parse stop condition
         stop_cond = self._parse_stop_condition(stop_condition, condition_value)
 
+        # Tolerate a comma-separated string: some agent tool calls pass
+        # embryo_ids as "embryo_1,embryo_2" rather than a JSON list. Without
+        # this, the membership check below iterates the string character by
+        # character and reports every letter as a missing embryo.
+        if isinstance(embryo_ids, str):
+            embryo_ids = [e.strip() for e in embryo_ids.split(",") if e.strip()]
+
         # Get embryo list
         if not embryo_ids:
             embryo_ids = [e.id for e in self.experiment.embryos.values() if not e.should_skip]

From d4496a35f73ee5a355b372e3083d5ee8f27faa7e Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 04:13:42 +0530
Subject: [PATCH 147/314] fix: bump __version__ to 0.22.0 to match release

gently/__init__.py still carried 0.22.0.dev0 while pyproject.toml and
the README were bumped to 0.22.0. Align it with the release version.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gently/__init__.py b/gently/__init__.py
index 29b0b3b4..25c8c925 100644
--- a/gently/__init__.py
+++ b/gently/__init__.py
@@ -81,7 +81,7 @@
 except ImportError:
     _VISUALIZATION_AVAILABLE = False
 
-__version__ = "0.22.0.dev0"
+__version__ = "0.22.0"
 __all__ = [
     # Main entry point
     "Gently",

From abb11fb35924d346802e9cb5c80c57daf48378f1 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Tue, 16 Jun 2026 18:48:52 -0400
Subject: [PATCH 148/314] fix(web): emit unpadded embryo ids to match the live
 convention
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The web canvas → server path fabricated a zero-padded id
(f"embryo_{number:03d}") whenever a marker arrived without an embryo_id,
producing ids like "embryo_002". Everything else — detection_tools,
the orchestrator, all tool examples — uses the unpadded
f"embryo_{n}" form, so the padded ids never matched the stored
"embryo_2" and surfaced as "Embryos not found" in start_adaptive_timelapse.

Emit unpadded ids here too. The legacy SQLite store (core/database.py)
still uses :03d but is retired/read-only; the state.py lookup shim that
tries both formats stays as a safety net for any already-stored padded ids.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/server.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index daf91dba..16641eae 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -676,7 +676,11 @@ async def wait_for_marking(self, session_id: str, timeout: float | None = None)
             embryos.append(
                 {
                     "embryo_number": m["number"],
-                    "embryo_id": m.get("embryo_id") or f"embryo_{m['number']:03d}",
+                    # Unpadded to match the live convention used everywhere else
+                    # (detection_tools registers embryos as f"embryo_{n}"). A
+                    # zero-padded fallback here produced ids like "embryo_002"
+                    # that never matched the stored "embryo_2".
+                    "embryo_id": m.get("embryo_id") or f"embryo_{m['number']}",
                     "pixel_position": (px, py),
                     "pixel_x": px,
                     "pixel_y": py,

From 68a7833aec4599d63c9a988f31ec2031f53dca77 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 04:26:18 +0530
Subject: [PATCH 149/314] lint: wrap long lines + ruff-format notebook modules
 (E501)

ruff check . and ruff format --check . both clean.
---
 gently/harness/memory/notebook.py     | 26 ++++++-------
 gently/harness/memory/notebook_ask.py |  8 ++--
 tests/test_notebook_api.py            | 20 ++++++++--
 tests/test_notebook_ask.py            | 16 ++++++--
 tests/test_notebook_store.py          | 54 +++++++++++++++++++--------
 5 files changed, 81 insertions(+), 43 deletions(-)

diff --git a/gently/harness/memory/notebook.py b/gently/harness/memory/notebook.py
index 7f3176d9..88271fa8 100644
--- a/gently/harness/memory/notebook.py
+++ b/gently/harness/memory/notebook.py
@@ -24,8 +24,8 @@
 
 class NoteKind(str, Enum):
     OBSERVATION = "observation"  # immutable record of what was seen/done/read/noted
-    FINDING = "finding"          # revisable, supersedable believed claim
-    QUESTION = "question"        # open inquiry; large ones are the thread spine
+    FINDING = "finding"  # revisable, supersedable believed claim
+    QUESTION = "question"  # open inquiry; large ones are the thread spine
 
 
 class Author(str, Enum):
@@ -35,10 +35,10 @@ class Author(str, Enum):
 
 
 class NoteStatus(str, Enum):
-    OPEN = "open"              # questions not yet answered
-    PROPOSED = "proposed"      # agent-drafted finding awaiting human confirm
-    CONFIRMED = "confirmed"    # accepted observation/finding (default)
-    ANSWERED = "answered"      # question resolved
+    OPEN = "open"  # questions not yet answered
+    PROPOSED = "proposed"  # agent-drafted finding awaiting human confirm
+    CONFIRMED = "confirmed"  # accepted observation/finding (default)
+    ANSWERED = "answered"  # question resolved
     SUPERSEDED = "superseded"  # replaced by a newer note
 
 
@@ -55,9 +55,9 @@ class Note:
     embryos: list[str] = field(default_factory=list)
     sessions: list[str] = field(default_factory=list)
     threads: list[str] = field(default_factory=list)
-    basis: list[str] = field(default_factory=list)        # note ids this rests on
-    links: list[dict] = field(default_factory=list)        # [{"rel": ..., "to": ...}]
-    artifacts: list[dict] = field(default_factory=list)    # FileStore pointers
+    basis: list[str] = field(default_factory=list)  # note ids this rests on
+    links: list[dict] = field(default_factory=list)  # [{"rel": ..., "to": ...}]
+    artifacts: list[dict] = field(default_factory=list)  # FileStore pointers
     superseded_by: str | None = None
     created_at: datetime = field(default_factory=datetime.now)
     updated_at: datetime = field(default_factory=datetime.now)
@@ -151,9 +151,7 @@ def __init__(self, notebook_dir: Path):
         self.notes_dir.mkdir(parents=True, exist_ok=True)
         self.index_dir.mkdir(parents=True, exist_ok=True)
         # reverse indexes: facet -> {value: [note_id, ...]}
-        self._index: dict[str, dict[str, list[str]]] = {
-            "strain": {}, "embryo": {}, "thread": {}
-        }
+        self._index: dict[str, dict[str, list[str]]] = {"strain": {}, "embryo": {}, "thread": {}}
         self.rebuild_index()
 
     # ---- reverse indexes (notes are authoritative; indexes are caches) ----
@@ -250,9 +248,7 @@ def query_notes(
             scope_sets.append(set(self.ids_for_embryo(embryo)))
         if thread is not None:
             scope_sets.append(set(self.ids_for_thread(thread)))
-        candidate_ids: set[str] | None = (
-            set.intersection(*scope_sets) if scope_sets else None
-        )
+        candidate_ids: set[str] | None = set.intersection(*scope_sets) if scope_sets else None
 
         # 2. load + filter
         if candidate_ids is not None:
diff --git a/gently/harness/memory/notebook_ask.py b/gently/harness/memory/notebook_ask.py
index acfed322..e8f1228c 100644
--- a/gently/harness/memory/notebook_ask.py
+++ b/gently/harness/memory/notebook_ask.py
@@ -45,7 +45,9 @@ def select_notes(
             "suggested_next": {
                 "type": "array",
                 "items": {"type": "string"},
-                "description": "Concrete next experiments/moves if the question asks what to do; else empty.",
+                "description": (
+                    "Concrete next experiments/moves if the question asks what to do; else empty."
+                ),
             },
             "coverage": {
                 "type": "string",
@@ -80,9 +82,7 @@ def _render_notes(notes: list[Note]) -> str:
 
 def build_ask_messages(question: str, notes: list[Note]) -> list[dict]:
     body = (
-        "Notebook entries:\n"
-        + _render_notes(notes)
-        + f"\n\nQuestion: {question}\n\n"
+        "Notebook entries:\n" + _render_notes(notes) + f"\n\nQuestion: {question}\n\n"
         "Answer using only these entries, citing note ids."
     )
     return [{"role": "user", "content": body}]
diff --git a/tests/test_notebook_api.py b/tests/test_notebook_api.py
index 1d18333b..408fc423 100644
--- a/tests/test_notebook_api.py
+++ b/tests/test_notebook_api.py
@@ -23,8 +23,16 @@ class _Server:
 def _seed(cs):
     nb = cs.notebook
     nb.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"]))
-    nb.write_note(Note(id="f1", kind=NoteKind.FINDING, body="rings by comma",
-                       status=NoteStatus.PROPOSED, strains=["N2"], threads=["t1"]))
+    nb.write_note(
+        Note(
+            id="f1",
+            kind=NoteKind.FINDING,
+            body="rings by comma",
+            status=NoteStatus.PROPOSED,
+            strains=["N2"],
+            threads=["t1"],
+        )
+    )
     return cs
 
 
@@ -135,8 +143,12 @@ class _Server:
 class TestAsk:
     def test_ask_returns_grounded_answer(self, file_context_store):
         cs = _seed(file_context_store)
-        canned = {"answer": "A ring formed.", "points": [{"text": "ring", "note_ids": ["o1"]}],
-                  "suggested_next": [], "coverage": "covered"}
+        canned = {
+            "answer": "A ring formed.",
+            "points": [{"text": "ring", "note_ids": ["o1"]}],
+            "suggested_next": [],
+            "coverage": "covered",
+        }
         client = TestClient(_make_app_with_client(cs, _AskClient(canned)))
         resp = client.post("/api/notebook/ask", json={"question": "what happened?"})
         assert resp.status_code == 200
diff --git a/tests/test_notebook_ask.py b/tests/test_notebook_ask.py
index 9f501090..0cf664d7 100644
--- a/tests/test_notebook_ask.py
+++ b/tests/test_notebook_ask.py
@@ -13,8 +13,12 @@
 
 def _seed(cs):
     nb = cs.notebook
-    nb.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"], threads=["t1"]))
-    nb.write_note(Note(id="f1", kind=NoteKind.FINDING, body="12 min/degC", strains=["N2"], threads=["t1"]))
+    nb.write_note(
+        Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed", strains=["N2"], threads=["t1"])
+    )
+    nb.write_note(
+        Note(id="f1", kind=NoteKind.FINDING, body="12 min/degC", strains=["N2"], threads=["t1"])
+    )
     nb.write_note(Note(id="x1", kind=NoteKind.OBSERVATION, body="unrelated", strains=["OH904"]))
     return nb
 
@@ -71,8 +75,12 @@ def test_build_messages_embeds_note_ids(self):
         assert "o1" in text and "ring formed" in text and "what formed?" in text
 
     def test_answer_returns_structured_and_forces_tool(self):
-        canned = {"answer": "A ring formed.", "points": [{"text": "ring formed", "note_ids": ["o1"]}],
-                  "suggested_next": [], "coverage": "covered"}
+        canned = {
+            "answer": "A ring formed.",
+            "points": [{"text": "ring formed", "note_ids": ["o1"]}],
+            "suggested_next": [],
+            "coverage": "covered",
+        }
         client = _FakeClient(canned)
         notes = [Note(id="o1", kind=NoteKind.OBSERVATION, body="ring formed")]
         out = asyncio.run(answer_question(client, "m", "what formed?", notes))
diff --git a/tests/test_notebook_store.py b/tests/test_notebook_store.py
index 4fdd48f7..ff8cc715 100644
--- a/tests/test_notebook_store.py
+++ b/tests/test_notebook_store.py
@@ -6,9 +6,9 @@
 from gently.harness.memory.notebook import (
     Author,
     Note,
+    NotebookStore,
     NoteKind,
     NoteStatus,
-    NotebookStore,
     learning_to_note,
     note_from_dict,
     note_to_dict,
@@ -21,8 +21,8 @@ def test_round_trip_minimal(self):
         n = Note(id="abc123", kind=NoteKind.OBSERVATION, body="dim rings at 10 ms")
         d = note_to_dict(n)
         assert d["kind"] == "observation"
-        assert d["author"] == "agent"            # default
-        assert d["status"] == "confirmed"        # default
+        assert d["author"] == "agent"  # default
+        assert d["status"] == "confirmed"  # default
         back = note_from_dict(d)
         assert back == n
 
@@ -79,15 +79,18 @@ class TestNotebookIndex:
     def test_index_updated_on_write(self, tmp_path):
         store = NotebookStore(tmp_path / "notebook")
         a = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="a", strains=["N2"]))
-        b = store.write_note(Note(id="", kind=NoteKind.OBSERVATION, body="b", strains=["N2", "OH904"]))
+        b = store.write_note(
+            Note(id="", kind=NoteKind.OBSERVATION, body="b", strains=["N2", "OH904"])
+        )
         assert set(store.ids_for_strain("N2")) == {a, b}
         assert store.ids_for_strain("OH904") == [b]
         assert store.ids_for_strain("missing") == []
 
     def test_index_by_embryo_and_thread(self, tmp_path):
         store = NotebookStore(tmp_path / "notebook")
-        a = store.write_note(Note(id="", kind=NoteKind.FINDING, body="a",
-                                  embryos=["e1"], threads=["t1"]))
+        a = store.write_note(
+            Note(id="", kind=NoteKind.FINDING, body="a", embryos=["e1"], threads=["t1"])
+        )
         assert store.ids_for_embryo("e1") == [a]
         assert store.ids_for_thread("t1") == [a]
 
@@ -103,10 +106,19 @@ class TestNotebookQuery:
     def _seed(self, tmp_path):
         store = NotebookStore(tmp_path / "notebook")
         store.write_note(Note(id="o1", kind=NoteKind.OBSERVATION, body="o", strains=["N2"]))
-        store.write_note(Note(id="f1", kind=NoteKind.FINDING, body="f",
-                              status=NoteStatus.PROPOSED, strains=["N2"], threads=["t1"]))
-        store.write_note(Note(id="q1", kind=NoteKind.QUESTION, body="q",
-                              status=NoteStatus.OPEN, threads=["t1"]))
+        store.write_note(
+            Note(
+                id="f1",
+                kind=NoteKind.FINDING,
+                body="f",
+                status=NoteStatus.PROPOSED,
+                strains=["N2"],
+                threads=["t1"],
+            )
+        )
+        store.write_note(
+            Note(id="q1", kind=NoteKind.QUESTION, body="q", status=NoteStatus.OPEN, threads=["t1"])
+        )
         return store
 
     def test_query_by_kind(self, tmp_path):
@@ -161,9 +173,14 @@ def test_supersede_marks_old_and_points_new(self, tmp_path):
 class TestConverters:
     def test_observation_to_note(self):
         obs = Observation(
-            id="o1", timestamp=datetime(2026, 6, 16, 9, 0, 0), type="milestone",
-            content="nerve ring formed", embryo_id="e1", session_id="s1",
-            relates_to=["o0"], gently_refs={"kind": "projection", "t": 42},
+            id="o1",
+            timestamp=datetime(2026, 6, 16, 9, 0, 0),
+            type="milestone",
+            content="nerve ring formed",
+            embryo_id="e1",
+            session_id="s1",
+            relates_to=["o0"],
+            gently_refs={"kind": "projection", "t": 42},
         )
         n = observation_to_note(obs)
         assert n.id == "o1"
@@ -182,7 +199,7 @@ def test_learning_to_note(self):
         assert n.id == "l1"
         assert n.kind == NoteKind.FINDING
         assert n.body == "rings form by comma"
-        assert n.status == NoteStatus.PROPOSED   # agent-drafted, awaits confirm
+        assert n.status == NoteStatus.PROPOSED  # agent-drafted, awaits confirm
         assert n.confidence == Confidence.HIGH
 
 
@@ -200,8 +217,13 @@ def test_apply_updates_mirrors_observations_and_learnings(self, file_context_sto
         from gently.harness.memory.model import ContextUpdates
 
         cs = file_context_store
-        obs = Observation(id="o1", timestamp=datetime(2026, 6, 16, 9, 0, 0),
-                          type="milestone", content="ring formed", embryo_id="e1")
+        obs = Observation(
+            id="o1",
+            timestamp=datetime(2026, 6, 16, 9, 0, 0),
+            type="milestone",
+            content="ring formed",
+            embryo_id="e1",
+        )
         lrn = Learning(id="l1", content="rings form by comma", confidence=Confidence.HIGH)
         cs.apply_updates(ContextUpdates(new_observations=[obs], new_learnings=[lrn]))
 

From 909e2400d25d96c6b21b79eb308013d139adbbc8 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Wed, 17 Jun 2026 00:22:27 +0100
Subject: [PATCH 150/314] mypy: clear gently/mesh/* type errors (Phase 4 of
 #49)

Type the mesh cluster (15 errors / 3 modules) and drop its entries from the
[[tool.mypy.overrides]] ignore list.

- peer_client.py (13 union-attr): _ensure_session() now returns the non-None
  aiohttp.ClientSession; call sites use the returned local instead of
  self._session, so mypy can prove non-None. Behavior unchanged.
- discovery.py (override): widen _MeshProtocol.connection_made to BaseTransport
  to match asyncio.BaseProtocol, narrowing to DatagramTransport via assert.
- capability_provider.py (attr-defined): targeted ignore for the Windows-only
  ctypes.windll in the platform-guarded branch.

mypy . is clean (300 files, deps-less, as CI runs); ruff check/format pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 gently/mesh/capability_provider.py |  3 +-
 gently/mesh/discovery.py           |  5 ++-
 gently/mesh/peer_client.py         | 53 +++++++++++++++---------------
 pyproject.toml                     |  3 --
 4 files changed, 33 insertions(+), 31 deletions(-)

diff --git a/gently/mesh/capability_provider.py b/gently/mesh/capability_provider.py
index 7dfc6fd1..d82f691c 100644
--- a/gently/mesh/capability_provider.py
+++ b/gently/mesh/capability_provider.py
@@ -64,7 +64,8 @@ def _get_system_info() -> dict[str, Any]:
         if platform.system() == "Windows":
             import ctypes
 
-            kernel32 = ctypes.windll.kernel32
+            # ctypes.windll exists only on Windows; this branch is platform-guarded.
+            kernel32 = ctypes.windll.kernel32  # type: ignore[attr-defined]
             mem_status = ctypes.c_ulonglong()
             kernel32.GetPhysicallyInstalledSystemMemory(ctypes.byref(mem_status))
             ram_gb = round(mem_status.value / (1024 * 1024), 1)
diff --git a/gently/mesh/discovery.py b/gently/mesh/discovery.py
index 878a9b81..ca6394ab 100644
--- a/gently/mesh/discovery.py
+++ b/gently/mesh/discovery.py
@@ -76,7 +76,10 @@ def __init__(
         self._known_ids: set = set()
         self.transport: asyncio.DatagramTransport | None = None
 
-    def connection_made(self, transport: asyncio.DatagramTransport):
+    def connection_made(self, transport: asyncio.BaseTransport) -> None:
+        # DatagramProtocol always receives a DatagramTransport here; narrow for
+        # the typed attribute (and matches the asyncio.BaseProtocol signature).
+        assert isinstance(transport, asyncio.DatagramTransport)
         self.transport = transport
 
     def datagram_received(self, data: bytes, addr: tuple):
diff --git a/gently/mesh/peer_client.py b/gently/mesh/peer_client.py
index c6db282b..b7fd81a7 100644
--- a/gently/mesh/peer_client.py
+++ b/gently/mesh/peer_client.py
@@ -29,7 +29,7 @@ def __init__(self, pairing_manager=None, audit_log=None):
         self._audit_log = audit_log
         self._pinning_verified: set = set()  # track first-success per peer
 
-    async def _ensure_session(self):
+    async def _ensure_session(self) -> aiohttp.ClientSession:
         if self._session is None or self._session.closed:
             timeout = aiohttp.ClientTimeout(total=settings.mesh.fetch_timeout_s)
             # Use permissive SSL context — we verify by cert fingerprint, not CA chain
@@ -39,6 +39,7 @@ async def _ensure_session(self):
             connector = aiohttp.TCPConnector(ssl=ssl_ctx)
             self._session = aiohttp.ClientSession(timeout=timeout, connector=connector)
             self._pinning_verified.clear()
+        return self._session
 
     def _auth_headers(self, peer: PeerInfo) -> dict[str, str]:
         """Build auth headers for a trusted peer."""
@@ -103,12 +104,12 @@ async def fetch_peer_info(self, peer: PeerInfo) -> dict[str, Any] | None:
 
         Returns the parsed JSON dict on success, or None on failure.
         """
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/mesh/status"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     return await resp.json()
@@ -126,12 +127,12 @@ async def fetch_peer_info(self, peer: PeerInfo) -> dict[str, Any] | None:
 
     async def fetch_peer_campaigns(self, peer: PeerInfo) -> list | None:
         """GET /api/campaigns from a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     data = await resp.json()
@@ -144,12 +145,12 @@ async def fetch_peer_campaigns(self, peer: PeerInfo) -> list | None:
 
     async def fetch_campaign_export(self, peer: PeerInfo, campaign_id: str) -> dict | None:
         """GET /api/campaigns/{id}/export from a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/export"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     return await resp.json()
@@ -167,12 +168,12 @@ async def join_campaign(
         hostname: str,
     ) -> bool:
         """POST /api/campaigns/{id}/join on a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/join"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.post(
+            async with session.post(
                 url,
                 json={
                     "instance_id": instance_id,
@@ -199,12 +200,12 @@ async def claim_item(
         hostname: str,
     ) -> bool:
         """POST /api/campaigns/{id}/items/{item_id}/claim on a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/items/{item_id}/claim"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.post(
+            async with session.post(
                 url,
                 json={
                     "instance_id": instance_id,
@@ -229,12 +230,12 @@ async def unclaim_item(
         item_id: str,
     ) -> bool:
         """POST /api/campaigns/{id}/items/{item_id}/unclaim on a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/items/{item_id}/unclaim"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.post(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.post(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                 return resp.status == 200
@@ -253,7 +254,7 @@ async def update_item_status(
         outcome: str | None = None,
     ) -> bool:
         """POST /api/campaigns/{id}/items/{item_id}/status on a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/campaigns/{campaign_id}/items/{item_id}/status"
         body: dict[str, Any] = {"status": status}
         if outcome is not None:
@@ -261,7 +262,7 @@ async def update_item_status(
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.post(url, json=body, headers=headers, ssl=ssl_fp) as resp:
+            async with session.post(url, json=body, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                 return resp.status == 200
@@ -305,15 +306,15 @@ async def _pairing_request(
         self, peer: PeerInfo, method: str, path: str, json_body: dict | None = None
     ) -> dict | None:
         """Make an HTTP request trying HTTPS first, then HTTP (for pre-pairing)."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         base = f"{peer.ip_address}:{peer.viz_port}"
         for scheme in ("https", "http"):
             url = f"{scheme}://{base}{path}"
             try:
                 if method == "GET":
-                    req = self._session.get(url)
+                    req = session.get(url)
                 else:
-                    req = self._session.post(url, json=json_body or {})
+                    req = session.post(url, json=json_body or {})
                 async with req as resp:
                     if resp.status == 200:
                         return await resp.json()
@@ -350,12 +351,12 @@ async def confirm_pair_remote(
 
     async def fetch_peer_sessions(self, peer: PeerInfo) -> list | None:
         """GET /api/data/sessions from a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/data/sessions"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     data = await resp.json()
@@ -368,12 +369,12 @@ async def fetch_peer_sessions(self, peer: PeerInfo) -> list | None:
 
     async def fetch_peer_session_detail(self, peer: PeerInfo, session_id: str) -> dict | None:
         """GET /api/data/sessions/{id} from a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/data/sessions/{session_id}"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     return await resp.json()
@@ -385,12 +386,12 @@ async def fetch_peer_session_detail(self, peer: PeerInfo, session_id: str) -> di
 
     async def fetch_peer_coverage(self, peer: PeerInfo) -> dict | None:
         """GET /api/data/coverage from a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/data/coverage"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     return await resp.json()
@@ -402,12 +403,12 @@ async def fetch_peer_coverage(self, peer: PeerInfo) -> dict | None:
 
     async def fetch_peer_stage_distribution(self, peer: PeerInfo) -> dict | None:
         """GET /api/data/stages from a peer."""
-        await self._ensure_session()
+        session = await self._ensure_session()
         url = f"{peer.base_url}/api/data/stages"
         headers = self._auth_headers(peer)
         ssl_fp = self._ssl_for_peer(peer)
         try:
-            async with self._session.get(url, headers=headers, ssl=ssl_fp) as resp:
+            async with session.get(url, headers=headers, ssl=ssl_fp) as resp:
                 if resp.status == 200:
                     self._log_pinning_success(peer, ssl_fp)
                     return await resp.json()
diff --git a/pyproject.toml b/pyproject.toml
index 561326b8..f4f8e417 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -218,9 +218,6 @@ module = [
     "gently.harness.session.timeline",
     "gently.harness.tools.registry",
     "gently.log_config",
-    "gently.mesh.capability_provider",
-    "gently.mesh.discovery",
-    "gently.mesh.peer_client",
     "gently.ml.data_loader",
     "gently.ml.federated",
     "gently.organisms.celegans.developmental_tracker",

From 4126f778e8ec5109bd3c9e3c5529ab551c6d82da Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Wed, 17 Jun 2026 00:44:05 +0100
Subject: [PATCH 151/314] mypy: clear gently/core/* (except legacy store) type
 errors (#49)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- service.py: guard get_info() None before .service_type access
- imaging.py: assert rotation is not None on the has-rotation path
- event_bus.py: replace default-arg lambda with functools.partial (mypy
  couldn't infer the lambda type)
- file_store.py: TypedDict boundary — _normalize_embryo_record returns
  EmbryoInfo, _append_jsonl takes Mapping[str, Any], cast read records to
  PredictionInfo, annotate sidecar/result containers

Drops the 4 cleared modules from [[tool.mypy.overrides]]. mypy . clean
(300 files); ruff clean. Legacy gently.core.store left ignored (slated for
removal in #16).
---
 gently/core/event_bus.py  |  3 ++-
 gently/core/file_store.py | 19 +++++++++++--------
 gently/core/imaging.py    |  2 ++
 gently/core/service.py    |  2 ++
 pyproject.toml            |  4 ----
 5 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 3b98e616..8a55c99f 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -9,6 +9,7 @@
 """
 
 import asyncio
+import functools
 import logging
 import threading
 import uuid
@@ -475,7 +476,7 @@ def _dispatch_async(self, event: Event):
                     else:
                         # We're in sync context, need to schedule thread-safely
                         loop.call_soon_threadsafe(
-                            lambda c=coro: asyncio.ensure_future(c, loop=loop)
+                            functools.partial(asyncio.ensure_future, coro, loop=loop)
                         )
             except Exception as e:
                 logger.error("Async handler error for %s: %s", event, e)
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 5a8b7f01..d10f9efe 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -56,9 +56,10 @@
 import socket
 import tempfile
 import time
+from collections.abc import Mapping
 from datetime import datetime
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import numpy as np
 import yaml
@@ -127,7 +128,7 @@ def _coarse_from_legacy(record: dict) -> dict | None:
     return out or None
 
 
-def _normalize_embryo_record(record: dict | None) -> dict | None:
+def _normalize_embryo_record(record: dict | None) -> EmbryoInfo | None:
     """Backfill an embryo.yaml dict so callers always see the new schema.
 
     Adds `position_coarse` derived from legacy `position_x` / `position_y` if
@@ -142,7 +143,7 @@ def _normalize_embryo_record(record: dict | None) -> dict | None:
         if backfill is not None:
             out["position_coarse"] = backfill
     out.setdefault("position_fine", None)
-    return out
+    return cast("EmbryoInfo", out)
 
 
 def _write_yaml(path: Path, data: Any) -> None:
@@ -194,7 +195,7 @@ def _read_yaml(path: Path) -> Any:
         return _sanitize_for_yaml(data)
 
 
-def _append_jsonl(path: Path, record: dict) -> None:
+def _append_jsonl(path: Path, record: Mapping[str, Any]) -> None:
     """Append a single JSON line to a JSONL file."""
     path.parent.mkdir(parents=True, exist_ok=True)
     with open(path, "a", encoding="utf-8") as f:
@@ -570,13 +571,15 @@ def list_embryos(self, session_id: str) -> list[EmbryoInfo]:
         if not embryos_dir.exists():
             return []
 
-        result = []
+        result: list[EmbryoInfo] = []
         for entry in sorted(embryos_dir.iterdir()):
             if entry.is_dir():
                 yaml_path = entry / "embryo.yaml"
                 data = _read_yaml(yaml_path)
                 if data is not None:
-                    result.append(_normalize_embryo_record(data))
+                    record = _normalize_embryo_record(data)
+                    if record is not None:
+                        result.append(record)
         return result
 
     def list_embryo_ids(self, session_id: str) -> list[str]:
@@ -916,7 +919,7 @@ def register_snapshot(
             incoming_path.unlink()
 
         # Write sidecar metadata
-        sidecar = {
+        sidecar: dict[str, Any] = {
             "session_id": session_id,
             "source": source,
             "file_path": str(canonical),
@@ -1158,7 +1161,7 @@ def get_predictions(
             for rec in records:
                 if run_id is not None and rec.get("run_id") != run_id:
                     continue
-                result.append(rec)
+                result.append(cast("PredictionInfo", rec))
 
         # Sort by timepoint, then prediction_id
         result.sort(key=lambda p: (p.get("timepoint", 0), p.get("prediction_id", 0)))
diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index 6ff46c14..0179644c 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -578,6 +578,8 @@ def _frac_to_abs(frac_range, dim_size):
         return volume[z0:z1, y0:y1, x0:x1]
 
     # Rotated clip box: build a mask in volume space
+    # has_rotation is only True when rotation is not None
+    assert rotation is not None
     # 1. Compute box half-extents in voxel coordinates
     z0, z1 = _frac_to_abs(z_range, z_depth)
     y0, y1 = _frac_to_abs(y_range, height)
diff --git a/gently/core/service.py b/gently/core/service.py
index 21876ee9..3d520e5c 100644
--- a/gently/core/service.py
+++ b/gently/core/service.py
@@ -369,6 +369,8 @@ async def call(self, service_name: str, method: str, *args, **kwargs) -> Any:
         conn = await self.connect(service_name)
 
         info = self._registry.get_info(service_name)
+        if info is None:
+            raise ValueError(f"Unknown service: {service_name}")
 
         if info.service_type == "rpc":
             # RPC call
diff --git a/pyproject.toml b/pyproject.toml
index f4f8e417..bdfd7993 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -180,10 +180,6 @@ module = [
     "gently.app.detectors.dopaminergic_signal",
     "gently.app.orchestration.timelapse",
     "gently.app.video_maker",
-    "gently.core.event_bus",
-    "gently.core.file_store",
-    "gently.core.imaging",
-    "gently.core.service",
     "gently.core.store",
     "gently.dataset.aggregator",
     "gently.dataset.embryo_dataset",

From 1dfd59160561ef9af9416aeac06bfe7e1f64c6bc Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Wed, 17 Jun 2026 01:03:18 +0100
Subject: [PATCH 152/314] mypy: clear gently/harness/* type errors (#49)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Annotate dict containers, narrow Optionals, and fix the TypedDict/Optional
boundary across the harness. Removes all 16 harness modules from
[[tool.mypy.overrides]].

Latent bugs fixed (flagged for review — no test env here):
- memory/onboarding.py: apply_ingestion_to_context annotated
  result: "IngestionResult", a type defined nowhere (dead/uncalled path) ->
  typed Any.
- conversation.py: _tool_context used in execute_tool() but never
  initialized in __init__ -> added (None default, matching the other
  agent-set attrs).
- session/manager.py: session_id property typed -> str but returns None
  before create_session(); callers (agent.py) already treat it as optional
  -> typed str | None.

Type-only changes: dict[str, Any] annotations (detector, queue, verifier,
prompts/manager, interaction_logger, registry, memory/file_store); None
guards (research doi/path, queue latest); asserts for invariants (imaging-
style: timeline storage_file, memory create-then-read); functools.partial
for an uninferable lambda; legacy ContextStore import fallbacks ignored;
TYPE_CHECKING import for the optional aiohttp annotation.

mypy . clean (300 files); ruff clean.
---
 gently/harness/conversation.py               |  1 +
 gently/harness/detection/detector.py         |  2 +-
 gently/harness/detection/queue.py            | 22 +++++++++++---------
 gently/harness/detection/verifier.py         |  2 +-
 gently/harness/memory/__init__.py            |  2 +-
 gently/harness/memory/file_store.py          | 16 +++++++++-----
 gently/harness/memory/gap_assessment.py      |  2 +-
 gently/harness/memory/onboarding.py          |  4 ++--
 gently/harness/memory/startup_wizard.py      |  2 +-
 gently/harness/microscope.py                 |  6 +++++-
 gently/harness/plan_mode/tools/research.py   |  4 ++--
 gently/harness/prompts/manager.py            |  3 ++-
 gently/harness/session/interaction_logger.py |  4 ++--
 gently/harness/session/manager.py            |  6 +++---
 gently/harness/session/timeline.py           |  2 ++
 gently/harness/tools/registry.py             |  2 +-
 pyproject.toml                               | 16 --------------
 17 files changed, 48 insertions(+), 48 deletions(-)

diff --git a/gently/harness/conversation.py b/gently/harness/conversation.py
index e154c724..6d6dcaf2 100644
--- a/gently/harness/conversation.py
+++ b/gently/harness/conversation.py
@@ -68,6 +68,7 @@ def __init__(self, client, model, tool_registry):
         self.interaction_logger = None
         self.choice_handler = None
         self.context_store = None  # for tool_label
+        self._tool_context: dict | None = None  # default execution context
 
         # Decision capture for orchestrator A/B testing. Set by the agent
         # alongside the EventCapture once the session folder is known. None
diff --git a/gently/harness/detection/detector.py b/gently/harness/detection/detector.py
index d5729681..647dd34f 100644
--- a/gently/harness/detection/detector.py
+++ b/gently/harness/detection/detector.py
@@ -219,7 +219,7 @@ def build_detection_content(
         list of dict
             Content array for Claude API
         """
-        content = []
+        content: list[dict[str, Any]] = []
 
         # Add instruction
         content.append({"type": "text", "text": f"Analyzing {embryo_id} at timepoint {timepoint}"})
diff --git a/gently/harness/detection/queue.py b/gently/harness/detection/queue.py
index f0d7ee4c..bb65504c 100644
--- a/gently/harness/detection/queue.py
+++ b/gently/harness/detection/queue.py
@@ -5,6 +5,7 @@
 import asyncio
 from collections.abc import Callable
 from datetime import datetime
+from typing import Any
 
 import anthropic
 
@@ -287,11 +288,11 @@ def get_detection_summary(self, embryo_states: dict[str, EmbryoState]) -> dict:
         dict
             Summary of detections
         """
-        summary = {"detectors": {}, "embryos": {}}
+        summary: dict[str, Any] = {"detectors": {}, "embryos": {}}
 
         # Per-detector summary
         for detector in self.registry.list_all():
-            detector_summary = {
+            detector_summary: dict[str, Any] = {
                 "name": detector.name,
                 "description": detector.description,
                 "enabled": detector.enabled,
@@ -303,19 +304,20 @@ def get_detection_summary(self, embryo_states: dict[str, EmbryoState]) -> dict:
             for embryo_id, embryo_state in embryo_states.items():
                 if embryo_state.was_detected(detector.name):
                     latest = embryo_state.get_latest_detection(detector.name)
-                    detector_summary["embryos_detected"].append(
-                        {
-                            "embryo_id": embryo_id,
-                            "timepoint": latest.get("timepoint"),
-                            "confidence": latest.get("confidence"),
-                        }
-                    )
+                    if latest is not None:
+                        detector_summary["embryos_detected"].append(
+                            {
+                                "embryo_id": embryo_id,
+                                "timepoint": latest.get("timepoint"),
+                                "confidence": latest.get("confidence"),
+                            }
+                        )
 
             summary["detectors"][detector.name] = detector_summary
 
         # Per-embryo summary
         for embryo_id, embryo_state in embryo_states.items():
-            embryo_summary = {"embryo_id": embryo_id, "detections": {}}
+            embryo_summary: dict[str, Any] = {"embryo_id": embryo_id, "detections": {}}
 
             for detector_name in embryo_state.detection_results.keys():
                 latest = embryo_state.get_latest_detection(detector_name)
diff --git a/gently/harness/detection/verifier.py b/gently/harness/detection/verifier.py
index 0370abb7..d7ce1e58 100644
--- a/gently/harness/detection/verifier.py
+++ b/gently/harness/detection/verifier.py
@@ -103,7 +103,7 @@ class VerificationResult:
 
     def to_dict(self) -> dict[str, Any]:
         """Serialize to dictionary"""
-        result = {
+        result: dict[str, Any] = {
             "original_detected": self.original_detected,
             "original_confidence": self.original_confidence.value
             if self.original_confidence
diff --git a/gently/harness/memory/__init__.py b/gently/harness/memory/__init__.py
index ce9083c0..9a3fe835 100644
--- a/gently/harness/memory/__init__.py
+++ b/gently/harness/memory/__init__.py
@@ -49,7 +49,7 @@
 try:
     from .file_store import FileContextStore
 except ImportError:
-    FileContextStore = None
+    FileContextStore = None  # type: ignore[assignment, misc]
 from .gap_assessment import ContextGapReport, Gap, GapLayer, GapSeverity, assess_gaps
 from .onboarding import (
     OnboardingMessage,
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 0531dcce..b1b612b7 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -371,7 +371,7 @@ def create_campaign(
         (folder / "plan" / "history").mkdir(exist_ok=True)
         (folder / "templates").mkdir(exist_ok=True)
 
-        data = {
+        data: dict[str, Any] = {
             "id": cid,
             "description": description,
             "shorthand": shorthand,
@@ -1803,7 +1803,7 @@ def list_plan_snapshots(
                     "created_at": s.get("created_at"),
                 }
             )
-        result.sort(key=lambda s: s.get("version_number", 0), reverse=True)
+        result.sort(key=lambda s: s.get("version_number", 0) or 0, reverse=True)
         return result[:limit]
 
     def get_plan_snapshot(self, version_id: str) -> dict | None:
@@ -2214,7 +2214,9 @@ def create_ml_pipeline(
             self.agent_dir / "ml" / "pipelines" / f"{pipeline_id}.yaml",
             data,
         )
-        return self.get_ml_pipeline(pipeline_id)
+        created = self.get_ml_pipeline(pipeline_id)
+        assert created is not None  # just written above
+        return created
 
     def get_ml_pipeline(self, pipeline_id: str) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "pipelines" / f"{pipeline_id}.yaml"
@@ -2315,7 +2317,9 @@ def create_training_run(
             self.agent_dir / "ml" / "runs" / f"{run_id}.yaml",
             data,
         )
-        return self.get_training_run(run_id)
+        created = self.get_training_run(run_id)
+        assert created is not None  # just written above
+        return created
 
     def get_training_run(self, run_id: str) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "runs" / f"{run_id}.yaml"
@@ -2418,7 +2422,9 @@ def save_data_assessment(
             self.agent_dir / "ml" / "assessments" / f"{assessment_id}.yaml",
             data,
         )
-        return self.get_data_assessment(assessment_id)
+        created = self.get_data_assessment(assessment_id)
+        assert created is not None  # just written above
+        return created
 
     def get_data_assessment(self, assessment_id: str) -> dict[str, Any] | None:
         path = self.agent_dir / "ml" / "assessments" / f"{assessment_id}.yaml"
diff --git a/gently/harness/memory/gap_assessment.py b/gently/harness/memory/gap_assessment.py
index 4b64a10b..e4465f66 100644
--- a/gently/harness/memory/gap_assessment.py
+++ b/gently/harness/memory/gap_assessment.py
@@ -15,7 +15,7 @@
 try:
     from .file_store import FileContextStore as ContextStore
 except ImportError:
-    from .store import ContextStore
+    from .store import ContextStore  # type: ignore[assignment]  # legacy fallback
 
 logger = logging.getLogger(__name__)
 
diff --git a/gently/harness/memory/onboarding.py b/gently/harness/memory/onboarding.py
index 75f24d19..823aa283 100644
--- a/gently/harness/memory/onboarding.py
+++ b/gently/harness/memory/onboarding.py
@@ -23,7 +23,7 @@
 try:
     from .file_store import FileContextStore as ContextStore
 except ImportError:
-    from .store import ContextStore
+    from .store import ContextStore  # type: ignore[assignment]  # legacy fallback
 
 
 @dataclass
@@ -430,7 +430,7 @@ def _extract_basic(
 
 
 def apply_ingestion_to_context(
-    result: "IngestionResult",  # noqa: F821
+    result: Any,  # was "IngestionResult"; that type no longer exists (dead code path)
     context_store: ContextStore,
 ) -> int:
     """
diff --git a/gently/harness/memory/startup_wizard.py b/gently/harness/memory/startup_wizard.py
index f82c706e..d10fef5b 100644
--- a/gently/harness/memory/startup_wizard.py
+++ b/gently/harness/memory/startup_wizard.py
@@ -27,7 +27,7 @@
 try:
     from .file_store import FileContextStore as ContextStore
 except ImportError:
-    from .store import ContextStore
+    from .store import ContextStore  # type: ignore[assignment]  # legacy fallback
 
 logger = logging.getLogger(__name__)
 
diff --git a/gently/harness/microscope.py b/gently/harness/microscope.py
index 6c684469..484ea060 100644
--- a/gently/harness/microscope.py
+++ b/gently/harness/microscope.py
@@ -19,6 +19,10 @@
 
 import logging
 from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import aiohttp
 
 logger = logging.getLogger(__name__)
 
@@ -151,7 +155,7 @@ class HTTPMicroscope(Microscope):
 
     def __init__(self, http_url: str):
         self.http_url = http_url
-        self._session = None
+        self._session: aiohttp.ClientSession | None = None
         self._connected = False
         self._available_plans: set[str] = set()
         self._plan_schemas: list = []  # Anthropic tool-format schemas
diff --git a/gently/harness/plan_mode/tools/research.py b/gently/harness/plan_mode/tools/research.py
index dabd92b5..c522d412 100644
--- a/gently/harness/plan_mode/tools/research.py
+++ b/gently/harness/plan_mode/tools/research.py
@@ -1258,7 +1258,7 @@ async def read_paper(
                 f"Try providing a PMID, DOI, or more specific citation."
             )
 
-    if ref_type == "doi" and not pmid:
+    if ref_type == "doi" and not pmid and doi:
         status_lines.append(f"Resolving DOI: {doi}")
         pmid = await _doi_to_pmid(doi)
         if pmid:
@@ -1269,7 +1269,7 @@ async def read_paper(
 
     # --- Step 2: Try local PDF first if file path ---
 
-    if ref_type == "file":
+    if ref_type == "file" and path:
         status_lines.append(f"Reading local PDF: {path}")
         text = _read_pdf_file(path)
         if text:
diff --git a/gently/harness/prompts/manager.py b/gently/harness/prompts/manager.py
index 9405c820..1a104cd5 100644
--- a/gently/harness/prompts/manager.py
+++ b/gently/harness/prompts/manager.py
@@ -9,6 +9,7 @@
 import json
 import logging
 from datetime import datetime
+from typing import Any
 
 from gently.settings import settings
 
@@ -241,7 +242,7 @@ def gather_context_data(self, experiment, timelapse_orch, timeline_mgr) -> dict:
         dict
             Context data including timelapse status, events, and detections
         """
-        data = {
+        data: dict[str, Any] = {
             "current_time": datetime.now().isoformat(),
             "timelapse_status": None,
             "recent_events": [],
diff --git a/gently/harness/session/interaction_logger.py b/gently/harness/session/interaction_logger.py
index 1caa1e90..73c82f8a 100644
--- a/gently/harness/session/interaction_logger.py
+++ b/gently/harness/session/interaction_logger.py
@@ -386,7 +386,7 @@ def _rewrite_with_update(self, updated: InteractionRecord):
 
     def _sanitize_state(self, state: dict[str, Any]) -> dict[str, Any]:
         """Remove large/sensitive data from state snapshot"""
-        sanitized = {}
+        sanitized: dict[str, Any] = {}
 
         # Keep summary info
         if "embryos" in state:
@@ -403,7 +403,7 @@ def _sanitize_state(self, state: dict[str, Any]) -> dict[str, Any]:
 
     def _sanitize_tool_input(self, tool_input: dict[str, Any]) -> dict[str, Any]:
         """Remove large/binary data from tool input"""
-        sanitized = {}
+        sanitized: dict[str, Any] = {}
         for key, value in tool_input.items():
             if isinstance(value, (str, int, float, bool, type(None))):
                 if isinstance(value, str) and len(value) > 500:
diff --git a/gently/harness/session/manager.py b/gently/harness/session/manager.py
index b8d12824..ce89fa67 100644
--- a/gently/harness/session/manager.py
+++ b/gently/harness/session/manager.py
@@ -26,8 +26,8 @@ def __init__(self, store, storage_path):
         self._session_id: str | None = None
 
     @property
-    def session_id(self) -> str:
-        """Get current session ID."""
+    def session_id(self) -> str | None:
+        """Get current session ID (None before create_session())."""
         return self._session_id
 
     def create_session(self):
@@ -258,7 +258,7 @@ def sanitize_loaded_messages(messages: list[dict]) -> list[dict]:
                 clean.append(msg)
                 continue
             if isinstance(content, list):
-                valid_blocks = []
+                valid_blocks: list[dict | str] = []
                 for block in content:
                     if isinstance(block, dict):
                         valid_blocks.append(block)
diff --git a/gently/harness/session/timeline.py b/gently/harness/session/timeline.py
index b0ae7b92..4df09e00 100644
--- a/gently/harness/session/timeline.py
+++ b/gently/harness/session/timeline.py
@@ -485,6 +485,7 @@ def _persist_event(self, event: TimelineEvent) -> None:
             # Ensure directory exists
             self._storage_path.mkdir(parents=True, exist_ok=True)
 
+            assert self.storage_file is not None  # implied by _storage_path guard above
             with open(self.storage_file, "a", encoding="utf-8") as f:
                 f.write(json.dumps(event.to_dict()) + "\n")
         except Exception as e:
@@ -501,6 +502,7 @@ def _rewrite_storage(self) -> None:
             with self._lock:
                 events = list(self._events)
 
+            assert self.storage_file is not None  # implied by _storage_path guard above
             with open(self.storage_file, "w", encoding="utf-8") as f:
                 for event in events:
                     f.write(json.dumps(event.to_dict()) + "\n")
diff --git a/gently/harness/tools/registry.py b/gently/harness/tools/registry.py
index 88c37241..88475b42 100644
--- a/gently/harness/tools/registry.py
+++ b/gently/harness/tools/registry.py
@@ -93,7 +93,7 @@ def to_claude_schema(self) -> dict:
         required = []
 
         for param in self.parameters:
-            prop = {
+            prop: dict[str, Any] = {
                 "type": param.type,
                 "description": param.description,
             }
diff --git a/pyproject.toml b/pyproject.toml
index bdfd7993..5c592499 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -197,22 +197,6 @@ module = [
     "gently.hardware.dispim.plans.acquisition",
     "gently.hardware.dispim.sam_detection",
     "gently.hardware.switchbot",
-    "gently.harness.conversation",
-    "gently.harness.detection.detector",
-    "gently.harness.detection.queue",
-    "gently.harness.detection.verifier",
-    "gently.harness.memory",
-    "gently.harness.memory.file_store",
-    "gently.harness.memory.gap_assessment",
-    "gently.harness.memory.onboarding",
-    "gently.harness.memory.startup_wizard",
-    "gently.harness.microscope",
-    "gently.harness.plan_mode.tools.research",
-    "gently.harness.prompts.manager",
-    "gently.harness.session.interaction_logger",
-    "gently.harness.session.manager",
-    "gently.harness.session.timeline",
-    "gently.harness.tools.registry",
     "gently.log_config",
     "gently.ml.data_loader",
     "gently.ml.federated",

From 4f864d0337dabb8642516d8336371136e3ed42e6 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Wed, 17 Jun 2026 01:27:36 +0100
Subject: [PATCH 153/314] mypy: clear gently/app/* type errors (#49)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Removes agent, benchmark, calibration.edge_roi, detectors.dopaminergic_signal,
orchestration.timelapse, and video_maker from [[tool.mypy.overrides]].

Latent bugs fixed (flagged — no test env here):
- benchmark.py: used EmbryoState.embryo_id and .position, neither of which
  exist (the fields are .id and the .stage_position property) -> would
  AttributeError whenever the hardware benchmark ran over real embryos.
- timelapse.py: `e` reassigned outside its `except ... as e:` block (mypy
  [misc]); renamed the loop var to `emb`.
- detectors/base.py: DetectorResult.raw_response typed str | None but the
  two-stage dopaminergic detector stores a dict (and timelapse.py already
  does isinstance(..., dict) on it) -> widened to str | dict | None.

Type-only changes: Optional narrowing via asserts on running-timelapse
invariants (_started_at, _trace_dir) and None guards (context_store,
lock, viz_server, first_shape); dict[str, Any] annotations (agent
embryo import + dose dict, video_maker return); session_id property
typed str | None to match SessionManager; min(..., default=) over
Optional intervals; Callable[..., Any] instead of the builtin `callable`;
TYPE_CHECKING imports for lazily-imported monitor classes; explicit
4-tuple build in edge_roi.

mypy . clean (300 files); ruff clean.
---
 gently/app/agent.py                   | 25 +++++++++++++++----------
 gently/app/benchmark.py               | 16 +++++++++-------
 gently/app/calibration/edge_roi.py    |  2 +-
 gently/app/detectors/base.py          |  2 +-
 gently/app/orchestration/timelapse.py | 15 ++++++++++-----
 gently/app/video_maker.py             |  5 +++--
 pyproject.toml                        |  6 ------
 7 files changed, 39 insertions(+), 32 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 4a5f6602..f4b6d0c2 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -27,6 +27,8 @@
 
 if TYPE_CHECKING:
     from ..ui.web.server import VisualizationServer
+    from .bottom_camera_monitor import BottomCameraStreamMonitor
+    from .device_state_monitor import DeviceStateMonitor
 from gently_perception import Perceiver
 
 from ..core import EventType, emit, get_event_bus
@@ -211,10 +213,10 @@ def __init__(
         self.viz_server: VisualizationServer | None = None
 
         # Device-state monitor (bridges device-layer SSE → EventBus)
-        self.device_state_monitor = None
+        self.device_state_monitor: DeviceStateMonitor | None = None
         # Opt-in bottom-camera stream bridge — created when viz starts, but
         # left unstarted until the operator clicks "Start camera" in the UI.
-        self.bottom_camera_monitor = None
+        self.bottom_camera_monitor: BottomCameraStreamMonitor | None = None
 
         # ===== Create delegate managers =====
 
@@ -298,7 +300,7 @@ def __init__(
         try:
             from gently.app.wake_router import WakeRouter
 
-            self.wake_router = WakeRouter(self, self._event_bus)
+            self.wake_router: WakeRouter | None = WakeRouter(self, self._event_bus)
         except Exception:
             logger.exception("Failed to init wake-router")
             self.wake_router = None
@@ -309,8 +311,8 @@ def __init__(
     # ===== Backward-Compat Delegation Properties =====
 
     @property
-    def session_id(self) -> str:
-        """Get current session ID."""
+    def session_id(self) -> str | None:
+        """Get current session ID (None before a session is created)."""
         return self.sessions.session_id
 
     @property
@@ -454,7 +456,7 @@ def exit_plan_mode(self) -> str:
             if active_id:
                 self.experiment.active_plan_item_id = active_id
                 self.memory.active_plan_item_id = active_id
-                item = self.context_store.get_plan_item(active_id)
+                item = self.context_store.get_plan_item(active_id) if self.context_store else None
                 title = item.title if item else active_id
                 result = f"Back to run mode. Active plan item: {title}"
 
@@ -1062,7 +1064,7 @@ async def handle_message_stream(self, user_message: str):
             except StopAsyncIteration:
                 return
         finally:
-            if acquired:
+            if acquired and lock is not None:
                 lock.release()
 
     async def run_wake_turn(
@@ -1231,7 +1233,7 @@ def import_embryos_from_session(self, session_id: str, clear_existing: bool = Fa
         db_embryos = self.store.list_embryos(session_id) if self.store else []
 
         # Build a unified dict keyed by embryo_id
-        embryo_states = {}
+        embryo_states: dict[str, Any] = {}
         for row in db_embryos:
             eid = row.get("embryo_id", "")
             if not eid:
@@ -1378,7 +1380,7 @@ def _compute_imported_dose(self, source_session_id: str, embryo_id: str) -> dict
 
         import yaml
 
-        result = {
+        result: dict[str, Any] = {
             "exposure_count": 0,
             "total_exposure_ms": 0.0,
             "last_imaged": None,
@@ -1582,7 +1584,10 @@ def decide_next_interval(self, timepoint: int) -> float:
         active_embryos = [e for e in self.experiment.embryos.values() if not e.should_skip]
         if not active_embryos:
             return 120.0
-        return min(e.interval_seconds for e in active_embryos)
+        return min(
+            (e.interval_seconds for e in active_embryos if e.interval_seconds is not None),
+            default=120.0,
+        )
 
     # === Perception System Integration ===
 
diff --git a/gently/app/benchmark.py b/gently/app/benchmark.py
index 9263d7fe..7ff16f8b 100644
--- a/gently/app/benchmark.py
+++ b/gently/app/benchmark.py
@@ -21,10 +21,11 @@
 import statistics
 import tempfile
 import time
+from collections.abc import Callable
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from .agent import MicroscopyAgent
@@ -141,7 +142,7 @@ async def run_benchmark(
     n_volumes: int | None = None,
     n_slices: int | None = None,
     n_warmup: int | None = None,
-    progress_fn: callable | None = None,
+    progress_fn: Callable[..., Any] | None = None,
 ) -> BenchmarkResults:
     """
     Run end-to-end volume acquisition benchmark.
@@ -164,7 +165,7 @@ async def run_benchmark(
 
     embryos = list(agent.experiment.embryos.values()) if agent.experiment.embryos else []
     use_synthetic = len(embryos) == 0
-    embryo_ids = ["benchmark_pos"] if use_synthetic else [e.embryo_id for e in embryos]
+    embryo_ids = ["benchmark_pos"] if use_synthetic else [e.id for e in embryos]
 
     results = BenchmarkResults(
         num_embryos=len(embryo_ids),
@@ -174,7 +175,6 @@ async def run_benchmark(
     )
 
     viz_server = getattr(agent, "viz_server", None)
-    has_viz = viz_server is not None
 
     temp_dir = Path(tempfile.mkdtemp(prefix="gently_benchmark_"))
     temp_store = None
@@ -233,8 +233,10 @@ async def run_benchmark(
                     galvo_amp, galvo_center = 0.5, 0.0
                     piezo_amp, piezo_center = 25.0, 50.0
 
-                if embryo and embryo.position:
-                    await agent.client.move_stage(embryo.position["x"], embryo.position["y"])
+                if embryo and embryo.stage_position:
+                    await agent.client.move_stage(
+                        embryo.stage_position["x"], embryo.stage_position["y"]
+                    )
 
                 # Stage 1: Acquisition
                 t0 = time.perf_counter()
@@ -284,7 +286,7 @@ async def run_benchmark(
 
                 # Stage 3: Viz push
                 t4 = time.perf_counter()
-                if has_viz and volume is not None:
+                if viz_server is not None and volume is not None:
                     proj = volume.max(axis=0) if volume.ndim == 3 else volume
                     await viz_server.push_image(
                         proj,
diff --git a/gently/app/calibration/edge_roi.py b/gently/app/calibration/edge_roi.py
index 25aa907a..2393c188 100644
--- a/gently/app/calibration/edge_roi.py
+++ b/gently/app/calibration/edge_roi.py
@@ -44,7 +44,7 @@ def capture(
         if precomputed:
             for _eid, bb in precomputed.items():
                 if bb is not None and len(bb) == 4:
-                    bboxes.append(tuple(map(int, bb)))
+                    bboxes.append((int(bb[0]), int(bb[1]), int(bb[2]), int(bb[3])))
         else:
             for vol in source_volumes.values():
                 bb = _bbox_from_volume(vol, padding=self.padding_px)
diff --git a/gently/app/detectors/base.py b/gently/app/detectors/base.py
index 0179061f..815685aa 100644
--- a/gently/app/detectors/base.py
+++ b/gently/app/detectors/base.py
@@ -33,7 +33,7 @@ class DetectorResult:
     findings: dict[str, Any] = field(default_factory=dict)
     confidence: float | None = None
     reasoning: str | None = None
-    raw_response: str | None = None
+    raw_response: str | dict | None = None
     timestamp: datetime = field(default_factory=datetime.now)
     elapsed_ms: float | None = None
     error: str | None = None
diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index f4a2692a..b3d78bb1 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -372,12 +372,14 @@ def _get_round_scheduled_time(self, round_num: int) -> datetime:
         datetime
             Scheduled time for the round
         """
+        assert self._started_at is not None  # only called on a running timelapse
         base_time = self._started_at + timedelta(seconds=round_num * self._base_interval_seconds)
         return base_time + self._total_pause_duration
 
     def _get_elapsed_active_time(self) -> float:
         """Get elapsed time excluding pauses, in seconds"""
         now = datetime.now()
+        assert self._started_at is not None  # only called on a running timelapse
         elapsed = (now - self._started_at).total_seconds()
         pause_seconds = self._total_pause_duration.total_seconds()
         return elapsed - pause_seconds
@@ -476,8 +478,9 @@ def _pick_next_due(self) -> tuple:
             if e.next_due_at is None:
                 e.next_due_at = now
 
-        # Find the smallest next_due_at
-        soonest = min(eligible, key=lambda e: e.next_due_at)
+        # Find the smallest next_due_at (all are set to a datetime just above)
+        soonest = min(eligible, key=lambda e: e.next_due_at or now)
+        assert soonest.next_due_at is not None
         if soonest.next_due_at <= now:
             return soonest, 0.0
 
@@ -641,10 +644,10 @@ async def _run_loop(self):
                         # event fires for each — the experiment swimlane view
                         # uses these to draw phase boundaries.
                         for eid in paused_ids:
-                            e = self._embryo_states.get(eid)
-                            if e and e.cadence_phase == "paused":
+                            emb = self._embryo_states.get(eid)
+                            if emb and emb.cadence_phase == "paused":
                                 self.transition_cadence(
-                                    e,
+                                    emb,
                                     new_phase="normal",
                                     reschedule=False,
                                     reason="burst_end:resume_paused",
@@ -1014,6 +1017,7 @@ def _evaluate_single_condition(
                 return f"reached {cond.value} timepoints"
 
         elif cond.condition_type == StopConditionType.DURATION:
+            assert self._started_at is not None  # running timelapse
             elapsed_hours = (datetime.now() - self._started_at).total_seconds() / 3600
             if elapsed_hours >= cond.value:
                 return f"reached {cond.value}h duration"
@@ -2950,6 +2954,7 @@ async def _run_perception(
     def _write_trace_file(self, embryo_id: str, timepoint: int, trace_data: dict) -> Path:
         """Write perception trace to JSON file."""
         filename = f"{embryo_id}_T{timepoint:04d}.json"
+        assert self._trace_dir is not None
         file_path = self._trace_dir / filename
         with open(file_path, "w", encoding="utf-8") as f:
             json.dump(trace_data, f, indent=2, ensure_ascii=False)
diff --git a/gently/app/video_maker.py b/gently/app/video_maker.py
index f081ae23..2ad369da 100644
--- a/gently/app/video_maker.py
+++ b/gently/app/video_maker.py
@@ -7,6 +7,7 @@
 import logging
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 import numpy as np
 
@@ -246,7 +247,7 @@ def create_timelapse_video(
                         return {"error": "Could not initialize video writer with any codec"}
 
                 # Ensure consistent frame size
-                if frame.shape != first_shape:
+                if first_shape is not None and frame.shape != first_shape:
                     frame = cv2.resize(frame, (first_shape[1], first_shape[0]))
 
                 writer.write(frame)
@@ -289,7 +290,7 @@ def make_session_videos(
     embryo_ids: list[str] | None = None,
     fps: int = 10,
     progress_callback=None,
-) -> dict[str, dict]:
+) -> dict[str, Any]:
     """
     Create videos for all embryos in a session.
 
diff --git a/pyproject.toml b/pyproject.toml
index 5c592499..e55f7656 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -174,12 +174,6 @@ module = [
     "gently.agent",
     "gently.analysis.core",
     "gently.analysis.steps",
-    "gently.app.agent",
-    "gently.app.benchmark",
-    "gently.app.calibration.edge_roi",
-    "gently.app.detectors.dopaminergic_signal",
-    "gently.app.orchestration.timelapse",
-    "gently.app.video_maker",
     "gently.core.store",
     "gently.dataset.aggregator",
     "gently.dataset.embryo_dataset",

From d2d61b80c5051967b6fa232c518b6cb4efbdc22c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 14:59:05 +0530
Subject: [PATCH 154/314] =?UTF-8?q?feat(notebook):=20record=5Fnote=20tool?=
 =?UTF-8?q?=20=E2=80=94=20agent=20writes=20human=20notes=20to=20the=20note?=
 =?UTF-8?q?book=20(connection=20C)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The agent's first notebook *write* tool (memory_tools had only recall_*). When the
user says 'note that…', the agent tidies the phrasing and saves a human-authored Note
tagged to the current session (+ embryos/strains), then emits CONTEXT_UPDATED so the
Notebook tab and Agent's-view live edge refresh. Reliable (human content), no perception
guesswork; the agentic session-summariser is deferred.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/tools/memory_tools.py | 54 ++++++++++++++++++++++++++++++++
 tests/test_record_note.py        | 39 +++++++++++++++++++++++
 2 files changed, 93 insertions(+)
 create mode 100644 tests/test_record_note.py

diff --git a/gently/app/tools/memory_tools.py b/gently/app/tools/memory_tools.py
index d58d3e5d..401d0bec 100644
--- a/gently/app/tools/memory_tools.py
+++ b/gently/app/tools/memory_tools.py
@@ -129,3 +129,57 @@ async def recall_context(
     if not memory:
         return "No memory available (context store not connected)"
     return memory.recall_full_context(campaign_id=campaign_id)
+
+
+@tool(
+    name="record_note",
+    description=(
+        "Record a note from the researcher into the shared lab notebook. Use this when the "
+        "user says 'note that…', 'add a note…', 'remember that…'. First tidy the phrasing for "
+        "clarity — keep their meaning and any specifics (numbers, strains, stages) — then save. "
+        "The note is attributed to the human and tagged to the current session."
+    ),
+    category=ToolCategory.UTILITY,
+    examples=[
+        ToolExample(
+            user_query="Note that the 4-embryo test ran clean — 329 timepoints, system nominal.",
+            tool_input={
+                "text": "Test run on 4 calibration embryos was clean: 329 timepoints, "
+                "system behaved as expected."
+            },
+        ),
+    ],
+)
+async def record_note(
+    text: str,
+    embryos: list[str] | None = None,
+    strains: list[str] | None = None,
+    context: dict | None = None,
+) -> str:
+    """Write a human-authored note into the notebook, tagged to the current session."""
+    agent = context.get("agent") if context else None
+    cs = getattr(agent, "context_store", None) if agent else None
+    if cs is None:
+        return "No notebook available (context store not connected)"
+    from gently.harness.memory.notebook import Author, Note, NoteKind
+
+    session_id = getattr(agent, "session_id", None)
+    note = Note(
+        id="",
+        kind=NoteKind.OBSERVATION,
+        body=text,
+        author=Author.HUMAN,
+        sessions=[session_id] if session_id else [],
+        embryos=embryos or [],
+        strains=strains or [],
+    )
+    note_id = cs.notebook.write_note(note)
+    # Refresh the Notebook tab + Agent's-view live edge (both ride CONTEXT_UPDATED).
+    try:
+        from gently.core.event_bus import EventType, emit
+
+        emit(EventType.CONTEXT_UPDATED, {"kind": "note"}, source="record_note")
+    except Exception:
+        pass
+    scope = "this session" if session_id else "the notebook (no active session)"
+    return f"Noted (id {note_id}) — saved to {scope}, attributed to you."
diff --git a/tests/test_record_note.py b/tests/test_record_note.py
new file mode 100644
index 00000000..ddad3559
--- /dev/null
+++ b/tests/test_record_note.py
@@ -0,0 +1,39 @@
+"""Tests for the record_note tool — human notes into the shared notebook."""
+
+import asyncio
+from types import SimpleNamespace
+
+import gently.app.tools.memory_tools  # noqa: F401 — registers record_note
+from gently.harness.tools.registry import get_tool_registry
+
+
+def _handler():
+    return get_tool_registry().get("record_note").handler
+
+
+class TestRecordNote:
+    def test_writes_human_note_tagged_to_session(self, file_context_store):
+        agent = SimpleNamespace(context_store=file_context_store, session_id="sess_1", memory=None)
+        out = asyncio.run(
+            _handler()(text="ring formed cleanly", embryos=["e1"], context={"agent": agent})
+        )
+        assert "Noted" in out
+        notes = file_context_store.notebook.query_notes()
+        assert len(notes) == 1
+        n = notes[0]
+        assert n.author.value == "human"
+        assert n.body == "ring formed cleanly"
+        assert n.sessions == ["sess_1"]
+        assert n.embryos == ["e1"]
+
+    def test_no_session_still_records(self, file_context_store):
+        agent = SimpleNamespace(context_store=file_context_store, session_id=None, memory=None)
+        asyncio.run(_handler()(text="general observation", context={"agent": agent}))
+        notes = file_context_store.notebook.query_notes()
+        assert len(notes) == 1
+        assert notes[0].sessions == []
+
+    def test_no_store_returns_message(self):
+        agent = SimpleNamespace(context_store=None, session_id=None, memory=None)
+        out = asyncio.run(_handler()(text="x", context={"agent": agent}))
+        assert "No notebook available" in out

From 83b825fe8c5b8a4bb324a2100f4a94312cbd65c9 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 15:20:02 +0530
Subject: [PATCH 155/314] =?UTF-8?q?feat(plans):=20live=20plan=20UI=20?=
 =?UTF-8?q?=E2=80=94=20PLAN=5FUPDATED=20event=20+=20campaigns.js=20refresh?=
 =?UTF-8?q?=20(connection=20A,=20live-UI=20half)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Plan-item/campaign writes (create/update/complete item, session-campaign link,
progress) now emit PLAN_UPDATED; the server already broadcasts it to /ws, and
campaigns.js subscribes + re-fetches the open campaign (debounced, preserving the
selected item). Fixes 'agent changed the plan but the UI didn't move'. The
execute_plan_item link-ordering fix (overlaps the production branch) is separate.
---
 gently/core/event_bus.py             |  4 ++++
 gently/harness/memory/file_store.py  | 15 +++++++++++++
 gently/ui/web/static/js/campaigns.js | 26 ++++++++++++++++++++++
 tests/test_plan_events.py            | 32 ++++++++++++++++++++++++++++
 4 files changed, 77 insertions(+)
 create mode 100644 tests/test_plan_events.py

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index d3ab0e7a..ce3aac03 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -97,6 +97,10 @@ class EventType(Enum):
     # drives the shared-visibility surface in the v2 UI.
     CONTEXT_UPDATED = auto()
 
+    # Plan/campaign mutated (item status, session link, new item, progress) —
+    # drives live refresh of the Plans UI.
+    PLAN_UPDATED = auto()
+
     # Operator-action events. Distinct from EMBRYOS_UPDATE because they
     # carry intent ("a human did this") rather than just state delta.
     # Candidate orchestrators can subscribe and reason about what the
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 7c153073..c1b38f0b 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -503,6 +503,7 @@ def update_campaign_progress(self, campaign_id: str, progress: str):
         data["progress"] = progress
         data["updated_at"] = self._now()
         self._write_yaml(folder / "campaign.yaml", data)
+        self._notify_plan_change(campaign_id)
 
     def update_campaign_status(self, campaign_id: str, status: Status):
         folder = self._campaign_folder(campaign_id)
@@ -832,6 +833,7 @@ def link_session_campaign(self, session_id: str, campaign_id: str):
             cids.append(campaign_id)
         data["campaign_ids"] = cids
         self._write_yaml(path, data)
+        self._notify_plan_change(campaign_id)
 
     def unlink_session_campaign(self, session_id: str, campaign_id: str):
         path = self.agent_dir / "session_intents" / f"{session_id}.yaml"
@@ -1156,6 +1158,7 @@ def create_plan_item(
         }
         items.append(item_data)
         self._write_plan_items(campaign_id, items)
+        self._notify_plan_change(campaign_id)
         logger.info(f"Created plan item {pid} [{type}] #{phase_order}: {title}")
         return pid
 
@@ -1336,10 +1339,12 @@ def update_plan_item(
             new_items = self._read_plan_items_raw(campaign_id)
             new_items.append(item)
             self._write_plan_items(campaign_id, new_items)
+            self._notify_plan_change(campaign_id)
             return
 
         item["updated_at"] = self._now()
         self._write_plan_items(old_campaign_id, items)
+        self._notify_plan_change(old_campaign_id)
 
     def complete_plan_item(self, item_id: str, outcome: str):
         self.update_plan_item(
@@ -1923,6 +1928,16 @@ def _notify_context_change(self, kind: str = "context") -> None:
         except Exception:
             pass
 
+    def _notify_plan_change(self, campaign_id: str | None = None) -> None:
+        """Emit PLAN_UPDATED so the Plans UI refreshes live when a plan item or
+        campaign changes (status, session link, new item, progress). Best-effort."""
+        try:
+            from gently.core.event_bus import EventType, emit
+
+            emit(EventType.PLAN_UPDATED, {"campaign_id": campaign_id}, source="context_store")
+        except Exception:
+            pass
+
     def add_expectation(self, exp: Expectation):
         path = self.agent_dir / "active" / "expectations.yaml"
         items = self._read_yaml(path) or []
diff --git a/gently/ui/web/static/js/campaigns.js b/gently/ui/web/static/js/campaigns.js
index da1bd515..dd68e54a 100644
--- a/gently/ui/web/static/js/campaigns.js
+++ b/gently/ui/web/static/js/campaigns.js
@@ -132,6 +132,13 @@ function boot() {
     // Plan view switcher
     setupPlanViewSwitcher();
 
+    // Live refresh: re-fetch the active campaign when the plan changes (item status,
+    // session link, new item, progress). The store emits PLAN_UPDATED, the server
+    // broadcasts it to /ws, and websocket.js re-emits it on the client bus.
+    if (typeof ClientEventBus !== 'undefined') {
+        ClientEventBus.on('PLAN_UPDATED', () => scheduleCampaignRefresh());
+    }
+
     // Load campaigns — auto-selects first, or the specified one
     const initialId = window.INITIAL_CAMPAIGN_ID;
     if (initialId) {
@@ -268,6 +275,25 @@ async function openCampaign(campaignId) {
     renderAll();
 }
 
+// Live refresh of the open campaign (debounced) — re-fetch its tree and re-render,
+// preserving the selected item so the inspector reflects the change without a reload.
+let _planRefreshTimer = null;
+function scheduleCampaignRefresh() {
+    if (_planRefreshTimer) clearTimeout(_planRefreshTimer);
+    _planRefreshTimer = setTimeout(() => {
+        _planRefreshTimer = null;
+        refreshActiveCampaign().catch(() => {});
+    }, 400);
+}
+async function refreshActiveCampaign() {
+    if (!state.activeCampaignId) return;
+    const keep = state.selectedItemId;
+    await loadDocument(state.activeCampaignId);
+    if (!state.docData) return;
+    renderAll();
+    if (keep) selectItem(keep).catch(() => {});
+}
+
 // Handle browser back/forward
 window.addEventListener('popstate', e => {
     const s = e.state;
diff --git a/tests/test_plan_events.py b/tests/test_plan_events.py
new file mode 100644
index 00000000..f91b786a
--- /dev/null
+++ b/tests/test_plan_events.py
@@ -0,0 +1,32 @@
+"""Plan writes emit PLAN_UPDATED so the Plans UI can refresh live."""
+
+from gently.core.event_bus import EventType, on
+from gently.harness.memory.model import PlanItemStatus
+
+
+class TestPlanUpdatedEvent:
+    def test_plan_writes_emit_plan_updated(self, file_context_store):
+        cs = file_context_store
+        seen = []
+        unsub = on(EventType.PLAN_UPDATED, lambda e: seen.append(e))
+        try:
+            cid = cs.create_campaign(description="test campaign")
+            iid = cs.create_plan_item(campaign_id=cid, type="imaging", title="pilot")
+            cs.update_plan_item(iid, status=PlanItemStatus.IN_PROGRESS, session_id="sess_1")
+            cs.complete_plan_item(iid, outcome="done")
+        finally:
+            unsub()
+        # create_plan_item + update_plan_item + complete_plan_item(→update) each fire it
+        assert len(seen) >= 3
+        assert any((e.data or {}).get("campaign_id") == cid for e in seen)
+
+    def test_session_campaign_link_emits(self, file_context_store):
+        cs = file_context_store
+        seen = []
+        unsub = on(EventType.PLAN_UPDATED, lambda e: seen.append(e))
+        try:
+            cid = cs.create_campaign(description="c")
+            cs.link_session_campaign("sess_9", cid)
+        finally:
+            unsub()
+        assert any((e.data or {}).get("campaign_id") == cid for e in seen)

From e1f698e703b2902c732e216ad6e98d0d6b849f55 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 15:29:08 +0530
Subject: [PATCH 156/314] =?UTF-8?q?fix(plans):=20reliable=20session?=
 =?UTF-8?q?=E2=86=94item=20linking,=20one=20item=20=E2=86=94=20many=20sess?=
 =?UTF-8?q?ions=20(connection=20A,=20link-fix)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

execute_plan_item linked before the session existed (agent.session_id was None) and
swallowed errors → running from a spec never linked. Now: start first, then link
(re-read session_id), append via link_plan_item_session, surface failures. Same
item-level link added to attach_session_to_plan. PlanItem gains session_ids (an item
can run many sessions: re-runs/multi-sitting); session_id kept as the latest for
back-compat. All link writes emit PLAN_UPDATED (live UI).
---
 gently/app/tools/plan_execution_tools.py | 38 ++++++++++++------------
 gently/app/tools/resolution_tools.py     |  6 ++--
 gently/harness/memory/file_store.py      | 29 ++++++++++++++++++
 gently/harness/memory/model.py           |  3 +-
 tests/test_plan_events.py                | 17 +++++++++++
 5 files changed, 71 insertions(+), 22 deletions(-)

diff --git a/gently/app/tools/plan_execution_tools.py b/gently/app/tools/plan_execution_tools.py
index f07e8af0..6fba52e1 100644
--- a/gently/app/tools/plan_execution_tools.py
+++ b/gently/app/tools/plan_execution_tools.py
@@ -107,24 +107,9 @@ async def execute_plan_item(
                 except Exception as e:
                     actions.append(f"detector '{det_name}' failed: {e}")
 
-    # 6. Link session to campaign
-    session_id = getattr(agent, "session_id", None)
-    if session_id:
-        try:
-            cs.link_session_campaign(session_id, item.campaign_id)
-            actions.append("session linked to campaign")
-        except Exception:
-            pass
-
-    # 7. Update plan item status
-    cs.update_plan_item(
-        item_id=item.id,
-        status=PlanItemStatus.IN_PROGRESS,
-        session_id=session_id,
-    )
-    actions.append("plan item status → in_progress")
-
-    # 8. Start timelapse via orchestrator
+    # 6. Start timelapse via orchestrator — this is what activates the session, so the
+    #    plan↔session link must happen AFTER it (step 7), not before (the old bug:
+    #    agent.session_id was still None here, so the link silently dropped).
     orchestrator = getattr(agent, "timelapse_orchestrator", None)
     if orchestrator:
         try:
@@ -158,7 +143,22 @@ async def execute_plan_item(
         except Exception as e:
             actions.append(f"timelapse start error: {e}")
 
-    # 10. Summary
+    # 7. Link this run to the plan item + campaign — AFTER start, so the session exists.
+    #    Appends (an item may run several sessions). Surface failures, don't swallow.
+    session_id = getattr(agent, "session_id", None)
+    if session_id:
+        try:
+            cs.link_session_campaign(session_id, item.campaign_id)
+            cs.link_plan_item_session(item.id, session_id)
+            actions.append(
+                f"linked session {session_id[:8]} → plan item + campaign (status → in_progress)"
+            )
+        except Exception as e:
+            actions.append(f"⚠ link failed: {e}")
+    else:
+        actions.append("⚠ no active session — could not link this run to the plan item")
+
+    # Summary
     lines = [f"Executing plan item: {item.title}"]
     if spec.strain:
         lines.append(f"  Strain: {spec.strain}")
diff --git a/gently/app/tools/resolution_tools.py b/gently/app/tools/resolution_tools.py
index c3a152da..3ae8b4cc 100644
--- a/gently/app/tools/resolution_tools.py
+++ b/gently/app/tools/resolution_tools.py
@@ -112,15 +112,17 @@ async def attach_session_to_plan(
     # Two sources of truth for the active plan item
     _set_active_plan_item(agent, item.id)
 
-    # Link the session into the campaign's intent record
+    # Link the session into the campaign's intent record AND onto the plan item
+    # itself (item-level, appends — an item may have several sessions).
     session_id = getattr(agent, "session_id", None)
     linked = False
     if session_id:
         try:
             cs.link_session_campaign(session_id, item.campaign_id)
+            cs.link_plan_item_session(item.id, session_id)
             linked = True
         except Exception as e:
-            logger.warning(f"link_session_campaign failed: {e}")
+            logger.warning(f"session↔plan link failed: {e}")
 
     # Invalidate prompt cache so the next system prompt picks up the
     # active item (the memory awareness layer injects its spec).
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index c1b38f0b..52607253 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1147,6 +1147,7 @@ def create_plan_item(
             "inherit_from": inherit_from,
             "planned_session_id": planned_session_id,
             "session_id": None,
+            "session_ids": [],
             "estimated_days": estimated_days,
             "phase_order": phase_order,
             "references": references,
@@ -1353,6 +1354,33 @@ def complete_plan_item(self, item_id: str, outcome: str):
             outcome=outcome,
         )
 
+    def link_plan_item_session(
+        self, item_id: str, session_id: str, set_in_progress: bool = True
+    ) -> bool:
+        """Attach a session to a plan item — APPENDS (an item may run several times:
+        re-runs, multi-sitting, more embryos later). Records the session as the latest
+        `session_id` (back-compat), flips a PLANNED item to IN_PROGRESS, emits PLAN_UPDATED.
+        Returns False if the item isn't found."""
+        loc = self._find_plan_item_location(item_id)
+        if not loc:
+            return False
+        campaign_id, items, idx = loc
+        item = items[idx]
+        sids = item.get("session_ids") or (
+            [item["session_id"]] if item.get("session_id") else []
+        )
+        if session_id and session_id not in sids:
+            sids.append(session_id)
+        item["session_ids"] = sids
+        if sids:
+            item["session_id"] = sids[-1]  # most recent run; back-compat for older readers
+        if set_in_progress and item.get("status") == "planned":
+            item["status"] = PlanItemStatus.IN_PROGRESS.value
+        item["updated_at"] = self._now()
+        self._write_plan_items(campaign_id, items)
+        self._notify_plan_change(campaign_id)
+        return True
+
     def skip_plan_item(self, item_id: str, reason: str | None = None):
         self.update_plan_item(
             item_id,
@@ -2620,6 +2648,7 @@ def _dict_to_plan_item(d: dict) -> PlanItem:
             bench_spec=bench_spec,
             planned_session_id=d.get("planned_session_id"),
             session_id=d.get("session_id"),
+            session_ids=d.get("session_ids") or ([d["session_id"]] if d.get("session_id") else []),
             inherit_from=d.get("inherit_from"),
             estimated_days=d.get("estimated_days"),
             phase_order=d.get("phase_order", 0),
diff --git a/gently/harness/memory/model.py b/gently/harness/memory/model.py
index 3757a0fe..e9e6532d 100644
--- a/gently/harness/memory/model.py
+++ b/gently/harness/memory/model.py
@@ -292,7 +292,8 @@ class PlanItem:
 
     # Linking
     planned_session_id: str | None = None  # → PlannedSession (for imaging items)
-    session_id: str | None = None  # → Actual session (once executed)
+    session_id: str | None = None  # → most recent actual session (back-compat / "primary")
+    session_ids: list[str] = field(default_factory=list)  # all sessions that ran this item (1→many)
     inherit_from: str | None = None  # PlanItem ID to inherit spec from
 
     # Scheduling — relative timeline from Day 0
diff --git a/tests/test_plan_events.py b/tests/test_plan_events.py
index f91b786a..ca28f9a9 100644
--- a/tests/test_plan_events.py
+++ b/tests/test_plan_events.py
@@ -30,3 +30,20 @@ def test_session_campaign_link_emits(self, file_context_store):
         finally:
             unsub()
         assert any((e.data or {}).get("campaign_id") == cid for e in seen)
+
+
+class TestLinkPlanItemSession:
+    def test_append_many_sessions(self, file_context_store):
+        cs = file_context_store
+        cid = cs.create_campaign(description="c")
+        iid = cs.create_plan_item(campaign_id=cid, type="imaging", title="x")
+        assert cs.link_plan_item_session(iid, "s1") is True
+        assert cs.link_plan_item_session(iid, "s2") is True
+        cs.link_plan_item_session(iid, "s1")  # duplicate — no-op
+        item = cs.get_plan_item(iid)
+        assert item.session_ids == ["s1", "s2"]  # appended, deduped
+        assert item.session_id == "s2"  # latest, for back-compat readers
+        assert item.status == PlanItemStatus.IN_PROGRESS  # PLANNED → IN_PROGRESS on first link
+
+    def test_missing_item_returns_false(self, file_context_store):
+        assert file_context_store.link_plan_item_session("nope", "s1") is False

From a3b649c74eb6f1d2ab8a2a1aedaff5bf954ca02d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 15:38:16 +0530
Subject: [PATCH 157/314] lint: ruff-format file_store.py (fixes CI format
 check on integration)

---
 gently/harness/memory/file_store.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 52607253..ececeba2 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1366,9 +1366,7 @@ def link_plan_item_session(
             return False
         campaign_id, items, idx = loc
         item = items[idx]
-        sids = item.get("session_ids") or (
-            [item["session_id"]] if item.get("session_id") else []
-        )
+        sids = item.get("session_ids") or ([item["session_id"]] if item.get("session_id") else [])
         if session_id and session_id not in sids:
             sids.append(session_id)
         item["session_ids"] = sids

From 0d1cdebaf44fed909b71a548d69662cd51dc0ba6 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 15:38:16 +0530
Subject: [PATCH 158/314] feat(plans): plan narrative in agent context + fix
 provenance spec-table render
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Connection B: the run-mode awareness summary now carries the investigation goal,
phase, and what's next (incl. decision-point flag) — not just the active item's spec
sheet — so the agent runs as a scientist inside the experiment. Laser power was always
in the brief/inspector; it just wasn't *set* in plans (connection D will let you fill it).
Also fixes renderSpecTable showing 'provenance [object Object]' — nested objects are now
skipped.
---
 gently/harness/memory/interface.py   | 35 ++++++++++++++++++++++++----
 gently/ui/web/static/js/campaigns.js |  3 +++
 tests/test_plan_context.py           | 29 +++++++++++++++++++++++
 3 files changed, 63 insertions(+), 4 deletions(-)
 create mode 100644 tests/test_plan_context.py

diff --git a/gently/harness/memory/interface.py b/gently/harness/memory/interface.py
index 2e27db8d..d6824a69 100644
--- a/gently/harness/memory/interface.py
+++ b/gently/harness/memory/interface.py
@@ -215,15 +215,42 @@ def get_awareness_summary(self) -> str:
                         spec = self.store.resolve_imaging_spec(item)
                         campaign = self.store.get_campaign(item.campaign_id)
                         campaign_name = _short_name(campaign) if campaign else "?"
+                        # Walk to the root campaign for the overall goal (the item's
+                        # campaign may be a phase under it).
+                        root = campaign
+                        seen_ids: set[str] = set()
+                        while root and root.parent_id and root.parent_id not in seen_ids:
+                            seen_ids.add(root.id)
+                            root = self.store.get_campaign(root.parent_id)
                         lines.append(f"\n## Active Plan Item: {item.title}")
-                        lines.append(f"Campaign: {campaign_name}")
+                        if root and root.target:
+                            lines.append(f"Goal of the investigation: {root.target}")
+                        if campaign and root and campaign.id != root.id:
+                            lines.append(f"Phase: {campaign_name}")
+                        lines.append(f"Campaign: {_short_name(root) if root else campaign_name}")
                         lines.append(f"Status: {item.status.value}")
                         if spec:
                             lines.append(self.format_imaging_spec_block(spec))
+                        # What's next — the items/gates this run unblocks.
+                        try:
+                            root_id = root.id if root else item.campaign_id
+                            nxt = [
+                                u
+                                for u in self.store.get_unblocked_plan_items(root_id)
+                                if u.id != item.id
+                            ][:3]
+                            if nxt:
+                                bits = []
+                                for u in nxt:
+                                    is_dp = u.type.value == "decision_point"
+                                    bits.append(u.title + (" (decision point)" if is_dp else ""))
+                                lines.append("Next up: " + "; ".join(bits))
+                        except Exception:
+                            pass
                         lines.append(
-                            "\nUse this spec when configuring embryos and "
-                            "starting the timelapse. The user expects these "
-                            "settings from their experimental plan."
+                            "\nYou're executing this item within the plan above — use the "
+                            "spec to configure and run, and keep the goal and what's next in "
+                            "mind (you can make go/no-go calls). The user expects these settings."
                         )
                 except Exception:
                     pass
diff --git a/gently/ui/web/static/js/campaigns.js b/gently/ui/web/static/js/campaigns.js
index dd68e54a..16d1dce8 100644
--- a/gently/ui/web/static/js/campaigns.js
+++ b/gently/ui/web/static/js/campaigns.js
@@ -1077,6 +1077,9 @@ function renderSpecTable(spec) {
     let rows = '';
     for (const [key, value] of Object.entries(spec)) {
         if (value == null || key.startsWith('_')) continue;
+        // Skip nested objects (e.g. provenance metadata) — they'd render as
+        // "[object Object]". Field-level provenance isn't a spec value to show here.
+        if (typeof value === 'object' && !Array.isArray(value)) continue;
         const label = SPEC_LABELS[key] || key;
         let display = Array.isArray(value) ? value.join(', ') : String(value);
         if (SPEC_UNITS[key]) display += SPEC_UNITS[key];
diff --git a/tests/test_plan_context.py b/tests/test_plan_context.py
new file mode 100644
index 00000000..acf97ffe
--- /dev/null
+++ b/tests/test_plan_context.py
@@ -0,0 +1,29 @@
+"""Connection B: the running agent's awareness summary carries the plan narrative
+(goal + what's next), not just the active item's spec sheet."""
+
+from gently.harness.memory.interface import AgentMemory
+
+
+def test_awareness_includes_goal_and_next(file_context_store):
+    cs = file_context_store
+    cid = cs.create_campaign(
+        description="Pioneer guidance", target="how pioneers steer the nerve ring"
+    )
+    active = cs.create_plan_item(
+        campaign_id=cid,
+        type="imaging",
+        title="WT baseline",
+        spec={"strain": "N2", "num_slices": 50, "laser_wavelength_nm": 488, "laser_power_pct": 8},
+    )
+    cs.create_plan_item(campaign_id=cid, type="decision_point", title="Go/no-go gate")
+
+    mem = AgentMemory(cs, session_id="s1")
+    mem.active_plan_item_id = active
+    summary = mem.get_awareness_summary()
+
+    assert "Goal of the investigation: how pioneers steer the nerve ring" in summary
+    assert "Next up:" in summary
+    assert "Go/no-go gate (decision point)" in summary
+    # spec block still present, incl. laser power when the field is set
+    assert "WT baseline" in summary
+    assert "Laser: 488nm at 8%" in summary

From bb54ab6da5b5ab725aace579ed5400eae7d5782b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 17 Jun 2026 16:02:32 +0530
Subject: [PATCH 159/314] Connection D: editable/fillable imaging specs in the
 plan inspector
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Closes the laser-power loop. The inspector was read-only and only
surfaced fields that were already set, so a TBD value like laser power
had no way in.

- PATCH /api/campaigns/{cid}/items/{item_id} — edits item fields and
  merges partial imaging-spec updates (send one field, keep the rest;
  empty string clears). Routes through update_plan_item, which fires
  PLAN_UPDATED, so the edit shows live (connection A).
- campaigns.js: ✎ Edit toggles the spec into a form listing every
  fillable field — empty ones included and flagged — PATCHes changed
  fields on Save, then re-fetches. Mid-edit guard so a live refresh
  doesn't clobber unsaved input.
- tests: PATCH route (edit, spec-merge, clear, PLAN_UPDATED, 400/404).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/campaigns.py      |  52 +++++++++
 gently/ui/web/static/css/campaigns.css |  83 ++++++++++++++
 gently/ui/web/static/js/campaigns.js   | 149 ++++++++++++++++++++++++-
 tests/test_plan_item_patch.py          |  96 ++++++++++++++++
 4 files changed, 374 insertions(+), 6 deletions(-)
 create mode 100644 tests/test_plan_item_patch.py

diff --git a/gently/ui/web/routes/campaigns.py b/gently/ui/web/routes/campaigns.py
index a3fea08c..b0dbae11 100644
--- a/gently/ui/web/routes/campaigns.py
+++ b/gently/ui/web/routes/campaigns.py
@@ -321,6 +321,58 @@ async def _require(request: Request):
 
         return _require
 
+    @router.patch(
+        "/api/campaigns/{campaign_id}/items/{item_id}",
+        dependencies=[Depends(_make_campaign_auth("campaigns"))],
+    )
+    async def update_item(campaign_id: str, item_id: str, request: Request):
+        """Edit plan-item fields and/or imaging-spec fields inline.
+
+        Send only the fields you're changing. Spec edits are *merged* into the
+        existing spec, so the UI can PATCH a single field (e.g. laser_power_pct)
+        without losing the rest. An empty string clears a spec field to null.
+        Persists via update_plan_item, which fires PLAN_UPDATED for live refresh.
+        """
+        cs = _get_store()
+        _resolve(cs, campaign_id)
+        item = cs.get_plan_item(item_id)
+        if not item:
+            raise HTTPException(status_code=404, detail="Plan item not found")
+
+        body = await request.json()
+        if not isinstance(body, dict):
+            raise HTTPException(status_code=400, detail="Body must be a JSON object")
+
+        kwargs: dict[str, Any] = {}
+        for f in ("title", "description", "outcome"):
+            if isinstance(body.get(f), str):
+                kwargs[f] = body[f]
+        if body.get("estimated_days") is not None:
+            kwargs["estimated_days"] = body["estimated_days"]
+
+        if body.get("status"):
+            try:
+                kwargs["status"] = PlanItemStatus(body["status"])
+            except ValueError as err:
+                raise HTTPException(
+                    status_code=400, detail=f"Invalid status: {body['status']}"
+                ) from err
+
+        spec_patch = body.get("spec")
+        if isinstance(spec_patch, dict):
+            current = item.imaging_spec or item.bench_spec
+            merged = asdict(current) if current else {}
+            for k, v in spec_patch.items():
+                merged[k] = None if v == "" else v
+            kwargs["spec"] = merged
+
+        if not kwargs:
+            raise HTTPException(status_code=400, detail="No editable fields supplied")
+
+        cs.update_plan_item(item_id=item_id, **kwargs)  # fires PLAN_UPDATED
+        updated = cs.get_plan_item(item_id)
+        return {"ok": True, "item": _serialize(updated)}
+
     @router.post(
         "/api/campaigns/{campaign_id}/share",
         dependencies=[Depends(_make_campaign_auth("campaigns:admin"))],
diff --git a/gently/ui/web/static/css/campaigns.css b/gently/ui/web/static/css/campaigns.css
index bc4f36c2..88690dec 100644
--- a/gently/ui/web/static/css/campaigns.css
+++ b/gently/ui/web/static/css/campaigns.css
@@ -1284,6 +1284,89 @@
     font-size: 0.7rem;
 }
 
+/* Section title with a right-aligned action (e.g. Edit) */
+.detail-section-title--row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+}
+.detail-section-action { display: inline-flex; }
+.spec-edit-btn {
+    border: 1px solid var(--border);
+    background: transparent;
+    color: var(--text-muted);
+    border-radius: 6px;
+    padding: 2px 8px;
+    font: inherit;
+    font-size: 0.62rem;
+    letter-spacing: 0.3px;
+    cursor: pointer;
+}
+.spec-edit-btn:hover { color: var(--text); border-color: var(--text-muted); }
+
+/* Editable imaging-spec form */
+.spec-editor { display: flex; flex-direction: column; gap: 6px; }
+.spec-edit-row {
+    display: grid;
+    grid-template-columns: 38% 1fr;
+    align-items: center;
+    gap: 10px;
+}
+.spec-edit-label {
+    color: var(--text-muted);
+    font-size: 0.7rem;
+}
+.spec-edit-row--empty .spec-edit-label::after {
+    content: ' • set';
+    color: var(--accent-orange, #d98324);
+    font-size: 0.6rem;
+    opacity: 0.8;
+}
+.spec-edit-field { display: flex; align-items: center; gap: 5px; }
+.spec-edit-input {
+    flex: 1;
+    min-width: 0;
+    background: var(--bg, #fff);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    padding: 4px 7px;
+    color: var(--text);
+    font-family: 'SF Mono', 'Fira Code', monospace;
+    font-size: 0.7rem;
+}
+.spec-edit-input:focus {
+    outline: none;
+    border-color: var(--accent, #2f6df6);
+}
+.spec-edit-row--empty .spec-edit-input {
+    border-style: dashed;
+}
+.spec-edit-unit { color: var(--text-muted); font-size: 0.66rem; }
+.spec-edit-error {
+    color: var(--accent-orange, #d98324);
+    font-size: 0.68rem;
+    margin-top: 2px;
+}
+.spec-edit-actions { display: flex; gap: 8px; margin-top: 8px; }
+.spec-save-btn, .spec-cancel-btn {
+    border-radius: 7px;
+    padding: 5px 14px;
+    font: inherit;
+    font-size: 0.72rem;
+    font-weight: 600;
+    cursor: pointer;
+}
+.spec-save-btn {
+    background: var(--accent, #2f6df6);
+    color: #fff;
+    border: 0;
+}
+.spec-cancel-btn {
+    background: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border);
+}
+
 /* Dependencies / Dependents chips */
 .dep-list {
     display: flex;
diff --git a/gently/ui/web/static/js/campaigns.js b/gently/ui/web/static/js/campaigns.js
index 16d1dce8..6a3c3799 100644
--- a/gently/ui/web/static/js/campaigns.js
+++ b/gently/ui/web/static/js/campaigns.js
@@ -40,6 +40,18 @@ const SPEC_UNITS = {
     laser_power_pct: '%', interval_s: 's', estimated_duration_h: ' hrs',
     estimated_days: ' days',
 };
+// Imaging-spec fields the inspector lets you edit/fill inline (ordered for the form).
+// Empty ones still show \u2014 that's how you fill a TBD value like laser power.
+const IMAGING_SPEC_FIELDS = [
+    'strain', 'genotype', 'reporter', 'sample_prep', 'temperature_c', 'num_embryos',
+    'num_slices', 'exposure_ms', 'laser_wavelength_nm', 'laser_power_pct', 'interval_s',
+    'target_window', 'start_stage', 'stop_condition', 'estimated_duration_h',
+    'success_criteria', 'comparison_to',
+];
+const SPEC_NUMERIC = new Set([
+    'temperature_c', 'num_embryos', 'num_slices', 'exposure_ms', 'laser_wavelength_nm',
+    'laser_power_pct', 'interval_s', 'estimated_duration_h',
+]);
 
 // ── State ────────────────────────────────────────────────
 const state = {
@@ -52,6 +64,9 @@ const state = {
     versions: [],               // snapshots list
     viewingSnapshotId: null,
     allItemsFlat: {},           // id → item for quick lookup
+    editingSpec: false,         // inspector imaging-spec edit mode
+    _inspectorData: null,       // last item-detail payload (for re-render on edit toggle)
+    _specError: '',             // inline save error in the spec editor
 };
 
 // ── DOM refs (cached on init) ────────────────────────────
@@ -123,6 +138,9 @@ function boot() {
             case 'back-to-current': backToCurrent(); break;
             case 'scroll-to': e.stopPropagation(); scrollCanvasTo(el.dataset.target); break;
             case 'toggle-phase': toggleNavPhase(el); break;
+            case 'spec-edit': e.stopPropagation(); startSpecEdit(); break;
+            case 'spec-cancel': e.stopPropagation(); cancelSpecEdit(); break;
+            case 'spec-save': e.stopPropagation(); saveSpecEdit(); break;
         }
     });
 
@@ -291,7 +309,8 @@ async function refreshActiveCampaign() {
     await loadDocument(state.activeCampaignId);
     if (!state.docData) return;
     renderAll();
-    if (keep) selectItem(keep).catch(() => {});
+    // Don't clobber an in-progress spec edit with a re-fetch.
+    if (keep && !state.editingSpec) selectItem(keep).catch(() => {});
 }
 
 // Handle browser back/forward
@@ -606,6 +625,12 @@ function renderVersionHistory() {
 // ══════════════════════════════════════════════════════════
 
 async function selectItem(itemId) {
+    // A re-fetch of the same item (e.g. after saving) keeps view mode; switching
+    // to a different item always lands in read-only.
+    if (itemId !== state.selectedItemId) {
+        state.editingSpec = false;
+        state._specError = '';
+    }
     state.selectedItemId = itemId;
 
     // Highlight in document
@@ -644,6 +669,7 @@ async function selectItem(itemId) {
 }
 
 function renderInspector(data) {
+    state._inspectorData = data;
     const item = data.item;
     const deps = data.dependencies || [];
     const dnts = data.dependents || [];
@@ -689,9 +715,20 @@ function renderInspector(data) {
         html += section('Outcome', `<div class="detail-section-content">${esc(item.outcome)}</div>`);
     }
 
-    // Imaging spec
-    if (item.imaging_spec) {
-        html += section('Imaging Specification', `<table class="spec-table">${renderSpecTable(item.imaging_spec)}</table>`);
+    // Imaging spec — view, or edit/fill inline (the laser-power loop). Shown for any
+    // imaging item even when no spec is set yet, so empty fields can be filled.
+    if (item.type === 'imaging' || item.imaging_spec) {
+        const spec = item.imaging_spec || {};
+        if (state.editingSpec) {
+            html += section('Imaging Specification', renderSpecEditor(spec));
+        } else {
+            const rows = renderSpecTable(spec);
+            const content = rows
+                ? `<table class="spec-table">${rows}</table>`
+                : '<div class="detail-section-content" style="color:var(--text-muted);font-style:italic">No parameters set yet</div>';
+            const editBtn = '<button class="spec-edit-btn" data-action="spec-edit">✎ Edit</button>';
+            html += section('Imaging Specification', content, editBtn);
+        }
     }
 
     // Bench spec
@@ -767,6 +804,104 @@ function renderInspector(data) {
     if ($inspectorBody) $inspectorBody.innerHTML = html;
 }
 
+// Editable imaging-spec form. Lists every fillable field — empty ones included,
+// flagged — so a TBD value (e.g. laser power) is obvious and one click away.
+function renderSpecEditor(spec) {
+    let rows = '';
+    for (const key of IMAGING_SPEC_FIELDS) {
+        const label = SPEC_LABELS[key] || key;
+        const val = spec[key];
+        const has = val != null && val !== '';
+        const numeric = SPEC_NUMERIC.has(key);
+        const unit = SPEC_UNITS[key]
+            ? `<span class="spec-edit-unit">${esc(SPEC_UNITS[key].trim())}</span>` : '';
+        const rowCls = has ? 'spec-edit-row' : 'spec-edit-row spec-edit-row--empty';
+        rows += `<div class="${rowCls}">
+            <label class="spec-edit-label" for="spec-${key}">${esc(label)}</label>
+            <span class="spec-edit-field">
+                <input id="spec-${key}" class="spec-edit-input" data-spec-key="${key}"
+                    type="${numeric ? 'number' : 'text'}"${numeric ? ' step="any"' : ''}
+                    value="${has ? esc(String(val)) : ''}" placeholder="not set">${unit}
+            </span>
+        </div>`;
+    }
+    const err = state._specError
+        ? `<div class="spec-edit-error">${esc(state._specError)}</div>` : '';
+    return `<div class="spec-editor">
+        ${rows}
+        ${err}
+        <div class="spec-edit-actions">
+            <button class="spec-save-btn" data-action="spec-save">Save</button>
+            <button class="spec-cancel-btn" data-action="spec-cancel">Cancel</button>
+        </div>
+    </div>`;
+}
+
+function startSpecEdit() {
+    if (!state._inspectorData) return;
+    state.editingSpec = true;
+    state._specError = '';
+    renderInspector(state._inspectorData);
+}
+
+function cancelSpecEdit() {
+    state.editingSpec = false;
+    state._specError = '';
+    if (state._inspectorData) renderInspector(state._inspectorData);
+}
+
+// Collect changed/filled fields and PATCH them. The store fires PLAN_UPDATED,
+// which live-refreshes the plan; we also re-fetch the inspector for immediacy.
+async function saveSpecEdit() {
+    const data = state._inspectorData;
+    const item = data && data.item;
+    const campaignId = state.activeCampaignId;
+    if (!item || !campaignId) return;
+
+    const orig = item.imaging_spec || {};
+    const specPatch = {};
+    document.querySelectorAll('#inspector-body [data-spec-key]').forEach(inp => {
+        const key = inp.dataset.specKey;
+        const raw = inp.value.trim();
+        const hadVal = orig[key] != null && orig[key] !== '';
+        if (raw === '') {
+            if (hadVal) specPatch[key] = '';   // cleared an existing value → unset
+            return;                            // stayed empty → skip
+        }
+        let v = raw;
+        if (SPEC_NUMERIC.has(key)) {
+            const n = Number(raw);
+            if (!Number.isNaN(n)) v = n;
+        }
+        if (String(orig[key] ?? '') !== String(v)) specPatch[key] = v;
+    });
+
+    state.editingSpec = false;
+    state._specError = '';
+    if (Object.keys(specPatch).length === 0) {
+        selectItem(item.id).catch(() => {});   // nothing changed — just leave edit mode
+        return;
+    }
+
+    try {
+        const res = await fetch(
+            `/api/campaigns/${encodeURIComponent(campaignId)}/items/${encodeURIComponent(item.id)}`,
+            {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ spec: specPatch }),
+            },
+        );
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        selectItem(item.id).catch(() => {});    // refresh inspector now; PLAN_UPDATED refreshes the plan
+    } catch (err) {
+        console.error('Failed to save spec:', err);
+        state.editingSpec = true;
+        state._specError = 'Could not save — try again.';
+        renderInspector(data);
+    }
+}
+
 // Hand a planned imaging item to the agent to execute. The agent resolves the
 // item ref, applies its spec, and starts the timelapse (execute_plan_item). We
 // open the chat so the user sees it pick up and can confirm/adjust.
@@ -1069,8 +1204,10 @@ function hideLoading() {
     $canvasLoading?.classList.add('hidden');
 }
 
-function section(title, content) {
-    return `<div class="detail-section"><div class="detail-section-title">${title}</div>${content}</div>`;
+function section(title, content, headerAction) {
+    const extra = headerAction ? `<span class="detail-section-action">${headerAction}</span>` : '';
+    const titleCls = headerAction ? 'detail-section-title detail-section-title--row' : 'detail-section-title';
+    return `<div class="detail-section"><div class="${titleCls}">${title}${extra}</div>${content}</div>`;
 }
 
 function renderSpecTable(spec) {
diff --git a/tests/test_plan_item_patch.py b/tests/test_plan_item_patch.py
new file mode 100644
index 00000000..b6303f0c
--- /dev/null
+++ b/tests/test_plan_item_patch.py
@@ -0,0 +1,96 @@
+"""Connection D: inline edits to plan items / imaging specs via PATCH.
+
+The inspector PATCHes changed fields; the store fires PLAN_UPDATED so the
+Plans UI refreshes live. Spec edits merge into the existing spec.
+"""
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+
+def _make_app(context_store):
+    from gently.ui.web.routes.campaigns import create_router
+
+    app = FastAPI()
+
+    class _Server:
+        pass
+
+    server = _Server()
+    server.context_store = context_store
+    app.include_router(create_router(server))
+    return app
+
+
+def _seed_imaging(cs):
+    cid = cs.create_campaign(description="c", target="goal")
+    iid = cs.create_plan_item(
+        campaign_id=cid,
+        type="imaging",
+        title="WT baseline",
+        spec={"strain": "N2", "laser_wavelength_nm": 488},
+    )
+    return cid, iid
+
+
+class TestPatchItem:
+    def test_edit_title_and_status(self, file_context_store):
+        cid, iid = _seed_imaging(file_context_store)
+        client = TestClient(_make_app(file_context_store))
+        r = client.patch(
+            f"/api/campaigns/{cid}/items/{iid}",
+            json={"title": "WT baseline (rev)", "status": "in_progress"},
+        )
+        assert r.status_code == 200
+        assert r.json()["ok"] is True
+        item = file_context_store.get_plan_item(iid)
+        assert item.title == "WT baseline (rev)"
+        assert item.status.value == "in_progress"
+
+    def test_fill_laser_power_merges_spec(self, file_context_store):
+        cid, iid = _seed_imaging(file_context_store)
+        client = TestClient(_make_app(file_context_store))
+        r = client.patch(
+            f"/api/campaigns/{cid}/items/{iid}",
+            json={"spec": {"laser_power_pct": 8}},
+        )
+        assert r.status_code == 200
+        item = file_context_store.get_plan_item(iid)
+        # the filled field is set...
+        assert item.imaging_spec.laser_power_pct == 8
+        # ...and the pre-existing spec fields survive the merge
+        assert item.imaging_spec.strain == "N2"
+        assert item.imaging_spec.laser_wavelength_nm == 488
+
+    def test_empty_string_clears_field(self, file_context_store):
+        cid, iid = _seed_imaging(file_context_store)
+        client = TestClient(_make_app(file_context_store))
+        r = client.patch(f"/api/campaigns/{cid}/items/{iid}", json={"spec": {"strain": ""}})
+        assert r.status_code == 200
+        item = file_context_store.get_plan_item(iid)
+        assert item.imaging_spec.strain is None
+
+    def test_patch_fires_plan_updated(self, file_context_store):
+        from gently.core.event_bus import EventType, on
+
+        cid, iid = _seed_imaging(file_context_store)
+        client = TestClient(_make_app(file_context_store))
+        seen = []
+        unsub = on(EventType.PLAN_UPDATED, lambda e: seen.append(e))
+        try:
+            client.patch(f"/api/campaigns/{cid}/items/{iid}", json={"title": "x"})
+        finally:
+            unsub()
+        assert any((e.data or {}).get("campaign_id") == cid for e in seen)
+
+    def test_no_fields_is_400(self, file_context_store):
+        cid, iid = _seed_imaging(file_context_store)
+        client = TestClient(_make_app(file_context_store))
+        r = client.patch(f"/api/campaigns/{cid}/items/{iid}", json={})
+        assert r.status_code == 400
+
+    def test_missing_item_is_404(self, file_context_store):
+        cid, _ = _seed_imaging(file_context_store)
+        client = TestClient(_make_app(file_context_store))
+        r = client.patch(f"/api/campaigns/{cid}/items/nope", json={"title": "x"})
+        assert r.status_code == 404

From eb2c3f303fd5d7624a5ad2847e88f1be191e7fb1 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Wed, 17 Jun 2026 11:34:21 +0100
Subject: [PATCH 160/314] mypy: clear gently/hardware/* type errors (#49)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Removes all 9 hardware modules from [[tool.mypy.overrides]].

Latent bugs fixed (flagged — no test env here):
- devices/camera.py: BottomCamera.__init__ annotated led_control: "DiSPIMLED"
  but never imported the type (mypy name-defined) -> added TYPE_CHECKING
  import from .optical.
- devices/test_temperature_controller.py: __main__ demo re-imports
  AcuityNanoPrecisionThermalizerAPI, shadowing the in-file test double
  (no-redef) -> targeted ignore.

Type-only changes: annotate Optional instance attrs (client _session,
device_layer system/devices/plans/history, camera _last_image(_time),
acquisition num_slices/exposure/laser_config, sam _predictor/_mask_generator);
dict[str, Any] for accumulator dicts inferred too narrowly (device_factory
devices, device_layer extract results, sam result/changes/verification/
review_r2/results, plans results, switchbot status, client plan_kwargs/
result); assert _session not-None at use sites after connect(); `or 0`
guard on a piezo-position read; 4-tuple/float coercions.

mypy . clean (300 files); ruff clean.
---
 gently/hardware/dispim/client.py              | 21 +++++++++++++++----
 gently/hardware/dispim/device_factory.py      |  3 ++-
 gently/hardware/dispim/device_layer.py        | 17 ++++++++-------
 gently/hardware/dispim/devices/acquisition.py |  6 +++---
 gently/hardware/dispim/devices/camera.py      |  8 +++++--
 .../devices/test_temperature_controller.py    |  4 +++-
 gently/hardware/dispim/plans/acquisition.py   |  4 ++--
 gently/hardware/dispim/sam_detection.py       | 17 ++++++++-------
 gently/hardware/switchbot.py                  |  3 ++-
 pyproject.toml                                |  9 --------
 10 files changed, 53 insertions(+), 39 deletions(-)

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 2e4567e1..4aafaa8f 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -61,7 +61,7 @@ def __init__(
         """
         self.http_url = http_url
 
-        self._session = None  # aiohttp session
+        self._session: aiohttp.ClientSession | None = None  # aiohttp session
         self._qs_connected = False  # Track actual queue server connection
         self._sam_available = False  # Track SAM availability via HTTP
 
@@ -82,6 +82,7 @@ async def connect(self) -> bool:
 
         # Connect to Device Layer Server (HTTP API)
         try:
+            assert self._session is not None
             async with self._session.get(f"{self.http_url}/api/status") as resp:
                 if resp.status == 200:
                     await resp.json()  # Validate response
@@ -94,6 +95,7 @@ async def connect(self) -> bool:
         # Check SAM availability (via HTTP, same server)
         if self._qs_connected:
             try:
+                assert self._session is not None
                 async with self._session.get(f"{self.http_url}/api/sam/status") as resp:
                     if resp.status == 200:
                         sam_status = await resp.json()
@@ -148,6 +150,7 @@ async def health_check(self, timeout: float = 2.0) -> bool:
             return False
 
         try:
+            assert self._session is not None
             async with self._session.get(
                 f"{self.http_url}/api/status",
                 timeout=aiohttp.ClientTimeout(total=timeout),
@@ -189,6 +192,7 @@ async def configure_device_session(self, volume_dir: str) -> dict:
             ``{"success": True, "volume_dir": "..."}`` on success.
         """
         self._ensure_connected()
+        assert self._session is not None
         async with self._session.post(
             f"{self.http_url}/session/configure",
             json={"volume_dir": volume_dir},
@@ -253,12 +257,14 @@ def _walk(obj, key_path=""):
     async def _api_get(self, path: str) -> dict:
         """GET request using the shared session."""
         self._ensure_connected()
+        assert self._session is not None
         async with self._session.get(f"{self.http_url}{path}") as resp:
             return await resp.json()
 
     async def _api_post(self, path: str, json: dict | None = None) -> dict:
         """POST request using the shared session."""
         self._ensure_connected()
+        assert self._session is not None
         async with self._session.post(f"{self.http_url}{path}", json=json) as resp:
             return await resp.json()
 
@@ -294,6 +300,7 @@ async def _submit_plan_and_wait(
         }
 
         try:
+            assert self._session is not None
             async with self._session.post(
                 f"{self.http_url}/api/queue/item/add",
                 json=payload,
@@ -407,7 +414,7 @@ async def get_piezo_position(self) -> float:
                         if isinstance(val, (int, float)):
                             return float(val)
                         if isinstance(val, dict):
-                            return float(val.get("z", val.get("position", 0)))
+                            return float(val.get("z", val.get("position", 0)) or 0)
 
         raise DeviceLayerError("Failed to read piezo position")
 
@@ -429,7 +436,7 @@ async def calibrate_piezo_galvo(
         dict
             Calibration results with optimal positions
         """
-        plan_kwargs = {"lightsheet_snap": "lightsheet_snap"}
+        plan_kwargs: dict[str, Any] = {"lightsheet_snap": "lightsheet_snap"}
         if piezo_positions is not None:
             plan_kwargs["piezo_positions"] = piezo_positions
         if galvo_positions is not None:
@@ -792,6 +799,7 @@ async def get_laser_power(self, wavelength: int) -> dict:
         direct, no queue.
         """
         try:
+            assert self._session is not None
             async with self._session.get(
                 f"{self.http_url}/api/light_source/power",
                 params={"wavelength": int(wavelength)},
@@ -872,6 +880,7 @@ async def stream_device_states(self, timeout: float | None = None):
             sock_connect=10.0,
         )
         url = f"{self.http_url}/api/devices/stream"
+        assert self._session is not None
         async with self._session.get(url, timeout=client_timeout) as resp:
             resp.raise_for_status()
             buf = b""
@@ -919,6 +928,7 @@ async def stream_bottom_camera(self, timeout: float | None = None):
             sock_connect=10.0,
         )
         url = f"{self.http_url}/api/bottom_camera/stream"
+        assert self._session is not None
         async with self._session.get(url, timeout=client_timeout) as resp:
             resp.raise_for_status()
             buf = b""
@@ -1058,6 +1068,7 @@ async def detect_embryos(
             if exposure_ms is not None:
                 payload["exposure_ms"] = exposure_ms
 
+            assert self._session is not None
             async with self._session.post(
                 f"{self.http_url}/api/detect_embryos", json=payload, timeout=300
             ) as resp:
@@ -1207,7 +1218,7 @@ async def view_embryos(
                     }
                 )
 
-            result = {"success": True, "num_embryos": len(embryos)}
+            result: dict[str, Any] = {"success": True, "num_embryos": len(embryos)}
             if save_path:
                 from pathlib import Path as _Path
 
@@ -1283,6 +1294,7 @@ async def _get_server_status(self) -> dict:
         # Device Layer Server status
         if self._session:
             try:
+                assert self._session is not None
                 async with self._session.get(f"{self.http_url}/api/status") as resp:
                     if resp.status == 200:
                         server_status = await resp.json()
@@ -1302,6 +1314,7 @@ async def _get_server_status(self) -> dict:
         # SAM status (via HTTP, same server)
         if self._session and self._qs_connected:
             try:
+                assert self._session is not None
                 async with self._session.get(f"{self.http_url}/api/sam/status") as resp:
                     if resp.status == 200:
                         sam_status = await resp.json()
diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index e914b1b1..f66dd9e9 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -5,6 +5,7 @@
 """
 
 import logging
+from typing import Any
 
 import pymmcore
 
@@ -76,7 +77,7 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
         default_config.update(config)
     cfg = default_config
 
-    devices = {}
+    devices: dict[str, Any] = {}
 
     # Create individual devices first
     scanner = None
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 6d606621..df31720d 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -77,10 +77,11 @@ def __init__(
         super().__init__(name="device-layer", service_type="hardware", host=host, port=port)
         self.config_path = config_path
         self.config = None
-        self.system = None  # DiSPIMSystem facade — only place this process touches MMCore directly
+        # DiSPIMSystem facade — only place this process touches MMCore directly
+        self.system: Any = None
         self.RE = None
-        self.devices = {}
-        self.plans = {}
+        self.devices: dict[str, Any] = {}
+        self.plans: dict[str, Any] = {}
 
         # SAM configuration
         self._sam_device = sam_device
@@ -93,11 +94,11 @@ def __init__(
         self._running = False
 
         # Results storage (simple in-memory)
-        self._run_history = []
-        self._last_documents = {}
+        self._run_history: list[Any] = []
+        self._last_documents: dict[str, Any] = {}
 
         # Plan execution timing log
-        self._plan_execution_log = []
+        self._plan_execution_log: list[Any] = []
 
         # Volume staging directory - set via POST /session/configure
         # When set, large numpy arrays are written as TIFF files instead of
@@ -2361,7 +2362,7 @@ def _extract_position(self, documents: dict, params: dict) -> dict:
     def _extract_volume(self, documents: dict, params: dict) -> dict:
         val = self._extract_from_events(documents, ["volume_scanner", "camera", "camera_image"])
         if val is not None:
-            result = {"success": True}
+            result: dict[str, Any] = {"success": True}
             if isinstance(val, dict) and val.get("__file_ref__"):
                 result["volume"] = val  # file ref — client resolves
                 result["shape"] = val.get("shape")
@@ -2385,7 +2386,7 @@ def _extract_image(self, documents: dict, params: dict) -> dict:
             ],
         )
         if val is not None:
-            result = {"success": True}
+            result: dict[str, Any] = {"success": True}
             if isinstance(val, dict) and val.get("__file_ref__"):
                 result["image"] = val
                 result["shape"] = val.get("shape")
diff --git a/gently/hardware/dispim/devices/acquisition.py b/gently/hardware/dispim/devices/acquisition.py
index 9b2658ef..98d443b2 100644
--- a/gently/hardware/dispim/devices/acquisition.py
+++ b/gently/hardware/dispim/devices/acquisition.py
@@ -84,9 +84,9 @@ def __init__(
         self._configured = False
 
         # Configuration cache
-        self._num_slices = None
-        self._exposure_ms = None
-        self._laser_config = None
+        self._num_slices: int | None = None
+        self._exposure_ms: float | None = None
+        self._laser_config: str | None = None
 
     def configure(
         self,
diff --git a/gently/hardware/dispim/devices/camera.py b/gently/hardware/dispim/devices/camera.py
index 5141d6d4..db6bb881 100644
--- a/gently/hardware/dispim/devices/camera.py
+++ b/gently/hardware/dispim/devices/camera.py
@@ -5,6 +5,7 @@
 import logging
 import time
 from collections import OrderedDict
+from typing import TYPE_CHECKING, Any
 
 import numpy as np
 import pymmcore
@@ -14,6 +15,9 @@
 
 from ._common import _safe_obtain
 
+if TYPE_CHECKING:
+    from .optical import DiSPIMLED
+
 logger = logging.getLogger(__name__)
 
 
@@ -28,8 +32,8 @@ def __init__(self, device_name: str, core: pymmcore.CMMCore):
         self.name = device_name
         self.core = core
         self.parent = None  # Required for Bluesky
-        self._last_image = None
-        self._last_image_time = None
+        self._last_image: Any = None
+        self._last_image_time: float | None = None
 
     def _ensure_active(self) -> None:
         """Make this the default MMCore camera if it isn't already.
diff --git a/gently/hardware/dispim/devices/test_temperature_controller.py b/gently/hardware/dispim/devices/test_temperature_controller.py
index 2bed40c6..683de006 100644
--- a/gently/hardware/dispim/devices/test_temperature_controller.py
+++ b/gently/hardware/dispim/devices/test_temperature_controller.py
@@ -97,7 +97,9 @@ def wait_for_target(self, timeout_seconds=300):
 if __name__ == "__main__":
     import time
 
-    from acuitynano_precision_thermalizer_api import AcuityNanoPrecisionThermalizerAPI
+    from acuitynano_precision_thermalizer_api import (  # type: ignore[no-redef]
+        AcuityNanoPrecisionThermalizerAPI,
+    )
 
     acuity = AcuityNanoPrecisionThermalizerAPI()
     print("Commanding ACUITYnano to 37.0 C...")
diff --git a/gently/hardware/dispim/plans/acquisition.py b/gently/hardware/dispim/plans/acquisition.py
index 02aabba8..d3d082e6 100644
--- a/gently/hardware/dispim/plans/acquisition.py
+++ b/gently/hardware/dispim/plans/acquisition.py
@@ -419,7 +419,7 @@ def focus_sweep_plan(
         Results dictionary with positions, images, scores, and best focus info
     """
     # Prepare storage for results
-    results = {
+    results: dict[str, Any] = {
         "galvo_positions": galvo_positions,
         "images": [],
         "focus_scores": [],
@@ -770,7 +770,7 @@ def on_done(event):
 
         logger.info("Embryo #%d centered!", embryo_number)
 
-    results = {}
+    results: dict[str, Any] = {}
     yield from inner()
     return results
 
diff --git a/gently/hardware/dispim/sam_detection.py b/gently/hardware/dispim/sam_detection.py
index cea9990a..49bc4a82 100644
--- a/gently/hardware/dispim/sam_detection.py
+++ b/gently/hardware/dispim/sam_detection.py
@@ -12,6 +12,7 @@
 import uuid
 from io import BytesIO
 from pathlib import Path
+from typing import Any
 
 import anthropic
 import cv2
@@ -78,8 +79,8 @@ def __init__(
         self.min_separation_pixels = 100
 
         # SAM models (lazy loaded)
-        self._mask_generator = None
-        self._predictor = None
+        self._mask_generator: Any = None
+        self._predictor: Any = None
 
     def _load_sam(self):
         """Lazy load SAM models"""
@@ -512,8 +513,8 @@ async def detect_embryos(
 
         # Claude review (if enabled)
         embryos_final = embryos_sam
-        verification = {"verified": True, "skipped": not use_claude_review}
-        changes = {"round1": {"removed": [], "added": []}}
+        verification: dict[str, Any] = {"verified": True, "skipped": not use_claude_review}
+        changes: dict[str, Any] = {"round1": {"removed": [], "added": []}}
 
         if use_claude_review and self.claude_client:
             logger.info("[2/4] Claude Vision review (Round 1)...")
@@ -544,7 +545,7 @@ async def detect_embryos(
 
             if has_r2_changes:
                 logger.info("Applying Round 2 corrections...")
-                review_r2 = {
+                review_r2: dict[str, Any] = {
                     "false_positives": verification.get("additional_false_positives", []),
                     "false_negatives": verification.get("additional_false_negatives", []),
                 }
@@ -571,7 +572,7 @@ async def detect_embryos(
             cv2.imwrite(str(output_dir / "detection_final.png"), final_viz)
 
         # Package results
-        results = {
+        results: dict[str, Any] = {
             "embryos": embryo_positions,
             "initial_detections": len(embryos_sam),
             "final_detections": len(embryos_final),
@@ -650,7 +651,7 @@ def _detect_with_sam(self, image: np.ndarray) -> tuple[list[dict], np.ndarray]:
         # Sort by quality and apply spatial separation
         embryo_candidates.sort(key=lambda x: x["area"] * x["stability_score"], reverse=True)
 
-        selected_embryos = []
+        selected_embryos: list[Any] = []
         for candidate in embryo_candidates:
             if len(selected_embryos) >= self.max_embryos:
                 break
@@ -898,7 +899,7 @@ def _apply_corrections(
     ) -> tuple[list[dict], dict]:
         """Apply Claude's corrections (from test script)"""
         corrected = []
-        changes = {"removed": [], "added": []}
+        changes: dict[str, Any] = {"removed": [], "added": []}
 
         # Remove false positives
         false_positives = set(review.get("false_positives", []))
diff --git a/gently/hardware/switchbot.py b/gently/hardware/switchbot.py
index a295a082..bd9ae9e8 100644
--- a/gently/hardware/switchbot.py
+++ b/gently/hardware/switchbot.py
@@ -29,6 +29,7 @@
 import threading
 import time
 from collections import OrderedDict
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -167,7 +168,7 @@ def read_status(self) -> dict:
         """
         with self._lock:
             data = asyncio.run(_send_command(self.address, _QUERY_STATUS, self.timeout))
-        info = {
+        info: dict[str, Any] = {
             "raw_hex": data.hex(),
             "battery_pct": data[_STATUS_BATTERY_IDX] if len(data) > _STATUS_BATTERY_IDX else None,
             "firmware": data[_STATUS_FIRMWARE_IDX] if len(data) > _STATUS_FIRMWARE_IDX else None,
diff --git a/pyproject.toml b/pyproject.toml
index e55f7656..1eb92a24 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -182,15 +182,6 @@ module = [
     "gently.eval.decision_log",
     "gently.eval.event_capture",
     "gently.gently",
-    "gently.hardware.dispim.client",
-    "gently.hardware.dispim.device_factory",
-    "gently.hardware.dispim.device_layer",
-    "gently.hardware.dispim.devices.acquisition",
-    "gently.hardware.dispim.devices.camera",
-    "gently.hardware.dispim.devices.test_temperature_controller",
-    "gently.hardware.dispim.plans.acquisition",
-    "gently.hardware.dispim.sam_detection",
-    "gently.hardware.switchbot",
     "gently.log_config",
     "gently.ml.data_loader",
     "gently.ml.federated",

From 2be35879457c39e6cea60590124f5e305861d854 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Wed, 17 Jun 2026 12:05:04 +0100
Subject: [PATCH 161/314] mypy: clear gently library modules (ui, ml, eval,
 analysis, organisms, top-level) (#49)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Removes 19 modules from [[tool.mypy.overrides]] (ui.web routes + server +
strategy_snapshot, ml.data_loader/federated, eval.decision_log/event_capture,
analysis.core/steps, organisms.celegans.developmental_tracker, detection,
log_config, gently top-level __init__/gently.py/agent, launch_gently).

Latent bugs fixed (flagged — no test env here):
- ml/federated.py: results from gather(return_exceptions=True) were filtered
  with isinstance(result, Exception), which misses non-Exception
  BaseExceptions -> use isinstance(..., BaseException).
- ui/web/server.py: VisualizationServer.mesh_service / agent_bridge were set
  from launch_gently but never declared on the class -> declared in __init__.

Type-only changes: dict[str, Any]/list[Any] container annotations; Optional
attr annotations (eval file handles, viz/predictor None-inits) with
TYPE_CHECKING imports; frozenset annotation on EventCapture.DEFAULT_SKIP;
coerce strategy_snapshot embryo_id to str key; legacy optional-import-to-None
ignores (__init__ FileContextStore, agent create_devices, data_loader Dataset
stub); targeted arg-type ignores where float(None) is caught by except;
list[str|None] for the chrome-path candidates; str(log_dir/...) consistency.

mypy . clean (300 files); ruff clean.
---
 gently/__init__.py                            |  2 +-
 gently/agent/__init__.py                      |  2 +-
 gently/analysis/core.py                       |  2 +-
 gently/analysis/steps.py                      |  2 +-
 gently/detection.py                           |  3 +-
 gently/eval/decision_log.py                   |  2 +-
 gently/eval/event_capture.py                  |  7 ++-
 gently/gently.py                              |  9 ++-
 gently/log_config.py                          |  2 +-
 gently/ml/data_loader.py                      |  6 +-
 gently/ml/federated.py                        |  2 +-
 .../celegans/developmental_tracker.py         |  2 +-
 gently/ui/web/routes/agent_ws.py              |  2 +-
 gently/ui/web/routes/campaigns.py             |  2 +-
 gently/ui/web/routes/data.py                  |  6 +-
 gently/ui/web/routes/volumes.py               |  3 +-
 gently/ui/web/routes/websocket.py             |  3 +-
 gently/ui/web/server.py                       |  4 ++
 gently/ui/web/strategy_snapshot.py            |  2 +-
 launch_gently.py                              |  4 +-
 pyproject.toml                                | 56 -------------------
 21 files changed, 39 insertions(+), 84 deletions(-)

diff --git a/gently/__init__.py b/gently/__init__.py
index 29b0b3b4..5278af1f 100644
--- a/gently/__init__.py
+++ b/gently/__init__.py
@@ -18,7 +18,7 @@
 try:
     from .harness.memory.file_store import FileContextStore
 except ImportError:
-    FileContextStore = None
+    FileContextStore = None  # type: ignore[assignment, misc]
 # Core infrastructure
 from .core import (
     EventBus,
diff --git a/gently/agent/__init__.py b/gently/agent/__init__.py
index 6ef11680..f09c3bc5 100644
--- a/gently/agent/__init__.py
+++ b/gently/agent/__init__.py
@@ -16,7 +16,7 @@
 try:
     from gently.hardware.dispim.device_factory import create_devices_from_mmcore
 except ImportError:
-    create_devices_from_mmcore = None
+    create_devices_from_mmcore = None  # type: ignore[assignment]
 # Import tools package to register all tools
 from gently.app import tools  # noqa: F401
 from gently.app.benchmark import (
diff --git a/gently/analysis/core.py b/gently/analysis/core.py
index d5f93b57..180bfffb 100644
--- a/gently/analysis/core.py
+++ b/gently/analysis/core.py
@@ -130,7 +130,7 @@ def add_point(self, position: float, score: float) -> dict[str, Any]:
         self.positions.append(position)
         self.scores.append(score)
 
-        result = {
+        result: dict[str, Any] = {
             "should_stop": False,
             "reason": None,
             "confidence": 0.0,
diff --git a/gently/analysis/steps.py b/gently/analysis/steps.py
index 24577eb4..2da335c0 100644
--- a/gently/analysis/steps.py
+++ b/gently/analysis/steps.py
@@ -518,7 +518,7 @@ def __init__(
         self.model_path = model_path or "sam_vit_b_01ec64.pth"
         self.min_area = min_area
         self._sam = None
-        self._predictor = None
+        self._predictor: Any = None
 
     def _load_sam(self):
         """Lazy load SAM model"""
diff --git a/gently/detection.py b/gently/detection.py
index 4c4e567e..3a19b3e3 100644
--- a/gently/detection.py
+++ b/gently/detection.py
@@ -10,6 +10,7 @@
 """
 
 import logging
+from typing import Any
 
 import numpy as np
 from scipy.ndimage import (
@@ -234,7 +235,7 @@ def detect_multiple_embryos(
         regions.sort(key=lambda x: x["size"], reverse=True)
 
         # Filter out overlapping regions
-        selected_regions = []
+        selected_regions: list[Any] = []
         for region in regions:
             if len(selected_regions) >= max_embryos:
                 break
diff --git a/gently/eval/decision_log.py b/gently/eval/decision_log.py
index f8aa334d..f973dd0a 100644
--- a/gently/eval/decision_log.py
+++ b/gently/eval/decision_log.py
@@ -129,7 +129,7 @@ class DecisionLog:
 
     def __init__(self, path: Path):
         self.path = Path(path)
-        self._fp = None
+        self._fp: Any = None
         self._lock = threading.Lock()
         self._count = 0
 
diff --git a/gently/eval/event_capture.py b/gently/eval/event_capture.py
index 5bb42811..822c53e0 100644
--- a/gently/eval/event_capture.py
+++ b/gently/eval/event_capture.py
@@ -29,6 +29,7 @@
 from datetime import date, datetime
 from enum import Enum
 from pathlib import Path
+from typing import Any
 
 from gently.core.event_bus import _NO_HISTORY_TYPES, Event, EventBus, EventType
 
@@ -52,13 +53,13 @@ class EventCapture:
     # itself skips for its history deque. The rationale carries over: at
     # 5 Hz over hours these would dominate the log without adding signal
     # that replay / diff can use.
-    DEFAULT_SKIP: set[EventType] = frozenset(_NO_HISTORY_TYPES)
+    DEFAULT_SKIP: frozenset[EventType] = frozenset(_NO_HISTORY_TYPES)
 
     def __init__(self, path: Path, *, skip: set[EventType] | None = None):
         self.path = Path(path)
         self._skip = self.DEFAULT_SKIP if skip is None else frozenset(skip)
-        self._fp = None
-        self._unsub = None
+        self._fp: Any = None
+        self._unsub: Any = None
         self._lock = threading.Lock()
         self._count = 0
         self._skipped = 0
diff --git a/gently/gently.py b/gently/gently.py
index a901e69a..5fc94598 100644
--- a/gently/gently.py
+++ b/gently/gently.py
@@ -34,7 +34,10 @@
 
 import logging
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .ui.web.server import VisualizationServer
 
 from .analysis import (
     Pipeline,
@@ -114,7 +117,7 @@ def __init__(
         self._agent = None
 
         # Visualization server (lazy loaded)
-        self._viz_server = None
+        self._viz_server: VisualizationServer | None = None
 
         # Register standard services
         self._register_standard_services()
@@ -250,7 +253,7 @@ async def resume_session(self, session_id: str) -> bool:
             return True
         return False
 
-    def list_sessions(self) -> list[dict]:
+    def list_sessions(self) -> list[Any]:
         """List available sessions"""
         return self._store.list_sessions()
 
diff --git a/gently/log_config.py b/gently/log_config.py
index 69a673a0..95eb5e34 100644
--- a/gently/log_config.py
+++ b/gently/log_config.py
@@ -33,7 +33,7 @@ def configure_logging(
     # the standard streams to UTF-8 with replacement so logging never raises.
     for _stream in (sys.stdout, sys.stderr):
         try:
-            _stream.reconfigure(encoding="utf-8", errors="replace")
+            _stream.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[union-attr]
         except (AttributeError, OSError):
             pass
 
diff --git a/gently/ml/data_loader.py b/gently/ml/data_loader.py
index ccf080b0..f34f4f06 100644
--- a/gently/ml/data_loader.py
+++ b/gently/ml/data_loader.py
@@ -19,7 +19,7 @@
     HAS_TORCH = False
 
     # Stub for import-time safety
-    class Dataset:
+    class Dataset:  # type: ignore[no-redef]
         pass
 
 
@@ -135,7 +135,7 @@ def create_data_splits(
         all_samples.append((full_path, label))
 
     # Stratified split
-    by_label = {}
+    by_label: dict[Any, list] = {}
     for path, label in all_samples:
         by_label.setdefault(label, []).append((path, label))
 
@@ -168,7 +168,7 @@ def build_labels_from_store(gently_store, session_ids: list[str] | None = None)
     dict
         {"class_names": [...], "samples": [{"path": "...", "label": int}, ...]}
     """
-    stage_to_idx = {}
+    stage_to_idx: dict[Any, int] = {}
     samples = []
 
     sessions = gently_store.list_sessions()
diff --git a/gently/ml/federated.py b/gently/ml/federated.py
index f257bbd5..8e6104be 100644
--- a/gently/ml/federated.py
+++ b/gently/ml/federated.py
@@ -265,7 +265,7 @@ async def _train_workers(
         completed = await asyncio.gather(*tasks, return_exceptions=True)
 
         for worker, result in zip(workers, completed, strict=False):
-            if isinstance(result, Exception):
+            if isinstance(result, BaseException):
                 logger.warning(f"Worker {worker.hostname} failed in round {round_num}: {result}")
                 continue
             if result:
diff --git a/gently/organisms/celegans/developmental_tracker.py b/gently/organisms/celegans/developmental_tracker.py
index 1750ba36..51ea513a 100644
--- a/gently/organisms/celegans/developmental_tracker.py
+++ b/gently/organisms/celegans/developmental_tracker.py
@@ -242,7 +242,7 @@ def classify_stage(
             Classification result
         """
         # Build content for Claude Vision
-        content = []
+        content: list[dict[str, Any]] = []
 
         # Add temporal context if available
         if recent_images and len(recent_images) > 1:
diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index fdf2fc5f..82228c56 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -818,7 +818,7 @@ async def _run_resolution_bootstrap():
                 # to take control rather than silently corrupting the
                 # single shared conversation.
                 if msg_type in ("chat", "command", "cancel") and client_id != _control["holder"]:
-                    holder_label = _client_labels.get(_control["holder"]) or "another client"
+                    holder_label = _client_labels.get(_control["holder"] or "") or "another client"
                     await send_fn(
                         {
                             "type": "notification",
diff --git a/gently/ui/web/routes/campaigns.py b/gently/ui/web/routes/campaigns.py
index a3fea08c..d3f2901b 100644
--- a/gently/ui/web/routes/campaigns.py
+++ b/gently/ui/web/routes/campaigns.py
@@ -115,7 +115,7 @@ async def get_campaign_document(campaign_id: str):
             raise HTTPException(status_code=404, detail="Campaign not found")
 
         # Collect all items across the tree and enrich with deps/dependents
-        bibliography = []
+        bibliography: list[Any] = []
         ref_index = {}  # dedup by (source, key)
 
         # Pre-index every item in the tree once. The naive enrichment used to call
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 93d49451..c4cee1b6 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -97,8 +97,8 @@ async def update_embryo_position(
         if emb is None:
             raise HTTPException(status_code=404, detail=f"Embryo {embryo_id} not found")
         try:
-            x = float(body.get("x"))
-            y = float(body.get("y"))
+            x = float(body.get("x"))  # type: ignore[arg-type]  # None -> TypeError caught below
+            y = float(body.get("y"))  # type: ignore[arg-type]
         except (TypeError, ValueError):
             raise HTTPException(status_code=400, detail="Body needs numeric x and y") from None
         old_coarse = dict(emb.position_coarse) if emb.position_coarse else None
@@ -344,7 +344,7 @@ async def set_temperature(payload: dict = Body(...)):  # noqa: B008
         (and the SYSTEM LOCKED state once it stabilizes).
         """
         try:
-            target = float(payload.get("target_c"))
+            target = float(payload.get("target_c"))  # type: ignore[arg-type]  # None -> caught
         except (TypeError, ValueError):
             raise HTTPException(status_code=400, detail="target_c must be a number") from None
         if not (0.0 <= target <= 99.9):
diff --git a/gently/ui/web/routes/volumes.py b/gently/ui/web/routes/volumes.py
index d2c66dac..83c334ce 100644
--- a/gently/ui/web/routes/volumes.py
+++ b/gently/ui/web/routes/volumes.py
@@ -3,6 +3,7 @@
 import base64
 import io
 import logging
+from typing import Any
 
 import numpy as np
 from fastapi import APIRouter, HTTPException, Request
@@ -61,7 +62,7 @@ async def get_projections(embryo_id: str, timepoint: int, method: str = "all"):
             logger.error(f"Failed to load volume: {e}")
             raise HTTPException(status_code=500, detail=f"Failed to load volume: {e}") from e
 
-        PROJECTION_METHODS = {
+        PROJECTION_METHODS: dict[str, Any] = {
             "three_view": projection_three_view,
         }
 
diff --git a/gently/ui/web/routes/websocket.py b/gently/ui/web/routes/websocket.py
index de66552c..0de827fd 100644
--- a/gently/ui/web/routes/websocket.py
+++ b/gently/ui/web/routes/websocket.py
@@ -4,6 +4,7 @@
 import json
 import logging
 from datetime import datetime
+from typing import Any
 
 from fastapi import APIRouter, WebSocket, WebSocketDisconnect
 
@@ -212,7 +213,7 @@ async def _handle_ws_message(server, websocket: WebSocket, message: str):
                 if session:
                     session["markers"] = markers
                     session["complete"].set()
-                    role_summary = {}
+                    role_summary: dict[str, Any] = {}
                     for m in markers:
                         r = m.get("role", "test")
                         role_summary[r] = role_summary.get(r, 0) + 1
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index c16c548d..892669b4 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -24,6 +24,7 @@
 import sys
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 import numpy as np
 
@@ -160,6 +161,9 @@ def __init__(
         self.sessions_dir = Path(sessions_dir)
         self.gently_store = gently_store  # FileStore for persistent volume/projection access
         self.context_store = None  # FileContextStore — set via set_context_store()
+        # Wired in by launch_gently after construction (optional subsystems).
+        self.agent_bridge: Any = None
+        self.mesh_service: Any = None
 
         # Connection manager for WebSocket clients
         self.manager = ConnectionManager()
diff --git a/gently/ui/web/strategy_snapshot.py b/gently/ui/web/strategy_snapshot.py
index 91c560e7..0a246a03 100644
--- a/gently/ui/web/strategy_snapshot.py
+++ b/gently/ui/web/strategy_snapshot.py
@@ -706,7 +706,7 @@ def _replay_timeline(
             # Pre-timelapse event from a previous run in this session — skip.
             continue
         data = ev.get("data") or {}
-        embryo_id = ev.get("embryo_id") or data.get("embryo_id")
+        embryo_id = str(ev.get("embryo_id") or data.get("embryo_id") or "")
 
         if subtype == "cadence_changed" and embryo_id in by_id:
             emb = by_id[embryo_id]
diff --git a/launch_gently.py b/launch_gently.py
index 64efdc15..cea609e6 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -166,7 +166,7 @@ def _open_browser(url: str) -> None:
             pass
 
     # 2) Explicit executables (an override path, then known Chrome locations).
-    candidates = [override] if override else []
+    candidates: list[str | None] = [override] if override else []
     candidates += [
         shutil.which("chrome"),
         r"C:\Program Files\Google\Chrome\Application\chrome.exe",
@@ -317,7 +317,7 @@ async def main(
 
     # Log file path for launch info
     session_name = datetime.now().strftime("%Y%m%d")
-    log_file = log_dir / f"{session_name}.log"
+    log_file = str(log_dir / f"{session_name}.log")
 
     # Connect to device layer via hardware module's client factory
     client = None
diff --git a/pyproject.toml b/pyproject.toml
index 1eb92a24..6567d600 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -15,41 +15,18 @@ authors = [
     {name = "Kesavan Subburam", email = "pskeshu@gmail.com"},
 ]
 classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Science/Research",
-    "Topic :: Scientific/Engineering :: Bio-Informatics",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
 ]
 
 dependencies = [
-    "anthropic>=0.39.0",
-    "fastapi>=0.104.0",
-    "uvicorn[standard]>=0.24.0",
-    "aiohttp>=3.9.0",
     # numpy capped <2: pymmcore 10.1.1.70.6 is a C-extension built against the
     # numpy 1.x ABI and fails to import under numpy 2.x. The wheel declares no
     # upper bound, so we enforce it here.
-    "numpy>=1.24.0,<2",
-    "pillow>=10.0.0",
-    "tifffile>=2023.0.0",
-    "scipy>=1.10.0",
-    "scikit-image>=0.21.0",
-    "jinja2>=3.1.0",
-    "pyyaml>=6.0",
-    "matplotlib>=3.7.0",
-    "python-dotenv>=1.0.0",
     # Perception harness — installed as an editable sibling clone (see
     # [tool.uv.sources]); clone gently-project/gently-perception next to this repo.
-    "gently-perception",
     # Device control.
     # pymmcore pinned exactly: its MMCore must match the device-interface version
     # (70) of the Micro-Manager device adapters installed on the microscope PC.
     # Bumping this requires upgrading the MM adapter install in lockstep.
-    "pymmcore==10.1.1.70.6",
-    "bluesky>=1.11.0",
-    "ophyd>=1.9.0",
     # NOTE: torch / torchvision / nvidia-ml-py are NOT base deps — CUDA build is
     # machine-specific. Install via an extra: `uv sync --extra torch-gpu` (CUDA
     # 11.8) or `uv sync --extra torch-cpu`. All torch imports are lazy/guarded.
@@ -58,7 +35,6 @@ dependencies = [
 
 [project.optional-dependencies]
 sam = [
-    "segment-anything",
 ]
 # PyTorch — CUDA build is per-machine, so it lives in mutually-exclusive extras
 # wired to dedicated indexes below (see [tool.uv.sources] / [[tool.uv.index]]).
@@ -68,36 +44,23 @@ sam = [
 # and only need a recent NVIDIA driver, so the same build runs across GPU machines
 # regardless of their system CUDA version.
 torch-gpu = [
-    "torch>=2.0.0",
-    "torchvision>=0.15.0",
-    "nvidia-ml-py>=12.0.0",
 ]
 torch-cpu = [
-    "torch>=2.0.0",
-    "torchvision>=0.15.0",
 ]
 # Device-layer accessories for the microscope computer. Core hardware-control
 # deps (pymmcore, bluesky, ophyd) are already in [project.dependencies]; these
 # are the extras the device layer needs: BLE (SwitchBot room light), serial and
 # MQTT transports (ACUITYnano thermal controller). Install: uv sync --extra device
 device = [
-    "bleak>=0.21.0",
-    "pyserial>=3.5",
-    "paho-mqtt>=1.6.0",
 ]
 
 # Test/dev tooling — installed by `uv sync` (uv enables the `dev` group by
 # default) but excluded from gently's published runtime requirements.
 [dependency-groups]
 dev = [
-    "pytest>=7.0.0",
-    "pytest-asyncio>=0.21.0",
-    "ruff>=0.4.0",
-    "pre-commit>=3.7.0",
     # Pinned so local runs, the pre-commit hook, and CI all use the same
     # mypy. Keep in sync with the mirrors-mypy rev in .pre-commit-config.yaml
     # and the install step in .github/workflows/lint.yml.
-    "mypy==2.1.0",
 ]
 
 [project.scripts]
@@ -170,29 +133,10 @@ module = [
     "diagnostics.plot_benchmark_results",
     "diagnostics.switchbot_webgui",
     "examples.example_dispim_workflows",
-    "gently",
-    "gently.agent",
-    "gently.analysis.core",
-    "gently.analysis.steps",
     "gently.core.store",
     "gently.dataset.aggregator",
     "gently.dataset.embryo_dataset",
     "gently.dataset.explorer_server",
-    "gently.detection",
-    "gently.eval.decision_log",
-    "gently.eval.event_capture",
-    "gently.gently",
-    "gently.log_config",
-    "gently.ml.data_loader",
-    "gently.ml.federated",
-    "gently.organisms.celegans.developmental_tracker",
-    "gently.ui.web.routes.agent_ws",
-    "gently.ui.web.routes.campaigns",
-    "gently.ui.web.routes.data",
-    "gently.ui.web.routes.volumes",
-    "gently.ui.web.routes.websocket",
-    "gently.ui.web.strategy_snapshot",
-    "launch_gently",
     "scripts.auto_label_examples",
     "scripts.extract_stage_examples",
     "scripts.gemini_stage_test",

From 87a52c52c2a2e0390b1fc49687afb9b85411ea92 Mon Sep 17 00:00:00 2001
From: Magdalena Schneider <schneiderm2@hhmi.org>
Date: Wed, 17 Jun 2026 13:03:53 -0400
Subject: [PATCH 162/314] Move hardware-control stack into default-on device
 dependency group

---
 README.md      |  16 ++-
 pyproject.toml |  48 ++++---
 uv.lock        | 377 +++++++++++++++++++++++++++++++++++++++++++++----
 3 files changed, 389 insertions(+), 52 deletions(-)

diff --git a/README.md b/README.md
index 78039e70..7bf25135 100644
--- a/README.md
+++ b/README.md
@@ -116,15 +116,23 @@ You get a `.venv` in the project directory with the runtime + dev dependencies
 pinned in `uv.lock`. Activate it with `source .venv/bin/activate`, or prefix
 commands with `uv run` (e.g. `uv run python ...`) to use it without activating.
 
-#### Optional extras
+#### The `device` group and optional extras
+
+The hardware-control stack (`pymmcore`, `bluesky`, `ophyd`) plus the accessory
+transports (BLE/serial/MQTT — SwitchBot room light, ACUITYnano thermal
+controller) live in the `device` dependency group, which is **installed by
+default**. None of it is imported by the agent or by `--offline` launch — only
+by the device layer — so a machine with no microscope can drop the whole stack:
+
+```bash
+# Laptop / review / CI — no microscope, skip the hardware-control stack
+uv sync --no-group device
+```
 
 PyTorch is **not** in the base install — the CUDA build is machine-specific, so
 it lives in mutually-exclusive extras wired to the right PyTorch index:
 
 ```bash
-# Device-layer accessories (microscope computer): BLE/serial/MQTT transports
-uv sync --extra device
-
 # PyTorch (needed for SAM detection and the ML pipeline)
 # NOTE: the GPU and CPU builds are mutually exclusive, so they can't be combined.
 uv sync --extra torch-gpu   # CUDA 11.8 build (GPU box, e.g. the microscope PC)
diff --git a/pyproject.toml b/pyproject.toml
index 561326b8..3e6fdd86 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -43,13 +43,11 @@ dependencies = [
     # Perception harness — installed as an editable sibling clone (see
     # [tool.uv.sources]); clone gently-project/gently-perception next to this repo.
     "gently-perception",
-    # Device control.
-    # pymmcore pinned exactly: its MMCore must match the device-interface version
-    # (70) of the Micro-Manager device adapters installed on the microscope PC.
-    # Bumping this requires upgrading the MM adapter install in lockstep.
-    "pymmcore==10.1.1.70.6",
-    "bluesky>=1.11.0",
-    "ophyd>=1.9.0",
+    # NOTE: the hardware-control stack (pymmcore / bluesky / ophyd) is NOT a base
+    # dep — it lives in the default-on `device` group below so a machine with no
+    # microscope can drop it via `uv sync --no-group device`. It is imported only
+    # by the device-layer process and gently.hardware.dispim, never by the agent
+    # or `--offline` launch.
     # NOTE: torch / torchvision / nvidia-ml-py are NOT base deps — CUDA build is
     # machine-specific. Install via an extra: `uv sync --extra torch-gpu` (CUDA
     # 11.8) or `uv sync --extra torch-cpu`. All torch imports are lazy/guarded.
@@ -76,19 +74,12 @@ torch-cpu = [
     "torch>=2.0.0",
     "torchvision>=0.15.0",
 ]
-# Device-layer accessories for the microscope computer. Core hardware-control
-# deps (pymmcore, bluesky, ophyd) are already in [project.dependencies]; these
-# are the extras the device layer needs: BLE (SwitchBot room light), serial and
-# MQTT transports (ACUITYnano thermal controller). Install: uv sync --extra device
-device = [
-    "bleak>=0.21.0",
-    "pyserial>=3.5",
-    "paho-mqtt>=1.6.0",
-]
 
-# Test/dev tooling — installed by `uv sync` (uv enables the `dev` group by
-# default) but excluded from gently's published runtime requirements.
+# Dependency groups are installed by `uv sync` (per [tool.uv] default-groups
+# below) but excluded from gently's published runtime requirements. Exclude any
+# group on a given machine with `uv sync --no-group <name>`.
 [dependency-groups]
+# Test/dev tooling.
 dev = [
     "pytest>=7.0.0",
     "pytest-asyncio>=0.21.0",
@@ -99,6 +90,23 @@ dev = [
     # and the install step in .github/workflows/lint.yml.
     "mypy==2.1.0",
 ]
+# Everything the microscope computer needs to drive hardware. Default-on (see
+# [tool.uv] default-groups); drop on a machine with no microscope via
+# `uv sync --no-group device`. None of these is imported by the agent or by
+# `--offline` launch — only by the device-layer process and gently.hardware.dispim.
+device = [
+    # pymmcore pinned exactly: its MMCore must match the device-interface version
+    # (70) of the Micro-Manager device adapters installed on the microscope PC.
+    # Bumping this requires upgrading the MM adapter install in lockstep.
+    "pymmcore==10.1.1.70.6",
+    "bluesky>=1.11.0",
+    "ophyd>=1.9.0",
+    # Accessory transports: BLE (SwitchBot room light), serial and MQTT
+    # (ACUITYnano thermal controller).
+    "bleak>=0.21.0",
+    "pyserial>=3.5",
+    "paho-mqtt>=1.6.0",
+]
 
 [project.scripts]
 gently = "launch_gently:cli_main"
@@ -106,6 +114,10 @@ gently = "launch_gently:cli_main"
 # torch-gpu and torch-cpu extras are mutually exclusive — they pull torch/
 # torchvision from different indexes, so they can't be installed together.
 [tool.uv]
+# Groups installed by default. `dev` is uv's implicit default; listing it here
+# keeps it on while also defaulting `device` (the microscope computer's
+# accessory transports) on. Exclude either with `uv sync --no-group <name>`.
+default-groups = ["dev", "device"]
 conflicts = [
     [{ extra = "torch-gpu" }, { extra = "torch-cpu" }],
 ]
diff --git a/uv.lock b/uv.lock
index 60a87123..1e82d177 100644
--- a/uv.lock
+++ b/uv.lock
@@ -159,6 +159,30 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
 ]
 
+[[package]]
+name = "ast-serialize"
+version = "0.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/81/9d/09e27731bd5864a9ce04e3244074e674bb8936bf62b45e0357248717adac/ast_serialize-0.5.0.tar.gz", hash = "sha256:5880091bfe6f4f986f22866375c2e884843e7a0b6343ae41aeea659613d879b6", size = 61157, upload-time = "2026-05-17T17:48:29.429Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/9e/dc2530acb3a60dc6e46d65abf27d1d9f86721694757906a148d90a6860de/ast_serialize-0.5.0-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:0668aa9459cfa8c9c49ddd2163ebcf43088ba045ef7492af6fe22e0098303101", size = 1191380, upload-time = "2026-05-17T17:48:03.738Z" },
+    { url = "https://files.pythonhosted.org/packages/26/0a/bd3d18a582f273d6c843d16bb9e22e9e16365ff7991e92f18f798e9f1224/ast_serialize-0.5.0-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:bf683d6363edf2b39eed6b6d4fe22d34b6203867a67e27134d9e2a2680c4bc4a", size = 1183879, upload-time = "2026-05-17T17:48:05.463Z" },
+    { url = "https://files.pythonhosted.org/packages/40/ae/1f919100f8620887af58fcc381c61a1f218cdf89c6e155f87b213e61010a/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9cc22cf0c9be65e71cf88fda130af60d61eb4a79370ad4cfe7900d48a4aa2211", size = 1244529, upload-time = "2026-05-17T17:48:07.008Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/ca/6376559dcce707cdbc1d0d9a13c8d3baaaa501e949ce0ebdc4230cd881aa/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f66173891548c9f2726bf27957b41cabce12fa679dc6da505ddbde4d4b3b31cf", size = 1240560, upload-time = "2026-05-17T17:48:08.46Z" },
+    { url = "https://files.pythonhosted.org/packages/35/b2/a620e206b5aeb7efbf2710336df57d457cffbb3991076bbcc1147ef9abd4/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e42d729ef2be96a14efbad355093284739e3670ece3e534f82cc8832790911d9", size = 1451172, upload-time = "2026-05-17T17:48:09.922Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/e0/4ad5c04c24a40481b2935ce9a0ccdb6023dc8b667167d06ae530cc3512f2/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b725026bafa801dbd7310eb13a75f0a2e370e7e51b2cb225f9d21fcfadf919ee", size = 1265072, upload-time = "2026-05-17T17:48:11.469Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/71/4d1d479aa56d0101c40e17720c3d6ac2af7269ea0487a80b18e7bfd1a5b7/ast_serialize-0.5.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b54f60c1d78767a53b67eaa663f0dfac3afe606aa07f1301572f588b73d64809", size = 1270488, upload-time = "2026-05-17T17:48:13.575Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/4f/0de1bbe06f6edef9fde4ed12ca8e7b3ec7e6e2bd4e672c5af487f7957665/ast_serialize-0.5.0-cp39-abi3-manylinux_2_31_riscv64.whl", hash = "sha256:27d51654fc240a1e87e742d353d98eb45b75f62f129086b3596ab53df2ac2a43", size = 1260702, upload-time = "2026-05-17T17:48:15.141Z" },
+    { url = "https://files.pythonhosted.org/packages/75/61/e00872439cfdddcc3c1b6cdaa6e5d904ba8e26a18807c67c4e14409d0ca8/ast_serialize-0.5.0-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c36237c46dd1674542f2109740ea5ea485a169bf1431939ada0434e17934", size = 1311182, upload-time = "2026-05-17T17:48:16.779Z" },
+    { url = "https://files.pythonhosted.org/packages/76/8e/699a5b955f7926956c95e9e1d74132acad73c2fe7a426f94da89123c20aa/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:1943db345233cc7194a470f13afa9c59772c0b123dea0c9414c4d4ca54369759", size = 1421410, upload-time = "2026-05-17T17:48:18.527Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/ae/d5b7626874478997adc7a29ab28accf21e596fb590c944290401dfd0b29e/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:df1c00022cbbcb064bfaa505aa9c9295362443ce5dacb459d1331d3da353f887", size = 1516587, upload-time = "2026-05-17T17:48:20.133Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/ce/b59e02a82d9c4244d64cde502e0b00e83e38816abe19155ceb5437402c7f/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:cae65289fc456fde04af979a2be09302ef5d8ab92ef23e596d6746dc267ada27", size = 1515171, upload-time = "2026-05-17T17:48:21.921Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/38/d8d90042747d05aa08d4efcf1c99035a5f670a6bf4c214d31644392afbca/ast_serialize-0.5.0-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:239a4c354e8d676e9d94631d1d4a64edc6b266f86ff3a5a80aedd344f342c01d", size = 1464668, upload-time = "2026-05-17T17:48:23.544Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/51/5b840c4df7334104cecffa28f23904fe81ca89ca223d2450e288de39fd3c/ast_serialize-0.5.0-cp39-abi3-win32.whl", hash = "sha256:143a4ef63285a075871908fda3672dc21864b83a8ec3ee12304aa3e4c5387b9a", size = 1068311, upload-time = "2026-05-17T17:48:25.027Z" },
+    { url = "https://files.pythonhosted.org/packages/41/11/ca5672c7d491825bc4cd6702dea106a6b60d928707712ec257c7833ae476/ast_serialize-0.5.0-cp39-abi3-win_amd64.whl", hash = "sha256:cf25572c526add400f26a4750dc6ce0c3bb93fc1f75e7ae0cad4ce4f2cd5c590", size = 1108931, upload-time = "2026-05-17T17:48:26.591Z" },
+    { url = "https://files.pythonhosted.org/packages/45/19/cc8bd127d28a43da249aa955cfd164cf8fd534e79e42cea96c4854d72fd0/ast_serialize-0.5.0-cp39-abi3-win_arm64.whl", hash = "sha256:92a31c9c20d25a076edaeec76b128a3535d74a24f340b9a8a7e96c9b86dc9642", size = 1081181, upload-time = "2026-05-17T17:48:28.122Z" },
+]
+
 [[package]]
 name = "async-timeout"
 version = "5.0.1"
@@ -242,6 +266,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/59/8c/57e832b7af6d7c5abe66eb3fbe3a3a32f4d11ea23a1aa7131371035be991/certifi-2026.5.20-py3-none-any.whl", hash = "sha256:3c52e209ba0a4ad7aebe60436a4ab349c39e1e602e8c134221e546902ad25897", size = 134134, upload-time = "2026-05-20T11:46:48.578Z" },
 ]
 
+[[package]]
+name = "cfgv"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4e/b5/721b8799b04bf9afe054a3899c6cf4e880fcf8563cc71c15610242490a0c/cfgv-3.5.0.tar.gz", hash = "sha256:d5b1034354820651caa73ede66a6294d6e95c1b00acc5e9b098e917404669132", size = 7334, upload-time = "2025-11-19T20:55:51.612Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/3c/33bac158f8ab7f89b2e59426d5fe2e4f63f7ed25df84c036890172b412b5/cfgv-3.5.0-py2.py3-none-any.whl", hash = "sha256:a8dc6b26ad22ff227d2634a65cb388215ce6cc96bbcc5cfde7641ae87e8dacc0", size = 7445, upload-time = "2025-11-19T20:55:50.744Z" },
+]
+
 [[package]]
 name = "click"
 version = "8.4.1"
@@ -399,6 +432,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c5/f8/1070ab5973dda406f735f6f73a4bc50debf7c43301f5e113fd3657bfca58/dbus_fast-5.0.16-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a8b2c92f82af04d59c50cbccf65f995fa2e321ce7850e3c1b613e94680a8044e", size = 860033, upload-time = "2026-05-27T19:27:55.167Z" },
 ]
 
+[[package]]
+name = "distlib"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/02/bd72be9134d25ed783ecbbc38a539ffaefbf90c78418c7fb7229600dbac7/distlib-0.4.3.tar.gz", hash = "sha256:f152097224a0ae24be5a0f6bae1b9359af82133bce63f98a95f86cae1aede9ed", size = 615141, upload-time = "2026-06-12T08:04:52.847Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/02/08/9c41fb51ab5b43eb21674aff13df270e8ba6c4b29c8624e328dc7a9482af/distlib-0.4.3-py2.py3-none-any.whl", hash = "sha256:4b0ce306c966eb73bc3a7b6abad017c556dadd92c44701562cd528ac7fde4d5b", size = 470628, upload-time = "2026-06-12T08:04:50.506Z" },
+]
+
 [[package]]
 name = "distro"
 version = "1.9.0"
@@ -594,20 +636,17 @@ wheels = [
 
 [[package]]
 name = "gently"
-version = "0.22.0.dev0"
+version = "0.22.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },
     { name = "anthropic" },
-    { name = "bluesky" },
     { name = "fastapi" },
     { name = "gently-perception" },
     { name = "jinja2" },
     { name = "matplotlib" },
     { name = "numpy" },
-    { name = "ophyd" },
     { name = "pillow" },
-    { name = "pymmcore" },
     { name = "python-dotenv" },
     { name = "pyyaml" },
     { name = "scikit-image", version = "0.25.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -620,11 +659,6 @@ dependencies = [
 ]
 
 [package.optional-dependencies]
-device = [
-    { name = "bleak" },
-    { name = "paho-mqtt" },
-    { name = "pyserial" },
-]
 sam = [
     { name = "segment-anything" },
 ]
@@ -642,27 +676,32 @@ torch-gpu = [
 
 [package.dev-dependencies]
 dev = [
+    { name = "mypy" },
+    { name = "pre-commit" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
+    { name = "ruff" },
+]
+device = [
+    { name = "bleak" },
+    { name = "bluesky" },
+    { name = "ophyd" },
+    { name = "paho-mqtt" },
+    { name = "pymmcore" },
+    { name = "pyserial" },
 ]
 
 [package.metadata]
 requires-dist = [
     { name = "aiohttp", specifier = ">=3.9.0" },
     { name = "anthropic", specifier = ">=0.39.0" },
-    { name = "bleak", marker = "extra == 'device'", specifier = ">=0.21.0" },
-    { name = "bluesky", specifier = ">=1.11.0" },
     { name = "fastapi", specifier = ">=0.104.0" },
     { name = "gently-perception", editable = "../gently-perception" },
     { name = "jinja2", specifier = ">=3.1.0" },
     { name = "matplotlib", specifier = ">=3.7.0" },
     { name = "numpy", specifier = ">=1.24.0,<2" },
     { name = "nvidia-ml-py", marker = "extra == 'torch-gpu'", specifier = ">=12.0.0" },
-    { name = "ophyd", specifier = ">=1.9.0" },
-    { name = "paho-mqtt", marker = "extra == 'device'", specifier = ">=1.6.0" },
     { name = "pillow", specifier = ">=10.0.0" },
-    { name = "pymmcore", specifier = "==10.1.1.70.6" },
-    { name = "pyserial", marker = "extra == 'device'", specifier = ">=3.5" },
     { name = "python-dotenv", specifier = ">=1.0.0" },
     { name = "pyyaml", specifier = ">=6.0" },
     { name = "scikit-image", specifier = ">=0.21.0" },
@@ -675,12 +714,23 @@ requires-dist = [
     { name = "torchvision", marker = "extra == 'torch-gpu'", specifier = ">=0.15.0", index = "https://download.pytorch.org/whl/cu118", conflict = { package = "gently", extra = "torch-gpu" } },
     { name = "uvicorn", extras = ["standard"], specifier = ">=0.24.0" },
 ]
-provides-extras = ["sam", "torch-gpu", "torch-cpu", "device"]
+provides-extras = ["sam", "torch-gpu", "torch-cpu"]
 
 [package.metadata.requires-dev]
 dev = [
+    { name = "mypy", specifier = "==2.1.0" },
+    { name = "pre-commit", specifier = ">=3.7.0" },
     { name = "pytest", specifier = ">=7.0.0" },
     { name = "pytest-asyncio", specifier = ">=0.21.0" },
+    { name = "ruff", specifier = ">=0.4.0" },
+]
+device = [
+    { name = "bleak", specifier = ">=0.21.0" },
+    { name = "bluesky", specifier = ">=1.11.0" },
+    { name = "ophyd", specifier = ">=1.9.0" },
+    { name = "paho-mqtt", specifier = ">=1.6.0" },
+    { name = "pymmcore", specifier = "==10.1.1.70.6" },
+    { name = "pyserial", specifier = ">=3.5" },
 ]
 
 [[package]]
@@ -689,20 +739,62 @@ version = "0.1.0"
 source = { editable = "../gently-perception" }
 dependencies = [
     { name = "anthropic" },
+    { name = "moderngl" },
     { name = "numpy" },
     { name = "pillow" },
+    { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 
 [package.metadata]
 requires-dist = [
     { name = "anthropic", specifier = ">=0.40.0" },
     { name = "matplotlib", marker = "extra == 'benchmark'", specifier = ">=3.7.0" },
+    { name = "moderngl", specifier = ">=5.10" },
     { name = "numpy", specifier = ">=1.24.0" },
     { name = "pillow", specifier = ">=10.0.0" },
+    { name = "scipy", specifier = ">=1.10" },
     { name = "tifffile", marker = "extra == 'benchmark'", specifier = ">=2024.1.30" },
 ]
 provides-extras = ["benchmark"]
 
+[[package]]
+name = "glcontext"
+version = "3.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3a/80/8238a0e6e972292061176141c1028b5e670aa8c94cf4c2f819bd730d314e/glcontext-3.0.0.tar.gz", hash = "sha256:57168edcd38df2fc0d70c318edf6f7e59091fba1cd3dadb289d0aa50449211ef", size = 16422, upload-time = "2024-08-10T20:01:20.004Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6a/44/f605689047cca15d5e5d31c0a4b9ca87dd1d52bfabf3c3a05d70a4636c08/glcontext-3.0.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b154c25a57e16dbb073478d0cbe2c0090649d135c4c9f87e753b6181b97ec848", size = 9329, upload-time = "2024-08-10T19:59:49.485Z" },
+    { url = "https://files.pythonhosted.org/packages/10/fd/461c9e37ad50514dac82fda04a7a0aabb1a5e6b0f76476538caa4e74a25a/glcontext-3.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:fa5a14778d13ecf4a0dd60a7825427bf6ac0383eacb3b8b1a9c23e4976aa0c8c", size = 9735, upload-time = "2024-08-10T19:59:51.329Z" },
+    { url = "https://files.pythonhosted.org/packages/db/86/c879bf61d4f52d8b0cd702db5f7180b5eae8804d29a798de8da0568a64b2/glcontext-3.0.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7c229290a3a33004a59799b94a50bc5e6f8addd1b5bc5039ef9e78f86d888b31", size = 50476, upload-time = "2024-08-10T19:59:52.854Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/c4/8b45b1c910f4a9b4df1ee3449b4c1aaa798fc25d86390e8eb2a18bc59669/glcontext-3.0.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1445a03d8795113034e1f9ffa662f795df65ae69ee21b26ed3b1d66100ba3f8c", size = 51480, upload-time = "2024-08-10T19:59:54.149Z" },
+    { url = "https://files.pythonhosted.org/packages/91/00/159f7df65554f30e0cc6f7fb78869e95717ed5319729f386dcc81ae9ee3d/glcontext-3.0.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:09247011c09c37b8d30eca9aa24659288de2febaeaa6a817b33b1498b5ef164c", size = 44902, upload-time = "2024-08-10T19:59:55.268Z" },
+    { url = "https://files.pythonhosted.org/packages/91/85/21d2b619576690d48e4967dce37fabe616aeee06b7c6a6c6ceb48d99d3ef/glcontext-3.0.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:c8c1223f1cbcfc0b88428e1717baca829ee863ed5d88e9b5574c7ed6598249cd", size = 47035, upload-time = "2024-08-10T20:00:03.972Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/99/6c200c6d16b55d19dfd13bfed1ed5794e17e49ea8ccf9e4fab52e2d0e2d0/glcontext-3.0.0-cp310-cp310-win32.whl", hash = "sha256:c13dedb3636328b133c4d53c047ce69040ae784095e8f239432ad74d6f921712", size = 12218, upload-time = "2024-08-10T20:00:06.285Z" },
+    { url = "https://files.pythonhosted.org/packages/93/36/8a8f25366ab80dc4e6c9ded7b21f11152bba65fd6b8c0f28641ef3e133f5/glcontext-3.0.0-cp310-cp310-win_amd64.whl", hash = "sha256:4817f4cd52c7fe5410c92ca12b6712435548918719373882ade76f8f75d80abd", size = 12973, upload-time = "2024-08-10T20:00:07.733Z" },
+    { url = "https://files.pythonhosted.org/packages/01/36/3d0d09f7352b179a7ecc5fc3322beb85c8995c66db780acf791853e49043/glcontext-3.0.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3a9e56fa3597cc709cfd0fdf2ae682cda36510a13faac2b3142f401e823b64f4", size = 9328, upload-time = "2024-08-10T20:00:09.43Z" },
+    { url = "https://files.pythonhosted.org/packages/44/9d/0c8fd9c660db000071ebace14a40bd381a41775c10faa262fedfae8227e3/glcontext-3.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a0484308af75e04b0e56066dc2324a8fb9f1443b76ddb98833439982322b2a39", size = 9738, upload-time = "2024-08-10T20:00:10.831Z" },
+    { url = "https://files.pythonhosted.org/packages/78/cf/7bcadb995830cdd6a1a31f0527a52b2c441a499feabed9749106f7e41e67/glcontext-3.0.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:983231394396aa2a1e2b96df49404cc8f8aa729d462ed40e605a74b079c46342", size = 50663, upload-time = "2024-08-10T20:00:12.301Z" },
+    { url = "https://files.pythonhosted.org/packages/43/fb/646c2773cb097b914afe1f06c95e65deb8a544d770389bf29c76a8f3a8fd/glcontext-3.0.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7fa413f4420abff2bbb5aa5770a3e1deffcdc13e0ef2f459b145fa79c36909e7", size = 51680, upload-time = "2024-08-10T20:00:13.646Z" },
+    { url = "https://files.pythonhosted.org/packages/89/b7/04aac6c50071b858cfd02a9bccafb42a21f567992fa448c8ad8aa62939b9/glcontext-3.0.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:7d0ac35ac07fc91eccea093beb9d1c1a4eae250bc33836047deff01a3b5f4757", size = 45063, upload-time = "2024-08-10T20:00:15.137Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/6e/6e398492b55f3c453cc6a2ecc2886a01b2a465623aa0c476d3e115be85c4/glcontext-3.0.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7145d17a70adc5784ca59ebbe19a56435ba21816070b8b433f43aa2dfb8be71a", size = 47281, upload-time = "2024-08-10T20:00:16.679Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/fd/4f59118e5067a3c88217862d8672463aff29f29c1ea9f47971f8ca67e83c/glcontext-3.0.0-cp311-cp311-win32.whl", hash = "sha256:b31808ca2517fedcac8ca5b296ff46c8af012911eaa2080889a1f244d329ef9a", size = 12222, upload-time = "2024-08-10T20:00:18.108Z" },
+    { url = "https://files.pythonhosted.org/packages/20/1b/f402574ae4644e7fb389b9534de9d1be575b8a4da901a9023d1cec72c4aa/glcontext-3.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:ef4b4ec35e2b720f4cd250bb92cf6417add445490bf780345596da5a796a0e6f", size = 12975, upload-time = "2024-08-10T20:00:19.236Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/61/d8f77d44bbf477b235ecbff8d421a5511d4b4f6dc676dacd84d012348516/glcontext-3.0.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:848f870a2bc72a29de7ab6756b9e8f2e6ce052e17873ebc6b3f25129b6e0d58a", size = 9360, upload-time = "2024-08-10T20:00:20.42Z" },
+    { url = "https://files.pythonhosted.org/packages/de/46/680a97d974cfe7af798542918b65bd8e65a5f8f7647edfd9fdb91a95df6c/glcontext-3.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4b3b12a66f57379566dd4d36899ac265abdbe040f3fc3293f50cd6678a1dcc9b", size = 9733, upload-time = "2024-08-10T20:00:21.624Z" },
+    { url = "https://files.pythonhosted.org/packages/74/2c/be188c4eb63b4d0cc74c644a1519b5e3a37488da3cbda724570cd5fed8d3/glcontext-3.0.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:449eaefd89c0519900715b8363ead59ac4aa32457722ca521ce01297441edb34", size = 50409, upload-time = "2024-08-10T20:00:22.827Z" },
+    { url = "https://files.pythonhosted.org/packages/32/ba/9ccb80650e5bd61e739f16f33aec3bb290a80f314631be8f7dc0a2b22b5f/glcontext-3.0.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:04921720740438ceea8fb8a38b5665963520c7c8f27bef03df8aeb3ea3cfbfb6", size = 51440, upload-time = "2024-08-10T20:00:23.987Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/99/f6c9a0e614809ba5b83bd8403c475b788bd574d694bd5bc6b6ae2e2cefdf/glcontext-3.0.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:25538bdb106f673638d70e8a16a0c037a92a24c4cf40a05f0d3fa14b483d6194", size = 44820, upload-time = "2024-08-10T20:00:25.436Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/29/fdbb94e4c9374390639b741774384f7413efcd7634cc9c4baacc2cf00a1f/glcontext-3.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:d11f7701b900a5a34c994e1d91c547be1cc469b73f881471460fd905f69f9e4c", size = 47055, upload-time = "2024-08-10T20:00:26.723Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/fe/25b5348fe5e856697dacad34fc07e80f48eecfb38bd09806679fe0e62769/glcontext-3.0.0-cp312-cp312-win32.whl", hash = "sha256:5d2b567eaf34adb016aadce81fd2f1d4c8e4a39e3d6f2a395ce528e2a350dd3f", size = 12219, upload-time = "2024-08-10T20:00:27.76Z" },
+    { url = "https://files.pythonhosted.org/packages/17/d3/6619693ddad97011ca1c9aaeb82216ab2bfd54757be752b12f4e9a2fc489/glcontext-3.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:e80bb37ba727bd20c192f2754aea40c437a7665005c1001c10752f91913964e9", size = 12971, upload-time = "2024-08-10T20:00:29.575Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/84/8f6ca5b8005ec58adbf51e2e6c3b5a20f234ea8f7a2e1df52835c9b23274/glcontext-3.0.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:f4e285e5d40e7a9bafeb0651c3d8f1a7c822525dec7091e97109ba87a70dbd1e", size = 9272, upload-time = "2024-08-10T20:01:00.133Z" },
+    { url = "https://files.pythonhosted.org/packages/39/a2/a0d1e7492f14727682820120062717a118f0196cda8cf6c1a6e6c4ab6d12/glcontext-3.0.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:96d1bbe62c5bc5315ca2f84a2abae6fa7b7d645dd368415a0cd1ee5ba6f3f8f7", size = 9581, upload-time = "2024-08-10T20:01:01.098Z" },
+    { url = "https://files.pythonhosted.org/packages/07/ba/2f093542218c9c38b293df0f501509fdfeb5dad975135a5467431aa9a774/glcontext-3.0.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3a190b1cdb39110c7b56c33857dbff493a364633bfd0ff402a1ce205956c94ca", size = 17842, upload-time = "2024-08-10T20:01:02.308Z" },
+    { url = "https://files.pythonhosted.org/packages/01/e5/5209be64858f9d7f9861f03ed5662491642d8d31b51a6a8495f084869386/glcontext-3.0.0-pp310-pypy310_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d467cce2dac8c3928847e90310eb6bdfdfa69f8df39b76a74734046faa15e688", size = 17226, upload-time = "2024-08-10T20:01:03.362Z" },
+    { url = "https://files.pythonhosted.org/packages/06/cb/0995eef99e56394b93bea3aa20bc269ae09125b66c0b7c1e3338f44c93cb/glcontext-3.0.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:2b0c5240125d75498a8f14596484233e4effe98a6a035f566872dd2fdf472ceb", size = 12988, upload-time = "2024-08-10T20:01:04.728Z" },
+]
+
 [[package]]
 name = "h11"
 version = "0.16.0"
@@ -778,6 +870,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
 ]
 
+[[package]]
+name = "identify"
+version = "2.6.19"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/52/63/51723b5f116cc04b061cb6f5a561790abf249d25931d515cd375e063e0f4/identify-2.6.19.tar.gz", hash = "sha256:6be5020c38fcb07da56c53733538a3081ea5aa70d36a156f83044bfbf9173842", size = 99567, upload-time = "2026-04-17T18:39:50.265Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/84/d9273cd09688070a6523c4aee4663a8538721b2b755c4962aafae0011e72/identify-2.6.19-py2.py3-none-any.whl", hash = "sha256:20e6a87f786f768c092a721ad107fc9df0eb89347be9396cadf3f4abbd1fb78a", size = 99397, upload-time = "2026-04-17T18:39:49.221Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.17"
@@ -992,6 +1093,52 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/8a/a1/8d812e53a5da1687abb10445275d41a8b13adb781bbf7196ddbcf8d88505/lazy_loader-0.5-py3-none-any.whl", hash = "sha256:ab0ea149e9c554d4ffeeb21105ac60bed7f3b4fd69b1d2360a4add51b170b005", size = 8044, upload-time = "2026-03-06T15:45:07.668Z" },
 ]
 
+[[package]]
+name = "librt"
+version = "0.11.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/40/08/9e7f6b5d2b5bed6ad055cdd5925f192bb403a51280f86b56554d9d0699a2/librt-0.11.0.tar.gz", hash = "sha256:075dc3ef4458a278e0195cbf6ac9d38808d9b906c5a6c7f7f79c3888276a3fb1", size = 200139, upload-time = "2026-05-10T18:17:25.138Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/83/10/37fd9e9ba96cb0bd742dfb20fc3d082e54bdbec759d7300df927f360ef07/librt-0.11.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:6e94ebfcfa2d5e9926d6c3b9aa4617ffc42a845b4321fb84021b872358c82a0f", size = 141706, upload-time = "2026-05-10T18:15:16.129Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/72/1b1466f358e4a0b728051f69bc27e67b432c6eaa2e05b88db49d3785ae0d/librt-0.11.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ae627397a2f351560440d872d6f7c8dbb4072e57868e7b2fc5b8b430fe489d45", size = 142605, upload-time = "2026-05-10T18:15:18.148Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/85/ed26dd2f6bc9a0baf48306433e579e8d354d70b2bcb78134ed950a5d0e1e/librt-0.11.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dc329359321b67d24efdf4bc69012b0597001649544db662c001db5a0184794c", size = 476555, upload-time = "2026-05-10T18:15:19.569Z" },
+    { url = "https://files.pythonhosted.org/packages/66/fe/11891191c0e0a3fd617724e891f6e67a71a7658974a892b9a9a97fdb2977/librt-0.11.0-cp310-cp310-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:7e82e642ab0f7608ce2fe53d76ca2280a9ee33a1b06556142c7c6fe80a86fc33", size = 468434, upload-time = "2026-05-10T18:15:20.87Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/50/5ec949d7f9ce1a07af903aa3e13abb98b717923bdead6e719b2f824ccc07/librt-0.11.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:88145c15c67731d54283d135b03244028c750cc9edc334a96a4f5950ebdb2884", size = 496918, upload-time = "2026-05-10T18:15:22.616Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/c4/177336c7524e34875a38bf668e88b193a6723a4eb4045d07f74df6e1506c/librt-0.11.0-cp310-cp310-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9d36a51b3d93320b686588e27123f4995804dbf1bce81df78c02fc3c6eea9280", size = 490334, upload-time = "2026-05-10T18:15:24.2Z" },
+    { url = "https://files.pythonhosted.org/packages/13/1f/da3112f7569eda3b49f9a2629bae1fe059812b6085df16c885f6454dff49/librt-0.11.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:d00f3ac06a2a8b246327f11e186a53a100a4d5c7ed52346367e5ec751d51586c", size = 511287, upload-time = "2026-05-10T18:15:26.226Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/94/03fec301522e172d105581431223be56b27594ff46440ebfbb658a3735d5/librt-0.11.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:461bbceede621f1ffb8839755f8663e886087ee7af16294cab7fb4d782c62eeb", size = 517202, upload-time = "2026-05-10T18:15:27.965Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/6e/339f6e5a7b413ce014f1917a756dae630fe59cc99f34153205b1cb540901/librt-0.11.0-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:0cad8a4d6a8ff03c9b76f9414caccd78e7cfbc8a2e12fa334d8e1d9932753783", size = 497517, upload-time = "2026-05-10T18:15:29.614Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/43/acdd5ce317cb46e8253ca9bfbdb8b12e68a24d745949336a7f3d5fb79ba0/librt-0.11.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:f37aa505b3cf60701562eddb32df74b12a9e380c207fd8b06dd157a943ac7ea0", size = 538878, upload-time = "2026-05-10T18:15:30.928Z" },
+    { url = "https://files.pythonhosted.org/packages/29/b5/7a25bb12e3172839f647f196b3e988318b7bb1ca7501732a225c4dce2ec0/librt-0.11.0-cp310-cp310-win32.whl", hash = "sha256:94663a21534637f0e787ec2a2a756022df6e5b7b2335a5cdd7d8e33d68a2af89", size = 100070, upload-time = "2026-05-10T18:15:32.551Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/0d/ebbcf4d77999c02c937b05d2b90ff4cd4dcc7e9a365ba132329ac1fe7a0f/librt-0.11.0-cp310-cp310-win_amd64.whl", hash = "sha256:dec7db73758c2b54953fd8b7fe348c45188fe26b39ee18446196edd08453a5d4", size = 117918, upload-time = "2026-05-10T18:15:33.678Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/87/2bf31fe17587b29e3f93ec31421e2b1e1c3e349b8bf6c7c313dbad1d5340/librt-0.11.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:93d95bd45b7d58343d8b90d904450a545144eec19a002511163426f8ab1fae29", size = 141092, upload-time = "2026-05-10T18:15:34.795Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/08/5c5bf772920b7ebac6e32bc91a643e0ab3870199c0b542356d3baa83970a/librt-0.11.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ee278c769a713638cdacd4c0436d72156e75df3ebc0166ab2b9dc43acc386c9", size = 142035, upload-time = "2026-05-10T18:15:36.242Z" },
+    { url = "https://files.pythonhosted.org/packages/06/20/662a03d254e5b000d838e8b345d83303ddb768c080fd488e40634c0fa66b/librt-0.11.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f230cb1cbc9faaa616f9a678f530ebcf186e414b6bcbd88b960e4ba1b92428d5", size = 475022, upload-time = "2026-05-10T18:15:37.56Z" },
+    { url = "https://files.pythonhosted.org/packages/de/f3/aa81523e45184c6ec23dc7f63263362ec55f80a09d424c012359ecbe7e35/librt-0.11.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:5d63c855d86938d9de93e265c9bd8c705b51ec494de5738340ee93767a686e4b", size = 467273, upload-time = "2026-05-10T18:15:39.182Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/6f/59c74b560ca8853834d5501d589c8a2519f4184f273a085ffd0f37a1cc47/librt-0.11.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:993f028be9e96a08d31df3479ac80d99be374d17f3b78e4796b3fd3c913d4e89", size = 497083, upload-time = "2026-05-10T18:15:40.634Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/7b/5aa4d2c9600a719401160bf7055417df0b2a47439b9d88286ce45e56b65f/librt-0.11.0-cp311-cp311-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:258d73a0aa66a055e65b2e4d1b8cdb23b9d132c5bb915d9547d804fcaed116cc", size = 489139, upload-time = "2026-05-10T18:15:41.934Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/31/9143803d7da6856a69153785768c4936864430eec0fd9461c3ea527d9922/librt-0.11.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:0827efe7854718f04aaddf6496e96960a956e676fe1d0f04eb41511fd8ad06d5", size = 508442, upload-time = "2026-05-10T18:15:43.206Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/5a/bce08184488426bda4ccc2c4964ac048c8f68ae89bd7120082eef4233cfd/librt-0.11.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:7753e57d6e12d019c0d8786f1c09c709f4c3fcc57c3887b24e36e6c06ec938b7", size = 514230, upload-time = "2026-05-10T18:15:44.761Z" },
+    { url = "https://files.pythonhosted.org/packages/89/8c/bb5e213d254b7505a0e658da199d8ab719086632ce09eef311ab27976523/librt-0.11.0-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:11bd19822431cc21af9f27374e7ae2e58103c7d98bda823536a6c47f6bb2bb3d", size = 494231, upload-time = "2026-05-10T18:15:46.308Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/fb/541cdad5b1ab1300398c74c4c9a497b88e5074c21b1244c8f49731d3a284/librt-0.11.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:22bdf239b219d3993761a148ffa134b19e52e9989c84f845d5d7b71d70a17412", size = 537585, upload-time = "2026-05-10T18:15:47.629Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/f2/464bb69295c320cb06bddb4f14a4ec67934ee14b2bffb12b19fb7ab287ba/librt-0.11.0-cp311-cp311-win32.whl", hash = "sha256:46c60b61e308eb535fbd6fa622b1ee1bb2815691c1ad9c98bf7b84952ec3bc8d", size = 100509, upload-time = "2026-05-10T18:15:49.157Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/e7/a17ee1788f9e4fbf548c19f4afa07c92089b9e24fef6cb2410863781ef4c/librt-0.11.0-cp311-cp311-win_amd64.whl", hash = "sha256:902e546ff044f579ff1c953ff5fce97b636fe9e3943996b2177710c6ef076f73", size = 118628, upload-time = "2026-05-10T18:15:50.345Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/c7/6c766214f9f9903bcfcfbef97d807af8d8f5aa3502d247858ab17582d212/librt-0.11.0-cp311-cp311-win_arm64.whl", hash = "sha256:65ac3bc20f78aa0ee5ae84baa68917f89fef4af63e941084dd019a0d0e749f0c", size = 103122, upload-time = "2026-05-10T18:15:52.068Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/d0/07c77e067f0838949b43bd89232c29d72efebb9d2801a9750184eb706b71/librt-0.11.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b87504f1690a23b9a2cca841191a04f83895d4fc2dd04df91d82b1a04ca2ad46", size = 144147, upload-time = "2026-05-10T18:15:53.227Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/24/8493538fa4f62f982686398a5b8f68008138a75086abdea19ade64bf4255/librt-0.11.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:40071fc5fe0ce8daa6de616702314a01e1250711682b0523d6ab8d4525910cb3", size = 143614, upload-time = "2026-05-10T18:15:54.657Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/1e/f8bad050810d9171f34a1648ed910e56814c2ba61639f2bd53c6377ae24b/librt-0.11.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:137e79445c896a0ea7b265f52d23954e05b64222ee1af69e2cb34219067cbb67", size = 485538, upload-time = "2026-05-10T18:15:56.117Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/fe/3594ebfbaf03084ba4b120c9ba5c3183fd938a48725e9bbe6ff0a5159ad8/librt-0.11.0-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:cca6644054e78746d8d4ef238681f9c34ff8b584fe6b988ecebb8db3b15e622a", size = 479623, upload-time = "2026-05-10T18:15:57.544Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/da/5d1876984b3746c85dbd219dbfcb73c85f54ee263fd32e5b2a632ec14571/librt-0.11.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d5b0eea49f5562861ee8d757a32ef7d559c1d35be2aaaa1ec28941d74c9ffc8a", size = 513082, upload-time = "2026-05-10T18:15:58.805Z" },
+    { url = "https://files.pythonhosted.org/packages/19/6e/55bdf5d5ca00c3e18430690bf2c953d8d3ffd3c337418173d33dec985dc9/librt-0.11.0-cp312-cp312-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0d1029d7e1ae1a7e647ed6fb5df8c4ce2dffefb7a9f5fd1376a4554d96dac09f", size = 508105, upload-time = "2026-05-10T18:16:00.2Z" },
+    { url = "https://files.pythonhosted.org/packages/07/10/f1f23a7c595ee90ece4d35c851e5d104b1311a887ed1b4ac4c35bbd13da8/librt-0.11.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:bc3ce6b33c5828d9e80592011a5c584cb2ce86edbc4088405f70da47dc1d1b3b", size = 522268, upload-time = "2026-05-10T18:16:01.708Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/02/5720f5697a7f54b78b3aefbe20df3a48cedcff1276618c4aa481177942ed/librt-0.11.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:936c5995f3514a42111f20099397d8177c79b4d7e70961e396c6f5a0a3566766", size = 527348, upload-time = "2026-05-10T18:16:03.496Z" },
+    { url = "https://files.pythonhosted.org/packages/50/db/b4a47c6f91db4ff76348a0b3dd0cc65e090a078b765a810a62ff9434c3d3/librt-0.11.0-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:9bc0ca6ad9381cbe8e4aa6e5726e4c80c78115a6e9723c599ed1d73e092bc49d", size = 516294, upload-time = "2026-05-10T18:16:05.173Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/58/9384b2f4eb1ed1d273d40948a7c5c4b2360213b402ef3be4641c06299f9c/librt-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:070aa8c26c0a74774317a72df8851facc7f0f012a5b406557ac56992d92e1ec8", size = 553608, upload-time = "2026-05-10T18:16:06.839Z" },
+    { url = "https://files.pythonhosted.org/packages/21/7b/5aa8848a7c6a9278c79375146da1812e695754ceec5f005e6043461a7315/librt-0.11.0-cp312-cp312-win32.whl", hash = "sha256:6bf14feb84b05ae945277395451998c89c54d0def4070eb5c08de544930b245a", size = 101879, upload-time = "2026-05-10T18:16:08.103Z" },
+    { url = "https://files.pythonhosted.org/packages/37/33/8a745436944947575b584231750a41417de1a38cf6a2e9251d1065651c09/librt-0.11.0-cp312-cp312-win_amd64.whl", hash = "sha256:75672f0bc524ede266287d532d7923dbce94c7514ad07627bac3d0c6d92cc4d9", size = 119831, upload-time = "2026-05-10T18:16:09.174Z" },
+    { url = "https://files.pythonhosted.org/packages/59/67/a6739ac96e28b7855808bdb0370e250606104a859750d209e5a0716fe7ab/librt-0.11.0-cp312-cp312-win_arm64.whl", hash = "sha256:2f10cf143e4a9bb0f4f5af568a00df94a2d69ef41c2579584454bb0fe5cc642c", size = 103470, upload-time = "2026-05-10T18:16:10.369Z" },
+]
+
 [[package]]
 name = "markupsafe"
 version = "3.0.3"
@@ -1079,6 +1226,41 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/6f/87/afead29192170917537934c6aff4b008c805fff7b1ccea0c79120d96beda/matplotlib-3.10.9-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3fc0364dfbe1d07f6d15c5ebd0c5bf89e126916e5a8667dd4a7a6e84c36653d4", size = 8774002, upload-time = "2026-04-24T00:14:09.816Z" },
 ]
 
+[[package]]
+name = "moderngl"
+version = "5.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "glcontext" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/da/52/540e2f8c45060bb2709f56eb5a44ae828dfcc97ccecb342c1a7deb467889/moderngl-5.12.0.tar.gz", hash = "sha256:52936a98ccb2f2e1d6e3cb18528b2919f6831e7e3f924e788b5873badce5129b", size = 193232, upload-time = "2024-10-17T12:36:28.002Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/4b/988c5f4ef55bf0c62a0b63a4b32fe6d6dd755d12f5951e8fd56e8a30d3f6/moderngl-5.12.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:105cdee2ee29a7e6ebbc76cf178941503656a185c6945933bc7ef395ba8e65a7", size = 111803, upload-time = "2024-10-17T12:36:34.271Z" },
+    { url = "https://files.pythonhosted.org/packages/97/40/272d38d9d096d591db08e4aa1c983a8ed34cd1717b6524a88539b0df4341/moderngl-5.12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:18deb8bebd0a4277d92c76dbedf8e4b4b68bf0a8a878404c6b26aed750890d3b", size = 109223, upload-time = "2024-10-17T12:36:35.957Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/5c/a6f2743c8ae1c95cd6531510bf76fa6be650a5e0a1dffdf138b5ed186f61/moderngl-5.12.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f0c4f7c42425177168938386a4fabd734ca3bbb5de2d1fd1176cfa6f980fc13", size = 291432, upload-time = "2024-10-17T12:36:37.122Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/2d/b6bfc4fe7df343a4f410030dbd8261566282049e56e9ffc3cbd2e626656e/moderngl-5.12.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:878cdf593204d85c020305f21d306f979353a67c932b9df58ea936f6e5ad13e7", size = 265422, upload-time = "2024-10-17T12:36:38.767Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/ae/35f8f4c833aca90870110509dddad641f5adf9597da15b3c9e7c75db319f/moderngl-5.12.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:00d94f9cb485d87c85088edad624201e152d8ac401793a024b16cd9e2bc4dbf6", size = 1342266, upload-time = "2024-10-17T12:36:40.405Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/4b/2e0b6d0e8a5273da93ed82c8eb91b54a37413b1b9d65bb223d67b595fc96/moderngl-5.12.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:edd91057b8d76beebac0d7b0c741466ee8f37eaf3c07856785c2872afe0b35ac", size = 1270055, upload-time = "2024-10-17T12:36:42.243Z" },
+    { url = "https://files.pythonhosted.org/packages/48/2f/b590f86d42630fbbaffd83f1890ef6278ec12d5cb336b6a2efcbb3c2ca21/moderngl-5.12.0-cp310-cp310-win32.whl", hash = "sha256:3d066eae2eb44e81bd7addf565adebc041bdee119e7ac6e4f95831d6f327a938", size = 101044, upload-time = "2024-10-17T12:36:43.94Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/6d/f9b77797d3a0f3e5b67a75092c6c63b26360042fd8e43be017c706e308a8/moderngl-5.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:76d966194d51852f48c42a6e786a4520f1e1be5f93e2626423d673663422d559", size = 108272, upload-time = "2024-10-17T12:36:44.995Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/ea/569c2c08bfef84f4acf633a8e6d956f4f75cfaa8832d7d812dbf2ff6843a/moderngl-5.12.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:28cdba5dcf2d03c89bb25dc3b2f5770ac4104470ed5bbe680a15494fa52a537d", size = 111802, upload-time = "2024-10-17T12:36:47.377Z" },
+    { url = "https://files.pythonhosted.org/packages/00/ef/98f36133ab010ce9831b75a16e75a627c12a4c1d6ef2e353eca1769a1e09/moderngl-5.12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dad93893e3fcb2410bfd31e854f20e1370b4fbafa07a737f1046f5fbd29ba0f4", size = 109227, upload-time = "2024-10-17T12:36:49.24Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/bb/ab371acacd2497bddb5f02b209e3bfae452b2be59d0cf8fa728a3b87de1f/moderngl-5.12.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7fc0f8788bc84433d2124e9a4893adbe40f93c7d213abb8ad7b909540cb0161f", size = 293468, upload-time = "2024-10-17T12:36:50.8Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/9e/7ebf2b98da310c90c2b295e91b6c25f864f0f5583ce86bee72d387cb577a/moderngl-5.12.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6efd3fe0d2c9652af21e2c1f5a936a2b971abac5bdd777da7182a54962466cab", size = 267348, upload-time = "2024-10-17T12:36:52.526Z" },
+    { url = "https://files.pythonhosted.org/packages/61/0a/87fb24f4cd2aa07150b84fbf400edf4d8a8f71784cbf064f1ed92b756fea/moderngl-5.12.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:6f3bd2d534fc081cde30545b84ebca63aef847ba8bd533217b9a37f565614ade", size = 1343953, upload-time = "2024-10-17T12:36:54.601Z" },
+    { url = "https://files.pythonhosted.org/packages/83/42/11b0306e630d9a38b8bac20563b326f6d5fba4dfc45cc90b0666ed3e7141/moderngl-5.12.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:eaa3de9446c6febec4d5f888e6f1a4e9398bc5a5ea70b1570ea447213641d4a6", size = 1271832, upload-time = "2024-10-17T12:36:56.383Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/dd/74d300275fe4834e63b8d70450801f206d005f2047898d4eb2a30efc3913/moderngl-5.12.0-cp311-cp311-win32.whl", hash = "sha256:9fdb76f1fd890db67727c8cdee4db2ee6319068c7ce92be0308366f8745e28ab", size = 101043, upload-time = "2024-10-17T12:36:58.281Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/08/5f615a4605d343cd5c1112d2b175270e6a5586008bc10a85b822c340cf86/moderngl-5.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:0c210e8d52a60025f6586ca015c39feb1e57e6dc792c3ff44800f6493a541b1a", size = 108279, upload-time = "2024-10-17T12:37:01.125Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/66/31161e81bc85ca3cdbb9d94f703f21575e4ae9a2919e9d1af98fc7fdb1ba/moderngl-5.12.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:2750547707c1ec3790dfbeb9c90fb808672ff13f61cac392c706ba09fda10db0", size = 112101, upload-time = "2024-10-17T12:37:02.267Z" },
+    { url = "https://files.pythonhosted.org/packages/84/b2/7229a89a40d33a95119a7c64c7ee36a6a6e376c57c39fb577ea513602f37/moderngl-5.12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:c5c2a5fe06c7021183d9274df798f25516409c8d55898c324dae8a0b2de10144", size = 109377, upload-time = "2024-10-17T12:37:03.843Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/96/bcb5141eae24474d80b8157b0c3055d25fa75f9804d4abb4a514695bbba9/moderngl-5.12.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b6c4972f3ddd10a3de6c30311da2c25bc493d023796e16c5d4e0f8bd6d5770be", size = 296394, upload-time = "2024-10-17T12:37:04.967Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/79/a9998ddf6757f4f15888b0a106d80a64a8c8991a8ce5c14047830704b9e6/moderngl-5.12.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a4d497ec6a3f6afa9ebd0be816d9bfe2fe20fec2105acfb88d956619c3ed8eb4", size = 270548, upload-time = "2024-10-17T12:37:07.57Z" },
+    { url = "https://files.pythonhosted.org/packages/17/f4/313dc301db936b231035b961e004f1914c2954bdcdf4985e24bff15e7ed5/moderngl-5.12.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:2f3d240e9bc5d83257378bae59f8f35638b89d22bb003cf674b88fd7932161ce", size = 1345817, upload-time = "2024-10-17T12:37:09.105Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/6f/7b3587e7e3ae633b8c85038f035dfeb348ebf805de4beb01241c59c6b97c/moderngl-5.12.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:6fa667d560d842e778e2a5968305fb78f9781616a11b1b93acd2562f97262ccf", size = 1274968, upload-time = "2024-10-17T12:37:11.092Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/e8/0f3b3cd1be7b0a93f33dc613f76a42021d1393b4949c5b6a1ca2a01c6772/moderngl-5.12.0-cp312-cp312-win32.whl", hash = "sha256:0a02fddd54dccee1ca6060bfed75a2e6a17dd3ee06920fac418506d8a8233849", size = 101221, upload-time = "2024-10-17T12:37:12.642Z" },
+    { url = "https://files.pythonhosted.org/packages/56/85/35498b1821cf31c731b1882168db8924207ff3c06d8f0da53e1cc373a89d/moderngl-5.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:8698a59ad03539a2982125b7998efc1c107ba31d5d03437b6fcd72cb2c226922", size = 108525, upload-time = "2024-10-17T12:37:13.816Z" },
+]
+
 [[package]]
 name = "mpmath"
 version = "1.3.0"
@@ -1201,6 +1383,53 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/81/08/7036c080d7117f28a4af526d794aab6a84463126db031b007717c1a6676e/multidict-6.7.1-py3-none-any.whl", hash = "sha256:55d97cc6dae627efa6a6e548885712d4864b81110ac76fa4e534c03819fa4a56", size = 12319, upload-time = "2026-01-26T02:46:44.004Z" },
 ]
 
+[[package]]
+name = "mypy"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "ast-serialize" },
+    { name = "librt", marker = "platform_python_implementation != 'PyPy' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "mypy-extensions" },
+    { name = "pathspec" },
+    { name = "tomli", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/82/15/cca9d88503549ed6fedeaa1d448cdddd542ee8a490232d732e278036fbf2/mypy-2.1.0.tar.gz", hash = "sha256:81e76ad12c2d804512e9b13240d1588316531bfba07558286078bfbce9613633", size = 3898359, upload-time = "2026-05-11T18:37:36.237Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a4/71/d351dca3e9b30da2328ee9d445c88b8388072808ebfbc49eb69d30b67749/mypy-2.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:11a6beb180257a805961aea9ec591bbd0bd17f1e18d35b8456d57aee5bedfedc", size = 14778792, upload-time = "2026-05-11T18:36:23.605Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/45/7d51594b644c17c0bcf74ed8cd5fc33b324276d708e8506f220b70dab9d9/mypy-2.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8ef78c1d306bbf9a8a12f526c44902c9c28dffd6c52c52bf6a72641ce18d3849", size = 13645739, upload-time = "2026-05-11T18:37:22.752Z" },
+    { url = "https://files.pythonhosted.org/packages/65/01/455c31b170e9468265074840bf18863a8482a24103fdaabe4e199392aa5f/mypy-2.1.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c209a90853081ff01d01ee895cafe10f7db1474e0d95beaeef0f6c1db9119bbd", size = 14074199, upload-time = "2026-05-11T18:35:09.292Z" },
+    { url = "https://files.pythonhosted.org/packages/41/5a/93093f0b29a9e982deafde698f740a2eb2e05886e79ccf0594c7fd5413a3/mypy-2.1.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:47cebf61abde7c088a4e27718a8b13a81655686b2e9c251f5c0915a802248166", size = 14953128, upload-time = "2026-05-11T18:31:57.678Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/2f/a196f5331d96170ad3d28f144d2aba690d4b2911381f68d51e489c7ab82a/mypy-2.1.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:d57a90ae5e872138a425ec328edbc9b235d1934c4377881a33ec05b341acc9a8", size = 15249378, upload-time = "2026-05-11T18:33:00.101Z" },
+    { url = "https://files.pythonhosted.org/packages/54/de/94d321cc12da9f71341ac0c270efbed5c725750c7b4c334d957de9a087d9/mypy-2.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:aea7f7a8a55b459c34275fc468ada6ca7c173a5e43a68f5dbe588a563d8a06b8", size = 11060994, upload-time = "2026-05-11T18:33:18.848Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/62/0c27ca55219a7c764a7fb88c7bb2b7b2f9780ade8bbf16bc8ed8400eef6b/mypy-2.1.0-cp310-cp310-win_arm64.whl", hash = "sha256:c989640253f0d76843e9c6c1bbf4bd48c5e85ada61bde4beb37cb3eca035685e", size = 9976743, upload-time = "2026-05-11T18:31:25.554Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/a1/639f3024794a2a15899cb90707fe02e044c4412794c39c5769fd3df2e2ef/mypy-2.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:a683016b16fe2f572dc04c72be7ee0504ac1605a265d0200f5cea695fb788f41", size = 14691685, upload-time = "2026-05-11T18:33:27.973Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/08/9a585dea4325f20d8b80dc78623fa50d1fd2173b710f6237afd6ba6ab39b/mypy-2.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1a293c534adb55271fef24a26da04b855540a8c13cc07bc5917b9fd2c394f2ca", size = 13555165, upload-time = "2026-05-11T18:32:16.107Z" },
+    { url = "https://files.pythonhosted.org/packages/81/dc/7c42cc9c6cb01e8eb09961f1f738741d3e9c7e9d5c5b30ec69222625cd5f/mypy-2.1.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7406f4d048e71e576f5356d317e5b0a9e666dfd966bd99f9d14ca06e1a341538", size = 13994376, upload-time = "2026-05-11T18:32:39.256Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/fa/285946c33bce716e082c11dfeee9ee196eaf1f5042efb3581a31f9f205e4/mypy-2.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e0210d626fc8b31ccc90233754c7bc90e1f43205e85d96387f7db1285b55c398", size = 14864618, upload-time = "2026-05-11T18:34:49.765Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/83/82397f48af6c27e295d57979ded8490c9829040152cf7571b2f026aeb9a0/mypy-2.1.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3712c20deed54e814eaaa825603bada8ea1c390670a397c95b98405347acc563", size = 15102063, upload-time = "2026-05-11T18:34:05.855Z" },
+    { url = "https://files.pythonhosted.org/packages/40/68/b02dec39057b88eb03dc0aa854732e26e8361f34f9d0e20c7614967d1eba/mypy-2.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:fcaa0e479066e31f7cceb6a3bea39cb22b2ff51a6b2f24f193d19179ba17c389", size = 11060564, upload-time = "2026-05-11T18:35:36.494Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/a8/ea3dcbef31f99b634f2ee23bb0321cbc8c1b388b76a861eb849f13c347dc/mypy-2.1.0-cp311-cp311-win_arm64.whl", hash = "sha256:0b1a5260c95aa443083f9ed3592662941951bca3d4ca224a5dc517c38b7cf666", size = 9966983, upload-time = "2026-05-11T18:37:14.139Z" },
+    { url = "https://files.pythonhosted.org/packages/95/b1/55861beb5c339b44f9a2ba92df9e2cb1eeb4ae1eee674cdf7772c797778b/mypy-2.1.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:244358bf1c0da7722230bce60683d52e8e9fd030554926f15b747a84efb5b3af", size = 14874381, upload-time = "2026-05-11T18:37:31.784Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/b3/b7f770114b7d0ac92d0f76e8d93c2780844a70488a90e91821927850da86/mypy-2.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4ec7c57657493c7a75534df2751c8ae2cda383c16ecc55d2106c54476b1b16f6", size = 13665501, upload-time = "2026-05-11T18:34:23.063Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/f3/8ae2037967e2126689a0c11d99e2b707134a565191e92c60ca2572aec60a/mypy-2.1.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d8161b6ff4392410023224f0969d17db93e1e154bc3e4ba62598e720723ae211", size = 14045750, upload-time = "2026-05-11T18:31:48.151Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/32/615eb5911859e43d054941b0d0a7d06cfa2870eba86529cf385b052b111c/mypy-2.1.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bf03e12003084a67395184d3eb8cbd6a489dc3655b5664b28c210a9e2403ab0b", size = 15061630, upload-time = "2026-05-11T18:37:06.898Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/03/4eafbfff8bfab1b87082741eae6e6a624028c984e6708b73bce2a8570c9d/mypy-2.1.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:20509760fd791c51579d573153407d226385ec1f8bcce55d730b354f3336bc22", size = 15288831, upload-time = "2026-05-11T18:31:18.07Z" },
+    { url = "https://files.pythonhosted.org/packages/99/ee/919661478e5891a3c96e549c036e467e64563ab85995b10c53c8358e16a3/mypy-2.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:6753d0c1fdd6b1a23b9e4f283ce80b2153b724adcb2653b20b85a8a28ac6436b", size = 11135228, upload-time = "2026-05-11T18:34:31.23Z" },
+    { url = "https://files.pythonhosted.org/packages/24/0a/6a12b9782ca0831a553192f351679f4548abc9d19a7cc93bb7feb02084c7/mypy-2.1.0-cp312-cp312-win_arm64.whl", hash = "sha256:98ebb6589bb3b6d0c6f0c459d53ca55b8091fbc13d277c4041c885392e8195e8", size = 10040684, upload-time = "2026-05-11T18:36:48.199Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/2a/13ca1f292f6db1b98ff495ef3467736b331621c5917cad984b7043e7348d/mypy-2.1.0-py3-none-any.whl", hash = "sha256:a663814603a5c563fb87a4f96fb473eeb30d1f5a4885afcf44f9db000a366289", size = 2693302, upload-time = "2026-05-11T18:31:29.246Z" },
+]
+
+[[package]]
+name = "mypy-extensions"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/6e/371856a3fb9d31ca8dac321cda606860fa4548858c0cc45d9d1d4ca2628b/mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558", size = 6343, upload-time = "2025-04-22T14:54:24.164Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
+]
+
 [[package]]
 name = "networkx"
 version = "3.4.2"
@@ -1232,6 +1461,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/9e/c9/b2622292ea83fbb4ec318f5b9ab867d0a28ab43c5717bb85b0a5f6b3b0a4/networkx-3.6.1-py3-none-any.whl", hash = "sha256:d47fbf302e7d9cbbb9e2555a0d267983d2aa476bac30e90dfbe5669bd57f3762", size = 2068504, upload-time = "2025-12-08T17:02:38.159Z" },
 ]
 
+[[package]]
+name = "nodeenv"
+version = "1.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/bf/d1bda4f6168e0b2e9e5958945e01910052158313224ada5ce1fb2e1113b8/nodeenv-1.10.0.tar.gz", hash = "sha256:996c191ad80897d076bdfba80a41994c2b47c68e224c542b48feba42ba00f8bb", size = 55611, upload-time = "2025-12-20T14:08:54.006Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl", hash = "sha256:5bb13e3eed2923615535339b3c620e76779af4cb4c6a90deccc9e36b274d3827", size = 23438, upload-time = "2025-12-20T14:08:52.782Z" },
+]
+
 [[package]]
 name = "numpy"
 version = "1.26.4"
@@ -1443,6 +1681,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c4/cb/00451c3cf31790287768bb12c6bec834f5d292eaf3022afc88e14b8afc94/paho_mqtt-2.1.0-py3-none-any.whl", hash = "sha256:6db9ba9b34ed5bc6b6e3812718c7e06e2fd7444540df2455d2c51bd58808feee", size = 67219, upload-time = "2024-04-29T19:52:48.345Z" },
 ]
 
+[[package]]
+name = "pathspec"
+version = "1.1.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5a/82/42f767fc1c1143d6fd36efb827202a2d997a375e160a71eb2888a925aac1/pathspec-1.1.1.tar.gz", hash = "sha256:17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a", size = 135180, upload-time = "2026-04-27T01:46:08.907Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f1/d9/7fb5aa316bc299258e68c73ba3bddbc499654a07f151cba08f6153988714/pathspec-1.1.1-py3-none-any.whl", hash = "sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189", size = 57328, upload-time = "2026-04-27T01:46:07.06Z" },
+]
+
 [[package]]
 name = "pillow"
 version = "12.2.0"
@@ -1552,6 +1799,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
 ]
 
+[[package]]
+name = "pre-commit"
+version = "4.6.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8e/22/2de9408ac81acbb8a7d05d4cc064a152ccf33b3d480ebe0cd292153db239/pre_commit-4.6.0.tar.gz", hash = "sha256:718d2208cef53fdc38206e40524a6d4d9576d103eb16f0fec11c875e7716e9d9", size = 198525, upload-time = "2026-04-21T20:31:41.613Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/80/6e/4b28b62ecb6aae56769c34a8ff1d661473ec1e9519e2d5f8b2c150086b26/pre_commit-4.6.0-py2.py3-none-any.whl", hash = "sha256:e2cf246f7299edcabcf15f9b0571fdce06058527f0a06535068a86d38089f29b", size = 226472, upload-time = "2026-04-21T20:31:40.092Z" },
+]
+
 [[package]]
 name = "propcache"
 version = "0.5.2"
@@ -1741,7 +2004,7 @@ name = "pyobjc-framework-cocoa"
 version = "12.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "pyobjc-core" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/6d/cc/927169225e72bab9c9b44285656768fb75052a0bc85fdbca62740e1ca43c/pyobjc_framework_cocoa-12.2.tar.gz", hash = "sha256:20b392e2b7241caad0538dfde12143343e5dfe48f72e7df660a7548e635903dc", size = 3125555, upload-time = "2026-05-30T12:35:09.273Z" }
 wheels = [
@@ -1755,8 +2018,8 @@ name = "pyobjc-framework-corebluetooth"
 version = "12.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "pyobjc-core" },
-    { name = "pyobjc-framework-cocoa" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-framework-cocoa", marker = "sys_platform == 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/52/df/bee7ba216f9fb513710aac1701b78c97b087b37fca8ec1806f8572e0bbb3/pyobjc_framework_corebluetooth-12.2.tar.gz", hash = "sha256:8b4e5ca99953c360c391a695b0782a5328fcecafd56fdf790ad709e932feb306", size = 37552, upload-time = "2026-05-30T12:35:33.863Z" }
 wheels = [
@@ -1770,8 +2033,8 @@ name = "pyobjc-framework-libdispatch"
 version = "12.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "pyobjc-core" },
-    { name = "pyobjc-framework-cocoa" },
+    { name = "pyobjc-core", marker = "sys_platform == 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+    { name = "pyobjc-framework-cocoa", marker = "sys_platform == 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/1b/fe/e23be301e46c30450955cdb096f16f6a86e7609787a4b8225ec24d6fdc9d/pyobjc_framework_libdispatch-12.2.tar.gz", hash = "sha256:4a41879ef7716b73d70f2e40ff39353d686cbc59d48c93217ed362d2b2baf1ba", size = 40345, upload-time = "2026-05-30T12:39:09.474Z" }
 wheels = [
@@ -1842,6 +2105,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" },
 ]
 
+[[package]]
+name = "python-discovery"
+version = "1.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "filelock" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0b/1a/cbbaf13b730abb0a16b964d984e19f2fe520c21a4dc664051359a3f5a9e7/python_discovery-1.4.2.tar.gz", hash = "sha256:8f3746c4b4968d22afbb97d36e1a0e5b66e6c0f297290f2e95f05b9b8bf18690", size = 70277, upload-time = "2026-06-11T16:10:42.383Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/82/a70006589557f267f15bd384c0642ad49f0d97b690c3a05b166b9dcbad3b/python_discovery-1.4.2-py3-none-any.whl", hash = "sha256:475803f53b7b2ed6e490e27373f9d8340f7d2eebf9acdaf645d7d714c97bb500", size = 33886, upload-time = "2026-06-11T16:10:41.192Z" },
+]
+
 [[package]]
 name = "python-dotenv"
 version = "1.2.2"
@@ -2029,6 +2305,31 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ea/ea/e7b0251441da9adfeaebcf29601d10f2a1455fcf0772fae9e7e19032bd96/rpds_py-2026.5.1-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:8c43a8a973270fd173bf48cdf80bbe66312421cba68d40845034f174f2389049", size = 586326, upload-time = "2026-05-28T12:02:11.47Z" },
 ]
 
+[[package]]
+name = "ruff"
+version = "0.15.17"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/a9/3abdf488f1bf3d24c699415e454ed554a6350d5d89ce183be1ee0a3361ac/ruff-0.15.17.tar.gz", hash = "sha256:2ec446937fd16c8c4de2674a209cc5af64d9c6f17d21fbf1151054fa0bcf5219", size = 4743346, upload-time = "2026-06-11T17:54:47.663Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/4d/e11259f5da07cb6afb2d074c31bf09da9671993f7329d4f15d2fdc458301/ruff-0.15.17-py3-none-linux_armv6l.whl", hash = "sha256:d9feddb927fc68bd295f5eebc587a7e42cfaf9b65f60ca4a2386febff575da8f", size = 10856677, upload-time = "2026-06-11T17:54:49.533Z" },
+    { url = "https://files.pythonhosted.org/packages/29/3e/772d679e1a0dc058e58875bd2c0cb713a0530877b4a76fee3c7966df0d49/ruff-0.15.17-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:25805a226d741c47d274a35ad5c10a7dde175fcddfa511d7cf3da0a21eb3eab7", size = 11223443, upload-time = "2026-06-11T17:55:00.573Z" },
+    { url = "https://files.pythonhosted.org/packages/68/58/bd41f7688b2fd5623012605130ed70e60aa7f2244baa3d5066bdd61530c8/ruff-0.15.17-py3-none-macosx_11_0_arm64.whl", hash = "sha256:f6ad73b14c2d18a3bf8ad7cb6974294d7f613a7898604826058e6ac64918ef4d", size = 10566458, upload-time = "2026-06-11T17:55:07.52Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/5b/733371013fcf1ec339e477ece6ab42bfe10bdd9bba8ee88a9516aa56bfc0/ruff-0.15.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ba0c1e4f95bcb3869d0d30cbd5917071ef2e28665abfec970cdab0492c713ed", size = 10914483, upload-time = "2026-06-11T17:55:05.501Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/cc/6f24251cc0252f7239391ccb85833f320efad14ebe5b443943f37ced6332/ruff-0.15.17-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:81647960f10bff57d2e51cadd0c3950fe598400c852863a038720ef5b8cca91e", size = 10647497, upload-time = "2026-06-11T17:54:57.733Z" },
+    { url = "https://files.pythonhosted.org/packages/68/dd/0d10c17ce1a1624d6fc3156309c3f834fdb5dfaad026ec90c85684f3990e/ruff-0.15.17-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0e01a84ddbc8c16c23055ba3924476850f1bbc1917cebbb9376665a63e74260d", size = 11416967, upload-time = "2026-06-11T17:54:51.461Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/91/556bfb156f6144f355e831c23db00b2fc4120f86b3ce81cc5f7fd2df51f3/ruff-0.15.17-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:84fe9f653152f8f294f9f7e03bf3a453d8b4a27f7a59c78c8666167f2b17b96c", size = 12335770, upload-time = "2026-06-11T17:54:45.793Z" },
+    { url = "https://files.pythonhosted.org/packages/88/82/8b5999aa13355e926f06d9f42a32dcca862f623bf0363785ff89d607dffd/ruff-0.15.17-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c0fe88a7676e7a05b73174d4d4a59cb2ac21ff8263583f87a81a6018475a978", size = 11575441, upload-time = "2026-06-11T17:54:32.661Z" },
+    { url = "https://files.pythonhosted.org/packages/11/93/f10377bb04109ca0e8cbc483ff1982c54b6d418210041776f93e8cdc7fa9/ruff-0.15.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ecfc3c7878fff94633ab0348524e093f9ce3243080416dd7d14f8ba400174719", size = 11557614, upload-time = "2026-06-11T17:54:34.698Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/a6/eeeae7f7d5493df41649ab3db92f086b2d0a30199e4efdf8e3dd7a033f24/ruff-0.15.17-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:b8461180b22420b1bdc289909410930761629fddf2a5aaf60fae1ab26cedc4c4", size = 11544450, upload-time = "2026-06-11T17:54:39.042Z" },
+    { url = "https://files.pythonhosted.org/packages/32/88/5991ce565129a24dd4a00db1254b3b5db2e53018cbe4018ea5a89738e727/ruff-0.15.17-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:6eccbe50a038b503e7140b441aa9c7fc8c1f36edf23ebef9f4165c2f28f568b7", size = 10892524, upload-time = "2026-06-11T17:55:09.432Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/1d/0fdd248313425f55223968af04b0a42125466a8d88d21c1d99c6af0a51e8/ruff-0.15.17-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:382fc0521025f5a8ad447d8bdd523545d0d7646adb718eb1c2dac5065ec27c0f", size = 10659573, upload-time = "2026-06-11T17:54:36.824Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/0e/072e8260deb9461062ce9311ced27a8e541229a6ffd483013dd37661e43e/ruff-0.15.17-py3-none-musllinux_1_2_i686.whl", hash = "sha256:456d41fcd1b2777ad63f09a6e7121d43f7b688bbc76a800c10f7f8fb1f912c3f", size = 11127818, upload-time = "2026-06-11T17:55:03.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/b4/55060a34163121498014696b5f656db5b8c6963768f227dbf0d76b311073/ruff-0.15.17-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:b1a04bcc94ae6194e9db05d16ad31f298a7194bfbcb08258bbe589cee1d587b8", size = 11655901, upload-time = "2026-06-11T17:54:53.562Z" },
+    { url = "https://files.pythonhosted.org/packages/49/71/9b29d6b87cef468d697f43c6a91e3fae4a80185779d7d5a4ef27d173439f/ruff-0.15.17-py3-none-win32.whl", hash = "sha256:596065960ab1ff593f744220c9fe6580eda00a95003cffa9f4048bb5b1bf0392", size = 10925574, upload-time = "2026-06-11T17:54:55.723Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/b2/8fc77f3723228836fa5d12497eb71c808f83782e10d058d2b15cfa14640b/ruff-0.15.17-py3-none-win_amd64.whl", hash = "sha256:6769e5fa1710b179b92e0bfa5a51735b35baea9013dadb06d5f44cbcf9547084", size = 12058788, upload-time = "2026-06-11T17:54:41.042Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/c7/c53e8dbff9c9dc4b7928773421ae294a5d28fcb8dcda1a089579d3a7e510/ruff-0.15.17-py3-none-win_arm64.whl", hash = "sha256:f3be1fbb34bcdfd146240d8fb92a709d4c2c8191348580a3c044ec60fa0b4456", size = 11355275, upload-time = "2026-06-11T17:54:43.635Z" },
+]
+
 [[package]]
 name = "scikit-image"
 version = "0.25.2"
@@ -2588,6 +2889,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/99/39/6b3f7d234ba3964c428a6e40006340f53ba37993f46ed6e111c6e9141d18/uvloop-0.22.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:512fec6815e2dd45161054592441ef76c830eddaad55c8aa30952e6fe1ed07c0", size = 4296343, upload-time = "2025-10-16T22:16:35.149Z" },
 ]
 
+[[package]]
+name = "virtualenv"
+version = "21.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+    { name = "python-discovery" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f1/a5/81f987504738e6defeed61ec1c47e2aefab3c35d8eeb87e1b3f38cf28254/virtualenv-21.5.1.tar.gz", hash = "sha256:dca3bf98275a59c652b69d68e73433e597d977c2da9198882479d1a7188009c8", size = 4578798, upload-time = "2026-06-16T16:23:58.603Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/02/3623e6169bed617ed1e2d372f7c69f92ec28d54c4dfc997055c8578ec148/virtualenv-21.5.1-py3-none-any.whl", hash = "sha256:55aa670b67bbfb991b03fda39bd3276d92c419d702376e98c5df1c9989a26783", size = 4558820, upload-time = "2026-06-16T16:23:56.963Z" },
+]
+
 [[package]]
 name = "watchfiles"
 version = "1.2.0"
@@ -2690,7 +3007,7 @@ name = "winrt-runtime"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions" },
+    { name = "typing-extensions", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/16/dd/acdd527c1d890c8f852cc2af644aa6c160974e66631289420aa871b05e65/winrt_runtime-3.2.1.tar.gz", hash = "sha256:c8dca19e12b234ae6c3dadf1a4d0761b51e708457492c13beb666556958801ea", size = 21721, upload-time = "2025-06-06T14:40:27.593Z" }
 wheels = [
@@ -2710,7 +3027,7 @@ name = "winrt-windows-devices-bluetooth"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/b2/a0/1c8a0c469abba7112265c6cb52f0090d08a67c103639aee71fc690e614b8/winrt_windows_devices_bluetooth-3.2.1.tar.gz", hash = "sha256:db496d2d92742006d5a052468fc355bf7bb49e795341d695c374746113d74505", size = 23732, upload-time = "2025-06-06T14:41:20.489Z" }
 wheels = [
@@ -2730,7 +3047,7 @@ name = "winrt-windows-devices-bluetooth-advertisement"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/06/fc/7ffe66ca4109b9e994b27c00f3d2d506e6e549e268791f755287ad9106d8/winrt_windows_devices_bluetooth_advertisement-3.2.1.tar.gz", hash = "sha256:0223852a7b7fa5c8dea3c6a93473bd783df4439b1ed938d9871f947933e574cc", size = 16906, upload-time = "2025-06-06T14:41:21.448Z" }
 wheels = [
@@ -2750,7 +3067,7 @@ name = "winrt-windows-devices-bluetooth-genericattributeprofile"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/44/21/aeeddc0eccdfbd25e543360b5cc093233e2eab3cdfb53ad3cabae1b5d04d/winrt_windows_devices_bluetooth_genericattributeprofile-3.2.1.tar.gz", hash = "sha256:cdf6ddc375e9150d040aca67f5a17c41ceaf13a63f3668f96608bc1d045dde71", size = 38896, upload-time = "2025-06-06T14:41:22.687Z" }
 wheels = [
@@ -2770,7 +3087,7 @@ name = "winrt-windows-devices-enumeration"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/9e/dd/75835bfbd063dffa152109727dedbd80f6e92ea284855f7855d48cdf31c9/winrt_windows_devices_enumeration-3.2.1.tar.gz", hash = "sha256:df316899e39bfc0ffc1f3cb0f5ee54d04e1d167fbbcc1484d2d5121449a935cf", size = 23538, upload-time = "2025-06-06T14:41:26.787Z" }
 wheels = [
@@ -2790,7 +3107,7 @@ name = "winrt-windows-devices-radios"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/5e/02/9704ea359ad8b0d6faa1011f98fb477e8fb6eac5201f39d19e73c2407e7b/winrt_windows_devices_radios-3.2.1.tar.gz", hash = "sha256:4dc9b9d1501846049eb79428d64ec698d6476c27a357999b78a8331072e18a0b", size = 5908, upload-time = "2025-06-06T14:41:44.868Z" }
 wheels = [
@@ -2810,7 +3127,7 @@ name = "winrt-windows-foundation"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/0c/55/098ce7ea0679efcc1298b269c48768f010b6c68f90c588f654ec874c8a74/winrt_windows_foundation-3.2.1.tar.gz", hash = "sha256:ad2f1fcaa6c34672df45527d7c533731fdf65b67c4638c2b4aca949f6eec0656", size = 30485, upload-time = "2025-06-06T14:41:53.344Z" }
 wheels = [
@@ -2830,7 +3147,7 @@ name = "winrt-windows-foundation-collections"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/ef/62/d21e3f1eeb8d47077887bbf0c3882c49277a84d8f98f7c12bda64d498a07/winrt_windows_foundation_collections-3.2.1.tar.gz", hash = "sha256:0eff1ad0d8d763ad17e9e7bbd0c26a62b27215016393c05b09b046d6503ae6d5", size = 16043, upload-time = "2025-06-06T14:41:53.983Z" }
 wheels = [
@@ -2850,7 +3167,7 @@ name = "winrt-windows-storage-streams"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "winrt-runtime" },
+    { name = "winrt-runtime", marker = "sys_platform != 'darwin' or extra != 'extra-6-gently-torch-cpu' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/00/50/f4488b07281566e3850fcae1021f0285c9653992f60a915e15567047db63/winrt_windows_storage_streams-3.2.1.tar.gz", hash = "sha256:476f522722751eb0b571bc7802d85a82a3cae8b1cce66061e6e758f525e7b80f", size = 34335, upload-time = "2025-06-06T14:43:23.905Z" }
 wheels = [

From 4d503f8c652c96d5659ba95d7030d39497fc2428 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 21:29:14 +0530
Subject: [PATCH 163/314] docs(temperature): design spec for temperature
 interface (sub-project A)

Persistence (session-scoped temperature.jsonl + per-acquisition meta stamp)
+ live SVG graph (water trace, stepped setpoint) on a Devices-tab card.
First slice of the temp-strain experiment prep roadmap (A before B/manual mode).

Brainstormed and approved 2026-06-27.
---
 ...2026-06-27-temperature-interface-design.md | 179 ++++++++++++++++++
 1 file changed, 179 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-06-27-temperature-interface-design.md

diff --git a/docs/superpowers/specs/2026-06-27-temperature-interface-design.md b/docs/superpowers/specs/2026-06-27-temperature-interface-design.md
new file mode 100644
index 00000000..30de5138
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-27-temperature-interface-design.md
@@ -0,0 +1,179 @@
+# Design: Temperature Interface (persistence + live graph)
+
+Status: design approved in brainstorm (2026-06-27).
+Base branch: off `integration/ux2-all` (PR #58, the UX-v2 stack) — this feature builds on that UI.
+
+## 0. Where this sits (execution roadmap)
+
+This is **sub-project A** of a sequenced program of work, preparing gently for
+production temperature-strain experiments next week. The full order (commit history is
+meant to reflect this priority):
+
+- **Track 1 — critical path for next week**
+  - **A. Temperature interface** *(this spec)* — persist temperature + live graph.
+  - **B. Manual mode** — write-enabled control surface (illumination from MMConfig presets,
+    live camera view, volume/timelapse config + by-hand triggers, temperature setpoint
+    control). Embeds A's graph.
+- **Track 2 — fast-follow (repeatability + observability)**
+  - **C. Temp-change burst tactic** — a `MonitoringMode` choreographing
+    transmission-burst → setpoint-change → bursts-during → bursts-after.
+  - **D. Operations-tab overhaul** — make composed tactics observable.
+- **Track 4 — later infrastructure**
+  - **G. Tactics library** (user-/agent-authored, persisted, reusable tactics), then
+  - **F. Plan-mode files** (repo base plans + session↔plan link/delink UI).
+- **Lowest**
+  - **E. Presentation / README.**
+
+Next week's first experiment round is **hand-driven** (A + B). A is foundational because
+B embeds its graph and C/D both consume the persisted temperature series.
+
+## 1. Overview
+
+The temperature controller (ACUITYnano Peltier stage, `gently/hardware/temperature.py`) is
+already integrated as a Bluesky device: `read()` returns water temp + setpoint + state live,
+exposed over the device layer at `GET /api/temperature/status`, with `set_temperature` /
+`get_temperature` agent tools. The web UI already has an SSE push channel
+(`DEVICE_STATE_UPDATE`) and shows temperature read-only in `devices.js`.
+
+**Two things are missing, and this sub-project supplies exactly those two:**
+
+1. **Persistence** — temperature is live-only today. `ImagingSpec.temperature_c` is a
+   *planned setpoint*, never a recorded readout. Nothing writes actual temperature into the
+   session or burst files, so a burst cannot be correlated to "what was the temperature."
+   This is the one real data hole for the experiment.
+2. **A live graph** — a continuous chart of current temperature, setpoint, and the rise/fall
+   trajectory over time.
+
+### What we keep / reuse
+- The controller's existing `read()` and the device-layer `GET /api/temperature/status` route.
+- The existing SSE push mechanism (`websocket.js` / `event-bus.js` / `status-store.js`).
+- The file-based, human-browsable store convention (`FileStore`, append-only jsonl like
+  `timeline.jsonl` / `predictions.jsonl`).
+- The hand-rolled-SVG charting style already used in `experiment-overview.js` /
+  `occupancy3d.js` — **no new charting dependency.**
+- The "calm empty state, never mock data" UI convention.
+
+### Scope decision: session-scoped capture
+Temperature is captured **only while an imaging session is active** (decided in brainstorm).
+No always-on facility daemon, no between-session global log. The series belongs to the
+session, which is where correlation matters.
+
+## 2. Architecture — five well-bounded units
+
+### 2.1 Temperature log store (persistence)
+Append-only series, one file per session: `sessions/{session}/temperature.jsonl`.
+Dedicated file — **not** folded into `timeline.jsonl`, because 1 Hz samples would drown the
+event stream and a standalone series is trivial to read and plot.
+
+API (methods on / adjacent to `FileStore`, `gently/core/file_store.py`):
+- `append_temperature_sample(session_id, sample)` — atomic append of one line.
+- `read_temperature_log(session_id, since=None)` — return samples, optionally filtered to
+  those at/after a timestamp (for the graph's rolling window / backfill).
+
+Sample schema (one jsonl line):
+```json
+{"t": "2026-06-27T10:31:04.512Z", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"}
+```
+`state` mirrors the controller's reported state string (e.g. heating / cooling / locked).
+
+### 2.2 Temperature sampler (the capture loop)
+A small background service in the **agent** process (persistence and session lifecycle are
+agent-side). While a session is active it:
+- polls the device layer's `GET /api/temperature/status` on a fixed cadence,
+- appends each reading to the session's `temperature.jsonl` via 2.1,
+- holds the **latest reading in memory** (so acquisition can stamp it without a blocking read),
+- emits an SSE `TEMPERATURE_UPDATE` event for the live graph.
+
+Lifecycle: started/stopped with the session. If no temperature device is configured (the
+`temperature:` block is config-gated in `device_layer.py`), the sampler does not run.
+
+Cadence: **1 Hz**, configurable via the existing `temperature:` config block. (Thermal change
+is slow; 1 Hz gives a smooth trace without flooding the log.)
+
+### 2.3 Acquisition stamp (image↔temperature correlation)
+At volume / burst acquisition, write the sampler's latest reading into the acquisition's
+metadata:
+- volume: `embryos/{id}/volumes/t{NNNN}.meta.yaml`
+- burst: each frame `.meta.yaml` and the `burst.yaml` manifest
+  (`gently/app/orchestration/exclusive.py`).
+
+Stamped block:
+```yaml
+temperature:
+  water_c: 28.4
+  setpoint_c: 32.0
+  state: heating
+  sampled_at: 2026-06-27T10:31:04.512Z   # timestamp of the reading, not of acquisition
+```
+We stamp the **latest sample** rather than a fresh blocking device read — at 1 Hz it is
+current enough, and acquisition stays latency-free. If no sample exists yet (session just
+started), omit the `temperature` block rather than writing stale/zero values.
+
+### 2.4 Read API (graph backfill)
+`GET /api/temperature/history?session=current&since=<iso>` returns the series for the initial
+graph render and reloads (`session=current` resolves to the most-recently-touched session,
+matching the existing experiments route convention). Live updates ride the existing SSE
+channel via `TEMPERATURE_UPDATE`; the endpoint is only for backfill.
+
+### 2.5 Frontend component (the graph)
+`gently/ui/web/static/js/temperature-graph.js` — a hand-rolled SVG line chart, reusable and
+self-mounting, surfaced as a **card on the Devices tab** (where temperature already shows
+read-only). B (manual mode) re-mounts the same component.
+
+Renders:
+- **water-temp trace** (continuous line),
+- **setpoint line** (distinct, stepped — so a commanded jump from 28→32 reads as a step while
+  the water trace climbs toward it),
+- **current numeric readouts** (water, setpoint, state) above the chart,
+- a **rolling time window** (last few minutes) with full-history fetch on demand.
+
+Data: backfills from 2.4 on mount, then appends from the `TEMPERATURE_UPDATE` SSE stream.
+
+## 3. Data flow
+
+```
+device layer (owns controller)
+        ▲  GET /api/temperature/status   (poll @ 1 Hz, while session active)
+        │
+   agent: TemperatureSampler ──► append temperature.jsonl   (persistence)
+        │                    └─► keep latest-in-memory ──► acquisition stamps meta
+        └─► emit SSE TEMPERATURE_UPDATE ──► browser: temperature-graph.js (live append)
+
+browser on mount/reload: GET /api/temperature/history?session=current ──► backfill graph
+```
+
+## 4. Error handling & edge cases
+
+- **No temperature device / device layer down** → sampler no-ops; graph shows a calm
+  "no temperature data" empty state (matching the codebase convention). Never mock data.
+- **A failed poll** → log a gap and continue; a sampler error never crashes the session.
+- **Partial last jsonl line** (atomic append + a reader tolerant of a truncated final line) →
+  the history endpoint skips an unparseable trailing line rather than erroring.
+- **Acquisition before first sample** → omit the `temperature` block from meta (no stale/zero).
+- **Setpoint change** → captured naturally: the next sample carries the new `setpoint_c`, so
+  the stepped setpoint line moves on its own; no special event needed.
+
+## 5. Testing (TDD)
+
+- **Store**: `append_temperature_sample` / `read_temperature_log` round-trip; `since` filter;
+  tolerance of a truncated trailing line.
+- **Sampler**: against the existing mock controller scaffold
+  (`gently/hardware/dispim/devices/test_temperature_controller.py`) — samples at cadence,
+  appends, updates latest-in-memory, emits SSE; **no-device path** (sampler stays dormant);
+  a poll failure leaves a gap without raising.
+- **Acquisition stamp**: a fake volume + burst acquisition stamps the latest sample into meta;
+  the no-sample-yet path omits the block.
+- **History endpoint**: filters by `since`; `session=current` resolution.
+- **Frontend**: a light render test for the SVG component — water trace + stepped setpoint
+  geometry, and the empty state when history is empty.
+
+## 6. Out of scope (deferred to later sub-projects)
+
+- **Setpoint *control* from the UI** — belongs to B (manual mode), which embeds this graph.
+- **Automated temp-change choreography** — belongs to C (the tactic).
+- **Always-on / facility-wide temperature logging** — explicitly not now (session-scoped only).
+
+## 7. Open defaults (easy to flip)
+
+- **1 Hz** sampling cadence.
+- Stamp the **latest sample** (not a fresh blocking read) at acquisition time.

From d1c881fd28b5b8b95ca30df26a72ab441678cf73 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 21:42:59 +0530
Subject: [PATCH 164/314] docs(temperature): TDD implementation plan for
 temperature interface (7 tasks)

---
 .../plans/2026-06-27-temperature-interface.md | 793 ++++++++++++++++++
 1 file changed, 793 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-27-temperature-interface.md

diff --git a/docs/superpowers/plans/2026-06-27-temperature-interface.md b/docs/superpowers/plans/2026-06-27-temperature-interface.md
new file mode 100644
index 00000000..ab02b895
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-27-temperature-interface.md
@@ -0,0 +1,793 @@
+# Temperature Interface Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Persist live temperature into each imaging session and chart it, so bursts/volumes are correlatable to temperature and the rise/fall trajectory is visible during the temperature-strain experiments.
+
+**Architecture:** A `FileStore`-backed append-only `temperature.jsonl` per session (mirroring `predictions.jsonl`); a `TemperatureSampler(Service)` in the agent process — modeled on `DeviceStateMonitor` — that, while a session is active, polls the device layer at 1 Hz, appends each reading, holds the latest in memory, and publishes a `TEMPERATURE_UPDATE` event that the viz server already forwards to the browser; acquisition code stamps the latest reading into volume/burst metadata; a FastAPI history route backfills the graph; a hand-rolled SVG component renders water-temp + stepped-setpoint as a card on the Devices tab.
+
+**Tech Stack:** Python 3 + asyncio, FastAPI, the project's `EventBus`, `FileStore` (file-based YAML/JSONL), vanilla-JS + hand-rolled SVG frontend (no build step), pytest with `asyncio_mode = "auto"`.
+
+## Global Constraints
+
+- **No new dependency** — chart is hand-rolled SVG (`createElementNS`), matching `experiment-overview.js`. No charting library.
+- **Session-scoped capture only** — sampler persists/emits **only while a session is active**; no always-on facility daemon.
+- **Sample schema** (one JSONL line): `{"t": <iso-utc>, "water_c": <float>, "setpoint_c": <float|null>, "state": <str|null>}`.
+- **Append pattern**: reuse `FileStore._append_jsonl` (append mode, `json.dumps(..., default=str)`, trailing `\n`). Meta written via existing `_write_yaml` / `yaml.safe_dump`.
+- **Defaults (flippable):** 1 Hz sampling; stamp the **latest sample** (no fresh blocking read) at acquisition.
+- **Robustness:** a failed poll = a gap, logged, loop continues; a sampler error never crashes the session. Empty state, **never mock data**.
+- **Tests:** `pytest`; `async def test_*` needs no decorator (auto mode); use the `file_store` fixture (`tests/conftest.py:38-45`, `FileStore(tmp_path/...)`). The frontend has **no JS unit harness** — verify it by running the app + Chrome DevTools MCP.
+- **Env:** production runs pip + `requirements*.txt` (no `uv`); we add no deps, so nothing to declare.
+
+---
+
+### Task 1: Temperature log store (FileStore methods)
+
+**Files:**
+- Modify: `gently/core/file_store.py` (add two methods on `FileStore`; reuse module-level `_append_jsonl` at `:197-201` and `_read_jsonl` at `:204-215`, and `_session_dir`/`_require_session_dir` at `:255-269`)
+- Test: `tests/test_temperature_store.py` (new)
+
+**Interfaces:**
+- Produces:
+  - `FileStore.append_temperature_sample(self, session_id: str, sample: dict) -> None` — appends one line to `sessions/{folder}/temperature.jsonl`.
+  - `FileStore.read_temperature_log(self, session_id: str, since: str | None = None) -> list[dict]` — returns samples; if `since` (an ISO-UTC string) is given, only samples with `r["t"] >= since` (lexicographic compare is valid for fixed-format UTC ISO).
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_temperature_store.py
+def _new_session(file_store):
+    return file_store.create_session(name="temp-test")  # returns session_id
+
+def test_append_and_read_roundtrip(file_store):
+    sid = _new_session(file_store)
+    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"})
+    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.3, "setpoint_c": 32.0, "state": "heating"})
+    rows = file_store.read_temperature_log(sid)
+    assert [r["water_c"] for r in rows] == [28.0, 28.3]
+
+def test_read_since_filters(file_store):
+    sid = _new_session(file_store)
+    for i, t in enumerate(["2026-06-27T10:00:00+00:00", "2026-06-27T10:00:01+00:00", "2026-06-27T10:00:02+00:00"]):
+        file_store.append_temperature_sample(sid, {"t": t, "water_c": 28.0 + i, "setpoint_c": 32.0, "state": "heating"})
+    rows = file_store.read_temperature_log(sid, since="2026-06-27T10:00:01+00:00")
+    assert [r["water_c"] for r in rows] == [29.0, 30.0]
+
+def test_read_unknown_session_is_empty(file_store):
+    assert file_store.read_temperature_log("does-not-exist") == []
+```
+
+> NOTE for implementer: confirm the exact session-creation API on `FileStore` (search for `def create_session`). If its signature differs, adjust `_new_session` accordingly — the rest of the test is unaffected.
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_temperature_store.py -v`
+Expected: FAIL — `AttributeError: 'FileStore' object has no attribute 'append_temperature_sample'`
+
+- [ ] **Step 3: Write minimal implementation**
+
+Add to the `FileStore` class body in `gently/core/file_store.py` (near the other per-session jsonl helpers like `add_prediction`):
+
+```python
+def append_temperature_sample(self, session_id: str, sample: dict) -> None:
+    """Append one temperature reading to the session's temperature.jsonl."""
+    sd = self._require_session_dir(session_id)
+    _append_jsonl(sd / "temperature.jsonl", sample)
+
+def read_temperature_log(self, session_id: str, since: str | None = None) -> list[dict]:
+    """Return temperature samples for a session, optionally filtered to t >= since (ISO-UTC string)."""
+    sd = self._session_dir(session_id)
+    if sd is None:
+        return []
+    rows = _read_jsonl(sd / "temperature.jsonl")
+    if since is not None:
+        rows = [r for r in rows if str(r.get("t", "")) >= since]
+    return rows
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_temperature_store.py -v`
+Expected: PASS (3 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/core/file_store.py tests/test_temperature_store.py
+git commit -m "feat(temperature): session-scoped temperature.jsonl store on FileStore"
+```
+
+---
+
+### Task 2: `TEMPERATURE_UPDATE` event type
+
+**Files:**
+- Modify: `gently/core/event_bus.py` (add enum member near `:86`; add to `_NO_HISTORY_TYPES` near `:187`)
+- Test: `tests/test_temperature_event.py` (new)
+
+**Interfaces:**
+- Produces: `EventType.TEMPERATURE_UPDATE` (a new enum member). High-volume → excluded from event history.
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_temperature_event.py
+from gently.core.event_bus import EventType, EventBus
+
+def test_temperature_update_event_exists():
+    assert EventType.TEMPERATURE_UPDATE.value == "TEMPERATURE_UPDATE"
+
+def test_temperature_update_publishes_to_subscriber():
+    bus = EventBus()
+    seen = []
+    bus.subscribe(EventType.TEMPERATURE_UPDATE, lambda e: seen.append(e.data))
+    bus.publish(event_type=EventType.TEMPERATURE_UPDATE, data={"x": 1}, source="t")
+    assert seen == [{"x": 1}]
+```
+
+> NOTE: confirm `EventBus.subscribe` signature/usage from an existing test (`tests/` has event-bus usage); adjust the subscribe call if the project's API differs (e.g. `subscribe(event_type, handler)` vs `subscribe(handler, event_type)`).
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_temperature_event.py -v`
+Expected: FAIL — `AttributeError: TEMPERATURE_UPDATE`
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `gently/core/event_bus.py`, add the member alongside the other `EventType` values (mirror how `DEVICE_STATE_UPDATE` at `:86` is declared — match the existing value style, e.g. `TEMPERATURE_UPDATE = "TEMPERATURE_UPDATE"`):
+
+```python
+    TEMPERATURE_UPDATE = "TEMPERATURE_UPDATE"
+```
+
+And add it to the high-volume set so it is not retained in history (next to `DEVICE_STATE_UPDATE` in `_NO_HISTORY_TYPES` near `:187`):
+
+```python
+    EventType.TEMPERATURE_UPDATE,
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_temperature_event.py -v`
+Expected: PASS (2 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/core/event_bus.py tests/test_temperature_event.py
+git commit -m "feat(temperature): add TEMPERATURE_UPDATE event type"
+```
+
+---
+
+### Task 3: TemperatureSampler service
+
+**Files:**
+- Create: `gently/app/temperature_sampler.py`
+- Test: `tests/test_temperature_sampler.py` (new)
+- Reference (template, do not modify): `gently/app/device_state_monitor.py`, `gently/core/service.py:63-172`
+
+**Interfaces:**
+- Consumes: `EventType.TEMPERATURE_UPDATE` (Task 2); `FileStore.append_temperature_sample` (Task 1); a microscope client exposing `async get_temperature() -> dict` returning `{"success": bool, "temperature_c": float, "setpoint_c": float, "state": str, ...}` (`gently/hardware/dispim/client.py:837`).
+- Produces:
+  - `TemperatureSampler(Service)` with `__init__(self, microscope, store, session_id_getter, interval_sec=1.0)`.
+  - `async on_start(self)` / `async on_stop(self)` (background asyncio loop, like `DeviceStateMonitor`).
+  - `async _tick(self, bus) -> None` — one poll/append/emit cycle (the unit under test).
+  - attribute `self.latest: dict | None` — most recent sample (for the acquisition stamp).
+  - module function `temperature_stamp(latest: dict | None) -> dict | None` — `{"water_c","setpoint_c","state","sampled_at"}` or `None`.
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_temperature_sampler.py
+import asyncio
+from gently.core.event_bus import EventBus, EventType
+from gently.app.temperature_sampler import TemperatureSampler, temperature_stamp
+
+
+class FakeScope:
+    def __init__(self, resp):
+        self.resp = resp
+        self.calls = 0
+    async def get_temperature(self):
+        self.calls += 1
+        if isinstance(self.resp, Exception):
+            raise self.resp
+        return self.resp
+
+
+def _capture(bus):
+    seen = []
+    bus.subscribe(EventType.TEMPERATURE_UPDATE, lambda e: seen.append(e.data))
+    return seen
+
+
+async def test_tick_appends_emits_and_sets_latest(file_store):
+    sid = file_store.create_session(name="s")
+    scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    bus = EventBus(); seen = _capture(bus)
+    s = TemperatureSampler(scope, file_store, lambda: sid)
+    await s._tick(bus)
+    rows = file_store.read_temperature_log(sid)
+    assert len(rows) == 1 and rows[0]["water_c"] == 28.4
+    assert s.latest["water_c"] == 28.4
+    assert seen and seen[0]["sample"]["water_c"] == 28.4 and seen[0]["session_id"] == sid
+
+
+async def test_tick_no_active_session_is_noop(file_store):
+    scope = FakeScope({"success": True, "temperature_c": 1.0, "setpoint_c": 2.0, "state": "x"})
+    bus = EventBus(); seen = _capture(bus)
+    s = TemperatureSampler(scope, file_store, lambda: None)
+    await s._tick(bus)
+    assert scope.calls == 0 and s.latest is None and seen == []
+
+
+async def test_tick_poll_failure_is_a_gap_not_a_crash(file_store):
+    sid = file_store.create_session(name="s")
+    scope = FakeScope(RuntimeError("device down"))
+    bus = EventBus()
+    s = TemperatureSampler(scope, file_store, lambda: sid)
+    # _run swallows; _tick raises — assert the loop-level guard swallows by calling _run-style guard:
+    try:
+        await s._tick(bus)
+    except RuntimeError:
+        pass  # _tick may raise; the loop in _run catches it (see test below)
+    assert file_store.read_temperature_log(sid) == []
+
+
+def test_temperature_stamp_shapes():
+    assert temperature_stamp(None) is None
+    assert temperature_stamp({"t": "2026-06-27T10:00:00+00:00", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"}) == {
+        "water_c": 28.4, "setpoint_c": 32.0, "state": "heating", "sampled_at": "2026-06-27T10:00:00+00:00",
+    }
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_temperature_sampler.py -v`
+Expected: FAIL — `ModuleNotFoundError: gently.app.temperature_sampler`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# gently/app/temperature_sampler.py
+"""Session-scoped temperature sampler — polls the device layer, persists, emits.
+
+Modeled on gently/app/device_state_monitor.py. While a session is active it polls
+the microscope's temperature at a fixed cadence, appends each reading to the
+session's temperature.jsonl, holds the latest reading (for acquisition stamping),
+and publishes TEMPERATURE_UPDATE for the live graph. A failed poll is a gap, not a
+crash; with no active session the loop idles.
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+from datetime import datetime, timezone
+
+from gently.core.service import Service
+from gently.core.event_bus import get_event_bus, EventType
+
+logger = logging.getLogger(__name__)
+
+
+def _now_iso() -> str:
+    return datetime.now(timezone.utc).isoformat()
+
+
+def temperature_stamp(latest: dict | None) -> dict | None:
+    """Build a temperature meta block from a latest sample, or None if unavailable."""
+    if not latest:
+        return None
+    return {
+        "water_c": latest.get("water_c"),
+        "setpoint_c": latest.get("setpoint_c"),
+        "state": latest.get("state"),
+        "sampled_at": latest.get("t"),
+    }
+
+
+class TemperatureSampler(Service):
+    def __init__(self, microscope, store, session_id_getter, interval_sec: float = 1.0):
+        super().__init__(name="temperature-sampler", service_type="monitor")
+        self._microscope = microscope
+        self._store = store
+        self._session_id_getter = session_id_getter
+        self._interval = interval_sec
+        self._task: asyncio.Task | None = None
+        self.latest: dict | None = None
+
+    async def on_start(self) -> None:
+        self._task = asyncio.create_task(self._run(), name="temperature-sampler-loop")
+
+    async def on_stop(self) -> None:
+        if self._task is not None:
+            self._task.cancel()
+            try:
+                await self._task
+            except asyncio.CancelledError:
+                pass
+            self._task = None
+
+    async def _run(self) -> None:
+        bus = get_event_bus()
+        while True:
+            try:
+                await self._tick(bus)
+            except asyncio.CancelledError:
+                raise
+            except Exception as exc:  # a gap, never a crash
+                logger.warning("temperature sampler tick failed: %s", exc)
+            await asyncio.sleep(self._interval)
+
+    async def _tick(self, bus) -> None:
+        session_id = self._session_id_getter()
+        if not session_id:
+            return
+        resp = await self._microscope.get_temperature()
+        if not resp or not resp.get("success", True):
+            return
+        water = resp.get("temperature_c")
+        if water is None:
+            return
+        sample = {
+            "t": _now_iso(),
+            "water_c": water,
+            "setpoint_c": resp.get("setpoint_c"),
+            "state": resp.get("state"),
+        }
+        self._store.append_temperature_sample(session_id, sample)
+        self.latest = sample
+        bus.publish(
+            event_type=EventType.TEMPERATURE_UPDATE,
+            data={"session_id": session_id, "sample": sample},
+            source="temperature-sampler",
+        )
+```
+
+> Note the failure test: `_tick` propagates the poll exception, and `_run`'s `except Exception` swallows it. The test asserts the gap (no rows). If you prefer, also add a direct `_run`-guard test that starts the loop briefly and asserts it does not raise — optional.
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_temperature_sampler.py -v`
+Expected: PASS (4 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/app/temperature_sampler.py tests/test_temperature_sampler.py
+git commit -m "feat(temperature): TemperatureSampler service (poll/persist/emit @1Hz)"
+```
+
+---
+
+### Task 4: Wire the sampler into the agent lifecycle
+
+**Files:**
+- Modify: `gently/app/agent.py` — init attribute (near `:212`), construct+start (near the `DeviceStateMonitor` block `:818-827` inside `start_viz_server`), stop (near `:850-855`).
+- Test: `tests/test_temperature_sampler_wiring.py` (new)
+
+**Interfaces:**
+- Consumes: `TemperatureSampler` (Task 3); the agent's microscope client (`self.microscope`), its `FileStore`, and `self.session_id`.
+- Produces: `agent.temperature_sampler: TemperatureSampler | None` (the live instance, read by the acquisition stamp in Task 6).
+
+> IMPLEMENTER: confirm the agent's FileStore attribute name before writing the construction line. Search `gently/app/agent.py` for the `FileStore` it uses (likely `self.store`). Use that exact attribute. If the agent reaches the store indirectly, pass whatever object exposes `append_temperature_sample`.
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_temperature_sampler_wiring.py
+from gently.app.temperature_sampler import TemperatureSampler
+
+def test_agent_initializes_temperature_sampler_attribute():
+    # The attribute must exist (None until start_viz_server runs with a microscope).
+    import gently.app.agent as agent_mod
+    src = (agent_mod.__file__)
+    text = open(src, encoding="utf-8").read()
+    assert "temperature_sampler" in text
+    assert "TemperatureSampler(" in text
+```
+
+> This is a light wiring guard (a full agent boot is an integration concern). It fails until the wiring lines exist.
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_temperature_sampler_wiring.py -v`
+Expected: FAIL — assertion error ("temperature_sampler" not in source)
+
+- [ ] **Step 3: Write minimal implementation**
+
+Near `:212` (with the other monitor attrs, e.g. `self.device_state_monitor = None`):
+
+```python
+        self.temperature_sampler = None
+```
+
+Inside `start_viz_server`, right after the `DeviceStateMonitor` start block (`:818-827`):
+
+```python
+            if self.microscope is not None and self.temperature_sampler is None:
+                from .temperature_sampler import TemperatureSampler
+                self.temperature_sampler = TemperatureSampler(
+                    self.microscope, self.store, lambda: self.session_id
+                )
+                await self.temperature_sampler.start()
+```
+
+In the symmetric shutdown path (`:850-855`, where `device_state_monitor.stop()` is awaited):
+
+```python
+            if self.temperature_sampler is not None:
+                await self.temperature_sampler.stop()
+                self.temperature_sampler = None
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_temperature_sampler_wiring.py -v`
+Expected: PASS (1 passed)
+
+Then full suite sanity: `pytest -q` — Expected: no new failures.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/app/agent.py tests/test_temperature_sampler_wiring.py
+git commit -m "feat(temperature): start/stop TemperatureSampler with the agent"
+```
+
+---
+
+### Task 5: History API route
+
+**Files:**
+- Create: `gently/ui/web/routes/temperature.py`
+- Modify: `gently/ui/web/routes/__init__.py` (import + add to the factories tuple in `register_all_routes`)
+- Test: `tests/test_temperature_route.py` (new)
+- Reference (template): `gently/ui/web/routes/experiments.py:1-66`, test template `tests/test_data_catalog.py:69-114`
+
+**Interfaces:**
+- Consumes: `server.gently_store` (a `FileStore`) with `list_sessions()`, `_session_dir(id)`, and `read_temperature_log(id, since=)` (Task 1).
+- Produces: `GET /api/temperature/{session_id}/history?since=<iso>` → `{"session_id": str, "samples": list[dict]}`; `session_id="current"` resolves to newest session.
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_temperature_route.py
+from unittest.mock import MagicMock
+from pathlib import Path
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+from gently.ui.web.routes.temperature import create_router
+
+
+def _server(samples, sessions=(("sess-1", True),)):
+    store = MagicMock()
+    store.list_sessions.return_value = [{"session_id": sid} for sid, _ in sessions]
+    store._session_dir.side_effect = lambda sid: Path("/x") if any(sid == s for s, _ in sessions) else None
+    store.read_temperature_log.return_value = samples
+    srv = MagicMock(); srv.gently_store = store
+    return srv, store
+
+
+def _client(server):
+    app = FastAPI(); app.include_router(create_router(server))
+    return TestClient(app)
+
+
+def test_history_returns_samples():
+    srv, store = _server([{"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"}])
+    r = _client(srv).get("/api/temperature/sess-1/history")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["session_id"] == "sess-1"
+    assert body["samples"][0]["water_c"] == 28.0
+
+
+def test_history_passes_since_through():
+    srv, store = _server([])
+    _client(srv).get("/api/temperature/sess-1/history?since=2026-06-27T10:00:01+00:00")
+    store.read_temperature_log.assert_called_with("sess-1", since="2026-06-27T10:00:01+00:00")
+
+
+def test_history_current_resolves_newest():
+    srv, store = _server([], sessions=(("newest", True),))
+    r = _client(srv).get("/api/temperature/current/history")
+    assert r.status_code == 200
+    assert r.json()["session_id"] == "newest"
+
+
+def test_history_unknown_session_404():
+    srv, store = _server([], sessions=(("sess-1", True),))
+    # _session_dir returns None for unknown -> 404
+    store._session_dir.side_effect = lambda sid: None
+    r = _client(srv).get("/api/temperature/ghost/history")
+    assert r.status_code == 404
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_temperature_route.py -v`
+Expected: FAIL — `ModuleNotFoundError: gently.ui.web.routes.temperature`
+
+- [ ] **Step 3: Write minimal implementation**
+
+```python
+# gently/ui/web/routes/temperature.py
+"""Read-only temperature history for the live graph (backfill on mount/reload).
+
+Live updates ride the TEMPERATURE_UPDATE event channel; this route is backfill only.
+Mirrors routes/experiments.py session resolution.
+"""
+from fastapi import APIRouter, HTTPException
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _resolve_session(session_id: str):
+        store = getattr(server, "gently_store", None)
+        if store is None:
+            raise HTTPException(status_code=503, detail="FileStore not configured on viz server")
+        if session_id == "current":
+            sessions = store.list_sessions()
+            if not sessions:
+                raise HTTPException(status_code=404, detail="No sessions in store")
+            session_id = sessions[0].get("session_id")
+        if store._session_dir(session_id) is None:
+            raise HTTPException(status_code=404, detail=f"Session not found: {session_id}")
+        return session_id
+
+    @router.get("/api/temperature/{session_id}/history")
+    async def get_history(session_id: str, since: str | None = None):
+        real_id = _resolve_session(session_id)
+        store = server.gently_store
+        samples = store.read_temperature_log(real_id, since=since)
+        return {"session_id": real_id, "samples": samples}
+
+    return router
+```
+
+Register it in `gently/ui/web/routes/__init__.py` — add the import and append `create_router` to the factories iterated by `register_all_routes` (follow the existing pattern exactly; alias to avoid name clashes, e.g. `from .temperature import create_router as create_temperature_router`).
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_temperature_route.py -v`
+Expected: PASS (4 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/routes/temperature.py gently/ui/web/routes/__init__.py tests/test_temperature_route.py
+git commit -m "feat(temperature): GET /api/temperature/{session}/history backfill route"
+```
+
+---
+
+### Task 6: Acquisition temperature stamp (burst + volume)
+
+**Files:**
+- Modify: `gently/app/orchestration/exclusive.py` — `_persist_burst_to_disk` (per-frame `metadata` at `:387-407`, `burst.yaml` manifest dict at `:423-442`); the `BurstAcquisition`/`ExclusiveAcquisition` construction to receive a temperature provider.
+- Modify: the volume acquisition call site that builds `metadata` for `FileStore.put_volume`/`register_volume` (locate the caller in `gently/app/orchestration/timelapse.py` / `gently/app/tools/acquisition_tools.py`).
+- Test: `tests/test_temperature_stamp.py` (new) — covers the pure helper + the volume metadata channel.
+- Consumes: `temperature_stamp` and `agent.temperature_sampler.latest` (Tasks 3–4).
+
+**Interfaces:**
+- Produces: a `temperature` block under `metadata` for volumes (`meta["metadata"]["temperature"]`) and under both per-frame `metadata` and the `burst.yaml` manifest top-level for bursts.
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_temperature_stamp.py
+import numpy as np
+from gently.app.temperature_sampler import temperature_stamp
+
+
+def test_stamp_none_when_no_reading():
+    assert temperature_stamp(None) is None
+
+def test_volume_metadata_carries_temperature(file_store):
+    sid = file_store.create_session(name="s")
+    emb = file_store.create_embryo(sid, position={"x": 0, "y": 0, "z": 0})  # confirm signature
+    stamp = temperature_stamp({"t": "2026-06-27T10:00:00+00:00", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    vol = np.zeros((2, 4, 4), dtype="uint16")
+    file_store.put_volume(sid, emb, timepoint=0, volume=vol, metadata={"temperature": stamp})
+    meta = file_store.get_volume_meta(sid, emb, 0)  # confirm accessor name
+    assert meta["metadata"]["temperature"]["water_c"] == 28.4
+```
+
+> IMPLEMENTER: confirm `create_embryo` and the volume-meta accessor (`get_volume_meta` or read the `.meta.yaml` directly via `get_volume_path(...).with_suffix` — adjust to the real API). The assertion target — `metadata["temperature"]` round-tripping into `t0000.meta.yaml` — is the contract; `put_volume` already nests the passed `metadata`, so this passes once the helper exists and the accessor is right.
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_temperature_stamp.py -v`
+Expected: FAIL — initially on import/accessor; fix the accessor name from the real API, then it exercises the channel.
+
+- [ ] **Step 3: Write minimal implementation**
+
+**Volume path** — at the acquisition call site that calls `put_volume`/`register_volume`, fold the stamp into the existing `metadata` dict:
+
+```python
+from gently.app.temperature_sampler import temperature_stamp
+# ... where `agent` (or self) holds the sampler and `metadata` is being built:
+stamp = temperature_stamp(getattr(getattr(agent, "temperature_sampler", None), "latest", None))
+if stamp is not None:
+    metadata["temperature"] = stamp
+```
+
+**Burst path** — `gently/app/orchestration/exclusive.py`:
+1. Add a constructor param to the acquisition class that persists bursts: `temperature_provider=None` (a zero-arg callable returning the latest sample dict, or `None`), stored as `self._temperature_provider`.
+2. In `_persist_burst_to_disk`, compute once:
+
+```python
+from gently.app.temperature_sampler import temperature_stamp
+_temp = temperature_stamp(self._temperature_provider() if self._temperature_provider else None)
+```
+
+3. Inject into the per-frame `metadata` dict (`:387-407`): add `"temperature": _temp` (only when not None — or always; `None` is acceptable YAML).
+4. Inject into the `burst.yaml` manifest dict (`:423-442`): add a top-level `"temperature": _temp`.
+5. Where this acquisition class is constructed (the orchestrator that owns bursts — `gently/app/orchestration/timelapse.py`), pass `temperature_provider=lambda: agent.temperature_sampler.latest if agent.temperature_sampler else None` (use the orchestrator's existing agent/store handle; confirm the attribute).
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_temperature_stamp.py -v`
+Expected: PASS
+
+- [ ] **Step 5: Verify burst wiring by inspection + targeted run**
+
+The burst persist writes real TIFFs, so it is verified by inspection (the `_temp` block is added in both dict sites) plus, during end-to-end verification (after Task 7), trigger one burst against the mock device and confirm `burst.yaml` and a frame `.meta.yaml` contain a `temperature` block. Note in the commit if the volume call site could not be located and was deferred — do not silently skip it.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add gently/app/orchestration/exclusive.py gently/app/orchestration/timelapse.py tests/test_temperature_stamp.py
+git commit -m "feat(temperature): stamp latest reading into burst + volume metadata"
+```
+
+---
+
+### Task 7: Frontend — temperature graph component + Devices card
+
+**Files:**
+- Create: `gently/ui/web/static/js/temperature-graph.js`
+- Modify: `gently/ui/web/templates/index.html` — add a chart container inside `#devices-content` (the existing small readout is at `:452-465`; mount the chart as a section under the Details/Map view).
+- Modify: `gently/ui/web/static/js/devices.js` — initialize the chart in `init()` (`:1556`) and subscribe it to `TEMPERATURE_UPDATE` (next to the `DEVICE_STATE_UPDATE` subscription at `:1561`).
+- Reference (SVG style): `gently/ui/web/static/js/experiment-overview.js`; (event API) `gently/ui/web/static/js/event-bus.js:9-48` (`ClientEventBus.on(type, handler)`).
+
+**No JS unit harness exists** — this task is verified by running the app + Chrome DevTools MCP (see Step 4), consistent with the repo and the "UI audit before done" practice.
+
+- [ ] **Step 1: Build the component**
+
+Create `temperature-graph.js` exposing a small object/module:
+
+```javascript
+// gently/ui/web/static/js/temperature-graph.js
+// Hand-rolled SVG line chart: water-temp trace + stepped setpoint line.
+// No dependency. Backfills from /api/temperature/{session}/history, then appends
+// from TEMPERATURE_UPDATE events. Calm empty state, never mock data.
+const TemperatureGraph = (() => {
+  const SVGNS = "http://www.w3.org/2000/svg";
+  const MAX_POINTS = 600;           // rolling ~10 min @ 1 Hz
+  let _root = null, _samples = [], _session = "current";
+
+  function init(container, sessionId) {
+    _root = container; _session = sessionId || "current"; _samples = [];
+    backfill();
+    ClientEventBus.on("TEMPERATURE_UPDATE", onEvent);
+  }
+
+  async function backfill() {
+    try {
+      const r = await fetch(`/api/temperature/${_session}/history`);
+      if (!r.ok) { renderEmpty(); return; }
+      const body = await r.json();
+      _session = body.session_id || _session;
+      _samples = (body.samples || []).slice(-MAX_POINTS);
+      render();
+    } catch (e) { renderEmpty(); }
+  }
+
+  function onEvent(data) {
+    if (!data || !data.sample) return;
+    _samples.push(data.sample);
+    if (_samples.length > MAX_POINTS) _samples.shift();
+    render();
+  }
+
+  function renderEmpty() {
+    _root.innerHTML = '<div class="temp-graph-empty">No temperature data yet</div>';
+  }
+
+  function render() {
+    if (!_samples.length) { renderEmpty(); return; }
+    const W = _root.clientWidth || 480, H = 160, pad = 24;
+    const xs = _samples.map((_, i) => i);
+    const ws = _samples.map(s => s.water_c).filter(v => v != null);
+    const sps = _samples.map(s => s.setpoint_c).filter(v => v != null);
+    const lo = Math.min(...ws, ...sps) - 1, hi = Math.max(...ws, ...sps) + 1;
+    const sx = i => pad + (i / Math.max(1, xs.length - 1)) * (W - 2 * pad);
+    const sy = v => H - pad - ((v - lo) / Math.max(0.001, hi - lo)) * (H - 2 * pad);
+
+    const svg = document.createElementNS(SVGNS, "svg");
+    svg.setAttribute("viewBox", `0 0 ${W} ${H}`); svg.setAttribute("width", "100%");
+
+    const line = (pts, cls) => {
+      const p = document.createElementNS(SVGNS, "polyline");
+      p.setAttribute("points", pts); p.setAttribute("class", cls);
+      p.setAttribute("fill", "none"); svg.appendChild(p);
+    };
+    line(_samples.map((s, i) => s.water_c != null ? `${sx(i)},${sy(s.water_c)}` : "").filter(Boolean).join(" "), "temp-water");
+    // Stepped setpoint: carry previous y until it changes.
+    let sp = []; _samples.forEach((s, i) => { if (s.setpoint_c != null) sp.push(`${sx(i)},${sy(s.setpoint_c)}`); });
+    line(sp.join(" "), "temp-setpoint");
+
+    const last = _samples[_samples.length - 1];
+    const readout = document.createElement("div");
+    readout.className = "temp-graph-readout";
+    readout.textContent = `${last.water_c?.toFixed?.(1) ?? "—"} °C → ${last.setpoint_c?.toFixed?.(1) ?? "—"} °C (${last.state ?? ""})`;
+
+    _root.innerHTML = ""; _root.appendChild(readout); _root.appendChild(svg);
+  }
+
+  function dispose() { ClientEventBus.off("TEMPERATURE_UPDATE", onEvent); }
+  return { init, dispose, _render: render, _samples: () => _samples };
+})();
+window.TemperatureGraph = TemperatureGraph;
+```
+
+Add minimal CSS (in the devices stylesheet) for `.temp-water` (stroke: water color), `.temp-setpoint` (dashed stroke), `.temp-graph-empty` (muted), matching existing palette.
+
+- [ ] **Step 2: Mount it**
+
+In `templates/index.html`, add inside `#devices-content` (under the map/details view):
+
+```html
+<section class="devices-temp-graph" id="devices-temp-graph" aria-label="Temperature trajectory"></section>
+```
+
+Load the script (next to the other `static/js/*.js` includes for the devices tab).
+
+In `devices.js` `init()` (`:1556`), after existing setup:
+
+```javascript
+    const tg = document.getElementById('devices-temp-graph');
+    if (tg && window.TemperatureGraph) TemperatureGraph.init(tg, 'current');
+```
+
+(No extra subscription needed in `devices.js` — the component self-subscribes. Optionally also route the existing small readout off the new event.)
+
+- [ ] **Step 3: Add the script tag**
+
+Add `<script src="/static/js/temperature-graph.js"></script>` in `index.html` alongside the other component scripts, **before** `devices.js` loads (so `window.TemperatureGraph` exists when `init()` runs).
+
+- [ ] **Step 4: Verify live in the app (Chrome DevTools MCP)**
+
+Use the `run` skill to launch the app with the mock temperature backend and an active session. Then with Chrome DevTools MCP:
+- navigate to the Devices tab, take a snapshot/screenshot;
+- confirm the empty state shows when no samples, then the water trace + stepped setpoint render and update live as the sampler emits;
+- run the UI audit (alignment/spacing/overflow/contrast) per the "UI audit before done" practice and fix any flaws;
+- trigger one burst and confirm (Task 6) that `burst.yaml` + a frame `.meta.yaml` carry a `temperature` block.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/static/js/temperature-graph.js gently/ui/web/templates/index.html gently/ui/web/static/js/devices.js
+git commit -m "feat(temperature): live SVG temperature graph on the Devices tab"
+```
+
+---
+
+## Self-Review
+
+**Spec coverage:**
+- Persistence / `temperature.jsonl` → Task 1. ✓
+- Sampler (poll @1 Hz, session-gated, latest-in-memory, SSE) → Tasks 2–4. ✓
+- Per-acquisition stamp (burst + volume) → Task 6. ✓
+- History API (`current` resolution, `since`) → Task 5. ✓
+- Reusable SVG graph on Devices card (water trace + stepped setpoint + readout, backfill + live, empty state) → Task 7. ✓
+- Error/empty handling (gap-not-crash, no-device idle, empty state) → Tasks 3 & 7. ✓
+- Out-of-scope (setpoint control, choreography, always-on) → not implemented, by design. ✓
+
+**Open verification items folded into tasks (not placeholders):** session-creation API (Task 1/3/6), `EventBus.subscribe` shape (Task 2), the agent's FileStore attribute (Task 4), the volume-meta accessor + `create_embryo` signature (Task 6), the burst-acquisition construction site (Task 6). Each is an explicit "confirm from the real API" instruction with a concrete fallback, not a TODO.
+
+**Type consistency:** `temperature_stamp` returns `{water_c, setpoint_c, state, sampled_at}` everywhere; sample lines are `{t, water_c, setpoint_c, state}`; event payload is `{session_id, sample}`; history response is `{session_id, samples}`. Consistent across Tasks 1/3/5/6/7.

From 06a5883eb38dc57f4e627b5dff12ac0d8c1ab43d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 21:46:05 +0530
Subject: [PATCH 165/314] feat(temperature): session-scoped temperature.jsonl
 store on FileStore

---
 gently/core/file_store.py       | 15 +++++++++++++++
 tests/test_temperature_store.py | 34 +++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 tests/test_temperature_store.py

diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 5a8b7f01..467d0c5e 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -444,6 +444,21 @@ def load_session_snapshot(self, session_id: str) -> dict | None:
         with open(path, encoding="utf-8") as f:
             return json.load(f)
 
+    def append_temperature_sample(self, session_id: str, sample: dict) -> None:
+        """Append one temperature reading to the session's temperature.jsonl."""
+        sd = self._require_session_dir(session_id)
+        _append_jsonl(sd / "temperature.jsonl", sample)
+
+    def read_temperature_log(self, session_id: str, since: str | None = None) -> list[dict]:
+        """Return temperature samples for a session, optionally filtered to t >= since (ISO-UTC string)."""
+        sd = self._session_dir(session_id)
+        if sd is None:
+            return []
+        rows = _read_jsonl(sd / "temperature.jsonl")
+        if since is not None:
+            rows = [r for r in rows if str(r.get("t", "")) >= since]
+        return rows
+
     # ------------------------------------------------------------------
     # Session lock
     # ------------------------------------------------------------------
diff --git a/tests/test_temperature_store.py b/tests/test_temperature_store.py
new file mode 100644
index 00000000..b51da792
--- /dev/null
+++ b/tests/test_temperature_store.py
@@ -0,0 +1,34 @@
+"""Tests for FileStore temperature log methods."""
+
+import pytest
+
+
+def _new_session(file_store):
+    """Create a test session and return its ID."""
+    # Use UUID-based session ID for uniqueness
+    import uuid
+    session_id = str(uuid.uuid4())
+    return file_store.create_session(session_id, name="temp-test")
+
+
+def test_append_and_read_roundtrip(file_store):
+    """Test appending and reading temperature samples."""
+    sid = _new_session(file_store)
+    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"})
+    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.3, "setpoint_c": 32.0, "state": "heating"})
+    rows = file_store.read_temperature_log(sid)
+    assert [r["water_c"] for r in rows] == [28.0, 28.3]
+
+
+def test_read_since_filters(file_store):
+    """Test that read_temperature_log filters by since parameter."""
+    sid = _new_session(file_store)
+    for i, t in enumerate(["2026-06-27T10:00:00+00:00", "2026-06-27T10:00:01+00:00", "2026-06-27T10:00:02+00:00"]):
+        file_store.append_temperature_sample(sid, {"t": t, "water_c": 28.0 + i, "setpoint_c": 32.0, "state": "heating"})
+    rows = file_store.read_temperature_log(sid, since="2026-06-27T10:00:01+00:00")
+    assert [r["water_c"] for r in rows] == [29.0, 30.0]
+
+
+def test_read_unknown_session_is_empty(file_store):
+    """Test that reading from a non-existent session returns empty list."""
+    assert file_store.read_temperature_log("does-not-exist") == []

From 3279c8f77e2d0ea3b7ecfb6d24619cc146256359 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 21:49:28 +0530
Subject: [PATCH 166/314] feat(temperature): add TEMPERATURE_UPDATE event type

---
 gently/core/event_bus.py        |  2 ++
 tests/test_temperature_event.py | 21 +++++++++++++++++++++
 2 files changed, 23 insertions(+)
 create mode 100644 tests/test_temperature_event.py

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index ce3aac03..b3bd7e68 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -84,6 +84,7 @@ class EventType(Enum):
     FOCUS_CHANGED = auto()
     LASER_CHANGED = auto()
     DEVICE_STATE_UPDATE = auto()  # Periodic device-state snapshot from device layer
+    TEMPERATURE_UPDATE = auto()  # Temperature reading from device layer
     BOTTOM_CAMERA_FRAME = auto()  # Live JPEG frame from the bottom camera stream
     EMBRYOS_UPDATE = auto()  # Full embryo list snapshot from agent.experiment
     SCAN_GEOMETRY_UPDATE = auto()  # Scan cuboid + light-sheet mode for the 3D optical-space view
@@ -185,6 +186,7 @@ class EventType(Enum):
 _NO_HISTORY_TYPES = frozenset(
     {
         EventType.DEVICE_STATE_UPDATE,
+        EventType.TEMPERATURE_UPDATE,  # High-volume telemetry from temperature controller
         EventType.BOTTOM_CAMERA_FRAME,  # ~2 Hz JPEG frames — would crowd history out
         EventType.LOG_RECORD,  # log lines can hit hundreds/min during
         # calibration; durable copy is in the
diff --git a/tests/test_temperature_event.py b/tests/test_temperature_event.py
new file mode 100644
index 00000000..388976aa
--- /dev/null
+++ b/tests/test_temperature_event.py
@@ -0,0 +1,21 @@
+"""
+Test suite for TEMPERATURE_UPDATE event type
+"""
+
+from gently.core.event_bus import EventType, EventBus
+
+
+def test_temperature_update_event_exists():
+    """Verify TEMPERATURE_UPDATE enum member exists with correct name"""
+    assert hasattr(EventType, 'TEMPERATURE_UPDATE')
+    event_type = EventType.TEMPERATURE_UPDATE
+    assert event_type.name == "TEMPERATURE_UPDATE"
+
+
+def test_temperature_update_publishes_to_subscriber():
+    """Verify publishing TEMPERATURE_UPDATE reaches subscribers"""
+    bus = EventBus()
+    seen = []
+    bus.subscribe(EventType.TEMPERATURE_UPDATE, lambda e: seen.append(e.data))
+    bus.publish(event_type=EventType.TEMPERATURE_UPDATE, data={"x": 1}, source="t")
+    assert seen == [{"x": 1}]

From 81bba23ae739dfaae830ae236350edc055c67e5c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 21:54:22 +0530
Subject: [PATCH 167/314] feat(temperature): TemperatureSampler service
 (poll/persist/emit @1Hz)

---
 gently/app/temperature_sampler.py | 92 +++++++++++++++++++++++++++++++
 tests/test_temperature_sampler.py | 73 ++++++++++++++++++++++++
 2 files changed, 165 insertions(+)
 create mode 100644 gently/app/temperature_sampler.py
 create mode 100644 tests/test_temperature_sampler.py

diff --git a/gently/app/temperature_sampler.py b/gently/app/temperature_sampler.py
new file mode 100644
index 00000000..5ccec94d
--- /dev/null
+++ b/gently/app/temperature_sampler.py
@@ -0,0 +1,92 @@
+"""Session-scoped temperature sampler — polls the device layer, persists, emits.
+
+Modeled on gently/app/device_state_monitor.py. While a session is active it polls
+the microscope's temperature at a fixed cadence, appends each reading to the
+session's temperature.jsonl, holds the latest reading (for acquisition stamping),
+and publishes TEMPERATURE_UPDATE for the live graph. A failed poll is a gap, not a
+crash; with no active session the loop idles.
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+from datetime import datetime, timezone
+
+from gently.core.service import Service
+from gently.core.event_bus import get_event_bus, EventType
+
+logger = logging.getLogger(__name__)
+
+
+def _now_iso() -> str:
+    return datetime.now(timezone.utc).isoformat()
+
+
+def temperature_stamp(latest: dict | None) -> dict | None:
+    """Build a temperature meta block from a latest sample, or None if unavailable."""
+    if not latest:
+        return None
+    return {
+        "water_c": latest.get("water_c"),
+        "setpoint_c": latest.get("setpoint_c"),
+        "state": latest.get("state"),
+        "sampled_at": latest.get("t"),
+    }
+
+
+class TemperatureSampler(Service):
+    def __init__(self, microscope, store, session_id_getter, interval_sec: float = 1.0):
+        super().__init__(name="temperature-sampler", service_type="monitor")
+        self._microscope = microscope
+        self._store = store
+        self._session_id_getter = session_id_getter
+        self._interval = interval_sec
+        self._task: asyncio.Task | None = None
+        self.latest: dict | None = None
+
+    async def on_start(self) -> None:
+        self._task = asyncio.create_task(self._run(), name="temperature-sampler-loop")
+
+    async def on_stop(self) -> None:
+        if self._task is not None:
+            self._task.cancel()
+            try:
+                await self._task
+            except asyncio.CancelledError:
+                pass
+            self._task = None
+
+    async def _run(self) -> None:
+        bus = get_event_bus()
+        while True:
+            try:
+                await self._tick(bus)
+            except asyncio.CancelledError:
+                raise
+            except Exception as exc:  # a gap, never a crash
+                logger.warning("temperature sampler tick failed: %s", exc)
+            await asyncio.sleep(self._interval)
+
+    async def _tick(self, bus) -> None:
+        session_id = self._session_id_getter()
+        if not session_id:
+            return
+        resp = await self._microscope.get_temperature()
+        if not resp or not resp.get("success", True):
+            return
+        water = resp.get("temperature_c")
+        if water is None:
+            return
+        sample = {
+            "t": _now_iso(),
+            "water_c": water,
+            "setpoint_c": resp.get("setpoint_c"),
+            "state": resp.get("state"),
+        }
+        self._store.append_temperature_sample(session_id, sample)
+        self.latest = sample
+        bus.publish(
+            event_type=EventType.TEMPERATURE_UPDATE,
+            data={"session_id": session_id, "sample": sample},
+            source="temperature-sampler",
+        )
diff --git a/tests/test_temperature_sampler.py b/tests/test_temperature_sampler.py
new file mode 100644
index 00000000..3e208069
--- /dev/null
+++ b/tests/test_temperature_sampler.py
@@ -0,0 +1,73 @@
+"""Tests for TemperatureSampler service.
+
+Adaptation note: create_session() requires session_id as its first positional
+argument (confirmed from file_store.py:328). The brief's
+`file_store.create_session(name="s")` is adapted to
+`file_store.create_session(str(uuid.uuid4()), name="s")` to match the real API.
+"""
+import asyncio
+import uuid
+
+from gently.core.event_bus import EventBus, EventType
+from gently.app.temperature_sampler import TemperatureSampler, temperature_stamp
+
+
+class FakeScope:
+    def __init__(self, resp):
+        self.resp = resp
+        self.calls = 0
+
+    async def get_temperature(self):
+        self.calls += 1
+        if isinstance(self.resp, Exception):
+            raise self.resp
+        return self.resp
+
+
+def _capture(bus):
+    seen = []
+    bus.subscribe(EventType.TEMPERATURE_UPDATE, lambda e: seen.append(e.data))
+    return seen
+
+
+async def test_tick_appends_emits_and_sets_latest(file_store):
+    sid = file_store.create_session(str(uuid.uuid4()), name="s")
+    scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    bus = EventBus()
+    seen = _capture(bus)
+    s = TemperatureSampler(scope, file_store, lambda: sid)
+    await s._tick(bus)
+    rows = file_store.read_temperature_log(sid)
+    assert len(rows) == 1 and rows[0]["water_c"] == 28.4
+    assert s.latest["water_c"] == 28.4
+    assert seen and seen[0]["sample"]["water_c"] == 28.4 and seen[0]["session_id"] == sid
+
+
+async def test_tick_no_active_session_is_noop(file_store):
+    scope = FakeScope({"success": True, "temperature_c": 1.0, "setpoint_c": 2.0, "state": "x"})
+    bus = EventBus()
+    seen = _capture(bus)
+    s = TemperatureSampler(scope, file_store, lambda: None)
+    await s._tick(bus)
+    assert scope.calls == 0 and s.latest is None and seen == []
+
+
+async def test_tick_poll_failure_is_a_gap_not_a_crash(file_store):
+    sid = file_store.create_session(str(uuid.uuid4()), name="s")
+    scope = FakeScope(RuntimeError("device down"))
+    bus = EventBus()
+    s = TemperatureSampler(scope, file_store, lambda: sid)
+    # _tick propagates the poll exception; _run's except-Exception swallows it.
+    # Assert the gap (no rows).
+    try:
+        await s._tick(bus)
+    except RuntimeError:
+        pass  # _tick may raise; the loop in _run catches it
+    assert file_store.read_temperature_log(sid) == []
+
+
+def test_temperature_stamp_shapes():
+    assert temperature_stamp(None) is None
+    assert temperature_stamp({"t": "2026-06-27T10:00:00+00:00", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"}) == {
+        "water_c": 28.4, "setpoint_c": 32.0, "state": "heating", "sampled_at": "2026-06-27T10:00:00+00:00",
+    }

From 122a5804a94ff4223dc8c01ee61c3185dfe96e06 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:00:04 +0530
Subject: [PATCH 168/314] feat(temperature): start/stop TemperatureSampler with
 the agent

---
 gently/app/agent.py                      | 21 +++++++++++++++++
 tests/test_temperature_sampler_wiring.py | 30 ++++++++++++++++++++++++
 2 files changed, 51 insertions(+)
 create mode 100644 tests/test_temperature_sampler_wiring.py

diff --git a/gently/app/agent.py b/gently/app/agent.py
index f68d67a7..3794f141 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -210,6 +210,8 @@ def __init__(
 
         # Device-state monitor (bridges device-layer SSE → EventBus)
         self.device_state_monitor = None
+        # Session-scoped temperature sampler — polls device layer, persists readings.
+        self.temperature_sampler = None
         # Opt-in bottom-camera stream bridge — created when viz starts, but
         # left unstarted until the operator clicks "Start camera" in the UI.
         self.bottom_camera_monitor = None
@@ -826,6 +828,19 @@ async def start_viz_server(
                 logger.warning(f"Failed to start device-state monitor: {e}")
                 self.device_state_monitor = None
 
+        if self.microscope is not None and self.temperature_sampler is None:
+            try:
+                from .temperature_sampler import TemperatureSampler
+
+                self.temperature_sampler = TemperatureSampler(
+                    self.microscope, self.store, lambda: self.session_id
+                )
+                await self.temperature_sampler.start()
+                logger.info("Temperature sampler started")
+            except Exception as e:
+                logger.warning(f"Failed to start temperature sampler: {e}")
+                self.temperature_sampler = None
+
         # Construct the bottom-camera monitor — but don't start it. Streaming
         # is opt-in and waits for an explicit operator action via the
         # /api/devices/bottom_camera/stream/start route.
@@ -853,6 +868,12 @@ async def stop_viz_server(self):
             except Exception:
                 logger.exception("Failed to stop device-state monitor")
             self.device_state_monitor = None
+        if self.temperature_sampler is not None:
+            try:
+                await self.temperature_sampler.stop()
+            except Exception:
+                logger.exception("Failed to stop temperature sampler")
+            self.temperature_sampler = None
         if self.viz_server is not None:
             await self.viz_server.stop()
             self.viz_server = None
diff --git a/tests/test_temperature_sampler_wiring.py b/tests/test_temperature_sampler_wiring.py
new file mode 100644
index 00000000..9564d775
--- /dev/null
+++ b/tests/test_temperature_sampler_wiring.py
@@ -0,0 +1,30 @@
+"""Wiring guard: asserts that agent.py contains the TemperatureSampler lifecycle hooks.
+
+This is an intentionally lightweight source-text guard — a full agent boot is a
+heavy integration concern verified end-to-end in a later task.  DeviceStateMonitor's
+own wiring is likewise not unit-tested at this level.
+"""
+from gently.app.temperature_sampler import TemperatureSampler
+
+
+def test_agent_initializes_temperature_sampler_attribute():
+    """agent.py must declare the attribute *and* construct the sampler.
+
+    Uses find_spec to locate the source file without executing the module
+    (agent.py has heavy runtime deps like anthropic that aren't present in the
+    test environment).
+    """
+    import importlib.util
+    from pathlib import Path
+
+    spec = importlib.util.find_spec("gently.app.agent")
+    assert spec is not None and spec.origin is not None, (
+        "Could not locate gently/app/agent.py via importlib"
+    )
+    text = Path(spec.origin).read_text(encoding="utf-8")
+    assert "temperature_sampler" in text, (
+        "agent.py has no 'temperature_sampler' attribute"
+    )
+    assert "TemperatureSampler(" in text, (
+        "agent.py never constructs a TemperatureSampler"
+    )

From 1a062c299b047628d69f475c1e64dbf565f1b75f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:05:38 +0530
Subject: [PATCH 169/314] feat(temperature): GET
 /api/temperature/{session}/history backfill route

---
 gently/ui/web/routes/__init__.py    |  2 ++
 gently/ui/web/routes/temperature.py | 46 +++++++++++++++++++++++++++
 tests/test_temperature_route.py     | 49 +++++++++++++++++++++++++++++
 3 files changed, 97 insertions(+)
 create mode 100644 gently/ui/web/routes/temperature.py
 create mode 100644 tests/test_temperature_route.py

diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index 9f8cd903..66e8842c 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -13,6 +13,7 @@
 from .context import create_router as create_context_router
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
+from .temperature import create_router as create_temperature_router
 from .images import create_router as create_images_router
 from .notebook import create_router as create_notebook_router
 from .pages import create_router as create_pages_router
@@ -37,6 +38,7 @@ def register_all_routes(server):
         create_chat_router,
         create_context_router,
         create_notebook_router,
+        create_temperature_router,
     ):
         router = factory(server)
         server.app.include_router(router)
diff --git a/gently/ui/web/routes/temperature.py b/gently/ui/web/routes/temperature.py
new file mode 100644
index 00000000..1505714b
--- /dev/null
+++ b/gently/ui/web/routes/temperature.py
@@ -0,0 +1,46 @@
+"""Read-only temperature history for the live graph (backfill on mount/reload).
+
+Live updates ride the TEMPERATURE_UPDATE event channel; this route is backfill only.
+Mirrors routes/experiments.py session resolution.
+"""
+import urllib.parse
+
+from fastapi import APIRouter, HTTPException, Request
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _resolve_session(session_id: str):
+        store = getattr(server, "gently_store", None)
+        if store is None:
+            raise HTTPException(status_code=503, detail="FileStore not configured on viz server")
+        if session_id == "current":
+            sessions = store.list_sessions()
+            if not sessions:
+                raise HTTPException(status_code=404, detail="No sessions in store")
+            session_id = sessions[0].get("session_id")
+        if store._session_dir(session_id) is None:
+            raise HTTPException(status_code=404, detail=f"Session not found: {session_id}")
+        return session_id
+
+    @router.get("/api/temperature/{session_id}/history")
+    async def get_history(session_id: str, request: Request):
+        # Parse `since` from raw query string using unquote (not unquote_plus) so that
+        # timezone offsets like +00:00 are preserved. Standard FastAPI query-param
+        # parsing applies unquote_plus, which converts + to a space.
+        raw_qs = request.scope.get("query_string", b"").decode()
+        since = None
+        for part in raw_qs.split("&"):
+            if "=" in part:
+                k, v = part.split("=", 1)
+                if urllib.parse.unquote(k) == "since":
+                    since = urllib.parse.unquote(v)
+                    break
+
+        real_id = _resolve_session(session_id)
+        store = server.gently_store
+        samples = store.read_temperature_log(real_id, since=since)
+        return {"session_id": real_id, "samples": samples}
+
+    return router
diff --git a/tests/test_temperature_route.py b/tests/test_temperature_route.py
new file mode 100644
index 00000000..4cd02cf3
--- /dev/null
+++ b/tests/test_temperature_route.py
@@ -0,0 +1,49 @@
+from unittest.mock import MagicMock
+from pathlib import Path
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+from gently.ui.web.routes.temperature import create_router
+
+
+def _server(samples, sessions=(("sess-1", True),)):
+    store = MagicMock()
+    store.list_sessions.return_value = [{"session_id": sid} for sid, _ in sessions]
+    store._session_dir.side_effect = lambda sid: Path("/x") if any(sid == s for s, _ in sessions) else None
+    store.read_temperature_log.return_value = samples
+    srv = MagicMock(); srv.gently_store = store
+    return srv, store
+
+
+def _client(server):
+    app = FastAPI(); app.include_router(create_router(server))
+    return TestClient(app)
+
+
+def test_history_returns_samples():
+    srv, store = _server([{"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"}])
+    r = _client(srv).get("/api/temperature/sess-1/history")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["session_id"] == "sess-1"
+    assert body["samples"][0]["water_c"] == 28.0
+
+
+def test_history_passes_since_through():
+    srv, store = _server([])
+    _client(srv).get("/api/temperature/sess-1/history?since=2026-06-27T10:00:01+00:00")
+    store.read_temperature_log.assert_called_with("sess-1", since="2026-06-27T10:00:01+00:00")
+
+
+def test_history_current_resolves_newest():
+    srv, store = _server([], sessions=(("newest", True),))
+    r = _client(srv).get("/api/temperature/current/history")
+    assert r.status_code == 200
+    assert r.json()["session_id"] == "newest"
+
+
+def test_history_unknown_session_404():
+    srv, store = _server([], sessions=(("sess-1", True),))
+    # _session_dir returns None for unknown -> 404
+    store._session_dir.side_effect = lambda sid: None
+    r = _client(srv).get("/api/temperature/ghost/history")
+    assert r.status_code == 404

From a8e9817f61b1c4c1783a2160aca3e469068aad7b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:18:23 +0530
Subject: [PATCH 170/314] feat(temperature): stamp latest reading into burst +
 volume metadata
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- BurstAcquisition accepts temperature_provider (zero-arg callable);
  _persist_burst_to_disk injects temperature_stamp() into per-frame
  metadata["metadata"]["temperature"] and burst.yaml top-level "temperature"
- TimelapseOrchestrator accepts temperature_provider and threads it through
  queue_burst() and _apply_runtime_state() → BurstAcquisition
- agent.py passes lambda: temperature_sampler.latest when constructing the
  orchestrator so live sessions stamp real readings
- acquisition_tools: folds temperature_stamp into acq_metadata on every
  put_volume / register_volume call (volume path)
- FileStore.get_volume_meta() accessor added (reads tNNNN.meta.yaml)
- tests/test_temperature_stamp.py: TDD — None-guard + volume round-trip
---
 gently/app/agent.py                   |  5 +++
 gently/app/orchestration/exclusive.py | 13 +++++++
 gently/app/orchestration/timelapse.py |  8 ++++
 gently/app/tools/acquisition_tools.py |  8 ++++
 gently/core/file_store.py             | 10 +++++
 tests/test_temperature_stamp.py       | 54 +++++++++++++++++++++++++++
 6 files changed, 98 insertions(+)
 create mode 100644 tests/test_temperature_stamp.py

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 3794f141..afe2e649 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -635,6 +635,11 @@ def _init_timelapse_orchestrator(self):
                 session_id=self.session_id,
                 store=self.store,
                 claude_client=self.claude,
+                temperature_provider=lambda: (
+                    self.temperature_sampler.latest
+                    if self.temperature_sampler
+                    else None
+                ),
             )
         except Exception as e:
             logging.getLogger(__name__).warning(f"Failed to init timelapse orchestrator: {e}")
diff --git a/gently/app/orchestration/exclusive.py b/gently/app/orchestration/exclusive.py
index db9804bd..83b196d7 100644
--- a/gently/app/orchestration/exclusive.py
+++ b/gently/app/orchestration/exclusive.py
@@ -23,6 +23,8 @@
 
 import numpy as np
 
+from gently.app.temperature_sampler import temperature_stamp
+
 logger = logging.getLogger(__name__)
 
 
@@ -98,11 +100,13 @@ def __init__(
         mode: str = "1hz",
         num_slices: int = 1,
         request_id: str | None = None,
+        temperature_provider=None,
     ):
         super().__init__(target_embryo_id=target_embryo_id, request_id=request_id)
         self.frames = frames
         self.mode = mode if mode in ("1hz", "asap") else "1hz"
         self.num_slices = num_slices
+        self._temperature_provider = temperature_provider
 
     async def run(self, orchestrator) -> ExclusiveResult:
         from gently.core import EventType
@@ -204,6 +208,7 @@ async def run(self, orchestrator) -> ExclusiveResult:
             piezo_amplitude=piezo_amplitude,
             piezo_center=piezo_center,
             laser_power_488_pct=getattr(embryo, "laser_power_488_pct", None),
+            temperature_provider=self._temperature_provider,
         )
 
         # Generate MP4 (derivative artifact; safe to fail).
@@ -318,6 +323,7 @@ def _persist_burst_to_disk(
     piezo_amplitude: float,
     piezo_center: float,
     laser_power_488_pct: float | None,
+    temperature_provider=None,
 ) -> Path | None:
     """Save per-frame TIFFs + meta + projections + a burst.yaml manifest.
 
@@ -344,6 +350,11 @@ def _persist_burst_to_disk(
     proj_dir = burst_dir / "projections"
     proj_dir.mkdir(exist_ok=True)
 
+    # Compute temperature stamp once for the whole burst (all frames share the
+    # same reading — the sampler captures at ~1 Hz so per-frame variation is
+    # sub-resolution anyway).
+    _temp = temperature_stamp(temperature_provider() if temperature_provider else None)
+
     # Position recorded for the manifest.
     pos = getattr(embryo, "stage_position", {}) or {}
     sid = getattr(orchestrator, "_session_id", None)
@@ -403,6 +414,7 @@ def _persist_burst_to_disk(
                 "burst_mode": mode,
                 "laser_power_488_pct": laser_power_488_pct,
                 "role": "burst",
+                "temperature": _temp,
             },
         }
         if _yaml is not None:
@@ -432,6 +444,7 @@ def _persist_burst_to_disk(
         "sustained_hz": sustained_hz,
         "embryo_position": {"x": pos.get("x"), "y": pos.get("y")},
         "laser_power_488_pct": laser_power_488_pct,
+        "temperature": _temp,
         "scan": {
             "galvo_amplitude": galvo_amplitude,
             "galvo_center": galvo_center,
diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index 6b140922..5918bd9c 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -74,6 +74,7 @@ def __init__(
         session_id: str | None = None,
         store: Optional["FileStore"] = None,
         claude_client=None,
+        temperature_provider=None,
     ):
         """
         Parameters
@@ -102,6 +103,11 @@ def __init__(
         self.on_volume_callback = on_volume_callback
         self.claude_client = claude_client
 
+        # Zero-arg callable returning the latest temperature sample dict (or None).
+        # Threaded from the agent's TemperatureSampler so burst frames carry a
+        # temperature block in their metadata.
+        self._temperature_provider = temperature_provider
+
         # Trace file storage (writes JSON files to disk)
         self._session_id = session_id
         self._trace_dir: Path | None = None
@@ -1974,6 +1980,7 @@ def _parse_dt(s):
                         mode=op_doc.get("mode", "1hz"),
                         num_slices=int(op_doc.get("num_slices", 1)),
                         request_id=op_doc.get("request_id"),
+                        temperature_provider=self._temperature_provider,
                     )
                 )
 
@@ -2092,6 +2099,7 @@ def queue_burst(
             frames=frames,
             mode=mode,
             num_slices=num_slices,
+            temperature_provider=self._temperature_provider,
         )
         self._exclusive_queue.append(op)
         logger.info(
diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index 79f69732..6e029ad4 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -212,6 +212,14 @@ async def acquire_volume(
                             "piezo_center": piezo_center,
                         },
                     }
+                    from gently.app.temperature_sampler import temperature_stamp as _ts
+                    _temp_stamp = _ts(
+                        getattr(
+                            getattr(agent, "temperature_sampler", None), "latest", None
+                        )
+                    )
+                    if _temp_stamp is not None:
+                        acq_metadata["temperature"] = _temp_stamp
                     volume_path_ref = result.get("volume_path")
                     if volume_path_ref is not None:
                         saved_path = agent.store.register_volume(
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 467d0c5e..ae668232 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -750,6 +750,16 @@ def get_volume_path(self, session_id: str, embryo_id: str, timepoint: int) -> Pa
             return vol_path
         return None
 
+    def get_volume_meta(self, session_id: str, embryo_id: str, timepoint: int) -> dict | None:
+        """Read the sidecar metadata YAML for a volume.  Returns None if not found."""
+        sd = self._session_dir(session_id)
+        if sd is None:
+            return None
+        meta_path = (
+            sd / "embryos" / embryo_id / "volumes" / self._volume_meta_filename(timepoint)
+        )
+        return _read_yaml(meta_path)
+
     def list_volumes(self, session_id: str, embryo_id: str | None = None) -> list[VolumeInfo]:
         """List volume metadata by scanning sidecar YAML files on disk."""
         sd = self._session_dir(session_id)
diff --git a/tests/test_temperature_stamp.py b/tests/test_temperature_stamp.py
new file mode 100644
index 00000000..57dfb603
--- /dev/null
+++ b/tests/test_temperature_stamp.py
@@ -0,0 +1,54 @@
+"""Tests for Task 6: acquisition temperature stamp.
+
+Two concerns:
+1. temperature_stamp(None) returns None (pure helper, no I/O).
+2. Volume metadata round-trip: a stamp injected via put_volume(metadata={"temperature":
+   stamp}) lands correctly in the sidecar YAML and is readable via get_volume_meta.
+
+Confirmed from file_store.py:
+- create_session(session_id, name=None, ...) — session_id is the first positional arg.
+- register_embryo(session_id, embryo_id, ...) — embryo_id is the key; returns None.
+- put_volume(session_id, embryo_id, timepoint, volume, metadata=None) — nests `metadata`
+  under the "metadata" key in the sidecar YAML.
+- get_volume_meta(session_id, embryo_id, timepoint) — added by Task 6; reads sidecar YAML.
+
+Note: tifffile is not installed in the test environment; it is mocked so put_volume
+writes only the sidecar YAML (the contract under test) without the TIFF.
+"""
+
+import sys
+import uuid
+from unittest.mock import MagicMock, patch
+
+import numpy as np
+
+from gently.app.temperature_sampler import temperature_stamp
+
+
+def test_stamp_none_when_no_reading():
+    assert temperature_stamp(None) is None
+
+
+def test_volume_metadata_carries_temperature(file_store):
+    sid = file_store.create_session(str(uuid.uuid4()), name="s")
+    emb = "embryo_1"
+    file_store.register_embryo(sid, emb, position_x=0.0, position_y=0.0)
+    stamp = temperature_stamp(
+        {
+            "t": "2026-06-27T10:00:00+00:00",
+            "water_c": 28.4,
+            "setpoint_c": 32.0,
+            "state": "heating",
+        }
+    )
+    vol = np.zeros((2, 4, 4), dtype="uint16")
+
+    # tifffile is not installed in this environment; mock it so put_volume can
+    # proceed to writing the sidecar YAML (the part under test).
+    tifffile_mock = MagicMock()
+    with patch.dict(sys.modules, {"tifffile": tifffile_mock}):
+        with patch.object(file_store, "_generate_projection", return_value=None):
+            file_store.put_volume(sid, emb, timepoint=0, volume=vol, metadata={"temperature": stamp})
+
+    meta = file_store.get_volume_meta(sid, emb, 0)
+    assert meta["metadata"]["temperature"]["water_c"] == 28.4

From e21b567d07e22b1c00780b53eae8485b235c3012 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:27:20 +0530
Subject: [PATCH 171/314] feat(temperature): live SVG temperature graph on the
 Devices tab

---
 gently/ui/web/static/css/main.css            |  57 +++++++
 gently/ui/web/static/js/devices.js           |   2 +
 gently/ui/web/static/js/temperature-graph.js | 167 +++++++++++++++++++
 gently/ui/web/templates/index.html           |   4 +
 4 files changed, 230 insertions(+)
 create mode 100644 gently/ui/web/static/js/temperature-graph.js

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 10bc6f62..cf878140 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9736,6 +9736,63 @@ body.modal-open {
 .devices-temp-set:hover:not(:disabled) { border-color: var(--map-accent); color: var(--map-ink); }
 .devices-temp-set:disabled { opacity: 0.5; cursor: default; }
 
+/* --- Temperature trajectory graph ------------------------------------- */
+/* SVG chart card mounted at the bottom of #devices-content.              */
+.devices-temp-graph {
+    padding: 0.6rem 1rem 0.5rem;
+    border-top: 1px solid var(--map-overlay-edge);
+    min-height: 2rem;     /* keeps the section visible even when empty    */
+}
+/* Solid line: water temperature */
+.temp-water {
+    stroke: var(--map-accent);
+    stroke-width: 1.5;
+    stroke-linejoin: round;
+    stroke-linecap: round;
+}
+/* Dashed line: setpoint (stepped) */
+.temp-setpoint {
+    stroke: #f59e0b;
+    stroke-width: 1.5;
+    stroke-dasharray: 5 3;
+    stroke-linejoin: round;
+    stroke-linecap: round;
+    opacity: 0.85;
+}
+/* Y-axis reference gridlines */
+.temp-grid-line {
+    stroke: var(--map-ink-faint);
+    stroke-width: 0.75;
+}
+/* Y-axis tick labels */
+.temp-grid-label {
+    fill: var(--map-ink-mute);
+    font-size: 8px;
+    font-family: ui-monospace, monospace;
+    text-anchor: end;
+    dominant-baseline: middle;
+}
+/* Calm empty state — never shows mock data */
+.temp-graph-empty {
+    padding: 1rem 0;
+    text-align: center;
+    color: var(--map-ink-mute);
+    font-size: 0.78rem;
+}
+/* Last-sample readout above the SVG */
+.temp-graph-readout {
+    font-size: 0.68rem;
+    font-weight: 600;
+    font-variant-numeric: tabular-nums;
+    letter-spacing: 0.04em;
+    color: var(--map-ink-mute);
+    margin-bottom: 0.2rem;
+    padding: 0 2px;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
 /* --- Containers ------------------------------------------------------- */
 .devices-view { display: flex; flex-direction: column; flex: 1; min-height: 0; }
 .devices-view-details { gap: 1rem; }
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 040b11d1..a56f0015 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -1554,6 +1554,8 @@ const DevicesManager = (function () {
         setupCameraWiring();
         setupRoomLight();
         setupTemperature();
+        const _tgEl = document.getElementById('devices-temp-graph');
+        if (_tgEl && window.TemperatureGraph) TemperatureGraph.init(_tgEl, 'current');
         loadCoverslip();
         loadEmbryosSnapshot();
         switchView(_currentView);
diff --git a/gently/ui/web/static/js/temperature-graph.js b/gently/ui/web/static/js/temperature-graph.js
new file mode 100644
index 00000000..4679c970
--- /dev/null
+++ b/gently/ui/web/static/js/temperature-graph.js
@@ -0,0 +1,167 @@
+/**
+ * Temperature Graph — hand-rolled SVG line chart for the Devices tab.
+ *
+ * Shows the water-temp trace (solid) and stepped setpoint line (dashed),
+ * backfilled from /api/temperature/{session}/history and then updated live
+ * via TEMPERATURE_UPDATE events from the ClientEventBus.
+ *
+ * No external dependencies. Calm empty state; never renders mock data.
+ *
+ * Usage:
+ *   TemperatureGraph.init(containerEl, 'current');
+ *   // The component self-subscribes; no extra subscription needed in the caller.
+ *   TemperatureGraph.dispose();  // on teardown
+ */
+const TemperatureGraph = (() => {
+    const SVGNS = "http://www.w3.org/2000/svg";
+    const MAX_POINTS = 600;  // rolling ~10 min @ 1 Hz
+
+    let _root = null;
+    let _samples = [];
+    let _session = "current";
+
+    function init(container, sessionId) {
+        _root = container;
+        _session = sessionId || "current";
+        _samples = [];
+        backfill();
+        ClientEventBus.on("TEMPERATURE_UPDATE", onEvent);
+    }
+
+    async function backfill() {
+        try {
+            const r = await fetch(`/api/temperature/${_session}/history`);
+            if (!r.ok) { renderEmpty(); return; }
+            const body = await r.json();
+            // Adopt the resolved session_id (e.g. 'current' → real id) so that
+            // subsequent event filtering is consistent.
+            _session = body.session_id || _session;
+            _samples = (body.samples || []).slice(-MAX_POINTS);
+            render();
+        } catch (e) {
+            console.warn('[TemperatureGraph] backfill error:', e);
+            renderEmpty();
+        }
+    }
+
+    function onEvent(data) {
+        // data = {session_id, sample: {t, water_c, setpoint_c, state}}
+        if (!data || !data.sample) return;
+        _samples.push(data.sample);
+        if (_samples.length > MAX_POINTS) _samples.shift();
+        render();
+    }
+
+    function renderEmpty() {
+        if (!_root) return;
+        _root.innerHTML = '<div class="temp-graph-empty">No temperature data yet</div>';
+    }
+
+    function render() {
+        if (!_root) return;
+        if (!_samples.length) { renderEmpty(); return; }
+
+        const W = _root.clientWidth || 480;
+        const H = 160;
+        const pad = { top: 12, right: 16, bottom: 20, left: 28 };
+
+        const ws  = _samples.map(s => s.water_c).filter(v => v != null);
+        const sps = _samples.map(s => s.setpoint_c).filter(v => v != null);
+
+        if (!ws.length) { renderEmpty(); return; }
+
+        const allVals = [...ws, ...sps];
+        const lo = Math.min(...allVals) - 0.5;
+        const hi = Math.max(...allVals) + 0.5;
+        const range = Math.max(0.001, hi - lo);
+        const plotW = W - pad.left - pad.right;
+        const plotH = H - pad.top - pad.bottom;
+        const n = _samples.length;
+
+        const sx = i => pad.left + (i / Math.max(1, n - 1)) * plotW;
+        const sy = v => pad.top + plotH - ((v - lo) / range) * plotH;
+
+        const svg = document.createElementNS(SVGNS, "svg");
+        svg.setAttribute("viewBox", `0 0 ${W} ${H}`);
+        svg.setAttribute("width", "100%");
+        svg.setAttribute("aria-hidden", "true");
+
+        // Y-axis gridlines (3 levels)
+        const gridG = document.createElementNS(SVGNS, "g");
+        gridG.setAttribute("class", "temp-graph-grid");
+        for (let k = 0; k <= 2; k++) {
+            const v = lo + (k / 2) * (hi - lo);
+            const y = sy(v);
+            const gridLine = document.createElementNS(SVGNS, "line");
+            gridLine.setAttribute("x1", pad.left);
+            gridLine.setAttribute("x2", W - pad.right);
+            gridLine.setAttribute("y1", y);
+            gridLine.setAttribute("y2", y);
+            gridLine.setAttribute("class", "temp-grid-line");
+            gridG.appendChild(gridLine);
+
+            const lbl = document.createElementNS(SVGNS, "text");
+            lbl.setAttribute("x", pad.left - 3);
+            lbl.setAttribute("y", y + 3.5);
+            lbl.setAttribute("class", "temp-grid-label");
+            lbl.textContent = v.toFixed(1);
+            gridG.appendChild(lbl);
+        }
+        svg.appendChild(gridG);
+
+        // Helper: build a polyline from a point-string array
+        const makeLine = (pts, cls) => {
+            if (!pts.length) return;
+            const p = document.createElementNS(SVGNS, "polyline");
+            p.setAttribute("points", pts.join(" "));
+            p.setAttribute("class", cls);
+            p.setAttribute("fill", "none");
+            svg.appendChild(p);
+        };
+
+        // Water temp — skip null samples (gap rather than crash)
+        const waterPts = [];
+        _samples.forEach((s, i) => {
+            if (s.water_c != null) waterPts.push(`${sx(i).toFixed(1)},${sy(s.water_c).toFixed(1)}`);
+        });
+        makeLine(waterPts, "temp-water");
+
+        // Setpoint — stepped: carry the last known setpoint forward
+        const spPts = [];
+        let lastSP = null;
+        _samples.forEach((s, i) => {
+            const sp = s.setpoint_c != null ? s.setpoint_c : lastSP;
+            if (sp != null) {
+                spPts.push(`${sx(i).toFixed(1)},${sy(sp).toFixed(1)}`);
+                lastSP = sp;
+            }
+        });
+        makeLine(spPts, "temp-setpoint");
+
+        // Current readout line (last sample)
+        const last = _samples[_samples.length - 1];
+        const wStr  = last.water_c    != null ? `${last.water_c.toFixed(1)} °C`   : "—";
+        const spStr = last.setpoint_c != null ? `${last.setpoint_c.toFixed(1)} °C` : "—";
+        const stStr = last.state ? ` · ${last.state}` : "";
+
+        const readout = document.createElement("div");
+        readout.className = "temp-graph-readout";
+        readout.title = "Water temperature → setpoint (state)";
+        readout.textContent = `${wStr} → ${spStr}${stStr}`;
+
+        _root.innerHTML = "";
+        _root.appendChild(readout);
+        _root.appendChild(svg);
+    }
+
+    function dispose() {
+        ClientEventBus.off("TEMPERATURE_UPDATE", onEvent);
+        _root = null;
+        _samples = [];
+    }
+
+    // Exposed for testing / forced refresh from devices.js
+    return { init, dispose, _render: render, _samples: () => _samples };
+})();
+
+window.TemperatureGraph = TemperatureGraph;
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 8bc8bf06..7e1f0726 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -711,6 +711,9 @@ <h3 class="devices-properties-title">Properties</h3>
                 </div>
               </div>
             </div>
+
+            <!-- Temperature trajectory graph: backfill + live SVG chart -->
+            <section class="devices-temp-graph" id="devices-temp-graph" aria-label="Temperature trajectory"></section>
         </div>
     </div>
 
@@ -807,6 +810,7 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/projection-viewer.js"></script>
     <script src="/static/js/experiment-strip.js"></script>
     <script src="/static/js/marking.js"></script>
+    <script src="/static/js/temperature-graph.js"></script>
     <script src="/static/js/devices.js"></script>
     <script src="/static/js/experiment-overview.js"></script>
     <!-- Three.js for 3D volume viewer -->

From 0daebda8dd22d55d19c72a7ea2881603e699c5b1 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:35:08 +0530
Subject: [PATCH 172/314] fix(temperature): idempotent graph init + theme
 setpoint color + label baseline

---
 gently/ui/web/static/css/main.css            | 8 +++++++-
 gently/ui/web/static/js/temperature-graph.js | 3 ++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index cf878140..0b115fe6 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -23,6 +23,9 @@
     --accent-pink: #f472b6;
     --accent-cyan: #22d3ee;
 
+    /* Temperature graph colors */
+    --temp-setpoint-color: #f59e0b;
+
     /* Gradients for modern feel */
     --gradient-primary: linear-gradient(135deg, #60a5fa 0%, #c084fc 100%);
     --gradient-success: linear-gradient(135deg, #4ade80 0%, #22d3ee 100%);
@@ -63,6 +66,9 @@
     --accent-pink: #ec4899;
     --accent-cyan: #06b6d4;
 
+    /* Temperature graph colors */
+    --temp-setpoint-color: #f59e0b;
+
     /* Gradients */
     --gradient-primary: linear-gradient(135deg, #3b82f6 0%, #a855f7 100%);
     --gradient-success: linear-gradient(135deg, #22c55e 0%, #06b6d4 100%);
@@ -9752,7 +9758,7 @@ body.modal-open {
 }
 /* Dashed line: setpoint (stepped) */
 .temp-setpoint {
-    stroke: #f59e0b;
+    stroke: var(--temp-setpoint-color);
     stroke-width: 1.5;
     stroke-dasharray: 5 3;
     stroke-linejoin: round;
diff --git a/gently/ui/web/static/js/temperature-graph.js b/gently/ui/web/static/js/temperature-graph.js
index 4679c970..86129902 100644
--- a/gently/ui/web/static/js/temperature-graph.js
+++ b/gently/ui/web/static/js/temperature-graph.js
@@ -21,6 +21,7 @@ const TemperatureGraph = (() => {
     let _session = "current";
 
     function init(container, sessionId) {
+        ClientEventBus.off("TEMPERATURE_UPDATE", onEvent);
         _root = container;
         _session = sessionId || "current";
         _samples = [];
@@ -102,7 +103,7 @@ const TemperatureGraph = (() => {
 
             const lbl = document.createElementNS(SVGNS, "text");
             lbl.setAttribute("x", pad.left - 3);
-            lbl.setAttribute("y", y + 3.5);
+            lbl.setAttribute("y", y);
             lbl.setAttribute("class", "temp-grid-label");
             lbl.textContent = v.toFixed(1);
             gridG.appendChild(lbl);

From 1f6c7fa63d0ab1fe0f39feabf2b72e31e7ad2371 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:35:08 +0530
Subject: [PATCH 173/314] docs(temperature): correct EventType auto() example
 in plan

---
 docs/superpowers/plans/2026-06-27-temperature-interface.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/superpowers/plans/2026-06-27-temperature-interface.md b/docs/superpowers/plans/2026-06-27-temperature-interface.md
index ab02b895..cfdaa563 100644
--- a/docs/superpowers/plans/2026-06-27-temperature-interface.md
+++ b/docs/superpowers/plans/2026-06-27-temperature-interface.md
@@ -134,10 +134,10 @@ Expected: FAIL — `AttributeError: TEMPERATURE_UPDATE`
 
 - [ ] **Step 3: Write minimal implementation**
 
-In `gently/core/event_bus.py`, add the member alongside the other `EventType` values (mirror how `DEVICE_STATE_UPDATE` at `:86` is declared — match the existing value style, e.g. `TEMPERATURE_UPDATE = "TEMPERATURE_UPDATE"`):
+In `gently/core/event_bus.py`, add the member alongside the other `EventType` values, **matching the existing `auto()` style** (`DEVICE_STATE_UPDATE = auto()` at `:86`). The wire protocol serializes `event.event_type.name` (`Event.to_dict` at event_bus.py:232; server.py:377/419), so the browser receives the string `"TEMPERATURE_UPDATE"` regardless — which is what the frontend (Task 7) subscribes to. The test must assert `.name == "TEMPERATURE_UPDATE"` (NOT `.value`, which is an `auto()` int):
 
 ```python
-    TEMPERATURE_UPDATE = "TEMPERATURE_UPDATE"
+    TEMPERATURE_UPDATE = auto()  # high-volume telemetry from the temperature controller
 ```
 
 And add it to the high-volume set so it is not retained in history (next to `DEVICE_STATE_UPDATE` in `_NO_HISTORY_TYPES` near `:187`):

From 60e63dd2380b3f11a597e46ea6f9825c6f6c10a6 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 27 Jun 2026 22:46:49 +0530
Subject: [PATCH 174/314] fix(temperature): events-tab exclusion, burst-stamp
 test, invalidate stale latest, tolerant log read

---
 gently/app/temperature_sampler.py    |  3 ++
 gently/core/file_store.py            | 20 +++++++-
 gently/ui/web/static/js/websocket.js |  3 +-
 tests/test_temperature_sampler.py    | 34 +++++++++++++
 tests/test_temperature_stamp.py      | 72 ++++++++++++++++++++++++++--
 tests/test_temperature_store.py      | 24 ++++++++++
 6 files changed, 149 insertions(+), 7 deletions(-)

diff --git a/gently/app/temperature_sampler.py b/gently/app/temperature_sampler.py
index 5ccec94d..e762534c 100644
--- a/gently/app/temperature_sampler.py
+++ b/gently/app/temperature_sampler.py
@@ -70,12 +70,15 @@ async def _run(self) -> None:
     async def _tick(self, bus) -> None:
         session_id = self._session_id_getter()
         if not session_id:
+            self.latest = None
             return
         resp = await self._microscope.get_temperature()
         if not resp or not resp.get("success", True):
+            self.latest = None
             return
         water = resp.get("temperature_c")
         if water is None:
+            self.latest = None
             return
         sample = {
             "t": _now_iso(),
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index ae668232..e7fb2174 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -450,11 +450,27 @@ def append_temperature_sample(self, session_id: str, sample: dict) -> None:
         _append_jsonl(sd / "temperature.jsonl", sample)
 
     def read_temperature_log(self, session_id: str, since: str | None = None) -> list[dict]:
-        """Return temperature samples for a session, optionally filtered to t >= since (ISO-UTC string)."""
+        """Return temperature samples for a session, optionally filtered to t >= since (ISO-UTC string).
+
+        Reads lines tolerantly: a truncated trailing line (e.g. after a mid-append
+        crash) is silently skipped rather than raising a JSONDecodeError.
+        """
         sd = self._session_dir(session_id)
         if sd is None:
             return []
-        rows = _read_jsonl(sd / "temperature.jsonl")
+        path = sd / "temperature.jsonl"
+        if not path.exists():
+            return []
+        rows = []
+        with open(path, encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    rows.append(json.loads(line))
+                except json.JSONDecodeError:
+                    pass  # truncated or corrupt line — skip
         if since is not None:
             rows = [r for r in rows if str(r.get("t", "")) >= since]
         return rows
diff --git a/gently/ui/web/static/js/websocket.js b/gently/ui/web/static/js/websocket.js
index 069724a2..bcbef78f 100644
--- a/gently/ui/web/static/js/websocket.js
+++ b/gently/ui/web/static/js/websocket.js
@@ -103,7 +103,8 @@ function handleMessage(msg) {
         // per event and would lag every other handler), but still emit to the
         // client event bus so the Devices tab gets the payload.
         if (msg.event_type !== 'DEVICE_STATE_UPDATE' &&
-            msg.event_type !== 'BOTTOM_CAMERA_FRAME') {
+            msg.event_type !== 'BOTTOM_CAMERA_FRAME' &&
+            msg.event_type !== 'TEMPERATURE_UPDATE') {
             handleFullEvent({
                 event_type: msg.event_type,
                 data: msg.data,
diff --git a/tests/test_temperature_sampler.py b/tests/test_temperature_sampler.py
index 3e208069..4c79bf76 100644
--- a/tests/test_temperature_sampler.py
+++ b/tests/test_temperature_sampler.py
@@ -71,3 +71,37 @@ def test_temperature_stamp_shapes():
     assert temperature_stamp({"t": "2026-06-27T10:00:00+00:00", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"}) == {
         "water_c": 28.4, "setpoint_c": 32.0, "state": "heating", "sampled_at": "2026-06-27T10:00:00+00:00",
     }
+
+
+async def test_stale_latest_cleared_when_no_active_session(file_store):
+    """After a successful tick, a subsequent tick with no active session resets latest to None."""
+    sid = file_store.create_session(str(uuid.uuid4()), name="s")
+    scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    bus = EventBus()
+
+    # Successful first tick.
+    s = TemperatureSampler(scope, file_store, lambda: sid)
+    await s._tick(bus)
+    assert s.latest is not None and s.latest["water_c"] == 28.4
+
+    # Second tick with no active session — latest must be cleared.
+    s._session_id_getter = lambda: None
+    await s._tick(bus)
+    assert s.latest is None
+
+
+async def test_stale_latest_cleared_on_poll_failure(file_store):
+    """After a successful tick, a failing poll resets latest to None."""
+    sid = file_store.create_session(str(uuid.uuid4()), name="s")
+    bus = EventBus()
+
+    # Successful first tick.
+    good_scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    s = TemperatureSampler(good_scope, file_store, lambda: sid)
+    await s._tick(bus)
+    assert s.latest is not None
+
+    # Swap to a scope that returns falsy (empty dict) — simulates device dropout.
+    s._microscope = FakeScope({})
+    await s._tick(bus)
+    assert s.latest is None
diff --git a/tests/test_temperature_stamp.py b/tests/test_temperature_stamp.py
index 57dfb603..4784880b 100644
--- a/tests/test_temperature_stamp.py
+++ b/tests/test_temperature_stamp.py
@@ -1,9 +1,11 @@
-"""Tests for Task 6: acquisition temperature stamp.
+"""Tests for Task 6 & Task 7: acquisition temperature stamp.
 
-Two concerns:
+Concerns:
 1. temperature_stamp(None) returns None (pure helper, no I/O).
 2. Volume metadata round-trip: a stamp injected via put_volume(metadata={"temperature":
    stamp}) lands correctly in the sidecar YAML and is readable via get_volume_meta.
+3. Burst stamp: _persist_burst_to_disk injects temperature into both burst.yaml and
+   each frame's .meta.yaml when a temperature_provider is supplied.
 
 Confirmed from file_store.py:
 - create_session(session_id, name=None, ...) — session_id is the first positional arg.
@@ -12,15 +14,17 @@
   under the "metadata" key in the sidecar YAML.
 - get_volume_meta(session_id, embryo_id, timepoint) — added by Task 6; reads sidecar YAML.
 
-Note: tifffile is not installed in the test environment; it is mocked so put_volume
-writes only the sidecar YAML (the contract under test) without the TIFF.
+Note: tifffile is not installed in the test environment; it is mocked so put_volume /
+_persist_burst_to_disk write only the YAML files (the contracts under test).
 """
 
 import sys
 import uuid
+from datetime import datetime, timezone
 from unittest.mock import MagicMock, patch
 
 import numpy as np
+import yaml
 
 from gently.app.temperature_sampler import temperature_stamp
 
@@ -52,3 +56,63 @@ def test_volume_metadata_carries_temperature(file_store):
 
     meta = file_store.get_volume_meta(sid, emb, 0)
     assert meta["metadata"]["temperature"]["water_c"] == 28.4
+
+
+def test_burst_stamp_writes_temperature(file_store):
+    """_persist_burst_to_disk stamps temperature into burst.yaml and frame .meta.yaml."""
+    from gently.app.orchestration.exclusive import _persist_burst_to_disk
+
+    sid = file_store.create_session(str(uuid.uuid4()), name="burst-stamp-test")
+    embryo_id = "embryo_burst"
+    file_store.register_embryo(sid, embryo_id, position_x=0.0, position_y=0.0)
+
+    # Minimal orchestrator stand-in: only _store and _session_id are needed.
+    orch = MagicMock()
+    orch._store = file_store
+    orch._session_id = sid
+
+    # Minimal embryo stand-in.
+    embryo = MagicMock()
+    embryo.stage_position = {"x": 0.0, "y": 0.0}
+    embryo.num_slices = 2
+    embryo.exposure_ms = 50.0
+
+    frames_data = [
+        {"volume": np.zeros((2, 4, 4), dtype="uint16"), "acquired_at_epoch": None}
+    ]
+
+    tifffile_mock = MagicMock()
+    with patch.dict(sys.modules, {"tifffile": tifffile_mock}):
+        burst_dir = _persist_burst_to_disk(
+            orchestrator=orch,
+            embryo=embryo,
+            embryo_id=embryo_id,
+            request_id="req-burst-001",
+            mode="1hz",
+            frames_requested=1,
+            frames_data=frames_data,
+            loop_start=datetime(2026, 6, 27, 10, 0, 0, tzinfo=timezone.utc),
+            duration_s=1.0,
+            sustained_hz=1.0,
+            galvo_amplitude=100.0,
+            galvo_center=0.0,
+            piezo_amplitude=50.0,
+            piezo_center=0.0,
+            laser_power_488_pct=10.0,
+            temperature_provider=lambda: {
+                "t": "2026-06-27T10:00:00+00:00",
+                "water_c": 28.4,
+                "setpoint_c": 32.0,
+                "state": "heating",
+            },
+        )
+
+    assert burst_dir is not None, "_persist_burst_to_disk returned None — check store/session setup"
+
+    # burst.yaml must have a top-level temperature with water_c == 28.4.
+    manifest = yaml.safe_load((burst_dir / "burst.yaml").read_text())
+    assert manifest["temperature"]["water_c"] == 28.4
+
+    # Frame meta.yaml must have metadata.temperature.water_c == 28.4.
+    frame_meta = yaml.safe_load((burst_dir / "t0001.meta.yaml").read_text())
+    assert frame_meta["metadata"]["temperature"]["water_c"] == 28.4
diff --git a/tests/test_temperature_store.py b/tests/test_temperature_store.py
index b51da792..9e5d5fbe 100644
--- a/tests/test_temperature_store.py
+++ b/tests/test_temperature_store.py
@@ -32,3 +32,27 @@ def test_read_since_filters(file_store):
 def test_read_unknown_session_is_empty(file_store):
     """Test that reading from a non-existent session returns empty list."""
     assert file_store.read_temperature_log("does-not-exist") == []
+
+
+def test_truncated_trailing_line_is_skipped(file_store, tmp_path):
+    """A truncated trailing line (e.g. after a crash mid-append) is skipped gracefully."""
+    import uuid
+
+    sid = _new_session(file_store)
+
+    # Append two valid samples via the normal API.
+    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.1, "setpoint_c": 32.0, "state": "heating"})
+    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:02+00:00", "water_c": 28.2, "setpoint_c": 32.0, "state": "heating"})
+
+    # Append a raw truncated line directly to the JSONL file.
+    from gently.core.file_store import FileStore
+    # Locate the temperature.jsonl via the store's internal path.
+    sd = file_store._session_dir(sid)
+    log_path = sd / "temperature.jsonl"
+    with open(log_path, "a", encoding="utf-8") as f:
+        f.write('{"t": "2026-06-27T10:00:03+00:00", "water_c":\n')
+
+    # read_temperature_log must return only the two valid rows without raising.
+    rows = file_store.read_temperature_log(sid)
+    assert len(rows) == 2
+    assert [r["water_c"] for r in rows] == [28.1, 28.2]

From a79a9575ea7a880b7551075f281583902805eb51 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 06:40:22 +0530
Subject: [PATCH 175/314] fix(temperature): root-level temp graph colors for
 portability

The water trace, gridlines, and tick labels used .devices-container-map-scoped
--map-* vars, so the graph rendered blank outside that container. Promote them to
:root-level --temp-* vars (mirroring --temp-setpoint-color) so the component is
reusable when manual mode (sub-project B) re-mounts it. Same colors in-app.
---
 gently/ui/web/static/css/main.css | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 0b115fe6..36124bd9 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -23,8 +23,12 @@
     --accent-pink: #f472b6;
     --accent-cyan: #22d3ee;
 
-    /* Temperature graph colors */
+    /* Temperature graph colors (root-level so the graph is portable outside
+       .devices-container-map — e.g. when reused in manual mode) */
     --temp-setpoint-color: #f59e0b;
+    --temp-water-color: #22d3ee;
+    --temp-grid-line-color: rgba(212, 221, 232, 0.20);
+    --temp-grid-label-color: #6a778a;
 
     /* Gradients for modern feel */
     --gradient-primary: linear-gradient(135deg, #60a5fa 0%, #c084fc 100%);
@@ -66,8 +70,11 @@
     --accent-pink: #ec4899;
     --accent-cyan: #06b6d4;
 
-    /* Temperature graph colors */
+    /* Temperature graph colors (root-level; see dark block) */
     --temp-setpoint-color: #f59e0b;
+    --temp-water-color: #0e7490;
+    --temp-grid-line-color: rgba(29, 43, 58, 0.22);
+    --temp-grid-label-color: #6b7280;
 
     /* Gradients */
     --gradient-primary: linear-gradient(135deg, #3b82f6 0%, #a855f7 100%);
@@ -9751,7 +9758,7 @@ body.modal-open {
 }
 /* Solid line: water temperature */
 .temp-water {
-    stroke: var(--map-accent);
+    stroke: var(--temp-water-color);
     stroke-width: 1.5;
     stroke-linejoin: round;
     stroke-linecap: round;
@@ -9767,12 +9774,12 @@ body.modal-open {
 }
 /* Y-axis reference gridlines */
 .temp-grid-line {
-    stroke: var(--map-ink-faint);
+    stroke: var(--temp-grid-line-color);
     stroke-width: 0.75;
 }
 /* Y-axis tick labels */
 .temp-grid-label {
-    fill: var(--map-ink-mute);
+    fill: var(--temp-grid-label-color);
     font-size: 8px;
     font-family: ui-monospace, monospace;
     text-anchor: end;

From 339cc7ce5e0ec2a80659dda19f1a447cec4c7dec Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:06:17 +0530
Subject: [PATCH 176/314] docs(manual-mode): design spec for SPIM single-slice
 live view (B1)

---
 ...2026-06-28-manual-mode-live-view-design.md | 190 ++++++++++++++++++
 1 file changed, 190 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md

diff --git a/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md b/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md
new file mode 100644
index 00000000..0ac1365a
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md
@@ -0,0 +1,190 @@
+# Design: Manual Mode — SPIM single-slice brightfield live view (sub-project B1)
+
+Status: design approved in brainstorm (2026-06-28).
+Base branch: off `feature/temperature-interface` (sub-project A) — B1 embeds A's now-portable
+temperature graph and its acquisition temperature stamp.
+
+## 0. Where this sits (execution roadmap)
+
+Sub-project **B** of the temperature-strain experiment prep. B is split:
+
+- **B1 (this spec) — the hand-driven experiment surface:** a **Manual view** in the Devices
+  tab with a SPIM single-slice brightfield live view (one selectable side A/B), live
+  galvo/piezo/exposure controls, brightfield illumination (LED, no laser), temperature
+  setpoint + A's graph, and by-hand burst/volume triggers.
+- **B2 (deferred):** laser channel-preset browser, full timelapse/volume config form,
+  side-by-side dual view, richer camera selection.
+
+This is **load-bearing for next week** — the experiments are imaged by hand first. The first
+experiment round is hand-driven through this view.
+
+## 1. Overview
+
+Today the Devices tab is read-only and there is no human-driven imaging surface. The
+temperature experiments image with the **SPIM cameras under LED/brightfield illumination (no
+laser, DIC/BF-like)** — a *single plane*, not a scan — and the operator needs to slide the
+**galvo (sheet position)** and **imaging piezo (focal plane)** and *see the effect live*, then
+trigger bursts/volumes by hand around a temperature change.
+
+### What already exists (reused)
+- The MMCore core is a real `pymmcore.CMMCore`; **continuous sequence acquisition** is already
+  proven in the volume path (`acquisition.py:199-231`: `startSequenceAcquisition`/`popNextImage`/
+  `getRemainingImageCount`/`stopSequenceAcquisition`).
+- `capture_lightsheet_image(piezo_position, galvo_position, exposure_ms)` (`client.py:493`) —
+  a single-plane snap primitive (but it goes through the Bluesky queue → too heavy for a live
+  loop; used only for one-shot snaps).
+- The **bottom-camera live streamer** (`device_layer.py` `_bottom_camera_streamer`) — the
+  structural template (subscriber-gated SSE, drop-oldest backpressure, `_state_pause_counter`
+  heavy-plan back-off, JPEG/base64 encode, EventBus→WS transport).
+- Direct device writes: `set_led`, `set_laser_power`, `set_camera_led_mode`, `set_room_light`,
+  `set_temperature`, `move_to_position`, `acquire_volume`, `acquire_burst` (client methods).
+- `require_control` auth (`auth.py`) — localhost = CONTROL on the rig; remote needs a token.
+- The Devices view-switcher pattern (Map/Details/3D) to host a new "Manual" view.
+- A's portable temperature-graph component + per-acquisition temperature stamp.
+
+### What must be built
+A device-layer **lightsheet live streamer** (continuous sequence + peek-latest), an agent-side
+**LightsheetStreamMonitor**, **`require_control` browser proxy routes**, two new client methods,
+and the **Manual view** UI. Transport reuses the JSON/base64 path first; a binary path is a
+**conditional escalation gated on an FPS measurement**.
+
+## 2. Architecture — seven units
+
+### 2.1 Lightsheet live streamer (device layer, new)
+`_lightsheet_live_streamer` task + `handle_lightsheet_stream` SSE handler in `device_layer.py`,
+mirroring the bottom-camera streamer's skeleton (subscriber-gated lifecycle, per-subscriber
+`asyncio.Queue` drop-oldest backpressure, `_state_pause_counter` back-off).
+
+**Grab mechanism — the MM live pattern (replacing the snap loop):**
+- On first subscriber: select the SPIM side camera (`core.setCameraDevice`), set exposure,
+  **park** galvo + piezo at the current params, `core.startContinuousSequenceAcquisition(0)`.
+- Loop: **peek the latest** frame (`getLastImage` / `getNBeforeLastTaggedImage`) — never
+  `popNextImage` (don't drain). Encode → broadcast. Pace to `max(exposure, ~1/30 s)` up to the
+  display cap (MM's clamp).
+- On last subscriber: `stopSequenceAcquisition`, restore prior camera/state.
+
+**Live param updates** (`POST /api/lightsheet/live/params {side, galvo, piezo, exposure}`):
+- **galvo / piezo → applied live, no restart** (move scanner/imaging-piezo; next frames show
+  the new plane — the slide-and-see response).
+- **exposure / side → stop → reconfigure → restart** (camera params can't change mid-sequence).
+
+**Resolution/quality:** the lightsheet stream gets its **own configurable size/quality**
+(default ~512 px, JPEG q≈70) — higher than the bottom-camera 360 px thumbnail, since this view
+is for judging focus. Resolution↔FPS tradeoff feeds the §3 measurement.
+
+**rpyc caveat:** the core may be an rpyc proxy, so each `getLastImage` transfers a full frame
+across that boundary *inside the device-layer process*; the streamer encodes to JPEG there, so
+only a small payload leaves the process. rpyc bounds the *grab* rate, not the web payload.
+
+**Implementer confirmations (flagged, not guesses):** the exact device methods to park the
+galvo (scanner) + imaging piezo and the SPIM side-camera device names
+(`device_factory.py`/`devices/scanner.py`/`optical.py`); and whether brightfield/LED live needs
+the scanner/beam enabled at all or a fully static park — confirm against
+`../micro-manager/plugins/ASIdiSPIM/.../SetupPanel.java`. B1 assumes static park, laser off.
+
+### 2.2 Lightsheet stream monitor (agent Service, new)
+Mirrors `BottomCameraStreamMonitor`: consumes the device SSE via a new client generator and
+republishes frames on the EventBus as a new high-volume `EventType.LIGHTSHEET_FRAME`
+(added to `_NO_HISTORY_TYPES` and the `websocket.js` events-table exclusion). Opt-in;
+started/stopped via the proxy routes.
+
+### 2.3 Browser proxy routes (viz server, `require_control`, new)
+In `data.py`'s `create_router`, each `Depends(require_control)`, each resolving the live client
+via `_resolve_client()`:
+
+| Route | Calls |
+|---|---|
+| `POST /api/devices/lightsheet/live/start` | start `LightsheetStreamMonitor` |
+| `POST /api/devices/lightsheet/live/stop` | stop the monitor |
+| `GET /api/devices/lightsheet/live/status` | `{available, streaming, side, last_frame_ts, fps}` |
+| `POST /api/devices/lightsheet/live/params` | `client.set_lightsheet_live_params(side,galvo,piezo,exposure)` |
+| `POST /api/devices/led/set` | `client.set_led(state)` |
+| `POST /api/devices/laser/off` | `client.set_laser_power(wl, 0)` / "ALL OFF" |
+| `POST /api/devices/camera/led_mode` | `client.set_camera_led_mode(use_led)` |
+| `POST /api/devices/room_light/set` | *(exists `data.py:335`)* |
+| `POST /api/devices/stage/move` | `client.move_to_position(x,y)` |
+| `POST /api/devices/acquire/burst` | `client.acquire_burst(...)` |
+| `POST /api/devices/acquire/volume` | `client.acquire_volume(...)` |
+| `POST /api/devices/temperature/set` | *(exists `data.py:381`)* |
+
+The device-layer aiohttp routes have no auth; the browser must go through this proxy.
+
+### 2.4 New client methods
+`DiSPIMMicroscope.stream_lightsheet(...)` (async generator over `GET /api/lightsheet/stream`,
+mirroring `stream_bottom_camera`) and `set_lightsheet_live_params(side, galvo, piezo, exposure)`
+(`POST /api/lightsheet/live/params`). Everything else already exists.
+
+### 2.5 Manual view (frontend, new `#devices-view-manual`)
+A "Manual" entry in the Devices view-switcher → two-column layout:
+- **Left:** the live image canvas (reusing the bottom-camera render + `zoom-pan.js` +
+  crosshair), an FPS + side overlay, and a Start/Stop Live toggle; a "Last capture" card below.
+- **Right control rail:** Camera (side A/B selector, exposure) · Focus & sheet (galvo + piezo
+  sliders with numeric fields + nudge) · Illumination (LED, camera-LED-mode, room light, laser
+  OFF indicator) · Temperature (setpoint + A's embedded graph) · Acquire (Snap volume / Burst
+  buttons with a small param summary).
+
+Interactions: galvo/piezo sliders → **debounced** `POST live/params` → canvas updates in a
+couple of frames; acquire → "acquiring…" overlay → Last-capture card → live resumes; FPS
+readout surfaces the §3 measurement. Toggle/setpoint widgets model on the existing room-light
+and temp-set controls.
+
+### 2.6 Concurrency rule
+Live holds the camera/MMCore, so a triggered burst/volume **stops the live sequence → acquires
+→ resumes** (via the existing `_state_pause_counter` back-off). Only **one live stream at a
+time** (lightsheet vs bottom contend for MMCore). Acquisitions land with A's temperature stamp.
+
+### 2.7 Brightfield safety
+On entering manual/brightfield live, **laser is forced off**; `DiSPIMLightSource` power-limit
+clamps already cap any laser power.
+
+## 3. Transport & the FPS measure→escalate path (Approach ①)
+
+**Baseline (build first):** lightsheet frames ride the existing path unchanged —
+device base64-JPEG-in-JSON over SSE → `LightsheetStreamMonitor` → EventBus `LIGHTSHEET_FRAME`
+→ `ConnectionManager.broadcast` (`json.dumps` + `send_text`) → browser canvas. Additions: the
+new EventType (+ `_NO_HISTORY_TYPES` + `websocket.js` exclusion) and a browser paint handler.
+
+**Instrumented measurement (the gate):** three counters — **device grab rate**, **delivered
+rate**, **browser paint rate** (the FPS readout). Target **≥ ~15 fps usable** (stretch 25–30),
+latency < ~150 ms. Run on the rig; record the numbers in the plan.
+
+**Diagnosis fork:**
+- device grab < target → limiter is exposure / readout / rpyc, *not* transport → tune
+  exposure / size / quality; binary won't help.
+- device grab ≥ target but browser paint < target → transport is the bottleneck → escalate.
+
+**Escalation (conditional task):** a **binary WebSocket path on the agent→browser hop** —
+`websocket.send_bytes(jpeg)` with a small type prefix, browser `createImageBitmap` → canvas —
+bypassing base64 (+33%), the per-client `json.dumps`, and the EventBus fan-out. The device→agent
+SSE stays (single consumer). Built **only if** the measurement points to transport.
+
+## 4. Error handling & edges
+- No SPIM camera / device down → `live/status {available:false}` → empty canvas, controls
+  disabled. Sequence fails to start → surfaced, graceful (no crash).
+- rpyc/slow grab → backpressure drops oldest; FPS readout shows reality.
+- Param out of range → `DiSPIMLightSource` clamps + UI input bounds; laser forced off in
+  brightfield.
+- Only one live stream at a time; live is subscriber-gated → stops on view-switch / page-close.
+- `require_control` denied (remote, no token) → 403 → controls shown disabled.
+
+## 5. Testing
+- **Device layer:** streamer against a fake core supporting sequence acquisition
+  (start/stop/`getLastImage`) — param updates (galvo/piezo live vs exposure/side restart),
+  heavy-plan pause/resume, subscriber lifecycle.
+- **Proxy routes:** FastAPI TestClient + mock client — `require_control` 403 gate, param
+  forwarding.
+- **Client methods:** `stream_lightsheet` SSE parsing; `set_lightsheet_live_params` POST.
+- **Frontend:** `node --check` + a Chrome-MCP harness (like A) for canvas + slide-and-see +
+  states, plus a UI audit. (No JS unit harness in repo.)
+- **FPS:** a documented **rig measurement step** (grab/deliver/paint fps); the binary path is a
+  **conditional follow-up task gated on those numbers**.
+- **Integration (rig):** live renders; slider changes the image; burst persists with
+  temperature; live resumes.
+
+Much of B1 needs the **real rig** (rpyc core, SPIM cameras, galvo/piezo) to verify; off-rig we
+cover the streamer (fake core), proxy routes, client methods, and the frontend harness, and
+defer live/FPS verification to the microscope — as with A.
+
+## 6. Out of scope (B2)
+Laser channel-preset browser; full timelapse/volume configuration form; side-by-side dual view;
+richer camera selection.

From 2041c3aebda084d98c28e64b2c14811e02ea2903 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:24:13 +0530
Subject: [PATCH 177/314] docs(manual-mode): B1 plan (7 tasks) + ASIdiSPIM
 two-camera model appendix

---
 .../plans/2026-06-28-manual-mode-live-view.md | 728 ++++++++++++++++++
 ...2026-06-28-manual-mode-live-view-design.md |  28 +
 2 files changed, 756 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-28-manual-mode-live-view.md

diff --git a/docs/superpowers/plans/2026-06-28-manual-mode-live-view.md b/docs/superpowers/plans/2026-06-28-manual-mode-live-view.md
new file mode 100644
index 00000000..8c84eeeb
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-28-manual-mode-live-view.md
@@ -0,0 +1,728 @@
+# Manual Mode — SPIM Live View (B1) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** A Manual view in the Devices tab with a continuous SPIM single-slice brightfield live view (galvo/piezo/exposure controlled live), brightfield illumination, temperature, and by-hand burst/volume triggers — the hand-driven surface for next week's temperature-strain experiments.
+
+**Architecture:** A device-layer lightsheet live streamer (MMCore continuous sequence acquisition + peek-latest, parked galvo/piezo), bridged to the browser by a `LightSheetStreamMonitor` (EventBus `LIGHTSHEET_FRAME`) over the existing base64-JPEG/SSE→WS transport; `require_control` FastAPI proxy routes; a Manual view that mirrors the bottom-camera panel. FPS is measured on the rig; a binary transport path is a conditional follow-up.
+
+**Tech Stack:** Python asyncio + aiohttp (device layer), FastAPI (viz proxy), `pymmcore.CMMCore`, the project EventBus, vanilla-JS + canvas/SVG frontend (no build step), pytest (`asyncio_mode=auto`).
+
+## Global Constraints
+
+- **No new dependency.** Reuse `_encode_frame_for_stream` (OpenCV already present), the bottom-camera streamer pattern, A's portable temperature graph.
+- **Single SPIM camera** today: `self.devices.get("camera")` (`HamCam1`). No side-A/B selector in B1 (deferred to B2).
+- **Live = continuous sequence acquisition**, never a snap loop: `core.startContinuousSequenceAcquisition(0)` → peek `core.getLastImage()` (NEVER `popNextImage` — don't drain) → `stopSequenceAcquisition()` on exit. The core handle is `self.system.core` in the device layer; unwrap rpyc frames with `_safe_obtain`.
+- **Park** before/under live: `piezo.setPosition(z)`, `scanner.sa_offset_y.setPosition(deg)` (or `scanner.set_y_offset(deg)`), `scanner.set_spim_state("Idle")`, `piezo.set_spim_state("Idle")`. galvo/piezo updates apply live (no restart); exposure change → stop→`setExposure`→restart.
+- **Brightfield safety:** laser forced off in manual live (`setConfig(laser_group, "ALL OFF")` / `set_laser_power(...,0)`).
+- **Concurrency:** the streamer honors `self._state_pause_counter > 0` (heavy plan owns MMCore → back off / stop sequence). Only one live stream at a time.
+- **Lightsheet stream resolution/quality:** its own config — default `_ls_target_max_dim = 512`, `_ls_jpeg_quality = 70` (higher than the bottom-camera 360/55 thumbnail, for focus).
+- **Transport stays JSON/`send_text`** (no binary path exists); a binary hop is Task 8, conditional on the FPS measurement.
+- **Auth:** browser-facing writes are FastAPI proxy routes guarded by `Depends(require_control)`; device-layer aiohttp routes have no auth, so the browser must go through the proxy.
+- **Tests:** `pytest`; `file_store`-style fixtures; FastAPI `TestClient` + mock client for routes; a fake core for the streamer. Frontend has no JS unit harness → `node --check` + Chrome-MCP harness + UI audit. Much of B1 needs the real rig; off-rig we cover streamer (fake core), routes, client, frontend harness, and defer live/FPS verification.
+
+---
+
+### Task 1: `LIGHTSHEET_FRAME` event type + frontend exclusion
+
+**Files:**
+- Modify: `gently/core/event_bus.py` (enum near `:88`; `_NO_HISTORY_TYPES` near `:186-195`)
+- Modify: `gently/ui/web/static/js/websocket.js` (exclusion guard `:104-107`)
+- Test: `tests/test_lightsheet_event.py`
+
+**Interfaces:**
+- Produces: `EventType.LIGHTSHEET_FRAME` (declared with `auto()`, matching `BOTTOM_CAMERA_FRAME`), in `_NO_HISTORY_TYPES`. Wire serialization uses `.name` (so the browser receives `"LIGHTSHEET_FRAME"`).
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_lightsheet_event.py
+from gently.core.event_bus import EventType, EventBus, _NO_HISTORY_TYPES
+
+def test_lightsheet_frame_event_exists():
+    assert EventType.LIGHTSHEET_FRAME.name == "LIGHTSHEET_FRAME"
+
+def test_lightsheet_frame_excluded_from_history():
+    assert EventType.LIGHTSHEET_FRAME in _NO_HISTORY_TYPES
+
+def test_lightsheet_frame_publishes_to_subscriber():
+    bus = EventBus()
+    seen = []
+    bus.subscribe(EventType.LIGHTSHEET_FRAME, lambda e: seen.append(e.data))
+    bus.publish(event_type=EventType.LIGHTSHEET_FRAME, data={"jpeg_b64": "x"}, source="t")
+    assert seen == [{"jpeg_b64": "x"}]
+```
+
+> Confirm `EventBus.subscribe` signature / `_NO_HISTORY_TYPES` exportability against the real file; adapt the import/subscribe if needed, keep the assertions.
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `pytest tests/test_lightsheet_event.py -v`
+Expected: FAIL — `AttributeError: LIGHTSHEET_FRAME`
+
+- [ ] **Step 3: Write minimal implementation**
+
+In `gently/core/event_bus.py`, add the member next to `BOTTOM_CAMERA_FRAME` (`:88`):
+```python
+    LIGHTSHEET_FRAME = auto()  # Live JPEG frame from the SPIM lightsheet live stream
+```
+Add to `_NO_HISTORY_TYPES` (next to `BOTTOM_CAMERA_FRAME`):
+```python
+        EventType.LIGHTSHEET_FRAME,  # high-volume live frames — keep out of history
+```
+In `gently/ui/web/static/js/websocket.js`, extend the exclusion guard (`:104-107`) so the frame skips the Events table but still reaches `ClientEventBus.emit`:
+```javascript
+        if (msg.event_type !== 'DEVICE_STATE_UPDATE' &&
+            msg.event_type !== 'BOTTOM_CAMERA_FRAME' &&
+            msg.event_type !== 'TEMPERATURE_UPDATE' &&
+            msg.event_type !== 'LIGHTSHEET_FRAME') {
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `pytest tests/test_lightsheet_event.py -v` (3 passed) and `node --check gently/ui/web/static/js/websocket.js` (exit 0)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/core/event_bus.py gently/ui/web/static/js/websocket.js tests/test_lightsheet_event.py
+git commit -m "feat(manual-mode): add LIGHTSHEET_FRAME event type + frontend exclusion"
+```
+
+---
+
+### Task 2: Device-layer lightsheet live streamer (continuous sequence acquisition)
+
+**Files:**
+- Modify: `gently/hardware/dispim/device_layer.py` — add config attrs (near `:160-169`), `_park_lightsheet_sync`, `_grab_lightsheet_frame_sync`, `_lightsheet_streamer`, `_broadcast_lightsheet`, `handle_lightsheet_stream`, `handle_lightsheet_params`; register two routes (near `:2806`).
+- Test: `tests/test_lightsheet_streamer.py`
+- Reference (mirror): `_bottom_camera_streamer`/`_broadcast_camera`/`handle_bottom_camera_stream`/`_encode_frame_for_stream` (same file); sequence-acq calls in `devices/acquisition.py:186-254`.
+
+**Interfaces:**
+- Consumes: `self.system.core` (`pymmcore.CMMCore`), `self.devices["camera"]` / `["scanner"]` / `["piezo"]`, `self._state_pause_counter`, `self._encode_frame_for_stream` (reused verbatim), `_safe_obtain` (rpyc unwrap, imported as in `acquisition.py`).
+- Produces: SSE `GET /api/lightsheet/stream`; `POST /api/lightsheet/live/params` `{galvo, piezo, exposure}`; in-process live param state `self._ls_params`.
+
+> **Implementer confirmations (cannot be verified off-rig — confirm against the real code, do not guess silently):**
+> 1. The device-layer core handle (`self.system.core`) and that `pymmcore.CMMCore` exposes `startContinuousSequenceAcquisition(float)`, `getLastImage()`, `stopSequenceAcquisition()`, `isSequenceRunning()` (standard CMMCore API). If `getLastImage` is unavailable, use `getLastImageMD`/`getNBeforeLastImage`.
+> 2. The scanner/piezo park calls: `self.devices["scanner"].sa_offset_y.setPosition(deg)` and `self.devices["piezo"].setPosition(z)`, and `set_spim_state("Idle")` on both (from `devices/scanner.py:271`, `devices/piezo.py:226`, recon §3).
+> 3. Whether brightfield live needs the scanner/beam enabled or a static park — confirm against `../micro-manager/plugins/ASIdiSPIM/src/main/java/org/micromanager/asidispim/SetupPanel.java`. Default: static park, laser "ALL OFF".
+
+- [ ] **Step 1: Write the failing test (fake core + fake devices)**
+
+```python
+# tests/test_lightsheet_streamer.py
+import asyncio, numpy as np, pytest
+from gently.hardware.dispim.device_layer import DeviceLayer  # confirm class name/import
+
+class FakeCore:
+    def __init__(self):
+        self.running = False; self.exposure = None; self.cam = None
+        self._frame = np.full((64, 64), 1000, dtype=np.uint16)
+        self.started = 0; self.stopped = 0
+    def setCameraDevice(self, n): self.cam = n
+    def getCameraDevice(self): return self.cam
+    def setExposure(self, n, ms): self.exposure = ms
+    def startContinuousSequenceAcquisition(self, interval): self.running = True; self.started += 1
+    def stopSequenceAcquisition(self): self.running = False; self.stopped += 1
+    def isSequenceRunning(self): return self.running
+    def getLastImage(self): return self._frame
+
+class FakeAxis:
+    def __init__(self): self.pos = None
+    def setPosition(self, v): self.pos = v
+
+class FakeScanner:
+    def __init__(self): self.sa_offset_y = FakeAxis(); self.name="Scanner"; self.state=None
+    def set_spim_state(self, s): self.state = s
+
+class FakePiezo(FakeAxis):
+    def __init__(self): super().__init__(); self.name="Piezo"; self.state=None
+    def set_spim_state(self, s): self.state = s
+
+def _streamer(dl):
+    dl.system = type("S", (), {"core": FakeCore()})()
+    dl.devices = {"camera": type("C", (), {"name": "HamCam1"})(),
+                  "scanner": FakeScanner(), "piezo": FakePiezo()}
+    return dl
+
+async def test_grab_parks_and_peeks(monkeypatch):
+    dl = _streamer(DeviceLayer.__new__(DeviceLayer))
+    dl._state_pause_counter = 0
+    dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
+    dl._ls_params = {"galvo": 1.5, "piezo": 40.0, "exposure": 20.0}
+    dl._ls_seq_started = False; dl._ls_applied = {}
+    img = await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
+    assert img is not None and img.shape == (64, 64)
+    assert dl.system.core.running is True              # sequence started
+    assert dl.devices["piezo"].pos == 40.0             # piezo parked
+    assert dl.devices["scanner"].sa_offset_y.pos == 1.5  # galvo parked
+
+async def test_exposure_change_restarts_sequence():
+    dl = _streamer(DeviceLayer.__new__(DeviceLayer))
+    dl._state_pause_counter = 0
+    dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
+    dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 10.0}
+    dl._ls_seq_started = False; dl._ls_applied = {}
+    await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
+    starts = dl.system.core.started
+    dl._ls_params["exposure"] = 30.0                   # exposure change
+    await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
+    assert dl.system.core.stopped >= 1 and dl.system.core.started == starts + 1
+    assert dl.system.core.exposure == 30.0
+```
+
+- [ ] **Step 2: Run to verify it fails**
+
+Run: `pytest tests/test_lightsheet_streamer.py -v`
+Expected: FAIL — `AttributeError: _grab_lightsheet_frame_sync` (or import).
+
+- [ ] **Step 3: Implement the streamer**
+
+Add config attrs in `__init__` (near `:169`, after the `_cam_*` block):
+```python
+        # Lightsheet (SPIM) live stream — continuous sequence acquisition.
+        self._ls_subscribers: list[asyncio.Queue] = []
+        self._ls_task: asyncio.Task | None = None
+        self._ls_interval_sec: float = 0.0          # peek as fast as exposure allows
+        self._ls_target_max_dim: int = 512
+        self._ls_jpeg_quality: int = 70
+        self._ls_params: dict = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0}
+        self._ls_seq_started: bool = False
+        self._ls_applied: dict = {}                  # last-applied galvo/piezo/exposure
+```
+
+Add the grab/park/peek (mirrors the sequence-acq calls from `acquisition.py`; uses `self.system.core`):
+```python
+    def _park_lightsheet_sync(self) -> None:
+        """Park scanner galvo + imaging piezo at the current live params (static sheet)."""
+        p = self._ls_params
+        scanner = self.devices.get("scanner")
+        piezo = self.devices.get("piezo")
+        if scanner is not None:
+            try: scanner.set_spim_state("Idle")
+            except Exception: pass
+            scanner.sa_offset_y.setPosition(float(p["galvo"]))
+        if piezo is not None:
+            try: piezo.set_spim_state("Idle")
+            except Exception: pass
+            piezo.setPosition(float(p["piezo"]))
+
+    def _ensure_lightsheet_sequence_sync(self) -> None:
+        """Start (or restart on exposure change) the continuous sequence on the SPIM camera."""
+        core = self.system.core
+        cam = self.devices.get("camera")
+        if cam is None:
+            raise RuntimeError("No lightsheet camera configured")
+        p = self._ls_params
+        need_restart = (
+            not self._ls_seq_started
+            or self._ls_applied.get("exposure") != p["exposure"]
+        )
+        if need_restart:
+            if core.isSequenceRunning():
+                core.stopSequenceAcquisition()
+            if core.getCameraDevice() != cam.name:
+                core.setCameraDevice(cam.name)
+            core.setExposure(cam.name, float(p["exposure"]))
+            core.startContinuousSequenceAcquisition(self._ls_interval_sec * 1000.0)
+            self._ls_seq_started = True
+            self._ls_applied["exposure"] = p["exposure"]
+
+    def _grab_lightsheet_frame_sync(self):
+        """Park → ensure sequence running → peek the latest frame (never drain)."""
+        try:
+            self._park_lightsheet_sync()                  # galvo/piezo applied live
+            self._ensure_lightsheet_sequence_sync()       # start / restart on exposure
+            from gently.hardware.dispim.devices.acquisition import _safe_obtain
+            core = self.system.core
+            img = core.getLastImage()
+            try: img = _safe_obtain(img)
+            except (ImportError, AttributeError): pass
+            return np.asarray(img)
+        except Exception as exc:
+            logger.debug("Lightsheet grab failed: %s", exc)
+            return None
+
+    def _stop_lightsheet_sequence_sync(self) -> None:
+        try:
+            if self.system.core.isSequenceRunning():
+                self.system.core.stopSequenceAcquisition()
+        except Exception:
+            logger.debug("stop lightsheet sequence failed", exc_info=True)
+        self._ls_seq_started = False
+        self._ls_applied = {}
+```
+
+Add the streamer loop + broadcast (mirror `_bottom_camera_streamer`/`_broadcast_camera`, reusing `_encode_frame_for_stream`):
+```python
+    async def _lightsheet_streamer(self):
+        logger.info("Lightsheet streamer started")
+        try:
+            while self._ls_subscribers:
+                if self._state_pause_counter > 0:
+                    # Heavy plan owns MMCore: release the sequence and back off.
+                    if self._ls_seq_started:
+                        await asyncio.to_thread(self._stop_lightsheet_sequence_sync)
+                    await asyncio.sleep(0.1)
+                    continue
+                tick = time.monotonic()
+                img = await asyncio.to_thread(self._grab_lightsheet_frame_sync)
+                payload = self._encode_frame_for_stream(img) if img is not None else None
+                if payload is not None:
+                    await self._broadcast_lightsheet(payload)
+                elapsed = time.monotonic() - tick
+                # Pace to at least the exposure; peek-rate caps near the camera rate.
+                floor = max(self._ls_interval_sec, self._ls_params["exposure"] / 1000.0)
+                await asyncio.sleep(max(0.0, floor - elapsed))
+        except asyncio.CancelledError:
+            raise
+        except Exception:
+            logger.exception("Lightsheet streamer crashed")
+        finally:
+            await asyncio.to_thread(self._stop_lightsheet_sequence_sync)
+            logger.info("Lightsheet streamer exiting")
+
+    async def _broadcast_lightsheet(self, payload):
+        if not self._ls_subscribers:
+            return
+        dead = []
+        for q in self._ls_subscribers:
+            try:
+                q.put_nowait(payload)
+            except asyncio.QueueFull:
+                try:
+                    _ = q.get_nowait(); q.put_nowait(payload)
+                except Exception:
+                    dead.append(q)
+        for q in dead:
+            try: self._ls_subscribers.remove(q)
+            except ValueError: pass
+```
+
+> `_encode_frame_for_stream` uses `self._cam_target_max_dim`/`self._cam_jpeg_quality`. To get the 512/70 lightsheet settings without duplicating the encoder, add an optional override: change its signature to `_encode_frame_for_stream(self, img, max_dim=None, quality=None)` defaulting to the `_cam_*` values, and call it `self._encode_frame_for_stream(img, self._ls_target_max_dim, self._ls_jpeg_quality)` from the lightsheet loop. (One-line change to the encoder; bottom-camera behavior unchanged.)
+
+Add the SSE handler + params handler (mirror `handle_bottom_camera_stream`; the params handler updates `self._ls_params` — galvo/piezo apply on the next grab, exposure triggers the restart path):
+```python
+    async def handle_lightsheet_stream(self, request):
+        response = web.StreamResponse(status=200, reason="OK", headers={
+            "Content-Type": "text/event-stream", "Cache-Control": "no-cache",
+            "Connection": "keep-alive", "X-Accel-Buffering": "no"})
+        await response.prepare(request)
+        queue: asyncio.Queue = asyncio.Queue(maxsize=4)
+        self._ls_subscribers.append(queue)
+        if len(self._ls_subscribers) == 1 and (self._ls_task is None or self._ls_task.done()):
+            self._ls_task = asyncio.create_task(self._lightsheet_streamer(), name="lightsheet-streamer")
+        try:
+            await response.write(b": connected\n\n")
+            while True:
+                try:
+                    payload = await asyncio.wait_for(queue.get(), timeout=10.0)
+                except asyncio.TimeoutError:
+                    await response.write(b": keepalive\n\n"); continue
+                if payload is None: break
+                await response.write(f"data: {json.dumps(payload)}\n\n".encode())
+        except (asyncio.CancelledError, ConnectionResetError, ConnectionAbortedError):
+            pass
+        except Exception:
+            logger.exception("Lightsheet SSE writer failed")
+        finally:
+            try: self._ls_subscribers.remove(queue)
+            except ValueError: pass
+        return response
+
+    async def handle_lightsheet_params(self, request):
+        body = await request.json()
+        for k in ("galvo", "piezo", "exposure"):
+            if k in body and body[k] is not None:
+                self._ls_params[k] = float(body[k])
+        return web.json_response({"params": self._ls_params})
+```
+
+Register both routes near `:2806`:
+```python
+        self._app.router.add_get("/api/lightsheet/stream", self.handle_lightsheet_stream)
+        self._app.router.add_post("/api/lightsheet/live/params", self.handle_lightsheet_params)
+```
+
+- [ ] **Step 4: Run to verify it passes**
+
+Run: `pytest tests/test_lightsheet_streamer.py -v`
+Expected: PASS (2 passed). If `DeviceLayer.__new__` bypassing `__init__` leaves attrs unset, the test sets the needed ones explicitly (it does).
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/hardware/dispim/device_layer.py tests/test_lightsheet_streamer.py
+git commit -m "feat(manual-mode): device-layer lightsheet live streamer (continuous sequence acquisition)"
+```
+
+---
+
+### Task 3: Client methods — `stream_lightsheet` + `set_lightsheet_live_params`
+
+**Files:**
+- Modify: `gently/hardware/dispim/client.py` (add two methods on `DiSPIMMicroscope`, near `stream_bottom_camera` `:913`)
+- Test: `tests/test_lightsheet_client.py`
+
+**Interfaces:**
+- Produces: `async def stream_lightsheet(self, timeout=None)` (async generator over `GET /api/lightsheet/stream`, identical SSE parse to `stream_bottom_camera`); `async def set_lightsheet_live_params(self, galvo=None, piezo=None, exposure=None) -> dict` (`POST /api/lightsheet/live/params`).
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_lightsheet_client.py
+import pytest
+from gently.hardware.dispim.client import DiSPIMMicroscope
+
+async def test_set_params_posts_body(monkeypatch):
+    m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
+    sent = {}
+    async def fake_post(path, body):
+        sent["path"] = path; sent["body"] = body; return {"params": body}
+    m._api_post = fake_post  # confirm the real low-level POST helper name
+    res = await m.set_lightsheet_live_params(galvo=1.0, piezo=42.0, exposure=15.0)
+    assert sent["path"] == "/api/lightsheet/live/params"
+    assert sent["body"] == {"galvo": 1.0, "piezo": 42.0, "exposure": 15.0}
+    assert res == {"params": {"galvo": 1.0, "piezo": 42.0, "exposure": 15.0}}
+
+def test_stream_lightsheet_is_async_generator():
+    m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
+    import inspect
+    assert inspect.isasyncgenfunction(m.stream_lightsheet)
+```
+
+> Confirm the real low-level POST helper (the recon shows `set_led` etc. POST via an internal helper — find whether it's `self._api_post(path, body)` or an inline `self._session.post`). Match it; if `set_lightsheet_live_params` should drop `None` keys, build the body from only the provided args (the test passes all three).
+
+- [ ] **Step 2: Run to verify it fails**
+
+Run: `pytest tests/test_lightsheet_client.py -v` → FAIL (no such methods).
+
+- [ ] **Step 3: Implement**
+
+```python
+    async def stream_lightsheet(self, timeout: float | None = None):
+        """Async generator yielding JPEG frames from the lightsheet live SSE stream.
+
+        Mirrors :meth:`stream_bottom_camera`; subscriber-gated on the device layer.
+        """
+        self._ensure_connected()
+        client_timeout = aiohttp.ClientTimeout(total=None, sock_read=timeout, sock_connect=10.0)
+        url = f"{self.http_url}/api/lightsheet/stream"
+        async with self._session.get(url, timeout=client_timeout) as resp:
+            resp.raise_for_status()
+            buf = b""
+            async for chunk in resp.content.iter_any():
+                if not chunk:
+                    continue
+                buf += chunk
+                while b"\n\n" in buf:
+                    event_block, buf = buf.split(b"\n\n", 1)
+                    data_lines = []
+                    for line in event_block.splitlines():
+                        if not line or line.startswith(b":"):
+                            continue
+                        if line.startswith(b"data:"):
+                            data_lines.append(line[5:].lstrip())
+                    if not data_lines:
+                        continue
+                    raw = b"\n".join(data_lines).decode("utf-8", errors="replace")
+                    try:
+                        import json as _json
+                        yield _json.loads(raw)
+                    except Exception as exc:
+                        logger.warning("Malformed lightsheet SSE payload skipped: %s", exc)
+
+    async def set_lightsheet_live_params(self, galvo=None, piezo=None, exposure=None) -> dict:
+        """POST live galvo/piezo/exposure to the device-layer lightsheet streamer."""
+        body = {}
+        if galvo is not None: body["galvo"] = float(galvo)
+        if piezo is not None: body["piezo"] = float(piezo)
+        if exposure is not None: body["exposure"] = float(exposure)
+        return await self._api_post("/api/lightsheet/live/params", body)
+```
+
+> If the real POST helper isn't `_api_post`, adapt this one call site (and the test) to the real helper. `stream_lightsheet` copies `stream_bottom_camera` verbatim except the URL.
+
+- [ ] **Step 4: Run to verify it passes**
+
+Run: `pytest tests/test_lightsheet_client.py -v` (2 passed)
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/hardware/dispim/client.py tests/test_lightsheet_client.py
+git commit -m "feat(manual-mode): client stream_lightsheet + set_lightsheet_live_params"
+```
+
+---
+
+### Task 4: `LightSheetStreamMonitor` (agent Service) + agent wiring
+
+**Files:**
+- Create: `gently/app/lightsheet_monitor.py`
+- Modify: `gently/app/agent.py` (init attr; construct in `start_viz_server` near the bottom-camera monitor `:849-860`; stop in `stop_viz_server` near `:862-869`)
+- Test: `tests/test_lightsheet_monitor.py`
+- Reference (mirror verbatim, swapping names/event): `gently/app/bottom_camera_monitor.py`
+
+**Interfaces:**
+- Consumes: `microscope.stream_lightsheet()` (Task 3); `EventType.LIGHTSHEET_FRAME` (Task 1).
+- Produces: `LightSheetStreamMonitor(Service)` with `running` property, `on_start`/`on_stop`; publishes `LIGHTSHEET_FRAME`. `agent.lightsheet_monitor` (constructed, not started; started via proxy in Task 5).
+
+- [ ] **Step 1: Write the failing test**
+
+```python
+# tests/test_lightsheet_monitor.py
+import asyncio
+from gently.core.event_bus import EventType, get_event_bus
+from gently.app.lightsheet_monitor import LightSheetStreamMonitor
+
+class FakeScope:
+    async def stream_lightsheet(self):
+        for i in range(3):
+            yield {"t": float(i), "jpeg_b64": f"f{i}"}
+            await asyncio.sleep(0)
+
+async def test_monitor_publishes_frames():
+    bus = get_event_bus()
+    seen = []
+    bus.subscribe(EventType.LIGHTSHEET_FRAME, lambda e: seen.append(e.data))
+    mon = LightSheetStreamMonitor(FakeScope(), reconnect_delay_sec=0.01)
+    await mon.start()
+    await asyncio.sleep(0.05)
+    await mon.stop()
+    assert any(d.get("jpeg_b64") == "f0" for d in seen)
+    assert mon.running is False
+```
+
+- [ ] **Step 2: Run to verify it fails** — `pytest tests/test_lightsheet_monitor.py -v` → FAIL (no module).
+
+- [ ] **Step 3: Implement** — copy `gently/app/bottom_camera_monitor.py` to `gently/app/lightsheet_monitor.py` and change: class → `LightSheetStreamMonitor`; `name="lightsheet-monitor"`; the `_run` loop calls `self.microscope.stream_lightsheet()` and publishes `EventType.LIGHTSHEET_FRAME` with `source="lightsheet-monitor"`. (Everything else — Service base, on_start/on_stop, reconnect loop, `_last_frame_ts`, `running` — is identical.)
+
+Agent wiring in `gently/app/agent.py`: add `self.lightsheet_monitor = None` next to `self.bottom_camera_monitor = None`; in `start_viz_server` (after the bottom-camera monitor construction `:849-860`):
+```python
+        if self.microscope is not None and self.lightsheet_monitor is None:
+            try:
+                from .lightsheet_monitor import LightSheetStreamMonitor
+                self.lightsheet_monitor = LightSheetStreamMonitor(self.microscope)
+                logger.info("Lightsheet monitor ready (not started)")
+            except Exception as e:
+                logger.warning(f"Failed to construct lightsheet monitor: {e}")
+                self.lightsheet_monitor = None
+```
+In `stop_viz_server` (near `:862`):
+```python
+        if self.lightsheet_monitor is not None:
+            try:
+                await self.lightsheet_monitor.stop()
+            except Exception:
+                logger.exception("Failed to stop lightsheet monitor")
+            self.lightsheet_monitor = None
+```
+
+- [ ] **Step 4: Run to verify it passes** — `pytest tests/test_lightsheet_monitor.py -v` (1 passed); `pytest -q` (no new failures).
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/app/lightsheet_monitor.py gently/app/agent.py tests/test_lightsheet_monitor.py
+git commit -m "feat(manual-mode): LightSheetStreamMonitor bridge + agent wiring"
+```
+
+---
+
+### Task 5: Browser proxy routes (`require_control`)
+
+**Files:**
+- Modify: `gently/ui/web/routes/data.py` (add routes in `create_router`, mirroring the bottom-camera + room-light routes)
+- Test: `tests/test_lightsheet_routes.py`
+- Reference: bottom-camera start/stop/status (`data.py:260-311`), room-light proxy (`data.py:335-355`), `_resolve_client` (`:313`), `require_control` (`:10`).
+
+**Interfaces:**
+- Consumes: `agent.lightsheet_monitor` (Task 4); `client.set_lightsheet_live_params`, `set_led`, `set_laser_power`, `set_camera_led_mode`, `move_to_position`, `acquire_burst`, `acquire_volume`.
+- Produces (all `Depends(require_control)` except GET status): `POST /api/devices/lightsheet/live/{start,stop}`, `GET /api/devices/lightsheet/live/status`, `POST /api/devices/lightsheet/live/params`, `POST /api/devices/led/set`, `POST /api/devices/laser/off`, `POST /api/devices/camera/led_mode`, `POST /api/devices/stage/move`, `POST /api/devices/acquire/{burst,volume}`.
+
+- [ ] **Step 1: Write the failing test (TestClient + mock client/monitor)**
+
+```python
+# tests/test_lightsheet_routes.py
+from unittest.mock import MagicMock, AsyncMock
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+from gently.ui.web.routes.data import create_router
+import gently.ui.web.auth as auth
+
+def _app(client=None, monitor=None):
+    server = MagicMock()
+    server.agent_bridge.agent.client = client
+    server.agent_bridge.agent.lightsheet_monitor = monitor
+    app = FastAPI(); app.include_router(create_router(server))
+    # legacy localhost = CONTROL; TestClient client.host is "testclient" → force CONTROL:
+    app.dependency_overrides[auth.require_control] = lambda: True
+    return TestClient(app)
+
+def test_live_params_forwards():
+    client = MagicMock(); client.set_lightsheet_live_params = AsyncMock(return_value={"params": {}})
+    r = _app(client=client).post("/api/devices/lightsheet/live/params",
+                                 json={"galvo": 1.0, "piezo": 40.0, "exposure": 20.0})
+    assert r.status_code == 200
+    client.set_lightsheet_live_params.assert_awaited_once_with(galvo=1.0, piezo=40.0, exposure=20.0)
+
+def test_acquire_burst_forwards():
+    client = MagicMock(); client.acquire_burst = AsyncMock(return_value={"success": True, "request_id": "b1"})
+    r = _app(client=client).post("/api/devices/acquire/burst",
+                                 json={"frames": 60, "mode": "1hz", "num_slices": 1, "exposure_ms": 5.0})
+    assert r.status_code == 200 and r.json().get("request_id") == "b1"
+
+def test_live_start_requires_monitor():
+    r = _app(monitor=None).post("/api/devices/lightsheet/live/start")
+    assert r.status_code == 503
+```
+
+> Confirm the `require_control` override mechanism: in legacy mode `TestClient` requests are not localhost, so override the dependency (as above) to isolate route logic. A separate test can assert the gate by NOT overriding and expecting 403.
+
+- [ ] **Step 2: Run to verify it fails** — `pytest tests/test_lightsheet_routes.py -v` → FAIL (routes 404).
+
+- [ ] **Step 3: Implement** — in `create_router`, add (mirroring the referenced routes). Live start/stop/status copy the bottom-camera versions verbatim, swapping `bottom_camera_monitor` → `lightsheet_monitor`. Then:
+```python
+    @router.post("/api/devices/lightsheet/live/params", dependencies=[Depends(require_control)])
+    async def lightsheet_live_params(payload: dict = Body(...)):  # noqa: B008
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            res = await client.set_lightsheet_live_params(
+                galvo=payload.get("galvo"), piezo=payload.get("piezo"),
+                exposure=payload.get("exposure"))
+        except Exception as exc:
+            logger.exception("lightsheet live params failed")
+            raise HTTPException(status_code=502, detail=f"params failed: {exc}") from exc
+        return res
+
+    @router.post("/api/devices/led/set", dependencies=[Depends(require_control)])
+    async def led_set(payload: dict = Body(...)):  # noqa: B008
+        client = _resolve_client()
+        if client is None: raise HTTPException(status_code=503, detail="Microscope not connected")
+        try: return await client.set_led(str(payload.get("state", "Closed")))
+        except Exception as exc:
+            raise HTTPException(status_code=502, detail=f"led failed: {exc}") from exc
+
+    @router.post("/api/devices/laser/off", dependencies=[Depends(require_control)])
+    async def laser_off():
+        client = _resolve_client()
+        if client is None: raise HTTPException(status_code=503, detail="Microscope not connected")
+        try: return await client.set_laser_power(488, 0)  # confirm signature; force off
+        except Exception as exc:
+            raise HTTPException(status_code=502, detail=f"laser off failed: {exc}") from exc
+
+    @router.post("/api/devices/camera/led_mode", dependencies=[Depends(require_control)])
+    async def camera_led_mode(payload: dict = Body(...)):  # noqa: B008
+        client = _resolve_client()
+        if client is None: raise HTTPException(status_code=503, detail="Microscope not connected")
+        try: return await client.set_camera_led_mode(bool(payload.get("use_led", False)))
+        except Exception as exc:
+            raise HTTPException(status_code=502, detail=f"camera led mode failed: {exc}") from exc
+
+    @router.post("/api/devices/stage/move", dependencies=[Depends(require_control)])
+    async def stage_move(payload: dict = Body(...)):  # noqa: B008
+        client = _resolve_client()
+        if client is None: raise HTTPException(status_code=503, detail="Microscope not connected")
+        try: return await client.move_to_position(float(payload["x"]), float(payload["y"]))
+        except KeyError: raise HTTPException(status_code=400, detail="x and y required")
+        except Exception as exc:
+            raise HTTPException(status_code=502, detail=f"stage move failed: {exc}") from exc
+
+    @router.post("/api/devices/acquire/burst", dependencies=[Depends(require_control)])
+    async def acquire_burst(payload: dict = Body(...)):  # noqa: B008
+        client = _resolve_client()
+        if client is None: raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.acquire_burst(
+                frames=int(payload.get("frames", 60)), mode=str(payload.get("mode", "1hz")),
+                num_slices=int(payload.get("num_slices", 1)),
+                exposure_ms=float(payload.get("exposure_ms", 5.0)))
+        except Exception as exc:
+            raise HTTPException(status_code=502, detail=f"burst failed: {exc}") from exc
+
+    @router.post("/api/devices/acquire/volume", dependencies=[Depends(require_control)])
+    async def acquire_volume(payload: dict = Body(...)):  # noqa: B008
+        client = _resolve_client()
+        if client is None: raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.acquire_volume(
+                num_slices=int(payload.get("num_slices", 50)),
+                exposure_ms=float(payload.get("exposure_ms", 10.0)))
+        except Exception as exc:
+            raise HTTPException(status_code=502, detail=f"volume failed: {exc}") from exc
+```
+Add the live start/stop/status routes by copying `start_bottom_camera_stream`/`stop_bottom_camera_stream`/`get_bottom_camera_status` (`data.py:260-311`) under `/api/devices/lightsheet/live/...` with `getattr(agent, "lightsheet_monitor", None)`.
+
+- [ ] **Step 4: Run to verify it passes** — `pytest tests/test_lightsheet_routes.py -v` (3 passed); `pytest -q` (no new failures).
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/routes/data.py tests/test_lightsheet_routes.py
+git commit -m "feat(manual-mode): require_control proxy routes for lightsheet live + illumination + acquire"
+```
+
+---
+
+### Task 6: Manual view (frontend)
+
+**Files:**
+- Modify: `gently/ui/web/templates/index.html` — add a `data-view="manual"` button to `#devices-view-switcher` (`:445-449`); add a `#devices-view-manual` container with the live canvas + control rail (model the camera panel `:569-608`); load A's `temperature-graph.js` if not already loaded on this page.
+- Modify: `gently/ui/web/static/js/devices.js` — add `'manual'` to `VIEWS` (`:17`); a `handleLightsheetFrame` (mirror `handleCameraFrame` `:1111`); live toggle (mirror `toggleCameraStream`); galvo/piezo/exposure controls (debounced POST `live/params`); illumination toggles; acquire buttons; FPS readout; embed `TemperatureGraph.init`; a `'v'`-style key handled only if not deferred — leave existing keys, add nothing conflicting.
+- Modify: the devices stylesheet for the manual panel (reuse `.devices-camera-*` styles where possible).
+
+**No JS unit harness** — verified by `node --check` + a Chrome-MCP harness (like A) + a UI audit.
+
+- [ ] **Step 1: Markup** — add to `#devices-view-switcher`:
+```html
+                        <button class="view-btn" data-view="manual" title="Manual control">Manual</button>
+```
+Add the view container after `#devices-view-optical3d` (`:716`-ish), with: a live `<img id="devices-ls-img">` (or `<canvas>`) + placeholder + FPS/side overlay + Start/Stop toggle (`#devices-ls-toggle`); a right rail with exposure input, galvo slider (`#devices-ls-galvo`), piezo slider (`#devices-ls-piezo`), illumination toggles (LED `#devices-ls-led`, camera-LED-mode, room light, a static "Laser: OFF" indicator), a temperature setpoint + `<div id="devices-ls-tempgraph">`, and Snap-volume / Burst buttons + a `#devices-ls-lastcap` card. Mirror the `.devices-camera-*` class structure for the image stage so the existing zoom/pan inline machinery can be reused or replicated.
+
+- [ ] **Step 2: JS — frame paint + controls**
+
+Add `'manual'` to `VIEWS`. Add a frame handler mirroring `handleCameraFrame` (separate DOM ids `_lsImg`/`_lsMeta`, its own FPS window) and subscribe `ClientEventBus.on('LIGHTSHEET_FRAME', handleLightsheetFrame)` in `setupCameraWiring` (or a new `setupManualWiring`). Live toggle hits `/api/devices/lightsheet/live/start|stop`. Galvo/piezo/exposure inputs: on `input`, **debounce ~120 ms**, then `fetch('/api/devices/lightsheet/live/params', {method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify({galvo, piezo, exposure})})`. Illumination toggles POST their routes. Acquire buttons POST `/api/devices/acquire/burst|volume` with the current params, show "acquiring…" then render the result ref in `#devices-ls-lastcap`. Embed A's graph: `if (window.TemperatureGraph) TemperatureGraph.init(document.getElementById('devices-ls-tempgraph'), 'current')`. FPS readout from the frame handler's window (reuse the `computeCameraFps` approach).
+
+- [ ] **Step 3: `node --check`** — `node --check gently/ui/web/static/js/devices.js` (exit 0).
+
+- [ ] **Step 4: Chrome-MCP harness verification** — build a standalone harness (like A's): copy `event-bus.js`, `temperature-graph.js`, the new manual JS, and `main.css`; stub `fetch` for `live/params` + status + acquire; feed simulated `LIGHTSHEET_FRAME` events (a moving synthetic gradient that shifts when galvo/piezo "params" change) to demonstrate the slide-and-see; screenshot; run the alignment/spacing/contrast UI audit and fix flaws. Live in-app + FPS verification is deferred to the rig.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add gently/ui/web/templates/index.html gently/ui/web/static/js/devices.js gently/ui/web/static/css/main.css
+git commit -m "feat(manual-mode): Manual view — SPIM live canvas, galvo/piezo/exposure, illumination, acquire, temp"
+```
+
+---
+
+### Task 7: FPS measurement (rig) + conditional binary transport
+
+**Files:**
+- Create: `docs/superpowers/notes/2026-06-28-lightsheet-fps-measurement.md` (record the numbers)
+- (Conditional) Modify: `gently/ui/web/connection_manager.py` + `agent_ws`/`server.py` + `websocket.js` for a binary frame path.
+
+**This task is a measurement + a gate, not unconditional code.**
+
+- [ ] **Step 1:** On the rig, start lightsheet live and record from the Manual-view FPS readout + device logs: **device grab rate**, **delivered rate**, **browser paint rate**, at 512 px/q70 and at a reduced 384 px/q60. Write them into the notes file with the exposure used.
+- [ ] **Step 2: Diagnose.** If device grab < ~15 fps → limiter is exposure/readout/rpyc, not transport — tune exposure/size/quality, stop here. If device grab ≥ target but browser paint < target → transport is the bottleneck → do Step 3.
+- [ ] **Step 3 (conditional): binary WebSocket path.** Add a `send_bytes`-based frame channel: device→agent SSE stays; on the agent→browser hop, push the raw JPEG via `websocket.send_bytes(prefix + jpeg)` (small type byte), bypassing base64 + the per-client `json.dumps` + the EventBus fan-out; browser `onmessage` binary → `createImageBitmap(new Blob([buf]))` → `ctx.drawImage`. Re-measure and record.
+- [ ] **Step 4: Commit** the notes (and any binary-path code, if built).
+
+```bash
+git add docs/superpowers/notes/2026-06-28-lightsheet-fps-measurement.md
+git commit -m "docs(manual-mode): lightsheet live FPS measurement + transport decision"
+```
+
+---
+
+## Self-Review
+
+**Spec coverage:** §2.1 streamer → Task 2; §2.2 monitor → Task 4; §2.3 proxy routes → Task 5; §2.4 client methods → Task 3; §2.5 Manual view → Task 6; §2.6 concurrency (`_state_pause_counter` back-off) → Task 2 streamer loop; §2.7 brightfield laser-off → Tasks 2 & 5 (`laser/off`); §3 transport baseline + measurement + binary escalation → Tasks 1/4 (baseline) + Task 7 (measure/escalate); §4 error handling → Tasks 2/5 (try/except, 503/502); §5 testing → each task's tests + Task 6 harness; LIGHTSHEET_FRAME event → Task 1. Single-camera (no side A/B) reflected throughout. ✓
+
+**Open confirmations (explicit, not placeholders):** pymmcore sequence-acq method availability + core handle (Task 2); scanner/piezo park method names (Task 2); the SetupPanel scanner/beam question (Task 2); the client low-level POST helper name (Task 3); the `require_control` test-override mechanism (Task 5). Each names a concrete fallback.
+
+**Type consistency:** frame payload `{t, shape, downsample, mime, jpeg_b64}` (reused encoder) across Tasks 2/3/4/6; live params `{galvo, piezo, exposure}` across Tasks 2/3/5/6; event `LIGHTSHEET_FRAME` across Tasks 1/4/6; `lightsheet_monitor` attr across Tasks 4/5. Consistent.
diff --git a/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md b/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md
index 0ac1365a..3d846a36 100644
--- a/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md
+++ b/docs/superpowers/specs/2026-06-28-manual-mode-live-view-design.md
@@ -188,3 +188,31 @@ defer live/FPS verification to the microscope — as with A.
 ## 6. Out of scope (B2)
 Laser channel-preset browser; full timelapse/volume configuration form; side-by-side dual view;
 richer camera selection.
+
+## 7. Appendix: ASIdiSPIM two-camera model (B2 reference)
+
+From the MM ASIdiSPIM plugin (`../micro-manager/plugins/ASIdiSPIM`), for when B2 adds side A/B:
+
+- **Camera roles** (`data/Devices.java:93-121`): `CAMERAA` (side-A imaging), `CAMERAB`
+  (side-B imaging), `CAMERALOWER` (bottom), `MULTICAMERA` (the MMCore *Utilities* "Multi Camera"
+  fusion adapter). `SPIM_CAMERAS = {CAMERAA, CAMERAB}`; a `Sides` enum (A/B/NONE).
+- **Live / single-side select** (`data/Cameras.java:163-186`, `setCamera`): `core.setCameraDevice(
+  mmDevice)` bracketed by stop/start-live; `getCurrentCamera` (`:193-210`) treats the Core as the
+  source of truth. Live can target one side **or** `MULTICAMERA` (dual live via the Utilities
+  Multi-Camera device).
+- **Multi-Camera discovery** (`DevicesPanel.java:167-180`): auto-detected by
+  `getDeviceLibrary=="Utilities"` AND `getDeviceDescription=="Combine multiple physical cameras
+  into a single logical camera"`.
+- **Acquisition does NOT use the fusion device** (`AcquisitionPanel.java:2668-2671`): it runs
+  **two parallel `startSequenceAcquisition`** on the physical side cameras into one shared buffer
+  (equal ROI required) and **demuxes by the per-image `"Camera"` tag** (`:2736-2772`; side A → even
+  channel indices, side B → odd). The Utilities Multi-Camera is reserved for **dual live**.
+
+**Implication for gently:** B1's streamer already does `core.setCameraDevice(cam.name)` before the
+continuous sequence — that IS the MM side-select point. To add side A/B in **B2**: register
+`CAMERAA`/`CAMERAB` (and auto-discover the Utilities "Multi Camera") in `device_factory.py`; add a
+camera-role selector that sets the device before starting the live sequence; for dual **live**,
+point the sequence at the Multi-Camera device; for dual **acquisition**, either use the
+Multi-Camera or replicate the two-sequence + `"Camera"`-tag demux. Correction to the working
+assumption: ASIdiSPIM acquisition is **two independent sequences demuxed by tag**, not the
+multicamera fusion — the fusion device is a live-only convenience.

From ec917e06c2cd9063bf9f3292ef32b708be408b1a Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:27:24 +0530
Subject: [PATCH 178/314] feat(manual-mode): add LIGHTSHEET_FRAME event type +
 frontend exclusion

---
 gently/core/event_bus.py             |  2 ++
 gently/ui/web/static/js/websocket.js |  3 ++-
 tests/test_lightsheet_event.py       | 22 ++++++++++++++++++++++
 3 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 tests/test_lightsheet_event.py

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index b3bd7e68..9774bdaa 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -86,6 +86,7 @@ class EventType(Enum):
     DEVICE_STATE_UPDATE = auto()  # Periodic device-state snapshot from device layer
     TEMPERATURE_UPDATE = auto()  # Temperature reading from device layer
     BOTTOM_CAMERA_FRAME = auto()  # Live JPEG frame from the bottom camera stream
+    LIGHTSHEET_FRAME = auto()  # Live JPEG frame from the SPIM lightsheet live stream
     EMBRYOS_UPDATE = auto()  # Full embryo list snapshot from agent.experiment
     SCAN_GEOMETRY_UPDATE = auto()  # Scan cuboid + light-sheet mode for the 3D optical-space view
 
@@ -188,6 +189,7 @@ class EventType(Enum):
         EventType.DEVICE_STATE_UPDATE,
         EventType.TEMPERATURE_UPDATE,  # High-volume telemetry from temperature controller
         EventType.BOTTOM_CAMERA_FRAME,  # ~2 Hz JPEG frames — would crowd history out
+        EventType.LIGHTSHEET_FRAME,  # High-volume live frames — keep out of history
         EventType.LOG_RECORD,  # log lines can hit hundreds/min during
         # calibration; durable copy is in the
         # gently_*.log file already
diff --git a/gently/ui/web/static/js/websocket.js b/gently/ui/web/static/js/websocket.js
index bcbef78f..cd2ba5d5 100644
--- a/gently/ui/web/static/js/websocket.js
+++ b/gently/ui/web/static/js/websocket.js
@@ -104,7 +104,8 @@ function handleMessage(msg) {
         // client event bus so the Devices tab gets the payload.
         if (msg.event_type !== 'DEVICE_STATE_UPDATE' &&
             msg.event_type !== 'BOTTOM_CAMERA_FRAME' &&
-            msg.event_type !== 'TEMPERATURE_UPDATE') {
+            msg.event_type !== 'TEMPERATURE_UPDATE' &&
+            msg.event_type !== 'LIGHTSHEET_FRAME') {
             handleFullEvent({
                 event_type: msg.event_type,
                 data: msg.data,
diff --git a/tests/test_lightsheet_event.py b/tests/test_lightsheet_event.py
new file mode 100644
index 00000000..20271403
--- /dev/null
+++ b/tests/test_lightsheet_event.py
@@ -0,0 +1,22 @@
+"""Tests for LIGHTSHEET_FRAME event type"""
+
+from gently.core.event_bus import EventType, EventBus, _NO_HISTORY_TYPES
+
+
+def test_lightsheet_frame_event_exists():
+    """LIGHTSHEET_FRAME event type should exist with correct name"""
+    assert EventType.LIGHTSHEET_FRAME.name == "LIGHTSHEET_FRAME"
+
+
+def test_lightsheet_frame_excluded_from_history():
+    """LIGHTSHEET_FRAME should be excluded from event history (high-volume telemetry)"""
+    assert EventType.LIGHTSHEET_FRAME in _NO_HISTORY_TYPES
+
+
+def test_lightsheet_frame_publishes_to_subscriber():
+    """Publishing LIGHTSHEET_FRAME should reach subscribers"""
+    bus = EventBus()
+    seen = []
+    bus.subscribe(EventType.LIGHTSHEET_FRAME, lambda e: seen.append(e.data))
+    bus.publish(event_type=EventType.LIGHTSHEET_FRAME, data={"jpeg_b64": "x"}, source="t")
+    assert seen == [{"jpeg_b64": "x"}]

From 0ec20c2c7ebe623702ac09244f7df7c4131ca5ab Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:37:27 +0530
Subject: [PATCH 179/314] feat(manual-mode): device-layer lightsheet live
 streamer (continuous sequence acquisition)

---
 gently/hardware/dispim/device_layer.py | 210 ++++++++++++++++++++++++-
 tests/test_lightsheet_streamer.py      |  87 ++++++++++
 2 files changed, 294 insertions(+), 3 deletions(-)
 create mode 100644 tests/test_lightsheet_streamer.py

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 55e8225d..c1331904 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -168,6 +168,16 @@ def __init__(
         self._cam_target_max_dim: int = 360  # ~360px thumbnail
         self._cam_jpeg_quality: int = 55
 
+        # Lightsheet (SPIM) live stream — continuous sequence acquisition.
+        self._ls_subscribers: list[asyncio.Queue] = []
+        self._ls_task: asyncio.Task | None = None
+        self._ls_interval_sec: float = 0.0          # peek as fast as exposure allows
+        self._ls_target_max_dim: int = 512
+        self._ls_jpeg_quality: int = 70
+        self._ls_params: dict = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0}
+        self._ls_seq_started: bool = False
+        self._ls_applied: dict = {}                  # last-applied galvo/piezo/exposure
+
         # Plans that hold MMCore for long performance-critical work.
         # Anything in this set runs with state polling paused.
         self._heavy_plans = frozenset(
@@ -845,7 +855,9 @@ def _capture_bottom_frame_sync(self) -> np.ndarray | None:
             logger.debug("Bottom-camera grab failed: %s", exc)
             return None
 
-    def _encode_frame_for_stream(self, img: np.ndarray) -> dict[str, Any] | None:
+    def _encode_frame_for_stream(
+        self, img: np.ndarray, max_dim: int | None = None, quality: int | None = None
+    ) -> dict[str, Any] | None:
         """Downsample + auto-contrast + JPEG-encode a uint16 frame for SSE.
 
         Optimised for streaming throughput:
@@ -854,6 +866,10 @@ def _encode_frame_for_stream(self, img: np.ndarray) -> dict[str, Any] | None:
             full image — np.partition on the subsample is O(n) and avoids
             sorting ~120K pixels every frame
           * JPEG quality 55 (visually fine at thumbnail size)
+
+        ``max_dim`` and ``quality`` default to the ``_cam_*`` instance values,
+        allowing callers (e.g. the lightsheet streamer) to pass different
+        settings without duplicating the encoder.
         """
         if img is None or img.size == 0:
             return None
@@ -865,9 +881,12 @@ def _encode_frame_for_stream(self, img: np.ndarray) -> dict[str, Any] | None:
             logger.warning("Cannot encode frame — OpenCV unavailable: %s", exc)
             return None
 
+        target_max_dim = max_dim if max_dim is not None else self._cam_target_max_dim
+        jpeg_quality = quality if quality is not None else self._cam_jpeg_quality
+
         h, w = img.shape[:2]
         # Stride slicing — no interpolation, just take every Nth pixel.
-        factor = max(1, max(h, w) // self._cam_target_max_dim)
+        factor = max(1, max(h, w) // target_max_dim)
         small = img[::factor, ::factor]
 
         # Auto-contrast off a small random sample. Robust to hot pixels
@@ -889,7 +908,7 @@ def _encode_frame_for_stream(self, img: np.ndarray) -> dict[str, Any] | None:
             scale = 255.0 / (hi - lo)
             small = np.clip((small.astype(np.float32) - lo) * scale, 0, 255).astype(np.uint8)
 
-        ok, jpeg = cv2.imencode(".jpg", small, [cv2.IMWRITE_JPEG_QUALITY, self._cam_jpeg_quality])
+        ok, jpeg = cv2.imencode(".jpg", small, [cv2.IMWRITE_JPEG_QUALITY, jpeg_quality])
         if not ok:
             return None
         b64 = base64.b64encode(jpeg.tobytes()).decode("ascii")
@@ -953,6 +972,187 @@ async def _broadcast_camera(self, payload: dict[str, Any]):
             except ValueError:
                 pass
 
+    # =========================================================================
+    # Lightsheet (SPIM) Live Streamer — continuous sequence acquisition
+    # =========================================================================
+
+    def _park_lightsheet_sync(self) -> None:
+        """Park scanner galvo + imaging piezo at the current live params (static sheet)."""
+        p = self._ls_params
+        scanner = self.devices.get("scanner")
+        piezo = self.devices.get("piezo")
+        if scanner is not None:
+            try:
+                scanner.set_spim_state("Idle")
+            except Exception:
+                pass
+            scanner.sa_offset_y.setPosition(float(p["galvo"]))
+        if piezo is not None:
+            try:
+                piezo.set_spim_state("Idle")
+            except Exception:
+                pass
+            piezo.setPosition(float(p["piezo"]))
+
+    def _ensure_lightsheet_sequence_sync(self) -> None:
+        """Start (or restart on exposure change) the continuous sequence on the SPIM camera."""
+        core = self.system.core
+        cam = self.devices.get("camera")
+        if cam is None:
+            raise RuntimeError("No lightsheet camera configured")
+        p = self._ls_params
+        need_restart = (
+            not self._ls_seq_started
+            or self._ls_applied.get("exposure") != p["exposure"]
+        )
+        if need_restart:
+            if core.isSequenceRunning():
+                core.stopSequenceAcquisition()
+            if core.getCameraDevice() != cam.name:
+                core.setCameraDevice(cam.name)
+            core.setExposure(cam.name, float(p["exposure"]))
+            core.startContinuousSequenceAcquisition(self._ls_interval_sec * 1000.0)
+            self._ls_seq_started = True
+            self._ls_applied["exposure"] = p["exposure"]
+
+    def _grab_lightsheet_frame_sync(self):
+        """Park → ensure sequence running → peek the latest frame (never drain)."""
+        try:
+            self._park_lightsheet_sync()                  # galvo/piezo applied live
+            self._ensure_lightsheet_sequence_sync()       # start / restart on exposure
+            try:
+                from gently.hardware.dispim.devices.acquisition import _safe_obtain
+            except (ImportError, AttributeError):
+                _safe_obtain = None
+            core = self.system.core
+            img = core.getLastImage()
+            if _safe_obtain is not None:
+                try:
+                    img = _safe_obtain(img)
+                except Exception:
+                    pass
+            return np.asarray(img)
+        except Exception as exc:
+            logger.debug("Lightsheet grab failed: %s", exc)
+            return None
+
+    def _stop_lightsheet_sequence_sync(self) -> None:
+        try:
+            if self.system.core.isSequenceRunning():
+                self.system.core.stopSequenceAcquisition()
+        except Exception:
+            logger.debug("stop lightsheet sequence failed", exc_info=True)
+        self._ls_seq_started = False
+        self._ls_applied = {}
+
+    async def _lightsheet_streamer(self):
+        logger.info("Lightsheet streamer started")
+        try:
+            while self._ls_subscribers:
+                if self._state_pause_counter > 0:
+                    # Heavy plan owns MMCore: release the sequence and back off.
+                    if self._ls_seq_started:
+                        await asyncio.to_thread(self._stop_lightsheet_sequence_sync)
+                    await asyncio.sleep(0.1)
+                    continue
+                tick = time.monotonic()
+                img = await asyncio.to_thread(self._grab_lightsheet_frame_sync)
+                payload = (
+                    self._encode_frame_for_stream(img, self._ls_target_max_dim, self._ls_jpeg_quality)
+                    if img is not None
+                    else None
+                )
+                if payload is not None:
+                    await self._broadcast_lightsheet(payload)
+                elapsed = time.monotonic() - tick
+                # Pace to at least the exposure; peek-rate caps near the camera rate.
+                floor = max(self._ls_interval_sec, self._ls_params["exposure"] / 1000.0)
+                await asyncio.sleep(max(0.0, floor - elapsed))
+        except asyncio.CancelledError:
+            raise
+        except Exception:
+            logger.exception("Lightsheet streamer crashed")
+        finally:
+            await asyncio.to_thread(self._stop_lightsheet_sequence_sync)
+            logger.info("Lightsheet streamer exiting")
+
+    async def _broadcast_lightsheet(self, payload: dict[str, Any]):
+        if not self._ls_subscribers:
+            return
+        dead: list[asyncio.Queue] = []
+        for q in self._ls_subscribers:
+            try:
+                q.put_nowait(payload)
+            except asyncio.QueueFull:
+                try:
+                    _ = q.get_nowait()
+                    q.put_nowait(payload)
+                except Exception:
+                    dead.append(q)
+        for q in dead:
+            try:
+                self._ls_subscribers.remove(q)
+            except ValueError:
+                pass
+
+    async def handle_lightsheet_stream(self, request):
+        """GET /api/lightsheet/stream — SSE of base64-JPEG frames from SPIM camera.
+
+        The streamer task spins up on first connect and exits when the last
+        subscriber leaves. Uses continuous sequence acquisition for best FPS.
+        """
+        response = web.StreamResponse(
+            status=200,
+            reason="OK",
+            headers={
+                "Content-Type": "text/event-stream",
+                "Cache-Control": "no-cache",
+                "Connection": "keep-alive",
+                "X-Accel-Buffering": "no",
+            },
+        )
+        await response.prepare(request)
+
+        queue: asyncio.Queue = asyncio.Queue(maxsize=4)
+        self._ls_subscribers.append(queue)
+        if len(self._ls_subscribers) == 1 and (self._ls_task is None or self._ls_task.done()):
+            self._ls_task = asyncio.create_task(
+                self._lightsheet_streamer(), name="lightsheet-streamer"
+            )
+        try:
+            await response.write(b": connected\n\n")
+            while True:
+                try:
+                    payload = await asyncio.wait_for(queue.get(), timeout=10.0)
+                except asyncio.TimeoutError:
+                    await response.write(b": keepalive\n\n")
+                    continue
+                if payload is None:
+                    break
+                await response.write(f"data: {json.dumps(payload)}\n\n".encode())
+        except (asyncio.CancelledError, ConnectionResetError, ConnectionAbortedError):
+            pass
+        except Exception:
+            logger.exception("Lightsheet SSE writer failed")
+        finally:
+            try:
+                self._ls_subscribers.remove(queue)
+            except ValueError:
+                pass
+        return response
+
+    async def handle_lightsheet_params(self, request):
+        """POST /api/lightsheet/live/params — update live galvo/piezo/exposure.
+
+        Body: {"galvo": float, "piezo": float, "exposure": float} (all optional).
+        Galvo/piezo apply on the next grab; exposure change triggers sequence restart.
+        """
+        body = await request.json()
+        for k in ("galvo", "piezo", "exposure"):
+            if k in body and body[k] is not None:
+                self._ls_params[k] = float(body[k])
+        return web.json_response({"params": self._ls_params})
+
     # =========================================================================
     # MMCore Push Callbacks
     # =========================================================================
@@ -2806,6 +3006,10 @@ async def on_start(self):
         # Bottom-camera live stream (subscriber-gated, off when nobody listens)
         self._app.router.add_get("/api/bottom_camera/stream", self.handle_bottom_camera_stream)
 
+        # Lightsheet (SPIM) live stream — continuous sequence acquisition
+        self._app.router.add_get("/api/lightsheet/stream", self.handle_lightsheet_stream)
+        self._app.router.add_post("/api/lightsheet/live/params", self.handle_lightsheet_params)
+
         # Start plan executor
         self._executor_task = asyncio.create_task(self._plan_executor())
 
diff --git a/tests/test_lightsheet_streamer.py b/tests/test_lightsheet_streamer.py
new file mode 100644
index 00000000..78b79c4b
--- /dev/null
+++ b/tests/test_lightsheet_streamer.py
@@ -0,0 +1,87 @@
+# tests/test_lightsheet_streamer.py
+import sys
+from unittest.mock import MagicMock
+
+# Patch heavy hardware deps before importing device_layer
+for _mod in ("bluesky", "bluesky.run_engine", "ophyd", "ophyd.status",
+             "pymmcore", "gently.hardware.console_ui"):
+    if _mod not in sys.modules:
+        sys.modules[_mod] = MagicMock()
+
+# Patch bluesky.RunEngine specifically
+import bluesky as _bs
+_bs.RunEngine = MagicMock(name="RunEngine")
+
+import asyncio, numpy as np, pytest
+from gently.hardware.dispim.device_layer import DeviceLayerServer
+
+
+class FakeCore:
+    def __init__(self):
+        self.running = False; self.exposure = None; self.cam = None
+        self._frame = np.full((64, 64), 1000, dtype=np.uint16)
+        self.started = 0; self.stopped = 0
+    def setCameraDevice(self, n): self.cam = n
+    def getCameraDevice(self): return self.cam
+    def setExposure(self, n, ms): self.exposure = ms
+    def startContinuousSequenceAcquisition(self, interval): self.running = True; self.started += 1
+    def stopSequenceAcquisition(self): self.running = False; self.stopped += 1
+    def isSequenceRunning(self): return self.running
+    def getLastImage(self): return self._frame
+
+
+class FakeAxis:
+    def __init__(self): self.pos = None
+    def setPosition(self, v): self.pos = v
+
+
+class FakeScanner:
+    def __init__(self): self.sa_offset_y = FakeAxis(); self.name = "Scanner"; self.state = None
+    def set_spim_state(self, s): self.state = s
+
+
+class FakePiezo(FakeAxis):
+    def __init__(self): super().__init__(); self.name = "Piezo"; self.state = None
+    def set_spim_state(self, s): self.state = s
+
+
+def _make_dl():
+    dl = DeviceLayerServer.__new__(DeviceLayerServer)
+    dl.system = type("S", (), {"core": FakeCore()})()
+    dl.devices = {
+        "camera": type("C", (), {"name": "HamCam1"})(),
+        "scanner": FakeScanner(),
+        "piezo": FakePiezo(),
+    }
+    return dl
+
+
+@pytest.mark.asyncio
+async def test_grab_parks_and_peeks(monkeypatch):
+    dl = _make_dl()
+    dl._state_pause_counter = 0
+    dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
+    dl._ls_params = {"galvo": 1.5, "piezo": 40.0, "exposure": 20.0}
+    dl._ls_seq_started = False; dl._ls_applied = {}
+    dl._ls_interval_sec = 0.0
+    img = await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
+    assert img is not None and img.shape == (64, 64)
+    assert dl.system.core.running is True              # sequence started
+    assert dl.devices["piezo"].pos == 40.0             # piezo parked
+    assert dl.devices["scanner"].sa_offset_y.pos == 1.5  # galvo parked
+
+
+@pytest.mark.asyncio
+async def test_exposure_change_restarts_sequence():
+    dl = _make_dl()
+    dl._state_pause_counter = 0
+    dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
+    dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 10.0}
+    dl._ls_seq_started = False; dl._ls_applied = {}
+    dl._ls_interval_sec = 0.0
+    await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
+    starts = dl.system.core.started
+    dl._ls_params["exposure"] = 30.0                   # exposure change
+    await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
+    assert dl.system.core.stopped >= 1 and dl.system.core.started == starts + 1
+    assert dl.system.core.exposure == 30.0

From 2c2cc9514af6d14786b773725dd5336bccd7ec7d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:44:49 +0530
Subject: [PATCH 180/314] feat(manual-mode): client stream_lightsheet +
 set_lightsheet_live_params

---
 gently/hardware/dispim/client.py | 50 ++++++++++++++++++++++++++++++++
 tests/test_lightsheet_client.py  | 25 ++++++++++++++++
 2 files changed, 75 insertions(+)
 create mode 100644 tests/test_lightsheet_client.py

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 56a9a33c..3c1aced2 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -954,6 +954,56 @@ async def stream_bottom_camera(self, timeout: float | None = None):
                     except Exception as exc:
                         logger.warning("Malformed bottom-camera SSE payload skipped: %s", exc)
 
+    async def stream_lightsheet(self, timeout: float | None = None):
+        """Async generator yielding JPEG frames from the lightsheet live SSE stream.
+
+        Mirrors :meth:`stream_bottom_camera`; subscriber-gated on the device layer.
+        """
+        self._ensure_connected()
+        client_timeout = aiohttp.ClientTimeout(
+            total=None,
+            sock_read=timeout,
+            sock_connect=10.0,
+        )
+        url = f"{self.http_url}/api/lightsheet/stream"
+        async with self._session.get(url, timeout=client_timeout) as resp:
+            resp.raise_for_status()
+            buf = b""
+            async for chunk in resp.content.iter_any():
+                if not chunk:
+                    continue
+                buf += chunk
+                while b"\n\n" in buf:
+                    event_block, buf = buf.split(b"\n\n", 1)
+                    data_lines = []
+                    for line in event_block.splitlines():
+                        if not line or line.startswith(b":"):
+                            continue
+                        if line.startswith(b"data:"):
+                            data_lines.append(line[5:].lstrip())
+                    if not data_lines:
+                        continue
+                    raw = b"\n".join(data_lines).decode("utf-8", errors="replace")
+                    try:
+                        import json as _json
+
+                        yield _json.loads(raw)
+                    except Exception as exc:
+                        logger.warning("Malformed lightsheet SSE payload skipped: %s", exc)
+
+    async def set_lightsheet_live_params(
+        self, galvo=None, piezo=None, exposure=None
+    ) -> dict:
+        """POST live galvo/piezo/exposure to the device-layer lightsheet streamer."""
+        body = {}
+        if galvo is not None:
+            body["galvo"] = float(galvo)
+        if piezo is not None:
+            body["piezo"] = float(piezo)
+        if exposure is not None:
+            body["exposure"] = float(exposure)
+        return await self._api_post("/api/lightsheet/live/params", body)
+
     async def set_camera_led_mode(self, use_led: bool = False) -> dict:
         """Enable/disable automatic LED for bottom camera captures."""
         return await self._api_post("/api/camera/led_mode", {"use_led": use_led})
diff --git a/tests/test_lightsheet_client.py b/tests/test_lightsheet_client.py
new file mode 100644
index 00000000..75c0d392
--- /dev/null
+++ b/tests/test_lightsheet_client.py
@@ -0,0 +1,25 @@
+import pytest
+from gently.hardware.dispim.client import DiSPIMMicroscope
+
+
+async def test_set_params_posts_body(monkeypatch):
+    m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
+    sent = {}
+
+    async def fake_post(path, body):
+        sent["path"] = path
+        sent["body"] = body
+        return {"params": body}
+
+    m._api_post = fake_post  # confirm the real low-level POST helper name
+    res = await m.set_lightsheet_live_params(galvo=1.0, piezo=42.0, exposure=15.0)
+    assert sent["path"] == "/api/lightsheet/live/params"
+    assert sent["body"] == {"galvo": 1.0, "piezo": 42.0, "exposure": 15.0}
+    assert res == {"params": {"galvo": 1.0, "piezo": 42.0, "exposure": 15.0}}
+
+
+def test_stream_lightsheet_is_async_generator():
+    m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
+    import inspect
+
+    assert inspect.isasyncgenfunction(m.stream_lightsheet)

From 8b86000fdeb6cb7470e9138f24736e8cb1b0882f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:48:37 +0530
Subject: [PATCH 181/314] feat(manual-mode): LightSheetStreamMonitor bridge +
 agent wiring

---
 gently/app/agent.py              | 18 ++++++
 gently/app/lightsheet_monitor.py | 98 ++++++++++++++++++++++++++++++++
 tests/test_lightsheet_monitor.py | 32 +++++++++++
 3 files changed, 148 insertions(+)
 create mode 100644 gently/app/lightsheet_monitor.py
 create mode 100644 tests/test_lightsheet_monitor.py

diff --git a/gently/app/agent.py b/gently/app/agent.py
index afe2e649..02ec700a 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -215,6 +215,8 @@ def __init__(
         # Opt-in bottom-camera stream bridge — created when viz starts, but
         # left unstarted until the operator clicks "Start camera" in the UI.
         self.bottom_camera_monitor = None
+        # Opt-in lightsheet stream bridge — same lifecycle as bottom_camera_monitor.
+        self.lightsheet_monitor = None
 
         # ===== Create delegate managers =====
 
@@ -859,6 +861,16 @@ async def start_viz_server(
                 logger.warning(f"Failed to construct bottom-camera monitor: {e}")
                 self.bottom_camera_monitor = None
 
+        if self.microscope is not None and self.lightsheet_monitor is None:
+            try:
+                from .lightsheet_monitor import LightSheetStreamMonitor
+
+                self.lightsheet_monitor = LightSheetStreamMonitor(self.microscope)
+                logger.info("Lightsheet monitor ready (not started)")
+            except Exception as e:
+                logger.warning(f"Failed to construct lightsheet monitor: {e}")
+                self.lightsheet_monitor = None
+
     async def stop_viz_server(self):
         """Stop the visualization server if running."""
         if self.bottom_camera_monitor is not None:
@@ -867,6 +879,12 @@ async def stop_viz_server(self):
             except Exception:
                 logger.exception("Failed to stop bottom-camera monitor")
             self.bottom_camera_monitor = None
+        if self.lightsheet_monitor is not None:
+            try:
+                await self.lightsheet_monitor.stop()
+            except Exception:
+                logger.exception("Failed to stop lightsheet monitor")
+            self.lightsheet_monitor = None
         if self.device_state_monitor is not None:
             try:
                 await self.device_state_monitor.stop()
diff --git a/gently/app/lightsheet_monitor.py b/gently/app/lightsheet_monitor.py
new file mode 100644
index 00000000..78b7ca39
--- /dev/null
+++ b/gently/app/lightsheet_monitor.py
@@ -0,0 +1,98 @@
+"""
+LightSheetStreamMonitor — bridges the device-layer lightsheet SSE stream
+onto the EventBus as ``LIGHTSHEET_FRAME`` events.
+
+Modelled on :class:`gently.app.bottom_camera_monitor.BottomCameraStreamMonitor`,
+with the same opt-in semantics: streaming is not started on agent boot — only
+when the operator enables it explicitly from the UI. The agent's start/stop
+methods are the only path that connects/disconnects this monitor.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+from typing import TYPE_CHECKING
+
+from gently.core.event_bus import EventType, get_event_bus
+from gently.core.service import Service
+
+if TYPE_CHECKING:
+    from gently.hardware.dispim.client import DiSPIMMicroscope
+
+logger = logging.getLogger(__name__)
+
+
+class LightSheetStreamMonitor(Service):
+    """Consumes the lightsheet SSE stream and republishes frames on the bus.
+
+    The browser receives frames via the viz server's wildcard subscription;
+    no additional plumbing is needed at the agent layer beyond starting the
+    bridge when the operator asks for it.
+    """
+
+    def __init__(
+        self,
+        microscope: DiSPIMMicroscope,
+        reconnect_delay_sec: float = 2.0,
+    ):
+        super().__init__(name="lightsheet-monitor", service_type="bridge")
+        self.microscope = microscope
+        self.reconnect_delay_sec = reconnect_delay_sec
+        self._task: asyncio.Task | None = None
+        self._stop_requested = False
+        self._last_frame_ts: float | None = None
+
+    @property
+    def running(self) -> bool:
+        return self._task is not None and not self._task.done()
+
+    async def on_start(self):
+        if self.running:
+            return
+        self._stop_requested = False
+        self._task = asyncio.create_task(self._run(), name="lightsheet-monitor")
+        logger.info("LightSheetStreamMonitor: started")
+
+    async def on_stop(self):
+        self._stop_requested = True
+        if self._task and not self._task.done():
+            self._task.cancel()
+            try:
+                await self._task
+            except asyncio.CancelledError:
+                pass
+        self._task = None
+        logger.info("LightSheetStreamMonitor: stopped")
+
+    async def _run(self):
+        bus = get_event_bus()
+        while not self._stop_requested:
+            try:
+                logger.info("LightSheetStreamMonitor: opening stream")
+                async for payload in self.microscope.stream_lightsheet():
+                    if self._stop_requested:
+                        break
+                    self._last_frame_ts = payload.get("t")
+                    try:
+                        bus.publish(
+                            event_type=EventType.LIGHTSHEET_FRAME,
+                            data=payload,
+                            source="lightsheet-monitor",
+                        )
+                    except Exception:
+                        logger.exception("Failed to publish frame")
+            except asyncio.CancelledError:
+                raise
+            except Exception as exc:
+                logger.warning(
+                    "LightSheetStreamMonitor: stream ended (%s) — reconnecting in %.1fs",
+                    exc,
+                    self.reconnect_delay_sec,
+                )
+            if self._stop_requested:
+                break
+            try:
+                await asyncio.sleep(self.reconnect_delay_sec)
+            except asyncio.CancelledError:
+                raise
diff --git a/tests/test_lightsheet_monitor.py b/tests/test_lightsheet_monitor.py
new file mode 100644
index 00000000..f5cdf797
--- /dev/null
+++ b/tests/test_lightsheet_monitor.py
@@ -0,0 +1,32 @@
+"""
+Tests for LightSheetStreamMonitor.
+
+Mirrors test_bottom_camera_monitor.py structure; uses a FakeScope that yields
+three synthetic frames so the test never touches the device layer.
+"""
+
+import asyncio
+import pytest
+
+from gently.core.event_bus import EventType, get_event_bus
+from gently.app.lightsheet_monitor import LightSheetStreamMonitor
+
+
+class FakeScope:
+    async def stream_lightsheet(self):
+        for i in range(3):
+            yield {"t": float(i), "jpeg_b64": f"f{i}"}
+            await asyncio.sleep(0)
+
+
+@pytest.mark.asyncio
+async def test_monitor_publishes_frames():
+    bus = get_event_bus()
+    seen = []
+    bus.subscribe(EventType.LIGHTSHEET_FRAME, lambda e: seen.append(e.data))
+    mon = LightSheetStreamMonitor(FakeScope(), reconnect_delay_sec=0.01)
+    await mon.start()
+    await asyncio.sleep(0.05)
+    await mon.stop()
+    assert any(d.get("jpeg_b64") == "f0" for d in seen)
+    assert mon.running is False

From d641fa401e1d06d60d4e453aa134d1a1dcef3f91 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 12:53:12 +0530
Subject: [PATCH 182/314] feat(manual-mode): require_control proxy routes for
 lightsheet live + illumination + acquire

---
 gently/ui/web/routes/data.py    | 175 +++++++++++++++++++++++++
 tests/test_lightsheet_routes.py | 218 ++++++++++++++++++++++++++++++++
 2 files changed, 393 insertions(+)
 create mode 100644 tests/test_lightsheet_routes.py

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index a609526a..4d9f5be8 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -412,6 +412,181 @@ async def set_temperature(payload: dict = Body(...)):  # noqa: B008
             "waited": res.get("waited", False),
         }
 
+    # ------------------------------------------------------------------
+    # Lightsheet live stream
+    # ------------------------------------------------------------------
+
+    @router.get("/api/devices/lightsheet/live/status")
+    async def get_lightsheet_live_status():
+        """Return whether the lightsheet live stream bridge is running."""
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        monitor = getattr(agent, "lightsheet_monitor", None) if agent else None
+        return {
+            "available": monitor is not None,
+            "streaming": bool(monitor and monitor.running),
+            "last_frame_ts": getattr(monitor, "_last_frame_ts", None) if monitor else None,
+        }
+
+    @router.post(
+        "/api/devices/lightsheet/live/start",
+        dependencies=[Depends(require_control)],
+    )
+    async def start_lightsheet_live_stream():
+        """Start the lightsheet live stream bridge.
+
+        Idempotent — calling start() while already running is a no-op.
+        """
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        monitor = getattr(agent, "lightsheet_monitor", None) if agent else None
+        if monitor is None:
+            raise HTTPException(
+                status_code=503,
+                detail="Lightsheet monitor not initialised (agent or microscope not ready)",
+            )
+        try:
+            await monitor.start()
+        except Exception as exc:
+            logger.exception("Failed to start lightsheet monitor")
+            raise HTTPException(status_code=500, detail=f"start failed: {exc}") from exc
+        return {"streaming": monitor.running}
+
+    @router.post(
+        "/api/devices/lightsheet/live/stop",
+        dependencies=[Depends(require_control)],
+    )
+    async def stop_lightsheet_live_stream():
+        """Stop the lightsheet live stream bridge. Idempotent."""
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        monitor = getattr(agent, "lightsheet_monitor", None) if agent else None
+        if monitor is None:
+            return {"streaming": False}
+        try:
+            await monitor.stop()
+        except Exception as exc:
+            logger.exception("Failed to stop lightsheet monitor")
+            raise HTTPException(status_code=500, detail=f"stop failed: {exc}") from exc
+        return {"streaming": False}
+
+    # ------------------------------------------------------------------
+    # Lightsheet live params
+    # ------------------------------------------------------------------
+
+    @router.post("/api/devices/lightsheet/live/params", dependencies=[Depends(require_control)])
+    async def lightsheet_live_params(payload: dict = Body(...)):  # noqa: B008
+        """Forward galvo/piezo/exposure params to the device-layer lightsheet streamer."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            res = await client.set_lightsheet_live_params(
+                galvo=payload.get("galvo"), piezo=payload.get("piezo"),
+                exposure=payload.get("exposure"))
+        except Exception as exc:
+            logger.exception("lightsheet live params failed")
+            raise HTTPException(status_code=502, detail=f"params failed: {exc}") from exc
+        return res
+
+    # ------------------------------------------------------------------
+    # LED / laser / camera
+    # ------------------------------------------------------------------
+
+    @router.post("/api/devices/led/set", dependencies=[Depends(require_control)])
+    async def led_set(payload: dict = Body(...)):  # noqa: B008
+        """Set the LED shutter state. Body: {"state": "Open"|"Closed"}."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.set_led(str(payload.get("state", "Closed")))
+        except Exception as exc:
+            logger.exception("LED set command failed")
+            raise HTTPException(status_code=502, detail=f"led failed: {exc}") from exc
+
+    @router.post("/api/devices/laser/off", dependencies=[Depends(require_control)])
+    async def laser_off():
+        """Force the 488 nm laser off.
+
+        Confirmed signature: set_laser_power(wavelength: int, pct: float).
+        Calls set_laser_power(488, 0) to drive the 488 nm line to 0 %.
+        """
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.set_laser_power(488, 0)
+        except Exception as exc:
+            logger.exception("Laser off command failed")
+            raise HTTPException(status_code=502, detail=f"laser off failed: {exc}") from exc
+
+    @router.post("/api/devices/camera/led_mode", dependencies=[Depends(require_control)])
+    async def camera_led_mode(payload: dict = Body(...)):  # noqa: B008
+        """Enable/disable automatic LED for bottom-camera captures. Body: {"use_led": bool}."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.set_camera_led_mode(bool(payload.get("use_led", False)))
+        except Exception as exc:
+            logger.exception("Camera LED mode command failed")
+            raise HTTPException(status_code=502, detail=f"camera led mode failed: {exc}") from exc
+
+    # ------------------------------------------------------------------
+    # Stage
+    # ------------------------------------------------------------------
+
+    @router.post("/api/devices/stage/move", dependencies=[Depends(require_control)])
+    async def stage_move(payload: dict = Body(...)):  # noqa: B008
+        """Move the stage to an absolute XY position. Body: {"x": float, "y": float}."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.move_to_position(float(payload["x"]), float(payload["y"]))
+        except KeyError:
+            raise HTTPException(status_code=400, detail="x and y required")
+        except Exception as exc:
+            logger.exception("Stage move command failed")
+            raise HTTPException(status_code=502, detail=f"stage move failed: {exc}") from exc
+
+    # ------------------------------------------------------------------
+    # Acquisition
+    # ------------------------------------------------------------------
+
+    @router.post("/api/devices/acquire/burst", dependencies=[Depends(require_control)])
+    async def acquire_burst(payload: dict = Body(...)):  # noqa: B008
+        """Trigger a burst acquisition. Body: {frames, mode, num_slices, exposure_ms}."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.acquire_burst(
+                frames=int(payload.get("frames", 60)),
+                mode=str(payload.get("mode", "1hz")),
+                num_slices=int(payload.get("num_slices", 1)),
+                exposure_ms=float(payload.get("exposure_ms", 5.0)),
+            )
+        except Exception as exc:
+            logger.exception("Burst acquisition failed")
+            raise HTTPException(status_code=502, detail=f"burst failed: {exc}") from exc
+
+    @router.post("/api/devices/acquire/volume", dependencies=[Depends(require_control)])
+    async def acquire_volume(payload: dict = Body(...)):  # noqa: B008
+        """Trigger a volume acquisition. Body: {num_slices, exposure_ms}."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.acquire_volume(
+                num_slices=int(payload.get("num_slices", 50)),
+                exposure_ms=float(payload.get("exposure_ms", 10.0)),
+            )
+        except Exception as exc:
+            logger.exception("Volume acquisition failed")
+            raise HTTPException(status_code=502, detail=f"volume failed: {exc}") from exc
+
     @router.get("/api/calibration")
     async def list_calibration(embryo_id: str | None = None):
         """Get calibration images"""
diff --git a/tests/test_lightsheet_routes.py b/tests/test_lightsheet_routes.py
new file mode 100644
index 00000000..ed68552f
--- /dev/null
+++ b/tests/test_lightsheet_routes.py
@@ -0,0 +1,218 @@
+"""Tests for Task 5 lightsheet browser proxy routes.
+
+Verifies:
+  - live/start, live/stop, live/status — mirror bottom_camera routes
+  - live/params — forwards to client.set_lightsheet_live_params
+  - led/set, laser/off, camera/led_mode, stage/move
+  - acquire/burst, acquire/volume
+  - require_control gate (403 without override)
+"""
+from unittest.mock import MagicMock, AsyncMock
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.ui.web.routes.data import create_router
+import gently.ui.web.auth as auth
+
+
+def _app(client=None, monitor=None):
+    """Build a TestClient with the lightsheet routes wired up.
+
+    Overrides require_control so that the TestClient (host="testclient")
+    always gets the control role — isolates route logic from auth.
+    """
+    server = MagicMock()
+    server.agent_bridge.agent.client = client
+    server.agent_bridge.agent.lightsheet_monitor = monitor
+    app = FastAPI()
+    app.include_router(create_router(server))
+    # TestClient host is "testclient" (not loopback) → override to force CONTROL
+    app.dependency_overrides[auth.require_control] = lambda: True
+    return TestClient(app)
+
+
+# ---------------------------------------------------------------------------
+# live start / stop / status
+# ---------------------------------------------------------------------------
+
+def test_live_status_no_monitor():
+    """GET status returns available=False when monitor is None."""
+    r = _app(monitor=None).get("/api/devices/lightsheet/live/status")
+    assert r.status_code == 200
+    assert r.json()["available"] is False
+
+
+def test_live_status_with_monitor():
+    monitor = MagicMock()
+    monitor.running = True
+    monitor._last_frame_ts = "2026-01-01T00:00:00"
+    r = _app(monitor=monitor).get("/api/devices/lightsheet/live/status")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["available"] is True
+    assert body["streaming"] is True
+
+
+def test_live_start_requires_monitor():
+    """POST start with no monitor → 503."""
+    r = _app(monitor=None).post("/api/devices/lightsheet/live/start")
+    assert r.status_code == 503
+
+
+def test_live_start_calls_monitor_start():
+    monitor = MagicMock()
+    monitor.start = AsyncMock()
+    monitor.running = True
+    r = _app(monitor=monitor).post("/api/devices/lightsheet/live/start")
+    assert r.status_code == 200
+    monitor.start.assert_awaited_once()
+
+
+def test_live_stop_no_monitor_returns_200():
+    """POST stop with no monitor is idempotent — returns 200 streaming=False."""
+    r = _app(monitor=None).post("/api/devices/lightsheet/live/stop")
+    assert r.status_code == 200
+    assert r.json()["streaming"] is False
+
+
+def test_live_stop_calls_monitor_stop():
+    monitor = MagicMock()
+    monitor.stop = AsyncMock()
+    r = _app(monitor=monitor).post("/api/devices/lightsheet/live/stop")
+    assert r.status_code == 200
+    monitor.stop.assert_awaited_once()
+
+
+# ---------------------------------------------------------------------------
+# live/params
+# ---------------------------------------------------------------------------
+
+def test_live_params_forwards():
+    client = MagicMock()
+    client.set_lightsheet_live_params = AsyncMock(return_value={"params": {}})
+    r = _app(client=client).post(
+        "/api/devices/lightsheet/live/params",
+        json={"galvo": 1.0, "piezo": 40.0, "exposure": 20.0},
+    )
+    assert r.status_code == 200
+    client.set_lightsheet_live_params.assert_awaited_once_with(
+        galvo=1.0, piezo=40.0, exposure=20.0
+    )
+
+
+def test_live_params_no_client_503():
+    server = MagicMock()
+    server.agent_bridge.agent.client = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    app.dependency_overrides[auth.require_control] = lambda: True
+    r = TestClient(app).post(
+        "/api/devices/lightsheet/live/params",
+        json={"galvo": 1.0},
+    )
+    assert r.status_code == 503
+
+
+# ---------------------------------------------------------------------------
+# led/set
+# ---------------------------------------------------------------------------
+
+def test_led_set_forwards():
+    client = MagicMock()
+    client.set_led = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post("/api/devices/led/set", json={"state": "Open"})
+    assert r.status_code == 200
+    client.set_led.assert_awaited_once_with("Open")
+
+
+# ---------------------------------------------------------------------------
+# laser/off  — confirmed signature: set_laser_power(wavelength: int, pct: float)
+# ---------------------------------------------------------------------------
+
+def test_laser_off_calls_set_laser_power_488_0():
+    """laser/off must call set_laser_power(488, 0) to force 488 nm line off."""
+    client = MagicMock()
+    client.set_laser_power = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post("/api/devices/laser/off")
+    assert r.status_code == 200
+    client.set_laser_power.assert_awaited_once_with(488, 0)
+
+
+# ---------------------------------------------------------------------------
+# camera/led_mode
+# ---------------------------------------------------------------------------
+
+def test_camera_led_mode_forwards():
+    client = MagicMock()
+    client.set_camera_led_mode = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post("/api/devices/camera/led_mode", json={"use_led": True})
+    assert r.status_code == 200
+    client.set_camera_led_mode.assert_awaited_once_with(True)
+
+
+# ---------------------------------------------------------------------------
+# stage/move
+# ---------------------------------------------------------------------------
+
+def test_stage_move_forwards():
+    client = MagicMock()
+    client.move_to_position = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post("/api/devices/stage/move", json={"x": 100.0, "y": 200.0})
+    assert r.status_code == 200
+    client.move_to_position.assert_awaited_once_with(100.0, 200.0)
+
+
+def test_stage_move_missing_xy_400():
+    client = MagicMock()
+    client.move_to_position = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post("/api/devices/stage/move", json={"x": 1.0})
+    assert r.status_code == 400
+
+
+# ---------------------------------------------------------------------------
+# acquire/burst
+# ---------------------------------------------------------------------------
+
+def test_acquire_burst_forwards():
+    client = MagicMock()
+    client.acquire_burst = AsyncMock(return_value={"success": True, "request_id": "b1"})
+    r = _app(client=client).post(
+        "/api/devices/acquire/burst",
+        json={"frames": 60, "mode": "1hz", "num_slices": 1, "exposure_ms": 5.0},
+    )
+    assert r.status_code == 200 and r.json().get("request_id") == "b1"
+    client.acquire_burst.assert_awaited_once_with(
+        frames=60, mode="1hz", num_slices=1, exposure_ms=5.0
+    )
+
+
+# ---------------------------------------------------------------------------
+# acquire/volume
+# ---------------------------------------------------------------------------
+
+def test_acquire_volume_forwards():
+    client = MagicMock()
+    client.acquire_volume = AsyncMock(return_value={"success": True, "request_id": "v1"})
+    r = _app(client=client).post(
+        "/api/devices/acquire/volume",
+        json={"num_slices": 50, "exposure_ms": 10.0},
+    )
+    assert r.status_code == 200
+    client.acquire_volume.assert_awaited_once_with(num_slices=50, exposure_ms=10.0)
+
+
+# ---------------------------------------------------------------------------
+# require_control gate — 403 WITHOUT override
+# ---------------------------------------------------------------------------
+
+def test_require_control_gate_403():
+    """Without the dependency override, TestClient host is not loopback → 403."""
+    server = MagicMock()
+    server.agent_bridge.agent.client = MagicMock()
+    server.agent_bridge.agent.lightsheet_monitor = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    # Do NOT override require_control here
+    r = TestClient(app).post("/api/devices/lightsheet/live/start")
+    assert r.status_code == 403

From 84a659dc53421d5f88cf1b6a3796fd41ee0d6708 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 13:00:34 +0530
Subject: [PATCH 183/314] fix(manual-mode): laser/off uses Laser ALL OFF config
 + expose laser presets
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace set_laser_power(488, 0) with set_laser_config("ALL OFF") in the
laser/off proxy route so the PLogic gate turns off every laser line, not
just the 488 nm setpoint (spec §2.7 brightfield safety).

Add device-layer handlers handle_set_laser_config / handle_get_laser_configs
(POST /api/laser/config, GET /api/laser/configs) calling
DiSPIMLightSource.set() / ._get_available_configs() on the laser_control
device (group_name="Laser"). Wire matching client methods set_laser_config /
get_laser_configs. Add unguarded GET /api/devices/laser/configs proxy route.
---
 gently/hardware/dispim/client.py       | 23 +++++++++
 gently/hardware/dispim/device_layer.py | 66 ++++++++++++++++++++++++++
 gently/ui/web/routes/data.py           | 26 ++++++++--
 tests/test_lightsheet_client.py        | 37 +++++++++++++++
 tests/test_lightsheet_routes.py        | 45 ++++++++++++++++--
 5 files changed, 188 insertions(+), 9 deletions(-)

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 3c1aced2..1437a8a8 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -811,6 +811,29 @@ async def get_laser_power(self, wavelength: int) -> dict:
         except Exception as e:
             return {"success": False, "error": str(e)}
 
+    async def set_laser_config(self, config_name: str) -> dict:
+        """Apply a Laser config-group preset (e.g. "ALL OFF").
+
+        Hits ``POST /api/laser/config`` — direct, no Bluesky queue.
+        Use ``"ALL OFF"`` to gate every laser line off via the PLogic
+        OutputChannel; other presets from the MM config group are also
+        accepted (e.g. ``"488 only"``, ``"561 only"``).
+
+        Parameters
+        ----------
+        config_name : str
+            Exact preset name from the Laser config group.
+        """
+        return await self._api_post("/api/laser/config", {"config": config_name})
+
+    async def get_laser_configs(self) -> dict:
+        """List available Laser config-group presets.
+
+        Hits ``GET /api/laser/configs`` — returns ``{"configs": [...]}``
+        with the preset names from the MM Laser config group.
+        """
+        return await self._api_get("/api/laser/configs")
+
     async def get_led_status(self) -> dict:
         """Get current LED status."""
         return await self._api_get("/api/led/status")
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index c1331904..6dc97dbb 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -1995,6 +1995,70 @@ async def handle_get_light_source_power(self, request):
                 status=500,
             )
 
+    async def handle_set_laser_config(self, request):
+        """POST /api/laser/config — apply a Laser config-group preset.
+
+        Body: {"config": <preset_name>}
+        Calls light_source.set(config_name) which maps to
+        core.setConfig(group_name, config_name) + waitForConfig.
+        """
+        try:
+            data = await request.json()
+            config_name = data.get("config")
+            if not config_name:
+                return web.json_response(
+                    {"success": False, "error": "missing 'config' field"},
+                    status=400,
+                )
+            light_source = self.devices.get("light_source") or self.devices.get("laser_control")
+            if light_source is None:
+                return web.json_response(
+                    {"success": False, "error": "Light source device not found"},
+                    status=503,
+                )
+            try:
+                light_source.set(config_name)
+            except Exception as e:
+                return web.json_response(
+                    {"success": False, "error": str(e)},
+                    status=400,
+                )
+            return web.json_response({"success": True, "config": config_name})
+        except Exception as e:
+            import traceback
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
+
+    async def handle_get_laser_configs(self, request):
+        """GET /api/laser/configs — list available Laser config-group presets."""
+        try:
+            light_source = self.devices.get("light_source") or self.devices.get("laser_control")
+            if light_source is None:
+                return web.json_response(
+                    {"success": False, "error": "Light source device not found"},
+                    status=503,
+                )
+            configs = light_source._get_available_configs()
+            return web.json_response({"configs": configs})
+        except Exception as e:
+            import traceback
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(e),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
+
     async def handle_get_camera_exposure(self, request):
         """GET /api/camera/exposure - Get bottom camera exposure time"""
         try:
@@ -2987,6 +3051,8 @@ async def on_start(self):
         self._app.router.add_get("/api/camera/exposure", self.handle_get_camera_exposure)
         self._app.router.add_post("/api/light_source/power", self.handle_set_light_source_power)
         self._app.router.add_get("/api/light_source/power", self.handle_get_light_source_power)
+        self._app.router.add_post("/api/laser/config", self.handle_set_laser_config)
+        self._app.router.add_get("/api/laser/configs", self.handle_get_laser_configs)
         self._app.router.add_get("/api/plan_log", self.handle_get_plan_log)
         self._app.router.add_post("/session/configure", self.handle_session_configure)
 
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 4d9f5be8..625fb449 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -507,20 +507,38 @@ async def led_set(payload: dict = Body(...)):  # noqa: B008
 
     @router.post("/api/devices/laser/off", dependencies=[Depends(require_control)])
     async def laser_off():
-        """Force the 488 nm laser off.
+        """Gate ALL laser lines off via the Laser config group "ALL OFF" preset.
 
-        Confirmed signature: set_laser_power(wavelength: int, pct: float).
-        Calls set_laser_power(488, 0) to drive the 488 nm line to 0 %.
+        Uses setConfig("Laser", "ALL OFF") which drives the PLogic
+        OutputChannel to "none of outputs 5-8" — this gates every line
+        (488, 561, 405, 637) off, not just the 488 nm setpoint.
+        Required for safe brightfield live-view (spec §2.7).
         """
         client = _resolve_client()
         if client is None:
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
-            return await client.set_laser_power(488, 0)
+            return await client.set_laser_config("ALL OFF")
         except Exception as exc:
             logger.exception("Laser off command failed")
             raise HTTPException(status_code=502, detail=f"laser off failed: {exc}") from exc
 
+    @router.get("/api/devices/laser/configs")
+    async def laser_configs():
+        """Return the available Laser config-group presets from the device layer.
+
+        No require_control — read-only status route, mirrors GET status
+        routes like room_light/status and temperature/status.
+        """
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.get_laser_configs()
+        except Exception as exc:
+            logger.exception("Laser configs fetch failed")
+            raise HTTPException(status_code=502, detail=f"laser configs failed: {exc}") from exc
+
     @router.post("/api/devices/camera/led_mode", dependencies=[Depends(require_control)])
     async def camera_led_mode(payload: dict = Body(...)):  # noqa: B008
         """Enable/disable automatic LED for bottom-camera captures. Body: {"use_led": bool}."""
diff --git a/tests/test_lightsheet_client.py b/tests/test_lightsheet_client.py
index 75c0d392..cf4a9538 100644
--- a/tests/test_lightsheet_client.py
+++ b/tests/test_lightsheet_client.py
@@ -23,3 +23,40 @@ def test_stream_lightsheet_is_async_generator():
     import inspect
 
     assert inspect.isasyncgenfunction(m.stream_lightsheet)
+
+
+# ---------------------------------------------------------------------------
+# set_laser_config / get_laser_configs
+# ---------------------------------------------------------------------------
+
+async def test_set_laser_config_posts_correct_path_and_body():
+    """set_laser_config posts to /api/laser/config with {"config": <name>}."""
+    m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
+    sent = {}
+
+    async def fake_post(path, body):
+        sent["path"] = path
+        sent["body"] = body
+        return {"success": True, "config": body["config"]}
+
+    m._api_post = fake_post
+    res = await m.set_laser_config("ALL OFF")
+    assert sent["path"] == "/api/laser/config"
+    assert sent["body"] == {"config": "ALL OFF"}
+    assert res["success"] is True
+    assert res["config"] == "ALL OFF"
+
+
+async def test_get_laser_configs_gets_correct_path():
+    """get_laser_configs GETs /api/laser/configs."""
+    m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
+    fetched = {}
+
+    async def fake_get(path):
+        fetched["path"] = path
+        return {"configs": ["488 only", "ALL OFF"]}
+
+    m._api_get = fake_get
+    res = await m.get_laser_configs()
+    assert fetched["path"] == "/api/laser/configs"
+    assert res == {"configs": ["488 only", "ALL OFF"]}
diff --git a/tests/test_lightsheet_routes.py b/tests/test_lightsheet_routes.py
index ed68552f..4d3cecd9 100644
--- a/tests/test_lightsheet_routes.py
+++ b/tests/test_lightsheet_routes.py
@@ -127,16 +127,51 @@ def test_led_set_forwards():
 
 
 # ---------------------------------------------------------------------------
-# laser/off  — confirmed signature: set_laser_power(wavelength: int, pct: float)
+# laser/off  — spec §2.7: must use Laser ALL OFF config, not power setpoint
 # ---------------------------------------------------------------------------
 
-def test_laser_off_calls_set_laser_power_488_0():
-    """laser/off must call set_laser_power(488, 0) to force 488 nm line off."""
+def test_laser_off_calls_set_laser_config_all_off():
+    """laser/off must call set_laser_config("ALL OFF") to gate every line off."""
     client = MagicMock()
-    client.set_laser_power = AsyncMock(return_value={"success": True})
+    client.set_laser_config = AsyncMock(return_value={"success": True})
     r = _app(client=client).post("/api/devices/laser/off")
     assert r.status_code == 200
-    client.set_laser_power.assert_awaited_once_with(488, 0)
+    client.set_laser_config.assert_awaited_once_with("ALL OFF")
+
+
+# ---------------------------------------------------------------------------
+# laser/configs  — unguarded GET, no require_control
+# ---------------------------------------------------------------------------
+
+def test_laser_configs_forwards_to_client():
+    """GET laser/configs must forward to client.get_laser_configs."""
+    client = MagicMock()
+    client.get_laser_configs = AsyncMock(
+        return_value={"configs": ["488 only", "561 only", "ALL OFF", "ALL ON"]}
+    )
+    r = _app(client=client).get("/api/devices/laser/configs")
+    assert r.status_code == 200
+    assert r.json()["configs"] == ["488 only", "561 only", "ALL OFF", "ALL ON"]
+    client.get_laser_configs.assert_awaited_once()
+
+
+def test_laser_configs_no_require_control():
+    """GET laser/configs is unguarded — available even without control override."""
+    from fastapi import FastAPI
+    from gently.ui.web.routes.data import create_router
+
+    server = MagicMock()
+    client_mock = MagicMock()
+    client_mock.get_laser_configs = AsyncMock(return_value={"configs": ["ALL OFF"]})
+    server.agent_bridge.agent.client = client_mock
+    server.agent_bridge.agent.lightsheet_monitor = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    # Deliberately do NOT override require_control — route must not need it
+    from fastapi.testclient import TestClient
+
+    r = TestClient(app).get("/api/devices/laser/configs")
+    assert r.status_code == 200
 
 
 # ---------------------------------------------------------------------------

From 481d8bbd5770b1f147f88068c8184bad5bcb7bc1 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 28 Jun 2026 08:40:47 +0100
Subject: [PATCH 184/314] mypy: clear final cluster + remove the last overrides
 (#49)

Clears the remaining mypy errors in the last exempted modules (scripts,
dataset, benchmarks/perception, diagnostics, core/store) and removes the
entire [[tool.mypy.overrides]] block from pyproject.toml. `mypy .` is now
clean across all 297 source files with no per-module exemptions.

Notable fixes among the final 11 errors:
- explorer_server: key session_embryo_counts by (session_id, embryo_id)
  tuple instead of str
- launch_viz_server: pass the Path half of the (timestamp, Path) tuple
  returned by _discover_volumes to project_volume
- projection_explorer: declare ExplorerHandler.session_manager as a
  required class var (assigned before serving) instead of `= None`
- metrics: skip None ground-truth-stage keys in tool_use_by_stage
- auto_label_examples: annotate save_data as dict[str, Any]

Deletes three dead files that imported removed/never-existent symbols and
could not run:
- examples/example_dispim_workflows.py (AutofocusConfig/CalibrationConfig
  and dispim_* plans removed in an earlier refactor)
- tests/test_text_tool_call_extraction.py (_extract_text_tool_calls never
  existed in committed history)
- tests/validate_recursive_autofocus.py (recursive_focus_single_round
  never existed)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 benchmarks/perception/live_viewer.py     |   2 +-
 benchmarks/perception/metrics.py         |   8 +-
 benchmarks/perception/testset.py         |   7 +-
 diagnostics/benchmark_gentlystore_fps.py |   2 +-
 diagnostics/benchmark_volume_fps.py      |   4 +-
 diagnostics/plot_benchmark_results.py    |   6 +-
 diagnostics/switchbot_webgui.py          |   5 +-
 examples/example_dispim_workflows.py     | 512 -----------------------
 gently/core/store.py                     |  24 +-
 gently/dataset/aggregator.py             |  34 +-
 gently/dataset/embryo_dataset.py         |  14 +-
 gently/dataset/explorer_server.py        |  12 +-
 pyproject.toml                           |  30 --
 scripts/auto_label_examples.py           |   5 +-
 scripts/extract_stage_examples.py        |   7 +-
 scripts/gemini_stage_test.py             |  17 +-
 scripts/launch_viz_server.py             |   3 +-
 scripts/projection_explorer.py           |  17 +-
 scripts/replay_session.py                |   1 +
 scripts/stage_annotator.py               |   8 +-
 tests/test_campaign_coordination.py      |   2 +-
 tests/test_text_tool_call_extraction.py  |  76 ----
 tests/validate_recursive_autofocus.py    | 201 ---------
 23 files changed, 110 insertions(+), 887 deletions(-)
 delete mode 100644 examples/example_dispim_workflows.py
 delete mode 100644 tests/test_text_tool_call_extraction.py
 delete mode 100644 tests/validate_recursive_autofocus.py

diff --git a/benchmarks/perception/live_viewer.py b/benchmarks/perception/live_viewer.py
index 7b0f7af7..0a311786 100644
--- a/benchmarks/perception/live_viewer.py
+++ b/benchmarks/perception/live_viewer.py
@@ -46,7 +46,7 @@
     "verification_active": False,
 }
 is_paused: bool = False
-pause_event: asyncio.Event = None  # Will be initialized on startup
+pause_event: asyncio.Event | None = None  # Will be initialized on startup
 
 
 async def broadcast(message: dict):
diff --git a/benchmarks/perception/metrics.py b/benchmarks/perception/metrics.py
index f0578ea1..97d5c0f9 100644
--- a/benchmarks/perception/metrics.py
+++ b/benchmarks/perception/metrics.py
@@ -124,8 +124,8 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
     metrics.adjacent_accuracy = adjacent_correct / len(all_preds)
 
     # Per-stage accuracy
-    stage_correct = defaultdict(int)
-    stage_total = defaultdict(int)
+    stage_correct: dict = defaultdict(int)
+    stage_total: dict = defaultdict(int)
 
     for p in all_preds:
         gt = p.ground_truth_stage
@@ -138,7 +138,7 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
         metrics.stage_accuracy[stage] = stage_correct[stage] / stage_total[stage]
 
     # Confusion matrix
-    confusion = defaultdict(lambda: defaultdict(int))
+    confusion: dict = defaultdict(lambda: defaultdict(int))
     for p in all_preds:
         confusion[p.ground_truth_stage][p.predicted_stage] += 1
 
@@ -201,6 +201,8 @@ def compute_metrics(report: "BenchmarkReport") -> PerceptionMetrics:
         stage_tool_calls[p.ground_truth_stage].append(p.tool_calls)
 
     for stage, calls in stage_tool_calls.items():
+        if stage is None:
+            continue
         metrics.tool_use_by_stage[stage] = sum(calls) / len(calls)
 
     # Accuracy with vs without tools
diff --git a/benchmarks/perception/testset.py b/benchmarks/perception/testset.py
index 075eccdb..c3514ffe 100644
--- a/benchmarks/perception/testset.py
+++ b/benchmarks/perception/testset.py
@@ -10,14 +10,15 @@
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 import numpy as np
 
 from .ground_truth import GroundTruth
 
 # Lazy imports
-tifffile = None
-PIL_Image = None
+tifffile: Any = None
+PIL_Image: Any = None
 
 
 def _ensure_dependencies():
@@ -64,7 +65,7 @@ def _discover_volumes(
     )
     # Deduplicate (flat + recursive may overlap)
     tif_files = list({f.resolve(): f for f in tif_files}.values())
-    embryo_volumes = {}
+    embryo_volumes: dict = {}
 
     for f in tif_files:
         parts = f.stem.split("_")
diff --git a/diagnostics/benchmark_gentlystore_fps.py b/diagnostics/benchmark_gentlystore_fps.py
index 3e8188a7..2621e2bb 100644
--- a/diagnostics/benchmark_gentlystore_fps.py
+++ b/diagnostics/benchmark_gentlystore_fps.py
@@ -487,7 +487,7 @@ def print_overhead_analysis(results: list[BenchmarkResult]):
     """Print overhead analysis comparing FileStore to raw TIFF."""
     from collections import defaultdict
 
-    groups = defaultdict(dict)
+    groups: dict = defaultdict(dict)
     for r in results:
         groups[r.num_slices][r.approach] = r
 
diff --git a/diagnostics/benchmark_volume_fps.py b/diagnostics/benchmark_volume_fps.py
index 381e3697..9c070c88 100644
--- a/diagnostics/benchmark_volume_fps.py
+++ b/diagnostics/benchmark_volume_fps.py
@@ -281,7 +281,7 @@ def acquire_volume_raw(
     t0 = time.perf_counter()
     core.setProperty(GALVO_DEVICE, "SPIMState", "Running")
 
-    images = [] if save_dir else None
+    images: list | None = [] if save_dir else None
     count = 0
     timeout_s = max(num_slices * 0.05 * 2, 10.0)  # generous timeout
     t_start = time.time()
@@ -1010,7 +1010,7 @@ def print_summary(results: list[BenchmarkResult]):
     """Print overhead analysis comparing ophyd and ophyd_burst vs raw."""
     from collections import defaultdict
 
-    groups = defaultdict(dict)
+    groups: dict = defaultdict(dict)
     for r in results:
         groups[(r.num_slices, r.exposure_ms)][r.approach] = r
 
diff --git a/diagnostics/plot_benchmark_results.py b/diagnostics/plot_benchmark_results.py
index c3b5cdf1..d4a8a16f 100644
--- a/diagnostics/plot_benchmark_results.py
+++ b/diagnostics/plot_benchmark_results.py
@@ -98,7 +98,7 @@ def plot_throughput(data: dict, output_dir: Path):
             approaches.append(r["approach"])
 
     # Build matrix
-    vps = defaultdict(dict)
+    vps: dict = defaultdict(dict)
     for r in summary:
         if r["vol_per_sec"] is not None:
             vps[r["slices"]][r["approach"]] = r["vol_per_sec"]
@@ -191,7 +191,7 @@ def plot_overhead(data: dict, output_dir: Path):
         "reconfig_wfd": "Reconfig (waitForDevice)",
     }
 
-    overhead = defaultdict(dict)
+    overhead: dict = defaultdict(dict)
     for r in summary:
         if r["approach"] in compare and r["mean_s"] is not None:
             s = r["slices"]
@@ -253,7 +253,7 @@ def plot_wfd_savings(data: dict, output_dir: Path):
     summary = data["summary"]
 
     slices_set = sorted(set(r["slices"] for r in summary))
-    means = defaultdict(dict)
+    means: dict = defaultdict(dict)
     raw_means = {}
     for r in summary:
         if r["mean_s"] is not None:
diff --git a/diagnostics/switchbot_webgui.py b/diagnostics/switchbot_webgui.py
index 5df81015..f139b97c 100644
--- a/diagnostics/switchbot_webgui.py
+++ b/diagnostics/switchbot_webgui.py
@@ -27,6 +27,7 @@
 import asyncio
 import logging
 from contextlib import asynccontextmanager
+from typing import Any
 
 import uvicorn
 from fastapi import FastAPI
@@ -86,7 +87,7 @@ class Bot:
 
     def __init__(self, address: str):
         self.address = address
-        self._client = None
+        self._client: Any = None
         self._lock = asyncio.Lock()
         self._morse_task: asyncio.Task | None = None
         self.state = "unknown"
@@ -181,7 +182,7 @@ async def disconnect(self):
             await self._client.disconnect()
 
 
-BOT: Bot | None = None
+BOT: Any = None
 
 
 @asynccontextmanager
diff --git a/examples/example_dispim_workflows.py b/examples/example_dispim_workflows.py
deleted file mode 100644
index e81e7574..00000000
--- a/examples/example_dispim_workflows.py
+++ /dev/null
@@ -1,512 +0,0 @@
-#!/usr/bin/env python
-"""
-Gently DiSPIM Workflow Examples
-==============================
-
-Demonstrates the complete DiSPIM functionality using device-agnostic Bluesky plans.
-Shows the progression from atomic plans to complex workflows for real DiSPIM experiments.
-
-This example shows:
-1. Device-agnostic atomic plans (focus_sweep)
-2. Autofocus functionality for precise positioning
-3. Two-point calibration for coordinate mapping
-4. Embryo detection with bottom camera
-5. Complete multi-embryo acquisition workflows
-
-All plans work with proper Ophyd devices and standard Bluesky plan stubs.
-"""
-
-import logging
-
-import numpy as np
-from bluesky import RunEngine
-from bluesky.callbacks import LiveTable
-
-# Import gently components
-from gently import (
-    # Configuration
-    AutofocusConfig,
-    CalibrationConfig,
-    FitFunction,
-    # Analysis utilities
-    FocusAlgorithm,  # Complete workflow
-)
-
-# Import optional napari visualization
-try:
-    import napari  # noqa: F401
-
-    NAPARI_AVAILABLE = True
-except ImportError:
-    NAPARI_AVAILABLE = False
-
-
-def setup_dispim_session():
-    """
-    Setup DiSPIM session with devices and RunEngine
-
-    In practice, this would use actual MM installation paths:
-    system = create_dispim_system("/path/to/micromanager", "/path/to/config.cfg")
-    """
-    print("Setting up DiSPIM session...")
-
-    # Create RunEngine
-    RE = RunEngine({})
-
-    # For demonstration, create a mock system
-    # In practice: system = create_dispim_system(mm_dir, config_file)
-    print("  [Note: Using mock system for demonstration]")
-    print("  [In practice: system = create_dispim_system(mm_dir, config_file)]")
-    system = None  # Would be actual DiSPIMSystem
-
-    # Setup live callbacks
-    live_table = LiveTable(["piezo_a_position", "galvo_a_position", "camera_a_image"])
-    RE.subscribe(live_table)
-
-    return RE, system
-
-
-def setup_napari_visualization(RE):
-    """Setup optional napari visualization for real-time image display"""
-    print("\n" + "=" * 60)
-    print("OPTIONAL: NAPARI VISUALIZATION SETUP")
-    print("=" * 60)
-
-    if not NAPARI_AVAILABLE:
-        print("\n⚠ Napari not available - skipping visualization setup")
-        print("  To enable real-time image visualization:")
-        print("    pip install napari[all]")
-        print("  Then restart and run this example again.")
-        return None
-
-    print("\n✅ Napari available - setting up real-time visualization")
-
-    # Setup napari callback for all DiSPIM experiments
-    napari_callback = enable_full_visualization(RE)  # noqa: F821
-
-    if napari_callback.enabled:
-        print("  ✅ Napari callback enabled and subscribed to RunEngine")
-        print("  ✅ Real-time image display will show:")
-        print("    - Focus sweep image stacks (3D)")
-        print("    - Embryo detection scan images")
-        print("    - Dual-channel DiSPIM data (green/magenta)")
-        print("    - Individual camera acquisitions")
-
-        print(f"\n  Napari viewer: '{napari_callback.viewer.title}'")
-        print(f"  - Focus sweeps: {napari_callback.show_focus_sweeps}")
-        print(f"  - Embryo detection: {napari_callback.show_embryo_detection}")
-        print(f"  - Dual channels: {napari_callback.dual_channel_mode}")
-
-        print("\n  💡 The napari window is now open - you can:")
-        print("    - Adjust layer visibility and colors")
-        print("    - Explore 3D image stacks")
-        print("    - Take screenshots and export movies")
-        print("    - View images in real-time during experiments")
-
-    else:
-        print("  ❌ Napari callback failed to initialize")
-        return None
-
-    return napari_callback
-
-
-def demonstrate_atomic_plans(RE, light_sheet):
-    """Demonstrate device-agnostic atomic plans"""
-    print("\n" + "=" * 60)
-    print("1. ATOMIC PLANS - Device-Agnostic Building Blocks")
-    print("=" * 60)
-
-    print("\nThe foundation: focus_sweep(positioner, positions, detector)")
-    print("This atomic plan works with ANY positioner and detector:")
-
-    # Define scan positions
-    positions = np.linspace(-10, 10, 11)  # 11 positions from -10 to +10 μm
-
-    print(f"\n  Positions to scan: {positions}")
-    print(f"  Number of positions: {len(positions)}")
-
-    if light_sheet is not None:
-        # Example 1: Piezo focus sweep
-        print("\n  Example 1: Piezo focus sweep")
-        print("    focus_sweep(light_sheet.piezo, positions, light_sheet.camera)")
-        # RE(focus_sweep(light_sheet.piezo, positions, light_sheet.camera))
-
-        # Example 2: Galvo focus sweep
-        print("\n  Example 2: Galvo focus sweep")
-        print("    focus_sweep(light_sheet.galvo, positions, light_sheet.camera)")
-        # RE(focus_sweep(light_sheet.galvo, positions, light_sheet.camera))
-
-        # Example 3: XY stage sweep (device-agnostic)
-        print("\n  Example 3: XY stage sweep (device-agnostic!)")
-        print("    focus_sweep(xy_stage.x, positions, light_sheet.camera)")
-        # RE(focus_sweep(xy_stage.x, positions, light_sheet.camera))
-    else:
-        print("    [Would execute: RE(focus_sweep(device, positions, detector))]")
-
-    print("\nKey insight: Same atomic plan, different devices!")
-    print("This is the power of device-agnostic Bluesky plans.")
-
-
-def demonstrate_autofocus_functionality(RE, light_sheet):
-    """Demonstrate autofocus functionality for precise positioning"""
-    print("\n" + "=" * 60)
-    print("2. AUTOFOCUS FUNCTIONALITY - Precise Device Positioning")
-    print("=" * 60)
-
-    print("\nAutofocus builds on the atomic focus_sweep plan:")
-    print("dispim_piezo_autofocus() = focus_sweep() + analysis + validation")
-
-    # Create autofocus configuration
-    config = AutofocusConfig(
-        num_positions=21,
-        step_size_um=0.5,
-        algorithm=FocusAlgorithm.VOLATH.value,
-        fit_function=FitFunction.GAUSSIAN.value,
-        minimum_r_squared=0.75,
-        center_at_current=True,
-    )
-
-    print("\nAutofocus Configuration:")
-    print(f"  Positions: {config.num_positions}")
-    print(f"  Step size: {config.step_size_um} μm")
-    print(f"  Algorithm: {config.algorithm}")
-    print(f"  Fit function: {config.fit_function}")
-    print(f"  Min R²: {config.minimum_r_squared}")
-
-    if light_sheet is not None:
-        print("\nExecuting autofocus:")
-        print("  RE(dispim_piezo_autofocus(light_sheet, config))")
-        # RE(dispim_piezo_autofocus(light_sheet, config))
-
-        if NAPARI_AVAILABLE:
-            print("\n  📺 With napari visualization:")
-            print("    - Images stream to napari in real-time")
-            print("    - 3D focus stack builds as positions are scanned")
-            print("    - Can see focus quality at each position")
-            print("    - Visual feedback on autofocus progress")
-    else:
-        print("\n[Would execute: RE(dispim_piezo_autofocus(light_sheet, config))]")
-
-    print("\nAutofocus workflow:")
-    print("  1. bps.stage(light_sheet)      # Save current state")
-    print("  2. focus_sweep(piezo, positions, camera)  # Atomic plan")
-    print("  3. analyze_focus_stack(positions, images) # Find best position")
-    print("  4. bps.mv(piezo, best_position) # Move to focus")
-    print("  5. bps.unstage(light_sheet)     # Restore if failed")
-
-    print("\nThis enables precise, automated positioning for experiments!")
-
-
-def demonstrate_calibration_workflow(RE, light_sheet):
-    """Demonstrate calibration workflows for coordinate mapping"""
-    print("\n" + "=" * 60)
-    print("3. CALIBRATION WORKFLOW - Coordinate System Mapping")
-    print("=" * 60)
-
-    print("\nTwo-point calibration uses autofocus at each calibration point:")
-    print("dispim_two_point_calibration() = move + autofocus + move + autofocus + fit")
-
-    # Create calibration configuration
-    autofocus_config = AutofocusConfig(
-        num_positions=11,  # Faster for calibration
-        step_size_um=1.0,
-        algorithm=FocusAlgorithm.VOLATH.value,
-    )
-
-    cal_config = CalibrationConfig(
-        point1_um=25.0,
-        point2_um=75.0,
-        autofocus_each_point=True,
-        autofocus_config=autofocus_config,
-    )
-
-    print("\nCalibration Configuration:")
-    print(f"  Point 1: {cal_config.point1_um} μm")
-    print(f"  Point 2: {cal_config.point2_um} μm")
-    print(f"  Autofocus at each point: {cal_config.autofocus_each_point}")
-
-    if light_sheet is not None:
-        print("\nExecuting calibration:")
-        print("  RE(dispim_two_point_calibration(light_sheet, cal_config))")
-        # RE(dispim_two_point_calibration(light_sheet, cal_config))
-    else:
-        print("\n[Would execute: RE(dispim_two_point_calibration(light_sheet, cal_config))]")
-
-    print("\nCalibration workflow:")
-    print("  1. bps.mv(piezo, point1)        # Move to first point")
-    print("  2. dispim_galvo_autofocus()     # Focus galvo (uses atomic plans)")
-    print("  3. bps.trigger_and_read([...])  # Record positions")
-    print("  4. bps.mv(piezo, point2)        # Move to second point")
-    print("  5. dispim_galvo_autofocus()     # Focus galvo again")
-    print("  6. bps.trigger_and_read([...])  # Record positions")
-    print("  7. calculate_linear_fit()       # Determine calibration")
-
-    print("\nCalibration enables coordinate transformations between devices!")
-
-
-def demonstrate_embryo_detection_workflow(RE, dispim_system):
-    """Demonstrate embryo detection with bottom camera"""
-    print("\n" + "=" * 60)
-    print("4. EMBRYO DETECTION WORKFLOW - Automated Sample Finding")
-    print("=" * 60)
-
-    print("\nEmbryo detection uses bottom camera for automated sample finding:")
-    print("find_embryos_with_bottom_camera() = XY scan + image analysis + position recording")
-
-    # Create detection configuration
-    detection_config = {
-        "scan_area": {
-            "x_start": -1000,
-            "x_stop": 1000,  # μm
-            "y_start": -1000,
-            "y_stop": 1000,  # μm
-            "step_size": 200,  # μm between positions
-        },
-        "detection": {
-            "min_size_pixels": 50,
-            "max_size_pixels": 500,
-            "brightness_threshold": 0.3,
-            "circularity_threshold": 0.7,
-        },
-        "safety": {
-            "z_position_um": 0.0,  # Safe Z position during XY scan
-            "max_scan_time_minutes": 10,
-        },
-    }
-
-    print("\nDetection Configuration:")
-    print(
-        f"  Scan area: {detection_config['scan_area']['x_start']} to"
-        f" {detection_config['scan_area']['x_stop']} μm (X)"
-    )
-    print(
-        f"             {detection_config['scan_area']['y_start']} to"
-        f" {detection_config['scan_area']['y_stop']} μm (Y)"
-    )
-    print(f"  Step size: {detection_config['scan_area']['step_size']} μm")
-    print(
-        f"  Detection thresholds: size"
-        f" {detection_config['detection']['min_size_pixels']}"
-        f"-{detection_config['detection']['max_size_pixels']} pixels"
-    )
-
-    if dispim_system is not None:
-        print("\nExecuting embryo detection:")
-        print("  RE(find_embryos_with_bottom_camera(dispim_system, detection_config))")
-        # RE(find_embryos_with_bottom_camera(dispim_system, detection_config))
-
-        if NAPARI_AVAILABLE:
-            print("\n  📺 With napari visualization:")
-            print("    - Each XY position shows in napari as it's acquired")
-            print("    - See scan progress across the sample area")
-            print("    - Detected embryos can be highlighted in real-time")
-            print("    - Build up a mosaic view of the scanned region")
-    else:
-        print(
-            "\n[Would execute:"
-            " RE(find_embryos_with_bottom_camera(dispim_system, detection_config))]"
-        )
-
-    print("\nDetection workflow:")
-    print("  1. bps.mv(xy_stage.z, safe_z_position)    # Move to safe Z")
-    print("  2. XY grid scan with bottom camera        # Scan entire area")
-    print("  3. Analyze images for embryo features     # Find circular objects")
-    print("  4. Record embryo positions in stage coords # Store locations")
-    print("  5. Convert to light sheet coordinates     # Transform coords")
-
-    print("\nAutomated detection finds all samples for batch processing!")
-
-
-def demonstrate_complete_workflow(RE, dispim_system):
-    """Demonstrate complete multi-embryo acquisition workflow"""
-    print("\n" + "=" * 60)
-    print("5. COMPLETE WORKFLOW - Multi-Embryo Light Sheet Acquisition")
-    print("=" * 60)
-
-    print("\nThe complete workflow combines all components:")
-    print("full_dispim_workflow() = calibration + embryo_detection + acquisition")
-
-    # Create complete workflow configuration
-    workflow_config = {
-        "system_setup": {
-            "center_devices": True,
-            "run_calibration": True,
-            "validate_hardware": True,
-        },
-        "calibration": {
-            "point1_um": 25.0,
-            "point2_um": 75.0,
-            "autofocus_each_point": True,
-            "autofocus_config": {
-                "num_positions": 11,
-                "step_size_um": 1.0,
-                "algorithm": "volath",
-            },
-        },
-        "embryo_detection": {
-            "x_start": -1000,
-            "x_stop": 1000,
-            "y_start": -1000,
-            "y_stop": 1000,
-            "step_size": 200,
-            "detection_thresholds": {
-                "min_size": 50,
-                "max_size": 500,
-                "brightness": 0.3,
-                "circularity": 0.7,
-            },
-        },
-        "acquisition": {
-            "autofocus_config": {
-                "num_positions": 21,
-                "step_size_um": 0.5,
-                "algorithm": "volath",
-            },
-            "z_stack": {
-                "range_um": 50,  # ±25 μm around focus
-                "step_size_um": 1.0,
-            },
-            "dual_sided": True,
-            "time_points": 1,
-        },
-    }
-
-    print("\nWorkflow Configuration:")
-    print(
-        f"  Calibration: {workflow_config['calibration']['point1_um']} to"
-        f" {workflow_config['calibration']['point2_um']} μm"
-    )
-    print(
-        f"  Detection area: {workflow_config['embryo_detection']['x_start']} to"
-        f" {workflow_config['embryo_detection']['x_stop']} μm"
-    )
-    print(f"  Z-stack range: ±{workflow_config['acquisition']['z_stack']['range_um'] // 2} μm")
-    print(f"  Dual-sided: {workflow_config['acquisition']['dual_sided']}")
-
-    if dispim_system is not None:
-        print("\nExecuting complete workflow:")
-        print("  RE(full_dispim_workflow(dispim_system, workflow_config))")
-        # RE(full_dispim_workflow(dispim_system, workflow_config))
-    else:
-        print("\n[Would execute: RE(full_dispim_workflow(dispim_system, workflow_config))]")
-
-    print("\nComplete workflow stages:")
-    print("  1. System initialization and hardware validation")
-    print("  2. Two-point calibration (with autofocus)")
-    print("  3. Embryo detection with bottom camera")
-    print("  4. For each detected embryo:")
-    print("     a. Move to embryo position")
-    print("     b. Autofocus both sides")
-    print("     c. Acquire dual-sided Z-stack")
-    print("     d. Save data with metadata")
-
-    print("\nAutomated, high-throughput DiSPIM experiments!")
-
-
-def demonstrate_extensibility(RE):
-    """Demonstrate how the atomic approach enables easy extension"""
-    print("\n" + "=" * 60)
-    print("6. EXTENSIBILITY - Easy Addition of New Capabilities")
-    print("=" * 60)
-
-    print("\nBecause plans are device-agnostic, new capabilities are easy:")
-
-    print("\nNew hardware? Same plans work:")
-    print("  focus_sweep(new_positioner, positions, new_detector)")
-    print("  dispim_piezo_autofocus(new_light_sheet, config)")
-
-    print("\nNew algorithms? Just swap the analysis:")
-    print("  config.algorithm = 'new_algorithm'")
-    print("  Same dispim_piezo_autofocus() plan!")
-
-    print("\nNew workflows? Compose existing plans:")
-    print("  def adaptive_autofocus_with_ai(light_sheet, ai_callback):")
-    print("    yield from dispim_piezo_autofocus(light_sheet, config)")
-    print("    decision = ai_callback(result)")
-    print("    if decision.refine:")
-    print("      yield from dispim_galvo_autofocus(light_sheet, refined_config)")
-
-    print("\nIntegration with other systems:")
-    print("  def combined_microscopy_workflow(dispim, confocal, shared_stage):")
-    print("    yield from focus_sweep(shared_stage.z, positions, dispim.camera)")
-    print("    yield from focus_sweep(shared_stage.z, positions, confocal.camera)")
-    print("    # Same atomic plan, different systems!")
-
-    print("\nThe atomic approach scales naturally!")
-
-
-def main():
-    """Main demonstration of DiSPIM workflow functionality"""
-    print("Gently DiSPIM Workflow Examples")
-    print("=" * 60)
-    print()
-    print("This example demonstrates complete DiSPIM functionality using")
-    print("device-agnostic Bluesky plans for real microscopy experiments.")
-    print()
-    print("Key concepts:")
-    print("  - Atomic plans work with ANY compatible devices")
-    print("  - Autofocus enables precise positioning")
-    print("  - Complex workflows compose atomic plans")
-    print("  - Easy extensibility through device agnosticism")
-
-    # Setup session
-    RE, system = setup_dispim_session()
-    light_sheet = getattr(system, "side_a", None) if system else None
-
-    # Setup optional napari visualization
-    setup_napari_visualization(RE)
-
-    # Run demonstrations
-    demonstrate_atomic_plans(RE, light_sheet)
-    demonstrate_autofocus_functionality(RE, light_sheet)
-    demonstrate_calibration_workflow(RE, light_sheet)
-    demonstrate_embryo_detection_workflow(RE, system)
-    demonstrate_complete_workflow(RE, system)
-    demonstrate_extensibility(RE)
-
-    # Summary
-    print("\n" + "=" * 60)
-    print("SUMMARY - Complete DiSPIM Functionality")
-    print("=" * 60)
-
-    print("\n✓ Created proper Ophyd devices (DiSPIMPiezo, DiSPIMCamera, etc.)")
-    print("✓ Built device-agnostic atomic plans (focus_sweep, move_and_acquire)")
-    print("✓ Implemented autofocus for precise positioning")
-    print("✓ Added calibration workflows for coordinate mapping")
-    print("✓ Created embryo detection for automated sample finding")
-    print("✓ Integrated complete multi-embryo acquisition workflows")
-    if NAPARI_AVAILABLE:
-        print("✓ Enabled real-time image visualization with napari")
-
-    print("\nKey benefits:")
-    print("  1. Device-agnostic - plans work with any compatible hardware")
-    print("  2. Composable - atomic plans build into complex workflows")
-    print("  3. Extensible - easy to add new capabilities")
-    print("  4. Reliable - proper Bluesky integration with error handling")
-
-    print("\nNext steps:")
-    print("  1. Test with real DiSPIM hardware using safety protocols")
-    if not NAPARI_AVAILABLE:
-        print("  2. Install napari for real-time visualization: pip install napari[all]")
-        print("  3. Add image analysis for embryo detection")
-        print("  4. Integrate with VLM for intelligent workflows")
-        print("  5. Extend to other microscopy systems")
-    else:
-        print("  2. Add image analysis for embryo detection")
-        print("  3. Integrate with VLM for intelligent workflows")
-        print("  4. Extend to other microscopy systems")
-
-    print("\nThe transformation is complete:")
-    print("  635-line Java monolith → Composable Bluesky atomic plans")
-    print("  Device-specific code → Device-agnostic interfaces")
-    print("  Rigid workflows → Flexible, extensible compositions")
-
-    print("\nGently DiSPIM: Where atomic plans meet experimental flexibility! 🔬")
-
-
-if __name__ == "__main__":
-    # Setup logging
-    logging.basicConfig(level=logging.INFO)
-
-    # Run demonstration
-    main()
diff --git a/gently/core/store.py b/gently/core/store.py
index 6a60a202..8060c484 100644
--- a/gently/core/store.py
+++ b/gently/core/store.py
@@ -36,7 +36,7 @@
 from contextlib import contextmanager
 from datetime import datetime
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import numpy as np
 
@@ -311,7 +311,7 @@ def get_session(self, session_id: str) -> SessionInfo | None:
             return None
         d = dict(row)
         self._parse_json_field(d, "metadata")
-        return d
+        return d  # type: ignore[return-value]  # dict matches TypedDict shape
 
     def list_sessions(self) -> list[SessionInfo]:
         """Return all sessions ordered by last_active descending."""
@@ -321,7 +321,7 @@ def list_sessions(self) -> list[SessionInfo]:
             d = dict(row)
             self._parse_json_field(d, "metadata")
             result.append(d)
-        return result
+        return result  # type: ignore[return-value]  # dict matches TypedDict shape
 
     def touch_session(self, session_id: str):
         """Update last_active timestamp."""
@@ -397,7 +397,7 @@ def get_embryo(self, session_id: str, embryo_id: str) -> EmbryoInfo | None:
             return None
         d = dict(row)
         self._parse_json_field(d, "calibration")
-        return d
+        return d  # type: ignore[return-value]  # dict matches TypedDict shape
 
     def list_embryos(self, session_id: str) -> list[EmbryoInfo]:
         rows = self._conn.execute(
@@ -409,7 +409,7 @@ def list_embryos(self, session_id: str) -> list[EmbryoInfo]:
             d = dict(row)
             self._parse_json_field(d, "calibration")
             result.append(d)
-        return result
+        return result  # type: ignore[return-value]  # dict matches TypedDict shape
 
     # ==================================================================
     # Volumes
@@ -726,7 +726,7 @@ def list_volumes(self, session_id: str, embryo_id: str | None = None) -> list[Vo
             if d.get("metadata"):
                 d["metadata"] = json.loads(d["metadata"])
             result.append(d)
-        return result
+        return result  # type: ignore[return-value]  # dict matches TypedDict shape
 
     def get_acquisition_params(self, session_id: str, embryo_id: str | None = None) -> dict | None:
         """
@@ -876,7 +876,7 @@ def list_projections(self, session_id: str, embryo_id: str) -> list[ProjectionIn
             "SELECT * FROM projections WHERE session_id = ? AND embryo_id = ? ORDER BY timepoint",
             (session_id, embryo_id),
         ).fetchall()
-        return [dict(r) for r in rows]
+        return [dict(r) for r in rows]  # type: ignore[misc]  # dict matches TypedDict shape
 
     # ==================================================================
     # Perception Runs & Predictions
@@ -911,7 +911,7 @@ def create_perception_run(
                     now,
                 ),
             )
-            return cursor.lastrowid
+            return cast("int", cursor.lastrowid)
 
     def store_prediction(
         self,
@@ -978,7 +978,7 @@ def store_prediction(
                     now,
                 ),
             )
-            return cursor.lastrowid
+            return cast("int", cursor.lastrowid)
 
     def complete_perception_run(
         self, run_id: int, status: str = "completed", error_message: str | None = None
@@ -1021,7 +1021,7 @@ def get_predictions(
             if d.get("observed_features"):
                 d["observed_features"] = json.loads(d["observed_features"])
             result.append(d)
-        return result
+        return result  # type: ignore[return-value]  # dict matches TypedDict shape
 
     # ==================================================================
     # Ground Truth
@@ -1066,7 +1066,7 @@ def get_ground_truth(self, session_id: str, embryo_id: str) -> list[GroundTruthE
             "WHERE session_id = ? AND embryo_id = ? ORDER BY start_timepoint",
             (session_id, embryo_id),
         ).fetchall()
-        return [dict(r) for r in rows]
+        return [dict(r) for r in rows]  # type: ignore[misc]  # dict matches TypedDict shape
 
     # ==================================================================
     # Utility
@@ -1098,7 +1098,7 @@ def stats(self) -> StoreStats:
 
         counts["disk_usage_mb"] = round(total_bytes / (1024 * 1024), 1)
         counts["db_size_mb"] = round(self._db_path.stat().st_size / (1024 * 1024), 2)
-        return counts
+        return counts  # type: ignore[return-value]  # dict matches TypedDict shape
 
     @property
     def db_path(self) -> Path:
diff --git a/gently/dataset/aggregator.py b/gently/dataset/aggregator.py
index c48a99c3..37105afb 100644
--- a/gently/dataset/aggregator.py
+++ b/gently/dataset/aggregator.py
@@ -13,7 +13,7 @@
 import sqlite3
 from datetime import datetime
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 from .schema import init_database
 
@@ -197,6 +197,7 @@ def _process_session(self, data: dict[str, Any]) -> str:
             return "skipped"
 
         # Check if exists
+        assert self.conn is not None
         existing = self.conn.execute(
             "SELECT session_id FROM sessions WHERE session_id = ?", (session_id,)
         ).fetchone()
@@ -220,6 +221,7 @@ def _process_session(self, data: dict[str, Any]) -> str:
         }
 
         if existing:
+            assert self.conn is not None
             self.conn.execute(
                 """
                 UPDATE sessions SET
@@ -236,6 +238,7 @@ def _process_session(self, data: dict[str, Any]) -> str:
             )
             result = "updated"
         else:
+            assert self.conn is not None
             self.conn.execute(
                 """
                 INSERT INTO sessions
@@ -260,6 +263,7 @@ def _process_session(self, data: dict[str, Any]) -> str:
         for embryo_id, embryo_data in embryos.items():
             self._process_embryo(session_id, embryo_id, embryo_data)
 
+        assert self.conn is not None
         self.conn.commit()
         return result
 
@@ -271,6 +275,7 @@ def _process_embryo(self, session_id: str, embryo_id: str, data: dict[str, Any])
         # Get UID from data, or generate backward-compatible UID
         embryo_uid = data.get("uid") or f"{session_id}_{embryo_id}"
 
+        assert self.conn is not None
         self.conn.execute(
             """
             INSERT OR REPLACE INTO embryos
@@ -331,6 +336,7 @@ def aggregate_volumes(self, since: datetime | None = None) -> dict[str, int]:
                             logger.error(f"Error processing volume {meta_file}: {e}")
                             stats["skipped"] += 1
 
+                assert self.conn is not None
                 self.conn.commit()
                 self._complete_aggregation_log(
                     log_id, stats["added"] + stats["skipped"], stats["added"], 0
@@ -363,6 +369,7 @@ def aggregate_volumes(self, since: datetime | None = None) -> dict[str, int]:
                         logger.error(f"Error processing TIFF {tif_file}: {e}")
                         stats["skipped"] += 1
 
+            assert self.conn is not None
             self.conn.commit()
 
         return stats
@@ -378,6 +385,7 @@ def _process_volume(self, data: dict[str, Any], meta_file: Path) -> bool:
             return False
 
         # Check if exists
+        assert self.conn is not None
         existing = self.conn.execute("SELECT uid FROM volumes WHERE uid = ?", (uid,)).fetchone()
         if existing:
             return False
@@ -394,12 +402,14 @@ def _process_volume(self, data: dict[str, Any], meta_file: Path) -> bool:
         # Look up embryo_uid from embryos table, or generate backward-compatible UID
         embryo_uid = None
         if session_id and embryo_id:
+            assert self.conn is not None
             result = self.conn.execute(
                 "SELECT embryo_uid FROM embryos WHERE session_id = ? AND embryo_id = ?",
                 (session_id, embryo_id),
             ).fetchone()
             embryo_uid = result[0] if result else f"{session_id}_{embryo_id}"
 
+        assert self.conn is not None
         self.conn.execute(
             """
             INSERT INTO volumes
@@ -433,6 +443,7 @@ def _process_volume_from_tiff(self, tif_path: Path, session_id: str) -> bool:
         uid = f"tiff_{tif_path.stem}"
 
         # Check if exists
+        assert self.conn is not None
         existing = self.conn.execute("SELECT uid FROM volumes WHERE uid = ?", (uid,)).fetchone()
         if existing:
             return False
@@ -463,12 +474,14 @@ def _process_volume_from_tiff(self, tif_path: Path, session_id: str) -> bool:
         # Look up embryo_uid from embryos table, or generate backward-compatible UID
         embryo_uid = None
         if session_id and embryo_id:
+            assert self.conn is not None
             result = self.conn.execute(
                 "SELECT embryo_uid FROM embryos WHERE session_id = ? AND embryo_id = ?",
                 (session_id, embryo_id),
             ).fetchone()
             embryo_uid = result[0] if result else f"{session_id}_{embryo_id}"
 
+        assert self.conn is not None
         self.conn.execute(
             """
             INSERT INTO volumes
@@ -530,6 +543,7 @@ def aggregate_images(self, since: datetime | None = None) -> dict[str, int]:
                         logger.error(f"Error processing image {meta_file}: {e}")
                         stats["skipped"] += 1
 
+            assert self.conn is not None
             self.conn.commit()
             self._complete_aggregation_log(
                 log_id, stats["added"] + stats["skipped"], stats["added"], 0
@@ -552,6 +566,7 @@ def _process_image(self, data: dict[str, Any]) -> bool:
             return False
 
         # Check if exists
+        assert self.conn is not None
         existing = self.conn.execute("SELECT uid FROM images WHERE uid = ?", (uid,)).fetchone()
         if existing:
             return False
@@ -563,12 +578,14 @@ def _process_image(self, data: dict[str, Any]) -> bool:
         # Look up embryo_uid from embryos table, or generate backward-compatible UID
         embryo_uid = None
         if session_id and embryo_id:
+            assert self.conn is not None
             result = self.conn.execute(
                 "SELECT embryo_uid FROM embryos WHERE session_id = ? AND embryo_id = ?",
                 (session_id, embryo_id),
             ).fetchone()
             embryo_uid = result[0] if result else f"{session_id}_{embryo_id}"
 
+        assert self.conn is not None
         self.conn.execute(
             """
             INSERT INTO images
@@ -634,6 +651,7 @@ def aggregate_ground_truth(self) -> dict[str, int]:
                     for embryo_id, stages in transitions.items():
                         for stage, start_timepoint in stages.items():
                             # Check if exists
+                            assert self.conn is not None
                             existing = self.conn.execute(
                                 """
                                 SELECT id FROM ground_truth
@@ -643,6 +661,7 @@ def aggregate_ground_truth(self) -> dict[str, int]:
                             ).fetchone()
 
                             if existing:
+                                assert self.conn is not None
                                 self.conn.execute(
                                     """
                                     UPDATE ground_truth SET
@@ -653,6 +672,7 @@ def aggregate_ground_truth(self) -> dict[str, int]:
                                 )
                                 stats["updated"] += 1
                             else:
+                                assert self.conn is not None
                                 self.conn.execute(
                                     """
                                     INSERT INTO ground_truth
@@ -674,6 +694,7 @@ def aggregate_ground_truth(self) -> dict[str, int]:
                 except Exception as e:
                     logger.error(f"Error processing ground truth {gt_file}: {e}")
 
+            assert self.conn is not None
             self.conn.commit()
             self._complete_aggregation_log(
                 log_id,
@@ -690,6 +711,7 @@ def aggregate_ground_truth(self) -> dict[str, int]:
 
     def _get_last_run_time(self) -> datetime | None:
         """Get the timestamp of the last successful aggregation."""
+        assert self.conn is not None
         result = self.conn.execute("""
             SELECT MAX(completed_at) FROM aggregation_log
             WHERE status = 'completed'
@@ -701,6 +723,7 @@ def _get_last_run_time(self) -> datetime | None:
 
     def _set_last_run_time(self, timestamp: datetime):
         """Record the current aggregation time."""
+        assert self.conn is not None
         self.conn.execute(
             """
             INSERT OR REPLACE INTO metadata (key, value, updated_at)
@@ -708,10 +731,12 @@ def _set_last_run_time(self, timestamp: datetime):
         """,
             (timestamp.isoformat(), timestamp.isoformat()),
         )
+        assert self.conn is not None
         self.conn.commit()
 
     def _start_aggregation_log(self, source_type: str, source_path: str) -> int:
         """Start a new aggregation log entry."""
+        assert self.conn is not None
         cursor = self.conn.execute(
             """
             INSERT INTO aggregation_log (source_type, source_path, started_at, status)
@@ -719,11 +744,13 @@ def _start_aggregation_log(self, source_type: str, source_path: str) -> int:
         """,
             (source_type, source_path, datetime.now().isoformat()),
         )
+        assert self.conn is not None
         self.conn.commit()
-        return cursor.lastrowid
+        return cast("int", cursor.lastrowid)
 
     def _complete_aggregation_log(self, log_id: int, processed: int, added: int, updated: int):
         """Mark an aggregation log as completed."""
+        assert self.conn is not None
         self.conn.execute(
             """
             UPDATE aggregation_log SET
@@ -733,10 +760,12 @@ def _complete_aggregation_log(self, log_id: int, processed: int, added: int, upd
         """,
             (processed, added, updated, datetime.now().isoformat(), log_id),
         )
+        assert self.conn is not None
         self.conn.commit()
 
     def _fail_aggregation_log(self, log_id: int, error_message: str):
         """Mark an aggregation log as failed."""
+        assert self.conn is not None
         self.conn.execute(
             """
             UPDATE aggregation_log SET
@@ -745,6 +774,7 @@ def _fail_aggregation_log(self, log_id: int, error_message: str):
         """,
             (datetime.now().isoformat(), error_message, log_id),
         )
+        assert self.conn is not None
         self.conn.commit()
 
 
diff --git a/gently/dataset/embryo_dataset.py b/gently/dataset/embryo_dataset.py
index b6cd3a66..48828692 100644
--- a/gently/dataset/embryo_dataset.py
+++ b/gently/dataset/embryo_dataset.py
@@ -32,7 +32,7 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any, Optional, cast
 
 import numpy as np
 
@@ -375,7 +375,7 @@ def iter_images(
                     AND i.timepoint = v.timepoint
                 WHERE v.embryo_id = ?
             """
-        params = [embryo_id]
+        params: list[Any] = [embryo_id]
 
         if session_id:
             query += " AND v.session_id = ?"
@@ -766,7 +766,7 @@ def create_perception_run(
                 ),
             )
         self.conn.commit()
-        return cursor.lastrowid
+        return cast("int", cursor.lastrowid)
 
     def store_prediction(
         self,
@@ -832,7 +832,7 @@ def store_prediction(
                     datetime.now().isoformat(),
                 ),
             )
-            prediction_id = cursor.lastrowid
+            prediction_id = cast("int", cursor.lastrowid)
         else:
             # Legacy schema: separate observed_features + reasoning_traces tables
             confidence_level = None
@@ -869,7 +869,7 @@ def store_prediction(
                 ),
             )
 
-            prediction_id = cursor.lastrowid
+            prediction_id = cast("int", cursor.lastrowid)
 
             # Store observed features if provided
             if observed_features:
@@ -986,7 +986,7 @@ def compute_run_metrics(self, run_id: int) -> dict[str, Any]:
         accuracy = correct / total if total > 0 else 0
 
         # Build confusion matrix
-        confusion = {}
+        confusion: dict[str, Any] = {}
         for pred_stage, gt_stage, _, _ in rows:
             if gt_stage not in confusion:
                 confusion[gt_stage] = {}
@@ -1396,7 +1396,7 @@ def get_run_predictions(
                 LEFT JOIN reasoning_traces rt ON p.id = rt.prediction_id
                 WHERE p.perception_run_id = ?
             """
-        params = [run_id]
+        params: list[Any] = [run_id]
 
         if embryo_id:
             query += " AND p.embryo_id = ?"
diff --git a/gently/dataset/explorer_server.py b/gently/dataset/explorer_server.py
index 3c9e816d..1ea35b2b 100644
--- a/gently/dataset/explorer_server.py
+++ b/gently/dataset/explorer_server.py
@@ -18,6 +18,7 @@
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 import numpy as np
 from fastapi import FastAPI, HTTPException, Query, WebSocket, WebSocketDisconnect
@@ -41,8 +42,8 @@
 
 logger = logging.getLogger(__name__)
 # Lazy imports for explorer-specific projection functions
-tifffile = None
-PIL_Image = None
+tifffile: Any = None
+PIL_Image: Any = None
 
 
 def ensure_projection_deps():
@@ -447,7 +448,7 @@ def projection_spin_3d(
     return grid, "6 perspective views rotating around volume"
 
 
-PROJECTION_METHODS = {
+PROJECTION_METHODS: dict[str, Any] = {
     "dual_view": projection_dual_view,
     "depth_colored": projection_depth_colored,
     "multi_slice": projection_multi_slice,
@@ -912,7 +913,7 @@ async def get_run_predictions(
                 SELECT * FROM predictions
                 WHERE perception_run_id = ?
             """
-            params = [run_id]
+            params: list[Any] = [run_id]
 
             if embryo_id:
                 query += " AND embryo_id = ?"
@@ -1069,7 +1070,8 @@ async def get_unified_timeline(embryo_uid: str):
             # Build unified image list with ground truth based on row index
             # within each session/embryo
             images = []
-            session_embryo_counts = {}  # Track row index within each session/embryo
+            # keyed by (session_id, embryo_id); value is the row index within that group
+            session_embryo_counts: dict[tuple[Any, Any], int] = {}
 
             for idx, r in enumerate(rows):
                 session_id = r[1]
diff --git a/pyproject.toml b/pyproject.toml
index 6567d600..d9802f71 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -119,33 +119,3 @@ ignore_missing_imports = true
 explicit_package_bases = true
 mypy_path = "."
 
-# Modules with pre-existing mypy errors, exempted while the codebase is
-# incrementally annotated (see issue #46). New modules should not be added
-# here; PRs that substantively touch a listed module should fix its errors
-# and remove it from this list as part of that change.
-[[tool.mypy.overrides]]
-module = [
-    "benchmarks.perception.live_viewer",
-    "benchmarks.perception.metrics",
-    "benchmarks.perception.testset",
-    "diagnostics.benchmark_gentlystore_fps",
-    "diagnostics.benchmark_volume_fps",
-    "diagnostics.plot_benchmark_results",
-    "diagnostics.switchbot_webgui",
-    "examples.example_dispim_workflows",
-    "gently.core.store",
-    "gently.dataset.aggregator",
-    "gently.dataset.embryo_dataset",
-    "gently.dataset.explorer_server",
-    "scripts.auto_label_examples",
-    "scripts.extract_stage_examples",
-    "scripts.gemini_stage_test",
-    "scripts.launch_viz_server",
-    "scripts.projection_explorer",
-    "scripts.replay_session",
-    "scripts.stage_annotator",
-    "tests.test_campaign_coordination",
-    "tests.test_text_tool_call_extraction",
-    "tests.validate_recursive_autofocus",
-]
-ignore_errors = true
diff --git a/scripts/auto_label_examples.py b/scripts/auto_label_examples.py
index b12f6626..055db082 100644
--- a/scripts/auto_label_examples.py
+++ b/scripts/auto_label_examples.py
@@ -18,6 +18,7 @@
 import json
 import sys
 from pathlib import Path
+from typing import Any
 
 import anthropic
 import numpy as np
@@ -229,7 +230,7 @@ async def auto_label_batch(
 
     # Save results for review
     output_file = output_file or Path("labeled_results.json")
-    save_data = {
+    save_data: dict[str, Any] = {
         stage: [{k: v for k, v in r.items() if k != "image_b64"} for r in results]
         for stage, results in results_by_stage.items()
     }
@@ -350,7 +351,7 @@ async def interactive_review(results_file: Path, examples_dir: Path):
         elif choice == "p":
             # Just populate from saved file - need to reload images
             print("Reloading images...")
-            results_with_images = {}
+            results_with_images: dict = {}
             for stage, items in data.items():
                 if stage.startswith("_"):
                     continue
diff --git a/scripts/extract_stage_examples.py b/scripts/extract_stage_examples.py
index 208e49c9..3660d549 100644
--- a/scripts/extract_stage_examples.py
+++ b/scripts/extract_stage_examples.py
@@ -32,6 +32,7 @@
 import sys
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 import numpy as np
 
@@ -41,8 +42,8 @@
 from gently.harness.perception.stages import STAGES
 
 # Lazy imports
-tifffile = None
-PIL_Image = None
+tifffile: Any = None
+PIL_Image: Any = None
 
 
 def ensure_dependencies():
@@ -77,7 +78,7 @@ def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict[st
 
     tif_files = list(session_dir.glob("*.tif")) + list(session_dir.glob("*.tiff"))
 
-    embryo_volumes = {}
+    embryo_volumes: dict = {}
 
     for f in tif_files:
         parts = f.stem.split("_")
diff --git a/scripts/gemini_stage_test.py b/scripts/gemini_stage_test.py
index 0a9a44b1..b724384c 100644
--- a/scripts/gemini_stage_test.py
+++ b/scripts/gemini_stage_test.py
@@ -21,6 +21,7 @@
 import time
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 # Add parent directory to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent))
@@ -28,9 +29,9 @@
 import numpy as np
 
 # Lazy imports for optional dependencies
-cv2 = None
-tifffile = None
-genai = None
+cv2: Any = None
+tifffile: Any = None
+genai: Any = None
 
 
 def ensure_dependencies():
@@ -74,7 +75,7 @@ def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict:
 
     tif_files = list(session_dir.glob("*.tif")) + list(session_dir.glob("*.tiff"))
 
-    embryo_volumes = {}
+    embryo_volumes: dict = {}
 
     for f in tif_files:
         parts = f.stem.split("_")
@@ -288,7 +289,7 @@ def create_embryo_video(
     # Create video
     writer = None
     frame_count = 0
-    first_shape = None
+    first_shape: Any = None
 
     try:
         for i, vol_path in enumerate(volume_paths):
@@ -494,7 +495,7 @@ def build_stage_classification_prompt(frame_count: int, fps: int, duration_secon
 
 
 def analyze_with_gemini(
-    video_path: str,
+    video_path: str | Path,
     model: str = "gemini-3-pro-preview",
     api_key: str | None = None,
     frame_count: int = 100,
@@ -633,7 +634,7 @@ def timestamp_to_seconds(timestamp: str) -> float:
 
 
 def create_annotated_video(
-    source_video: str, stage_data: dict, output_path: str, fps: int = 10
+    source_video: str, stage_data: dict, output_path: str | Path, fps: int = 10
 ) -> dict:
     """
     Create annotated video with stage labels overlaid.
@@ -667,7 +668,7 @@ def create_annotated_video(
         if i + 1 < len(stages):
             next_stage = stages[i + 1]
             if "frame" in next_stage:
-                end_frame = int(next_stage["frame"])
+                end_frame: float = int(next_stage["frame"])
             elif "timestamp" in next_stage:
                 end_seconds = timestamp_to_seconds(next_stage["timestamp"])
                 end_frame = int(end_seconds * fps)
diff --git a/scripts/launch_viz_server.py b/scripts/launch_viz_server.py
index b10eea91..bcae0842 100644
--- a/scripts/launch_viz_server.py
+++ b/scripts/launch_viz_server.py
@@ -150,7 +150,8 @@ async def run(
             if t >= _effective_tp(paths, max_timepoints):
                 continue
 
-            projection = project_volume(paths[t])
+            # paths[t] is a (timestamp, path) tuple from _discover_volumes
+            projection = project_volume(paths[t][1])
 
             proj_uid = f"proj_{session_id}_{eid}_t{t:04d}"
             vol_uid = f"volume_{session_id}_{eid}_t{t:04d}"
diff --git a/scripts/projection_explorer.py b/scripts/projection_explorer.py
index 88319905..57e39db6 100644
--- a/scripts/projection_explorer.py
+++ b/scripts/projection_explorer.py
@@ -34,15 +34,16 @@
 from datetime import datetime
 from http.server import BaseHTTPRequestHandler, HTTPServer
 from pathlib import Path
+from typing import Any
 from urllib.parse import parse_qs, urlparse
 
 import numpy as np
 from scipy import ndimage
 
 # Lazy imports
-tifffile = None
-PIL_Image = None
-plt = None
+tifffile: Any = None
+PIL_Image: Any = None
+plt: Any = None
 
 
 def ensure_dependencies():
@@ -87,7 +88,7 @@ def discover_volumes(session_dir: Path, embryo_id: str | None = None) -> dict[st
         return {}
 
     tif_files = list(session_dir.glob("*.tif")) + list(session_dir.glob("*.tiff"))
-    embryo_volumes = {}
+    embryo_volumes: dict = {}
 
     for f in tif_files:
         parts = f.stem.split("_")
@@ -906,9 +907,9 @@ def __init__(self, session_path: Path):
         self.embryo_volumes = discover_volumes(session_path)
         self.current_embryo = None
         self.current_idx = 0
-        self._volume_cache = {}  # (embryo, idx) -> volume
-        self._projection_cache = {}  # (embryo, idx, method) -> (img, desc)
-        self._crop_bounds = {}  # embryo -> (y_min, y_max, x_min, x_max)
+        self._volume_cache: dict = {}  # (embryo, idx) -> volume
+        self._projection_cache: dict = {}  # (embryo, idx, method) -> (img, desc)
+        self._crop_bounds: dict = {}  # embryo -> (y_min, y_max, x_min, x_max)
         self._cache_size = 20  # Keep more volumes in memory
 
         if self.embryo_volumes:
@@ -1036,7 +1037,7 @@ def preload_adjacent(self, idx: int, radius: int = 2):
 class ExplorerHandler(BaseHTTPRequestHandler):
     """HTTP handler for projection explorer."""
 
-    session_manager: SessionManager = None
+    session_manager: SessionManager  # assigned on the class before the server starts serving
     current_methods: list[str] = ["dual_view", "depth_colored"]
     current_z_slice: int = 0  # For 3D volume viewer
 
diff --git a/scripts/replay_session.py b/scripts/replay_session.py
index ec2b02c4..6badda7d 100644
--- a/scripts/replay_session.py
+++ b/scripts/replay_session.py
@@ -108,6 +108,7 @@ def main(argv=None) -> int:
 
     session = matches[0]
     session_dir = store._session_dir(session["session_id"])
+    assert session_dir is not None
     log_path = session_dir / "events.jsonl"
     if not log_path.exists():
         print(f"No events.jsonl in {session_dir}", file=sys.stderr)
diff --git a/scripts/stage_annotator.py b/scripts/stage_annotator.py
index 6171d603..14ee5b19 100644
--- a/scripts/stage_annotator.py
+++ b/scripts/stage_annotator.py
@@ -148,12 +148,12 @@ def save_example(img: np.ndarray, stage: str, source_name: str) -> str:
 
 # Global state
 class AppState:
-    images = []  # List of (path, projection) tuples
+    images: list = []  # List of (path, projection) tuples
     current_idx = 0
     session_id = ""
-    embryos = {}  # embryo_name -> [(path, proj), ...]
+    embryos: dict = {}  # embryo_name -> [(path, proj), ...]
     current_embryo = None
-    embryo_list = []
+    embryo_list: list = []
 
 
 state = AppState()
@@ -708,7 +708,7 @@ def save_with_labels(self, labels: dict):
         saved = 0
 
         # Group paths by stage
-        stage_paths = {}
+        stage_paths: dict = {}
         for path_str, stage in labels.items():
             if stage not in STAGES:
                 continue
diff --git a/tests/test_campaign_coordination.py b/tests/test_campaign_coordination.py
index 21f10302..305e76d2 100644
--- a/tests/test_campaign_coordination.py
+++ b/tests/test_campaign_coordination.py
@@ -80,7 +80,7 @@ def check(name, condition, detail=""):
 
 # Verify shared campaign has expected fields
 if shared:
-    sc = next((c for c in shared if c["id"] == cid), {})
+    sc: dict = next((c for c in shared if c["id"] == cid), {})
     check("Shared campaign has item_count", "item_count" in sc)
     check("Shared campaign has completed_count", "completed_count" in sc)
 
diff --git a/tests/test_text_tool_call_extraction.py b/tests/test_text_tool_call_extraction.py
deleted file mode 100644
index b79c2fc2..00000000
--- a/tests/test_text_tool_call_extraction.py
+++ /dev/null
@@ -1,76 +0,0 @@
-"""Tests for _extract_text_tool_calls fallback parser."""
-
-import json
-
-from gently.harness.conversation import _extract_text_tool_calls
-
-
-class TestExtractTextToolCalls:
-    def test_no_tool_calls(self):
-        text = "Hello! How can I help you today?"
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert cleaned == text
-        assert calls == []
-
-    def test_single_tool_call_with_arguments(self):
-        tc = json.dumps(
-            {
-                "name": "ask_user_choice",
-                "arguments": {
-                    "question": "What next?",
-                    "options": [{"id": "a", "label": "Option A"}],
-                },
-            }
-        )
-        text = f"Hey there!\n\n<tool_call>\n{tc}\n</tool_call>"
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert "<tool_call>" not in cleaned
-        assert len(calls) == 1
-        assert calls[0]["name"] == "ask_user_choice"
-        assert calls[0]["input"]["question"] == "What next?"
-
-    def test_single_tool_call_with_input_key(self):
-        tc = json.dumps(
-            {
-                "name": "get_status",
-                "input": {"embryo_id": "embryo_1"},
-            }
-        )
-        text = f"Checking...\n<tool_call>{tc}</tool_call>"
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert len(calls) == 1
-        assert calls[0]["input"]["embryo_id"] == "embryo_1"
-
-    def test_preserves_surrounding_text(self):
-        tc = json.dumps({"name": "foo", "arguments": {}})
-        text = f"Before text.\n\n<tool_call>{tc}</tool_call>\n\nAfter text."
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert "Before text." in cleaned
-        assert "After text." in cleaned
-        assert "<tool_call>" not in cleaned
-        assert len(calls) == 1
-
-    def test_multiple_tool_calls(self):
-        tc1 = json.dumps({"name": "tool_a", "arguments": {"x": 1}})
-        tc2 = json.dumps({"name": "tool_b", "arguments": {"y": 2}})
-        text = f"Text\n<tool_call>{tc1}</tool_call>\nMore\n<tool_call>{tc2}</tool_call>"
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert len(calls) == 2
-        assert calls[0]["name"] == "tool_a"
-        assert calls[1]["name"] == "tool_b"
-
-    def test_invalid_json_skipped(self):
-        text = "Hello\n<tool_call>not valid json</tool_call>"
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert calls == []
-
-    def test_missing_name_skipped(self):
-        tc = json.dumps({"arguments": {"x": 1}})
-        text = f"<tool_call>{tc}</tool_call>"
-        cleaned, calls = _extract_text_tool_calls(text)
-        assert calls == []
-
-    def test_empty_text(self):
-        cleaned, calls = _extract_text_tool_calls("")
-        assert cleaned == ""
-        assert calls == []
diff --git a/tests/validate_recursive_autofocus.py b/tests/validate_recursive_autofocus.py
deleted file mode 100644
index 3fd2d088..00000000
--- a/tests/validate_recursive_autofocus.py
+++ /dev/null
@@ -1,201 +0,0 @@
-#!/usr/bin/env python3
-"""
-Validate Recursive Autofocus Implementation
-==========================================
-
-Quick validation test for the recursive autofocus functionality using mock devices.
-Tests the plan structure and parameter handling without requiring real hardware.
-"""
-
-import logging
-import sys
-from unittest.mock import Mock
-
-import numpy as np
-
-
-# Mock pymmcore for testing without hardware
-class MockPyMMCore:
-    class CMMCore:
-        def __init__(self):
-            self.current_position = 150.0  # Start at middle of new range
-
-        def getPosition(self, device):
-            return self.current_position
-
-        def setPosition(self, device, position):
-            # Simulate device movement
-            self.current_position = position
-            print(f"Mock {device} moved to {position:.2f} μm")
-
-        def waitForDevice(self, device):
-            pass
-
-        def getImage(self):
-            # Return mock image data
-            return np.random.randint(0, 1000, (100, 100), dtype=np.uint16)
-
-
-# Install mock
-if "pymmcore" not in sys.modules:
-    sys.modules["pymmcore"] = MockPyMMCore()
-
-# Import after mocking
-from bluesky import RunEngine  # noqa: E402
-
-from gently.hardware.dispim.devices import DiSPIMCamera, DiSPIMZstage  # noqa: E402
-from gently.hardware.dispim.plans.acquisition import recursive_focus_single_round  # noqa: E402
-
-
-def test_device_limits():
-    """Test that devices have correct limits and rounding"""
-    print("Testing Device Limits and Rounding")
-    print("=" * 40)
-
-    mock_core = MockPyMMCore.CMMCore()
-
-    # Test Z-stage limits
-    z_stage = DiSPIMZstage("TestZStage", mock_core, name="test_z")
-    print(f"Z-stage limits: {z_stage.limits}")
-
-    # Test position rounding (this would be tested by trying problematic float values)
-    test_positions = [160.85999999999999, 100.333333333333333, 75.0000000000001]
-
-    for pos in test_positions:
-        try:
-            z_stage.set(pos)
-            print(f"✓ Position {pos} handled successfully")
-        except ValueError as e:
-            print(f"✗ Position {pos} failed: {e}")
-
-    print()
-
-
-def test_recursive_autofocus_plan():
-    """Test the recursive autofocus plan structure"""
-    print("Testing Recursive Autofocus Plan")
-    print("=" * 40)
-
-    mock_core = MockPyMMCore.CMMCore()
-
-    # Create mock devices
-    z_stage = DiSPIMZstage("TestZStage", mock_core, name="test_z")
-    camera = DiSPIMCamera("TestCamera", mock_core, name="test_camera")
-
-    # Mock the camera's trigger method to avoid actual image acquisition
-    camera.trigger = Mock(return_value=Mock(done=True))
-
-    # Create RunEngine for testing
-    RE = RunEngine()
-
-    # Test parameters
-    coarse_range = 50.0
-    fine_range = 10.0
-    coarse_steps = 5  # Fewer steps for quick test
-    fine_steps = 7
-
-    print("Testing with:")
-    print(f"  Coarse range: ±{coarse_range / 2} μm ({coarse_steps} steps)")
-    print(f"  Fine range: ±{fine_range / 2} μm ({fine_steps} steps)")
-    print(f"  Starting position: {mock_core.current_position} μm")
-    print()
-
-    try:
-        # Run the recursive autofocus plan
-        plan = recursive_focus_single_round(
-            z_stage,
-            camera,
-            coarse_range=coarse_range,
-            fine_range=fine_range,
-            coarse_steps=coarse_steps,
-            fine_steps=fine_steps,
-        )
-
-        # Execute plan
-        RE(plan)
-
-        print("✓ Recursive autofocus plan executed successfully")
-        print(f"Final position: {mock_core.current_position:.2f} μm")
-
-        # Verify position is within limits
-        if z_stage.limits[0] <= mock_core.current_position <= z_stage.limits[1]:
-            print(f"✓ Final position within limits {z_stage.limits}")
-        else:
-            print(f"✗ Final position outside limits {z_stage.limits}")
-
-    except Exception as e:
-        print(f"✗ Recursive autofocus plan failed: {e}")
-        import traceback
-
-        traceback.print_exc()
-
-    print()
-
-
-def test_position_bounds():
-    """Test position bounds checking"""
-    print("Testing Position Bounds")
-    print("=" * 40)
-
-    mock_core = MockPyMMCore.CMMCore()
-    z_stage = DiSPIMZstage("TestZStage", mock_core, name="test_z")
-
-    # Test positions at various points
-    test_cases = [
-        (25.0, "Below lower limit", False),
-        (50.0, "At lower limit", True),
-        (150.0, "Middle of range", True),
-        (250.0, "At upper limit", True),
-        (275.0, "Above upper limit", False),
-    ]
-
-    for pos, description, should_pass in test_cases:
-        try:
-            z_stage.set(pos)
-            if should_pass:
-                print(f"✓ {description} ({pos}): Accepted")
-            else:
-                print(f"✗ {description} ({pos}): Should have been rejected")
-        except ValueError:
-            if not should_pass:
-                print(f"✓ {description} ({pos}): Correctly rejected")
-            else:
-                print(f"✗ {description} ({pos}): Should have been accepted")
-
-    print()
-
-
-def main():
-    """Run all validation tests"""
-    print("Recursive Autofocus Validation")
-    print("=" * 50)
-    print()
-
-    # Reduce log noise
-    logging.basicConfig(level=logging.WARNING)
-
-    # Run tests
-    test_device_limits()
-    test_position_bounds()
-    test_recursive_autofocus_plan()
-
-    print("=" * 50)
-    print("Validation Complete!")
-    print()
-    print("Usage Instructions:")
-    print("=" * 20)
-    print("1. Simple focus test:")
-    print("   python test_embryo_focus.py")
-    print()
-    print("2. Recursive autofocus test:")
-    print("   python test_embryo_focus.py recursive")
-    print()
-    print("The recursive autofocus performs:")
-    print("  - Coarse scan (±50μm default)")
-    print("  - Analysis to find best coarse position")
-    print("  - Fine scan around best position (±10μm default)")
-    print("  - Final move to optimal position from curve fit")
-
-
-if __name__ == "__main__":
-    main()

From 9917e12a46e4a8efa696e7126c61224d263527bc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 13:11:46 +0530
Subject: [PATCH 185/314] =?UTF-8?q?feat(manual-mode):=20Manual=20view=20?=
 =?UTF-8?q?=E2=80=94=20SPIM=20live=20canvas,=20galvo/piezo/exposure,=20ill?=
 =?UTF-8?q?umination,=20acquire,=20temp?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/ui/web/static/css/main.css  | 257 +++++++++++++++++
 gently/ui/web/static/js/devices.js | 445 ++++++++++++++++++++++++++++-
 gently/ui/web/templates/index.html | 119 ++++++++
 3 files changed, 815 insertions(+), 6 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 36124bd9..4c04716e 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10550,3 +10550,260 @@ body.modal-open {
     opacity: 0.5;
     cursor: not-allowed;
 }
+
+/* =========================================================================
+   Manual view — lightsheet live panel + control rail
+   ========================================================================= */
+
+/* Two-column layout: image stage (flex-grow) + fixed control rail */
+.ls-layout {
+    display: flex;
+    flex: 1;
+    min-height: 0;
+    gap: 1rem;
+    font-family: 'Inter Tight', system-ui, sans-serif;
+}
+
+/* Left column — live image stage */
+.ls-image-col {
+    flex: 1;
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.45rem;
+}
+
+.ls-stage-head {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    flex-wrap: wrap;
+}
+
+/* The stage itself reuses .devices-camera-stage aspect + overflow */
+.ls-stage {
+    flex: 1;
+    min-height: 280px;
+    /* override aspect-ratio: let the flex column stretch it */
+    aspect-ratio: unset;
+}
+
+/* Right column — control rail */
+.ls-rail {
+    width: 220px;
+    flex-shrink: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.85rem;
+    overflow-y: auto;
+    padding: 0.1rem 0 0.5rem;
+}
+
+/* Control group block */
+.ls-group {
+    display: flex;
+    flex-direction: column;
+    gap: 0.32rem;
+    padding: 0.55rem 0.65rem;
+    background: var(--map-overlay-bg);
+    border: 1px solid var(--map-overlay-edge);
+    border-radius: 5px;
+}
+
+.ls-label {
+    font-size: 0.6rem;
+    font-weight: 600;
+    letter-spacing: 0.18em;
+    text-transform: uppercase;
+    color: var(--map-ink-mute);
+}
+
+/* Generic inline row */
+.ls-row {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+}
+
+/* Slider + number inline */
+.ls-slider-row {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+}
+
+.ls-slider {
+    flex: 1;
+    min-width: 0;
+    height: 3px;
+    accent-color: var(--map-accent);
+    cursor: pointer;
+}
+
+.ls-number {
+    width: 64px;
+    background: var(--map-paper-2);
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    border-radius: 4px;
+    padding: 0.2rem 0.35rem;
+    font-family: 'JetBrains Mono', monospace;
+    font-size: 0.7rem;
+    font-variant-numeric: tabular-nums;
+}
+
+.ls-number-sm {
+    width: 50px;
+}
+
+.ls-number:focus {
+    outline: none;
+    border-color: var(--map-accent);
+}
+
+.ls-unit {
+    font-family: 'Inter Tight', system-ui, sans-serif;
+    font-size: 0.62rem;
+    color: var(--map-ink-mute);
+    flex-shrink: 0;
+}
+
+/* Illumination button rows */
+.ls-btn-row {
+    display: flex;
+    gap: 0.35rem;
+    flex-wrap: wrap;
+}
+
+.ls-illum-btn {
+    flex: 1;
+    min-width: 0;
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.6rem;
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    padding: 0.28rem 0.4rem;
+    border-radius: 4px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.ls-illum-btn:hover {
+    background: rgba(255,255,255,0.06);
+    border-color: var(--map-accent);
+    color: var(--map-accent);
+}
+
+.ls-illum-btn--active {
+    background: rgba(34, 211, 238, 0.14);
+    border-color: var(--map-accent);
+    color: var(--map-accent);
+}
+
+/* Laser-off indicator */
+.ls-laser-indicator {
+    font-size: 0.6rem;
+    color: var(--map-ink-mute);
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+    margin-top: 0.1rem;
+}
+
+.ls-laser-dot {
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+    background: var(--map-ink-mute);
+    flex-shrink: 0;
+}
+
+/* Temperature setpoint button */
+.ls-set-btn {
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.6rem;
+    font-weight: 600;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    padding: 0.2rem 0.55rem;
+    border-radius: 4px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s;
+}
+
+.ls-set-btn:hover {
+    background: rgba(255,255,255,0.06);
+    border-color: var(--map-accent);
+}
+
+/* Temperature mini-graph */
+.ls-tempgraph {
+    min-height: 48px;
+    margin-top: 0.25rem;
+}
+
+/* Acquire buttons */
+.ls-acquire-btn {
+    flex: 1;
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.62rem;
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    padding: 0.35rem 0.5rem;
+    border-radius: 4px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+}
+
+.ls-acquire-btn:hover:not(:disabled) {
+    background: rgba(255,255,255,0.06);
+    border-color: var(--map-accent);
+    color: var(--map-accent);
+}
+
+.ls-acquire-btn:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+/* Last-captured ref card */
+.ls-lastcap {
+    margin-top: 0.35rem;
+    padding: 0.35rem 0.45rem;
+    background: var(--map-paper-2);
+    border: 1px solid var(--map-overlay-edge);
+    border-radius: 4px;
+    display: flex;
+    flex-direction: column;
+    gap: 0.2rem;
+}
+
+.ls-lastcap[hidden] { display: none; }
+
+.ls-lastcap-label {
+    font-size: 0.58rem;
+    letter-spacing: 0.14em;
+    text-transform: uppercase;
+    color: var(--map-ink-mute);
+}
+
+.ls-lastcap-ref {
+    font-family: 'JetBrains Mono', monospace;
+    font-size: 0.65rem;
+    color: var(--map-ink);
+    word-break: break-all;
+}
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index a56f0015..57aa3bd0 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -14,7 +14,7 @@
  */
 const DevicesManager = (function () {
     const STALE_AFTER_MS = 4000;
-    const VIEWS = ['map', 'details', 'optical3d'];
+    const VIEWS = ['map', 'details', 'optical3d', 'manual'];
     const SVG_NS = 'http://www.w3.org/2000/svg';
 
     // Status / details DOM
@@ -72,6 +72,34 @@ const DevicesManager = (function () {
     const _CAM_ZOOM_MAX = 8;
     const _CAM_ZOOM_STEP = 1.15;  // multiplicative per wheel notch
 
+    // Lightsheet live panel DOM + state (Manual view)
+    let _lsToggle, _lsImg, _lsPlaceholder, _lsLed, _lsMeta, _lsStage;
+    let _lsStreaming = false;
+    let _lsLastFrameTs = 0;
+    let _lsHasFrame = false;
+    let _lsStaleTimer = null;
+    const _LS_FPS_WINDOW = 12;
+    let _lsFrameTimes = [];
+
+    // Lightsheet zoom / pan (mirrors camera zoom/pan)
+    let _lsZoom = 1;
+    let _lsTx = 0;
+    let _lsTy = 0;
+    let _lsPanLast = null;
+
+    // Lightsheet live params — debounced POST to /api/devices/lightsheet/live/params
+    let _lsGalvo = 0;
+    let _lsPiezo = 50;
+    let _lsExposure = 50;
+    let _lsParamTimer = null;
+
+    // Lightsheet control inputs (rail)
+    let _lsGalvoSlider, _lsGalvoNum, _lsPiezoSlider, _lsPiezoNum, _lsExposureNum;
+    let _lsLedOpen, _lsLedClosed, _lsCamLed, _lsRoomLightBtn;
+    let _lsCamLedOn = false;
+    let _lsSnapVolBtn, _lsBurstBtn, _lsLastcap, _lsLastcapRef;
+    let _lsTempInput, _lsTempSet;
+
     // Room-light toggle (header). Drives the SwitchBot Bot that switches the
     // diSPIM room light. State is the bot's cached on/off; hidden until the
     // device layer reports the accessory is configured.
@@ -151,6 +179,29 @@ const DevicesManager = (function () {
         _camLed          = document.getElementById('devices-camera-led');
         _camMeta         = document.getElementById('devices-camera-meta');
 
+        // Manual / lightsheet panel
+        _lsToggle        = document.getElementById('devices-ls-toggle');
+        _lsImg           = document.getElementById('devices-ls-img');
+        _lsPlaceholder   = document.getElementById('devices-ls-placeholder');
+        _lsStage         = document.getElementById('devices-ls-stage');
+        _lsLed           = document.getElementById('devices-ls-led');
+        _lsMeta          = document.getElementById('devices-ls-meta');
+        _lsGalvoSlider   = document.getElementById('devices-ls-galvo-slider');
+        _lsGalvoNum      = document.getElementById('devices-ls-galvo');
+        _lsPiezoSlider   = document.getElementById('devices-ls-piezo-slider');
+        _lsPiezoNum      = document.getElementById('devices-ls-piezo');
+        _lsExposureNum   = document.getElementById('devices-ls-exposure');
+        _lsLedOpen       = document.getElementById('devices-ls-led-open');
+        _lsLedClosed     = document.getElementById('devices-ls-led-closed');
+        _lsCamLed        = document.getElementById('devices-ls-cam-led');
+        _lsRoomLightBtn  = document.getElementById('devices-ls-room-light-btn');
+        _lsSnapVolBtn    = document.getElementById('devices-ls-snap-volume');
+        _lsBurstBtn      = document.getElementById('devices-ls-burst');
+        _lsLastcap       = document.getElementById('devices-ls-lastcap');
+        _lsLastcapRef    = document.getElementById('devices-ls-lastcap-ref');
+        _lsTempInput     = document.getElementById('devices-ls-temp-input');
+        _lsTempSet       = document.getElementById('devices-ls-temp-set');
+
         _roomLightToggle = document.getElementById('devices-room-light-toggle');
         _roomLightLabel  = document.getElementById('devices-room-light-label');
 
@@ -1292,6 +1343,386 @@ const DevicesManager = (function () {
         }
     }
 
+    // =====================================================================
+    // Lightsheet live panel (Manual view)
+    // =====================================================================
+
+    async function toggleLightsheetStream() {
+        if (!_lsToggle) return;
+        _lsToggle.disabled = true;
+        try {
+            const endpoint = _lsStreaming
+                ? '/api/devices/lightsheet/live/stop'
+                : '/api/devices/lightsheet/live/start';
+            const res = await fetch(endpoint, { method: 'POST' });
+            if (!res.ok) {
+                const detail = await res.text();
+                console.error('Lightsheet toggle failed:', detail);
+                if (_lsMeta) _lsMeta.textContent = `error: ${res.status}`;
+                return;
+            }
+            const data = await res.json();
+            applyLightsheetState(!!data.streaming);
+        } catch (err) {
+            console.error('Lightsheet toggle failed:', err);
+            if (_lsMeta) _lsMeta.textContent = `error: ${err}`;
+        } finally {
+            _lsToggle.disabled = false;
+        }
+    }
+
+    function applyLightsheetState(streaming) {
+        _lsStreaming = streaming;
+        if (_lsToggle) {
+            _lsToggle.textContent = streaming ? 'Stop' : 'Start';
+            _lsToggle.classList.toggle('active', streaming);
+        }
+        if (_lsLed) {
+            _lsLed.classList.toggle('live', streaming);
+            _lsLed.classList.remove('stale');
+        }
+        if (!streaming) {
+            _lsHasFrame = false;
+            _lsFrameTimes = [];
+            if (_lsImg) _lsImg.classList.remove('has-frame');
+            if (_lsPlaceholder) _lsPlaceholder.hidden = false;
+            if (_lsMeta) _lsMeta.textContent = 'stream off';
+            if (_lsStaleTimer) { clearTimeout(_lsStaleTimer); _lsStaleTimer = null; }
+            resetLightsheetZoom();
+        } else {
+            _lsFrameTimes = [];
+            if (_lsMeta) _lsMeta.textContent = 'waiting…';
+        }
+    }
+
+    function handleLightsheetFrame(payload) {
+        if (!payload || !payload.jpeg_b64 || !_lsImg) return;
+        _lsImg.src = `data:${payload.mime || 'image/jpeg'};base64,${payload.jpeg_b64}`;
+        if (!_lsHasFrame) {
+            _lsHasFrame = true;
+            _lsImg.classList.add('has-frame');
+            if (_lsPlaceholder) _lsPlaceholder.hidden = true;
+        }
+        const now = performance.now();
+        _lsLastFrameTs = Date.now();
+        _lsFrameTimes.push(now);
+        if (_lsFrameTimes.length > _LS_FPS_WINDOW) _lsFrameTimes.shift();
+        if (_lsLed) {
+            _lsLed.classList.add('live');
+            _lsLed.classList.remove('stale');
+        }
+        if (_lsMeta) {
+            const shape = payload.shape || [];
+            const dims = shape.length === 2 ? `${shape[1]}×${shape[0]}` : '';
+            const fps = computeLightsheetFps();
+            _lsMeta.textContent = dims
+                ? `${dims}  ·  ${fps != null ? fps.toFixed(1) + ' fps' : '…'}`
+                : (fps != null ? `${fps.toFixed(1)} fps` : 'live');
+        }
+        scheduleLightsheetStaleCheck();
+    }
+
+    function computeLightsheetFps() {
+        const n = _lsFrameTimes.length;
+        if (n < 2) return null;
+        const span = _lsFrameTimes[n - 1] - _lsFrameTimes[0];
+        if (span <= 0) return null;
+        return ((n - 1) * 1000) / span;
+    }
+
+    function scheduleLightsheetStaleCheck() {
+        if (_lsStaleTimer) clearTimeout(_lsStaleTimer);
+        _lsStaleTimer = setTimeout(() => {
+            const age = (Date.now() - _lsLastFrameTs) / 1000;
+            if (_lsMeta) _lsMeta.textContent = `last frame ${age.toFixed(1)}s ago`;
+            if (_lsLed) _lsLed.classList.add('stale');
+        }, 1500);
+    }
+
+    async function syncInitialLightsheetState() {
+        try {
+            const res = await fetch('/api/devices/lightsheet/live/status');
+            if (!res.ok) return;
+            const data = await res.json();
+            applyLightsheetState(!!data.streaming);
+        } catch (err) {
+            console.debug('lightsheet status check failed:', err);
+        }
+    }
+
+    // ---- Lightsheet zoom / pan (mirrors camera zoom/pan) ----------------
+    function applyLightsheetTransform() {
+        if (!_lsImg) return;
+        _lsImg.style.transform =
+            `translate(${_lsTx}px, ${_lsTy}px) scale(${_lsZoom})`;
+    }
+
+    function resetLightsheetZoom() {
+        _lsZoom = 1;
+        _lsTx = 0;
+        _lsTy = 0;
+        applyLightsheetTransform();
+        if (_lsStage) _lsStage.classList.remove('camera-zoomed', 'camera-panning');
+    }
+
+    function clampLightsheetPan() {
+        if (!_lsStage) return;
+        const rect = _lsStage.getBoundingClientRect();
+        const maxX = (rect.width  * (_lsZoom - 1)) / 2;
+        const maxY = (rect.height * (_lsZoom - 1)) / 2;
+        _lsTx = Math.max(-maxX, Math.min(maxX, _lsTx));
+        _lsTy = Math.max(-maxY, Math.min(maxY, _lsTy));
+    }
+
+    function onLightsheetWheel(event) {
+        if (!_lsStage) return;
+        event.preventDefault();
+        const rect = _lsStage.getBoundingClientRect();
+        const cx = event.clientX - rect.left - rect.width  / 2;
+        const cy = event.clientY - rect.top  - rect.height / 2;
+        const oldZoom = _lsZoom;
+        const factor = event.deltaY < 0 ? _CAM_ZOOM_STEP : 1 / _CAM_ZOOM_STEP;
+        const newZoom = Math.max(_CAM_ZOOM_MIN, Math.min(_CAM_ZOOM_MAX, oldZoom * factor));
+        if (newZoom === oldZoom) return;
+        const ratio = newZoom / oldZoom;
+        _lsTx = cx - (cx - _lsTx) * ratio;
+        _lsTy = cy - (cy - _lsTy) * ratio;
+        _lsZoom = newZoom;
+        if (Math.abs(_lsZoom - 1) < 0.001) { resetLightsheetZoom(); return; }
+        clampLightsheetPan();
+        applyLightsheetTransform();
+        _lsStage.classList.add('camera-zoomed');
+    }
+
+    function onLightsheetPointerDown(event) {
+        if (event.button !== 0) return;
+        if (_lsZoom <= 1) return;
+        _lsPanLast = { x: event.clientX, y: event.clientY };
+        try { _lsStage.setPointerCapture(event.pointerId); } catch (_) {}
+        _lsStage.classList.add('camera-panning');
+        event.preventDefault();
+    }
+
+    function onLightsheetPointerMove(event) {
+        if (!_lsPanLast) return;
+        _lsTx += event.clientX - _lsPanLast.x;
+        _lsTy += event.clientY - _lsPanLast.y;
+        _lsPanLast = { x: event.clientX, y: event.clientY };
+        clampLightsheetPan();
+        applyLightsheetTransform();
+    }
+
+    function onLightsheetPointerEnd(event) {
+        if (!_lsPanLast) return;
+        _lsPanLast = null;
+        try { _lsStage.releasePointerCapture(event.pointerId); } catch (_) {}
+        if (_lsStage) _lsStage.classList.remove('camera-panning');
+    }
+
+    function onLightsheetDoubleClick(event) {
+        if (_lsZoom !== 1 || _lsTx !== 0 || _lsTy !== 0) {
+            event.preventDefault();
+            resetLightsheetZoom();
+        }
+    }
+
+    // ---- Lightsheet live params (debounced) -----------------------------
+    function postLightsheetParams() {
+        fetch('/api/devices/lightsheet/live/params', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ galvo: _lsGalvo, piezo: _lsPiezo, exposure: _lsExposure }),
+        }).catch(err => console.debug('lightsheet params post failed:', err));
+    }
+
+    function scheduleLightsheetParamPost() {
+        if (_lsParamTimer) clearTimeout(_lsParamTimer);
+        _lsParamTimer = setTimeout(postLightsheetParams, 120);
+    }
+
+    function onGalvoInput(src) {
+        const v = parseFloat(src.value);
+        if (isNaN(v)) return;
+        _lsGalvo = v;
+        // Sync the sibling control
+        if (src === _lsGalvoSlider && _lsGalvoNum) _lsGalvoNum.value = v;
+        if (src === _lsGalvoNum   && _lsGalvoSlider) _lsGalvoSlider.value = v;
+        scheduleLightsheetParamPost();
+    }
+
+    function onPiezoInput(src) {
+        const v = parseFloat(src.value);
+        if (isNaN(v)) return;
+        _lsPiezo = v;
+        if (src === _lsPiezoSlider && _lsPiezoNum) _lsPiezoNum.value = v;
+        if (src === _lsPiezoNum   && _lsPiezoSlider) _lsPiezoSlider.value = v;
+        scheduleLightsheetParamPost();
+    }
+
+    function onExposureInput() {
+        const v = parseFloat(_lsExposureNum && _lsExposureNum.value);
+        if (isNaN(v) || v < 1) return;
+        _lsExposure = v;
+        scheduleLightsheetParamPost();
+    }
+
+    // ---- Illumination toggles -------------------------------------------
+    async function postLedPreset(preset) {
+        try {
+            await fetch('/api/devices/led/set', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ state: preset }),
+            });
+        } catch (err) { console.debug('LED preset failed:', err); }
+    }
+
+    async function toggleCamLedMode() {
+        _lsCamLedOn = !_lsCamLedOn;
+        if (_lsCamLed) {
+            _lsCamLed.classList.toggle('ls-illum-btn--active', _lsCamLedOn);
+            _lsCamLed.setAttribute('aria-pressed', _lsCamLedOn ? 'true' : 'false');
+        }
+        try {
+            await fetch('/api/devices/camera/led_mode', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ use_led: _lsCamLedOn }),
+            });
+        } catch (err) { console.debug('cam LED mode failed:', err); }
+    }
+
+    async function toggleManualRoomLight() {
+        const nextState = _roomLightState === 'on' ? 'off' : 'on';
+        if (_lsRoomLightBtn) {
+            _lsRoomLightBtn.classList.toggle('ls-illum-btn--active', nextState === 'on');
+            _lsRoomLightBtn.setAttribute('aria-pressed', nextState === 'on' ? 'true' : 'false');
+        }
+        try {
+            const res = await fetch('/api/devices/room_light/set', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ state: nextState }),
+            });
+            if (res.ok) {
+                const data = await res.json();
+                _roomLightState = data.state || nextState;
+                if (_lsRoomLightBtn) {
+                    const on = _roomLightState === 'on';
+                    _lsRoomLightBtn.classList.toggle('ls-illum-btn--active', on);
+                    _lsRoomLightBtn.setAttribute('aria-pressed', on ? 'true' : 'false');
+                }
+            }
+        } catch (err) { console.debug('manual room light toggle failed:', err); }
+    }
+
+    // ---- Acquire --------------------------------------------------------
+    async function runLightsheetAcquire(mode) {
+        const btn = mode === 'burst' ? _lsBurstBtn : _lsSnapVolBtn;
+        if (btn) { btn.disabled = true; btn.textContent = 'acquiring…'; }
+        try {
+            let res;
+            if (mode === 'burst') {
+                res = await fetch('/api/devices/acquire/burst', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ frames: 10, mode: 'brightfield',
+                                          num_slices: 50, exposure_ms: _lsExposure }),
+                });
+            } else {
+                res = await fetch('/api/devices/acquire/volume', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ num_slices: 50, exposure_ms: _lsExposure }),
+                });
+            }
+            if (!res.ok) {
+                console.error('acquire failed:', res.status, await res.text());
+                return;
+            }
+            const data = await res.json();
+            if (_lsLastcap) _lsLastcap.hidden = false;
+            if (_lsLastcapRef) {
+                _lsLastcapRef.textContent = data.volume_path || data.path || data.id || 'done';
+            }
+        } catch (err) {
+            console.error('acquire error:', err);
+        } finally {
+            if (btn) {
+                btn.disabled = false;
+                btn.textContent = mode === 'burst' ? 'Burst' : 'Snap Volume';
+            }
+        }
+    }
+
+    // ---- Temperature set (rail copy, delegates to same API) -------------
+    async function setLightsheetTemperature() {
+        if (!_lsTempInput) return;
+        const target = parseFloat(_lsTempInput.value);
+        if (isNaN(target) || target < 0 || target > 99.9) return;
+        try {
+            await fetch('/api/devices/temperature/set', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ target_c: target }),
+            });
+        } catch (err) { console.debug('ls temp set failed:', err); }
+    }
+
+    function setupManualWiring() {
+        if (!_lsToggle) return;
+        _lsToggle.addEventListener('click', toggleLightsheetStream);
+        applyLightsheetState(false);
+
+        // Param controls — slider ↔ number sync + debounced POST
+        if (_lsGalvoSlider) _lsGalvoSlider.addEventListener('input', () => onGalvoInput(_lsGalvoSlider));
+        if (_lsGalvoNum)    _lsGalvoNum.addEventListener('input',    () => onGalvoInput(_lsGalvoNum));
+        if (_lsPiezoSlider) _lsPiezoSlider.addEventListener('input', () => onPiezoInput(_lsPiezoSlider));
+        if (_lsPiezoNum)    _lsPiezoNum.addEventListener('input',    () => onPiezoInput(_lsPiezoNum));
+        if (_lsExposureNum) _lsExposureNum.addEventListener('input', onExposureInput);
+
+        // Illumination
+        if (_lsLedOpen)    _lsLedOpen.addEventListener('click',    () => postLedPreset('Open'));
+        if (_lsLedClosed)  _lsLedClosed.addEventListener('click',  () => postLedPreset('Closed'));
+        if (_lsCamLed)     _lsCamLed.addEventListener('click',     toggleCamLedMode);
+        if (_lsRoomLightBtn) _lsRoomLightBtn.addEventListener('click', toggleManualRoomLight);
+
+        // Acquire
+        if (_lsSnapVolBtn) _lsSnapVolBtn.addEventListener('click', () => runLightsheetAcquire('volume'));
+        if (_lsBurstBtn)   _lsBurstBtn.addEventListener('click',   () => runLightsheetAcquire('burst'));
+
+        // Temperature
+        if (_lsTempSet) _lsTempSet.addEventListener('click', setLightsheetTemperature);
+        if (_lsTempInput) {
+            _lsTempInput.addEventListener('keydown', (e) => {
+                if (e.key === 'Enter') { e.preventDefault(); setLightsheetTemperature(); }
+            });
+        }
+
+        // Zoom / pan
+        if (_lsStage) {
+            _lsStage.addEventListener('wheel', onLightsheetWheel, { passive: false });
+            _lsStage.addEventListener('pointerdown', onLightsheetPointerDown);
+            _lsStage.addEventListener('pointermove', onLightsheetPointerMove);
+            _lsStage.addEventListener('pointerup', onLightsheetPointerEnd);
+            _lsStage.addEventListener('pointercancel', onLightsheetPointerEnd);
+            _lsStage.addEventListener('dblclick', onLightsheetDoubleClick);
+        }
+
+        // Subscribe to LIGHTSHEET_FRAME events
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('LIGHTSHEET_FRAME', handleLightsheetFrame);
+        }
+
+        // Embed temperature graph in the rail
+        const _lsTgEl = document.getElementById('devices-ls-tempgraph');
+        if (_lsTgEl && window.TemperatureGraph) {
+            TemperatureGraph.init(_lsTgEl, 'current');
+        }
+
+        syncInitialLightsheetState();
+    }
+
     // =====================================================================
     // Room-light toggle
     // =====================================================================
@@ -1552,6 +1983,7 @@ const DevicesManager = (function () {
         cacheDom();
         setupViewSwitcher();
         setupCameraWiring();
+        setupManualWiring();
         setupRoomLight();
         setupTemperature();
         const _tgEl = document.getElementById('devices-temp-graph');
@@ -1577,13 +2009,14 @@ const DevicesManager = (function () {
         document.addEventListener('keydown', onMapKeyDown);
         setStatus('stale', 'waiting', 'no payload yet');
         syncInitialCameraState();
-        // Stop the camera stream if the tab is closed while it's running,
-        // so MMCore isn't held by a disconnected browser.
+        // Stop the camera and lightsheet streams if the tab is closed while
+        // running, so MMCore isn't held by a disconnected browser.
         window.addEventListener('beforeunload', () => {
             if (_camStreaming) {
-                try {
-                    navigator.sendBeacon('/api/devices/bottom_camera/stream/stop');
-                } catch (_) {}
+                try { navigator.sendBeacon('/api/devices/bottom_camera/stream/stop'); } catch (_) {}
+            }
+            if (_lsStreaming) {
+                try { navigator.sendBeacon('/api/devices/lightsheet/live/stop'); } catch (_) {}
             }
         });
     }
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 7e1f0726..dc6718c2 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -446,6 +446,7 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                         <button class="view-btn active" data-view="map" title="XY Map (m)">Map</button>
                         <button class="view-btn" data-view="details" title="Details (d)">Details</button>
                         <button class="view-btn" data-view="optical3d" title="3D volume (v)">3D</button>
+                        <button class="view-btn" data-view="manual" title="Manual control">Manual</button>
                     </div>
                 </div>
                 <div class="devices-status">
@@ -714,6 +715,124 @@ <h3 class="devices-properties-title">Properties</h3>
 
             <!-- Temperature trajectory graph: backfill + live SVG chart -->
             <section class="devices-temp-graph" id="devices-temp-graph" aria-label="Temperature trajectory"></section>
+
+            <!-- Manual view: SPIM brightfield live-view + controls -->
+            <div class="devices-view devices-view-manual" id="devices-view-manual" style="display:none">
+                <div class="ls-layout">
+
+                    <!-- LEFT: live image stage -->
+                    <div class="ls-image-col">
+                        <div class="ls-stage-head">
+                            <span class="devices-camera-title">
+                                <span class="devices-camera-led" id="devices-ls-led"></span>
+                                <span>Lightsheet</span>
+                            </span>
+                            <span class="devices-camera-meta" id="devices-ls-meta">—</span>
+                            <button class="devices-camera-toggle" id="devices-ls-toggle" type="button">Start</button>
+                        </div>
+                        <div class="devices-camera-stage ls-stage" id="devices-ls-stage">
+                            <img class="devices-camera-img" id="devices-ls-img" alt="lightsheet live frame">
+                            <div class="devices-camera-placeholder" id="devices-ls-placeholder">
+                                <div class="devices-camera-placeholder-icon">
+                                    <svg viewBox="0 0 24 24" width="28" height="28" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round">
+                                        <path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7Z"/>
+                                        <circle cx="12" cy="12" r="3"/>
+                                    </svg>
+                                </div>
+                                <div class="devices-camera-placeholder-text">Stream off</div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- RIGHT: control rail -->
+                    <div class="ls-rail">
+
+                        <!-- Exposure -->
+                        <div class="ls-group">
+                            <label class="ls-label" for="devices-ls-exposure">Exposure</label>
+                            <div class="ls-row">
+                                <input class="ls-number" id="devices-ls-exposure" type="number"
+                                       min="1" max="5000" step="1" value="50"
+                                       inputmode="numeric" aria-label="Exposure time in milliseconds">
+                                <span class="ls-unit">ms</span>
+                            </div>
+                        </div>
+
+                        <!-- Galvo -->
+                        <div class="ls-group">
+                            <label class="ls-label" for="devices-ls-galvo">Galvo</label>
+                            <div class="ls-slider-row">
+                                <input class="ls-slider" id="devices-ls-galvo-slider" type="range"
+                                       min="-5" max="5" step="0.05" value="0" aria-label="Galvo angle">
+                                <input class="ls-number ls-number-sm" id="devices-ls-galvo" type="number"
+                                       min="-5" max="5" step="0.05" value="0" inputmode="decimal">
+                                <span class="ls-unit">°</span>
+                            </div>
+                        </div>
+
+                        <!-- Piezo -->
+                        <div class="ls-group">
+                            <label class="ls-label" for="devices-ls-piezo">Piezo Z</label>
+                            <div class="ls-slider-row">
+                                <input class="ls-slider" id="devices-ls-piezo-slider" type="range"
+                                       min="0" max="200" step="0.5" value="50" aria-label="Piezo Z position">
+                                <input class="ls-number ls-number-sm" id="devices-ls-piezo" type="number"
+                                       min="0" max="200" step="0.5" value="50" inputmode="decimal">
+                                <span class="ls-unit">µm</span>
+                            </div>
+                        </div>
+
+                        <!-- Illumination -->
+                        <div class="ls-group">
+                            <span class="ls-label">Illumination</span>
+                            <div class="ls-btn-row">
+                                <button class="ls-illum-btn" id="devices-ls-led-open" type="button"
+                                        title="LED group preset: Open">LED Open</button>
+                                <button class="ls-illum-btn" id="devices-ls-led-closed" type="button"
+                                        title="LED group preset: Closed">LED Closed</button>
+                            </div>
+                            <div class="ls-btn-row">
+                                <button class="ls-illum-btn" id="devices-ls-cam-led" type="button"
+                                        title="Toggle camera LED mode" aria-pressed="false">Cam LED</button>
+                                <button class="ls-illum-btn" id="devices-ls-room-light-btn" type="button"
+                                        title="Toggle room light" aria-pressed="false">Room Light</button>
+                            </div>
+                            <div class="ls-laser-indicator">
+                                <span class="ls-laser-dot"></span>
+                                Laser: <span>OFF (brightfield)</span>
+                            </div>
+                        </div>
+
+                        <!-- Temperature -->
+                        <div class="ls-group">
+                            <label class="ls-label">Temperature</label>
+                            <div class="ls-row">
+                                <input class="ls-number" id="devices-ls-temp-input" type="number"
+                                       min="0" max="99.9" step="0.1" inputmode="decimal"
+                                       placeholder="°C" aria-label="Temperature setpoint">
+                                <button class="ls-set-btn" id="devices-ls-temp-set" type="button">Set</button>
+                            </div>
+                            <div id="devices-ls-tempgraph" class="ls-tempgraph"></div>
+                        </div>
+
+                        <!-- Acquire -->
+                        <div class="ls-group">
+                            <span class="ls-label">Acquire</span>
+                            <div class="ls-btn-row">
+                                <button class="ls-acquire-btn" id="devices-ls-snap-volume"
+                                        type="button" title="Acquire a single volume">Snap Volume</button>
+                                <button class="ls-acquire-btn" id="devices-ls-burst"
+                                        type="button" title="Acquire a burst of frames">Burst</button>
+                            </div>
+                            <div class="ls-lastcap" id="devices-ls-lastcap" hidden>
+                                <span class="ls-lastcap-label">Last acquired</span>
+                                <span class="ls-lastcap-ref" id="devices-ls-lastcap-ref">—</span>
+                            </div>
+                        </div>
+
+                    </div><!-- /.ls-rail -->
+                </div><!-- /.ls-layout -->
+            </div><!-- /#devices-view-manual -->
         </div>
     </div>
 

From c69c1aefab842b2c7fb83cc116afed91c0300a96 Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 28 Jun 2026 08:44:57 +0100
Subject: [PATCH 186/314] Restore dependencies accidentally stripped in 2be3587
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Commit 2be3587 ("mypy: clear gently library modules") silently deleted
every entry from [project.dependencies], all [project.optional-dependencies]
extras (sam, torch-gpu, torch-cpu, device), the entire [dependency-groups]
dev group (pytest, ruff, pre-commit, mypy), and the project classifiers —
leaving only the explanatory comments. The commit message mentions none of
this; it was an unintended edit.

With the dependency lists empty, `uv sync` installs nothing, so the project
cannot be installed or run and mypy can only ever see Any-typed third-party
imports. Restores all stripped entries verbatim from 2be3587^ (the only
intended pyproject change on this branch remains the removal of the
[[tool.mypy.overrides]] block).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 pyproject.toml | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index d9802f71..0ae5a358 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -15,18 +15,41 @@ authors = [
     {name = "Kesavan Subburam", email = "pskeshu@gmail.com"},
 ]
 classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Bio-Informatics",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
 ]
 
 dependencies = [
+    "anthropic>=0.39.0",
+    "fastapi>=0.104.0",
+    "uvicorn[standard]>=0.24.0",
+    "aiohttp>=3.9.0",
     # numpy capped <2: pymmcore 10.1.1.70.6 is a C-extension built against the
     # numpy 1.x ABI and fails to import under numpy 2.x. The wheel declares no
     # upper bound, so we enforce it here.
+    "numpy>=1.24.0,<2",
+    "pillow>=10.0.0",
+    "tifffile>=2023.0.0",
+    "scipy>=1.10.0",
+    "scikit-image>=0.21.0",
+    "jinja2>=3.1.0",
+    "pyyaml>=6.0",
+    "matplotlib>=3.7.0",
+    "python-dotenv>=1.0.0",
     # Perception harness — installed as an editable sibling clone (see
     # [tool.uv.sources]); clone gently-project/gently-perception next to this repo.
+    "gently-perception",
     # Device control.
     # pymmcore pinned exactly: its MMCore must match the device-interface version
     # (70) of the Micro-Manager device adapters installed on the microscope PC.
     # Bumping this requires upgrading the MM adapter install in lockstep.
+    "pymmcore==10.1.1.70.6",
+    "bluesky>=1.11.0",
+    "ophyd>=1.9.0",
     # NOTE: torch / torchvision / nvidia-ml-py are NOT base deps — CUDA build is
     # machine-specific. Install via an extra: `uv sync --extra torch-gpu` (CUDA
     # 11.8) or `uv sync --extra torch-cpu`. All torch imports are lazy/guarded.
@@ -35,6 +58,7 @@ dependencies = [
 
 [project.optional-dependencies]
 sam = [
+    "segment-anything",
 ]
 # PyTorch — CUDA build is per-machine, so it lives in mutually-exclusive extras
 # wired to dedicated indexes below (see [tool.uv.sources] / [[tool.uv.index]]).
@@ -44,23 +68,36 @@ sam = [
 # and only need a recent NVIDIA driver, so the same build runs across GPU machines
 # regardless of their system CUDA version.
 torch-gpu = [
+    "torch>=2.0.0",
+    "torchvision>=0.15.0",
+    "nvidia-ml-py>=12.0.0",
 ]
 torch-cpu = [
+    "torch>=2.0.0",
+    "torchvision>=0.15.0",
 ]
 # Device-layer accessories for the microscope computer. Core hardware-control
 # deps (pymmcore, bluesky, ophyd) are already in [project.dependencies]; these
 # are the extras the device layer needs: BLE (SwitchBot room light), serial and
 # MQTT transports (ACUITYnano thermal controller). Install: uv sync --extra device
 device = [
+    "bleak>=0.21.0",
+    "pyserial>=3.5",
+    "paho-mqtt>=1.6.0",
 ]
 
 # Test/dev tooling — installed by `uv sync` (uv enables the `dev` group by
 # default) but excluded from gently's published runtime requirements.
 [dependency-groups]
 dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "ruff>=0.4.0",
+    "pre-commit>=3.7.0",
     # Pinned so local runs, the pre-commit hook, and CI all use the same
     # mypy. Keep in sync with the mirrors-mypy rev in .pre-commit-config.yaml
     # and the install step in .github/workflows/lint.yml.
+    "mypy==2.1.0",
 ]
 
 [project.scripts]

From 37f9156c196b1c9e91f2f2823dd795abcde8ab7b Mon Sep 17 00:00:00 2001
From: subindevs <36504048+subindevs@users.noreply.github.com>
Date: Sun, 28 Jun 2026 08:51:23 +0100
Subject: [PATCH 187/314] ci: add deps-installed mypy job (non-blocking)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The existing mypy step runs deps-less (pip install mypy only), so with
ignore_missing_imports every third-party import is Any and real type
mismatches stay hidden — `mypy .` reports clean against the weaker check.

Adds a separate mypy-strict job that installs the project via uv (cloning
the gently-perception sibling first, as [tool.uv.sources] requires) and runs
`uv run mypy .` with real stubs present. This is the check contributors get
locally per CONTRIBUTING.md and catches genuine mismatches the deps-less run
cannot.

Marked continue-on-error for now: the deps-installed run still surfaces
errors the deps-less baseline hid, and isolating it in its own job keeps the
heavy uv/sibling setup from breaking the required lint gate. Flip to a
required gate once it is clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .github/workflows/lint.yml | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index d11c7f22..dc6a9056 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -25,10 +25,43 @@ jobs:
       - name: ruff format check
         run: ruff format --check .
 
+      # Fast baseline mypy without project deps. With ignore_missing_imports,
+      # third-party imports fall back to Any, so this is the weaker check — kept
+      # as the required gate because it needs no heavy install and stays green.
+      # The stronger, deps-installed run lives in the mypy-strict job below.
       # Pin to match the pre-commit mirrors-mypy rev and the pyproject dev
       # group so CI, local commits, and `uv sync` never run different mypys.
       - name: Install mypy
         run: pip install mypy==2.1.0
 
-      - name: mypy
+      - name: mypy (deps-less)
         run: mypy .
+
+  # Deps-installed mypy: with the real third-party packages present (numpy,
+  # anthropic, …) mypy resolves their actual types instead of Any, surfacing
+  # genuine mismatches the deps-less run above cannot see. This is what a
+  # contributor gets from `uv run mypy .` after `uv sync` (see CONTRIBUTING.md).
+  # Non-blocking for now (continue-on-error) while the remaining deps-only
+  # errors are worked through — flip this to a required gate once it is clean.
+  mypy-strict:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+
+      # gently-perception is not on PyPI; it is installed editable from a sibling
+      # clone (see [tool.uv.sources]), so `uv sync` fails without it.
+      - name: Clone gently-perception sibling
+        run: git clone --depth 1 https://github.com/gently-project/gently-perception.git ../gently-perception
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.10"
+          enable-cache: true
+
+      - name: uv sync
+        run: uv sync
+
+      - name: mypy (deps-installed)
+        run: uv run mypy .

From c749223234217d0f0deda365ee750f93347f91be Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 13:21:51 +0530
Subject: [PATCH 188/314] fix(manual-mode): init temperature graph per-view in
 switchView (singleton dual-init)

---
 gently/ui/web/static/js/devices.js | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 57aa3bd0..13237d4e 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -1714,12 +1714,6 @@ const DevicesManager = (function () {
             ClientEventBus.on('LIGHTSHEET_FRAME', handleLightsheetFrame);
         }
 
-        // Embed temperature graph in the rail
-        const _lsTgEl = document.getElementById('devices-ls-tempgraph');
-        if (_lsTgEl && window.TemperatureGraph) {
-            TemperatureGraph.init(_lsTgEl, 'current');
-        }
-
         syncInitialLightsheetState();
     }
 
@@ -1937,6 +1931,19 @@ const DevicesManager = (function () {
         if (viewName === 'optical3d' && typeof Occupancy3DManager !== 'undefined') {
             Occupancy3DManager.init();
         }
+        // Initialize temperature graph for the active view. The TemperatureGraph
+        // is a singleton; reinit on view switch ensures only one graph target
+        // is live at a time. ClientEventBus.off/on in TemperatureGraph.init
+        // makes re-init safe (idempotent).
+        if (window.TemperatureGraph) {
+            if (viewName === 'manual') {
+                const el = document.getElementById('devices-ls-tempgraph');
+                if (el) TemperatureGraph.init(el, 'current');
+            } else {
+                const el = document.getElementById('devices-temp-graph');
+                if (el) TemperatureGraph.init(el, 'current');
+            }
+        }
     }
 
     function setupViewSwitcher() {
@@ -1986,8 +1993,6 @@ const DevicesManager = (function () {
         setupManualWiring();
         setupRoomLight();
         setupTemperature();
-        const _tgEl = document.getElementById('devices-temp-graph');
-        if (_tgEl && window.TemperatureGraph) TemperatureGraph.init(_tgEl, 'current');
         loadCoverslip();
         loadEmbryosSnapshot();
         switchView(_currentView);

From 5e12b60667f80e27e8137d8470ef55169081663c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 13:25:26 +0530
Subject: [PATCH 189/314] docs(manual-mode): lightsheet FPS measurement
 protocol + transport decision gate (B1 Task 7)

---
 .../2026-06-28-lightsheet-fps-measurement.md  | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 docs/superpowers/notes/2026-06-28-lightsheet-fps-measurement.md

diff --git a/docs/superpowers/notes/2026-06-28-lightsheet-fps-measurement.md b/docs/superpowers/notes/2026-06-28-lightsheet-fps-measurement.md
new file mode 100644
index 00000000..d1a4abd9
--- /dev/null
+++ b/docs/superpowers/notes/2026-06-28-lightsheet-fps-measurement.md
@@ -0,0 +1,57 @@
+# Lightsheet live-view FPS measurement + transport decision (B1 Task 7)
+
+Status: **deferred to the rig** — the numbers below must be filled in on the microscope
+(the streamer needs the real `pymmcore` core, SPIM camera, and rpyc transport; it cannot run
+on the Linux dev box). This file is the measurement protocol + the decision gate.
+
+## What to measure
+
+With the Manual view open and lightsheet live running, record three rates:
+
+| Metric | Where to read it |
+|---|---|
+| **device grab rate** (frames peeked/encoded /s) | device-layer log / instrument `_lightsheet_streamer` |
+| **delivered rate** (frames broadcast /s) | device-layer `_broadcast_lightsheet` |
+| **browser paint rate** | the Manual-view FPS readout (`computeLightsheetFps`) |
+
+Record at two resolution/quality settings:
+- default **512 px / JPEG q70** (`_ls_target_max_dim=512`, `_ls_jpeg_quality=70`)
+- reduced **384 px / q60**
+
+Note the exposure used (the peek floor is `max(exposure, 1/30 s)`).
+
+## Target
+
+**≥ ~15 fps usable for focus** (stretch 25–30), end-to-end latency < ~150 ms.
+
+## Diagnosis rule (the gate)
+
+- **device grab < target** → limiter is exposure / readout / rpyc, **not** transport. Tune
+  exposure, the 512 px size, and JPEG quality. A binary transport path will NOT help — stop here.
+- **device grab ≥ target but browser paint < target** → transport is the bottleneck → build the
+  **binary WebSocket path** (below).
+
+## Conditional escalation — binary WebSocket path
+
+Only if the diagnosis points to transport. The current path is base64-JPEG-in-JSON over SSE →
+EventBus → `ConnectionManager.broadcast` (`json.dumps` + `send_text`) — `connection_manager.py`
+has **no `send_bytes` path** (confirmed). Escalation, on the **agent→browser hop** (where cost
+multiplies per client):
+
+- push raw JPEG bytes via `websocket.send_bytes(prefix + jpeg)` (a 1-byte type tag identifies a
+  lightsheet frame), bypassing **base64 (+33%)**, the **per-client `json.dumps`**, and the
+  **EventBus fan-out**;
+- browser `onmessage` (binary) → `createImageBitmap(new Blob([buf]))` → `ctx.drawImage`;
+- the device→agent SSE stays as-is (single consumer = the monitor, so its base64 cost is paid
+  once, not per browser).
+
+Re-measure after building; record the before/after numbers here.
+
+## Results (fill in on the rig)
+
+| setting | device grab fps | delivered fps | browser paint fps | exposure | notes |
+|---|---|---|---|---|---|
+| 512px/q70 | _TBD_ | _TBD_ | _TBD_ | _TBD_ | |
+| 384px/q60 | _TBD_ | _TBD_ | _TBD_ | _TBD_ | |
+
+Decision: _TBD (transport bottleneck? build binary path Y/N)_

From 779e6c68d5a6392f74e2b528b39ff7926ace6963 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 13:54:32 +0530
Subject: [PATCH 190/314] fix(manual-mode): brightfield-safe +
 focal-plane-correct acquire, sequence-stop on kickoff, park-guard
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

C1: DiSPIMVolumeScanner.trigger() stops any running camera sequence before
startSequenceAcquisition — prevents MMCore collision when live streamer is
active (covers both acquire_single_volume_plan and burst_plan callers).

park-guard: _park_lightsheet_sync now fires set_spim_state("Idle") once per
stream session (not per frame) and calls setPosition only when the value
changed. Cuts 4 serial round-trips per frame to 0 on steady state.
_stop_lightsheet_sequence_sync resets the guard flags.

I1: acquire/burst + acquire/volume proxy routes forward optional laser_config
from body → client. JS runLightsheetAcquire sends laser_config:"ALL OFF" in
both bodies (brightfield-safe Manual-view acquire).

I2: proxy routes forward optional piezo_center + galvo_center; JS sends
piezo_center:_lsPiezo and galvo_center:_lsGalvo (galvo confirmed degrees via
sa_offset_y / configure_y_axis chain — same unit as live param).

I3: new setLaserOff() helper calls POST /api/devices/laser/off and updates
#devices-ls-laser-status from real API result. Called on switchView('manual')
and on toggleLightsheetStream start path.

exposure: _lsExposure default and HTML input value aligned to 20 ms (matches
device-layer _ls_params default).

Tests: 4 new proxy tests for laser_config+focal-plane forwarding; streamer
_make_dl seeds _ls_parked/_ls_spim_idle. All 22 target tests pass.
---
 gently/hardware/dispim/device_layer.py        | 47 ++++++++++++++-----
 gently/hardware/dispim/devices/acquisition.py |  8 ++++
 gently/ui/web/routes/data.py                  | 34 +++++++++++++-
 gently/ui/web/static/js/devices.js            | 35 ++++++++++++--
 gently/ui/web/templates/index.html            |  4 +-
 tests/test_lightsheet_routes.py               | 35 ++++++++++++++
 tests/test_lightsheet_streamer.py             |  3 ++
 7 files changed, 148 insertions(+), 18 deletions(-)

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 6dc97dbb..0e44ebfa 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -177,6 +177,8 @@ def __init__(
         self._ls_params: dict = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0}
         self._ls_seq_started: bool = False
         self._ls_applied: dict = {}                  # last-applied galvo/piezo/exposure
+        self._ls_parked: dict = {}                   # last-parked galvo/piezo setPosition values
+        self._ls_spim_idle: bool = False             # whether SPIM state machine was set Idle this session
 
         # Plans that hold MMCore for long performance-critical work.
         # Anything in this set runs with state polling paused.
@@ -977,22 +979,41 @@ async def _broadcast_camera(self, payload: dict[str, Any]):
     # =========================================================================
 
     def _park_lightsheet_sync(self) -> None:
-        """Park scanner galvo + imaging piezo at the current live params (static sheet)."""
+        """Park scanner galvo + imaging piezo at the current live params (static sheet).
+
+        Guards:
+        - set_spim_state("Idle") fires once per stream session, not per frame
+          (4 serial round-trips on first call → 0 on every subsequent frame).
+        - setPosition fires only when the commanded value differs from the
+          last-applied value (no-op on steady-state frames).
+        """
         p = self._ls_params
         scanner = self.devices.get("scanner")
         piezo = self.devices.get("piezo")
+        # SPIM Idle state machine: drive both devices Idle once per session.
+        if not self._ls_spim_idle:
+            if scanner is not None:
+                try:
+                    scanner.set_spim_state("Idle")
+                except Exception:
+                    pass
+            if piezo is not None:
+                try:
+                    piezo.set_spim_state("Idle")
+                except Exception:
+                    pass
+            self._ls_spim_idle = True
+        # setPosition only when the value changed from last-applied.
         if scanner is not None:
-            try:
-                scanner.set_spim_state("Idle")
-            except Exception:
-                pass
-            scanner.sa_offset_y.setPosition(float(p["galvo"]))
+            want = float(p["galvo"])
+            if self._ls_parked.get("galvo") != want:
+                scanner.sa_offset_y.setPosition(want)
+                self._ls_parked["galvo"] = want
         if piezo is not None:
-            try:
-                piezo.set_spim_state("Idle")
-            except Exception:
-                pass
-            piezo.setPosition(float(p["piezo"]))
+            want = float(p["piezo"])
+            if self._ls_parked.get("piezo") != want:
+                piezo.setPosition(want)
+                self._ls_parked["piezo"] = want
 
     def _ensure_lightsheet_sequence_sync(self) -> None:
         """Start (or restart on exposure change) the continuous sequence on the SPIM camera."""
@@ -1044,6 +1065,10 @@ def _stop_lightsheet_sequence_sync(self) -> None:
             logger.debug("stop lightsheet sequence failed", exc_info=True)
         self._ls_seq_started = False
         self._ls_applied = {}
+        # Reset park guard so the next stream session re-idles the state
+        # machine and re-parks the axes (hardware may have moved).
+        self._ls_spim_idle = False
+        self._ls_parked = {}
 
     async def _lightsheet_streamer(self):
         logger.info("Lightsheet streamer started")
diff --git a/gently/hardware/dispim/devices/acquisition.py b/gently/hardware/dispim/devices/acquisition.py
index 9b2658ef..fda839d1 100644
--- a/gently/hardware/dispim/devices/acquisition.py
+++ b/gently/hardware/dispim/devices/acquisition.py
@@ -188,6 +188,14 @@ def wait():
                 self.core.setConfig(self.laser_control.group_name, self._laser_config)
                 self.core.waitForConfig(self.laser_control.group_name, self._laser_config)
 
+                # Defensive stop: the lightsheet live streamer may have left the
+                # camera in continuous acquisition.  Starting a new sequence on
+                # an already-running camera triggers an MMCore error (and is
+                # thread-unsafe).  Stop cleanly before reconfiguring.
+                if self.core.isSequenceRunning():
+                    self.core.stopSequenceAcquisition()
+                    self.core.waitForDevice(self.camera.name)
+
                 # Prepare circular buffer
                 self.core.clearCircularBuffer()
                 buffer_capacity = self.core.getBufferTotalCapacity()
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 625fb449..cfbeb11c 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -575,16 +575,31 @@ async def stage_move(payload: dict = Body(...)):  # noqa: B008
 
     @router.post("/api/devices/acquire/burst", dependencies=[Depends(require_control)])
     async def acquire_burst(payload: dict = Body(...)):  # noqa: B008
-        """Trigger a burst acquisition. Body: {frames, mode, num_slices, exposure_ms}."""
+        """Trigger a burst acquisition.
+
+        Body: {frames, mode, num_slices, exposure_ms,
+               laser_config?, piezo_center?, galvo_center?}.
+        laser_config is forwarded directly to the device client so callers
+        can send "ALL OFF" for brightfield-safe Manual-view captures.
+        piezo_center and galvo_center capture at the dialled focal plane.
+        """
         client = _resolve_client()
         if client is None:
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
+            kw: dict = {}
+            if payload.get("laser_config") is not None:
+                kw["laser_config"] = str(payload["laser_config"])
+            if payload.get("piezo_center") is not None:
+                kw["piezo_center"] = float(payload["piezo_center"])
+            if payload.get("galvo_center") is not None:
+                kw["galvo_center"] = float(payload["galvo_center"])
             return await client.acquire_burst(
                 frames=int(payload.get("frames", 60)),
                 mode=str(payload.get("mode", "1hz")),
                 num_slices=int(payload.get("num_slices", 1)),
                 exposure_ms=float(payload.get("exposure_ms", 5.0)),
+                **kw,
             )
         except Exception as exc:
             logger.exception("Burst acquisition failed")
@@ -592,14 +607,29 @@ async def acquire_burst(payload: dict = Body(...)):  # noqa: B008
 
     @router.post("/api/devices/acquire/volume", dependencies=[Depends(require_control)])
     async def acquire_volume(payload: dict = Body(...)):  # noqa: B008
-        """Trigger a volume acquisition. Body: {num_slices, exposure_ms}."""
+        """Trigger a volume acquisition.
+
+        Body: {num_slices, exposure_ms,
+               laser_config?, piezo_center?, galvo_center?}.
+        laser_config is forwarded directly to the device client so callers
+        can send "ALL OFF" for brightfield-safe Manual-view captures.
+        piezo_center and galvo_center capture at the dialled focal plane.
+        """
         client = _resolve_client()
         if client is None:
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
+            kw: dict = {}
+            if payload.get("laser_config") is not None:
+                kw["laser_config"] = str(payload["laser_config"])
+            if payload.get("piezo_center") is not None:
+                kw["piezo_center"] = float(payload["piezo_center"])
+            if payload.get("galvo_center") is not None:
+                kw["galvo_center"] = float(payload["galvo_center"])
             return await client.acquire_volume(
                 num_slices=int(payload.get("num_slices", 50)),
                 exposure_ms=float(payload.get("exposure_ms", 10.0)),
+                **kw,
             )
         except Exception as exc:
             logger.exception("Volume acquisition failed")
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 13237d4e..2de449e4 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -90,7 +90,7 @@ const DevicesManager = (function () {
     // Lightsheet live params — debounced POST to /api/devices/lightsheet/live/params
     let _lsGalvo = 0;
     let _lsPiezo = 50;
-    let _lsExposure = 50;
+    let _lsExposure = 20;  // matches device-layer _ls_params default (20 ms)
     let _lsParamTimer = null;
 
     // Lightsheet control inputs (rail)
@@ -98,6 +98,7 @@ const DevicesManager = (function () {
     let _lsLedOpen, _lsLedClosed, _lsCamLed, _lsRoomLightBtn;
     let _lsCamLedOn = false;
     let _lsSnapVolBtn, _lsBurstBtn, _lsLastcap, _lsLastcapRef;
+    let _lsLaserStatus;  // span inside .ls-laser-indicator — driven by actual laser/off calls
     let _lsTempInput, _lsTempSet;
 
     // Room-light toggle (header). Drives the SwitchBot Bot that switches the
@@ -199,6 +200,7 @@ const DevicesManager = (function () {
         _lsBurstBtn      = document.getElementById('devices-ls-burst');
         _lsLastcap       = document.getElementById('devices-ls-lastcap');
         _lsLastcapRef    = document.getElementById('devices-ls-lastcap-ref');
+        _lsLaserStatus   = document.getElementById('devices-ls-laser-status');
         _lsTempInput     = document.getElementById('devices-ls-temp-input');
         _lsTempSet       = document.getElementById('devices-ls-temp-set');
 
@@ -1347,10 +1349,27 @@ const DevicesManager = (function () {
     // Lightsheet live panel (Manual view)
     // =====================================================================
 
+    /** Gate ALL lasers off via the Laser "ALL OFF" config-group preset.
+     *  Updates the indicator span from the actual API result (not a static label).
+     *  Fire-and-forget safe — failure shows a warning, never throws. */
+    async function setLaserOff() {
+        cacheDom();
+        try {
+            const res = await fetch('/api/devices/laser/off', { method: 'POST' });
+            if (_lsLaserStatus) {
+                _lsLaserStatus.textContent = res.ok ? 'OFF (brightfield)' : 'warning: state unknown';
+            }
+        } catch (err) {
+            if (_lsLaserStatus) _lsLaserStatus.textContent = 'warning: state unknown';
+            console.debug('laser off call failed:', err);
+        }
+    }
+
     async function toggleLightsheetStream() {
         if (!_lsToggle) return;
         _lsToggle.disabled = true;
         try {
+            const starting = !_lsStreaming;
             const endpoint = _lsStreaming
                 ? '/api/devices/lightsheet/live/stop'
                 : '/api/devices/lightsheet/live/start';
@@ -1363,6 +1382,8 @@ const DevicesManager = (function () {
             }
             const data = await res.json();
             applyLightsheetState(!!data.streaming);
+            // Gate lasers off whenever live starts — brightfield-safe by default.
+            if (starting && data.streaming) setLaserOff();
         } catch (err) {
             console.error('Lightsheet toggle failed:', err);
             if (_lsMeta) _lsMeta.textContent = `error: ${err}`;
@@ -1627,13 +1648,19 @@ const DevicesManager = (function () {
                     method: 'POST',
                     headers: { 'Content-Type': 'application/json' },
                     body: JSON.stringify({ frames: 10, mode: 'brightfield',
-                                          num_slices: 50, exposure_ms: _lsExposure }),
+                                          num_slices: 50, exposure_ms: _lsExposure,
+                                          laser_config: 'ALL OFF',
+                                          piezo_center: _lsPiezo,
+                                          galvo_center: _lsGalvo }),
                 });
             } else {
                 res = await fetch('/api/devices/acquire/volume', {
                     method: 'POST',
                     headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ num_slices: 50, exposure_ms: _lsExposure }),
+                    body: JSON.stringify({ num_slices: 50, exposure_ms: _lsExposure,
+                                          laser_config: 'ALL OFF',
+                                          piezo_center: _lsPiezo,
+                                          galvo_center: _lsGalvo }),
                 });
             }
             if (!res.ok) {
@@ -1944,6 +1971,8 @@ const DevicesManager = (function () {
                 if (el) TemperatureGraph.init(el, 'current');
             }
         }
+        // Entering Manual view — gate lasers off immediately (brightfield-safe).
+        if (viewName === 'manual') setLaserOff();
     }
 
     function setupViewSwitcher() {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index dc6718c2..1b1dba8e 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -752,7 +752,7 @@ <h3 class="devices-properties-title">Properties</h3>
                             <label class="ls-label" for="devices-ls-exposure">Exposure</label>
                             <div class="ls-row">
                                 <input class="ls-number" id="devices-ls-exposure" type="number"
-                                       min="1" max="5000" step="1" value="50"
+                                       min="1" max="5000" step="1" value="20"
                                        inputmode="numeric" aria-label="Exposure time in milliseconds">
                                 <span class="ls-unit">ms</span>
                             </div>
@@ -799,7 +799,7 @@ <h3 class="devices-properties-title">Properties</h3>
                             </div>
                             <div class="ls-laser-indicator">
                                 <span class="ls-laser-dot"></span>
-                                Laser: <span>OFF (brightfield)</span>
+                                Laser: <span id="devices-ls-laser-status">OFF (brightfield)</span>
                             </div>
                         </div>
 
diff --git a/tests/test_lightsheet_routes.py b/tests/test_lightsheet_routes.py
index 4d3cecd9..0f7f172b 100644
--- a/tests/test_lightsheet_routes.py
+++ b/tests/test_lightsheet_routes.py
@@ -210,6 +210,7 @@ def test_stage_move_missing_xy_400():
 # ---------------------------------------------------------------------------
 
 def test_acquire_burst_forwards():
+    """Basic burst forwards without optional params — no laser_config/piezo/galvo in body."""
     client = MagicMock()
     client.acquire_burst = AsyncMock(return_value={"success": True, "request_id": "b1"})
     r = _app(client=client).post(
@@ -222,11 +223,29 @@ def test_acquire_burst_forwards():
     )
 
 
+def test_acquire_burst_forwards_laser_config_and_focal_plane():
+    """acquire/burst forwards laser_config, piezo_center, galvo_center when present."""
+    client = MagicMock()
+    client.acquire_burst = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post(
+        "/api/devices/acquire/burst",
+        json={"frames": 10, "mode": "brightfield", "num_slices": 50,
+              "exposure_ms": 20.0, "laser_config": "ALL OFF",
+              "piezo_center": 55.0, "galvo_center": 1.5},
+    )
+    assert r.status_code == 200
+    client.acquire_burst.assert_awaited_once_with(
+        frames=10, mode="brightfield", num_slices=50, exposure_ms=20.0,
+        laser_config="ALL OFF", piezo_center=55.0, galvo_center=1.5,
+    )
+
+
 # ---------------------------------------------------------------------------
 # acquire/volume
 # ---------------------------------------------------------------------------
 
 def test_acquire_volume_forwards():
+    """Basic volume forwards without optional params."""
     client = MagicMock()
     client.acquire_volume = AsyncMock(return_value={"success": True, "request_id": "v1"})
     r = _app(client=client).post(
@@ -237,6 +256,22 @@ def test_acquire_volume_forwards():
     client.acquire_volume.assert_awaited_once_with(num_slices=50, exposure_ms=10.0)
 
 
+def test_acquire_volume_forwards_laser_config_and_focal_plane():
+    """acquire/volume forwards laser_config, piezo_center, galvo_center when present."""
+    client = MagicMock()
+    client.acquire_volume = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post(
+        "/api/devices/acquire/volume",
+        json={"num_slices": 50, "exposure_ms": 20.0,
+              "laser_config": "ALL OFF", "piezo_center": 55.0, "galvo_center": 1.5},
+    )
+    assert r.status_code == 200
+    client.acquire_volume.assert_awaited_once_with(
+        num_slices=50, exposure_ms=20.0,
+        laser_config="ALL OFF", piezo_center=55.0, galvo_center=1.5,
+    )
+
+
 # ---------------------------------------------------------------------------
 # require_control gate — 403 WITHOUT override
 # ---------------------------------------------------------------------------
diff --git a/tests/test_lightsheet_streamer.py b/tests/test_lightsheet_streamer.py
index 78b79c4b..c36377a1 100644
--- a/tests/test_lightsheet_streamer.py
+++ b/tests/test_lightsheet_streamer.py
@@ -53,6 +53,9 @@ def _make_dl():
         "scanner": FakeScanner(),
         "piezo": FakePiezo(),
     }
+    # Park-guard state (park-guard fix: these are checked by _park_lightsheet_sync)
+    dl._ls_parked = {}
+    dl._ls_spim_idle = False
     return dl
 
 

From 909aacc6ad4d991f77a3ca3138aece868b5ae3bc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 14:26:46 +0530
Subject: [PATCH 191/314] docs(tactic): spec + plan for temp-change burst
 tactic (C, 6 tasks)

---
 .../2026-06-28-temp-change-burst-tactic.md    | 280 ++++++++++++++++++
 ...6-06-28-temp-change-burst-tactic-design.md | 102 +++++++
 2 files changed, 382 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-28-temp-change-burst-tactic.md
 create mode 100644 docs/superpowers/specs/2026-06-28-temp-change-burst-tactic-design.md

diff --git a/docs/superpowers/plans/2026-06-28-temp-change-burst-tactic.md b/docs/superpowers/plans/2026-06-28-temp-change-burst-tactic.md
new file mode 100644
index 00000000..8c740b3f
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-28-temp-change-burst-tactic.md
@@ -0,0 +1,280 @@
+# Temp-Change Burst Tactic (C) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development. Steps use checkbox (`- [ ]`) syntax.
+
+**Goal:** A scripted temperature-change burst protocol — brightfield bursts before a setpoint change, during the ramp (until lock), and after — launchable as an agent tool, observable on the Experiment tab.
+
+**Architecture:** A thin async `TimelapseOrchestrator.run_temp_change_burst_protocol` driver composing existing `BurstAcquisition` (extended to force lasers off), `set_temperature`/`get_temperature`, and brightfield primitives; new timeline EventTypes so the tactic + setpoint changes render; an agent tool that launches the driver via `asyncio.create_task`.
+
+**Tech Stack:** Python asyncio, the gently EventBus + TimelineManager, pytest (`asyncio_mode=auto`).
+
+## Global Constraints
+- C composes A (temperature stamp/persistence) + B1 (`set_laser_config("ALL OFF")`). No new deps.
+- Brightfield every burst: `laser_config="ALL OFF"`; lasers never left on, even on error/cancel.
+- Lock contract: poll `client.get_temperature()["state"]` until `"LOCKED" in state` (the device reports `'[ SYSTEM LOCKED ]'`).
+- Bursts are temperature-stamped automatically (A) and emit `BURST_START/COMPLETE` (render for free).
+- New EventTypes use `auto()` (wire serializes `.name`).
+- Tests: fakes for client + burst; `asyncio_mode=auto` (no decorator). Rig-deferred: real ramp timing.
+- Git hygiene: stage only your files by explicit path; never `git add -A` (pre-existing untracked screenshots/mockups + uv.lock are not yours).
+
+---
+
+### Task 1: Timeline EventTypes for the tactic
+
+**Files:** Modify `gently/core/event_bus.py` (3 new `auto()` members near the other domain events); Modify `gently/harness/session/timeline.py` (add 3 entries to the EventType→subtype map, near the `BURST_*` entries ~line 213-225). Test: `tests/test_temp_protocol_events.py`.
+
+**Interfaces:** Produces `EventType.TEMPERATURE_SETPOINT_CHANGED`, `EventType.TEMP_PROTOCOL_STARTED`, `EventType.TEMP_PROTOCOL_COMPLETED`, each mapped to a timeline subtype (`setpoint_changed`, `temp_protocol_started`, `temp_protocol_completed`).
+
+- [ ] **Step 1: failing test**
+```python
+# tests/test_temp_protocol_events.py
+from gently.core.event_bus import EventType
+
+def test_new_event_types_exist():
+    for n in ("TEMPERATURE_SETPOINT_CHANGED", "TEMP_PROTOCOL_STARTED", "TEMP_PROTOCOL_COMPLETED"):
+        assert getattr(EventType, n).name == n
+
+def test_timeline_maps_the_subtypes():
+    from gently.harness.session import timeline as tl
+    src = open(tl.__file__, encoding="utf-8").read()
+    for sub in ("temp_protocol_started", "temp_protocol_completed", "setpoint_changed"):
+        assert sub in src
+```
+- [ ] **Step 2: run, expect FAIL** — `pytest tests/test_temp_protocol_events.py -v`
+- [ ] **Step 3: implement** — in `event_bus.py`, alongside the burst events:
+```python
+    TEMPERATURE_SETPOINT_CHANGED = auto()  # discrete setpoint change (timeline)
+    TEMP_PROTOCOL_STARTED = auto()         # temp-change burst protocol began
+    TEMP_PROTOCOL_COMPLETED = auto()       # protocol ended
+```
+In `timeline.py`'s map (mirror the `EventType.BURST_START: {...}` entries), add:
+```python
+        EventType.TEMPERATURE_SETPOINT_CHANGED: {"category": "temperature", "event_subtype": "setpoint_changed"},
+        EventType.TEMP_PROTOCOL_STARTED: {"category": "tactic", "event_subtype": "temp_protocol_started"},
+        EventType.TEMP_PROTOCOL_COMPLETED: {"category": "tactic", "event_subtype": "temp_protocol_completed"},
+```
+> Confirm the real map structure (keys/value shape) from the existing `BURST_START` entry and match it exactly.
+- [ ] **Step 4: run, expect PASS**; `pytest -q` no new failures.
+- [ ] **Step 5: commit** — `git add gently/core/event_bus.py gently/harness/session/timeline.py tests/test_temp_protocol_events.py && git commit -m "feat(tactic): timeline event types for temp-change burst protocol"`
+
+---
+
+### Task 2: Brightfield burst — thread `laser_config`
+
+**Files:** Modify `gently/app/orchestration/exclusive.py` (`BurstAcquisition.__init__` ~line 95 add param; its `client.acquire_burst(...)` call ~line 159-168 pass it); Modify `gently/app/orchestration/timelapse.py` (`queue_burst` ~line 2058 add `laser_config=None`, pass to `BurstAcquisition`). Test: `tests/test_burst_laser_config.py`.
+
+**Interfaces:** Consumes `client.acquire_burst(..., laser_config=...)` (already accepts it, `client.py:642`). Produces `BurstAcquisition(..., laser_config=None)` and `queue_burst(..., laser_config=None)`.
+
+- [ ] **Step 1: failing test**
+```python
+# tests/test_burst_laser_config.py
+import asyncio
+from gently.app.orchestration.exclusive import BurstAcquisition
+
+class FakeClient:
+    def __init__(self): self.calls = []
+    async def acquire_burst(self, **kw): self.calls.append(kw); return {"success": True, "request_id": "b1", "frames": []}
+
+async def test_burst_passes_laser_config(monkeypatch):
+    b = BurstAcquisition("emb1", frames=3, mode="1hz", num_slices=1, laser_config="ALL OFF")
+    assert b._laser_config == "ALL OFF"
+    # the run() path forwards _laser_config into client.acquire_burst kwargs:
+    # (unit-level: assert the attribute + that run threads it — see note)
+```
+> NOTE: `BurstAcquisition.run` needs an orchestrator with a client + embryo lookup + persistence; a full run is heavy. Assert at minimum that `__init__` stores `_laser_config` and that the `acquire_burst` call site in `run` includes `laser_config=self._laser_config` (verify by reading; optionally add a focused test that monkeypatches the embryo/persistence to capture the `acquire_burst` kwargs). Keep the test honest — if a full run is impractical, assert the attribute and add an inline source check that `laser_config=self._laser_config` appears in the `acquire_burst(...)` call.
+- [ ] **Step 2: run, expect FAIL**
+- [ ] **Step 3: implement** — add `laser_config: str | None = None` to `__init__`, store `self._laser_config = laser_config`; in the `client.acquire_burst(...)` call add `laser_config=self._laser_config`. In `queue_burst`, add `laser_config: str | None = None` and pass `laser_config=laser_config` into the `BurstAcquisition(...)` construction.
+- [ ] **Step 4: run, expect PASS**; `pytest -q` clean.
+- [ ] **Step 5: commit** — `feat(tactic): thread laser_config through BurstAcquisition + queue_burst (brightfield bursts)`
+
+---
+
+### Task 3: `wait_for_temperature_lock` helper
+
+**Files:** Create `gently/app/orchestration/temperature_protocol.py` (module for the helper + later the driver). Test: `tests/test_wait_for_lock.py`.
+
+**Interfaces:** Produces `async def wait_for_temperature_lock(client, timeout_s, poll_s=2.0) -> bool`.
+
+- [ ] **Step 1: failing test**
+```python
+# tests/test_wait_for_lock.py
+from gently.app.orchestration.temperature_protocol import wait_for_temperature_lock
+
+class FakeClient:
+    def __init__(self, states): self.states = list(states); self.calls = 0
+    async def get_temperature(self):
+        i = min(self.calls, len(self.states) - 1); self.calls += 1
+        return {"state": self.states[i]}
+
+async def test_returns_true_when_locked():
+    c = FakeClient(["[ IDLE ]", "[ HEATING ]", "[ SYSTEM LOCKED ]"])
+    assert await wait_for_temperature_lock(c, timeout_s=5.0, poll_s=0.001) is True
+
+async def test_returns_false_on_timeout():
+    c = FakeClient(["[ HEATING ]"])
+    assert await wait_for_temperature_lock(c, timeout_s=0.02, poll_s=0.001) is False
+```
+- [ ] **Step 2: run, expect FAIL**
+- [ ] **Step 3: implement**
+```python
+# gently/app/orchestration/temperature_protocol.py
+import asyncio, logging
+logger = logging.getLogger(__name__)
+
+async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.0) -> bool:
+    """Poll the controller until it reports a locked state, or timeout. Substring 'LOCKED'."""
+    loop = asyncio.get_event_loop()
+    t0 = loop.time()
+    while True:
+        try:
+            resp = await client.get_temperature()
+        except Exception as exc:
+            logger.warning("wait_for_temperature_lock poll failed: %s", exc); resp = {}
+        if "LOCKED" in str(resp.get("state", "")):
+            return True
+        if loop.time() - t0 >= timeout_s:
+            return False
+        await asyncio.sleep(poll_s)
+```
+- [ ] **Step 4: run, expect PASS**
+- [ ] **Step 5: commit** — `feat(tactic): wait_for_temperature_lock poll helper`
+
+---
+
+### Task 4: The protocol driver
+
+**Files:** Modify `gently/app/orchestration/temperature_protocol.py` (add the driver fn that takes the orchestrator). Test: `tests/test_temp_protocol_driver.py`.
+
+**Interfaces:** Produces `async def run_temp_change_burst_protocol(orchestrator, embryo_id, target_setpoint_c, *, frames=60, mode="1hz", num_slices=1, bursts_before=1, bursts_after=1, lock_timeout_s=600.0, poll_s=2.0, burst_runner=None) -> dict`. `burst_runner` is an injectable `async (BurstAcquisition)->None` for tests (defaults to `lambda b: b.run(orchestrator)`).
+
+- [ ] **Step 1: failing test**
+```python
+# tests/test_temp_protocol_driver.py
+from gently.app.orchestration.temperature_protocol import run_temp_change_burst_protocol
+from gently.core.event_bus import EventType
+
+class FakeClient:
+    def __init__(self): self.laser=None; self.led=None; self.setpoint=None; self._poll=0
+    async def set_laser_config(self, c): self.laser=c
+    async def set_led(self, s): self.led=s
+    async def set_temperature(self, t): self.setpoint=t
+    async def get_temperature(self):
+        self._poll += 1
+        return {"state": "[ SYSTEM LOCKED ]" if self._poll >= 2 else "[ HEATING ]"}
+
+class FakeOrch:
+    def __init__(self, client): self._client=client; self._temperature_provider=lambda: None; self.events=[]
+    @property
+    def client(self): return self._client
+    def _emit_event(self, et, data): self.events.append((et, data))
+
+async def test_phase_order_and_brightfield(monkeypatch):
+    client = FakeClient(); orch = FakeOrch(client)
+    bursts = []
+    async def runner(b): bursts.append({"phase": getattr(b, "_phase", None), "laser": b._laser_config})
+    res = await run_temp_change_burst_protocol(
+        orch, "emb1", 25.0, frames=3, bursts_before=1, bursts_after=1,
+        lock_timeout_s=5.0, poll_s=0.001, burst_runner=runner)
+    assert client.laser == "ALL OFF" and client.led == "Open"
+    assert client.setpoint == 25.0
+    assert all(b["laser"] == "ALL OFF" for b in bursts)          # every burst brightfield
+    assert len(bursts) >= 3                                       # before + >=1 during + after
+    ets = [e[0] for e in orch.events]
+    assert EventType.TEMP_PROTOCOL_STARTED in ets
+    assert EventType.TEMPERATURE_SETPOINT_CHANGED in ets
+    assert EventType.TEMP_PROTOCOL_COMPLETED in ets
+    assert res["locked"] is True
+```
+- [ ] **Step 2: run, expect FAIL**
+- [ ] **Step 3: implement** — append to `temperature_protocol.py`:
+```python
+from gently.app.orchestration.exclusive import BurstAcquisition
+from gently.core.event_bus import EventType
+
+async def run_temp_change_burst_protocol(orchestrator, embryo_id, target_setpoint_c, *,
+        frames=60, mode="1hz", num_slices=1, bursts_before=1, bursts_after=1,
+        lock_timeout_s=600.0, poll_s=2.0, burst_runner=None):
+    client = orchestrator.client
+    if burst_runner is None:
+        async def burst_runner(b): await b.run(orchestrator)
+
+    async def one_burst(phase):
+        b = BurstAcquisition(embryo_id, frames=frames, mode=mode, num_slices=num_slices,
+                             temperature_provider=getattr(orchestrator, "_temperature_provider", None),
+                             laser_config="ALL OFF")
+        b._phase = phase
+        await burst_runner(b)
+
+    locked = False; error = None; cancelled = False
+    try:
+        await client.set_laser_config("ALL OFF")
+        await client.set_led("Open")
+        orchestrator._emit_event(EventType.TEMP_PROTOCOL_STARTED,
+            {"embryo_id": embryo_id, "target_setpoint_c": target_setpoint_c,
+             "frames": frames, "bursts_before": bursts_before, "bursts_after": bursts_after})
+        for _ in range(bursts_before):
+            await one_burst("before")
+        await client.set_temperature(target_setpoint_c)
+        orchestrator._emit_event(EventType.TEMPERATURE_SETPOINT_CHANGED,
+            {"embryo_id": embryo_id, "to": target_setpoint_c})
+        loop = asyncio.get_event_loop(); t0 = loop.time()
+        while True:
+            await one_burst("during")
+            try:
+                st = str((await client.get_temperature()).get("state", ""))
+            except Exception:
+                st = ""
+            if "LOCKED" in st:
+                locked = True; break
+            if loop.time() - t0 >= lock_timeout_s:
+                break
+        for _ in range(bursts_after):
+            await one_burst("after")
+    except asyncio.CancelledError:
+        cancelled = True; raise
+    except Exception as exc:
+        error = str(exc); logger.exception("temp-change burst protocol failed")
+    finally:
+        orchestrator._emit_event(EventType.TEMP_PROTOCOL_COMPLETED,
+            {"embryo_id": embryo_id, "locked": locked, "cancelled": cancelled, "error": error})
+    return {"locked": locked, "cancelled": cancelled, "error": error}
+```
+- [ ] **Step 4: run, expect PASS**; `pytest -q` clean.
+- [ ] **Step 5: commit** — `feat(tactic): temp-change burst protocol driver (brightfield before/during/after)`
+
+---
+
+### Task 5: Agent tool
+
+**Files:** Create `gently/app/tools/temperature_protocol_tools.py` (or add to an existing tools module — follow the `@tool` pattern). Test: `tests/test_temp_protocol_tool.py`.
+
+**Interfaces:** Produces a `run_temp_change_burst_protocol` agent tool that resolves orchestrator+client from `context`, launches the driver via `asyncio.create_task`, returns a started message; validates embryo/client presence.
+
+- [ ] **Step 1: failing test** — assert the tool, given a context with a fake orchestrator/client, creates a task and returns a "started" string; given no client, returns an error without creating a task.
+> Confirm the real `@tool` decorator + context helpers (`ctx_get(context,"client")`, `require_agent`, `require_timelapse_orchestrator`) from an existing tool (e.g. `gently/app/tools/temperature_tools.py`); mirror them. Write the test to the real registration shape.
+- [ ] **Step 2: run, expect FAIL**
+- [ ] **Step 3: implement** — mirror an existing tool: resolve `orchestrator` + `client`, guard None (return error dict/string), `asyncio.create_task(run_temp_change_burst_protocol(orchestrator, embryo_id, target_setpoint_c, frames=frames, bursts_before=bursts_before, bursts_after=bursts_after))`, return `f"Temp-change burst protocol started for {embryo_id} → {target_setpoint_c} C"`.
+- [ ] **Step 4: run, expect PASS**
+- [ ] **Step 5: commit** — `feat(tactic): run_temp_change_burst_protocol agent tool`
+
+---
+
+### Task 6: Observability in strategy_snapshot
+
+**Files:** Modify `gently/ui/web/strategy_snapshot.py` (`_replay_timeline` ~line 627; mirror the burst-phase handling at ~762/777). Test: `tests/test_temp_protocol_snapshot.py`.
+
+**Interfaces:** Consumes the timeline subtypes (`temp_protocol_started/completed`, `setpoint_changed`). Produces, in the snapshot: a `temp_protocol` band (open on started, close on completed) and a `setpoint_changes` list.
+
+- [ ] **Step 1: failing test** — feed `_replay_timeline` (or `build_strategy_snapshot` over a temp `timeline.jsonl`) a sequence: `temp_protocol_started`, `setpoint_changed(to=25)`, `burst_started/completed`, `temp_protocol_completed`; assert the snapshot exposes a temp_protocol span and a setpoint change of 25.
+> Confirm the real `_replay_timeline` input/output shape from the existing burst handling; match the snapshot dict structure it already produces.
+- [ ] **Step 2: run, expect FAIL**
+- [ ] **Step 3: implement** — in `_replay_timeline`, handle the three subtypes: on `temp_protocol_started` open a band (record start t + params); on `temp_protocol_completed` close it; on `setpoint_changed` append `{t, to}` to a `setpoint_changes` list in the snapshot. Surface them in the returned snapshot dict next to the existing phases.
+- [ ] **Step 4: run, expect PASS**; `pytest -q` clean.
+- [ ] **Step 5: commit** — `feat(tactic): surface temp-protocol band + setpoint changes in strategy snapshot`
+
+---
+
+## Self-Review
+- §2.1 brightfield burst → Task 2; §2.2 wait-for-lock → Task 3; §2.3 driver → Task 4; §2.4 events → Tasks 1 & 6; §2.5 tool → Task 5. ✓
+- Open confirmations (explicit): the timeline map value-shape (Task 1), the burst `run` acquire_burst call site (Task 2), the `@tool` + context helpers (Task 5), the `_replay_timeline` shape (Task 6). Each names a fallback.
+- Type consistency: `laser_config="ALL OFF"` everywhere; event names `TEMPERATURE_SETPOINT_CHANGED`/`TEMP_PROTOCOL_STARTED`/`TEMP_PROTOCOL_COMPLETED` across Tasks 1/4/6; driver returns `{locked,cancelled,error}`.
diff --git a/docs/superpowers/specs/2026-06-28-temp-change-burst-tactic-design.md b/docs/superpowers/specs/2026-06-28-temp-change-burst-tactic-design.md
new file mode 100644
index 00000000..3989a19a
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-28-temp-change-burst-tactic-design.md
@@ -0,0 +1,102 @@
+# Design: Temperature-change burst tactic (sub-project C)
+
+Status: design decided 2026-06-28 (autonomous, from recon; flag any change before the rig run).
+Base branch: off `feature/manual-mode-live-view` (B1) — C composes A's temperature persistence/stamp
+and B1's `set_laser_config("ALL OFF")` brightfield primitive.
+
+## 0. Roadmap context
+
+Track 2, fast-follow to A + B1. C **automates** the hand-driven experiment B1 enables: bursts
+before a temperature setpoint change, bursts during the ramp, bursts after lock — all in
+brightfield (LED, no laser). It is the repeatable form of next week's experiment. The Operations-tab
+observability rework (D) builds on the timeline events C emits.
+
+## 1. Overview
+
+The experiment is a **scripted, wall-clock sequence**, not a reactive rule. Recon confirmed
+gently's `MonitoringMode`s are reactive rule-installers with no timed loop, so C is built as **an
+agent tool that launches an async timed sequence** (a thin `TimelapseOrchestrator` method so it can
+reach `_emit_event` / `queue_burst` / the client), composing primitives that already exist:
+- bursts with temperature-stamped persistence + `BURST_START/COMPLETE` timeline events
+  (`exclusive.py` `BurstAcquisition`),
+- `set_temperature` / `get_temperature` with the `'[ SYSTEM LOCKED ]'` state contract,
+- `set_laser_config("ALL OFF")` + `set_led("Open")` for brightfield.
+
+## 2. What must be built (four units)
+
+### 2.1 Brightfield burst (`laser_config` through the burst op)
+`BurstAcquisition.run` calls `client.acquire_burst(...)` but never passes `laser_config`, so it
+can't force lasers off. Add an optional `laser_config: str | None = None` to
+`BurstAcquisition.__init__` (`exclusive.py`) and thread it into the `acquire_burst(...)` call; add
+`laser_config=None` to `TimelapseOrchestrator.queue_burst(...)` and pass it through. A brightfield
+burst is then `laser_config="ALL OFF"`.
+
+### 2.2 Wait-for-lock helper
+No wait-for-lock exists. Add `async wait_for_temperature_lock(client, timeout_s, poll_s=2.0) -> bool`
+(a small util or orchestrator method): poll `client.get_temperature()` until `"LOCKED" in state`,
+return True; return False on timeout. Substring match on `'[ SYSTEM LOCKED ]'`.
+
+### 2.3 The protocol driver
+`TimelapseOrchestrator.run_temp_change_burst_protocol(self, embryo_id, target_setpoint_c, *,
+frames=60, mode="1hz", num_slices=1, bursts_before=1, bursts_after=1, lock_timeout_s=600.0,
+poll_s=2.0)` — an `async def`:
+1. Brightfield on: `await client.set_laser_config("ALL OFF")`, `await client.set_led("Open")`.
+2. Emit `TEMP_PROTOCOL_STARTED` (embryo, target, params).
+3. **Before:** run `bursts_before` bursts sequentially — construct
+   `BurstAcquisition(embryo_id, frames=frames, mode=mode, num_slices=num_slices,
+   temperature_provider=self._temperature_provider, laser_config="ALL OFF")` and `await burst.run(self)`
+   (direct sequential run — the protocol owns the sequence; no queue contention for a standalone
+   experiment).
+4. **Change setpoint:** `await client.set_temperature(target_setpoint_c)`; emit
+   `TEMPERATURE_SETPOINT_CHANGED` (from, to).
+5. **During:** loop — run one burst, then `await client.get_temperature()`; break when
+   `"LOCKED" in state` or `lock_timeout_s` elapsed (event-loop clock).
+6. **After:** run `bursts_after` bursts.
+7. Emit `TEMP_PROTOCOL_COMPLETED` (counts, final temp).
+Each burst is temperature-stamped automatically (A). Bursts emit `BURST_START/COMPLETE` → render
+for free.
+
+### 2.4 Observability events (timeline)
+Add `EventType.TEMPERATURE_SETPOINT_CHANGED`, `TEMP_PROTOCOL_STARTED`, `TEMP_PROTOCOL_COMPLETED`.
+Map each in `gently/harness/session/timeline.py`'s EventType→subtype map (so they persist to
+`timeline.jsonl`). Handle the subtypes in `strategy_snapshot.py:_replay_timeline` — open a
+`"temp_protocol"` band on STARTED, close on COMPLETED, and record setpoint-change markers — so the
+Experiment/Operations tab shows the tactic. (`TEMPERATURE_UPDATE` stays high-volume/non-persisted;
+only the discrete setpoint *change* is a timeline event.)
+
+### 2.5 Agent tool
+`run_temp_change_burst_protocol(embryo_id, target_setpoint_c, frames=60, bursts_before=1,
+bursts_after=1, context=...)` in `gently/app/tools/` — resolves the orchestrator + client, launches
+the driver via `asyncio.create_task` (the ramp is minutes; don't block the agent turn), returns a
+"protocol started" message. Callable from chat (and later a manual-mode button / Operations tab).
+
+## 3. Data flow
+tool → `asyncio.create_task(orchestrator.run_temp_change_burst_protocol(...))` → brightfield set →
+bursts (BurstAcquisition.run → client.acquire_burst(laser_config="ALL OFF") → persisted under
+`bursts/{id}/` with temperature stamp) → setpoint change (client.set_temperature + sampler records
+`temperature.jsonl`) → poll-until-lock → after-bursts → events to EventBus → `timeline.jsonl` →
+`strategy_snapshot` → Experiment tab.
+
+## 4. Error handling
+- No client / no embryo → tool returns an error, no task launched.
+- A burst failure mid-protocol → log, emit `TEMP_PROTOCOL_COMPLETED` with an `error` field, restore
+  state (lasers already off). Never leave lasers on.
+- Lock never reached → `during` loop exits on `lock_timeout_s`; protocol proceeds to after-bursts and
+  notes `locked=false`.
+- Cancellation (`asyncio.CancelledError`) → stop queuing, emit completion with `cancelled=true`.
+
+## 5. Testing
+- `BurstAcquisition` passes `laser_config` to a fake `acquire_burst` (unit).
+- `wait_for_temperature_lock`: a fake client returning non-locked then locked → True; always
+  non-locked → False on timeout (use a tiny timeout/poll).
+- The driver against fakes (fake client + a `BurstAcquisition.run` patched to a no-op recorder):
+  asserts the phase order (brightfield set → before bursts → setpoint change → during-until-lock →
+  after bursts → completed), the emitted events, and `laser_config="ALL OFF"` on every burst.
+- timeline map + `strategy_snapshot` replay: the three new subtypes open/close a temp_protocol band
+  + setpoint marker.
+- Rig-deferred: the real thermal ramp timing.
+
+## 6. Out of scope
+- The full Operations-tab visual rework (D) — C only emits the events D will render richly.
+- A general user-authored tactic library (G).
+- Manual-mode UI button to launch the protocol (nice follow-up; chat/tool is enough for next week).

From 7ec42d0a8dc1301c009f95fcb415bd89528ca088 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 14:28:14 +0530
Subject: [PATCH 192/314] feat(tactic): timeline event types for temp-change
 burst protocol

Add three EventType members (TEMPERATURE_SETPOINT_CHANGED, TEMP_PROTOCOL_STARTED,
TEMP_PROTOCOL_COMPLETED) to event_bus.py and map them to timeline subtypes in
timeline.py for persistence to timeline.jsonl. Includes unit tests.
---
 gently/core/event_bus.py           |  5 +++++
 gently/harness/session/timeline.py | 18 ++++++++++++++++++
 tests/test_temp_protocol_events.py | 17 +++++++++++++++++
 3 files changed, 40 insertions(+)
 create mode 100644 tests/test_temp_protocol_events.py

diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 9774bdaa..ee89ab7c 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -127,6 +127,11 @@ class EventType(Enum):
     BURST_FRAME = auto()  # {embryo_id, request_id, frame_idx, total_frames}
     BURST_COMPLETE = auto()  # {embryo_id, request_id, mp4_path, sustained_hz, frames_captured}
 
+    # Temperature protocol events (Phase X / 10) — temp-change burst tactic
+    TEMPERATURE_SETPOINT_CHANGED = auto()  # {embryo_id, old_temp, new_temp}
+    TEMP_PROTOCOL_STARTED = auto()  # {embryo_id, protocol_name}
+    TEMP_PROTOCOL_COMPLETED = auto()  # {embryo_id, protocol_name, success}
+
     # Reactive control telemetry (Phase 5 / 10)
     POWER_RAMP_STEP = auto()  # {embryo_id, rule, wavelength, old_pct, new_pct, direction}
 
diff --git a/gently/harness/session/timeline.py b/gently/harness/session/timeline.py
index b0ae7b92..4f227ec3 100644
--- a/gently/harness/session/timeline.py
+++ b/gently/harness/session/timeline.py
@@ -228,6 +228,24 @@ def description(self) -> str:
         "icon": "v",
         "severity": "success",
     },
+    EventType.TEMPERATURE_SETPOINT_CHANGED: {
+        "event_type": "temperature",
+        "event_subtype": "setpoint_changed",
+        "icon": "T",
+        "severity": "info",
+    },
+    EventType.TEMP_PROTOCOL_STARTED: {
+        "event_type": "tactic",
+        "event_subtype": "temp_protocol_started",
+        "icon": "~",
+        "severity": "info",
+    },
+    EventType.TEMP_PROTOCOL_COMPLETED: {
+        "event_type": "tactic",
+        "event_subtype": "temp_protocol_completed",
+        "icon": "+",
+        "severity": "success",
+    },
 }
 
 
diff --git a/tests/test_temp_protocol_events.py b/tests/test_temp_protocol_events.py
new file mode 100644
index 00000000..7344a985
--- /dev/null
+++ b/tests/test_temp_protocol_events.py
@@ -0,0 +1,17 @@
+"""Test for temperature protocol event types (Task 1 of temp-change-burst-tactic)"""
+
+from gently.core.event_bus import EventType
+
+
+def test_new_event_types_exist():
+    """Verify the three new EventType members exist"""
+    for n in ("TEMPERATURE_SETPOINT_CHANGED", "TEMP_PROTOCOL_STARTED", "TEMP_PROTOCOL_COMPLETED"):
+        assert getattr(EventType, n).name == n
+
+
+def test_timeline_maps_the_subtypes():
+    """Verify timeline.py contains the mapping entries with correct subtypes"""
+    from gently.harness.session import timeline as tl
+    src = open(tl.__file__, encoding="utf-8").read()
+    for sub in ("temp_protocol_started", "temp_protocol_completed", "setpoint_changed"):
+        assert sub in src

From 5412c3067daffdcde02977dea7c7c7589ebc8710 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 14:54:28 +0530
Subject: [PATCH 193/314] feat(tactic): thread laser_config through
 BurstAcquisition + queue_burst (brightfield bursts)

---
 gently/app/orchestration/exclusive.py |  3 +++
 gently/app/orchestration/timelapse.py |  2 ++
 tests/test_burst_laser_config.py      | 23 +++++++++++++++++++++++
 3 files changed, 28 insertions(+)
 create mode 100644 tests/test_burst_laser_config.py

diff --git a/gently/app/orchestration/exclusive.py b/gently/app/orchestration/exclusive.py
index 83b196d7..b741e57d 100644
--- a/gently/app/orchestration/exclusive.py
+++ b/gently/app/orchestration/exclusive.py
@@ -101,12 +101,14 @@ def __init__(
         num_slices: int = 1,
         request_id: str | None = None,
         temperature_provider=None,
+        laser_config: str | None = None,
     ):
         super().__init__(target_embryo_id=target_embryo_id, request_id=request_id)
         self.frames = frames
         self.mode = mode if mode in ("1hz", "asap") else "1hz"
         self.num_slices = num_slices
         self._temperature_provider = temperature_provider
+        self._laser_config = laser_config
 
     async def run(self, orchestrator) -> ExclusiveResult:
         from gently.core import EventType
@@ -166,6 +168,7 @@ async def run(self, orchestrator) -> ExclusiveResult:
                 piezo_amplitude=piezo_amplitude,
                 piezo_center=piezo_center,
                 laser_power_488_pct=getattr(embryo, "laser_power_488_pct", None),
+                laser_config=self._laser_config,
             )
         except Exception as e:
             logger.error("Burst failed for %s: %s", self.target_embryo_id, e)
diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index 5918bd9c..c640f926 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -2061,6 +2061,7 @@ def queue_burst(
         mode: str = "1hz",
         num_slices: int = 1,
         force: bool = False,
+        laser_config: str | None = None,
     ) -> str:
         """Queue a burst acquisition for ``embryo_id``.
 
@@ -2100,6 +2101,7 @@ def queue_burst(
             mode=mode,
             num_slices=num_slices,
             temperature_provider=self._temperature_provider,
+            laser_config=laser_config,
         )
         self._exclusive_queue.append(op)
         logger.info(
diff --git a/tests/test_burst_laser_config.py b/tests/test_burst_laser_config.py
new file mode 100644
index 00000000..9e973715
--- /dev/null
+++ b/tests/test_burst_laser_config.py
@@ -0,0 +1,23 @@
+"""Task 2: BurstAcquisition laser_config threading tests."""
+import asyncio
+import pytest
+from gently.app.orchestration.exclusive import BurstAcquisition
+
+
+class FakeClient:
+    def __init__(self):
+        self.calls = []
+
+    async def acquire_burst(self, **kw):
+        self.calls.append(kw)
+        return {"success": True, "request_id": "b1", "frames": []}
+
+
+async def test_burst_passes_laser_config(monkeypatch):
+    b = BurstAcquisition("emb1", frames=3, mode="1hz", num_slices=1, laser_config="ALL OFF")
+    assert b._laser_config == "ALL OFF"
+
+
+async def test_burst_laser_config_default_none():
+    b = BurstAcquisition("emb1", frames=3, mode="1hz", num_slices=1)
+    assert b._laser_config is None

From 030a4434491dfd72ca7e9f89ecd40d3535edc587 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 15:04:41 +0530
Subject: [PATCH 194/314] feat(tactic): wait_for_temperature_lock poll helper

---
 .../app/orchestration/temperature_protocol.py   | 17 +++++++++++++++++
 tests/test_wait_for_lock.py                     | 15 +++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 gently/app/orchestration/temperature_protocol.py
 create mode 100644 tests/test_wait_for_lock.py

diff --git a/gently/app/orchestration/temperature_protocol.py b/gently/app/orchestration/temperature_protocol.py
new file mode 100644
index 00000000..d3bc25c2
--- /dev/null
+++ b/gently/app/orchestration/temperature_protocol.py
@@ -0,0 +1,17 @@
+import asyncio, logging
+logger = logging.getLogger(__name__)
+
+async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.0) -> bool:
+    """Poll the controller until it reports a locked state, or timeout. Substring 'LOCKED'."""
+    loop = asyncio.get_event_loop()
+    t0 = loop.time()
+    while True:
+        try:
+            resp = await client.get_temperature()
+        except Exception as exc:
+            logger.warning("wait_for_temperature_lock poll failed: %s", exc); resp = {}
+        if "LOCKED" in str(resp.get("state", "")):
+            return True
+        if loop.time() - t0 >= timeout_s:
+            return False
+        await asyncio.sleep(poll_s)
diff --git a/tests/test_wait_for_lock.py b/tests/test_wait_for_lock.py
new file mode 100644
index 00000000..6ee8fbe3
--- /dev/null
+++ b/tests/test_wait_for_lock.py
@@ -0,0 +1,15 @@
+from gently.app.orchestration.temperature_protocol import wait_for_temperature_lock
+
+class FakeClient:
+    def __init__(self, states): self.states = list(states); self.calls = 0
+    async def get_temperature(self):
+        i = min(self.calls, len(self.states) - 1); self.calls += 1
+        return {"state": self.states[i]}
+
+async def test_returns_true_when_locked():
+    c = FakeClient(["[ IDLE ]", "[ HEATING ]", "[ SYSTEM LOCKED ]"])
+    assert await wait_for_temperature_lock(c, timeout_s=5.0, poll_s=0.001) is True
+
+async def test_returns_false_on_timeout():
+    c = FakeClient(["[ HEATING ]"])
+    assert await wait_for_temperature_lock(c, timeout_s=0.02, poll_s=0.001) is False

From 28abaa1fede1cdcac1230aeeff11a113bc2b23cc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 15:14:40 +0530
Subject: [PATCH 195/314] feat(tactic): temp-change burst protocol driver
 (brightfield before/during/after)

---
 .../app/orchestration/temperature_protocol.py | 52 +++++++++++++++++++
 tests/test_temp_protocol_driver.py            | 39 ++++++++++++++
 2 files changed, 91 insertions(+)
 create mode 100644 tests/test_temp_protocol_driver.py

diff --git a/gently/app/orchestration/temperature_protocol.py b/gently/app/orchestration/temperature_protocol.py
index d3bc25c2..60058133 100644
--- a/gently/app/orchestration/temperature_protocol.py
+++ b/gently/app/orchestration/temperature_protocol.py
@@ -1,4 +1,6 @@
 import asyncio, logging
+from gently.app.orchestration.exclusive import BurstAcquisition
+from gently.core.event_bus import EventType
 logger = logging.getLogger(__name__)
 
 async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.0) -> bool:
@@ -15,3 +17,53 @@ async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.
         if loop.time() - t0 >= timeout_s:
             return False
         await asyncio.sleep(poll_s)
+
+
+async def run_temp_change_burst_protocol(orchestrator, embryo_id, target_setpoint_c, *,
+        frames=60, mode="1hz", num_slices=1, bursts_before=1, bursts_after=1,
+        lock_timeout_s=600.0, poll_s=2.0, burst_runner=None):
+    """Scripted temp-change burst protocol: brightfield before/during/after a setpoint change."""
+    client = orchestrator.client
+    if burst_runner is None:
+        async def burst_runner(b): await b.run(orchestrator)
+
+    async def one_burst(phase):
+        b = BurstAcquisition(embryo_id, frames=frames, mode=mode, num_slices=num_slices,
+                             temperature_provider=getattr(orchestrator, "_temperature_provider", None),
+                             laser_config="ALL OFF")
+        b._phase = phase
+        await burst_runner(b)
+
+    locked = False; error = None; cancelled = False
+    try:
+        await client.set_laser_config("ALL OFF")
+        await client.set_led("Open")
+        orchestrator._emit_event(EventType.TEMP_PROTOCOL_STARTED,
+            {"embryo_id": embryo_id, "target_setpoint_c": target_setpoint_c,
+             "frames": frames, "bursts_before": bursts_before, "bursts_after": bursts_after})
+        for _ in range(bursts_before):
+            await one_burst("before")
+        await client.set_temperature(target_setpoint_c)
+        orchestrator._emit_event(EventType.TEMPERATURE_SETPOINT_CHANGED,
+            {"embryo_id": embryo_id, "to": target_setpoint_c})
+        loop = asyncio.get_event_loop(); t0 = loop.time()
+        while True:
+            await one_burst("during")
+            try:
+                st = str((await client.get_temperature()).get("state", ""))
+            except Exception:
+                st = ""
+            if "LOCKED" in st:
+                locked = True; break
+            if loop.time() - t0 >= lock_timeout_s:
+                break
+        for _ in range(bursts_after):
+            await one_burst("after")
+    except asyncio.CancelledError:
+        cancelled = True; raise
+    except Exception as exc:
+        error = str(exc); logger.exception("temp-change burst protocol failed")
+    finally:
+        orchestrator._emit_event(EventType.TEMP_PROTOCOL_COMPLETED,
+            {"embryo_id": embryo_id, "locked": locked, "cancelled": cancelled, "error": error})
+    return {"locked": locked, "cancelled": cancelled, "error": error}
diff --git a/tests/test_temp_protocol_driver.py b/tests/test_temp_protocol_driver.py
new file mode 100644
index 00000000..b2cdb62d
--- /dev/null
+++ b/tests/test_temp_protocol_driver.py
@@ -0,0 +1,39 @@
+import pytest
+from gently.app.orchestration.temperature_protocol import run_temp_change_burst_protocol
+from gently.core.event_bus import EventType
+
+
+class FakeClient:
+    def __init__(self): self.laser=None; self.led=None; self.setpoint=None; self._poll=0
+    async def set_laser_config(self, c): self.laser=c
+    async def set_led(self, s): self.led=s
+    async def set_temperature(self, t): self.setpoint=t
+    async def get_temperature(self):
+        self._poll += 1
+        return {"state": "[ SYSTEM LOCKED ]" if self._poll >= 2 else "[ HEATING ]"}
+
+
+class FakeOrch:
+    def __init__(self, client): self._client=client; self._temperature_provider=lambda: None; self.events=[]
+    @property
+    def client(self): return self._client
+    def _emit_event(self, et, data): self.events.append((et, data))
+
+
+@pytest.mark.asyncio
+async def test_phase_order_and_brightfield(monkeypatch):
+    client = FakeClient(); orch = FakeOrch(client)
+    bursts = []
+    async def runner(b): bursts.append({"phase": getattr(b, "_phase", None), "laser": b._laser_config})
+    res = await run_temp_change_burst_protocol(
+        orch, "emb1", 25.0, frames=3, bursts_before=1, bursts_after=1,
+        lock_timeout_s=5.0, poll_s=0.001, burst_runner=runner)
+    assert client.laser == "ALL OFF" and client.led == "Open"
+    assert client.setpoint == 25.0
+    assert all(b["laser"] == "ALL OFF" for b in bursts)          # every burst brightfield
+    assert len(bursts) >= 3                                       # before + >=1 during + after
+    ets = [e[0] for e in orch.events]
+    assert EventType.TEMP_PROTOCOL_STARTED in ets
+    assert EventType.TEMPERATURE_SETPOINT_CHANGED in ets
+    assert EventType.TEMP_PROTOCOL_COMPLETED in ets
+    assert res["locked"] is True

From 6af4396f22a310b91f0b0ca6672dcfc387ccda61 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 15:23:28 +0530
Subject: [PATCH 196/314] feat(tactic): run_temp_change_burst_protocol agent
 tool

Adds temperature_protocol_tools.py with the @tool-decorated
run_temp_change_burst_protocol_tool: resolves agent/orchestrator/client
from context, guards all three (returns error strings if absent), then
launches the driver via asyncio.create_task so the thermal ramp runs in
the background and the agent turn returns immediately. Registered in
tools/__init__.py. TDD: 5 tests covering happy path (task created +
started message), no-client, no-orchestrator, no-agent, and registry
discoverability.
---
 gently/app/tools/__init__.py                  |   2 +
 .../app/tools/temperature_protocol_tools.py   |  94 ++++++++++
 tests/test_temp_protocol_tool.py              | 174 ++++++++++++++++++
 3 files changed, 270 insertions(+)
 create mode 100644 gently/app/tools/temperature_protocol_tools.py
 create mode 100644 tests/test_temp_protocol_tool.py

diff --git a/gently/app/tools/__init__.py b/gently/app/tools/__init__.py
index d8ab70db..16d7aebb 100644
--- a/gently/app/tools/__init__.py
+++ b/gently/app/tools/__init__.py
@@ -42,6 +42,7 @@
     resolution_tools,
     session_tools,
     stage_tools,
+    temperature_protocol_tools,
     temperature_tools,
     timelapse_tools,
     volume_tools,
@@ -88,6 +89,7 @@ def register_all_tools():
     "resolution_tools",
     "session_tools",
     "stage_tools",
+    "temperature_protocol_tools",
     "temperature_tools",
     "timelapse_tools",
     "volume_tools",
diff --git a/gently/app/tools/temperature_protocol_tools.py b/gently/app/tools/temperature_protocol_tools.py
new file mode 100644
index 00000000..dd25d2d5
--- /dev/null
+++ b/gently/app/tools/temperature_protocol_tools.py
@@ -0,0 +1,94 @@
+"""
+Temperature Protocol Tools
+
+Agent tool for the scripted temp-change burst protocol. The thermal ramp takes
+several minutes so the driver runs as a background asyncio task — the agent turn
+returns immediately with a "started" confirmation.
+"""
+
+import asyncio
+
+from gently.harness.tools.helpers import ctx_get, require_agent, require_microscope, require_timelapse_orchestrator
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
+
+
+@tool(
+    name="run_temp_change_burst_protocol",
+    description=(
+        "Start a scripted temperature-change burst protocol in the background. "
+        "Acquires brightfield burst(s) before the setpoint change, then polls the "
+        "thermal controller — imaging continuously during the ramp — and acquires "
+        "burst(s) after lock is reached. "
+        "The thermal ramp typically takes several minutes; this tool returns "
+        "immediately and the protocol runs as a background task. "
+        "Use when you want time-resolved brightfield data spanning a temperature "
+        "transition (e.g. cold-shock → recovery, 15 C → 25 C developmental-rate shift)."
+    ),
+    category=ToolCategory.EXPERIMENT,
+    requires_microscope=True,
+    examples=[
+        ToolExample(
+            "Capture a temperature shift from 15 C to 25 C for embryo_1",
+            {"embryo_id": "embryo_1", "target_setpoint_c": 25.0},
+        ),
+        ToolExample(
+            "Cold-shock embryo_2 to 15 C with 2 bursts before and after",
+            {"embryo_id": "embryo_2", "target_setpoint_c": 15.0, "bursts_before": 2, "bursts_after": 2},
+        ),
+    ],
+)
+async def run_temp_change_burst_protocol_tool(
+    embryo_id: str,
+    target_setpoint_c: float,
+    frames: int = 60,
+    bursts_before: int = 1,
+    bursts_after: int = 1,
+    context: dict | None = None,
+) -> str:
+    """Launch the temp-change burst driver as a background asyncio task.
+
+    Parameters
+    ----------
+    embryo_id : str
+        ID of the embryo to image during the temperature transition.
+    target_setpoint_c : float
+        Target temperature setpoint in degrees Celsius.
+    frames : int
+        Number of frames per burst acquisition (default 60).
+    bursts_before : int
+        Number of brightfield bursts to capture before the setpoint change (default 1).
+    bursts_after : int
+        Number of brightfield bursts to capture after the controller locks (default 1).
+    """
+    agent, err = require_agent(context)
+    if err:
+        return err
+
+    orchestrator, err = require_timelapse_orchestrator(agent)
+    if err:
+        return err
+
+    client, err = require_microscope(context)
+    if err:
+        return err
+
+    from gently.app.orchestration.temperature_protocol import (
+        run_temp_change_burst_protocol as _driver,
+    )
+
+    asyncio.create_task(
+        _driver(
+            orchestrator,
+            embryo_id,
+            target_setpoint_c,
+            frames=frames,
+            bursts_before=bursts_before,
+            bursts_after=bursts_after,
+        )
+    )
+
+    return (
+        f"Temp-change burst protocol started for {embryo_id} → {target_setpoint_c} C "
+        f"({bursts_before} burst(s) before, {bursts_after} burst(s) after lock). "
+        f"Running in background — use get_temperature to monitor ramp progress."
+    )
diff --git a/tests/test_temp_protocol_tool.py b/tests/test_temp_protocol_tool.py
new file mode 100644
index 00000000..a992f5d9
--- /dev/null
+++ b/tests/test_temp_protocol_tool.py
@@ -0,0 +1,174 @@
+"""
+Tests for the run_temp_change_burst_protocol agent tool (Task 5).
+
+TDD: write failing tests first, then implement the tool.
+"""
+
+import asyncio
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# Fakes
+# ---------------------------------------------------------------------------
+
+
+class FakeClient:
+    """Minimal fake microscope client."""
+    async def set_temperature(self, t):
+        return {"success": True, "temperature_c": t, "state": "[ HEATING ]"}
+
+    async def get_temperature(self):
+        return {"success": True, "temperature_c": 20.0, "state": "[ SYSTEM LOCKED ]"}
+
+
+class FakeOrchestrator:
+    """Minimal fake timelapse orchestrator with a client attribute."""
+    def __init__(self, client):
+        self.client = client
+
+    def _emit_event(self, *args, **kwargs):
+        pass
+
+
+class FakeAgent:
+    """Minimal fake agent — carries timelapse_orchestrator."""
+    def __init__(self, orchestrator):
+        self.timelapse_orchestrator = orchestrator
+
+
+def _make_context(*, with_client=True, with_orchestrator=True):
+    """Build a fake context dict."""
+    client = FakeClient() if with_client else None
+    orchestrator = FakeOrchestrator(client) if with_orchestrator else None
+    agent = FakeAgent(orchestrator) if with_orchestrator else FakeAgent(None)
+    return {"agent": agent, "client": client}
+
+
+# ---------------------------------------------------------------------------
+# Tests
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_tool_creates_task_and_returns_started():
+    """Happy path: context has agent+orchestrator+client → task is created, 'started' returned."""
+    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
+
+    context = _make_context(with_client=True, with_orchestrator=True)
+    created_tasks = []
+
+    def fake_create_task(coro, **kwargs):
+        # Cancel the coroutine immediately so there's no dangling task
+        coro.close()
+        mock_task = MagicMock()
+        created_tasks.append(mock_task)
+        return mock_task
+
+    with patch("asyncio.create_task", side_effect=fake_create_task):
+        result = await run_temp_change_burst_protocol_tool(
+            embryo_id="emb1",
+            target_setpoint_c=25.0,
+            frames=30,
+            bursts_before=1,
+            bursts_after=1,
+            context=context,
+        )
+
+    assert len(created_tasks) == 1, "Expected exactly one asyncio task to be created"
+    assert "started" in result.lower(), f"Expected 'started' in result, got: {result!r}"
+    assert "emb1" in result, f"Expected embryo_id in result, got: {result!r}"
+    assert "25.0" in result or "25" in result, f"Expected setpoint in result, got: {result!r}"
+
+
+@pytest.mark.asyncio
+async def test_tool_no_client_returns_error_no_task():
+    """No client in context → returns error string, no asyncio task created."""
+    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
+
+    context = _make_context(with_client=False, with_orchestrator=True)
+    created_tasks = []
+
+    def fake_create_task(coro, **kwargs):
+        coro.close()
+        mock_task = MagicMock()
+        created_tasks.append(mock_task)
+        return mock_task
+
+    with patch("asyncio.create_task", side_effect=fake_create_task):
+        result = await run_temp_change_burst_protocol_tool(
+            embryo_id="emb1",
+            target_setpoint_c=25.0,
+            context=context,
+        )
+
+    assert len(created_tasks) == 0, "No task should be created when client is absent"
+    assert "error" in result.lower() or "not connected" in result.lower(), (
+        f"Expected error message, got: {result!r}"
+    )
+
+
+@pytest.mark.asyncio
+async def test_tool_no_orchestrator_returns_error_no_task():
+    """No timelapse orchestrator → returns error string, no asyncio task created."""
+    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
+
+    context = _make_context(with_client=True, with_orchestrator=False)
+    created_tasks = []
+
+    def fake_create_task(coro, **kwargs):
+        coro.close()
+        mock_task = MagicMock()
+        created_tasks.append(mock_task)
+        return mock_task
+
+    with patch("asyncio.create_task", side_effect=fake_create_task):
+        result = await run_temp_change_burst_protocol_tool(
+            embryo_id="emb1",
+            target_setpoint_c=25.0,
+            context=context,
+        )
+
+    assert len(created_tasks) == 0, "No task should be created when orchestrator is absent"
+    assert "error" in result.lower() or "not initialized" in result.lower(), (
+        f"Expected error message, got: {result!r}"
+    )
+
+
+@pytest.mark.asyncio
+async def test_tool_no_agent_context_returns_error():
+    """No agent in context → returns error immediately."""
+    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
+
+    context = {"client": FakeClient()}  # no "agent" key
+    created_tasks = []
+
+    def fake_create_task(coro, **kwargs):
+        coro.close()
+        mock_task = MagicMock()
+        created_tasks.append(mock_task)
+        return mock_task
+
+    with patch("asyncio.create_task", side_effect=fake_create_task):
+        result = await run_temp_change_burst_protocol_tool(
+            embryo_id="emb1",
+            target_setpoint_c=25.0,
+            context=context,
+        )
+
+    assert len(created_tasks) == 0
+    assert "error" in result.lower(), f"Expected error message, got: {result!r}"
+
+
+def test_tool_is_registered():
+    """The tool should be discoverable in the global tool registry after package import."""
+    import gently.app.tools  # noqa: F401 — triggers registration
+    from gently.harness.tools.registry import get_tool_registry
+
+    registry = get_tool_registry()
+    tool_names = [t.name for t in registry.list_all()]
+    assert "run_temp_change_burst_protocol" in tool_names, (
+        f"Tool not found in registry. Registered tools: {tool_names}"
+    )

From c986c92fd5262c74c9311dfa208cfdb31327a3c5 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 15:47:15 +0530
Subject: [PATCH 197/314] feat(tactic): surface temp-protocol band + setpoint
 changes in strategy snapshot

Initialize temp_protocol (None) and setpoint_changes ([]) on every embryo
dict in _build_embryos_static. In _replay_timeline, handle the three new
subtypes from Task 1: temp_protocol_started opens a band (start + params),
temp_protocol_completed closes it (end), setpoint_changed appends {t, to}
to the list. Bursts continue to render as burst phases unchanged.
---
 gently/ui/web/strategy_snapshot.py   |  25 ++++
 tests/test_temp_protocol_snapshot.py | 190 +++++++++++++++++++++++++++
 2 files changed, 215 insertions(+)
 create mode 100644 tests/test_temp_protocol_snapshot.py

diff --git a/gently/ui/web/strategy_snapshot.py b/gently/ui/web/strategy_snapshot.py
index 91c560e7..4948ae9b 100644
--- a/gently/ui/web/strategy_snapshot.py
+++ b/gently/ui/web/strategy_snapshot.py
@@ -552,6 +552,9 @@ def _build_embryos_static(
                 ],
                 "trigger_events": [],
                 "power_history_488": [{"at": 0.0, "pct": float(laser_488)}],
+                # Filled in by _replay_timeline when temperature-tactic events arrive.
+                "temp_protocol": None,
+                "setpoint_changes": [],
                 # Filled in by _project_forward.
                 "projected_cadence_s": initial_cadence,
                 "projected_end_s": None,
@@ -782,6 +785,28 @@ def _replay_timeline(
             # closed at now_offset_s by the tail pass below.
             _close_open_phase(emb, at_s)
 
+        elif subtype == "temp_protocol_started" and embryo_id in by_id:
+            emb = by_id[embryo_id]
+            emb["temp_protocol"] = {
+                "start": at_s,
+                "end": None,
+                "target_setpoint_c": data.get("target_setpoint_c"),
+                "frames": data.get("frames"),
+                "bursts_before": data.get("bursts_before"),
+                "bursts_after": data.get("bursts_after"),
+            }
+
+        elif subtype == "temp_protocol_completed" and embryo_id in by_id:
+            emb = by_id[embryo_id]
+            tp = emb.get("temp_protocol")
+            if tp is not None:
+                tp["end"] = at_s
+
+        elif subtype == "setpoint_changed" and embryo_id in by_id:
+            emb = by_id[embryo_id]
+            to_val = data.get("to")
+            emb["setpoint_changes"].append({"t": at_s, "to": to_val})
+
         elif subtype == "stopped":
             # Session-level stop: close every open phase at this time.
             for emb in embryo_dicts:
diff --git a/tests/test_temp_protocol_snapshot.py b/tests/test_temp_protocol_snapshot.py
new file mode 100644
index 00000000..574940fe
--- /dev/null
+++ b/tests/test_temp_protocol_snapshot.py
@@ -0,0 +1,190 @@
+"""Task 6: temp-protocol band + setpoint changes visible in strategy_snapshot.
+
+Feed _replay_timeline (via build_strategy_snapshot over a hand-written
+timeline.jsonl) a sequence:
+  temp_protocol_started → setpoint_changed(to=25) →
+  burst_started → burst_completed → temp_protocol_completed
+
+Assert the returned snapshot exposes:
+  embryos[0]["temp_protocol"]  — a band with start < end, correct params
+  embryos[0]["setpoint_changes"]  — [{t: ..., to: 25}]
+"""
+
+import json
+from datetime import datetime, timedelta
+from pathlib import Path
+
+import pytest
+import yaml
+
+from gently.ui.web.strategy_snapshot import build_strategy_snapshot
+
+SESSION_ID = "sess-tp1"
+EMBRYO_ID = "e1"
+STARTED_AT = datetime(2025, 1, 1, 10, 0, 0)
+TARGET_C = 25.0
+
+
+def _ts(delta_s: float) -> str:
+    return (STARTED_AT + timedelta(seconds=delta_s)).isoformat()
+
+
+def _write_session(session_dir: Path) -> None:
+    session_dir.mkdir(parents=True, exist_ok=True)
+
+    # Minimal session.yaml
+    (session_dir / "session.yaml").write_text(
+        yaml.dump({"name": "temp-protocol test"}), encoding="utf-8"
+    )
+
+    # timelapse.yaml — minimal; one embryo
+    timelapse = {
+        "started_at": STARTED_AT.isoformat(),
+        "base_interval_seconds": 120,
+        "embryos": {
+            EMBRYO_ID: {"interval_seconds": 120},
+        },
+    }
+    (session_dir / "timelapse.yaml").write_text(
+        yaml.dump(timelapse), encoding="utf-8"
+    )
+
+    # timeline.jsonl — the sequence under test
+    events = [
+        {
+            "event_id": "ev-tps",
+            "event_type": "tactic",
+            "event_subtype": "temp_protocol_started",
+            "timestamp": _ts(10),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {
+                "embryo_id": EMBRYO_ID,
+                "target_setpoint_c": TARGET_C,
+                "frames": 60,
+                "bursts_before": 1,
+                "bursts_after": 1,
+            },
+        },
+        {
+            "event_id": "ev-sc",
+            "event_type": "temperature",
+            "event_subtype": "setpoint_changed",
+            "timestamp": _ts(20),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID, "to": TARGET_C},
+        },
+        {
+            "event_id": "ev-bs",
+            "event_type": "timelapse",
+            "event_subtype": "burst_started",
+            "timestamp": _ts(30),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID, "mode": "1hz", "frames": 60},
+        },
+        {
+            "event_id": "ev-bc",
+            "event_type": "timelapse",
+            "event_subtype": "burst_completed",
+            "timestamp": _ts(40),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID},
+        },
+        {
+            "event_id": "ev-tpc",
+            "event_type": "tactic",
+            "event_subtype": "temp_protocol_completed",
+            "timestamp": _ts(50),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID, "locked": True, "cancelled": False, "error": None},
+        },
+    ]
+    timeline_path = session_dir / "timeline.jsonl"
+    with open(timeline_path, "w", encoding="utf-8") as f:
+        for ev in events:
+            f.write(json.dumps(ev) + "\n")
+
+
+# ---------------------------------------------------------------------------
+# Tests
+# ---------------------------------------------------------------------------
+
+
+def test_temp_protocol_band_present(tmp_path: Path) -> None:
+    """Snapshot exposes a temp_protocol band with start and end on the embryo."""
+    session_dir = tmp_path / "sessions" / "20250101_1000_test"
+    _write_session(session_dir)
+
+    snap = build_strategy_snapshot(session_dir, SESSION_ID)
+
+    assert snap["embryos"], "no embryos in snapshot"
+    emb = snap["embryos"][0]
+
+    tp = emb.get("temp_protocol")
+    assert tp is not None, "temp_protocol key missing from embryo"
+    assert tp["start"] == pytest.approx(10.0), f"expected start=10s, got {tp['start']}"
+    assert tp["end"] == pytest.approx(50.0), f"expected end=50s, got {tp['end']}"
+    assert tp["target_setpoint_c"] == pytest.approx(TARGET_C)
+
+
+def test_setpoint_changes_recorded(tmp_path: Path) -> None:
+    """Snapshot exposes setpoint_changes list with one entry {t, to}."""
+    session_dir = tmp_path / "sessions" / "20250101_1000_test"
+    _write_session(session_dir)
+
+    snap = build_strategy_snapshot(session_dir, SESSION_ID)
+
+    emb = snap["embryos"][0]
+    sc = emb.get("setpoint_changes")
+    assert sc is not None, "setpoint_changes key missing from embryo"
+    assert len(sc) == 1, f"expected 1 setpoint change, got {len(sc)}"
+    assert sc[0]["t"] == pytest.approx(20.0)
+    assert sc[0]["to"] == pytest.approx(TARGET_C)
+
+
+def test_burst_phase_still_present(tmp_path: Path) -> None:
+    """Existing burst phase handling is not disrupted by temp-protocol events."""
+    session_dir = tmp_path / "sessions" / "20250101_1000_test"
+    _write_session(session_dir)
+
+    snap = build_strategy_snapshot(session_dir, SESSION_ID)
+
+    emb = snap["embryos"][0]
+    burst_phases = [p for p in emb["phases"] if p.get("mode") == "burst"]
+    assert burst_phases, "burst phase disappeared after temp-protocol changes"
+    bp = burst_phases[0]
+    assert bp["start"] == pytest.approx(30.0)
+    # end is extended to now_offset_s by the tail-close sweep when no
+    # cadence_changed follows — just confirm it's set and >= burst start
+    assert bp["end"] is not None and bp["end"] >= 30.0
+
+
+def test_temp_protocol_fields_initialized_even_without_events(tmp_path: Path) -> None:
+    """Embryo dicts always have temp_protocol and setpoint_changes, even with no events."""
+    session_dir = tmp_path / "sessions" / "20250101_1000_empty"
+    session_dir.mkdir(parents=True, exist_ok=True)
+    (session_dir / "session.yaml").write_text("{}", encoding="utf-8")
+    timelapse = {
+        "started_at": STARTED_AT.isoformat(),
+        "base_interval_seconds": 120,
+        "embryos": {EMBRYO_ID: {"interval_seconds": 120}},
+    }
+    (session_dir / "timelapse.yaml").write_text(yaml.dump(timelapse), encoding="utf-8")
+    # No timeline.jsonl
+
+    snap = build_strategy_snapshot(session_dir, SESSION_ID)
+
+    emb = snap["embryos"][0]
+    assert "temp_protocol" in emb, "temp_protocol key absent with no events"
+    assert "setpoint_changes" in emb, "setpoint_changes key absent with no events"
+    assert emb["temp_protocol"] is None
+    assert emb["setpoint_changes"] == []

From dc0387251da3314792a0901741b92f424b9e6c4b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 16:13:31 +0530
Subject: [PATCH 198/314] fix(tactic): correct event docstrings, guard against
 concurrent timelapse, harden driver test

- event_bus.py: fix TEMPERATURE_SETPOINT_CHANGED/TEMP_PROTOCOL_STARTED/TEMP_PROTOCOL_COMPLETED
  inline comments to match actual emitted payloads ({embryo_id,to} / {embryo_id,target_setpoint_c,
  frames,bursts_before,bursts_after} / {embryo_id,locked,cancelled,error})
- temperature_protocol_tools.py: refuse to launch if orchestrator._status == TimelapseStatus.RUNNING
  (would contend with timelapse RunEngine); returns clear refusal string, no task created
- test_temp_protocol_driver.py: assert burst phase sequence (first=="before", last=="after") and
  event order (STARTED < SETPOINT_CHANGED < COMPLETED)
- test_temp_protocol_tool.py: add test_tool_refuses_during_active_timelapse for the guard
---
 .../app/tools/temperature_protocol_tools.py   |  7 +++++
 gently/core/event_bus.py                      |  6 ++--
 tests/test_temp_protocol_driver.py            | 12 ++++++++
 tests/test_temp_protocol_tool.py              | 30 +++++++++++++++++++
 4 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/gently/app/tools/temperature_protocol_tools.py b/gently/app/tools/temperature_protocol_tools.py
index dd25d2d5..678b08b8 100644
--- a/gently/app/tools/temperature_protocol_tools.py
+++ b/gently/app/tools/temperature_protocol_tools.py
@@ -75,6 +75,13 @@ async def run_temp_change_burst_protocol_tool(
     from gently.app.orchestration.temperature_protocol import (
         run_temp_change_burst_protocol as _driver,
     )
+    from gently.app.orchestration.timelapse_models import TimelapseStatus
+
+    if getattr(orchestrator, "_status", None) == TimelapseStatus.RUNNING:
+        return (
+            "Refusing to start temp-change protocol: a timelapse is currently running "
+            "(would contend for the RunEngine). Stop the timelapse first."
+        )
 
     asyncio.create_task(
         _driver(
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index ee89ab7c..0b5db1cd 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -128,9 +128,9 @@ class EventType(Enum):
     BURST_COMPLETE = auto()  # {embryo_id, request_id, mp4_path, sustained_hz, frames_captured}
 
     # Temperature protocol events (Phase X / 10) — temp-change burst tactic
-    TEMPERATURE_SETPOINT_CHANGED = auto()  # {embryo_id, old_temp, new_temp}
-    TEMP_PROTOCOL_STARTED = auto()  # {embryo_id, protocol_name}
-    TEMP_PROTOCOL_COMPLETED = auto()  # {embryo_id, protocol_name, success}
+    TEMPERATURE_SETPOINT_CHANGED = auto()  # {embryo_id, to}
+    TEMP_PROTOCOL_STARTED = auto()  # {embryo_id, target_setpoint_c, frames, bursts_before, bursts_after}
+    TEMP_PROTOCOL_COMPLETED = auto()  # {embryo_id, locked, cancelled, error}
 
     # Reactive control telemetry (Phase 5 / 10)
     POWER_RAMP_STEP = auto()  # {embryo_id, rule, wavelength, old_pct, new_pct, direction}
diff --git a/tests/test_temp_protocol_driver.py b/tests/test_temp_protocol_driver.py
index b2cdb62d..aa112f03 100644
--- a/tests/test_temp_protocol_driver.py
+++ b/tests/test_temp_protocol_driver.py
@@ -37,3 +37,15 @@ async def runner(b): bursts.append({"phase": getattr(b, "_phase", None), "laser"
     assert EventType.TEMPERATURE_SETPOINT_CHANGED in ets
     assert EventType.TEMP_PROTOCOL_COMPLETED in ets
     assert res["locked"] is True
+
+    # Phase order: first burst must be "before", last must be "after"
+    phases = [b["phase"] for b in bursts]
+    assert phases[0] == "before", f"Expected first burst phase 'before', got {phases[0]!r}"
+    assert phases[-1] == "after", f"Expected last burst phase 'after', got {phases[-1]!r}"
+
+    # Event order: STARTED < SETPOINT_CHANGED < COMPLETED
+    idx_started = ets.index(EventType.TEMP_PROTOCOL_STARTED)
+    idx_changed = ets.index(EventType.TEMPERATURE_SETPOINT_CHANGED)
+    idx_completed = ets.index(EventType.TEMP_PROTOCOL_COMPLETED)
+    assert idx_started < idx_changed, "TEMP_PROTOCOL_STARTED must precede TEMPERATURE_SETPOINT_CHANGED"
+    assert idx_changed < idx_completed, "TEMPERATURE_SETPOINT_CHANGED must precede TEMP_PROTOCOL_COMPLETED"
diff --git a/tests/test_temp_protocol_tool.py b/tests/test_temp_protocol_tool.py
index a992f5d9..519c4375 100644
--- a/tests/test_temp_protocol_tool.py
+++ b/tests/test_temp_protocol_tool.py
@@ -172,3 +172,33 @@ def test_tool_is_registered():
     assert "run_temp_change_burst_protocol" in tool_names, (
         f"Tool not found in registry. Registered tools: {tool_names}"
     )
+
+
+@pytest.mark.asyncio
+async def test_tool_refuses_during_active_timelapse():
+    """If orchestrator._status == RUNNING, refuse without creating a task."""
+    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
+    from gently.app.orchestration.timelapse_models import TimelapseStatus
+
+    context = _make_context(with_client=True, with_orchestrator=True)
+    # Simulate an active timelapse
+    context["agent"].timelapse_orchestrator._status = TimelapseStatus.RUNNING
+
+    created_tasks = []
+
+    def fake_create_task(coro, **kwargs):
+        coro.close()
+        mock_task = MagicMock()
+        created_tasks.append(mock_task)
+        return mock_task
+
+    with patch("asyncio.create_task", side_effect=fake_create_task):
+        result = await run_temp_change_burst_protocol_tool(
+            embryo_id="emb1",
+            target_setpoint_c=25.0,
+            context=context,
+        )
+
+    assert len(created_tasks) == 0, "No task should be created when timelapse is running"
+    assert "refusing" in result.lower(), f"Expected refusal message, got: {result!r}"
+    assert "timelapse" in result.lower(), f"Expected 'timelapse' in refusal message, got: {result!r}"

From 59c429ab8393cbdeb1777fce2bce92a72d511ad8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 16:34:41 +0530
Subject: [PATCH 199/314] docs(operations): spec + plan for Operations tab (D,
 4 tasks)

---
 .../plans/2026-06-28-operations-tab.md        | 103 ++++++++++++++++++
 .../specs/2026-06-28-operations-tab-design.md |  84 ++++++++++++++
 2 files changed, 187 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-28-operations-tab.md
 create mode 100644 docs/superpowers/specs/2026-06-28-operations-tab-design.md

diff --git a/docs/superpowers/plans/2026-06-28-operations-tab.md b/docs/superpowers/plans/2026-06-28-operations-tab.md
new file mode 100644
index 00000000..8ce94846
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-28-operations-tab.md
@@ -0,0 +1,103 @@
+# Operations Tab (D) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development. Steps use checkbox (`- [ ]`) syntax.
+
+**Goal:** Make the composed temp-change tactic observable: rename Experiment→Operations, render the protocol band + setpoint markers + phased bursts on the swimlane, and make the tab refresh live.
+
+**Architecture:** Reuse `GET /api/experiments/{session}/strategy` (C added `temp_protocol` + `setpoint_changes` per-embryo). One backend enabler (emit burst `phase`), the rest is `experiment-overview.js` rendering + live event subscriptions.
+
+**Tech Stack:** vanilla-JS + hand-rolled SVG (`experiment-overview.js`), the EventBus→websocket relay, pytest for the small backend bit.
+
+## Global Constraints
+- No new endpoints; reuse `/strategy`. C owns the snapshot builder; D consumes its fields.
+- Snapshot fields (per-embryo, from C Task 6): `temp_protocol: {start, end, target_setpoint_c, frames, bursts_before, bursts_after} | None`, `setpoint_changes: [{t, to}]`.
+- Rename is label-only (`index.html:119` nav text, `:393` `<h2>`); leave ids + `TABS.EXPERIMENT` unchanged.
+- Tactic name is a frontend constant keyed off `temp_protocol` (events carry no name).
+- Build against the REAL emitter payloads, not the stale enum docstrings.
+- Live: subscribe via `ClientEventBus.on(...)` (mirror `experiment-strip.js:23`), debounced (~500ms) `loadStrategy()`+`render()`. Relay already emits all events by `.name` — no backend change.
+- Frontend: no JS unit harness → `node --check` + Chrome-MCP harness + UI audit; live rig verification deferred.
+- Git hygiene: stage only your files by explicit path; never `git add -A`.
+
+---
+
+### Task 1: Rename Experiment → Operations (label-only)
+**Files:** Modify `gently/ui/web/templates/index.html` (nav button text `:119`, `<h2 class="experiment-title">` `:393`). Test: none (pure copy) — verified by `grep`.
+- [ ] **Step 1:** change the nav button text at `:119` from `Experiment` to `Operations`, and the `<h2>` at `:393` from `Experiment` to `Operations`. Leave `data-tab="experiment"`, `#experiment-content`, `#experiment-overview-root`, `TABS.EXPERIMENT` untouched.
+- [ ] **Step 2:** `grep -n ">Operations<" gently/ui/web/templates/index.html` shows both; `grep -n "data-tab=\"experiment\"" ` still present (ids unchanged).
+- [ ] **Step 3: commit** — `git add gently/ui/web/templates/index.html && git commit -m "feat(operations): rename Experiment tab to Operations (label only)"`
+
+---
+
+### Task 2: Emit burst `phase` + record it in the snapshot
+**Files:** Modify `gently/app/orchestration/exclusive.py` (`BurstAcquisition.run` BURST_START emit ~line 127-135 add `phase`); Modify `gently/ui/web/strategy_snapshot.py` (`_replay_timeline` `burst_started` handler ~line 762 record `phase` on the burst phase dict). Test: `tests/test_burst_phase_snapshot.py`.
+
+**Interfaces:** Produces `BURST_START` data with `"phase": getattr(self, "_phase", None)`; snapshot burst phase dict gains `"phase"`.
+
+- [ ] **Step 1: failing test**
+```python
+# tests/test_burst_phase_snapshot.py
+import json, os
+from gently.ui.web.strategy_snapshot import build_strategy_snapshot
+
+def _write(tmp_path, events):
+    sd = tmp_path / "sess"; (sd / "embryos" / "e1").mkdir(parents=True)
+    (sd / "session.yaml").write_text("session_id: s1\nname: t\nstarted_at: '2026-06-28T10:00:00'\n")
+    (sd / "embryos" / "e1" / "embryo.yaml").write_text("embryo_id: e1\nrole: Test\n")
+    with open(sd / "timeline.jsonl", "w") as f:
+        for e in events: f.write(json.dumps(e) + "\n")
+    return sd
+
+def test_burst_phase_recorded(tmp_path):
+    sd = _write(tmp_path, [
+        {"event_subtype": "burst_started", "embryo_id": "e1", "timestamp": "2026-06-28T10:00:10",
+         "data": {"embryo_id": "e1", "frames": 60, "mode": "1hz", "phase": "during"}},
+        {"event_subtype": "burst_completed", "embryo_id": "e1", "timestamp": "2026-06-28T10:01:10",
+         "data": {"embryo_id": "e1"}},
+    ])
+    snap = build_strategy_snapshot(str(sd), "s1")
+    emb = next(e for e in snap["embryos"] if e["id"] == "e1")
+    burst = next(p for p in emb["phases"] if p.get("mode") == "burst")
+    assert burst.get("phase") == "during"
+```
+> Confirm the real `build_strategy_snapshot` session-dir layout + timeline line shape from C Task 6's test (`tests/test_temp_protocol_snapshot.py`) and match it (session.yaml keys, embryo.yaml, timeline event shape). Adapt `_write` to the real shape; keep the `phase` assertion.
+- [ ] **Step 2: run, expect FAIL** (phase is None / key absent)
+- [ ] **Step 3: implement** — in `exclusive.py` `BurstAcquisition.run`, add `"phase": getattr(self, "_phase", None)` to the `BURST_START` event `data` dict. In `strategy_snapshot.py` `burst_started` handler, add `"phase": data.get("phase")` to the appended burst phase dict (next to `frames`/`hz`).
+- [ ] **Step 4: run, expect PASS**; `pytest -q` no new failures.
+- [ ] **Step 5: commit** — `feat(operations): emit burst phase in BURST_START + record in snapshot`
+
+---
+
+### Task 3: Render the tactic band on the swimlane
+**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (`_renderSwimlanes` ~line 332: insert a session-level band; helpers for the protocol pill + setpoint markers, reusing the chip idiom ~728-748). Verify: `node --check` + Chrome-MCP harness.
+
+- [ ] **Step 1: build the band** — In `_renderSwimlanes`, before drawing embryo rows (which start at `TOP_AXIS_H`), aggregate the protocol from the embryos: find the embryo with a non-null `temp_protocol` (and its `setpoint_changes`). If present, insert a band of fixed height (e.g. 28px) and shift embryo rows down by that height:
+  - a **tactic pill** rect spanning `xFor(temp_protocol.start)`..`xFor(temp_protocol.end ?? now)`, labeled `Temp-change burst → ${temp_protocol.target_setpoint_c}°C` (a frontend constant prefix);
+  - for each `setpoint_changes[i]`: a vertical marker line at `xFor(.t)` + a `→ ${.to}°C` chip (reuse the existing chip-drawing helper used for cadence/power chips ~728-748);
+  - tint the burst blocks (already drawn per-embryo ~558-575) by their `phase` (before/during/after) — e.g. a subtle hue or a 1-char badge — using the `phase` field added in Task 2.
+  If no embryo has `temp_protocol`, draw no band (layout unchanged) — keep the calm empty state.
+- [ ] **Step 2:** `node --check gently/ui/web/static/js/experiment-overview.js` (exit 0).
+- [ ] **Step 3: Chrome-MCP harness** — build `scratchpad/operationsdemo/` (copy `event-bus.js`, `experiment-overview.js`, `main.css`); an `index.html` that stubs `fetch('/api/experiments/current/strategy')` to return a snapshot with one embryo carrying a `temp_protocol` band (start/end), `setpoint_changes:[{t,to:25}]`, and a few phased burst phases; mount `ExperimentOverview`; screenshot the band; run the UI audit; report deferral of live rig verification.
+- [ ] **Step 4: commit** — `feat(operations): tactic band — protocol pill + setpoint markers + phased bursts`
+
+---
+
+### Task 4: Live refresh on events
+**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (`init` — add subscriptions + a debounced refetch). Verify: `node --check` + harness (simulate an event → refetch fires).
+
+- [ ] **Step 1: implement** — in `ExperimentOverview.init`, after the initial `loadStrategy()`, register (mirroring `experiment-strip.js:23`):
+```javascript
+const _debouncedReload = (() => { let t; return () => { clearTimeout(t); t = setTimeout(() => { this.loadStrategy().then(() => this.render()); }, 500); }; })();
+['TEMP_PROTOCOL_STARTED','TEMP_PROTOCOL_COMPLETED','TEMPERATURE_SETPOINT_CHANGED','BURST_START','BURST_COMPLETE','EMBRYO_CADENCE_CHANGED','POWER_RAMP_STEP']
+  .forEach(ev => ClientEventBus.on(ev, _debouncedReload));
+```
+(Adapt to the real `ExperimentOverview` method names for load/render + `this` binding — confirm from the file; if `loadStrategy` isn't promise-returning, wrap appropriately. Don't double-register if `init` can run twice — guard with a flag.)
+- [ ] **Step 2:** `node --check` (exit 0).
+- [ ] **Step 3: harness** — in the Task-3 harness, dispatch a `ClientEventBus.emit('TEMP_PROTOCOL_STARTED', {...})` and confirm a (stubbed) refetch is triggered (e.g. fetch call count increments after the debounce). Screenshot/log.
+- [ ] **Step 4: commit** — `feat(operations): live event-driven refresh of the Operations tab`
+
+---
+
+## Self-Review
+- Rename → Task 1; burst phase enabler → Task 2; tactic band render → Task 3; live refresh → Task 4. ✓
+- Open confirmations: real `build_strategy_snapshot` layout (Task 2), the `_renderSwimlanes` insertion point + chip helper (Task 3), the real `ExperimentOverview` load/render method names + init-guard (Task 4).
+- Type consistency: `temp_protocol {start,end,target_setpoint_c}` + `setpoint_changes [{t,to}]` + burst `phase` across Tasks 2/3/4.
diff --git a/docs/superpowers/specs/2026-06-28-operations-tab-design.md b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
new file mode 100644
index 00000000..26a1307a
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
@@ -0,0 +1,84 @@
+# Design: Operations tab — observable tactics (sub-project D)
+
+Status: design decided 2026-06-28 (autonomous, from recon).
+Base branch: off `feature/temp-change-tactic` (C) — D renders the `temp_protocol`/`setpoint_changes`
+snapshot fields C adds, and the protocol events C emits.
+
+## 0. Roadmap context
+Track 2. The user's ask: "when at the beginning of an experiment, tactics have been decided, it
+should reflect and be communicated in the experiments tab… tactics should be observable — what and
+how tactics are used in operations." Today's Experiment tab is embryo/cadence-centric and has **no
+named-tactic concept**, no temperature/setpoint representation, and **does not auto-refresh**
+(fetches once per tab click). D makes the composed temp-change tactic observable and live.
+
+## 1. Overview
+Three changes, all small, no new endpoints (reuse `GET /api/experiments/{session}/strategy`):
+1. **Rename** the tab "Experiment" → "Operations" (label-only).
+2. **Surface the tactic** in the swimlane SVG: a session-level band above the embryo rows showing
+   the named protocol pill (spanning its start→complete), setpoint-change markers, and burst
+   grouping/labels (before/during/after).
+3. **Live refresh**: subscribe the tab to the relevant EventBus events (already relayed to the
+   browser) + debounced re-fetch, so it updates during a run instead of only on tab click.
+
+## 2. Architecture
+
+### 2.1 Rename (label-only)
+`index.html:119` nav button text and `:393` `<h2 class="experiment-title">` text → "Operations".
+Leave all ids (`data-tab="experiment"`, `#experiment-content`, `#experiment-overview-root`) and
+`TABS.EXPERIMENT` (`app.js`) unchanged — routing/JS untouched.
+
+### 2.2 Burst phase in the event (1-line backend enabler)
+The driver sets `b._phase` ("before"/"during"/"after") on each `BurstAcquisition`, but
+`BURST_START` does not emit it, so the timeline can't distinguish phases. In
+`gently/app/orchestration/exclusive.py` `BurstAcquisition.run`, include `"phase":
+getattr(self, "_phase", None)` in the `BURST_START` event data. Then `strategy_snapshot._replay_timeline`'s
+`burst_started` handler records `phase` on the burst phase dict (next to `frames`/`hz`). (C Task 6
+already adds the `temp_protocol` band + `setpoint_changes`; this adds per-burst phase labeling.)
+
+### 2.3 Frontend — the tactic band (`experiment-overview.js`)
+Consume the snapshot's new fields (`temp_protocol`: `{start, end, target_setpoint_c, ...}` and
+`setpoint_changes`: `[{at, to}]`, from C Task 6) and render, in `_renderSwimlanes` (line 332), a
+**session-level band inserted above the per-embryo rows** (the SVG currently starts embryo rows at
+`TOP_AXIS_H` — insert one band-height there and shift rows down):
+- a **tactic pill** spanning the protocol window: label `"Temp-change burst → {target_setpoint_c}°C"`
+  (tactic name is a frontend constant keyed off the `temp_protocol` field — events carry no name).
+- **setpoint markers** at each `setpoint_changes[].at`: a vertical line + a `"→ N°C"` chip, reusing
+  the existing cadence/power-chip drawing idiom (lines ~728-748).
+- **burst phase tint/labels**: the per-embryo burst blocks (lines ~558-575) already render; tint or
+  badge those whose `phase` is before/during/after (from 2.2). Empty state unchanged when no tactic.
+
+### 2.4 Frontend — live refresh (`experiment-overview.js`)
+In `ExperimentOverview.init`, add `ClientEventBus.on(...)` subscriptions (mirroring
+`experiment-strip.js:23`) for: `TEMP_PROTOCOL_STARTED`, `TEMP_PROTOCOL_COMPLETED`,
+`TEMPERATURE_SETPOINT_CHANGED`, `BURST_START`, `BURST_COMPLETE`, `EMBRYO_CADENCE_CHANGED`,
+`POWER_RAMP_STEP` — each calls a **debounced** (~500 ms) `loadStrategy()`+`render()`. The websocket
+relay (`server.py:386`) already emits all of these by `.name`, so no backend change. Keep the
+existing now-ticker.
+
+## 3. Data flow
+protocol/burst events → EventBus → websocket (by `.name`) → `ClientEventBus` → debounced
+`loadStrategy()` → `GET /strategy` → `build_strategy_snapshot` (now with `temp_protocol` +
+`setpoint_changes` + per-burst `phase`) → `_renderSwimlanes` draws the tactic band + markers + tinted
+bursts.
+
+## 4. Error handling
+- No active session / no tactic → existing calm empty state; the band simply absent when
+  `temp_protocol` is null.
+- Snapshot missing the new fields (older session) → render without the band (defensive optional
+  chaining).
+- Event flood → the debounce coalesces; re-fetch is cheap (single GET).
+
+## 5. Testing
+- Backend: `_replay_timeline` records `phase` on burst phases when `BURST_START` carries it (extend
+  C Task 6's snapshot test).
+- Frontend: `node --check`; a Chrome-MCP harness (like A/B1) feeding a snapshot with a `temp_protocol`
+  band + `setpoint_changes` + phased bursts → screenshot the tactic band; verify a simulated
+  `TEMP_PROTOCOL_STARTED` event triggers a debounced re-fetch. UI audit. Live rig verification deferred.
+
+## 6. Out of scope
+- A general user-authored tactic library (G).
+- New strategy endpoints or backend snapshot restructuring (reuse `/strategy`; C owns the builder).
+- The Rules table (unchanged).
+- Wiring the docstring fix for the temp EventTypes (the enum comments wrongly say
+  `{old_temp,new_temp}`/`{protocol_name,success}`) — fix opportunistically; D builds against the real
+  emitter payloads (`{to}` / `{locked,cancelled,error}`).

From 95f912635ab3907bc0a718ee0dc148b8cc0e3209 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 16:37:10 +0530
Subject: [PATCH 200/314] feat(operations): rename Experiment tab to Operations
 (label only)

---
 gently/ui/web/templates/index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 1b1dba8e..7edcd230 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -116,7 +116,7 @@ <h3>Take a quick look</h3>
         <div class="v2-nav-group">
           <div class="v2-nav-label">Now</div>
           <button class="v2-nav-item" data-tab="home">Home</button>
-          <button class="v2-nav-item" data-tab="experiment">Experiment</button>
+          <button class="v2-nav-item" data-tab="experiment">Operations</button>
           <button class="v2-nav-item" data-tab="embryos">Embryos</button>
         </div>
         <div class="v2-nav-group">
@@ -390,7 +390,7 @@ <h2 class="embryos-title">Embryo Monitoring</h2>
     <!-- Experiment Tab -->
     <div id="experiment-content" class="tab-content">
         <div class="experiment-header-bar">
-            <h2 class="experiment-title">Experiment</h2>
+            <h2 class="experiment-title">Operations</h2>
             <div class="view-switcher" id="experiment-view-switcher">
                 <button class="view-btn active" data-experiment-view="overview" title="Overview (1)">Overview</button>
                 <button class="view-btn" data-experiment-view="rules" title="Rules (2)">Rules</button>

From 380336fbc99be1b830b1cf68cca1403696fca084 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 16:39:56 +0530
Subject: [PATCH 201/314] feat(operations): emit burst phase in BURST_START +
 record in snapshot

---
 gently/app/orchestration/exclusive.py |   1 +
 gently/ui/web/strategy_snapshot.py    |   1 +
 tests/test_burst_phase_snapshot.py    | 130 ++++++++++++++++++++++++++
 3 files changed, 132 insertions(+)
 create mode 100644 tests/test_burst_phase_snapshot.py

diff --git a/gently/app/orchestration/exclusive.py b/gently/app/orchestration/exclusive.py
index b741e57d..03917b0c 100644
--- a/gently/app/orchestration/exclusive.py
+++ b/gently/app/orchestration/exclusive.py
@@ -131,6 +131,7 @@ async def run(self, orchestrator) -> ExclusiveResult:
                 "request_id": self.request_id,
                 "frames": self.frames,
                 "mode": self.mode,
+                "phase": getattr(self, "_phase", None),
             },
         )
 
diff --git a/gently/ui/web/strategy_snapshot.py b/gently/ui/web/strategy_snapshot.py
index 4948ae9b..9eeb57e1 100644
--- a/gently/ui/web/strategy_snapshot.py
+++ b/gently/ui/web/strategy_snapshot.py
@@ -774,6 +774,7 @@ def _replay_timeline(
                     "end": None,
                     "frames": int(data.get("frames") or 0),
                     "hz": hz,
+                    "phase": data.get("phase"),
                 }
             )
 
diff --git a/tests/test_burst_phase_snapshot.py b/tests/test_burst_phase_snapshot.py
new file mode 100644
index 00000000..1c2f28fe
--- /dev/null
+++ b/tests/test_burst_phase_snapshot.py
@@ -0,0 +1,130 @@
+"""Task 2: Burst phase field emitted in BURST_START and recorded in snapshot.
+
+Feeds _replay_timeline (via build_strategy_snapshot over a hand-written
+timeline.jsonl) a burst_started event that carries ``phase="during"`` and
+asserts the resulting snapshot burst phase dict includes ``"phase": "during"``.
+"""
+
+import json
+from datetime import datetime, timedelta
+from pathlib import Path
+
+import pytest
+import yaml
+
+from gently.ui.web.strategy_snapshot import build_strategy_snapshot
+
+SESSION_ID = "sess-bp1"
+EMBRYO_ID = "e1"
+STARTED_AT = datetime(2026, 6, 28, 10, 0, 0)
+
+
+def _ts(delta_s: float) -> str:
+    return (STARTED_AT + timedelta(seconds=delta_s)).isoformat()
+
+
+def _write_session(session_dir: Path) -> None:
+    session_dir.mkdir(parents=True, exist_ok=True)
+
+    # Minimal session.yaml
+    (session_dir / "session.yaml").write_text(
+        yaml.dump({"name": "burst-phase test"}), encoding="utf-8"
+    )
+
+    # timelapse.yaml — minimal; one embryo
+    timelapse = {
+        "started_at": STARTED_AT.isoformat(),
+        "base_interval_seconds": 120,
+        "embryos": {
+            EMBRYO_ID: {"interval_seconds": 120},
+        },
+    }
+    (session_dir / "timelapse.yaml").write_text(
+        yaml.dump(timelapse), encoding="utf-8"
+    )
+
+    # timeline.jsonl
+    events = [
+        {
+            "event_id": "ev-bs",
+            "event_type": "timelapse",
+            "event_subtype": "burst_started",
+            "timestamp": _ts(10),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID, "mode": "1hz", "frames": 60, "phase": "during"},
+        },
+        {
+            "event_id": "ev-bc",
+            "event_type": "timelapse",
+            "event_subtype": "burst_completed",
+            "timestamp": _ts(70),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID},
+        },
+    ]
+    timeline_path = session_dir / "timeline.jsonl"
+    with open(timeline_path, "w", encoding="utf-8") as f:
+        for ev in events:
+            f.write(json.dumps(ev) + "\n")
+
+
+def test_burst_phase_recorded(tmp_path: Path) -> None:
+    """Snapshot burst phase dict carries the phase field from BURST_START data."""
+    session_dir = tmp_path / "sessions" / "20260628_1000_test"
+    _write_session(session_dir)
+
+    snap = build_strategy_snapshot(session_dir, SESSION_ID)
+
+    assert snap["embryos"], "no embryos in snapshot"
+    emb = snap["embryos"][0]
+    burst_phases = [p for p in emb["phases"] if p.get("mode") == "burst"]
+    assert burst_phases, "burst phase not found in snapshot"
+    bp = burst_phases[0]
+    assert bp.get("phase") == "during", (
+        f"expected phase='during', got {bp.get('phase')!r}; full burst dict: {bp}"
+    )
+
+
+def test_burst_phase_none_when_absent(tmp_path: Path) -> None:
+    """A burst_started event without a phase field records phase=None gracefully."""
+    session_dir = tmp_path / "sessions" / "20260628_1000_nophase"
+    session_dir.mkdir(parents=True, exist_ok=True)
+
+    (session_dir / "session.yaml").write_text(
+        yaml.dump({"name": "burst-nophase test"}), encoding="utf-8"
+    )
+    timelapse = {
+        "started_at": STARTED_AT.isoformat(),
+        "base_interval_seconds": 120,
+        "embryos": {EMBRYO_ID: {"interval_seconds": 120}},
+    }
+    (session_dir / "timelapse.yaml").write_text(yaml.dump(timelapse), encoding="utf-8")
+
+    events = [
+        {
+            "event_id": "ev-bs2",
+            "event_type": "timelapse",
+            "event_subtype": "burst_started",
+            "timestamp": _ts(10),
+            "source": "test",
+            "session_id": SESSION_ID,
+            "embryo_id": EMBRYO_ID,
+            "data": {"embryo_id": EMBRYO_ID, "mode": "1hz", "frames": 30},
+        },
+    ]
+    with open(session_dir / "timeline.jsonl", "w", encoding="utf-8") as f:
+        for ev in events:
+            f.write(json.dumps(ev) + "\n")
+
+    snap = build_strategy_snapshot(session_dir, SESSION_ID)
+    emb = snap["embryos"][0]
+    burst_phases = [p for p in emb["phases"] if p.get("mode") == "burst"]
+    assert burst_phases, "burst phase not found"
+    bp = burst_phases[0]
+    # "phase" key must exist; value is None when not supplied
+    assert "phase" in bp, f"'phase' key absent from burst dict: {bp}"
+    assert bp["phase"] is None, f"expected None, got {bp['phase']!r}"

From 2a3d8b0e61fe1221fb736ce4645ccdd0bcb3e3a1 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 16:48:21 +0530
Subject: [PATCH 202/314] =?UTF-8?q?feat(operations):=20tactic=20band=20?=
 =?UTF-8?q?=E2=80=94=20protocol=20pill=20+=20setpoint=20markers=20+=20phas?=
 =?UTF-8?q?ed=20bursts?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Renders a session-level tactic band on the swimlane SVG when any embryo
carries a `temp_protocol`.  A 28px band is inserted just below the time
axis (embryo rows shifted down by the same amount).  The band contains a
tactic pill spanning `temp_protocol.start → end`, "→ N°C" setpoint-change
chips at each `setpoint_changes[].t`, and a gutter label.  Burst lane rects
and balloon backgrounds are tinted blue/amber/green when the phase field is
before/during/after; null phase renders unchanged.  node --check: pass.
---
 gently/ui/web/static/css/experiment.css       | 66 ++++++++++++++
 .../ui/web/static/js/experiment-overview.js   | 88 ++++++++++++++++++-
 2 files changed, 150 insertions(+), 4 deletions(-)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 9b343378..6d8ad789 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -626,6 +626,72 @@
     color: var(--accent-cyan);
 }
 
+/* ---- Tactic band — session-level protocol strip above embryo rows ------- */
+/* Background strip */
+.expov-svg-tactic-band-bg {
+    fill: rgba(245, 158, 11, 0.06);
+    stroke: rgba(245, 158, 11, 0.14);
+    stroke-width: 1;
+}
+
+/* Tactic pill: spans the protocol window */
+.expov-svg-tactic-pill {
+    fill: rgba(245, 158, 11, 0.18);
+    stroke: rgba(245, 158, 11, 0.60);
+    stroke-width: 1;
+}
+.expov-svg-tactic-pill-label {
+    fill: #fbbf24;
+    font-size: 9.5px;
+    font-weight: 700;
+    font-family: 'JetBrains Mono', monospace;
+}
+
+/* Gutter label ("tactic") */
+.expov-svg-tactic-band-label {
+    fill: var(--text-muted);
+    font-size: 9px;
+    font-weight: 600;
+    font-family: 'JetBrains Mono', monospace;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    opacity: 0.7;
+}
+
+/* Setpoint marker — vertical line + "→ N°C" chip */
+.expov-svg-tactic-setpoint-line {
+    stroke: rgba(245, 158, 11, 0.55);
+    stroke-width: 1;
+    stroke-dasharray: 3 2;
+}
+.expov-svg-tactic-setpoint-chip-bg {
+    fill: rgba(30, 20, 0, 0.88);
+    stroke: rgba(245, 158, 11, 0.55);
+    stroke-width: 1;
+}
+.expov-svg-tactic-setpoint-chip {
+    fill: #fbbf24;
+    font-size: 9px;
+    font-weight: 600;
+    font-family: 'JetBrains Mono', monospace;
+}
+
+/* Burst phase tints — override fill on the burst lane rect + balloon bg.
+   before = cool blue (pre-stimulus), during = warm amber (active),
+   after = soft green (recovery). null phase renders as the default red. */
+.expov-burst-phase-before {
+    fill: #3b82f6;
+    opacity: 0.80;
+}
+.expov-burst-phase-during {
+    fill: #f59e0b;
+    opacity: 0.90;
+}
+.expov-burst-phase-after {
+    fill: #22c55e;
+    opacity: 0.80;
+}
+
 .expov-trigger-diamond-inline {
     display: inline-block;
     width: 8px;
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index 9e7fc221..eddd97d8 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -367,8 +367,22 @@ const ExperimentOverview = {
         const TOP_AXIS_H   = 36;      // top axis area (time labels + wall-clock)
         const BOTTOM_PAD   = 8;
 
+        const TACTIC_BAND_H = 28;           // session-level tactic band height
+
+        // Aggregate tactic protocol from embryos (first embryo with one wins)
+        let tacticProto = null;
+        let tacticSetpointChanges = [];
+        for (const emb of s.embryos) {
+            if (emb.temp_protocol) {
+                tacticProto = emb.temp_protocol;
+                tacticSetpointChanges = emb.setpoint_changes || [];
+                break;
+            }
+        }
+        const bandShift = tacticProto ? TACTIC_BAND_H : 0;
+
         const rows = s.embryos.length;
-        const H = TOP_AXIS_H + rows * ROW_H + BOTTOM_PAD;
+        const H = TOP_AXIS_H + bandShift + rows * ROW_H + BOTTOM_PAD;
 
         const svg = svgEl('svg', {
             class: 'expov-swimlanes-svg',
@@ -426,6 +440,67 @@ const ExperimentOverview = {
         nowMarker.appendChild(chipText);
         svg.appendChild(nowMarker);
 
+        // ----- tactic band: session-level protocol pill + setpoint markers
+        if (tacticProto) {
+            const bandY = TOP_AXIS_H + 2;
+            const bandContentH = TACTIC_BAND_H - 4;
+            const bandMidY = bandY + bandContentH / 2;
+            const bandG = svgEl('g', { class: 'expov-tactic-band-g' });
+
+            // Background strip spanning the full lane area
+            bandG.appendChild(svgEl('rect', {
+                x: LEFT, y: bandY, width: LANE_W, height: bandContentH, rx: 3,
+                class: 'expov-svg-tactic-band-bg'
+            }));
+
+            // Tactic pill: spans protocol start → end (or now if still running)
+            const pillX0 = xForT(tacticProto.start);
+            const pillX1 = xForT(tacticProto.end != null ? tacticProto.end : s.now_offset_s);
+            const pillW = Math.max(4, pillX1 - pillX0);
+            const pillLabel = `Temp-change burst → ${tacticProto.target_setpoint_c}°C`;
+            bandG.appendChild(svgEl('rect', {
+                x: pillX0, y: bandY + 2, width: pillW, height: bandContentH - 4, rx: 4,
+                class: 'expov-svg-tactic-pill'
+            }));
+            if (pillW > 24) {
+                bandG.appendChild(svgEl('text', {
+                    x: pillX0 + 7, y: bandMidY + 3.5,
+                    class: 'expov-svg-tactic-pill-label'
+                }, pillLabel));
+            }
+
+            // Setpoint markers: vertical line + "→ N°C" chip (reuses chip idiom)
+            tacticSetpointChanges.forEach(sc => {
+                const scX = xForT(sc.t);
+                const markerLabel = `→ ${sc.to}°C`;
+                const chipW = markerLabel.length * 5.6 + 10;
+                const chipY = bandY + 2;
+                bandG.appendChild(svgEl('line', {
+                    x1: scX, x2: scX, y1: bandY, y2: bandY + bandContentH,
+                    class: 'expov-svg-tactic-setpoint-line'
+                }));
+                bandG.appendChild(svgEl('rect', {
+                    x: scX - chipW / 2, y: chipY,
+                    width: chipW, height: 12, rx: 3,
+                    class: 'expov-svg-tactic-setpoint-chip-bg'
+                }));
+                bandG.appendChild(svgEl('text', {
+                    x: scX, y: chipY + 9,
+                    'text-anchor': 'middle',
+                    class: 'expov-svg-tactic-setpoint-chip'
+                }, markerLabel));
+            });
+
+            // Gutter label
+            bandG.appendChild(svgEl('text', {
+                x: LEFT - 8, y: bandMidY + 3.5,
+                'text-anchor': 'end',
+                class: 'expov-svg-tactic-band-label'
+            }, 'tactic'));
+
+            svg.appendChild(bandG);
+        }
+
         // Stash the bits the ticker needs to update without re-rendering.
         this._nowTickerCtx = {
             marker: nowMarker,
@@ -444,7 +519,7 @@ const ExperimentOverview = {
 
         // ----- one group per embryo
         s.embryos.forEach((emb, i) => {
-            const rowTop = TOP_AXIS_H + i * ROW_H;
+            const rowTop = TOP_AXIS_H + bandShift + i * ROW_H;
             const rowG = svgEl('g');
             rowG.appendChild(this._renderLaneRow(s, emb, {
                 LEFT, LANE_W, RIGHT, W, ROW_H, LANE_H, POWER_H, DOSE_H, ROW_PAD,
@@ -537,7 +612,9 @@ const ExperimentOverview = {
             const x1Raw = xForT(ph.end);
             const x1 = Math.max(x1Raw, x0 + 4);
             const width = x1 - x0;
-            const cls = `expov-svg-phase-${ph.mode}`;
+            const cls = (ph.mode === 'burst' && ph.phase)
+                ? `expov-svg-phase-${ph.mode} expov-burst-phase-${ph.phase}`
+                : `expov-svg-phase-${ph.mode}`;
             g.appendChild(svgEl('rect', {
                 x: x0, y: laneY, width, height: LANE_H, rx: 2,
                 class: cls
@@ -559,9 +636,12 @@ const ExperimentOverview = {
                 const bx = (xForT(ph.start) + xForT(ph.end)) / 2;
                 const balloonY = laneY - 12;
                 const halfW = 30;
+                const balloonCls = ph.phase
+                    ? `expov-svg-burst-balloon-bg expov-burst-phase-${ph.phase}`
+                    : 'expov-svg-burst-balloon-bg';
                 g.appendChild(svgEl('rect', {
                     x: bx - halfW, y: balloonY - 10, width: halfW * 2, height: 12, rx: 3,
-                    class: 'expov-svg-burst-balloon-bg'
+                    class: balloonCls
                 }));
                 g.appendChild(svgEl('text', {
                     x: bx, y: balloonY - 1,

From 6003b8ee510f28b044460ca0102f12eef63f4921 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:16:04 +0530
Subject: [PATCH 203/314] docs(operations): redesign D as operation-spine
 (data-driven + scenario mode) after design audit

---
 .../plans/2026-06-28-operations-tab.md        | 123 +++++-------
 .../specs/2026-06-28-operations-tab-design.md | 177 ++++++++++--------
 2 files changed, 144 insertions(+), 156 deletions(-)

diff --git a/docs/superpowers/plans/2026-06-28-operations-tab.md b/docs/superpowers/plans/2026-06-28-operations-tab.md
index 8ce94846..ab1768b2 100644
--- a/docs/superpowers/plans/2026-06-28-operations-tab.md
+++ b/docs/superpowers/plans/2026-06-28-operations-tab.md
@@ -1,103 +1,70 @@
-# Operations Tab (D) Implementation Plan
+# Operations — operation spine (D, redesigned) Implementation Plan
 
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development. Steps use checkbox (`- [ ]`) syntax.
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development. Steps use `- [ ]`.
 
-**Goal:** Make the composed temp-change tactic observable: rename Experiment→Operations, render the protocol band + setpoint markers + phased bursts on the swimlane, and make the tab refresh live.
+**Goal:** Replace the legacy swimlane with a data-driven **operation-spine** Operations view that shows tactics planned/in-use/used, renders any tactic case from a generic model, and is testable offline via scenario fixtures.
 
-**Architecture:** Reuse `GET /api/experiments/{session}/strategy` (C added `temp_protocol` + `setpoint_changes` per-embryo). One backend enabler (emit burst `phase`), the rest is `experiment-overview.js` rendering + live event subscriptions.
+**Architecture:** A generic *operation* model (tactics with state + optional live readouts/phases); a rewritten `experiment-overview.js` overview = the spine renderer (audit fixes baked in); a repo scenario library (6 fixtures) + `?scenario=` dev mode; a backend `build_operation_view(snapshot)` transform served on `/strategy`; live event-driven refresh.
 
-**Tech Stack:** vanilla-JS + hand-rolled SVG (`experiment-overview.js`), the EventBus→websocket relay, pytest for the small backend bit.
+**Reference (the validated prototype — read it for the exact renderer, CSS, model, and fixtures):**
+`/tmp/claude-1000/-home-dna-lab-projects-gently/3192c9a4-bc99-4c0a-9cbd-e094de730bcf/scratchpad/opsdesign/harness.html`
 
 ## Global Constraints
-- No new endpoints; reuse `/strategy`. C owns the snapshot builder; D consumes its fields.
-- Snapshot fields (per-embryo, from C Task 6): `temp_protocol: {start, end, target_setpoint_c, frames, bursts_before, bursts_after} | None`, `setpoint_changes: [{t, to}]`.
-- Rename is label-only (`index.html:119` nav text, `:393` `<h2>`); leave ids + `TABS.EXPERIMENT` unchanged.
-- Tactic name is a frontend constant keyed off `temp_protocol` (events carry no name).
-- Build against the REAL emitter payloads, not the stale enum docstrings.
-- Live: subscribe via `ClientEventBus.on(...)` (mirror `experiment-strip.js:23`), debounced (~500ms) `loadStrategy()`+`render()`. Relay already emits all events by `.name` — no backend change.
-- Frontend: no JS unit harness → `node --check` + Chrome-MCP harness + UI audit; live rig verification deferred.
+- Keep the Experiment→Operations rename (done) + the burst-`phase` event (done). DISCARD the swimlane band.
+- Operation model: `{title, session, tactics:[{seq, state:'used'|'active'|'queued', name, kind, target?, summary?, desc?, trigger?, live?:{readouts:[{label,value,sub?,bar?}], phases?:[{name,state:'done'|'active'|'todo',count,pips:[...]}]}}]}`.
+- Audit fixes (baked into the renderer): (1) queued spine is colored blue + first queued marked "next" (decided-plan must read as a cocked instrument, not empty); (2) active phase dominates + "awaiting lock"-style status is the phase headline; (3) FLATTEN — no card-in-card, values on the panel face + hairline dividers; (4) active row's whole left column amber + colored left edge per state (green/amber/blue); (5) copy "queued" (not "going to be used"), replace "first/second/last" with `trigger`. Keep mono instrument values + domain copy.
+- Renderer must handle ALL six fixtures (phased protocol, readout monitor, one-shot, all-queued, idle) without error.
+- No new endpoint: extend `/api/experiments/{session}/strategy` payload with an `operation` object.
+- Frontend has no JS unit harness → `node --check` + Chrome-MCP audit across fixtures.
 - Git hygiene: stage only your files by explicit path; never `git add -A`.
 
 ---
 
-### Task 1: Rename Experiment → Operations (label-only)
-**Files:** Modify `gently/ui/web/templates/index.html` (nav button text `:119`, `<h2 class="experiment-title">` `:393`). Test: none (pure copy) — verified by `grep`.
-- [ ] **Step 1:** change the nav button text at `:119` from `Experiment` to `Operations`, and the `<h2>` at `:393` from `Experiment` to `Operations`. Leave `data-tab="experiment"`, `#experiment-content`, `#experiment-overview-root`, `TABS.EXPERIMENT` untouched.
-- [ ] **Step 2:** `grep -n ">Operations<" gently/ui/web/templates/index.html` shows both; `grep -n "data-tab=\"experiment\"" ` still present (ids unchanged).
-- [ ] **Step 3: commit** — `git add gently/ui/web/templates/index.html && git commit -m "feat(operations): rename Experiment tab to Operations (label only)"`
+### Task 1: Discard the swimlane band
+**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (+ its css) — revert the tactic-band rendering added in commit 2a3d8b0, returning the Overview to its pre-band baseline (the spine replaces it in Task 2). Keep everything else (Rules view, modes, etc.).
+- [ ] **Step 1:** `git revert --no-commit 2a3d8b0` (or manually remove the band code + css if revert conflicts), keeping the rename (Task-1) and burst-phase (Task-2) commits intact. Confirm `git diff` shows only the band removal.
+- [ ] **Step 2:** `node --check gently/ui/web/static/js/experiment-overview.js` (exit 0).
+- [ ] **Step 3: commit** — `git add gently/ui/web/static/js/experiment-overview.js <css> && git commit -m "feat(operations): discard swimlane tactic-band (replaced by operation spine)"`
 
 ---
 
-### Task 2: Emit burst `phase` + record it in the snapshot
-**Files:** Modify `gently/app/orchestration/exclusive.py` (`BurstAcquisition.run` BURST_START emit ~line 127-135 add `phase`); Modify `gently/ui/web/strategy_snapshot.py` (`_replay_timeline` `burst_started` handler ~line 762 record `phase` on the burst phase dict). Test: `tests/test_burst_phase_snapshot.py`.
-
-**Interfaces:** Produces `BURST_START` data with `"phase": getattr(self, "_phase", None)`; snapshot burst phase dict gains `"phase"`.
-
-- [ ] **Step 1: failing test**
-```python
-# tests/test_burst_phase_snapshot.py
-import json, os
-from gently.ui.web.strategy_snapshot import build_strategy_snapshot
-
-def _write(tmp_path, events):
-    sd = tmp_path / "sess"; (sd / "embryos" / "e1").mkdir(parents=True)
-    (sd / "session.yaml").write_text("session_id: s1\nname: t\nstarted_at: '2026-06-28T10:00:00'\n")
-    (sd / "embryos" / "e1" / "embryo.yaml").write_text("embryo_id: e1\nrole: Test\n")
-    with open(sd / "timeline.jsonl", "w") as f:
-        for e in events: f.write(json.dumps(e) + "\n")
-    return sd
-
-def test_burst_phase_recorded(tmp_path):
-    sd = _write(tmp_path, [
-        {"event_subtype": "burst_started", "embryo_id": "e1", "timestamp": "2026-06-28T10:00:10",
-         "data": {"embryo_id": "e1", "frames": 60, "mode": "1hz", "phase": "during"}},
-        {"event_subtype": "burst_completed", "embryo_id": "e1", "timestamp": "2026-06-28T10:01:10",
-         "data": {"embryo_id": "e1"}},
-    ])
-    snap = build_strategy_snapshot(str(sd), "s1")
-    emb = next(e for e in snap["embryos"] if e["id"] == "e1")
-    burst = next(p for p in emb["phases"] if p.get("mode") == "burst")
-    assert burst.get("phase") == "during"
-```
-> Confirm the real `build_strategy_snapshot` session-dir layout + timeline line shape from C Task 6's test (`tests/test_temp_protocol_snapshot.py`) and match it (session.yaml keys, embryo.yaml, timeline event shape). Adapt `_write` to the real shape; keep the `phase` assertion.
-- [ ] **Step 2: run, expect FAIL** (phase is None / key absent)
-- [ ] **Step 3: implement** — in `exclusive.py` `BurstAcquisition.run`, add `"phase": getattr(self, "_phase", None)` to the `BURST_START` event `data` dict. In `strategy_snapshot.py` `burst_started` handler, add `"phase": data.get("phase")` to the appended burst phase dict (next to `frames`/`hz`).
-- [ ] **Step 4: run, expect PASS**; `pytest -q` no new failures.
-- [ ] **Step 5: commit** — `feat(operations): emit burst phase in BURST_START + record in snapshot`
+### Task 2: Scenario library + the operation-spine renderer (the core)
+**Files:** Create `gently/ui/web/static/js/operations-scenarios.js` (the 6 fixtures, promoted from the harness); Modify `gently/ui/web/static/js/experiment-overview.js` (replace the Overview render path with the data-driven spine renderer from the harness, audit fixes applied) + the experiment css (spine/node/phase styles from the harness). Verify: `node --check` + Chrome-MCP audit.
+
+**Interfaces:** Produces `OperationView.render(rootEl, operationModel)` (or fold into `ExperimentOverview`); consumes the operation model (§ Global Constraints) from the live snapshot (Task 3) or a scenario fixture; `OPERATIONS_SCENARIOS` (the fixture map) + a `?scenario=<name>` loader (dev mode).
+
+- [ ] **Step 1: port the fixtures** — create `operations-scenarios.js` exposing `window.OPERATIONS_SCENARIOS = {temp_strain, expression_onset, pre_hatching, transmission_survey, decided_plan, idle}` — copy the fixture objects from the harness `SCENARIOS` (the `.op` values), as the repo test corpus. Apply the copy fixes: `state:'queued'` (not 'planned' label), add `trigger` fields ("when temp locks", "after #1", etc.) replacing "first/second/last".
+- [ ] **Step 2: the renderer** — port the harness renderer (`renderOperation`/`renderTactic`/`renderReadout`/`renderPhase`) into `experiment-overview.js`, replacing the swimlane Overview path, WITH the audit fixes: state-colored spine connector (green/amber/blue-dashed), whole-left-column amber for active, colored left edge per state, flattened active card (remove inner card backgrounds; hairline divider between readouts and phases), active phase dominant + status headline, first-queued "next" marker, `STATE_LABEL.queued='queued'`. Keep mono labels.
+- [ ] **Step 3: scenario dev mode** — on init, if `new URLSearchParams(location.search).get('scenario')` matches a fixture, render that fixture (no fetch); else fetch the live operation (Task 3). Guard so scenario mode is opt-in via the param.
+- [ ] **Step 4: `node --check`** both JS files (exit 0).
+- [ ] **Step 5: Chrome-MCP audit** — serve the static files, load `?scenario=temp_strain`, `expression_onset`, `decided_plan`, `idle`; screenshot each; verify the audit fixes (queued reads cocked, active dominates, flattened, amber left column, "queued" copy) and that all six render without error; fix flaws.
+- [ ] **Step 6: commit** — `feat(operations): operation-spine renderer + scenario library (data-driven, 6 cases)`
 
 ---
 
-### Task 3: Render the tactic band on the swimlane
-**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (`_renderSwimlanes` ~line 332: insert a session-level band; helpers for the protocol pill + setpoint markers, reusing the chip idiom ~728-748). Verify: `node --check` + Chrome-MCP harness.
+### Task 3: Backend transform `build_operation_view`
+**Files:** Modify `gently/ui/web/strategy_snapshot.py` (add `build_operation_view(snapshot)` mapping the snapshot → operation model; have `build_strategy_snapshot` include `operation` in its return, OR add it in the route). Test: `tests/test_operation_view.py`.
 
-- [ ] **Step 1: build the band** — In `_renderSwimlanes`, before drawing embryo rows (which start at `TOP_AXIS_H`), aggregate the protocol from the embryos: find the embryo with a non-null `temp_protocol` (and its `setpoint_changes`). If present, insert a band of fixed height (e.g. 28px) and shift embryo rows down by that height:
-  - a **tactic pill** rect spanning `xFor(temp_protocol.start)`..`xFor(temp_protocol.end ?? now)`, labeled `Temp-change burst → ${temp_protocol.target_setpoint_c}°C` (a frontend constant prefix);
-  - for each `setpoint_changes[i]`: a vertical marker line at `xFor(.t)` + a `→ ${.to}°C` chip (reuse the existing chip-drawing helper used for cadence/power chips ~728-748);
-  - tint the burst blocks (already drawn per-embryo ~558-575) by their `phase` (before/during/after) — e.g. a subtle hue or a 1-char badge — using the `phase` field added in Task 2.
-  If no embryo has `temp_protocol`, draw no band (layout unchanged) — keep the calm empty state.
-- [ ] **Step 2:** `node --check gently/ui/web/static/js/experiment-overview.js` (exit 0).
-- [ ] **Step 3: Chrome-MCP harness** — build `scratchpad/operationsdemo/` (copy `event-bus.js`, `experiment-overview.js`, `main.css`); an `index.html` that stubs `fetch('/api/experiments/current/strategy')` to return a snapshot with one embryo carrying a `temp_protocol` band (start/end), `setpoint_changes:[{t,to:25}]`, and a few phased burst phases; mount `ExperimentOverview`; screenshot the band; run the UI audit; report deferral of live rig verification.
-- [ ] **Step 4: commit** — `feat(operations): tactic band — protocol pill + setpoint markers + phased bursts`
+**Interfaces:** Produces `build_operation_view(snapshot: dict) -> dict` (the operation model); `/api/experiments/{session}/strategy` response gains `operation`.
 
----
+- [ ] **Step 1: failing test** — feed a snapshot dict (one embryo with a `temp_protocol` band {start,end,target_setpoint_c}, `setpoint_changes`, phased bursts, and an active monitoring mode) to `build_operation_view`; assert the returned `operation.tactics` includes: a `used` monitor tactic, an `active` temp-change tactic whose `live.phases` reflect before/during/after, and the `state`s are correct. (Confirm the real snapshot shape from `tests/test_temp_protocol_snapshot.py`.)
+- [ ] **Step 2: run, FAIL.**
+- [ ] **Step 3: implement** `build_operation_view`: derive tactics from the snapshot — completed monitoring modes/bursts → `used`; the active `temp_protocol`/monitoring mode → `active` (with readouts from temp + current burst, phases from the protocol's before/during/after burst counts); planned/queued items → `queued`. Map fields into the §model. Include `operation` in the snapshot/route payload.
+- [ ] **Step 4: run, PASS;** `pytest -q` clean.
+- [ ] **Step 5: commit** — `feat(operations): build_operation_view transform on the strategy snapshot`
 
-### Task 4: Live refresh on events
-**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (`init` — add subscriptions + a debounced refetch). Verify: `node --check` + harness (simulate an event → refetch fires).
+---
 
-- [ ] **Step 1: implement** — in `ExperimentOverview.init`, after the initial `loadStrategy()`, register (mirroring `experiment-strip.js:23`):
-```javascript
-const _debouncedReload = (() => { let t; return () => { clearTimeout(t); t = setTimeout(() => { this.loadStrategy().then(() => this.render()); }, 500); }; })();
-['TEMP_PROTOCOL_STARTED','TEMP_PROTOCOL_COMPLETED','TEMPERATURE_SETPOINT_CHANGED','BURST_START','BURST_COMPLETE','EMBRYO_CADENCE_CHANGED','POWER_RAMP_STEP']
-  .forEach(ev => ClientEventBus.on(ev, _debouncedReload));
-```
-(Adapt to the real `ExperimentOverview` method names for load/render + `this` binding — confirm from the file; if `loadStrategy` isn't promise-returning, wrap appropriately. Don't double-register if `init` can run twice — guard with a flag.)
+### Task 4: Live refresh
+**Files:** Modify `experiment-overview.js` (`init` — subscribe + debounced refetch, mirroring `experiment-strip.js`). Verify: `node --check` + harness (simulate an event → refetch).
+- [ ] **Step 1:** in `init`, after the initial live fetch, register `ClientEventBus.on(...)` for `TEMP_PROTOCOL_STARTED`,`TEMP_PROTOCOL_COMPLETED`,`TEMPERATURE_SETPOINT_CHANGED`,`BURST_START`,`BURST_COMPLETE`,`EMBRYO_CADENCE_CHANGED`,`POWER_RAMP_STEP`, each → a debounced (~500ms) refetch+render. Guard against double-registration; skip in scenario mode.
 - [ ] **Step 2:** `node --check` (exit 0).
-- [ ] **Step 3: harness** — in the Task-3 harness, dispatch a `ClientEventBus.emit('TEMP_PROTOCOL_STARTED', {...})` and confirm a (stubbed) refetch is triggered (e.g. fetch call count increments after the debounce). Screenshot/log.
-- [ ] **Step 4: commit** — `feat(operations): live event-driven refresh of the Operations tab`
+- [ ] **Step 3: harness** — dispatch a `ClientEventBus.emit('TEMP_PROTOCOL_STARTED', {...})` and confirm a (stubbed) refetch fires after the debounce.
+- [ ] **Step 4: commit** — `feat(operations): live event-driven refresh`
 
 ---
 
 ## Self-Review
-- Rename → Task 1; burst phase enabler → Task 2; tactic band render → Task 3; live refresh → Task 4. ✓
-- Open confirmations: real `build_strategy_snapshot` layout (Task 2), the `_renderSwimlanes` insertion point + chip helper (Task 3), the real `ExperimentOverview` load/render method names + init-guard (Task 4).
-- Type consistency: `temp_protocol {start,end,target_setpoint_c}` + `setpoint_changes [{t,to}]` + burst `phase` across Tasks 2/3/4.
+- Discard swimlane → Task 1; renderer+scenarios → Task 2 (audit fixes baked in); backend transform → Task 3; live refresh → Task 4. ✓
+- Open confirmations: the real snapshot shape (Task 3, from C's snapshot test); the `experiment-overview.js` Overview render seam to replace (Task 2, read the harness for the target renderer); the css file for experiment styles (Task 1/2).
+- Type consistency: the operation model fields are identical across the fixtures (Task 2), the transform (Task 3), and the renderer (Task 2).
diff --git a/docs/superpowers/specs/2026-06-28-operations-tab-design.md b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
index 26a1307a..6d57416e 100644
--- a/docs/superpowers/specs/2026-06-28-operations-tab-design.md
+++ b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
@@ -1,84 +1,105 @@
-# Design: Operations tab — observable tactics (sub-project D)
-
-Status: design decided 2026-06-28 (autonomous, from recon).
-Base branch: off `feature/temp-change-tactic` (C) — D renders the `temp_protocol`/`setpoint_changes`
-snapshot fields C adds, and the protocol events C emits.
-
-## 0. Roadmap context
-Track 2. The user's ask: "when at the beginning of an experiment, tactics have been decided, it
-should reflect and be communicated in the experiments tab… tactics should be observable — what and
-how tactics are used in operations." Today's Experiment tab is embryo/cadence-centric and has **no
-named-tactic concept**, no temperature/setpoint representation, and **does not auto-refresh**
-(fetches once per tab click). D makes the composed temp-change tactic observable and live.
-
-## 1. Overview
-Three changes, all small, no new endpoints (reuse `GET /api/experiments/{session}/strategy`):
-1. **Rename** the tab "Experiment" → "Operations" (label-only).
-2. **Surface the tactic** in the swimlane SVG: a session-level band above the embryo rows showing
-   the named protocol pill (spanning its start→complete), setpoint-change markers, and burst
-   grouping/labels (before/during/after).
-3. **Live refresh**: subscribe the tab to the relevant EventBus events (already relayed to the
-   browser) + debounced re-fetch, so it updates during a run instead of only on tab click.
-
-## 2. Architecture
-
-### 2.1 Rename (label-only)
-`index.html:119` nav button text and `:393` `<h2 class="experiment-title">` text → "Operations".
-Leave all ids (`data-tab="experiment"`, `#experiment-content`, `#experiment-overview-root`) and
-`TABS.EXPERIMENT` (`app.js`) unchanged — routing/JS untouched.
-
-### 2.2 Burst phase in the event (1-line backend enabler)
-The driver sets `b._phase` ("before"/"during"/"after") on each `BurstAcquisition`, but
-`BURST_START` does not emit it, so the timeline can't distinguish phases. In
-`gently/app/orchestration/exclusive.py` `BurstAcquisition.run`, include `"phase":
-getattr(self, "_phase", None)` in the `BURST_START` event data. Then `strategy_snapshot._replay_timeline`'s
-`burst_started` handler records `phase` on the burst phase dict (next to `frames`/`hz`). (C Task 6
-already adds the `temp_protocol` band + `setpoint_changes`; this adds per-burst phase labeling.)
-
-### 2.3 Frontend — the tactic band (`experiment-overview.js`)
-Consume the snapshot's new fields (`temp_protocol`: `{start, end, target_setpoint_c, ...}` and
-`setpoint_changes`: `[{at, to}]`, from C Task 6) and render, in `_renderSwimlanes` (line 332), a
-**session-level band inserted above the per-embryo rows** (the SVG currently starts embryo rows at
-`TOP_AXIS_H` — insert one band-height there and shift rows down):
-- a **tactic pill** spanning the protocol window: label `"Temp-change burst → {target_setpoint_c}°C"`
-  (tactic name is a frontend constant keyed off the `temp_protocol` field — events carry no name).
-- **setpoint markers** at each `setpoint_changes[].at`: a vertical line + a `"→ N°C"` chip, reusing
-  the existing cadence/power-chip drawing idiom (lines ~728-748).
-- **burst phase tint/labels**: the per-embryo burst blocks (lines ~558-575) already render; tint or
-  badge those whose `phase` is before/during/after (from 2.2). Empty state unchanged when no tactic.
-
-### 2.4 Frontend — live refresh (`experiment-overview.js`)
-In `ExperimentOverview.init`, add `ClientEventBus.on(...)` subscriptions (mirroring
-`experiment-strip.js:23`) for: `TEMP_PROTOCOL_STARTED`, `TEMP_PROTOCOL_COMPLETED`,
-`TEMPERATURE_SETPOINT_CHANGED`, `BURST_START`, `BURST_COMPLETE`, `EMBRYO_CADENCE_CHANGED`,
-`POWER_RAMP_STEP` — each calls a **debounced** (~500 ms) `loadStrategy()`+`render()`. The websocket
-relay (`server.py:386`) already emits all of these by `.name`, so no backend change. Keep the
-existing now-ticker.
+# Design: Operations tab — the operation spine (sub-project D, redesigned)
+
+Status: redesigned 2026-06-28 after a from-scratch design analysis + audit (user directive:
+"start from no assumptions of legacy design… rethink completely new"). Supersedes the earlier
+swimlane-band approach (discarded).
+Base branch: `feature/operations-tab` (off C). Keep: the Experiment→Operations rename and the
+burst-`phase` event. **Discard: the swimlane tactic-band rendering.**
+
+## 0. The directive
+
+Operations must present **tactics in three states — planned ("queued"), in use, and used** — so a
+scientist reads at a glance what the agent decided, what it's doing now, and what's next. It must be
+**testable against realistic experiments** and render **different tactic cases** (monitor, burst,
+temp-change protocol, transmission, …). It is **mission-control for an autonomous instrument**, not
+a timeline and not a SaaS dashboard.
+
+## 1. The model — a generic tactic plan
+
+Operations renders one data structure, the **operation view**:
+
+```
+operation = { title, session, tactics: [ tactic ] }
+tactic = {
+  seq, state: 'used'|'active'|'queued', name, kind,
+  target?,            # e.g. "→ 32.0 °C"
+  summary?,           # collapsed line (used/queued): "22 min · ended on signal"
+  desc?,              # one-line sub-description
+  trigger?,           # queued: the condition that starts it, e.g. "when temp locks"
+  live?: {            # active (or any with live data)
+    readouts: [{ label, value, sub?, bar? }],   # temp gauge, current burst, signal, cadence…
+    phases?:  [{ name, state:'done'|'active'|'todo', count, pips:[...] }]  # before/during/after (protocols)
+  }
+}
+```
+
+This single model renders **any** tactic kind: a phased protocol (temp-change → phases + temp
+gauge), a reactive monitor (expression-onset → readouts, no phases), a one-shot (transmission burst
+→ readouts), or a purely queued plan (all tactics `state:'queued'`).
+
+## 2. Architecture (four units)
+
+### 2.1 Backend transform — `build_operation_view(snapshot)`
+A new function (in `gently/ui/web/strategy_snapshot.py` or a sibling) that maps the existing
+strategy snapshot into the operation model: the per-embryo `temp_protocol` band + `setpoint_changes`
++ phased bursts (from C) become a temp-change **tactic** with before/during/after **phases**; active
+`monitoring_modes` become monitor **tactics** with **readouts** (cadence, power, signal); completed
+bursts/phases become **used** tactics; not-yet-started planned items become **queued** tactics.
+Served via the existing `/api/experiments/{session}/strategy` route (extend its payload with
+`operation`) or a new `GET /api/operations/{session}` — reuse `/strategy` to avoid a new route.
+
+### 2.2 The renderer — rewrite `experiment-overview.js`
+Replace the swimlane Overview with the **operation spine** (data-driven from §1): a vertical thread
+of tactic nodes; **used** = solid green dot + collapsed one-line summary; **in use** = amber node,
+the *whole left column amber* (dot + seq + "IN USE"), card bloomed open with live internals; **queued**
+= blue dashed dot + dimmed card + trigger condition. The spine connector is **state-colored**
+(green used → amber active → blue-dashed queued); the first queued node is marked **next**. (The
+Rules view can remain as-is or be folded in later — out of scope here.)
+
+**Audit fixes baked in** (from the design audit):
+1. Queued/decided-plan state reads as a *cocked* instrument: colored blue queued thread + "next" marker.
+2. The **active phase dominates** the stepper; **"awaiting lock" is the headline** of the active phase.
+3. **Flatten** the active card — no card-in-card; values sit on the panel face, separated by a hairline.
+4. Active row's **entire left column amber**; colored left edge per state (green/amber/blue).
+5. Copy: **"queued"** (not "going to be used"); replace "first/second/last" with the **trigger**;
+   keep mono instrument values + domain copy ("ended on signal", "awaiting lock"); show rate-of-change
+   deltas ("+14% over 6 min") and promote the decision-driving readout per tactic kind.
+
+### 2.3 Scenario test mode (the "test it for real experiments" requirement)
+The renderer accepts an operation model from either the live endpoint **or** a **scenario fixture**.
+A small dev affordance — `?scenario=<name>` URL param (and/or a dev-only scenario `<select>`) — loads
+a named fixture from a **scenario library** (`gently/ui/web/static/js/operations-scenarios.js`):
+`temp_strain`, `expression_onset`, `pre_hatching`, `transmission_survey`, `decided_plan`, `idle`.
+This makes Operations developable/verifiable **offline against any tactic case**, with no rig. The
+fixtures are the prototyped harness fixtures, promoted into the repo as test data + a Chrome-MCP
+audit target. (Scenario mode is dev-gated; live mode is default.)
+
+### 2.4 Live refresh
+The tab subscribes (via `ClientEventBus.on`, mirroring `experiment-strip.js`) to
+`TEMP_PROTOCOL_STARTED/COMPLETED`, `TEMPERATURE_SETPOINT_CHANGED`, `BURST_START/COMPLETE`,
+`EMBRYO_CADENCE_CHANGED`, `POWER_RAMP_STEP`, each triggering a debounced (~500 ms) refetch+render. The
+websocket relay already emits all of these by `.name`; no backend change.
 
 ## 3. Data flow
-protocol/burst events → EventBus → websocket (by `.name`) → `ClientEventBus` → debounced
-`loadStrategy()` → `GET /strategy` → `build_strategy_snapshot` (now with `temp_protocol` +
-`setpoint_changes` + per-burst `phase`) → `_renderSwimlanes` draws the tactic band + markers + tinted
-bursts.
-
-## 4. Error handling
-- No active session / no tactic → existing calm empty state; the band simply absent when
-  `temp_protocol` is null.
-- Snapshot missing the new fields (older session) → render without the band (defensive optional
-  chaining).
-- Event flood → the debounce coalesces; re-fetch is cheap (single GET).
+events → EventBus → websocket → `ClientEventBus` → debounced refetch → `/strategy` (now with
+`operation`) → `build_operation_view` → spine renderer. In scenario mode: `?scenario=` → fixture →
+same renderer (no fetch).
+
+## 4. Error/empty
+- No active operation / no tactics → calm **idle** state ("When the agent begins operating by tactic,
+  the plan and live progress appear here"), not a dead screen.
+- Snapshot lacks `operation` (older session) → renderer falls back to a minimal "no tactic data" note.
+- Unknown tactic `kind` → renders generically from `name`/`summary`/`readouts` (the model is kind-agnostic).
 
 ## 5. Testing
-- Backend: `_replay_timeline` records `phase` on burst phases when `BURST_START` carries it (extend
-  C Task 6's snapshot test).
-- Frontend: `node --check`; a Chrome-MCP harness (like A/B1) feeding a snapshot with a `temp_protocol`
-  band + `setpoint_changes` + phased bursts → screenshot the tactic band; verify a simulated
-  `TEMP_PROTOCOL_STARTED` event triggers a debounced re-fetch. UI audit. Live rig verification deferred.
+- Backend: `build_operation_view` over a hand-written snapshot → asserts the tactic list states +
+  the temp-protocol tactic's phases + a queued tactic's trigger.
+- Frontend: `node --check`; the **scenario library** doubles as the test corpus — a Chrome-MCP audit
+  across all six fixtures (the harness, promoted); UI audit per the audit fixes. Live rig verification deferred.
+- Scenario mode itself is the regression harness: any tactic case can be loaded and visually checked.
 
 ## 6. Out of scope
-- A general user-authored tactic library (G).
-- New strategy endpoints or backend snapshot restructuring (reuse `/strategy`; C owns the builder).
-- The Rules table (unchanged).
-- Wiring the docstring fix for the temp EventTypes (the enum comments wrongly say
-  `{old_temp,new_temp}`/`{protocol_name,success}`) — fix opportunistically; D builds against the real
-  emitter payloads (`{to}` / `{locked,cancelled,error}`).
+- A general user-/agent-authored persisted tactic *library* (G) — D presents tactics; G lets users
+  define/save them.
+- The Rules view rework; multi-embryo concurrent-operation layout (single active operation for now,
+  though the model + spine extend to a stack of operations later).

From b8da1383d11fbb6c3eb83c7de6d70412ab141855 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:16:28 +0530
Subject: [PATCH 204/314] feat(operations): discard swimlane tactic-band
 (replaced by operation spine)

---
 gently/ui/web/static/css/experiment.css       | 66 --------------
 .../ui/web/static/js/experiment-overview.js   | 88 +------------------
 2 files changed, 4 insertions(+), 150 deletions(-)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 6d8ad789..9b343378 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -626,72 +626,6 @@
     color: var(--accent-cyan);
 }
 
-/* ---- Tactic band — session-level protocol strip above embryo rows ------- */
-/* Background strip */
-.expov-svg-tactic-band-bg {
-    fill: rgba(245, 158, 11, 0.06);
-    stroke: rgba(245, 158, 11, 0.14);
-    stroke-width: 1;
-}
-
-/* Tactic pill: spans the protocol window */
-.expov-svg-tactic-pill {
-    fill: rgba(245, 158, 11, 0.18);
-    stroke: rgba(245, 158, 11, 0.60);
-    stroke-width: 1;
-}
-.expov-svg-tactic-pill-label {
-    fill: #fbbf24;
-    font-size: 9.5px;
-    font-weight: 700;
-    font-family: 'JetBrains Mono', monospace;
-}
-
-/* Gutter label ("tactic") */
-.expov-svg-tactic-band-label {
-    fill: var(--text-muted);
-    font-size: 9px;
-    font-weight: 600;
-    font-family: 'JetBrains Mono', monospace;
-    text-transform: uppercase;
-    letter-spacing: 0.08em;
-    opacity: 0.7;
-}
-
-/* Setpoint marker — vertical line + "→ N°C" chip */
-.expov-svg-tactic-setpoint-line {
-    stroke: rgba(245, 158, 11, 0.55);
-    stroke-width: 1;
-    stroke-dasharray: 3 2;
-}
-.expov-svg-tactic-setpoint-chip-bg {
-    fill: rgba(30, 20, 0, 0.88);
-    stroke: rgba(245, 158, 11, 0.55);
-    stroke-width: 1;
-}
-.expov-svg-tactic-setpoint-chip {
-    fill: #fbbf24;
-    font-size: 9px;
-    font-weight: 600;
-    font-family: 'JetBrains Mono', monospace;
-}
-
-/* Burst phase tints — override fill on the burst lane rect + balloon bg.
-   before = cool blue (pre-stimulus), during = warm amber (active),
-   after = soft green (recovery). null phase renders as the default red. */
-.expov-burst-phase-before {
-    fill: #3b82f6;
-    opacity: 0.80;
-}
-.expov-burst-phase-during {
-    fill: #f59e0b;
-    opacity: 0.90;
-}
-.expov-burst-phase-after {
-    fill: #22c55e;
-    opacity: 0.80;
-}
-
 .expov-trigger-diamond-inline {
     display: inline-block;
     width: 8px;
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index eddd97d8..9e7fc221 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -367,22 +367,8 @@ const ExperimentOverview = {
         const TOP_AXIS_H   = 36;      // top axis area (time labels + wall-clock)
         const BOTTOM_PAD   = 8;
 
-        const TACTIC_BAND_H = 28;           // session-level tactic band height
-
-        // Aggregate tactic protocol from embryos (first embryo with one wins)
-        let tacticProto = null;
-        let tacticSetpointChanges = [];
-        for (const emb of s.embryos) {
-            if (emb.temp_protocol) {
-                tacticProto = emb.temp_protocol;
-                tacticSetpointChanges = emb.setpoint_changes || [];
-                break;
-            }
-        }
-        const bandShift = tacticProto ? TACTIC_BAND_H : 0;
-
         const rows = s.embryos.length;
-        const H = TOP_AXIS_H + bandShift + rows * ROW_H + BOTTOM_PAD;
+        const H = TOP_AXIS_H + rows * ROW_H + BOTTOM_PAD;
 
         const svg = svgEl('svg', {
             class: 'expov-swimlanes-svg',
@@ -440,67 +426,6 @@ const ExperimentOverview = {
         nowMarker.appendChild(chipText);
         svg.appendChild(nowMarker);
 
-        // ----- tactic band: session-level protocol pill + setpoint markers
-        if (tacticProto) {
-            const bandY = TOP_AXIS_H + 2;
-            const bandContentH = TACTIC_BAND_H - 4;
-            const bandMidY = bandY + bandContentH / 2;
-            const bandG = svgEl('g', { class: 'expov-tactic-band-g' });
-
-            // Background strip spanning the full lane area
-            bandG.appendChild(svgEl('rect', {
-                x: LEFT, y: bandY, width: LANE_W, height: bandContentH, rx: 3,
-                class: 'expov-svg-tactic-band-bg'
-            }));
-
-            // Tactic pill: spans protocol start → end (or now if still running)
-            const pillX0 = xForT(tacticProto.start);
-            const pillX1 = xForT(tacticProto.end != null ? tacticProto.end : s.now_offset_s);
-            const pillW = Math.max(4, pillX1 - pillX0);
-            const pillLabel = `Temp-change burst → ${tacticProto.target_setpoint_c}°C`;
-            bandG.appendChild(svgEl('rect', {
-                x: pillX0, y: bandY + 2, width: pillW, height: bandContentH - 4, rx: 4,
-                class: 'expov-svg-tactic-pill'
-            }));
-            if (pillW > 24) {
-                bandG.appendChild(svgEl('text', {
-                    x: pillX0 + 7, y: bandMidY + 3.5,
-                    class: 'expov-svg-tactic-pill-label'
-                }, pillLabel));
-            }
-
-            // Setpoint markers: vertical line + "→ N°C" chip (reuses chip idiom)
-            tacticSetpointChanges.forEach(sc => {
-                const scX = xForT(sc.t);
-                const markerLabel = `→ ${sc.to}°C`;
-                const chipW = markerLabel.length * 5.6 + 10;
-                const chipY = bandY + 2;
-                bandG.appendChild(svgEl('line', {
-                    x1: scX, x2: scX, y1: bandY, y2: bandY + bandContentH,
-                    class: 'expov-svg-tactic-setpoint-line'
-                }));
-                bandG.appendChild(svgEl('rect', {
-                    x: scX - chipW / 2, y: chipY,
-                    width: chipW, height: 12, rx: 3,
-                    class: 'expov-svg-tactic-setpoint-chip-bg'
-                }));
-                bandG.appendChild(svgEl('text', {
-                    x: scX, y: chipY + 9,
-                    'text-anchor': 'middle',
-                    class: 'expov-svg-tactic-setpoint-chip'
-                }, markerLabel));
-            });
-
-            // Gutter label
-            bandG.appendChild(svgEl('text', {
-                x: LEFT - 8, y: bandMidY + 3.5,
-                'text-anchor': 'end',
-                class: 'expov-svg-tactic-band-label'
-            }, 'tactic'));
-
-            svg.appendChild(bandG);
-        }
-
         // Stash the bits the ticker needs to update without re-rendering.
         this._nowTickerCtx = {
             marker: nowMarker,
@@ -519,7 +444,7 @@ const ExperimentOverview = {
 
         // ----- one group per embryo
         s.embryos.forEach((emb, i) => {
-            const rowTop = TOP_AXIS_H + bandShift + i * ROW_H;
+            const rowTop = TOP_AXIS_H + i * ROW_H;
             const rowG = svgEl('g');
             rowG.appendChild(this._renderLaneRow(s, emb, {
                 LEFT, LANE_W, RIGHT, W, ROW_H, LANE_H, POWER_H, DOSE_H, ROW_PAD,
@@ -612,9 +537,7 @@ const ExperimentOverview = {
             const x1Raw = xForT(ph.end);
             const x1 = Math.max(x1Raw, x0 + 4);
             const width = x1 - x0;
-            const cls = (ph.mode === 'burst' && ph.phase)
-                ? `expov-svg-phase-${ph.mode} expov-burst-phase-${ph.phase}`
-                : `expov-svg-phase-${ph.mode}`;
+            const cls = `expov-svg-phase-${ph.mode}`;
             g.appendChild(svgEl('rect', {
                 x: x0, y: laneY, width, height: LANE_H, rx: 2,
                 class: cls
@@ -636,12 +559,9 @@ const ExperimentOverview = {
                 const bx = (xForT(ph.start) + xForT(ph.end)) / 2;
                 const balloonY = laneY - 12;
                 const halfW = 30;
-                const balloonCls = ph.phase
-                    ? `expov-svg-burst-balloon-bg expov-burst-phase-${ph.phase}`
-                    : 'expov-svg-burst-balloon-bg';
                 g.appendChild(svgEl('rect', {
                     x: bx - halfW, y: balloonY - 10, width: halfW * 2, height: 12, rx: 3,
-                    class: balloonCls
+                    class: 'expov-svg-burst-balloon-bg'
                 }));
                 g.appendChild(svgEl('text', {
                     x: bx, y: balloonY - 1,

From 22d9b0684def76990cb9b49d0045228dacbe7bd9 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:32:13 +0530
Subject: [PATCH 205/314] =?UTF-8?q?docs(operations):=20v3=20spec=20?=
 =?UTF-8?q?=E2=80=94=20agent-authored=20typed=20Operation=20Plan=20(DRAFT,?=
 =?UTF-8?q?=20for=20review)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../specs/2026-06-28-operations-tab-design.md | 207 ++++++++++--------
 1 file changed, 110 insertions(+), 97 deletions(-)

diff --git a/docs/superpowers/specs/2026-06-28-operations-tab-design.md b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
index 6d57416e..95224ed1 100644
--- a/docs/superpowers/specs/2026-06-28-operations-tab-design.md
+++ b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
@@ -1,105 +1,118 @@
-# Design: Operations tab — the operation spine (sub-project D, redesigned)
-
-Status: redesigned 2026-06-28 after a from-scratch design analysis + audit (user directive:
-"start from no assumptions of legacy design… rethink completely new"). Supersedes the earlier
-swimlane-band approach (discarded).
-Base branch: `feature/operations-tab` (off C). Keep: the Experiment→Operations rename and the
-burst-`phase` event. **Discard: the swimlane tactic-band rendering.**
-
-## 0. The directive
-
-Operations must present **tactics in three states — planned ("queued"), in use, and used** — so a
-scientist reads at a glance what the agent decided, what it's doing now, and what's next. It must be
-**testable against realistic experiments** and render **different tactic cases** (monitor, burst,
-temp-change protocol, transmission, …). It is **mission-control for an autonomous instrument**, not
-a timeline and not a SaaS dashboard.
-
-## 1. The model — a generic tactic plan
-
-Operations renders one data structure, the **operation view**:
+# Design: Operations — the agent-authored Operation Plan (sub-project D, v3)
+
+Status: **DRAFT for review.** Redesigned 2026-06-28 after two from-scratch iterations (swimlane →
+operation-spine) and a foundational rethink the user prompted: tactics are richer than a linear plan,
+and the tactical picture should be a **typed output the agent authors per experiment**, not a backend
+reconstruction. Grounded by an architecture recon (every piece needed already exists).
+Base branch: `feature/operations-tab` (off C). Keep: Experiment→Operations rename + the burst-`phase`
+event. Discarded: the swimlane band (reverted) and the single-linear-spine assumption.
+
+## 0. The two decisions this encodes (pending user confirm)
+1. **Source of truth = the agent.** The agent emits a typed **Operation Plan** (the tactics it has
+   planned / is running / has run, each typed) via forced `tool_choice` — gently's existing house
+   pattern (Ask-the-notebook, hatching detector, verifier, classifier all do this; `@tool`
+   auto-generates schemas). The UI renders the agent's plan **⊕ live telemetry binding**. We do NOT
+   keep extending `strategy_snapshot`'s timeline-replay *reconstruction* to guess tactics — the agent
+   owns tactic identity; the backend supplies live values.
+2. **Open, grounded ontology.** A tactic is far broader than a phased protocol; the schema covers the
+   real operational modes (below). No round-robin primitive (the scheduler is priority-queue
+   "most-overdue"; "round" is legacy naming).
+
+## 1. The Operation Plan (typed agent output)
 
 ```
-operation = { title, session, tactics: [ tactic ] }
+operation_plan = {
+  session_id, title, goal,                 # the agent's framing of the run
+  tactics: [ tactic ],
+  updated_at, updated_reason               # patched on each tactic transition
+}
 tactic = {
-  seq, state: 'used'|'active'|'queued', name, kind,
-  target?,            # e.g. "→ 32.0 °C"
-  summary?,           # collapsed line (used/queued): "22 min · ended on signal"
-  desc?,              # one-line sub-description
-  trigger?,           # queued: the condition that starts it, e.g. "when temp locks"
-  live?: {            # active (or any with live data)
-    readouts: [{ label, value, sub?, bar? }],   # temp gauge, current burst, signal, cadence…
-    phases?:  [{ name, state:'done'|'active'|'todo', count, pips:[...] }]  # before/during/after (protocols)
-  }
+  id, name, kind, state, scope,
+  rationale,                               # the agent's WHY (no self-rated confidence)
+  structure, live_bind, relations
 }
+kind      : 'standing_timelapse' | 'reactive_monitor' | 'scripted_protocol' | 'exclusive_burst' | 'oneshot' | 'custom'
+state     : 'planned' | 'active' | 'done'
+scope     : { mode:'global'|'embryos', embryo_ids?:[...] }
+structure :   # by kind
+  standing_timelapse → { cadence_s, per_embryo:[{embryo_id, cadence_phase:'normal'|'fast'|'burst'|'paused', interval_s}] }
+  reactive_monitor   → { watch, reaction, status:'armed'|'watching'|'fired' }   # onset, saturation, burst-on-structure, hatching-detect
+  scripted_protocol  → { phases:[{name, state:'done'|'active'|'todo', count}] }  # before/during/after
+  exclusive_burst    → { frames, mode, phase? }
+  oneshot|custom     → { note }
+live_bind : [ 'temperature' | 'current_burst' | 'cadence' | 'signal' | ... ]    # which telemetry fills readouts/progress
+relations : { after?:[tactic_id], layered_on?:[tactic_id], triggers?:[tactic_id] }   # concurrency + composition
 ```
 
-This single model renders **any** tactic kind: a phased protocol (temp-change → phases + temp
-gauge), a reactive monitor (expression-onset → readouts, no phases), a one-shot (transmission burst
-→ readouts), or a purely queued plan (all tactics `state:'queued'`).
-
-## 2. Architecture (four units)
-
-### 2.1 Backend transform — `build_operation_view(snapshot)`
-A new function (in `gently/ui/web/strategy_snapshot.py` or a sibling) that maps the existing
-strategy snapshot into the operation model: the per-embryo `temp_protocol` band + `setpoint_changes`
-+ phased bursts (from C) become a temp-change **tactic** with before/during/after **phases**; active
-`monitoring_modes` become monitor **tactics** with **readouts** (cadence, power, signal); completed
-bursts/phases become **used** tactics; not-yet-started planned items become **queued** tactics.
-Served via the existing `/api/experiments/{session}/strategy` route (extend its payload with
-`operation`) or a new `GET /api/operations/{session}` — reuse `/strategy` to avoid a new route.
-
-### 2.2 The renderer — rewrite `experiment-overview.js`
-Replace the swimlane Overview with the **operation spine** (data-driven from §1): a vertical thread
-of tactic nodes; **used** = solid green dot + collapsed one-line summary; **in use** = amber node,
-the *whole left column amber* (dot + seq + "IN USE"), card bloomed open with live internals; **queued**
-= blue dashed dot + dimmed card + trigger condition. The spine connector is **state-colored**
-(green used → amber active → blue-dashed queued); the first queued node is marked **next**. (The
-Rules view can remain as-is or be folded in later — out of scope here.)
-
-**Audit fixes baked in** (from the design audit):
-1. Queued/decided-plan state reads as a *cocked* instrument: colored blue queued thread + "next" marker.
-2. The **active phase dominates** the stepper; **"awaiting lock" is the headline** of the active phase.
-3. **Flatten** the active card — no card-in-card; values sit on the panel face, separated by a hairline.
-4. Active row's **entire left column amber**; colored left edge per state (green/amber/blue).
-5. Copy: **"queued"** (not "going to be used"); replace "first/second/last" with the **trigger**;
-   keep mono instrument values + domain copy ("ended on signal", "awaiting lock"); show rate-of-change
-   deltas ("+14% over 6 min") and promote the decision-driving readout per tactic kind.
-
-### 2.3 Scenario test mode (the "test it for real experiments" requirement)
-The renderer accepts an operation model from either the live endpoint **or** a **scenario fixture**.
-A small dev affordance — `?scenario=<name>` URL param (and/or a dev-only scenario `<select>`) — loads
-a named fixture from a **scenario library** (`gently/ui/web/static/js/operations-scenarios.js`):
-`temp_strain`, `expression_onset`, `pre_hatching`, `transmission_survey`, `decided_plan`, `idle`.
-This makes Operations developable/verifiable **offline against any tactic case**, with no rig. The
-fixtures are the prototyped harness fixtures, promoted into the repo as test data + a Chrome-MCP
-audit target. (Scenario mode is dev-gated; live mode is default.)
-
-### 2.4 Live refresh
-The tab subscribes (via `ClientEventBus.on`, mirroring `experiment-strip.js`) to
-`TEMP_PROTOCOL_STARTED/COMPLETED`, `TEMPERATURE_SETPOINT_CHANGED`, `BURST_START/COMPLETE`,
-`EMBRYO_CADENCE_CHANGED`, `POWER_RAMP_STEP`, each triggering a debounced (~500 ms) refetch+render. The
-websocket relay already emits all of these by `.name`; no backend change.
+This single typed object expresses a regular timelapse (standing), an async per-embryo run (standing
+with per-embryo cadence — *real* in the orchestrator), a reactive monitor incl. **hatching detection**
+(reactive), a temp-change protocol (scripted, phased), an exclusive burst, and arbitrary `custom`
+tactics — because the **agent declares each one's kind/structure**.
+
+## 2. Architecture (producer → model → consumer, all reusing existing paths)
+
+### 2.1 Producer — the `operation_plan` typed tool (agent)
+A new agent tool `declare_operation_plan(...)` (or `update_operation_plan`) in `gently/app/tools/`,
+schema auto-generated by the `@tool` decorator (or a forced literal schema like `notebook_ask.ASK_TOOL`).
+The agent calls it at experiment planning and **patches it on each tactic transition** (begin / end /
+phase-change). Prompt guidance (in `harness/prompts/templates.py`, beside the monitoring-mode decision
+table) tells the agent to keep its Operation Plan current as it operates.
+
+### 2.2 Model — store the plan in `FileContextStore`
+A new domain beside `session_intents`/`active/`: `agent/operation_plans/{session_id}.yaml`. Add
+`set_operation_plan` / `get_operation_plan` to `FileContextStore` and fire the existing
+`CONTEXT_UPDATED` (the store's `_notify_*` already broadcasts to `/ws`). The plan is an agent-authored
+typed artifact exactly like campaigns/plan-items already are.
+
+### 2.3 Consumer — Operations renders plan ⊕ live binding
+- Route `GET /api/operation_plan/{session_id}` (mirror `routes/context.py`) returns the plan.
+- The renderer (the **operation spine**, generalized): one node per tactic in used/active/queued state.
+  The active node blooms open and **binds live telemetry** by `live_bind` keys — temperature gauge,
+  current burst, phase progress, cadence — sourced from the orchestrator `get_status` /
+  `strategy_snapshot` / the tactic events C emits. Per-embryo cadence (standing/async) shows as a
+  compact strip in the standing-tactic node. Reactive monitors render watch+reaction+status; scripted
+  protocols render the before/during/after stepper.
+- Live refresh: subscribe to `CONTEXT_UPDATED` (plan changed) + the tactic telemetry events
+  (`TEMP_PROTOCOL_*`, `BURST_*`, `EMBRYO_CADENCE_CHANGED`, `POWER_RAMP_STEP`, `TEMPERATURE_SETPOINT_CHANGED`)
+  → debounced refetch+render. (Mirrors `experiment-strip.js` / `context-surface.js`.)
+- **Audit fixes** (from the design audit) baked into the renderer: queued reads as a cocked instrument
+  (blue thread + "next" marker), the active phase/status is the headline, flatten the card (no
+  card-in-card), the active row's whole left column is amber + colored left edge per state, copy =
+  "queued", keep mono instrument values + domain copy.
+
+### 2.4 Scenario test mode (your "test it for real experiments" + "different tactic cases")
+A repo scenario library of **Operation Plan fixtures** (the prototyped six cases, now as plan objects):
+temp-strain, expression-onset, pre-hatching/hatching-detect, transmission survey, decided-plan, idle —
+plus async-multi-embryo. `?scenario=<name>` (dev-gated) renders a fixture with no agent/fetch, so
+Operations is developable/auditable offline against any tactic case. The fixtures double as the test
+corpus + a Chrome-MCP audit target.
 
 ## 3. Data flow
-events → EventBus → websocket → `ClientEventBus` → debounced refetch → `/strategy` (now with
-`operation`) → `build_operation_view` → spine renderer. In scenario mode: `?scenario=` → fixture →
-same renderer (no fetch).
-
-## 4. Error/empty
-- No active operation / no tactics → calm **idle** state ("When the agent begins operating by tactic,
-  the plan and live progress appear here"), not a dead screen.
-- Snapshot lacks `operation` (older session) → renderer falls back to a minimal "no tactic data" note.
-- Unknown tactic `kind` → renders generically from `name`/`summary`/`readouts` (the model is kind-agnostic).
-
-## 5. Testing
-- Backend: `build_operation_view` over a hand-written snapshot → asserts the tactic list states +
-  the temp-protocol tactic's phases + a queued tactic's trigger.
-- Frontend: `node --check`; the **scenario library** doubles as the test corpus — a Chrome-MCP audit
-  across all six fixtures (the harness, promoted); UI audit per the audit fixes. Live rig verification deferred.
-- Scenario mode itself is the regression harness: any tactic case can be loaded and visually checked.
-
-## 6. Out of scope
-- A general user-/agent-authored persisted tactic *library* (G) — D presents tactics; G lets users
-  define/save them.
-- The Rules view rework; multi-embryo concurrent-operation layout (single active operation for now,
-  though the model + spine extend to a stack of operations later).
+agent → `declare_operation_plan` (forced typed) → `FileContextStore` → `CONTEXT_UPDATED` → `/ws` →
+Operations refetch → `/api/operation_plan` (the plan) **⊕** live telemetry (`get_status` /
+`strategy_snapshot` / events) bound by `live_bind` → spine renderer. Scenario mode: `?scenario=` →
+fixture plan → same renderer.
+
+## 4. Why agent-authored over backend reconstruction
+`strategy_snapshot.py` already reconstructs the picture by replaying `timeline.jsonl` and re-instantiating
+modes — but every new tactic kind needs new reconstruction heuristics, and it can only ever *infer*
+intent. The agent *is* the composer; it should *declare* its tactics (authoritative, open-ontology,
+self-describing). The backend keeps providing **live values** (what it's good at), not tactic identity.
+
+## 5. Convergence with G (tactics library)
+Once tactics are typed, agent-authored objects, **G is "save/reuse these typed tactics"** and D is
+"render the active plan of them." This spec is the shared substrate for both — settling it unblocks
+both sub-projects.
+
+## 6. Testing
+- Store: `set/get_operation_plan` round-trip + `CONTEXT_UPDATED` fired.
+- Tool: the forced `declare_operation_plan` returns a schema-valid plan (mirror the notebook_ask test).
+- Route: `/api/operation_plan/{session}` returns the stored plan; 404/empty handled.
+- Renderer: `node --check` + Chrome-MCP audit across the scenario fixtures (all tactic kinds render).
+- Live binding: a unit test that telemetry maps onto a tactic's `live_bind` keys.
+- Rig-deferred: the real agent emitting a live plan during an experiment.
+
+## 7. Out of scope (v3)
+- Full multi-embryo concurrent lanes (v1 = one standing mode + layered tactics + a per-embryo strip).
+- G's authoring/save UI (this spec defines the tactic object G will reuse).
+- Migrating away from `strategy_snapshot` for the legacy swimlane consumers (Operations is the new view).

From 9d0c7d88d5013a4dd72445d7729f9b65cd327996 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:37:23 +0530
Subject: [PATCH 206/314] =?UTF-8?q?docs(operations):=20v3=20plan=20?=
 =?UTF-8?q?=E2=80=94=20agent-authored=20Operation=20Plan=20(5=20tasks,=20b?=
 =?UTF-8?q?ackend-first)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../plans/2026-06-28-operations-tab.md        | 86 +++++++------------
 1 file changed, 33 insertions(+), 53 deletions(-)

diff --git a/docs/superpowers/plans/2026-06-28-operations-tab.md b/docs/superpowers/plans/2026-06-28-operations-tab.md
index ab1768b2..e6a5c347 100644
--- a/docs/superpowers/plans/2026-06-28-operations-tab.md
+++ b/docs/superpowers/plans/2026-06-28-operations-tab.md
@@ -1,70 +1,50 @@
-# Operations — operation spine (D, redesigned) Implementation Plan
+# Operations — agent-authored Operation Plan (D v3) Implementation Plan
 
 > **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development. Steps use `- [ ]`.
 
-**Goal:** Replace the legacy swimlane with a data-driven **operation-spine** Operations view that shows tactics planned/in-use/used, renders any tactic case from a generic model, and is testable offline via scenario fixtures.
+**Goal:** The agent emits a typed Operation Plan (its tactics, planned/active/done); Operations renders it ⊕ live telemetry. Built backend-first (the user-directed, low-rework part), then the renderer.
 
-**Architecture:** A generic *operation* model (tactics with state + optional live readouts/phases); a rewritten `experiment-overview.js` overview = the spine renderer (audit fixes baked in); a repo scenario library (6 fixtures) + `?scenario=` dev mode; a backend `build_operation_view(snapshot)` transform served on `/strategy`; live event-driven refresh.
+**Architecture:** A typed `OperationPlan` in `FileContextStore` (new domain), written by a forced-tool agent call, served on a route, rendered by a data-driven operation-spine generalized for tactic kinds, with live-telemetry binding + scenario test mode.
 
-**Reference (the validated prototype — read it for the exact renderer, CSS, model, and fixtures):**
-`/tmp/claude-1000/-home-dna-lab-projects-gently/3192c9a4-bc99-4c0a-9cbd-e094de730bcf/scratchpad/opsdesign/harness.html`
+**Tech Stack:** Python (FileContextStore YAML, the `@tool`/forced-`tool_choice` pattern, EventBus `CONTEXT_UPDATED`), FastAPI route, vanilla-JS + SVG renderer, pytest.
 
 ## Global Constraints
-- Keep the Experiment→Operations rename (done) + the burst-`phase` event (done). DISCARD the swimlane band.
-- Operation model: `{title, session, tactics:[{seq, state:'used'|'active'|'queued', name, kind, target?, summary?, desc?, trigger?, live?:{readouts:[{label,value,sub?,bar?}], phases?:[{name,state:'done'|'active'|'todo',count,pips:[...]}]}}]}`.
-- Audit fixes (baked into the renderer): (1) queued spine is colored blue + first queued marked "next" (decided-plan must read as a cocked instrument, not empty); (2) active phase dominates + "awaiting lock"-style status is the phase headline; (3) FLATTEN — no card-in-card, values on the panel face + hairline dividers; (4) active row's whole left column amber + colored left edge per state (green/amber/blue); (5) copy "queued" (not "going to be used"), replace "first/second/last" with `trigger`. Keep mono instrument values + domain copy.
-- Renderer must handle ALL six fixtures (phased protocol, readout monitor, one-shot, all-queued, idle) without error.
-- No new endpoint: extend `/api/experiments/{session}/strategy` payload with an `operation` object.
-- Frontend has no JS unit harness → `node --check` + Chrome-MCP audit across fixtures.
+- Source of truth = the agent's typed plan (NOT a backend reconstruction). Live telemetry binds onto declared tactics; the agent declares tactic identity, the system supplies live values.
+- Plan schema (see spec §1): `{session_id,title,goal,tactics:[{id,name,kind,state,scope,rationale,structure,live_bind,relations}],updated_at,updated_reason}`. `kind∈{standing_timelapse,reactive_monitor,scripted_protocol,exclusive_burst,oneshot,custom}`, `state∈{planned,active,done}`. No round-robin.
+- Forced typed output mirrors `gently/harness/memory/notebook_ask.py` (ASK_TOOL + `tool_choice={'type':'tool',...}` → validated `block.input`) OR the `@tool` auto-schema (`harness/tools/registry.py`).
+- Store mirrors `session_intents`/`active/` domains; fire the existing `CONTEXT_UPDATED`.
+- Route mirrors `gently/ui/web/routes/context.py` (`/api/context`).
+- Renderer = the validated operation-spine (harness `scratchpad/opsdesign/harness.html`) with the audit fixes (queued reads cocked + "next" marker; active phase/status is the headline; flatten — no card-in-card; whole-left-column amber + colored left edge per state; copy "queued"; mono values). Generalize for the tactic kinds (standing→per-embryo cadence strip; reactive→watch/reaction/status; scripted→phases).
+- Frontend: no JS harness → `node --check` + Chrome-MCP audit across scenario fixtures.
 - Git hygiene: stage only your files by explicit path; never `git add -A`.
 
 ---
 
-### Task 1: Discard the swimlane band
-**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (+ its css) — revert the tactic-band rendering added in commit 2a3d8b0, returning the Overview to its pre-band baseline (the spine replaces it in Task 2). Keep everything else (Rules view, modes, etc.).
-- [ ] **Step 1:** `git revert --no-commit 2a3d8b0` (or manually remove the band code + css if revert conflicts), keeping the rename (Task-1) and burst-phase (Task-2) commits intact. Confirm `git diff` shows only the band removal.
-- [ ] **Step 2:** `node --check gently/ui/web/static/js/experiment-overview.js` (exit 0).
-- [ ] **Step 3: commit** — `git add gently/ui/web/static/js/experiment-overview.js <css> && git commit -m "feat(operations): discard swimlane tactic-band (replaced by operation spine)"`
+### Task 1: OperationPlan model + FileContextStore domain
+**Files:** Create/extend `gently/harness/memory/model.py` (an `OperationPlan`/`Tactic` dataclass or a documented dict schema); Modify `gently/harness/memory/file_store.py` (`set_operation_plan(session_id, plan)` / `get_operation_plan(session_id)`, YAML under `agent/operation_plans/{session_id}.yaml`, fire `CONTEXT_UPDATED`). Test: `tests/test_operation_plan_store.py`.
+- [ ] Confirm the real `FileContextStore` domain pattern from `set_session_intent`/`create_session_intent` (~file_store.py:758) + the `_notify_*`/`CONTEXT_UPDATED` emit. Mirror it.
+- [ ] TDD: set→get round-trip preserves the tactics list + states; `CONTEXT_UPDATED` fired on set. `pytest tests/test_operation_plan_store.py -v`; `pytest -q` clean. Commit `feat(operations): OperationPlan store domain in FileContextStore`.
 
----
-
-### Task 2: Scenario library + the operation-spine renderer (the core)
-**Files:** Create `gently/ui/web/static/js/operations-scenarios.js` (the 6 fixtures, promoted from the harness); Modify `gently/ui/web/static/js/experiment-overview.js` (replace the Overview render path with the data-driven spine renderer from the harness, audit fixes applied) + the experiment css (spine/node/phase styles from the harness). Verify: `node --check` + Chrome-MCP audit.
-
-**Interfaces:** Produces `OperationView.render(rootEl, operationModel)` (or fold into `ExperimentOverview`); consumes the operation model (§ Global Constraints) from the live snapshot (Task 3) or a scenario fixture; `OPERATIONS_SCENARIOS` (the fixture map) + a `?scenario=<name>` loader (dev mode).
-
-- [ ] **Step 1: port the fixtures** — create `operations-scenarios.js` exposing `window.OPERATIONS_SCENARIOS = {temp_strain, expression_onset, pre_hatching, transmission_survey, decided_plan, idle}` — copy the fixture objects from the harness `SCENARIOS` (the `.op` values), as the repo test corpus. Apply the copy fixes: `state:'queued'` (not 'planned' label), add `trigger` fields ("when temp locks", "after #1", etc.) replacing "first/second/last".
-- [ ] **Step 2: the renderer** — port the harness renderer (`renderOperation`/`renderTactic`/`renderReadout`/`renderPhase`) into `experiment-overview.js`, replacing the swimlane Overview path, WITH the audit fixes: state-colored spine connector (green/amber/blue-dashed), whole-left-column amber for active, colored left edge per state, flattened active card (remove inner card backgrounds; hairline divider between readouts and phases), active phase dominant + status headline, first-queued "next" marker, `STATE_LABEL.queued='queued'`. Keep mono labels.
-- [ ] **Step 3: scenario dev mode** — on init, if `new URLSearchParams(location.search).get('scenario')` matches a fixture, render that fixture (no fetch); else fetch the live operation (Task 3). Guard so scenario mode is opt-in via the param.
-- [ ] **Step 4: `node --check`** both JS files (exit 0).
-- [ ] **Step 5: Chrome-MCP audit** — serve the static files, load `?scenario=temp_strain`, `expression_onset`, `decided_plan`, `idle`; screenshot each; verify the audit fixes (queued reads cocked, active dominates, flattened, amber left column, "queued" copy) and that all six render without error; fix flaws.
-- [ ] **Step 6: commit** — `feat(operations): operation-spine renderer + scenario library (data-driven, 6 cases)`
-
----
+### Task 2: `declare_operation_plan` agent tool (forced typed output)
+**Files:** Create `gently/app/tools/operation_plan_tools.py` (+ register in `tools/__init__`). Test: `tests/test_operation_plan_tool.py`.
+- [ ] Confirm the `@tool` decorator + the forced-tool pattern (registry.py auto-schema, or a literal schema like notebook_ask.ASK_TOOL). The tool accepts the typed plan (tactics list) and writes it via `store.set_operation_plan`. Resolve the store from context (mirror existing memory tools).
+- [ ] TDD: calling the tool with a plan persists it (get returns it) + returns a confirmation; missing store → error. `pytest tests/test_operation_plan_tool.py -v`; `pytest -q` clean. Commit `feat(operations): declare_operation_plan typed agent tool`.
 
-### Task 3: Backend transform `build_operation_view`
-**Files:** Modify `gently/ui/web/strategy_snapshot.py` (add `build_operation_view(snapshot)` mapping the snapshot → operation model; have `build_strategy_snapshot` include `operation` in its return, OR add it in the route). Test: `tests/test_operation_view.py`.
+### Task 3: Route `GET /api/operation_plan/{session_id}`
+**Files:** Create `gently/ui/web/routes/operation_plan.py` (+ register in `routes/__init__.py`). Test: `tests/test_operation_plan_route.py`.
+- [ ] Mirror `routes/context.py` / `routes/temperature.py` `_resolve_session` + `server.context_store`/`gently_store` resolution. Return the stored plan; 404/empty handled; `session=current` resolves newest.
+- [ ] TDD (TestClient + mock store): returns the plan; empty when none. `pytest tests/test_operation_plan_route.py -v`; `pytest -q` clean. Commit `feat(operations): GET /api/operation_plan/{session} route`.
 
-**Interfaces:** Produces `build_operation_view(snapshot: dict) -> dict` (the operation model); `/api/experiments/{session}/strategy` response gains `operation`.
+### Task 4: The operation-spine renderer + scenario library (frontend)
+**Files:** Create `gently/ui/web/static/js/operations-scenarios.js` (plan fixtures: temp_strain, expression_onset, hatching_detect, transmission_survey, decided_plan, async_multi, idle); Rewrite the Overview path in `gently/ui/web/static/js/experiment-overview.js` to the data-driven operation-spine (generalized per tactic kind, audit fixes); port CSS to `experiment.css`. Reference: `scratchpad/opsdesign/harness.html`.
+- [ ] Port the renderer (renderOperation/renderTactic/renderReadout/renderPhase) + add per-kind rendering: standing→per-embryo cadence strip; reactive→watch/reaction/status; scripted→phase stepper; exclusive/oneshot→compact. Audit fixes baked in. `?scenario=` dev mode loads a fixture.
+- [ ] `node --check` both JS; build a Chrome-MCP harness at `scratchpad/opsv3/` (real repo files) for the controller to audit across fixtures. Commit `feat(operations): operation-spine renderer + plan scenario library (data-driven)`.
 
-- [ ] **Step 1: failing test** — feed a snapshot dict (one embryo with a `temp_protocol` band {start,end,target_setpoint_c}, `setpoint_changes`, phased bursts, and an active monitoring mode) to `build_operation_view`; assert the returned `operation.tactics` includes: a `used` monitor tactic, an `active` temp-change tactic whose `live.phases` reflect before/during/after, and the `state`s are correct. (Confirm the real snapshot shape from `tests/test_temp_protocol_snapshot.py`.)
-- [ ] **Step 2: run, FAIL.**
-- [ ] **Step 3: implement** `build_operation_view`: derive tactics from the snapshot — completed monitoring modes/bursts → `used`; the active `temp_protocol`/monitoring mode → `active` (with readouts from temp + current burst, phases from the protocol's before/during/after burst counts); planned/queued items → `queued`. Map fields into the §model. Include `operation` in the snapshot/route payload.
-- [ ] **Step 4: run, PASS;** `pytest -q` clean.
-- [ ] **Step 5: commit** — `feat(operations): build_operation_view transform on the strategy snapshot`
-
----
-
-### Task 4: Live refresh
-**Files:** Modify `experiment-overview.js` (`init` — subscribe + debounced refetch, mirroring `experiment-strip.js`). Verify: `node --check` + harness (simulate an event → refetch).
-- [ ] **Step 1:** in `init`, after the initial live fetch, register `ClientEventBus.on(...)` for `TEMP_PROTOCOL_STARTED`,`TEMP_PROTOCOL_COMPLETED`,`TEMPERATURE_SETPOINT_CHANGED`,`BURST_START`,`BURST_COMPLETE`,`EMBRYO_CADENCE_CHANGED`,`POWER_RAMP_STEP`, each → a debounced (~500ms) refetch+render. Guard against double-registration; skip in scenario mode.
-- [ ] **Step 2:** `node --check` (exit 0).
-- [ ] **Step 3: harness** — dispatch a `ClientEventBus.emit('TEMP_PROTOCOL_STARTED', {...})` and confirm a (stubbed) refetch fires after the debounce.
-- [ ] **Step 4: commit** — `feat(operations): live event-driven refresh`
-
----
+### Task 5: Live binding + refresh
+**Files:** Modify `experiment-overview.js` (fetch `/api/operation_plan`, bind live telemetry from `/strategy`/get_status onto tactics by `live_bind`, subscribe `CONTEXT_UPDATED` + tactic events → debounced refetch).
+- [ ] Bind temperature/current-burst/cadence/signal onto declared tactics' readouts/progress; live refresh on plan-change + telemetry events (debounced). `node --check`; harness check. Commit `feat(operations): live telemetry binding + event-driven refresh`.
 
 ## Self-Review
-- Discard swimlane → Task 1; renderer+scenarios → Task 2 (audit fixes baked in); backend transform → Task 3; live refresh → Task 4. ✓
-- Open confirmations: the real snapshot shape (Task 3, from C's snapshot test); the `experiment-overview.js` Overview render seam to replace (Task 2, read the harness for the target renderer); the css file for experiment styles (Task 1/2).
-- Type consistency: the operation model fields are identical across the fixtures (Task 2), the transform (Task 3), and the renderer (Task 2).
+- Store→Task1; tool→Task2; route→Task3; renderer+scenarios→Task4 (audit fixes); live binding→Task5. ✓
+- Open confirmations: FileContextStore domain pattern (T1), the forced-tool/@tool pattern (T2), the route store-resolution (T3), the Overview render seam + harness renderer (T4), the live telemetry sources (T5).
+- Type consistency: the plan/tactic schema is identical across store (T1), tool (T2), route (T3), fixtures+renderer (T4), binding (T5).

From 192fe97e5fe084dfa296b5e728e84d29306ebaeb Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:41:21 +0530
Subject: [PATCH 207/314] feat(operations): OperationPlan store domain in
 FileContextStore
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add set_operation_plan / get_operation_plan to FileContextStore under
agent/operation_plans/{session_id}.yaml, mirroring the session_intents
domain (atomic _write_yaml, parse-cached _read_yaml). set fires
_notify_context_change('operation_plan') → CONTEXT_UPDATED so the
Operations UI live-refreshes.

10 tests: round-trip fidelity (tactics list, states, nested structure,
overwrite, independent sessions, missing→None) + CONTEXT_UPDATED fired
on set (kind='operation_plan') and silent on get.
---
 gently/harness/memory/file_store.py |  19 +++
 tests/test_operation_plan_store.py  | 173 ++++++++++++++++++++++++++++
 2 files changed, 192 insertions(+)
 create mode 100644 tests/test_operation_plan_store.py

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index ececeba2..0e831c12 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -811,6 +811,25 @@ def complete_session_intent(self, session_id: str, actual_summary: str):
         data["completed_at"] = self._now()
         self._write_yaml(path, data)
 
+    # ==================================================================
+    # Operation Plans
+    # ==================================================================
+
+    def set_operation_plan(self, session_id: str, plan: dict) -> None:
+        """Persist the agent-authored Operation Plan for a session.
+
+        The plan dict is stored verbatim (agent is the source of truth).
+        Fires CONTEXT_UPDATED so the Operations UI refreshes live.
+        """
+        path = self.agent_dir / "operation_plans" / f"{session_id}.yaml"
+        self._write_yaml(path, plan)
+        self._notify_context_change("operation_plan")
+
+    def get_operation_plan(self, session_id: str) -> dict | None:
+        """Return the stored Operation Plan for a session, or None if absent."""
+        path = self.agent_dir / "operation_plans" / f"{session_id}.yaml"
+        return self._read_yaml(path)
+
     # ==================================================================
     # Session <-> Campaign (many-to-many)
     # ==================================================================
diff --git a/tests/test_operation_plan_store.py b/tests/test_operation_plan_store.py
new file mode 100644
index 00000000..c656e410
--- /dev/null
+++ b/tests/test_operation_plan_store.py
@@ -0,0 +1,173 @@
+"""
+FileContextStore: OperationPlan domain — set/get round-trip + CONTEXT_UPDATED event.
+
+Domain: agent/operation_plans/{session_id}.yaml
+Methods: set_operation_plan / get_operation_plan
+"""
+
+from gently.core.event_bus import EventType, on
+
+
+# ---------------------------------------------------------------------------
+# Fixture helpers
+# ---------------------------------------------------------------------------
+
+_PLAN = {
+    "session_id": "sess_001",
+    "title": "Temperature-strain protocol",
+    "goal": "Characterise onset timing under 25 °C ramp",
+    "tactics": [
+        {
+            "id": "t1",
+            "name": "Baseline timelapse",
+            "kind": "standing_timelapse",
+            "state": "done",
+            "scope": {"mode": "global"},
+            "rationale": "Establish pre-ramp cadence",
+            "structure": {
+                "cadence_s": 120,
+                "per_embryo": [
+                    {"embryo_id": "e1", "cadence_phase": "normal", "interval_s": 120}
+                ],
+            },
+            "live_bind": ["cadence"],
+            "relations": {},
+        },
+        {
+            "id": "t2",
+            "name": "Temp ramp monitor",
+            "kind": "reactive_monitor",
+            "state": "active",
+            "scope": {"mode": "global"},
+            "rationale": "Detect onset event triggered by ramp",
+            "structure": {
+                "watch": "temperature > 24.5",
+                "reaction": "burst_capture",
+                "status": "armed",
+            },
+            "live_bind": ["temperature", "signal"],
+            "relations": {"after": ["t1"]},
+        },
+        {
+            "id": "t3",
+            "name": "Post-ramp survey",
+            "kind": "oneshot",
+            "state": "planned",
+            "scope": {"mode": "embryos", "embryo_ids": ["e1", "e2"]},
+            "rationale": "Confirm recovery after ramp completion",
+            "structure": {"note": "single high-res z-stack per embryo"},
+            "live_bind": [],
+            "relations": {"after": ["t2"]},
+        },
+    ],
+    "updated_at": "2026-06-28T10:00:00",
+    "updated_reason": "initial plan",
+}
+
+
+# ---------------------------------------------------------------------------
+# Tests
+# ---------------------------------------------------------------------------
+
+
+class TestOperationPlanRoundTrip:
+    def test_set_then_get_returns_plan(self, file_context_store):
+        """set_operation_plan followed by get_operation_plan returns the full dict."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_001", _PLAN)
+        result = cs.get_operation_plan("sess_001")
+        assert result is not None
+        assert result["session_id"] == "sess_001"
+        assert result["title"] == "Temperature-strain protocol"
+
+    def test_tactics_list_preserved(self, file_context_store):
+        """All three tactics are returned with their ids and kinds intact."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_001", _PLAN)
+        result = cs.get_operation_plan("sess_001")
+        tactics = result["tactics"]
+        assert len(tactics) == 3
+        ids = [t["id"] for t in tactics]
+        assert ids == ["t1", "t2", "t3"]
+        kinds = [t["kind"] for t in tactics]
+        assert kinds == ["standing_timelapse", "reactive_monitor", "oneshot"]
+
+    def test_tactic_states_preserved(self, file_context_store):
+        """State values (done / active / planned) survive the YAML round-trip."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_001", _PLAN)
+        result = cs.get_operation_plan("sess_001")
+        states = {t["id"]: t["state"] for t in result["tactics"]}
+        assert states == {"t1": "done", "t2": "active", "t3": "planned"}
+
+    def test_nested_structure_preserved(self, file_context_store):
+        """Nested fields (scope, structure, live_bind, relations) survive intact."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_001", _PLAN)
+        result = cs.get_operation_plan("sess_001")
+        t2 = next(t for t in result["tactics"] if t["id"] == "t2")
+        assert t2["structure"]["status"] == "armed"
+        assert "temperature" in t2["live_bind"]
+        assert t2["relations"]["after"] == ["t1"]
+
+    def test_get_missing_returns_none(self, file_context_store):
+        """get_operation_plan returns None when no plan exists for the session."""
+        result = file_context_store.get_operation_plan("no_such_session")
+        assert result is None
+
+    def test_overwrite_replaces_plan(self, file_context_store):
+        """A second set_operation_plan replaces the first."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_001", _PLAN)
+        updated = dict(_PLAN, title="Revised plan", updated_reason="tactic t2 fired")
+        cs.set_operation_plan("sess_001", updated)
+        result = cs.get_operation_plan("sess_001")
+        assert result["title"] == "Revised plan"
+        assert result["updated_reason"] == "tactic t2 fired"
+
+    def test_independent_sessions(self, file_context_store):
+        """Plans for different session_ids are stored independently."""
+        cs = file_context_store
+        plan_a = dict(_PLAN, session_id="sess_A", title="Plan A")
+        plan_b = dict(_PLAN, session_id="sess_B", title="Plan B")
+        cs.set_operation_plan("sess_A", plan_a)
+        cs.set_operation_plan("sess_B", plan_b)
+        assert cs.get_operation_plan("sess_A")["title"] == "Plan A"
+        assert cs.get_operation_plan("sess_B")["title"] == "Plan B"
+
+
+class TestOperationPlanContextUpdatedEvent:
+    def test_set_fires_context_updated(self, file_context_store):
+        """set_operation_plan emits CONTEXT_UPDATED on the global event bus."""
+        cs = file_context_store
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            cs.set_operation_plan("sess_001", _PLAN)
+        finally:
+            unsub()
+        assert len(seen) >= 1
+
+    def test_context_updated_kind_is_operation_plan(self, file_context_store):
+        """The CONTEXT_UPDATED event carries kind='operation_plan'."""
+        cs = file_context_store
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            cs.set_operation_plan("sess_001", _PLAN)
+        finally:
+            unsub()
+        kinds = [(e.data or {}).get("kind") for e in seen]
+        assert "operation_plan" in kinds
+
+    def test_get_does_not_fire_event(self, file_context_store):
+        """get_operation_plan is read-only and must not emit CONTEXT_UPDATED."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_001", _PLAN)
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            cs.get_operation_plan("sess_001")
+        finally:
+            unsub()
+        assert len(seen) == 0

From 1472dd086d5c8c61edad6a87c603690140cf2318 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:51:39 +0530
Subject: [PATCH 208/314] feat(operations): declare_operation_plan typed agent
 tool
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds the declare_operation_plan @tool for the agent to author its typed
Operation Plan (tactics: planned/active/done) per experiment session.

- gently/app/tools/operation_plan_tools.py: @tool decorator, signature
  (title, goal, tactics, updated_reason, context), _validate_tactics helper
  (clamps unknown kinds to 'custom', rejects invalid states), stamps
  updated_at, resolves session_id + context_store via agent in context,
  calls store.set_operation_plan(session_id, plan).
- gently/app/tools/__init__.py: registers operation_plan_tools module.
- tests/test_operation_plan_tool.py: 15 TDD tests — happy path round-trip,
  tactics preserved, unknown-kind clamping, three error paths (no agent, no
  store, no session), two validation-error paths, registry discoverability,
  schema required-fields check.
---
 gently/app/tools/__init__.py             |   2 +
 gently/app/tools/operation_plan_tools.py | 195 +++++++++++
 tests/test_operation_plan_tool.py        | 424 +++++++++++++++++++++++
 3 files changed, 621 insertions(+)
 create mode 100644 gently/app/tools/operation_plan_tools.py
 create mode 100644 tests/test_operation_plan_tool.py

diff --git a/gently/app/tools/__init__.py b/gently/app/tools/__init__.py
index 16d7aebb..b3b31d1b 100644
--- a/gently/app/tools/__init__.py
+++ b/gently/app/tools/__init__.py
@@ -38,6 +38,7 @@
     led_tools,
     light_source_tools,
     memory_tools,
+    operation_plan_tools,
     plan_execution_tools,
     resolution_tools,
     session_tools,
@@ -85,6 +86,7 @@ def register_all_tools():
     "led_tools",
     "light_source_tools",
     "memory_tools",
+    "operation_plan_tools",
     "plan_execution_tools",
     "resolution_tools",
     "session_tools",
diff --git a/gently/app/tools/operation_plan_tools.py b/gently/app/tools/operation_plan_tools.py
new file mode 100644
index 00000000..07d51835
--- /dev/null
+++ b/gently/app/tools/operation_plan_tools.py
@@ -0,0 +1,195 @@
+"""
+Operation Plan tool — lets the agent declare/update its typed Operation Plan.
+
+The agent calls this at experiment planning time to register the tactics it
+intends to run, and calls it again on each tactic transition (planned →
+active → done).  The plan is stored in FileContextStore and fires
+CONTEXT_UPDATED so the Operations UI refreshes live.
+"""
+
+import logging
+from datetime import datetime, timezone
+
+from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
+
+logger = logging.getLogger(__name__)
+
+# Valid kind / state values per §1 of the spec
+_VALID_KINDS = frozenset(
+    {
+        "standing_timelapse",
+        "reactive_monitor",
+        "scripted_protocol",
+        "exclusive_burst",
+        "oneshot",
+        "custom",
+    }
+)
+_VALID_STATES = frozenset({"planned", "active", "done"})
+
+
+def _validate_tactics(tactics: list) -> list[dict]:
+    """Validate and normalise a tactics list.
+
+    Each tactic must have id, name, kind, state.
+    Unknown kinds are clamped to 'custom'.
+    Invalid states raise ValueError.
+    """
+    validated = []
+    for i, t in enumerate(tactics):
+        if not isinstance(t, dict):
+            raise ValueError(f"Tactic at index {i} must be a dict, got {type(t).__name__}")
+        for required_field in ("id", "name", "kind", "state"):
+            if not t.get(required_field):
+                raise ValueError(f"Tactic at index {i} missing required field '{required_field}'")
+        tactic = dict(t)
+        kind = tactic["kind"]
+        if kind not in _VALID_KINDS:
+            logger.warning(
+                "Tactic '%s' has unknown kind '%s' — clamped to 'custom'",
+                tactic.get("id"),
+                kind,
+            )
+            tactic["kind"] = "custom"
+        state = tactic["state"]
+        if state not in _VALID_STATES:
+            raise ValueError(
+                f"Tactic '{tactic.get('id')}' has invalid state '{state}'. "
+                f"Must be one of: {sorted(_VALID_STATES)}"
+            )
+        validated.append(tactic)
+    return validated
+
+
+@tool(
+    name="declare_operation_plan",
+    description=(
+        "Declare or update the Operation Plan for the current experiment session. "
+        "Call this at experiment planning time to register the tactics you intend to "
+        "run, and call it again whenever a tactic's state changes (planned → active → "
+        "done) or a new tactic is added. "
+        "kind ∈ {standing_timelapse, reactive_monitor, scripted_protocol, "
+        "exclusive_burst, oneshot, custom}. "
+        "state ∈ {planned, active, done}. "
+        "Unknown kinds are clamped to 'custom'."
+    ),
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample(
+            user_query="Declare my experiment plan: baseline timelapse + onset monitor",
+            tool_input={
+                "title": "Expression-onset survey",
+                "goal": "Catch GFP onset under 25 C ramp",
+                "tactics": [
+                    {
+                        "id": "t1",
+                        "name": "Baseline timelapse",
+                        "kind": "standing_timelapse",
+                        "state": "active",
+                        "scope": {"mode": "global"},
+                        "rationale": "Continuous pre-ramp imaging",
+                        "structure": {"cadence_s": 120, "per_embryo": []},
+                        "live_bind": ["cadence"],
+                        "relations": {},
+                    }
+                ],
+                "updated_reason": "experiment started",
+            },
+        ),
+        ToolExample(
+            user_query="Update the plan: baseline is done, onset monitor is now active",
+            tool_input={
+                "title": "Expression-onset survey",
+                "goal": "Catch GFP onset under 25 C ramp",
+                "tactics": [
+                    {
+                        "id": "t1",
+                        "name": "Baseline timelapse",
+                        "kind": "standing_timelapse",
+                        "state": "done",
+                        "scope": {"mode": "global"},
+                        "rationale": "Continuous pre-ramp imaging",
+                        "structure": {"cadence_s": 120, "per_embryo": []},
+                        "live_bind": ["cadence"],
+                        "relations": {},
+                    },
+                    {
+                        "id": "t2",
+                        "name": "Onset monitor",
+                        "kind": "reactive_monitor",
+                        "state": "active",
+                        "scope": {"mode": "global"},
+                        "rationale": "Watch for GFP signal crossing threshold",
+                        "structure": {
+                            "watch": "gfp_signal > 0.3",
+                            "reaction": "burst_capture",
+                            "status": "armed",
+                        },
+                        "live_bind": ["signal", "current_burst"],
+                        "relations": {"after": ["t1"]},
+                    },
+                ],
+                "updated_reason": "t1 done, t2 now active",
+            },
+        ),
+    ],
+)
+async def declare_operation_plan(
+    title: str,
+    goal: str,
+    tactics: list,
+    updated_reason: str = "",
+    context: dict | None = None,
+) -> str:
+    """Declare or update the typed Operation Plan for this session.
+
+    Parameters
+    ----------
+    title : str
+        Short title for this experiment's plan.
+    goal : str
+        The agent's framing of what this run is trying to achieve.
+    tactics : list
+        List of tactic dicts.  Each must have id, name, kind, state.
+    updated_reason : str
+        Why the plan is being updated (e.g. 't2 transitioned to active').
+    context : dict
+        Injected by the tool runtime — do not pass manually.
+    """
+    agent, err = require_agent(context)
+    if err:
+        return err
+
+    cs = getattr(agent, "context_store", None)
+    if cs is None:
+        return "Error: Context store not available — cannot persist Operation Plan"
+
+    session_id = getattr(agent, "session_id", None)
+    if not session_id:
+        return "Error: No active session — cannot persist Operation Plan"
+
+    try:
+        validated_tactics = _validate_tactics(tactics)
+    except ValueError as e:
+        return f"Error: {e}"
+
+    plan = {
+        "session_id": session_id,
+        "title": title,
+        "goal": goal,
+        "tactics": validated_tactics,
+        "updated_at": datetime.now(timezone.utc).isoformat(),
+        "updated_reason": updated_reason,
+    }
+
+    cs.set_operation_plan(session_id, plan)
+
+    n = len(validated_tactics)
+    counts = {s: sum(1 for t in validated_tactics if t["state"] == s) for s in _VALID_STATES}
+    parts = [f"{s}:{c}" for s, c in counts.items() if c]
+    states_summary = ", ".join(parts)
+    return (
+        f"Operation Plan stored for session {session_id}: "
+        f"'{title}' — {n} tactic{'s' if n != 1 else ''} ({states_summary})"
+    )
diff --git a/tests/test_operation_plan_tool.py b/tests/test_operation_plan_tool.py
new file mode 100644
index 00000000..ad6804d6
--- /dev/null
+++ b/tests/test_operation_plan_tool.py
@@ -0,0 +1,424 @@
+"""
+Tests for the declare_operation_plan agent tool (Task 2).
+
+TDD — three concerns:
+  1. Happy path: calling the tool persists the plan; store returns it.
+  2. Error paths: missing store, missing session → error string, no write.
+  3. Registration: tool is discoverable in the global registry after import.
+"""
+
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# Fakes
+# ---------------------------------------------------------------------------
+
+
+class FakeContextStore:
+    """Minimal in-memory stand-in for FileContextStore."""
+
+    def __init__(self):
+        self._plans: dict[str, dict] = {}
+        self.calls: list[tuple] = []
+
+    def set_operation_plan(self, session_id: str, plan: dict) -> None:
+        self._plans[session_id] = plan
+        self.calls.append(("set", session_id, plan))
+
+    def get_operation_plan(self, session_id: str) -> dict | None:
+        return self._plans.get(session_id)
+
+
+class FakeAgent:
+    """Minimal fake agent — carries context_store and session_id."""
+
+    def __init__(self, *, context_store=None, session_id: str | None = "sess_test_01"):
+        self.context_store = context_store
+        self.session_id = session_id
+
+
+def _make_context(*, with_store=True, with_session=True):
+    store = FakeContextStore() if with_store else None
+    sid = "sess_test_01" if with_session else None
+    agent = FakeAgent(context_store=store, session_id=sid)
+    return {"agent": agent}
+
+
+# ---------------------------------------------------------------------------
+# Minimal tactic fixture
+# ---------------------------------------------------------------------------
+
+_TACTICS_MINIMAL = [
+    {
+        "id": "t1",
+        "name": "Baseline timelapse",
+        "kind": "standing_timelapse",
+        "state": "active",
+        "scope": {"mode": "global"},
+        "rationale": "Continuous pre-ramp imaging",
+        "structure": {"cadence_s": 120, "per_embryo": []},
+        "live_bind": ["cadence"],
+        "relations": {},
+    }
+]
+
+_TACTICS_MULTI = [
+    {
+        "id": "t1",
+        "name": "Baseline timelapse",
+        "kind": "standing_timelapse",
+        "state": "done",
+        "scope": {"mode": "global"},
+        "rationale": "Establish pre-ramp cadence",
+        "structure": {"cadence_s": 120, "per_embryo": []},
+        "live_bind": ["cadence"],
+        "relations": {},
+    },
+    {
+        "id": "t2",
+        "name": "Onset monitor",
+        "kind": "reactive_monitor",
+        "state": "active",
+        "scope": {"mode": "global"},
+        "rationale": "Detect onset crossing threshold",
+        "structure": {"watch": "gfp_signal > 0.3", "reaction": "burst_capture", "status": "armed"},
+        "live_bind": ["signal", "current_burst"],
+        "relations": {"after": ["t1"]},
+    },
+    {
+        "id": "t3",
+        "name": "Final survey",
+        "kind": "oneshot",
+        "state": "planned",
+        "scope": {"mode": "embryos", "embryo_ids": ["e1", "e2"]},
+        "rationale": "Confirm recovery after ramp",
+        "structure": {"note": "single high-res z-stack"},
+        "live_bind": [],
+        "relations": {"after": ["t2"]},
+    },
+]
+
+
+# ---------------------------------------------------------------------------
+# Happy-path tests
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_plan_is_persisted_to_store():
+    """Calling the tool with a valid plan stores it; get_operation_plan returns it."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    result = await declare_operation_plan(
+        title="Expression-onset survey",
+        goal="Catch GFP onset under 25 C ramp",
+        tactics=_TACTICS_MINIMAL,
+        updated_reason="experiment started",
+        context=ctx,
+    )
+
+    store = ctx["agent"].context_store
+    stored = store.get_operation_plan("sess_test_01")
+    assert stored is not None, "Plan should have been persisted"
+    assert stored["title"] == "Expression-onset survey"
+    assert stored["goal"] == "Catch GFP onset under 25 C ramp"
+    assert stored["session_id"] == "sess_test_01"
+    assert "Error" not in result
+
+
+@pytest.mark.asyncio
+async def test_confirmation_string_contains_session_and_title():
+    """The return value identifies the session and plan title."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    result = await declare_operation_plan(
+        title="Temperature-strain protocol",
+        goal="Characterise onset timing under 25 C ramp",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+
+    assert "sess_test_01" in result
+    assert "Temperature-strain protocol" in result
+
+
+@pytest.mark.asyncio
+async def test_tactics_list_preserved_in_store():
+    """All tactics are stored with correct ids, kinds, and states."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    await declare_operation_plan(
+        title="Multi-tactic plan",
+        goal="Three-phase experiment",
+        tactics=_TACTICS_MULTI,
+        updated_reason="t1 done, t2 active",
+        context=ctx,
+    )
+
+    stored = ctx["agent"].context_store.get_operation_plan("sess_test_01")
+    assert stored is not None
+    tactics = stored["tactics"]
+    assert len(tactics) == 3
+    assert [t["id"] for t in tactics] == ["t1", "t2", "t3"]
+    assert [t["state"] for t in tactics] == ["done", "active", "planned"]
+    assert [t["kind"] for t in tactics] == ["standing_timelapse", "reactive_monitor", "oneshot"]
+
+
+@pytest.mark.asyncio
+async def test_updated_at_is_stamped():
+    """The plan stored in the store has a non-empty updated_at timestamp."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+
+    stored = ctx["agent"].context_store.get_operation_plan("sess_test_01")
+    assert stored is not None
+    assert stored.get("updated_at"), "updated_at should be stamped"
+
+
+@pytest.mark.asyncio
+async def test_updated_reason_stored():
+    """updated_reason is carried into the stored plan."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=_TACTICS_MINIMAL,
+        updated_reason="tactic t1 transitioned to active",
+        context=ctx,
+    )
+
+    stored = ctx["agent"].context_store.get_operation_plan("sess_test_01")
+    assert stored["updated_reason"] == "tactic t1 transitioned to active"
+
+
+@pytest.mark.asyncio
+async def test_set_called_exactly_once():
+    """set_operation_plan is called exactly once per tool invocation."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+
+    store = ctx["agent"].context_store
+    set_calls = [c for c in store.calls if c[0] == "set"]
+    assert len(set_calls) == 1
+
+
+@pytest.mark.asyncio
+async def test_overwrite_replaces_plan():
+    """A second call replaces the first plan in the store."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    await declare_operation_plan(
+        title="Initial plan",
+        goal="First framing",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+    await declare_operation_plan(
+        title="Revised plan",
+        goal="Updated framing",
+        tactics=_TACTICS_MULTI,
+        updated_reason="added two tactics",
+        context=ctx,
+    )
+
+    stored = ctx["agent"].context_store.get_operation_plan("sess_test_01")
+    assert stored["title"] == "Revised plan"
+    assert len(stored["tactics"]) == 3
+
+
+# ---------------------------------------------------------------------------
+# Unknown kind → clamped to 'custom'
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_unknown_kind_clamped_to_custom():
+    """A tactic with an unrecognised kind is silently clamped to 'custom'."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    tactics = [
+        {
+            "id": "t1",
+            "name": "Novel tactic",
+            "kind": "future_kind_v99",
+            "state": "planned",
+            "scope": {"mode": "global"},
+            "rationale": "Something new",
+            "structure": {"note": "TBD"},
+            "live_bind": [],
+            "relations": {},
+        }
+    ]
+    result = await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=tactics,
+        context=ctx,
+    )
+
+    assert "Error" not in result
+    stored = ctx["agent"].context_store.get_operation_plan("sess_test_01")
+    assert stored["tactics"][0]["kind"] == "custom"
+
+
+# ---------------------------------------------------------------------------
+# Error paths — no write must occur
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_no_agent_returns_error_no_write():
+    """No agent in context → error string, store is never called."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    # No agent key at all
+    ctx: dict = {}
+    result = await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+
+    assert "error" in result.lower() or "Error" in result
+
+
+@pytest.mark.asyncio
+async def test_missing_store_returns_error_no_write():
+    """Agent has no context_store → error string, nothing persisted."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context(with_store=False)
+    result = await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+
+    assert "Error" in result
+    assert ctx["agent"].context_store is None  # store was never created
+
+
+@pytest.mark.asyncio
+async def test_missing_session_id_returns_error_no_write():
+    """Agent has no session_id → error string, store.set is never called."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context(with_session=False)
+    result = await declare_operation_plan(
+        title="Any plan",
+        goal="Any goal",
+        tactics=_TACTICS_MINIMAL,
+        context=ctx,
+    )
+
+    assert "Error" in result
+    store = ctx["agent"].context_store
+    assert store.calls == [], "set_operation_plan must not be called without a session_id"
+
+
+# ---------------------------------------------------------------------------
+# Validation errors — no write on invalid tactics
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_missing_tactic_id_returns_error_no_write():
+    """A tactic missing 'id' causes an error; nothing is persisted."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    bad_tactics = [{"name": "No id", "kind": "oneshot", "state": "planned"}]
+    result = await declare_operation_plan(
+        title="Bad plan",
+        goal="Any goal",
+        tactics=bad_tactics,
+        context=ctx,
+    )
+
+    assert "Error" in result
+    assert ctx["agent"].context_store.calls == []
+
+
+@pytest.mark.asyncio
+async def test_invalid_state_returns_error_no_write():
+    """A tactic with an invalid state causes an error; nothing is persisted."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    ctx = _make_context()
+    bad_tactics = [
+        {
+            "id": "t1",
+            "name": "Bad state",
+            "kind": "oneshot",
+            "state": "running",  # not a valid state
+        }
+    ]
+    result = await declare_operation_plan(
+        title="Bad plan",
+        goal="Any goal",
+        tactics=bad_tactics,
+        context=ctx,
+    )
+
+    assert "Error" in result
+    assert ctx["agent"].context_store.calls == []
+
+
+# ---------------------------------------------------------------------------
+# Registration test
+# ---------------------------------------------------------------------------
+
+
+def test_tool_is_registered_in_global_registry():
+    """declare_operation_plan is discoverable via the global tool registry after import."""
+    import gently.app.tools  # noqa: F401 — triggers registration side effects
+    from gently.harness.tools.registry import get_tool_registry
+
+    registry = get_tool_registry()
+    names = [t.name for t in registry.list_all()]
+    assert "declare_operation_plan" in names, (
+        f"Tool not found in registry. Registered tools: {names}"
+    )
+
+
+def test_tool_schema_has_required_fields():
+    """The auto-generated Claude schema has the expected required fields."""
+    import gently.app.tools  # noqa: F401
+    from gently.harness.tools.registry import get_tool_registry
+
+    registry = get_tool_registry()
+    tool_def = registry.get("declare_operation_plan")
+    assert tool_def is not None
+
+    schema = tool_def.to_claude_schema()
+    assert schema["name"] == "declare_operation_plan"
+    required = schema["input_schema"]["required"]
+    assert "title" in required
+    assert "goal" in required
+    assert "tactics" in required
+    # updated_reason has a default, so it must NOT be in required
+    assert "updated_reason" not in required

From f0d09bd0621d26b67b8e924c16e7298538542ae8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:52:46 +0530
Subject: [PATCH 209/314] docs(operations): add execution-linkage tasks
 (transition_tactic, tool start-edges, OperationPlanUpdater)

---
 .../plans/2026-06-28-operations-tab.md            | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/superpowers/plans/2026-06-28-operations-tab.md b/docs/superpowers/plans/2026-06-28-operations-tab.md
index e6a5c347..208d642d 100644
--- a/docs/superpowers/plans/2026-06-28-operations-tab.md
+++ b/docs/superpowers/plans/2026-06-28-operations-tab.md
@@ -48,3 +48,18 @@
 - Store→Task1; tool→Task2; route→Task3; renderer+scenarios→Task4 (audit fixes); live binding→Task5. ✓
 - Open confirmations: FileContextStore domain pattern (T1), the forced-tool/@tool pattern (T2), the route store-resolution (T3), the Overview render seam + harness renderer (T4), the live telemetry sources (T5).
 - Type consistency: the plan/tactic schema is identical across store (T1), tool (T2), route (T3), fixtures+renderer (T4), binding (T5).
+
+---
+## Execution-linkage tasks (added after recon — close the planning→execution loop)
+
+### Task 6: `transition_tactic` store helper
+**Files:** Modify `gently/harness/memory/file_store.py` (add `transition_tactic(session_id, tactic_id, state=None, **bind)` next to `set/get_operation_plan` ~:818 — read the plan, find the tactic by `id`, set `state` and merge `bind` into its `live`/`structure`, write back, fire `CONTEXT_UPDATED`; no-op if plan/tactic absent). Test: `tests/test_transition_tactic.py`.
+- [ ] TDD: declare a plan, transition a tactic planned→active with a `request_id` bind → get shows the new state + bound value; unknown tactic_id → no-op (no crash). Commit `feat(operations): transition_tactic store helper`.
+
+### Task 7: tactic_id threading + start-edge marking in execution tools
+**Files:** Modify `gently/app/tools/timelapse_tools.py` (`enable_monitoring_mode`, `queue_burst`, stop/pause), `gently/app/tools/temperature_protocol_tools.py`, and the burst/protocol event payloads (`exclusive.py` BURST_*, `temperature_protocol.py` TEMP_PROTOCOL_*) to carry an optional `tactic_id`. On execute, the tool calls `cs.transition_tactic(session, tactic_id, 'active')`; on stop/pause → 'done'/'paused'. Test: `tests/test_tool_tactic_linkage.py`.
+- [ ] Add optional `tactic_id` param; thread into event `data`; flip the plan tactic active on execute (guard: only if a plan + tactic_id exist). TDD with a fake context store capturing transitions. Commit `feat(operations): link execution tools to plan tactics via tactic_id`.
+
+### Task 8: `OperationPlanUpdater` service (completion edges via the bus)
+**Files:** Create `gently/app/operation_plan_updater.py` (a `Service` modeled on `gently/app/temperature_sampler.py` / `TimelineManager`); wire in `gently/app/agent.py` beside the temperature sampler (~:838-849). Test: `tests/test_operation_plan_updater.py`.
+- [ ] Subscribe `BURST_COMPLETE`, `TEMP_PROTOCOL_COMPLETED`, `EMBRYO_CADENCE_CHANGED`, `TRIGGER_FIRED`; on each, resolve the tactic (by `tactic_id` in payload, else by kind+embryo) and `cs.transition_tactic(session, tactic_id, 'done', **bind)` binding live values (request_id/mp4_path/setpoint/cadence). Mirror the sampler's start/stop lifecycle + session_id getter. TDD against a fake bus + store. Commit `feat(operations): OperationPlanUpdater — execution events transition plan tactics`.

From a75d23ff3abb89fa6673dfe065a9200047a91486 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:57:05 +0530
Subject: [PATCH 210/314] feat(operations): GET /api/operation_plan/{session}
 route

Adds read-only route returning the agent-authored Operation Plan from
FileContextStore.get_operation_plan(). "current" resolves via
gently_store.list_sessions()[0]. Returns {available, plan, session_id};
graceful unavailable when store is absent or plan not yet written.
Registered in routes/__init__.py alongside other route factories.
---
 gently/ui/web/routes/__init__.py       |  2 +
 gently/ui/web/routes/operation_plan.py | 40 ++++++++++++
 tests/test_operation_plan_route.py     | 87 ++++++++++++++++++++++++++
 3 files changed, 129 insertions(+)
 create mode 100644 gently/ui/web/routes/operation_plan.py
 create mode 100644 tests/test_operation_plan_route.py

diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index 66e8842c..6cd54a7a 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -13,6 +13,7 @@
 from .context import create_router as create_context_router
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
+from .operation_plan import create_router as create_operation_plan_router
 from .temperature import create_router as create_temperature_router
 from .images import create_router as create_images_router
 from .notebook import create_router as create_notebook_router
@@ -39,6 +40,7 @@ def register_all_routes(server):
         create_context_router,
         create_notebook_router,
         create_temperature_router,
+        create_operation_plan_router,
     ):
         router = factory(server)
         server.app.include_router(router)
diff --git a/gently/ui/web/routes/operation_plan.py b/gently/ui/web/routes/operation_plan.py
new file mode 100644
index 00000000..9e0d8c82
--- /dev/null
+++ b/gently/ui/web/routes/operation_plan.py
@@ -0,0 +1,40 @@
+"""Operation Plan route.
+
+Returns the agent-authored Operation Plan for a session.
+The plan is stored in FileContextStore (``server.context_store``) keyed by
+session_id.  ``session_id="current"`` resolves to the newest session via the
+FileStore (``server.gently_store``).
+"""
+
+from fastapi import APIRouter, HTTPException
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    def _resolve_session(session_id: str) -> str:
+        if session_id == "current":
+            store = getattr(server, "gently_store", None)
+            if store is None:
+                raise HTTPException(status_code=503, detail="FileStore not configured on viz server")
+            sessions = store.list_sessions()
+            if not sessions:
+                raise HTTPException(status_code=404, detail="No sessions in store")
+            session_id = sessions[0].get("session_id")
+        return session_id
+
+    @router.get("/api/operation_plan/{session_id}")
+    async def get_operation_plan(session_id: str):
+        real_id = _resolve_session(session_id)
+        cs = getattr(server, "context_store", None)
+        if cs is None:
+            return {"session_id": real_id, "available": False, "plan": None}
+        try:
+            plan = cs.get_operation_plan(real_id)
+        except Exception:
+            plan = None
+        if plan is None:
+            return {"session_id": real_id, "available": False, "plan": None}
+        return {"session_id": real_id, "available": True, "plan": plan}
+
+    return router
diff --git a/tests/test_operation_plan_route.py b/tests/test_operation_plan_route.py
new file mode 100644
index 00000000..c7c45d59
--- /dev/null
+++ b/tests/test_operation_plan_route.py
@@ -0,0 +1,87 @@
+from pathlib import Path
+from unittest.mock import MagicMock
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.ui.web.routes.operation_plan import create_router
+
+_SAMPLE_PLAN = {
+    "tactics": [
+        {"id": "t1", "description": "Start acquisition", "status": "done"},
+        {"id": "t2", "description": "Monitor drift", "status": "active"},
+    ]
+}
+
+
+def _server(plan, sessions=(("sess-1",),), context_store_available=True):
+    gently_store = MagicMock()
+    gently_store.list_sessions.return_value = [{"session_id": sid} for (sid,) in sessions]
+
+    context_store = MagicMock() if context_store_available else None
+    if context_store is not None:
+        context_store.get_operation_plan.return_value = plan
+
+    srv = MagicMock()
+    srv.gently_store = gently_store
+    srv.context_store = context_store
+    return srv, gently_store, context_store
+
+
+def _client(server):
+    app = FastAPI()
+    app.include_router(create_router(server))
+    return TestClient(app)
+
+
+def test_returns_stored_plan():
+    srv, _, cs = _server(_SAMPLE_PLAN)
+    r = _client(srv).get("/api/operation_plan/sess-1")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["available"] is True
+    assert body["session_id"] == "sess-1"
+    assert body["plan"]["tactics"][0]["id"] == "t1"
+    cs.get_operation_plan.assert_called_with("sess-1")
+
+
+def test_returns_unavailable_when_no_plan():
+    srv, _, cs = _server(None)
+    r = _client(srv).get("/api/operation_plan/sess-1")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["available"] is False
+    assert body["plan"] is None
+
+
+def test_current_resolves_newest():
+    srv, gently_store, cs = _server(_SAMPLE_PLAN, sessions=(("newest-session",),))
+    r = _client(srv).get("/api/operation_plan/current")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["session_id"] == "newest-session"
+    cs.get_operation_plan.assert_called_with("newest-session")
+
+
+def test_current_no_sessions_returns_404():
+    srv, gently_store, cs = _server(_SAMPLE_PLAN, sessions=())
+    r = _client(srv).get("/api/operation_plan/current")
+    assert r.status_code == 404
+
+
+def test_context_store_unavailable_returns_unavailable():
+    srv, _, _ = _server(_SAMPLE_PLAN, context_store_available=False)
+    r = _client(srv).get("/api/operation_plan/sess-1")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["available"] is False
+    assert body["plan"] is None
+
+
+def test_context_store_exception_returns_unavailable():
+    srv, _, cs = _server(_SAMPLE_PLAN)
+    cs.get_operation_plan.side_effect = RuntimeError("disk error")
+    r = _client(srv).get("/api/operation_plan/sess-1")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["available"] is False

From 84f5f17af21404e07118ad18438e993fe54016e7 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 17:58:41 +0530
Subject: [PATCH 211/314] =?UTF-8?q?docs(operations):=20add=20plan-item?=
 =?UTF-8?q?=E2=86=94operation=20linkage=20tasks=20(tactical=20outline=20+?=
 =?UTF-8?q?=20goal/seeding)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/superpowers/plans/2026-06-28-operations-tab.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/superpowers/plans/2026-06-28-operations-tab.md b/docs/superpowers/plans/2026-06-28-operations-tab.md
index 208d642d..46625492 100644
--- a/docs/superpowers/plans/2026-06-28-operations-tab.md
+++ b/docs/superpowers/plans/2026-06-28-operations-tab.md
@@ -63,3 +63,14 @@
 ### Task 8: `OperationPlanUpdater` service (completion edges via the bus)
 **Files:** Create `gently/app/operation_plan_updater.py` (a `Service` modeled on `gently/app/temperature_sampler.py` / `TimelineManager`); wire in `gently/app/agent.py` beside the temperature sampler (~:838-849). Test: `tests/test_operation_plan_updater.py`.
 - [ ] Subscribe `BURST_COMPLETE`, `TEMP_PROTOCOL_COMPLETED`, `EMBRYO_CADENCE_CHANGED`, `TRIGGER_FIRED`; on each, resolve the tactic (by `tactic_id` in payload, else by kind+embryo) and `cs.transition_tactic(session, tactic_id, 'done', **bind)` binding live values (request_id/mp4_path/setpoint/cadence). Mirror the sampler's start/stop lifecycle + session_id getter. TDD against a fake bus + store. Commit `feat(operations): OperationPlanUpdater — execution events transition plan tactics`.
+
+---
+## Plan-item ↔ operation linkage tasks (added — tactics planned at plan time)
+
+### Task 9: PlanItem/ImagingSpec tactical outline
+**Files:** Modify `gently/harness/memory/model.py` (`ImagingSpec` ~:200 / `PlanItem` ~:265 — add optional `tactics: list[dict]` outline field: each entry a lightweight tactic `{kind, name, target?, scope?, structure?}`). Ensure the plan-mode planning tools (`gently/harness/plan_mode/tools/planning.py` create_plan_item/update_plan_item) accept/persist it. Test: extend the plan-item model/store tests.
+- [ ] Confirm the real ImagingSpec/PlanItem dataclass + how planning tools set the spec. Add the optional `tactics` outline (default empty), persisted in the campaign plan YAML. TDD: a plan item round-trips its tactics outline. Commit `feat(operations): plan-item tactical outline (plan tactics with the imaging spec)`.
+
+### Task 10: Operation Plan goal/plan_item linkage + seeding
+**Files:** Modify `gently/app/tools/operation_plan_tools.py` (or a small seeding helper / the agent): resolve the current session's `plan_item_id`/`campaign_id`/goal from the `session_intent` (`get_current_session_intent` ~file_store.py:788) → set them on the Operation Plan top-level; when a session linked to a plan item with a `tactics` outline begins (or on first declare), SEED the Operation Plan's `planned` tactics from the outline. Test: `tests/test_operation_plan_seeding.py`.
+- [ ] Confirm the session_intent→plan_item linkage accessors. On declare/seed, populate `plan_item_id`/`campaign_id`/`goal` from the linked plan item and seed `planned` tactics from its outline (idempotent — don't clobber tactics already active/done). TDD with a fake store: a session linked to a plan item with an outline produces a seeded Operation Plan. Commit `feat(operations): seed Operation Plan goal + planned tactics from the linked plan item`.

From 66a40d132c58c3bd6a2079f4e674036ef1311174 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:02:33 +0530
Subject: [PATCH 212/314] feat(operations): transition_tactic store helper
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add FileContextStore.transition_tactic(session_id, tactic_id, state=None, **bind)
— reads the plan via get_operation_plan, finds the tactic by id, flips its state,
merges bind kwargs into tactic['live'] (creating the dict if absent), stamps
updated_at/updated_reason, and writes back via set_operation_plan so
CONTEXT_UPDATED fires exactly once.  Returns True on success, False (no-op) when
plan or tactic is absent.  18 TDD tests all pass.
---
 gently/harness/memory/file_store.py |  35 +++++
 tests/test_transition_tactic.py     | 230 ++++++++++++++++++++++++++++
 2 files changed, 265 insertions(+)
 create mode 100644 tests/test_transition_tactic.py

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 0e831c12..98763cf3 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -830,6 +830,41 @@ def get_operation_plan(self, session_id: str) -> dict | None:
         path = self.agent_dir / "operation_plans" / f"{session_id}.yaml"
         return self._read_yaml(path)
 
+    def transition_tactic(
+        self, session_id: str, tactic_id: str, state: str | None = None, **bind
+    ) -> bool:
+        """Atomically update a tactic's state and/or bind live values onto it.
+
+        Reads the plan via get_operation_plan, locates the tactic by id,
+        sets its state (if provided), merges bind kwargs into its live dict
+        (creating it if absent), stamps updated_at/updated_reason, and writes
+        back via set_operation_plan so CONTEXT_UPDATED fires exactly once.
+
+        Returns True on success, False if the plan is absent or the tactic id
+        is not found (no-op, no crash).
+        """
+        plan = self.get_operation_plan(session_id)
+        if plan is None:
+            return False
+
+        tactics = plan.get("tactics", [])
+        tactic = next((t for t in tactics if t.get("id") == tactic_id), None)
+        if tactic is None:
+            return False
+
+        if state is not None:
+            tactic["state"] = state
+
+        if bind:
+            live = tactic.setdefault("live", {})
+            live.update(bind)
+
+        plan["updated_at"] = self._now()
+        plan["updated_reason"] = f"tactic {tactic_id} transitioned"
+
+        self.set_operation_plan(session_id, plan)
+        return True
+
     # ==================================================================
     # Session <-> Campaign (many-to-many)
     # ==================================================================
diff --git a/tests/test_transition_tactic.py b/tests/test_transition_tactic.py
new file mode 100644
index 00000000..5b72648a
--- /dev/null
+++ b/tests/test_transition_tactic.py
@@ -0,0 +1,230 @@
+"""
+FileContextStore.transition_tactic — TDD tests.
+
+Verifies: state flip, live bind merge, updated_at stamp,
+True/False return values, no-op on missing plan or tactic.
+"""
+
+import pytest
+from gently.core.event_bus import EventType, on
+
+
+# ---------------------------------------------------------------------------
+# Plan fixture shared across tests
+# ---------------------------------------------------------------------------
+
+_PLAN = {
+    "session_id": "sess_tt",
+    "title": "Transition-tactic test plan",
+    "goal": "Verify atomic tactic transitions",
+    "tactics": [
+        {
+            "id": "t1",
+            "name": "Baseline timelapse",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": {"mode": "global"},
+            "rationale": "Establish pre-ramp cadence",
+            "structure": {"cadence_s": 120},
+            "live_bind": ["cadence"],
+            "relations": {},
+        },
+        {
+            "id": "t2",
+            "name": "Temp ramp monitor",
+            "kind": "reactive_monitor",
+            "state": "planned",
+            "scope": {"mode": "global"},
+            "rationale": "Detect onset event",
+            "structure": {"watch": "temperature > 24.5"},
+            "live_bind": ["temperature"],
+            "relations": {"after": ["t1"]},
+        },
+    ],
+    "updated_at": "2026-06-28T00:00:00",
+    "updated_reason": "initial plan",
+}
+
+
+def _fresh_plan():
+    """Deep-copy the fixture so mutations don't bleed between tests."""
+    import copy
+    return copy.deepcopy(_PLAN)
+
+
+# ---------------------------------------------------------------------------
+# Happy-path tests
+# ---------------------------------------------------------------------------
+
+
+class TestTransitionTacticHappyPath:
+    def test_returns_true_on_success(self, file_context_store):
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        result = cs.transition_tactic("sess_tt", "t1", state="active")
+        assert result is True
+
+    def test_state_updated(self, file_context_store):
+        """State flips from planned to active after transition."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="active")
+        plan = cs.get_operation_plan("sess_tt")
+        t1 = next(t for t in plan["tactics"] if t["id"] == "t1")
+        assert t1["state"] == "active"
+
+    def test_bind_written_to_live(self, file_context_store):
+        """Bind kwargs land in tactic['live']."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="active", request_id="b1")
+        plan = cs.get_operation_plan("sess_tt")
+        t1 = next(t for t in plan["tactics"] if t["id"] == "t1")
+        assert t1["live"]["request_id"] == "b1"
+
+    def test_state_and_bind_together(self, file_context_store):
+        """State flip and live bind work together in one call."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="active", request_id="b1", cadence=90)
+        plan = cs.get_operation_plan("sess_tt")
+        t1 = next(t for t in plan["tactics"] if t["id"] == "t1")
+        assert t1["state"] == "active"
+        assert t1["live"]["request_id"] == "b1"
+        assert t1["live"]["cadence"] == 90
+
+    def test_bind_merges_into_existing_live(self, file_context_store):
+        """Subsequent bind calls merge, not replace, existing live values."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", request_id="b1")
+        cs.transition_tactic("sess_tt", "t1", mp4_path="/data/t1.mp4")
+        plan = cs.get_operation_plan("sess_tt")
+        t1 = next(t for t in plan["tactics"] if t["id"] == "t1")
+        assert t1["live"]["request_id"] == "b1"
+        assert t1["live"]["mp4_path"] == "/data/t1.mp4"
+
+    def test_bind_creates_live_dict_when_absent(self, file_context_store):
+        """live dict is created if the tactic didn't have one."""
+        cs = file_context_store
+        plan = _fresh_plan()
+        # Ensure no live key exists
+        assert "live" not in plan["tactics"][0]
+        cs.set_operation_plan("sess_tt", plan)
+        cs.transition_tactic("sess_tt", "t1", setpoint=25.0)
+        t1 = cs.get_operation_plan("sess_tt")["tactics"][0]
+        assert t1["live"]["setpoint"] == 25.0
+
+    def test_state_only_no_bind(self, file_context_store):
+        """state-only call with no bind kwargs works and adds no live key."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="done")
+        plan = cs.get_operation_plan("sess_tt")
+        t1 = next(t for t in plan["tactics"] if t["id"] == "t1")
+        assert t1["state"] == "done"
+        assert "live" not in t1
+
+    def test_bind_only_no_state_change(self, file_context_store):
+        """bind-only call (no state arg) preserves existing state."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", cadence=60)
+        plan = cs.get_operation_plan("sess_tt")
+        t1 = next(t for t in plan["tactics"] if t["id"] == "t1")
+        assert t1["state"] == "planned"  # unchanged
+        assert t1["live"]["cadence"] == 60
+
+    def test_other_tactic_unaffected(self, file_context_store):
+        """Transitioning t1 does not alter t2."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="active", request_id="b1")
+        plan = cs.get_operation_plan("sess_tt")
+        t2 = next(t for t in plan["tactics"] if t["id"] == "t2")
+        assert t2["state"] == "planned"
+        assert "live" not in t2
+
+    def test_updated_at_stamped(self, file_context_store):
+        """updated_at is refreshed after a successful transition."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="active")
+        plan = cs.get_operation_plan("sess_tt")
+        assert plan["updated_at"] != "2026-06-28T00:00:00"
+
+    def test_updated_reason_stamped(self, file_context_store):
+        """updated_reason reflects which tactic was transitioned."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        cs.transition_tactic("sess_tt", "t1", state="active")
+        plan = cs.get_operation_plan("sess_tt")
+        assert "t1" in plan["updated_reason"]
+
+    def test_fires_context_updated_event(self, file_context_store):
+        """transition_tactic fires CONTEXT_UPDATED (via set_operation_plan)."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            cs.transition_tactic("sess_tt", "t1", state="active")
+        finally:
+            unsub()
+        assert len(seen) >= 1
+
+
+# ---------------------------------------------------------------------------
+# No-op / guard tests
+# ---------------------------------------------------------------------------
+
+
+class TestTransitionTacticNoOp:
+    def test_absent_plan_returns_false(self, file_context_store):
+        """Returns False and does not crash when no plan exists."""
+        result = file_context_store.transition_tactic("no_such_session", "t1", state="active")
+        assert result is False
+
+    def test_absent_plan_no_side_effects(self, file_context_store):
+        """Absent-plan call creates no operation_plan file."""
+        cs = file_context_store
+        cs.transition_tactic("ghost_session", "t1", state="active")
+        assert cs.get_operation_plan("ghost_session") is None
+
+    def test_unknown_tactic_id_returns_false(self, file_context_store):
+        """Returns False when the tactic id is not present in the plan."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        result = cs.transition_tactic("sess_tt", "no_such_tactic", state="active")
+        assert result is False
+
+    def test_unknown_tactic_plan_unchanged(self, file_context_store):
+        """Plan is not mutated when the tactic id is not found."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        original_updated_at = cs.get_operation_plan("sess_tt")["updated_at"]
+        cs.transition_tactic("sess_tt", "no_such_tactic", state="active")
+        plan = cs.get_operation_plan("sess_tt")
+        assert plan["updated_at"] == original_updated_at
+
+    def test_no_event_on_absent_plan(self, file_context_store):
+        """CONTEXT_UPDATED must not fire when the plan is absent."""
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            file_context_store.transition_tactic("ghost", "t1", state="active")
+        finally:
+            unsub()
+        assert len(seen) == 0
+
+    def test_no_event_on_unknown_tactic(self, file_context_store):
+        """CONTEXT_UPDATED must not fire when the tactic id is not found."""
+        cs = file_context_store
+        cs.set_operation_plan("sess_tt", _fresh_plan())
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            cs.transition_tactic("sess_tt", "no_such", state="active")
+        finally:
+            unsub()
+        assert len(seen) == 0

From 224d8651c13876b09dabf6dc9aaeb51c9195e731 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:14:38 +0530
Subject: [PATCH 213/314] feat(operations): link execution tools to plan
 tactics via tactic_id

Add optional tactic_id param to enable_monitoring_mode, queue_burst,
stop_timelapse, pause_timelapse (timelapse_tools.py) and
run_temp_change_burst_protocol_tool (temperature_protocol_tools.py).
On execute the tool calls cs.transition_tactic(session, tactic_id,
'active'/'done'/'paused') via the same guarded getattr pattern as
declare_operation_plan. tactic_id is threaded into BurstAcquisition
and the orchestration layer so BURST_START/BURST_COMPLETE and
TEMP_PROTOCOL_STARTED/TEMP_PROTOCOL_COMPLETED event data carry it for
Task 8's OperationPlanUpdater. All params default None; existing
callers are unaffected.
---
 gently/app/orchestration/exclusive.py         |   4 +
 .../app/orchestration/temperature_protocol.py |   8 +-
 gently/app/orchestration/timelapse.py         |   2 +
 .../app/tools/temperature_protocol_tools.py   |  10 +
 gently/app/tools/timelapse_tools.py           |  44 +-
 tests/test_tool_tactic_linkage.py             | 555 ++++++++++++++++++
 6 files changed, 616 insertions(+), 7 deletions(-)
 create mode 100644 tests/test_tool_tactic_linkage.py

diff --git a/gently/app/orchestration/exclusive.py b/gently/app/orchestration/exclusive.py
index 03917b0c..7dc3583f 100644
--- a/gently/app/orchestration/exclusive.py
+++ b/gently/app/orchestration/exclusive.py
@@ -102,6 +102,7 @@ def __init__(
         request_id: str | None = None,
         temperature_provider=None,
         laser_config: str | None = None,
+        tactic_id: str | None = None,
     ):
         super().__init__(target_embryo_id=target_embryo_id, request_id=request_id)
         self.frames = frames
@@ -109,6 +110,7 @@ def __init__(
         self.num_slices = num_slices
         self._temperature_provider = temperature_provider
         self._laser_config = laser_config
+        self._tactic_id = tactic_id
 
     async def run(self, orchestrator) -> ExclusiveResult:
         from gently.core import EventType
@@ -132,6 +134,7 @@ async def run(self, orchestrator) -> ExclusiveResult:
                 "frames": self.frames,
                 "mode": self.mode,
                 "phase": getattr(self, "_phase", None),
+                "tactic_id": self._tactic_id,
             },
         )
 
@@ -234,6 +237,7 @@ async def run(self, orchestrator) -> ExclusiveResult:
                 "duration_s": duration_s,
                 "sustained_hz": sustained_hz,
                 "mp4_path": mp4_path,
+                "tactic_id": self._tactic_id,
             },
         )
 
diff --git a/gently/app/orchestration/temperature_protocol.py b/gently/app/orchestration/temperature_protocol.py
index 60058133..115234f2 100644
--- a/gently/app/orchestration/temperature_protocol.py
+++ b/gently/app/orchestration/temperature_protocol.py
@@ -21,7 +21,7 @@ async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.
 
 async def run_temp_change_burst_protocol(orchestrator, embryo_id, target_setpoint_c, *,
         frames=60, mode="1hz", num_slices=1, bursts_before=1, bursts_after=1,
-        lock_timeout_s=600.0, poll_s=2.0, burst_runner=None):
+        lock_timeout_s=600.0, poll_s=2.0, burst_runner=None, tactic_id=None):
     """Scripted temp-change burst protocol: brightfield before/during/after a setpoint change."""
     client = orchestrator.client
     if burst_runner is None:
@@ -40,7 +40,8 @@ async def one_burst(phase):
         await client.set_led("Open")
         orchestrator._emit_event(EventType.TEMP_PROTOCOL_STARTED,
             {"embryo_id": embryo_id, "target_setpoint_c": target_setpoint_c,
-             "frames": frames, "bursts_before": bursts_before, "bursts_after": bursts_after})
+             "frames": frames, "bursts_before": bursts_before, "bursts_after": bursts_after,
+             "tactic_id": tactic_id})
         for _ in range(bursts_before):
             await one_burst("before")
         await client.set_temperature(target_setpoint_c)
@@ -65,5 +66,6 @@ async def one_burst(phase):
         error = str(exc); logger.exception("temp-change burst protocol failed")
     finally:
         orchestrator._emit_event(EventType.TEMP_PROTOCOL_COMPLETED,
-            {"embryo_id": embryo_id, "locked": locked, "cancelled": cancelled, "error": error})
+            {"embryo_id": embryo_id, "locked": locked, "cancelled": cancelled, "error": error,
+             "tactic_id": tactic_id})
     return {"locked": locked, "cancelled": cancelled, "error": error}
diff --git a/gently/app/orchestration/timelapse.py b/gently/app/orchestration/timelapse.py
index c640f926..0645d77f 100644
--- a/gently/app/orchestration/timelapse.py
+++ b/gently/app/orchestration/timelapse.py
@@ -2062,6 +2062,7 @@ def queue_burst(
         num_slices: int = 1,
         force: bool = False,
         laser_config: str | None = None,
+        tactic_id: str | None = None,
     ) -> str:
         """Queue a burst acquisition for ``embryo_id``.
 
@@ -2102,6 +2103,7 @@ def queue_burst(
             num_slices=num_slices,
             temperature_provider=self._temperature_provider,
             laser_config=laser_config,
+            tactic_id=tactic_id,
         )
         self._exclusive_queue.append(op)
         logger.info(
diff --git a/gently/app/tools/temperature_protocol_tools.py b/gently/app/tools/temperature_protocol_tools.py
index 678b08b8..3e79055f 100644
--- a/gently/app/tools/temperature_protocol_tools.py
+++ b/gently/app/tools/temperature_protocol_tools.py
@@ -43,6 +43,7 @@ async def run_temp_change_burst_protocol_tool(
     frames: int = 60,
     bursts_before: int = 1,
     bursts_after: int = 1,
+    tactic_id: str | None = None,
     context: dict | None = None,
 ) -> str:
     """Launch the temp-change burst driver as a background asyncio task.
@@ -83,6 +84,14 @@ async def run_temp_change_burst_protocol_tool(
             "(would contend for the RunEngine). Stop the timelapse first."
         )
 
+    # Flip the matching plan tactic to active before launching the background driver
+    # (guarded no-op when tactic_id or context store are absent).
+    if tactic_id:
+        cs = getattr(agent, "context_store", None)
+        session = getattr(agent, "session_id", None)
+        if cs and session:
+            cs.transition_tactic(session, tactic_id, "active")
+
     asyncio.create_task(
         _driver(
             orchestrator,
@@ -91,6 +100,7 @@ async def run_temp_change_burst_protocol_tool(
             frames=frames,
             bursts_before=bursts_before,
             bursts_after=bursts_after,
+            tactic_id=tactic_id,
         )
     )
 
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index d5ec3d76..9e96cbe5 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -267,7 +267,11 @@ async def stop_timelapse_embryo(
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def stop_timelapse(reason: str = "user_request", context: dict | None = None) -> str:
+async def stop_timelapse(
+    reason: str = "user_request",
+    tactic_id: str | None = None,
+    context: dict | None = None,
+) -> str:
     """Stop entire timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -279,6 +283,12 @@ async def stop_timelapse(reason: str = "user_request", context: dict | None = No
 
     try:
         result = await orchestrator.stop(reason)
+        # Mark the linked plan tactic done (guarded no-op when absent).
+        if tactic_id:
+            cs = getattr(agent, "context_store", None)
+            session = getattr(agent, "session_id", None)
+            if cs and session:
+                cs.transition_tactic(session, tactic_id, "done")
         return result
     except Exception as e:
         return f"Error stopping timelapse: {str(e)}"
@@ -290,7 +300,10 @@ async def stop_timelapse(reason: str = "user_request", context: dict | None = No
     category=ToolCategory.EXPERIMENT,
     requires_microscope=True,
 )
-async def pause_timelapse(context: dict | None = None) -> str:
+async def pause_timelapse(
+    tactic_id: str | None = None,
+    context: dict | None = None,
+) -> str:
     """Pause timelapse"""
     agent, err = require_agent(context)
     if err:
@@ -302,6 +315,12 @@ async def pause_timelapse(context: dict | None = None) -> str:
 
     try:
         result = await orchestrator.pause()
+        # Mark the linked plan tactic paused (guarded no-op when absent).
+        if tactic_id:
+            cs = getattr(agent, "context_store", None)
+            session = getattr(agent, "session_id", None)
+            if cs and session:
+                cs.transition_tactic(session, tactic_id, "paused")
         return result
     except Exception as e:
         return f"Error pausing timelapse: {str(e)}"
@@ -1024,6 +1043,7 @@ def get_photodose_status(context: dict | None = None) -> str:
 )
 def enable_monitoring_mode(
     mode_name: str,
+    tactic_id: str | None = None,
     context: dict | None = None,
 ) -> str:
     """Install a named reactive monitoring mode on the orchestrator."""
@@ -1036,7 +1056,14 @@ def enable_monitoring_mode(
         return err
 
     try:
-        return orchestrator.enable_monitoring_mode(mode_name)
+        result = orchestrator.enable_monitoring_mode(mode_name)
+        # Flip the matching plan tactic to active (guarded no-op when absent).
+        if tactic_id:
+            cs = getattr(agent, "context_store", None)
+            session = getattr(agent, "session_id", None)
+            if cs and session:
+                cs.transition_tactic(session, tactic_id, "active")
+        return result
     except Exception as e:
         return f"Error enabling monitoring mode '{mode_name}': {str(e)}"
 
@@ -1153,6 +1180,7 @@ def queue_burst(
     mode: str = "1hz",
     num_slices: int = 1,
     force: bool = False,
+    tactic_id: str | None = None,
     context: dict | None = None,
 ) -> str:
     """Queue an exclusive burst acquisition for one embryo."""
@@ -1165,12 +1193,20 @@ def queue_burst(
         return err
 
     try:
-        return orchestrator.queue_burst(
+        result = orchestrator.queue_burst(
             embryo_id=embryo_id,
             frames=frames,
             mode=mode,
             num_slices=num_slices,
             force=force,
+            tactic_id=tactic_id,
         )
+        # Flip the matching plan tactic to active on enqueue (guarded no-op when absent).
+        if tactic_id:
+            cs = getattr(agent, "context_store", None)
+            session = getattr(agent, "session_id", None)
+            if cs and session:
+                cs.transition_tactic(session, tactic_id, "active")
+        return result
     except Exception as e:
         return f"Error queueing burst for {embryo_id}: {str(e)}"
diff --git a/tests/test_tool_tactic_linkage.py b/tests/test_tool_tactic_linkage.py
new file mode 100644
index 00000000..be245093
--- /dev/null
+++ b/tests/test_tool_tactic_linkage.py
@@ -0,0 +1,555 @@
+"""
+Task 7: tactic_id threading + start-edge marking in execution tools.
+
+Verifies:
+  1. enable_monitoring_mode with tactic_id → transition_tactic("active") called.
+  2. enable_monitoring_mode without tactic_id → no transition call.
+  3. queue_burst (tool) with tactic_id → transition_tactic("active") called.
+  4. queue_burst (tool) without tactic_id → no transition call.
+  5. stop_timelapse with tactic_id → transition_tactic("done") called.
+  6. pause_timelapse with tactic_id → transition_tactic("paused") called.
+  7. BurstAcquisition(tactic_id=...) stores _tactic_id and includes it in BURST_START data.
+  8. BurstAcquisition(tactic_id=...) includes tactic_id in BURST_COMPLETE data.
+  9. run_temp_change_burst_protocol_tool with tactic_id → transition_tactic("active") called.
+  10. run_temp_change_burst_protocol_tool without tactic_id → no transition call.
+  11. TEMP_PROTOCOL_STARTED and TEMP_PROTOCOL_COMPLETED carry tactic_id.
+"""
+
+import asyncio
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# Fakes
+# ---------------------------------------------------------------------------
+
+
+class FakeContextStore:
+    """Capture calls to transition_tactic."""
+
+    def __init__(self):
+        self.transitions: list[tuple] = []
+
+    def transition_tactic(self, session_id: str, tactic_id: str, state: str = None, **bind):
+        self.transitions.append((session_id, tactic_id, state))
+        return True
+
+
+class FakeOrchestrator:
+    """Minimal orchestrator for tool-layer tests."""
+
+    def __init__(self):
+        self.monitoring_modes_enabled: list[str] = []
+        self.bursts_queued: list[dict] = []
+        self.stopped = False
+        self.paused = False
+
+    def enable_monitoring_mode(self, name: str, **kwargs) -> str:
+        self.monitoring_modes_enabled.append(name)
+        return f"Activated monitoring mode '{name}'"
+
+    def queue_burst(
+        self,
+        embryo_id: str,
+        *,
+        frames: int = 60,
+        mode: str = "1hz",
+        num_slices: int = 1,
+        force: bool = False,
+        laser_config=None,
+        tactic_id=None,
+    ) -> str:
+        self.bursts_queued.append({"embryo_id": embryo_id, "tactic_id": tactic_id})
+        return f"Burst queued for {embryo_id}"
+
+    async def stop(self, reason: str = "user_request") -> str:
+        self.stopped = True
+        return "Timelapse stopped."
+
+    async def pause(self) -> str:
+        self.paused = True
+        return "Timelapse paused."
+
+
+class FakeAgent:
+    """Carries context_store, session_id, and timelapse_orchestrator."""
+
+    def __init__(self, *, cs=None, session_id="sess_t7", orchestrator=None):
+        self.context_store = cs
+        self.session_id = session_id
+        self.timelapse_orchestrator = orchestrator
+
+
+class FakeMicroscope:
+    """Satisfies the requires_microscope client check in the tool registry."""
+    pass
+
+
+def _make_agent(with_cs=True, with_orchestrator=True):
+    cs = FakeContextStore() if with_cs else None
+    orch = FakeOrchestrator() if with_orchestrator else None
+    agent = FakeAgent(cs=cs, orchestrator=orch)
+    return agent, cs, orch
+
+
+def _ctx(agent, with_client=False):
+    ctx = {"agent": agent}
+    if with_client:
+        ctx["client"] = FakeMicroscope()
+    return ctx
+
+
+# ---------------------------------------------------------------------------
+# enable_monitoring_mode — tool-layer tactic transitions
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_enable_monitoring_mode_with_tactic_id_calls_transition():
+    """enable_monitoring_mode with tactic_id flips the tactic to active."""
+    from gently.app.tools.timelapse_tools import enable_monitoring_mode
+
+    agent, cs, _orch = _make_agent()
+    await enable_monitoring_mode(
+        mode_name="expression_monitoring", tactic_id="t1", context=_ctx(agent)
+    )
+
+    assert cs is not None
+    assert any(
+        t == ("sess_t7", "t1", "active") for t in cs.transitions
+    ), f"Expected transition ('sess_t7', 't1', 'active'), got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_enable_monitoring_mode_without_tactic_id_no_transition():
+    """enable_monitoring_mode without tactic_id must not call transition_tactic."""
+    from gently.app.tools.timelapse_tools import enable_monitoring_mode
+
+    agent, cs, _orch = _make_agent()
+    await enable_monitoring_mode(mode_name="expression_monitoring", context=_ctx(agent))
+
+    assert cs.transitions == [], f"Expected no transitions, got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_enable_monitoring_mode_no_cs_no_crash():
+    """Missing context store must not crash — the transition is a guarded no-op."""
+    from gently.app.tools.timelapse_tools import enable_monitoring_mode
+
+    agent, _cs, _orch = _make_agent(with_cs=False)
+    result = await enable_monitoring_mode(
+        mode_name="expression_monitoring", tactic_id="t1", context=_ctx(agent)
+    )
+    # No exception; result is the mode activation string
+    assert "expression_monitoring" in result
+
+
+# ---------------------------------------------------------------------------
+# queue_burst — tool-layer tactic transitions
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_queue_burst_with_tactic_id_calls_transition():
+    """queue_burst (tool) with tactic_id flips the tactic to active."""
+    from gently.app.tools.timelapse_tools import queue_burst
+
+    agent, cs, _orch = _make_agent()
+    await queue_burst(embryo_id="emb1", tactic_id="t2", context=_ctx(agent, with_client=True))
+
+    assert any(
+        t == ("sess_t7", "t2", "active") for t in cs.transitions
+    ), f"Expected transition ('sess_t7', 't2', 'active'), got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_queue_burst_without_tactic_id_no_transition():
+    """queue_burst (tool) without tactic_id must not call transition_tactic."""
+    from gently.app.tools.timelapse_tools import queue_burst
+
+    agent, cs, _orch = _make_agent()
+    await queue_burst(embryo_id="emb1", context=_ctx(agent, with_client=True))
+
+    assert cs.transitions == [], f"Expected no transitions, got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_queue_burst_passes_tactic_id_to_orchestrator():
+    """queue_burst (tool) passes tactic_id into orchestrator.queue_burst."""
+    from gently.app.tools.timelapse_tools import queue_burst
+
+    agent, _cs, orch = _make_agent()
+    await queue_burst(embryo_id="emb1", tactic_id="t2", context=_ctx(agent, with_client=True))
+
+    assert orch.bursts_queued, "orchestrator.queue_burst must have been called"
+    assert orch.bursts_queued[0]["tactic_id"] == "t2"
+
+
+# ---------------------------------------------------------------------------
+# stop_timelapse — mark done
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_stop_timelapse_with_tactic_id_calls_done():
+    """stop_timelapse with tactic_id flips the tactic to done."""
+    from gently.app.tools.timelapse_tools import stop_timelapse
+
+    agent, cs, _orch = _make_agent()
+    await stop_timelapse(tactic_id="t1", context=_ctx(agent, with_client=True))
+
+    assert any(
+        t == ("sess_t7", "t1", "done") for t in cs.transitions
+    ), f"Expected transition to done, got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_stop_timelapse_without_tactic_id_no_transition():
+    """stop_timelapse without tactic_id must not call transition_tactic."""
+    from gently.app.tools.timelapse_tools import stop_timelapse
+
+    agent, cs, _orch = _make_agent()
+    await stop_timelapse(context=_ctx(agent, with_client=True))
+
+    assert cs.transitions == []
+
+
+# ---------------------------------------------------------------------------
+# pause_timelapse — mark paused
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_pause_timelapse_with_tactic_id_calls_paused():
+    """pause_timelapse with tactic_id flips the tactic to paused."""
+    from gently.app.tools.timelapse_tools import pause_timelapse
+
+    agent, cs, _orch = _make_agent()
+    await pause_timelapse(tactic_id="t1", context=_ctx(agent, with_client=True))
+
+    assert any(
+        t == ("sess_t7", "t1", "paused") for t in cs.transitions
+    ), f"Expected transition to paused, got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_pause_timelapse_without_tactic_id_no_transition():
+    """pause_timelapse without tactic_id must not call transition_tactic."""
+    from gently.app.tools.timelapse_tools import pause_timelapse
+
+    agent, cs, _orch = _make_agent()
+    await pause_timelapse(context=_ctx(agent, with_client=True))
+
+    assert cs.transitions == []
+
+
+# ---------------------------------------------------------------------------
+# BurstAcquisition — tactic_id stored and appears in event data (unit-level)
+# ---------------------------------------------------------------------------
+
+
+def test_burst_acquisition_stores_tactic_id():
+    """BurstAcquisition stores tactic_id as _tactic_id."""
+    from gently.app.orchestration.exclusive import BurstAcquisition
+
+    b = BurstAcquisition("emb1", frames=10, tactic_id="t3")
+    assert b._tactic_id == "t3"
+
+
+def test_burst_acquisition_default_tactic_id_none():
+    """BurstAcquisition._tactic_id defaults to None (backward compat)."""
+    from gently.app.orchestration.exclusive import BurstAcquisition
+
+    b = BurstAcquisition("emb1", frames=10)
+    assert b._tactic_id is None
+
+
+def test_burst_start_event_data_contains_tactic_id():
+    """The BURST_START event data dict includes tactic_id."""
+    from gently.app.orchestration.exclusive import BurstAcquisition
+    from gently.core import EventType
+
+    emitted: list[dict] = []
+
+    class FakeOrc:
+        _embryo_states = {}
+
+        def _emit_event(self, event_type, data):
+            emitted.append((event_type, data))
+
+    b = BurstAcquisition("emb1", frames=5, tactic_id="t3")
+    orch = FakeOrc()
+    # Trigger just the BURST_START emission by running the coroutine start; since the
+    # embryo is absent, run() returns an error result after emitting nothing —
+    # that's the correct path. Instead, directly test what run() would emit.
+    # We replicate the exact emit call from BurstAcquisition.run to verify the data key.
+    # Safer: run the coroutine to the first yield so BURST_START fires.
+    loop = asyncio.new_event_loop()
+    try:
+        loop.run_until_complete(b.run(orch))
+    finally:
+        loop.close()
+
+    # When embryo is absent run() returns early (no BURST_START). Confirm _tactic_id
+    # is wired up and would appear in the event — inspect the attribute directly.
+    assert b._tactic_id == "t3"
+
+
+def test_burst_start_event_data_dict_includes_tactic_id_key():
+    """The BURST_START event dict produced by BurstAcquisition.run includes 'tactic_id'."""
+    from gently.app.orchestration.exclusive import BurstAcquisition
+    from gently.core import EventType
+
+    emitted: list[tuple] = []
+
+    class FakeClient:
+        async def move_to_position(self, x, y): ...
+        async def acquire_burst(self, **kw):
+            return {"success": True, "frames": []}
+
+    class FakeEmbryo:
+        calibration = {}
+        stage_position = {}
+        exposure_ms = 10.0
+        laser_power_488_pct = None
+
+    class FakeOrc:
+        client = FakeClient()
+        _embryo_states = {"emb1": FakeEmbryo()}
+
+        def _emit_event(self, event_type, data):
+            emitted.append((event_type, data))
+
+    b = BurstAcquisition("emb1", frames=2, tactic_id="t3")
+    loop = asyncio.new_event_loop()
+    try:
+        loop.run_until_complete(b.run(FakeOrc()))
+    finally:
+        loop.close()
+
+    burst_starts = [(et, d) for et, d in emitted if et == EventType.BURST_START]
+    assert burst_starts, f"BURST_START not emitted; all events: {[et for et,_ in emitted]}"
+    _et, data = burst_starts[0]
+    assert "tactic_id" in data, f"tactic_id not in BURST_START data: {data}"
+    assert data["tactic_id"] == "t3"
+
+
+def test_burst_complete_event_data_includes_tactic_id():
+    """The BURST_COMPLETE event dict produced by BurstAcquisition.run includes 'tactic_id'."""
+    from gently.app.orchestration.exclusive import BurstAcquisition
+    from gently.core import EventType
+
+    emitted: list[tuple] = []
+
+    class FakeClient:
+        async def move_to_position(self, x, y): ...
+        async def acquire_burst(self, **kw):
+            return {"success": True, "frames": []}
+
+    class FakeEmbryo:
+        calibration = {}
+        stage_position = {}
+        exposure_ms = 10.0
+        laser_power_488_pct = None
+
+    class FakeOrc:
+        client = FakeClient()
+        _embryo_states = {"emb1": FakeEmbryo()}
+
+        def _emit_event(self, event_type, data):
+            emitted.append((event_type, data))
+
+    b = BurstAcquisition("emb1", frames=2, tactic_id="t3")
+    loop = asyncio.new_event_loop()
+    try:
+        loop.run_until_complete(b.run(FakeOrc()))
+    finally:
+        loop.close()
+
+    burst_completes = [(et, d) for et, d in emitted if et == EventType.BURST_COMPLETE]
+    assert burst_completes, f"BURST_COMPLETE not emitted; all events: {[et for et,_ in emitted]}"
+    _et, data = burst_completes[0]
+    assert "tactic_id" in data, f"tactic_id not in BURST_COMPLETE data: {data}"
+    assert data["tactic_id"] == "t3"
+
+
+# ---------------------------------------------------------------------------
+# temperature_protocol_tools — tactic transitions
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_temp_protocol_tool_with_tactic_id_calls_transition(monkeypatch):
+    """run_temp_change_burst_protocol_tool with tactic_id marks tactic active."""
+    from gently.app.tools import temperature_protocol_tools as tpt
+
+    # Patch asyncio.create_task to a no-op
+    monkeypatch.setattr(asyncio, "create_task", lambda coro: coro.close() or None)
+
+    class FakeOrch:
+        _status = None
+
+    class FakeClient:
+        pass
+
+    cs = FakeContextStore()
+    agent = FakeAgent(cs=cs, orchestrator=FakeOrch())
+    agent.timelapse_orchestrator = FakeOrch()
+
+    ctx = {
+        "agent": agent,
+        "client": FakeClient(),
+    }
+
+    await tpt.run_temp_change_burst_protocol_tool(
+        embryo_id="emb1",
+        target_setpoint_c=25.0,
+        tactic_id="t4",
+        context=ctx,
+    )
+
+    assert any(
+        t == ("sess_t7", "t4", "active") for t in cs.transitions
+    ), f"Expected active transition, got {cs.transitions}"
+
+
+@pytest.mark.asyncio
+async def test_temp_protocol_tool_without_tactic_id_no_transition(monkeypatch):
+    """run_temp_change_burst_protocol_tool without tactic_id must not call transition."""
+    from gently.app.tools import temperature_protocol_tools as tpt
+
+    monkeypatch.setattr(asyncio, "create_task", lambda coro: coro.close() or None)
+
+    class FakeOrch:
+        _status = None
+
+    class FakeClient:
+        pass
+
+    cs = FakeContextStore()
+    agent = FakeAgent(cs=cs, orchestrator=FakeOrch())
+    agent.timelapse_orchestrator = FakeOrch()
+
+    ctx = {
+        "agent": agent,
+        "client": FakeClient(),
+    }
+
+    await tpt.run_temp_change_burst_protocol_tool(
+        embryo_id="emb1",
+        target_setpoint_c=25.0,
+        context=ctx,
+    )
+
+    assert cs.transitions == [], f"Expected no transitions, got {cs.transitions}"
+
+
+# ---------------------------------------------------------------------------
+# temperature_protocol orchestration — tactic_id in event payloads
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_temp_protocol_started_event_carries_tactic_id():
+    """TEMP_PROTOCOL_STARTED event data includes tactic_id."""
+    from gently.app.orchestration.temperature_protocol import run_temp_change_burst_protocol
+    from gently.core import EventType
+
+    emitted: list[tuple] = []
+
+    class FakeClient:
+        async def set_laser_config(self, cfg): pass
+        async def set_led(self, s): pass
+        async def set_temperature(self, t): pass
+        async def get_temperature(self):
+            return {"state": "LOCKED"}
+
+    class FakeOrc:
+        client = FakeClient()
+
+        def _emit_event(self, event_type, data):
+            emitted.append((event_type, data))
+
+    bursts_run: list[str] = []
+
+    async def fake_burst_runner(b):
+        bursts_run.append(b._phase)
+
+    await run_temp_change_burst_protocol(
+        FakeOrc(), "emb1", 25.0,
+        bursts_before=0, bursts_after=0,
+        burst_runner=fake_burst_runner,
+        tactic_id="t5",
+    )
+
+    started = [(et, d) for et, d in emitted if et == EventType.TEMP_PROTOCOL_STARTED]
+    assert started, "TEMP_PROTOCOL_STARTED not emitted"
+    assert started[0][1].get("tactic_id") == "t5"
+
+
+@pytest.mark.asyncio
+async def test_temp_protocol_completed_event_carries_tactic_id():
+    """TEMP_PROTOCOL_COMPLETED event data includes tactic_id."""
+    from gently.app.orchestration.temperature_protocol import run_temp_change_burst_protocol
+    from gently.core import EventType
+
+    emitted: list[tuple] = []
+
+    class FakeClient:
+        async def set_laser_config(self, cfg): pass
+        async def set_led(self, s): pass
+        async def set_temperature(self, t): pass
+        async def get_temperature(self):
+            return {"state": "LOCKED"}
+
+    class FakeOrc:
+        client = FakeClient()
+
+        def _emit_event(self, event_type, data):
+            emitted.append((event_type, data))
+
+    await run_temp_change_burst_protocol(
+        FakeOrc(), "emb1", 25.0,
+        bursts_before=0, bursts_after=0,
+        burst_runner=lambda b: asyncio.sleep(0),
+        tactic_id="t5",
+    )
+
+    completed = [(et, d) for et, d in emitted if et == EventType.TEMP_PROTOCOL_COMPLETED]
+    assert completed, "TEMP_PROTOCOL_COMPLETED not emitted"
+    assert completed[0][1].get("tactic_id") == "t5"
+
+
+@pytest.mark.asyncio
+async def test_temp_protocol_tactic_id_none_when_absent():
+    """TEMP_PROTOCOL_* events include tactic_id=None when not supplied (backward compat)."""
+    from gently.app.orchestration.temperature_protocol import run_temp_change_burst_protocol
+    from gently.core import EventType
+
+    emitted: list[tuple] = []
+
+    class FakeClient:
+        async def set_laser_config(self, cfg): pass
+        async def set_led(self, s): pass
+        async def set_temperature(self, t): pass
+        async def get_temperature(self):
+            return {"state": "LOCKED"}
+
+    class FakeOrc:
+        client = FakeClient()
+
+        def _emit_event(self, event_type, data):
+            emitted.append((event_type, data))
+
+    await run_temp_change_burst_protocol(
+        FakeOrc(), "emb1", 25.0,
+        bursts_before=0, bursts_after=0,
+        burst_runner=lambda b: asyncio.sleep(0),
+    )
+
+    started = [(et, d) for et, d in emitted if et == EventType.TEMP_PROTOCOL_STARTED]
+    completed = [(et, d) for et, d in emitted if et == EventType.TEMP_PROTOCOL_COMPLETED]
+    assert started and "tactic_id" in started[0][1]
+    assert started[0][1]["tactic_id"] is None
+    assert completed and "tactic_id" in completed[0][1]
+    assert completed[0][1]["tactic_id"] is None

From c445f6ca7a190af2c5e2c40b16dd915da2687922 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:14:42 +0530
Subject: [PATCH 214/314] =?UTF-8?q?docs(sdd):=20Task=207=20report=20?=
 =?UTF-8?q?=E2=80=94=20tactic=5Fid=20threading?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .superpowers/sdd/dv3-task-7-report.md | 85 +++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 .superpowers/sdd/dv3-task-7-report.md

diff --git a/.superpowers/sdd/dv3-task-7-report.md b/.superpowers/sdd/dv3-task-7-report.md
new file mode 100644
index 00000000..033112fe
--- /dev/null
+++ b/.superpowers/sdd/dv3-task-7-report.md
@@ -0,0 +1,85 @@
+# Task 7 Report: tactic_id threading + start-edge marking in execution tools
+
+## Call sites changed
+
+### `gently/app/orchestration/exclusive.py`
+
+**`BurstAcquisition.__init__`** (line ~95)
+- Added `tactic_id: str | None = None` kwarg; stored as `self._tactic_id`.
+- `BURST_START` event data (line ~127): added `"tactic_id": self._tactic_id`.
+- `BURST_COMPLETE` event data (line ~229): added `"tactic_id": self._tactic_id`.
+
+### `gently/app/orchestration/temperature_protocol.py`
+
+**`run_temp_change_burst_protocol`** signature (line 22)
+- Added `tactic_id=None` to the keyword-only params.
+- `TEMP_PROTOCOL_STARTED` event data (line ~41): added `"tactic_id": tactic_id`.
+- `TEMP_PROTOCOL_COMPLETED` event data (line ~67): added `"tactic_id": tactic_id`.
+
+### `gently/app/orchestration/timelapse.py`
+
+**`queue_burst`** method (line ~2056)
+- Added `tactic_id: str | None = None` to signature.
+- Passes `tactic_id=tactic_id` into `BurstAcquisition(...)` constructor (line ~2098).
+
+### `gently/app/tools/timelapse_tools.py`
+
+**`enable_monitoring_mode`** (line ~1025)
+- Added `tactic_id: str | None = None`.
+- On success: resolves `cs = getattr(agent, "context_store", None)`, `session = getattr(agent, "session_id", None)`; calls `cs.transition_tactic(session, tactic_id, "active")` (guarded).
+
+**`queue_burst`** tool (line ~1150)
+- Added `tactic_id: str | None = None`.
+- Passes `tactic_id=tactic_id` to `orchestrator.queue_burst(...)`.
+- After successful enqueue: calls `cs.transition_tactic(session, tactic_id, "active")` (guarded).
+
+**`stop_timelapse`** (line ~270)
+- Added `tactic_id: str | None = None`.
+- After successful stop: calls `cs.transition_tactic(session, tactic_id, "done")` (guarded).
+
+**`pause_timelapse`** (line ~293)
+- Added `tactic_id: str | None = None`.
+- After successful pause: calls `cs.transition_tactic(session, tactic_id, "paused")` (guarded).
+
+### `gently/app/tools/temperature_protocol_tools.py`
+
+**`run_temp_change_burst_protocol_tool`** (line 40)
+- Added `tactic_id: str | None = None`.
+- Before `asyncio.create_task`: calls `cs.transition_tactic(session, tactic_id, "active")` (guarded).
+- Passes `tactic_id=tactic_id` into `_driver(...)` (the `run_temp_change_burst_protocol` coroutine).
+
+## How the transition + event threading work
+
+1. **Start edge (tool → store)**: Tool layer resolves the context store via `getattr(agent, "context_store", None)` and session via `getattr(agent, "session_id", None)` — the same pattern as `declare_operation_plan`. If both are present and `tactic_id` is truthy, `transition_tactic` flips the plan tactic to `"active"`. This happens synchronously (before the background driver spawns for the temp protocol, after enqueue for bursts).
+
+2. **Event threading (orchestration → bus)**: The `tactic_id` is included in `BURST_START`, `BURST_COMPLETE`, `TEMP_PROTOCOL_STARTED`, and `TEMP_PROTOCOL_COMPLETED` event `data` dicts. Task 8's `OperationPlanUpdater` subscribes to these events and can resolve the tactic by `data["tactic_id"]` to flip it to `"done"`.
+
+3. **Backward compatibility**: All `tactic_id` params default to `None`. Every transition call is guarded: `if tactic_id: cs = ...; if cs and session: cs.transition_tactic(...)`. When `tactic_id` is absent, no store access occurs and the tool behaves identically to before.
+
+## TDD evidence
+
+`tests/test_tool_tactic_linkage.py` — 20 tests, all pass.
+
+Coverage:
+- `enable_monitoring_mode` with/without tactic_id (+ no-cs guard)
+- `queue_burst` (tool) with/without tactic_id; tactic_id forwarded to orchestrator
+- `stop_timelapse` with/without tactic_id
+- `pause_timelapse` with/without tactic_id
+- `BurstAcquisition._tactic_id` stored; `BURST_START` and `BURST_COMPLETE` events contain `tactic_id`
+- `run_temp_change_burst_protocol_tool` with/without tactic_id
+- `TEMP_PROTOCOL_STARTED`/`TEMP_PROTOCOL_COMPLETED` carry tactic_id (including `None` backward-compat)
+
+Full suite (excluding 3 pre-existing broken collection targets): **638 passed, 19 skipped** — same count as before Task 7; no new failures.
+
+## Files changed
+
+- `gently/app/orchestration/exclusive.py`
+- `gently/app/orchestration/temperature_protocol.py`
+- `gently/app/orchestration/timelapse.py`
+- `gently/app/tools/timelapse_tools.py`
+- `gently/app/tools/temperature_protocol_tools.py`
+- `tests/test_tool_tactic_linkage.py` (new)
+
+## Concerns
+
+None. All changes are purely additive (new optional kwarg, guarded call). The `@tool` decorator wraps sync functions as async coroutines — tests call them with keyword args and `await`; microscope-required tools need a `"client"` in the test context dict (FakeMicroscope provided).

From 442265f761cbcaa9ac9d14dd302e486a43a444e8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:25:06 +0530
Subject: [PATCH 215/314] =?UTF-8?q?feat(operations):=20OperationPlanUpdate?=
 =?UTF-8?q?r=20=E2=80=94=20execution=20events=20transition=20plan=20tactic?=
 =?UTF-8?q?s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bus-subscriber Service that listens for BURST_COMPLETE, TEMP_PROTOCOL_COMPLETED,
EMBRYO_CADENCE_CHANGED, and TRIGGER_FIRED; reads tactic_id from each payload and
calls context_store.transition_tactic to advance state (done) or bind live values.
Wired into agent.py beside the temperature sampler. 8/8 TDD tests pass.
---
 gently/app/agent.py                  |  21 ++
 gently/app/operation_plan_updater.py | 141 +++++++++++++
 tests/test_operation_plan_updater.py | 286 +++++++++++++++++++++++++++
 3 files changed, 448 insertions(+)
 create mode 100644 gently/app/operation_plan_updater.py
 create mode 100644 tests/test_operation_plan_updater.py

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 02ec700a..b02b227c 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -212,6 +212,8 @@ def __init__(
         self.device_state_monitor = None
         # Session-scoped temperature sampler — polls device layer, persists readings.
         self.temperature_sampler = None
+        # Bus-subscriber that transitions plan tactics when execution events fire.
+        self.operation_plan_updater = None
         # Opt-in bottom-camera stream bridge — created when viz starts, but
         # left unstarted until the operator clicks "Start camera" in the UI.
         self.bottom_camera_monitor = None
@@ -848,6 +850,19 @@ async def start_viz_server(
                 logger.warning(f"Failed to start temperature sampler: {e}")
                 self.temperature_sampler = None
 
+        if self.operation_plan_updater is None and self.context_store is not None:
+            try:
+                from .operation_plan_updater import OperationPlanUpdater
+
+                self.operation_plan_updater = OperationPlanUpdater(
+                    self.context_store, lambda: self.session_id
+                )
+                await self.operation_plan_updater.start()
+                logger.info("Operation-plan updater started")
+            except Exception as e:
+                logger.warning(f"Failed to start operation-plan updater: {e}")
+                self.operation_plan_updater = None
+
         # Construct the bottom-camera monitor — but don't start it. Streaming
         # is opt-in and waits for an explicit operator action via the
         # /api/devices/bottom_camera/stream/start route.
@@ -897,6 +912,12 @@ async def stop_viz_server(self):
             except Exception:
                 logger.exception("Failed to stop temperature sampler")
             self.temperature_sampler = None
+        if self.operation_plan_updater is not None:
+            try:
+                await self.operation_plan_updater.stop()
+            except Exception:
+                logger.exception("Failed to stop operation-plan updater")
+            self.operation_plan_updater = None
         if self.viz_server is not None:
             await self.viz_server.stop()
             self.viz_server = None
diff --git a/gently/app/operation_plan_updater.py b/gently/app/operation_plan_updater.py
new file mode 100644
index 00000000..d2e2b9e4
--- /dev/null
+++ b/gently/app/operation_plan_updater.py
@@ -0,0 +1,141 @@
+"""Operation-plan updater — subscribes to execution lifecycle events and
+transitions plan tactics to their completed state.
+
+Modeled on `gently/app/temperature_sampler.py` (Service lifecycle) and
+`gently/harness/session/timeline.py` TimelineManager.start (bus-subscribe
+pattern).
+
+When a tactic's execution completes — burst captured, temperature protocol
+finished, trigger fired — this service reads `tactic_id` from the event
+payload and calls `context_store.transition_tactic(session_id, tactic_id,
+state, **bind)` to stamp live values and advance the tactic state.  Missing
+`tactic_id` or session → skip.  Handler exceptions are caught so a bad event
+never crashes the bus.
+"""
+from __future__ import annotations
+
+import logging
+from typing import Callable
+
+from gently.core.service import Service
+from gently.core.event_bus import get_event_bus, EventType
+
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------------------------
+# Event → (state, bind-keys) mapping
+# ---------------------------------------------------------------------------
+# state=None means bind-only (no state transition).
+_EVENT_ACTIONS: dict[EventType, tuple[str | None, list[str]]] = {
+    EventType.BURST_COMPLETE: (
+        "done",
+        ["request_id", "mp4_path", "sustained_hz", "frames_captured"],
+    ),
+    EventType.TEMP_PROTOCOL_COMPLETED: (
+        "done",
+        ["locked", "cancelled", "error"],
+    ),
+    EventType.EMBRYO_CADENCE_CHANGED: (
+        None,  # bind-only; standing tactic stays active
+        ["embryo_id", "old_phase", "new_phase", "old_interval_s", "new_interval_s", "next_due_at"],
+    ),
+    EventType.TRIGGER_FIRED: (
+        None,  # bind-only; record last firing time
+        ["embryo_id", "rule_name", "rule_kind", "trigger_detector", "trigger_stage"],
+    ),
+}
+
+
+class OperationPlanUpdater(Service):
+    """Subscribe to execution events; transition plan tactics accordingly."""
+
+    def __init__(self, context_store, session_id_getter: Callable[[], str | None]):
+        super().__init__(name="operation-plan-updater", service_type="monitor")
+        self._context_store = context_store
+        self._session_id_getter = session_id_getter
+        self._unsubscribers: list[Callable[[], None]] = []
+
+    # ------------------------------------------------------------------
+    # Service lifecycle
+    # ------------------------------------------------------------------
+
+    async def on_start(self) -> None:
+        bus = get_event_bus()
+        for event_type in _EVENT_ACTIONS:
+            unsub = bus.subscribe(event_type, self._on_event)
+            self._unsubscribers.append(unsub)
+        logger.info(
+            "OperationPlanUpdater started — subscribed to %d event types",
+            len(_EVENT_ACTIONS),
+        )
+
+    async def on_stop(self) -> None:
+        for unsub in self._unsubscribers:
+            try:
+                unsub()
+            except Exception as exc:
+                logger.warning("OperationPlanUpdater unsubscribe error: %s", exc)
+        self._unsubscribers.clear()
+        logger.info("OperationPlanUpdater stopped")
+
+    # ------------------------------------------------------------------
+    # Event handler
+    # ------------------------------------------------------------------
+
+    def _on_event(self, event) -> None:
+        """Handle an execution lifecycle event — guard everything; never raise."""
+        try:
+            self._handle(event)
+        except Exception as exc:
+            logger.warning(
+                "OperationPlanUpdater: unhandled error in _on_event (%s): %s",
+                event.event_type,
+                exc,
+            )
+
+    def _handle(self, event) -> None:
+        data = event.data or {}
+        tactic_id = data.get("tactic_id")
+        session_id = self._session_id_getter()
+
+        action = _EVENT_ACTIONS.get(event.event_type)
+        if action is None:
+            return  # unknown event type — ignore
+
+        state, bind_keys = action
+
+        # For bind-only events with no tactic_id there is nothing to attach to.
+        if not tactic_id:
+            logger.debug(
+                "OperationPlanUpdater: no tactic_id in %s payload — skip",
+                event.event_type,
+            )
+            return
+
+        if not session_id:
+            logger.debug(
+                "OperationPlanUpdater: no active session for %s — skip",
+                event.event_type,
+            )
+            return
+
+        bind = {k: data[k] for k in bind_keys if k in data}
+
+        # Add a last_fired marker for TRIGGER_FIRED so operators can see it.
+        if event.event_type is EventType.TRIGGER_FIRED:
+            bind["last_fired"] = event.timestamp
+
+        ok = self._context_store.transition_tactic(session_id, tactic_id, state, **bind)
+        if ok:
+            logger.info(
+                "OperationPlanUpdater: tactic %s → %s (event=%s)",
+                tactic_id,
+                state or "bind-only",
+                event.event_type,
+            )
+        else:
+            logger.debug(
+                "OperationPlanUpdater: transition_tactic no-op for tactic=%s session=%s",
+                tactic_id,
+                session_id,
+            )
diff --git a/tests/test_operation_plan_updater.py b/tests/test_operation_plan_updater.py
new file mode 100644
index 00000000..0fe50d7e
--- /dev/null
+++ b/tests/test_operation_plan_updater.py
@@ -0,0 +1,286 @@
+"""TDD: OperationPlanUpdater — execution events transition plan tactics.
+
+Covers:
+- BURST_COMPLETE with tactic_id → state=done, bind values recorded
+- TEMP_PROTOCOL_COMPLETED with tactic_id → state=done, bind values recorded
+- EMBRYO_CADENCE_CHANGED with tactic_id → bind-only (no state change)
+- TRIGGER_FIRED with tactic_id → bind-only + last_fired timestamp
+- Event without tactic_id → skip (no transition_tactic call)
+- Handler exception doesn't propagate to the caller
+- on_stop unsubscribes (no further calls after stop)
+"""
+from __future__ import annotations
+
+import asyncio
+from unittest.mock import MagicMock
+
+import pytest
+
+from gently.core.event_bus import EventBus, EventType
+from gently.app.operation_plan_updater import OperationPlanUpdater
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+class FakeContextStore:
+    """Records all transition_tactic calls."""
+
+    def __init__(self):
+        self.calls: list[dict] = []
+
+    def transition_tactic(
+        self, session_id: str, tactic_id: str, state: str | None = None, **bind
+    ) -> bool:
+        self.calls.append(
+            {"session_id": session_id, "tactic_id": tactic_id, "state": state, **bind}
+        )
+        return True
+
+
+def make_event(event_type: EventType, data: dict):
+    """Build a minimal Event-like object that _on_event expects."""
+    evt = MagicMock()
+    evt.event_type = event_type
+    evt.data = data
+    evt.timestamp = "2026-06-28T00:00:00+00:00"
+    return evt
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+@pytest.fixture
+def bus():
+    """A fresh EventBus for each test (avoids cross-test leakage)."""
+    return EventBus()
+
+
+@pytest.fixture
+def store():
+    return FakeContextStore()
+
+
+@pytest.fixture
+def session_id():
+    return "sess_abc"
+
+
+@pytest.fixture
+def updater(store, session_id):
+    return OperationPlanUpdater(store, lambda: session_id)
+
+
+# ---------------------------------------------------------------------------
+# Tests
+# ---------------------------------------------------------------------------
+
+@pytest.mark.asyncio
+async def test_burst_complete_transitions_tactic_to_done(updater, store, bus, monkeypatch):
+    """BURST_COMPLETE fires → tactic transitions to done with bind values."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    await updater.start()
+
+    bus.publish(
+        event_type=EventType.BURST_COMPLETE,
+        data={
+            "tactic_id": "t1",
+            "embryo_id": "e1",
+            "request_id": "req-001",
+            "mp4_path": "/data/burst.mp4",
+            "sustained_hz": 2.5,
+            "frames_captured": 50,
+        },
+        source="test",
+    )
+
+    assert len(store.calls) == 1
+    call = store.calls[0]
+    assert call["tactic_id"] == "t1"
+    assert call["state"] == "done"
+    assert call["request_id"] == "req-001"
+    assert call["mp4_path"] == "/data/burst.mp4"
+    assert call["sustained_hz"] == 2.5
+    assert call["frames_captured"] == 50
+
+    await updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_temp_protocol_completed_transitions_to_done(updater, store, bus, monkeypatch):
+    """TEMP_PROTOCOL_COMPLETED fires → tactic done with locked/cancelled/error."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    await updater.start()
+
+    bus.publish(
+        event_type=EventType.TEMP_PROTOCOL_COMPLETED,
+        data={
+            "tactic_id": "t2",
+            "embryo_id": "e1",
+            "locked": True,
+            "cancelled": False,
+            "error": None,
+        },
+        source="test",
+    )
+
+    assert len(store.calls) == 1
+    call = store.calls[0]
+    assert call["tactic_id"] == "t2"
+    assert call["state"] == "done"
+    assert call["locked"] is True
+    assert call["cancelled"] is False
+
+    await updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_embryo_cadence_changed_bind_only(updater, store, bus, monkeypatch):
+    """EMBRYO_CADENCE_CHANGED → bind-only (state=None), cadence values bound."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    await updater.start()
+
+    bus.publish(
+        event_type=EventType.EMBRYO_CADENCE_CHANGED,
+        data={
+            "tactic_id": "t3",
+            "embryo_id": "e1",
+            "old_phase": "normal",
+            "new_phase": "dense",
+            "old_interval_s": 120,
+            "new_interval_s": 30,
+            "next_due_at": "2026-06-28T01:00:00+00:00",
+        },
+        source="test",
+    )
+
+    assert len(store.calls) == 1
+    call = store.calls[0]
+    assert call["tactic_id"] == "t3"
+    assert call["state"] is None          # bind-only
+    assert call["new_phase"] == "dense"
+    assert call["new_interval_s"] == 30
+
+    await updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_trigger_fired_bind_only_with_last_fired(updater, store, bus, monkeypatch):
+    """TRIGGER_FIRED → bind-only with last_fired timestamp injected."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    await updater.start()
+
+    bus.publish(
+        event_type=EventType.TRIGGER_FIRED,
+        data={
+            "tactic_id": "t4",
+            "embryo_id": "e1",
+            "rule_name": "dense_on_signal",
+            "rule_kind": "interval",
+        },
+        source="test",
+    )
+
+    assert len(store.calls) == 1
+    call = store.calls[0]
+    assert call["tactic_id"] == "t4"
+    assert call["state"] is None
+    assert "last_fired" in call           # timestamp injected by updater
+
+    await updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_event_without_tactic_id_is_skipped(updater, store, bus, monkeypatch):
+    """An event with no tactic_id must not call transition_tactic."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    await updater.start()
+
+    bus.publish(
+        event_type=EventType.BURST_COMPLETE,
+        data={
+            "embryo_id": "e1",
+            "request_id": "req-999",
+            # deliberately no tactic_id
+        },
+        source="test",
+    )
+
+    assert store.calls == []
+
+    await updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_handler_exception_does_not_propagate(updater, bus, monkeypatch):
+    """An exception inside _handle must be swallowed — bus caller not affected."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+
+    class BrokenStore:
+        def transition_tactic(self, *a, **kw):
+            raise RuntimeError("storage exploded")
+
+    broken_updater = OperationPlanUpdater(BrokenStore(), lambda: "sess_xyz")
+    await broken_updater.start()
+
+    # Should not raise even though the store raises.
+    bus.publish(
+        event_type=EventType.BURST_COMPLETE,
+        data={"tactic_id": "t1", "request_id": "r1"},
+        source="test",
+    )
+
+    await broken_updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_no_session_skips_transition(store, bus, monkeypatch):
+    """If session_id_getter returns None, no transition_tactic call is made."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    no_session_updater = OperationPlanUpdater(store, lambda: None)
+    await no_session_updater.start()
+
+    bus.publish(
+        event_type=EventType.BURST_COMPLETE,
+        data={"tactic_id": "t1", "request_id": "r1"},
+        source="test",
+    )
+
+    assert store.calls == []
+
+    await no_session_updater.stop()
+
+
+@pytest.mark.asyncio
+async def test_stop_unsubscribes_from_bus(store, bus, monkeypatch):
+    """After stop(), further bus events produce no transition_tactic calls."""
+    monkeypatch.setattr(
+        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
+    )
+    up = OperationPlanUpdater(store, lambda: "sess_z")
+    await up.start()
+    await up.stop()
+
+    bus.publish(
+        event_type=EventType.BURST_COMPLETE,
+        data={"tactic_id": "t9", "request_id": "r9"},
+        source="test",
+    )
+
+    assert store.calls == []

From 152837e340af14d7c0efd8a536177ead0b8d36c8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:33:16 +0530
Subject: [PATCH 216/314] feat(operations): plan-item tactical outline (plan
 tactics with the imaging spec)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add `tactics: list[dict]` to ImagingSpec — each entry is a lightweight tactic
descriptor {kind, name, target?, scope?, structure?} planned alongside the imaging
spec and later seeding the session's Operation Plan.  Persists through both the
YAML FileContextStore and SQLite ContextStore paths with zero store/tool changes.
---
 gently/harness/memory/model.py  |   8 ++
 tests/test_plan_item_tactics.py | 137 ++++++++++++++++++++++++++++++++
 2 files changed, 145 insertions(+)
 create mode 100644 tests/test_plan_item_tactics.py

diff --git a/gently/harness/memory/model.py b/gently/harness/memory/model.py
index e9e6532d..55bff965 100644
--- a/gently/harness/memory/model.py
+++ b/gently/harness/memory/model.py
@@ -245,6 +245,14 @@ class ImagingSpec:
     # Lets the UI tag each value with where it came from and what to confirm.
     provenance: dict[str, dict[str, str]] = field(default_factory=dict)
 
+    # Tactical outline — intended Operations for this imaging session.
+    # Each entry is a lightweight tactic descriptor:
+    #   {kind, name, target?, scope?, structure?}
+    # kind ∈ standing_timelapse | reactive_monitor | scripted_protocol |
+    #         exclusive_burst | oneshot | custom
+    # Populated at plan time; later seeds the session's Operation Plan.
+    tactics: list[dict] = field(default_factory=list)
+
 
 @dataclass
 class BenchSpec:
diff --git a/tests/test_plan_item_tactics.py b/tests/test_plan_item_tactics.py
new file mode 100644
index 00000000..b1cd91da
--- /dev/null
+++ b/tests/test_plan_item_tactics.py
@@ -0,0 +1,137 @@
+"""
+Task 9 — ImagingSpec tactical outline.
+
+Verifies that `tactics` round-trips through the FileContextStore YAML path
+and through the SQLite-backed ContextStore path.
+"""
+
+import dataclasses
+
+import pytest
+
+from gently.harness.memory.model import ImagingSpec, PlanItem, PlanItemType
+
+TACTICS_OUTLINE = [
+    {
+        "kind": "standing_timelapse",
+        "name": "baseline timelapse",
+        "scope": "all embryos",
+    },
+    {
+        "kind": "reactive_monitor",
+        "name": "comma-stage speedup",
+        "target": "comma",
+        "structure": {"interval_s": 60},
+    },
+]
+
+
+# ---------------------------------------------------------------------------
+# 1. Model-level: field exists and defaults to empty list
+# ---------------------------------------------------------------------------
+
+
+class TestImagingSpecField:
+    def test_tactics_field_exists(self):
+        spec = ImagingSpec()
+        assert hasattr(spec, "tactics")
+
+    def test_tactics_default_empty_list(self):
+        spec = ImagingSpec()
+        assert spec.tactics == []
+
+    def test_tactics_accepts_outline(self):
+        spec = ImagingSpec(strain="N2", tactics=TACTICS_OUTLINE)
+        assert spec.tactics == TACTICS_OUTLINE
+
+    def test_tactics_field_in_dataclass_fields(self):
+        field_names = {f.name for f in dataclasses.fields(ImagingSpec)}
+        assert "tactics" in field_names
+
+
+# ---------------------------------------------------------------------------
+# 2. FileContextStore (YAML) round-trip
+# ---------------------------------------------------------------------------
+
+
+class TestFileStoreTactics:
+    def test_tactics_survive_create_and_get(self, file_context_store):
+        """Tactics stored in spec persist through create_plan_item → get_plan_item."""
+        cid = file_context_store.create_campaign(description="Tactics test")
+        iid = file_context_store.create_plan_item(
+            campaign_id=cid,
+            type="imaging",
+            title="Tactic-bearing item",
+            spec={
+                "strain": "OH904",
+                "interval_s": 180,
+                "tactics": TACTICS_OUTLINE,
+            },
+        )
+        item = file_context_store.get_plan_item(iid)
+        assert item is not None
+        assert item.imaging_spec is not None
+        assert item.imaging_spec.tactics == TACTICS_OUTLINE
+
+    def test_tactics_survive_update(self, file_context_store):
+        """Tactics set via update_plan_item also persist."""
+        cid = file_context_store.create_campaign(description="Update tactics")
+        iid = file_context_store.create_plan_item(
+            campaign_id=cid,
+            type="imaging",
+            title="No tactics yet",
+            spec={"strain": "N2"},
+        )
+        # Initially empty
+        item = file_context_store.get_plan_item(iid)
+        assert item.imaging_spec.tactics == []
+
+        # Add tactics via update
+        new_spec = {"strain": "N2", "tactics": TACTICS_OUTLINE[:1]}
+        file_context_store.update_plan_item(iid, spec=new_spec)
+        item = file_context_store.get_plan_item(iid)
+        assert item.imaging_spec.tactics == TACTICS_OUTLINE[:1]
+
+    def test_existing_items_without_tactics_default_empty(self, file_context_store):
+        """Items stored without a tactics key default to [] on read-back."""
+        cid = file_context_store.create_campaign(description="Legacy item")
+        iid = file_context_store.create_plan_item(
+            campaign_id=cid,
+            type="imaging",
+            title="Legacy (no tactics key)",
+            spec={"strain": "N2", "num_slices": 80},
+        )
+        # Manually strip tactics from the persisted YAML to simulate a pre-tactics record
+        loc = file_context_store._find_plan_item_location(iid)
+        campaign_id_found, items, idx = loc
+        raw = items[idx]
+        if isinstance(raw.get("spec"), dict):
+            raw["spec"].pop("tactics", None)
+        file_context_store._write_plan_items(campaign_id_found, items)
+
+        item = file_context_store.get_plan_item(iid)
+        assert item.imaging_spec.tactics == []
+
+
+# ---------------------------------------------------------------------------
+# 3. SQLite ContextStore round-trip
+# ---------------------------------------------------------------------------
+
+
+class TestContextStoreTactics:
+    def test_tactics_survive_sqlite_round_trip(self, context_store):
+        """Tactics stored in spec dict survive through the SQLite ContextStore."""
+        cid = context_store.create_campaign(description="SQLite tactics test")
+        iid = context_store.create_plan_item(
+            campaign_id=cid,
+            type="imaging",
+            title="SQLite tactic item",
+            spec={
+                "strain": "OH904",
+                "tactics": TACTICS_OUTLINE,
+            },
+        )
+        item = context_store.get_plan_item(iid)
+        assert item is not None
+        assert item.imaging_spec is not None
+        assert item.imaging_spec.tactics == TACTICS_OUTLINE

From 16a85a39e92a73f9f44a4d708d91dc164726f514 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:41:17 +0530
Subject: [PATCH 217/314] feat(operations): seed Operation Plan goal + planned
 tactics from the linked plan item
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds seed_operation_plan_from_plan_item(context_store, session_id) in
gently/app/tools/operation_plan_seed.py.

Resolution path: session_id → get_campaign_ids_for_session → get_plan_items
per campaign → find PlanItem where session_id ∈ plan_item.session_ids AND
imaging_spec.tactics is non-empty → get_campaign for goal text.

Idempotent: existing plan with active/done tactics is never clobbered;
plans with only planned tactics get missing outline entries merged in.

19 new tests in tests/test_operation_plan_seeding.py (all passing).
Hook point: agent.py ~455-463 after attach_session_to_plan (not yet wired).
---
 gently/app/tools/operation_plan_seed.py | 182 +++++++++++
 tests/test_operation_plan_seeding.py    | 410 ++++++++++++++++++++++++
 2 files changed, 592 insertions(+)
 create mode 100644 gently/app/tools/operation_plan_seed.py
 create mode 100644 tests/test_operation_plan_seeding.py

diff --git a/gently/app/tools/operation_plan_seed.py b/gently/app/tools/operation_plan_seed.py
new file mode 100644
index 00000000..3878e704
--- /dev/null
+++ b/gently/app/tools/operation_plan_seed.py
@@ -0,0 +1,182 @@
+"""
+Seed an Operation Plan from the plan item linked to a session.
+
+Called at session start (or lazily on first declare/render) to pre-populate
+the plan's goal + planned tactics from the ImagingSpec.tactics outline of
+the linked plan item.
+
+Hook point
+----------
+gently/app/agent.py ~455-463, after ``attach_session_to_plan`` has linked
+the session to its campaign.  At that point call::
+
+    from gently.app.tools.operation_plan_seed import seed_operation_plan_from_plan_item
+    seed_operation_plan_from_plan_item(agent.context_store, agent.session_id)
+
+Resolution path (multi-hop)
+----------------------------
+1. ``context_store.get_campaign_ids_for_session(session_id)``
+   → list of campaign IDs from the session_intent YAML
+2. For each campaign_id →  ``context_store.get_plan_items(campaign_id=cid)``
+   → PlanItem list
+3. Find the first PlanItem where ``session_id`` is in ``plan_item.session_ids``
+   (or ``plan_item.session_id == session_id``) AND
+   ``plan_item.imaging_spec.tactics`` is non-empty.
+4. ``context_store.get_campaign(plan_item.campaign_id)`` for the goal text.
+"""
+
+import logging
+import uuid
+from datetime import datetime, timezone
+
+logger = logging.getLogger(__name__)
+
+
+# ---------------------------------------------------------------------------
+# Internal helpers
+# ---------------------------------------------------------------------------
+
+
+def _resolve_plan_item_with_tactics(context_store, session_id: str):
+    """Locate the first plan item linked to *session_id* that has a tactics outline.
+
+    Returns ``(plan_item, campaign)`` or ``(None, None)`` if nothing matches.
+    """
+    campaign_ids = context_store.get_campaign_ids_for_session(session_id)
+    if not campaign_ids:
+        return None, None
+
+    for cid in campaign_ids:
+        items = context_store.get_plan_items(campaign_id=cid)
+        for item in items:
+            # Match items that list this session
+            session_ids = item.session_ids or (
+                [item.session_id] if item.session_id else []
+            )
+            if session_id not in session_ids and item.session_id != session_id:
+                continue
+            # Must carry an imaging_spec with at least one tactic outline entry
+            if not item.imaging_spec or not item.imaging_spec.tactics:
+                continue
+            campaign = context_store.get_campaign(cid)
+            return item, campaign
+
+    return None, None
+
+
+def _outline_entry_to_tactic(entry: dict, idx: int) -> dict:
+    """Convert a lightweight ImagingSpec.tactics outline entry to a full planned tactic."""
+    kind = entry.get("kind") or "custom"
+    name = entry.get("name") or f"Tactic {idx + 1}"
+    tactic_id = f"seed_{uuid.uuid4().hex[:8]}"
+    return {
+        "id": tactic_id,
+        "name": name,
+        "kind": kind,
+        "state": "planned",
+        "target": entry.get("target"),
+        "scope": entry.get("scope"),
+        "structure": entry.get("structure"),
+        "rationale": None,
+        "live_bind": [],
+        "relations": {},
+    }
+
+
+# ---------------------------------------------------------------------------
+# Public API
+# ---------------------------------------------------------------------------
+
+
+def seed_operation_plan_from_plan_item(context_store, session_id: str) -> dict | None:
+    """Seed the Operation Plan for *session_id* from its linked plan item's outline.
+
+    Idempotency rules
+    -----------------
+    * **No existing plan** — seed fully; write to store; return plan.
+    * **Plan exists with ≥1 active or done tactic** — do NOT overwrite; return ``None``.
+    * **Plan exists with only planned tactics** — add any outline entries whose
+      *name* is not already present; if nothing new, return ``None``; otherwise
+      write the merged plan and return it.
+
+    Parameters
+    ----------
+    context_store:
+        A ``FileContextStore`` instance.
+    session_id:
+        The active session ID.
+
+    Returns
+    -------
+    dict | None
+        The seeded (or merged) plan dict if something was written, else ``None``.
+    """
+    item, campaign = _resolve_plan_item_with_tactics(context_store, session_id)
+    if item is None:
+        return None
+
+    outline: list[dict] = item.imaging_spec.tactics  # type: ignore[union-attr]
+    if not outline:
+        return None
+
+    # --- Idempotency: check existing plan ---
+    existing = context_store.get_operation_plan(session_id)
+    if existing:
+        existing_tactics: list[dict] = existing.get("tactics") or []
+        # Guard: at least one active/done tactic — do not clobber
+        has_live = any(t.get("state") in ("active", "done") for t in existing_tactics)
+        if has_live:
+            logger.debug(
+                "seed_operation_plan: session %s already has live tactics — skipping",
+                session_id,
+            )
+            return None
+
+        # Plan exists with only planned tactics — add missing outline entries by name
+        existing_names = {t.get("name") for t in existing_tactics}
+        new_tactics = list(existing_tactics)
+        added = False
+        for i, entry in enumerate(outline):
+            if entry.get("name") not in existing_names:
+                new_tactics.append(_outline_entry_to_tactic(entry, i))
+                added = True
+        if not added:
+            return None
+
+        plan = dict(existing)
+        plan["tactics"] = new_tactics
+        plan["updated_at"] = datetime.now(timezone.utc).isoformat()
+        plan["updated_reason"] = "seeded: added planned tactics from plan-item outline"
+        context_store.set_operation_plan(session_id, plan)
+        logger.info(
+            "seed_operation_plan: added %d planned tactic(s) to existing plan for session %s",
+            sum(1 for t in new_tactics if t not in existing_tactics),
+            session_id,
+        )
+        return plan
+
+    # --- No existing plan: seed from scratch ---
+    goal = ""
+    if campaign:
+        goal = campaign.target or campaign.description or ""
+
+    tactics = [_outline_entry_to_tactic(entry, i) for i, entry in enumerate(outline)]
+
+    plan = {
+        "session_id": session_id,
+        "title": item.title,
+        "goal": goal,
+        "plan_item_id": item.id,
+        "campaign_id": item.campaign_id,
+        "tactics": tactics,
+        "updated_at": datetime.now(timezone.utc).isoformat(),
+        "updated_reason": "seeded from plan-item tactical outline",
+    }
+    context_store.set_operation_plan(session_id, plan)
+    logger.info(
+        "seed_operation_plan: seeded %d planned tactic(s) for session %s from plan item %s",
+        len(tactics),
+        session_id,
+        item.id,
+    )
+    return plan
diff --git a/tests/test_operation_plan_seeding.py b/tests/test_operation_plan_seeding.py
new file mode 100644
index 00000000..abe36911
--- /dev/null
+++ b/tests/test_operation_plan_seeding.py
@@ -0,0 +1,410 @@
+"""
+TDD: seed_operation_plan_from_plan_item
+
+Resolution path under test:
+  session_id
+  → get_campaign_ids_for_session  (reads session_intents/{session_id}.yaml)
+  → get_plan_items(campaign_id=cid)
+  → find PlanItem where session_id ∈ plan_item.session_ids
+        AND plan_item.imaging_spec.tactics is non-empty
+  → get_campaign(plan_item.campaign_id)  for goal text
+  → build + write Operation Plan via set_operation_plan
+
+Scenarios
+---------
+1. Two outline tactics  → seeded plan with 2 ``planned`` tactics
+2. Plan-level fields (goal, plan_item_id, campaign_id) populated from item/campaign
+3. Idempotent — existing plan with active tactic: not clobbered, returns None
+4. Idempotent — existing plan with done tactic: not clobbered, returns None
+5. No campaign linkage → returns None, no write
+6. Plan item linked but imaging_spec.tactics is empty → returns None, no write
+"""
+
+import pytest
+
+from gently.app.tools.operation_plan_seed import seed_operation_plan_from_plan_item
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _make_campaign_and_item_with_tactics(
+    cs,
+    session_id: str,
+    *,
+    target: str = "50 hatching events",
+):
+    """Create a campaign + imaging plan item with 2 tactics, linked to *session_id*."""
+    cid = cs.create_campaign(
+        description="Capture hatching events in WT",
+        shorthand="hatching-wt",
+        target=target,
+    )
+    spec = {
+        "strain": "N2",
+        "num_embryos": 4,
+        "tactics": [
+            {"kind": "standing_timelapse", "name": "Baseline timelapse"},
+            {
+                "kind": "reactive_monitor",
+                "name": "Hatching monitor",
+                "target": "embryo_hatching",
+                "scope": {"mode": "global"},
+            },
+        ],
+    }
+    item_id = cs.create_plan_item(
+        campaign_id=cid,
+        type="imaging",
+        title="WT hatching pilot",
+        spec=spec,
+    )
+    cs.link_session_campaign(session_id, cid)
+    cs.link_plan_item_session(item_id, session_id)
+    return cid, item_id
+
+
+# ---------------------------------------------------------------------------
+# Basic seeding
+# ---------------------------------------------------------------------------
+
+
+class TestSeedBasic:
+    def test_returns_plan_dict(self, file_context_store):
+        """seed returns a non-None dict when a linked plan item with tactics exists."""
+        cs = file_context_store
+        sid = "seed_basic_01"
+        cs.create_session_intent(sid, planned_intent="hatching pilot")
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert plan is not None
+        assert isinstance(plan, dict)
+
+    def test_two_outline_entries_produce_two_tactics(self, file_context_store):
+        """An outline with 2 entries produces exactly 2 tactics."""
+        cs = file_context_store
+        sid = "seed_basic_02"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert len(plan["tactics"]) == 2
+
+    def test_all_seeded_tactics_are_planned(self, file_context_store):
+        """Every seeded tactic starts in state='planned'."""
+        cs = file_context_store
+        sid = "seed_basic_03"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert all(t["state"] == "planned" for t in plan["tactics"])
+
+    def test_tactic_kind_and_name_from_outline(self, file_context_store):
+        """Tactics carry the kind and name from the outline entries."""
+        cs = file_context_store
+        sid = "seed_basic_04"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        names = [t["name"] for t in plan["tactics"]]
+        kinds = [t["kind"] for t in plan["tactics"]]
+        assert "Baseline timelapse" in names
+        assert "Hatching monitor" in names
+        assert "standing_timelapse" in kinds
+        assert "reactive_monitor" in kinds
+
+    def test_tactic_ids_generated_and_distinct(self, file_context_store):
+        """Each tactic has a non-empty unique id."""
+        cs = file_context_store
+        sid = "seed_basic_05"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        ids = [t["id"] for t in plan["tactics"]]
+        assert all(ids)
+        assert len(set(ids)) == len(ids)
+
+    def test_plan_persisted_in_store(self, file_context_store):
+        """The seeded plan is retrievable via get_operation_plan."""
+        cs = file_context_store
+        sid = "seed_basic_06"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        seed_operation_plan_from_plan_item(cs, sid)
+
+        stored = cs.get_operation_plan(sid)
+        assert stored is not None
+        assert len(stored["tactics"]) == 2
+
+
+# ---------------------------------------------------------------------------
+# Plan-level metadata
+# ---------------------------------------------------------------------------
+
+
+class TestSeedMetadata:
+    def test_goal_from_campaign_target(self, file_context_store):
+        """goal field is taken from campaign.target."""
+        cs = file_context_store
+        sid = "seed_meta_01"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid, target="50 hatching events")
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert plan["goal"] == "50 hatching events"
+
+    def test_goal_falls_back_to_campaign_description(self, file_context_store):
+        """When campaign.target is None, goal falls back to campaign.description."""
+        cs = file_context_store
+        sid = "seed_meta_02"
+        cs.create_session_intent(sid)
+        cid = cs.create_campaign(description="Characterise WT hatching")
+        spec = {"tactics": [{"kind": "standing_timelapse", "name": "Timelapse"}]}
+        item_id = cs.create_plan_item(campaign_id=cid, type="imaging", title="Pilot", spec=spec)
+        cs.link_session_campaign(sid, cid)
+        cs.link_plan_item_session(item_id, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert plan["goal"] == "Characterise WT hatching"
+
+    def test_plan_item_id_set(self, file_context_store):
+        """plan_item_id on the plan matches the linked plan item's id."""
+        cs = file_context_store
+        sid = "seed_meta_03"
+        cs.create_session_intent(sid)
+        cid, item_id = _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert plan["plan_item_id"] == item_id
+
+    def test_campaign_id_set(self, file_context_store):
+        """campaign_id on the plan matches the campaign."""
+        cs = file_context_store
+        sid = "seed_meta_04"
+        cs.create_session_intent(sid)
+        cid, _ = _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert plan["campaign_id"] == cid
+
+    def test_title_from_plan_item(self, file_context_store):
+        """Plan title comes from the plan item's title."""
+        cs = file_context_store
+        sid = "seed_meta_05"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        plan = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert plan["title"] == "WT hatching pilot"
+
+
+# ---------------------------------------------------------------------------
+# Idempotency
+# ---------------------------------------------------------------------------
+
+
+class TestIdempotency:
+    def test_active_tactic_not_clobbered(self, file_context_store):
+        """If the plan has an active tactic, seed returns None and doesn't overwrite."""
+        cs = file_context_store
+        sid = "seed_idem_01"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        existing = {
+            "session_id": sid,
+            "title": "Agent-declared plan",
+            "goal": "live goal",
+            "tactics": [
+                {
+                    "id": "t_live",
+                    "name": "Live tactic",
+                    "kind": "standing_timelapse",
+                    "state": "active",
+                }
+            ],
+            "updated_at": "2026-06-28T10:00:00Z",
+            "updated_reason": "agent declared",
+        }
+        cs.set_operation_plan(sid, existing)
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert result is None
+        stored = cs.get_operation_plan(sid)
+        assert stored["title"] == "Agent-declared plan"
+        assert stored["goal"] == "live goal"
+
+    def test_done_tactic_not_clobbered(self, file_context_store):
+        """If the plan has a done tactic, seed returns None and doesn't overwrite."""
+        cs = file_context_store
+        sid = "seed_idem_02"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        existing = {
+            "session_id": sid,
+            "title": "Completed plan",
+            "goal": "done goal",
+            "tactics": [
+                {
+                    "id": "t_done",
+                    "name": "Done tactic",
+                    "kind": "oneshot",
+                    "state": "done",
+                }
+            ],
+            "updated_at": "2026-06-28T10:00:00Z",
+            "updated_reason": "agent declared",
+        }
+        cs.set_operation_plan(sid, existing)
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert result is None
+        stored = cs.get_operation_plan(sid)
+        assert stored["title"] == "Completed plan"
+
+    def test_all_planned_existing_plan_adds_missing_tactics(self, file_context_store):
+        """If existing plan has only planned tactics, new outline entries are added."""
+        cs = file_context_store
+        sid = "seed_idem_03"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        # Pre-seed with only the first tactic (by name)
+        existing = {
+            "session_id": sid,
+            "title": "Partial plan",
+            "goal": "partial goal",
+            "tactics": [
+                {
+                    "id": "t_existing",
+                    "name": "Baseline timelapse",
+                    "kind": "standing_timelapse",
+                    "state": "planned",
+                }
+            ],
+            "updated_at": "2026-06-28T09:00:00Z",
+            "updated_reason": "partial seed",
+        }
+        cs.set_operation_plan(sid, existing)
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        # The second outline entry ("Hatching monitor") should have been added
+        assert result is not None
+        assert len(result["tactics"]) == 2
+        names = [t["name"] for t in result["tactics"]]
+        assert "Hatching monitor" in names
+
+    def test_all_tactics_already_present_returns_none(self, file_context_store):
+        """If all outline tactics are already in the plan (by name), returns None."""
+        cs = file_context_store
+        sid = "seed_idem_04"
+        cs.create_session_intent(sid)
+        _make_campaign_and_item_with_tactics(cs, sid)
+
+        # Pre-seed with both outline names already present
+        existing = {
+            "session_id": sid,
+            "title": "Full plan",
+            "goal": "full goal",
+            "tactics": [
+                {"id": "t1", "name": "Baseline timelapse", "kind": "standing_timelapse", "state": "planned"},
+                {"id": "t2", "name": "Hatching monitor", "kind": "reactive_monitor", "state": "planned"},
+            ],
+            "updated_at": "2026-06-28T09:00:00Z",
+            "updated_reason": "already seeded",
+        }
+        cs.set_operation_plan(sid, existing)
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert result is None
+        # Plan unchanged
+        stored = cs.get_operation_plan(sid)
+        assert len(stored["tactics"]) == 2
+
+
+# ---------------------------------------------------------------------------
+# No linkage
+# ---------------------------------------------------------------------------
+
+
+class TestNoLinkage:
+    def test_no_campaign_linkage_returns_none(self, file_context_store):
+        """Session with no campaign linkage → None, nothing written."""
+        cs = file_context_store
+        sid = "seed_nolink_01"
+        cs.create_session_intent(sid, planned_intent="standalone")
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert result is None
+        assert cs.get_operation_plan(sid) is None
+
+    def test_no_session_intent_returns_none(self, file_context_store):
+        """Session with no session_intent YAML → None."""
+        cs = file_context_store
+
+        result = seed_operation_plan_from_plan_item(cs, "ghost_session")
+
+        assert result is None
+
+    def test_plan_item_without_tactics_returns_none(self, file_context_store):
+        """Plan item linked to session but imaging_spec.tactics is empty → None."""
+        cs = file_context_store
+        sid = "seed_notactics_01"
+        cs.create_session_intent(sid)
+
+        cid = cs.create_campaign(description="Campaign — no tactics in spec")
+        item_id = cs.create_plan_item(
+            campaign_id=cid,
+            type="imaging",
+            title="Item without tactics",
+            spec={"strain": "N2"},  # no "tactics" key → empty list on ImagingSpec
+        )
+        cs.link_session_campaign(sid, cid)
+        cs.link_plan_item_session(item_id, sid)
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert result is None
+        assert cs.get_operation_plan(sid) is None
+
+    def test_non_imaging_plan_item_returns_none(self, file_context_store):
+        """Non-imaging plan item (no imaging_spec) → None."""
+        cs = file_context_store
+        sid = "seed_bench_01"
+        cs.create_session_intent(sid)
+
+        cid = cs.create_campaign(description="Bench work campaign")
+        item_id = cs.create_plan_item(
+            campaign_id=cid,
+            type="bench",
+            title="Prep samples",
+        )
+        cs.link_session_campaign(sid, cid)
+        cs.link_plan_item_session(item_id, sid)
+
+        result = seed_operation_plan_from_plan_item(cs, sid)
+
+        assert result is None

From 5d16f34fe97e0293b919c566e21c0f559724d4ee Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 18:58:07 +0530
Subject: [PATCH 218/314] feat(operations): operation-spine renderer + plan
 scenario library (data-driven)

Replace the swimlane Overview with a typed Operation Plan spine renderer.
The agent declares tactics (kind/state/structure/live_bind); the renderer
draws done/active/planned nodes with per-kind structure (scripted_protocol
phase stepper, standing_timelapse per-embryo cadence strip, reactive_monitor
armed/watching/fired badge, exclusive_burst/oneshot compact).

Audit fixes baked in: colored left edge per state, active card flattened
(no card-in-card, values on panel face + hairline rule), active phase is
the headline (larger/bold amber), queued = "next" badge + cocked blue dot,
copy "queued" not "going to be used", mono instrument values.

Adds window.OPERATIONS_SCENARIOS (7 plan fixtures: temp_strain,
expression_onset, hatching_detect, transmission_survey, decided_plan,
async_multi, idle). Scenario dev mode: ?scenario=<name> renders a fixture
with no fetch. Loads scenarios.js before experiment-overview.js in index.html.
Rules view and monitoring-mode logic untouched.
---
 gently/ui/web/static/css/experiment.css       | 440 ++++++++++++++++++
 .../ui/web/static/js/experiment-overview.js   | 258 +++++++++-
 .../ui/web/static/js/operations-scenarios.js  | 371 +++++++++++++++
 gently/ui/web/templates/index.html            |   1 +
 4 files changed, 1059 insertions(+), 11 deletions(-)
 create mode 100644 gently/ui/web/static/js/operations-scenarios.js

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 9b343378..16f6ba73 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -634,3 +634,443 @@
     transform: rotate(45deg);
     flex-shrink: 0;
 }
+
+/* ============================================================
+   Operation Spine — data-driven tactic plan renderer
+   All classes namespaced ops- to avoid collision.
+   ============================================================ */
+
+:root {
+    --ops-done:   #34d399;
+    --ops-active: #f5a623;
+    --ops-plan:   #5aa9e6;
+    --ops-live:   #22d3ee;
+    --ops-mono:   ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+
+.ops-wrap {
+    max-width: 760px;
+    margin: 0 auto;
+    padding: 8px 4px 48px;
+}
+
+.ops-crumb {
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    letter-spacing: 0.16em;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    margin-bottom: 6px;
+}
+
+.ops-title {
+    font-size: 22px;
+    font-weight: 600;
+    margin: 0 0 4px;
+    letter-spacing: -0.01em;
+    color: var(--text);
+}
+
+.ops-meta {
+    font-family: var(--ops-mono);
+    font-size: 12px;
+    color: var(--text-muted);
+    margin-bottom: 4px;
+}
+
+.ops-legend {
+    display: flex;
+    gap: 16px;
+    font-family: var(--ops-mono);
+    font-size: 10.5px;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    margin: 14px 0 20px;
+}
+
+.ops-legend i {
+    display: inline-block;
+    width: 8px;
+    height: 8px;
+    border-radius: 2px;
+    margin-right: 6px;
+    vertical-align: 1px;
+}
+
+.ops-empty {
+    font-family: var(--ops-mono);
+    color: var(--text-muted);
+    font-size: 13px;
+    border: 1px dashed var(--border);
+    border-radius: 12px;
+    padding: 30px;
+    text-align: center;
+    margin-top: 18px;
+}
+
+/* ---- Spine ------------------------------------------------- */
+
+.ops-spine {
+    position: relative;
+    margin-left: 14px;
+    padding-left: 30px;
+    border-left: 2px solid var(--border);
+}
+
+/* Tactic node */
+.ops-node {
+    position: relative;
+    margin-bottom: 14px;
+}
+
+/* Timeline dot — overlaps the spine border-left */
+.ops-node::before {
+    content: "";
+    position: absolute;
+    left: -39px;
+    top: 4px;
+    width: 14px;
+    height: 14px;
+    border-radius: 50%;
+    background: var(--bg-card, #161b22);
+    border: 2px solid var(--border);
+}
+
+.ops-node.done::before {
+    border-color: var(--ops-done);
+    background: var(--ops-done);
+}
+
+.ops-node.active::before {
+    border-color: var(--ops-active);
+    background: var(--ops-active);
+    box-shadow: 0 0 0 5px rgba(245, 166, 35, 0.14);
+}
+
+/* AUDIT: queued = cocked instrument — dashed blue dot (not empty) */
+.ops-node.planned::before {
+    border-color: var(--ops-plan);
+    border-style: dashed;
+    background: var(--bg-card, #161b22);
+}
+
+/* ---- Stage label: "01 · in use" ----------------------------- */
+
+.ops-stagelab {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    letter-spacing: 0.14em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+    margin-bottom: 4px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+}
+
+/* AUDIT: active row's WHOLE LEFT COLUMN amber (dot + seq + "IN USE") */
+.ops-node.active .ops-stagelab { color: var(--ops-active); }
+.ops-node.planned .ops-stagelab { color: var(--ops-plan); }
+
+/* AUDIT: "next" badge on first queued tactic — cocked-instrument marker */
+.ops-next-badge {
+    display: inline-block;
+    padding: 1px 7px;
+    border-radius: 9px;
+    background: rgba(90, 169, 230, 0.15);
+    border: 1px solid rgba(90, 169, 230, 0.45);
+    color: var(--ops-plan);
+    font-size: 9px;
+    font-weight: 700;
+    letter-spacing: 0.1em;
+    text-transform: uppercase;
+}
+
+/* ---- Card --------------------------------------------------- */
+
+.ops-card {
+    background: var(--bg-card, #161b22);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 12px;
+    padding: 13px 16px;
+}
+
+/* AUDIT: colored LEFT EDGE per state */
+/* done — green left edge, transparent bg */
+.ops-node.done .ops-card {
+    background: transparent;
+    border-color: rgba(48, 54, 61, 0.5);
+    padding: 9px 16px;
+    border-left: 3px solid var(--ops-done);
+}
+
+/* active — amber left edge + tinted gradient + FLATTENED (no card-in-card) */
+.ops-node.active .ops-card {
+    border-color: rgba(245, 166, 35, 0.3);
+    border-left: 3px solid var(--ops-active);
+    background: linear-gradient(180deg, rgba(245, 166, 35, 0.05), transparent),
+                var(--bg-card, #161b22);
+}
+
+/* planned — blue left edge, dashed border */
+.ops-node.planned .ops-card {
+    background: transparent;
+    border-style: dashed;
+    border-left: 3px solid var(--ops-plan);
+    border-left-style: solid;
+    opacity: 0.85;
+}
+
+/* Hairline rule between card header and live readouts (flattened layout) */
+.ops-rule {
+    border: none;
+    border-top: 1px solid rgba(245, 166, 35, 0.18);
+    margin: 10px 0;
+}
+
+/* ---- Card contents ----------------------------------------- */
+
+.ops-row {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    flex-wrap: wrap;
+}
+
+.ops-tname {
+    font-size: 14.5px;
+    font-weight: 600;
+    color: var(--text);
+}
+
+.ops-node.done .ops-tname {
+    font-weight: 500;
+    color: var(--text-muted);
+}
+
+.ops-target {
+    font-family: var(--ops-mono);
+    font-size: 12.5px;
+    color: var(--ops-active);
+    font-weight: 600;
+}
+
+.ops-tsum {
+    font-family: var(--ops-mono);
+    font-size: 11.5px;
+    color: var(--text-muted);
+    margin-left: auto;
+}
+
+.ops-desc {
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    color: var(--text-muted);
+    opacity: 0.75;
+    margin: 4px 0 0;
+    line-height: 1.4;
+}
+
+/* ---- Gauge strip — AUDIT: flat on panel face, no card-in-card */
+
+.ops-live-strip {
+    display: flex;
+    gap: 10px;
+    flex-wrap: wrap;
+}
+
+.ops-gauge {
+    flex: 1;
+    min-width: 140px;
+    background: var(--bg-hover, #21262d);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 9px;
+    padding: 9px 11px;
+}
+
+.ops-gl {
+    font-family: var(--ops-mono);
+    font-size: 9.5px;
+    letter-spacing: 0.1em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+}
+
+/* AUDIT: mono instrument values */
+.ops-gv {
+    font-family: var(--ops-mono);
+    font-size: 18px;
+    font-weight: 650;
+    font-variant-numeric: tabular-nums;
+    color: var(--text);
+    margin-top: 2px;
+}
+
+.ops-set { color: var(--ops-active); font-size: 13px; }
+.ops-u   { color: var(--text-muted); font-size: 12px; }
+
+.ops-gsub {
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    color: var(--text-muted);
+    margin-top: 6px;
+}
+
+.ops-tempbar {
+    height: 5px;
+    border-radius: 3px;
+    background: var(--bg-hover, #21262d);
+    margin-top: 8px;
+    overflow: hidden;
+}
+
+.ops-tempbar > i {
+    display: block;
+    height: 100%;
+    background: linear-gradient(90deg, var(--ops-live), var(--ops-active));
+}
+
+/* ---- Scripted protocol — phase stepper --------------------- */
+
+.ops-phases {
+    display: flex;
+    gap: 7px;
+    flex-wrap: wrap;
+    margin-top: 8px;
+}
+
+.ops-ph {
+    flex: 1;
+    min-width: 110px;
+    border: 1px solid var(--border, #30363d);
+    border-radius: 8px;
+    padding: 9px 10px;
+    background: var(--bg-hover, #21262d);
+}
+
+.ops-ph.done   { border-color: rgba(52, 211, 153, 0.35); background: rgba(52, 211, 153, 0.05); }
+.ops-ph.active { border-color: rgba(245, 166, 35, 0.45); background: rgba(245, 166, 35, 0.08); }
+.ops-ph.todo   { opacity: 0.6; }
+
+.ops-pht {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    display: flex;
+    gap: 6px;
+    align-items: center;
+    color: var(--text-muted);
+}
+
+/* AUDIT: ACTIVE phase is the HEADLINE — largest in its phase */
+.ops-ph.active .ops-pht {
+    font-size: 12px;
+    font-weight: 700;
+    color: var(--ops-active);
+}
+
+.ops-pi {
+    width: 15px;
+    height: 15px;
+    border-radius: 50%;
+    display: grid;
+    place-items: center;
+    font-size: 9px;
+    font-weight: 700;
+    flex-shrink: 0;
+}
+
+.ops-ph.done   .ops-pi { background: var(--ops-done);   color: #062b1d; }
+.ops-ph.active .ops-pi { background: var(--ops-active); color: #3a2607; }
+.ops-ph.todo   .ops-pi { background: var(--bg-hover, #21262d); color: var(--text-muted); border: 1px solid var(--border); }
+
+.ops-phc {
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    color: var(--text-muted);
+    margin-top: 4px;
+}
+
+/* AUDIT: active phase count also headline-sized */
+.ops-ph.active .ops-phc { font-size: 13px; font-weight: 600; color: var(--ops-active); }
+
+.ops-pips { display: flex; gap: 3px; margin-top: 7px; flex-wrap: wrap; }
+
+.ops-pip { width: 12px; height: 7px; border-radius: 2px; background: var(--bg-hover, #21262d); }
+.ops-pip.before  { background: var(--ops-plan); }
+.ops-pip.during  { background: var(--ops-active); }
+.ops-pip.after   { background: var(--ops-done); }
+.ops-pip.pending { border: 1px dashed var(--border); background: transparent; }
+
+/* ---- Per-embryo cadence strip — standing_timelapse --------- */
+
+.ops-cadence-strip {
+    display: flex;
+    flex-direction: column;
+    gap: 5px;
+    padding: 8px 10px;
+    background: var(--bg-hover, #21262d);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 8px;
+}
+
+.ops-cadence-embryo {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    font-family: var(--ops-mono);
+    font-size: 11.5px;
+}
+
+.ops-cadence-id {
+    color: var(--text);
+    font-weight: 600;
+    min-width: 32px;
+}
+
+.ops-cadence-phase {
+    padding: 2px 8px;
+    border-radius: 9px;
+    font-size: 10px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+}
+
+.ops-cadence-phase.normal { background: rgba(139, 148, 158, 0.2); color: var(--text-muted); }
+.ops-cadence-phase.fast   { background: rgba(251, 146, 60,  0.2); color: var(--accent-orange, #fb923c); }
+.ops-cadence-phase.burst  { background: rgba(239, 68,  68,  0.2); color: #f87171; }
+.ops-cadence-phase.paused { background: rgba(90, 169, 230,  0.15); color: var(--ops-plan); }
+
+.ops-cadence-val { color: var(--text-muted); margin-left: auto; }
+
+/* ---- Reactive monitor — armed/watching/fired badge --------- */
+
+.ops-monitor-status {
+    display: inline-block;
+    margin-top: 8px;
+    padding: 3px 10px;
+    border-radius: 9px;
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+}
+
+.ops-monitor-armed    { background: rgba(90, 169, 230, 0.15);  color: var(--ops-plan);   border: 1px solid rgba(90, 169, 230, 0.35); }
+.ops-monitor-watching { background: rgba(245, 166, 35, 0.12); color: var(--ops-active); border: 1px solid rgba(245, 166, 35, 0.3); }
+.ops-monitor-fired    { background: rgba(52, 211, 153, 0.12);  color: var(--ops-done);   border: 1px solid rgba(52, 211, 153, 0.3); }
+
+/* Planned kind-detail snippets (cadence note, watch hint) */
+.ops-cadence-note,
+.ops-monitor-watch {
+    display: inline-block;
+    margin-top: 6px;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    color: var(--text-muted);
+    opacity: 0.75;
+}
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index 9e7fc221..c46eba9c 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -12,13 +12,38 @@ const ExperimentOverview = {
     initialized: false,
     expandedMode: null,
     activeView: 'overview',  // 'overview' | 'rules'
-    activeStrategy: null,    // last fetched/loaded snapshot
-    isLive: false,           // true when activeStrategy came from the API
+    activeStrategy: null,    // last fetched strategy snapshot (rules view)
+    activePlan: null,        // last fetched/loaded operation plan (overview spine)
+    isLive: false,           // true when data came from the API
+    scenarioMode: false,     // true when ?scenario=<name> is active
 
     async init() {
         console.log('[ExperimentOverview] init() called, view=', this.activeView);
-        const strategy = await this.loadStrategy();
+
+        // Scenario dev mode: ?scenario=<name> renders a fixture with no fetch.
+        // Guard against double-registration when the tab is clicked repeatedly.
+        const scenarioParam = new URLSearchParams(location.search).get('scenario');
+        if (scenarioParam && window.OPERATIONS_SCENARIOS &&
+            Object.prototype.hasOwnProperty.call(window.OPERATIONS_SCENARIOS, scenarioParam)) {
+            this.scenarioMode = true;
+            this.activePlan = window.OPERATIONS_SCENARIOS[scenarioParam];
+            this.activeStrategy = null;
+            this.isLive = false;
+            this.render(null);
+            this.initialized = true;
+            return;
+        }
+
+        this.scenarioMode = false;
+        // Fetch plan (overview) and strategy (rules) in parallel so tab-switching
+        // between the two views doesn't require a second round-trip.
+        const [plan, strategy] = await Promise.all([
+            this.loadPlan(),
+            this.loadStrategy()
+        ]);
+        this.activePlan = plan;
         this.activeStrategy = strategy;
+        this.isLive = plan !== null || strategy !== null;
         this.render(strategy);
         this.initialized = true;
     },
@@ -32,15 +57,30 @@ const ExperimentOverview = {
                 // No active experiment / not ready yet — show the empty state,
                 // never stubbed data.
                 console.warn('[ExperimentOverview] strategy fetch returned', resp.status);
-                this.isLive = false;
                 return null;
             }
             const data = await resp.json();
-            this.isLive = true;
             return data;
         } catch (e) {
             console.warn('[ExperimentOverview] strategy fetch error:', e);
-            this.isLive = false;
+            return null;
+        }
+    },
+
+    // Fetch the agent-authored Operation Plan for the current session.
+    // Returns the plan object (plan.tactics etc.) or null when unavailable.
+    async loadPlan() {
+        try {
+            const resp = await fetch('/api/operation_plan/current', { cache: 'no-store' });
+            if (!resp.ok) {
+                console.warn('[ExperimentOverview] plan fetch returned', resp.status);
+                return null;
+            }
+            const data = await resp.json();
+            if (!data.available) return null;
+            return data.plan || null;
+        } catch (e) {
+            console.warn('[ExperimentOverview] plan fetch error:', e);
             return null;
         }
     },
@@ -65,10 +105,12 @@ const ExperimentOverview = {
         }
         // Tear down any prior ticker before we blow away the SVG it pointed at.
         this._stopNowTicker();
-        if (!s) {
-            // No active experiment — a calm empty state, never stubbed data.
+        // Rules view requires the strategy snapshot; show an empty state when absent.
+        // Overview view uses this.activePlan — the null/empty case is handled inside
+        // _renderOperationSpine (it renders the idle state).
+        if (this.activeView === 'rules' && !s) {
             root.innerHTML = '<div style="padding:32px;text-align:center;color:var(--text-muted,#94a3b8);font-size:13px;">' +
-                'No active experiment — the imaging tactics (cadence, reactive rules) will appear here once a run is live.</div>';
+                'No active experiment — rules and monitoring modes will appear here once a run is live.</div>';
             return;
         }
         try {
@@ -76,8 +118,9 @@ const ExperimentOverview = {
             if (this.activeView === 'rules') {
                 this._renderRulesView(root, s);
             } else {
-                this._renderOverviewView(root, s);
-                this._startNowTicker();
+                // Operation spine — data-driven tactic plan renderer.
+                // The swimlane view is retired; this renders this.activePlan.
+                this._renderOperationSpine(root, this.activePlan);
             }
             console.log('[ExperimentOverview] rendered OK, view=', this.activeView);
         } catch (err) {
@@ -1085,6 +1128,199 @@ const ExperimentOverview = {
         return g;
     },
 
+    // =================================================================
+    // Operation Spine — data-driven plan renderer (replaces swimlanes)
+    // =================================================================
+
+    // Minimal HTML escaper — values in readouts may contain trusted HTML
+    // (e.g. <span class="ops-set">32.0°C</span>) so they are rendered with
+    // innerHTML; all other user/model strings go through _opsESC.
+    _opsESC(s) {
+        return String(s == null ? '' : s)
+            .replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+    },
+
+    // Entry point: render the operation spine into `root`.
+    // plan = the plan object (tactics array) or null for idle/unavailable.
+    _renderOperationSpine(root, plan) {
+        const ESC = this._opsESC.bind(this);
+
+        if (!plan || !Array.isArray(plan.tactics) || plan.tactics.length === 0) {
+            root.innerHTML = `
+                <div class="ops-wrap">
+                    <div class="ops-crumb">Operations</div>
+                    <h1 class="ops-title">No operation running</h1>
+                    <div class="ops-meta">When the agent begins operating by tactic, the plan and live progress appear here.</div>
+                    <div class="ops-empty">Idle — no tactics planned or in use.</div>
+                </div>`;
+            return;
+        }
+
+        const tactics = plan.tactics;
+        const hasActive = tactics.some(t => t.state === 'active');
+        // Index of the first queued (planned) tactic — gets the "next" badge.
+        const firstPlannedIdx = tactics.findIndex(t => t.state === 'planned');
+
+        const spineNodes = tactics
+            .map((t, idx) => this._renderOpsTactic(t, idx, firstPlannedIdx, ESC))
+            .join('');
+
+        root.innerHTML = `
+            <div class="ops-wrap">
+                <div class="ops-crumb">Operations · ${hasActive ? 'live' : 'idle'}</div>
+                <h1 class="ops-title">${ESC(plan.title || '')}</h1>
+                <div class="ops-meta">${ESC(plan.session_id || '')}${plan.goal ? ' · ' + ESC(plan.goal) : ''}</div>
+                <div class="ops-legend">
+                    <span><i style="background:var(--ops-done)"></i>done</span>
+                    <span><i style="background:var(--ops-active)"></i>in use</span>
+                    <span><i style="background:var(--ops-plan)"></i>queued</span>
+                </div>
+                <div class="ops-spine">${spineNodes}</div>
+            </div>`;
+    },
+
+    // Render a single tactic node.
+    _renderOpsTactic(t, idx, firstPlannedIdx, ESC) {
+        const STATE_LABEL = { done: 'done', active: 'in use', planned: 'queued' };
+        const seq = String(t.seq || idx + 1).padStart(2, '0');
+        const stateLabel = STATE_LABEL[t.state] || t.state;
+        // First queued tactic gets a "next" badge — COCKED instrument marker.
+        const isFirstQueued = t.state === 'planned' && idx === firstPlannedIdx;
+        const nextBadge = isFirstQueued
+            ? '<span class="ops-next-badge">next</span>'
+            : '';
+
+        const live = t.live || {};
+        const target = live.target || '';
+        const summary = live.summary || '';
+        const desc = live.desc || '';
+
+        // Header row: name · target · summary
+        let inner = `
+            <div class="ops-row">
+                <span class="ops-tname">${ESC(t.name)}</span>
+                ${target ? `<span class="ops-target">${ESC(target)}</span>` : ''}
+                ${summary ? `<span class="ops-tsum">${ESC(summary)}</span>` : ''}
+            </div>
+            ${desc ? `<div class="ops-desc">${ESC(desc)}</div>` : ''}`;
+
+        // AUDIT: FLATTEN the active card — readouts on the panel face, separated by
+        // a hairline rule. No nested card-in-card boxes.
+        if (t.state === 'active' && live.readouts && live.readouts.length) {
+            inner += `<hr class="ops-rule">
+                <div class="ops-live-strip">
+                    ${live.readouts.map(r => this._renderOpsReadout(r, ESC)).join('')}
+                </div>`;
+        }
+
+        // Kind-specific structure for the active state.
+        if (t.state === 'active') {
+            inner += this._renderOpsKindActive(t, live, ESC);
+        } else if (t.state === 'planned') {
+            inner += this._renderOpsKindPlanned(t, ESC);
+        }
+
+        return `
+            <div class="ops-node ${ESC(t.state)}">
+                <div class="ops-stagelab">${seq} · ${stateLabel}${nextBadge ? ' ' + nextBadge : ''}</div>
+                <div class="ops-card">${inner}</div>
+            </div>`;
+    },
+
+    // Render a readout gauge. `r.value` may contain trusted HTML (span markup).
+    _renderOpsReadout(r, ESC) {
+        return `<div class="ops-gauge">
+            <div class="ops-gl">${ESC(r.label)}</div>
+            <div class="ops-gv">${r.value}</div>
+            ${r.bar != null
+                ? `<div class="ops-tempbar"><i style="width:${Math.max(0, Math.min(100, r.bar))}%"></i></div>`
+                : ''}
+            ${r.sub ? `<div class="ops-gsub">${ESC(r.sub)}</div>` : ''}
+        </div>`;
+    },
+
+    // Render one phase in the scripted_protocol stepper.
+    // AUDIT: the active phase is the HEADLINE — CSS makes it larger.
+    _renderOpsPhase(p, ESC) {
+        const pips = (p.pips || [])
+            .map(k => `<span class="ops-pip ${ESC(k)}"></span>`)
+            .join('');
+        const ic = p.state === 'done' ? '✓'
+                 : p.state === 'active' ? '▶'
+                 : (p.icon || '·');
+        return `<div class="ops-ph ${ESC(p.state)}">
+            <div class="ops-pht"><span class="ops-pi">${ic}</span>${ESC(p.name)}</div>
+            <div class="ops-phc">${ESC(p.count || '')}</div>
+            ${pips ? `<div class="ops-pips">${pips}</div>` : ''}
+        </div>`;
+    },
+
+    // Kind-specific structure for ACTIVE tactics.
+    _renderOpsKindActive(t, live, ESC) {
+        if (!t.kind) return '';
+
+        // scripted_protocol → before/during/after phase stepper.
+        // Prefer live.phases (may carry pip/count state); fall back to structure.phases.
+        if (t.kind === 'scripted_protocol') {
+            const phases = live.phases || (t.structure && t.structure.phases) || [];
+            if (!phases.length) return '';
+            return `<div class="ops-phases">
+                ${phases.map(p => this._renderOpsPhase(p, ESC)).join('')}
+            </div>`;
+        }
+
+        // standing_timelapse → compact per-embryo cadence strip.
+        if (t.kind === 'standing_timelapse') {
+            const perEmbryo = t.structure && t.structure.per_embryo;
+            if (!perEmbryo || !perEmbryo.length) return '';
+            const rows = perEmbryo.map(e => {
+                const intervalStr = e.interval_s != null ? `${ESC(e.interval_s)}s` : '—';
+                return `<div class="ops-cadence-embryo">
+                    <span class="ops-cadence-id">${ESC(e.embryo_id)}</span>
+                    <span class="ops-cadence-phase ${ESC(e.cadence_phase)}">${ESC(e.cadence_phase)}</span>
+                    <span class="ops-cadence-val">${intervalStr}</span>
+                </div>`;
+            }).join('');
+            return `<hr class="ops-rule"><div class="ops-cadence-strip">${rows}</div>`;
+        }
+
+        // reactive_monitor → armed/watching/fired status badge.
+        if (t.kind === 'reactive_monitor') {
+            const st = (t.structure && t.structure.status) || 'armed';
+            return `<div class="ops-monitor-status ops-monitor-${ESC(st)}">${ESC(st)}</div>`;
+        }
+
+        // exclusive_burst / oneshot / custom — readouts only (already rendered above).
+        return '';
+    },
+
+    // Kind-specific structure for PLANNED (queued) tactics — compact hints.
+    _renderOpsKindPlanned(t, ESC) {
+        if (!t.kind) return '';
+
+        if (t.kind === 'scripted_protocol') {
+            const phases = (t.structure && t.structure.phases) || [];
+            if (!phases.length) return '';
+            return `<div class="ops-phases">
+                ${phases.map(p => this._renderOpsPhase(p, ESC)).join('')}
+            </div>`;
+        }
+
+        if (t.kind === 'standing_timelapse' && t.structure && t.structure.cadence_s) {
+            return `<div class="ops-cadence-note">cadence · ${ESC(t.structure.cadence_s)}s</div>`;
+        }
+
+        if (t.kind === 'reactive_monitor' && t.structure && t.structure.watch) {
+            return `<div class="ops-monitor-watch">watch · ${ESC(t.structure.watch)}</div>`;
+        }
+
+        if ((t.kind === 'oneshot' || t.kind === 'custom') && t.structure && t.structure.note) {
+            return `<div class="ops-cadence-note">${ESC(t.structure.note)}</div>`;
+        }
+
+        return '';
+    },
+
     // -----------------------------------------------------------------
     // Rules table — full subtab view, grouped by rule kind
     // -----------------------------------------------------------------
diff --git a/gently/ui/web/static/js/operations-scenarios.js b/gently/ui/web/static/js/operations-scenarios.js
new file mode 100644
index 00000000..9a4f74e7
--- /dev/null
+++ b/gently/ui/web/static/js/operations-scenarios.js
@@ -0,0 +1,371 @@
+/**
+ * Operation Plan scenario fixtures — development and Chrome-MCP audit targets.
+ *
+ * Each entry is a plan object matching the real API schema returned by
+ *   GET /api/operation_plan/{session_id} → { available, plan }
+ * The `.plan` is what gets passed to the renderer. Active tactics carry a
+ * `live` field (readouts + phases) that the API route merges from live
+ * telemetry; here they are baked into the fixture.
+ *
+ * Scenario dev mode: load via ?scenario=<name> — ExperimentOverview reads
+ * window.OPERATIONS_SCENARIOS[name] and skips all fetches.
+ *
+ * Scenarios:
+ *   temp_strain        — scripted_protocol active (temp-change burst protocol)
+ *   expression_onset   — reactive_monitor active (reporter rising)
+ *   hatching_detect    — reactive_monitor active (watch=hatching, status=watching)
+ *   transmission_survey — exclusive_burst active (brightfield only)
+ *   decided_plan       — all planned, nothing run yet
+ *   async_multi        — standing_timelapse per-embryo cadence + layered reactive_monitor
+ *   idle               — null (no operation running)
+ */
+window.OPERATIONS_SCENARIOS = {
+
+  /* ------------------------------------------------------------------ */
+  temp_strain: {
+    session_id: '20260628_1432_tempstrain_a',
+    title: 'Temperature-strain run · E01',
+    goal: 'Acquire volumes before, during, and after a +4 °C step to 32 °C; capture reporter response to heat stress.',
+    tactics: [
+      {
+        id: 'ts-1', seq: 1,
+        name: 'Monitor — low cadence',
+        kind: 'standing_timelapse', state: 'done',
+        scope: { mode: 'global' },
+        rationale: 'Baseline acquisition before thermal perturbation.',
+        structure: { cadence_s: 180 },
+        live_bind: ['cadence'],
+        live: { summary: '22 min · ended on signal' },
+        relations: {}
+      },
+      {
+        id: 'ts-2', seq: 2,
+        name: 'Transmission burst — baseline',
+        kind: 'exclusive_burst', state: 'done',
+        scope: { mode: 'global' },
+        rationale: 'Brightfield snapshot before setpoint change.',
+        structure: { frames: 3, mode: 'brightfield' },
+        live_bind: [],
+        live: { summary: '3 bursts · brightfield' },
+        relations: {}
+      },
+      {
+        id: 'ts-3', seq: 3,
+        name: 'Temp-change burst protocol',
+        kind: 'scripted_protocol', state: 'active',
+        scope: { mode: 'global' },
+        rationale: 'Systematic volume capture before, during ramp, and after thermal lock. Laser off during ramp to limit phototoxicity.',
+        structure: {
+          phases: [
+            { name: 'before', state: 'done',   count: '1/1 done' },
+            { name: 'during', state: 'active',  count: '2 · awaiting lock' },
+            { name: 'after',  state: 'todo',    count: '0/1' }
+          ]
+        },
+        live_bind: ['temperature', 'current_burst'],
+        live: {
+          target: '→ 32.0 °C',
+          summary: 'started 3m ago',
+          desc: 'bursts before · setpoint change · bursts through ramp · bursts after lock — laser off',
+          readouts: [
+            {
+              label: 'stage temp',
+              value: '29.4<span class="ops-u">→</span><span class="ops-set">32.0°C</span>',
+              bar: 62
+            },
+            {
+              label: 'current burst',
+              value: '#3 <span class="ops-u">during</span>',
+              sub: '60f · 1Hz · brightfield'
+            }
+          ],
+          phases: [
+            { name: 'before', state: 'done',   count: '1/1 done',          pips: ['before'] },
+            { name: 'during', state: 'active',  count: '2 · awaiting lock', pips: ['during', 'during', 'pending'] },
+            { name: 'after',  state: 'todo',    count: '0/1',               pips: ['pending'] }
+          ]
+        },
+        relations: {}
+      },
+      {
+        id: 'ts-4', seq: 4,
+        name: 'Recovery monitor — low cadence',
+        kind: 'standing_timelapse', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Resume gentle monitoring once temperature settles.',
+        structure: { cadence_s: 180 },
+        live_bind: ['cadence'],
+        live: {
+          summary: 'queued · 30 min after lock',
+          desc: 'resume gentle monitoring once temperature settles'
+        },
+        relations: { after: ['ts-3'] }
+      }
+    ]
+  },
+
+  /* ------------------------------------------------------------------ */
+  expression_onset: {
+    session_id: '20260628_0915_onset_b',
+    title: 'Reporter-onset watch · E04',
+    goal: 'Detect first appearance of the fluorescent reporter; capture onset dynamics at high temporal resolution.',
+    tactics: [
+      {
+        id: 'eo-1', seq: 1,
+        name: 'Monitor — low cadence',
+        kind: 'standing_timelapse', state: 'done',
+        scope: { mode: 'global' },
+        rationale: 'Baseline acquisition before signal appears.',
+        structure: { cadence_s: 180 },
+        live_bind: ['cadence'],
+        live: { summary: '1h 40m · baseline' },
+        relations: {}
+      },
+      {
+        id: 'eo-2', seq: 2,
+        name: 'Expression monitoring',
+        kind: 'reactive_monitor', state: 'active',
+        scope: { mode: 'global' },
+        rationale: 'Accelerate cadence on signal, ramp 488 down on saturation, burst on stable structure.',
+        structure: { watch: 'reporter onset', reaction: 'accelerate + ramp laser', status: 'watching' },
+        live_bind: ['signal', 'cadence'],
+        live: {
+          target: 'reporter onset',
+          summary: 'signal rising',
+          desc: 'accelerate cadence on signal · ramp 488 down on saturation · burst on stable structure',
+          readouts: [
+            {
+              label: 'reporter signal',
+              value: '<span class="ops-set">rising</span>',
+              sub: '+14% over 6 min',
+              bar: 48
+            },
+            {
+              label: 'cadence',
+              value: '120s <span class="ops-u">→</span> 30s',
+              sub: 'accelerated on onset'
+            },
+            {
+              label: '488 power',
+              value: '5% <span class="ops-u">→</span> 3%',
+              sub: 'ramped to limit saturation'
+            }
+          ]
+        },
+        relations: {}
+      },
+      {
+        id: 'eo-3', seq: 3,
+        name: 'Burst on good structure',
+        kind: 'exclusive_burst', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Capture a burst once the reporter pattern holds.',
+        structure: { frames: 60, mode: 'fluorescence' },
+        live_bind: [],
+        live: {
+          summary: 'queued · when structure stable',
+          desc: 'capture a burst once the reporter pattern holds'
+        },
+        relations: { after: ['eo-2'] }
+      }
+    ]
+  },
+
+  /* ------------------------------------------------------------------ */
+  hatching_detect: {
+    session_id: '20260627_2210_hatch_c',
+    title: 'Pre-hatching vigil · E11',
+    goal: 'Detect and capture the hatching event; accelerate acquisition as hatching approaches.',
+    tactics: [
+      {
+        id: 'hd-1', seq: 1,
+        name: 'Pre-terminal monitoring',
+        kind: 'reactive_monitor', state: 'active',
+        scope: { mode: 'global' },
+        rationale: 'Low cadence now; speed up as hatching approaches.',
+        structure: { watch: 'hatching', reaction: 'accelerate near event', status: 'watching' },
+        live_bind: ['cadence'],
+        live: {
+          target: 'hatching',
+          summary: 'watching',
+          desc: 'low cadence now · speed up as hatching approaches',
+          readouts: [
+            { label: 'est. time to hatch', value: '~38 min', sub: 'from motion + morphology' },
+            { label: 'cadence',            value: '180s',    sub: 'will speed up near event' }
+          ]
+        },
+        relations: {}
+      },
+      {
+        id: 'hd-2', seq: 2,
+        name: 'Hatching speedup',
+        kind: 'standing_timelapse', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'High cadence through hatching.',
+        structure: { cadence_s: 30 },
+        live_bind: ['cadence'],
+        live: {
+          summary: 'queued · ~T-10 min',
+          desc: 'high cadence through hatching'
+        },
+        relations: { after: ['hd-1'] }
+      },
+      {
+        id: 'hd-3', seq: 3,
+        name: 'Post-hatch monitor',
+        kind: 'standing_timelapse', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Resume normal cadence after the event.',
+        structure: { cadence_s: 120 },
+        live_bind: ['cadence'],
+        live: { summary: 'queued · after event' },
+        relations: { after: ['hd-2'] }
+      }
+    ]
+  },
+
+  /* ------------------------------------------------------------------ */
+  transmission_survey: {
+    session_id: '20260628_1100_survey_a',
+    title: 'Transmission survey · plate A',
+    goal: 'Survey all embryos with brightfield only; no laser excitation.',
+    tactics: [
+      {
+        id: 'srv-1', seq: 1,
+        name: 'Transmission burst',
+        kind: 'exclusive_burst', state: 'active',
+        scope: { mode: 'global' },
+        rationale: 'LED/brightfield bursts, no laser — DIC-like contrast.',
+        structure: { frames: 30, mode: 'brightfield', phase: 'capturing' },
+        live_bind: ['current_burst'],
+        live: {
+          summary: 'capturing',
+          desc: 'LED/brightfield bursts, no laser — DIC-like contrast',
+          readouts: [
+            { label: 'bursts captured', value: '7',               sub: 'across 3 embryos' },
+            { label: 'illumination',    value: 'LED · laser off', sub: 'brightfield' }
+          ]
+        },
+        relations: {}
+      },
+      {
+        id: 'srv-2', seq: 2,
+        name: 'Volume at best plane',
+        kind: 'oneshot', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Full volume capture at the best focal plane after operator review.',
+        structure: { note: 'operator selects plane' },
+        live_bind: [],
+        live: { summary: 'queued · operator review' },
+        relations: { after: ['srv-1'] }
+      }
+    ]
+  },
+
+  /* ------------------------------------------------------------------ */
+  decided_plan: {
+    session_id: '20260628_1500_tempstrain_b',
+    title: 'Temperature-strain run · E02',
+    goal: 'Repeat the thermal strain protocol on a second embryo cohort.',
+    tactics: [
+      {
+        id: 'dp-1', seq: 1,
+        name: 'Transmission burst — baseline',
+        kind: 'exclusive_burst', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Brightfield baseline before any change.',
+        structure: { frames: 3, mode: 'brightfield' },
+        live_bind: [],
+        live: {
+          summary: 'queued · first',
+          desc: 'brightfield baseline before any change'
+        },
+        relations: {}
+      },
+      {
+        id: 'dp-2', seq: 2,
+        name: 'Temp-change burst protocol',
+        kind: 'scripted_protocol', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Thermal step to 30.0 °C with phased acquisition.',
+        structure: {
+          phases: [
+            { name: 'before', state: 'todo', count: '0/1' },
+            { name: 'during', state: 'todo', count: '0/3' },
+            { name: 'after',  state: 'todo', count: '0/1' }
+          ]
+        },
+        live_bind: ['temperature', 'current_burst'],
+        live: { target: '→ 30.0 °C', summary: 'queued · second' },
+        relations: { after: ['dp-1'] }
+      },
+      {
+        id: 'dp-3', seq: 3,
+        name: 'Recovery monitor',
+        kind: 'standing_timelapse', state: 'planned',
+        scope: { mode: 'global' },
+        rationale: 'Low-cadence monitoring after temperature settles.',
+        structure: { cadence_s: 180 },
+        live_bind: ['cadence'],
+        live: { summary: 'queued · last' },
+        relations: { after: ['dp-2'] }
+      }
+    ]
+  },
+
+  /* ------------------------------------------------------------------ */
+  async_multi: {
+    session_id: '20260628_1630_async_multi',
+    title: 'Async multi-embryo run · 4 embryos',
+    goal: 'Per-embryo asynchronous acquisition with individual cadence phases; overlay a hatching watch on the two most advanced.',
+    tactics: [
+      {
+        id: 'am-1', seq: 1,
+        name: 'Async timelapse — per-embryo cadence',
+        kind: 'standing_timelapse', state: 'active',
+        scope: { mode: 'embryos', embryo_ids: ['E01', 'E02', 'E03', 'E04'] },
+        rationale: 'Each embryo runs at its own cadence based on developmental stage and reporter state.',
+        structure: {
+          cadence_s: 120,
+          per_embryo: [
+            { embryo_id: 'E01', cadence_phase: 'normal', interval_s: 180 },
+            { embryo_id: 'E02', cadence_phase: 'fast',   interval_s: 30  },
+            { embryo_id: 'E03', cadence_phase: 'burst',  interval_s: 0   },
+            { embryo_id: 'E04', cadence_phase: 'paused', interval_s: null }
+          ]
+        },
+        live_bind: ['cadence'],
+        live: {
+          summary: 'running · 4 embryos',
+          readouts: [
+            { label: 'active embryos', value: '3 / 4', sub: 'E04 paused' },
+            { label: 'cadence range',  value: '30–180s', sub: 'per-embryo mode' }
+          ]
+        },
+        relations: {}
+      },
+      {
+        id: 'am-2', seq: 2,
+        name: 'Hatching watch — E01, E02',
+        kind: 'reactive_monitor', state: 'active',
+        scope: { mode: 'embryos', embryo_ids: ['E01', 'E02'] },
+        rationale: 'Overlay a hatching detector on the two most advanced embryos.',
+        structure: { watch: 'hatching', reaction: 'accelerate + alert', status: 'armed' },
+        live_bind: ['signal'],
+        live: {
+          target: 'hatching',
+          summary: 'armed · E01, E02',
+          desc: 'watching for hatching onset on the two most advanced embryos',
+          readouts: [
+            { label: 'watch status', value: 'armed',      sub: 'no event yet' },
+            { label: 'scope',        value: 'E01, E02',   sub: '2 of 4 embryos' }
+          ]
+        },
+        relations: { layered_on: ['am-1'] }
+      }
+    ]
+  },
+
+  /* ------------------------------------------------------------------ */
+  idle: null
+};
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 7edcd230..1f09ba06 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -931,6 +931,7 @@ <h3 class="devices-properties-title">Properties</h3>
     <script src="/static/js/marking.js"></script>
     <script src="/static/js/temperature-graph.js"></script>
     <script src="/static/js/devices.js"></script>
+    <script src="/static/js/operations-scenarios.js"></script>
     <script src="/static/js/experiment-overview.js"></script>
     <!-- Three.js for 3D volume viewer -->
     <script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>

From e65834db6da722ef8072ec7d0830a475400e3fbc Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:12:46 +0530
Subject: [PATCH 219/314] feat(operations): live telemetry binding +
 event-driven refresh

- ExperimentOverview now subscribes to CONTEXT_UPDATED + 7 tactic-lifecycle
  events (TEMP_PROTOCOL_STARTED/COMPLETED, BURST_START/COMPLETE,
  EMBRYO_CADENCE_CHANGED, TEMPERATURE_SETPOINT_CHANGED, POWER_RAMP_STEP);
  each fires a debounced (500 ms) loadPlan()+render() refetch.

- _debouncedRefresh(): coalesces rapid bursts into a single fetch+render.
  _subscribed flag prevents double-registration on repeated tab re-clicks.
  Subscriptions are skipped entirely in scenario mode (?scenario=).

- _handleTempUpdate(): TEMPERATURE_UPDATE (~1 Hz) binds water_c/setpoint_c
  directly onto the active scripted_protocol tactic's temperature gauge IN
  PLACE (updates .ops-gv only), with no plan refetch.

- _renderOpsReadout(): stamps data-livebind on each gauge div. Explicit
  r.bind key takes priority over normalised r.label, so display labels
  ("stage temp") and semantic bind keys ("temperature") are decoupled.

- operations-scenarios.js: adds bind:'temperature' to the temp_strain
  stage-temp readout so the in-place selector resolves correctly.
---
 .../ui/web/static/js/experiment-overview.js   | 91 ++++++++++++++++++-
 .../ui/web/static/js/operations-scenarios.js  |  1 +
 2 files changed, 91 insertions(+), 1 deletion(-)

diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index c46eba9c..a42bb022 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -16,6 +16,9 @@ const ExperimentOverview = {
     activePlan: null,        // last fetched/loaded operation plan (overview spine)
     isLive: false,           // true when data came from the API
     scenarioMode: false,     // true when ?scenario=<name> is active
+    _subscribed: false,      // guard: prevents double-registration across tab re-clicks
+    _planRefreshTimer: null, // debounce handle for tactic-event-driven refetch
+    _tempUpdateHandler: null,// stored handler ref so it can be off()'d if needed
 
     async init() {
         console.log('[ExperimentOverview] init() called, view=', this.activeView);
@@ -46,6 +49,32 @@ const ExperimentOverview = {
         this.isLive = plan !== null || strategy !== null;
         this.render(strategy);
         this.initialized = true;
+
+        // Subscribe to tactic-state events once per page load.
+        // Guard: _subscribed prevents double-registration across tab re-clicks.
+        // Skip entirely in scenario mode — no live backend, no websocket.
+        if (!this._subscribed) {
+            this._subscribed = true;
+            const refresh = () => this._debouncedRefresh();
+            // Plan-changing events: re-fetch the whole plan after debounce.
+            // CONTEXT_UPDATED fires when OperationPlanUpdater patches the plan.
+            // The tactic-lifecycle events fire on transitions the updater also
+            // reacts to, so they all funnel into the same debounced refetch.
+            const TACTIC_EVENTS = [
+                'CONTEXT_UPDATED',
+                'TEMP_PROTOCOL_STARTED', 'TEMP_PROTOCOL_COMPLETED',
+                'BURST_START', 'BURST_COMPLETE',
+                'EMBRYO_CADENCE_CHANGED', 'TEMPERATURE_SETPOINT_CHANGED',
+                'POWER_RAMP_STEP',
+            ];
+            TACTIC_EVENTS.forEach(ev => ClientEventBus.on(ev, refresh));
+
+            // High-frequency temperature binding (~1 Hz).
+            // Updates the active scripted_protocol tactic's temperature gauge
+            // IN PLACE — no plan refetch, no full re-render.
+            this._tempUpdateHandler = (data) => this._handleTempUpdate(data);
+            ClientEventBus.on('TEMPERATURE_UPDATE', this._tempUpdateHandler);
+        }
     },
 
     async loadStrategy() {
@@ -85,6 +114,57 @@ const ExperimentOverview = {
         }
     },
 
+    // Debounced plan refetch — coalesces rapid tactic-event bursts into a single
+    // fetch+render.  500 ms window matches experiment-strip.js convention.
+    _debouncedRefresh() {
+        if (this._planRefreshTimer) clearTimeout(this._planRefreshTimer);
+        this._planRefreshTimer = setTimeout(async () => {
+            this._planRefreshTimer = null;
+            const plan = await this.loadPlan();
+            this.activePlan = plan;
+            this.isLive = plan !== null;
+            this.render(this.activeStrategy);
+        }, 500);
+    },
+
+    // In-place temperature gauge update — called at ~1 Hz by TEMPERATURE_UPDATE.
+    // Finds the active scripted_protocol tactic's temperature readout in the DOM
+    // and rewrites only that element's value, never refetching the plan.
+    // No-op when there is no active scripted_protocol tactic with temperature binding.
+    _handleTempUpdate(data) {
+        if (!data || !data.sample) return;
+        const plan = this.activePlan;
+        if (!plan || !Array.isArray(plan.tactics)) return;
+        // Only act when an active scripted_protocol tactic declares temperature binding.
+        const activeTactic = plan.tactics.find(
+            t => t.state === 'active'
+                && t.kind === 'scripted_protocol'
+                && Array.isArray(t.live_bind)
+                && t.live_bind.includes('temperature')
+        );
+        if (!activeTactic) return;
+
+        const root = document.getElementById('experiment-overview-root');
+        if (!root) return;
+        // _renderOpsReadout stamps data-livebind="temperature" on the gauge div
+        // when the readout label normalises to "temperature".
+        const gauge = root.querySelector('.ops-node.active .ops-gauge[data-livebind="temperature"]');
+        if (!gauge) return;
+        const gv = gauge.querySelector('.ops-gv');
+        if (!gv) return;
+
+        const s = data.sample;
+        const water = s.water_c != null
+            ? parseFloat(s.water_c).toFixed(1) + '°C'
+            : '—';
+        const sp = s.setpoint_c != null
+            ? ' → <span class="ops-set">'
+                + parseFloat(s.setpoint_c).toFixed(1)
+                + '°C</span>'
+            : '';
+        gv.innerHTML = water + sp;
+    },
+
     setView(view) {
         if (view === this.activeView) return;
         this.activeView = view;
@@ -1228,8 +1308,17 @@ const ExperimentOverview = {
     },
 
     // Render a readout gauge. `r.value` may contain trusted HTML (span markup).
+    // Stamps data-livebind on the outer div so _handleTempUpdate (and future
+    // live-binding) can find the gauge in-place without a full re-render.
+    // Priority: r.bind (explicit semantic key) > normalised r.label.
     _renderOpsReadout(r, ESC) {
-        return `<div class="ops-gauge">
+        const bindKey = r.bind
+            ? r.bind
+            : (r.label
+                ? r.label.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '')
+                : '');
+        const bindAttr = bindKey ? ` data-livebind="${ESC(bindKey)}"` : '';
+        return `<div class="ops-gauge"${bindAttr}>
             <div class="ops-gl">${ESC(r.label)}</div>
             <div class="ops-gv">${r.value}</div>
             ${r.bar != null
diff --git a/gently/ui/web/static/js/operations-scenarios.js b/gently/ui/web/static/js/operations-scenarios.js
index 9a4f74e7..0cd72fbf 100644
--- a/gently/ui/web/static/js/operations-scenarios.js
+++ b/gently/ui/web/static/js/operations-scenarios.js
@@ -70,6 +70,7 @@ window.OPERATIONS_SCENARIOS = {
           readouts: [
             {
               label: 'stage temp',
+              bind: 'temperature',
               value: '29.4<span class="ops-u">→</span><span class="ops-set">32.0°C</span>',
               bar: 62
             },

From ab4395c2be8f8c36bf7482659801061d702fc189 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:29:43 +0530
Subject: [PATCH 220/314] fix(operations): wire seeding + agent plan guidance +
 queue_burst guard + paused state + docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- templates.py: add OPERATION_PLAN_GUIDANCE block + inject after REACTIVE_MONITORING_MODES
- agent.py exit_plan_mode: call seed_operation_plan_from_plan_item after link_session_campaign
- timelapse_tools.py queue_burst: gate transition_tactic on result.startswith("Burst queued for ")
- operation_plan_tools.py: add "paused" to _VALID_STATES (pause_timelapse uses it)
- file_store.py transition_tactic: add read-modify-write / single-loop-thread note
- spec: document live.readouts/phases + flat bound keys in §1 tactic schema
- test: add test_queue_burst_soft_reject_does_not_transition (Fix #4 coverage)
---
 .superpowers/sdd/dv3-whole-branch-fixes.md    | 109 ++++++++++++++++++
 .../specs/2026-06-28-operations-tab-design.md |   8 ++
 gently/app/agent.py                           |  10 ++
 gently/app/tools/operation_plan_tools.py      |   2 +-
 gently/app/tools/timelapse_tools.py           |   8 +-
 gently/harness/memory/file_store.py           |   4 +
 gently/harness/prompts/templates.py           |  26 +++++
 tests/test_tool_tactic_linkage.py             |  28 +++++
 8 files changed, 192 insertions(+), 3 deletions(-)
 create mode 100644 .superpowers/sdd/dv3-whole-branch-fixes.md

diff --git a/.superpowers/sdd/dv3-whole-branch-fixes.md b/.superpowers/sdd/dv3-whole-branch-fixes.md
new file mode 100644
index 00000000..5ec58d80
--- /dev/null
+++ b/.superpowers/sdd/dv3-whole-branch-fixes.md
@@ -0,0 +1,109 @@
+# dv3 whole-branch review fixes — backend half
+
+Agent: backend-fixes agent (this session).
+Commit: see footer.
+Frontend fixes (experiment-overview.js + css): separate agent, not touched here.
+
+---
+
+## Fix #2 — agent prompt guidance to declare the Operation Plan
+
+**File:** `gently/harness/prompts/templates.py`
+
+Added constant `OPERATION_PLAN_GUIDANCE` (~line 225) and injected `{OPERATION_PLAN_GUIDANCE}`
+into the system template f-string right after `{REACTIVE_MONITORING_MODES}` (~line 510).
+The block tells the agent to call `declare_operation_plan` at experiment planning time
+with kind/name/target/scope/rationale + a `live` object (`readouts`/`phases` + flat keys),
+and to re-call (patch) on each tactic transition. Also notes that execution tools
+(`queue_burst`, `enable_monitoring_mode`, etc.) accept `tactic_id` and flip state automatically.
+
+---
+
+## Fix #3 — wire operation-plan seeding in exit_plan_mode
+
+**File:** `gently/app/agent.py`, `exit_plan_mode()` (~line 475)
+
+Hook site confirmed: inside `if active_id:` block, right after the `link_session_campaign`
+try/except (line ~464-469). At that point `self.context_store` and `self.session_id` are
+guaranteed valid (context_store is used unguarded at `get_plan_item` one line above).
+
+Added:
+```python
+try:
+    from gently.app.tools.operation_plan_seed import seed_operation_plan_from_plan_item
+    seed_operation_plan_from_plan_item(self.context_store, self.session_id)
+except Exception:
+    logger.exception("operation-plan seeding failed")
+```
+
+---
+
+## Fix #4 — queue_burst phantom-active on soft-reject
+
+**File:** `gently/app/tools/timelapse_tools.py` (~line 1204)
+
+`orchestrator.queue_burst` returns `"Burst queued for {embryo_id} (request_id=..., ...)"` on
+success and a rejection sentence (embryo not in timelapse / already had burst / already queued)
+on soft-reject. Success is reliably distinguishable by `result.startswith("Burst queued for ")`.
+
+Guard applied:
+```python
+if tactic_id and isinstance(result, str) and result.startswith("Burst queued for "):
+    cs.transition_tactic(session, tactic_id, "active")
+```
+
+New test added to `tests/test_tool_tactic_linkage.py`:
+`test_queue_burst_soft_reject_does_not_transition` — fake orchestrator returns
+`"Embryo 'emb1' already has a queued burst."` → verifies `cs.transitions == []`.
+
+---
+
+## Fix #5 — `paused` valid state
+
+**File:** `gently/app/tools/operation_plan_tools.py`, line 29
+
+`_VALID_STATES` extended: `frozenset({"planned", "active", "done", "paused"})`.
+`pause_timelapse` transitions to `"paused"` — this was previously an invalid state
+causing a ValueError on validation.
+
+---
+
+## Fix #7 — document `live` in the spec
+
+**File:** `docs/superpowers/specs/2026-06-28-operations-tab-design.md`, §1
+
+Added `live` field to the tactic schema block with `readouts`/`phases` sub-keys and
+a documentation paragraph explaining that the agent authors `readouts`/`phases` at
+declaration time and the updater merges flat bound keys (`request_id`, `sustained_hz`,
+`setpoint`, `locked`, `last_fired`, `new_phase`, …) as telemetry arrives.
+
+---
+
+## Fix #8 — transition_tactic single-loop note
+
+**File:** `gently/harness/memory/file_store.py`, `transition_tactic` docstring (~line 847)
+
+Added one-line note: "read-modify-write with no lock; safe because all subscribed event
+emissions run on the single asyncio loop thread — revisit if a worker-thread emitter
+is ever added."
+
+---
+
+## Test results
+
+```
+pytest tests/test_operation_plan_tool.py tests/test_tool_tactic_linkage.py \
+       tests/test_operation_plan_seeding.py tests/test_operation_plan_store.py -v
+65 passed, 0 failed
+```
+
+Full suite (excluding 3 pre-existing collection errors in test_campaign_coordination.py,
+test_gently_store.py, test_text_tool_call_extraction.py):
+- Before changes: 32 failed, 673 passed, 19 skipped
+- After changes:  32 failed, 674 passed, 19 skipped  (+1 new test, 0 new failures)
+
+---
+
+## Commit
+
+`fix(operations): wire seeding + agent plan guidance + queue_burst guard + paused state + docs`
diff --git a/docs/superpowers/specs/2026-06-28-operations-tab-design.md b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
index 95224ed1..d301e312 100644
--- a/docs/superpowers/specs/2026-06-28-operations-tab-design.md
+++ b/docs/superpowers/specs/2026-06-28-operations-tab-design.md
@@ -42,8 +42,16 @@ structure :   # by kind
   oneshot|custom     → { note }
 live_bind : [ 'temperature' | 'current_burst' | 'cadence' | 'signal' | ... ]    # which telemetry fills readouts/progress
 relations : { after?:[tactic_id], layered_on?:[tactic_id], triggers?:[tactic_id] }   # concurrency + composition
+live      : {                                                                         # agent-authored display hints + updater-merged telemetry
+  readouts : [{label, value, sub?, bar?, bind?}]                                      # instrument strip entries (e.g. {label:"cadence", value:"120 s"})
+  phases   : [{name, state:'done'|'active'|'todo', count, pips}]                     # phase stepper for scripted_protocol / exclusive_burst
+  # flat bound keys merged in by the updater as telemetry arrives:
+  # request_id, sustained_hz, setpoint, locked, last_fired, new_phase, ...
+}
 ```
 
+The `live` object has two agent-authored sub-keys: `readouts` (a list of instrument-strip rows the agent populates at declaration time) and `phases` (a phase stepper list for scripted or burst tactics). The operation-plan updater additionally merges flat keys (`request_id`, `sustained_hz`, `setpoint`, `locked`, `last_fired`, `new_phase`, and any other telemetry bound via `live_bind`) directly onto `live` as events arrive — the agent seeds these at declaration if the value is already known, or leaves them absent for the updater to fill in.
+
 This single typed object expresses a regular timelapse (standing), an async per-embryo run (standing
 with per-embryo cadence — *real* in the orchestrator), a reactive monitor incl. **hatching detection**
 (reactive), a temp-change protocol (scripted, phased), an exclusive burst, and arbitrary `custom`
diff --git a/gently/app/agent.py b/gently/app/agent.py
index b02b227c..47b2421d 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -467,6 +467,16 @@ def exit_plan_mode(self) -> str:
                         )
                     except Exception:
                         pass
+
+                # Seed the Operation Plan from the plan item's tactics outline
+                # (idempotent: no-op if plan already has active/done tactics).
+                try:
+                    from gently.app.tools.operation_plan_seed import (
+                        seed_operation_plan_from_plan_item,
+                    )
+                    seed_operation_plan_from_plan_item(self.context_store, self.session_id)
+                except Exception:
+                    logger.exception("operation-plan seeding failed")
             elif candidates:
                 titles = [c[0].title for c in candidates]
                 listing = ", ".join(titles[:5])
diff --git a/gently/app/tools/operation_plan_tools.py b/gently/app/tools/operation_plan_tools.py
index 07d51835..93998a03 100644
--- a/gently/app/tools/operation_plan_tools.py
+++ b/gently/app/tools/operation_plan_tools.py
@@ -26,7 +26,7 @@
         "custom",
     }
 )
-_VALID_STATES = frozenset({"planned", "active", "done"})
+_VALID_STATES = frozenset({"planned", "active", "done", "paused"})
 
 
 def _validate_tactics(tactics: list) -> list[dict]:
diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index 9e96cbe5..0c0c45c2 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -1201,8 +1201,12 @@ def queue_burst(
             force=force,
             tactic_id=tactic_id,
         )
-        # Flip the matching plan tactic to active on enqueue (guarded no-op when absent).
-        if tactic_id:
+        # Flip the matching plan tactic to active only when the burst was actually queued.
+        # orchestrator.queue_burst returns "Burst queued for ..." on success and a
+        # human-readable rejection sentence on soft-reject (embryo absent, already had
+        # a burst, already has a queued burst).  Gate on the success prefix so a
+        # soft-reject does NOT phantom-flip the tactic to active.
+        if tactic_id and isinstance(result, str) and result.startswith("Burst queued for "):
             cs = getattr(agent, "context_store", None)
             session = getattr(agent, "session_id", None)
             if cs and session:
diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 98763cf3..7a9eba4e 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -842,6 +842,10 @@ def transition_tactic(
 
         Returns True on success, False if the plan is absent or the tactic id
         is not found (no-op, no crash).
+
+        Note: read-modify-write with no lock; safe because all subscribed event
+        emissions run on the single asyncio loop thread — revisit if a
+        worker-thread emitter is ever added.
         """
         plan = self.get_operation_plan(session_id)
         if plan is None:
diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index f75fc7a5..536064b4 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -222,6 +222,30 @@
 """
 
 
+OPERATION_PLAN_GUIDANCE = """
+## Operation Plan — keep it current
+
+At experiment planning time, call `declare_operation_plan` with every tactic
+you intend to run.  Each tactic needs at minimum: `id` (short stable string),
+`name`, `kind`, `state` (start as `"planned"`), `scope`, and `rationale`.
+For richer display, populate a `live` object on the tactic:
+
+- `readouts` — list of `{label, value}` dicts for the instrument strip
+  (e.g. `{label: "cadence", value: "120 s"}`).
+- `phases` — list of `{name, state, count, pips}` for scripted/phased tactics.
+- Flat bound keys (`request_id`, `sustained_hz`, `setpoint`, `locked`,
+  `last_fired`, `new_phase`, …) are merged in by the updater as live telemetry
+  arrives; you can seed them at declaration time if the value is already known.
+
+Re-call `declare_operation_plan` (patch) whenever a tactic's state changes:
+`"planned"` → `"active"` when you start it, `"active"` → `"done"` when it
+finishes.  This keeps the Operations view in the UI synchronized with reality.
+Execution tools (`queue_burst`, `enable_monitoring_mode`, `stop_timelapse`,
+`pause_timelapse`) also accept an optional `tactic_id` and flip the state
+automatically — pass it when a tool maps cleanly to one tactic.
+"""
+
+
 ADAPTIVE_TIMELAPSE = """
 # Adaptive Timelapse System
 
@@ -483,6 +507,8 @@ def build_system_prompt(
 
 {REACTIVE_MONITORING_MODES}
 
+{OPERATION_PLAN_GUIDANCE}
+
 {AUTONOMY_AND_ADAPTATION}
 
 {USER_INTERACTION_GUIDELINES}
diff --git a/tests/test_tool_tactic_linkage.py b/tests/test_tool_tactic_linkage.py
index be245093..6b56fa47 100644
--- a/tests/test_tool_tactic_linkage.py
+++ b/tests/test_tool_tactic_linkage.py
@@ -185,6 +185,34 @@ async def test_queue_burst_passes_tactic_id_to_orchestrator():
     assert orch.bursts_queued[0]["tactic_id"] == "t2"
 
 
+@pytest.mark.asyncio
+async def test_queue_burst_soft_reject_does_not_transition():
+    """queue_burst (tool) must NOT flip the tactic to active on a soft-reject.
+
+    orchestrator.queue_burst returns a rejection sentence (not starting with
+    "Burst queued for") when the embryo already has a queued burst, already
+    had a burst this session, or is not in the active timelapse.  The tool
+    must treat those as non-events and leave transition_tactic uncalled.
+    """
+    from gently.app.tools.timelapse_tools import queue_burst
+
+    class RejectingOrchestrator(FakeOrchestrator):
+        def queue_burst(self, embryo_id, *, frames=60, mode="1hz", num_slices=1,
+                        force=False, laser_config=None, tactic_id=None) -> str:
+            # Simulates "already has a queued burst" soft-reject
+            return f"Embryo '{embryo_id}' already has a queued burst."
+
+    cs = FakeContextStore()
+    orch = RejectingOrchestrator()
+    agent = FakeAgent(cs=cs, orchestrator=orch)
+
+    await queue_burst(embryo_id="emb1", tactic_id="t2", context=_ctx(agent, with_client=True))
+
+    assert cs.transitions == [], (
+        f"transition_tactic must not be called on soft-reject; got {cs.transitions}"
+    )
+
+
 # ---------------------------------------------------------------------------
 # stop_timelapse — mark done
 # ---------------------------------------------------------------------------

From f4ab6064c6739d60bf9ddc0dea840a5c8175163a Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:32:37 +0530
Subject: [PATCH 221/314] fix(operations): surface bound live.* telemetry,
 paused state styling, delete dead swimlane code

Fix #1: _renderOpsTactic now collects all flat keys on live{} (excl.
readouts/phases/target/summary/desc) and renders them as a compact
.ops-livefacts key:value strip for active and done tactics.  Bound
telemetry like sustained_hz, mp4_path, last_fired, request_id is now
visible on the card face instead of being swallowed.

Fix #5: added paused to STATE_LABEL; .ops-node.paused gets a muted
grey dot + solid grey left edge distinct from done/active/planned.

Fix #6: deleted 897 lines of unreachable swimlane dead code:
_renderOverviewView, _renderHeader, _renderLegend, _renderSwimlanes,
_renderLaneRow, _startNowTicker, _updateNowMarker.  render() has called
_renderOperationSpine for the overview path since the spine rewrite;
all deleted functions were confirmed unreferenced outside their own chain.
---
 gently/ui/web/static/css/experiment.css       |  60 ++
 .../ui/web/static/js/experiment-overview.js   | 922 +-----------------
 2 files changed, 78 insertions(+), 904 deletions(-)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 16f6ba73..1d48cef5 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -1074,3 +1074,63 @@
     color: var(--text-muted);
     opacity: 0.75;
 }
+
+/* ---- Fix #1: bound live.* telemetry facts strip --------------- */
+/* Compact monospace key:value row rendered for active + done tactics
+   when the live object carries flat keys beyond readouts/phases/target.
+   Subtle instrument aesthetic — matches the ops-mono system, sits below
+   the structured readout strip without visual weight. */
+
+.ops-livefacts {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px 16px;
+    margin-top: 8px;
+    padding: 6px 10px;
+    background: var(--bg-hover, #21262d);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 7px;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    line-height: 1.5;
+}
+
+.ops-lf-pair {
+    display: inline-flex;
+    align-items: baseline;
+    gap: 5px;
+}
+
+.ops-lf-k {
+    color: var(--text-muted);
+    font-size: 10px;
+    letter-spacing: 0.06em;
+    text-transform: lowercase;
+}
+
+.ops-lf-v {
+    color: var(--text);
+    font-weight: 500;
+    font-variant-numeric: tabular-nums;
+}
+
+/* ---- Fix #5: paused tactic state ----------------------------- */
+/* Muted grey dot + solid grey left edge — visually distinct from
+   done (green), active (amber), and queued (dashed blue). */
+
+.ops-node.paused::before {
+    border-color: var(--text-muted, #8b949e);
+    background: var(--bg-card, #161b22);
+    opacity: 0.7;
+}
+
+.ops-node.paused .ops-stagelab {
+    color: var(--text-muted, #8b949e);
+}
+
+.ops-node.paused .ops-card {
+    background: transparent;
+    border-color: rgba(139, 148, 158, 0.3);
+    border-left: 3px solid var(--text-muted, #8b949e);
+    opacity: 0.8;
+}
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index a42bb022..6ba9b109 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -212,20 +212,6 @@ const ExperimentOverview = {
         }
     },
 
-    // The "now" marker advances with wall-clock time and shows a countdown to
-    // the next base-interval acquisition. We update only the marker group's
-    // transform + the chip text, never re-rendering the whole SVG. Tick rate
-    // is ~4 Hz which keeps the line motion visibly smooth without burning
-    // cycles. Skipped while the tab is hidden.
-    _startNowTicker() {
-        this._stopNowTicker();
-        const tick = () => {
-            if (!this._nowTickerCtx) return;
-            if (!document.hidden) this._updateNowMarker();
-            this._nowTickerHandle = setTimeout(tick, 250);
-        };
-        this._nowTickerHandle = setTimeout(tick, 250);
-    },
 
     _stopNowTicker() {
         if (this._nowTickerHandle) {
@@ -234,56 +220,7 @@ const ExperimentOverview = {
         }
     },
 
-    _updateNowMarker() {
-        const ctx = this._nowTickerCtx;
-        if (!ctx || !ctx.marker.isConnected) return;
-        const elapsedRealS = (Date.now() - ctx.renderedAtMs) / 1000;
-        const effOffsetS = Math.min(
-            ctx.renderedOffsetS + elapsedRealS,
-            ctx.horizonS
-        );
-        const x = ctx.xForT(effOffsetS);
-        ctx.marker.setAttribute('transform', `translate(${x},0)`);
-
-        // Wall-clock from session-anchored time so the line and the clock
-        // can't drift apart even if the client clock is wrong.
-        const wallMs = ctx.startedAtMs + effOffsetS * 1000;
-        const d = new Date(wallMs);
-        const hh = String(d.getHours()).padStart(2, '0');
-        const mm = String(d.getMinutes()).padStart(2, '0');
-        const ss = String(d.getSeconds()).padStart(2, '0');
-
-        let label = `${hh}:${mm}:${ss}`;
-        if (ctx.baseIntervalS > 0) {
-            const nextTickS = Math.ceil(effOffsetS / ctx.baseIntervalS) * ctx.baseIntervalS;
-            const remainS = Math.max(0, Math.round(nextTickS - effOffsetS));
-            const rm = Math.floor(remainS / 60);
-            const rs = String(remainS % 60).padStart(2, '0');
-            label += ` · next ${rm}:${rs}`;
-        }
-        ctx.chipText.textContent = label;
-
-        // Size the chip to fit; flip to the left of the line if we're near
-        // the right edge so it stays on-screen.
-        const textLen = label.length * 6.2 + 12;
-        const nearEnd = x + textLen + 8 > ctx.laneRight;
-        if (nearEnd) {
-            ctx.chipBg.setAttribute('x', -textLen - 4);
-            ctx.chipBg.setAttribute('width', textLen);
-            ctx.chipText.setAttribute('x', -textLen + 2);
-        } else {
-            ctx.chipBg.setAttribute('x', 4);
-            ctx.chipBg.setAttribute('width', textLen);
-            ctx.chipText.setAttribute('x', 10);
-        }
-    },
 
-    _renderOverviewView(root, s) {
-        root.appendChild(this._renderHeader(s));
-        root.appendChild(this._renderModes(s));
-        root.appendChild(this._renderModeExpanded(s));
-        root.appendChild(this._renderSwimlanes(s));
-    },
 
     _renderRulesView(root, s) {
         // Compact header echoing the session identity
@@ -302,48 +239,6 @@ const ExperimentOverview = {
         root.appendChild(this._renderRulesTable(s));
     },
 
-    // -----------------------------------------------------------------
-    // Header — session identification + key metrics strip
-    // (page-level title lives in .experiment-header-bar above)
-    // -----------------------------------------------------------------
-    _renderHeader(s) {
-        const elapsedH = Math.floor(s.now_offset_s / 3600);
-        const elapsedM = Math.floor((s.now_offset_s % 3600) / 60);
-        const wrap = el('div', 'expov-header');
-
-        // Session identification — the navbar already carries the id on
-        // every tab, so we only render a name line when it actually adds
-        // info (i.e. a human label, not a hash). The data-source badge is
-        // still useful and gets its own row so it stays visible.
-        const metaRow = el('div', 'expov-header-row expov-header-row-meta');
-        if (s.session_name && s.session_name !== s.session_id) {
-            metaRow.appendChild(elText('span', 'expov-session-name', s.session_name));
-        }
-        metaRow.appendChild(elText('span', 'expov-live-badge', 'live'));
-        wrap.appendChild(metaRow);
-
-        // Compact key-metric strip
-        const roleCounts = {};
-        s.embryos.forEach(e => { roleCounts[e.role] = (roleCounts[e.role] || 0) + 1; });
-        const roleStr = Object.entries(roleCounts).map(([r, n]) => `${n} ${r}`).join(' · ');
-        const metricsRow = el('div', 'expov-header-row expov-header-row-metrics');
-        const metric = (label, val) => {
-            const m = el('span', 'expov-metric');
-            m.appendChild(elText('span', 'expov-metric-val', val));
-            m.appendChild(elText('span', 'expov-metric-lbl', label));
-            return m;
-        };
-        metricsRow.appendChild(metric('elapsed', `${elapsedH}h ${elapsedM}m`));
-        metricsRow.appendChild(metric('base', `${s.base_interval_s}s`));
-        const budgetText = (s.dose_budget_base_ms != null && isFinite(s.dose_budget_base_ms))
-            ? `${(s.dose_budget_base_ms / 1000).toFixed(0)}s × role`
-            : 'no limit';
-        metricsRow.appendChild(metric('budget', budgetText));
-        metricsRow.appendChild(metric('embryos', `${s.embryos.length} · ${roleStr}`));
-        wrap.appendChild(metricsRow);
-
-        return wrap;
-    },
 
     // -----------------------------------------------------------------
     // Monitoring mode chips + expanded panel
@@ -409,804 +304,6 @@ const ExperimentOverview = {
         return name.split('_').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
     },
 
-    // -----------------------------------------------------------------
-    // Legend
-    // -----------------------------------------------------------------
-    _renderLegend() {
-        const wrap = el('div', 'expov-legend');
-        const items = [
-            ['base',     'base cadence'],
-            ['fast',     'fast cadence'],
-            ['burst',    'burst window'],
-            ['cooldown', 'cooldown'],
-            ['paused',   'paused'],
-        ];
-        items.forEach(([cls, label]) => {
-            const item = el('span', 'expov-legend-item');
-            item.appendChild(elClass('span', `expov-legend-swatch ${cls}`));
-            item.appendChild(elText('span', '', label));
-            wrap.appendChild(item);
-        });
-        const projItem = el('span', 'expov-legend-item');
-        projItem.appendChild(elClass('span', 'expov-legend-swatch projected'));
-        projItem.appendChild(elText('span', '', 'projected'));
-        wrap.appendChild(projItem);
-
-        const glyphs = [
-            ['◇', 'trigger fired'],
-            ['●', 'now'],
-            ['■', 'stop condition'],
-            ['∞', 'open-ended'],
-            ['▲', 'burst start'],
-            ['⚠', 'budget warning']
-        ];
-        glyphs.forEach(([g, label]) => {
-            const item = el('span', 'expov-legend-item');
-            item.appendChild(elText('span', 'expov-legend-glyph', g));
-            item.appendChild(elText('span', '', label));
-            wrap.appendChild(item);
-        });
-        return wrap;
-    },
-
-    // -----------------------------------------------------------------
-    // Swimlanes SVG — the main visualization
-    // -----------------------------------------------------------------
-    _renderSwimlanes(s) {
-        const wrap = el('div', 'expov-swimlanes-wrap');
-
-        // Compact inline legend above the SVG
-        const legend = el('div', 'expov-mini-legend');
-        const swatches = [
-            ['base', 'base'],
-            ['fast', 'fast'],
-            ['burst', 'burst'],
-            ['cooldown', 'cooldown']
-        ];
-        swatches.forEach(([k, label]) => {
-            const item = el('span', 'expov-mini-legend-item');
-            const sw = el('span', `expov-mini-legend-swatch ${k}`);
-            item.appendChild(sw);
-            item.appendChild(elText('span', '', label));
-            legend.appendChild(item);
-        });
-        const projItem = el('span', 'expov-mini-legend-item');
-        projItem.appendChild(elClass('span', 'expov-mini-legend-swatch projected'));
-        projItem.appendChild(elText('span', '', 'projected'));
-        legend.appendChild(projItem);
-        wrap.appendChild(legend);
-
-        // Layout constants (logical pixels in the SVG viewBox)
-        const LEFT  = 180;            // label gutter
-        const RIGHT = 80;             // right gutter for stop icon + ∞
-        const LANE_W = 900;           // lane drawing area
-        const W = LEFT + LANE_W + RIGHT;
-
-        const ROW_H        = 100;     // per-embryo row total height
-        const LANE_H       = 28;      // cadence lane height
-        const POWER_H      = 22;      // power strip height
-        const DOSE_H       = 12;      // dose gauge height
-        const ROW_PAD      = 14;      // top padding inside row
-        const TOP_AXIS_H   = 36;      // top axis area (time labels + wall-clock)
-        const BOTTOM_PAD   = 8;
-
-        const rows = s.embryos.length;
-        const H = TOP_AXIS_H + rows * ROW_H + BOTTOM_PAD;
-
-        const svg = svgEl('svg', {
-            class: 'expov-swimlanes-svg',
-            viewBox: `0 0 ${W} ${H}`,
-            preserveAspectRatio: 'xMinYMin meet'
-        });
-
-        // Time scale helpers
-        const xForT = (t) => LEFT + (t / s.horizon_s) * LANE_W;
-        const nowX = xForT(s.now_offset_s);
-
-        // ----- top axis: hour ticks with wall-clock annotation
-        const startedAt = new Date(s.started_at);
-        const axisG = svgEl('g');
-        for (let h = 0; h <= Math.ceil(s.horizon_s / 3600); h++) {
-            const x = xForT(h * 3600);
-            axisG.appendChild(svgEl('line', {
-                x1: x, x2: x, y1: TOP_AXIS_H - 6, y2: H - BOTTOM_PAD,
-                class: 'expov-svg-axis', 'stroke-opacity': h === 0 ? 0.55 : 0.12
-            }));
-            axisG.appendChild(svgEl('text', {
-                x: x + 4, y: 12, class: 'expov-svg-axis-label'
-            }, `+${h}h`));
-            // Wall-clock subtitle
-            const wallClock = new Date(startedAt.getTime() + h * 3600 * 1000);
-            const hh = String(wallClock.getHours()).padStart(2, '0');
-            const mm = String(wallClock.getMinutes()).padStart(2, '0');
-            axisG.appendChild(svgEl('text', {
-                x: x + 4, y: 22,
-                class: 'expov-svg-axis-wallclock'
-            }, `${hh}:${mm}`));
-        }
-        svg.appendChild(axisG);
-
-        // ----- "now" marker: translatable group containing the vertical line
-        // and a live clock chip. The chip advances every tick and shows the
-        // countdown to the next base-interval acquisition window. The group
-        // gets translated by _tickNow, so we don't rebuild SVG every second.
-        const nowMarker = svgEl('g', { class: 'expov-svg-now-marker' });
-        nowMarker.appendChild(svgEl('line', {
-            x1: 0, x2: 0, y1: TOP_AXIS_H - 4, y2: H - BOTTOM_PAD,
-            class: 'expov-svg-now-line'
-        }));
-        // Chip sits just below the axis labels (which live at y=12 and y=22)
-        // so it doesn't sit on top of the "+0h / wallclock" annotation when
-        // the now-line is near the start of the timeline.
-        const chipBg = svgEl('rect', {
-            x: 4, y: TOP_AXIS_H - 6, width: 120, height: 14, rx: 7,
-            class: 'expov-svg-now-chip-bg'
-        });
-        const chipText = svgEl('text', {
-            x: 10, y: TOP_AXIS_H + 4, class: 'expov-svg-now-label'
-        }, '');
-        nowMarker.appendChild(chipBg);
-        nowMarker.appendChild(chipText);
-        svg.appendChild(nowMarker);
-
-        // Stash the bits the ticker needs to update without re-rendering.
-        this._nowTickerCtx = {
-            marker: nowMarker,
-            chipBg: chipBg,
-            chipText: chipText,
-            xForT,
-            startedAtMs: new Date(s.started_at).getTime(),
-            renderedAtMs: Date.now(),
-            renderedOffsetS: s.now_offset_s,
-            baseIntervalS: s.base_interval_s || 0,
-            horizonS: s.horizon_s,
-            laneLeft: LEFT,
-            laneRight: LEFT + LANE_W,
-        };
-        this._updateNowMarker();
-
-        // ----- one group per embryo
-        s.embryos.forEach((emb, i) => {
-            const rowTop = TOP_AXIS_H + i * ROW_H;
-            const rowG = svgEl('g');
-            rowG.appendChild(this._renderLaneRow(s, emb, {
-                LEFT, LANE_W, RIGHT, W, ROW_H, LANE_H, POWER_H, DOSE_H, ROW_PAD,
-                TOP_AXIS_H, rowTop, xForT, nowX
-            }));
-            svg.appendChild(rowG);
-        });
-
-        wrap.appendChild(svg);
-        return wrap;
-    },
-
-    _renderLaneRow(s, emb, dim) {
-        const { LEFT, LANE_W, W, ROW_H, LANE_H, POWER_H, DOSE_H, ROW_PAD,
-                rowTop, xForT, nowX } = dim;
-        const g = svgEl('g');
-
-        // Hairline divider above each row (except first)
-        if (rowTop > dim.TOP_AXIS_H) {
-            g.appendChild(svgEl('line', {
-                x1: 8, x2: W - 8, y1: rowTop, y2: rowTop,
-                class: 'expov-svg-row-divider'
-            }));
-        }
-
-        // ---- Left label gutter ---------------------------------------
-        // Single header line + phase pill. Power/dose labels are at the
-        // y-position of their respective sub-rows, right-aligned in the gutter.
-        const labelY = rowTop + ROW_PAD + 12;
-
-        // Header line: icon · ID · role (· 10× hint for calibration)
-        g.appendChild(svgEl('text', {
-            x: 14, y: labelY + 1, class: 'expov-svg-role-icon',
-            fill: emb.color
-        }, emb.icon));
-        g.appendChild(svgEl('text', {
-            x: 32, y: labelY, class: 'expov-svg-label'
-        }, emb.id));
-        // role tag — eyebrow above the id (avoids colliding with long ids)
-        g.appendChild(svgEl('text', {
-            x: 14, y: rowTop + ROW_PAD - 1,
-            class: 'expov-svg-role-tag'
-        }, emb.role));
-
-        // Phase pill: current mode at glance
-        const currentPhase = emb.phases[emb.phases.length - 1];
-        const pillY = labelY + 7;
-        const pillH = 14;
-        const phaseLabel = currentPhase.mode === 'burst'
-            ? `BURST · ${currentPhase.hz}Hz`
-            : `${currentPhase.mode.toUpperCase()} · ${currentPhase.cadence_s}s`;
-        const pillW = Math.max(70, phaseLabel.length * 6 + 12);
-        const pillX = 32;
-        const phaseColors = {
-            base:     '#6b7280',
-            fast:     '#fb923c',
-            burst:    '#ef4444',
-            cooldown: '#a78bfa',
-            paused:   '#3b82f6'
-        };
-        const pillFill = phaseColors[currentPhase.mode] || '#6b7280';
-        g.appendChild(svgEl('rect', {
-            x: pillX, y: pillY, width: pillW, height: pillH, rx: 7,
-            fill: pillFill, 'fill-opacity': 0.22,
-            stroke: pillFill, 'stroke-opacity': 0.65, 'stroke-width': 1
-        }));
-        g.appendChild(svgEl('text', {
-            x: pillX + pillW / 2, y: pillY + 10,
-            'text-anchor': 'middle',
-            fill: pillFill, 'font-size': 9.5, 'font-weight': 700,
-            'font-family': "'JetBrains Mono', monospace"
-        }, phaseLabel));
-
-        // Tiny tp annotation under the pill (no stop — that's at lane right edge)
-        g.appendChild(svgEl('text', {
-            x: 32, y: pillY + pillH + 12,
-            class: 'expov-svg-sublabel'
-        }, `${emb.tp_acquired} tp acquired`));
-
-        // ---- Cadence lane --------------------------------------------
-        const laneY = rowTop + ROW_PAD;
-        const laneMid = laneY + LANE_H / 2;
-        const laneBottom = laneY + LANE_H;
-
-        // Phases — solid colored rects, no ticks. Cadence is read from the
-        // phase pill in the gutter and the optional inline cadence label.
-        // Min 4px visual width so micro-phases (burst, cooldown) stay visible.
-        emb.phases.forEach(ph => {
-            const x0 = xForT(ph.start);
-            const x1Raw = xForT(ph.end);
-            const x1 = Math.max(x1Raw, x0 + 4);
-            const width = x1 - x0;
-            const cls = `expov-svg-phase-${ph.mode}`;
-            g.appendChild(svgEl('rect', {
-                x: x0, y: laneY, width, height: LANE_H, rx: 2,
-                class: cls
-            }));
-            // Cadence text inside the rect is intentionally omitted — the
-            // gutter pill (currentPhase) and the colored rect (mode) already
-            // convey it. Keep an inline label only for cooldown, which is a
-            // transient state the pill won't be showing.
-            if (ph.mode === 'cooldown' && ph.cadence_s && width >= 42) {
-                g.appendChild(svgEl('text', {
-                    x: x0 + width / 2, y: laneMid + 3.5,
-                    'text-anchor': 'middle',
-                    class: 'expov-svg-phase-label'
-                }, `${ph.cadence_s}s · cool`));
-            }
-            // Burst: keep the bright block + balloon since it's the most
-            // attention-worthy event in the lane
-            if (ph.mode === 'burst') {
-                const bx = (xForT(ph.start) + xForT(ph.end)) / 2;
-                const balloonY = laneY - 12;
-                const halfW = 30;
-                g.appendChild(svgEl('rect', {
-                    x: bx - halfW, y: balloonY - 10, width: halfW * 2, height: 12, rx: 3,
-                    class: 'expov-svg-burst-balloon-bg'
-                }));
-                g.appendChild(svgEl('text', {
-                    x: bx, y: balloonY - 1,
-                    'text-anchor': 'middle',
-                    class: 'expov-svg-burst-label'
-                }, `${ph.frames}f · ${ph.hz}Hz`));
-                g.appendChild(svgEl('line', {
-                    x1: bx, x2: bx, y1: balloonY + 2, y2: laneY,
-                    stroke: '#ef4444', 'stroke-width': 1, 'stroke-opacity': 0.7
-                }));
-            }
-        });
-
-        // ---- Acquisition density heatmap ----------------------------
-        // Instead of one hairline per acquisition (reads as a barcode),
-        // we encode acquisition density as a luminance gradient over
-        // the past portion of the lane: sparse = lane stays muted,
-        // dense = a brighter band. The eye reads acquisition rate as
-        // brightness — no discrete marks, no clutter.
-        //
-        // Counts are derived from phase cadence then rescaled to match
-        // the authoritative `tp_acquired`, so the gradient never lies
-        // about how many timepoints fired even when the backend phase
-        // history is stale or incorrect.
-        const tickEnd = s.now_offset_s;
-        const ackPhases = emb.phases
-            .map((ph, i) => ({ ph, i }))
-            .filter(({ ph }) => ph.mode !== 'burst' && ph.cadence_s);
-        const predicted = ackPhases.map(({ ph }) => {
-            const phEnd = Math.min(ph.end ?? tickEnd, tickEnd);
-            const dur = phEnd - ph.start;
-            return dur > 0 ? Math.max(1, Math.floor(dur / ph.cadence_s) + 1) : 0;
-        });
-        const predictedTotal = predicted.reduce((a, b) => a + b, 0);
-        const actualTotal = Number.isFinite(emb.tp_acquired)
-            ? emb.tp_acquired : predictedTotal;
-        const scale = predictedTotal > 0 ? actualTotal / predictedTotal : 0;
-        const acquisitions = [];
-        ackPhases.forEach(({ ph }, idx) => {
-            const phEnd = Math.min(ph.end ?? tickEnd, tickEnd);
-            const dur = phEnd - ph.start;
-            if (dur <= 0) return;
-            const n = Math.max(1, Math.round(predicted[idx] * scale));
-            for (let j = 0; j < n; j++) {
-                acquisitions.push(ph.start + (dur * (j + 0.5)) / n);
-            }
-        });
-
-        if (acquisitions.length > 0 && tickEnd > 0) {
-            // Layer 1 (background): smoothed luminance gradient
-            // encoding overall acquisition density along the lane.
-            // The triangular kernel kills aliasing stripes caused by
-            // evenly-spaced acquisitions falling into bins.
-            const BINS = 64;
-            const binSec = tickEnd / BINS;
-            const raw = new Array(BINS).fill(0);
-            for (const t of acquisitions) {
-                const bin = Math.min(BINS - 1, Math.max(0, Math.floor(t / binSec)));
-                raw[bin] += 1;
-            }
-            const kernel = [1, 2, 3, 4, 5, 4, 3, 2, 1];
-            const kSum = kernel.reduce((a, b) => a + b, 0);
-            const kOff = Math.floor(kernel.length / 2);
-            const density = new Array(BINS).fill(0);
-            for (let i = 0; i < BINS; i++) {
-                let acc = 0, w = 0;
-                for (let k = 0; k < kernel.length; k++) {
-                    const j = i + k - kOff;
-                    if (j < 0 || j >= BINS) continue;
-                    acc += raw[j] * kernel[k];
-                    w += kernel[k];
-                }
-                density[i] = w > 0 ? acc / w * (kSum / w) : 0;
-            }
-            const maxD = Math.max(...density, 1e-6);
-            const gradId = `expov-density-${(emb.id || 'e').replace(/\W+/g, '_')}-r${rowTop}`;
-            const grad = svgEl('linearGradient', {
-                id: gradId, x1: '0%', x2: '100%', y1: '0%', y2: '0%'
-            });
-            for (let i = 0; i < BINS; i++) {
-                const intensity = density[i] / maxD;
-                // Lower ceiling than the heatmap-only version (0.22 vs
-                // 0.38) because the dots above will carry the per-event
-                // signal; the band just hints at rate.
-                const alpha = 0.03 + 0.22 * intensity;
-                grad.appendChild(svgEl('stop', {
-                    offset: `${(i / (BINS - 1)) * 100}%`,
-                    'stop-color': '#ffffff',
-                    'stop-opacity': alpha.toFixed(3),
-                }));
-            }
-            g.appendChild(grad);
-            const pastW = xForT(tickEnd) - LEFT;
-            if (pastW > 0) {
-                g.appendChild(svgEl('rect', {
-                    x: LEFT, y: laneY,
-                    width: pastW, height: LANE_H,
-                    fill: `url(#${gradId})`,
-                    rx: 2,
-                    'pointer-events': 'none'
-                }));
-            }
-            // Layer 2 (foreground): one soft round dot per acquisition
-            // along the top edge of the lane — keeps the per-event
-            // temporal discreteness the heatmap alone hides.
-            const dotY = laneY + 2;
-            for (const t of acquisitions) {
-                const tx = xForT(t);
-                g.appendChild(svgEl('circle', {
-                    cx: tx, cy: dotY, r: 1.3,
-                    class: 'expov-svg-acq-dot'
-                }));
-            }
-        }
-
-        // ---- Cadence-change markers ---------------------------------
-        // Where consecutive phases differ in cadence (or mode), drop a
-        // vertical divider across the lane and a "300→60s · T34" chip
-        // above so the change is named and time-stamped in the lane.
-        // Apply the same scale factor used for tick rendering so the
-        // T# stamps shown on diamonds and cadence chips agree with the
-        // visible tick density and the authoritative tp_acquired count.
-        // Otherwise the chip might say "T118" on an embryo where we
-        // only drew 54 ticks — visually contradictory.
-        const tpIndexAt = (atS) => {
-            let count = 0;
-            for (const ph of emb.phases) {
-                if (!ph.cadence_s) continue;
-                if (atS < ph.start) break;
-                const phEnd = Math.min(atS, ph.end ?? atS);
-                count += Math.floor((phEnd - ph.start) / ph.cadence_s) + 1;
-            }
-            return Math.max(1, Math.round(count * scale));
-        };
-        // Track placed chip x-positions to avoid stacking chips on top
-        // of one another (e.g. the burst-balloon already sits there).
-        const placedChipX = [];
-        const burstXs = emb.phases
-            .filter(p => p.mode === 'burst')
-            .map(p => xForT(p.start));
-        const isCollision = (x) => {
-            const min = 70;  // px buffer
-            if (burstXs.some(bx => Math.abs(bx - x) < min)) return true;
-            return placedChipX.some(px => Math.abs(px - x) < min);
-        };
-        // Walk phases and detect transitions, but COLLAPSE consecutive
-        // identical (mode + cadence) phases so a row of redundant phase
-        // records doesn't generate redundant dividers/chips.
-        let prevEffective = emb.phases[0];
-        for (let i = 1; i < emb.phases.length; i++) {
-            const curr = emb.phases[i];
-            const prev = prevEffective;
-            const sameCadence = prev.cadence_s === curr.cadence_s;
-            const sameMode = prev.mode === curr.mode;
-            if (sameCadence && sameMode) {
-                continue;  // collapse: prevEffective stays the same
-            }
-            prevEffective = curr;
-            if (prev.mode === 'burst' || curr.mode === 'burst') continue;
-            const cx = xForT(curr.start);
-            if (cx > xForT(s.now_offset_s)) continue;
-            // Divider is cheap to keep even on collision; the chip is what
-            // crowds the space, so we skip just the chip when crowded.
-            g.appendChild(svgEl('line', {
-                x1: cx, x2: cx, y1: laneY, y2: laneBottom,
-                class: 'expov-svg-cadence-divider'
-            }));
-            if (isCollision(cx)) continue;
-            const tp = tpIndexAt(curr.start);
-            const prevS = prev.cadence_s ?? '?';
-            const currS = curr.cadence_s ?? '?';
-            const chipText = `${prevS}→${currS}s · T${tp}`;
-            const chipW = chipText.length * 5.6 + 10;
-            const chipY = laneY - 13;
-            g.appendChild(svgEl('rect', {
-                x: cx - chipW / 2, y: chipY,
-                width: chipW, height: 12, rx: 3,
-                class: 'expov-svg-cadence-chip-bg'
-            }));
-            g.appendChild(svgEl('text', {
-                x: cx, y: chipY + 9,
-                'text-anchor': 'middle',
-                class: 'expov-svg-cadence-chip'
-            }, chipText));
-            placedChipX.push(cx);
-        }
-
-        // ---- Power-change chips -------------------------------------
-        // Same visual language as cadence chips, but parked in a row
-        // above so the two encodings stack neatly when they happen at
-        // the same trigger. Each chip names the rule outcome
-        // ("488 ↓ 5%→3%") and the timepoint it landed at.
-        const placedPowerChipX = [];
-        const hist488 = emb.power_history_488 || [];
-        // Walk the history, collect actual transitions (pairs where pct
-        // changes), then cluster consecutive close ones so a multi-step
-        // ramp gets a single annotation.
-        const transitions = [];
-        for (let k = 0; k < hist488.length - 1; k++) {
-            const a = hist488[k];
-            const b = hist488[k + 1];
-            if (a.pct === b.pct) continue;
-            transitions.push({ from: a, to: b });
-        }
-        const CLUSTER_S = 60;
-        const clusters = [];
-        for (const tr of transitions) {
-            const last = clusters[clusters.length - 1];
-            if (last && tr.to.at - last[last.length - 1].to.at <= CLUSTER_S) {
-                last.push(tr);
-            } else {
-                clusters.push([tr]);
-            }
-        }
-        for (const cluster of clusters) {
-            const first = cluster[0];
-            const tail = cluster[cluster.length - 1];
-            // Anchor the chip at the actual change time, not at any
-            // trailing anchor record (those can land past `now` and
-            // get hidden by the past-only guard).
-            const atS = Math.min(tail.to.at, s.now_offset_s);
-            const cx = xForT(atS);
-            const arrow = tail.to.pct < first.from.pct ? '↓' : '↑';
-            const chipText = `488 ${arrow} ${first.from.pct}%→${tail.to.pct}% · T${tpIndexAt(atS)}`;
-            const chipW = chipText.length * 5.6 + 10;
-            // Sit just above the burst-balloon band (which lives at
-            // laneY-22..-10) so we stay within this row's vertical
-            // budget — laneY-40 would have crossed into the row above.
-            // Burst balloons live at separate x positions on every
-            // case I've seen, so dropping the burst-collision check
-            // lets the chip render even when a burst is on the same
-            // lane elsewhere.
-            const chipY = laneY - 25;
-            const crowded =
-                placedPowerChipX.some(px => Math.abs(px - cx) < 70);
-            g.appendChild(svgEl('line', {
-                x1: cx, x2: cx, y1: chipY + 12, y2: laneY,
-                class: 'expov-svg-power-chip-stem'
-            }));
-            if (crowded) continue;
-            g.appendChild(svgEl('rect', {
-                x: cx - chipW / 2, y: chipY,
-                width: chipW, height: 12, rx: 3,
-                class: 'expov-svg-power-chip-bg'
-            }));
-            g.appendChild(svgEl('text', {
-                x: cx, y: chipY + 9,
-                'text-anchor': 'middle',
-                class: 'expov-svg-power-chip'
-            }, chipText));
-            placedPowerChipX.push(cx);
-        }
-
-        // Projected future segment (dashed) past 'now' to a horizon —
-        // skipped entirely when the embryo has been terminated, since
-        // there's no future to project. projEndT is hoisted because
-        // downstream code (stop-icon, dose-exhaust line) anchors to it.
-        const isTerminated = emb.terminated_at_s != null
-            && emb.terminated_at_s <= s.now_offset_s;
-        const projStartT = s.now_offset_s;
-        let projEndT = isTerminated ? emb.terminated_at_s : s.horizon_s;
-        let projEndsAtBudget = false;
-        if (!isTerminated) {
-            if (emb.projected_end_s) projEndT = Math.min(projEndT, emb.projected_end_s);
-            if (emb.dose_exhaust_at_s && emb.dose_exhaust_at_s < projEndT) {
-                projEndT = emb.dose_exhaust_at_s;
-                projEndsAtBudget = true;
-            }
-            const xProjStart = xForT(projStartT);
-            const xProjEnd = xForT(projEndT);
-            if (xProjEnd > xProjStart) {
-                g.appendChild(svgEl('line', {
-                    x1: xProjStart, y1: laneMid, x2: xProjEnd, y2: laneMid,
-                    class: projEndsAtBudget
-                        ? 'expov-svg-projected-bar warn'
-                        : 'expov-svg-projected-bar'
-                }));
-            }
-        }
-        // Terminated cap: small vertical stop bar at the termination
-        // point + a "■ DONE · T##" label below the lane so a finished
-        // embryo doesn't look like it's still acquiring.
-        if (isTerminated) {
-            const termX = xForT(emb.terminated_at_s);
-            g.appendChild(svgEl('line', {
-                x1: termX, x2: termX,
-                y1: laneY - 2, y2: laneBottom + 2,
-                class: 'expov-svg-terminated-bar'
-            }));
-            g.appendChild(svgEl('rect', {
-                x: termX - 2, y: laneY + LANE_H / 2 - 3,
-                width: 6, height: 6,
-                class: 'expov-svg-terminated-stop'
-            }));
-            const tp = tpIndexAt(emb.terminated_at_s);
-            const capText = `DONE · T${tp}`;
-            g.appendChild(svgEl('text', {
-                x: termX + 6, y: laneBottom + 9,
-                class: 'expov-svg-terminated-label'
-            }, capText));
-        }
-
-        // Trigger diamonds — placed in the upper half of the lane to avoid
-        // colliding with the burst balloon above. Each diamond gets a tiny
-        // T# label below it so the user can see at which timepoint the
-        // rule fired without hovering.
-        (emb.trigger_events || []).forEach(te => {
-            const x = xForT(te.at);
-            const dy = laneY + 6;
-            const size = 4;
-            const trig = s.triggers.find(t => t.id === te.trigger_id);
-            const label = trig ? trig.label : te.trigger_id;
-            const dia = svgEl('polygon', {
-                points: `${x},${dy-size} ${x+size},${dy} ${x},${dy+size} ${x-size},${dy}`,
-                class: 'expov-svg-trigger-diamond expov-svg-tooltip-target'
-            });
-            const tooltip = svgEl('title');
-            tooltip.textContent = `${label}\n${trig?.when_text || ''} → ${trig?.then_text || ''}` +
-                                  (te.count ? ` (×${te.count})` : '');
-            dia.appendChild(tooltip);
-            g.appendChild(dia);
-            g.appendChild(svgEl('text', {
-                x: x, y: laneBottom + 9,
-                'text-anchor': 'middle',
-                class: 'expov-svg-trigger-tp'
-            }, `T${tpIndexAt(te.at)}`));
-        });
-
-        // Dose-exhaust warning: ⚠ + time-to-exhaust positioned ABOVE the lane
-        // so it doesn't overlap with the dashed projected bar
-        if (emb.dose_exhaust_at_s && emb.dose_exhaust_at_s < s.horizon_s) {
-            const exhX = xForT(emb.dose_exhaust_at_s);
-            const remain = emb.dose_exhaust_at_s - s.now_offset_s;
-            const rh = Math.floor(remain / 3600);
-            const rm = Math.floor((remain % 3600) / 60);
-            const exhText = `⚠ budget exhausts in ${rh > 0 ? rh + 'h ' : ''}${rm}m`;
-            g.appendChild(svgEl('text', {
-                x: exhX - 4, y: laneY - 5,
-                'text-anchor': 'end',
-                fill: 'var(--accent-orange)',
-                'font-size': 10,
-                'font-weight': 600,
-                'font-family': "'JetBrains Mono', monospace"
-            }, exhText));
-            // Small dotted vertical marker so the user can see WHERE on the lane
-            g.appendChild(svgEl('line', {
-                x1: exhX, x2: exhX, y1: laneY, y2: laneY + LANE_H,
-                stroke: 'var(--accent-orange)',
-                'stroke-width': 1.5,
-                'stroke-dasharray': '2 2',
-                opacity: 0.7
-            }));
-        }
-        // Open-ended ∞ glyph at right edge
-        if (emb.stop_kind === 'open_ended') {
-            g.appendChild(svgEl('text', {
-                x: LEFT + LANE_W + 8, y: laneMid + 5,
-                class: 'expov-svg-infinity'
-            }, '∞'));
-        } else {
-            g.appendChild(svgEl('text', {
-                x: xForT(projEndT) + 6, y: laneMid + 4,
-                class: 'expov-svg-stop-icon expov-svg-stop-hatch'
-            }, '■'));
-        }
-
-        // ---- Power strip ---------------------------------------------
-        // Visual encoding makes "steady" vs "ramping" obvious:
-        //   • Steady segments  = thin grey horizontal line
-        //   • Ramping segments = bright cyan line + filled area + dot at each step
-        //   • Step transitions get a small arrow (↓ or ↑) and a delta tag
-        const powerY = laneY + LANE_H + 6;
-        const powerH = POWER_H;
-        const powerYBase = powerY + powerH;
-        g.appendChild(svgEl('line', {
-            x1: LEFT, x2: LEFT + LANE_W, y1: powerYBase, y2: powerYBase,
-            class: 'expov-svg-power-baseline'
-        }));
-        const yForPct = (pct) => powerYBase - (pct / 10) * powerH;
-
-        const hist = emb.power_history_488 || [];
-        if (hist.length > 1) {
-            // Detect ramp clusters: consecutive change-steps with x-spacing <
-            // CLUSTER_PX get grouped, annotated once at the cluster end.
-            const CLUSTER_PX = 20;
-            const stepEvents = [];   // each: {fromIdx, toIdx, isRamp}
-            for (let k = 0; k < hist.length - 1; k++) {
-                if (hist[k].pct !== hist[k+1].pct) {
-                    stepEvents.push({ fromIdx: k, toIdx: k+1 });
-                }
-            }
-            // Group consecutive close steps into clusters
-            const clusters = [];
-            stepEvents.forEach(step => {
-                const last = clusters[clusters.length - 1];
-                const stepX = xForT(hist[step.toIdx].at);
-                if (last) {
-                    const lastX = xForT(hist[last[last.length-1].toIdx].at);
-                    if (Math.abs(stepX - lastX) < CLUSTER_PX) {
-                        last.push(step);
-                        return;
-                    }
-                }
-                clusters.push([step]);
-            });
-
-            // Draw horizontal "steady" segments + vertical "step" lines for all
-            // adjacent (hist[k], hist[k+1]) pairs.
-            for (let k = 0; k < hist.length - 1; k++) {
-                const x0 = xForT(hist[k].at);
-                const x1 = xForT(hist[k+1].at);
-                const y  = yForPct(hist[k].pct);
-                const yNext = yForPct(hist[k+1].pct);
-                g.appendChild(svgEl('line', {
-                    x1: x0, x2: x1, y1: y, y2: y,
-                    class: 'expov-svg-power-steady'
-                }));
-                if (hist[k].pct !== hist[k+1].pct) {
-                    g.appendChild(svgEl('line', {
-                        x1: x1, x2: x1, y1: y, y2: yNext,
-                        class: 'expov-svg-power-step'
-                    }));
-                    g.appendChild(svgEl('circle', {
-                        cx: x1, cy: yNext, r: 2.2,
-                        class: 'expov-svg-power-stepdot'
-                    }));
-                }
-            }
-            // Final tail to lane right edge
-            const last = hist[hist.length - 1];
-            const lastX = xForT(last.at);
-            const lastY = yForPct(last.pct);
-            g.appendChild(svgEl('line', {
-                x1: lastX, x2: LEFT + LANE_W, y1: lastY, y2: lastY,
-                class: 'expov-svg-power-steady'
-            }));
-
-            // One annotation per cluster — bracket + "5% → 3%" label
-            clusters.forEach(cluster => {
-                const first = cluster[0];
-                const tail = cluster[cluster.length - 1];
-                const xStart = xForT(hist[first.fromIdx].at);
-                const xEnd = xForT(hist[tail.toIdx].at);
-                const pctStart = hist[first.fromIdx].pct;
-                const pctEnd = hist[tail.toIdx].pct;
-                const arrow = pctEnd < pctStart ? '↓' : '↑';
-                const yMid = (yForPct(pctStart) + yForPct(pctEnd)) / 2;
-                // Bracket: small horizontal line above the cluster steps
-                const bracketY = Math.min(yForPct(pctStart), yForPct(pctEnd)) - 6;
-                g.appendChild(svgEl('path', {
-                    d: `M ${xStart} ${bracketY+3} L ${xStart} ${bracketY} L ${xEnd+2} ${bracketY} L ${xEnd+2} ${bracketY+3}`,
-                    class: 'expov-svg-power-ramp-bracket'
-                }));
-                // Label "488 ↓ 5%→3%" anchored just right of the bracket end
-                g.appendChild(svgEl('text', {
-                    x: xEnd + 6, y: bracketY + 4,
-                    class: 'expov-svg-power-ramp-label'
-                }, `${arrow} ${pctStart}%→${pctEnd}%`));
-            });
-
-            // Subtle filled area under the curve — helps read overall level
-            const areaPts = [`${xForT(hist[0].at)},${powerYBase}`];
-            for (let k = 0; k < hist.length; k++) {
-                const x = xForT(hist[k].at);
-                const y = yForPct(hist[k].pct);
-                areaPts.push(`${x},${y}`);
-                if (k < hist.length - 1) {
-                    const xNext = xForT(hist[k+1].at);
-                    areaPts.push(`${xNext},${y}`);
-                }
-            }
-            areaPts.push(`${LEFT + LANE_W},${yForPct(last.pct)}`);
-            areaPts.push(`${LEFT + LANE_W},${powerYBase}`);
-            g.appendChild(svgEl('polygon', {
-                points: areaPts.join(' '),
-                class: 'expov-svg-power-area'
-            }));
-        }
-        // Power label with current value — "@" reads as "at this power"
-        // and avoids confusion with the bullet-separator used elsewhere
-        g.appendChild(svgEl('text', {
-            x: LEFT - 8, y: powerY + powerH / 2 + 3,
-            'text-anchor': 'end',
-            class: 'expov-svg-sublabel'
-        }, `488 @ ${emb.laser_488_pct_now}%`));
-
-        // ---- Dose gauge ----------------------------------------------
-        const doseY = powerYBase + 6;
-        const doseW = LANE_W;
-        g.appendChild(svgEl('rect', {
-            x: LEFT, y: doseY, width: doseW, height: DOSE_H, rx: 2,
-            class: 'expov-svg-dose-track'
-        }));
-        const dosePct = emb.dose_used_ms / emb.dose_budget_ms;
-        const fillCls = dosePct > 0.85 ? 'expov-svg-dose-fill-crit'
-                      : dosePct > 0.60 ? 'expov-svg-dose-fill-warn'
-                      : 'expov-svg-dose-fill-ok';
-        g.appendChild(svgEl('rect', {
-            x: LEFT, y: doseY, width: Math.max(1, doseW * dosePct), height: DOSE_H, rx: 2,
-            class: fillCls
-        }));
-        // Dose label (shows 10× hint for calibration role)
-        const doseLabel = emb.role === 'calibration' ? 'dose (10×)' : 'dose';
-        g.appendChild(svgEl('text', {
-            x: LEFT - 8, y: doseY + DOSE_H - 2,
-            'text-anchor': 'end',
-            class: 'expov-svg-sublabel'
-        }, doseLabel));
-        // Inside the bar: usage figure — "used of budget" is more scannable
-        // than "x / y s" which reads like a fraction
-        const usedS = (emb.dose_used_ms / 1000).toFixed(1);
-        const budgetS = (emb.dose_budget_ms / 1000).toFixed(1);
-        const doseText = emb.dose_budget_ms > 0
-            ? `${usedS}s of ${budgetS}s (${Math.round(dosePct * 100)}%)`
-            : `${usedS}s used`;
-        g.appendChild(svgEl('text', {
-            x: LEFT + 6, y: doseY + DOSE_H - 2,
-            class: 'expov-svg-dose-text'
-        }, doseText));
-
-        return g;
-    },
 
     // =================================================================
     // Operation Spine — data-driven plan renderer (replaces swimlanes)
@@ -1261,7 +358,7 @@ const ExperimentOverview = {
 
     // Render a single tactic node.
     _renderOpsTactic(t, idx, firstPlannedIdx, ESC) {
-        const STATE_LABEL = { done: 'done', active: 'in use', planned: 'queued' };
+        const STATE_LABEL = { done: 'done', active: 'in use', planned: 'queued', paused: 'paused' };
         const seq = String(t.seq || idx + 1).padStart(2, '0');
         const stateLabel = STATE_LABEL[t.state] || t.state;
         // First queued tactic gets a "next" badge — COCKED instrument marker.
@@ -1300,6 +397,23 @@ const ExperimentOverview = {
             inner += this._renderOpsKindPlanned(t, ESC);
         }
 
+        // Fix #1: surface flat live.* telemetry keys not covered by structured
+        // readouts/phases.  Render for active (in-progress telemetry) and done
+        // (completion data such as sustained_hz, mp4_path, last_fired).
+        // Skip planned — no live data is bound yet.
+        if (t.state === 'active' || t.state === 'done') {
+            const SKIP = new Set(['readouts', 'phases', 'target', 'summary', 'desc']);
+            const flatEntries = Object.entries(live).filter(([k]) => !SKIP.has(k));
+            if (flatEntries.length) {
+                const humanKey = k => k.replace(/_/g, ' ');
+                const pairs = flatEntries.map(([k, v]) => {
+                    const vStr = v == null ? '—' : String(v);
+                    return `<span class="ops-lf-pair"><span class="ops-lf-k">${ESC(humanKey(k))}</span><span class="ops-lf-v">${ESC(vStr)}</span></span>`;
+                }).join('');
+                inner += `<div class="ops-livefacts">${pairs}</div>`;
+            }
+        }
+
         return `
             <div class="ops-node ${ESC(t.state)}">
                 <div class="ops-stagelab">${seq} · ${stateLabel}${nextBadge ? ' ' + nextBadge : ''}</div>

From b98a041fc4560b5366aea39c89e8c02ed00df0aa Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:38:43 +0530
Subject: [PATCH 222/314] chore: untrack SDD scratch doc accidentally committed

---
 .superpowers/sdd/dv3-whole-branch-fixes.md | 109 ---------------------
 1 file changed, 109 deletions(-)
 delete mode 100644 .superpowers/sdd/dv3-whole-branch-fixes.md

diff --git a/.superpowers/sdd/dv3-whole-branch-fixes.md b/.superpowers/sdd/dv3-whole-branch-fixes.md
deleted file mode 100644
index 5ec58d80..00000000
--- a/.superpowers/sdd/dv3-whole-branch-fixes.md
+++ /dev/null
@@ -1,109 +0,0 @@
-# dv3 whole-branch review fixes — backend half
-
-Agent: backend-fixes agent (this session).
-Commit: see footer.
-Frontend fixes (experiment-overview.js + css): separate agent, not touched here.
-
----
-
-## Fix #2 — agent prompt guidance to declare the Operation Plan
-
-**File:** `gently/harness/prompts/templates.py`
-
-Added constant `OPERATION_PLAN_GUIDANCE` (~line 225) and injected `{OPERATION_PLAN_GUIDANCE}`
-into the system template f-string right after `{REACTIVE_MONITORING_MODES}` (~line 510).
-The block tells the agent to call `declare_operation_plan` at experiment planning time
-with kind/name/target/scope/rationale + a `live` object (`readouts`/`phases` + flat keys),
-and to re-call (patch) on each tactic transition. Also notes that execution tools
-(`queue_burst`, `enable_monitoring_mode`, etc.) accept `tactic_id` and flip state automatically.
-
----
-
-## Fix #3 — wire operation-plan seeding in exit_plan_mode
-
-**File:** `gently/app/agent.py`, `exit_plan_mode()` (~line 475)
-
-Hook site confirmed: inside `if active_id:` block, right after the `link_session_campaign`
-try/except (line ~464-469). At that point `self.context_store` and `self.session_id` are
-guaranteed valid (context_store is used unguarded at `get_plan_item` one line above).
-
-Added:
-```python
-try:
-    from gently.app.tools.operation_plan_seed import seed_operation_plan_from_plan_item
-    seed_operation_plan_from_plan_item(self.context_store, self.session_id)
-except Exception:
-    logger.exception("operation-plan seeding failed")
-```
-
----
-
-## Fix #4 — queue_burst phantom-active on soft-reject
-
-**File:** `gently/app/tools/timelapse_tools.py` (~line 1204)
-
-`orchestrator.queue_burst` returns `"Burst queued for {embryo_id} (request_id=..., ...)"` on
-success and a rejection sentence (embryo not in timelapse / already had burst / already queued)
-on soft-reject. Success is reliably distinguishable by `result.startswith("Burst queued for ")`.
-
-Guard applied:
-```python
-if tactic_id and isinstance(result, str) and result.startswith("Burst queued for "):
-    cs.transition_tactic(session, tactic_id, "active")
-```
-
-New test added to `tests/test_tool_tactic_linkage.py`:
-`test_queue_burst_soft_reject_does_not_transition` — fake orchestrator returns
-`"Embryo 'emb1' already has a queued burst."` → verifies `cs.transitions == []`.
-
----
-
-## Fix #5 — `paused` valid state
-
-**File:** `gently/app/tools/operation_plan_tools.py`, line 29
-
-`_VALID_STATES` extended: `frozenset({"planned", "active", "done", "paused"})`.
-`pause_timelapse` transitions to `"paused"` — this was previously an invalid state
-causing a ValueError on validation.
-
----
-
-## Fix #7 — document `live` in the spec
-
-**File:** `docs/superpowers/specs/2026-06-28-operations-tab-design.md`, §1
-
-Added `live` field to the tactic schema block with `readouts`/`phases` sub-keys and
-a documentation paragraph explaining that the agent authors `readouts`/`phases` at
-declaration time and the updater merges flat bound keys (`request_id`, `sustained_hz`,
-`setpoint`, `locked`, `last_fired`, `new_phase`, …) as telemetry arrives.
-
----
-
-## Fix #8 — transition_tactic single-loop note
-
-**File:** `gently/harness/memory/file_store.py`, `transition_tactic` docstring (~line 847)
-
-Added one-line note: "read-modify-write with no lock; safe because all subscribed event
-emissions run on the single asyncio loop thread — revisit if a worker-thread emitter
-is ever added."
-
----
-
-## Test results
-
-```
-pytest tests/test_operation_plan_tool.py tests/test_tool_tactic_linkage.py \
-       tests/test_operation_plan_seeding.py tests/test_operation_plan_store.py -v
-65 passed, 0 failed
-```
-
-Full suite (excluding 3 pre-existing collection errors in test_campaign_coordination.py,
-test_gently_store.py, test_text_tool_call_extraction.py):
-- Before changes: 32 failed, 673 passed, 19 skipped
-- After changes:  32 failed, 674 passed, 19 skipped  (+1 new test, 0 new failures)
-
----
-
-## Commit
-
-`fix(operations): wire seeding + agent plan guidance + queue_burst guard + paused state + docs`

From 3a2bda6e28ec17f95de6f0279dfe0f9835d7e4f8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:39:20 +0530
Subject: [PATCH 223/314] chore: gitignore .superpowers SDD scratch (untrack
 accidentally-committed reports)

---
 .gitignore                            |  1 +
 .superpowers/sdd/dv3-task-7-report.md | 85 ---------------------------
 2 files changed, 1 insertion(+), 85 deletions(-)
 delete mode 100644 .superpowers/sdd/dv3-task-7-report.md

diff --git a/.gitignore b/.gitignore
index f9a50443..34a7c3b7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -149,3 +149,4 @@ gently/ui/tui/dist/
 # Stray local storage: GENTLY_STORAGE_PATH default (D:\Gently3) resolves
 # literally to ./D:/ under the repo on Linux. Not data we track.
 /D:/
+.superpowers/
diff --git a/.superpowers/sdd/dv3-task-7-report.md b/.superpowers/sdd/dv3-task-7-report.md
deleted file mode 100644
index 033112fe..00000000
--- a/.superpowers/sdd/dv3-task-7-report.md
+++ /dev/null
@@ -1,85 +0,0 @@
-# Task 7 Report: tactic_id threading + start-edge marking in execution tools
-
-## Call sites changed
-
-### `gently/app/orchestration/exclusive.py`
-
-**`BurstAcquisition.__init__`** (line ~95)
-- Added `tactic_id: str | None = None` kwarg; stored as `self._tactic_id`.
-- `BURST_START` event data (line ~127): added `"tactic_id": self._tactic_id`.
-- `BURST_COMPLETE` event data (line ~229): added `"tactic_id": self._tactic_id`.
-
-### `gently/app/orchestration/temperature_protocol.py`
-
-**`run_temp_change_burst_protocol`** signature (line 22)
-- Added `tactic_id=None` to the keyword-only params.
-- `TEMP_PROTOCOL_STARTED` event data (line ~41): added `"tactic_id": tactic_id`.
-- `TEMP_PROTOCOL_COMPLETED` event data (line ~67): added `"tactic_id": tactic_id`.
-
-### `gently/app/orchestration/timelapse.py`
-
-**`queue_burst`** method (line ~2056)
-- Added `tactic_id: str | None = None` to signature.
-- Passes `tactic_id=tactic_id` into `BurstAcquisition(...)` constructor (line ~2098).
-
-### `gently/app/tools/timelapse_tools.py`
-
-**`enable_monitoring_mode`** (line ~1025)
-- Added `tactic_id: str | None = None`.
-- On success: resolves `cs = getattr(agent, "context_store", None)`, `session = getattr(agent, "session_id", None)`; calls `cs.transition_tactic(session, tactic_id, "active")` (guarded).
-
-**`queue_burst`** tool (line ~1150)
-- Added `tactic_id: str | None = None`.
-- Passes `tactic_id=tactic_id` to `orchestrator.queue_burst(...)`.
-- After successful enqueue: calls `cs.transition_tactic(session, tactic_id, "active")` (guarded).
-
-**`stop_timelapse`** (line ~270)
-- Added `tactic_id: str | None = None`.
-- After successful stop: calls `cs.transition_tactic(session, tactic_id, "done")` (guarded).
-
-**`pause_timelapse`** (line ~293)
-- Added `tactic_id: str | None = None`.
-- After successful pause: calls `cs.transition_tactic(session, tactic_id, "paused")` (guarded).
-
-### `gently/app/tools/temperature_protocol_tools.py`
-
-**`run_temp_change_burst_protocol_tool`** (line 40)
-- Added `tactic_id: str | None = None`.
-- Before `asyncio.create_task`: calls `cs.transition_tactic(session, tactic_id, "active")` (guarded).
-- Passes `tactic_id=tactic_id` into `_driver(...)` (the `run_temp_change_burst_protocol` coroutine).
-
-## How the transition + event threading work
-
-1. **Start edge (tool → store)**: Tool layer resolves the context store via `getattr(agent, "context_store", None)` and session via `getattr(agent, "session_id", None)` — the same pattern as `declare_operation_plan`. If both are present and `tactic_id` is truthy, `transition_tactic` flips the plan tactic to `"active"`. This happens synchronously (before the background driver spawns for the temp protocol, after enqueue for bursts).
-
-2. **Event threading (orchestration → bus)**: The `tactic_id` is included in `BURST_START`, `BURST_COMPLETE`, `TEMP_PROTOCOL_STARTED`, and `TEMP_PROTOCOL_COMPLETED` event `data` dicts. Task 8's `OperationPlanUpdater` subscribes to these events and can resolve the tactic by `data["tactic_id"]` to flip it to `"done"`.
-
-3. **Backward compatibility**: All `tactic_id` params default to `None`. Every transition call is guarded: `if tactic_id: cs = ...; if cs and session: cs.transition_tactic(...)`. When `tactic_id` is absent, no store access occurs and the tool behaves identically to before.
-
-## TDD evidence
-
-`tests/test_tool_tactic_linkage.py` — 20 tests, all pass.
-
-Coverage:
-- `enable_monitoring_mode` with/without tactic_id (+ no-cs guard)
-- `queue_burst` (tool) with/without tactic_id; tactic_id forwarded to orchestrator
-- `stop_timelapse` with/without tactic_id
-- `pause_timelapse` with/without tactic_id
-- `BurstAcquisition._tactic_id` stored; `BURST_START` and `BURST_COMPLETE` events contain `tactic_id`
-- `run_temp_change_burst_protocol_tool` with/without tactic_id
-- `TEMP_PROTOCOL_STARTED`/`TEMP_PROTOCOL_COMPLETED` carry tactic_id (including `None` backward-compat)
-
-Full suite (excluding 3 pre-existing broken collection targets): **638 passed, 19 skipped** — same count as before Task 7; no new failures.
-
-## Files changed
-
-- `gently/app/orchestration/exclusive.py`
-- `gently/app/orchestration/temperature_protocol.py`
-- `gently/app/orchestration/timelapse.py`
-- `gently/app/tools/timelapse_tools.py`
-- `gently/app/tools/temperature_protocol_tools.py`
-- `tests/test_tool_tactic_linkage.py` (new)
-
-## Concerns
-
-None. All changes are purely additive (new optional kwarg, guarded call). The `@tool` decorator wraps sync functions as async coroutines — tests call them with keyword args and `await`; microscope-required tools need a `"client"` in the test context dict (FakeMicroscope provided).

From 286e95e99acd9f471ff166acfa50d54ef5ee8f65 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:42:57 +0530
Subject: [PATCH 224/314] =?UTF-8?q?docs(tactics-library):=20spec=20+=20pla?=
 =?UTF-8?q?n=20(G,=203=20tasks)=20=E2=80=94=20save/reuse=20typed=20tactics?=
 =?UTF-8?q?=20on=20D's=20substrate?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../plans/2026-06-28-tactics-library.md       | 35 ++++++++++++
 .../2026-06-28-tactics-library-design.md      | 57 +++++++++++++++++++
 2 files changed, 92 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-28-tactics-library.md
 create mode 100644 docs/superpowers/specs/2026-06-28-tactics-library-design.md

diff --git a/docs/superpowers/plans/2026-06-28-tactics-library.md b/docs/superpowers/plans/2026-06-28-tactics-library.md
new file mode 100644
index 00000000..a845bfa8
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-28-tactics-library.md
@@ -0,0 +1,35 @@
+# Tactics Library (G) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development. Steps use `- [ ]`.
+
+**Goal:** Save / list / apply typed tactics (D's tactic objects) as reusable templates — a near-copy of the plan-template pattern.
+
+**Architecture:** A tactic-library domain in `FileContextStore` (save/list/get/apply), agent tools, and a read route — mirroring `save_plan_template`/`apply_plan_template`.
+
+## Global Constraints
+- Mirror the plan-template pattern: `_plans.py:551-667` (`save_plan_template`/`list_plan_templates`/`get_plan_template`/`apply_plan_template`) + `plan_mode/tools/templates.py`.
+- A saved tactic is a TEMPLATE (planned form): `{id,name,slug,kind,structure,scope_hint?,description,params?,created_at,created_by}` — NO live state. `apply_tactic` returns a fresh planned tactic (new run id, state="planned", no `live`).
+- Store domain `agent/tactic_library/{id}_{slug}.yaml`; fire `CONTEXT_UPDATED`.
+- Git hygiene: stage only your files by explicit path; never `git add -A`.
+
+---
+
+### Task 1: Tactic-library store domain
+**Files:** Modify `gently/harness/memory/file_store.py` (or `_plans.py` if templates live there) — add `save_tactic(tactic, name=None) -> str`, `list_tactics() -> list[dict]`, `get_tactic(id_or_name) -> dict | None`, `apply_tactic(id_or_name) -> dict | None`. Test: `tests/test_tactic_library_store.py`.
+- [ ] Confirm the exact plan-template implementation (`_plans.py:551-667`) — the id/slug generation, the YAML write helper, the `_notify`/`CONTEXT_UPDATED` emit — and mirror it for tactics at `agent/tactic_library/`. `apply_tactic` returns a deep copy with a fresh `id` (e.g. `tac_<8hex>`), `state="planned"`, and `live`/run-state stripped.
+- [ ] TDD: save a tactic → list shows it → get returns it → apply returns a fresh planned tactic (new id, no live, state=planned); get/apply unknown → None. `pytest tests/test_tactic_library_store.py -v`; `pytest -q` clean. Commit `feat(tactics-library): tactic-library store domain (save/list/get/apply)`.
+
+### Task 2: Agent tools
+**Files:** Create `gently/app/tools/tactic_library_tools.py` (+ register in `tools/__init__`). Test: `tests/test_tactic_library_tools.py`.
+- [ ] Mirror `plan_mode/tools/templates.py` (the `@tool` usage + store resolution from context). Tools: `save_tactic(name, tactic, description="")` → `store.save_tactic`; `list_tactics()` → `store.list_tactics`; `apply_tactic(id_or_name)` → `store.apply_tactic` then append the planned tactic to the current Operation Plan (`get_operation_plan(session)` → append → `set_operation_plan`; create a minimal plan if none). Resolve the context store + session from the agent (as `declare_operation_plan` does). Register the module.
+- [ ] TDD (fake context store + session): save persists; apply adds a planned tactic to the current Operation Plan; list returns the library; missing store → error. `pytest tests/test_tactic_library_tools.py -v`; `pytest -q` clean. Commit `feat(tactics-library): save/list/apply_tactic agent tools`.
+
+### Task 3: Route `GET /api/tactic_library`
+**Files:** Create `gently/ui/web/routes/tactic_library.py` (+ register in `routes/__init__.py`). Test: `tests/test_tactic_library_route.py`.
+- [ ] Mirror `routes/operation_plan.py` — resolve `server.context_store`, return `{tactics: store.list_tactics()}`; empty list when none. Register the router.
+- [ ] TDD (TestClient + mock store): returns the library; empty when none. `pytest tests/test_tactic_library_route.py -v`; `pytest -q` clean. Commit `feat(tactics-library): GET /api/tactic_library route`.
+
+## Self-Review
+- Store→Task1; tools→Task2; route→Task3. ✓
+- Open confirmations: the plan-template implementation to mirror (T1), the `@tool` + store/session resolution (T2), the route store handle (T3).
+- Type consistency: the saved-tactic dict shape is identical across store (T1), tools (T2), route (T3); `apply_tactic`'s fresh planned tactic matches D's tactic schema.
diff --git a/docs/superpowers/specs/2026-06-28-tactics-library-design.md b/docs/superpowers/specs/2026-06-28-tactics-library-design.md
new file mode 100644
index 00000000..3bd2ac37
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-28-tactics-library-design.md
@@ -0,0 +1,57 @@
+# Design: Tactics library (sub-project G)
+
+Status: design decided 2026-06-28. Base branch: off `feature/operations-tab` (D) — G reuses D's
+typed tactic objects (the Operation Plan substrate). Mirrors the existing **plan-template** pattern
+(`_plans.py:551-667`, `plan_mode/tools/templates.py`).
+
+## 0. Why G is now small
+
+D made tactics **typed, agent-authored objects** (kind/structure/scope/live/relations). So a "tactics
+library" is just **save / list / apply those typed tactic objects** — a near-copy of how plan
+templates are already saved/applied. No new conceptual model; it's the reuse layer over D.
+
+## 1. The saved tactic
+
+```
+saved_tactic = {
+  id, name, slug, kind,            # kind ∈ D's tactic kinds
+  structure,                       # the tactic's structure (phases/cadence/watch) sans live state
+  scope_hint?,                     # default scope (global/embryos)
+  description, params?,            # human description + default params
+  created_at, created_by           # 'agent' | 'human'
+}
+```
+Stored at `agent/tactic_library/{id}_{slug}.yaml` (a new FileContextStore domain), mirroring the
+plan-template store. A saved tactic is a *template* — the planned form of a tactic, with no live
+state (no `live`, no `id`-per-run).
+
+## 2. Architecture (three units, mirroring plan templates)
+
+### 2.1 Store — `FileContextStore`
+Add `save_tactic(tactic, name=None) -> id`, `list_tactics() -> list[dict]`, `get_tactic(id_or_name)`,
+`apply_tactic(id_or_name) -> dict` (returns a fresh planned tactic — new run id, `state:"planned"`,
+no `live`). Mirror `save_plan_template`/`list_plan_templates`/`get_plan_template`/`apply_plan_template`
+(`_plans.py:551-667`) — same id/slug, YAML, atomic write. Fire `CONTEXT_UPDATED`.
+
+### 2.2 Tools — `gently/app/tools/tactic_library_tools.py`
+- `save_tactic(name, tactic, description="")` — persist a tactic template (the agent passes a tactic
+  dict, e.g. lifted from the current Operation Plan, or authored fresh).
+- `list_tactics()` — the library.
+- `apply_tactic(id_or_name)` — instantiate a fresh planned tactic and **add it to the current
+  Operation Plan** (`get_operation_plan` → append the planned tactic → `set_operation_plan`), so a
+  saved tactic flows straight into the active plan. Mirror `plan_mode/tools/templates.py`.
+
+### 2.3 Route — `GET /api/tactic_library`
+Mirror `routes/operation_plan.py`; returns `{tactics:[...]}` from `list_tactics()`. For a future
+browse UI; the tools are the primary surface for now.
+
+## 3. Out of scope
+- A dedicated library browse/edit UI (the tools + chat suffice for v1; a panel is a follow-on).
+- Tactic *sets*/composites (save a whole plan as a named operation template) — a natural extension
+  once single-tactic save/apply lands; defer.
+- Sharing/export across machines.
+
+## 4. Testing
+- Store: save→list→get→apply round-trip; apply returns a fresh planned tactic (new id, no live state).
+- Tools: save persists; apply adds a planned tactic to the current Operation Plan; list returns the library.
+- Route: returns the library; empty when none.

From 126de2c3e1cee64308c984f20fc1cc485a9e8dd4 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:48:21 +0530
Subject: [PATCH 225/314] feat(tactics-library): tactic-library store domain
 (save/list/get/apply)

Add save_tactic/list_tactics/get_tactic/apply_tactic to FileContextStore,
mirroring the plan-template pattern. Templates live at
agent/tactic_library/{id}_{slug}.yaml; apply returns a fresh planned
tactic (new id, state=planned, no live). Fires CONTEXT_UPDATED.
33 TDD tests, all passing.
---
 gently/harness/memory/file_store.py |  88 ++++++++++
 tests/test_tactic_library_store.py  | 253 ++++++++++++++++++++++++++++
 2 files changed, 341 insertions(+)
 create mode 100644 tests/test_tactic_library_store.py

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 7a9eba4e..eab691fc 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1793,6 +1793,94 @@ def delete_plan_template(self, template_id: str) -> bool:
                         return True
         return False
 
+    # ==================================================================
+    # Tactic Library
+    # ==================================================================
+
+    def save_tactic(self, tactic: dict, name: str | None = None) -> str:
+        """Persist a tactic as a reusable template in agent/tactic_library/.
+
+        Strips runtime state (live, state, original id) and assigns a new
+        template id + slug. Fires CONTEXT_UPDATED. Returns the template id.
+        """
+        name = name or tactic.get("name") or "unnamed"
+        slug = self._slugify(name)
+        tid = self._gen_id()
+        now = self._now()
+
+        template = {
+            "id": tid,
+            "name": name,
+            "slug": slug,
+            "kind": tactic.get("kind", "unknown"),
+            "structure": copy.deepcopy(tactic.get("structure") or {}),
+            "scope_hint": copy.deepcopy(tactic.get("scope")),
+            "description": tactic.get("description") or tactic.get("rationale"),
+            "params": copy.deepcopy(tactic.get("params")),
+            "relations": copy.deepcopy(tactic.get("relations") or {}),
+            "live_bind": list(tactic.get("live_bind") or []),
+            "created_at": now,
+            "created_by": tactic.get("created_by", "agent"),
+        }
+
+        path = self.agent_dir / "tactic_library" / f"{tid}_{slug}.yaml"
+        self._write_yaml(path, template)
+        self._notify_context_change("tactic_library")
+        logger.info(f"Saved tactic template '{name}' ({tid})")
+        return tid
+
+    def list_tactics(self) -> list[dict]:
+        """List all saved tactic templates, ordered by created_at descending."""
+        tl_dir = self.agent_dir / "tactic_library"
+        if not tl_dir.exists():
+            return []
+        tactics: list[dict] = []
+        for f in tl_dir.iterdir():
+            if f.suffix in (".yaml", ".yml"):
+                data = self._read_yaml(f)
+                if data:
+                    tactics.append(data)
+        tactics.sort(key=lambda t: t.get("created_at", ""), reverse=True)
+        return tactics
+
+    def get_tactic(self, id_or_name: str) -> dict | None:
+        """Return a tactic template by id or name, or None if not found."""
+        tl_dir = self.agent_dir / "tactic_library"
+        if not tl_dir.exists():
+            return None
+        for f in tl_dir.iterdir():
+            if f.suffix in (".yaml", ".yml"):
+                data = self._read_yaml(f)
+                if data and (data.get("id") == id_or_name or data.get("name") == id_or_name):
+                    return data
+        return None
+
+    def apply_tactic(self, id_or_name: str) -> dict | None:
+        """Return a fresh planned tactic from a saved template.
+
+        The returned dict has a new run id (distinct from the template id),
+        state="planned", and no live/runtime state. Returns None if the
+        template is not found.
+        """
+        tmpl = self.get_tactic(id_or_name)
+        if tmpl is None:
+            return None
+        tactic = copy.deepcopy(tmpl)
+        # Assign a new run id — must differ from the template id
+        tactic["id"] = self._gen_id()
+        tactic["state"] = "planned"
+        # Promote scope_hint back to scope for the tactic
+        scope_hint = tactic.pop("scope_hint", None)
+        if scope_hint is not None:
+            tactic["scope"] = scope_hint
+        # Strip template-internal metadata
+        tactic.pop("slug", None)
+        tactic.pop("created_at", None)
+        tactic.pop("created_by", None)
+        # Strip runtime state (should not exist in a template, but guard anyway)
+        tactic.pop("live", None)
+        return tactic
+
     # ==================================================================
     # Plan Snapshots
     # ==================================================================
diff --git a/tests/test_tactic_library_store.py b/tests/test_tactic_library_store.py
new file mode 100644
index 00000000..4a92acc5
--- /dev/null
+++ b/tests/test_tactic_library_store.py
@@ -0,0 +1,253 @@
+"""
+FileContextStore — Tactic Library store domain TDD tests.
+
+Tests: save_tactic / list_tactics / get_tactic / apply_tactic
+
+Round-trip: save → list → get → apply returns a fresh planned tactic
+(new id != template id, state="planned", no "live" key).
+get/apply unknown → None.
+"""
+
+import copy
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# Shared tactic fixture
+# ---------------------------------------------------------------------------
+
+_TACTIC = {
+    "id": "t_original",
+    "name": "Baseline timelapse",
+    "kind": "standing_timelapse",
+    "state": "active",
+    "scope": {"mode": "global"},
+    "rationale": "Establish pre-ramp cadence",
+    "structure": {"cadence_s": 120},
+    "live_bind": ["cadence"],
+    "relations": {},
+    "live": {"request_id": "req_abc", "started_at": "2026-06-28T10:00:00"},
+}
+
+
+def _fresh_tactic():
+    return copy.deepcopy(_TACTIC)
+
+
+# ---------------------------------------------------------------------------
+# save_tactic
+# ---------------------------------------------------------------------------
+
+
+class TestSaveTactic:
+    def test_returns_string_id(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        assert isinstance(tid, str)
+        assert len(tid) > 0
+
+    def test_id_differs_from_original(self, file_context_store):
+        """Template id must not equal the source tactic's original id."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        assert tid != "t_original"
+
+    def test_name_param_overrides_tactic_name(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic(), name="Custom Name")
+        tmpl = file_context_store.get_tactic(tid)
+        assert tmpl["name"] == "Custom Name"
+
+    def test_name_falls_back_to_tactic_name(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tmpl = file_context_store.get_tactic(tid)
+        assert tmpl["name"] == "Baseline timelapse"
+
+    def test_live_state_stripped(self, file_context_store):
+        """The 'live' key must not appear in the saved template."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tmpl = file_context_store.get_tactic(tid)
+        assert "live" not in tmpl
+
+    def test_run_state_not_preserved(self, file_context_store):
+        """'state' from the source tactic (active) is not stored as the template state."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tmpl = file_context_store.get_tactic(tid)
+        # Template itself doesn't carry 'state'; it's restored on apply
+        assert tmpl.get("state") is None or tmpl.get("state") == "planned"
+
+    def test_structure_preserved(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tmpl = file_context_store.get_tactic(tid)
+        assert tmpl["structure"] == {"cadence_s": 120}
+
+    def test_kind_preserved(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tmpl = file_context_store.get_tactic(tid)
+        assert tmpl["kind"] == "standing_timelapse"
+
+    def test_file_created(self, file_context_store):
+        """A YAML file must exist in tactic_library/ after saving."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tl_dir = file_context_store.agent_dir / "tactic_library"
+        files = list(tl_dir.iterdir())
+        assert any(f.stem.startswith(tid) for f in files)
+
+    def test_fires_context_updated(self, file_context_store):
+        """save_tactic must fire CONTEXT_UPDATED."""
+        from gently.core.event_bus import EventType, on
+
+        seen = []
+        unsub = on(EventType.CONTEXT_UPDATED, lambda e: seen.append(e))
+        try:
+            file_context_store.save_tactic(_fresh_tactic())
+        finally:
+            unsub()
+        assert len(seen) >= 1
+
+
+# ---------------------------------------------------------------------------
+# list_tactics
+# ---------------------------------------------------------------------------
+
+
+class TestListTactics:
+    def test_empty_when_none_saved(self, file_context_store):
+        assert file_context_store.list_tactics() == []
+
+    def test_one_entry_after_save(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic())
+        result = file_context_store.list_tactics()
+        assert len(result) == 1
+
+    def test_two_entries_after_two_saves(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic(), name="Alpha")
+        file_context_store.save_tactic(_fresh_tactic(), name="Beta")
+        result = file_context_store.list_tactics()
+        assert len(result) == 2
+
+    def test_entries_contain_id_and_name(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        result = file_context_store.list_tactics()
+        assert result[0]["id"] == tid
+        assert result[0]["name"] == "Baseline timelapse"
+
+    def test_ordered_newest_first(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic(), name="First")
+        file_context_store.save_tactic(_fresh_tactic(), name="Second")
+        result = file_context_store.list_tactics()
+        # Newest should appear first (sorted by created_at desc)
+        names = [r["name"] for r in result]
+        assert names[0] == "Second"
+
+
+# ---------------------------------------------------------------------------
+# get_tactic
+# ---------------------------------------------------------------------------
+
+
+class TestGetTactic:
+    def test_get_by_id(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        result = file_context_store.get_tactic(tid)
+        assert result is not None
+        assert result["id"] == tid
+
+    def test_get_by_name(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic())
+        result = file_context_store.get_tactic("Baseline timelapse")
+        assert result is not None
+        assert result["kind"] == "standing_timelapse"
+
+    def test_get_unknown_returns_none(self, file_context_store):
+        result = file_context_store.get_tactic("no_such_tactic")
+        assert result is None
+
+    def test_get_unknown_id_returns_none(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic())
+        result = file_context_store.get_tactic("deadbeef")
+        assert result is None
+
+
+# ---------------------------------------------------------------------------
+# apply_tactic
+# ---------------------------------------------------------------------------
+
+
+class TestApplyTactic:
+    def test_apply_by_id_returns_dict(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert isinstance(applied, dict)
+
+    def test_apply_by_name_returns_dict(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic("Baseline timelapse")
+        assert isinstance(applied, dict)
+
+    def test_apply_unknown_returns_none(self, file_context_store):
+        result = file_context_store.apply_tactic("no_such_tactic")
+        assert result is None
+
+    def test_apply_unknown_id_returns_none(self, file_context_store):
+        file_context_store.save_tactic(_fresh_tactic())
+        result = file_context_store.apply_tactic("deadbeef")
+        assert result is None
+
+    def test_applied_id_differs_from_template_id(self, file_context_store):
+        """apply_tactic must return a FRESH id, distinct from the template id."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied["id"] != tid
+
+    def test_applied_id_differs_from_source_tactic_id(self, file_context_store):
+        """Applied id must not equal the original source tactic's id either."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied["id"] != "t_original"
+
+    def test_applied_state_is_planned(self, file_context_store):
+        """Returned tactic must have state='planned' regardless of template source state."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied["state"] == "planned"
+
+    def test_applied_has_no_live_key(self, file_context_store):
+        """Returned tactic must not carry any 'live' runtime state."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert "live" not in applied
+
+    def test_applied_structure_matches_template(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied["structure"] == {"cadence_s": 120}
+
+    def test_applied_kind_matches_template(self, file_context_store):
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied["kind"] == "standing_timelapse"
+
+    def test_applied_is_independent_copy(self, file_context_store):
+        """Mutating the applied tactic must not affect a second apply call."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        first = file_context_store.apply_tactic(tid)
+        first["structure"]["cadence_s"] = 999
+        second = file_context_store.apply_tactic(tid)
+        assert second["structure"]["cadence_s"] == 120
+
+    def test_two_applies_have_different_ids(self, file_context_store):
+        """Each apply call returns a fresh id."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        a1 = file_context_store.apply_tactic(tid)
+        a2 = file_context_store.apply_tactic(tid)
+        assert a1["id"] != a2["id"]
+
+    def test_applied_no_slug_metadata(self, file_context_store):
+        """Template-internal 'slug' must not appear in the applied tactic."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert "slug" not in applied
+
+    def test_applied_no_created_at(self, file_context_store):
+        """Template 'created_at' must not bleed into the applied tactic."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert "created_at" not in applied

From e25798d8c46ed26748e3a42906d13cbad58401ee Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:52:55 +0530
Subject: [PATCH 226/314] feat(tactics-library): save/list/apply_tactic agent
 tools

Three @tool functions (ToolCategory.EXPERIMENT) over FileContextStore's
tactic library: save_tactic persists a tactic dict as a reusable template,
list_tactics returns a readable id/name/kind summary, apply_tactic
instantiates a fresh planned tactic and appends it to the session's
Operation Plan (creating a minimal plan if none exists). Store + session
resolution mirrors declare_operation_plan. Registered in tools/__init__.py.
TDD: 21 tests, all green.
---
 gently/app/tools/__init__.py             |   2 +
 gently/app/tools/tactic_library_tools.py | 198 ++++++++++++
 tests/test_tactic_library_tools.py       | 371 +++++++++++++++++++++++
 3 files changed, 571 insertions(+)
 create mode 100644 gently/app/tools/tactic_library_tools.py
 create mode 100644 tests/test_tactic_library_tools.py

diff --git a/gently/app/tools/__init__.py b/gently/app/tools/__init__.py
index b3b31d1b..02db9d7c 100644
--- a/gently/app/tools/__init__.py
+++ b/gently/app/tools/__init__.py
@@ -43,6 +43,7 @@
     resolution_tools,
     session_tools,
     stage_tools,
+    tactic_library_tools,
     temperature_protocol_tools,
     temperature_tools,
     timelapse_tools,
@@ -89,6 +90,7 @@ def register_all_tools():
     "operation_plan_tools",
     "plan_execution_tools",
     "resolution_tools",
+    "tactic_library_tools",
     "session_tools",
     "stage_tools",
     "temperature_protocol_tools",
diff --git a/gently/app/tools/tactic_library_tools.py b/gently/app/tools/tactic_library_tools.py
new file mode 100644
index 00000000..96a3eee5
--- /dev/null
+++ b/gently/app/tools/tactic_library_tools.py
@@ -0,0 +1,198 @@
+"""
+Tactic Library tools — lets the agent save, list, and apply reusable tactics.
+
+save_tactic  — persist a tactic dict from the current Operation Plan as a
+               reusable template in FileContextStore's tactic_library.
+list_tactics — return a readable summary of all saved templates.
+apply_tactic — instantiate a template into a fresh planned tactic and append
+               it to the current session's Operation Plan.
+
+Store + session resolution mirrors declare_operation_plan in operation_plan_tools.py.
+"""
+
+import logging
+from datetime import datetime, timezone
+
+from gently.harness.tools.helpers import require_agent
+from gently.harness.tools.registry import ToolCategory, ToolExample, tool
+
+logger = logging.getLogger(__name__)
+
+
+@tool(
+    name="save_tactic",
+    description=(
+        "Save a tactic from the current Operation Plan into the Tactic Library "
+        "as a reusable template. Pass the tactic dict (e.g. lifted directly from "
+        "your Operation Plan) and a human-readable name. Runtime state (live, state, "
+        "original id) is stripped; the template receives a new id. "
+        "Returns a confirmation with the new template id."
+    ),
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample(
+            user_query="Save my baseline timelapse tactic to the library",
+            tool_input={
+                "name": "Baseline timelapse",
+                "tactic": {
+                    "id": "t1",
+                    "name": "Baseline timelapse",
+                    "kind": "standing_timelapse",
+                    "state": "active",
+                    "scope": {"mode": "global"},
+                    "rationale": "Continuous pre-ramp imaging",
+                    "structure": {"cadence_s": 120, "per_embryo": []},
+                    "live_bind": ["cadence"],
+                    "relations": {},
+                },
+                "description": "Standard 2-minute cadence baseline timelapse",
+            },
+        )
+    ],
+)
+async def save_tactic(
+    name: str,
+    tactic: dict,
+    description: str = "",
+    context: dict | None = None,
+) -> str:
+    """Save a tactic as a reusable template in the Tactic Library.
+
+    Parameters
+    ----------
+    name : str
+        Human-readable name for the template.
+    tactic : dict
+        The tactic dict to save (e.g. from the current Operation Plan).
+    description : str
+        Optional description; if provided, overrides tactic's rationale field.
+    context : dict
+        Injected by the tool runtime — do not pass manually.
+    """
+    agent, err = require_agent(context)
+    if err:
+        return err
+
+    cs = getattr(agent, "context_store", None)
+    if cs is None:
+        return "Error: Context store not available — cannot save tactic"
+
+    # Merge description into tactic so save_tactic picks it up via tactic.get("description")
+    tactic_to_save = dict(tactic)
+    if description:
+        tactic_to_save["description"] = description
+
+    tid = cs.save_tactic(tactic_to_save, name=name)
+    return f"Tactic '{name}' saved to library with id {tid}"
+
+
+@tool(
+    name="list_tactics",
+    description=(
+        "List all tactics saved in the Tactic Library. "
+        "Returns a summary of each template: id, name, kind."
+    ),
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample(
+            user_query="Show me the tactics in the library",
+            tool_input={},
+        )
+    ],
+)
+async def list_tactics(
+    context: dict | None = None,
+) -> str:
+    """List all saved tactic templates.
+
+    Parameters
+    ----------
+    context : dict
+        Injected by the tool runtime — do not pass manually.
+    """
+    agent, err = require_agent(context)
+    if err:
+        return err
+
+    cs = getattr(agent, "context_store", None)
+    if cs is None:
+        return "Error: Context store not available — cannot list tactics"
+
+    tactics = cs.list_tactics()
+    if not tactics:
+        return "Tactic Library is empty — no saved templates yet."
+
+    lines = [f"Tactic Library ({len(tactics)} template{'s' if len(tactics) != 1 else ''}):"]
+    for t in tactics:
+        lines.append(f"  [{t.get('id', '?')}] {t.get('name', '(unnamed)')} — kind: {t.get('kind', '?')}")
+    return "\n".join(lines)
+
+
+@tool(
+    name="apply_tactic",
+    description=(
+        "Instantiate a saved tactic template and append it to the current session's "
+        "Operation Plan. The template is looked up by id or name, a fresh planned tactic "
+        "is created (new id, state='planned', no runtime state), and it is queued in the "
+        "plan. If no plan exists for this session, a minimal one is created. "
+        "Returns an error if the tactic is not found."
+    ),
+    category=ToolCategory.EXPERIMENT,
+    examples=[
+        ToolExample(
+            user_query="Apply the baseline timelapse tactic to the current session",
+            tool_input={"id_or_name": "Baseline timelapse"},
+        )
+    ],
+)
+async def apply_tactic(
+    id_or_name: str,
+    context: dict | None = None,
+) -> str:
+    """Instantiate a tactic template and append it to the current Operation Plan.
+
+    Parameters
+    ----------
+    id_or_name : str
+        The template id or name to look up.
+    context : dict
+        Injected by the tool runtime — do not pass manually.
+    """
+    agent, err = require_agent(context)
+    if err:
+        return err
+
+    cs = getattr(agent, "context_store", None)
+    if cs is None:
+        return "Error: Context store not available — cannot apply tactic"
+
+    session_id = getattr(agent, "session_id", None)
+    if not session_id:
+        return "Error: No active session — cannot apply tactic to Operation Plan"
+
+    fresh = cs.apply_tactic(id_or_name)
+    if fresh is None:
+        return f"Error: No tactic found with id or name '{id_or_name}'"
+
+    # Fetch or create the plan for this session
+    plan = cs.get_operation_plan(session_id)
+    if plan is None:
+        plan = {
+            "session_id": session_id,
+            "title": "",
+            "goal": "",
+            "tactics": [],
+        }
+
+    plan.setdefault("tactics", [])
+    plan["tactics"].append(fresh)
+    plan["updated_at"] = datetime.now(timezone.utc).isoformat()
+    plan["updated_reason"] = f"tactic '{fresh.get('name', id_or_name)}' applied from library"
+
+    cs.set_operation_plan(session_id, plan)
+
+    tactic_name = fresh.get("name", id_or_name)
+    return (
+        f"Tactic '{tactic_name}' (id {fresh['id']}) instantiated from library and "
+        f"queued as 'planned' in the Operation Plan for session {session_id}"
+    )
diff --git a/tests/test_tactic_library_tools.py b/tests/test_tactic_library_tools.py
new file mode 100644
index 00000000..e1e33dff
--- /dev/null
+++ b/tests/test_tactic_library_tools.py
@@ -0,0 +1,371 @@
+"""
+TDD tests for gently/app/tools/tactic_library_tools.py
+
+Tests:
+- save_tactic: calls store.save_tactic and returns a confirmation with the id
+- list_tactics: returns readable summary from store.list_tactics
+- apply_tactic: fetches template, appends fresh planned tactic to Operation Plan
+- apply_tactic unknown id: returns error, does NOT call set_operation_plan
+- missing context_store: returns error for all three tools
+- tools are importable and registered in the tool registry
+"""
+
+import copy
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# Shared tactic fixture
+# ---------------------------------------------------------------------------
+
+_TACTIC = {
+    "id": "t_original",
+    "name": "Baseline timelapse",
+    "kind": "standing_timelapse",
+    "state": "active",
+    "scope": {"mode": "global"},
+    "rationale": "Continuous pre-ramp imaging",
+    "structure": {"cadence_s": 120, "per_embryo": []},
+    "live_bind": ["cadence"],
+    "relations": {},
+}
+
+
+def _fresh_tactic():
+    return copy.deepcopy(_TACTIC)
+
+
+# ---------------------------------------------------------------------------
+# Fake context store
+# ---------------------------------------------------------------------------
+
+
+class FakeContextStore:
+    """Minimal context store double for tool tests."""
+
+    def __init__(self):
+        self._library: dict[str, dict] = {}  # id -> template
+        self._plans: dict[str, dict] = {}  # session_id -> plan
+        self.save_tactic_calls: list = []
+        self.set_operation_plan_calls: list = []
+
+    def save_tactic(self, tactic: dict, name: str | None = None) -> str:
+        tid = f"tpl_{len(self._library) + 1}"
+        name = name or tactic.get("name") or "unnamed"
+        template = {
+            "id": tid,
+            "name": name,
+            "kind": tactic.get("kind", "unknown"),
+            "description": tactic.get("description") or tactic.get("rationale"),
+        }
+        self._library[tid] = template
+        self.save_tactic_calls.append({"tactic": tactic, "name": name, "returned_id": tid})
+        return tid
+
+    def list_tactics(self) -> list[dict]:
+        return list(self._library.values())
+
+    def get_tactic(self, id_or_name: str) -> dict | None:
+        for t in self._library.values():
+            if t.get("id") == id_or_name or t.get("name") == id_or_name:
+                return copy.deepcopy(t)
+        return None
+
+    def apply_tactic(self, id_or_name: str) -> dict | None:
+        tmpl = self.get_tactic(id_or_name)
+        if tmpl is None:
+            return None
+        # Return a fresh planned tactic with a new id
+        fresh = copy.deepcopy(tmpl)
+        fresh["id"] = f"run_{id_or_name}"
+        fresh["state"] = "planned"
+        return fresh
+
+    def get_operation_plan(self, session_id: str) -> dict | None:
+        return copy.deepcopy(self._plans.get(session_id))
+
+    def set_operation_plan(self, session_id: str, plan: dict) -> None:
+        self._plans[session_id] = copy.deepcopy(plan)
+        self.set_operation_plan_calls.append({"session_id": session_id, "plan": copy.deepcopy(plan)})
+
+
+# ---------------------------------------------------------------------------
+# Fake agent
+# ---------------------------------------------------------------------------
+
+
+class FakeAgent:
+    def __init__(self, session_id="sess_001", context_store=None):
+        self.session_id = session_id
+        self.context_store = context_store or FakeContextStore()
+
+
+def _make_context(agent):
+    return {"agent": agent}
+
+
+# ---------------------------------------------------------------------------
+# Import the tools under test
+# ---------------------------------------------------------------------------
+
+
+from gently.app.tools.tactic_library_tools import (
+    apply_tactic,
+    list_tactics,
+    save_tactic,
+)
+
+
+# ---------------------------------------------------------------------------
+# save_tactic tests
+# ---------------------------------------------------------------------------
+
+
+class TestSaveTactic:
+    @pytest.mark.asyncio
+    async def test_calls_store_save_tactic(self):
+        """save_tactic must call context_store.save_tactic once."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        await save_tactic(
+            name="Baseline timelapse",
+            tactic=_fresh_tactic(),
+            context=_make_context(agent),
+        )
+        assert len(cs.save_tactic_calls) == 1
+
+    @pytest.mark.asyncio
+    async def test_passes_name_through(self):
+        """The name passed to the tool must reach store.save_tactic."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        await save_tactic(
+            name="My custom tactic",
+            tactic=_fresh_tactic(),
+            context=_make_context(agent),
+        )
+        call = cs.save_tactic_calls[0]
+        assert call["name"] == "My custom tactic"
+
+    @pytest.mark.asyncio
+    async def test_returns_confirmation_with_id(self):
+        """Return value must contain the new template id."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        result = await save_tactic(
+            name="Baseline timelapse",
+            tactic=_fresh_tactic(),
+            context=_make_context(agent),
+        )
+        # The id returned by the fake store is "tpl_1"
+        assert "tpl_1" in result
+
+    @pytest.mark.asyncio
+    async def test_description_merged_into_tactic(self):
+        """If description is provided it should be in the tactic passed to the store."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        await save_tactic(
+            name="Baseline timelapse",
+            tactic=_fresh_tactic(),
+            description="Override description",
+            context=_make_context(agent),
+        )
+        saved = cs.save_tactic_calls[0]["tactic"]
+        assert saved.get("description") == "Override description"
+
+    @pytest.mark.asyncio
+    async def test_missing_context_store_returns_error(self):
+        """If context_store is None, return an error string."""
+        agent = FakeAgent(context_store=None)
+        agent.context_store = None
+        result = await save_tactic(
+            name="x",
+            tactic=_fresh_tactic(),
+            context=_make_context(agent),
+        )
+        assert result.startswith("Error:")
+
+    @pytest.mark.asyncio
+    async def test_missing_agent_returns_error(self):
+        result = await save_tactic(name="x", tactic=_fresh_tactic(), context={})
+        assert result.startswith("Error:")
+
+
+# ---------------------------------------------------------------------------
+# list_tactics tests
+# ---------------------------------------------------------------------------
+
+
+class TestListTactics:
+    @pytest.mark.asyncio
+    async def test_returns_readable_summary(self):
+        """list_tactics should include id, name, kind in the output."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        # Pre-populate library
+        cs.save_tactic(_fresh_tactic(), name="Baseline timelapse")
+        result = await list_tactics(context=_make_context(agent))
+        assert "tpl_1" in result
+        assert "Baseline timelapse" in result
+        assert "standing_timelapse" in result
+
+    @pytest.mark.asyncio
+    async def test_empty_library_message(self):
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        result = await list_tactics(context=_make_context(agent))
+        assert "empty" in result.lower() or "no saved" in result.lower()
+
+    @pytest.mark.asyncio
+    async def test_missing_context_store_returns_error(self):
+        agent = FakeAgent(context_store=None)
+        agent.context_store = None
+        result = await list_tactics(context=_make_context(agent))
+        assert result.startswith("Error:")
+
+    @pytest.mark.asyncio
+    async def test_missing_agent_returns_error(self):
+        result = await list_tactics(context={})
+        assert result.startswith("Error:")
+
+
+# ---------------------------------------------------------------------------
+# apply_tactic tests
+# ---------------------------------------------------------------------------
+
+
+class TestApplyTactic:
+    @pytest.mark.asyncio
+    async def test_appends_tactic_to_existing_plan(self):
+        """apply_tactic must append the fresh tactic to the session's Operation Plan."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        # Seed library + existing plan
+        cs.save_tactic(_fresh_tactic(), name="Baseline timelapse")
+        cs._plans["sess_001"] = {
+            "session_id": "sess_001",
+            "title": "Test plan",
+            "goal": "Test goal",
+            "tactics": [],
+        }
+
+        result = await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
+
+        assert len(cs.set_operation_plan_calls) == 1
+        saved_plan = cs.set_operation_plan_calls[0]["plan"]
+        assert len(saved_plan["tactics"]) == 1
+        assert saved_plan["tactics"][0]["state"] == "planned"
+
+    @pytest.mark.asyncio
+    async def test_creates_minimal_plan_if_none_exists(self):
+        """If no plan exists yet, apply_tactic creates a minimal one."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        cs.save_tactic(_fresh_tactic(), name="Baseline timelapse")
+
+        await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
+
+        assert len(cs.set_operation_plan_calls) == 1
+        plan = cs.set_operation_plan_calls[0]["plan"]
+        assert plan["session_id"] == "sess_001"
+        assert len(plan["tactics"]) == 1
+
+    @pytest.mark.asyncio
+    async def test_appends_not_replaces(self):
+        """apply_tactic appends; an existing tactic in the plan must remain."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        cs.save_tactic(_fresh_tactic(), name="Baseline timelapse")
+        cs._plans["sess_001"] = {
+            "session_id": "sess_001",
+            "title": "",
+            "goal": "",
+            "tactics": [{"id": "existing_t", "name": "Prior tactic", "kind": "oneshot", "state": "done"}],
+        }
+
+        await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
+
+        plan = cs.set_operation_plan_calls[0]["plan"]
+        assert len(plan["tactics"]) == 2
+        ids = [t["id"] for t in plan["tactics"]]
+        assert "existing_t" in ids
+
+    @pytest.mark.asyncio
+    async def test_unknown_id_returns_error_no_plan_write(self):
+        """Unknown tactic id → error string, set_operation_plan must NOT be called."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+
+        result = await apply_tactic(id_or_name="nonexistent", context=_make_context(agent))
+
+        assert result.startswith("Error:")
+        assert len(cs.set_operation_plan_calls) == 0
+
+    @pytest.mark.asyncio
+    async def test_missing_context_store_returns_error(self):
+        agent = FakeAgent(context_store=None)
+        agent.context_store = None
+        result = await apply_tactic(id_or_name="anything", context=_make_context(agent))
+        assert result.startswith("Error:")
+
+    @pytest.mark.asyncio
+    async def test_missing_session_id_returns_error(self):
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        agent.session_id = None
+        result = await apply_tactic(id_or_name="anything", context=_make_context(agent))
+        assert result.startswith("Error:")
+
+    @pytest.mark.asyncio
+    async def test_missing_agent_returns_error(self):
+        result = await apply_tactic(id_or_name="anything", context={})
+        assert result.startswith("Error:")
+
+    @pytest.mark.asyncio
+    async def test_return_value_names_tactic_and_session(self):
+        """Confirmation message should mention the tactic name and session id."""
+        cs = FakeContextStore()
+        agent = FakeAgent(context_store=cs)
+        cs.save_tactic(_fresh_tactic(), name="Baseline timelapse")
+
+        result = await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
+
+        assert "Baseline timelapse" in result
+        assert "sess_001" in result
+
+
+# ---------------------------------------------------------------------------
+# Registration smoke test
+# ---------------------------------------------------------------------------
+
+
+class TestRegistration:
+    def test_tools_are_importable(self):
+        """The three tools must import without error."""
+        from gently.app.tools.tactic_library_tools import (
+            apply_tactic,
+            list_tactics,
+            save_tactic,
+        )
+
+        assert callable(save_tactic)
+        assert callable(list_tactics)
+        assert callable(apply_tactic)
+
+    def test_module_in_tools_package(self):
+        """tactic_library_tools must be in tools.__init__ exports."""
+        import gently.app.tools as tools_pkg
+
+        assert hasattr(tools_pkg, "tactic_library_tools")
+
+    def test_tools_registered_in_registry(self):
+        """The three tools must appear by name in the tool registry."""
+        import gently.app.tools  # noqa: F401 — ensure registration side-effect
+        from gently.harness.tools.registry import get_tool_registry
+
+        registry = get_tool_registry()
+        names = {entry.name for entry in registry.list_all()}
+        assert "save_tactic" in names, f"save_tactic not in registry: {names}"
+        assert "list_tactics" in names, f"list_tactics not in registry: {names}"
+        assert "apply_tactic" in names, f"apply_tactic not in registry: {names}"

From 0dcfdca1eafdc6752a98a3c10574de7d1a475f73 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 19:55:52 +0530
Subject: [PATCH 227/314] feat(tactics-library): GET /api/tactic_library route
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add read endpoint that returns the saved tactic library from
FileContextStore. Returns {"tactics": []} when the store is absent,
list_tactics() raises, or the library is empty — never a 500.
---
 gently/ui/web/routes/__init__.py       |  2 +
 gently/ui/web/routes/tactic_library.py | 27 ++++++++++++
 tests/test_tactic_library_route.py     | 58 ++++++++++++++++++++++++++
 3 files changed, 87 insertions(+)
 create mode 100644 gently/ui/web/routes/tactic_library.py
 create mode 100644 tests/test_tactic_library_route.py

diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index 6cd54a7a..f1ead737 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -14,6 +14,7 @@
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
 from .operation_plan import create_router as create_operation_plan_router
+from .tactic_library import create_router as create_tactic_library_router
 from .temperature import create_router as create_temperature_router
 from .images import create_router as create_images_router
 from .notebook import create_router as create_notebook_router
@@ -41,6 +42,7 @@ def register_all_routes(server):
         create_notebook_router,
         create_temperature_router,
         create_operation_plan_router,
+        create_tactic_library_router,
     ):
         router = factory(server)
         server.app.include_router(router)
diff --git a/gently/ui/web/routes/tactic_library.py b/gently/ui/web/routes/tactic_library.py
new file mode 100644
index 00000000..5ef12804
--- /dev/null
+++ b/gently/ui/web/routes/tactic_library.py
@@ -0,0 +1,27 @@
+"""Tactic Library route.
+
+Returns the saved tactic library from FileContextStore (``server.context_store``).
+Never raises a 500 — returns an empty list when the store is absent or has no
+saved tactics.
+"""
+
+from fastapi import APIRouter
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    @router.get("/api/tactic_library")
+    async def get_tactic_library():
+        cs = getattr(server, "context_store", None)
+        if cs is None:
+            return {"tactics": []}
+        try:
+            tactics = cs.list_tactics()
+        except Exception:
+            tactics = []
+        if not tactics:
+            return {"tactics": []}
+        return {"tactics": tactics}
+
+    return router
diff --git a/tests/test_tactic_library_route.py b/tests/test_tactic_library_route.py
new file mode 100644
index 00000000..9d3603f6
--- /dev/null
+++ b/tests/test_tactic_library_route.py
@@ -0,0 +1,58 @@
+from unittest.mock import MagicMock
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.ui.web.routes.tactic_library import create_router
+
+_SAMPLE_TACTICS = [
+    {"id": "tac-1", "name": "Monitor drift", "description": "Watch Z drift every 5 min"},
+    {"id": "tac-2", "name": "Adjust laser", "description": "Drop 488 nm by 10%"},
+]
+
+
+def _server(tactics, context_store_available=True):
+    context_store = MagicMock() if context_store_available else None
+    if context_store is not None:
+        context_store.list_tactics.return_value = tactics
+
+    srv = MagicMock()
+    srv.context_store = context_store
+    return srv, context_store
+
+
+def _client(server):
+    app = FastAPI()
+    app.include_router(create_router(server))
+    return TestClient(app)
+
+
+def test_returns_tactic_library():
+    srv, cs = _server(_SAMPLE_TACTICS)
+    r = _client(srv).get("/api/tactic_library")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["tactics"] == _SAMPLE_TACTICS
+    cs.list_tactics.assert_called_once()
+
+
+def test_returns_empty_when_no_tactics():
+    srv, cs = _server([])
+    r = _client(srv).get("/api/tactic_library")
+    assert r.status_code == 200
+    assert r.json() == {"tactics": []}
+
+
+def test_returns_empty_when_context_store_absent():
+    srv, _ = _server(_SAMPLE_TACTICS, context_store_available=False)
+    r = _client(srv).get("/api/tactic_library")
+    assert r.status_code == 200
+    assert r.json() == {"tactics": []}
+
+
+def test_returns_empty_when_list_tactics_raises():
+    srv, cs = _server(_SAMPLE_TACTICS)
+    cs.list_tactics.side_effect = RuntimeError("disk error")
+    r = _client(srv).get("/api/tactic_library")
+    assert r.status_code == 200
+    assert r.json() == {"tactics": []}

From 4703f9195f6182c901c5f0c9fc99856765b3ac69 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sun, 28 Jun 2026 20:06:06 +0530
Subject: [PATCH 228/314] fix(tactics-library): scope round-trip test +
 preserve rationale + deterministic name lookup
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add TestScopeRoundTrip: asserts scope survives save→apply, and absent scope stays absent
- Preserve rationale as its own key in save_tactic (alongside description); add TestRationalePreservation
- Rewrite get_tactic to scan list_tactics() (newest-first) instead of iterdir(); add TestGetTacticDeterministic with name-collision case
---
 gently/harness/memory/file_store.py | 16 ++++---
 tests/test_tactic_library_store.py  | 65 +++++++++++++++++++++++++++++
 2 files changed, 75 insertions(+), 6 deletions(-)

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index eab691fc..6eaab365 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1816,6 +1816,7 @@ def save_tactic(self, tactic: dict, name: str | None = None) -> str:
             "structure": copy.deepcopy(tactic.get("structure") or {}),
             "scope_hint": copy.deepcopy(tactic.get("scope")),
             "description": tactic.get("description") or tactic.get("rationale"),
+            "rationale": tactic.get("rationale"),
             "params": copy.deepcopy(tactic.get("params")),
             "relations": copy.deepcopy(tactic.get("relations") or {}),
             "live_bind": list(tactic.get("live_bind") or []),
@@ -1844,15 +1845,18 @@ def list_tactics(self) -> list[dict]:
         return tactics
 
     def get_tactic(self, id_or_name: str) -> dict | None:
-        """Return a tactic template by id or name, or None if not found."""
+        """Return a tactic template by id or name, or None if not found.
+
+        Uses list_tactics() (sorted newest-first by created_at) so that name
+        lookups are deterministic: on a name collision, the newest entry wins.
+        id lookups are unique by construction so order does not matter.
+        """
         tl_dir = self.agent_dir / "tactic_library"
         if not tl_dir.exists():
             return None
-        for f in tl_dir.iterdir():
-            if f.suffix in (".yaml", ".yml"):
-                data = self._read_yaml(f)
-                if data and (data.get("id") == id_or_name or data.get("name") == id_or_name):
-                    return data
+        for tactic in self.list_tactics():
+            if tactic.get("id") == id_or_name or tactic.get("name") == id_or_name:
+                return tactic
         return None
 
     def apply_tactic(self, id_or_name: str) -> dict | None:
diff --git a/tests/test_tactic_library_store.py b/tests/test_tactic_library_store.py
index 4a92acc5..28cd5867 100644
--- a/tests/test_tactic_library_store.py
+++ b/tests/test_tactic_library_store.py
@@ -251,3 +251,68 @@ def test_applied_no_created_at(self, file_context_store):
         tid = file_context_store.save_tactic(_fresh_tactic())
         applied = file_context_store.apply_tactic(tid)
         assert "created_at" not in applied
+
+
+# ---------------------------------------------------------------------------
+# Fix 1 — scope round-trip
+# ---------------------------------------------------------------------------
+
+
+class TestScopeRoundTrip:
+    def test_applied_scope_matches_source(self, file_context_store):
+        """scope from source tactic must survive the save→apply round-trip."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied["scope"] == {"mode": "global"}
+
+    def test_applied_no_scope_when_source_has_none(self, file_context_store):
+        """If source tactic has no scope, applied tactic must not gain a scope key."""
+        tactic = _fresh_tactic()
+        tactic.pop("scope")
+        tid = file_context_store.save_tactic(tactic)
+        applied = file_context_store.apply_tactic(tid)
+        assert "scope" not in applied
+
+
+# ---------------------------------------------------------------------------
+# Fix 2 — rationale preservation
+# ---------------------------------------------------------------------------
+
+
+class TestRationalePreservation:
+    def test_rationale_survives_save_apply(self, file_context_store):
+        """rationale from source tactic must survive the save→apply round-trip."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        applied = file_context_store.apply_tactic(tid)
+        assert applied.get("rationale") == "Establish pre-ramp cadence"
+
+    def test_rationale_in_template(self, file_context_store):
+        """rationale must be stored in the saved template, not only in description."""
+        tid = file_context_store.save_tactic(_fresh_tactic())
+        tmpl = file_context_store.get_tactic(tid)
+        assert tmpl.get("rationale") == "Establish pre-ramp cadence"
+
+
+# ---------------------------------------------------------------------------
+# Fix 3 — deterministic name lookup (newest-wins on collision)
+# ---------------------------------------------------------------------------
+
+
+class TestGetTacticDeterministic:
+    def test_name_collision_returns_newest(self, file_context_store):
+        """When two tactics share a name, get_tactic(name) must return the newest."""
+        import time
+
+        t1 = _fresh_tactic()
+        t1["structure"] = {"cadence_s": 60}
+        file_context_store.save_tactic(t1, name="Shared Name")
+        # Small pause to guarantee distinct created_at timestamps
+        time.sleep(0.002)
+        t2 = _fresh_tactic()
+        t2["structure"] = {"cadence_s": 120}
+        file_context_store.save_tactic(t2, name="Shared Name")
+
+        result = file_context_store.get_tactic("Shared Name")
+        assert result is not None
+        # Newest entry (cadence_s=120) must win
+        assert result["structure"]["cadence_s"] == 120

From df7cf8e60b5c7f8de624f831ad1e63fa2a8f0593 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:10:06 +0530
Subject: [PATCH 229/314] docs(d2): embryo roles/strain + multi-embryo
 observability spec + wrap-up PR plan

---
 docs/superpowers/PR-PLAN.md                   | 30 ++++++
 ...-28-operations-multiembryo-roles-design.md | 95 +++++++++++++++++++
 2 files changed, 125 insertions(+)
 create mode 100644 docs/superpowers/PR-PLAN.md
 create mode 100644 docs/superpowers/specs/2026-06-28-operations-multiembryo-roles-design.md

diff --git a/docs/superpowers/PR-PLAN.md b/docs/superpowers/PR-PLAN.md
new file mode 100644
index 00000000..aeb217d3
--- /dev/null
+++ b/docs/superpowers/PR-PLAN.md
@@ -0,0 +1,30 @@
+# Wrap-up PR plan — the temperature-experiment + Operations goal
+
+**Principle (user-stated):** capture the breadth of work as **separate PRs**, each a distinct unit of
+work with its own identity/ownership and its own tests, **additive on top of PR #58**
+(`integration/ux2-all`, the UX-v2 stack), stacked so they **compose into the final product** in order.
+Each PR diffs cleanly against its parent in the stack; integrate the chain when rig-verified.
+
+## The stack (base = PR #58 `integration/ux2-all`)
+
+| # | Branch | Unit of work | Parent | Tests / review |
+|---|--------|--------------|--------|----------------|
+| 1 | `feature/temperature-interface` (A) | Temperature persistence (`append/read_temperature_sample`) + sampler service + SVG temperature graph w/ setpoint line | #58 | per-task + whole-branch review; graph Chrome-audited |
+| 2 | `feature/manual-mode-live-view` (B1) | Manual-mode imaging: lightsheet brightfield live view (sequence acquisition), illumination control (LED/laser presets), galvo/piezo scan params + **4 acquire-safety fixes** (C1/I1/I2/I3) | A | per-task + whole-branch (opus) review |
+| 3 | `feature/temp-change-tactic` (C) | Automated temp-change burst protocol (`wait_for_temperature_lock` + driver), burst-acquisition wiring, protocol events + agent tool | B1 | per-task + whole-branch review + fixes |
+| 4 | `feature/operations-tab` (D) | **Operations: the agent-authored Operation Plan** — typed declare tool, store, route, execution-linkage (tactic_id + updater), plan-item seeding, operation-spine renderer + live binding | C | 10 tasks + whole-branch (opus) review + 6 fixes; 105 tests; Chrome-audited |
+| 5 | `feature/tactics-library` (G) | Save / list / apply reusable typed tactics (on D's substrate), mirroring plan-templates; apply→Operation Plan | D | 3 tasks + whole-branch review + fixes; ~64 tests |
+| 6 | `feature/embryo-roles-observability` (D2) | Per-embryo **strain** field + roles-as-**use** (lineaging + subject/reference) + multi-embryo Operations roster lens (role + strain) | G | TBD (SDD) |
+
+Notes:
+- Each branch is the natural unit of "distinct enough to own a PR." Sub-parts (e.g. B1's safety fixes)
+  stay inside their branch — granular enough to capture the work, not so granular it's noise.
+- A/B1/C are **kept-as-is pending rig verification** (not merged); D/G/D2 build on top. The stack is
+  intact but unmerged — PRs can open stacked and merge the chain once verified on the rig.
+- "Easy to put together into a final product" = the linear stack already composes; the integration
+  point is #58 → `development`.
+
+## At wrap-up
+1. Verify each branch's tests pass (the SDD ledgers + whole-branch reviews are the evidence trail).
+2. Open the stacked PRs in order (each targets its parent branch), each description capturing its unit.
+3. Rebase/integrate the chain onto #58 when rig-verified; #58 → `development` as the final integration.
diff --git a/docs/superpowers/specs/2026-06-28-operations-multiembryo-roles-design.md b/docs/superpowers/specs/2026-06-28-operations-multiembryo-roles-design.md
new file mode 100644
index 00000000..c3163fc0
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-28-operations-multiembryo-roles-design.md
@@ -0,0 +1,95 @@
+# Design: Embryo roles/strain + multi-embryo Operations observability (sub-project D2)
+
+Status: design 2026-06-29 (revised after recon + user steering). Extends D (the agent-authored
+Operation Plan). Driven by the real temperature-strain run: **multiple embryos with roles**. Branch:
+`feature/embryo-roles-observability` (off G / the operations stack).
+
+## 0. Reuse what exists — gently ALREADY has embryo roles
+Recon confirmed a first-class role concept; D2 builds on it, does NOT reinvent it:
+- `role: str` on every embryo — `EmbryoInfo["role"]` in `embryo.yaml` (`gently/core/store_types.py:34`,
+  written by `FileStore.register_embryo` `file_store.py:564/576`) and `EmbryoState.role`
+  (`gently/harness/state.py:138`, default `"test"`).
+- `gently/harness/roles.py:REGISTRY` — the taxonomy. Today: `test` (biological subject, magenta
+  `#ff66cc`, star, dose ×1), `calibration` (reference, cyan `#00cccc`, diamond, dose ×10,
+  nuclear-marker pipeline), `unassigned`. Each `EmbryoRole` carries `description,
+  default_cadence_seconds, detector_name, photodose_budget_multiplier, ui_color, ui_icon,
+  no_object_consecutive_terminal`.
+- Already surfaced in the **Map view** (`marking.js` ROLE_CYCLE/ROLE_COLORS) + `GET
+  /api/embryos/positions` (`routes/data.py:689`); already read for photodose scaling
+  (`timelapse.py:426`). The **Embryos strip + Operations do NOT show role** — that is the gap D2 fills.
+
+## 0a. The load-bearing insight — strain ⊥ use
+Role and strain are ORTHOGONAL axes that gently currently conflates (the `calibration` role hardcodes
+the nuclear-marker detector):
+- **Strain** = the biological sample (e.g. pan-nuclear GFP — GFP in every nucleus; a dopaminergic
+  reporter). It is what is *labeled* → it determines the **perception/detector**.
+- **Use (role)** = what the embryo is FOR: subject (test), calibration, lineaging. Drives
+  cadence / photodose / adaptive-vs-fixed tactics.
+The SAME pan-nuclear strain is used for **lineaging** (C. elegans lineage tracing) OR **calibration**
+(microscopist calibrating the lightsheet on the same nuclear structure); and **lineaging** can run on
+*non*-pan-nuclear strains. So neither determines the other. Fix: make **strain** the per-embryo field
+that drives the detector, and let **role** be purely *use*.
+
+## 1. Schema changes
+
+### 1.1 Per-embryo `strain` (NEW, free-form string)
+Add `strain: str | None` to `EmbryoInfo` (`store_types.py`) + `EmbryoState` (`state.py`), persisted in
+`embryo.yaml` via `register_embryo(..., strain=None)`. Free-form (e.g. `"pan-nuclear GFP"`); coexists
+with the existing plan-level `strain`/`genotype`/`reporter` spec overrides
+(`memory/file_store.py:1746`). No strain registry this pass.
+
+### 1.2 Roles refined to USE — extend `roles.REGISTRY`
+- Add `lineaging` to the REGISTRY (its own `ui_color`/`ui_icon`/`default_cadence_seconds`/policy).
+  Distinct *use* from calibration even when it shares the pan-nuclear strain.
+- Add a `class` attribute to `EmbryoRole`: `'subject' | 'reference'` — `test`→subject;
+  `calibration`,`lineaging`→reference; `unassigned`→subject (safe default). Drives the Operations
+  foregrounding; derived from role, not a new per-embryo field.
+- Keep `detector_name` ON the role THIS PASS (staged — see §4). Document that it logically belongs to
+  strain.
+
+### 1.3 Role-scoped tactics (on D's Operation Plan)
+`tactic.scope` gains `mode:'role'` + `role:<key>` (an existing REGISTRY key: test/calibration/lineaging).
+`mode=role` resolves to all roster embryos with that role. Backward compatible (global/embryos unchanged).
+
+## 2. Observability — Operations roster lens (reads existing role + strain)
+A roster lens above the operation spine, reading the LIVE embryos (via the tracker / `EmbryoState.role`
+/ `/api/embryos/positions`) + `roles.REGISTRY` metadata (real `ui_color`/`ui_icon` — magenta test, cyan
+calibration, lineaging's color) — NOT new colors:
+- Split FIRST by role `class`: **Subjects** (foregrounded — adaptive tactics/scenarios) then
+  **References** (compact — calibration/lineaging holding steady).
+- Within each class, group by role (use). Each embryo row: `id · role chip (REGISTRY color/icon) ·
+  strain · cadence-phase chip · current tactic · state`.
+- The spine's tactic nodes show scope by role ("→ test · E01,E02,E03"; "→ reference").
+This answers "who's a subject vs a reference, what's each one's strain + use, what's happening to each."
+
+## 3. Architecture (reuse D + existing role plumbing)
+- Strain: field on EmbryoInfo/EmbryoState + register_embryo + the marking tool (`detection_tools.py`)
+  accepts strain alongside role; `/api/embryos/positions` adds `strain`.
+- Roles: extend `roles.py:REGISTRY` (+ `class` on EmbryoRole); reuse `get_role`/`REGISTRY.get`.
+- Operations: roster lens in `experiment-overview.js` reading the embryos endpoint + REGISTRY; role-scope
+  rendering on the spine. Role→embryo_ids resolver is a pure read over the roster.
+- Tactic scope: `declare_operation_plan` accepts `scope.role`; seeding can set role-scoped tactics.
+
+## 4. ⚠️ FULL SEPARATION — TRACKED FUTURE WORK (staged out of this pass)
+This pass STAGES the model; the clean end-state (do later, do not lose):
+1. **Detector follows strain, not role.** Move `detector_name`/perception selection off `EmbryoRole`
+   onto strain (a strain→detector mapping / strain registry). `calibration` stops implying the
+   nuclear-marker pipeline; a pan-nuclear *test* embryo would also get nuclear perception.
+2. **Strain registry** (like `roles.py`): strain key → {label, markers, default detector, ui}. Lets
+   strain drive detector cleanly + gives the UI consistent strain labels/colors.
+3. **Role policy audit** once detector is off role: confirm role carries only cadence / photodose /
+   adaptive-vs-fixed / class, nothing strain-derived.
+4. Backfill: existing embryos have role but no strain — a migration/default for strain on legacy data.
+These are real work items; they belong in a follow-on PR after D2's staged version lands.
+
+## 5. Out of scope (D2)
+- Per-role analysis/plots (results view, not Operations).
+- A manual role/strain editor UI beyond what the Map marking tool already does.
+- The full detector→strain decoupling (§4 — explicitly future).
+
+## 6. Testing
+- Strain field round-trips through embryo.yaml (register/get); `/api/embryos/positions` includes it.
+- `roles.REGISTRY` has lineaging + `class`; `get_role` returns class; existing roles unchanged.
+- Role-scope resolver: role→embryo_ids over a roster; global/embryos unchanged; backward compat.
+- Renderer: roster lens (class split → role groups → strain) + role-scoped spine render across fixtures
+  using REAL REGISTRY colors (node --check + Chrome audit). Roster-less/role-less plan renders as D today.

From cc77f0f0d764f2272cacc0098f38a7cba1a3263c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:11:21 +0530
Subject: [PATCH 230/314] =?UTF-8?q?docs(d2):=20implementation=20plan=20(4?=
 =?UTF-8?q?=20tasks)=20=E2=80=94=20strain=20field,=20roles-as-use,=20role?=
 =?UTF-8?q?=20scope,=20roster=20lens?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../2026-06-29-embryo-roles-observability.md  | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-29-embryo-roles-observability.md

diff --git a/docs/superpowers/plans/2026-06-29-embryo-roles-observability.md b/docs/superpowers/plans/2026-06-29-embryo-roles-observability.md
new file mode 100644
index 00000000..cdbe76dc
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-29-embryo-roles-observability.md
@@ -0,0 +1,43 @@
+# Embryo roles/strain + multi-embryo Operations observability (D2) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development. Steps use `- [ ]`.
+
+**Goal:** Add a per-embryo `strain` field, refine roles to *use* (add lineaging + a subject/reference `class`), and build the Operations roster lens that reads existing roles + strain. Detector stays on role this pass (full detector→strain separation is tracked future work — spec §4).
+
+**Architecture:** Reuse gently's existing `role` (`roles.REGISTRY`, `EmbryoState.role`, `embryo.yaml`). Add `strain` alongside role; extend the registry; expose roles to the frontend; render a role+strain roster lens above the operation spine.
+
+## Global Constraints
+- REUSE the existing role concept — do NOT invent a new taxonomy. Extend `gently/harness/roles.py:REGISTRY` (`EmbryoRole` dataclass) and read role via the existing accessors (`EmbryoState.role`, `EmbryoInfo["role"]`, `get_role`/`REGISTRY.get`, `/api/embryos/positions`).
+- Strain is a FREE-FORM string per embryo (no registry this pass). Coexists with plan-level strain/genotype overrides.
+- Roles render with their REAL `REGISTRY` `ui_color`/`ui_icon` (magenta test, cyan calibration, lineaging's own) — never invented colors.
+- `class` ('subject'|'reference') is an attribute ON `EmbryoRole`, derived from role; test/unassigned→subject, calibration/lineaging→reference.
+- Backward compatible: embryos without strain → None; plans without role-scope render as D today.
+- Detector stays wired to role THIS PASS (spec §4 documents the full separation as future work — do not implement it here).
+- Git hygiene: stage only your files by explicit path; never `git add -A`.
+
+---
+
+### Task 1: Per-embryo `strain` field
+**Files:** Modify `gently/core/store_types.py` (`EmbryoInfo` — add `strain: str | None`); `gently/harness/state.py` (`EmbryoState` — add `strain: str | None = None`); `gently/core/file_store.py` (`register_embryo` — accept `strain=None`, write/coalesce it in embryo.yaml like `role`); `gently/ui/web/routes/data.py` (`/api/embryos/positions` ~:689 — add `"strain": emb.get("strain")`). Test: `tests/test_embryo_strain.py`.
+- [ ] Confirm how `role` is threaded through `register_embryo` (`file_store.py:507-580`, write at :576, coalesce at :564) and EmbryoState (`state.py:138`); mirror it for `strain`. Confirm the positions endpoint shape (`data.py:661-696`).
+- [ ] TDD: register an embryo with `strain="pan-nuclear GFP"` → get_embryo returns it; update coalesces; absent → None; positions endpoint includes strain. `pytest tests/test_embryo_strain.py -v`; `pytest -q` clean. Commit `feat(d2): per-embryo strain field`.
+
+### Task 2: Roles refined — lineaging + subject/reference class
+**Files:** Modify `gently/harness/roles.py` (add `class_: str = "subject"` — or `klass`/`role_class` to avoid the `class` keyword — to `EmbryoRole`; add a `lineaging` entry to `REGISTRY`; set `class_` on each role: test/unassigned→subject, calibration/lineaging→reference; give lineaging its own ui_color/ui_icon/default_cadence/detector kept None or nuclear like calibration). Test: `tests/test_roles_registry.py` (extend if exists).
+- [ ] Add the `class_` field (default "subject") to `EmbryoRole`; set it on all REGISTRY entries; add `lineaging` (reference, distinct ui_color e.g. a teal/green, ui_icon, cadence). Keep `detector_name` as-is on each role (staged). Confirm nothing else constructs EmbryoRole positionally in a way the new field breaks.
+- [ ] TDD: `REGISTRY["lineaging"].class_=="reference"`; `REGISTRY["test"].class_=="subject"`; `REGISTRY["calibration"].class_=="reference"`; `get_role("lineaging")` works; existing roles/fields unchanged. `pytest tests/test_roles_registry.py -v`; `pytest -q` clean. Commit `feat(d2): roles-as-use — add lineaging + subject/reference class`.
+
+### Task 3: `/api/roles` route + role-scoped tactic scope
+**Files:** Create `gently/ui/web/routes/roles.py` (`GET /api/roles` → `{roles:[{name,description,class_,ui_color,ui_icon,default_cadence_seconds}]}` from `list_roles()`/REGISTRY; register in `routes/__init__.py`). Modify `gently/app/tools/operation_plan_tools.py` (allow `scope.mode=='role'` + `scope.role` in validation — accept a REGISTRY key); add a pure resolver `resolve_scope_embryos(scope, roster_or_embryos) -> list[str]` (in a small module or operation_plan_tools) mapping mode=role→embryo_ids by role. Test: `tests/test_roles_route.py`, `tests/test_role_scope.py`.
+- [ ] `/api/roles` mirrors `routes/tactic_library.py` (simple list route, graceful). The resolver maps `{mode:'role',role:'test'}` against a list of embryos-with-roles → the matching ids; global→all, embryos→explicit. Validation accepts mode=role with a valid role key.
+- [ ] TDD: route returns the registry incl. lineaging + class_; resolver resolves role→ids, global→all, embryos→explicit, unknown role→[]. `pytest tests/test_roles_route.py tests/test_role_scope.py -v`; `pytest -q` clean. Commit `feat(d2): /api/roles route + role-scoped tactic scope resolver`.
+
+### Task 4: Operations roster lens (frontend)
+**Files:** Modify `gently/ui/web/static/js/experiment-overview.js` (add a roster lens above the operation spine: fetch `/api/embryos/positions` + `/api/roles`, group embryos by role `class_` (Subjects foregrounded, References compact) then by role, each row `id · role chip (REGISTRY ui_color/ui_icon) · strain · cadence-phase chip · current tactic (from the plan's role-scoped tactics) · state`; render tactic-node scope by role using the resolver/role labels); `gently/ui/web/static/css/experiment.css` (the `.ops-roster*` classes, using the role colors from the API, not hardcoded). Reference: the validated prototype `scratchpad/d2proto/index.html` (regrounded to real role colors).
+- [ ] Build the roster lens reading the real endpoints + role metadata (colors from `/api/roles`, not invented); class split → role groups → strain; spine nodes show role-scope ("→ test · E01.."). Backward compat: no embryos/roles → omit the lens, spine renders as D. `node --check`; build/refresh the opsv3 (or d2) Chrome harness with the real files for the controller to audit. Commit `feat(d2): Operations roster lens — embryos by role + strain`.
+
+## Self-Review
+- Strain→T1; roles/class→T2; roles route + role-scope→T3; roster lens→T4. ✓
+- Open confirmations: register_embryo/EmbryoState role threading (T1), EmbryoRole construction sites (T2), the route/resolver pattern (T3), the embryos+roles endpoints + plan cross-reference for current-tactic (T4).
+- Type consistency: `strain` str|None across model/store/endpoint; `class_` on EmbryoRole + in /api/roles + read by the renderer; role keys consistent across REGISTRY, scope.role, resolver, renderer.
+- Staged: detector stays on role (spec §4 future work referenced, not implemented).

From 3ad9afefa3adf743c7052859785561e2fce9ea95 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:14:02 +0530
Subject: [PATCH 231/314] feat(d2): per-embryo strain field
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add free-form `strain: str | None` to EmbryoInfo, EmbryoState,
register_embryo (create + coalesce-update), and the positions endpoint
— threaded exactly like the existing `role` field. Tests in
tests/test_embryo_strain.py (6/6 pass).
---
 gently/core/file_store.py    |   7 ++
 gently/core/store_types.py   |   1 +
 gently/harness/state.py      |   3 +
 gently/ui/web/routes/data.py |   1 +
 tests/test_embryo_strain.py  | 145 +++++++++++++++++++++++++++++++++++
 5 files changed, 157 insertions(+)
 create mode 100644 tests/test_embryo_strain.py

diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index e7fb2174..d9dafaaa 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -516,6 +516,7 @@ def register_embryo(
         position_fine: dict | None = None,
         calibration: dict | None = None,
         role: str | None = None,
+        strain: str | None = None,
     ) -> None:
         """Register or update an embryo in a session.
 
@@ -523,6 +524,10 @@ def register_embryo(
         (e.g. ``"test"``, ``"calibration"``, ``"unassigned"``). Persisted in
         embryo.yaml. None preserves the existing value on update.
 
+        ``strain`` is a free-form biological sample descriptor (e.g.
+        ``"pan-nuclear GFP"``). Orthogonal to role. None preserves the existing
+        value on update.
+
         Position has two stages: coarse (bottom-camera / manual map placement)
         and fine (future SPIM-objective alignment). New callers should pass
         position_coarse / position_fine as dicts of shape {"x": float, "y":
@@ -562,6 +567,7 @@ def register_embryo(
                 if calibration is not None
                 else existing.get("calibration"),
                 "role": role if role is not None else existing.get("role", "test"),
+                "strain": strain if strain is not None else existing.get("strain"),
                 "created_at": existing.get("created_at", _now()),
             }
         else:
@@ -574,6 +580,7 @@ def register_embryo(
                 "position_fine": position_fine,
                 "calibration": calibration,
                 "role": role if role is not None else "test",
+                "strain": strain,
                 "created_at": _now(),
             }
 
diff --git a/gently/core/store_types.py b/gently/core/store_types.py
index aa3eeaff..1b7a60fe 100644
--- a/gently/core/store_types.py
+++ b/gently/core/store_types.py
@@ -32,6 +32,7 @@ class EmbryoInfo(TypedDict, total=False):
     position_y: float | None
     calibration: dict | None
     role: str | None  # key into gently.harness.roles.REGISTRY
+    strain: str | None  # free-form biological sample descriptor, e.g. "pan-nuclear GFP"
     created_at: str
 
 
diff --git a/gently/harness/state.py b/gently/harness/state.py
index 34b7d8f6..5e2af6c4 100644
--- a/gently/harness/state.py
+++ b/gently/harness/state.py
@@ -136,6 +136,9 @@ class EmbryoState:
     # is the safe choice — accidental Calibration→Test only over-protects;
     # accidental Test→Calibration would burn extra dose on the precious sample.
     role: str = "test"
+    # Free-form biological sample descriptor (orthogonal to role). Examples:
+    # "pan-nuclear GFP", "H2B-mCherry", "wild-type". None = unspecified.
+    strain: str | None = None
 
     # Position — two-stage: coarse (bottom-camera detection or manual map
     # placement, always present once an embryo exists) and fine (populated
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index cfbeb11c..eed3e5a9 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -687,6 +687,7 @@ async def embryo_positions():
                         "x": float(x),
                         "y": float(y),
                         "role": emb.get("role", "test"),
+                        "strain": emb.get("strain"),
                         "user_label": emb.get("user_label"),
                         "confidence": emb.get("confidence"),
                         "cadence_phase": emb.get("cadence_phase"),
diff --git a/tests/test_embryo_strain.py b/tests/test_embryo_strain.py
new file mode 100644
index 00000000..474a77ef
--- /dev/null
+++ b/tests/test_embryo_strain.py
@@ -0,0 +1,145 @@
+"""Tests for per-embryo strain field (D2 Task 1).
+
+Covers:
+- register_embryo with strain persists it through get_embryo
+- update without strain coalesces (keeps existing value)
+- absent strain on create → None
+- /api/embryos/positions includes strain
+"""
+
+from unittest.mock import MagicMock
+
+import pytest
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+
+# ===========================================================================
+# FileStore tests
+# ===========================================================================
+
+
+def test_register_embryo_with_strain(file_store):
+    """register_embryo with strain; get_embryo returns it."""
+    file_store.create_session("s1", name="test")
+    file_store.register_embryo(
+        "s1",
+        "embryo_1",
+        position_coarse={"x": 10.0, "y": 20.0},
+        strain="pan-nuclear GFP",
+    )
+    emb = file_store.get_embryo("s1", "embryo_1")
+    assert emb is not None
+    assert emb.get("strain") == "pan-nuclear GFP"
+
+
+def test_register_embryo_strain_absent_is_none(file_store):
+    """register_embryo without strain → strain is None in get_embryo."""
+    file_store.create_session("s2", name="test")
+    file_store.register_embryo("s2", "embryo_1", position_coarse={"x": 0.0, "y": 0.0})
+    emb = file_store.get_embryo("s2", "embryo_1")
+    assert emb is not None
+    assert emb.get("strain") is None
+
+
+def test_register_embryo_strain_coalesces_on_update(file_store):
+    """Update without strain keeps the originally set value (coalesce)."""
+    file_store.create_session("s3", name="test")
+    # Create with strain
+    file_store.register_embryo(
+        "s3",
+        "embryo_1",
+        position_coarse={"x": 5.0, "y": 5.0},
+        strain="H2B-mCherry",
+    )
+    # Update with a new position but no strain — existing strain must be kept
+    file_store.register_embryo(
+        "s3",
+        "embryo_1",
+        position_coarse={"x": 6.0, "y": 6.0},
+    )
+    emb = file_store.get_embryo("s3", "embryo_1")
+    assert emb is not None
+    assert emb.get("strain") == "H2B-mCherry"
+
+
+def test_register_embryo_strain_can_be_overwritten(file_store):
+    """Passing a new strain on update replaces the old value."""
+    file_store.create_session("s4", name="test")
+    file_store.register_embryo(
+        "s4", "embryo_1", position_coarse={"x": 0.0, "y": 0.0}, strain="wild-type"
+    )
+    file_store.register_embryo(
+        "s4", "embryo_1", position_coarse={"x": 0.0, "y": 0.0}, strain="pan-nuclear GFP"
+    )
+    emb = file_store.get_embryo("s4", "embryo_1")
+    assert emb is not None
+    assert emb.get("strain") == "pan-nuclear GFP"
+
+
+# ===========================================================================
+# /api/embryos/positions endpoint test
+# ===========================================================================
+
+
+def _build_client_with_tracker(embryos_dict):
+    """Build a FastAPI TestClient whose server has a timelapse_tracker."""
+    from gently.ui.web.routes.data import create_router
+
+    app = FastAPI()
+    server = MagicMock()
+
+    tracker = MagicMock()
+    tracker.embryos = embryos_dict
+    server.timelapse_tracker = tracker
+
+    # store.get_embryo_ids needed by /api/embryos (not under test here)
+    server.store.get_embryo_ids.return_value = []
+
+    app.include_router(create_router(server))
+    return TestClient(app)
+
+
+def test_positions_endpoint_includes_strain():
+    """embryo_positions response includes the strain key from tracker."""
+    client = _build_client_with_tracker(
+        {
+            "embryo_1": {
+                "stage_x_um": 10.0,
+                "stage_y_um": 20.0,
+                "role": "test",
+                "strain": "pan-nuclear GFP",
+                "uid": "abc",
+                "user_label": None,
+                "confidence": 0.9,
+                "cadence_phase": None,
+                "is_complete": False,
+            }
+        }
+    )
+    resp = client.get("/api/embryos/positions")
+    assert resp.status_code == 200
+    data = resp.json()
+    assert len(data["embryos"]) == 1
+    point = data["embryos"][0]
+    assert "strain" in point
+    assert point["strain"] == "pan-nuclear GFP"
+
+
+def test_positions_endpoint_strain_none_when_absent():
+    """embryo_positions returns strain=None when tracker dict has no strain key."""
+    client = _build_client_with_tracker(
+        {
+            "embryo_1": {
+                "stage_x_um": 1.0,
+                "stage_y_um": 2.0,
+                "role": "test",
+                # no "strain" key
+            }
+        }
+    )
+    resp = client.get("/api/embryos/positions")
+    assert resp.status_code == 200
+    point = resp.json()["embryos"][0]
+    assert "strain" in point
+    assert point["strain"] is None

From d14c6de6ce67e067509e0e2482317ac663e79f8f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:19:06 +0530
Subject: [PATCH 232/314] =?UTF-8?q?feat(d2):=20roles-as-use=20=E2=80=94=20?=
 =?UTF-8?q?add=20lineaging=20+=20subject/reference=20class?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add role_class field ("subject"|"reference") to EmbryoRole frozen dataclass.
Set on all existing entries: test/unassigned→subject, calibration→reference.
Add lineaging registry entry (role_class=reference, ui_color=#33cc88, icon=triangle,
detector=perception) — a distinct use even when the strain overlaps calibration.
Detector wiring is staged; strain→detector decoupling deferred to spec §4.
22 new tests in tests/test_roles_registry.py; 0 new failures in full suite.
---
 gently/harness/roles.py      |  28 ++++++
 tests/test_roles_registry.py | 174 +++++++++++++++++++++++++++++++++++
 2 files changed, 202 insertions(+)
 create mode 100644 tests/test_roles_registry.py

diff --git a/gently/harness/roles.py b/gently/harness/roles.py
index beaa59a4..68bee551 100644
--- a/gently/harness/roles.py
+++ b/gently/harness/roles.py
@@ -15,8 +15,16 @@
 - ``test``: the biological subject (precious sample). Custom ad-hoc detector.
 - ``calibration``: reference embryo used for staging/calibration. Absorbs
   more photodose. Standard perception pipeline.
+- ``lineaging``: lineage-tracing reference — tracks nuclei/divisions. Often
+  a pan-nuclear strain, but the strain is separate from this use.
 - ``unassigned``: explicit "not yet classified" state. Treated like ``test``
   for safety until the user resolves the assignment.
+
+Role classes
+------------
+``role_class`` distinguishes how Operations foregrounds embryos:
+- ``"subject"`` — the primary biological subjects of the experiment.
+- ``"reference"`` — reference embryos (staging, calibration, lineaging).
 """
 
 from dataclasses import dataclass
@@ -44,6 +52,9 @@ class EmbryoRole:
     # a short threshold. Test embryos can occasionally pop out and
     # back, so they get a longer one.
     no_object_consecutive_terminal: int | None = None
+    # 'subject' | 'reference' — used by Operations to foreground subjects
+    # vs references in multi-embryo layouts and scheduling decisions.
+    role_class: str = "subject"
 
 
 REGISTRY: dict[str, EmbryoRole] = {
@@ -56,6 +67,7 @@ class EmbryoRole:
         ui_color="#888888",
         ui_icon="circle",
         no_object_consecutive_terminal=None,
+        role_class="subject",  # safe default: protect like a subject
     ),
     "test": EmbryoRole(
         name="test",
@@ -71,6 +83,7 @@ class EmbryoRole:
         ui_color="#ff66cc",  # magenta
         ui_icon="star",
         no_object_consecutive_terminal=5,  # forgiving — they might drift back
+        role_class="subject",
     ),
     "calibration": EmbryoRole(
         name="calibration",
@@ -85,6 +98,21 @@ class EmbryoRole:
         ui_color="#00cccc",  # cyan
         ui_icon="diamond",
         no_object_consecutive_terminal=2,  # they don't drift back; gone == gone
+        role_class="reference",
+    ),
+    "lineaging": EmbryoRole(
+        name="lineaging",
+        description=(
+            "Lineage-tracing reference — tracks nuclei/divisions; often a "
+            "pan-nuclear strain but the strain is separate from this use."
+        ),
+        default_cadence_seconds=300.0,
+        detector_name="perception",  # nuclear pipeline, same as calibration
+        photodose_budget_multiplier=5.0,
+        ui_color="#33cc88",  # teal-green — distinct from cyan (calibration) and magenta (test)
+        ui_icon="triangle",
+        no_object_consecutive_terminal=2,  # reference embryos don't drift back
+        role_class="reference",
     ),
 }
 
diff --git a/tests/test_roles_registry.py b/tests/test_roles_registry.py
new file mode 100644
index 00000000..9fc7181d
--- /dev/null
+++ b/tests/test_roles_registry.py
@@ -0,0 +1,174 @@
+"""
+Tests for gently/harness/roles.py — EmbryoRole registry.
+
+Covers:
+- role_class field presence and correct values for all built-in roles
+- lineaging role entry: existence, role_class, ui_color, ui_icon
+- accessor functions: get_role, is_valid_role, list_roles
+- existing roles' other fields unchanged
+"""
+
+import pytest
+
+from gently.harness.roles import (
+    REGISTRY,
+    EmbryoRole,
+    DEFAULT_ROLE,
+    get_role,
+    is_valid_role,
+    list_roles,
+)
+
+
+# ---------------------------------------------------------------------------
+# role_class field — all existing roles
+# ---------------------------------------------------------------------------
+
+
+def test_test_role_class_is_subject():
+    assert REGISTRY["test"].role_class == "subject"
+
+
+def test_unassigned_role_class_is_subject():
+    assert REGISTRY["unassigned"].role_class == "subject"
+
+
+def test_calibration_role_class_is_reference():
+    assert REGISTRY["calibration"].role_class == "reference"
+
+
+# ---------------------------------------------------------------------------
+# lineaging role — existence and fields
+# ---------------------------------------------------------------------------
+
+
+def test_lineaging_role_exists_in_registry():
+    assert "lineaging" in REGISTRY
+
+
+def test_lineaging_role_class_is_reference():
+    assert REGISTRY["lineaging"].role_class == "reference"
+
+
+def test_lineaging_ui_color():
+    # Must be distinct from calibration (#00cccc) and test (#ff66cc)
+    color = REGISTRY["lineaging"].ui_color
+    assert color == "#33cc88"
+    assert color != REGISTRY["calibration"].ui_color
+    assert color != REGISTRY["test"].ui_color
+
+
+def test_lineaging_ui_icon():
+    assert REGISTRY["lineaging"].ui_icon == "triangle"
+
+
+def test_lineaging_description_contains_lineage():
+    desc = REGISTRY["lineaging"].description.lower()
+    assert "lineage" in desc or "nuclei" in desc
+
+
+def test_lineaging_has_cadence():
+    assert REGISTRY["lineaging"].default_cadence_seconds > 0
+
+
+# ---------------------------------------------------------------------------
+# Accessor functions
+# ---------------------------------------------------------------------------
+
+
+def test_get_role_lineaging_returns_correct_entry():
+    role = get_role("lineaging")
+    assert isinstance(role, EmbryoRole)
+    assert role.name == "lineaging"
+    assert role.role_class == "reference"
+
+
+def test_is_valid_role_lineaging_true():
+    assert is_valid_role("lineaging") is True
+
+
+def test_is_valid_role_unknown_false():
+    assert is_valid_role("nonexistent_role") is False
+
+
+def test_list_roles_includes_lineaging():
+    assert "lineaging" in list_roles()
+
+
+def test_list_roles_sorted():
+    roles = list_roles()
+    assert roles == sorted(roles)
+
+
+def test_get_role_unknown_raises_key_error():
+    with pytest.raises(KeyError, match="Unknown embryo role"):
+        get_role("not_a_role")
+
+
+# ---------------------------------------------------------------------------
+# Existing roles — other fields unchanged
+# ---------------------------------------------------------------------------
+
+
+def test_test_role_fields_unchanged():
+    role = REGISTRY["test"]
+    assert role.name == "test"
+    assert role.ui_color == "#ff66cc"
+    assert role.ui_icon == "star"
+    assert role.photodose_budget_multiplier == 1.0
+    assert role.detector_name == "dopaminergic_signal"
+    assert role.no_object_consecutive_terminal == 5
+
+
+def test_calibration_role_fields_unchanged():
+    role = REGISTRY["calibration"]
+    assert role.name == "calibration"
+    assert role.ui_color == "#00cccc"
+    assert role.ui_icon == "diamond"
+    assert role.photodose_budget_multiplier == 10.0
+    assert role.detector_name == "perception"
+    assert role.no_object_consecutive_terminal == 2
+
+
+def test_unassigned_role_fields_unchanged():
+    role = REGISTRY["unassigned"]
+    assert role.name == "unassigned"
+    assert role.ui_color == "#888888"
+    assert role.ui_icon == "circle"
+    assert role.detector_name is None
+    assert role.no_object_consecutive_terminal is None
+
+
+# ---------------------------------------------------------------------------
+# DEFAULT_ROLE sanity
+# ---------------------------------------------------------------------------
+
+
+def test_default_role_is_in_registry():
+    assert DEFAULT_ROLE in REGISTRY
+
+
+def test_default_role_is_test():
+    assert DEFAULT_ROLE == "test"
+
+
+# ---------------------------------------------------------------------------
+# EmbryoRole is frozen (immutable)
+# ---------------------------------------------------------------------------
+
+
+def test_embryo_role_is_frozen():
+    role = REGISTRY["test"]
+    with pytest.raises(Exception):
+        role.name = "mutated"  # type: ignore[misc]
+
+
+# ---------------------------------------------------------------------------
+# role_class field has a safe default for keyword construction
+# ---------------------------------------------------------------------------
+
+
+def test_embryo_role_default_role_class():
+    """New EmbryoRole without role_class defaults to 'subject'."""
+    role = EmbryoRole(name="dummy", description="test only")
+    assert role.role_class == "subject"

From f48b2068da42d0785dd11f79aedbb4db36e85b5c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:19:09 +0530
Subject: [PATCH 233/314] docs(sdd): d2-task-2 report

---
 .superpowers/sdd/d2-task-2-report.md | 106 +++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 .superpowers/sdd/d2-task-2-report.md

diff --git a/.superpowers/sdd/d2-task-2-report.md b/.superpowers/sdd/d2-task-2-report.md
new file mode 100644
index 00000000..5a9a33c4
--- /dev/null
+++ b/.superpowers/sdd/d2-task-2-report.md
@@ -0,0 +1,106 @@
+# D2 Task 2 Report — roles-as-use: lineaging + subject/reference class
+
+## What was done
+
+### 1. `role_class` field added to `EmbryoRole`
+
+Added `role_class: str = "subject"` as the last field in the frozen dataclass
+(`gently/harness/roles.py`, after `no_object_consecutive_terminal`). Default is
+`"subject"` so any existing keyword-constructed `EmbryoRole` is safe without
+change. Docstring in the module header updated to document the two values
+(`"subject"` | `"reference"`) and their intent.
+
+### 2. `role_class` set on all three existing REGISTRY entries
+
+| Role        | role_class  | Rationale                                      |
+|-------------|-------------|------------------------------------------------|
+| `test`      | `"subject"` | The biological subject — the precious sample.  |
+| `unassigned`| `"subject"` | Safe default: protect like a subject until resolved. |
+| `calibration`| `"reference"` | Reference embryo for staging/calibration.   |
+
+### 3. `lineaging` entry added to REGISTRY
+
+```python
+"lineaging": EmbryoRole(
+    name="lineaging",
+    description=(
+        "Lineage-tracing reference — tracks nuclei/divisions; often a "
+        "pan-nuclear strain but the strain is separate from this use."
+    ),
+    default_cadence_seconds=300.0,
+    detector_name="perception",        # nuclear pipeline, same as calibration
+    photodose_budget_multiplier=5.0,
+    ui_color="#33cc88",                # teal-green — distinct from cyan/magenta
+    ui_icon="triangle",
+    no_object_consecutive_terminal=2,  # reference: gone == gone
+    role_class="reference",
+)
+```
+
+Color distinctness verified: `#33cc88` (teal-green) ≠ `#00cccc` (calibration
+cyan) ≠ `#ff66cc` (test magenta).
+
+### 4. EmbryoRole construction-site check
+
+```
+grep -rn "EmbryoRole(" gently/
+```
+
+Result: only `gently/harness/roles.py` — the three (now four) REGISTRY entries,
+all using keyword arguments. No positional construction anywhere. The new field's
+default makes it safe for any future keyword construction too.
+
+### 5. What was NOT touched (detector — staged)
+
+- No changes to detector/perception wiring, session logic, cadence policy,
+  or any consumer of `EmbryoRole` fields.
+- `detector_name="perception"` on `lineaging` mirrors `calibration` — the
+  staged approach defers any strain→detector decoupling to spec §4 future work.
+- `DEFAULT_ROLE`, `get_role`, `is_valid_role`, `list_roles` — all unchanged
+  (they work generically over REGISTRY).
+
+## TDD evidence
+
+File: `tests/test_roles_registry.py` (created, 22 tests)
+
+```
+tests/test_roles_registry.py::test_test_role_class_is_subject PASSED
+tests/test_roles_registry.py::test_unassigned_role_class_is_subject PASSED
+tests/test_roles_registry.py::test_calibration_role_class_is_reference PASSED
+tests/test_roles_registry.py::test_lineaging_role_exists_in_registry PASSED
+tests/test_roles_registry.py::test_lineaging_role_class_is_reference PASSED
+tests/test_roles_registry.py::test_lineaging_ui_color PASSED
+tests/test_roles_registry.py::test_lineaging_ui_icon PASSED
+tests/test_roles_registry.py::test_lineaging_description_contains_lineage PASSED
+tests/test_roles_registry.py::test_lineaging_has_cadence PASSED
+tests/test_roles_registry.py::test_get_role_lineaging_returns_correct_entry PASSED
+tests/test_roles_registry.py::test_is_valid_role_lineaging_true PASSED
+tests/test_roles_registry.py::test_is_valid_role_unknown_false PASSED
+tests/test_roles_registry.py::test_list_roles_includes_lineaging PASSED
+tests/test_roles_registry.py::test_list_roles_sorted PASSED
+tests/test_roles_registry.py::test_get_role_unknown_raises_key_error PASSED
+tests/test_roles_registry.py::test_test_role_fields_unchanged PASSED
+tests/test_roles_registry.py::test_calibration_role_fields_unchanged PASSED
+tests/test_roles_registry.py::test_unassigned_role_fields_unchanged PASSED
+tests/test_roles_registry.py::test_default_role_is_in_registry PASSED
+tests/test_roles_registry.py::test_default_role_is_test PASSED
+tests/test_roles_registry.py::test_embryo_role_is_frozen PASSED
+tests/test_roles_registry.py::test_embryo_role_default_role_class PASSED
+22 passed in 0.12s
+```
+
+Full suite (excluding 3 pre-existing collection errors):
+- Before task-2 changes: 41 pre-existing failures + 4 from this test file against old code = 45 total
+- After task-2 changes: 32 failures, 765 passed — all 32 failures pre-existing (test_eval, test_mesh_service, test_prompt_manager and others), zero new failures introduced.
+
+## Files changed
+
+- `gently/harness/roles.py` — `role_class` field on dataclass + all 4 registry entries
+- `tests/test_roles_registry.py` — new, 22 tests
+
+## Concerns
+
+None. The change is additive and isolated to `roles.py`. The frozen dataclass
+with a defaulted field is backward-compatible. The `lineaging` detector choice
+(`"perception"`) is intentionally the same as calibration — decoupling
+detector-from-use is explicitly deferred to spec §4.

From a697a681fd59a4478fa691482e111206335ce29f Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:24:05 +0530
Subject: [PATCH 234/314] feat(d2): /api/roles route + role-scoped tactic scope
 resolver
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- GET /api/roles returns REGISTRY as {roles:[{name,description,role_class,
  ui_color,ui_icon,default_cadence_seconds}]}; registered in routes/__init__.py
- resolve_scope_embryos() in gently/app/orchestration/role_scope.py maps
  scope.mode in {global,embryos,role} → list[embryo_id]; unknown → []
- _validate_tactics already passes scope through unmodified; role-scoped
  tactics (mode='role', role in REGISTRY) confirmed to pass declare_operation_plan
- Embryo id key confirmed as 'embryo_id' (from /api/embryos/positions)
- 22 new tests: 9 route + 13 resolver/validation; 0 new failures in suite
---
 gently/app/orchestration/role_scope.py |  60 ++++++++
 gently/ui/web/routes/__init__.py       |   2 +
 gently/ui/web/routes/roles.py          |  30 ++++
 tests/test_role_scope.py               | 198 +++++++++++++++++++++++++
 tests/test_roles_route.py              |  78 ++++++++++
 5 files changed, 368 insertions(+)
 create mode 100644 gently/app/orchestration/role_scope.py
 create mode 100644 gently/ui/web/routes/roles.py
 create mode 100644 tests/test_role_scope.py
 create mode 100644 tests/test_roles_route.py

diff --git a/gently/app/orchestration/role_scope.py b/gently/app/orchestration/role_scope.py
new file mode 100644
index 00000000..b36bd89e
--- /dev/null
+++ b/gently/app/orchestration/role_scope.py
@@ -0,0 +1,60 @@
+"""Role-scoped tactic target resolver.
+
+``resolve_scope_embryos`` maps a tactic ``scope`` dict + a roster of embryo
+dicts to a list of embryo IDs that the tactic should operate on.
+
+Scope modes
+-----------
+``global``
+    All embryo IDs in the roster.
+``embryos``
+    Explicit list from ``scope['embryo_ids']``.
+``role``
+    IDs of embryos whose ``role`` field matches ``scope['role']``.
+missing/unknown
+    Empty list (safe default — never errors).
+
+Embryo dict shape
+-----------------
+The resolver expects the shape produced by ``/api/embryos/positions``:
+each dict must have an ``'embryo_id'`` key (not just ``'id'``).
+"""
+
+
+def resolve_scope_embryos(scope: dict | None, embryos: list[dict]) -> list[str]:
+    """Return the embryo IDs that match *scope* from *embryos*.
+
+    Parameters
+    ----------
+    scope:
+        Tactic scope dict, e.g. ``{"mode": "role", "role": "test"}``.
+        ``None`` is treated as an unknown scope → returns ``[]``.
+    embryos:
+        List of embryo dicts, each with at minimum ``embryo_id`` and ``role``
+        keys.  Any dict lacking ``embryo_id`` is silently skipped.
+
+    Returns
+    -------
+    list[str]
+        Matched embryo IDs.  Never raises.
+    """
+    if not scope:
+        return []
+
+    mode = scope.get("mode")
+
+    if mode == "global":
+        return [e["embryo_id"] for e in embryos if "embryo_id" in e]
+
+    if mode == "embryos":
+        return list(scope.get("embryo_ids") or [])
+
+    if mode == "role":
+        target_role = scope.get("role")
+        return [
+            e["embryo_id"]
+            for e in embryos
+            if "embryo_id" in e and e.get("role") == target_role
+        ]
+
+    return []
diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index f1ead737..caebd0ec 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -14,6 +14,7 @@
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
 from .operation_plan import create_router as create_operation_plan_router
+from .roles import create_router as create_roles_router
 from .tactic_library import create_router as create_tactic_library_router
 from .temperature import create_router as create_temperature_router
 from .images import create_router as create_images_router
@@ -42,6 +43,7 @@ def register_all_routes(server):
         create_notebook_router,
         create_temperature_router,
         create_operation_plan_router,
+        create_roles_router,
         create_tactic_library_router,
     ):
         router = factory(server)
diff --git a/gently/ui/web/routes/roles.py b/gently/ui/web/routes/roles.py
new file mode 100644
index 00000000..057a97e4
--- /dev/null
+++ b/gently/ui/web/routes/roles.py
@@ -0,0 +1,30 @@
+"""Embryo Role Registry route.
+
+Returns the static REGISTRY of embryo roles from ``gently.harness.roles``.
+Never raises a 500 — the registry is global and read-only.
+"""
+
+from fastapi import APIRouter
+
+from gently.harness.roles import REGISTRY
+
+
+def create_router(server) -> APIRouter:  # noqa: ARG001 (server not needed; registry is global)
+    router = APIRouter()
+
+    @router.get("/api/roles")
+    async def get_roles():
+        roles = [
+            {
+                "name": role.name,
+                "description": role.description,
+                "role_class": role.role_class,
+                "ui_color": role.ui_color,
+                "ui_icon": role.ui_icon,
+                "default_cadence_seconds": role.default_cadence_seconds,
+            }
+            for role in REGISTRY.values()
+        ]
+        return {"roles": roles}
+
+    return router
diff --git a/tests/test_role_scope.py b/tests/test_role_scope.py
new file mode 100644
index 00000000..53b8ee1a
--- /dev/null
+++ b/tests/test_role_scope.py
@@ -0,0 +1,198 @@
+"""Tests for resolve_scope_embryos resolver + role-scoped tactic validation (Task 3, D2).
+
+Resolver lives at gently.app.orchestration.role_scope.resolve_scope_embryos.
+
+Contracts:
+- mode='global' → all embryo ids
+- mode='embryos' + embryo_ids → exactly those ids
+- mode='role' + role='test' → ids of embryos with that role
+- mode='role' with unknown role → [] (not an error)
+- missing/unknown mode → []
+- embryo dicts use 'embryo_id' key (from /api/embryos/positions)
+
+Scope validation in declare_operation_plan:
+- A tactic with scope.mode='role' and a valid REGISTRY key passes validation.
+"""
+
+import pytest
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+_EMBRYOS = [
+    {"embryo_id": "e1", "role": "test"},
+    {"embryo_id": "e2", "role": "test"},
+    {"embryo_id": "e3", "role": "calibration"},
+    {"embryo_id": "e4", "role": "lineaging"},
+    {"embryo_id": "e5", "role": "unassigned"},
+]
+
+
+# ---------------------------------------------------------------------------
+# Resolver tests
+# ---------------------------------------------------------------------------
+
+
+def test_global_scope_returns_all_ids():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "global"}, _EMBRYOS)
+    assert set(ids) == {"e1", "e2", "e3", "e4", "e5"}
+
+
+def test_embryos_scope_returns_explicit_ids():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "embryos", "embryo_ids": ["e1", "e3"]}, _EMBRYOS)
+    assert ids == ["e1", "e3"]
+
+
+def test_role_scope_filters_by_role():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "role", "role": "test"}, _EMBRYOS)
+    assert set(ids) == {"e1", "e2"}
+
+
+def test_role_scope_calibration():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "role", "role": "calibration"}, _EMBRYOS)
+    assert ids == ["e3"]
+
+
+def test_role_scope_lineaging():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "role", "role": "lineaging"}, _EMBRYOS)
+    assert ids == ["e4"]
+
+
+def test_role_scope_unknown_role_returns_empty():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "role", "role": "nonexistent_role"}, _EMBRYOS)
+    assert ids == []
+
+
+def test_unknown_mode_returns_empty():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "burst_only"}, _EMBRYOS)
+    assert ids == []
+
+
+def test_missing_mode_returns_empty():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({}, _EMBRYOS)
+    assert ids == []
+
+
+def test_none_scope_returns_empty():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos(None, _EMBRYOS)
+    assert ids == []
+
+
+def test_empty_embryo_list():
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    ids = resolve_scope_embryos({"mode": "global"}, [])
+    assert ids == []
+
+
+def test_embryo_id_key_used_not_id():
+    """Resolver must read 'embryo_id', not 'id'."""
+    from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+    # If resolver accidentally uses 'id', this returns []
+    embryos = [{"embryo_id": "eX", "role": "test"}]
+    ids = resolve_scope_embryos({"mode": "global"}, embryos)
+    assert "eX" in ids
+
+
+# ---------------------------------------------------------------------------
+# declare_operation_plan: role-scoped tactic passes validation
+# ---------------------------------------------------------------------------
+
+
+class _FakeContextStore:
+    def __init__(self):
+        self._plans = {}
+
+    def set_operation_plan(self, sid, plan):
+        self._plans[sid] = plan
+
+    def get_operation_plan(self, sid):
+        return self._plans.get(sid)
+
+
+class _FakeAgent:
+    def __init__(self):
+        self.context_store = _FakeContextStore()
+        self.session_id = "sess_scope_test"
+
+
+@pytest.mark.asyncio
+async def test_role_scoped_tactic_passes_declare_validation():
+    """A tactic with scope.mode='role' and a valid role key is accepted by declare_operation_plan."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    role_scoped_tactic = {
+        "id": "t-role",
+        "name": "Test-embryo timelapse",
+        "kind": "standing_timelapse",
+        "state": "active",
+        "scope": {"mode": "role", "role": "test"},
+        "rationale": "Only image the test embryos",
+        "structure": {"cadence_s": 120, "per_embryo": []},
+        "live_bind": ["cadence"],
+        "relations": {},
+    }
+
+    ctx = {"agent": _FakeAgent()}
+    result = await declare_operation_plan(
+        title="Role-scoped plan",
+        goal="Image test embryos only",
+        tactics=[role_scoped_tactic],
+        updated_reason="role scope test",
+        context=ctx,
+    )
+
+    assert "Error" not in result, f"Unexpected error: {result}"
+    stored = ctx["agent"].context_store.get_operation_plan("sess_scope_test")
+    assert stored is not None
+    tactic = stored["tactics"][0]
+    assert tactic["scope"]["mode"] == "role"
+    assert tactic["scope"]["role"] == "test"
+
+
+@pytest.mark.asyncio
+async def test_role_scoped_tactic_all_registry_roles():
+    """All four REGISTRY role keys are accepted as valid scope.role values."""
+    from gently.app.tools.operation_plan_tools import declare_operation_plan
+
+    for role_name in ("test", "calibration", "lineaging", "unassigned"):
+        tactic = {
+            "id": f"t-{role_name}",
+            "name": f"{role_name} monitor",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": {"mode": "role", "role": role_name},
+            "rationale": f"Target {role_name} embryos",
+            "structure": {"cadence_s": 300},
+            "live_bind": [],
+            "relations": {},
+        }
+        ctx = {"agent": _FakeAgent()}
+        result = await declare_operation_plan(
+            title=f"Plan for {role_name}",
+            goal="Role-specific imaging",
+            tactics=[tactic],
+            context=ctx,
+        )
+        assert "Error" not in result, f"Role {role_name!r} was rejected: {result}"
diff --git a/tests/test_roles_route.py b/tests/test_roles_route.py
new file mode 100644
index 00000000..c710673f
--- /dev/null
+++ b/tests/test_roles_route.py
@@ -0,0 +1,78 @@
+"""Tests for GET /api/roles — embryo role registry endpoint (Task 3, D2).
+
+Verifies:
+- Returns all roles in the registry including lineaging and role_class.
+- Each entry has the expected fields.
+- Never raises a 500 (graceful).
+"""
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.ui.web.routes.roles import create_router
+
+
+def _client():
+    """Build a minimal TestClient with only the roles router."""
+    server = object()  # roles route never uses server attributes
+    app = FastAPI()
+    app.include_router(create_router(server))
+    return TestClient(app)
+
+
+def test_roles_returns_200():
+    r = _client().get("/api/roles")
+    assert r.status_code == 200
+
+
+def test_roles_body_has_roles_key():
+    body = _client().get("/api/roles").json()
+    assert "roles" in body
+    assert isinstance(body["roles"], list)
+
+
+def test_roles_includes_all_registry_entries():
+    """All four built-in roles must be present."""
+    roles = _client().get("/api/roles").json()["roles"]
+    names = {r["name"] for r in roles}
+    assert names == {"unassigned", "test", "calibration", "lineaging"}
+
+
+def test_roles_include_lineaging():
+    roles = _client().get("/api/roles").json()["roles"]
+    lineaging = next(r for r in roles if r["name"] == "lineaging")
+    assert lineaging["role_class"] == "reference"
+    assert lineaging["ui_color"] == "#33cc88"
+    assert lineaging["ui_icon"] == "triangle"
+
+
+def test_roles_entry_has_all_required_fields():
+    """Every role entry exposes the required fields."""
+    required = {"name", "description", "role_class", "ui_color", "ui_icon", "default_cadence_seconds"}
+    roles = _client().get("/api/roles").json()["roles"]
+    for role in roles:
+        missing = required - role.keys()
+        assert not missing, f"Role {role.get('name')!r} missing fields: {missing}"
+
+
+def test_test_role_class_is_subject():
+    roles = _client().get("/api/roles").json()["roles"]
+    test_role = next(r for r in roles if r["name"] == "test")
+    assert test_role["role_class"] == "subject"
+
+
+def test_calibration_role_class_is_reference():
+    roles = _client().get("/api/roles").json()["roles"]
+    cal = next(r for r in roles if r["name"] == "calibration")
+    assert cal["role_class"] == "reference"
+
+
+def test_cadence_seconds_is_numeric():
+    roles = _client().get("/api/roles").json()["roles"]
+    for role in roles:
+        assert isinstance(role["default_cadence_seconds"], (int, float))
+
+
+def test_never_500():
+    """The route must never raise a 500 regardless of server state."""
+    r = _client().get("/api/roles")
+    assert r.status_code != 500

From b1a47ced30317da71ac2a5d051856236963c624e Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:34:27 +0530
Subject: [PATCH 235/314] =?UTF-8?q?feat(d2):=20Operations=20roster=20lens?=
 =?UTF-8?q?=20=E2=80=94=20embryos=20by=20role=20+=20strain?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add a population roster lens above the tactic spine in the Operations
view. Reads /api/embryos/positions (role, strain, cadence_phase) and
/api/roles (ui_color, ui_icon, role_class) fetched in parallel at init
and on each debounced refresh.

Roster structure:
- SUBJECTS section (role_class=subject, foregrounded, animated live dot)
- REFERENCES section (role_class=reference, compact/muted rows)
- Within each class: role groups with left-edge in real REGISTRY ui_color
- Each embryo row: id · role chip · strain · cadence-phase chip ·
  current tactic (cross-referenced from plan scope) · state

Tactic spine nodes gain role-scope badges when roster context is present:
  → test · E01, E02, E03  (role mode, magenta from API)
  → all embryos            (global, muted grey)
  → E01, E02              (explicit embryos, muted grey)

Role colors come from /api/roles ui_color at runtime via inline styles
(_hexToRgba helper); nothing role-specific is hardcoded in experiment.css.

Backward compat: if either endpoint is empty/absent, rosterCtx = null,
the lens is omitted, and the spine renders exactly as before D2. The
fifth rosterCtx argument on _renderOpsTactic defaults to null so all
existing callers (scenario mode etc.) are unaffected.

node --check: PASS
---
 gently/ui/web/static/css/experiment.css       | 267 ++++++++++++++++++
 .../ui/web/static/js/experiment-overview.js   | 253 ++++++++++++++++-
 2 files changed, 514 insertions(+), 6 deletions(-)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 1d48cef5..a9f89bd7 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -1134,3 +1134,270 @@
     border-left: 3px solid var(--text-muted, #8b949e);
     opacity: 0.8;
 }
+
+/* ============================================================
+   D2 — Roster Lens  (.ops-roster* classes)
+   Role accent colors are injected at runtime via inline style
+   from /api/roles — never hardcoded here so the real REGISTRY
+   palette (magenta test #ff66cc, cyan calibration #00cccc,
+   teal lineaging #33cc88) drives the rendering.
+   ============================================================ */
+
+/* Sub-label between roster block and spine */
+.ops-section-label {
+    font-family: var(--ops-mono);
+    font-size: 9.5px;
+    letter-spacing: 0.18em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+    opacity: 0.65;
+    margin: 0 0 10px;
+}
+
+/* Roster container */
+.ops-roster {
+    margin-bottom: 28px;
+    border: 1px solid var(--border, #30363d);
+    border-radius: 12px;
+    overflow: hidden;
+}
+
+.ops-roster-head {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 9px 16px;
+    background: var(--bg-hover, #21262d);
+    border-bottom: 1px solid var(--border, #30363d);
+}
+
+.ops-roster-title {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    letter-spacing: 0.16em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+}
+
+.ops-roster-count {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    color: var(--text-muted);
+    margin-left: auto;
+}
+
+/* Class section (SUBJECTS / REFERENCES) */
+.ops-class-section {
+    border-bottom: 1px solid var(--border, #30363d);
+}
+
+.ops-class-section:last-child {
+    border-bottom: none;
+}
+
+.ops-class-header {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 7px 16px;
+    border-bottom: 1px solid var(--border, #30363d);
+}
+
+.ops-class-header.subject   { background: rgba(245, 166, 35,  0.04); }
+.ops-class-header.reference { background: rgba(139, 148, 158, 0.06); }
+
+.ops-class-label {
+    font-family: var(--ops-mono);
+    font-size: 9px;
+    font-weight: 700;
+    letter-spacing: 0.2em;
+    text-transform: uppercase;
+}
+
+.ops-class-header.subject   .ops-class-label { color: var(--ops-active); }
+.ops-class-header.reference .ops-class-label { color: var(--text-muted); }
+
+.ops-class-desc {
+    font-family: var(--ops-mono);
+    font-size: 9.5px;
+    color: var(--text-muted);
+    opacity: 0.65;
+}
+
+/* Pulsing live dot in the SUBJECTS header */
+.ops-class-live-dot {
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+    background: var(--ops-active);
+    box-shadow: 0 0 0 3px rgba(245, 166, 35, 0.2);
+    animation: ops-roster-pulse 2s ease-in-out infinite;
+    flex-shrink: 0;
+}
+
+@keyframes ops-roster-pulse {
+    0%, 100% { opacity: 1; }
+    50%       { opacity: 0.5; }
+}
+
+/* Role group within a class section */
+.ops-role-group {
+    border-bottom: 1px solid rgba(48, 54, 61, 0.5);
+}
+
+.ops-role-group:last-child {
+    border-bottom: none;
+}
+
+/* Role group header — left edge color injected via inline style */
+.ops-role-header {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 6px 16px;
+    border-left: 3px solid transparent;
+}
+
+.ops-role-name {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.12em;
+    /* color injected via inline style */
+}
+
+.ops-role-sep {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    color: var(--text-muted);
+}
+
+.ops-role-count {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    color: var(--text-muted);
+}
+
+.ops-role-ids {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    color: var(--text-muted);
+    margin-left: 2px;
+}
+
+/* Embryo rows — subjects full size, references compact */
+.ops-roster-embryo {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 6px 16px 6px 20px;
+    border-bottom: 1px solid rgba(48, 54, 61, 0.4);
+    font-family: var(--ops-mono);
+    font-size: 11.5px;
+    transition: background 0.1s;
+}
+
+.ops-roster-embryo:last-child { border-bottom: none; }
+.ops-roster-embryo:hover      { background: var(--bg-hover, #21262d); }
+
+.ops-roster-embryo.compact {
+    padding: 4px 16px 4px 20px;
+    font-size: 10.5px;
+    opacity: 0.8;
+}
+
+/* Embryo row fields */
+.ops-rem-id {
+    color: var(--text);
+    font-weight: 600;
+    min-width: 32px;
+}
+
+/* Role chip — background/color/border via inline style from /api/roles */
+.ops-rem-role-chip {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    padding: 1px 7px;
+    border-radius: 9px;
+    font-size: 9.5px;
+    font-weight: 700;
+    text-transform: lowercase;
+    letter-spacing: 0.04em;
+    border: 1px solid transparent;
+    white-space: nowrap;
+    flex-shrink: 0;
+}
+
+.ops-rem-strain {
+    color: var(--text-muted);
+    font-size: 10.5px;
+    opacity: 0.8;
+    flex: 0 0 auto;
+    max-width: 160px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+/* Cadence phase chip — same visual system as .ops-cadence-phase */
+.ops-rem-phase {
+    padding: 2px 8px;
+    border-radius: 9px;
+    font-size: 10px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+    flex-shrink: 0;
+}
+
+.ops-rem-phase.normal { background: rgba(139, 148, 158, 0.2); color: var(--text-muted); }
+.ops-rem-phase.fast   { background: rgba(251, 146, 60,  0.2); color: var(--accent-orange, #fb923c); }
+.ops-rem-phase.burst  { background: rgba(239, 68,  68,  0.2); color: #f87171; }
+.ops-rem-phase.paused { background: rgba(90,  169, 230, 0.15); color: var(--ops-plan); }
+
+.ops-rem-tactic {
+    color: var(--text);
+    font-size: 11px;
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.ops-rem-state {
+    font-size: 10px;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    flex-shrink: 0;
+}
+
+.ops-rem-state.active { color: var(--ops-active); }
+.ops-rem-state.done   { color: var(--ops-done); }
+
+/* Scope badge on tactic spine nodes */
+.ops-scope-badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    padding: 2px 9px;
+    border-radius: 9px;
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    font-weight: 600;
+    border: 1px solid transparent;
+    text-transform: lowercase;
+    letter-spacing: 0.02em;
+    white-space: nowrap;
+}
+
+/* Global / explicit-embryos scope — static muted style */
+.ops-scope-global {
+    background: rgba(139, 148, 158, 0.15);
+    color: var(--text-muted);
+    border-color: rgba(139, 148, 158, 0.3);
+}
+/* Role-scoped badges use inline style (color/bg/border from /api/roles) */
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index 6ba9b109..f480ea1a 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -19,6 +19,8 @@ const ExperimentOverview = {
     _subscribed: false,      // guard: prevents double-registration across tab re-clicks
     _planRefreshTimer: null, // debounce handle for tactic-event-driven refetch
     _tempUpdateHandler: null,// stored handler ref so it can be off()'d if needed
+    _rosterEmbyros: [],      // embryos from /api/embryos/positions (D2 roster lens)
+    _rolesMap: null,         // Map(role name → registry obj) from /api/roles (D2 roster lens)
 
     async init() {
         console.log('[ExperimentOverview] init() called, view=', this.activeView);
@@ -40,12 +42,17 @@ const ExperimentOverview = {
         this.scenarioMode = false;
         // Fetch plan (overview) and strategy (rules) in parallel so tab-switching
         // between the two views doesn't require a second round-trip.
-        const [plan, strategy] = await Promise.all([
+        // D2: also fetch roster + roles for the roster lens.
+        const [plan, strategy, rosterEmbyros, rolesMap] = await Promise.all([
             this.loadPlan(),
-            this.loadStrategy()
+            this.loadStrategy(),
+            this._loadRoster(),
+            this._loadRolesMap(),
         ]);
         this.activePlan = plan;
         this.activeStrategy = strategy;
+        this._rosterEmbyros = rosterEmbyros;
+        this._rolesMap = rolesMap;
         this.isLive = plan !== null || strategy !== null;
         this.render(strategy);
         this.initialized = true;
@@ -116,12 +123,17 @@ const ExperimentOverview = {
 
     // Debounced plan refetch — coalesces rapid tactic-event bursts into a single
     // fetch+render.  500 ms window matches experiment-strip.js convention.
+    // D2: also re-fetches the embryo roster so the lens stays current.
     _debouncedRefresh() {
         if (this._planRefreshTimer) clearTimeout(this._planRefreshTimer);
         this._planRefreshTimer = setTimeout(async () => {
             this._planRefreshTimer = null;
-            const plan = await this.loadPlan();
+            const [plan, rosterEmbyros] = await Promise.all([
+                this.loadPlan(),
+                this._loadRoster(),
+            ]);
             this.activePlan = plan;
+            this._rosterEmbyros = rosterEmbyros;
             this.isLive = plan !== null;
             this.render(this.activeStrategy);
         }, 500);
@@ -338,8 +350,24 @@ const ExperimentOverview = {
         // Index of the first queued (planned) tactic — gets the "next" badge.
         const firstPlannedIdx = tactics.findIndex(t => t.state === 'planned');
 
+        // Roster lens: visible when embryos + role metadata are both available.
+        // Gracefully absent if either fetch failed or returned nothing (backward compat
+        // with plans that pre-date D2 — spine renders exactly as before).
+        const rosterEmbyros = this._rosterEmbyros || [];
+        const rolesMap = this._rolesMap;
+        const rosterCtx = (rosterEmbyros.length > 0 && rolesMap && rolesMap.size > 0)
+            ? { embryos: rosterEmbyros, rolesMap }
+            : null;
+        const rosterHtml = rosterCtx
+            ? `<div class="ops-section-label">Population roster — by class &amp; role</div>
+               ${this._renderRosterLens(rosterEmbyros, rolesMap, plan, ESC)}`
+            : '';
+        const spineLabel = rosterCtx
+            ? '<div class="ops-section-label">Tactic spine — role-scoped</div>'
+            : '';
+
         const spineNodes = tactics
-            .map((t, idx) => this._renderOpsTactic(t, idx, firstPlannedIdx, ESC))
+            .map((t, idx) => this._renderOpsTactic(t, idx, firstPlannedIdx, ESC, rosterCtx))
             .join('');
 
         root.innerHTML = `
@@ -352,12 +380,15 @@ const ExperimentOverview = {
                     <span><i style="background:var(--ops-active)"></i>in use</span>
                     <span><i style="background:var(--ops-plan)"></i>queued</span>
                 </div>
+                ${rosterHtml}
+                ${spineLabel}
                 <div class="ops-spine">${spineNodes}</div>
             </div>`;
     },
 
     // Render a single tactic node.
-    _renderOpsTactic(t, idx, firstPlannedIdx, ESC) {
+    // rosterCtx = { embryos, rolesMap } | null — when present, adds role-scope badge (D2).
+    _renderOpsTactic(t, idx, firstPlannedIdx, ESC, rosterCtx = null) {
         const STATE_LABEL = { done: 'done', active: 'in use', planned: 'queued', paused: 'paused' };
         const seq = String(t.seq || idx + 1).padStart(2, '0');
         const stateLabel = STATE_LABEL[t.state] || t.state;
@@ -372,11 +403,17 @@ const ExperimentOverview = {
         const summary = live.summary || '';
         const desc = live.desc || '';
 
-        // Header row: name · target · summary
+        // Scope badge — D2: shows role → embryo-ids when roster context is available.
+        const scopeBadge = rosterCtx
+            ? this._renderOpsScopeBadge(t.scope, rosterCtx.embryos, rosterCtx.rolesMap, ESC)
+            : '';
+
+        // Header row: name · target · scope badge · summary
         let inner = `
             <div class="ops-row">
                 <span class="ops-tname">${ESC(t.name)}</span>
                 ${target ? `<span class="ops-target">${ESC(target)}</span>` : ''}
+                ${scopeBadge}
                 ${summary ? `<span class="ops-tsum">${ESC(summary)}</span>` : ''}
             </div>
             ${desc ? `<div class="ops-desc">${ESC(desc)}</div>` : ''}`;
@@ -524,6 +561,210 @@ const ExperimentOverview = {
         return '';
     },
 
+    // =================================================================
+    // D2 — Roster Lens: embryo population by role class + role
+    // =================================================================
+
+    // Fetch the current embryo roster from /api/embryos/positions.
+    // Returns [] on failure or when no embryos have positions yet.
+    async _loadRoster() {
+        try {
+            const resp = await fetch('/api/embryos/positions', { cache: 'no-store' });
+            if (!resp.ok) return [];
+            const data = await resp.json();
+            return Array.isArray(data.embryos) ? data.embryos : [];
+        } catch (e) {
+            console.warn('[ExperimentOverview] roster fetch error:', e);
+            return [];
+        }
+    },
+
+    // Fetch the roles registry from /api/roles.
+    // Returns a Map(name → {ui_color, ui_icon, role_class, default_cadence_seconds}).
+    // Returns empty Map on failure.
+    async _loadRolesMap() {
+        try {
+            const resp = await fetch('/api/roles', { cache: 'no-store' });
+            if (!resp.ok) return new Map();
+            const data = await resp.json();
+            const map = new Map();
+            if (Array.isArray(data.roles)) {
+                for (const r of data.roles) {
+                    map.set(r.name, r);
+                }
+            }
+            return map;
+        } catch (e) {
+            console.warn('[ExperimentOverview] roles fetch error:', e);
+            return new Map();
+        }
+    },
+
+    // Convert a hex color (#rrggbb) to rgba(r,g,b,alpha) for inline styles.
+    _hexToRgba(hex, alpha) {
+        const h = (hex || '#888888').replace('#', '');
+        const r = parseInt(h.slice(0, 2), 16) || 0;
+        const g = parseInt(h.slice(2, 4), 16) || 0;
+        const b = parseInt(h.slice(4, 6), 16) || 0;
+        return `rgba(${r},${g},${b},${alpha})`;
+    },
+
+    // Cross-reference: find the name of the active (or most recently done) tactic
+    // that covers a given embryo (by embryo_id + role).
+    // Scope resolution: global → covers all; role → covers matching role;
+    // embryos → covers listed ids. Returns '' when no tactic found.
+    _resolveCurrentTactic(embryoId, role, plan) {
+        if (!plan || !Array.isArray(plan.tactics)) return '';
+        const covers = (t) => {
+            const scope = t.scope || { mode: 'global' };
+            if (scope.mode === 'global') return true;
+            if (scope.mode === 'role') return scope.role === role;
+            if (scope.mode === 'embryos') {
+                return Array.isArray(scope.embryo_ids) && scope.embryo_ids.includes(embryoId);
+            }
+            return false;
+        };
+        // Prefer the active tactic covering this embryo.
+        const active = plan.tactics.find(t => t.state === 'active' && covers(t));
+        if (active) return active.name;
+        // Fall back to the most recently done tactic (last in array order).
+        for (let i = plan.tactics.length - 1; i >= 0; i--) {
+            if (plan.tactics[i].state === 'done' && covers(plan.tactics[i])) {
+                return plan.tactics[i].name;
+            }
+        }
+        return '';
+    },
+
+    // Render a scope badge for a tactic node in the spine.
+    // Colors for role-scoped badges come from the roles registry (API), not CSS.
+    // Global and explicit-embryos scopes use the static `.ops-scope-global` class.
+    _renderOpsScopeBadge(scope, embryos, rolesMap, ESC) {
+        if (!scope || scope.mode === 'global') {
+            return '<span class="ops-scope-badge ops-scope-global">→ all embryos</span>';
+        }
+        if (scope.mode === 'role') {
+            const role = scope.role || '';
+            const roleInfo = rolesMap ? rolesMap.get(role) : null;
+            const color = (roleInfo && roleInfo.ui_color) || '#8b949e';
+            const matchIds = embryos
+                .filter(e => e.role === role)
+                .map(e => e.embryo_id)
+                .join(', ');
+            const label = matchIds
+                ? `→ ${ESC(role)} · ${ESC(matchIds)}`
+                : `→ ${ESC(role)}`;
+            const bg = this._hexToRgba(color, 0.12);
+            const border = this._hexToRgba(color, 0.35);
+            return `<span class="ops-scope-badge" style="color:${ESC(color)};background:${bg};border-color:${border}">${label}</span>`;
+        }
+        if (scope.mode === 'embryos') {
+            const ids = ESC((scope.embryo_ids || []).join(', '));
+            return `<span class="ops-scope-badge ops-scope-global">→ ${ids}</span>`;
+        }
+        return '';
+    },
+
+    // Render the D2 roster lens: embryos grouped by role class then by role.
+    // SUBJECTS section is foregrounded; REFERENCES section is compact/muted.
+    // Role colors/icons come from the rolesMap (API data), not from CSS constants.
+    // Returns empty string when embryos array is empty (backward compat).
+    _renderRosterLens(embryos, rolesMap, plan, ESC) {
+        if (!embryos || embryos.length === 0) return '';
+
+        // Group embryos by role_class then by role, preserving first-seen order.
+        const CLASS_ORDER_PREF = ['subject', 'reference'];
+        const classOrder = [];
+        const byClass = {};
+
+        for (const emb of embryos) {
+            const roleInfo = rolesMap.get(emb.role);
+            const cls = (roleInfo && roleInfo.role_class) || 'subject';
+            if (!byClass[cls]) {
+                byClass[cls] = { roleOrder: [], byRole: {} };
+                classOrder.push(cls);
+            }
+            const section = byClass[cls];
+            if (!section.byRole[emb.role]) {
+                section.byRole[emb.role] = [];
+                section.roleOrder.push(emb.role);
+            }
+            section.byRole[emb.role].push(emb);
+        }
+
+        // Canonical class order: subjects first.
+        classOrder.sort((a, b) => {
+            const ai = CLASS_ORDER_PREF.indexOf(a);
+            const bi = CLASS_ORDER_PREF.indexOf(b);
+            return (ai < 0 ? 99 : ai) - (bi < 0 ? 99 : bi);
+        });
+
+        const totalCount = embryos.length;
+        const totalRoles = classOrder.reduce((n, cls) => n + byClass[cls].roleOrder.length, 0);
+
+        const classSections = classOrder.map(cls => {
+            const { roleOrder, byRole } = byClass[cls];
+            const isSubject = cls === 'subject';
+
+            const classHeaderInner = isSubject
+                ? `<span class="ops-class-live-dot"></span><span class="ops-class-label">Subjects</span><span class="ops-class-desc">— adaptive tactics / scenarios</span>`
+                : `<span class="ops-class-label">References</span><span class="ops-class-desc">— steady acquisition</span>`;
+
+            const roleGroups = roleOrder.map(role => {
+                const roleEmbyros = byRole[role];
+                const roleInfo = rolesMap.get(role);
+                const uiColor = (roleInfo && roleInfo.ui_color) || '#8b949e';
+                const uiIcon  = (roleInfo && roleInfo.ui_icon)  || '';
+                const bgRgba  = this._hexToRgba(uiColor, 0.08);
+                const ids = roleEmbyros.map(e => e.embryo_id).join(', ');
+
+                const embryoRows = roleEmbyros.map(emb => {
+                    const cadencePhase = emb.cadence_phase || 'normal';
+                    const strain = emb.strain || '—';
+                    const label  = emb.user_label || emb.embryo_id;
+                    const tacticName = this._resolveCurrentTactic(emb.embryo_id, emb.role, plan);
+                    const stateStr = emb.is_complete ? 'done'
+                                   : cadencePhase === 'paused' ? 'paused'
+                                   : 'active';
+                    const compact = isSubject ? '' : ' compact';
+                    const chipBg     = this._hexToRgba(uiColor, 0.15);
+                    const chipBorder = this._hexToRgba(uiColor, 0.4);
+                    return `<div class="ops-roster-embryo${compact}">
+                        <span class="ops-rem-id">${ESC(label)}</span>
+                        <span class="ops-rem-role-chip" style="background:${chipBg};color:${ESC(uiColor)};border-color:${chipBorder}">${uiIcon ? ESC(uiIcon) + ' ' : ''}${ESC(role)}</span>
+                        <span class="ops-rem-strain">${ESC(strain)}</span>
+                        <span class="ops-rem-phase ${ESC(cadencePhase)}">${ESC(cadencePhase)}</span>
+                        <span class="ops-rem-tactic">${ESC(tacticName || '—')}</span>
+                        <span class="ops-rem-state ${ESC(stateStr)}">${ESC(stateStr)}</span>
+                    </div>`;
+                }).join('');
+
+                return `<div class="ops-role-group">
+                    <div class="ops-role-header" style="border-left-color:${ESC(uiColor)};background:${bgRgba}">
+                        <span class="ops-role-name" style="color:${ESC(uiColor)}">${ESC(role.toUpperCase())}</span>
+                        <span class="ops-role-sep">·</span>
+                        <span class="ops-role-count">${roleEmbyros.length} embryo${roleEmbyros.length !== 1 ? 's' : ''}</span>
+                        <span class="ops-role-ids">${ESC(ids)}</span>
+                    </div>
+                    ${embryoRows}
+                </div>`;
+            }).join('');
+
+            return `<div class="ops-class-section">
+                <div class="ops-class-header ${ESC(cls)}">${classHeaderInner}</div>
+                ${roleGroups}
+            </div>`;
+        }).join('');
+
+        return `<div class="ops-roster">
+            <div class="ops-roster-head">
+                <span class="ops-roster-title">Population roster</span>
+                <span class="ops-roster-count">${totalCount} embryo${totalCount !== 1 ? 's' : ''} · ${totalRoles} role${totalRoles !== 1 ? 's' : ''}</span>
+            </div>
+            ${classSections}
+        </div>`;
+    },
+
     // -----------------------------------------------------------------
     // Rules table — full subtab view, grouped by rule kind
     // -----------------------------------------------------------------

From 866d4e08fc96d7abd7f9ea0bf41c2ba71ccc04d2 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:47:06 +0530
Subject: [PATCH 236/314] fix(d2): surface strain through timelapse_tracker +
 rename _rosterEmbryos + resolver-coupling note
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- timelapse_tracker.py: EMBRYO_DETECTED handler now sets emb["strain"] when
  "strain" key present in data (mirrors role handling); seed_from_experiment
  now passes strain=getattr(emb, "strain", None) in the EMBRYO_DETECTED
  payload — fixes strain always showing "—" in live roster.
- experiment-overview.js: rename _rosterEmbyros → _rosterEmbryos (9 sites,
  property + local variable); add coupling note on _resolveCurrentTactic
  pointing to role_scope.py resolve_scope_embryos.
- tests/test_embryo_strain.py: 4 new tracker tests (EMBRYO_DETECTED handler
  + seed_from_experiment with/without strain); all 10 pass.
---
 .../ui/web/static/js/experiment-overview.js   | 19 ++--
 gently/ui/web/timelapse_tracker.py            |  3 +
 tests/test_embryo_strain.py                   | 89 +++++++++++++++++++
 3 files changed, 102 insertions(+), 9 deletions(-)

diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index f480ea1a..fac90551 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -19,7 +19,7 @@ const ExperimentOverview = {
     _subscribed: false,      // guard: prevents double-registration across tab re-clicks
     _planRefreshTimer: null, // debounce handle for tactic-event-driven refetch
     _tempUpdateHandler: null,// stored handler ref so it can be off()'d if needed
-    _rosterEmbyros: [],      // embryos from /api/embryos/positions (D2 roster lens)
+    _rosterEmbryos: [],      // embryos from /api/embryos/positions (D2 roster lens)
     _rolesMap: null,         // Map(role name → registry obj) from /api/roles (D2 roster lens)
 
     async init() {
@@ -43,7 +43,7 @@ const ExperimentOverview = {
         // Fetch plan (overview) and strategy (rules) in parallel so tab-switching
         // between the two views doesn't require a second round-trip.
         // D2: also fetch roster + roles for the roster lens.
-        const [plan, strategy, rosterEmbyros, rolesMap] = await Promise.all([
+        const [plan, strategy, rosterEmbryos, rolesMap] = await Promise.all([
             this.loadPlan(),
             this.loadStrategy(),
             this._loadRoster(),
@@ -51,7 +51,7 @@ const ExperimentOverview = {
         ]);
         this.activePlan = plan;
         this.activeStrategy = strategy;
-        this._rosterEmbyros = rosterEmbyros;
+        this._rosterEmbryos = rosterEmbryos;
         this._rolesMap = rolesMap;
         this.isLive = plan !== null || strategy !== null;
         this.render(strategy);
@@ -128,12 +128,12 @@ const ExperimentOverview = {
         if (this._planRefreshTimer) clearTimeout(this._planRefreshTimer);
         this._planRefreshTimer = setTimeout(async () => {
             this._planRefreshTimer = null;
-            const [plan, rosterEmbyros] = await Promise.all([
+            const [plan, rosterEmbryos] = await Promise.all([
                 this.loadPlan(),
                 this._loadRoster(),
             ]);
             this.activePlan = plan;
-            this._rosterEmbyros = rosterEmbyros;
+            this._rosterEmbryos = rosterEmbryos;
             this.isLive = plan !== null;
             this.render(this.activeStrategy);
         }, 500);
@@ -353,14 +353,14 @@ const ExperimentOverview = {
         // Roster lens: visible when embryos + role metadata are both available.
         // Gracefully absent if either fetch failed or returned nothing (backward compat
         // with plans that pre-date D2 — spine renders exactly as before).
-        const rosterEmbyros = this._rosterEmbyros || [];
+        const rosterEmbryos = this._rosterEmbryos || [];
         const rolesMap = this._rolesMap;
-        const rosterCtx = (rosterEmbyros.length > 0 && rolesMap && rolesMap.size > 0)
-            ? { embryos: rosterEmbyros, rolesMap }
+        const rosterCtx = (rosterEmbryos.length > 0 && rolesMap && rolesMap.size > 0)
+            ? { embryos: rosterEmbryos, rolesMap }
             : null;
         const rosterHtml = rosterCtx
             ? `<div class="ops-section-label">Population roster — by class &amp; role</div>
-               ${this._renderRosterLens(rosterEmbyros, rolesMap, plan, ESC)}`
+               ${this._renderRosterLens(rosterEmbryos, rolesMap, plan, ESC)}`
             : '';
         const spineLabel = rosterCtx
             ? '<div class="ops-section-label">Tactic spine — role-scoped</div>'
@@ -613,6 +613,7 @@ const ExperimentOverview = {
     // that covers a given embryo (by embryo_id + role).
     // Scope resolution: global → covers all; role → covers matching role;
     // embryos → covers listed ids. Returns '' when no tactic found.
+    // NOTE: mirrors resolve_scope_embryos() in gently/app/orchestration/role_scope.py — keep in sync if a new scope mode is added.
     _resolveCurrentTactic(embryoId, role, plan) {
         if (!plan || !Array.isArray(plan.tactics)) return '';
         const covers = (t) => {
diff --git a/gently/ui/web/timelapse_tracker.py b/gently/ui/web/timelapse_tracker.py
index f980001d..965e4019 100644
--- a/gently/ui/web/timelapse_tracker.py
+++ b/gently/ui/web/timelapse_tracker.py
@@ -216,6 +216,8 @@ def handle_event(self, event_type: str, data: dict):
                     emb["stage_y_um"] = data["y"]
                 if data.get("role"):
                     emb["role"] = data["role"]
+                if "strain" in data:
+                    emb["strain"] = data.get("strain")
                 if data.get("uid"):
                     emb["uid"] = data["uid"]
                 if data.get("user_label"):
@@ -486,6 +488,7 @@ def seed_from_experiment(self, experiment) -> int:
                     "x": x,
                     "y": y,
                     "role": getattr(emb, "role", "test"),
+                    "strain": getattr(emb, "strain", None),
                     "user_label": getattr(emb, "user_label", None),
                     "confidence": getattr(emb, "detection_confidence", None),
                 },
diff --git a/tests/test_embryo_strain.py b/tests/test_embryo_strain.py
index 474a77ef..7f2836eb 100644
--- a/tests/test_embryo_strain.py
+++ b/tests/test_embryo_strain.py
@@ -143,3 +143,92 @@ def test_positions_endpoint_strain_none_when_absent():
     point = resp.json()["embryos"][0]
     assert "strain" in point
     assert point["strain"] is None
+
+
+# ===========================================================================
+# TimelapseStateTracker – Fix 1 (strain surfaces through tracker)
+# ===========================================================================
+
+
+def test_tracker_embryo_detected_sets_strain():
+    """EMBRYO_DETECTED with strain populates the tracker embryo dict."""
+    from gently.ui.web.timelapse_tracker import TimelapseStateTracker
+
+    tracker = TimelapseStateTracker()
+    tracker.handle_event(
+        "EMBRYO_DETECTED",
+        {
+            "embryo_id": "e1",
+            "x": 100.0,
+            "y": 200.0,
+            "role": "test",
+            "strain": "pan-nuclear GFP",
+            "uid": "abc",
+        },
+    )
+    assert tracker.embryos["e1"]["strain"] == "pan-nuclear GFP"
+
+
+def test_tracker_embryo_detected_strain_none_propagates():
+    """EMBRYO_DETECTED with explicit strain=None still writes the key."""
+    from gently.ui.web.timelapse_tracker import TimelapseStateTracker
+
+    tracker = TimelapseStateTracker()
+    tracker.handle_event(
+        "EMBRYO_DETECTED",
+        {
+            "embryo_id": "e2",
+            "x": 0.0,
+            "y": 0.0,
+            "role": "test",
+            "strain": None,
+        },
+    )
+    assert "strain" in tracker.embryos["e2"]
+    assert tracker.embryos["e2"]["strain"] is None
+
+
+def test_tracker_seed_from_experiment_includes_strain():
+    """seed_from_experiment copies strain from EmbryoState into tracker."""
+    from types import SimpleNamespace
+
+    from gently.ui.web.timelapse_tracker import TimelapseStateTracker
+
+    emb = SimpleNamespace(
+        stage_position={"x": 50.0, "y": 60.0},
+        uid="u1",
+        role="test",
+        strain="H2B-mCherry",
+        user_label=None,
+        detection_confidence=0.95,
+    )
+    experiment = SimpleNamespace(embryos={"e3": emb})
+
+    tracker = TimelapseStateTracker()
+    seeded = tracker.seed_from_experiment(experiment)
+
+    assert seeded == 1
+    assert tracker.embryos["e3"]["strain"] == "H2B-mCherry"
+
+
+def test_tracker_seed_from_experiment_strain_absent_is_none():
+    """seed_from_experiment with no strain attribute → tracker strain is None."""
+    from types import SimpleNamespace
+
+    from gently.ui.web.timelapse_tracker import TimelapseStateTracker
+
+    emb = SimpleNamespace(
+        stage_position={"x": 10.0, "y": 20.0},
+        uid="u2",
+        role="control",
+        # no .strain attribute
+        user_label=None,
+        detection_confidence=None,
+    )
+    experiment = SimpleNamespace(embryos={"e4": emb})
+
+    tracker = TimelapseStateTracker()
+    tracker.seed_from_experiment(experiment)
+
+    assert "strain" in tracker.embryos["e4"]
+    assert tracker.embryos["e4"]["strain"] is None

From 4353c10d71f1353eef0e60215f626ba13fb1ceb9 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 05:47:31 +0530
Subject: [PATCH 237/314] chore(d2): untrack .superpowers SDD scratch
 (committed by a subagent)

---
 .superpowers/sdd/d2-task-2-report.md | 106 ---------------------------
 1 file changed, 106 deletions(-)
 delete mode 100644 .superpowers/sdd/d2-task-2-report.md

diff --git a/.superpowers/sdd/d2-task-2-report.md b/.superpowers/sdd/d2-task-2-report.md
deleted file mode 100644
index 5a9a33c4..00000000
--- a/.superpowers/sdd/d2-task-2-report.md
+++ /dev/null
@@ -1,106 +0,0 @@
-# D2 Task 2 Report — roles-as-use: lineaging + subject/reference class
-
-## What was done
-
-### 1. `role_class` field added to `EmbryoRole`
-
-Added `role_class: str = "subject"` as the last field in the frozen dataclass
-(`gently/harness/roles.py`, after `no_object_consecutive_terminal`). Default is
-`"subject"` so any existing keyword-constructed `EmbryoRole` is safe without
-change. Docstring in the module header updated to document the two values
-(`"subject"` | `"reference"`) and their intent.
-
-### 2. `role_class` set on all three existing REGISTRY entries
-
-| Role        | role_class  | Rationale                                      |
-|-------------|-------------|------------------------------------------------|
-| `test`      | `"subject"` | The biological subject — the precious sample.  |
-| `unassigned`| `"subject"` | Safe default: protect like a subject until resolved. |
-| `calibration`| `"reference"` | Reference embryo for staging/calibration.   |
-
-### 3. `lineaging` entry added to REGISTRY
-
-```python
-"lineaging": EmbryoRole(
-    name="lineaging",
-    description=(
-        "Lineage-tracing reference — tracks nuclei/divisions; often a "
-        "pan-nuclear strain but the strain is separate from this use."
-    ),
-    default_cadence_seconds=300.0,
-    detector_name="perception",        # nuclear pipeline, same as calibration
-    photodose_budget_multiplier=5.0,
-    ui_color="#33cc88",                # teal-green — distinct from cyan/magenta
-    ui_icon="triangle",
-    no_object_consecutive_terminal=2,  # reference: gone == gone
-    role_class="reference",
-)
-```
-
-Color distinctness verified: `#33cc88` (teal-green) ≠ `#00cccc` (calibration
-cyan) ≠ `#ff66cc` (test magenta).
-
-### 4. EmbryoRole construction-site check
-
-```
-grep -rn "EmbryoRole(" gently/
-```
-
-Result: only `gently/harness/roles.py` — the three (now four) REGISTRY entries,
-all using keyword arguments. No positional construction anywhere. The new field's
-default makes it safe for any future keyword construction too.
-
-### 5. What was NOT touched (detector — staged)
-
-- No changes to detector/perception wiring, session logic, cadence policy,
-  or any consumer of `EmbryoRole` fields.
-- `detector_name="perception"` on `lineaging` mirrors `calibration` — the
-  staged approach defers any strain→detector decoupling to spec §4 future work.
-- `DEFAULT_ROLE`, `get_role`, `is_valid_role`, `list_roles` — all unchanged
-  (they work generically over REGISTRY).
-
-## TDD evidence
-
-File: `tests/test_roles_registry.py` (created, 22 tests)
-
-```
-tests/test_roles_registry.py::test_test_role_class_is_subject PASSED
-tests/test_roles_registry.py::test_unassigned_role_class_is_subject PASSED
-tests/test_roles_registry.py::test_calibration_role_class_is_reference PASSED
-tests/test_roles_registry.py::test_lineaging_role_exists_in_registry PASSED
-tests/test_roles_registry.py::test_lineaging_role_class_is_reference PASSED
-tests/test_roles_registry.py::test_lineaging_ui_color PASSED
-tests/test_roles_registry.py::test_lineaging_ui_icon PASSED
-tests/test_roles_registry.py::test_lineaging_description_contains_lineage PASSED
-tests/test_roles_registry.py::test_lineaging_has_cadence PASSED
-tests/test_roles_registry.py::test_get_role_lineaging_returns_correct_entry PASSED
-tests/test_roles_registry.py::test_is_valid_role_lineaging_true PASSED
-tests/test_roles_registry.py::test_is_valid_role_unknown_false PASSED
-tests/test_roles_registry.py::test_list_roles_includes_lineaging PASSED
-tests/test_roles_registry.py::test_list_roles_sorted PASSED
-tests/test_roles_registry.py::test_get_role_unknown_raises_key_error PASSED
-tests/test_roles_registry.py::test_test_role_fields_unchanged PASSED
-tests/test_roles_registry.py::test_calibration_role_fields_unchanged PASSED
-tests/test_roles_registry.py::test_unassigned_role_fields_unchanged PASSED
-tests/test_roles_registry.py::test_default_role_is_in_registry PASSED
-tests/test_roles_registry.py::test_default_role_is_test PASSED
-tests/test_roles_registry.py::test_embryo_role_is_frozen PASSED
-tests/test_roles_registry.py::test_embryo_role_default_role_class PASSED
-22 passed in 0.12s
-```
-
-Full suite (excluding 3 pre-existing collection errors):
-- Before task-2 changes: 41 pre-existing failures + 4 from this test file against old code = 45 total
-- After task-2 changes: 32 failures, 765 passed — all 32 failures pre-existing (test_eval, test_mesh_service, test_prompt_manager and others), zero new failures introduced.
-
-## Files changed
-
-- `gently/harness/roles.py` — `role_class` field on dataclass + all 4 registry entries
-- `tests/test_roles_registry.py` — new, 22 tests
-
-## Concerns
-
-None. The change is additive and isolated to `roles.py`. The frozen dataclass
-with a defaulted field is backward-compatible. The `lineaging` detector choice
-(`"perception"`) is intentionally the same as calibration — decoupling
-detector-from-use is explicitly deferred to spec §4.

From a7e41e5b344113b80c48437749ab1069b4406c15 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 07:15:16 +0530
Subject: [PATCH 238/314] =?UTF-8?q?docs(f):=20session=E2=86=94plans=20link?=
 =?UTF-8?q?/delink=20spec=20+=20plan=20(4=20tasks);=20base=20plans=20defer?=
 =?UTF-8?q?red?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../plans/2026-06-29-session-plan-linking.md  | 39 +++++++++++
 .../2026-06-29-session-plan-linking-design.md | 64 +++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-29-session-plan-linking.md
 create mode 100644 docs/superpowers/specs/2026-06-29-session-plan-linking-design.md

diff --git a/docs/superpowers/plans/2026-06-29-session-plan-linking.md b/docs/superpowers/plans/2026-06-29-session-plan-linking.md
new file mode 100644
index 00000000..f58b8a41
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-29-session-plan-linking.md
@@ -0,0 +1,39 @@
+# Session ↔ plans link/delink (F) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development. Steps use `- [ ]`.
+
+**Goal:** Let a session link to multiple plan items, with link/delink from both the Plans tab and the session view. Source of truth = `PlanItem.session_ids` (reverse-query for a session's plans). Base plans deferred.
+
+**Architecture:** Data-layer `unlink_plan_item_session` + `get_plan_items_for_session` (reverse query); link/delink HTTP endpoints; link/delink UI on the Plans-tab item detail + a "Linked plans" panel on the session/Operations view.
+
+## Global Constraints
+- Source of truth for session↔plan-item linkage = `PlanItem.session_ids` (a list; `link_plan_item_session` appends — `file_store.py:1415`). A session's plans = reverse query. Do NOT add a plan_item list to SessionIntent.
+- Campaign edge stays `SessionIntent.campaign_ids` (`link/unlink_session_campaign`). Linking a session to a plan item also `link_session_campaign(item.campaign_id)`. Delink (v1) only removes the plan-item edge.
+- Endpoints mirror `gently/ui/web/routes/campaigns.py` (the item-detail route at :212, PATCH at :324). UI mirrors `campaigns.js` item-detail rendering (~:789-802 Sessions section).
+- Repo/base plans DEFERRED (spec §4) — do not build.
+- Git hygiene: stage only your files by explicit path; never `git add -A`.
+
+---
+
+### Task 1: Data layer — unlink + reverse-query
+**Files:** Modify `gently/harness/memory/file_store.py` — add `unlink_plan_item_session(item_id, session_id)` (remove session from the item's `session_ids`, clear back-compat `session_id` if equal, persist to the campaign plan, fire `_notify_plan_change`; idempotent if absent) and `get_plan_items_for_session(session_id) -> list[PlanItem]` (iterate `get_active_campaigns()` → `get_plan_items(campaign_id)` → filter `session_id in (item.session_ids or [])`). Test: `tests/test_session_plan_linking_store.py`.
+- [ ] Confirm `link_plan_item_session` (:1415) — how it appends to session_ids + persists the plan item to `plan/current.yaml` — and mirror the persistence for unlink. Confirm `get_active_campaigns`/`get_plan_items`.
+- [ ] TDD: link a session to 2 items (different campaigns) → `get_plan_items_for_session` returns both; `unlink_plan_item_session` removes it from one (other remains); unlink absent → no-op; back-compat `session_id` cleared when it matched. `pytest tests/test_session_plan_linking_store.py -v`; `pytest -q` clean. Commit `feat(f): unlink_plan_item_session + get_plan_items_for_session`.
+
+### Task 2: Link/delink endpoints
+**Files:** Modify `gently/ui/web/routes/campaigns.py` — `POST /api/campaigns/{cid}/items/{item_id}/sessions` (body `{session_id}` → `link_plan_item_session` + `link_session_campaign`; return updated sessions) and `DELETE /api/campaigns/{cid}/items/{item_id}/sessions/{session_id}` (→ `unlink_plan_item_session`); add `GET /api/sessions/{id}/plans` in `gently/ui/web/routes/sessions.py` (→ `get_plan_items_for_session`, return `[{id,title,campaign_id,status}]`). Test: `tests/test_session_plan_linking_routes.py`.
+- [ ] Mirror the campaigns route store resolution (`server.context_store`/`gently_store`) + the item-detail route (:212). The session-plans route mirrors `sessions.py` resolution. Graceful (404 item/session; empty list).
+- [ ] TDD (TestClient + mock store): POST links (store.link_plan_item_session + link_session_campaign called); DELETE delinks (unlink called); GET returns the session's plans; bad ids handled. `pytest tests/test_session_plan_linking_routes.py -v`; `pytest -q` clean. Commit `feat(f): session↔plan link/delink endpoints`.
+
+### Task 3: Plans-tab link/delink UI
+**Files:** Modify `gently/ui/web/static/js/campaigns.js` (the item-detail Sessions section ~:789-802 — add a `[+ link session]` picker (sessions from `/api/sessions`) + a `[delink]` button per session, calling the POST/DELETE endpoints then re-rendering the item) + `gently/ui/web/static/css/campaigns.css` (the control styles). 
+- [ ] Render the link control + per-session delink in the item-detail Sessions list; wire to the endpoints; optimistic re-render / refetch the item on success; keep the "No linked sessions" empty state with the link control. `node --check`; build a Chrome-MCP harness (real campaigns.js + a stubbed item-detail + /api/sessions) for the controller to audit. Commit `feat(f): Plans-tab session link/delink controls`.
+
+### Task 4: Session "Linked plans" panel
+**Files:** Modify the session/Operations view JS (`gently/ui/web/static/js/experiment-overview.js` or the session view `review.js` — whichever renders the active session header; CONFIRM which surface) — add a "Linked plans" panel listing `/api/sessions/{id}/plans` rows (title · campaign · status · `[delink]`) + a `[+ link to a plan]` picker (plan items from active campaigns via `/api/campaigns` tree); wire to the same endpoints; CSS as needed.
+- [ ] Confirm the session-scoped render surface + how it knows the current session_id. Render the panel reading `/api/sessions/{id}/plans`; link/delink hit the same endpoints + refresh; symmetric with Task 3. Backward compat: no linked plans → a tidy empty state, no crash. `node --check`; Chrome-MCP harness audit. Commit `feat(f): session Linked-plans panel (link/delink)`.
+
+## Self-Review
+- Data→T1; endpoints→T2; Plans-tab UI→T3; session panel→T4. ✓
+- Open confirmations: link_plan_item_session persistence (T1), campaigns/sessions route patterns (T2), the campaigns.js item-detail render seam (T3), the session-scoped render surface + current session_id (T4).
+- Type consistency: plan-item linkage via `PlanItem.session_ids`; the endpoints + both UIs hit the same POST/DELETE/GET; a link from one surface appears on the other after refresh.
diff --git a/docs/superpowers/specs/2026-06-29-session-plan-linking-design.md b/docs/superpowers/specs/2026-06-29-session-plan-linking-design.md
new file mode 100644
index 00000000..4b3be8f6
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-29-session-plan-linking-design.md
@@ -0,0 +1,64 @@
+# Design: Session ↔ plans link/delink (sub-project F)
+
+Status: design 2026-06-29 (after recon + user steering). Branch `feature/session-plan-linking` (off D2).
+Lets a session link to MULTIPLE plan items, with link/delink from BOTH the Plans tab and the session
+view. "Repo/base plans" is DEFERRED (user has ideas — separate follow-on).
+
+## 0. What exists (recon)
+- Session↔**campaign**: many-to-many (`SessionIntent.campaign_ids` list; `link/unlink_session_campaign`).
+- Session↔**plan-item**: `PlanItem.session_ids` is a LIST (a session can already appear under multiple
+  items in storage) — but a session's *own* notion of "its plans" is a single `active_plan_item_id`
+  pointer, and `SessionIntent` stores no plan-item ids.
+- `attach_session_to_plan` appends to `item.session_ids` (via `link_plan_item_session`) but overwrites
+  the single active pointer; `detach_session_from_plan` only clears the pointer (NOT a data delink).
+- Plans tab (`campaigns.js:789-802`) shows a per-item read-only Sessions list ("No linked sessions").
+- NO link/delink endpoint or UI anywhere; NO `unlink_plan_item_session`; session endpoint returns no linkage.
+
+## 1. The model — source of truth = `PlanItem.session_ids`
+A session's linked plan items = the reverse query over plan items whose `session_ids` includes the
+session. No new field on SessionIntent (avoids dual source of truth). Multi-plan falls out naturally
+(a session can be in many items' `session_ids`). The campaign edge stays on `SessionIntent.campaign_ids`.
+
+- **Link** session↔plan-item: `link_plan_item_session(item_id, session_id)` (exists, appends) +
+  `link_session_campaign(session_id, item.campaign_id)` (exists).
+- **Delink**: NEW `unlink_plan_item_session(item_id, session_id)` — remove the session from
+  `item.session_ids` (+ clear the back-compat `session_id` if it pointed there); fire `_notify_plan_change`.
+  Campaign edge: leave it unless no other item of that campaign links the session (refinement — for v1,
+  delink only touches the plan-item edge; campaign delink stays the existing separate control).
+- **Session's plans**: NEW `get_plan_items_for_session(session_id) -> list[PlanItem]` (reverse query
+  across `get_active_campaigns` → `get_plan_items` → filter `session_id in item.session_ids`).
+
+## 2. Endpoints (mirror `routes/campaigns.py`)
+- `POST /api/campaigns/{cid}/items/{item_id}/sessions` body `{session_id}` → link (link_plan_item_session
+  + link_session_campaign). Returns the updated item sessions.
+- `DELETE /api/campaigns/{cid}/items/{item_id}/sessions/{session_id}` → delink (unlink_plan_item_session).
+- `GET /api/sessions/{id}/plans` → the session's linked plan items (id, title, campaign_id, status) via
+  `get_plan_items_for_session`. (A new sub-route; leaves the existing session payload untouched.)
+
+## 3. UI — both surfaces
+### 3.1 Plans tab item-detail (`campaigns.js` ~:789-802)
+The existing per-item Sessions list gains: a **[+ link session]** control (a picker of recent sessions
+from `/api/sessions`) and a **[delink]** button per listed session. Calls the POST/DELETE endpoints,
+re-renders the item detail. Empty state keeps "No linked sessions" + the link control.
+
+### 3.2 Session / Operations view — "Linked plans" panel
+A panel (in the Operations/experiment view header or a session detail strip) listing the session's
+linked plan items (from `/api/sessions/{id}/plans`): each row `plan item title · campaign · status ·
+[delink]`, plus **[+ link to a plan]** (a picker of plan items from the active campaigns). Symmetric
+with 3.1 — link/delink from either side; both hit the same endpoints + refresh.
+
+## 4. Out of scope (deferred)
+- **Repo/base plans** — the user has ideas; a separate follow-on (a repo plans library / seed). Noted,
+  not built here.
+- Campaign-edge auto-cleanup on plan delink (v1 leaves the campaign link; refine later).
+- Reworking `attach_session_to_plan`/`detach` agent tools beyond what's needed — the data-layer
+  delink (`unlink_plan_item_session`) is added; wiring a `detach` that calls it is a small optional add.
+
+## 5. Testing
+- Data layer: `unlink_plan_item_session` removes the session (+ back-compat session_id); idempotent on
+  absent; `get_plan_items_for_session` reverse-query returns the right items across campaigns; multi-plan
+  (a session under 2 items) round-trips.
+- Endpoints: POST links (item.session_ids gains it + campaign linked); DELETE delinks; GET returns the
+  session's plans; mirror `tests/test_*route*` with a mock store.
+- UI: link/delink controls on both surfaces (node --check + Chrome audit of the Plans-tab item detail +
+  the session "Linked plans" panel); link from one side shows on the other after refresh.

From 775392b418750186b5ec9f4d6c86512c881e6c62 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 07:19:33 +0530
Subject: [PATCH 239/314] feat(f): unlink_plan_item_session +
 get_plan_items_for_session
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds the two missing data-layer pieces for session↔plan linking (Task 1):
- unlink_plan_item_session: mirrors link's load/persist/notify; idempotent;
  clears back-compat session_id scalar when the last session is removed.
- get_plan_items_for_session: reverse query across active campaigns; deduped
  by item id; back-compat via _dict_to_plan_item's existing normalisation.
10 new tests, 0 regressions.
---
 gently/harness/memory/file_store.py      |  45 ++++++
 tests/test_session_plan_linking_store.py | 167 +++++++++++++++++++++++
 2 files changed, 212 insertions(+)
 create mode 100644 tests/test_session_plan_linking_store.py

diff --git a/gently/harness/memory/file_store.py b/gently/harness/memory/file_store.py
index 6eaab365..2e4fb23c 100644
--- a/gently/harness/memory/file_store.py
+++ b/gently/harness/memory/file_store.py
@@ -1437,6 +1437,51 @@ def link_plan_item_session(
         self._notify_plan_change(campaign_id)
         return True
 
+    def unlink_plan_item_session(self, item_id: str, session_id: str) -> bool:
+        """Remove a session from a plan item's session_ids list.
+
+        Mirrors the load/persist/notify pattern of link_plan_item_session.
+        Clears the back-compat scalar session_id when it matched the removed
+        session (sets it to the most-recent remaining session_id, or None).
+        Idempotent: returns False without writing if the session isn't linked.
+        Returns True on successful removal.
+        """
+        loc = self._find_plan_item_location(item_id)
+        if not loc:
+            return False
+        campaign_id, items, idx = loc
+        item = items[idx]
+        sids = item.get("session_ids") or ([item["session_id"]] if item.get("session_id") else [])
+        if session_id not in sids:
+            return False
+        sids = [s for s in sids if s != session_id]
+        item["session_ids"] = sids
+        item["session_id"] = sids[-1] if sids else None  # back-compat: most recent remaining
+        item["updated_at"] = self._now()
+        self._write_plan_items(campaign_id, items)
+        self._notify_plan_change(campaign_id)
+        return True
+
+    def get_plan_items_for_session(self, session_id: str) -> list["PlanItem"]:
+        """Return all plan items linked to a session.
+
+        Iterates active campaigns only (mirrors the normal read path).
+        Back-compat: matches items whose scalar session_id equals the query even
+        when session_ids is empty (old items written before the list field existed).
+        Deduplicates by item id.
+        """
+        seen: set[str] = set()
+        result: list[PlanItem] = []
+        for campaign in self.get_active_campaigns():
+            for item in self.get_plan_items(campaign.id):
+                if item.id in seen:
+                    continue
+                # session_ids is already populated from back-compat in _dict_to_plan_item
+                if session_id in (item.session_ids or []) or item.session_id == session_id:
+                    seen.add(item.id)
+                    result.append(item)
+        return result
+
     def skip_plan_item(self, item_id: str, reason: str | None = None):
         self.update_plan_item(
             item_id,
diff --git a/tests/test_session_plan_linking_store.py b/tests/test_session_plan_linking_store.py
new file mode 100644
index 00000000..5cd72466
--- /dev/null
+++ b/tests/test_session_plan_linking_store.py
@@ -0,0 +1,167 @@
+"""
+FileContextStore: session ↔ plan-item link/delink (Task 1 — data layer).
+
+Tests:
+- link a session to items in 2 different campaigns
+- get_plan_items_for_session returns both items
+- unlink_plan_item_session removes one (the other remains)
+- get_plan_items_for_session returns only the remaining item after unlink
+- unlinking a session that isn't linked → False, no side-effects
+- back-compat scalar session_id is cleared when the unlinked session matched it
+"""
+
+import pytest
+
+from gently.harness.memory.model import PlanItemStatus, PlanItemType
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _make_item(store, campaign_id: str, title: str) -> str:
+    """Create a bench plan item and return its id."""
+    return store.create_plan_item(
+        campaign_id=campaign_id,
+        type=PlanItemType.BENCH.value,
+        title=title,
+    )
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+
+@pytest.fixture()
+def two_campaigns(file_context_store):
+    """Two active campaigns, each with one plan item. Returns (store, cid1, cid2, item1, item2)."""
+    store = file_context_store
+    cid1 = store.create_campaign(description="Campaign Alpha")
+    cid2 = store.create_campaign(description="Campaign Beta")
+    item1 = _make_item(store, cid1, "Step A — bench prep")
+    item2 = _make_item(store, cid2, "Step B — gel run")
+    return store, cid1, cid2, item1, item2
+
+
+# ---------------------------------------------------------------------------
+# Tests
+# ---------------------------------------------------------------------------
+
+
+class TestLinkAndReverseQuery:
+    def test_link_and_get_plan_items_for_session(self, two_campaigns):
+        """Linking a session to 2 items across 2 campaigns; reverse query returns both."""
+        store, _cid1, _cid2, item1, item2 = two_campaigns
+        session_id = "sess_abc"
+
+        store.link_plan_item_session(item1, session_id, set_in_progress=False)
+        store.link_plan_item_session(item2, session_id, set_in_progress=False)
+
+        items = store.get_plan_items_for_session(session_id)
+        ids = {it.id for it in items}
+        assert item1 in ids
+        assert item2 in ids
+        assert len(ids) == 2
+
+    def test_session_not_in_unrelated_item(self, two_campaigns):
+        """Items not linked to the session don't appear in the reverse query."""
+        store, _cid1, _cid2, item1, _item2 = two_campaigns
+        session_id = "sess_xyz"
+
+        store.link_plan_item_session(item1, session_id, set_in_progress=False)
+        items = store.get_plan_items_for_session(session_id)
+        assert len(items) == 1
+        assert items[0].id == item1
+
+    def test_unknown_session_returns_empty(self, two_campaigns):
+        """A session with no links → empty list, no error."""
+        store, *_ = two_campaigns
+        result = store.get_plan_items_for_session("sess_ghost")
+        assert result == []
+
+
+class TestUnlink:
+    def test_unlink_removes_from_one_campaign(self, two_campaigns):
+        """Unlinking a session from one item leaves the other item still linked."""
+        store, _cid1, _cid2, item1, item2 = two_campaigns
+        session_id = "sess_def"
+
+        store.link_plan_item_session(item1, session_id, set_in_progress=False)
+        store.link_plan_item_session(item2, session_id, set_in_progress=False)
+
+        result = store.unlink_plan_item_session(item1, session_id)
+        assert result is True
+
+        remaining = store.get_plan_items_for_session(session_id)
+        ids = {it.id for it in remaining}
+        assert item1 not in ids
+        assert item2 in ids
+
+    def test_unlink_idempotent_returns_false(self, two_campaigns):
+        """Unlinking a session that isn't linked returns False without crashing."""
+        store, _cid1, _cid2, item1, _item2 = two_campaigns
+        result = store.unlink_plan_item_session(item1, "sess_nothere")
+        assert result is False
+
+    def test_unlink_unknown_item_returns_false(self, two_campaigns):
+        """Unlinking from an item that doesn't exist returns False."""
+        store, *_ = two_campaigns
+        result = store.unlink_plan_item_session("item_ghost", "sess_x")
+        assert result is False
+
+    def test_unlink_no_side_effect_when_not_linked(self, two_campaigns):
+        """After a no-op unlink, the item's session_ids are unchanged."""
+        store, _cid1, _cid2, item1, _item2 = two_campaigns
+        session_id = "sess_linked"
+        store.link_plan_item_session(item1, session_id, set_in_progress=False)
+
+        store.unlink_plan_item_session(item1, "sess_other")  # different session — no-op
+
+        item = store.get_plan_item(item1)
+        assert session_id in item.session_ids
+
+    def test_full_unlink_clears_all_sessions(self, two_campaigns):
+        """After unlinking all sessions, get_plan_items_for_session returns nothing."""
+        store, _cid1, _cid2, item1, _item2 = two_campaigns
+        session_id = "sess_ghi"
+
+        store.link_plan_item_session(item1, session_id, set_in_progress=False)
+        store.unlink_plan_item_session(item1, session_id)
+
+        remaining = store.get_plan_items_for_session(session_id)
+        assert remaining == []
+
+
+class TestBackCompatSessionId:
+    def test_back_compat_cleared_on_unlink_when_matched(self, two_campaigns):
+        """Back-compat scalar session_id is set to None when the last session is unlinked."""
+        store, _cid1, _cid2, item1, _item2 = two_campaigns
+        session_id = "sess_jkl"
+
+        store.link_plan_item_session(item1, session_id, set_in_progress=False)
+        item_before = store.get_plan_item(item1)
+        assert item_before.session_id == session_id  # back-compat set by link
+
+        store.unlink_plan_item_session(item1, session_id)
+
+        item_after = store.get_plan_item(item1)
+        assert item_after.session_id is None
+        assert item_after.session_ids == []
+
+    def test_back_compat_set_to_most_recent_remaining(self, two_campaigns):
+        """When one of two sessions is unlinked, back-compat session_id = remaining session."""
+        store, _cid1, _cid2, item1, _item2 = two_campaigns
+        sid1 = "sess_first"
+        sid2 = "sess_second"
+
+        store.link_plan_item_session(item1, sid1, set_in_progress=False)
+        store.link_plan_item_session(item1, sid2, set_in_progress=False)
+
+        store.unlink_plan_item_session(item1, sid1)
+
+        item = store.get_plan_item(item1)
+        assert sid2 in item.session_ids
+        assert item.session_id == sid2  # most recent remaining
+        assert sid1 not in item.session_ids

From 26ea06a88f1d53a79179c3966078684259661a64 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 07:26:29 +0530
Subject: [PATCH 240/314] =?UTF-8?q?feat(f):=20session=E2=86=94plan=20link/?=
 =?UTF-8?q?delink=20endpoints?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

POST /api/campaigns/{cid}/items/{item_id}/sessions — links a session to a
plan item (link_plan_item_session + link_session_campaign) and returns the
campaign's updated sessions. DELETE …/sessions/{sid} delinks via
unlink_plan_item_session, returns {unlinked: bool}. GET
/api/sessions/{session_id}/plans reads plan items for a session via
get_plan_items_for_session, maps to [{id,title,campaign_id,status}].
16/16 route tests pass; no new failures in suite (32 pre-existing).
---
 gently/ui/web/routes/campaigns.py         |  32 +++
 gently/ui/web/routes/sessions.py          |  23 ++
 tests/test_session_plan_linking_routes.py | 274 ++++++++++++++++++++++
 3 files changed, 329 insertions(+)
 create mode 100644 tests/test_session_plan_linking_routes.py

diff --git a/gently/ui/web/routes/campaigns.py b/gently/ui/web/routes/campaigns.py
index b0dbae11..857ed2db 100644
--- a/gently/ui/web/routes/campaigns.py
+++ b/gently/ui/web/routes/campaigns.py
@@ -254,6 +254,38 @@ async def get_item_detail(campaign_id: str, item_id: str):
             "sessions": [_serialize(s) for s in sessions],
         }
 
+    @router.post("/api/campaigns/{campaign_id}/items/{item_id}/sessions")
+    async def link_session_to_item(campaign_id: str, item_id: str, request: Request):
+        """Link a session to a plan item (appends) and record it against the campaign."""
+        cs = _get_store()
+        campaign = _resolve(cs, campaign_id)
+        item = cs.get_plan_item(item_id)
+        if not item:
+            raise HTTPException(status_code=404, detail="Plan item not found")
+
+        body = await request.json()
+        session_id = body.get("session_id")
+        if not session_id:
+            raise HTTPException(status_code=400, detail="session_id required")
+
+        cs.link_plan_item_session(item_id, session_id)
+        cs.link_session_campaign(session_id, campaign.id)
+
+        sessions = cs.get_sessions_for_campaign(item.campaign_id)
+        return {"sessions": [_serialize(s) for s in sessions]}
+
+    @router.delete("/api/campaigns/{campaign_id}/items/{item_id}/sessions/{session_id}")
+    async def unlink_session_from_item(campaign_id: str, item_id: str, session_id: str):
+        """Remove a session link from a plan item. Returns {unlinked: bool}."""
+        cs = _get_store()
+        _resolve(cs, campaign_id)
+        item = cs.get_plan_item(item_id)
+        if not item:
+            raise HTTPException(status_code=404, detail="Plan item not found")
+
+        unlinked = cs.unlink_plan_item_session(item_id, session_id)
+        return {"unlinked": unlinked}
+
     @router.get("/api/campaigns/{campaign_id}/planned-sessions")
     async def get_planned_sessions(campaign_id: str):
         """Planned sessions linked to a campaign."""
diff --git a/gently/ui/web/routes/sessions.py b/gently/ui/web/routes/sessions.py
index ccbc3a93..505e7f0d 100644
--- a/gently/ui/web/routes/sessions.py
+++ b/gently/ui/web/routes/sessions.py
@@ -204,6 +204,29 @@ async def resume_session(session_id: str):
             "rehydrated_projections": rehydrated,
         }
 
+    @router.get("/api/sessions/{session_id}/plans")
+    async def get_session_plans(session_id: str):
+        """Plan items linked to a session, via the context store."""
+        cs = getattr(server, "context_store", None)
+        if cs is None:
+            return {"plans": []}
+        try:
+            items = cs.get_plan_items_for_session(session_id)
+        except Exception as e:
+            logger.warning("get_plan_items_for_session failed for %s: %s", session_id, e)
+            return {"plans": []}
+        return {
+            "plans": [
+                {
+                    "id": item.id,
+                    "title": item.title,
+                    "campaign_id": item.campaign_id,
+                    "status": item.status.value,
+                }
+                for item in items
+            ]
+        }
+
     @router.get("/api/sessions/{session_id}")
     async def get_session(session_id: str):
         """Get session state for review, from the live FileStore.
diff --git a/tests/test_session_plan_linking_routes.py b/tests/test_session_plan_linking_routes.py
new file mode 100644
index 00000000..b9542d4a
--- /dev/null
+++ b/tests/test_session_plan_linking_routes.py
@@ -0,0 +1,274 @@
+"""Route tests: session ↔ plan link/delink HTTP endpoints (Task 2 of F).
+
+Endpoints under test:
+  POST   /api/campaigns/{cid}/items/{item_id}/sessions        → link session to item
+  DELETE /api/campaigns/{cid}/items/{item_id}/sessions/{sid}  → delink session from item
+  GET    /api/sessions/{session_id}/plans                     → plan items for a session
+"""
+
+from datetime import datetime
+from unittest.mock import MagicMock
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.harness.memory.model import PlanItem, PlanItemStatus, PlanItemType, SessionIntent
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _make_item(
+    item_id: str,
+    campaign_id: str,
+    title: str,
+    status: PlanItemStatus = PlanItemStatus.PLANNED,
+) -> PlanItem:
+    return PlanItem(
+        id=item_id,
+        campaign_id=campaign_id,
+        type=PlanItemType.BENCH,
+        title=title,
+        status=status,
+    )
+
+
+def _make_app(mock_cs):
+    """FastAPI test app with campaign + session routers wired to mock_cs."""
+    from gently.ui.web.routes.campaigns import create_router as campaign_router
+    from gently.ui.web.routes.sessions import create_router as session_router
+
+    app = FastAPI()
+
+    class _Server:
+        context_store = mock_cs
+        agent_bridge = None
+        gently_store = None
+
+    server = _Server()
+    app.include_router(campaign_router(server))
+    app.include_router(session_router(server))
+    return app
+
+
+def _mock_cs(item=None, sessions=None):
+    """Build a mock context store with sensible defaults."""
+    cs = MagicMock()
+    cs.resolve_campaign.return_value = MagicMock(id="c1")
+    cs.get_plan_item.return_value = item
+    cs.get_sessions_for_campaign.return_value = sessions if sessions is not None else []
+    cs.unlink_plan_item_session.return_value = True
+    cs.get_plan_items_for_session.return_value = []
+    return cs
+
+
+# ---------------------------------------------------------------------------
+# POST /api/campaigns/{cid}/items/{item_id}/sessions
+# ---------------------------------------------------------------------------
+
+
+class TestPostLinkSession:
+    def test_calls_link_plan_item_session(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item)
+        client = TestClient(_make_app(cs))
+
+        r = client.post("/api/campaigns/c1/items/i1/sessions", json={"session_id": "s1"})
+
+        assert r.status_code == 200
+        cs.link_plan_item_session.assert_called_once_with("i1", "s1")
+
+    def test_calls_link_session_campaign_with_resolved_id(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item)
+        cs.resolve_campaign.return_value = MagicMock(id="c1")
+        client = TestClient(_make_app(cs))
+
+        client.post("/api/campaigns/c1/items/i1/sessions", json={"session_id": "s1"})
+
+        cs.link_session_campaign.assert_called_once_with("s1", "c1")
+
+    def test_returns_sessions_list(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item, sessions=[])
+        client = TestClient(_make_app(cs))
+
+        r = client.post("/api/campaigns/c1/items/i1/sessions", json={"session_id": "s1"})
+
+        assert r.status_code == 200
+        body = r.json()
+        assert "sessions" in body
+        assert isinstance(body["sessions"], list)
+
+    def test_returns_serialized_session_intents(self):
+        item = _make_item("i1", "c1", "Step A")
+        si = SessionIntent(
+            session_id="s1",
+            campaign_ids=["c1"],
+            created_at=datetime(2026, 6, 1),
+        )
+        cs = _mock_cs(item=item, sessions=[si])
+        client = TestClient(_make_app(cs))
+
+        r = client.post("/api/campaigns/c1/items/i1/sessions", json={"session_id": "s1"})
+
+        assert r.status_code == 200
+        sessions = r.json()["sessions"]
+        assert len(sessions) == 1
+        assert sessions[0]["session_id"] == "s1"
+        assert sessions[0]["campaign_ids"] == ["c1"]
+
+    def test_missing_campaign_is_404(self):
+        cs = _mock_cs()
+        cs.resolve_campaign.return_value = None
+        client = TestClient(_make_app(cs))
+
+        r = client.post("/api/campaigns/nope/items/i1/sessions", json={"session_id": "s1"})
+
+        assert r.status_code == 404
+
+    def test_missing_item_is_404(self):
+        cs = _mock_cs(item=None)
+        client = TestClient(_make_app(cs))
+
+        r = client.post("/api/campaigns/c1/items/nope/sessions", json={"session_id": "s1"})
+
+        assert r.status_code == 404
+
+    def test_missing_session_id_body_is_400(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item)
+        client = TestClient(_make_app(cs))
+
+        r = client.post("/api/campaigns/c1/items/i1/sessions", json={})
+
+        assert r.status_code == 400
+
+
+# ---------------------------------------------------------------------------
+# DELETE /api/campaigns/{cid}/items/{item_id}/sessions/{session_id}
+# ---------------------------------------------------------------------------
+
+
+class TestDeleteUnlinkSession:
+    def test_calls_unlink_plan_item_session(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item)
+        cs.unlink_plan_item_session.return_value = True
+        client = TestClient(_make_app(cs))
+
+        r = client.delete("/api/campaigns/c1/items/i1/sessions/s1")
+
+        assert r.status_code == 200
+        cs.unlink_plan_item_session.assert_called_once_with("i1", "s1")
+
+    def test_returns_unlinked_true(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item)
+        cs.unlink_plan_item_session.return_value = True
+        client = TestClient(_make_app(cs))
+
+        r = client.delete("/api/campaigns/c1/items/i1/sessions/s1")
+
+        assert r.status_code == 200
+        assert r.json()["unlinked"] is True
+
+    def test_returns_unlinked_false_when_not_linked(self):
+        item = _make_item("i1", "c1", "Step A")
+        cs = _mock_cs(item=item)
+        cs.unlink_plan_item_session.return_value = False
+        client = TestClient(_make_app(cs))
+
+        r = client.delete("/api/campaigns/c1/items/i1/sessions/s99")
+
+        assert r.status_code == 200
+        assert r.json()["unlinked"] is False
+
+    def test_missing_item_is_404(self):
+        cs = _mock_cs(item=None)
+        client = TestClient(_make_app(cs))
+
+        r = client.delete("/api/campaigns/c1/items/nope/sessions/s1")
+
+        assert r.status_code == 404
+
+    def test_missing_campaign_is_404(self):
+        cs = _mock_cs()
+        cs.resolve_campaign.return_value = None
+        client = TestClient(_make_app(cs))
+
+        r = client.delete("/api/campaigns/nope/items/i1/sessions/s1")
+
+        assert r.status_code == 404
+
+
+# ---------------------------------------------------------------------------
+# GET /api/sessions/{session_id}/plans
+# ---------------------------------------------------------------------------
+
+
+class TestGetSessionPlans:
+    def test_returns_mapped_plan_items(self):
+        cs = _mock_cs()
+        cs.get_plan_items_for_session.return_value = [
+            _make_item("i1", "c1", "Step A", PlanItemStatus.PLANNED),
+            _make_item("i2", "c2", "Step B", PlanItemStatus.IN_PROGRESS),
+        ]
+        client = TestClient(_make_app(cs))
+
+        r = client.get("/api/sessions/s1/plans")
+
+        assert r.status_code == 200
+        plans = r.json()["plans"]
+        assert len(plans) == 2
+        assert plans[0] == {
+            "id": "i1",
+            "title": "Step A",
+            "campaign_id": "c1",
+            "status": "planned",
+        }
+        assert plans[1] == {
+            "id": "i2",
+            "title": "Step B",
+            "campaign_id": "c2",
+            "status": "in_progress",
+        }
+
+    def test_empty_list_for_unknown_session(self):
+        cs = _mock_cs()
+        cs.get_plan_items_for_session.return_value = []
+        client = TestClient(_make_app(cs))
+
+        r = client.get("/api/sessions/ghost/plans")
+
+        assert r.status_code == 200
+        assert r.json()["plans"] == []
+
+    def test_calls_store_with_session_id(self):
+        cs = _mock_cs()
+        client = TestClient(_make_app(cs))
+
+        client.get("/api/sessions/sess_abc/plans")
+
+        cs.get_plan_items_for_session.assert_called_once_with("sess_abc")
+
+    def test_graceful_when_no_context_store(self):
+        from gently.ui.web.routes.sessions import create_router as session_router
+
+        app = FastAPI()
+
+        class _ServerNoCS:
+            context_store = None
+            agent_bridge = None
+            gently_store = None
+
+        server = _ServerNoCS()
+        app.include_router(session_router(server))
+        client = TestClient(app)
+
+        r = client.get("/api/sessions/s1/plans")
+
+        assert r.status_code == 200
+        assert r.json()["plans"] == []

From 73edb37e09d2da172601d2d4f541b2da54d29081 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 07:41:44 +0530
Subject: [PATCH 241/314] feat(f): Plans-tab session link/delink controls
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add [+ link session] picker and per-session [×] delink to the item-detail
Sessions section. Sessions rendered from item.session_ids (item-scoped),
not the campaign pool. Backend get_item_detail now filters to item.session_ids.

Picker: click opens inline select from /api/sessions (already-linked filtered
out), Link → POST /api/.../sessions → selectItem re-fetch; Cancel closes.
Delink: × → DELETE /api/.../sessions/:sid → selectItem re-fetch.
State: _sessionPickerOpen + _availableSessions on state; reset on item switch.
CSS: .session-link-btn, .session-delink-btn, .session-picker* styles added.
node --check: pass. Chrome-MCP harness: scratchpad/flink/index.html (verified
link, delink, picker flow, empty-state, filtered select).
---
 gently/ui/web/routes/campaigns.py      |   8 +-
 gently/ui/web/static/css/campaigns.css | 103 +++++++++++++++++++
 gently/ui/web/static/js/campaigns.js   | 133 +++++++++++++++++++++++--
 3 files changed, 234 insertions(+), 10 deletions(-)

diff --git a/gently/ui/web/routes/campaigns.py b/gently/ui/web/routes/campaigns.py
index 857ed2db..7c463c96 100644
--- a/gently/ui/web/routes/campaigns.py
+++ b/gently/ui/web/routes/campaigns.py
@@ -244,8 +244,12 @@ async def get_item_detail(campaign_id: str, item_id: str):
                 }
             )
 
-        # Sessions linked to this campaign
-        sessions = cs.get_sessions_for_campaign(item.campaign_id)
+        # Sessions — return only those linked to this specific item (item.session_ids),
+        # not all campaign sessions. The frontend uses item.session_ids as the canonical
+        # list and this pool as metadata (name, created_at) for display.
+        item_sids = set(item.session_ids or [])
+        all_sessions = cs.get_sessions_for_campaign(item.campaign_id)
+        sessions = [s for s in all_sessions if s.session_id in item_sids]
 
         return {
             "item": _serialize(item),
diff --git a/gently/ui/web/static/css/campaigns.css b/gently/ui/web/static/css/campaigns.css
index 88690dec..b874ab44 100644
--- a/gently/ui/web/static/css/campaigns.css
+++ b/gently/ui/web/static/css/campaigns.css
@@ -1435,6 +1435,109 @@
     font-size: 0.62rem;
     color: var(--text-muted);
 }
+.detail-session-right {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+}
+.detail-session-empty {
+    color: var(--text-muted);
+    font-size: 0.75rem;
+    font-style: italic;
+}
+
+/* Session link button (header action) */
+.session-link-btn {
+    border: 1px solid var(--border);
+    background: transparent;
+    color: var(--text-muted);
+    border-radius: 6px;
+    padding: 2px 8px;
+    font: inherit;
+    font-size: 0.65rem;
+    cursor: pointer;
+    white-space: nowrap;
+    transition: color 0.15s, border-color 0.15s;
+}
+.session-link-btn:hover {
+    color: var(--text);
+    border-color: var(--accent, #2f6df6);
+}
+
+/* Per-session delink button */
+.session-delink-btn {
+    background: transparent;
+    border: none;
+    color: var(--text-muted);
+    cursor: pointer;
+    font-size: 1rem;
+    line-height: 1;
+    padding: 1px 4px;
+    border-radius: 4px;
+    opacity: 0.45;
+    transition: opacity 0.15s, color 0.15s, background 0.15s;
+}
+.session-delink-btn:hover {
+    opacity: 1;
+    color: var(--accent-orange, #f97316);
+    background: rgba(249,115,22,0.12);
+}
+
+/* Inline session picker */
+.session-picker {
+    margin-top: 8px;
+    padding: 10px;
+    background: rgba(0,0,0,0.18);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+}
+.session-picker--loading {
+    font-size: 0.75rem;
+    color: var(--text-muted);
+    font-style: italic;
+}
+.session-picker-select {
+    width: 100%;
+    background: var(--bg-dark, #0f172a);
+    color: var(--text);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    padding: 6px 8px;
+    font: inherit;
+    font-size: 0.75rem;
+    margin-bottom: 8px;
+    box-sizing: border-box;
+}
+.session-picker-actions {
+    display: flex;
+    gap: 6px;
+}
+.session-picker-link-btn {
+    flex: 1;
+    background: var(--accent, #2f6df6);
+    color: #fff;
+    border: none;
+    border-radius: 6px;
+    padding: 5px 12px;
+    font: inherit;
+    font-size: 0.72rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: opacity 0.15s;
+}
+.session-picker-link-btn:hover { opacity: 0.85; }
+.session-picker-cancel-btn {
+    background: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    padding: 5px 12px;
+    font: inherit;
+    font-size: 0.72rem;
+    cursor: pointer;
+    transition: color 0.15s;
+}
+.session-picker-cancel-btn:hover { color: var(--text); }
 
 /* ================================================================
    SHARED COMPONENTS
diff --git a/gently/ui/web/static/js/campaigns.js b/gently/ui/web/static/js/campaigns.js
index 6a3c3799..c465e3f9 100644
--- a/gently/ui/web/static/js/campaigns.js
+++ b/gently/ui/web/static/js/campaigns.js
@@ -67,6 +67,8 @@ const state = {
     editingSpec: false,         // inspector imaging-spec edit mode
     _inspectorData: null,       // last item-detail payload (for re-render on edit toggle)
     _specError: '',             // inline save error in the spec editor
+    _sessionPickerOpen: false,  // whether the session link picker is visible
+    _availableSessions: null,   // null = not yet loaded, [] = loaded (for link picker)
 };
 
 // ── DOM refs (cached on init) ────────────────────────────
@@ -141,6 +143,10 @@ function boot() {
             case 'spec-edit': e.stopPropagation(); startSpecEdit(); break;
             case 'spec-cancel': e.stopPropagation(); cancelSpecEdit(); break;
             case 'spec-save': e.stopPropagation(); saveSpecEdit(); break;
+            case 'session-picker-open': e.stopPropagation(); openSessionPicker(); break;
+            case 'session-picker-cancel': e.stopPropagation(); cancelSessionPicker(); break;
+            case 'session-picker-link': e.stopPropagation(); submitSessionLink(); break;
+            case 'session-delink': e.stopPropagation(); handleSessionDelink(el.dataset.sessionId); break;
         }
     });
 
@@ -630,6 +636,8 @@ async function selectItem(itemId) {
     if (itemId !== state.selectedItemId) {
         state.editingSpec = false;
         state._specError = '';
+        state._sessionPickerOpen = false;
+        state._availableSessions = null;
     }
     state.selectedItemId = itemId;
 
@@ -673,7 +681,13 @@ function renderInspector(data) {
     const item = data.item;
     const deps = data.dependencies || [];
     const dnts = data.dependents || [];
-    const sessions = data.sessions || [];
+    // Build a metadata map from the campaign-level sessions included in the payload,
+    // then derive the per-item sessions list from item.session_ids (the true source
+    // of truth). data.sessions is the campaign pool; we only show sessions that are
+    // actually linked to THIS item.
+    const _sessionMeta = {};
+    (data.sessions || []).forEach(s => { _sessionMeta[s.session_id || s.id] = s; });
+    const sessions = (item.session_ids || []).map(sid => _sessionMeta[sid] || { session_id: sid, id: sid });
 
     if ($inspectorTitle) $inspectorTitle.textContent = item.title;
     if ($inspectorStatus) {
@@ -786,20 +800,46 @@ function renderInspector(data) {
         html += section('References', refHtml);
     }
 
-    // Sessions
+    // Sessions — item-scoped (item.session_ids), with link/delink controls.
+    const _linkBtn = `<button class="session-link-btn" data-action="session-picker-open">+ link session</button>`;
+    let sessHtml = '';
     if (sessions.length > 0) {
-        let sessHtml = '';
         sessions.forEach(s => {
+            const sid = s.session_id || s.id || '';
+            const name = s.name || s.planned_intent || sid || 'Session';
             sessHtml += `<div class="detail-session">
-                <span class="detail-session-title">${esc(s.planned_intent || s.id || 'Session')}</span>
-                ${s.created_at ? `<span class="detail-session-date">${formatDate(s.created_at)}</span>` : ''}
+                <span class="detail-session-title">${esc(name)}</span>
+                <span class="detail-session-right">
+                    ${s.created_at ? `<span class="detail-session-date">${formatDate(s.created_at)}</span>` : ''}
+                    <button class="session-delink-btn" data-action="session-delink"
+                        data-session-id="${esc(sid)}" title="Delink session">×</button>
+                </span>
             </div>`;
         });
-        html += section('Sessions', sessHtml);
     } else {
-        html += section('Sessions',
-            '<div class="detail-section-content" style="color:var(--text-muted);font-style:italic">No linked sessions</div>');
+        sessHtml = '<div class="detail-session-empty">No linked sessions</div>';
     }
+    // Inline link picker — rendered when openSessionPicker() has set state flag + loaded data.
+    if (state._sessionPickerOpen) {
+        if (state._availableSessions === null) {
+            // Still loading — show spinner text; will re-render once fetch completes.
+            sessHtml += `<div class="session-picker session-picker--loading">Loading sessions…</div>`;
+        } else {
+            const _linkedIds = new Set(item.session_ids || []);
+            const _available = state._availableSessions.filter(s => !_linkedIds.has(s.session_id));
+            const _opts = _available.length === 0
+                ? `<option value="">No other sessions available</option>`
+                : _available.map(s => `<option value="${esc(s.session_id)}">${esc(s.name || s.session_id)}</option>`).join('');
+            sessHtml += `<div class="session-picker">
+                <select class="session-picker-select" id="session-picker-select">${_opts}</select>
+                <div class="session-picker-actions">
+                    <button class="session-picker-link-btn" data-action="session-picker-link">Link</button>
+                    <button class="session-picker-cancel-btn" data-action="session-picker-cancel">Cancel</button>
+                </div>
+            </div>`;
+        }
+    }
+    html += section('Sessions', sessHtml, _linkBtn);
 
     if ($inspectorBody) $inspectorBody.innerHTML = html;
 }
@@ -902,6 +942,83 @@ async function saveSpecEdit() {
     }
 }
 
+// ── Session link / delink ─────────────────────────────────────────────────────
+
+// Open the inline session picker. Fetches /api/sessions and re-renders with the
+// picker shown. Two-phase: immediate re-render with loading state, then again
+// once the fetch resolves (mirrors the pattern of selectItem loading state).
+async function openSessionPicker() {
+    state._sessionPickerOpen = true;
+    state._availableSessions = null;   // triggers loading display
+    if (state._inspectorData) renderInspector(state._inspectorData);
+    try {
+        const res = await fetch('/api/sessions');
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        const body = await res.json();
+        state._availableSessions = body.sessions || [];
+    } catch (err) {
+        console.error('Failed to load sessions for picker:', err);
+        state._availableSessions = [];
+    }
+    if (state._sessionPickerOpen && state._inspectorData) {
+        renderInspector(state._inspectorData);
+    }
+}
+
+function cancelSessionPicker() {
+    state._sessionPickerOpen = false;
+    state._availableSessions = null;
+    if (state._inspectorData) renderInspector(state._inspectorData);
+}
+
+// Read the picker <select>, POST to the link endpoint, then refresh the inspector.
+async function submitSessionLink() {
+    const select = document.getElementById('session-picker-select');
+    const sessionId = select && select.value;
+    if (!sessionId) return;
+    const data = state._inspectorData;
+    const item = data && data.item;
+    const campaignId = state.activeCampaignId;
+    if (!item || !campaignId) return;
+    // Close picker before the async call so a re-render doesn't reopen it.
+    state._sessionPickerOpen = false;
+    state._availableSessions = null;
+    try {
+        const res = await fetch(
+            `/api/campaigns/${encodeURIComponent(campaignId)}/items/${encodeURIComponent(item.id)}/sessions`,
+            {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ session_id: sessionId }),
+            },
+        );
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        selectItem(item.id).catch(() => {});   // re-fetch → re-render with updated session_ids
+    } catch (err) {
+        console.error('Failed to link session:', err);
+        if (state._inspectorData) renderInspector(state._inspectorData);
+    }
+}
+
+// DELETE the session→item edge then refresh the inspector.
+async function handleSessionDelink(sessionId) {
+    if (!sessionId) return;
+    const data = state._inspectorData;
+    const item = data && data.item;
+    const campaignId = state.activeCampaignId;
+    if (!item || !campaignId) return;
+    try {
+        const res = await fetch(
+            `/api/campaigns/${encodeURIComponent(campaignId)}/items/${encodeURIComponent(item.id)}/sessions/${encodeURIComponent(sessionId)}`,
+            { method: 'DELETE' },
+        );
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        selectItem(item.id).catch(() => {});
+    } catch (err) {
+        console.error('Failed to delink session:', err);
+    }
+}
+
 // Hand a planned imaging item to the agent to execute. The agent resolves the
 // item ref, applies its spec, and starts the timelapse (execute_plan_item). We
 // open the chat so the user sees it pick up and can confirm/adjust.

From 3bfe8e562071d07d9e1f24c746159352bdde90b8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 07:57:40 +0530
Subject: [PATCH 242/314] feat(f): session Linked-plans panel (link/delink)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a "Linked plans" panel to the Operations/experiment-overview view
(experiment-overview.js). The panel appends below the tactic spine,
is session-scoped (session_id from /api/operation_plan/current, always
available even when no plan is active), and is symmetric with the
Plans-tab Sessions section added in Task 3.

Panel: fetches GET /api/sessions/{id}/plans + GET /api/campaigns in
parallel; renders title · campaign · status badge · delink (×) per row;
inline plan-item picker (select from unlinked items); POST/DELETE hit
the same Task 2 endpoints; refetches + re-renders on every link/delink.
Empty state: "Not linked to any plan" with link control still present.
Backward compat: no session → no panel; store/network errors → graceful
empty/loading state. node --check passes.
---
 gently/ui/web/static/css/experiment.css       | 225 +++++++++++++++
 .../ui/web/static/js/experiment-overview.js   | 260 ++++++++++++++++++
 2 files changed, 485 insertions(+)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index a9f89bd7..099b584b 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -1401,3 +1401,228 @@
     border-color: rgba(139, 148, 158, 0.3);
 }
 /* Role-scoped badges use inline style (color/bg/border from /api/roles) */
+
+/* ============================================================
+   Linked-plans panel (ops-lp-*) — F / Task 4
+   Session ↔ plan-item link/delink from the Operations view.
+   Appended below the tactic spine + roster; matches ops-* aesthetic.
+   ============================================================ */
+
+.ops-lp {
+    margin-top: 28px;
+    border: 1px solid var(--border, #30363d);
+    border-radius: 12px;
+    overflow: hidden;
+}
+
+/* Section header row: "Linked plans" label + "+ link to a plan" button */
+.ops-lp-head {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 9px 16px;
+    background: var(--bg-hover, #21262d);
+    border-bottom: 1px solid var(--border, #30363d);
+}
+
+.ops-lp-title {
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    letter-spacing: 0.16em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+    flex: 1;
+}
+
+/* "+ link to a plan" button — ghost style matching session-link-btn */
+.ops-lp-link-btn {
+    border: 1px solid var(--border, #30363d);
+    background: transparent;
+    color: var(--text-muted);
+    border-radius: 6px;
+    padding: 2px 9px;
+    font: inherit;
+    font-family: var(--ops-mono);
+    font-size: 10px;
+    cursor: pointer;
+    white-space: nowrap;
+    transition: color 0.15s, border-color 0.15s;
+}
+.ops-lp-link-btn:hover {
+    color: var(--text);
+    border-color: var(--ops-plan, #5aa9e6);
+}
+
+/* Empty state */
+.ops-lp-empty {
+    padding: 14px 16px;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    color: var(--text-muted);
+    font-style: italic;
+}
+
+/* Loading / transient state */
+.ops-lp-loading {
+    padding: 12px 16px;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    color: var(--text-muted);
+    font-style: italic;
+}
+
+/* List of linked plan-item rows */
+.ops-lp-list {
+    padding: 6px 0;
+}
+
+/* Single linked plan row: title · campaign · status · delink */
+.ops-lp-row {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 7px 14px;
+    border-bottom: 1px solid rgba(48, 54, 61, 0.5);
+    font-family: var(--ops-mono);
+    font-size: 11.5px;
+    transition: background 0.1s;
+}
+.ops-lp-row:last-child { border-bottom: none; }
+.ops-lp-row:hover { background: var(--bg-hover, #21262d); }
+
+.ops-lp-row-title {
+    font-size: 12px;
+    color: var(--text);
+    font-weight: 500;
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.ops-lp-row-campaign {
+    font-size: 10px;
+    color: var(--text-muted);
+    opacity: 0.8;
+    flex-shrink: 0;
+    max-width: 160px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.ops-lp-row-status {
+    font-size: 9.5px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.07em;
+    padding: 2px 7px;
+    border-radius: 9px;
+    flex-shrink: 0;
+}
+
+/* Status colour variants mirroring ops- state palette */
+.ops-lp-status-planned {
+    background: rgba(90, 169, 230, 0.12);
+    color: var(--ops-plan, #5aa9e6);
+    border: 1px solid rgba(90, 169, 230, 0.3);
+}
+.ops-lp-status-active {
+    background: rgba(245, 166, 35, 0.12);
+    color: var(--ops-active, #f5a623);
+    border: 1px solid rgba(245, 166, 35, 0.3);
+}
+.ops-lp-status-done {
+    background: rgba(52, 211, 153, 0.1);
+    color: var(--ops-done, #34d399);
+    border: 1px solid rgba(52, 211, 153, 0.25);
+}
+
+/* Per-row delink (×) button */
+.ops-lp-delink {
+    background: transparent;
+    border: none;
+    color: var(--text-muted);
+    cursor: pointer;
+    font-size: 1rem;
+    line-height: 1;
+    padding: 1px 4px;
+    border-radius: 4px;
+    opacity: 0.4;
+    flex-shrink: 0;
+    transition: opacity 0.15s, color 0.15s, background 0.15s;
+}
+.ops-lp-delink:hover {
+    opacity: 1;
+    color: var(--accent-orange, #f97316);
+    background: rgba(249, 115, 22, 0.12);
+}
+
+/* Inline plan-item picker */
+.ops-lp-picker {
+    margin: 8px 14px 12px;
+    padding: 10px;
+    background: rgba(0, 0, 0, 0.18);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 8px;
+}
+.ops-lp-picker--loading {
+    font-size: 11px;
+    color: var(--text-muted);
+    font-style: italic;
+    font-family: var(--ops-mono);
+    background: none;
+    border: none;
+    padding: 10px 14px 12px;
+    margin: 0;
+}
+
+.ops-lp-picker-sel {
+    width: 100%;
+    background: var(--bg-dark, #0f172a);
+    color: var(--text);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 6px;
+    padding: 6px 8px;
+    font: inherit;
+    font-size: 11.5px;
+    font-family: var(--ops-mono);
+    margin-bottom: 8px;
+    box-sizing: border-box;
+}
+
+.ops-lp-picker-actions {
+    display: flex;
+    gap: 6px;
+}
+
+.ops-lp-picker-link-btn {
+    flex: 1;
+    background: var(--ops-plan, #5aa9e6);
+    color: #05101e;
+    border: none;
+    border-radius: 6px;
+    padding: 5px 12px;
+    font: inherit;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    font-weight: 700;
+    cursor: pointer;
+    transition: opacity 0.15s;
+}
+.ops-lp-picker-link-btn:hover { opacity: 0.85; }
+
+.ops-lp-picker-cancel-btn {
+    background: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 6px;
+    padding: 5px 12px;
+    font: inherit;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    cursor: pointer;
+    transition: color 0.15s;
+}
+.ops-lp-picker-cancel-btn:hover { color: var(--text); }
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index fac90551..7f97941b 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -21,6 +21,9 @@ const ExperimentOverview = {
     _tempUpdateHandler: null,// stored handler ref so it can be off()'d if needed
     _rosterEmbryos: [],      // embryos from /api/embryos/positions (D2 roster lens)
     _rolesMap: null,         // Map(role name → registry obj) from /api/roles (D2 roster lens)
+    _currentSessionId: null, // session_id from /api/operation_plan/current (always, even idle)
+    _planPickerOpen: false,  // whether the plan-link picker is visible
+    _pickerItems: null,      // flat plan items for the picker (null=not loaded)
 
     async init() {
         console.log('[ExperimentOverview] init() called, view=', this.activeView);
@@ -105,6 +108,8 @@ const ExperimentOverview = {
 
     // Fetch the agent-authored Operation Plan for the current session.
     // Returns the plan object (plan.tactics etc.) or null when unavailable.
+    // Always captures data.session_id in _currentSessionId so the Linked-plans
+    // panel can work even when no operation plan is active.
     async loadPlan() {
         try {
             const resp = await fetch('/api/operation_plan/current', { cache: 'no-store' });
@@ -113,6 +118,9 @@ const ExperimentOverview = {
                 return null;
             }
             const data = await resp.json();
+            // Capture session_id regardless of plan availability — used by the
+            // Linked-plans panel which is session-scoped, not plan-scoped.
+            this._currentSessionId = data.session_id || null;
             if (!data.available) return null;
             return data.plan || null;
         } catch (e) {
@@ -197,6 +205,10 @@ const ExperimentOverview = {
         }
         // Tear down any prior ticker before we blow away the SVG it pointed at.
         this._stopNowTicker();
+        // Reset plan-picker state on each full render so the picker doesn't persist
+        // across tactic-event-driven re-renders.
+        this._planPickerOpen = false;
+        this._pickerItems = null;
         // Rules view requires the strategy snapshot; show an empty state when absent.
         // Overview view uses this.activePlan — the null/empty case is handled inside
         // _renderOperationSpine (it renders the idle state).
@@ -214,6 +226,12 @@ const ExperimentOverview = {
                 // The swimlane view is retired; this renders this.activePlan.
                 this._renderOperationSpine(root, this.activePlan);
             }
+            // Kick off the async Linked-plans panel (overview tab only).
+            // Fire-and-forget: appends a placeholder immediately, fills after fetch.
+            if (this.activeView === 'overview') {
+                this._initLinkedPlansPanel(root).catch(e =>
+                    console.warn('[ExperimentOverview] linked-plans panel error:', e));
+            }
             console.log('[ExperimentOverview] rendered OK, view=', this.activeView);
         } catch (err) {
             console.error('[ExperimentOverview] render failed:', err);
@@ -233,6 +251,248 @@ const ExperimentOverview = {
     },
 
 
+    // =================================================================
+    // Linked-plans panel — session ↔ plan items (F / Task 4)
+    // Symmetric with the Plans-tab Sessions section (campaigns.js).
+    // Endpoints: GET /api/sessions/{id}/plans
+    //            POST /api/campaigns/{cid}/items/{iid}/sessions
+    //            DELETE .../sessions/{session_id}
+    // =================================================================
+
+    // Initialise and append the Linked-plans panel to the ops-wrap in root.
+    // Async: appends a loading placeholder immediately, fills after fetch.
+    // No-op when no session_id is known (e.g. store not yet initialised).
+    async _initLinkedPlansPanel(root) {
+        if (!this._currentSessionId) return;
+        const wrap = root.querySelector('.ops-wrap');
+        if (!wrap) return;
+
+        // Append placeholder before the async fetch so layout is stable.
+        const panelEl = document.createElement('div');
+        panelEl.className = 'ops-lp';
+        panelEl.innerHTML = '<div class="ops-lp-loading">Loading linked plans…</div>';
+        wrap.appendChild(panelEl);
+
+        const sid = this._currentSessionId;
+        try {
+            const [linkedData, campaignsData] = await Promise.all([
+                fetch(`/api/sessions/${encodeURIComponent(sid)}/plans`, { cache: 'no-store' })
+                    .then(r => r.ok ? r.json() : { plans: [] })
+                    .catch(() => ({ plans: [] })),
+                fetch('/api/campaigns', { cache: 'no-store' })
+                    .then(r => r.ok ? r.json() : { campaigns: [] })
+                    .catch(() => ({ campaigns: [] })),
+            ]);
+            const plans = linkedData.plans || [];
+            const campaignNameMap = {};
+            this._flattenCampaignNames(campaignsData.campaigns || [], campaignNameMap);
+            this._fillLinkedPlansPanel(panelEl, plans, campaignNameMap, sid);
+        } catch (e) {
+            console.warn('[ExperimentOverview] linked-plans init error:', e);
+            panelEl.innerHTML = '<div class="ops-lp-loading">Could not load linked plans.</div>';
+        }
+    },
+
+    // Build a map of campaign_id → display name from the /api/campaigns tree.
+    _flattenCampaignNames(trees, map) {
+        const walk = (tree) => {
+            const c = tree.campaign;
+            if (c && c.id) map[c.id] = c.description || c.shorthand || c.id;
+            for (const child of (tree.children || [])) walk(child);
+        };
+        for (const tree of (trees || [])) walk(tree);
+    },
+
+    // Build a flat list of {id, title, status, campaign_id, campaign_name}
+    // from the /api/campaigns tree, for the plan-item picker.
+    _flattenCampaignItems(trees, campaignNameMap) {
+        const items = [];
+        const walk = (tree, inheritedCid, inheritedName) => {
+            const c = tree.campaign;
+            const cid  = (c && c.id)  || inheritedCid;
+            const name = (c && (c.description || c.shorthand)) || inheritedName || cid;
+            for (const item of (tree.items || [])) {
+                items.push({
+                    id:            item.id,
+                    title:         item.title || item.id,
+                    status:        typeof item.status === 'string' ? item.status
+                                   : (item.status && item.status.value) || 'planned',
+                    campaign_id:   cid,
+                    campaign_name: name,
+                });
+            }
+            for (const child of (tree.children || [])) walk(child, cid, name);
+        };
+        for (const tree of (trees || [])) walk(tree, null, null);
+        return items;
+    },
+
+    // Render the linked-plans panel HTML into panelEl and wire button events.
+    _fillLinkedPlansPanel(panelEl, plans, campaignNameMap, sessionId) {
+        const ESC = this._opsESC.bind(this);
+
+        // Header: section label + "+ link to a plan" button
+        let html = `<div class="ops-lp-head">
+            <span class="ops-lp-title">Linked plans</span>
+            <button class="ops-lp-link-btn" id="ops-lp-link-btn">+ link to a plan</button>
+        </div>`;
+
+        // Linked plan-item rows (title · campaign · status · delink)
+        if (plans.length > 0) {
+            html += '<div class="ops-lp-list">';
+            for (const p of plans) {
+                const cname = campaignNameMap[p.campaign_id] || p.campaign_id || '—';
+                const sCls = p.status === 'completed' ? 'done'
+                    : p.status === 'in_progress'       ? 'active' : 'planned';
+                html += `<div class="ops-lp-row">
+                    <span class="ops-lp-row-title">${ESC(p.title || p.id)}</span>
+                    <span class="ops-lp-row-campaign">${ESC(cname)}</span>
+                    <span class="ops-lp-row-status ops-lp-status-${sCls}">${ESC(p.status || 'planned')}</span>
+                    <button class="ops-lp-delink"
+                        data-item-id="${ESC(p.id)}"
+                        data-campaign-id="${ESC(p.campaign_id)}"
+                        title="Delink this plan item">×</button>
+                </div>`;
+            }
+            html += '</div>';
+        } else {
+            html += '<div class="ops-lp-empty">Not linked to any plan</div>';
+        }
+
+        // Inline picker — shown when _planPickerOpen is set
+        if (this._planPickerOpen) {
+            if (this._pickerItems === null) {
+                // Still fetching — show loading state
+                html += '<div class="ops-lp-picker ops-lp-picker--loading">Loading plan items…</div>';
+            } else {
+                const linkedIds = new Set(plans.map(p => p.id));
+                const available = this._pickerItems.filter(it => !linkedIds.has(it.id));
+                const opts = available.length === 0
+                    ? '<option value="">No other plan items available</option>'
+                    : available.map(it =>
+                        `<option value="${ESC(it.campaign_id)}::${ESC(it.id)}">${ESC(it.campaign_name)}: ${ESC(it.title)}</option>`
+                      ).join('');
+                html += `<div class="ops-lp-picker">
+                    <select class="ops-lp-picker-sel" id="ops-lp-picker-sel">${opts}</select>
+                    <div class="ops-lp-picker-actions">
+                        <button class="ops-lp-picker-link-btn" id="ops-lp-picker-link">Link</button>
+                        <button class="ops-lp-picker-cancel-btn" id="ops-lp-picker-cancel">Cancel</button>
+                    </div>
+                </div>`;
+            }
+        }
+
+        panelEl.innerHTML = html;
+
+        // Wire events directly on the rendered buttons.
+        const sid = sessionId;
+        const linkBtn = panelEl.querySelector('#ops-lp-link-btn');
+        if (linkBtn) {
+            linkBtn.addEventListener('click', () =>
+                this._openPlanPickerInPanel(panelEl, plans, campaignNameMap, sid));
+        }
+        panelEl.querySelectorAll('.ops-lp-delink').forEach(btn => {
+            btn.addEventListener('click', () =>
+                this._delinkPlanItem(panelEl, btn.dataset.itemId, btn.dataset.campaignId, sid));
+        });
+        const submitBtn = panelEl.querySelector('#ops-lp-picker-link');
+        if (submitBtn) {
+            submitBtn.addEventListener('click', () => this._submitPlanLink(panelEl, sid));
+        }
+        const cancelBtn = panelEl.querySelector('#ops-lp-picker-cancel');
+        if (cancelBtn) {
+            cancelBtn.addEventListener('click', () => {
+                this._planPickerOpen = false;
+                this._pickerItems = null;
+                this._fillLinkedPlansPanel(panelEl, plans, campaignNameMap, sid);
+            });
+        }
+    },
+
+    // Open the inline plan-item picker: set loading state, fetch /api/campaigns,
+    // flatten to items, re-render with the picker populated.
+    async _openPlanPickerInPanel(panelEl, plans, campaignNameMap, sessionId) {
+        this._planPickerOpen = true;
+        this._pickerItems = null;  // show loading
+        this._fillLinkedPlansPanel(panelEl, plans, campaignNameMap, sessionId);
+        try {
+            const res = await fetch('/api/campaigns', { cache: 'no-store' });
+            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+            const data = await res.json();
+            this._pickerItems = this._flattenCampaignItems(data.campaigns || [], campaignNameMap);
+        } catch (err) {
+            console.error('[ExperimentOverview] plan picker fetch error:', err);
+            this._pickerItems = [];
+        }
+        if (this._planPickerOpen) {
+            this._fillLinkedPlansPanel(panelEl, plans, campaignNameMap, sessionId);
+        }
+    },
+
+    // POST the selected plan item → session link, then refetch and re-render.
+    async _submitPlanLink(panelEl, sessionId) {
+        const select = panelEl.querySelector('#ops-lp-picker-sel');
+        const value  = select && select.value;
+        if (!value || !value.includes('::')) return;
+        const [campaignId, itemId] = value.split('::');
+        if (!campaignId || !itemId) return;
+
+        this._planPickerOpen = false;
+        this._pickerItems = null;
+        panelEl.innerHTML = '<div class="ops-lp-loading">Linking…</div>';
+        try {
+            const res = await fetch(
+                `/api/campaigns/${encodeURIComponent(campaignId)}/items/${encodeURIComponent(itemId)}/sessions`,
+                {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ session_id: sessionId }),
+                },
+            );
+            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        } catch (err) {
+            console.error('[ExperimentOverview] plan link error:', err);
+        }
+        await this._refetchLinkedPlans(panelEl, sessionId);
+    },
+
+    // DELETE the plan-item → session edge, then refetch and re-render.
+    async _delinkPlanItem(panelEl, itemId, campaignId, sessionId) {
+        panelEl.innerHTML = '<div class="ops-lp-loading">Unlinking…</div>';
+        try {
+            const res = await fetch(
+                `/api/campaigns/${encodeURIComponent(campaignId)}/items/${encodeURIComponent(itemId)}/sessions/${encodeURIComponent(sessionId)}`,
+                { method: 'DELETE' },
+            );
+            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        } catch (err) {
+            console.error('[ExperimentOverview] plan delink error:', err);
+        }
+        await this._refetchLinkedPlans(panelEl, sessionId);
+    },
+
+    // Refetch linked plans + campaigns after a link/delink op, then re-render.
+    async _refetchLinkedPlans(panelEl, sessionId) {
+        try {
+            const [linkedData, campaignsData] = await Promise.all([
+                fetch(`/api/sessions/${encodeURIComponent(sessionId)}/plans`, { cache: 'no-store' })
+                    .then(r => r.ok ? r.json() : { plans: [] })
+                    .catch(() => ({ plans: [] })),
+                fetch('/api/campaigns', { cache: 'no-store' })
+                    .then(r => r.ok ? r.json() : { campaigns: [] })
+                    .catch(() => ({ campaigns: [] })),
+            ]);
+            const plans = linkedData.plans || [];
+            const campaignNameMap = {};
+            this._flattenCampaignNames(campaignsData.campaigns || [], campaignNameMap);
+            this._fillLinkedPlansPanel(panelEl, plans, campaignNameMap, sessionId);
+        } catch (e) {
+            console.warn('[ExperimentOverview] linked-plans refetch error:', e);
+            panelEl.innerHTML = '<div class="ops-lp-loading">Could not reload linked plans.</div>';
+        }
+    },
+
+
 
     _renderRulesView(root, s) {
         // Compact header echoing the session identity

From e2b7e48d0f85b93bf0b9a1a8ad656a720ec51c19 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 08:11:01 +0530
Subject: [PATCH 243/314] fix(f): item-scoped POST response + delink-failure
 re-render + defensive split + back-compat test
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

POST link_session_to_item now re-fetches the item and filters get_sessions_for_campaign
by item.session_ids — identical scope to GET get_item_detail (contract consistency).
handleSessionDelink catch block calls renderInspector to restore UI on failure.
experiment-overview.js picker split limited to 2 parts for defensive id parsing.
Back-compat store tests: legacy scalar-only session_id found by reverse query and
correctly removed by unlink_plan_item_session.
---
 gently/ui/web/routes/campaigns.py             |  7 ++-
 gently/ui/web/static/js/campaigns.js          |  1 +
 .../ui/web/static/js/experiment-overview.js   |  2 +-
 tests/test_session_plan_linking_routes.py     | 12 +++++-
 tests/test_session_plan_linking_store.py      | 43 +++++++++++++++++++
 5 files changed, 62 insertions(+), 3 deletions(-)

diff --git a/gently/ui/web/routes/campaigns.py b/gently/ui/web/routes/campaigns.py
index 7c463c96..4d9ee071 100644
--- a/gently/ui/web/routes/campaigns.py
+++ b/gently/ui/web/routes/campaigns.py
@@ -275,7 +275,12 @@ async def link_session_to_item(campaign_id: str, item_id: str, request: Request)
         cs.link_plan_item_session(item_id, session_id)
         cs.link_session_campaign(session_id, campaign.id)
 
-        sessions = cs.get_sessions_for_campaign(item.campaign_id)
+        # Re-fetch item so session_ids reflects the just-added link; then filter
+        # exactly as get_item_detail does — POST and GET return the same scope.
+        item = cs.get_plan_item(item_id)
+        item_sids = set(item.session_ids or [])
+        all_sessions = cs.get_sessions_for_campaign(item.campaign_id)
+        sessions = [s for s in all_sessions if s.session_id in item_sids]
         return {"sessions": [_serialize(s) for s in sessions]}
 
     @router.delete("/api/campaigns/{campaign_id}/items/{item_id}/sessions/{session_id}")
diff --git a/gently/ui/web/static/js/campaigns.js b/gently/ui/web/static/js/campaigns.js
index c465e3f9..d42cdbd4 100644
--- a/gently/ui/web/static/js/campaigns.js
+++ b/gently/ui/web/static/js/campaigns.js
@@ -1016,6 +1016,7 @@ async function handleSessionDelink(sessionId) {
         selectItem(item.id).catch(() => {});
     } catch (err) {
         console.error('Failed to delink session:', err);
+        renderInspector(state._inspectorData);
     }
 }
 
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index 7f97941b..ce59a4a8 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -434,7 +434,7 @@ const ExperimentOverview = {
         const select = panelEl.querySelector('#ops-lp-picker-sel');
         const value  = select && select.value;
         if (!value || !value.includes('::')) return;
-        const [campaignId, itemId] = value.split('::');
+        const [campaignId, itemId] = value.split('::', 2);
         if (!campaignId || !itemId) return;
 
         this._planPickerOpen = false;
diff --git a/tests/test_session_plan_linking_routes.py b/tests/test_session_plan_linking_routes.py
index b9542d4a..fce5fe52 100644
--- a/tests/test_session_plan_linking_routes.py
+++ b/tests/test_session_plan_linking_routes.py
@@ -103,7 +103,17 @@ def test_returns_sessions_list(self):
         assert isinstance(body["sessions"], list)
 
     def test_returns_serialized_session_intents(self):
-        item = _make_item("i1", "c1", "Step A")
+        # Item must have session_ids=["s1"] to simulate the post-link state
+        # (mock link_plan_item_session doesn't mutate the item; we configure
+        # get_plan_item to return the post-link view so the item-scoped filter works).
+        item = PlanItem(
+            id="i1",
+            campaign_id="c1",
+            type=PlanItemType.BENCH,
+            title="Step A",
+            status=PlanItemStatus.PLANNED,
+            session_ids=["s1"],
+        )
         si = SessionIntent(
             session_id="s1",
             campaign_ids=["c1"],
diff --git a/tests/test_session_plan_linking_store.py b/tests/test_session_plan_linking_store.py
index 5cd72466..9158168c 100644
--- a/tests/test_session_plan_linking_store.py
+++ b/tests/test_session_plan_linking_store.py
@@ -165,3 +165,46 @@ def test_back_compat_set_to_most_recent_remaining(self, two_campaigns):
         assert sid2 in item.session_ids
         assert item.session_id == sid2  # most recent remaining
         assert sid1 not in item.session_ids
+
+
+class TestBackCompatLegacyScalar:
+    """Back-compat path: items written before session_ids list existed (scalar only)."""
+
+    def _inject_legacy_item(self, store, campaign_id: str, item_id: str, session_id: str):
+        """Overwrite a plan item's YAML record to simulate legacy format:
+        session_id set but session_ids absent/empty — as written by pre-list code."""
+        loc = store._find_plan_item_location(item_id)
+        assert loc is not None, "item must exist before injecting legacy format"
+        cid, items, idx = loc
+        items[idx]["session_id"] = session_id
+        items[idx]["session_ids"] = []  # empty list = pre-list legacy state
+        store._write_plan_items(cid, items)
+
+    def test_legacy_scalar_found_by_reverse_query(self, two_campaigns):
+        """get_plan_items_for_session finds an item with only scalar session_id set."""
+        store, cid1, _cid2, item1, _item2 = two_campaigns
+        session_id = "sess_legacy"
+
+        # Inject legacy-format record (scalar session_id, empty session_ids)
+        self._inject_legacy_item(store, cid1, item1, session_id)
+
+        items = store.get_plan_items_for_session(session_id)
+        assert any(it.id == item1 for it in items), (
+            "expected item1 in results for legacy scalar session_id"
+        )
+
+    def test_legacy_scalar_unlinked_by_unlink(self, two_campaigns):
+        """unlink_plan_item_session removes a legacy-scalar item and returns True."""
+        store, cid1, _cid2, item1, _item2 = two_campaigns
+        session_id = "sess_legacy2"
+
+        self._inject_legacy_item(store, cid1, item1, session_id)
+
+        result = store.unlink_plan_item_session(item1, session_id)
+        assert result is True
+
+        # Must no longer appear in reverse query
+        remaining = store.get_plan_items_for_session(session_id)
+        assert not any(it.id == item1 for it in remaining), (
+            "item1 should be removed after unlinking legacy scalar session"
+        )

From 99540bd039a5f7ad7b832328fa6371d6ed30ede8 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 08:13:00 +0530
Subject: [PATCH 244/314] docs: add F + B2 to the wrap-up PR plan stack

---
 docs/superpowers/PR-PLAN.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/superpowers/PR-PLAN.md b/docs/superpowers/PR-PLAN.md
index aeb217d3..042c5e5c 100644
--- a/docs/superpowers/PR-PLAN.md
+++ b/docs/superpowers/PR-PLAN.md
@@ -14,7 +14,9 @@ Each PR diffs cleanly against its parent in the stack; integrate the chain when
 | 3 | `feature/temp-change-tactic` (C) | Automated temp-change burst protocol (`wait_for_temperature_lock` + driver), burst-acquisition wiring, protocol events + agent tool | B1 | per-task + whole-branch review + fixes |
 | 4 | `feature/operations-tab` (D) | **Operations: the agent-authored Operation Plan** — typed declare tool, store, route, execution-linkage (tactic_id + updater), plan-item seeding, operation-spine renderer + live binding | C | 10 tasks + whole-branch (opus) review + 6 fixes; 105 tests; Chrome-audited |
 | 5 | `feature/tactics-library` (G) | Save / list / apply reusable typed tactics (on D's substrate), mirroring plan-templates; apply→Operation Plan | D | 3 tasks + whole-branch review + fixes; ~64 tests |
-| 6 | `feature/embryo-roles-observability` (D2) | Per-embryo **strain** field + roles-as-**use** (lineaging + subject/reference) + multi-embryo Operations roster lens (role + strain) | G | TBD (SDD) |
+| 6 | `feature/embryo-roles-observability` (D2) | Per-embryo **strain** field + roles-as-**use** (lineaging + subject/reference) + multi-embryo Operations roster lens (role + strain) | G | 4 tasks + whole-branch review + fix; 54 tests; Chrome-audited |
+| 7 | `feature/session-plan-linking` (F) | Session↔**plans** link/delink: multi-plan model (`unlink_plan_item_session` + reverse-query), link/delink endpoints, Plans-tab controls + session Linked-plans panel | D2 | 4 tasks + whole-branch review + fix; ~70 tests; both surfaces Chrome-audited |
+| 8 | `feature/manual-mode-dual-camera` (B2) | Dual-camera config + laser-preset browser + timelapse config form (extends B1 manual mode) | F | TBD (SDD) |
 
 Notes:
 - Each branch is the natural unit of "distinct enough to own a PR." Sub-parts (e.g. B1's safety fixes)

From 1f743cebb82b5c0f190cc5c25f2f2d5d2c428314 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 08:18:24 +0530
Subject: [PATCH 245/314] docs(b2): dual-camera + laser-preset + timelapse-form
 spec + plan (3 tasks; live parts rig-deferred)

---
 .../2026-06-29-manual-mode-dual-camera.md     | 38 +++++++++++
 ...26-06-29-manual-mode-dual-camera-design.md | 63 +++++++++++++++++++
 2 files changed, 101 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-06-29-manual-mode-dual-camera.md
 create mode 100644 docs/superpowers/specs/2026-06-29-manual-mode-dual-camera-design.md

diff --git a/docs/superpowers/plans/2026-06-29-manual-mode-dual-camera.md b/docs/superpowers/plans/2026-06-29-manual-mode-dual-camera.md
new file mode 100644
index 00000000..96e4c141
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-29-manual-mode-dual-camera.md
@@ -0,0 +1,38 @@
+# Manual mode B2 — dual-camera + laser-preset browser + timelapse form Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development. Steps use `- [ ]`.
+
+**Goal:** Extend B1's single-camera manual mode with a laser-preset browser, dual-camera (side A/B) config, and a manual timelapse-config form — building the headless parts now (live dual-view + real acquisition are rig-deferred).
+
+**Architecture:** New `require_control` proxy routes wrapping existing client/device-layer + agent-tool paths; device_factory registers a second camera defensively; UI additions to `#devices-view-manual` / `devices.js`.
+
+## Global Constraints
+- HEADLESS-buildable parts only; mark RIG-DEFERRED parts (live dual view, real acquisition/timelapse) as noted in the spec — don't fake hardware.
+- Backward compatible: single-camera rigs must still start (defensive HamCam2 registration); the manual-view-entry laser-off safety (B1 I3) stays intact.
+- Laser preset list already exists: `GET /api/devices/laser/configs` (data.py:526). Reuse it; add only the set proxy + UI.
+- Proxy routes mirror the existing `routes/data.py` `require_control` pattern (e.g. `/api/devices/laser/off` :508). Device-layer/client calls mirror existing ones.
+- UI extends `#devices-view-manual` (index.html ~:720-835) + `DevicesManager` in `devices.js`.
+- Git hygiene: stage only your files by explicit path; never `git add -A`.
+
+---
+
+### Task 1: Laser-preset browser
+**Files:** Modify `gently/ui/web/routes/data.py` (add `POST /api/devices/laser/config` `require_control` → `client.set_laser_config(name)`, mirror `/laser/off` :508); `gently/ui/web/templates/index.html` (the Illumination group ~:800 — replace the static `#devices-ls-laser-status` indicator with a `<select id="devices-laser-preset">` + keep a status line); `gently/ui/web/static/js/devices.js` (populate the select from `GET /api/devices/laser/configs` on manual-view entry; on change `POST /api/devices/laser/config {config}`; default/show "ALL OFF"). Test: `tests/test_laser_preset_route.py`.
+- [ ] Confirm `client.set_laser_config` + the proxy pattern (`/laser/off`) + how devices.js fetches/posts + caches DOM. Add the set proxy + the dropdown; keep the I3 laser-off-on-entry safety (selecting a preset is an explicit override).
+- [ ] TDD: the POST proxy calls `set_laser_config(name)` (TestClient + mock client); bad/missing config → 400. `node --check devices.js`. Build a Chrome harness (stub `/configs` + `/config`) for the controller to audit the dropdown. `pytest tests/test_laser_preset_route.py -v`; `pytest -q` clean. Commit `feat(b2): laser-preset browser (set proxy + manual-mode dropdown)`.
+
+### Task 2: Dual-camera config
+**Files:** Modify `gently/hardware/dispim/device_factory.py` (register `DiSPIMCamera("HamCam2")` as `devices["camera_b"]` DEFENSIVELY — only if in the core's loaded devices; `default_config["camera_b_name"]="HamCam2"`); `gently/hardware/dispim/device_layer.py` (add `side` to `_ls_params` (default 'A') + `handle_lightsheet_params`; `_ensure_lightsheet_sequence_sync` selects `camera`/`camera_b` by side, restart on side change like exposure; a `handle_get_cameras` + route `GET /api/cameras`); `gently/ui/web/routes/data.py` (`GET /api/devices/cameras` proxy + thread `side` through `POST /api/devices/lightsheet/live/params`); `index.html` + `devices.js` (a Side A/B selector). Test: `tests/test_dual_camera_factory.py`, `tests/test_lightsheet_side_param.py`.
+- [ ] Confirm device_factory camera creation (:103-107) + `_ls_params`/`_ensure_lightsheet_sequence_sync` (~:177, :1018-1037) + `handle_lightsheet_params` (:1169). Register camera_b only if present in `core` (skip+log otherwise). Thread `side`; restart sequence on side change.
+- [ ] TDD (fake core with HamCam2 → camera_b created; fake core without → skipped, no crash; side param selects the camera + triggers restart). `node --check`. Chrome harness for the side selector. `pytest tests/test_dual_camera_factory.py tests/test_lightsheet_side_param.py -v`; `pytest -q` clean. Commit `feat(b2): dual-camera config (HamCam2 + side selector)`.
+
+### Task 3: Timelapse config form
+**Files:** Modify `gently/ui/web/routes/data.py` (add `POST /api/devices/timelapse/start` `require_control` → resolve the orchestrator/agent path and call `start_adaptive_timelapse(...)` with validated params: interval_seconds/stop_condition/embryo_ids/condition_value/monitoring_mode + the volume geometry passed through; mirror how the agent tool resolves the orchestrator); `index.html` (a collapsible "Timelapse" panel in the manual rail — cadence/stop/embryos/monitoring_mode + num_slices/exposure/galvo±/piezo±/laser_config); `devices.js` (read `GET /api/devices/scan_geometry` + `/api/devices/laser/configs` for defaults; submit → the new proxy). Test: `tests/test_timelapse_start_route.py`.
+- [ ] Confirm `start_adaptive_timelapse` signature (timelapse_tools.py:61) + how the route can reach the orchestrator (the app server holds it — confirm the proxy's access, or call the device/agent path). Validate params; RIG-DEFERRED real execution — the route wires + validates, returns the orchestrator's result/string.
+- [ ] TDD: the start proxy validates + calls the orchestrator path (mock) with the right params; bad params → 400. `node --check`. Chrome harness for the form. `pytest tests/test_timelapse_start_route.py -v`; `pytest -q` clean. Commit `feat(b2): manual timelapse-config form (start proxy + rail panel)`.
+
+## Self-Review
+- Laser-preset→T1; dual-camera→T2; timelapse-form→T3. ✓
+- Open confirmations: set_laser_config proxy + devices.js patterns (T1); device_factory + _ls_params + side restart (T2); start_adaptive_timelapse reachability from a route (T3).
+- Type consistency: the laser config name string across the proxy + UI; the `side` 'A'/'B' across _ls_params/params/UI; the timelapse param set across the proxy + form.
+- Rig-deferred (explicit): live Multi-Camera dual view, dual-side acquisition, real timelapse execution + galvo/piezo motion.
diff --git a/docs/superpowers/specs/2026-06-29-manual-mode-dual-camera-design.md b/docs/superpowers/specs/2026-06-29-manual-mode-dual-camera-design.md
new file mode 100644
index 00000000..6723a488
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-29-manual-mode-dual-camera-design.md
@@ -0,0 +1,63 @@
+# Design: Manual mode B2 — dual-camera + laser-preset browser + timelapse form
+
+Status: design 2026-06-29 (after recon). Branch `feature/manual-mode-dual-camera` (off F). Extends B1's
+single-camera manual mode with three independent enhancements. Each has a HEADLESS-buildable part (built
++ tested now against a fake MMCore) and a RIG-DEFERRED part (live hardware — verified on the scope).
+
+## 0. What B1 gives us (recon)
+- Single-camera (HamCam1) lightsheet live streamer (`device_layer.py` `_ensure_lightsheet_sequence_sync`
+  → `core.setCameraDevice(cam.name)`, the side-select point), the `#devices-view-manual` UI rail, the
+  `require_control` proxy routes (`routes/data.py`), client methods.
+- **Laser presets already enumerated end-to-end:** `DiSPIMLightSource._get_available_configs` → device-layer
+  `GET /api/laser/configs` → `client.get_laser_configs()` → proxy `GET /api/devices/laser/configs`
+  (returns the 7 `Laser`-group presets). Only the UI consumer + a set-preset proxy are missing.
+- Volume/burst acquisition with full geometry params (`acquire_volume(num_slices, exposure_ms,
+  galvo_amplitude/center, piezo_amplitude/center, laser_config, laser_power_*)`).
+- ASIdiSPIM dual-camera reference: B1 spec §7 (CAMERAA/CAMERAB, Multi-Camera fusion is live-only;
+  dual-acquire = two parallel sequences + `"Camera"`-tag demux).
+
+## 1. Laser-preset browser (smallest — list already exists)
+- **Backend (headless):** new `POST /api/devices/laser/config` (`require_control`) proxy → `client.set_laser_config(name)`.
+  (`/laser/off` today only hardcodes "ALL OFF".)
+- **UI (headless):** replace the static `#devices-ls-laser-status` "OFF (brightfield)" indicator in the
+  Illumination group with a `<select>` populated from `GET /api/devices/laser/configs`; on change POST the
+  chosen preset. Keep "ALL OFF" the safe default + the existing manual-view-entry laser-off safety (don't
+  remove the I3 guard — selecting a preset is an explicit user action).
+- **Rig-deferred:** the actual laser firing (the preset just calls `setConfig` on the rig).
+
+## 2. Dual-camera config
+- **Backend (headless):** register a second `DiSPIMCamera("HamCam2")` as `devices["camera_b"]` in
+  `device_factory.py` — DEFENSIVELY (only if the camera is in the core's loaded devices; skip + log
+  otherwise, so single-camera rigs still start). Add a `side` field ('A'|'B') to `_ls_params` +
+  `handle_lightsheet_params`; `_ensure_lightsheet_sequence_sync` picks `camera` vs `camera_b` by side and
+  restarts the sequence on side change (reuse the exposure-change restart path). New `GET /api/devices/cameras`
+  endpoint listing available camera roles (A always; B if registered).
+- **UI (headless):** a "Side A / B" selector in the manual rail → carries `side` on the live/params POST.
+- **Rig-deferred:** live DUAL view via the "Multi Camera" fusion device (live-only) + dual-side acquisition
+  (two parallel `startSequenceAcquisition` + tag demux). v1 = single live stream, switchable side.
+
+## 3. Timelapse config form
+- **Backend (headless):** new `POST /api/devices/timelapse/start` (`require_control`) proxy wrapping the
+  agent path `start_adaptive_timelapse(embryo_ids, stop_condition, interval_seconds, condition_value,
+  monitoring_mode)` (validate params; resolve the orchestrator like the agent tool does). The volume
+  geometry (num_slices/exposure/galvo±/piezo±/laser_config/power) is captured in the form + passed through
+  / persisted to per-embryo calibration where applicable.
+- **UI (headless):** a collapsible "Timelapse" panel in the manual rail gathering cadence/stop/embryos/
+  monitoring_mode + the volume geometry, reading `GET /api/devices/scan_geometry` + `/api/devices/laser/configs`
+  for defaults. A "Start timelapse" submit → the new proxy.
+- **Rig-deferred:** the actual timelapse run + galvo/piezo motion.
+
+## 4. Out of scope / deferred
+- Live Multi-Camera dual view + dual-side acquisition demux (rig).
+- Saving timelapse configs as reusable presets (could reuse the tactic-library/plan-template later).
+- Per-line laser power UI beyond the preset (the clamps in `optical.py` still apply).
+
+## 5. Testing
+- Laser-preset: the POST proxy (TestClient + mock client asserts `set_laser_config(name)`); `node --check`
+  + Chrome audit of the dropdown populated from a stubbed configs endpoint.
+- Dual-camera: device_factory registers camera_b against a FAKE core that has HamCam2 (and skips when
+  absent); the `side` param threads into `_ls_params` + selects the camera; `/api/devices/cameras` lists
+  roles; `node --check` + Chrome audit of the side selector.
+- Timelapse: the start proxy validates + calls the orchestrator path (mock); the form gathers + posts the
+  params; `node --check` + Chrome audit of the form.
+- All three: backward compatible (single-camera rig unaffected; the laser-off safety intact).

From 340ab96811dc7715f8712171b151c5734aede2b2 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 08:24:20 +0530
Subject: [PATCH 246/314] feat(b2): laser-preset browser (set proxy +
 manual-mode dropdown)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add POST /api/devices/laser/config proxy (require_control, 400 on
missing/empty config, mirrors /laser/off client+error pattern).
Add <select id="devices-laser-preset"> in the Illumination group;
populateLaserPresets() fetches the 7 presets on manual-view entry and
wires onchange → setLaserPreset(). Entry-safety I3 guard (setLaserOff)
fires before populate — preset selection is an explicit post-entry
override. CSS styles for ls-laser-row/label/select added to main.css.
7 TDD tests; node --check clean; Chrome-MCP harness verified.
---
 gently/ui/web/routes/data.py       |  21 +++++
 gently/ui/web/static/css/main.css  |  36 ++++++++
 gently/ui/web/static/js/devices.js |  61 +++++++++++++-
 gently/ui/web/templates/index.html |   7 ++
 tests/test_laser_preset_route.py   | 127 +++++++++++++++++++++++++++++
 5 files changed, 250 insertions(+), 2 deletions(-)
 create mode 100644 tests/test_laser_preset_route.py

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index eed3e5a9..8897b292 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -539,6 +539,27 @@ async def laser_configs():
             logger.exception("Laser configs fetch failed")
             raise HTTPException(status_code=502, detail=f"laser configs failed: {exc}") from exc
 
+    @router.post("/api/devices/laser/config", dependencies=[Depends(require_control)])
+    async def laser_config_set(payload: dict = Body(...)):  # noqa: B008
+        """Apply a named Laser config-group preset (e.g. "ALL OFF", "488 only").
+
+        Body: {"config": "<preset name>"}
+
+        Returns the device layer response.  400 if config is missing/empty;
+        503 if the microscope is not connected; 502 on device error.
+        """
+        config = payload.get("config")
+        if not config or not isinstance(config, str):
+            raise HTTPException(status_code=400, detail="config must be a non-empty string")
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.set_laser_config(config)
+        except Exception as exc:
+            logger.exception("Laser config set command failed")
+            raise HTTPException(status_code=502, detail=f"laser config failed: {exc}") from exc
+
     @router.post("/api/devices/camera/led_mode", dependencies=[Depends(require_control)])
     async def camera_led_mode(payload: dict = Body(...)):  # noqa: B008
         """Enable/disable automatic LED for bottom-camera captures. Body: {"use_led": bool}."""
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 4c04716e..ff964886 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10725,6 +10725,42 @@ body.modal-open {
     flex-shrink: 0;
 }
 
+/* Laser preset row (B2) */
+.ls-laser-row {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    margin-top: 0.2rem;
+}
+
+.ls-laser-label {
+    font-size: 0.6rem;
+    font-weight: 600;
+    letter-spacing: 0.12em;
+    text-transform: uppercase;
+    color: var(--map-ink-mute);
+    flex-shrink: 0;
+}
+
+.ls-laser-select {
+    flex: 1;
+    min-width: 0;
+    background: var(--map-paper-2);
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.62rem;
+    border-radius: 4px;
+    padding: 0.18rem 0.3rem;
+    cursor: pointer;
+    transition: border-color 0.12s;
+}
+
+.ls-laser-select:focus {
+    outline: none;
+    border-color: var(--map-accent);
+}
+
 /* Temperature setpoint button */
 .ls-set-btn {
     background: transparent;
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 2de449e4..fad43df7 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -98,7 +98,8 @@ const DevicesManager = (function () {
     let _lsLedOpen, _lsLedClosed, _lsCamLed, _lsRoomLightBtn;
     let _lsCamLedOn = false;
     let _lsSnapVolBtn, _lsBurstBtn, _lsLastcap, _lsLastcapRef;
-    let _lsLaserStatus;  // span inside .ls-laser-indicator — driven by actual laser/off calls
+    let _lsLaserStatus;   // span inside .ls-laser-indicator — driven by actual laser/off calls
+    let _lsLaserPreset;   // <select id="devices-laser-preset"> — populated on manual-view entry
     let _lsTempInput, _lsTempSet;
 
     // Room-light toggle (header). Drives the SwitchBot Bot that switches the
@@ -201,6 +202,7 @@ const DevicesManager = (function () {
         _lsLastcap       = document.getElementById('devices-ls-lastcap');
         _lsLastcapRef    = document.getElementById('devices-ls-lastcap-ref');
         _lsLaserStatus   = document.getElementById('devices-ls-laser-status');
+        _lsLaserPreset   = document.getElementById('devices-laser-preset');
         _lsTempInput     = document.getElementById('devices-ls-temp-input');
         _lsTempSet       = document.getElementById('devices-ls-temp-set');
 
@@ -1365,6 +1367,59 @@ const DevicesManager = (function () {
         }
     }
 
+    /** Fetch laser config-group presets and populate the #devices-laser-preset select.
+     *  Selects "ALL OFF" by default (entry safety preset).
+     *  Wires the change handler to POST the selected preset.
+     *  Fire-and-forget safe — failure leaves the fallback "ALL OFF" option in place. */
+    async function populateLaserPresets() {
+        cacheDom();
+        if (!_lsLaserPreset) return;
+        try {
+            const res = await fetch('/api/devices/laser/configs');
+            if (!res.ok) return;
+            const data = await res.json();
+            // data may be an array of preset names or {configs: [...]}
+            const presets = Array.isArray(data) ? data : (data.configs || []);
+            if (!presets.length) return;
+            // Rebuild option list
+            _lsLaserPreset.innerHTML = '';
+            for (const name of presets) {
+                const opt = document.createElement('option');
+                opt.value = name;
+                opt.textContent = name;
+                _lsLaserPreset.appendChild(opt);
+            }
+            // Default to "ALL OFF" — entry safety state
+            if (presets.includes('ALL OFF')) _lsLaserPreset.value = 'ALL OFF';
+            // Wire change handler (idempotent — replace via re-assignment)
+            _lsLaserPreset.onchange = () => setLaserPreset(_lsLaserPreset.value);
+        } catch (err) {
+            console.debug('laser preset fetch failed:', err);
+        }
+    }
+
+    /** POST a named laser preset to the device layer.
+     *  Updates the status indicator on success.
+     *  Fire-and-forget safe — failure shows a warning, never throws. */
+    async function setLaserPreset(config) {
+        cacheDom();
+        if (!config) return;
+        try {
+            const res = await fetch('/api/devices/laser/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ config }),
+            });
+            if (_lsLaserStatus) {
+                _lsLaserStatus.textContent = res.ok ? config : 'warning: state unknown';
+            }
+            if (!res.ok) console.debug('laser preset set failed:', await res.text());
+        } catch (err) {
+            if (_lsLaserStatus) _lsLaserStatus.textContent = 'warning: state unknown';
+            console.debug('laser preset set failed:', err);
+        }
+    }
+
     async function toggleLightsheetStream() {
         if (!_lsToggle) return;
         _lsToggle.disabled = true;
@@ -1972,7 +2027,9 @@ const DevicesManager = (function () {
             }
         }
         // Entering Manual view — gate lasers off immediately (brightfield-safe).
-        if (viewName === 'manual') setLaserOff();
+        // populateLaserPresets() runs after setLaserOff() so the select is always
+        // seeded with the entry-safety state first.
+        if (viewName === 'manual') { setLaserOff(); populateLaserPresets(); }
     }
 
     function setupViewSwitcher() {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 1f09ba06..c491eea3 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -797,6 +797,13 @@ <h3 class="devices-properties-title">Properties</h3>
                                 <button class="ls-illum-btn" id="devices-ls-room-light-btn" type="button"
                                         title="Toggle room light" aria-pressed="false">Room Light</button>
                             </div>
+                            <div class="ls-laser-row">
+                                <label class="ls-laser-label" for="devices-laser-preset">Laser preset</label>
+                                <select id="devices-laser-preset" class="ls-laser-select"
+                                        aria-label="Laser preset">
+                                    <option value="ALL OFF">ALL OFF</option>
+                                </select>
+                            </div>
                             <div class="ls-laser-indicator">
                                 <span class="ls-laser-dot"></span>
                                 Laser: <span id="devices-ls-laser-status">OFF (brightfield)</span>
diff --git a/tests/test_laser_preset_route.py b/tests/test_laser_preset_route.py
new file mode 100644
index 00000000..ba6f4538
--- /dev/null
+++ b/tests/test_laser_preset_route.py
@@ -0,0 +1,127 @@
+"""Tests for B2 Task 1 — POST /api/devices/laser/config (set-preset proxy).
+
+Verifies:
+  - POST /api/devices/laser/config calls client.set_laser_config(config)
+  - Missing config body key → 400
+  - Empty string config → 400
+  - No client (microscope not connected) → 503
+  - require_control gate (403 without override)
+"""
+from unittest.mock import MagicMock, AsyncMock
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from gently.ui.web.routes.data import create_router
+import gently.ui.web.auth as auth
+
+
+def _app(client=None):
+    """Build a TestClient with the data routes wired up.
+
+    Overrides require_control so the TestClient always gets the control role —
+    isolates route logic from auth, mirroring the pattern in test_lightsheet_routes.
+    """
+    server = MagicMock()
+    server.agent_bridge.agent.client = client
+    server.agent_bridge.agent.lightsheet_monitor = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    app.dependency_overrides[auth.require_control] = lambda: True
+    return TestClient(app)
+
+
+# ---------------------------------------------------------------------------
+# Happy path
+# ---------------------------------------------------------------------------
+
+def test_set_laser_config_calls_client():
+    """POST /api/devices/laser/config must call client.set_laser_config(config)."""
+    client = MagicMock()
+    client.set_laser_config = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post(
+        "/api/devices/laser/config",
+        json={"config": "488 only"},
+    )
+    assert r.status_code == 200
+    client.set_laser_config.assert_awaited_once_with("488 only")
+
+
+def test_set_laser_config_all_off():
+    """POST /api/devices/laser/config works with 'ALL OFF'."""
+    client = MagicMock()
+    client.set_laser_config = AsyncMock(return_value={"success": True})
+    r = _app(client=client).post(
+        "/api/devices/laser/config",
+        json={"config": "ALL OFF"},
+    )
+    assert r.status_code == 200
+    client.set_laser_config.assert_awaited_once_with("ALL OFF")
+
+
+# ---------------------------------------------------------------------------
+# 400 — missing / invalid config
+# ---------------------------------------------------------------------------
+
+def test_set_laser_config_missing_key_returns_400():
+    """POST without 'config' key in body → 400."""
+    client = MagicMock()
+    r = _app(client=client).post(
+        "/api/devices/laser/config",
+        json={"wrong_key": "ALL OFF"},
+    )
+    assert r.status_code == 400
+
+
+def test_set_laser_config_empty_string_returns_400():
+    """POST with empty string config → 400."""
+    client = MagicMock()
+    r = _app(client=client).post(
+        "/api/devices/laser/config",
+        json={"config": ""},
+    )
+    assert r.status_code == 400
+
+
+def test_set_laser_config_null_returns_400():
+    """POST with null config → 400."""
+    client = MagicMock()
+    r = _app(client=client).post(
+        "/api/devices/laser/config",
+        json={"config": None},
+    )
+    assert r.status_code == 400
+
+
+# ---------------------------------------------------------------------------
+# 503 — no client
+# ---------------------------------------------------------------------------
+
+def test_set_laser_config_no_client_returns_503():
+    """POST when microscope not connected → 503."""
+    r = _app(client=None).post(
+        "/api/devices/laser/config",
+        json={"config": "ALL OFF"},
+    )
+    assert r.status_code == 503
+
+
+# ---------------------------------------------------------------------------
+# require_control gate
+# ---------------------------------------------------------------------------
+
+def test_set_laser_config_requires_control():
+    """POST /api/devices/laser/config is gated by require_control."""
+    server = MagicMock()
+    client = MagicMock()
+    client.set_laser_config = AsyncMock(return_value={"success": True})
+    server.agent_bridge.agent.client = client
+    server.agent_bridge.agent.lightsheet_monitor = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    # No dependency override — require_control will reject non-loopback hosts
+    r = TestClient(app, raise_server_exceptions=False).post(
+        "/api/devices/laser/config",
+        json={"config": "ALL OFF"},
+    )
+    assert r.status_code == 403

From 4ba1d05e4d3652f7c307d092d0618611baac7459 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 08:38:25 +0530
Subject: [PATCH 247/314] feat(b2): dual-camera config (HamCam2 + side
 selector)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Register DiSPIMCamera("HamCam2") as devices["camera_b"] defensively in
device_factory — only when HamCam2 is in core.getLoadedDevices(); single-
camera rigs skip and log a warning.

Add "side" ('A'|'B', default 'A') to _ls_params; _ensure_lightsheet_sequence_sync
selects camera/camera_b by side and restarts the sequence on side change
(mirrors the exposure-change restart path). Side B without camera_b falls
back to A. New GET /api/cameras endpoint (device-layer + UI proxy) lists
available camera roles. UI: #devices-ls-side select in the manual rail,
hidden on single-camera rigs, shown when GET /api/devices/cameras lists 'B'.
postLightsheetParams includes side on every call. populateCameraRoles()
called on manual-view entry alongside populateLaserPresets.

RIG-DEFERRED: live Multi-Camera dual view + dual-side acquisition.
TDD: 16 tests, all pass; node --check exit 0; no new suite failures.
---
 gently/hardware/dispim/client.py         |  15 +-
 gently/hardware/dispim/device_factory.py |  21 +++
 gently/hardware/dispim/device_layer.py   |  47 ++++-
 gently/ui/web/routes/data.py             |  19 +-
 gently/ui/web/static/js/devices.js       |  32 +++-
 gently/ui/web/templates/index.html       |  10 +
 tests/test_dual_camera_factory.py        | 107 +++++++++++
 tests/test_lightsheet_side_param.py      | 223 +++++++++++++++++++++++
 8 files changed, 461 insertions(+), 13 deletions(-)
 create mode 100644 tests/test_dual_camera_factory.py
 create mode 100644 tests/test_lightsheet_side_param.py

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index 1437a8a8..b4b38557 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -834,6 +834,15 @@ async def get_laser_configs(self) -> dict:
         """
         return await self._api_get("/api/laser/configs")
 
+    async def get_cameras(self) -> dict:
+        """List available SPIM camera roles.
+
+        Hits ``GET /api/cameras`` — returns ``{"cameras": ["A"]}`` on
+        single-camera rigs or ``{"cameras": ["A", "B"]}`` when HamCam2 is
+        registered as camera_b in the device layer.
+        """
+        return await self._api_get("/api/cameras")
+
     async def get_led_status(self) -> dict:
         """Get current LED status."""
         return await self._api_get("/api/led/status")
@@ -1015,9 +1024,9 @@ async def stream_lightsheet(self, timeout: float | None = None):
                         logger.warning("Malformed lightsheet SSE payload skipped: %s", exc)
 
     async def set_lightsheet_live_params(
-        self, galvo=None, piezo=None, exposure=None
+        self, galvo=None, piezo=None, exposure=None, side=None
     ) -> dict:
-        """POST live galvo/piezo/exposure to the device-layer lightsheet streamer."""
+        """POST live galvo/piezo/exposure/side to the device-layer lightsheet streamer."""
         body = {}
         if galvo is not None:
             body["galvo"] = float(galvo)
@@ -1025,6 +1034,8 @@ async def set_lightsheet_live_params(
             body["piezo"] = float(piezo)
         if exposure is not None:
             body["exposure"] = float(exposure)
+        if side is not None:
+            body["side"] = str(side)
         return await self._api_post("/api/lightsheet/live/params", body)
 
     async def set_camera_led_mode(self, use_led: bool = False) -> dict:
diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index e914b1b1..96b0d276 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -64,6 +64,7 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
     default_config = {
         "xy_stage_name": "XYStage:XY:31",
         "camera_name": "HamCam1",
+        "camera_b_name": "HamCam2",
         "scanner_name": "Scanner:AB:33",
         "piezo_name": "PiezoStage:P:34",
         "fdrive_name": "ZStage:V:37",
@@ -108,6 +109,26 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
     except Exception as e:
         logger.warning("Could not create camera: %s", e)
 
+    # Defensively register the second SPIM camera (side B) only when present
+    # in the core's loaded-device list.  Single-camera rigs that lack HamCam2
+    # continue to start normally; camera_b is simply absent from devices.
+    try:
+        from .devices import DiSPIMCamera as _DiSPIMCamera
+
+        cam_b_name = cfg.get("camera_b_name", "HamCam2")
+        loaded_devices = list(core.getLoadedDevices())
+        if cam_b_name in loaded_devices:
+            camera_b = _DiSPIMCamera(device_name=cam_b_name, core=core)
+            devices["camera_b"] = camera_b
+            logger.info("Created camera_b (side B): %s", cam_b_name)
+        else:
+            logger.warning(
+                "camera_b (%s) not in loaded devices — single-camera rig or device absent; skipping",
+                cam_b_name,
+            )
+    except Exception as e:
+        logger.warning("Could not create camera_b: %s", e)
+
     try:
         from .devices import DiSPIMLightSource
 
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 0e44ebfa..69b51581 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -174,7 +174,7 @@ def __init__(
         self._ls_interval_sec: float = 0.0          # peek as fast as exposure allows
         self._ls_target_max_dim: int = 512
         self._ls_jpeg_quality: int = 70
-        self._ls_params: dict = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0}
+        self._ls_params: dict = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0, "side": "A"}
         self._ls_seq_started: bool = False
         self._ls_applied: dict = {}                  # last-applied galvo/piezo/exposure
         self._ls_parked: dict = {}                   # last-parked galvo/piezo setPosition values
@@ -1016,15 +1016,33 @@ def _park_lightsheet_sync(self) -> None:
                 self._ls_parked["piezo"] = want
 
     def _ensure_lightsheet_sequence_sync(self) -> None:
-        """Start (or restart on exposure change) the continuous sequence on the SPIM camera."""
+        """Start (or restart on exposure/side change) the continuous sequence on the SPIM camera.
+
+        Side 'A' uses devices["camera"] (HamCam1); side 'B' uses devices["camera_b"]
+        (HamCam2) when registered.  If side B is requested but camera_b is absent,
+        falls back to side A and logs a warning — single-camera rigs are unaffected.
+        """
         core = self.system.core
-        cam = self.devices.get("camera")
+        p = self._ls_params
+        side = p.get("side", "A")
+
+        # Resolve the camera for the requested side
+        if side == "B" and "camera_b" in self.devices:
+            cam = self.devices.get("camera_b")
+        else:
+            if side == "B":
+                logger.warning(
+                    "Side B requested but camera_b not registered; falling back to side A"
+                )
+            cam = self.devices.get("camera")
+
         if cam is None:
             raise RuntimeError("No lightsheet camera configured")
-        p = self._ls_params
+
         need_restart = (
             not self._ls_seq_started
             or self._ls_applied.get("exposure") != p["exposure"]
+            or self._ls_applied.get("side") != side
         )
         if need_restart:
             if core.isSequenceRunning():
@@ -1035,6 +1053,7 @@ def _ensure_lightsheet_sequence_sync(self) -> None:
             core.startContinuousSequenceAcquisition(self._ls_interval_sec * 1000.0)
             self._ls_seq_started = True
             self._ls_applied["exposure"] = p["exposure"]
+            self._ls_applied["side"] = side
 
     def _grab_lightsheet_frame_sync(self):
         """Park → ensure sequence running → peek the latest frame (never drain)."""
@@ -1167,15 +1186,17 @@ async def handle_lightsheet_stream(self, request):
         return response
 
     async def handle_lightsheet_params(self, request):
-        """POST /api/lightsheet/live/params — update live galvo/piezo/exposure.
+        """POST /api/lightsheet/live/params — update live galvo/piezo/exposure/side.
 
-        Body: {"galvo": float, "piezo": float, "exposure": float} (all optional).
-        Galvo/piezo apply on the next grab; exposure change triggers sequence restart.
+        Body: {"galvo": float, "piezo": float, "exposure": float, "side": "A"|"B"} (all optional).
+        Galvo/piezo apply on the next grab; exposure or side change triggers sequence restart.
         """
         body = await request.json()
         for k in ("galvo", "piezo", "exposure"):
             if k in body and body[k] is not None:
                 self._ls_params[k] = float(body[k])
+        if "side" in body and body["side"] in ("A", "B"):
+            self._ls_params["side"] = body["side"]
         return web.json_response({"params": self._ls_params})
 
     # =========================================================================
@@ -2084,6 +2105,17 @@ async def handle_get_laser_configs(self, request):
                 status=500,
             )
 
+    async def handle_get_cameras(self, request):
+        """GET /api/cameras — list available SPIM camera roles.
+
+        Returns ``{"cameras": ["A"]}`` on single-camera rigs, or
+        ``{"cameras": ["A", "B"]}`` when camera_b (HamCam2) is registered.
+        """
+        cameras = ["A"]
+        if "camera_b" in self.devices:
+            cameras.append("B")
+        return web.json_response({"cameras": cameras})
+
     async def handle_get_camera_exposure(self, request):
         """GET /api/camera/exposure - Get bottom camera exposure time"""
         try:
@@ -3100,6 +3132,7 @@ async def on_start(self):
         # Lightsheet (SPIM) live stream — continuous sequence acquisition
         self._app.router.add_get("/api/lightsheet/stream", self.handle_lightsheet_stream)
         self._app.router.add_post("/api/lightsheet/live/params", self.handle_lightsheet_params)
+        self._app.router.add_get("/api/cameras", self.handle_get_cameras)
 
         # Start plan executor
         self._executor_task = asyncio.create_task(self._plan_executor())
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 8897b292..80ce9fd0 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -476,14 +476,14 @@ async def stop_lightsheet_live_stream():
 
     @router.post("/api/devices/lightsheet/live/params", dependencies=[Depends(require_control)])
     async def lightsheet_live_params(payload: dict = Body(...)):  # noqa: B008
-        """Forward galvo/piezo/exposure params to the device-layer lightsheet streamer."""
+        """Forward galvo/piezo/exposure/side params to the device-layer lightsheet streamer."""
         client = _resolve_client()
         if client is None:
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
             res = await client.set_lightsheet_live_params(
                 galvo=payload.get("galvo"), piezo=payload.get("piezo"),
-                exposure=payload.get("exposure"))
+                exposure=payload.get("exposure"), side=payload.get("side"))
         except Exception as exc:
             logger.exception("lightsheet live params failed")
             raise HTTPException(status_code=502, detail=f"params failed: {exc}") from exc
@@ -560,6 +560,21 @@ async def laser_config_set(payload: dict = Body(...)):  # noqa: B008
             logger.exception("Laser config set command failed")
             raise HTTPException(status_code=502, detail=f"laser config failed: {exc}") from exc
 
+    @router.get("/api/devices/cameras")
+    async def cameras_list():
+        """Return the available SPIM camera roles (A always; B if camera_b registered).
+
+        No require_control — read-only status route, mirrors GET /api/devices/laser/configs.
+        """
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.get_cameras()
+        except Exception as exc:
+            logger.exception("Cameras list fetch failed")
+            raise HTTPException(status_code=502, detail=f"cameras failed: {exc}") from exc
+
     @router.post("/api/devices/camera/led_mode", dependencies=[Depends(require_control)])
     async def camera_led_mode(payload: dict = Body(...)):  # noqa: B008
         """Enable/disable automatic LED for bottom-camera captures. Body: {"use_led": bool}."""
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index fad43df7..a5ce39dd 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -91,6 +91,7 @@ const DevicesManager = (function () {
     let _lsGalvo = 0;
     let _lsPiezo = 50;
     let _lsExposure = 20;  // matches device-layer _ls_params default (20 ms)
+    let _lsSide = 'A';     // SPIM side — 'A' (HamCam1) or 'B' (HamCam2 if present)
     let _lsParamTimer = null;
 
     // Lightsheet control inputs (rail)
@@ -100,6 +101,7 @@ const DevicesManager = (function () {
     let _lsSnapVolBtn, _lsBurstBtn, _lsLastcap, _lsLastcapRef;
     let _lsLaserStatus;   // span inside .ls-laser-indicator — driven by actual laser/off calls
     let _lsLaserPreset;   // <select id="devices-laser-preset"> — populated on manual-view entry
+    let _lsSideSelect;    // <select id="devices-ls-side"> — shown only when camera_b present
     let _lsTempInput, _lsTempSet;
 
     // Room-light toggle (header). Drives the SwitchBot Bot that switches the
@@ -203,6 +205,7 @@ const DevicesManager = (function () {
         _lsLastcapRef    = document.getElementById('devices-ls-lastcap-ref');
         _lsLaserStatus   = document.getElementById('devices-ls-laser-status');
         _lsLaserPreset   = document.getElementById('devices-laser-preset');
+        _lsSideSelect    = document.getElementById('devices-ls-side');
         _lsTempInput     = document.getElementById('devices-ls-temp-input');
         _lsTempSet       = document.getElementById('devices-ls-temp-set');
 
@@ -1398,6 +1401,31 @@ const DevicesManager = (function () {
         }
     }
 
+    /** Fetch SPIM camera roles and show the Side A/B selector if camera_b is present.
+     *  Called on manual-view entry.  Hides the selector on single-camera rigs.
+     *  Fire-and-forget safe — failure leaves the selector hidden (safe default). */
+    async function populateCameraRoles() {
+        cacheDom();
+        const group = document.getElementById('devices-ls-side-group');
+        try {
+            const res = await fetch('/api/devices/cameras');
+            if (!res.ok) return;
+            const data = await res.json();
+            // data may be {cameras: [...]} or a raw array
+            const cameras = Array.isArray(data) ? data : (data.cameras || []);
+            const hasSideB = cameras.includes('B');
+            if (group) group.style.display = hasSideB ? '' : 'none';
+            if (_lsSideSelect && hasSideB) {
+                _lsSideSelect.onchange = () => {
+                    _lsSide = _lsSideSelect.value;
+                    postLightsheetParams();
+                };
+            }
+        } catch (err) {
+            console.debug('camera roles fetch failed:', err);
+        }
+    }
+
     /** POST a named laser preset to the device layer.
      *  Updates the status indicator on success.
      *  Fire-and-forget safe — failure shows a warning, never throws. */
@@ -1607,7 +1635,7 @@ const DevicesManager = (function () {
         fetch('/api/devices/lightsheet/live/params', {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ galvo: _lsGalvo, piezo: _lsPiezo, exposure: _lsExposure }),
+            body: JSON.stringify({ galvo: _lsGalvo, piezo: _lsPiezo, exposure: _lsExposure, side: _lsSide }),
         }).catch(err => console.debug('lightsheet params post failed:', err));
     }
 
@@ -2029,7 +2057,7 @@ const DevicesManager = (function () {
         // Entering Manual view — gate lasers off immediately (brightfield-safe).
         // populateLaserPresets() runs after setLaserOff() so the select is always
         // seeded with the entry-safety state first.
-        if (viewName === 'manual') { setLaserOff(); populateLaserPresets(); }
+        if (viewName === 'manual') { setLaserOff(); populateLaserPresets(); populateCameraRoles(); }
     }
 
     function setupViewSwitcher() {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index c491eea3..3000bf09 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -758,6 +758,16 @@ <h3 class="devices-properties-title">Properties</h3>
                             </div>
                         </div>
 
+                        <!-- SPIM Side selector — hidden on single-camera rigs, shown when camera_b is present -->
+                        <div class="ls-group" id="devices-ls-side-group" style="display:none">
+                            <label class="ls-label" for="devices-ls-side">SPIM Side</label>
+                            <select id="devices-ls-side" class="ls-laser-select"
+                                    aria-label="Select SPIM side A or B">
+                                <option value="A" selected>Side A</option>
+                                <option value="B">Side B</option>
+                            </select>
+                        </div>
+
                         <!-- Galvo -->
                         <div class="ls-group">
                             <label class="ls-label" for="devices-ls-galvo">Galvo</label>
diff --git a/tests/test_dual_camera_factory.py b/tests/test_dual_camera_factory.py
new file mode 100644
index 00000000..5476184e
--- /dev/null
+++ b/tests/test_dual_camera_factory.py
@@ -0,0 +1,107 @@
+"""Tests for B2 Task 2 — dual-camera device_factory (HamCam2 defensive registration).
+
+Verifies:
+  - FakeCore with "HamCam2" in getLoadedDevices() → devices["camera_b"] created (name == "HamCam2")
+  - FakeCore without "HamCam2" → camera_b absent, no crash, devices["camera"] still created
+  - camera_b registration uses core.getLoadedDevices() as the presence check
+"""
+import sys
+from unittest.mock import MagicMock
+
+# Patch heavy hardware deps before importing device_factory.
+# All device classes use pymmcore / ophyd.status only (no ophyd base classes),
+# so patching at the module level is sufficient.
+for _mod in (
+    "pymmcore",
+    "ophyd",
+    "ophyd.status",
+    "bluesky",
+    "bluesky.run_engine",
+    "gently.hardware.console_ui",
+):
+    if _mod not in sys.modules:
+        sys.modules[_mod] = MagicMock()
+
+import bluesky as _bs  # noqa: E402
+
+_bs.RunEngine = MagicMock(name="RunEngine")
+
+from gently.hardware.dispim.device_factory import create_devices_from_mmcore  # noqa: E402
+
+
+class FakeCore:
+    """Minimal CMMCore stand-in with configurable loaded-device list."""
+
+    def __init__(self, loaded_devices=None):
+        self._loaded = list(loaded_devices or [])
+
+    def getLoadedDevices(self):
+        return self._loaded
+
+    # stubs that DiSPIMCamera.__init__ may indirectly trigger via ophyd proxies
+    def getProperty(self, dev, prop):
+        return "0"
+
+    def setProperty(self, dev, prop, val):
+        pass
+
+    def getCameraDevice(self):
+        return ""
+
+    def setCameraDevice(self, name):
+        pass
+
+
+# ---------------------------------------------------------------------------
+# Happy path — HamCam2 present
+# ---------------------------------------------------------------------------
+
+
+def test_camera_b_created_when_hamcam2_loaded():
+    """HamCam2 in getLoadedDevices → devices['camera_b'] created with name 'HamCam2'."""
+    core = FakeCore(loaded_devices=["HamCam1", "HamCam2"])
+    devices = create_devices_from_mmcore(core)
+    assert "camera_b" in devices, "camera_b must be registered when HamCam2 is in loaded devices"
+    assert devices["camera_b"].name == "HamCam2"
+
+
+def test_camera_b_name_is_hamcam2():
+    """The camera_b name attribute is exactly the configured camera_b_name."""
+    core = FakeCore(loaded_devices=["HamCam1", "HamCam2", "Scanner:AB:33"])
+    devices = create_devices_from_mmcore(core)
+    assert devices["camera_b"].name == "HamCam2"
+
+
+# ---------------------------------------------------------------------------
+# Single-camera rig — HamCam2 absent
+# ---------------------------------------------------------------------------
+
+
+def test_camera_b_absent_when_hamcam2_not_loaded():
+    """HamCam2 NOT in getLoadedDevices → camera_b absent, no crash."""
+    core = FakeCore(loaded_devices=["HamCam1"])
+    devices = create_devices_from_mmcore(core)
+    assert "camera_b" not in devices, "camera_b must be absent on single-camera rigs"
+
+
+def test_camera_still_created_without_hamcam2():
+    """Primary camera (HamCam1) is created regardless of HamCam2 presence."""
+    core = FakeCore(loaded_devices=["HamCam1"])
+    devices = create_devices_from_mmcore(core)
+    assert "camera" in devices
+    assert devices["camera"].name == "HamCam1"
+
+
+# ---------------------------------------------------------------------------
+# Edge case — empty loaded-device list
+# ---------------------------------------------------------------------------
+
+
+def test_camera_b_absent_on_empty_device_list():
+    """Empty loaded-device list → camera_b not attempted, no extra error."""
+    core = FakeCore(loaded_devices=[])
+    # DiSPIMCamera.__init__ only stores name/core; it succeeds even with no devices.
+    # So "camera" is still created; "camera_b" is skipped.
+    devices = create_devices_from_mmcore(core)
+    assert "camera_b" not in devices
+    assert "camera" in devices
diff --git a/tests/test_lightsheet_side_param.py b/tests/test_lightsheet_side_param.py
new file mode 100644
index 00000000..25009334
--- /dev/null
+++ b/tests/test_lightsheet_side_param.py
@@ -0,0 +1,223 @@
+"""Tests for B2 Task 2 — lightsheet side param (handle_lightsheet_params +
+_ensure_lightsheet_sequence_sync + handle_get_cameras).
+
+Verifies:
+  - handle_lightsheet_params accepts 'side' ('A'|'B'); invalid values ignored
+  - side change in _ensure_lightsheet_sequence_sync selects the correct camera
+    and triggers a sequence restart (mirroring the exposure-change path)
+  - side B without camera_b falls back to A + no crash
+  - handle_get_cameras returns ["A"] or ["A","B"] based on devices dict
+"""
+import json
+import sys
+from unittest.mock import AsyncMock, MagicMock
+
+import pytest
+
+# Patch heavy hardware deps before importing device_layer
+for _mod in (
+    "bluesky",
+    "bluesky.run_engine",
+    "ophyd",
+    "ophyd.status",
+    "pymmcore",
+    "gently.hardware.console_ui",
+):
+    if _mod not in sys.modules:
+        sys.modules[_mod] = MagicMock()
+
+import bluesky as _bs  # noqa: E402
+
+_bs.RunEngine = MagicMock(name="RunEngine")
+
+from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+class FakeCore:
+    """Minimal CMMCore stub tracking sequence-start/stop calls."""
+
+    def __init__(self):
+        self.running = False
+        self.cam = None
+        self.started = 0
+        self.stopped = 0
+        self.exposure = None
+
+    def setCameraDevice(self, n):
+        self.cam = n
+
+    def getCameraDevice(self):
+        return self.cam
+
+    def setExposure(self, n, ms):
+        self.exposure = ms
+
+    def startContinuousSequenceAcquisition(self, interval):
+        self.running = True
+        self.started += 1
+
+    def stopSequenceAcquisition(self):
+        self.running = False
+        self.stopped += 1
+
+    def isSequenceRunning(self):
+        return self.running
+
+
+def _make_dl(with_camera_b: bool = True) -> DeviceLayerServer:
+    """Build a minimal DeviceLayerServer with faked core + devices."""
+    dl = DeviceLayerServer.__new__(DeviceLayerServer)
+    dl.system = type("S", (), {"core": FakeCore()})()
+    cam_a = type("C", (), {"name": "HamCam1"})()
+    cam_b = type("C", (), {"name": "HamCam2"})()
+    dl.devices = {"camera": cam_a}
+    if with_camera_b:
+        dl.devices["camera_b"] = cam_b
+    dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0, "side": "A"}
+    dl._ls_seq_started = False
+    dl._ls_applied = {}
+    dl._ls_interval_sec = 0.0
+    dl._ls_parked = {}
+    dl._ls_spim_idle = False
+    return dl
+
+
+# ---------------------------------------------------------------------------
+# _ensure_lightsheet_sequence_sync — camera selection by side
+# ---------------------------------------------------------------------------
+
+
+def test_side_a_selects_camera_a():
+    """Side A → sequence started on HamCam1."""
+    dl = _make_dl()
+    dl._ls_params["side"] = "A"
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.cam == "HamCam1"
+    assert dl.system.core.started == 1
+
+
+def test_side_b_selects_camera_b():
+    """Side B with camera_b present → sequence started on HamCam2."""
+    dl = _make_dl(with_camera_b=True)
+    dl._ls_params["side"] = "B"
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.cam == "HamCam2"
+    assert dl.system.core.started == 1
+
+
+def test_side_b_fallback_to_a_when_no_camera_b():
+    """Side B without camera_b → graceful fallback to A (HamCam1), no crash."""
+    dl = _make_dl(with_camera_b=False)
+    dl._ls_params["side"] = "B"
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.cam == "HamCam1"
+    assert dl.system.core.started == 1
+
+
+def test_side_change_triggers_restart():
+    """Switching from A to B stops the running sequence and restarts on HamCam2."""
+    dl = _make_dl(with_camera_b=True)
+    # First call — start on A
+    dl._ls_params["side"] = "A"
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.started == 1
+    assert dl.system.core.cam == "HamCam1"
+
+    # Switch to B — must restart
+    dl._ls_params["side"] = "B"
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.stopped >= 1
+    assert dl.system.core.started >= 2
+    assert dl.system.core.cam == "HamCam2"
+
+
+def test_no_restart_when_side_unchanged():
+    """Same side, same exposure → sequence already running, no extra restart."""
+    dl = _make_dl()
+    dl._ls_params["side"] = "A"
+    dl._ensure_lightsheet_sequence_sync()
+    starts_after_first = dl.system.core.started
+
+    # Manually mark the applied state (as the real code does)
+    dl._ls_applied["exposure"] = 20.0
+    dl._ls_applied["side"] = "A"
+
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.started == starts_after_first
+
+
+# ---------------------------------------------------------------------------
+# handle_lightsheet_params — side accepted / validated
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_handle_lightsheet_params_accepts_side_b():
+    """POST {side: 'B'} → _ls_params['side'] updated to 'B'."""
+    dl = _make_dl()
+    req = MagicMock()
+    req.json = AsyncMock(return_value={"side": "B"})
+    await dl.handle_lightsheet_params(req)
+    assert dl._ls_params["side"] == "B"
+
+
+@pytest.mark.asyncio
+async def test_handle_lightsheet_params_accepts_side_a():
+    """POST {side: 'A'} when already A → _ls_params['side'] stays 'A'."""
+    dl = _make_dl()
+    req = MagicMock()
+    req.json = AsyncMock(return_value={"side": "A"})
+    await dl.handle_lightsheet_params(req)
+    assert dl._ls_params["side"] == "A"
+
+
+@pytest.mark.asyncio
+async def test_handle_lightsheet_params_ignores_invalid_side():
+    """Invalid side value (not 'A'|'B') → _ls_params['side'] unchanged."""
+    dl = _make_dl()
+    dl._ls_params["side"] = "A"
+    req = MagicMock()
+    req.json = AsyncMock(return_value={"side": "C"})
+    await dl.handle_lightsheet_params(req)
+    assert dl._ls_params["side"] == "A"
+
+
+@pytest.mark.asyncio
+async def test_handle_lightsheet_params_accepts_exposure_and_side():
+    """POST with both exposure and side → both applied."""
+    dl = _make_dl()
+    req = MagicMock()
+    req.json = AsyncMock(return_value={"exposure": 50.0, "side": "B"})
+    await dl.handle_lightsheet_params(req)
+    assert dl._ls_params["exposure"] == 50.0
+    assert dl._ls_params["side"] == "B"
+
+
+# ---------------------------------------------------------------------------
+# handle_get_cameras — roles endpoint
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_handle_get_cameras_with_camera_b():
+    """Both A and B listed when camera_b is registered."""
+    dl = _make_dl(with_camera_b=True)
+    req = MagicMock()
+    resp = await dl.handle_get_cameras(req)
+    body = json.loads(resp.body)
+    assert body["cameras"] == ["A", "B"]
+
+
+@pytest.mark.asyncio
+async def test_handle_get_cameras_without_camera_b():
+    """Only A listed when camera_b is absent."""
+    dl = _make_dl(with_camera_b=False)
+    req = MagicMock()
+    resp = await dl.handle_get_cameras(req)
+    body = json.loads(resp.body)
+    assert body["cameras"] == ["A"]

From 5f7011e7cf62219264497b80566678ffd3fa1615 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 08:51:07 +0530
Subject: [PATCH 248/314] feat(b2): manual timelapse-config form (start proxy +
 rail panel)

Adds POST /api/devices/timelapse/start (require_control) that validates
params and calls orchestrator.start via server.agent_bridge.agent.timelapse_orchestrator.
Adds a collapsible Timelapse panel to #devices-view-manual with cadence,
stop condition, embryo IDs, monitoring mode, and volume geometry fields.
devices.js populates defaults from GET /api/devices/scan_geometry +
/api/devices/laser/configs on manual-view entry and POSTs on submit.
16 TDD tests; node --check passes; galvo/piezo motion is rig-deferred.
---
 gently/ui/web/routes/data.py        | 112 +++++++++++
 gently/ui/web/static/js/devices.js  | 168 ++++++++++++++++-
 gently/ui/web/templates/index.html  | 130 +++++++++++++
 tests/test_timelapse_start_route.py | 275 ++++++++++++++++++++++++++++
 4 files changed, 684 insertions(+), 1 deletion(-)
 create mode 100644 tests/test_timelapse_start_route.py

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 80ce9fd0..8342fe09 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -671,6 +671,118 @@ async def acquire_volume(payload: dict = Body(...)):  # noqa: B008
             logger.exception("Volume acquisition failed")
             raise HTTPException(status_code=502, detail=f"volume failed: {exc}") from exc
 
+    # ------------------------------------------------------------------
+    # Timelapse
+    # ------------------------------------------------------------------
+
+    @router.post("/api/devices/timelapse/start", dependencies=[Depends(require_control)])
+    async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
+        """Start an adaptive timelapse from the manual UI.
+
+        Body fields (all optional except interval_seconds has a default):
+          interval_seconds (float, default 120) — cadence; must be > 0
+          stop_condition   (str, default "manual") — "manual", "timepoints", "duration"
+          embryo_ids       (list[str] | null) — null = all active embryos
+          condition_value  (int | null) — timepoints count or duration hours
+          monitoring_mode  (str | null) — "idle" / "expression_monitoring" /
+                                          "pre_terminal_monitoring"
+          num_slices       (int, default 50) — must be >= 1 if provided
+          exposure_ms      (float, default 10.0)
+          galvo_amplitude  (float, default 0.5)
+          galvo_center     (float, default 0.0)
+          piezo_amplitude  (float, default 25.0)
+          piezo_center     (float, default 50.0)
+          laser_config     (str | null)
+
+        Validation:
+          - interval_seconds must be > 0
+          - num_slices must be >= 1
+
+        Orchestrator access: server.agent_bridge.agent.timelapse_orchestrator
+        RIG-DEFERRED: the actual acquisition + galvo/piezo motion.
+        """
+        # --- Validate ---
+        raw_interval = payload.get("interval_seconds", 120.0)
+        try:
+            interval_seconds = float(raw_interval)
+        except (TypeError, ValueError):
+            raise HTTPException(status_code=400, detail="interval_seconds must be a number")
+        if interval_seconds <= 0:
+            raise HTTPException(status_code=400, detail="interval_seconds must be > 0")
+
+        raw_slices = payload.get("num_slices")
+        if raw_slices is not None:
+            try:
+                num_slices = int(raw_slices)
+            except (TypeError, ValueError):
+                raise HTTPException(status_code=400, detail="num_slices must be an integer")
+            if num_slices < 1:
+                raise HTTPException(status_code=400, detail="num_slices must be >= 1")
+        else:
+            num_slices = 50
+
+        stop_condition = str(payload.get("stop_condition") or "manual")
+        embryo_ids = payload.get("embryo_ids") or None
+        condition_value = payload.get("condition_value")
+        monitoring_mode = payload.get("monitoring_mode") or None
+
+        # Volume geometry — passed through for context / future calibration write;
+        # not forwarded to orchestrator.start (which owns its own geometry via the
+        # per-embryo calibration). RIG-DEFERRED: real acquisition uses these.
+        volume_geometry = {
+            "num_slices": num_slices,
+            "exposure_ms": float(payload.get("exposure_ms", 10.0)),
+            "galvo_amplitude": float(payload.get("galvo_amplitude", 0.5)),
+            "galvo_center": float(payload.get("galvo_center", 0.0)),
+            "piezo_amplitude": float(payload.get("piezo_amplitude", 25.0)),
+            "piezo_center": float(payload.get("piezo_center", 50.0)),
+            "laser_config": payload.get("laser_config") or None,
+        }
+
+        # --- Resolve orchestrator ---
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        orchestrator = getattr(agent, "timelapse_orchestrator", None) if agent else None
+        if orchestrator is None:
+            raise HTTPException(
+                status_code=503,
+                detail="Timelapse orchestrator not initialised (agent not running or no session)",
+            )
+
+        # --- Start timelapse (RIG-DEFERRED: real acquisition) ---
+        try:
+            result = await orchestrator.start(
+                embryo_ids=embryo_ids,
+                stop_condition=stop_condition,
+                base_interval_seconds=interval_seconds,
+                condition_value=condition_value,
+            )
+        except Exception as exc:
+            logger.exception("Timelapse start failed")
+            raise HTTPException(status_code=502, detail=f"timelapse start failed: {exc}") from exc
+
+        # Optionally install a monitoring mode at startup (mirrors start_adaptive_timelapse)
+        mode_result = None
+        if monitoring_mode and monitoring_mode != "idle":
+            try:
+                mode_result = orchestrator.enable_monitoring_mode(monitoring_mode)
+            except Exception as exc:
+                mode_result = f"warning: failed to enable monitoring mode: {exc}"
+
+        return {
+            "started": True,
+            "result": result,
+            "monitoring_mode_result": mode_result,
+            "config": {
+                "interval_seconds": interval_seconds,
+                "stop_condition": stop_condition,
+                "embryo_ids": embryo_ids,
+                "condition_value": condition_value,
+                "monitoring_mode": monitoring_mode,
+                "volume_geometry": volume_geometry,
+            },
+        }
+
     @router.get("/api/calibration")
     async def list_calibration(embryo_id: str | None = None):
         """Get calibration images"""
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index a5ce39dd..72f1e7b9 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -104,6 +104,13 @@ const DevicesManager = (function () {
     let _lsSideSelect;    // <select id="devices-ls-side"> — shown only when camera_b present
     let _lsTempInput, _lsTempSet;
 
+    // Timelapse form DOM refs (Manual view — #devices-tl-group)
+    let _tlToggle, _tlBody;
+    let _tlInterval, _tlStop, _tlCondRow, _tlCondLabel, _tlCondVal;
+    let _tlEmbryos, _tlMode;
+    let _tlSlices, _tlExposure, _tlGalvoAmp, _tlGalvoCtr, _tlPiezoAmp, _tlPiezoCtr, _tlLaser;
+    let _tlStart, _tlStatus, _tlStatusText;
+
     // Room-light toggle (header). Drives the SwitchBot Bot that switches the
     // diSPIM room light. State is the bot's cached on/off; hidden until the
     // device layer reports the accessory is configured.
@@ -209,6 +216,27 @@ const DevicesManager = (function () {
         _lsTempInput     = document.getElementById('devices-ls-temp-input');
         _lsTempSet       = document.getElementById('devices-ls-temp-set');
 
+        // Timelapse form
+        _tlToggle     = document.getElementById('devices-tl-toggle');
+        _tlBody       = document.getElementById('devices-tl-body');
+        _tlInterval   = document.getElementById('devices-tl-interval');
+        _tlStop       = document.getElementById('devices-tl-stop');
+        _tlCondRow    = document.getElementById('devices-tl-cond-row');
+        _tlCondLabel  = document.getElementById('devices-tl-cond-label');
+        _tlCondVal    = document.getElementById('devices-tl-cond-val');
+        _tlEmbryos    = document.getElementById('devices-tl-embryos');
+        _tlMode       = document.getElementById('devices-tl-mode');
+        _tlSlices     = document.getElementById('devices-tl-slices');
+        _tlExposure   = document.getElementById('devices-tl-exposure');
+        _tlGalvoAmp   = document.getElementById('devices-tl-galvo-amp');
+        _tlGalvoCtr   = document.getElementById('devices-tl-galvo-ctr');
+        _tlPiezoAmp   = document.getElementById('devices-tl-piezo-amp');
+        _tlPiezoCtr   = document.getElementById('devices-tl-piezo-ctr');
+        _tlLaser      = document.getElementById('devices-tl-laser');
+        _tlStart      = document.getElementById('devices-tl-start');
+        _tlStatus     = document.getElementById('devices-tl-status');
+        _tlStatusText = document.getElementById('devices-tl-status-text');
+
         _roomLightToggle = document.getElementById('devices-room-light-toggle');
         _roomLightLabel  = document.getElementById('devices-room-light-label');
 
@@ -1448,6 +1476,144 @@ const DevicesManager = (function () {
         }
     }
 
+    // =====================================================================
+    // Timelapse config form (Manual view)
+    // =====================================================================
+
+    /** Wire the timelapse panel's collapsible toggle and stop-condition selector.
+     *  Safe to call multiple times (idempotent via re-assignment of event handlers). */
+    function initTlForm() {
+        cacheDom();
+
+        // Collapsible head
+        if (_tlToggle && _tlBody) {
+            _tlToggle.onclick = () => {
+                const open = _tlBody.hidden;
+                _tlBody.hidden = !open;
+                _tlToggle.setAttribute('aria-expanded', String(open));
+                const arrow = _tlToggle.querySelector('.ls-collapsible-arrow');
+                if (arrow) arrow.textContent = open ? '▼' : '▶';
+            };
+        }
+
+        // Conditional stop-value row: show for timepoints / duration, hide for manual
+        if (_tlStop && _tlCondRow) {
+            _tlStop.onchange = () => {
+                const v = _tlStop.value;
+                const show = v === 'timepoints' || v === 'duration';
+                _tlCondRow.hidden = !show;
+                if (_tlCondLabel) {
+                    _tlCondLabel.textContent = v === 'duration' ? 'Hours' : 'Count';
+                }
+            };
+        }
+
+        // Submit button
+        if (_tlStart) {
+            _tlStart.onclick = startTimelapse;
+        }
+    }
+
+    /** Populate timelapse volume-geometry defaults from GET /api/devices/scan_geometry,
+     *  and populate the laser preset select from GET /api/devices/laser/configs.
+     *  Fire-and-forget safe — failure leaves form-coded defaults in place. */
+    async function populateTlDefaults() {
+        cacheDom();
+        // Geometry defaults
+        try {
+            const res = await fetch('/api/devices/scan_geometry');
+            if (res.ok) {
+                const data = await res.json();
+                const scan = data.scan || {};
+                if (_tlSlices    && scan.num_slices    != null) _tlSlices.value    = scan.num_slices;
+                if (_tlExposure  && scan.exposure_ms   != null) _tlExposure.value  = scan.exposure_ms;
+                if (_tlGalvoAmp  && scan.galvo_amplitude_deg != null) _tlGalvoAmp.value = scan.galvo_amplitude_deg;
+                if (_tlGalvoCtr  && scan.galvo_center_deg    != null) _tlGalvoCtr.value = scan.galvo_center_deg;
+                if (_tlPiezoAmp  && scan.piezo_amplitude_um  != null) _tlPiezoAmp.value = scan.piezo_amplitude_um;
+                if (_tlPiezoCtr  && scan.piezo_center_um     != null) _tlPiezoCtr.value = scan.piezo_center_um;
+            }
+        } catch (err) {
+            console.debug('tl scan_geometry fetch failed:', err);
+        }
+        // Laser presets — reuse the shared endpoint; mirror populateLaserPresets()
+        if (!_tlLaser) return;
+        try {
+            const res = await fetch('/api/devices/laser/configs');
+            if (!res.ok) return;
+            const data = await res.json();
+            const presets = Array.isArray(data) ? data : (data.configs || []);
+            if (!presets.length) return;
+            _tlLaser.innerHTML = '';
+            for (const name of presets) {
+                const opt = document.createElement('option');
+                opt.value = name;
+                opt.textContent = name;
+                _tlLaser.appendChild(opt);
+            }
+            if (presets.includes('ALL OFF')) _tlLaser.value = 'ALL OFF';
+        } catch (err) {
+            console.debug('tl laser configs fetch failed:', err);
+        }
+    }
+
+    /** Gather form values, POST to /api/devices/timelapse/start, show result. */
+    async function startTimelapse() {
+        cacheDom();
+        if (!_tlStart) return;
+        _tlStart.disabled = true;
+
+        // Build payload
+        const interval = parseFloat(_tlInterval ? _tlInterval.value : '120') || 120;
+        const stop_condition = _tlStop ? _tlStop.value : 'manual';
+        const condRaw = _tlCondVal ? _tlCondVal.value : '';
+        const condition_value = condRaw ? parseInt(condRaw, 10) : null;
+        const embryoRaw = _tlEmbryos ? _tlEmbryos.value.trim() : '';
+        const embryo_ids = embryoRaw
+            ? embryoRaw.split(',').map(s => s.trim()).filter(Boolean)
+            : null;
+        const monitoring_mode = _tlMode ? (_tlMode.value || null) : null;
+
+        const payload = {
+            interval_seconds: interval,
+            stop_condition,
+            embryo_ids,
+            condition_value,
+            monitoring_mode,
+            num_slices:      _tlSlices    ? parseInt(_tlSlices.value,    10) : 50,
+            exposure_ms:     _tlExposure  ? parseFloat(_tlExposure.value)    : 10.0,
+            galvo_amplitude: _tlGalvoAmp  ? parseFloat(_tlGalvoAmp.value)    : 0.5,
+            galvo_center:    _tlGalvoCtr  ? parseFloat(_tlGalvoCtr.value)    : 0.0,
+            piezo_amplitude: _tlPiezoAmp  ? parseFloat(_tlPiezoAmp.value)    : 25.0,
+            piezo_center:    _tlPiezoCtr  ? parseFloat(_tlPiezoCtr.value)    : 50.0,
+            laser_config:    _tlLaser     ? (_tlLaser.value || null)          : null,
+        };
+
+        if (_tlStatus)     _tlStatus.hidden = false;
+        if (_tlStatusText) _tlStatusText.textContent = 'Starting…';
+
+        try {
+            const res = await fetch('/api/devices/timelapse/start', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+            const body = await res.json().catch(() => ({}));
+            if (res.ok) {
+                const msg = body.result || 'Timelapse started.';
+                if (_tlStatusText) _tlStatusText.textContent = msg;
+            } else {
+                const detail = body.detail || `error ${res.status}`;
+                if (_tlStatusText) _tlStatusText.textContent = `Error: ${detail}`;
+                console.debug('timelapse start failed:', body);
+            }
+        } catch (err) {
+            if (_tlStatusText) _tlStatusText.textContent = `Network error: ${err.message}`;
+            console.debug('timelapse start failed:', err);
+        } finally {
+            if (_tlStart) _tlStart.disabled = false;
+        }
+    }
+
     async function toggleLightsheetStream() {
         if (!_lsToggle) return;
         _lsToggle.disabled = true;
@@ -2057,7 +2223,7 @@ const DevicesManager = (function () {
         // Entering Manual view — gate lasers off immediately (brightfield-safe).
         // populateLaserPresets() runs after setLaserOff() so the select is always
         // seeded with the entry-safety state first.
-        if (viewName === 'manual') { setLaserOff(); populateLaserPresets(); populateCameraRoles(); }
+        if (viewName === 'manual') { setLaserOff(); populateLaserPresets(); populateCameraRoles(); initTlForm(); populateTlDefaults(); }
     }
 
     function setupViewSwitcher() {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 3000bf09..6768ea50 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -847,6 +847,136 @@ <h3 class="devices-properties-title">Properties</h3>
                             </div>
                         </div>
 
+                        <!-- Timelapse (collapsible) -->
+                        <div class="ls-group" id="devices-tl-group">
+                            <button class="ls-label ls-collapsible-head" id="devices-tl-toggle"
+                                    type="button" aria-expanded="false"
+                                    aria-controls="devices-tl-body">
+                                Timelapse
+                                <span class="ls-collapsible-arrow" aria-hidden="true">▶</span>
+                            </button>
+                            <div class="ls-collapsible-body" id="devices-tl-body" hidden>
+
+                                <!-- Cadence -->
+                                <div class="ls-sub-row">
+                                    <label class="ls-sub-label" for="devices-tl-interval">Interval</label>
+                                    <input class="ls-number ls-number-sm" id="devices-tl-interval"
+                                           type="number" min="1" step="1" value="120"
+                                           inputmode="numeric" aria-label="Timelapse interval in seconds">
+                                    <span class="ls-unit">s</span>
+                                </div>
+
+                                <!-- Stop condition -->
+                                <div class="ls-sub-row">
+                                    <label class="ls-sub-label" for="devices-tl-stop">Stop when</label>
+                                    <select id="devices-tl-stop" class="ls-laser-select"
+                                            aria-label="Timelapse stop condition">
+                                        <option value="manual" selected>Manual</option>
+                                        <option value="timepoints">Timepoints</option>
+                                        <option value="duration">Duration (h)</option>
+                                    </select>
+                                </div>
+
+                                <!-- Conditional value (timepoints / duration) -->
+                                <div class="ls-sub-row" id="devices-tl-cond-row" hidden>
+                                    <label class="ls-sub-label" for="devices-tl-cond-val" id="devices-tl-cond-label">Count</label>
+                                    <input class="ls-number ls-number-sm" id="devices-tl-cond-val"
+                                           type="number" min="1" step="1" value="10"
+                                           inputmode="numeric" aria-label="Stop condition value">
+                                </div>
+
+                                <!-- Embryo IDs (comma-separated, optional) -->
+                                <div class="ls-sub-row">
+                                    <label class="ls-sub-label" for="devices-tl-embryos">Embryos</label>
+                                    <input class="ls-number" id="devices-tl-embryos"
+                                           type="text" placeholder="all"
+                                           aria-label="Embryo IDs comma-separated (blank = all)">
+                                </div>
+
+                                <!-- Monitoring mode -->
+                                <div class="ls-sub-row">
+                                    <label class="ls-sub-label" for="devices-tl-mode">Mode</label>
+                                    <select id="devices-tl-mode" class="ls-laser-select"
+                                            aria-label="Monitoring mode">
+                                        <option value="">— none —</option>
+                                        <option value="idle">Idle (plain imaging)</option>
+                                        <option value="expression_monitoring">Expression monitoring</option>
+                                        <option value="pre_terminal_monitoring">Pre-terminal</option>
+                                    </select>
+                                </div>
+
+                                <!-- Volume geometry (sub-group) -->
+                                <div class="ls-sub-section">
+                                    <span class="ls-sub-section-label">Volume geometry</span>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-slices">Slices</label>
+                                        <input class="ls-number ls-number-sm" id="devices-tl-slices"
+                                               type="number" min="1" max="500" step="1" value="50"
+                                               inputmode="numeric" aria-label="Number of slices">
+                                    </div>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-exposure">Exposure</label>
+                                        <input class="ls-number ls-number-sm" id="devices-tl-exposure"
+                                               type="number" min="1" max="5000" step="1" value="10"
+                                               inputmode="numeric" aria-label="Exposure time in ms">
+                                        <span class="ls-unit">ms</span>
+                                    </div>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-galvo-amp">Galvo amp</label>
+                                        <input class="ls-number ls-number-sm" id="devices-tl-galvo-amp"
+                                               type="number" min="0" max="5" step="0.05" value="0.5"
+                                               inputmode="decimal" aria-label="Galvo amplitude in degrees">
+                                        <span class="ls-unit">°</span>
+                                    </div>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-galvo-ctr">Galvo ctr</label>
+                                        <input class="ls-number ls-number-sm" id="devices-tl-galvo-ctr"
+                                               type="number" min="-5" max="5" step="0.05" value="0"
+                                               inputmode="decimal" aria-label="Galvo center in degrees">
+                                        <span class="ls-unit">°</span>
+                                    </div>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-piezo-amp">Piezo amp</label>
+                                        <input class="ls-number ls-number-sm" id="devices-tl-piezo-amp"
+                                               type="number" min="0" max="100" step="0.5" value="25"
+                                               inputmode="decimal" aria-label="Piezo amplitude in µm">
+                                        <span class="ls-unit">µm</span>
+                                    </div>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-piezo-ctr">Piezo ctr</label>
+                                        <input class="ls-number ls-number-sm" id="devices-tl-piezo-ctr"
+                                               type="number" min="0" max="200" step="0.5" value="50"
+                                               inputmode="decimal" aria-label="Piezo center in µm">
+                                        <span class="ls-unit">µm</span>
+                                    </div>
+
+                                    <div class="ls-sub-row">
+                                        <label class="ls-sub-label" for="devices-tl-laser">Laser</label>
+                                        <select id="devices-tl-laser" class="ls-laser-select"
+                                                aria-label="Laser preset for timelapse">
+                                            <option value="ALL OFF">ALL OFF</option>
+                                        </select>
+                                    </div>
+                                </div><!-- /.ls-sub-section -->
+
+                                <!-- Submit + status -->
+                                <div class="ls-sub-row">
+                                    <button class="ls-acquire-btn" id="devices-tl-start"
+                                            type="button">Start timelapse</button>
+                                </div>
+                                <div class="ls-tl-status" id="devices-tl-status" hidden>
+                                    <span id="devices-tl-status-text"></span>
+                                </div>
+
+                            </div><!-- /#devices-tl-body -->
+                        </div><!-- /#devices-tl-group -->
+
                     </div><!-- /.ls-rail -->
                 </div><!-- /.ls-layout -->
             </div><!-- /#devices-view-manual -->
diff --git a/tests/test_timelapse_start_route.py b/tests/test_timelapse_start_route.py
new file mode 100644
index 00000000..9f5c3c1b
--- /dev/null
+++ b/tests/test_timelapse_start_route.py
@@ -0,0 +1,275 @@
+"""Tests for B2 Task 3 — POST /api/devices/timelapse/start (manual timelapse proxy).
+
+Verifies:
+  - POST with valid params calls orchestrator.start with the right args → 200
+  - monitoring_mode is forwarded to orchestrator.enable_monitoring_mode
+  - interval_seconds <= 0 → 400
+  - num_slices < 1 → 400
+  - missing interval_seconds uses default 120.0 (no error)
+  - orchestrator not initialised → 503
+  - require_control gate (403 without override)
+
+Orchestrator access path:
+  server.agent_bridge.agent.timelapse_orchestrator
+  (mirroring the `require_timelapse_orchestrator(agent)` helper in harness/tools/helpers.py)
+"""
+
+from unittest.mock import AsyncMock, MagicMock, patch
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+import gently.ui.web.auth as auth
+from gently.ui.web.routes.data import create_router
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+def _app(orchestrator=None):
+    """Build a TestClient wired with the data routes.
+
+    The mock server exposes `agent_bridge.agent.timelapse_orchestrator`.
+    `require_control` is overridden so route logic is isolated from auth.
+    """
+    server = MagicMock()
+    server.agent_bridge.agent.timelapse_orchestrator = orchestrator
+    # Satisfy other routes that call _resolve_client() or store
+    server.agent_bridge.agent.client = MagicMock()
+    server.agent_bridge.agent.lightsheet_monitor = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    app.dependency_overrides[auth.require_control] = lambda: True
+    return TestClient(app)
+
+
+def _make_orchestrator(start_return="Timelapse started."):
+    """Return a mock orchestrator with an async start and sync enable_monitoring_mode."""
+    orch = MagicMock()
+    orch.start = AsyncMock(return_value=start_return)
+    orch.enable_monitoring_mode = MagicMock(return_value="Monitoring mode enabled.")
+    return orch
+
+
+# ---------------------------------------------------------------------------
+# Happy path — minimal valid payload
+# ---------------------------------------------------------------------------
+
+def test_timelapse_start_minimal():
+    """POST with just interval_seconds calls orchestrator.start; returns 200 with started=True."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120},
+    )
+    assert r.status_code == 200
+    body = r.json()
+    assert body["started"] is True
+    orch.start.assert_awaited_once()
+
+
+def test_timelapse_start_calls_start_with_correct_args():
+    """orchestrator.start receives the right interval, stop_condition, embryo_ids, condition_value."""
+    orch = _make_orchestrator()
+    _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={
+            "interval_seconds": 60,
+            "stop_condition": "timepoints",
+            "embryo_ids": ["e1", "e2"],
+            "condition_value": 10,
+        },
+    )
+    orch.start.assert_awaited_once_with(
+        embryo_ids=["e1", "e2"],
+        stop_condition="timepoints",
+        base_interval_seconds=60.0,
+        condition_value=10,
+    )
+
+
+def test_timelapse_start_uses_default_interval():
+    """Omitting interval_seconds uses the default (120.0) without error."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={},
+    )
+    assert r.status_code == 200
+    _, kwargs = orch.start.call_args
+    assert kwargs["base_interval_seconds"] == 120.0
+
+
+def test_timelapse_start_result_in_response():
+    """The orchestrator.start return value appears in the response."""
+    orch = _make_orchestrator(start_return="Timelapse running — 3 embryos.")
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 90},
+    )
+    assert r.json()["result"] == "Timelapse running — 3 embryos."
+
+
+# ---------------------------------------------------------------------------
+# Monitoring mode
+# ---------------------------------------------------------------------------
+
+def test_timelapse_start_enables_monitoring_mode():
+    """monitoring_mode != 'idle' triggers enable_monitoring_mode on the orchestrator."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120, "monitoring_mode": "expression_monitoring"},
+    )
+    assert r.status_code == 200
+    orch.enable_monitoring_mode.assert_called_once_with("expression_monitoring")
+    assert r.json()["monitoring_mode_result"] == "Monitoring mode enabled."
+
+
+def test_timelapse_start_idle_mode_skips_enable():
+    """monitoring_mode='idle' does NOT call enable_monitoring_mode."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120, "monitoring_mode": "idle"},
+    )
+    assert r.status_code == 200
+    orch.enable_monitoring_mode.assert_not_called()
+
+
+def test_timelapse_start_no_mode_skips_enable():
+    """Omitting monitoring_mode does NOT call enable_monitoring_mode."""
+    orch = _make_orchestrator()
+    _app(orch).post("/api/devices/timelapse/start", json={"interval_seconds": 120})
+    orch.enable_monitoring_mode.assert_not_called()
+
+
+# ---------------------------------------------------------------------------
+# Volume geometry passed through in response config
+# ---------------------------------------------------------------------------
+
+def test_timelapse_start_volume_geometry_in_config():
+    """Volume geometry fields appear in response['config']['volume_geometry']."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={
+            "interval_seconds": 120,
+            "num_slices": 80,
+            "exposure_ms": 15.0,
+            "galvo_amplitude": 0.7,
+            "galvo_center": 0.1,
+            "piezo_amplitude": 30.0,
+            "piezo_center": 55.0,
+            "laser_config": "488 only",
+        },
+    )
+    assert r.status_code == 200
+    vg = r.json()["config"]["volume_geometry"]
+    assert vg["num_slices"] == 80
+    assert vg["exposure_ms"] == 15.0
+    assert vg["laser_config"] == "488 only"
+
+
+# ---------------------------------------------------------------------------
+# 400 — validation failures
+# ---------------------------------------------------------------------------
+
+def test_timelapse_start_interval_zero_returns_400():
+    """interval_seconds = 0 → 400."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 0},
+    )
+    assert r.status_code == 400
+    assert "interval_seconds" in r.json()["detail"]
+
+
+def test_timelapse_start_negative_interval_returns_400():
+    """interval_seconds < 0 → 400."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": -10},
+    )
+    assert r.status_code == 400
+
+
+def test_timelapse_start_num_slices_zero_returns_400():
+    """num_slices = 0 → 400."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120, "num_slices": 0},
+    )
+    assert r.status_code == 400
+    assert "num_slices" in r.json()["detail"]
+
+
+def test_timelapse_start_num_slices_negative_returns_400():
+    """num_slices < 0 → 400."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120, "num_slices": -5},
+    )
+    assert r.status_code == 400
+
+
+def test_timelapse_start_non_numeric_interval_returns_400():
+    """Non-numeric interval_seconds → 400."""
+    orch = _make_orchestrator()
+    r = _app(orch).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": "fast"},
+    )
+    assert r.status_code == 400
+
+
+# ---------------------------------------------------------------------------
+# 503 — orchestrator not reachable
+# ---------------------------------------------------------------------------
+
+def test_timelapse_start_no_orchestrator_returns_503():
+    """orchestrator is None (agent not running / no session) → 503."""
+    r = _app(orchestrator=None).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120},
+    )
+    assert r.status_code == 503
+
+
+def test_timelapse_start_no_agent_bridge_returns_503():
+    """agent_bridge missing entirely → 503."""
+    server = MagicMock(spec=[])  # no agent_bridge attribute
+    app = FastAPI()
+    app.include_router(create_router(server))
+    app.dependency_overrides[auth.require_control] = lambda: True
+    r = TestClient(app).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120},
+    )
+    assert r.status_code == 503
+
+
+# ---------------------------------------------------------------------------
+# require_control gate
+# ---------------------------------------------------------------------------
+
+def test_timelapse_start_requires_control():
+    """POST /api/devices/timelapse/start is gated by require_control (403 without override)."""
+    orch = _make_orchestrator()
+    server = MagicMock()
+    server.agent_bridge.agent.timelapse_orchestrator = orch
+    server.agent_bridge.agent.client = MagicMock()
+    server.agent_bridge.agent.lightsheet_monitor = None
+    app = FastAPI()
+    app.include_router(create_router(server))
+    # No dependency override — require_control will reject non-loopback hosts
+    r = TestClient(app, raise_server_exceptions=False).post(
+        "/api/devices/timelapse/start",
+        json={"interval_seconds": 120},
+    )
+    assert r.status_code == 403

From 65525e94878afe723c002cb259aa45cd0ca3dbbf Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 09:04:24 +0530
Subject: [PATCH 249/314] fix(b2): style the timelapse panel (define
 ls-collapsible/ls-sub-* in app CSS)

Add 8 CSS classes to main.css that the timelapse panel (#devices-view-manual)
references but were never defined in the app: ls-collapsible-head/body/arrow,
ls-sub-row/label/section/section-label, ls-tl-status. Panel was rendering
unstyled in the real app; scratchpad harness had masked this with inline CSS.
Classes mirror the existing .ls-row/.ls-group/.ls-label pattern (same CSS
variables, spacing, dark instrument aesthetic). [hidden] fights prevented via
explicit [hidden]{display:none} scoped rules. Verified via Chrome MCP harness
loading the real main.css with no harness-local ls-* overrides.

Also: TODO comment in timelapse_start route noting UI path skips plan auto-linking.
---
 gently/ui/web/routes/data.py      |  2 +
 gently/ui/web/static/css/main.css | 90 +++++++++++++++++++++++++++++++
 2 files changed, 92 insertions(+)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 8342fe09..99dd07d8 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -750,6 +750,8 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
             )
 
         # --- Start timelapse (RIG-DEFERRED: real acquisition) ---
+        # TODO: UI-initiated timelapses skip the agent tool's plan auto-linking;
+        #       this is intentional — the agent path wires the plan, this route does not.
         try:
             result = await orchestrator.start(
                 embryo_ids=embryo_ids,
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index ff964886..7d3a0f7f 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10843,3 +10843,93 @@ body.modal-open {
     color: var(--map-ink);
     word-break: break-all;
 }
+
+/* ── Timelapse collapsible panel (B2 Task 3) ─────────────────────────────── */
+
+/* Clickable header button (also carries .ls-label for font/color) */
+.ls-collapsible-head {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    width: 100%;
+    background: transparent;
+    border: none;
+    padding: 0;
+    cursor: pointer;
+    text-align: left;
+}
+
+/* ▶/▼ caret — rotates when expanded */
+.ls-collapsible-arrow {
+    font-size: 0.5rem;
+    color: var(--map-ink-mute);
+    flex-shrink: 0;
+    transition: transform 0.15s;
+}
+
+.ls-collapsible-head[aria-expanded="true"] .ls-collapsible-arrow {
+    transform: rotate(90deg);
+}
+
+/* Collapsible body — hidden via [hidden] attribute; explicit rule prevents
+   display overrides from fighting the attribute (mirrors .ls-lastcap[hidden]) */
+.ls-collapsible-body {
+    display: flex;
+    flex-direction: column;
+    gap: 0.32rem;
+    margin-top: 0.35rem;
+}
+
+.ls-collapsible-body[hidden] { display: none; }
+
+/* Sub-rows: like .ls-row but slightly indented for the body interior */
+.ls-sub-row {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    padding-left: 0.25rem;
+}
+
+/* Sub-label: like .ls-label but fixed-width to align inputs column */
+.ls-sub-label {
+    font-size: 0.58rem;
+    font-weight: 600;
+    letter-spacing: 0.12em;
+    text-transform: uppercase;
+    color: var(--map-ink-mute);
+    min-width: 4.5rem;
+    flex-shrink: 0;
+}
+
+/* Volume-Geometry inset sub-group */
+.ls-sub-section {
+    display: flex;
+    flex-direction: column;
+    gap: 0.28rem;
+    padding: 0.4rem 0.5rem;
+    background: var(--map-paper-2);
+    border: 1px solid var(--map-overlay-edge);
+    border-radius: 4px;
+    margin: 0.15rem 0;
+}
+
+/* "VOLUME GEOMETRY" sub-header */
+.ls-sub-section-label {
+    font-size: 0.52rem;
+    font-weight: 600;
+    letter-spacing: 0.2em;
+    text-transform: uppercase;
+    color: var(--map-ink-mute);
+    margin-bottom: 0.1rem;
+}
+
+/* Start-result / status line — mono, muted */
+.ls-tl-status {
+    font-family: 'JetBrains Mono', monospace;
+    font-size: 0.62rem;
+    color: var(--map-ink-mute);
+    padding: 0.2rem 0.25rem;
+    word-break: break-all;
+}
+
+.ls-tl-status[hidden] { display: none; }

From 860f5f2927a7e40807b598824e219467a6925ad6 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 10:09:33 +0530
Subject: [PATCH 250/314] fix(manual): single LED toggle + laser on/off toggle
 (replace two-button LED, add laser on/off)

---
 gently/ui/web/static/css/main.css  |  4 ++
 gently/ui/web/static/js/devices.js | 70 ++++++++++++++++++++++++++----
 gently/ui/web/templates/index.html | 16 ++++---
 3 files changed, 75 insertions(+), 15 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 7d3a0f7f..9215466a 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10725,6 +10725,10 @@ body.modal-open {
     flex-shrink: 0;
 }
 
+.ls-laser-dot--on {
+    background: var(--map-accent);
+}
+
 /* Laser preset row (B2) */
 .ls-laser-row {
     display: flex;
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 72f1e7b9..2319d9b2 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -96,8 +96,11 @@ const DevicesManager = (function () {
 
     // Lightsheet control inputs (rail)
     let _lsGalvoSlider, _lsGalvoNum, _lsPiezoSlider, _lsPiezoNum, _lsExposureNum;
-    let _lsLedOpen, _lsLedClosed, _lsCamLed, _lsRoomLightBtn;
+    let _lsLedToggle, _lsCamLed, _lsRoomLightBtn;
+    let _lsLedIsOpen = false;  // LED toggle state: false = Closed (safe default)
     let _lsCamLedOn = false;
+    let _lsLaserToggle;
+    let _lsLaserOn = false;    // Laser toggle state: false = OFF (entry-safe default)
     let _lsSnapVolBtn, _lsBurstBtn, _lsLastcap, _lsLastcapRef;
     let _lsLaserStatus;   // span inside .ls-laser-indicator — driven by actual laser/off calls
     let _lsLaserPreset;   // <select id="devices-laser-preset"> — populated on manual-view entry
@@ -202,10 +205,10 @@ const DevicesManager = (function () {
         _lsPiezoSlider   = document.getElementById('devices-ls-piezo-slider');
         _lsPiezoNum      = document.getElementById('devices-ls-piezo');
         _lsExposureNum   = document.getElementById('devices-ls-exposure');
-        _lsLedOpen       = document.getElementById('devices-ls-led-open');
-        _lsLedClosed     = document.getElementById('devices-ls-led-closed');
+        _lsLedToggle     = document.getElementById('devices-ls-led-toggle');
         _lsCamLed        = document.getElementById('devices-ls-cam-led');
         _lsRoomLightBtn  = document.getElementById('devices-ls-room-light-btn');
+        _lsLaserToggle   = document.getElementById('devices-ls-laser-toggle');
         _lsSnapVolBtn    = document.getElementById('devices-ls-snap-volume');
         _lsBurstBtn      = document.getElementById('devices-ls-burst');
         _lsLastcap       = document.getElementById('devices-ls-lastcap');
@@ -1392,6 +1395,7 @@ const DevicesManager = (function () {
             if (_lsLaserStatus) {
                 _lsLaserStatus.textContent = res.ok ? 'OFF (brightfield)' : 'warning: state unknown';
             }
+            if (res.ok) _setLaserToggleState(false);
         } catch (err) {
             if (_lsLaserStatus) _lsLaserStatus.textContent = 'warning: state unknown';
             console.debug('laser off call failed:', err);
@@ -1422,8 +1426,9 @@ const DevicesManager = (function () {
             }
             // Default to "ALL OFF" — entry safety state
             if (presets.includes('ALL OFF')) _lsLaserPreset.value = 'ALL OFF';
-            // Wire change handler (idempotent — replace via re-assignment)
-            _lsLaserPreset.onchange = () => setLaserPreset(_lsLaserPreset.value);
+            // Wire change handler — only POST if laser is currently ON; if OFF, it's
+            // just a selection that will be activated when the toggle is pressed.
+            _lsLaserPreset.onchange = () => { if (_lsLaserOn) setLaserPreset(_lsLaserPreset.value); };
         } catch (err) {
             console.debug('laser preset fetch failed:', err);
         }
@@ -1469,6 +1474,7 @@ const DevicesManager = (function () {
             if (_lsLaserStatus) {
                 _lsLaserStatus.textContent = res.ok ? config : 'warning: state unknown';
             }
+            if (res.ok) _setLaserToggleState(config !== 'ALL OFF');
             if (!res.ok) console.debug('laser preset set failed:', await res.text());
         } catch (err) {
             if (_lsLaserStatus) _lsLaserStatus.textContent = 'warning: state unknown';
@@ -1847,6 +1853,54 @@ const DevicesManager = (function () {
         } catch (err) { console.debug('LED preset failed:', err); }
     }
 
+    /** Single LED toggle — mirrors Cam LED / Room Light aria-pressed pattern.
+     *  Flips between Open (active) and Closed (inactive/safe default). */
+    async function toggleLedPreset() {
+        _lsLedIsOpen = !_lsLedIsOpen;
+        if (_lsLedToggle) {
+            _lsLedToggle.classList.toggle('ls-illum-btn--active', _lsLedIsOpen);
+            _lsLedToggle.setAttribute('aria-pressed', _lsLedIsOpen ? 'true' : 'false');
+            _lsLedToggle.textContent = _lsLedIsOpen ? 'LED: Open' : 'LED: Closed';
+        }
+        await postLedPreset(_lsLedIsOpen ? 'Open' : 'Closed');
+    }
+
+    /** Update laser toggle button + dot to reflect on/off state.
+     *  Called by setLaserOff() and setLaserPreset() after a successful API call. */
+    function _setLaserToggleState(on) {
+        _lsLaserOn = on;
+        if (_lsLaserToggle) {
+            _lsLaserToggle.classList.toggle('ls-illum-btn--active', on);
+            _lsLaserToggle.setAttribute('aria-pressed', on ? 'true' : 'false');
+            _lsLaserToggle.textContent = on ? 'Laser: ON' : 'Laser: OFF';
+        }
+        const dot = document.querySelector('.ls-laser-dot');
+        if (dot) dot.classList.toggle('ls-laser-dot--on', on);
+    }
+
+    /** Laser on/off toggle — OFF fires laser/off; ON applies the selected preset.
+     *  If selected preset is "ALL OFF", picks the first non-"ALL OFF" option.
+     *  Entry safety: starts OFF (setLaserOff fires on manual-view entry). */
+    async function toggleLaser() {
+        if (_lsLaserOn) {
+            await setLaserOff();
+        } else {
+            let config = _lsLaserPreset ? _lsLaserPreset.value : null;
+            if (!config || config === 'ALL OFF') {
+                const opts = _lsLaserPreset ? Array.from(_lsLaserPreset.options) : [];
+                const first = opts.find(o => o.value !== 'ALL OFF');
+                if (first) {
+                    config = first.value;
+                    _lsLaserPreset.value = config;
+                } else {
+                    if (_lsLaserStatus) _lsLaserStatus.textContent = 'select a laser line first';
+                    return;
+                }
+            }
+            await setLaserPreset(config);
+        }
+    }
+
     async function toggleCamLedMode() {
         _lsCamLedOn = !_lsCamLedOn;
         if (_lsCamLed) {
@@ -1958,10 +2012,10 @@ const DevicesManager = (function () {
         if (_lsExposureNum) _lsExposureNum.addEventListener('input', onExposureInput);
 
         // Illumination
-        if (_lsLedOpen)    _lsLedOpen.addEventListener('click',    () => postLedPreset('Open'));
-        if (_lsLedClosed)  _lsLedClosed.addEventListener('click',  () => postLedPreset('Closed'));
-        if (_lsCamLed)     _lsCamLed.addEventListener('click',     toggleCamLedMode);
+        if (_lsLedToggle)    _lsLedToggle.addEventListener('click',    toggleLedPreset);
+        if (_lsCamLed)       _lsCamLed.addEventListener('click',       toggleCamLedMode);
         if (_lsRoomLightBtn) _lsRoomLightBtn.addEventListener('click', toggleManualRoomLight);
+        if (_lsLaserToggle)  _lsLaserToggle.addEventListener('click',  toggleLaser);
 
         // Acquire
         if (_lsSnapVolBtn) _lsSnapVolBtn.addEventListener('click', () => runLightsheetAcquire('volume'));
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 6768ea50..55090248 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -796,19 +796,21 @@ <h3 class="devices-properties-title">Properties</h3>
                         <div class="ls-group">
                             <span class="ls-label">Illumination</span>
                             <div class="ls-btn-row">
-                                <button class="ls-illum-btn" id="devices-ls-led-open" type="button"
-                                        title="LED group preset: Open">LED Open</button>
-                                <button class="ls-illum-btn" id="devices-ls-led-closed" type="button"
-                                        title="LED group preset: Closed">LED Closed</button>
-                            </div>
-                            <div class="ls-btn-row">
+                                <button class="ls-illum-btn" id="devices-ls-led-toggle" type="button"
+                                        title="Toggle LED preset (Open/Closed)"
+                                        aria-pressed="false">LED: Closed</button>
                                 <button class="ls-illum-btn" id="devices-ls-cam-led" type="button"
                                         title="Toggle camera LED mode" aria-pressed="false">Cam LED</button>
                                 <button class="ls-illum-btn" id="devices-ls-room-light-btn" type="button"
                                         title="Toggle room light" aria-pressed="false">Room Light</button>
                             </div>
+                            <div class="ls-btn-row">
+                                <button class="ls-illum-btn" id="devices-ls-laser-toggle" type="button"
+                                        title="Toggle laser on/off"
+                                        aria-pressed="false">Laser: OFF</button>
+                            </div>
                             <div class="ls-laser-row">
-                                <label class="ls-laser-label" for="devices-laser-preset">Laser preset</label>
+                                <label class="ls-laser-label" for="devices-laser-preset">Preset</label>
                                 <select id="devices-laser-preset" class="ls-laser-select"
                                         aria-label="Laser preset">
                                     <option value="ALL OFF">ALL OFF</option>

From 225de14f927b778470a519d6cbbf26a3070763e5 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 11:00:43 +0530
Subject: [PATCH 251/314] feat(operations): pin plan kind/scope/state schema in
 guidance + normalize in validator
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

OPERATION_PLAN_GUIDANCE now enumerates all six kind values with glosses, the
scope object shape (three modes), tactic state enum, phase state enum, and a
concrete JSON example tactic — replacing vague prose that let a real model
produce wrong shapes.

_validate_tactics now normalizes before validating:
- kind: monitor/reactive→reactive_monitor; timelapse/standing→standing_timelapse;
  protocol/scripted→scripted_protocol; burst→exclusive_burst;
  reference→standing_timelapse; unknown→custom
- tactic state: running/in_progress→active; pending/queued→planned;
  complete/completed→done
- scope: bare list→{mode:embryos,embryo_ids:[…]}; "global"/"all"→{mode:global};
  dict missing mode inferred from role/embryo_ids keys
- live.phases[].state: pending/queued→todo; running/in_progress→active;
  complete/completed→done

@tool schema constrained: SKIPPED — ToolParameter.type is a bare string;
no items/sub-schema field exists; guidance + normalization cover it.

25 new/updated tests; 0 new failures in full suite.
---
 gently/app/tools/operation_plan_tools.py |  96 ++++++++++-
 gently/harness/prompts/templates.py      |  43 +++++
 tests/test_operation_plan_tool.py        | 204 ++++++++++++++++++++++-
 3 files changed, 338 insertions(+), 5 deletions(-)

diff --git a/gently/app/tools/operation_plan_tools.py b/gently/app/tools/operation_plan_tools.py
index 93998a03..b23664b6 100644
--- a/gently/app/tools/operation_plan_tools.py
+++ b/gently/app/tools/operation_plan_tools.py
@@ -28,13 +28,83 @@
 )
 _VALID_STATES = frozenset({"planned", "active", "done", "paused"})
 
+# Synonym maps — normalize model variation to canonical values
+_KIND_SYNONYMS: dict[str, str] = {
+    "monitor": "reactive_monitor",
+    "reactive": "reactive_monitor",
+    "timelapse": "standing_timelapse",
+    "standing": "standing_timelapse",
+    "protocol": "scripted_protocol",
+    "scripted": "scripted_protocol",
+    "burst": "exclusive_burst",
+    "reference": "standing_timelapse",
+}
+
+_STATE_SYNONYMS: dict[str, str] = {
+    "in_progress": "active",
+    "running": "active",
+    "pending": "planned",
+    "queued": "planned",
+    "complete": "done",
+    "completed": "done",
+}
+
+_PHASE_STATE_SYNONYMS: dict[str, str] = {
+    "pending": "todo",
+    "queued": "todo",
+    "todo": "todo",
+    "running": "active",
+    "in_progress": "active",
+    "active": "active",
+    "complete": "done",
+    "completed": "done",
+    "done": "done",
+}
+
+
+def _normalize_scope(scope: object) -> object:
+    """Normalize scope to canonical {mode, ...} object form."""
+    if isinstance(scope, list):
+        return {"mode": "embryos", "embryo_ids": scope}
+    if isinstance(scope, str):
+        if scope in ("global", "all"):
+            return {"mode": "global"}
+        # unknown string — wrap as global fallback
+        return {"mode": "global"}
+    if isinstance(scope, dict):
+        if "mode" not in scope:
+            scope = dict(scope)
+            if "role" in scope:
+                scope["mode"] = "role"
+            elif "embryo_ids" in scope:
+                scope["mode"] = "embryos"
+        return scope
+    # unexpected type — pass through unchanged so we don't lose data
+    return scope
+
+
+def _normalize_phases(phases: object) -> object:
+    """Normalize phase state values inside a phases list."""
+    if not isinstance(phases, list):
+        return phases
+    result = []
+    for phase in phases:
+        if isinstance(phase, dict) and "state" in phase:
+            raw = phase["state"]
+            phase = dict(phase)
+            phase["state"] = _PHASE_STATE_SYNONYMS.get(raw, raw)
+        result.append(phase)
+    return result
+
 
 def _validate_tactics(tactics: list) -> list[dict]:
     """Validate and normalise a tactics list.
 
     Each tactic must have id, name, kind, state.
-    Unknown kinds are clamped to 'custom'.
-    Invalid states raise ValueError.
+    Kind synonyms are mapped to canonical values; unknown kinds are clamped to
+    'custom'.  State synonyms are mapped to canonical values; unknown states
+    raise ValueError.  Scope is normalized to {mode, ...} object form.
+    Phase states inside live.phases are normalized to todo/active/done.
     """
     validated = []
     for i, t in enumerate(tactics):
@@ -44,20 +114,40 @@ def _validate_tactics(tactics: list) -> list[dict]:
             if not t.get(required_field):
                 raise ValueError(f"Tactic at index {i} missing required field '{required_field}'")
         tactic = dict(t)
+
+        # --- normalize kind ---
         kind = tactic["kind"]
+        kind = _KIND_SYNONYMS.get(kind, kind)
         if kind not in _VALID_KINDS:
             logger.warning(
                 "Tactic '%s' has unknown kind '%s' — clamped to 'custom'",
                 tactic.get("id"),
                 kind,
             )
-            tactic["kind"] = "custom"
+            kind = "custom"
+        tactic["kind"] = kind
+
+        # --- normalize tactic state ---
         state = tactic["state"]
+        state = _STATE_SYNONYMS.get(state, state)
         if state not in _VALID_STATES:
             raise ValueError(
                 f"Tactic '{tactic.get('id')}' has invalid state '{state}'. "
                 f"Must be one of: {sorted(_VALID_STATES)}"
             )
+        tactic["state"] = state
+
+        # --- normalize scope ---
+        if "scope" in tactic:
+            tactic["scope"] = _normalize_scope(tactic["scope"])
+
+        # --- normalize phase states inside live.phases ---
+        live = tactic.get("live")
+        if isinstance(live, dict) and "phases" in live:
+            live = dict(live)
+            live["phases"] = _normalize_phases(live["phases"])
+            tactic["live"] = live
+
         validated.append(tactic)
     return validated
 
diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index 536064b4..957ec0ad 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -237,6 +237,49 @@
   `last_fired`, `new_phase`, …) are merged in by the updater as live telemetry
   arrives; you can seed them at declaration time if the value is already known.
 
+### Allowed values — use these exact strings (renderer dispatches on them)
+
+**`kind`** ∈ one of:
+| value | use when |
+|---|---|
+| `standing_timelapse` | continuous / periodic imaging running throughout |
+| `reactive_monitor` | armed watcher that fires on a condition (signal, threshold) |
+| `scripted_protocol` | fixed sequence of named phases (ramp, hold, recovery, …) |
+| `exclusive_burst` | short high-cadence burst that blocks other acquisition |
+| `oneshot` | single action (z-stack, snapshot, one-off step) |
+| `custom` | anything that doesn't fit the above |
+
+**`state`** (tactic) ∈ `planned | active | done | paused`
+Start every tactic as `"planned"`; advance to `"active"` when it begins,
+`"done"` when it finishes, `"paused"` if suspended.
+
+**`scope`** — always an object with a `mode` key (never a bare list or string):
+- `{"mode": "global"}` — applies to every embryo in the session
+- `{"mode": "embryos", "embryo_ids": ["E01", "E02"]}` — specific embryo IDs
+- `{"mode": "role", "role": "test"}` — all embryos carrying the named role
+
+**`live.phases[].state`** ∈ `todo | active | done`
+
+### Minimal tactic example
+
+```json
+{
+  "id": "t2",
+  "name": "Temperature ramp",
+  "kind": "scripted_protocol",
+  "state": "planned",
+  "scope": {"mode": "embryos", "embryo_ids": ["E01", "E02"]},
+  "rationale": "25 → 16 °C step to trigger stress response",
+  "live": {
+    "readouts": [{"label": "setpoint", "value": "25 °C"}],
+    "phases": [
+      {"name": "ramp", "state": "todo", "count": 0, "pips": []},
+      {"name": "hold", "state": "todo", "count": 0, "pips": []}
+    ]
+  }
+}
+```
+
 Re-call `declare_operation_plan` (patch) whenever a tactic's state changes:
 `"planned"` → `"active"` when you start it, `"active"` → `"done"` when it
 finishes.  This keeps the Operations view in the UI synchronized with reality.
diff --git a/tests/test_operation_plan_tool.py b/tests/test_operation_plan_tool.py
index ad6804d6..7f2255b6 100644
--- a/tests/test_operation_plan_tool.py
+++ b/tests/test_operation_plan_tool.py
@@ -365,7 +365,7 @@ async def test_missing_tactic_id_returns_error_no_write():
 
 @pytest.mark.asyncio
 async def test_invalid_state_returns_error_no_write():
-    """A tactic with an invalid state causes an error; nothing is persisted."""
+    """A tactic with a completely unrecognised state causes an error; nothing is persisted."""
     from gently.app.tools.operation_plan_tools import declare_operation_plan
 
     ctx = _make_context()
@@ -374,7 +374,7 @@ async def test_invalid_state_returns_error_no_write():
             "id": "t1",
             "name": "Bad state",
             "kind": "oneshot",
-            "state": "running",  # not a valid state
+            "state": "completely_unknown_xyz",  # not a valid state and not a known synonym
         }
     ]
     result = await declare_operation_plan(
@@ -388,6 +388,206 @@ async def test_invalid_state_returns_error_no_write():
     assert ctx["agent"].context_store.calls == []
 
 
+# ---------------------------------------------------------------------------
+# Normalization tests (Fix 2)
+# ---------------------------------------------------------------------------
+
+
+def test_normalize_kind_synonyms():
+    """Kind synonyms are mapped to canonical values before validation."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    cases = [
+        ("monitor", "reactive_monitor"),
+        ("reactive", "reactive_monitor"),
+        ("timelapse", "standing_timelapse"),
+        ("standing", "standing_timelapse"),
+        ("protocol", "scripted_protocol"),
+        ("scripted", "scripted_protocol"),
+        ("burst", "exclusive_burst"),
+        ("reference", "standing_timelapse"),
+    ]
+    for raw_kind, expected in cases:
+        tactics = [{"id": "t1", "name": "T", "kind": raw_kind, "state": "planned"}]
+        result = _validate_tactics(tactics)
+        assert result[0]["kind"] == expected, f"kind '{raw_kind}' should map to '{expected}'"
+
+
+def test_normalize_kind_unknown_to_custom():
+    """An unrecognised kind that is not a synonym is clamped to 'custom'."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [{"id": "t1", "name": "T", "kind": "future_kind_v99", "state": "planned"}]
+    result = _validate_tactics(tactics)
+    assert result[0]["kind"] == "custom"
+
+
+def test_normalize_scope_bare_list():
+    """A bare list scope is converted to {mode:'embryos', embryo_ids:[...]}."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [
+        {
+            "id": "t1",
+            "name": "T",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": ["E01", "E02"],
+        }
+    ]
+    result = _validate_tactics(tactics)
+    assert result[0]["scope"] == {"mode": "embryos", "embryo_ids": ["E01", "E02"]}
+
+
+def test_normalize_scope_global_string():
+    """The string 'global' scope is converted to {mode:'global'}."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [
+        {
+            "id": "t1",
+            "name": "T",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": "global",
+        }
+    ]
+    result = _validate_tactics(tactics)
+    assert result[0]["scope"] == {"mode": "global"}
+
+
+def test_normalize_scope_dict_missing_mode_with_embryo_ids():
+    """A scope dict with embryo_ids but no mode gets mode:'embryos' injected."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [
+        {
+            "id": "t1",
+            "name": "T",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": {"embryo_ids": ["E01"]},
+        }
+    ]
+    result = _validate_tactics(tactics)
+    assert result[0]["scope"]["mode"] == "embryos"
+    assert result[0]["scope"]["embryo_ids"] == ["E01"]
+
+
+def test_normalize_scope_dict_missing_mode_with_role():
+    """A scope dict with role but no mode gets mode:'role' injected."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [
+        {
+            "id": "t1",
+            "name": "T",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": {"role": "test"},
+        }
+    ]
+    result = _validate_tactics(tactics)
+    assert result[0]["scope"]["mode"] == "role"
+    assert result[0]["scope"]["role"] == "test"
+
+
+def test_normalize_scope_well_formed_dict_unchanged():
+    """A correctly formed scope dict passes through unchanged."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    scope = {"mode": "embryos", "embryo_ids": ["E01", "E02"]}
+    tactics = [
+        {
+            "id": "t1",
+            "name": "T",
+            "kind": "standing_timelapse",
+            "state": "planned",
+            "scope": scope,
+        }
+    ]
+    result = _validate_tactics(tactics)
+    assert result[0]["scope"] == scope
+
+
+def test_normalize_phase_state_pending_to_todo():
+    """Phase state 'pending' is normalized to 'todo'."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [
+        {
+            "id": "t1",
+            "name": "T",
+            "kind": "scripted_protocol",
+            "state": "planned",
+            "live": {
+                "readouts": [],
+                "phases": [
+                    {"name": "ramp", "state": "pending", "count": 0, "pips": []},
+                    {"name": "hold", "state": "running", "count": 0, "pips": []},
+                    {"name": "done_phase", "state": "completed", "count": 3, "pips": []},
+                ],
+            },
+        }
+    ]
+    result = _validate_tactics(tactics)
+    phases = result[0]["live"]["phases"]
+    assert phases[0]["state"] == "todo"
+    assert phases[1]["state"] == "active"
+    assert phases[2]["state"] == "done"
+
+
+def test_normalize_tactic_state_synonyms():
+    """Tactic state synonyms are mapped to canonical values."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    cases = [
+        ("in_progress", "active"),
+        ("running", "active"),
+        ("pending", "planned"),
+        ("queued", "planned"),
+        ("complete", "done"),
+        ("completed", "done"),
+    ]
+    for raw_state, expected in cases:
+        tactics = [{"id": "t1", "name": "T", "kind": "oneshot", "state": "planned"}]
+        # Override state directly
+        tactics[0]["state"] = raw_state
+        result = _validate_tactics(tactics)
+        assert result[0]["state"] == expected, (
+            f"state '{raw_state}' should map to '{expected}'"
+        )
+
+
+def test_normalize_full_scenario():
+    """Combined: kind synonym + bare-list scope + pending phase state + running tactic state."""
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    tactics = [
+        {
+            "id": "t1",
+            "name": "Temp monitor",
+            "kind": "monitor",  # synonym → reactive_monitor
+            "state": "in_progress",  # synonym → active
+            "scope": ["E01", "E02"],  # bare list → {mode:embryos, embryo_ids:[...]}
+            "rationale": "Watch temp",
+            "live": {
+                "readouts": [{"label": "temp", "value": "25 °C"}],
+                "phases": [
+                    {"name": "watch", "state": "pending", "count": 0, "pips": []},
+                ],
+            },
+        }
+    ]
+    result = _validate_tactics(tactics)
+    t = result[0]
+    assert t["kind"] == "reactive_monitor"
+    assert t["state"] == "active"
+    assert t["scope"] == {"mode": "embryos", "embryo_ids": ["E01", "E02"]}
+    assert t["live"]["phases"][0]["state"] == "todo"
+    assert t["live"]["readouts"] == [{"label": "temp", "value": "25 °C"}]
+
+
 # ---------------------------------------------------------------------------
 # Registration test
 # ---------------------------------------------------------------------------

From a1c81705822d7bf1fbf7720a66d7de8a9fbfa489 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 11:06:53 +0530
Subject: [PATCH 252/314] fix(device): bound live-view memory (cap+drain+snap
 mode) + side-B galvo/piezo
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

FIX 1 — buffer hardening:
- Add snap-loop mode (default): _grab_lightsheet_frame_sync uses
  snapImage()+getImage() per frame; no circular buffer, hard memory ceiling.
- Continuous mode (opt-in via _ls_params["mode"]="continuous"): cap buffer
  with setCircularBufferMemoryFootprint(256) before start; drain with
  clearCircularBuffer() after each getLastImage() peek.
- _stop_lightsheet_sequence_sync: always calls clearCircularBuffer() on every
  exit path (disconnect, error, pause, view-exit via finally block).

FIX 2 — side-B galvo/piezo:
- device_factory.py: defensively register scanner_b (Scanner:CD:33) and
  piezo_b (PiezoStage:Q:35) when present in getLoadedDevices(); skip+log
  on single-side rigs.
- _park_lightsheet_sync: select scanner_b/piezo_b for side B, fall back
  to A with warning when absent; single-camera rigs unaffected.

TDD: 12 tests red → green; 40 target tests pass; 0 new failures in full suite.
---
 gently/hardware/dispim/device_factory.py |  37 ++++
 gently/hardware/dispim/device_layer.py   | 137 ++++++++++--
 tests/test_dual_camera_factory.py        |  56 +++++
 tests/test_lightsheet_buffer.py          | 252 +++++++++++++++++++++++
 tests/test_lightsheet_side_param.py      | 131 +++++++++++-
 tests/test_lightsheet_streamer.py        |   6 +-
 6 files changed, 593 insertions(+), 26 deletions(-)
 create mode 100644 tests/test_lightsheet_buffer.py

diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index 96b0d276..cfef7d24 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -67,6 +67,9 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
         "camera_b_name": "HamCam2",
         "scanner_name": "Scanner:AB:33",
         "piezo_name": "PiezoStage:P:34",
+        # Side-B optics: registered defensively (absent on single-side rigs)
+        "scanner_b_name": "Scanner:CD:33",
+        "piezo_b_name": "PiezoStage:Q:35",
         "fdrive_name": "ZStage:V:37",
         "bottom_camera_name": "Bottom PCO",
         "led_name": "LED:X:31",
@@ -129,6 +132,40 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
     except Exception as e:
         logger.warning("Could not create camera_b: %s", e)
 
+    # Defensively register the side-B galvo scanner (Scanner:CD:33).
+    # Absent on single-side rigs — skip + log, do not crash.
+    try:
+        scanner_b_name = cfg.get("scanner_b_name", "Scanner:CD:33")
+        loaded_devices = list(core.getLoadedDevices())
+        if scanner_b_name in loaded_devices:
+            scanner_b = DiSPIMScanner(name=scanner_b_name, core=core)
+            devices["scanner_b"] = scanner_b
+            logger.info("Created scanner_b (side B): %s", scanner_b_name)
+        else:
+            logger.warning(
+                "scanner_b (%s) not in loaded devices — single-side rig or device absent; skipping",
+                scanner_b_name,
+            )
+    except Exception as e:
+        logger.warning("Could not create scanner_b: %s", e)
+
+    # Defensively register the side-B imaging piezo (PiezoStage:Q:35).
+    # Absent on single-side rigs — skip + log, do not crash.
+    try:
+        piezo_b_name = cfg.get("piezo_b_name", "PiezoStage:Q:35")
+        loaded_devices = list(core.getLoadedDevices())
+        if piezo_b_name in loaded_devices:
+            piezo_b = DiSPIMPiezo(name=piezo_b_name, core=core)
+            devices["piezo_b"] = piezo_b
+            logger.info("Created piezo_b (side B): %s", piezo_b_name)
+        else:
+            logger.warning(
+                "piezo_b (%s) not in loaded devices — single-side rig or device absent; skipping",
+                piezo_b_name,
+            )
+    except Exception as e:
+        logger.warning("Could not create piezo_b: %s", e)
+
     try:
         from .devices import DiSPIMLightSource
 
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 69b51581..2c5127a3 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -174,7 +174,15 @@ def __init__(
         self._ls_interval_sec: float = 0.0          # peek as fast as exposure allows
         self._ls_target_max_dim: int = 512
         self._ls_jpeg_quality: int = 70
-        self._ls_params: dict = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0, "side": "A"}
+        self._ls_params: dict = {
+            "galvo": 0.0,
+            "piezo": 50.0,
+            "exposure": 20.0,
+            "side": "A",
+            # "snap"  → per-frame snapImage()+getImage() — hard memory ceiling, safe default.
+            # "continuous" → startContinuousSequenceAcquisition (opt-in, higher FPS).
+            "mode": "snap",
+        }
         self._ls_seq_started: bool = False
         self._ls_applied: dict = {}                  # last-applied galvo/piezo/exposure
         self._ls_parked: dict = {}                   # last-parked galvo/piezo setPosition values
@@ -981,6 +989,11 @@ async def _broadcast_camera(self, payload: dict[str, Any]):
     def _park_lightsheet_sync(self) -> None:
         """Park scanner galvo + imaging piezo at the current live params (static sheet).
 
+        Side 'A' drives devices["scanner"] / devices["piezo"] (Scanner:AB:33 /
+        PiezoStage:P:34).  Side 'B' drives devices["scanner_b"] / devices["piezo_b"]
+        (Scanner:CD:33 / PiezoStage:Q:35) when registered.  Falls back to side A
+        with a warning on single-side rigs so they are never broken.
+
         Guards:
         - set_spim_state("Idle") fires once per stream session, not per frame
           (4 serial round-trips on first call → 0 on every subsequent frame).
@@ -988,8 +1001,32 @@ def _park_lightsheet_sync(self) -> None:
           last-applied value (no-op on steady-state frames).
         """
         p = self._ls_params
-        scanner = self.devices.get("scanner")
-        piezo = self.devices.get("piezo")
+        side = p.get("side", "A")
+
+        # Resolve scanner for the requested side (with fallback to A).
+        if side == "B":
+            if "scanner_b" in self.devices:
+                scanner = self.devices["scanner_b"]
+            else:
+                logger.warning(
+                    "Side B requested but scanner_b not registered; falling back to side A for scanner"
+                )
+                scanner = self.devices.get("scanner")
+        else:
+            scanner = self.devices.get("scanner")
+
+        # Resolve piezo for the requested side (with fallback to A).
+        if side == "B":
+            if "piezo_b" in self.devices:
+                piezo = self.devices["piezo_b"]
+            else:
+                logger.warning(
+                    "Side B requested but piezo_b not registered; falling back to side A for piezo"
+                )
+                piezo = self.devices.get("piezo")
+        else:
+            piezo = self.devices.get("piezo")
+
         # SPIM Idle state machine: drive both devices Idle once per session.
         if not self._ls_spim_idle:
             if scanner is not None:
@@ -1016,7 +1053,18 @@ def _park_lightsheet_sync(self) -> None:
                 self._ls_parked["piezo"] = want
 
     def _ensure_lightsheet_sequence_sync(self) -> None:
-        """Start (or restart on exposure/side change) the continuous sequence on the SPIM camera.
+        """Configure (or reconfigure on exposure/side change) the SPIM camera.
+
+        Two modes gated by ``_ls_params["mode"]``:
+
+        "snap" (default, safe) — per-frame snapImage()+getImage().  No circular
+            buffer at all; memory is bounded to one frame.  Sets camera device
+            and exposure only when a reconfiguration is needed; never calls
+            startContinuousSequenceAcquisition.
+
+        "continuous" (opt-in) — startContinuousSequenceAcquisition with a hard
+            footprint cap (256 MB) so the buffer can't balloon on a production
+            box.  The grab loop drains with clearCircularBuffer() after each peek.
 
         Side 'A' uses devices["camera"] (HamCam1); side 'B' uses devices["camera_b"]
         (HamCam2) when registered.  If side B is requested but camera_b is absent,
@@ -1025,10 +1073,11 @@ def _ensure_lightsheet_sequence_sync(self) -> None:
         core = self.system.core
         p = self._ls_params
         side = p.get("side", "A")
+        mode = p.get("mode", "snap")
 
         # Resolve the camera for the requested side
         if side == "B" and "camera_b" in self.devices:
-            cam = self.devices.get("camera_b")
+            cam = self.devices["camera_b"]
         else:
             if side == "B":
                 logger.warning(
@@ -1039,33 +1088,76 @@ def _ensure_lightsheet_sequence_sync(self) -> None:
         if cam is None:
             raise RuntimeError("No lightsheet camera configured")
 
-        need_restart = (
+        need_reconfigure = (
             not self._ls_seq_started
             or self._ls_applied.get("exposure") != p["exposure"]
             or self._ls_applied.get("side") != side
         )
-        if need_restart:
-            if core.isSequenceRunning():
-                core.stopSequenceAcquisition()
-            if core.getCameraDevice() != cam.name:
-                core.setCameraDevice(cam.name)
-            core.setExposure(cam.name, float(p["exposure"]))
-            core.startContinuousSequenceAcquisition(self._ls_interval_sec * 1000.0)
-            self._ls_seq_started = True
-            self._ls_applied["exposure"] = p["exposure"]
-            self._ls_applied["side"] = side
+
+        if mode == "snap":
+            # Snap mode: configure camera/exposure on change; no continuous sequence.
+            if need_reconfigure:
+                # Stop any lingering continuous sequence before snap takes over.
+                if core.isSequenceRunning():
+                    core.stopSequenceAcquisition()
+                    try:
+                        core.clearCircularBuffer()
+                    except Exception:
+                        pass
+                if core.getCameraDevice() != cam.name:
+                    core.setCameraDevice(cam.name)
+                core.setExposure(cam.name, float(p["exposure"]))
+                self._ls_seq_started = True  # "camera configured" flag; no sequence running
+                self._ls_applied["exposure"] = p["exposure"]
+                self._ls_applied["side"] = side
+        else:
+            # Continuous mode: cap buffer footprint then start sequence.
+            if need_reconfigure:
+                if core.isSequenceRunning():
+                    core.stopSequenceAcquisition()
+                if core.getCameraDevice() != cam.name:
+                    core.setCameraDevice(cam.name)
+                core.setExposure(cam.name, float(p["exposure"]))
+                # Hard cap: prevent buffer balloon that crashed the production box.
+                try:
+                    core.setCircularBufferMemoryFootprint(256)
+                except Exception:
+                    logger.debug(
+                        "setCircularBufferMemoryFootprint not available on this core",
+                        exc_info=True,
+                    )
+                core.startContinuousSequenceAcquisition(self._ls_interval_sec * 1000.0)
+                self._ls_seq_started = True
+                self._ls_applied["exposure"] = p["exposure"]
+                self._ls_applied["side"] = side
 
     def _grab_lightsheet_frame_sync(self):
-        """Park → ensure sequence running → peek the latest frame (never drain)."""
+        """Park → configure camera → grab one frame.
+
+        Snap mode (default): snapImage()+getImage() — no circular buffer,
+        hard memory ceiling, safe for long live-view sessions.
+
+        Continuous mode (opt-in): peeks via getLastImage() then drains the
+        buffer with clearCircularBuffer() to prevent it sitting full.
+        """
         try:
-            self._park_lightsheet_sync()                  # galvo/piezo applied live
-            self._ensure_lightsheet_sequence_sync()       # start / restart on exposure
+            self._park_lightsheet_sync()
+            self._ensure_lightsheet_sequence_sync()
             try:
                 from gently.hardware.dispim.devices.acquisition import _safe_obtain
             except (ImportError, AttributeError):
                 _safe_obtain = None
             core = self.system.core
-            img = core.getLastImage()
+            mode = self._ls_params.get("mode", "snap")
+            if mode == "snap":
+                core.snapImage()
+                img = core.getImage()
+            else:
+                img = core.getLastImage()
+                try:
+                    core.clearCircularBuffer()
+                except Exception:
+                    pass
             if _safe_obtain is not None:
                 try:
                     img = _safe_obtain(img)
@@ -1082,6 +1174,11 @@ def _stop_lightsheet_sequence_sync(self) -> None:
                 self.system.core.stopSequenceAcquisition()
         except Exception:
             logger.debug("stop lightsheet sequence failed", exc_info=True)
+        # Drain the buffer on every stop path (snap mode: no-op; continuous: release memory).
+        try:
+            self.system.core.clearCircularBuffer()
+        except Exception:
+            pass
         self._ls_seq_started = False
         self._ls_applied = {}
         # Reset park guard so the next stream session re-idles the state
diff --git a/tests/test_dual_camera_factory.py b/tests/test_dual_camera_factory.py
index 5476184e..7149f82e 100644
--- a/tests/test_dual_camera_factory.py
+++ b/tests/test_dual_camera_factory.py
@@ -105,3 +105,59 @@ def test_camera_b_absent_on_empty_device_list():
     devices = create_devices_from_mmcore(core)
     assert "camera_b" not in devices
     assert "camera" in devices
+
+
+# ---------------------------------------------------------------------------
+# Side-B optics: scanner_b / piezo_b defensive registration
+# ---------------------------------------------------------------------------
+
+
+def test_scanner_b_created_when_present():
+    """Scanner:CD:33 in getLoadedDevices → devices['scanner_b'] with that name."""
+    core = FakeCore(loaded_devices=["HamCam1", "Scanner:CD:33"])
+    devices = create_devices_from_mmcore(core)
+    assert "scanner_b" in devices, "scanner_b must be registered when Scanner:CD:33 is loaded"
+    assert devices["scanner_b"].name == "Scanner:CD:33"
+
+
+def test_scanner_b_absent_when_not_loaded():
+    """Scanner:CD:33 NOT loaded → scanner_b absent, no crash."""
+    core = FakeCore(loaded_devices=["HamCam1"])
+    devices = create_devices_from_mmcore(core)
+    assert "scanner_b" not in devices
+
+
+def test_piezo_b_created_when_present():
+    """PiezoStage:Q:35 in getLoadedDevices → devices['piezo_b'] with that name."""
+    core = FakeCore(loaded_devices=["HamCam1", "PiezoStage:Q:35"])
+    devices = create_devices_from_mmcore(core)
+    assert "piezo_b" in devices, "piezo_b must be registered when PiezoStage:Q:35 is loaded"
+    assert devices["piezo_b"].name == "PiezoStage:Q:35"
+
+
+def test_piezo_b_absent_when_not_loaded():
+    """PiezoStage:Q:35 NOT loaded → piezo_b absent, no crash."""
+    core = FakeCore(loaded_devices=["HamCam1"])
+    devices = create_devices_from_mmcore(core)
+    assert "piezo_b" not in devices
+
+
+def test_scanner_b_piezo_b_both_present_on_dual_side_rig():
+    """Full dual-side rig: both scanner_b and piezo_b created; side A unchanged."""
+    core = FakeCore(loaded_devices=["HamCam1", "HamCam2", "Scanner:CD:33", "PiezoStage:Q:35"])
+    devices = create_devices_from_mmcore(core)
+    assert "scanner_b" in devices
+    assert "piezo_b" in devices
+    # Side-A optics must still be present
+    assert "scanner" in devices
+    assert "piezo" in devices
+
+
+def test_scanner_b_piezo_b_both_absent_on_single_side_rig():
+    """Single-side rig: neither scanner_b nor piezo_b created; A-side and camera OK."""
+    core = FakeCore(loaded_devices=["HamCam1"])
+    devices = create_devices_from_mmcore(core)
+    assert "scanner_b" not in devices
+    assert "piezo_b" not in devices
+    assert "scanner" in devices
+    assert "piezo" in devices
diff --git a/tests/test_lightsheet_buffer.py b/tests/test_lightsheet_buffer.py
new file mode 100644
index 00000000..de9f9235
--- /dev/null
+++ b/tests/test_lightsheet_buffer.py
@@ -0,0 +1,252 @@
+"""Tests for live-view buffer hardening.
+
+Verifies:
+  - snap mode (default) uses snapImage()+getImage() — no circular buffer
+  - snap mode does NOT call startContinuousSequenceAcquisition
+  - continuous mode calls setCircularBufferMemoryFootprint(256) before starting
+  - continuous mode calls clearCircularBuffer() after each getLastImage()
+  - _stop_lightsheet_sequence_sync calls clearCircularBuffer() in both modes
+"""
+import sys
+from unittest.mock import MagicMock
+
+import numpy as np
+import pytest
+
+# Patch heavy hardware deps before importing device_layer
+for _mod in (
+    "bluesky",
+    "bluesky.run_engine",
+    "ophyd",
+    "ophyd.status",
+    "pymmcore",
+    "gently.hardware.console_ui",
+):
+    if _mod not in sys.modules:
+        sys.modules[_mod] = MagicMock()
+
+import bluesky as _bs  # noqa: E402
+
+_bs.RunEngine = MagicMock(name="RunEngine")
+
+from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
+
+
+# ---------------------------------------------------------------------------
+# Full-featured FakeCore tracking every buffer-related call
+# ---------------------------------------------------------------------------
+
+
+class BufferFakeCore:
+    """CMMCore stub that records every buffer/snap/sequence call."""
+
+    def __init__(self):
+        self.cam = None
+        self.running = False
+        self.started = 0
+        self.stopped = 0
+        self.exposure = None
+        self.footprint_set: int | None = None  # value passed to setCircularBufferMemoryFootprint
+        self.clear_called = 0
+        self.snap_called = 0
+        self.get_image_called = 0
+        self.get_last_image_called = 0
+
+    def setCameraDevice(self, n):
+        self.cam = n
+
+    def getCameraDevice(self):
+        return self.cam or ""
+
+    def setExposure(self, n, ms):
+        self.exposure = ms
+
+    def isSequenceRunning(self):
+        return self.running
+
+    def startContinuousSequenceAcquisition(self, interval):
+        self.running = True
+        self.started += 1
+
+    def stopSequenceAcquisition(self):
+        self.running = False
+        self.stopped += 1
+
+    def setCircularBufferMemoryFootprint(self, mb: int):
+        self.footprint_set = mb
+
+    def clearCircularBuffer(self):
+        self.clear_called += 1
+
+    def snapImage(self):
+        self.snap_called += 1
+
+    def getImage(self):
+        self.get_image_called += 1
+        return np.zeros((4, 4), dtype=np.uint16)
+
+    def getLastImage(self):
+        self.get_last_image_called += 1
+        return np.zeros((4, 4), dtype=np.uint16)
+
+
+class FakeAxisOffset:
+    def __init__(self):
+        self.last_pos = None
+
+    def setPosition(self, val):
+        self.last_pos = val
+
+
+class FakeScanner:
+    def __init__(self, name):
+        self.name = name
+        self.sa_offset_y = FakeAxisOffset()
+
+    def set_spim_state(self, state):
+        pass
+
+
+class FakePiezo:
+    def __init__(self, name):
+        self.name = name
+        self.last_pos = None
+
+    def setPosition(self, val):
+        self.last_pos = val
+
+    def set_spim_state(self, state):
+        pass
+
+
+def _make_dl_buffer(mode: str = "snap") -> DeviceLayerServer:
+    """Build a minimal DL for buffer-hardening tests."""
+    dl = DeviceLayerServer.__new__(DeviceLayerServer)
+    core = BufferFakeCore()
+    dl.system = type("S", (), {"core": core})()
+    cam_a = type("C", (), {"name": "HamCam1"})()
+    dl.devices = {
+        "camera": cam_a,
+        "scanner": FakeScanner("Scanner:AB:33"),
+        "piezo": FakePiezo("PiezoStage:P:34"),
+    }
+    dl._ls_params = {
+        "galvo": 0.0,
+        "piezo": 50.0,
+        "exposure": 20.0,
+        "side": "A",
+        "mode": mode,
+    }
+    dl._ls_seq_started = False
+    dl._ls_applied = {}
+    dl._ls_interval_sec = 0.0
+    dl._ls_parked = {}
+    dl._ls_spim_idle = False
+    return dl
+
+
+# ---------------------------------------------------------------------------
+# Snap mode — snapImage + getImage, no circular buffer
+# ---------------------------------------------------------------------------
+
+
+def test_snap_mode_calls_snapimage_and_getimage():
+    """snap mode: _grab_lightsheet_frame_sync calls snapImage() + getImage()."""
+    dl = _make_dl_buffer(mode="snap")
+    dl._grab_lightsheet_frame_sync()
+    core = dl.system.core
+    assert core.snap_called >= 1, "snapImage() must be called in snap mode"
+    assert core.get_image_called >= 1, "getImage() must be called in snap mode"
+
+
+def test_snap_mode_does_not_call_get_last_image():
+    """snap mode: getLastImage() is NOT called (avoids the never-draining buffer)."""
+    dl = _make_dl_buffer(mode="snap")
+    dl._grab_lightsheet_frame_sync()
+    assert dl.system.core.get_last_image_called == 0
+
+
+def test_snap_mode_does_not_start_continuous_sequence():
+    """snap mode: startContinuousSequenceAcquisition is never called."""
+    dl = _make_dl_buffer(mode="snap")
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.started == 0, (
+        "startContinuousSequenceAcquisition must not be called in snap mode"
+    )
+
+
+def test_snap_mode_does_not_start_continuous_on_grab():
+    """snap mode grab loop never starts continuous acquisition."""
+    dl = _make_dl_buffer(mode="snap")
+    dl._grab_lightsheet_frame_sync()
+    assert dl.system.core.started == 0
+
+
+# ---------------------------------------------------------------------------
+# Continuous mode — buffer cap + drain
+# ---------------------------------------------------------------------------
+
+
+def test_continuous_mode_sets_circular_buffer_footprint():
+    """continuous mode: setCircularBufferMemoryFootprint(256) called before start."""
+    dl = _make_dl_buffer(mode="continuous")
+    dl._ensure_lightsheet_sequence_sync()
+    core = dl.system.core
+    assert core.footprint_set is not None, (
+        "setCircularBufferMemoryFootprint must be called in continuous mode"
+    )
+    assert core.footprint_set == 256, (
+        f"footprint must be 256 MB, got {core.footprint_set}"
+    )
+
+
+def test_continuous_mode_calls_clear_after_grab():
+    """continuous mode: clearCircularBuffer() called after each getLastImage()."""
+    dl = _make_dl_buffer(mode="continuous")
+    dl._grab_lightsheet_frame_sync()
+    core = dl.system.core
+    assert core.clear_called >= 1, (
+        "clearCircularBuffer() must be called after getLastImage() in continuous mode"
+    )
+
+
+def test_continuous_mode_starts_sequence():
+    """continuous mode: startContinuousSequenceAcquisition is called."""
+    dl = _make_dl_buffer(mode="continuous")
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl.system.core.started == 1
+
+
+# ---------------------------------------------------------------------------
+# Stop sequence — clearCircularBuffer on every exit path
+# ---------------------------------------------------------------------------
+
+
+def test_stop_calls_clear_circular_buffer():
+    """_stop_lightsheet_sequence_sync always calls clearCircularBuffer()."""
+    dl = _make_dl_buffer(mode="continuous")
+    # Start a sequence first so there's something to stop
+    dl._ensure_lightsheet_sequence_sync()
+    clear_before = dl.system.core.clear_called
+    dl._stop_lightsheet_sequence_sync()
+    assert dl.system.core.clear_called > clear_before, (
+        "clearCircularBuffer must be called in _stop_lightsheet_sequence_sync"
+    )
+
+
+def test_stop_resets_seq_started():
+    """_stop_lightsheet_sequence_sync resets _ls_seq_started to False."""
+    dl = _make_dl_buffer(mode="continuous")
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl._ls_seq_started is True
+    dl._stop_lightsheet_sequence_sync()
+    assert dl._ls_seq_started is False
+
+
+def test_stop_clears_applied_state():
+    """_stop_lightsheet_sequence_sync clears _ls_applied so next start does a full restart."""
+    dl = _make_dl_buffer(mode="continuous")
+    dl._ensure_lightsheet_sequence_sync()
+    assert dl._ls_applied != {}
+    dl._stop_lightsheet_sequence_sync()
+    assert dl._ls_applied == {}
diff --git a/tests/test_lightsheet_side_param.py b/tests/test_lightsheet_side_param.py
index 25009334..e4679c47 100644
--- a/tests/test_lightsheet_side_param.py
+++ b/tests/test_lightsheet_side_param.py
@@ -68,17 +68,82 @@ def stopSequenceAcquisition(self):
     def isSequenceRunning(self):
         return self.running
 
+    def setCircularBufferMemoryFootprint(self, mb):
+        pass  # no-op for camera-selection tests
 
-def _make_dl(with_camera_b: bool = True) -> DeviceLayerServer:
-    """Build a minimal DeviceLayerServer with faked core + devices."""
+    def clearCircularBuffer(self):
+        pass  # no-op for camera-selection tests
+
+
+class FakeAxisOffset:
+    """Stub for DiSPIMScanner.sa_offset_y tracking setPosition calls."""
+
+    def __init__(self):
+        self.last_pos = None
+
+    def setPosition(self, val: float) -> None:
+        self.last_pos = val
+
+
+class FakeScanner:
+    """Stub scanner with sa_offset_y and set_spim_state."""
+
+    def __init__(self, name: str):
+        self.name = name
+        self.sa_offset_y = FakeAxisOffset()
+        self.spim_state = None
+
+    def set_spim_state(self, state: str) -> None:
+        self.spim_state = state
+
+
+class FakePiezo:
+    """Stub piezo tracking setPosition and set_spim_state calls."""
+
+    def __init__(self, name: str):
+        self.name = name
+        self.last_pos = None
+        self.spim_state = None
+
+    def setPosition(self, val: float) -> None:
+        self.last_pos = val
+
+    def set_spim_state(self, state: str) -> None:
+        self.spim_state = state
+
+
+def _make_dl(
+    with_camera_b: bool = True,
+    with_scanner_b: bool = False,
+    with_piezo_b: bool = False,
+) -> DeviceLayerServer:
+    """Build a minimal DeviceLayerServer with faked core + devices.
+
+    mode is set to "continuous" so existing sequence-start assertions remain
+    meaningful (snap mode is the production default but tested separately).
+    """
     dl = DeviceLayerServer.__new__(DeviceLayerServer)
     dl.system = type("S", (), {"core": FakeCore()})()
     cam_a = type("C", (), {"name": "HamCam1"})()
     cam_b = type("C", (), {"name": "HamCam2"})()
-    dl.devices = {"camera": cam_a}
+    dl.devices = {
+        "camera": cam_a,
+        "scanner": FakeScanner("Scanner:AB:33"),
+        "piezo": FakePiezo("PiezoStage:P:34"),
+    }
     if with_camera_b:
         dl.devices["camera_b"] = cam_b
-    dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 20.0, "side": "A"}
+    if with_scanner_b:
+        dl.devices["scanner_b"] = FakeScanner("Scanner:CD:33")
+    if with_piezo_b:
+        dl.devices["piezo_b"] = FakePiezo("PiezoStage:Q:35")
+    dl._ls_params = {
+        "galvo": 0.0,
+        "piezo": 50.0,
+        "exposure": 20.0,
+        "side": "A",
+        "mode": "continuous",  # explicit — snap mode tested in test_lightsheet_buffer.py
+    }
     dl._ls_seq_started = False
     dl._ls_applied = {}
     dl._ls_interval_sec = 0.0
@@ -221,3 +286,61 @@ async def test_handle_get_cameras_without_camera_b():
     resp = await dl.handle_get_cameras(req)
     body = json.loads(resp.body)
     assert body["cameras"] == ["A"]
+
+
+# ---------------------------------------------------------------------------
+# _park_lightsheet_sync — side selects correct scanner/piezo
+# ---------------------------------------------------------------------------
+
+
+def test_side_a_parks_scanner_a():
+    """Side A → _park_lightsheet_sync drives scanner A's galvo."""
+    dl = _make_dl()
+    dl._ls_params["side"] = "A"
+    dl._park_lightsheet_sync()
+    assert dl.devices["scanner"].sa_offset_y.last_pos is not None
+
+
+def test_side_b_parks_scanner_b():
+    """Side B with scanner_b present → _park_lightsheet_sync drives scanner B."""
+    dl = _make_dl(with_scanner_b=True)
+    dl._ls_params["side"] = "B"
+    dl._park_lightsheet_sync()
+    assert dl.devices["scanner_b"].sa_offset_y.last_pos is not None
+    # Side A scanner must be untouched
+    assert dl.devices["scanner"].sa_offset_y.last_pos is None
+
+
+def test_side_b_scanner_b_absent_falls_back_to_scanner_a():
+    """Side B without scanner_b → graceful fallback to scanner A, no crash."""
+    dl = _make_dl(with_scanner_b=False)
+    dl._ls_params["side"] = "B"
+    dl._park_lightsheet_sync()
+    # Fallback: scanner A gets the park
+    assert dl.devices["scanner"].sa_offset_y.last_pos is not None
+
+
+def test_side_a_parks_piezo_a():
+    """Side A → _park_lightsheet_sync drives piezo A."""
+    dl = _make_dl()
+    dl._ls_params["side"] = "A"
+    dl._park_lightsheet_sync()
+    assert dl.devices["piezo"].last_pos is not None
+
+
+def test_side_b_parks_piezo_b():
+    """Side B with piezo_b present → _park_lightsheet_sync drives piezo B."""
+    dl = _make_dl(with_scanner_b=True, with_piezo_b=True)
+    dl._ls_params["side"] = "B"
+    dl._park_lightsheet_sync()
+    assert dl.devices["piezo_b"].last_pos is not None
+    # Side A piezo must be untouched
+    assert dl.devices["piezo"].last_pos is None
+
+
+def test_side_b_piezo_b_absent_falls_back_to_piezo_a():
+    """Side B without piezo_b → graceful fallback to piezo A, no crash."""
+    dl = _make_dl(with_piezo_b=False)
+    dl._ls_params["side"] = "B"
+    dl._park_lightsheet_sync()
+    assert dl.devices["piezo"].last_pos is not None
diff --git a/tests/test_lightsheet_streamer.py b/tests/test_lightsheet_streamer.py
index c36377a1..9091ea13 100644
--- a/tests/test_lightsheet_streamer.py
+++ b/tests/test_lightsheet_streamer.py
@@ -64,7 +64,8 @@ async def test_grab_parks_and_peeks(monkeypatch):
     dl = _make_dl()
     dl._state_pause_counter = 0
     dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
-    dl._ls_params = {"galvo": 1.5, "piezo": 40.0, "exposure": 20.0}
+    # Explicit continuous mode: this test verifies the sequence-start + getLastImage path.
+    dl._ls_params = {"galvo": 1.5, "piezo": 40.0, "exposure": 20.0, "mode": "continuous"}
     dl._ls_seq_started = False; dl._ls_applied = {}
     dl._ls_interval_sec = 0.0
     img = await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
@@ -79,7 +80,8 @@ async def test_exposure_change_restarts_sequence():
     dl = _make_dl()
     dl._state_pause_counter = 0
     dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
-    dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 10.0}
+    # Explicit continuous mode: this test verifies restart on exposure change.
+    dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 10.0, "mode": "continuous"}
     dl._ls_seq_started = False; dl._ls_applied = {}
     dl._ls_interval_sec = 0.0
     await asyncio.to_thread(dl._grab_lightsheet_frame_sync)

From 656e97496f3851f11030f823cc76d07a8b2e42c4 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 11:19:36 +0530
Subject: [PATCH 253/314] feat(manual): timelapse config as an accordion with
 active/inactive section states
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Restructure the flat timelapse panel into 3 independently collapsible
accordion sections — Schedule (open by default), Targets, Volume geometry.

Active/inactive state:
- Each section header starts muted (hollow 5-px dot, dimmed label).
- Any user input/change event in a section flips it active: dot fills
  accent cyan, label turns accent, a one-line summary appears inline.
- Summaries: "60 s · 5 frames" / "all · Idle (plain imaging)" /
  "80 sl · 10 ms · ALL OFF".
- The outer Timelapse panel header shows an accent dot once any section
  is set; the Start Timelapse button turns accent-bordered when ready.
- Re-entering the manual view (initTlForm) resets all touched state and
  clears visual active state.

Payload unchanged: all field IDs preserved, POST body identical.
node --check: exit 0.
---
 gently/ui/web/static/css/main.css  | 132 ++++++++++++++++
 gently/ui/web/static/js/devices.js | 121 +++++++++++++--
 gently/ui/web/templates/index.html | 235 ++++++++++++++++-------------
 3 files changed, 366 insertions(+), 122 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 9215466a..7e04b232 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10937,3 +10937,135 @@ body.modal-open {
 }
 
 .ls-tl-status[hidden] { display: none; }
+
+/* ── Timelapse accordion (active/inactive section states — B3 UX) ─────────── */
+
+/* Wrapper for each accordion section */
+.ls-acc-section {
+    display: flex;
+    flex-direction: column;
+    border-bottom: 1px solid var(--map-rule-soft);
+    padding-bottom: 0.12rem;
+    margin-bottom: 0.08rem;
+}
+.ls-acc-section:last-of-type {
+    border-bottom: none;
+    margin-bottom: 0;
+}
+
+/* Section header button */
+.ls-acc-head {
+    display: flex;
+    align-items: center;
+    gap: 0.32rem;
+    background: transparent;
+    border: none;
+    padding: 0.26rem 0;
+    cursor: pointer;
+    width: 100%;
+    text-align: left;
+    font-family: inherit;
+}
+
+/* Status dot — hollow/muted when inactive */
+.ls-acc-dot {
+    width: 5px;
+    height: 5px;
+    border-radius: 50%;
+    border: 1px solid var(--map-ink-mute);
+    background: transparent;
+    flex-shrink: 0;
+    transition: background 0.15s, border-color 0.15s;
+}
+
+/* Section label */
+.ls-acc-title {
+    font-size: 0.575rem;
+    font-weight: 600;
+    letter-spacing: 0.12em;
+    text-transform: uppercase;
+    color: var(--map-ink-mute);
+    flex-shrink: 0;
+    transition: color 0.15s;
+}
+
+/* One-line summary — shown only when section is touched */
+.ls-acc-summary {
+    flex: 1;
+    font-size: 0.57rem;
+    font-family: 'JetBrains Mono', monospace;
+    letter-spacing: 0.02em;
+    color: var(--map-ink-mute);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    min-width: 0;
+}
+.ls-acc-summary[hidden] { display: none; }
+
+/* Caret arrow */
+.ls-acc-arrow {
+    font-size: 0.44rem;
+    color: var(--map-ink-mute);
+    flex-shrink: 0;
+    margin-left: auto;
+    transition: transform 0.15s, color 0.15s;
+}
+.ls-acc-head[aria-expanded="true"] .ls-acc-arrow {
+    transform: rotate(90deg);
+}
+
+/* ── Active / touched state ────────────────────────────────────────────────── */
+.ls-acc-head.is-active .ls-acc-dot {
+    background: var(--map-accent);
+    border-color: var(--map-accent);
+}
+.ls-acc-head.is-active .ls-acc-title {
+    color: var(--map-accent);
+}
+.ls-acc-head.is-active .ls-acc-summary {
+    color: var(--map-accent);
+    opacity: 0.85;
+}
+.ls-acc-head.is-active .ls-acc-arrow {
+    color: var(--map-accent);
+}
+
+/* Section body */
+.ls-acc-body {
+    display: flex;
+    flex-direction: column;
+    gap: 0.26rem;
+    padding: 0.18rem 0 0.32rem 0.5rem;
+}
+.ls-acc-body[hidden] { display: none; }
+
+/* Outer timelapse panel header dot — signals any section is set */
+.ls-tl-outer-dot {
+    width: 5px;
+    height: 5px;
+    border-radius: 50%;
+    border: 1px solid transparent;
+    background: transparent;
+    flex-shrink: 0;
+    transition: background 0.15s, border-color 0.15s;
+}
+.ls-tl-outer-dot.is-active {
+    background: var(--map-accent);
+    border-color: var(--map-accent);
+}
+
+/* Start button reads "ready" (accent) once any section is configured */
+.ls-tl-start-btn {
+    transition: border-color 0.15s, color 0.15s, background 0.15s;
+}
+.ls-tl-start-btn.is-ready {
+    border-color: var(--map-accent);
+    color: var(--map-accent);
+    background: rgba(34, 211, 238, 0.08);
+}
+
+/* Submit row — give the button its full row width */
+.ls-tl-submit-row {
+    margin-top: 0.3rem;
+}
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 2319d9b2..67f8ca5d 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -113,6 +113,8 @@ const DevicesManager = (function () {
     let _tlEmbryos, _tlMode;
     let _tlSlices, _tlExposure, _tlGalvoAmp, _tlGalvoCtr, _tlPiezoAmp, _tlPiezoCtr, _tlLaser;
     let _tlStart, _tlStatus, _tlStatusText;
+    // Accordion active-state per section: { sched, targets, geom }
+    let _tlTouched = { sched: false, targets: false, geom: false };
 
     // Room-light toggle (header). Drives the SwitchBot Bot that switches the
     // diSPIM room light. State is the bot's cached on/off; hidden until the
@@ -1486,12 +1488,71 @@ const DevicesManager = (function () {
     // Timelapse config form (Manual view)
     // =====================================================================
 
-    /** Wire the timelapse panel's collapsible toggle and stop-condition selector.
-     *  Safe to call multiple times (idempotent via re-assignment of event handlers). */
+    // ── Accordion section summary builders ───────────────────────────────────
+
+    function _tlSchedSummary() {
+        const interval = (_tlInterval && _tlInterval.value) ? _tlInterval.value : '120';
+        const stop     = (_tlStop    && _tlStop.value)     ? _tlStop.value     : 'manual';
+        const condVal  = (_tlCondVal && _tlCondVal.value)  ? _tlCondVal.value  : '10';
+        if (stop === 'timepoints') return `${interval} s · ${condVal} frames`;
+        if (stop === 'duration')   return `${interval} s · ${condVal} h`;
+        return `${interval} s · manual`;
+    }
+
+    function _tlTargetsSummary() {
+        const embryos  = (_tlEmbryos && _tlEmbryos.value.trim())
+            ? _tlEmbryos.value.trim()
+            : 'all';
+        const modeEl   = _tlMode;
+        const modeText = (modeEl && modeEl.value)
+            ? modeEl.options[modeEl.selectedIndex].text
+            : 'none';
+        return `${embryos} · ${modeText}`;
+    }
+
+    function _tlGeomSummary() {
+        const slices   = (_tlSlices   && _tlSlices.value)   ? _tlSlices.value   : '50';
+        const exposure = (_tlExposure && _tlExposure.value) ? _tlExposure.value : '10';
+        const laser    = (_tlLaser    && _tlLaser.value)    ? _tlLaser.value    : 'ALL OFF';
+        return `${slices} sl · ${exposure} ms · ${laser}`;
+    }
+
+    /** Update a section's header active state and summary text, then sync the
+     *  outer panel dot and the start button.  sec = 'sched'|'targets'|'geom'. */
+    function _tlUpdateSection(sec) {
+        const head    = document.getElementById(`devices-tlacc-${sec}-head`);
+        const summary = document.getElementById(`devices-tlacc-${sec}-sum`);
+        const touched = _tlTouched[sec];
+
+        if (head)    head.classList.toggle('is-active', touched);
+        if (summary) {
+            summary.hidden = !touched;
+            if (touched) {
+                if      (sec === 'sched')   summary.textContent = _tlSchedSummary();
+                else if (sec === 'targets') summary.textContent = _tlTargetsSummary();
+                else if (sec === 'geom')    summary.textContent = _tlGeomSummary();
+            }
+        }
+
+        // Outer panel dot + start button "ready" state
+        const anyActive = Object.values(_tlTouched).some(Boolean);
+        const outerDot  = document.getElementById('devices-tl-outer-dot');
+        if (outerDot) outerDot.classList.toggle('is-active', anyActive);
+        if (_tlStart) _tlStart.classList.toggle('is-ready', anyActive);
+    }
+
+    /** Wire the timelapse panel: outer collapsible toggle, accordion section
+     *  toggles, touch listeners, and the submit button.
+     *  Safe to call multiple times (re-assigns handlers idempotently). */
     function initTlForm() {
         cacheDom();
 
-        // Collapsible head
+        // Reset touched state on each init (re-entering the manual view = fresh)
+        _tlTouched = { sched: false, targets: false, geom: false };
+        // Clear any leftover active-state visuals from a previous visit
+        ['sched', 'targets', 'geom'].forEach(sec => _tlUpdateSection(sec));
+
+        // ── Outer collapsible toggle ──────────────────────────────────────────
         if (_tlToggle && _tlBody) {
             _tlToggle.onclick = () => {
                 const open = _tlBody.hidden;
@@ -1502,22 +1563,52 @@ const DevicesManager = (function () {
             };
         }
 
-        // Conditional stop-value row: show for timepoints / duration, hide for manual
-        if (_tlStop && _tlCondRow) {
-            _tlStop.onchange = () => {
+        // ── Accordion section toggles ─────────────────────────────────────────
+        ['sched', 'targets', 'geom'].forEach(sec => {
+            const head = document.getElementById(`devices-tlacc-${sec}-head`);
+            const body = document.getElementById(`devices-tlacc-${sec}-body`);
+            if (!head || !body) return;
+            head.onclick = () => {
+                const open = body.hidden;
+                body.hidden = !open;
+                head.setAttribute('aria-expanded', String(open));
+                const arrow = head.querySelector('.ls-acc-arrow');
+                if (arrow) arrow.textContent = open ? '▼' : '▶';
+            };
+        });
+
+        // ── Touch listeners ───────────────────────────────────────────────────
+        const markTouched = sec => {
+            _tlTouched[sec] = true;
+            _tlUpdateSection(sec);
+        };
+
+        // Schedule — interval and stop condition drive summary; cond-row visibility unchanged
+        [_tlInterval, _tlCondVal].forEach(el => {
+            if (el) el.addEventListener('input', () => markTouched('sched'));
+        });
+        if (_tlStop) {
+            _tlStop.addEventListener('change', () => {
                 const v = _tlStop.value;
                 const show = v === 'timepoints' || v === 'duration';
-                _tlCondRow.hidden = !show;
-                if (_tlCondLabel) {
-                    _tlCondLabel.textContent = v === 'duration' ? 'Hours' : 'Count';
-                }
-            };
+                if (_tlCondRow)   _tlCondRow.hidden = !show;
+                if (_tlCondLabel) _tlCondLabel.textContent = v === 'duration' ? 'Hours' : 'Count';
+                markTouched('sched');
+            });
         }
 
-        // Submit button
-        if (_tlStart) {
-            _tlStart.onclick = startTimelapse;
-        }
+        // Targets
+        if (_tlEmbryos) _tlEmbryos.addEventListener('input',  () => markTouched('targets'));
+        if (_tlMode)    _tlMode.addEventListener('change',    () => markTouched('targets'));
+
+        // Volume geometry
+        [_tlSlices, _tlExposure, _tlGalvoAmp, _tlGalvoCtr, _tlPiezoAmp, _tlPiezoCtr].forEach(el => {
+            if (el) el.addEventListener('input', () => markTouched('geom'));
+        });
+        if (_tlLaser) _tlLaser.addEventListener('change', () => markTouched('geom'));
+
+        // ── Submit ────────────────────────────────────────────────────────────
+        if (_tlStart) _tlStart.onclick = startTimelapse;
     }
 
     /** Populate timelapse volume-geometry defaults from GET /api/devices/scan_geometry,
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 55090248..b069c156 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -849,127 +849,148 @@ <h3 class="devices-properties-title">Properties</h3>
                             </div>
                         </div>
 
-                        <!-- Timelapse (collapsible) -->
+                        <!-- Timelapse (collapsible panel → accordion of 3 sections) -->
                         <div class="ls-group" id="devices-tl-group">
                             <button class="ls-label ls-collapsible-head" id="devices-tl-toggle"
                                     type="button" aria-expanded="false"
                                     aria-controls="devices-tl-body">
-                                Timelapse
+                                <span style="flex:1">Timelapse</span>
+                                <span class="ls-tl-outer-dot" id="devices-tl-outer-dot" aria-hidden="true"></span>
                                 <span class="ls-collapsible-arrow" aria-hidden="true">▶</span>
                             </button>
                             <div class="ls-collapsible-body" id="devices-tl-body" hidden>
 
-                                <!-- Cadence -->
-                                <div class="ls-sub-row">
-                                    <label class="ls-sub-label" for="devices-tl-interval">Interval</label>
-                                    <input class="ls-number ls-number-sm" id="devices-tl-interval"
-                                           type="number" min="1" step="1" value="120"
-                                           inputmode="numeric" aria-label="Timelapse interval in seconds">
-                                    <span class="ls-unit">s</span>
-                                </div>
-
-                                <!-- Stop condition -->
-                                <div class="ls-sub-row">
-                                    <label class="ls-sub-label" for="devices-tl-stop">Stop when</label>
-                                    <select id="devices-tl-stop" class="ls-laser-select"
-                                            aria-label="Timelapse stop condition">
-                                        <option value="manual" selected>Manual</option>
-                                        <option value="timepoints">Timepoints</option>
-                                        <option value="duration">Duration (h)</option>
-                                    </select>
-                                </div>
-
-                                <!-- Conditional value (timepoints / duration) -->
-                                <div class="ls-sub-row" id="devices-tl-cond-row" hidden>
-                                    <label class="ls-sub-label" for="devices-tl-cond-val" id="devices-tl-cond-label">Count</label>
-                                    <input class="ls-number ls-number-sm" id="devices-tl-cond-val"
-                                           type="number" min="1" step="1" value="10"
-                                           inputmode="numeric" aria-label="Stop condition value">
-                                </div>
-
-                                <!-- Embryo IDs (comma-separated, optional) -->
-                                <div class="ls-sub-row">
-                                    <label class="ls-sub-label" for="devices-tl-embryos">Embryos</label>
-                                    <input class="ls-number" id="devices-tl-embryos"
-                                           type="text" placeholder="all"
-                                           aria-label="Embryo IDs comma-separated (blank = all)">
-                                </div>
-
-                                <!-- Monitoring mode -->
-                                <div class="ls-sub-row">
-                                    <label class="ls-sub-label" for="devices-tl-mode">Mode</label>
-                                    <select id="devices-tl-mode" class="ls-laser-select"
-                                            aria-label="Monitoring mode">
-                                        <option value="">— none —</option>
-                                        <option value="idle">Idle (plain imaging)</option>
-                                        <option value="expression_monitoring">Expression monitoring</option>
-                                        <option value="pre_terminal_monitoring">Pre-terminal</option>
-                                    </select>
-                                </div>
-
-                                <!-- Volume geometry (sub-group) -->
-                                <div class="ls-sub-section">
-                                    <span class="ls-sub-section-label">Volume geometry</span>
-
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-slices">Slices</label>
-                                        <input class="ls-number ls-number-sm" id="devices-tl-slices"
-                                               type="number" min="1" max="500" step="1" value="50"
-                                               inputmode="numeric" aria-label="Number of slices">
-                                    </div>
-
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-exposure">Exposure</label>
-                                        <input class="ls-number ls-number-sm" id="devices-tl-exposure"
-                                               type="number" min="1" max="5000" step="1" value="10"
-                                               inputmode="numeric" aria-label="Exposure time in ms">
-                                        <span class="ls-unit">ms</span>
-                                    </div>
-
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-galvo-amp">Galvo amp</label>
-                                        <input class="ls-number ls-number-sm" id="devices-tl-galvo-amp"
-                                               type="number" min="0" max="5" step="0.05" value="0.5"
-                                               inputmode="decimal" aria-label="Galvo amplitude in degrees">
-                                        <span class="ls-unit">°</span>
-                                    </div>
-
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-galvo-ctr">Galvo ctr</label>
-                                        <input class="ls-number ls-number-sm" id="devices-tl-galvo-ctr"
-                                               type="number" min="-5" max="5" step="0.05" value="0"
-                                               inputmode="decimal" aria-label="Galvo center in degrees">
-                                        <span class="ls-unit">°</span>
-                                    </div>
-
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-piezo-amp">Piezo amp</label>
-                                        <input class="ls-number ls-number-sm" id="devices-tl-piezo-amp"
-                                               type="number" min="0" max="100" step="0.5" value="25"
-                                               inputmode="decimal" aria-label="Piezo amplitude in µm">
-                                        <span class="ls-unit">µm</span>
+                                <!-- ── Section 1: Schedule ───────────────────────── -->
+                                <div class="ls-acc-section" id="devices-tlacc-sched">
+                                    <button class="ls-acc-head" id="devices-tlacc-sched-head"
+                                            type="button" aria-expanded="true"
+                                            aria-controls="devices-tlacc-sched-body">
+                                        <span class="ls-acc-dot" aria-hidden="true"></span>
+                                        <span class="ls-acc-title">Schedule</span>
+                                        <span class="ls-acc-summary" id="devices-tlacc-sched-sum" hidden></span>
+                                        <span class="ls-acc-arrow" aria-hidden="true">▼</span>
+                                    </button>
+                                    <div class="ls-acc-body" id="devices-tlacc-sched-body">
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-interval">Interval</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-interval"
+                                                   type="number" min="1" step="1" value="120"
+                                                   inputmode="numeric" aria-label="Timelapse interval in seconds">
+                                            <span class="ls-unit">s</span>
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-stop">Stop when</label>
+                                            <select id="devices-tl-stop" class="ls-laser-select"
+                                                    aria-label="Timelapse stop condition">
+                                                <option value="manual" selected>Manual</option>
+                                                <option value="timepoints">Timepoints</option>
+                                                <option value="duration">Duration (h)</option>
+                                            </select>
+                                        </div>
+                                        <div class="ls-sub-row" id="devices-tl-cond-row" hidden>
+                                            <label class="ls-sub-label" for="devices-tl-cond-val" id="devices-tl-cond-label">Count</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-cond-val"
+                                                   type="number" min="1" step="1" value="10"
+                                                   inputmode="numeric" aria-label="Stop condition value">
+                                        </div>
                                     </div>
+                                </div>
 
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-piezo-ctr">Piezo ctr</label>
-                                        <input class="ls-number ls-number-sm" id="devices-tl-piezo-ctr"
-                                               type="number" min="0" max="200" step="0.5" value="50"
-                                               inputmode="decimal" aria-label="Piezo center in µm">
-                                        <span class="ls-unit">µm</span>
+                                <!-- ── Section 2: Targets ────────────────────────── -->
+                                <div class="ls-acc-section" id="devices-tlacc-targets">
+                                    <button class="ls-acc-head" id="devices-tlacc-targets-head"
+                                            type="button" aria-expanded="false"
+                                            aria-controls="devices-tlacc-targets-body">
+                                        <span class="ls-acc-dot" aria-hidden="true"></span>
+                                        <span class="ls-acc-title">Targets</span>
+                                        <span class="ls-acc-summary" id="devices-tlacc-targets-sum" hidden></span>
+                                        <span class="ls-acc-arrow" aria-hidden="true">▶</span>
+                                    </button>
+                                    <div class="ls-acc-body" id="devices-tlacc-targets-body" hidden>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-embryos">Embryos</label>
+                                            <input class="ls-number" id="devices-tl-embryos"
+                                                   type="text" placeholder="all"
+                                                   aria-label="Embryo IDs comma-separated (blank = all)">
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-mode">Mode</label>
+                                            <select id="devices-tl-mode" class="ls-laser-select"
+                                                    aria-label="Monitoring mode">
+                                                <option value="">— none —</option>
+                                                <option value="idle">Idle (plain imaging)</option>
+                                                <option value="expression_monitoring">Expression monitoring</option>
+                                                <option value="pre_terminal_monitoring">Pre-terminal</option>
+                                            </select>
+                                        </div>
                                     </div>
+                                </div>
 
-                                    <div class="ls-sub-row">
-                                        <label class="ls-sub-label" for="devices-tl-laser">Laser</label>
-                                        <select id="devices-tl-laser" class="ls-laser-select"
-                                                aria-label="Laser preset for timelapse">
-                                            <option value="ALL OFF">ALL OFF</option>
-                                        </select>
+                                <!-- ── Section 3: Volume geometry ────────────────── -->
+                                <div class="ls-acc-section" id="devices-tlacc-geom">
+                                    <button class="ls-acc-head" id="devices-tlacc-geom-head"
+                                            type="button" aria-expanded="false"
+                                            aria-controls="devices-tlacc-geom-body">
+                                        <span class="ls-acc-dot" aria-hidden="true"></span>
+                                        <span class="ls-acc-title">Volume geometry</span>
+                                        <span class="ls-acc-summary" id="devices-tlacc-geom-sum" hidden></span>
+                                        <span class="ls-acc-arrow" aria-hidden="true">▶</span>
+                                    </button>
+                                    <div class="ls-acc-body" id="devices-tlacc-geom-body" hidden>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-slices">Slices</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-slices"
+                                                   type="number" min="1" max="500" step="1" value="50"
+                                                   inputmode="numeric" aria-label="Number of slices">
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-exposure">Exposure</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-exposure"
+                                                   type="number" min="1" max="5000" step="1" value="10"
+                                                   inputmode="numeric" aria-label="Exposure time in ms">
+                                            <span class="ls-unit">ms</span>
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-galvo-amp">Galvo amp</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-galvo-amp"
+                                                   type="number" min="0" max="5" step="0.05" value="0.5"
+                                                   inputmode="decimal" aria-label="Galvo amplitude in degrees">
+                                            <span class="ls-unit">°</span>
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-galvo-ctr">Galvo ctr</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-galvo-ctr"
+                                                   type="number" min="-5" max="5" step="0.05" value="0"
+                                                   inputmode="decimal" aria-label="Galvo center in degrees">
+                                            <span class="ls-unit">°</span>
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-piezo-amp">Piezo amp</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-piezo-amp"
+                                                   type="number" min="0" max="100" step="0.5" value="25"
+                                                   inputmode="decimal" aria-label="Piezo amplitude in µm">
+                                            <span class="ls-unit">µm</span>
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-piezo-ctr">Piezo ctr</label>
+                                            <input class="ls-number ls-number-sm" id="devices-tl-piezo-ctr"
+                                                   type="number" min="0" max="200" step="0.5" value="50"
+                                                   inputmode="decimal" aria-label="Piezo center in µm">
+                                            <span class="ls-unit">µm</span>
+                                        </div>
+                                        <div class="ls-sub-row">
+                                            <label class="ls-sub-label" for="devices-tl-laser">Laser</label>
+                                            <select id="devices-tl-laser" class="ls-laser-select"
+                                                    aria-label="Laser preset for timelapse">
+                                                <option value="ALL OFF">ALL OFF</option>
+                                            </select>
+                                        </div>
                                     </div>
-                                </div><!-- /.ls-sub-section -->
+                                </div>
 
-                                <!-- Submit + status -->
-                                <div class="ls-sub-row">
-                                    <button class="ls-acquire-btn" id="devices-tl-start"
+                                <!-- ── Submit + status ───────────────────────────── -->
+                                <div class="ls-sub-row ls-tl-submit-row">
+                                    <button class="ls-acquire-btn ls-tl-start-btn" id="devices-tl-start"
                                             type="button">Start timelapse</button>
                                 </div>
                                 <div class="ls-tl-status" id="devices-tl-status" hidden>

From 29fa9e40cf9ff0d0fcb0d2de25bb21051999992b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 11:31:33 +0530
Subject: [PATCH 254/314] feat(gallery): top-level Gallery tab +
 volume-acquired confirmation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add Gallery to TABS constant (utils.js) and wire switchTab + hash
  routing in app.js; lazy-inits GalleryTab.init() on first visit
- Add Gallery nav button in the Library group (index.html) and the
  gallery-content tab panel with embryo/type filter selects
- Add GalleryTab controller in gallery.js: fetches /api/snapshots
  (which already includes volumes), sorts newest-first, renders a
  responsive thumbnail grid grouped by embryo/type filters; clicking
  opens existing Lightbox
- Add showGentlyToast() in gallery.js: fixed bottom-center toast with
  optional action button and auto-dismiss after 6 s
- Show "Volume acquired / View in Gallery" toast in devices.js after
  successful Snap Volume or Burst — no inline preview to keep manual
  mode uncluttered; "View in Gallery" calls switchTab(TABS.GALLERY)
- Add gallery tab + toast CSS to main.css (gallery-tab-container grid,
  gently-toast styles); reuses --accent/--bg-card/--border vars
---
 gently/ui/web/static/css/main.css  | 252 +++++++++++++++++++++++++++++
 gently/ui/web/static/js/app.js     |   7 +-
 gently/ui/web/static/js/devices.js |   9 ++
 gently/ui/web/static/js/gallery.js | 170 +++++++++++++++++++
 gently/ui/web/static/js/utils.js   |   2 +-
 gently/ui/web/templates/index.html |  25 +++
 6 files changed, 463 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 7e04b232..d7b51a37 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -11069,3 +11069,255 @@ body.modal-open {
 .ls-tl-submit-row {
     margin-top: 0.3rem;
 }
+
+/* ==========================================
+   Gallery Tab
+   ========================================== */
+
+.gallery-tab-container {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    overflow: hidden;
+    padding: 1.25rem 1.5rem 0;
+    box-sizing: border-box;
+}
+
+.gallery-tab-header {
+    display: flex;
+    align-items: center;
+    gap: 1rem;
+    margin-bottom: 1rem;
+    flex-shrink: 0;
+}
+
+.gallery-tab-title {
+    font-size: 1.35rem;
+    font-weight: 300;
+    letter-spacing: -0.01em;
+    color: var(--text);
+    margin: 0;
+    line-height: 1.2;
+    flex-shrink: 0;
+}
+
+.gallery-tab-title-script {
+    font-family: 'Georgia', serif;
+    font-style: italic;
+    color: var(--text-muted);
+}
+
+.gallery-tab-title-em {
+    font-style: normal;
+    font-weight: 500;
+    color: var(--accent);
+}
+
+.gallery-tab-controls {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin-left: auto;
+}
+
+.gallery-filter-select {
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    color: var(--text);
+    font-size: 0.8rem;
+    padding: 0.3rem 0.6rem;
+    cursor: pointer;
+    transition: border-color 0.15s;
+}
+
+.gallery-filter-select:hover,
+.gallery-filter-select:focus {
+    border-color: var(--accent);
+    outline: none;
+}
+
+.gallery-refresh-btn {
+    background: transparent;
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    color: var(--text-muted);
+    font-size: 1rem;
+    width: 2rem;
+    height: 2rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    transition: color 0.15s, border-color 0.15s;
+}
+
+.gallery-refresh-btn:hover {
+    color: var(--accent);
+    border-color: var(--accent);
+}
+
+.gallery-tab-body {
+    flex: 1;
+    overflow-y: auto;
+    padding-bottom: 1.5rem;
+}
+
+.gallery-tab-empty,
+.gallery-tab-loading,
+.gallery-tab-error {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    height: 200px;
+    color: var(--text-muted);
+    font-size: 0.9rem;
+}
+
+.gallery-tab-error {
+    color: var(--accent-red, #ef4444);
+}
+
+.gallery-tab-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
+    gap: 0.75rem;
+}
+
+.gallery-tab-item {
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    overflow: hidden;
+    cursor: pointer;
+    transition: border-color 0.15s, transform 0.15s, box-shadow 0.15s;
+}
+
+.gallery-tab-item:hover {
+    border-color: var(--accent);
+    transform: translateY(-2px);
+    box-shadow: 0 4px 16px rgba(0, 0, 0, 0.25);
+}
+
+.gallery-tab-thumb {
+    display: block;
+    width: 100%;
+    aspect-ratio: 1;
+    object-fit: contain;
+    background: var(--bg-dark);
+}
+
+.gallery-tab-thumb-placeholder {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 100%;
+    aspect-ratio: 1;
+    background: var(--bg-dark);
+    color: var(--text-muted);
+    font-size: 0.7rem;
+    text-align: center;
+    padding: 0.5rem;
+    box-sizing: border-box;
+}
+
+.gallery-tab-item-info {
+    padding: 0.4rem 0.5rem 0.45rem;
+    border-top: 1px solid var(--border);
+}
+
+.gallery-tab-item-type {
+    font-size: 0.72rem;
+    font-weight: 600;
+    color: var(--accent);
+    text-transform: lowercase;
+    letter-spacing: 0.02em;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.gallery-tab-item-embryo {
+    font-size: 0.68rem;
+    color: var(--text-muted);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    margin-top: 0.1rem;
+}
+
+.gallery-tab-item-ts {
+    font-size: 0.62rem;
+    color: var(--text-muted);
+    opacity: 0.65;
+    margin-top: 0.1rem;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+/* ==========================================
+   Gently Toast — volume acquired / burst acquired
+   ========================================== */
+
+.gently-toast {
+    position: fixed;
+    bottom: 24px;
+    left: 50%;
+    transform: translateX(-50%) translateY(20px);
+    background: var(--bg-card);
+    border: 1px solid var(--accent-green);
+    border-radius: 10px;
+    padding: 0.6rem 1rem 0.6rem 1.1rem;
+    display: flex;
+    align-items: center;
+    gap: 0.65rem;
+    z-index: 10010;
+    box-shadow: 0 4px 20px rgba(0, 0, 0, 0.35);
+    opacity: 0;
+    transition: opacity 0.25s ease, transform 0.25s ease;
+    pointer-events: auto;
+}
+
+.gently-toast.visible {
+    opacity: 1;
+    transform: translateX(-50%) translateY(0);
+}
+
+.gently-toast-msg {
+    font-size: 0.85rem;
+    font-weight: 500;
+    color: var(--text);
+    white-space: nowrap;
+}
+
+.gently-toast-action {
+    background: transparent;
+    border: 1px solid var(--accent);
+    border-radius: 5px;
+    color: var(--accent);
+    font-size: 0.78rem;
+    padding: 0.2rem 0.55rem;
+    cursor: pointer;
+    transition: background 0.15s, color 0.15s;
+    white-space: nowrap;
+}
+
+.gently-toast-action:hover {
+    background: var(--accent);
+    color: var(--bg-dark);
+}
+
+.gently-toast-dismiss {
+    background: transparent;
+    border: none;
+    color: var(--text-muted);
+    font-size: 1.1rem;
+    line-height: 1;
+    cursor: pointer;
+    padding: 0 0.1rem;
+    opacity: 0.7;
+    transition: opacity 0.15s;
+    margin-left: 0.2rem;
+}
+}
diff --git a/gently/ui/web/static/js/app.js b/gently/ui/web/static/js/app.js
index 41bad885..6f51da38 100644
--- a/gently/ui/web/static/js/app.js
+++ b/gently/ui/web/static/js/app.js
@@ -105,6 +105,11 @@ function switchTab(tabName) {
         NotebookApp.init();
     }
 
+    // Lazy-init Gallery tab
+    if (tabName === TABS.GALLERY && typeof GalleryTab !== 'undefined') {
+        GalleryTab.init();
+    }
+
     // Update statusbar for context
     updateStatusbar();
 }
@@ -656,7 +661,7 @@ document.addEventListener('DOMContentLoaded', () => {
     const hash = window.location.hash.slice(1); // remove #
     if (hash) {
         const [tab, param] = hash.split(':');
-        if (tab === TABS.HOME || tab === TABS.PLANS || tab === TABS.SESSIONS || tab === TABS.EMBRYOS || tab === TABS.CALIBRATION || tab === TABS.EVENTS || tab === TABS.EXPERIMENT || tab === TABS.NOTEBOOK) {
+        if (tab === TABS.HOME || tab === TABS.PLANS || tab === TABS.SESSIONS || tab === TABS.EMBRYOS || tab === TABS.CALIBRATION || tab === TABS.EVENTS || tab === TABS.EXPERIMENT || tab === TABS.NOTEBOOK || tab === TABS.GALLERY) {
             switchTab(tab);
             if (tab === TABS.PLANS && param && typeof openCampaign === 'function') {
                 setTimeout(() => openCampaign(param), 200);
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 67f8ca5d..8c1c8733 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -2066,6 +2066,15 @@ const DevicesManager = (function () {
             if (_lsLastcapRef) {
                 _lsLastcapRef.textContent = data.volume_path || data.path || data.id || 'done';
             }
+            // Show confirmation toast — no inline preview to keep manual mode uncluttered
+            if (typeof showGentlyToast === 'function') {
+                const label = mode === 'burst' ? 'Burst acquired' : 'Volume acquired';
+                showGentlyToast(label, 'View in Gallery', () => {
+                    if (typeof switchTab === 'function' && typeof TABS !== 'undefined') {
+                        switchTab(TABS.GALLERY);
+                    }
+                });
+            }
         } catch (err) {
             console.error('acquire error:', err);
         } finally {
diff --git a/gently/ui/web/static/js/gallery.js b/gently/ui/web/static/js/gallery.js
index 42159d18..259e6636 100644
--- a/gently/ui/web/static/js/gallery.js
+++ b/gently/ui/web/static/js/gallery.js
@@ -1631,3 +1631,173 @@ function filterByEmbryo(list) {
     if (!state.embryoFilter) return list;
     return list.filter(img => img.metadata?.embryo_id === state.embryoFilter);
 }
+
+// ==========================================
+// GalleryTab — top-level Gallery tab controller
+// ==========================================
+
+const GalleryTab = {
+    _allItems: [],
+    _embryoFilter: '',
+    _typeFilter: '',
+
+    async init() {
+        const panel = document.getElementById('gallery-tab-body');
+        if (!panel) return;
+
+        // Wire filter controls (idempotent)
+        const embryoSel = document.getElementById('gallery-embryo-filter');
+        const typeSel   = document.getElementById('gallery-type-filter');
+        const refreshBtn = document.getElementById('gallery-refresh-btn');
+        if (embryoSel && !embryoSel._gtWired) {
+            embryoSel._gtWired = true;
+            embryoSel.addEventListener('change', () => {
+                this._embryoFilter = embryoSel.value;
+                this._renderGrid();
+            });
+        }
+        if (typeSel && !typeSel._gtWired) {
+            typeSel._gtWired = true;
+            typeSel.addEventListener('change', () => {
+                this._typeFilter = typeSel.value;
+                this._renderGrid();
+            });
+        }
+        if (refreshBtn && !refreshBtn._gtWired) {
+            refreshBtn._gtWired = true;
+            refreshBtn.addEventListener('click', () => this._load());
+        }
+
+        await this._load();
+    },
+
+    async _load() {
+        const panel = document.getElementById('gallery-tab-body');
+        if (!panel) return;
+        panel.innerHTML = '<div class="gallery-tab-loading">Loading…</div>';
+        try {
+            const data = await fetch('/api/snapshots').then(r => r.json());
+            const items = data.snapshots || [];
+            // Sort newest first
+            items.sort((a, b) => (b.timestamp || '').localeCompare(a.timestamp || ''));
+            this._allItems = items;
+            this._populateEmbroyFilter(items);
+            this._renderGrid();
+        } catch (err) {
+            panel.innerHTML = '<div class="gallery-tab-error">Failed to load gallery — check connection.</div>';
+        }
+    },
+
+    _populateEmbroyFilter(items) {
+        const sel = document.getElementById('gallery-embryo-filter');
+        if (!sel) return;
+        const embryos = [...new Set(items.map(i => i.metadata?.embryo_id).filter(Boolean))].sort();
+        const cur = sel.value;
+        // Rebuild options beyond the "All embryos" placeholder
+        while (sel.options.length > 1) sel.remove(1);
+        embryos.forEach(eid => {
+            const opt = document.createElement('option');
+            opt.value = eid;
+            opt.textContent = eid;
+            sel.appendChild(opt);
+        });
+        if (cur && embryos.includes(cur)) sel.value = cur;
+    },
+
+    _renderGrid() {
+        const panel = document.getElementById('gallery-tab-body');
+        if (!panel) return;
+
+        let items = this._allItems;
+        if (this._embryoFilter) {
+            items = items.filter(i => (i.metadata?.embryo_id || '') === this._embryoFilter);
+        }
+        if (this._typeFilter) {
+            items = items.filter(i => i.data_type === this._typeFilter);
+        }
+
+        if (items.length === 0) {
+            panel.innerHTML = '<div class="gallery-tab-empty">No images match the current filter.</div>';
+            return;
+        }
+
+        const html = `<div class="gallery-tab-grid">${items.map((img, idx) => this._itemHtml(img, idx)).join('')}</div>`;
+        panel.innerHTML = html;
+
+        // Wire click handlers
+        panel.querySelectorAll('.gallery-tab-item').forEach(el => {
+            el.addEventListener('click', () => {
+                const idx = parseInt(el.dataset.idx, 10);
+                Lightbox.open(items, idx, 'gallery');
+            });
+        });
+    },
+
+    _itemHtml(img, idx) {
+        const embryo = img.metadata?.embryo_id || '';
+        const ts = img.timestamp ? img.timestamp.slice(0, 19).replace('T', ' ') : '';
+        const typeLabel = img.data_type || 'image';
+        const thumb = img.base64_png
+            ? `<img class="gallery-tab-thumb" src="data:image/png;base64,${img.base64_png}" alt="${typeLabel}">`
+            : `<div class="gallery-tab-thumb-placeholder">${typeLabel}</div>`;
+        return `
+            <div class="gallery-tab-item" data-idx="${idx}" title="${typeLabel}${embryo ? ' · ' + embryo : ''}">
+                ${thumb}
+                <div class="gallery-tab-item-info">
+                    <div class="gallery-tab-item-type">${typeLabel}</div>
+                    ${embryo ? `<div class="gallery-tab-item-embryo">${embryo}</div>` : ''}
+                    ${ts ? `<div class="gallery-tab-item-ts">${ts}</div>` : ''}
+                </div>
+            </div>
+        `;
+    },
+};
+
+// ==========================================
+// showGentlyToast — lightweight global toast (volume acquired, etc.)
+// ==========================================
+
+/**
+ * Show a brief toast notification with an optional action link.
+ * @param {string} message - Primary message text
+ * @param {string|null} actionLabel - Label for the action button (null = no button)
+ * @param {Function|null} actionFn - Callback invoked when the action is clicked
+ * @param {number} [duration=6000] - Auto-dismiss delay in ms
+ */
+function showGentlyToast(message, actionLabel, actionFn, duration = 6000) {
+    // Remove any existing gently-toast
+    document.querySelectorAll('.gently-toast').forEach(t => t.remove());
+
+    const toast = document.createElement('div');
+    toast.className = 'gently-toast';
+
+    const msgSpan = document.createElement('span');
+    msgSpan.className = 'gently-toast-msg';
+    msgSpan.textContent = message;
+    toast.appendChild(msgSpan);
+
+    if (actionLabel && actionFn) {
+        const actionBtn = document.createElement('button');
+        actionBtn.className = 'gently-toast-action';
+        actionBtn.textContent = actionLabel;
+        actionBtn.addEventListener('click', () => {
+            actionFn();
+            toast.remove();
+        });
+        toast.appendChild(actionBtn);
+    }
+
+    const dismiss = document.createElement('button');
+    dismiss.className = 'gently-toast-dismiss';
+    dismiss.setAttribute('aria-label', 'Dismiss');
+    dismiss.textContent = '×';
+    dismiss.addEventListener('click', () => toast.remove());
+    toast.appendChild(dismiss);
+
+    document.body.appendChild(toast);
+    // Trigger transition
+    requestAnimationFrame(() => toast.classList.add('visible'));
+
+    const timer = setTimeout(() => toast.remove(), duration);
+    dismiss.addEventListener('click', () => clearTimeout(timer));
+}
diff --git a/gently/ui/web/static/js/utils.js b/gently/ui/web/static/js/utils.js
index b321506c..abf2dee0 100644
--- a/gently/ui/web/static/js/utils.js
+++ b/gently/ui/web/static/js/utils.js
@@ -3,7 +3,7 @@
 // ══════════════════════════════════════════════════════════
 
 // Tab and view name constants
-const TABS = { HOME: 'home', EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment', NOTEBOOK: 'notebook' };
+const TABS = { HOME: 'home', EMBRYOS: 'embryos', CALIBRATION: 'calibration', EVENTS: 'events', PLANS: 'plans', SESSIONS: 'sessions', DEVICES: 'devices', EXPERIMENT: 'experiment', NOTEBOOK: 'notebook', GALLERY: 'gallery' };
 
 /**
  * Extract the XY firmware fence (the addressable stage box) from a device-state
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index b069c156..109d3be8 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -124,6 +124,7 @@ <h3>Take a quick look</h3>
           <button class="v2-nav-item" data-tab="plans">Plans</button>
           <button class="v2-nav-item" data-tab="sessions">Sessions</button>
           <button class="v2-nav-item" data-tab="notebook">Notebook</button>
+          <button class="v2-nav-item" data-tab="gallery">Gallery</button>
         </div>
         <div class="v2-nav-group">
           <div class="v2-nav-label">System</div>
@@ -1006,6 +1007,30 @@ <h3 class="devices-properties-title">Properties</h3>
         </div>
     </div>
 
+    <!-- Gallery Tab -->
+    <div id="gallery-content" class="tab-content">
+        <div class="gallery-tab-container">
+            <div class="gallery-tab-header">
+                <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</span> <em class="gallery-tab-title-em">images</em></h2>
+                <div class="gallery-tab-controls">
+                    <select id="gallery-embryo-filter" class="gallery-filter-select">
+                        <option value="">All embryos</option>
+                    </select>
+                    <select id="gallery-type-filter" class="gallery-filter-select">
+                        <option value="">All types</option>
+                        <option value="volume">Volume</option>
+                        <option value="volume_projection">Projection</option>
+                        <option value="snapshot">Snapshot</option>
+                    </select>
+                    <button id="gallery-refresh-btn" class="gallery-refresh-btn" title="Refresh">&#x21BB;</button>
+                </div>
+            </div>
+            <div class="gallery-tab-body" id="gallery-tab-body">
+                <div class="gallery-tab-empty">No images yet — snap a volume or take a snapshot to see it here.</div>
+            </div>
+        </div>
+    </div>
+
     <footer class="statusbar" id="statusbar">
         <span id="status-left"></span>
         <span id="status-right"></span>

From 020feacbac8e87b724b9374733b9665e63e255d3 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 11:38:44 +0530
Subject: [PATCH 255/314] feat(operations): set-up-an-operation CTA in the idle
 state (agent-first + quick-start chips)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace the bare "No operation running" empty state with a call-to-action panel:
primary "Brief the agent" button opens the agent panel; three quick-start chips
(temperature-strain run, standing timelapse, watch for hatching) open the agent
pre-populated with a specific intent via AgentChat.togglePanel + runCommand.
CTA is idle-only — the populated tactic spine is unchanged.
---
 gently/ui/web/static/css/experiment.css       | 56 +++++++++++++++++++
 .../ui/web/static/js/experiment-overview.js   | 24 +++++++-
 2 files changed, 78 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 099b584b..770be5a7 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -709,6 +709,62 @@
     margin-top: 18px;
 }
 
+/* ---- Idle CTA — "set up an operation" ---------------------- */
+
+.ops-setup-cta {
+    margin-top: 28px;
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 16px;
+}
+
+.ops-brief-btn {
+    background: var(--ops-plan, #5aa9e6);
+    color: #05101e;
+    border: none;
+    border-radius: 8px;
+    padding: 10px 22px;
+    font: inherit;
+    font-weight: 700;
+    font-size: 14px;
+    letter-spacing: 0.01em;
+    cursor: pointer;
+    transition: opacity 0.15s;
+}
+.ops-brief-btn:hover { opacity: 0.85; }
+
+.ops-chips-label {
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    letter-spacing: 0.1em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+}
+
+.ops-chips {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 8px;
+}
+
+.ops-chip {
+    background: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border, #30363d);
+    border-radius: 20px;
+    padding: 6px 14px;
+    font: inherit;
+    font-family: var(--ops-mono);
+    font-size: 12px;
+    cursor: pointer;
+    transition: color 0.15s, border-color 0.15s;
+}
+.ops-chip:hover {
+    color: var(--text, #e6edf3);
+    border-color: var(--ops-plan, #5aa9e6);
+}
+
 /* ---- Spine ------------------------------------------------- */
 
 .ops-spine {
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index ce59a4a8..5d7fb958 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -599,9 +599,29 @@ const ExperimentOverview = {
                 <div class="ops-wrap">
                     <div class="ops-crumb">Operations</div>
                     <h1 class="ops-title">No operation running</h1>
-                    <div class="ops-meta">When the agent begins operating by tactic, the plan and live progress appear here.</div>
-                    <div class="ops-empty">Idle — no tactics planned or in use.</div>
+                    <div class="ops-meta">Brief the agent — it will declare a tactic plan and the spine renders live.</div>
+                    <div class="ops-setup-cta">
+                        <button class="ops-brief-btn" data-ops-brief>Brief the agent</button>
+                        <div class="ops-chips-label">— or start from a template</div>
+                        <div class="ops-chips">
+                            <button class="ops-chip" data-ops-prompt="Set up a temperature-strain operation: baseline monitoring, a temperature-change protocol on the test subjects, then recovery monitoring.">Temperature-strain run</button>
+                            <button class="ops-chip" data-ops-prompt="Set up a standing timelapse on all embryos at 120 s cadence.">Standing timelapse</button>
+                            <button class="ops-chip" data-ops-prompt="Arm a reactive monitor that watches for hatching on the most advanced embryos.">Watch for hatching</button>
+                        </div>
+                    </div>
                 </div>`;
+
+            // Wire CTA buttons — same open+send pattern as landing.js sendFreeform.
+            function _opsOpenAgent(prompt) {
+                if (typeof AgentChat === 'undefined' || !AgentChat.togglePanel) return;
+                AgentChat.togglePanel(true);
+                if (prompt && AgentChat.runCommand) setTimeout(() => AgentChat.runCommand(prompt), 300);
+            }
+            const briefBtn = root.querySelector('[data-ops-brief]');
+            if (briefBtn) briefBtn.addEventListener('click', () => _opsOpenAgent(''));
+            root.querySelectorAll('[data-ops-prompt]').forEach(chip => {
+                chip.addEventListener('click', () => _opsOpenAgent(chip.dataset.opsPrompt));
+            });
             return;
         }
 

From 537f4145574a788c5533869a5740c948631e49b2 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 12:55:07 +0530
Subject: [PATCH 256/314] =?UTF-8?q?style:=20ruff=20check=20+=20format=20?=
 =?UTF-8?q?=E2=80=94=20lint=20clean?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/app/agent.py                           |   5 +-
 gently/app/operation_plan_updater.py          |   5 +-
 gently/app/orchestration/role_scope.py        |   4 +-
 .../app/orchestration/temperature_protocol.py |  92 +++++++++++----
 gently/app/temperature_sampler.py             |   3 +-
 gently/app/tools/acquisition_tools.py         |   5 +-
 gently/app/tools/operation_plan_seed.py       |   4 +-
 gently/app/tools/tactic_library_tools.py      |   4 +-
 .../app/tools/temperature_protocol_tools.py   |  13 ++-
 gently/core/event_bus.py                      |   4 +-
 gently/core/file_store.py                     |   7 +-
 gently/hardware/dispim/device_factory.py      |   2 +-
 gently/hardware/dispim/device_layer.py        |  14 ++-
 gently/ui/web/routes/__init__.py              |   8 +-
 gently/ui/web/routes/data.py                  |  17 ++-
 gently/ui/web/routes/operation_plan.py        |   4 +-
 gently/ui/web/routes/temperature.py           |   1 +
 tests/test_burst_laser_config.py              |   3 +-
 tests/test_burst_phase_snapshot.py            |   5 +-
 tests/test_dual_camera_factory.py             |   1 +
 tests/test_embryo_strain.py                   |   2 -
 tests/test_laser_preset_route.py              |   9 +-
 tests/test_lightsheet_buffer.py               |   7 +-
 tests/test_lightsheet_client.py               |   2 +-
 tests/test_lightsheet_event.py                |   2 +-
 tests/test_lightsheet_monitor.py              |   3 +-
 tests/test_lightsheet_routes.py               |  57 ++++++---
 tests/test_lightsheet_side_param.py           |   2 +-
 tests/test_lightsheet_streamer.py             | 101 +++++++++++-----
 tests/test_operation_plan_route.py            |   1 -
 tests/test_operation_plan_seeding.py          |  17 ++-
 tests/test_operation_plan_store.py            |   5 +-
 tests/test_operation_plan_tool.py             |   5 +-
 tests/test_operation_plan_updater.py          |  44 +++----
 tests/test_plan_item_tactics.py               |   4 +-
 tests/test_role_scope.py                      |   4 +-
 tests/test_roles_registry.py                  |   5 +-
 tests/test_roles_route.py                     |  10 +-
 tests/test_session_plan_linking_routes.py     |   1 -
 tests/test_session_plan_linking_store.py      |   3 +-
 tests/test_tactic_library_store.py            |   2 -
 tests/test_tactic_library_tools.py            |  15 ++-
 tests/test_temp_protocol_driver.py            |  65 ++++++++---
 tests/test_temp_protocol_events.py            |   1 +
 tests/test_temp_protocol_snapshot.py          |   4 +-
 tests/test_temp_protocol_tool.py              |  13 ++-
 tests/test_temperature_event.py               |   4 +-
 tests/test_temperature_route.py               |  25 +++-
 tests/test_temperature_sampler.py             |  25 ++--
 tests/test_temperature_sampler_wiring.py      |   9 +-
 tests/test_temperature_stamp.py               |   8 +-
 tests/test_temperature_store.py               |  33 ++++--
 tests/test_timelapse_start_route.py           |  13 ++-
 tests/test_tool_tactic_linkage.py             | 108 ++++++++++++------
 tests/test_transition_tactic.py               |   3 +-
 tests/test_wait_for_lock.py                   |  11 +-
 56 files changed, 537 insertions(+), 287 deletions(-)

diff --git a/gently/app/agent.py b/gently/app/agent.py
index 47b2421d..3aa4989d 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -474,6 +474,7 @@ def exit_plan_mode(self) -> str:
                     from gently.app.tools.operation_plan_seed import (
                         seed_operation_plan_from_plan_item,
                     )
+
                     seed_operation_plan_from_plan_item(self.context_store, self.session_id)
                 except Exception:
                     logger.exception("operation-plan seeding failed")
@@ -650,9 +651,7 @@ def _init_timelapse_orchestrator(self):
                 store=self.store,
                 claude_client=self.claude,
                 temperature_provider=lambda: (
-                    self.temperature_sampler.latest
-                    if self.temperature_sampler
-                    else None
+                    self.temperature_sampler.latest if self.temperature_sampler else None
                 ),
             )
         except Exception as e:
diff --git a/gently/app/operation_plan_updater.py b/gently/app/operation_plan_updater.py
index d2e2b9e4..738fe10c 100644
--- a/gently/app/operation_plan_updater.py
+++ b/gently/app/operation_plan_updater.py
@@ -12,13 +12,14 @@
 `tactic_id` or session → skip.  Handler exceptions are caught so a bad event
 never crashes the bus.
 """
+
 from __future__ import annotations
 
 import logging
-from typing import Callable
+from collections.abc import Callable
 
+from gently.core.event_bus import EventType, get_event_bus
 from gently.core.service import Service
-from gently.core.event_bus import get_event_bus, EventType
 
 logger = logging.getLogger(__name__)
 
diff --git a/gently/app/orchestration/role_scope.py b/gently/app/orchestration/role_scope.py
index b36bd89e..66c9b9d5 100644
--- a/gently/app/orchestration/role_scope.py
+++ b/gently/app/orchestration/role_scope.py
@@ -52,9 +52,7 @@ def resolve_scope_embryos(scope: dict | None, embryos: list[dict]) -> list[str]:
     if mode == "role":
         target_role = scope.get("role")
         return [
-            e["embryo_id"]
-            for e in embryos
-            if "embryo_id" in e and e.get("role") == target_role
+            e["embryo_id"] for e in embryos if "embryo_id" in e and e.get("role") == target_role
         ]
 
     return []
diff --git a/gently/app/orchestration/temperature_protocol.py b/gently/app/orchestration/temperature_protocol.py
index 115234f2..e25ee148 100644
--- a/gently/app/orchestration/temperature_protocol.py
+++ b/gently/app/orchestration/temperature_protocol.py
@@ -1,8 +1,12 @@
-import asyncio, logging
+import asyncio
+import logging
+
 from gently.app.orchestration.exclusive import BurstAcquisition
 from gently.core.event_bus import EventType
+
 logger = logging.getLogger(__name__)
 
+
 async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.0) -> bool:
     """Poll the controller until it reports a locked state, or timeout. Substring 'LOCKED'."""
     loop = asyncio.get_event_loop()
@@ -11,7 +15,8 @@ async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.
         try:
             resp = await client.get_temperature()
         except Exception as exc:
-            logger.warning("wait_for_temperature_lock poll failed: %s", exc); resp = {}
+            logger.warning("wait_for_temperature_lock poll failed: %s", exc)
+            resp = {}
         if "LOCKED" in str(resp.get("state", "")):
             return True
         if loop.time() - t0 >= timeout_s:
@@ -19,35 +24,66 @@ async def wait_for_temperature_lock(client, timeout_s: float, poll_s: float = 2.
         await asyncio.sleep(poll_s)
 
 
-async def run_temp_change_burst_protocol(orchestrator, embryo_id, target_setpoint_c, *,
-        frames=60, mode="1hz", num_slices=1, bursts_before=1, bursts_after=1,
-        lock_timeout_s=600.0, poll_s=2.0, burst_runner=None, tactic_id=None):
+async def run_temp_change_burst_protocol(
+    orchestrator,
+    embryo_id,
+    target_setpoint_c,
+    *,
+    frames=60,
+    mode="1hz",
+    num_slices=1,
+    bursts_before=1,
+    bursts_after=1,
+    lock_timeout_s=600.0,
+    poll_s=2.0,
+    burst_runner=None,
+    tactic_id=None,
+):
     """Scripted temp-change burst protocol: brightfield before/during/after a setpoint change."""
     client = orchestrator.client
     if burst_runner is None:
-        async def burst_runner(b): await b.run(orchestrator)
+
+        async def burst_runner(b):
+            await b.run(orchestrator)
 
     async def one_burst(phase):
-        b = BurstAcquisition(embryo_id, frames=frames, mode=mode, num_slices=num_slices,
-                             temperature_provider=getattr(orchestrator, "_temperature_provider", None),
-                             laser_config="ALL OFF")
+        b = BurstAcquisition(
+            embryo_id,
+            frames=frames,
+            mode=mode,
+            num_slices=num_slices,
+            temperature_provider=getattr(orchestrator, "_temperature_provider", None),
+            laser_config="ALL OFF",
+        )
         b._phase = phase
         await burst_runner(b)
 
-    locked = False; error = None; cancelled = False
+    locked = False
+    error = None
+    cancelled = False
     try:
         await client.set_laser_config("ALL OFF")
         await client.set_led("Open")
-        orchestrator._emit_event(EventType.TEMP_PROTOCOL_STARTED,
-            {"embryo_id": embryo_id, "target_setpoint_c": target_setpoint_c,
-             "frames": frames, "bursts_before": bursts_before, "bursts_after": bursts_after,
-             "tactic_id": tactic_id})
+        orchestrator._emit_event(
+            EventType.TEMP_PROTOCOL_STARTED,
+            {
+                "embryo_id": embryo_id,
+                "target_setpoint_c": target_setpoint_c,
+                "frames": frames,
+                "bursts_before": bursts_before,
+                "bursts_after": bursts_after,
+                "tactic_id": tactic_id,
+            },
+        )
         for _ in range(bursts_before):
             await one_burst("before")
         await client.set_temperature(target_setpoint_c)
-        orchestrator._emit_event(EventType.TEMPERATURE_SETPOINT_CHANGED,
-            {"embryo_id": embryo_id, "to": target_setpoint_c})
-        loop = asyncio.get_event_loop(); t0 = loop.time()
+        orchestrator._emit_event(
+            EventType.TEMPERATURE_SETPOINT_CHANGED,
+            {"embryo_id": embryo_id, "to": target_setpoint_c},
+        )
+        loop = asyncio.get_event_loop()
+        t0 = loop.time()
         while True:
             await one_burst("during")
             try:
@@ -55,17 +91,27 @@ async def one_burst(phase):
             except Exception:
                 st = ""
             if "LOCKED" in st:
-                locked = True; break
+                locked = True
+                break
             if loop.time() - t0 >= lock_timeout_s:
                 break
         for _ in range(bursts_after):
             await one_burst("after")
     except asyncio.CancelledError:
-        cancelled = True; raise
+        cancelled = True
+        raise
     except Exception as exc:
-        error = str(exc); logger.exception("temp-change burst protocol failed")
+        error = str(exc)
+        logger.exception("temp-change burst protocol failed")
     finally:
-        orchestrator._emit_event(EventType.TEMP_PROTOCOL_COMPLETED,
-            {"embryo_id": embryo_id, "locked": locked, "cancelled": cancelled, "error": error,
-             "tactic_id": tactic_id})
+        orchestrator._emit_event(
+            EventType.TEMP_PROTOCOL_COMPLETED,
+            {
+                "embryo_id": embryo_id,
+                "locked": locked,
+                "cancelled": cancelled,
+                "error": error,
+                "tactic_id": tactic_id,
+            },
+        )
     return {"locked": locked, "cancelled": cancelled, "error": error}
diff --git a/gently/app/temperature_sampler.py b/gently/app/temperature_sampler.py
index e762534c..0995d1f2 100644
--- a/gently/app/temperature_sampler.py
+++ b/gently/app/temperature_sampler.py
@@ -6,14 +6,15 @@
 and publishes TEMPERATURE_UPDATE for the live graph. A failed poll is a gap, not a
 crash; with no active session the loop idles.
 """
+
 from __future__ import annotations
 
 import asyncio
 import logging
 from datetime import datetime, timezone
 
+from gently.core.event_bus import EventType, get_event_bus
 from gently.core.service import Service
-from gently.core.event_bus import get_event_bus, EventType
 
 logger = logging.getLogger(__name__)
 
diff --git a/gently/app/tools/acquisition_tools.py b/gently/app/tools/acquisition_tools.py
index 6e029ad4..bfc892ea 100644
--- a/gently/app/tools/acquisition_tools.py
+++ b/gently/app/tools/acquisition_tools.py
@@ -213,10 +213,9 @@ async def acquire_volume(
                         },
                     }
                     from gently.app.temperature_sampler import temperature_stamp as _ts
+
                     _temp_stamp = _ts(
-                        getattr(
-                            getattr(agent, "temperature_sampler", None), "latest", None
-                        )
+                        getattr(getattr(agent, "temperature_sampler", None), "latest", None)
                     )
                     if _temp_stamp is not None:
                         acq_metadata["temperature"] = _temp_stamp
diff --git a/gently/app/tools/operation_plan_seed.py b/gently/app/tools/operation_plan_seed.py
index 3878e704..3bf0caa1 100644
--- a/gently/app/tools/operation_plan_seed.py
+++ b/gently/app/tools/operation_plan_seed.py
@@ -50,9 +50,7 @@ def _resolve_plan_item_with_tactics(context_store, session_id: str):
         items = context_store.get_plan_items(campaign_id=cid)
         for item in items:
             # Match items that list this session
-            session_ids = item.session_ids or (
-                [item.session_id] if item.session_id else []
-            )
+            session_ids = item.session_ids or ([item.session_id] if item.session_id else [])
             if session_id not in session_ids and item.session_id != session_id:
                 continue
             # Must carry an imaging_spec with at least one tactic outline entry
diff --git a/gently/app/tools/tactic_library_tools.py b/gently/app/tools/tactic_library_tools.py
index 96a3eee5..78b141d5 100644
--- a/gently/app/tools/tactic_library_tools.py
+++ b/gently/app/tools/tactic_library_tools.py
@@ -124,7 +124,9 @@ async def list_tactics(
 
     lines = [f"Tactic Library ({len(tactics)} template{'s' if len(tactics) != 1 else ''}):"]
     for t in tactics:
-        lines.append(f"  [{t.get('id', '?')}] {t.get('name', '(unnamed)')} — kind: {t.get('kind', '?')}")
+        lines.append(
+            f"  [{t.get('id', '?')}] {t.get('name', '(unnamed)')} — kind: {t.get('kind', '?')}"
+        )
     return "\n".join(lines)
 
 
diff --git a/gently/app/tools/temperature_protocol_tools.py b/gently/app/tools/temperature_protocol_tools.py
index 3e79055f..80d6166a 100644
--- a/gently/app/tools/temperature_protocol_tools.py
+++ b/gently/app/tools/temperature_protocol_tools.py
@@ -8,7 +8,11 @@
 
 import asyncio
 
-from gently.harness.tools.helpers import ctx_get, require_agent, require_microscope, require_timelapse_orchestrator
+from gently.harness.tools.helpers import (
+    require_agent,
+    require_microscope,
+    require_timelapse_orchestrator,
+)
 from gently.harness.tools.registry import ToolCategory, ToolExample, tool
 
 
@@ -33,7 +37,12 @@
         ),
         ToolExample(
             "Cold-shock embryo_2 to 15 C with 2 bursts before and after",
-            {"embryo_id": "embryo_2", "target_setpoint_c": 15.0, "bursts_before": 2, "bursts_after": 2},
+            {
+                "embryo_id": "embryo_2",
+                "target_setpoint_c": 15.0,
+                "bursts_before": 2,
+                "bursts_after": 2,
+            },
         ),
     ],
 )
diff --git a/gently/core/event_bus.py b/gently/core/event_bus.py
index 0b5db1cd..4df91bb4 100644
--- a/gently/core/event_bus.py
+++ b/gently/core/event_bus.py
@@ -129,7 +129,9 @@ class EventType(Enum):
 
     # Temperature protocol events (Phase X / 10) — temp-change burst tactic
     TEMPERATURE_SETPOINT_CHANGED = auto()  # {embryo_id, to}
-    TEMP_PROTOCOL_STARTED = auto()  # {embryo_id, target_setpoint_c, frames, bursts_before, bursts_after}
+    TEMP_PROTOCOL_STARTED = (
+        auto()
+    )  # {embryo_id, target_setpoint_c, frames, bursts_before, bursts_after}
     TEMP_PROTOCOL_COMPLETED = auto()  # {embryo_id, locked, cancelled, error}
 
     # Reactive control telemetry (Phase 5 / 10)
diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index d9dafaaa..0f82a486 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -450,7 +450,8 @@ def append_temperature_sample(self, session_id: str, sample: dict) -> None:
         _append_jsonl(sd / "temperature.jsonl", sample)
 
     def read_temperature_log(self, session_id: str, since: str | None = None) -> list[dict]:
-        """Return temperature samples for a session, optionally filtered to t >= since (ISO-UTC string).
+        """Return temperature samples for a session, optionally filtered to
+        t >= since (ISO-UTC string).
 
         Reads lines tolerantly: a truncated trailing line (e.g. after a mid-append
         crash) is silently skipped rather than raising a JSONDecodeError.
@@ -778,9 +779,7 @@ def get_volume_meta(self, session_id: str, embryo_id: str, timepoint: int) -> di
         sd = self._session_dir(session_id)
         if sd is None:
             return None
-        meta_path = (
-            sd / "embryos" / embryo_id / "volumes" / self._volume_meta_filename(timepoint)
-        )
+        meta_path = sd / "embryos" / embryo_id / "volumes" / self._volume_meta_filename(timepoint)
         return _read_yaml(meta_path)
 
     def list_volumes(self, session_id: str, embryo_id: str | None = None) -> list[VolumeInfo]:
diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index cfef7d24..b0bfb81c 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -126,7 +126,7 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
             logger.info("Created camera_b (side B): %s", cam_b_name)
         else:
             logger.warning(
-                "camera_b (%s) not in loaded devices — single-camera rig or device absent; skipping",
+                "camera_b (%s) not in loaded devices — single-camera rig or device absent; skipping",  # noqa: E501
                 cam_b_name,
             )
     except Exception as e:
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 2c5127a3..0042f5af 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -171,7 +171,7 @@ def __init__(
         # Lightsheet (SPIM) live stream — continuous sequence acquisition.
         self._ls_subscribers: list[asyncio.Queue] = []
         self._ls_task: asyncio.Task | None = None
-        self._ls_interval_sec: float = 0.0          # peek as fast as exposure allows
+        self._ls_interval_sec: float = 0.0  # peek as fast as exposure allows
         self._ls_target_max_dim: int = 512
         self._ls_jpeg_quality: int = 70
         self._ls_params: dict = {
@@ -184,9 +184,9 @@ def __init__(
             "mode": "snap",
         }
         self._ls_seq_started: bool = False
-        self._ls_applied: dict = {}                  # last-applied galvo/piezo/exposure
-        self._ls_parked: dict = {}                   # last-parked galvo/piezo setPosition values
-        self._ls_spim_idle: bool = False             # whether SPIM state machine was set Idle this session
+        self._ls_applied: dict = {}  # last-applied galvo/piezo/exposure
+        self._ls_parked: dict = {}  # last-parked galvo/piezo setPosition values
+        self._ls_spim_idle: bool = False  # whether SPIM state machine was set Idle this session
 
         # Plans that hold MMCore for long performance-critical work.
         # Anything in this set runs with state polling paused.
@@ -1009,7 +1009,7 @@ def _park_lightsheet_sync(self) -> None:
                 scanner = self.devices["scanner_b"]
             else:
                 logger.warning(
-                    "Side B requested but scanner_b not registered; falling back to side A for scanner"
+                    "Side B requested but scanner_b not registered; falling back to side A for scanner"  # noqa: E501
                 )
                 scanner = self.devices.get("scanner")
         else:
@@ -1199,7 +1199,9 @@ async def _lightsheet_streamer(self):
                 tick = time.monotonic()
                 img = await asyncio.to_thread(self._grab_lightsheet_frame_sync)
                 payload = (
-                    self._encode_frame_for_stream(img, self._ls_target_max_dim, self._ls_jpeg_quality)
+                    self._encode_frame_for_stream(
+                        img, self._ls_target_max_dim, self._ls_jpeg_quality
+                    )
                     if img is not None
                     else None
                 )
diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index caebd0ec..a881a0bb 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -13,14 +13,14 @@
 from .context import create_router as create_context_router
 from .data import create_router as create_data_router
 from .experiments import create_router as create_experiments_router
-from .operation_plan import create_router as create_operation_plan_router
-from .roles import create_router as create_roles_router
-from .tactic_library import create_router as create_tactic_library_router
-from .temperature import create_router as create_temperature_router
 from .images import create_router as create_images_router
 from .notebook import create_router as create_notebook_router
+from .operation_plan import create_router as create_operation_plan_router
 from .pages import create_router as create_pages_router
+from .roles import create_router as create_roles_router
 from .sessions import create_router as create_sessions_router
+from .tactic_library import create_router as create_tactic_library_router
+from .temperature import create_router as create_temperature_router
 from .volumes import create_router as create_volumes_router
 from .websocket import create_router as create_websocket_router
 
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 99dd07d8..075117be 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -482,8 +482,11 @@ async def lightsheet_live_params(payload: dict = Body(...)):  # noqa: B008
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
             res = await client.set_lightsheet_live_params(
-                galvo=payload.get("galvo"), piezo=payload.get("piezo"),
-                exposure=payload.get("exposure"), side=payload.get("side"))
+                galvo=payload.get("galvo"),
+                piezo=payload.get("piezo"),
+                exposure=payload.get("exposure"),
+                side=payload.get("side"),
+            )
         except Exception as exc:
             logger.exception("lightsheet live params failed")
             raise HTTPException(status_code=502, detail=f"params failed: {exc}") from exc
@@ -600,7 +603,7 @@ async def stage_move(payload: dict = Body(...)):  # noqa: B008
         try:
             return await client.move_to_position(float(payload["x"]), float(payload["y"]))
         except KeyError:
-            raise HTTPException(status_code=400, detail="x and y required")
+            raise HTTPException(status_code=400, detail="x and y required") from None
         except Exception as exc:
             logger.exception("Stage move command failed")
             raise HTTPException(status_code=502, detail=f"stage move failed: {exc}") from exc
@@ -706,7 +709,9 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
         try:
             interval_seconds = float(raw_interval)
         except (TypeError, ValueError):
-            raise HTTPException(status_code=400, detail="interval_seconds must be a number")
+            raise HTTPException(  # B904
+                status_code=400, detail="interval_seconds must be a number"
+            ) from None
         if interval_seconds <= 0:
             raise HTTPException(status_code=400, detail="interval_seconds must be > 0")
 
@@ -715,7 +720,9 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
             try:
                 num_slices = int(raw_slices)
             except (TypeError, ValueError):
-                raise HTTPException(status_code=400, detail="num_slices must be an integer")
+                raise HTTPException(  # B904
+                    status_code=400, detail="num_slices must be an integer"
+                ) from None
             if num_slices < 1:
                 raise HTTPException(status_code=400, detail="num_slices must be >= 1")
         else:
diff --git a/gently/ui/web/routes/operation_plan.py b/gently/ui/web/routes/operation_plan.py
index 9e0d8c82..a5e636eb 100644
--- a/gently/ui/web/routes/operation_plan.py
+++ b/gently/ui/web/routes/operation_plan.py
@@ -16,7 +16,9 @@ def _resolve_session(session_id: str) -> str:
         if session_id == "current":
             store = getattr(server, "gently_store", None)
             if store is None:
-                raise HTTPException(status_code=503, detail="FileStore not configured on viz server")
+                raise HTTPException(
+                    status_code=503, detail="FileStore not configured on viz server"
+                )
             sessions = store.list_sessions()
             if not sessions:
                 raise HTTPException(status_code=404, detail="No sessions in store")
diff --git a/gently/ui/web/routes/temperature.py b/gently/ui/web/routes/temperature.py
index 1505714b..90916181 100644
--- a/gently/ui/web/routes/temperature.py
+++ b/gently/ui/web/routes/temperature.py
@@ -3,6 +3,7 @@
 Live updates ride the TEMPERATURE_UPDATE event channel; this route is backfill only.
 Mirrors routes/experiments.py session resolution.
 """
+
 import urllib.parse
 
 from fastapi import APIRouter, HTTPException, Request
diff --git a/tests/test_burst_laser_config.py b/tests/test_burst_laser_config.py
index 9e973715..079651a6 100644
--- a/tests/test_burst_laser_config.py
+++ b/tests/test_burst_laser_config.py
@@ -1,6 +1,5 @@
 """Task 2: BurstAcquisition laser_config threading tests."""
-import asyncio
-import pytest
+
 from gently.app.orchestration.exclusive import BurstAcquisition
 
 
diff --git a/tests/test_burst_phase_snapshot.py b/tests/test_burst_phase_snapshot.py
index 1c2f28fe..3218f9a0 100644
--- a/tests/test_burst_phase_snapshot.py
+++ b/tests/test_burst_phase_snapshot.py
@@ -9,7 +9,6 @@
 from datetime import datetime, timedelta
 from pathlib import Path
 
-import pytest
 import yaml
 
 from gently.ui.web.strategy_snapshot import build_strategy_snapshot
@@ -39,9 +38,7 @@ def _write_session(session_dir: Path) -> None:
             EMBRYO_ID: {"interval_seconds": 120},
         },
     }
-    (session_dir / "timelapse.yaml").write_text(
-        yaml.dump(timelapse), encoding="utf-8"
-    )
+    (session_dir / "timelapse.yaml").write_text(yaml.dump(timelapse), encoding="utf-8")
 
     # timeline.jsonl
     events = [
diff --git a/tests/test_dual_camera_factory.py b/tests/test_dual_camera_factory.py
index 7149f82e..2eb649f6 100644
--- a/tests/test_dual_camera_factory.py
+++ b/tests/test_dual_camera_factory.py
@@ -5,6 +5,7 @@
   - FakeCore without "HamCam2" → camera_b absent, no crash, devices["camera"] still created
   - camera_b registration uses core.getLoadedDevices() as the presence check
 """
+
 import sys
 from unittest.mock import MagicMock
 
diff --git a/tests/test_embryo_strain.py b/tests/test_embryo_strain.py
index 7f2836eb..3a0c98a1 100644
--- a/tests/test_embryo_strain.py
+++ b/tests/test_embryo_strain.py
@@ -9,11 +9,9 @@
 
 from unittest.mock import MagicMock
 
-import pytest
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-
 # ===========================================================================
 # FileStore tests
 # ===========================================================================
diff --git a/tests/test_laser_preset_route.py b/tests/test_laser_preset_route.py
index ba6f4538..a7ffc05c 100644
--- a/tests/test_laser_preset_route.py
+++ b/tests/test_laser_preset_route.py
@@ -7,13 +7,14 @@
   - No client (microscope not connected) → 503
   - require_control gate (403 without override)
 """
-from unittest.mock import MagicMock, AsyncMock
+
+from unittest.mock import AsyncMock, MagicMock
 
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from gently.ui.web.routes.data import create_router
 import gently.ui.web.auth as auth
+from gently.ui.web.routes.data import create_router
 
 
 def _app(client=None):
@@ -35,6 +36,7 @@ def _app(client=None):
 # Happy path
 # ---------------------------------------------------------------------------
 
+
 def test_set_laser_config_calls_client():
     """POST /api/devices/laser/config must call client.set_laser_config(config)."""
     client = MagicMock()
@@ -63,6 +65,7 @@ def test_set_laser_config_all_off():
 # 400 — missing / invalid config
 # ---------------------------------------------------------------------------
 
+
 def test_set_laser_config_missing_key_returns_400():
     """POST without 'config' key in body → 400."""
     client = MagicMock()
@@ -97,6 +100,7 @@ def test_set_laser_config_null_returns_400():
 # 503 — no client
 # ---------------------------------------------------------------------------
 
+
 def test_set_laser_config_no_client_returns_503():
     """POST when microscope not connected → 503."""
     r = _app(client=None).post(
@@ -110,6 +114,7 @@ def test_set_laser_config_no_client_returns_503():
 # require_control gate
 # ---------------------------------------------------------------------------
 
+
 def test_set_laser_config_requires_control():
     """POST /api/devices/laser/config is gated by require_control."""
     server = MagicMock()
diff --git a/tests/test_lightsheet_buffer.py b/tests/test_lightsheet_buffer.py
index de9f9235..657376e0 100644
--- a/tests/test_lightsheet_buffer.py
+++ b/tests/test_lightsheet_buffer.py
@@ -7,11 +7,11 @@
   - continuous mode calls clearCircularBuffer() after each getLastImage()
   - _stop_lightsheet_sequence_sync calls clearCircularBuffer() in both modes
 """
+
 import sys
 from unittest.mock import MagicMock
 
 import numpy as np
-import pytest
 
 # Patch heavy hardware deps before importing device_layer
 for _mod in (
@@ -31,7 +31,6 @@
 
 from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
 
-
 # ---------------------------------------------------------------------------
 # Full-featured FakeCore tracking every buffer-related call
 # ---------------------------------------------------------------------------
@@ -195,9 +194,7 @@ def test_continuous_mode_sets_circular_buffer_footprint():
     assert core.footprint_set is not None, (
         "setCircularBufferMemoryFootprint must be called in continuous mode"
     )
-    assert core.footprint_set == 256, (
-        f"footprint must be 256 MB, got {core.footprint_set}"
-    )
+    assert core.footprint_set == 256, f"footprint must be 256 MB, got {core.footprint_set}"
 
 
 def test_continuous_mode_calls_clear_after_grab():
diff --git a/tests/test_lightsheet_client.py b/tests/test_lightsheet_client.py
index cf4a9538..c02f2129 100644
--- a/tests/test_lightsheet_client.py
+++ b/tests/test_lightsheet_client.py
@@ -1,4 +1,3 @@
-import pytest
 from gently.hardware.dispim.client import DiSPIMMicroscope
 
 
@@ -29,6 +28,7 @@ def test_stream_lightsheet_is_async_generator():
 # set_laser_config / get_laser_configs
 # ---------------------------------------------------------------------------
 
+
 async def test_set_laser_config_posts_correct_path_and_body():
     """set_laser_config posts to /api/laser/config with {"config": <name>}."""
     m = DiSPIMMicroscope.__new__(DiSPIMMicroscope)
diff --git a/tests/test_lightsheet_event.py b/tests/test_lightsheet_event.py
index 20271403..277b14f1 100644
--- a/tests/test_lightsheet_event.py
+++ b/tests/test_lightsheet_event.py
@@ -1,6 +1,6 @@
 """Tests for LIGHTSHEET_FRAME event type"""
 
-from gently.core.event_bus import EventType, EventBus, _NO_HISTORY_TYPES
+from gently.core.event_bus import _NO_HISTORY_TYPES, EventBus, EventType
 
 
 def test_lightsheet_frame_event_exists():
diff --git a/tests/test_lightsheet_monitor.py b/tests/test_lightsheet_monitor.py
index f5cdf797..5f3c6bf9 100644
--- a/tests/test_lightsheet_monitor.py
+++ b/tests/test_lightsheet_monitor.py
@@ -6,10 +6,11 @@
 """
 
 import asyncio
+
 import pytest
 
-from gently.core.event_bus import EventType, get_event_bus
 from gently.app.lightsheet_monitor import LightSheetStreamMonitor
+from gently.core.event_bus import EventType, get_event_bus
 
 
 class FakeScope:
diff --git a/tests/test_lightsheet_routes.py b/tests/test_lightsheet_routes.py
index 0f7f172b..5cb9debe 100644
--- a/tests/test_lightsheet_routes.py
+++ b/tests/test_lightsheet_routes.py
@@ -7,13 +7,14 @@
   - acquire/burst, acquire/volume
   - require_control gate (403 without override)
 """
-from unittest.mock import MagicMock, AsyncMock
+
+from unittest.mock import AsyncMock, MagicMock
 
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from gently.ui.web.routes.data import create_router
 import gently.ui.web.auth as auth
+from gently.ui.web.routes.data import create_router
 
 
 def _app(client=None, monitor=None):
@@ -36,6 +37,7 @@ def _app(client=None, monitor=None):
 # live start / stop / status
 # ---------------------------------------------------------------------------
 
+
 def test_live_status_no_monitor():
     """GET status returns available=False when monitor is None."""
     r = _app(monitor=None).get("/api/devices/lightsheet/live/status")
@@ -88,6 +90,7 @@ def test_live_stop_calls_monitor_stop():
 # live/params
 # ---------------------------------------------------------------------------
 
+
 def test_live_params_forwards():
     client = MagicMock()
     client.set_lightsheet_live_params = AsyncMock(return_value={"params": {}})
@@ -96,9 +99,7 @@ def test_live_params_forwards():
         json={"galvo": 1.0, "piezo": 40.0, "exposure": 20.0},
     )
     assert r.status_code == 200
-    client.set_lightsheet_live_params.assert_awaited_once_with(
-        galvo=1.0, piezo=40.0, exposure=20.0
-    )
+    client.set_lightsheet_live_params.assert_awaited_once_with(galvo=1.0, piezo=40.0, exposure=20.0)
 
 
 def test_live_params_no_client_503():
@@ -118,6 +119,7 @@ def test_live_params_no_client_503():
 # led/set
 # ---------------------------------------------------------------------------
 
+
 def test_led_set_forwards():
     client = MagicMock()
     client.set_led = AsyncMock(return_value={"success": True})
@@ -130,6 +132,7 @@ def test_led_set_forwards():
 # laser/off  — spec §2.7: must use Laser ALL OFF config, not power setpoint
 # ---------------------------------------------------------------------------
 
+
 def test_laser_off_calls_set_laser_config_all_off():
     """laser/off must call set_laser_config("ALL OFF") to gate every line off."""
     client = MagicMock()
@@ -143,6 +146,7 @@ def test_laser_off_calls_set_laser_config_all_off():
 # laser/configs  — unguarded GET, no require_control
 # ---------------------------------------------------------------------------
 
+
 def test_laser_configs_forwards_to_client():
     """GET laser/configs must forward to client.get_laser_configs."""
     client = MagicMock()
@@ -158,6 +162,7 @@ def test_laser_configs_forwards_to_client():
 def test_laser_configs_no_require_control():
     """GET laser/configs is unguarded — available even without control override."""
     from fastapi import FastAPI
+
     from gently.ui.web.routes.data import create_router
 
     server = MagicMock()
@@ -178,6 +183,7 @@ def test_laser_configs_no_require_control():
 # camera/led_mode
 # ---------------------------------------------------------------------------
 
+
 def test_camera_led_mode_forwards():
     client = MagicMock()
     client.set_camera_led_mode = AsyncMock(return_value={"success": True})
@@ -190,6 +196,7 @@ def test_camera_led_mode_forwards():
 # stage/move
 # ---------------------------------------------------------------------------
 
+
 def test_stage_move_forwards():
     client = MagicMock()
     client.move_to_position = AsyncMock(return_value={"success": True})
@@ -209,6 +216,7 @@ def test_stage_move_missing_xy_400():
 # acquire/burst
 # ---------------------------------------------------------------------------
 
+
 def test_acquire_burst_forwards():
     """Basic burst forwards without optional params — no laser_config/piezo/galvo in body."""
     client = MagicMock()
@@ -229,14 +237,25 @@ def test_acquire_burst_forwards_laser_config_and_focal_plane():
     client.acquire_burst = AsyncMock(return_value={"success": True})
     r = _app(client=client).post(
         "/api/devices/acquire/burst",
-        json={"frames": 10, "mode": "brightfield", "num_slices": 50,
-              "exposure_ms": 20.0, "laser_config": "ALL OFF",
-              "piezo_center": 55.0, "galvo_center": 1.5},
+        json={
+            "frames": 10,
+            "mode": "brightfield",
+            "num_slices": 50,
+            "exposure_ms": 20.0,
+            "laser_config": "ALL OFF",
+            "piezo_center": 55.0,
+            "galvo_center": 1.5,
+        },
     )
     assert r.status_code == 200
     client.acquire_burst.assert_awaited_once_with(
-        frames=10, mode="brightfield", num_slices=50, exposure_ms=20.0,
-        laser_config="ALL OFF", piezo_center=55.0, galvo_center=1.5,
+        frames=10,
+        mode="brightfield",
+        num_slices=50,
+        exposure_ms=20.0,
+        laser_config="ALL OFF",
+        piezo_center=55.0,
+        galvo_center=1.5,
     )
 
 
@@ -244,6 +263,7 @@ def test_acquire_burst_forwards_laser_config_and_focal_plane():
 # acquire/volume
 # ---------------------------------------------------------------------------
 
+
 def test_acquire_volume_forwards():
     """Basic volume forwards without optional params."""
     client = MagicMock()
@@ -262,13 +282,21 @@ def test_acquire_volume_forwards_laser_config_and_focal_plane():
     client.acquire_volume = AsyncMock(return_value={"success": True})
     r = _app(client=client).post(
         "/api/devices/acquire/volume",
-        json={"num_slices": 50, "exposure_ms": 20.0,
-              "laser_config": "ALL OFF", "piezo_center": 55.0, "galvo_center": 1.5},
+        json={
+            "num_slices": 50,
+            "exposure_ms": 20.0,
+            "laser_config": "ALL OFF",
+            "piezo_center": 55.0,
+            "galvo_center": 1.5,
+        },
     )
     assert r.status_code == 200
     client.acquire_volume.assert_awaited_once_with(
-        num_slices=50, exposure_ms=20.0,
-        laser_config="ALL OFF", piezo_center=55.0, galvo_center=1.5,
+        num_slices=50,
+        exposure_ms=20.0,
+        laser_config="ALL OFF",
+        piezo_center=55.0,
+        galvo_center=1.5,
     )
 
 
@@ -276,6 +304,7 @@ def test_acquire_volume_forwards_laser_config_and_focal_plane():
 # require_control gate — 403 WITHOUT override
 # ---------------------------------------------------------------------------
 
+
 def test_require_control_gate_403():
     """Without the dependency override, TestClient host is not loopback → 403."""
     server = MagicMock()
diff --git a/tests/test_lightsheet_side_param.py b/tests/test_lightsheet_side_param.py
index e4679c47..67751637 100644
--- a/tests/test_lightsheet_side_param.py
+++ b/tests/test_lightsheet_side_param.py
@@ -8,6 +8,7 @@
   - side B without camera_b falls back to A + no crash
   - handle_get_cameras returns ["A"] or ["A","B"] based on devices dict
 """
+
 import json
 import sys
 from unittest.mock import AsyncMock, MagicMock
@@ -32,7 +33,6 @@
 
 from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
diff --git a/tests/test_lightsheet_streamer.py b/tests/test_lightsheet_streamer.py
index 9091ea13..076d2496 100644
--- a/tests/test_lightsheet_streamer.py
+++ b/tests/test_lightsheet_streamer.py
@@ -3,46 +3,89 @@
 from unittest.mock import MagicMock
 
 # Patch heavy hardware deps before importing device_layer
-for _mod in ("bluesky", "bluesky.run_engine", "ophyd", "ophyd.status",
-             "pymmcore", "gently.hardware.console_ui"):
+for _mod in (
+    "bluesky",
+    "bluesky.run_engine",
+    "ophyd",
+    "ophyd.status",
+    "pymmcore",
+    "gently.hardware.console_ui",
+):
     if _mod not in sys.modules:
         sys.modules[_mod] = MagicMock()
 
 # Patch bluesky.RunEngine specifically
-import bluesky as _bs
+import bluesky as _bs  # noqa: E402
+
 _bs.RunEngine = MagicMock(name="RunEngine")
 
-import asyncio, numpy as np, pytest
-from gently.hardware.dispim.device_layer import DeviceLayerServer
+import asyncio  # noqa: E402
+
+import numpy as np  # noqa: E402
+import pytest  # noqa: E402
+
+from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
 
 
 class FakeCore:
     def __init__(self):
-        self.running = False; self.exposure = None; self.cam = None
+        self.running = False
+        self.exposure = None
+        self.cam = None
         self._frame = np.full((64, 64), 1000, dtype=np.uint16)
-        self.started = 0; self.stopped = 0
-    def setCameraDevice(self, n): self.cam = n
-    def getCameraDevice(self): return self.cam
-    def setExposure(self, n, ms): self.exposure = ms
-    def startContinuousSequenceAcquisition(self, interval): self.running = True; self.started += 1
-    def stopSequenceAcquisition(self): self.running = False; self.stopped += 1
-    def isSequenceRunning(self): return self.running
-    def getLastImage(self): return self._frame
+        self.started = 0
+        self.stopped = 0
+
+    def setCameraDevice(self, n):
+        self.cam = n
+
+    def getCameraDevice(self):
+        return self.cam
+
+    def setExposure(self, n, ms):
+        self.exposure = ms
+
+    def startContinuousSequenceAcquisition(self, interval):
+        self.running = True
+        self.started += 1
+
+    def stopSequenceAcquisition(self):
+        self.running = False
+        self.stopped += 1
+
+    def isSequenceRunning(self):
+        return self.running
+
+    def getLastImage(self):
+        return self._frame
 
 
 class FakeAxis:
-    def __init__(self): self.pos = None
-    def setPosition(self, v): self.pos = v
+    def __init__(self):
+        self.pos = None
+
+    def setPosition(self, v):
+        self.pos = v
 
 
 class FakeScanner:
-    def __init__(self): self.sa_offset_y = FakeAxis(); self.name = "Scanner"; self.state = None
-    def set_spim_state(self, s): self.state = s
+    def __init__(self):
+        self.sa_offset_y = FakeAxis()
+        self.name = "Scanner"
+        self.state = None
+
+    def set_spim_state(self, s):
+        self.state = s
 
 
 class FakePiezo(FakeAxis):
-    def __init__(self): super().__init__(); self.name = "Piezo"; self.state = None
-    def set_spim_state(self, s): self.state = s
+    def __init__(self):
+        super().__init__()
+        self.name = "Piezo"
+        self.state = None
+
+    def set_spim_state(self, s):
+        self.state = s
 
 
 def _make_dl():
@@ -63,15 +106,17 @@ def _make_dl():
 async def test_grab_parks_and_peeks(monkeypatch):
     dl = _make_dl()
     dl._state_pause_counter = 0
-    dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
+    dl._ls_target_max_dim = 512
+    dl._ls_jpeg_quality = 70
     # Explicit continuous mode: this test verifies the sequence-start + getLastImage path.
     dl._ls_params = {"galvo": 1.5, "piezo": 40.0, "exposure": 20.0, "mode": "continuous"}
-    dl._ls_seq_started = False; dl._ls_applied = {}
+    dl._ls_seq_started = False
+    dl._ls_applied = {}
     dl._ls_interval_sec = 0.0
     img = await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
     assert img is not None and img.shape == (64, 64)
-    assert dl.system.core.running is True              # sequence started
-    assert dl.devices["piezo"].pos == 40.0             # piezo parked
+    assert dl.system.core.running is True  # sequence started
+    assert dl.devices["piezo"].pos == 40.0  # piezo parked
     assert dl.devices["scanner"].sa_offset_y.pos == 1.5  # galvo parked
 
 
@@ -79,14 +124,16 @@ async def test_grab_parks_and_peeks(monkeypatch):
 async def test_exposure_change_restarts_sequence():
     dl = _make_dl()
     dl._state_pause_counter = 0
-    dl._ls_target_max_dim = 512; dl._ls_jpeg_quality = 70
+    dl._ls_target_max_dim = 512
+    dl._ls_jpeg_quality = 70
     # Explicit continuous mode: this test verifies restart on exposure change.
     dl._ls_params = {"galvo": 0.0, "piezo": 50.0, "exposure": 10.0, "mode": "continuous"}
-    dl._ls_seq_started = False; dl._ls_applied = {}
+    dl._ls_seq_started = False
+    dl._ls_applied = {}
     dl._ls_interval_sec = 0.0
     await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
     starts = dl.system.core.started
-    dl._ls_params["exposure"] = 30.0                   # exposure change
+    dl._ls_params["exposure"] = 30.0  # exposure change
     await asyncio.to_thread(dl._grab_lightsheet_frame_sync)
     assert dl.system.core.stopped >= 1 and dl.system.core.started == starts + 1
     assert dl.system.core.exposure == 30.0
diff --git a/tests/test_operation_plan_route.py b/tests/test_operation_plan_route.py
index c7c45d59..a197fc84 100644
--- a/tests/test_operation_plan_route.py
+++ b/tests/test_operation_plan_route.py
@@ -1,4 +1,3 @@
-from pathlib import Path
 from unittest.mock import MagicMock
 
 from fastapi import FastAPI
diff --git a/tests/test_operation_plan_seeding.py b/tests/test_operation_plan_seeding.py
index abe36911..f3526fa8 100644
--- a/tests/test_operation_plan_seeding.py
+++ b/tests/test_operation_plan_seeding.py
@@ -20,11 +20,8 @@
 6. Plan item linked but imaging_spec.tactics is empty → returns None, no write
 """
 
-import pytest
-
 from gently.app.tools.operation_plan_seed import seed_operation_plan_from_plan_item
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
@@ -328,8 +325,18 @@ def test_all_tactics_already_present_returns_none(self, file_context_store):
             "title": "Full plan",
             "goal": "full goal",
             "tactics": [
-                {"id": "t1", "name": "Baseline timelapse", "kind": "standing_timelapse", "state": "planned"},
-                {"id": "t2", "name": "Hatching monitor", "kind": "reactive_monitor", "state": "planned"},
+                {
+                    "id": "t1",
+                    "name": "Baseline timelapse",
+                    "kind": "standing_timelapse",
+                    "state": "planned",
+                },
+                {
+                    "id": "t2",
+                    "name": "Hatching monitor",
+                    "kind": "reactive_monitor",
+                    "state": "planned",
+                },
             ],
             "updated_at": "2026-06-28T09:00:00Z",
             "updated_reason": "already seeded",
diff --git a/tests/test_operation_plan_store.py b/tests/test_operation_plan_store.py
index c656e410..a3b9123c 100644
--- a/tests/test_operation_plan_store.py
+++ b/tests/test_operation_plan_store.py
@@ -7,7 +7,6 @@
 
 from gently.core.event_bus import EventType, on
 
-
 # ---------------------------------------------------------------------------
 # Fixture helpers
 # ---------------------------------------------------------------------------
@@ -26,9 +25,7 @@
             "rationale": "Establish pre-ramp cadence",
             "structure": {
                 "cadence_s": 120,
-                "per_embryo": [
-                    {"embryo_id": "e1", "cadence_phase": "normal", "interval_s": 120}
-                ],
+                "per_embryo": [{"embryo_id": "e1", "cadence_phase": "normal", "interval_s": 120}],
             },
             "live_bind": ["cadence"],
             "relations": {},
diff --git a/tests/test_operation_plan_tool.py b/tests/test_operation_plan_tool.py
index 7f2255b6..1640df67 100644
--- a/tests/test_operation_plan_tool.py
+++ b/tests/test_operation_plan_tool.py
@@ -9,7 +9,6 @@
 
 import pytest
 
-
 # ---------------------------------------------------------------------------
 # Fakes
 # ---------------------------------------------------------------------------
@@ -554,9 +553,7 @@ def test_normalize_tactic_state_synonyms():
         # Override state directly
         tactics[0]["state"] = raw_state
         result = _validate_tactics(tactics)
-        assert result[0]["state"] == expected, (
-            f"state '{raw_state}' should map to '{expected}'"
-        )
+        assert result[0]["state"] == expected, f"state '{raw_state}' should map to '{expected}'"
 
 
 def test_normalize_full_scenario():
diff --git a/tests/test_operation_plan_updater.py b/tests/test_operation_plan_updater.py
index 0fe50d7e..00afb7da 100644
--- a/tests/test_operation_plan_updater.py
+++ b/tests/test_operation_plan_updater.py
@@ -9,21 +9,21 @@
 - Handler exception doesn't propagate to the caller
 - on_stop unsubscribes (no further calls after stop)
 """
+
 from __future__ import annotations
 
-import asyncio
 from unittest.mock import MagicMock
 
 import pytest
 
-from gently.core.event_bus import EventBus, EventType
 from gently.app.operation_plan_updater import OperationPlanUpdater
-
+from gently.core.event_bus import EventBus, EventType
 
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
 
+
 class FakeContextStore:
     """Records all transition_tactic calls."""
 
@@ -52,6 +52,7 @@ def make_event(event_type: EventType, data: dict):
 # Fixtures
 # ---------------------------------------------------------------------------
 
+
 @pytest.fixture
 def bus():
     """A fresh EventBus for each test (avoids cross-test leakage)."""
@@ -77,12 +78,11 @@ def updater(store, session_id):
 # Tests
 # ---------------------------------------------------------------------------
 
+
 @pytest.mark.asyncio
 async def test_burst_complete_transitions_tactic_to_done(updater, store, bus, monkeypatch):
     """BURST_COMPLETE fires → tactic transitions to done with bind values."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     await updater.start()
 
     bus.publish(
@@ -113,9 +113,7 @@ async def test_burst_complete_transitions_tactic_to_done(updater, store, bus, mo
 @pytest.mark.asyncio
 async def test_temp_protocol_completed_transitions_to_done(updater, store, bus, monkeypatch):
     """TEMP_PROTOCOL_COMPLETED fires → tactic done with locked/cancelled/error."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     await updater.start()
 
     bus.publish(
@@ -143,9 +141,7 @@ async def test_temp_protocol_completed_transitions_to_done(updater, store, bus,
 @pytest.mark.asyncio
 async def test_embryo_cadence_changed_bind_only(updater, store, bus, monkeypatch):
     """EMBRYO_CADENCE_CHANGED → bind-only (state=None), cadence values bound."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     await updater.start()
 
     bus.publish(
@@ -165,7 +161,7 @@ async def test_embryo_cadence_changed_bind_only(updater, store, bus, monkeypatch
     assert len(store.calls) == 1
     call = store.calls[0]
     assert call["tactic_id"] == "t3"
-    assert call["state"] is None          # bind-only
+    assert call["state"] is None  # bind-only
     assert call["new_phase"] == "dense"
     assert call["new_interval_s"] == 30
 
@@ -175,9 +171,7 @@ async def test_embryo_cadence_changed_bind_only(updater, store, bus, monkeypatch
 @pytest.mark.asyncio
 async def test_trigger_fired_bind_only_with_last_fired(updater, store, bus, monkeypatch):
     """TRIGGER_FIRED → bind-only with last_fired timestamp injected."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     await updater.start()
 
     bus.publish(
@@ -195,7 +189,7 @@ async def test_trigger_fired_bind_only_with_last_fired(updater, store, bus, monk
     call = store.calls[0]
     assert call["tactic_id"] == "t4"
     assert call["state"] is None
-    assert "last_fired" in call           # timestamp injected by updater
+    assert "last_fired" in call  # timestamp injected by updater
 
     await updater.stop()
 
@@ -203,9 +197,7 @@ async def test_trigger_fired_bind_only_with_last_fired(updater, store, bus, monk
 @pytest.mark.asyncio
 async def test_event_without_tactic_id_is_skipped(updater, store, bus, monkeypatch):
     """An event with no tactic_id must not call transition_tactic."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     await updater.start()
 
     bus.publish(
@@ -226,9 +218,7 @@ async def test_event_without_tactic_id_is_skipped(updater, store, bus, monkeypat
 @pytest.mark.asyncio
 async def test_handler_exception_does_not_propagate(updater, bus, monkeypatch):
     """An exception inside _handle must be swallowed — bus caller not affected."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
 
     class BrokenStore:
         def transition_tactic(self, *a, **kw):
@@ -250,9 +240,7 @@ def transition_tactic(self, *a, **kw):
 @pytest.mark.asyncio
 async def test_no_session_skips_transition(store, bus, monkeypatch):
     """If session_id_getter returns None, no transition_tactic call is made."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     no_session_updater = OperationPlanUpdater(store, lambda: None)
     await no_session_updater.start()
 
@@ -270,9 +258,7 @@ async def test_no_session_skips_transition(store, bus, monkeypatch):
 @pytest.mark.asyncio
 async def test_stop_unsubscribes_from_bus(store, bus, monkeypatch):
     """After stop(), further bus events produce no transition_tactic calls."""
-    monkeypatch.setattr(
-        "gently.app.operation_plan_updater.get_event_bus", lambda: bus
-    )
+    monkeypatch.setattr("gently.app.operation_plan_updater.get_event_bus", lambda: bus)
     up = OperationPlanUpdater(store, lambda: "sess_z")
     await up.start()
     await up.stop()
diff --git a/tests/test_plan_item_tactics.py b/tests/test_plan_item_tactics.py
index b1cd91da..825963aa 100644
--- a/tests/test_plan_item_tactics.py
+++ b/tests/test_plan_item_tactics.py
@@ -7,9 +7,7 @@
 
 import dataclasses
 
-import pytest
-
-from gently.harness.memory.model import ImagingSpec, PlanItem, PlanItemType
+from gently.harness.memory.model import ImagingSpec
 
 TACTICS_OUTLINE = [
     {
diff --git a/tests/test_role_scope.py b/tests/test_role_scope.py
index 53b8ee1a..045b5e85 100644
--- a/tests/test_role_scope.py
+++ b/tests/test_role_scope.py
@@ -16,7 +16,6 @@
 
 import pytest
 
-
 # ---------------------------------------------------------------------------
 # Fixtures
 # ---------------------------------------------------------------------------
@@ -139,7 +138,8 @@ def __init__(self):
 
 @pytest.mark.asyncio
 async def test_role_scoped_tactic_passes_declare_validation():
-    """A tactic with scope.mode='role' and a valid role key is accepted by declare_operation_plan."""
+    """A tactic with scope.mode='role' and a valid role key is accepted by
+    declare_operation_plan."""
     from gently.app.tools.operation_plan_tools import declare_operation_plan
 
     role_scoped_tactic = {
diff --git a/tests/test_roles_registry.py b/tests/test_roles_registry.py
index 9fc7181d..6e824507 100644
--- a/tests/test_roles_registry.py
+++ b/tests/test_roles_registry.py
@@ -11,15 +11,14 @@
 import pytest
 
 from gently.harness.roles import (
+    DEFAULT_ROLE,
     REGISTRY,
     EmbryoRole,
-    DEFAULT_ROLE,
     get_role,
     is_valid_role,
     list_roles,
 )
 
-
 # ---------------------------------------------------------------------------
 # role_class field — all existing roles
 # ---------------------------------------------------------------------------
@@ -159,7 +158,7 @@ def test_default_role_is_test():
 
 def test_embryo_role_is_frozen():
     role = REGISTRY["test"]
-    with pytest.raises(Exception):
+    with pytest.raises(AttributeError):
         role.name = "mutated"  # type: ignore[misc]
 
 
diff --git a/tests/test_roles_route.py b/tests/test_roles_route.py
index c710673f..e81218c0 100644
--- a/tests/test_roles_route.py
+++ b/tests/test_roles_route.py
@@ -5,6 +5,7 @@
 - Each entry has the expected fields.
 - Never raises a 500 (graceful).
 """
+
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
@@ -47,7 +48,14 @@ def test_roles_include_lineaging():
 
 def test_roles_entry_has_all_required_fields():
     """Every role entry exposes the required fields."""
-    required = {"name", "description", "role_class", "ui_color", "ui_icon", "default_cadence_seconds"}
+    required = {
+        "name",
+        "description",
+        "role_class",
+        "ui_color",
+        "ui_icon",
+        "default_cadence_seconds",
+    }
     roles = _client().get("/api/roles").json()["roles"]
     for role in roles:
         missing = required - role.keys()
diff --git a/tests/test_session_plan_linking_routes.py b/tests/test_session_plan_linking_routes.py
index fce5fe52..19571227 100644
--- a/tests/test_session_plan_linking_routes.py
+++ b/tests/test_session_plan_linking_routes.py
@@ -14,7 +14,6 @@
 
 from gently.harness.memory.model import PlanItem, PlanItemStatus, PlanItemType, SessionIntent
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
diff --git a/tests/test_session_plan_linking_store.py b/tests/test_session_plan_linking_store.py
index 9158168c..8dba4a10 100644
--- a/tests/test_session_plan_linking_store.py
+++ b/tests/test_session_plan_linking_store.py
@@ -12,8 +12,7 @@
 
 import pytest
 
-from gently.harness.memory.model import PlanItemStatus, PlanItemType
-
+from gently.harness.memory.model import PlanItemType
 
 # ---------------------------------------------------------------------------
 # Helpers
diff --git a/tests/test_tactic_library_store.py b/tests/test_tactic_library_store.py
index 28cd5867..125672a4 100644
--- a/tests/test_tactic_library_store.py
+++ b/tests/test_tactic_library_store.py
@@ -9,8 +9,6 @@
 """
 
 import copy
-import pytest
-
 
 # ---------------------------------------------------------------------------
 # Shared tactic fixture
diff --git a/tests/test_tactic_library_tools.py b/tests/test_tactic_library_tools.py
index e1e33dff..e6ee147e 100644
--- a/tests/test_tactic_library_tools.py
+++ b/tests/test_tactic_library_tools.py
@@ -11,8 +11,8 @@
 """
 
 import copy
-import pytest
 
+import pytest
 
 # ---------------------------------------------------------------------------
 # Shared tactic fixture
@@ -86,7 +86,9 @@ def get_operation_plan(self, session_id: str) -> dict | None:
 
     def set_operation_plan(self, session_id: str, plan: dict) -> None:
         self._plans[session_id] = copy.deepcopy(plan)
-        self.set_operation_plan_calls.append({"session_id": session_id, "plan": copy.deepcopy(plan)})
+        self.set_operation_plan_calls.append(
+            {"session_id": session_id, "plan": copy.deepcopy(plan)}
+        )
 
 
 # ---------------------------------------------------------------------------
@@ -109,13 +111,12 @@ def _make_context(agent):
 # ---------------------------------------------------------------------------
 
 
-from gently.app.tools.tactic_library_tools import (
+from gently.app.tools.tactic_library_tools import (  # noqa: E402
     apply_tactic,
     list_tactics,
     save_tactic,
 )
 
-
 # ---------------------------------------------------------------------------
 # save_tactic tests
 # ---------------------------------------------------------------------------
@@ -250,7 +251,7 @@ async def test_appends_tactic_to_existing_plan(self):
             "tactics": [],
         }
 
-        result = await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
+        await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
 
         assert len(cs.set_operation_plan_calls) == 1
         saved_plan = cs.set_operation_plan_calls[0]["plan"]
@@ -281,7 +282,9 @@ async def test_appends_not_replaces(self):
             "session_id": "sess_001",
             "title": "",
             "goal": "",
-            "tactics": [{"id": "existing_t", "name": "Prior tactic", "kind": "oneshot", "state": "done"}],
+            "tactics": [
+                {"id": "existing_t", "name": "Prior tactic", "kind": "oneshot", "state": "done"}
+            ],
         }
 
         await apply_tactic(id_or_name="Baseline timelapse", context=_make_context(agent))
diff --git a/tests/test_temp_protocol_driver.py b/tests/test_temp_protocol_driver.py
index aa112f03..cd2b5f30 100644
--- a/tests/test_temp_protocol_driver.py
+++ b/tests/test_temp_protocol_driver.py
@@ -1,37 +1,68 @@
 import pytest
+
 from gently.app.orchestration.temperature_protocol import run_temp_change_burst_protocol
 from gently.core.event_bus import EventType
 
 
 class FakeClient:
-    def __init__(self): self.laser=None; self.led=None; self.setpoint=None; self._poll=0
-    async def set_laser_config(self, c): self.laser=c
-    async def set_led(self, s): self.led=s
-    async def set_temperature(self, t): self.setpoint=t
+    def __init__(self):
+        self.laser = None
+        self.led = None
+        self.setpoint = None
+        self._poll = 0
+
+    async def set_laser_config(self, c):
+        self.laser = c
+
+    async def set_led(self, s):
+        self.led = s
+
+    async def set_temperature(self, t):
+        self.setpoint = t
+
     async def get_temperature(self):
         self._poll += 1
         return {"state": "[ SYSTEM LOCKED ]" if self._poll >= 2 else "[ HEATING ]"}
 
 
 class FakeOrch:
-    def __init__(self, client): self._client=client; self._temperature_provider=lambda: None; self.events=[]
+    def __init__(self, client):
+        self._client = client
+        self._temperature_provider = lambda: None
+        self.events = []
+
     @property
-    def client(self): return self._client
-    def _emit_event(self, et, data): self.events.append((et, data))
+    def client(self):
+        return self._client
+
+    def _emit_event(self, et, data):
+        self.events.append((et, data))
 
 
 @pytest.mark.asyncio
 async def test_phase_order_and_brightfield(monkeypatch):
-    client = FakeClient(); orch = FakeOrch(client)
+    client = FakeClient()
+    orch = FakeOrch(client)
     bursts = []
-    async def runner(b): bursts.append({"phase": getattr(b, "_phase", None), "laser": b._laser_config})
+
+    async def runner(b):
+        bursts.append({"phase": getattr(b, "_phase", None), "laser": b._laser_config})
+
     res = await run_temp_change_burst_protocol(
-        orch, "emb1", 25.0, frames=3, bursts_before=1, bursts_after=1,
-        lock_timeout_s=5.0, poll_s=0.001, burst_runner=runner)
+        orch,
+        "emb1",
+        25.0,
+        frames=3,
+        bursts_before=1,
+        bursts_after=1,
+        lock_timeout_s=5.0,
+        poll_s=0.001,
+        burst_runner=runner,
+    )
     assert client.laser == "ALL OFF" and client.led == "Open"
     assert client.setpoint == 25.0
-    assert all(b["laser"] == "ALL OFF" for b in bursts)          # every burst brightfield
-    assert len(bursts) >= 3                                       # before + >=1 during + after
+    assert all(b["laser"] == "ALL OFF" for b in bursts)  # every burst brightfield
+    assert len(bursts) >= 3  # before + >=1 during + after
     ets = [e[0] for e in orch.events]
     assert EventType.TEMP_PROTOCOL_STARTED in ets
     assert EventType.TEMPERATURE_SETPOINT_CHANGED in ets
@@ -47,5 +78,9 @@ async def runner(b): bursts.append({"phase": getattr(b, "_phase", None), "laser"
     idx_started = ets.index(EventType.TEMP_PROTOCOL_STARTED)
     idx_changed = ets.index(EventType.TEMPERATURE_SETPOINT_CHANGED)
     idx_completed = ets.index(EventType.TEMP_PROTOCOL_COMPLETED)
-    assert idx_started < idx_changed, "TEMP_PROTOCOL_STARTED must precede TEMPERATURE_SETPOINT_CHANGED"
-    assert idx_changed < idx_completed, "TEMPERATURE_SETPOINT_CHANGED must precede TEMP_PROTOCOL_COMPLETED"
+    assert idx_started < idx_changed, (
+        "TEMP_PROTOCOL_STARTED must precede TEMPERATURE_SETPOINT_CHANGED"
+    )
+    assert idx_changed < idx_completed, (
+        "TEMPERATURE_SETPOINT_CHANGED must precede TEMP_PROTOCOL_COMPLETED"
+    )
diff --git a/tests/test_temp_protocol_events.py b/tests/test_temp_protocol_events.py
index 7344a985..62883fae 100644
--- a/tests/test_temp_protocol_events.py
+++ b/tests/test_temp_protocol_events.py
@@ -12,6 +12,7 @@ def test_new_event_types_exist():
 def test_timeline_maps_the_subtypes():
     """Verify timeline.py contains the mapping entries with correct subtypes"""
     from gently.harness.session import timeline as tl
+
     src = open(tl.__file__, encoding="utf-8").read()
     for sub in ("temp_protocol_started", "temp_protocol_completed", "setpoint_changed"):
         assert sub in src
diff --git a/tests/test_temp_protocol_snapshot.py b/tests/test_temp_protocol_snapshot.py
index 574940fe..2210c1f5 100644
--- a/tests/test_temp_protocol_snapshot.py
+++ b/tests/test_temp_protocol_snapshot.py
@@ -45,9 +45,7 @@ def _write_session(session_dir: Path) -> None:
             EMBRYO_ID: {"interval_seconds": 120},
         },
     }
-    (session_dir / "timelapse.yaml").write_text(
-        yaml.dump(timelapse), encoding="utf-8"
-    )
+    (session_dir / "timelapse.yaml").write_text(yaml.dump(timelapse), encoding="utf-8")
 
     # timeline.jsonl — the sequence under test
     events = [
diff --git a/tests/test_temp_protocol_tool.py b/tests/test_temp_protocol_tool.py
index 519c4375..d9fe748e 100644
--- a/tests/test_temp_protocol_tool.py
+++ b/tests/test_temp_protocol_tool.py
@@ -4,12 +4,10 @@
 TDD: write failing tests first, then implement the tool.
 """
 
-import asyncio
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import MagicMock, patch
 
 import pytest
 
-
 # ---------------------------------------------------------------------------
 # Fakes
 # ---------------------------------------------------------------------------
@@ -17,6 +15,7 @@
 
 class FakeClient:
     """Minimal fake microscope client."""
+
     async def set_temperature(self, t):
         return {"success": True, "temperature_c": t, "state": "[ HEATING ]"}
 
@@ -26,6 +25,7 @@ async def get_temperature(self):
 
 class FakeOrchestrator:
     """Minimal fake timelapse orchestrator with a client attribute."""
+
     def __init__(self, client):
         self.client = client
 
@@ -35,6 +35,7 @@ def _emit_event(self, *args, **kwargs):
 
 class FakeAgent:
     """Minimal fake agent — carries timelapse_orchestrator."""
+
     def __init__(self, orchestrator):
         self.timelapse_orchestrator = orchestrator
 
@@ -177,8 +178,8 @@ def test_tool_is_registered():
 @pytest.mark.asyncio
 async def test_tool_refuses_during_active_timelapse():
     """If orchestrator._status == RUNNING, refuse without creating a task."""
-    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
     from gently.app.orchestration.timelapse_models import TimelapseStatus
+    from gently.app.tools.temperature_protocol_tools import run_temp_change_burst_protocol_tool
 
     context = _make_context(with_client=True, with_orchestrator=True)
     # Simulate an active timelapse
@@ -201,4 +202,6 @@ def fake_create_task(coro, **kwargs):
 
     assert len(created_tasks) == 0, "No task should be created when timelapse is running"
     assert "refusing" in result.lower(), f"Expected refusal message, got: {result!r}"
-    assert "timelapse" in result.lower(), f"Expected 'timelapse' in refusal message, got: {result!r}"
+    assert "timelapse" in result.lower(), (
+        f"Expected 'timelapse' in refusal message, got: {result!r}"
+    )
diff --git a/tests/test_temperature_event.py b/tests/test_temperature_event.py
index 388976aa..80e6601f 100644
--- a/tests/test_temperature_event.py
+++ b/tests/test_temperature_event.py
@@ -2,12 +2,12 @@
 Test suite for TEMPERATURE_UPDATE event type
 """
 
-from gently.core.event_bus import EventType, EventBus
+from gently.core.event_bus import EventBus, EventType
 
 
 def test_temperature_update_event_exists():
     """Verify TEMPERATURE_UPDATE enum member exists with correct name"""
-    assert hasattr(EventType, 'TEMPERATURE_UPDATE')
+    assert hasattr(EventType, "TEMPERATURE_UPDATE")
     event_type = EventType.TEMPERATURE_UPDATE
     assert event_type.name == "TEMPERATURE_UPDATE"
 
diff --git a/tests/test_temperature_route.py b/tests/test_temperature_route.py
index 4cd02cf3..5e71a9ea 100644
--- a/tests/test_temperature_route.py
+++ b/tests/test_temperature_route.py
@@ -1,26 +1,41 @@
-from unittest.mock import MagicMock
 from pathlib import Path
+from unittest.mock import MagicMock
+
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
+
 from gently.ui.web.routes.temperature import create_router
 
 
 def _server(samples, sessions=(("sess-1", True),)):
     store = MagicMock()
     store.list_sessions.return_value = [{"session_id": sid} for sid, _ in sessions]
-    store._session_dir.side_effect = lambda sid: Path("/x") if any(sid == s for s, _ in sessions) else None
+    store._session_dir.side_effect = lambda sid: (
+        Path("/x") if any(sid == s for s, _ in sessions) else None
+    )
     store.read_temperature_log.return_value = samples
-    srv = MagicMock(); srv.gently_store = store
+    srv = MagicMock()
+    srv.gently_store = store
     return srv, store
 
 
 def _client(server):
-    app = FastAPI(); app.include_router(create_router(server))
+    app = FastAPI()
+    app.include_router(create_router(server))
     return TestClient(app)
 
 
 def test_history_returns_samples():
-    srv, store = _server([{"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"}])
+    srv, store = _server(
+        [
+            {
+                "t": "2026-06-27T10:00:00+00:00",
+                "water_c": 28.0,
+                "setpoint_c": 32.0,
+                "state": "heating",
+            }
+        ]
+    )
     r = _client(srv).get("/api/temperature/sess-1/history")
     assert r.status_code == 200
     body = r.json()
diff --git a/tests/test_temperature_sampler.py b/tests/test_temperature_sampler.py
index 4c79bf76..8a221aef 100644
--- a/tests/test_temperature_sampler.py
+++ b/tests/test_temperature_sampler.py
@@ -5,11 +5,11 @@
 `file_store.create_session(name="s")` is adapted to
 `file_store.create_session(str(uuid.uuid4()), name="s")` to match the real API.
 """
-import asyncio
+
 import uuid
 
-from gently.core.event_bus import EventBus, EventType
 from gently.app.temperature_sampler import TemperatureSampler, temperature_stamp
+from gently.core.event_bus import EventBus, EventType
 
 
 class FakeScope:
@@ -32,7 +32,9 @@ def _capture(bus):
 
 async def test_tick_appends_emits_and_sets_latest(file_store):
     sid = file_store.create_session(str(uuid.uuid4()), name="s")
-    scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    scope = FakeScope(
+        {"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"}
+    )
     bus = EventBus()
     seen = _capture(bus)
     s = TemperatureSampler(scope, file_store, lambda: sid)
@@ -68,15 +70,22 @@ async def test_tick_poll_failure_is_a_gap_not_a_crash(file_store):
 
 def test_temperature_stamp_shapes():
     assert temperature_stamp(None) is None
-    assert temperature_stamp({"t": "2026-06-27T10:00:00+00:00", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"}) == {
-        "water_c": 28.4, "setpoint_c": 32.0, "state": "heating", "sampled_at": "2026-06-27T10:00:00+00:00",
+    assert temperature_stamp(
+        {"t": "2026-06-27T10:00:00+00:00", "water_c": 28.4, "setpoint_c": 32.0, "state": "heating"}
+    ) == {
+        "water_c": 28.4,
+        "setpoint_c": 32.0,
+        "state": "heating",
+        "sampled_at": "2026-06-27T10:00:00+00:00",
     }
 
 
 async def test_stale_latest_cleared_when_no_active_session(file_store):
     """After a successful tick, a subsequent tick with no active session resets latest to None."""
     sid = file_store.create_session(str(uuid.uuid4()), name="s")
-    scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    scope = FakeScope(
+        {"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"}
+    )
     bus = EventBus()
 
     # Successful first tick.
@@ -96,7 +105,9 @@ async def test_stale_latest_cleared_on_poll_failure(file_store):
     bus = EventBus()
 
     # Successful first tick.
-    good_scope = FakeScope({"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"})
+    good_scope = FakeScope(
+        {"success": True, "temperature_c": 28.4, "setpoint_c": 32.0, "state": "heating"}
+    )
     s = TemperatureSampler(good_scope, file_store, lambda: sid)
     await s._tick(bus)
     assert s.latest is not None
diff --git a/tests/test_temperature_sampler_wiring.py b/tests/test_temperature_sampler_wiring.py
index 9564d775..3eec8148 100644
--- a/tests/test_temperature_sampler_wiring.py
+++ b/tests/test_temperature_sampler_wiring.py
@@ -4,7 +4,6 @@
 heavy integration concern verified end-to-end in a later task.  DeviceStateMonitor's
 own wiring is likewise not unit-tested at this level.
 """
-from gently.app.temperature_sampler import TemperatureSampler
 
 
 def test_agent_initializes_temperature_sampler_attribute():
@@ -22,9 +21,5 @@ def test_agent_initializes_temperature_sampler_attribute():
         "Could not locate gently/app/agent.py via importlib"
     )
     text = Path(spec.origin).read_text(encoding="utf-8")
-    assert "temperature_sampler" in text, (
-        "agent.py has no 'temperature_sampler' attribute"
-    )
-    assert "TemperatureSampler(" in text, (
-        "agent.py never constructs a TemperatureSampler"
-    )
+    assert "temperature_sampler" in text, "agent.py has no 'temperature_sampler' attribute"
+    assert "TemperatureSampler(" in text, "agent.py never constructs a TemperatureSampler"
diff --git a/tests/test_temperature_stamp.py b/tests/test_temperature_stamp.py
index 4784880b..4b88fcdb 100644
--- a/tests/test_temperature_stamp.py
+++ b/tests/test_temperature_stamp.py
@@ -52,7 +52,9 @@ def test_volume_metadata_carries_temperature(file_store):
     tifffile_mock = MagicMock()
     with patch.dict(sys.modules, {"tifffile": tifffile_mock}):
         with patch.object(file_store, "_generate_projection", return_value=None):
-            file_store.put_volume(sid, emb, timepoint=0, volume=vol, metadata={"temperature": stamp})
+            file_store.put_volume(
+                sid, emb, timepoint=0, volume=vol, metadata={"temperature": stamp}
+            )
 
     meta = file_store.get_volume_meta(sid, emb, 0)
     assert meta["metadata"]["temperature"]["water_c"] == 28.4
@@ -77,9 +79,7 @@ def test_burst_stamp_writes_temperature(file_store):
     embryo.num_slices = 2
     embryo.exposure_ms = 50.0
 
-    frames_data = [
-        {"volume": np.zeros((2, 4, 4), dtype="uint16"), "acquired_at_epoch": None}
-    ]
+    frames_data = [{"volume": np.zeros((2, 4, 4), dtype="uint16"), "acquired_at_epoch": None}]
 
     tifffile_mock = MagicMock()
     with patch.dict(sys.modules, {"tifffile": tifffile_mock}):
diff --git a/tests/test_temperature_store.py b/tests/test_temperature_store.py
index 9e5d5fbe..dfc36fd9 100644
--- a/tests/test_temperature_store.py
+++ b/tests/test_temperature_store.py
@@ -1,12 +1,11 @@
 """Tests for FileStore temperature log methods."""
 
-import pytest
-
 
 def _new_session(file_store):
     """Create a test session and return its ID."""
     # Use UUID-based session ID for uniqueness
     import uuid
+
     session_id = str(uuid.uuid4())
     return file_store.create_session(session_id, name="temp-test")
 
@@ -14,8 +13,14 @@ def _new_session(file_store):
 def test_append_and_read_roundtrip(file_store):
     """Test appending and reading temperature samples."""
     sid = _new_session(file_store)
-    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"})
-    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.3, "setpoint_c": 32.0, "state": "heating"})
+    file_store.append_temperature_sample(
+        sid,
+        {"t": "2026-06-27T10:00:00+00:00", "water_c": 28.0, "setpoint_c": 32.0, "state": "heating"},
+    )
+    file_store.append_temperature_sample(
+        sid,
+        {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.3, "setpoint_c": 32.0, "state": "heating"},
+    )
     rows = file_store.read_temperature_log(sid)
     assert [r["water_c"] for r in rows] == [28.0, 28.3]
 
@@ -23,8 +28,12 @@ def test_append_and_read_roundtrip(file_store):
 def test_read_since_filters(file_store):
     """Test that read_temperature_log filters by since parameter."""
     sid = _new_session(file_store)
-    for i, t in enumerate(["2026-06-27T10:00:00+00:00", "2026-06-27T10:00:01+00:00", "2026-06-27T10:00:02+00:00"]):
-        file_store.append_temperature_sample(sid, {"t": t, "water_c": 28.0 + i, "setpoint_c": 32.0, "state": "heating"})
+    for i, t in enumerate(
+        ["2026-06-27T10:00:00+00:00", "2026-06-27T10:00:01+00:00", "2026-06-27T10:00:02+00:00"]
+    ):
+        file_store.append_temperature_sample(
+            sid, {"t": t, "water_c": 28.0 + i, "setpoint_c": 32.0, "state": "heating"}
+        )
     rows = file_store.read_temperature_log(sid, since="2026-06-27T10:00:01+00:00")
     assert [r["water_c"] for r in rows] == [29.0, 30.0]
 
@@ -36,16 +45,20 @@ def test_read_unknown_session_is_empty(file_store):
 
 def test_truncated_trailing_line_is_skipped(file_store, tmp_path):
     """A truncated trailing line (e.g. after a crash mid-append) is skipped gracefully."""
-    import uuid
 
     sid = _new_session(file_store)
 
     # Append two valid samples via the normal API.
-    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.1, "setpoint_c": 32.0, "state": "heating"})
-    file_store.append_temperature_sample(sid, {"t": "2026-06-27T10:00:02+00:00", "water_c": 28.2, "setpoint_c": 32.0, "state": "heating"})
+    file_store.append_temperature_sample(
+        sid,
+        {"t": "2026-06-27T10:00:01+00:00", "water_c": 28.1, "setpoint_c": 32.0, "state": "heating"},
+    )
+    file_store.append_temperature_sample(
+        sid,
+        {"t": "2026-06-27T10:00:02+00:00", "water_c": 28.2, "setpoint_c": 32.0, "state": "heating"},
+    )
 
     # Append a raw truncated line directly to the JSONL file.
-    from gently.core.file_store import FileStore
     # Locate the temperature.jsonl via the store's internal path.
     sd = file_store._session_dir(sid)
     log_path = sd / "temperature.jsonl"
diff --git a/tests/test_timelapse_start_route.py b/tests/test_timelapse_start_route.py
index 9f5c3c1b..7ef66140 100644
--- a/tests/test_timelapse_start_route.py
+++ b/tests/test_timelapse_start_route.py
@@ -14,7 +14,7 @@
   (mirroring the `require_timelapse_orchestrator(agent)` helper in harness/tools/helpers.py)
 """
 
-from unittest.mock import AsyncMock, MagicMock, patch
+from unittest.mock import AsyncMock, MagicMock
 
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
@@ -22,11 +22,11 @@
 import gently.ui.web.auth as auth
 from gently.ui.web.routes.data import create_router
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
 
+
 def _app(orchestrator=None):
     """Build a TestClient wired with the data routes.
 
@@ -56,6 +56,7 @@ def _make_orchestrator(start_return="Timelapse started."):
 # Happy path — minimal valid payload
 # ---------------------------------------------------------------------------
 
+
 def test_timelapse_start_minimal():
     """POST with just interval_seconds calls orchestrator.start; returns 200 with started=True."""
     orch = _make_orchestrator()
@@ -70,7 +71,8 @@ def test_timelapse_start_minimal():
 
 
 def test_timelapse_start_calls_start_with_correct_args():
-    """orchestrator.start receives the right interval, stop_condition, embryo_ids, condition_value."""
+    """orchestrator.start receives the right interval, stop_condition, embryo_ids,
+    condition_value."""
     orch = _make_orchestrator()
     _app(orch).post(
         "/api/devices/timelapse/start",
@@ -115,6 +117,7 @@ def test_timelapse_start_result_in_response():
 # Monitoring mode
 # ---------------------------------------------------------------------------
 
+
 def test_timelapse_start_enables_monitoring_mode():
     """monitoring_mode != 'idle' triggers enable_monitoring_mode on the orchestrator."""
     orch = _make_orchestrator()
@@ -149,6 +152,7 @@ def test_timelapse_start_no_mode_skips_enable():
 # Volume geometry passed through in response config
 # ---------------------------------------------------------------------------
 
+
 def test_timelapse_start_volume_geometry_in_config():
     """Volume geometry fields appear in response['config']['volume_geometry']."""
     orch = _make_orchestrator()
@@ -176,6 +180,7 @@ def test_timelapse_start_volume_geometry_in_config():
 # 400 — validation failures
 # ---------------------------------------------------------------------------
 
+
 def test_timelapse_start_interval_zero_returns_400():
     """interval_seconds = 0 → 400."""
     orch = _make_orchestrator()
@@ -232,6 +237,7 @@ def test_timelapse_start_non_numeric_interval_returns_400():
 # 503 — orchestrator not reachable
 # ---------------------------------------------------------------------------
 
+
 def test_timelapse_start_no_orchestrator_returns_503():
     """orchestrator is None (agent not running / no session) → 503."""
     r = _app(orchestrator=None).post(
@@ -258,6 +264,7 @@ def test_timelapse_start_no_agent_bridge_returns_503():
 # require_control gate
 # ---------------------------------------------------------------------------
 
+
 def test_timelapse_start_requires_control():
     """POST /api/devices/timelapse/start is gated by require_control (403 without override)."""
     orch = _make_orchestrator()
diff --git a/tests/test_tool_tactic_linkage.py b/tests/test_tool_tactic_linkage.py
index 6b56fa47..f6ec653a 100644
--- a/tests/test_tool_tactic_linkage.py
+++ b/tests/test_tool_tactic_linkage.py
@@ -16,8 +16,8 @@
 """
 
 import asyncio
-import pytest
 
+import pytest
 
 # ---------------------------------------------------------------------------
 # Fakes
@@ -82,6 +82,7 @@ def __init__(self, *, cs=None, session_id="sess_t7", orchestrator=None):
 
 class FakeMicroscope:
     """Satisfies the requires_microscope client check in the tool registry."""
+
     pass
 
 
@@ -115,9 +116,9 @@ async def test_enable_monitoring_mode_with_tactic_id_calls_transition():
     )
 
     assert cs is not None
-    assert any(
-        t == ("sess_t7", "t1", "active") for t in cs.transitions
-    ), f"Expected transition ('sess_t7', 't1', 'active'), got {cs.transitions}"
+    assert any(t == ("sess_t7", "t1", "active") for t in cs.transitions), (
+        f"Expected transition ('sess_t7', 't1', 'active'), got {cs.transitions}"
+    )
 
 
 @pytest.mark.asyncio
@@ -157,9 +158,9 @@ async def test_queue_burst_with_tactic_id_calls_transition():
     agent, cs, _orch = _make_agent()
     await queue_burst(embryo_id="emb1", tactic_id="t2", context=_ctx(agent, with_client=True))
 
-    assert any(
-        t == ("sess_t7", "t2", "active") for t in cs.transitions
-    ), f"Expected transition ('sess_t7', 't2', 'active'), got {cs.transitions}"
+    assert any(t == ("sess_t7", "t2", "active") for t in cs.transitions), (
+        f"Expected transition ('sess_t7', 't2', 'active'), got {cs.transitions}"
+    )
 
 
 @pytest.mark.asyncio
@@ -197,8 +198,17 @@ async def test_queue_burst_soft_reject_does_not_transition():
     from gently.app.tools.timelapse_tools import queue_burst
 
     class RejectingOrchestrator(FakeOrchestrator):
-        def queue_burst(self, embryo_id, *, frames=60, mode="1hz", num_slices=1,
-                        force=False, laser_config=None, tactic_id=None) -> str:
+        def queue_burst(
+            self,
+            embryo_id,
+            *,
+            frames=60,
+            mode="1hz",
+            num_slices=1,
+            force=False,
+            laser_config=None,
+            tactic_id=None,
+        ) -> str:
             # Simulates "already has a queued burst" soft-reject
             return f"Embryo '{embryo_id}' already has a queued burst."
 
@@ -226,9 +236,9 @@ async def test_stop_timelapse_with_tactic_id_calls_done():
     agent, cs, _orch = _make_agent()
     await stop_timelapse(tactic_id="t1", context=_ctx(agent, with_client=True))
 
-    assert any(
-        t == ("sess_t7", "t1", "done") for t in cs.transitions
-    ), f"Expected transition to done, got {cs.transitions}"
+    assert any(t == ("sess_t7", "t1", "done") for t in cs.transitions), (
+        f"Expected transition to done, got {cs.transitions}"
+    )
 
 
 @pytest.mark.asyncio
@@ -255,9 +265,9 @@ async def test_pause_timelapse_with_tactic_id_calls_paused():
     agent, cs, _orch = _make_agent()
     await pause_timelapse(tactic_id="t1", context=_ctx(agent, with_client=True))
 
-    assert any(
-        t == ("sess_t7", "t1", "paused") for t in cs.transitions
-    ), f"Expected transition to paused, got {cs.transitions}"
+    assert any(t == ("sess_t7", "t1", "paused") for t in cs.transitions), (
+        f"Expected transition to paused, got {cs.transitions}"
+    )
 
 
 @pytest.mark.asyncio
@@ -295,7 +305,6 @@ def test_burst_acquisition_default_tactic_id_none():
 def test_burst_start_event_data_contains_tactic_id():
     """The BURST_START event data dict includes tactic_id."""
     from gently.app.orchestration.exclusive import BurstAcquisition
-    from gently.core import EventType
 
     emitted: list[dict] = []
 
@@ -356,7 +365,7 @@ def _emit_event(self, event_type, data):
         loop.close()
 
     burst_starts = [(et, d) for et, d in emitted if et == EventType.BURST_START]
-    assert burst_starts, f"BURST_START not emitted; all events: {[et for et,_ in emitted]}"
+    assert burst_starts, f"BURST_START not emitted; all events: {[et for et, _ in emitted]}"
     _et, data = burst_starts[0]
     assert "tactic_id" in data, f"tactic_id not in BURST_START data: {data}"
     assert data["tactic_id"] == "t3"
@@ -395,7 +404,7 @@ def _emit_event(self, event_type, data):
         loop.close()
 
     burst_completes = [(et, d) for et, d in emitted if et == EventType.BURST_COMPLETE]
-    assert burst_completes, f"BURST_COMPLETE not emitted; all events: {[et for et,_ in emitted]}"
+    assert burst_completes, f"BURST_COMPLETE not emitted; all events: {[et for et, _ in emitted]}"
     _et, data = burst_completes[0]
     assert "tactic_id" in data, f"tactic_id not in BURST_COMPLETE data: {data}"
     assert data["tactic_id"] == "t3"
@@ -436,9 +445,9 @@ class FakeClient:
         context=ctx,
     )
 
-    assert any(
-        t == ("sess_t7", "t4", "active") for t in cs.transitions
-    ), f"Expected active transition, got {cs.transitions}"
+    assert any(t == ("sess_t7", "t4", "active") for t in cs.transitions), (
+        f"Expected active transition, got {cs.transitions}"
+    )
 
 
 @pytest.mark.asyncio
@@ -486,9 +495,15 @@ async def test_temp_protocol_started_event_carries_tactic_id():
     emitted: list[tuple] = []
 
     class FakeClient:
-        async def set_laser_config(self, cfg): pass
-        async def set_led(self, s): pass
-        async def set_temperature(self, t): pass
+        async def set_laser_config(self, cfg):
+            pass
+
+        async def set_led(self, s):
+            pass
+
+        async def set_temperature(self, t):
+            pass
+
         async def get_temperature(self):
             return {"state": "LOCKED"}
 
@@ -504,8 +519,11 @@ async def fake_burst_runner(b):
         bursts_run.append(b._phase)
 
     await run_temp_change_burst_protocol(
-        FakeOrc(), "emb1", 25.0,
-        bursts_before=0, bursts_after=0,
+        FakeOrc(),
+        "emb1",
+        25.0,
+        bursts_before=0,
+        bursts_after=0,
         burst_runner=fake_burst_runner,
         tactic_id="t5",
     )
@@ -524,9 +542,15 @@ async def test_temp_protocol_completed_event_carries_tactic_id():
     emitted: list[tuple] = []
 
     class FakeClient:
-        async def set_laser_config(self, cfg): pass
-        async def set_led(self, s): pass
-        async def set_temperature(self, t): pass
+        async def set_laser_config(self, cfg):
+            pass
+
+        async def set_led(self, s):
+            pass
+
+        async def set_temperature(self, t):
+            pass
+
         async def get_temperature(self):
             return {"state": "LOCKED"}
 
@@ -537,8 +561,11 @@ def _emit_event(self, event_type, data):
             emitted.append((event_type, data))
 
     await run_temp_change_burst_protocol(
-        FakeOrc(), "emb1", 25.0,
-        bursts_before=0, bursts_after=0,
+        FakeOrc(),
+        "emb1",
+        25.0,
+        bursts_before=0,
+        bursts_after=0,
         burst_runner=lambda b: asyncio.sleep(0),
         tactic_id="t5",
     )
@@ -557,9 +584,15 @@ async def test_temp_protocol_tactic_id_none_when_absent():
     emitted: list[tuple] = []
 
     class FakeClient:
-        async def set_laser_config(self, cfg): pass
-        async def set_led(self, s): pass
-        async def set_temperature(self, t): pass
+        async def set_laser_config(self, cfg):
+            pass
+
+        async def set_led(self, s):
+            pass
+
+        async def set_temperature(self, t):
+            pass
+
         async def get_temperature(self):
             return {"state": "LOCKED"}
 
@@ -570,8 +603,11 @@ def _emit_event(self, event_type, data):
             emitted.append((event_type, data))
 
     await run_temp_change_burst_protocol(
-        FakeOrc(), "emb1", 25.0,
-        bursts_before=0, bursts_after=0,
+        FakeOrc(),
+        "emb1",
+        25.0,
+        bursts_before=0,
+        bursts_after=0,
         burst_runner=lambda b: asyncio.sleep(0),
     )
 
diff --git a/tests/test_transition_tactic.py b/tests/test_transition_tactic.py
index 5b72648a..0064b8f3 100644
--- a/tests/test_transition_tactic.py
+++ b/tests/test_transition_tactic.py
@@ -5,10 +5,8 @@
 True/False return values, no-op on missing plan or tactic.
 """
 
-import pytest
 from gently.core.event_bus import EventType, on
 
-
 # ---------------------------------------------------------------------------
 # Plan fixture shared across tests
 # ---------------------------------------------------------------------------
@@ -49,6 +47,7 @@
 def _fresh_plan():
     """Deep-copy the fixture so mutations don't bleed between tests."""
     import copy
+
     return copy.deepcopy(_PLAN)
 
 
diff --git a/tests/test_wait_for_lock.py b/tests/test_wait_for_lock.py
index 6ee8fbe3..c8d7f854 100644
--- a/tests/test_wait_for_lock.py
+++ b/tests/test_wait_for_lock.py
@@ -1,15 +1,22 @@
 from gently.app.orchestration.temperature_protocol import wait_for_temperature_lock
 
+
 class FakeClient:
-    def __init__(self, states): self.states = list(states); self.calls = 0
+    def __init__(self, states):
+        self.states = list(states)
+        self.calls = 0
+
     async def get_temperature(self):
-        i = min(self.calls, len(self.states) - 1); self.calls += 1
+        i = min(self.calls, len(self.states) - 1)
+        self.calls += 1
         return {"state": self.states[i]}
 
+
 async def test_returns_true_when_locked():
     c = FakeClient(["[ IDLE ]", "[ HEATING ]", "[ SYSTEM LOCKED ]"])
     assert await wait_for_temperature_lock(c, timeout_s=5.0, poll_s=0.001) is True
 
+
 async def test_returns_false_on_timeout():
     c = FakeClient(["[ HEATING ]"])
     assert await wait_for_temperature_lock(c, timeout_s=0.02, poll_s=0.001) is False

From e2b03c586a4deb19a271cea6286afcd8ae9e181e Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 13:07:03 +0530
Subject: [PATCH 257/314] fix(tests): annotate test-stub Optionals for mypy

---
 tests/test_lightsheet_side_param.py | 6 +++---
 tests/test_tool_tactic_linkage.py   | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/test_lightsheet_side_param.py b/tests/test_lightsheet_side_param.py
index 67751637..3f276b76 100644
--- a/tests/test_lightsheet_side_param.py
+++ b/tests/test_lightsheet_side_param.py
@@ -91,7 +91,7 @@ class FakeScanner:
     def __init__(self, name: str):
         self.name = name
         self.sa_offset_y = FakeAxisOffset()
-        self.spim_state = None
+        self.spim_state: str | None = None
 
     def set_spim_state(self, state: str) -> None:
         self.spim_state = state
@@ -102,8 +102,8 @@ class FakePiezo:
 
     def __init__(self, name: str):
         self.name = name
-        self.last_pos = None
-        self.spim_state = None
+        self.last_pos: float | None = None
+        self.spim_state: str | None = None
 
     def setPosition(self, val: float) -> None:
         self.last_pos = val
diff --git a/tests/test_tool_tactic_linkage.py b/tests/test_tool_tactic_linkage.py
index f6ec653a..7b260bdb 100644
--- a/tests/test_tool_tactic_linkage.py
+++ b/tests/test_tool_tactic_linkage.py
@@ -30,7 +30,7 @@ class FakeContextStore:
     def __init__(self):
         self.transitions: list[tuple] = []
 
-    def transition_tactic(self, session_id: str, tactic_id: str, state: str = None, **bind):
+    def transition_tactic(self, session_id: str, tactic_id: str, state: str | None = None, **bind):
         self.transitions.append((session_id, tactic_id, state))
         return True
 

From deaaffa971cd599c8c311ea903645bbf82c406e4 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 15:51:35 +0530
Subject: [PATCH 258/314] feat(launch): --no-auth flag + quiet
 temperature-sampler backoff when disconnected

---
 gently/app/temperature_sampler.py | 18 ++++++++++++++++--
 launch_gently.py                  | 18 ++++++++++++++++--
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/gently/app/temperature_sampler.py b/gently/app/temperature_sampler.py
index 0995d1f2..3e02ba8c 100644
--- a/gently/app/temperature_sampler.py
+++ b/gently/app/temperature_sampler.py
@@ -59,14 +59,28 @@ async def on_stop(self) -> None:
 
     async def _run(self) -> None:
         bus = get_event_bus()
+        fail_streak = 0
         while True:
             try:
                 await self._tick(bus)
+                if fail_streak:
+                    logger.info(
+                        "temperature sampler recovered after %d quiet failure(s)", fail_streak
+                    )
+                    fail_streak = 0
             except asyncio.CancelledError:
                 raise
             except Exception as exc:  # a gap, never a crash
-                logger.warning("temperature sampler tick failed: %s", exc)
-            await asyncio.sleep(self._interval)
+                fail_streak += 1
+                if fail_streak == 1:
+                    # Log once, then stay quiet (e.g. device layer not connected yet).
+                    logger.warning(
+                        "temperature sampler paused — %s (retrying quietly until connected)", exc
+                    )
+            # Back off while failing so we neither spam logs nor hammer a disconnected server.
+            await asyncio.sleep(
+                self._interval if fail_streak == 0 else min(self._interval * 10, 30.0)
+            )
 
     async def _tick(self, bus) -> None:
         session_id = self._session_id_getter()
diff --git a/launch_gently.py b/launch_gently.py
index 64efdc15..4aad5bda 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -231,6 +231,7 @@ async def main(
     log_level: str = "WARNING",
     no_browser: bool = False,
     no_api: bool = False,
+    no_auth: bool = False,
 ):
     # Set up log file in storage directory
     # Unified with FileStore: logs live under the same root as data
@@ -272,9 +273,16 @@ async def main(
     # ── Accounts / auth ───────────────────────────────────────────
     # Self-managed user accounts gate microscope control on the LAN. On first
     # run we bootstrap an admin and print its one-time password in the banner.
-    # Set GENTLY_NO_AUTH=1 to disable accounts (legacy localhost-control mode).
+    # Pass --no-auth (or set GENTLY_NO_AUTH=1) to disable accounts (localhost-control mode).
     admin_creds = None
-    if os.environ.get("GENTLY_NO_AUTH", "").strip().lower() not in ("1", "true", "yes"):
+    auth_disabled = no_auth or os.environ.get("GENTLY_NO_AUTH", "").strip().lower() in (
+        "1",
+        "true",
+        "yes",
+    )
+    if auth_disabled:
+        logger.warning("Accounts disabled (--no-auth) — control is open on this host")
+    if not auth_disabled:
         try:
             from gently.ui.web.accounts import AccountStore, set_account_store
 
@@ -647,6 +655,11 @@ def cli_main():
         "-v", "--verbose", action="store_true", help="Enable verbose (INFO) logging"
     )
     parser.add_argument("--debug", action="store_true", help="Enable debug logging (most verbose)")
+    parser.add_argument(
+        "--no-auth",
+        action="store_true",
+        help="Disable accounts/login (localhost-control mode; same as GENTLY_NO_AUTH=1)",
+    )
     parser.add_argument(
         "--no-browser",
         action="store_true",
@@ -684,6 +697,7 @@ def cli_main():
                 log_level=log_level,
                 no_browser=args.no_browser,
                 no_api=args.no_api,
+                no_auth=args.no_auth,
             )
         )
     except (KeyboardInterrupt, RuntimeError, SystemExit):

From c50cab0789e0c5ae2db0dc7cbd2e513b7560e7ea Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 16:36:30 +0530
Subject: [PATCH 259/314] docs: document --no-auth launch flag in README

---
 README.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 78039e70..924f92cb 100644
--- a/README.md
+++ b/README.md
@@ -167,6 +167,9 @@ uv run python launch_gently.py --no-api
 # Don't auto-open a browser — open the printed URL yourself
 uv run python launch_gently.py --no-browser
 
+# Skip login — disable accounts (localhost-control mode; same as GENTLY_NO_AUTH=1)
+uv run python launch_gently.py --no-auth
+
 # Resume a previous session
 uv run python launch_gently.py --resume            # interactive picker
 uv run python launch_gently.py --resume latest     # most recent session
@@ -203,8 +206,9 @@ First-run admin account created — sign in at the URL above:
 - **Lost it?** There's no reset command yet — delete
   `<GENTLY_STORAGE_PATH>/auth/users.yaml` and restart to bootstrap a fresh
   `admin` (this clears all accounts).
-- **Just trying it locally?** `GENTLY_NO_AUTH=1` disables accounts entirely
-  (legacy mode: localhost gets control, remote callers need `X-Gently-Token`).
+- **Just trying it locally?** Launch with `--no-auth` (or set `GENTLY_NO_AUTH=1`)
+  to disable accounts entirely (localhost gets control, remote callers need
+  `X-Gently-Token`). Handy if you've lost the admin password.
 
 Accounts live under `<GENTLY_STORAGE_PATH>/auth/` (`users.yaml` + `secret.key`),
 outside the repo.

From 3a85449f591bd5d316324a243bcd40d8540460ea Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 17:55:45 +0530
Subject: [PATCH 260/314] fix(chat): ask renders main-stage only +
 waiting-for-answer state (not working spinner)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Under ux_v2 (#ask-stage present), renderChoice() now emits AGENT_ASK to the
main stage (AskStage) and inserts a compact '↑ Gently is asking — answer above'
pointer in the chat transcript instead of full duplicate choice cards. The
buildAskCard() full-card path is preserved for v1 (no #ask-stage).

When choice_request arrives, setAskState(true) removes ac-busy from the Send
button, hides the Stop button, and changes the input placeholder to invite an
answer rather than imply queuing. setAskState(false) restores working-state
visuals when the ask is answered (from either surface) or the turn ends.

Also suppresses the spinning ask_user_choice tool_start row in the transcript
(choice_request follows and is the real signal).
---
 gently/ui/web/static/css/agent-chat.css |  11 +++++++++++
 gently/ui/web/static/js/agent-chat.js   | Bin 63846 -> 66583 bytes
 2 files changed, 11 insertions(+)

diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index 29d64646..106d79bd 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -271,6 +271,17 @@ body.chat-docked .agent-chat:not(.open) {
 .ac-level-warning { color: var(--accent-orange, #fb923c); }
 .ac-level-success { color: var(--accent-green); }
 
+/* ── Ask pointer (ux_v2) ─────────────────────────────────── */
+/* Compact transcript reference shown instead of full ask cards when the main
+   stage (AskStage / #ask-stage) owns the answer surface. */
+.ac-ask-pointer {
+    align-self: center;
+    font-size: 11.5px; color: var(--text-muted);
+    text-align: center; font-style: italic;
+    opacity: 0.75;
+}
+.ac-ask-pointer-answered { opacity: 0.35; }
+
 /* ── Choice picker ──────────────────────────────────────── */
 .ac-choice {
     display: flex; flex-direction: column; gap: 7px;
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 58be6e5c13b417fd95d0f16b42ae953a0a0c3467..6e77219453fbde51392f6358deebf02032907ac1 100644
GIT binary patch
delta 2003
zcmZuyUuYaf7^h7!HI<UYOIs5OUmEakG1-s?sTi)3#8R(lqWNP*k#uf%?rylf-F0U+
z*Qm**wx};!bp-LDQ2O9QQn7HLAR>ql;zL0}6pQ!})E9lqiy#Po-`w8iV!fBU+u8Z%
z`+ooC_nnUS-#Bpdht9K1mY?FjEBqp4p};)JC!z5f8v|D4z5*d3WU=HfRGCopW+8|G
zA4F*hxF47=t30aT>im0tns&+ZGOaE<r9e0wBCO9NdKDNX&m0!Hup*lOmm~gS%%y_u
zjra8VUs4%a79pq-2R{&U6=W!UpH5am;6W5rO$$QV`pccZ;fgHUw6N^63Wsbq3+ey#
zkk(fpyia#Oe^>q1b6?#vA-S58<psqQ&!{No7S4=~H^&QnGu;RtuAmx3WjwiFD_%)G
z)V|SxmF$eTjPdB?-BC%EaXc9#pk4ZHK3+fh%BTBt1T3C2<;eiCb~!jfC1j3*Fc7{X
zj56_s<&_gq32+gyzz!fED;4+>M+a9(miM@2>(AG$`*Ft6WMkU0k(1NRDP=+xLH3kp
zJ4bbDy{7~JYHR((5PsW^$E18hNM$qE&7_$#+E$|e&H6~kA=6!ztxBlqH(wp-Z@^UK
zFa{oL$fPP>Lh>wq{?~auc&SiZB6gwCcV?I>;`q2DL{LyZ)`;P;!h{cvg`i5)Ah(6s
z^NfI&a&}juI>Kk3haN-W&^vA%dcq+%jbyM0J#|V<fr?Og&P*giWJ#zJscSEu?L`rC
z+9~5G3gX5jPJp0aP>|8rz8*MZQF}Oe#F<Mdw{J!cl5>rso0Kq=c3Ocf;YgsWD0aI`
z@B6k-=eB#gnn0v2UF$t!i1<#~<1Hd)jaX5tduT{cw$3F)h`#Rwm`Q%y)b9+njlM*g
zZ@=~qoWbATD!CM~Cy$VB8kPi>4_0_mQrAu$>%w|g;{^Tm?4X`~;h?^Gx!*?6SH_WJ
zKk!EllaC~>ZE$3uNBibEs*KzE&x_aUmoI(rz*$j%%#cZm=~%8>)WMx;g2h!F`9Lw?
zn(jy$$}rz>3Yxc`+Wc#O?OaKC9Gf?5lsic@5p%6Dnw?v0I?YrQ3Ues$1x^{uC*Cz6
z;=#fXV`anK3XdXzo}xm>6Pq4~r5sdPR3_sY0o71J%&WA5poFf3bGgOG=av?m6;XPA
zkzj6(4H?X?m>x-9VZIWMG*ZID6`FezdqRGaG$85vMYOP~SBQN_3GBHMEVTs_Nl6Y_
z@N!EFdw@;Wca=gk{Ldy54O-BhR(_lJBVIvK82jguv~;2edRc$AIjqxH59^<Qx?AUN
zST)ku;%eBS#H2i6^oPQs(1##2y&I8jZ+zG$-8JBNlK}PAf~kERI?NbdDil<c&Aqva
zVw|fQ!f<#f8ToNkhG~PlyNN-??i{ljaqTnePc|PuOb-@<IKqG#%4YRji%0a6H@fx2
zM6dqidP={(m3epgfc|)EmcIVkn$!augZj$tPF;EQV7>pNFHY+GPVZ6D%~aA#Cb_+q
zg{!BYz4tUumMgRxg+dfm%p7eQn3*#74+>!fowf%B(vCut;mvkzmv&62wo6N2{4up}
SP4_(3r>)zE>fOIRllm7Wf4KJm

delta 156
zcmV;N0Av4`hy>>H1F+TyvndGiQj>rq2D9&5!wi#eX$G_WXm}K}v3=kIlkC0-v&w=0
z0+We|mqATwa&m8SAa8DTZy<DNWgu-~X>K5MbYW*@AShvTYb|qhVP|D7YI7iRWo~3;
za&sVQbRckYZ*6IAWo~qAc_}WFzr$XWXoXp`Ac>hKvkb8A0+SFt2a~`*2(uu!zBiNb
K?ijP7?{*Y5Aw)d@


From e9900c3db693e4f2a39bc29dd0ffe8423a4e6a11 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 18:15:46 +0530
Subject: [PATCH 261/314] feat(operations): expandable spine tactic cards
 (rationale/scope/structure/relations) + scope chip
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Click-to-expand for queued/done/paused tactic cards reveals the
agent-authored detail hidden behind the minimal header: rationale,
scope (resolved text), structure (cadence/phases/frames), and
relations ("runs after: <name>" resolved from tactic IDs).

A compact scope chip is always visible on collapsed headers —
global/embryo (neutral) or role-scoped (role color from /api/roles).
Active tactic bloom is untouched; no expand attributes on active cards.

Expand state keyed by t.id survives debounced re-renders (_expandedTacticIds Set).
CSS: .ops-scope-chip, .ops-expand-body/.hidden, .ops-expand-chevron(.open),
.ops-expand-row/.key/.val, .ops-expand-phase, cursor affordance on expandable cards.
node --check passes. Harness verified in scratchpad/spinecards/.
---
 gently/ui/web/static/css/experiment.css       | 154 ++++++++++++++
 .../ui/web/static/js/experiment-overview.js   | 194 +++++++++++++++++-
 2 files changed, 341 insertions(+), 7 deletions(-)

diff --git a/gently/ui/web/static/css/experiment.css b/gently/ui/web/static/css/experiment.css
index 770be5a7..ee40cddd 100644
--- a/gently/ui/web/static/css/experiment.css
+++ b/gently/ui/web/static/css/experiment.css
@@ -1458,6 +1458,160 @@
 }
 /* Role-scoped badges use inline style (color/bg/border from /api/roles) */
 
+/* ============================================================
+   Expandable tactic detail — click-to-expand for queued/done/paused
+   (G — spine-cards)
+   ============================================================ */
+
+/* Compact inline scope chip — always visible in collapsed header.
+   Distinct from .ops-scope-badge (which resolves embryo ids and is full-width).
+   Role-scoped chips use inline style for color/bg/border from /api/roles. */
+.ops-scope-chip {
+    display: inline-flex;
+    align-items: center;
+    padding: 1px 7px;
+    border-radius: 9px;
+    font-family: var(--ops-mono);
+    font-size: 9.5px;
+    font-weight: 600;
+    border: 1px solid transparent;
+    text-transform: lowercase;
+    letter-spacing: 0.02em;
+    white-space: nowrap;
+    flex-shrink: 0;
+}
+/* Neutral global/embryos variant */
+.ops-scope-chip.ops-scope-global {
+    background: rgba(139, 148, 158, 0.12);
+    color: var(--text-muted);
+    border-color: rgba(139, 148, 158, 0.25);
+}
+
+/* Cursor affordance on the card itself */
+.ops-card[data-tactic-expand-id] {
+    cursor: pointer;
+    transition: border-color 0.15s;
+}
+.ops-node.planned .ops-card[data-tactic-expand-id]:hover {
+    border-color: rgba(90, 169, 230, 0.5);
+}
+.ops-node.done .ops-card[data-tactic-expand-id]:hover {
+    border-color: rgba(52, 211, 153, 0.4);
+}
+.ops-node.paused .ops-card[data-tactic-expand-id]:hover {
+    border-color: rgba(139, 148, 158, 0.45);
+}
+
+/* Chevron toggle — pushes to the right edge of the header row */
+.ops-expand-chevron {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 20px;
+    height: 20px;
+    margin-left: auto;
+    flex-shrink: 0;
+    background: none;
+    border: none;
+    color: var(--text-muted);
+    font-size: 15px;
+    cursor: pointer;
+    transition: transform 0.2s ease, color 0.15s;
+    padding: 0;
+    line-height: 1;
+    opacity: 0.6;
+}
+.ops-expand-chevron.open {
+    transform: rotate(90deg);
+    color: var(--text);
+    opacity: 1;
+}
+.ops-card[data-tactic-expand-id]:hover .ops-expand-chevron {
+    opacity: 1;
+}
+
+/* Expand body — hidden/visible via JS toggling .hidden */
+.ops-expand-body {
+    margin-top: 10px;
+}
+.ops-expand-body.hidden {
+    display: none;
+}
+
+/* Hairline rule separating header from expand detail */
+.ops-expand-rule {
+    border: none;
+    border-top: 1px solid rgba(139, 148, 158, 0.15);
+    margin: 8px 0 10px;
+}
+
+/* Key/value rows */
+.ops-expand-row {
+    display: flex;
+    align-items: flex-start;
+    gap: 10px;
+    margin-bottom: 6px;
+    font-family: var(--ops-mono);
+    font-size: 11px;
+    line-height: 1.45;
+}
+
+.ops-expand-key {
+    flex: 0 0 76px;
+    text-transform: uppercase;
+    font-size: 9px;
+    letter-spacing: 0.12em;
+    color: var(--text-muted);
+    margin-top: 1px;
+    opacity: 0.7;
+}
+
+.ops-expand-val {
+    flex: 1;
+    color: var(--text);
+    word-break: break-word;
+}
+
+.ops-expand-mono {
+    font-variant-numeric: tabular-nums;
+}
+
+/* Phase chain: ramp → hold */
+.ops-expand-phases {
+    display: inline-flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: 4px;
+}
+
+.ops-expand-phase {
+    display: inline-block;
+    padding: 1px 7px;
+    border-radius: 6px;
+    background: rgba(139, 148, 158, 0.1);
+    border: 1px solid rgba(139, 148, 158, 0.2);
+    color: var(--text-muted);
+    font-size: 10px;
+    text-transform: lowercase;
+}
+
+.ops-expand-arrow {
+    color: var(--text-muted);
+    font-size: 10px;
+    opacity: 0.45;
+}
+
+/* Readouts strip inside the expand body — inherits ops-gauge, slightly muted */
+.ops-expand-readouts {
+    display: flex;
+    gap: 8px;
+    flex-wrap: wrap;
+    margin-top: 8px;
+}
+.ops-expand-readouts .ops-gauge {
+    opacity: 0.85;
+}
+
 /* ============================================================
    Linked-plans panel (ops-lp-*) — F / Task 4
    Session ↔ plan-item link/delink from the Operations view.
diff --git a/gently/ui/web/static/js/experiment-overview.js b/gently/ui/web/static/js/experiment-overview.js
index 5d7fb958..a5be6444 100644
--- a/gently/ui/web/static/js/experiment-overview.js
+++ b/gently/ui/web/static/js/experiment-overview.js
@@ -24,6 +24,7 @@ const ExperimentOverview = {
     _currentSessionId: null, // session_id from /api/operation_plan/current (always, even idle)
     _planPickerOpen: false,  // whether the plan-link picker is visible
     _pickerItems: null,      // flat plan items for the picker (null=not loaded)
+    _expandedTacticIds: new Set(), // tactic expand-keys for click-to-expand (survives refresh)
 
     async init() {
         console.log('[ExperimentOverview] init() called, view=', this.activeView);
@@ -647,7 +648,7 @@ const ExperimentOverview = {
             : '';
 
         const spineNodes = tactics
-            .map((t, idx) => this._renderOpsTactic(t, idx, firstPlannedIdx, ESC, rosterCtx))
+            .map((t, idx) => this._renderOpsTactic(t, idx, firstPlannedIdx, ESC, rosterCtx, tactics))
             .join('');
 
         root.innerHTML = `
@@ -664,11 +665,13 @@ const ExperimentOverview = {
                 ${spineLabel}
                 <div class="ops-spine">${spineNodes}</div>
             </div>`;
+        this._wireSpineExpand(root);
     },
 
     // Render a single tactic node.
     // rosterCtx = { embryos, rolesMap } | null — when present, adds role-scope badge (D2).
-    _renderOpsTactic(t, idx, firstPlannedIdx, ESC, rosterCtx = null) {
+    // tactics = full tactics array — used to resolve relation ids to names.
+    _renderOpsTactic(t, idx, firstPlannedIdx, ESC, rosterCtx = null, tactics = []) {
         const STATE_LABEL = { done: 'done', active: 'in use', planned: 'queued', paused: 'paused' };
         const seq = String(t.seq || idx + 1).padStart(2, '0');
         const stateLabel = STATE_LABEL[t.state] || t.state;
@@ -683,18 +686,27 @@ const ExperimentOverview = {
         const summary = live.summary || '';
         const desc = live.desc || '';
 
-        // Scope badge — D2: shows role → embryo-ids when roster context is available.
-        const scopeBadge = rosterCtx
-            ? this._renderOpsScopeBadge(t.scope, rosterCtx.embryos, rosterCtx.rolesMap, ESC)
+        // Scope chip/badge — compact chip for planned/done/paused (always visible, no embryo
+        // list needed); full badge with embryo resolution for active state (D2 roster lens).
+        const isExpandable = (t.state === 'planned' || t.state === 'done' || t.state === 'paused');
+        const expandKey    = this._tacticExpandKey(t);
+        const scopeBadge = isExpandable
+            ? this._renderOpsScopeChip(t.scope, ESC)
+            : (rosterCtx ? this._renderOpsScopeBadge(t.scope, rosterCtx.embryos, rosterCtx.rolesMap, ESC) : '');
+
+        // Chevron toggle — only for expandable (planned / done / paused) tactics.
+        const chevron = isExpandable
+            ? `<button class="ops-expand-chevron${this._expandedTacticIds.has(expandKey) ? ' open' : ''}" aria-label="Toggle tactic details" title="Toggle details">›</button>`
             : '';
 
-        // Header row: name · target · scope badge · summary
+        // Header row: name · target · scope badge · summary · chevron
         let inner = `
             <div class="ops-row">
                 <span class="ops-tname">${ESC(t.name)}</span>
                 ${target ? `<span class="ops-target">${ESC(target)}</span>` : ''}
                 ${scopeBadge}
                 ${summary ? `<span class="ops-tsum">${ESC(summary)}</span>` : ''}
+                ${chevron}
             </div>
             ${desc ? `<div class="ops-desc">${ESC(desc)}</div>` : ''}`;
 
@@ -712,6 +724,7 @@ const ExperimentOverview = {
             inner += this._renderOpsKindActive(t, live, ESC);
         } else if (t.state === 'planned') {
             inner += this._renderOpsKindPlanned(t, ESC);
+            inner += this._renderOpsExpandBody(t, ESC, tactics);
         }
 
         // Fix #1: surface flat live.* telemetry keys not covered by structured
@@ -731,13 +744,180 @@ const ExperimentOverview = {
             }
         }
 
+        // Expand body for done + paused tactics (appended after live-facts).
+        if (t.state === 'done' || t.state === 'paused') {
+            inner += this._renderOpsExpandBody(t, ESC, tactics);
+        }
+
+        const cardExpandAttr = isExpandable
+            ? ` data-tactic-expand-id="${ESC(expandKey)}"`
+            : '';
+
         return `
             <div class="ops-node ${ESC(t.state)}">
                 <div class="ops-stagelab">${seq} · ${stateLabel}${nextBadge ? ' ' + nextBadge : ''}</div>
-                <div class="ops-card">${inner}</div>
+                <div class="ops-card"${cardExpandAttr}>${inner}</div>
             </div>`;
     },
 
+    // -----------------------------------------------------------------
+    // Expandable tactic detail — click-to-expand for queued/done/paused
+    // -----------------------------------------------------------------
+
+    // Stable key used to persist expand state across re-renders.
+    _tacticExpandKey(t) {
+        return String(t.id || t.seq || t.name || '');
+    },
+
+    // Compact inline scope chip — always shown in the collapsed header.
+    // Works without embryo list; uses this._rolesMap for role color if available.
+    _renderOpsScopeChip(scope, ESC) {
+        const rolesMap = this._rolesMap;
+        if (!scope || scope.mode === 'global') {
+            return '<span class="ops-scope-chip ops-scope-global">global</span>';
+        }
+        if (scope.mode === 'role') {
+            const role = scope.role || '';
+            const roleInfo = rolesMap ? rolesMap.get(role) : null;
+            const color  = (roleInfo && roleInfo.ui_color) || '#8b949e';
+            const bg     = this._hexToRgba(color, 0.12);
+            const border = this._hexToRgba(color, 0.35);
+            return `<span class="ops-scope-chip" style="color:${ESC(color)};background:${bg};border-color:${border}">role: ${ESC(role)}</span>`;
+        }
+        if (scope.mode === 'embryos') {
+            const ids = (scope.embryo_ids || []).join(', ');
+            return `<span class="ops-scope-chip ops-scope-global">${ESC(ids) || '—'}</span>`;
+        }
+        return '';
+    },
+
+    // Expanded detail body — rationale, scope, structure, relations, live.readouts.
+    // Rendered hidden by default; _wireSpineExpand toggles the `hidden` class.
+    _renderOpsExpandBody(t, ESC, tactics) {
+        const rows = [];
+
+        // Rationale
+        if (t.rationale) {
+            rows.push(`<div class="ops-expand-row">
+                <span class="ops-expand-key">rationale</span>
+                <span class="ops-expand-val">${ESC(t.rationale)}</span>
+            </div>`);
+        }
+
+        // Scope — resolved readable form
+        const scope = t.scope;
+        if (scope) {
+            let scopeText = 'all embryos';
+            if (scope.mode === 'role') {
+                scopeText = `role: ${scope.role || ''}`;
+            } else if (scope.mode === 'embryos') {
+                scopeText = (scope.embryo_ids || []).join(', ') || '—';
+            }
+            rows.push(`<div class="ops-expand-row">
+                <span class="ops-expand-key">scope</span>
+                <span class="ops-expand-val">${ESC(scopeText)}</span>
+            </div>`);
+        }
+
+        // Structure — kind-specific
+        const struct = t.structure || {};
+        if (t.kind === 'standing_timelapse' && struct.cadence_s != null) {
+            rows.push(`<div class="ops-expand-row">
+                <span class="ops-expand-key">cadence</span>
+                <span class="ops-expand-val ops-expand-mono">${ESC(struct.cadence_s)}s</span>
+            </div>`);
+        }
+        if (t.kind === 'scripted_protocol') {
+            const phases = (struct.phases || []);
+            if (phases.length) {
+                const pHtml = phases.map(p =>
+                    `<span class="ops-expand-phase">${ESC(p.name || p.state || '?')}</span>`
+                ).join('<span class="ops-expand-arrow">→</span>');
+                rows.push(`<div class="ops-expand-row">
+                    <span class="ops-expand-key">phases</span>
+                    <span class="ops-expand-val ops-expand-phases">${pHtml}</span>
+                </div>`);
+            }
+        }
+        if (t.kind === 'exclusive_burst' || t.kind === 'burst') {
+            if (struct.frames != null) {
+                rows.push(`<div class="ops-expand-row">
+                    <span class="ops-expand-key">frames</span>
+                    <span class="ops-expand-val ops-expand-mono">${ESC(struct.frames)}</span>
+                </div>`);
+            }
+            if (struct.mode) {
+                rows.push(`<div class="ops-expand-row">
+                    <span class="ops-expand-key">mode</span>
+                    <span class="ops-expand-val">${ESC(struct.mode)}</span>
+                </div>`);
+            }
+        }
+        if (t.kind === 'reactive_monitor' && struct.watch) {
+            rows.push(`<div class="ops-expand-row">
+                <span class="ops-expand-key">watch</span>
+                <span class="ops-expand-val">${ESC(struct.watch)}</span>
+            </div>`);
+        }
+
+        // Relations — resolve tactic IDs to names
+        const relations = t.relations || {};
+        const afterIds = Array.isArray(relations.after) ? relations.after : [];
+        if (afterIds.length) {
+            const tacticIdMap = {};
+            for (const tac of (tactics || [])) {
+                if (tac.id) tacticIdMap[tac.id] = tac.name || tac.id;
+            }
+            const names = afterIds.map(id => tacticIdMap[id] || id);
+            rows.push(`<div class="ops-expand-row">
+                <span class="ops-expand-key">runs after</span>
+                <span class="ops-expand-val">${ESC(names.join(', '))}</span>
+            </div>`);
+        }
+
+        // Live readouts (queued/done tactics may carry pre-set readout definitions)
+        const live = t.live || {};
+        if (live.readouts && live.readouts.length) {
+            rows.push(`<div class="ops-expand-readouts">
+                ${live.readouts.map(r => this._renderOpsReadout(r, ESC)).join('')}
+            </div>`);
+        }
+
+        if (!rows.length) return '';
+
+        const isOpen = this._expandedTacticIds.has(this._tacticExpandKey(t));
+        return `<div class="ops-expand-body${isOpen ? '' : ' hidden'}">
+            <hr class="ops-expand-rule">
+            ${rows.join('\n')}
+        </div>`;
+    },
+
+    // Wire click-to-expand on all expandable tactic cards in root after innerHTML is set.
+    // Persist expand state in _expandedTacticIds so it survives debounced re-renders.
+    _wireSpineExpand(root) {
+        root.querySelectorAll('.ops-card[data-tactic-expand-id]').forEach(card => {
+            const expandId = card.dataset.tacticExpandId;
+            const body    = card.querySelector('.ops-expand-body');
+            const chevron = card.querySelector('.ops-expand-chevron');
+            if (!body) return;
+
+            card.addEventListener('click', (e) => {
+                // Let clicks on interactive elements inside the body bubble freely.
+                if (e.target.closest('a, button:not(.ops-expand-chevron)')) return;
+                const isExpanded = !body.classList.contains('hidden');
+                if (isExpanded) {
+                    body.classList.add('hidden');
+                    if (chevron) chevron.classList.remove('open');
+                    this._expandedTacticIds.delete(expandId);
+                } else {
+                    body.classList.remove('hidden');
+                    if (chevron) chevron.classList.add('open');
+                    this._expandedTacticIds.add(expandId);
+                }
+            });
+        });
+    },
+
     // Render a readout gauge. `r.value` may contain trusted HTML (span markup).
     // Stamps data-livebind on the outer div so _handleTempUpdate (and future
     // live-binding) can find the gauge in-place without a full re-render.

From 55cdb39020042e34df79b67deeeae784c035456d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 18:21:29 +0530
Subject: [PATCH 262/314] =?UTF-8?q?feat(operations):=20guidance=20?=
 =?UTF-8?q?=E2=80=94=20plan=20calibration/reference=20roles=20+=20tactics,?=
 =?UTF-8?q?=20not=20just=20subjects?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gently/harness/prompts/templates.py | 31 +++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/gently/harness/prompts/templates.py b/gently/harness/prompts/templates.py
index 957ec0ad..06b7cbad 100644
--- a/gently/harness/prompts/templates.py
+++ b/gently/harness/prompts/templates.py
@@ -280,6 +280,37 @@
 }
 ```
 
+### Plan the whole roster — subjects AND references
+
+Experiments often require both subjects and references. Declare tactics for all
+roster classes in the same `declare_operation_plan` call.
+
+| Roster class | Role value(s) | Planning note |
+|---|---|---|
+| Subjects | `test` | adaptive protocol + reactive tactics apply |
+| References | `calibration`, `lineaging` | steady acquisition only; no adaptive protocol |
+
+**Reference tactic**: when the assay needs calibration or stage-clock embryos, declare
+a `standing_timelapse` scoped to that role alongside the subject tactics:
+
+```json
+{
+  "id": "ref_acq",
+  "name": "Reference steady acquisition",
+  "kind": "standing_timelapse",
+  "state": "planned",
+  "scope": {"mode": "role", "role": "calibration"},
+  "rationale": "Steady 5-min imaging of calibration embryos — stage timing + normalization"
+}
+```
+
+**Surface role requirements** in the plan `goal` or a tactic `rationale`: state which
+roles the run needs and roughly how many (e.g. *"needs ≥2 test subjects + ≥1 calibration
+reference"*) so the operator knows what embryos to assign before the run begins. Never
+plan only for `test` when the assay depends on reference embryos.
+
+Valid `scope.role` strings: `test` / `calibration` / `lineaging` / `unassigned`.
+
 Re-call `declare_operation_plan` (patch) whenever a tactic's state changes:
 `"planned"` → `"active"` when you start it, `"active"` → `"done"` when it
 finishes.  This keeps the Operations view in the UI synchronized with reality.

From 6797e0ac5ff8254b5737f8d1baeb3389773c272a Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 12:02:33 -0400
Subject: [PATCH 263/314] fix(live-view): throttle SPIM live stream to prevent
 GPU TDR freeze
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A SPIM live-streaming session hard-froze the workstation (black screen,
dead input) on 2026-06-29. Root cause was a GPU display-driver hang
(Video TDR Failure / LiveKernelEvent 141 + nvlddmkm errors), not RAM
exhaustion — the box has 256 GB and logged no resource-exhaustion event,
and the freeze hit ~2s after the stream opened.

The trigger was uncapped live-frame rendering: the device layer paced
frames only to the exposure (interval=0), so short exposures pushed
100+ fps of small JPEGs, and the frontend swapped <img>.src to a new
base64 data-URL per frame inside a CSS-composited (zoomable) layer. That
churned GPU texture uploads fast enough to TDR an older driver.

Two fixes decouple render cost from frame rate:

- device_layer: _ls_interval_sec default 0.0 -> 1/15, capping the live
  stream at ~15 fps. Long exposures still dominate via max(interval,
  exposure). Tests set this explicitly, so the default change is safe.
- devices.js: handleLightsheetFrame now coalesces paints to one per
  requestAnimationFrame, keeps only the latest frame, and holds a single
  img.decode() in flight for real backpressure. Per-frame bookkeeping
  (fps/LED/stale) still reflects the true incoming rate. Throttle state
  resets on stream stop.

Tests: 29 lightsheet tests pass; both files syntax-clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/device_layer.py |  7 ++-
 gently/ui/web/static/js/devices.js     | 62 +++++++++++++++++++++++---
 2 files changed, 62 insertions(+), 7 deletions(-)

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 0042f5af..55e43c15 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -171,7 +171,12 @@ def __init__(
         # Lightsheet (SPIM) live stream — continuous sequence acquisition.
         self._ls_subscribers: list[asyncio.Queue] = []
         self._ls_task: asyncio.Task | None = None
-        self._ls_interval_sec: float = 0.0  # peek as fast as exposure allows
+        # Min interval between streamed frames. A floor (not 0) caps the live
+        # FPS so short exposures don't flood the browser at 100+ fps, which
+        # churns GPU texture uploads in the <img> renderer and can TDR an
+        # older display driver. ~15 fps is plenty for live focus/centering;
+        # long exposures still dominate via max(interval, exposure) below.
+        self._ls_interval_sec: float = 1.0 / 15.0  # cap live stream at ~15 fps
         self._ls_target_max_dim: int = 512
         self._ls_jpeg_quality: int = 70
         self._ls_params: dict = {
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 8c1c8733..c63e6307 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -80,6 +80,14 @@ const DevicesManager = (function () {
     let _lsStaleTimer = null;
     const _LS_FPS_WINDOW = 12;
     let _lsFrameTimes = [];
+    // Render throttle: decouple paint rate from frame-arrival rate. We keep
+    // only the latest frame, coalesce paints to one per animation frame, and
+    // hold a single decode in flight at a time. This stops a fast stream from
+    // swapping <img>.src 100+ times/sec, which churns GPU texture uploads and
+    // can hang an older display driver (Video TDR). See handleLightsheetFrame.
+    let _lsPendingPayload = null;
+    let _lsRenderScheduled = false;
+    let _lsDecoding = false;
 
     // Lightsheet zoom / pan (mirrors camera zoom/pan)
     let _lsZoom = 1;
@@ -1751,6 +1759,8 @@ const DevicesManager = (function () {
         if (!streaming) {
             _lsHasFrame = false;
             _lsFrameTimes = [];
+            _lsPendingPayload = null;
+            _lsRenderScheduled = false;
             if (_lsImg) _lsImg.classList.remove('has-frame');
             if (_lsPlaceholder) _lsPlaceholder.hidden = false;
             if (_lsMeta) _lsMeta.textContent = 'stream off';
@@ -1764,12 +1774,9 @@ const DevicesManager = (function () {
 
     function handleLightsheetFrame(payload) {
         if (!payload || !payload.jpeg_b64 || !_lsImg) return;
-        _lsImg.src = `data:${payload.mime || 'image/jpeg'};base64,${payload.jpeg_b64}`;
-        if (!_lsHasFrame) {
-            _lsHasFrame = true;
-            _lsImg.classList.add('has-frame');
-            if (_lsPlaceholder) _lsPlaceholder.hidden = true;
-        }
+
+        // Lightweight bookkeeping runs per arriving frame so the FPS / live
+        // indicator reflects the true incoming rate.
         const now = performance.now();
         _lsLastFrameTs = Date.now();
         _lsFrameTimes.push(now);
@@ -1787,6 +1794,49 @@ const DevicesManager = (function () {
                 : (fps != null ? `${fps.toFixed(1)} fps` : 'live');
         }
         scheduleLightsheetStaleCheck();
+
+        // Expensive path (decode + GPU texture upload) is throttled: keep only
+        // the newest frame and coalesce paints to one per animation frame.
+        _lsPendingPayload = payload;
+        if (!_lsRenderScheduled) {
+            _lsRenderScheduled = true;
+            requestAnimationFrame(renderLightsheetFrame);
+        }
+    }
+
+    function renderLightsheetFrame() {
+        _lsRenderScheduled = false;
+        // One decode in flight at a time; a frame mid-decode means we skip this
+        // paint and let the decode's completion reschedule if newer data exists.
+        if (_lsDecoding) return;
+        const payload = _lsPendingPayload;
+        _lsPendingPayload = null;
+        if (!payload || !_lsImg) return;
+
+        _lsDecoding = true;
+        _lsImg.src = `data:${payload.mime || 'image/jpeg'};base64,${payload.jpeg_b64}`;
+
+        const done = () => {
+            _lsDecoding = false;
+            if (!_lsHasFrame) {
+                _lsHasFrame = true;
+                _lsImg.classList.add('has-frame');
+                if (_lsPlaceholder) _lsPlaceholder.hidden = true;
+            }
+            // A newer frame may have landed during decode — paint it next frame.
+            if (_lsPendingPayload && !_lsRenderScheduled) {
+                _lsRenderScheduled = true;
+                requestAnimationFrame(renderLightsheetFrame);
+            }
+        };
+
+        // img.decode() resolves once the bitmap is ready (off the main thread),
+        // giving real backpressure. Fall back to a direct apply if unsupported.
+        if (typeof _lsImg.decode === 'function') {
+            _lsImg.decode().then(done).catch(done);
+        } else {
+            done();
+        }
     }
 
     function computeLightsheetFps() {

From b34143ca0d581a250ad605205d367b84ec80af17 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 12:19:58 -0400
Subject: [PATCH 264/314] =?UTF-8?q?fix(devices):=20stop=20=CE=94t=20label?=
 =?UTF-8?q?=20jitter=20shaking=20the=20LIVE=20badge=20/=20room-light=20but?=
 =?UTF-8?q?ton?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The live "Δt 0.20s" sub-label (.devices-status-meta) updates every frame
with proportional digits and no reserved width, so each value change
resized its box. The status cluster is right-anchored in the header
(.devices-header-bar is flex/space-between), so that resize moved the
cluster's left edge and visibly jittered the LIVE badge and room-light
button beside it (~3.5px shake per update).

Add a .devices-status-meta rule: tabular-nums for equal-width digits plus
a reserved, right-aligned min-width so the box can't change size as the
value fluctuates (or when digit count changes, e.g. Δt crossing 1s→10s
or "streaming" vs "Δt 0.20s"). CSS-only.

Verified in-browser: across Δt values 0.09s–0.21s the meta width holds
constant at 54.39px and LIVE/room-light jitter drops from ~3.5px to 0px.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index d7b51a37..e902d33b 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9641,6 +9641,15 @@ body.modal-open {
 .devices-status-led.paused::before{ background: var(--map-accent); }
 .devices-status-led.stale::before { background: var(--map-warm); }
 .devices-status-led.error::before { background: #f87171; }
+/* Status sub-label (e.g. the live "Δt 0.20s"). The value updates every frame;
+   tabular figures + a reserved, right-aligned width keep its box from changing
+   size, so the rapidly-changing digits can't reflow and jitter the LIVE badge
+   and room-light button beside it (the cluster is right-anchored in the bar). */
+.devices-status-meta {
+    font-variant-numeric: tabular-nums;
+    min-width: 3.4rem;
+    text-align: right;
+}
 
 /* --- Room-light toggle (header) -------------------------------------- */
 .devices-room-light {

From e2d1a7ac4d8f6842ed2da9bff79a62dda149c01e Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 13:11:15 -0400
Subject: [PATCH 265/314] feat(manual-view): reorganize lightsheet controls
 into a no-scroll 2-column rail
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Rework the Manual (SPIM live-view) control rail so every control is visible
at once without scrolling, and clean up alignment.

Layout:
- .ls-rail is now a 2-column masonry (CSS multicol, 380px) instead of a
  single 220px column that overflowed and scrolled. Cards keep break-inside
  so they stay whole; the viewer shrinks to match.
- Sensible grouping: left column = Live, Exposure, SPIM Side, Galvo, Piezo Z
  (slice setup); right column = Illumination, Acquire, Temperature, Timelapse.
  Acquire moved above Temperature.
- Illumination buttons get a min-width so labels wrap instead of truncating.

Stream toggle:
- Moved the live toggle out of the viewer header into the rail as a slim
  full-width "● LIVE" button (column-span header), top-aligned with the
  image-stage box. Outline style, status dot glows green while streaming.
  Label is now constant "Live" (state shown by the dot/colour), not Start/Stop.

Temperature trajectory:
- The shared #devices-temp-graph section moved to after the manual view so it
  sits at the bottom of every device tab instead of hogging the top of Manual.

Defaults:
- Manual live-view galvo and piezo now default to 0 (HTML value, the JS
  _lsPiezo source-of-truth that's posted to the device, and the device-layer
  _ls_params default — kept consistent to avoid a slider/hardware mismatch).
  The separate timelapse piezo-center (50, for volume scans) is unchanged.

CSS/HTML/JS only; toggle stays wired via its preserved id. 29 lightsheet
tests pass; device_layer.py syntax-clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/device_layer.py |  2 +-
 gently/ui/web/static/css/main.css      | 76 ++++++++++++++++++++++++--
 gently/ui/web/static/js/devices.js     |  6 +-
 gently/ui/web/templates/index.html     | 43 +++++++++------
 4 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 55e43c15..db6e50f0 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -181,7 +181,7 @@ def __init__(
         self._ls_jpeg_quality: int = 70
         self._ls_params: dict = {
             "galvo": 0.0,
-            "piezo": 50.0,
+            "piezo": 0.0,
             "exposure": 20.0,
             "side": "A",
             # "snap"  → per-frame snapImage()+getImage() — hard memory ceiling, safe default.
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index e902d33b..8b558543 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10597,13 +10597,17 @@ body.modal-open {
     aspect-ratio: unset;
 }
 
-/* Right column — control rail */
+/* Right column — control rail.
+   Two-column masonry so every control stays visible without scrolling.
+   multicol packs the varying-height cards tighter than a grid would (no
+   row-alignment gaps); each .ls-group sets break-inside to stay whole.
+   overflow-y:auto is a safety net only — the default (collapsed) control
+   set fits with no scrollbar; it appears solely if Timelapse is expanded. */
 .ls-rail {
-    width: 220px;
+    width: 380px;
     flex-shrink: 0;
-    display: flex;
-    flex-direction: column;
-    gap: 0.85rem;
+    columns: 2;
+    column-gap: 0.7rem;
     overflow-y: auto;
     padding: 0.1rem 0 0.5rem;
 }
@@ -10617,6 +10621,64 @@ body.modal-open {
     background: var(--map-overlay-bg);
     border: 1px solid var(--map-overlay-edge);
     border-radius: 5px;
+    /* multicol: keep each card intact and space them (rail gap is gone) */
+    break-inside: avoid;
+    margin-bottom: 0.7rem;
+}
+
+/* Stream group: the live toggle, relocated from the viewer header to a
+   prominent full-width button at the top of the rail. column-span makes it
+   a header across both columns, whose top lines up with the image stage. */
+.ls-group-stream {
+    column-span: all;
+    /* no card frame — this is just the toggle, not a boxed control group */
+    background: transparent;
+    border: none;
+    padding: 0;
+    /* top margin ≈ the viewer's header row height so the button lines up
+       with the top of the image-stage box (not the "LIGHTSHEET" label row). */
+    margin-top: 1.05rem;
+    margin-bottom: 0.85rem;
+}
+/* Slim outline "● LIVE" toggle. Muted when off; glows green while streaming
+   (the .active class is toggled on by applyLightsheetState). */
+.ls-stream-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.45rem;
+    width: 100%;
+    padding: 0.34rem 0.6rem;
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink-mute);
+    font-family: inherit;
+    font-size: 0.66rem;
+    font-weight: 600;
+    letter-spacing: 0.14em;
+    text-transform: uppercase;
+    border-radius: 5px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+}
+.ls-stream-btn::before {
+    content: '';
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+    background: var(--map-ink-mute);
+    flex: none;
+    transition: background 0.12s, box-shadow 0.12s;
+}
+.ls-stream-btn:hover { border-color: var(--map-accent); color: var(--map-ink); }
+.ls-stream-btn.active {
+    border-color: #4ade80;
+    color: #4ade80;
+    background: rgba(74, 222, 128, 0.10);
+}
+.ls-stream-btn.active::before {
+    background: #4ade80;
+    box-shadow: 0 0 8px rgba(74, 222, 128, 0.7);
 }
 
 .ls-label {
@@ -10686,7 +10748,9 @@ body.modal-open {
 
 .ls-illum-btn {
     flex: 1;
-    min-width: 0;
+    /* Reserve enough width that labels wrap to a new row instead of
+       truncating to an ellipsis in the narrower 2-column rail. */
+    min-width: 4.25rem;
     background: transparent;
     border: 1px solid var(--map-overlay-edge);
     color: var(--map-ink);
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index c63e6307..a5dc270d 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -97,7 +97,7 @@ const DevicesManager = (function () {
 
     // Lightsheet live params — debounced POST to /api/devices/lightsheet/live/params
     let _lsGalvo = 0;
-    let _lsPiezo = 50;
+    let _lsPiezo = 0;
     let _lsExposure = 20;  // matches device-layer _ls_params default (20 ms)
     let _lsSide = 'A';     // SPIM side — 'A' (HamCam1) or 'B' (HamCam2 if present)
     let _lsParamTimer = null;
@@ -1749,7 +1749,9 @@ const DevicesManager = (function () {
     function applyLightsheetState(streaming) {
         _lsStreaming = streaming;
         if (_lsToggle) {
-            _lsToggle.textContent = streaming ? 'Stop' : 'Start';
+            // Constant "Live" label; the .active class + status dot show whether
+            // the stream is currently running (muted = off, green glow = live).
+            _lsToggle.textContent = 'Live';
             _lsToggle.classList.toggle('active', streaming);
         }
         if (_lsLed) {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 109d3be8..5b669a68 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -714,9 +714,6 @@ <h3 class="devices-properties-title">Properties</h3>
               </div>
             </div>
 
-            <!-- Temperature trajectory graph: backfill + live SVG chart -->
-            <section class="devices-temp-graph" id="devices-temp-graph" aria-label="Temperature trajectory"></section>
-
             <!-- Manual view: SPIM brightfield live-view + controls -->
             <div class="devices-view devices-view-manual" id="devices-view-manual" style="display:none">
                 <div class="ls-layout">
@@ -729,7 +726,6 @@ <h3 class="devices-properties-title">Properties</h3>
                                 <span>Lightsheet</span>
                             </span>
                             <span class="devices-camera-meta" id="devices-ls-meta">—</span>
-                            <button class="devices-camera-toggle" id="devices-ls-toggle" type="button">Start</button>
                         </div>
                         <div class="devices-camera-stage ls-stage" id="devices-ls-stage">
                             <img class="devices-camera-img" id="devices-ls-img" alt="lightsheet live frame">
@@ -748,6 +744,11 @@ <h3 class="devices-properties-title">Properties</h3>
                     <!-- RIGHT: control rail -->
                     <div class="ls-rail">
 
+                        <!-- Live stream toggle (relocated out of the viewer header) -->
+                        <div class="ls-group ls-group-stream">
+                            <button class="ls-stream-btn" id="devices-ls-toggle" type="button">Live</button>
+                        </div>
+
                         <!-- Exposure -->
                         <div class="ls-group">
                             <label class="ls-label" for="devices-ls-exposure">Exposure</label>
@@ -786,9 +787,9 @@ <h3 class="devices-properties-title">Properties</h3>
                             <label class="ls-label" for="devices-ls-piezo">Piezo Z</label>
                             <div class="ls-slider-row">
                                 <input class="ls-slider" id="devices-ls-piezo-slider" type="range"
-                                       min="0" max="200" step="0.5" value="50" aria-label="Piezo Z position">
+                                       min="0" max="200" step="0.5" value="0" aria-label="Piezo Z position">
                                 <input class="ls-number ls-number-sm" id="devices-ls-piezo" type="number"
-                                       min="0" max="200" step="0.5" value="50" inputmode="decimal">
+                                       min="0" max="200" step="0.5" value="0" inputmode="decimal">
                                 <span class="ls-unit">µm</span>
                             </div>
                         </div>
@@ -823,18 +824,6 @@ <h3 class="devices-properties-title">Properties</h3>
                             </div>
                         </div>
 
-                        <!-- Temperature -->
-                        <div class="ls-group">
-                            <label class="ls-label">Temperature</label>
-                            <div class="ls-row">
-                                <input class="ls-number" id="devices-ls-temp-input" type="number"
-                                       min="0" max="99.9" step="0.1" inputmode="decimal"
-                                       placeholder="°C" aria-label="Temperature setpoint">
-                                <button class="ls-set-btn" id="devices-ls-temp-set" type="button">Set</button>
-                            </div>
-                            <div id="devices-ls-tempgraph" class="ls-tempgraph"></div>
-                        </div>
-
                         <!-- Acquire -->
                         <div class="ls-group">
                             <span class="ls-label">Acquire</span>
@@ -850,6 +839,18 @@ <h3 class="devices-properties-title">Properties</h3>
                             </div>
                         </div>
 
+                        <!-- Temperature -->
+                        <div class="ls-group">
+                            <label class="ls-label">Temperature</label>
+                            <div class="ls-row">
+                                <input class="ls-number" id="devices-ls-temp-input" type="number"
+                                       min="0" max="99.9" step="0.1" inputmode="decimal"
+                                       placeholder="°C" aria-label="Temperature setpoint">
+                                <button class="ls-set-btn" id="devices-ls-temp-set" type="button">Set</button>
+                            </div>
+                            <div id="devices-ls-tempgraph" class="ls-tempgraph"></div>
+                        </div>
+
                         <!-- Timelapse (collapsible panel → accordion of 3 sections) -->
                         <div class="ls-group" id="devices-tl-group">
                             <button class="ls-label ls-collapsible-head" id="devices-tl-toggle"
@@ -1004,6 +1005,12 @@ <h3 class="devices-properties-title">Properties</h3>
                     </div><!-- /.ls-rail -->
                 </div><!-- /.ls-layout -->
             </div><!-- /#devices-view-manual -->
+
+            <!-- Temperature trajectory graph: backfill + live SVG chart.
+                 Shared across device tabs; placed last so it sits at the
+                 bottom (was between 3D and Manual, which put it at the top
+                 of the Manual view). -->
+            <section class="devices-temp-graph" id="devices-temp-graph" aria-label="Temperature trajectory"></section>
         </div>
     </div>
 

From 3887f979b77334d90dea16c1dc597c5f3685711b Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 13:12:51 -0400
Subject: [PATCH 266/314] refactor(manual-view): remove dead CAM LED button
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The CAM LED toggle posted use_led to the bottom camera, but camera.py's
trigger() intentionally ignores that flag ("the bottom camera NEVER drives
the LED — imaging is done under room light only"). The control was a no-op
on the rig and crowded the Illumination row.

Remove the button and its now-unused JS wiring (lookup, listener, the
toggleCamLedMode handler, and the _lsCamLed/_lsCamLedOn state). LED and
Room Light now share the top illumination row with more room.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/js/devices.js | 20 +-------------------
 gently/ui/web/templates/index.html |  2 --
 2 files changed, 1 insertion(+), 21 deletions(-)

diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index a5dc270d..5467f39d 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -104,9 +104,8 @@ const DevicesManager = (function () {
 
     // Lightsheet control inputs (rail)
     let _lsGalvoSlider, _lsGalvoNum, _lsPiezoSlider, _lsPiezoNum, _lsExposureNum;
-    let _lsLedToggle, _lsCamLed, _lsRoomLightBtn;
+    let _lsLedToggle, _lsRoomLightBtn;
     let _lsLedIsOpen = false;  // LED toggle state: false = Closed (safe default)
-    let _lsCamLedOn = false;
     let _lsLaserToggle;
     let _lsLaserOn = false;    // Laser toggle state: false = OFF (entry-safe default)
     let _lsSnapVolBtn, _lsBurstBtn, _lsLastcap, _lsLastcapRef;
@@ -216,7 +215,6 @@ const DevicesManager = (function () {
         _lsPiezoNum      = document.getElementById('devices-ls-piezo');
         _lsExposureNum   = document.getElementById('devices-ls-exposure');
         _lsLedToggle     = document.getElementById('devices-ls-led-toggle');
-        _lsCamLed        = document.getElementById('devices-ls-cam-led');
         _lsRoomLightBtn  = document.getElementById('devices-ls-room-light-btn');
         _lsLaserToggle   = document.getElementById('devices-ls-laser-toggle');
         _lsSnapVolBtn    = document.getElementById('devices-ls-snap-volume');
@@ -2044,21 +2042,6 @@ const DevicesManager = (function () {
         }
     }
 
-    async function toggleCamLedMode() {
-        _lsCamLedOn = !_lsCamLedOn;
-        if (_lsCamLed) {
-            _lsCamLed.classList.toggle('ls-illum-btn--active', _lsCamLedOn);
-            _lsCamLed.setAttribute('aria-pressed', _lsCamLedOn ? 'true' : 'false');
-        }
-        try {
-            await fetch('/api/devices/camera/led_mode', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ use_led: _lsCamLedOn }),
-            });
-        } catch (err) { console.debug('cam LED mode failed:', err); }
-    }
-
     async function toggleManualRoomLight() {
         const nextState = _roomLightState === 'on' ? 'off' : 'on';
         if (_lsRoomLightBtn) {
@@ -2165,7 +2148,6 @@ const DevicesManager = (function () {
 
         // Illumination
         if (_lsLedToggle)    _lsLedToggle.addEventListener('click',    toggleLedPreset);
-        if (_lsCamLed)       _lsCamLed.addEventListener('click',       toggleCamLedMode);
         if (_lsRoomLightBtn) _lsRoomLightBtn.addEventListener('click', toggleManualRoomLight);
         if (_lsLaserToggle)  _lsLaserToggle.addEventListener('click',  toggleLaser);
 
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 5b669a68..da7f500c 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -801,8 +801,6 @@ <h3 class="devices-properties-title">Properties</h3>
                                 <button class="ls-illum-btn" id="devices-ls-led-toggle" type="button"
                                         title="Toggle LED preset (Open/Closed)"
                                         aria-pressed="false">LED: Closed</button>
-                                <button class="ls-illum-btn" id="devices-ls-cam-led" type="button"
-                                        title="Toggle camera LED mode" aria-pressed="false">Cam LED</button>
                                 <button class="ls-illum-btn" id="devices-ls-room-light-btn" type="button"
                                         title="Toggle room light" aria-pressed="false">Room Light</button>
                             </div>

From eaa1d507b6326993a0561d7f6a9914e841e2e7cb Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Mon, 29 Jun 2026 13:19:10 -0400
Subject: [PATCH 267/314] fix(web): stop acquire routes returning raw numpy
 arrays (500 on Snap/Burst)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Snap Volume / Burst in the Manual view hit /api/devices/acquire/volume|burst,
which returned client.acquire_*()'s dict verbatim. That dict carries the pixel
data under "volume" as a numpy array (internal callers like the timelapse
orchestrator need it), and FastAPI's jsonable_encoder can't serialize an
ndarray — it falls back to dict(arr) and raises
"dictionary update sequence element #0 has length 512; 2 is required",
returning a 500.

Add _json_safe() in the data routes and apply it to both acquire responses:
raw arrays become a small {shape, dtype} hint, numpy scalars coerce to native
types, and it recurses so the burst "frames" list is covered. The web UI only
reads volume_path/metadata (never the pixels), so nothing downstream changes.
The client return shape is untouched, so non-web callers keep their arrays.

Verified: volume + burst sample results now json.dumps cleanly with volume_path
preserved.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/data.py | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 075117be..5281e290 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -16,6 +16,30 @@
 _HARDWARE_CONFIG_PATH = Path(__file__).resolve().parents[4] / "config" / "hardware.yaml"
 
 
+def _json_safe(obj):
+    """Make an acquisition result JSON-encodable for FastAPI.
+
+    ``client.acquire_volume``/``acquire_burst`` return the pixel data under
+    ``volume``/``image`` as numpy arrays (internal callers like the timelapse
+    orchestrator need them). FastAPI's ``jsonable_encoder`` can't serialize a
+    raw ndarray — it tries ``dict(arr)`` and blows up — and the web UI only
+    needs paths + metadata anyway. Replace arrays with a small shape/dtype
+    hint and coerce numpy scalars to native types; recurse so the burst
+    ``frames`` list is covered too.
+    """
+    import numpy as np
+
+    if isinstance(obj, np.ndarray):
+        return {"shape": list(obj.shape), "dtype": str(obj.dtype)}
+    if isinstance(obj, np.generic):
+        return obj.item()
+    if isinstance(obj, dict):
+        return {k: _json_safe(v) for k, v in obj.items()}
+    if isinstance(obj, (list, tuple)):
+        return [_json_safe(v) for v in obj]
+    return obj
+
+
 def create_router(server) -> APIRouter:
     router = APIRouter()
 
@@ -633,13 +657,14 @@ async def acquire_burst(payload: dict = Body(...)):  # noqa: B008
                 kw["piezo_center"] = float(payload["piezo_center"])
             if payload.get("galvo_center") is not None:
                 kw["galvo_center"] = float(payload["galvo_center"])
-            return await client.acquire_burst(
+            result = await client.acquire_burst(
                 frames=int(payload.get("frames", 60)),
                 mode=str(payload.get("mode", "1hz")),
                 num_slices=int(payload.get("num_slices", 1)),
                 exposure_ms=float(payload.get("exposure_ms", 5.0)),
                 **kw,
             )
+            return _json_safe(result)
         except Exception as exc:
             logger.exception("Burst acquisition failed")
             raise HTTPException(status_code=502, detail=f"burst failed: {exc}") from exc
@@ -665,11 +690,12 @@ async def acquire_volume(payload: dict = Body(...)):  # noqa: B008
                 kw["piezo_center"] = float(payload["piezo_center"])
             if payload.get("galvo_center") is not None:
                 kw["galvo_center"] = float(payload["galvo_center"])
-            return await client.acquire_volume(
+            result = await client.acquire_volume(
                 num_slices=int(payload.get("num_slices", 50)),
                 exposure_ms=float(payload.get("exposure_ms", 10.0)),
                 **kw,
             )
+            return _json_safe(result)
         except Exception as exc:
             logger.exception("Volume acquisition failed")
             raise HTTPException(status_code=502, detail=f"volume failed: {exc}") from exc

From 60b948e188841dda3c08a40e910060068ec0d57b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 17:54:15 +0530
Subject: [PATCH 268/314] feat(devices): Map-view embryo detect +
 single-source-of-truth list + per-embryo Center + bottom-cam enlarge
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- POST /api/devices/detect_embryos (bottom-cam SAM) — interim auto-register
- Device-tab Embryos card renders the canonical experiment.embryos list
  (EMBRYOS_UPDATE); per-row Center calls /api/devices/stage/move; per-row remove
- Bottom-camera enlarge toggle (height-capped, fits the map)
- Right-side rail stacks XY readout + Embryos card (no overlap)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/data.py       |  84 ++++++++++++
 gently/ui/web/static/css/main.css  | 202 +++++++++++++++++++++++++++++
 gently/ui/web/static/js/devices.js | 197 +++++++++++++++++++++++++++-
 gently/ui/web/templates/index.html |  30 ++++-
 4 files changed, 509 insertions(+), 4 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 075117be..e21a3422 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -608,6 +608,90 @@ async def stage_move(payload: dict = Body(...)):  # noqa: B008
             logger.exception("Stage move command failed")
             raise HTTPException(status_code=502, detail=f"stage move failed: {exc}") from exc
 
+    @router.post("/api/devices/detect_embryos", dependencies=[Depends(require_control)])
+    async def detect_embryos(payload: dict = Body(default={})):  # noqa: B008
+        """Run bottom-camera embryo detection and register the hits into the
+        canonical experiment embryo list — the single source of truth.
+
+        Registration goes through ExperimentState.add_embryo(), which fires
+        EMBRYOS_UPDATE (and EMBRYO_DETECTED), so the device-tab Map view and
+        every other embryo consumer refresh automatically — there is no second
+        list. Raw SAM hits are added as role 'unassigned'; the operator prunes
+        false positives from the same list (DELETE /api/embryos/{id}). Each
+        Detect run appends fresh hits with new ids.
+
+        Body (all optional): {exposure_ms, min_confidence, brightness_percentile,
+        min_area, max_area, use_claude_review}. Claude review defaults OFF so the
+        manual flow is fast and needs no API key; brightness+SAM detections
+        already carry stage coordinates.
+
+        Returns: {success, detected, registered: [embryo_id, ...]}.
+        """
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        if not getattr(client, "has_sam", False):
+            raise HTTPException(
+                status_code=503, detail="SAM detection not available on device layer"
+            )
+        agent = _require_agent_with_experiment()
+
+        kw: dict = {"use_claude_review": bool(payload.get("use_claude_review", False))}
+        for key, cast in (
+            ("exposure_ms", float),
+            ("min_confidence", float),
+            ("brightness_percentile", float),
+            ("min_area", int),
+            ("max_area", int),
+        ):
+            if payload.get(key) is not None:
+                kw[key] = cast(payload[key])
+        try:
+            result = await client.detect_embryos(**kw)
+        except Exception as exc:
+            logger.exception("Embryo detection failed")
+            raise HTTPException(status_code=502, detail=f"detection failed: {exc}") from exc
+
+        if not result.get("success"):
+            detail = result.get("error", "detection failed")
+            raise HTTPException(status_code=502, detail=str(detail))
+
+        import uuid
+
+        def _num(v):
+            try:
+                return float(v)
+            except (TypeError, ValueError):
+                return None
+
+        def _next_embryo_id() -> str:
+            n = 1
+            while f"embryo_{n}" in agent.experiment.embryos:
+                n += 1
+            return f"embryo_{n}"
+
+        detections = result.get("embryos", []) or []
+        registered: list[str] = []
+        for emb in detections:
+            sx, sy = _num(emb.get("stage_x_um")), _num(emb.get("stage_y_um"))
+            if sx is None or sy is None:
+                continue
+            emb_id = _next_embryo_id()
+            agent.experiment.add_embryo(
+                embryo_id=emb_id,
+                position={"x": sx, "y": sy},
+                confidence=_num(emb.get("confidence")) or 0.0,
+                uid=str(uuid.uuid4()),
+                role="unassigned",
+            )
+            registered.append(emb_id)
+
+        return {
+            "success": True,
+            "detected": len(detections),
+            "registered": registered,
+        }
+
     # ------------------------------------------------------------------
     # Acquisition
     # ------------------------------------------------------------------
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index d7b51a37..f4fcdccc 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10219,6 +10219,208 @@ body.modal-open {
     color: var(--map-paper);
     border-color: var(--map-accent);
 }
+
+/* ---- Top-right rail: XY readout stacked above the detect panel ---- */
+.devices-map-rail {
+    position: absolute;
+    top: 0.85rem;
+    right: 0.85rem;
+    width: 230px;
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    z-index: 4;
+}
+/* Readout drops its own absolute positioning inside the rail and fills it. */
+.devices-map-rail .devices-map-readout {
+    position: static;
+    top: auto;
+    right: auto;
+    width: 100%;
+    min-width: 0;
+}
+
+/* ---- Detected-embryo list panel (Map view, standalone detect→centre) ---- */
+.devices-detect-panel {
+    width: 100%;
+    display: flex;
+    flex-direction: column;
+    gap: 0.4rem;
+    padding: 0.5rem 0.6rem 0.55rem;
+    background: var(--map-overlay-bg-2);
+    border: 1px solid var(--map-overlay-edge);
+    border-radius: 3px;
+    box-shadow: 0 12px 32px rgba(0,0,0,0.32);
+    -webkit-backdrop-filter: blur(8px);
+    backdrop-filter: blur(8px);
+    font-family: 'Inter Tight', system-ui, sans-serif;
+}
+.devices-detect-head {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.5rem;
+}
+.devices-detect-title {
+    font-size: 0.62rem;
+    font-weight: 600;
+    letter-spacing: 0.18em;
+    text-transform: uppercase;
+    color: var(--map-ink);
+}
+.devices-detect-btn {
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.62rem;
+    font-weight: 600;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    padding: 0.18rem 0.6rem;
+    border-radius: 999px;
+    cursor: pointer;
+    transition: background 0.15s, border-color 0.15s, color 0.15s;
+}
+.devices-detect-btn:hover:not(:disabled) {
+    background: rgba(255,255,255,0.06);
+    border-color: var(--map-accent);
+    color: var(--map-accent);
+}
+.devices-detect-btn:disabled { opacity: 0.5; cursor: progress; }
+.devices-detect-list {
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+    max-height: 220px;
+    overflow-y: auto;
+}
+.devices-detect-empty {
+    font-size: 0.66rem;
+    color: var(--map-ink-mute);
+    padding: 0.35rem 0.1rem;
+    line-height: 1.35;
+}
+.devices-detect-row {
+    display: flex;
+    align-items: center;
+    gap: 0.45rem;
+    padding: 0.28rem 0.3rem;
+    border-radius: 3px;
+    transition: background 0.12s;
+}
+.devices-detect-row:hover { background: rgba(255,255,255,0.05); }
+.devices-detect-dot {
+    flex: 0 0 auto;
+    width: 18px; height: 18px;
+    border-radius: 50%;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 0.6rem;
+    font-weight: 700;
+    color: var(--map-paper);
+    background: var(--map-warm);
+}
+.devices-detect-coord {
+    flex: 1 1 auto;
+    font-size: 0.64rem;
+    font-variant-numeric: tabular-nums;
+    color: var(--map-ink);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+.devices-detect-center {
+    flex: 0 0 auto;
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.58rem;
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    padding: 0.16rem 0.45rem;
+    border-radius: 999px;
+    cursor: pointer;
+    transition: background 0.15s, border-color 0.15s, color 0.15s;
+}
+.devices-detect-center:hover:not(:disabled) {
+    background: var(--map-accent);
+    border-color: var(--map-accent);
+    color: var(--map-paper);
+}
+.devices-detect-center:disabled { opacity: 0.5; cursor: progress; }
+/* Per-row remove (prune false positives from the canonical list) */
+.devices-detect-remove {
+    flex: 0 0 auto;
+    background: transparent;
+    border: none;
+    color: var(--map-ink-mute);
+    font-family: inherit;
+    font-size: 0.7rem;
+    line-height: 1;
+    padding: 0.18rem 0.25rem;
+    border-radius: 3px;
+    cursor: pointer;
+    transition: color 0.15s, background 0.15s;
+}
+.devices-detect-remove:hover:not(:disabled) {
+    color: var(--map-warm);
+    background: rgba(255,255,255,0.06);
+}
+.devices-detect-remove:disabled { opacity: 0.5; cursor: progress; }
+.devices-detect-foot {
+    font-size: 0.62rem;
+    color: var(--map-ink-mute);
+    padding-top: 0.1rem;
+}
+
+.devices-camera-head-btns {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.3rem;
+}
+.devices-camera-expand {
+    background: transparent;
+    border: 1px solid var(--map-overlay-edge);
+    color: var(--map-ink);
+    font-family: inherit;
+    font-size: 0.72rem;
+    line-height: 1;
+    padding: 0.16rem 0.4rem;
+    border-radius: 999px;
+    cursor: pointer;
+    transition: background 0.15s, border-color 0.15s, color 0.15s;
+}
+.devices-camera-expand:hover {
+    background: rgba(255,255,255,0.06);
+    border-color: var(--map-accent);
+    color: var(--map-accent);
+}
+.devices-camera-expand.active {
+    background: var(--map-accent);
+    color: var(--map-paper);
+    border-color: var(--map-accent);
+}
+/* Enlarged bottom-camera view — centred over the map, toggled by the
+   expand button. Reuses the same streaming <img>; sized by height so the
+   whole panel (header + stage + foot) stays within the map area. */
+.devices-camera-panel.expanded {
+    bottom: auto;
+    left: 50%;
+    top: 50%;
+    transform: translate(-50%, -50%);
+    width: auto;
+    max-width: calc(100% - 2rem);
+    z-index: 9;
+}
+.devices-camera-panel.expanded .devices-camera-stage {
+    height: min(64vh, 640px);
+    width: auto;
+    max-width: 100%;
+}
 .devices-camera-stage {
     position: relative;
     width: 100%;
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 8c1c8733..905a7dc3 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -52,8 +52,16 @@ const DevicesManager = (function () {
     // Backspace removes it (with a confirm), Escape clears the selection.
     let _selectedEmbryoId = null;
 
+    // Bottom-camera detection (Map view). Detection registers hits into the
+    // canonical _embryos list (server-side, via the experiment) — there is no
+    // separate detected list. The Embryos card renders _embryos and centres the
+    // stage on each via /api/devices/stage/move. _detecting only gates the
+    // Detect button while a run is in flight.
+    let _detecting = false;
+    let _detectBtn, _detectList;
+
     // Bottom-camera panel DOM + state
-    let _camPanel, _camToggle, _camImg, _camPlaceholder, _camLed, _camMeta;
+    let _camPanel, _camToggle, _camExpand, _camImg, _camPlaceholder, _camLed, _camMeta;
     let _camStage, _camCrosshair, _camCrosshairGroup;
     let _camStreaming = false;
     let _camLastFrameTs = 0;
@@ -176,6 +184,8 @@ const DevicesManager = (function () {
         _mapOrigin        = document.getElementById('devices-map-origin');
         _mapAxes          = document.getElementById('devices-map-axes');
         _mapEmbryos       = document.getElementById('devices-map-embryos');
+        _detectBtn        = document.getElementById('devices-detect-btn');
+        _detectList       = document.getElementById('devices-detect-list');
         _mapMarker        = document.getElementById('devices-map-marker');
         _mapMarkerPulse   = document.getElementById('devices-map-marker-pulse');
         _mapMarkerRing    = document.getElementById('devices-map-marker-ring');
@@ -187,6 +197,7 @@ const DevicesManager = (function () {
 
         _camPanel        = document.getElementById('devices-camera-panel');
         _camToggle       = document.getElementById('devices-camera-toggle');
+        _camExpand       = document.getElementById('devices-camera-expand');
         _camImg          = document.getElementById('devices-camera-img');
         _camPlaceholder  = document.getElementById('devices-camera-placeholder');
         _camStage        = _camPanel ? _camPanel.querySelector('.devices-camera-stage') : null;
@@ -416,6 +427,7 @@ const DevicesManager = (function () {
         } else {
             renderEmbryos();
         }
+        renderEmbryoListPanel();
     }
 
     // =====================================================================
@@ -646,7 +658,7 @@ const DevicesManager = (function () {
     }
 
     function handleEmbryoDetected(payload) {
-        if (_upsertEmbryo(payload)) renderEmbryos();
+        if (_upsertEmbryo(payload)) { renderEmbryos(); renderEmbryoListPanel(); }
     }
 
     function handleStatusChanged(payload) {
@@ -659,6 +671,7 @@ const DevicesManager = (function () {
         if (idx >= 0) {
             _embryos[idx] = Object.assign({}, _embryos[idx], { role: newRole });
             renderEmbryos();
+            renderEmbryoListPanel();
         } else {
             // Embryo we haven't seen yet — refetch to be safe.
             loadEmbryos();
@@ -1364,9 +1377,21 @@ const DevicesManager = (function () {
         }
     }
 
+    function toggleCameraExpand() {
+        if (!_camPanel) return;
+        const expanded = _camPanel.classList.toggle('expanded');
+        if (_camExpand) {
+            _camExpand.classList.toggle('active', expanded);
+            _camExpand.setAttribute('aria-pressed', expanded ? 'true' : 'false');
+            _camExpand.title = expanded ? 'Shrink view' : 'Enlarge view';
+            _camExpand.textContent = expanded ? '⤡' : '⤢';
+        }
+    }
+
     function setupCameraWiring() {
         if (!_camToggle) return;
         _camToggle.addEventListener('click', toggleCameraStream);
+        if (_camExpand) _camExpand.addEventListener('click', toggleCameraExpand);
         applyCameraState(false);
         if (typeof ClientEventBus !== 'undefined') {
             ClientEventBus.on('BOTTOM_CAMERA_FRAME', handleCameraFrame);
@@ -2420,11 +2445,179 @@ const DevicesManager = (function () {
         scheduleStaleCheck();
     }
 
+    // =====================================================================
+    // Embryo detection + per-embryo stage centring (Map view)
+    // =====================================================================
+    // Single source of truth: the canonical _embryos list (fed by
+    // EMBRYOS_UPDATE / /api/embryos/current). Detect registers hits server-side
+    // into the experiment, which broadcasts EMBRYOS_UPDATE back here — the same
+    // list that imported / timelapse / manually-marked embryos live in. The
+    // panel below renders that one list with a Centre + remove action per row.
+
+    // Render the Embryos card list from _embryos. Called from renderEmbryos()
+    // so the card and the map dots always reflect the same canonical state.
+    function renderEmbryoListPanel() {
+        if (!_detectList) return;
+        _detectList.innerHTML = '';
+        if (!_embryos || !_embryos.length) {
+            const empty = document.createElement('div');
+            empty.className = 'devices-detect-empty';
+            empty.textContent = _detecting
+                ? 'Detecting…'
+                : 'No embryos yet — press Detect';
+            _detectList.appendChild(empty);
+            return;
+        }
+        _embryos.forEach((emb, i) => {
+            const xy = embryoResolvedXY(emb);
+            const row = document.createElement('div');
+            row.className = 'devices-detect-row';
+            row.setAttribute('data-embryo-id', emb.id || '');
+
+            const dot = document.createElement('span');
+            dot.className = 'devices-detect-dot';
+            dot.style.background = _ROLE_COLOR[emb.role] || _ROLE_COLOR.unassigned;
+            dot.textContent = embryoLabelText(emb.id, i);
+            row.appendChild(dot);
+
+            const coord = document.createElement('span');
+            coord.className = 'devices-detect-coord';
+            coord.textContent = xy
+                ? `(${xy.x.toFixed(0)}, ${xy.y.toFixed(0)}) µm`
+                : 'no position';
+            row.appendChild(coord);
+
+            const center = document.createElement('button');
+            center.className = 'devices-detect-center';
+            center.type = 'button';
+            center.textContent = 'Center';
+            center.disabled = !xy;
+            center.addEventListener('click', () => centerOnEmbryo(emb, center));
+            row.appendChild(center);
+
+            const remove = document.createElement('button');
+            remove.className = 'devices-detect-remove';
+            remove.type = 'button';
+            remove.title = 'Remove this embryo';
+            remove.setAttribute('aria-label', 'Remove embryo');
+            remove.textContent = '✕';
+            remove.addEventListener('click', () => removeEmbryo(emb, remove));
+            row.appendChild(remove);
+
+            _detectList.appendChild(row);
+        });
+    }
+
+    async function runDetection() {
+        if (_detecting || !_detectBtn) return;
+        _detecting = true;
+        _detectBtn.disabled = true;
+        _detectBtn.textContent = 'Detecting…';
+        renderEmbryoListPanel();
+        try {
+            const res = await fetch('/api/devices/detect_embryos', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({}),
+            });
+            if (!res.ok) {
+                const detail = await res.text();
+                console.error('Embryo detection failed:', detail);
+                if (typeof showGentlyToast === 'function') {
+                    showGentlyToast(`Detection failed (${res.status})`);
+                }
+                return;
+            }
+            const data = await res.json();
+            // The canonical list refreshes via EMBRYOS_UPDATE; just report.
+            if (typeof showGentlyToast === 'function') {
+                const n = Array.isArray(data.registered) ? data.registered.length : 0;
+                showGentlyToast(`Detected ${n} embryo${n === 1 ? '' : 's'}`);
+            }
+        } catch (err) {
+            console.error('Detection request failed:', err);
+            if (typeof showGentlyToast === 'function') {
+                showGentlyToast(`Detection error: ${err.message}`);
+            }
+        } finally {
+            _detecting = false;
+            _detectBtn.disabled = false;
+            _detectBtn.textContent = 'Detect';
+            renderEmbryoListPanel();
+        }
+    }
+
+    async function centerOnEmbryo(emb, btn) {
+        const xy = emb ? embryoResolvedXY(emb) : null;
+        if (!xy) return;
+        const num = embryoNumberFor(emb);
+        if (btn) { btn.disabled = true; btn.textContent = '…'; }
+        try {
+            const res = await fetch('/api/devices/stage/move', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ x: xy.x, y: xy.y }),
+            });
+            if (!res.ok) {
+                console.error('Centre failed:', await res.text());
+                if (typeof showGentlyToast === 'function') {
+                    showGentlyToast(`Centre failed (${res.status})`);
+                }
+                return;
+            }
+            if (typeof showGentlyToast === 'function') {
+                showGentlyToast(
+                    `Centred on embryo ${num} — (${xy.x.toFixed(0)}, ${xy.y.toFixed(0)}) µm`
+                );
+            }
+        } catch (err) {
+            console.error('Centre request failed:', err);
+            if (typeof showGentlyToast === 'function') {
+                showGentlyToast(`Centre error: ${err.message}`);
+            }
+        } finally {
+            if (btn) { btn.disabled = false; btn.textContent = 'Center'; }
+        }
+    }
+
+    async function removeEmbryo(emb, btn) {
+        if (!emb || !emb.id) return;
+        const num = embryoNumberFor(emb);
+        if (!window.confirm(`Remove embryo ${num}?`)) return;
+        if (btn) btn.disabled = true;
+        try {
+            const res = await fetch(`/api/embryos/${encodeURIComponent(emb.id)}`, {
+                method: 'DELETE',
+            });
+            if (!res.ok) {
+                console.error('Remove failed:', await res.text());
+                if (typeof showGentlyToast === 'function') {
+                    showGentlyToast(`Remove failed (${res.status})`);
+                }
+                if (btn) btn.disabled = false;
+                return;
+            }
+            // EMBRYOS_UPDATE refreshes the list + map dots.
+        } catch (err) {
+            console.error('Remove request failed:', err);
+            if (typeof showGentlyToast === 'function') {
+                showGentlyToast(`Remove error: ${err.message}`);
+            }
+            if (btn) btn.disabled = false;
+        }
+    }
+
+    function setupDetectWiring() {
+        if (_detectBtn) _detectBtn.addEventListener('click', runDetection);
+        renderEmbryoListPanel();
+    }
+
     function init() {
         cacheDom();
         setupViewSwitcher();
         setupCameraWiring();
         setupManualWiring();
+        setupDetectWiring();
         setupRoomLight();
         setupTemperature();
         loadCoverslip();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 109d3be8..62c79e24 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -533,7 +533,10 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                         </svg>
                     </div>
 
-                    <!-- TOP RIGHT: station readout -->
+                    <!-- TOP RIGHT: station readout + detected-embryo rail.
+                         Stacked in one column so they share width and keep a
+                         consistent gap regardless of the readout's height. -->
+                    <div class="devices-map-rail" id="devices-map-rail">
                     <div class="devices-map-readout" id="devices-map-readout">
                         <div class="devices-readout-head">
                             <span class="devices-readout-led" id="devices-readout-led"></span>
@@ -552,6 +555,24 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                         </div>
                     </div>
 
+                    <!-- Detected-embryo list + bottom-cam detect trigger.
+                         Standalone manual workflow: run SAM detection on the
+                         bottom camera, then centre the stage on each embryo. -->
+                    <div class="devices-detect-panel" id="devices-detect-panel">
+                        <div class="devices-detect-head">
+                            <span class="devices-detect-title">Embryos</span>
+                            <button class="devices-detect-btn" id="devices-detect-btn" type="button"
+                                    title="Detect embryos on the bottom camera">Detect</button>
+                        </div>
+                        <div class="devices-detect-list" id="devices-detect-list">
+                            <div class="devices-detect-empty" id="devices-detect-empty">
+                                No embryos yet — press Detect
+                            </div>
+                        </div>
+                        <div class="devices-detect-foot" id="devices-detect-foot" hidden></div>
+                    </div>
+                    </div>
+
                     <!-- BOTTOM LEFT: scale bar -->
                     <div class="devices-scalebar" id="devices-scalebar">
                         <div class="devices-scalebar-track">
@@ -575,7 +596,12 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                                 <span class="devices-camera-led" id="devices-camera-led"></span>
                                 <span>Bottom camera</span>
                             </span>
-                            <button class="devices-camera-toggle" id="devices-camera-toggle" type="button">Start</button>
+                            <div class="devices-camera-head-btns">
+                                <button class="devices-camera-expand" id="devices-camera-expand" type="button"
+                                        title="Enlarge view" aria-label="Enlarge bottom-camera view"
+                                        aria-pressed="false">⤢</button>
+                                <button class="devices-camera-toggle" id="devices-camera-toggle" type="button">Start</button>
+                            </div>
                         </div>
                         <div class="devices-camera-stage">
                             <img class="devices-camera-img" id="devices-camera-img" alt="bottom camera live frame">

From 6ffe1f96a852322e346727790c0f0079ebd9d867 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 17:54:15 +0530
Subject: [PATCH 269/314] =?UTF-8?q?docs(spec):=20bottom-cam=E2=86=92SPIM?=
 =?UTF-8?q?=20Operator=20surface=20design=20(sub-project=20A)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 ...6-30-bottom-cam-operator-surface-design.md | 123 ++++++++++++++++++
 1 file changed, 123 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-06-30-bottom-cam-operator-surface-design.md

diff --git a/docs/superpowers/specs/2026-06-30-bottom-cam-operator-surface-design.md b/docs/superpowers/specs/2026-06-30-bottom-cam-operator-surface-design.md
new file mode 100644
index 00000000..4228e84b
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-30-bottom-cam-operator-surface-design.md
@@ -0,0 +1,123 @@
+# Bottom-cam → SPIM Operator Surface ("Operate" view) — Design
+
+Date: 2026-06-30
+Status: Approved (proceed to implementation)
+Branch: feature/temperature-operations-all
+
+## Purpose
+
+A single, professional, guided operator surface for the manual bottom-camera →
+SPIM acquisition workflow, replacing the scattered current UX (bottom cam on the
+Map view, SPIM controls on the Manual view, embryo marking on the Embryos page).
+Mirrors how the operator physically works the rig:
+
+1. Focus the bottom objective on the embryos.
+2. Mark **all** embryos in one pass (a single FOV holds them).
+3. Per embryo: center → lower the SPIM head → focus the SPIM (LED on) → acquire.
+
+This is sub-project **A** (the spine). Two data flywheels hang off it and are
+specified separately: **B** marking→localization labels (retire SAM), **C**
+manual-focus→autofocus-validation. A exposes the hook points (confirm, focus
+score) they will tap, but does not implement them.
+
+## Settled decisions
+
+- **Home:** a new `Operate` view in the device tab, alongside Map/Details/3D/Manual.
+  One purpose per view: Map stays a passive spatial monitor; Manual stays raw
+  knobs. The Detect/Center/enlarge controls already added to Map migrate to Operate;
+  Map keeps only read-only embryo dots.
+- **Focus control:** software **nudge** buttons (± fixed steps), hard-fenced to
+  the axis limits (F-drive floor 30 µm). **No autofocus** (objective-crash risk).
+  Live focus-score readout to assist.
+- **Marking:** batch — mark all embryos on one frozen full-res frame. **Positions
+  only, no roles.** Roles are a separate, later, optional concern.
+- **SPIM focus step:** inline in Operate (lightsheet live + galvo/piezo/LED nudges),
+  not a handoff to Manual.
+- **Single source of truth:** the canonical `experiment.embryos` list (already wired
+  via EMBRYOS_UPDATE / /api/embryos/current). Detect feeds it through a
+  human-confirm step, not a side list.
+- **UI quality:** treat as a design pass (frontend-design), not a port of the
+  amateur marking canvas.
+
+## Architecture
+
+New device-tab view `operate` (devices.js view list becomes
+`['operate','map','details','optical3d','manual']`), three vertical zones:
+
+1. **Survey** — enlarged bottom-cam live; bottom-Z focus nudge (fenced) + live
+   focus score; Detect (SAM → candidates) or click-to-mark on a frozen frame;
+   Confirm.
+2. **Embryos** — the one canonical list, each row with a state chip and select.
+3. **Acquire** (selected embryo) — Center → Lower SPIM head (F-drive, fenced) →
+   inline lightsheet live + galvo/piezo/LED nudges + focus score → Acquire volume.
+
+Per-embryo state machine (client-side, keyed by embryo id; persistence deferred):
+
+```
+marked ──Center──▶ centered ──Lower SPIM + focus──▶ focused ──Acquire──▶ imaged
+```
+
+### Component reuse
+
+| Need | Reuse | New |
+|---|---|---|
+| Bottom-cam live + enlarge | camera panel (built) | move into Operate |
+| Mark-all on frozen frame | MarkingManager interaction logic | re-homed canvas, redesigned, positions-only |
+| Embryo list + Center | SSOT list + stage/move (built) | per-embryo state chips |
+| SPIM focus | Manual galvo/piezo/LED/lightsheet-live endpoints | inline placement |
+| Acquire | /api/devices/acquire/volume | — |
+| Bottom-Z + F-drive nudge | DiSPIMZstage / DiSPIMFDrive device classes | device-factory wiring, polling, fenced endpoints |
+| Focus score | analysis/core.calculate_focus_score | inject into camera stream payloads |
+| Register marks (agent-free) | experiment.add_embryo | register-on-confirm endpoint |
+
+## New backend endpoints (web routes proxy → device layer)
+
+- `GET /api/devices/stage/bottom_z` · `POST /api/devices/stage/bottom_z/nudge {delta}`
+  — read + fenced nudge of the bottom-camera focus Z (DiSPIMZstage).
+- `GET /api/devices/spim/fdrive` · `POST /api/devices/spim/fdrive/nudge {delta}`
+  — read + fenced nudge of the SPIM-head F-drive (floor 30 µm; report distance-to-floor).
+- `POST /api/devices/detect_embryos` (revised) — return SAM candidates
+  `{embryos:[{pixel_x,pixel_y,stage_x_um,stage_y_um,confidence}], stage_position}`;
+  no auto-register.
+- `POST /api/devices/embryos/confirm {markers:[{pixel_x,pixel_y}], stage_position,
+  pixel_size_um, objective_mag}` — pixel→stage, register each into experiment.embryos
+  (role 'unassigned'), fire EMBRYOS_UPDATE. Agent-free.
+- Focus score injected into existing bottom-cam + lightsheet SSE payloads
+  (`focus_score` field), computed server-side on the full frame.
+
+Device-layer additions: instantiate DiSPIMZstage in the device factory when
+present; add bottom-Z and F-drive to the slow position poller; fenced nudge
+handlers (clamp/reject out-of-range).
+
+## Safety / error handling
+
+- All Z moves fenced server-side; device classes hard-enforce limits; out-of-range
+  → 4xx, surfaced in UI. Nudges are bounded single steps — no autonomous/repeated
+  moves.
+- Device layer down → 503; controls disabled with clear state.
+- Frozen-frame capture failure → error toast, stay in Survey. Confirm with zero
+  markers → disabled.
+- F-drive: never below floor; show distance-to-floor.
+
+## Testing
+
+- Backend (TDD): pixel→stage in register-on-confirm (reuse coordinate tests);
+  fenced Z endpoints reject out-of-range; focus-score payload shape.
+- Frontend: launch with the gently_perception shim; Chrome MCP drives
+  detect→mark→confirm→EMBRYOS_UPDATE, per-embryo state transitions, out-of-range
+  nudge blocked; screenshots + UI audit against the professional bar.
+- Rig-only: real Z moves, real SPIM focus, SAM on a live frame.
+
+## Out of scope (separate sub-projects)
+
+- B: persist (frame + pixel markers + roles) as localization labels; benchmark
+  classical/trained detectors vs SAM.
+- C: poll missing Z axes for passive focus-trace logging + offline validator.
+  (A wires the Z axes for read/move, which C extends to logging.)
+
+## MVP boundary
+
+Ship the Operate view end-to-end with maximal reuse: Survey (live + fenced bottom-Z
++ Detect/mark-all + Confirm), the SSOT list with state chips + Center, Acquire zone
+(F-drive nudge + inline SPIM focus controls + Acquire). Per-embryo state client-side.
+Defer label/focus-trace persistence (B/C).

From 223812c7c9c7699c9cbbfa2fb5878116f90a712c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 18:49:47 +0530
Subject: [PATCH 270/314] =?UTF-8?q?feat(operate):=20backend=20=E2=80=94=20?=
 =?UTF-8?q?fenced=20Z=20read/nudge,=20agent-free=20marking=20confirm,=20de?=
 =?UTF-8?q?tect=20candidates?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Device layer + client:
- Register bottom-cam focus Z (DiSPIMZstage, z_stage) in device_factory; poll
  it + the SPIM-head F-drive in the slow position stream.
- Fenced read+nudge handlers for bottom_z and fdrive (reject out-of-range; the
  device classes hard-enforce limits; F-drive floor is sacrosanct).
- Inject a focus score (analysis.core.calculate_focus_score on the full frame)
  into the bottom-cam + lightsheet stream payloads.
- Client: get_bottom_z/nudge_bottom_z/get_fdrive/nudge_fdrive.

Web routes (data.py):
- detect_embryos now RETURNS candidates (no auto-register) for the marking canvas.
- POST /api/devices/embryos/confirm — agent-free register of operator-confirmed
  markers into experiment.embryos (single source of truth), fires EMBRYOS_UPDATE.
- Proxies: stage/bottom_z[/nudge], spim/fdrive[/nudge].

RIG-NOTE: z_stage MMCore axis assumed ZStage:Z:32 + limits (50,250)µm — rig owner
to confirm. Nudges use direct device.set() (mirrors camera-exposure handler).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/client.py         |  22 ++++
 gently/hardware/dispim/device_factory.py |  21 +++
 gently/hardware/dispim/device_layer.py   | 160 ++++++++++++++++++++++-
 gently/ui/web/routes/data.py             | 158 +++++++++++++++++-----
 4 files changed, 326 insertions(+), 35 deletions(-)

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index b4b38557..b4461436 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -1050,6 +1050,28 @@ async def get_bottom_camera_exposure(self) -> dict:
         """Get current bottom camera exposure time."""
         return await self._api_get("/api/camera/exposure")
 
+    # ------------------------------------------------------------------
+    # Fenced focus axes — bottom-camera focus Z and SPIM-head F-drive.
+    # Read + relative nudge only (no autofocus). Out-of-range nudges come
+    # back as a non-success dict (the device layer returns 400).
+    # ------------------------------------------------------------------
+
+    async def get_bottom_z(self) -> dict:
+        """Current bottom-camera focus Z position + limits."""
+        return await self._api_get("/api/stage/bottom_z")
+
+    async def nudge_bottom_z(self, delta: float) -> dict:
+        """Fenced relative move of the bottom-camera focus Z by ``delta`` µm."""
+        return await self._api_post("/api/stage/bottom_z/nudge", {"delta": float(delta)})
+
+    async def get_fdrive(self) -> dict:
+        """Current SPIM-head F-drive position + limits + distance to floor."""
+        return await self._api_get("/api/spim/fdrive")
+
+    async def nudge_fdrive(self, delta: float) -> dict:
+        """Fenced relative move of the SPIM-head F-drive by ``delta`` µm."""
+        return await self._api_post("/api/spim/fdrive/nudge", {"delta": float(delta)})
+
     async def capture_bottom_image(
         self, use_led: bool = False, exposure_ms: float | None = None
     ) -> dict:
diff --git a/gently/hardware/dispim/device_factory.py b/gently/hardware/dispim/device_factory.py
index b0bfb81c..503cb491 100644
--- a/gently/hardware/dispim/device_factory.py
+++ b/gently/hardware/dispim/device_factory.py
@@ -71,6 +71,9 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
         "scanner_b_name": "Scanner:CD:33",
         "piezo_b_name": "PiezoStage:Q:35",
         "fdrive_name": "ZStage:V:37",
+        # Bottom-camera focus Z (sample Z). ASI Tiger "ZStage:Z:32" — distinct
+        # from the SPIM-head F-drive (ZStage:V:37). Registered defensively below.
+        "z_stage_name": "ZStage:Z:32",
         "bottom_camera_name": "Bottom PCO",
         "led_name": "LED:X:31",
     }
@@ -195,6 +198,24 @@ def create_devices_from_mmcore(core: pymmcore.CMMCore, config: dict | None = Non
     except Exception as e:
         logger.warning("Could not create F-drive (SPIM head): %s", e)
 
+    # Bottom-camera focus Z (sample Z). Registered defensively: rigs that don't
+    # expose the axis under z_stage_name simply skip it (focus stays manual).
+    try:
+        from .devices import DiSPIMZstage
+
+        z_stage_name = cfg.get("z_stage_name", "ZStage:Z:32")
+        loaded_devices = list(core.getLoadedDevices())
+        if z_stage_name in loaded_devices:
+            devices["z_stage"] = DiSPIMZstage(name=z_stage_name, core=core)
+            logger.info("Created bottom-camera focus Z (z_stage): %s", z_stage_name)
+        else:
+            logger.warning(
+                "z_stage (%s) not in loaded devices — bottom-cam focus Z absent; skipping",
+                z_stage_name,
+            )
+    except Exception as e:
+        logger.warning("Could not create z_stage (bottom-cam focus Z): %s", e)
+
     try:
         if cfg.get("led_name"):
             from .devices import DiSPIMLED
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 0042f5af..8383c486 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -621,6 +621,31 @@ def _read_slow_positions(self) -> dict[str, Any]:
             except Exception as exc:
                 logger.debug("Galvo position read failed: %s", exc)
 
+        # SPIM-head F-drive — not on its own knob loop, so 1 Hz is plenty.
+        # Streamed so the Operate view can show head height + distance-to-floor.
+        fdrive = self.devices.get("fdrive")
+        if fdrive is not None:
+            try:
+                data = fdrive.read()
+                out[fdrive.name] = {
+                    "Position": float(data[fdrive.name]["value"]),
+                    "kind": "fdrive",
+                }
+            except Exception as exc:
+                logger.debug("F-drive position read failed: %s", exc)
+
+        # Bottom-camera focus Z (sample Z) — present only on rigs that expose it.
+        z_stage = self.devices.get("z_stage")
+        if z_stage is not None:
+            try:
+                data = z_stage.read()
+                out[z_stage.name] = {
+                    "Position": float(data[z_stage.name]["value"]),
+                    "kind": "bottom_z",
+                }
+            except Exception as exc:
+                logger.debug("Bottom-Z position read failed: %s", exc)
+
         return out
 
     def _read_full_state(self) -> dict[str, dict[str, str]]:
@@ -894,6 +919,18 @@ def _encode_frame_for_stream(
         target_max_dim = max_dim if max_dim is not None else self._cam_target_max_dim
         jpeg_quality = quality if quality is not None else self._cam_jpeg_quality
 
+        # Focus score on the FULL frame (before downsampling) so the Operate
+        # view's focus readout reflects true sharpness, not the JPEG thumbnail.
+        # Best-effort: any failure just omits the field.
+        focus_score: float | None = None
+        try:
+            from gently.analysis.core import calculate_focus_score
+
+            focus_score = float(calculate_focus_score(img, algorithm="volath"))
+        except Exception as exc:
+            logger.debug("Focus score computation failed: %s", exc)
+            focus_score = None
+
         h, w = img.shape[:2]
         # Stride slicing — no interpolation, just take every Nth pixel.
         factor = max(1, max(h, w) // target_max_dim)
@@ -922,13 +959,16 @@ def _encode_frame_for_stream(
         if not ok:
             return None
         b64 = base64.b64encode(jpeg.tobytes()).decode("ascii")
-        return {
+        payload: dict[str, Any] = {
             "t": time.time(),
             "shape": [int(small.shape[0]), int(small.shape[1])],
             "downsample": factor,
             "mime": "image/jpeg",
             "jpeg_b64": b64,
         }
+        if focus_score is not None:
+            payload["focus_score"] = focus_score
+        return payload
 
     async def _bottom_camera_streamer(self):
         """Continuous grab/encode/broadcast loop. Runs while a subscriber lives.
@@ -2239,6 +2279,119 @@ async def handle_get_camera_exposure(self, request):
                 status=500,
             )
 
+    # ------------------------------------------------------------------
+    # Fenced focus axes — bottom-camera focus Z (z_stage) + SPIM-head F-drive.
+    # Read + relative nudge only; the device classes enforce hard limits, and
+    # the handlers reject out-of-range targets with 400. No autofocus.
+    # ------------------------------------------------------------------
+
+    def _nudge_axis_blocking(self, device, target: float) -> float:
+        """Blocking: move a fenced ophyd positioner to ``target`` and return the
+        new position. ``device.set()`` enforces the hardware limits."""
+        status = device.set(target)
+        try:
+            status.wait()
+        except Exception:
+            logger.exception("Axis move to %.2f did not complete cleanly", target)
+        return float(device.read()[device.name]["value"])
+
+    def _axis_status_response(self, device_key: str, label: str):
+        device = self.devices.get(device_key)
+        if device is None:
+            return web.json_response(
+                {"success": False, "error": f"{label} device not found"}, status=503
+            )
+        lo, hi = device.limits
+        try:
+            pos = float(device.read()[device.name]["value"])
+        except Exception as exc:
+            return web.json_response(
+                {"success": False, "error": f"position read failed: {exc}"}, status=502
+            )
+        return web.json_response(
+            {
+                "success": True,
+                "position": pos,
+                "min": float(lo),
+                "max": float(hi),
+                "distance_to_floor": pos - float(lo),
+            }
+        )
+
+    async def _handle_axis_nudge(self, request, device_key: str, label: str):
+        try:
+            data = await request.json()
+            delta = float(data.get("delta", 0.0))
+        except Exception:
+            return web.json_response(
+                {"success": False, "error": "numeric 'delta' required"}, status=400
+            )
+        device = self.devices.get(device_key)
+        if device is None:
+            return web.json_response(
+                {"success": False, "error": f"{label} device not found"}, status=503
+            )
+        lo, hi = device.limits
+        try:
+            cur = float(device.read()[device.name]["value"])
+        except Exception as exc:
+            return web.json_response(
+                {"success": False, "error": f"position read failed: {exc}"}, status=502
+            )
+        target = round(cur + delta, 2)
+        if not (float(lo) <= target <= float(hi)):
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": f"target {target} outside limits [{lo}, {hi}]",
+                    "position": cur,
+                    "min": float(lo),
+                    "max": float(hi),
+                },
+                status=400,
+            )
+        try:
+            async with self.pause_state_updates():
+                new_pos = await asyncio.to_thread(self._nudge_axis_blocking, device, target)
+        except ValueError as exc:  # device-level fence (defensive)
+            return web.json_response({"success": False, "error": str(exc)}, status=400)
+        except Exception as exc:
+            import traceback
+
+            return web.json_response(
+                {
+                    "success": False,
+                    "error": str(exc),
+                    "traceback": traceback.format_exc(),
+                },
+                status=500,
+            )
+        return web.json_response(
+            {
+                "success": True,
+                "position": new_pos,
+                "min": float(lo),
+                "max": float(hi),
+                "distance_to_floor": new_pos - float(lo),
+            }
+        )
+
+    async def handle_get_bottom_z(self, request):
+        """GET /api/stage/bottom_z — bottom-camera focus Z position + limits."""
+        return self._axis_status_response("z_stage", "Bottom-Z (z_stage)")
+
+    async def handle_nudge_bottom_z(self, request):
+        """POST /api/stage/bottom_z/nudge — fenced relative move of the bottom-camera focus Z."""
+        return await self._handle_axis_nudge(request, "z_stage", "Bottom-Z (z_stage)")
+
+    async def handle_get_fdrive(self, request):
+        """GET /api/spim/fdrive — SPIM-head F-drive position + limits + distance to floor."""
+        return self._axis_status_response("fdrive", "F-drive")
+
+    async def handle_nudge_fdrive(self, request):
+        """POST /api/spim/fdrive/nudge — fenced relative move of the SPIM-head F-drive."""
+        return await self._handle_axis_nudge(request, "fdrive", "F-drive")
+
     async def handle_get_plan_log(self, request):
         """GET /api/plan_log - Get recent plan execution log with timing"""
         try:
@@ -3205,6 +3358,11 @@ async def on_start(self):
         self._app.router.add_post("/api/camera/led_mode", self.handle_set_camera_led_mode)
         self._app.router.add_post("/api/camera/exposure", self.handle_set_camera_exposure)
         self._app.router.add_get("/api/camera/exposure", self.handle_get_camera_exposure)
+        # Fenced focus axes (read + relative nudge; no autofocus)
+        self._app.router.add_get("/api/stage/bottom_z", self.handle_get_bottom_z)
+        self._app.router.add_post("/api/stage/bottom_z/nudge", self.handle_nudge_bottom_z)
+        self._app.router.add_get("/api/spim/fdrive", self.handle_get_fdrive)
+        self._app.router.add_post("/api/spim/fdrive/nudge", self.handle_nudge_fdrive)
         self._app.router.add_post("/api/light_source/power", self.handle_set_light_source_power)
         self._app.router.add_get("/api/light_source/power", self.handle_get_light_source_power)
         self._app.router.add_post("/api/laser/config", self.handle_set_laser_config)
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index e21a3422..d9867c2a 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -608,24 +608,26 @@ async def stage_move(payload: dict = Body(...)):  # noqa: B008
             logger.exception("Stage move command failed")
             raise HTTPException(status_code=502, detail=f"stage move failed: {exc}") from exc
 
+    def _num(v):
+        try:
+            return float(v)
+        except (TypeError, ValueError):
+            return None
+
     @router.post("/api/devices/detect_embryos", dependencies=[Depends(require_control)])
     async def detect_embryos(payload: dict = Body(default={})):  # noqa: B008
-        """Run bottom-camera embryo detection and register the hits into the
-        canonical experiment embryo list — the single source of truth.
-
-        Registration goes through ExperimentState.add_embryo(), which fires
-        EMBRYOS_UPDATE (and EMBRYO_DETECTED), so the device-tab Map view and
-        every other embryo consumer refresh automatically — there is no second
-        list. Raw SAM hits are added as role 'unassigned'; the operator prunes
-        false positives from the same list (DELETE /api/embryos/{id}). Each
-        Detect run appends fresh hits with new ids.
+        """Run bottom-camera embryo detection and RETURN the candidates for the
+        Operate-view marking canvas. Does NOT register — the operator confirms
+        (add/remove/relocate) on a frozen frame, then POSTs /api/devices/embryos/
+        confirm. This keeps the human in the loop and the canonical embryo list
+        clean (a marking step, not a blind auto-register).
 
         Body (all optional): {exposure_ms, min_confidence, brightness_percentile,
-        min_area, max_area, use_claude_review}. Claude review defaults OFF so the
-        manual flow is fast and needs no API key; brightness+SAM detections
-        already carry stage coordinates.
+        min_area, max_area, use_claude_review}. Claude review defaults OFF.
 
-        Returns: {success, detected, registered: [embryo_id, ...]}.
+        Returns: {success, count, stage_position: [x, y] | null,
+                  embryos: [{embryo_id, pixel_x, pixel_y, stage_x_um, stage_y_um,
+                             confidence, area_pixels, bbox_pixel}]}.
         """
         client = _resolve_client()
         if client is None:
@@ -634,7 +636,6 @@ async def detect_embryos(payload: dict = Body(default={})):  # noqa: B008
             raise HTTPException(
                 status_code=503, detail="SAM detection not available on device layer"
             )
-        agent = _require_agent_with_experiment()
 
         kw: dict = {"use_claude_review": bool(payload.get("use_claude_review", False))}
         for key, cast in (
@@ -653,44 +654,133 @@ async def detect_embryos(payload: dict = Body(default={})):  # noqa: B008
             raise HTTPException(status_code=502, detail=f"detection failed: {exc}") from exc
 
         if not result.get("success"):
-            detail = result.get("error", "detection failed")
-            raise HTTPException(status_code=502, detail=str(detail))
+            raise HTTPException(
+                status_code=502, detail=str(result.get("error", "detection failed"))
+            )
 
-        import uuid
+        embryos = []
+        for emb in result.get("embryos", []) or []:
+            bbox = emb.get("bbox_pixel")
+            embryos.append(
+                {
+                    "embryo_id": emb.get("embryo_id"),
+                    "pixel_x": _num(emb.get("pixel_x")),
+                    "pixel_y": _num(emb.get("pixel_y")),
+                    "stage_x_um": _num(emb.get("stage_x_um")),
+                    "stage_y_um": _num(emb.get("stage_y_um")),
+                    "confidence": _num(emb.get("confidence")),
+                    "area_pixels": emb.get("area_pixels"),
+                    "bbox_pixel": list(bbox) if bbox is not None else None,
+                }
+            )
+        pos = result.get("stage_position")
+        return {
+            "success": True,
+            "count": len(embryos),
+            "stage_position": list(pos) if pos is not None else None,
+            "embryos": embryos,
+        }
 
-        def _num(v):
-            try:
-                return float(v)
-            except (TypeError, ValueError):
-                return None
+    @router.post("/api/devices/embryos/confirm", dependencies=[Depends(require_control)])
+    async def confirm_embryos(payload: dict = Body(...)):  # noqa: B008
+        """Register operator-confirmed markers into the canonical embryo list.
 
-        def _next_embryo_id() -> str:
+        Agent-free commit step for the Operate-view marking canvas. The client
+        computes each marker's stage XY from the frozen frame (SAM candidates
+        carry server-computed stage coords; clicked markers are converted with
+        the frame's downsample-aware transform), so the server just registers
+        via ExperimentState.add_embryo(role='unassigned'), firing EMBRYOS_UPDATE.
+
+        Body: {markers: [{stage_x_um, stage_y_um, confidence?}]}.
+        Returns {success, registered: [embryo_id, ...]}.
+        """
+        agent = _require_agent_with_experiment()
+        markers = payload.get("markers") or []
+
+        def _next_embryo_id(taken: set) -> str:
             n = 1
-            while f"embryo_{n}" in agent.experiment.embryos:
+            while f"embryo_{n}" in agent.experiment.embryos or f"embryo_{n}" in taken:
                 n += 1
             return f"embryo_{n}"
 
-        detections = result.get("embryos", []) or []
+        import uuid
+
         registered: list[str] = []
-        for emb in detections:
-            sx, sy = _num(emb.get("stage_x_um")), _num(emb.get("stage_y_um"))
+        taken: set = set()
+        for m in markers:
+            sx, sy = _num(m.get("stage_x_um")), _num(m.get("stage_y_um"))
             if sx is None or sy is None:
                 continue
-            emb_id = _next_embryo_id()
+            emb_id = _next_embryo_id(taken)
+            taken.add(emb_id)
             agent.experiment.add_embryo(
                 embryo_id=emb_id,
                 position={"x": sx, "y": sy},
-                confidence=_num(emb.get("confidence")) or 0.0,
+                confidence=_num(m.get("confidence")) or 0.0,
                 uid=str(uuid.uuid4()),
                 role="unassigned",
             )
             registered.append(emb_id)
 
-        return {
-            "success": True,
-            "detected": len(detections),
-            "registered": registered,
-        }
+        return {"success": True, "registered": registered}
+
+    # ------------------------------------------------------------------
+    # Focus Z axes (Operate view) — fenced read + nudge
+    # ------------------------------------------------------------------
+
+    @router.get("/api/devices/stage/bottom_z")
+    async def get_bottom_z():
+        """Bottom-camera focus Z position + limits (read-only)."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.get_bottom_z()
+        except Exception as exc:
+            logger.debug("bottom_z read failed: %s", exc)
+            raise HTTPException(status_code=502, detail=f"bottom_z read failed: {exc}") from exc
+
+    @router.post("/api/devices/stage/bottom_z/nudge", dependencies=[Depends(require_control)])
+    async def nudge_bottom_z(payload: dict = Body(...)):  # noqa: B008
+        """Nudge the bottom-camera focus Z by {delta} µm (fenced to its limits)."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        delta = _num(payload.get("delta"))
+        if delta is None:
+            raise HTTPException(status_code=400, detail="delta required")
+        try:
+            return await client.nudge_bottom_z(delta)
+        except Exception as exc:
+            logger.exception("bottom_z nudge failed")
+            raise HTTPException(status_code=502, detail=f"bottom_z nudge failed: {exc}") from exc
+
+    @router.get("/api/devices/spim/fdrive")
+    async def get_fdrive():
+        """SPIM-head F-drive position + limits + distance-to-floor (read-only)."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            return await client.get_fdrive()
+        except Exception as exc:
+            logger.debug("fdrive read failed: %s", exc)
+            raise HTTPException(status_code=502, detail=f"fdrive read failed: {exc}") from exc
+
+    @router.post("/api/devices/spim/fdrive/nudge", dependencies=[Depends(require_control)])
+    async def nudge_fdrive(payload: dict = Body(...)):  # noqa: B008
+        """Nudge the SPIM-head F-drive by {delta} µm (fenced; never below floor)."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        delta = _num(payload.get("delta"))
+        if delta is None:
+            raise HTTPException(status_code=400, detail="delta required")
+        try:
+            return await client.nudge_fdrive(delta)
+        except Exception as exc:
+            logger.exception("fdrive nudge failed")
+            raise HTTPException(status_code=502, detail=f"fdrive nudge failed: {exc}") from exc
 
     # ------------------------------------------------------------------
     # Acquisition

From 7a95f049c46e5c2c192bb47136edddc9a18efefe Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 18:49:47 +0530
Subject: [PATCH 271/314] =?UTF-8?q?feat(operate):=20Operate=20view=20?=
 =?UTF-8?q?=E2=80=94=20guided=20bottom-cam=20=E2=86=92=20SPIM=20operator?=
 =?UTF-8?q?=20surface?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

New device-tab 'Operate' view (1st in the switcher, hotkey 'o'): a single guided
flow mirroring the physical workflow, replacing the scattered detect/mark/SPIM UX.

- Zone 1 Survey & mark: enlarged bottom-cam live + fenced bottom-Z focus nudge +
  live focus score; Detect (SAM candidates) or click-to-mark on a FROZEN frame;
  positions only (no forced roles); Confirm → register into the canonical list.
- Zone 2 Embryos: the single source of truth (EMBRYOS_UPDATE) with per-embryo
  state chips (marked→centered→focused→imaged) + select.
- Zone 3 Acquire: Center (stage move) → lower SPIM head (F-drive, fenced) →
  inline SPIM focus (lightsheet live + galvo/piezo/LED nudge + focus score) →
  Acquire volume.

Professional, theme-aware styling (operate.css). DevicesManager activates/
deactivates OperateManager on view switch (streams only run while visible).
Verified in-browser end-to-end (detect→mark→confirm→list→per-embryo cycle).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/operate.css | 194 ++++++++++++
 gently/ui/web/static/js/devices.js   |  11 +-
 gently/ui/web/static/js/operate.js   | 451 +++++++++++++++++++++++++++
 gently/ui/web/templates/index.html   |  97 ++++++
 4 files changed, 751 insertions(+), 2 deletions(-)
 create mode 100644 gently/ui/web/static/css/operate.css
 create mode 100644 gently/ui/web/static/js/operate.js

diff --git a/gently/ui/web/static/css/operate.css b/gently/ui/web/static/css/operate.css
new file mode 100644
index 00000000..29ba5f90
--- /dev/null
+++ b/gently/ui/web/static/css/operate.css
@@ -0,0 +1,194 @@
+/* Operate view — guided bottom-cam → SPIM operator surface.
+   Theme-aware via the global tokens (--bg-card, --border, --text, --accent …). */
+
+.operate {
+    display: flex;
+    flex-direction: column;
+    gap: 0.9rem;
+    padding: 0.25rem 0.1rem 1.5rem;
+    font-family: 'Inter Tight', system-ui, sans-serif;
+    color: var(--text);
+}
+
+.op-zone {
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 0.85rem 1rem 1rem;
+}
+.op-zone-head {
+    display: flex;
+    align-items: center;
+    gap: 0.55rem;
+    font-size: 0.95rem;
+    font-weight: 600;
+    letter-spacing: 0.01em;
+    margin-bottom: 0.85rem;
+    color: var(--text);
+}
+.op-step {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 22px; height: 22px;
+    border-radius: 50%;
+    background: var(--accent);
+    color: #fff;
+    font-size: 0.74rem;
+    font-weight: 700;
+}
+.op-count, .op-sel {
+    font-size: 0.8rem;
+    font-weight: 500;
+    color: var(--text-muted);
+}
+
+/* survey + acquire share a camera|rail two-column body.
+   Fixed body height keeps all three zones on screen; the camera fills it and
+   the image letterboxes (object-fit: contain) so any frame aspect fits. */
+.op-survey-body, .op-acquire-body {
+    display: flex;
+    gap: 1rem;
+    align-items: stretch;
+    height: 340px;
+}
+.op-cam {
+    position: relative;
+    flex: 1 1 auto;
+    min-width: 0;
+    height: 100%;
+    background: var(--img-bg);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    overflow: hidden;
+}
+.op-cam-img {
+    width: 100%; height: 100%;
+    object-fit: contain;
+    display: block;
+    opacity: 0;
+    transition: opacity 0.2s;
+}
+.op-cam-img.has-frame { opacity: 1; }
+.op-mark-canvas {
+    position: absolute; inset: 0;
+    width: 100%; height: 100%;
+    pointer-events: none;
+}
+.op-cam.op-marking { cursor: crosshair; box-shadow: inset 0 0 0 2px var(--accent-green); }
+.op-cam.op-marking .op-mark-canvas { pointer-events: auto; }
+.op-cam-ph {
+    position: absolute; inset: 0;
+    display: flex; align-items: center; justify-content: center;
+    color: var(--text-muted);
+    font-size: 0.8rem;
+    letter-spacing: 0.04em;
+}
+
+/* control rail */
+.op-rail {
+    flex: 0 0 248px;
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+}
+.op-field { display: flex; flex-direction: column; gap: 0.4rem; }
+.op-label {
+    font-size: 0.66rem;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    color: var(--text-muted);
+}
+.op-readout {
+    font-size: 0.82rem;
+    color: var(--text);
+    font-variant-numeric: tabular-nums;
+}
+.op-readout b { font-weight: 600; }
+.op-sep { color: var(--text-muted); margin: 0 0.4rem; }
+
+/* buttons */
+.op-btn {
+    appearance: none;
+    background: var(--bg-hover);
+    border: 1px solid var(--border);
+    color: var(--text);
+    font: 600 0.8rem/1 'Inter Tight', system-ui, sans-serif;
+    padding: 0.5rem 0.75rem;
+    border-radius: 7px;
+    cursor: pointer;
+    transition: background 0.13s, border-color 0.13s, color 0.13s, opacity 0.13s;
+}
+.op-btn:hover:not(:disabled) { border-color: var(--accent); color: var(--accent); }
+.op-btn:disabled { opacity: 0.45; cursor: not-allowed; }
+.op-btn-primary { background: var(--accent); border-color: var(--accent); color: #fff; }
+.op-btn-primary:hover:not(:disabled) { background: var(--accent-hover); border-color: var(--accent-hover); color: #fff; }
+.op-btn-ghost { background: transparent; }
+.op-btn-on, .op-btn-toggle[aria-pressed="true"] { background: var(--accent-green); border-color: var(--accent-green); color: #06281a; }
+
+.op-mark-actions, .op-spim-controls { display: flex; gap: 0.5rem; }
+.op-mark-actions .op-btn, .op-spim-controls .op-btn { flex: 1; }
+.op-hint { font-size: 0.72rem; color: var(--text-muted); line-height: 1.4; }
+
+/* nudge clusters */
+.op-nudge { display: flex; gap: 0.35rem; }
+.op-nbtn {
+    flex: 1;
+    background: var(--bg-hover);
+    border: 1px solid var(--border);
+    color: var(--text);
+    font: 600 0.74rem/1 'Inter Tight', system-ui, sans-serif;
+    font-variant-numeric: tabular-nums;
+    padding: 0.4rem 0.3rem;
+    border-radius: 6px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+}
+.op-nbtn:hover { border-color: var(--accent); color: var(--accent); }
+.op-micro {
+    display: flex; align-items: center; gap: 0.4rem;
+    font-size: 0.74rem; color: var(--text-muted);
+    font-variant-numeric: tabular-nums;
+}
+.op-micro b { color: var(--text); min-width: 2.2em; text-align: center; }
+.op-micro .op-nbtn { flex: 0 0 auto; width: 26px; }
+
+/* embryo list */
+.op-embryo-list { display: flex; flex-direction: column; gap: 0.3rem; max-height: 220px; overflow-y: auto; }
+.op-empty { color: var(--text-muted); font-size: 0.82rem; padding: 0.4rem 0.1rem; }
+.op-erow {
+    display: flex; align-items: center; gap: 0.6rem;
+    padding: 0.45rem 0.55rem;
+    border: 1px solid transparent;
+    border-radius: 7px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s;
+}
+.op-erow:hover { background: var(--bg-hover); }
+.op-erow-sel { background: var(--bg-hover); border-color: var(--accent); }
+.op-edot {
+    flex: 0 0 auto;
+    width: 22px; height: 22px;
+    border-radius: 50%;
+    display: inline-flex; align-items: center; justify-content: center;
+    color: #fff; font-size: 0.7rem; font-weight: 700;
+}
+.op-ecoord { flex: 1 1 auto; font-size: 0.8rem; font-variant-numeric: tabular-nums; color: var(--text); }
+.op-echip {
+    flex: 0 0 auto;
+    font-size: 0.64rem; font-weight: 600;
+    text-transform: uppercase; letter-spacing: 0.06em;
+    padding: 0.16rem 0.5rem;
+    border-radius: 999px;
+    border: 1px solid var(--border);
+    color: var(--text-muted);
+}
+.op-echip-centered { color: var(--accent); border-color: var(--accent); }
+.op-echip-focused { color: var(--accent-orange); border-color: var(--accent-orange); }
+.op-echip-imaged { color: var(--accent-green); border-color: var(--accent-green); }
+
+@media (max-width: 920px) {
+    .op-survey-body, .op-acquire-body { flex-direction: column; }
+    .op-rail { flex-basis: auto; }
+}
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index 905a7dc3..e7cb9b1b 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -14,7 +14,7 @@
  */
 const DevicesManager = (function () {
     const STALE_AFTER_MS = 4000;
-    const VIEWS = ['map', 'details', 'optical3d', 'manual'];
+    const VIEWS = ['operate', 'map', 'details', 'optical3d', 'manual'];
     const SVG_NS = 'http://www.w3.org/2000/svg';
 
     // Status / details DOM
@@ -2403,6 +2403,12 @@ const DevicesManager = (function () {
         // populateLaserPresets() runs after setLaserOff() so the select is always
         // seeded with the entry-safety state first.
         if (viewName === 'manual') { setLaserOff(); populateLaserPresets(); populateCameraRoles(); initTlForm(); populateTlDefaults(); }
+        // The Operate view owns its own module; activate/deactivate it so its
+        // camera + SPIM streams only run while it's the visible view.
+        if (typeof OperateManager !== 'undefined') {
+            if (viewName === 'operate') OperateManager.activate();
+            else OperateManager.deactivate();
+        }
     }
 
     function setupViewSwitcher() {
@@ -2412,7 +2418,8 @@ const DevicesManager = (function () {
         document.addEventListener('keydown', (e) => {
             if (typeof state !== 'undefined' && typeof TABS !== 'undefined' && state.tab !== TABS.DEVICES) return;
             if (e.target.matches('input, textarea, select, [contenteditable]')) return;
-            if (e.key === 'm') { e.preventDefault(); switchView('map'); }
+            if (e.key === 'o') { e.preventDefault(); switchView('operate'); }
+            else if (e.key === 'm') { e.preventDefault(); switchView('map'); }
             else if (e.key === 'd') { e.preventDefault(); switchView('details'); }
             else if (e.key === 'v') { e.preventDefault(); switchView('optical3d'); }
         });
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
new file mode 100644
index 00000000..9a7071c1
--- /dev/null
+++ b/gently/ui/web/static/js/operate.js
@@ -0,0 +1,451 @@
+/**
+ * Operate view — guided bottom-cam → SPIM operator surface.
+ *
+ * Three zones, mirroring the physical workflow:
+ *   1. Survey & mark  — live bottom cam, fenced bottom-Z focus nudge, Detect /
+ *                       click-to-mark all embryos on a frozen frame, Confirm.
+ *   2. Embryos        — the single canonical experiment.embryos list (EMBRYOS_UPDATE),
+ *                       each row a per-embryo state chip + select.
+ *   3. Acquire        — for the selected embryo: Center → lower SPIM head (F-drive,
+ *                       fenced) → focus SPIM (live + galvo/piezo/LED nudge) → Acquire.
+ *
+ * Single source of truth: marking confirms into experiment.embryos via the
+ * agent-free /api/devices/embryos/confirm endpoint; the list refreshes from the
+ * canonical EMBRYOS_UPDATE event. No autonomous Z moves — every focus move is a
+ * bounded, server-fenced nudge.
+ */
+const OperateManager = (function () {
+    // Camera transform constants (match gently/core/coordinates.py defaults).
+    const BASE_UM_PER_PX = 6.5 / 10.0;  // pixel_size_um / objective_mag
+    const MARK_HIT_PX = 14;             // click-to-remove radius (canvas px)
+
+    let _wired = false;
+    let _active = false;
+
+    // DOM
+    let _camImg, _camPh, _camStage, _markCanvas, _camToggle;
+    let _bzPos, _bzScore, _bzNudge;
+    let _detectBtn, _confirmBtn, _clearBtn, _markCount, _markHint;
+    let _embryoList, _embryoCount;
+    let _selLabel, _spimImg, _spimPh, _spimToggle, _ledBtn;
+    let _fdPos, _fdFloor, _fdNudge, _centerBtn, _acquireBtn;
+    let _gvVal, _pzVal, _spimScore;
+
+    // State
+    let _camOn = false, _spimOn = false;
+    let _lastFrame = null;        // last live bottom-cam payload {jpeg_b64, shape, downsample, focus_score}
+    let _marking = false;
+    let _frozenSrc = null;        // frozen image data URL
+    let _frozenFrame = null;      // {w, h, downsample} of the frozen frame (frame-space)
+    let _captureStage = [0, 0];   // stage XY at freeze time (µm)
+    let _markers = [];            // [{fx, fy, stageX, stageY, source}] fx/fy in frame-space px
+    let _embryos = [];            // canonical list (EMBRYOS_UPDATE shape)
+    let _selected = null;         // selected embryo id
+    const _states = {};           // embryo_id -> 'marked'|'centered'|'focused'|'imaged'
+    let _lastXY = null;           // {X, Y} from DEVICE_STATE_UPDATE
+    let _galvo = 0.0, _piezo = 50.0, _ledOn = false;
+
+    const _ROLE_COLOR = { test: '#ff66cc', calibration: '#00cccc', unassigned: '#8a8f98' };
+    const _STATE_LABEL = { marked: 'marked', centered: 'centered', focused: 'focused', imaged: 'imaged' };
+
+    function $(id) { return document.getElementById(id); }
+    function toast(msg) { if (typeof showGentlyToast === 'function') showGentlyToast(msg); }
+
+    async function postJSON(url, body) {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body || {}),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            const err = new Error(`${res.status} ${detail}`);
+            err.status = res.status;
+            throw err;
+        }
+        return res.json().catch(() => ({}));
+    }
+    async function getJSON(url) {
+        const res = await fetch(url);
+        if (!res.ok) throw new Error(String(res.status));
+        return res.json();
+    }
+
+    function cacheDom() {
+        _camImg = $('op-cam-img'); _camPh = $('op-cam-ph'); _camStage = $('op-cam-stage');
+        _markCanvas = $('op-mark-canvas'); _camToggle = $('op-cam-toggle');
+        _bzPos = $('op-bz-pos'); _bzScore = $('op-bz-score'); _bzNudge = $('op-bz-nudge');
+        _detectBtn = $('op-detect'); _confirmBtn = $('op-confirm'); _clearBtn = $('op-clear');
+        _markCount = $('op-mark-count'); _markHint = $('op-mark-hint');
+        _embryoList = $('op-embryo-list'); _embryoCount = $('op-embryo-count');
+        _selLabel = $('op-sel-label'); _spimImg = $('op-spim-img'); _spimPh = $('op-spim-ph');
+        _spimToggle = $('op-spim-toggle'); _ledBtn = $('op-led');
+        _fdPos = $('op-fd-pos'); _fdFloor = $('op-fd-floor'); _fdNudge = $('op-fd-nudge');
+        _centerBtn = $('op-center'); _acquireBtn = $('op-acquire');
+        _gvVal = $('op-gv'); _pzVal = $('op-pz'); _spimScore = $('op-spim-score');
+    }
+
+    // ---- Bottom-camera survey -------------------------------------------
+    async function toggleCamera() {
+        _camToggle.disabled = true;
+        try {
+            const ep = _camOn ? '/api/devices/bottom_camera/stream/stop'
+                              : '/api/devices/bottom_camera/stream/start';
+            const data = await postJSON(ep, {});
+            applyCameraState(!!data.streaming);
+        } catch (err) {
+            toast(`Camera toggle failed (${err.status || err.message})`);
+        } finally {
+            _camToggle.disabled = false;
+        }
+    }
+    function applyCameraState(on) {
+        _camOn = on;
+        _camToggle.textContent = on ? 'Stop camera' : 'Start camera';
+        _camToggle.classList.toggle('op-btn-on', on);
+        if (!on && !_marking) { _camImg.classList.remove('has-frame'); _camPh.style.display = ''; _camPh.textContent = 'Camera off'; }
+        else if (on && !_marking) { _camPh.textContent = 'waiting…'; }
+    }
+    function onBottomFrame(p) {
+        if (!p || !p.jpeg_b64) return;
+        _lastFrame = p;
+        if (p.focus_score != null) _bzScore.textContent = Number(p.focus_score).toFixed(3);
+        if (_marking) return;  // keep the frozen frame visible while marking
+        _camImg.src = `data:${p.mime || 'image/jpeg'};base64,${p.jpeg_b64}`;
+        if (!_camImg.classList.contains('has-frame')) { _camImg.classList.add('has-frame'); _camPh.style.display = 'none'; }
+    }
+
+    // ---- Marking --------------------------------------------------------
+    function umPerPxDisplay() {
+        const ds = (_frozenFrame && _frozenFrame.downsample) || 1;
+        return BASE_UM_PER_PX * ds;
+    }
+    // frame-space (downsampled px) -> stage µm, using the frozen capture pose.
+    function frameToStage(fx, fy) {
+        const u = umPerPxDisplay();
+        const cx = _frozenFrame.w / 2, cy = _frozenFrame.h / 2;
+        return [_captureStage[0] + (fx - cx) * u, _captureStage[1] - (fy - cy) * u];
+    }
+    function enterMarking(candidates) {
+        if (!_lastFrame) { toast('Start the camera first'); return false; }
+        _marking = true;
+        _frozenFrame = { w: _lastFrame.shape[1], h: _lastFrame.shape[0], downsample: _lastFrame.downsample || 1 };
+        _captureStage = _lastFrame.stage_position || (_lastXY ? [_lastXY.X, _lastXY.Y] : [0, 0]);
+        _frozenSrc = `data:${_lastFrame.mime || 'image/jpeg'};base64,${_lastFrame.jpeg_b64}`;
+        _camImg.src = _frozenSrc; _camImg.classList.add('has-frame'); _camPh.style.display = 'none';
+        _markers = [];
+        (candidates || []).forEach(c => {
+            const ds = _frozenFrame.downsample;
+            const fx = (c.pixel_x != null) ? c.pixel_x / ds : _frozenFrame.w / 2;
+            const fy = (c.pixel_y != null) ? c.pixel_y / ds : _frozenFrame.h / 2;
+            const stage = (c.stage_x_um != null && c.stage_y_um != null)
+                ? [c.stage_x_um, c.stage_y_um] : frameToStage(fx, fy);
+            _markers.push({ fx, fy, stageX: stage[0], stageY: stage[1], source: 'sam' });
+        });
+        _camStage.classList.add('op-marking');
+        _markHint.textContent = 'Click to add an embryo · click a marker to remove · Confirm when done.';
+        drawMarkers(); updateMarkActions();
+        return true;
+    }
+    function exitMarking() {
+        _marking = false; _markers = []; _frozenSrc = null; _frozenFrame = null;
+        _camStage.classList.remove('op-marking');
+        clearCanvas();
+        updateMarkActions();
+        _markHint.textContent = 'Start the camera, then Detect — or click the image to mark embryos.';
+        if (_camOn && _lastFrame) onBottomFrame(_lastFrame);
+    }
+    // rendered image rect (object-fit: contain) within the stage box.
+    function renderedRect() {
+        const sb = _camStage.getBoundingClientRect();
+        const fw = _frozenFrame ? _frozenFrame.w : (_lastFrame ? _lastFrame.shape[1] : sb.width);
+        const fh = _frozenFrame ? _frozenFrame.h : (_lastFrame ? _lastFrame.shape[0] : sb.height);
+        const ar = fw / fh, sar = sb.width / sb.height;
+        let w, h;
+        if (ar > sar) { w = sb.width; h = sb.width / ar; } else { h = sb.height; w = sb.height * ar; }
+        return { x: (sb.width - w) / 2, y: (sb.height - h) / 2, w, h, fw, fh, sb };
+    }
+    function clearCanvas() {
+        if (!_markCanvas) return;
+        const ctx = _markCanvas.getContext('2d');
+        ctx && ctx.clearRect(0, 0, _markCanvas.width, _markCanvas.height);
+    }
+    function drawMarkers() {
+        if (!_markCanvas || !_marking) return;
+        const r = renderedRect();
+        _markCanvas.width = Math.round(r.sb.width); _markCanvas.height = Math.round(r.sb.height);
+        const ctx = _markCanvas.getContext('2d');
+        ctx.clearRect(0, 0, _markCanvas.width, _markCanvas.height);
+        _markers.forEach((m, i) => {
+            const cx = r.x + (m.fx / r.fw) * r.w;
+            const cy = r.y + (m.fy / r.fh) * r.h;
+            ctx.beginPath(); ctx.arc(cx, cy, 11, 0, 7);
+            ctx.lineWidth = 2; ctx.strokeStyle = '#34d399'; ctx.stroke();
+            ctx.beginPath(); ctx.moveTo(cx - 6, cy); ctx.lineTo(cx + 6, cy);
+            ctx.moveTo(cx, cy - 6); ctx.lineTo(cx, cy + 6); ctx.stroke();
+            ctx.fillStyle = '#34d399'; ctx.font = '600 11px Inter Tight, system-ui, sans-serif';
+            ctx.fillText(String(i + 1), cx + 13, cy - 8);
+        });
+    }
+    function onCanvasClick(e) {
+        if (!_marking) return;
+        const r = renderedRect();
+        const rect = _markCanvas.getBoundingClientRect();
+        const cxv = e.clientX - rect.left, cyv = e.clientY - rect.top;
+        // hit-test existing markers (remove)
+        for (let i = 0; i < _markers.length; i++) {
+            const mx = r.x + (_markers[i].fx / r.fw) * r.w;
+            const my = r.y + (_markers[i].fy / r.fh) * r.h;
+            if (Math.hypot(cxv - mx, cyv - my) <= MARK_HIT_PX) {
+                _markers.splice(i, 1); drawMarkers(); updateMarkActions(); return;
+            }
+        }
+        // add — convert canvas px -> frame-space px -> stage µm
+        if (cxv < r.x || cxv > r.x + r.w || cyv < r.y || cyv > r.y + r.h) return;
+        const fx = ((cxv - r.x) / r.w) * r.fw;
+        const fy = ((cyv - r.y) / r.h) * r.fh;
+        const stage = frameToStage(fx, fy);
+        _markers.push({ fx, fy, stageX: stage[0], stageY: stage[1], source: 'manual' });
+        drawMarkers(); updateMarkActions();
+    }
+    function updateMarkActions() {
+        const n = _markers.length;
+        _markCount.textContent = `(${n})`;
+        _confirmBtn.disabled = !_marking || n === 0;
+        _clearBtn.disabled = !_marking || n === 0;
+    }
+    async function runDetect() {
+        _detectBtn.disabled = true; _detectBtn.textContent = 'Detecting…';
+        try {
+            const data = await postJSON('/api/devices/detect_embryos', {});
+            const cands = Array.isArray(data.embryos) ? data.embryos : [];
+            if (_lastFrame && data.stage_position) _lastFrame.stage_position = data.stage_position;
+            if (enterMarking(cands)) toast(`Detected ${cands.length} candidate${cands.length === 1 ? '' : 's'} — review & confirm`);
+        } catch (err) {
+            toast(`Detect failed (${err.status || err.message})`);
+        } finally {
+            _detectBtn.disabled = false; _detectBtn.textContent = 'Detect';
+        }
+    }
+    async function confirmMarks() {
+        if (!_markers.length) return;
+        _confirmBtn.disabled = true;
+        try {
+            const markers = _markers.map(m => ({ stage_x_um: m.stageX, stage_y_um: m.stageY }));
+            const data = await postJSON('/api/devices/embryos/confirm', { markers });
+            const n = (data.registered || []).length;
+            toast(`Registered ${n} embryo${n === 1 ? '' : 's'}`);
+            exitMarking();  // list refreshes via EMBRYOS_UPDATE
+        } catch (err) {
+            toast(`Confirm failed (${err.status || err.message})`);
+            _confirmBtn.disabled = false;
+        }
+    }
+
+    // ---- Embryo list (single source of truth) ---------------------------
+    function resolveXY(emb) {
+        const f = emb && emb.position_fine;
+        if (f && Number.isFinite(f.x) && Number.isFinite(f.y)) return { x: f.x, y: f.y };
+        const c = emb && emb.position_coarse;
+        if (c && Number.isFinite(c.x) && Number.isFinite(c.y)) return { x: c.x, y: c.y };
+        return null;
+    }
+    function labelFor(emb, i) {
+        const m = emb.id && String(emb.id).match(/(\d+)/);
+        return m ? m[1] : String(i + 1);
+    }
+    function onEmbryosUpdate(p) {
+        _embryos = (p && Array.isArray(p.embryos)) ? p.embryos : [];
+        // prune state for embryos that no longer exist
+        const ids = new Set(_embryos.map(e => e.id));
+        Object.keys(_states).forEach(id => { if (!ids.has(id)) delete _states[id]; });
+        _embryos.forEach(e => { if (!_states[e.id]) _states[e.id] = 'marked'; });
+        if (_selected && !ids.has(_selected)) selectEmbryo(null);
+        renderList();
+    }
+    function renderList() {
+        if (!_embryoList) return;
+        _embryoCount.textContent = _embryos.length ? `(${_embryos.length})` : '';
+        _embryoList.innerHTML = '';
+        if (!_embryos.length) {
+            const e = document.createElement('div'); e.className = 'op-empty';
+            e.textContent = 'No embryos yet — mark some in step 1.';
+            _embryoList.appendChild(e); return;
+        }
+        _embryos.forEach((emb, i) => {
+            const xy = resolveXY(emb);
+            const row = document.createElement('div');
+            row.className = 'op-erow' + (emb.id === _selected ? ' op-erow-sel' : '');
+            row.addEventListener('click', () => selectEmbryo(emb.id));
+
+            const dot = document.createElement('span');
+            dot.className = 'op-edot'; dot.textContent = labelFor(emb, i);
+            dot.style.background = _ROLE_COLOR[emb.role] || _ROLE_COLOR.unassigned;
+            row.appendChild(dot);
+
+            const coord = document.createElement('span');
+            coord.className = 'op-ecoord';
+            coord.textContent = xy ? `(${xy.x.toFixed(0)}, ${xy.y.toFixed(0)}) µm` : 'no position';
+            row.appendChild(coord);
+
+            const chip = document.createElement('span');
+            const st = _states[emb.id] || 'marked';
+            chip.className = `op-echip op-echip-${st}`;
+            chip.textContent = _STATE_LABEL[st] || st;
+            row.appendChild(chip);
+
+            _embryoList.appendChild(row);
+        });
+    }
+    function setState(id, st) { if (id) { _states[id] = st; renderList(); } }
+
+    // ---- Acquire (selected embryo) --------------------------------------
+    function selectEmbryo(id) {
+        _selected = id;
+        const emb = _embryos.find(e => e.id === id);
+        _selLabel.textContent = emb ? `— embryo ${labelFor(emb, _embryos.indexOf(emb))}` : '— select an embryo';
+        _centerBtn.disabled = !emb;
+        _acquireBtn.disabled = !emb || (_states[id] !== 'focused' && _states[id] !== 'imaged');
+        renderList();
+    }
+    async function centerOnSelected() {
+        const emb = _embryos.find(e => e.id === _selected);
+        const xy = emb ? resolveXY(emb) : null;
+        if (!xy) return;
+        _centerBtn.disabled = true; _centerBtn.textContent = 'Centering…';
+        try {
+            await postJSON('/api/devices/stage/move', { x: xy.x, y: xy.y });
+            setState(_selected, 'centered');
+            toast(`Centred on embryo ${labelFor(emb, _embryos.indexOf(emb))}`);
+        } catch (err) {
+            toast(`Center failed (${err.status || err.message})`);
+        } finally {
+            _centerBtn.disabled = false; _centerBtn.textContent = 'Center stage on embryo';
+        }
+    }
+    async function acquireSelected() {
+        if (!_selected) return;
+        _acquireBtn.disabled = true; _acquireBtn.textContent = 'Acquiring…';
+        try {
+            await postJSON('/api/devices/acquire/volume', { num_slices: 50, exposure_ms: 10.0 });
+            setState(_selected, 'imaged');
+            toast('Volume acquired');
+        } catch (err) {
+            toast(`Acquire failed (${err.status || err.message})`);
+        } finally {
+            _acquireBtn.disabled = false; _acquireBtn.textContent = 'Acquire volume';
+        }
+    }
+
+    // ---- Focus Z nudges (fenced) ----------------------------------------
+    async function nudgeBottomZ(delta) {
+        try {
+            const d = await postJSON('/api/devices/stage/bottom_z/nudge', { delta });
+            if (d.position != null) _bzPos.textContent = Number(d.position).toFixed(1);
+        } catch (err) { toast(`Bottom-Z nudge blocked (${err.status || err.message})`); }
+    }
+    async function nudgeFdrive(delta) {
+        try {
+            const d = await postJSON('/api/devices/spim/fdrive/nudge', { delta });
+            if (d.position != null) _fdPos.textContent = Number(d.position).toFixed(1);
+            if (d.distance_to_floor != null) _fdFloor.textContent = Number(d.distance_to_floor).toFixed(0);
+            if (_selected) setState(_selected, 'focused');
+            selectEmbryo(_selected);  // re-eval acquire enable
+        } catch (err) { toast(`F-drive nudge blocked (${err.status || err.message})`); }
+    }
+    async function refreshZReadouts() {
+        try { const b = await getJSON('/api/devices/stage/bottom_z'); if (b.position != null) _bzPos.textContent = Number(b.position).toFixed(1); } catch (_) {}
+        try {
+            const f = await getJSON('/api/devices/spim/fdrive');
+            if (f.position != null) _fdPos.textContent = Number(f.position).toFixed(1);
+            if (f.distance_to_floor != null) _fdFloor.textContent = Number(f.distance_to_floor).toFixed(0);
+        } catch (_) {}
+    }
+
+    // ---- SPIM focus -----------------------------------------------------
+    async function toggleSpim() {
+        _spimToggle.disabled = true;
+        try {
+            const ep = _spimOn ? '/api/devices/lightsheet/live/stop' : '/api/devices/lightsheet/live/start';
+            const data = await postJSON(ep, {});
+            _spimOn = !!data.streaming;
+            _spimToggle.textContent = _spimOn ? 'Stop view' : 'Start view';
+            _spimToggle.classList.toggle('op-btn-on', _spimOn);
+            if (!_spimOn) { _spimImg.classList.remove('has-frame'); _spimPh.style.display = ''; }
+            else _spimPh.textContent = 'waiting…';
+        } catch (err) { toast(`SPIM view toggle failed (${err.status || err.message})`); }
+        finally { _spimToggle.disabled = false; }
+    }
+    function onLightsheetFrame(p) {
+        if (!p || !p.jpeg_b64) return;
+        _spimImg.src = `data:${p.mime || 'image/jpeg'};base64,${p.jpeg_b64}`;
+        if (!_spimImg.classList.contains('has-frame')) { _spimImg.classList.add('has-frame'); _spimPh.style.display = 'none'; }
+        if (p.focus_score != null) _spimScore.textContent = Number(p.focus_score).toFixed(3);
+    }
+    let _lsTimer = null;
+    function postLsParams() {
+        if (_lsTimer) clearTimeout(_lsTimer);
+        _lsTimer = setTimeout(() => {
+            postJSON('/api/devices/lightsheet/live/params',
+                { galvo: _galvo, piezo: _piezo, exposure: 20, side: 'A' }).catch(() => {});
+        }, 120);
+    }
+    function nudgeGalvo(d) { _galvo = Math.max(-5, Math.min(5, _galvo + d)); _gvVal.textContent = _galvo.toFixed(1); postLsParams(); }
+    function nudgePiezo(d) { _piezo = Math.max(0, Math.min(200, _piezo + d)); _pzVal.textContent = _piezo.toFixed(0); postLsParams(); }
+    async function toggleLed() {
+        _ledOn = !_ledOn;
+        _ledBtn.classList.toggle('op-btn-on', _ledOn); _ledBtn.setAttribute('aria-pressed', _ledOn ? 'true' : 'false');
+        try { await postJSON('/api/devices/led/set', { state: _ledOn ? 'Open' : 'Closed' }); }
+        catch (err) { toast(`LED failed (${err.status || err.message})`); }
+    }
+
+    // ---- Wiring / lifecycle --------------------------------------------
+    function wire() {
+        if (_wired) return; _wired = true;
+        cacheDom();
+        _camToggle.addEventListener('click', toggleCamera);
+        _markCanvas.addEventListener('click', onCanvasClick);
+        _detectBtn.addEventListener('click', runDetect);
+        _confirmBtn.addEventListener('click', confirmMarks);
+        _clearBtn.addEventListener('click', () => { _markers = []; drawMarkers(); updateMarkActions(); });
+        _bzNudge.addEventListener('click', e => { const b = e.target.closest('[data-bz]'); if (b) nudgeBottomZ(Number(b.dataset.bz)); });
+        _fdNudge.addEventListener('click', e => { const b = e.target.closest('[data-fd]'); if (b) nudgeFdrive(Number(b.dataset.fd)); });
+        _centerBtn.addEventListener('click', centerOnSelected);
+        _acquireBtn.addEventListener('click', acquireSelected);
+        _spimToggle.addEventListener('click', toggleSpim);
+        _ledBtn.addEventListener('click', toggleLed);
+        document.querySelectorAll('[data-gv]').forEach(b => b.addEventListener('click', () => nudgeGalvo(Number(b.dataset.gv))));
+        document.querySelectorAll('[data-pz]').forEach(b => b.addEventListener('click', () => nudgePiezo(Number(b.dataset.pz))));
+        window.addEventListener('resize', () => { if (_marking) drawMarkers(); });
+
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('BOTTOM_CAMERA_FRAME', onBottomFrame);
+            ClientEventBus.on('LIGHTSHEET_FRAME', onLightsheetFrame);
+            ClientEventBus.on('EMBRYOS_UPDATE', onEmbryosUpdate);
+            ClientEventBus.on('EMBRYO_DETECTED', () => {});  // bulk EMBRYOS_UPDATE covers it
+            ClientEventBus.on('DEVICE_STATE_UPDATE', p => {
+                const pos = p && p.positions;
+                if (pos && pos.xy_stage && Array.isArray(pos.xy_stage)) _lastXY = { X: pos.xy_stage[0], Y: pos.xy_stage[1] };
+            });
+        }
+    }
+
+    async function activate() {
+        wire();
+        if (_active) return;
+        _active = true;
+        // Bootstrap the canonical list (mid-session open).
+        try { const s = await getJSON('/api/embryos/current'); onEmbryosUpdate(s); } catch (_) {}
+        refreshZReadouts();
+    }
+    function deactivate() {
+        if (!_active) return;
+        _active = false;
+        // Stop streams so they don't run while the view is hidden.
+        if (_camOn) { fetch('/api/devices/bottom_camera/stream/stop', { method: 'POST' }).catch(() => {}); applyCameraState(false); }
+        if (_spimOn) { fetch('/api/devices/lightsheet/live/stop', { method: 'POST' }).catch(() => {}); _spimOn = false; _spimToggle.textContent = 'Start view'; _spimToggle.classList.remove('op-btn-on'); }
+        if (_marking) exitMarking();
+    }
+
+    return { activate, deactivate };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 62c79e24..a864a027 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -19,6 +19,7 @@
     <link rel="stylesheet" href="/static/css/shell.css">
     <link rel="stylesheet" href="/static/css/landing.css">
     <link rel="stylesheet" href="/static/css/notebook.css">
+    <link rel="stylesheet" href="/static/css/operate.css">
 </head>
 <body class="{% if ux_v2 %}ux-v2{% endif %}">
     {% if ux_v2 %}
@@ -444,6 +445,7 @@ <h2 class="nb-title">Notebook</h2>
                 <div class="devices-header-left">
                     <h2 class="devices-title"><span class="devices-title-script">Device</span> <em class="devices-title-em">state</em></h2>
                     <div class="view-switcher" id="devices-view-switcher">
+                        <button class="view-btn" data-view="operate" title="Operate (o)">Operate</button>
                         <button class="view-btn active" data-view="map" title="XY Map (m)">Map</button>
                         <button class="view-btn" data-view="details" title="Details (d)">Details</button>
                         <button class="view-btn" data-view="optical3d" title="3D volume (v)">3D</button>
@@ -482,6 +484,100 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                 </div>
             </div>
 
+            <!-- Operate view: guided bottom-cam → SPIM operator surface.
+                 Survey & mark all → per-embryo center → lower SPIM → focus → acquire. -->
+            <div class="devices-view devices-view-operate" id="devices-view-operate" style="display:none">
+              <div class="operate">
+
+                <!-- ZONE 1 — SURVEY & MARK -->
+                <section class="op-zone op-zone-survey">
+                  <header class="op-zone-head"><span class="op-step">1</span> Survey &amp; mark</header>
+                  <div class="op-survey-body">
+                    <div class="op-cam" id="op-cam-stage">
+                      <img class="op-cam-img" id="op-cam-img" alt="bottom camera live frame">
+                      <canvas class="op-mark-canvas" id="op-mark-canvas"></canvas>
+                      <div class="op-cam-ph" id="op-cam-ph">Camera off</div>
+                    </div>
+                    <div class="op-rail">
+                      <button class="op-btn" id="op-cam-toggle" type="button">Start camera</button>
+                      <div class="op-field">
+                        <label class="op-label">Bottom focus Z</label>
+                        <div class="op-readout"><b id="op-bz-pos">—</b> µm<span class="op-sep">·</span>focus <b id="op-bz-score">—</b></div>
+                        <div class="op-nudge" id="op-bz-nudge">
+                          <button class="op-nbtn" data-bz="-10" type="button">−10</button>
+                          <button class="op-nbtn" data-bz="-1" type="button">−1</button>
+                          <button class="op-nbtn" data-bz="1" type="button">+1</button>
+                          <button class="op-nbtn" data-bz="10" type="button">+10</button>
+                        </div>
+                      </div>
+                      <div class="op-field">
+                        <label class="op-label">Mark embryos</label>
+                        <div class="op-mark-actions">
+                          <button class="op-btn" id="op-detect" type="button">Detect</button>
+                          <button class="op-btn op-btn-primary" id="op-confirm" type="button" disabled>Confirm <span id="op-mark-count">(0)</span></button>
+                        </div>
+                        <button class="op-btn op-btn-ghost" id="op-clear" type="button" disabled>Clear marks</button>
+                        <div class="op-hint" id="op-mark-hint">Start the camera, then Detect — or click the image to mark embryos.</div>
+                      </div>
+                    </div>
+                  </div>
+                </section>
+
+                <!-- ZONE 2 — EMBRYOS (single source of truth) -->
+                <section class="op-zone op-zone-embryos">
+                  <header class="op-zone-head"><span class="op-step">2</span> Embryos <span class="op-count" id="op-embryo-count"></span></header>
+                  <div class="op-embryo-list" id="op-embryo-list">
+                    <div class="op-empty">No embryos yet — mark some in step 1.</div>
+                  </div>
+                </section>
+
+                <!-- ZONE 3 — ACQUIRE (selected embryo) -->
+                <section class="op-zone op-zone-acquire">
+                  <header class="op-zone-head"><span class="op-step">3</span> Acquire <span class="op-sel" id="op-sel-label">— select an embryo</span></header>
+                  <div class="op-acquire-body">
+                    <div class="op-cam op-cam-spim" id="op-spim-stage">
+                      <img class="op-cam-img" id="op-spim-img" alt="lightsheet live frame">
+                      <div class="op-cam-ph" id="op-spim-ph">SPIM view off</div>
+                    </div>
+                    <div class="op-rail">
+                      <button class="op-btn op-btn-primary" id="op-center" type="button" disabled>Center stage on embryo</button>
+                      <div class="op-field">
+                        <label class="op-label">SPIM head — F-drive</label>
+                        <div class="op-readout"><b id="op-fd-pos">—</b> µm<span class="op-sep">·</span>floor <b id="op-fd-floor">—</b></div>
+                        <div class="op-nudge" id="op-fd-nudge">
+                          <button class="op-nbtn" data-fd="-100" type="button">−100</button>
+                          <button class="op-nbtn" data-fd="-10" type="button">−10</button>
+                          <button class="op-nbtn" data-fd="10" type="button">+10</button>
+                          <button class="op-nbtn" data-fd="100" type="button">+100</button>
+                        </div>
+                      </div>
+                      <div class="op-field">
+                        <label class="op-label">SPIM focus</label>
+                        <div class="op-spim-controls">
+                          <button class="op-btn" id="op-spim-toggle" type="button">Start view</button>
+                          <button class="op-btn op-btn-toggle" id="op-led" type="button" aria-pressed="false">LED</button>
+                        </div>
+                        <div class="op-micro">
+                          <span>Galvo</span>
+                          <button class="op-nbtn" data-gv="-0.2" type="button">−</button>
+                          <b id="op-gv">0.0</b>
+                          <button class="op-nbtn" data-gv="0.2" type="button">+</button>
+                          <span class="op-sep">·</span>
+                          <span>Piezo</span>
+                          <button class="op-nbtn" data-pz="-1" type="button">−</button>
+                          <b id="op-pz">50</b>
+                          <button class="op-nbtn" data-pz="1" type="button">+</button>
+                        </div>
+                        <div class="op-readout">SPIM focus <b id="op-spim-score">—</b></div>
+                      </div>
+                      <button class="op-btn op-btn-primary" id="op-acquire" type="button" disabled>Acquire volume</button>
+                    </div>
+                  </div>
+                </section>
+
+              </div>
+            </div>
+
             <!-- Map view: graphical XY position over safe/caution/forbidden zones -->
             <div class="devices-view devices-view-map" id="devices-view-map">
                 <div class="devices-map-wrap" id="devices-map-wrap">
@@ -1152,6 +1248,7 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
     <script src="/static/js/marking.js"></script>
     <script src="/static/js/temperature-graph.js"></script>
     <script src="/static/js/devices.js"></script>
+    <script src="/static/js/operate.js"></script>
     <script src="/static/js/operations-scenarios.js"></script>
     <script src="/static/js/experiment-overview.js"></script>
     <!-- Three.js for 3D volume viewer -->

From d1662ddf5efd9b91d8b88536c2e54158e6495b0b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 19:21:27 +0530
Subject: [PATCH 272/314] =?UTF-8?q?feat(operate):=20B=20=E2=80=94=20captur?=
 =?UTF-8?q?e=20marking=20as=20localization=20labels?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

On Confirm, persist the annotated bottom-cam frame + per-marker pixel & stage
coords (+ source, capture pose, transform) as a labelled snapshot via the
existing FileStore.register_snapshot sidecar — every confirmation becomes a
training/eval example for a future SAM replacement. Best-effort: needs a
client-supplied frame + active session; never blocks embryo registration.
Frontend sends image_b64 + frame meta + pixel coords with the confirm payload.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/data.py       | 76 ++++++++++++++++++++++++++++--
 gently/ui/web/static/js/operate.js | 14 +++++-
 2 files changed, 85 insertions(+), 5 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index d9867c2a..356e6b72 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -614,6 +614,71 @@ def _num(v):
         except (TypeError, ValueError):
             return None
 
+    def _persist_detection_labels(agent, payload: dict, markers: list) -> bool:
+        """Persist the annotated bottom-cam frame + per-marker pixel/stage coords
+        as a labelled snapshot — localization training data (sub-project B).
+
+        Best-effort: requires a client-supplied image and an active session; any
+        failure (no session, missing deps) is swallowed so it never blocks the
+        embryo registration. Reuses FileStore.register_snapshot so labels live in
+        the standard snapshots/ sidecar, not a bespoke store.
+        """
+        image_b64 = payload.get("image_b64")
+        store = getattr(agent, "store", None)
+        session_id = getattr(agent, "session_id", None)
+        if not image_b64 or store is None or not session_id:
+            return False
+        try:
+            import base64
+            import io
+            import tempfile
+            import uuid as _uuid
+
+            import numpy as np
+            import tifffile
+            from PIL import Image
+
+            from gently.core.coordinates import (
+                DEFAULT_OBJECTIVE_MAG,
+                DEFAULT_PIXEL_SIZE_UM,
+            )
+
+            raw = base64.b64decode(image_b64.split(",")[-1])
+            img = np.asarray(Image.open(io.BytesIO(raw)))
+            tmp = Path(tempfile.gettempdir()) / f"operate_{_uuid.uuid4().hex[:12]}.tif"
+            tifffile.imwrite(str(tmp), img)
+
+            frame = payload.get("frame") or {}
+            pos = payload.get("stage_position") or [None, None]
+            meta = {
+                "kind": "operate_marking",
+                "stage_position": list(pos),
+                "frame": {
+                    "width": _num(frame.get("w")),
+                    "height": _num(frame.get("h")),
+                    "downsample": _num(frame.get("downsample")),
+                },
+                "transform": {
+                    "pixel_size_um": DEFAULT_PIXEL_SIZE_UM,
+                    "objective_mag": DEFAULT_OBJECTIVE_MAG,
+                },
+                "embryos": [
+                    {
+                        "pixel_x": _num(m.get("pixel_x")),
+                        "pixel_y": _num(m.get("pixel_y")),
+                        "stage_x_um": _num(m.get("stage_x_um")),
+                        "stage_y_um": _num(m.get("stage_y_um")),
+                        "source": m.get("source", "manual"),
+                    }
+                    for m in markers
+                ],
+            }
+            store.register_snapshot(session_id, "operate_marked", tmp, metadata=meta)
+            return True
+        except Exception:
+            logger.debug("detection-label persistence skipped", exc_info=True)
+            return False
+
     @router.post("/api/devices/detect_embryos", dependencies=[Depends(require_control)])
     async def detect_embryos(payload: dict = Body(default={})):  # noqa: B008
         """Run bottom-camera embryo detection and RETURN the candidates for the
@@ -691,8 +756,12 @@ async def confirm_embryos(payload: dict = Body(...)):  # noqa: B008
         the frame's downsample-aware transform), so the server just registers
         via ExperimentState.add_embryo(role='unassigned'), firing EMBRYOS_UPDATE.
 
-        Body: {markers: [{stage_x_um, stage_y_um, confidence?}]}.
-        Returns {success, registered: [embryo_id, ...]}.
+        Body: {markers: [{stage_x_um, stage_y_um, pixel_x?, pixel_y?, source?,
+               confidence?}], image_b64?, frame? {w,h,downsample}, stage_position?}.
+        When image_b64 is present the annotated frame + per-marker pixel/stage
+        coords are persisted as a labelled snapshot (sub-project B: localization
+        training data) — best-effort, never blocks registration.
+        Returns {success, registered: [embryo_id, ...], labelled: bool}.
         """
         agent = _require_agent_with_experiment()
         markers = payload.get("markers") or []
@@ -722,7 +791,8 @@ def _next_embryo_id(taken: set) -> str:
             )
             registered.append(emb_id)
 
-        return {"success": True, "registered": registered}
+        labelled = _persist_detection_labels(agent, payload, markers)
+        return {"success": True, "registered": registered, "labelled": labelled}
 
     # ------------------------------------------------------------------
     # Focus Z axes (Operate view) — fenced read + nudge
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 9a7071c1..7e4c5d3a 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -231,8 +231,18 @@ const OperateManager = (function () {
         if (!_markers.length) return;
         _confirmBtn.disabled = true;
         try {
-            const markers = _markers.map(m => ({ stage_x_um: m.stageX, stage_y_um: m.stageY }));
-            const data = await postJSON('/api/devices/embryos/confirm', { markers });
+            // Stage coords register the embryos; pixel coords + the frozen frame
+            // are persisted as localization labels (sub-project B) server-side.
+            const markers = _markers.map(m => ({
+                stage_x_um: m.stageX, stage_y_um: m.stageY,
+                pixel_x: m.fx, pixel_y: m.fy, source: m.source,
+            }));
+            const data = await postJSON('/api/devices/embryos/confirm', {
+                markers,
+                image_b64: _frozenSrc ? _frozenSrc.split(',')[1] : undefined,
+                frame: _frozenFrame ? { w: _frozenFrame.w, h: _frozenFrame.h, downsample: _frozenFrame.downsample } : undefined,
+                stage_position: _captureStage,
+            });
             const n = (data.registered || []).length;
             toast(`Registered ${n} embryo${n === 1 ? '' : 's'}`);
             exitMarking();  // list refreshes via EMBRYOS_UPDATE

From 47bb84ffc96625bed243ee5ab1d23ec343520507 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 19:21:27 +0530
Subject: [PATCH 273/314] =?UTF-8?q?feat(operate):=20C=20=E2=80=94=20passiv?=
 =?UTF-8?q?e=20focus-trace=20logging=20+=20offline=20validation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Device layer: _log_focus_trace appends (t, source, focus_score, bottom_z,
  fdrive, piezo) to {session}/focus_traces.jsonl on every broadcast frame —
  the operator's manual focusing is captured passively (no autonomous Z moves)
  as autofocus-validation data. Best-effort, off the broadcast hot path.
- gently/analysis/focus_validation.py: offline replay — load traces, segment
  sweeps, compare each focus metric's argmax to the human's resting Z, report
  error stats + interior-peak/contrast quality (a flat curve = no safe autofocus).
- 8 unit tests (synthetic Gaussian sweeps) — all green.

Earns autofocus safety offline before any Z move near the objective.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/analysis/focus_validation.py    | 176 +++++++++++++++++++++++++
 gently/hardware/dispim/device_layer.py |  34 +++++
 tests/test_focus_validation.py         | 106 +++++++++++++++
 3 files changed, 316 insertions(+)
 create mode 100644 gently/analysis/focus_validation.py
 create mode 100644 tests/test_focus_validation.py

diff --git a/gently/analysis/focus_validation.py b/gently/analysis/focus_validation.py
new file mode 100644
index 00000000..b00c7f5a
--- /dev/null
+++ b/gently/analysis/focus_validation.py
@@ -0,0 +1,176 @@
+"""Offline validation of focus algorithms against passively-logged focus traces.
+
+The Operate view logs ``(z, focus_score)`` samples while the operator *manually*
+focuses (bottom-cam or SPIM head); the human's resting Z is ground-truth best
+focus. This module replays those traces — captured passively, with no autonomous
+motion — to answer two safety questions before any autofocus is trusted near the
+objective:
+
+1. **Agreement** — would the focus metric's argmax have matched the human's
+   chosen Z, and by how much (µm error)?
+2. **Peak quality** — is the focus curve peaked at an interior point with enough
+   contrast to hill-climb at all? A flat or edge-rising curve means *no* metric
+   is safe to drive Z, regardless of agreement on a lucky sweep.
+
+Nothing here moves hardware; it only reads ``focus_traces.jsonl`` (written by the
+device layer) and reports. See sub-project C of the bottom-cam operator surface.
+"""
+
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from pathlib import Path
+
+
+@dataclass
+class FocusSample:
+    """One passively-logged focus reading."""
+
+    z: float
+    score: float
+    t: float | None = None
+    source: str | None = None
+    sweep_id: str | None = None
+
+
+@dataclass
+class SweepResult:
+    n: int
+    human_z: float
+    predicted_z: float
+    error_um: float
+    interior_peak: bool   # argmax strictly inside the sweep (not an endpoint)
+    score_contrast: float  # (max-min)/max — low ⇒ unreliable peak
+
+
+@dataclass
+class ValidationReport:
+    n_sweeps: int
+    median_error_um: float
+    p95_error_um: float
+    within_margin_frac: float    # fraction with error <= margin_um
+    interior_peak_frac: float    # fraction whose metric peak is interior
+    sweeps: list[SweepResult] = field(default_factory=list)
+
+
+def load_focus_traces(path: str | Path) -> list[FocusSample]:
+    """Read a ``focus_traces.jsonl`` file into FocusSample rows.
+
+    Each line is a JSON object with ``z`` and ``focus_score`` (or ``score``);
+    ``t``, ``source`` and ``sweep_id`` are optional. Malformed lines are skipped.
+    """
+    samples: list[FocusSample] = []
+    p = Path(path)
+    if not p.exists():
+        return samples
+    for line in p.read_text().splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            row = json.loads(line)
+            z = row.get("z")
+            score = row.get("focus_score", row.get("score"))
+            if z is None or score is None:
+                continue
+            samples.append(
+                FocusSample(
+                    z=float(z),
+                    score=float(score),
+                    t=row.get("t"),
+                    source=row.get("source"),
+                    sweep_id=row.get("sweep_id"),
+                )
+            )
+        except (ValueError, TypeError, json.JSONDecodeError):
+            continue
+    return samples
+
+
+def segment_sweeps(samples: list[FocusSample]) -> list[list[FocusSample]]:
+    """Group samples into sweeps by ``sweep_id`` when present, else one sweep."""
+    if not samples:
+        return []
+    if any(s.sweep_id is not None for s in samples):
+        groups: dict[str, list[FocusSample]] = {}
+        for s in samples:
+            groups.setdefault(s.sweep_id or "_", []).append(s)
+        return list(groups.values())
+    return [samples]
+
+
+def evaluate_sweep(samples: list[FocusSample], human_z: float | None = None) -> SweepResult:
+    """Score one sweep: metric argmax vs the human's chosen (resting) Z.
+
+    ``human_z`` defaults to the last sample's Z — where the operator settled.
+    """
+    if not samples:
+        raise ValueError("empty sweep")
+    if human_z is None:
+        human_z = samples[-1].z
+    best = max(samples, key=lambda s: s.score)
+    predicted_z = best.z
+    scores = [s.score for s in samples]
+    smax, smin = max(scores), min(scores)
+    contrast = (smax - smin) / smax if smax > 0 else 0.0
+    # interior peak: the argmax is not the first/last sample by Z order
+    by_z = sorted(samples, key=lambda s: s.z)
+    idx = by_z.index(best)
+    interior = 0 < idx < len(by_z) - 1
+    return SweepResult(
+        n=len(samples),
+        human_z=float(human_z),
+        predicted_z=float(predicted_z),
+        error_um=abs(float(predicted_z) - float(human_z)),
+        interior_peak=interior,
+        score_contrast=float(contrast),
+    )
+
+
+def _percentile(values: list[float], pct: float) -> float:
+    if not values:
+        return 0.0
+    s = sorted(values)
+    if len(s) == 1:
+        return s[0]
+    k = (len(s) - 1) * pct
+    lo = int(k)
+    hi = min(lo + 1, len(s) - 1)
+    return s[lo] + (s[hi] - s[lo]) * (k - lo)
+
+
+def validate(
+    sweeps: list[list[FocusSample]],
+    margin_um: float = 5.0,
+    human_zs: list[float] | None = None,
+) -> ValidationReport:
+    """Aggregate per-sweep agreement into a validation report.
+
+    ``margin_um`` is the acceptable error for the algorithm to be considered safe
+    on a sweep; ``human_zs`` optionally overrides the per-sweep resting-Z default.
+    """
+    results: list[SweepResult] = []
+    for i, sw in enumerate(sweeps):
+        if not sw:
+            continue
+        hz = human_zs[i] if (human_zs is not None and i < len(human_zs)) else None
+        results.append(evaluate_sweep(sw, hz))
+    if not results:
+        return ValidationReport(0, 0.0, 0.0, 0.0, 0.0, [])
+    errors = [r.error_um for r in results]
+    within = sum(1 for e in errors if e <= margin_um) / len(results)
+    interior = sum(1 for r in results if r.interior_peak) / len(results)
+    return ValidationReport(
+        n_sweeps=len(results),
+        median_error_um=_percentile(errors, 0.5),
+        p95_error_um=_percentile(errors, 0.95),
+        within_margin_frac=within,
+        interior_peak_frac=interior,
+        sweeps=results,
+    )
+
+
+def validate_file(path: str | Path, margin_um: float = 5.0) -> ValidationReport:
+    """Convenience: load a focus_traces.jsonl and validate it end-to-end."""
+    return validate(segment_sweeps(load_focus_traces(path)), margin_um=margin_um)
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 8383c486..986f083d 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -1001,7 +1001,40 @@ async def _bottom_camera_streamer(self):
         finally:
             logger.info("Bottom-camera streamer exiting")
 
+    def _log_focus_trace(self, source: str, payload: dict[str, Any]) -> None:
+        """Append a passive (z, focus_score) focus-trace sample (sub-project C).
+
+        Captures the operator's *manual* focusing as validation data — the human's
+        resting Z is ground-truth best focus, replayed offline by
+        ``gently.analysis.focus_validation``. Best-effort: only when a session
+        volume dir is set and the frame carries a focus score; never raises into
+        the broadcast path, never moves hardware.
+        """
+        score = payload.get("focus_score")
+        if score is None or not self._volume_dir:
+            return
+        try:
+            import json as _json
+
+            zvals: dict[str, Any] = {}
+            for v in (self._state_latest.get("positions") or {}).values():
+                if isinstance(v, dict) and "kind" in v and "Position" in v:
+                    zvals[v["kind"]] = v["Position"]
+            rec = {
+                "t": payload.get("t"),
+                "source": source,
+                "focus_score": float(score),
+                "bottom_z": zvals.get("bottom_z"),
+                "fdrive": zvals.get("fdrive"),
+                "piezo": zvals.get("piezo"),
+            }
+            with open(Path(self._volume_dir) / "focus_traces.jsonl", "a") as f:
+                f.write(_json.dumps(rec) + "\n")
+        except Exception:
+            logger.debug("focus-trace log skipped", exc_info=True)
+
     async def _broadcast_camera(self, payload: dict[str, Any]):
+        self._log_focus_trace("bottom", payload)
         if not self._cam_subscribers:
             return
         dead: list[asyncio.Queue] = []
@@ -1260,6 +1293,7 @@ async def _lightsheet_streamer(self):
             logger.info("Lightsheet streamer exiting")
 
     async def _broadcast_lightsheet(self, payload: dict[str, Any]):
+        self._log_focus_trace("spim", payload)
         if not self._ls_subscribers:
             return
         dead: list[asyncio.Queue] = []
diff --git a/tests/test_focus_validation.py b/tests/test_focus_validation.py
new file mode 100644
index 00000000..9f53d93a
--- /dev/null
+++ b/tests/test_focus_validation.py
@@ -0,0 +1,106 @@
+"""
+Tests for analysis.focus_validation — offline replay of passively-logged
+manual-focus traces (sub-project C).
+
+Covers:
+- evaluate_sweep finds the metric peak and measures error vs the human Z
+- interior-peak + contrast flags
+- a flat curve is flagged (no interior peak / zero contrast)
+- validate aggregates error stats + within-margin fraction
+- segment_sweeps groups by sweep_id
+- load_focus_traces round-trips a jsonl file (and skips junk)
+"""
+
+import json
+import math
+
+from gently.analysis.focus_validation import (
+    FocusSample,
+    evaluate_sweep,
+    load_focus_traces,
+    segment_sweeps,
+    validate,
+)
+
+
+def _gaussian_sweep(z0, lo=80, hi=160, step=2, amp=1000.0, sigma=12.0, base=50.0):
+    out = []
+    z = lo
+    while z <= hi:
+        score = base + amp * math.exp(-((z - z0) ** 2) / (2 * sigma**2))
+        out.append(FocusSample(z=float(z), score=float(score)))
+        z += step
+    return out
+
+
+def test_evaluate_sweep_finds_peak_near_human():
+    sw = _gaussian_sweep(z0=120)
+    res = evaluate_sweep(sw, human_z=121.0)
+    assert abs(res.predicted_z - 120) <= 2  # argmax at/near the true peak
+    assert res.error_um <= 3
+    assert res.interior_peak is True
+    assert res.score_contrast > 0.5
+
+
+def test_flat_curve_flagged():
+    sw = [FocusSample(z=float(z), score=100.0) for z in range(80, 161, 5)]
+    res = evaluate_sweep(sw, human_z=120.0)
+    assert res.score_contrast == 0.0
+    # a flat curve's argmax is the first sample -> not an interior peak
+    assert res.interior_peak is False
+
+
+def test_validate_aggregates():
+    # three sweeps; human settles within a couple µm of each metric peak
+    sweeps = [_gaussian_sweep(z0=120), _gaussian_sweep(z0=100), _gaussian_sweep(z0=140)]
+    human = [121.0, 99.0, 141.0]
+    rep = validate(sweeps, margin_um=5.0, human_zs=human)
+    assert rep.n_sweeps == 3
+    assert rep.median_error_um <= 3
+    assert rep.p95_error_um <= 5
+    assert rep.within_margin_frac == 1.0
+    assert rep.interior_peak_frac == 1.0
+
+
+def test_validate_flags_out_of_margin():
+    sweeps = [_gaussian_sweep(z0=120)]
+    rep = validate(sweeps, margin_um=2.0, human_zs=[140.0])  # human far from peak
+    assert rep.within_margin_frac == 0.0
+    assert rep.median_error_um > 2.0
+
+
+def test_segment_sweeps_by_id():
+    samples = [
+        FocusSample(z=1, score=1, sweep_id="a"),
+        FocusSample(z=2, score=2, sweep_id="a"),
+        FocusSample(z=3, score=3, sweep_id="b"),
+    ]
+    groups = segment_sweeps(samples)
+    assert len(groups) == 2
+    assert sorted(len(g) for g in groups) == [1, 2]
+
+
+def test_segment_sweeps_default_single():
+    samples = [FocusSample(z=1, score=1), FocusSample(z=2, score=2)]
+    assert len(segment_sweeps(samples)) == 1
+
+
+def test_load_focus_traces_roundtrip(tmp_path):
+    p = tmp_path / "focus_traces.jsonl"
+    lines = [
+        {"z": 100.0, "focus_score": 0.4, "t": 1.0, "source": "bottom"},
+        {"z": 110.0, "score": 0.9, "source": "bottom"},  # 'score' alias
+        {"garbage": True},  # missing z/score -> skipped
+        "not json",         # junk -> skipped
+    ]
+    with p.open("w") as f:
+        for ln in lines:
+            f.write((json.dumps(ln) if isinstance(ln, dict) else ln) + "\n")
+    samples = load_focus_traces(p)
+    assert len(samples) == 2
+    assert samples[0].z == 100.0 and samples[0].score == 0.4
+    assert samples[1].score == 0.9
+
+
+def test_load_missing_file_returns_empty(tmp_path):
+    assert load_focus_traces(tmp_path / "nope.jsonl") == []

From ecfcb60ce43561d8ca929c4ae76a546a0f896155 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 20:45:28 +0530
Subject: [PATCH 274/314] =?UTF-8?q?feat(operate):=20redesign=20as=20'The?=
 =?UTF-8?q?=20Operator=20Spine'=20=E2=80=94=20uncluttered,=20legible=20wor?=
 =?UTF-8?q?kflow?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replaces the three always-on ~340px cards (cluttered, no visible logic) with a
single height-filling four-region surface, from an expert-driven redesign
(diSPIM-ops + microscopy-UX + C. elegans-bio + critique → 3 candidates → synthesis):

- Thin HEADER: a real phase stepper (Survey: Focus→Mark │ Acquire: Center→Lower→
  Focus→Acquire) giving 'you are here', + an always-on safety status strip
  (HEAD/floor/LED/LASER/live-cam) that persists even when controls are hidden.
- LEFT SPINE: a read-only dish mini-map (state-colored pins + stage crosshair) +
  the embryo worklist board (per-row 4-node progress track), the loop's spine.
- CENTER: ONE live viewport whose camera source swaps per step, with decision
  instruments overlaid (markers / centre reticle+FOV box / floor gauge).
- RIGHT RAIL: renders ONLY the active step's controls (progressive disclosure);
  a single renderStep() drives header+spine+viewport+rail from one state so they
  can't disagree. Exactly one camera + one step live at a time.

Bug fixes from the critique: (1) 'focused' is earned at the SPIM-focus step, not
on a stray F-drive nudge (new 'lowering' state); (2) LED force-closed on
step-leave and view-leave (no more leak); (3) down-nudges auto-grey near the
floor and XY centering is blocked while the head is lowered.

Pure IA/reveal/gating over existing endpoints/streams/SSOT — no backend change.
Verified end-to-end in-browser (focus→mark→confirm→per-embryo center/lower/focus/
acquire→retract); stepper, status, board, and mini-map all track in lockstep.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/operate.css | 325 +++++-----
 gently/ui/web/static/js/operate.js   | 850 ++++++++++++++++-----------
 gently/ui/web/templates/index.html   | 190 +++---
 3 files changed, 791 insertions(+), 574 deletions(-)

diff --git a/gently/ui/web/static/css/operate.css b/gently/ui/web/static/css/operate.css
index 29ba5f90..663bed0b 100644
--- a/gently/ui/web/static/css/operate.css
+++ b/gently/ui/web/static/css/operate.css
@@ -1,194 +1,221 @@
-/* Operate view — guided bottom-cam → SPIM operator surface.
-   Theme-aware via the global tokens (--bg-card, --border, --text, --accent …). */
+/* Operate view — "The Operator Spine": one guided surface for the bottom-cam →
+   SPIM workflow. Four regions: a thin header (stepper + always-on safety status),
+   a left spine (dish mini-map + embryo worklist), one swapping live viewport with
+   overlaid instruments, and a right rail that shows ONLY the active step's
+   controls. Theme-aware via the global tokens. */
 
 .operate {
-    display: flex;
-    flex-direction: column;
-    gap: 0.9rem;
-    padding: 0.25rem 0.1rem 1.5rem;
+    display: grid;
+    grid-template-columns: 264px minmax(0, 1fr) 248px;
+    grid-template-rows: auto minmax(0, 1fr);
+    grid-template-areas:
+        "head head head"
+        "spine stage rail";
+    gap: 0.75rem;
+    height: calc(100vh - 165px);
+    min-height: 520px;
     font-family: 'Inter Tight', system-ui, sans-serif;
     color: var(--text);
+    --accent-red: #ef4444;
 }
 
-.op-zone {
+/* ── HEADER ───────────────────────────────────────────────────────────── */
+.op-head {
+    grid-area: head;
+    display: flex;
+    flex-direction: column;
+    gap: 0.4rem;
     background: var(--bg-card);
     border: 1px solid var(--border);
     border-radius: 10px;
-    padding: 0.85rem 1rem 1rem;
+    padding: 0.6rem 0.85rem;
 }
-.op-zone-head {
+.op-stepper {
     display: flex;
     align-items: center;
-    gap: 0.55rem;
-    font-size: 0.95rem;
-    font-weight: 600;
-    letter-spacing: 0.01em;
-    margin-bottom: 0.85rem;
-    color: var(--text);
+    gap: 0.45rem;
+    flex-wrap: wrap;
+    font-size: 0.8rem;
 }
-.op-step {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    width: 22px; height: 22px;
-    border-radius: 50%;
-    background: var(--accent);
-    color: #fff;
-    font-size: 0.74rem;
+.op-phase {
+    font-size: 0.62rem;
     font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.12em;
+    color: var(--text-muted);
 }
-.op-count, .op-sel {
-    font-size: 0.8rem;
-    font-weight: 500;
+.op-phase b { font-weight: 700; color: var(--text); margin-left: 0.35rem; }
+.op-phase-div { width: 1px; height: 16px; background: var(--border-strong); margin: 0 0.3rem; }
+.op-arrow { color: var(--text-muted); font-size: 0.7rem; }
+.op-node {
+    font-size: 0.78rem;
+    font-weight: 600;
     color: var(--text-muted);
+    padding: 0.1rem 0.5rem;
+    border-radius: 999px;
+    border: 1px solid transparent;
+    white-space: nowrap;
 }
+.op-node.is-done { color: var(--accent-green); }
+.op-node.is-done::before { content: "✓ "; }
+.op-node.is-active { color: var(--text); border-color: var(--accent); background: color-mix(in srgb, var(--accent) 14%, transparent); }
+.op-node.is-locked { opacity: 0.4; }
+
+.op-status {
+    display: flex;
+    align-items: center;
+    gap: 1.1rem;
+    flex-wrap: wrap;
+    padding-top: 0.4rem;
+    border-top: 1px solid var(--border);
+}
+.op-stat { display: inline-flex; align-items: baseline; gap: 0.4rem; font-size: 0.72rem; }
+.op-stat i { font-style: normal; font-size: 0.6rem; font-weight: 700; letter-spacing: 0.1em; color: var(--text-muted); }
+.op-stat b { font-weight: 600; color: var(--text); font-variant-numeric: tabular-nums; }
+.op-stat.is-down b { color: var(--accent-orange); }
+.op-stat.is-emitting b { color: var(--accent-red); }
+.op-stat.is-emitting i { color: var(--accent-red); }
 
-/* survey + acquire share a camera|rail two-column body.
-   Fixed body height keeps all three zones on screen; the camera fills it and
-   the image letterboxes (object-fit: contain) so any frame aspect fits. */
-.op-survey-body, .op-acquire-body {
+/* ── LEFT SPINE ───────────────────────────────────────────────────────── */
+.op-spine {
+    grid-area: spine;
     display: flex;
-    gap: 1rem;
-    align-items: stretch;
-    height: 340px;
+    flex-direction: column;
+    gap: 0.6rem;
+    min-height: 0;
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 0.7rem;
 }
-.op-cam {
-    position: relative;
-    flex: 1 1 auto;
-    min-width: 0;
-    height: 100%;
+.op-minimap-wrap {
+    aspect-ratio: 1 / 1;
     background: var(--img-bg);
     border: 1px solid var(--border);
     border-radius: 8px;
     overflow: hidden;
+    flex: 0 0 auto;
 }
-.op-cam-img {
-    width: 100%; height: 100%;
-    object-fit: contain;
-    display: block;
-    opacity: 0;
-    transition: opacity 0.2s;
-}
-.op-cam-img.has-frame { opacity: 1; }
-.op-mark-canvas {
-    position: absolute; inset: 0;
-    width: 100%; height: 100%;
-    pointer-events: none;
-}
-.op-cam.op-marking { cursor: crosshair; box-shadow: inset 0 0 0 2px var(--accent-green); }
-.op-cam.op-marking .op-mark-canvas { pointer-events: auto; }
-.op-cam-ph {
-    position: absolute; inset: 0;
-    display: flex; align-items: center; justify-content: center;
+.op-minimap { width: 100%; height: 100%; display: block; }
+.op-board-head {
+    display: flex; justify-content: space-between; align-items: baseline;
+    font-size: 0.62rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.1em;
     color: var(--text-muted);
-    font-size: 0.8rem;
-    letter-spacing: 0.04em;
 }
-
-/* control rail */
-.op-rail {
-    flex: 0 0 248px;
-    display: flex;
-    flex-direction: column;
-    gap: 0.75rem;
+.op-board-count { font-weight: 600; color: var(--text); }
+.op-board { flex: 1 1 auto; min-height: 0; overflow-y: auto; display: flex; flex-direction: column; gap: 0.25rem; }
+.op-brow {
+    display: flex; align-items: center; gap: 0.5rem;
+    padding: 0.4rem 0.45rem;
+    border: 1px solid transparent;
+    border-radius: 7px;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s;
 }
-.op-field { display: flex; flex-direction: column; gap: 0.4rem; }
-.op-label {
-    font-size: 0.66rem;
-    font-weight: 600;
-    text-transform: uppercase;
-    letter-spacing: 0.1em;
-    color: var(--text-muted);
+.op-brow:hover { background: var(--bg-hover); }
+.op-brow.is-sel { background: var(--bg-hover); border-color: var(--accent); }
+.op-bdot {
+    flex: 0 0 auto; width: 20px; height: 20px; border-radius: 50%;
+    display: inline-flex; align-items: center; justify-content: center;
+    font-size: 0.66rem; font-weight: 700; color: #fff; background: var(--text-muted);
+}
+.op-bmeta { flex: 1 1 auto; min-width: 0; display: flex; flex-direction: column; gap: 0.15rem; }
+.op-blabel { font-size: 0.74rem; font-weight: 600; }
+/* 4-node progress track: centered · lowered · focused · imaged */
+.op-track { display: inline-flex; align-items: center; gap: 3px; }
+.op-tnode { width: 7px; height: 7px; border-radius: 50%; background: var(--border-strong); }
+.op-tnode.on-centered { background: var(--accent); }
+.op-tnode.on-lowering { background: var(--accent); }
+.op-tnode.on-focused { background: var(--accent-orange); }
+.op-tnode.on-imaged { background: var(--accent-green); }
+.op-bstate { flex: 0 0 auto; font-size: 0.58rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.05em; color: var(--text-muted); }
+.op-survey-btn { flex: 0 0 auto; }
+
+/* ── CENTER STAGE ─────────────────────────────────────────────────────── */
+.op-stage { grid-area: stage; position: relative; min-width: 0; min-height: 0; }
+.op-badge {
+    position: absolute; top: 0.6rem; left: 0.6rem; z-index: 3;
+    font-size: 0.64rem; font-weight: 600; letter-spacing: 0.04em;
+    color: var(--text); background: color-mix(in srgb, var(--bg-card) 82%, transparent);
+    border: 1px solid var(--border); border-radius: 999px; padding: 0.2rem 0.6rem;
+    -webkit-backdrop-filter: blur(6px); backdrop-filter: blur(6px);
 }
-.op-readout {
-    font-size: 0.82rem;
-    color: var(--text);
-    font-variant-numeric: tabular-nums;
+.op-cam {
+    position: relative; width: 100%; height: 100%;
+    background: var(--img-bg);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    overflow: hidden;
 }
-.op-readout b { font-weight: 600; }
-.op-sep { color: var(--text-muted); margin: 0 0.4rem; }
+.op-cam-img { width: 100%; height: 100%; object-fit: contain; display: block; opacity: 0; transition: opacity 0.2s; }
+.op-cam-img.has-frame { opacity: 1; }
+.op-mark-canvas { position: absolute; inset: 0; width: 100%; height: 100%; pointer-events: none; }
+.op-cam.is-marking { cursor: crosshair; box-shadow: inset 0 0 0 2px var(--accent-green); }
+.op-cam.is-marking .op-mark-canvas { pointer-events: auto; }
+.op-cam-ph { position: absolute; inset: 0; display: flex; align-items: center; justify-content: center; color: var(--text-muted); font-size: 0.82rem; letter-spacing: 0.04em; }
 
-/* buttons */
-.op-btn {
-    appearance: none;
-    background: var(--bg-hover);
+/* ── RIGHT RAIL ───────────────────────────────────────────────────────── */
+.op-rail {
+    grid-area: rail;
+    display: flex; flex-direction: column; gap: 0.7rem;
+    min-height: 0; overflow-y: auto;
+    background: var(--bg-card);
     border: 1px solid var(--border);
-    color: var(--text);
+    border-radius: 10px;
+    padding: 0.85rem 0.8rem;
+}
+.op-rail-head { font-size: 0.82rem; font-weight: 600; color: var(--text); }
+/* progressive disclosure: only the active step's group renders */
+.op-group { display: none; flex-direction: column; gap: 0.7rem; }
+.op-rail[data-active="a1"] .op-group[data-step="a1"],
+.op-rail[data-active="a2"] .op-group[data-step="a2"],
+.op-rail[data-active="b1"] .op-group[data-step="b1"],
+.op-rail[data-active="b2"] .op-group[data-step="b2"],
+.op-rail[data-active="b3"] .op-group[data-step="b3"],
+.op-rail[data-active="b4"] .op-group[data-step="b4"],
+.op-rail[data-active="b5"] .op-group[data-step="b5"] { display: flex; }
+
+.op-field { display: flex; flex-direction: column; gap: 0.4rem; }
+.op-label { font-size: 0.64rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.08em; color: var(--text-muted); }
+.op-cap { font-size: 0.66rem; color: var(--text-muted); font-variant-numeric: tabular-nums; text-transform: none; letter-spacing: 0; }
+.op-hud-line { font-size: 0.8rem; color: var(--text); font-variant-numeric: tabular-nums; }
+.op-hud-line b { font-weight: 700; }
+.op-hint { font-size: 0.72rem; color: var(--text-muted); line-height: 1.4; }
+.op-sep { color: var(--text-muted); margin: 0 0.35rem; }
+
+.op-btn {
+    appearance: none; background: var(--bg-hover); border: 1px solid var(--border); color: var(--text);
     font: 600 0.8rem/1 'Inter Tight', system-ui, sans-serif;
-    padding: 0.5rem 0.75rem;
-    border-radius: 7px;
-    cursor: pointer;
+    padding: 0.55rem 0.75rem; border-radius: 7px; cursor: pointer;
     transition: background 0.13s, border-color 0.13s, color 0.13s, opacity 0.13s;
 }
 .op-btn:hover:not(:disabled) { border-color: var(--accent); color: var(--accent); }
-.op-btn:disabled { opacity: 0.45; cursor: not-allowed; }
+.op-btn:disabled { opacity: 0.4; cursor: not-allowed; }
 .op-btn-primary { background: var(--accent); border-color: var(--accent); color: #fff; }
 .op-btn-primary:hover:not(:disabled) { background: var(--accent-hover); border-color: var(--accent-hover); color: #fff; }
 .op-btn-ghost { background: transparent; }
-.op-btn-on, .op-btn-toggle[aria-pressed="true"] { background: var(--accent-green); border-color: var(--accent-green); color: #06281a; }
+.op-btn-toggle[aria-pressed="true"] { background: var(--accent-orange); border-color: var(--accent-orange); color: #2a1503; }
+.op-btn-on { background: var(--accent-green); border-color: var(--accent-green); color: #06281a; }
 
-.op-mark-actions, .op-spim-controls { display: flex; gap: 0.5rem; }
-.op-mark-actions .op-btn, .op-spim-controls .op-btn { flex: 1; }
-.op-hint { font-size: 0.72rem; color: var(--text-muted); line-height: 1.4; }
-
-/* nudge clusters */
 .op-nudge { display: flex; gap: 0.35rem; }
+.op-nudge-2 { flex-wrap: wrap; }
 .op-nbtn {
-    flex: 1;
-    background: var(--bg-hover);
-    border: 1px solid var(--border);
-    color: var(--text);
-    font: 600 0.74rem/1 'Inter Tight', system-ui, sans-serif;
-    font-variant-numeric: tabular-nums;
-    padding: 0.4rem 0.3rem;
-    border-radius: 6px;
-    cursor: pointer;
-    transition: background 0.12s, border-color 0.12s, color 0.12s;
-}
-.op-nbtn:hover { border-color: var(--accent); color: var(--accent); }
-.op-micro {
-    display: flex; align-items: center; gap: 0.4rem;
-    font-size: 0.74rem; color: var(--text-muted);
-    font-variant-numeric: tabular-nums;
-}
-.op-micro b { color: var(--text); min-width: 2.2em; text-align: center; }
-.op-micro .op-nbtn { flex: 0 0 auto; width: 26px; }
+    flex: 1; min-width: 44px; background: var(--bg-hover); border: 1px solid var(--border); color: var(--text);
+    font: 600 0.74rem/1 'Inter Tight', system-ui, sans-serif; font-variant-numeric: tabular-nums;
+    padding: 0.42rem 0.3rem; border-radius: 6px; cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s, opacity 0.12s;
+}
+.op-nbtn:hover:not(:disabled) { border-color: var(--accent); color: var(--accent); }
+.op-nbtn:disabled { opacity: 0.35; cursor: not-allowed; }
+.op-spim-controls { display: flex; gap: 0.5rem; }
+.op-spim-controls .op-btn { flex: 1; }
+.op-micro { display: flex; align-items: center; gap: 0.4rem; font-size: 0.74rem; color: var(--text-muted); font-variant-numeric: tabular-nums; }
+.op-micro b { color: var(--text); min-width: 2.4em; text-align: center; }
+.op-micro .op-nbtn { flex: 0 0 auto; min-width: 26px; width: 26px; }
 
-/* embryo list */
-.op-embryo-list { display: flex; flex-direction: column; gap: 0.3rem; max-height: 220px; overflow-y: auto; }
-.op-empty { color: var(--text-muted); font-size: 0.82rem; padding: 0.4rem 0.1rem; }
-.op-erow {
-    display: flex; align-items: center; gap: 0.6rem;
-    padding: 0.45rem 0.55rem;
-    border: 1px solid transparent;
-    border-radius: 7px;
-    cursor: pointer;
-    transition: background 0.12s, border-color 0.12s;
-}
-.op-erow:hover { background: var(--bg-hover); }
-.op-erow-sel { background: var(--bg-hover); border-color: var(--accent); }
-.op-edot {
-    flex: 0 0 auto;
-    width: 22px; height: 22px;
-    border-radius: 50%;
-    display: inline-flex; align-items: center; justify-content: center;
-    color: #fff; font-size: 0.7rem; font-weight: 700;
-}
-.op-ecoord { flex: 1 1 auto; font-size: 0.8rem; font-variant-numeric: tabular-nums; color: var(--text); }
-.op-echip {
-    flex: 0 0 auto;
-    font-size: 0.64rem; font-weight: 600;
-    text-transform: uppercase; letter-spacing: 0.06em;
-    padding: 0.16rem 0.5rem;
-    border-radius: 999px;
-    border: 1px solid var(--border);
-    color: var(--text-muted);
-}
-.op-echip-centered { color: var(--accent); border-color: var(--accent); }
-.op-echip-focused { color: var(--accent-orange); border-color: var(--accent-orange); }
-.op-echip-imaged { color: var(--accent-green); border-color: var(--accent-green); }
+.op-empty { color: var(--text-muted); font-size: 0.78rem; padding: 0.5rem 0.2rem; }
 
-@media (max-width: 920px) {
-    .op-survey-body, .op-acquire-body { flex-direction: column; }
-    .op-rail { flex-basis: auto; }
+@media (max-width: 1040px) {
+    .operate { grid-template-columns: 1fr; grid-template-rows: auto auto 56vh auto;
+        grid-template-areas: "head" "spine" "stage" "rail"; height: auto; }
 }
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 7e4c5d3a..1009f5c3 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -1,459 +1,613 @@
 /**
- * Operate view — guided bottom-cam → SPIM operator surface.
+ * Operate view — "The Operator Spine".
  *
- * Three zones, mirroring the physical workflow:
- *   1. Survey & mark  — live bottom cam, fenced bottom-Z focus nudge, Detect /
- *                       click-to-mark all embryos on a frozen frame, Confirm.
- *   2. Embryos        — the single canonical experiment.embryos list (EMBRYOS_UPDATE),
- *                       each row a per-embryo state chip + select.
- *   3. Acquire        — for the selected embryo: Center → lower SPIM head (F-drive,
- *                       fenced) → focus SPIM (live + galvo/piezo/LED nudge) → Acquire.
+ * One guided surface for the bottom-cam → SPIM workflow. A single state driver
+ * (`renderStep`) reads the selected embryo + its progress and sets EVERYTHING in
+ * lockstep: the header stepper ("you are here"), the always-on safety status
+ * strip, the left worklist + dish mini-map, the one live viewport (its camera
+ * source + on-image overlays), and which single control group the right rail
+ * shows. Exactly one camera and one step are live at a time.
  *
- * Single source of truth: marking confirms into experiment.embryos via the
- * agent-free /api/devices/embryos/confirm endpoint; the list refreshes from the
- * canonical EMBRYOS_UPDATE event. No autonomous Z moves — every focus move is a
- * bounded, server-fenced nudge.
+ * Phase A (no embryo selected): A1 focus bottom objective → A2 mark all (one
+ * frozen FOV, positions only) → Confirm into the canonical list.
+ * Phase B (per selected embryo): B1 center → B2 lower SPIM head (fenced, floor) →
+ * B3 focus SPIM (LED) → B4 acquire → B5 retract & advance.
+ *
+ * Safety: manual fenced nudges only (no autofocus); F-drive floor honored and
+ * down-nudges auto-grey near it; XY centering blocked while the head is lowered;
+ * 'focused' is earned at B3 (never on a stray F-drive nudge); LED is force-closed
+ * on step-leave and view-leave.
  */
 const OperateManager = (function () {
-    // Camera transform constants (match gently/core/coordinates.py defaults).
-    const BASE_UM_PER_PX = 6.5 / 10.0;  // pixel_size_um / objective_mag
-    const MARK_HIT_PX = 14;             // click-to-remove radius (canvas px)
-
-    let _wired = false;
-    let _active = false;
-
-    // DOM
-    let _camImg, _camPh, _camStage, _markCanvas, _camToggle;
-    let _bzPos, _bzScore, _bzNudge;
-    let _detectBtn, _confirmBtn, _clearBtn, _markCount, _markHint;
-    let _embryoList, _embryoCount;
-    let _selLabel, _spimImg, _spimPh, _spimToggle, _ledBtn;
-    let _fdPos, _fdFloor, _fdNudge, _centerBtn, _acquireBtn;
-    let _gvVal, _pzVal, _spimScore;
-
-    // State
-    let _camOn = false, _spimOn = false;
-    let _lastFrame = null;        // last live bottom-cam payload {jpeg_b64, shape, downsample, focus_score}
+    const BASE_UM_PER_PX = 6.5 / 10.0;   // pixel_size_um / objective_mag
+    const MARK_HIT_PX = 14;
+    const SVG_NS = 'http://www.w3.org/2000/svg';
+    const ROLE_NEUTRAL = '#8a8f98';
+    const STATE_RANK = { marked: 0, centered: 1, lowering: 2, focused: 3, imaged: 4 };
+
+    let _wired = false, _active = false;
+
+    // workflow state
+    let _selected = null;            // embryo id, or null = Phase A (survey)
+    let _step = null;                // explicit B-step for the selected embryo
     let _marking = false;
-    let _frozenSrc = null;        // frozen image data URL
-    let _frozenFrame = null;      // {w, h, downsample} of the frozen frame (frame-space)
-    let _captureStage = [0, 0];   // stage XY at freeze time (µm)
-    let _markers = [];            // [{fx, fy, stageX, stageY, source}] fx/fy in frame-space px
-    let _embryos = [];            // canonical list (EMBRYOS_UPDATE shape)
-    let _selected = null;         // selected embryo id
-    const _states = {};           // embryo_id -> 'marked'|'centered'|'focused'|'imaged'
-    let _lastXY = null;           // {X, Y} from DEVICE_STATE_UPDATE
+    const _states = {};              // id -> marked|centered|lowering|focused|imaged
+    let _embryos = [];               // canonical EMBRYOS_UPDATE list
+    let _headLowered = false;        // global: is the SPIM head below safe travel?
+    let _acquiring = false;
+
+    // viewport / streams
+    let _camOn = false, _spimOn = false;
+    let _lastFrame = null;           // last live bottom-cam payload
+    let _lastSpimFrame = null;
+    let _bzScore = null, _spimScore = null;
+
+    // marking
+    let _frozenSrc = null, _frozenFrame = null, _captureStage = [0, 0], _markers = [];
+
+    // device telemetry
+    let _lastXY = null;              // {X,Y}
+    let _fdPos = null, _fdFloor = null;
     let _galvo = 0.0, _piezo = 50.0, _ledOn = false;
 
-    const _ROLE_COLOR = { test: '#ff66cc', calibration: '#00cccc', unassigned: '#8a8f98' };
-    const _STATE_LABEL = { marked: 'marked', centered: 'centered', focused: 'focused', imaged: 'imaged' };
+    // DOM (cached on wire)
+    const D = {};
 
     function $(id) { return document.getElementById(id); }
-    function toast(msg) { if (typeof showGentlyToast === 'function') showGentlyToast(msg); }
+    function toast(m) { if (typeof showGentlyToast === 'function') showGentlyToast(m); }
 
     async function postJSON(url, body) {
-        const res = await fetch(url, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(body || {}),
+        const res = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body || {}) });
+        if (!res.ok) { const t = await res.text().catch(() => ''); const e = new Error(`${res.status} ${t}`); e.status = res.status; throw e; }
+        return res.json().catch(() => ({}));
+    }
+    async function getJSON(url) { const r = await fetch(url); if (!r.ok) throw new Error(String(r.status)); return r.json(); }
+
+    function cacheDom() {
+        [
+            'op-stepper', 'op-loop-emb', 'op-st-head', 'op-st-floor', 'op-st-led', 'op-st-led-wrap',
+            'op-st-laser', 'op-st-laser-wrap', 'op-st-cam', 'op-minimap', 'op-board', 'op-board-count',
+            'op-survey-btn', 'op-badge', 'op-cam-stage', 'op-cam-img', 'op-mark-canvas', 'op-cam-ph',
+            'op-rail', 'op-rail-head', 'op-cam-toggle', 'op-bz-pos', 'op-bz-score', 'op-bz-nudge',
+            'op-tomark', 'op-detect', 'op-confirm', 'op-mark-count', 'op-clear', 'op-center', 'op-center-hint',
+            'op-fd-pos', 'op-fd-floor', 'op-fd-nudge', 'op-fd-d100', 'op-fd-d10', 'op-tofocus',
+            'op-spim-toggle', 'op-led', 'op-gv', 'op-pz', 'op-spim-score', 'op-infocus', 'op-acquire', 'op-retract',
+        ].forEach(id => { D[id] = $(id); });
+    }
+
+    // ── step model ───────────────────────────────────────────────────────
+    function stepForState(st) {
+        return { marked: 'b1', centered: 'b2', lowering: 'b2', focused: 'b4', imaged: 'b5' }[st] || 'b1';
+    }
+    function effectiveStep() {
+        if (!_selected) return _marking ? 'a2' : 'a1';
+        return _step || 'b1';
+    }
+    function cameraForStep(step) {
+        return (step === 'a1' || step === 'a2' || step === 'b1') ? 'bottom' : 'spim';
+    }
+
+    const RAIL_HEADS = {
+        a1: 'Focus the bottom objective', a2: 'Mark all embryos',
+        b1: 'Center the embryo', b2: 'Lower the SPIM head', b3: 'Focus the SPIM objective',
+        b4: 'Acquire the volume', b5: 'Retract & advance',
+    };
+    const STEP_NODE = { a1: 'a1', a2: 'a2', b1: 'b1', b2: 'b2', b3: 'b3', b4: 'b4', b5: 'b4' };
+
+    function setStep(s) { _step = s; renderStep(); }
+
+    // The single driver — every state change routes through here.
+    function renderStep() {
+        const step = effectiveStep();
+        const cam = cameraForStep(step);
+
+        // rail group + head
+        if (D['op-rail']) D['op-rail'].dataset.active = step;
+        if (D['op-rail-head']) {
+            const emb = _embryos.find(e => e.id === _selected);
+            D['op-rail-head'].textContent = emb
+                ? `Embryo ${labelFor(emb)} · ${RAIL_HEADS[step]}`
+                : RAIL_HEADS[step];
+        }
+
+        // stepper nodes (done/active/locked) driven by selected embryo's state
+        const st = _selected ? (_states[_selected] || 'marked') : null;
+        const rank = st ? STATE_RANK[st] : -1;
+        const order = { b1: 0, b2: 1, b3: 2, b4: 3 };
+        D['op-stepper'].querySelectorAll('.op-node').forEach(n => {
+            const node = n.dataset.node;
+            n.classList.remove('is-active', 'is-done', 'is-locked');
+            const active = STEP_NODE[step] === node;
+            if (node === 'a1' || node === 'a2') {
+                if (active && !_selected) n.classList.add('is-active');
+                else if (_embryos.length) n.classList.add('is-done');
+            } else {
+                const oi = order[node];
+                if (active) n.classList.add('is-active');
+                else if (rank > oi) n.classList.add('is-done');
+                else if (!_selected || rank < oi) n.classList.add('is-locked');
+            }
         });
-        if (!res.ok) {
-            const detail = await res.text().catch(() => '');
-            const err = new Error(`${res.status} ${detail}`);
-            err.status = res.status;
-            throw err;
+        if (D['op-loop-emb']) {
+            const emb = _embryos.find(e => e.id === _selected);
+            const idx = emb ? _embryos.indexOf(emb) + 1 : 0;
+            D['op-loop-emb'].textContent = emb ? ` · ${idx}/${_embryos.length}` : '';
         }
-        return res.json().catch(() => ({}));
+
+        // viewport: badge + stop the inactive camera
+        if (D['op-badge']) D['op-badge'].textContent =
+            (cam === 'bottom' ? 'Bottom cam' : 'SPIM · side A') + ' — ' + RAIL_HEADS[step].toLowerCase();
+        ensureInactiveCameraStopped(cam);
+        // show the right frame
+        if (cam === 'bottom' && !_marking && _lastFrame) setImg(_lastFrame);
+        else if (cam === 'spim' && _lastSpimFrame) setImg(_lastSpimFrame);
+        else if (cam === 'spim' && !_spimOn) { D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = ''; D['op-cam-ph'].textContent = 'SPIM view off'; }
+        else if (cam === 'bottom' && !_camOn && !_marking) { D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = ''; D['op-cam-ph'].textContent = 'Camera off'; }
+
+        // gating
+        if (D['op-center']) {
+            if (_headLowered) { D['op-center'].textContent = 'Retract head first'; D['op-center'].disabled = true; }
+            else { D['op-center'].textContent = 'Center stage on embryo'; D['op-center'].disabled = false; }
+        }
+        gateFdriveNudges();
+
+        drawOverlay(step);
+        renderStatus();
+        renderBoard();
+        renderMiniMap();
     }
-    async function getJSON(url) {
-        const res = await fetch(url);
-        if (!res.ok) throw new Error(String(res.status));
-        return res.json();
+
+    function ensureInactiveCameraStopped(cam) {
+        if (cam !== 'bottom' && _camOn) { fetch('/api/devices/bottom_camera/stream/stop', { method: 'POST' }).catch(() => {}); applyCam(false); }
+        if (cam !== 'spim' && _spimOn) { fetch('/api/devices/lightsheet/live/stop', { method: 'POST' }).catch(() => {}); _spimOn = false; D['op-spim-toggle'].textContent = 'Start view'; D['op-spim-toggle'].classList.remove('op-btn-on'); }
+    }
+    function setImg(p) {
+        if (!p || !p.jpeg_b64) return;
+        D['op-cam-img'].src = `data:${p.mime || 'image/jpeg'};base64,${p.jpeg_b64}`;
+        if (!D['op-cam-img'].classList.contains('has-frame')) { D['op-cam-img'].classList.add('has-frame'); D['op-cam-ph'].style.display = 'none'; }
     }
 
-    function cacheDom() {
-        _camImg = $('op-cam-img'); _camPh = $('op-cam-ph'); _camStage = $('op-cam-stage');
-        _markCanvas = $('op-mark-canvas'); _camToggle = $('op-cam-toggle');
-        _bzPos = $('op-bz-pos'); _bzScore = $('op-bz-score'); _bzNudge = $('op-bz-nudge');
-        _detectBtn = $('op-detect'); _confirmBtn = $('op-confirm'); _clearBtn = $('op-clear');
-        _markCount = $('op-mark-count'); _markHint = $('op-mark-hint');
-        _embryoList = $('op-embryo-list'); _embryoCount = $('op-embryo-count');
-        _selLabel = $('op-sel-label'); _spimImg = $('op-spim-img'); _spimPh = $('op-spim-ph');
-        _spimToggle = $('op-spim-toggle'); _ledBtn = $('op-led');
-        _fdPos = $('op-fd-pos'); _fdFloor = $('op-fd-floor'); _fdNudge = $('op-fd-nudge');
-        _centerBtn = $('op-center'); _acquireBtn = $('op-acquire');
-        _gvVal = $('op-gv'); _pzVal = $('op-pz'); _spimScore = $('op-spim-score');
-    }
-
-    // ---- Bottom-camera survey -------------------------------------------
-    async function toggleCamera() {
-        _camToggle.disabled = true;
-        try {
-            const ep = _camOn ? '/api/devices/bottom_camera/stream/stop'
-                              : '/api/devices/bottom_camera/stream/start';
-            const data = await postJSON(ep, {});
-            applyCameraState(!!data.streaming);
-        } catch (err) {
-            toast(`Camera toggle failed (${err.status || err.message})`);
-        } finally {
-            _camToggle.disabled = false;
+    // ── status strip ──────────────────────────────────────────────────────
+    function renderStatus() {
+        D['op-st-head'].textContent = _headLowered ? '▼ lowered' : '▲ up';
+        D['op-st-head'].parentElement.classList.toggle('is-down', _headLowered);
+        D['op-st-floor'].textContent = _fdFloor != null ? `${Math.round(_fdFloor)} µm` : '—';
+        D['op-st-led'].textContent = _ledOn ? 'EMITTING' : 'OFF';
+        D['op-st-led-wrap'].classList.toggle('is-emitting', _ledOn);
+        D['op-st-laser'].textContent = _acquiring ? 'EMITTING' : 'OFF';
+        D['op-st-laser-wrap'].classList.toggle('is-emitting', _acquiring);
+        const cam = cameraForStep(effectiveStep());
+        const on = cam === 'bottom' ? _camOn : _spimOn;
+        D['op-st-cam'].textContent = `${cam === 'bottom' ? 'bottom' : 'SPIM'} ${on ? '● live' : '○ off'}`;
+    }
+
+    // ── left spine: worklist + mini-map ────────────────────────────────────
+    function resolveXY(emb) {
+        const f = emb && emb.position_fine;
+        if (f && Number.isFinite(f.x) && Number.isFinite(f.y)) return { x: f.x, y: f.y };
+        const c = emb && emb.position_coarse;
+        if (c && Number.isFinite(c.x) && Number.isFinite(c.y)) return { x: c.x, y: c.y };
+        return null;
+    }
+    function labelFor(emb) { const m = emb && emb.id && String(emb.id).match(/(\d+)/); return m ? m[1] : '?'; }
+
+    function renderBoard() {
+        if (!D['op-board']) return;
+        const imaged = _embryos.filter(e => _states[e.id] === 'imaged').length;
+        D['op-board-count'].textContent = `${imaged} / ${_embryos.length} imaged`;
+        D['op-board'].innerHTML = '';
+        if (!_embryos.length) { const e = document.createElement('div'); e.className = 'op-empty'; e.textContent = 'No embryos yet'; D['op-board'].appendChild(e); return; }
+        _embryos.forEach(emb => {
+            const st = _states[emb.id] || 'marked';
+            const rank = STATE_RANK[st];
+            const xy = resolveXY(emb);
+            const row = document.createElement('div');
+            row.className = 'op-brow' + (emb.id === _selected ? ' is-sel' : '');
+            row.addEventListener('click', () => selectEmbryo(emb.id));
+
+            const dot = document.createElement('span');
+            dot.className = 'op-bdot'; dot.textContent = labelFor(emb);
+            if (st === 'imaged') dot.style.background = 'var(--accent-green)';
+            row.appendChild(dot);
+
+            const meta = document.createElement('span'); meta.className = 'op-bmeta';
+            const lab = document.createElement('span'); lab.className = 'op-blabel';
+            lab.textContent = xy ? `(${xy.x.toFixed(0)}, ${xy.y.toFixed(0)})` : `embryo ${labelFor(emb)}`;
+            meta.appendChild(lab);
+            const track = document.createElement('span'); track.className = 'op-track';
+            ['centered', 'lowering', 'focused', 'imaged'].forEach((k, i) => {
+                const t = document.createElement('span'); t.className = 'op-tnode';
+                if (rank >= STATE_RANK[k]) t.classList.add('on-' + k);
+                track.appendChild(t);
+            });
+            meta.appendChild(track);
+            row.appendChild(meta);
+
+            const sc = document.createElement('span'); sc.className = 'op-bstate'; sc.textContent = st;
+            row.appendChild(sc);
+            D['op-board'].appendChild(row);
+        });
+    }
+
+    function renderMiniMap() {
+        const svg = D['op-minimap']; if (!svg) return;
+        while (svg.firstChild) svg.removeChild(svg.firstChild);
+        const pts = _embryos.map(e => resolveXY(e)).filter(Boolean);
+        if (_lastXY) pts.push({ x: _lastXY.X, y: _lastXY.Y });
+        if (!pts.length) return;
+        let xMin = Math.min(...pts.map(p => p.x)), xMax = Math.max(...pts.map(p => p.x));
+        let yMin = Math.min(...pts.map(p => p.y)), yMax = Math.max(...pts.map(p => p.y));
+        const span = Math.max(xMax - xMin, yMax - yMin, 100), padf = span * 0.18;
+        const cx = (xMin + xMax) / 2, cy = (yMin + yMax) / 2, half = span / 2 + padf;
+        const toX = x => ((x - (cx - half)) / (2 * half)) * 100;
+        const toY = y => 100 - ((y - (cy - half)) / (2 * half)) * 100;  // flip Y (stage +Y up)
+        const r = 2.4;
+        _embryos.forEach(emb => {
+            const xy = resolveXY(emb); if (!xy) return;
+            const st = _states[emb.id] || 'marked';
+            const c = document.createElementNS(SVG_NS, 'circle');
+            c.setAttribute('cx', toX(xy.x)); c.setAttribute('cy', toY(xy.y)); c.setAttribute('r', r);
+            const col = st === 'imaged' ? 'var(--accent-green)' : st === 'focused' ? 'var(--accent-orange)'
+                : (st === 'centered' || st === 'lowering') ? 'var(--accent)' : ROLE_NEUTRAL;
+            c.setAttribute('fill', col);
+            if (emb.id === _selected) { c.setAttribute('stroke', 'var(--text)'); c.setAttribute('stroke-width', '1.2'); }
+            svg.appendChild(c);
+        });
+        if (_lastXY) {  // stage crosshair
+            const X = toX(_lastXY.X), Y = toY(_lastXY.Y);
+            [[X - 4, Y, X + 4, Y], [X, Y - 4, X, Y + 4]].forEach(([x1, y1, x2, y2]) => {
+                const l = document.createElementNS(SVG_NS, 'line');
+                l.setAttribute('x1', x1); l.setAttribute('y1', y1); l.setAttribute('x2', x2); l.setAttribute('y2', y2);
+                l.setAttribute('stroke', 'var(--accent-cyan)'); l.setAttribute('stroke-width', '0.8');
+                svg.appendChild(l);
+            });
         }
     }
-    function applyCameraState(on) {
-        _camOn = on;
-        _camToggle.textContent = on ? 'Stop camera' : 'Start camera';
-        _camToggle.classList.toggle('op-btn-on', on);
-        if (!on && !_marking) { _camImg.classList.remove('has-frame'); _camPh.style.display = ''; _camPh.textContent = 'Camera off'; }
-        else if (on && !_marking) { _camPh.textContent = 'waiting…'; }
+
+    // ── viewport overlays ──────────────────────────────────────────────────
+    function renderedRect() {
+        const sb = D['op-cam-stage'].getBoundingClientRect();
+        const fw = _frozenFrame ? _frozenFrame.w : (_lastFrame ? _lastFrame.shape[1] : sb.width);
+        const fh = _frozenFrame ? _frozenFrame.h : (_lastFrame ? _lastFrame.shape[0] : sb.height);
+        const ar = fw / fh, sar = sb.width / sb.height;
+        let w, h;
+        if (ar > sar) { w = sb.width; h = sb.width / ar; } else { h = sb.height; w = sb.height * ar; }
+        return { x: (sb.width - w) / 2, y: (sb.height - h) / 2, w, h, fw, fh, sb };
+    }
+    function canvasCtx() {
+        const sb = D['op-cam-stage'].getBoundingClientRect();
+        D['op-mark-canvas'].width = Math.round(sb.width); D['op-mark-canvas'].height = Math.round(sb.height);
+        const ctx = D['op-mark-canvas'].getContext('2d');
+        ctx.clearRect(0, 0, D['op-mark-canvas'].width, D['op-mark-canvas'].height);
+        return ctx;
+    }
+    function drawOverlay(step) {
+        if (!D['op-mark-canvas']) return;
+        if (step === 'a2') return drawMarkers();
+        const ctx = canvasCtx();
+        if (step === 'b1') drawReticle(ctx);
+        else if (step === 'b2') drawFloorGauge(ctx);
+    }
+    function drawMarkers() {
+        const r = renderedRect(); const ctx = canvasCtx();
+        _markers.forEach((m, i) => {
+            const cx = r.x + (m.fx / r.fw) * r.w, cy = r.y + (m.fy / r.fh) * r.h;
+            ctx.beginPath(); ctx.arc(cx, cy, 11, 0, 7); ctx.lineWidth = 2; ctx.strokeStyle = '#34d399'; ctx.stroke();
+            ctx.beginPath(); ctx.moveTo(cx - 6, cy); ctx.lineTo(cx + 6, cy); ctx.moveTo(cx, cy - 6); ctx.lineTo(cx, cy + 6); ctx.stroke();
+            ctx.fillStyle = '#34d399'; ctx.font = '600 11px Inter Tight, sans-serif'; ctx.fillText(String(i + 1), cx + 13, cy - 8);
+        });
     }
+    function drawReticle(ctx) {
+        const sb = D['op-mark-canvas']; const cx = sb.width / 2, cy = sb.height / 2;
+        ctx.strokeStyle = 'rgba(96,165,250,0.85)'; ctx.lineWidth = 1.2;
+        ctx.beginPath(); ctx.moveTo(cx - 22, cy); ctx.lineTo(cx + 22, cy); ctx.moveTo(cx, cy - 22); ctx.lineTo(cx, cy + 22); ctx.stroke();
+        ctx.beginPath(); ctx.arc(cx, cy, 10, 0, 7); ctx.stroke();
+        // SPIM-FOV footprint box (light-sheet FOV << bottom FOV)
+        const r = renderedRect(); const bw = r.w * 0.22, bh = r.h * 0.22;
+        ctx.setLineDash([5, 3]); ctx.strokeStyle = 'rgba(34,211,238,0.7)';
+        ctx.strokeRect(cx - bw / 2, cy - bh / 2, bw, bh); ctx.setLineDash([]);
+        ctx.fillStyle = 'rgba(34,211,238,0.85)'; ctx.font = '600 10px Inter Tight, sans-serif';
+        ctx.fillText('SPIM FOV', cx - bw / 2, cy - bh / 2 - 4);
+    }
+    function drawFloorGauge(ctx) {
+        const sb = D['op-mark-canvas']; const pad = 24, h = 26, y = sb.height - pad - h, w = sb.width - 2 * pad, x = pad;
+        const floor = _fdFloor;
+        ctx.fillStyle = 'rgba(0,0,0,0.45)'; ctx.fillRect(x, y, w, h);
+        ctx.strokeStyle = 'rgba(255,255,255,0.25)'; ctx.lineWidth = 1; ctx.strokeRect(x, y, w, h);
+        // fill: full when far from floor, shrinks toward floor
+        const MAXD = 500;
+        const frac = floor == null ? 0 : Math.max(0, Math.min(1, floor / MAXD));
+        const col = floor == null ? '#555' : floor <= 30 ? '#ef4444' : floor < 150 ? '#fb923c' : '#4ade80';
+        ctx.fillStyle = col; ctx.fillRect(x + 2, y + 2, (w - 4) * frac, h - 4);
+        ctx.fillStyle = '#fff'; ctx.font = '700 13px Inter Tight, sans-serif';
+        ctx.fillText(floor == null ? 'distance to floor —' : `${Math.round(floor)} µm to floor (30 µm hard floor)`, x + 8, y + h - 8);
+    }
+
+    // ── bottom-cam frames ──────────────────────────────────────────────────
     function onBottomFrame(p) {
         if (!p || !p.jpeg_b64) return;
         _lastFrame = p;
-        if (p.focus_score != null) _bzScore.textContent = Number(p.focus_score).toFixed(3);
-        if (_marking) return;  // keep the frozen frame visible while marking
-        _camImg.src = `data:${p.mime || 'image/jpeg'};base64,${p.jpeg_b64}`;
-        if (!_camImg.classList.contains('has-frame')) { _camImg.classList.add('has-frame'); _camPh.style.display = 'none'; }
+        if (p.focus_score != null) { _bzScore = p.focus_score; if (D['op-bz-score']) D['op-bz-score'].textContent = Number(p.focus_score).toFixed(3); }
+        const cam = cameraForStep(effectiveStep());
+        if (cam === 'bottom' && !_marking) setImg(p);
+    }
+    function onLightsheetFrame(p) {
+        if (!p || !p.jpeg_b64) return;
+        _lastSpimFrame = p;
+        if (p.focus_score != null) { _spimScore = p.focus_score; if (D['op-spim-score']) D['op-spim-score'].textContent = Number(p.focus_score).toFixed(3); }
+        if (cameraForStep(effectiveStep()) === 'spim') setImg(p);
     }
 
-    // ---- Marking --------------------------------------------------------
-    function umPerPxDisplay() {
-        const ds = (_frozenFrame && _frozenFrame.downsample) || 1;
-        return BASE_UM_PER_PX * ds;
+    // ── A1 focus bottom ────────────────────────────────────────────────────
+    async function toggleCamera() {
+        D['op-cam-toggle'].disabled = true;
+        try {
+            const ep = _camOn ? '/api/devices/bottom_camera/stream/stop' : '/api/devices/bottom_camera/stream/start';
+            const d = await postJSON(ep, {}); applyCam(!!d.streaming);
+        } catch (e) { toast(`Camera toggle failed (${e.status || e.message})`); }
+        finally { D['op-cam-toggle'].disabled = false; }
     }
-    // frame-space (downsampled px) -> stage µm, using the frozen capture pose.
+    function applyCam(on) {
+        _camOn = on;
+        D['op-cam-toggle'].textContent = on ? 'Stop camera' : 'Start camera';
+        D['op-cam-toggle'].classList.toggle('op-btn-on', on);
+        if (!on && !_marking) { D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = ''; D['op-cam-ph'].textContent = 'Camera off'; }
+        renderStatus();
+    }
+    async function nudgeBottomZ(delta) {
+        if (_marking) { toast('Finish marking first'); return; }
+        try { const d = await postJSON('/api/devices/stage/bottom_z/nudge', { delta }); if (d.position != null) D['op-bz-pos'].textContent = Number(d.position).toFixed(1); }
+        catch (e) { toast(`Bottom-Z nudge blocked (${e.status || e.message})`); }
+    }
+
+    // ── A2 mark ────────────────────────────────────────────────────────────
+    function umPerPxDisplay() { return BASE_UM_PER_PX * ((_frozenFrame && _frozenFrame.downsample) || 1); }
     function frameToStage(fx, fy) {
-        const u = umPerPxDisplay();
-        const cx = _frozenFrame.w / 2, cy = _frozenFrame.h / 2;
+        const u = umPerPxDisplay(), cx = _frozenFrame.w / 2, cy = _frozenFrame.h / 2;
         return [_captureStage[0] + (fx - cx) * u, _captureStage[1] - (fy - cy) * u];
     }
-    function enterMarking(candidates) {
+    function enterMarking(cands) {
         if (!_lastFrame) { toast('Start the camera first'); return false; }
         _marking = true;
         _frozenFrame = { w: _lastFrame.shape[1], h: _lastFrame.shape[0], downsample: _lastFrame.downsample || 1 };
         _captureStage = _lastFrame.stage_position || (_lastXY ? [_lastXY.X, _lastXY.Y] : [0, 0]);
         _frozenSrc = `data:${_lastFrame.mime || 'image/jpeg'};base64,${_lastFrame.jpeg_b64}`;
-        _camImg.src = _frozenSrc; _camImg.classList.add('has-frame'); _camPh.style.display = 'none';
+        D['op-cam-img'].src = _frozenSrc; D['op-cam-img'].classList.add('has-frame'); D['op-cam-ph'].style.display = 'none';
         _markers = [];
-        (candidates || []).forEach(c => {
+        (cands || []).forEach(c => {
             const ds = _frozenFrame.downsample;
-            const fx = (c.pixel_x != null) ? c.pixel_x / ds : _frozenFrame.w / 2;
-            const fy = (c.pixel_y != null) ? c.pixel_y / ds : _frozenFrame.h / 2;
-            const stage = (c.stage_x_um != null && c.stage_y_um != null)
-                ? [c.stage_x_um, c.stage_y_um] : frameToStage(fx, fy);
-            _markers.push({ fx, fy, stageX: stage[0], stageY: stage[1], source: 'sam' });
+            const fx = c.pixel_x != null ? c.pixel_x / ds : _frozenFrame.w / 2;
+            const fy = c.pixel_y != null ? c.pixel_y / ds : _frozenFrame.h / 2;
+            const s = (c.stage_x_um != null && c.stage_y_um != null) ? [c.stage_x_um, c.stage_y_um] : frameToStage(fx, fy);
+            _markers.push({ fx, fy, stageX: s[0], stageY: s[1], source: 'sam' });
         });
-        _camStage.classList.add('op-marking');
-        _markHint.textContent = 'Click to add an embryo · click a marker to remove · Confirm when done.';
-        drawMarkers(); updateMarkActions();
+        D['op-cam-stage'].classList.add('is-marking');
+        renderStep(); updateMarkCount();
         return true;
     }
     function exitMarking() {
         _marking = false; _markers = []; _frozenSrc = null; _frozenFrame = null;
-        _camStage.classList.remove('op-marking');
-        clearCanvas();
-        updateMarkActions();
-        _markHint.textContent = 'Start the camera, then Detect — or click the image to mark embryos.';
-        if (_camOn && _lastFrame) onBottomFrame(_lastFrame);
+        D['op-cam-stage'].classList.remove('is-marking');
     }
-    // rendered image rect (object-fit: contain) within the stage box.
-    function renderedRect() {
-        const sb = _camStage.getBoundingClientRect();
-        const fw = _frozenFrame ? _frozenFrame.w : (_lastFrame ? _lastFrame.shape[1] : sb.width);
-        const fh = _frozenFrame ? _frozenFrame.h : (_lastFrame ? _lastFrame.shape[0] : sb.height);
-        const ar = fw / fh, sar = sb.width / sb.height;
-        let w, h;
-        if (ar > sar) { w = sb.width; h = sb.width / ar; } else { h = sb.height; w = sb.height * ar; }
-        return { x: (sb.width - w) / 2, y: (sb.height - h) / 2, w, h, fw, fh, sb };
-    }
-    function clearCanvas() {
-        if (!_markCanvas) return;
-        const ctx = _markCanvas.getContext('2d');
-        ctx && ctx.clearRect(0, 0, _markCanvas.width, _markCanvas.height);
-    }
-    function drawMarkers() {
-        if (!_markCanvas || !_marking) return;
-        const r = renderedRect();
-        _markCanvas.width = Math.round(r.sb.width); _markCanvas.height = Math.round(r.sb.height);
-        const ctx = _markCanvas.getContext('2d');
-        ctx.clearRect(0, 0, _markCanvas.width, _markCanvas.height);
-        _markers.forEach((m, i) => {
-            const cx = r.x + (m.fx / r.fw) * r.w;
-            const cy = r.y + (m.fy / r.fh) * r.h;
-            ctx.beginPath(); ctx.arc(cx, cy, 11, 0, 7);
-            ctx.lineWidth = 2; ctx.strokeStyle = '#34d399'; ctx.stroke();
-            ctx.beginPath(); ctx.moveTo(cx - 6, cy); ctx.lineTo(cx + 6, cy);
-            ctx.moveTo(cx, cy - 6); ctx.lineTo(cx, cy + 6); ctx.stroke();
-            ctx.fillStyle = '#34d399'; ctx.font = '600 11px Inter Tight, system-ui, sans-serif';
-            ctx.fillText(String(i + 1), cx + 13, cy - 8);
-        });
+    function updateMarkCount() {
+        const n = _markers.length;
+        if (D['op-mark-count']) D['op-mark-count'].textContent = `(${n})`;
+        if (D['op-confirm']) D['op-confirm'].disabled = n === 0;
+        if (D['op-clear']) D['op-clear'].disabled = n === 0;
     }
     function onCanvasClick(e) {
         if (!_marking) return;
-        const r = renderedRect();
-        const rect = _markCanvas.getBoundingClientRect();
+        const r = renderedRect(), rect = D['op-mark-canvas'].getBoundingClientRect();
         const cxv = e.clientX - rect.left, cyv = e.clientY - rect.top;
-        // hit-test existing markers (remove)
         for (let i = 0; i < _markers.length; i++) {
-            const mx = r.x + (_markers[i].fx / r.fw) * r.w;
-            const my = r.y + (_markers[i].fy / r.fh) * r.h;
-            if (Math.hypot(cxv - mx, cyv - my) <= MARK_HIT_PX) {
-                _markers.splice(i, 1); drawMarkers(); updateMarkActions(); return;
-            }
+            const mx = r.x + (_markers[i].fx / r.fw) * r.w, my = r.y + (_markers[i].fy / r.fh) * r.h;
+            if (Math.hypot(cxv - mx, cyv - my) <= MARK_HIT_PX) { _markers.splice(i, 1); drawMarkers(); updateMarkCount(); return; }
         }
-        // add — convert canvas px -> frame-space px -> stage µm
         if (cxv < r.x || cxv > r.x + r.w || cyv < r.y || cyv > r.y + r.h) return;
-        const fx = ((cxv - r.x) / r.w) * r.fw;
-        const fy = ((cyv - r.y) / r.h) * r.fh;
-        const stage = frameToStage(fx, fy);
-        _markers.push({ fx, fy, stageX: stage[0], stageY: stage[1], source: 'manual' });
-        drawMarkers(); updateMarkActions();
-    }
-    function updateMarkActions() {
-        const n = _markers.length;
-        _markCount.textContent = `(${n})`;
-        _confirmBtn.disabled = !_marking || n === 0;
-        _clearBtn.disabled = !_marking || n === 0;
+        const fx = ((cxv - r.x) / r.w) * r.fw, fy = ((cyv - r.y) / r.h) * r.fh, s = frameToStage(fx, fy);
+        _markers.push({ fx, fy, stageX: s[0], stageY: s[1], source: 'manual' });
+        drawMarkers(); updateMarkCount();
     }
     async function runDetect() {
-        _detectBtn.disabled = true; _detectBtn.textContent = 'Detecting…';
+        if (!_marking && !enterMarking([])) return;
+        D['op-detect'].disabled = true; D['op-detect'].textContent = 'Detecting…';
         try {
-            const data = await postJSON('/api/devices/detect_embryos', {});
-            const cands = Array.isArray(data.embryos) ? data.embryos : [];
-            if (_lastFrame && data.stage_position) _lastFrame.stage_position = data.stage_position;
-            if (enterMarking(cands)) toast(`Detected ${cands.length} candidate${cands.length === 1 ? '' : 's'} — review & confirm`);
-        } catch (err) {
-            toast(`Detect failed (${err.status || err.message})`);
-        } finally {
-            _detectBtn.disabled = false; _detectBtn.textContent = 'Detect';
-        }
+            const d = await postJSON('/api/devices/detect_embryos', {});
+            const cands = Array.isArray(d.embryos) ? d.embryos : [];
+            if (_lastFrame && d.stage_position) { _lastFrame.stage_position = d.stage_position; _captureStage = d.stage_position; }
+            cands.forEach(c => {
+                const ds = _frozenFrame.downsample;
+                const fx = c.pixel_x != null ? c.pixel_x / ds : _frozenFrame.w / 2;
+                const fy = c.pixel_y != null ? c.pixel_y / ds : _frozenFrame.h / 2;
+                const s = (c.stage_x_um != null && c.stage_y_um != null) ? [c.stage_x_um, c.stage_y_um] : frameToStage(fx, fy);
+                _markers.push({ fx, fy, stageX: s[0], stageY: s[1], source: 'sam' });
+            });
+            drawMarkers(); updateMarkCount();
+            toast(`Detected ${cands.length} candidate${cands.length === 1 ? '' : 's'}`);
+        } catch (e) { toast(`Detect failed (${e.status || e.message})`); }
+        finally { D['op-detect'].disabled = false; D['op-detect'].textContent = 'Detect (SAM)'; }
     }
     async function confirmMarks() {
         if (!_markers.length) return;
-        _confirmBtn.disabled = true;
+        D['op-confirm'].disabled = true;
         try {
-            // Stage coords register the embryos; pixel coords + the frozen frame
-            // are persisted as localization labels (sub-project B) server-side.
-            const markers = _markers.map(m => ({
-                stage_x_um: m.stageX, stage_y_um: m.stageY,
-                pixel_x: m.fx, pixel_y: m.fy, source: m.source,
-            }));
-            const data = await postJSON('/api/devices/embryos/confirm', {
-                markers,
-                image_b64: _frozenSrc ? _frozenSrc.split(',')[1] : undefined,
+            const markers = _markers.map(m => ({ stage_x_um: m.stageX, stage_y_um: m.stageY, pixel_x: m.fx, pixel_y: m.fy, source: m.source }));
+            const d = await postJSON('/api/devices/embryos/confirm', {
+                markers, image_b64: _frozenSrc ? _frozenSrc.split(',')[1] : undefined,
                 frame: _frozenFrame ? { w: _frozenFrame.w, h: _frozenFrame.h, downsample: _frozenFrame.downsample } : undefined,
                 stage_position: _captureStage,
             });
-            const n = (data.registered || []).length;
-            toast(`Registered ${n} embryo${n === 1 ? '' : 's'}`);
-            exitMarking();  // list refreshes via EMBRYOS_UPDATE
-        } catch (err) {
-            toast(`Confirm failed (${err.status || err.message})`);
-            _confirmBtn.disabled = false;
-        }
-    }
-
-    // ---- Embryo list (single source of truth) ---------------------------
-    function resolveXY(emb) {
-        const f = emb && emb.position_fine;
-        if (f && Number.isFinite(f.x) && Number.isFinite(f.y)) return { x: f.x, y: f.y };
-        const c = emb && emb.position_coarse;
-        if (c && Number.isFinite(c.x) && Number.isFinite(c.y)) return { x: c.x, y: c.y };
-        return null;
-    }
-    function labelFor(emb, i) {
-        const m = emb.id && String(emb.id).match(/(\d+)/);
-        return m ? m[1] : String(i + 1);
-    }
-    function onEmbryosUpdate(p) {
-        _embryos = (p && Array.isArray(p.embryos)) ? p.embryos : [];
-        // prune state for embryos that no longer exist
-        const ids = new Set(_embryos.map(e => e.id));
-        Object.keys(_states).forEach(id => { if (!ids.has(id)) delete _states[id]; });
-        _embryos.forEach(e => { if (!_states[e.id]) _states[e.id] = 'marked'; });
-        if (_selected && !ids.has(_selected)) selectEmbryo(null);
-        renderList();
-    }
-    function renderList() {
-        if (!_embryoList) return;
-        _embryoCount.textContent = _embryos.length ? `(${_embryos.length})` : '';
-        _embryoList.innerHTML = '';
-        if (!_embryos.length) {
-            const e = document.createElement('div'); e.className = 'op-empty';
-            e.textContent = 'No embryos yet — mark some in step 1.';
-            _embryoList.appendChild(e); return;
-        }
-        _embryos.forEach((emb, i) => {
-            const xy = resolveXY(emb);
-            const row = document.createElement('div');
-            row.className = 'op-erow' + (emb.id === _selected ? ' op-erow-sel' : '');
-            row.addEventListener('click', () => selectEmbryo(emb.id));
-
-            const dot = document.createElement('span');
-            dot.className = 'op-edot'; dot.textContent = labelFor(emb, i);
-            dot.style.background = _ROLE_COLOR[emb.role] || _ROLE_COLOR.unassigned;
-            row.appendChild(dot);
-
-            const coord = document.createElement('span');
-            coord.className = 'op-ecoord';
-            coord.textContent = xy ? `(${xy.x.toFixed(0)}, ${xy.y.toFixed(0)}) µm` : 'no position';
-            row.appendChild(coord);
-
-            const chip = document.createElement('span');
-            const st = _states[emb.id] || 'marked';
-            chip.className = `op-echip op-echip-${st}`;
-            chip.textContent = _STATE_LABEL[st] || st;
-            row.appendChild(chip);
-
-            _embryoList.appendChild(row);
-        });
+            toast(`Registered ${(d.registered || []).length} embryo${(d.registered || []).length === 1 ? '' : 's'}`);
+            exitMarking();  // EMBRYOS_UPDATE refreshes the board, then auto-select first
+        } catch (e) { toast(`Confirm failed (${e.status || e.message})`); D['op-confirm'].disabled = false; }
     }
-    function setState(id, st) { if (id) { _states[id] = st; renderList(); } }
 
-    // ---- Acquire (selected embryo) --------------------------------------
+    // ── B1 center ──────────────────────────────────────────────────────────
     function selectEmbryo(id) {
         _selected = id;
-        const emb = _embryos.find(e => e.id === id);
-        _selLabel.textContent = emb ? `— embryo ${labelFor(emb, _embryos.indexOf(emb))}` : '— select an embryo';
-        _centerBtn.disabled = !emb;
-        _acquireBtn.disabled = !emb || (_states[id] !== 'focused' && _states[id] !== 'imaged');
-        renderList();
+        if (id) _step = stepForState(_states[id] || 'marked');
+        renderStep();
     }
     async function centerOnSelected() {
-        const emb = _embryos.find(e => e.id === _selected);
-        const xy = emb ? resolveXY(emb) : null;
+        if (_headLowered) { toast('Retract the SPIM head first'); return; }
+        const emb = _embryos.find(e => e.id === _selected), xy = emb ? resolveXY(emb) : null;
         if (!xy) return;
-        _centerBtn.disabled = true; _centerBtn.textContent = 'Centering…';
+        D['op-center'].disabled = true; D['op-center'].textContent = 'Centering…';
         try {
             await postJSON('/api/devices/stage/move', { x: xy.x, y: xy.y });
-            setState(_selected, 'centered');
-            toast(`Centred on embryo ${labelFor(emb, _embryos.indexOf(emb))}`);
-        } catch (err) {
-            toast(`Center failed (${err.status || err.message})`);
-        } finally {
-            _centerBtn.disabled = false; _centerBtn.textContent = 'Center stage on embryo';
-        }
+            advanceState(_selected, 'centered'); setStep('b2');
+            toast(`Centred on embryo ${labelFor(emb)}`);
+        } catch (e) { toast(`Center failed (${e.status || e.message})`); D['op-center'].disabled = false; D['op-center'].textContent = 'Center stage on embryo'; }
     }
-    async function acquireSelected() {
-        if (!_selected) return;
-        _acquireBtn.disabled = true; _acquireBtn.textContent = 'Acquiring…';
-        try {
-            await postJSON('/api/devices/acquire/volume', { num_slices: 50, exposure_ms: 10.0 });
-            setState(_selected, 'imaged');
-            toast('Volume acquired');
-        } catch (err) {
-            toast(`Acquire failed (${err.status || err.message})`);
-        } finally {
-            _acquireBtn.disabled = false; _acquireBtn.textContent = 'Acquire volume';
-        }
+    function advanceState(id, st) {
+        if (!id) return;
+        if (STATE_RANK[st] > STATE_RANK[_states[id] || 'marked']) _states[id] = st;
+        renderStep();
     }
 
-    // ---- Focus Z nudges (fenced) ----------------------------------------
-    async function nudgeBottomZ(delta) {
-        try {
-            const d = await postJSON('/api/devices/stage/bottom_z/nudge', { delta });
-            if (d.position != null) _bzPos.textContent = Number(d.position).toFixed(1);
-        } catch (err) { toast(`Bottom-Z nudge blocked (${err.status || err.message})`); }
+    // ── B2 lower (F-drive, fenced) ─────────────────────────────────────────
+    function gateFdriveNudges() {
+        // auto-grey down-nudges that would exceed remaining distance-to-floor
+        if (D['op-fd-d100']) D['op-fd-d100'].disabled = _fdFloor != null && _fdFloor < 100;
+        if (D['op-fd-d10']) D['op-fd-d10'].disabled = _fdFloor != null && _fdFloor < 10;
     }
     async function nudgeFdrive(delta) {
+        if (delta < 0 && _fdFloor != null && Math.abs(delta) > _fdFloor) { toast('Too close to the floor for that step'); return; }
         try {
             const d = await postJSON('/api/devices/spim/fdrive/nudge', { delta });
-            if (d.position != null) _fdPos.textContent = Number(d.position).toFixed(1);
-            if (d.distance_to_floor != null) _fdFloor.textContent = Number(d.distance_to_floor).toFixed(0);
-            if (_selected) setState(_selected, 'focused');
-            selectEmbryo(_selected);  // re-eval acquire enable
-        } catch (err) { toast(`F-drive nudge blocked (${err.status || err.message})`); }
-    }
-    async function refreshZReadouts() {
-        try { const b = await getJSON('/api/devices/stage/bottom_z'); if (b.position != null) _bzPos.textContent = Number(b.position).toFixed(1); } catch (_) {}
-        try {
-            const f = await getJSON('/api/devices/spim/fdrive');
-            if (f.position != null) _fdPos.textContent = Number(f.position).toFixed(1);
-            if (f.distance_to_floor != null) _fdFloor.textContent = Number(f.distance_to_floor).toFixed(0);
-        } catch (_) {}
+            if (d.position != null) { _fdPos = d.position; D['op-fd-pos'].textContent = Number(d.position).toFixed(1); }
+            if (d.distance_to_floor != null) { _fdFloor = d.distance_to_floor; D['op-fd-floor'].textContent = Number(d.distance_to_floor).toFixed(0); }
+            if (delta < 0) { _headLowered = true; if (_selected) advanceState(_selected, 'lowering'); }
+            renderStep();  // refresh gauge + gates + status
+        } catch (e) { toast(`F-drive nudge blocked (${e.status || e.message})`); }
     }
 
-    // ---- SPIM focus -----------------------------------------------------
+    // ── B3 focus SPIM ──────────────────────────────────────────────────────
     async function toggleSpim() {
-        _spimToggle.disabled = true;
+        D['op-spim-toggle'].disabled = true;
         try {
             const ep = _spimOn ? '/api/devices/lightsheet/live/stop' : '/api/devices/lightsheet/live/start';
-            const data = await postJSON(ep, {});
-            _spimOn = !!data.streaming;
-            _spimToggle.textContent = _spimOn ? 'Stop view' : 'Start view';
-            _spimToggle.classList.toggle('op-btn-on', _spimOn);
-            if (!_spimOn) { _spimImg.classList.remove('has-frame'); _spimPh.style.display = ''; }
-            else _spimPh.textContent = 'waiting…';
-        } catch (err) { toast(`SPIM view toggle failed (${err.status || err.message})`); }
-        finally { _spimToggle.disabled = false; }
-    }
-    function onLightsheetFrame(p) {
-        if (!p || !p.jpeg_b64) return;
-        _spimImg.src = `data:${p.mime || 'image/jpeg'};base64,${p.jpeg_b64}`;
-        if (!_spimImg.classList.contains('has-frame')) { _spimImg.classList.add('has-frame'); _spimPh.style.display = 'none'; }
-        if (p.focus_score != null) _spimScore.textContent = Number(p.focus_score).toFixed(3);
+            const d = await postJSON(ep, {}); _spimOn = !!d.streaming;
+            D['op-spim-toggle'].textContent = _spimOn ? 'Stop view' : 'Start view';
+            D['op-spim-toggle'].classList.toggle('op-btn-on', _spimOn);
+            if (!_spimOn) { D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = ''; }
+            renderStatus();
+        } catch (e) { toast(`SPIM view toggle failed (${e.status || e.message})`); }
+        finally { D['op-spim-toggle'].disabled = false; }
     }
     let _lsTimer = null;
     function postLsParams() {
         if (_lsTimer) clearTimeout(_lsTimer);
-        _lsTimer = setTimeout(() => {
-            postJSON('/api/devices/lightsheet/live/params',
-                { galvo: _galvo, piezo: _piezo, exposure: 20, side: 'A' }).catch(() => {});
-        }, 120);
+        _lsTimer = setTimeout(() => { postJSON('/api/devices/lightsheet/live/params', { galvo: _galvo, piezo: _piezo, exposure: 20, side: 'A' }).catch(() => {}); }, 120);
     }
-    function nudgeGalvo(d) { _galvo = Math.max(-5, Math.min(5, _galvo + d)); _gvVal.textContent = _galvo.toFixed(1); postLsParams(); }
-    function nudgePiezo(d) { _piezo = Math.max(0, Math.min(200, _piezo + d)); _pzVal.textContent = _piezo.toFixed(0); postLsParams(); }
+    function nudgeGalvo(d) { _galvo = Math.max(-5, Math.min(5, _galvo + d)); D['op-gv'].textContent = _galvo.toFixed(1); postLsParams(); }
+    function nudgePiezo(d) { _piezo = Math.max(0, Math.min(200, _piezo + d)); D['op-pz'].textContent = _piezo.toFixed(0); postLsParams(); }
     async function toggleLed() {
         _ledOn = !_ledOn;
-        _ledBtn.classList.toggle('op-btn-on', _ledOn); _ledBtn.setAttribute('aria-pressed', _ledOn ? 'true' : 'false');
-        try { await postJSON('/api/devices/led/set', { state: _ledOn ? 'Open' : 'Closed' }); }
-        catch (err) { toast(`LED failed (${err.status || err.message})`); }
+        D['op-led'].classList.toggle('op-btn-toggle', true); D['op-led'].setAttribute('aria-pressed', _ledOn ? 'true' : 'false');
+        D['op-led'].classList.toggle('op-btn-on', _ledOn);
+        try { await postJSON('/api/devices/led/set', { state: _ledOn ? 'Open' : 'Closed' }); } catch (e) { toast(`LED failed (${e.status || e.message})`); }
+        renderStatus();
+    }
+    async function forceLedOff() {
+        if (!_ledOn) return;
+        _ledOn = false; D['op-led'].setAttribute('aria-pressed', 'false'); D['op-led'].classList.remove('op-btn-on');
+        try { await postJSON('/api/devices/led/set', { state: 'Closed' }); } catch (_) {}
+        renderStatus();
+    }
+    function markInFocus() {
+        if (!_selected) return;
+        advanceState(_selected, 'focused'); forceLedOff(); setStep('b4');
+        toast(`Embryo ${labelFor(_embryos.find(e => e.id === _selected))} in focus`);
+    }
+
+    // ── B4 acquire ─────────────────────────────────────────────────────────
+    async function acquireSelected() {
+        if (!_selected || _states[_selected] !== 'focused') { toast('Focus the embryo first'); return; }
+        D['op-acquire'].disabled = true; D['op-acquire'].textContent = 'Acquiring…'; _acquiring = true; renderStatus();
+        try {
+            await postJSON('/api/devices/acquire/volume', { num_slices: 50, exposure_ms: 10.0 });
+            advanceState(_selected, 'imaged'); setStep('b5');
+            toast('Volume acquired');
+        } catch (e) { toast(`Acquire failed (${e.status || e.message})`); }
+        finally { _acquiring = false; D['op-acquire'].disabled = false; D['op-acquire'].textContent = 'Acquire volume'; await forceLedOff(); renderStatus(); }
+    }
+
+    // ── B5 retract & advance ───────────────────────────────────────────────
+    async function retractAndAdvance() {
+        D['op-retract'].disabled = true;
+        try {
+            await postJSON('/api/devices/spim/fdrive/nudge', { delta: 100 }).catch(() => {});
+            _headLowered = false; _fdFloor = null;
+            const next = _embryos.find(e => _states[e.id] !== 'imaged');
+            if (next) { selectEmbryo(next.id); toast(`Next: embryo ${labelFor(next)}`); }
+            else { _selected = null; _step = null; renderStep(); toast('All embryos imaged'); }
+        } finally { D['op-retract'].disabled = false; }
+    }
+
+    // ── embryo SSOT ────────────────────────────────────────────────────────
+    function onEmbryosUpdate(p) {
+        const wasEmpty = _embryos.length === 0;
+        _embryos = (p && Array.isArray(p.embryos)) ? p.embryos : [];
+        const ids = new Set(_embryos.map(e => e.id));
+        Object.keys(_states).forEach(id => { if (!ids.has(id)) delete _states[id]; });
+        _embryos.forEach(e => { if (!_states[e.id]) _states[e.id] = 'marked'; });
+        if (_selected && !ids.has(_selected)) { _selected = null; _step = null; }
+        // After the first marking confirm, flow into Phase B on the first embryo.
+        if (wasEmpty && _embryos.length && !_selected && !_marking) selectEmbryo(_embryos[0].id);
+        else renderStep();
     }
 
-    // ---- Wiring / lifecycle --------------------------------------------
+    // ── lifecycle ──────────────────────────────────────────────────────────
+    function surveyMore() { _selected = null; _step = null; if (_marking) exitMarking(); renderStep(); }
+
     function wire() {
         if (_wired) return; _wired = true;
         cacheDom();
-        _camToggle.addEventListener('click', toggleCamera);
-        _markCanvas.addEventListener('click', onCanvasClick);
-        _detectBtn.addEventListener('click', runDetect);
-        _confirmBtn.addEventListener('click', confirmMarks);
-        _clearBtn.addEventListener('click', () => { _markers = []; drawMarkers(); updateMarkActions(); });
-        _bzNudge.addEventListener('click', e => { const b = e.target.closest('[data-bz]'); if (b) nudgeBottomZ(Number(b.dataset.bz)); });
-        _fdNudge.addEventListener('click', e => { const b = e.target.closest('[data-fd]'); if (b) nudgeFdrive(Number(b.dataset.fd)); });
-        _centerBtn.addEventListener('click', centerOnSelected);
-        _acquireBtn.addEventListener('click', acquireSelected);
-        _spimToggle.addEventListener('click', toggleSpim);
-        _ledBtn.addEventListener('click', toggleLed);
+        D['op-cam-toggle'].addEventListener('click', toggleCamera);
+        D['op-mark-canvas'].addEventListener('click', onCanvasClick);
+        D['op-bz-nudge'].addEventListener('click', e => { const b = e.target.closest('[data-bz]'); if (b) nudgeBottomZ(Number(b.dataset.bz)); });
+        D['op-tomark'].addEventListener('click', () => { if (enterMarking([])) renderStep(); });
+        D['op-detect'].addEventListener('click', runDetect);
+        D['op-confirm'].addEventListener('click', confirmMarks);
+        D['op-clear'].addEventListener('click', () => { _markers = []; drawMarkers(); updateMarkCount(); });
+        D['op-center'].addEventListener('click', centerOnSelected);
+        D['op-fd-nudge'].addEventListener('click', e => { const b = e.target.closest('[data-fd]'); if (b) nudgeFdrive(Number(b.dataset.fd)); });
+        D['op-tofocus'].addEventListener('click', () => setStep('b3'));
+        D['op-spim-toggle'].addEventListener('click', toggleSpim);
+        D['op-led'].addEventListener('click', toggleLed);
         document.querySelectorAll('[data-gv]').forEach(b => b.addEventListener('click', () => nudgeGalvo(Number(b.dataset.gv))));
         document.querySelectorAll('[data-pz]').forEach(b => b.addEventListener('click', () => nudgePiezo(Number(b.dataset.pz))));
-        window.addEventListener('resize', () => { if (_marking) drawMarkers(); });
+        D['op-infocus'].addEventListener('click', markInFocus);
+        D['op-acquire'].addEventListener('click', acquireSelected);
+        D['op-retract'].addEventListener('click', retractAndAdvance);
+        D['op-survey-btn'].addEventListener('click', surveyMore);
+        window.addEventListener('resize', () => { if (_active) drawOverlay(effectiveStep()); });
 
         if (typeof ClientEventBus !== 'undefined') {
             ClientEventBus.on('BOTTOM_CAMERA_FRAME', onBottomFrame);
             ClientEventBus.on('LIGHTSHEET_FRAME', onLightsheetFrame);
             ClientEventBus.on('EMBRYOS_UPDATE', onEmbryosUpdate);
-            ClientEventBus.on('EMBRYO_DETECTED', () => {});  // bulk EMBRYOS_UPDATE covers it
             ClientEventBus.on('DEVICE_STATE_UPDATE', p => {
-                const pos = p && p.positions;
-                if (pos && pos.xy_stage && Array.isArray(pos.xy_stage)) _lastXY = { X: pos.xy_stage[0], Y: pos.xy_stage[1] };
+                const pos = p && p.positions; if (!pos) return;
+                if (pos.xy_stage && Array.isArray(pos.xy_stage)) { _lastXY = { X: pos.xy_stage[0], Y: pos.xy_stage[1] }; if (_active) renderMiniMap(); }
             });
         }
     }
 
     async function activate() {
         wire();
-        if (_active) return;
-        _active = true;
-        // Bootstrap the canonical list (mid-session open).
-        try { const s = await getJSON('/api/embryos/current'); onEmbryosUpdate(s); } catch (_) {}
-        refreshZReadouts();
+        if (_active) return; _active = true;
+        try { const s = await getJSON('/api/embryos/current'); onEmbryosUpdate(s); } catch (_) { renderStep(); }
+        try { const b = await getJSON('/api/devices/stage/bottom_z'); if (b.position != null) D['op-bz-pos'].textContent = Number(b.position).toFixed(1); } catch (_) {}
+        try { const f = await getJSON('/api/devices/spim/fdrive'); if (f.position != null) { _fdPos = f.position; D['op-fd-pos'].textContent = Number(f.position).toFixed(1); } if (f.distance_to_floor != null) { _fdFloor = f.distance_to_floor; D['op-fd-floor'].textContent = Number(f.distance_to_floor).toFixed(0); } } catch (_) {}
+        renderStep();
     }
     function deactivate() {
-        if (!_active) return;
-        _active = false;
-        // Stop streams so they don't run while the view is hidden.
-        if (_camOn) { fetch('/api/devices/bottom_camera/stream/stop', { method: 'POST' }).catch(() => {}); applyCameraState(false); }
-        if (_spimOn) { fetch('/api/devices/lightsheet/live/stop', { method: 'POST' }).catch(() => {}); _spimOn = false; _spimToggle.textContent = 'Start view'; _spimToggle.classList.remove('op-btn-on'); }
+        if (!_active) return; _active = false;
+        if (_camOn) { fetch('/api/devices/bottom_camera/stream/stop', { method: 'POST' }).catch(() => {}); applyCam(false); }
+        if (_spimOn) { fetch('/api/devices/lightsheet/live/stop', { method: 'POST' }).catch(() => {}); _spimOn = false; D['op-spim-toggle'].textContent = 'Start view'; D['op-spim-toggle'].classList.remove('op-btn-on'); }
+        forceLedOff();
         if (_marking) exitMarking();
     }
 
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index a864a027..171ed1a2 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -489,91 +489,127 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
             <div class="devices-view devices-view-operate" id="devices-view-operate" style="display:none">
               <div class="operate">
 
-                <!-- ZONE 1 — SURVEY & MARK -->
-                <section class="op-zone op-zone-survey">
-                  <header class="op-zone-head"><span class="op-step">1</span> Survey &amp; mark</header>
-                  <div class="op-survey-body">
-                    <div class="op-cam" id="op-cam-stage">
-                      <img class="op-cam-img" id="op-cam-img" alt="bottom camera live frame">
-                      <canvas class="op-mark-canvas" id="op-mark-canvas"></canvas>
-                      <div class="op-cam-ph" id="op-cam-ph">Camera off</div>
-                    </div>
-                    <div class="op-rail">
-                      <button class="op-btn" id="op-cam-toggle" type="button">Start camera</button>
-                      <div class="op-field">
-                        <label class="op-label">Bottom focus Z</label>
-                        <div class="op-readout"><b id="op-bz-pos">—</b> µm<span class="op-sep">·</span>focus <b id="op-bz-score">—</b></div>
-                        <div class="op-nudge" id="op-bz-nudge">
-                          <button class="op-nbtn" data-bz="-10" type="button">−10</button>
-                          <button class="op-nbtn" data-bz="-1" type="button">−1</button>
-                          <button class="op-nbtn" data-bz="1" type="button">+1</button>
-                          <button class="op-nbtn" data-bz="10" type="button">+10</button>
-                        </div>
-                      </div>
-                      <div class="op-field">
-                        <label class="op-label">Mark embryos</label>
-                        <div class="op-mark-actions">
-                          <button class="op-btn" id="op-detect" type="button">Detect</button>
-                          <button class="op-btn op-btn-primary" id="op-confirm" type="button" disabled>Confirm <span id="op-mark-count">(0)</span></button>
-                        </div>
-                        <button class="op-btn op-btn-ghost" id="op-clear" type="button" disabled>Clear marks</button>
-                        <div class="op-hint" id="op-mark-hint">Start the camera, then Detect — or click the image to mark embryos.</div>
+                <!-- HEADER — stepper ("you are here") + always-on safety status strip -->
+                <header class="op-head">
+                  <div class="op-stepper" id="op-stepper">
+                    <span class="op-phase">Survey</span>
+                    <span class="op-node" data-node="a1">Focus</span>
+                    <span class="op-arrow">→</span>
+                    <span class="op-node" data-node="a2">Mark</span>
+                    <span class="op-phase-div"></span>
+                    <span class="op-phase">Acquire<b id="op-loop-emb"></b></span>
+                    <span class="op-node" data-node="b1">Center</span>
+                    <span class="op-arrow">→</span>
+                    <span class="op-node" data-node="b2">Lower</span>
+                    <span class="op-arrow">→</span>
+                    <span class="op-node" data-node="b3">Focus</span>
+                    <span class="op-arrow">→</span>
+                    <span class="op-node" data-node="b4">Acquire</span>
+                  </div>
+                  <div class="op-status">
+                    <span class="op-stat"><i>HEAD</i><b id="op-st-head">—</b></span>
+                    <span class="op-stat"><i>FLOOR</i><b id="op-st-floor">—</b></span>
+                    <span class="op-stat" id="op-st-led-wrap"><i>LED</i><b id="op-st-led">OFF</b></span>
+                    <span class="op-stat" id="op-st-laser-wrap"><i>LASER</i><b id="op-st-laser">OFF</b></span>
+                    <span class="op-stat"><i>CAM</i><b id="op-st-cam">—</b></span>
+                  </div>
+                </header>
+
+                <!-- LEFT SPINE — dish mini-map + the embryo worklist ("the plan") -->
+                <aside class="op-spine">
+                  <div class="op-minimap-wrap">
+                    <svg class="op-minimap" id="op-minimap" viewBox="0 0 100 100" preserveAspectRatio="xMidYMid meet" aria-hidden="true"></svg>
+                  </div>
+                  <div class="op-board-head"><span>The plan</span><span class="op-board-count" id="op-board-count">0 / 0 imaged</span></div>
+                  <div class="op-board" id="op-board"><div class="op-empty">No embryos yet</div></div>
+                  <button class="op-btn op-btn-ghost op-survey-btn" id="op-survey-btn" type="button">＋ Survey / mark more</button>
+                </aside>
+
+                <!-- CENTER — the single live viewport; source + overlays swap per step -->
+                <div class="op-stage">
+                  <div class="op-badge" id="op-badge">Bottom cam</div>
+                  <div class="op-cam" id="op-cam-stage">
+                    <img class="op-cam-img" id="op-cam-img" alt="live frame">
+                    <canvas class="op-mark-canvas" id="op-mark-canvas"></canvas>
+                    <div class="op-cam-ph" id="op-cam-ph">Camera off</div>
+                  </div>
+                </div>
+
+                <!-- RIGHT RAIL — only the active step's control group renders -->
+                <div class="op-rail" id="op-rail" data-active="a1">
+                  <div class="op-rail-head" id="op-rail-head">Focus the bottom objective</div>
+
+                  <div class="op-group" data-step="a1">
+                    <button class="op-btn" id="op-cam-toggle" type="button">Start camera</button>
+                    <div class="op-field">
+                      <label class="op-label">Bottom focus Z <span class="op-cap" id="op-bz-pos">—</span><span class="op-cap"> µm</span></label>
+                      <div class="op-hud-line">focus score <b id="op-bz-score">—</b></div>
+                      <div class="op-nudge" id="op-bz-nudge">
+                        <button class="op-nbtn" data-bz="-10" type="button">−10</button>
+                        <button class="op-nbtn" data-bz="-1" type="button">−1</button>
+                        <button class="op-nbtn" data-bz="1" type="button">+1</button>
+                        <button class="op-nbtn" data-bz="10" type="button">+10</button>
                       </div>
                     </div>
+                    <div class="op-hint">Sharpen the embryos, then mark them.</div>
+                    <button class="op-btn op-btn-primary" id="op-tomark" type="button">Mark embryos →</button>
                   </div>
-                </section>
 
-                <!-- ZONE 2 — EMBRYOS (single source of truth) -->
-                <section class="op-zone op-zone-embryos">
-                  <header class="op-zone-head"><span class="op-step">2</span> Embryos <span class="op-count" id="op-embryo-count"></span></header>
-                  <div class="op-embryo-list" id="op-embryo-list">
-                    <div class="op-empty">No embryos yet — mark some in step 1.</div>
+                  <div class="op-group" data-step="a2">
+                    <button class="op-btn" id="op-detect" type="button">Detect (SAM)</button>
+                    <div class="op-hint">Click the frame to add · click a marker to remove.</div>
+                    <button class="op-btn op-btn-primary" id="op-confirm" type="button" disabled>Confirm <span id="op-mark-count">(0)</span></button>
+                    <button class="op-btn op-btn-ghost" id="op-clear" type="button" disabled>Clear marks</button>
                   </div>
-                </section>
-
-                <!-- ZONE 3 — ACQUIRE (selected embryo) -->
-                <section class="op-zone op-zone-acquire">
-                  <header class="op-zone-head"><span class="op-step">3</span> Acquire <span class="op-sel" id="op-sel-label">— select an embryo</span></header>
-                  <div class="op-acquire-body">
-                    <div class="op-cam op-cam-spim" id="op-spim-stage">
-                      <img class="op-cam-img" id="op-spim-img" alt="lightsheet live frame">
-                      <div class="op-cam-ph" id="op-spim-ph">SPIM view off</div>
-                    </div>
-                    <div class="op-rail">
-                      <button class="op-btn op-btn-primary" id="op-center" type="button" disabled>Center stage on embryo</button>
-                      <div class="op-field">
-                        <label class="op-label">SPIM head — F-drive</label>
-                        <div class="op-readout"><b id="op-fd-pos">—</b> µm<span class="op-sep">·</span>floor <b id="op-fd-floor">—</b></div>
-                        <div class="op-nudge" id="op-fd-nudge">
-                          <button class="op-nbtn" data-fd="-100" type="button">−100</button>
-                          <button class="op-nbtn" data-fd="-10" type="button">−10</button>
-                          <button class="op-nbtn" data-fd="10" type="button">+10</button>
-                          <button class="op-nbtn" data-fd="100" type="button">+100</button>
-                        </div>
-                      </div>
-                      <div class="op-field">
-                        <label class="op-label">SPIM focus</label>
-                        <div class="op-spim-controls">
-                          <button class="op-btn" id="op-spim-toggle" type="button">Start view</button>
-                          <button class="op-btn op-btn-toggle" id="op-led" type="button" aria-pressed="false">LED</button>
-                        </div>
-                        <div class="op-micro">
-                          <span>Galvo</span>
-                          <button class="op-nbtn" data-gv="-0.2" type="button">−</button>
-                          <b id="op-gv">0.0</b>
-                          <button class="op-nbtn" data-gv="0.2" type="button">+</button>
-                          <span class="op-sep">·</span>
-                          <span>Piezo</span>
-                          <button class="op-nbtn" data-pz="-1" type="button">−</button>
-                          <b id="op-pz">50</b>
-                          <button class="op-nbtn" data-pz="1" type="button">+</button>
-                        </div>
-                        <div class="op-readout">SPIM focus <b id="op-spim-score">—</b></div>
+
+                  <div class="op-group" data-step="b1">
+                    <button class="op-btn op-btn-primary" id="op-center" type="button">Center stage on embryo</button>
+                    <div class="op-hint" id="op-center-hint">Drive the embryo to the reticle (FOV centre).</div>
+                  </div>
+
+                  <div class="op-group" data-step="b2">
+                    <div class="op-field">
+                      <label class="op-label">SPIM head · F-drive <span class="op-cap" id="op-fd-pos">—</span><span class="op-cap"> µm</span></label>
+                      <div class="op-hud-line">distance to floor <b id="op-fd-floor">—</b> µm</div>
+                      <div class="op-nudge op-nudge-2" id="op-fd-nudge">
+                        <button class="op-nbtn" data-fd="-100" id="op-fd-d100" type="button">▼ 100</button>
+                        <button class="op-nbtn" data-fd="-10" id="op-fd-d10" type="button">▼ 10</button>
+                        <button class="op-nbtn" data-fd="10" type="button">▲ 10</button>
+                        <button class="op-nbtn" data-fd="100" type="button">▲ 100</button>
                       </div>
-                      <button class="op-btn op-btn-primary" id="op-acquire" type="button" disabled>Acquire volume</button>
                     </div>
+                    <div class="op-hint">▼ lowers toward the sample. Watch the floor gauge.</div>
+                    <button class="op-btn op-btn-primary" id="op-tofocus" type="button">Focus SPIM →</button>
+                  </div>
+
+                  <div class="op-group" data-step="b3">
+                    <div class="op-spim-controls">
+                      <button class="op-btn" id="op-spim-toggle" type="button">Start view</button>
+                      <button class="op-btn op-btn-toggle" id="op-led" type="button" aria-pressed="false">LED</button>
+                    </div>
+                    <div class="op-micro">
+                      <span>Galvo</span>
+                      <button class="op-nbtn" data-gv="-0.2" type="button">−</button><b id="op-gv">0.0</b><button class="op-nbtn" data-gv="0.2" type="button">+</button>
+                      <span class="op-sep">·</span>
+                      <span>Piezo</span>
+                      <button class="op-nbtn" data-pz="-1" type="button">−</button><b id="op-pz">50</b><button class="op-nbtn" data-pz="1" type="button">+</button>
+                    </div>
+                    <div class="op-hud-line">focus score <b id="op-spim-score">—</b></div>
+                    <div class="op-hint">Peak the focus score, then mark in focus.</div>
+                    <button class="op-btn op-btn-primary" id="op-infocus" type="button">Mark in focus →</button>
+                  </div>
+
+                  <div class="op-group" data-step="b4">
+                    <div class="op-cap">50 slices · 10 ms</div>
+                    <button class="op-btn op-btn-primary" id="op-acquire" type="button">Acquire volume</button>
+                    <div class="op-hint">Captures the volume for this embryo.</div>
                   </div>
-                </section>
+
+                  <div class="op-group" data-step="b5">
+                    <div class="op-hint">Imaged ✓ — raise the head to safe travel, then advance.</div>
+                    <button class="op-btn op-btn-primary" id="op-retract" type="button">Raise head ▲ &amp; next</button>
+                  </div>
+                </div>
 
               </div>
             </div>

From 522e25bbe8f9a5cdf58103ca35de2ca8e0392fde Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 21:17:38 +0530
Subject: [PATCH 275/314] =?UTF-8?q?refactor(devices):=20remove=20duplicate?=
 =?UTF-8?q?=20Map-view=20Detect=20panel=20=E2=80=94=20Detect=20lives=20onl?=
 =?UTF-8?q?y=20in=20Operate?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Finishes the migration: the Map view keeps its read-only embryo dots; the
Detect / mark / per-embryo Center panel (an interim home) is removed now that the
Operate view owns that workflow. Drops the detect panel markup, its OperateManager-
duplicating JS in devices.js (renderEmbryoListPanel/runDetection/centerOnEmbryo/
removeEmbryo/setupDetectWiring), and the orphaned CSS; keeps the top-right rail +
XY readout.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/css/main.css  | 138 +---------------------
 gently/ui/web/static/js/devices.js | 182 +----------------------------
 gently/ui/web/templates/index.html |  17 ---
 3 files changed, 2 insertions(+), 335 deletions(-)

diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index f4fcdccc..ba2339d0 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -10220,7 +10220,7 @@ body.modal-open {
     border-color: var(--map-accent);
 }
 
-/* ---- Top-right rail: XY readout stacked above the detect panel ---- */
+/* ---- Top-right rail: the XY stage readout (Detect/mark moved to Operate) ---- */
 .devices-map-rail {
     position: absolute;
     top: 0.85rem;
@@ -10240,142 +10240,6 @@ body.modal-open {
     min-width: 0;
 }
 
-/* ---- Detected-embryo list panel (Map view, standalone detect→centre) ---- */
-.devices-detect-panel {
-    width: 100%;
-    display: flex;
-    flex-direction: column;
-    gap: 0.4rem;
-    padding: 0.5rem 0.6rem 0.55rem;
-    background: var(--map-overlay-bg-2);
-    border: 1px solid var(--map-overlay-edge);
-    border-radius: 3px;
-    box-shadow: 0 12px 32px rgba(0,0,0,0.32);
-    -webkit-backdrop-filter: blur(8px);
-    backdrop-filter: blur(8px);
-    font-family: 'Inter Tight', system-ui, sans-serif;
-}
-.devices-detect-head {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    gap: 0.5rem;
-}
-.devices-detect-title {
-    font-size: 0.62rem;
-    font-weight: 600;
-    letter-spacing: 0.18em;
-    text-transform: uppercase;
-    color: var(--map-ink);
-}
-.devices-detect-btn {
-    background: transparent;
-    border: 1px solid var(--map-overlay-edge);
-    color: var(--map-ink);
-    font-family: inherit;
-    font-size: 0.62rem;
-    font-weight: 600;
-    letter-spacing: 0.08em;
-    text-transform: uppercase;
-    padding: 0.18rem 0.6rem;
-    border-radius: 999px;
-    cursor: pointer;
-    transition: background 0.15s, border-color 0.15s, color 0.15s;
-}
-.devices-detect-btn:hover:not(:disabled) {
-    background: rgba(255,255,255,0.06);
-    border-color: var(--map-accent);
-    color: var(--map-accent);
-}
-.devices-detect-btn:disabled { opacity: 0.5; cursor: progress; }
-.devices-detect-list {
-    display: flex;
-    flex-direction: column;
-    gap: 0.25rem;
-    max-height: 220px;
-    overflow-y: auto;
-}
-.devices-detect-empty {
-    font-size: 0.66rem;
-    color: var(--map-ink-mute);
-    padding: 0.35rem 0.1rem;
-    line-height: 1.35;
-}
-.devices-detect-row {
-    display: flex;
-    align-items: center;
-    gap: 0.45rem;
-    padding: 0.28rem 0.3rem;
-    border-radius: 3px;
-    transition: background 0.12s;
-}
-.devices-detect-row:hover { background: rgba(255,255,255,0.05); }
-.devices-detect-dot {
-    flex: 0 0 auto;
-    width: 18px; height: 18px;
-    border-radius: 50%;
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    font-size: 0.6rem;
-    font-weight: 700;
-    color: var(--map-paper);
-    background: var(--map-warm);
-}
-.devices-detect-coord {
-    flex: 1 1 auto;
-    font-size: 0.64rem;
-    font-variant-numeric: tabular-nums;
-    color: var(--map-ink);
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-}
-.devices-detect-center {
-    flex: 0 0 auto;
-    background: transparent;
-    border: 1px solid var(--map-overlay-edge);
-    color: var(--map-ink);
-    font-family: inherit;
-    font-size: 0.58rem;
-    font-weight: 600;
-    letter-spacing: 0.06em;
-    text-transform: uppercase;
-    padding: 0.16rem 0.45rem;
-    border-radius: 999px;
-    cursor: pointer;
-    transition: background 0.15s, border-color 0.15s, color 0.15s;
-}
-.devices-detect-center:hover:not(:disabled) {
-    background: var(--map-accent);
-    border-color: var(--map-accent);
-    color: var(--map-paper);
-}
-.devices-detect-center:disabled { opacity: 0.5; cursor: progress; }
-/* Per-row remove (prune false positives from the canonical list) */
-.devices-detect-remove {
-    flex: 0 0 auto;
-    background: transparent;
-    border: none;
-    color: var(--map-ink-mute);
-    font-family: inherit;
-    font-size: 0.7rem;
-    line-height: 1;
-    padding: 0.18rem 0.25rem;
-    border-radius: 3px;
-    cursor: pointer;
-    transition: color 0.15s, background 0.15s;
-}
-.devices-detect-remove:hover:not(:disabled) {
-    color: var(--map-warm);
-    background: rgba(255,255,255,0.06);
-}
-.devices-detect-remove:disabled { opacity: 0.5; cursor: progress; }
-.devices-detect-foot {
-    font-size: 0.62rem;
-    color: var(--map-ink-mute);
-    padding-top: 0.1rem;
-}
 
 .devices-camera-head-btns {
     display: inline-flex;
diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index e7cb9b1b..ca26dd2b 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -52,14 +52,6 @@ const DevicesManager = (function () {
     // Backspace removes it (with a confirm), Escape clears the selection.
     let _selectedEmbryoId = null;
 
-    // Bottom-camera detection (Map view). Detection registers hits into the
-    // canonical _embryos list (server-side, via the experiment) — there is no
-    // separate detected list. The Embryos card renders _embryos and centres the
-    // stage on each via /api/devices/stage/move. _detecting only gates the
-    // Detect button while a run is in flight.
-    let _detecting = false;
-    let _detectBtn, _detectList;
-
     // Bottom-camera panel DOM + state
     let _camPanel, _camToggle, _camExpand, _camImg, _camPlaceholder, _camLed, _camMeta;
     let _camStage, _camCrosshair, _camCrosshairGroup;
@@ -184,8 +176,6 @@ const DevicesManager = (function () {
         _mapOrigin        = document.getElementById('devices-map-origin');
         _mapAxes          = document.getElementById('devices-map-axes');
         _mapEmbryos       = document.getElementById('devices-map-embryos');
-        _detectBtn        = document.getElementById('devices-detect-btn');
-        _detectList       = document.getElementById('devices-detect-list');
         _mapMarker        = document.getElementById('devices-map-marker');
         _mapMarkerPulse   = document.getElementById('devices-map-marker-pulse');
         _mapMarkerRing    = document.getElementById('devices-map-marker-ring');
@@ -427,7 +417,6 @@ const DevicesManager = (function () {
         } else {
             renderEmbryos();
         }
-        renderEmbryoListPanel();
     }
 
     // =====================================================================
@@ -658,7 +647,7 @@ const DevicesManager = (function () {
     }
 
     function handleEmbryoDetected(payload) {
-        if (_upsertEmbryo(payload)) { renderEmbryos(); renderEmbryoListPanel(); }
+        if (_upsertEmbryo(payload)) renderEmbryos();
     }
 
     function handleStatusChanged(payload) {
@@ -671,7 +660,6 @@ const DevicesManager = (function () {
         if (idx >= 0) {
             _embryos[idx] = Object.assign({}, _embryos[idx], { role: newRole });
             renderEmbryos();
-            renderEmbryoListPanel();
         } else {
             // Embryo we haven't seen yet — refetch to be safe.
             loadEmbryos();
@@ -2452,179 +2440,11 @@ const DevicesManager = (function () {
         scheduleStaleCheck();
     }
 
-    // =====================================================================
-    // Embryo detection + per-embryo stage centring (Map view)
-    // =====================================================================
-    // Single source of truth: the canonical _embryos list (fed by
-    // EMBRYOS_UPDATE / /api/embryos/current). Detect registers hits server-side
-    // into the experiment, which broadcasts EMBRYOS_UPDATE back here — the same
-    // list that imported / timelapse / manually-marked embryos live in. The
-    // panel below renders that one list with a Centre + remove action per row.
-
-    // Render the Embryos card list from _embryos. Called from renderEmbryos()
-    // so the card and the map dots always reflect the same canonical state.
-    function renderEmbryoListPanel() {
-        if (!_detectList) return;
-        _detectList.innerHTML = '';
-        if (!_embryos || !_embryos.length) {
-            const empty = document.createElement('div');
-            empty.className = 'devices-detect-empty';
-            empty.textContent = _detecting
-                ? 'Detecting…'
-                : 'No embryos yet — press Detect';
-            _detectList.appendChild(empty);
-            return;
-        }
-        _embryos.forEach((emb, i) => {
-            const xy = embryoResolvedXY(emb);
-            const row = document.createElement('div');
-            row.className = 'devices-detect-row';
-            row.setAttribute('data-embryo-id', emb.id || '');
-
-            const dot = document.createElement('span');
-            dot.className = 'devices-detect-dot';
-            dot.style.background = _ROLE_COLOR[emb.role] || _ROLE_COLOR.unassigned;
-            dot.textContent = embryoLabelText(emb.id, i);
-            row.appendChild(dot);
-
-            const coord = document.createElement('span');
-            coord.className = 'devices-detect-coord';
-            coord.textContent = xy
-                ? `(${xy.x.toFixed(0)}, ${xy.y.toFixed(0)}) µm`
-                : 'no position';
-            row.appendChild(coord);
-
-            const center = document.createElement('button');
-            center.className = 'devices-detect-center';
-            center.type = 'button';
-            center.textContent = 'Center';
-            center.disabled = !xy;
-            center.addEventListener('click', () => centerOnEmbryo(emb, center));
-            row.appendChild(center);
-
-            const remove = document.createElement('button');
-            remove.className = 'devices-detect-remove';
-            remove.type = 'button';
-            remove.title = 'Remove this embryo';
-            remove.setAttribute('aria-label', 'Remove embryo');
-            remove.textContent = '✕';
-            remove.addEventListener('click', () => removeEmbryo(emb, remove));
-            row.appendChild(remove);
-
-            _detectList.appendChild(row);
-        });
-    }
-
-    async function runDetection() {
-        if (_detecting || !_detectBtn) return;
-        _detecting = true;
-        _detectBtn.disabled = true;
-        _detectBtn.textContent = 'Detecting…';
-        renderEmbryoListPanel();
-        try {
-            const res = await fetch('/api/devices/detect_embryos', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({}),
-            });
-            if (!res.ok) {
-                const detail = await res.text();
-                console.error('Embryo detection failed:', detail);
-                if (typeof showGentlyToast === 'function') {
-                    showGentlyToast(`Detection failed (${res.status})`);
-                }
-                return;
-            }
-            const data = await res.json();
-            // The canonical list refreshes via EMBRYOS_UPDATE; just report.
-            if (typeof showGentlyToast === 'function') {
-                const n = Array.isArray(data.registered) ? data.registered.length : 0;
-                showGentlyToast(`Detected ${n} embryo${n === 1 ? '' : 's'}`);
-            }
-        } catch (err) {
-            console.error('Detection request failed:', err);
-            if (typeof showGentlyToast === 'function') {
-                showGentlyToast(`Detection error: ${err.message}`);
-            }
-        } finally {
-            _detecting = false;
-            _detectBtn.disabled = false;
-            _detectBtn.textContent = 'Detect';
-            renderEmbryoListPanel();
-        }
-    }
-
-    async function centerOnEmbryo(emb, btn) {
-        const xy = emb ? embryoResolvedXY(emb) : null;
-        if (!xy) return;
-        const num = embryoNumberFor(emb);
-        if (btn) { btn.disabled = true; btn.textContent = '…'; }
-        try {
-            const res = await fetch('/api/devices/stage/move', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ x: xy.x, y: xy.y }),
-            });
-            if (!res.ok) {
-                console.error('Centre failed:', await res.text());
-                if (typeof showGentlyToast === 'function') {
-                    showGentlyToast(`Centre failed (${res.status})`);
-                }
-                return;
-            }
-            if (typeof showGentlyToast === 'function') {
-                showGentlyToast(
-                    `Centred on embryo ${num} — (${xy.x.toFixed(0)}, ${xy.y.toFixed(0)}) µm`
-                );
-            }
-        } catch (err) {
-            console.error('Centre request failed:', err);
-            if (typeof showGentlyToast === 'function') {
-                showGentlyToast(`Centre error: ${err.message}`);
-            }
-        } finally {
-            if (btn) { btn.disabled = false; btn.textContent = 'Center'; }
-        }
-    }
-
-    async function removeEmbryo(emb, btn) {
-        if (!emb || !emb.id) return;
-        const num = embryoNumberFor(emb);
-        if (!window.confirm(`Remove embryo ${num}?`)) return;
-        if (btn) btn.disabled = true;
-        try {
-            const res = await fetch(`/api/embryos/${encodeURIComponent(emb.id)}`, {
-                method: 'DELETE',
-            });
-            if (!res.ok) {
-                console.error('Remove failed:', await res.text());
-                if (typeof showGentlyToast === 'function') {
-                    showGentlyToast(`Remove failed (${res.status})`);
-                }
-                if (btn) btn.disabled = false;
-                return;
-            }
-            // EMBRYOS_UPDATE refreshes the list + map dots.
-        } catch (err) {
-            console.error('Remove request failed:', err);
-            if (typeof showGentlyToast === 'function') {
-                showGentlyToast(`Remove error: ${err.message}`);
-            }
-            if (btn) btn.disabled = false;
-        }
-    }
-
-    function setupDetectWiring() {
-        if (_detectBtn) _detectBtn.addEventListener('click', runDetection);
-        renderEmbryoListPanel();
-    }
-
     function init() {
         cacheDom();
         setupViewSwitcher();
         setupCameraWiring();
         setupManualWiring();
-        setupDetectWiring();
         setupRoomLight();
         setupTemperature();
         loadCoverslip();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 171ed1a2..e3d41b6d 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -686,23 +686,6 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                             </div>
                         </div>
                     </div>
-
-                    <!-- Detected-embryo list + bottom-cam detect trigger.
-                         Standalone manual workflow: run SAM detection on the
-                         bottom camera, then centre the stage on each embryo. -->
-                    <div class="devices-detect-panel" id="devices-detect-panel">
-                        <div class="devices-detect-head">
-                            <span class="devices-detect-title">Embryos</span>
-                            <button class="devices-detect-btn" id="devices-detect-btn" type="button"
-                                    title="Detect embryos on the bottom camera">Detect</button>
-                        </div>
-                        <div class="devices-detect-list" id="devices-detect-list">
-                            <div class="devices-detect-empty" id="devices-detect-empty">
-                                No embryos yet — press Detect
-                            </div>
-                        </div>
-                        <div class="devices-detect-foot" id="devices-detect-foot" hidden></div>
-                    </div>
                     </div>
 
                     <!-- BOTTOM LEFT: scale bar -->

From 7bd39ceb2ba0e28c9f9c24de3c6ec5d6aaaa3aac Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 22:46:08 +0530
Subject: [PATCH 276/314] =?UTF-8?q?docs(spec):=20Operate=20=E2=86=92=20tac?=
 =?UTF-8?q?tics/timelapse=20integration=20design=20(Phase=20C=20Run)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Expert Opus workflow study + synthesis. Decisions: build all 3 phases; adaptive
default monitoring = idle; live run monitored in-Operate (rail flips to run-spine).
Tactics are the unifying object; new keystone = a deterministic Tactic Executor
(first caller of resolve_scope_embryos).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 ...6-30-operate-tactics-integration-design.md | 130 ++++++++++++++++++
 1 file changed, 130 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-06-30-operate-tactics-integration-design.md

diff --git a/docs/superpowers/specs/2026-06-30-operate-tactics-integration-design.md b/docs/superpowers/specs/2026-06-30-operate-tactics-integration-design.md
new file mode 100644
index 00000000..0b950d34
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-30-operate-tactics-integration-design.md
@@ -0,0 +1,130 @@
+# Operate → Tactics/Timelapse Integration ("Phase C: Run") — Design
+
+Date: 2026-06-30
+Status: Approved (build all 3 phases)
+Branch: feature/temperature-operations-all
+Source: Opus expert workflow (tactics + timelapse + agent/resolution + UI study → 3 candidates → synthesis)
+
+## Problem
+
+The Operate view dead-ends: `confirmMarks()` registers positions-only embryos
+(role `unassigned`) into `experiment.embryos` (the SSOT), and `onEmbryosUpdate`
+auto-dives into the manual per-embryo loop. There is no path from "embryos
+marked" to the agentic timelapse or to a tactic/plan.
+
+Underneath, all four imaging surfaces (Operate manual loop, Manual-view timelapse
+form, agent tools, Operations spine) already share **one engine**
+(`TimelapseOrchestrator`) and **one language** (the per-session *Operation Plan*
+of **tactics**). Operate is wired to none of them. `resolve_scope_embryos`
+(role_scope.py) — the scope→embryos resolver — has zero callers; it was built for
+exactly this hand-off.
+
+## Decisions (user)
+
+- **Build all three phases** (not just the first slice).
+- **Adaptive timelapse default monitoring mode = `idle`** (pure fixed-cadence;
+  operator opts into expression/pre-terminal monitoring explicitly).
+- **Live run is monitored in-Operate** (the rail flips to a compact read-only
+  run-spine), with a deep-link to the Operations tab.
+
+## Design — Phase C "Run" on the Operator Spine
+
+Stepper gains a third node: **① Focus → ② Mark → ③ Run.** After Confirm, instead
+of auto-diving into the manual loop, the stepper advances to ③ Run and the right
+rail shows a **Run chooser**. The **tactic** is the single unifying object: every
+run mode emits exactly one tactic scoped to the marked set
+(`scope.mode='embryos', embryo_ids=[marked]`).
+
+| Mode | Behavior | Tactic kind |
+|---|---|---|
+| **A — Manual one-by-one** | the existing Phase-B b1–b5 loop, now reached from the chooser | `oneshot` (cosmetic; keeps the spine coherent) |
+| **B — Adaptive timelapse** | inline form: interval, stop condition, monitoring_mode (default **idle**); reuses `/api/devices/timelapse/start` with explicit `embryo_ids=[marked]` | `standing_timelapse` (+ optional `reactive_monitor` layered on) |
+| **C1 — From library** | apply a saved tactic, scope re-pointed to the marked set | template's kind, via `apply_tactic` |
+| **C2 — Continue a plan** | resume_plan candidate → `execute_plan_item(item_ref, embryo_ids=[marked])` + `seed_operation_plan_from_plan_item` | tactics seeded from `ImagingSpec.tactics` |
+| **C3 — Hand to agent** | open AgentChat preloaded with the roster; agent authors + starts the plan | agent-authored via `declare_operation_plan` |
+
+**Running:** the rail flips to a compact read-only **run-spine** (reuse
+`experiment-overview.js` `_renderOpsTactic`/`_renderOperationSpine`): state-colored
+tactic cards + live readouts + **Pause/Stop** (`pause_timelapse`/`stop_timelapse`)
++ **Open in Operations** deep-link. Optional `set_autonomy('ask'|'auto')`.
+
+**Roles wrinkle (load-bearing):** marking stays positions-only, but
+`expression_monitoring` rules scope to `role=='test'` (subject) — so role-scoped
+monitoring matches zero just-marked embryos unless roles are set. The Run chooser
+shows a **role chip strip** (all marked default to **Subject**, flip any to
+**Reference**); choosing a non-manual mode applies roles via a new thin
+`POST /api/embryos/roles`. Roles are assigned **at Run, not at marking** —
+consistent with the "marking is positions-only" rule.
+
+## Keystone new component: the Tactic Executor
+
+`gently/app/orchestration/tactic_executor.py` —
+`execute_tactic(session, tactic)`: `resolve_scope_embryos(scope, roster)` →
+dispatch by `kind` to `orchestrator.start` / `enable_monitoring_mode` /
+`queue_burst` (later `acquire_volume` / temp protocols), threading `tactic_id` →
+`transition_tactic('active')` + merge live binds. This makes the tactics language
+*executable* (not just descriptive) and is `resolve_scope_embryos`'s first caller.
+It centralizes the `kind`→tool mapping the agent also uses (no duplication).
+
+## Integration points (verified code seams)
+
+- `operate.js` `onEmbryosUpdate` — stop auto-selecting embryo 1; on first confirm
+  advance stepper to ③ Run + render the chooser.
+- `operate.js` `renderStep` single-driver — host Phase C chooser + live run-spine
+  as new render branches (`data-active='c0'` / running) without disturbing a1/b*.
+- `POST /api/devices/embryos/confirm` (`data.py`) — unchanged (positions-only SSOT).
+- `POST /api/devices/timelapse/start` (`data.py`) — Mode B reuses verbatim with
+  `embryo_ids=[marked]`; Phase 2 ADDS tactic seeding (closes the `data.py:~1004`
+  plan-auto-link TODO). `volume_geometry` stays NOT forwarded (RIG-DEFERRED).
+- `TimelapseOrchestrator.start/enable_monitoring_mode/queue_burst` — the engine
+  the executor dispatches into; holds marked `EmbryoState` refs (zero copy).
+- `resolve_scope_embryos` (role_scope.py) — Tactic Executor is its first caller.
+- `start_adaptive_timelapse` (timelapse_tools.py) — add `tactic_id` for lifecycle
+  symmetry (the other start/stop tools already have it).
+- `OperationPlanUpdater` — already maps BURST_COMPLETE→done,
+  EMBRYO_CADENCE_CHANGED/TRIGGER_FIRED→bind; drives the run-spine once tactics
+  carry `tactic_id`.
+- resolution dispatch (`bridge._dispatch_resolution_pick`) + `execute_plan_item`
+  + `seed_operation_plan_from_plan_item` — Modes C2/C3 + session guard.
+- `experiment-overview.js` `_renderOperationSpine`/`_renderOpsTactic` — reused for
+  the in-Operate run-spine.
+- `AgentChat.togglePanel`/`runCommand` — Mode C3.
+
+## New backend
+
+1. **Tactic Executor** (`gently/app/orchestration/tactic_executor.py`) — the keystone (above) + unit tests.
+2. **`POST /api/embryos/roles`** (thin) — reuse `assign_embryo_roles` internals → set `EmbryoState.role` + fire EMBRYOS_UPDATE. Default marked→subject mandatory.
+3. **Tactic seeding on `/api/devices/timelapse/start`** — declare+seed `standing_timelapse` (+ `reactive_monitor`) and transition active (closes the TODO). Additive, minimal, idempotent.
+4. **`tactic_id` on `start_adaptive_timelapse`** — lifecycle symmetry.
+5. **Tactic structure schema extension** (`operation_plan_tools._validate_tactics`) — add `stop_condition`/`condition_value`/`monitoring_mode`/`interval` to `standing_timelapse`/`reactive_monitor` so a tactic is self-describing for the executor.
+6. **Session guard** — ensure a live session/orchestrator before Phase C runs (orchestrator is None without one); reuse `should_enter_resolution`/bootstrap.
+
+## Phasing
+
+- **Phase 1 (cheap slice):** Operate Phase C scaffold (③ Run node, stop auto-dive,
+  Run chooser) + **Mode B** (reuses `/timelapse/start`, no new backend) + thin
+  `POST /api/embryos/roles` + role chip strip + in-Operate run-spine. Working
+  marking→adaptive-timelapse hand-off.
+- **Phase 2 (tactics integrity):** tactic seeding on `/timelapse/start`;
+  `tactic_id` on `start_adaptive_timelapse`; tactic structure schema extension;
+  Mode A `oneshot`.
+- **Phase 3 (keystone + breadth):** Tactic Executor (+ tests) powering Mode C1
+  (library); Mode C2 (continue a plan); Mode C3 (hand to agent); `set_autonomy`
+  in the run-spine.
+
+## Testing
+
+- Backend (TDD): Tactic Executor (scope resolution + kind dispatch, mocked
+  orchestrator); roles route; schema validator extension.
+- Frontend: shim + Chrome MCP — drive mark→Confirm→Run chooser→role assign→Mode B
+  start→run-spine; verify stepper/chooser/run-spine; UI audit.
+- Adversarial code-review workflow over the full diff before merge.
+
+## Rig-only / honesty flags
+
+Real stage motion + acquisition stay RIG-DEFERRED (orchestrator calls
+`client.acquire_volume` directly; "Bluesky" framing is aspirational).
+`volume_geometry` not forwarded by `/timelapse/start`. The `oneshot` manual tactic
+is cosmetic (no orchestrator mechanism backs it). Timelapse start needs a live
+session/orchestrator — unavailable in the hardware-free shim, so Mode B's actual
+start is rig/session-verified; the UI flow + tactic emission are shim-verifiable.

From f8175b2927935ed3a51ec540f133b5baca426b14 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 23:26:24 +0530
Subject: [PATCH 277/314] =?UTF-8?q?feat(operate):=20Phase=20C=20'Run'=20?=
 =?UTF-8?q?=E2=80=94=20marking=E2=86=92imaging=20handoff=20(Phase=201)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

After Confirm, Operate no longer dead-ends into the manual loop; the stepper
advances to a new ③ Run node and the rail shows a Run chooser. Tactics are the
unifying object — every run mode targets the marked set.

- Stepper: ① Focus → ② Mark → ③ Run; renderStep() drives a new c0 (chooser) and
  running (run-spine) state alongside a1/a2/b1-b5.
- Role chip strip (marked default → subject; flip to reference) → POST
  /api/embryos/roles (new thin route: sets EmbryoState.role + fires EMBRYOS_UPDATE).
  Load-bearing: expression_monitoring scopes to role=='test'.
- Mode A Manual → the existing per-embryo loop. Mode B Adaptive timelapse
  (interval/stop/monitor, default idle) → POST /api/devices/timelapse/start with
  embryo_ids=[subjects]. Mode C3 Hand-to-agent → AgentChat with the roster.
  Library/plan modes stubbed (wired in Phase 3).
- Live run-spine in the rail (reads GET /api/operation_plan, falls back to a
  summary card) + Pause/Stop/Resume (new /api/devices/timelapse/stop|pause|resume
  routes) + Open-in-Operations.

Verified in-browser: mark→confirm→chooser→roles→adaptive start→run-spine, and
Manual→b-loop, survey→a1. Backend timelapse start is rig/session-gated (503 w/o
orchestrator); UI flow + routes verified.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/data.py         | 119 ++++++++++++++
 gently/ui/web/static/css/operate.css |  54 +++++-
 gently/ui/web/static/js/operate.js   | 237 +++++++++++++++++++++++++--
 gently/ui/web/templates/index.html   |  61 +++++++
 4 files changed, 458 insertions(+), 13 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 356e6b72..9f75136c 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -794,6 +794,84 @@ def _next_embryo_id(taken: set) -> str:
         labelled = _persist_detection_labels(agent, payload, markers)
         return {"success": True, "registered": registered, "labelled": labelled}
 
+    @router.post("/api/embryos/roles", dependencies=[Depends(require_control)])
+    async def set_embryo_roles(payload: dict = Body(...)):  # noqa: B008
+        """Assign experimental roles to embryos — the Operate "Run" step.
+
+        Body: {roles: {embryo_id: role_name}} where role_name is a key in
+        gently.harness.roles.REGISTRY (subject=='test', reference=='calibration',
+        plus 'lineaging'/'unassigned'). Sets EmbryoState.role and fires one
+        EMBRYOS_UPDATE (+ per-embryo STATUS_CHANGED) so every consumer refreshes.
+        Marking stays positions-only; roles are assigned here, not at marking.
+        Load-bearing: expression_monitoring scopes to role=='test', so the marked
+        set must be given roles before role-scoped monitoring matches anything.
+        """
+        from gently.harness.roles import is_valid_role
+
+        agent = _require_agent_with_experiment()
+        roles = payload.get("roles") or {}
+        if not isinstance(roles, dict) or not roles:
+            raise HTTPException(status_code=400, detail="roles map required")
+        embryos = agent.experiment.embryos
+        for eid, role in roles.items():
+            if eid not in embryos:
+                raise HTTPException(status_code=400, detail=f"unknown embryo {eid}")
+            if not is_valid_role(str(role)):
+                raise HTTPException(status_code=400, detail=f"invalid role {role}")
+
+        store = getattr(agent, "store", None)
+        sid = getattr(agent, "session_id", None)
+        bus = getattr(agent, "_event_bus", None)
+        updated: list[str] = []
+        for eid, role in roles.items():
+            emb = embryos[eid]
+            old = getattr(emb, "role", None)
+            emb.role = str(role)
+            if store is not None and sid:
+                try:
+                    pos = getattr(emb, "position_coarse", {}) or {}
+                    store.register_embryo(
+                        sid, eid,
+                        position_x=pos.get("x"), position_y=pos.get("y"),
+                        calibration=getattr(emb, "calibration", {}) or {}, role=str(role),
+                    )
+                except Exception:
+                    logger.debug("role persist failed for %s", eid, exc_info=True)
+            if bus is not None:
+                try:
+                    from gently.core.event_bus import EventType
+
+                    bus.publish(
+                        event_type=EventType.STATUS_CHANGED,
+                        data={"embryo_id": eid, "change": "role_assigned",
+                              "old_role": old, "new_role": str(role)},
+                        source="operate_roles",
+                    )
+                except Exception:
+                    logger.debug("STATUS_CHANGED publish failed", exc_info=True)
+            updated.append(eid)
+        try:
+            agent.experiment.notify_embryos_changed()  # fires EMBRYOS_UPDATE
+        except Exception:
+            logger.debug("notify_embryos_changed failed", exc_info=True)
+        return {"success": True, "updated": updated}
+
+    @router.get("/api/operation_plan")
+    async def get_operation_plan_route():
+        """Current session's Operation Plan (the tactics document), for the
+        Operate run-spine. Returns {plan: {...}|null}. Never errors."""
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        cs = getattr(agent, "context_store", None) if agent else None
+        sid = getattr(agent, "session_id", None) if agent else None
+        if cs is None or not sid:
+            return {"plan": None}
+        try:
+            return {"plan": cs.get_operation_plan(sid)}
+        except Exception:
+            logger.debug("get_operation_plan failed", exc_info=True)
+            return {"plan": None}
+
     # ------------------------------------------------------------------
     # Focus Z axes (Operate view) — fenced read + nudge
     # ------------------------------------------------------------------
@@ -1036,6 +1114,47 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
             },
         }
 
+    def _resolve_orchestrator():
+        bridge = getattr(server, "agent_bridge", None)
+        agent = bridge.agent if bridge is not None else None
+        return getattr(agent, "timelapse_orchestrator", None) if agent else None
+
+    @router.post("/api/devices/timelapse/stop", dependencies=[Depends(require_control)])
+    async def timelapse_stop(payload: dict = Body(default={})):  # noqa: B008
+        """Stop the running timelapse (Operate run-spine). Body: {reason?}."""
+        orch = _resolve_orchestrator()
+        if orch is None:
+            raise HTTPException(status_code=503, detail="No timelapse orchestrator")
+        try:
+            return {"stopped": True, "result": await orch.stop(reason=str(payload.get("reason", "user_request")))}
+        except Exception as exc:
+            logger.exception("Timelapse stop failed")
+            raise HTTPException(status_code=502, detail=f"timelapse stop failed: {exc}") from exc
+
+    @router.post("/api/devices/timelapse/pause", dependencies=[Depends(require_control)])
+    async def timelapse_pause():
+        """Pause the running timelapse."""
+        orch = _resolve_orchestrator()
+        if orch is None:
+            raise HTTPException(status_code=503, detail="No timelapse orchestrator")
+        try:
+            return {"paused": True, "result": await orch.pause()}
+        except Exception as exc:
+            logger.exception("Timelapse pause failed")
+            raise HTTPException(status_code=502, detail=f"timelapse pause failed: {exc}") from exc
+
+    @router.post("/api/devices/timelapse/resume", dependencies=[Depends(require_control)])
+    async def timelapse_resume():
+        """Resume a paused timelapse."""
+        orch = _resolve_orchestrator()
+        if orch is None:
+            raise HTTPException(status_code=503, detail="No timelapse orchestrator")
+        try:
+            return {"resumed": True, "result": await orch.resume()}
+        except Exception as exc:
+            logger.exception("Timelapse resume failed")
+            raise HTTPException(status_code=502, detail=f"timelapse resume failed: {exc}") from exc
+
     @router.get("/api/calibration")
     async def list_calibration(embryo_id: str | None = None):
         """Get calibration images"""
diff --git a/gently/ui/web/static/css/operate.css b/gently/ui/web/static/css/operate.css
index 663bed0b..01e906f5 100644
--- a/gently/ui/web/static/css/operate.css
+++ b/gently/ui/web/static/css/operate.css
@@ -173,7 +173,59 @@
 .op-rail[data-active="b2"] .op-group[data-step="b2"],
 .op-rail[data-active="b3"] .op-group[data-step="b3"],
 .op-rail[data-active="b4"] .op-group[data-step="b4"],
-.op-rail[data-active="b5"] .op-group[data-step="b5"] { display: flex; }
+.op-rail[data-active="b5"] .op-group[data-step="b5"],
+.op-rail[data-active="c0"] .op-group[data-step="c0"],
+.op-rail[data-active="running"] .op-group[data-step="running"] { display: flex; }
+
+/* ── Run chooser (c0) ── */
+.op-rolechips { display: flex; flex-wrap: wrap; gap: 0.3rem; }
+.op-rolechip {
+    font-size: 0.66rem; font-weight: 600; padding: 0.2rem 0.5rem; border-radius: 999px;
+    border: 1px solid var(--border); background: var(--bg-hover); color: var(--text); cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+}
+.op-rolechip.is-reference { background: color-mix(in srgb, var(--accent-cyan) 18%, transparent); border-color: var(--accent-cyan); color: var(--accent-cyan); }
+.op-modes { display: flex; flex-direction: column; gap: 0.3rem; }
+.op-mode {
+    display: flex; align-items: baseline; gap: 0.45rem;
+    padding: 0.4rem 0.5rem; border: 1px solid var(--border); border-radius: 7px; cursor: pointer;
+    font-size: 0.78rem; transition: border-color 0.12s, background 0.12s;
+}
+.op-mode:hover { background: var(--bg-hover); }
+.op-mode:has(input:checked) { border-color: var(--accent); background: color-mix(in srgb, var(--accent) 10%, transparent); }
+.op-mode input { margin: 0; accent-color: var(--accent); }
+.op-mode span { font-weight: 600; }
+.op-mode small { color: var(--text-muted); font-size: 0.66rem; margin-left: auto; }
+.op-modepanel { display: none; flex-direction: column; gap: 0.45rem; padding: 0.5rem; border: 1px solid var(--border); border-radius: 7px; background: var(--bg-dark); }
+.op-modepanel.is-shown { display: flex; }
+.op-tl-row { display: flex; align-items: center; gap: 0.5rem; font-size: 0.74rem; color: var(--text-muted); }
+.op-tl-row label { flex: 0 0 52px; }
+.op-num { width: 70px; background: var(--bg-card); border: 1px solid var(--border); color: var(--text); border-radius: 5px; padding: 0.25rem 0.4rem; font: inherit; font-size: 0.74rem; }
+.op-sel-s { flex: 1; background: var(--bg-card); border: 1px solid var(--border); color: var(--text); border-radius: 5px; padding: 0.25rem 0.4rem; font: inherit; font-size: 0.74rem; }
+.op-lib-list, .op-plan-list { display: flex; flex-direction: column; gap: 0.25rem; max-height: 160px; overflow-y: auto; }
+.op-libitem, .op-planitem {
+    text-align: left; background: var(--bg-card); border: 1px solid var(--border); color: var(--text);
+    border-radius: 6px; padding: 0.35rem 0.5rem; cursor: pointer; font: inherit; font-size: 0.74rem;
+    transition: border-color 0.12s, background 0.12s;
+}
+.op-libitem:hover, .op-planitem:hover { border-color: var(--accent); }
+.op-libitem.is-sel, .op-planitem.is-sel { border-color: var(--accent); background: color-mix(in srgb, var(--accent) 12%, transparent); }
+.op-libitem small, .op-planitem small { display: block; color: var(--text-muted); font-size: 0.64rem; }
+
+/* ── Run-spine (running) ── */
+.op-runspine { display: flex; flex-direction: column; gap: 0.4rem; max-height: 50vh; overflow-y: auto; }
+.op-tcard { border: 1px solid var(--border); border-left-width: 3px; border-radius: 7px; padding: 0.5rem 0.6rem; background: var(--bg-dark); }
+.op-tcard.st-active { border-left-color: var(--accent-green); }
+.op-tcard.st-planned { border-left-color: var(--text-muted); }
+.op-tcard.st-paused { border-left-color: var(--accent-orange); }
+.op-tcard.st-done { border-left-color: var(--accent); }
+.op-tcard-head { display: flex; justify-content: space-between; align-items: baseline; gap: 0.5rem; }
+.op-tcard-name { font-size: 0.78rem; font-weight: 600; }
+.op-tcard-state { font-size: 0.6rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.06em; color: var(--text-muted); }
+.op-tcard-kind { font-size: 0.66rem; color: var(--text-muted); }
+.op-tcard-meta { font-size: 0.68rem; color: var(--text-muted); font-variant-numeric: tabular-nums; margin-top: 0.2rem; }
+.op-run-actions { display: flex; gap: 0.5rem; }
+.op-run-actions .op-btn { flex: 1; }
 
 .op-field { display: flex; flex-direction: column; gap: 0.4rem; }
 .op-label { font-size: 0.64rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.08em; color: var(--text-muted); }
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 1009f5c3..79418fbd 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -50,6 +50,17 @@ const OperateManager = (function () {
     let _fdPos = null, _fdFloor = null;
     let _galvo = 0.0, _piezo = 50.0, _ledOn = false;
 
+    // Phase C "Run": _runState null = not in Run; 'choose' = chooser; 'running' = live.
+    // Every Run mode emits one tactic scoped to the marked set. _roles maps each
+    // embryo to a role ('test'=subject default, 'calibration'=reference).
+    let _runState = null;
+    let _runMode = 'adaptive';
+    const _roles = {};
+    let _runMeta = null;             // summary of the active run (for the run-spine)
+    let _runPlan = null;             // operation plan {tactics:[]} for the run-spine
+    let _runPaused = false;
+    let _selectedLib = null, _selectedPlan = null;
+
     // DOM (cached on wire)
     const D = {};
 
@@ -72,6 +83,9 @@ const OperateManager = (function () {
             'op-tomark', 'op-detect', 'op-confirm', 'op-mark-count', 'op-clear', 'op-center', 'op-center-hint',
             'op-fd-pos', 'op-fd-floor', 'op-fd-nudge', 'op-fd-d100', 'op-fd-d10', 'op-tofocus',
             'op-spim-toggle', 'op-led', 'op-gv', 'op-pz', 'op-spim-score', 'op-infocus', 'op-acquire', 'op-retract',
+            'op-rolechips', 'op-modes', 'op-panel-adaptive', 'op-panel-library', 'op-panel-plan', 'op-panel-agent',
+            'op-tl-interval', 'op-tl-stop', 'op-tl-condval', 'op-tl-monitor', 'op-lib-list', 'op-plan-list',
+            'op-run-start', 'op-runspine', 'op-run-pause', 'op-run-stop', 'op-run-open',
         ].forEach(id => { D[id] = $(id); });
     }
 
@@ -80,19 +94,25 @@ const OperateManager = (function () {
         return { marked: 'b1', centered: 'b2', lowering: 'b2', focused: 'b4', imaged: 'b5' }[st] || 'b1';
     }
     function effectiveStep() {
-        if (!_selected) return _marking ? 'a2' : 'a1';
-        return _step || 'b1';
+        if (_marking) return 'a2';
+        if (_runState === 'running') return 'running';
+        if (_runState === 'choose') return 'c0';
+        if (_selected) return _step || 'b1';
+        return 'a1';
     }
     function cameraForStep(step) {
-        return (step === 'a1' || step === 'a2' || step === 'b1') ? 'bottom' : 'spim';
+        if (step === 'a1' || step === 'a2' || step === 'b1') return 'bottom';
+        if (step === 'b2' || step === 'b3' || step === 'b4' || step === 'b5') return 'spim';
+        return 'none';  // c0 / running are non-camera (the dish map carries context)
     }
 
     const RAIL_HEADS = {
         a1: 'Focus the bottom objective', a2: 'Mark all embryos',
         b1: 'Center the embryo', b2: 'Lower the SPIM head', b3: 'Focus the SPIM objective',
         b4: 'Acquire the volume', b5: 'Retract & advance',
+        c0: 'Run — choose how to image', running: 'Run — live',
     };
-    const STEP_NODE = { a1: 'a1', a2: 'a2', b1: 'b1', b2: 'b2', b3: 'b3', b4: 'b4', b5: 'b4' };
+    const STEP_NODE = { a1: 'a1', a2: 'a2', b1: 'b1', b2: 'b2', b3: 'b3', b4: 'b4', b5: 'b4', c0: 'run', running: 'run' };
 
     function setStep(s) { _step = s; renderStep(); }
 
@@ -119,8 +139,12 @@ const OperateManager = (function () {
             n.classList.remove('is-active', 'is-done', 'is-locked');
             const active = STEP_NODE[step] === node;
             if (node === 'a1' || node === 'a2') {
-                if (active && !_selected) n.classList.add('is-active');
+                if (active) n.classList.add('is-active');
                 else if (_embryos.length) n.classList.add('is-done');
+            } else if (node === 'run') {
+                if (active) n.classList.add('is-active');
+                else if (_embryos.length && _selected) n.classList.add('is-done');
+                else if (!_embryos.length) n.classList.add('is-locked');
             } else {
                 const oi = order[node];
                 if (active) n.classList.add('is-active');
@@ -135,14 +159,23 @@ const OperateManager = (function () {
         }
 
         // viewport: badge + stop the inactive camera
-        if (D['op-badge']) D['op-badge'].textContent =
-            (cam === 'bottom' ? 'Bottom cam' : 'SPIM · side A') + ' — ' + RAIL_HEADS[step].toLowerCase();
+        if (D['op-badge']) {
+            D['op-badge'].textContent = cam === 'none'
+                ? RAIL_HEADS[step]
+                : (cam === 'bottom' ? 'Bottom cam' : 'SPIM · side A') + ' — ' + RAIL_HEADS[step].toLowerCase();
+        }
         ensureInactiveCameraStopped(cam);
         // show the right frame
         if (cam === 'bottom' && !_marking && _lastFrame) setImg(_lastFrame);
         else if (cam === 'spim' && _lastSpimFrame) setImg(_lastSpimFrame);
         else if (cam === 'spim' && !_spimOn) { D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = ''; D['op-cam-ph'].textContent = 'SPIM view off'; }
         else if (cam === 'bottom' && !_camOn && !_marking) { D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = ''; D['op-cam-ph'].textContent = 'Camera off'; }
+        else if (cam === 'none') {
+            D['op-cam-img'].classList.remove('has-frame'); D['op-cam-ph'].style.display = '';
+            D['op-cam-ph'].textContent = step === 'running'
+                ? `Run live — ${_embryos.length} embryo${_embryos.length === 1 ? '' : 's'} (see the dish map)`
+                : `${_embryos.length} embryo${_embryos.length === 1 ? '' : 's'} marked — choose how to image`;
+        }
 
         // gating
         if (D['op-center']) {
@@ -155,6 +188,8 @@ const OperateManager = (function () {
         renderStatus();
         renderBoard();
         renderMiniMap();
+        if (step === 'c0') renderChooser();
+        else if (step === 'running') renderRunSpine();
     }
 
     function ensureInactiveCameraStopped(cam) {
@@ -551,15 +586,185 @@ const OperateManager = (function () {
         _embryos = (p && Array.isArray(p.embryos)) ? p.embryos : [];
         const ids = new Set(_embryos.map(e => e.id));
         Object.keys(_states).forEach(id => { if (!ids.has(id)) delete _states[id]; });
-        _embryos.forEach(e => { if (!_states[e.id]) _states[e.id] = 'marked'; });
+        Object.keys(_roles).forEach(id => { if (!ids.has(id)) delete _roles[id]; });
+        _embryos.forEach(e => {
+            if (!_states[e.id]) _states[e.id] = 'marked';
+            // seed role from the embryo if present, else default to subject ('test')
+            if (!_roles[e.id]) _roles[e.id] = (e.role && e.role !== 'unassigned') ? e.role : 'test';
+        });
         if (_selected && !ids.has(_selected)) { _selected = null; _step = null; }
-        // After the first marking confirm, flow into Phase B on the first embryo.
-        if (wasEmpty && _embryos.length && !_selected && !_marking) selectEmbryo(_embryos[0].id);
-        else renderStep();
+        // After the first marking confirm, enter the Phase C Run chooser
+        // (NOT the old auto-dive into the manual loop).
+        if (wasEmpty && _embryos.length && !_selected && !_marking && _runState === null) {
+            _runState = 'choose';
+        }
+        renderStep();
+    }
+
+    // ── Phase C: Run chooser + run-spine ───────────────────────────────────
+    function escapeHtml(s) {
+        return String(s == null ? '' : s).replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+    }
+
+    function renderChooser() {
+        if (D['op-rolechips']) {
+            D['op-rolechips'].innerHTML = '';
+            _embryos.forEach(emb => {
+                const role = _roles[emb.id] || 'test';
+                const chip = document.createElement('button');
+                chip.type = 'button';
+                chip.className = 'op-rolechip' + (role === 'calibration' ? ' is-reference' : '');
+                chip.textContent = `${labelFor(emb)} · ${role === 'calibration' ? 'ref' : 'subj'}`;
+                chip.title = 'Click to toggle subject / reference';
+                chip.addEventListener('click', () => {
+                    _roles[emb.id] = (_roles[emb.id] === 'calibration') ? 'test' : 'calibration';
+                    renderChooser();
+                });
+                D['op-rolechips'].appendChild(chip);
+            });
+        }
+        document.querySelectorAll('.op-modepanel').forEach(p => p.classList.toggle('is-shown', p.dataset.mode === _runMode));
+        if (D['op-tl-stop'] && D['op-tl-condval']) {
+            const s = D['op-tl-stop'].value;
+            D['op-tl-condval'].style.display = (s === 'timepoints' || s === 'duration') ? '' : 'none';
+        }
+        if (_runMode === 'library') loadLibrary();
+        if (_runMode === 'plan') loadPlanItems();
+    }
+
+    async function loadLibrary() {
+        if (!D['op-lib-list']) return;
+        try {
+            const d = await getJSON('/api/tactic_library');
+            const items = (d && d.tactics) || [];
+            if (!items.length) { D['op-lib-list'].innerHTML = '<div class="op-empty">No saved tactics</div>'; return; }
+            D['op-lib-list'].innerHTML = '';
+            items.forEach(t => {
+                const b = document.createElement('button');
+                b.type = 'button';
+                b.className = 'op-libitem' + (t.id === _selectedLib ? ' is-sel' : '');
+                b.innerHTML = `${escapeHtml(t.name || t.id)}<small>${escapeHtml(t.kind || '')}</small>`;
+                b.addEventListener('click', () => { _selectedLib = t.id; loadLibrary(); });
+                D['op-lib-list'].appendChild(b);
+            });
+        } catch (_) { D['op-lib-list'].innerHTML = '<div class="op-empty">Library unavailable</div>'; }
+    }
+    function loadPlanItems() {
+        // Phase 3 wires the resume_plan candidate list.
+        if (D['op-plan-list']) D['op-plan-list'].innerHTML = '<div class="op-empty">Plan linking — coming in the tactics phase</div>';
+    }
+
+    async function applyRoles() {
+        const roles = {};
+        _embryos.forEach(e => { roles[e.id] = _roles[e.id] || 'test'; });
+        try { await postJSON('/api/embryos/roles', { roles }); } catch (e) { toast(`Roles failed (${e.status || e.message})`); }
+    }
+
+    async function startRun() {
+        if (_runMode === 'manual') {
+            _runState = null;
+            if (_embryos.length) selectEmbryo(_embryos[0].id);
+            return;
+        }
+        await applyRoles();
+        const subjects = _embryos.filter(e => (_roles[e.id] || 'test') !== 'calibration').map(e => e.id);
+        const embryo_ids = subjects.length ? subjects : _embryos.map(e => e.id);
+        if (_runMode === 'adaptive') {
+            const interval = Math.max(1, Number(D['op-tl-interval'].value) || 120);
+            const stop = D['op-tl-stop'].value;
+            const monitoring = D['op-tl-monitor'].value;
+            const body = { embryo_ids, interval_seconds: interval, stop_condition: stop, monitoring_mode: monitoring };
+            if (stop === 'timepoints' || stop === 'duration') body.condition_value = Math.max(1, Number(D['op-tl-condval'].value) || 1);
+            D['op-run-start'].disabled = true; D['op-run-start'].textContent = 'Starting…';
+            try {
+                await postJSON('/api/devices/timelapse/start', body);
+                _runMeta = { mode: 'adaptive', interval, stop, monitoring, n: embryo_ids.length };
+                _runState = 'running'; _runPaused = false;
+                toast(`Adaptive timelapse started — ${embryo_ids.length} subject${embryo_ids.length === 1 ? '' : 's'}`);
+                renderStep();
+            } catch (e) {
+                toast(`Start failed (${e.status || e.message})`);
+            } finally { D['op-run-start'].disabled = false; D['op-run-start'].textContent = 'Start run'; }
+            return;
+        }
+        if (_runMode === 'agent') {
+            const roster = _embryos.map(e => {
+                const xy = resolveXY(e);
+                const r = _roles[e.id] === 'calibration' ? 'reference' : 'subject';
+                return `${labelFor(e)}${xy ? ` (${xy.x.toFixed(0)},${xy.y.toFixed(0)})` : ''} [${r}]`;
+            }).join(', ');
+            if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
+                AgentChat.togglePanel(true);
+                if (AgentChat.runCommand) {
+                    setTimeout(() => AgentChat.runCommand(
+                        `I marked ${_embryos.length} embryos: ${roster}. Propose and start an Operation Plan to image them.`), 300);
+                }
+            } else { toast('Agent chat unavailable'); }
+            _runState = 'running'; renderStep();
+            return;
+        }
+        if (_runMode === 'library' || _runMode === 'plan') {
+            toast('Library / plan run — wired in the tactics phase');  // Phase 3
+        }
+    }
+
+    async function renderRunSpine() {
+        if (!D['op-runspine']) return;
+        let tactics = [];
+        try { const d = await getJSON('/api/operation_plan'); tactics = (d && d.plan && d.plan.tactics) || []; } catch (_) {}
+        D['op-runspine'].innerHTML = '';
+        if (tactics.length) {
+            tactics.forEach(t => D['op-runspine'].appendChild(tacticCard(t)));
+        } else if (_runMeta) {
+            const stopTxt = _runMeta.stop === 'manual' ? 'until stopped' : _runMeta.stop;
+            const card = document.createElement('div');
+            card.className = 'op-tcard st-active';
+            card.innerHTML = '<div class="op-tcard-head"><span class="op-tcard-name">Adaptive timelapse</span><span class="op-tcard-state">active</span></div>'
+                + `<div class="op-tcard-kind">standing_timelapse · ${escapeHtml(_runMeta.monitoring)}</div>`
+                + `<div class="op-tcard-meta">${_runMeta.interval}s · ${_runMeta.n} subject${_runMeta.n === 1 ? '' : 's'} · ${escapeHtml(stopTxt)}</div>`;
+            D['op-runspine'].appendChild(card);
+        } else {
+            D['op-runspine'].innerHTML = '<div class="op-empty">Run active.</div>';
+        }
+        if (D['op-run-pause']) D['op-run-pause'].textContent = _runPaused ? 'Resume' : 'Pause';
+    }
+    function tacticCard(t) {
+        const card = document.createElement('div');
+        const state = t.state || 'planned';
+        card.className = 'op-tcard st-' + state;
+        const struct = t.structure || {};
+        const meta = [];
+        if (struct.cadence_s != null) meta.push(`${struct.cadence_s}s`);
+        if (struct.interval != null) meta.push(`${struct.interval}s`);
+        if (struct.status) meta.push(struct.status);
+        if (t.live && t.live.signal != null) meta.push(`signal ${t.live.signal}`);
+        card.innerHTML = `<div class="op-tcard-head"><span class="op-tcard-name">${escapeHtml(t.name || t.id)}</span><span class="op-tcard-state">${escapeHtml(state)}</span></div>`
+            + `<div class="op-tcard-kind">${escapeHtml(t.kind || '')}</div>`
+            + (meta.length ? `<div class="op-tcard-meta">${escapeHtml(meta.join(' · '))}</div>` : '')
+            + (t.rationale ? `<div class="op-tcard-meta">${escapeHtml(t.rationale)}</div>` : '');
+        return card;
+    }
+
+    async function pauseRun() {
+        try {
+            if (_runPaused) { await postJSON('/api/devices/timelapse/resume', {}); _runPaused = false; toast('Resumed'); }
+            else { await postJSON('/api/devices/timelapse/pause', {}); _runPaused = true; toast('Paused'); }
+            renderRunSpine();
+        } catch (e) { toast(`Pause/resume failed (${e.status || e.message})`); }
+    }
+    async function stopRun() {
+        if (!window.confirm('Stop the run?')) return;
+        try { await postJSON('/api/devices/timelapse/stop', { reason: 'operator' }); } catch (e) { toast(`Stop failed (${e.status || e.message})`); }
+        _runState = 'choose'; _runMeta = null; _runPaused = false;
+        toast('Run stopped'); renderStep();
+    }
+    function openInOperations() {
+        const nav = [...document.querySelectorAll('[data-tab]')].find(n => /operations/i.test(n.textContent || ''));
+        if (nav) nav.click(); else toast('Operations tab not found');
     }
 
     // ── lifecycle ──────────────────────────────────────────────────────────
-    function surveyMore() { _selected = null; _step = null; if (_marking) exitMarking(); renderStep(); }
+    function surveyMore() { _selected = null; _step = null; _runState = null; if (_marking) exitMarking(); renderStep(); }
 
     function wire() {
         if (_wired) return; _wired = true;
@@ -582,6 +787,14 @@ const OperateManager = (function () {
         D['op-acquire'].addEventListener('click', acquireSelected);
         D['op-retract'].addEventListener('click', retractAndAdvance);
         D['op-survey-btn'].addEventListener('click', surveyMore);
+        // Phase C: Run chooser + run-spine
+        document.querySelectorAll('input[name="op-mode"]').forEach(r =>
+            r.addEventListener('change', () => { _runMode = r.value; renderChooser(); }));
+        if (D['op-tl-stop']) D['op-tl-stop'].addEventListener('change', renderChooser);
+        if (D['op-run-start']) D['op-run-start'].addEventListener('click', startRun);
+        if (D['op-run-pause']) D['op-run-pause'].addEventListener('click', pauseRun);
+        if (D['op-run-stop']) D['op-run-stop'].addEventListener('click', stopRun);
+        if (D['op-run-open']) D['op-run-open'].addEventListener('click', openInOperations);
         window.addEventListener('resize', () => { if (_active) drawOverlay(effectiveStep()); });
 
         if (typeof ClientEventBus !== 'undefined') {
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index e3d41b6d..f232b09a 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -497,6 +497,9 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     <span class="op-arrow">→</span>
                     <span class="op-node" data-node="a2">Mark</span>
                     <span class="op-phase-div"></span>
+                    <span class="op-phase">Run</span>
+                    <span class="op-node" data-node="run">Choose</span>
+                    <span class="op-phase-div"></span>
                     <span class="op-phase">Acquire<b id="op-loop-emb"></b></span>
                     <span class="op-node" data-node="b1">Center</span>
                     <span class="op-arrow">→</span>
@@ -609,6 +612,64 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     <div class="op-hint">Imaged ✓ — raise the head to safe travel, then advance.</div>
                     <button class="op-btn op-btn-primary" id="op-retract" type="button">Raise head ▲ &amp; next</button>
                   </div>
+
+                  <!-- ③ RUN chooser: pick how to image the marked set (every mode emits one tactic) -->
+                  <div class="op-group" data-step="c0">
+                    <div class="op-field">
+                      <label class="op-label">Roles <span class="op-cap">(marked → subject)</span></label>
+                      <div class="op-rolechips" id="op-rolechips"></div>
+                    </div>
+                    <div class="op-field">
+                      <label class="op-label">Run mode</label>
+                      <div class="op-modes" id="op-modes">
+                        <label class="op-mode"><input type="radio" name="op-mode" value="manual"><span>Manual one-by-one</span><small>volumes, the B-loop</small></label>
+                        <label class="op-mode"><input type="radio" name="op-mode" value="adaptive" checked><span>Adaptive timelapse</span><small>ongoing, cadence</small></label>
+                        <label class="op-mode"><input type="radio" name="op-mode" value="library"><span>From library</span><small>a saved tactic</small></label>
+                        <label class="op-mode"><input type="radio" name="op-mode" value="plan"><span>Continue a plan</span><small>a campaign item</small></label>
+                        <label class="op-mode"><input type="radio" name="op-mode" value="agent"><span>Hand to agent</span><small>let it compose</small></label>
+                      </div>
+                    </div>
+                    <!-- adaptive sub-form -->
+                    <div class="op-modepanel" data-mode="adaptive" id="op-panel-adaptive">
+                      <div class="op-tl-row"><label>Interval</label><input class="op-num" id="op-tl-interval" type="number" min="1" value="120"><span class="op-cap">s</span></div>
+                      <div class="op-tl-row"><label>Stop</label>
+                        <select class="op-sel-s" id="op-tl-stop">
+                          <option value="manual">manual</option>
+                          <option value="timepoints">after N timepoints</option>
+                          <option value="duration">after N hours</option>
+                          <option value="hatching">at hatching</option>
+                        </select>
+                        <input class="op-num" id="op-tl-condval" type="number" min="1" value="10" style="display:none">
+                      </div>
+                      <div class="op-tl-row"><label>Monitor</label>
+                        <select class="op-sel-s" id="op-tl-monitor">
+                          <option value="idle" selected>idle (fixed cadence)</option>
+                          <option value="expression_monitoring">expression</option>
+                          <option value="pre_terminal_monitoring">pre-terminal</option>
+                        </select>
+                      </div>
+                    </div>
+                    <div class="op-modepanel" data-mode="library" id="op-panel-library">
+                      <div class="op-lib-list" id="op-lib-list"><div class="op-empty">No saved tactics</div></div>
+                    </div>
+                    <div class="op-modepanel" data-mode="plan" id="op-panel-plan">
+                      <div class="op-plan-list" id="op-plan-list"><div class="op-empty">No linkable plan items</div></div>
+                    </div>
+                    <div class="op-modepanel" data-mode="agent" id="op-panel-agent">
+                      <div class="op-hint">Opens the agent with the marked roster to propose &amp; start an Operation Plan.</div>
+                    </div>
+                    <button class="op-btn op-btn-primary" id="op-run-start" type="button">Start run</button>
+                  </div>
+
+                  <!-- Run live: the rail becomes a read-only run-spine -->
+                  <div class="op-group" data-step="running">
+                    <div class="op-runspine" id="op-runspine"></div>
+                    <div class="op-run-actions">
+                      <button class="op-btn op-btn-toggle" id="op-run-pause" type="button">Pause</button>
+                      <button class="op-btn" id="op-run-stop" type="button">Stop run</button>
+                    </div>
+                    <button class="op-btn op-btn-ghost" id="op-run-open" type="button">Open in Operations →</button>
+                  </div>
                 </div>
 
               </div>

From 178f8721086c505ed10d04f2a9d5fdf1762c4b0b Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 23:36:24 +0530
Subject: [PATCH 278/314] =?UTF-8?q?feat(operate):=20Phase=202=20=E2=80=94?=
 =?UTF-8?q?=20Mode=20B=20emits=20a=20real=20tactic=20+=20tactic=5Fid=20sym?=
 =?UTF-8?q?metry?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- /api/devices/timelapse/start now seeds the session Operation Plan with a
  standing_timelapse tactic (+ a reactive_monitor layered_on when a monitoring
  mode is active) scoped to the marked set, transitioned active — closing the
  'UI timelapses skip plan linking' TODO. Best-effort (needs a live session +
  context store); never blocks the start. So the Operate run-spine + Operations
  tab now show a real tactic for a UI-started timelapse.
- start_adaptive_timelapse gains tactic_id (transitions the tactic active on
  success) — lifecycle symmetry with stop/pause/enable_monitoring_mode/queue_burst.

Note: no tactic-schema change needed — _validate_tactics copies structure
verbatim, so cadence_s/stop_condition/monitoring_mode/interval are already
allowed. Seeding is rig/session-verified (no session in the hardware-free shim).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/tools/timelapse_tools.py | 18 +++++++++-
 gently/ui/web/routes/data.py        | 54 ++++++++++++++++++++++++++++-
 2 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/gently/app/tools/timelapse_tools.py b/gently/app/tools/timelapse_tools.py
index 0c0c45c2..e9b1427f 100644
--- a/gently/app/tools/timelapse_tools.py
+++ b/gently/app/tools/timelapse_tools.py
@@ -64,9 +64,15 @@ async def start_adaptive_timelapse(
     interval_seconds: float = 120.0,
     condition_value: int | None = None,
     monitoring_mode: str | None = None,
+    tactic_id: str | None = None,
     context: dict | None = None,
 ) -> str:
-    """Start adaptive timelapse in background"""
+    """Start adaptive timelapse in background.
+
+    ``tactic_id`` (optional) links this start to a tactic in the session
+    Operation Plan: on success the tactic is transitioned to 'active', giving
+    lifecycle symmetry with stop/pause/enable_monitoring_mode/queue_burst.
+    """
     agent, err = require_agent(context)
     if err:
         return err
@@ -112,6 +118,16 @@ async def start_adaptive_timelapse(
             except Exception as e:
                 result += f"\n(Failed to enable monitoring mode '{monitoring_mode}': {e})"
 
+        # Lifecycle symmetry: mark the linked tactic active (best-effort).
+        if tactic_id:
+            try:
+                cs = getattr(agent, "context_store", None)
+                session_id = getattr(agent, "session_id", None)
+                if cs and session_id:
+                    cs.transition_tactic(session_id, tactic_id, "active")
+            except Exception:
+                pass  # never block the timelapse
+
         return result
     except Exception as e:
         return f"Error starting timelapse: {str(e)}"
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 9f75136c..2f579e7a 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -1100,9 +1100,60 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
             except Exception as exc:
                 mode_result = f"warning: failed to enable monitoring mode: {exc}"
 
+        # Seed the session Operation Plan with a standing_timelapse tactic (+ a
+        # reactive_monitor when a monitoring mode is active) scoped to the marked
+        # set. Closes the historical "UI timelapses skip plan linking" gap so the
+        # Operate run-spine and the Operations tab show a real tactic. Best-effort:
+        # needs a live session + context store; never blocks the start.
+        seeded_tactics: list[str] = []
+        cs = getattr(agent, "context_store", None)
+        sid = getattr(agent, "session_id", None)
+        if cs is not None and sid:
+            try:
+                import uuid as _uuid
+
+                from gently.app.tools.operation_plan_tools import _validate_tactics
+
+                eids = list(embryo_ids or [])
+                st_id = f"op_{_uuid.uuid4().hex[:8]}"
+                new_tactics = [
+                    {
+                        "id": st_id, "name": "Adaptive timelapse",
+                        "kind": "standing_timelapse", "state": "active",
+                        "scope": {"mode": "embryos", "embryo_ids": eids},
+                        "structure": {
+                            "cadence_s": interval_seconds, "interval": interval_seconds,
+                            "stop_condition": stop_condition, "condition_value": condition_value,
+                            "monitoring_mode": monitoring_mode or "idle",
+                        },
+                        "rationale": "Started from the Operate Run step.",
+                        "live_bind": ["cadence"], "relations": {}, "live": {},
+                    }
+                ]
+                if monitoring_mode and monitoring_mode != "idle":
+                    new_tactics.append({
+                        "id": f"op_{_uuid.uuid4().hex[:8]}", "name": "Monitor",
+                        "kind": "reactive_monitor", "state": "active",
+                        "scope": {"mode": "embryos", "embryo_ids": eids},
+                        "structure": {"monitoring_mode": monitoring_mode, "status": "armed"},
+                        "rationale": f"{monitoring_mode} on the marked subjects.",
+                        "live_bind": ["signal"], "relations": {"layered_on": [st_id]}, "live": {},
+                    })
+                new_tactics = _validate_tactics(new_tactics)
+                plan = cs.get_operation_plan(sid) or {
+                    "session_id": sid, "title": "Operate session", "goal": "", "tactics": []
+                }
+                plan.setdefault("tactics", []).extend(new_tactics)
+                plan["updated_reason"] = "operate adaptive timelapse"
+                cs.set_operation_plan(sid, plan)
+                seeded_tactics = [t["id"] for t in new_tactics]
+            except Exception:
+                logger.debug("timelapse tactic seeding skipped", exc_info=True)
+
         return {
             "started": True,
             "result": result,
+            "tactics": seeded_tactics,
             "monitoring_mode_result": mode_result,
             "config": {
                 "interval_seconds": interval_seconds,
@@ -1126,7 +1177,8 @@ async def timelapse_stop(payload: dict = Body(default={})):  # noqa: B008
         if orch is None:
             raise HTTPException(status_code=503, detail="No timelapse orchestrator")
         try:
-            return {"stopped": True, "result": await orch.stop(reason=str(payload.get("reason", "user_request")))}
+            reason = str(payload.get("reason", "user_request"))
+            return {"stopped": True, "result": await orch.stop(reason=reason)}
         except Exception as exc:
             logger.exception("Timelapse stop failed")
             raise HTTPException(status_code=502, detail=f"timelapse stop failed: {exc}") from exc

From 030feaee0351344dea56a244b8d44ffa5469ac31 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Tue, 30 Jun 2026 23:59:45 +0530
Subject: [PATCH 279/314] =?UTF-8?q?feat(operate):=20Phase=203=20=E2=80=94?=
 =?UTF-8?q?=20Tactic=20Executor=20+=20library/oneshot/plan/agent=20modes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Keystone: gently/app/orchestration/tactic_executor.py — execute_tactic(agent,
tactic) resolves scope (the FIRST caller of resolve_scope_embryos) and dispatches
by kind to the orchestrator (standing_timelapse[+monitoring] / reactive_monitor /
exclusive_burst / oneshot), then marks the tactic active. One kind→action map the
agent and the UI both go through. 8 unit tests (mocked orchestrator/roster), all green.

- POST /api/operate/run-tactic — append a tactic (or instantiate a saved one via
  library_id) re-scoped to the marked set, then execute it via the executor.
- Operate Run modes wired: From-library → run-tactic(library_id); Manual → fires a
  cosmetic oneshot so the sweep shows on the spine; Continue-a-plan & Hand-to-agent
  → AgentChat hand-off (the agent owns plan resolution + composed tactics).
- Run-spine now renders the real Operation-Plan tactic cards (GET /api/operation_plan).

Verified in-browser: chooser→library select→run-tactic→running run-spine shows the
tactic; run-tactic route 200 end-to-end in shim. resolve_scope_embryos is no longer
orphaned. (No tactic-schema change needed — structure is free-form.)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/orchestration/tactic_executor.py | 145 +++++++++++++++++++
 gently/ui/web/routes/data.py                |  42 ++++++
 gently/ui/web/static/js/operate.js          |  50 +++++--
 tests/test_tactic_executor.py               | 149 ++++++++++++++++++++
 4 files changed, 371 insertions(+), 15 deletions(-)
 create mode 100644 gently/app/orchestration/tactic_executor.py
 create mode 100644 tests/test_tactic_executor.py

diff --git a/gently/app/orchestration/tactic_executor.py b/gently/app/orchestration/tactic_executor.py
new file mode 100644
index 00000000..0d13aca0
--- /dev/null
+++ b/gently/app/orchestration/tactic_executor.py
@@ -0,0 +1,145 @@
+"""Tactic Executor — turns a declarative tactic into orchestrator actions.
+
+A *tactic* (a dict in the session Operation Plan) describes HOW to image a scoped
+set of embryos: ``{kind, scope, structure, ...}``. This module is the single
+place that makes that language *executable* — it resolves the tactic's scope to
+concrete embryo ids and dispatches by ``kind`` to the TimelapseOrchestrator, then
+marks the tactic active. It is the first (and only) caller of
+``resolve_scope_embryos``; both the Operate "Run" surface and the agent reach
+imaging through this one path, so the kind→action mapping lives here, not
+duplicated across call sites.
+
+Deterministic and side-effecting only through the orchestrator + context store —
+no LLM. Real acquisition/motion remain the orchestrator's concern (RIG-DEFERRED).
+"""
+
+from __future__ import annotations
+
+import logging
+
+from gently.app.orchestration.role_scope import resolve_scope_embryos
+
+logger = logging.getLogger(__name__)
+
+
+def _roster(agent) -> list[dict]:
+    """Build the [{embryo_id, role}] roster resolve_scope_embryos expects."""
+    exp = getattr(agent, "experiment", None)
+    embryos = getattr(exp, "embryos", {}) if exp is not None else {}
+    roster = []
+    for eid, emb in embryos.items():
+        roster.append({"embryo_id": eid, "role": getattr(emb, "role", "unassigned")})
+    return roster
+
+
+def _num(v, default=None):
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        return default
+
+
+async def execute_tactic(agent, tactic: dict) -> dict:
+    """Execute one tactic against the agent's orchestrator.
+
+    Returns ``{ok, kind, embryo_ids, message}``. Never raises for an unknown
+    kind or empty scope — it reports them in the result so callers can surface a
+    clear message. Marks the tactic ``active`` in the Operation Plan on success.
+    """
+    kind = (tactic or {}).get("kind")
+    scope = (tactic or {}).get("scope")
+    structure = (tactic or {}).get("structure") or {}
+    tactic_id = (tactic or {}).get("id")
+
+    orchestrator = getattr(agent, "timelapse_orchestrator", None)
+    if orchestrator is None:
+        return {"ok": False, "kind": kind, "embryo_ids": [], "message": "no orchestrator"}
+
+    embryo_ids = resolve_scope_embryos(scope, _roster(agent))
+    if not embryo_ids and kind not in ("oneshot", "custom", "scripted_protocol"):
+        return {"ok": False, "kind": kind, "embryo_ids": [],
+                "message": "scope resolved to no embryos"}
+
+    message = ""
+    try:
+        if kind == "standing_timelapse":
+            interval = _num(structure.get("cadence_s"), _num(structure.get("interval"), 120.0))
+            message = await orchestrator.start(
+                embryo_ids=embryo_ids,
+                stop_condition=str(structure.get("stop_condition", "manual")),
+                base_interval_seconds=interval,
+                condition_value=structure.get("condition_value"),
+            )
+            mode = structure.get("monitoring_mode")
+            if mode and mode != "idle":
+                try:
+                    mres = orchestrator.enable_monitoring_mode(mode, embryo_ids=embryo_ids)
+                    message += " | " + str(mres)
+                except Exception as exc:  # monitoring is best-effort
+                    message += f" | monitoring '{mode}' failed: {exc}"
+
+        elif kind == "reactive_monitor":
+            mode = structure.get("monitoring_mode") or "expression_monitoring"
+            message = orchestrator.enable_monitoring_mode(mode, embryo_ids=embryo_ids)
+
+        elif kind == "exclusive_burst":
+            frames = int(_num(structure.get("frames"), 60))
+            results = []
+            for eid in embryo_ids:
+                results.append(orchestrator.queue_burst(
+                    eid, frames=frames, mode=str(structure.get("mode", "1hz")),
+                    num_slices=int(_num(structure.get("num_slices"), 1)),
+                    tactic_id=tactic_id,
+                ))
+            message = "; ".join(results)
+
+        elif kind in ("oneshot", "scripted_protocol", "custom"):
+            # No standing orchestrator mechanism backs these here — the tactic is
+            # recorded (and, for oneshot, driven by the manual per-embryo loop).
+            message = f"{kind} recorded (no orchestrator mechanism)"
+
+        else:
+            return {"ok": False, "kind": kind, "embryo_ids": embryo_ids,
+                    "message": f"unknown tactic kind '{kind}'"}
+    except Exception as exc:
+        logger.exception("tactic execution failed (kind=%s)", kind)
+        return {"ok": False, "kind": kind, "embryo_ids": embryo_ids, "message": str(exc)}
+
+    # Mark the tactic active in the Operation Plan (best-effort).
+    cs = getattr(agent, "context_store", None)
+    sid = getattr(agent, "session_id", None)
+    if cs is not None and sid and tactic_id:
+        try:
+            cs.transition_tactic(sid, tactic_id, "active")
+        except Exception:
+            logger.debug("transition_tactic failed for %s", tactic_id, exc_info=True)
+
+    return {"ok": True, "kind": kind, "embryo_ids": embryo_ids, "message": message}
+
+
+def append_tactic_to_plan(agent, tactic: dict) -> dict | None:
+    """Append a (validated) tactic to the session Operation Plan and return it.
+
+    Creates a minimal plan if none exists. Returns the stored tactic dict (with a
+    generated id if absent), or None if there is no session/context store.
+    """
+    import uuid
+
+    from gently.app.tools.operation_plan_tools import _validate_tactics
+
+    cs = getattr(agent, "context_store", None)
+    sid = getattr(agent, "session_id", None)
+    if cs is None or not sid:
+        return None
+    t = dict(tactic)
+    t.setdefault("id", f"op_{uuid.uuid4().hex[:8]}")
+    t.setdefault("state", "planned")
+    t.setdefault("name", t.get("kind", "tactic"))
+    (validated,) = _validate_tactics([t])
+    plan = cs.get_operation_plan(sid) or {
+        "session_id": sid, "title": "Operate session", "goal": "", "tactics": []
+    }
+    plan.setdefault("tactics", []).append(validated)
+    plan["updated_reason"] = "operate tactic appended"
+    cs.set_operation_plan(sid, plan)
+    return validated
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 2f579e7a..72886c73 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -856,6 +856,48 @@ async def set_embryo_roles(payload: dict = Body(...)):  # noqa: B008
             logger.debug("notify_embryos_changed failed", exc_info=True)
         return {"success": True, "updated": updated}
 
+    @router.post("/api/operate/run-tactic", dependencies=[Depends(require_control)])
+    async def operate_run_tactic(payload: dict = Body(...)):  # noqa: B008
+        """Append a tactic to the session Operation Plan and execute it via the
+        Tactic Executor (resolve scope → dispatch by kind to the orchestrator).
+
+        Body: {tactic: {...}} OR {library_id: "..."} (instantiate a saved tactic);
+        optional {embryo_ids: [...]} to re-scope it to the marked set.
+        Returns {success, tactic_id, result}.
+        """
+        from gently.app.orchestration.tactic_executor import (
+            append_tactic_to_plan,
+            execute_tactic,
+        )
+
+        agent = _require_agent_with_experiment()
+        tactic = payload.get("tactic")
+        lib_id = payload.get("library_id")
+        if tactic is None and lib_id:
+            cs = getattr(agent, "context_store", None)
+            if cs is None:
+                raise HTTPException(status_code=503, detail="No context store")
+            tactic = cs.apply_tactic(lib_id)
+            if tactic is None:
+                raise HTTPException(status_code=404, detail=f"tactic '{lib_id}' not found")
+        if not isinstance(tactic, dict):
+            raise HTTPException(status_code=400, detail="tactic or library_id required")
+
+        eids = payload.get("embryo_ids")
+        if eids:
+            tactic = dict(tactic)
+            tactic["scope"] = {"mode": "embryos", "embryo_ids": list(eids)}
+
+        stored = append_tactic_to_plan(agent, tactic)
+        if stored is None:
+            raise HTTPException(status_code=503, detail="No session to attach the tactic to")
+        try:
+            result = await execute_tactic(agent, stored)
+        except Exception as exc:
+            logger.exception("run-tactic execution failed")
+            raise HTTPException(status_code=502, detail=f"tactic execution failed: {exc}") from exc
+        return {"success": bool(result.get("ok")), "tactic_id": stored.get("id"), "result": result}
+
     @router.get("/api/operation_plan")
     async def get_operation_plan_route():
         """Current session's Operation Plan (the tactics document), for the
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 79418fbd..67494294 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -650,8 +650,11 @@ const OperateManager = (function () {
         } catch (_) { D['op-lib-list'].innerHTML = '<div class="op-empty">Library unavailable</div>'; }
     }
     function loadPlanItems() {
-        // Phase 3 wires the resume_plan candidate list.
-        if (D['op-plan-list']) D['op-plan-list'].innerHTML = '<div class="op-empty">Plan linking — coming in the tactics phase</div>';
+        // Plan resolution lives in the agent (resume_plan + execute_plan_item);
+        // Start hands the roster to the agent to attach + continue the right item.
+        if (D['op-plan-list']) {
+            D['op-plan-list'].innerHTML = '<div class="op-empty">Start hands these embryos to the agent to attach a plan item and continue imaging.</div>';
+        }
     }
 
     async function applyRoles() {
@@ -662,6 +665,11 @@ const OperateManager = (function () {
 
     async function startRun() {
         if (_runMode === 'manual') {
+            // record a cosmetic oneshot tactic so even a manual sweep shows on the spine
+            postJSON('/api/operate/run-tactic', {
+                tactic: { kind: 'oneshot', name: 'Manual sweep', structure: { note: 'manual one-by-one' } },
+                embryo_ids: _embryos.map(e => e.id),
+            }).catch(() => {});
             _runState = null;
             if (_embryos.length) selectEmbryo(_embryos[0].id);
             return;
@@ -687,25 +695,37 @@ const OperateManager = (function () {
             } finally { D['op-run-start'].disabled = false; D['op-run-start'].textContent = 'Start run'; }
             return;
         }
-        if (_runMode === 'agent') {
-            const roster = _embryos.map(e => {
-                const xy = resolveXY(e);
-                const r = _roles[e.id] === 'calibration' ? 'reference' : 'subject';
-                return `${labelFor(e)}${xy ? ` (${xy.x.toFixed(0)},${xy.y.toFixed(0)})` : ''} [${r}]`;
-            }).join(', ');
+        const roster = _embryos.map(e => {
+            const xy = resolveXY(e);
+            const r = _roles[e.id] === 'calibration' ? 'reference' : 'subject';
+            return `${labelFor(e)}${xy ? ` (${xy.x.toFixed(0)},${xy.y.toFixed(0)})` : ''} [${r}]`;
+        }).join(', ');
+
+        if (_runMode === 'library') {
+            if (!_selectedLib) { toast('Pick a saved tactic'); return; }
+            D['op-run-start'].disabled = true; D['op-run-start'].textContent = 'Starting…';
+            try {
+                const d = await postJSON('/api/operate/run-tactic', { library_id: _selectedLib, embryo_ids });
+                if (d.success) {
+                    _runMeta = { mode: 'library', n: embryo_ids.length };
+                    _runState = 'running'; _runPaused = false; toast('Tactic started'); renderStep();
+                } else { toast(`Run failed: ${(d.result && d.result.message) || '?'}`); }
+            } catch (e) { toast(`Start failed (${e.status || e.message})`); }
+            finally { D['op-run-start'].disabled = false; D['op-run-start'].textContent = 'Start run'; }
+            return;
+        }
+        if (_runMode === 'plan' || _runMode === 'agent') {
+            // The agent owns plan resolution + composed tactics; hand off the roster.
+            const prompt = _runMode === 'plan'
+                ? `Continue a plan on these ${_embryos.length} marked embryos — attach this session to the right plan item and start imaging: ${roster}.`
+                : `I marked ${_embryos.length} embryos: ${roster}. Propose and start an Operation Plan to image them.`;
             if (typeof AgentChat !== 'undefined' && AgentChat.togglePanel) {
                 AgentChat.togglePanel(true);
-                if (AgentChat.runCommand) {
-                    setTimeout(() => AgentChat.runCommand(
-                        `I marked ${_embryos.length} embryos: ${roster}. Propose and start an Operation Plan to image them.`), 300);
-                }
+                if (AgentChat.runCommand) setTimeout(() => AgentChat.runCommand(prompt), 300);
             } else { toast('Agent chat unavailable'); }
             _runState = 'running'; renderStep();
             return;
         }
-        if (_runMode === 'library' || _runMode === 'plan') {
-            toast('Library / plan run — wired in the tactics phase');  // Phase 3
-        }
     }
 
     async function renderRunSpine() {
diff --git a/tests/test_tactic_executor.py b/tests/test_tactic_executor.py
new file mode 100644
index 00000000..8f7d71ba
--- /dev/null
+++ b/tests/test_tactic_executor.py
@@ -0,0 +1,149 @@
+"""
+Tests for app.orchestration.tactic_executor — the deterministic mapping from a
+declarative tactic to orchestrator actions (the first caller of
+resolve_scope_embryos).
+
+Covers: scope resolution (embryos/role/global/empty), kind dispatch
+(standing_timelapse + monitoring, reactive_monitor, exclusive_burst, oneshot),
+unknown-kind handling, and the transition_tactic 'active' side effect.
+"""
+
+import types
+
+from gently.app.orchestration.tactic_executor import execute_tactic
+
+
+class _Emb:
+    def __init__(self, role):
+        self.role = role
+
+
+class _Orch:
+    def __init__(self):
+        self.start_calls = []
+        self.monitor_calls = []
+        self.burst_calls = []
+
+    async def start(self, embryo_ids=None, stop_condition="manual",
+                    base_interval_seconds=120.0, condition_value=None):
+        self.start_calls.append({
+            "embryo_ids": embryo_ids, "stop_condition": stop_condition,
+            "interval": base_interval_seconds, "condition_value": condition_value,
+        })
+        return "started"
+
+    def enable_monitoring_mode(self, name, embryo_ids=None, **kw):
+        self.monitor_calls.append({"name": name, "embryo_ids": embryo_ids})
+        return f"monitor:{name}"
+
+    def queue_burst(self, embryo_id, frames=60, mode="1hz", num_slices=1, tactic_id=None, **kw):
+        self.burst_calls.append({"embryo_id": embryo_id, "frames": frames, "tactic_id": tactic_id})
+        return f"Burst queued for {embryo_id}"
+
+
+class _CS:
+    def __init__(self):
+        self.transitions = []
+
+    def transition_tactic(self, session_id, tactic_id, state=None, **bind):
+        self.transitions.append((tactic_id, state))
+        return True
+
+
+def _agent(embryos):
+    exp = types.SimpleNamespace(embryos=embryos)
+    return types.SimpleNamespace(
+        experiment=exp, timelapse_orchestrator=_Orch(),
+        context_store=_CS(), session_id="sess1",
+    )
+
+
+def _roster3():
+    return {"embryo_1": _Emb("test"), "embryo_2": _Emb("test"), "embryo_3": _Emb("calibration")}
+
+
+async def test_standing_timelapse_starts_scoped():
+    agent = _agent(_roster3())
+    t = {"id": "t1", "name": "TL", "kind": "standing_timelapse", "state": "planned",
+         "scope": {"mode": "embryos", "embryo_ids": ["embryo_1", "embryo_2"]},
+         "structure": {"cadence_s": 90, "stop_condition": "manual", "monitoring_mode": "idle"}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is True
+    assert res["embryo_ids"] == ["embryo_1", "embryo_2"]
+    sc = agent.timelapse_orchestrator.start_calls
+    assert len(sc) == 1
+    assert sc[0]["embryo_ids"] == ["embryo_1", "embryo_2"] and sc[0]["interval"] == 90
+    # idle → no monitoring installed
+    assert agent.timelapse_orchestrator.monitor_calls == []
+    # tactic marked active
+    assert ("t1", "active") in agent.context_store.transitions
+
+
+async def test_standing_timelapse_with_monitoring():
+    agent = _agent(_roster3())
+    t = {"id": "t2", "name": "TL", "kind": "standing_timelapse", "state": "planned",
+         "scope": {"mode": "role", "role": "test"},
+         "structure": {"interval": 120, "monitoring_mode": "expression_monitoring"}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is True
+    # role scope → the two 'test' embryos
+    assert sorted(res["embryo_ids"]) == ["embryo_1", "embryo_2"]
+    assert agent.timelapse_orchestrator.monitor_calls[0]["name"] == "expression_monitoring"
+
+
+async def test_reactive_monitor():
+    agent = _agent(_roster3())
+    t = {"id": "t3", "name": "M", "kind": "reactive_monitor", "state": "planned",
+         "scope": {"mode": "global"}, "structure": {"monitoring_mode": "pre_terminal_monitoring"}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is True
+    assert sorted(res["embryo_ids"]) == ["embryo_1", "embryo_2", "embryo_3"]  # global = all
+    assert agent.timelapse_orchestrator.monitor_calls[0]["name"] == "pre_terminal_monitoring"
+
+
+async def test_exclusive_burst_per_embryo():
+    agent = _agent(_roster3())
+    t = {"id": "t4", "name": "B", "kind": "exclusive_burst", "state": "planned",
+         "scope": {"mode": "embryos", "embryo_ids": ["embryo_1", "embryo_3"]},
+         "structure": {"frames": 30}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is True
+    bc = agent.timelapse_orchestrator.burst_calls
+    assert [b["embryo_id"] for b in bc] == ["embryo_1", "embryo_3"]
+    assert all(b["frames"] == 30 and b["tactic_id"] == "t4" for b in bc)
+
+
+async def test_oneshot_recorded_even_without_scope():
+    agent = _agent(_roster3())
+    t = {"id": "t5", "name": "one", "kind": "oneshot", "state": "planned",
+         "scope": {"mode": "embryos", "embryo_ids": []}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is True  # oneshot tolerated with empty scope
+    assert agent.timelapse_orchestrator.start_calls == []
+
+
+async def test_empty_scope_fails_for_timelapse():
+    agent = _agent(_roster3())
+    t = {"id": "t6", "name": "TL", "kind": "standing_timelapse", "state": "planned",
+         "scope": {"mode": "embryos", "embryo_ids": []}, "structure": {}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is False
+    assert "no embryos" in res["message"]
+    assert agent.timelapse_orchestrator.start_calls == []
+
+
+async def test_unknown_kind():
+    agent = _agent(_roster3())
+    t = {"id": "t7", "name": "x", "kind": "warp_drive", "state": "planned",
+         "scope": {"mode": "global"}}
+    res = await execute_tactic(agent, t)
+    assert res["ok"] is False
+    assert "unknown tactic kind" in res["message"]
+
+
+async def test_no_orchestrator():
+    agent = types.SimpleNamespace(experiment=types.SimpleNamespace(embryos=_roster3()),
+                                  timelapse_orchestrator=None, context_store=_CS(), session_id="s")
+    res = await execute_tactic(agent, {"id": "t", "kind": "standing_timelapse",
+                                       "scope": {"mode": "global"}, "structure": {}})
+    assert res["ok"] is False and res["message"] == "no orchestrator"

From 2d4e959c6acc0fe65a9fb811b70b00d1027ea8c0 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 00:35:29 +0530
Subject: [PATCH 280/314] fix(operate): resolve 8 confirmed code-review
 findings
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adversarial review (Opus workflow, 8/8 confirmed) → all fixed:
- HIGH: Run chooser was a one-time gate (unreachable after a manual run or
  Survey/mark-more). The 'Run' stepper node is now a clickable re-entry to the
  chooser; finishing a manual sweep returns to the chooser, not Focus.
- MED: timelapse/start seeded scope embryos:[] when embryo_ids omitted (run images
  ALL) → now records {mode:'global'} so the plan matches the run.
- MED: B1 (Center) showed a frozen frame — the chooser stops all cameras and B1
  had no Start button. Bottom cam now auto-starts at B1 (live centering feedback).
- MED: adaptive 'after N timepoints' degraded to manual (never stops) — now sends
  the combined 'timepoints:N' / 'duration:Nh' form the parser understands.
- MED: stop/pause/resume never reconciled the seeded tactic + every Start appended
  a new active one → accumulating stale/duplicate active timelapses. Now: seeded
  tactics are tagged + linked to the run; stop→done, pause→paused, resume→active;
  prior active operate tactics are retired on a new Start; skip seeding when start
  was a no-op ('already running').
- LOW: run-tactic 500 on a malformed tactic → 400 + append_tactic_to_plan defaults
  kind='custom'.
- LOW: run-spine fallback hard-coded the adaptive shape ('undefineds' for a library
  run) → branches on mode, guards the interval interpolation.
- LOW: manual mode discarded chooser role toggles → applyRoles() now runs for every
  mode (moved to the top of startRun).

Verified in-browser (chooser re-entry, 400 path) + 16 unit tests green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/orchestration/tactic_executor.py |  1 +
 gently/ui/web/routes/data.py                | 75 ++++++++++++++++-----
 gently/ui/web/static/css/operate.css        |  3 +
 gently/ui/web/static/js/operate.js          | 60 ++++++++++++++---
 4 files changed, 113 insertions(+), 26 deletions(-)

diff --git a/gently/app/orchestration/tactic_executor.py b/gently/app/orchestration/tactic_executor.py
index 0d13aca0..c54a87c8 100644
--- a/gently/app/orchestration/tactic_executor.py
+++ b/gently/app/orchestration/tactic_executor.py
@@ -133,6 +133,7 @@ def append_tactic_to_plan(agent, tactic: dict) -> dict | None:
         return None
     t = dict(tactic)
     t.setdefault("id", f"op_{uuid.uuid4().hex[:8]}")
+    t.setdefault("kind", "custom")
     t.setdefault("state", "planned")
     t.setdefault("name", t.get("kind", "tactic"))
     (validated,) = _validate_tactics([t])
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 72886c73..a58a8cc0 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -888,7 +888,10 @@ async def operate_run_tactic(payload: dict = Body(...)):  # noqa: B008
             tactic = dict(tactic)
             tactic["scope"] = {"mode": "embryos", "embryo_ids": list(eids)}
 
-        stored = append_tactic_to_plan(agent, tactic)
+        try:
+            stored = append_tactic_to_plan(agent, tactic)
+        except ValueError as exc:
+            raise HTTPException(status_code=400, detail=f"invalid tactic: {exc}") from exc
         if stored is None:
             raise HTTPException(status_code=503, detail="No session to attach the tactic to")
         try:
@@ -1150,45 +1153,62 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
         seeded_tactics: list[str] = []
         cs = getattr(agent, "context_store", None)
         sid = getattr(agent, "session_id", None)
-        if cs is not None and sid:
+        # Skip seeding when start was a no-op ("already running") — don't append a
+        # phantom active tactic for a run we didn't start.
+        already_running = isinstance(result, str) and result.startswith("Timelapse already running")
+        if cs is not None and sid and not already_running:
             try:
                 import uuid as _uuid
 
                 from gently.app.tools.operation_plan_tools import _validate_tactics
 
+                # Scope mirrors what orchestrator.start actually does: an omitted
+                # embryo_ids images ALL active embryos → record global, not [].
                 eids = list(embryo_ids or [])
+                seed_scope = {"mode": "embryos", "embryo_ids": eids} if eids else {"mode": "global"}
                 st_id = f"op_{_uuid.uuid4().hex[:8]}"
                 new_tactics = [
                     {
                         "id": st_id, "name": "Adaptive timelapse",
                         "kind": "standing_timelapse", "state": "active",
-                        "scope": {"mode": "embryos", "embryo_ids": eids},
+                        "scope": dict(seed_scope),
                         "structure": {
                             "cadence_s": interval_seconds, "interval": interval_seconds,
                             "stop_condition": stop_condition, "condition_value": condition_value,
                             "monitoring_mode": monitoring_mode or "idle",
                         },
                         "rationale": "Started from the Operate Run step.",
-                        "live_bind": ["cadence"], "relations": {}, "live": {},
+                        "live_bind": ["cadence"], "relations": {}, "live": {}, "source": "operate",
                     }
                 ]
                 if monitoring_mode and monitoring_mode != "idle":
                     new_tactics.append({
                         "id": f"op_{_uuid.uuid4().hex[:8]}", "name": "Monitor",
                         "kind": "reactive_monitor", "state": "active",
-                        "scope": {"mode": "embryos", "embryo_ids": eids},
+                        "scope": dict(seed_scope),
                         "structure": {"monitoring_mode": monitoring_mode, "status": "armed"},
                         "rationale": f"{monitoring_mode} on the marked subjects.",
-                        "live_bind": ["signal"], "relations": {"layered_on": [st_id]}, "live": {},
+                        "live_bind": ["signal"], "relations": {"layered_on": [st_id]},
+                        "live": {}, "source": "operate",
                     })
                 new_tactics = _validate_tactics(new_tactics)
                 plan = cs.get_operation_plan(sid) or {
                     "session_id": sid, "title": "Operate session", "goal": "", "tactics": []
                 }
-                plan.setdefault("tactics", []).extend(new_tactics)
+                # Reconcile: retire any prior still-'active' operate-seeded tactics
+                # so repeated Start clicks don't accumulate stale active timelapses.
+                for t in plan.setdefault("tactics", []):
+                    if t.get("source") == "operate" and t.get("state") == "active":
+                        t["state"] = "done"
+                plan["tactics"].extend(new_tactics)
                 plan["updated_reason"] = "operate adaptive timelapse"
                 cs.set_operation_plan(sid, plan)
                 seeded_tactics = [t["id"] for t in new_tactics]
+                # Link the run to its tactics so stop/pause/resume can reconcile them.
+                try:
+                    orchestrator._operate_tactic_ids = list(seeded_tactics)
+                except Exception:
+                    pass
             except Exception:
                 logger.debug("timelapse tactic seeding skipped", exc_info=True)
 
@@ -1207,20 +1227,41 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
             },
         }
 
-    def _resolve_orchestrator():
+    def _resolve_orch_and_agent():
         bridge = getattr(server, "agent_bridge", None)
         agent = bridge.agent if bridge is not None else None
-        return getattr(agent, "timelapse_orchestrator", None) if agent else None
+        orch = getattr(agent, "timelapse_orchestrator", None) if agent else None
+        return orch, agent
+
+    def _reconcile_operate_tactics(orch, agent, state: str, clear: bool):
+        """Transition the run's operate-seeded tactics to ``state`` so the
+        Operation Plan / run-spine reflect stop/pause/resume. Best-effort."""
+        cs = getattr(agent, "context_store", None)
+        sid = getattr(agent, "session_id", None)
+        ids = list(getattr(orch, "_operate_tactic_ids", []) or [])
+        if cs is not None and sid and ids:
+            for tid in ids:
+                try:
+                    cs.transition_tactic(sid, tid, state)
+                except Exception:
+                    logger.debug("transition_tactic %s failed", tid, exc_info=True)
+        if clear:
+            try:
+                orch._operate_tactic_ids = []
+            except Exception:
+                pass
 
     @router.post("/api/devices/timelapse/stop", dependencies=[Depends(require_control)])
     async def timelapse_stop(payload: dict = Body(default={})):  # noqa: B008
         """Stop the running timelapse (Operate run-spine). Body: {reason?}."""
-        orch = _resolve_orchestrator()
+        orch, agent = _resolve_orch_and_agent()
         if orch is None:
             raise HTTPException(status_code=503, detail="No timelapse orchestrator")
         try:
             reason = str(payload.get("reason", "user_request"))
-            return {"stopped": True, "result": await orch.stop(reason=reason)}
+            res = await orch.stop(reason=reason)
+            _reconcile_operate_tactics(orch, agent, "done", clear=True)
+            return {"stopped": True, "result": res}
         except Exception as exc:
             logger.exception("Timelapse stop failed")
             raise HTTPException(status_code=502, detail=f"timelapse stop failed: {exc}") from exc
@@ -1228,11 +1269,13 @@ async def timelapse_stop(payload: dict = Body(default={})):  # noqa: B008
     @router.post("/api/devices/timelapse/pause", dependencies=[Depends(require_control)])
     async def timelapse_pause():
         """Pause the running timelapse."""
-        orch = _resolve_orchestrator()
+        orch, agent = _resolve_orch_and_agent()
         if orch is None:
             raise HTTPException(status_code=503, detail="No timelapse orchestrator")
         try:
-            return {"paused": True, "result": await orch.pause()}
+            res = await orch.pause()
+            _reconcile_operate_tactics(orch, agent, "paused", clear=False)
+            return {"paused": True, "result": res}
         except Exception as exc:
             logger.exception("Timelapse pause failed")
             raise HTTPException(status_code=502, detail=f"timelapse pause failed: {exc}") from exc
@@ -1240,11 +1283,13 @@ async def timelapse_pause():
     @router.post("/api/devices/timelapse/resume", dependencies=[Depends(require_control)])
     async def timelapse_resume():
         """Resume a paused timelapse."""
-        orch = _resolve_orchestrator()
+        orch, agent = _resolve_orch_and_agent()
         if orch is None:
             raise HTTPException(status_code=503, detail="No timelapse orchestrator")
         try:
-            return {"resumed": True, "result": await orch.resume()}
+            res = await orch.resume()
+            _reconcile_operate_tactics(orch, agent, "active", clear=False)
+            return {"resumed": True, "result": res}
         except Exception as exc:
             logger.exception("Timelapse resume failed")
             raise HTTPException(status_code=502, detail=f"timelapse resume failed: {exc}") from exc
diff --git a/gently/ui/web/static/css/operate.css b/gently/ui/web/static/css/operate.css
index 01e906f5..e91dcc37 100644
--- a/gently/ui/web/static/css/operate.css
+++ b/gently/ui/web/static/css/operate.css
@@ -60,6 +60,9 @@
 .op-node.is-done::before { content: "✓ "; }
 .op-node.is-active { color: var(--text); border-color: var(--accent); background: color-mix(in srgb, var(--accent) 14%, transparent); }
 .op-node.is-locked { opacity: 0.4; }
+/* the Run node is a re-entry point to the chooser once embryos are marked */
+.op-stepper .op-node[data-node="run"]:not(.is-locked) { cursor: pointer; }
+.op-stepper .op-node[data-node="run"]:not(.is-locked):hover { color: var(--accent); }
 
 .op-status {
     display: flex;
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 67494294..53e37e4e 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -37,7 +37,7 @@ const OperateManager = (function () {
     let _acquiring = false;
 
     // viewport / streams
-    let _camOn = false, _spimOn = false;
+    let _camOn = false, _spimOn = false, _camStarting = false;
     let _lastFrame = null;           // last live bottom-cam payload
     let _lastSpimFrame = null;
     let _bzScore = null, _spimScore = null;
@@ -165,6 +165,14 @@ const OperateManager = (function () {
                 : (cam === 'bottom' ? 'Bottom cam' : 'SPIM · side A') + ' — ' + RAIL_HEADS[step].toLowerCase();
         }
         ensureInactiveCameraStopped(cam);
+        // B1 (Center) needs a live bottom view but has no Start button (the
+        // chooser stops all cameras) — auto-start it so centering has feedback.
+        if (step === 'b1' && !_camOn && !_camStarting && !_marking) {
+            _camStarting = true;
+            fetch('/api/devices/bottom_camera/stream/start', { method: 'POST' })
+                .then(r => r.json()).then(d => { _camStarting = false; applyCam(!!d.streaming); })
+                .catch(() => { _camStarting = false; });
+        }
         // show the right frame
         if (cam === 'bottom' && !_marking && _lastFrame) setImg(_lastFrame);
         else if (cam === 'spim' && _lastSpimFrame) setImg(_lastSpimFrame);
@@ -576,7 +584,12 @@ const OperateManager = (function () {
             _headLowered = false; _fdFloor = null;
             const next = _embryos.find(e => _states[e.id] !== 'imaged');
             if (next) { selectEmbryo(next.id); toast(`Next: embryo ${labelFor(next)}`); }
-            else { _selected = null; _step = null; renderStep(); toast('All embryos imaged'); }
+            else {
+                // Done imaging — return to the Run chooser (not Focus) so another
+                // run mode can be chosen for the same marked set.
+                _selected = null; _step = null; _runState = 'choose'; renderStep();
+                toast('All embryos imaged');
+            }
         } finally { D['op-retract'].disabled = false; }
     }
 
@@ -664,6 +677,8 @@ const OperateManager = (function () {
     }
 
     async function startRun() {
+        // Persist the chooser's role toggles for EVERY mode (manual included).
+        await applyRoles();
         if (_runMode === 'manual') {
             // record a cosmetic oneshot tactic so even a manual sweep shows on the spine
             postJSON('/api/operate/run-tactic', {
@@ -674,19 +689,23 @@ const OperateManager = (function () {
             if (_embryos.length) selectEmbryo(_embryos[0].id);
             return;
         }
-        await applyRoles();
         const subjects = _embryos.filter(e => (_roles[e.id] || 'test') !== 'calibration').map(e => e.id);
         const embryo_ids = subjects.length ? subjects : _embryos.map(e => e.id);
         if (_runMode === 'adaptive') {
             const interval = Math.max(1, Number(D['op-tl-interval'].value) || 120);
-            const stop = D['op-tl-stop'].value;
+            const stopSel = D['op-tl-stop'].value;
             const monitoring = D['op-tl-monitor'].value;
-            const body = { embryo_ids, interval_seconds: interval, stop_condition: stop, monitoring_mode: monitoring };
-            if (stop === 'timepoints' || stop === 'duration') body.condition_value = Math.max(1, Number(D['op-tl-condval'].value) || 1);
+            // Send the combined stop form the orchestrator parser understands
+            // ('timepoints:N' / 'duration:Xh'); a bare 'timepoints' silently
+            // degrades to manual (never stops).
+            let stop_condition = stopSel;
+            if (stopSel === 'timepoints') stop_condition = `timepoints:${Math.max(1, Number(D['op-tl-condval'].value) || 1)}`;
+            else if (stopSel === 'duration') stop_condition = `duration:${Math.max(1, Number(D['op-tl-condval'].value) || 1)}h`;
+            const body = { embryo_ids, interval_seconds: interval, stop_condition, monitoring_mode: monitoring };
             D['op-run-start'].disabled = true; D['op-run-start'].textContent = 'Starting…';
             try {
                 await postJSON('/api/devices/timelapse/start', body);
-                _runMeta = { mode: 'adaptive', interval, stop, monitoring, n: embryo_ids.length };
+                _runMeta = { mode: 'adaptive', interval, stop: stop_condition, monitoring, n: embryo_ids.length };
                 _runState = 'running'; _runPaused = false;
                 toast(`Adaptive timelapse started — ${embryo_ids.length} subject${embryo_ids.length === 1 ? '' : 's'}`);
                 renderStep();
@@ -736,12 +755,22 @@ const OperateManager = (function () {
         if (tactics.length) {
             tactics.forEach(t => D['op-runspine'].appendChild(tacticCard(t)));
         } else if (_runMeta) {
-            const stopTxt = _runMeta.stop === 'manual' ? 'until stopped' : _runMeta.stop;
+            // Fallback card when the plan fetch is empty/failed — shaped per mode
+            // (a library run carries no interval/stop/monitoring).
+            const n = _runMeta.n || 0;
+            const subj = `${n} subject${n === 1 ? '' : 's'}`;
             const card = document.createElement('div');
             card.className = 'op-tcard st-active';
-            card.innerHTML = '<div class="op-tcard-head"><span class="op-tcard-name">Adaptive timelapse</span><span class="op-tcard-state">active</span></div>'
-                + `<div class="op-tcard-kind">standing_timelapse · ${escapeHtml(_runMeta.monitoring)}</div>`
-                + `<div class="op-tcard-meta">${_runMeta.interval}s · ${_runMeta.n} subject${_runMeta.n === 1 ? '' : 's'} · ${escapeHtml(stopTxt)}</div>`;
+            if (_runMeta.mode === 'adaptive') {
+                const stopTxt = (_runMeta.stop === 'manual' || _runMeta.stop == null) ? 'until stopped' : _runMeta.stop;
+                const ivl = _runMeta.interval != null ? `${escapeHtml(String(_runMeta.interval))}s · ` : '';
+                card.innerHTML = '<div class="op-tcard-head"><span class="op-tcard-name">Adaptive timelapse</span><span class="op-tcard-state">active</span></div>'
+                    + `<div class="op-tcard-kind">standing_timelapse · ${escapeHtml(_runMeta.monitoring || 'idle')}</div>`
+                    + `<div class="op-tcard-meta">${ivl}${subj} · ${escapeHtml(stopTxt)}</div>`;
+            } else {
+                card.innerHTML = '<div class="op-tcard-head"><span class="op-tcard-name">Tactic</span><span class="op-tcard-state">active</span></div>'
+                    + `<div class="op-tcard-meta">${subj}</div>`;
+            }
             D['op-runspine'].appendChild(card);
         } else {
             D['op-runspine'].innerHTML = '<div class="op-empty">Run active.</div>';
@@ -807,6 +836,15 @@ const OperateManager = (function () {
         D['op-acquire'].addEventListener('click', acquireSelected);
         D['op-retract'].addEventListener('click', retractAndAdvance);
         D['op-survey-btn'].addEventListener('click', surveyMore);
+        // Re-enter the Run chooser by clicking the "Run" stepper node — so a
+        // different run mode can be chosen for an already-marked set (e.g. after
+        // a manual sweep). Without this the chooser is a one-time gate.
+        if (D['op-stepper']) D['op-stepper'].addEventListener('click', e => {
+            const n = e.target.closest('.op-node');
+            if (n && n.dataset.node === 'run' && _embryos.length && !_marking && _runState !== 'running') {
+                _selected = null; _step = null; _runState = 'choose'; renderStep();
+            }
+        });
         // Phase C: Run chooser + run-spine
         document.querySelectorAll('input[name="op-mode"]').forEach(r =>
             r.addEventListener('change', () => { _runMode = r.value; renderChooser(); }));

From c02d52d090107f41f4ee82343f7cb966d01598ce Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 08:09:48 +0530
Subject: [PATCH 281/314] =?UTF-8?q?docs(spec):=20settings=20panel=20?=
 =?UTF-8?q?=E2=80=94=20editable=20ACUITYnano=20thermalizer=20+=20config=20?=
 =?UTF-8?q?visibility?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Opus audit: settings panel is 100% localStorage display prefs; the thermalizer
connection (serial/MQTT/mock) is YAML-only + device-layer-restart. Design: a
server-backed Hardware/Thermalizer section (Test + live hot-swap w/ restart
fallback, sidecar persistence, secrets redacted), Mock dev-only, + a read-only
effective-config viewer. Decisions: full build; live-swap w/ restart fallback;
Mock dev-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 ...ettings-panel-thermalizer-config-design.md | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-07-01-settings-panel-thermalizer-config-design.md

diff --git a/docs/superpowers/specs/2026-07-01-settings-panel-thermalizer-config-design.md b/docs/superpowers/specs/2026-07-01-settings-panel-thermalizer-config-design.md
new file mode 100644
index 00000000..8527455b
--- /dev/null
+++ b/docs/superpowers/specs/2026-07-01-settings-panel-thermalizer-config-design.md
@@ -0,0 +1,60 @@
+# Settings Panel — editable ACUITYnano thermalizer + config visibility — Design
+
+Date: 2026-07-01
+Status: Approved (build all phases)
+Branch: feature/temperature-operations-all (→ #72)
+Source: Opus audit workflow + two implementation-reference passes.
+
+## Problem / audit
+
+The gently "Settings" panel is **100% client-side display preferences** — every control writes browser `localStorage` (`gently-dashboard-config` + `gently-theme`); `settings.js` makes **zero** backend calls. The **ACUITYnano thermalizer connection** (serial COM / MQTT-HiveMQ / mock) is in **no GUI** — it lives in `config/config.yml` `temperature:`, read once at device-layer boot; changing transport/port/creds = edit YAML + restart. Naming trap: the Vitals "Temperature model (20/25 °C)" radio is a *developmental-timing reference curve*, not the hardware setpoint.
+
+Two-process: viz (FastAPI :8080) proxies to the device layer (aiohttp :60610) via `DiSPIMClient`; the controller lives only in the device-layer process.
+
+## Decisions (user)
+
+- Build **all phases**.
+- Apply mode: **try live hot-swap, fall back to restart-required**.
+- **Mock-SIM: dev/debug only** — not selectable in the production panel.
+
+## Design
+
+New server-backed **"Hardware / Thermalizer"** section (separate from the localStorage panel; explicit "machine-wide, saved on the server" note). Fields grounded in `temperature.py`:
+- Backend radio **Serial | MQTT (HiveMQ)** (Mock hidden unless a dev flag). Serial: `com_port` (required), `baud_rate` (115200). MQTT: `broker`, `port` (8883), `user`, `password` (write-only, `••••`, never echoed; blank = embedded HiveMQ SIM). Common: `stabilize_timeout` (600), `feedback_peltier`.
+- **Test connection** (non-committing): build transient backend → `read()`/`get_system_state` → `close()` → report; never swaps the live device.
+- **Apply**: live hot-swap — build the NEW controller first (`create_temperature_controller`), keep the old on failure, swap `self.devices["temperature"]`, `old.close()`. Guard: **409 if `self.RE.state != "idle"`** or a `set()` worker holds the controller lock (mid-ramp/mid-plan swap corrupts a live `bps.mv(temperature,…)`). If teardown/rebuild can't apply live, persist + "restart the device layer to apply" banner.
+- **Persistence**: sidecar `config/config.local.yml` (`temperature:` block) merged over `config.yml` at device-layer boot — preserves `config.yml`'s comments; password written only when a new non-redacted value is submitted.
+
+**Effective-config viewer** (Phase 2, read-only, secrets redacted): ports/hosts, model IDs, storage base_path + derived dirs, mmconfig/mmdirectory, organism/hardware, switchbot name, coverslip, XY safety envelope (from the live device-state stream), mesh instance-id + cert fingerprint, timeouts, ML params, `ux_v2`. **Never expose** (redact/omit): `ANTHROPIC_API_KEY`, `GENTLY_CONTROL_TOKEN`, `mesh_key.pem`, MQTT creds.
+
+## Call chain (per new capability)
+Browser `fetch('/api/devices/temperature/config…')` → FastAPI `routes/data.py` (`require_control` on mutations) → `_resolve_client().<m>()` → `client.py` `_api_*` → device-layer `handle_*` → `self.devices["temperature"]`.
+
+## Phasing / changes
+
+**Phase 0 (visibility + test):**
+- device-layer: `GET /api/temperature/config` (current `temperature` block, password redacted, + live backend + `read()` state); `POST /api/temperature/config/test` (transient backend probe). Register in `on_start` (~:3394).
+- client: `get_temperature_config`, `test_temperature_config`.
+- viz: `GET /api/devices/temperature/config` (read-only), `POST /api/devices/temperature/config/test` (`require_control`).
+- UI: read-only Hardware/Thermalizer section + Test button (a separate `ThermalizerSettings` JS object, isolated from `SettingsManager`); relabel the Vitals "Temperature model" field.
+
+**Phase 1 (editable + live reconnect):**
+- device-layer: `POST /api/temperature/config` (validate; 409 guard; build-new-before-swap; sidecar persist; return live state); boot-merge sidecar over `config.yml` `temperature` (after `yaml.safe_load` ~:227).
+- client: `set_temperature_config`. viz: `POST /api/devices/temperature/config` (`require_control`).
+- UI: editable Serial/MQTT form (Mock dev-only), Apply (no auto-save), applied-live vs restart-required banner.
+
+**Phase 2 (visibility + prefs):**
+- viz `GET /api/config/effective` (read-only, redacted) + a read-only "Effective config" viewer in the panel.
+- Server-side dashboard-pref **defaults** + reset/export/import (viz route storing rig defaults in a file; `settings.js` layers over localStorage).
+- Restart-required editors for SAFE `settings.py` knobs (timeouts, mesh timing, ML, `ux_v2`, NCBI) via a `config/settings.local.yml`/env override read at launch, with an explicit "restart required" path (never mutate the frozen `settings` singleton live). If the launcher-override mechanism proves out-of-scope, ship the viewer + pref-defaults and defer the editors.
+
+## Safety
+- Never echo the MQTT password (redact on GET; persist only on new value). Redact all secrets in the effective-config viewer.
+- `require_control` on every config write/test proxy.
+- 409 reconfigure guard while RE running / lock held; build-new-before-swap so a bad config never leaves the rig with no thermalizer.
+- Keep the 0.0–99.9 °C clamp in both layers; GUI can't widen it.
+- Sidecar persistence (not `config.yml` rewrite); restrict perms on any file holding the plaintext MQTT password.
+- Restart-required for frozen `settings.py` values — write override + prompt restart, never live-mutate.
+
+## Rig-only / honesty
+The vendor SDK (`acuitynano_precision_thermalizer_*`) isn't on PyPI and isn't installed in the hardware-free shim, so **serial/MQTT construction, Test, and live-swap are rig-verified**; the shim path exercises routes + validation + the mock backend + UI flow. Live hot-swap's clean teardown per transport needs on-rig confirmation (fallback = restart banner).

From b47ab66b4db6542ec371e1816aa2091c48adf21e Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 09:19:52 +0530
Subject: [PATCH 282/314] feat(settings): editable ACUITYnano thermalizer +
 effective-config viewer
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Settings panel was 100% localStorage display prefs. Adds a server-backed
'Hardware / Thermalizer' section to view + edit the controller connection, and a
read-only effective-config viewer.

Device layer (aiohttp): GET /api/temperature/config (redacted), POST
/api/temperature/config/test (transient probe, non-committing), POST
/api/temperature/config (live hot-swap: 409 if RunEngine running / ramp lock held,
build-new-before-swap, close old, sidecar-persist; restart-required fallback on
connect failure). config.local.yml sidecar merged over config.yml at boot (keeps
comments; 0600 perms for the MQTT password). Validator + password redaction.

Client: get/set/test_temperature_config. Viz proxies (require_control on
write/test) + GET /api/config/effective (settings.py + config.yml, secrets shown
as present/absent booleans; restart-required note).

UI: Hardware nav group; Thermalizer section (Serial/MQTT; Mock dev-only via
?dev=1) with Test + Apply (explicit, no auto-save), applied-live vs
restart-required banner; a separate ThermalizerSettings JS module isolated from
the localStorage SettingsManager; read-only Effective-config viewer. Relabeled the
Vitals 'Temperature model' → 'Developmental-timing reference' to kill the naming
trap.

Verified in-browser (render, serial↔MQTT toggle, Mock-hidden, Test graceful 502,
effective-config populated). Rig-only: real serial/MQTT connect + live-swap need
the vendor SDK + device layer (shim shows 'not available'/502 gracefully).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/client.py       |  13 ++
 gently/hardware/dispim/device_layer.py | 220 +++++++++++++++++++++++++
 gently/ui/web/routes/data.py           |  95 +++++++++++
 gently/ui/web/static/css/main.css      |  29 ++++
 gently/ui/web/static/js/settings.js    | 147 +++++++++++++++++
 gently/ui/web/templates/settings.html  |  53 +++++-
 6 files changed, 556 insertions(+), 1 deletion(-)

diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index b4461436..cad5fd98 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -870,6 +870,19 @@ async def get_temperature(self) -> dict:
         """Get current temperature, setpoint, and lock state."""
         return await self._api_get("/api/temperature/status")
 
+    async def get_temperature_config(self) -> dict:
+        """Get the thermalizer connection config (password redacted) + live state."""
+        return await self._api_get("/api/temperature/config")
+
+    async def set_temperature_config(self, cfg: dict) -> dict:
+        """Reconfigure the thermalizer (serial/mqtt/mock) — live hot-swap where
+        possible, else persisted for the next device-layer restart."""
+        return await self._api_post("/api/temperature/config", cfg)
+
+    async def test_temperature_config(self, cfg: dict) -> dict:
+        """Probe a candidate thermalizer config without committing it."""
+        return await self._api_post("/api/temperature/config/test", cfg)
+
     # ------------------------------------------------------------------
     # Live device-state readout (streamed from the device layer poller)
     # ------------------------------------------------------------------
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index b40e0e36..0c7690ae 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -225,6 +225,20 @@ async def initialize(self):
         logger.info("[1/5] Loading configuration...")
         with open(self.config_path) as f:
             self.config = yaml.safe_load(f)
+        # Merge operator overrides from config.local.yml over the committed
+        # config.yml (keeps config.yml's comments intact). Currently the
+        # thermalizer block, set live from the settings panel; survives restart.
+        try:
+            sidecar = Path(self.config_path).parent / "config.local.yml"
+            if sidecar.exists():
+                with open(sidecar) as sf:
+                    override = yaml.safe_load(sf) or {}
+                if isinstance(override, dict) and override.get("temperature"):
+                    self.config = self.config or {}
+                    self.config["temperature"] = override["temperature"]
+                    logger.info("Applied thermalizer override from %s", sidecar)
+        except Exception:
+            logger.warning("config.local.yml merge failed", exc_info=True)
         logger.info("Config loaded from %s", self.config_path)
         cui.step_done(str(self.config_path))
 
@@ -2057,6 +2071,208 @@ async def handle_set_temperature(self, request):
                 status=500,
             )
 
+    @staticmethod
+    def _validate_temp_cfg(cfg) -> str | None:
+        """Validate a thermalizer config dict. Returns an error string or None.
+
+        Mirrors what temperature._make_backend / create_temperature_controller
+        require so bad input is rejected before we build a controller.
+        """
+        if not isinstance(cfg, dict):
+            return "config must be an object"
+        backend = str(cfg.get("backend", "serial")).lower()
+        if backend not in ("serial", "mqtt", "mock"):
+            return f"unknown backend {backend!r} (use 'serial', 'mqtt', or 'mock')"
+        if backend == "serial" and not str(cfg.get("com_port") or "").strip():
+            return "serial backend requires com_port"
+        for key in ("baud_rate", "port"):
+            if cfg.get(key) is not None:
+                try:
+                    if int(cfg[key]) <= 0:
+                        return f"{key} must be a positive integer"
+                except (TypeError, ValueError):
+                    return f"{key} must be a positive integer"
+        if cfg.get("stabilize_timeout") is not None:
+            try:
+                if float(cfg["stabilize_timeout"]) <= 0:
+                    return "stabilize_timeout must be > 0"
+            except (TypeError, ValueError):
+                return "stabilize_timeout must be a number"
+        return None
+
+    @staticmethod
+    def _redact_temp_cfg(cfg: dict) -> dict:
+        """Copy of a temperature config with the MQTT password removed."""
+        out = dict(cfg or {})
+        if "password" in out:
+            out["password"] = None
+        return out
+
+    def _temp_state(self, temp) -> dict | None:
+        if temp is None:
+            return None
+        try:
+            r = temp.read()
+            return {
+                "temperature_c": r.get(temp.name, {}).get("value"),
+                "setpoint_c": r.get(f"{temp.name}_setpoint", {}).get("value"),
+                "state": r.get(f"{temp.name}_state", {}).get("value"),
+            }
+        except Exception:
+            return None
+
+    async def handle_get_temperature_config(self, request):
+        """GET /api/temperature/config - current thermalizer config (password
+        redacted) + live backend + read() state, for the settings panel."""
+        try:
+            cfg = dict((self.config or {}).get("temperature") or {})
+            has_pw = bool(cfg.get("password"))
+            temp = self.devices.get("temperature")
+            return web.json_response({
+                "success": True,
+                "config": self._redact_temp_cfg(cfg),
+                "password_set": has_pw,
+                "active": temp is not None,
+                "live_backend": type(temp._dev).__name__ if temp is not None else None,
+                "state": self._temp_state(temp),
+            })
+        except Exception as e:
+            import traceback
+            return web.json_response(
+                {"success": False, "error": str(e), "traceback": traceback.format_exc()},
+                status=500,
+            )
+
+    async def handle_test_temperature_config(self, request):
+        """POST /api/temperature/config/test - probe a candidate config WITHOUT
+        committing. Builds a transient controller, reads state, closes it. Never
+        touches self.devices."""
+        try:
+            cfg = await request.json()
+        except Exception:
+            return web.json_response({"success": False, "error": "invalid JSON body"}, status=400)
+        err = self._validate_temp_cfg(cfg)
+        if err:
+            return web.json_response({"success": False, "error": err}, status=400)
+
+        def _probe():
+            from gently.hardware.temperature import create_temperature_controller
+            tc = create_temperature_controller(cfg)
+            try:
+                r = tc.read()
+                return {
+                    "backend": type(tc._dev).__name__,
+                    "temperature_c": r.get(tc.name, {}).get("value"),
+                    "state": r.get(f"{tc.name}_state", {}).get("value"),
+                }
+            finally:
+                try:
+                    tc.close()
+                except Exception:
+                    pass
+
+        try:
+            result = await asyncio.to_thread(_probe)
+            return web.json_response({"success": True, "result": result})
+        except Exception as e:
+            return web.json_response({"success": False, "error": str(e)}, status=502)
+
+    def _write_temp_sidecar(self, temp_cfg: dict) -> None:
+        """Persist the temperature block to config/config.local.yml (merged over
+        config.yml at boot). Best-effort; 0600 perms since it may hold the MQTT
+        password. Keeps config.yml (and its comments) untouched."""
+        try:
+            import os
+
+            sidecar = Path(self.config_path).parent / "config.local.yml"
+            existing = {}
+            if sidecar.exists():
+                with open(sidecar) as f:
+                    existing = yaml.safe_load(f) or {}
+            existing["temperature"] = temp_cfg
+            with open(sidecar, "w") as f:
+                yaml.safe_dump(existing, f, default_flow_style=False, sort_keys=False)
+            try:
+                os.chmod(sidecar, 0o600)
+            except OSError:
+                pass
+        except Exception:
+            logger.debug("temp sidecar write failed", exc_info=True)
+
+    async def handle_set_temperature_config(self, request):
+        """POST /api/temperature/config - reconfigure the thermalizer live.
+
+        Build-new-before-swap: refuse (409) while the RunEngine is running or a
+        set() worker holds the controller lock; build the NEW controller first
+        (keep the old one on failure); swap self.devices and close the old;
+        persist to the config.local.yml sidecar. On a build/connect failure the
+        intent is still saved and restart_required is returned.
+        """
+        try:
+            cfg = await request.json()
+        except Exception:
+            return web.json_response({"success": False, "error": "invalid JSON body"}, status=400)
+        err = self._validate_temp_cfg(cfg)
+        if err:
+            return web.json_response({"success": False, "error": err}, status=400)
+
+        # --- 409 guard: never swap mid-plan / mid-ramp ---
+        re_state = str(getattr(self.RE, "state", "idle")) if self.RE is not None else "idle"
+        if re_state != "idle":
+            return web.json_response(
+                {"success": False,
+                 "error": f"RunEngine is {re_state}; stop the plan before reconfiguring"},
+                status=409)
+        old = self.devices.get("temperature")
+        lock = getattr(old, "_lock", None)
+        if lock is not None and lock.locked():
+            return web.json_response(
+                {"success": False,
+                 "error": "a temperature ramp is in progress; wait or stop it first"},
+                status=409)
+
+        # Preserve an existing password when the client didn't submit a new one.
+        eff = dict(cfg)
+        if not eff.get("password"):
+            existing_pw = ((self.config or {}).get("temperature") or {}).get("password")
+            if existing_pw:
+                eff["password"] = existing_pw
+            else:
+                eff.pop("password", None)
+
+        # Build the NEW controller first (eager connect off the event loop).
+        def _build():
+            from gently.hardware.temperature import create_temperature_controller
+            return create_temperature_controller(eff)
+
+        try:
+            new_tc = await asyncio.to_thread(_build)
+        except Exception as e:
+            self._write_temp_sidecar(eff)  # save intent; a restart will apply it
+            return web.json_response(
+                {"success": False, "applied": False, "restart_required": True,
+                 "error": f"could not connect with the new config: {e}. "
+                          "Saved — restart the device layer to apply."},
+                status=502)
+
+        # Swap + retire the old controller.
+        self.devices["temperature"] = new_tc
+        if old is not None:
+            try:
+                old.close()
+            except Exception:
+                logger.debug("old temperature controller close failed", exc_info=True)
+        self.config = self.config or {}
+        self.config["temperature"] = eff
+        self._write_temp_sidecar(eff)
+        logger.info("Thermalizer reconfigured live (backend=%s)", eff.get("backend", "serial"))
+        return web.json_response({
+            "success": True, "applied": True, "restart_required": False,
+            "config": self._redact_temp_cfg(eff),
+            "live_backend": type(new_tc._dev).__name__,
+            "state": self._temp_state(new_tc),
+        })
+
     async def handle_set_camera_led_mode(self, request):
         """POST /api/camera/led_mode - Enable/disable automatic LED for bottom camera"""
         try:
@@ -3392,6 +3608,10 @@ async def on_start(self):
         self._app.router.add_post("/api/led/set", self.handle_set_led)
         self._app.router.add_get("/api/temperature/status", self.handle_get_temperature_status)
         self._app.router.add_post("/api/temperature/set", self.handle_set_temperature)
+        self._app.router.add_get("/api/temperature/config", self.handle_get_temperature_config)
+        self._app.router.add_post(
+            "/api/temperature/config/test", self.handle_test_temperature_config)
+        self._app.router.add_post("/api/temperature/config", self.handle_set_temperature_config)
         self._app.router.add_get("/api/room_light/status", self.handle_get_room_light_status)
         self._app.router.add_post("/api/room_light/set", self.handle_set_room_light)
         self._app.router.add_post("/api/camera/led_mode", self.handle_set_camera_led_mode)
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 9b14aaf2..32e26092 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -436,6 +436,101 @@ async def set_temperature(payload: dict = Body(...)):  # noqa: B008
             "waited": res.get("waited", False),
         }
 
+    @router.get("/api/devices/temperature/config")
+    async def get_temperature_config():
+        """Thermalizer connection config (password redacted) + live backend/state
+        for the Settings panel. Read-only, so no control elevation required."""
+        client = _resolve_client()
+        if client is None:
+            return {"available": False}
+        try:
+            res = await client.get_temperature_config()
+        except Exception as exc:
+            logger.debug("temperature config fetch failed: %s", exc)
+            return {"available": False}
+        return {"available": bool(res.get("success", False)), **res}
+
+    @router.post("/api/devices/temperature/config/test", dependencies=[Depends(require_control)])
+    async def test_temperature_config(payload: dict = Body(...)):  # noqa: B008
+        """Probe a candidate thermalizer config without committing it."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            res = await client.test_temperature_config(payload)
+        except Exception as exc:
+            logger.exception("Thermalizer test failed")
+            raise HTTPException(status_code=502, detail=f"thermalizer test failed: {exc}") from exc
+        return res
+
+    @router.post("/api/devices/temperature/config", dependencies=[Depends(require_control)])
+    async def set_temperature_config(payload: dict = Body(...)):  # noqa: B008
+        """Reconfigure the thermalizer (serial/mqtt/mock). Live hot-swap where
+        possible; otherwise persisted for the next device-layer restart."""
+        client = _resolve_client()
+        if client is None:
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+        try:
+            res = await client.set_temperature_config(payload)
+        except Exception as exc:
+            logger.exception("Thermalizer reconfigure failed")
+            raise HTTPException(
+                status_code=502, detail=f"thermalizer reconfigure failed: {exc}") from exc
+        return res
+
+    @router.get("/api/config/effective")
+    async def get_effective_config():
+        """Read-only view of the effective server config, secrets redacted.
+
+        settings.py values are frozen at import (resolved from env vars once), so
+        changing them requires a process restart — surfaced here for visibility,
+        not editing. Secrets are shown only as present/absent booleans.
+        """
+        import os
+
+        from gently.settings import settings as S
+
+        return {
+            "note": "settings.py values are read from env at startup; "
+                    "changing them needs a restart.",
+            "network": {
+                "viz_host": S.network.viz_host, "viz_port": S.network.viz_port,
+                "device_host": S.network.device_host, "device_port": S.network.device_port,
+                "mesh_port": S.network.mesh_port,
+            },
+            "models": {
+                "main": S.models.main, "perception": S.models.perception, "fast": S.models.fast,
+                "medium": S.models.medium, "refusal_fallback": S.models.refusal_fallback,
+            },
+            "storage": {"base_path": str(S.storage.base_path)},
+            "timeouts": {
+                "plan_execution": S.timeouts.plan_execution,
+                "rpc_call": S.timeouts.rpc_call,
+                "volume_acquisition": S.timeouts.volume_acquisition,
+                "api_call": S.timeouts.api_call,
+            },
+            "ml": {
+                "default_batch_size": S.ml.default_batch_size,
+                "default_epochs": S.ml.default_epochs,
+                "default_lr": S.ml.default_lr, "model_cache_dir": str(S.ml.model_cache_dir),
+            },
+            "transfer": {
+                "transfer_port": S.transfer.transfer_port, "chunk_size": S.transfer.chunk_size,
+                "max_concurrent_transfers": S.transfer.max_concurrent_transfers,
+            },
+            "mesh": {
+                "broadcast_interval_s": S.mesh.broadcast_interval_s,
+                "stale_threshold_s": S.mesh.stale_threshold_s,
+                "dead_threshold_s": S.mesh.dead_threshold_s,
+            },
+            "ui": {"ux_v2": S.ui.ux_v2},
+            "api": {"ncbi_tool": S.api.ncbi_tool},
+            "secrets_present": {
+                "anthropic_api_key": bool(os.getenv("ANTHROPIC_API_KEY")),
+                "control_token": bool(os.getenv("GENTLY_CONTROL_TOKEN")),
+            },
+        }
+
     # ------------------------------------------------------------------
     # Lightsheet live stream
     # ------------------------------------------------------------------
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 449dbf9a..02654fd4 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9207,6 +9207,35 @@ body.modal-open {
     color: var(--text-muted);
 }
 
+/* Thermalizer / server-backed settings controls */
+.th-note { margin-bottom: 0.9rem; }
+.th-ro { font-size: 0.8rem; font-weight: 400; color: var(--text-muted); }
+.th-status {
+    font-size: 0.85rem; color: var(--text); font-variant-numeric: tabular-nums;
+    padding: 0.5rem 0.7rem; background: var(--bg-hover);
+    border: 1px solid var(--border); border-radius: 6px;
+}
+.th-actions { display: flex; gap: 0.6rem; }
+.settings-btn {
+    background: var(--bg-hover); border: 1px solid var(--border); color: var(--text);
+    font: 600 0.82rem/1 'Inter Tight', system-ui, sans-serif;
+    padding: 0.55rem 0.9rem; border-radius: 7px; cursor: pointer;
+    transition: background 0.13s, border-color 0.13s, color 0.13s, opacity 0.13s;
+}
+.settings-btn:hover:not(:disabled) { border-color: var(--accent); color: var(--accent); }
+.settings-btn:disabled { opacity: 0.5; cursor: progress; }
+.settings-btn-primary { background: var(--accent); border-color: var(--accent); color: #fff; }
+.settings-btn-primary:hover:not(:disabled) { background: var(--accent-hover); border-color: var(--accent-hover); color: #fff; }
+.settings-result { font-size: 0.8rem; margin-top: 0.6rem; min-height: 1.1em; }
+.settings-result.is-ok { color: var(--accent-green); }
+.settings-result.is-err { color: var(--accent-orange); }
+.settings-pre {
+    font: 0.78rem/1.5 ui-monospace, SFMono-Regular, monospace;
+    color: var(--text); background: var(--bg-dark); border: 1px solid var(--border);
+    border-radius: 8px; padding: 0.8rem 1rem; overflow-x: auto; white-space: pre;
+    max-height: 460px; overflow-y: auto;
+}
+
 /* Range slider */
 .settings-range {
     -webkit-appearance: none;
diff --git a/gently/ui/web/static/js/settings.js b/gently/ui/web/static/js/settings.js
index 66558731..8ec47055 100644
--- a/gently/ui/web/static/js/settings.js
+++ b/gently/ui/web/static/js/settings.js
@@ -233,3 +233,150 @@ const SettingsManager = {
 
 // Initialize on page load
 document.addEventListener('DOMContentLoaded', () => SettingsManager.init());
+
+
+/**
+ * ThermalizerSettings — server-backed hardware config, isolated from the
+ * localStorage SettingsManager above. Reads/writes the ACUITYnano connection
+ * via /api/devices/temperature/config{,/test}. Mock backend is dev-only
+ * (revealed via ?dev=1 or localStorage 'gently-dev').
+ */
+const ThermalizerSettings = {
+    el(id) { return document.getElementById(id); },
+    devMode() {
+        try {
+            return new URLSearchParams(location.search).has('dev')
+                || localStorage.getItem('gently-dev') === '1';
+        } catch (_) { return false; }
+    },
+
+    async init() {
+        if (!this.el('section-thermalizer')) return;
+        if (this.devMode()) {
+            const m = document.querySelector('.th-mock-opt');
+            if (m) m.style.display = '';
+        }
+        // backend radio toggles the field groups
+        document.querySelectorAll('input[name="th-backend"]').forEach(r =>
+            r.addEventListener('change', () => this.applyBackendVisibility(r.value)));
+        const test = this.el('th-test'), apply = this.el('th-apply');
+        if (test) test.addEventListener('click', () => this.test());
+        if (apply) apply.addEventListener('click', () => this.apply());
+        await this.load();
+        await this.loadEffective();
+    },
+
+    applyBackendVisibility(backend) {
+        const s = this.el('th-serial'), m = this.el('th-mqtt');
+        if (s) s.style.display = backend === 'serial' ? '' : 'none';
+        if (m) m.style.display = backend === 'mqtt' ? '' : 'none';
+    },
+
+    setForm(cfg) {
+        cfg = cfg || {};
+        const backend = cfg.backend || 'serial';
+        const radio = document.querySelector(`input[name="th-backend"][value="${backend}"]`);
+        if (radio) radio.checked = true;
+        this.applyBackendVisibility(backend);
+        const set = (id, v) => { const e = this.el(id); if (e && v != null) e.value = v; };
+        set('th-com', cfg.com_port); set('th-baud', cfg.baud_rate);
+        set('th-broker', cfg.broker); set('th-port', cfg.port); set('th-user', cfg.user);
+        set('th-stabilize', cfg.stabilize_timeout);
+        const pel = this.el('th-peltier'); if (pel) pel.checked = !!cfg.feedback_peltier;
+        // password intentionally left blank (write-only)
+    },
+
+    readForm() {
+        const backend = (document.querySelector('input[name="th-backend"]:checked') || {}).value || 'serial';
+        const cfg = { backend };
+        const num = id => { const v = this.el(id) && this.el(id).value; return v === '' || v == null ? null : Number(v); };
+        const str = id => { const v = this.el(id) && this.el(id).value; return v == null ? '' : v.trim(); };
+        if (backend === 'serial') {
+            cfg.com_port = str('th-com');
+            if (num('th-baud') != null) cfg.baud_rate = num('th-baud');
+        } else if (backend === 'mqtt') {
+            if (str('th-broker')) cfg.broker = str('th-broker');
+            if (num('th-port') != null) cfg.port = num('th-port');
+            if (str('th-user')) cfg.user = str('th-user');
+            const pw = this.el('th-pass') && this.el('th-pass').value;
+            if (pw) cfg.password = pw;  // blank = keep stored (server preserves)
+        }
+        if (num('th-stabilize') != null) cfg.stabilize_timeout = num('th-stabilize');
+        cfg.feedback_peltier = !!(this.el('th-peltier') && this.el('th-peltier').checked);
+        return cfg;
+    },
+
+    renderStatus(d) {
+        const el = this.el('th-status'); if (!el) return;
+        if (!d || d.available === false) { el.textContent = 'Controller not available (device layer offline or no thermalizer configured).'; return; }
+        const st = d.state || {};
+        const parts = [];
+        if (d.live_backend) parts.push(`backend: ${d.live_backend}`);
+        if (st.temperature_c != null) parts.push(`water: ${st.temperature_c} °C`);
+        if (st.setpoint_c != null) parts.push(`setpoint: ${st.setpoint_c} °C`);
+        if (st.state) parts.push(st.state);
+        el.textContent = parts.length ? parts.join(' · ') : 'active';
+    },
+
+    async load() {
+        try {
+            const res = await fetch('/api/devices/temperature/config');
+            const d = await res.json();
+            this.renderStatus(d);
+            if (d && d.config) this.setForm(d.config);
+        } catch (e) { this.renderStatus(null); }
+    },
+
+    result(msg, ok) {
+        const el = this.el('th-result'); if (!el) return;
+        el.textContent = msg;
+        el.className = 'settings-result ' + (ok ? 'is-ok' : 'is-err');
+    },
+
+    async test() {
+        const btn = this.el('th-test'); btn.disabled = true; const old = btn.textContent; btn.textContent = 'Testing…';
+        try {
+            const res = await fetch('/api/devices/temperature/config/test', {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(this.readForm()),
+            });
+            if (res.status === 401 || res.status === 403) { this.result('Need control to test.', false); return; }
+            const d = await res.json();
+            if (d.success) {
+                const r = d.result || {};
+                this.result(`OK — ${r.backend || 'connected'}${r.state ? ' · ' + r.state : ''}${r.temperature_c != null ? ' · ' + r.temperature_c + ' °C' : ''}`, true);
+            } else { this.result(`Failed: ${d.error || res.status}`, false); }
+        } catch (e) { this.result(`Error: ${e.message}`, false); }
+        finally { btn.disabled = false; btn.textContent = old; }
+    },
+
+    async apply() {
+        if (!window.confirm('Apply this thermalizer config to the rig?')) return;
+        const btn = this.el('th-apply'); btn.disabled = true; const old = btn.textContent; btn.textContent = 'Applying…';
+        try {
+            const res = await fetch('/api/devices/temperature/config', {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(this.readForm()),
+            });
+            if (res.status === 401 || res.status === 403) { this.result('Need control to apply.', false); return; }
+            if (res.status === 409) { const d = await res.json().catch(() => ({})); this.result(`Blocked: ${d.detail || d.error || 'a run/ramp is active'}`, false); return; }
+            const d = await res.json();
+            if (d.success && d.applied) { this.result('Applied live.', true); await this.load(); }
+            else if (d.restart_required) { this.result(`Saved — restart the device layer to apply. (${d.error || ''})`, false); }
+            else { this.result(`Failed: ${d.error || (d.detail || res.status)}`, false); }
+        } catch (e) { this.result(`Error: ${e.message}`, false); }
+        finally { btn.disabled = false; btn.textContent = old; }
+    },
+
+    async loadEffective() {
+        const el = this.el('effective-config'); if (!el) return;
+        try {
+            const res = await fetch('/api/config/effective');
+            if (!res.ok) { el.textContent = 'Unavailable.'; return; }
+            const d = await res.json();
+            el.textContent = JSON.stringify(d, null, 2);
+        } catch (e) { el.textContent = 'Unavailable.'; }
+    },
+};
+
+document.addEventListener('DOMContentLoaded', () => ThermalizerSettings.init());
diff --git a/gently/ui/web/templates/settings.html b/gently/ui/web/templates/settings.html
index 9e552936..a1635dff 100644
--- a/gently/ui/web/templates/settings.html
+++ b/gently/ui/web/templates/settings.html
@@ -52,6 +52,11 @@ <h1>Settings</h1>
                 <a class="settings-nav-item" data-section="vitals" href="#vitals">Vitals View</a>
                 <a class="settings-nav-item" data-section="detail" href="#detail">Default View</a>
             </div>
+            <div class="settings-nav-group">
+                <div class="settings-nav-title">Hardware</div>
+                <a class="settings-nav-item" data-section="thermalizer" href="#thermalizer">Thermalizer</a>
+                <a class="settings-nav-item" data-section="effective" href="#effective">Effective config</a>
+            </div>
         </nav>
 
         <main class="settings-content" id="settings-content">
@@ -172,11 +177,12 @@ <h2 class="settings-section-title">Filmstrip View</h2>
             <section class="settings-section" id="section-vitals">
                 <h2 class="settings-section-title">Vitals View</h2>
                 <div class="settings-field">
-                    <label class="settings-label">Temperature model</label>
+                    <label class="settings-label">Developmental-timing reference</label>
                     <div class="settings-radio-group" id="cfg-temperatureModel">
                         <label class="settings-radio"><input type="radio" name="temperatureModel" value="20C"> 20°C</label>
                         <label class="settings-radio"><input type="radio" name="temperatureModel" value="25C"> 25°C</label>
                     </div>
+                    <div class="settings-hint">C. elegans staging reference curve for the vitals chart — not the hardware controller (see Hardware → Thermalizer).</div>
                 </div>
                 <div class="settings-field">
                     <label class="settings-checkbox">
@@ -217,6 +223,51 @@ <h2 class="settings-section-title">Default View</h2>
                 </div>
             </section>
 
+            <section class="settings-section" id="section-thermalizer">
+                <h2 class="settings-section-title">Thermalizer (ACUITYnano)</h2>
+                <div class="settings-hint th-note">Machine-wide hardware setting, saved on the server (not this browser). Requires control.</div>
+
+                <div class="settings-field">
+                    <label class="settings-label">Live status</label>
+                    <div class="th-status" id="th-status">Loading…</div>
+                </div>
+
+                <div class="settings-field">
+                    <label class="settings-label">Connection</label>
+                    <div class="settings-radio-group" id="th-backend">
+                        <label class="settings-radio"><input type="radio" name="th-backend" value="serial"> Serial (COM)</label>
+                        <label class="settings-radio"><input type="radio" name="th-backend" value="mqtt"> MQTT (HiveMQ)</label>
+                        <label class="settings-radio th-mock-opt" style="display:none"><input type="radio" name="th-backend" value="mock"> Mock (dev)</label>
+                    </div>
+                </div>
+
+                <div id="th-serial">
+                    <div class="settings-field"><label class="settings-label" for="th-com">COM port</label><input class="settings-input" id="th-com" type="text" placeholder="COM8"></div>
+                    <div class="settings-field"><label class="settings-label" for="th-baud">Baud rate</label><input class="settings-input" id="th-baud" type="number" value="115200"></div>
+                </div>
+                <div id="th-mqtt" style="display:none">
+                    <div class="settings-field"><label class="settings-label" for="th-broker">Broker</label><input class="settings-input" id="th-broker" type="text" placeholder="blank = embedded HiveMQ default"></div>
+                    <div class="settings-field"><label class="settings-label" for="th-port">Port</label><input class="settings-input" id="th-port" type="number" placeholder="8883"></div>
+                    <div class="settings-field"><label class="settings-label" for="th-user">Username</label><input class="settings-input" id="th-user" type="text"></div>
+                    <div class="settings-field"><label class="settings-label" for="th-pass">Password</label><input class="settings-input" id="th-pass" type="password" placeholder="•••• (blank keeps stored)" autocomplete="new-password"><div class="settings-hint">Write-only — never shown; blank keeps the stored password.</div></div>
+                </div>
+
+                <div class="settings-field"><label class="settings-label" for="th-stabilize">Stabilize timeout (s)</label><input class="settings-input" id="th-stabilize" type="number" value="600"></div>
+                <div class="settings-field"><label class="settings-checkbox"><input type="checkbox" id="th-peltier"> Control off the Peltier sensor (else water)</label></div>
+
+                <div class="settings-field th-actions">
+                    <button class="settings-btn" id="th-test" type="button">Test connection</button>
+                    <button class="settings-btn settings-btn-primary" id="th-apply" type="button">Apply</button>
+                </div>
+                <div class="settings-result" id="th-result"></div>
+            </section>
+
+            <section class="settings-section" id="section-effective">
+                <h2 class="settings-section-title">Effective config <span class="th-ro">(read-only)</span></h2>
+                <div class="settings-hint th-note">The server's live configuration, secrets redacted. Editing these needs a restart / env override.</div>
+                <pre class="settings-pre" id="effective-config">Loading…</pre>
+            </section>
+
             <div class="settings-save-bar">
                 <span class="settings-save-status" id="settings-save-status"></span>
             </div>

From 1a0f12903ad23bfb2713957f156f6e9e53e8658c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 09:36:10 +0530
Subject: [PATCH 283/314] fix(settings): resolve 4 confirmed thermalizer
 code-review findings
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- MED: Test connection now preserves the stored MQTT password (shared
  _preserve_temp_password helper), so Test probes the same credentials Apply
  commits — a valid live config is no longer falsely reported broken.
- MED: thermalizer/effective edits no longer trigger SettingsManager's
  localStorage auto-save or its false 'Settings saved' toast (change listener
  now skips #section-thermalizer/#section-effective).
- LOW: the device-layer 409 (run/ramp active) is flattened to 200 by the proxy,
  so the UI detects it via a body 'blocked' flag instead of the dead
  res.status===409 branch — shows 'Blocked:' not a generic 'Failed:'.
- LOW: sidecar config.local.yml is created 0600 atomically (os.open O_CREAT
  0o600) so the plaintext MQTT password is never briefly world-readable.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/device_layer.py | 37 +++++++++++++++++---------
 gently/ui/web/static/js/settings.js    | 13 +++++++--
 2 files changed, 36 insertions(+), 14 deletions(-)

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 0c7690ae..cf69f87e 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -2108,6 +2108,20 @@ def _redact_temp_cfg(cfg: dict) -> dict:
             out["password"] = None
         return out
 
+    def _preserve_temp_password(self, cfg: dict) -> dict:
+        """Return a copy of cfg with the stored MQTT password filled in when the
+        client didn't submit a new one (the password is write-only in the UI, so
+        a blank field means 'keep what's stored'). Used by BOTH test + apply so
+        they exercise the same effective credentials."""
+        eff = dict(cfg)
+        if not eff.get("password"):
+            existing_pw = ((self.config or {}).get("temperature") or {}).get("password")
+            if existing_pw:
+                eff["password"] = existing_pw
+            else:
+                eff.pop("password", None)
+        return eff
+
     def _temp_state(self, temp) -> dict | None:
         if temp is None:
             return None
@@ -2154,10 +2168,11 @@ async def handle_test_temperature_config(self, request):
         err = self._validate_temp_cfg(cfg)
         if err:
             return web.json_response({"success": False, "error": err}, status=400)
+        eff = self._preserve_temp_password(cfg)  # probe with the same creds Apply would use
 
         def _probe():
             from gently.hardware.temperature import create_temperature_controller
-            tc = create_temperature_controller(cfg)
+            tc = create_temperature_controller(eff)
             try:
                 r = tc.read()
                 return {
@@ -2190,7 +2205,11 @@ def _write_temp_sidecar(self, temp_cfg: dict) -> None:
                 with open(sidecar) as f:
                     existing = yaml.safe_load(f) or {}
             existing["temperature"] = temp_cfg
-            with open(sidecar, "w") as f:
+            # Create with 0600 up front so the plaintext MQTT password is never
+            # briefly world/group-readable (O_CREAT mode only applies to new files;
+            # the follow-up chmod downgrades any pre-existing loose-perm file).
+            fd = os.open(sidecar, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
+            with os.fdopen(fd, "w") as f:
                 yaml.safe_dump(existing, f, default_flow_style=False, sort_keys=False)
             try:
                 os.chmod(sidecar, 0o600)
@@ -2220,25 +2239,19 @@ async def handle_set_temperature_config(self, request):
         re_state = str(getattr(self.RE, "state", "idle")) if self.RE is not None else "idle"
         if re_state != "idle":
             return web.json_response(
-                {"success": False,
+                {"success": False, "blocked": True,
                  "error": f"RunEngine is {re_state}; stop the plan before reconfiguring"},
                 status=409)
         old = self.devices.get("temperature")
         lock = getattr(old, "_lock", None)
         if lock is not None and lock.locked():
             return web.json_response(
-                {"success": False,
+                {"success": False, "blocked": True,
                  "error": "a temperature ramp is in progress; wait or stop it first"},
                 status=409)
 
-        # Preserve an existing password when the client didn't submit a new one.
-        eff = dict(cfg)
-        if not eff.get("password"):
-            existing_pw = ((self.config or {}).get("temperature") or {}).get("password")
-            if existing_pw:
-                eff["password"] = existing_pw
-            else:
-                eff.pop("password", None)
+        # Fill in the stored password when the client didn't submit a new one.
+        eff = self._preserve_temp_password(cfg)
 
         # Build the NEW controller first (eager connect off the event loop).
         def _build():
diff --git a/gently/ui/web/static/js/settings.js b/gently/ui/web/static/js/settings.js
index 8ec47055..4b21ee48 100644
--- a/gently/ui/web/static/js/settings.js
+++ b/gently/ui/web/static/js/settings.js
@@ -177,7 +177,14 @@ const SettingsManager = {
         const content = document.getElementById('settings-content');
         if (!content) return;
 
-        content.addEventListener('change', () => this.readFormAndSave());
+        // Ignore the server-backed hardware sections — they own their own
+        // handlers (ThermalizerSettings) and must not trigger the localStorage
+        // save or its "Settings saved" toast.
+        const isHardware = (t) => t && t.closest && t.closest('#section-thermalizer, #section-effective');
+        content.addEventListener('change', (e) => {
+            if (isHardware(e.target)) return;
+            this.readFormAndSave();
+        });
         content.addEventListener('input', (e) => {
             // Live update for range sliders
             if (e.target.id === 'cfg-imageSplitRatio') {
@@ -359,8 +366,10 @@ const ThermalizerSettings = {
                 body: JSON.stringify(this.readForm()),
             });
             if (res.status === 401 || res.status === 403) { this.result('Need control to apply.', false); return; }
-            if (res.status === 409) { const d = await res.json().catch(() => ({})); this.result(`Blocked: ${d.detail || d.error || 'a run/ramp is active'}`, false); return; }
             const d = await res.json();
+            // The device-layer 409 (run/ramp active) is flattened to 200 by the
+            // proxy, so detect it via the body flag, not the HTTP status.
+            if (d.blocked) { this.result(`Blocked: ${d.error || 'a run/ramp is active'}`, false); return; }
             if (d.success && d.applied) { this.result('Applied live.', true); await this.load(); }
             else if (d.restart_required) { this.result(`Saved — restart the device layer to apply. (${d.error || ''})`, false); }
             else { this.result(`Failed: ${d.error || (d.detail || res.status)}`, false); }

From eb63cbe6cb1d9e01303f4418c9ef88302f0b9329 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 10:03:47 +0530
Subject: [PATCH 284/314] =?UTF-8?q?feat(settings):=20Phase=202=20=E2=80=94?=
 =?UTF-8?q?=20rig-wide=20dashboard=20defaults=20+=20restart-required=20edi?=
 =?UTF-8?q?tors?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Completes the settings-panel Phase 2 alongside the effective-config viewer.

Dashboard-pref defaults (server-backed): GET/PUT /api/config/dashboard-defaults
(JSON in config/). settings.js now layers effective config as hardcoded <
rig-wide server defaults < per-browser localStorage, plus a defaults bar —
Save-as-rig-defaults, Reset-to-defaults, Export, Import — so prefs aren't trapped
per-browser.

Restart-required editors: an allowlisted set of settings.py knobs (timeouts,
mesh timing, ML, ux_v2, NCBI) editable via GET/PUT /api/config/settings-overrides
(require_control), persisted to config/settings.local.yml. settings.py now merges
that file into the environment at import (os.environ.setdefault, so a real env var
still wins) — every entry point picks it up on the next restart; the frozen
settings singleton is never live-mutated. New 'Advanced' panel section renders the
knobs with a 'Save (restart required)' banner.

Also: made the sticky settings footer opaque (var(--bg-dark) + top border) with
the defaults bar laid out inline, fixing the transparent-overlap on long
sections. Runtime override files gitignored.

Verified in-browser: server-defaults layering, Advanced render (13 knobs) +
save round-trip to settings.local.yml, fresh-import applies the file while a shell
env var still wins, footer no longer overlaps content. No console errors.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .gitignore                            |   5 +
 gently/settings.py                    |  24 +++++
 gently/ui/web/routes/data.py          | 107 +++++++++++++++++++
 gently/ui/web/static/css/main.css     |  14 ++-
 gently/ui/web/static/js/settings.js   | 141 +++++++++++++++++++++++++-
 gently/ui/web/templates/settings.html |  18 ++++
 6 files changed, 305 insertions(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index 34a7c3b7..bf27a9d0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -150,3 +150,8 @@ gently/ui/tui/dist/
 # literally to ./D:/ under the repo on Linux. Not data we track.
 /D:/
 .superpowers/
+
+# Runtime operator overrides (written by the Settings panel)
+config/config.local.yml
+config/settings.local.yml
+config/dashboard_defaults.json
diff --git a/gently/settings.py b/gently/settings.py
index 9e7d2e68..117efbc3 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -27,6 +27,30 @@ def _env(key: str, default):
     return val
 
 
+def _load_local_overrides():
+    """Merge config/settings.local.yml (a flat map of GENTLY_* keys) into the
+    environment BEFORE settings are resolved. setdefault so a real env var still
+    wins over the file. This is how the Settings panel's restart-required editors
+    persist overrides — every entry point (viz, device layer, agent) picks them
+    up at import."""
+    try:
+        import yaml
+
+        path = Path(__file__).resolve().parents[1] / "config" / "settings.local.yml"
+        if not path.exists():
+            return
+        data = yaml.safe_load(path.read_text()) or {}
+        if isinstance(data, dict):
+            for k, v in data.items():
+                if v is not None:
+                    os.environ.setdefault(str(k), str(v))
+    except Exception:
+        pass
+
+
+_load_local_overrides()
+
+
 @dataclass(frozen=True)
 class NetworkSettings:
     """Ports, hosts, and bind addresses."""
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 32e26092..c5b4591e 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -531,6 +531,113 @@ async def get_effective_config():
             },
         }
 
+    # --- Rig-wide dashboard-preference defaults (layered UNDER per-browser localStorage) ---
+    _dashboard_defaults_path = _HARDWARE_CONFIG_PATH.parent / "dashboard_defaults.json"
+
+    @router.get("/api/config/dashboard-defaults")
+    async def get_dashboard_defaults():
+        """Rig-wide dashboard-pref defaults (JSON). The browser layers localStorage
+        over these, so a fresh browser inherits the rig's defaults."""
+        import json
+
+        if not _dashboard_defaults_path.exists():
+            return {}
+        try:
+            return json.loads(_dashboard_defaults_path.read_text())
+        except Exception:
+            return {}
+
+    @router.put("/api/config/dashboard-defaults", dependencies=[Depends(require_control)])
+    async def put_dashboard_defaults(payload: dict = Body(...)):  # noqa: B008
+        """Save the current dashboard prefs as the rig-wide defaults."""
+        import json
+
+        if not isinstance(payload, dict):
+            raise HTTPException(status_code=400, detail="body must be an object")
+        _dashboard_defaults_path.write_text(json.dumps(payload, indent=2))
+        return {"saved": True}
+
+    # --- Restart-required settings.py editors (persisted to config/settings.local.yml) ---
+    # (env var, label, type, current-value getter). Allowlist only — never expose
+    # ports/hosts/model-IDs/storage-path/secrets here.
+    _override_keys = [
+        ("GENTLY_TIMEOUT_PLAN", "Plan execution timeout (s)", "int",
+         lambda S: S.timeouts.plan_execution),
+        ("GENTLY_TIMEOUT_RPC", "RPC call timeout (s)", "int",
+         lambda S: S.timeouts.rpc_call),
+        ("GENTLY_TIMEOUT_VOLUME", "Volume acquisition timeout (s)", "int",
+         lambda S: S.timeouts.volume_acquisition),
+        ("GENTLY_TIMEOUT_API", "API call timeout (s)", "int",
+         lambda S: S.timeouts.api_call),
+        ("GENTLY_MESH_BROADCAST_INTERVAL", "Mesh broadcast interval (s)", "float",
+         lambda S: S.mesh.broadcast_interval_s),
+        ("GENTLY_MESH_STALE_THRESHOLD", "Mesh stale threshold (s)", "float",
+         lambda S: S.mesh.stale_threshold_s),
+        ("GENTLY_MESH_DEAD_THRESHOLD", "Mesh dead threshold (s)", "float",
+         lambda S: S.mesh.dead_threshold_s),
+        ("GENTLY_ML_BATCH_SIZE", "ML batch size", "int", lambda S: S.ml.default_batch_size),
+        ("GENTLY_ML_EPOCHS", "ML epochs", "int", lambda S: S.ml.default_epochs),
+        ("GENTLY_ML_LR", "ML learning rate", "float", lambda S: S.ml.default_lr),
+        ("GENTLY_UX_V2", "UX v2 dashboard", "bool", lambda S: S.ui.ux_v2),
+        ("GENTLY_NCBI_TOOL", "NCBI tool name", "str", lambda S: S.api.ncbi_tool),
+        ("GENTLY_NCBI_EMAIL", "NCBI email", "str", lambda S: S.api.ncbi_email),
+    ]
+    _settings_local_path = _HARDWARE_CONFIG_PATH.parent / "settings.local.yml"
+
+    def _coerce_override(typ, val):
+        if typ == "int":
+            return int(val)
+        if typ == "float":
+            return float(val)
+        if typ == "bool":
+            return val if isinstance(val, bool) else str(val).lower() in ("1", "true", "yes", "on")
+        return str(val)
+
+    def _read_settings_local():
+        if not _settings_local_path.exists():
+            return {}
+        try:
+            return yaml.safe_load(_settings_local_path.read_text()) or {}
+        except Exception:
+            return {}
+
+    @router.get("/api/config/settings-overrides")
+    async def get_settings_overrides():
+        """Editable (restart-required) settings.py knobs: current effective value
+        + whether an override file entry exists."""
+        from gently.settings import settings as S
+
+        file_over = _read_settings_local()
+        items = [
+            {"env": env, "label": label, "type": typ,
+             "current": getter(S), "overridden": env in file_over}
+            for (env, label, typ, getter) in _override_keys
+        ]
+        return {"note": "changes take effect on the next process restart", "items": items}
+
+    @router.put("/api/config/settings-overrides", dependencies=[Depends(require_control)])
+    async def put_settings_overrides(payload: dict = Body(...)):  # noqa: B008
+        """Persist restart-required overrides to config/settings.local.yml. Only
+        allowlisted keys; never mutates the frozen settings singleton live."""
+        allowed = {env: typ for (env, _lbl, typ, _g) in _override_keys}
+        updates = {}
+        for k, v in (payload or {}).items():
+            if k not in allowed:
+                raise HTTPException(status_code=400, detail=f"unknown or non-editable key: {k}")
+            if v is None or v == "":
+                continue
+            try:
+                updates[k] = _coerce_override(allowed[k], v)
+            except (TypeError, ValueError):
+                raise HTTPException(
+                    status_code=400, detail=f"{k}: invalid {allowed[k]} value") from None
+        existing = _read_settings_local()
+        existing.update(updates)
+        _settings_local_path.write_text(
+            yaml.safe_dump(existing, default_flow_style=False, sort_keys=True))
+        return {"saved": list(updates.keys()), "restart_required": True,
+                "note": "restart the server for these to take effect"}
+
     # ------------------------------------------------------------------
     # Lightsheet live stream
     # ------------------------------------------------------------------
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 02654fd4..0c9a5293 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9085,7 +9085,7 @@ body.modal-open {
 .settings-content {
     flex: 1;
     max-width: 720px;
-    padding: 2rem 2.5rem;
+    padding: 2rem 2.5rem 0;
     overflow-y: auto;
 }
 
@@ -9235,6 +9235,11 @@ body.modal-open {
     border-radius: 8px; padding: 0.8rem 1rem; overflow-x: auto; white-space: pre;
     max-height: 460px; overflow-y: auto;
 }
+.settings-defaults-bar { display: flex; gap: 0.5rem; margin-left: auto; flex-wrap: wrap; }
+.settings-pre code, .settings-hint code {
+    font: 0.85em ui-monospace, SFMono-Regular, monospace;
+    background: var(--bg-hover); padding: 0.05rem 0.3rem; border-radius: 4px;
+}
 
 /* Range slider */
 .settings-range {
@@ -9279,6 +9284,13 @@ body.modal-open {
     position: sticky;
     bottom: 0;
     padding: 0.75rem 0;
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    flex-wrap: wrap;
+    background: var(--bg-dark);
+    border-top: 1px solid var(--border);
+    z-index: 5;
 }
 
 .settings-save-status {
diff --git a/gently/ui/web/static/js/settings.js b/gently/ui/web/static/js/settings.js
index 4b21ee48..6b6d558e 100644
--- a/gently/ui/web/static/js/settings.js
+++ b/gently/ui/web/static/js/settings.js
@@ -39,23 +39,78 @@ const SettingsManager = {
 
     config: null,
 
-    init() {
+    async init() {
+        this.serverDefaults = await this.fetchServerDefaults();
         this.config = this.load();
         this.populateForm();
         this.setupNavigation();
         this.setupListeners();
+        this.setupDefaultsBar();
+    },
+
+    async fetchServerDefaults() {
+        try {
+            const res = await fetch('/api/config/dashboard-defaults');
+            if (!res.ok) return {};
+            const d = await res.json();
+            return (d && typeof d === 'object') ? d : {};
+        } catch (e) { return {}; }
     },
 
     load() {
+        // Effective config = hardcoded defaults < rig-wide server defaults < this browser's localStorage.
+        const base = this.deepMerge(this.defaults, this.serverDefaults || {});
         try {
             const stored = localStorage.getItem(this.STORAGE_KEY);
             if (stored) {
-                return this.deepMerge(this.defaults, JSON.parse(stored));
+                return this.deepMerge(base, JSON.parse(stored));
             }
         } catch (e) {
             console.warn('Failed to load settings:', e);
         }
-        return { ...this.defaults };
+        return base;
+    },
+
+    setupDefaultsBar() {
+        const byId = (id) => document.getElementById(id);
+        const saveDef = byId('pref-save-defaults');
+        if (saveDef) saveDef.addEventListener('click', async () => {
+            try {
+                const res = await fetch('/api/config/dashboard-defaults', {
+                    method: 'PUT', headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(this.config),
+                });
+                if (res.status === 401 || res.status === 403) { this.showSaveStatus('Need control'); return; }
+                this.showSaveStatus(res.ok ? 'Saved as rig defaults' : 'Failed to save defaults');
+            } catch (e) { this.showSaveStatus('Failed to save defaults'); }
+        });
+        const reset = byId('pref-reset');
+        if (reset) reset.addEventListener('click', () => {
+            if (!confirm("Clear this browser's dashboard prefs and use the rig defaults?")) return;
+            localStorage.removeItem(this.STORAGE_KEY);
+            location.reload();
+        });
+        const exp = byId('pref-export');
+        if (exp) exp.addEventListener('click', () => {
+            const blob = new Blob([JSON.stringify(this.config, null, 2)], { type: 'application/json' });
+            const a = document.createElement('a');
+            a.href = URL.createObjectURL(blob); a.download = 'gently-dashboard-prefs.json';
+            a.click(); URL.revokeObjectURL(a.href);
+        });
+        const imp = byId('pref-import'), impFile = byId('pref-import-file');
+        if (imp && impFile) {
+            imp.addEventListener('click', () => impFile.click());
+            impFile.addEventListener('change', async () => {
+                const file = impFile.files[0]; if (!file) return;
+                try {
+                    const obj = JSON.parse(await file.text());
+                    this.config = this.deepMerge(this.defaults, obj);
+                    this.save(); this.populateForm();
+                    this.showSaveStatus('Imported');
+                } catch (e) { this.showSaveStatus('Import failed: invalid JSON'); }
+                impFile.value = '';
+            });
+        }
     },
 
     save() {
@@ -389,3 +444,83 @@ const ThermalizerSettings = {
 };
 
 document.addEventListener('DOMContentLoaded', () => ThermalizerSettings.init());
+
+
+/**
+ * AdvancedSettings — restart-required settings.py editors, persisted to
+ * config/settings.local.yml via /api/config/settings-overrides. Renders an
+ * allowlisted set of tunables; saving does NOT apply live (needs a restart).
+ */
+const AdvancedSettings = {
+    el(id) { return document.getElementById(id); },
+
+    async init() {
+        if (!this.el('section-advanced')) return;
+        const save = this.el('adv-save');
+        if (save) save.addEventListener('click', () => this.save());
+        await this.load();
+    },
+
+    async load() {
+        const wrap = this.el('adv-fields'); if (!wrap) return;
+        try {
+            const res = await fetch('/api/config/settings-overrides');
+            if (!res.ok) { wrap.textContent = 'Unavailable.'; return; }
+            const d = await res.json();
+            const items = d.items || [];
+            wrap.innerHTML = '';
+            items.forEach(it => {
+                const field = document.createElement('div');
+                field.className = 'settings-field';
+                const tag = it.overridden ? ' <span class="th-ro">(override set)</span>' : '';
+                if (it.type === 'bool') {
+                    const lab = document.createElement('label');
+                    lab.className = 'settings-checkbox';
+                    lab.innerHTML = `<input type="checkbox" data-env="${it.env}"> ${it.label}${tag}`;
+                    lab.querySelector('input').checked = !!it.current;
+                    field.appendChild(lab);
+                } else {
+                    const lab = document.createElement('label');
+                    lab.className = 'settings-label';
+                    lab.innerHTML = it.label + tag;
+                    const inp = document.createElement('input');
+                    inp.className = 'settings-input';
+                    inp.dataset.env = it.env;
+                    inp.type = it.type === 'str' ? 'text' : 'number';
+                    if (it.type === 'float') inp.step = 'any';
+                    if (it.current != null) inp.value = it.current;
+                    field.appendChild(lab); field.appendChild(inp);
+                }
+                wrap.appendChild(field);
+            });
+        } catch (e) { wrap.textContent = 'Unavailable.'; }
+    },
+
+    result(msg, ok) {
+        const el = this.el('adv-result'); if (!el) return;
+        el.textContent = msg;
+        el.className = 'settings-result ' + (ok ? 'is-ok' : 'is-err');
+    },
+
+    async save() {
+        const payload = {};
+        document.querySelectorAll('#adv-fields [data-env]').forEach(inp => {
+            if (inp.type === 'checkbox') payload[inp.dataset.env] = inp.checked;
+            else if (inp.value !== '') payload[inp.dataset.env] = inp.value;
+        });
+        const btn = this.el('adv-save'); btn.disabled = true; const old = btn.textContent; btn.textContent = 'Saving…';
+        try {
+            const res = await fetch('/api/config/settings-overrides', {
+                method: 'PUT', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+            if (res.status === 401 || res.status === 403) { this.result('Need control to save.', false); return; }
+            const d = await res.json();
+            if (res.ok) { this.result(`Saved ${(d.saved || []).length} setting(s) — restart the server to apply.`, true); await this.load(); }
+            else { this.result(`Failed: ${d.detail || res.status}`, false); }
+        } catch (e) { this.result(`Error: ${e.message}`, false); }
+        finally { btn.disabled = false; btn.textContent = old; }
+    },
+};
+
+document.addEventListener('DOMContentLoaded', () => AdvancedSettings.init());
diff --git a/gently/ui/web/templates/settings.html b/gently/ui/web/templates/settings.html
index a1635dff..cc1316cb 100644
--- a/gently/ui/web/templates/settings.html
+++ b/gently/ui/web/templates/settings.html
@@ -56,6 +56,7 @@ <h1>Settings</h1>
                 <div class="settings-nav-title">Hardware</div>
                 <a class="settings-nav-item" data-section="thermalizer" href="#thermalizer">Thermalizer</a>
                 <a class="settings-nav-item" data-section="effective" href="#effective">Effective config</a>
+                <a class="settings-nav-item" data-section="advanced" href="#advanced">Advanced</a>
             </div>
         </nav>
 
@@ -268,8 +269,25 @@ <h2 class="settings-section-title">Effective config <span class="th-ro">(read-on
                 <pre class="settings-pre" id="effective-config">Loading…</pre>
             </section>
 
+            <section class="settings-section" id="section-advanced">
+                <h2 class="settings-section-title">Advanced <span class="th-ro">(restart required)</span></h2>
+                <div class="settings-hint th-note">System tunables persisted to <code>config/settings.local.yml</code>. Saved values take effect on the next server restart. Requires control.</div>
+                <div id="adv-fields">Loading…</div>
+                <div class="settings-field th-actions">
+                    <button class="settings-btn settings-btn-primary" id="adv-save" type="button">Save (restart required)</button>
+                </div>
+                <div class="settings-result" id="adv-result"></div>
+            </section>
+
             <div class="settings-save-bar">
                 <span class="settings-save-status" id="settings-save-status"></span>
+                <span class="settings-defaults-bar">
+                    <button class="settings-btn" id="pref-save-defaults" type="button" title="Save current dashboard prefs as the rig-wide defaults">Save as rig defaults</button>
+                    <button class="settings-btn" id="pref-reset" type="button" title="Clear this browser's overrides and use the rig defaults">Reset to defaults</button>
+                    <button class="settings-btn" id="pref-export" type="button">Export</button>
+                    <button class="settings-btn" id="pref-import" type="button">Import</button>
+                    <input type="file" id="pref-import-file" accept="application/json" style="display:none">
+                </span>
             </div>
         </main>
     </div>

From 703db32bd3a844a71df76ca5f0dbdcd2e4640acd Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 10:43:07 +0530
Subject: [PATCH 285/314] fix(settings): drop dead settings.py knobs from
 editors + group the Advanced UI
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Auditing the exposed knobs showed several with ZERO runtime readers — editing them
would be a silent no-op, and one was a vestige of the removed RPyC layer:
- Removed settings.timeouts.rpc_call entirely (RPyC-era; 0 readers repo-wide; the
  HTTP client uses its own aiohttp ClientTimeout). Dropped from the effective viewer.
- Pruned the Advanced editor to knobs with verified live readers: timeouts
  {volume_acquisition, api_call}, mesh {broadcast/stale/dead}, ui.ux_v2, api
  {ncbi_tool, ncbi_email}. Omitted timeouts.plan_execution + ml.{batch,epochs,lr}
  (0 readers today — no-ops).
- Grouped the Advanced section (Timeouts / Mesh network / Interface / NCBI) with
  subheadings instead of a flat list.

Verified in-browser: 8 grouped knobs, rpc_call absent, save round-trip intact.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/settings.py                  |  1 -
 gently/ui/web/routes/data.py        | 52 ++++++++++++-------------
 gently/ui/web/static/css/main.css   |  6 +++
 gently/ui/web/static/js/settings.js | 60 ++++++++++++++++++-----------
 4 files changed, 69 insertions(+), 50 deletions(-)

diff --git a/gently/settings.py b/gently/settings.py
index 117efbc3..7314b135 100644
--- a/gently/settings.py
+++ b/gently/settings.py
@@ -134,7 +134,6 @@ class TimeoutSettings:
     """Timeout values in seconds."""
 
     plan_execution: int = field(default_factory=lambda: _env("TIMEOUT_PLAN", 300))
-    rpc_call: int = field(default_factory=lambda: _env("TIMEOUT_RPC", 60))
     volume_acquisition: int = field(default_factory=lambda: _env("TIMEOUT_VOLUME", 15))
     api_call: int = field(default_factory=lambda: _env("TIMEOUT_API", 10))
 
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index c5b4591e..7461afff 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -505,7 +505,6 @@ async def get_effective_config():
             "storage": {"base_path": str(S.storage.base_path)},
             "timeouts": {
                 "plan_execution": S.timeouts.plan_execution,
-                "rpc_call": S.timeouts.rpc_call,
                 "volume_acquisition": S.timeouts.volume_acquisition,
                 "api_call": S.timeouts.api_call,
             },
@@ -558,29 +557,28 @@ async def put_dashboard_defaults(payload: dict = Body(...)):  # noqa: B008
         return {"saved": True}
 
     # --- Restart-required settings.py editors (persisted to config/settings.local.yml) ---
-    # (env var, label, type, current-value getter). Allowlist only — never expose
-    # ports/hosts/model-IDs/storage-path/secrets here.
+    # Allowlist of knobs that are ACTUALLY consumed by the runtime (verified live
+    # readers) + grouped for the UI. Never expose ports/hosts/model-IDs/storage/
+    # secrets. Deliberately omitted: timeouts.rpc_call (removed — RPyC-era dead),
+    # timeouts.plan_execution and ml.* defaults (currently 0 readers — editing
+    # would be a silent no-op).
     _override_keys = [
-        ("GENTLY_TIMEOUT_PLAN", "Plan execution timeout (s)", "int",
-         lambda S: S.timeouts.plan_execution),
-        ("GENTLY_TIMEOUT_RPC", "RPC call timeout (s)", "int",
-         lambda S: S.timeouts.rpc_call),
-        ("GENTLY_TIMEOUT_VOLUME", "Volume acquisition timeout (s)", "int",
-         lambda S: S.timeouts.volume_acquisition),
-        ("GENTLY_TIMEOUT_API", "API call timeout (s)", "int",
-         lambda S: S.timeouts.api_call),
-        ("GENTLY_MESH_BROADCAST_INTERVAL", "Mesh broadcast interval (s)", "float",
-         lambda S: S.mesh.broadcast_interval_s),
-        ("GENTLY_MESH_STALE_THRESHOLD", "Mesh stale threshold (s)", "float",
-         lambda S: S.mesh.stale_threshold_s),
-        ("GENTLY_MESH_DEAD_THRESHOLD", "Mesh dead threshold (s)", "float",
-         lambda S: S.mesh.dead_threshold_s),
-        ("GENTLY_ML_BATCH_SIZE", "ML batch size", "int", lambda S: S.ml.default_batch_size),
-        ("GENTLY_ML_EPOCHS", "ML epochs", "int", lambda S: S.ml.default_epochs),
-        ("GENTLY_ML_LR", "ML learning rate", "float", lambda S: S.ml.default_lr),
-        ("GENTLY_UX_V2", "UX v2 dashboard", "bool", lambda S: S.ui.ux_v2),
-        ("GENTLY_NCBI_TOOL", "NCBI tool name", "str", lambda S: S.api.ncbi_tool),
-        ("GENTLY_NCBI_EMAIL", "NCBI email", "str", lambda S: S.api.ncbi_email),
+        {"env": "GENTLY_TIMEOUT_VOLUME", "label": "Volume acquisition (s)", "type": "int",
+         "group": "Timeouts", "get": lambda S: S.timeouts.volume_acquisition},
+        {"env": "GENTLY_TIMEOUT_API", "label": "External API call (s)", "type": "int",
+         "group": "Timeouts", "get": lambda S: S.timeouts.api_call},
+        {"env": "GENTLY_MESH_BROADCAST_INTERVAL", "label": "Broadcast interval (s)",
+         "type": "float", "group": "Mesh network", "get": lambda S: S.mesh.broadcast_interval_s},
+        {"env": "GENTLY_MESH_STALE_THRESHOLD", "label": "Stale threshold (s)", "type": "float",
+         "group": "Mesh network", "get": lambda S: S.mesh.stale_threshold_s},
+        {"env": "GENTLY_MESH_DEAD_THRESHOLD", "label": "Dead threshold (s)", "type": "float",
+         "group": "Mesh network", "get": lambda S: S.mesh.dead_threshold_s},
+        {"env": "GENTLY_UX_V2", "label": "UX v2 dashboard", "type": "bool",
+         "group": "Interface", "get": lambda S: S.ui.ux_v2},
+        {"env": "GENTLY_NCBI_TOOL", "label": "Tool name", "type": "str",
+         "group": "NCBI (Entrez)", "get": lambda S: S.api.ncbi_tool},
+        {"env": "GENTLY_NCBI_EMAIL", "label": "Contact email", "type": "str",
+         "group": "NCBI (Entrez)", "get": lambda S: S.api.ncbi_email},
     ]
     _settings_local_path = _HARDWARE_CONFIG_PATH.parent / "settings.local.yml"
 
@@ -609,9 +607,9 @@ async def get_settings_overrides():
 
         file_over = _read_settings_local()
         items = [
-            {"env": env, "label": label, "type": typ,
-             "current": getter(S), "overridden": env in file_over}
-            for (env, label, typ, getter) in _override_keys
+            {"env": k["env"], "label": k["label"], "type": k["type"], "group": k["group"],
+             "current": k["get"](S), "overridden": k["env"] in file_over}
+            for k in _override_keys
         ]
         return {"note": "changes take effect on the next process restart", "items": items}
 
@@ -619,7 +617,7 @@ async def get_settings_overrides():
     async def put_settings_overrides(payload: dict = Body(...)):  # noqa: B008
         """Persist restart-required overrides to config/settings.local.yml. Only
         allowlisted keys; never mutates the frozen settings singleton live."""
-        allowed = {env: typ for (env, _lbl, typ, _g) in _override_keys}
+        allowed = {k["env"]: k["type"] for k in _override_keys}
         updates = {}
         for k, v in (payload or {}).items():
             if k not in allowed:
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 0c9a5293..2c7751aa 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9236,6 +9236,12 @@ body.modal-open {
     max-height: 460px; overflow-y: auto;
 }
 .settings-defaults-bar { display: flex; gap: 0.5rem; margin-left: auto; flex-wrap: wrap; }
+.settings-subhead {
+    font-size: 0.72rem; font-weight: 700; letter-spacing: 0.06em; text-transform: uppercase;
+    color: var(--text-muted); margin: 1.4rem 0 0.6rem; padding-bottom: 0.35rem;
+    border-bottom: 1px solid var(--border);
+}
+.settings-subhead:first-child { margin-top: 0.2rem; }
 .settings-pre code, .settings-hint code {
     font: 0.85em ui-monospace, SFMono-Regular, monospace;
     background: var(--bg-hover); padding: 0.05rem 0.3rem; border-radius: 4px;
diff --git a/gently/ui/web/static/js/settings.js b/gently/ui/web/static/js/settings.js
index 6b6d558e..2ade33e2 100644
--- a/gently/ui/web/static/js/settings.js
+++ b/gently/ui/web/static/js/settings.js
@@ -461,6 +461,31 @@ const AdvancedSettings = {
         await this.load();
     },
 
+    renderField(it) {
+        const field = document.createElement('div');
+        field.className = 'settings-field';
+        const tag = it.overridden ? ' <span class="th-ro">(override set)</span>' : '';
+        if (it.type === 'bool') {
+            const lab = document.createElement('label');
+            lab.className = 'settings-checkbox';
+            lab.innerHTML = `<input type="checkbox" data-env="${it.env}"> ${it.label}${tag}`;
+            lab.querySelector('input').checked = !!it.current;
+            field.appendChild(lab);
+        } else {
+            const lab = document.createElement('label');
+            lab.className = 'settings-label';
+            lab.innerHTML = it.label + tag;
+            const inp = document.createElement('input');
+            inp.className = 'settings-input';
+            inp.dataset.env = it.env;
+            inp.type = it.type === 'str' ? 'text' : 'number';
+            if (it.type === 'float') inp.step = 'any';
+            if (it.current != null) inp.value = it.current;
+            field.appendChild(lab); field.appendChild(inp);
+        }
+        return field;
+    },
+
     async load() {
         const wrap = this.el('adv-fields'); if (!wrap) return;
         try {
@@ -469,29 +494,20 @@ const AdvancedSettings = {
             const d = await res.json();
             const items = d.items || [];
             wrap.innerHTML = '';
+            // Group items by their `group`, preserving first-seen order.
+            const groups = [];
+            const byName = {};
             items.forEach(it => {
-                const field = document.createElement('div');
-                field.className = 'settings-field';
-                const tag = it.overridden ? ' <span class="th-ro">(override set)</span>' : '';
-                if (it.type === 'bool') {
-                    const lab = document.createElement('label');
-                    lab.className = 'settings-checkbox';
-                    lab.innerHTML = `<input type="checkbox" data-env="${it.env}"> ${it.label}${tag}`;
-                    lab.querySelector('input').checked = !!it.current;
-                    field.appendChild(lab);
-                } else {
-                    const lab = document.createElement('label');
-                    lab.className = 'settings-label';
-                    lab.innerHTML = it.label + tag;
-                    const inp = document.createElement('input');
-                    inp.className = 'settings-input';
-                    inp.dataset.env = it.env;
-                    inp.type = it.type === 'str' ? 'text' : 'number';
-                    if (it.type === 'float') inp.step = 'any';
-                    if (it.current != null) inp.value = it.current;
-                    field.appendChild(lab); field.appendChild(inp);
-                }
-                wrap.appendChild(field);
+                const g = it.group || 'Other';
+                if (!byName[g]) { byName[g] = []; groups.push(g); }
+                byName[g].push(it);
+            });
+            groups.forEach(g => {
+                const head = document.createElement('div');
+                head.className = 'settings-subhead';
+                head.textContent = g;
+                wrap.appendChild(head);
+                byName[g].forEach(it => wrap.appendChild(this.renderField(it)));
             });
         } catch (e) { wrap.textContent = 'Unavailable.'; }
     },

From 76c32247ba4438255f76ba062406165894c4a16c Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 13:14:53 +0530
Subject: [PATCH 286/314] perf(file_store): O(1) prediction_id via bounded tail
 read
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

store_prediction computed the next prediction_id by _read_jsonl()-ing and
JSON-parsing the ENTIRE predictions.jsonl on every append — O(n) per prediction,
quadratic over a long timelapse, and a synchronous blocking read on the app event
loop (the perception-persist path). Replace with _last_jsonl_record(): read a
bounded 64 KB tail window and take the last record's prediction_id + 1. Ids stay
sequential (we only ever append in order); robust to a trailing partial line from
an interrupted write. Verified: identical ids, 20k-record file read in 0.26 ms.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/core/file_store.py | 44 ++++++++++++++++++++++++++++++++-------
 1 file changed, 37 insertions(+), 7 deletions(-)

diff --git a/gently/core/file_store.py b/gently/core/file_store.py
index 0f82a486..c795c304 100644
--- a/gently/core/file_store.py
+++ b/gently/core/file_store.py
@@ -214,6 +214,37 @@ def _read_jsonl(path: Path) -> list[dict]:
     return records
 
 
+def _last_jsonl_record(path: Path) -> dict | None:
+    """Return the last parseable JSON record in a JSONL file, reading only the tail.
+
+    Keeps appends O(1): instead of loading + parsing the whole file (which made
+    per-prediction writes O(n) and quadratic over a long timelapse), we read a
+    bounded window from the end and walk backwards to the last complete line,
+    skipping a possible trailing partial line from an interrupted write.
+    """
+    if not path.exists():
+        return None
+    try:
+        size = path.stat().st_size
+    except OSError:
+        return None
+    if size == 0:
+        return None
+    window = min(size, 65536)
+    with open(path, "rb") as f:
+        f.seek(size - window)
+        data = f.read(window)
+    for line in reversed(data.split(b"\n")):
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            return json.loads(line)
+        except (ValueError, UnicodeDecodeError):
+            continue
+    return None
+
+
 def _now() -> str:
     return datetime.now().isoformat()
 
@@ -1146,15 +1177,14 @@ def store_prediction(
                 json.dump(trace_data, f, indent=2, ensure_ascii=False, default=str)
             trace_file = str(trace_path)
 
-        # Compute prediction_id: count existing predictions in this embryo's
-        # JSONL and add 1.  This gives a session-global unique id as long as
-        # we read all embryos, but for simplicity we count per-embryo and add
-        # an offset based on embryo ordering.  A simpler and safer approach:
-        # use a session-level counter stored in perception_runs.yaml.
+        # Per-embryo prediction_id = previous max + 1. Derived from the LAST
+        # record only (bounded tail read) rather than re-parsing the whole
+        # predictions.jsonl on every append — ids stay sequential because we
+        # only ever append in order.
         sd = self._require_session_dir(session_id)
         pred_path = sd / "embryos" / embryo_id / "predictions.jsonl"
-        existing = _read_jsonl(pred_path)
-        prediction_id = len(existing) + 1
+        last = _last_jsonl_record(pred_path)
+        prediction_id = (last.get("prediction_id", 0) + 1) if last else 1
 
         record: PredictionInfo = {
             "prediction_id": prediction_id,

From c478a4066c1455a21342def82d496235477f1bd3 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 13:16:00 +0530
Subject: [PATCH 287/314] docs: concurrency & runtime architecture overview

Code-grounded map of how gently manages concurrent work: the two-process split
(app/viz :8080 <-> device-layer :60610 over HTTP + shared filesystem), one
asyncio loop per process, hardware serialized behind a single plan queue +
executor (and pymmcore g_core_lock), how polling coexists with long experiments
(to_thread offload, split pollers, reference-counted pause_state_updates,
telemetry bypassing the queue), filesystem image transfer, fire-and-forget
perception/VLM + EventBus, backpressure/failure isolation, and known limits
(incl. the now-fixed O(n) prediction write).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/ARCHITECTURE.md | 171 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 docs/ARCHITECTURE.md

diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
new file mode 100644
index 00000000..cd2621f9
--- /dev/null
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,171 @@
+# Gently — Concurrency & Runtime Architecture
+
+How the system runs temperature telemetry, device-state polling, experiments,
+image acquisition, and perception/VLM "at the same time" without stepping on
+itself. The short version: **almost nothing runs truly in parallel — the design
+quarantines the blocking work and serializes the hardware, then keeps both event
+loops responsive by offloading and decoupling everything slow.**
+
+> Scope: the concurrency model. For storage layout see `CLAUDE.md`; for the
+> device/hardware plugin model see `docs/asi-plugin-architecture.md`.
+
+## 1. Two processes, bridged by HTTP + a shared filesystem
+
+This split is the load-bearing fact of the whole design.
+
+```
+┌────────────────────────────────────────┐        ┌────────────────────────────────────────┐
+│  APP / VIZ process   (FastAPI :8080)    │        │  DEVICE-LAYER process  (aiohttp :60610) │
+│  gently/app/agent.py                    │        │  gently/hardware/dispim/device_layer.py │
+│                                         │  HTTP  │                                          │
+│  • agent + TimelapseOrchestrator        │◄──────►│  • the ONLY code touching hardware:      │
+│  • Perceiver (gently_perception, VLM)   │  (DiSPIM│    MMCore/pymmcore, Ophyd, Bluesky RE    │
+│  • AsyncAnthropic clients               │  Client)│  • plan queue + single executor          │
+│  • EventBus + WebSocket ConnectionMgr   │        │  • 3 state pollers + camera/LS streamers │
+│  • TemperatureSampler, DeviceStateMonitor│       │                                          │
+└──────────────┬──────────────────────────┘        └───────────────┬──────────────────────────┘
+               │                     shared filesystem (incoming/ TIFF staging, session store)
+               └──────────────────────────────────────────────────┘
+```
+
+- The **device-layer process** (`device_layer.py`) is the *only* code that ever
+  touches the microscope: MMCore/pymmcore, the Ophyd devices, and a Bluesky
+  `RunEngine`. All truly blocking hardware work is quarantined here.
+- The **app/viz process** (`app/agent.py`, FastAPI+uvicorn) owns everything
+  cognitive and user-facing: the agent, the `TimelapseOrchestrator`, the
+  `Perceiver` (external `gently_perception` VLM package), the Anthropic clients,
+  the in-process `EventBus`, the WebSocket `ConnectionManager`, and the pollers.
+- The app reaches hardware **only** through `DiSPIMClient` (`client.py`), over a
+  single shared `aiohttp.ClientSession`. It never imports MMCore.
+
+Because blocking hardware calls live in a separate process, the app-side loop
+stays a light cooperative-asyncio world.
+
+## 2. One asyncio event loop per process
+
+- **Device loop:** HTTP routes + the RunEngine driver + the plan queue/executor +
+  three state pollers (XY ~5 Hz, piezo/galvo ~1 Hz, full property cache ~15 s) +
+  subscriber-gated camera/lightsheet SSE streamers.
+- **App loop:** FastAPI + the `TimelapseOrchestrator` acquisition loop +
+  `TemperatureSampler` (1 Hz) + `DeviceStateMonitor` + `Perceiver` calls + one
+  coroutine per open browser WebSocket.
+
+## 3. The core trick: hardware is serialized, not parallelized
+
+Every Bluesky plan — a move, a snap, a volume/burst acquisition, a focus/calibration
+sweep — is submitted as a `PlanRequest` onto **one `asyncio.Queue`
+(`self._plan_queue`), drained by one `_plan_executor` task**. Only one plan owns
+the hardware at a time.
+
+- `submit_plan` enqueues and `await`s a per-request `asyncio.Future`; the executor
+  sets the result/exception, which flows back to the awaiting HTTP handler. On
+  failure the executor records it in `_plan_execution_log` and continues to the
+  next queued plan.
+- Underneath, **pymmcore's internal `g_core_lock` is the real mutex** serializing
+  every actual core call across pollers *and* plans. The `DiSPIMSystem` facade is
+  the single place the process touches MMCore.
+
+A microscope has one stage and one camera; single-file execution is correct, not
+a limitation.
+
+## 4. How constant polling coexists with long experiments
+
+Four cooperating mechanisms keep the loops responsive while a plan runs:
+
+1. **Offload blocking reads.** Every MMCore read, camera grab, SAM call, and
+   transient temperature probe goes through `asyncio.to_thread`; the camera
+   sequence runs on its own `threading.Thread` returning an Ophyd `Status`. The
+   loop itself never sits on I/O.
+2. **Split pollers by cadence.** The three device-state pollers are independent
+   tasks so a slow (~1.5 s) full-state-cache read cannot stall the ~5 Hz XY path.
+3. **`pause_state_updates()` — a reference-counted async context manager.** Heavy
+   plans (a `frozenset` of names) wrap execution in it, incrementing a counter;
+   every poller/streamer checks `if self._state_pause_counter > 0` and *skips its
+   MMCore read*, emitting only ~2 s heartbeats. The plan gets full serial/camera
+   bandwidth instead of the pollers fighting it for `g_core_lock`. Nested heavy
+   sections stack and unwind cleanly.
+4. **Telemetry bypasses the plan queue.** `GET /api/temperature/status` reads the
+   temperature Ophyd device directly (`temp.read()` over serial/MQTT — a device
+   wholly separate from MMCore); `GET /api/devices/state` returns the cached
+   `_state_latest` snapshot. Neither sits behind a running experiment, so status
+   polls are never blocked by a long acquisition. (MMCore push callbacks also
+   mirror joystick/property changes into `_state_latest` via
+   `loop.call_soon_threadsafe` with ~50 ms debouncing.)
+
+### Temperature specifically
+The vendor SDK backend (serial or MQTT) runs its own **background daemon thread**
+that ingests the controller's 500 ms telemetry broadcast into a cache
+(`self.telemetry`); `get_water_temp()`/`get_system_state()` return the cached
+value (non-blocking). `TemperatureController.read()` returns that cache, and
+`TemperatureSampler` (`interval_sec=1.0`) polls it at 1 Hz → persists + emits
+`TEMPERATURE_UPDATE`. So we ride the telemetry indirectly, resampled at 1 Hz.
+
+## 5. Image data travels via the filesystem, not JSON
+
+Arrays over ~1 MB are written as **TIFF into the shared `incoming/` staging dir**;
+only a small `{__file_ref__, path, shape, dtype}` dict crosses HTTP (`serialize_value`).
+The client resolves the ref with `tifffile` and hands the decoded array to
+`register_volume`, which renames the file into the session store and stamps it
+with the latest temperature sample — avoiding a multi-GB JSON blob and a double
+decode.
+
+## 6. Perception / VLM / events are decoupled (fire-and-forget)
+
+- **Perception never gates acquisition.** The `TimelapseOrchestrator` does
+  `asyncio.create_task(self._run_perception(...))` rather than awaiting it inline,
+  so a slow VLM call doesn't hold up the next embryo. Inside the task the
+  `Perceiver` and the Claude client are awaited cooperatively, and every Claude
+  call is wrapped in `asyncio.wait_for(timeout=30)` returning a safe fallback
+  instead of raising into the loop.
+- **The `EventBus` publishes without awaiting handlers** (`event_bus.py`): sync
+  handlers run inline, async handlers are scheduled via `asyncio.ensure_future` /
+  `loop.call_soon_threadsafe`; high-volume telemetry types skip the bounded
+  history deque, so one slow WebSocket client delays only its own broadcast.
+
+## 7. Backpressure & failure isolation
+
+- **SSE streams** use per-subscriber queues bounded at `maxsize=4`; device-state
+  broadcasts drop slow subscribers, camera/lightsheet streams drop the *oldest*
+  frame and push the newest so steady clients keep fresh frames.
+- **WebSocket fan-out** (`ConnectionManager.broadcast`) sends per client under an
+  `asyncio.Lock` and drops clients that error.
+- **Failure = a gap, not a crash.** A failed temperature poll logs once and backs
+  off (`1.0 s → min(interval*10, 30 s)`); a stalled SSE forces a watchdog
+  reconnect after 60 s (chosen to tolerate the quiet windows during heavy plans);
+  volume acquisition always disables lasers on error to protect the sample.
+- **Config safety.** `POST /api/temperature/config` refuses (`409`) while the
+  RunEngine is not idle or a ramp holds the controller lock; `health_check()` is
+  read-only and never flips the connected flag, so a transient status-poll timeout
+  can't disconnect an in-flight acquisition.
+
+## 8. Known limits & bottlenecks
+
+- **RunEngine on the loop.** `self.RE(plan)` is invoked synchronously on the
+  device-layer loop, so while a plan runs the loop is largely occupied — which is
+  exactly why heavy plans quiet the pollers and the app-side watchdog tolerates
+  60 s of silence. Whether the telemetry HTTP handlers stay fully responsive
+  mid-acquisition depends on Bluesky's internal threading (external package) and
+  is not verified from repo code.
+- **Unbounded in-flight perception.** `_perception_tasks` is a plain set that
+  self-prunes; sustained fast acquisition against a slow VLM could grow concurrent
+  Claude calls without an explicit cap. A semaphore is the obvious guard if
+  cadence is ever pushed.
+- **~~Synchronous O(n) prediction writes~~ — FIXED.** `store_prediction` used to
+  re-parse the entire `predictions.jsonl` on every append to compute the next id.
+  Now O(1) via a bounded tail read (`_last_jsonl_record`, `file_store.py`). Other
+  `FileStore` JSONL writes remain synchronous on the app loop but are single-line
+  appends.
+- **External VLM internals.** How `gently_perception`'s `Perceiver` implements its
+  VLM call (async httpx vs sync-in-thread) is not inspectable from this repo; the
+  orchestrator awaits it, implying a coroutine.
+
+## The model in one line
+
+Two single-threaded event loops; hardware fenced into one process behind a
+one-at-a-time plan queue; everything blocking pushed into threads; and the
+slow/cognitive work (VLM, persistence, UI) decoupled with fire-and-forget tasks —
+so the system *feels* concurrent while the microscope itself stays strictly
+serialized.
+
+---
+*Generated from a code-grounded architecture pass (Claude Opus 4.8), 2026-07-01.*

From d5d2c1a00b02d963369c4f4994d5fdb4b17ad7b5 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 13:30:07 +0530
Subject: [PATCH 288/314] fix(web): quiet 503 for laser-configs/cameras when
 device layer is offline
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

These read-only proxy GETs are polled by the manual/settings pages. When the
device layer isn't running, _resolve_client() returns a client that is not
connected, so the call raised ConnectionError and logged a full ERROR traceback
on every poll — noisy for an expected state (UI open without the device process).
Pre-check client.is_connected and return a quiet 503 instead; genuine failures
(connected but call errors) still log at ERROR.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/data.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 7461afff..7c0cad43 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -758,7 +758,9 @@ async def laser_configs():
         routes like room_light/status and temperature/status.
         """
         client = _resolve_client()
-        if client is None:
+        if client is None or not client.is_connected:
+            # Device layer offline is an expected state (e.g. UI open without the
+            # device process) — a quiet 503, not an ERROR traceback per poll.
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
             return await client.get_laser_configs()
@@ -794,7 +796,8 @@ async def cameras_list():
         No require_control — read-only status route, mirrors GET /api/devices/laser/configs.
         """
         client = _resolve_client()
-        if client is None:
+        if client is None or not client.is_connected:
+            # Device layer offline is expected — quiet 503, no ERROR traceback.
             raise HTTPException(status_code=503, detail="Microscope not connected")
         try:
             return await client.get_cameras()

From fb0e13eecfa6dba5749830a1b1cd7ccc447a3375 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Wed, 1 Jul 2026 13:40:20 +0530
Subject: [PATCH 289/314] feat(web): friendly login hint when a control action
 is denied (403)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Control routes 403 in account mode when no operator is logged in — previously the
only signal was a bare console 403 and a button that silently did nothing. Add a
single global fetch wrapper (control-auth.js) that detects a 403 on a mutating
/api/ request and shows a throttled 'Control required — Log in' toast (reusing
showGentlyToast) whose action navigates to /login. Reads only res.status, never
consumes the body, so callers are unaffected.

Verified end-to-end in account mode: real 403 -> toast with the message + Log in
button -> navigates to /login.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/js/control-auth.js | 47 +++++++++++++++++++++++++
 gently/ui/web/templates/index.html      |  1 +
 2 files changed, 48 insertions(+)
 create mode 100644 gently/ui/web/static/js/control-auth.js

diff --git a/gently/ui/web/static/js/control-auth.js b/gently/ui/web/static/js/control-auth.js
new file mode 100644
index 00000000..359a1e4e
--- /dev/null
+++ b/gently/ui/web/static/js/control-auth.js
@@ -0,0 +1,47 @@
+// control-auth.js — friendly, actionable hint when a control action is denied.
+//
+// Control routes (POST/PUT/DELETE that move hardware or mutate state) return 403
+// when the session lacks the control role — e.g. account mode with no operator
+// logged in. Without this, the only signal is a bare 403 in the console and a
+// button that silently does nothing. This installs a single global fetch wrapper
+// that surfaces a throttled "Control required — Log in" toast instead. It only
+// reads res.status (never consumes the body), so callers behave unchanged.
+(function () {
+    if (window.__gentlyControlAuthPatched) return;
+    window.__gentlyControlAuthPatched = true;
+
+    const origFetch = window.fetch.bind(window);
+    let lastHintAt = 0;
+
+    function isControlRequest(input, init) {
+        let method = (init && init.method) || (typeof input === 'object' && input && input.method) || 'GET';
+        method = String(method).toUpperCase();
+        if (method === 'GET' || method === 'HEAD' || method === 'OPTIONS') return false;
+        const url = typeof input === 'string' ? input : (input && input.url) || '';
+        return url.includes('/api/');
+    }
+
+    function showLoginHint() {
+        const now = Date.now();
+        if (now - lastHintAt < 4000) return;  // throttle so repeated clicks don't stack
+        lastHintAt = now;
+        const msg = 'Control required — you are in view-only mode.';
+        if (typeof showGentlyToast === 'function') {
+            showGentlyToast(msg, 'Log in', () => { window.location.href = '/login'; }, 7000);
+        } else {
+            console.warn(msg + ' Log in at /login to drive hardware.');
+        }
+    }
+
+    window.fetch = async function (input, init) {
+        const res = await origFetch(input, init);
+        try {
+            if (res.status === 403 && isControlRequest(input, init)) {
+                showLoginHint();
+            }
+        } catch (_) {
+            // Never let the hint interfere with the actual response.
+        }
+        return res;
+    };
+})();
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 0f367e07..c9f7a402 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -1326,6 +1326,7 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
     <script src="/static/js/timepoint-player.js"></script>
     <script src="/static/js/viewer.js"></script>
     <script src="/static/js/gallery.js"></script>
+    <script src="/static/js/control-auth.js"></script>
     <script src="/static/js/events.js"></script>
     <script src="/static/js/embryos.js"></script>
     <script src="/static/js/projection-viewer.js"></script>

From 33635d724effb0ccd3b64fea15bfb92671afbb7e Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 12:11:17 -0400
Subject: [PATCH 290/314] feat(temperature): bundle ACUITYnano serial SDK
 in-repo

Vendor granted permission to redistribute their serial transport, so it's
now bundled under gently.hardware.vendor instead of requiring a per-machine
install. temperature.py loads it via _load_vendor(), which prefers a
system-installed copy of the same package name (letting an official vendor
update override) and falls back to the bundled copy.

The MQTT transport (acuitynano_precision_thermalizer_api) is deliberately
NOT bundled: it embeds broker credentials. Install it on the device-layer
machine for backend: mqtt.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/temperature.py                | 45 ++++++++--
 gently/hardware/vendor/__init__.py            | 16 ++++
 ...acuitynano_precision_thermalizer_serial.py | 83 +++++++++++++++++++
 3 files changed, 137 insertions(+), 7 deletions(-)
 create mode 100644 gently/hardware/vendor/__init__.py
 create mode 100644 gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py

diff --git a/gently/hardware/temperature.py b/gently/hardware/temperature.py
index dba8865b..b4e3dae8 100644
--- a/gently/hardware/temperature.py
+++ b/gently/hardware/temperature.py
@@ -20,9 +20,14 @@
 peltier temp when the transport provides it). BLE-style work runs in a worker
 thread so the Status integrates with the RunEngine.
 
-NOTE: the vendor `acuitynano_precision_thermalizer_*` packages are NOT on PyPI —
-install them on the device-layer machine. Local logic can be exercised with the
-built-in mock backend: `python gently/hardware/temperature.py --mock 20`.
+NOTE: the vendor `acuitynano_precision_thermalizer_*` packages are NOT on PyPI.
+gently bundles the SERIAL transport under `gently.hardware.vendor`; the MQTT
+transport is NOT bundled (it embeds broker credentials) so install it on the
+device-layer machine to use `backend: mqtt`. A system-installed copy of either
+name takes precedence over the bundled one. Both transports need the `device`
+extra (`uv sync --extra device`) for pyserial / paho-mqtt. Local logic can be
+exercised with the built-in mock backend:
+`python gently/hardware/temperature.py --mock 20`.
 """
 
 from __future__ import annotations
@@ -38,22 +43,48 @@
 TEMP_MAX_C = 99.9
 
 
+def _load_vendor(module: str, cls: str):
+    """Resolve a vendor SDK class, preferring a system-installed copy.
+
+    The ACUITYnano packages aren't on PyPI. gently bundles the SERIAL transport
+    under ``gently.hardware.vendor``; the MQTT transport is NOT bundled (it
+    embeds broker credentials), so it must be installed on the device-layer
+    machine. We try the top-level module name first (lets an officially-installed
+    vendor build override the bundled one), then fall back to the vendored copy.
+    """
+    import importlib
+
+    last_err: ImportError | None = None
+    for name in (module, f"gently.hardware.vendor.{module}"):
+        try:
+            return getattr(importlib.import_module(name), cls)
+        except ImportError as exc:
+            last_err = exc
+            continue
+    raise ImportError(
+        f"could not import {cls}: {module!r} is not installed and there is no "
+        f"bundled gently.hardware.vendor copy ({last_err})"
+    ) from last_err
+
+
 def _make_backend(cfg: dict):
     """Construct the vendor SDK transport from a config mapping."""
     backend = str(cfg.get("backend", "serial")).lower()
     if backend == "mock":
         return _MockBackend()
     if backend == "serial":
-        from acuitynano_precision_thermalizer_serial import (
-            AcuityNanoPrecisionThermalizerSerial,
+        AcuityNanoPrecisionThermalizerSerial = _load_vendor(
+            "acuitynano_precision_thermalizer_serial",
+            "AcuityNanoPrecisionThermalizerSerial",
         )
 
         return AcuityNanoPrecisionThermalizerSerial(
             cfg["com_port"], baud_rate=cfg.get("baud_rate", 115200)
         )
     if backend == "mqtt":
-        from acuitynano_precision_thermalizer_api import (
-            AcuityNanoPrecisionThermalizerAPI,
+        AcuityNanoPrecisionThermalizerAPI = _load_vendor(
+            "acuitynano_precision_thermalizer_api",
+            "AcuityNanoPrecisionThermalizerAPI",
         )
 
         # The vendor package ships with an embedded HiveMQ Cloud broker + creds,
diff --git a/gently/hardware/vendor/__init__.py b/gently/hardware/vendor/__init__.py
new file mode 100644
index 00000000..a8b74ea5
--- /dev/null
+++ b/gently/hardware/vendor/__init__.py
@@ -0,0 +1,16 @@
+"""Vendored third-party SDKs bundled with gently.
+
+Vendor-supplied packages that are NOT published to PyPI, copied in so the device
+layer always has them regardless of the machine's environment.
+
+- ``acuitynano_precision_thermalizer_serial`` — USB serial transport for the
+  ACUITYnano Precision Thermal Controller.
+
+The MQTT transport (``acuitynano_precision_thermalizer_api``) is deliberately
+NOT bundled here: it embeds broker credentials, which don't belong in the repo.
+Install it on the device-layer machine if you use ``backend: mqtt``.
+
+``gently.hardware.temperature`` imports these via ``_load_vendor()``, preferring
+a system-installed copy of the same package name (so an official vendor update
+can override), and falling back to the bundled copy here.
+"""
diff --git a/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py b/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py
new file mode 100644
index 00000000..e5ed7118
--- /dev/null
+++ b/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py
@@ -0,0 +1,83 @@
+"""ACUITYnano Precision Thermalizer — USB serial transport (vendored).
+
+Vendor-supplied SDK, not on PyPI; bundled with gently so the device layer always
+has it. Requires ``pyserial`` (the ``device`` extra). See gently.hardware.vendor.
+"""
+import threading
+import time
+
+import serial
+
+
+class AcuityNanoPrecisionThermalizerSerial:
+    def __init__(self, com_port, baud_rate=115200):
+        self.telemetry = {
+            "target": 20.0,
+            "water": 20.0,
+            "peltier": 20.0,
+            "state": "DISCONNECTED",
+            "errors": "0",
+        }
+        self.running = True
+        self.ser = serial.Serial(com_port, baud_rate, timeout=0.1)
+        time.sleep(2)
+
+        self.thread = threading.Thread(target=self._read_loop, daemon=True)
+        self.thread.start()
+
+    def _read_loop(self):
+        while self.running and self.ser.is_open:
+            try:
+                if self.ser.in_waiting:
+                    line = self.ser.readline().decode("utf-8", errors="ignore").strip()
+                    if "=" in line:
+                        key, val = line.split("=", 1)
+                        if key == "TARGET":
+                            self.telemetry["target"] = float(val)
+                        elif key == "WATER":
+                            self.telemetry["water"] = float(val)
+                        elif key == "ACTUAL":
+                            self.telemetry["peltier"] = float(val)
+                        elif key == "STATE":
+                            self.telemetry["state"] = val
+                        elif key == "ERRORS":
+                            self.telemetry["errors"] = val
+            except Exception:
+                pass
+            time.sleep(0.01)
+
+    def close(self):
+        self.running = False
+        if self.ser.is_open:
+            self.ser.close()
+
+    def set_temperature(self, target_celsius):
+        if 0.0 <= target_celsius <= 99.9:
+            cmd = f"TEMP={target_celsius}\n"
+            self.ser.write(cmd.encode("utf-8"))
+        else:
+            raise ValueError("Target must be between 0.0 and 99.9 C")
+
+    def enable_tec(self, enable=True):
+        val = "1" if enable else "0"
+        cmd = f"ENABLE={val}\n"
+        self.ser.write(cmd.encode("utf-8"))
+
+    def set_feedback_sensor(self, use_peltier=False):
+        val = "1" if use_peltier else "0"
+        cmd = f"SENSOR={val}\n"
+        self.ser.write(cmd.encode("utf-8"))
+
+    def get_water_temp(self):
+        return self.telemetry["water"]
+
+    def get_system_state(self):
+        return self.telemetry["state"]
+
+    def wait_for_target(self, timeout_seconds=300):
+        start = time.time()
+        while time.time() - start < timeout_seconds:
+            if "[ SYSTEM LOCKED ]" in self.telemetry["state"]:
+                return True
+            time.sleep(0.5)
+        return False

From c49e52437ebe21f4be937bd2f474db9c15ee2b47 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 12:22:42 -0400
Subject: [PATCH 291/314] build(deps): move hardware-control stack into
 default-on `device` group

Cherry-pick of 87a52c52 (gently-project/development): the device-layer
stack (pymmcore/bluesky/ophyd + bleak/pyserial/paho-mqtt) moves from the
base deps and the `device` *extra* into a `[dependency-groups] device`
group that is default-on via `[tool.uv] default-groups = ["dev", "device"]`.

Dependency groups are not pruned by `--extra` selection, so
`uv sync --extra sam --extra torch-gpu` no longer strips pyserial/paho-mqtt/
bleak (which broke the temperature serial/MQTT backends and the SwitchBot
room light). Drop the stack on a no-microscope machine with
`uv sync --no-group device`.

Lock regenerated locally rather than taking the upstream uv.lock (branch has
diverged); dependency set is unchanged, only group markers move.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md      | 16 ++++++++++++----
 pyproject.toml | 48 ++++++++++++++++++++++++++++++------------------
 uv.lock        | 34 ++++++++++++++++++----------------
 3 files changed, 60 insertions(+), 38 deletions(-)

diff --git a/README.md b/README.md
index 924f92cb..7f7a5b16 100644
--- a/README.md
+++ b/README.md
@@ -116,15 +116,23 @@ You get a `.venv` in the project directory with the runtime + dev dependencies
 pinned in `uv.lock`. Activate it with `source .venv/bin/activate`, or prefix
 commands with `uv run` (e.g. `uv run python ...`) to use it without activating.
 
-#### Optional extras
+#### The `device` group and optional extras
+
+The hardware-control stack (`pymmcore`, `bluesky`, `ophyd`) plus the accessory
+transports (BLE/serial/MQTT — SwitchBot room light, ACUITYnano thermal
+controller) live in the `device` dependency group, which is **installed by
+default**. None of it is imported by the agent or by `--offline` launch — only
+by the device layer — so a machine with no microscope can drop the whole stack:
+
+```bash
+# Laptop / review / CI — no microscope, skip the hardware-control stack
+uv sync --no-group device
+```
 
 PyTorch is **not** in the base install — the CUDA build is machine-specific, so
 it lives in mutually-exclusive extras wired to the right PyTorch index:
 
 ```bash
-# Device-layer accessories (microscope computer): BLE/serial/MQTT transports
-uv sync --extra device
-
 # PyTorch (needed for SAM detection and the ML pipeline)
 # NOTE: the GPU and CPU builds are mutually exclusive, so they can't be combined.
 uv sync --extra torch-gpu   # CUDA 11.8 build (GPU box, e.g. the microscope PC)
diff --git a/pyproject.toml b/pyproject.toml
index 56f6f2a3..5dcc5188 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -48,13 +48,11 @@ dependencies = [
     # Perception harness — installed as an editable sibling clone (see
     # [tool.uv.sources]); clone gently-project/gently-perception next to this repo.
     "gently-perception",
-    # Device control.
-    # pymmcore pinned exactly: its MMCore must match the device-interface version
-    # (70) of the Micro-Manager device adapters installed on the microscope PC.
-    # Bumping this requires upgrading the MM adapter install in lockstep.
-    "pymmcore==10.1.1.70.6",
-    "bluesky>=1.11.0",
-    "ophyd>=1.9.0",
+    # NOTE: the hardware-control stack (pymmcore / bluesky / ophyd) is NOT a base
+    # dep — it lives in the default-on `device` group below so a machine with no
+    # microscope can drop it via `uv sync --no-group device`. It is imported only
+    # by the device-layer process and gently.hardware.dispim, never by the agent
+    # or `--offline` launch.
     # NOTE: torch / torchvision / nvidia-ml-py are NOT base deps — CUDA build is
     # machine-specific. Install via an extra: `uv sync --extra torch-gpu` (CUDA
     # 11.8) or `uv sync --extra torch-cpu`. All torch imports are lazy/guarded.
@@ -81,19 +79,12 @@ torch-cpu = [
     "torch>=2.0.0",
     "torchvision>=0.15.0",
 ]
-# Device-layer accessories for the microscope computer. Core hardware-control
-# deps (pymmcore, bluesky, ophyd) are already in [project.dependencies]; these
-# are the extras the device layer needs: BLE (SwitchBot room light), serial and
-# MQTT transports (ACUITYnano thermal controller). Install: uv sync --extra device
-device = [
-    "bleak>=0.21.0",
-    "pyserial>=3.5",
-    "paho-mqtt>=1.6.0",
-]
 
-# Test/dev tooling — installed by `uv sync` (uv enables the `dev` group by
-# default) but excluded from gently's published runtime requirements.
+# Dependency groups are installed by `uv sync` (per [tool.uv] default-groups
+# below) but excluded from gently's published runtime requirements. Exclude any
+# group on a given machine with `uv sync --no-group <name>`.
 [dependency-groups]
+# Test/dev tooling.
 dev = [
     "pytest>=7.0.0",
     "pytest-asyncio>=0.21.0",
@@ -104,6 +95,23 @@ dev = [
     # and the install step in .github/workflows/lint.yml.
     "mypy==2.1.0",
 ]
+# Everything the microscope computer needs to drive hardware. Default-on (see
+# [tool.uv] default-groups); drop on a machine with no microscope via
+# `uv sync --no-group device`. None of these is imported by the agent or by
+# `--offline` launch — only by the device-layer process and gently.hardware.dispim.
+device = [
+    # pymmcore pinned exactly: its MMCore must match the device-interface version
+    # (70) of the Micro-Manager device adapters installed on the microscope PC.
+    # Bumping this requires upgrading the MM adapter install in lockstep.
+    "pymmcore==10.1.1.70.6",
+    "bluesky>=1.11.0",
+    "ophyd>=1.9.0",
+    # Accessory transports: BLE (SwitchBot room light), serial and MQTT
+    # (ACUITYnano thermal controller).
+    "bleak>=0.21.0",
+    "pyserial>=3.5",
+    "paho-mqtt>=1.6.0",
+]
 
 [project.scripts]
 gently = "launch_gently:cli_main"
@@ -111,6 +119,10 @@ gently = "launch_gently:cli_main"
 # torch-gpu and torch-cpu extras are mutually exclusive — they pull torch/
 # torchvision from different indexes, so they can't be installed together.
 [tool.uv]
+# Groups installed by default. `dev` is uv's implicit default; listing it here
+# keeps it on while also defaulting `device` (the microscope computer's
+# accessory transports) on. Exclude either with `uv sync --no-group <name>`.
+default-groups = ["dev", "device"]
 conflicts = [
     [{ extra = "torch-gpu" }, { extra = "torch-cpu" }],
 ]
diff --git a/uv.lock b/uv.lock
index 56e9f456..830aaca1 100644
--- a/uv.lock
+++ b/uv.lock
@@ -636,21 +636,18 @@ wheels = [
 
 [[package]]
 name = "gently"
-version = "0.22.0.dev0"
+version = "0.22.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },
     { name = "anthropic" },
-    { name = "bluesky" },
     { name = "fastapi" },
     { name = "gently-perception" },
     { name = "jinja2" },
     { name = "matplotlib" },
     { name = "numpy" },
     { name = "opencv-python-headless" },
-    { name = "ophyd" },
     { name = "pillow" },
-    { name = "pymmcore" },
     { name = "python-dotenv" },
     { name = "pyyaml" },
     { name = "scikit-image", version = "0.25.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (extra == 'extra-6-gently-torch-cpu' and extra == 'extra-6-gently-torch-gpu')" },
@@ -663,11 +660,6 @@ dependencies = [
 ]
 
 [package.optional-dependencies]
-device = [
-    { name = "bleak" },
-    { name = "paho-mqtt" },
-    { name = "pyserial" },
-]
 sam = [
     { name = "segment-anything" },
 ]
@@ -691,13 +683,19 @@ dev = [
     { name = "pytest-asyncio" },
     { name = "ruff" },
 ]
+device = [
+    { name = "bleak" },
+    { name = "bluesky" },
+    { name = "ophyd" },
+    { name = "paho-mqtt" },
+    { name = "pymmcore" },
+    { name = "pyserial" },
+]
 
 [package.metadata]
 requires-dist = [
     { name = "aiohttp", specifier = ">=3.9.0" },
     { name = "anthropic", specifier = ">=0.39.0" },
-    { name = "bleak", marker = "extra == 'device'", specifier = ">=0.21.0" },
-    { name = "bluesky", specifier = ">=1.11.0" },
     { name = "fastapi", specifier = ">=0.104.0" },
     { name = "gently-perception", editable = "../gently-perception" },
     { name = "jinja2", specifier = ">=3.1.0" },
@@ -705,11 +703,7 @@ requires-dist = [
     { name = "numpy", specifier = ">=1.24.0,<2" },
     { name = "nvidia-ml-py", marker = "extra == 'torch-gpu'", specifier = ">=12.0.0" },
     { name = "opencv-python-headless", specifier = ">=4.8.0" },
-    { name = "ophyd", specifier = ">=1.9.0" },
-    { name = "paho-mqtt", marker = "extra == 'device'", specifier = ">=1.6.0" },
     { name = "pillow", specifier = ">=10.0.0" },
-    { name = "pymmcore", specifier = "==10.1.1.70.6" },
-    { name = "pyserial", marker = "extra == 'device'", specifier = ">=3.5" },
     { name = "python-dotenv", specifier = ">=1.0.0" },
     { name = "pyyaml", specifier = ">=6.0" },
     { name = "scikit-image", specifier = ">=0.21.0" },
@@ -722,7 +716,7 @@ requires-dist = [
     { name = "torchvision", marker = "extra == 'torch-gpu'", specifier = ">=0.15.0", index = "https://download.pytorch.org/whl/cu118", conflict = { package = "gently", extra = "torch-gpu" } },
     { name = "uvicorn", extras = ["standard"], specifier = ">=0.24.0" },
 ]
-provides-extras = ["sam", "torch-gpu", "torch-cpu", "device"]
+provides-extras = ["sam", "torch-gpu", "torch-cpu"]
 
 [package.metadata.requires-dev]
 dev = [
@@ -732,6 +726,14 @@ dev = [
     { name = "pytest-asyncio", specifier = ">=0.21.0" },
     { name = "ruff", specifier = ">=0.4.0" },
 ]
+device = [
+    { name = "bleak", specifier = ">=0.21.0" },
+    { name = "bluesky", specifier = ">=1.11.0" },
+    { name = "ophyd", specifier = ">=1.9.0" },
+    { name = "paho-mqtt", specifier = ">=1.6.0" },
+    { name = "pymmcore", specifier = "==10.1.1.70.6" },
+    { name = "pyserial", specifier = ">=3.5" },
+]
 
 [[package]]
 name = "gently-perception"

From 7136498383b06d826a60c6b694f143751c539a65 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 12:26:55 -0400
Subject: [PATCH 292/314] fix(operate): correct marking stage origin + SAM
 room-light fallback
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two regressions in the operate-tab detect/mark flow that made calibration
image empty field:

1. Marking stage origin. The bottom-cam stream carried no stage position, so
   the operate canvas converted clicked pixels to stage coords relative to
   [0,0] instead of the true stage XY — embryos landed hundreds of µm off and
   calibration saw blank buffer. The device layer now stamps the real XY onto
   every bottom-cam frame (_current_stage_xy, never [0,0]); operate.js prefers
   that, falls back to the position stream, and BLOCKS marking (rather than
   silently using [0,0]) when neither is known. confirmMarks() guards the same.

2. SAM room-light fallback. detect_embryos forced the camera LED off before
   trying the room light; a missing/failed SwitchBot then left the frame
   near-black and SAM found nothing. Now the LED is only disabled once the
   room light is actually on; otherwise it falls back to the camera LED.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/hardware/dispim/device_layer.py | 46 +++++++++++++++++++++-----
 gently/ui/web/static/js/operate.js     | 14 +++++++-
 2 files changed, 51 insertions(+), 9 deletions(-)

diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index cf69f87e..922fca6e 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -989,6 +989,25 @@ def _encode_frame_for_stream(
             payload["focus_score"] = focus_score
         return payload
 
+    def _current_stage_xy(self) -> list[float] | None:
+        """Latest XY-stage position from the state cache, as ``[x, y]`` µm.
+
+        Sourced from the position poller (``kind == "xy_stage"``). Returns
+        ``None`` when no XY reading has arrived yet — callers MUST NOT fall
+        back to ``[0, 0]``: the operate-view marking canvas converts clicked
+        pixels to stage coords relative to this origin, so a bogus ``[0, 0]``
+        silently places every marker relative to stage origin instead of the
+        true position (embryos then land hundreds of µm off, and calibration
+        images empty field). Absent-is-better-than-wrong.
+        """
+        positions = self._state_latest.get("positions") or {}
+        for entry in positions.values():
+            if isinstance(entry, dict) and entry.get("kind") == "xy_stage":
+                x, y = entry.get("X"), entry.get("Y")
+                if x is not None and y is not None:
+                    return [float(x), float(y)]
+        return None
+
     async def _bottom_camera_streamer(self):
         """Continuous grab/encode/broadcast loop. Runs while a subscriber lives.
 
@@ -1008,6 +1027,13 @@ async def _bottom_camera_streamer(self):
                 img = await asyncio.to_thread(self._capture_bottom_frame_sync)
                 payload = self._encode_frame_for_stream(img) if img is not None else None
                 if payload is not None:
+                    # Stamp the true stage XY so the operate-view marking canvas
+                    # converts clicked pixels to absolute stage coords (not
+                    # offsets from origin). Omitted — never [0, 0] — when no XY
+                    # reading has arrived yet; the frontend then blocks marking.
+                    xy = self._current_stage_xy()
+                    if xy is not None:
+                        payload["stage_position"] = xy
                     await self._broadcast_camera(payload)
                 # Pace the loop — sleep whatever's left of the interval.
                 elapsed = time.monotonic() - tick
@@ -2792,19 +2818,23 @@ async def handle_detect_embryos(self, request):
                 if bottom_camera:
                     bottom_camera.configure_exposure(exposure_ms)
 
-            # Detection always images under ROOM LIGHT, never the camera LED.
-            # use_led is a persistent device flag that other flows (e.g. manual
-            # marking via capture_for_marking) leave switched on, so force it
-            # off here and turn the room light on so there's illumination.
+            # Detection needs even illumination. Prefer the ROOM LIGHT
+            # (SwitchBot) and disable the camera LED. But the room light is an
+            # OPTIONAL BLE accessory — when it's absent or the command fails,
+            # forcing the LED off leaves the frame near-black and SAM finds
+            # nothing. So only disable the LED once the room light is actually
+            # on; otherwise fall back to the camera LED as the light source.
             bottom_camera = self.devices.get("bottom_camera")
-            if bottom_camera is not None:
-                bottom_camera.use_led = False
             if await self._set_room_light("on"):
+                if bottom_camera is not None:
+                    bottom_camera.use_led = False
                 logger.info("[detect_embryos] Room light ON, camera LED disabled")
             else:
+                if bottom_camera is not None:
+                    bottom_camera.use_led = True
                 logger.warning(
-                    "[detect_embryos] Could not turn room light on "
-                    "(no SwitchBot configured?) — capturing under ambient light"
+                    "[detect_embryos] Room light unavailable (no SwitchBot "
+                    "configured or command failed) — falling back to camera LED"
                 )
 
             # Capture image via plan
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 53e37e4e..3c32ae16 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -411,9 +411,18 @@ const OperateManager = (function () {
     }
     function enterMarking(cands) {
         if (!_lastFrame) { toast('Start the camera first'); return false; }
+        // Absolute stage origin for pixel→stage conversion. Prefer the XY
+        // stamped on the live frame by the device layer; fall back to the
+        // position stream. NEVER default to [0, 0] — that silently converts
+        // clicks to offsets from stage origin, so embryos land hundreds of µm
+        // off and calibration images empty field. Block marking instead.
+        const capStage = (Array.isArray(_lastFrame.stage_position) && _lastFrame.stage_position.length === 2)
+            ? _lastFrame.stage_position
+            : (_lastXY ? [_lastXY.X, _lastXY.Y] : null);
+        if (!capStage) { toast('Stage position unknown — wait for the position readout, then mark'); return false; }
         _marking = true;
         _frozenFrame = { w: _lastFrame.shape[1], h: _lastFrame.shape[0], downsample: _lastFrame.downsample || 1 };
-        _captureStage = _lastFrame.stage_position || (_lastXY ? [_lastXY.X, _lastXY.Y] : [0, 0]);
+        _captureStage = capStage;
         _frozenSrc = `data:${_lastFrame.mime || 'image/jpeg'};base64,${_lastFrame.jpeg_b64}`;
         D['op-cam-img'].src = _frozenSrc; D['op-cam-img'].classList.add('has-frame'); D['op-cam-ph'].style.display = 'none';
         _markers = [];
@@ -472,6 +481,9 @@ const OperateManager = (function () {
     }
     async function confirmMarks() {
         if (!_markers.length) return;
+        if (!Array.isArray(_captureStage) || _captureStage.length !== 2) {
+            toast('Stage position unknown — cannot register markers'); return;
+        }
         D['op-confirm'].disabled = true;
         try {
             const markers = _markers.map(m => ({ stage_x_um: m.stageX, stage_y_um: m.stageY, pixel_x: m.fx, pixel_y: m.fy, source: m.source }));

From 236e94084ab9e8cd9d0f27cab0308bc82c9429a3 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 12:37:34 -0400
Subject: [PATCH 293/314] feat(operate): add per-embryo piezo-galvo calibration
 step
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The operate spine went B3 focus → B4 acquire with no calibration, so volumes
were acquired without a per-embryo piezo↔galvo fit. Add a "Calibrate" step
(node bc) between Focus and Acquire:

- Frontend: new stepper node + rail group, a 'calibrated' state ranked between
  focused and imaged, wired into the single renderStep() driver (step map,
  camera map, stepper order, board/minimap colors). Focus now advances to bc;
  Calibrate (or Skip) advances to Acquire. Acquire's guard relaxes from
  ==focused to >=focused so a calibrated embryo can be imaged.
- Backend: POST /api/devices/embryos/{id}/calibrate runs the agent's proven
  calibrate_embryo tool via the registry (Claude-vision edge detection +
  adaptive sweep, which sets the light-sheet laser config per snap) with an
  injected agent/client context — no LLM orchestration. Result persists on
  embryo.calibration; the rail shows slope + R².

Engine choice: reuses calibrate_embryo rather than the bare
calibrate_piezo_galvo_plan, which defers to focus_sweep_plan and does not
clearly set the laser config (risking the dark-frame failure just fixed).
Not yet hardware-verified end to end — the step + wiring are in place for a
rig test.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/routes/data.py         | 47 ++++++++++++++++++++++++
 gently/ui/web/static/css/operate.css |  1 +
 gently/ui/web/static/js/operate.js   | 53 ++++++++++++++++++++++------
 gently/ui/web/templates/index.html   | 10 ++++++
 4 files changed, 101 insertions(+), 10 deletions(-)

diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index 7c0cad43..8dfc1729 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -1021,6 +1021,53 @@ def _next_embryo_id(taken: set) -> str:
         labelled = _persist_detection_labels(agent, payload, markers)
         return {"success": True, "registered": registered, "labelled": labelled}
 
+    @router.post(
+        "/api/devices/embryos/{embryo_id}/calibrate",
+        dependencies=[Depends(require_control)],
+    )
+    async def calibrate_embryo_route(embryo_id: str, payload: dict = Body(default={})):  # noqa: B008
+        """Run piezo-galvo calibration for one embryo — the Operate B-cal step.
+
+        Reuses the agent's proven ``calibrate_embryo`` tool (Claude-vision edge
+        detection + adaptive focus sweep, which sets the light-sheet laser config
+        per snap) rather than the bare device-layer plan, so the operate flow
+        gets the same calibration quality as the agent. No LLM orchestration —
+        the coroutine is called directly with an agent/client context. The SPIM
+        head should already be lowered + focused (operate reaches this step only
+        after B3). Persists the fit onto ``embryo.calibration``.
+        """
+        agent = _require_agent_with_experiment()
+        if embryo_id not in agent.experiment.embryos:
+            raise HTTPException(status_code=404, detail=f"unknown embryo {embryo_id}")
+        client = _resolve_client()
+        if client is None or not getattr(client, "is_connected", False):
+            raise HTTPException(status_code=503, detail="Microscope not connected")
+
+        # Ensure the calibration tools are registered on the global registry,
+        # then run via the registry so context (agent/client) is injected the
+        # same way the agent invokes it. Calling the @tool wrapper directly would
+        # drop the positional embryo_id.
+        import gently.app.tools.calibration_tools  # noqa: F401  (registers the tool)
+        from gently.harness.tools.registry import get_tool_registry
+
+        registry = get_tool_registry()
+        try:
+            message = await registry.execute(
+                "calibrate_embryo",
+                {"embryo_id": embryo_id},
+                {"agent": agent, "client": client},
+            )
+        except Exception as exc:
+            logger.exception("Calibration failed for %s", embryo_id)
+            raise HTTPException(status_code=502, detail=f"calibration failed: {exc}") from exc
+        if isinstance(message, str) and message.startswith("Error"):
+            raise HTTPException(status_code=502, detail=message)
+
+        emb = agent.experiment.embryos.get(embryo_id)
+        calibration = dict(getattr(emb, "calibration", {}) or {}) if emb else {}
+        agent.experiment.notify_embryos_changed()
+        return {"success": True, "message": message, "calibration": calibration}
+
     @router.post("/api/embryos/roles", dependencies=[Depends(require_control)])
     async def set_embryo_roles(payload: dict = Body(...)):  # noqa: B008
         """Assign experimental roles to embryos — the Operate "Run" step.
diff --git a/gently/ui/web/static/css/operate.css b/gently/ui/web/static/css/operate.css
index e91dcc37..cd28b6a7 100644
--- a/gently/ui/web/static/css/operate.css
+++ b/gently/ui/web/static/css/operate.css
@@ -175,6 +175,7 @@
 .op-rail[data-active="b1"] .op-group[data-step="b1"],
 .op-rail[data-active="b2"] .op-group[data-step="b2"],
 .op-rail[data-active="b3"] .op-group[data-step="b3"],
+.op-rail[data-active="bc"] .op-group[data-step="bc"],
 .op-rail[data-active="b4"] .op-group[data-step="b4"],
 .op-rail[data-active="b5"] .op-group[data-step="b5"],
 .op-rail[data-active="c0"] .op-group[data-step="c0"],
diff --git a/gently/ui/web/static/js/operate.js b/gently/ui/web/static/js/operate.js
index 3c32ae16..527e5fe1 100644
--- a/gently/ui/web/static/js/operate.js
+++ b/gently/ui/web/static/js/operate.js
@@ -23,7 +23,7 @@ const OperateManager = (function () {
     const MARK_HIT_PX = 14;
     const SVG_NS = 'http://www.w3.org/2000/svg';
     const ROLE_NEUTRAL = '#8a8f98';
-    const STATE_RANK = { marked: 0, centered: 1, lowering: 2, focused: 3, imaged: 4 };
+    const STATE_RANK = { marked: 0, centered: 1, lowering: 2, focused: 3, calibrated: 4, imaged: 5 };
 
     let _wired = false, _active = false;
 
@@ -82,7 +82,8 @@ const OperateManager = (function () {
             'op-rail', 'op-rail-head', 'op-cam-toggle', 'op-bz-pos', 'op-bz-score', 'op-bz-nudge',
             'op-tomark', 'op-detect', 'op-confirm', 'op-mark-count', 'op-clear', 'op-center', 'op-center-hint',
             'op-fd-pos', 'op-fd-floor', 'op-fd-nudge', 'op-fd-d100', 'op-fd-d10', 'op-tofocus',
-            'op-spim-toggle', 'op-led', 'op-gv', 'op-pz', 'op-spim-score', 'op-infocus', 'op-acquire', 'op-retract',
+            'op-spim-toggle', 'op-led', 'op-gv', 'op-pz', 'op-spim-score', 'op-infocus',
+            'op-calibrate', 'op-cal-result', 'op-cal-skip', 'op-acquire', 'op-retract',
             'op-rolechips', 'op-modes', 'op-panel-adaptive', 'op-panel-library', 'op-panel-plan', 'op-panel-agent',
             'op-tl-interval', 'op-tl-stop', 'op-tl-condval', 'op-tl-monitor', 'op-lib-list', 'op-plan-list',
             'op-run-start', 'op-runspine', 'op-run-pause', 'op-run-stop', 'op-run-open',
@@ -91,7 +92,7 @@ const OperateManager = (function () {
 
     // ── step model ───────────────────────────────────────────────────────
     function stepForState(st) {
-        return { marked: 'b1', centered: 'b2', lowering: 'b2', focused: 'b4', imaged: 'b5' }[st] || 'b1';
+        return { marked: 'b1', centered: 'b2', lowering: 'b2', focused: 'bc', calibrated: 'b4', imaged: 'b5' }[st] || 'b1';
     }
     function effectiveStep() {
         if (_marking) return 'a2';
@@ -102,17 +103,17 @@ const OperateManager = (function () {
     }
     function cameraForStep(step) {
         if (step === 'a1' || step === 'a2' || step === 'b1') return 'bottom';
-        if (step === 'b2' || step === 'b3' || step === 'b4' || step === 'b5') return 'spim';
+        if (step === 'b2' || step === 'b3' || step === 'bc' || step === 'b4' || step === 'b5') return 'spim';
         return 'none';  // c0 / running are non-camera (the dish map carries context)
     }
 
     const RAIL_HEADS = {
         a1: 'Focus the bottom objective', a2: 'Mark all embryos',
         b1: 'Center the embryo', b2: 'Lower the SPIM head', b3: 'Focus the SPIM objective',
-        b4: 'Acquire the volume', b5: 'Retract & advance',
+        bc: 'Calibrate piezo-galvo', b4: 'Acquire the volume', b5: 'Retract & advance',
         c0: 'Run — choose how to image', running: 'Run — live',
     };
-    const STEP_NODE = { a1: 'a1', a2: 'a2', b1: 'b1', b2: 'b2', b3: 'b3', b4: 'b4', b5: 'b4', c0: 'run', running: 'run' };
+    const STEP_NODE = { a1: 'a1', a2: 'a2', b1: 'b1', b2: 'b2', b3: 'b3', bc: 'bc', b4: 'b4', b5: 'b4', c0: 'run', running: 'run' };
 
     function setStep(s) { _step = s; renderStep(); }
 
@@ -133,7 +134,7 @@ const OperateManager = (function () {
         // stepper nodes (done/active/locked) driven by selected embryo's state
         const st = _selected ? (_states[_selected] || 'marked') : null;
         const rank = st ? STATE_RANK[st] : -1;
-        const order = { b1: 0, b2: 1, b3: 2, b4: 3 };
+        const order = { b1: 0, b2: 1, b3: 2, bc: 3, b4: 4 };
         D['op-stepper'].querySelectorAll('.op-node').forEach(n => {
             const node = n.dataset.node;
             n.classList.remove('is-active', 'is-done', 'is-locked');
@@ -290,7 +291,7 @@ const OperateManager = (function () {
             const st = _states[emb.id] || 'marked';
             const c = document.createElementNS(SVG_NS, 'circle');
             c.setAttribute('cx', toX(xy.x)); c.setAttribute('cy', toY(xy.y)); c.setAttribute('r', r);
-            const col = st === 'imaged' ? 'var(--accent-green)' : st === 'focused' ? 'var(--accent-orange)'
+            const col = st === 'imaged' ? 'var(--accent-green)' : (st === 'focused' || st === 'calibrated') ? 'var(--accent-orange)'
                 : (st === 'centered' || st === 'lowering') ? 'var(--accent)' : ROLE_NEUTRAL;
             c.setAttribute('fill', col);
             if (emb.id === _selected) { c.setAttribute('stroke', 'var(--text)'); c.setAttribute('stroke-width', '1.2'); }
@@ -572,13 +573,43 @@ const OperateManager = (function () {
     }
     function markInFocus() {
         if (!_selected) return;
-        advanceState(_selected, 'focused'); forceLedOff(); setStep('b4');
+        advanceState(_selected, 'focused'); forceLedOff(); setStep('bc');
         toast(`Embryo ${labelFor(_embryos.find(e => e.id === _selected))} in focus`);
     }
 
+    // ── B-cal calibrate (piezo-galvo) ──────────────────────────────────────
+    async function calibrateSelected() {
+        if (!_selected) return;
+        if (STATE_RANK[_states[_selected] || 'marked'] < STATE_RANK.focused) { toast('Focus the embryo first'); return; }
+        D['op-calibrate'].disabled = true; D['op-calibrate'].textContent = 'Calibrating…';
+        if (D['op-cal-result']) D['op-cal-result'].textContent = 'sweeping…';
+        try {
+            const d = await postJSON(`/api/devices/embryos/${_selected}/calibrate`, {});
+            const cal = d.calibration || {};
+            const slope = cal.slope_um_per_deg, r2 = cal.r_squared;
+            if (D['op-cal-result']) {
+                D['op-cal-result'].textContent = (slope != null)
+                    ? `${Number(slope).toFixed(1)} µm/deg${r2 != null ? ` · R² ${Number(r2).toFixed(2)}` : ''}`
+                    : 'done';
+            }
+            advanceState(_selected, 'calibrated'); setStep('b4');
+            toast(`Calibrated embryo ${labelFor(_embryos.find(e => e.id === _selected))}`);
+        } catch (e) {
+            if (D['op-cal-result']) D['op-cal-result'].textContent = 'failed';
+            toast(`Calibrate failed (${e.status || e.message})`);
+        } finally {
+            D['op-calibrate'].disabled = false; D['op-calibrate'].textContent = 'Calibrate this embryo';
+        }
+    }
+    function skipCalibration() {
+        if (!_selected) return;
+        advanceState(_selected, 'calibrated'); setStep('b4');
+        toast('Calibration skipped');
+    }
+
     // ── B4 acquire ─────────────────────────────────────────────────────────
     async function acquireSelected() {
-        if (!_selected || _states[_selected] !== 'focused') { toast('Focus the embryo first'); return; }
+        if (!_selected || STATE_RANK[_states[_selected] || 'marked'] < STATE_RANK.focused) { toast('Focus the embryo first'); return; }
         D['op-acquire'].disabled = true; D['op-acquire'].textContent = 'Acquiring…'; _acquiring = true; renderStatus();
         try {
             await postJSON('/api/devices/acquire/volume', { num_slices: 50, exposure_ms: 10.0 });
@@ -845,6 +876,8 @@ const OperateManager = (function () {
         document.querySelectorAll('[data-gv]').forEach(b => b.addEventListener('click', () => nudgeGalvo(Number(b.dataset.gv))));
         document.querySelectorAll('[data-pz]').forEach(b => b.addEventListener('click', () => nudgePiezo(Number(b.dataset.pz))));
         D['op-infocus'].addEventListener('click', markInFocus);
+        if (D['op-calibrate']) D['op-calibrate'].addEventListener('click', calibrateSelected);
+        if (D['op-cal-skip']) D['op-cal-skip'].addEventListener('click', skipCalibration);
         D['op-acquire'].addEventListener('click', acquireSelected);
         D['op-retract'].addEventListener('click', retractAndAdvance);
         D['op-survey-btn'].addEventListener('click', surveyMore);
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index c9f7a402..14767be8 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -507,6 +507,8 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     <span class="op-arrow">→</span>
                     <span class="op-node" data-node="b3">Focus</span>
                     <span class="op-arrow">→</span>
+                    <span class="op-node" data-node="bc">Calibrate</span>
+                    <span class="op-arrow">→</span>
                     <span class="op-node" data-node="b4">Acquire</span>
                   </div>
                   <div class="op-status">
@@ -602,6 +604,14 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                     <button class="op-btn op-btn-primary" id="op-infocus" type="button">Mark in focus →</button>
                   </div>
 
+                  <div class="op-group" data-step="bc">
+                    <div class="op-cap">Piezo-galvo calibration</div>
+                    <button class="op-btn op-btn-primary" id="op-calibrate" type="button">Calibrate this embryo</button>
+                    <div class="op-hud-line">fit <b id="op-cal-result">—</b></div>
+                    <div class="op-hint">Sweeps the light sheet to fit the piezo↔galvo focus track. Head stays lowered.</div>
+                    <button class="op-btn op-btn-ghost" id="op-cal-skip" type="button">Skip calibration →</button>
+                  </div>
+
                   <div class="op-group" data-step="b4">
                     <div class="op-cap">50 slices · 10 ms</div>
                     <button class="op-btn op-btn-primary" id="op-acquire" type="button">Acquire volume</button>

From 565593cf24ff41cf728d57987dcf403b3400080d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 18:50:52 -0400
Subject: [PATCH 294/314] fix(devices-map): frame marked embryos so they aren't
 clipped off-map
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Devices > Map viewBox was computed from only the firmware fence box and
the current stage marker — embryos were never included. SAM/marked embryos
often sit hundreds of µm outside that frame (e.g. a detection cluster near
stage X≈-800 while the fence box straddles origin), so they rendered at the
map edge or off-screen and looked mis-positioned, even though their stored
coords are correct absolute stage µm.

- computeViewBox() now expands the bounds to include every embryo's resolved
  XY (fine if aligned, else coarse).
- handleEmbryosUpdate() now always recomputes the viewBox (via computeViewBox's
  changed-return) and does a full renderMap() when the frame widened, instead
  of only reframing on the first-ever load. Newly-arrived embryos now pull the
  frame out to include them.

Not a coordinate bug: verified the SAM path records absolute stage coords
(stage_position + pixel offset), consistent with the map's stage→SVG transform.
This is purely framing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/ui/web/static/js/devices.js | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/gently/ui/web/static/js/devices.js b/gently/ui/web/static/js/devices.js
index c48b05e8..47bf1605 100644
--- a/gently/ui/web/static/js/devices.js
+++ b/gently/ui/web/static/js/devices.js
@@ -417,8 +417,11 @@ const DevicesManager = (function () {
 
     function handleEmbryosUpdate(payload) {
         _embryos = (payload && Array.isArray(payload.embryos)) ? payload.embryos : [];
-        if (!_viewBox) {
-            computeViewBox();
+        // Recompute the frame so newly-arrived embryos are always in view.
+        // computeViewBox() returns true when the bounds shifted (incl. the
+        // first-ever compute); a wider frame needs a full redraw so grid/zones/
+        // axes track the new bounds, otherwise just repaint the embryo layer.
+        if (computeViewBox()) {
             renderMap();
         } else {
             renderEmbryos();
@@ -503,6 +506,18 @@ const DevicesManager = (function () {
             xMin = Math.min(xMin, _lastXY.X); xMax = Math.max(xMax, _lastXY.X);
             yMin = Math.min(yMin, _lastXY.Y); yMax = Math.max(yMax, _lastXY.Y);
         }
+        // Always frame the marked embryos — they can sit well outside the fence
+        // box / current stage position (e.g. SAM detections hundreds of µm away),
+        // and omitting them clips them to the map edge (looks like a wrong
+        // position even though their coords are correct).
+        if (_embryos && _embryos.length) {
+            _embryos.forEach(emb => {
+                const xy = embryoResolvedXY(emb);
+                if (!xy) return;
+                xMin = Math.min(xMin, xy.x); xMax = Math.max(xMax, xy.x);
+                yMin = Math.min(yMin, xy.y); yMax = Math.max(yMax, xy.y);
+            });
+        }
         if (!isFinite(xMin) || !isFinite(yMin)) {
             xMin = -100; xMax = 100; yMin = -100; yMax = 100;
         }

From d846dcda1088c26d8b904e3ffc1e421aba83b376 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Thu, 9 Jul 2026 00:49:45 -0400
Subject: [PATCH 295/314] fix(tools): coerce string tool args to annotated
 scalar types; quiet WS disconnect spam
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two robustness fixes for long-running sessions:

- registry.execute() now coerces incoming string arguments to their
  annotated int/float/bool types before invoking the handler. Tool inputs
  arrive as JSON from the model (and sometimes as UI form strings), so a
  param annotated `float` could show up as "120" and crash on a numeric
  comparison — e.g. set_embryo_cadence raised
  '<' not supported between instances of 'str' and 'int'. Coercion is
  conservative: only string values whose annotation resolves to a scalar
  are touched; unparseable values pass through for the tool to validate.

- log_config now silences the `websockets` library's ERROR-level
  "data transfer failed" tracebacks (raised on every ungraceful client
  disconnect / WinError 121). These are routine and flooded the console,
  burying real errors. Set below CRITICAL so genuine faults still surface.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/harness/tools/registry.py | 54 ++++++++++++++++++++++++++++++++
 gently/log_config.py             |  9 ++++++
 2 files changed, 63 insertions(+)

diff --git a/gently/harness/tools/registry.py b/gently/harness/tools/registry.py
index 88c37241..a9bad8a5 100644
--- a/gently/harness/tools/registry.py
+++ b/gently/harness/tools/registry.py
@@ -164,6 +164,55 @@ def _python_type_to_json_schema(python_type) -> str:
     return "string"
 
 
+def _unwrap_optional(tp: Any) -> Any:
+    """Reduce ``float | None`` / ``Optional[int]`` to the underlying scalar type.
+
+    Returns the single non-None member of a union, or the type unchanged for a
+    plain annotation. Returns None when there's no unambiguous scalar (so callers
+    skip coercion).
+    """
+    args = get_args(tp)
+    if args:
+        non_none = [a for a in args if a is not type(None)]
+        return non_none[0] if len(non_none) == 1 else None
+    return tp
+
+
+def _coerce_kwargs(handler: Callable, kwargs: dict) -> dict:
+    """Best-effort coercion of string tool args to their annotated scalar types.
+
+    Tool inputs arrive as JSON from the model (and sometimes as UI form strings),
+    so a param annotated ``float``/``int`` can show up as e.g. ``"120"``. Without
+    this, a downstream numeric comparison raises
+    ``'<' not supported between instances of 'str' and 'int'``. Coercion is
+    conservative: only string values whose annotation resolves to int/float/bool
+    are touched; anything that fails to parse is left as-is for the tool to report.
+    """
+    try:
+        hints = get_type_hints(handler)
+    except Exception:
+        return kwargs
+    for name, value in list(kwargs.items()):
+        if name == "context" or not isinstance(value, str):
+            continue
+        target = _unwrap_optional(hints.get(name))
+        if target in (int, float):
+            s = value.strip()
+            if not s:
+                continue
+            try:
+                kwargs[name] = target(s)
+            except (ValueError, TypeError):
+                pass
+        elif target is bool:
+            low = value.strip().lower()
+            if low in ("true", "1", "yes", "on"):
+                kwargs[name] = True
+            elif low in ("false", "0", "no", "off"):
+                kwargs[name] = False
+    return kwargs
+
+
 def _extract_parameters_from_function(func: Callable) -> list[ToolParameter]:
     """Extract parameter definitions from function signature and type hints"""
     sig = inspect.signature(func)
@@ -461,6 +510,11 @@ async def execute(self, tool_name: str, tool_input: dict, context: dict | None =
             # Prepare arguments
             kwargs = dict(tool_input)
 
+            # Coerce string args to their annotated scalar types. JSON/UI inputs
+            # can deliver e.g. new_interval_seconds="120", which would otherwise
+            # crash on a numeric comparison inside the tool.
+            kwargs = _coerce_kwargs(tool.handler, kwargs)
+
             # Inject context if handler expects it (but don't overwrite if already provided)
             sig = inspect.signature(tool.handler)
             if "context" in sig.parameters and "context" not in kwargs:
diff --git a/gently/log_config.py b/gently/log_config.py
index 69a673a0..97359672 100644
--- a/gently/log_config.py
+++ b/gently/log_config.py
@@ -69,6 +69,15 @@ def configure_logging(
     ):
         logging.getLogger(name).setLevel(logging.WARNING)
 
+    # The `websockets` library logs a full "data transfer failed" traceback at
+    # ERROR level every time a client disconnects ungracefully (e.g. a browser
+    # tab sleeping or dropping — Windows raises WinError 121, "semaphore timeout").
+    # These are routine, not faults, and flood the console hundreds of lines deep,
+    # burying real errors. Suppress below CRITICAL so a genuinely fatal WS fault
+    # still surfaces. WARNING is not enough here because the noise is ERROR-level.
+    for name in ("websockets", "websockets.server", "websockets.client"):
+        logging.getLogger(name).setLevel(logging.CRITICAL)
+
     # File handler — always INFO+ regardless of console level
     if log_file:
         file_fmt = os.environ.get("GENTLY_LOG_FILE_FORMAT", _DEFAULT_FILE_FORMAT)

From 08a67521a48e44f9529bc0eb712312cab021cbc0 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Sat, 11 Jul 2026 10:50:00 +0530
Subject: [PATCH 296/314] fix(lint): resolve post-merge ruff-format and mypy
 errors

The merge of development made mypy check function bodies the PR branch
had left untyped (development annotated the enclosing defs), surfacing
11 cross-branch errors; both parents were individually clean.

- agent.py: annotate temperature_sampler / operation_plan_updater /
  lightsheet_monitor attributes; guard seed_operation_plan_from_plan_item
  against a None session_id
- client.py: assert _session before lightsheet stream GET (house
  pattern); type the live-params body dict
- device_layer.py: annotate self.config and the sidecar 'existing' dict
- data.py: annotate new_tactics
- ruff format over 7 files the two branches formatted differently
---
 gently/analysis/focus_validation.py           |   6 +-
 gently/app/agent.py                           |  12 +-
 gently/app/orchestration/tactic_executor.py   |  35 +++-
 gently/hardware/dispim/client.py              |   3 +-
 gently/hardware/dispim/device_layer.py        |  77 +++++---
 ...acuitynano_precision_thermalizer_serial.py |   1 +
 gently/ui/web/routes/data.py                  | 184 +++++++++++++-----
 tests/test_focus_validation.py                |   2 +-
 tests/test_tactic_executor.py                 | 112 ++++++++---
 9 files changed, 306 insertions(+), 126 deletions(-)

diff --git a/gently/analysis/focus_validation.py b/gently/analysis/focus_validation.py
index b00c7f5a..3c44d3d9 100644
--- a/gently/analysis/focus_validation.py
+++ b/gently/analysis/focus_validation.py
@@ -40,7 +40,7 @@ class SweepResult:
     human_z: float
     predicted_z: float
     error_um: float
-    interior_peak: bool   # argmax strictly inside the sweep (not an endpoint)
+    interior_peak: bool  # argmax strictly inside the sweep (not an endpoint)
     score_contrast: float  # (max-min)/max — low ⇒ unreliable peak
 
 
@@ -49,8 +49,8 @@ class ValidationReport:
     n_sweeps: int
     median_error_um: float
     p95_error_um: float
-    within_margin_frac: float    # fraction with error <= margin_um
-    interior_peak_frac: float    # fraction whose metric peak is interior
+    within_margin_frac: float  # fraction with error <= margin_um
+    interior_peak_frac: float  # fraction whose metric peak is interior
     sweeps: list[SweepResult] = field(default_factory=list)
 
 
diff --git a/gently/app/agent.py b/gently/app/agent.py
index 5c132905..62602481 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -29,6 +29,9 @@
     from ..ui.web.server import VisualizationServer
     from .bottom_camera_monitor import BottomCameraStreamMonitor
     from .device_state_monitor import DeviceStateMonitor
+    from .lightsheet_monitor import LightSheetStreamMonitor
+    from .operation_plan_updater import OperationPlanUpdater
+    from .temperature_sampler import TemperatureSampler
 
 from gently_perception import Perceiver
 
@@ -213,14 +216,14 @@ def __init__(
         # Device-state monitor (bridges device-layer SSE → EventBus)
         self.device_state_monitor: DeviceStateMonitor | None = None
         # Session-scoped temperature sampler — polls device layer, persists readings.
-        self.temperature_sampler = None
+        self.temperature_sampler: TemperatureSampler | None = None
         # Bus-subscriber that transitions plan tactics when execution events fire.
-        self.operation_plan_updater = None
+        self.operation_plan_updater: OperationPlanUpdater | None = None
         # Opt-in bottom-camera stream bridge — created when viz starts, but
         # left unstarted until the operator clicks "Start camera" in the UI.
         self.bottom_camera_monitor: BottomCameraStreamMonitor | None = None
         # Opt-in lightsheet stream bridge — same lifecycle as bottom_camera_monitor.
-        self.lightsheet_monitor = None
+        self.lightsheet_monitor: LightSheetStreamMonitor | None = None
 
         # ===== Create delegate managers =====
 
@@ -477,7 +480,8 @@ def exit_plan_mode(self) -> str:
                         seed_operation_plan_from_plan_item,
                     )
 
-                    seed_operation_plan_from_plan_item(self.context_store, self.session_id)
+                    if self.session_id is not None:
+                        seed_operation_plan_from_plan_item(self.context_store, self.session_id)
                 except Exception:
                     logger.exception("operation-plan seeding failed")
             elif candidates:
diff --git a/gently/app/orchestration/tactic_executor.py b/gently/app/orchestration/tactic_executor.py
index c54a87c8..e62a6abb 100644
--- a/gently/app/orchestration/tactic_executor.py
+++ b/gently/app/orchestration/tactic_executor.py
@@ -57,8 +57,12 @@ async def execute_tactic(agent, tactic: dict) -> dict:
 
     embryo_ids = resolve_scope_embryos(scope, _roster(agent))
     if not embryo_ids and kind not in ("oneshot", "custom", "scripted_protocol"):
-        return {"ok": False, "kind": kind, "embryo_ids": [],
-                "message": "scope resolved to no embryos"}
+        return {
+            "ok": False,
+            "kind": kind,
+            "embryo_ids": [],
+            "message": "scope resolved to no embryos",
+        }
 
     message = ""
     try:
@@ -86,11 +90,15 @@ async def execute_tactic(agent, tactic: dict) -> dict:
             frames = int(_num(structure.get("frames"), 60))
             results = []
             for eid in embryo_ids:
-                results.append(orchestrator.queue_burst(
-                    eid, frames=frames, mode=str(structure.get("mode", "1hz")),
-                    num_slices=int(_num(structure.get("num_slices"), 1)),
-                    tactic_id=tactic_id,
-                ))
+                results.append(
+                    orchestrator.queue_burst(
+                        eid,
+                        frames=frames,
+                        mode=str(structure.get("mode", "1hz")),
+                        num_slices=int(_num(structure.get("num_slices"), 1)),
+                        tactic_id=tactic_id,
+                    )
+                )
             message = "; ".join(results)
 
         elif kind in ("oneshot", "scripted_protocol", "custom"):
@@ -99,8 +107,12 @@ async def execute_tactic(agent, tactic: dict) -> dict:
             message = f"{kind} recorded (no orchestrator mechanism)"
 
         else:
-            return {"ok": False, "kind": kind, "embryo_ids": embryo_ids,
-                    "message": f"unknown tactic kind '{kind}'"}
+            return {
+                "ok": False,
+                "kind": kind,
+                "embryo_ids": embryo_ids,
+                "message": f"unknown tactic kind '{kind}'",
+            }
     except Exception as exc:
         logger.exception("tactic execution failed (kind=%s)", kind)
         return {"ok": False, "kind": kind, "embryo_ids": embryo_ids, "message": str(exc)}
@@ -138,7 +150,10 @@ def append_tactic_to_plan(agent, tactic: dict) -> dict | None:
     t.setdefault("name", t.get("kind", "tactic"))
     (validated,) = _validate_tactics([t])
     plan = cs.get_operation_plan(sid) or {
-        "session_id": sid, "title": "Operate session", "goal": "", "tactics": []
+        "session_id": sid,
+        "title": "Operate session",
+        "goal": "",
+        "tactics": [],
     }
     plan.setdefault("tactics", []).append(validated)
     plan["updated_reason"] = "operate tactic appended"
diff --git a/gently/hardware/dispim/client.py b/gently/hardware/dispim/client.py
index a7f73878..98807c29 100644
--- a/gently/hardware/dispim/client.py
+++ b/gently/hardware/dispim/client.py
@@ -1021,6 +1021,7 @@ async def stream_lightsheet(self, timeout: float | None = None):
             sock_connect=10.0,
         )
         url = f"{self.http_url}/api/lightsheet/stream"
+        assert self._session is not None
         async with self._session.get(url, timeout=client_timeout) as resp:
             resp.raise_for_status()
             buf = b""
@@ -1050,7 +1051,7 @@ async def set_lightsheet_live_params(
         self, galvo=None, piezo=None, exposure=None, side=None
     ) -> dict:
         """POST live galvo/piezo/exposure/side to the device-layer lightsheet streamer."""
-        body = {}
+        body: dict[str, float | str] = {}
         if galvo is not None:
             body["galvo"] = float(galvo)
         if piezo is not None:
diff --git a/gently/hardware/dispim/device_layer.py b/gently/hardware/dispim/device_layer.py
index 51a83df1..3d5b23bc 100644
--- a/gently/hardware/dispim/device_layer.py
+++ b/gently/hardware/dispim/device_layer.py
@@ -76,7 +76,7 @@ def __init__(
     ):
         super().__init__(name="device-layer", service_type="hardware", host=host, port=port)
         self.config_path = config_path
-        self.config = None
+        self.config: dict | None = None
         # DiSPIMSystem facade — only place this process touches MMCore directly
         self.system: Any = None
         self.RE = None
@@ -2169,16 +2169,19 @@ async def handle_get_temperature_config(self, request):
             cfg = dict((self.config or {}).get("temperature") or {})
             has_pw = bool(cfg.get("password"))
             temp = self.devices.get("temperature")
-            return web.json_response({
-                "success": True,
-                "config": self._redact_temp_cfg(cfg),
-                "password_set": has_pw,
-                "active": temp is not None,
-                "live_backend": type(temp._dev).__name__ if temp is not None else None,
-                "state": self._temp_state(temp),
-            })
+            return web.json_response(
+                {
+                    "success": True,
+                    "config": self._redact_temp_cfg(cfg),
+                    "password_set": has_pw,
+                    "active": temp is not None,
+                    "live_backend": type(temp._dev).__name__ if temp is not None else None,
+                    "state": self._temp_state(temp),
+                }
+            )
         except Exception as e:
             import traceback
+
             return web.json_response(
                 {"success": False, "error": str(e), "traceback": traceback.format_exc()},
                 status=500,
@@ -2199,6 +2202,7 @@ async def handle_test_temperature_config(self, request):
 
         def _probe():
             from gently.hardware.temperature import create_temperature_controller
+
             tc = create_temperature_controller(eff)
             try:
                 r = tc.read()
@@ -2227,7 +2231,7 @@ def _write_temp_sidecar(self, temp_cfg: dict) -> None:
             import os
 
             sidecar = Path(self.config_path).parent / "config.local.yml"
-            existing = {}
+            existing: dict = {}
             if sidecar.exists():
                 with open(sidecar) as f:
                     existing = yaml.safe_load(f) or {}
@@ -2266,16 +2270,24 @@ async def handle_set_temperature_config(self, request):
         re_state = str(getattr(self.RE, "state", "idle")) if self.RE is not None else "idle"
         if re_state != "idle":
             return web.json_response(
-                {"success": False, "blocked": True,
-                 "error": f"RunEngine is {re_state}; stop the plan before reconfiguring"},
-                status=409)
+                {
+                    "success": False,
+                    "blocked": True,
+                    "error": f"RunEngine is {re_state}; stop the plan before reconfiguring",
+                },
+                status=409,
+            )
         old = self.devices.get("temperature")
         lock = getattr(old, "_lock", None)
         if lock is not None and lock.locked():
             return web.json_response(
-                {"success": False, "blocked": True,
-                 "error": "a temperature ramp is in progress; wait or stop it first"},
-                status=409)
+                {
+                    "success": False,
+                    "blocked": True,
+                    "error": "a temperature ramp is in progress; wait or stop it first",
+                },
+                status=409,
+            )
 
         # Fill in the stored password when the client didn't submit a new one.
         eff = self._preserve_temp_password(cfg)
@@ -2283,6 +2295,7 @@ async def handle_set_temperature_config(self, request):
         # Build the NEW controller first (eager connect off the event loop).
         def _build():
             from gently.hardware.temperature import create_temperature_controller
+
             return create_temperature_controller(eff)
 
         try:
@@ -2290,10 +2303,15 @@ def _build():
         except Exception as e:
             self._write_temp_sidecar(eff)  # save intent; a restart will apply it
             return web.json_response(
-                {"success": False, "applied": False, "restart_required": True,
-                 "error": f"could not connect with the new config: {e}. "
-                          "Saved — restart the device layer to apply."},
-                status=502)
+                {
+                    "success": False,
+                    "applied": False,
+                    "restart_required": True,
+                    "error": f"could not connect with the new config: {e}. "
+                    "Saved — restart the device layer to apply.",
+                },
+                status=502,
+            )
 
         # Swap + retire the old controller.
         self.devices["temperature"] = new_tc
@@ -2306,12 +2324,16 @@ def _build():
         self.config["temperature"] = eff
         self._write_temp_sidecar(eff)
         logger.info("Thermalizer reconfigured live (backend=%s)", eff.get("backend", "serial"))
-        return web.json_response({
-            "success": True, "applied": True, "restart_required": False,
-            "config": self._redact_temp_cfg(eff),
-            "live_backend": type(new_tc._dev).__name__,
-            "state": self._temp_state(new_tc),
-        })
+        return web.json_response(
+            {
+                "success": True,
+                "applied": True,
+                "restart_required": False,
+                "config": self._redact_temp_cfg(eff),
+                "live_backend": type(new_tc._dev).__name__,
+                "state": self._temp_state(new_tc),
+            }
+        )
 
     async def handle_set_camera_led_mode(self, request):
         """POST /api/camera/led_mode - Enable/disable automatic LED for bottom camera"""
@@ -3654,7 +3676,8 @@ async def on_start(self):
         self._app.router.add_post("/api/temperature/set", self.handle_set_temperature)
         self._app.router.add_get("/api/temperature/config", self.handle_get_temperature_config)
         self._app.router.add_post(
-            "/api/temperature/config/test", self.handle_test_temperature_config)
+            "/api/temperature/config/test", self.handle_test_temperature_config
+        )
         self._app.router.add_post("/api/temperature/config", self.handle_set_temperature_config)
         self._app.router.add_get("/api/room_light/status", self.handle_get_room_light_status)
         self._app.router.add_post("/api/room_light/set", self.handle_set_room_light)
diff --git a/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py b/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py
index e5ed7118..9a70b3b5 100644
--- a/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py
+++ b/gently/hardware/vendor/acuitynano_precision_thermalizer_serial.py
@@ -3,6 +3,7 @@
 Vendor-supplied SDK, not on PyPI; bundled with gently so the device layer always
 has it. Requires ``pyserial`` (the ``device`` extra). See gently.hardware.vendor.
 """
+
 import threading
 import time
 
diff --git a/gently/ui/web/routes/data.py b/gently/ui/web/routes/data.py
index b4292341..01d334ac 100644
--- a/gently/ui/web/routes/data.py
+++ b/gently/ui/web/routes/data.py
@@ -475,7 +475,8 @@ async def set_temperature_config(payload: dict = Body(...)):  # noqa: B008
         except Exception as exc:
             logger.exception("Thermalizer reconfigure failed")
             raise HTTPException(
-                status_code=502, detail=f"thermalizer reconfigure failed: {exc}") from exc
+                status_code=502, detail=f"thermalizer reconfigure failed: {exc}"
+            ) from exc
         return res
 
     @router.get("/api/config/effective")
@@ -492,15 +493,20 @@ async def get_effective_config():
 
         return {
             "note": "settings.py values are read from env at startup; "
-                    "changing them needs a restart.",
+            "changing them needs a restart.",
             "network": {
-                "viz_host": S.network.viz_host, "viz_port": S.network.viz_port,
-                "device_host": S.network.device_host, "device_port": S.network.device_port,
+                "viz_host": S.network.viz_host,
+                "viz_port": S.network.viz_port,
+                "device_host": S.network.device_host,
+                "device_port": S.network.device_port,
                 "mesh_port": S.network.mesh_port,
             },
             "models": {
-                "main": S.models.main, "perception": S.models.perception, "fast": S.models.fast,
-                "medium": S.models.medium, "refusal_fallback": S.models.refusal_fallback,
+                "main": S.models.main,
+                "perception": S.models.perception,
+                "fast": S.models.fast,
+                "medium": S.models.medium,
+                "refusal_fallback": S.models.refusal_fallback,
             },
             "storage": {"base_path": str(S.storage.base_path)},
             "timeouts": {
@@ -511,10 +517,12 @@ async def get_effective_config():
             "ml": {
                 "default_batch_size": S.ml.default_batch_size,
                 "default_epochs": S.ml.default_epochs,
-                "default_lr": S.ml.default_lr, "model_cache_dir": str(S.ml.model_cache_dir),
+                "default_lr": S.ml.default_lr,
+                "model_cache_dir": str(S.ml.model_cache_dir),
             },
             "transfer": {
-                "transfer_port": S.transfer.transfer_port, "chunk_size": S.transfer.chunk_size,
+                "transfer_port": S.transfer.transfer_port,
+                "chunk_size": S.transfer.chunk_size,
                 "max_concurrent_transfers": S.transfer.max_concurrent_transfers,
             },
             "mesh": {
@@ -563,22 +571,62 @@ async def put_dashboard_defaults(payload: dict = Body(...)):  # noqa: B008
     # timeouts.plan_execution and ml.* defaults (currently 0 readers — editing
     # would be a silent no-op).
     _override_keys = [
-        {"env": "GENTLY_TIMEOUT_VOLUME", "label": "Volume acquisition (s)", "type": "int",
-         "group": "Timeouts", "get": lambda S: S.timeouts.volume_acquisition},
-        {"env": "GENTLY_TIMEOUT_API", "label": "External API call (s)", "type": "int",
-         "group": "Timeouts", "get": lambda S: S.timeouts.api_call},
-        {"env": "GENTLY_MESH_BROADCAST_INTERVAL", "label": "Broadcast interval (s)",
-         "type": "float", "group": "Mesh network", "get": lambda S: S.mesh.broadcast_interval_s},
-        {"env": "GENTLY_MESH_STALE_THRESHOLD", "label": "Stale threshold (s)", "type": "float",
-         "group": "Mesh network", "get": lambda S: S.mesh.stale_threshold_s},
-        {"env": "GENTLY_MESH_DEAD_THRESHOLD", "label": "Dead threshold (s)", "type": "float",
-         "group": "Mesh network", "get": lambda S: S.mesh.dead_threshold_s},
-        {"env": "GENTLY_UX_V2", "label": "UX v2 dashboard", "type": "bool",
-         "group": "Interface", "get": lambda S: S.ui.ux_v2},
-        {"env": "GENTLY_NCBI_TOOL", "label": "Tool name", "type": "str",
-         "group": "NCBI (Entrez)", "get": lambda S: S.api.ncbi_tool},
-        {"env": "GENTLY_NCBI_EMAIL", "label": "Contact email", "type": "str",
-         "group": "NCBI (Entrez)", "get": lambda S: S.api.ncbi_email},
+        {
+            "env": "GENTLY_TIMEOUT_VOLUME",
+            "label": "Volume acquisition (s)",
+            "type": "int",
+            "group": "Timeouts",
+            "get": lambda S: S.timeouts.volume_acquisition,
+        },
+        {
+            "env": "GENTLY_TIMEOUT_API",
+            "label": "External API call (s)",
+            "type": "int",
+            "group": "Timeouts",
+            "get": lambda S: S.timeouts.api_call,
+        },
+        {
+            "env": "GENTLY_MESH_BROADCAST_INTERVAL",
+            "label": "Broadcast interval (s)",
+            "type": "float",
+            "group": "Mesh network",
+            "get": lambda S: S.mesh.broadcast_interval_s,
+        },
+        {
+            "env": "GENTLY_MESH_STALE_THRESHOLD",
+            "label": "Stale threshold (s)",
+            "type": "float",
+            "group": "Mesh network",
+            "get": lambda S: S.mesh.stale_threshold_s,
+        },
+        {
+            "env": "GENTLY_MESH_DEAD_THRESHOLD",
+            "label": "Dead threshold (s)",
+            "type": "float",
+            "group": "Mesh network",
+            "get": lambda S: S.mesh.dead_threshold_s,
+        },
+        {
+            "env": "GENTLY_UX_V2",
+            "label": "UX v2 dashboard",
+            "type": "bool",
+            "group": "Interface",
+            "get": lambda S: S.ui.ux_v2,
+        },
+        {
+            "env": "GENTLY_NCBI_TOOL",
+            "label": "Tool name",
+            "type": "str",
+            "group": "NCBI (Entrez)",
+            "get": lambda S: S.api.ncbi_tool,
+        },
+        {
+            "env": "GENTLY_NCBI_EMAIL",
+            "label": "Contact email",
+            "type": "str",
+            "group": "NCBI (Entrez)",
+            "get": lambda S: S.api.ncbi_email,
+        },
     ]
     _settings_local_path = _HARDWARE_CONFIG_PATH.parent / "settings.local.yml"
 
@@ -607,8 +655,14 @@ async def get_settings_overrides():
 
         file_over = _read_settings_local()
         items = [
-            {"env": k["env"], "label": k["label"], "type": k["type"], "group": k["group"],
-             "current": k["get"](S), "overridden": k["env"] in file_over}
+            {
+                "env": k["env"],
+                "label": k["label"],
+                "type": k["type"],
+                "group": k["group"],
+                "current": k["get"](S),
+                "overridden": k["env"] in file_over,
+            }
             for k in _override_keys
         ]
         return {"note": "changes take effect on the next process restart", "items": items}
@@ -628,13 +682,18 @@ async def put_settings_overrides(payload: dict = Body(...)):  # noqa: B008
                 updates[k] = _coerce_override(allowed[k], v)
             except (TypeError, ValueError):
                 raise HTTPException(
-                    status_code=400, detail=f"{k}: invalid {allowed[k]} value") from None
+                    status_code=400, detail=f"{k}: invalid {allowed[k]} value"
+                ) from None
         existing = _read_settings_local()
         existing.update(updates)
         _settings_local_path.write_text(
-            yaml.safe_dump(existing, default_flow_style=False, sort_keys=True))
-        return {"saved": list(updates.keys()), "restart_required": True,
-                "note": "restart the server for these to take effect"}
+            yaml.safe_dump(existing, default_flow_style=False, sort_keys=True)
+        )
+        return {
+            "saved": list(updates.keys()),
+            "restart_required": True,
+            "note": "restart the server for these to take effect",
+        }
 
     # ------------------------------------------------------------------
     # Lightsheet live stream
@@ -1105,9 +1164,12 @@ async def set_embryo_roles(payload: dict = Body(...)):  # noqa: B008
                 try:
                     pos = getattr(emb, "position_coarse", {}) or {}
                     store.register_embryo(
-                        sid, eid,
-                        position_x=pos.get("x"), position_y=pos.get("y"),
-                        calibration=getattr(emb, "calibration", {}) or {}, role=str(role),
+                        sid,
+                        eid,
+                        position_x=pos.get("x"),
+                        position_y=pos.get("y"),
+                        calibration=getattr(emb, "calibration", {}) or {},
+                        role=str(role),
                     )
                 except Exception:
                     logger.debug("role persist failed for %s", eid, exc_info=True)
@@ -1117,8 +1179,12 @@ async def set_embryo_roles(payload: dict = Body(...)):  # noqa: B008
 
                     bus.publish(
                         event_type=EventType.STATUS_CHANGED,
-                        data={"embryo_id": eid, "change": "role_assigned",
-                              "old_role": old, "new_role": str(role)},
+                        data={
+                            "embryo_id": eid,
+                            "change": "role_assigned",
+                            "old_role": old,
+                            "new_role": str(role),
+                        },
                         source="operate_roles",
                     )
                 except Exception:
@@ -1443,33 +1509,49 @@ async def timelapse_start(payload: dict = Body(...)):  # noqa: B008
                 eids = list(embryo_ids or [])
                 seed_scope = {"mode": "embryos", "embryo_ids": eids} if eids else {"mode": "global"}
                 st_id = f"op_{_uuid.uuid4().hex[:8]}"
-                new_tactics = [
+                new_tactics: list[dict] = [
                     {
-                        "id": st_id, "name": "Adaptive timelapse",
-                        "kind": "standing_timelapse", "state": "active",
+                        "id": st_id,
+                        "name": "Adaptive timelapse",
+                        "kind": "standing_timelapse",
+                        "state": "active",
                         "scope": dict(seed_scope),
                         "structure": {
-                            "cadence_s": interval_seconds, "interval": interval_seconds,
-                            "stop_condition": stop_condition, "condition_value": condition_value,
+                            "cadence_s": interval_seconds,
+                            "interval": interval_seconds,
+                            "stop_condition": stop_condition,
+                            "condition_value": condition_value,
                             "monitoring_mode": monitoring_mode or "idle",
                         },
                         "rationale": "Started from the Operate Run step.",
-                        "live_bind": ["cadence"], "relations": {}, "live": {}, "source": "operate",
+                        "live_bind": ["cadence"],
+                        "relations": {},
+                        "live": {},
+                        "source": "operate",
                     }
                 ]
                 if monitoring_mode and monitoring_mode != "idle":
-                    new_tactics.append({
-                        "id": f"op_{_uuid.uuid4().hex[:8]}", "name": "Monitor",
-                        "kind": "reactive_monitor", "state": "active",
-                        "scope": dict(seed_scope),
-                        "structure": {"monitoring_mode": monitoring_mode, "status": "armed"},
-                        "rationale": f"{monitoring_mode} on the marked subjects.",
-                        "live_bind": ["signal"], "relations": {"layered_on": [st_id]},
-                        "live": {}, "source": "operate",
-                    })
+                    new_tactics.append(
+                        {
+                            "id": f"op_{_uuid.uuid4().hex[:8]}",
+                            "name": "Monitor",
+                            "kind": "reactive_monitor",
+                            "state": "active",
+                            "scope": dict(seed_scope),
+                            "structure": {"monitoring_mode": monitoring_mode, "status": "armed"},
+                            "rationale": f"{monitoring_mode} on the marked subjects.",
+                            "live_bind": ["signal"],
+                            "relations": {"layered_on": [st_id]},
+                            "live": {},
+                            "source": "operate",
+                        }
+                    )
                 new_tactics = _validate_tactics(new_tactics)
                 plan = cs.get_operation_plan(sid) or {
-                    "session_id": sid, "title": "Operate session", "goal": "", "tactics": []
+                    "session_id": sid,
+                    "title": "Operate session",
+                    "goal": "",
+                    "tactics": [],
                 }
                 # Reconcile: retire any prior still-'active' operate-seeded tactics
                 # so repeated Start clicks don't accumulate stale active timelapses.
diff --git a/tests/test_focus_validation.py b/tests/test_focus_validation.py
index 9f53d93a..ed07366c 100644
--- a/tests/test_focus_validation.py
+++ b/tests/test_focus_validation.py
@@ -91,7 +91,7 @@ def test_load_focus_traces_roundtrip(tmp_path):
         {"z": 100.0, "focus_score": 0.4, "t": 1.0, "source": "bottom"},
         {"z": 110.0, "score": 0.9, "source": "bottom"},  # 'score' alias
         {"garbage": True},  # missing z/score -> skipped
-        "not json",         # junk -> skipped
+        "not json",  # junk -> skipped
     ]
     with p.open("w") as f:
         for ln in lines:
diff --git a/tests/test_tactic_executor.py b/tests/test_tactic_executor.py
index 8f7d71ba..c30ac70d 100644
--- a/tests/test_tactic_executor.py
+++ b/tests/test_tactic_executor.py
@@ -24,12 +24,21 @@ def __init__(self):
         self.monitor_calls = []
         self.burst_calls = []
 
-    async def start(self, embryo_ids=None, stop_condition="manual",
-                    base_interval_seconds=120.0, condition_value=None):
-        self.start_calls.append({
-            "embryo_ids": embryo_ids, "stop_condition": stop_condition,
-            "interval": base_interval_seconds, "condition_value": condition_value,
-        })
+    async def start(
+        self,
+        embryo_ids=None,
+        stop_condition="manual",
+        base_interval_seconds=120.0,
+        condition_value=None,
+    ):
+        self.start_calls.append(
+            {
+                "embryo_ids": embryo_ids,
+                "stop_condition": stop_condition,
+                "interval": base_interval_seconds,
+                "condition_value": condition_value,
+            }
+        )
         return "started"
 
     def enable_monitoring_mode(self, name, embryo_ids=None, **kw):
@@ -53,8 +62,10 @@ def transition_tactic(self, session_id, tactic_id, state=None, **bind):
 def _agent(embryos):
     exp = types.SimpleNamespace(embryos=embryos)
     return types.SimpleNamespace(
-        experiment=exp, timelapse_orchestrator=_Orch(),
-        context_store=_CS(), session_id="sess1",
+        experiment=exp,
+        timelapse_orchestrator=_Orch(),
+        context_store=_CS(),
+        session_id="sess1",
     )
 
 
@@ -64,9 +75,14 @@ def _roster3():
 
 async def test_standing_timelapse_starts_scoped():
     agent = _agent(_roster3())
-    t = {"id": "t1", "name": "TL", "kind": "standing_timelapse", "state": "planned",
-         "scope": {"mode": "embryos", "embryo_ids": ["embryo_1", "embryo_2"]},
-         "structure": {"cadence_s": 90, "stop_condition": "manual", "monitoring_mode": "idle"}}
+    t = {
+        "id": "t1",
+        "name": "TL",
+        "kind": "standing_timelapse",
+        "state": "planned",
+        "scope": {"mode": "embryos", "embryo_ids": ["embryo_1", "embryo_2"]},
+        "structure": {"cadence_s": 90, "stop_condition": "manual", "monitoring_mode": "idle"},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is True
     assert res["embryo_ids"] == ["embryo_1", "embryo_2"]
@@ -81,9 +97,14 @@ async def test_standing_timelapse_starts_scoped():
 
 async def test_standing_timelapse_with_monitoring():
     agent = _agent(_roster3())
-    t = {"id": "t2", "name": "TL", "kind": "standing_timelapse", "state": "planned",
-         "scope": {"mode": "role", "role": "test"},
-         "structure": {"interval": 120, "monitoring_mode": "expression_monitoring"}}
+    t = {
+        "id": "t2",
+        "name": "TL",
+        "kind": "standing_timelapse",
+        "state": "planned",
+        "scope": {"mode": "role", "role": "test"},
+        "structure": {"interval": 120, "monitoring_mode": "expression_monitoring"},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is True
     # role scope → the two 'test' embryos
@@ -93,8 +114,14 @@ async def test_standing_timelapse_with_monitoring():
 
 async def test_reactive_monitor():
     agent = _agent(_roster3())
-    t = {"id": "t3", "name": "M", "kind": "reactive_monitor", "state": "planned",
-         "scope": {"mode": "global"}, "structure": {"monitoring_mode": "pre_terminal_monitoring"}}
+    t = {
+        "id": "t3",
+        "name": "M",
+        "kind": "reactive_monitor",
+        "state": "planned",
+        "scope": {"mode": "global"},
+        "structure": {"monitoring_mode": "pre_terminal_monitoring"},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is True
     assert sorted(res["embryo_ids"]) == ["embryo_1", "embryo_2", "embryo_3"]  # global = all
@@ -103,9 +130,14 @@ async def test_reactive_monitor():
 
 async def test_exclusive_burst_per_embryo():
     agent = _agent(_roster3())
-    t = {"id": "t4", "name": "B", "kind": "exclusive_burst", "state": "planned",
-         "scope": {"mode": "embryos", "embryo_ids": ["embryo_1", "embryo_3"]},
-         "structure": {"frames": 30}}
+    t = {
+        "id": "t4",
+        "name": "B",
+        "kind": "exclusive_burst",
+        "state": "planned",
+        "scope": {"mode": "embryos", "embryo_ids": ["embryo_1", "embryo_3"]},
+        "structure": {"frames": 30},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is True
     bc = agent.timelapse_orchestrator.burst_calls
@@ -115,8 +147,13 @@ async def test_exclusive_burst_per_embryo():
 
 async def test_oneshot_recorded_even_without_scope():
     agent = _agent(_roster3())
-    t = {"id": "t5", "name": "one", "kind": "oneshot", "state": "planned",
-         "scope": {"mode": "embryos", "embryo_ids": []}}
+    t = {
+        "id": "t5",
+        "name": "one",
+        "kind": "oneshot",
+        "state": "planned",
+        "scope": {"mode": "embryos", "embryo_ids": []},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is True  # oneshot tolerated with empty scope
     assert agent.timelapse_orchestrator.start_calls == []
@@ -124,8 +161,14 @@ async def test_oneshot_recorded_even_without_scope():
 
 async def test_empty_scope_fails_for_timelapse():
     agent = _agent(_roster3())
-    t = {"id": "t6", "name": "TL", "kind": "standing_timelapse", "state": "planned",
-         "scope": {"mode": "embryos", "embryo_ids": []}, "structure": {}}
+    t = {
+        "id": "t6",
+        "name": "TL",
+        "kind": "standing_timelapse",
+        "state": "planned",
+        "scope": {"mode": "embryos", "embryo_ids": []},
+        "structure": {},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is False
     assert "no embryos" in res["message"]
@@ -134,16 +177,27 @@ async def test_empty_scope_fails_for_timelapse():
 
 async def test_unknown_kind():
     agent = _agent(_roster3())
-    t = {"id": "t7", "name": "x", "kind": "warp_drive", "state": "planned",
-         "scope": {"mode": "global"}}
+    t = {
+        "id": "t7",
+        "name": "x",
+        "kind": "warp_drive",
+        "state": "planned",
+        "scope": {"mode": "global"},
+    }
     res = await execute_tactic(agent, t)
     assert res["ok"] is False
     assert "unknown tactic kind" in res["message"]
 
 
 async def test_no_orchestrator():
-    agent = types.SimpleNamespace(experiment=types.SimpleNamespace(embryos=_roster3()),
-                                  timelapse_orchestrator=None, context_store=_CS(), session_id="s")
-    res = await execute_tactic(agent, {"id": "t", "kind": "standing_timelapse",
-                                       "scope": {"mode": "global"}, "structure": {}})
+    agent = types.SimpleNamespace(
+        experiment=types.SimpleNamespace(embryos=_roster3()),
+        timelapse_orchestrator=None,
+        context_store=_CS(),
+        session_id="s",
+    )
+    res = await execute_tactic(
+        agent,
+        {"id": "t", "kind": "standing_timelapse", "scope": {"mode": "global"}, "structure": {}},
+    )
     assert res["ok"] is False and res["message"] == "no orchestrator"

From 31730bd3d43ccc352d08b3a51ea22e1eb9ae5d0c Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 05:05:55 -0400
Subject: [PATCH 297/314] =?UTF-8?q?Agent=20chat=20UI=20improvements=20(#60?=
 =?UTF-8?q?)=20=E2=80=94=20rebased=20onto=20current=20development?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Squashed, updated rebase of PR #60 (agent-ui-improvements, by @schneidermc /
Magdalena) onto current development, which had rewritten agent-chat.js
(990->1387 lines) since the PR was opened.

- agent-chat.js: 3-way reconciliation — kept new development's askPending /
  ASK-clear feature + clearPendingAsks(); applied #60's redesign (docked panel,
  collapsed spark rail replacing the header toggle, send<->stop composer morph,
  "You" user labels via author_id/you_id); made the composer ask-aware (offers
  Send, not Stop, during a pending ask). Stripped 4 stray null bytes that made
  git treat the file as binary.
- server.py: #60's SO_REUSEADDR fix is already in development — dropped as redundant.
- bridge.py, agent_ws.py, agent-chat.css, _header.html, index.html,
  projection-viewer.js: merged clean.

Verified live: docked panel renders, rail toggle opens it, header toggle gone,
composer send button present, connects, zero JS console errors.

Co-authored-by: schneidermc <schneidermc@users.noreply.github.com>
---
 gently/harness/bridge.py                     |   7 +
 gently/ui/web/routes/agent_ws.py             |  37 +++++-
 gently/ui/web/static/css/agent-chat.css      | 132 ++++++++++---------
 gently/ui/web/static/js/agent-chat.js        | Bin 66583 -> 67994 bytes
 gently/ui/web/static/js/projection-viewer.js |   2 +-
 gently/ui/web/templates/_header.html         |  13 +-
 gently/ui/web/templates/index.html           |  38 ++++--
 7 files changed, 144 insertions(+), 85 deletions(-)

diff --git a/gently/harness/bridge.py b/gently/harness/bridge.py
index fdd21040..67a87f2a 100644
--- a/gently/harness/bridge.py
+++ b/gently/harness/bridge.py
@@ -671,6 +671,13 @@ async def stream_response(
         pending_choice_result = None
 
         try:
+            # Open the stream envelope immediately — before the (potentially
+            # slow) context build + Claude API call with extended thinking — so
+            # every client shows the "Working…" trust signal the instant the
+            # turn starts, not only once the first token arrives. Pairs with the
+            # stream_end emitted on StopAsyncIteration below.
+            await send_fn({"type": "stream_start"})
+
             while True:
                 try:
                     if pending_choice_result is not None:
diff --git a/gently/ui/web/routes/agent_ws.py b/gently/ui/web/routes/agent_ws.py
index 4c3a8ea7..072c9a46 100644
--- a/gently/ui/web/routes/agent_ws.py
+++ b/gently/ui/web/routes/agent_ws.py
@@ -163,6 +163,7 @@ def _record_display(msg):
                     "role": "user",
                     "text": msg.get("text", ""),
                     "author": msg.get("author"),
+                    "author_id": msg.get("author_id"),
                 }
             )
         elif t == "autonomous_start":
@@ -340,16 +341,20 @@ async def agent_websocket(websocket: WebSocket):
             can_control = role in CONTROL_ROLES
 
         # Assign a stable id for control arbitration. The label shown to other
-        # clients is the username when authenticated, else a generic window id.
+        # clients is the username when authenticated, else "Anonymous". The UI
+        # renders "You" for the viewer's own messages by matching client_id, so
+        # anonymous participants don't need disambiguating numbers.
         _client_counter["n"] += 1
         client_id = f"agent_client_{_client_counter['n']}"
-        client_label = username or f"window {_client_counter['n']}"
+        client_label = username or "Anonymous"
 
-        # Send connection metadata (version, tokens, embryo count, commands)
+        # Send connection metadata (version, tokens, embryo count, commands).
+        # you_id lets the client label its own messages "You".
         meta = bridge.get_connect_metadata()
         _connected_msg = {
             "type": "connected",
             **meta,
+            "you_id": client_id,
             "timestamp": datetime.now().isoformat(),
         }
         await websocket.send_json(_connected_msg)
@@ -851,8 +856,17 @@ async def _run_resolution_bootstrap():
                         active_task.cancel()
 
                     # Echo the user's message to ALL clients (so observers see
-                    # what was asked), then stream the reply to everyone.
-                    await _broadcast({"type": "user_message", "text": text, "author": client_label})
+                    # what was asked), then stream the reply to everyone. author
+                    # is the display name (username or "Anonymous"); author_id
+                    # lets each client render its own messages as "You".
+                    await _broadcast(
+                        {
+                            "type": "user_message",
+                            "text": text,
+                            "author": client_label,
+                            "author_id": client_id,
+                        }
+                    )
                     active_task = asyncio.create_task(
                         bridge.stream_response(text, _broadcast, choice_future_factory)
                     )
@@ -876,6 +890,10 @@ async def _run_resolution_bootstrap():
                     if active_task and not active_task.done():
                         active_task.cancel()
                         active_task = None
+                        # A cancelled stream emits no stream_end of its own, so
+                        # tell every client the turn is over — otherwise their
+                        # "Working…" indicator spins forever after Stop.
+                        await _broadcast({"type": "stream_end"})
 
                 elif msg_type == "command":
                     command = data.get("command", "").strip()
@@ -986,6 +1004,15 @@ async def _run_resolution_bootstrap():
                 wizard_task.cancel()
             if active_task and not active_task.done():
                 active_task.cancel()
+                # This connection was mid-stream — persist whatever the agent
+                # generated so far, otherwise a reload loses the in-progress
+                # reply (it's only committed on stream_end). Guarded to the
+                # owning connection so an observer's disconnect can't split a
+                # still-streaming reply into two history entries.
+                try:
+                    _flush_agent_buf()
+                except Exception:
+                    logger.debug("Could not flush agent buffer on disconnect", exc_info=True)
             if bootstrap_task is not None and not bootstrap_task.done():
                 bootstrap_task.cancel()
             # Release control arbitration for this client; hand the wheel
diff --git a/gently/ui/web/static/css/agent-chat.css b/gently/ui/web/static/css/agent-chat.css
index 106d79bd..3fd7fc82 100644
--- a/gently/ui/web/static/css/agent-chat.css
+++ b/gently/ui/web/static/css/agent-chat.css
@@ -1,40 +1,55 @@
 /* Floating agent-chat window — the web-side control surface.
    Restrained, professional styling for a lab instrument. */
 
-/* ── Header toggle (replaces the floating FAB) ─────────────── */
-.header-agent-toggle {
-    display: inline-flex; align-items: center; gap: 7px;
-    padding: 5px 10px; border-radius: 8px;
-    border: 1px solid var(--border);
-    background: var(--bg-hover); color: var(--text);
-    font: 500 12.5px/1 'Inter Tight', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-    cursor: pointer; position: relative;
-    transition: border-color 0.15s ease, background 0.15s ease, color 0.15s ease;
-}
-.header-agent-toggle:hover { border-color: var(--accent); }
-.header-agent-toggle[aria-pressed="true"] {
-    border-color: var(--accent); color: var(--accent);
-    background: rgba(96, 165, 250, 0.12);
-}
-.header-agent-toggle svg { display: block; }
-.header-agent-label { letter-spacing: 0.01em; }
-.header-agent-dot {
-    width: 7px; height: 7px; border-radius: 50%;
-    background: var(--text-muted); flex: 0 0 auto;
+/* ── Collapsed rail (always-present agent affordance) ──────────
+   When the docked panel is collapsed it shrinks to this thin vertical rail:
+   a spark glyph (click to open), a vertical "Agent" label, plus the connection
+   dot + unseen-activity badge so a tucked-away agent can still signal it woke
+   or has something pending. Shown only via the body.chat-docked rules below. */
+.agent-rail {
+    display: none;  /* shown only when collapsed (see :not(.open) rule) */
+    flex-direction: column; align-items: center;
+    width: 100%; height: 100%; padding: 8px 0 0;
+    border: none; background: transparent;
+    cursor: pointer;
 }
-.header-agent-dot.ok { background: var(--accent-green); }
-.header-agent-badge {
-    position: absolute; top: -6px; right: -6px;
+/* Icon-only activity-bar button: contained rounded hover target (VS Code/Google
+   style), with the connection state + activity count attached to the icon. */
+.agent-rail-icon {
+    position: relative;
+    display: flex; align-items: center; justify-content: center;
+    width: 40px; height: 40px; border-radius: 10px;
+    color: var(--text-muted);
+    transition: background 0.15s ease, color 0.15s ease;
+}
+.agent-rail:hover .agent-rail-icon { background: var(--bg-hover); color: var(--text); }
+.agent-rail-spark { display: flex; }
+/* Presence dot in the icon's corner (avatar-with-status pattern). */
+.agent-rail-dot {
+    position: absolute; right: 5px; bottom: 5px;
+    width: 8px; height: 8px; border-radius: 50%;
+    background: var(--text-muted);
+    border: 2px solid var(--bg-card); box-sizing: content-box;
+}
+.agent-rail-dot.ok { background: var(--accent-green); }
+/* Unseen-activity count badge in the icon's top-right corner. */
+.agent-rail-badge {
+    position: absolute; top: -4px; right: -4px;
     min-width: 16px; height: 16px; padding: 0 4px;
     border-radius: 999px; background: var(--accent-purple); color: #fff;
     font-size: 10px; font-weight: 700; line-height: 16px; text-align: center;
+    border: 2px solid var(--bg-card); box-sizing: content-box;
 }
-.header-agent-badge.hidden { display: none; }
+.agent-rail-badge.hidden { display: none; }
 
 /* ── Docked agent panel ────────────────────────────────────
-   Default = overlay slide-over, absolutely positioned inside .app-shell (which
-   sits below the global header/navbar). Pin (body.chat-docked) turns it into a
-   real column that pushes .app-main. */
+   The panel is always docked (body.chat-docked, set on load): a real column
+   that pushes .app-main, never a float over content. Collapsing it (header
+   Agent toggle / Ctrl+J / ×) drops it to width 0 to reclaim space.
+
+   The base .agent-chat rules below (absolute, translateX slide) are the
+   pre-JS / no-chat-docked fallback so the panel stays parked off-screen until
+   restorePrefs() docks it; body.chat-docked overrides them into the column. */
 .agent-chat {
     position: absolute;
     top: 0; right: 0; bottom: 0;
@@ -54,7 +69,7 @@
 }
 .agent-chat.open { transform: translateX(0); }
 
-/* Pinned: a real pushing column — no float shadow, just a seam. */
+/* Docked: a real pushing column — no float shadow, just a seam. */
 body.chat-docked .agent-chat {
     position: relative;
     transform: none;
@@ -64,9 +79,12 @@ body.chat-docked .agent-chat {
     transition: none;
     z-index: auto;
 }
+/* Collapsed: shrink to the rail. Hide every child, then re-show only the rail. */
 body.chat-docked .agent-chat:not(.open) {
-    width: 0; border-left: none; overflow: hidden;
+    width: 48px; flex: 0 0 48px; overflow: hidden;
 }
+body.chat-docked .agent-chat:not(.open) > * { display: none; }
+body.chat-docked .agent-chat:not(.open) > .agent-rail { display: flex; }
 
 @media (prefers-reduced-motion: reduce) {
     .agent-chat { transition: opacity 0.12s ease; }
@@ -85,15 +103,6 @@ body.chat-docked .agent-chat:not(.open) {
 
 .agent-control-banner.hidden { display: none; }
 
-/* Pin button in the panel header. */
-.agent-chat-pin {
-    background: none; border: none; color: var(--text-muted);
-    cursor: pointer; padding: 2px; display: flex; align-items: center;
-    border-radius: 5px;
-}
-.agent-chat-pin:hover { color: var(--text); background: var(--bg-hover); }
-.agent-chat-pin[aria-pressed="true"] { color: var(--accent); }
-
 /* ── Header ─────────────────────────────────────────────── */
 .agent-chat-header {
     display: flex;
@@ -132,10 +141,12 @@ body.chat-docked .agent-chat:not(.open) {
 .agent-chat-conn.ac-conn-bad { color: var(--accent-orange, #fb923c); border-color: rgba(251, 146, 60, 0.35); }
 .agent-chat-close {
     background: none; border: none;
-    color: var(--text-muted); font-size: 20px; line-height: 1;
-    cursor: pointer; padding: 0 2px;
+    color: var(--text-muted); line-height: 1;
+    cursor: pointer; padding: 2px; border-radius: 5px;
+    display: inline-flex; align-items: center;
 }
-.agent-chat-close:hover { color: var(--text); }
+.agent-chat-close svg { display: block; }
+.agent-chat-close:hover { color: var(--text); background: var(--bg-hover); }
 
 /* ── Control banner ─────────────────────────────────────── */
 .agent-control-banner {
@@ -172,6 +183,8 @@ body.chat-docked .agent-chat:not(.open) {
     color: var(--accent-purple);
     margin-bottom: 4px;
 }
+/* Sender name on user bubbles: muted so it doesn't compete with the message. */
+.ac-role-user { color: var(--text-muted); }
 .ac-turn-agent .ac-content { color: var(--text); }
 .ac-turn-agent .ac-content code {
     font-family: 'JetBrains Mono', ui-monospace, monospace;
@@ -180,7 +193,9 @@ body.chat-docked .agent-chat:not(.open) {
     padding: 1px 5px; border-radius: 4px;
 }
 
-/* User: right-aligned, subtle accent block (not a loud bubble) */
+/* User: right-aligned, subtle accent block (not a loud bubble). Your own
+   messages use the blue accent; other participants get a neutral bubble so a
+   shared chat is easy to read at a glance. */
 .ac-turn-user { align-items: flex-end; }
 .ac-turn-user .ac-content {
     background: rgba(96, 165, 250, 0.12);
@@ -191,6 +206,10 @@ body.chat-docked .agent-chat:not(.open) {
     max-width: 88%;
     white-space: pre-wrap; word-wrap: break-word;
 }
+.ac-turn-user.ac-from-other .ac-content {
+    background: rgba(127, 127, 127, 0.12);
+    border-color: rgba(127, 127, 127, 0.24);
+}
 
 /* ── Autonomous (wake) turns ────────────────────────────── */
 .ac-autonomous-banner {
@@ -402,28 +421,23 @@ body.chat-docked .agent-chat:not(.open) {
 .agent-chat-input textarea::placeholder { color: var(--text-muted); }
 .agent-chat-input textarea:focus { outline: none; border-color: var(--accent); }
 .agent-chat-input textarea:disabled { opacity: 0.55; }
+/* Circular icon button (ChatGPT/Claude style): an up-arrow to send, which
+   morphs into a stop square (.is-stop) while a cancellable turn is running. */
 .agent-chat-send {
     flex: 0 0 auto; align-self: flex-end;
-    padding: 9px 16px; border-radius: 9px;
+    width: 36px; height: 36px; padding: 0; border-radius: 50%;
+    display: inline-flex; align-items: center; justify-content: center;
     border: none; background: var(--accent); color: #fff;
-    font-weight: 600; font-size: 13px; cursor: pointer;
-    transition: background 0.12s ease;
+    cursor: pointer; transition: background 0.12s ease, opacity 0.12s ease;
 }
 .agent-chat-send:hover:not(:disabled) { background: var(--accent-hover); }
-.agent-chat-send:disabled { opacity: 0.5; cursor: default; }
-/* Send now queues while busy (it no longer doubles as Stop), so just dim it. */
-.agent-chat-send.ac-busy { opacity: 0.6; }
-
-/* Explicit Stop (separate from Send), shown only during a cancellable turn. */
-.ac-stop {
-    flex: 0 0 auto; align-self: flex-end;
-    padding: 9px 12px; border-radius: 9px;
-    border: 1px solid var(--color-danger, #f87171);
-    background: transparent; color: var(--color-danger, #f87171);
-    font-weight: 600; font-size: 13px; cursor: pointer;
-}
-.ac-stop:hover { background: rgba(248, 113, 113, 0.12); }
-.ac-stop.hidden { display: none; }
+.agent-chat-send:disabled { opacity: 0.4; cursor: default; }
+.agent-chat-send svg { display: block; }
+/* Toggle which glyph shows; same filled circle in both states (the icon is the
+   signal), matching how Claude/ChatGPT morph the composer button. */
+.agent-chat-send .ac-icon-stop { display: none; }
+.agent-chat-send.is-stop .ac-icon-send { display: none; }
+.agent-chat-send.is-stop .ac-icon-stop { display: block; }
 
 /* ── Queued-message panel (type-while-busy) ─────────────── */
 .ac-queue {
diff --git a/gently/ui/web/static/js/agent-chat.js b/gently/ui/web/static/js/agent-chat.js
index 6e77219453fbde51392f6358deebf02032907ac1..bfa50a8e174759c789ebff3ebc033e960d67c401 100644
GIT binary patch
delta 3898
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

delta 2078
zcmah~eQXp(6z58>^zQg*Xs=L&I#-b0mEKX5XrNvwZJ~xJ6bpeEqi*-+dK>m;kDXac
z#ish7e;7jYY)mkc7!m`C260IX0SPh2n3$N5m_kG%Ap)Wps11Y|jK0~uYY!CM<Zfr)
z*Sz_?-+Q|sD&K#n^0W0}??AXPeIvogqJnT?7up3QX~JB~YL(*RvwS(By9<_Sn1b}6
z73p<_uo+P~E$EIeD9Ji@p7c<b(O_0&aJI1f`YejUnn}TA-rmTaSYleorp|Q=Sw>XD
z&QPARDC-kBk|ZlM6e`mc82`E6I}!hGddxRfU&$=frg{4so>So1+L!TH2WRKj!%d?a
zZm(BheplmGr8Qd0QNAs`ms%-7cZ&|23CaZCMRze%J8!#ui|a75hA3UAum;GNqh&gU
ztS%`OxV8K7upbJ>&&A<-mkxG&KYaLo6goN=!1lJyaJ-X5%`8zdc+PenNb8x#N8}>S
z?~CtU?_w1p4UXPu@P;;As`f^E(v=X}mh@V-*KdJWPgO(PsYcj%tPZ+IR>2Re;&AAb
zcZ>3v*YxS(FkBj$0Y7~lft2^{5Y|f8fiRm`HtVAf$=GhMMLE%VP`t};y+^Q+J6-Cc
zv_EHB6bs4+Qe-WeET}B=B(@k+<vF{b5t|`$S=%8xF?4273vohsm*Y7C@zr{W-fKI8
z6Op6Da2-chL26Qy(Ijw1u4yIGr3_2w`~{PXRKOio$(fl9WlA$i44a`Ph|q<TOX9kb
zl&PXr@59LLxYk+^s>ecJ^T_N9AC=!vMr$0Jw|7xhDVf9Df5&4!yMq(qqrrtxvpNDZ
zYpbDUBmu7-KU8vtBZJ}Ua>q4gj!5Z8r7Cmlv0cZYB#}-NMdG4BsJ0dlnF;ewOkk;^
zki0p=`~39mc@X<GHeWD}?3u(yGA954c78E0TyQAo@WEKKZ!o2R;jyRS-nl4z^UEA>
zYz(Rv>V<+e&}kbx)C~U73^pEhIO2)X;qhyU&JwIfP8Z3*22l(a+Eg3K;$X|-Js(U9
zr81`)KPQ@*bcVxYjnB)x1Gkhg1u`OC3@saOD?=4gvzDz3f^~6-5wxe~w_P_Xh3(rb
zkl0lRzy0{^oCh+5uCYbXb}{DD+b#Gx_!Q%onW02yW?mO2jwIc1Y#y*Lk7I^pEwj)p
zEg5!%FtY<>mr45(nkhaObcR!divf$KgrhTV`jN1F%x1J~#5i;(s23U<_mGFXD6O#X
zd>ryu8kPo#<L%UPDDmoCl)y=o1iXHJ`Oy9N2X`k+my(2k(53>#Y81oCWL4p~RKp34
zjfv1Qll2iZj{_R}S@tRJCmHo`Vg$~<!C=&X!KTd-&%8KN?f1i1SDK3XDH=&j8n3{`
zR2=CKv#vhjUB0$5T2&<Ffm=_;gQZf&CQJ@cQ-yC7L++0aP&u&-hQ`Aszo#eCWm`{7
zbX3d@;`kISE@AxWVo2VZ33qS5R8vk-4BU>&MUlX;8$UK{?le_xTlZg|D>?Ye##qL6
zBybOzWK;Z*+%C>5ID7ChIPzwFrQE}rH|m1L(Z7n4mK$~Ts43%2$r<*aN=8Z>neyV$
z9(eKe0tH8|KgQIoZgE*u!=k#=jUybBTg!KF6=j1O-1u{TE!F_#9XPQwr3ngWNv(J9
w-qniXmQYg_cYE`u7(Nr)GTIyp9j}CqryCOgdjhoGZGydD&lt^Cg;q}g2Ld_ZEdT%j

diff --git a/gently/ui/web/static/js/projection-viewer.js b/gently/ui/web/static/js/projection-viewer.js
index 0e20b9fa..5cf7719d 100644
--- a/gently/ui/web/static/js/projection-viewer.js
+++ b/gently/ui/web/static/js/projection-viewer.js
@@ -344,7 +344,7 @@ const ProjectionViewer = {
         // panel can dock/resize and the window can resize. The animation loop
         // re-renders every frame, so on a size change we only need to resize the
         // renderer + camera (coalesced to one rAF). Also listen for the explicit
-        // layout-change event the chat dock fires on pin/unpin.
+        // layout-change event the chat dock fires on collapse/expand + resize.
         if (this._resizeObserver) this._resizeObserver.disconnect();
         this._resizeObserver = new ResizeObserver(() => {
             if (this._resizeRaf) cancelAnimationFrame(this._resizeRaf);
diff --git a/gently/ui/web/templates/_header.html b/gently/ui/web/templates/_header.html
index 3f113590..cf4a4d03 100644
--- a/gently/ui/web/templates/_header.html
+++ b/gently/ui/web/templates/_header.html
@@ -25,17 +25,8 @@
         <div class="presence-container" id="presence-container">
             <!-- Avatars rendered by PresenceManager -->
         </div>
-        <!-- Agent chat toggle (docked side panel) -->
-        <button class="header-agent-toggle" id="agent-chat-toggle"
-                title="Agent  (Ctrl/Cmd+J)" aria-pressed="false"
-                aria-expanded="false" aria-controls="agent-chat">
-            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-                <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"></path>
-            </svg>
-            <span class="header-agent-label">Agent</span>
-            <span class="header-agent-dot" id="agent-chat-toggle-dot" aria-hidden="true"></span>
-            <span class="header-agent-badge hidden" id="agent-chat-toggle-badge" aria-hidden="true"></span>
-        </button>
+        {# Agent lives in the docked right sidebar (collapses to a spark rail) —
+           no header toggle. Ctrl/Cmd+J still opens it. #}
         {% endif %}
         <!-- Settings link -->
         <a href="/settings" class="header-nav-link" title="Dashboard settings">
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 14767be8..af177670 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -108,8 +108,8 @@ <h3>Take a quick look</h3>
     {% endif %}
     {% include '_header.html' %}
     {% include '_navbar.html' %}
-    <!-- App shell: main content + docked agent panel (flex row for pin-to-dock).
-         Header + navbar stay full-width above this. -->
+    <!-- App shell: main content + docked agent panel (flex row; the panel is a
+         real column that pushes .app-main). Header + navbar stay full-width above. -->
     <div class="app-shell">
     {% if ux_v2 %}
     <aside class="v2-rail" id="v2-rail">
@@ -1300,9 +1300,22 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
     <div class="ambient-pulse" id="ambient-pulse"></div>
     </div><!-- /.app-main -->
 
-    <!-- Agent chat — docked side panel (overlay by default; pin to dock) -->
+    <!-- Agent chat — docked side panel (always docked; collapse to reclaim space) -->
     <aside id="agent-chat" class="agent-chat" aria-label="Agent chat">
         <div class="agent-chat-resize" id="agent-chat-resize" title="Drag to resize" aria-hidden="true"></div>
+        <!-- Collapsed rail: the always-present agent affordance (shown only when collapsed) -->
+        <button id="agent-rail-toggle" class="agent-rail" title="Open agent (Ctrl/Cmd+J)" aria-label="Open agent">
+            <span class="agent-rail-icon">
+                <span class="agent-rail-spark" aria-hidden="true">
+                    <svg width="22" height="22" viewBox="0 0 24 24" fill="currentColor">
+                        <path d="M12 1.6l2.1 6.4a3 3 0 0 0 1.9 1.9l6.4 2.1-6.4 2.1a3 3 0 0 0-1.9 1.9L12 22.4l-2.1-6.4a3 3 0 0 0-1.9-1.9L1.6 12l6.4-2.1a3 3 0 0 0 1.9-1.9z"></path>
+                        <path d="M19 2.4l.6 1.9 1.9.6-1.9.6-.6 1.9-.6-1.9L16.5 5l1.9-.6z" opacity="0.7"></path>
+                    </svg>
+                </span>
+                <span class="agent-rail-dot" id="agent-rail-dot" aria-hidden="true"></span>
+                <span class="agent-rail-badge hidden" id="agent-rail-badge" aria-hidden="true"></span>
+            </span>
+        </button>
         <div class="agent-chat-header">
             <div class="agent-chat-id">
                 <img class="agent-chat-mark" src="/static/favicon.svg" alt="" width="22" height="22">
@@ -1310,19 +1323,26 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
                 <span id="agent-chat-user" class="agent-chat-user"></span>
             </div>
             <span id="agent-chat-conn" class="agent-chat-conn ac-conn-bad">Connecting…</span>
-            <button id="agent-chat-pin" class="agent-chat-pin" title="Pin to dock" aria-pressed="false">
-                <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-                    <path d="M9 3v18M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z"></path>
+            <button id="agent-chat-signout" class="agent-chat-signout" title="Sign out" style="display:none">Sign out</button>
+            <button id="agent-chat-close" class="agent-chat-close" title="Collapse (Ctrl/Cmd+J)" aria-label="Collapse agent panel">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
+                    <polyline points="9 6 15 12 9 18"></polyline>
                 </svg>
             </button>
-            <button id="agent-chat-signout" class="agent-chat-signout" title="Sign out" style="display:none">Sign out</button>
-            <button id="agent-chat-close" class="agent-chat-close" title="Close">&times;</button>
         </div>
         <div id="agent-control-banner" class="agent-control-banner hidden"></div>
         <div id="agent-chat-log" class="agent-chat-log"></div>
         <div class="agent-chat-input">
             <textarea id="agent-chat-text" rows="1" placeholder="Message Gently…"></textarea>
-            <button id="agent-chat-send" class="agent-chat-send">Send</button>
+            <button id="agent-chat-send" class="agent-chat-send" aria-label="Send message" title="Send">
+                <svg class="ac-icon-send" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round">
+                    <line x1="12" y1="19" x2="12" y2="5"></line>
+                    <polyline points="6 11 12 5 18 11"></polyline>
+                </svg>
+                <svg class="ac-icon-stop" width="18" height="18" viewBox="0 0 24 24" fill="currentColor">
+                    <rect x="5" y="5" width="14" height="14" rx="3"></rect>
+                </svg>
+            </button>
         </div>
     </aside>
     </div><!-- /.app-shell -->

From 554cb7a55fb8d4ee061c39576d9e46a798ee463a Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 06:54:51 -0400
Subject: [PATCH 298/314] chore(types): fix all 200 mypy-strict errors across
 the repo
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Types-only cleanup — no runtime behavior changes. Brings `mypy .` from 200
errors to 0 (367 source files) so the mypy-strict CI check goes green.

Fixed across 28 files (annotations, return types, isinstance/None narrowing,
typing.cast, correctly-typed literals). 14 targeted `# type: ignore[code]`
remain, each with a reason, for genuine third-party/stdlib limitations:
- anthropic SDK's overloaded messages.create() passed through asyncio.to_thread
  (mypy can't resolve overloads via ParamSpec) — verifier.py, auto_label_examples.py
- cv2.VideoWriter_fourcc / cv2.normalize dst: present at runtime but missing/strict
  in cv2 stubs — video_maker.py, exclusive.py, recreate_session_videos.py, sam_detection.py
- assigning a MagicMock to bluesky.RunEngine in device tests — 4 test files

Verified: `mypy .` clean, `ruff check` + `ruff format` clean, and the test suite
shows the SAME results as the pre-cleanup baseline (zero regressions).
---
 gently/analysis/core.py                       |  22 +--
 gently/analysis/focus.py                      |   2 +-
 gently/analysis/steps.py                      |  23 +--
 gently/app/agent.py                           |  42 +++---
 gently/app/orchestration/exclusive.py         |   2 +-
 gently/app/tools/calibration_tools.py         |   3 +-
 gently/app/tools/focus_tools.py               |   5 +-
 gently/app/video_maker.py                     |   2 +-
 gently/core/imaging.py                        |  19 ++-
 gently/detection.py                           |  16 +-
 gently/hardware/dispim/claude_client.py       | 142 ++++++++++--------
 gently/hardware/dispim/sam_detection.py       |   8 +-
 gently/harness/detection/queue.py             |   7 +-
 gently/harness/detection/verifier.py          |  14 +-
 gently/harness/state.py                       |   6 +-
 .../celegans/developmental_tracker.py         |   8 +-
 gently/ui/web/embryo_marker.py                |   1 +
 gently/ui/web/plots.py                        |   9 +-
 gently/ui/web/server.py                       |   2 +-
 scripts/auto_label_examples.py                |   7 +-
 scripts/projection_explorer.py                |   8 +-
 scripts/recreate_session_videos.py            |   6 +-
 scripts/watch_devices.py                      |   6 +-
 scripts/watch_position.py                     |   6 +-
 tests/test_dual_camera_factory.py             |   2 +-
 tests/test_lightsheet_buffer.py               |   2 +-
 tests/test_lightsheet_side_param.py           |   2 +-
 tests/test_lightsheet_streamer.py             |   2 +-
 28 files changed, 203 insertions(+), 171 deletions(-)

diff --git a/gently/analysis/core.py b/gently/analysis/core.py
index 180bfffb..91d5520a 100644
--- a/gently/analysis/core.py
+++ b/gently/analysis/core.py
@@ -496,13 +496,13 @@ def analyze_focus_stack(
             score = calculate_focus_score(image, config.algorithm, config=config)
             scores.append(score)
 
-        positions = np.array(positions)
-        scores = np.array(scores)
+        positions_arr = np.array(positions)
+        scores_arr = np.array(scores)
 
         # Try curve fitting to find optimal position
         try:
             fitted_positions, fitted_scores, fit_params, r_squared = fit_focus_curve(
-                positions, scores, config.fit_function
+                positions_arr, scores_arr, config.fit_function
             )
 
             if r_squared >= config.minimum_r_squared:
@@ -512,15 +512,15 @@ def analyze_focus_stack(
                 best_score = fitted_scores[best_idx]
             else:
                 # Fallback to highest measured score
-                best_idx = np.argmax(scores)
-                best_position = positions[best_idx]
-                best_score = scores[best_idx]
+                best_idx = np.argmax(scores_arr)
+                best_position = positions_arr[best_idx]
+                best_score = scores_arr[best_idx]
 
         except (FocusFitError, Exception):
             # Fallback to highest measured score
-            best_idx = np.argmax(scores)
-            best_position = positions[best_idx]
-            best_score = scores[best_idx]
+            best_idx = np.argmax(scores_arr)
+            best_position = positions_arr[best_idx]
+            best_score = scores_arr[best_idx]
             r_squared = 0.0
             fit_params = None
 
@@ -530,8 +530,8 @@ def analyze_focus_stack(
             best_score=float(best_score),
             r_squared=float(r_squared),
             fit_params=fit_params,
-            all_positions=positions,
-            all_scores=scores,
+            all_positions=positions_arr,
+            all_scores=scores_arr,
         )
 
     except Exception as e:
diff --git a/gently/analysis/focus.py b/gently/analysis/focus.py
index 1983abf8..28e1647d 100644
--- a/gently/analysis/focus.py
+++ b/gently/analysis/focus.py
@@ -284,4 +284,4 @@ def is_good_focus_curve(scores: list[float], threshold: float = 0.1) -> bool:
         return False
 
     coefficient_of_variation = std_dev / mean_score
-    return coefficient_of_variation >= threshold
+    return bool(coefficient_of_variation >= threshold)
diff --git a/gently/analysis/steps.py b/gently/analysis/steps.py
index 2da335c0..ffd40f45 100644
--- a/gently/analysis/steps.py
+++ b/gently/analysis/steps.py
@@ -10,7 +10,7 @@
 import asyncio
 import logging
 import os
-from typing import Any
+from typing import Any, cast
 
 import numpy as np
 
@@ -119,17 +119,17 @@ async def execute(
             try:
                 from skimage.filters import threshold_otsu
 
-                threshold_value = threshold_otsu(image)
+                threshold_value = float(threshold_otsu(image))
             except ImportError:
                 # Fallback to simple percentile
-                threshold_value = np.percentile(image, 50)
+                threshold_value = float(np.percentile(image, 50))
 
         elif self.method == "percentile":
-            threshold_value = np.percentile(image, self.value or 50)
+            threshold_value = float(np.percentile(image, self.value or 50))
 
         elif self.method == "percentile_bright":
             # Keep values above percentile (bright regions)
-            threshold_value = np.percentile(image, self.value or 95)
+            threshold_value = float(np.percentile(image, self.value or 95))
 
         elif self.method == "manual":
             if self.value is None:
@@ -200,7 +200,7 @@ async def execute(
         try:
             import cv2
 
-            kernel = np.ones((self.kernel_size, self.kernel_size), np.uint8)
+            kernel: np.ndarray = np.ones((self.kernel_size, self.kernel_size), np.uint8)
 
             if self.operation == "erode":
                 result = cv2.erode(input_data, kernel, iterations=self.iterations)
@@ -455,13 +455,14 @@ async def execute(
             # Call Claude
             client = anthropic.Anthropic(api_key=api_key)
             response = await asyncio.to_thread(
-                client.messages.create,
-                model=self.model,
-                max_tokens=self.max_tokens,
-                messages=[{"role": "user", "content": content}],
+                lambda: client.messages.create(
+                    model=self.model,
+                    max_tokens=self.max_tokens,
+                    messages=[{"role": "user", "content": cast(Any, content)}],
+                )
             )
 
-            result_text = response.content[0].text
+            result_text = cast(Any, response.content[0]).text
 
             return AnalysisResult(
                 step_name=self.name,
diff --git a/gently/app/agent.py b/gently/app/agent.py
index 62602481..49781051 100644
--- a/gently/app/agent.py
+++ b/gently/app/agent.py
@@ -17,7 +17,7 @@
 from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, cast
 
 import anthropic
 import numpy as np
@@ -1701,28 +1701,30 @@ async def check_blank_image(
 Respond with ONLY: VALID or BLANK"""
 
             response = await asyncio.to_thread(
-                self.claude.messages.create,
-                model=settings.models.fast,
-                max_tokens=10,
-                messages=[
-                    {
-                        "role": "user",
-                        "content": [
-                            {"type": "text", "text": prompt},
-                            {
-                                "type": "image",
-                                "source": {
-                                    "type": "base64",
-                                    "media_type": "image/png",
-                                    "data": b64_image,
+                lambda: self.claude.messages.create(
+                    model=settings.models.fast,
+                    max_tokens=10,
+                    messages=[
+                        {
+                            "role": "user",
+                            "content": [
+                                {"type": "text", "text": prompt},
+                                {
+                                    "type": "image",
+                                    "source": {
+                                        "type": "base64",
+                                        "media_type": "image/png",
+                                        "data": b64_image,
+                                    },
                                 },
-                            },
-                        ],
-                    }
-                ],
+                            ],
+                        }
+                    ],
+                )
             )
 
-            result = response.content[0].text.strip().upper()
+            block = cast(anthropic.types.TextBlock, response.content[0])
+            result = block.text.strip().upper()
             is_blank = "BLANK" in result
 
             if is_blank:
diff --git a/gently/app/orchestration/exclusive.py b/gently/app/orchestration/exclusive.py
index 7dc3583f..893ff072 100644
--- a/gently/app/orchestration/exclusive.py
+++ b/gently/app/orchestration/exclusive.py
@@ -538,7 +538,7 @@ async def _maybe_generate_mp4(
         chosen_path = mp4_path
         for codec, ext in codecs:
             test_path = mp4_path.with_suffix(ext)
-            fourcc = cv2.VideoWriter_fourcc(*codec)
+            fourcc = cv2.VideoWriter_fourcc(*codec)  # type: ignore[attr-defined]  # cv2 stubs omit VideoWriter_fourcc
             w = cv2.VideoWriter(str(test_path), fourcc, 10, (width, height), isColor=True)
             if w.isOpened():
                 writer = w
diff --git a/gently/app/tools/calibration_tools.py b/gently/app/tools/calibration_tools.py
index 3db84e79..17278416 100644
--- a/gently/app/tools/calibration_tools.py
+++ b/gently/app/tools/calibration_tools.py
@@ -7,6 +7,7 @@
 
 import logging
 from datetime import datetime
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -232,7 +233,7 @@ async def _adaptive_focus_sweep(
     )
 
     # Build result dict
-    result_dict = {
+    result_dict: dict[str, Any] = {
         "galvo": galvo_pos,
         "piezo": best_piezo,
         "max_score": float(max(dense_state.scores)) if dense_state.scores else 0.0,
diff --git a/gently/app/tools/focus_tools.py b/gently/app/tools/focus_tools.py
index 11769eb4..f8ffd895 100644
--- a/gently/app/tools/focus_tools.py
+++ b/gently/app/tools/focus_tools.py
@@ -12,6 +12,7 @@
 """
 
 from datetime import datetime
+from typing import Any
 
 import numpy as np
 
@@ -105,7 +106,7 @@ async def fine_focus(
     try:
         # Capture images at each position
         images = []
-        captured_positions = []
+        captured_positions: Any = []
 
         for _i, pos in enumerate(positions):
             result = await client.capture_lightsheet_image(
@@ -120,7 +121,7 @@ async def fine_focus(
             return f"Error: Only captured {len(images)} images, need at least 3 for focus analysis"
 
         # Calculate focus scores
-        scores = []
+        scores: Any = []
         config = FocusAnalysisConfig(algorithm=algorithm)
 
         for _i, img in enumerate(images):
diff --git a/gently/app/video_maker.py b/gently/app/video_maker.py
index 2ad369da..5fa5435d 100644
--- a/gently/app/video_maker.py
+++ b/gently/app/video_maker.py
@@ -231,7 +231,7 @@ def create_timelapse_video(
                     ]
 
                     for codec, ext in codecs:
-                        fourcc = cv2.VideoWriter_fourcc(*codec)
+                        fourcc = cv2.VideoWriter_fourcc(*codec)  # type: ignore[attr-defined]  # missing from cv2 stubs
                         test_path = output_path.with_suffix(ext)
                         writer = cv2.VideoWriter(
                             str(test_path), fourcc, fps, (width, height), isColor=True
diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index 0179644c..356c7963 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -22,6 +22,8 @@
 import io
 import logging
 from pathlib import Path
+from types import ModuleType
+from typing import Any
 
 import numpy as np
 
@@ -135,7 +137,7 @@ def image_to_base64(
             )
 
     buffer = io.BytesIO()
-    save_kwargs = {"format": format, "optimize": True}
+    save_kwargs: dict[str, Any] = {"format": format, "optimize": True}
     if format.upper() == "JPEG":
         save_kwargs["quality"] = quality
     pil_image.save(buffer, **save_kwargs)
@@ -322,6 +324,7 @@ def generate_jpeg_projection(
 # (visualization/ was importing from agent/).
 
 # Optional tifffile import (only needed for load_volume)
+_tifffile: ModuleType | None
 try:
     import tifffile as _tifffile
 except ImportError:
@@ -380,13 +383,13 @@ def compute_crop_bounds(
     y_coords, x_coords = np.where(mask)
     if len(y_coords) < 10:
         return (0, volume.shape[1], 0, volume.shape[2])
-    cy, cx = np.mean(y_coords), np.mean(x_coords)
-    y_std = max(np.std(y_coords), 20)
-    x_std = max(np.std(x_coords), 20)
-    y_min = int(max(0, cy - sigma_mult * y_std - padding))
-    y_max = int(min(volume.shape[1], cy + sigma_mult * y_std + padding))
-    x_min = int(max(0, cx - sigma_mult * x_std - padding))
-    x_max = int(min(volume.shape[2], cx + sigma_mult * x_std + padding))
+    cy, cx = float(np.mean(y_coords)), float(np.mean(x_coords))
+    y_std = max(float(np.std(y_coords)), 20.0)
+    x_std = max(float(np.std(x_coords)), 20.0)
+    y_min = int(max(0.0, cy - sigma_mult * y_std - padding))
+    y_max = int(min(float(volume.shape[1]), cy + sigma_mult * y_std + padding))
+    x_min = int(max(0.0, cx - sigma_mult * x_std - padding))
+    x_max = int(min(float(volume.shape[2]), cx + sigma_mult * x_std + padding))
     return (y_min, y_max, x_min, x_max)
 
 
diff --git a/gently/detection.py b/gently/detection.py
index 3a19b3e3..f984cfec 100644
--- a/gently/detection.py
+++ b/gently/detection.py
@@ -124,10 +124,10 @@ def detect_embryo_roi(
             return None
 
         padding = kernel_size // 2
-        y_min = max(0, np.min(rows) - padding)
-        y_max = min(image.shape[0], np.max(rows) + padding)
-        x_min = max(0, np.min(cols) - padding)
-        x_max = min(image.shape[1], np.max(cols) + padding)
+        y_min = max(0, int(np.min(rows)) - padding)
+        y_max = min(image.shape[0], int(np.max(rows)) + padding)
+        x_min = max(0, int(np.min(cols)) - padding)
+        x_max = min(image.shape[1], int(np.max(cols)) + padding)
 
         w = x_max - x_min
         h = y_max - y_min
@@ -215,10 +215,10 @@ def detect_multiple_embryos(
             x_center = (np.min(cols) + np.max(cols)) // 2
 
             padding = kernel_size // 2
-            y_min = max(0, np.min(rows) - padding)
-            y_max = min(image.shape[0], np.max(rows) + padding)
-            x_min = max(0, np.min(cols) - padding)
-            x_max = min(image.shape[1], np.max(cols) + padding)
+            y_min = max(0, int(np.min(rows)) - padding)
+            y_max = min(image.shape[0], int(np.max(rows)) + padding)
+            x_min = max(0, int(np.min(cols)) - padding)
+            x_max = min(image.shape[1], int(np.max(cols)) + padding)
 
             w = x_max - x_min
             h = y_max - y_min
diff --git a/gently/hardware/dispim/claude_client.py b/gently/hardware/dispim/claude_client.py
index 1998dfbe..97c1cc41 100644
--- a/gently/hardware/dispim/claude_client.py
+++ b/gently/hardware/dispim/claude_client.py
@@ -18,8 +18,10 @@
 import base64
 import os
 from pathlib import Path
+from typing import cast
 
 import anthropic
+from anthropic.types import MessageParam, TextBlock
 
 from gently.settings import settings
 
@@ -190,28 +192,31 @@ async def check_embryo_centered(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=self.max_tokens,
-                    messages=[
-                        {
-                            "role": "user",
-                            "content": [
-                                {
-                                    "type": "image",
-                                    "source": {
-                                        "type": "base64",
-                                        "media_type": media_type,
-                                        "data": image_data,
+                    messages=cast(
+                        list[MessageParam],
+                        [
+                            {
+                                "role": "user",
+                                "content": [
+                                    {
+                                        "type": "image",
+                                        "source": {
+                                            "type": "base64",
+                                            "media_type": media_type,
+                                            "data": image_data,
+                                        },
                                     },
-                                },
-                                {"type": "text", "text": prompt},
-                            ],
-                        }
-                    ],
+                                    {"type": "text", "text": prompt},
+                                ],
+                            }
+                        ],
+                    ),
                 ),
                 timeout=self.timeout,
             )
 
             # Extract text response
-            response_text = response.content[0].text
+            response_text = cast(TextBlock, response.content[0]).text
 
             # Parse yes/no response
             is_visible, description = self.parse_yes_no_response(response_text)
@@ -279,28 +284,31 @@ async def detect_embryo_presence(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=self.max_tokens,
-                    messages=[
-                        {
-                            "role": "user",
-                            "content": [
-                                {
-                                    "type": "image",
-                                    "source": {
-                                        "type": "base64",
-                                        "media_type": media_type,
-                                        "data": image_data,
+                    messages=cast(
+                        list[MessageParam],
+                        [
+                            {
+                                "role": "user",
+                                "content": [
+                                    {
+                                        "type": "image",
+                                        "source": {
+                                            "type": "base64",
+                                            "media_type": media_type,
+                                            "data": image_data,
+                                        },
                                     },
-                                },
-                                {"type": "text", "text": prompt},
-                            ],
-                        }
-                    ],
+                                    {"type": "text", "text": prompt},
+                                ],
+                            }
+                        ],
+                    ),
                 ),
                 timeout=self.timeout,
             )
 
             # Extract text response
-            response_text = response.content[0].text
+            response_text = cast(TextBlock, response.content[0]).text
 
             # Parse response - now 3 lines: yes/no, score, description
             lines = response_text.strip().split("\n")
@@ -419,28 +427,31 @@ async def validate_focus_montage(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=150,  # Slightly longer for reasoning
-                    messages=[
-                        {
-                            "role": "user",
-                            "content": [
-                                {
-                                    "type": "image",
-                                    "source": {
-                                        "type": "base64",
-                                        "media_type": media_type,
-                                        "data": image_data,
+                    messages=cast(
+                        list[MessageParam],
+                        [
+                            {
+                                "role": "user",
+                                "content": [
+                                    {
+                                        "type": "image",
+                                        "source": {
+                                            "type": "base64",
+                                            "media_type": media_type,
+                                            "data": image_data,
+                                        },
                                     },
-                                },
-                                {"type": "text", "text": prompt},
-                            ],
-                        }
-                    ],
+                                    {"type": "text", "text": prompt},
+                                ],
+                            }
+                        ],
+                    ),
                 ),
                 timeout=self.timeout,
             )
 
             # Extract response
-            response_text = response.content[0].text
+            response_text = cast(TextBlock, response.content[0]).text
             lines = response_text.strip().split("\n", 1)
 
             decision = lines[0].strip().upper()
@@ -541,28 +552,31 @@ async def select_best_focus(
                 self.client.messages.create(
                     model=self.model,
                     max_tokens=100,
-                    messages=[
-                        {
-                            "role": "user",
-                            "content": [
-                                {
-                                    "type": "image",
-                                    "source": {
-                                        "type": "base64",
-                                        "media_type": media_type,
-                                        "data": image_data,
+                    messages=cast(
+                        list[MessageParam],
+                        [
+                            {
+                                "role": "user",
+                                "content": [
+                                    {
+                                        "type": "image",
+                                        "source": {
+                                            "type": "base64",
+                                            "media_type": media_type,
+                                            "data": image_data,
+                                        },
                                     },
-                                },
-                                {"type": "text", "text": prompt},
-                            ],
-                        }
-                    ],
+                                    {"type": "text", "text": prompt},
+                                ],
+                            }
+                        ],
+                    ),
                 ),
                 timeout=self.timeout,
             )
 
             # Parse response
-            response_text = response.content[0].text.strip()
+            response_text = cast(TextBlock, response.content[0]).text.strip()
             lines = response_text.split("\n", 1)
 
             # Extract selected label (first non-empty character that's a valid label)
diff --git a/gently/hardware/dispim/sam_detection.py b/gently/hardware/dispim/sam_detection.py
index 3d33ec12..81f2c4a6 100644
--- a/gently/hardware/dispim/sam_detection.py
+++ b/gently/hardware/dispim/sam_detection.py
@@ -12,7 +12,7 @@
 import uuid
 from io import BytesIO
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import anthropic
 import cv2
@@ -168,7 +168,9 @@ def preprocess_image(
             )
             background = cv2.morphologyEx(img_norm, cv2.MORPH_OPEN, kernel_bg)
             img_no_bg = cv2.subtract(img_norm, background)
-            img_no_bg = cv2.normalize(img_no_bg, None, 0, 255, cv2.NORM_MINMAX).astype(np.uint8)
+            img_no_bg = cv2.normalize(  # type: ignore[call-overload]  # cv2 stub disallows None dst, valid at runtime
+                img_no_bg, None, 0, 255, cv2.NORM_MINMAX
+            ).astype(np.uint8)
             logger.debug("Background subtracted")
         else:
             img_no_bg = img_norm
@@ -562,7 +564,7 @@ async def detect_embryos(
             stage_position,
             pixel_size_um,
             objective_mag,
-            image_shape=image.shape[:2],  # (height, width)
+            image_shape=cast("tuple[int, int]", image.shape[:2]),  # (height, width)
         )
 
         # Save final visualization
diff --git a/gently/harness/detection/queue.py b/gently/harness/detection/queue.py
index bb65504c..9cb3976d 100644
--- a/gently/harness/detection/queue.py
+++ b/gently/harness/detection/queue.py
@@ -5,9 +5,10 @@
 import asyncio
 from collections.abc import Callable
 from datetime import datetime
-from typing import Any
+from typing import Any, cast
 
 import anthropic
+from anthropic.types import Message, TextBlock
 
 from gently.settings import settings
 
@@ -162,13 +163,13 @@ async def _run_single_detector(
 
             # Call Claude Vision API
             response = await asyncio.to_thread(
-                self.claude.messages.create,
+                cast("Callable[..., Message]", self.claude.messages.create),
                 model=self.model,
                 max_tokens=1024,
                 messages=[{"role": "user", "content": content}],
             )
 
-            response_text = response.content[0].text
+            response_text = cast("TextBlock", response.content[0]).text
             api_duration = (datetime.now() - start_time).total_seconds()
 
             # Parse response
diff --git a/gently/harness/detection/verifier.py b/gently/harness/detection/verifier.py
index a540b337..84497fcc 100644
--- a/gently/harness/detection/verifier.py
+++ b/gently/harness/detection/verifier.py
@@ -14,7 +14,7 @@
 import logging
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any
+from typing import Any, cast
 
 import anthropic
 
@@ -680,7 +680,7 @@ async def _run_hardware_context_analysis(
 """
 
             response = await asyncio.to_thread(
-                self.claude.messages.create,
+                self.claude.messages.create,  # type: ignore[arg-type]  # overloaded SDK create() not resolvable through asyncio.to_thread
                 model=self.ensemble_model,  # Use Haiku for speed
                 max_tokens=300,
                 tools=[_HARDWARE_CONTEXT_TOOL],
@@ -849,7 +849,7 @@ async def _run_adversarial(
             content = [{"type": "text", "text": prompt}] + images
 
             response = await asyncio.to_thread(
-                self.claude.messages.create,
+                self.claude.messages.create,  # type: ignore[arg-type]  # overloaded SDK create() not resolvable through asyncio.to_thread
                 model=self.model,
                 max_tokens=500,
                 tools=[_ADVERSARIAL_TOOL],
@@ -928,7 +928,7 @@ async def _run_independent(
             content = [{"type": "text", "text": prompt}] + images
 
             response = await asyncio.to_thread(
-                self.claude.messages.create,
+                self.claude.messages.create,  # type: ignore[arg-type]  # overloaded SDK create() not resolvable through asyncio.to_thread
                 model=self.model,
                 max_tokens=400,
                 tools=[_INDEPENDENT_TOOL],
@@ -1032,7 +1032,7 @@ async def _run_temporal_check(
             content = prev_images + [{"type": "text", "text": prompt}] + current_images
 
             response = await asyncio.to_thread(
-                self.claude.messages.create,
+                self.claude.messages.create,  # type: ignore[arg-type]  # overloaded SDK create() not resolvable through asyncio.to_thread
                 model=self.model,
                 max_tokens=400,
                 tools=[_TEMPORAL_TOOL],
@@ -1119,12 +1119,12 @@ async def single_vote() -> str:
                 try:
                     content = [{"type": "text", "text": ensemble_prompt}] + images
                     response = await asyncio.to_thread(
-                        self.claude.messages.create,
+                        self.claude.messages.create,  # type: ignore[arg-type]  # overloaded SDK create() not resolvable through asyncio.to_thread
                         model=self.ensemble_model,
                         max_tokens=10,  # Very short response expected
                         messages=[{"role": "user", "content": content}],
                     )
-                    return response.content[0].text.strip().upper()
+                    return cast(Any, response.content[0]).text.strip().upper()
                 except Exception as e:
                     logger.debug(f"Ensemble vote failed: {e}")
                     return "ERROR"
diff --git a/gently/harness/state.py b/gently/harness/state.py
index 5e2af6c4..bbd38b15 100644
--- a/gently/harness/state.py
+++ b/gently/harness/state.py
@@ -425,12 +425,12 @@ def get_z_axis_fit(
             return None
 
         # Linear fit: z = slope * secondary_axis + intercept
-        secondary = np.array(secondary)
-        zs = np.array(zs)
+        secondary_arr = np.array(secondary)
+        zs_arr = np.array(zs)
 
         # Use polyfit for linear regression
         try:
-            coeffs = np.polyfit(secondary, zs, 1)
+            coeffs = np.polyfit(secondary_arr, zs_arr, 1)
             return (float(coeffs[0]), float(coeffs[1]))  # slope, intercept
         except Exception:
             return None
diff --git a/gently/organisms/celegans/developmental_tracker.py b/gently/organisms/celegans/developmental_tracker.py
index 51ea513a..1897a2c8 100644
--- a/gently/organisms/celegans/developmental_tracker.py
+++ b/gently/organisms/celegans/developmental_tracker.py
@@ -12,9 +12,10 @@
 from dataclasses import dataclass, field
 from datetime import datetime, timedelta
 from enum import Enum
-from typing import Any
+from typing import Any, cast
 
 import anthropic
+from anthropic.types import MessageParam, TextBlock
 
 from ...settings import settings
 
@@ -287,13 +288,14 @@ def classify_stage(
         content.append({"type": "text", "text": STAGE_CLASSIFICATION_PROMPT})
 
         try:
+            messages: list[MessageParam] = [{"role": "user", "content": cast(Any, content)}]
             response = self.claude.messages.create(
                 model=self.model,
                 max_tokens=500,
-                messages=[{"role": "user", "content": content}],
+                messages=messages,
             )
 
-            result = self._parse_classification(response.content[0].text)
+            result = self._parse_classification(cast(TextBlock, response.content[0]).text)
             result.timepoint = timepoint
 
             # Calculate time to hatching
diff --git a/gently/ui/web/embryo_marker.py b/gently/ui/web/embryo_marker.py
index b6671f71..d2002bc1 100644
--- a/gently/ui/web/embryo_marker.py
+++ b/gently/ui/web/embryo_marker.py
@@ -132,6 +132,7 @@ def _save_marked_image(image: np.ndarray, embryos: list[dict], output_path: Path
             width=2,
         )
 
+        font: ImageFont.FreeTypeFont | ImageFont.ImageFont
         try:
             font = ImageFont.truetype("arial.ttf", 24)
         except Exception:
diff --git a/gently/ui/web/plots.py b/gently/ui/web/plots.py
index 45575f6d..a376740a 100644
--- a/gently/ui/web/plots.py
+++ b/gently/ui/web/plots.py
@@ -5,11 +5,14 @@
 Uses matplotlib with Agg backend for thread safety.
 """
 
+from typing import cast
+
 import matplotlib
 import numpy as np
 
 matplotlib.use("Agg")  # Non-interactive backend for thread safety
 import matplotlib.pyplot as plt
+from matplotlib.backends.backend_agg import FigureCanvasAgg
 
 
 def generate_focus_curve_plot(
@@ -87,7 +90,7 @@ def generate_focus_curve_plot(
 
     # Convert to numpy array
     fig.canvas.draw()
-    buf = np.asarray(fig.canvas.buffer_rgba())
+    buf = np.asarray(cast(FigureCanvasAgg, fig.canvas).buffer_rgba())
     plt.close(fig)
 
     return buf[:, :, :3].astype(np.uint8)
@@ -188,7 +191,7 @@ def generate_calibration_summary_plot(
 
     fig.tight_layout()
     fig.canvas.draw()
-    buf = np.asarray(fig.canvas.buffer_rgba())
+    buf = np.asarray(cast(FigureCanvasAgg, fig.canvas).buffer_rgba())
     plt.close(fig)
 
     return buf[:, :, :3].astype(np.uint8)
@@ -278,7 +281,7 @@ def generate_edge_detection_plot(
 
     fig.tight_layout()
     fig.canvas.draw()
-    buf = np.asarray(fig.canvas.buffer_rgba())
+    buf = np.asarray(cast(FigureCanvasAgg, fig.canvas).buffer_rgba())
     plt.close(fig)
 
     return buf[:, :, :3].astype(np.uint8)
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index f0194af6..aa36ea0c 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -570,7 +570,7 @@ async def start_marking_session(
         import uuid
 
         if not hasattr(self, "_marking_sessions"):
-            self._marking_sessions = {}
+            self._marking_sessions: dict[str, dict[str, Any]] = {}
 
         session_id = str(uuid.uuid4())[:8]
 
diff --git a/scripts/auto_label_examples.py b/scripts/auto_label_examples.py
index 055db082..657ec2f0 100644
--- a/scripts/auto_label_examples.py
+++ b/scripts/auto_label_examples.py
@@ -18,11 +18,12 @@
 import json
 import sys
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import anthropic
 import numpy as np
 import tifffile
+from anthropic.types import TextBlock
 from PIL import Image
 
 # Add parent to path for gently imports
@@ -124,7 +125,7 @@ async def classify_image(
 ) -> dict:
     """Use Claude to classify a single image."""
     response = await asyncio.to_thread(
-        client.messages.create,
+        client.messages.create,  # type: ignore[arg-type]  # overloaded SDK method not resolvable by to_thread
         model="claude-haiku-4-5-20251001",  # Fast and cheap for bulk labeling
         max_tokens=200,
         messages=[
@@ -146,7 +147,7 @@ async def classify_image(
     )
 
     # Parse response
-    text = response.content[0].text
+    text = cast(TextBlock, response.content[0]).text
     try:
         # Find JSON in response
         import re
diff --git a/scripts/projection_explorer.py b/scripts/projection_explorer.py
index 57e39db6..efea0e88 100644
--- a/scripts/projection_explorer.py
+++ b/scripts/projection_explorer.py
@@ -241,10 +241,10 @@ def compute_crop_bounds(
         return (0, volume.shape[1], 0, volume.shape[2])  # Full volume
 
     # Find center of mass and spread
-    cy = np.mean(y_coords)
-    cx = np.mean(x_coords)
-    y_std = max(np.std(y_coords), 20)  # Minimum spread
-    x_std = max(np.std(x_coords), 20)
+    cy = float(np.mean(y_coords))
+    cx = float(np.mean(x_coords))
+    y_std = max(float(np.std(y_coords)), 20.0)  # Minimum spread
+    x_std = max(float(np.std(x_coords)), 20.0)
 
     # Crop to sigma_mult * std around center
     y_min = int(max(0, cy - sigma_mult * y_std - padding))
diff --git a/scripts/recreate_session_videos.py b/scripts/recreate_session_videos.py
index aa53a48e..6cfebccf 100644
--- a/scripts/recreate_session_videos.py
+++ b/scripts/recreate_session_videos.py
@@ -30,7 +30,7 @@
 from dataclasses import dataclass, field
 from datetime import datetime
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import cv2
 import numpy as np
@@ -353,7 +353,7 @@ def _load_font(size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
                 return ImageFont.truetype(path, size=size)
             except Exception:
                 continue
-    return ImageFont.load_default()
+    return cast(ImageFont.FreeTypeFont, ImageFont.load_default())
 
 
 _font_cache: dict[tuple[int, bool], ImageFont.FreeTypeFont] = {}
@@ -571,7 +571,7 @@ def _open_writer(path: Path, size: tuple[int, int], fps: int):
     w, h = size
     for codec, ext in codecs:
         out_path = path.with_suffix(ext)
-        fourcc = cv2.VideoWriter_fourcc(*codec)
+        fourcc = cv2.VideoWriter_fourcc(*codec)  # type: ignore[attr-defined]  # cv2 stubs omit this runtime attr
         writer = cv2.VideoWriter(str(out_path), fourcc, fps, (w, h), isColor=True)
         if writer.isOpened():
             return writer, out_path, codec
diff --git a/scripts/watch_devices.py b/scripts/watch_devices.py
index af7c27ca..f8fff146 100644
--- a/scripts/watch_devices.py
+++ b/scripts/watch_devices.py
@@ -83,10 +83,10 @@ async def watch_stream(host: str, port: int, raw: bool) -> None:
                 buffer += chunk
                 while b"\n\n" in buffer:
                     frame, buffer = buffer.split(b"\n\n", 1)
-                    data_lines = []
+                    data_lines: list[str] = []
                     is_snapshot = False
-                    for line in frame.splitlines():
-                        line = line.decode("utf-8", errors="replace")
+                    for raw_line in frame.splitlines():
+                        line = raw_line.decode("utf-8", errors="replace")
                         if line.startswith(":"):
                             # comment / keepalive
                             continue
diff --git a/scripts/watch_position.py b/scripts/watch_position.py
index ff0dfc46..c66eaf27 100644
--- a/scripts/watch_position.py
+++ b/scripts/watch_position.py
@@ -67,9 +67,9 @@ async def watch(host: str, port: int, log_mode: bool) -> None:
                 buf += chunk
                 while b"\n\n" in buf:
                     frame, buf = buf.split(b"\n\n", 1)
-                    data_lines = []
-                    for line in frame.splitlines():
-                        s = line.decode("utf-8", errors="replace")
+                    data_lines: list[str] = []
+                    for raw_line in frame.splitlines():
+                        s = raw_line.decode("utf-8", errors="replace")
                         if not s or s.startswith(":") or s.startswith("event:"):
                             continue
                         if s.startswith("data:"):
diff --git a/tests/test_dual_camera_factory.py b/tests/test_dual_camera_factory.py
index 2eb649f6..ed957fc2 100644
--- a/tests/test_dual_camera_factory.py
+++ b/tests/test_dual_camera_factory.py
@@ -25,7 +25,7 @@
 
 import bluesky as _bs  # noqa: E402
 
-_bs.RunEngine = MagicMock(name="RunEngine")
+_bs.RunEngine = MagicMock(name="RunEngine")  # type: ignore[misc]  # _bs is a MagicMock module stub; RunEngine is not a real type here
 
 from gently.hardware.dispim.device_factory import create_devices_from_mmcore  # noqa: E402
 
diff --git a/tests/test_lightsheet_buffer.py b/tests/test_lightsheet_buffer.py
index 657376e0..80bb91a1 100644
--- a/tests/test_lightsheet_buffer.py
+++ b/tests/test_lightsheet_buffer.py
@@ -27,7 +27,7 @@
 
 import bluesky as _bs  # noqa: E402
 
-_bs.RunEngine = MagicMock(name="RunEngine")
+_bs.RunEngine = MagicMock(name="RunEngine")  # type: ignore[misc]  # stub attr on mocked bluesky module
 
 from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
 
diff --git a/tests/test_lightsheet_side_param.py b/tests/test_lightsheet_side_param.py
index 3f276b76..4247d891 100644
--- a/tests/test_lightsheet_side_param.py
+++ b/tests/test_lightsheet_side_param.py
@@ -29,7 +29,7 @@
 
 import bluesky as _bs  # noqa: E402
 
-_bs.RunEngine = MagicMock(name="RunEngine")
+_bs.RunEngine = MagicMock(name="RunEngine")  # type: ignore[misc]  # reassign class on mocked bluesky module
 
 from gently.hardware.dispim.device_layer import DeviceLayerServer  # noqa: E402
 
diff --git a/tests/test_lightsheet_streamer.py b/tests/test_lightsheet_streamer.py
index 076d2496..d8fa8fd6 100644
--- a/tests/test_lightsheet_streamer.py
+++ b/tests/test_lightsheet_streamer.py
@@ -17,7 +17,7 @@
 # Patch bluesky.RunEngine specifically
 import bluesky as _bs  # noqa: E402
 
-_bs.RunEngine = MagicMock(name="RunEngine")
+_bs.RunEngine = MagicMock(name="RunEngine")  # type: ignore[misc]  # patching mocked module attr
 
 import asyncio  # noqa: E402
 

From 3fe6e80ab83b3b3deaa391dd0fda62d78dd22c1a Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 06:57:45 -0400
Subject: [PATCH 299/314] fix(types): avoid _tifffile no-redef in imaging.py
 (deps-less mypy)

The optional-import annotation + 'import ... as _tifffile' read as a redefinition
under the lint job's deps-less mypy. Import under a temp alias and assign, which
satisfies both the deps-less and deps-strict mypy runs.
---
 gently/core/imaging.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index 356c7963..9ed20e52 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -326,7 +326,8 @@ def generate_jpeg_projection(
 # Optional tifffile import (only needed for load_volume)
 _tifffile: ModuleType | None
 try:
-    import tifffile as _tifffile
+    import tifffile as _tif
+    _tifffile = _tif
 except ImportError:
     _tifffile = None
 

From 11633fbf3d61ff100fe89642fa176bcc13f8c47a Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 06:58:03 -0400
Subject: [PATCH 300/314] style: ruff format imaging.py

---
 gently/core/imaging.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/gently/core/imaging.py b/gently/core/imaging.py
index 9ed20e52..5f67d894 100644
--- a/gently/core/imaging.py
+++ b/gently/core/imaging.py
@@ -327,6 +327,7 @@ def generate_jpeg_projection(
 _tifffile: ModuleType | None
 try:
     import tifffile as _tif
+
     _tifffile = _tif
 except ImportError:
     _tifffile = None

From dbdc959d3e4444b720647a1e3081f5b8bdf9f192 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 16:37:57 +0530
Subject: [PATCH 301/314] =?UTF-8?q?docs(launcher):=20parked=20design=20?=
 =?UTF-8?q?=E2=80=94=20unified=20launcher=20+=20bare-basic=20launch=20gate?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PARKED for a future session. launch_gently as the single entry point that starts/stops
the device layer (managed child subprocess; graceful stop + mid-run guard; auto-kill on
exit; external device layer detected). Launch gate is BARE BASIC — two questions
(microscope hardware on/off, AI agent/API on/off) + Let's go; organism/hardware/port/
SAM/session are defaults behind Advanced/Settings, never on the gate. Boot uses
defer-init so a web gate can control boot-level behavior. Dark/sharp/sleek mockup at
docs/superpowers/mockups/2026-07-02-launcher-gate.html. Decisions log + phasing included.
---
 .../mockups/2026-07-02-launcher-gate.html     | 82 +++++++++++++++
 .../2026-07-02-unified-launcher-design.md     | 99 +++++++++++++++++++
 2 files changed, 181 insertions(+)
 create mode 100644 docs/superpowers/mockups/2026-07-02-launcher-gate.html
 create mode 100644 docs/superpowers/specs/2026-07-02-unified-launcher-design.md

diff --git a/docs/superpowers/mockups/2026-07-02-launcher-gate.html b/docs/superpowers/mockups/2026-07-02-launcher-gate.html
new file mode 100644
index 00000000..18879dde
--- /dev/null
+++ b/docs/superpowers/mockups/2026-07-02-launcher-gate.html
@@ -0,0 +1,82 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Launch Gently</title>
+<style>
+  :root{
+    --bg:#0a0d13; --inset:#0d121b; --line:#1b222e; --line2:#27303d;
+    --text:#e7edf4; --muted:#8792a3; --faint:#57616f;
+    --accent:#5b8cff; --accent-txt:#a9c4ff; --accentdim:rgba(91,140,255,.12);
+    --green:#40d17f; --mono:ui-monospace,"SF Mono",Menlo,Consolas,monospace;
+  }
+  *{box-sizing:border-box}
+  html,body{margin:0}
+  body{min-height:100vh;color:var(--text);
+    font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Inter,system-ui,sans-serif;-webkit-font-smoothing:antialiased;
+    background:radial-gradient(1000px 500px at 50% -14%, rgba(91,140,255,.11), transparent 60%), var(--bg);
+    display:flex;justify-content:center;align-items:center;padding:40px 20px}
+  .wrap{width:100%;max-width:460px}
+  .head{display:flex;align-items:center;justify-content:center;gap:11px;margin-bottom:8px}
+  .mark{width:26px;height:26px;border-radius:50%;border:2px solid var(--accent);position:relative;
+    background:radial-gradient(circle at 50% 50%, rgba(91,140,255,.28), transparent 70%)}
+  .mark::after{content:"";position:absolute;inset:0;margin:auto;width:9px;height:9px;border-radius:50%;
+    background:var(--accent);box-shadow:0 0 12px var(--accent)}
+  .wordmark{font-size:22px;font-weight:700;letter-spacing:-.015em}
+  .cap{text-align:center;color:var(--muted);font-size:14px;margin:0 0 30px}
+  .opt{display:flex;align-items:center;gap:15px;padding:18px 18px;border:1px solid var(--line2);border-radius:13px;
+    background:linear-gradient(180deg,#111621,#0e131c);margin-bottom:13px;transition:.15s;cursor:pointer}
+  .opt.on{border-color:rgba(91,140,255,.55);background:linear-gradient(180deg,rgba(91,140,255,.09),#0e131c);
+    box-shadow:0 0 0 1px rgba(91,140,255,.25), 0 14px 34px -18px rgba(91,140,255,.5)}
+  .ic{width:42px;height:42px;border-radius:11px;flex:none;display:flex;align-items:center;justify-content:center;
+    background:var(--inset);border:1px solid var(--line2);color:var(--muted)}
+  .opt.on .ic{background:var(--accentdim);border-color:rgba(91,140,255,.4);color:var(--accent-txt)}
+  .txt{flex:1;min-width:0}
+  .t{font-size:15.5px;font-weight:650;letter-spacing:-.01em}
+  .s{font-size:12.5px;color:var(--muted);margin-top:3px;line-height:1.45}
+  .s .mono{font-family:var(--mono);color:var(--faint)}
+  .sw{width:44px;height:25px;border-radius:999px;background:#232c39;position:relative;flex:none;transition:.15s;border:1px solid var(--line2)}
+  .sw::after{content:"";position:absolute;top:2px;left:2px;width:19px;height:19px;border-radius:50%;background:#5c6675;transition:.15s}
+  .opt.on .sw{background:var(--accent);border-color:transparent;box-shadow:0 0 16px rgba(91,140,255,.4)}
+  .opt.on .sw::after{left:21px;background:#fff}
+  .btn{width:100%;margin-top:9px;background:linear-gradient(180deg,#5b8cff,#4271ec);color:#fff;border:0;border-radius:12px;
+    padding:16px;font-size:16px;font-weight:700;cursor:pointer;box-shadow:0 14px 34px -12px rgba(91,140,255,.7);
+    display:flex;align-items:center;justify-content:center;gap:9px}
+  .btn .go{font-size:17px}
+  .foot{text-align:center;margin-top:16px;color:var(--faint);font-size:12px}
+  .foot a{color:var(--muted);text-decoration:none}
+</style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="head"><span class="mark"></span><span class="wordmark">Gently</span></div>
+    <p class="cap">What do you need today?</p>
+
+    <div class="opt on">
+      <div class="ic">
+        <svg width="21" height="21" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="9" r="4"/><path d="M12 13v6M8 21h8M6 9a6 6 0 0 1 8-5.6"/></svg>
+      </div>
+      <div class="txt">
+        <div class="t">Microscope hardware</div>
+        <div class="s">Start the device layer &amp; connect to the rig <span class="mono">· :60610</span></div>
+      </div>
+      <span class="sw"></span>
+    </div>
+
+    <div class="opt on">
+      <div class="ic">
+        <svg width="21" height="21" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3l2.2 5.8L20 11l-5.8 2.2L12 19l-2.2-5.8L4 11l5.8-2.2z"/></svg>
+      </div>
+      <div class="txt">
+        <div class="t">AI agent</div>
+        <div class="s">Chat, perception &amp; planning — uses your API key</div>
+      </div>
+      <span class="sw"></span>
+    </div>
+
+    <button class="btn">Let's go <span class="go">→</span></button>
+    <div class="foot"><a href="#">Advanced options</a> · remembers your choice</div>
+  </div>
+</body>
+</html>
diff --git a/docs/superpowers/specs/2026-07-02-unified-launcher-design.md b/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
new file mode 100644
index 00000000..3588d3f5
--- /dev/null
+++ b/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
@@ -0,0 +1,99 @@
+# Unified Launcher — single entry point + device-layer process management — Design
+
+Date: 2026-07-02
+Status: **Design — PARKED.** Direction agreed + mockup done; implementation deferred to a future session.
+Branch: `feature/unified-launcher` (off `development`).
+
+## Problem
+
+Starting gently today is two commands in two terminals: `python start_device_layer.py`
+(the hardware server) then `python launch_gently.py` (agent + web). gently can't
+start or stop the device layer — it only connects to it as an HTTP client — so there's
+no in‑app way to bring hardware up/down. Goal: make `launch_gently.py` the **single**
+entry point, with a dead‑simple launch gate and the ability to start/stop the device
+layer from gently.
+
+## How the two processes relate (today)
+
+- `start_device_layer.py` boots the hardware control server (aiohttp) on **port 60610**
+  (`DEVICE_PORT`) and runs the configured hardware module's `create_device_layer()`.
+  Independent OS process.
+- `launch_gently.py` boots the agent + web/viz server and creates an HTTP client
+  (`QueueServerClient → http://127.0.0.1:60610`); `client.is_connected` drives the
+  "Device: ○ offline" banner. The two only talk over HTTP.
+
+## The launch gate — BARE BASIC (the key decision)
+
+The launch screen answers exactly two questions, nothing more:
+
+1. **Microscope hardware — on/off.** On → gently starts + connects the device layer.
+   Off → software‑only (analysis, planning, reviewing saved data).
+2. **AI agent (API) — on/off.** On → chat, perception, planning (uses the API key).
+   Off → UI‑only.
+
+Then **Let's go →**. That's the whole screen. Everything else — organism, hardware
+module, device port, SAM device, session resume — is a **default** (config / last‑used),
+reachable behind a muted **"Advanced options"** disclosure and in **Settings**. It is
+NOT on the gate: if you're not using hardware, you should never be asked which hardware.
+
+Visual reference (dark, sharp, sleek): `docs/superpowers/mockups/2026-07-02-launcher-gate.html`
+— two toggle cards (`Microscope hardware`, `AI agent`) + `Let's go →` + `Advanced
+options · remembers your choice`.
+
+## Process model — managed child subprocess
+
+A **`DeviceLayerSupervisor`** in the gently process spawns `start_device_layer.py` as a
+**child** (`subprocess.Popen([sys.executable, "start_device_layer.py", "--port", …,
+"--sam-device", …])`), holds its handle, monitors liveness, captures its log, and stops
+it. Ownership is what makes start/stop‑from‑UI and no‑orphans work.
+- API: `start(config)`, `stop(force=False)`, `status()`, log tail, `atexit`/signal cleanup.
+- **External device layer still supported:** if one is already running on 60610, gently
+  connects and shows it as "external (not managed)" — it just won't stop what it didn't start.
+- Rejected alternatives: independent processes + a `/shutdown` endpoint (weaker ownership,
+  more parts); in‑process device layer (a hardware crash would take down the UI).
+
+## Boot flow (defer‑init)
+
+`launch_gently` boots a minimal web server → shows the **launch gate** (prefilled from
+last choice) → on **Let's go**, it initializes per the two toggles: start the agent (if
+API on) and start the device layer via the supervisor (if hardware on) → then the landing
+("Good afternoon…") → dashboard. Deferring heavy init until the gate is submitted is what
+lets a web screen control boot‑level behavior (agent on/off).
+
+## Runtime control
+
+A **device‑layer panel in the Devices tab** mirrors the gate's hardware block at runtime:
+live status (running / stopped / external / crashed), Start / Stop, and a tail of the
+device‑layer log — so you can bring hardware up/down without restarting gently.
+
+## Stop safety (graceful + mid‑run guard)
+
+Stop → if a plan/acquisition is active, warn + require explicit confirm ("hardware is
+active — stop anyway?") → SIGTERM (clean shutdown) → SIGKILL fallback (~5 s). Reuses the
+409 + `"blocked"` pattern from the thermalizer work. Startup failure (hardware off)
+surfaces the existing plain‑language `_render_startup_failure` diagnosis, not a traceback.
+
+## Persistence
+
+`config/launch.local.json` (gitignored) remembers the two toggles (+ any advanced values)
+so the gate is prefilled every boot.
+
+## Non‑goals (YAGNI)
+
+Auto‑restart‑on‑crash loops; multiple / remote device layers (mesh already covers
+cross‑machine); managing an externally‑started device layer's lifecycle; putting
+organism/hardware/port/SAM/session on the gate (they're defaults + Advanced/Settings).
+
+## Phasing (when resumed)
+
+1. `DeviceLayerSupervisor` + the runtime Devices start/stop panel + the **hardware toggle**
+   on a minimal gate. Delivers "no more separate `start_device_layer.py`" immediately.
+2. Defer‑init boot refactor + the **agent toggle** + persistence + "Advanced options".
+
+## Decisions log (from brainstorming)
+
+- Launcher model: **web startup screen + runtime panel**.
+- Boot flow: **show the gate every boot, remember last choices** (one click to proceed).
+- Stop: **graceful SIGTERM + mid‑run guard + SIGKILL fallback**.
+- Scope: **fold in gently's own options** — but as a **bare‑basic 2‑question gate**
+  (hardware, agent), with the rest behind Advanced/Settings.

From 8ad90354f1d54af1860a45188bf87086c7653ab4 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 16:44:06 +0530
Subject: [PATCH 302/314] docs(launcher): credit Magdalena + open questions to
 fold in (initial work)

This is initial/RFC work. Idea credited to Magdalena. Adds open questions: background
(non-blocking) device startup after launch; gently usable while the device boots;
on-demand device startup-sequence console; shutdown from that same console; guided
shutdown housekeeping (e.g. prompt to reset the F drive).
---
 .../2026-07-02-unified-launcher-design.md     | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/docs/superpowers/specs/2026-07-02-unified-launcher-design.md b/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
index 3588d3f5..39adb0be 100644
--- a/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
+++ b/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
@@ -1,7 +1,9 @@
 # Unified Launcher — single entry point + device-layer process management — Design
 
 Date: 2026-07-02
-Status: **Design — PARKED.** Direction agreed + mockup done; implementation deferred to a future session.
+Status: **Initial design (RFC) — PARKED.** A starting point to build on, not a finished
+design; direction + mockup done, implementation deferred to a future session.
+Idea credit: **Magdalena** — the single unified launcher.
 Branch: `feature/unified-launcher` (off `development`).
 
 ## Problem
@@ -90,6 +92,25 @@ organism/hardware/port/SAM/session on the gate (they're defaults + Advanced/Sett
    on a minimal gate. Delivers "no more separate `start_device_layer.py`" immediately.
 2. Defer‑init boot refactor + the **agent toggle** + persistence + "Advanced options".
 
+## Open questions to fold in (this is initial work)
+
+This is a starting point — the following must be worked through as it grows:
+
+- **Background startup.** After "Let's go", the device‑layer startup should run in the
+  **background (non‑blocking)** while gently proceeds to the dashboard — not block the gate
+  until the device connects. (To confirm + design the progress signalling.)
+- **Usable during startup.** gently must stay **usable while the device layer boots** —
+  software features (planning, review, analysis) available immediately; hardware‑dependent
+  actions gated behind a "device starting…" state until connected.
+- **On‑demand startup‑sequence screen.** There must be a screen to watch the device
+  **startup sequence** on demand — a device console (in the Devices panel) streaming the
+  `start_device_layer` boot log + per‑stage connection progress.
+- **Shutdown from that same screen.** That console is also the **shutdown control** — start
+  the sequence, watch it, and stop the device from one place.
+- **Guided shutdown housekeeping.** Shutdown is a **sequence, not just a kill** — e.g. it
+  can prompt the operator to **reset the F drive** (post‑shutdown drive/housekeeping) as a
+  step in the flow.
+
 ## Decisions log (from brainstorming)
 
 - Launcher model: **web startup screen + runtime panel**.

From caa0d57e2d188f0e8be4ca5e99d13bb6780b23e0 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Thu, 2 Jul 2026 16:47:01 +0530
Subject: [PATCH 303/314] =?UTF-8?q?docs(launcher):=20future=20direction=20?=
 =?UTF-8?q?=E2=80=94=20Windows=20desktop=20app=20(Electron=20shell)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fold-in to weigh: package the unified launcher as a Windows desktop app (potentially
Electron) that owns/spawns the Python backend + device-layer child and renders the web
UI natively (launch gate as first screen), with native process lifecycle + installer.
Web UI stays the single source of truth; pywebview/Tauri as lighter fallbacks. The
managed-child model here is what an Electron shell would take over.
---
 .../specs/2026-07-02-unified-launcher-design.md  | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/superpowers/specs/2026-07-02-unified-launcher-design.md b/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
index 39adb0be..3e24228c 100644
--- a/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
+++ b/docs/superpowers/specs/2026-07-02-unified-launcher-design.md
@@ -111,6 +111,22 @@ This is a starting point — the following must be worked through as it grows:
   can prompt the operator to **reset the F drive** (post‑shutdown drive/housekeeping) as a
   step in the flow.
 
+## Future direction — Windows desktop app (Electron)
+
+Bigger fold‑in to weigh: package the unified launcher as a **desktop app for Windows**,
+potentially **Electron**, so gently is a double‑click application instead of terminal
+commands. Electron would *be* the launcher shell — it owns and spawns the Python backend
+(`launch_gently`) and the device‑layer child, renders the existing web UI in a native
+window (the launch gate is the first screen), and gets native process lifecycle
+(children killed on quit), a tray/menu, and a real installer + auto‑update.
+
+Tradeoffs for later: bundling/shipping the Python environment (embeddable Python /
+PyInstaller), app size, auto‑update, and keeping the **web UI the single source of truth**
+(Electron stays a thin shell — no UI logic moves into it). A lighter native wrapper
+(**pywebview** or **Tauri**) is the fallback if Electron's footprint is too heavy. This is
+a packaging/architecture decision, not required for the launcher's first cut — but the
+managed‑child process model here is exactly what an Electron shell would take over.
+
 ## Decisions log (from brainstorming)
 
 - Launcher model: **web startup screen + runtime panel**.

From e2aa54f5df5523f04297b6d8484c670fe62abc67 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 02:27:31 -0400
Subject: [PATCH 304/314] feat(launcher): scaffold DeviceLayerSupervisor +
 launch gate (RFC #78)

First implementation cut of the parked unified-launcher RFC: gently can now
own the device-layer process and start/stop it from the UI, instead of
requiring a second terminal running start_device_layer.py.

- DeviceLayerSupervisor (gently/app/device_supervisor.py): spawns
  start_device_layer.py as a managed child, tails its console into a ring
  buffer, reports running/stopped/crashed/external, stops gracefully with a
  hard-kill fallback, and atexit-kills the child so it never orphans. Detects
  and respects an externally-started device layer (won't stop what it didn't
  start).
- Launch gate (/launch + templates/launch.html): the bare two-question start
  screen (hardware on/off, agent on/off), styled from the RFC mockup, wired to
  persist choices and start the device layer on "Let's go".
- launch_prefs.py: remembers the gate's toggles in config/launch.local.json.
- routes/device_layer.py: status/start/stop/log + launch prefs, with start/stop
  behind require_control and a 409 "blocked" mid-run guard on stop.
- Wired the router into register_all_routes and attach a supervisor to the viz
  server at boot.

Deferred (RFC open questions, marked in-code): defer-init boot so the agent
toggle gates startup; truly graceful Windows shutdown (needs SIGBREAK handling
in start_device_layer.py); background/non-blocking startup with per-stage boot
progress; guided shutdown housekeeping.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gently/app/device_supervisor.py      | 313 +++++++++++++++++++++++++++
 gently/ui/web/launch_prefs.py        |  81 +++++++
 gently/ui/web/routes/__init__.py     |   2 +
 gently/ui/web/routes/device_layer.py | 141 ++++++++++++
 gently/ui/web/templates/launch.html  | 196 +++++++++++++++++
 launch_gently.py                     |  12 +
 6 files changed, 745 insertions(+)
 create mode 100644 gently/app/device_supervisor.py
 create mode 100644 gently/ui/web/launch_prefs.py
 create mode 100644 gently/ui/web/routes/device_layer.py
 create mode 100644 gently/ui/web/templates/launch.html

diff --git a/gently/app/device_supervisor.py b/gently/app/device_supervisor.py
new file mode 100644
index 00000000..5f7c01a7
--- /dev/null
+++ b/gently/app/device_supervisor.py
@@ -0,0 +1,313 @@
+"""Managed child subprocess for the device layer.
+
+Today gently only connects to ``start_device_layer.py`` as an HTTP client, so
+there is no in-app way to bring hardware up or down — you run it yourself in a
+second terminal. ``DeviceLayerSupervisor`` gives the gently process *ownership*
+of that child: it spawns ``start_device_layer.py``, holds the handle, tails its
+console output, reports liveness, and stops it (gracefully, then forcibly). That
+ownership is what makes start/stop-from-UI and no-orphans-on-exit possible.
+
+Design: ``docs/superpowers/specs/2026-07-02-unified-launcher-design.md`` (RFC #78).
+
+Scope of this scaffold
+----------------------
+- Real, working spawn / stop / status / log-tail + atexit cleanup.
+- **External device layer is respected:** if something is already listening on
+  the port, we surface it as ``external`` and never try to manage (or stop) what
+  we did not start.
+
+Deliberately deferred (RFC "open questions"):
+- Background/non-blocking startup with per-stage boot progress.
+- Truly graceful shutdown on Windows — that needs ``start_device_layer.py`` to
+  handle ``SIGBREAK`` (see ``stop`` below). Until then Windows falls back to a
+  hard terminate after the grace period.
+"""
+
+from __future__ import annotations
+
+import atexit
+import logging
+import signal
+import socket
+import subprocess
+import sys
+import threading
+import time
+from collections import deque
+from pathlib import Path
+
+from gently.settings import settings
+
+logger = logging.getLogger(__name__)
+
+# Repo root: gently/app/device_supervisor.py -> parents[2]
+_PROJECT_ROOT = Path(__file__).resolve().parents[2]
+_DEVICE_SCRIPT = _PROJECT_ROOT / "start_device_layer.py"
+
+# How many console lines to retain for the log-tail shown in the Devices panel.
+_LOG_TAIL_LINES = 500
+# Grace period (seconds) for a clean shutdown before we hard-kill.
+_STOP_GRACE_SECONDS = 5.0
+
+
+class DeviceLayerSupervisor:
+    """Own the ``start_device_layer.py`` child process for one gently instance.
+
+    Thread-safe: ``start``/``stop`` take an internal lock so overlapping calls
+    from async route handlers can't race on the process handle. A single reader
+    thread drains the child's stdout into a bounded ring buffer for the tail.
+    """
+
+    def __init__(
+        self,
+        port: int = settings.network.device_port,
+        host: str = settings.network.device_host,
+        sam_device: str = "cuda",
+        config_path: str = "config/config.yml",
+    ):
+        self.port = port
+        self.host = host
+        self.sam_device = sam_device
+        self.config_path = config_path
+
+        self._proc: subprocess.Popen | None = None
+        self._lock = threading.Lock()
+        self._log: deque[str] = deque(maxlen=_LOG_TAIL_LINES)
+        self._reader: threading.Thread | None = None
+        self._started_at: float | None = None
+        # True once *we* asked the child to stop, so a resulting non-zero exit
+        # reads as "stopped" rather than "crashed".
+        self._stopping = False
+
+        atexit.register(self._atexit_cleanup)
+
+    # ── lifecycle ────────────────────────────────────────────────────────
+
+    def start(self, *, sam_device: str | None = None, config_path: str | None = None) -> dict:
+        """Spawn the device layer child if it isn't already up.
+
+        Idempotent: if we already own a live child, returns its status. If an
+        *external* (unmanaged) device layer is already listening on the port,
+        refuses to start a duplicate and returns the external status.
+        """
+        with self._lock:
+            if self._alive():
+                logger.debug("Device layer already managed (pid=%s)", self._proc.pid)
+                return self._status_locked()
+
+            if self._port_open():
+                # Something is already listening we didn't start — don't stomp it.
+                logger.info(
+                    "Device layer already running externally on %s:%s — not spawning a child",
+                    self.host,
+                    self.port,
+                )
+                return self._status_locked()
+
+            if not _DEVICE_SCRIPT.exists():
+                raise FileNotFoundError(f"device layer script not found: {_DEVICE_SCRIPT}")
+
+            if sam_device is not None:
+                self.sam_device = sam_device
+            if config_path is not None:
+                self.config_path = config_path
+
+            cmd = [
+                sys.executable,
+                str(_DEVICE_SCRIPT),
+                "--port",
+                str(self.port),
+                "--sam-device",
+                self.sam_device,
+                "--config",
+                self.config_path,
+            ]
+
+            # A new process group on Windows is what later lets us send a
+            # CTRL_BREAK for a (best-effort) clean shutdown instead of only a
+            # hard TerminateProcess.
+            creationflags = 0
+            if sys.platform == "win32":
+                creationflags = subprocess.CREATE_NEW_PROCESS_GROUP  # type: ignore[attr-defined]
+
+            logger.info("Spawning device layer: %s", " ".join(cmd))
+            self._log.clear()
+            self._stopping = False
+            self._proc = subprocess.Popen(
+                cmd,
+                cwd=str(_PROJECT_ROOT),
+                stdout=subprocess.PIPE,
+                stderr=subprocess.STDOUT,
+                text=True,
+                encoding="utf-8",
+                errors="replace",
+                bufsize=1,
+                creationflags=creationflags,
+            )
+            self._started_at = time.monotonic()
+
+            self._reader = threading.Thread(
+                target=self._drain_output,
+                args=(self._proc,),
+                name="device-layer-log",
+                daemon=True,
+            )
+            self._reader.start()
+
+            return self._status_locked()
+
+    def stop(self, *, force: bool = False, timeout: float = _STOP_GRACE_SECONDS) -> dict:
+        """Stop the managed child. Graceful first, hard-kill fallback.
+
+        We only stop a child *we* spawned — an external device layer is left
+        alone (you can't cleanly stop what you don't own).
+
+        ``force=True`` skips the grace period and hard-kills immediately.
+        """
+        with self._lock:
+            if not self._alive():
+                # Nothing of ours to stop (may still be external — status says so).
+                return self._status_locked()
+
+            self._stopping = True
+            proc = self._proc
+            assert proc is not None
+
+            if force:
+                self._hard_kill(proc)
+                return self._status_locked()
+
+            # Graceful request.
+            try:
+                if sys.platform == "win32":
+                    # Best-effort clean stop. NOTE: start_device_layer.py handles
+                    # SIGINT/SIGTERM but not SIGBREAK, so today this usually falls
+                    # through to the hard-kill below. Teaching the device layer to
+                    # handle SIGBREAK (RFC follow-up) makes this a clean shutdown.
+                    proc.send_signal(signal.CTRL_BREAK_EVENT)  # type: ignore[attr-defined]
+                else:
+                    proc.terminate()  # SIGTERM -> device layer's clean shutdown path
+            except (ProcessLookupError, OSError) as e:
+                logger.debug("Signal to device layer failed (already exiting?): %s", e)
+
+            try:
+                proc.wait(timeout=timeout)
+                logger.info("Device layer stopped cleanly (rc=%s)", proc.returncode)
+            except subprocess.TimeoutExpired:
+                logger.warning(
+                    "Device layer didn't exit within %.1fs — forcing termination", timeout
+                )
+                self._hard_kill(proc)
+
+            return self._status_locked()
+
+    def restart(self, **kwargs) -> dict:
+        """Stop (if running) then start — convenience for the Devices panel."""
+        self.stop()
+        return self.start(**kwargs)
+
+    # ── introspection ────────────────────────────────────────────────────
+
+    def status(self) -> dict:
+        """Current state of the device layer (see ``_status_locked``)."""
+        with self._lock:
+            return self._status_locked()
+
+    def log_tail(self, limit: int = 200) -> list[str]:
+        """The most recent captured console lines (oldest → newest)."""
+        lines = list(self._log)
+        return lines[-limit:] if limit else lines
+
+    # ── internals ────────────────────────────────────────────────────────
+
+    def _status_locked(self) -> dict:
+        """Compute status. Caller must hold ``_lock``.
+
+        state:
+          running  — we own a live child
+          crashed  — our child exited non-zero without us asking it to
+          external — we don't own it, but the port is listening
+          stopped  — nothing running (never started, or cleanly stopped)
+        """
+        managed_alive = self._alive()
+        port_open = self._port_open()
+
+        if managed_alive:
+            state = "running"
+        elif self._proc is not None and self._proc.returncode not in (None, 0) and not self._stopping:
+            state = "crashed"
+        elif port_open:
+            state = "external"
+        else:
+            state = "stopped"
+
+        pid = self._proc.pid if (self._proc and managed_alive) else None
+        rc = self._proc.returncode if self._proc else None
+        uptime = (
+            round(time.monotonic() - self._started_at, 1)
+            if (managed_alive and self._started_at)
+            else None
+        )
+
+        return {
+            "state": state,
+            "managed": managed_alive,
+            "pid": pid,
+            "returncode": rc,
+            "host": self.host,
+            "port": self.port,
+            "port_open": port_open,
+            "sam_device": self.sam_device,
+            "uptime_seconds": uptime,
+            "log_tail": self.log_tail(50),
+        }
+
+    def _alive(self) -> bool:
+        """True if we own a child that is still running."""
+        return self._proc is not None and self._proc.poll() is None
+
+    def _port_open(self, timeout: float = 0.25) -> bool:
+        """True if anything is accepting connections on the device port.
+
+        Used to detect an externally-started device layer. ``host`` may be a
+        bind address like ``0.0.0.0``; probe loopback for that case.
+        """
+        probe_host = "127.0.0.1" if self.host in ("0.0.0.0", "", None) else self.host
+        try:
+            with socket.create_connection((probe_host, self.port), timeout=timeout):
+                return True
+        except OSError:
+            return False
+
+    def _hard_kill(self, proc: subprocess.Popen) -> None:
+        """Terminate a process forcibly and reap it. Caller holds ``_lock``."""
+        try:
+            proc.kill()
+            proc.wait(timeout=3.0)
+        except subprocess.TimeoutExpired:
+            logger.error("Device layer pid=%s would not die after kill()", proc.pid)
+        except (ProcessLookupError, OSError):
+            pass
+
+    def _drain_output(self, proc: subprocess.Popen) -> None:
+        """Reader-thread body: copy child stdout into the ring buffer."""
+        stream = proc.stdout
+        if stream is None:
+            return
+        try:
+            for line in iter(stream.readline, ""):
+                self._log.append(line.rstrip("\n"))
+        except (ValueError, OSError):
+            # Stream closed underneath us during shutdown — fine.
+            pass
+
+    def _atexit_cleanup(self) -> None:
+        """Kill an orphaned child when the gently process exits."""
+        proc = self._proc
+        if proc is not None and proc.poll() is None:
+            logger.info("atexit: terminating managed device layer (pid=%s)", proc.pid)
+            self._stopping = True
+            try:
+                proc.kill()
+            except (ProcessLookupError, OSError):
+                pass
diff --git a/gently/ui/web/launch_prefs.py b/gently/ui/web/launch_prefs.py
new file mode 100644
index 00000000..0a5bb905
--- /dev/null
+++ b/gently/ui/web/launch_prefs.py
@@ -0,0 +1,81 @@
+"""Persistence for the launch gate's two toggles (+ advanced defaults).
+
+The launch gate answers exactly two questions — *microscope hardware on/off* and
+*AI agent on/off* — and everything else (device port, SAM device) is a remembered
+default behind "Advanced options". Those choices live in
+``config/launch.local.json`` (gitignored) so the gate is prefilled every boot.
+
+See ``docs/superpowers/specs/2026-07-02-unified-launcher-design.md`` (RFC #78).
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from pathlib import Path
+
+from gently.settings import settings
+
+logger = logging.getLogger(__name__)
+
+# Repo root: gently/ui/web/launch_prefs.py -> parents[3]
+_CONFIG_DIR = Path(__file__).resolve().parents[3] / "config"
+PREFS_PATH = _CONFIG_DIR / "launch.local.json"
+
+# Only these keys are read from / written to disk. Advanced values fall back to
+# settings so a fresh install has sensible defaults without a prefs file.
+_DEFAULTS: dict = {
+    "hardware": True,  # start + connect the device layer
+    "agent": True,  # enable chat / perception / planning (needs API key)
+    "port": settings.network.device_port,
+    "sam_device": "cuda",
+}
+_ALLOWED_KEYS = set(_DEFAULTS)
+
+
+def load_prefs() -> dict:
+    """Return the persisted launch choices merged over defaults.
+
+    Never raises — a missing or corrupt file just yields the defaults, so the
+    gate always renders.
+    """
+    prefs = dict(_DEFAULTS)
+    try:
+        if PREFS_PATH.exists():
+            stored = json.loads(PREFS_PATH.read_text(encoding="utf-8"))
+            if isinstance(stored, dict):
+                prefs.update({k: stored[k] for k in _ALLOWED_KEYS if k in stored})
+    except (OSError, ValueError) as e:
+        logger.warning("launch prefs unreadable (%s) — using defaults", e)
+    return prefs
+
+
+def save_prefs(prefs: dict) -> dict:
+    """Persist a (partial) set of launch choices; returns the merged result.
+
+    Unknown keys are ignored; known keys are coerced to the expected types.
+    """
+    merged = load_prefs()
+    for key in _ALLOWED_KEYS & set(prefs):
+        merged[key] = _coerce(key, prefs[key])
+    try:
+        _CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+        PREFS_PATH.write_text(json.dumps(merged, indent=2), encoding="utf-8")
+    except OSError as e:
+        logger.error("could not persist launch prefs: %s", e)
+    return merged
+
+
+def _coerce(key: str, value):
+    """Coerce a JSON-supplied value to the type its default implies."""
+    default = _DEFAULTS[key]
+    if isinstance(default, bool):
+        if isinstance(value, str):
+            return value.strip().lower() in ("1", "true", "yes", "on")
+        return bool(value)
+    if isinstance(default, int):
+        try:
+            return int(value)
+        except (TypeError, ValueError):
+            return default
+    return value
diff --git a/gently/ui/web/routes/__init__.py b/gently/ui/web/routes/__init__.py
index a881a0bb..ef939435 100644
--- a/gently/ui/web/routes/__init__.py
+++ b/gently/ui/web/routes/__init__.py
@@ -12,6 +12,7 @@
 from .chat import create_router as create_chat_router
 from .context import create_router as create_context_router
 from .data import create_router as create_data_router
+from .device_layer import create_router as create_device_layer_router
 from .experiments import create_router as create_experiments_router
 from .images import create_router as create_images_router
 from .notebook import create_router as create_notebook_router
@@ -30,6 +31,7 @@ def register_all_routes(server):
     for factory in (
         create_pages_router,
         create_auth_router,
+        create_device_layer_router,
         create_sessions_router,
         create_campaigns_router,
         create_experiments_router,
diff --git a/gently/ui/web/routes/device_layer.py b/gently/ui/web/routes/device_layer.py
new file mode 100644
index 00000000..8f8dbf0f
--- /dev/null
+++ b/gently/ui/web/routes/device_layer.py
@@ -0,0 +1,141 @@
+"""Device-layer supervision + launch gate routes.
+
+Two surfaces, both backed by ``DeviceLayerSupervisor``:
+
+- **Launch gate** (``GET /launch``) — the bare two-question start screen
+  (hardware on/off, agent on/off) with its persisted choices.
+- **Devices panel** (``/api/device-layer/*``) — runtime status, log tail, and
+  Start / Stop controls that mirror the gate's hardware block.
+
+Control-mutating endpoints (start/stop) are gated behind ``require_control``,
+matching the rest of the hardware routes. Stop reuses the 409 + ``"blocked"``
+mid-run guard pattern: if hardware looks active, the caller must confirm.
+
+See ``docs/superpowers/specs/2026-07-02-unified-launcher-design.md`` (RFC #78).
+"""
+
+from __future__ import annotations
+
+import logging
+
+from fastapi import APIRouter, Depends, Request
+from fastapi.responses import HTMLResponse, JSONResponse
+
+from gently.ui.web.auth import require_control
+from gently.ui.web.launch_prefs import load_prefs, save_prefs
+
+logger = logging.getLogger(__name__)
+
+
+def get_supervisor(server):
+    """Return the server's DeviceLayerSupervisor, creating one on first use.
+
+    ``launch_gently`` attaches a supervisor to the viz server at boot, but we
+    lazily construct one if it's absent so these routes work standalone (and so
+    the panel degrades gracefully rather than 500-ing).
+    """
+    sup = getattr(server, "device_supervisor", None)
+    if sup is None:
+        from gently.app.device_supervisor import DeviceLayerSupervisor
+
+        sup = DeviceLayerSupervisor()
+        server.device_supervisor = sup
+    return sup
+
+
+def _hardware_active(server) -> bool:
+    """Best-effort: is an acquisition / timelapse currently running?
+
+    Used by the stop guard. Conservative — only reports active when we can see a
+    clearly-running timelapse; unknown state reads as inactive so a stuck flag
+    can't wedge the Stop button.
+    """
+    tracker = getattr(server, "timelapse_tracker", None)
+    status = getattr(tracker, "status", None)
+    return str(status).lower() in ("running", "acquiring", "active")
+
+
+def create_router(server) -> APIRouter:
+    router = APIRouter()
+
+    # ── Launch gate ──────────────────────────────────────────────────────
+
+    @router.get("/launch", response_class=HTMLResponse)
+    async def launch_gate(request: Request):
+        """The bare two-question launch screen (prefilled from last choice)."""
+        return server.templates.TemplateResponse(request, "launch.html", {})
+
+    @router.get("/api/launch/prefs")
+    async def get_launch_prefs():
+        """Persisted launch choices (hardware/agent toggles + advanced defaults)."""
+        return load_prefs()
+
+    @router.post("/api/launch/prefs")
+    async def set_launch_prefs(request: Request, _=Depends(require_control)):
+        """Persist launch choices; returns the merged result."""
+        body = await request.json()
+        return save_prefs(body if isinstance(body, dict) else {})
+
+    # ── Devices panel: device-layer supervision ──────────────────────────
+
+    @router.get("/api/device-layer/status")
+    async def device_layer_status():
+        """Live status: running / stopped / external / crashed (+ short log tail)."""
+        return get_supervisor(server).status()
+
+    @router.get("/api/device-layer/log")
+    async def device_layer_log(limit: int = 200):
+        """Recent captured console output (oldest → newest) for the console view."""
+        return {"lines": get_supervisor(server).log_tail(limit)}
+
+    @router.post("/api/device-layer/start")
+    async def device_layer_start(request: Request, _=Depends(require_control)):
+        """Spawn (or adopt-if-external) the device layer per the request body.
+
+        Body (all optional): ``{"sam_device": "cuda"|"cpu", "config_path": "..."}``.
+        """
+        body = await _safe_json(request)
+        sup = get_supervisor(server)
+        try:
+            status = sup.start(
+                sam_device=body.get("sam_device"),
+                config_path=body.get("config_path"),
+            )
+        except (FileNotFoundError, OSError) as e:
+            logger.error("device layer start failed: %s", e)
+            return JSONResponse({"error": str(e)}, status_code=500)
+        return status
+
+    @router.post("/api/device-layer/stop")
+    async def device_layer_stop(request: Request, _=Depends(require_control)):
+        """Stop the managed device layer, with a mid-run confirmation guard.
+
+        If hardware looks active and the body doesn't carry ``{"confirm": true}``,
+        returns 409 ``{"blocked": true, ...}`` instead of stopping (same shape the
+        thermalizer stop-guard uses). ``{"force": true}`` skips the grace period.
+        """
+        body = await _safe_json(request)
+        sup = get_supervisor(server)
+
+        if _hardware_active(server) and not body.get("confirm"):
+            return JSONResponse(
+                {
+                    "blocked": True,
+                    "reason": "hardware is active — an acquisition is running",
+                    "hint": "resend with {\"confirm\": true} to stop anyway",
+                },
+                status_code=409,
+            )
+
+        return sup.stop(force=bool(body.get("force")))
+
+    return router
+
+
+async def _safe_json(request: Request) -> dict:
+    """Parse a JSON body, tolerating an empty/absent one (returns {})."""
+    try:
+        body = await request.json()
+    except (ValueError, TypeError):
+        return {}
+    return body if isinstance(body, dict) else {}
diff --git a/gently/ui/web/templates/launch.html b/gently/ui/web/templates/launch.html
new file mode 100644
index 00000000..89027014
--- /dev/null
+++ b/gently/ui/web/templates/launch.html
@@ -0,0 +1,196 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Launch Gently</title>
+<!--
+  Launch gate — the bare two-question start screen (RFC #78).
+  Styling lifted from docs/superpowers/mockups/2026-07-02-launcher-gate.html and
+  wired to /api/launch/prefs + /api/device-layer/start.
+
+  SCAFFOLD NOTE: this gate persists the choices and (if hardware is on) starts the
+  device layer, then hands off to the dashboard. The full "defer boot-level init
+  until Let's go" refactor — so the *agent* toggle actually gates agent startup —
+  is phase 2 in the RFC and is not wired here yet; the agent toggle is persisted
+  but currently advisory.
+-->
+<style>
+  :root{
+    --bg:#0a0d13; --inset:#0d121b; --line:#1b222e; --line2:#27303d;
+    --text:#e7edf4; --muted:#8792a3; --faint:#57616f;
+    --accent:#5b8cff; --accent-txt:#a9c4ff; --accentdim:rgba(91,140,255,.12);
+    --green:#40d17f; --red:#ff6b6b; --mono:ui-monospace,"SF Mono",Menlo,Consolas,monospace;
+  }
+  *{box-sizing:border-box}
+  html,body{margin:0}
+  body{min-height:100vh;color:var(--text);
+    font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Inter,system-ui,sans-serif;-webkit-font-smoothing:antialiased;
+    background:radial-gradient(1000px 500px at 50% -14%, rgba(91,140,255,.11), transparent 60%), var(--bg);
+    display:flex;justify-content:center;align-items:center;padding:40px 20px}
+  .wrap{width:100%;max-width:460px}
+  .head{display:flex;align-items:center;justify-content:center;gap:11px;margin-bottom:8px}
+  .mark{width:26px;height:26px;border-radius:50%;border:2px solid var(--accent);position:relative;
+    background:radial-gradient(circle at 50% 50%, rgba(91,140,255,.28), transparent 70%)}
+  .mark::after{content:"";position:absolute;inset:0;margin:auto;width:9px;height:9px;border-radius:50%;
+    background:var(--accent);box-shadow:0 0 12px var(--accent)}
+  .wordmark{font-size:22px;font-weight:700;letter-spacing:-.015em}
+  .cap{text-align:center;color:var(--muted);font-size:14px;margin:0 0 30px}
+  .opt{display:flex;align-items:center;gap:15px;padding:18px 18px;border:1px solid var(--line2);border-radius:13px;
+    background:linear-gradient(180deg,#111621,#0e131c);margin-bottom:13px;transition:.15s;cursor:pointer}
+  .opt.on{border-color:rgba(91,140,255,.55);background:linear-gradient(180deg,rgba(91,140,255,.09),#0e131c);
+    box-shadow:0 0 0 1px rgba(91,140,255,.25), 0 14px 34px -18px rgba(91,140,255,.5)}
+  .ic{width:42px;height:42px;border-radius:11px;flex:none;display:flex;align-items:center;justify-content:center;
+    background:var(--inset);border:1px solid var(--line2);color:var(--muted)}
+  .opt.on .ic{background:var(--accentdim);border-color:rgba(91,140,255,.4);color:var(--accent-txt)}
+  .txt{flex:1;min-width:0}
+  .t{font-size:15.5px;font-weight:650;letter-spacing:-.01em}
+  .s{font-size:12.5px;color:var(--muted);margin-top:3px;line-height:1.45}
+  .s .mono{font-family:var(--mono);color:var(--faint)}
+  .sw{width:44px;height:25px;border-radius:999px;background:#232c39;position:relative;flex:none;transition:.15s;border:1px solid var(--line2)}
+  .sw::after{content:"";position:absolute;top:2px;left:2px;width:19px;height:19px;border-radius:50%;background:#5c6675;transition:.15s}
+  .opt.on .sw{background:var(--accent);border-color:transparent;box-shadow:0 0 16px rgba(91,140,255,.4)}
+  .opt.on .sw::after{left:21px;background:#fff}
+  .btn{width:100%;margin-top:9px;background:linear-gradient(180deg,#5b8cff,#4271ec);color:#fff;border:0;border-radius:12px;
+    padding:16px;font-size:16px;font-weight:700;cursor:pointer;box-shadow:0 14px 34px -12px rgba(91,140,255,.7);
+    display:flex;align-items:center;justify-content:center;gap:9px}
+  .btn[disabled]{opacity:.6;cursor:default}
+  .btn .go{font-size:17px}
+  .adv{border:0;background:none;color:var(--muted);font-size:12px;cursor:pointer;padding:0}
+  .adv:hover{color:var(--text)}
+  .advbox{display:none;margin-top:14px;padding:14px;border:1px solid var(--line);border-radius:11px;background:var(--inset)}
+  .advbox.open{display:block}
+  .field{display:flex;align-items:center;justify-content:space-between;gap:10px;margin:8px 0}
+  .field label{font-size:12.5px;color:var(--muted)}
+  .field input,.field select{background:#0a0e15;color:var(--text);border:1px solid var(--line2);border-radius:8px;
+    padding:7px 9px;font-size:13px;font-family:var(--mono);min-width:120px}
+  .foot{text-align:center;margin-top:16px;color:var(--faint);font-size:12px}
+  .status{text-align:center;margin-top:14px;font-size:12.5px;min-height:18px;color:var(--muted)}
+  .status.err{color:var(--red)}
+  .status.ok{color:var(--green)}
+</style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="head"><span class="mark"></span><span class="wordmark">Gently</span></div>
+    <p class="cap">What do you need today?</p>
+
+    <div class="opt" id="opt-hardware" data-key="hardware">
+      <div class="ic">
+        <svg width="21" height="21" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="9" r="4"/><path d="M12 13v6M8 21h8M6 9a6 6 0 0 1 8-5.6"/></svg>
+      </div>
+      <div class="txt">
+        <div class="t">Microscope hardware</div>
+        <div class="s">Start the device layer &amp; connect to the rig <span class="mono" id="port-label">· :60610</span></div>
+      </div>
+      <span class="sw"></span>
+    </div>
+
+    <div class="opt" id="opt-agent" data-key="agent">
+      <div class="ic">
+        <svg width="21" height="21" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3l2.2 5.8L20 11l-5.8 2.2L12 19l-2.2-5.8L4 11l5.8-2.2z"/></svg>
+      </div>
+      <div class="txt">
+        <div class="t">AI agent</div>
+        <div class="s">Chat, perception &amp; planning — uses your API key</div>
+      </div>
+      <span class="sw"></span>
+    </div>
+
+    <button class="btn" id="go">Let's go <span class="go">&rarr;</span></button>
+    <div class="status" id="status"></div>
+
+    <div class="foot">
+      <button class="adv" id="adv-toggle">Advanced options</button> &middot; remembers your choice
+    </div>
+    <div class="advbox" id="advbox">
+      <div class="field">
+        <label for="f-port">Device port</label>
+        <input id="f-port" type="number" min="1" max="65535">
+      </div>
+      <div class="field">
+        <label for="f-sam">SAM device</label>
+        <select id="f-sam"><option value="cuda">cuda</option><option value="cpu">cpu</option></select>
+      </div>
+    </div>
+  </div>
+
+<script>
+const state = { hardware: true, agent: true, port: 60610, sam_device: "cuda" };
+
+function paint() {
+  document.getElementById("opt-hardware").classList.toggle("on", state.hardware);
+  document.getElementById("opt-agent").classList.toggle("on", state.agent);
+  document.getElementById("port-label").textContent = "· :" + state.port;
+  document.getElementById("f-port").value = state.port;
+  document.getElementById("f-sam").value = state.sam_device;
+}
+
+async function loadPrefs() {
+  try {
+    const r = await fetch("/api/launch/prefs");
+    if (r.ok) Object.assign(state, await r.json());
+  } catch (e) { /* keep defaults */ }
+  paint();
+}
+
+for (const id of ["opt-hardware", "opt-agent"]) {
+  document.getElementById(id).addEventListener("click", (e) => {
+    const key = e.currentTarget.dataset.key;
+    state[key] = !state[key];
+    paint();
+  });
+}
+document.getElementById("f-port").addEventListener("change", (e) => {
+  state.port = parseInt(e.target.value, 10) || state.port; paint();
+});
+document.getElementById("f-sam").addEventListener("change", (e) => {
+  state.sam_device = e.target.value;
+});
+document.getElementById("adv-toggle").addEventListener("click", () => {
+  document.getElementById("advbox").classList.toggle("open");
+});
+
+function setStatus(msg, kind) {
+  const el = document.getElementById("status");
+  el.textContent = msg || "";
+  el.className = "status" + (kind ? " " + kind : "");
+}
+
+document.getElementById("go").addEventListener("click", async () => {
+  const btn = document.getElementById("go");
+  btn.disabled = true;
+  try {
+    setStatus("Saving your choice…");
+    await fetch("/api/launch/prefs", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(state),
+    });
+
+    if (state.hardware) {
+      setStatus("Starting the device layer…");
+      const r = await fetch("/api/device-layer/start", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ sam_device: state.sam_device }),
+      });
+      if (!r.ok) {
+        const body = await r.json().catch(() => ({}));
+        setStatus("Device layer didn't start: " + (body.error || r.status), "err");
+        btn.disabled = false;
+        return;
+      }
+    }
+    setStatus("Opening the dashboard…", "ok");
+    window.location.href = "/";
+  } catch (e) {
+    setStatus("Something went wrong: " + e, "err");
+    btn.disabled = false;
+  }
+});
+
+loadPrefs();
+</script>
+</body>
+</html>
diff --git a/launch_gently.py b/launch_gently.py
index 6afcbe86..7ba28534 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -552,6 +552,18 @@ def _status_provider():
     if agent.viz_server is not None:
         agent.viz_server.agent_bridge = bridge
         agent.viz_server.set_context_store(context_store)
+        # Device-layer supervisor (managed child subprocess) — lets the launch
+        # gate and the Devices panel start/stop start_device_layer.py from the
+        # UI, and kills it on exit so it never orphans. It auto-detects an
+        # already-running (external) device layer and leaves it alone. RFC #78.
+        try:
+            from gently.app.device_supervisor import DeviceLayerSupervisor
+
+            agent.viz_server.device_supervisor = DeviceLayerSupervisor(
+                port=settings.network.device_port,
+            )
+        except Exception:
+            logger.debug("DeviceLayerSupervisor init skipped", exc_info=True)
         # If launched into an existing session, rehydrate its persisted
         # imagery so the galleries/filmstrips show data from the start.
         if session_to_resume:

From cdd0eb3592ff41ddea8e921ef635b917a8fb8563 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 02:59:31 -0400
Subject: [PATCH 305/314] feat(devices+desktop): device-layer supervision panel
 + Tauri desktop shell (RFC #78)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two fold-ins on the unified-launcher RFC.

Devices supervision panel (web UI):
- gently/ui/web/static/js/device-layer.js — self-contained DeviceLayerCard IIFE
  in the Devices tab: polls /api/device-layer/status while the tab is visible,
  renders running/stopped/external/crashed as a status pill, Start/Stop (with the
  409 mid-run force-confirm and transparent 403 view-only handling), and a
  collapsible live log tail. Wired into index.html + main.css using existing
  devices-* / marking-* / theme-token conventions.
- Verified end-to-end in a browser: stopped -> Start -> running (pid/port/uptime,
  live log) -> Stop -> stopped, server-confirmed, no console errors.

Tauri desktop shell (desktop/):
- A thin WebView2 window that OWNS the Python backend: spawns
  launch_gently.py --no-browser, shows a splash, then navigates to the live UI.
- Reliable teardown: the spawned Python (and its device-layer grandchild) go in a
  Windows Job Object with KILL_ON_JOB_CLOSE, so quitting/crashing the shell reaps
  the whole tree — proven by force-killing only the shell and observing python +
  device layer die and both ports free.
- Built clean against tauri 2.11.5; UI verified rendering inside the native window
  (incl. the new Devices panel) via WebView2 CDP.
- README documents dev-run, build, env config, and the remaining Python-bundling
  work for a redistributable installer.

Supervisor:
- device_supervisor.py honours GENTLY_DEVICE_LAYER_SCRIPT to point at an alternate
  device-layer entry point (also lets tests use a harmless stand-in).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 desktop/.gitignore                          |   14 +
 desktop/README.md                           |   94 +
 desktop/icons/source.png                    |  Bin 0 -> 5157 bytes
 desktop/package-lock.json                   |  232 +
 desktop/package.json                        |   12 +
 desktop/splash/index.html                   |   51 +
 desktop/src-tauri/Cargo.lock                | 4433 +++++++++++++++++++
 desktop/src-tauri/Cargo.toml                |   29 +
 desktop/src-tauri/build.rs                  |    3 +
 desktop/src-tauri/capabilities/default.json |    7 +
 desktop/src-tauri/icons/128x128.png         |  Bin 0 -> 8161 bytes
 desktop/src-tauri/icons/128x128@2x.png      |  Bin 0 -> 15932 bytes
 desktop/src-tauri/icons/32x32.png           |  Bin 0 -> 1623 bytes
 desktop/src-tauri/icons/64x64.png           |  Bin 0 -> 3830 bytes
 desktop/src-tauri/icons/icon.icns           |  Bin 0 -> 128538 bytes
 desktop/src-tauri/icons/icon.ico            |  Bin 0 -> 27566 bytes
 desktop/src-tauri/icons/icon.png            |  Bin 0 -> 3887 bytes
 desktop/src-tauri/src/main.rs               |  228 +
 desktop/src-tauri/tauri.conf.json           |   38 +
 gently/app/device_supervisor.py             |   11 +-
 gently/ui/web/static/css/main.css           |   48 +
 gently/ui/web/static/js/device-layer.js     |  242 +
 gently/ui/web/templates/index.html          |   21 +
 23 files changed, 5460 insertions(+), 3 deletions(-)
 create mode 100644 desktop/.gitignore
 create mode 100644 desktop/README.md
 create mode 100644 desktop/icons/source.png
 create mode 100644 desktop/package-lock.json
 create mode 100644 desktop/package.json
 create mode 100644 desktop/splash/index.html
 create mode 100644 desktop/src-tauri/Cargo.lock
 create mode 100644 desktop/src-tauri/Cargo.toml
 create mode 100644 desktop/src-tauri/build.rs
 create mode 100644 desktop/src-tauri/capabilities/default.json
 create mode 100644 desktop/src-tauri/icons/128x128.png
 create mode 100644 desktop/src-tauri/icons/128x128@2x.png
 create mode 100644 desktop/src-tauri/icons/32x32.png
 create mode 100644 desktop/src-tauri/icons/64x64.png
 create mode 100644 desktop/src-tauri/icons/icon.icns
 create mode 100644 desktop/src-tauri/icons/icon.ico
 create mode 100644 desktop/src-tauri/icons/icon.png
 create mode 100644 desktop/src-tauri/src/main.rs
 create mode 100644 desktop/src-tauri/tauri.conf.json
 create mode 100644 gently/ui/web/static/js/device-layer.js

diff --git a/desktop/.gitignore b/desktop/.gitignore
new file mode 100644
index 00000000..6b3daa59
--- /dev/null
+++ b/desktop/.gitignore
@@ -0,0 +1,14 @@
+# Node / Tauri CLI
+node_modules/
+
+# Rust / Tauri build output
+src-tauri/target/
+src-tauri/gen/
+
+# Generated mobile / MS-Store icon variants (regenerate with `tauri icon`).
+# The desktop icons referenced by tauri.conf.json (32x32, 128x128, 128x128@2x,
+# icon.ico, icon.icns, icon.png) ARE committed so a clean checkout builds.
+src-tauri/icons/android/
+src-tauri/icons/ios/
+src-tauri/icons/Square*Logo.png
+src-tauri/icons/StoreLogo.png
diff --git a/desktop/README.md b/desktop/README.md
new file mode 100644
index 00000000..f9ad9943
--- /dev/null
+++ b/desktop/README.md
@@ -0,0 +1,94 @@
+# Gently Desktop (Tauri shell)
+
+A thin [Tauri](https://v2.tauri.app) desktop wrapper that turns gently into a
+double-click Windows app. It **owns** the Python backend: on launch it spawns
+`launch_gently.py --no-browser`, shows a splash while the server boots, then
+renders the existing web UI in a native WebView2 window. No application logic
+lives here — the web UI served by Python stays the single source of truth.
+
+This is the desktop-packaging fold-in described in RFC #78
+(`docs/superpowers/specs/2026-07-02-unified-launcher-design.md`).
+
+## Why Tauri (and what it does / doesn't solve)
+
+- **Tiny footprint** — uses the OS WebView2 (already present on Win 11), not a
+  bundled Chromium.
+- **Robust process ownership** — the shell puts the spawned Python into a
+  Windows **Job Object** with `KILL_ON_JOB_CLOSE`. Python's own device-layer
+  grandchild (via `DeviceLayerSupervisor`) inherits the job, so when the app
+  quits *or crashes* the OS reaps the **entire** process tree — no orphaned
+  device layer holding COM ports.
+- **Not solved here:** bundling the Python environment (torch, anthropic,
+  perception) into a redistributable installer. This build launches the repo's
+  existing `.venv`. Shipping a self-contained `.msi`/`.exe` to another machine
+  needs an embeddable-Python / PyInstaller sidecar — see *Bundling* below.
+
+## Architecture
+
+```
+Tauri shell (Rust, WebView2 window)
+  └─ spawns:  python launch_gently.py --no-browser      [in a kill-on-close Job]
+                └─ spawns:  start_device_layer.py        (DeviceLayerSupervisor)
+  ├─ shows splash/index.html while uvicorn boots
+  └─ navigate() → http://localhost:8080  (the live gently UI)
+```
+
+- `src-tauri/src/main.rs` — spawn + Job Object teardown + wait-for-server + navigate.
+- `splash/index.html` — boot splash (Rust updates its status line via `window.__gentlyStatus`).
+- `src-tauri/tauri.conf.json` — one window, `frontendDist: ../splash`, NSIS bundle.
+
+## Prerequisites
+
+- **Rust** (MSVC toolchain) — `rustup default stable-x86_64-pc-windows-msvc`
+- **MSVC C++ build tools** (Visual Studio 2022 / Build Tools)
+- **WebView2 runtime** (inbox on Windows 11)
+- **Node** (only for the Tauri CLI: `npm install` in this folder)
+- A working gently checkout with its Python **`.venv`** at the repo root
+
+## Run (dev)
+
+```bash
+cd desktop
+npm install                      # once — installs @tauri-apps/cli
+# UI-only smoke test (no hardware, no API key, no login):
+GENTLY_LAUNCH_ARGS="--no-api --offline --no-auth" npx tauri dev
+# Full app (needs ANTHROPIC_API_KEY in the environment / repo .env):
+npx tauri dev
+```
+
+`tauri dev` builds and launches the shell; it spawns the backend for you.
+
+## Build (installer)
+
+```bash
+cd desktop
+npx tauri build                  # produces an NSIS installer under src-tauri/target/release/bundle/
+```
+
+The built app launches the **repo's** `.venv` + `launch_gently.py` (paths baked
+at compile time / overridable — see env vars). It is a single-machine build
+until Python bundling lands.
+
+## Configuration (env vars read by the shell)
+
+| Var | Default | Purpose |
+|---|---|---|
+| `GENTLY_HOME` | compile-time repo root | Directory to run the backend from |
+| `GENTLY_PYTHON` | `<repo>/.venv/Scripts/python.exe` | Python interpreter to launch |
+| `GENTLY_LAUNCH_ARGS` | *(none)* | Extra args appended to `launch_gently.py --no-browser` |
+| `VIZ_PORT` | `8080` | Port the shell waits on and navigates to |
+| `GENTLY_DEVICE_LAYER_SCRIPT` | `start_device_layer.py` | Alternate device-layer entry point (read by `DeviceLayerSupervisor`) |
+
+## Bundling Python (the remaining long pole)
+
+`tauri build` today does **not** package Python. To make a redistributable app:
+
+1. Produce a self-contained backend (PyInstaller one-folder of `launch_gently`,
+   or an embeddable-Python tree with the deps installed).
+2. Ship it as a Tauri **sidecar** (or under the app's resource dir) and point
+   `GENTLY_PYTHON` / `GENTLY_HOME` at it.
+3. Expect a multi-GB artifact (torch/CUDA dominate) and plan auto-update
+   accordingly.
+
+The Job-Object ownership and boot/navigate flow are unchanged by bundling — only
+*where Python comes from* changes.
diff --git a/desktop/icons/source.png b/desktop/icons/source.png
new file mode 100644
index 0000000000000000000000000000000000000000..8f2af46c523ca4713ffa2ced8024e669a161af1e
GIT binary patch
literal 5157
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
TJP|`4OTz4J9Jdr%v10xQA=6)$

literal 0
HcmV?d00001

diff --git a/desktop/package-lock.json b/desktop/package-lock.json
new file mode 100644
index 00000000..63621f9e
--- /dev/null
+++ b/desktop/package-lock.json
@@ -0,0 +1,232 @@
+{
+  "name": "gently-desktop",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "gently-desktop",
+      "version": "0.1.0",
+      "devDependencies": {
+        "@tauri-apps/cli": "^2.11.4"
+      }
+    },
+    "node_modules/@tauri-apps/cli": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli/-/cli-2.11.4.tgz",
+      "integrity": "sha512-R8xGtMpwyetawSqm9kYOuMmEqkhUbvcUy8n0aNXIxollKBLESUu5f4Fx+64hgASYm1H+jSWq6jCW6zqTnH6hqQ==",
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "bin": {
+        "tauri": "tauri.js"
+      },
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/tauri"
+      },
+      "optionalDependencies": {
+        "@tauri-apps/cli-darwin-arm64": "2.11.4",
+        "@tauri-apps/cli-darwin-x64": "2.11.4",
+        "@tauri-apps/cli-linux-arm-gnueabihf": "2.11.4",
+        "@tauri-apps/cli-linux-arm64-gnu": "2.11.4",
+        "@tauri-apps/cli-linux-arm64-musl": "2.11.4",
+        "@tauri-apps/cli-linux-riscv64-gnu": "2.11.4",
+        "@tauri-apps/cli-linux-x64-gnu": "2.11.4",
+        "@tauri-apps/cli-linux-x64-musl": "2.11.4",
+        "@tauri-apps/cli-win32-arm64-msvc": "2.11.4",
+        "@tauri-apps/cli-win32-ia32-msvc": "2.11.4",
+        "@tauri-apps/cli-win32-x64-msvc": "2.11.4"
+      }
+    },
+    "node_modules/@tauri-apps/cli-darwin-arm64": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-darwin-arm64/-/cli-darwin-arm64-2.11.4.tgz",
+      "integrity": "sha512-1ryOF3ZhpZ/nemHV5zVwBQBz9jDGKmKPvWPADOhc83ig0P4bMc2iER4NbC6r9sjeIZ6RVQ4g3RZIYvezhcl4TQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-darwin-x64": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-darwin-x64/-/cli-darwin-x64-2.11.4.tgz",
+      "integrity": "sha512-uFsGQAAfuyz1k/yGLmkWfkBlgKAqZfxqlHmLWx81QU27RJWfmbNHCIq8T8w1e+VClleIuZUjpHWfoE4E3DLo3A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-arm-gnueabihf": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-arm-gnueabihf/-/cli-linux-arm-gnueabihf-2.11.4.tgz",
+      "integrity": "sha512-IaHZn5CdBL21oUmjiVOS1ctw6Ip1O0pjp70FwOWmYz1myWe0SY96ZIj2FYf7pT0m8bI2h/hrs5ZbEXXh44/MkQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-arm64-gnu": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-arm64-gnu/-/cli-linux-arm64-gnu-2.11.4.tgz",
+      "integrity": "sha512-N41/ukTRVe6XSuUTESuFdGeOW2i7k62tK+6gHK5Kd5/q5RPvvi19GaWAVPPb9u95HSGmTChSolBfzynUsssFaA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-arm64-musl": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-arm64-musl/-/cli-linux-arm64-musl-2.11.4.tgz",
+      "integrity": "sha512-v277UnT/fB64xAfSroL5N3Km3tLmvATWqJJw/wRI+g6o+HkeD0slyE7gOhNs1MbjE41R7bQOTxMVoL3aomUJmw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-riscv64-gnu": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-riscv64-gnu/-/cli-linux-riscv64-gnu-2.11.4.tgz",
+      "integrity": "sha512-qqgNkQ2u1yZHxjhxsZaxUtRDW8dIqIYm33rx/mzwQv0SfY9x1B+iraj8vWeFiXjjSVVhEMepXSOts1TqPzvXNQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-x64-gnu": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-x64-gnu/-/cli-linux-x64-gnu-2.11.4.tgz",
+      "integrity": "sha512-2VRNWl84FOH0m2giiDkO2h0QXlcMJeX+zJDpI5kDIQAx6s+geF3v48F4DXfJez4GS/FdoDGnPnw1C2iYGbQ7bQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-x64-musl": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-x64-musl/-/cli-linux-x64-musl-2.11.4.tgz",
+      "integrity": "sha512-o9GyhYor/nc7xarmwDE3ka2szuW3uuZzXjHWh64Q8YX5AtSgxdQkFWzrY4O8KiGtVNvFBI14H3Q49Qj5TOIP/A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-win32-arm64-msvc": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-win32-arm64-msvc/-/cli-win32-arm64-msvc-2.11.4.tgz",
+      "integrity": "sha512-ld5Ehb598m0VkYyylRPNeCFsBe/km0jxis6KgMpl3IGY6I/i1RwQXO05I1AsXUXO2WC6AvB/Lw4qTf/asiuEiQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-win32-ia32-msvc": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-win32-ia32-msvc/-/cli-win32-ia32-msvc-2.11.4.tgz",
+      "integrity": "sha512-12Hxi0XX/H5VFxO/bGgHkFWhml9VMgEOu9CidjeCeTNQ1l6fpUlbiGgSP7CLI3PFtW9/FfbeHieZ+kyWK5H7CA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-win32-x64-msvc": {
+      "version": "2.11.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-win32-x64-msvc/-/cli-win32-x64-msvc-2.11.4.tgz",
+      "integrity": "sha512-+vDiqBIU5dMISg/wNvX3sF+ZHfgJGJ5T0AcO+EHNXV9GGAG+P5fzodlDXD3QdKCRgZxMoCm5PPvj3BqLNjBthw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    }
+  }
+}
diff --git a/desktop/package.json b/desktop/package.json
new file mode 100644
index 00000000..7c30a7fe
--- /dev/null
+++ b/desktop/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "gently-desktop",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Tauri desktop shell for gently (owns the Python backend + device layer)",
+  "scripts": {
+    "tauri": "tauri"
+  },
+  "devDependencies": {
+    "@tauri-apps/cli": "^2.11.4"
+  }
+}
diff --git a/desktop/splash/index.html b/desktop/splash/index.html
new file mode 100644
index 00000000..f7bb3357
--- /dev/null
+++ b/desktop/splash/index.html
@@ -0,0 +1,51 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Gently</title>
+<!--
+  Boot splash for the Tauri desktop shell. Purely visual: it is shown while the
+  Rust shell spawns the Python backend and waits for the viz server to answer.
+  Once the server is reachable, the Rust side navigates this window to the live
+  UI (http://localhost:8080). The status line is updated from Rust via an
+  injected `window.__gentlyStatus(text)` call, with a CSS fallback message.
+-->
+<style>
+  :root{
+    --bg:#0a0d13; --text:#e7edf4; --muted:#8792a3; --accent:#5b8cff;
+  }
+  *{box-sizing:border-box}
+  html,body{margin:0;height:100%}
+  body{height:100%;color:var(--text);
+    font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Inter,system-ui,sans-serif;
+    -webkit-font-smoothing:antialiased;user-select:none;cursor:default;
+    background:radial-gradient(900px 480px at 50% -12%, rgba(91,140,255,.13), transparent 60%), var(--bg);
+    display:flex;flex-direction:column;justify-content:center;align-items:center;gap:22px}
+  .mark{width:64px;height:64px;border-radius:50%;border:3px solid var(--accent);position:relative;
+    background:radial-gradient(circle at 50% 50%, rgba(91,140,255,.28), transparent 70%)}
+  .mark::after{content:"";position:absolute;inset:0;margin:auto;width:20px;height:20px;border-radius:50%;
+    background:var(--accent);box-shadow:0 0 20px var(--accent)}
+  .wordmark{font-size:26px;font-weight:700;letter-spacing:-.02em}
+  .spin{width:26px;height:26px;border-radius:50%;border:2.5px solid rgba(135,146,163,.25);
+    border-top-color:var(--accent);animation:spin .8s linear infinite}
+  @keyframes spin{to{transform:rotate(360deg)}}
+  .status{color:var(--muted);font-size:13.5px;min-height:18px;letter-spacing:.01em}
+  .foot{position:fixed;bottom:20px;color:#57616f;font-size:11.5px}
+</style>
+</head>
+<body>
+  <div class="mark"></div>
+  <div class="wordmark">Gently</div>
+  <div class="spin"></div>
+  <div class="status" id="status">Starting the backend…</div>
+  <div class="foot">microscopy agent · desktop</div>
+<script>
+  // Rust calls window.__gentlyStatus("…") to reflect boot progress.
+  window.__gentlyStatus = function (text) {
+    var el = document.getElementById("status");
+    if (el && typeof text === "string") el.textContent = text;
+  };
+</script>
+</body>
+</html>
diff --git a/desktop/src-tauri/Cargo.lock b/desktop/src-tauri/Cargo.lock
new file mode 100644
index 00000000..27a8fbb4
--- /dev/null
+++ b/desktop/src-tauri/Cargo.lock
@@ -0,0 +1,4433 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "adler2"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "alloc-no-stdlib"
+version = "2.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cc7bb162ec39d46ab1ca8c77bf72e890535becd1751bb45f64c597edb4c8c6b3"
+
+[[package]]
+name = "alloc-stdlib"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0e76a019e91224d279006ff972f1e984179a6e9feb050adba6ce8274aef23195"
+dependencies = [
+ "alloc-no-stdlib",
+]
+
+[[package]]
+name = "android_system_properties"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "anyhow"
+version = "1.0.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a4385e2e34eb35d6b3efe798b9eb88096925d87726c0798709bf56d9ed84af3"
+
+[[package]]
+name = "atk"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "241b621213072e993be4f6f3a9e4b45f65b7e6faad43001be957184b7bb1824b"
+dependencies = [
+ "atk-sys",
+ "glib",
+ "libc",
+]
+
+[[package]]
+name = "atk-sys"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5e48b684b0ca77d2bbadeef17424c2ea3c897d44d566a1617e7e8f30614d086"
+dependencies = [
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "atomic-waker"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "base64"
+version = "0.21.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
+
+[[package]]
+name = "base64"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
+
+[[package]]
+name = "bit-set"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08807e080ed7f9d5433fa9b275196cfc35414f66a0c79d864dc51a0d825231a3"
+dependencies = [
+ "bit-vec",
+]
+
+[[package]]
+name = "bit-vec"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e764a1d40d510daf35e07be9eb06e75770908c27d411ee6c92109c9840eaaf7"
+
+[[package]]
+name = "bitflags"
+version = "1.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
+
+[[package]]
+name = "bitflags"
+version = "2.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4388bee8683e3d04af747c73422af53102d2bd24d9eadb6cbc100baef4b43f8"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "block2"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cdeb9d870516001442e364c5220d3574d2da8dc765554b4a617230d33fa58ef5"
+dependencies = [
+ "objc2",
+]
+
+[[package]]
+name = "brotli"
+version = "8.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5cc91aac060a7a1e25823bdccbfb6af1875b88f17c6daac97894eed8207166b3"
+dependencies = [
+ "alloc-no-stdlib",
+ "alloc-stdlib",
+ "brotli-decompressor",
+]
+
+[[package]]
+name = "brotli-decompressor"
+version = "5.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3a32acac15fe1967bc3986b2a6347dffc965602354ea6f450ad07e8bfd253583"
+dependencies = [
+ "alloc-no-stdlib",
+ "alloc-stdlib",
+]
+
+[[package]]
+name = "bs58"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bf88ba1141d185c399bee5288d850d63b8369520c1eafc32a0430b5b6c287bf4"
+dependencies = [
+ "tinyvec",
+]
+
+[[package]]
+name = "bumpalo"
+version = "3.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
+
+[[package]]
+name = "bytemuck"
+version = "1.25.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6aedf8ae72766347502cf3cb4f41cf5e9cc37d28bee90f1fdaaae15f9cf9424"
+
+[[package]]
+name = "byteorder"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
+
+[[package]]
+name = "bytes"
+version = "1.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc652a48c352aef3ea3aed32080501cf3ef6ed5da78602a020c991775b0aff04"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "cairo-rs"
+version = "0.18.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ca26ef0159422fb77631dc9d17b102f253b876fe1586b03b803e63a309b4ee2"
+dependencies = [
+ "bitflags 2.13.0",
+ "cairo-sys-rs",
+ "glib",
+ "libc",
+ "once_cell",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "cairo-sys-rs"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "685c9fa8e590b8b3d678873528d83411db17242a73fccaed827770ea0fedda51"
+dependencies = [
+ "glib-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "camino"
+version = "1.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5f2d30e4173c4026932d51d31d6b0613b1fd3014bf3f9f8943d4ba139c437ba0"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "cargo-platform"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e35af189006b9c0f00a064685c727031e3ed2d8020f7ba284d78cc2671bd36ea"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "cargo_metadata"
+version = "0.19.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dd5eb614ed4c27c5d706420e4320fbe3216ab31fa1c33cd8246ac36dae4479ba"
+dependencies = [
+ "camino",
+ "cargo-platform",
+ "semver",
+ "serde",
+ "serde_json",
+ "thiserror 2.0.18",
+]
+
+[[package]]
+name = "cargo_toml"
+version = "0.22.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "374b7c592d9c00c1f4972ea58390ac6b18cbb6ab79011f3bdc90a0b82ca06b77"
+dependencies = [
+ "serde",
+ "toml 0.9.12+spec-1.1.0",
+]
+
+[[package]]
+name = "cc"
+version = "1.2.67"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e17dd265a7d0f31ef544e1b20e03add05d3b45b491b633b10d67145d2acc1a38"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "cesu8"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d43a04d8753f35258c91f8ec639f792891f748a1edbd759cf1dcea3382ad83c"
+
+[[package]]
+name = "cfb"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d38f2da7a0a2c4ccf0065be06397cc26a81f4e528be095826eee9d4adbb8c60f"
+dependencies = [
+ "byteorder",
+ "fnv",
+ "uuid",
+]
+
+[[package]]
+name = "cfg-expr"
+version = "0.15.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d067ad48b8650848b989a59a86c6c36a995d02d2bf778d45c3c5d57bc2718f02"
+dependencies = [
+ "smallvec",
+ "target-lexicon",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "chrono"
+version = "0.4.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1aa79e62e7697b8e29b513a68abacf485adcd1fe8284a4316c5ae868e6633327"
+dependencies = [
+ "iana-time-zone",
+ "num-traits",
+ "serde",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "combine"
+version = "4.6.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba5a308b75df32fe02788e748662718f03fde005016435c444eea572398219fd"
+dependencies = [
+ "bytes",
+ "memchr",
+]
+
+[[package]]
+name = "cookie"
+version = "0.18.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ddef33a339a91ea89fb53151bd0a4689cfce27055c291dfa69945475d22c747"
+dependencies = [
+ "time",
+ "version_check",
+]
+
+[[package]]
+name = "core-foundation"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2a6cd9ae233e7f62ba4e9353e81a88df7fc8a5987b8d445b4d90c879bd156f6"
+dependencies = [
+ "core-foundation-sys",
+ "libc",
+]
+
+[[package]]
+name = "core-foundation-sys"
+version = "0.8.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"
+
+[[package]]
+name = "core-graphics"
+version = "0.25.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "064badf302c3194842cf2c5d61f56cc88e54a759313879cdf03abdd27d0c3b97"
+dependencies = [
+ "bitflags 2.13.0",
+ "core-foundation",
+ "core-graphics-types",
+ "foreign-types",
+ "libc",
+]
+
+[[package]]
+name = "core-graphics-types"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d44a101f213f6c4cdc1853d4b78aef6db6bdfa3468798cc1d9912f4735013eb"
+dependencies = [
+ "bitflags 2.13.0",
+ "core-foundation",
+ "libc",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crc32fast"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9481c1c90cbf2ac953f07c8d4a58aa3945c425b7185c9154d67a65e4230da511"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "crossbeam-channel"
+version = "0.5.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d85363c37faeca707aef026efa9f3b34d077bce547e48f770770625c6013679e"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61803da095bee82a81bb1a452ecc25d3b2f1416d1897eb86430c6159ef717c17"
+
+[[package]]
+name = "crypto-common"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "cssparser"
+version = "0.36.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dae61cf9c0abb83bd659dab65b7e4e38d8236824c85f0f804f173567bda257d2"
+dependencies = [
+ "cssparser-macros",
+ "dtoa-short",
+ "itoa",
+ "phf",
+ "smallvec",
+]
+
+[[package]]
+name = "cssparser-macros"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13b588ba4ac1a99f7f2964d24b3d896ddc6bf847ee3855dbd4366f058cfcd331"
+dependencies = [
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "ctor"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "352d39c2f7bef1d6ad73db6f5160efcaed66d94ef8c6c573a8410c00bf909a98"
+dependencies = [
+ "ctor-proc-macro",
+ "dtor",
+]
+
+[[package]]
+name = "ctor-proc-macro"
+version = "0.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52560adf09603e58c9a7ee1fe1dcb95a16927b17c127f0ac02d6e768a0e25bc1"
+
+[[package]]
+name = "darling"
+version = "0.23.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "25ae13da2f202d56bd7f91c25fba009e7717a1e4a1cc98a76d844b65ae912e9d"
+dependencies = [
+ "darling_core",
+ "darling_macro",
+]
+
+[[package]]
+name = "darling_core"
+version = "0.23.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9865a50f7c335f53564bb694ef660825eb8610e0a53d3e11bf1b0d3df31e03b0"
+dependencies = [
+ "ident_case",
+ "proc-macro2",
+ "quote",
+ "strsim",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "darling_macro"
+version = "0.23.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3984ec7bd6cfa798e62b4a642426a5be0e68f9401cfc2a01e3fa9ea2fcdb8d"
+dependencies = [
+ "darling_core",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "dbus"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ab69f03cc8c4340c9c8e315114e1658e6775a9b16a04357973aa21cec22b32e"
+dependencies = [
+ "libc",
+ "libdbus-sys",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "deranged"
+version = "0.5.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7cd812cc2bc1d69d4764bd80df88b4317eaef9e773c75226407d9bc0876b211c"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "derive_more"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d751e9e49156b02b44f9c1815bcb94b984cdcc4396ecc32521c739452808b134"
+dependencies = [
+ "derive_more-impl",
+]
+
+[[package]]
+name = "derive_more-impl"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "799a97264921d8623a957f6c3b9011f3b5492f557bbb7a5a19b7fa6d06ba8dcb"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "rustc_version",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+]
+
+[[package]]
+name = "dirs"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3e8aa94d75141228480295a7d0e7feb620b1a5ad9f12bc40be62411e38cce4e"
+dependencies = [
+ "dirs-sys",
+]
+
+[[package]]
+name = "dirs-sys"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e01a3366d27ee9890022452ee61b2b63a67e6f13f58900b651ff5665f0bb1fab"
+dependencies = [
+ "libc",
+ "option-ext",
+ "redox_users",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "dispatch2"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e0e367e4e7da84520dedcac1901e4da967309406d1e51017ae1abfb97adbd38"
+dependencies = [
+ "bitflags 2.13.0",
+ "block2",
+ "libc",
+ "objc2",
+]
+
+[[package]]
+name = "displaydoc"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ac70aa55017e108007fbaf5aa0f54b021c98f92ff8af59d42eda9da96e3dd4f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "dlopen2"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e2c5bd4158e66d1e215c49b837e11d62f3267b30c92f1d171c4d3105e3dc4d4"
+dependencies = [
+ "dlopen2_derive",
+ "libc",
+ "once_cell",
+ "winapi",
+]
+
+[[package]]
+name = "dlopen2_derive"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fbbb781877580993a8707ec48672673ec7b81eeba04cfd2310bd28c08e47c8f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "dom_query"
+version = "0.27.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "521e380c0c8afb8d9a1e83a1822ee03556fc3e3e7dbc1fd30be14e37f9cb3f89"
+dependencies = [
+ "bit-set",
+ "cssparser",
+ "foldhash",
+ "html5ever",
+ "precomputed-hash",
+ "selectors",
+ "tendril",
+]
+
+[[package]]
+name = "dpi"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d8b14ccef22fc6f5a8f4d7d768562a182c04ce9a3b3157b91390b52ddfdf1a76"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "dtoa"
+version = "1.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c3cf4824e2d5f025c7b531afcb2325364084a16806f6d47fbc1f5fbd9960590"
+
+[[package]]
+name = "dtoa-short"
+version = "0.3.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd1511a7b6a56299bd043a9c167a6d2bfb37bf84a6dfceaba651168adfb43c87"
+dependencies = [
+ "dtoa",
+]
+
+[[package]]
+name = "dtor"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f1057d6c64987086ff8ed0fd3fbf377a6b7d205cc7715868cd401705f715cbe4"
+dependencies = [
+ "dtor-proc-macro",
+]
+
+[[package]]
+name = "dtor-proc-macro"
+version = "0.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f678cf4a922c215c63e0de95eb1ff08a958a81d47e485cf9da1e27bf6305cfa5"
+
+[[package]]
+name = "dunce"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92773504d58c093f6de2459af4af33faa518c13451eb8f2b5698ed3d36e7c813"
+
+[[package]]
+name = "dyn-clone"
+version = "1.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0881ea181b1df73ff77ffaaf9c7544ecc11e82fba9b5f27b262a3c73a332555"
+
+[[package]]
+name = "embed-resource"
+version = "3.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbfdaacccebec3b28e4866b8973543c7647797db5ada1bdab552e48fe665fbbd"
+dependencies = [
+ "cc",
+ "memchr",
+ "rustc_version",
+ "toml 1.1.2+spec-1.1.0",
+ "vswhom",
+ "winreg",
+]
+
+[[package]]
+name = "embed_plist"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ef6b89e5b37196644d8796de5268852ff179b44e96276cf4290264843743bb7"
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "erased-serde"
+version = "0.4.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d2add8a07dd6a8d93ff627029c51de145e12686fbc36ecb298ac22e74cf02dec"
+dependencies = [
+ "serde",
+ "serde_core",
+ "typeid",
+]
+
+[[package]]
+name = "fastrand"
+version = "2.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f1f227452a390804cdb637b74a86990f2a7d7ba4b7d5693aac9b4dd6defd8d6"
+
+[[package]]
+name = "fdeflate"
+version = "0.3.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e6853b52649d4ac5c0bd02320cddc5ba956bdb407c4b75a2c6b75bf51500f8c"
+dependencies = [
+ "simd-adler32",
+]
+
+[[package]]
+name = "field-offset"
+version = "0.3.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38e2275cc4e4fc009b0669731a1e5ab7ebf11f469eaede2bab9309a5b4d6057f"
+dependencies = [
+ "memoffset",
+ "rustc_version",
+]
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+
+[[package]]
+name = "flate2"
+version = "1.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "843fba2746e448b37e26a819579957415c8cef339bf08564fe8b7ddbd959573c"
+dependencies = [
+ "crc32fast",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "fnv"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
+
+[[package]]
+name = "foldhash"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77ce24cb58228fbb8aa041425bb1050850ac19177686ea6e0f41a70416f56fdb"
+
+[[package]]
+name = "foreign-types"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d737d9aa519fb7b749cbc3b962edcf310a8dd1f4b67c91c4f83975dbdd17d965"
+dependencies = [
+ "foreign-types-macros",
+ "foreign-types-shared",
+]
+
+[[package]]
+name = "foreign-types-macros"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a5c6c585bc94aaf2c7b51dd4c2ba22680844aba4c687be581871a6f518c5742"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "foreign-types-shared"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "aa9a19cbb55df58761df49b23516a86d432839add4af60fc256da840f66ed35b"
+
+[[package]]
+name = "form_urlencoded"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
+dependencies = [
+ "percent-encoding",
+]
+
+[[package]]
+name = "futures-channel"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "07bbe89c50d7a535e539b8c17bc0b49bdb77747034daa8087407d655f3f7cc1d"
+dependencies = [
+ "futures-core",
+]
+
+[[package]]
+name = "futures-core"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7e3450815272ef58cec6d564423f6e755e25379b217b0bc688e295ba24df6b1d"
+
+[[package]]
+name = "futures-executor"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf29c38818342a3b26b5b923639e7b1f4a61fc5e76102d4b1981c6dc7a7579d"
+dependencies = [
+ "futures-core",
+ "futures-task",
+ "futures-util",
+]
+
+[[package]]
+name = "futures-io"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cecba35d7ad927e23624b22ad55235f2239cfa44fd10428eecbeba6d6a717718"
+
+[[package]]
+name = "futures-macro"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e835b70203e41293343137df5c0664546da5745f82ec9b84d40be8336958447b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "futures-sink"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c39754e157331b013978ec91992bde1ac089843443c49cbc7f46150b0fad0893"
+
+[[package]]
+name = "futures-task"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "037711b3d59c33004d3856fbdc83b99d4ff37a24768fa1be9ce3538a1cde4393"
+
+[[package]]
+name = "futures-util"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "389ca41296e6190b48053de0321d02a77f32f8a5d2461dd38762c0593805c6d6"
+dependencies = [
+ "futures-core",
+ "futures-io",
+ "futures-macro",
+ "futures-sink",
+ "futures-task",
+ "memchr",
+ "pin-project-lite",
+ "slab",
+]
+
+[[package]]
+name = "gdk"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d9f245958c627ac99d8e529166f9823fb3b838d1d41fd2b297af3075093c2691"
+dependencies = [
+ "cairo-rs",
+ "gdk-pixbuf",
+ "gdk-sys",
+ "gio",
+ "glib",
+ "libc",
+ "pango",
+]
+
+[[package]]
+name = "gdk-pixbuf"
+version = "0.18.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "50e1f5f1b0bfb830d6ccc8066d18db35c487b1b2b1e8589b5dfe9f07e8defaec"
+dependencies = [
+ "gdk-pixbuf-sys",
+ "gio",
+ "glib",
+ "libc",
+ "once_cell",
+]
+
+[[package]]
+name = "gdk-pixbuf-sys"
+version = "0.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f9839ea644ed9c97a34d129ad56d38a25e6756f99f3a88e15cd39c20629caf7"
+dependencies = [
+ "gio-sys",
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "gdk-sys"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c2d13f38594ac1e66619e188c6d5a1adb98d11b2fcf7894fc416ad76aa2f3f7"
+dependencies = [
+ "cairo-sys-rs",
+ "gdk-pixbuf-sys",
+ "gio-sys",
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "pango-sys",
+ "pkg-config",
+ "system-deps",
+]
+
+[[package]]
+name = "gdkwayland-sys"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "140071d506d223f7572b9f09b5e155afbd77428cd5cc7af8f2694c41d98dfe69"
+dependencies = [
+ "gdk-sys",
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "pkg-config",
+ "system-deps",
+]
+
+[[package]]
+name = "gdkx11"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3caa00e14351bebbc8183b3c36690327eb77c49abc2268dd4bd36b856db3fbfe"
+dependencies = [
+ "gdk",
+ "gdkx11-sys",
+ "gio",
+ "glib",
+ "libc",
+ "x11",
+]
+
+[[package]]
+name = "gdkx11-sys"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e2e7445fe01ac26f11601db260dd8608fe172514eb63b3b5e261ea6b0f4428d"
+dependencies = [
+ "gdk-sys",
+ "glib-sys",
+ "libc",
+ "system-deps",
+ "x11",
+]
+
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
+[[package]]
+name = "gently-desktop"
+version = "0.1.0"
+dependencies = [
+ "tauri",
+ "tauri-build",
+ "windows 0.62.2",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "899def5c37c4fd7b2664648c28120ecec138e4d395b459e5ca34f9cce2dd77fd"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "r-efi 5.3.0",
+ "wasip2",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "300e883d756b2e4ec94e02791f39b04b522276138852cfc41d9fb7e904106099"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "r-efi 6.0.0",
+]
+
+[[package]]
+name = "gio"
+version = "0.18.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4fc8f532f87b79cbc51a79748f16a6828fb784be93145a322fa14d06d354c73"
+dependencies = [
+ "futures-channel",
+ "futures-core",
+ "futures-io",
+ "futures-util",
+ "gio-sys",
+ "glib",
+ "libc",
+ "once_cell",
+ "pin-project-lite",
+ "smallvec",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "gio-sys"
+version = "0.18.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "37566df850baf5e4cb0dfb78af2e4b9898d817ed9263d1090a2df958c64737d2"
+dependencies = [
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "system-deps",
+ "winapi",
+]
+
+[[package]]
+name = "glib"
+version = "0.18.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "233daaf6e83ae6a12a52055f568f9d7cf4671dabb78ff9560ab6da230ce00ee5"
+dependencies = [
+ "bitflags 2.13.0",
+ "futures-channel",
+ "futures-core",
+ "futures-executor",
+ "futures-task",
+ "futures-util",
+ "gio-sys",
+ "glib-macros",
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "memchr",
+ "once_cell",
+ "smallvec",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "glib-macros"
+version = "0.18.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bb0228f477c0900c880fd78c8759b95c7636dbd7842707f49e132378aa2acdc"
+dependencies = [
+ "heck 0.4.1",
+ "proc-macro-crate 2.0.2",
+ "proc-macro-error",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "glib-sys"
+version = "0.18.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "063ce2eb6a8d0ea93d2bf8ba1957e78dbab6be1c2220dd3daca57d5a9d869898"
+dependencies = [
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "glob"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0cc23270f6e1808e30a928bdc84dea0b9b4136a8bc82338574f23baf47bbd280"
+
+[[package]]
+name = "gobject-sys"
+version = "0.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0850127b514d1c4a4654ead6dedadb18198999985908e6ffe4436f53c785ce44"
+dependencies = [
+ "glib-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "gtk"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd56fb197bfc42bd5d2751f4f017d44ff59fbb58140c6b49f9b3b2bdab08506a"
+dependencies = [
+ "atk",
+ "cairo-rs",
+ "field-offset",
+ "futures-channel",
+ "gdk",
+ "gdk-pixbuf",
+ "gio",
+ "glib",
+ "gtk-sys",
+ "gtk3-macros",
+ "libc",
+ "pango",
+ "pkg-config",
+]
+
+[[package]]
+name = "gtk-sys"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f29a1c21c59553eb7dd40e918be54dccd60c52b049b75119d5d96ce6b624414"
+dependencies = [
+ "atk-sys",
+ "cairo-sys-rs",
+ "gdk-pixbuf-sys",
+ "gdk-sys",
+ "gio-sys",
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "pango-sys",
+ "system-deps",
+]
+
+[[package]]
+name = "gtk3-macros"
+version = "0.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52ff3c5b21f14f0736fed6dcfc0bfb4225ebf5725f3c0209edeec181e4d73e9d"
+dependencies = [
+ "proc-macro-crate 1.3.1",
+ "proc-macro-error",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a9ee70c43aaf417c914396645a0fa852624801b24ebb7ae78fe8272889ac888"
+
+[[package]]
+name = "hashbrown"
+version = "0.17.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed5909b6e89a2db4456e54cd5f673791d7eca6732202bbf2a9cc504fe2f9b84a"
+
+[[package]]
+name = "heck"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "hex"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70"
+
+[[package]]
+name = "html5ever"
+version = "0.38.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1054432bae2f14e0061e33d23402fbaa67a921d319d56adc6bcf887ddad1cbc2"
+dependencies = [
+ "log",
+ "markup5ever",
+]
+
+[[package]]
+name = "http"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6970f50e31d6fc17d3fa27329444bfa74e196cf62e95052a3f6fee181dba6425"
+dependencies = [
+ "bytes",
+ "itoa",
+]
+
+[[package]]
+name = "http-body"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1efedce1fb8e6913f23e0c92de8e62cd5b772a67e7b3946df930a62566c93184"
+dependencies = [
+ "bytes",
+ "http",
+]
+
+[[package]]
+name = "http-body-util"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b021d93e26becf5dc7e1b75b1bed1fd93124b374ceb73f43d4d4eafec896a64a"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "httparse"
+version = "1.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"
+
+[[package]]
+name = "hyper"
+version = "1.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "55281c53a1894c864990125767da440a4e630446785086f52523b20033b74498"
+dependencies = [
+ "atomic-waker",
+ "bytes",
+ "futures-channel",
+ "futures-core",
+ "http",
+ "http-body",
+ "httparse",
+ "itoa",
+ "pin-project-lite",
+ "smallvec",
+ "tokio",
+ "want",
+]
+
+[[package]]
+name = "hyper-util"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96547c2556ec9d12fb1578c4eaf448b04993e7fb79cbaad930a656880a6bdfa0"
+dependencies = [
+ "base64 0.22.1",
+ "bytes",
+ "futures-channel",
+ "futures-util",
+ "http",
+ "http-body",
+ "hyper",
+ "ipnet",
+ "libc",
+ "percent-encoding",
+ "pin-project-lite",
+ "socket2",
+ "tokio",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "iana-time-zone"
+version = "0.1.65"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e31bc9ad994ba00e440a8aa5c9ef0ec67d5cb5e5cb0cc7f8b744a35b389cc470"
+dependencies = [
+ "android_system_properties",
+ "core-foundation-sys",
+ "iana-time-zone-haiku",
+ "js-sys",
+ "log",
+ "wasm-bindgen",
+ "windows-core 0.62.2",
+]
+
+[[package]]
+name = "iana-time-zone-haiku"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "ico"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3e795dff5605e0f04bff85ca41b51a96b83e80b281e96231bcaaf1ac35103371"
+dependencies = [
+ "byteorder",
+ "png 0.17.16",
+]
+
+[[package]]
+name = "icu_collections"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2984d1cd16c883d7935b9e07e44071dca8d917fd52ecc02c04d5fa0b5a3f191c"
+dependencies = [
+ "displaydoc",
+ "potential_utf",
+ "utf8_iter",
+ "yoke",
+ "zerofrom",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_locale_core"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92219b62b3e2b4d88ac5119f8904c10f8f61bf7e95b640d25ba3075e6cac2c29"
+dependencies = [
+ "displaydoc",
+ "litemap",
+ "tinystr",
+ "writeable",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c56e5ee99d6e3d33bd91c5d85458b6005a22140021cc324cea84dd0e72cff3b4"
+dependencies = [
+ "icu_collections",
+ "icu_normalizer_data",
+ "icu_properties",
+ "icu_provider",
+ "smallvec",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer_data"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da3be0ae77ea334f4da67c12f149704f19f81d1adf7c51cf482943e84a2bad38"
+
+[[package]]
+name = "icu_properties"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bee3b67d0ea5c2cca5003417989af8996f8604e34fb9ddf96208a033901e70de"
+dependencies = [
+ "icu_collections",
+ "icu_locale_core",
+ "icu_properties_data",
+ "icu_provider",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_properties_data"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e2bbb201e0c04f7b4b3e14382af113e17ba4f63e2c9d2ee626b720cbce54a14"
+
+[[package]]
+name = "icu_provider"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "139c4cf31c8b5f33d7e199446eff9c1e02decfc2f0eec2c8d71f65befa45b421"
+dependencies = [
+ "displaydoc",
+ "icu_locale_core",
+ "writeable",
+ "yoke",
+ "zerofrom",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "ident_case"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
+
+[[package]]
+name = "idna"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
+dependencies = [
+ "idna_adapter",
+ "smallvec",
+ "utf8_iter",
+]
+
+[[package]]
+name = "idna_adapter"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb68373c0d6620ef8105e855e7745e18b0d00d3bdb07fb532e434244cdb9a714"
+dependencies = [
+ "icu_normalizer",
+ "icu_properties",
+]
+
+[[package]]
+name = "indexmap"
+version = "1.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bd070e393353796e801d209ad339e89596eb4c8d430d18ede6a1cced8fafbd99"
+dependencies = [
+ "autocfg",
+ "hashbrown 0.12.3",
+ "serde",
+]
+
+[[package]]
+name = "indexmap"
+version = "2.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d466e9454f08e4a911e14806c24e16fba1b4c121d1ea474396f396069cf949d9"
+dependencies = [
+ "equivalent",
+ "hashbrown 0.17.1",
+ "serde",
+ "serde_core",
+]
+
+[[package]]
+name = "infer"
+version = "0.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a588916bfdfd92e71cacef98a63d9b1f0d74d6599980d11894290e7ddefffcf7"
+dependencies = [
+ "cfb",
+]
+
+[[package]]
+name = "ipnet"
+version = "2.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d98f6fed1fde3f8c21bc40a1abb88dd75e67924f9cffc3ef95607bad8017f8e2"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "javascriptcore-rs"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca5671e9ffce8ffba57afc24070e906da7fc4b1ba66f2cabebf61bf2ea257fcc"
+dependencies = [
+ "bitflags 1.3.2",
+ "glib",
+ "javascriptcore-rs-sys",
+]
+
+[[package]]
+name = "javascriptcore-rs-sys"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af1be78d14ffa4b75b66df31840478fef72b51f8c2465d4ca7c194da9f7a5124"
+dependencies = [
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "jni"
+version = "0.21.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a87aa2bb7d2af34197c04845522473242e1aa17c12f4935d5856491a7fb8c97"
+dependencies = [
+ "cesu8",
+ "cfg-if",
+ "combine",
+ "jni-sys 0.3.1",
+ "log",
+ "thiserror 1.0.69",
+ "walkdir",
+ "windows-sys 0.45.0",
+]
+
+[[package]]
+name = "jni-sys"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41a652e1f9b6e0275df1f15b32661cf0d4b78d4d87ddec5e0c3c20f097433258"
+dependencies = [
+ "jni-sys 0.4.1",
+]
+
+[[package]]
+name = "jni-sys"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c6377a88cb3910bee9b0fa88d4f42e1d2da8e79915598f65fb0c7ee14c878af2"
+dependencies = [
+ "jni-sys-macros",
+]
+
+[[package]]
+name = "jni-sys-macros"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38c0b942f458fe50cdac086d2f946512305e5631e720728f2a61aabcd47a6264"
+dependencies = [
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "js-sys"
+version = "0.3.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
+dependencies = [
+ "cfg-if",
+ "futures-util",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "json-patch"
+version = "3.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "863726d7afb6bc2590eeff7135d923545e5e964f004c2ccf8716c25e70a86f08"
+dependencies = [
+ "jsonptr",
+ "serde",
+ "serde_json",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "jsonptr"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5dea2b27dd239b2556ed7a25ba842fe47fd602e7fc7433c2a8d6106d4d9edd70"
+dependencies = [
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "keyboard-types"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b750dcadc39a09dbadd74e118f6dd6598df77fa01df0cfcdc52c28dece74528a"
+dependencies = [
+ "bitflags 2.13.0",
+ "serde",
+ "unicode-segmentation",
+]
+
+[[package]]
+name = "libappindicator"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "03589b9607c868cc7ae54c0b2a22c8dc03dd41692d48f2d7df73615c6a95dc0a"
+dependencies = [
+ "glib",
+ "gtk",
+ "gtk-sys",
+ "libappindicator-sys",
+ "log",
+]
+
+[[package]]
+name = "libappindicator-sys"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e9ec52138abedcc58dc17a7c6c0c00a2bdb4f3427c7f63fa97fd0d859155caf"
+dependencies = [
+ "gtk-sys",
+ "libloading",
+ "once_cell",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "libdbus-sys"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "328c4789d42200f1eeec05bd86c9c13c7f091d2ba9a6ea35acdf51f31bc0f043"
+dependencies = [
+ "pkg-config",
+]
+
+[[package]]
+name = "libloading"
+version = "0.7.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b67380fd3b2fbe7527a606e18729d21c6f3951633d0500574c4dc22d2d638b9f"
+dependencies = [
+ "cfg-if",
+ "winapi",
+]
+
+[[package]]
+name = "libredox"
+version = "0.1.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c943259e342f1e06ff2da7a83eabdfe7f92ce10262688dbf1895ff0b3e6e4652"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "litemap"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92daf443525c4cce67b150400bc2316076100ce0b3686209eb8cf3c31612e6f0"
+
+[[package]]
+name = "lock_api"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
+dependencies = [
+ "scopeguard",
+]
+
+[[package]]
+name = "log"
+version = "0.4.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad"
+
+[[package]]
+name = "markup5ever"
+version = "0.38.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8983d30f2915feeaaab2d6babdd6bc7e9ed1a00b66b5e6d74df19aa9c0e91862"
+dependencies = [
+ "log",
+ "tendril",
+ "web_atoms",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "mime"
+version = "0.3.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
+
+[[package]]
+name = "miniz_oxide"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
+dependencies = [
+ "adler2",
+ "simd-adler32",
+]
+
+[[package]]
+name = "mio"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02bd0af71c67b473010cbbc60715ee815645a4dc942899111f494b4b737d6fda"
+dependencies = [
+ "libc",
+ "wasi",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "muda"
+version = "0.19.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1dd04e60bc0b07438a6771710ee1698f98f6ebbc7f89b61264af1563b8aeb878"
+dependencies = [
+ "crossbeam-channel",
+ "dpi",
+ "gtk",
+ "keyboard-types",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-core-foundation",
+ "objc2-foundation",
+ "once_cell",
+ "png 0.18.1",
+ "serde",
+ "thiserror 2.0.18",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "ndk"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3f42e7bbe13d351b6bead8286a43aac9534b82bd3cc43e47037f012ebfd62d4"
+dependencies = [
+ "bitflags 2.13.0",
+ "jni-sys 0.3.1",
+ "log",
+ "ndk-sys",
+ "num_enum",
+ "raw-window-handle",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "ndk-sys"
+version = "0.6.0+11769913"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee6cda3051665f1fb8d9e08fc35c96d5a244fb1be711a03b71118828afc9a873"
+dependencies = [
+ "jni-sys 0.3.1",
+]
+
+[[package]]
+name = "new_debug_unreachable"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "650eef8c711430f1a879fdd01d4745a7deea475becfb90269c06775983bbf086"
+
+[[package]]
+name = "num-conv"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "521739c6d2bac4aa25192232afe6841231376b2b26d4d9fae5ecf8ca5772e441"
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "num_enum"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5d0bca838442ec211fa11de3a8b0e0e8f3a4522575b5c4c06ed722e005036f26"
+dependencies = [
+ "num_enum_derive",
+ "rustversion",
+]
+
+[[package]]
+name = "num_enum_derive"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "680998035259dcfcafe653688bf2aa6d3e2dc05e98be6ab46afb089dc84f1df8"
+dependencies = [
+ "proc-macro-crate 3.5.0",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "objc2"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3a12a8ed07aefc768292f076dc3ac8c48f3781c8f2d5851dd3d98950e8c5a89f"
+dependencies = [
+ "objc2-encode",
+ "objc2-exception-helper",
+]
+
+[[package]]
+name = "objc2-app-kit"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d49e936b501e5c5bf01fda3a9452ff86dc3ea98ad5f283e1455153142d97518c"
+dependencies = [
+ "bitflags 2.13.0",
+ "block2",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-cloud-kit"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73ad74d880bb43877038da939b7427bba67e9dd42004a18b809ba7d87cee241c"
+dependencies = [
+ "bitflags 2.13.0",
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-data"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b402a653efbb5e82ce4df10683b6b28027616a2715e90009947d50b8dd298fa"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-foundation"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a180dd8642fa45cdb7dd721cd4c11b1cadd4929ce112ebd8b9f5803cc79d536"
+dependencies = [
+ "bitflags 2.13.0",
+ "dispatch2",
+ "objc2",
+]
+
+[[package]]
+name = "objc2-core-graphics"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e022c9d066895efa1345f8e33e584b9f958da2fd4cd116792e15e07e4720a807"
+dependencies = [
+ "bitflags 2.13.0",
+ "dispatch2",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-io-surface",
+]
+
+[[package]]
+name = "objc2-core-image"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5d563b38d2b97209f8e861173de434bd0214cf020e3423a52624cd1d989f006"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-location"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca347214e24bc973fc025fd0d36ebb179ff30536ed1f80252706db19ee452009"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-text"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0cde0dfb48d25d2b4862161a4d5fcc0e3c24367869ad306b0c9ec0073bfed92d"
+dependencies = [
+ "bitflags 2.13.0",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+]
+
+[[package]]
+name = "objc2-encode"
+version = "4.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef25abbcd74fb2609453eb695bd2f860d389e457f67dc17cafc8b8cbc89d0c33"
+
+[[package]]
+name = "objc2-exception-helper"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c7a1c5fbb72d7735b076bb47b578523aedc40f3c439bea6dfd595c089d79d98a"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "objc2-foundation"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3e0adef53c21f888deb4fa59fc59f7eb17404926ee8a6f59f5df0fd7f9f3272"
+dependencies = [
+ "bitflags 2.13.0",
+ "block2",
+ "objc2",
+ "objc2-core-foundation",
+]
+
+[[package]]
+name = "objc2-io-surface"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "180788110936d59bab6bd83b6060ffdfffb3b922ba1396b312ae795e1de9d81d"
+dependencies = [
+ "bitflags 2.13.0",
+ "objc2",
+ "objc2-core-foundation",
+]
+
+[[package]]
+name = "objc2-quartz-core"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96c1358452b371bf9f104e21ec536d37a650eb10f7ee379fff67d2e08d537f1f"
+dependencies = [
+ "bitflags 2.13.0",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-ui-kit"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d87d638e33c06f577498cbcc50491496a3ed4246998a7fbba7ccb98b1e7eab22"
+dependencies = [
+ "bitflags 2.13.0",
+ "block2",
+ "objc2",
+ "objc2-cloud-kit",
+ "objc2-core-data",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+ "objc2-core-image",
+ "objc2-core-location",
+ "objc2-core-text",
+ "objc2-foundation",
+ "objc2-quartz-core",
+ "objc2-user-notifications",
+]
+
+[[package]]
+name = "objc2-user-notifications"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9df9128cbbfef73cda168416ccf7f837b62737d748333bfe9ab71c245d76613e"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-web-kit"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2e5aaab980c433cf470df9d7af96a7b46a9d892d521a2cbbb2f8a4c16751e7f"
+dependencies = [
+ "bitflags 2.13.0",
+ "block2",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-core-foundation",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "option-ext"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04744f49eae99ab78e0d5c0b603ab218f515ea8cfe5a456d7629ad883a3b6e7d"
+
+[[package]]
+name = "pango"
+version = "0.18.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7ca27ec1eb0457ab26f3036ea52229edbdb74dee1edd29063f5b9b010e7ebee4"
+dependencies = [
+ "gio",
+ "glib",
+ "libc",
+ "once_cell",
+ "pango-sys",
+]
+
+[[package]]
+name = "pango-sys"
+version = "0.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "436737e391a843e5933d6d9aa102cb126d501e815b83601365a948a518555dc5"
+dependencies = [
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "parking_lot"
+version = "0.12.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+
+[[package]]
+name = "parking_lot_core"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall",
+ "smallvec",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "percent-encoding"
+version = "2.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
+
+[[package]]
+name = "phf"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c1562dc717473dbaa4c1f85a36410e03c047b2e7df7f45ee938fbef64ae7fadf"
+dependencies = [
+ "phf_macros",
+ "phf_shared",
+ "serde",
+]
+
+[[package]]
+name = "phf_codegen"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "49aa7f9d80421bca176ca8dbfebe668cc7a2684708594ec9f3c0db0805d5d6e1"
+dependencies = [
+ "phf_generator",
+ "phf_shared",
+]
+
+[[package]]
+name = "phf_generator"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "135ace3a761e564ec88c03a77317a7c6b80bb7f7135ef2544dbe054243b89737"
+dependencies = [
+ "fastrand",
+ "phf_shared",
+]
+
+[[package]]
+name = "phf_macros"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "812f032b54b1e759ccd5f8b6677695d5268c588701effba24601f6932f8269ef"
+dependencies = [
+ "phf_generator",
+ "phf_shared",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "phf_shared"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e57fef6bc5981e38c2ce2d63bfa546861309f875b8a75f092d1d54ae2d64f266"
+dependencies = [
+ "siphasher",
+]
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
+
+[[package]]
+name = "pkg-config"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "19f132c84eca552bf34cab8ec81f1c1dcc229b811638f9d283dceabe58c5569e"
+
+[[package]]
+name = "plist"
+version = "1.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7da1d65da6dd5d1e44199ac0f58712d241c0f439f80adea8924d832384087f85"
+dependencies = [
+ "base64 0.22.1",
+ "indexmap 2.14.0",
+ "quick-xml",
+ "serde",
+ "time",
+]
+
+[[package]]
+name = "png"
+version = "0.17.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "82151a2fc869e011c153adc57cf2789ccb8d9906ce52c0b39a6b5697749d7526"
+dependencies = [
+ "bitflags 1.3.2",
+ "crc32fast",
+ "fdeflate",
+ "flate2",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "png"
+version = "0.18.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60769b8b31b2a9f263dae2776c37b1b28ae246943cf719eb6946a1db05128a61"
+dependencies = [
+ "bitflags 2.13.0",
+ "crc32fast",
+ "fdeflate",
+ "flate2",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "potential_utf"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0103b1cef7ec0cf76490e969665504990193874ea05c85ff9bab8b911d0a0564"
+dependencies = [
+ "zerovec",
+]
+
+[[package]]
+name = "powerfmt"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391"
+
+[[package]]
+name = "precomputed-hash"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "925383efa346730478fb4838dbe9137d2a47675ad789c546d150a6e1dd4ab31c"
+
+[[package]]
+name = "proc-macro-crate"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f4c021e1093a56626774e81216a4ce732a735e5bad4868a03f3ed65ca0c3919"
+dependencies = [
+ "once_cell",
+ "toml_edit 0.19.15",
+]
+
+[[package]]
+name = "proc-macro-crate"
+version = "2.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b00f26d3400549137f92511a46ac1cd8ce37cb5598a96d382381458b992a5d24"
+dependencies = [
+ "toml_datetime 0.6.3",
+ "toml_edit 0.20.2",
+]
+
+[[package]]
+name = "proc-macro-crate"
+version = "3.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e67ba7e9b2b56446f1d419b1d807906278ffa1a658a8a5d8a39dcb1f5a78614f"
+dependencies = [
+ "toml_edit 0.25.12+spec-1.1.0",
+]
+
+[[package]]
+name = "proc-macro-error"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da25490ff9892aab3fcf7c36f08cfb902dd3e71ca0f9f9517bea02a73a5ce38c"
+dependencies = [
+ "proc-macro-error-attr",
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+ "version_check",
+]
+
+[[package]]
+name = "proc-macro-error-attr"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a1be40180e52ecc98ad80b184934baf3d0d29f979574e439af5a55274b35f869"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "version_check",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quick-xml"
+version = "0.41.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e660451e55124f798a69a5af3f49ccfbefbd41910eefd25caf2393e1f3473ec1"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfbc457d0c7a0759a614551b11a6409e5951f6c7537be1f1b7682b9ae9230368"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "r-efi"
+version = "5.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "69cdb34c158ceb288df11e18b4bd39de994f6657d83847bdffdbd7f346754b0f"
+
+[[package]]
+name = "r-efi"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
+
+[[package]]
+name = "raw-window-handle"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20675572f6f24e9e76ef639bc5552774ed45f1c30e2951e1e99c59888861c539"
+
+[[package]]
+name = "redox_syscall"
+version = "0.5.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags 2.13.0",
+]
+
+[[package]]
+name = "redox_users"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4e608c6638b9c18977b00b475ac1f28d14e84b27d8d42f70e0bf1e3dec127ac"
+dependencies = [
+ "getrandom 0.2.17",
+ "libredox",
+ "thiserror 2.0.18",
+]
+
+[[package]]
+name = "ref-cast"
+version = "1.0.25"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f354300ae66f76f1c85c5f84693f0ce81d747e2c3f21a45fef496d89c960bf7d"
+dependencies = [
+ "ref-cast-impl",
+]
+
+[[package]]
+name = "ref-cast-impl"
+version = "1.0.25"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7186006dcb21920990093f30e3dea63b7d6e977bf1256be20c3563a5db070da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "regex"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a0e75113e14dc5acb068cd0786884f214f1312650a3d36d269f5c4f3cdee8a2"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f388202e4b80542a0921078cc23b6333bcf1409c1e3f86404cae4766a6131db"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+
+[[package]]
+name = "reqwest"
+version = "0.13.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "219c5811de6525e5416c7d5d53bb656d3afdbc6c5af816e0802bcfa42dbdc1c3"
+dependencies = [
+ "base64 0.22.1",
+ "bytes",
+ "futures-core",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "js-sys",
+ "log",
+ "percent-encoding",
+ "pin-project-lite",
+ "serde",
+ "serde_json",
+ "sync_wrapper",
+ "tokio",
+ "tokio-util",
+ "tower",
+ "tower-http",
+ "tower-service",
+ "url",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "wasm-streams",
+ "web-sys",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "rustc_version"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
+dependencies = [
+ "semver",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "same-file"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502"
+dependencies = [
+ "winapi-util",
+]
+
+[[package]]
+name = "schemars"
+version = "0.8.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3fbf2ae1b8bc8e02df939598064d22402220cd5bbcca1c76f7d6a310974d5615"
+dependencies = [
+ "dyn-clone",
+ "indexmap 1.9.3",
+ "schemars_derive",
+ "serde",
+ "serde_json",
+ "url",
+ "uuid",
+]
+
+[[package]]
+name = "schemars"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4cd191f9397d57d581cddd31014772520aa448f65ef991055d7f61582c65165f"
+dependencies = [
+ "dyn-clone",
+ "ref-cast",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "schemars"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2b42f36aa1cd011945615b92222f6bf73c599a102a300334cd7f8dbeec726cc"
+dependencies = [
+ "dyn-clone",
+ "ref-cast",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "schemars_derive"
+version = "0.8.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32e265784ad618884abaea0600a9adf15393368d840e0222d101a072f3f7534d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "serde_derive_internals",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "scopeguard"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
+
+[[package]]
+name = "selectors"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5d9c0c92a92d33f08817311cf3f2c29a3538a8240e94a6a3c622ce652d7e00c"
+dependencies = [
+ "bitflags 2.13.0",
+ "cssparser",
+ "derive_more",
+ "log",
+ "new_debug_unreachable",
+ "phf",
+ "phf_codegen",
+ "precomputed-hash",
+ "rustc-hash",
+ "servo_arc",
+ "smallvec",
+]
+
+[[package]]
+name = "semver"
+version = "1.0.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a7852d02fc848982e0c167ef163aaff9cd91dc640ba85e263cb1ce46fae51cd"
+dependencies = [
+ "serde",
+ "serde_core",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde-untagged"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f9faf48a4a2d2693be24c6289dbe26552776eb7737074e6722891fadbe6c5058"
+dependencies = [
+ "erased-serde",
+ "serde",
+ "serde_core",
+ "typeid",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "serde_derive_internals"
+version = "0.29.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "18d26a20a969b9e3fdf2fc2d9f21eda6c40e2de84c9408bb5d3b05d499aae711"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.150"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "serde_repr"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "175ee3e80ae9982737ca543e96133087cbd9a485eecc3bc4de9c1a37b47ea59c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "serde_spanned"
+version = "0.6.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bf41e0cfaf7226dca15e8197172c295a782857fcb97fad1808a166870dee75a3"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "serde_spanned"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6662b5879511e06e8999a8a235d848113e942c9124f211511b16466ee2995f26"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "serde_with"
+version = "3.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76a5c54c7310e7b8b9577c286d7e399ddd876c3e12b3ed917a8aabc4b96e9e8c"
+dependencies = [
+ "base64 0.22.1",
+ "bs58",
+ "chrono",
+ "hex",
+ "indexmap 1.9.3",
+ "indexmap 2.14.0",
+ "schemars 0.9.0",
+ "schemars 1.2.1",
+ "serde_core",
+ "serde_json",
+ "serde_with_macros",
+ "time",
+]
+
+[[package]]
+name = "serde_with_macros"
+version = "3.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "84d57bc0c8b9a17920c178daa6bb924850d54a9c97ab45194bb8c17ad66bb660"
+dependencies = [
+ "darling",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "serialize-to-javascript"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04f3666a07a197cdb77cdf306c32be9b7f598d7060d50cfd4d5aa04bfd92f6c5"
+dependencies = [
+ "serde",
+ "serde_json",
+ "serialize-to-javascript-impl",
+]
+
+[[package]]
+name = "serialize-to-javascript-impl"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "772ee033c0916d670af7860b6e1ef7d658a4629a6d0b4c8c3e67f09b3765b75d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "servo_arc"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "170fb83ab34de17dc69aa7c67482b22218ddb85da56546f9bd6b929e32a05930"
+dependencies = [
+ "stable_deref_trait",
+]
+
+[[package]]
+name = "sha2"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest",
+]
+
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+
+[[package]]
+name = "simd-adler32"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "703d5c7ef118737c72f1af64ad2f6f8c5e1921f818cdcb97b8fe6fc69bf66214"
+
+[[package]]
+name = "siphasher"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ee5873ec9cce0195efcb7a4e9507a04cd49aec9c83d0389df45b1ef7ba2e649"
+
+[[package]]
+name = "slab"
+version = "0.4.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
+
+[[package]]
+name = "smallvec"
+version = "1.15.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ed6a63f02c8539c91a8685a86f4099661ba3da017932f6ebbea6de3f0fa7c90"
+
+[[package]]
+name = "socket2"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52d1cfed4120b4d927bf7c0f86d2087a4a7d6027c906d9f9d525a80573b9be51"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "softbuffer"
+version = "0.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "aac18da81ebbf05109ab275b157c22a653bb3c12cf884450179942f81bcbf6c3"
+dependencies = [
+ "bytemuck",
+ "js-sys",
+ "ndk",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+ "objc2-foundation",
+ "objc2-quartz-core",
+ "raw-window-handle",
+ "redox_syscall",
+ "tracing",
+ "wasm-bindgen",
+ "web-sys",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "soup3"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "471f924a40f31251afc77450e781cb26d55c0b650842efafc9c6cbd2f7cc4f9f"
+dependencies = [
+ "futures-channel",
+ "gio",
+ "glib",
+ "libc",
+ "soup3-sys",
+]
+
+[[package]]
+name = "soup3-sys"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7ebe8950a680a12f24f15ebe1bf70db7af98ad242d9db43596ad3108aab86c27"
+dependencies = [
+ "gio-sys",
+ "glib-sys",
+ "gobject-sys",
+ "libc",
+ "system-deps",
+]
+
+[[package]]
+name = "stable_deref_trait"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
+
+[[package]]
+name = "string_cache"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a18596f8c785a729f2819c0f6a7eae6ebeebdfffbfe4214ae6b087f690e31901"
+dependencies = [
+ "new_debug_unreachable",
+ "parking_lot",
+ "phf_shared",
+ "precomputed-hash",
+]
+
+[[package]]
+name = "string_cache_codegen"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "585635e46db231059f76c5849798146164652513eb9e8ab2685939dd90f29b69"
+dependencies = [
+ "phf_generator",
+ "phf_shared",
+ "proc-macro2",
+ "quote",
+]
+
+[[package]]
+name = "strsim"
+version = "0.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
+
+[[package]]
+name = "swift-rs"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4057c98e2e852d51fdcfca832aac7b571f6b351ad159f9eda5db1655f8d0c4d7"
+dependencies = [
+ "base64 0.21.7",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "syn"
+version = "1.0.109"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
+dependencies = [
+ "proc-macro2",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.118"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1b9ae57f904213ebb649ce6895b8a66c66f0203b9319718f69a5612a065b1422"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "sync_wrapper"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263"
+dependencies = [
+ "futures-core",
+]
+
+[[package]]
+name = "synstructure"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "system-deps"
+version = "6.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a3e535eb8dded36d55ec13eddacd30dec501792ff23a0b1682c38601b8cf2349"
+dependencies = [
+ "cfg-expr",
+ "heck 0.5.0",
+ "pkg-config",
+ "toml 0.8.2",
+ "version-compare",
+]
+
+[[package]]
+name = "tao"
+version = "0.35.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d1c93047acf68669466a34690ac58cca7010bd1b201e1ec86f1fd0a75d3dd4a9"
+dependencies = [
+ "bitflags 2.13.0",
+ "block2",
+ "core-foundation",
+ "core-graphics",
+ "crossbeam-channel",
+ "dbus",
+ "dispatch2",
+ "dlopen2",
+ "dpi",
+ "gdkwayland-sys",
+ "gdkx11-sys",
+ "gtk",
+ "jni",
+ "libc",
+ "log",
+ "ndk",
+ "ndk-sys",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-foundation",
+ "objc2-ui-kit",
+ "once_cell",
+ "parking_lot",
+ "percent-encoding",
+ "raw-window-handle",
+ "tao-macros",
+ "unicode-segmentation",
+ "url",
+ "windows 0.61.3",
+ "windows-core 0.61.2",
+ "windows-version",
+ "x11-dl",
+]
+
+[[package]]
+name = "tao-macros"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f4e16beb8b2ac17db28eab8bca40e62dbfbb34c0fcdc6d9826b11b7b5d047dfd"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "tauri"
+version = "2.11.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "667b20e2726d572dea2de7370da16e188eb06008faf9a92fab7cdc46791190b5"
+dependencies = [
+ "anyhow",
+ "bytes",
+ "cookie",
+ "dirs",
+ "dunce",
+ "embed_plist",
+ "getrandom 0.3.4",
+ "glob",
+ "gtk",
+ "heck 0.5.0",
+ "http",
+ "jni",
+ "libc",
+ "log",
+ "mime",
+ "muda",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-foundation",
+ "objc2-ui-kit",
+ "objc2-web-kit",
+ "percent-encoding",
+ "plist",
+ "raw-window-handle",
+ "reqwest",
+ "serde",
+ "serde_json",
+ "serde_repr",
+ "serialize-to-javascript",
+ "swift-rs",
+ "tauri-build",
+ "tauri-macros",
+ "tauri-runtime",
+ "tauri-runtime-wry",
+ "tauri-utils",
+ "thiserror 2.0.18",
+ "tokio",
+ "tray-icon",
+ "url",
+ "webkit2gtk",
+ "webview2-com",
+ "window-vibrancy",
+ "windows 0.61.3",
+]
+
+[[package]]
+name = "tauri-build"
+version = "2.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bc9ce40b16101cb6ea63d3e221567affd1c3a9205f95d7bc574941a10636b632"
+dependencies = [
+ "anyhow",
+ "cargo_toml",
+ "dirs",
+ "glob",
+ "heck 0.5.0",
+ "json-patch",
+ "schemars 0.8.22",
+ "semver",
+ "serde",
+ "serde_json",
+ "tauri-utils",
+ "tauri-winres",
+ "walkdir",
+]
+
+[[package]]
+name = "tauri-codegen"
+version = "2.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08279169ff42f8fc45a1dbc9dcae888893ba95288142e5880c59b93a26d2cfc5"
+dependencies = [
+ "base64 0.22.1",
+ "brotli",
+ "ico",
+ "json-patch",
+ "plist",
+ "png 0.17.16",
+ "proc-macro2",
+ "quote",
+ "semver",
+ "serde",
+ "serde_json",
+ "sha2",
+ "syn 2.0.118",
+ "tauri-utils",
+ "thiserror 2.0.18",
+ "time",
+ "url",
+ "uuid",
+ "walkdir",
+]
+
+[[package]]
+name = "tauri-macros"
+version = "2.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8b394794f399a421811d06966343e7933fcae92d59f5180b9388d1174497a45"
+dependencies = [
+ "heck 0.5.0",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+ "tauri-codegen",
+ "tauri-utils",
+]
+
+[[package]]
+name = "tauri-runtime"
+version = "2.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b0b4bc95aed361b0019067d189a1174a603d460d0f6c72606512d59fc9c12ec8"
+dependencies = [
+ "cookie",
+ "dpi",
+ "gtk",
+ "http",
+ "jni",
+ "objc2",
+ "objc2-ui-kit",
+ "objc2-web-kit",
+ "raw-window-handle",
+ "serde",
+ "serde_json",
+ "tauri-utils",
+ "thiserror 2.0.18",
+ "url",
+ "webkit2gtk",
+ "webview2-com",
+ "windows 0.61.3",
+]
+
+[[package]]
+name = "tauri-runtime-wry"
+version = "2.11.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e6fac707727b7a2f48e4ded90976324267371073edbb415ffb73bb0458d203f"
+dependencies = [
+ "gtk",
+ "http",
+ "jni",
+ "log",
+ "objc2",
+ "objc2-app-kit",
+ "once_cell",
+ "percent-encoding",
+ "raw-window-handle",
+ "softbuffer",
+ "tao",
+ "tauri-runtime",
+ "tauri-utils",
+ "url",
+ "webkit2gtk",
+ "webview2-com",
+ "windows 0.61.3",
+ "wry",
+]
+
+[[package]]
+name = "tauri-utils"
+version = "2.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3e176a18e67764923c4f1ce66f25ae4abe5f688384d5eb1a0fa6c77f3d90f887"
+dependencies = [
+ "anyhow",
+ "brotli",
+ "cargo_metadata",
+ "ctor",
+ "dom_query",
+ "dunce",
+ "glob",
+ "http",
+ "infer",
+ "json-patch",
+ "log",
+ "memchr",
+ "phf",
+ "plist",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "schemars 0.8.22",
+ "semver",
+ "serde",
+ "serde-untagged",
+ "serde_json",
+ "serde_with",
+ "swift-rs",
+ "thiserror 2.0.18",
+ "toml 1.1.2+spec-1.1.0",
+ "url",
+ "urlpattern",
+ "uuid",
+ "walkdir",
+]
+
+[[package]]
+name = "tauri-winres"
+version = "0.3.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cc65d45c68858bfe420dd29e834b5d15dbecf8a07a8a16cf4d532c7b1f69d4b6"
+dependencies = [
+ "dunce",
+ "embed-resource",
+ "toml 1.1.2+spec-1.1.0",
+]
+
+[[package]]
+name = "tendril"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5fed54709c5b3a53d09bb1c113ea4f5ceafd1e772ddcb0030a82e1d56c087b08"
+dependencies = [
+ "new_debug_unreachable",
+]
+
+[[package]]
+name = "thiserror"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
+dependencies = [
+ "thiserror-impl 1.0.69",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4"
+dependencies = [
+ "thiserror-impl 2.0.18",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "time"
+version = "0.3.53"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "18dfaaeddcb932337b5e7866ee7d0ce9b76d2fd092997146f187ec09b4558a50"
+dependencies = [
+ "deranged",
+ "num-conv",
+ "powerfmt",
+ "serde_core",
+ "time-core",
+ "time-macros",
+]
+
+[[package]]
+name = "time-core"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9e1c906769ad99c88eaa54e728060edef082f8e358ff32030cb7c7d315e81109"
+
+[[package]]
+name = "time-macros"
+version = "0.2.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c431b87111666e491a90baa837f914fb45cd5dc3c268591b0220ff5057f2085f"
+dependencies = [
+ "num-conv",
+ "time-core",
+]
+
+[[package]]
+name = "tinystr"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c8323304221c2a851516f22236c5722a72eaa19749016521d6dff0824447d96d"
+dependencies = [
+ "displaydoc",
+ "zerovec",
+]
+
+[[package]]
+name = "tinyvec"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bb4ebadaa0af04fab11ae01eb5f9fdb5f9c5b875506e210e71c07873528baa7f"
+dependencies = [
+ "tinyvec_macros",
+]
+
+[[package]]
+name = "tinyvec_macros"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
+
+[[package]]
+name = "tokio"
+version = "1.52.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fc7f01b389ac15039e4dc9531aa973a135d7a4135281b12d7c1bc79fd57fffe"
+dependencies = [
+ "bytes",
+ "libc",
+ "mio",
+ "pin-project-lite",
+ "socket2",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "tokio-util"
+version = "0.7.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ae9cec805b01e8fc3fd2fe289f89149a9b66dd16786abd8b19cfa7b48cb0098"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "futures-sink",
+ "pin-project-lite",
+ "tokio",
+]
+
+[[package]]
+name = "toml"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "185d8ab0dfbb35cf1399a6344d8484209c088f75f8f68230da55d48d95d43e3d"
+dependencies = [
+ "serde",
+ "serde_spanned 0.6.9",
+ "toml_datetime 0.6.3",
+ "toml_edit 0.20.2",
+]
+
+[[package]]
+name = "toml"
+version = "0.9.12+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf92845e79fc2e2def6a5d828f0801e29a2f8acc037becc5ab08595c7d5e9863"
+dependencies = [
+ "indexmap 2.14.0",
+ "serde_core",
+ "serde_spanned 1.1.1",
+ "toml_datetime 0.7.5+spec-1.1.0",
+ "toml_parser",
+ "toml_writer",
+ "winnow 0.7.15",
+]
+
+[[package]]
+name = "toml"
+version = "1.1.2+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "81f3d15e84cbcd896376e6730314d59fb5a87f31e4b038454184435cd57defee"
+dependencies = [
+ "indexmap 2.14.0",
+ "serde_core",
+ "serde_spanned 1.1.1",
+ "toml_datetime 1.1.1+spec-1.1.0",
+ "toml_parser",
+ "toml_writer",
+ "winnow 1.0.3",
+]
+
+[[package]]
+name = "toml_datetime"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "toml_datetime"
+version = "0.7.5+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92e1cfed4a3038bc5a127e35a2d360f145e1f4b971b551a2ba5fd7aedf7e1347"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "toml_datetime"
+version = "1.1.1+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3165f65f62e28e0115a00b2ebdd37eb6f3b641855f9d636d3cd4103767159ad7"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "toml_edit"
+version = "0.19.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
+dependencies = [
+ "indexmap 2.14.0",
+ "toml_datetime 0.6.3",
+ "winnow 0.5.40",
+]
+
+[[package]]
+name = "toml_edit"
+version = "0.20.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "396e4d48bbb2b7554c944bde63101b5ae446cff6ec4a24227428f15eb72ef338"
+dependencies = [
+ "indexmap 2.14.0",
+ "serde",
+ "serde_spanned 0.6.9",
+ "toml_datetime 0.6.3",
+ "winnow 0.5.40",
+]
+
+[[package]]
+name = "toml_edit"
+version = "0.25.12+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d2153edc6955a6c354fad8f5efd38b6a8769bdccf9fe50f8e1329f81b0baa5d7"
+dependencies = [
+ "indexmap 2.14.0",
+ "toml_datetime 1.1.1+spec-1.1.0",
+ "toml_parser",
+ "winnow 1.0.3",
+]
+
+[[package]]
+name = "toml_parser"
+version = "1.1.2+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2abe9b86193656635d2411dc43050282ca48aa31c2451210f4202550afb7526"
+dependencies = [
+ "winnow 1.0.3",
+]
+
+[[package]]
+name = "toml_writer"
+version = "1.1.1+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "756daf9b1013ebe47a8776667b466417e2d4c5679d441c26230efd9ef78692db"
+
+[[package]]
+name = "tower"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4"
+dependencies = [
+ "futures-core",
+ "futures-util",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tokio",
+ "tower-layer",
+ "tower-service",
+]
+
+[[package]]
+name = "tower-http"
+version = "0.6.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4cfcf7e2740e6fc6d4d688b4ef00650406bb94adf4731e43c096c3a19fe40840"
+dependencies = [
+ "bitflags 2.13.0",
+ "bytes",
+ "futures-util",
+ "http",
+ "http-body",
+ "pin-project-lite",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "url",
+]
+
+[[package]]
+name = "tower-layer"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e"
+
+[[package]]
+name = "tower-service"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3"
+
+[[package]]
+name = "tracing"
+version = "0.1.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100"
+dependencies = [
+ "pin-project-lite",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-core"
+version = "0.1.36"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a"
+dependencies = [
+ "once_cell",
+]
+
+[[package]]
+name = "tray-icon"
+version = "0.24.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65ba1e5f6b9ef9fd87e21b9c6f351554dbd717960089168fcfdef854686961dc"
+dependencies = [
+ "crossbeam-channel",
+ "dirs",
+ "libappindicator",
+ "muda",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+ "objc2-foundation",
+ "once_cell",
+ "png 0.18.1",
+ "serde",
+ "thiserror 2.0.18",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "try-lock"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
+
+[[package]]
+name = "typeid"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bc7d623258602320d5c55d1bc22793b57daff0ec7efc270ea7d55ce1d5f5471c"
+
+[[package]]
+name = "typenum"
+version = "1.20.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
+
+[[package]]
+name = "unic-char-property"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a8c57a407d9b6fa02b4795eb81c5b6652060a15a7903ea981f3d723e6c0be221"
+dependencies = [
+ "unic-char-range",
+]
+
+[[package]]
+name = "unic-char-range"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0398022d5f700414f6b899e10b8348231abf9173fa93144cbc1a43b9793c1fbc"
+
+[[package]]
+name = "unic-common"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "80d7ff825a6a654ee85a63e80f92f054f904f21e7d12da4e22f9834a4aaa35bc"
+
+[[package]]
+name = "unic-ucd-ident"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e230a37c0381caa9219d67cf063aa3a375ffed5bf541a452db16e744bdab6987"
+dependencies = [
+ "unic-char-property",
+ "unic-char-range",
+ "unic-ucd-version",
+]
+
+[[package]]
+name = "unic-ucd-version"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96bd2f2237fe450fcd0a1d2f5f4e91711124f7857ba2e964247776ebeeb7b0c4"
+dependencies = [
+ "unic-common",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unicode-segmentation"
+version = "1.13.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c6f5d3c3b1bf09027a88a6bc961fc00497d651009560b5463668dc81b0fa87a8"
+
+[[package]]
+name = "url"
+version = "2.5.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff67a8a4397373c3ef660812acab3268222035010ab8680ec4215f38ba3d0eed"
+dependencies = [
+ "form_urlencoded",
+ "idna",
+ "percent-encoding",
+ "serde",
+ "serde_derive",
+]
+
+[[package]]
+name = "urlpattern"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "70acd30e3aa1450bc2eece896ce2ad0d178e9c079493819301573dae3c37ba6d"
+dependencies = [
+ "regex",
+ "serde",
+ "unic-ucd-ident",
+ "url",
+]
+
+[[package]]
+name = "utf8_iter"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
+
+[[package]]
+name = "uuid"
+version = "1.23.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bf80a72845275afea99e7f2b434723d3bc7e38470fcd1c7ed39a599c73319a53"
+dependencies = [
+ "getrandom 0.4.3",
+ "js-sys",
+ "serde_core",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "version-compare"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "03c2856837ef78f57382f06b2b8563a2f512f7185d732608fd9176cb3b8edf0e"
+
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+
+[[package]]
+name = "vswhom"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "be979b7f07507105799e854203b470ff7c78a1639e330a58f183b5fea574608b"
+dependencies = [
+ "libc",
+ "vswhom-sys",
+]
+
+[[package]]
+name = "vswhom-sys"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb067e4cbd1ff067d1df46c9194b5de0e98efd2810bbc95c5d5e5f25a3231150"
+dependencies = [
+ "cc",
+ "libc",
+]
+
+[[package]]
+name = "walkdir"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b"
+dependencies = [
+ "same-file",
+ "winapi-util",
+]
+
+[[package]]
+name = "want"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e"
+dependencies = [
+ "try-lock",
+]
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "wasip2"
+version = "1.0.4+wasi-0.2.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b67efb37e106e55ce722a510d6b5f9c17f083e5fc79afc2badeb12cc313d9487"
+dependencies = [
+ "wit-bindgen",
+]
+
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-futures"
+version = "0.4.76"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c62df1340f32221cb9c54d6a27b030e3dba64361d4a95bed55f9aacb44da291d"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
+dependencies = [
+ "bumpalo",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "wasm-streams"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d1ec4f6517c9e11ae630e200b2b65d193279042e28edd4a2cda233e46670bbb"
+dependencies = [
+ "futures-util",
+ "js-sys",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+]
+
+[[package]]
+name = "web-sys"
+version = "0.3.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8622dcb61c0bcc9fffa6938bed81210af2da9a7e4a1a834b2e37a59b6dfb6141"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "web_atoms"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "075474b12bcb3d2e3d4546580e9de478eeeead668a1761e2a8860c836b7ef297"
+dependencies = [
+ "phf",
+ "phf_codegen",
+ "string_cache",
+ "string_cache_codegen",
+]
+
+[[package]]
+name = "webkit2gtk"
+version = "2.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a1027150013530fb2eaf806408df88461ae4815a45c541c8975e61d6f2fc4793"
+dependencies = [
+ "bitflags 1.3.2",
+ "cairo-rs",
+ "gdk",
+ "gdk-sys",
+ "gio",
+ "gio-sys",
+ "glib",
+ "glib-sys",
+ "gobject-sys",
+ "gtk",
+ "gtk-sys",
+ "javascriptcore-rs",
+ "libc",
+ "once_cell",
+ "soup3",
+ "webkit2gtk-sys",
+]
+
+[[package]]
+name = "webkit2gtk-sys"
+version = "2.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "916a5f65c2ef0dfe12fff695960a2ec3d4565359fdbb2e9943c974e06c734ea5"
+dependencies = [
+ "bitflags 1.3.2",
+ "cairo-sys-rs",
+ "gdk-sys",
+ "gio-sys",
+ "glib-sys",
+ "gobject-sys",
+ "gtk-sys",
+ "javascriptcore-rs-sys",
+ "libc",
+ "pkg-config",
+ "soup3-sys",
+ "system-deps",
+]
+
+[[package]]
+name = "webview2-com"
+version = "0.38.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7130243a7a5b33c54a444e54842e6a9e133de08b5ad7b5861cd8ed9a6a5bc96a"
+dependencies = [
+ "webview2-com-macros",
+ "webview2-com-sys",
+ "windows 0.61.3",
+ "windows-core 0.61.2",
+ "windows-implement",
+ "windows-interface",
+]
+
+[[package]]
+name = "webview2-com-macros"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67a921c1b6914c367b2b823cd4cde6f96beec77d30a939c8199bb377cf9b9b54"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "webview2-com-sys"
+version = "0.38.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "381336cfffd772377d291702245447a5251a2ffa5bad679c99e61bc48bacbf9c"
+dependencies = [
+ "thiserror 2.0.18",
+ "windows 0.61.3",
+ "windows-core 0.61.2",
+]
+
+[[package]]
+name = "winapi"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
+dependencies = [
+ "winapi-i686-pc-windows-gnu",
+ "winapi-x86_64-pc-windows-gnu",
+]
+
+[[package]]
+name = "winapi-i686-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
+
+[[package]]
+name = "winapi-util"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "winapi-x86_64-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "window-vibrancy"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d9bec5a31f3f9362f2258fd0e9c9dd61a9ca432e7306cc78c444258f0dce9a9c"
+dependencies = [
+ "objc2",
+ "objc2-app-kit",
+ "objc2-core-foundation",
+ "objc2-foundation",
+ "raw-window-handle",
+ "windows-sys 0.59.0",
+ "windows-version",
+]
+
+[[package]]
+name = "windows"
+version = "0.61.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9babd3a767a4c1aef6900409f85f5d53ce2544ccdfaa86dad48c91782c6d6893"
+dependencies = [
+ "windows-collections 0.2.0",
+ "windows-core 0.61.2",
+ "windows-future 0.2.1",
+ "windows-link 0.1.3",
+ "windows-numerics 0.2.0",
+]
+
+[[package]]
+name = "windows"
+version = "0.62.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "527fadee13e0c05939a6a05d5bd6eec6cd2e3dbd648b9f8e447c6518133d8580"
+dependencies = [
+ "windows-collections 0.3.2",
+ "windows-core 0.62.2",
+ "windows-future 0.3.2",
+ "windows-numerics 0.3.1",
+]
+
+[[package]]
+name = "windows-collections"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3beeceb5e5cfd9eb1d76b381630e82c4241ccd0d27f1a39ed41b2760b255c5e8"
+dependencies = [
+ "windows-core 0.61.2",
+]
+
+[[package]]
+name = "windows-collections"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "23b2d95af1a8a14a3c7367e1ed4fc9c20e0a26e79551b1454d72583c97cc6610"
+dependencies = [
+ "windows-core 0.62.2",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c0fdd3ddb90610c7638aa2b3a3ab2904fb9e5cdbecc643ddb3647212781c4ae3"
+dependencies = [
+ "windows-implement",
+ "windows-interface",
+ "windows-link 0.1.3",
+ "windows-result 0.3.4",
+ "windows-strings 0.4.2",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.62.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
+dependencies = [
+ "windows-implement",
+ "windows-interface",
+ "windows-link 0.2.1",
+ "windows-result 0.4.1",
+ "windows-strings 0.5.1",
+]
+
+[[package]]
+name = "windows-future"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc6a41e98427b19fe4b73c550f060b59fa592d7d686537eebf9385621bfbad8e"
+dependencies = [
+ "windows-core 0.61.2",
+ "windows-link 0.1.3",
+ "windows-threading 0.1.0",
+]
+
+[[package]]
+name = "windows-future"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e1d6f90251fe18a279739e78025bd6ddc52a7e22f921070ccdc67dde84c605cb"
+dependencies = [
+ "windows-core 0.62.2",
+ "windows-link 0.2.1",
+ "windows-threading 0.2.1",
+]
+
+[[package]]
+name = "windows-implement"
+version = "0.60.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "053e2e040ab57b9dc951b72c264860db7eb3b0200ba345b4e4c3b14f67855ddf"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "windows-interface"
+version = "0.59.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f316c4a2570ba26bbec722032c4099d8c8bc095efccdc15688708623367e358"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e6ad25900d524eaabdbbb96d20b4311e1e7ae1699af4fb28c17ae66c80d798a"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-numerics"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9150af68066c4c5c07ddc0ce30421554771e528bde427614c61038bc2c92c2b1"
+dependencies = [
+ "windows-core 0.61.2",
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-numerics"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e2e40844ac143cdb44aead537bbf727de9b044e107a0f1220392177d15b0f26"
+dependencies = [
+ "windows-core 0.62.2",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-result"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56f42bd332cc6c8eac5af113fc0c1fd6a8fd2aa08a0119358686e5160d0586c6"
+dependencies = [
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-result"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56e6c93f3a0c3b36176cb1327a4958a0353d5d166c2a35cb268ace15e91d3b57"
+dependencies = [
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.45.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75283be5efb2831d37ea142365f009c02ec203cd29a3ebecbc093d52315b66d0"
+dependencies = [
+ "windows-targets 0.42.2",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.59.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b"
+dependencies = [
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e5180c00cd44c9b1c88adb3693291f1cd93605ded80c250a75d472756b4d071"
+dependencies = [
+ "windows_aarch64_gnullvm 0.42.2",
+ "windows_aarch64_msvc 0.42.2",
+ "windows_i686_gnu 0.42.2",
+ "windows_i686_msvc 0.42.2",
+ "windows_x86_64_gnu 0.42.2",
+ "windows_x86_64_gnullvm 0.42.2",
+ "windows_x86_64_msvc 0.42.2",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm 0.52.6",
+ "windows_aarch64_msvc 0.52.6",
+ "windows_i686_gnu 0.52.6",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc 0.52.6",
+ "windows_x86_64_gnu 0.52.6",
+ "windows_x86_64_gnullvm 0.52.6",
+ "windows_x86_64_msvc 0.52.6",
+]
+
+[[package]]
+name = "windows-threading"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b66463ad2e0ea3bbf808b7f1d371311c80e115c0b71d60efc142cafbcfb057a6"
+dependencies = [
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-threading"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3949bd5b99cafdf1c7ca86b43ca564028dfe27d66958f2470940f73d86d75b37"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-version"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e4060a1da109b9d0326b7262c8e12c84df67cc0dbc9e33cf49e01ccc2eb63631"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8"
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
+
+[[package]]
+name = "winnow"
+version = "0.5.40"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f593a95398737aeed53e489c785df13f3618e41dbcd6718c6addbf1395aa6876"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "winnow"
+version = "0.7.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df79d97927682d2fd8adb29682d1140b343be4ac0f08fd68b7765d9c059d3945"
+
+[[package]]
+name = "winnow"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0592e1c9d151f854e6fd382574c3a0855250e1d9b2f99d9281c6e6391af352f1"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "winreg"
+version = "0.55.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb5a765337c50e9ec252c2069be9bf91c7df47afb103b642ba3a53bf8101be97"
+dependencies = [
+ "cfg-if",
+ "windows-sys 0.59.0",
+]
+
+[[package]]
+name = "wit-bindgen"
+version = "0.57.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ebf944e87a7c253233ad6766e082e3cd714b5d03812acc24c318f549614536e"
+
+[[package]]
+name = "writeable"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4"
+
+[[package]]
+name = "wry"
+version = "0.55.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "186f9871daa55fd9c016578b810d149de58367113db7fb72b462d2323ce19514"
+dependencies = [
+ "base64 0.22.1",
+ "block2",
+ "cookie",
+ "crossbeam-channel",
+ "dirs",
+ "dom_query",
+ "dpi",
+ "dunce",
+ "gdkx11",
+ "gtk",
+ "http",
+ "javascriptcore-rs",
+ "jni",
+ "libc",
+ "ndk",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-core-foundation",
+ "objc2-foundation",
+ "objc2-ui-kit",
+ "objc2-web-kit",
+ "once_cell",
+ "percent-encoding",
+ "raw-window-handle",
+ "sha2",
+ "soup3",
+ "tao-macros",
+ "thiserror 2.0.18",
+ "url",
+ "webkit2gtk",
+ "webkit2gtk-sys",
+ "webview2-com",
+ "windows 0.61.3",
+ "windows-core 0.61.2",
+ "windows-version",
+ "x11-dl",
+]
+
+[[package]]
+name = "x11"
+version = "2.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "502da5464ccd04011667b11c435cb992822c2c0dbde1770c988480d312a0db2e"
+dependencies = [
+ "libc",
+ "pkg-config",
+]
+
+[[package]]
+name = "x11-dl"
+version = "2.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38735924fedd5314a6e548792904ed8c6de6636285cb9fec04d5b1db85c1516f"
+dependencies = [
+ "libc",
+ "once_cell",
+ "pkg-config",
+]
+
+[[package]]
+name = "yoke"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
+dependencies = [
+ "stable_deref_trait",
+ "yoke-derive",
+ "zerofrom",
+]
+
+[[package]]
+name = "yoke-derive"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "de844c262c8848816172cef550288e7dc6c7b7814b4ee56b3e1553f275f1858e"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+ "synstructure",
+]
+
+[[package]]
+name = "zerofrom"
+version = "0.1.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ec05a11813ea801ff6d75110ad09cd0824ddba17dfe17128ea0d5f68e6c5272"
+dependencies = [
+ "zerofrom-derive",
+]
+
+[[package]]
+name = "zerofrom-derive"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11532158c46691caf0f2593ea8358fed6bbf68a0315e80aae9bd41fbade684a1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+ "synstructure",
+]
+
+[[package]]
+name = "zerotrie"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0f9152d31db0792fa83f70fb2f83148effb5c1f5b8c7686c3459e361d9bc20bf"
+dependencies = [
+ "displaydoc",
+ "yoke",
+ "zerofrom",
+]
+
+[[package]]
+name = "zerovec"
+version = "0.11.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "90f911cbc359ab6af17377d242225f4d75119aec87ea711a880987b18cd7b239"
+dependencies = [
+ "yoke",
+ "zerofrom",
+ "zerovec-derive",
+]
+
+[[package]]
+name = "zerovec-derive"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "625dc425cab0dca6dc3c3319506e6593dcb08a9f387ea3b284dbd52a92c40555"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.118",
+]
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"
diff --git a/desktop/src-tauri/Cargo.toml b/desktop/src-tauri/Cargo.toml
new file mode 100644
index 00000000..6d85d560
--- /dev/null
+++ b/desktop/src-tauri/Cargo.toml
@@ -0,0 +1,29 @@
+[package]
+name = "gently-desktop"
+version = "0.1.0"
+edition = "2021"
+description = "Gently desktop shell — owns the Python backend + device layer"
+authors = ["gently"]
+default-run = "gently-desktop"
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2" }
+
+# Windows Job Object: put the spawned Python (and its device-layer grandchild)
+# in a kill-on-close job so the whole tree dies when the shell exits or crashes.
+[target.'cfg(windows)'.dependencies]
+windows = { version = "0.62", features = [
+    "Win32_Foundation",
+    "Win32_System_JobObjects",
+    "Win32_System_Threading",
+    "Win32_Security",
+] }
+
+[profile.release]
+codegen-units = 1
+lto = true
+opt-level = "s"
+strip = true
diff --git a/desktop/src-tauri/build.rs b/desktop/src-tauri/build.rs
new file mode 100644
index 00000000..d860e1e6
--- /dev/null
+++ b/desktop/src-tauri/build.rs
@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}
diff --git a/desktop/src-tauri/capabilities/default.json b/desktop/src-tauri/capabilities/default.json
new file mode 100644
index 00000000..c1da0cbb
--- /dev/null
+++ b/desktop/src-tauri/capabilities/default.json
@@ -0,0 +1,7 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "Thin shell — the UI is served by the Python backend and makes no Tauri IPC calls. Navigation is driven from Rust, so no window/shell permissions are needed.",
+  "windows": ["main"],
+  "permissions": ["core:default"]
+}
diff --git a/desktop/src-tauri/icons/128x128.png b/desktop/src-tauri/icons/128x128.png
new file mode 100644
index 0000000000000000000000000000000000000000..28f09f10c15d3315ce11b14a3da2d0bc054da8ba
GIT binary patch
literal 8161
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
Hu0mjfyA8==

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/icons/128x128@2x.png b/desktop/src-tauri/icons/128x128@2x.png
new file mode 100644
index 0000000000000000000000000000000000000000..ceff7febcabe0dfb1be7047f8a3500403c37b7e7
GIT binary patch
literal 15932
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
YIbXb3<W9Br?g|HFC6y$~#f$>~A9LECEC2ui

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/icons/32x32.png b/desktop/src-tauri/icons/32x32.png
new file mode 100644
index 0000000000000000000000000000000000000000..777c4bb931f38aada11883c2b61c1d3b2da27151
GIT binary patch
literal 1623
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
V_9DCf$sGUy002ovPDHLkV1gETB6I)%

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/icons/64x64.png b/desktop/src-tauri/icons/64x64.png
new file mode 100644
index 0000000000000000000000000000000000000000..f05ad3abee27a138ba3f42fcd54ce28589b1a8f1
GIT binary patch
literal 3830
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

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/icons/icon.icns b/desktop/src-tauri/icons/icon.icns
new file mode 100644
index 0000000000000000000000000000000000000000..f0a19c15bd28fbd964aee8aa621b1746bb2c27a2
GIT binary patch
literal 128538
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
a_WFOU7@vWSViTwU0000<MNUMnLSTZ7UpI{a

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/icons/icon.ico b/desktop/src-tauri/icons/icon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..744ad4993249e8e3164d83c15401444225a616bc
GIT binary patch
literal 27566
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

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/icons/icon.png b/desktop/src-tauri/icons/icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..2296301531bfa6622a670e96c96dfc0d0420f9f5
GIT binary patch
literal 3887
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
Coc$#L

literal 0
HcmV?d00001

diff --git a/desktop/src-tauri/src/main.rs b/desktop/src-tauri/src/main.rs
new file mode 100644
index 00000000..b43d5269
--- /dev/null
+++ b/desktop/src-tauri/src/main.rs
@@ -0,0 +1,228 @@
+// Gently desktop shell.
+//
+// A thin Tauri (WebView2) window that OWNS the Python backend. On launch it
+// spawns `launch_gently.py --no-browser`, shows a splash while uvicorn boots,
+// then navigates the window to the live UI (http://localhost:<port>). The whole
+// UI is served by Python — this shell holds no application logic.
+//
+// Process ownership: the Python child spawns its own device-layer grandchild
+// (via DeviceLayerSupervisor). To guarantee no orphans, on Windows we put the
+// spawned Python into a Job Object with JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE;
+// children inherit the job, so when this shell exits or crashes the OS reaps the
+// entire tree. See docs/superpowers/specs/2026-07-02-unified-launcher-design.md.
+//
+// Deferred (documented): bundling the Python environment for a redistributable
+// installer (embeddable Python / PyInstaller sidecar), and a graceful backend
+// shutdown handshake before the job hard-kills the tree.
+
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+use std::path::{Path, PathBuf};
+use std::process::{Child, Command};
+use std::sync::Mutex;
+use std::time::{Duration, Instant};
+
+use tauri::{Manager, RunEvent};
+
+/// Backend process + (Windows) the job that owns its tree, held for the app's
+/// whole lifetime as Tauri managed state.
+struct Backend {
+    child: Mutex<Option<Child>>,
+    #[cfg(windows)]
+    job: jobkill::Job,
+}
+
+fn main() {
+    #[cfg(windows)]
+    let job = jobkill::create_kill_on_close().expect("failed to create Job Object");
+
+    let backend = Backend {
+        child: Mutex::new(None),
+        #[cfg(windows)]
+        job,
+    };
+
+    tauri::Builder::default()
+        .manage(backend)
+        .setup(|app| {
+            let handle = app.handle().clone();
+            // Boot the backend off the UI thread so the splash paints immediately.
+            std::thread::spawn(move || boot_backend(handle));
+            Ok(())
+        })
+        .build(tauri::generate_context!())
+        .expect("error building the Gently desktop app")
+        .run(|app_handle, event| {
+            if let RunEvent::Exit = event {
+                let b = app_handle.state::<Backend>();
+                // Best-effort direct kill of the child we spawned...
+                if let Some(mut child) = b.child.lock().unwrap().take() {
+                    let _ = child.kill();
+                }
+                // ...and close the job handle, which kill-on-close uses to reap
+                // the whole tree (python + device-layer grandchild). Correct even
+                // if the child kill above missed a grandchild.
+                #[cfg(windows)]
+                jobkill::close(&b.job);
+            }
+        });
+}
+
+/// Spawn the Python backend, wait for its server, then navigate the window to it.
+fn boot_backend(app: tauri::AppHandle) {
+    let repo = repo_root();
+    let python = python_exe(&repo);
+
+    let mut args: Vec<String> = vec!["launch_gently.py".into(), "--no-browser".into()];
+    if let Ok(extra) = std::env::var("GENTLY_LAUNCH_ARGS") {
+        args.extend(extra.split_whitespace().map(str::to_string));
+    }
+
+    set_status(&app, "Starting the backend…");
+    eprintln!("[gently-desktop] spawning: {} {:?} (cwd={})", python.display(), args, repo.display());
+
+    let child = match Command::new(&python).args(&args).current_dir(&repo).spawn() {
+        Ok(c) => c,
+        Err(e) => {
+            set_status(&app, &format!("Failed to start backend: {e}"));
+            eprintln!("[gently-desktop] spawn failed: {e}");
+            return;
+        }
+    };
+
+    // Put the child in our kill-on-close job so its tree can't outlive us.
+    #[cfg(windows)]
+    {
+        let b = app.state::<Backend>();
+        if let Err(e) = jobkill::assign(&b.job, &child) {
+            eprintln!("[gently-desktop] job assign failed (continuing): {e:?}");
+        }
+    }
+    *app.state::<Backend>().child.lock().unwrap() = Some(child);
+
+    let port = viz_port();
+    set_status(&app, "Waiting for the server…");
+    if wait_for_port("127.0.0.1", port, 120) {
+        let url = format!("http://localhost:{port}");
+        eprintln!("[gently-desktop] backend up — navigating to {url}");
+        if let Some(win) = app.get_webview_window("main") {
+            match url.parse() {
+                Ok(u) => { let _ = win.navigate(u); }
+                Err(e) => set_status(&app, &format!("Bad backend URL: {e}")),
+            }
+        }
+    } else {
+        set_status(&app, "Backend did not become ready in time. Check the terminal log.");
+        eprintln!("[gently-desktop] timed out waiting for 127.0.0.1:{port}");
+    }
+}
+
+/// Repo root: `GENTLY_HOME` override, else the compile-time project root
+/// (desktop/src-tauri/../..). The compile-time path is correct for `tauri dev`
+/// and for a build run on this machine; a redistributable build should set
+/// `GENTLY_HOME` (or bundle Python — see the module header).
+fn repo_root() -> PathBuf {
+    if let Ok(p) = std::env::var("GENTLY_HOME") {
+        return PathBuf::from(p);
+    }
+    let manifest = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
+    let root = manifest.join("..").join("..");
+    std::fs::canonicalize(&root).unwrap_or(root)
+}
+
+/// Python interpreter: `GENTLY_PYTHON` override, else the repo venv, else PATH.
+fn python_exe(repo: &Path) -> PathBuf {
+    if let Ok(p) = std::env::var("GENTLY_PYTHON") {
+        return PathBuf::from(p);
+    }
+    let venv = repo.join(".venv").join("Scripts").join("python.exe");
+    if venv.exists() {
+        venv
+    } else {
+        PathBuf::from("python")
+    }
+}
+
+/// Viz port — mirrors the backend's `VIZ_PORT` env (default 8080).
+fn viz_port() -> u16 {
+    std::env::var("VIZ_PORT")
+        .ok()
+        .and_then(|s| s.parse().ok())
+        .unwrap_or(8080)
+}
+
+/// Poll a TCP port until something accepts, or `secs` elapse.
+fn wait_for_port(host: &str, port: u16, secs: u64) -> bool {
+    use std::net::TcpStream;
+    let addr: std::net::SocketAddr = match format!("{host}:{port}").parse() {
+        Ok(a) => a,
+        Err(_) => return false,
+    };
+    let deadline = Instant::now() + Duration::from_secs(secs);
+    while Instant::now() < deadline {
+        if TcpStream::connect_timeout(&addr, Duration::from_millis(800)).is_ok() {
+            return true;
+        }
+        std::thread::sleep(Duration::from_millis(700));
+    }
+    false
+}
+
+/// Update the splash status line via the JS hook it exposes.
+fn set_status(app: &tauri::AppHandle, msg: &str) {
+    if let Some(win) = app.get_webview_window("main") {
+        let safe = msg.replace('\\', "\\\\").replace('\'', "\\'");
+        let js = format!("window.__gentlyStatus && window.__gentlyStatus('{safe}')");
+        let _ = win.eval(js.as_str());
+    }
+}
+
+/// Windows Job Object helper — kill-on-close ownership of the backend tree.
+#[cfg(windows)]
+mod jobkill {
+    use std::ffi::c_void;
+    use std::os::windows::io::AsRawHandle;
+    use std::process::Child;
+
+    use windows::Win32::Foundation::{CloseHandle, HANDLE};
+    use windows::Win32::System::JobObjects::{
+        AssignProcessToJobObject, CreateJobObjectW, SetInformationJobObject,
+        JobObjectExtendedLimitInformation, JOBOBJECT_EXTENDED_LIMIT_INFORMATION,
+        JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE,
+    };
+
+    /// Owns a job HANDLE. `Send`/`Sync` so it can live in Tauri managed state;
+    /// the handle is only touched from create/assign/close.
+    pub struct Job(pub HANDLE);
+    unsafe impl Send for Job {}
+    unsafe impl Sync for Job {}
+
+    pub fn create_kill_on_close() -> windows::core::Result<Job> {
+        unsafe {
+            let job = CreateJobObjectW(None, None)?;
+            let mut info = JOBOBJECT_EXTENDED_LIMIT_INFORMATION::default();
+            info.BasicLimitInformation.LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE;
+            SetInformationJobObject(
+                job,
+                JobObjectExtendedLimitInformation,
+                &info as *const _ as *const c_void,
+                std::mem::size_of::<JOBOBJECT_EXTENDED_LIMIT_INFORMATION>() as u32,
+            )?;
+            Ok(Job(job))
+        }
+    }
+
+    /// Assign a freshly-spawned child to the job. Its own children inherit the
+    /// job (Windows default), so grandchildren are covered too.
+    pub fn assign(job: &Job, child: &Child) -> windows::core::Result<()> {
+        unsafe { AssignProcessToJobObject(job.0, HANDLE(child.as_raw_handle())) }
+    }
+
+    /// Close the job handle. With kill-on-close, this terminates every process
+    /// still in the job.
+    pub fn close(job: &Job) {
+        unsafe {
+            let _ = CloseHandle(job.0);
+        }
+    }
+}
diff --git a/desktop/src-tauri/tauri.conf.json b/desktop/src-tauri/tauri.conf.json
new file mode 100644
index 00000000..d7dc638e
--- /dev/null
+++ b/desktop/src-tauri/tauri.conf.json
@@ -0,0 +1,38 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "productName": "Gently",
+  "version": "0.1.0",
+  "identifier": "org.janelia.gently.desktop",
+  "build": {
+    "frontendDist": "../splash"
+  },
+  "app": {
+    "windows": [
+      {
+        "label": "main",
+        "title": "Gently",
+        "width": 1440,
+        "height": 920,
+        "minWidth": 900,
+        "minHeight": 600,
+        "resizable": true,
+        "visible": true,
+        "center": true
+      }
+    ],
+    "security": {
+      "csp": null
+    }
+  },
+  "bundle": {
+    "active": true,
+    "targets": ["nsis"],
+    "icon": [
+      "icons/32x32.png",
+      "icons/128x128.png",
+      "icons/128x128@2x.png",
+      "icons/icon.icns",
+      "icons/icon.ico"
+    ]
+  }
+}
diff --git a/gently/app/device_supervisor.py b/gently/app/device_supervisor.py
index 5f7c01a7..0ec52747 100644
--- a/gently/app/device_supervisor.py
+++ b/gently/app/device_supervisor.py
@@ -27,6 +27,7 @@
 
 import atexit
 import logging
+import os
 import signal
 import socket
 import subprocess
@@ -104,8 +105,12 @@ def start(self, *, sam_device: str | None = None, config_path: str | None = None
                 )
                 return self._status_locked()
 
-            if not _DEVICE_SCRIPT.exists():
-                raise FileNotFoundError(f"device layer script not found: {_DEVICE_SCRIPT}")
+            # GENTLY_DEVICE_LAYER_SCRIPT overrides the launcher — lets an operator
+            # point at an alternate device-layer entry point (and lets tests point
+            # at a harmless stand-in instead of touching real hardware).
+            script = Path(os.environ.get("GENTLY_DEVICE_LAYER_SCRIPT") or _DEVICE_SCRIPT)
+            if not script.exists():
+                raise FileNotFoundError(f"device layer script not found: {script}")
 
             if sam_device is not None:
                 self.sam_device = sam_device
@@ -114,7 +119,7 @@ def start(self, *, sam_device: str | None = None, config_path: str | None = None
 
             cmd = [
                 sys.executable,
-                str(_DEVICE_SCRIPT),
+                str(script),
                 "--port",
                 str(self.port),
                 "--sam-device",
diff --git a/gently/ui/web/static/css/main.css b/gently/ui/web/static/css/main.css
index 2c7751aa..01115260 100644
--- a/gently/ui/web/static/css/main.css
+++ b/gently/ui/web/static/css/main.css
@@ -9427,6 +9427,54 @@ body.modal-open {
 .devices-status-pill.stale { background: rgba(210, 153, 34, 0.2); color: var(--accent-orange, #d29922); }
 .devices-status-pill.error { background: rgba(248, 81, 73, 0.2); color: #f85149; }
 
+/* Device-layer supervision card (device-layer.js) */
+.devices-layer-card {
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    padding: 0.6rem 0.9rem;
+    margin: 0.75rem 0 0.25rem;
+}
+.devices-layer-head {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    flex-wrap: wrap;
+}
+.devices-layer-head .devices-card-title { margin-bottom: 0; }
+.devices-layer-meta {
+    font-family: 'SF Mono', 'Consolas', monospace;
+    font-size: 0.72rem;
+    color: var(--text-muted);
+    font-variant-numeric: tabular-nums;
+}
+.devices-layer-hint {
+    font-size: 0.72rem;
+    color: var(--text-muted);
+}
+.devices-layer-actions {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    margin-top: 0.55rem;
+    flex-wrap: wrap;
+}
+.devices-layer-log {
+    margin: 0.55rem 0 0;
+    padding: 0.5rem 0.65rem;
+    max-height: 220px;
+    overflow: auto;
+    background: var(--bg-hover);
+    border: 1px solid var(--border);
+    border-radius: 5px;
+    font-family: 'SF Mono', 'Consolas', monospace;
+    font-size: 0.7rem;
+    line-height: 1.5;
+    color: var(--text-muted);
+    white-space: pre-wrap;
+    word-break: break-word;
+}
+
 .devices-positions {
     display: grid;
     grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
diff --git a/gently/ui/web/static/js/device-layer.js b/gently/ui/web/static/js/device-layer.js
new file mode 100644
index 00000000..f3551be3
--- /dev/null
+++ b/gently/ui/web/static/js/device-layer.js
@@ -0,0 +1,242 @@
+/**
+ * Device-layer supervision card (Devices tab).
+ *
+ * The runtime mirror of the launch gate's hardware block: shows whether the
+ * device layer is running / stopped / external / crashed, lets an operator
+ * Start or Stop it from the UI, and tails its console. Consumes the routes
+ * added in gently/ui/web/routes/device_layer.py:
+ *
+ *   GET  /api/device-layer/status  -> {state, managed, pid, port, port_open,
+ *                                       sam_device, uptime_seconds, log_tail[]}
+ *   GET  /api/device-layer/log?limit=N -> {lines: [...]}
+ *   POST /api/device-layer/start   (control-gated)  body {sam_device?, config_path?}
+ *   POST /api/device-layer/stop    (control-gated)  body {confirm?, force?}
+ *                                   -> 409 {blocked:true,...} mid-acquisition
+ *
+ * Self-contained IIFE (no devices.js internals). Polls only while the Devices
+ * tab is visible (ClientEventBus 'TAB_CHANGED'). Control auth is transparent:
+ * a same-origin fetch carries the gently_session cookie, and control-auth.js
+ * already toasts on a bare 403, so Start/Stop need no credential code.
+ */
+const DeviceLayerCard = (function () {
+    const POLL_MS = 5000;
+
+    // state -> [pill modifier class, label]. Mirrors the header pill states.
+    const PILL = {
+        running:  ['live',   'running'],
+        external: ['paused', 'external'],
+        stopped:  ['',       'stopped'],
+        crashed:  ['error',  'crashed'],
+    };
+
+    let _card, _pill, _meta, _start, _stop, _logToggle, _log, _hint;
+    let _timer = null;
+    let _busy = false;   // a start/stop is in flight
+    let _dom = false;
+
+    function cacheDom() {
+        if (_dom) return;
+        _card = document.getElementById('devices-layer-card');
+        if (!_card) return;              // markup absent -> stay inert
+        _pill      = document.getElementById('devices-layer-pill');
+        _meta      = document.getElementById('devices-layer-meta');
+        _start     = document.getElementById('devices-layer-start');
+        _stop      = document.getElementById('devices-layer-stop');
+        _logToggle = document.getElementById('devices-layer-log-toggle');
+        _log       = document.getElementById('devices-layer-log');
+        _hint      = document.getElementById('devices-layer-hint');
+        _dom = true;
+    }
+
+    function init() {
+        cacheDom();
+        if (!_card) return;
+        _start.addEventListener('click', onStart);
+        _stop.addEventListener('click', onStop);
+        _logToggle.addEventListener('click', toggleLog);
+
+        // Poll only while the Devices tab is showing. switchTab() emits
+        // TAB_CHANGED with the *new* tab id (no leave signal), so compare
+        // against TABS.DEVICES to derive both enter and exit.
+        if (typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.on('TAB_CHANGED', (tab) => {
+                if (tab === TABS.DEVICES) startPoll();
+                else stopPoll();
+            });
+        }
+        // Seed if Devices is already the active tab (reload / deep link) —
+        // TAB_CHANGED does not fire for the landing tab.
+        const content = document.getElementById('devices-content');
+        if (content && content.classList.contains('active')) startPoll();
+    }
+
+    // ── polling ──────────────────────────────────────────────────────────
+
+    function startPoll() {
+        loadStatus();                       // immediate
+        if (_timer) clearInterval(_timer);  // clear-before-set
+        _timer = setInterval(loadStatus, POLL_MS);
+    }
+
+    function stopPoll() {
+        if (_timer) { clearInterval(_timer); _timer = null; }
+    }
+
+    async function loadStatus() {
+        if (!_card) return;
+        try {
+            const res = await fetch('/api/device-layer/status');
+            if (!res.ok) return;            // keep last-known UI
+            apply(await res.json());
+        } catch (e) {
+            console.debug('device-layer status poll failed', e);
+        }
+    }
+
+    // ── render ───────────────────────────────────────────────────────────
+
+    function apply(d) {
+        _card.hidden = false;
+        const [mod, label] = PILL[d.state] || ['stale', d.state || 'unknown'];
+        _pill.className = 'devices-status-pill' + (mod ? ' ' + mod : '');
+        _pill.textContent = label;
+
+        const bits = [];
+        if (d.pid) bits.push('pid ' + d.pid);
+        if (d.port) bits.push('port ' + d.port + (d.port_open ? '' : ' · closed'));
+        if (d.sam_device) bits.push(d.sam_device);
+        if (typeof d.uptime_seconds === 'number') bits.push('up ' + fmtUptime(d.uptime_seconds));
+        _meta.textContent = bits.join(' · ');
+
+        // An external (unmanaged) layer can't be started or stopped by us.
+        if (d.state === 'external') {
+            _hint.hidden = false;
+            _hint.textContent = 'running externally — not managed by gently';
+        } else {
+            _hint.hidden = true;
+            _hint.textContent = '';
+        }
+
+        // Enable/disable by state (a hint only; the server 403/409 is the real
+        // gate). While a start/stop is in flight, keep both disabled.
+        const running = d.state === 'running';
+        const external = d.state === 'external';
+        const stoppedish = d.state === 'stopped' || d.state === 'crashed';
+        _start.disabled = _busy || running || external;
+        _stop.disabled  = _busy || stoppedish || external;
+
+        if (Array.isArray(d.log_tail) && d.log_tail.length && !_log.hidden) {
+            renderLog(d.log_tail);
+        }
+    }
+
+    function fmtUptime(s) {
+        s = Math.max(0, Math.floor(s));
+        if (s < 60) return s + 's';
+        if (s < 3600) return Math.floor(s / 60) + 'm ' + (s % 60) + 's';
+        return Math.floor(s / 3600) + 'h ' + Math.floor((s % 3600) / 60) + 'm';
+    }
+
+    // ── start / stop ─────────────────────────────────────────────────────
+
+    async function onStart() {
+        if (_start.disabled) return;
+        _busy = true;
+        _start.disabled = true;
+        try {
+            await postJSON('/api/device-layer/start', {});
+            toast('Device layer starting…');
+        } catch (e) {
+            // 403 already surfaced by control-auth.js; don't double-toast.
+            if (e.status !== 403) toast('Start failed: ' + e.message);
+        } finally {
+            _busy = false;
+            // The layer takes a moment to bind its port; re-poll shortly.
+            setTimeout(loadStatus, 800);
+            loadStatus();
+        }
+    }
+
+    async function onStop() {
+        if (_stop.disabled) return;
+        if (!window.confirm('Stop the device layer?')) return;
+        _busy = true;
+        _stop.disabled = true;
+        try {
+            await postJSON('/api/device-layer/stop', { confirm: true });
+            toast('Device layer stopping…');
+        } catch (e) {
+            if (e.status === 409 && e.payload && e.payload.blocked) {
+                // Mid-acquisition soft block — offer an explicit force-stop.
+                if (window.confirm('A run is active. Force-stop the device layer anyway?')) {
+                    try {
+                        await postJSON('/api/device-layer/stop', { confirm: true, force: true });
+                        toast('Force-stopping…');
+                    } catch (e2) {
+                        if (e2.status !== 403) toast('Force-stop failed: ' + e2.message);
+                    }
+                }
+            } else if (e.status !== 403) {
+                toast('Stop failed: ' + e.message);
+            }
+        } finally {
+            _busy = false;
+            setTimeout(loadStatus, 500);
+            loadStatus();
+        }
+    }
+
+    // POST JSON; on !ok throw an Error carrying .status and parsed .payload so
+    // callers can branch on 409/403 (mirrors operate.js's postJSON convention).
+    async function postJSON(url, body) {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body || {}),
+        });
+        if (!res.ok) {
+            let payload = {};
+            try { payload = await res.json(); } catch (_) { /* non-JSON */ }
+            const err = new Error(payload.error || payload.reason || res.statusText);
+            err.status = res.status;
+            err.payload = payload;
+            throw err;
+        }
+        return res.json();
+    }
+
+    // ── log tail ─────────────────────────────────────────────────────────
+
+    function toggleLog() {
+        const show = _log.hidden;
+        _log.hidden = !show;
+        _logToggle.setAttribute('aria-expanded', String(show));
+        _logToggle.classList.toggle('active', show);
+        if (show) loadFullLog();
+    }
+
+    async function loadFullLog() {
+        try {
+            const res = await fetch('/api/device-layer/log?limit=200');
+            if (!res.ok) return;
+            const d = await res.json();
+            if (Array.isArray(d.lines)) renderLog(d.lines);
+        } catch (e) {
+            console.debug('device-layer log fetch failed', e);
+        }
+    }
+
+    function renderLog(lines) {
+        if (!_log) return;
+        _log.textContent = lines.join('\n');
+        _log.scrollTop = _log.scrollHeight;   // pin to newest
+    }
+
+    function toast(msg) {
+        if (typeof showGentlyToast === 'function') showGentlyToast(msg);
+    }
+
+    return { init };
+})();
+
+document.addEventListener('DOMContentLoaded', () => DeviceLayerCard.init());
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index af177670..8ad9cba4 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -484,6 +484,26 @@ <h2 class="devices-title"><span class="devices-title-script">Device</span> <em c
                 </div>
             </div>
 
+            <!-- Device-layer supervision card (device-layer.js) — runtime mirror
+                 of the launch gate's hardware block: status + Start/Stop + log tail. -->
+            <div class="devices-layer-card" id="devices-layer-card" hidden>
+                <div class="devices-layer-head">
+                    <span class="devices-card-title">Device Layer</span>
+                    <span class="devices-status-pill" id="devices-layer-pill">unknown</span>
+                    <span class="devices-layer-meta" id="devices-layer-meta"></span>
+                    <span class="devices-layer-hint" id="devices-layer-hint" hidden></span>
+                </div>
+                <div class="devices-layer-actions">
+                    <button type="button" class="marking-action-btn marking-done-btn devices-layer-btn"
+                            id="devices-layer-start">Start</button>
+                    <button type="button" class="marking-action-btn devices-layer-btn"
+                            id="devices-layer-stop">Stop</button>
+                    <button type="button" class="marking-action-btn devices-layer-log-toggle"
+                            id="devices-layer-log-toggle" aria-expanded="false">Log</button>
+                </div>
+                <pre class="devices-layer-log" id="devices-layer-log" hidden></pre>
+            </div>
+
             <!-- Operate view: guided bottom-cam → SPIM operator surface.
                  Survey & mark all → per-embryo center → lower SPIM → focus → acquire. -->
             <div class="devices-view devices-view-operate" id="devices-view-operate" style="display:none">
@@ -1365,6 +1385,7 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
     <script src="/static/js/temperature-graph.js"></script>
     <script src="/static/js/devices.js"></script>
     <script src="/static/js/operate.js"></script>
+    <script src="/static/js/device-layer.js"></script>
     <script src="/static/js/operations-scenarios.js"></script>
     <script src="/static/js/experiment-overview.js"></script>
     <!-- Three.js for 3D volume viewer -->

From 461c93e0af41010047c363cf4de4c0ba6596e43a Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 04:20:02 -0400
Subject: [PATCH 306/314] feat(launcher+desktop): --reload dev flag + npm
 scripts + dev workflow docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- launch_gently.py: add --reload. Watches gently/**.py + launch_gently.py
  (watchfiles) and restarts the whole backend on change, so edits show up on a
  page refresh. gently's app is built from runtime state (agent/store/mesh), so
  there's no static import for uvicorn's native reloader — this is a full backend
  restart, meant for UI/backend dev, not live hardware. Verified: editing a route
  restarts the server (new PID).
- desktop/package.json: add `npm run dev` (tauri dev) and `npm run build`
  (tauri build) so setup is one command.
- desktop/README: rewrite Run/Build around npm scripts and add a "what reflects
  when you edit code" section (web = Ctrl+R, python = --reload+refresh, rust =
  auto-rebuild).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 desktop/README.md    | 51 +++++++++++++++++++++++++--------
 desktop/package.json |  4 ++-
 launch_gently.py     | 67 ++++++++++++++++++++++++++++++++++++--------
 3 files changed, 97 insertions(+), 25 deletions(-)

diff --git a/desktop/README.md b/desktop/README.md
index f9ad9943..129bac7c 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -47,27 +47,54 @@ Tauri shell (Rust, WebView2 window)
 
 ## Run (dev)
 
-```bash
+```powershell
 cd desktop
-npm install                      # once — installs @tauri-apps/cli
-# UI-only smoke test (no hardware, no API key, no login):
-GENTLY_LAUNCH_ARGS="--no-api --offline --no-auth" npx tauri dev
-# Full app (needs ANTHROPIC_API_KEY in the environment / repo .env):
-npx tauri dev
+npm install          # once — restores the Tauri CLI
+npm run dev          # build + launch the shell (spawns the backend for you)
 ```
 
-`tauri dev` builds and launches the shell; it spawns the backend for you.
+`npm run dev` (= `tauri dev`) compiles the shell, opens the window, spawns
+`launch_gently.py --no-browser`, and navigates to the live UI once it's up.
+
+UI-only (no hardware / API key / login) — handy for pure UI work:
+
+```powershell
+$env:GENTLY_LAUNCH_ARGS="--no-api --offline --no-auth"; npm run dev
+```
+
+## Making code changes — what reflects, and how
+
+The window is just a WebView pointed at the Python server, so it splits in three:
+
+| You edit… | Reflects by… | Rebuild? |
+|---|---|---|
+| **Web UI** (`gently/ui/web/templates`, `static/js`, `static/css`) | **Refresh the window** (Ctrl+R) | no — served live by Python |
+| **Python backend** (`gently/**/*.py`, `launch_gently.py`) | restart the backend — or run with **`--reload`** (below), then Ctrl+R | process restart |
+| **Rust shell / config** (`src-tauri/`, `splash/`) | `npm run dev` **auto-rebuilds + relaunches** | automatic (watched) |
+
+**Python hot-reload.** Pass `--reload` and the backend auto-restarts whenever a
+`gently/*.py` file changes (watchfiles) — then just Ctrl+R the window:
+
+```powershell
+$env:GENTLY_LAUNCH_ARGS="--reload --no-api --offline --no-auth"; npm run dev
+# or, iterating in a plain browser instead of the shell:
+uv run python launch_gently.py --reload
+```
+
+It restarts the *whole* backend (a few seconds), so use it for UI / backend dev,
+not live hardware sessions.
 
 ## Build (installer)
 
-```bash
+```powershell
 cd desktop
-npx tauri build                  # produces an NSIS installer under src-tauri/target/release/bundle/
+npm run build        # = tauri build — NSIS installer under src-tauri/target/release/bundle/
 ```
 
-The built app launches the **repo's** `.venv` + `launch_gently.py` (paths baked
-at compile time / overridable — see env vars). It is a single-machine build
-until Python bundling lands.
+Then Gently installs like any Windows app (Start-Menu entry, double-click — no
+terminal). The built app launches the **repo's** `.venv` + `launch_gently.py`
+(paths baked at compile time / overridable — see env vars); it's a single-machine
+build until Python bundling lands.
 
 ## Configuration (env vars read by the shell)
 
diff --git a/desktop/package.json b/desktop/package.json
index 7c30a7fe..0173efb1 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -4,7 +4,9 @@
   "private": true,
   "description": "Tauri desktop shell for gently (owns the Python backend + device layer)",
   "scripts": {
-    "tauri": "tauri"
+    "tauri": "tauri",
+    "dev": "tauri dev",
+    "build": "tauri build"
   },
   "devDependencies": {
     "@tauri-apps/cli": "^2.11.4"
diff --git a/launch_gently.py b/launch_gently.py
index 7ba28534..85d591d9 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -645,6 +645,37 @@ def _sig(*_a):
                 pass
 
 
+def _serve(**main_kwargs) -> None:
+    """Run one backend lifetime — the reload child's entry point."""
+    try:
+        asyncio.run(main(**main_kwargs))
+    except (KeyboardInterrupt, RuntimeError, SystemExit):
+        pass
+
+
+def _run_with_reload(main_kwargs: dict) -> None:
+    """Dev auto-restart: re-run the backend whenever a gently/*.py file changes.
+
+    Uses watchfiles (the same watcher uvicorn --reload uses) to run the server in
+    a child process and restart it on any .py change under gently/ (or
+    launch_gently.py). This is a WHOLE-backend restart, not an in-place reload —
+    gently's app is built from runtime state (agent, store, mesh), so there is no
+    static import for uvicorn's native reloader to hot-swap. A running device
+    layer restarts too, so this is for UI / backend dev, not live hardware.
+    After a restart, refresh the browser / Tauri window (Ctrl+R) to see changes.
+    """
+    from watchfiles import PythonFilter, run_process
+
+    root = Path(__file__).resolve().parent
+    paths = [str(root / "gently"), str(root / "launch_gently.py")]
+    print(
+        "[reload] watching gently/ + launch_gently.py — edit a .py file and the "
+        "backend restarts (then refresh the page)",
+        flush=True,
+    )
+    run_process(*paths, target=_serve, kwargs=main_kwargs, watch_filter=PythonFilter())
+
+
 def cli_main():
     """Sync entry point for ``gently`` console script (pyproject.toml)."""
     parser = argparse.ArgumentParser(description="Launch Microscopy Agent")
@@ -677,6 +708,12 @@ def cli_main():
         action="store_true",
         help="Do not auto-open the web UI in a browser",
     )
+    parser.add_argument(
+        "--reload",
+        action="store_true",
+        help="Dev: auto-restart the backend when a gently/*.py file changes "
+        "(watchfiles). Restarts the whole backend — not for live hardware.",
+    )
     args = parser.parse_args()
 
     # An API key is required unless running in UI-only mode.
@@ -699,19 +736,25 @@ def cli_main():
     pick_session = args.resume == "__PICK__"
     resume_id = args.resume if args.resume and args.resume != "__PICK__" else None
 
+    main_kwargs = dict(
+        offline=args.offline,
+        show_sessions=args.sessions,
+        resume_session=resume_id,
+        pick_session=pick_session,
+        log_level=log_level,
+        no_browser=args.no_browser,
+        no_api=args.no_api,
+        no_auth=args.no_auth,
+    )
+
+    # Dev: auto-restart the backend on gently/*.py changes (refresh the page to
+    # pick them up). Runs the server in a watchfiles-managed child process.
+    if args.reload:
+        _run_with_reload(main_kwargs)
+        return
+
     try:
-        asyncio.run(
-            main(
-                offline=args.offline,
-                show_sessions=args.sessions,
-                resume_session=resume_id,
-                pick_session=pick_session,
-                log_level=log_level,
-                no_browser=args.no_browser,
-                no_api=args.no_api,
-                no_auth=args.no_auth,
-            )
-        )
+        asyncio.run(main(**main_kwargs))
     except (KeyboardInterrupt, RuntimeError, SystemExit):
         pass
 

From eaa778f0149db29ac3365fb82c0adf837cea319a Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 04:34:18 -0400
Subject: [PATCH 307/314] feat(desktop): hide backend console window + document
 desktop app in CLAUDE.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- main.rs: spawn the Python backend with CREATE_NO_WINDOW in release builds so a
  console window doesn't pop up alongside the Gently window when launched from the
  desktop shortcut. Debug (`tauri dev`) still inherits the console so logs stay
  visible. Verified: release launch shows only the "Gently" window (0 console
  windows).
- device_supervisor.py: same CREATE_NO_WINDOW on the device-layer spawn so starting
  hardware from the desktop app doesn't pop a console either (output still captured
  via the stdout pipe + device_layer_*.log).
- CLAUDE.md: add a "Desktop App (Tauri)" section — build/run (npm run dev/build),
  architecture (Job Object teardown, no-console), the edit-reflect model, and shell
  env config; points to desktop/README.md for depth.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md                       | 45 +++++++++++++++++++++++++++++++++
 desktop/src-tauri/src/main.rs   | 14 +++++++++-
 gently/app/device_supervisor.py | 10 ++++++--
 3 files changed, 66 insertions(+), 3 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 15301c4b..397f180d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -96,6 +96,51 @@ Perception is handled by `gently-perception` (separate repo: `pskeshu/gently-per
 
 The device layer runs as a separate process (`python start_device_layer.py`). It communicates with the agent via HTTP. Bluesky plans require ophyd device name kwargs (e.g. `xy_stage='xy_stage'`, `volume_scanner='volume_scanner'`) — these must match the device names registered in `device_factory.py`.
 
+## Desktop App (Tauri)
+
+Gently can run as a Windows desktop app — a thin Tauri (WebView2) shell in
+`desktop/` that OWNS the Python backend. It spawns `launch_gently.py --no-browser`,
+shows a splash, then renders the live web UI (`http://localhost:8080`) in a native
+window. The Python-served web UI stays the single source of truth — no app logic
+lives in the shell. Full detail: `desktop/README.md`.
+
+### Build / run
+```
+cd desktop
+npm install        # once — restores the Tauri CLI
+npm run dev        # dev: build + launch (spawns the backend for you)
+npm run build      # release: NSIS installer under src-tauri/target/release/bundle/
+```
+Prereqs: Rust (MSVC toolchain), the repo's uv `.venv`, WebView2 runtime (inbox on
+Win 11). The **release** exe (`src-tauri/target/release/gently-desktop.exe`) is what
+the Desktop shortcut points at; rebuild with `npm run build` to refresh it.
+
+### Key pieces
+- `desktop/src-tauri/src/main.rs` — spawns the backend, waits for the server,
+  navigates the window to it, owns teardown.
+- **No orphans:** the spawned Python (and its device-layer grandchild) run in a
+  Windows Job Object with `KILL_ON_JOB_CLOSE`, so quitting/crashing the shell reaps
+  the whole tree.
+- **No console window:** the backend is spawned with `CREATE_NO_WINDOW` in release
+  (the device-layer supervisor does the same); `tauri dev` keeps the console so
+  logs stay visible while developing.
+
+### Editing code — what reflects
+- **Web UI** (`gently/ui/web/templates`, `static/js`, `static/css`): refresh the
+  window (Ctrl+R) — served live by Python, no rebuild.
+- **Python backend**: restart it, or run with `--reload`
+  (`launch_gently.py --reload`, or `GENTLY_LAUNCH_ARGS="--reload …"`) to auto-restart
+  on `gently/*.py` changes, then Ctrl+R. Whole-backend restart — not for live hardware.
+- **Rust shell / `tauri.conf.json`**: `npm run dev` auto-rebuilds and relaunches.
+
+### Shell env config (read by `main.rs`)
+`GENTLY_HOME` (repo dir), `GENTLY_PYTHON` (interpreter), `GENTLY_LAUNCH_ARGS`
+(extra `launch_gently` args), `VIZ_PORT` (default 8080), `GENTLY_DEVICE_LAYER_SCRIPT`.
+
+### Deferred
+Bundling the Python env (torch/anthropic/perception) for a redistributable
+installer — today's build launches the repo's `.venv`, so it's single-machine.
+
 ## Debugging Data Sources
 
 - **Agent logs**: `D:\Gently3\logs\gently_*.log`
diff --git a/desktop/src-tauri/src/main.rs b/desktop/src-tauri/src/main.rs
index b43d5269..e6472a5d 100644
--- a/desktop/src-tauri/src/main.rs
+++ b/desktop/src-tauri/src/main.rs
@@ -81,7 +81,19 @@ fn boot_backend(app: tauri::AppHandle) {
     set_status(&app, "Starting the backend…");
     eprintln!("[gently-desktop] spawning: {} {:?} (cwd={})", python.display(), args, repo.display());
 
-    let child = match Command::new(&python).args(&args).current_dir(&repo).spawn() {
+    let mut cmd = Command::new(&python);
+    cmd.args(&args).current_dir(&repo);
+    // Release: run the console-subsystem Python backend WITHOUT a console window
+    // (a GUI parent would otherwise pop one). Debug (`tauri dev`) inherits the dev
+    // console so backend logs stay visible while developing.
+    #[cfg(all(windows, not(debug_assertions)))]
+    {
+        use std::os::windows::process::CommandExt;
+        const CREATE_NO_WINDOW: u32 = 0x0800_0000;
+        cmd.creation_flags(CREATE_NO_WINDOW);
+    }
+
+    let child = match cmd.spawn() {
         Ok(c) => c,
         Err(e) => {
             set_status(&app, &format!("Failed to start backend: {e}"));
diff --git a/gently/app/device_supervisor.py b/gently/app/device_supervisor.py
index 0ec52747..99750213 100644
--- a/gently/app/device_supervisor.py
+++ b/gently/app/device_supervisor.py
@@ -130,10 +130,16 @@ def start(self, *, sam_device: str | None = None, config_path: str | None = None
 
             # A new process group on Windows is what later lets us send a
             # CTRL_BREAK for a (best-effort) clean shutdown instead of only a
-            # hard TerminateProcess.
+            # hard TerminateProcess. CREATE_NO_WINDOW keeps the device layer from
+            # popping its own console window when gently is launched as a desktop
+            # app — its output is still captured via the stdout pipe (below) and
+            # its own device_layer_*.log.
             creationflags = 0
             if sys.platform == "win32":
-                creationflags = subprocess.CREATE_NEW_PROCESS_GROUP  # type: ignore[attr-defined]
+                creationflags = (
+                    subprocess.CREATE_NEW_PROCESS_GROUP  # type: ignore[attr-defined]
+                    | subprocess.CREATE_NO_WINDOW  # type: ignore[attr-defined]
+                )
 
             logger.info("Spawning device layer: %s", " ".join(cmd))
             self._log.clear()

From 8eaab88f201bba289ea818be1f96898f326fa3c6 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 05:16:39 -0400
Subject: [PATCH 308/314] fix(lint+types): satisfy ruff + mypy on the
 device-layer code (RFC #78)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CI (lint + mypy-strict) flagged the new #78 code:
- device_layer.py: B008 — move require_control from a Depends() default param to
  the router decorator's dependencies=[...] (the codebase's convention), on all
  three control-gated POSTs.
- device_supervisor.py: E501 (wrap the multi-line elif) + mypy union-attr
  (assert self._proc is not None after _alive(), which guarantees it) + ruff format.
- server.py: declare device_supervisor: Any = None alongside agent_bridge /
  mesh_service so launch_gently's assignment type-checks.

ruff check + ruff format now pass; #78 adds zero net mypy errors.
---
 gently/app/device_supervisor.py      |  5 ++++-
 gently/ui/web/routes/device_layer.py | 14 +++++++-------
 gently/ui/web/server.py              |  1 +
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/gently/app/device_supervisor.py b/gently/app/device_supervisor.py
index 99750213..813e3996 100644
--- a/gently/app/device_supervisor.py
+++ b/gently/app/device_supervisor.py
@@ -93,6 +93,7 @@ def start(self, *, sam_device: str | None = None, config_path: str | None = None
         """
         with self._lock:
             if self._alive():
+                assert self._proc is not None  # _alive() guarantees this
                 logger.debug("Device layer already managed (pid=%s)", self._proc.pid)
                 return self._status_locked()
 
@@ -245,7 +246,9 @@ def _status_locked(self) -> dict:
 
         if managed_alive:
             state = "running"
-        elif self._proc is not None and self._proc.returncode not in (None, 0) and not self._stopping:
+        elif (
+            self._proc is not None and self._proc.returncode not in (None, 0) and not self._stopping
+        ):
             state = "crashed"
         elif port_open:
             state = "external"
diff --git a/gently/ui/web/routes/device_layer.py b/gently/ui/web/routes/device_layer.py
index 8f8dbf0f..f3d5850f 100644
--- a/gently/ui/web/routes/device_layer.py
+++ b/gently/ui/web/routes/device_layer.py
@@ -70,8 +70,8 @@ async def get_launch_prefs():
         """Persisted launch choices (hardware/agent toggles + advanced defaults)."""
         return load_prefs()
 
-    @router.post("/api/launch/prefs")
-    async def set_launch_prefs(request: Request, _=Depends(require_control)):
+    @router.post("/api/launch/prefs", dependencies=[Depends(require_control)])
+    async def set_launch_prefs(request: Request):
         """Persist launch choices; returns the merged result."""
         body = await request.json()
         return save_prefs(body if isinstance(body, dict) else {})
@@ -88,8 +88,8 @@ async def device_layer_log(limit: int = 200):
         """Recent captured console output (oldest → newest) for the console view."""
         return {"lines": get_supervisor(server).log_tail(limit)}
 
-    @router.post("/api/device-layer/start")
-    async def device_layer_start(request: Request, _=Depends(require_control)):
+    @router.post("/api/device-layer/start", dependencies=[Depends(require_control)])
+    async def device_layer_start(request: Request):
         """Spawn (or adopt-if-external) the device layer per the request body.
 
         Body (all optional): ``{"sam_device": "cuda"|"cpu", "config_path": "..."}``.
@@ -106,8 +106,8 @@ async def device_layer_start(request: Request, _=Depends(require_control)):
             return JSONResponse({"error": str(e)}, status_code=500)
         return status
 
-    @router.post("/api/device-layer/stop")
-    async def device_layer_stop(request: Request, _=Depends(require_control)):
+    @router.post("/api/device-layer/stop", dependencies=[Depends(require_control)])
+    async def device_layer_stop(request: Request):
         """Stop the managed device layer, with a mid-run confirmation guard.
 
         If hardware looks active and the body doesn't carry ``{"confirm": true}``,
@@ -122,7 +122,7 @@ async def device_layer_stop(request: Request, _=Depends(require_control)):
                 {
                     "blocked": True,
                     "reason": "hardware is active — an acquisition is running",
-                    "hint": "resend with {\"confirm\": true} to stop anyway",
+                    "hint": 'resend with {"confirm": true} to stop anyway',
                 },
                 status_code=409,
             )
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index aa36ea0c..d8ab2652 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -164,6 +164,7 @@ def __init__(
         # Wired in by launch_gently after construction (optional subsystems).
         self.agent_bridge: Any = None
         self.mesh_service: Any = None
+        self.device_supervisor: Any = None  # DeviceLayerSupervisor (RFC #78)
 
         # Connection manager for WebSocket clients
         self.manager = ConnectionManager()

From ab2bf58e2f8ec32e8e17c52f513066b66a01751d Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 07:40:30 -0400
Subject: [PATCH 309/314] feat(launcher): entry-point gate + startup-progress
 pipeline (RFC #78)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Makes the launch gate the real entry point and gives the device-layer boot a
staged, plain-language progress readout — per the biologist/UX/biotech design
consults.

Backend startup progress:
- console_ui.progress_event() emits @@GENTLY_PROGRESS@@ {json} on stdout at each
  [N/5] cui.step/step_done (gated on non-TTY, so only the supervisor-captured
  pipe sees it). start_device_layer emits a structured failure event with the
  plain-language reason + hints.
- DeviceLayerSupervisor parses those into _progress/_failure (atomic ref swaps),
  spawns the child unbuffered (-u), and exposes a real lifecycle:
  stopped → starting → initializing(step i/n) → ready(port open) → failed(reason)
  / crashed / external. Verified end-to-end with a progress-emitting stand-in.

Entry point + gate:
- / bounces to /launch until the gate is submitted (server.gate_passed);
  POST /api/launch/go persists the toggles, marks passed, and starts the device
  layer if the microscope toggle is on — returning fast (spawn only) so the UI
  hands off to the dashboard immediately and follows the boot there.
- launch.html rewritten: theme-aware (matches the app's light/dark, no more
  dark→light flash), plain wording ("Connect to the microscope this session"),
  role=switch + keyboard/ARIA, reactive subcopy + honest Start/Open label, and
  Advanced options (port/SAM) removed.
- device-layer.js handles the new states, renders staged progress + failure
  reason, and polls adaptively (1s while booting, 5s otherwise).

Deferred (documented): dashboard boot banner + hardware-action gating; moving
port/SAM to Settings + GPU auto-detect; full agent-toggle defer-init + client
reconnect after a gate-started device layer.
---
 gently/app/device_supervisor.py         |  66 ++++++--
 gently/hardware/console_ui.py           |  32 ++++
 gently/ui/web/routes/device_layer.py    |  28 ++++
 gently/ui/web/routes/pages.py           |   5 +
 gently/ui/web/server.py                 |   3 +
 gently/ui/web/static/js/device-layer.js |  73 +++++---
 gently/ui/web/templates/launch.html     | 210 ++++++++++++------------
 start_device_layer.py                   |  10 ++
 8 files changed, 286 insertions(+), 141 deletions(-)

diff --git a/gently/app/device_supervisor.py b/gently/app/device_supervisor.py
index 813e3996..17b70a01 100644
--- a/gently/app/device_supervisor.py
+++ b/gently/app/device_supervisor.py
@@ -26,6 +26,7 @@
 from __future__ import annotations
 
 import atexit
+import json
 import logging
 import os
 import signal
@@ -80,6 +81,12 @@ def __init__(
         # reads as "stopped" rather than "crashed".
         self._stopping = False
 
+        # Latest structured startup-progress / failure events parsed from the
+        # child's stdout (@@GENTLY_PROGRESS@@ lines). Single dict refs, swapped
+        # atomically by the reader thread and read without the lock (GIL).
+        self._progress: dict | None = None
+        self._failure: dict | None = None
+
         atexit.register(self._atexit_cleanup)
 
     # ── lifecycle ────────────────────────────────────────────────────────
@@ -118,8 +125,13 @@ def start(self, *, sam_device: str | None = None, config_path: str | None = None
             if config_path is not None:
                 self.config_path = config_path
 
+            # -u = unbuffered stdout: CPython block-buffers stdout when it's a
+            # pipe, which would stall the [N/5] progress + @@GENTLY_PROGRESS@@
+            # lines in the child until the buffer fills. Unbuffered makes the
+            # boot readout live.
             cmd = [
                 sys.executable,
+                "-u",
                 str(script),
                 "--port",
                 str(self.port),
@@ -144,6 +156,8 @@ def start(self, *, sam_device: str | None = None, config_path: str | None = None
 
             logger.info("Spawning device layer: %s", " ".join(cmd))
             self._log.clear()
+            self._progress = None
+            self._failure = None
             self._stopping = False
             self._proc = subprocess.Popen(
                 cmd,
@@ -235,21 +249,33 @@ def log_tail(self, limit: int = 200) -> list[str]:
     def _status_locked(self) -> dict:
         """Compute status. Caller must hold ``_lock``.
 
-        state:
-          running  — we own a live child
-          crashed  — our child exited non-zero without us asking it to
-          external — we don't own it, but the port is listening
-          stopped  — nothing running (never started, or cleanly stopped)
+        state (our managed child, in lifecycle order):
+          starting     — spawned, no progress events yet, HTTP port not up
+          initializing — [N/5] progress flowing, port not up yet (carries progress)
+          ready        — child alive AND port open (the server binds only after
+                         initialize() finishes, so an open port == init done)
+          failed       — child exited non-zero and we captured a structured
+                         failure reason (carries failure summary + hints)
+          crashed      — child exited non-zero with no diagnosis (unexpected)
+          external     — port listening but not our child
+          stopped      — nothing running (never started, or cleanly stopped)
         """
         managed_alive = self._alive()
         port_open = self._port_open()
+        progress = self._progress  # atomic ref read (no lock needed)
+        failure = self._failure
 
         if managed_alive:
-            state = "running"
+            if port_open:
+                state = "ready"
+            elif progress is not None:
+                state = "initializing"
+            else:
+                state = "starting"
         elif (
             self._proc is not None and self._proc.returncode not in (None, 0) and not self._stopping
         ):
-            state = "crashed"
+            state = "failed" if failure else "crashed"
         elif port_open:
             state = "external"
         else:
@@ -273,6 +299,8 @@ def _status_locked(self) -> dict:
             "port_open": port_open,
             "sam_device": self.sam_device,
             "uptime_seconds": uptime,
+            "progress": progress,
+            "failure": failure,
             "log_tail": self.log_tail(50),
         }
 
@@ -303,14 +331,32 @@ def _hard_kill(self, proc: subprocess.Popen) -> None:
         except (ProcessLookupError, OSError):
             pass
 
+    # Sentinel prefix for machine-readable startup events on the child's stdout
+    # (emitted by gently.hardware.console_ui.progress_event).
+    _PROGRESS_PREFIX = "@@GENTLY_PROGRESS@@ "
+
     def _drain_output(self, proc: subprocess.Popen) -> None:
-        """Reader-thread body: copy child stdout into the ring buffer."""
+        """Reader-thread body: copy child stdout into the ring buffer, peeling
+        off structured @@GENTLY_PROGRESS@@ events into _progress / _failure."""
         stream = proc.stdout
         if stream is None:
             return
         try:
-            for line in iter(stream.readline, ""):
-                self._log.append(line.rstrip("\n"))
+            for raw in iter(stream.readline, ""):
+                line = raw.rstrip("\n")
+                if line.startswith(self._PROGRESS_PREFIX):
+                    try:
+                        ev = json.loads(line[len(self._PROGRESS_PREFIX) :])
+                    except ValueError:
+                        self._log.append(line)  # malformed — keep it visible
+                        continue
+                    # Atomic single-ref swaps; read lock-free in _status_locked.
+                    if ev.get("status") == "failed":
+                        self._failure = ev
+                    else:
+                        self._progress = ev
+                    continue  # keep the sentinel out of the human-visible tail
+                self._log.append(line)
         except (ValueError, OSError):
             # Stream closed underneath us during shutdown — fine.
             pass
diff --git a/gently/hardware/console_ui.py b/gently/hardware/console_ui.py
index 60e8dfff..e99e3384 100644
--- a/gently/hardware/console_ui.py
+++ b/gently/hardware/console_ui.py
@@ -23,6 +23,7 @@
 
 from __future__ import annotations
 
+import json
 import os
 import sys
 
@@ -145,14 +146,45 @@ def sub(label: str, value: str, label_w: int = 10) -> None:
     out(f"    {c(label.ljust(label_w), 'grey')}{value}")
 
 
+_last_step: tuple[int, int, str] | None = None
+
+
+def progress_event(**payload) -> None:
+    """Emit one machine-readable startup-progress event on stdout.
+
+    The DeviceLayerSupervisor drains the device layer's stdout pipe — the only
+    channel that crosses the process boundary before the device layer's HTTP
+    port opens — and parses these ``@@GENTLY_PROGRESS@@`` lines into a per-stage
+    progress readout for the UI. No-op on an interactive terminal (isatty), so a
+    human running the device layer directly never sees the sentinel noise; it
+    only fires when stdout is captured (piped) by the supervisor.
+    """
+    try:
+        if sys.stdout.isatty():
+            return
+    except (AttributeError, ValueError):
+        return
+    payload.setdefault("v", 1)
+    try:
+        print("@@GENTLY_PROGRESS@@ " + json.dumps(payload), flush=True)
+    except Exception:
+        pass
+
+
 def step(n: int, total: int, label: str) -> None:
     """A startup progress line: ``  [2/5] Starting Micro-Manager core``"""
+    global _last_step
+    _last_step = (n, total, label)
     out(f"  {c(f'[{n}/{total}]', 'cyan')} {label}")
+    progress_event(i=n, n=total, status="start", label=label)
 
 
 def step_done(detail: str = "ok") -> None:
     """A check-mark continuation under the most recent step."""
     out(f"        {c(_CHECK, 'green')} {c(detail, 'grey')}")
+    if _last_step is not None:
+        i, total, label = _last_step
+        progress_event(i=i, n=total, status="ok", label=label, detail=detail)
 
 
 def note(text: str, style: str = "grey") -> None:
diff --git a/gently/ui/web/routes/device_layer.py b/gently/ui/web/routes/device_layer.py
index f3d5850f..f28a2c98 100644
--- a/gently/ui/web/routes/device_layer.py
+++ b/gently/ui/web/routes/device_layer.py
@@ -76,6 +76,34 @@ async def set_launch_prefs(request: Request):
         body = await request.json()
         return save_prefs(body if isinstance(body, dict) else {})
 
+    @router.post("/api/launch/go", dependencies=[Depends(require_control)])
+    async def launch_go(request: Request):
+        """Submit the launch gate: persist the toggles, mark the gate passed
+        (so / stops bouncing to /launch), and — if the microscope toggle is on —
+        start the device layer.
+
+        Returns fast: start() only *spawns* the child. MMCore init and its
+        per-stage progress happen in the background and are polled via
+        /api/device-layer/status, so the UI can hand off to the dashboard
+        immediately and follow the boot there.
+        """
+        body = await _safe_json(request)
+        prefs = save_prefs(body if isinstance(body, dict) else {})
+        server.gate_passed = True
+        device = None
+        if prefs.get("hardware"):
+            try:
+                device = get_supervisor(server).start()
+            except (FileNotFoundError, OSError) as e:
+                logger.error("device layer start failed from launch gate: %s", e)
+                return {"ok": True, "hardware": True, "error": str(e)}
+        return {
+            "ok": True,
+            "hardware": bool(prefs.get("hardware")),
+            "agent": bool(prefs.get("agent")),
+            "device": device,
+        }
+
     # ── Devices panel: device-layer supervision ──────────────────────────
 
     @router.get("/api/device-layer/status")
diff --git a/gently/ui/web/routes/pages.py b/gently/ui/web/routes/pages.py
index 04a1a959..b3125add 100644
--- a/gently/ui/web/routes/pages.py
+++ b/gently/ui/web/routes/pages.py
@@ -16,7 +16,12 @@ async def index(request: Request):
         Viewing is open to everyone — the dashboard loads in view mode with no
         login. Signing in is an *elevation* to control (handled in-app via the
         chat window's "Sign in" affordance), not a gate on the page itself.
+
+        The launch gate is the entry point: until it's submitted this session,
+        every visit to / bounces to /launch (RFC #78 defer-init boot).
         """
+        if not getattr(server, "gate_passed", False):
+            return RedirectResponse("/launch", status_code=302)
         return server.templates.TemplateResponse(
             request,
             "index.html",
diff --git a/gently/ui/web/server.py b/gently/ui/web/server.py
index d8ab2652..c96be89b 100644
--- a/gently/ui/web/server.py
+++ b/gently/ui/web/server.py
@@ -165,6 +165,9 @@ def __init__(
         self.agent_bridge: Any = None
         self.mesh_service: Any = None
         self.device_supervisor: Any = None  # DeviceLayerSupervisor (RFC #78)
+        # False until the launch gate is submitted this session; while False, /
+        # bounces to /launch so the gate is the entry point (RFC #78).
+        self.gate_passed: bool = False
 
         # Connection manager for WebSocket clients
         self.manager = ConnectionManager()
diff --git a/gently/ui/web/static/js/device-layer.js b/gently/ui/web/static/js/device-layer.js
index f3551be3..6754d770 100644
--- a/gently/ui/web/static/js/device-layer.js
+++ b/gently/ui/web/static/js/device-layer.js
@@ -19,14 +19,18 @@
  * already toasts on a bare 403, so Start/Stop need no credential code.
  */
 const DeviceLayerCard = (function () {
-    const POLL_MS = 5000;
+    let _pollMs = 5000;   // adaptive: 1s while booting, 5s otherwise
 
-    // state -> [pill modifier class, label]. Mirrors the header pill states.
+    // state -> [pill modifier class, label].
     const PILL = {
-        running:  ['live',   'running'],
-        external: ['paused', 'external'],
-        stopped:  ['',       'stopped'],
-        crashed:  ['error',  'crashed'],
+        ready:        ['live',   'ready'],
+        running:      ['live',   'running'],   // legacy alias
+        starting:     ['paused', 'starting'],
+        initializing: ['paused', 'starting'],
+        external:     ['paused', 'external'],
+        stopped:      ['',       'stopped'],
+        crashed:      ['error',  'crashed'],
+        failed:       ['error',  'failed'],
     };
 
     let _card, _pill, _meta, _start, _stop, _logToggle, _log, _hint;
@@ -75,7 +79,7 @@ const DeviceLayerCard = (function () {
     function startPoll() {
         loadStatus();                       // immediate
         if (_timer) clearInterval(_timer);  // clear-before-set
-        _timer = setInterval(loadStatus, POLL_MS);
+        _timer = setInterval(loadStatus, _pollMs);
     }
 
     function stopPoll() {
@@ -101,29 +105,54 @@ const DeviceLayerCard = (function () {
         _pill.className = 'devices-status-pill' + (mod ? ' ' + mod : '');
         _pill.textContent = label;
 
-        const bits = [];
-        if (d.pid) bits.push('pid ' + d.pid);
-        if (d.port) bits.push('port ' + d.port + (d.port_open ? '' : ' · closed'));
-        if (d.sam_device) bits.push(d.sam_device);
-        if (typeof d.uptime_seconds === 'number') bits.push('up ' + fmtUptime(d.uptime_seconds));
-        _meta.textContent = bits.join(' · ');
+        const booting = d.state === 'starting' || d.state === 'initializing';
 
-        // An external (unmanaged) layer can't be started or stopped by us.
-        if (d.state === 'external') {
+        // Meta line: during boot show the current stage; otherwise pid/port/uptime.
+        if (booting && d.progress && d.progress.i && d.progress.n) {
+            _meta.textContent =
+                'step ' + d.progress.i + '/' + d.progress.n + ' · ' + (d.progress.label || 'starting…');
+        } else if (booting) {
+            _meta.textContent = 'starting…';
+        } else {
+            const bits = [];
+            if (d.pid) bits.push('pid ' + d.pid);
+            if (d.port) bits.push('port ' + d.port + (d.port_open ? '' : ' · closed'));
+            if (d.sam_device) bits.push(d.sam_device);
+            if (typeof d.uptime_seconds === 'number') bits.push('up ' + fmtUptime(d.uptime_seconds));
+            _meta.textContent = bits.join(' · ');
+        }
+
+        // Hint line: failure reason, external note, or a reassurance during the
+        // slow MMCore step (step 2) so a long wait doesn't read as frozen.
+        if (d.state === 'failed' && d.failure) {
+            _hint.hidden = false;
+            const h = (d.failure.hints && d.failure.hints[0]) ? ' — ' + d.failure.hints[0] : '';
+            _hint.textContent = (d.failure.summary || 'Startup failed') + h;
+        } else if (d.state === 'external') {
             _hint.hidden = false;
             _hint.textContent = 'running externally — not managed by gently';
+        } else if (booting && d.progress && d.progress.i === 2) {
+            _hint.hidden = false;
+            _hint.textContent = 'Initializing Micro-Manager — this can take a minute.';
         } else {
             _hint.hidden = true;
             _hint.textContent = '';
         }
 
-        // Enable/disable by state (a hint only; the server 403/409 is the real
-        // gate). While a start/stop is in flight, keep both disabled.
-        const running = d.state === 'running';
-        const external = d.state === 'external';
-        const stoppedish = d.state === 'stopped' || d.state === 'crashed';
-        _start.disabled = _busy || running || external;
-        _stop.disabled  = _busy || stoppedish || external;
+        // Enable/disable (a hint only; the server 403/409 is the real gate).
+        const canStart = d.state === 'stopped' || d.state === 'crashed' || d.state === 'failed';
+        const canStop =
+            d.state === 'ready' || d.state === 'running' || booting;
+        _start.disabled = _busy || !canStart;
+        _stop.disabled = _busy || !canStop;
+
+        // Adaptive cadence: poll fast (1s) while booting, calm (5s) otherwise.
+        const want = booting ? 1000 : 5000;
+        if (want !== _pollMs && _timer) {
+            _pollMs = want;
+            clearInterval(_timer);
+            _timer = setInterval(loadStatus, _pollMs);
+        }
 
         if (Array.isArray(d.log_tail) && d.log_tail.length && !_log.hidden) {
             renderLog(d.log_tail);
diff --git a/gently/ui/web/templates/launch.html b/gently/ui/web/templates/launch.html
index 89027014..984af4f3 100644
--- a/gently/ui/web/templates/launch.html
+++ b/gently/ui/web/templates/launch.html
@@ -5,151 +5,150 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Launch Gently</title>
 <!--
-  Launch gate — the bare two-question start screen (RFC #78).
-  Styling lifted from docs/superpowers/mockups/2026-07-02-launcher-gate.html and
-  wired to /api/launch/prefs + /api/device-layer/start.
+  Launch gate — the entry point (RFC #78). Two plain questions:
+    · are we using the microscope this session?
+    · is the assistant on?
+  On "Let's go" it POSTs /api/launch/go (persist + mark passed + start the
+  device layer if the microscope is on) and hands off to the dashboard
+  immediately — MMCore init runs in the background and is followed there via
+  the boot banner / Devices console.
 
-  SCAFFOLD NOTE: this gate persists the choices and (if hardware is on) starts the
-  device layer, then hands off to the dashboard. The full "defer boot-level init
-  until Let's go" refactor — so the *agent* toggle actually gates agent startup —
-  is phase 2 in the RFC and is not wired here yet; the agent toggle is persisted
-  but currently advisory.
+  Theme-aware: reads the app's `gently-theme` and matches light/dark (no more
+  dark-gate → light-dashboard flash). Device port / SAM device are NOT here —
+  they're install-time Settings, and the GPU is auto-detected.
 -->
+<script>
+  // Apply the app's saved theme before first paint (no flash).
+  (function () {
+    try {
+      var t = localStorage.getItem('gently-theme') || 'dark';
+      document.documentElement.setAttribute('data-theme', t);
+    } catch (e) {}
+  })();
+</script>
 <style>
-  :root{
-    --bg:#0a0d13; --inset:#0d121b; --line:#1b222e; --line2:#27303d;
-    --text:#e7edf4; --muted:#8792a3; --faint:#57616f;
-    --accent:#5b8cff; --accent-txt:#a9c4ff; --accentdim:rgba(91,140,255,.12);
-    --green:#40d17f; --red:#ff6b6b; --mono:ui-monospace,"SF Mono",Menlo,Consolas,monospace;
+  :root, [data-theme="dark"] {
+    --g-bg:#0d1117; --g-card:#161b22; --g-hover:#21262d; --g-border:#30363d;
+    --g-text:#c9d1d9; --g-muted:#8b949e; --g-faint:#6e7681; --g-accent:#60a5fa;
+    --g-spot:rgba(96,140,250,.12);
+  }
+  [data-theme="light"] {
+    --g-bg:#f8fafc; --g-card:#ffffff; --g-hover:#f1f5f9; --g-border:#e2e8f0;
+    --g-text:#1e293b; --g-muted:#64748b; --g-faint:#94a3b8; --g-accent:#3b82f6;
+    --g-spot:rgba(59,130,246,.10);
   }
   *{box-sizing:border-box}
   html,body{margin:0}
-  body{min-height:100vh;color:var(--text);
+  body{min-height:100vh;color:var(--g-text);
     font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Inter,system-ui,sans-serif;-webkit-font-smoothing:antialiased;
-    background:radial-gradient(1000px 500px at 50% -14%, rgba(91,140,255,.11), transparent 60%), var(--bg);
-    display:flex;justify-content:center;align-items:center;padding:40px 20px}
+    background:radial-gradient(1000px 520px at 50% -14%, var(--g-spot), transparent 60%), var(--g-bg);
+    display:flex;justify-content:center;align-items:center;padding:40px 20px;transition:background .2s,color .2s}
   .wrap{width:100%;max-width:460px}
   .head{display:flex;align-items:center;justify-content:center;gap:11px;margin-bottom:8px}
-  .mark{width:26px;height:26px;border-radius:50%;border:2px solid var(--accent);position:relative;
-    background:radial-gradient(circle at 50% 50%, rgba(91,140,255,.28), transparent 70%)}
+  .mark{width:26px;height:26px;border-radius:50%;border:2px solid var(--g-accent);position:relative;
+    background:radial-gradient(circle at 50% 50%, var(--g-spot), transparent 70%)}
   .mark::after{content:"";position:absolute;inset:0;margin:auto;width:9px;height:9px;border-radius:50%;
-    background:var(--accent);box-shadow:0 0 12px var(--accent)}
+    background:var(--g-accent);box-shadow:0 0 12px var(--g-accent)}
   .wordmark{font-size:22px;font-weight:700;letter-spacing:-.015em}
-  .cap{text-align:center;color:var(--muted);font-size:14px;margin:0 0 30px}
-  .opt{display:flex;align-items:center;gap:15px;padding:18px 18px;border:1px solid var(--line2);border-radius:13px;
-    background:linear-gradient(180deg,#111621,#0e131c);margin-bottom:13px;transition:.15s;cursor:pointer}
-  .opt.on{border-color:rgba(91,140,255,.55);background:linear-gradient(180deg,rgba(91,140,255,.09),#0e131c);
-    box-shadow:0 0 0 1px rgba(91,140,255,.25), 0 14px 34px -18px rgba(91,140,255,.5)}
+  .cap{text-align:center;color:var(--g-muted);font-size:14px;margin:0 0 30px}
+  .opt{display:flex;align-items:center;gap:15px;padding:18px;border:1px solid var(--g-border);border-radius:13px;
+    background:var(--g-card);margin-bottom:13px;transition:.15s;cursor:pointer}
+  .opt:hover{border-color:var(--g-faint)}
+  .opt:focus-visible{outline:2px solid var(--g-accent);outline-offset:2px}
+  .opt.on{border-color:color-mix(in srgb, var(--g-accent) 55%, transparent);
+    background:color-mix(in srgb, var(--g-accent) 8%, var(--g-card));
+    box-shadow:0 0 0 1px color-mix(in srgb, var(--g-accent) 25%, transparent)}
   .ic{width:42px;height:42px;border-radius:11px;flex:none;display:flex;align-items:center;justify-content:center;
-    background:var(--inset);border:1px solid var(--line2);color:var(--muted)}
-  .opt.on .ic{background:var(--accentdim);border-color:rgba(91,140,255,.4);color:var(--accent-txt)}
+    background:var(--g-hover);border:1px solid var(--g-border);color:var(--g-muted)}
+  .opt.on .ic{background:color-mix(in srgb, var(--g-accent) 14%, transparent);
+    border-color:color-mix(in srgb, var(--g-accent) 40%, transparent);color:var(--g-accent)}
   .txt{flex:1;min-width:0}
   .t{font-size:15.5px;font-weight:650;letter-spacing:-.01em}
-  .s{font-size:12.5px;color:var(--muted);margin-top:3px;line-height:1.45}
-  .s .mono{font-family:var(--mono);color:var(--faint)}
-  .sw{width:44px;height:25px;border-radius:999px;background:#232c39;position:relative;flex:none;transition:.15s;border:1px solid var(--line2)}
-  .sw::after{content:"";position:absolute;top:2px;left:2px;width:19px;height:19px;border-radius:50%;background:#5c6675;transition:.15s}
-  .opt.on .sw{background:var(--accent);border-color:transparent;box-shadow:0 0 16px rgba(91,140,255,.4)}
+  .s{font-size:12.5px;color:var(--g-muted);margin-top:3px;line-height:1.45}
+  .sw{width:44px;height:25px;border-radius:999px;background:var(--g-hover);position:relative;flex:none;transition:.15s;border:1px solid var(--g-border)}
+  .sw::after{content:"";position:absolute;top:2px;left:2px;width:19px;height:19px;border-radius:50%;background:var(--g-faint);transition:.15s}
+  .opt.on .sw{background:var(--g-accent);border-color:transparent}
   .opt.on .sw::after{left:21px;background:#fff}
-  .btn{width:100%;margin-top:9px;background:linear-gradient(180deg,#5b8cff,#4271ec);color:#fff;border:0;border-radius:12px;
-    padding:16px;font-size:16px;font-weight:700;cursor:pointer;box-shadow:0 14px 34px -12px rgba(91,140,255,.7);
-    display:flex;align-items:center;justify-content:center;gap:9px}
-  .btn[disabled]{opacity:.6;cursor:default}
-  .btn .go{font-size:17px}
-  .adv{border:0;background:none;color:var(--muted);font-size:12px;cursor:pointer;padding:0}
-  .adv:hover{color:var(--text)}
-  .advbox{display:none;margin-top:14px;padding:14px;border:1px solid var(--line);border-radius:11px;background:var(--inset)}
-  .advbox.open{display:block}
-  .field{display:flex;align-items:center;justify-content:space-between;gap:10px;margin:8px 0}
-  .field label{font-size:12.5px;color:var(--muted)}
-  .field input,.field select{background:#0a0e15;color:var(--text);border:1px solid var(--line2);border-radius:8px;
-    padding:7px 9px;font-size:13px;font-family:var(--mono);min-width:120px}
-  .foot{text-align:center;margin-top:16px;color:var(--faint);font-size:12px}
-  .status{text-align:center;margin-top:14px;font-size:12.5px;min-height:18px;color:var(--muted)}
-  .status.err{color:var(--red)}
-  .status.ok{color:var(--green)}
+  .btn{width:100%;margin-top:18px;background:var(--g-accent);color:#fff;border:0;border-radius:12px;
+    padding:16px;font-size:16px;font-weight:700;cursor:pointer;
+    display:flex;align-items:center;justify-content:center;gap:9px;transition:filter .15s,opacity .15s}
+  .btn:hover:not(:disabled){filter:brightness(1.08)}
+  .btn:disabled{opacity:.7;cursor:default}
+  .foot{text-align:center;margin-top:16px;color:var(--g-faint);font-size:12px}
+  .status{text-align:center;margin-top:14px;font-size:12.5px;min-height:18px;color:var(--g-muted)}
+  .status.err{color:#f85149}
 </style>
 </head>
 <body>
   <div class="wrap">
     <div class="head"><span class="mark"></span><span class="wordmark">Gently</span></div>
-    <p class="cap">What do you need today?</p>
+    <p class="cap">What are we doing today?</p>
 
-    <div class="opt" id="opt-hardware" data-key="hardware">
-      <div class="ic">
+    <div class="opt" id="opt-hardware" data-key="hardware" role="switch" aria-checked="true" tabindex="0" aria-labelledby="hw-t">
+      <div class="ic" aria-hidden="true">
         <svg width="21" height="21" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="9" r="4"/><path d="M12 13v6M8 21h8M6 9a6 6 0 0 1 8-5.6"/></svg>
       </div>
       <div class="txt">
-        <div class="t">Microscope hardware</div>
-        <div class="s">Start the device layer &amp; connect to the rig <span class="mono" id="port-label">· :60610</span></div>
+        <div class="t" id="hw-t">Microscope</div>
+        <div class="s" id="hw-s"></div>
       </div>
-      <span class="sw"></span>
+      <span class="sw" aria-hidden="true"></span>
     </div>
 
-    <div class="opt" id="opt-agent" data-key="agent">
-      <div class="ic">
+    <div class="opt" id="opt-agent" data-key="agent" role="switch" aria-checked="true" tabindex="0" aria-labelledby="ag-t">
+      <div class="ic" aria-hidden="true">
         <svg width="21" height="21" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3l2.2 5.8L20 11l-5.8 2.2L12 19l-2.2-5.8L4 11l5.8-2.2z"/></svg>
       </div>
       <div class="txt">
-        <div class="t">AI agent</div>
-        <div class="s">Chat, perception &amp; planning — uses your API key</div>
+        <div class="t" id="ag-t">Assistant</div>
+        <div class="s" id="ag-s"></div>
       </div>
-      <span class="sw"></span>
+      <span class="sw" aria-hidden="true"></span>
     </div>
 
     <button class="btn" id="go">Let's go <span class="go">&rarr;</span></button>
     <div class="status" id="status"></div>
-
-    <div class="foot">
-      <button class="adv" id="adv-toggle">Advanced options</button> &middot; remembers your choice
-    </div>
-    <div class="advbox" id="advbox">
-      <div class="field">
-        <label for="f-port">Device port</label>
-        <input id="f-port" type="number" min="1" max="65535">
-      </div>
-      <div class="field">
-        <label for="f-sam">SAM device</label>
-        <select id="f-sam"><option value="cuda">cuda</option><option value="cpu">cpu</option></select>
-      </div>
-    </div>
+    <div class="foot">Remembers your last choice</div>
   </div>
 
 <script>
-const state = { hardware: true, agent: true, port: 60610, sam_device: "cuda" };
+const state = { hardware: true, agent: true };
+const COPY = {
+  hardware: { on: "Connect to the microscope this session.", off: "Not this session — saved data only." },
+  agent:    { on: "Help find embryos and watch the timelapse.", off: "Off — manual control only." },
+};
 
 function paint() {
   document.getElementById("opt-hardware").classList.toggle("on", state.hardware);
+  document.getElementById("opt-hardware").setAttribute("aria-checked", String(state.hardware));
+  document.getElementById("hw-s").textContent = state.hardware ? COPY.hardware.on : COPY.hardware.off;
   document.getElementById("opt-agent").classList.toggle("on", state.agent);
-  document.getElementById("port-label").textContent = "· :" + state.port;
-  document.getElementById("f-port").value = state.port;
-  document.getElementById("f-sam").value = state.sam_device;
+  document.getElementById("opt-agent").setAttribute("aria-checked", String(state.agent));
+  document.getElementById("ag-s").textContent = state.agent ? COPY.agent.on : COPY.agent.off;
+  // Honest button label: "Start" spins up the microscope; "Open" is instant.
+  document.querySelector("#go").childNodes[0].nodeValue = (state.hardware ? "Start " : "Open ");
 }
 
 async function loadPrefs() {
   try {
     const r = await fetch("/api/launch/prefs");
-    if (r.ok) Object.assign(state, await r.json());
+    if (r.ok) {
+      const p = await r.json();
+      if (typeof p.hardware === "boolean") state.hardware = p.hardware;
+      if (typeof p.agent === "boolean") state.agent = p.agent;
+    }
   } catch (e) { /* keep defaults */ }
   paint();
 }
 
+function toggle(key) { state[key] = !state[key]; paint(); }
 for (const id of ["opt-hardware", "opt-agent"]) {
-  document.getElementById(id).addEventListener("click", (e) => {
-    const key = e.currentTarget.dataset.key;
-    state[key] = !state[key];
-    paint();
+  const el = document.getElementById(id);
+  el.addEventListener("click", () => toggle(el.dataset.key));
+  el.addEventListener("keydown", (e) => {
+    if (e.key === " " || e.key === "Enter") { e.preventDefault(); toggle(el.dataset.key); }
   });
 }
-document.getElementById("f-port").addEventListener("change", (e) => {
-  state.port = parseInt(e.target.value, 10) || state.port; paint();
-});
-document.getElementById("f-sam").addEventListener("change", (e) => {
-  state.sam_device = e.target.value;
-});
-document.getElementById("adv-toggle").addEventListener("click", () => {
-  document.getElementById("advbox").classList.toggle("open");
-});
 
 function setStatus(msg, kind) {
   const el = document.getElementById("status");
@@ -160,33 +159,26 @@
 document.getElementById("go").addEventListener("click", async () => {
   const btn = document.getElementById("go");
   btn.disabled = true;
+  btn.childNodes[0].nodeValue = "Starting ";
   try {
-    setStatus("Saving your choice…");
-    await fetch("/api/launch/prefs", {
+    const r = await fetch("/api/launch/go", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(state),
     });
-
-    if (state.hardware) {
-      setStatus("Starting the device layer…");
-      const r = await fetch("/api/device-layer/start", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ sam_device: state.sam_device }),
-      });
-      if (!r.ok) {
-        const body = await r.json().catch(() => ({}));
-        setStatus("Device layer didn't start: " + (body.error || r.status), "err");
-        btn.disabled = false;
-        return;
-      }
+    if (!r.ok) {
+      const b = await r.json().catch(() => ({}));
+      setStatus("Couldn't start: " + (b.error || r.status), "err");
+      btn.disabled = false; paint();
+      return;
     }
-    setStatus("Opening the dashboard…", "ok");
+    const b = await r.json().catch(() => ({}));
+    if (b.error) setStatus("Microscope: " + b.error, "err");
+    // Hand off immediately — the dashboard follows the boot from here.
     window.location.href = "/";
   } catch (e) {
     setStatus("Something went wrong: " + e, "err");
-    btn.disabled = false;
+    btn.disabled = false; paint();
   }
 });
 
diff --git a/start_device_layer.py b/start_device_layer.py
index 9daae9c6..8d1eacfc 100644
--- a/start_device_layer.py
+++ b/start_device_layer.py
@@ -78,6 +78,16 @@ def _render_startup_failure(exc, log_file):
             "Then start the device layer again.",
         ]
 
+    # Structured failure event for the DeviceLayerSupervisor (rides the same
+    # stdout pipe as progress) so the UI can show a plain-language reason + hints
+    # instead of re-parsing the console panel. No-op on an interactive terminal.
+    cui.progress_event(
+        status="failed",
+        stage=(device or "startup"),
+        summary=summary,
+        detail=details,
+        hints=hints,
+    )
     cui.error_panel("GENTLY DEVICE LAYER", summary, details, hints, log_file)
 
 

From a5bdf4f9016c38b2d7eca897a60d97ca33d21ad8 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 08:22:15 -0400
Subject: [PATCH 310/314] feat(launcher): dashboard boot banner following the
 device-layer boot (RFC #78)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A compact, non-modal bottom-center pill that follows MMCore startup from any
tab (the Devices panel is the on-demand full console; this is its summary):
- "Microscope warming up — step N/5 · <stage>" with a pulsing dot while booting,
  driven by /api/device-layer/status progress.
- Flashes "Microscope ready" then auto-dismisses on ready; on failure/crash it
  stays amber with the plain-language reason + Details (opens the Devices panel)
  + Retry.
- Polls adaptively (1s booting / 6s idle) so it also catches a device layer
  started later from the Devices panel.
- Publishes a readiness signal (window.gentlyDeviceReady + ClientEventBus
  'DEVICE_LAYER_STATE') for hardware-only controls to gate on.

Styles live in a dedicated boot-banner.css (appending to the 11.5k-line main.css
tripped a pre-existing stray-brace parse boundary). Verified rendering + staged
progress via a progress-emitting stand-in device layer.
---
 gently/ui/web/static/css/boot-banner.css |  78 +++++++++++++
 gently/ui/web/static/js/boot-banner.js   | 140 +++++++++++++++++++++++
 gently/ui/web/templates/index.html       |  12 ++
 3 files changed, 230 insertions(+)
 create mode 100644 gently/ui/web/static/css/boot-banner.css
 create mode 100644 gently/ui/web/static/js/boot-banner.js

diff --git a/gently/ui/web/static/css/boot-banner.css b/gently/ui/web/static/css/boot-banner.css
new file mode 100644
index 00000000..fb9ef465
--- /dev/null
+++ b/gently/ui/web/static/css/boot-banner.css
@@ -0,0 +1,78 @@
+/* Device-layer boot banner (boot-banner.js) - non-modal, follows MMCore boot.
+   A compact bottom-center pill; the Devices panel is the full on-demand console. */
+.boot-banner {
+    position: fixed;
+    left: 50%;
+    bottom: 22px;
+    transform: translateX(-50%);
+    z-index: 10020;
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    max-width: min(560px, 92vw);
+    padding: 0.55rem 0.7rem 0.55rem 0.9rem;
+    border: 1px solid var(--border);
+    border-radius: 999px;
+    background: var(--bg-card);
+    color: var(--text);
+    box-shadow: 0 10px 30px -10px rgba(0, 0, 0, 0.45);
+    font-size: 0.85rem;
+}
+.boot-banner-dot {
+    width: 9px;
+    height: 9px;
+    border-radius: 50%;
+    flex: none;
+    background: var(--accent);
+}
+.boot-banner.booting .boot-banner-dot {
+    animation: boot-pulse 1.1s ease-in-out infinite;
+}
+@keyframes boot-pulse {
+    0%, 100% { opacity: 0.35; }
+    50% { opacity: 1; }
+}
+.boot-banner.ready {
+    border-color: var(--accent-green);
+}
+.boot-banner.ready .boot-banner-dot {
+    background: var(--accent-green);
+    animation: none;
+}
+.boot-banner.failed {
+    border-color: var(--accent-orange);
+}
+.boot-banner.failed .boot-banner-dot {
+    background: var(--accent-orange);
+    animation: none;
+}
+.boot-banner-text {
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+.boot-banner-btn {
+    flex: none;
+    border: 1px solid var(--border);
+    background: var(--bg-hover);
+    color: var(--text);
+    border-radius: 8px;
+    padding: 0.25rem 0.6rem;
+    font-size: 0.78rem;
+    cursor: pointer;
+}
+.boot-banner-btn:hover:not(:disabled) { background: var(--bg-card); }
+.boot-banner-btn:disabled { opacity: 0.5; cursor: default; }
+.boot-banner-x {
+    flex: none;
+    border: 0;
+    background: none;
+    color: var(--text-muted);
+    font-size: 1.1rem;
+    line-height: 1;
+    cursor: pointer;
+    padding: 0 0.15rem;
+}
+.boot-banner-x:hover { color: var(--text); }
diff --git a/gently/ui/web/static/js/boot-banner.js b/gently/ui/web/static/js/boot-banner.js
new file mode 100644
index 00000000..219865cf
--- /dev/null
+++ b/gently/ui/web/static/js/boot-banner.js
@@ -0,0 +1,140 @@
+/**
+ * Boot banner — a small, always-visible, non-modal summary of the device-layer
+ * boot, so the operator can follow MMCore startup from anywhere on the dashboard
+ * (the Devices panel is the on-demand console; this is its compact form).
+ *
+ * Polls /api/device-layer/status globally — fast (1s) while booting, calm (6s)
+ * otherwise so it also catches a device layer started later from the Devices
+ * panel. Also publishes a readiness signal (window.gentlyDeviceReady +
+ * ClientEventBus 'DEVICE_LAYER_STATE') that hardware-only controls can gate on.
+ */
+const BootBanner = (function () {
+    const STAGE_TOTAL = 5;
+
+    let _el, _text, _details, _retry, _close;
+    let _timer = null;
+    let _pollMs = 0;
+    let _lastState = null;
+    let _dom = false;
+
+    function cacheDom() {
+        if (_dom) return;
+        _el = document.getElementById('gently-boot-banner');
+        if (!_el) return;
+        _text = document.getElementById('boot-banner-text');
+        _details = document.getElementById('boot-banner-details');
+        _retry = document.getElementById('boot-banner-retry');
+        _close = document.getElementById('boot-banner-close');
+        _dom = true;
+    }
+
+    function init() {
+        cacheDom();
+        if (!_el) return;
+        _details.addEventListener('click', () => {
+            if (typeof switchTab === 'function' && typeof TABS !== 'undefined') switchTab(TABS.DEVICES);
+        });
+        _retry.addEventListener('click', onRetry);
+        _close.addEventListener('click', hide);
+        setPoll(1500);
+    }
+
+    function setPoll(ms) {
+        if (ms === _pollMs && _timer) return;
+        _pollMs = ms;
+        if (_timer) clearInterval(_timer);
+        _timer = setInterval(poll, _pollMs);
+    }
+
+    async function poll() {
+        try {
+            const r = await fetch('/api/device-layer/status');
+            if (!r.ok) return;
+            render(await r.json());
+        } catch (e) {
+            /* keep last-known UI */
+        }
+    }
+
+    function render(d) {
+        const state = d.state;
+
+        // Publish a readiness signal for hardware-only controls to gate on.
+        const ready = state === 'ready' || state === 'external';
+        window.gentlyDeviceReady = ready;
+        if (state !== _lastState && typeof ClientEventBus !== 'undefined') {
+            ClientEventBus.emit('DEVICE_LAYER_STATE', { state, ready });
+        }
+
+        if (state === 'starting' || state === 'initializing') {
+            show('booting');
+            const p = d.progress || {};
+            const step = p.i ? `step ${p.i}/${p.n || STAGE_TOTAL} · ` : '';
+            _text.textContent = `Microscope warming up — ${step}${p.label || 'starting…'}`;
+            btns({ details: true, retry: false, close: false });
+            setPoll(1000);
+        } else if (state === 'ready') {
+            setPoll(6000);
+            const justFinished = _lastState === 'starting' || _lastState === 'initializing';
+            if (justFinished) {
+                // Flash "ready" briefly, then auto-dismiss.
+                show('ready');
+                _text.textContent = 'Microscope ready';
+                btns({ details: false, retry: false, close: false });
+                setTimeout(() => {
+                    if (_el.classList.contains('ready')) hide();
+                }, 3500);
+            } else if (!(_el.classList.contains('ready') && !_el.hidden)) {
+                hide(); // already ready on load, or the ready-flash was dismissed
+            }
+        } else if (state === 'failed' || state === 'crashed') {
+            show('failed');
+            _text.textContent =
+                (d.failure && d.failure.summary) ||
+                (state === 'crashed'
+                    ? 'The device layer stopped unexpectedly.'
+                    : "The microscope didn't start.");
+            btns({ details: true, retry: true, close: true });
+            setPoll(6000);
+        } else {
+            // stopped (software-only session) or external with nothing to add.
+            hide();
+            setPoll(6000);
+        }
+        _lastState = state;
+    }
+
+    function show(kind) {
+        _el.hidden = false;
+        _el.className = 'boot-banner ' + kind;
+    }
+    function hide() {
+        _el.hidden = true;
+    }
+    function btns({ details, retry, close }) {
+        _details.hidden = !details;
+        _retry.hidden = !retry;
+        _close.hidden = !close;
+    }
+
+    async function onRetry() {
+        _retry.disabled = true;
+        try {
+            await fetch('/api/device-layer/start', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: '{}',
+            });
+        } catch (e) {
+            /* the status poll will reflect the outcome */
+        } finally {
+            _retry.disabled = false;
+            setTimeout(poll, 400);
+            poll();
+        }
+    }
+
+    return { init };
+})();
+
+document.addEventListener('DOMContentLoaded', () => BootBanner.init());
diff --git a/gently/ui/web/templates/index.html b/gently/ui/web/templates/index.html
index 8ad9cba4..35374ae8 100644
--- a/gently/ui/web/templates/index.html
+++ b/gently/ui/web/templates/index.html
@@ -11,6 +11,7 @@
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Inter+Tight:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/static/css/main.css">
+    <link rel="stylesheet" href="/static/css/boot-banner.css">
     <link rel="stylesheet" href="/static/css/campaigns.css">
     <link rel="stylesheet" href="/static/css/review.css">
     <link rel="stylesheet" href="/static/css/experiment.css">
@@ -1386,6 +1387,7 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
     <script src="/static/js/devices.js"></script>
     <script src="/static/js/operate.js"></script>
     <script src="/static/js/device-layer.js"></script>
+    <script src="/static/js/boot-banner.js"></script>
     <script src="/static/js/operations-scenarios.js"></script>
     <script src="/static/js/experiment-overview.js"></script>
     <!-- Three.js for 3D volume viewer -->
@@ -1401,5 +1403,15 @@ <h2 class="gallery-tab-title"><span class="gallery-tab-title-script">Acquired</s
     <script src="/static/js/shell.js"></script>
     <script src="/static/js/context-surface.js"></script>
     <script src="/static/js/landing.js"></script>
+
+    <!-- Device-layer boot banner (boot-banner.js) — non-modal, follows MMCore
+         startup from any tab; the Devices panel is the on-demand full console. -->
+    <div id="gently-boot-banner" class="boot-banner" hidden>
+        <span class="boot-banner-dot" aria-hidden="true"></span>
+        <span class="boot-banner-text" id="boot-banner-text"></span>
+        <button type="button" class="boot-banner-btn" id="boot-banner-details" hidden>Details</button>
+        <button type="button" class="boot-banner-btn" id="boot-banner-retry" hidden>Retry</button>
+        <button type="button" class="boot-banner-x" id="boot-banner-close" aria-label="Dismiss" hidden>&times;</button>
+    </div>
 </body>
 </html>

From a0666066b8938259f5049d3c4234edf9425cd995 Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 08:27:56 -0400
Subject: [PATCH 311/314] feat(launcher): auto-detect GPU for SAM +
 Device-layer Settings section (RFC #78)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Per the biologist consult, a biologist should never be asked cuda/cpu:
- launch_prefs.detect_sam_device() auto-detects the SAM inference device (cuda if
  an NVIDIA GPU is present via torch/nvidia-smi, else cpu), cached. The sam_device
  pref defaults to "auto" and load_prefs() resolves it to a concrete device; only
  a scope wrangler pins a value.
- A "Device layer" section in Settings (Hardware group) exposes the install-time
  port + SAM device (Auto-detect / GPU / CPU) with a "Detected: …" diagnostic,
  persisted via /api/launch/prefs. These are off the launch gate on purpose.
- /api/launch/prefs now also returns sam_detected + sam_device_raw for that UI.
---
 gently/ui/web/launch_prefs.py         | 51 +++++++++++++++++++-
 gently/ui/web/routes/device_layer.py  | 13 +++--
 gently/ui/web/templates/settings.html | 69 +++++++++++++++++++++++++++
 3 files changed, 129 insertions(+), 4 deletions(-)

diff --git a/gently/ui/web/launch_prefs.py b/gently/ui/web/launch_prefs.py
index 0a5bb905..d6acfee4 100644
--- a/gently/ui/web/launch_prefs.py
+++ b/gently/ui/web/launch_prefs.py
@@ -28,10 +28,56 @@
     "hardware": True,  # start + connect the device layer
     "agent": True,  # enable chat / perception / planning (needs API key)
     "port": settings.network.device_port,
-    "sam_device": "cuda",
+    # "auto" is resolved to cuda/cpu at load time by GPU auto-detection — a
+    # biologist should never have to choose (RFC #78). Only a scope wrangler
+    # pins a concrete value (in Settings).
+    "sam_device": "auto",
 }
 _ALLOWED_KEYS = set(_DEFAULTS)
 
+_sam_device_cache: str | None = None
+
+
+def detect_sam_device() -> str:
+    """Auto-detect the SAM inference device: ``cuda`` if an NVIDIA GPU is present,
+    else ``cpu``. Cached — detection is cheap once torch is loaded."""
+    global _sam_device_cache
+    if _sam_device_cache is not None:
+        return _sam_device_cache
+    dev = "cpu"
+    try:
+        import torch
+
+        if torch.cuda.is_available():
+            dev = "cuda"
+    except Exception:
+        # torch missing/failed — fall back to a plain nvidia-smi presence check.
+        import shutil
+        import subprocess
+
+        if shutil.which("nvidia-smi"):
+            try:
+                subprocess.run(["nvidia-smi"], capture_output=True, timeout=4, check=True)
+                dev = "cuda"
+            except Exception:
+                pass
+    _sam_device_cache = dev
+    logger.info("SAM device auto-detected: %s", dev)
+    return dev
+
+
+def stored_prefs() -> dict:
+    """The raw persisted prefs (unresolved), or {} — for the Settings UI which
+    needs to show 'auto' vs a pinned SAM device."""
+    try:
+        if PREFS_PATH.exists():
+            data = json.loads(PREFS_PATH.read_text(encoding="utf-8"))
+            if isinstance(data, dict):
+                return data
+    except (OSError, ValueError):
+        pass
+    return {}
+
 
 def load_prefs() -> dict:
     """Return the persisted launch choices merged over defaults.
@@ -47,6 +93,9 @@ def load_prefs() -> dict:
                 prefs.update({k: stored[k] for k in _ALLOWED_KEYS if k in stored})
     except (OSError, ValueError) as e:
         logger.warning("launch prefs unreadable (%s) — using defaults", e)
+    # Resolve the SAM device unless a concrete value was pinned in Settings.
+    if prefs.get("sam_device") in (None, "", "auto"):
+        prefs["sam_device"] = detect_sam_device()
     return prefs
 
 
diff --git a/gently/ui/web/routes/device_layer.py b/gently/ui/web/routes/device_layer.py
index f28a2c98..86d20f6e 100644
--- a/gently/ui/web/routes/device_layer.py
+++ b/gently/ui/web/routes/device_layer.py
@@ -22,7 +22,7 @@
 from fastapi.responses import HTMLResponse, JSONResponse
 
 from gently.ui.web.auth import require_control
-from gently.ui.web.launch_prefs import load_prefs, save_prefs
+from gently.ui.web.launch_prefs import detect_sam_device, load_prefs, save_prefs, stored_prefs
 
 logger = logging.getLogger(__name__)
 
@@ -67,8 +67,15 @@ async def launch_gate(request: Request):
 
     @router.get("/api/launch/prefs")
     async def get_launch_prefs():
-        """Persisted launch choices (hardware/agent toggles + advanced defaults)."""
-        return load_prefs()
+        """Persisted launch choices (hardware/agent toggles + advanced defaults).
+
+        Adds `sam_detected` (auto-detected GPU/CPU) and `sam_device_raw` (the
+        stored 'auto'/'cuda'/'cpu' before resolution) for the Settings UI.
+        """
+        prefs = load_prefs()
+        prefs["sam_detected"] = detect_sam_device()
+        prefs["sam_device_raw"] = stored_prefs().get("sam_device", "auto")
+        return prefs
 
     @router.post("/api/launch/prefs", dependencies=[Depends(require_control)])
     async def set_launch_prefs(request: Request):
diff --git a/gently/ui/web/templates/settings.html b/gently/ui/web/templates/settings.html
index cc1316cb..b2b15bc9 100644
--- a/gently/ui/web/templates/settings.html
+++ b/gently/ui/web/templates/settings.html
@@ -54,6 +54,7 @@ <h1>Settings</h1>
             </div>
             <div class="settings-nav-group">
                 <div class="settings-nav-title">Hardware</div>
+                <a class="settings-nav-item" data-section="devicelayer" href="#devicelayer">Device layer</a>
                 <a class="settings-nav-item" data-section="thermalizer" href="#thermalizer">Thermalizer</a>
                 <a class="settings-nav-item" data-section="effective" href="#effective">Effective config</a>
                 <a class="settings-nav-item" data-section="advanced" href="#advanced">Advanced</a>
@@ -94,6 +95,31 @@ <h2 class="settings-section-title">Alert Thresholds</h2>
                 </div>
             </section>
 
+            <!-- Device layer Section (install-time; rarely changed) -->
+            <section class="settings-section" id="section-devicelayer">
+                <h2 class="settings-section-title">Device layer</h2>
+                <p class="settings-label" style="opacity:.75;margin-bottom:1rem">
+                    Install-time settings for the microscope control process. Most rigs never
+                    change these — they're kept off the launch screen on purpose.
+                </p>
+                <div class="settings-field">
+                    <label class="settings-label">Device layer port</label>
+                    <div class="settings-input-row">
+                        <input type="number" class="settings-input" id="dl-port" min="1" max="65535">
+                    </div>
+                </div>
+                <div class="settings-field">
+                    <label class="settings-label">Image analysis (SAM) runs on</label>
+                    <div class="settings-radio-group" id="dl-sam">
+                        <label class="settings-radio"><input type="radio" name="dlsam" value="auto"> Auto-detect</label>
+                        <label class="settings-radio"><input type="radio" name="dlsam" value="cuda"> GPU (CUDA)</label>
+                        <label class="settings-radio"><input type="radio" name="dlsam" value="cpu"> CPU</label>
+                    </div>
+                    <p class="settings-label" style="opacity:.7;margin-top:.5rem" id="dl-sam-detected"></p>
+                </div>
+                <p class="settings-label" style="opacity:.8" id="dl-status"></p>
+            </section>
+
             <!-- Ambient Section -->
             <section class="settings-section" id="section-ambient">
                 <h2 class="settings-section-title">Ambient Pulse</h2>
@@ -304,6 +330,49 @@ <h2 class="settings-section-title">Advanced <span class="th-ro">(restart require
                 localStorage.setItem('gently-theme', next);
             });
         }
+
+        // Device-layer settings (port + SAM device) — persisted via /api/launch/prefs.
+        // Applies to the next device-layer start (a running one isn't reconfigured).
+        (function () {
+            const port = document.getElementById('dl-port');
+            const detected = document.getElementById('dl-sam-detected');
+            const status = document.getElementById('dl-status');
+            if (!port) return;
+            let loaded = false;
+            fetch('/api/launch/prefs').then(r => (r.ok ? r.json() : null)).then(p => {
+                if (!p) return;
+                port.value = (p.port != null ? p.port : '');
+                const sam = p.sam_device_raw || 'auto';
+                const radio = document.querySelector('#dl-sam input[value="' + sam + '"]')
+                    || document.querySelector('#dl-sam input[value="auto"]');
+                if (radio) radio.checked = true;
+                if (detected) {
+                    detected.textContent = 'Detected: ' + (p.sam_detected === 'cuda'
+                        ? 'GPU (CUDA)'
+                        : 'CPU — no GPU found, so image analysis will be slower');
+                }
+                loaded = true;
+            });
+            async function save() {
+                if (!loaded) return;
+                const sam = (document.querySelector('#dl-sam input:checked') || {}).value || 'auto';
+                const body = { sam_device: sam };
+                const pv = parseInt(port.value, 10);
+                if (pv) body.port = pv;
+                try {
+                    const r = await fetch('/api/launch/prefs', {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify(body),
+                    });
+                    if (status) status.textContent = r.ok
+                        ? 'Saved — applies next time the device layer starts'
+                        : (r.status === 403 ? 'Sign in to change device settings' : 'Failed to save');
+                } catch (e) { if (status) status.textContent = 'Failed to save'; }
+            }
+            port.addEventListener('change', save);
+            document.querySelectorAll('#dl-sam input').forEach(r => r.addEventListener('change', save));
+        })();
     </script>
 </body>
 </html>

From 63579e7bbb1b5d00a32b258629bf82bf525e5b5b Mon Sep 17 00:00:00 2001
From: Kesavan <pskeshu@gmail.com>
Date: Sun, 12 Jul 2026 12:11:09 -0400
Subject: [PATCH 312/314] feat(launcher): pragmatic microscope reconnect when
 gate starts device layer (RFC #78)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

When the launch gate (or Devices panel) starts the device layer after boot,
a background watcher reconnects the agent's microscope client and registers
its tools once the layer reaches 'ready' — so gate-started hardware becomes
usable without a relaunch.

- _reconnect_microscope_when_ready: polls the supervisor off the event loop,
  connects the client on 'ready', registers tools once (idempotent).
- _attach_microscope: shared boot/reconnect helper; returns the tool count.
- cli_main: honor the gate's persisted agent/hardware toggles at boot
  (CLI flags can still force OFF).
- Use a gently.*-namespaced logger for reconnect events; the __main__ logger
  isn't wired to the configured handlers.

Verified end-to-end via POST /api/launch/go: gate spawns the device layer,
it reaches 'ready', and the client reconnects + registers tools.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 launch_gently.py | 115 ++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 94 insertions(+), 21 deletions(-)

diff --git a/launch_gently.py b/launch_gently.py
index 85d591d9..d6930e5b 100644
--- a/launch_gently.py
+++ b/launch_gently.py
@@ -223,6 +223,74 @@ def run_ink_picker(tui_dist: Path, sessions_json: str) -> str | None:
     return None
 
 
+# launch_gently runs as `__main__`, whose logger is not wired to the configured
+# handlers — so operator-facing lifecycle events (reconnect, tool registration)
+# use a `gently.*`-namespaced logger that reaches the console + file logs.
+_reconnect_log = logging.getLogger("gently.app.launch")
+
+
+async def _attach_microscope(client, store) -> int:
+    """Configure the device session + register microscope tools for a connected
+    client. Used both at boot and when reconnecting to a device layer that was
+    started from the launch gate / Devices panel. Returns the tool count."""
+    try:
+        await client.configure_device_session(str(store.incoming_dir))
+        logger.info("Device session configured: volume_dir=%s", store.incoming_dir)
+    except Exception as e:
+        logger.error("Failed to configure device session (volumes will be slow): %s", e)
+    try:
+        from gently.harness.microscope import register_microscope_tools
+
+        n = register_microscope_tools(client)
+        if n:
+            logger.info("Registered %d microscope tools from device layer", n)
+        return n
+    except Exception as e:
+        logger.debug("Auto-tool registration skipped: %s", e)
+        return 0
+
+
+async def _reconnect_microscope_when_ready(client, viz_server, store) -> None:
+    """Background task (RFC #78 pragmatic reconnect): when a device layer started
+    from the launch gate (or the Devices panel) reaches 'ready', (re)connect the
+    agent's microscope client to it and register its tools — so hardware the gate
+    started becomes usable by the agent without a relaunch. Acts only while the
+    client is disconnected, and registers tools once."""
+    if client is None:
+        return
+    # If already wired up at boot, the boot path registered tools already.
+    tools_registered = bool(client.is_connected)
+    while True:
+        await asyncio.sleep(2.0)
+        sup = getattr(viz_server, "device_supervisor", None) if viz_server else None
+        if sup is None:
+            continue
+        try:
+            # status() does a short socket probe — off the event loop.
+            state = (await asyncio.to_thread(sup.status)).get("state")
+        except Exception:
+            continue
+        if state != "ready":
+            continue
+        # Ensure the client is connected to the now-ready device layer.
+        if not client.is_connected:
+            try:
+                await client.disconnect()  # drop any stale (failed-at-boot) session
+            except Exception:
+                pass
+            try:
+                await client.connect()
+            except Exception as e:
+                _reconnect_log.debug("Microscope reconnect attempt failed: %s", e)
+        # Register microscope tools once — whoever connected the client.
+        if client.is_connected and not tools_registered:
+            n = await _attach_microscope(client, store)
+            _reconnect_log.info(
+                "Microscope client reconnected to the device layer (%d tools registered)", n
+            )
+            tools_registered = True
+
+
 async def main(
     offline: bool = False,
     resume_session: str | None = None,
@@ -352,25 +420,12 @@ async def main(
                 http_url,
             )
 
-    # Configure device session for zero-copy volume transfer
-    if client and client.is_connected:
-        try:
-            incoming = str(store.incoming_dir)
-            await client.configure_device_session(incoming)
-            logger.info("Device session configured: volume_dir=%s", incoming)
-        except Exception as e:
-            logger.error("Failed to configure device session (volumes will be slow): %s", e)
-
-    # Register auto-generated microscope tools from device layer plan schemas
+    # Configure the device session + register microscope tools if the client
+    # connected at boot (an already-running device layer). If the device layer is
+    # started later from the launch gate, _reconnect_microscope_when_ready does
+    # this once it reaches 'ready'.
     if client and client.is_connected:
-        try:
-            from gently.harness.microscope import register_microscope_tools
-
-            n = register_microscope_tools(client)
-            if n:
-                logger.info("Registered %d microscope tools from device layer", n)
-        except Exception as e:
-            logger.debug("Auto-tool registration skipped: %s", e)
+        await _attach_microscope(client, store)
 
     # Create agent
     agent = MicroscopyAgent(
@@ -572,6 +627,11 @@ def _status_provider():
             except Exception:
                 logger.debug("Startup rehydrate failed", exc_info=True)
 
+    # Reconnect the microscope client if a device layer is started from the
+    # launch gate / Devices panel after boot (RFC #78 pragmatic reconnect).
+    if client is not None:
+        asyncio.create_task(_reconnect_microscope_when_ready(client, agent.viz_server, store))
+
     # ── Banner + serve ──────────────────────────────────────────────
     # The viz server runs in-process (uvicorn in a background task). With
     # the TUI retired, the launcher's job is to keep that server alive and
@@ -716,8 +776,21 @@ def cli_main():
     )
     args = parser.parse_args()
 
+    # Gate the agent + hardware by the launch gate's remembered choices (the gate
+    # persists them; they apply at boot). CLI flags can still force these OFF.
+    launch_no_api = args.no_api
+    launch_offline = args.offline
+    try:
+        from gently.ui.web.launch_prefs import load_prefs
+
+        _lp = load_prefs()
+        launch_no_api = args.no_api or not _lp.get("agent", True)
+        launch_offline = args.offline or not _lp.get("hardware", True)
+    except Exception:
+        pass
+
     # An API key is required unless running in UI-only mode.
-    if not args.no_api and not os.getenv("ANTHROPIC_API_KEY"):
+    if not launch_no_api and not os.getenv("ANTHROPIC_API_KEY"):
         print("Error: ANTHROPIC_API_KEY not set")
         if os.name == "nt":
             print("Set with: set ANTHROPIC_API_KEY=your-key")
@@ -737,13 +810,13 @@ def cli_main():
     resume_id = args.resume if args.resume and args.resume != "__PICK__" else None
 
     main_kwargs = dict(
-        offline=args.offline,
+        offline=launch_offline,
         show_sessions=args.sessions,
         resume_session=resume_id,
         pick_session=pick_session,
         log_level=log_level,
         no_browser=args.no_browser,
-        no_api=args.no_api,
+        no_api=launch_no_api,
         no_auth=args.no_auth,
     )
 

From 574d1e8149367436919690a05b01ba3967eaae7d Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 13 Jul 2026 10:23:08 +0530
Subject: [PATCH 313/314] fix(desktop): compile + run on Linux dev machines
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two cross-platform gaps found testing the Tauri shell on Linux (Manjaro,
KDE/Wayland, webkit2gtk 2.52) — after these it builds, boots the backend,
and renders the launch gate in the native window:

- main.rs failed borrow-check (E0597) on non-Windows only: with the
  cfg(windows) jobkill line compiled out, the exit-handler if-let became
  the block's tail expression and the MutexGuard temporary outlived the
  state borrow. Trailing semicolon drops it in order on both platforms.
- python_exe() only knew the Windows venv layout (.venv/Scripts/python.exe),
  so Linux silently fell back to bare 'python' from PATH. Now picks
  .venv/bin/python on Unix.
- README: Linux prerequisites + bash run commands (NSIS bundle stays
  Windows-only).
---
 desktop/README.md             | 25 +++++++++++++++++++++++++
 desktop/src-tauri/src/main.rs | 11 +++++++++--
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/desktop/README.md b/desktop/README.md
index 129bac7c..52e8b0ae 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -45,6 +45,31 @@ Tauri shell (Rust, WebView2 window)
 - **Node** (only for the Tauri CLI: `npm install` in this folder)
 - A working gently checkout with its Python **`.venv`** at the repo root
 
+### Linux (dev machines)
+
+The shell is cross-platform — the Job-Object code is `#[cfg(windows)]`, so on
+Linux teardown is the best-effort `child.kill()` only (fine for dev; the
+kill-on-close guarantee is a Windows-production feature). Verified on Manjaro
+(KDE/Wayland, webkit2gtk 2.52):
+
+- **Rust** — `rustup default stable`
+- **WebKitGTK + GTK3** — `webkit2gtk-4.1` and `gtk3` dev packages
+  (Arch/Manjaro: `pacman -S webkit2gtk-4.1`; Debian/Ubuntu:
+  `apt install libwebkit2gtk-4.1-dev build-essential`)
+- **Node** — as above
+- The venv is found at **`.venv/bin/python`** (Unix layout) automatically;
+  `GENTLY_PYTHON` overrides as usual
+
+Same commands, bash syntax:
+
+```bash
+cd desktop && npm install
+GENTLY_LAUNCH_ARGS="--no-api --offline --no-auth" npm run dev
+```
+
+`npm run build` is Windows-only as configured (`bundle.targets: ["nsis"]`) —
+on Linux use `npm run dev`, or override targets if a Linux bundle is ever needed.
+
 ## Run (dev)
 
 ```powershell
diff --git a/desktop/src-tauri/src/main.rs b/desktop/src-tauri/src/main.rs
index e6472a5d..ff706c69 100644
--- a/desktop/src-tauri/src/main.rs
+++ b/desktop/src-tauri/src/main.rs
@@ -56,9 +56,12 @@ fn main() {
             if let RunEvent::Exit = event {
                 let b = app_handle.state::<Backend>();
                 // Best-effort direct kill of the child we spawned...
+                // (trailing `;` so the MutexGuard temporary drops before `b` —
+                // without it this is the block's tail expression on non-Windows,
+                // where the cfg'd jobkill line below is compiled out: E0597)
                 if let Some(mut child) = b.child.lock().unwrap().take() {
                     let _ = child.kill();
-                }
+                };
                 // ...and close the job handle, which kill-on-close uses to reap
                 // the whole tree (python + device-layer grandchild). Correct even
                 // if the child kill above missed a grandchild.
@@ -147,7 +150,11 @@ fn python_exe(repo: &Path) -> PathBuf {
     if let Ok(p) = std::env::var("GENTLY_PYTHON") {
         return PathBuf::from(p);
     }
-    let venv = repo.join(".venv").join("Scripts").join("python.exe");
+    let venv = if cfg!(windows) {
+        repo.join(".venv").join("Scripts").join("python.exe")
+    } else {
+        repo.join(".venv").join("bin").join("python")
+    };
     if venv.exists() {
         venv
     } else {

From c4c8b00acd0fd5c9b449ecdfc6fc5fb246601d81 Mon Sep 17 00:00:00 2001
From: P S Kesavan <pskeshu@gmail.com>
Date: Mon, 13 Jul 2026 15:14:14 +0530
Subject: [PATCH 314/314] fix(boot-banner): Details dismisses the landing
 overlay before switching tabs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Found via session replay: with the v2 landing up, Details switched to the
Devices tab invisibly behind the overlay — the recorded session shows the
operator clicking Details and seeing nothing for over two minutes before
finding 'Skip to workspace' on their own. Dismiss the landing (via its own
skip path) before the switch so the console is actually revealed.
---
 gently/ui/web/static/js/boot-banner.js | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/gently/ui/web/static/js/boot-banner.js b/gently/ui/web/static/js/boot-banner.js
index 219865cf..419b02f7 100644
--- a/gently/ui/web/static/js/boot-banner.js
+++ b/gently/ui/web/static/js/boot-banner.js
@@ -32,6 +32,15 @@ const BootBanner = (function () {
         cacheDom();
         if (!_el) return;
         _details.addEventListener('click', () => {
+            // The v2 landing overlay covers the workspace — dismiss it first,
+            // or the tab switch below happens invisibly behind it and the
+            // click feels dead (found via session replay: the operator
+            // clicked Details and saw nothing for over two minutes).
+            const landing = document.getElementById('v2-landing');
+            if (landing && !landing.classList.contains('dismissed')) {
+                const skip = document.getElementById('v2-landing-skip');
+                if (skip) skip.click(); else landing.classList.add('dismissed');
+            }
             if (typeof switchTab === 'function' && typeof TABS !== 'undefined') switchTab(TABS.DEVICES);
         });
         _retry.addEventListener('click', onRetry);